@openuji/speculator 0.6.1 → 0.6.2

package/dist/postprocess/plugins/walk-ast.js

@@ -1,92 +0,0 @@
-/**
- * AST Walker Utility
- *
- * Provides a generic visitor pattern for walking the SpecAST.
- * Used by postprocess plugins to traverse document structure.
- */
-/** Inline type names for detection */
-const INLINE_TYPES = new Set([
-    'text', 'emphasis', 'strong', 'inlineCode', 'link', 'image',
-    'definition', 'reference', 'requirement', 'issue', 'cite'
-]);
-/**
- * Walk all inline nodes, calling visitor.visitInline for each
- */
-function walkInlines(inlines, visitor) {
-    for (const inline of inlines) {
-        visitor.visitInline?.(inline);
-        // Recurse into children
-        if ('children' in inline && Array.isArray(inline.children)) {
-            walkInlines(inline.children, visitor);
-        }
-    }
-}
-/**
- * Walk a block node and its children
- */
-function walkBlock(block, visitor) {
-    visitor.visitBlock?.(block);
-    if ('children' in block) {
-        const children = block.children;
-        if (Array.isArray(children) && children.length > 0) {
-            const firstChild = children[0];
-            if (firstChild && typeof firstChild === 'object' && 'type' in firstChild) {
-                if (INLINE_TYPES.has(firstChild.type)) {
-                    walkInlines(children, visitor);
-                }
-                else {
-                    for (const child of children) {
-                        walkBlock(child, visitor);
-                    }
-                }
-            }
-        }
-    }
-}
-/**
- * Walk a section node and its children
- */
-function walkSection(section, visitor) {
-    visitor.visitSection?.(section);
-    // Walk heading if present
-    if (section.heading) {
-        walkInlines(section.heading.children, visitor);
-    }
-    // Walk children
-    for (const child of section.children) {
-        if (child.type === 'section') {
-            walkSection(child, visitor);
-        }
-        else {
-            walkBlock(child, visitor);
-        }
-    }
-}
-/**
- * Walk an entire document, calling visitor methods for each node type.
- *
- * @param document - The document to traverse
- * @param visitor - Visitor with optional callbacks for each node type
- *
- * @example
- * ```typescript
- * walkDocument(doc, {
- *     visitInline: (inline) => {
- *         if (inline.type === 'definition') {
- *             // process definition
- *         }
- *     }
- * });
- * ```
- */
-export function walkDocument(document, visitor) {
-    for (const child of document.children) {
-        if (child.type === 'section') {
-            walkSection(child, visitor);
-        }
-        else {
-            walkBlock(child, visitor);
-        }
-    }
-}
-//# sourceMappingURL=walk-ast.js.map

package/dist/postprocess/plugins/walk-ast.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"walk-ast.js","sourceRoot":"","sources":["../../../src/postprocess/plugins/walk-ast.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsBH,sCAAsC;AACtC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IACzB,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO;IAC3D,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM;CAC5D,CAAC,CAAC;AAEH;;GAEG;AACH,SAAS,WAAW,CAAC,OAAiB,EAAE,OAAmB;IACvD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,OAAO,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC;QAC9B,wBAAwB;QACxB,IAAI,UAAU,IAAI,MAAM,IAAI,KAAK,CAAC,OAAO,CAAE,MAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClE,WAAW,CAAE,MAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC;IACL,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,SAAS,CAAC,KAAY,EAAE,OAAmB;IAChD,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC;IAE5B,IAAI,UAAU,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,QAAQ,GAAI,KAAa,CAAC,QAAQ,CAAC;QACzC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjD,MAAM,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC/B,IAAI,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,MAAM,IAAI,UAAU,EAAE,CAAC;gBACvE,IAAI,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;oBACpC,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACnC,CAAC;qBAAM,CAAC;oBACJ,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;wBAC3B,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;oBAC9B,CAAC;gBACL,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,OAAgB,EAAE,OAAmB;IACtD,OAAO,CAAC,YAAY,EAAE,CAAC,OAAO,CAAC,CAAC;IAEhC,0BAA0B;IAC1B,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAClB,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,gBAAgB;IAChB,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC3B,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACJ,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC9B,CAAC;IACL,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,YAAY,CAAC,QAAkB,EAAE,OAAmB;IAChE,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACpC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC3B,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACJ,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC9B,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/postprocess/reference-resolve.d.ts

@@ -1,19 +0,0 @@
-/**
- * Reference Resolve Plugin
- *
- * Resolves cross-references (xref) to their target definitions (dfn).
- *
- * Process:
- * 1. Build lookup map from document.indexes.definitions
- * 2. Walk AST to find all InlineReference nodes
- * 3. Match references to definitions using term/candidateTerms + forContext
- * 4. Assign targetId to resolved references
- *
- * Note: Requires dfn-index plugin to run first to populate document.indexes.definitions
- */
-import type { Plugin } from '#src/pipeline/types';
-/**
- * Reference resolve plugin
- */
-export declare const referenceResolvePlugin: Plugin;
-//# sourceMappingURL=reference-resolve.d.ts.map

package/dist/postprocess/reference-resolve.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"reference-resolve.d.ts","sourceRoot":"","sources":["../../src/postprocess/reference-resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,qBAAqB,CAAC;AAyGlE;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAQpC,CAAC"}

package/dist/postprocess/reference-resolve.js

@@ -1,105 +0,0 @@
-/**
- * Reference Resolve Plugin
- *
- * Resolves cross-references (xref) to their target definitions (dfn).
- *
- * Process:
- * 1. Build lookup map from document.indexes.definitions
- * 2. Walk AST to find all InlineReference nodes
- * 3. Match references to definitions using term/candidateTerms + forContext
- * 4. Assign targetId to resolved references
- *
- * Note: Requires dfn-index plugin to run first to populate document.indexes.definitions
- */
-import { normalizeTerm } from '#src/parse/normalize';
-import { walkDocument } from './walk-ast.js';
-/**
- * Build lookup map from definition index
- */
-function buildLookupMap(document) {
-    const map = new Map();
-    const definitions = document.indexes?.definitions || [];
-    for (const entry of definitions) {
-        const linkTexts = entry.linkTexts || [entry.term];
-        // Index by all link texts
-        for (const text of linkTexts) {
-            const key = normalizeTerm(text);
-            const existing = map.get(key) || [];
-            existing.push(entry);
-            map.set(key, existing);
-        }
-        // Also index by the primary term if different
-        const termKey = normalizeTerm(entry.term);
-        if (!linkTexts.some(lt => normalizeTerm(lt) === termKey)) {
-            const existing = map.get(termKey) || [];
-            existing.push(entry);
-            map.set(termKey, existing);
-        }
-    }
-    return map;
-}
-/**
- * Resolve a reference to a definition
- */
-function resolveReference(ref, index) {
-    const candidateTerms = ref.candidateTerms || [ref.targetTerm];
-    const forContexts = ref.forContexts || [null];
-    const preferredType = ref.preferredType;
-    // Try each candidate term
-    for (const term of candidateTerms) {
-        const key = normalizeTerm(term);
-        const entries = index.get(key);
-        if (!entries || entries.length === 0)
-            continue;
-        // Filter by forContext if specified
-        let matches = entries;
-        // If reference has a forContext, prefer definitions with that forContext
-        const refForContext = forContexts.find((fc) => fc !== null);
-        if (refForContext) {
-            const exactMatches = matches.filter(e => (e.forContexts || [null]).some(fc => fc && normalizeTerm(fc) === normalizeTerm(refForContext)));
-            if (exactMatches.length > 0) {
-                matches = exactMatches;
-            }
-        }
-        // Filter by preferred type if specified
-        if (preferredType && matches.length > 1) {
-            const typeMatches = matches.filter(e => e.dfnType === preferredType);
-            if (typeMatches.length > 0) {
-                matches = typeMatches;
-            }
-        }
-        // Return first match
-        if (matches.length > 0) {
-            return matches[0];
-        }
-    }
-    return null;
-}
-/**
- * Walk document and resolve all references
- */
-function resolveReferences(document, index) {
-    walkDocument(document, {
-        visitInline: (inline) => {
-            if (inline.type === 'reference') {
-                const ref = inline;
-                const match = resolveReference(ref, index);
-                if (match) {
-                    ref.targetId = match.id;
-                }
-            }
-        }
-    });
-}
-/**
- * Reference resolve plugin
- */
-export const referenceResolvePlugin = {
-    name: 'reference-resolve',
-    order: { resolve: 10 },
-    async resolve(ctx) {
-        const index = buildLookupMap(ctx.document);
-        resolveReferences(ctx.document, index);
-    },
-};
-//# sourceMappingURL=reference-resolve.js.map

package/dist/postprocess/reference-resolve.js.map

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