@urbicon-ui/docs-gen 6.1.4

package/dist/extractors/variants/VariantsExtractor.js

@@ -0,0 +1,340 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import * as ts from 'typescript';
+import { TypeScriptBaseExtractor } from '../typescript/TypeScriptBaseExtractor';
+/**
+ * Extracts variant information from Tailwind Variants files
+ * Supports tv() function calls and various variant configurations
+ */
+export class VariantsExtractor extends TypeScriptBaseExtractor {
+    config;
+    constructor(tsConfig) {
+        super(tsConfig);
+        const ext = tsConfig
+            ?.extraction?.variants;
+        this.config = {
+            frameworks: ['tailwind-variants'],
+            extractDefaults: true,
+            includeComputed: false,
+            customParsers: [],
+            ...ext
+        };
+    }
+    /**
+     * Extract variants from component variants file
+     */
+    async extract(input) {
+        const startTime = Date.now();
+        if (!this.validateInput(input)) {
+            return this.handleError(new Error('Invalid input for variants extraction'), input);
+        }
+        try {
+            console.log(`🎨 Extracting variants for ${input.componentName}`);
+            // Find variants file
+            const variantsFilePath = input.variantsFilePath || (await this.findVariantsFile(input));
+            if (!variantsFilePath) {
+                const warning = this.addWarning('no_variants_file', `No variants file found for ${input.componentName}`, `Create a ${input.componentName.toLowerCase()}.variants.ts file to define component variants`);
+                return this.createSuccessResult([], [warning], input.componentPath, Date.now() - startTime);
+            }
+            console.log(`✅ Found variants file: ${path.relative(process.cwd(), variantsFilePath)}`);
+            // Parse variants from file
+            const variants = await this.parseVariantsFile(variantsFilePath, input.componentName);
+            console.log(`🎨 Extracted ${variants.length} variant groups from ${input.componentName}`);
+            const duration = Date.now() - startTime;
+            return this.createSuccessResult(variants, [], variantsFilePath, duration);
+        }
+        catch (error) {
+            return this.handleError(error, input);
+        }
+    }
+    // ==========================================
+    // VARIANTS FILE DISCOVERY
+    // ==========================================
+    async findVariantsFile(input) {
+        const componentDir = path.dirname(input.componentPath);
+        const componentName = input.componentName;
+        const kebab = componentName.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();
+        const camel = componentName.charAt(0).toLowerCase() + componentName.slice(1);
+        // Try common patterns for variants files. Authors are inconsistent
+        // (some use lowercase, some camelCase, some kebab-case), so we
+        // probe each variant. Order is "most specific first".
+        const patterns = [
+            `${componentName.toLowerCase()}.variants.ts`,
+            `${componentName}.variants.ts`,
+            `${camel}.variants.ts`,
+            `${kebab}.variants.ts`,
+            'variants.ts',
+            `${componentName.toLowerCase()}.variants.js`,
+            `${componentName}.variants.js`,
+            `${camel}.variants.js`,
+            `${kebab}.variants.js`
+        ];
+        // Discovery probes many candidates in sequence; we don't want each
+        // missing path to log a warning. Check existence first via fs.access
+        // and only call getSourceFile for paths that actually exist.
+        for (const pattern of patterns) {
+            const filePath = path.join(componentDir, pattern);
+            try {
+                await fs.access(filePath);
+            }
+            catch {
+                continue;
+            }
+            try {
+                const sourceFile = await this.getSourceFile(filePath);
+                if (sourceFile) {
+                    return filePath;
+                }
+            }
+            catch {
+                // Continue to next pattern
+            }
+        }
+        return null;
+    }
+    // ==========================================
+    // VARIANTS FILE PARSING
+    // ==========================================
+    async parseVariantsFile(variantsFilePath, componentName) {
+        const sourceFile = await this.getSourceFile(variantsFilePath);
+        if (!sourceFile) {
+            throw new Error(`Could not load variants file: ${variantsFilePath}`);
+        }
+        // Find variants declaration
+        const variantsDeclaration = this.findVariantsDeclaration(sourceFile, componentName);
+        if (!variantsDeclaration) {
+            throw new Error(`No variants declaration found in ${variantsFilePath}`);
+        }
+        console.log(`🎯 Found variants declaration: ${variantsDeclaration.name?.getText()}`);
+        // Parse the variants based on framework
+        return this.parseVariantsDeclaration(variantsDeclaration, sourceFile);
+    }
+    findVariantsDeclaration(sourceFile, componentName) {
+        // camelCase covers the repo convention for multi-word components
+        // (`segmentGroupVariants`, `guidePanelVariants`); for single-word names it
+        // coincides with the lowercase candidate.
+        const camel = componentName.charAt(0).toLowerCase() + componentName.slice(1);
+        const possibleNames = [
+            `${componentName.toLowerCase()}Variants`,
+            `${camel}Variants`,
+            `${componentName}Variants`,
+            'variants'
+        ];
+        let foundDeclaration = null;
+        const visit = (node) => {
+            if (ts.isVariableDeclaration(node) && node.name && ts.isIdentifier(node.name)) {
+                const declarationName = node.name.text;
+                if (possibleNames.includes(declarationName)) {
+                    foundDeclaration = node;
+                    return;
+                }
+            }
+            ts.forEachChild(node, visit);
+        };
+        visit(sourceFile);
+        return foundDeclaration;
+    }
+    parseVariantsDeclaration(declaration, _sourceFile) {
+        if (!declaration.initializer) {
+            throw new Error('Variants declaration has no initializer');
+        }
+        // Check for supported frameworks
+        for (const framework of this.config.frameworks) {
+            switch (framework) {
+                case 'tailwind-variants': {
+                    const tvCall = this.findTailwindVariantsCall(declaration.initializer);
+                    if (tvCall) {
+                        return this.parseTailwindVariants(tvCall);
+                    }
+                    break;
+                }
+                // Add support for other frameworks here
+                case 'stitches':
+                    // TODO: Implement Stitches support
+                    break;
+                case 'vanilla-extract':
+                    // TODO: Implement Vanilla Extract support
+                    break;
+            }
+        }
+        throw new Error('Unsupported variants pattern - only Tailwind Variants (tv) is currently supported');
+    }
+    // ==========================================
+    // TAILWIND VARIANTS PARSING
+    // ==========================================
+    findTailwindVariantsCall(node) {
+        if (ts.isCallExpression(node)) {
+            if (ts.isIdentifier(node.expression) && node.expression.text === 'tv') {
+                return node;
+            }
+        }
+        let result = null;
+        ts.forEachChild(node, (child) => {
+            if (!result) {
+                result = this.findTailwindVariantsCall(child);
+            }
+        });
+        return result;
+    }
+    parseTailwindVariants(tvCall) {
+        const configObject = tvCall.arguments[0];
+        if (!configObject || !ts.isObjectLiteralExpression(configObject)) {
+            throw new Error('tv() first argument is not an object literal');
+        }
+        // Extract variants property
+        const variantsProperty = this.findPropertyInObject(configObject, 'variants');
+        if (!variantsProperty || !ts.isObjectLiteralExpression(variantsProperty)) {
+            throw new Error('No variants property found in tv() config');
+        }
+        // Extract default variants if present
+        const defaultVariants = this.findPropertyInObject(configObject, 'defaultVariants');
+        const defaults = defaultVariants ? this.extractDefaultVariants(defaultVariants) : {};
+        // Parse individual variant groups
+        return this.parseVariantGroups(variantsProperty, defaults);
+    }
+    findPropertyInObject(objectLiteral, propertyName) {
+        for (const property of objectLiteral.properties) {
+            if (ts.isPropertyAssignment(property)) {
+                const propName = this.getObjectPropertyName(property);
+                if (propName === propertyName) {
+                    return property.initializer;
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * Helper method to extract property names from object literal properties
+     */
+    getObjectPropertyName(property) {
+        return this.extractPropertyName(property.name);
+    }
+    /**
+     * Helper method to extract property names from PropertyName nodes
+     */
+    extractPropertyName(propertyName) {
+        if (ts.isIdentifier(propertyName)) {
+            return propertyName.text;
+        }
+        if (ts.isStringLiteral(propertyName)) {
+            return propertyName.text;
+        }
+        if (ts.isNumericLiteral(propertyName)) {
+            return propertyName.text;
+        }
+        if (ts.isComputedPropertyName(propertyName)) {
+            // For computed property names like [key], we can't easily determine the name
+            return null;
+        }
+        return null;
+    }
+    extractDefaultVariants(defaultVariantsNode) {
+        const defaults = {};
+        if (ts.isObjectLiteralExpression(defaultVariantsNode)) {
+            for (const property of defaultVariantsNode.properties) {
+                if (ts.isPropertyAssignment(property)) {
+                    const key = this.extractPropertyName(property.name);
+                    const value = this.extractLiteralValue(property.initializer);
+                    if (key && value) {
+                        defaults[key] = value;
+                    }
+                }
+            }
+        }
+        return defaults;
+    }
+    parseVariantGroups(variantsObject, defaults) {
+        const variants = [];
+        for (const property of variantsObject.properties) {
+            if (ts.isPropertyAssignment(property)) {
+                const variantName = this.extractPropertyName(property.name);
+                if (variantName && ts.isObjectLiteralExpression(property.initializer)) {
+                    const variantInfo = this.parseVariantGroup(variantName, property.initializer, defaults[variantName]);
+                    if (variantInfo) {
+                        variants.push(variantInfo);
+                        console.log(`   🎨 ${variantName}: [${variantInfo.values.join(', ')}]${variantInfo.defaultValue ? ` (default: ${variantInfo.defaultValue})` : ''}`);
+                    }
+                }
+            }
+        }
+        return variants;
+    }
+    parseVariantGroup(variantName, variantObject, defaultValue) {
+        const values = [];
+        const examples = [];
+        // Extract variant values from object keys
+        for (const property of variantObject.properties) {
+            if (ts.isPropertyAssignment(property)) {
+                const variantValue = this.extractPropertyName(property.name);
+                if (variantValue) {
+                    values.push(variantValue);
+                    // Extract example classes if available
+                    const classes = this.extractVariantClasses(property.initializer);
+                    if (classes) {
+                        examples.push({
+                            value: variantValue,
+                            label: variantValue,
+                            description: `${variantName} variant with value "${variantValue}"`,
+                            code: `<Component ${variantName}="${variantValue}" />`
+                        });
+                    }
+                }
+            }
+            else if (ts.isShorthandPropertyAssignment(property)) {
+                values.push(property.name.text);
+            }
+            else if (ts.isMethodDeclaration(property) && ts.isIdentifier(property.name)) {
+                values.push(property.name.text);
+            }
+        }
+        if (values.length === 0) {
+            return null;
+        }
+        // Sort values for consistency
+        values.sort();
+        const variantInfo = {
+            name: variantName,
+            values,
+            examples: examples.length > 0 ? examples : []
+        };
+        if (defaultValue) {
+            variantInfo.defaultValue = defaultValue;
+        }
+        return variantInfo;
+    }
+    extractVariantClasses(initializer) {
+        if (ts.isStringLiteral(initializer)) {
+            return initializer.text;
+        }
+        if (ts.isArrayLiteralExpression(initializer)) {
+            const classes = initializer.elements
+                .filter(ts.isStringLiteral)
+                .map((element) => element.text)
+                .join(' ');
+            return classes || null;
+        }
+        return null;
+    }
+    extractLiteralValue(node) {
+        if (ts.isStringLiteral(node)) {
+            return node.text;
+        }
+        if (ts.isNumericLiteral(node)) {
+            return node.text;
+        }
+        if (node.kind === ts.SyntaxKind.TrueKeyword) {
+            return 'true';
+        }
+        if (node.kind === ts.SyntaxKind.FalseKeyword) {
+            return 'false';
+        }
+        return null;
+    }
+    /**
+     * Clear any caches
+     */
+    clearCache() {
+        // No persistent cache in this implementation
+    }
+}
+//# sourceMappingURL=VariantsExtractor.js.map

package/dist/extractors/variants/VariantsExtractor.js.map

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

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

@@ -0,0 +1,2 @@
+export { VariantsExtractor } from './VariantsExtractor';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extractors/variants/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/extractors/variants/index.js

@@ -0,0 +1,2 @@
+export { VariantsExtractor } from './VariantsExtractor';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extractors/variants/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/generators/api/APIFileGenerator.d.ts

@@ -0,0 +1,32 @@
+import type { APIData, APIOutputConfig, GeneratedOutput } from '../../types';
+/**
+ * Generates the api-props.ts file that other phases can consume
+ * This is the critical output that enables the API-first architecture
+ */
+export declare class APIFileGenerator {
+    private config;
+    constructor(config: APIOutputConfig);
+    /**
+     * Generate API file from API data
+     */
+    generate(apiData: APIData): Promise<GeneratedOutput>;
+    private generateTypeScriptFile;
+    private generateComponentInterface;
+    private toSlug;
+    private generatePerComponentTypeScriptFile;
+    private generateJSONFile;
+    private generateYAMLFile;
+    /**
+     * Validate API data before generation
+     */
+    validateAPIData(apiData: APIData): void;
+    /**
+     * Generate backup of existing API file if it exists
+     */
+    createBackup(): Promise<void>;
+    /**
+     * Compare with existing API file and report changes
+     */
+    reportChanges(newAPIData: APIData): Promise<void>;
+}
+//# sourceMappingURL=APIFileGenerator.d.ts.map

package/dist/generators/api/APIFileGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"APIFileGenerator.d.ts","sourceRoot":"","sources":["../../../src/generators/api/APIFileGenerator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAoB,eAAe,EAAE,MAAM,aAAa,CAAC;AAE/F;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,EAAE,eAAe;IAInC;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IA4F1D,OAAO,CAAC,sBAAsB;IAyL9B,OAAO,CAAC,0BAA0B;IAgDlC,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,kCAAkC;IAqF1C,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,gBAAgB;IAkDxB;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAyBvC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAenC;;OAEG;IACG,aAAa,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAoBxD"}