@openuji/speculator 0.7.4 → 0.8.0

package/dist/parse/pipeline.js

@@ -8,6 +8,7 @@ import { MarkdownUnitParser } from '#src/parse/markdown/index';
 import { HtmlUnitParser } from '#src/parse/html/index';
 import { assembleDocument } from '#src/parse/assembler';
 import { defaultRegistry } from '#src/parse/registry';
+import { SourceMapper } from '#src/parse/source-mapper';
 /**
  * Parser registry - maps format to parser factory
  */
@@ -30,16 +31,36 @@ function getParser(parsers, format) {
     return parser;
 }
 /**
- * Parse a single source unit
+ * Helper to parse content with error handling
  */
-function parseUnit(unit, parsers) {
+function parseContent(content, format, sourceMapper, entryFile, parsers, errors) {
     try {
-        const parser = getParser(parsers, unit.format);
-        return parser.parse(unit);
+        const parser = getParser(parsers, format);
+        return parser.parse(content, sourceMapper);
     }
     catch (error) {
-        // Fallback or error handling if needed, but for now just returning empty if parser fails
-        console.error(`Failed to parse ${unit.file}: ${error instanceof Error ? error.message : String(error)}`);
+        const message = error instanceof Error ? error.message : String(error);
+        // Extract position from message if adjusted by parser (e.g. "(99:1)")
+        const posMatch = message.match(/\((\d+):(\d+)(?:-[\d:]+)?\)/);
+        let posSuffix = "";
+        let reportedFile = entryFile;
+        if (posMatch) {
+            const startLineOffset = parseInt(posMatch[1], 10);
+            // Convert remark's global line to actual source line via mapper
+            const srcPos = sourceMapper.createSourcePos({ start: { line: startLineOffset, column: parseInt(posMatch[2], 10), offset: 0 } });
+            if (srcPos) {
+                reportedFile = srcPos.file;
+                posSuffix = `:${srcPos.line}:${srcPos.column}`;
+            }
+            else {
+                posSuffix = `:${posMatch[1]}:${posMatch[2]}`;
+            }
+        }
+        const formattedError = `${reportedFile}${posSuffix}: ${message}`;
+        errors.push(formattedError);
+        console.error(formattedError);
+        if (error instanceof Error)
+            console.error(error);
         return [];
     }
 }
@@ -47,22 +68,28 @@ function parseUnit(unit, parsers) {
  * Internal parse implementation
  */
 function parseInternal(preprocessed, parsers) {
-    const allBlocks = [];
-    // Parse each unit in order
-    for (const unit of preprocessed.source.units) {
-        const blocks = parseUnit(unit, parsers);
-        allBlocks.push(...blocks);
+    const errors = [];
+    const source = preprocessed.source;
+    const sourceMapper = new SourceMapper(source.content, source.sourceMap);
+    // If entry is HTML but we have markdown fragments, we MUST use the Markdown/MDX
+    // parser for the whole thing to allow markdown-inside-tags. MDX is a superset
+    // of HTML for our purposes.
+    let effectiveFormat = source.entryFormat;
+    if (effectiveFormat === 'html' && source.sourceMap.fragments.some(f => f.format === 'markdown')) {
+        effectiveFormat = 'markdown';
     }
-    if (allBlocks.length === 0) {
-        return {};
+    const blocks = parseContent(source.content, effectiveFormat, sourceMapper, source.entryFile, parsers, errors);
+    if (blocks.length === 0) {
+        return { errors: errors.length > 0 ? errors : undefined };
     }
     // Assemble document
-    const document = assembleDocument(allBlocks, preprocessed.config, preprocessed.source.entryFile);
+    const document = assembleDocument(blocks, preprocessed.config, preprocessed.source.entryFile);
     return {
         result: {
             config: preprocessed.config,
             document,
         },
+        errors: errors.length > 0 ? errors : undefined
     };
 }
 /**

package/dist/parse/pipeline.js.map

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

package/dist/parse/registry.d.ts

@@ -6,7 +6,7 @@
 import type { Element, RootContent as HastRootContent } from 'hast';
 import type { RootContent as MdastRootContent } from 'mdast';
 import type { Block, Inline, Section, SourcePos } from '#src/types/ast.generated';
-import type { SourceUnit } from '#src/preprocess/types';
+import type { SourceMapper } from '#src/parse/source-mapper';
 /** Node with position info from standard parsers */
 export interface NodeWithPosition {
     position?: {
@@ -36,8 +36,8 @@ export type ParseContextChildren = HastRootContent[] | MdastRootContent[];
  * Context provided to parser modules during transformation.
  */
 export interface ParseContext {
-    /** The source unit being parsed */
-    readonly unit: SourceUnit;
+    /** The source mapper for absolute coordinates */
+    readonly sourceMapper: SourceMapper;
     /** Create a source position for the AST node */
     createSourcePos(node: NodeWithPosition): SourcePos;
     /** Transform an array of mdast/hast inline children */
@@ -106,11 +106,11 @@ export declare class ParseHandlerRegistry {
     /**
      * Get block handler for an HTML tag
      */
-    getHtmlBlockHandler(tagName: string): HtmlParserModule | undefined;
+    getHtmlBlockHandlers(tagName: string): HtmlParserModule[];
     /**
      * Get inline handler for an HTML tag
      */
-    getHtmlInlineHandler(tagName: string): HtmlParserModule | undefined;
+    getHtmlInlineHandlers(tagName: string): HtmlParserModule[];
 }
 /**
  * Default global registry used by the application.

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

@@ -52,30 +52,30 @@ export class ParseHandlerRegistry {
         for (const tag of parser.handles) {
             const normalizedTag = tag.toLowerCase();
             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.htmlBlockHandlers.get(normalizedTag) || [];
+                handlers.push(parser);
+                handlers.sort((a, b) => (a.order ?? 10) - (b.order ?? 10));
+                this.htmlBlockHandlers.set(normalizedTag, 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.htmlInlineHandlers.get(normalizedTag) || [];
+                handlers.push(parser);
+                handlers.sort((a, b) => (a.order ?? 10) - (b.order ?? 10));
+                this.htmlInlineHandlers.set(normalizedTag, handlers);
             }
         }
     }
     /**
      * Get block handler for an HTML tag
      */
-    getHtmlBlockHandler(tagName) {
-        return this.htmlBlockHandlers.get(tagName.toLowerCase());
+    getHtmlBlockHandlers(tagName) {
+        return this.htmlBlockHandlers.get(tagName.toLowerCase()) || [];
     }
     /**
      * Get inline handler for an HTML tag
      */
-    getHtmlInlineHandler(tagName) {
-        return this.htmlInlineHandlers.get(tagName.toLowerCase());
+    getHtmlInlineHandlers(tagName) {
+        return this.htmlInlineHandlers.get(tagName.toLowerCase()) || [];
     }
 }
 /**

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/source-mapper.d.ts

@@ -0,0 +1,42 @@
+import type { SourceMap } from '#src/preprocess/types';
+import type { SourcePos } from '#src/types/ast.generated';
+/**
+ * Maps a global character offset in the concatenated content string
+ * back to the original file and line number.
+ */
+export declare class SourceMapper {
+    private sourceMap;
+    private globalLineStarts;
+    constructor(content: string, sourceMap: SourceMap);
+    private buildLineMapping;
+    /**
+     * Converts an absolute offset in the composed string to an absolute line/column.
+     */
+    private offsetToGlobalLineColumn;
+    /**
+     * Find the source map fragment that covers the given offset.
+     */
+    private findFragment;
+    /**
+     * Creates a full SourcePos mapping for a given set of absolute offsets/lines/columns.
+     * Since remark gives us global lines and columns for the concatenated string,
+     * we will map those to original lines based on the fragment.
+     */
+    createSourcePos(pos: {
+        start: {
+            line: number;
+            column: number;
+            offset?: number;
+        };
+        end?: {
+            line: number;
+            column: number;
+            offset?: number;
+        };
+    }): SourcePos | undefined;
+    /**
+     * Get sideFiles for a given offset. Useful for resolving relative assets/vocabularies.
+     */
+    getSideFiles(offset: number): Record<string, string> | undefined;
+}
+//# sourceMappingURL=source-mapper.d.ts.map

package/dist/parse/source-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-mapper.d.ts","sourceRoot":"","sources":["../../src/parse/source-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAqB,MAAM,uBAAuB,CAAC;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;;GAGG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,SAAS,CAAY;IAE7B,OAAO,CAAC,gBAAgB,CAAgB;gBAE5B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS;IAOjD,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAuBhC;;OAEG;IACH,OAAO,CAAC,YAAY;IA6BpB;;;;OAIG;IACI,eAAe,CAClB,GAAG,EAAE;QAAE,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,GAAG,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GAC3H,SAAS,GAAG,SAAS;IAkCxB;;OAEG;IACI,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS;CAI1E"}

package/dist/parse/source-mapper.js

@@ -0,0 +1,117 @@
+/**
+ * Maps a global character offset in the concatenated content string
+ * back to the original file and line number.
+ */
+export class SourceMapper {
+    sourceMap;
+    // Cache the lines array for the composed content so we can convert offset -> line/column
+    globalLineStarts = [];
+    constructor(content, sourceMap) {
+        this.sourceMap = sourceMap;
+        if (content) {
+            this.buildLineMapping(content);
+        }
+    }
+    buildLineMapping(content) {
+        this.globalLineStarts.push(0);
+        for (let i = 0; i < content.length; i++) {
+            if (content[i] === '\n') {
+                this.globalLineStarts.push(i + 1);
+            }
+        }
+    }
+    /**
+     * Converts an absolute offset in the composed string to an absolute line/column.
+     */
+    offsetToGlobalLineColumn(offset) {
+        // Binary search to find the line
+        let low = 0;
+        let high = this.globalLineStarts.length - 1;
+        while (low <= high) {
+            const mid = Math.floor((low + high) / 2);
+            if (this.globalLineStarts[mid] <= offset) {
+                if (mid === this.globalLineStarts.length - 1 || this.globalLineStarts[mid + 1] > offset) {
+                    return {
+                        line: mid + 1, // 1-indexed
+                        column: offset - this.globalLineStarts[mid] + 1 // 1-indexed
+                    };
+                }
+                low = mid + 1;
+            }
+            else {
+                high = mid - 1;
+            }
+        }
+        return { line: 1, column: 1 };
+    }
+    /**
+     * Find the source map fragment that covers the given offset.
+     */
+    findFragment(offset) {
+        // Binary search the fragments (they are ordered by startOffset and non-overlapping)
+        let low = 0;
+        let high = this.sourceMap.fragments.length - 1;
+        while (low <= high) {
+            const mid = Math.floor((low + high) / 2);
+            const fragment = this.sourceMap.fragments[mid];
+            if (offset >= fragment.startOffset && offset < fragment.endOffset) {
+                return fragment;
+            }
+            else if (offset < fragment.startOffset) {
+                high = mid - 1;
+            }
+            else {
+                low = mid + 1;
+            }
+        }
+        // Fallback: if offset equals the document length, return the last fragment
+        if (offset > 0 && this.sourceMap.fragments.length > 0) {
+            const last = this.sourceMap.fragments[this.sourceMap.fragments.length - 1];
+            if (offset === last.endOffset) {
+                return last;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Creates a full SourcePos mapping for a given set of absolute offsets/lines/columns.
+     * Since remark gives us global lines and columns for the concatenated string,
+     * we will map those to original lines based on the fragment.
+     */
+    createSourcePos(pos) {
+        if (pos.start.offset === undefined)
+            return undefined;
+        const fragment = this.findFragment(pos.start.offset);
+        if (!fragment)
+            return undefined;
+        // remark gives us global line. We need to find how many lines into the fragment we are.
+        const fragmentStartGlobalLC = this.offsetToGlobalLineColumn(fragment.startOffset);
+        // The local line offset within the fragment
+        const linesIntoFragment = pos.start.line - fragmentStartGlobalLC.line;
+        const originalLine = fragment.originalStartLine + linesIntoFragment;
+        const result = {
+            file: fragment.file,
+            line: originalLine,
+            column: pos.start.column,
+            offset: pos.start.offset, // keeping global offset. If we want local offset: (pos.start.offset - fragment.startOffset)
+        };
+        if (pos.end && pos.end.offset !== undefined) {
+            result.endColumn = pos.end.column;
+            result.endOffset = pos.end.offset; // global end
+            // if it stays in the same fragment, simple math
+            // technically block ends might fall into a different fragment if include spans, 
+            // but we'll use the start fragment's file and calculate endLine relative to the start fragment
+            const endLinesIntoFragment = pos.end.line - fragmentStartGlobalLC.line;
+            result.endLine = fragment.originalStartLine + endLinesIntoFragment;
+        }
+        return result;
+    }
+    /**
+     * Get sideFiles for a given offset. Useful for resolving relative assets/vocabularies.
+     */
+    getSideFiles(offset) {
+        const fragment = this.findFragment(offset);
+        return fragment?.sideFiles;
+    }
+}
+//# sourceMappingURL=source-mapper.js.map

package/dist/parse/source-mapper.js.map

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

package/dist/parse/types.d.ts

@@ -3,8 +3,9 @@
  *
  * Types for parsing source units into AST nodes.
  */
-import type { SourceUnit, SourceFormat, SpecConfig } from '#src/preprocess/types';
-import type { Section, Block, SourcePos, Document } from '#src/types/ast.generated';
+import type { SourceFormat, SpecConfig } from '#src/preprocess/types';
+import type { Section, Block, Document } from '#src/types/ast.generated';
+import type { SourceMapper } from '#src/parse/source-mapper';
 /**
  * Interface for format-specific unit parsers
  *
@@ -15,12 +16,24 @@ export interface UnitParser {
     /** Format this parser handles */
     readonly format: SourceFormat;
     /**
-     * Parse a source unit into AST blocks
+     * Parse a final composed string into AST blocks using a source mapper
+     * for location tracking.
      *
-     * @param unit - Source unit to parse
+     * Overload 1: New API with content string and SourceMapper
+     * Overload 2: Legacy API with SourceUnit-like object (backwards compat for tests)
+     *
+     * @param content - Full composed source string
+     * @param sourceMapper - Mapper to resolve absolute offsets to original files
      * @returns Array of top-level blocks/sections
      */
-    parse(unit: SourceUnit): (Section | Block)[];
+    parse(content: string, sourceMapper: SourceMapper): (Section | Block)[];
+    parse(unit: {
+        content: string;
+        file: string;
+        format: string;
+        startLine: number;
+        sideFiles?: Record<string, string>;
+    }): (Section | Block)[];
 }
 /**
  * Result of parsing a preprocessed spec
@@ -37,9 +50,7 @@ export interface ParsedSpec {
 export interface ParseResult {
     /** Parsed spec (may be partial if errors) */
     result?: ParsedSpec;
+    /** Encountered errors */
+    errors?: string[];
 }
-/**
- * Create a source position from unit context
- */
-export declare function createSourcePos(unit: SourceUnit, line: number, column: number): SourcePos;
 //# sourceMappingURL=types.d.ts.map

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,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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/parse/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAO7D;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACvB,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAE9B;;;;;;;;;;OAUG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC;IACxE,KAAK,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC;CAC9I;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;IACpB,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB"}

package/dist/parse/types.js

@@ -3,17 +3,6 @@
  *
  * Types for parsing source units into AST nodes.
  */
-// ============================================================================
-// Helpers
-// ============================================================================
-/**
- * Create a source position from unit context
- */
-export function createSourcePos(unit, line, column) {
-    return {
-        file: unit.file,
-        line: unit.startLine + line - 1,
-        column,
-    };
-}
+export {};
+// Keep file valid but removed helpers not needed for offset-based mapping
 //# sourceMappingURL=types.js.map

package/dist/parse/types.js.map

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

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

@@ -1 +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,EAAkB,MAAM,MAAM,CAAC;AAEtG,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,qBAAqB,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAkB,MAAM,0BAA0B,CAAC;AAyBlG;;;GAGG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAe1E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAUvD;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAuBtG;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,EAAE,CA4BhG;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,EAAE,eAAe,CAAC,EAAE,SAAS,GAAG,YAAY,CA2K9F"}
+{"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,EAAkB,MAAM,MAAM,CAAC;AAEtG,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,qBAAqB,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAkB,MAAM,0BAA0B,CAAC;AA0BlG;;;GAGG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAqB1E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAUvD;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAgCtG;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,EAAE,CA6ChG;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,EAAE,eAAe,CAAC,EAAE,SAAS,GAAG,YAAY,CAmL9F"}

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

@@ -5,6 +5,7 @@
  * shared between HTML parsers and markdown HTML inline handling.
  */
 import { visit } from 'unist-util-visit';
+import { createBlockHtmlElement, createInlineHtmlElement } from './html-element-utils.js';
 /**
  * Offset the position of mdast nodes by a given number of lines.
  * This is used when parsing markdown content inside HTML blocks,
@@ -30,6 +31,13 @@ function offsetMdastNodes(nodes, offsetLine) {
  */
 export function getAttr(element, name) {
     let val = element.properties?.[name];
+    // Handle class/className alias
+    if (val === undefined) {
+        if (name === 'class')
+            val = element.properties?.className;
+        else if (name === 'className')
+            val = element.properties?.class;
+    }
     // Fallback: handle data- attributes (check both camelCase and kebab-case)
     if (val === undefined && name.startsWith('data')) {
         const camel = name.replace(/-([a-z0-9])/g, (g) => g[1].toUpperCase());
@@ -62,7 +70,7 @@ export function getTextContent(element) {
     }
     return text;
 }
-import { parseMarkdownInlines, parseMarkdownBlocks } from './markdown-utils.js';
+import { isHtmlBlockTag, parseMarkdownInlines, parseMarkdownBlocks } from './markdown-utils.js';
 /**
  * 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.
@@ -79,13 +87,20 @@ export function transformHastInline(node, ctx) {
         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);
+    // Look up handlers in the registry provided in the context
+    const handlers = ctx.registry.getHtmlInlineHandlers(tagName);
+    if (handlers.length > 0) {
+        for (const handler of handlers) {
+            if (handler.handleInline) {
+                const result = handler.handleInline(element, ctx);
+                if (result !== null)
+                    return result;
+            }
+        }
+        // All tried handlers returned null
+        return null;
     }
-    // Fallback: recurse into children if no handler for this tag
-    return ctx.transformInlineChildren(element.children);
+    return createInlineHtmlElement(element, ctx, ctx.transformInlineChildren(element.children));
 }
 /**
  * Transform a hast node to Speculator block(s) using HTML handlers.
@@ -95,28 +110,44 @@ export function transformHastBlock(node, ctx) {
         return [];
     const element = node;
     const tagName = element.tagName.toLowerCase();
-    const handler = ctx.registry.getHtmlBlockHandler(tagName);
-    if (handler?.handleBlock) {
-        const result = handler.handleBlock(element, ctx);
-        if (result === null)
-            return [];
-        if (Array.isArray(result))
-            return result;
-        return [result];
+    const handlers = ctx.registry.getHtmlBlockHandlers(tagName);
+    if (handlers.length > 0) {
+        for (const handler of handlers) {
+            if (handler.handleBlock) {
+                const result = handler.handleBlock(element, ctx);
+                if (result !== null) {
+                    if (Array.isArray(result))
+                        return result;
+                    return [result];
+                }
+            }
+        }
     }
-    // Fallback: wrap as paragraph if it has inline content
-    const sourcePos = ctx.createSourcePos(element);
-    const inlines = ctx.transformInlineChildren(element.children);
-    if (inlines.length > 0) {
-        const result = {
-            type: 'paragraph',
-            children: inlines,
-        };
-        if (sourcePos)
-            result.sourcePos = sourcePos;
-        return [result];
+    const inlineHandlers = ctx.registry.getHtmlInlineHandlers(tagName);
+    if (inlineHandlers.length > 0) {
+        for (const inlineHandler of inlineHandlers) {
+            if (inlineHandler.handleInline) {
+                const inlineResult = inlineHandler.handleInline(element, ctx);
+                if (inlineResult !== null) {
+                    const sourcePos = ctx.createSourcePos(element);
+                    const inlines = Array.isArray(inlineResult) ? inlineResult : [inlineResult];
+                    const paragraph = {
+                        type: 'paragraph',
+                        children: inlines,
+                    };
+                    if (sourcePos)
+                        paragraph.sourcePos = sourcePos;
+                    return [paragraph];
+                }
+            }
+        }
     }
-    return [];
+    // Only fall back to generic element if NO handlers were registered for this tag at all.
+    // If handlers existed but all returned null, we return an empty block list.
+    if (handlers.length > 0 || inlineHandlers.length > 0) {
+        return [];
+    }
+    return [createBlockHtmlElement(element, ctx, ctx.transformBlockChildren(element.children))];
 }
 /**
  * Create a hast-aware ParseContext from a base (markdown) context.
@@ -164,6 +195,13 @@ export function createHastContext(ctx, parentSourcePos) {
             const camelName = name.replace(/-([a-z])/g, (g) => g[1].toUpperCase());
             val = element.properties?.[camelName];
         }
+        // Handle class/className alias
+        if (val === undefined) {
+            if (name === 'class')
+                val = element.properties?.className;
+            else if (name === 'className')
+                val = element.properties?.class;
+        }
         if (Array.isArray(val)) {
             return val.join(' ');
         }
@@ -241,8 +279,10 @@ export function createHastContext(ctx, parentSourcePos) {
                 if (child.type === 'element') {
                     // We know it's an element, but TS needs help differentiating from the generic object
                     const element = child;
-                    const handler = hastCtx.registry.getHtmlBlockHandler(element.tagName.toLowerCase());
-                    if (handler?.handleBlock) {
+                    const tagName = element.tagName.toLowerCase();
+                    const handlers = hastCtx.registry.getHtmlBlockHandlers(tagName);
+                    const shouldTreatAsBlock = handlers.some(h => h.handleBlock) || isHtmlBlockTag(tagName);
+                    if (shouldTreatAsBlock) {
                         flushInlines();
                         results.push(...transformHastBlock(child, hastCtx));
                         continue;