@openuji/speculator 0.3.1 → 0.4.0

package/dist/parse/parsers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsers.js","sourceRoot":"","sources":["../../src/parse/parsers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,sBAAsB;AACtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,0BAA0B;AAC1B,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAEtE,yBAAyB;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAItE;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAuB;IAC/C,4CAA4C;IAC5C,aAAa,EAAQ,WAAW;IAChC,cAAc,EAAO,WAAW;IAChC,eAAe,EAAM,WAAW;IAChC,mBAAmB;IACnB,kBAAkB,EAAG,YAAY;IACjC,kBAAkB,EAAG,YAAY;IACjC,oBAAoB,EAAC,YAAY;IACjC,eAAe,EAAM,YAAY;IACjC,cAAc,EAAO,YAAY;IACjC,oBAAoB,EAAC,YAAY;IACjC,gBAAgB,EAAK,YAAY;IACjC,iBAAiB,EAAI,YAAY;IACjC,oCAAoC;IACpC,cAAc,EAAO,YAAY;CACpC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA2B;IACvD,mBAAmB;IACnB,sBAAsB,EAAG,YAAY;IACrC,wBAAwB,EAAC,YAAY;IACrC,mBAAmB,EAAM,YAAY;IACrC,kBAAkB,EAAO,YAAY;IACrC,wBAAwB,EAAC,YAAY;IACrC,oBAAoB,EAAK,YAAY;IACrC,qBAAqB,EAAI,YAAY;IACrC,oCAAoC;IACpC,kBAAkB,EAAO,YAAY;CACxC,CAAC"}

package/dist/parse/pipeline.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Parse Pipeline
+ *
+ * Orchestrates parsing of preprocessed spec into Document AST.
+ * Parser modules are registered automatically when importing html/index and markdown/index.
+ */
+import type { PreprocessedSpec } from '#src/preprocess/types';
+import type { UnitParser, ParseResult } from '#src/parse/types';
+import { ParseHandlerRegistry } from '#src/parse/registry';
+/**
+ * Parse a preprocessed spec into a Document AST
+ *
+ * Uses the default registry with core handlers.
+ *
+ * @param preprocessed - Preprocessed spec with config and source units
+ * @returns ParseResult with document and diagnostics
+ */
+export declare function parse(preprocessed: PreprocessedSpec): ParseResult;
+/**
+ * Parse a preprocessed spec using a custom handler registry
+ *
+ * This allows the pipeline to use plugin-registered handlers.
+ *
+ * @param preprocessed - Preprocessed spec with config and source units
+ * @param registry - Custom handler registry with plugin handlers
+ * @returns ParseResult with document and diagnostics
+ */
+export declare function parseWithRegistry(preprocessed: PreprocessedSpec, registry: ParseHandlerRegistry): ParseResult;
+/**
+ * Register a custom parser for a format
+ *
+ * Useful for extending with custom format support.
+ */
+export declare function registerParser(parser: UnitParser): void;
+/**
+ * Parse composite source directly (without config)
+ *
+ * Useful for testing or when config is handled separately.
+ */
+export declare function parseCompositeSource(source: PreprocessedSpec['source'], config?: PreprocessedSpec['config']): ParseResult;
+//# sourceMappingURL=pipeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/parse/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAA4B,MAAM,uBAAuB,CAAC;AAExF,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAmB,MAAM,kBAAkB,CAAC;AAIjF,OAAO,EAAE,oBAAoB,EAAmB,MAAM,qBAAqB,CAAC;AA4F5E;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,YAAY,EAAE,gBAAgB,GAAG,WAAW,CAEjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC7B,YAAY,EAAE,gBAAgB,EAC9B,QAAQ,EAAE,oBAAoB,GAC/B,WAAW,CAGb;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAChC,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EAClC,MAAM,GAAE,gBAAgB,CAAC,QAAQ,CAAM,GACxC,WAAW,CAEb"}

package/dist/parse/pipeline.js

@@ -0,0 +1,120 @@
+/**
+ * Parse Pipeline
+ *
+ * Orchestrates parsing of preprocessed spec into Document AST.
+ * Parser modules are registered automatically when importing html/index and markdown/index.
+ */
+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';
+/**
+ * Parser registry - maps format to parser factory
+ */
+function createParsers(registry) {
+    const parsers = new Map();
+    parsers.set('markdown', new MarkdownUnitParser(registry));
+    parsers.set('html', new HtmlUnitParser(registry));
+    return parsers;
+}
+// Default parsers using the default registry
+const defaultParsers = createParsers(defaultRegistry);
+/**
+ * Get parser for a format from a parser map
+ */
+function getParser(parsers, format) {
+    const parser = parsers.get(format);
+    if (!parser) {
+        throw new Error(`No parser registered for format: ${format}`);
+    }
+    return parser;
+}
+/**
+ * Parse a single source unit
+ */
+function parseUnit(unit, parsers) {
+    const diagnostics = [];
+    try {
+        const parser = getParser(parsers, unit.format);
+        const blocks = parser.parse(unit);
+        return { blocks, diagnostics };
+    }
+    catch (error) {
+        diagnostics.push({
+            severity: 'error',
+            code: 'parse-error',
+            message: `Failed to parse ${unit.file}: ${error instanceof Error ? error.message : String(error)}`,
+            file: unit.file,
+        });
+        return { blocks: [], diagnostics };
+    }
+}
+/**
+ * Internal parse implementation
+ */
+function parseInternal(preprocessed, parsers) {
+    const diagnostics = [];
+    const allBlocks = [];
+    // Parse each unit in order
+    for (const unit of preprocessed.source.units) {
+        const unitResult = parseUnit(unit, parsers);
+        diagnostics.push(...unitResult.diagnostics);
+        allBlocks.push(...unitResult.blocks);
+    }
+    // Check for errors
+    const hasErrors = diagnostics.some(d => d.severity === 'error');
+    if (hasErrors && allBlocks.length === 0) {
+        return { diagnostics, hasErrors };
+    }
+    // Assemble document
+    const document = assembleDocument(allBlocks, preprocessed.config, preprocessed.source.entryFile);
+    return {
+        result: {
+            config: preprocessed.config,
+            document,
+        },
+        diagnostics,
+        hasErrors,
+    };
+}
+/**
+ * Parse a preprocessed spec into a Document AST
+ *
+ * Uses the default registry with core handlers.
+ *
+ * @param preprocessed - Preprocessed spec with config and source units
+ * @returns ParseResult with document and diagnostics
+ */
+export function parse(preprocessed) {
+    return parseInternal(preprocessed, defaultParsers);
+}
+/**
+ * Parse a preprocessed spec using a custom handler registry
+ *
+ * This allows the pipeline to use plugin-registered handlers.
+ *
+ * @param preprocessed - Preprocessed spec with config and source units
+ * @param registry - Custom handler registry with plugin handlers
+ * @returns ParseResult with document and diagnostics
+ */
+export function parseWithRegistry(preprocessed, registry) {
+    const parsers = createParsers(registry);
+    return parseInternal(preprocessed, parsers);
+}
+/**
+ * Register a custom parser for a format
+ *
+ * Useful for extending with custom format support.
+ */
+export function registerParser(parser) {
+    defaultParsers.set(parser.format, parser);
+}
+/**
+ * Parse composite source directly (without config)
+ *
+ * Useful for testing or when config is handled separately.
+ */
+export function parseCompositeSource(source, config = {}) {
+    return parse({ config, source });
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/parse/pipeline.js.map

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

package/dist/parse/registry.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Parse Handler Registry
+ *
+ * Provides a modular architecture for parser modules.
+ * Parser modules handle specific hast/mdast nodes and emit SpecAST nodes.
+ */
+import type { Element, RootContent } from 'hast';
+import type { RootContent as MdastRootContent } from 'mdast';
+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
+ */
+export interface NodeWithPosition {
+    position?: {
+        start: {
+            line: number;
+            column: number;
+            offset?: number;
+        };
+        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
+ */
+export type InlineHandlerResult = Inline | Inline[] | null;
+/**
+ * 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.
+ */
+export interface ParseContext {
+    /** 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;
+    /** Get text content of element (HTML) */
+    getTextContent(element: Element): string;
+    /** Get attribute value (HTML) */
+    getAttr(element: Element, name: string): string | undefined;
+}
+/**
+ * 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.
+ */
+export interface HtmlParserModule {
+    /** Unique parser module name */
+    name: string;
+    /** Tag names this parser handles (e.g., ['h1', 'h2', 'h3', 'h4', 'h5', 'h6']) */
+    handles: string[];
+    /**
+     * Order for deterministic dispatch.
+     * Lower numbers run first. Default is 10.
+     */
+    order?: number;
+    /** Handle a block-level element */
+    handleBlock?(element: Element, ctx: ParseContext): BlockHandlerResult;
+    /** Handle an inline-level element */
+    handleInline?(element: Element, 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.
+ */
+export interface MarkdownParserModule {
+    /** Unique parser module name */
+    name: string;
+    /** Node types this parser handles (e.g., ['heading']) */
+    handles: string[];
+    /**
+     * Order for deterministic dispatch.
+     * Lower numbers run first. Default is 10.
+     */
+    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;
+}
+/**
+ * Registry for parser modules
+ *
+ * Manages parser modules for HTML tags and Markdown node types.
+ * Supports ordering for deterministic dispatch.
+ */
+export declare class ParseHandlerRegistry {
+    private htmlBlockHandlers;
+    private htmlInlineHandlers;
+    private mdBlockHandlers;
+    private mdInlineHandlers;
+    /**
+     * Register an HTML parser module
+     */
+    registerHtmlParser(parser: HtmlParserModule): void;
+    /**
+     * Register a Markdown parser module
+     */
+    registerMarkdownParser(parser: MarkdownParserModule): void;
+    /**
+     * Get HTML block parser for a tag
+     */
+    getHtmlBlockHandler(tagName: string): HtmlParserModule | undefined;
+    /**
+     * Get HTML inline parser for a tag
+     */
+    getHtmlInlineHandler(tagName: string): HtmlParserModule | undefined;
+    /**
+     * Get Markdown block parser for a node type
+     */
+    getMdBlockHandler(nodeType: string): MarkdownParserModule | undefined;
+    /**
+     * Get Markdown inline parser for a node type
+     */
+    getMdInlineHandler(nodeType: string): MarkdownParserModule | undefined;
+    /**
+     * Check if a handler exists for HTML tag
+     */
+    hasHtmlHandler(tagName: string): boolean;
+    /**
+     * Check if a handler exists for Markdown node type
+     */
+    hasMdHandler(nodeType: string): boolean;
+}
+/**
+ * Global default registry instance
+ */
+export declare const defaultRegistry: ParseHandlerRegistry;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/parse/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,IAAI,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAClF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAMxD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,EAAE;QACP,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACzD,GAAG,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC3D,CAAC;CACL;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;AAE7F;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,KAAK,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC;AAE9E;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;AAM3D;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IACzB,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAE1B,uCAAuC;IACvC,eAAe,CAAC,IAAI,EAAE,gBAAgB,GAAG,SAAS,GAAG,SAAS,CAAC;IAE/D,yCAAyC;IACzC,uBAAuB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,gBAAgB,EAAE,GAAG,MAAM,EAAE,CAAC;IAEhF,oDAAoD;IACpD,sBAAsB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,gBAAgB,EAAE,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC;IAE1F;;;OAGG;IACH,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAEhE,yCAAyC;IACzC,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC;IAEzC,iCAAiC;IACjC,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAC/D;AAMD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC7B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IAEb,iFAAiF;IACjF,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,mCAAmC;IACnC,WAAW,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,GAAG,kBAAkB,CAAC;IAEtE,qCAAqC;IACrC,YAAY,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,GAAG,mBAAmB,CAAC;CAC3E;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACjC,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IAEb,yDAAyD;IACzD,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,gCAAgC;IAChC,WAAW,CAAC,CAAC,IAAI,EAAE,gBAAgB,EAAE,GAAG,EAAE,YAAY,GAAG,KAAK,GAAG,IAAI,CAAC;IAEtE,kCAAkC;IAClC,YAAY,CAAC,CAAC,IAAI,EAAE,gBAAgB,EAAE,GAAG,EAAE,YAAY,GAAG,mBAAmB,CAAC;CACjF;AAMD;;;;;GAKG;AACH,qBAAa,oBAAoB;IAC7B,OAAO,CAAC,iBAAiB,CAAuC;IAChE,OAAO,CAAC,kBAAkB,CAAuC;IACjE,OAAO,CAAC,eAAe,CAA2C;IAClE,OAAO,CAAC,gBAAgB,CAA2C;IAEnE;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAmBlD;;OAEG;IACH,sBAAsB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAkB1D;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAIlE;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAInE;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAIrE;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAItE;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAKxC;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAG1C;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,sBAA6B,CAAC"}

package/dist/parse/registry.js

@@ -0,0 +1,104 @@
+/**
+ * Parse Handler Registry
+ *
+ * Provides a modular architecture for parser modules.
+ * Parser modules handle specific hast/mdast nodes and emit SpecAST nodes.
+ */
+// ============================================================================
+// Registry
+// ============================================================================
+/**
+ * Registry for parser modules
+ *
+ * Manages parser modules for HTML tags and Markdown node types.
+ * Supports ordering for deterministic dispatch.
+ */
+export class ParseHandlerRegistry {
+    htmlBlockHandlers = new Map();
+    htmlInlineHandlers = new Map();
+    mdBlockHandlers = new Map();
+    mdInlineHandlers = new Map();
+    /**
+     * Register an HTML parser module
+     */
+    registerHtmlParser(parser) {
+        for (const tag of parser.handles) {
+            const normalizedTag = tag.toLowerCase();
+            // Check if we should override based on order
+            if (parser.handleBlock) {
+                const existing = this.htmlBlockHandlers.get(normalizedTag);
+                if (!existing || (parser.order ?? 10) < (existing.order ?? 10)) {
+                    this.htmlBlockHandlers.set(normalizedTag, parser);
+                }
+            }
+            if (parser.handleInline) {
+                const existing = this.htmlInlineHandlers.get(normalizedTag);
+                if (!existing || (parser.order ?? 10) < (existing.order ?? 10)) {
+                    this.htmlInlineHandlers.set(normalizedTag, parser);
+                }
+            }
+        }
+    }
+    /**
+     * Register a Markdown parser module
+     */
+    registerMarkdownParser(parser) {
+        for (const nodeType of parser.handles) {
+            // Check if we should override based on order
+            if (parser.handleBlock) {
+                const existing = this.mdBlockHandlers.get(nodeType);
+                if (!existing || (parser.order ?? 10) < (existing.order ?? 10)) {
+                    this.mdBlockHandlers.set(nodeType, parser);
+                }
+            }
+            if (parser.handleInline) {
+                const existing = this.mdInlineHandlers.get(nodeType);
+                if (!existing || (parser.order ?? 10) < (existing.order ?? 10)) {
+                    this.mdInlineHandlers.set(nodeType, parser);
+                }
+            }
+        }
+    }
+    /**
+     * Get HTML block parser for a tag
+     */
+    getHtmlBlockHandler(tagName) {
+        return this.htmlBlockHandlers.get(tagName.toLowerCase());
+    }
+    /**
+     * Get HTML inline parser for a 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
+ */
+export const defaultRegistry = new ParseHandlerRegistry();
+//# sourceMappingURL=registry.js.map

package/dist/parse/registry.js.map

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

package/dist/parse/types.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Parse Stage Types
+ *
+ * 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';
+/**
+ * Interface for format-specific unit parsers
+ *
+ * Both markdown and HTML parsers implement this interface,
+ * allowing the orchestrator to route units to the correct parser.
+ */
+export interface UnitParser {
+    /** Format this parser handles */
+    readonly format: SourceFormat;
+    /**
+     * Parse a source unit into AST blocks
+     *
+     * @param unit - Source unit to parse
+     * @returns Array of top-level blocks/sections
+     */
+    parse(unit: SourceUnit): (Section | Block)[];
+}
+/**
+ * Result of parsing a preprocessed spec
+ */
+export interface ParsedSpec {
+    /** Configuration from preprocess */
+    config: SpecConfig;
+    /** Parsed document AST */
+    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
+ */
+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
+ */
+export declare function createSourcePos(unit: SourceUnit, line: number, column: number): SourcePos;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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"}

package/dist/parse/types.js

@@ -0,0 +1,19 @@
+/**
+ * Parse Stage Types
+ *
+ * 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,
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/parse/types.js.map

@@ -0,0 +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"}

package/dist/pipeline/__tests__/pipeline.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Pipeline Integration Tests
+ */
+export {};
+//# sourceMappingURL=pipeline.test.d.ts.map

package/dist/pipeline/__tests__/pipeline.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.test.d.ts","sourceRoot":"","sources":["../../../src/pipeline/__tests__/pipeline.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/pipeline/__tests__/pipeline.test.js

@@ -0,0 +1,69 @@
+/**
+ * Pipeline Integration Tests
+ */
+import { describe, it, expect } from 'vitest';
+import { speculate, corePlugins } from '#src/index';
+import { MemoryFileProvider } from '#src/file-provider/memory';
+describe('speculate', () => {
+    it('processes a simple markdown spec', async () => {
+        const fileProvider = new MemoryFileProvider({
+            '/spec/index.md': '# My Spec\n\nParagraph content.',
+        });
+        const result = await speculate({
+            entry: '/spec/index.md',
+            plugins: corePlugins,
+            fileProvider,
+        });
+        expect(result.workspace?.documents[0].type).toBe('document');
+        expect(result.workspace?.documents[0].children.length).toBeGreaterThan(0);
+    });
+    it('processes markdown with config', async () => {
+        const fileProvider = new MemoryFileProvider({
+            '/spec/index.md': '# Title\n\nContent',
+            '/spec/config.respec.json': JSON.stringify({
+                title: 'Test Spec',
+                shortName: 'test',
+            }),
+        });
+        const result = await speculate({
+            entry: '/spec/index.md',
+            configPath: '/spec/config.respec.json',
+            plugins: corePlugins,
+            fileProvider,
+        });
+        expect(result.workspace?.documents[0].metadata?.title).toBe('Test Spec');
+    });
+    it('processes HTML spec with sections', async () => {
+        const fileProvider = new MemoryFileProvider({
+            '/spec/index.html': `
+                <section id="abstract">
+                    <h2>Abstract</h2>
+                    <p>Summary text</p>
+                </section>
+            `,
+        });
+        const result = await speculate({
+            entry: '/spec/index.html',
+            plugins: corePlugins,
+            fileProvider,
+        });
+        const section = result.workspace?.documents[0].children[0];
+        expect(section.type).toBe('section');
+        expect(section.id).toBe('abstract');
+    });
+    it('works with includes', async () => {
+        const fileProvider = new MemoryFileProvider({
+            '/spec/index.md': '# Title\n\n:::include ./intro.md :::\n',
+            '/spec/intro.md': '## Introduction\n\nIntro text',
+        });
+        const result = await speculate({
+            entry: '/spec/index.md',
+            plugins: corePlugins,
+            fileProvider,
+        });
+        // Check that content from both files is present
+        const doc = result.workspace?.documents[0];
+        expect(doc?.children.length).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=pipeline.test.js.map

package/dist/pipeline/__tests__/pipeline.test.js.map

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

package/dist/pipeline/__tests__/single-as-workspace.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=single-as-workspace.test.d.ts.map

package/dist/pipeline/__tests__/single-as-workspace.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-as-workspace.test.d.ts","sourceRoot":"","sources":["../../../src/pipeline/__tests__/single-as-workspace.test.ts"],"names":[],"mappings":""}

package/dist/pipeline/__tests__/single-as-workspace.test.js

@@ -0,0 +1,19 @@
+import { describe, it, expect } from 'vitest';
+import { SpeculatorPipeline } from '../runner.js';
+import { MemoryFileProvider } from '#src/file-provider/memory';
+describe('Single document as workspace', () => {
+    it('should return a Workspace root even for a single-document run', async () => {
+        const fileProvider = new MemoryFileProvider();
+        fileProvider.setFile('/spec.md', '# Spec\n\nHello world');
+        const pipeline = new SpeculatorPipeline([]);
+        const result = await pipeline.run({
+            entry: '/spec.md',
+            fileProvider
+        });
+        expect(result.workspace).toBeDefined();
+        expect(result.workspace?.type).toBe('workspace');
+        expect(result.workspace?.documents.length).toBe(1);
+        expect(result.workspace?.documents[0].type).toBe('document');
+    });
+});
+//# sourceMappingURL=single-as-workspace.test.js.map