mooncakes.io

marianoguerra/shrubbery-html/lower does not have a README file

RawTextHook

type RawTextHook = (String, Array[@marianoguerra/shrubbery/ast.Node
Node]) -> String?

What to do with the block of a raw-text element.

The obvious next thought after style(): @{ ... } is to let that body hold shrubbery CSS -- and acting on it would make marianoguerra/shrubbery-css a dependency of this module, which every consumer would then fetch whether they wanted CSS or not. So the hook is a parameter instead: a caller that already depends on both supplies one and gets the composition; everyone else pays nothing.

The function is handed the element's name and the groups in its block, and returns the raw text to put inside it, or None to fall back to the ordinary reading.

Lowered

source

pub struct Lowered {
  document : @marianoguerra/html/ast.Document
Document
  diagnostics : Array[@marianoguerra/shrubbery-html/error.Diagnostic
Diagnostic]
}

A lowering: the tree, and everything noticed on the way.

Lowered::diagnostics

source

fn Lowered::diagnostics(self : Lowered) -> Array[@marianoguerra/shrubbery-html/error.Diagnostic
Diagnostic]

Lowered::document

source

fn Lowered::document(self : Lowered) -> @marianoguerra/html/ast.Document
Document

Lowered::has_errors

source

fn Lowered::has_errors(self : Lowered) -> Bool

lower

source

fn lower(root : @marianoguerra/shrubbery/ast.Node
Node, strict? : Bool, hook? : (String, Array[@marianoguerra/shrubbery/ast.Node
Node]) -> String??) -> Lowered raise @marianoguerra/shrubbery-html/error.ShrubHtmlError
ShrubHtmlError

Lower a parsed shrubbery tree.

lower_source

source

fn lower_source(src : String, strict? : Bool, hook? : (String, Array[@marianoguerra/shrubbery/ast.Node
Node]) -> String??) -> Lowered raise @marianoguerra/shrubbery-html/error.ShrubHtmlError
ShrubHtmlError

Parse shrubbery source and lower it in one step.

Shrubbery's own diagnostics come first and are converted, so a caller sees one list rather than having to consult two. A source that does not parse lowers to an empty document: there is no tree to lower, and inventing one would put the bridge's guesses where the notation's answer should be.