@urbicon-ui/docs-gen 6.1.4

package/dist/extractors/BaseExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseExtractor.d.ts","sourceRoot":"","sources":["../../src/extractors/BaseExtractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAErF;;GAEG;AACH,8BAAsB,aAAa,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IACrE,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC;gBAEd,MAAM,CAAC,EAAE,OAAO;IAI5B;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAEnE;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI/C;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC;IAqBnF;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAC3B,IAAI,EAAE,OAAO,EACb,QAAQ,GAAE,iBAAiB,EAAO,EAClC,UAAU,GAAE,MAAkB,EAC9B,QAAQ,GAAE,MAAU,GACnB,gBAAgB,CAAC,OAAO,CAAC;IAe5B;;OAEG;IACH,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,iBAAiB;IAK3F;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB"}

package/dist/extractors/BaseExtractor.js

@@ -0,0 +1,68 @@
+/**
+ * Generic base class for all extractors (TypeScript and non-TypeScript)
+ */
+export class BaseExtractor {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Validate input before extraction - can be overridden
+     */
+    validateInput(input) {
+        return input !== null && input !== undefined;
+    }
+    /**
+     * Handle extraction errors - can be overridden for custom error handling
+     */
+    handleError(error, context) {
+        const extractionError = {
+            type: 'extraction_failed',
+            message: error instanceof Error ? error.message : String(error),
+            context
+        };
+        return {
+            success: false,
+            data: undefined,
+            errors: [extractionError],
+            warnings: [],
+            metadata: {
+                duration: 0,
+                extractorVersion: '2.0.0',
+                sourceFile: context?.sourceFile || 'unknown',
+                timestamp: new Date().toISOString()
+            }
+        };
+    }
+    /**
+     * Create a successful extraction result
+     */
+    createSuccessResult(data, warnings = [], sourceFile = 'unknown', duration = 0) {
+        return {
+            success: true,
+            data,
+            errors: [],
+            warnings,
+            metadata: {
+                duration,
+                extractorVersion: '2.0.0',
+                sourceFile,
+                timestamp: new Date().toISOString()
+            }
+        };
+    }
+    /**
+     * Add warning to extraction result
+     */
+    addWarning(type, message, suggestion) {
+        const warning = { type, message };
+        return suggestion ? { ...warning, suggestion } : warning;
+    }
+    /**
+     * Clear any caches (useful for watch mode)
+     */
+    clearCache() {
+        // Override in subclasses if needed
+    }
+}
+//# sourceMappingURL=BaseExtractor.js.map

package/dist/extractors/BaseExtractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseExtractor.js","sourceRoot":"","sources":["../../src/extractors/BaseExtractor.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAgB,aAAa;IACvB,MAAM,CAAU;IAE1B,YAAY,MAAgB;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAOD;;OAEG;IACO,aAAa,CAAC,KAAa;QACnC,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;IAC/C,CAAC;IAED;;OAEG;IACO,WAAW,CAAC,KAAc,EAAE,OAAiB;QACrD,MAAM,eAAe,GAAoB;YACvC,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;YAC/D,OAAO;SACR,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,KAAK;YACd,IAAI,EAAE,SAA+B;YACrC,MAAM,EAAE,CAAC,eAAe,CAAC;YACzB,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE;gBACR,QAAQ,EAAE,CAAC;gBACX,gBAAgB,EAAE,OAAO;gBACzB,UAAU,EAAG,OAA+C,EAAE,UAAU,IAAI,SAAS;gBACrF,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACO,mBAAmB,CAC3B,IAAa,EACb,WAAgC,EAAE,EAClC,aAAqB,SAAS,EAC9B,WAAmB,CAAC;QAEpB,OAAO;YACL,OAAO,EAAE,IAAI;YACb,IAAI;YACJ,MAAM,EAAE,EAAE;YACV,QAAQ;YACR,QAAQ,EAAE;gBACR,QAAQ;gBACR,gBAAgB,EAAE,OAAO;gBACzB,UAAU;gBACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACO,UAAU,CAAC,IAAY,EAAE,OAAe,EAAE,UAAmB;QACrE,MAAM,OAAO,GAAsB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACrD,OAAO,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,UAAU;QACR,mCAAmC;IACrC,CAAC;CACF"}

package/dist/extractors/ExtractorFactory.d.ts

@@ -0,0 +1,35 @@
+import type { TypeScriptExtractionConfig } from '../types';
+import type { BaseExtractor } from './BaseExtractor';
+/**
+ * Universal factory that manages both TypeScript and non-TypeScript extractors
+ */
+export declare class ExtractorFactory {
+    private static instance;
+    private extractorCache;
+    private tsConfig;
+    private constructor();
+    static getInstance(tsConfig?: TypeScriptExtractionConfig): ExtractorFactory;
+    /**
+     * Create or get cached PropsExtractor (TypeScript-based)
+     */
+    createPropsExtractor(): Promise<BaseExtractor<unknown, unknown>>;
+    /**
+     * Create or get cached InheritanceExtractor (TypeScript-based)
+     */
+    createInheritanceExtractor(): Promise<BaseExtractor<unknown, unknown>>;
+    /**
+     * Create or get cached VariantsExtractor (TypeScript-based)
+     */
+    createVariantsExtractor(): Promise<BaseExtractor<unknown, unknown>>;
+    /**
+     * Clear all cached extractors
+     */
+    clearCache(): void;
+    /**
+     * Update TypeScript configuration for TypeScript-based extractors
+     */
+    updateTsConfig(newTsConfig?: TypeScriptExtractionConfig): void;
+    createExamplesExtractor(): Promise<BaseExtractor<unknown, unknown>>;
+    createLocalTypesExtractor(): Promise<BaseExtractor<unknown, unknown>>;
+}
+//# sourceMappingURL=ExtractorFactory.d.ts.map

package/dist/extractors/ExtractorFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtractorFactory.d.ts","sourceRoot":"","sources":["../../src/extractors/ExtractorFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmB;IAC1C,OAAO,CAAC,cAAc,CAAoC;IAC1D,OAAO,CAAC,QAAQ,CAAyC;IAEzD,OAAO;IAIP,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,0BAA0B,GAAG,gBAAgB;IAO3E;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAYtE;;OAEG;IACG,0BAA0B,IAAI,OAAO,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAc5E;;OAEG;IACG,uBAAuB,IAAI,OAAO,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAczE;;OAEG;IACH,UAAU,IAAI,IAAI;IAOlB;;OAEG;IACH,cAAc,CAAC,WAAW,CAAC,EAAE,0BAA0B,GAAG,IAAI;IAKxD,uBAAuB,IAAI,OAAO,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAYnE,yBAAyB,IAAI,OAAO,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;CAW5E"}

package/dist/extractors/ExtractorFactory.js

@@ -0,0 +1,88 @@
+/**
+ * Universal factory that manages both TypeScript and non-TypeScript extractors
+ */
+export class ExtractorFactory {
+    static instance;
+    extractorCache = new Map();
+    tsConfig;
+    constructor(tsConfig) {
+        this.tsConfig = tsConfig;
+    }
+    static getInstance(tsConfig) {
+        if (!ExtractorFactory.instance) {
+            ExtractorFactory.instance = new ExtractorFactory(tsConfig);
+        }
+        return ExtractorFactory.instance;
+    }
+    /**
+     * Create or get cached PropsExtractor (TypeScript-based)
+     */
+    async createPropsExtractor() {
+        const cacheKey = 'props';
+        if (!this.extractorCache.has(cacheKey)) {
+            const { PropsExtractor } = await import('./typescript/PropsExtractor');
+            const extractor = new PropsExtractor(this.tsConfig);
+            this.extractorCache.set(cacheKey, extractor);
+        }
+        return this.extractorCache.get(cacheKey);
+    }
+    /**
+     * Create or get cached InheritanceExtractor (TypeScript-based)
+     */
+    async createInheritanceExtractor() {
+        const cacheKey = 'inheritance';
+        if (!this.extractorCache.has(cacheKey)) {
+            const { InheritanceExtractor } = await import('./typescript/InheritanceExtractor');
+            const extractor = new InheritanceExtractor(this.tsConfig);
+            this.extractorCache.set(cacheKey, extractor);
+        }
+        return this.extractorCache.get(cacheKey);
+    }
+    /**
+     * Create or get cached VariantsExtractor (TypeScript-based)
+     */
+    async createVariantsExtractor() {
+        const cacheKey = 'variants';
+        if (!this.extractorCache.has(cacheKey)) {
+            const { VariantsExtractor } = await import('./variants/VariantsExtractor');
+            const extractor = new VariantsExtractor(this.tsConfig);
+            this.extractorCache.set(cacheKey, extractor);
+        }
+        return this.extractorCache.get(cacheKey);
+    }
+    /**
+     * Clear all cached extractors
+     */
+    clearCache() {
+        this.extractorCache.forEach((extractor) => {
+            extractor.clearCache();
+        });
+        this.extractorCache.clear();
+    }
+    /**
+     * Update TypeScript configuration for TypeScript-based extractors
+     */
+    updateTsConfig(newTsConfig) {
+        this.tsConfig = newTsConfig;
+        this.clearCache(); // Force recreation with new config
+    }
+    async createExamplesExtractor() {
+        const key = 'examples';
+        if (!this.extractorCache.has(key)) {
+            const mod = await import('./typescript/ExamplesExtractor');
+            const extractor = new mod.ExamplesExtractor(this.tsConfig);
+            this.extractorCache.set(key, extractor);
+        }
+        return this.extractorCache.get(key);
+    }
+    async createLocalTypesExtractor() {
+        const cacheKey = 'localTypes';
+        if (!this.extractorCache.has(cacheKey)) {
+            const { LocalTypesExtractor } = await import('./typescript/LocalTypesExtractor');
+            const extractor = new LocalTypesExtractor(this.tsConfig);
+            this.extractorCache.set(cacheKey, extractor);
+        }
+        return this.extractorCache.get(cacheKey);
+    }
+}
+//# sourceMappingURL=ExtractorFactory.js.map

package/dist/extractors/ExtractorFactory.js.map

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

package/dist/extractors/documentation/index.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=index.d.ts.map

package/dist/extractors/documentation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extractors/documentation/index.ts"],"names":[],"mappings":""}

package/dist/extractors/documentation/index.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=index.js.map

package/dist/extractors/documentation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extractors/documentation/index.ts"],"names":[],"mappings":""}

package/dist/extractors/index.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=index.d.ts.map

package/dist/extractors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extractors/index.ts"],"names":[],"mappings":""}

package/dist/extractors/index.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=index.js.map

package/dist/extractors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/extractors/index.ts"],"names":[],"mappings":""}

package/dist/extractors/typescript/ExamplesExtractor.d.ts

@@ -0,0 +1,32 @@
+import type { ExtractionResult } from '../../types/validation';
+import { TypeScriptBaseExtractor } from './TypeScriptBaseExtractor';
+interface ExamplesExtractionInput {
+    filePath: string;
+    componentName: string;
+}
+/**
+ * Extracts interface-level @example snippets from the <Component>Props JSDoc using TS AST,
+ * avoiding fragile regex parsing in later pipeline stages.
+ */
+export declare class ExamplesExtractor extends TypeScriptBaseExtractor<ExamplesExtractionInput, string[]> {
+    extract(input: ExamplesExtractionInput): Promise<ExtractionResult<string[]>>;
+    /**
+     * Full-text ranges of sibling components' Props declarations (incl. their leading
+     * JSDoc trivia). A sibling is another `export { default as X } from './X.svelte'`
+     * of the same file — in a multi-component index.ts (e.g. the Guide surfaces) the
+     * head-scan must not attribute a sibling's `@example` blocks to this component.
+     * Helper interfaces like `MenuSpecificProps` (no matching `.svelte` export) are
+     * deliberately NOT excluded: their head JSDoc is the documented authoring spot
+     * for the primary component's examples.
+     */
+    private collectSiblingPropsRanges;
+    private getTagCommentText;
+    private extractFencedExamples;
+    private extractFallbackExamples;
+    private normalizeExampleFromTag;
+    private extractExamplesFromHead;
+    private sanitizeExampleCode;
+    private dedupeExamples;
+}
+export {};
+//# sourceMappingURL=ExamplesExtractor.d.ts.map

package/dist/extractors/typescript/ExamplesExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExamplesExtractor.d.ts","sourceRoot":"","sources":["../../../src/extractors/typescript/ExamplesExtractor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,UAAU,uBAAuB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,uBAAuB,CAAC,uBAAuB,EAAE,MAAM,EAAE,CAAC;IACzF,OAAO,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC;IA8DlF;;;;;;;;OAQG;IACH,OAAO,CAAC,yBAAyB;IAkCjC,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,uBAAuB;IAS/B,OAAO,CAAC,uBAAuB;IAkC/B,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,cAAc;CAYvB"}

package/dist/extractors/typescript/ExamplesExtractor.js

@@ -0,0 +1,209 @@
+import * as ts from 'typescript';
+import { TypeScriptBaseExtractor } from './TypeScriptBaseExtractor';
+/**
+ * Extracts interface-level @example snippets from the <Component>Props JSDoc using TS AST,
+ * avoiding fragile regex parsing in later pipeline stages.
+ */
+export class ExamplesExtractor extends TypeScriptBaseExtractor {
+    async extract(input) {
+        const start = Date.now();
+        try {
+            if (!input?.filePath || !input?.componentName) {
+                return this.createSuccessResult([], [], input?.filePath ?? 'unknown', 0);
+            }
+            const sourceFile = await this.getSourceFile(input.filePath);
+            if (!sourceFile) {
+                return this.createSuccessResult([], [], input.filePath, 0);
+            }
+            const ifaceName = `${input.componentName}Props`;
+            const iface = this.findInterface(sourceFile, ifaceName);
+            const typeAlias = !iface ? this.findTypeAlias(sourceFile, ifaceName) : null;
+            const propsNode = iface ?? typeAlias;
+            let examples = [];
+            if (propsNode) {
+                // First, try to read explicit @example tags
+                const tags = ts.getJSDocTags(propsNode) || [];
+                for (const tag of tags) {
+                    if (tag.tagName?.getText() === 'example') {
+                        const raw = this.getTagCommentText(tag) || '';
+                        const cleaned = this.normalizeExampleFromTag(raw);
+                        if (cleaned)
+                            examples.push(cleaned);
+                    }
+                }
+                // If none found, fallback to scanning the full JSDoc comment attached to the interface
+                if (examples.length === 0) {
+                    const jsDocs = (ts.getJSDocCommentsAndTags(propsNode) || []).filter((n) => ts.isJSDoc(n));
+                    for (const doc of jsDocs) {
+                        const text = this.getCommentText(doc.comment ?? '') || '';
+                        const fromFences = this.extractFencedExamples(text);
+                        if (fromFences.length > 0)
+                            examples.push(...fromFences);
+                        const fromFallback = this.extractFallbackExamples(text);
+                        if (fromFallback.length > 0)
+                            examples.push(...fromFallback);
+                    }
+                }
+                // Still nothing? Scan the file head (content before the interface) for top-level
+                // JSDoc blocks containing @example (common authoring pattern for component props docs)
+                if (examples.length === 0) {
+                    const fromHead = this.extractExamplesFromHead(sourceFile, propsNode);
+                    if (fromHead.length > 0)
+                        examples.push(...fromHead);
+                }
+            }
+            // Deduplicate and trim
+            examples = this.dedupeExamples(examples);
+            return this.createSuccessResult(examples, [], input.filePath, Date.now() - start);
+        }
+        catch (error) {
+            return this.handleError(error, { component: input?.componentName, file: input?.filePath });
+        }
+    }
+    /**
+     * Full-text ranges of sibling components' Props declarations (incl. their leading
+     * JSDoc trivia). A sibling is another `export { default as X } from './X.svelte'`
+     * of the same file — in a multi-component index.ts (e.g. the Guide surfaces) the
+     * head-scan must not attribute a sibling's `@example` blocks to this component.
+     * Helper interfaces like `MenuSpecificProps` (no matching `.svelte` export) are
+     * deliberately NOT excluded: their head JSDoc is the documented authoring spot
+     * for the primary component's examples.
+     */
+    collectSiblingPropsRanges(sourceFile, propsNode) {
+        const svelteExports = new Set();
+        for (const statement of sourceFile.statements) {
+            if (ts.isExportDeclaration(statement) &&
+                statement.exportClause &&
+                ts.isNamedExports(statement.exportClause) &&
+                statement.moduleSpecifier &&
+                ts.isStringLiteral(statement.moduleSpecifier) &&
+                statement.moduleSpecifier.text.endsWith('.svelte')) {
+                for (const element of statement.exportClause.elements) {
+                    if (element.propertyName?.text === 'default')
+                        svelteExports.add(element.name.text);
+                }
+            }
+        }
+        const ranges = [];
+        for (const statement of sourceFile.statements) {
+            if (statement === propsNode)
+                continue;
+            if ((ts.isInterfaceDeclaration(statement) || ts.isTypeAliasDeclaration(statement)) &&
+                statement.name.text.endsWith('Props') &&
+                svelteExports.has(statement.name.text.slice(0, -'Props'.length))) {
+                ranges.push({ start: statement.getFullStart(), end: statement.getEnd() });
+            }
+        }
+        return ranges;
+    }
+    getTagCommentText(tag) {
+        // TypeScript does not expose a typed API for tag.comment text slices directly,
+        // but JSDocTag has a 'comment' field we can stringify.
+        const tagWithComment = tag;
+        const comment = tagWithComment?.comment;
+        if (comment == null)
+            return undefined;
+        if (typeof comment === 'string')
+            return comment;
+        if (Array.isArray(comment))
+            return comment
+                .map((p) => (typeof p === 'string' ? p : (p?.text ?? '')))
+                .join('');
+        return String(comment ?? '');
+    }
+    extractFencedExamples(text) {
+        const out = [];
+        const fenceRe = /```(?:\w+)?\n([\s\S]*?)```/g;
+        for (const m of text.matchAll(fenceRe)) {
+            const block = this.sanitizeExampleCode(m[1] || '');
+            if (block)
+                out.push(block);
+        }
+        return out;
+    }
+    extractFallbackExamples(text) {
+        // Split by @example markers and take the part until the next tag or end
+        const parts = text.split(/@example/g).slice(1);
+        const out = [];
+        for (const part of parts) {
+            const body = part.split('@')[0] || '';
+            const cleaned = this.sanitizeExampleCode(body);
+            if (cleaned)
+                out.push(cleaned);
+        }
+        return out;
+    }
+    normalizeExampleFromTag(text) {
+        const fenced = this.extractFencedExamples(text);
+        if (fenced.length > 0) {
+            const first = fenced[0];
+            if (first)
+                return first;
+        }
+        return this.sanitizeExampleCode(text || '');
+    }
+    extractExamplesFromHead(sourceFile, iface) {
+        try {
+            const text = sourceFile.getFullText();
+            const end = iface.getStart();
+            let head = text.slice(0, end);
+            // Blank out sibling components' Props declarations (incl. their JSDoc trivia)
+            // so their @example blocks are never attributed to this component.
+            for (const range of this.collectSiblingPropsRanges(sourceFile, iface)) {
+                if (range.start >= head.length)
+                    continue;
+                const sliceEnd = Math.min(range.end, head.length);
+                head =
+                    head.slice(0, range.start) + ' '.repeat(sliceEnd - range.start) + head.slice(sliceEnd);
+            }
+            // Look for @example fenced blocks in the head
+            const out = [];
+            const fenceRe = /@example[\s\S]*?```(?:\w+)?\n([\s\S]*?)```/g;
+            for (const m of head.matchAll(fenceRe)) {
+                const cleaned = this.sanitizeExampleCode(m[1] || '');
+                if (cleaned)
+                    out.push(cleaned);
+            }
+            if (out.length > 0)
+                return out;
+            // Fallback inside head: split by @example and take until next @ or end of block
+            const parts = head.split(/@example/g).slice(1);
+            for (const part of parts) {
+                const snippet = part.split('@')[0] || '';
+                const cleaned = this.sanitizeExampleCode(snippet);
+                if (cleaned)
+                    out.push(cleaned);
+            }
+            return out;
+        }
+        catch {
+            return [];
+        }
+    }
+    sanitizeExampleCode(code) {
+        if (!code)
+            return '';
+        const lines = String(code)
+            .split(/\r?\n/)
+            .map((l) => l.replace(/^\s*\*\s?/, ''));
+        // strip leading/trailing empties
+        while (lines.length > 0 && lines[0]?.trim() === '')
+            lines.shift();
+        while (lines.length > 0 && lines[lines.length - 1]?.trim() === '')
+            lines.pop();
+        return lines.join('\n');
+    }
+    dedupeExamples(examples) {
+        const seen = new Set();
+        const out = [];
+        for (const ex of examples) {
+            const key = ex.replace(/\s+/g, '').toLowerCase();
+            if (!seen.has(key)) {
+                seen.add(key);
+                out.push(ex);
+            }
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=ExamplesExtractor.js.map

package/dist/extractors/typescript/ExamplesExtractor.js.map

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

package/dist/extractors/typescript/InheritanceExtractor.d.ts

@@ -0,0 +1,45 @@
+import type { ExtractionResult, InheritanceExtractionConfig, InheritanceInfo, KnownInterfaceConfig } from '../../types';
+import { TypeScriptBaseExtractor } from './TypeScriptBaseExtractor';
+interface InheritanceExtractionInput {
+    filePath: string;
+    componentName: string;
+    interfaceName?: string;
+}
+/**
+ * Resolves interface inheritance, including HTML attributes, external types, and Omit patterns
+ */
+export declare class InheritanceExtractor extends TypeScriptBaseExtractor<InheritanceExtractionInput, InheritanceInfo[]> {
+    config: InheritanceExtractionConfig;
+    private knownInterfaces;
+    constructor(tsConfig?: Record<string, unknown>);
+    /**
+     * Extract inheritance information from component interface
+     */
+    extract(input: InheritanceExtractionInput): Promise<ExtractionResult<InheritanceInfo[]>>;
+    private extractInheritanceFromInterface;
+    private processHeritageType;
+    private handleOmitPattern;
+    private handleHTMLAttributes;
+    private handleKnownInterface;
+    private handleLocalInterface;
+    private handleExternalType;
+    private isOmitPattern;
+    private isHTMLAttributes;
+    private isKnownInterface;
+    private extractElementType;
+    private parseOmittedKeys;
+    private getPackageForType;
+    private getUrlForType;
+    private extractPropFromMember;
+    private addDefaultKnownInterfaces;
+    /**
+     * Add a known interface configuration
+     */
+    addKnownInterface(config: KnownInterfaceConfig): void;
+    /**
+     * Clear any caches
+     */
+    clearCache(): void;
+}
+export {};
+//# sourceMappingURL=InheritanceExtractor.d.ts.map

package/dist/extractors/typescript/InheritanceExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InheritanceExtractor.d.ts","sourceRoot":"","sources":["../../../src/extractors/typescript/InheritanceExtractor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,2BAA2B,EAC3B,eAAe,EACf,oBAAoB,EAErB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,UAAU,0BAA0B;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,uBAAuB,CAC/D,0BAA0B,EAC1B,eAAe,EAAE,CAClB;IACQ,MAAM,EAAE,2BAA2B,CAAC;IAC3C,OAAO,CAAC,eAAe,CAAoC;gBAE/C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAwB9C;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,gBAAgB,CAAC,eAAe,EAAE,CAAC,CAAC;YA8ChF,+BAA+B;YA6B/B,mBAAmB;IA6CjC,OAAO,CAAC,iBAAiB;IA+CzB,OAAO,CAAC,oBAAoB;IA6B5B,OAAO,CAAC,oBAAoB;YA2Bd,oBAAoB;IA2ClC,OAAO,CAAC,kBAAkB;IAqC1B,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,kBAAkB;IAK1B,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,qBAAqB;IAiB7B,OAAO,CAAC,yBAAyB;IAuCjC;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAIrD;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB"}