@sudosandwich/limps-radix 0.1.1

package/dist/extractor/forward-ref.js

@@ -0,0 +1,134 @@
+/**
+ * ForwardRefExoticComponent extraction for complex .d.ts files.
+ * Handles patterns like: React.ForwardRefExoticComponent<Props & React.RefAttributes<Element>>
+ */
+import { extractPropsFromInterface } from './props.js';
+/**
+ * Find all ForwardRefExoticComponent variable declarations in a source file.
+ */
+export function findForwardRefDeclarations(sourceFile) {
+    const results = [];
+    for (const statement of sourceFile.getVariableStatements()) {
+        for (const decl of statement.getDeclarations()) {
+            const typeNode = decl.getTypeNode();
+            if (!typeNode)
+                continue;
+            const typeText = typeNode.getText();
+            if (typeText.includes('ForwardRefExoticComponent')) {
+                const name = decl.getName();
+                const propsTypeName = extractPropsTypeFromForwardRef(typeNode);
+                results.push({
+                    name,
+                    declaration: decl,
+                    propsTypeName,
+                });
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Extract the props type name from a ForwardRefExoticComponent type.
+ * Handles: ForwardRefExoticComponent<DialogRootProps & React.RefAttributes<...>>
+ */
+function extractPropsTypeFromForwardRef(typeNode) {
+    const typeText = typeNode.getText();
+    // Match pattern: ForwardRefExoticComponent<TypeName & ...>
+    // or ForwardRefExoticComponent<TypeName>
+    const match = typeText.match(/ForwardRefExoticComponent<\s*(\w+)(?:\s*&|>)/);
+    if (match) {
+        return match[1];
+    }
+    return null;
+}
+/**
+ * Extract props from a ForwardRef declaration by resolving its type parameter.
+ */
+export function extractPropsFromForwardRef(sourceFile, decl) {
+    const { propsTypeName, declaration } = decl;
+    // Try to find the props interface directly
+    if (propsTypeName) {
+        const propsInterface = sourceFile.getInterface(propsTypeName);
+        if (propsInterface) {
+            const props = extractPropsFromInterface(propsInterface);
+            return filterRefAttributes(props);
+        }
+    }
+    // Fallback: try to extract from the type directly using ts-morph's type system
+    const typeNode = declaration.getTypeNode();
+    if (!typeNode)
+        return null;
+    const props = extractPropsFromTypeNode(sourceFile, typeNode);
+    return filterRefAttributes(props);
+}
+/**
+ * Extract props from a TypeNode (for inline type definitions).
+ */
+function extractPropsFromTypeNode(_sourceFile, typeNode) {
+    const props = [];
+    // Get the type from the type checker
+    const type = typeNode.getType();
+    // For ForwardRefExoticComponent, we need the first type argument
+    const typeArgs = type.getTypeArguments();
+    if (typeArgs.length === 0)
+        return props;
+    const propsType = typeArgs[0];
+    // Get all properties from the type (resolves intersections)
+    for (const prop of propsType.getProperties()) {
+        const name = prop.getName();
+        const declarations = prop.getDeclarations();
+        const propDecl = declarations[0];
+        if (!propDecl)
+            continue;
+        // Get the type from the property
+        const propType = prop.getTypeAtLocation(propDecl);
+        const typeText = propType.getText();
+        // Check if optional (has question token or is union with undefined)
+        const isOptional = propDecl.getKindName() === 'PropertySignature'
+            ? propDecl.hasQuestionToken?.() ?? false
+            : typeText.includes('undefined');
+        props.push({
+            name,
+            type: simplifyTypeText(typeText),
+            required: !isOptional,
+        });
+    }
+    return props;
+}
+/**
+ * Filter out React.RefAttributes props (ref).
+ */
+function filterRefAttributes(props) {
+    const refAttributeProps = ['ref'];
+    return props.filter((p) => !refAttributeProps.includes(p.name));
+}
+/**
+ * Simplify complex type text for readability.
+ */
+function simplifyTypeText(text) {
+    return text
+        .replace(/React\.ReactNode/g, 'ReactNode')
+        .replace(/React\.ReactElement/g, 'ReactElement')
+        .replace(/React\.CSSProperties/g, 'CSSProperties')
+        .replace(/React\.HTMLAttributes<.*?>/g, 'HTMLAttributes')
+        .replace(/React\.ComponentPropsWithoutRef<.*?>/g, 'ComponentProps')
+        .replace(/React\.Ref<.*?>/g, 'Ref')
+        .replace(/React\.RefAttributes<.*?>/g, 'RefAttributes')
+        .replace(/import\(".*?"\)\./g, '');
+}
+/**
+ * Get the sub-component suffix from a component name.
+ * @example "DialogContent" with primitive "Dialog" -> "Content"
+ */
+export function getSubComponentSuffix(componentName, primitiveName) {
+    if (!componentName.startsWith(primitiveName))
+        return null;
+    const suffix = componentName.slice(primitiveName.length);
+    if (!suffix)
+        return null;
+    // Ensure suffix starts with uppercase (valid sub-component)
+    if (!/^[A-Z]/.test(suffix))
+        return null;
+    return suffix;
+}
+//# sourceMappingURL=forward-ref.js.map

package/dist/extractor/forward-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forward-ref.js","sourceRoot":"","sources":["../../src/extractor/forward-ref.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAWvD;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,UAAsB;IAEtB,MAAM,OAAO,GAA4B,EAAE,CAAC;IAE5C,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,qBAAqB,EAAE,EAAE,CAAC;QAC3D,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,eAAe,EAAE,EAAE,CAAC;YAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YACpC,IAAI,CAAC,QAAQ;gBAAE,SAAS;YAExB,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;YACpC,IAAI,QAAQ,CAAC,QAAQ,CAAC,2BAA2B,CAAC,EAAE,CAAC;gBACnD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;gBAC5B,MAAM,aAAa,GAAG,8BAA8B,CAAC,QAAQ,CAAC,CAAC;gBAE/D,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI;oBACJ,WAAW,EAAE,IAAI;oBACjB,aAAa;iBACd,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,SAAS,8BAA8B,CAAC,QAAkB;IACxD,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;IAEpC,2DAA2D;IAC3D,yCAAyC;IACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAC1B,8CAA8C,CAC/C,CAAC;IACF,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,UAAsB,EACtB,IAA2B;IAE3B,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAE5C,2CAA2C;IAC3C,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,cAAc,GAAG,UAAU,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;QAC9D,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,KAAK,GAAG,yBAAyB,CAAC,cAAc,CAAC,CAAC;YACxD,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,+EAA+E;IAC/E,MAAM,QAAQ,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;IAC3C,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,MAAM,KAAK,GAAG,wBAAwB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC7D,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,SAAS,wBAAwB,CAC/B,WAAuB,EACvB,QAAkB;IAElB,MAAM,KAAK,GAAc,EAAE,CAAC;IAE5B,qCAAqC;IACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;IAEhC,iEAAiE;IACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACzC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAExC,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE9B,4DAA4D;IAC5D,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,aAAa,EAAE,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC5B,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QAEjC,IAAI,CAAC,QAAQ;YAAE,SAAS;QAExB,iCAAiC;QACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;QAEpC,oEAAoE;QACpE,MAAM,UAAU,GACd,QAAQ,CAAC,WAAW,EAAE,KAAK,mBAAmB;YAC5C,CAAC,CAAE,QAAuD,CAAC,gBAAgB,EAAE,EAAE,IAAI,KAAK;YACxF,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAErC,KAAK,CAAC,IAAI,CAAC;YACT,IAAI;YACJ,IAAI,EAAE,gBAAgB,CAAC,QAAQ,CAAC;YAChC,QAAQ,EAAE,CAAC,UAAU;SACtB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,KAAgB;IAC3C,MAAM,iBAAiB,GAAG,CAAC,KAAK,CAAC,CAAC;IAClC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,IAAY;IACpC,OAAO,IAAI;SACR,OAAO,CAAC,mBAAmB,EAAE,WAAW,CAAC;SACzC,OAAO,CAAC,sBAAsB,EAAE,cAAc,CAAC;SAC/C,OAAO,CAAC,uBAAuB,EAAE,eAAe,CAAC;SACjD,OAAO,CAAC,6BAA6B,EAAE,gBAAgB,CAAC;SACxD,OAAO,CAAC,uCAAuC,EAAE,gBAAgB,CAAC;SAClE,OAAO,CAAC,kBAAkB,EAAE,KAAK,CAAC;SAClC,OAAO,CAAC,4BAA4B,EAAE,eAAe,CAAC;SACtD,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,aAAqB,EACrB,aAAqB;IAErB,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,aAAa,CAAC;QAAE,OAAO,IAAI,CAAC;IAE1D,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IACzD,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,4DAA4D;IAC5D,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAExC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/extractor/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Type extractor module for parsing Radix type definitions.
+ */
+import type { ExtractedPrimitive, PropDefinition, RawProp } from '../types/index.js';
+export { createProject, createSourceFile, parseTypes } from './project.js';
+export { findInterfaces, findPropsInterfaces, extractSubComponents, extractSubComponentsEnhanced, findExports, detectContextUsage, extractContextShape, extractPrimitiveFromSource, } from './interface.js';
+export { findForwardRefDeclarations, extractPropsFromForwardRef, getSubComponentSuffix, } from './forward-ref.js';
+export { resolveTypeAlias, mergeIntersectionTypes, filterReactInternals, resolveTypeReference, } from './type-resolver.js';
+export { extractPropsFromInterface, extractProp, isPropsInterface, componentNameFromProps, } from './props.js';
+export { extractJsDoc, extractDefaultFromComment } from './jsdoc.js';
+export { classifyProp, isStateControl, isEventHandler, isComposition, isConfiguration, getPropCategory, } from './classifier.js';
+/**
+ * Extract primitive information from type content.
+ *
+ * @param typeContent - The .d.ts file content
+ * @param primitiveName - The primitive name (e.g., "Dialog")
+ * @param version - The package version
+ * @returns ExtractedPrimitive with full type information
+ */
+export declare function extractPrimitive(typeContent: string, primitiveName: string, version?: string, packageName?: string): ExtractedPrimitive;
+/**
+ * Classify an array of raw props into full PropDefinitions.
+ */
+export declare function classifyProps(rawProps: RawProp[]): PropDefinition[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extractor/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAMrF,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,4BAA4B,EAC5B,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,yBAAyB,EACzB,WAAW,EACX,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EACL,YAAY,EACZ,cAAc,EACd,cAAc,EACd,aAAa,EACb,eAAe,EACf,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,MAAkB,EAC3B,WAAW,CAAC,EAAE,MAAM,GACnB,kBAAkB,CAWpB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,CAcnE"}

package/dist/extractor/index.js

@@ -0,0 +1,43 @@
+/**
+ * Type extractor module for parsing Radix type definitions.
+ */
+import { parseTypes } from './project.js';
+import { extractPrimitiveFromSource } from './interface.js';
+import { primitiveToPackage } from '../fetcher/npm-registry.js';
+// Re-export utilities
+export { createProject, createSourceFile, parseTypes } from './project.js';
+export { findInterfaces, findPropsInterfaces, extractSubComponents, extractSubComponentsEnhanced, findExports, detectContextUsage, extractContextShape, extractPrimitiveFromSource, } from './interface.js';
+export { findForwardRefDeclarations, extractPropsFromForwardRef, getSubComponentSuffix, } from './forward-ref.js';
+export { resolveTypeAlias, mergeIntersectionTypes, filterReactInternals, resolveTypeReference, } from './type-resolver.js';
+export { extractPropsFromInterface, extractProp, isPropsInterface, componentNameFromProps, } from './props.js';
+export { extractJsDoc, extractDefaultFromComment } from './jsdoc.js';
+export { classifyProp, isStateControl, isEventHandler, isComposition, isConfiguration, getPropCategory, } from './classifier.js';
+/**
+ * Extract primitive information from type content.
+ *
+ * @param typeContent - The .d.ts file content
+ * @param primitiveName - The primitive name (e.g., "Dialog")
+ * @param version - The package version
+ * @returns ExtractedPrimitive with full type information
+ */
+export function extractPrimitive(typeContent, primitiveName, version = 'unknown', packageName) {
+    const sourceFile = parseTypes(typeContent);
+    const resolvedPackageName = packageName ?? primitiveToPackage(primitiveName.toLowerCase());
+    return extractPrimitiveFromSource(sourceFile, primitiveName, resolvedPackageName, version);
+}
+/**
+ * Classify an array of raw props into full PropDefinitions.
+ */
+export function classifyProps(rawProps) {
+    return rawProps.map((raw) => ({
+        ...raw,
+        isStateControl: raw.name === 'open' ||
+            raw.name === 'value' ||
+            raw.name === 'checked' ||
+            raw.name.startsWith('default'),
+        isEventHandler: /^on[A-Z]/.test(raw.name),
+        isConfiguration: ['modal', 'orientation', 'side', 'align'].includes(raw.name),
+        isComposition: raw.name === 'asChild' || raw.name === 'children',
+    }));
+}
+//# sourceMappingURL=index.js.map

package/dist/extractor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/extractor/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,sBAAsB;AACtB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,4BAA4B,EAC5B,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,yBAAyB,EACzB,WAAW,EACX,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EACL,YAAY,EACZ,cAAc,EACd,cAAc,EACd,aAAa,EACb,eAAe,EACf,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,WAAmB,EACnB,aAAqB,EACrB,UAAkB,SAAS,EAC3B,WAAoB;IAEpB,MAAM,UAAU,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAC3C,MAAM,mBAAmB,GACvB,WAAW,IAAI,kBAAkB,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC,CAAC;IAEjE,OAAO,0BAA0B,CAC/B,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,OAAO,CACR,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,QAAmB;IAC/C,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC5B,GAAG,GAAG;QACN,cAAc,EACZ,GAAG,CAAC,IAAI,KAAK,MAAM;YACnB,GAAG,CAAC,IAAI,KAAK,OAAO;YACpB,GAAG,CAAC,IAAI,KAAK,SAAS;YACtB,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAChC,cAAc,EAAE,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;QACzC,eAAe,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,QAAQ,CACjE,GAAG,CAAC,IAAI,CACT;QACD,aAAa,EAAE,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU;KACjE,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/extractor/interface.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Interface extraction from TypeScript source files.
+ */
+import type { SourceFile, InterfaceDeclaration } from 'ts-morph';
+import type { SubComponentDefinition, ExtractedPrimitive, PropDefinition } from '../types/index.js';
+/**
+ * Find all interfaces in a source file.
+ */
+export declare function findInterfaces(sourceFile: SourceFile): InterfaceDeclaration[];
+/**
+ * Find props interfaces (names ending with "Props").
+ */
+export declare function findPropsInterfaces(sourceFile: SourceFile): InterfaceDeclaration[];
+/**
+ * Extract sub-components from props interfaces.
+ */
+export declare function extractSubComponents(sourceFile: SourceFile, primitiveName: string): SubComponentDefinition[];
+/**
+ * Enhanced sub-component extraction that also handles ForwardRefExoticComponent.
+ * This function combines interface-based extraction with ForwardRef detection.
+ */
+export declare function extractSubComponentsEnhanced(sourceFile: SourceFile, primitiveName: string): SubComponentDefinition[];
+/**
+ * Find exported names from a source file.
+ */
+export declare function findExports(sourceFile: SourceFile): string[];
+/**
+ * Check if the primitive uses React Context.
+ */
+export declare function detectContextUsage(sourceFile: SourceFile): boolean;
+/**
+ * Extract context shape if present.
+ */
+export declare function extractContextShape(sourceFile: SourceFile, primitiveName: string): PropDefinition[] | undefined;
+/**
+ * Extract a complete primitive from a source file.
+ * Uses enhanced extraction with ForwardRef support for real .d.ts files.
+ */
+export declare function extractPrimitiveFromSource(sourceFile: SourceFile, primitiveName: string, packageName: string, version: string): ExtractedPrimitive;
+//# sourceMappingURL=interface.d.ts.map

package/dist/extractor/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/extractor/interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACjE,OAAO,KAAK,EACV,sBAAsB,EACtB,kBAAkB,EAClB,cAAc,EACf,MAAM,mBAAmB,CAAC;AA+B3B;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,oBAAoB,EAAE,CAE7E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,UAAU,GACrB,oBAAoB,EAAE,CAExB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,UAAU,EACtB,aAAa,EAAE,MAAM,GACpB,sBAAsB,EAAE,CAkC1B;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,UAAU,EACtB,aAAa,EAAE,MAAM,GACpB,sBAAsB,EAAE,CA4D1B;AAqCD;;GAEG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,EAAE,CA6B5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAOlE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,UAAU,EACtB,aAAa,EAAE,MAAM,GACpB,cAAc,EAAE,GAAG,SAAS,CAY9B;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,UAAU,EACtB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,kBAAkB,CAwBpB"}

package/dist/extractor/interface.js

@@ -0,0 +1,233 @@
+/**
+ * Interface extraction from TypeScript source files.
+ */
+import { extractPropsFromInterface, isPropsInterface } from './props.js';
+import { classifyProp } from './classifier.js';
+import { findForwardRefDeclarations, extractPropsFromForwardRef, getSubComponentSuffix, } from './forward-ref.js';
+import { filterReactInternals } from './type-resolver.js';
+/**
+ * Pattern for Radix sub-component naming.
+ * @example "DialogRoot", "DialogContent", "DialogTrigger"
+ */
+const SUB_COMPONENT_PATTERN = /^([A-Z][a-z]+)(Root|Trigger|Content|Title|Description|Close|Overlay|Portal|Arrow|Item|Indicator|Thumb|Track|Range|Viewport|Scrollbar|Corner|Action|Cancel|Group|Label|Separator|Sub|List|Value|Icon|Image|Fallback)Props$/;
+/**
+ * Required sub-components by primitive type.
+ */
+const REQUIRED_SUB_COMPONENTS = {
+    Dialog: ['Root', 'Trigger', 'Content'],
+    AlertDialog: ['Root', 'Trigger', 'Content', 'Action', 'Cancel'],
+    Popover: ['Root', 'Trigger', 'Content'],
+    Tooltip: ['Root', 'Trigger', 'Content'],
+    DropdownMenu: ['Root', 'Trigger', 'Content'],
+    ContextMenu: ['Root', 'Trigger', 'Content'],
+    Select: ['Root', 'Trigger', 'Value', 'Content'],
+    Tabs: ['Root', 'List', 'Trigger', 'Content'],
+    Accordion: ['Root', 'Item', 'Trigger', 'Content'],
+};
+/**
+ * Find all interfaces in a source file.
+ */
+export function findInterfaces(sourceFile) {
+    return sourceFile.getInterfaces();
+}
+/**
+ * Find props interfaces (names ending with "Props").
+ */
+export function findPropsInterfaces(sourceFile) {
+    return sourceFile.getInterfaces().filter((i) => isPropsInterface(i.getName()));
+}
+/**
+ * Extract sub-components from props interfaces.
+ */
+export function extractSubComponents(sourceFile, primitiveName) {
+    const subComponents = [];
+    const interfaces = findPropsInterfaces(sourceFile);
+    const requiredSubs = REQUIRED_SUB_COMPONENTS[primitiveName] || [];
+    for (const iface of interfaces) {
+        const name = iface.getName();
+        // Check if it matches the sub-component pattern
+        const match = name.match(SUB_COMPONENT_PATTERN);
+        if (match && match[1] === primitiveName) {
+            const subName = match[2];
+            const rawProps = extractPropsFromInterface(iface);
+            const props = rawProps.map(classifyProp);
+            subComponents.push({
+                name: subName,
+                props,
+                isRequired: requiredSubs.includes(subName),
+            });
+        }
+        else if (name === `${primitiveName}Props`) {
+            // Root component props
+            const rawProps = extractPropsFromInterface(iface);
+            const props = rawProps.map(classifyProp);
+            subComponents.push({
+                name: 'Root',
+                props,
+                isRequired: true,
+            });
+        }
+    }
+    return subComponents;
+}
+/**
+ * Enhanced sub-component extraction that also handles ForwardRefExoticComponent.
+ * This function combines interface-based extraction with ForwardRef detection.
+ */
+export function extractSubComponentsEnhanced(sourceFile, primitiveName) {
+    const subComponents = [];
+    const seenNames = new Set();
+    const requiredSubs = REQUIRED_SUB_COMPONENTS[primitiveName] || [];
+    // First, try ForwardRef declarations (more common in real .d.ts files)
+    const forwardRefDecls = findForwardRefDeclarations(sourceFile);
+    for (const decl of forwardRefDecls) {
+        const suffix = getSubComponentSuffix(decl.name, primitiveName);
+        if (!suffix && decl.name !== primitiveName)
+            continue;
+        const subName = suffix || 'Root';
+        if (seenNames.has(subName))
+            continue;
+        seenNames.add(subName);
+        const rawProps = extractPropsFromForwardRef(sourceFile, decl);
+        const filteredProps = rawProps ? filterReactInternals(rawProps) : [];
+        const props = filteredProps.map(classifyProp);
+        subComponents.push({
+            name: subName,
+            props,
+            isRequired: requiredSubs.includes(subName),
+        });
+    }
+    // Also check for React.FC exports (like DialogPortal)
+    const fcDecls = findFCDeclarations(sourceFile, primitiveName);
+    for (const { name, propsTypeName } of fcDecls) {
+        const suffix = getSubComponentSuffix(name, primitiveName);
+        if (!suffix && name !== primitiveName)
+            continue;
+        const subName = suffix || 'Root';
+        if (seenNames.has(subName))
+            continue;
+        seenNames.add(subName);
+        // Try to get props from the interface
+        let props = [];
+        if (propsTypeName) {
+            const propsInterface = sourceFile.getInterface(propsTypeName);
+            if (propsInterface) {
+                const rawProps = extractPropsFromInterface(propsInterface);
+                props = filterReactInternals(rawProps).map(classifyProp);
+            }
+        }
+        subComponents.push({
+            name: subName,
+            props,
+            isRequired: requiredSubs.includes(subName),
+        });
+    }
+    // Fallback: use interface-based extraction if no ForwardRef found
+    if (subComponents.length === 0) {
+        return extractSubComponents(sourceFile, primitiveName);
+    }
+    return subComponents;
+}
+/**
+ * Find React.FC variable declarations for a primitive.
+ */
+function findFCDeclarations(sourceFile, primitiveName) {
+    const results = [];
+    for (const statement of sourceFile.getVariableStatements()) {
+        for (const decl of statement.getDeclarations()) {
+            const typeNode = decl.getTypeNode();
+            if (!typeNode)
+                continue;
+            const typeText = typeNode.getText();
+            const name = decl.getName();
+            // Check if it's React.FC and matches our primitive
+            if ((typeText.includes('React.FC') || typeText.includes('FC<')) &&
+                name.startsWith(primitiveName)) {
+                // Extract props type from FC<PropsType>
+                const match = typeText.match(/(?:React\.)?FC<(\w+)>/);
+                results.push({
+                    name,
+                    propsTypeName: match ? match[1] : null,
+                });
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Find exported names from a source file.
+ */
+export function findExports(sourceFile) {
+    const exports = [];
+    // Get export declarations
+    for (const exportDecl of sourceFile.getExportDeclarations()) {
+        for (const named of exportDecl.getNamedExports()) {
+            exports.push(named.getName());
+        }
+    }
+    // Get export assignments (export default)
+    const defaultExport = sourceFile.getDefaultExportSymbol();
+    if (defaultExport) {
+        exports.push('default');
+    }
+    // Get directly exported declarations
+    for (const stmt of sourceFile.getStatements()) {
+        if (stmt.getText().startsWith('export ')) {
+            // Try to extract the name
+            const text = stmt.getText();
+            const match = text.match(/export\s+(?:const|let|var|function|class|interface|type)\s+(\w+)/);
+            if (match) {
+                exports.push(match[1]);
+            }
+        }
+    }
+    return [...new Set(exports)];
+}
+/**
+ * Check if the primitive uses React Context.
+ */
+export function detectContextUsage(sourceFile) {
+    const text = sourceFile.getFullText();
+    return (text.includes('createContext') ||
+        text.includes('useContext') ||
+        text.includes('Provider'));
+}
+/**
+ * Extract context shape if present.
+ */
+export function extractContextShape(sourceFile, primitiveName) {
+    // Look for *ContextValue interface
+    const contextInterface = sourceFile.getInterface(`${primitiveName}ContextValue`);
+    if (contextInterface) {
+        const rawProps = extractPropsFromInterface(contextInterface);
+        return rawProps.map(classifyProp);
+    }
+    return undefined;
+}
+/**
+ * Extract a complete primitive from a source file.
+ * Uses enhanced extraction with ForwardRef support for real .d.ts files.
+ */
+export function extractPrimitiveFromSource(sourceFile, primitiveName, packageName, version) {
+    // Try enhanced extraction first (handles ForwardRefExoticComponent)
+    let subComponents = extractSubComponentsEnhanced(sourceFile, primitiveName);
+    // Fallback to standard extraction if enhanced returns empty
+    if (subComponents.length === 0) {
+        subComponents = extractSubComponents(sourceFile, primitiveName);
+    }
+    // Find root props (either from XxxProps or from Root sub-component)
+    const rootSubComponent = subComponents.find((s) => s.name === 'Root');
+    const rootProps = rootSubComponent?.props || [];
+    return {
+        name: primitiveName,
+        package: packageName,
+        version,
+        extractedAt: new Date().toISOString(),
+        rootProps,
+        subComponents,
+        exports: findExports(sourceFile),
+        usesContext: detectContextUsage(sourceFile),
+        contextShape: extractContextShape(sourceFile, primitiveName),
+    };
+}
+//# sourceMappingURL=interface.js.map

package/dist/extractor/interface.js.map

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

package/dist/extractor/jsdoc.d.ts

@@ -0,0 +1,24 @@
+/**
+ * JSDoc extraction utilities.
+ */
+import type { JSDoc, PropertySignature } from 'ts-morph';
+export interface JsDocInfo {
+    description?: string;
+    defaultValue?: string;
+    deprecated?: boolean;
+    see?: string[];
+    example?: string;
+}
+/**
+ * Extract JSDoc information from a property.
+ */
+export declare function extractJsDoc(prop: PropertySignature): JsDocInfo;
+/**
+ * Extract @default value from JSDoc comment text.
+ * Handles formats like:
+ * - @default "value"
+ * - @default `value`
+ * - @default value
+ */
+export declare function extractDefaultFromComment(jsDocs: JSDoc[]): string | undefined;
+//# sourceMappingURL=jsdoc.d.ts.map

package/dist/extractor/jsdoc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsdoc.d.ts","sourceRoot":"","sources":["../../src/extractor/jsdoc.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAEzD,MAAM,WAAW,SAAS;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,iBAAiB,GAAG,SAAS,CAuC/D;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,KAAK,EAAE,GACd,MAAM,GAAG,SAAS,CAUpB"}

package/dist/extractor/jsdoc.js

@@ -0,0 +1,74 @@
+/**
+ * JSDoc extraction utilities.
+ */
+/**
+ * Extract JSDoc information from a property.
+ */
+export function extractJsDoc(prop) {
+    const jsDocs = prop.getJsDocs();
+    if (jsDocs.length === 0) {
+        return {};
+    }
+    const result = {};
+    const doc = jsDocs[0];
+    // Get main description
+    const description = doc.getDescription();
+    if (description) {
+        result.description = description.trim();
+    }
+    // Parse tags
+    for (const tag of doc.getTags()) {
+        const tagName = tag.getTagName();
+        const text = tag.getText();
+        switch (tagName) {
+            case 'default':
+            case 'defaultValue':
+                result.defaultValue = extractTagValue(text);
+                break;
+            case 'deprecated':
+                result.deprecated = true;
+                break;
+            case 'see':
+                result.see = result.see || [];
+                result.see.push(extractTagValue(text));
+                break;
+            case 'example':
+                result.example = extractTagValue(text);
+                break;
+        }
+    }
+    return result;
+}
+/**
+ * Extract @default value from JSDoc comment text.
+ * Handles formats like:
+ * - @default "value"
+ * - @default `value`
+ * - @default value
+ */
+export function extractDefaultFromComment(jsDocs) {
+    for (const doc of jsDocs) {
+        for (const tag of doc.getTags()) {
+            const tagName = tag.getTagName();
+            if (tagName === 'default' || tagName === 'defaultValue') {
+                return extractTagValue(tag.getText());
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Extract the value from a JSDoc tag text.
+ */
+function extractTagValue(text) {
+    // Remove the @tagName part
+    const value = text.replace(/^@\w+\s*/, '').trim();
+    // Remove surrounding quotes or backticks
+    if ((value.startsWith('"') && value.endsWith('"')) ||
+        (value.startsWith("'") && value.endsWith("'")) ||
+        (value.startsWith('`') && value.endsWith('`'))) {
+        return value.slice(1, -1);
+    }
+    return value;
+}
+//# sourceMappingURL=jsdoc.js.map

package/dist/extractor/jsdoc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsdoc.js","sourceRoot":"","sources":["../../src/extractor/jsdoc.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAuB;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAChC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAc,EAAE,CAAC;IAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAEtB,uBAAuB;IACvB,MAAM,WAAW,GAAG,GAAG,CAAC,cAAc,EAAE,CAAC;IACzC,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,CAAC,WAAW,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,aAAa;IACb,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;QAE3B,QAAQ,OAAO,EAAE,CAAC;YAChB,KAAK,SAAS,CAAC;YACf,KAAK,cAAc;gBACjB,MAAM,CAAC,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;gBAC5C,MAAM;YACR,KAAK,YAAY;gBACf,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC;gBACzB,MAAM;YACR,KAAK,KAAK;gBACR,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;gBAC9B,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;gBACvC,MAAM;YACR,KAAK,SAAS;gBACZ,MAAM,CAAC,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;gBACvC,MAAM;QACV,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAe;IAEf,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC;YACjC,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,cAAc,EAAE,CAAC;gBACxD,OAAO,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,IAAY;IACnC,2BAA2B;IAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAElD,yCAAyC;IACzC,IACE,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC9C,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC9C,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAC9C,CAAC;QACD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/extractor/project.d.ts

@@ -0,0 +1,17 @@
+/**
+ * ts-morph project setup for parsing type definitions.
+ */
+import { Project, SourceFile } from 'ts-morph';
+/**
+ * Create a ts-morph Project with in-memory file system.
+ */
+export declare function createProject(): Project;
+/**
+ * Create a source file from type content.
+ */
+export declare function createSourceFile(project: Project, content: string, fileName?: string): SourceFile;
+/**
+ * Parse type content and return a source file.
+ */
+export declare function parseTypes(content: string): SourceFile;
+//# sourceMappingURL=project.d.ts.map

package/dist/extractor/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/extractor/project.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE/C;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAWvC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAqB,GAC9B,UAAU,CAEZ;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAGtD"}