@openuji/speculator 0.5.3 → 0.5.4

package/dist/parse/registry.d.ts

@@ -1,17 +1,13 @@
 /**
  * Parse Handler Registry
  *
- * Provides a modular architecture for parser modules.
- * Parser modules handle specific hast/mdast nodes and emit SpecAST nodes.
+ * Manages the registration and lookup of HTML and Markdown parser modules.
  */
-import type { Element, RootContent } from 'hast';
+import type { Element } from 'hast';
 import type { RootContent as MdastRootContent } from 'mdast';
+import type { Block, Inline, Section } from '#src/types/ast.generated';
 import type { SourceUnit } from '#src/preprocess/types';
-import type { Section, Block, Inline, SourcePos } from '#src/types/ast.generated';
-import type { ParseDiagnostic } from '#src/parse/types';
-/**
- * Node with optional position information
- */
+/** Node with position info from standard parsers */
 export interface NodeWithPosition {
     position?: {
         start: {
@@ -19,138 +15,101 @@ export interface NodeWithPosition {
             column: number;
             offset?: number;
         };
-        end?: {
+        end: {
             line: number;
             column: number;
             offset?: number;
         };
     };
 }
-/**
- * Result of handling a node - can emit blocks, inlines, or null
- */
-export type HandlerResult = Section | Block | Inline | (Section | Block)[] | Inline[] | null;
-/**
- * Block-level handler result
- */
-export type BlockHandlerResult = Section | Block | (Section | Block)[] | null;
-/**
- * Inline-level handler result
- */
+/** Result of a block-level parse handler */
+export type BlockHandlerResult = Block | Section | (Block | Section)[] | null;
+/** Result of an inline-level parse handler */
 export type InlineHandlerResult = Inline | Inline[] | null;
+/** Generic result type for either block or inline handler */
+export type HandlerResult = BlockHandlerResult | InlineHandlerResult;
 /**
- * Unified context provided to parser modules
- *
- * This is the common interface for both HTML and Markdown parser modules.
- * Some methods may be no-ops depending on the format.
+ * Context provided to parser modules during transformation.
  */
 export interface ParseContext {
-    /** Source unit being parsed */
+    /** The source unit being parsed */
     readonly unit: SourceUnit;
-    /** Create source position from node */
-    createSourcePos(node: NodeWithPosition): SourcePos | undefined;
-    /** Transform children to inline nodes */
-    transformInlineChildren(children: RootContent[] | MdastRootContent[]): Inline[];
-    /** Transform children to block nodes (recursive) */
-    transformBlockChildren(children: RootContent[] | MdastRootContent[]): (Section | Block)[];
-    /**
-     * Emit a diagnostic from the parser module.
-     * Use for warnings about invalid structure, unsupported elements, etc.
-     */
-    emitDiagnostic(diagnostic: Omit<ParseDiagnostic, 'file'>): void;
+    /** Create a source position for the AST node */
+    createSourcePos(node: NodeWithPosition): any;
+    /** Transform an array of mdast/hast inline children */
+    transformInlineChildren(children: any[]): Inline[];
+    /** Transform an array of mdast/hast block children */
+    transformBlockChildren(children: any[]): (Section | Block)[];
     /** Get text content of element (HTML) */
     getTextContent(element: Element): string;
     /** Get attribute value (HTML) */
     getAttr(element: Element, name: string): string | undefined;
+    /** Registry being used for parsing */
+    readonly registry: ParseHandlerRegistry;
 }
 /**
- * HTML parser module for handling hast elements.
- *
- * Parser modules are first-class modules that live in src/parse/.
- * They handle specific HTML tags and emit SpecAST nodes.
+ * Interface for a Markdown parser module.
  */
-export interface HtmlParserModule {
-    /** Unique parser module name */
+export interface MarkdownParserModule {
     name: string;
-    /** Tag names this parser handles (e.g., ['h1', 'h2', 'h3', 'h4', 'h5', 'h6']) */
+    /** Node types this parser can handle (e.g., 'paragraph', 'text', 'html') */
     handles: string[];
-    /**
-     * Order for deterministic dispatch.
-     * Lower numbers run first. Default is 10.
-     */
+    /** Priority order (lower number = higher priority, runs earlier) */
     order?: number;
-    /** Handle a block-level element */
-    handleBlock?(element: Element, ctx: ParseContext): BlockHandlerResult;
-    /** Handle an inline-level element */
-    handleInline?(element: Element, ctx: ParseContext): InlineHandlerResult;
+    /** Handle block-level transformation */
+    handleBlock?(node: MdastRootContent, ctx: ParseContext): BlockHandlerResult;
+    /** Handle inline-level transformation */
+    handleInline?(node: MdastRootContent, ctx: ParseContext): InlineHandlerResult;
 }
 /**
- * Markdown parser module for handling mdast nodes.
- *
- * Parser modules are first-class modules that live in src/parse/.
- * They handle specific mdast node types and emit SpecAST nodes.
+ * Interface for an HTML parser module.
  */
-export interface MarkdownParserModule {
-    /** Unique parser module name */
+export interface HtmlParserModule {
     name: string;
-    /** Node types this parser handles (e.g., ['heading']) */
+    /** Element tags this parser can handle (e.g., 'dfn', 'xref', 'a') */
     handles: string[];
-    /**
-     * Order for deterministic dispatch.
-     * Lower numbers run first. Default is 10.
-     */
+    /** Priority order (lower number = higher priority, runs earlier) */
     order?: number;
-    /** Handle a block-level node */
-    handleBlock?(node: MdastRootContent, ctx: ParseContext): Block | null;
-    /** Handle an inline-level node */
-    handleInline?(node: MdastRootContent, ctx: ParseContext): InlineHandlerResult;
+    /** Handle block-level element transformation */
+    handleBlock?(element: Element, ctx: ParseContext): BlockHandlerResult;
+    /** Handle inline-level element transformation */
+    handleInline?(element: Element, ctx: ParseContext): InlineHandlerResult;
 }
 /**
- * Registry for parser modules
- *
- * Manages parser modules for HTML tags and Markdown node types.
- * Supports ordering for deterministic dispatch.
+ * Registry for managing HTML and Markdown parser modules.
  */
 export declare class ParseHandlerRegistry {
-    private htmlBlockHandlers;
-    private htmlInlineHandlers;
     private mdBlockHandlers;
     private mdInlineHandlers;
-    /**
-     * Register an HTML parser module
-     */
-    registerHtmlParser(parser: HtmlParserModule): void;
+    private htmlBlockHandlers;
+    private htmlInlineHandlers;
     /**
      * Register a Markdown parser module
      */
     registerMarkdownParser(parser: MarkdownParserModule): void;
     /**
-     * Get HTML block parser for a tag
+     * Get block handlers for a Markdown node type
      */
-    getHtmlBlockHandler(tagName: string): HtmlParserModule | undefined;
+    getMdBlockHandlers(nodeType: string): MarkdownParserModule[];
     /**
-     * Get HTML inline parser for a tag
+     * Get inline handlers for a Markdown node type
      */
-    getHtmlInlineHandler(tagName: string): HtmlParserModule | undefined;
+    getMdInlineHandlers(nodeType: string): MarkdownParserModule[];
     /**
-     * Get Markdown block parser for a node type
-     */
-    getMdBlockHandler(nodeType: string): MarkdownParserModule | undefined;
-    /**
-     * Get Markdown inline parser for a node type
+     * Register an HTML parser module
      */
-    getMdInlineHandler(nodeType: string): MarkdownParserModule | undefined;
+    registerHtmlParser(parser: HtmlParserModule): void;
     /**
-     * Check if a handler exists for HTML tag
+     * Get block handler for an HTML tag
      */
-    hasHtmlHandler(tagName: string): boolean;
+    getHtmlBlockHandler(tagName: string): HtmlParserModule | undefined;
     /**
-     * Check if a handler exists for Markdown node type
+     * Get inline handler for an HTML tag
      */
-    hasMdHandler(nodeType: string): boolean;
+    getHtmlInlineHandler(tagName: string): HtmlParserModule | undefined;
 }
 /**
- * Global default registry instance
+ * Default global registry used by the application.
  */
 export declare const defaultRegistry: ParseHandlerRegistry;
 //# sourceMappingURL=registry.d.ts.map

package/dist/parse/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/parse/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/parse/registry.ts"],"names":[],"mappings":"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"}

package/dist/parse/registry.js

@@ -1,104 +1,85 @@
 /**
  * Parse Handler Registry
  *
- * Provides a modular architecture for parser modules.
- * Parser modules handle specific hast/mdast nodes and emit SpecAST nodes.
+ * Manages the registration and lookup of HTML and Markdown parser modules.
  */
 // ============================================================================
-// Registry
+// Registry Implementation
 // ============================================================================
 /**
- * Registry for parser modules
- *
- * Manages parser modules for HTML tags and Markdown node types.
- * Supports ordering for deterministic dispatch.
+ * Registry for managing HTML and Markdown parser modules.
  */
 export class ParseHandlerRegistry {
-    htmlBlockHandlers = new Map();
-    htmlInlineHandlers = new Map();
     mdBlockHandlers = new Map();
     mdInlineHandlers = new Map();
+    htmlBlockHandlers = new Map();
+    htmlInlineHandlers = new Map();
     /**
-     * Register an HTML parser module
+     * Register a Markdown parser module
      */
-    registerHtmlParser(parser) {
-        for (const tag of parser.handles) {
-            const normalizedTag = tag.toLowerCase();
-            // Check if we should override based on order
+    registerMarkdownParser(parser) {
+        for (const nodeType of parser.handles) {
             if (parser.handleBlock) {
-                const existing = this.htmlBlockHandlers.get(normalizedTag);
-                if (!existing || (parser.order ?? 10) < (existing.order ?? 10)) {
-                    this.htmlBlockHandlers.set(normalizedTag, parser);
-                }
+                const handlers = this.mdBlockHandlers.get(nodeType) || [];
+                handlers.push(parser);
+                handlers.sort((a, b) => (a.order ?? 10) - (b.order ?? 10));
+                this.mdBlockHandlers.set(nodeType, handlers);
             }
             if (parser.handleInline) {
-                const existing = this.htmlInlineHandlers.get(normalizedTag);
-                if (!existing || (parser.order ?? 10) < (existing.order ?? 10)) {
-                    this.htmlInlineHandlers.set(normalizedTag, parser);
-                }
+                const handlers = this.mdInlineHandlers.get(nodeType) || [];
+                handlers.push(parser);
+                handlers.sort((a, b) => (a.order ?? 10) - (b.order ?? 10));
+                this.mdInlineHandlers.set(nodeType, handlers);
             }
         }
     }
     /**
-     * Register a Markdown parser module
+     * Get block handlers for a Markdown node type
      */
-    registerMarkdownParser(parser) {
-        for (const nodeType of parser.handles) {
-            // Check if we should override based on order
+    getMdBlockHandlers(nodeType) {
+        return this.mdBlockHandlers.get(nodeType) || [];
+    }
+    /**
+     * Get inline handlers for a Markdown node type
+     */
+    getMdInlineHandlers(nodeType) {
+        return this.mdInlineHandlers.get(nodeType) || [];
+    }
+    /**
+     * Register an HTML parser module
+     */
+    registerHtmlParser(parser) {
+        for (const tag of parser.handles) {
+            const normalizedTag = tag.toLowerCase();
             if (parser.handleBlock) {
-                const existing = this.mdBlockHandlers.get(nodeType);
+                const existing = this.htmlBlockHandlers.get(normalizedTag);
                 if (!existing || (parser.order ?? 10) < (existing.order ?? 10)) {
-                    this.mdBlockHandlers.set(nodeType, parser);
+                    this.htmlBlockHandlers.set(normalizedTag, parser);
                 }
             }
             if (parser.handleInline) {
-                const existing = this.mdInlineHandlers.get(nodeType);
+                const existing = this.htmlInlineHandlers.get(normalizedTag);
                 if (!existing || (parser.order ?? 10) < (existing.order ?? 10)) {
-                    this.mdInlineHandlers.set(nodeType, parser);
+                    this.htmlInlineHandlers.set(normalizedTag, parser);
                 }
             }
         }
     }
     /**
-     * Get HTML block parser for a tag
+     * Get block handler for an HTML tag
      */
     getHtmlBlockHandler(tagName) {
         return this.htmlBlockHandlers.get(tagName.toLowerCase());
     }
     /**
-     * Get HTML inline parser for a tag
+     * Get inline handler for an HTML tag
      */
     getHtmlInlineHandler(tagName) {
         return this.htmlInlineHandlers.get(tagName.toLowerCase());
     }
-    /**
-     * Get Markdown block parser for a node type
-     */
-    getMdBlockHandler(nodeType) {
-        return this.mdBlockHandlers.get(nodeType);
-    }
-    /**
-     * Get Markdown inline parser for a node type
-     */
-    getMdInlineHandler(nodeType) {
-        return this.mdInlineHandlers.get(nodeType);
-    }
-    /**
-     * Check if a handler exists for HTML tag
-     */
-    hasHtmlHandler(tagName) {
-        const normalized = tagName.toLowerCase();
-        return this.htmlBlockHandlers.has(normalized) || this.htmlInlineHandlers.has(normalized);
-    }
-    /**
-     * Check if a handler exists for Markdown node type
-     */
-    hasMdHandler(nodeType) {
-        return this.mdBlockHandlers.has(nodeType) || this.mdInlineHandlers.has(nodeType);
-    }
 }
 /**
- * Global default registry instance
+ * Default global registry used by the application.
  */
 export const defaultRegistry = new ParseHandlerRegistry();
 //# sourceMappingURL=registry.js.map

package/dist/parse/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/parse/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/parse/registry.ts"],"names":[],"mappings":"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"}

package/dist/parse/types.d.ts

@@ -32,33 +32,11 @@ export interface ParsedSpec {
     document: Document;
 }
 /**
- * Parse diagnostic codes
- */
-export type ParseDiagnosticCode = 'parse-error' | 'invalid-structure' | 'unsupported-element';
-/**
- * Diagnostic severity levels
- */
-export type DiagnosticSeverity = 'error' | 'warning' | 'info';
-/**
- * Parse diagnostic message
- */
-export interface ParseDiagnostic {
-    severity: DiagnosticSeverity;
-    code: ParseDiagnosticCode;
-    message: string;
-    file?: string;
-    sourcePos?: SourcePos;
-}
-/**
- * Parse result with diagnostics
+ * Parse result
  */
 export interface ParseResult {
     /** Parsed spec (may be partial if errors) */
     result?: ParsedSpec;
-    /** Diagnostics from parsing */
-    diagnostics: ParseDiagnostic[];
-    /** Quick check for errors */
-    hasErrors: boolean;
 }
 /**
  * Create a source position from unit context

package/dist/parse/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/parse/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAOpF;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACvB,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAE9B;;;;;OAKG;IACH,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC;CAChD;AAMD;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,oCAAoC;IACpC,MAAM,EAAE,UAAU,CAAC;IAEnB,0BAA0B;IAC1B,QAAQ,EAAE,QAAQ,CAAC;CACtB;AAMD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GACzB,aAAa,GACb,mBAAmB,GACnB,qBAAqB,CAAC;AAE5B;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,SAAS,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,UAAU,CAAC;IAEpB,+BAA+B;IAC/B,WAAW,EAAE,eAAe,EAAE,CAAC;IAE/B,6BAA6B;IAC7B,SAAS,EAAE,OAAO,CAAC;CACtB;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAC3B,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACf,SAAS,CAMX"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/parse/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAOpF;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACvB,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAE9B;;;;;OAKG;IACH,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC;CAChD;AAMD;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,oCAAoC;IACpC,MAAM,EAAE,UAAU,CAAC;IAEnB,0BAA0B;IAC1B,QAAQ,EAAE,QAAQ,CAAC;CACtB;AAMD;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,UAAU,CAAC;CACvB;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAC3B,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACf,SAAS,CAMX"}

package/dist/parse/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/parse/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAsFH,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,eAAe,CAC3B,IAAgB,EAChB,IAAY,EACZ,MAAc;IAEd,OAAO;QACH,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,CAAC;QAC/B,MAAM;KACT,CAAC;AACN,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/parse/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAwDH,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,eAAe,CAC3B,IAAgB,EAChB,IAAY,EACZ,MAAc;IAEd,OAAO;QACH,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,CAAC;QAC/B,MAAM;KACT,CAAC;AACN,CAAC"}

package/dist/parse/utils/hast-utils.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shared HAST Utilities
+ *
+ * Common utility functions for working with hast (HTML AST) nodes,
+ * shared between HTML parsers and markdown HTML inline handling.
+ */
+import type { Element, RootContent as HastRootContent } from 'hast';
+import type { ParseContext } from '#src/parse/registry';
+import type { Inline } from '#src/types/ast.generated';
+/**
+ * Get element attribute value from hast element.
+ * Handles various types: strings, arrays (joins with space), numbers, and booleans.
+ */
+export declare function getAttr(element: Element, name: string): string | undefined;
+/**
+ * Get text content of element recursively.
+ * Extracts all text from nested elements.
+ */
+export declare function getTextContent(element: Element): string;
+/**
+ * Transform a hast node to Speculator inline(s) using HTML handlers.
+ * This is the core transformation logic shared by both paragraph and block HTML parsers.
+ */
+export declare function transformHastInline(node: HastRootContent, ctx: ParseContext): Inline | Inline[] | null;
+/**
+ * Create a hast-aware ParseContext from a base (markdown) context.
+ * This allows hast nodes to be transformed using the same handler infrastructure.
+ */
+export declare function createHastContext(ctx: ParseContext): ParseContext;
+//# sourceMappingURL=hast-utils.d.ts.map

package/dist/parse/utils/hast-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hast-utils.d.ts","sourceRoot":"","sources":["../../../src/parse/utils/hast-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAoB,WAAW,IAAI,eAAe,EAAE,MAAM,MAAM,CAAC;AAEtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO1E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAUvD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAsBtG;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,CAwBjE"}

package/dist/parse/utils/hast-utils.js

@@ -0,0 +1,94 @@
+/**
+ * Shared HAST Utilities
+ *
+ * Common utility functions for working with hast (HTML AST) nodes,
+ * shared between HTML parsers and markdown HTML inline handling.
+ */
+/**
+ * Get element attribute value from hast element.
+ * Handles various types: strings, arrays (joins with space), numbers, and booleans.
+ */
+export function getAttr(element, name) {
+    const val = element.properties?.[name];
+    if (typeof val === 'string')
+        return val;
+    if (Array.isArray(val))
+        return val.join(' ');
+    if (typeof val === 'number')
+        return String(val);
+    if (typeof val === 'boolean' && val)
+        return name;
+    return undefined;
+}
+/**
+ * Get text content of element recursively.
+ * Extracts all text from nested elements.
+ */
+export function getTextContent(element) {
+    let text = '';
+    for (const child of element.children) {
+        if (child.type === 'text') {
+            text += child.value;
+        }
+        else if (child.type === 'element') {
+            text += getTextContent(child);
+        }
+    }
+    return text;
+}
+/**
+ * Transform a hast node to Speculator inline(s) using HTML handlers.
+ * This is the core transformation logic shared by both paragraph and block HTML parsers.
+ */
+export function transformHastInline(node, ctx) {
+    if (node.type === 'text') {
+        const textValue = node.value;
+        // Delegate back to Markdown's transformInlineChildren to handle shorthands (|var|)
+        const res = ctx.transformInlineChildren([{ type: 'text', value: textValue }]);
+        return res.length === 0 ? null : res;
+    }
+    if (node.type !== 'element')
+        return null;
+    const element = node;
+    const tagName = element.tagName.toLowerCase();
+    // Look up handler in the registry provided in the context
+    const handler = ctx.registry.getHtmlInlineHandler(tagName);
+    if (handler?.handleInline) {
+        return handler.handleInline(element, ctx);
+    }
+    // Fallback: recurse into children if no handler for this tag
+    return ctx.transformInlineChildren(element.children);
+}
+/**
+ * Create a hast-aware ParseContext from a base (markdown) context.
+ * This allows hast nodes to be transformed using the same handler infrastructure.
+ */
+export function createHastContext(ctx) {
+    const originalTransform = ctx.transformInlineChildren;
+    const hastCtx = {
+        ...ctx,
+        transformInlineChildren: (children) => {
+            const results = [];
+            for (const child of children) {
+                if (child.type === 'element') {
+                    const res = transformHastInline(child, hastCtx);
+                    if (res) {
+                        if (Array.isArray(res))
+                            results.push(...res);
+                        else
+                            results.push(res);
+                    }
+                }
+                else {
+                    // Delegate anything else (text, mdast nodes) to the original transformer
+                    results.push(...originalTransform([child]));
+                }
+            }
+            return results;
+        },
+        getTextContent,
+        getAttr,
+    };
+    return hastCtx;
+}
+//# sourceMappingURL=hast-utils.js.map

package/dist/parse/utils/hast-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hast-utils.js","sourceRoot":"","sources":["../../../src/parse/utils/hast-utils.ts"],"names":[],"mappings":"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"}

package/dist/pipeline/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/pipeline/runner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAK7D,OAAO,KAAK,EACR,MAAM,EAEN,eAAe,EAElB,MAAM,YAAY,CAAC;AAiCpB;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,OAAO,CAAW;gBAEd,OAAO,GAAE,MAAM,EAAO;IAIlC;;;OAGG;IACG,GAAG,CAAC,OAAO,EAAE;QACf,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,YAAY,CAAC;KAC9B,GAAG,OAAO,CAAC,eAAe,CAAC;IAO5B;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE;QACxB,OAAO,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAClD,YAAY,EAAE,YAAY,CAAC;KAC9B,GAAG,OAAO,CAAC,eAAe,CAAC;CAmF/B"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/pipeline/runner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAK7D,OAAO,KAAK,EACR,MAAM,EAEN,eAAe,EAElB,MAAM,YAAY,CAAC;AAiCpB;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,OAAO,CAAW;gBAEd,OAAO,GAAE,MAAM,EAAO;IAIlC;;;OAGG;IACG,GAAG,CAAC,OAAO,EAAE;QACf,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,YAAY,CAAC;KAC9B,GAAG,OAAO,CAAC,eAAe,CAAC;IAO5B;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE;QACxB,OAAO,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAClD,YAAY,EAAE,YAAY,CAAC;KAC9B,GAAG,OAAO,CAAC,eAAe,CAAC;CAsF/B"}

package/dist/pipeline/runner.js

@@ -62,19 +62,23 @@ export class SpeculatorPipeline {
         const results = [];
         // 1. Initial run: Preprocess + Parse
         for (const entryConfig of options.entries) {
-            const preprocessResult = await preprocess({
-                entry: entryConfig.entry,
-                configPath: entryConfig.configPath,
-                fileProvider: options.fileProvider,
-            });
-            if (!preprocessResult.result)
-                continue;
-            const registry = new ParseHandlerRegistry();
-            registerCoreParsers(registry);
-            const parseResult = parseWithRegistry(preprocessResult.result, registry);
-            if (!parseResult.result)
+            try {
+                const preprocessedSpec = await preprocess({
+                    entry: entryConfig.entry,
+                    configPath: entryConfig.configPath,
+                    fileProvider: options.fileProvider,
+                });
+                const registry = new ParseHandlerRegistry();
+                registerCoreParsers(registry);
+                const parseResult = parseWithRegistry(preprocessedSpec, registry);
+                if (!parseResult.result)
+                    continue;
+                results.push({ doc: parseResult.result.document, entry: entryConfig.entry });
+            }
+            catch {
+                // Preprocess errors are now thrown, skip this entry
                 continue;
-            results.push({ doc: parseResult.result.document, entry: entryConfig.entry });
+            }
         }
         if (results.length === 0) {
             return {};