@sky.ui/mcp 0.0.1

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

@@ -0,0 +1,119 @@
+import { loadDesignGuidelines } from './repository.js';
+import { extractThemeVariableNames } from '../source-read.js';
+function tokenize(input) {
+    return input
+        .toLowerCase()
+        .split(/[^a-z0-9-]+/g)
+        .map((t) => t.trim())
+        .filter(Boolean);
+}
+function scoreIntent(semanticIntent, tokens) {
+    const hay = semanticIntent.toLowerCase();
+    let score = 0;
+    for (const token of tokens) {
+        if (hay === token)
+            score += 5;
+        else if (hay.includes(token))
+            score += 2;
+    }
+    return score;
+}
+function rankThemeTokensByIntent(intent, allThemeTokens, limit) {
+    const words = tokenize(intent);
+    const weighted = allThemeTokens
+        .map((token) => {
+        let score = 0;
+        const hay = token.toLowerCase();
+        for (const word of words) {
+            if (hay.includes(word))
+                score += 3;
+        }
+        if (hay.includes('primary') && words.some((w) => ['primary', 'action', 'cta'].includes(w)))
+            score += 4;
+        if (hay.includes('danger') && words.some((w) => ['danger', 'destructive', 'error'].includes(w)))
+            score += 4;
+        if (hay.includes('surface') && words.some((w) => ['surface', 'background', 'subtle'].includes(w)))
+            score += 4;
+        if (hay.includes('text') && words.some((w) => ['text', 'label', 'content'].includes(w)))
+            score += 2;
+        return { token, score };
+    })
+        .filter((row) => row.score > 0)
+        .sort((a, b) => b.score - a.score || a.token.localeCompare(b.token));
+    return weighted.slice(0, limit).map((row) => row.token);
+}
+export function suggestTokensForIntent(input) {
+    const loaded = loadDesignGuidelines();
+    if (!loaded.ok)
+        return { ok: false, error: loaded.error };
+    const intent = input.intent?.trim();
+    if (!intent)
+        return { ok: false, error: 'intent must be a non-empty string.' };
+    const theme = input.theme ?? 'light';
+    const limit = input.limit ?? 5;
+    const tokens = tokenize(intent);
+    const extracted = extractThemeVariableNames(1000);
+    const themeTokens = extracted.ok ? extracted.variables : [];
+    const ranked = loaded.data.raw.tokens
+        .map((row) => ({ row, score: scoreIntent(row.semanticIntent, tokens) }))
+        .filter((row) => row.score > 0)
+        .sort((a, b) => b.score - a.score || a.row.semanticIntent.localeCompare(b.row.semanticIntent))
+        .slice(0, limit)
+        .map((row) => {
+        const fromTheme = rankThemeTokensByIntent(row.row.semanticIntent, themeTokens, Math.max(2, limit));
+        return {
+            semanticIntent: row.row.semanticIntent,
+            score: row.score,
+            suggestedTokens: fromTheme.length > 0 ? fromTheme : row.row.tokenSet[theme],
+            forbiddenCombos: row.row.forbiddenCombos,
+            minContrast: row.row.minContrast,
+            densityMapping: row.row.densityMapping
+        };
+    });
+    return {
+        ok: true,
+        body: {
+            schemaVersion: loaded.data.schemaVersion,
+            intent,
+            theme,
+            sourceOfTruth: 'sky-theme-provider',
+            sourceHint: extracted.ok ? extracted.sourceHint : extracted.error,
+            suggestions: ranked
+        }
+    };
+}
+export function resolveTokenUsage(input) {
+    const loaded = loadDesignGuidelines();
+    if (!loaded.ok)
+        return { ok: false, error: loaded.error };
+    const semanticIntent = input.semantic_intent?.trim();
+    if (!semanticIntent)
+        return { ok: false, error: 'semantic_intent must be a non-empty string.' };
+    const theme = input.theme ?? 'light';
+    const density = (input.density ?? 'comfortable').toLowerCase();
+    const target = loaded.data.raw.tokens.find((row) => row.semanticIntent.toLowerCase() === semanticIntent.toLowerCase());
+    if (!target) {
+        return { ok: false, error: `No token guideline entry found for semantic intent: ${semanticIntent}` };
+    }
+    const extracted = extractThemeVariableNames(1000);
+    const themeTokens = extracted.ok ? extracted.variables : [];
+    const resolvedFromTheme = rankThemeTokensByIntent(target.semanticIntent, themeTokens, 6);
+    return {
+        ok: true,
+        body: {
+            schemaVersion: loaded.data.schemaVersion,
+            semanticIntent: target.semanticIntent,
+            theme,
+            resolvedTokens: resolvedFromTheme.length > 0 ? resolvedFromTheme : target.tokenSet[theme],
+            forbiddenCombos: target.forbiddenCombos,
+            minContrast: target.minContrast,
+            sourceOfTruth: 'sky-theme-provider',
+            sourceHint: extracted.ok ? extracted.sourceHint : extracted.error,
+            density: {
+                requested: density,
+                mapped: target.densityMapping[density] ?? target.densityMapping.comfortable ?? null
+            }
+        }
+    };
+}
+//# sourceMappingURL=token-engine.js.map

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

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

package/dist/docs-read.d.ts

@@ -0,0 +1,28 @@
+/** Human-readable guide for `userTheme` / `ThemeModeConfig` keys (`get_docs`). */
+export declare const THEME_CONFIG_GUIDE_RELATIVE_PATH = "packages/mcp/docs/theme-config-guide.md";
+/** Cross-model routing, token discipline, and improvement checklist (`get_docs`). */
+export declare const CROSS_MODEL_MCP_PLAYBOOK_RELATIVE_PATH = "packages/mcp/docs/cross-model-mcp-playbook.md";
+/** One-block paste prompt for new sessions (`get_docs`). */
+export declare const STARTER_PROMPT_RELATIVE_PATH = "packages/mcp/docs/starter-prompt.md";
+/** Unified checklist for all `/api/mcp/component/{id}` pages (`get_docs`). */
+export declare const AGENT_RECIPE_EXAMPLE_SITE_RELATIVE_PATH = "packages/mcp/docs/agent-recipe-example-site.md";
+/** sky-chart `type` + ECharts-shaped `option` field guide for assistants (`get_docs`). */
+export declare const SKY_CHART_OPTION_API_GUIDE_RELATIVE_PATH = "packages/mcp/docs/sky-chart-option-api.md";
+/** Vue `@sky.ui/vue` wrappers — v-model support and usage patterns (`get_docs`). */
+export declare const VUE_WRAPPER_VMODEL_GUIDE_RELATIVE_PATH = "packages/mcp/docs/vue-wrapper-v-model.md";
+/** Default `max_bytes` when omitted (keeps MCP responses smaller for agent sessions; callers can pass a higher value). */
+export declare const DEFAULT_GET_DOCS_MAX_BYTES = 200000;
+export declare function getDocsPage(path: string, options?: {
+    max_bytes?: number;
+}): {
+    ok: true;
+    path: string;
+    mimeType: string;
+    content: string;
+    truncated: boolean;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function listDocsPaths(): string[];
+//# sourceMappingURL=docs-read.d.ts.map

package/dist/docs-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-read.d.ts","sourceRoot":"","sources":["../src/docs-read.ts"],"names":[],"mappings":"AAQA,kFAAkF;AAClF,eAAO,MAAM,gCAAgC,4CAA4C,CAAC;AAE1F,qFAAqF;AACrF,eAAO,MAAM,sCAAsC,kDAAkD,CAAC;AAEtG,4DAA4D;AAC5D,eAAO,MAAM,4BAA4B,wCAAwC,CAAC;AAElF,8EAA8E;AAC9E,eAAO,MAAM,uCAAuC,mDAAmD,CAAC;AAExG,0FAA0F;AAC1F,eAAO,MAAM,wCAAwC,8CAA8C,CAAC;AAEpG,oFAAoF;AACpF,eAAO,MAAM,sCAAsC,6CAA6C,CAAC;AAsDjG,0HAA0H;AAC1H,eAAO,MAAM,0BAA0B,SAAU,CAAC;AAElD,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA2BlH;AAED,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAExC"}

package/dist/docs-read.js

@@ -0,0 +1,102 @@
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { normalize, relative, resolve } from 'node:path';
+import { packagesDir } from './catalog.js';
+function monorepoRoot() {
+    return resolve(packagesDir(), '..');
+}
+/** Human-readable guide for `userTheme` / `ThemeModeConfig` keys (`get_docs`). */
+export const THEME_CONFIG_GUIDE_RELATIVE_PATH = 'packages/mcp/docs/theme-config-guide.md';
+/** Cross-model routing, token discipline, and improvement checklist (`get_docs`). */
+export const CROSS_MODEL_MCP_PLAYBOOK_RELATIVE_PATH = 'packages/mcp/docs/cross-model-mcp-playbook.md';
+/** One-block paste prompt for new sessions (`get_docs`). */
+export const STARTER_PROMPT_RELATIVE_PATH = 'packages/mcp/docs/starter-prompt.md';
+/** Unified checklist for all `/api/mcp/component/{id}` pages (`get_docs`). */
+export const AGENT_RECIPE_EXAMPLE_SITE_RELATIVE_PATH = 'packages/mcp/docs/agent-recipe-example-site.md';
+/** sky-chart `type` + ECharts-shaped `option` field guide for assistants (`get_docs`). */
+export const SKY_CHART_OPTION_API_GUIDE_RELATIVE_PATH = 'packages/mcp/docs/sky-chart-option-api.md';
+/** Vue `@sky.ui/vue` wrappers — v-model support and usage patterns (`get_docs`). */
+export const VUE_WRAPPER_VMODEL_GUIDE_RELATIVE_PATH = 'packages/mcp/docs/vue-wrapper-v-model.md';
+/**
+ * Allowed doc paths relative to monorepo root (prefix match after normalization).
+ * Keep to markdown under known public docs / fixture READMEs only.
+ */
+const ALLOWED_PREFIXES = [
+    'README.md',
+    'packages/main/README.md',
+    'packages/mcp/README.md',
+    THEME_CONFIG_GUIDE_RELATIVE_PATH,
+    CROSS_MODEL_MCP_PLAYBOOK_RELATIVE_PATH,
+    STARTER_PROMPT_RELATIVE_PATH,
+    AGENT_RECIPE_EXAMPLE_SITE_RELATIVE_PATH,
+    SKY_CHART_OPTION_API_GUIDE_RELATIVE_PATH,
+    VUE_WRAPPER_VMODEL_GUIDE_RELATIVE_PATH,
+    'packages/mcp/docs/example-site-and-mcp-training.md',
+    'packages/mcp/docs/utils-usage-guide.md',
+    'packages/react/README.md',
+    'packages/reactivity/README.md',
+    'packages/vue/README.md',
+    'test/README.md',
+    'test/mcp/README.md',
+    'test/parcel/main/README.md',
+    'test/parcel/react/README.md',
+    'test/parcel/vue/README.md',
+    'test/rolldown/main/README.md',
+    'test/rolldown/react/README.md',
+    'test/rolldown/vue/README.md',
+    'test/rollup/main/README.md',
+    'test/rollup/react/README.md',
+    'test/rollup/vue/README.md',
+    'test/vite/main/README.md',
+    'test/vite/react/README.md',
+    'test/vite/vue/README.md',
+    'test/webpack/main/README.md',
+    'test/webpack/react/README.md',
+    'test/webpack/vue/README.md'
+];
+function normalizeDocPath(input) {
+    let p = input.trim().replace(/^[/\\]+/, '');
+    p = normalize(p).replace(/\\/g, '/');
+    if (p.startsWith('../') || p.includes('/../')) {
+        return '';
+    }
+    return p;
+}
+function isAllowed(relativePath) {
+    if (!relativePath || relativePath.includes('..'))
+        return false;
+    return ALLOWED_PREFIXES.some((pre) => relativePath === pre || relativePath.startsWith(pre + '/'));
+}
+/** Default `max_bytes` when omitted (keeps MCP responses smaller for agent sessions; callers can pass a higher value). */
+export const DEFAULT_GET_DOCS_MAX_BYTES = 200_000;
+export function getDocsPage(path, options) {
+    const maxBytes = options?.max_bytes ?? DEFAULT_GET_DOCS_MAX_BYTES;
+    const root = monorepoRoot();
+    const rel = normalizeDocPath(path);
+    if (!rel) {
+        return { ok: false, error: 'Invalid or unsafe path.' };
+    }
+    if (!isAllowed(rel)) {
+        return {
+            ok: false,
+            error: `Path not allowed. Allowed paths: ${ALLOWED_PREFIXES.join(', ')}`
+        };
+    }
+    const abs = resolve(root, rel);
+    const relToRoot = relative(resolve(root), abs);
+    if (relToRoot.startsWith('..') || relToRoot === '..') {
+        return { ok: false, error: 'Path escapes repository root.' };
+    }
+    if (!existsSync(abs) || !statSync(abs).isFile()) {
+        return { ok: false, error: `Documentation file not found: ${rel}` };
+    }
+    const st = statSync(abs);
+    const raw = readFileSync(abs, 'utf8');
+    const truncated = st.size > maxBytes;
+    const content = truncated ? raw.slice(0, maxBytes) + '\n… [truncated]' : raw;
+    const mime = rel.endsWith('.md') ? 'text/markdown' : 'text/plain';
+    return { ok: true, path: rel, mimeType: mime, content, truncated };
+}
+export function listDocsPaths() {
+    return [...ALLOWED_PREFIXES];
+}
+//# sourceMappingURL=docs-read.js.map

package/dist/docs-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-read.js","sourceRoot":"","sources":["../src/docs-read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,SAAS,YAAY;IACnB,OAAO,OAAO,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,MAAM,gCAAgC,GAAG,yCAAyC,CAAC;AAE1F,qFAAqF;AACrF,MAAM,CAAC,MAAM,sCAAsC,GAAG,+CAA+C,CAAC;AAEtG,4DAA4D;AAC5D,MAAM,CAAC,MAAM,4BAA4B,GAAG,qCAAqC,CAAC;AAElF,8EAA8E;AAC9E,MAAM,CAAC,MAAM,uCAAuC,GAAG,gDAAgD,CAAC;AAExG,0FAA0F;AAC1F,MAAM,CAAC,MAAM,wCAAwC,GAAG,2CAA2C,CAAC;AAEpG,oFAAoF;AACpF,MAAM,CAAC,MAAM,sCAAsC,GAAG,0CAA0C,CAAC;AAEjG;;;GAGG;AACH,MAAM,gBAAgB,GAAG;IACvB,WAAW;IACX,yBAAyB;IACzB,wBAAwB;IACxB,gCAAgC;IAChC,sCAAsC;IACtC,4BAA4B;IAC5B,uCAAuC;IACvC,wCAAwC;IACxC,sCAAsC;IACtC,oDAAoD;IACpD,wCAAwC;IACxC,0BAA0B;IAC1B,+BAA+B;IAC/B,wBAAwB;IACxB,gBAAgB;IAChB,oBAAoB;IACpB,4BAA4B;IAC5B,6BAA6B;IAC7B,2BAA2B;IAC3B,8BAA8B;IAC9B,+BAA+B;IAC/B,6BAA6B;IAC7B,4BAA4B;IAC5B,6BAA6B;IAC7B,2BAA2B;IAC3B,0BAA0B;IAC1B,2BAA2B;IAC3B,yBAAyB;IACzB,6BAA6B;IAC7B,8BAA8B;IAC9B,4BAA4B;CAC7B,CAAC;AAEF,SAAS,gBAAgB,CAAC,KAAa;IACrC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC5C,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACrC,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9C,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,SAAS,CAAC,YAAoB;IACrC,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/D,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,YAAY,KAAK,GAAG,IAAI,YAAY,CAAC,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC;AACpG,CAAC;AAED,0HAA0H;AAC1H,MAAM,CAAC,MAAM,0BAA0B,GAAG,OAAO,CAAC;AAElD,MAAM,UAAU,WAAW,CACzB,IAAY,EACZ,OAAgC;IAEhC,MAAM,QAAQ,GAAG,OAAO,EAAE,SAAS,IAAI,0BAA0B,CAAC;IAClE,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC;IAC5B,MAAM,GAAG,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;IACzD,CAAC;IACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,oCAAoC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SACzE,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC/B,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;IAC/C,IAAI,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACrD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,+BAA+B,EAAE,CAAC;IAC/D,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QAChD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,iCAAiC,GAAG,EAAE,EAAE,CAAC;IACtE,CAAC;IACD,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IACzB,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACtC,MAAM,SAAS,GAAG,EAAE,CAAC,IAAI,GAAG,QAAQ,CAAC;IACrC,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC;IAC7E,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,YAAY,CAAC;IAClE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,CAAC,GAAG,gBAAgB,CAAC,CAAC;AAC/B,CAAC"}

package/dist/docs.d.ts

@@ -0,0 +1,73 @@
+import { type ComponentDocumentation } from './parse-component-ast.js';
+export type { ComponentDocumentation };
+export type SkyComponentDocsOptions = {
+    maxCharsPerExample?: number;
+    includeRawLead?: boolean;
+    /** When false (default), omit browser/Lit lifecycle names from `methods` (consumer API for AI). */
+    includeInternalLifecycleMethods?: boolean;
+};
+export type ComponentDocsResult = {
+    doc: ComponentDocumentation;
+    /** True when one or more @example bodies were truncated */
+    truncatedExamples: boolean;
+    /**
+     * `ast` when TypeScript source was parsed (authoritative); CEM may supplement members missing from AST.
+     * `cem` when only `custom-elements.json` was used (no source file, or AST parse failed).
+     */
+    dataSource: 'cem' | 'ast';
+};
+export declare function getSkyComponentDocs(nameInput: string, options?: SkyComponentDocsOptions): {
+    ok: true;
+    result: ComponentDocsResult;
+} | {
+    ok: false;
+    error: string;
+};
+export type SearchHit = {
+    name: string;
+    npmImport: string;
+    summary: string | null;
+};
+export type ApiSearchHit = {
+    name: string;
+    npmImport: string;
+    summary?: string;
+    score?: number;
+    matched: {
+        properties: string[];
+        events: string[];
+        slots: string[];
+    };
+};
+export declare function searchSkyComponents(query: string, limit: number): {
+    ok: true;
+    hits: SearchHit[];
+} | {
+    ok: false;
+    error: string;
+};
+export declare function searchComponentsByApi(query: string, limit: number): {
+    ok: true;
+    hits: ApiSearchHit[];
+} | {
+    ok: false;
+    error: string;
+};
+export declare function searchComponentsByApiBatch(queries: string[], limitPerQuery: number): {
+    ok: true;
+    results: Array<{
+        query: string;
+        hits: ApiSearchHit[];
+    }>;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function frameworkWrapperImport(framework: 'react' | 'vue', nameInput: string): {
+    ok: true;
+    import: string;
+} | {
+    ok: false;
+    error: string;
+};
+//# sourceMappingURL=docs.d.ts.map

package/dist/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../src/docs.ts"],"names":[],"mappings":"AAYA,OAAO,EAIL,KAAK,sBAAsB,EAC5B,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EAAE,sBAAsB,EAAE,CAAC;AAEvC,MAAM,MAAM,uBAAuB,GAAG;IACpC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mGAAmG;IACnG,+BAA+B,CAAC,EAAE,OAAO,CAAC;CAC3C,CAAC;AAeF,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,sBAAsB,CAAC;IAC5B,2DAA2D;IAC3D,iBAAiB,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,UAAU,EAAE,KAAK,GAAG,KAAK,CAAC;CAC3B,CAAC;AA8JF,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,uBAAuB,GAChC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAG1E;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,KAAK,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;CACH,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,SAAS,EAAE,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAuChI;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,YAAY,EAAE,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA6CnE;AAuBD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EAAE,EACjB,aAAa,EAAE,MAAM,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,YAAY,EAAE,CAAA;KAAE,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAqDtG;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,OAAO,GAAG,KAAK,EAAE,SAAS,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAUjJ"}

package/dist/docs.js

@@ -0,0 +1,323 @@
+import { readFileSync, existsSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import * as ts from 'typescript';
+import { loadSkyComponentsCached, packagesDir, resolveComponentEntry, resolveMainPackageRoot, resolveMainProPackageRoot } from './catalog.js';
+import { getCached } from './cache.js';
+import { declarationToComponentDocumentation, findCemDeclaration, getCemSummaryForTag, isCemManifestPresent } from './cem.js';
+import { collectNamedTypeDefinitions, parseLitComponentDocumentation, parseSummaryOnly } from './parse-component-ast.js';
+import { isConsumerFacingComponentMethod } from './component-method-filter.js';
+function applyMethodsVisibilityFilter(doc, includeInternalLifecycleMethods) {
+    if (includeInternalLifecycleMethods) {
+        return doc;
+    }
+    return {
+        ...doc,
+        methods: doc.methods.filter((m) => isConsumerFacingComponentMethod(m.name))
+    };
+}
+function componentSrcRootCandidates(entry) {
+    const out = [];
+    if (entry.tier === 'pro') {
+        const proRoot = resolveMainProPackageRoot();
+        if (proRoot)
+            out.push(join(proRoot, 'src'));
+        out.push(join(packagesDir(), 'main-pro', 'src'));
+    }
+    else {
+        const mainRoot = resolveMainPackageRoot();
+        if (mainRoot)
+            out.push(join(mainRoot, 'src'));
+        out.push(join(packagesDir(), 'main', 'src'));
+    }
+    return out;
+}
+function componentMainSourcePath(entry) {
+    const rel = join(entry.name, `${entry.name}.ts`);
+    const roots = componentSrcRootCandidates(entry);
+    for (const root of roots) {
+        const p = join(root, rel);
+        if (existsSync(p))
+            return p;
+    }
+    return join(roots[0], rel);
+}
+/** When both AST and CEM exist, keep AST order and values; append CEM-only members (e.g. attribute-only fields). */
+function supplementAstWithUniqueCemMembers(ast, cem) {
+    if (cem.length === 0)
+        return ast;
+    const seen = new Set(ast.map((x) => x.name));
+    const out = [...ast];
+    for (const c of cem) {
+        if (!seen.has(c.name)) {
+            seen.add(c.name);
+            out.push(c);
+        }
+    }
+    return out;
+}
+function getSkyComponentDocsImpl(nameInput, options) {
+    const loaded = loadSkyComponentsCached();
+    if (!loaded.ok) {
+        return { ok: false, error: loaded.error };
+    }
+    const resolved = resolveComponentEntry(nameInput, loaded.components);
+    if (!resolved) {
+        return { ok: false, error: `Unknown component: ${nameInput}` };
+    }
+    const hit = resolved.entry;
+    const sourcePath = componentMainSourcePath(hit);
+    const maxEx = options?.maxCharsPerExample ?? 12_000;
+    const cemHit = findCemDeclaration(hit.name);
+    let raw = null;
+    if (existsSync(sourcePath)) {
+        try {
+            const st = statSync(sourcePath);
+            if (st.size > 600_000) {
+                return { ok: false, error: `Source file too large (${st.size} bytes); skip docs extraction.` };
+            }
+            raw = readFileSync(sourcePath, 'utf8');
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return { ok: false, error: `Failed to read source: ${msg}` };
+        }
+    }
+    const cemDoc = cemHit == null
+        ? null
+        : declarationToComponentDocumentation(hit.name, hit.name, hit.npmImport, cemHit.modulePath, cemHit.declaration, hit.tier === 'pro' ? 'main-pro' : 'main');
+    if (raw) {
+        const parsed = parseLitComponentDocumentation(sourcePath, raw, hit.name, hit.npmImport, {
+            maxCharsPerExample: maxEx
+        });
+        if (parsed.ok) {
+            let doc = { ...parsed.doc, dataSource: 'ast' };
+            if (!options?.includeRawLead) {
+                delete doc.rawLeadTrivia;
+            }
+            if (cemDoc) {
+                doc = {
+                    ...doc,
+                    properties: supplementAstWithUniqueCemMembers(doc.properties, cemDoc.properties),
+                    events: supplementAstWithUniqueCemMembers(doc.events, cemDoc.events),
+                    slots: supplementAstWithUniqueCemMembers(doc.slots, cemDoc.slots),
+                    cssParts: supplementAstWithUniqueCemMembers(doc.cssParts, cemDoc.cssParts),
+                    methods: supplementAstWithUniqueCemMembers(doc.methods, cemDoc.methods),
+                    examples: doc.examples.length > 0 ? doc.examples : cemDoc.examples
+                };
+            }
+            const sf = ts.createSourceFile(sourcePath, raw, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+            const typeDefsFromMerged = collectNamedTypeDefinitions(sf, doc);
+            if (typeDefsFromMerged && typeDefsFromMerged.length > 0) {
+                doc = { ...doc, typeDefinitions: typeDefsFromMerged };
+            }
+            else if (parsed.doc.typeDefinitions && parsed.doc.typeDefinitions.length > 0) {
+                doc = { ...doc, typeDefinitions: parsed.doc.typeDefinitions };
+            }
+            const filteredDoc = applyMethodsVisibilityFilter(doc, options?.includeInternalLifecycleMethods);
+            return {
+                ok: true,
+                result: {
+                    doc: filteredDoc,
+                    truncatedExamples: parsed.truncated,
+                    dataSource: 'ast'
+                }
+            };
+        }
+        if (cemDoc) {
+            const filteredDoc = applyMethodsVisibilityFilter(cemDoc, options?.includeInternalLifecycleMethods);
+            return {
+                ok: true,
+                result: {
+                    doc: filteredDoc,
+                    truncatedExamples: false,
+                    dataSource: 'cem'
+                }
+            };
+        }
+        return { ok: false, error: parsed.error };
+    }
+    if (cemDoc) {
+        const filteredDoc = applyMethodsVisibilityFilter(cemDoc, options?.includeInternalLifecycleMethods);
+        return {
+            ok: true,
+            result: {
+                doc: filteredDoc,
+                truncatedExamples: false,
+                dataSource: 'cem'
+            }
+        };
+    }
+    return {
+        ok: false,
+        error: `No docs source found for ${hit.name}. Needs custom-elements.json (run build:main / build:main-pro) or monorepo source under packages/${hit.tier === 'pro' ? 'main-pro' : 'main'}/src. ` +
+            `Set SKY_UI_CORE${hit.tier === 'pro' ? '_PRO' : ''}_PACKAGE_ROOT to a built package if MCP runs outside the monorepo.`
+    };
+}
+export function getSkyComponentDocs(nameInput, options) {
+    const key = `sky-doc:${nameInput}:${options?.maxCharsPerExample ?? 12_000}:${options?.includeRawLead ? 1 : 0}:${options?.includeInternalLifecycleMethods ? 1 : 0}`;
+    return getCached(key, 45_000, () => getSkyComponentDocsImpl(nameInput, options));
+}
+export function searchSkyComponents(query, limit) {
+    const loaded = loadSkyComponentsCached();
+    if (!loaded.ok) {
+        return { ok: false, error: loaded.error };
+    }
+    const q = query.trim().toLowerCase();
+    if (!q) {
+        return { ok: true, hits: [] };
+    }
+    const tokens = q.split(/\s+/).filter(Boolean);
+    const hits = [];
+    const cem = isCemManifestPresent();
+    for (const c of loaded.components) {
+        const p = componentMainSourcePath(c);
+        let summary = null;
+        if (existsSync(p)) {
+            try {
+                const st = statSync(p);
+                const maxScan = 400_000;
+                const slice = st.size > maxScan ? readFileSync(p, 'utf8').slice(0, maxScan) : readFileSync(p, 'utf8');
+                summary = parseSummaryOnly(p, slice, c.name);
+            }
+            catch {
+                summary = null;
+            }
+        }
+        if (summary == null && cem) {
+            summary = getCemSummaryForTag(c.name);
+        }
+        const hay = `${c.name} ${summary ?? ''}`.toLowerCase();
+        const ok = tokens.every((t) => hay.includes(t));
+        if (ok) {
+            hits.push({ name: c.name, npmImport: c.npmImport, summary });
+        }
+        if (hits.length >= limit) {
+            break;
+        }
+    }
+    return { ok: true, hits };
+}
+export function searchComponentsByApi(query, limit) {
+    const loaded = loadSkyComponentsCached();
+    if (!loaded.ok) {
+        return { ok: false, error: loaded.error };
+    }
+    const q = query.trim().toLowerCase();
+    if (!q) {
+        return { ok: true, hits: [] };
+    }
+    const tokens = q.split(/\s+/).filter(Boolean);
+    const hits = [];
+    for (const c of loaded.components) {
+        const r = getSkyComponentDocs(c.name);
+        if (!r.ok) {
+            continue;
+        }
+        const doc = r.result.doc;
+        const matchedProps = (doc.properties ?? [])
+            .map((p) => p.name)
+            .filter((name) => tokens.every((t) => name.toLowerCase().includes(t)));
+        const matchedEvents = (doc.events ?? [])
+            .map((e) => e.name)
+            .filter((name) => tokens.every((t) => name.toLowerCase().includes(t)));
+        const matchedSlots = (doc.slots ?? [])
+            .map((s) => s.name)
+            .filter((name) => tokens.every((t) => name.toLowerCase().includes(t)));
+        if (matchedProps.length || matchedEvents.length || matchedSlots.length) {
+            hits.push({
+                name: c.name,
+                npmImport: c.npmImport,
+                summary: doc.summary,
+                matched: {
+                    properties: matchedProps,
+                    events: matchedEvents,
+                    slots: matchedSlots
+                }
+            });
+        }
+        if (hits.length >= limit) {
+            break;
+        }
+    }
+    return { ok: true, hits };
+}
+function tokenScore(name, token) {
+    const n = name.toLowerCase();
+    const t = token.toLowerCase();
+    if (n === t)
+        return 6;
+    if (n.startsWith(t))
+        return 4;
+    if (n.includes(t))
+        return 2;
+    return 0;
+}
+function namesScore(names, tokens) {
+    let score = 0;
+    for (const n of names) {
+        let local = 0;
+        for (const t of tokens) {
+            local += tokenScore(n, t);
+        }
+        score += local;
+    }
+    return score;
+}
+export function searchComponentsByApiBatch(queries, limitPerQuery) {
+    const loaded = loadSkyComponentsCached();
+    if (!loaded.ok) {
+        return { ok: false, error: loaded.error };
+    }
+    const results = [];
+    const normalizedQueries = queries.map((q) => q.trim()).filter(Boolean);
+    for (const q of normalizedQueries) {
+        const tokens = q.toLowerCase().split(/\s+/).filter(Boolean);
+        const hits = [];
+        for (const c of loaded.components) {
+            const r = getSkyComponentDocs(c.name);
+            if (!r.ok)
+                continue;
+            const doc = r.result.doc;
+            const matchedProps = (doc.properties ?? [])
+                .map((p) => p.name)
+                .filter((name) => tokens.every((t) => name.toLowerCase().includes(t)));
+            const matchedEvents = (doc.events ?? [])
+                .map((e) => e.name)
+                .filter((name) => tokens.every((t) => name.toLowerCase().includes(t)));
+            const matchedSlots = (doc.slots ?? [])
+                .map((s) => s.name)
+                .filter((name) => tokens.every((t) => name.toLowerCase().includes(t)));
+            if (!(matchedProps.length || matchedEvents.length || matchedSlots.length))
+                continue;
+            const score = namesScore(matchedProps, tokens) * 3 +
+                namesScore(matchedEvents, tokens) * 2 +
+                namesScore(matchedSlots, tokens);
+            hits.push({
+                name: c.name,
+                npmImport: c.npmImport,
+                summary: doc.summary,
+                score,
+                matched: {
+                    properties: matchedProps,
+                    events: matchedEvents,
+                    slots: matchedSlots
+                }
+            });
+        }
+        hits.sort((a, b) => (b.score ?? 0) - (a.score ?? 0) || a.name.localeCompare(b.name));
+        results.push({ query: q, hits: hits.slice(0, limitPerQuery) });
+    }
+    return { ok: true, results };
+}
+export function frameworkWrapperImport(framework, nameInput) {
+    const loaded = loadSkyComponentsCached();
+    if (!loaded.ok) {
+        return { ok: false, error: loaded.error };
+    }
+    const resolved = resolveComponentEntry(nameInput, loaded.components);
+    if (!resolved) {
+        return { ok: false, error: `Unknown component: ${nameInput}` };
+    }
+    return { ok: true, import: `@sky.ui/${framework}/${resolved.entry.name}` };
+}
+//# sourceMappingURL=docs.js.map