@sky.ui/mcp 0.0.1

package/dist/component-docs-tool.js

@@ -0,0 +1,217 @@
+import { getSkyComponentDocs } from './docs.js';
+import { getSkyComponentDocsEnrichedFromExampleSite } from './example-site-doc-enrichment.js';
+import { McpErrorCode, mcpToolErr } from './mcp-tool-errors.js';
+import { withSkyUiMcpMeta } from './mcp-response-truth.js';
+function extractReplacementHint(text) {
+    if (!text)
+        return null;
+    const patterns = [
+        /use\s+`?([a-z0-9_.-]+)`?\s+instead/i,
+        /replace(?:d)?\s+by\s+`?([a-z0-9_.-]+)`?/i,
+        /migrate\s+to\s+`?([a-z0-9_.-]+)`?/i
+    ];
+    for (const p of patterns) {
+        const m = p.exec(text);
+        if (m?.[1])
+            return m[1];
+    }
+    return null;
+}
+function isDeprecatedText(text) {
+    if (!text)
+        return false;
+    return /\bdeprecated\b/i.test(text);
+}
+export function buildDeprecationsPayload(doc, dataSource) {
+    const componentSignals = [doc.status, doc.summary, ...doc.miscTags.map((t) => `${t.tag}: ${t.text}`)].filter(Boolean);
+    const componentDeprecated = componentSignals.some((t) => isDeprecatedText(t));
+    const componentReplacement = componentSignals.map((t) => extractReplacementHint(t)).find(Boolean) ?? null;
+    const deprecatedProperties = (doc.properties ?? [])
+        .filter((p) => isDeprecatedText(p.description))
+        .map((p) => ({
+        name: p.name,
+        description: p.description ?? null,
+        replacement: extractReplacementHint(p.description ?? undefined)
+    }));
+    const deprecatedEvents = (doc.events ?? [])
+        .filter((e) => isDeprecatedText(e.description))
+        .map((e) => ({
+        name: e.name,
+        description: e.description ?? null,
+        replacement: extractReplacementHint(e.description ?? undefined)
+    }));
+    const deprecatedSlots = (doc.slots ?? [])
+        .filter((s) => isDeprecatedText(s.description))
+        .map((s) => ({
+        name: s.name,
+        description: s.description ?? null,
+        replacement: extractReplacementHint(s.description ?? undefined)
+    }));
+    return {
+        name: doc.name,
+        tagName: doc.tagName,
+        dataSource,
+        component: {
+            deprecated: componentDeprecated,
+            replacement: componentReplacement
+        },
+        members: {
+            properties: deprecatedProperties,
+            events: deprecatedEvents,
+            slots: deprecatedSlots
+        },
+        foundAnyDeprecation: componentDeprecated ||
+            deprecatedProperties.length > 0 ||
+            deprecatedEvents.length > 0 ||
+            deprecatedSlots.length > 0
+    };
+}
+function enrichmentNote(result) {
+    if (result.exampleSitePageAi !== undefined ||
+        result.exampleSiteSections !== undefined ||
+        result.exampleSiteSourceUrl !== undefined) {
+        return 'exampleSitePageAi, exampleSiteSections, and merged events/methods come from the published docs site — verify API facts against your installed @sky.ui/core.';
+    }
+    return undefined;
+}
+function fullDocPayload(result, truncatedExamples) {
+    const { doc, dataSource, exampleSitePageAi, exampleSiteSections, exampleSiteSourceUrl, exampleSiteEnrichmentError } = result;
+    return {
+        schemaVersion: doc.schemaVersion,
+        name: doc.name,
+        tagName: doc.tagName,
+        import: doc.npmImport,
+        element: doc.element,
+        summary: doc.summary,
+        status: doc.status,
+        since: doc.since,
+        documentation: doc.documentation,
+        slots: doc.slots,
+        properties: doc.properties,
+        cssParts: doc.cssParts,
+        events: doc.events,
+        methods: doc.methods,
+        examples: doc.examples,
+        miscTags: doc.miscTags,
+        typeDefinitions: doc.typeDefinitions ?? [],
+        dataSource,
+        ...(doc.rawLeadTrivia !== undefined ? { rawLeadTrivia: doc.rawLeadTrivia } : {}),
+        truncatedExamples,
+        ...(exampleSitePageAi !== undefined ? { exampleSitePageAi } : {}),
+        ...(exampleSiteSections !== undefined ? { exampleSiteSections } : {}),
+        ...(exampleSiteSourceUrl !== undefined ? { exampleSiteSourceUrl } : {}),
+        ...(exampleSiteEnrichmentError !== undefined ? { exampleSiteEnrichmentError } : {})
+    };
+}
+function surfacePayload(result, surface) {
+    const { doc, dataSource, exampleSitePageAi, exampleSiteSections, exampleSiteSourceUrl, exampleSiteEnrichmentError } = result;
+    const base = {
+        surface,
+        name: doc.name,
+        tagName: doc.tagName,
+        dataSource,
+        ...(exampleSitePageAi !== undefined ? { exampleSitePageAi } : {}),
+        ...(exampleSiteSections !== undefined ? { exampleSiteSections } : {}),
+        ...(exampleSiteSourceUrl !== undefined ? { exampleSiteSourceUrl } : {}),
+        ...(exampleSiteEnrichmentError !== undefined ? { exampleSiteEnrichmentError } : {})
+    };
+    if (surface === 'props')
+        return { ...base, properties: doc.properties };
+    if (surface === 'slots')
+        return { ...base, slots: doc.slots };
+    if (surface === 'events')
+        return { ...base, events: doc.events };
+    return { ...base, methods: doc.methods };
+}
+async function loadDocResult(name, options) {
+    const needsEnrichment = !options.surface || options.surface === 'events' || options.surface === 'methods';
+    if (needsEnrichment) {
+        const enriched = await getSkyComponentDocsEnrichedFromExampleSite(name, {
+            maxCharsPerExample: options.maxCharsPerExample,
+            includeRawLead: options.includeRawLead ?? false,
+            includeInternalLifecycleMethods: options.includeInternalLifecycleMethods ?? false
+        });
+        if (!enriched.ok)
+            return enriched;
+        return {
+            ok: true,
+            result: enriched.result,
+            truncatedExamples: enriched.result.truncatedExamples ?? false
+        };
+    }
+    const basic = getSkyComponentDocs(name, {
+        maxCharsPerExample: options.maxCharsPerExample,
+        includeRawLead: options.includeRawLead ?? false,
+        includeInternalLifecycleMethods: options.includeInternalLifecycleMethods ?? false
+    });
+    if (!basic.ok)
+        return basic;
+    return {
+        ok: true,
+        result: {
+            doc: basic.result.doc,
+            dataSource: basic.result.dataSource,
+            truncatedExamples: basic.result.truncatedExamples
+        },
+        truncatedExamples: basic.result.truncatedExamples
+    };
+}
+function jsonContent(payload, enrichment) {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(withSkyUiMcpMeta(payload, 'api_source', enrichment), null, 2)
+            }
+        ]
+    };
+}
+export async function handleGetSkyComponentDocs(input) {
+    const hasName = Boolean(input.name?.trim());
+    const hasNames = Boolean(input.names?.length);
+    if (hasName === hasNames) {
+        return mcpToolErr(McpErrorCode.COMPONENT_DOCS_FAILED, 'Provide exactly one of name (single) or names (batch).');
+    }
+    const options = {
+        maxCharsPerExample: input.max_example_chars === null ? undefined : input.max_example_chars,
+        includeRawLead: input.include_raw_lead ?? false,
+        includeInternalLifecycleMethods: input.include_internal_lifecycle_methods ?? false,
+        surface: input.surface
+    };
+    if (hasNames) {
+        const results = [];
+        for (const rawName of input.names) {
+            const loaded = await loadDocResult(rawName, options);
+            if (!loaded.ok) {
+                results.push({ input: rawName, ok: false, error: loaded.error });
+                continue;
+            }
+            let payload = input.surface
+                ? surfacePayload(loaded.result, input.surface)
+                : fullDocPayload(loaded.result, loaded.truncatedExamples);
+            if (input.include_deprecations) {
+                payload = {
+                    ...payload,
+                    deprecations: buildDeprecationsPayload(loaded.result.doc, loaded.result.dataSource)
+                };
+            }
+            results.push({ input: rawName, ok: true, ...payload });
+        }
+        return jsonContent({ requested: input.names.length, results });
+    }
+    const loaded = await loadDocResult(input.name.trim(), options);
+    if (!loaded.ok) {
+        return mcpToolErr(McpErrorCode.COMPONENT_DOCS_FAILED, loaded.error);
+    }
+    let payload = input.surface
+        ? surfacePayload(loaded.result, input.surface)
+        : fullDocPayload(loaded.result, loaded.truncatedExamples);
+    if (input.include_deprecations) {
+        payload = {
+            ...payload,
+            deprecations: buildDeprecationsPayload(loaded.result.doc, loaded.result.dataSource)
+        };
+    }
+    return jsonContent(payload, enrichmentNote(loaded.result));
+}
+//# sourceMappingURL=component-docs-tool.js.map

package/dist/component-docs-tool.js.map

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

package/dist/component-method-filter.d.ts

@@ -0,0 +1,3 @@
+/** True if this instance method should appear in consumer-facing docs (`get_component_methods`, etc.). */
+export declare function isConsumerFacingComponentMethod(name: string): boolean;
+//# sourceMappingURL=component-method-filter.d.ts.map

package/dist/component-method-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-method-filter.d.ts","sourceRoot":"","sources":["../src/component-method-filter.ts"],"names":[],"mappings":"AA0BA,0GAA0G;AAC1G,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGrE"}

package/dist/component-method-filter.js

@@ -0,0 +1,32 @@
+/**
+ * Names excluded from MCP “public methods” — browser CE / form lifecycle and Lit
+ * ReactiveElement hooks. CEM often omits `privacy` on these; real APIs use `privacy: "public"`.
+ */
+const INTERNAL_COMPONENT_METHOD_NAMES = new Set([
+    'connectedCallback',
+    'disconnectedCallback',
+    'adoptedCallback',
+    'attributeChangedCallback',
+    'formAssociatedCallback',
+    'formDisabledCallback',
+    'formResetCallback',
+    'formStateRestoreCallback',
+    'performUpdate',
+    'scheduleUpdate',
+    'shouldUpdate',
+    'willUpdate',
+    'update',
+    'updated',
+    'firstUpdated',
+    'render',
+    'createRenderRoot',
+    'hasUpdated',
+    'getUpdateComplete'
+]);
+/** True if this instance method should appear in consumer-facing docs (`get_component_methods`, etc.). */
+export function isConsumerFacingComponentMethod(name) {
+    if (!name || name.startsWith('_'))
+        return false;
+    return !INTERNAL_COMPONENT_METHOD_NAMES.has(name);
+}
+//# sourceMappingURL=component-method-filter.js.map

package/dist/component-method-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-method-filter.js","sourceRoot":"","sources":["../src/component-method-filter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,+BAA+B,GAAG,IAAI,GAAG,CAAC;IAC9C,mBAAmB;IACnB,sBAAsB;IACtB,iBAAiB;IACjB,0BAA0B;IAC1B,wBAAwB;IACxB,sBAAsB;IACtB,mBAAmB;IACnB,0BAA0B;IAC1B,eAAe;IACf,gBAAgB;IAChB,cAAc;IACd,YAAY;IACZ,QAAQ;IACR,SAAS;IACT,cAAc;IACd,QAAQ;IACR,kBAAkB;IAClB,YAAY;IACZ,mBAAmB;CACpB,CAAC,CAAC;AAEH,0GAA0G;AAC1G,MAAM,UAAU,+BAA+B,CAAC,IAAY;IAC1D,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAChD,OAAO,CAAC,+BAA+B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACpD,CAAC"}

package/dist/component-tier.d.ts

@@ -0,0 +1,20 @@
+export type SkyComponentTier = 'free' | 'pro';
+export declare const PACKAGE_IMPORTS: {
+    readonly free: {
+        readonly main: "@sky.ui/core";
+        readonly vue: "@sky.ui/vue";
+        readonly react: "@sky.ui/react";
+    };
+    readonly pro: {
+        readonly main: "@sky.ui.pro/core";
+        readonly vue: "@sky.ui.pro/vue";
+        readonly react: "@sky.ui.pro/react";
+    };
+};
+export declare function loadProComponentTags(): Set<string>;
+export declare function componentTier(tag: string): SkyComponentTier;
+export declare function npmMainImport(tag: string, tier?: SkyComponentTier): string;
+export declare function npmVueImport(tag: string, tier?: SkyComponentTier): string;
+export declare function npmReactImport(tag: string, tier?: SkyComponentTier): string;
+export declare function proInstallLine(framework: 'main' | 'vue' | 'react'): string;
+//# sourceMappingURL=component-tier.d.ts.map

package/dist/component-tier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-tier.d.ts","sourceRoot":"","sources":["../src/component-tier.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,KAAK,CAAC;AAE9C,eAAO,MAAM,eAAe;;;;;;;;;;;CAWlB,CAAC;AAgBX,wBAAgB,oBAAoB,IAAI,GAAG,CAAC,MAAM,CAAC,CAclD;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAE3D;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,gBAAqC,GAAG,MAAM,CAE9F;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,gBAAqC,GAAG,MAAM,CAE7F;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,gBAAqC,GAAG,MAAM,CAE/F;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAG1E"}

package/dist/component-tier.js

@@ -0,0 +1,59 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { mcpPackageRoot, packagesDir } from './catalog.js';
+export const PACKAGE_IMPORTS = {
+    free: {
+        main: '@sky.ui/core',
+        vue: '@sky.ui/vue',
+        react: '@sky.ui/react'
+    },
+    pro: {
+        main: '@sky.ui.pro/core',
+        vue: '@sky.ui.pro/vue',
+        react: '@sky.ui.pro/react'
+    }
+};
+let cachedProTags = null;
+function componentTierConfigPath() {
+    const bundled = join(mcpPackageRoot(), 'data', 'component-tier.json');
+    if (existsSync(bundled))
+        return bundled;
+    const monorepo = join(packagesDir(), '..', 'config', 'component-tier.json');
+    if (existsSync(monorepo))
+        return monorepo;
+    return null;
+}
+export function loadProComponentTags() {
+    if (cachedProTags)
+        return cachedProTags;
+    const path = componentTierConfigPath();
+    if (!path) {
+        cachedProTags = new Set();
+        return cachedProTags;
+    }
+    try {
+        const raw = JSON.parse(readFileSync(path, 'utf8'));
+        cachedProTags = new Set(Array.isArray(raw.pro) ? raw.pro : []);
+    }
+    catch {
+        cachedProTags = new Set();
+    }
+    return cachedProTags;
+}
+export function componentTier(tag) {
+    return loadProComponentTags().has(tag) ? 'pro' : 'free';
+}
+export function npmMainImport(tag, tier = componentTier(tag)) {
+    return `${PACKAGE_IMPORTS[tier].main}/${tag}`;
+}
+export function npmVueImport(tag, tier = componentTier(tag)) {
+    return `${PACKAGE_IMPORTS[tier].vue}/${tag}`;
+}
+export function npmReactImport(tag, tier = componentTier(tag)) {
+    return `${PACKAGE_IMPORTS[tier].react}/${tag}`;
+}
+export function proInstallLine(framework) {
+    const pkg = PACKAGE_IMPORTS.pro[framework];
+    return `npm install ${pkg}`;
+}
+//# sourceMappingURL=component-tier.js.map

package/dist/component-tier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-tier.js","sourceRoot":"","sources":["../src/component-tier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAI3D,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE;QACJ,IAAI,EAAE,cAAc;QACpB,GAAG,EAAE,aAAa;QAClB,KAAK,EAAE,eAAe;KACvB;IACD,GAAG,EAAE;QACH,IAAI,EAAE,kBAAkB;QACxB,GAAG,EAAE,iBAAiB;QACtB,KAAK,EAAE,mBAAmB;KAC3B;CACO,CAAC;AAMX,IAAI,aAAa,GAAuB,IAAI,CAAC;AAE7C,SAAS,uBAAuB;IAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,qBAAqB,CAAC,CAAC;IACtE,IAAI,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC;IAC5E,IAAI,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC1C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC;IACxC,MAAM,IAAI,GAAG,uBAAuB,EAAE,CAAC;IACvC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC;QAC1B,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAwB,CAAC;QAC1E,aAAa,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,oBAAoB,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,OAAyB,aAAa,CAAC,GAAG,CAAC;IACpF,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,OAAyB,aAAa,CAAC,GAAG,CAAC;IACnF,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,OAAyB,aAAa,CAAC,GAAG,CAAC;IACrF,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,SAAmC;IAChE,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC3C,OAAO,eAAe,GAAG,EAAE,CAAC;AAC9B,CAAC"}

package/dist/component-usage-tool.d.ts

@@ -0,0 +1,20 @@
+import { type WrapperImportStyle } from './framework-wrappers.js';
+export type ComponentUsageFramework = 'lit' | 'react' | 'vue';
+export type ComponentUsageRequest = {
+    framework: string;
+    name: string;
+    import_style?: WrapperImportStyle;
+};
+export declare function handleGetComponentUsage(input: ComponentUsageRequest): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError: true;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+//# sourceMappingURL=component-usage-tool.d.ts.map

package/dist/component-usage-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-usage-tool.d.ts","sourceRoot":"","sources":["../src/component-usage-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,yBAAyB,CAAC;AAIjC,MAAM,MAAM,uBAAuB,GAAG,KAAK,GAAG,OAAO,GAAG,KAAK,CAAC;AAE9D,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC,CAAC;AAmBF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,qBAAqB;;;;;;;;;;;EAqEnE"}

package/dist/component-usage-tool.js

@@ -0,0 +1,90 @@
+import { loadSkyComponentsCached, resolveComponentEntry } from './catalog.js';
+import { buildFrameworkWrapperDetails, buildUsageSnippetForFramework } from './framework-wrappers.js';
+import { McpErrorCode, mcpToolErr } from './mcp-tool-errors.js';
+import { withSkyUiMcpMeta } from './mcp-response-truth.js';
+function litUsageSnippet(componentInput) {
+    const hitRes = loadSkyComponentsCached();
+    if (!hitRes.ok)
+        return { ok: false, error: hitRes.error };
+    const resolved = resolveComponentEntry(componentInput, hitRes.components);
+    if (!resolved)
+        return { ok: false, error: `Unknown component: ${componentInput}` };
+    const tag = resolved.entry.name;
+    const coreImport = resolved.entry.npmImport;
+    return {
+        ok: true,
+        componentName: tag,
+        npmImport: coreImport,
+        snippet: `import { html, LitElement } from 'lit';\nimport '${coreImport}';\n\nexport class DemoEl extends LitElement {\n  render() {\n    return html\`<${tag}>Hello</${tag}>\`;\n  }\n}`
+    };
+}
+export function handleGetComponentUsage(input) {
+    const fwRaw = input.framework.trim().toLowerCase();
+    let framework;
+    if (['lit', 'litelement', 'core', 'webcomponent', 'webcomponents', 'vanilla'].includes(fwRaw)) {
+        framework = 'lit';
+    }
+    else if (['react', 'reactjs', 'jsx'].includes(fwRaw)) {
+        framework = 'react';
+    }
+    else if (['vue', 'vue3', 'sfc'].includes(fwRaw)) {
+        framework = 'vue';
+    }
+    else {
+        return mcpToolErr(McpErrorCode.USAGE_SNIPPET_INVALID_FRAMEWORK, `Unknown framework: ${input.framework}`, {
+            supported: ['lit', 'react', 'vue']
+        });
+    }
+    if (framework === 'lit') {
+        const lit = litUsageSnippet(input.name);
+        if (!lit.ok) {
+            return mcpToolErr(McpErrorCode.USAGE_SNIPPET_FAILED, lit.error);
+        }
+        const payload = {
+            framework: 'lit',
+            component: lit.componentName,
+            import: lit.npmImport,
+            tagName: lit.componentName,
+            snippet: lit.snippet,
+            note: 'Side-effect import registers the custom element; use the kebab tag in Lit html templates.'
+        };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(withSkyUiMcpMeta(payload, 'api_source'), null, 2) }]
+        };
+    }
+    const style = input.import_style ?? 'per_component';
+    const rich = buildFrameworkWrapperDetails(framework, input.name);
+    if (!rich.ok) {
+        return mcpToolErr(McpErrorCode.COMPONENT_USAGE_FAILED, rich.error);
+    }
+    const snippet = buildUsageSnippetForFramework(framework, input.name, style);
+    if (!snippet.ok) {
+        return mcpToolErr(McpErrorCode.USAGE_SNIPPET_FAILED, snippet.error);
+    }
+    const d = rich.details;
+    const payload = {
+        framework,
+        component: d.componentKebab,
+        tagName: d.vueKebabTagInTemplate,
+        pascalName: d.pascalName,
+        import: d.importPerComponent,
+        importPerComponent: d.importPerComponent,
+        importBarrel: d.importBarrel,
+        primaryImportLine: d.primaryImportLine,
+        importStyle: style,
+        snippet: snippet.snippet,
+        snippets: d.snippets,
+        vueKebabTagInTemplate: d.vueKebabTagInTemplate,
+        conventions: d.conventions,
+        packageVersion: d.packageVersion,
+        peerDependencies: d.peerDependencies,
+        relatedDocs: [
+            'get_sky_component_docs for props, events, slots, and methods',
+            'get_docs packages/mcp/docs/vue-wrapper-v-model.md for Vue v-model patterns'
+        ]
+    };
+    return {
+        content: [{ type: 'text', text: JSON.stringify(withSkyUiMcpMeta(payload, 'api_source'), null, 2) }]
+    };
+}
+//# sourceMappingURL=component-usage-tool.js.map

package/dist/component-usage-tool.js.map

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

package/dist/design-guidelines/a11y-engine.d.ts

@@ -0,0 +1,22 @@
+export declare function getA11yRequirements(input: {
+    component: string;
+}): {
+    ok: true;
+    body: Record<string, unknown>;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function checkColorContrast(input: {
+    foreground: string;
+    background: string;
+    level?: 'AA' | 'AAA';
+    large_text?: boolean;
+}): {
+    ok: true;
+    body: Record<string, unknown>;
+} | {
+    ok: false;
+    error: string;
+};
+//# sourceMappingURL=a11y-engine.d.ts.map

package/dist/design-guidelines/a11y-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y-engine.d.ts","sourceRoot":"","sources":["../../src/design-guidelines/a11y-engine.ts"],"names":[],"mappings":"AAqCA,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAkB7E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAuB7E"}

package/dist/design-guidelines/a11y-engine.js

@@ -0,0 +1,78 @@
+import { loadDesignGuidelines } from './repository.js';
+function normalize(value) {
+    return value.trim().toLowerCase();
+}
+function hexToRgb(hexColor) {
+    const clean = hexColor.trim().replace('#', '');
+    if (!/^[a-fA-F0-9]{3}$|^[a-fA-F0-9]{6}$/.test(clean))
+        return null;
+    const full = clean.length === 3 ? clean.split('').map((c) => c + c).join('') : clean;
+    const num = Number.parseInt(full, 16);
+    return {
+        r: (num >> 16) & 255,
+        g: (num >> 8) & 255,
+        b: num & 255
+    };
+}
+function relativeLuminance({ r, g, b }) {
+    const transform = (channel) => {
+        const c = channel / 255;
+        return c <= 0.03928 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
+    };
+    const R = transform(r);
+    const G = transform(g);
+    const B = transform(b);
+    return 0.2126 * R + 0.7152 * G + 0.0722 * B;
+}
+function contrastRatio(foreground, background) {
+    const l1 = relativeLuminance(foreground);
+    const l2 = relativeLuminance(background);
+    const lighter = Math.max(l1, l2);
+    const darker = Math.min(l1, l2);
+    return (lighter + 0.05) / (darker + 0.05);
+}
+export function getA11yRequirements(input) {
+    const loaded = loadDesignGuidelines();
+    if (!loaded.ok)
+        return { ok: false, error: loaded.error };
+    const guideline = loaded.data.componentsByName.get(normalize(input.component));
+    if (!guideline) {
+        return { ok: false, error: `No guideline entry found for component: ${input.component}` };
+    }
+    return {
+        ok: true,
+        body: {
+            schemaVersion: loaded.data.schemaVersion,
+            component: guideline.name,
+            a11yChecklist: guideline.a11yChecklist,
+            keyboardMap: guideline.keyboardMap,
+            ariaRoles: guideline.ariaRoles,
+            focusRules: guideline.focusRules
+        }
+    };
+}
+export function checkColorContrast(input) {
+    const fg = hexToRgb(input.foreground);
+    const bg = hexToRgb(input.background);
+    if (!fg || !bg) {
+        return { ok: false, error: 'foreground/background must be valid hex colors (#rgb or #rrggbb).' };
+    }
+    const level = input.level ?? 'AA';
+    const largeText = input.large_text ?? false;
+    const ratio = contrastRatio(fg, bg);
+    const requiredRatio = level === 'AAA' ? (largeText ? 4.5 : 7) : largeText ? 3 : 4.5;
+    const passes = ratio >= requiredRatio;
+    return {
+        ok: true,
+        body: {
+            foreground: input.foreground,
+            background: input.background,
+            level,
+            largeText,
+            contrastRatio: Number(ratio.toFixed(2)),
+            requiredRatio,
+            passes
+        }
+    };
+}
+//# sourceMappingURL=a11y-engine.js.map

package/dist/design-guidelines/a11y-engine.js.map

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

package/dist/design-guidelines/compatibility-engine.d.ts

@@ -0,0 +1,20 @@
+export declare function getComponentAntiPatterns(input: {
+    component: string;
+}): {
+    ok: true;
+    body: Record<string, unknown>;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function checkComponentCompatibility(input: {
+    primary: string;
+    secondary: string;
+}): {
+    ok: true;
+    body: Record<string, unknown>;
+} | {
+    ok: false;
+    error: string;
+};
+//# sourceMappingURL=compatibility-engine.d.ts.map

package/dist/design-guidelines/compatibility-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility-engine.d.ts","sourceRoot":"","sources":["../../src/design-guidelines/compatibility-engine.ts"],"names":[],"mappings":"AAMA,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAgB7E;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAgC7E"}