@the_dissidents/libemmm 0.0.5 → 0.0.8

package/README.md

@@ -83,9 +83,9 @@ You can also use the brackets without a modifier. However, this has little effec
 Suppose the modifier `[.pre]` accepts a preformatted block:
 
 ```
-[.pre] Preformatted content, suitable for code and ASCII art. Always treated as plain text, even if I write [.foo] or [/foo] or \[.
+[.pre] This is preformatted content, suitable for code and ASCII art. Always treated as plain text, even if I write [.foo] or [/foo] or \[.
 
-However, like in a normal paragraph, a blank line creates a new block so this is no longer in the pre. Use brackets:
+However, like in a normal paragraph, a blank line creates a new block so this is no longer in the pre. Use brackets if you don't want that:
 
 [.pre]
 :--
@@ -104,7 +104,7 @@ Use a `;` before `]` to signify empty content. Modifiers that don't accept conte
 [.pre;]
 ```
 
-In normal paragraphs, use a slash `\` to **escape** the character immediately after it, so that it will not be interpreted as a special character (e.g. the beginning of a modifier).
+In normal paragraphs, you can use a backslash `\` to **escape** a character immediately after it, so that it will not be interpreted as a special character (e.g. the beginning of a modifier).
 
 **Inline modifiers** are similar to block modifiers, but occur in paragraphs. They are written as `[/baa]` or `[/baa args]`. If accepting content, use `[;]` to mark the end of their scope.
 
@@ -159,10 +159,10 @@ A colon before the first argument states explicitly the beginning of that argume
 
 ### System modifiers
 
-[**-define-block** *name*:*args...*]  
-[**-define-block** *name*:*args...*:(*slot*)]  
-[**-define-inline** *name*:*args...*]  
-[**-define-inline** *name*:*args...*:(*slot*)]  
+[**-define-block** *name*:*args...*] *content*  
+[**-define-block** *name*:*args...*:(*slot*)] *content*  
+[**-define-inline** *name*:*args...*] *content*  
+[**-define-inline** *name*:*args...*:(*slot*)] *content*  
 
 > Define a new modifier. The first argument is the name. If one or more arguments exist, and the last is enclosed in `()`, it is taken as the **slot name** (more on that later). The rest in the middle are names for the arguments.
 > 
@@ -174,15 +174,15 @@ A colon before the first argument states explicitly the beginning of that argume
 > 
 > You can't reassign arguments, only variables. Since arguments always take precedence over variables, "reassigning" them has no effect inside a definition and can only confuse the rest of the code.
 
-[**-define-block-prefix** *prefix*]  
-[**-define-block-prefix** *prefix*:(*slot*)]
+[**-define-block-prefix** *prefix*] *content*  
+[**-define-block-prefix** *prefix*:(*slot*)] *content*
 
 > Not implemented yet
 
-[**-define-inline-shorthand** *prefix*]  
-[**-define-inline-shorthand** *prefix*:(*slot*):*postfix*]  
-[**-define-inline-shorthand** *prefix*:*arg1*:*mid1*:*arg2*:*mid2*...]  
-[**-define-inline-shorthand** *prefix*:*arg1*:*mid1*:*arg2*:*mid2*...:(*slot*):*postfix*]  
+[**-define-inline-shorthand** *prefix*] *content*  
+[**-define-inline-shorthand** *prefix*:(*slot*):*postfix*] *content*  
+[**-define-inline-shorthand** *prefix*:*arg1*:*mid1*:*arg2*:*mid2*...] *content*  
+[**-define-inline-shorthand** *prefix*:*arg1*:*mid1*:*arg2*:*mid2*...:(*slot*):*postfix*] *content*  
 
 > Defines an inline shorthand. A shorthand notation consists of a prefix, zero or more pairs of argument and middle part, and optionally a slot and a postfix. You must specify a slot name if you want to use one, although you can specify an empty one using `()`. You may also specify an *empty* last argument, i.e. a `:` before the `]` that ends the modifier head, to make the postfix stand out better.
 > ```
@@ -222,14 +222,22 @@ A colon before the first argument states explicitly the beginning of that argume
 > ```
 > Note the first, unnamed `.slot` refers to the slot of `q`.
 
-[**.module** *module-name*]
+[**.module** *module-name*] *content*
 
 > Causes the definitions in the content to become part of a **module**. They don't take effect outside the `[.module]` modifier *unless* activated by a `[.use]` or `[-use]` modifier.
 
-[**.use** *module-name*]
+[**.use** *module-name*] *content*
 
 > Activates the definitions in a module for the content *within this modifier*. Use `[-use]` to activate for the whole document instead.
 
+[**.ifdef** *id*] *content*
+
+> Expands to the content if the variable or argument *id* is defined, or nothing if it's not.
+
+[**.ifndef** *id*] *content*
+
+> Expands to the content if the variable or argument *id* is undefined, or nothing if it's defined.
+
 ### Inline modifiers
 
 [**/slot**]  
@@ -245,6 +253,11 @@ A colon before the first argument states explicitly the beginning of that argume
 
 > Expands to the value of the arguments, separated by nothing, as plain text.
 
+[**/ifdef** *id*] *content* [;]  
+[**/ifndef** *id*] *content* [;]
+
+> See the similarly named block modifiers.
+
 ### Interpolators
 
 **$(** *varid* **)**

package/dist/index.d.mts

@@ -1,3 +1,5 @@
+import * as minimal_jsx_runtime from 'minimal-jsx-runtime';
+
 declare enum DebugLevel {
     Trace = 0,
     Info = 1,
@@ -6,6 +8,35 @@ declare enum DebugLevel {
     None = 4
 }
 
+type SourceDescriptor = {
+    readonly name: string;
+};
+interface Source extends SourceDescriptor {
+    readonly nLines: number;
+    /**
+     * Return the row- and column-index corresponding to a given location. The indices are zero-based.
+     */
+    getRowCol(loc: number): [row: number, col: number];
+    /**
+     * Returns the position of the start of row `n` (zero-based). If `n` is zero, returns zero. If the source contains less than `n` rows, returns `Infinity`.
+     */
+    getRowStart(n: number): number;
+    /**
+     * Returns the content of the row `n` (zero-based). If the source contains less than `n` rows, returns `undefined`.
+     */
+    getRow(n: number): string | undefined;
+}
+declare class StringSource implements Source {
+    private readonly src;
+    readonly name: string;
+    readonly nLines: number;
+    private readonly lineMap;
+    constructor(d: SourceDescriptor, src: string);
+    getRowCol(pos: number): [row: number, col: number];
+    getRowStart(n: number): number;
+    getRow(n: number): string | undefined;
+}
+
 declare class NameManager<T extends {
     name: string;
 }> {
@@ -37,12 +68,20 @@ declare class ParseContext {
     set<S extends ParseContextStoreKey>(key: S, obj: ParseContextStoreEntry<S>): void;
     get<S extends ParseContextStoreKey>(key: S): ParseContextStoreEntry<S>;
 }
-declare class Document {
+declare class Document$1 {
     readonly root: RootNode;
     readonly context: ParseContext;
     readonly messages: readonly Message[];
     constructor(root: RootNode, context: ParseContext, messages: readonly Message[]);
-    toStripped(): Document;
+    toStripped(): Document$1;
+    /**
+     * Performs a depth-first walk of the node tree.
+     */
+    walk(callback: (node: BlockEntity | InlineEntity | ArgumentEntity) => 'skip' | 'break' | 'continue'): void;
+    /**
+     * Gets all nodes that covers the given position, from outermost to innermost (essentially a path).
+     */
+    resolvePosition(pos: number): (BlockEntity | InlineEntity | ArgumentEntity)[];
 }
 interface ReadonlyConfiguration {
     readonly initializers: readonly ((cxt: ParseContext) => void)[];
@@ -77,12 +116,9 @@ type Message = {
     readonly info: string;
     readonly code: number;
 };
-type SourceDescriptor = {
-    name: string;
-};
 type LocationRange = {
     original?: LocationRange;
-    source: SourceDescriptor;
+    source: Source;
     start: number;
     end: number;
     actualEnd?: number;
@@ -155,7 +191,7 @@ type InlineModifierNode<TState> = {
 type RootNode = {
     type: NodeType.Root;
     content: BlockEntity[];
-    source: SourceDescriptor;
+    source: Source;
 };
 type ModifierNode<T = any> = BlockModifierNode<T> | InlineModifierNode<T> | SystemModifierNode<T>;
 type BlockEntity = ParagraphNode | PreNode | BlockModifierNode<any> | SystemModifierNode<any>;
@@ -185,24 +221,43 @@ declare class ModifierBase<TNode, TEntity> {
     readonly name: string;
     readonly slotType: ModifierSlotType;
     constructor(name: string, slotType?: ModifierSlotType, args?: Partial<ModifierBase<TNode, TEntity>>);
+    /**
+     * Common values: heading, emphasis, keyword, highlight, commentary, comment, link, quote
+     */
     roleHint?: string;
     /**
-     * If true, any modifier encountered in the content of it will *not* be expanded, *unless* that modifier is `alwaysTryExpand`.
+     * If true, any modifier encountered inside it will *not* be expanded *during parse-content*,
+     * *unless* that modifier is `alwaysTryExpand`. In the vast majority of cases, you shouldn't
+     * be using this.
      */
     delayContentExpansion: boolean;
     /**
-     * If true, such a modifier will always be expanded whenever it is encountered, *even if* contained in a modifier with `delayContentExpansion`.
+     * If true, such a modifier will always be expanded whenever it is encountered, *even if*
+     * it is contained in a modifier with `delayContentExpansion`. In the vast majority of cases,
+     * you shouldn't be using this.
      */
     alwaysTryExpand: boolean;
-    /** Called before the modifier's content is parsed. */
+    /** Called before the modifier's content is parsed.
+     * @param immediate False when the node is inside a `delayContentExpansion` modifier, but it is `alwaysTryExpand`; otherwise true.
+    */
     beforeParseContent?: (node: TNode, cxt: ParseContext, immediate: boolean) => Message[];
-    /** Called after the modifier's content is parsed. */
+    /** Called after the modifier's content is parsed.
+     * @param immediate False when the node is inside a `delayContentExpansion` modifier, but it is `alwaysTryExpand`; otherwise true.
+    */
     afterParseContent?: (node: TNode, cxt: ParseContext, immediate: boolean) => Message[];
-    /** Called before reparsing of the expansion. */
+    /** Called before reparsing of the expansion.
+     * @param immediate False when the node is inside a `delayContentExpansion` modifier, but it is `alwaysTryExpand`; otherwise true.*/
     beforeProcessExpansion?: (node: TNode, cxt: ParseContext, immediate: boolean) => Message[];
-    /** Called before reparsing of the expansion. */
+    /** Called before reparsing of the expansion.
+     * @param immediate False when the node is inside a `delayContentExpansion` modifier, but it is `alwaysTryExpand`; otherwise true.*/
     afterProcessExpansion?: (node: TNode, cxt: ParseContext, immediate: boolean) => Message[];
+    /**
+     * @param immediate False when the node is inside a `delayContentExpansion` modifier, but it is `alwaysTryExpand`; otherwise true.
+     */
     prepareExpand?: (node: TNode, cxt: ParseContext, immediate: boolean) => Message[];
+    /**
+     * @param immediate False when the node is inside a `delayContentExpansion` modifier, but it is `alwaysTryExpand`; otherwise true.
+     */
     expand?: (node: TNode, cxt: ParseContext, immediate: boolean) => TEntity[] | undefined;
 }
 declare class BlockModifierDefinition<TState> extends ModifierBase<BlockModifierNode<TState>, BlockEntity> {
@@ -229,9 +284,9 @@ type InlineShorthand<TState> = Shorthand<InlineModifierDefinition<TState>>;
 
 declare class SimpleScanner implements Scanner {
     private src;
-    readonly source: SourceDescriptor;
+    readonly source: Source;
     private pos;
-    constructor(src: string, source?: SourceDescriptor);
+    constructor(src: string, sourceDesc?: SourceDescriptor);
     position(): number;
     isEOF(): boolean;
     peek(str: string): boolean;
@@ -240,7 +295,7 @@ declare class SimpleScanner implements Scanner {
     acceptWhitespaceChar(): string | null;
 }
 interface Scanner {
-    readonly source: SourceDescriptor;
+    readonly source: Source;
     position(): number;
     isEOF(): boolean;
     peek(str: string): boolean;
@@ -249,25 +304,30 @@ interface Scanner {
     acceptWhitespaceChar(): string | null;
 }
 
-declare function parse(scanner: Scanner, cxt: ParseContext): Document;
+declare function parse(scanner: Scanner, cxt: ParseContext): Document$1;
 
-type RendererType<TState, TReturn, TOptions = undefined> = {
+type RendererType<TState, TReturn, TDocument, TOptions = undefined> = {
     state: TState;
     return: TReturn;
+    document: TDocument;
     options: TOptions;
 };
-type AnyRendererType = RendererType<any, any, any>;
-type getState<Type> = Type extends RendererType<infer T, any, any> ? T : never;
-type getReturn<Type> = Type extends RendererType<any, infer T, any> ? T : never;
-type getOptions<Type> = Type extends RendererType<any, any, infer T> ? T : never;
+type AnyRendererType = RendererType<any, any, any, any>;
+type getState<Type> = Type extends RendererType<infer T, any, any, any> ? T : never;
+type getReturn<Type> = Type extends RendererType<any, infer T, any, any> ? T : never;
+type getDocument<Type> = Type extends RendererType<any, any, infer T, any> ? T : never;
+type getOptions<Type> = Type extends RendererType<any, any, any, infer T> ? T : never;
 type NodeRenderer<Type extends AnyRendererType, TNode> = (node: TNode, cxt: RenderContext<Type>) => getReturn<Type>;
-type NodeRendererDefinition<Type extends AnyRendererType, TNode, TDef> = [def: TDef, renderer: NodeRenderer<Type, TNode>];
+type NodeRendererDefinition<Type extends AnyRendererType, TNode, TDef> = [
+    def: TDef,
+    renderer: NodeRenderer<Type, TNode>
+];
 declare class RenderContext<Type extends AnyRendererType> {
     readonly config: RenderConfiguration<Type>;
-    readonly parseContext: ParseContext;
+    readonly parsedDocument: Document$1;
     state: getState<Type>;
     renderEntity(node: BlockEntity | InlineEntity): getReturn<Type> | undefined;
-    constructor(config: RenderConfiguration<Type>, parseContext: ParseContext, state: getState<Type>);
+    constructor(config: RenderConfiguration<Type>, parsedDocument: Document$1, state: getState<Type>);
 }
 interface ReadonlyRenderConfiguration<Type extends AnyRendererType> {
     readonly options: getOptions<Type>;
@@ -277,22 +337,22 @@ interface ReadonlyRenderConfiguration<Type extends AnyRendererType> {
     readonly undefinedInlineRenderer?: NodeRenderer<Type, InlineModifierNode<any>>;
     readonly blockRenderers: ReadonlyMap<BlockModifierDefinition<any>, NodeRenderer<Type, BlockModifierNode<any>>>;
     readonly inlineRenderers: ReadonlyMap<InlineModifierDefinition<any>, NodeRenderer<Type, InlineModifierNode<any>>>;
-    readonly postprocessor: (results: getReturn<Type>[], cxt: RenderContext<Type>) => getReturn<Type>;
-    render(doc: Document, state: getState<Type>): getReturn<Type>;
+    readonly postprocessor: (results: getReturn<Type>[], cxt: RenderContext<Type>) => getDocument<Type>;
+    render(doc: Document$1, state: getState<Type>): getDocument<Type>;
 }
 type BlockRendererDefiniton<Type extends AnyRendererType, ModState = any> = NodeRendererDefinition<Type, BlockModifierNode<ModState>, BlockModifierDefinition<ModState>>;
 type InlineRendererDefiniton<Type extends AnyRendererType, ModState = any> = NodeRendererDefinition<Type, InlineModifierNode<ModState>, InlineModifierDefinition<ModState>>;
 declare class RenderConfiguration<Type extends AnyRendererType> implements ReadonlyRenderConfiguration<Type> {
     options: getOptions<Type>;
-    postprocessor: (results: getReturn<Type>[], cxt: RenderContext<Type>) => getReturn<Type>;
+    postprocessor: (results: getReturn<Type>[], cxt: RenderContext<Type>) => getDocument<Type>;
     paragraphRenderer?: NodeRenderer<Type, ParagraphNode>;
     textRenderer?: NodeRenderer<Type, TextNode | PreNode | EscapedNode>;
     undefinedBlockRenderer?: NodeRenderer<Type, BlockModifierNode<any>>;
     undefinedInlineRenderer?: NodeRenderer<Type, InlineModifierNode<any>>;
     blockRenderers: Map<BlockModifierDefinition<any>, NodeRenderer<Type, BlockModifierNode<any>>>;
     inlineRenderers: Map<InlineModifierDefinition<any>, NodeRenderer<Type, InlineModifierNode<any>>>;
-    constructor(options: getOptions<Type>, postprocessor: (results: getReturn<Type>[], cxt: RenderContext<Type>) => getReturn<Type>);
-    render(doc: Document, state: getState<Type>): getReturn<Type>;
+    constructor(options: getOptions<Type>, postprocessor: (results: getReturn<Type>[], cxt: RenderContext<Type>) => getDocument<Type>);
+    render(doc: Document$1, state: getState<Type>): getDocument<Type>;
     addBlockRenderer(...rs: BlockRendererDefiniton<Type>[]): void;
     addInlineRenderer(...rs: InlineRendererDefiniton<Type>[]): void;
     static from<Type extends AnyRendererType>(from: ReadonlyRenderConfiguration<Type>): RenderConfiguration<Type>;
@@ -425,7 +485,7 @@ declare class UnnecessaryNewlineMessage extends RemoveThingMessage {
 declare class NewBlockShouldBeOnNewlineMessage extends AddThingMessage {
     constructor(location: LocationRange);
 }
-declare class ContentShouldBeOnNewlineMessage extends AddThingMessage {
+declare class ShouldBeOnNewlineMessage extends AddThingMessage {
     constructor(location: LocationRange);
 }
 declare class NameAlreadyDefinedMessage implements Message {
@@ -468,8 +528,6 @@ type messages_CannotExpandArgumentMessage = CannotExpandArgumentMessage;
 declare const messages_CannotExpandArgumentMessage: typeof CannotExpandArgumentMessage;
 type messages_CannotUseModuleInSelfMessage = CannotUseModuleInSelfMessage;
 declare const messages_CannotUseModuleInSelfMessage: typeof CannotUseModuleInSelfMessage;
-type messages_ContentShouldBeOnNewlineMessage = ContentShouldBeOnNewlineMessage;
-declare const messages_ContentShouldBeOnNewlineMessage: typeof ContentShouldBeOnNewlineMessage;
 type messages_EitherNormalOrPreMessage = EitherNormalOrPreMessage;
 declare const messages_EitherNormalOrPreMessage: typeof EitherNormalOrPreMessage;
 type messages_EntityNotAllowedMessage = EntityNotAllowedMessage;
@@ -494,6 +552,8 @@ type messages_OverwriteSpecialVariableMessage = OverwriteSpecialVariableMessage;
 declare const messages_OverwriteSpecialVariableMessage: typeof OverwriteSpecialVariableMessage;
 type messages_ReachedRecursionLimitMessage = ReachedRecursionLimitMessage;
 declare const messages_ReachedRecursionLimitMessage: typeof ReachedRecursionLimitMessage;
+type messages_ShouldBeOnNewlineMessage = ShouldBeOnNewlineMessage;
+declare const messages_ShouldBeOnNewlineMessage: typeof ShouldBeOnNewlineMessage;
 type messages_SlotUsedOutsideDefinitionMessage = SlotUsedOutsideDefinitionMessage;
 declare const messages_SlotUsedOutsideDefinitionMessage: typeof SlotUsedOutsideDefinitionMessage;
 type messages_UnclosedInlineModifierMessage = UnclosedInlineModifierMessage;
@@ -505,7 +565,22 @@ declare const messages_UnknownModifierMessage: typeof UnknownModifierMessage;
 type messages_UnnecessaryNewlineMessage = UnnecessaryNewlineMessage;
 declare const messages_UnnecessaryNewlineMessage: typeof UnnecessaryNewlineMessage;
 declare namespace messages {
-  export { messages_ArgumentCountMismatchMessage as ArgumentCountMismatchMessage, messages_CannotExpandArgumentMessage as CannotExpandArgumentMessage, messages_CannotUseModuleInSelfMessage as CannotUseModuleInSelfMessage, messages_ContentShouldBeOnNewlineMessage as ContentShouldBeOnNewlineMessage, messages_EitherNormalOrPreMessage as EitherNormalOrPreMessage, messages_EntityNotAllowedMessage as EntityNotAllowedMessage, messages_ExpectedMessage as ExpectedMessage, messages_InvalidArgumentMessage as InvalidArgumentMessage, messages_MultipleBlocksNotPermittedMessage as MultipleBlocksNotPermittedMessage, messages_NameAlreadyDefinedMessage as NameAlreadyDefinedMessage, messages_NewBlockShouldBeOnNewlineMessage as NewBlockShouldBeOnNewlineMessage, messages_NoNestedModuleMessage as NoNestedModuleMessage, messages_OnlySimpleParagraphsPermittedMessage as OnlySimpleParagraphsPermittedMessage, messages_OverwriteDefinitionsMessage as OverwriteDefinitionsMessage, messages_OverwriteSpecialVariableMessage as OverwriteSpecialVariableMessage, messages_ReachedRecursionLimitMessage as ReachedRecursionLimitMessage, messages_SlotUsedOutsideDefinitionMessage as SlotUsedOutsideDefinitionMessage, messages_UnclosedInlineModifierMessage as UnclosedInlineModifierMessage, messages_UndefinedVariableMessage as UndefinedVariableMessage, messages_UnknownModifierMessage as UnknownModifierMessage, messages_UnnecessaryNewlineMessage as UnnecessaryNewlineMessage };
+  export { messages_ArgumentCountMismatchMessage as ArgumentCountMismatchMessage, messages_CannotExpandArgumentMessage as CannotExpandArgumentMessage, messages_CannotUseModuleInSelfMessage as CannotUseModuleInSelfMessage, messages_EitherNormalOrPreMessage as EitherNormalOrPreMessage, messages_EntityNotAllowedMessage as EntityNotAllowedMessage, messages_ExpectedMessage as ExpectedMessage, messages_InvalidArgumentMessage as InvalidArgumentMessage, messages_MultipleBlocksNotPermittedMessage as MultipleBlocksNotPermittedMessage, messages_NameAlreadyDefinedMessage as NameAlreadyDefinedMessage, messages_NewBlockShouldBeOnNewlineMessage as NewBlockShouldBeOnNewlineMessage, messages_NoNestedModuleMessage as NoNestedModuleMessage, messages_OnlySimpleParagraphsPermittedMessage as OnlySimpleParagraphsPermittedMessage, messages_OverwriteDefinitionsMessage as OverwriteDefinitionsMessage, messages_OverwriteSpecialVariableMessage as OverwriteSpecialVariableMessage, messages_ReachedRecursionLimitMessage as ReachedRecursionLimitMessage, messages_ShouldBeOnNewlineMessage as ShouldBeOnNewlineMessage, messages_SlotUsedOutsideDefinitionMessage as SlotUsedOutsideDefinitionMessage, messages_UnclosedInlineModifierMessage as UnclosedInlineModifierMessage, messages_UndefinedVariableMessage as UndefinedVariableMessage, messages_UnknownModifierMessage as UnknownModifierMessage, messages_UnnecessaryNewlineMessage as UnnecessaryNewlineMessage };
+}
+
+declare function checkArgumentLength(node: ModifierNode, min?: number, max?: number | undefined): Message[] | null;
+declare function checkArguments(node: ModifierNode, min?: number, max?: number | undefined): Message[] | null;
+declare function onlyPermitPlaintextParagraph(node: BlockModifierNode<any> | SystemModifierNode<any>): Message[] | string;
+declare function onlyPermitSimpleParagraphs(node: BlockModifierNode<any> | SystemModifierNode<any>): Message[] | null;
+declare function onlyPermitSingleBlock(node: BlockModifierNode<any> | SystemModifierNode<any>): Message[] | null;
+
+declare const modifierHelper_checkArgumentLength: typeof checkArgumentLength;
+declare const modifierHelper_checkArguments: typeof checkArguments;
+declare const modifierHelper_onlyPermitPlaintextParagraph: typeof onlyPermitPlaintextParagraph;
+declare const modifierHelper_onlyPermitSimpleParagraphs: typeof onlyPermitSimpleParagraphs;
+declare const modifierHelper_onlyPermitSingleBlock: typeof onlyPermitSingleBlock;
+declare namespace modifierHelper {
+  export { modifierHelper_checkArgumentLength as checkArgumentLength, modifierHelper_checkArguments as checkArguments, modifierHelper_onlyPermitPlaintextParagraph as onlyPermitPlaintextParagraph, modifierHelper_onlyPermitSimpleParagraphs as onlyPermitSimpleParagraphs, modifierHelper_onlyPermitSingleBlock as onlyPermitSingleBlock };
 }
 
 declare const BuiltinConfiguration: ReadonlyConfiguration;
@@ -516,24 +591,25 @@ type HTMLRendererOptions = {
     headPlugins: HTMLComponentPlugin[];
     headerPlugins: HTMLComponentPlugin[];
     footerPlugins: HTMLComponentPlugin[];
+    postprocessPlugins: HTMLPostprocessPlugin[];
     transformAsset: (id: string) => string | undefined;
 };
 type HTMLRenderType = {
     state: HTMLRenderState;
     options: HTMLRendererOptions;
-    return: string;
+    document: Document;
+    return: Node | Node[];
 };
 type HTMLRenderPlugin = (elem: BlockEntity | InlineEntity, cxt: RenderContext<HTMLRenderType>) => string | undefined;
-type HTMLComponentPlugin = (cxt: RenderContext<HTMLRenderType>) => string | undefined;
-type HTMLPostprocessPlugin = (cxt: RenderContext<HTMLRenderType>, output: string) => string;
+type HTMLComponentPlugin = (cxt: RenderContext<HTMLRenderType>) => Node | Node[] | undefined;
+type HTMLPostprocessPlugin = (cxt: RenderContext<HTMLRenderType>, output: Document) => void;
 declare class HTMLRenderState {
     title: string;
     stylesheet: string;
     cssVariables: Map<string, string>;
-    escape(content: string): string;
-    invalidBlock(node: BlockEntity, msg: string): string;
-    invalidInline(node: InlineEntity, msg: string): string;
-    render(elems: (BlockEntity | InlineEntity)[], cxt: RenderContext<HTMLRenderType>): string;
+    invalidBlock(node: BlockEntity, msg: string): minimal_jsx_runtime.JSX.Element;
+    invalidInline(node: InlineEntity, msg: string): minimal_jsx_runtime.JSX.Element;
+    render(elems: (BlockEntity | InlineEntity)[], cxt: RenderContext<HTMLRenderType>): DocumentFragment;
 }
 declare const HTMLRenderConfiguration: ReadonlyRenderConfiguration<HTMLRenderType>;
 
@@ -544,11 +620,15 @@ declare const debugPrint: {
     blockShorthand: (x: BlockShorthand<any>) => string;
     argument: (arg: ModifierArgument) => string;
     node: (...nodes: (BlockEntity | InlineEntity)[]) => string;
-    message: (m: Message, source?: string, descriptor?: SourceDescriptor) => string;
+    message: typeof debugPrintMsg;
+    range: typeof debugPrintRange;
     document: typeof debugDumpDocument;
 };
-declare function debugDumpDocument(doc: Document, source: string): string;
+declare function debugPrintRange(loc: LocationRange, context?: number): string;
+declare function debugPrintMsg(m: Message): string;
+declare function debugDumpDocument(doc: Document$1): string;
 
+declare const emmmVersion = "0.0.6";
 declare function setDebugLevel(level: DebugLevel): void;
 
-export { type ArgumentEntity, ArgumentInterpolatorDefinition, type BlockEntity, BlockModifierDefinition, type BlockModifierNode, type BlockRendererDefiniton, type BlockShorthand, BuiltinConfiguration, Configuration, DebugLevel, DefaultConfiguration, Document, type DocumentNode, type EscapedNode, type HTMLComponentPlugin, type HTMLPostprocessPlugin, HTMLRenderConfiguration, type HTMLRenderPlugin, HTMLRenderState, type HTMLRenderType, type HTMLRendererOptions, type InlineEntity, InlineModifierDefinition, type InlineModifierNode, type InlineRendererDefiniton, type InlineShorthand, type InterpolationNode, type LocationRange, type Message, MessageSeverity, type ModifierArgument, type ModifierNode, ModifierSlotType, type NodeRenderer, type NodeRendererDefinition, NodeType, type ParagraphNode, ParseContext, type ParseContextStoreDefinitions, type ParseContextStoreKey, type PreNode, type ReadonlyConfiguration, type ReadonlyRenderConfiguration, RenderConfiguration, RenderContext, type RendererType, type RootNode, type Scanner, SimpleScanner, type SourceDescriptor, SystemModifierDefinition, type SystemModifierNode, type TextNode, debugPrint, messages, parse, setDebugLevel };
+export { type ArgumentEntity, ArgumentInterpolatorDefinition, type BlockEntity, BlockModifierDefinition, type BlockModifierNode, type BlockRendererDefiniton, type BlockShorthand, BuiltinConfiguration, Configuration, DebugLevel, DefaultConfiguration, Document$1 as Document, type DocumentNode, type EscapedNode, type HTMLComponentPlugin, type HTMLPostprocessPlugin, HTMLRenderConfiguration, type HTMLRenderPlugin, HTMLRenderState, type HTMLRenderType, type HTMLRendererOptions, type InlineEntity, InlineModifierDefinition, type InlineModifierNode, type InlineRendererDefiniton, type InlineShorthand, type InterpolationNode, type LocationRange, type Message, MessageSeverity, type ModifierArgument, type ModifierNode, ModifierSlotType, type NodeRenderer, type NodeRendererDefinition, NodeType, type ParagraphNode, ParseContext, type ParseContextStoreDefinitions, type ParseContextStoreKey, type PreNode, type ReadonlyConfiguration, type ReadonlyRenderConfiguration, RenderConfiguration, RenderContext, type RendererType, type RootNode, type Scanner, SimpleScanner, type Source, type SourceDescriptor, StringSource, SystemModifierDefinition, type SystemModifierNode, type TextNode, debugPrint, emmmVersion, modifierHelper as helper, messages, parse, setDebugLevel };