spec-gen-cli 1.2.6 → 1.2.8

package/dist/core/analyzer/schema-extractor.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Database Schema Extractor
+ *
+ * Parses ORM schema definitions from source files using regex-based analysis.
+ * Supports Prisma, TypeORM, Drizzle ORM, and SQLAlchemy.
+ *
+ * Audit fields (createdAt, updatedAt, created_at, updated_at, deletedAt,
+ * deleted_at) are excluded from field lists to keep output concise.
+ *
+ * Uses regex-based analysis without requiring tree-sitter.
+ */
+export interface SchemaField {
+    name: string;
+    type: string;
+    nullable: boolean;
+}
+export type OrmType = 'prisma' | 'typeorm' | 'drizzle' | 'sqlalchemy' | 'unknown';
+export interface SchemaTable {
+    /** Model / table name */
+    name: string;
+    /** Path relative to project root */
+    file: string;
+    /** ORM that owns this schema */
+    orm: OrmType;
+    /** Extracted fields (audit fields excluded) */
+    fields: SchemaField[];
+    /** 1-based line of the model declaration */
+    line: number;
+}
+/**
+ * Extract database schema tables from a list of absolute file paths.
+ *
+ * @param filePaths - Absolute paths to source files
+ * @param rootDir   - Project root used to compute relative paths in output
+ */
+export declare function extractSchemas(filePaths: string[], rootDir: string): Promise<SchemaTable[]>;
+/**
+ * Summarise schema tables by ORM for display / artifact embedding.
+ */
+export declare function summarizeSchemas(tables: SchemaTable[]): Record<string, number>;
+//# sourceMappingURL=schema-extractor.d.ts.map

package/dist/core/analyzer/schema-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-extractor.d.ts","sourceRoot":"","sources":["../../../src/core/analyzer/schema-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;AAElF,MAAM,WAAW,WAAW;IAC1B,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,GAAG,EAAE,OAAO,CAAC;IACb,+CAA+C;IAC/C,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;CACd;AAsMD;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,WAAW,EAAE,CAAC,CA8BxB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EAAE,GACpB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMxB"}

package/dist/core/analyzer/schema-extractor.js

@@ -0,0 +1,229 @@
+/**
+ * Database Schema Extractor
+ *
+ * Parses ORM schema definitions from source files using regex-based analysis.
+ * Supports Prisma, TypeORM, Drizzle ORM, and SQLAlchemy.
+ *
+ * Audit fields (createdAt, updatedAt, created_at, updated_at, deletedAt,
+ * deleted_at) are excluded from field lists to keep output concise.
+ *
+ * Uses regex-based analysis without requiring tree-sitter.
+ */
+import { readFile } from 'node:fs/promises';
+import { extname, relative } from 'node:path';
+import { getSkeletonContent } from './code-shaper.js';
+// ============================================================================
+// AUDIT FIELD FILTER
+// ============================================================================
+const AUDIT_FIELD_NAMES = new Set([
+    'createdAt', 'updatedAt', 'deletedAt',
+    'created_at', 'updated_at', 'deleted_at',
+    'createdBy', 'updatedBy', 'created_by', 'updated_by',
+]);
+function isAuditField(name) {
+    return AUDIT_FIELD_NAMES.has(name);
+}
+// ============================================================================
+// HELPERS
+// ============================================================================
+function lineOfIndex(source, index) {
+    return source.slice(0, index).split('\n').length;
+}
+// ============================================================================
+// PRISMA PARSER (.prisma files)
+// ============================================================================
+// model User { ... }
+const PRISMA_MODEL_RE = /^model\s+(\w+)\s*\{([^}]+)\}/gm;
+// field line: fieldName  FieldType? @...
+const PRISMA_FIELD_RE = /^\s{1,4}(\w+)\s+(\w+)(\?)?/m;
+function parsePrisma(source, rel) {
+    const tables = [];
+    const modelRe = new RegExp(PRISMA_MODEL_RE.source, PRISMA_MODEL_RE.flags);
+    let m;
+    while ((m = modelRe.exec(source)) !== null) {
+        const name = m[1];
+        const body = m[2];
+        const line = lineOfIndex(source, m.index);
+        const fields = [];
+        for (const rawLine of body.split('\n')) {
+            const fm = PRISMA_FIELD_RE.exec(rawLine);
+            if (!fm)
+                continue;
+            const fieldName = fm[1];
+            if (fieldName.startsWith('@') || fieldName === '@@')
+                continue;
+            if (isAuditField(fieldName))
+                continue;
+            fields.push({
+                name: fieldName,
+                type: fm[2],
+                nullable: fm[3] === '?',
+            });
+        }
+        tables.push({ name, file: rel, orm: 'prisma', fields, line });
+    }
+    return tables;
+}
+// ============================================================================
+// TYPEORM PARSER (.ts files with @Entity)
+// ============================================================================
+// @Entity() ... class ClassName { ... }
+// We capture class name after @Entity decorator region.
+const TYPEORM_ENTITY_RE = /@Entity\s*\([^)]*\)[^]*?class\s+(\w+)/g;
+// @Column() / @PrimaryGeneratedColumn() etc before fieldName: FieldType
+const TYPEORM_COLUMN_RE = /@(?:Column|PrimaryGeneratedColumn|PrimaryColumn|CreateDateColumn|UpdateDateColumn|DeleteDateColumn|ManyToOne|OneToMany|ManyToMany|OneToOne|JoinColumn|JoinTable)\s*\([^)]*\)\s*\n\s*(\w+)\s*[?!]?\s*:\s*([^;\n]+)/g;
+const TYPEORM_CLASS_BODY_RE = /class\s+\w+[^{]*\{([^]*?)^}/m;
+function parseTypeOrm(source, rel) {
+    const tables = [];
+    const entityRe = new RegExp(TYPEORM_ENTITY_RE.source, TYPEORM_ENTITY_RE.flags);
+    let em;
+    while ((em = entityRe.exec(source)) !== null) {
+        const name = em[1];
+        const line = lineOfIndex(source, em.index);
+        const fields = [];
+        // Extract class body starting from the match
+        const afterMatch = source.slice(em.index);
+        const bodyMatch = TYPEORM_CLASS_BODY_RE.exec(afterMatch);
+        if (bodyMatch) {
+            const body = bodyMatch[1];
+            const colRe = new RegExp(TYPEORM_COLUMN_RE.source, TYPEORM_COLUMN_RE.flags);
+            let cm;
+            while ((cm = colRe.exec(body)) !== null) {
+                const fieldName = cm[1];
+                if (isAuditField(fieldName))
+                    continue;
+                fields.push({
+                    name: fieldName,
+                    type: cm[2].trim().replace(/;.*$/, ''),
+                    nullable: cm[2].includes('null') || false,
+                });
+            }
+        }
+        tables.push({ name, file: rel, orm: 'typeorm', fields, line });
+    }
+    return tables;
+}
+// ============================================================================
+// DRIZZLE ORM PARSER (.ts files)
+// ============================================================================
+// export const users = pgTable('users', { ... })
+const DRIZZLE_TABLE_RE = /(?:export\s+(?:const|let)\s+(\w+)\s*=\s*)?(?:pgTable|mysqlTable|sqliteTable)\s*\(\s*['"`](\w+)['"`]\s*,\s*\{([^}]+)\}/g;
+// fieldName: columnType(...)
+const DRIZZLE_FIELD_RE = /^\s{1,6}(\w+)\s*:\s*([\w.]+)\s*\(/m;
+function parseDrizzle(source, rel) {
+    const tables = [];
+    const tableRe = new RegExp(DRIZZLE_TABLE_RE.source, DRIZZLE_TABLE_RE.flags);
+    let m;
+    while ((m = tableRe.exec(source)) !== null) {
+        // Prefer the table name literal (m[2]) over the variable name (m[1])
+        const name = m[2] || m[1] || 'unknown';
+        const body = m[3];
+        const line = lineOfIndex(source, m.index);
+        const fields = [];
+        for (const rawLine of body.split('\n')) {
+            const fm = DRIZZLE_FIELD_RE.exec(rawLine);
+            if (!fm)
+                continue;
+            const fieldName = fm[1];
+            if (isAuditField(fieldName))
+                continue;
+            fields.push({
+                name: fieldName,
+                type: fm[2],
+                nullable: rawLine.includes('.nullable()') || rawLine.includes('$default'),
+            });
+        }
+        tables.push({ name, file: rel, orm: 'drizzle', fields, line });
+    }
+    return tables;
+}
+// ============================================================================
+// SQLALCHEMY PARSER (.py files)
+// ============================================================================
+// class User(Base): or class User(db.Model):
+const SQLALCHEMY_MODEL_RE = /^class\s+(\w+)\s*\([^)]*(?:Base|db\.Model|DeclarativeBase)[^)]*\)\s*:/gm;
+// column_name = Column(Type, ...)
+const SQLALCHEMY_COLUMN_RE = /^\s{4}(\w+)\s*=\s*(?:mapped_column|Column)\s*\(\s*([^,)]+)/m;
+// nullable: nullable=True (default) or nullable=False
+const SQLALCHEMY_NULLABLE_RE = /nullable\s*=\s*(True|False)/;
+function parseSqlAlchemy(source, rel) {
+    const tables = [];
+    const classRe = new RegExp(SQLALCHEMY_MODEL_RE.source, SQLALCHEMY_MODEL_RE.flags);
+    let cm;
+    while ((cm = classRe.exec(source)) !== null) {
+        const name = cm[1];
+        const line = lineOfIndex(source, cm.index);
+        const fields = [];
+        // Capture up to next class or end of file
+        const rest = source.slice(cm.index + cm[0].length);
+        const nextClassIdx = rest.search(/^class\s+\w+/m);
+        const classBody = nextClassIdx >= 0 ? rest.slice(0, nextClassIdx) : rest;
+        for (const rawLine of classBody.split('\n')) {
+            const fm = SQLALCHEMY_COLUMN_RE.exec(rawLine);
+            if (!fm)
+                continue;
+            const fieldName = fm[1];
+            if (fieldName.startsWith('_') || isAuditField(fieldName))
+                continue;
+            const nullableMatch = SQLALCHEMY_NULLABLE_RE.exec(rawLine);
+            // SQLAlchemy columns are nullable by default
+            const nullable = nullableMatch ? nullableMatch[1] === 'True' : true;
+            fields.push({
+                name: fieldName,
+                type: fm[2].trim().replace(/[,)].*/s, ''),
+                nullable,
+            });
+        }
+        tables.push({ name, file: rel, orm: 'sqlalchemy', fields, line });
+    }
+    return tables;
+}
+// ============================================================================
+// PUBLIC API
+// ============================================================================
+/**
+ * Extract database schema tables from a list of absolute file paths.
+ *
+ * @param filePaths - Absolute paths to source files
+ * @param rootDir   - Project root used to compute relative paths in output
+ */
+export async function extractSchemas(filePaths, rootDir) {
+    const results = [];
+    await Promise.all(filePaths.map(async (filePath) => {
+        const ext = extname(filePath).toLowerCase();
+        const rel = relative(rootDir, filePath);
+        let source;
+        try {
+            source = getSkeletonContent(await readFile(filePath, 'utf-8'), ext === '.py' ? 'python' : 'typescript');
+        }
+        catch {
+            return;
+        }
+        if (ext === '.prisma') {
+            results.push(...parsePrisma(source, rel));
+        }
+        else if (ext === '.py' && (source.includes('Column(') || source.includes('mapped_column('))) {
+            results.push(...parseSqlAlchemy(source, rel));
+        }
+        else if (ext === '.ts' || ext === '.tsx') {
+            if (source.includes('@Entity(') || source.includes('@Entity()')) {
+                results.push(...parseTypeOrm(source, rel));
+            }
+            else if (/pgTable|mysqlTable|sqliteTable/.test(source)) {
+                results.push(...parseDrizzle(source, rel));
+            }
+        }
+    }));
+    return results;
+}
+/**
+ * Summarise schema tables by ORM for display / artifact embedding.
+ */
+export function summarizeSchemas(tables) {
+    const counts = {};
+    for (const t of tables) {
+        counts[t.orm] = (counts[t.orm] ?? 0) + 1;
+    }
+    return counts;
+}
+//# sourceMappingURL=schema-extractor.js.map

package/dist/core/analyzer/schema-extractor.js.map

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

package/dist/core/analyzer/spec-snapshot-generator.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Spec Snapshot Generator
+ *
+ * Derives a compact coverage summary from existing analysis artifacts —
+ * no LLM required. Reads llm-context.json, mapping.json, and spec files
+ * to produce spec-snapshot.json.
+ */
+import type { SpecSnapshot } from '../../types/index.js';
+export declare class SpecSnapshotGenerator {
+    private readonly rootPath;
+    private readonly openspecRelPath;
+    constructor(rootPath: string, openspecRelPath?: string);
+    generate(): Promise<SpecSnapshot>;
+    /** Load a previously generated snapshot, or return null if not found. */
+    static load(rootPath: string): Promise<SpecSnapshot | null>;
+}
+//# sourceMappingURL=spec-snapshot-generator.d.ts.map

package/dist/core/analyzer/spec-snapshot-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-snapshot-generator.d.ts","sourceRoot":"","sources":["../../../src/core/analyzer/spec-snapshot-generator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAeH,OAAO,KAAK,EAAE,YAAY,EAAuC,MAAM,sBAAsB,CAAC;AAmH9F,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,eAAe;gBADf,QAAQ,EAAE,MAAM,EAChB,eAAe,GAAE,MAAqB;IAGnD,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;IA4FvC,yEAAyE;WAC5D,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;CAWlE"}

package/dist/core/analyzer/spec-snapshot-generator.js

@@ -0,0 +1,201 @@
+/**
+ * Spec Snapshot Generator
+ *
+ * Derives a compact coverage summary from existing analysis artifacts —
+ * no LLM required. Reads llm-context.json, mapping.json, and spec files
+ * to produce spec-snapshot.json.
+ */
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { readFile, stat, readdir, writeFile } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+import { SPEC_GEN_DIR, SPEC_GEN_ANALYSIS_SUBDIR, ARTIFACT_LLM_CONTEXT, ARTIFACT_MAPPING, ARTIFACT_SPEC_SNAPSHOT, OPENSPEC_DIR, OPENSPEC_SPECS_SUBDIR, } from '../../constants.js';
+const execFileAsync = promisify(execFile);
+// ============================================================================
+// GIT HELPERS
+// ============================================================================
+async function getGitState(rootPath) {
+    try {
+        const [commitResult, branchResult, statusResult] = await Promise.all([
+            execFileAsync('git', ['rev-parse', '--short', 'HEAD'], { cwd: rootPath }).catch(() => ({ stdout: '' })),
+            execFileAsync('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { cwd: rootPath }).catch(() => ({ stdout: '' })),
+            execFileAsync('git', ['status', '--porcelain'], { cwd: rootPath }).catch(() => ({ stdout: '' })),
+        ]);
+        return {
+            commit: commitResult.stdout.trim() || 'unknown',
+            branch: branchResult.stdout.trim() || 'unknown',
+            dirty: statusResult.stdout.trim().length > 0,
+        };
+    }
+    catch {
+        return { commit: 'unknown', branch: 'unknown', dirty: false };
+    }
+}
+// ============================================================================
+// SPEC FILE HELPERS
+// ============================================================================
+/** Count H2/H3 headings in a spec.md as a proxy for requirement count. */
+function countRequirements(content) {
+    const matches = content.match(/^#{2,3} /gm);
+    return matches ? matches.length : 0;
+}
+/** Get max mtime across a list of file paths (returns epoch ISO string if none exist). */
+async function maxMtime(filePaths, rootPath) {
+    let max = 0;
+    for (const rel of filePaths) {
+        try {
+            const s = await stat(join(rootPath, rel));
+            if (s.mtimeMs > max)
+                max = s.mtimeMs;
+        }
+        catch { /* file may not exist */ }
+    }
+    return max > 0 ? new Date(max).toISOString() : new Date(0).toISOString();
+}
+async function discoverSpecDomains(openspecPath, rootPath) {
+    const specsDir = join(openspecPath, OPENSPEC_SPECS_SUBDIR);
+    let entries;
+    try {
+        entries = await readdir(specsDir);
+    }
+    catch {
+        return [];
+    }
+    const domains = [];
+    for (const entry of entries) {
+        const specFilePath = join(specsDir, entry, 'spec.md');
+        try {
+            const [content, s] = await Promise.all([
+                readFile(specFilePath, 'utf-8'),
+                stat(specFilePath),
+            ]);
+            domains.push({
+                name: entry,
+                specFile: relative(rootPath, specFilePath),
+                specModifiedAt: s.mtime.toISOString(),
+                requirementCount: countRequirements(content),
+            });
+        }
+        catch { /* skip missing spec.md */ }
+    }
+    return domains;
+}
+// ============================================================================
+// COVERAGE COMPUTATION
+// ============================================================================
+function buildCoveredFunctionSet(mapping) {
+    const covered = new Set();
+    for (const m of mapping.mappings) {
+        for (const fn of m.functions) {
+            if (fn.name && fn.name !== '*') {
+                covered.add(`${fn.file}::${fn.name}`);
+                covered.add(fn.name); // also by name alone for looser matching
+            }
+        }
+    }
+    return covered;
+}
+function isFunctionCovered(node, covered) {
+    const byFileAndName = `${node.filePath}::${node.name}`;
+    return covered.has(byFileAndName) || covered.has(node.name);
+}
+// ============================================================================
+// PUBLIC API
+// ============================================================================
+export class SpecSnapshotGenerator {
+    rootPath;
+    openspecRelPath;
+    constructor(rootPath, openspecRelPath = OPENSPEC_DIR) {
+        this.rootPath = rootPath;
+        this.openspecRelPath = openspecRelPath;
+    }
+    async generate() {
+        const analysisDir = join(this.rootPath, SPEC_GEN_DIR, SPEC_GEN_ANALYSIS_SUBDIR);
+        const openspecPath = join(this.rootPath, this.openspecRelPath);
+        // Load artifacts in parallel
+        const [llmContextRaw, mappingRaw, git, specDomains] = await Promise.all([
+            readFile(join(analysisDir, ARTIFACT_LLM_CONTEXT), 'utf-8').catch(() => null),
+            readFile(join(analysisDir, ARTIFACT_MAPPING), 'utf-8').catch(() => null),
+            getGitState(this.rootPath),
+            discoverSpecDomains(openspecPath, this.rootPath),
+        ]);
+        const llmContext = llmContextRaw ? JSON.parse(llmContextRaw) : null;
+        const mapping = mappingRaw ? JSON.parse(mappingRaw) : null;
+        const callGraph = llmContext?.callGraph;
+        const allNodes = callGraph?.nodes ?? [];
+        const hubNodes = callGraph?.hubFunctions ?? [];
+        // Build coverage index from mapping
+        const covered = mapping ? buildCoveredFunctionSet(mapping) : new Set();
+        const coveredCount = mapping ? allNodes.filter(n => isFunctionCovered(n, covered)).length : 0;
+        const orphanCount = mapping?.orphanFunctions?.length ?? 0;
+        const totalFunctions = allNodes.length;
+        // Build per-domain info
+        // For each spec domain, find which mapping entries belong to it
+        const domainMappings = new Map();
+        if (mapping) {
+            for (const m of mapping.mappings) {
+                const entry = domainMappings.get(m.domain) ?? { mappedFunctions: new Set(), sourceFiles: new Set() };
+                for (const fn of m.functions) {
+                    if (fn.name && fn.name !== '*')
+                        entry.mappedFunctions.add(fn.name);
+                    if (fn.file && fn.file !== '*')
+                        entry.sourceFiles.add(fn.file);
+                }
+                domainMappings.set(m.domain, entry);
+            }
+        }
+        const domains = await Promise.all(specDomains.map(async (d) => {
+            const dm = domainMappings.get(d.name);
+            const sourceFiles = dm ? Array.from(dm.sourceFiles) : [];
+            const mappedFunctionCount = dm ? dm.mappedFunctions.size : 0;
+            const sourcesModifiedAt = await maxMtime(sourceFiles, this.rootPath);
+            const coveragePct = d.requirementCount > 0
+                ? Math.round((mappedFunctionCount / Math.max(d.requirementCount, mappedFunctionCount)) * 100)
+                : 0;
+            return {
+                name: d.name,
+                specFile: d.specFile,
+                sourceFiles,
+                requirementCount: d.requirementCount,
+                mappedFunctionCount,
+                coveragePct,
+                specModifiedAt: d.specModifiedAt,
+                sourcesModifiedAt,
+            };
+        }));
+        // Hub coverage
+        const hubs = hubNodes.map(n => ({
+            name: n.name,
+            file: n.filePath,
+            fanIn: n.fanIn,
+            covered: isFunctionCovered(n, covered),
+        }));
+        const snapshot = {
+            version: '1',
+            generatedAt: new Date().toISOString(),
+            git,
+            coverage: {
+                totalFunctions,
+                coveredFunctions: coveredCount,
+                orphanFunctions: orphanCount,
+                coveragePct: totalFunctions > 0 ? Math.round((coveredCount / totalFunctions) * 100) : 0,
+            },
+            domains,
+            hubs,
+        };
+        // Persist
+        await writeFile(join(analysisDir, ARTIFACT_SPEC_SNAPSHOT), JSON.stringify(snapshot, null, 2));
+        return snapshot;
+    }
+    /** Load a previously generated snapshot, or return null if not found. */
+    static async load(rootPath) {
+        try {
+            const raw = await readFile(join(rootPath, SPEC_GEN_DIR, SPEC_GEN_ANALYSIS_SUBDIR, ARTIFACT_SPEC_SNAPSHOT), 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=spec-snapshot-generator.js.map

package/dist/core/analyzer/spec-snapshot-generator.js.map

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

package/dist/core/analyzer/ui-component-extractor.d.ts

@@ -0,0 +1,43 @@
+/**
+ * UI Component Extractor
+ *
+ * Detects React, Vue, Svelte, and Angular UI components from source files
+ * using regex-based analysis (no tree-sitter required).
+ *
+ * Detection strategy per framework:
+ *   - React: function/const export with PascalCase name in JSX/TSX files
+ *   - Vue: Single File Components (.vue) with <template> blocks
+ *   - Svelte: .svelte files (each file = one component)
+ *   - Angular: @Component decorator
+ */
+export interface ComponentProp {
+    name: string;
+    type: string;
+    required: boolean;
+}
+export interface UIComponent {
+    /** PascalCase component name */
+    name: string;
+    /** Path relative to project root */
+    file: string;
+    /** UI framework */
+    framework: 'react' | 'vue' | 'svelte' | 'angular';
+    /** Whether this is the default export */
+    isDefault: boolean;
+    /** 1-based line number of the declaration */
+    line: number;
+    /** Extracted props (up to MAX_PROPS) */
+    props: ComponentProp[];
+}
+/**
+ * Extract UI components from a list of absolute file paths.
+ *
+ * @param filePaths - Absolute paths to source files
+ * @param rootDir   - Project root used to compute relative paths in output
+ */
+export declare function extractUIComponents(filePaths: string[], rootDir: string): Promise<UIComponent[]>;
+/**
+ * Summarise components by framework for display / artifact embedding.
+ */
+export declare function summarizeUIComponents(components: UIComponent[]): Record<string, number>;
+//# sourceMappingURL=ui-component-extractor.d.ts.map

package/dist/core/analyzer/ui-component-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-component-extractor.d.ts","sourceRoot":"","sources":["../../../src/core/analyzer/ui-component-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,SAAS,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;IAClD,yCAAyC;IACzC,SAAS,EAAE,OAAO,CAAC;IACnB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAmOD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,WAAW,EAAE,CAAC,CAUxB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,WAAW,EAAE,GACxB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMxB"}