@launch77/cli 1.2.0

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

@@ -0,0 +1,145 @@
+{
+  "$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"
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/dist/modules/catalog/services/catalog-generator-svc.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Service for generating catalog metadata files for component libraries
+ */
+import type { CatalogConfig, GenerationResult } from '../types/catalog-types.js';
+export declare class CatalogGeneratorService {
+    /**
+     * Generate catalog metadata for a component library
+     *
+     * @param libraryPath - Absolute path to the library directory
+     * @param config - Validated catalog configuration
+     * @returns Generation result with success status and quality report
+     */
+    generateForLibrary(libraryPath: string, config: CatalogConfig): Promise<GenerationResult>;
+    /**
+     * Filter components that passed validation
+     */
+    private filterValidComponents;
+    /**
+     * Categorize validations into errors and warnings
+     */
+    private categorizeValidations;
+    /**
+     * Read package.json from library directory
+     */
+    private readPackageJson;
+}
+//# sourceMappingURL=catalog-generator-svc.d.ts.map

package/dist/modules/catalog/services/catalog-generator-svc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-generator-svc.d.ts","sourceRoot":"","sources":["../../../../src/modules/catalog/services/catalog-generator-svc.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,KAAK,EAAE,aAAa,EAAsB,gBAAgB,EAAiC,MAAM,2BAA2B,CAAA;AAEnI,qBAAa,uBAAuB;IAClC;;;;;;OAMG;IACG,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuD/F;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAa7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAU7B;;OAEG;YACW,eAAe;CAe9B"}

package/dist/modules/catalog/services/catalog-generator-svc.js

@@ -0,0 +1,100 @@
+/**
+ * Service for generating catalog metadata files for component libraries
+ */
+import path from 'path';
+import fs from 'fs-extra';
+import { scanUILibrary } from '../scanners/ui-component-scanner.js';
+import { generateQualityReport } from '../utils/quality-reporter.js';
+export class CatalogGeneratorService {
+    /**
+     * Generate catalog metadata for a component library
+     *
+     * @param libraryPath - Absolute path to the library directory
+     * @param config - Validated catalog configuration
+     * @returns Generation result with success status and quality report
+     */
+    async generateForLibrary(libraryPath, config) {
+        try {
+            // 1. Scan library components
+            const scanResult = await scanUILibrary(libraryPath, config.packageName);
+            // 2. Validate components
+            const validatedComponents = this.filterValidComponents(scanResult.components, config);
+            // 3. Extract validation results
+            const { errors, warnings } = this.categorizeValidations(scanResult.validations);
+            // 4. Generate quality report
+            const qualityReport = generateQualityReport(scanResult.components.length, scanResult.excluded, scanResult.validations);
+            // 5. Check if generation should fail (strict mode with errors)
+            if (config.validation.strict && errors.length > 0) {
+                return {
+                    success: false,
+                    catalogFile: '',
+                    qualityReport,
+                    errors,
+                    warnings,
+                };
+            }
+            // 6. Read package version
+            const packageJson = await this.readPackageJson(libraryPath);
+            // 7. Create catalog
+            const catalog = {
+                $schema: 'https://launch77.io/schemas/catalog-ui-components.schema.json',
+                catalogType: 'ui-components',
+                catalogVersion: config.catalogVersion,
+                packageName: config.packageName,
+                packageVersion: packageJson.version,
+                generatedAt: new Date().toISOString(),
+                components: validatedComponents,
+            };
+            // 8. Write catalog file
+            const outputPath = path.join(libraryPath, config.outputFile);
+            await fs.writeJson(outputPath, catalog, { spaces: 2 });
+            return {
+                success: true,
+                catalogFile: outputPath,
+                qualityReport,
+                errors,
+                warnings,
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to generate catalog: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Filter components that passed validation
+     */
+    filterValidComponents(components, config) {
+        // In strict mode, only include components with valid metadata
+        if (config.validation.strict) {
+            return components.filter((component) => {
+                // Component is valid if it has required fields
+                return component.description && component.category;
+            });
+        }
+        // In non-strict mode, include all components
+        return components;
+    }
+    /**
+     * Categorize validations into errors and warnings
+     */
+    categorizeValidations(validations) {
+        const errors = validations.filter((v) => !v.valid && v.errors.length > 0);
+        const warnings = validations.filter((v) => v.warnings.length > 0);
+        return { errors, warnings };
+    }
+    /**
+     * Read package.json from library directory
+     */
+    async readPackageJson(libraryPath) {
+        const packageJsonPath = path.join(libraryPath, 'package.json');
+        if (!(await fs.pathExists(packageJsonPath))) {
+            throw new Error(`package.json not found in ${libraryPath}`);
+        }
+        const packageJson = await fs.readJson(packageJsonPath);
+        if (!packageJson.version) {
+            throw new Error(`package.json in ${libraryPath} does not have a version field`);
+        }
+        return packageJson;
+    }
+}
+//# sourceMappingURL=catalog-generator-svc.js.map

package/dist/modules/catalog/services/catalog-generator-svc.js.map

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

package/dist/modules/catalog/services/catalog-generator-svc.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=catalog-generator-svc.test.d.ts.map

package/dist/modules/catalog/services/catalog-generator-svc.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-generator-svc.test.d.ts","sourceRoot":"","sources":["../../../../src/modules/catalog/services/catalog-generator-svc.test.ts"],"names":[],"mappings":""}

package/dist/modules/catalog/services/catalog-generator-svc.test.js

@@ -0,0 +1,201 @@
+import path from 'path';
+import fs from 'fs-extra';
+import { describe, test, expect, beforeEach, afterEach } from 'vitest';
+import { CatalogGeneratorService } from './catalog-generator-svc.js';
+describe('CatalogGeneratorService', () => {
+    const service = new CatalogGeneratorService();
+    const testDir = path.join(process.cwd(), '.test-temp', 'catalog-generator');
+    beforeEach(async () => {
+        // Create test directory
+        await fs.ensureDir(testDir);
+    });
+    afterEach(async () => {
+        // Clean up test directory
+        await fs.remove(testDir);
+    });
+    describe('generateForLibrary', () => {
+        test('throws error if package.json not found', async () => {
+            const emptyDir = path.join(testDir, 'empty-lib');
+            await fs.ensureDir(emptyDir);
+            const config = {
+                type: 'ui-components',
+                packageName: '@test/lib',
+                sourceDir: './src',
+                componentsDir: './src/components',
+                exportsFile: './src/index.ts',
+                outputFile: 'catalog-ui-components.json',
+                catalogVersion: '0.1.0',
+                validation: {
+                    strict: true,
+                    requireCategory: true,
+                    requireDescription: true,
+                    minDescriptionLength: 20,
+                    requireWhenToUse: true,
+                    requireWhenNotToUse: true,
+                    minTags: 3,
+                },
+            };
+            await expect(service.generateForLibrary(emptyDir, config)).rejects.toThrow('package.json not found');
+        });
+        test('throws error if package.json has no version', async () => {
+            const libDir = path.join(testDir, 'no-version-lib');
+            await fs.ensureDir(libDir);
+            await fs.writeJson(path.join(libDir, 'package.json'), { name: '@test/lib' });
+            const config = {
+                type: 'ui-components',
+                packageName: '@test/lib',
+                sourceDir: './src',
+                componentsDir: './src/components',
+                exportsFile: './src/index.ts',
+                outputFile: 'catalog-ui-components.json',
+                catalogVersion: '0.1.0',
+                validation: {
+                    strict: true,
+                    requireCategory: true,
+                    requireDescription: true,
+                    minDescriptionLength: 20,
+                    requireWhenToUse: true,
+                    requireWhenNotToUse: true,
+                    minTags: 3,
+                },
+            };
+            await expect(service.generateForLibrary(libDir, config)).rejects.toThrow('does not have a version field');
+        });
+        test('generates empty catalog for library with no components', async () => {
+            const libDir = path.join(testDir, 'empty-components-lib');
+            await fs.ensureDir(path.join(libDir, 'src'));
+            await fs.writeJson(path.join(libDir, 'package.json'), {
+                name: '@test/lib',
+                version: '1.0.0',
+            });
+            await fs.writeFile(path.join(libDir, 'src', 'index.ts'), '// No exports');
+            const config = {
+                type: 'ui-components',
+                packageName: '@test/lib',
+                sourceDir: './src',
+                componentsDir: './src/components',
+                exportsFile: './src/index.ts',
+                outputFile: 'catalog-ui-components.json',
+                catalogVersion: '0.1.0',
+                validation: {
+                    strict: false, // Non-strict to allow empty catalog
+                    requireCategory: true,
+                    requireDescription: true,
+                    minDescriptionLength: 20,
+                    requireWhenToUse: true,
+                    requireWhenNotToUse: true,
+                    minTags: 3,
+                },
+            };
+            const result = await service.generateForLibrary(libDir, config);
+            expect(result.success).toBe(true);
+            expect(result.qualityReport.totalComponents).toBe(0);
+            expect(await fs.pathExists(path.join(libDir, 'catalog-ui-components.json'))).toBe(true);
+            const catalog = await fs.readJson(path.join(libDir, 'catalog-ui-components.json'));
+            expect(catalog.catalogType).toBe('ui-components');
+            expect(catalog.catalogVersion).toBe('0.1.0');
+            expect(catalog.packageName).toBe('@test/lib');
+            expect(catalog.packageVersion).toBe('1.0.0');
+            expect(catalog.components).toEqual([]);
+            expect(catalog.generatedAt).toBeTruthy();
+        });
+        test('writes catalog to configured output file', async () => {
+            const libDir = path.join(testDir, 'custom-output-lib');
+            await fs.ensureDir(path.join(libDir, 'src'));
+            await fs.writeJson(path.join(libDir, 'package.json'), {
+                name: '@test/lib',
+                version: '2.0.0',
+            });
+            await fs.writeFile(path.join(libDir, 'src', 'index.ts'), '// No exports');
+            const config = {
+                type: 'ui-components',
+                packageName: '@test/lib',
+                sourceDir: './src',
+                componentsDir: './src/components',
+                exportsFile: './src/index.ts',
+                outputFile: 'custom-catalog.json', // Custom output file
+                catalogVersion: '1.2.3',
+                validation: {
+                    strict: false,
+                    requireCategory: true,
+                    requireDescription: true,
+                    minDescriptionLength: 20,
+                    requireWhenToUse: true,
+                    requireWhenNotToUse: true,
+                    minTags: 3,
+                },
+            };
+            const result = await service.generateForLibrary(libDir, config);
+            expect(result.success).toBe(true);
+            expect(result.catalogFile).toBe(path.join(libDir, 'custom-catalog.json'));
+            expect(await fs.pathExists(path.join(libDir, 'custom-catalog.json'))).toBe(true);
+            const catalog = await fs.readJson(path.join(libDir, 'custom-catalog.json'));
+            expect(catalog.catalogVersion).toBe('1.2.3');
+            expect(catalog.packageVersion).toBe('2.0.0');
+        });
+        test('catalog includes correct metadata structure', async () => {
+            const libDir = path.join(testDir, 'metadata-lib');
+            await fs.ensureDir(path.join(libDir, 'src'));
+            await fs.writeJson(path.join(libDir, 'package.json'), {
+                name: '@test/meta-lib',
+                version: '3.1.4',
+            });
+            await fs.writeFile(path.join(libDir, 'src', 'index.ts'), '');
+            const config = {
+                type: 'ui-components',
+                packageName: '@test/meta-lib',
+                sourceDir: './src',
+                componentsDir: './src/components',
+                exportsFile: './src/index.ts',
+                outputFile: 'catalog-ui-components.json',
+                catalogVersion: '2.0.0',
+                validation: {
+                    strict: false,
+                    requireCategory: true,
+                    requireDescription: true,
+                    minDescriptionLength: 20,
+                    requireWhenToUse: true,
+                    requireWhenNotToUse: true,
+                    minTags: 3,
+                },
+            };
+            const result = await service.generateForLibrary(libDir, config);
+            expect(result.success).toBe(true);
+            const catalog = await fs.readJson(path.join(libDir, 'catalog-ui-components.json'));
+            // Verify required fields
+            expect(catalog).toHaveProperty('catalogType', 'ui-components');
+            expect(catalog).toHaveProperty('catalogVersion', '2.0.0');
+            expect(catalog).toHaveProperty('packageName', '@test/meta-lib');
+            expect(catalog).toHaveProperty('packageVersion', '3.1.4');
+            expect(catalog).toHaveProperty('generatedAt');
+            expect(catalog).toHaveProperty('components');
+            // Verify generatedAt is valid ISO date
+            expect(() => new Date(catalog.generatedAt)).not.toThrow();
+        });
+    });
+    describe('error handling', () => {
+        test('provides helpful error message on failure', async () => {
+            const nonExistentDir = path.join(testDir, 'does-not-exist');
+            const config = {
+                type: 'ui-components',
+                packageName: '@test/lib',
+                sourceDir: './src',
+                componentsDir: './src/components',
+                exportsFile: './src/index.ts',
+                outputFile: 'catalog-ui-components.json',
+                catalogVersion: '0.1.0',
+                validation: {
+                    strict: true,
+                    requireCategory: true,
+                    requireDescription: true,
+                    minDescriptionLength: 20,
+                    requireWhenToUse: true,
+                    requireWhenNotToUse: true,
+                    minTags: 3,
+                },
+            };
+            await expect(service.generateForLibrary(nonExistentDir, config)).rejects.toThrow('Failed to generate catalog');
+        });
+    });
+});
+//# sourceMappingURL=catalog-generator-svc.test.js.map

package/dist/modules/catalog/services/catalog-generator-svc.test.js.map

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

package/dist/modules/catalog/services/catalog-svc.d.ts

@@ -0,0 +1,39 @@
+import type { MonorepoContext } from '../../../utils/monorepo.js';
+export interface ScanCatalogOptions {
+    strict?: boolean;
+    quiet?: boolean;
+}
+export interface ScanCatalogResult {
+    catalogPath: string;
+    version: string;
+    totalArtifacts: number;
+}
+/**
+ * Catalog Service
+ *
+ * Scans Launch77 artifacts and generates catalog.json
+ */
+export declare class CatalogService {
+    /**
+     * Scan Launch77 codebase and generate catalog.json
+     */
+    scanCatalog(context: MonorepoContext, options?: ScanCatalogOptions): Promise<ScanCatalogResult>;
+    /**
+     * Scan all UI components from @launch77/ui and @launch/marketing-ui
+     */
+    private scanAllUIComponents;
+    /**
+     * Check if catalog content has changed (excluding version field)
+     */
+    private catalogHasChanges;
+    /**
+     * Get current version from existing catalog
+     */
+    private getCurrentVersion;
+    /**
+     * Get the next version by incrementing the patch version of existing catalog
+     * If no catalog exists, start at 1.0.0
+     */
+    private getNextVersion;
+}
+//# sourceMappingURL=catalog-svc.d.ts.map

package/dist/modules/catalog/services/catalog-svc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-svc.d.ts","sourceRoot":"","sources":["../../../../src/modules/catalog/services/catalog-svc.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAGjE,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;CACvB;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACzB;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA+FzG;;OAEG;YACW,mBAAmB;IA0BjC;;OAEG;YACW,iBAAiB;IAwB/B;;OAEG;YACW,iBAAiB;IAa/B;;;OAGG;YACW,cAAc;CAgB7B"}