@openuji/speculator 0.3.1 → 0.4.0

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

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

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

@@ -0,0 +1,103 @@
+/**
+ * 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;
+}
+/**
+ * Reference resolve plugin
+ */
+export const referenceResolvePlugin = {
+    name: 'reference-resolve',
+    order: { resolve: 10 },
+    async resolve(ctx) {
+        // Use global index if in a workspace, otherwise build local lookup map
+        const index = ctx.workspace
+            ? ctx.workspace.globalIndex.definitions
+            : buildLookupMap(ctx.document);
+        walkDocument(ctx.document, {
+            visitInline: (inline) => {
+                if (inline.type === 'reference') {
+                    const ref = inline;
+                    const match = resolveReference(ref, index);
+                    if (match) {
+                        // Assign the resolved target ID (mutation for resolution)
+                        ref.targetId = match.id;
+                    }
+                }
+            }
+        });
+    },
+};
+//# sourceMappingURL=reference-resolve.js.map

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

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

package/dist/postprocess/plugins/section-id.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Section ID Plugin
+ *
+ * Ensures all sections have unique, slug-based IDs.
+ *
+ * Process:
+ * 1. Walk AST to find all Section nodes
+ * 2. For sections without IDs or with non-slug IDs, generate from heading text
+ * 3. Ensure uniqueness by tracking used IDs and appending numbers (-2, -3, etc.)
+ */
+import type { Plugin } from '#src/pipeline/types';
+/**
+ * Section ID plugin
+ */
+export declare const sectionIdPlugin: Plugin;
+//# sourceMappingURL=section-id.d.ts.map

package/dist/postprocess/plugins/section-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-id.d.ts","sourceRoot":"","sources":["../../../src/postprocess/plugins/section-id.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAgB,MAAM,qBAAqB,CAAC;AA8GhE;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAO7B,CAAC"}

package/dist/postprocess/plugins/section-id.js

@@ -0,0 +1,116 @@
+/**
+ * Section ID Plugin
+ *
+ * Ensures all sections have unique, slug-based IDs.
+ *
+ * Process:
+ * 1. Walk AST to find all Section nodes
+ * 2. For sections without IDs or with non-slug IDs, generate from heading text
+ * 3. Ensure uniqueness by tracking used IDs and appending numbers (-2, -3, etc.)
+ */
+import { walkDocument } from '../walk-ast.js';
+/**
+ * Extract plain text from heading inline nodes
+ */
+function extractHeadingText(heading) {
+    function extractFromInlines(inlines) {
+        return inlines
+            .map(inline => {
+            switch (inline.type) {
+                case 'text':
+                    return inline.value;
+                case 'emphasis':
+                case 'strong':
+                case 'link':
+                    return extractFromInlines(inline.children);
+                case 'inlineCode':
+                    return inline.value;
+                case 'definition':
+                    return inline.term;
+                case 'reference':
+                    return inline.targetTerm;
+                case 'issue':
+                    return extractFromInlines(inline.children);
+                case 'cite':
+                    return inline.children ? extractFromInlines(inline.children) : inline.key;
+                default:
+                    return '';
+            }
+        })
+            .join('');
+    }
+    return extractFromInlines(heading.children);
+}
+/**
+ * Convert text to URL-safe slug
+ */
+function slugify(text) {
+    return text
+        .toLowerCase()
+        .trim()
+        // Replace spaces and underscores with hyphens
+        .replace(/[\s_]+/g, '-')
+        // Remove non-alphanumeric characters except hyphens
+        .replace(/[^a-z0-9-]+/g, '')
+        // Remove leading/trailing hyphens
+        .replace(/^-+|-+$/g, '')
+        // Collapse multiple hyphens
+        .replace(/-+/g, '-');
+}
+/**
+ * Check if a string looks like a slug (lowercase alphanumeric with hyphens)
+ */
+function isSlugLike(id) {
+    return /^[a-z0-9]+(-[a-z0-9]+)*$/.test(id);
+}
+/**
+ * Ensure all sections have unique, slug-based IDs
+ */
+function ensureSectionIds(document) {
+    const usedIds = new Set();
+    /**
+     * Generate a unique ID from base slug
+     */
+    function makeUniqueId(baseSlug) {
+        if (!baseSlug) {
+            baseSlug = 'section';
+        }
+        let id = baseSlug;
+        let counter = 2;
+        while (usedIds.has(id)) {
+            id = `${baseSlug}-${counter}`;
+            counter++;
+        }
+        usedIds.add(id);
+        return id;
+    }
+    walkDocument(document, {
+        visitSection: (section) => {
+            // Check if section needs an ID
+            const needsId = !section.id || !isSlugLike(section.id);
+            if (needsId && section.heading) {
+                // Generate ID from heading text
+                const headingText = extractHeadingText(section.heading);
+                const baseSlug = slugify(headingText);
+                const uniqueId = makeUniqueId(baseSlug);
+                // Assign the ID to the section
+                section.id = uniqueId;
+            }
+            else if (section.id) {
+                // Track existing ID to avoid duplicates
+                usedIds.add(section.id);
+            }
+        }
+    });
+}
+/**
+ * Section ID plugin
+ */
+export const sectionIdPlugin = {
+    name: 'section-id',
+    order: { index: 5 },
+    async index(ctx) {
+        ensureSectionIds(ctx.document);
+    },
+};
+//# sourceMappingURL=section-id.js.map

package/dist/postprocess/plugins/section-id.js.map

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

package/dist/postprocess/plugins/walk-ast.d.ts

@@ -0,0 +1,38 @@
+/**
+ * AST Walker Utility
+ *
+ * Provides a generic visitor pattern for walking the SpecAST.
+ * Used by postprocess plugins to traverse document structure.
+ */
+import type { SpeculatorASTSchema as Document, Section, Block, Inline } from '#src/types/ast.generated';
+/**
+ * Visitor interface for AST traversal.
+ * Implement only the methods you need.
+ */
+export interface AstVisitor {
+    /** Called for each inline node */
+    visitInline?(inline: Inline): void;
+    /** Called for each block node */
+    visitBlock?(block: Block): void;
+    /** Called for each section node */
+    visitSection?(section: Section): void;
+}
+/**
+ * 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 declare function walkDocument(document: Document, visitor: AstVisitor): void;
+//# sourceMappingURL=walk-ast.d.ts.map

package/dist/postprocess/plugins/walk-ast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk-ast.d.ts","sourceRoot":"","sources":["../../../src/postprocess/plugins/walk-ast.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACR,mBAAmB,IAAI,QAAQ,EAC/B,OAAO,EACP,KAAK,EACL,MAAM,EACT,MAAM,0BAA0B,CAAC;AAElC;;;GAGG;AACH,MAAM,WAAW,UAAU;IACvB,kCAAkC;IAClC,WAAW,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,iCAAiC;IACjC,UAAU,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAChC,mCAAmC;IACnC,YAAY,CAAC,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACzC;AAiED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAQ1E"}

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

@@ -0,0 +1,92 @@
+/**
+ * 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

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

@@ -0,0 +1,19 @@
+/**
+ * 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

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

@@ -0,0 +1,105 @@
+/**
+ * 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

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

package/dist/postprocess/walk-ast.d.ts

@@ -0,0 +1,38 @@
+/**
+ * AST Walker Utility
+ *
+ * Provides a generic visitor pattern for walking the SpecAST.
+ * Used by postprocess plugins to traverse document structure.
+ */
+import type { Document, Section, Block, Inline } from '#src/types/ast.generated';
+/**
+ * Visitor interface for AST traversal.
+ * Implement only the methods you need.
+ */
+export interface AstVisitor {
+    /** Called for each inline node */
+    visitInline?(inline: Inline): void;
+    /** Called for each block node */
+    visitBlock?(block: Block): void;
+    /** Called for each section node */
+    visitSection?(section: Section): void;
+}
+/**
+ * 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 declare function walkDocument(document: Document, visitor: AstVisitor): void;
+//# sourceMappingURL=walk-ast.d.ts.map

package/dist/postprocess/walk-ast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk-ast.d.ts","sourceRoot":"","sources":["../../src/postprocess/walk-ast.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACR,QAAQ,EACR,OAAO,EACP,KAAK,EACL,MAAM,EACT,MAAM,0BAA0B,CAAC;AAGlC;;;GAGG;AACH,MAAM,WAAW,UAAU;IACvB,kCAAkC;IAClC,WAAW,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,iCAAiC;IACjC,UAAU,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAChC,mCAAmC;IACnC,YAAY,CAAC,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACzC;AAmED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAQ1E"}

package/dist/postprocess/walk-ast.js

@@ -0,0 +1,94 @@
+/**
+ * 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)) {
+            const inlineWithChildren = inline;
+            walkInlines(inlineWithChildren.children, visitor);
+        }
+    }
+}
+/**
+ * Walk a block node and its children
+ */
+function walkBlock(block, visitor) {
+    visitor.visitBlock?.(block);
+    if ('children' in block) {
+        const blockWithChildren = block;
+        const children = blockWithChildren.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