@launch77/cli 1.2.0

package/dist/modules/catalog/parsers/typescript-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-parser.d.ts","sourceRoot":"","sources":["../../../../src/modules/catalog/parsers/typescript-parser.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA2BtE;AAuCD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQzE"}

package/dist/modules/catalog/parsers/typescript-parser.js

@@ -0,0 +1,82 @@
+import * as path from 'path';
+import fs from 'fs-extra';
+import * as ts from 'typescript';
+/**
+ * Extract prop names from a React component TypeScript file
+ * Looks for Props interfaces/types and exports
+ */
+export async function extractProps(filePath) {
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        const sourceFile = ts.createSourceFile(path.basename(filePath), content, ts.ScriptTarget.Latest, true);
+        const props = new Set();
+        // Visit all nodes in the AST
+        const visitor = (node) => {
+            // Look for type/interface definitions with "Props" in the name
+            if (ts.isInterfaceDeclaration(node) || ts.isTypeAliasDeclaration(node)) {
+                const name = node.name.text;
+                if (name.includes('Props')) {
+                    extractPropsFromType(node, props);
+                }
+            }
+            ts.forEachChild(node, visitor);
+        };
+        visitor(sourceFile);
+        return Array.from(props);
+    }
+    catch (error) {
+        // If parsing fails, return empty array
+        return [];
+    }
+}
+function extractPropsFromType(node, props) {
+    if (ts.isInterfaceDeclaration(node)) {
+        // Extract from interface members
+        node.members.forEach((member) => {
+            if (ts.isPropertySignature(member) && member.name && ts.isIdentifier(member.name)) {
+                props.add(member.name.text);
+            }
+        });
+    }
+    else if (ts.isTypeAliasDeclaration(node)) {
+        // Extract from type alias
+        const typeNode = node.type;
+        if (ts.isIntersectionTypeNode(typeNode)) {
+            // Handle intersection types (e.g., A & B & C)
+            typeNode.types.forEach((type) => {
+                if (ts.isTypeLiteralNode(type)) {
+                    type.members.forEach((member) => {
+                        if (ts.isPropertySignature(member) && member.name && ts.isIdentifier(member.name)) {
+                            props.add(member.name.text);
+                        }
+                    });
+                }
+            });
+        }
+        else if (ts.isTypeLiteralNode(typeNode)) {
+            // Handle type literal (e.g., { prop1: string })
+            typeNode.members.forEach((member) => {
+                if (ts.isPropertySignature(member) && member.name && ts.isIdentifier(member.name)) {
+                    props.add(member.name.text);
+                }
+            });
+        }
+    }
+    // Add common HTML attributes that are usually inherited
+    const commonProps = ['className', 'style', 'children', 'onClick', 'onChange'];
+    commonProps.forEach((prop) => props.add(prop));
+}
+/**
+ * Detect if a file is a React component
+ */
+export async function isReactComponent(filePath) {
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        // Simple heuristic: contains React import and JSX/TSX
+        return content.includes('import') && (content.includes('React') || content.includes("from 'react'")) && (filePath.endsWith('.tsx') || filePath.endsWith('.jsx'));
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=typescript-parser.js.map

package/dist/modules/catalog/parsers/typescript-parser.js.map

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

package/dist/modules/catalog/scanners/metadata-extractor.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Extract Launch77 metadata from JSDoc comments in source files
+ */
+import type { ComponentMetadata } from '../types/catalog-types.js';
+/**
+ * Extract metadata from a component source file
+ * Looks for @launch77-component JSDoc tag and extracts metadata fields
+ */
+export declare function extractComponentMetadata(filePath: string): Promise<ComponentMetadata>;
+//# sourceMappingURL=metadata-extractor.d.ts.map

package/dist/modules/catalog/scanners/metadata-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-extractor.d.ts","sourceRoot":"","sources":["../../../../src/modules/catalog/scanners/metadata-extractor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAElE;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAuE3F"}

package/dist/modules/catalog/scanners/metadata-extractor.js

@@ -0,0 +1,122 @@
+/**
+ * Extract Launch77 metadata from JSDoc comments in source files
+ */
+import fs from 'fs-extra';
+/**
+ * Extract metadata from a component source file
+ * Looks for @launch77-component JSDoc tag and extracts metadata fields
+ */
+export async function extractComponentMetadata(filePath) {
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        // Check for @launch77-ignore tag first
+        const ignoreRegex = /\/\*\*[\s\S]*?@launch77-ignore[\s\S]*?\*\//;
+        const ignoreMatch = content.match(ignoreRegex);
+        if (ignoreMatch) {
+            const reason = extractField(ignoreMatch[0], 'reason');
+            return {
+                description: '',
+                category: '',
+                whenToUse: '',
+                whenNotToUse: '',
+                tags: [],
+                example: '',
+                ignored: true,
+                ignoreReason: reason || 'Excluded from catalog',
+            };
+        }
+        // Look for JSDoc comment with @launch77-component marker
+        const jsdocRegex = /\/\*\*[\s\S]*?@launch77-component[\s\S]*?\*\//;
+        const match = content.match(jsdocRegex);
+        if (!match) {
+            // No Launch77 metadata found - return empty
+            return {
+                description: '',
+                category: '',
+                whenToUse: '',
+                whenNotToUse: '',
+                tags: [],
+                example: '',
+                ignored: false,
+            };
+        }
+        const jsdoc = match[0];
+        // Extract individual fields
+        const description = extractField(jsdoc, 'description');
+        const category = extractField(jsdoc, 'category');
+        const whenToUse = extractField(jsdoc, 'whenToUse');
+        const whenNotToUse = extractField(jsdoc, 'whenNotToUse');
+        const tags = extractTags(jsdoc);
+        const example = extractExample(jsdoc);
+        return {
+            description,
+            category,
+            whenToUse,
+            whenNotToUse,
+            tags,
+            example,
+            ignored: false,
+        };
+    }
+    catch (error) {
+        // If we can't read the file or parse fails, return empty metadata
+        // This ensures the scan doesn't fail if metadata is missing
+        return {
+            description: '',
+            category: '',
+            whenToUse: '',
+            whenNotToUse: '',
+            tags: [],
+            example: '',
+            ignored: false,
+        };
+    }
+}
+/**
+ * Extract a single-line field from JSDoc
+ * Format: @fieldName value here until end of line
+ */
+function extractField(jsdoc, fieldName) {
+    const regex = new RegExp(`@${fieldName}\\s+(.+?)(?=\\n|\\*\\/|@)`, 's');
+    const match = jsdoc.match(regex);
+    if (!match)
+        return '';
+    // Clean up the value: remove extra whitespace, asterisks from line breaks
+    return match[1]
+        .split('\n')
+        .map((line) => line.replace(/^\s*\*\s?/, '').trim())
+        .filter((line) => line.length > 0)
+        .join(' ')
+        .trim();
+}
+/**
+ * Extract tags (comma or space separated)
+ * Format: @tags tag1, tag2, tag3
+ */
+function extractTags(jsdoc) {
+    const tagsString = extractField(jsdoc, 'tags');
+    if (!tagsString)
+        return [];
+    // Split by comma or whitespace, clean up
+    return tagsString
+        .split(/[,\s]+/)
+        .map((tag) => tag.trim())
+        .filter((tag) => tag.length > 0);
+}
+/**
+ * Extract example code block
+ * Format: @example followed by code until next @ tag or end of comment
+ */
+function extractExample(jsdoc) {
+    const regex = /@example\s+([\s\S]+?)(?=@|\*\/)/;
+    const match = jsdoc.match(regex);
+    if (!match)
+        return '';
+    // Clean up the example: remove leading asterisks and extra whitespace
+    return match[1]
+        .split('\n')
+        .map((line) => line.replace(/^\s*\*\s?/, ''))
+        .join('\n')
+        .trim();
+}
+//# sourceMappingURL=metadata-extractor.js.map

package/dist/modules/catalog/scanners/metadata-extractor.js.map

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

package/dist/modules/catalog/scanners/metadata-validator.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Validate Launch77 component metadata for quality and completeness
+ */
+import type { ComponentMetadata, ValidationResult } from '../types/catalog-types.js';
+export declare function validateMetadata(metadata: ComponentMetadata, componentName: string, filePath: string): ValidationResult;
+//# sourceMappingURL=metadata-validator.d.ts.map

package/dist/modules/catalog/scanners/metadata-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-validator.d.ts","sourceRoot":"","sources":["../../../../src/modules/catalog/scanners/metadata-validator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAQpF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAsDvH"}

package/dist/modules/catalog/scanners/metadata-validator.js

@@ -0,0 +1,57 @@
+/**
+ * Validate Launch77 component metadata for quality and completeness
+ */
+/**
+ * Validate component metadata against Launch77 quality standards
+ */
+// Valid category values for UI components
+const VALID_CATEGORIES = ['actions', 'forms', 'feedback', 'layout', 'marketing', 'typography', 'infrastructure', 'compliance'];
+export function validateMetadata(metadata, componentName, filePath) {
+    const errors = [];
+    const warnings = [];
+    // REQUIRED: @launch77-component tag (indicated by non-empty description)
+    if (!metadata.description) {
+        errors.push('Missing @launch77-component tag');
+    }
+    // REQUIRED: @category tag
+    if (!metadata.category) {
+        errors.push('Missing @category tag (required)');
+    }
+    else if (!VALID_CATEGORIES.includes(metadata.category)) {
+        errors.push(`Invalid category "${metadata.category}". Must be one of: ${VALID_CATEGORIES.join(', ')}`);
+    }
+    // Check description quality
+    if (metadata.description && metadata.description.length < 20) {
+        warnings.push('Description is too short (< 20 characters)');
+    }
+    // Check for generic descriptions
+    if (metadata.description && /^[A-Z][a-z]+ component$/.test(metadata.description)) {
+        warnings.push(`Generic description detected: "${metadata.description}"`);
+    }
+    // RECOMMENDED: Guidance fields
+    if (!metadata.whenToUse) {
+        warnings.push('Missing @whenToUse guidance');
+    }
+    if (!metadata.whenNotToUse) {
+        warnings.push('Missing @whenNotToUse guidance');
+    }
+    // RECOMMENDED: Tags
+    if (metadata.tags.length === 0) {
+        warnings.push('Missing @tags');
+    }
+    else if (metadata.tags.length < 3) {
+        warnings.push('Too few tags (< 3 recommended)');
+    }
+    // RECOMMENDED: Example code
+    if (!metadata.example) {
+        warnings.push('Missing @example code');
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+        componentName,
+        filePath,
+    };
+}
+//# sourceMappingURL=metadata-validator.js.map

package/dist/modules/catalog/scanners/metadata-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-validator.js","sourceRoot":"","sources":["../../../../src/modules/catalog/scanners/metadata-validator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,0CAA0C;AAC1C,MAAM,gBAAgB,GAAsB,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,CAAC,CAAA;AAEjJ,MAAM,UAAU,gBAAgB,CAAC,QAA2B,EAAE,aAAqB,EAAE,QAAgB;IACnG,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,MAAM,QAAQ,GAAa,EAAE,CAAA;IAE7B,yEAAyE;IACzE,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAA;IAChD,CAAC;IAED,0BAA0B;IAC1B,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAA;IACjD,CAAC;SAAM,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC,qBAAqB,QAAQ,CAAC,QAAQ,sBAAsB,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACxG,CAAC;IAED,4BAA4B;IAC5B,IAAI,QAAQ,CAAC,WAAW,IAAI,QAAQ,CAAC,WAAW,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QAC7D,QAAQ,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAA;IAC7D,CAAC;IAED,iCAAiC;IACjC,IAAI,QAAQ,CAAC,WAAW,IAAI,yBAAyB,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACjF,QAAQ,CAAC,IAAI,CAAC,kCAAkC,QAAQ,CAAC,WAAW,GAAG,CAAC,CAAA;IAC1E,CAAC;IAED,+BAA+B;IAC/B,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QACxB,QAAQ,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAA;IAC9C,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;QAC3B,QAAQ,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;IACjD,CAAC;IAED,oBAAoB;IACpB,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;IAChC,CAAC;SAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,QAAQ,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;IACjD,CAAC;IAED,4BAA4B;IAC5B,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAA;IACxC,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;QACN,QAAQ;QACR,aAAa;QACb,QAAQ;KACT,CAAA;AACH,CAAC"}

package/dist/modules/catalog/scanners/ui-component-scanner.d.ts

@@ -0,0 +1,11 @@
+import type { UiComponent, ValidationResult } from '../types/catalog-types.js';
+export interface ScanResult {
+    components: UiComponent[];
+    validations: ValidationResult[];
+    excluded: number;
+}
+/**
+ * Scan a UI library package for components
+ */
+export declare function scanUILibrary(libraryPath: string, packageName: string): Promise<ScanResult>;
+//# sourceMappingURL=ui-component-scanner.d.ts.map

package/dist/modules/catalog/scanners/ui-component-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-component-scanner.d.ts","sourceRoot":"","sources":["../../../../src/modules/catalog/scanners/ui-component-scanner.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAE9E,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,WAAW,EAAE,CAAA;IACzB,WAAW,EAAE,gBAAgB,EAAE,CAAA;IAC/B,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA8DjG"}

package/dist/modules/catalog/scanners/ui-component-scanner.js

@@ -0,0 +1,147 @@
+import * as path from 'path';
+import fs from 'fs-extra';
+import { extractComponentMetadata } from './metadata-extractor.js';
+import { validateMetadata } from './metadata-validator.js';
+import { extractProps, isReactComponent } from '../parsers/typescript-parser.js';
+import { validateComponentName } from '../validators/component-name-validator.js';
+/**
+ * Scan a UI library package for components
+ */
+export async function scanUILibrary(libraryPath, packageName) {
+    const components = [];
+    const validations = [];
+    let excluded = 0;
+    // Read the main index file to find exports
+    const indexPath = path.join(libraryPath, 'src/index.ts');
+    if (!(await fs.pathExists(indexPath))) {
+        return { components, validations, excluded };
+    }
+    const indexContent = await fs.readFile(indexPath, 'utf-8');
+    // Parse exports: export * from './components/Button'
+    const exportRegex = /export\s+\*\s+from\s+['"](\.\/[^'"]+)['"]/g;
+    const exports = [];
+    let match;
+    while ((match = exportRegex.exec(indexContent)) !== null) {
+        exports.push(match[1]);
+    }
+    // Also parse: export { Button } from './components/Button'
+    const namedExportRegex = /export\s+\{([^}]+)\}\s+from\s+['"](\.\/[^'"]+)['"]/g;
+    while ((match = namedExportRegex.exec(indexContent)) !== null) {
+        exports.push(match[2]);
+    }
+    // Scan each export path
+    for (const exportPath of exports) {
+        const fullPath = path.join(libraryPath, 'src', exportPath.replace('./', ''));
+        // Check if it's a directory with index.ts or a .tsx file
+        let componentFile;
+        if (await fs.pathExists(fullPath + '.tsx')) {
+            componentFile = fullPath + '.tsx';
+        }
+        else if (await fs.pathExists(fullPath + '.ts')) {
+            componentFile = fullPath + '.ts';
+        }
+        else if (await fs.pathExists(path.join(fullPath, 'index.ts'))) {
+            // It's a directory, find the main component file
+            const files = await fs.readdir(fullPath);
+            const mainFile = files.find((f) => f.endsWith('.tsx') && !f.includes('.test.') && !f.includes('.stories.') && !f.includes('.examples.'));
+            if (mainFile) {
+                componentFile = path.join(fullPath, mainFile);
+            }
+        }
+        if (componentFile && (await isReactComponent(componentFile))) {
+            const result = await scanComponent(componentFile, packageName, libraryPath);
+            if (result) {
+                if (result.excluded) {
+                    excluded++;
+                }
+                else {
+                    components.push(result.component);
+                    validations.push(result.validation);
+                }
+            }
+        }
+    }
+    return { components, validations, excluded };
+}
+async function scanComponent(filePath, packageName, libraryRoot) {
+    try {
+        // Extract component name from filename
+        const fileName = path.basename(filePath, path.extname(filePath));
+        const componentName = fileName;
+        // Validate component name
+        const nameValidation = validateComponentName(componentName);
+        if (!nameValidation.valid) {
+            console.warn(`Skipping ${filePath}: Invalid component name - ${nameValidation.errors.join(', ')}`);
+            return null;
+        }
+        // Calculate source path relative to repo root for validation
+        const sourcePath = path.relative(path.join(libraryRoot, '../../..'), filePath);
+        // Extract metadata from JSDoc (Launch77-specific)
+        const metadata = await extractComponentMetadata(filePath);
+        // Check if component is excluded via @launch77-ignore
+        if (metadata.ignored) {
+            // Return excluded marker - no validation needed for ignored components
+            return {
+                component: {}, // Won't be used, but satisfies type
+                validation: { valid: true, errors: [], warnings: [], componentName: '', filePath: '' },
+                excluded: true,
+            };
+        }
+        // Validate metadata (all non-ignored components must have @launch77-component and @category)
+        const validation = validateMetadata(metadata, componentName, sourcePath);
+        // Use category from metadata - validation ensures it exists and is valid
+        const category = metadata.category;
+        // Extract props
+        const props = await extractProps(filePath);
+        // Use metadata description - validation ensures it exists
+        const description = metadata.description;
+        // Generate ID
+        const id = `${packageName}#${componentName}`;
+        // Use explicit tags from metadata only (no auto-generation)
+        const tags = metadata.tags;
+        // Build guidance object if we have both fields
+        const guidance = metadata.whenToUse && metadata.whenNotToUse
+            ? {
+                whenToUse: metadata.whenToUse,
+                whenNotToUse: metadata.whenNotToUse,
+            }
+            : undefined;
+        // Check for examples file
+        let examples;
+        const examplesPath = filePath.replace(/\.tsx?$/, '.examples.tsx');
+        if (await fs.pathExists(examplesPath)) {
+            // Calculate examples source path relative to repo root
+            const examplesSourcePath = path.relative(path.join(libraryRoot, '../../..'), examplesPath);
+            examples = {
+                module: `${packageName}/examples`,
+                export: `${componentName}Examples`,
+                sourcePath: examplesSourcePath,
+            };
+        }
+        const component = {
+            id,
+            kind: 'ui_component',
+            name: componentName,
+            packageName,
+            category,
+            description,
+            tags,
+            props: props.length > 0 ? props : undefined,
+            sourcePath,
+            library: packageName, // Link component to its library
+            guidance,
+            example: metadata.example || undefined,
+            examples,
+        };
+        return {
+            component,
+            validation,
+            excluded: false,
+        };
+    }
+    catch (error) {
+        console.error(`Error scanning component ${filePath}:`, error);
+        return null;
+    }
+}
+//# sourceMappingURL=ui-component-scanner.js.map

package/dist/modules/catalog/scanners/ui-component-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-component-scanner.js","sourceRoot":"","sources":["../../../../src/modules/catalog/scanners/ui-component-scanner.ts"],"names":[],"mappings":"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"}

package/dist/modules/catalog/schemas/catalog-ui-components.schema.json

@@ -0,0 +1,161 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://launch77.io/schemas/catalog-ui-components.schema.json",
+  "title": "Launch77 UI Components Catalog",
+  "description": "Catalog metadata for UI component libraries. Generated during library build and consumed by Launch77 platform for component discovery.",
+  "type": "object",
+  "required": [
+    "catalogType",
+    "catalogVersion",
+    "packageName",
+    "packageVersion",
+    "generatedAt",
+    "components"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "catalogType": {
+      "type": "string",
+      "const": "ui-components",
+      "description": "Type of catalog - identifies this as a UI components catalog"
+    },
+    "catalogVersion": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Semantic version of the catalog schema (e.g., 0.1.0)"
+    },
+    "packageName": {
+      "type": "string",
+      "pattern": "^@[a-z0-9-]+/[a-z0-9-]+$",
+      "description": "NPM package name (e.g., @launch77/ui)"
+    },
+    "packageVersion": {
+      "type": "string",
+      "description": "Version of the package containing these components"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp when catalog was generated"
+    },
+    "components": {
+      "type": "array",
+      "description": "Array of UI component metadata",
+      "items": {
+        "$ref": "#/definitions/UiComponent"
+      }
+    }
+  },
+  "definitions": {
+    "UiComponent": {
+      "type": "object",
+      "description": "Metadata for a single UI component",
+      "required": ["id", "kind", "name", "packageName", "category", "description", "tags"],
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^@[a-z0-9-]+/[a-z0-9-]+#[A-Z][a-zA-Z0-9]*$",
+          "description": "Unique identifier: packageName#ComponentName (e.g., @launch77/ui#Button)"
+        },
+        "kind": {
+          "type": "string",
+          "const": "ui_component",
+          "description": "Component kind - always 'ui_component' for UI components"
+        },
+        "name": {
+          "type": "string",
+          "pattern": "^[A-Z][a-zA-Z0-9]*$",
+          "description": "Component name in PascalCase (e.g., Button, AlertDialog)"
+        },
+        "packageName": {
+          "type": "string",
+          "pattern": "^@[a-z0-9-]+/[a-z0-9-]+$",
+          "description": "NPM package containing this component"
+        },
+        "category": {
+          "type": "string",
+          "enum": [
+            "actions",
+            "forms",
+            "feedback",
+            "layout",
+            "marketing",
+            "typography",
+            "infrastructure",
+            "compliance"
+          ],
+          "description": "Component category for organization and discovery"
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Human-readable description of the component"
+        },
+        "tags": {
+          "type": "array",
+          "description": "Search tags for component discovery",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "minItems": 1
+        },
+        "props": {
+          "type": "array",
+          "description": "Component props (optional - extracted from TypeScript)",
+          "items": {
+            "type": "string"
+          }
+        },
+        "sourcePath": {
+          "type": "string",
+          "description": "Relative path to component source file from repository root (optional)"
+        },
+        "library": {
+          "type": "string",
+          "description": "Parent library package name (optional - typically same as packageName)"
+        },
+        "guidance": {
+          "type": "object",
+          "description": "Usage guidance for the component (optional)",
+          "additionalProperties": false,
+          "properties": {
+            "whenToUse": {
+              "type": "string",
+              "description": "When to use this component"
+            },
+            "whenNotToUse": {
+              "type": "string",
+              "description": "When NOT to use this component (anti-patterns)"
+            }
+          }
+        },
+        "example": {
+          "type": "string",
+          "description": "Code example showing component usage (optional)"
+        },
+        "examples": {
+          "type": "object",
+          "description": "Reference to examples module (optional)",
+          "required": ["module", "export", "sourcePath"],
+          "additionalProperties": false,
+          "properties": {
+            "module": {
+              "type": "string",
+              "description": "Module path to import examples (e.g., @launch77/ui/examples)"
+            },
+            "export": {
+              "type": "string",
+              "description": "Export name for examples (e.g., ButtonExamples)"
+            },
+            "sourcePath": {
+              "type": "string",
+              "description": "Relative path to examples source file from repository root"
+            }
+          }
+        }
+      }
+    }
+  }
+}