@urbicon-ui/docs-gen 6.1.4

package/dist/extractors/typescript/InheritanceExtractor.js

@@ -0,0 +1,368 @@
+import * as ts from 'typescript';
+import { TypeScriptBaseExtractor } from './TypeScriptBaseExtractor';
+/**
+ * Resolves interface inheritance, including HTML attributes, external types, and Omit patterns
+ */
+export class InheritanceExtractor extends TypeScriptBaseExtractor {
+    config;
+    knownInterfaces;
+    constructor(tsConfig) {
+        super(tsConfig);
+        const ext = tsConfig?.extraction?.inheritance;
+        this.config = {
+            resolveExternalTypes: true,
+            includeHTMLAttributes: true,
+            maxDepth: 5,
+            knownInterfaces: [],
+            ...ext
+        };
+        // Build known interfaces map
+        this.knownInterfaces = new Map();
+        this.config.knownInterfaces?.forEach((iface) => {
+            this.knownInterfaces.set(iface.name, iface);
+        });
+        // Add default known interfaces
+        this.addDefaultKnownInterfaces();
+    }
+    /**
+     * Extract inheritance information from component interface
+     */
+    async extract(input) {
+        const startTime = Date.now();
+        if (!this.validateInput(input)) {
+            return this.handleError(new Error('Invalid input for inheritance extraction'), input);
+        }
+        try {
+            console.log(`🔗 Extracting inheritance for ${input.componentName}`);
+            const sourceFile = await this.getSourceFile(input.filePath);
+            if (!sourceFile) {
+                return this.handleError(new Error(`Could not load source file: ${input.filePath}`), input);
+            }
+            // Find the main interface
+            const interfaceName = input.interfaceName || `${input.componentName}Props`;
+            const mainInterface = this.findInterface(sourceFile, interfaceName);
+            if (!mainInterface) {
+                const warning = this.addWarning('no_interface', `No ${interfaceName} interface found`, `Create a ${interfaceName} interface to document inheritance`);
+                return this.createSuccessResult([], [warning], input.filePath, Date.now() - startTime);
+            }
+            console.log(`✅ Found ${interfaceName} interface`);
+            // Extract inheritance information
+            const inheritance = await this.extractInheritanceFromInterface(mainInterface, sourceFile, 0);
+            console.log(`🔗 Extracted ${inheritance.length} inheritance sources`);
+            const duration = Date.now() - startTime;
+            return this.createSuccessResult(inheritance, [], input.filePath, duration);
+        }
+        catch (error) {
+            return this.handleError(error, input);
+        }
+    }
+    // ==========================================
+    // INHERITANCE EXTRACTION
+    // ==========================================
+    async extractInheritanceFromInterface(interfaceNode, sourceFile, depth) {
+        if (depth >= this.config.maxDepth) {
+            console.warn(`⚠️  Max inheritance depth (${this.config.maxDepth}) reached`);
+            return [];
+        }
+        const inheritance = [];
+        if (!interfaceNode.heritageClauses) {
+            return inheritance;
+        }
+        for (const heritageClause of interfaceNode.heritageClauses) {
+            for (const heritageType of heritageClause.types) {
+                const inheritanceInfo = await this.processHeritageType(heritageType, sourceFile, depth + 1);
+                if (inheritanceInfo) {
+                    inheritance.push(inheritanceInfo);
+                }
+            }
+        }
+        return inheritance;
+    }
+    async processHeritageType(heritageType, sourceFile, depth) {
+        const typeName = heritageType.expression.getText();
+        console.log(`🔍 Processing heritage type: ${typeName} (depth: ${depth})`);
+        // Handle different inheritance patterns
+        if (this.isOmitPattern(heritageType)) {
+            return this.handleOmitPattern(heritageType);
+        }
+        if (this.isHTMLAttributes(typeName)) {
+            return this.handleHTMLAttributes(typeName);
+        }
+        if (this.isKnownInterface(typeName)) {
+            return this.handleKnownInterface(typeName);
+        }
+        // Try to find local interface
+        const localInterface = this.findInterface(sourceFile, typeName);
+        if (localInterface) {
+            return this.handleLocalInterface(localInterface, typeName, sourceFile, depth);
+        }
+        // Handle external types if enabled
+        if (this.config.resolveExternalTypes) {
+            return this.handleExternalType(typeName, heritageType);
+        }
+        // Create placeholder for unresolved inheritance
+        console.log(`❓ Creating placeholder for unresolved type: ${typeName}`);
+        return {
+            typeName,
+            source: 'unknown',
+            props: []
+        };
+    }
+    // ==========================================
+    // INHERITANCE PATTERN HANDLERS
+    // ==========================================
+    handleOmitPattern(heritageType) {
+        const fullType = heritageType.getText();
+        console.log(`✂️ Handling Omit pattern: ${fullType}`);
+        // Parse Omit<BaseType, Keys> pattern
+        const match = fullType.match(/Omit<([^,]+),\s*([^>]+)>/);
+        if (!match) {
+            throw new Error(`Invalid Omit pattern: ${fullType}`);
+        }
+        const baseType = (match[1] || '').trim();
+        const omittedKeys = (match[2] || '').trim();
+        // Extract omitted key names
+        const omittedKeyList = this.parseOmittedKeys(omittedKeys);
+        let props = [];
+        let url;
+        // Handle base type
+        if (this.isHTMLAttributes(baseType)) {
+            const elementType = this.extractElementType(baseType);
+            url = `https://developer.mozilla.org/en-US/docs/Web/HTML/Element/${elementType.toLowerCase()}`;
+            props = [
+                {
+                    name: `...${elementType}Attributes`,
+                    type: 'HTMLAttributes',
+                    required: false,
+                    description: `HTML ${elementType.toLowerCase()} attributes${omittedKeyList.length > 0 ? ` (excluding: ${omittedKeyList.join(', ')})` : ''}`,
+                    source: {
+                        type: 'inherited',
+                        name: baseType,
+                        package: 'svelte/elements'
+                    }
+                }
+            ];
+        }
+        return {
+            typeName: fullType,
+            source: 'omit-pattern',
+            props,
+            ...(url ? { url } : {})
+        };
+    }
+    handleHTMLAttributes(typeName) {
+        console.log(`🌐 Handling HTML attributes: ${typeName}`);
+        const elementType = this.extractElementType(typeName);
+        const url = `https://developer.mozilla.org/en-US/docs/Web/HTML/Element/${elementType.toLowerCase()}`;
+        const props = [
+            {
+                name: `...${elementType}Attributes`,
+                type: 'HTMLAttributes',
+                required: false,
+                description: `All standard HTML ${elementType.toLowerCase()} attributes`,
+                source: {
+                    type: 'inherited',
+                    name: typeName,
+                    package: 'svelte/elements',
+                    ...(url ? { url } : {})
+                }
+            }
+        ];
+        return {
+            typeName,
+            source: 'html-attributes',
+            props,
+            ...(url ? { url } : {})
+        };
+    }
+    handleKnownInterface(typeName) {
+        const knownInterface = this.knownInterfaces.get(typeName);
+        console.log(`📚 Handling known interface: ${typeName} from ${knownInterface.package}`);
+        const props = [
+            {
+                name: `...${typeName}`,
+                type: typeName,
+                required: false,
+                description: knownInterface.description || `Properties from ${typeName}`,
+                source: {
+                    type: 'inherited',
+                    name: typeName,
+                    package: knownInterface.package,
+                    ...(knownInterface.url ? { url: knownInterface.url } : {})
+                }
+            }
+        ];
+        return {
+            typeName,
+            source: knownInterface.package,
+            props,
+            ...(knownInterface.url ? { url: knownInterface.url } : {})
+        };
+    }
+    async handleLocalInterface(interfaceNode, typeName, sourceFile, depth) {
+        console.log(`📋 Handling local interface: ${typeName}`);
+        const props = [];
+        // Extract props from local interface
+        for (const member of interfaceNode.members) {
+            if (ts.isPropertySignature(member)) {
+                const prop = this.extractPropFromMember(member);
+                if (prop) {
+                    prop.source = {
+                        type: 'inherited',
+                        name: typeName
+                    };
+                    props.push(prop);
+                }
+            }
+        }
+        // Recursively extract inheritance from this interface
+        const nestedInheritance = await this.extractInheritanceFromInterface(interfaceNode, sourceFile, depth);
+        // Flatten nested inheritance props
+        nestedInheritance.forEach((inheritance) => {
+            props.push(...inheritance.props);
+        });
+        return {
+            typeName,
+            source: 'local-interface',
+            props
+        };
+    }
+    handleExternalType(typeName, _heritageType) {
+        console.log(`🌍 Handling external type: ${typeName}`);
+        // Try to resolve common external types
+        const packageName = this.getPackageForType(typeName);
+        const url = this.getUrlForType(typeName);
+        const props = [
+            {
+                name: `...${typeName}`,
+                type: typeName,
+                required: false,
+                description: `Properties inherited from ${typeName}`,
+                source: {
+                    type: 'inherited',
+                    name: typeName,
+                    ...(packageName ? { package: packageName } : {}),
+                    ...(url ? { url } : {})
+                }
+            }
+        ];
+        return {
+            typeName,
+            source: packageName || 'external',
+            props,
+            ...(url ? { url } : {})
+        };
+    }
+    // ==========================================
+    // UTILITY METHODS
+    // ==========================================
+    isOmitPattern(heritageType) {
+        return heritageType.expression.getText().startsWith('Omit');
+    }
+    isHTMLAttributes(typeName) {
+        return typeName.includes('HTML') && typeName.includes('Attributes');
+    }
+    isKnownInterface(typeName) {
+        return this.knownInterfaces.has(typeName);
+    }
+    extractElementType(typeName) {
+        const match = typeName?.match(/HTML(\w+)Attributes/);
+        return match?.[1] ? match[1] : 'Element';
+    }
+    parseOmittedKeys(omittedKeys) {
+        // Handle union types: 'key1' | 'key2' | 'key3'
+        const keys = omittedKeys
+            .split('|')
+            .map((key) => key.trim().replace(/['"]/g, ''))
+            .filter((key) => key.length > 0);
+        return keys;
+    }
+    getPackageForType(typeName) {
+        const packageMap = {
+            Snippet: 'svelte',
+            ComponentEvents: 'svelte',
+            MintProp: '@urbicon-ui/blocks',
+            ComponentIntent: '@urbicon-ui/blocks',
+            ComponentSize: '@urbicon-ui/blocks',
+            HTMLButtonAttributes: 'svelte/elements',
+            HTMLInputAttributes: 'svelte/elements',
+            HTMLDivAttributes: 'svelte/elements'
+        };
+        return packageMap[typeName];
+    }
+    getUrlForType(typeName) {
+        const urlMap = {
+            Snippet: 'https://svelte.dev/docs/svelte/snippet',
+            ComponentEvents: 'https://svelte.dev/docs/svelte/component-events',
+            MintProp: '/docs/mint-system',
+            ComponentIntent: '/docs/design-tokens#intent',
+            ComponentSize: '/docs/design-tokens#size'
+        };
+        return urlMap[typeName];
+    }
+    extractPropFromMember(member) {
+        const propName = this.getPropertyName(member);
+        if (!propName)
+            return null;
+        const propType = this.getTypeString(member.type);
+        const isRequired = this.isPropertyRequired(member);
+        const description = this.extractJSDocComment(member) || `${propName} property`;
+        return {
+            name: propName,
+            type: propType,
+            required: isRequired,
+            description,
+            source: { type: 'inherited' } // Will be updated by caller
+        };
+    }
+    addDefaultKnownInterfaces() {
+        const defaultInterfaces = [
+            {
+                name: 'Snippet',
+                package: 'svelte',
+                url: 'https://svelte.dev/docs/svelte/snippet',
+                description: 'Svelte snippet for reusable content'
+            },
+            {
+                name: 'ComponentEvents',
+                package: 'svelte',
+                url: 'https://svelte.dev/docs/svelte/component-events',
+                description: 'Svelte component event handlers'
+            },
+            {
+                name: 'MintProp',
+                package: '@urbicon-ui/blocks',
+                url: '/docs/mint-system',
+                description: 'Urbicon Mint micro-interaction system'
+            },
+            {
+                name: 'ComponentIntent',
+                package: '@urbicon-ui/blocks',
+                url: '/docs/design-tokens#intent',
+                description: 'Urbicon component intent colors'
+            },
+            {
+                name: 'ComponentSize',
+                package: '@urbicon-ui/blocks',
+                url: '/docs/design-tokens#size',
+                description: 'Urbicon component sizes'
+            }
+        ];
+        defaultInterfaces.forEach((iface) => {
+            this.knownInterfaces.set(iface.name, iface);
+        });
+    }
+    /**
+     * Add a known interface configuration
+     */
+    addKnownInterface(config) {
+        this.knownInterfaces.set(config.name, config);
+    }
+    /**
+     * Clear any caches
+     */
+    clearCache() {
+        // No persistent cache in this implementation
+    }
+}
+//# sourceMappingURL=InheritanceExtractor.js.map

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

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

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

@@ -0,0 +1,20 @@
+import type { TypeDefinition } from '../../types';
+import { TypeScriptBaseExtractor } from './TypeScriptBaseExtractor';
+interface LocalTypesExtractionInput {
+    filePath: string;
+    componentName: string;
+    packageName: string;
+}
+/**
+ * Extracts exported local type/interface definitions from a component's index.ts file.
+ * Focus: concrete business-relevant types (e.g., MenuItemType, MenuObjectOption, ...)
+ * Does not follow re-exports in this first iteration.
+ */
+export declare class LocalTypesExtractor extends TypeScriptBaseExtractor<LocalTypesExtractionInput, TypeDefinition[]> {
+    extract(input: LocalTypesExtractionInput): Promise<import("../..").ExtractionResult<TypeDefinition[]>>;
+    private collectExportedTypesFromSource;
+    private hasExportModifier;
+    private findVariantsFile;
+}
+export {};
+//# sourceMappingURL=LocalTypesExtractor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LocalTypesExtractor.d.ts","sourceRoot":"","sources":["../../../src/extractors/typescript/LocalTypesExtractor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,UAAU,yBAAyB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,uBAAuB,CAC9D,yBAAyB,EACzB,cAAc,EAAE,CACjB;IACO,OAAO,CAAC,KAAK,EAAE,yBAAyB;IA4B9C,OAAO,CAAC,8BAA8B;IAyCtC,OAAO,CAAC,iBAAiB;YAMX,gBAAgB;CAuB/B"}

package/dist/extractors/typescript/LocalTypesExtractor.js

@@ -0,0 +1,100 @@
+import * as path from 'node:path';
+import * as ts from 'typescript';
+import { TypeScriptBaseExtractor } from './TypeScriptBaseExtractor';
+/**
+ * Extracts exported local type/interface definitions from a component's index.ts file.
+ * Focus: concrete business-relevant types (e.g., MenuItemType, MenuObjectOption, ...)
+ * Does not follow re-exports in this first iteration.
+ */
+export class LocalTypesExtractor extends TypeScriptBaseExtractor {
+    async extract(input) {
+        const start = Date.now();
+        try {
+            const sourceFile = await this.getSourceFile(input.filePath);
+            if (!sourceFile) {
+                return this.createSuccessResult([], [], input.filePath, Date.now() - start);
+            }
+            const typeDefs = [];
+            // collect from component index/source file
+            this.collectExportedTypesFromSource(sourceFile, typeDefs, input.packageName);
+            // optionally collect types from variants file (e.g., menu.variants.ts)
+            const variantsFilePath = await this.findVariantsFile(input.filePath, input.componentName);
+            if (variantsFilePath) {
+                const variantsSource = await this.getSourceFile(variantsFilePath);
+                if (variantsSource) {
+                    this.collectExportedTypesFromSource(variantsSource, typeDefs, input.packageName);
+                }
+            }
+            return this.createSuccessResult(typeDefs, [], input.filePath, Date.now() - start);
+        }
+        catch (error) {
+            return this.handleError(error, input);
+        }
+    }
+    collectExportedTypesFromSource(sourceFile, out, packageName) {
+        const existing = new Set(out.map((t) => t.name));
+        sourceFile.forEachChild((node) => {
+            // type alias: export type Name = ...
+            if (ts.isTypeAliasDeclaration(node) && this.hasExportModifier(node)) {
+                const name = node.name?.getText() || '';
+                if (!name || existing.has(name))
+                    return;
+                const rhs = node.type?.getText() || 'unknown';
+                out.push({
+                    name,
+                    type: 'type',
+                    definition: rhs,
+                    package: packageName,
+                    documentation: this.extractJSDocComment(node) || ''
+                });
+                existing.add(name);
+            }
+            // interface: export interface Name { ... }
+            if (ts.isInterfaceDeclaration(node) && this.hasExportModifier(node)) {
+                const name = node.name?.getText() || '';
+                if (!name || existing.has(name))
+                    return;
+                const body = node.members?.length
+                    ? sourceFile.text.slice(node.members.pos, node.members.end)
+                    : ' {}';
+                out.push({
+                    name,
+                    type: 'interface',
+                    definition: body.trim(),
+                    package: packageName,
+                    documentation: this.extractJSDocComment(node) || ''
+                });
+                existing.add(name);
+            }
+        });
+    }
+    hasExportModifier(node) {
+        if (!ts.canHaveModifiers(node))
+            return false;
+        const modifiers = ts.getModifiers(node);
+        return (modifiers ?? []).some((m) => m.kind === ts.SyntaxKind.ExportKeyword);
+    }
+    async findVariantsFile(componentFilePath, componentName) {
+        const dir = path.dirname(componentFilePath);
+        const patterns = [
+            `${componentName.toLowerCase()}.variants.ts`,
+            `${componentName}.variants.ts`,
+            'variants.ts',
+            `${componentName.toLowerCase()}.variants.js`,
+            `${componentName}.variants.js`
+        ];
+        for (const p of patterns) {
+            const candidate = path.join(dir, p);
+            try {
+                const sf = await this.getSourceFile(candidate);
+                if (sf)
+                    return candidate;
+            }
+            catch {
+                // ignore
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=LocalTypesExtractor.js.map

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

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

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

@@ -0,0 +1,142 @@
+import type { ExtractionResult, PropInfo, TypeScriptExtractionConfig } from '../../types';
+import { TypeScriptBaseExtractor } from './TypeScriptBaseExtractor';
+interface PropsExtractionInput {
+    filePath: string;
+    componentName: string;
+    /** Optional list of variant prop keys (from VariantsExtractor) to exclude in Omit<... , keyof Variants> */
+    variantKeys?: string[];
+}
+/**
+ * Extracts props from TypeScript interfaces using AST parsing
+ * Supports JSDoc comments, type analysis, and prop categorization
+ */
+export declare class PropsExtractor extends TypeScriptBaseExtractor<PropsExtractionInput, PropInfo[]> {
+    config: TypeScriptExtractionConfig;
+    private currentVariantKeys;
+    constructor(tsConfig?: Record<string, unknown>);
+    /**
+     * Extract props from TypeScript interface
+     */
+    extract(input: PropsExtractionInput): Promise<ExtractionResult<PropInfo[]>>;
+    /**
+     * Extract the component description from the JSDoc on the *Props declaration.
+     * Checks @description tag first, then falls back to leading prose text.
+     */
+    extractDescription(input: {
+        filePath: string;
+        componentName: string;
+    }): Promise<string | null>;
+    /**
+     * Extract all @tag values from the *Props declaration JSDoc.
+     */
+    extractTags(input: {
+        filePath: string;
+        componentName: string;
+    }): Promise<string[]>;
+    /**
+     * Extract all @related values from the *Props declaration JSDoc.
+     */
+    extractRelated(input: {
+        filePath: string;
+        componentName: string;
+    }): Promise<string[]>;
+    /**
+     * Extract the `@stability` tag from the *Props declaration JSDoc.
+     * Accepts `experimental | beta | stable | deprecated`; unknown
+     * values are dropped so a typo doesn't silently propagate into the
+     * Editorial badge.
+     */
+    extractStability(input: {
+        filePath: string;
+        componentName: string;
+    }): Promise<'experimental' | 'beta' | 'stable' | 'deprecated' | null>;
+    /**
+     * Locate the component's props declaration. Either:
+     *   - an `interface FooProps { ... }`            → kind: 'interface'
+     *   - a `type FooProps = A | B | …`              → kind: 'union'
+     *
+     * `node` is the AST node whose members get walked for props; `jsDocHost`
+     * is the declaration that owns the leading JSDoc block (for an interface
+     * they're the same; for a union the JSDoc lives on the type-alias, not
+     * on the `UnionTypeNode` itself). Other type-alias shapes (intersection,
+     * single reference, mapped types, etc.) aren't supported here and fall
+     * through to `null`.
+     */
+    private findPropsDeclaration;
+    /**
+     * Extract props from a discriminated-union type alias.
+     *
+     * Algorithm (generic — no hard-coded discriminator name):
+     *   1. Resolve each union member to a local interface. Members that
+     *      can't be resolved (anonymous type literals, external refs,
+     *      intersections, etc.) are dropped with a warning.
+     *   2. Extract props from each resolved interface (reusing the
+     *      interface path so heritage / Omit / variants are honoured).
+     *   3. Detect the discriminator: a property that exists in every
+     *      member with a single string-literal type, and whose literal
+     *      value differs across members.
+     *   4. Merge the per-member prop sets:
+     *      - Props that appear in every member → unconditional.
+     *      - Props that appear in only some members → `conditionalOn`
+     *        records the discriminator and the values where they apply.
+     *      - The discriminator prop itself is collapsed into one entry
+     *        whose `values` array enumerates every literal it can take.
+     */
+    private extractPropsFromUnion;
+    /**
+     * Pick the most informative occurrence of a prop across union members.
+     * Prefers occurrences whose type isn't `never`, whose description isn't
+     * an auto-generated placeholder (`'<name> property'`), and which carry
+     * a `defaultValue` over those that don't. This keeps
+     * `<Badge variant="dot" removable>` extracting as `removable: boolean`
+     * (from `BadgeStandardProps`) rather than `removable?: never` (from
+     * `BadgeDotProps`) — and, when collapsing the discriminator, picks the
+     * arm whose `@default` JSDoc is set so the docs site renders a real
+     * default value in the API table.
+     */
+    private pickInformativeOccurrence;
+    /**
+     * Resolve a union-member type to a local interface declaration. Currently
+     * supports plain TypeReferenceNode shapes (`A`, `Foo<T>`). Returns null for
+     * anonymous type literals, intersections, external references the file
+     * doesn't import directly, etc.
+     */
+    private resolveUnionMemberInterface;
+    /**
+     * Detect the discriminator property. A discriminator must:
+     *   - exist in every union member,
+     *   - have a string-literal-union type in each member (one or more
+     *     `'x' | 'y'` values),
+     *   - have non-overlapping value-sets across members (so the literal
+     *     uniquely identifies which member a value belongs to).
+     *
+     * Returns null if no such property exists.
+     */
+    private detectDiscriminator;
+    private extractPropsFromInterface;
+    private extractPropFromMember;
+    private extractInheritedProps;
+    private handleVariantInheritance;
+    private handleOmitPattern;
+    private handleHTMLAttributes;
+    private extractPropsFromLocalInterface;
+    private isVariantInterface;
+    private isOmitPattern;
+    /**
+     * Parse the keys argument of `Omit<X, K>` into a flat string-literal list.
+     * Handles `'a'`, `'a' | 'b' | 'c'`, double-quoted, and ignores `keyof T`
+     * patterns (those are handled separately via `currentVariantKeys`).
+     */
+    private extractOmittedLiteralKeys;
+    private isHTMLAttributes;
+    private extractElementType;
+    private getPackageForType;
+    private extractJSDocExamples;
+    private sortProps;
+    /**
+     * Clear any caches
+     */
+    clearCache(): void;
+}
+export {};
+//# sourceMappingURL=PropsExtractor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PropsExtractor.d.ts","sourceRoot":"","sources":["../../../src/extractors/typescript/PropsExtractor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAC1F,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,UAAU,oBAAoB;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,2GAA2G;IAC3G,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAMD;;;GAGG;AACH,qBAAa,cAAe,SAAQ,uBAAuB,CAAC,oBAAoB,EAAE,QAAQ,EAAE,CAAC;IACpF,MAAM,EAAE,0BAA0B,CAAC;IAC1C,OAAO,CAAC,kBAAkB,CAAgB;gBAE9B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAe9C;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,CAAC;IA2DjF;;;OAGG;IACG,kBAAkB,CAAC,KAAK,EAAE;QAC9B,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAa1B;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAUxF;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAU3F;;;;;OAKG;IACG,gBAAgB,CAAC,KAAK,EAAE;QAC5B,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,IAAI,CAAC;IA0BrE;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,oBAAoB;IA2B5B;;;;;;;;;;;;;;;;;;OAkBG;YACW,qBAAqB;IA0HnC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,yBAAyB;IAgBjC;;;;;OAKG;IACH,OAAO,CAAC,2BAA2B;IAWnC;;;;;;;;;OASG;IACH,OAAO,CAAC,mBAAmB;YAwCb,yBAAyB;IAuCvC,OAAO,CAAC,qBAAqB;YAiFf,qBAAqB;IA2CnC,OAAO,CAAC,wBAAwB;IAmBhC,OAAO,CAAC,iBAAiB;IA6EzB,OAAO,CAAC,oBAAoB;IAmB5B,OAAO,CAAC,8BAA8B;IA2BtC,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,aAAa;IAIrB;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;IAMjC,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,kBAAkB;IAK1B,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,oBAAoB;IAsB5B,OAAO,CAAC,SAAS;IAajB;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB"}