@cl-mcp/core 2.0.0

package/dist/data/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/data/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAwVzD,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYtC,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,qBAAqB,CAe1E"}

package/dist/data/schema.js

@@ -0,0 +1,356 @@
+/**
+ * Zod schema for `component-metadata.json`.
+ *
+ * This is the trust-boundary validator for metadata loaded at MCP-server
+ * startup. The analyzer produces the file at build time; by the time the
+ * server reads it, it might be stale, hand-edited, from a different major
+ * version, or corrupt. Parsing through this schema — instead of casting —
+ * catches shape drift loudly and immediately.
+ *
+ * Phase 7 (v4.0 BREAKING): discriminated unions mirror the TS types in
+ * `analyzer/src/types.ts`. Illegal states (e.g. `required: true` with a
+ * `defaultValue`, both `template` + `templateUrl` set, `self + skipSelf`)
+ * are rejected at parse time. `importedBy` is computed at load time and
+ * is no longer part of the on-disk schema.
+ */
+import { z } from 'zod';
+// ── Leaves ──────────────────────────────────────────────────────────
+const ResolvedValuesSchema = z.object({
+    values: z.array(z.string()),
+    partial: z.boolean(),
+});
+// InputProperty — discriminated on `required`. A required input cannot
+// carry a `defaultValue`.
+const InputPropertySchema = z.discriminatedUnion('required', [
+    z
+        .object({
+        required: z.literal(true),
+        name: z.string(),
+        type: z.string().nullable(),
+        typeResolved: z.boolean(),
+        alias: z.string().optional(),
+        description: z.string().optional(),
+        transform: z.string().optional(),
+        resolvedValues: ResolvedValuesSchema.nullable(),
+    })
+        // Strict: required inputs cannot carry `defaultValue`. Extra unknown
+        // fields would otherwise be silently accepted by Zod's default mode.
+        .strict(),
+    z.object({
+        required: z.literal(false),
+        name: z.string(),
+        type: z.string().nullable(),
+        typeResolved: z.boolean(),
+        defaultValue: z.string().optional(),
+        alias: z.string().optional(),
+        description: z.string().optional(),
+        transform: z.string().optional(),
+        resolvedValues: ResolvedValuesSchema.nullable(),
+    }),
+]);
+const OutputPropertySchema = z.object({
+    name: z.string(),
+    eventType: z.string().nullable(),
+    eventTypeResolved: z.boolean(),
+    alias: z.string().optional(),
+    description: z.string().optional(),
+});
+const MethodParameterSchema = z.object({
+    name: z.string(),
+    type: z.string().nullable(),
+    typeResolved: z.boolean(),
+    optional: z.boolean(),
+    defaultValue: z.string().optional(),
+});
+const PublicMethodSchema = z.object({
+    name: z.string(),
+    parameters: z.array(MethodParameterSchema),
+    returnType: z.string().nullable(),
+    returnTypeResolved: z.boolean(),
+    description: z.string().optional(),
+    isAsync: z.boolean(),
+});
+// InjectedDependency — `self: true` forces `skipSelf: false`.
+const InjectedDependencyBaseFields = {
+    name: z.string(),
+    type: z.string().nullable(),
+    typeResolved: z.boolean(),
+    injectionToken: z.string().optional(),
+    optional: z.boolean(),
+    host: z.boolean(),
+};
+const InjectedDependencySchema = z.discriminatedUnion('self', [
+    z.object({
+        ...InjectedDependencyBaseFields,
+        self: z.literal(true),
+        skipSelf: z.literal(false),
+    }),
+    z.object({
+        ...InjectedDependencyBaseFields,
+        self: z.literal(false),
+        skipSelf: z.boolean(),
+    }),
+]);
+const TypeMemberSchema = z.object({
+    name: z.string(),
+    type: z.string().nullable(),
+    typeResolved: z.boolean(),
+    optional: z.boolean(),
+    description: z.string().optional(),
+});
+const EnumMemberSchema = z.object({
+    name: z.string(),
+    value: z.string().optional(),
+});
+// ExportedType — discriminated on `kind`. `interface` / `class` carry
+// TypeMember[]; `enum` carries EnumMember[]; `type` carries no members.
+const ExportedTypeSchema = z.discriminatedUnion('kind', [
+    z.object({
+        kind: z.literal('interface'),
+        name: z.string(),
+        definition: z.string(),
+        members: z.array(TypeMemberSchema).optional(),
+    }),
+    z.object({
+        kind: z.literal('class'),
+        name: z.string(),
+        definition: z.string(),
+        members: z.array(TypeMemberSchema).optional(),
+    }),
+    z.object({
+        kind: z.literal('type'),
+        name: z.string(),
+        definition: z.string(),
+    }),
+    z.object({
+        kind: z.literal('enum'),
+        name: z.string(),
+        definition: z.string(),
+        members: z.array(EnumMemberSchema).optional(),
+    }),
+]);
+const LifecycleHookSchema = z.object({
+    name: z.string(),
+    implemented: z.boolean(),
+});
+// ComponentMetadata — enforce XOR on template/templateUrl via .refine().
+// `z.discriminatedUnion` doesn't fit because both fields are optional
+// (directives carry neither), so a plain object + refinement is the
+// cleanest expression of "at most one".
+const ComponentMetadataSchema = z
+    .object({
+    selector: z.string(),
+    standalone: z.boolean(),
+    changeDetection: z.enum(['OnPush', 'Default']).nullable().optional(),
+    encapsulation: z.enum(['None', 'Emulated', 'ShadowDom']).nullable().optional(),
+    exportAs: z.string().optional(),
+    template: z.string().optional(),
+    templateUrl: z.string().optional(),
+    styleUrls: z.array(z.string()).optional(),
+    imports: z.array(z.string()).optional(),
+    providers: z.array(z.string()).optional(),
+})
+    .refine((m) => !(m.template !== undefined && m.templateUrl !== undefined), {
+    message: 'template and templateUrl are mutually exclusive',
+    path: ['template'],
+});
+const ComponentAnalysisSchema = z.object({
+    className: z.string(),
+    filePath: z.string(),
+    metadata: ComponentMetadataSchema,
+    inputs: z.array(InputPropertySchema),
+    outputs: z.array(OutputPropertySchema),
+    publicMethods: z.array(PublicMethodSchema),
+    dependencies: z.array(InjectedDependencySchema),
+    lifecycleHooks: z.array(LifecycleHookSchema),
+    exportedTypes: z.array(ExportedTypeSchema),
+    jsDocDescription: z.string().optional(),
+});
+const PipeAnalysisSchema = z.object({
+    className: z.string(),
+    pipeName: z.string(),
+    pure: z.boolean(),
+    standalone: z.boolean(),
+    transformMethod: PublicMethodSchema.optional(),
+});
+const ServiceAnalysisSchema = z.object({
+    className: z.string(),
+    providedIn: z.enum(['root', 'platform', 'any']).nullable().optional(),
+    dependencies: z.array(InjectedDependencySchema),
+    publicMethods: z.array(PublicMethodSchema),
+});
+const ExportedFunctionSchema = z.object({
+    name: z.string(),
+    parameters: z.array(MethodParameterSchema),
+    returnType: z.string().nullable(),
+    returnTypeResolved: z.boolean(),
+    description: z.string().optional(),
+    isAsync: z.boolean(),
+});
+const FileAnalysisSchema = z.object({
+    filePath: z.string(),
+    components: z.array(ComponentAnalysisSchema),
+    directives: z.array(ComponentAnalysisSchema),
+    pipes: z.array(PipeAnalysisSchema),
+    services: z.array(ServiceAnalysisSchema),
+    exportedTypes: z.array(ExportedTypeSchema),
+    exportedFunctions: z.array(ExportedFunctionSchema),
+});
+// ── Enhanced types ──────────────────────────────────────────────────
+const InheritanceInfoSchema = z.object({
+    baseClass: z.string().optional(),
+    baseClassPath: z.string().optional(),
+    inheritedInputs: z.array(InputPropertySchema),
+    inheritedOutputs: z.array(OutputPropertySchema),
+    mixins: z.array(z.string()),
+});
+const ContentSlotInfoSchema = z.object({
+    name: z.string(),
+    selector: z.string().optional(),
+    required: z.boolean(),
+    multiple: z.boolean(),
+    // v4.1 additive — compound-selector alternates captured by analyzer
+    // (e.g. `select="[foo], [bar]"`). Optional for back-compat.
+    selectorAlternates: z.array(z.string()).optional(),
+});
+const DeprecationInfoSchema = z.object({
+    deprecated: z.literal(true),
+    since: z.string().optional(),
+    removeIn: z.string().optional(),
+    replacement: z.string().optional(),
+    reason: z.string().optional(),
+});
+const ConfigTokenInfoSchema = z.object({
+    token: z.string(),
+    interface: z.string(),
+    properties: z.array(TypeMemberSchema),
+    defaultValues: z.record(z.unknown()).optional(),
+    filePath: z.string(),
+    // v4.2 additive: decorator-based global config (@WithConfig) vs InjectionToken.
+    kind: z.enum(['injection-token', 'with-config']).optional(),
+    configKey: z.string().optional(),
+});
+// StorybookExample — `validated` dropped in v4.0 (derivable from validation pass).
+const StorybookExampleSchema = z.object({
+    storyName: z.string(),
+    filePath: z.string(),
+    template: z.string(),
+    args: z.record(z.unknown()),
+    argTypes: z.record(z.object({ options: z.array(z.string()).optional() })).optional(),
+    usedComponents: z.array(z.string()),
+    // v4.1 additive — structured element/attribute refs. Optional for back-compat
+    // with v4.0 files that don't carry it.
+    usedComponentRefs: z
+        .array(z.object({
+        selector: z.string(),
+        kind: z.enum(['element', 'attribute']),
+    }))
+        .optional(),
+});
+const RelatedComponentSchema = z.object({
+    name: z.string(),
+    relationship: z.enum(['requires', 'often-used-with', 'alternative-to']),
+    reason: z.string(),
+});
+const SelectorQuickInfoSchema = z.object({
+    component: z.string(),
+    type: z.enum(['component', 'directive']).optional(),
+    mainInputs: z.array(z.string()),
+    mainOutputs: z.array(z.string()),
+    formControl: z.boolean().optional(),
+    hasContentSlots: z.boolean().optional(),
+    deprecated: z.boolean().optional(),
+    configRequired: z.array(z.string()).optional(),
+});
+const AnalyzerDiagnosticSchema = z.object({
+    severity: z.enum(['error', 'warn']),
+    code: z.string(),
+    component: z.string().optional(),
+    file: z.string().optional(),
+    message: z.string(),
+    stack: z.string().optional(),
+});
+// EnhancedComponentMetadataEntry — discriminated on `kind`.
+// `analyzed` carries the full payload; `skipped`/`failed` carry only
+// `name` + `reason`. `importedBy` is NOT in the on-disk schema — it is
+// computed at load time (see data/metadata.ts).
+const AnalyzedComponentEntrySchema = z.object({
+    kind: z.literal('analyzed'),
+    name: z.string(),
+    exports: z.array(z.string()),
+    files: z.array(z.string()),
+    readme: z.string().optional(),
+    analysis: z.array(FileAnalysisSchema),
+    dependencies: z.object({
+        required: z.array(z.string()),
+        optional: z.array(z.string()),
+        providers: z.object({
+            required: z.array(z.string()),
+            optional: z.array(z.string()),
+        }),
+    }),
+    examples: z.array(z.object({
+        name: z.string(),
+        description: z.string(),
+        template: z.string().optional(),
+        typescript: z.string().optional(),
+        scss: z.string().optional(),
+    })),
+    inheritance: z.record(InheritanceInfoSchema).optional(),
+    contentProjection: z.array(ContentSlotInfoSchema).optional(),
+    deprecation: DeprecationInfoSchema.optional(),
+    configTokens: z.array(ConfigTokenInfoSchema).optional(),
+    storybookExamples: z.array(StorybookExampleSchema).optional(),
+    importsFrom: z.array(z.string()).optional(),
+    relatedComponents: z.array(RelatedComponentSchema).optional(),
+    llmSummary: z.string().optional(),
+    commonPatterns: z.array(z.string()).optional(),
+    inheritanceResolved: z.boolean(),
+});
+const SkippedComponentEntrySchema = z.object({
+    kind: z.literal('skipped'),
+    name: z.string(),
+    reason: z.string(),
+});
+const FailedComponentEntrySchema = z.object({
+    kind: z.literal('failed'),
+    name: z.string(),
+    reason: z.string(),
+});
+const ComponentMetadataEntrySchema = z.discriminatedUnion('kind', [
+    AnalyzedComponentEntrySchema,
+    SkippedComponentEntrySchema,
+    FailedComponentEntrySchema,
+]);
+export const ComponentMetadataFileSchema = z.object({
+    version: z.string(),
+    generatedAt: z.string(),
+    // v4.2 additive: absent means "angular" (every pre-v4.2 file was Angular).
+    framework: z.enum(['angular', 'react']).optional(),
+    libraryName: z.string().optional(),
+    componentsPath: z.string(),
+    importPrefix: z.string().optional(),
+    libraryDocumentation: z.string().optional(),
+    components: z.record(ComponentMetadataEntrySchema),
+    selectorMap: z.record(SelectorQuickInfoSchema).optional(),
+    diagnostics: z.array(AnalyzerDiagnosticSchema).optional(),
+});
+/**
+ * Parse and validate raw JSON as `ComponentMetadataFile`. Throws a single
+ * descriptive `Error` when the input violates the schema — the message lists
+ * every offending path + reason so operators can pinpoint drift.
+ */
+export function parseComponentMetadata(raw) {
+    const result = ComponentMetadataFileSchema.safeParse(raw);
+    if (result.success) {
+        // Zod parse returns our structural shape; brand types are compile-time
+        // only, so the cast is a pure type-level widen.
+        return result.data;
+    }
+    const issueLines = result.error.issues.map((issue) => {
+        const path = issue.path.length > 0 ? issue.path.join('.') : '<root>';
+        return `  - ${path}: ${issue.message}`;
+    });
+    throw new Error(`[cl-mcp] component-metadata.json failed schema validation:\n${issueLines.join('\n')}`);
+}
+//# sourceMappingURL=schema.js.map

package/dist/data/schema.js.map

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

package/dist/domain/context.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Quick Context Generation (for LLM efficiency)
+ *
+ * Generates compact component reference data optimized for LLM consumption.
+ * Parametric — uses config for library-specific names.
+ */
+import type { QuickContext } from "../types.js";
+export declare function generateQuickContext(): QuickContext;
+export declare function getQuickContext(): QuickContext;
+export declare function formatQuickContextForLLM(): string;
+//# sourceMappingURL=context.d.ts.map

package/dist/domain/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/domain/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,aAAa,CAAC;AAEnE,wBAAgB,oBAAoB,IAAI,YAAY,CA8EnD;AAOD,wBAAgB,eAAe,IAAI,YAAY,CAQ9C;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CA8EjD"}

package/dist/domain/context.js

@@ -0,0 +1,168 @@
+/**
+ * Quick Context Generation (for LLM efficiency)
+ *
+ * Generates compact component reference data optimized for LLM consumption.
+ * Parametric — uses config for library-specific names.
+ */
+import { getLibraryConfig } from "../config.js";
+import { getAnalyzedEntry, getAvailableComponents, getMetadata } from "../data/metadata.js";
+export function generateQuickContext() {
+    const metadata = getMetadata();
+    const components = getAvailableComponents();
+    const config = getLibraryConfig();
+    const importCheatsheet = {};
+    const importHint = (componentName) => (config.framework ?? "angular") === "react"
+        ? `import { ${componentName.split(".")[0]} } from '${config.packageName}';`
+        : `import { ... } from '${config.packageName}/${componentName}';`;
+    if (metadata.selectorMap) {
+        for (const componentName of components) {
+            importCheatsheet[componentName] = importHint(componentName);
+        }
+        return {
+            version: metadata.version,
+            totalComponents: components.length,
+            selectorMap: metadata.selectorMap,
+            importCheatsheet,
+        };
+    }
+    // Fallback: compute at runtime
+    const selectorMap = {};
+    for (const componentName of components) {
+        const preloaded = getAnalyzedEntry(componentName);
+        if (!preloaded)
+            continue;
+        importCheatsheet[componentName] = importHint(componentName);
+        for (const analysis of preloaded.analysis) {
+            for (const comp of analysis.components) {
+                if (!comp.metadata.selector)
+                    continue;
+                if (comp.metadata.selector.startsWith("test-") || comp.metadata.selector.startsWith("storybook-"))
+                    continue;
+                const sortedInputs = [...comp.inputs].sort((a, b) => {
+                    if (a.required && !b.required)
+                        return -1;
+                    if (!a.required && b.required)
+                        return 1;
+                    return a.name.localeCompare(b.name);
+                });
+                const mainInputs = sortedInputs.slice(0, 5).map((i) => (i.required ? `${i.name}*` : i.name));
+                const mainOutputs = comp.outputs.slice(0, 3).map((o) => o.name);
+                const formControl = comp.inputs.some((i) => i.name === "formControl" || i.name === "formControlName");
+                selectorMap[comp.metadata.selector] = {
+                    component: componentName,
+                    mainInputs,
+                    mainOutputs,
+                    formControl: formControl || undefined,
+                };
+            }
+            for (const dir of analysis.directives || []) {
+                if (!dir.metadata.selector)
+                    continue;
+                const rawSelector = dir.metadata.selector.replace(/[\[\]]/g, "");
+                if (rawSelector.startsWith("test-") || rawSelector.startsWith("storybook-"))
+                    continue;
+                const mainInputs = dir.inputs.slice(0, 5).map((i) => (i.required ? `${i.name}*` : i.name));
+                const mainOutputs = dir.outputs.slice(0, 3).map((o) => o.name);
+                selectorMap[dir.metadata.selector] = {
+                    component: componentName,
+                    mainInputs,
+                    mainOutputs,
+                };
+            }
+        }
+    }
+    return {
+        version: metadata.version,
+        totalComponents: components.length,
+        selectorMap,
+        importCheatsheet,
+    };
+}
+// Memoized per library — the active library can be switched per request
+// (multi-library mode), so a single cache slot would leak contexts across
+// libraries.
+const cachedQuickContexts = new Map();
+export function getQuickContext() {
+    const key = getLibraryConfig().packageName;
+    let ctx = cachedQuickContexts.get(key);
+    if (!ctx) {
+        ctx = generateQuickContext();
+        cachedQuickContexts.set(key, ctx);
+    }
+    return ctx;
+}
+export function formatQuickContextForLLM() {
+    const ctx = getQuickContext();
+    const components = getAvailableComponents();
+    const config = getLibraryConfig();
+    let result = `# ${config.packageName} Quick Reference\n\n`;
+    result += `**${ctx.totalComponents} components available**\n\n`;
+    result += "## CRITICAL RULES\n";
+    result += "1. ONLY use inputs/outputs listed in the table below - do NOT hallucinate props\n";
+    result += "2. Use `validate_template` tool BEFORE returning any template\n";
+    result += "3. Check `get_component` for full API when unsure\n\n";
+    result += "## Selector → Inputs Map\n";
+    result += "(* = required input)\n\n";
+    result += "| Selector | Type | Main Inputs | Outputs | Form | Notes |\n";
+    result += "|----------|------|-------------|---------|------|-------|\n";
+    for (const [selector, info] of Object.entries(ctx.selectorMap)) {
+        const inputs = info.mainInputs.join(", ") || "-";
+        const outputs = info.mainOutputs.join(", ") || "-";
+        const form = info.formControl ? "✓" : "";
+        const notes = [];
+        const type = info.type === "directive" ? "directive" : "component";
+        if (info.hasContentSlots)
+            notes.push("slots");
+        if (info.deprecated)
+            notes.push("deprecated");
+        if (info.configRequired && info.configRequired.length > 0)
+            notes.push(`needs:${info.configRequired.join(",")}`);
+        const notesStr = notes.length > 0 ? notes.join(", ") : "";
+        result += `| \`${selector}\` | ${type} | ${inputs} | ${outputs} | ${form} | ${notesStr} |\n`;
+    }
+    // Directive and pipe tables
+    const directiveRows = [];
+    const pipeRows = [];
+    for (const componentName of components) {
+        const preloaded = getAnalyzedEntry(componentName);
+        if (!preloaded)
+            continue;
+        for (const analysis of preloaded.analysis) {
+            if (analysis.directives) {
+                for (const directive of analysis.directives) {
+                    if (directive.metadata.selector) {
+                        const rawSelector = directive.metadata.selector.replace(/[\[\]]/g, "");
+                        if (rawSelector.startsWith("test-") || rawSelector.startsWith("storybook-"))
+                            continue;
+                        directiveRows.push({
+                            selector: directive.metadata.selector,
+                            component: componentName,
+                            className: directive.className,
+                        });
+                    }
+                }
+            }
+            if (analysis.pipes) {
+                for (const pipe of analysis.pipes) {
+                    pipeRows.push({ pipeName: pipe.pipeName, component: componentName, className: pipe.className });
+                }
+            }
+        }
+    }
+    if (directiveRows.length > 0) {
+        result += "\n## Key Directives\n";
+        result += "| Directive | Component | Class |\n|-----------|-----------|-------|\n";
+        for (const row of directiveRows) {
+            result += `| \`${row.selector}\` | ${row.component} | ${row.className} |\n`;
+        }
+    }
+    if (pipeRows.length > 0) {
+        result += "\n## Available Pipes\n";
+        result += "| Pipe | Component | Class |\n|------|-----------|-------|\n";
+        for (const row of pipeRows) {
+            result += `| \`${row.pipeName}\` | ${row.component} | ${row.className} |\n`;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=context.js.map

package/dist/domain/context.js.map

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

package/dist/domain/formatters.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Component Data Formatters for @cl-mcp/mcp-server
+ *
+ * Transforms raw component metadata into formatted markdown responses
+ * for each detail_level: api, full, examples, types.
+ *
+ * Parametric — no hardcoded library names or import paths.
+ */
+import { type SearchResult } from "./search.js";
+export declare function jsonResponse(data: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function textResponse(text: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function errorResponse(message: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: true;
+};
+export declare function requireComponent(componentName: string): {
+    error: ReturnType<typeof errorResponse>;
+} | {
+    resolved: string;
+    matchedSelector?: string;
+};
+export declare function handleComponentApi(componentName: string, selectorFilter?: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function handleComponentFull(componentName: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function handleComponentExamples(componentName: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function handleComponentTypes(componentName: string, selectorFilter?: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function formatSelectorHints(selectors: string[], match: SearchResult): string;
+export declare function formatSearchResultEntry(match: SearchResult): string;
+export declare function formatSearchFooter(topResults: SearchResult[]): string;
+export declare function handleComponentSearch(query: string, components: string[]): ReturnType<typeof textResponse>;
+export declare function handleComponentListing(components: string[], listAll?: boolean): ReturnType<typeof textResponse>;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/domain/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../src/domain/formatters.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA4BH,OAAO,EAAE,KAAK,YAAY,EAAsC,MAAM,aAAa,CAAC;AAiKpF,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO;;;;;EAEzC;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM;;;;;EAExC;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM;;;;;;EAE5C;AAED,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,MAAM,GACpB;IAAE,KAAK,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAA;CAAE,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,CAkB9F;AAID,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM;;;;;EA2GhF;AAED,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM;;;;;EA6JxD;AAED,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM;;;;;EA6D5D;AAED,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM;;;;;EA4BlF;AAID,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,YAAY,GAAG,MAAM,CAapF;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CA2BnE;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,MAAM,CAQrE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAiB1G;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAwB/G"}