@urbicon-ui/docs-gen 6.1.4

package/README.md

@@ -0,0 +1,92 @@
+# @urbicon-ui/docs-gen
+
+Documentation generator for UI component libraries. Extracts props, variants, and inheritance from TypeScript/Svelte components and generates API data files and LLM-friendly documentation.
+
+## Usage
+
+### From workspace root
+
+```bash
+# Generate docs for all packages (blocks, docs, table)
+bun run docs:gen:all
+
+# Generate for a specific package
+bun run docs:gen:blocks
+bun run docs:gen:docs
+bun run docs:gen:table
+```
+
+### From this package
+
+```bash
+bun run docs:gen           # Generate all targets
+```
+
+### CLI
+
+```
+docs-gen [command] [options]
+
+Commands:
+  generate, build    Generate documentation (default)
+  help              Show help
+
+Options:
+  --target <type>   Target: 'blocks', 'docs', 'table', or 'all' (default: 'all')
+```
+
+## Architecture
+
+The pipeline follows a strict sequence: **Discovery → Extraction → Enrichment → Generation**.
+
+```
+Phase 1: Discovery      → Find components via glob patterns (ComponentFinder)
+Phase 2: Extraction     → Extract props, variants, inheritance from TypeScript
+Phase 3: Enrichment     → Resolve cross-refs, calculate stats, produce APIData
+Phase 4: Generation     → Write API file first, then LLM docs
+```
+
+Discovery yields one component per `index.ts` (named after its directory). A
+multi-component `index.ts` can opt additional exports into their own catalog
+entries via an `@standalone` JSDoc tag on the export's `<Name>Props` interface
+(plus a matching `export { default as Name } from './Name.svelte'`) — used by
+the Guide surfaces. Exports without the tag are treated as compound
+subcomponents and stay folded into the directory component's entry.
+
+### Key modules
+
+| Path | Purpose |
+|------|---------|
+| `src/core/pipeline/PipelineOrchestrator.ts` | Main pipeline coordinator |
+| `src/core/discovery/ComponentFinder.ts` | Component discovery |
+| `src/core/extraction/ExtractionCoordinator.ts` | Orchestrates extractors |
+| `src/core/enrichment/APIDataGenerator.ts` | API data generation |
+| `src/core/generation/GenerationCoordinator.ts` | Output coordination |
+| `src/generators/api/APIFileGenerator.ts` | Per-component `api.ts` files |
+| `src/generators/llm/LLMDocumentationGenerator.ts` | LLM text output |
+
+## Configuration
+
+Configuration is built via `DocsConfigurationBuilder` and `ConfigurationFactory`. Presets:
+
+- `ConfigurationFactory.blocks()` — `@urbicon-ui/blocks`
+- `ConfigurationFactory.docs()` — `@urbicon-ui/docs`
+- `ConfigurationFactory.table()` — `@urbicon-ui/table`
+
+### Output paths
+
+| Target | API output | LLM output |
+|--------|-----------|------------|
+| blocks | `apps/docs/src/routes/blocks/` | `apps/docs/static/blocks/` |
+| docs | `apps/docs/src/routes/docs/` | `apps/docs/static/docs/` |
+| table | `apps/docs/src/routes/table/` | `apps/docs/static/table/` |
+
+## Scripts
+
+| Script | Description |
+|--------|-------------|
+| `bun run docs:gen` | Generate documentation |
+| `bun run test` | Run Vitest |
+| `bun run test:watch` | Watch mode tests |
+| `bun run build` | Build TypeScript |
+| `bun run typecheck` | Type check only |

package/dist/cli/CLI.d.ts

@@ -0,0 +1,10 @@
+export declare class DocsGeneratorCLI {
+    run(args?: string[]): Promise<void>;
+    private generateCommand;
+    private generateTarget;
+    private assembleLlmsFull;
+    private scaffoldCommand;
+    private parseOptions;
+    private showHelp;
+}
+//# sourceMappingURL=CLI.d.ts.map

package/dist/cli/CLI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CLI.d.ts","sourceRoot":"","sources":["../../src/cli/CLI.ts"],"names":[],"mappings":"AAaA,qBAAa,gBAAgB;IACrB,GAAG,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;YA8BlD,eAAe;YAwBf,cAAc;YAyCd,gBAAgB;YAiDhB,eAAe;IA6L7B,OAAO,CAAC,YAAY;IAsBpB,OAAO,CAAC,QAAQ;CAuBjB"}

package/dist/cli/CLI.js

@@ -0,0 +1,340 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { LlmsFullAssembler } from '../generators/llm/LlmsFullAssembler';
+import { MCPCatalogAssembler } from '../generators/mcp/MCPCatalogAssembler';
+import { ConfigurationFactory } from '../schema/ConfigurationBuilder';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+function resolveFromDocsGen(...segments) {
+    return path.resolve(__dirname, '..', '..', ...segments);
+}
+export class DocsGeneratorCLI {
+    async run(args = process.argv.slice(2)) {
+        const command = args[0] || 'generate';
+        const options = this.parseOptions(args.slice(1));
+        try {
+            switch (command) {
+                case 'generate':
+                case 'build':
+                    await this.generateCommand(options);
+                    break;
+                case 'scaffold':
+                    await this.scaffoldCommand(args.slice(1));
+                    break;
+                case 'help':
+                    this.showHelp();
+                    break;
+                default:
+                    console.error(`Unknown command: ${command}`);
+                    this.showHelp();
+                    process.exit(1);
+            }
+        }
+        catch (error) {
+            console.error('❌ Command failed:', error);
+            process.exit(1);
+        }
+    }
+    async generateCommand(options) {
+        const target = options.target || 'all';
+        if (target === 'all' || target === 'both') {
+            console.log('📚 Generating documentation for all packages...');
+            await this.generateTarget('blocks');
+            await this.generateTarget('docs');
+            await this.generateTarget('table');
+            await this.generateTarget('auth');
+            await this.assembleLlmsFull();
+        }
+        else if (target === 'blocks' ||
+            target === 'docs' ||
+            target === 'table' ||
+            target === 'auth') {
+            console.log(`📚 Generating documentation for ${target}...`);
+            await this.generateTarget(target);
+        }
+        else {
+            console.error(`Unknown target: ${target}. Valid: blocks, docs, table, auth, all`);
+            process.exit(1);
+        }
+    }
+    async generateTarget(target) {
+        console.log(`\n🔄 Processing ${target} package...`);
+        const configMap = {
+            blocks: ConfigurationFactory.blocks,
+            docs: ConfigurationFactory.docs,
+            table: ConfigurationFactory.table,
+            auth: ConfigurationFactory.auth
+        };
+        const config = configMap[target]();
+        console.log(`✅ Configuration loaded: ${config.input.packages.length} packages`);
+        const { PipelineOrchestrator } = await import('../core/pipeline/PipelineOrchestrator');
+        const orchestrator = new PipelineOrchestrator(config);
+        const result = await orchestrator.execute();
+        if (result.success) {
+            console.log(`🎉 ${target} documentation generation completed successfully!`);
+            console.log(`📊 Generated ${result.stats.totalComponents} components in ${result.duration}ms`);
+            if (result.outputs.length > 0) {
+                console.log('📄 Generated outputs:');
+                result.outputs.forEach((output) => {
+                    console.log(`  - ${output.type}: ${output.path} (${output.components.length} components)`);
+                });
+            }
+        }
+        else {
+            console.error(`❌ ${target} documentation generation failed`);
+            result.errors.forEach((error) => {
+                console.error(`  - ${error.type}: ${error.message}`);
+            });
+            throw new Error(`${target} generation failed`);
+        }
+    }
+    async assembleLlmsFull() {
+        console.log('\n🔗 Assembling llms-full.txt...');
+        const assembler = new LlmsFullAssembler({
+            templatePath: resolveFromDocsGen('templates', 'llms-full-template.md'),
+            staticDirs: [
+                resolveFromDocsGen('..', '..', 'apps', 'docs', 'static', 'blocks'),
+                resolveFromDocsGen('..', '..', 'apps', 'docs', 'static', 'docs'),
+                resolveFromDocsGen('..', '..', 'apps', 'docs', 'static', 'table'),
+                resolveFromDocsGen('..', '..', 'apps', 'docs', 'static', 'auth')
+            ],
+            outputPaths: [
+                resolveFromDocsGen('..', '..', 'llms-full.txt'),
+                resolveFromDocsGen('..', '..', 'apps', 'docs', 'static', 'llms-full.txt')
+            ]
+        });
+        const result = await assembler.assemble();
+        console.log(`✅ llms-full.txt assembled (${result.componentCount} components)`);
+        // Assemble MCP component catalog
+        console.log('\n📦 Assembling MCP component catalog...');
+        const catalogAssembler = new MCPCatalogAssembler({
+            staticDirs: [
+                resolveFromDocsGen('..', '..', 'apps', 'docs', 'static', 'blocks'),
+                resolveFromDocsGen('..', '..', 'apps', 'docs', 'static', 'docs'),
+                resolveFromDocsGen('..', '..', 'apps', 'docs', 'static', 'table'),
+                resolveFromDocsGen('..', '..', 'apps', 'docs', 'static', 'auth')
+            ],
+            recipesDir: resolveFromDocsGen('..', '..', 'apps', 'docs', 'src', 'routes', 'recipes'),
+            outputPath: resolveFromDocsGen('..', '..', 'apps', 'docs', 'static', 'mcp', 'component-catalog.json'),
+            version: '0.2.38'
+        });
+        const catalogResult = await catalogAssembler.assemble();
+        console.log(`✅ MCP catalog assembled (${catalogResult.componentCount} components, ${catalogResult.recipeCount} recipes)`);
+    }
+    async scaffoldCommand(args) {
+        const name = args[0];
+        const options = this.parseOptions(args.slice(1));
+        const group = options.group || 'primitives';
+        if (!name) {
+            console.error('❌ Component name required. Usage: docs-gen scaffold Button --group primitives');
+            process.exit(1);
+        }
+        if (group !== 'primitives' && group !== 'components') {
+            console.error(`❌ Invalid group "${group}". Must be "primitives" or "components".`);
+            process.exit(1);
+        }
+        const slug = name
+            .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+            .replace(/_/g, '-')
+            .toLowerCase();
+        const docsDir = resolveFromDocsGen('..', '..', 'apps', 'docs', 'src', 'routes', 'blocks', group, slug);
+        // Check if directory already exists
+        try {
+            await fs.access(docsDir);
+            console.error(`❌ Directory already exists: ${docsDir}`);
+            process.exit(1);
+        }
+        catch {
+            // Expected — directory doesn't exist yet
+        }
+        await fs.mkdir(docsDir, { recursive: true });
+        // Generate +page.svelte
+        const pageSvelte = `<script lang="ts">
+  import { page } from '$app/state';
+  import { asset } from '$app/paths';
+  import {
+    ApiReference,
+    CodeExample,
+    DocsLayout as DocsPageLayout,
+    extractPlaygroundDocs,
+    PlaygroundConfigurator,
+    Section
+  } from '@urbicon-ui/docs';
+  import PrevNextNav from '$lib/PrevNextNav.svelte';
+  import SeoMeta from '$lib/SeoMeta.svelte';
+  import CustomDocs from './Docs.svelte';
+  import { componentData } from './api';
+  import { ${name} } from '@urbicon-ui/blocks';
+
+  const { propDocs, variantKeys } = extractPlaygroundDocs(componentData?.props ?? []);
+
+  const navigation = [
+    { id: 'playground', label: 'Playground', order: 1 },
+    { id: 'examples', label: 'Examples', order: 2 },
+    { id: 'customization', label: 'Customization', order: 3 },
+    { id: 'accessibility', label: 'Accessibility', order: 4 },
+    { id: 'api', label: 'API Reference', order: 10 },
+    { id: 'installation', label: 'Installation', order: 11 }
+  ];
+</script>
+
+<SeoMeta title="${name} Component" />
+
+<DocsPageLayout
+  maxWidth="2xl"
+  showToc={true}
+  title="${name}"
+  description=""
+  breadcrumbs={[
+    { label: 'Blocks', href: '/blocks' },
+    { label: '${group === 'primitives' ? 'Primitives' : 'Components'}', href: '/blocks/${group}' }
+  ]}
+  {navigation}
+>
+  <Section id="playground" title="Playground" intent="primary">
+    <PlaygroundConfigurator
+      showHeader={false}
+      {propDocs}
+      {variantKeys}
+      componentName="${name}"
+      controls={[
+        // TODO: Add playground controls
+      ]}
+    >
+      {#snippet children(values)}
+        <${name} {...values}>
+          <!-- TODO: Add component content -->
+        </${name}>
+      {/snippet}
+    </PlaygroundConfigurator>
+  </Section>
+
+  <CustomDocs />
+
+  <Section id="api" title="API Reference" intent="secondary">
+    <ApiReference props={componentData?.props ?? []} />
+  </Section>
+
+  <Section id="installation" title="Installation">
+    <CodeExample
+      title="Import"
+      code={\`import { ${name} } from '@urbicon-ui/blocks';\`}
+      language="svelte"
+      hasPreview={false}
+    />
+  </Section>
+
+  <div class="mt-6 text-right">
+    <a
+      href={asset('/blocks/${group}/${slug}/llm.txt')}
+      target="_blank"
+      rel="noopener"
+      class="text-text-tertiary hover:text-primary text-xs transition-colors"
+    >
+      llm.txt
+    </a>
+  </div>
+
+  <PrevNextNav currentPath={page.url.pathname} />
+</DocsPageLayout>
+`;
+        // Generate Docs.svelte
+        const docsSvelte = `<script lang="ts">
+  import type { SvelteDocsConfig } from '@urbicon-ui/shared-types';
+  import { CodeExample, Section } from '@urbicon-ui/docs';
+
+  export const docsConfig: SvelteDocsConfig = {
+    generation: {
+      overview: { enabled: false },
+      playground: { enabled: true, order: 1 },
+      variants: { enabled: false },
+      examples: false,
+      api: { showInheritance: true, groupBy: 'category', enabled: true, order: 14 },
+      usage: false
+    },
+    llm: { include: true },
+    meta: { title: '${name} Component', showToc: true }
+  };
+</script>
+
+<!-- ─── Examples ─── -->
+<Section id="examples" title="Examples">
+  <div class="space-y-8">
+    <!-- TODO: Add examples -->
+  </div>
+</Section>
+
+<!-- ─── Customization ─── -->
+<Section id="customization" title="Customization">
+  <div class="space-y-4">
+    <!-- TODO: Add customization examples -->
+  </div>
+</Section>
+
+<!-- ─── Accessibility ─── -->
+<Section id="accessibility" title="Accessibility">
+  <div class="prose prose-sm">
+    <!-- TODO: Document accessibility features -->
+  </div>
+</Section>
+`;
+        await fs.writeFile(path.join(docsDir, '+page.svelte'), pageSvelte, 'utf-8');
+        await fs.writeFile(path.join(docsDir, 'Docs.svelte'), docsSvelte, 'utf-8');
+        console.log(`✅ Scaffolded docs page for ${name}:`);
+        console.log(`   ${docsDir}/+page.svelte`);
+        console.log(`   ${docsDir}/Docs.svelte`);
+        console.log(`\n📝 Next steps:`);
+        console.log(`   1. Add playground controls to +page.svelte`);
+        console.log(`   2. Add examples, customization, and accessibility content to Docs.svelte`);
+        console.log(`   3. Run \`bun run docs:gen:all\` to generate the api.ts file`);
+    }
+    parseOptions(args) {
+        const options = {};
+        for (let i = 0; i < args.length; i++) {
+            const arg = args[i];
+            if (arg?.startsWith('--')) {
+                const key = arg.slice(2);
+                const value = args[i + 1];
+                if (value && !value.startsWith('--')) {
+                    options[key] = value;
+                    i++;
+                }
+                else {
+                    options[key] = true;
+                }
+            }
+        }
+        return options;
+    }
+    showHelp() {
+        console.log(`
+📚 Docs Generator
+
+Usage:
+  docs-gen [command] [options]
+
+Commands:
+  generate, build    Generate documentation (default)
+  scaffold <Name>    Scaffold a new docs page for a component
+  help              Show this help
+
+Options:
+  --target <type>   Target package: 'blocks', 'docs', 'table', or 'all' (default: 'all')
+  --group <group>   Component group for scaffold: 'primitives' or 'components' (default: 'primitives')
+
+Examples:
+  docs-gen                                        # Generate all packages
+  docs-gen --target blocks                        # Generate only blocks docs
+  docs-gen scaffold Button                        # Scaffold docs for Button (primitives)
+  docs-gen scaffold DatePicker --group components # Scaffold docs for DatePicker (components)
+    `);
+    }
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    const cli = new DocsGeneratorCLI();
+    cli.run().catch((error) => {
+        console.error('❌ CLI execution failed:', error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=CLI.js.map

package/dist/cli/CLI.js.map

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

package/dist/cli/index.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,7 @@
+import { DocsGeneratorCLI } from './CLI';
+const cli = new DocsGeneratorCLI();
+cli.run().catch((error) => {
+    console.error('❌ CLI execution failed:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAEzC,MAAM,GAAG,GAAG,IAAI,gBAAgB,EAAE,CAAC;AACnC,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACxB,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/core/discovery/ComponentFinder.d.ts

@@ -0,0 +1,43 @@
+import type { ComponentManifest, ExtractionResult, PackageConfig, PackageInfo } from '../../types';
+/**
+ * Finds and analyzes components in packages using glob patterns
+ */
+export declare class ComponentFinder {
+    private cache;
+    /**
+     * Find all components in a package
+     */
+    findComponents(packageConfig: PackageConfig): Promise<ComponentManifest[]>;
+    /**
+     * Clear the cache (useful for watch mode)
+     */
+    clearCache(): void;
+    /**
+     * Get package info from package.json
+     */
+    getPackageInfo(packagePath: string): Promise<PackageInfo>;
+    private discoverComponents;
+    /**
+     * Find component exports in an index.ts that opt into their own catalog entry.
+     *
+     * An export qualifies when both hold:
+     *   1. it is re-exported from a Svelte file: `export { default as X } from './X.svelte'`
+     *   2. a local `interface XProps` carries the `@standalone` JSDoc tag
+     *
+     * The tag is the explicit opt-in that separates independent surfaces (Guide family) from
+     * compound subcomponents (TabItem, MenuItem, CalendarDay, …), which carry the same
+     * `@description`/`@tag` metadata but must NOT become standalone catalog entries.
+     */
+    private findStandaloneComponentNames;
+    private findComponentFiles;
+    private createComponentManifest;
+    private extractComponentName;
+    private discoverRelatedFiles;
+    private findRelatedFile;
+    private findRelatedFiles;
+    /**
+     * Validate that a component manifest is complete and valid
+     */
+    validateManifest(manifest: ComponentManifest): Promise<ExtractionResult<ComponentManifest>>;
+}
+//# sourceMappingURL=ComponentFinder.d.ts.map

package/dist/core/discovery/ComponentFinder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentFinder.d.ts","sourceRoot":"","sources":["../../../src/core/discovery/ComponentFinder.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAGV,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAA0C;IAEvD;;OAEG;IACG,cAAc,CAAC,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAyBhF;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;YA6BjD,kBAAkB;IAgEhC;;;;;;;;;;OAUG;YACW,4BAA4B;YAuE5B,kBAAkB;YAwClB,uBAAuB;IAoDrC,OAAO,CAAC,oBAAoB;YAmCd,oBAAoB;YAsDpB,eAAe;YASf,gBAAgB;IA8E9B;;OAEG;IACG,gBAAgB,CACpB,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;CAkDhD"}