@sudosandwich/limps-radix 0.1.1

package/dist/cache/storage.js

@@ -0,0 +1,176 @@
+/**
+ * File-based cache storage for Radix primitive data.
+ *
+ * Cache structure:
+ * ~/.limps-radix/
+ *   cache/
+ *     1.0.5/
+ *       dialog.json          # ExtractedPrimitive
+ *       dialog.sig.json      # BehaviorSignature
+ *     1.1.0/
+ *       ...
+ *     latest-resolved.json   # { primitive: { version: "1.1.2", resolvedAt: "..." } }
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import * as os from 'node:os';
+/**
+ * Default cache directory name.
+ */
+const CACHE_DIR_NAME = '.limps-radix';
+/**
+ * Sub-directory for versioned cache data.
+ */
+const CACHE_SUBDIR = 'cache';
+/**
+ * Get the cache directory path.
+ * @param baseDir - Optional base directory (defaults to home directory)
+ * @returns Absolute path to the cache directory
+ */
+export function getCacheDir(baseDir) {
+    const base = baseDir || os.homedir();
+    return path.join(base, CACHE_DIR_NAME, CACHE_SUBDIR);
+}
+/**
+ * Get the versioned cache directory path.
+ * @param version - The Radix version
+ * @param baseDir - Optional base directory
+ * @returns Absolute path to the versioned cache directory
+ */
+export function getVersionedCacheDir(version, baseDir) {
+    return path.join(getCacheDir(baseDir), version);
+}
+/**
+ * Get the path for a cached primitive file.
+ * @param primitive - Primitive name (e.g., "Dialog")
+ * @param version - Version string
+ * @param type - Type of cache ('data' for ExtractedPrimitive, 'sig' for BehaviorSignature)
+ * @param baseDir - Optional base directory
+ * @returns Absolute file path
+ */
+export function getCachePath(primitive, version, type, baseDir) {
+    const dir = getVersionedCacheDir(version, baseDir);
+    const fileName = type === 'sig'
+        ? `${primitive.toLowerCase()}.sig.json`
+        : `${primitive.toLowerCase()}.json`;
+    return path.join(dir, fileName);
+}
+/**
+ * Ensure the cache directory exists.
+ * @param dirPath - Directory path to create
+ */
+async function ensureDir(dirPath) {
+    await fs.mkdir(dirPath, { recursive: true });
+}
+/**
+ * Read data from a cache file.
+ * @param cachePath - Full path to the cache file
+ * @returns Parsed JSON data or null if file doesn't exist or is invalid
+ */
+export async function readFromFile(cachePath) {
+    try {
+        const content = await fs.readFile(cachePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        // File doesn't exist or parse error
+        if (error.code === 'ENOENT') {
+            return null;
+        }
+        // Log parse errors but return null
+        console.warn(`Cache read error for ${cachePath}:`, error);
+        return null;
+    }
+}
+/**
+ * Write data to a cache file.
+ * @param cachePath - Full path to the cache file
+ * @param data - Data to write
+ */
+export async function writeToFile(cachePath, data) {
+    const dir = path.dirname(cachePath);
+    await ensureDir(dir);
+    const content = JSON.stringify(data, null, 2);
+    await fs.writeFile(cachePath, content, 'utf-8');
+}
+/**
+ * Delete a cache file.
+ * @param cachePath - Full path to the cache file
+ * @returns True if file was deleted, false if it didn't exist
+ */
+export async function deleteFile(cachePath) {
+    try {
+        await fs.unlink(cachePath);
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return false;
+        }
+        throw error;
+    }
+}
+/**
+ * Delete a directory and all its contents.
+ * @param dirPath - Directory path to delete
+ * @returns True if directory was deleted, false if it didn't exist
+ */
+export async function deleteDir(dirPath) {
+    try {
+        await fs.rm(dirPath, { recursive: true, force: true });
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return false;
+        }
+        throw error;
+    }
+}
+/**
+ * List all versioned cache directories.
+ * @param baseDir - Optional base directory
+ * @returns Array of version strings that have cached data
+ */
+export async function listCachedVersions(baseDir) {
+    const cacheDir = getCacheDir(baseDir);
+    try {
+        const entries = await fs.readdir(cacheDir, { withFileTypes: true });
+        return entries
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => entry.name)
+            .filter((name) => /^\d+\.\d+\.\d+/.test(name)); // Only semver-like directories
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return [];
+        }
+        throw error;
+    }
+}
+/**
+ * List all cached primitives for a version.
+ * @param version - Version string
+ * @param baseDir - Optional base directory
+ * @returns Array of primitive names that have cached data
+ */
+export async function listCachedPrimitives(version, baseDir) {
+    const versionDir = getVersionedCacheDir(version, baseDir);
+    try {
+        const entries = await fs.readdir(versionDir);
+        return entries
+            .filter((name) => name.endsWith('.json') && !name.endsWith('.sig.json'))
+            .map((name) => {
+            // Convert filename back to primitive name (capitalize first letter)
+            const baseName = name.replace('.json', '');
+            return baseName.charAt(0).toUpperCase() + baseName.slice(1);
+        });
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return [];
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/cache/storage.js.map

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

package/dist/cache/ttl.d.ts

@@ -0,0 +1,62 @@
+/**
+ * TTL (Time-To-Live) checking logic for cache expiration.
+ */
+/**
+ * TTL constants in milliseconds.
+ */
+export declare const TTL: {
+    /**
+     * TTL for versioned primitive data (7 days).
+     * Versioned data is stable and can be cached longer.
+     */
+    readonly VERSION_DATA: number;
+    /**
+     * TTL for "latest" version resolution (1 hour).
+     * Latest version can change frequently, so we check more often.
+     */
+    readonly LATEST_RESOLUTION: number;
+    /**
+     * TTL for signature data (same as version data).
+     * Signatures derived from versioned data inherit the same TTL.
+     */
+    readonly SIGNATURE_DATA: number;
+};
+/**
+ * Check if a timestamp has expired based on TTL.
+ * @param timestamp - ISO timestamp string
+ * @param ttlMs - Time-to-live in milliseconds
+ * @returns True if the data has expired
+ */
+export declare function isExpired(timestamp: string, ttlMs: number): boolean;
+/**
+ * Check if version data has expired.
+ * @param timestamp - ISO timestamp string (extractedAt)
+ * @returns True if the version data has expired
+ */
+export declare function isVersionDataExpired(timestamp: string): boolean;
+/**
+ * Check if "latest" resolution has expired.
+ * @param timestamp - ISO timestamp string (resolvedAt)
+ * @returns True if the latest resolution has expired
+ */
+export declare function isLatestResolutionExpired(timestamp: string): boolean;
+/**
+ * Check if signature data has expired.
+ * @param timestamp - ISO timestamp string
+ * @returns True if the signature data has expired
+ */
+export declare function isSignatureExpired(timestamp: string): boolean;
+/**
+ * Get the remaining TTL for cached data.
+ * @param timestamp - ISO timestamp string
+ * @param ttlMs - Time-to-live in milliseconds
+ * @returns Remaining time in milliseconds (negative if expired)
+ */
+export declare function getRemainingTtl(timestamp: string, ttlMs: number): number;
+/**
+ * Format remaining TTL as human-readable string.
+ * @param remainingMs - Remaining time in milliseconds
+ * @returns Human-readable string like "2 days", "3 hours", "expired"
+ */
+export declare function formatRemainingTtl(remainingMs: number): string;
+//# sourceMappingURL=ttl.d.ts.map

package/dist/cache/ttl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ttl.d.ts","sourceRoot":"","sources":["../../src/cache/ttl.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,GAAG;IACd;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;CAEK,CAAC;AAEX;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAKnE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKxE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAoB9D"}

package/dist/cache/ttl.js

@@ -0,0 +1,96 @@
+/**
+ * TTL (Time-To-Live) checking logic for cache expiration.
+ */
+/**
+ * TTL constants in milliseconds.
+ */
+export const TTL = {
+    /**
+     * TTL for versioned primitive data (7 days).
+     * Versioned data is stable and can be cached longer.
+     */
+    VERSION_DATA: 7 * 24 * 60 * 60 * 1000,
+    /**
+     * TTL for "latest" version resolution (1 hour).
+     * Latest version can change frequently, so we check more often.
+     */
+    LATEST_RESOLUTION: 60 * 60 * 1000,
+    /**
+     * TTL for signature data (same as version data).
+     * Signatures derived from versioned data inherit the same TTL.
+     */
+    SIGNATURE_DATA: 7 * 24 * 60 * 60 * 1000,
+};
+/**
+ * Check if a timestamp has expired based on TTL.
+ * @param timestamp - ISO timestamp string
+ * @param ttlMs - Time-to-live in milliseconds
+ * @returns True if the data has expired
+ */
+export function isExpired(timestamp, ttlMs) {
+    const cachedTime = new Date(timestamp).getTime();
+    const now = Date.now();
+    const age = now - cachedTime;
+    return age >= ttlMs;
+}
+/**
+ * Check if version data has expired.
+ * @param timestamp - ISO timestamp string (extractedAt)
+ * @returns True if the version data has expired
+ */
+export function isVersionDataExpired(timestamp) {
+    return isExpired(timestamp, TTL.VERSION_DATA);
+}
+/**
+ * Check if "latest" resolution has expired.
+ * @param timestamp - ISO timestamp string (resolvedAt)
+ * @returns True if the latest resolution has expired
+ */
+export function isLatestResolutionExpired(timestamp) {
+    return isExpired(timestamp, TTL.LATEST_RESOLUTION);
+}
+/**
+ * Check if signature data has expired.
+ * @param timestamp - ISO timestamp string
+ * @returns True if the signature data has expired
+ */
+export function isSignatureExpired(timestamp) {
+    return isExpired(timestamp, TTL.SIGNATURE_DATA);
+}
+/**
+ * Get the remaining TTL for cached data.
+ * @param timestamp - ISO timestamp string
+ * @param ttlMs - Time-to-live in milliseconds
+ * @returns Remaining time in milliseconds (negative if expired)
+ */
+export function getRemainingTtl(timestamp, ttlMs) {
+    const cachedTime = new Date(timestamp).getTime();
+    const now = Date.now();
+    const age = now - cachedTime;
+    return ttlMs - age;
+}
+/**
+ * Format remaining TTL as human-readable string.
+ * @param remainingMs - Remaining time in milliseconds
+ * @returns Human-readable string like "2 days", "3 hours", "expired"
+ */
+export function formatRemainingTtl(remainingMs) {
+    if (remainingMs <= 0) {
+        return 'expired';
+    }
+    const seconds = Math.floor(remainingMs / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    if (days > 0) {
+        return `${days} day${days === 1 ? '' : 's'}`;
+    }
+    if (hours > 0) {
+        return `${hours} hour${hours === 1 ? '' : 's'}`;
+    }
+    if (minutes > 0) {
+        return `${minutes} minute${minutes === 1 ? '' : 's'}`;
+    }
+    return `${seconds} second${seconds === 1 ? '' : 's'}`;
+}
+//# sourceMappingURL=ttl.js.map

package/dist/cache/ttl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ttl.js","sourceRoot":"","sources":["../../src/cache/ttl.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB;;;OAGG;IACH,YAAY,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;IAErC;;;OAGG;IACH,iBAAiB,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;IAEjC;;;OAGG;IACH,cAAc,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;CAC/B,CAAC;AAEX;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,SAAiB,EAAE,KAAa;IACxD,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,GAAG,GAAG,GAAG,GAAG,UAAU,CAAC;IAC7B,OAAO,GAAG,IAAI,KAAK,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,OAAO,SAAS,CAAC,SAAS,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;AAChD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,SAAiB;IACzD,OAAO,SAAS,CAAC,SAAS,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,OAAO,SAAS,CAAC,SAAS,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,KAAa;IAC9D,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,GAAG,GAAG,GAAG,GAAG,UAAU,CAAC;IAC7B,OAAO,KAAK,GAAG,GAAG,CAAC;AACrB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAmB;IACpD,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;QACrB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IAEpC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACb,OAAO,GAAG,IAAI,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IAC/C,CAAC;IACD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,OAAO,GAAG,KAAK,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IAClD,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,OAAO,GAAG,OAAO,UAAU,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IACxD,CAAC;IACD,OAAO,GAAG,OAAO,UAAU,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;AACxD,CAAC"}

package/dist/extractor/classifier.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Semantic prop classifier.
+ * Classifies props into categories: state, event, config, composition.
+ */
+import type { PropDefinition, RawProp } from '../types/index.js';
+/**
+ * Classify a raw prop into a full PropDefinition.
+ */
+export declare function classifyProp(raw: RawProp): PropDefinition;
+/**
+ * Check if a prop name indicates state control.
+ */
+export declare function isStateControl(name: string): boolean;
+/**
+ * Check if a prop name indicates an event handler.
+ */
+export declare function isEventHandler(name: string): boolean;
+/**
+ * Check if a prop name indicates composition.
+ */
+export declare function isComposition(name: string): boolean;
+/**
+ * Check if a prop name indicates configuration.
+ */
+export declare function isConfiguration(name: string): boolean;
+/**
+ * Get the category of a prop.
+ */
+export declare function getPropCategory(name: string): 'state' | 'event' | 'composition' | 'config' | 'other';
+//# sourceMappingURL=classifier.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.d.ts","sourceRoot":"","sources":["../../src/extractor/classifier.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAkGjE;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAQzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAYpD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,GACX,OAAO,GAAG,OAAO,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,CAMxD"}

package/dist/extractor/classifier.js

@@ -0,0 +1,150 @@
+/**
+ * Semantic prop classifier.
+ * Classifies props into categories: state, event, config, composition.
+ */
+/**
+ * State control props - control component state
+ */
+const STATE_PROPS = new Set([
+    'open',
+    'defaultOpen',
+    'value',
+    'defaultValue',
+    'checked',
+    'defaultChecked',
+    'pressed',
+    'defaultPressed',
+    'selected',
+    'defaultSelected',
+    'active',
+    'expanded',
+    'disabled',
+]);
+/**
+ * State prop patterns
+ */
+const STATE_PATTERNS = [/^default[A-Z]/, /^is[A-Z]/];
+/**
+ * Event handler pattern - onXxx
+ */
+const EVENT_PATTERN = /^on[A-Z]/;
+/**
+ * Composition props - affect component composition
+ */
+const COMPOSITION_PROPS = new Set([
+    'asChild',
+    'children',
+    'as',
+    'render',
+    'slot',
+]);
+/**
+ * Configuration props - affect behavior/appearance
+ */
+const CONFIG_PROPS = new Set([
+    // Layout/positioning
+    'modal',
+    'side',
+    'sideOffset',
+    'align',
+    'alignOffset',
+    'orientation',
+    'dir',
+    'loop',
+    'sticky',
+    'hideWhenDetached',
+    'avoidCollisions',
+    'collisionBoundary',
+    'collisionPadding',
+    // Behavior
+    'closeOnEscape',
+    'closeOnOutsideClick',
+    'closeOnInteractOutside',
+    'trapFocus',
+    'restoreFocus',
+    'preventScroll',
+    'disableOutsidePointerEvents',
+    'forceMount',
+    'delayDuration',
+    'skipDelayDuration',
+    'disableHoverableContent',
+    // Accessibility
+    'ariaLabel',
+    'aria-label',
+    'ariaLabelledby',
+    'aria-labelledby',
+    'ariaDescribedby',
+    'aria-describedby',
+    // Styling
+    'className',
+    'style',
+    // Other common configs
+    'id',
+    'name',
+    'required',
+    'placeholder',
+    'min',
+    'max',
+    'step',
+    'type',
+    'form',
+]);
+/**
+ * Classify a raw prop into a full PropDefinition.
+ */
+export function classifyProp(raw) {
+    return {
+        ...raw,
+        isStateControl: isStateControl(raw.name),
+        isEventHandler: isEventHandler(raw.name),
+        isConfiguration: isConfiguration(raw.name),
+        isComposition: isComposition(raw.name),
+    };
+}
+/**
+ * Check if a prop name indicates state control.
+ */
+export function isStateControl(name) {
+    if (STATE_PROPS.has(name)) {
+        return true;
+    }
+    for (const pattern of STATE_PATTERNS) {
+        if (pattern.test(name)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Check if a prop name indicates an event handler.
+ */
+export function isEventHandler(name) {
+    return EVENT_PATTERN.test(name);
+}
+/**
+ * Check if a prop name indicates composition.
+ */
+export function isComposition(name) {
+    return COMPOSITION_PROPS.has(name);
+}
+/**
+ * Check if a prop name indicates configuration.
+ */
+export function isConfiguration(name) {
+    return CONFIG_PROPS.has(name);
+}
+/**
+ * Get the category of a prop.
+ */
+export function getPropCategory(name) {
+    if (isStateControl(name))
+        return 'state';
+    if (isEventHandler(name))
+        return 'event';
+    if (isComposition(name))
+        return 'composition';
+    if (isConfiguration(name))
+        return 'config';
+    return 'other';
+}
+//# sourceMappingURL=classifier.js.map

package/dist/extractor/classifier.js.map

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

package/dist/extractor/forward-ref.d.ts

@@ -0,0 +1,28 @@
+/**
+ * ForwardRefExoticComponent extraction for complex .d.ts files.
+ * Handles patterns like: React.ForwardRefExoticComponent<Props & React.RefAttributes<Element>>
+ */
+import type { SourceFile, VariableDeclaration } from 'ts-morph';
+import type { RawProp } from '../types/index.js';
+/**
+ * Result of finding a ForwardRef declaration.
+ */
+export interface ForwardRefDeclaration {
+    name: string;
+    declaration: VariableDeclaration;
+    propsTypeName: string | null;
+}
+/**
+ * Find all ForwardRefExoticComponent variable declarations in a source file.
+ */
+export declare function findForwardRefDeclarations(sourceFile: SourceFile): ForwardRefDeclaration[];
+/**
+ * Extract props from a ForwardRef declaration by resolving its type parameter.
+ */
+export declare function extractPropsFromForwardRef(sourceFile: SourceFile, decl: ForwardRefDeclaration): RawProp[] | null;
+/**
+ * Get the sub-component suffix from a component name.
+ * @example "DialogContent" with primitive "Dialog" -> "Content"
+ */
+export declare function getSubComponentSuffix(componentName: string, primitiveName: string): string | null;
+//# sourceMappingURL=forward-ref.d.ts.map

package/dist/extractor/forward-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forward-ref.d.ts","sourceRoot":"","sources":["../../src/extractor/forward-ref.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,mBAAmB,EAEpB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAGjD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,mBAAmB,CAAC;IACjC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,UAAU,GACrB,qBAAqB,EAAE,CAuBzB;AAqBD;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,qBAAqB,GAC1B,OAAO,EAAE,GAAG,IAAI,CAkBlB;AAuED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,GACpB,MAAM,GAAG,IAAI,CAUf"}