{-# LANGUAGE OverloadedStrings #-}
module Stylist(cssPriorityAgent, cssPriorityUser, cssPriorityAuthor,
PropertyParser(..), TrivialPropertyParser(..),
StyleSheet(..), TrivialStyleSheet(..), Props,
Element(..), Attribute(..),
elementPath, compileAttrTest, matched, attrTest, hasWord, hasLang,
parseUnorderedShorthand, parseUnorderedShorthand', parseOperands) where
import Data.Text (Text, unpack)
import Data.CSS.Syntax.Tokens (Token(..))
import Data.List
import Stylist.Parse (StyleSheet(..), TrivialStyleSheet(..), scanBlock)
import Stylist.Parse.Selector
-- | Set the priority for a CSS stylesheet being parsed.
cssPriorityAgent, cssPriorityUser, cssPriorityAuthor :: StyleSheet s => s -> s
cssPriorityAgent = setPriority 1
cssPriorityUser = setPriority 2
cssPriorityAuthor = setPriority 3
-- | Defines how to parse CSS properties into an output "style" format.
class PropertyParser a where
-- | Default styles.
temp :: a
-- | Creates a style inherited from a parent style.
inherit :: a -> a
inherit = id
priority :: a -> [Text]
priority _ = []
-- | Expand a shorthand property into longhand properties.
shorthand :: a -> Text -> [Token] -> [(Text, [Token])]
shorthand self key value | Just _ <- longhand self self key value = [(key, value)]
| otherwise = []
-- | Mutates self to store the given CSS property, if it's syntax is valid.
-- longhand parent self name value
longhand :: a -> a -> Text -> [Token] -> Maybe a
-- | Retrieve stored variables, optional.
getVars :: a -> Props
getVars _ = []
-- | Save variable values, optional.
setVars :: Props -> a -> a
setVars _ = id
-- | Mutates self to store the given pseudoelement styles,
-- passing a callback so you can alter the parent &
-- (for interactive pseudoclasses) base styles.
pseudoEl :: a -> Text -> (a -> Maybe a -> a) -> a
pseudoEl self _ _ = self
-- | "key: value;" entries to be parsed into an output type.
type Props = [(Text, [Token])]
-- | Gathers properties as a key'd list.
-- Works well with `lookup`.
data TrivialPropertyParser = TrivialPropertyParser [(String, [Token])] deriving (Show, Eq)
instance PropertyParser TrivialPropertyParser where
temp = TrivialPropertyParser []
longhand _ (TrivialPropertyParser self) key value =
Just $ TrivialPropertyParser ((unpack key, value):self)
-- | An inversely-linked tree of elements, to apply CSS selectors to.
data Element = ElementNode {
-- | The element's parent in the tree.
parent :: Maybe Element,
-- | The element's previous sibling in the tree.
previous :: Maybe Element,
-- | The element's name.
name :: Text,
-- | The element's namespace.
namespace :: Text,
-- | The element's attributes, in sorted order.
attributes :: [Attribute]
}
-- | A key-value attribute.
data Attribute = Attribute Text Text String deriving (Eq, Ord)
-- | Computes the child indices to traverse to reach the given element.
elementPath :: Element -> [Int]
elementPath = elementPath' []
-- | Variant of `elementPath` with a prefix path.
elementPath' path ElementNode { parent = Just parent', previous = prev } =
elementPath' (succ (countSib prev) : path) parent'
elementPath' path ElementNode { parent = Nothing, previous = prev } =
(succ (countSib prev) : path)
-- | How many previous children does this element have?
countSib (Just (ElementNode { previous = prev })) = succ $ countSib prev
countSib Nothing = 0
-- | Converts a property text into a callback testing against a string.
compileAttrTest :: PropertyTest -> String -> Bool
compileAttrTest Exists = matched
compileAttrTest (Equals val) = (== (unpack val))
compileAttrTest (Suffix val) = isSuffixOf $ unpack val
compileAttrTest (Prefix val) = isPrefixOf $ unpack val
compileAttrTest (Substring val) = isInfixOf $ unpack val
compileAttrTest (Include val) = hasWord $ unpack val
compileAttrTest (Dash val) = hasLang $ unpack val
compileAttrTest (Callback (PropertyFunc cb)) = cb
-- | returns True regardless of value.
matched :: t -> Bool
matched _ = True
-- | Tests the given word is in the whitespace-seperated value.
hasWord :: String -> String -> Bool
hasWord expected value = expected `elem` words value
-- | Tests whether the attribute holds the expected value or a sub-locale.
hasLang :: [Char] -> [Char] -> Bool
hasLang expected value = expected == value || isPrefixOf (expected ++ "-") value
-- | Test whether the element matches a parsed property test, for the given attribute.
attrTest :: Maybe Text -> Text -> PropertyTest -> Element -> Bool
attrTest namespace name test ElementNode { attributes = attrs } = any predicate attrs
where
predicate attr@(Attribute ns' _ _) | Just ns <- namespace = ns == ns' && predicate' attr
| otherwise = predicate' attr
predicate' (Attribute _ name' value') = name == name' && compileAttrTest test value'
-- | Utility for parsing shorthand attributes which don't care in which order the
-- subproperties are specified.
-- Each property must parse only a single function or token.
parseUnorderedShorthand :: PropertyParser a =>
a -> [Text] -> [Token] -> [(Text, [Token])]
parseUnorderedShorthand self properties toks
| Just _ <- lookup "" ret = [] -- Error recovery!
| otherwise = ret
where
ret = parseUnorderedShorthand' self properties $ parseOperands toks
-- | Variant of `parseUnorderedShorthand` taking pre-split list.
parseUnorderedShorthand' :: PropertyParser a =>
a -> [Text] -> [[Token]] -> [(Text, [Token])]
parseUnorderedShorthand' self properties (arg:args) = inner properties []
where
inner (prop:props) props'
| entry@(_:_) <- shorthand self prop arg =
entry ++ parseUnorderedShorthand' self (props' ++ props) args
| otherwise = inner props (prop:props')
inner [] _ = [("", [])] -- Error caught & handled by public API.
parseUnorderedShorthand' self (prop:props) [] = -- Shorthands have long effects!
(prop, [Ident "initial"]):parseUnorderedShorthand' self props []
parseUnorderedShorthand' _ [] [] = []
-- | Splits a token list so each function is it's own list.
-- Other tokens are split into their own singletons.
parseOperands :: [Token] -> [[Token]]
parseOperands (Function name:toks) = let (args, toks') = scanBlock toks
in (Function name:args):parseOperands toks'
parseOperands (tok:toks) = [tok]:parseOperands toks
parseOperands [] = []