@sky.ui/mcp 0.0.1

package/dist/cem.js

@@ -0,0 +1,348 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { createRequire } from 'node:module';
+import { packagesDir, resolveMainPackageRoot, resolveMainProPackageRoot } from './catalog.js';
+function str(v) {
+    return typeof v === 'string' ? v : undefined;
+}
+function cemPathForRoot(mainRoot) {
+    return join(mainRoot, 'dist', 'custom-elements.json');
+}
+function cemPath() {
+    const mainRoot = resolveMainPackageRoot();
+    if (mainRoot) {
+        return cemPathForRoot(mainRoot);
+    }
+    return join(packagesDir(), 'main', 'dist', 'custom-elements.json');
+}
+function cemProPath() {
+    const proRoot = resolveMainProPackageRoot();
+    if (proRoot)
+        return cemPathForRoot(proRoot);
+    const mono = join(packagesDir(), 'main-pro', 'dist', 'custom-elements.json');
+    return existsSync(mono) ? mono : null;
+}
+function resolvePublishedCemPath(packageName) {
+    try {
+        const req = createRequire(import.meta.url);
+        return req.resolve(`${packageName}/custom-elements.json`);
+    }
+    catch {
+        return null;
+    }
+}
+function readCemPackageFromPath(p) {
+    if (!existsSync(p))
+        return null;
+    try {
+        const raw = JSON.parse(readFileSync(p, 'utf8'));
+        if (!raw || !Array.isArray(raw.modules))
+            return null;
+        return raw;
+    }
+    catch {
+        return null;
+    }
+}
+function mergeCemPackages(packages) {
+    const modules = [];
+    for (const pkg of packages) {
+        modules.push(...pkg.modules);
+    }
+    if (modules.length === 0)
+        return null;
+    return { schemaVersion: packages[0]?.schemaVersion ?? '1.0.0', modules };
+}
+function firstAvailableCemPath() {
+    const preferred = cemPath();
+    if (existsSync(preferred))
+        return preferred;
+    const published = resolvePublishedCemPath('@sky.ui/core');
+    if (published && existsSync(published))
+        return published;
+    return null;
+}
+function allAvailableCemPackages() {
+    const out = [];
+    const freePath = firstAvailableCemPath();
+    if (freePath) {
+        const pkg = readCemPackageFromPath(freePath);
+        if (pkg)
+            out.push(pkg);
+    }
+    const proCandidates = [
+        cemProPath(),
+        resolvePublishedCemPath('@sky.ui.pro/core')
+    ].filter((p) => Boolean(p));
+    for (const p of proCandidates) {
+        const pkg = readCemPackageFromPath(p);
+        if (pkg) {
+            out.push(pkg);
+            break;
+        }
+    }
+    return out;
+}
+export function isCemManifestPresent() {
+    return firstAvailableCemPath() != null;
+}
+/** Raw JSON string of the manifest, or null if missing. */
+export function readCustomElementsManifestText() {
+    const p = firstAvailableCemPath();
+    if (!p) {
+        return null;
+    }
+    try {
+        return readFileSync(p, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+export function loadCemPackage() {
+    const merged = mergeCemPackages(allAvailableCemPackages());
+    return merged;
+}
+export function getCemSummaryForTag(tagName) {
+    const hit = findCemDeclaration(tagName);
+    if (!hit) {
+        return null;
+    }
+    const desc = str(hit.declaration.description);
+    if (!desc) {
+        return null;
+    }
+    const line = desc.split('\n').find((l) => l.trim().length > 0);
+    return line?.trim() ?? null;
+}
+export function findCemDeclaration(tagName) {
+    const pkg = loadCemPackage();
+    if (!pkg) {
+        return null;
+    }
+    for (const mod of pkg.modules) {
+        if (!mod.declarations) {
+            continue;
+        }
+        for (const decl of mod.declarations) {
+            if (!decl || typeof decl !== 'object') {
+                continue;
+            }
+            const d = decl;
+            if (d.kind === 'class' && d.customElement === true && d.tagName === tagName) {
+                return { modulePath: mod.path, declaration: d };
+            }
+        }
+    }
+    return null;
+}
+function mapCemMembersToProperties(members) {
+    if (!Array.isArray(members)) {
+        return [];
+    }
+    const out = [];
+    for (const m of members) {
+        if (!m || typeof m !== 'object') {
+            continue;
+        }
+        const row = m;
+        if (row.kind !== 'field') {
+            continue;
+        }
+        /** Static fields (e.g. `dependencies`, `formAssociated`) are not instance props for consumers. */
+        if (row.static === true) {
+            continue;
+        }
+        const privacy = str(row.privacy);
+        if (privacy === 'private' || privacy === 'protected') {
+            continue;
+        }
+        const name = str(row.name);
+        if (!name || name.startsWith('_')) {
+            continue;
+        }
+        let typeStr;
+        if (typeof row.type === 'string') {
+            typeStr = row.type;
+        }
+        else if (row.type && typeof row.type === 'object' && row.type !== null && 'text' in row.type) {
+            typeStr = String(row.type.text);
+        }
+        const description = str(row.description);
+        out.push({ name, type: typeStr, description });
+    }
+    return out;
+}
+function mapCemAttributes(attributes) {
+    if (!Array.isArray(attributes)) {
+        return [];
+    }
+    const out = [];
+    for (const a of attributes) {
+        if (!a || typeof a !== 'object') {
+            continue;
+        }
+        const row = a;
+        if (row.kind !== 'attribute') {
+            continue;
+        }
+        const name = str(row.name);
+        if (!name) {
+            continue;
+        }
+        let typeStr;
+        if (typeof row.type === 'string') {
+            typeStr = row.type;
+        }
+        else if (row.type && typeof row.type === 'object' && row.type !== null && 'text' in row.type) {
+            typeStr = String(row.type.text);
+        }
+        out.push({ name, type: typeStr, description: str(row.description) });
+    }
+    return out;
+}
+function mapCemSlots(slots) {
+    if (!Array.isArray(slots)) {
+        return [];
+    }
+    const out = [];
+    for (const s of slots) {
+        if (!s || typeof s !== 'object') {
+            continue;
+        }
+        const o = s;
+        const name = str(o.name) ?? '';
+        const description = str(o.description);
+        out.push({ name, description });
+    }
+    return out;
+}
+function mapCemEvents(events) {
+    if (!Array.isArray(events)) {
+        return [];
+    }
+    const out = [];
+    for (const e of events) {
+        if (!e || typeof e !== 'object') {
+            continue;
+        }
+        const o = e;
+        const name = str(o.name) ?? str(o.eventName);
+        if (!name) {
+            continue;
+        }
+        let type;
+        if (o.type && typeof o.type === 'object' && 'text' in o.type) {
+            type = str(o.type.text);
+        }
+        else if (typeof o.type === 'string') {
+            type = o.type;
+        }
+        else if (o.type && typeof o.type === 'object') {
+            const t = o.type;
+            type = str(t.text) ?? str(t.name);
+        }
+        out.push({ name, type, description: str(o.description) });
+    }
+    return out;
+}
+function mapCemMethods(members) {
+    if (!Array.isArray(members))
+        return [];
+    const out = [];
+    for (const m of members) {
+        if (!m || typeof m !== 'object')
+            continue;
+        const row = m;
+        if (row.kind !== 'method')
+            continue;
+        if (str(row.privacy) && str(row.privacy) !== 'public')
+            continue;
+        const name = str(row.name);
+        if (!name || name.startsWith('_'))
+            continue;
+        const paramsRaw = Array.isArray(row.parameters) ? row.parameters : [];
+        const params = [];
+        for (const p of paramsRaw) {
+            if (!p || typeof p !== 'object')
+                continue;
+            const pr = p;
+            const pName = str(pr.name);
+            if (!pName)
+                continue;
+            let typeStr;
+            if (typeof pr.type === 'string')
+                typeStr = pr.type;
+            else if (pr.type && typeof pr.type === 'object' && 'text' in pr.type)
+                typeStr = str(pr.type.text);
+            params.push({
+                name: pName,
+                type: typeStr,
+                optional: Boolean(pr.optional)
+            });
+        }
+        let returnType;
+        if (typeof row.return === 'string')
+            returnType = row.return;
+        else if (row.return && typeof row.return === 'object' && 'type' in row.return) {
+            const rt = row.return.type;
+            if (typeof rt === 'string')
+                returnType = rt;
+            else if (rt && typeof rt === 'object' && 'text' in rt)
+                returnType = str(rt.text);
+        }
+        out.push({
+            name,
+            description: str(row.description),
+            params,
+            returns: returnType ? { type: returnType } : undefined
+        });
+    }
+    return out;
+}
+/**
+ * Map a CEM class declaration into the same structured shape the AST path uses,
+ * so MCP clients always see one JSON schema.
+ */
+export function declarationToComponentDocumentation(tagName, componentFolderName, npmImport, modulePath, declaration, sourcePackage = 'main') {
+    const description = str(declaration.description);
+    const members = declaration.members;
+    const attrs = mapCemAttributes(declaration.attributes);
+    const fromMembers = mapCemMembersToProperties(members);
+    const propByName = new Map();
+    for (const p of fromMembers) {
+        propByName.set(p.name, p);
+    }
+    for (const a of attrs) {
+        if (!propByName.has(a.name)) {
+            propByName.set(a.name, a);
+        }
+    }
+    const properties = [...propByName.values()];
+    const slots = mapCemSlots(declaration.slots);
+    const events = mapCemEvents(declaration.events);
+    const methods = mapCemMethods(members);
+    const cssParts = mapCemSlots(declaration.cssParts); // same shape {name, description}
+    return {
+        schemaVersion: 1,
+        dataSource: 'cem',
+        name: componentFolderName,
+        tagName,
+        npmImport,
+        sourceFile: join(packagesDir(), sourcePackage, modulePath),
+        className: str(declaration.name),
+        summary: description,
+        documentation: undefined,
+        status: undefined,
+        since: undefined,
+        element: tagName,
+        slots,
+        properties,
+        cssParts,
+        events,
+        methods,
+        examples: [],
+        miscTags: []
+    };
+}
+//# sourceMappingURL=cem.js.map

package/dist/cem.js.map

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

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

@@ -0,0 +1,20 @@
+import { type WrapperImportStyle } from './framework-wrappers.js';
+export type ChartUsageOperation = 'list_types' | 'get_type' | 'option_guide';
+export type ChartUsageRequest = {
+    operation: 'list_types';
+} | {
+    operation: 'get_type';
+    chart_type: string;
+    framework?: 'lit' | 'react' | 'vue';
+    import_style?: WrapperImportStyle;
+} | {
+    operation: 'option_guide';
+    max_bytes?: number;
+};
+export declare function handleGetChartUsage(input: ChartUsageRequest): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+//# sourceMappingURL=chart-usage-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chart-usage-tool.d.ts","sourceRoot":"","sources":["../src/chart-usage-tool.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiC,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAOjG,MAAM,MAAM,mBAAmB,GAAG,YAAY,GAAG,UAAU,GAAG,cAAc,CAAC;AAE7E,MAAM,MAAM,iBAAiB,GACzB;IAAE,SAAS,EAAE,YAAY,CAAA;CAAE,GAC3B;IAAE,SAAS,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,KAAK,CAAC;IAAC,YAAY,CAAC,EAAE,kBAAkB,CAAA;CAAE,GACrH;IAAE,SAAS,EAAE,cAAc,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAiFtD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB;;;;;EA6E3D"}

package/dist/chart-usage-tool.js

@@ -0,0 +1,153 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { getDocsPage, SKY_CHART_OPTION_API_GUIDE_RELATIVE_PATH } from './docs-read.js';
+import { mcpPackageRoot } from './catalog.js';
+import { buildUsageSnippetForFramework } from './framework-wrappers.js';
+import { McpErrorCode, mcpToolErr } from './mcp-tool-errors.js';
+import { withSkyUiMcpMeta } from './mcp-response-truth.js';
+import { npmMainImport } from './component-tier.js';
+const CHART_CORE_IMPORT = npmMainImport('sky-chart', 'pro');
+let cachedChartApi = null;
+function loadChartApiData() {
+    if (cachedChartApi)
+        return cachedChartApi;
+    const p = join(mcpPackageRoot(), 'data', 'chart-api-sections.json');
+    if (!existsSync(p))
+        return null;
+    try {
+        cachedChartApi = JSON.parse(readFileSync(p, 'utf8'));
+        return cachedChartApi;
+    }
+    catch {
+        return null;
+    }
+}
+function normalizeChartType(input) {
+    const n = input.trim();
+    if (!n)
+        return null;
+    const data = loadChartApiData();
+    const types = data?.types ?? FALLBACK_CHART_TYPES;
+    if (types.includes(n))
+        return n;
+    const lower = n.toLowerCase();
+    const hit = types.find((t) => t.toLowerCase() === lower);
+    return hit ?? null;
+}
+const FALLBACK_CHART_TYPES = [
+    'bar',
+    'line',
+    'pie',
+    'funnel',
+    'scatter',
+    'gauge',
+    'boxplot',
+    'candlestick',
+    'heatmap',
+    'lines',
+    'parallel',
+    'graph',
+    'map',
+    'sunburst',
+    'treemap',
+    'custom',
+    'radar',
+    'sankey',
+    'pictorialBar',
+    'themeRiver',
+    'calendar',
+    'brush',
+    'waterfall'
+];
+function litChartSnippet(type) {
+    return `import { html, LitElement } from 'lit';
+import '@sky.ui.pro/core/sky-chart';
+
+const option = {
+  title: { text: 'My ${type} chart', left: 'center' },
+  series: [{ type: '${type === 'waterfall' ? 'waterfall' : type}', data: [] }]
+};
+
+export class DemoChart extends LitElement {
+  render() {
+    return html\`<sky-chart type="${type === 'waterfall' ? 'bar' : type}" .option=\${option}></sky-chart>\`;
+  }
+}`;
+}
+function jsonText(payload, layer = 'static_reference') {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(withSkyUiMcpMeta(payload, layer), null, 2) }]
+    };
+}
+export function handleGetChartUsage(input) {
+    if (input.operation === 'list_types') {
+        const data = loadChartApiData();
+        const types = data?.types ?? FALLBACK_CHART_TYPES;
+        return jsonText({
+            code: 'OK',
+            component: 'sky-chart',
+            import: CHART_CORE_IMPORT,
+            types,
+            count: types.length,
+            relatedTools: [
+                'get_sky_component_docs with name sky-chart for props, events, and typeDefinitions',
+                'get_chart_usage operation option_guide for root EChartsOption mental model',
+                'get_component_usage for React/Vue wrapper snippets'
+            ],
+            ...(data?.notes ? { notes: data.notes } : {})
+        });
+    }
+    if (input.operation === 'option_guide') {
+        const r = getDocsPage(SKY_CHART_OPTION_API_GUIDE_RELATIVE_PATH, { max_bytes: input.max_bytes });
+        if (!r.ok) {
+            return mcpToolErr(McpErrorCode.DOCS_READ_FAILED, r.error);
+        }
+        return jsonText({
+            code: 'OK',
+            path: r.path,
+            mimeType: r.mimeType,
+            truncated: r.truncated,
+            content: r.content
+        });
+    }
+    const chartType = normalizeChartType(input.chart_type);
+    if (!chartType) {
+        const data = loadChartApiData();
+        return mcpToolErr(McpErrorCode.CHART_USAGE_UNKNOWN_TYPE, `Unknown chart type: ${input.chart_type}`, {
+            knownTypes: data?.types ?? FALLBACK_CHART_TYPES
+        });
+    }
+    const data = loadChartApiData();
+    const hostType = chartType === 'waterfall' ? 'bar' : chartType;
+    const sections = data?.sectionsByType?.[chartType] ?? [];
+    const fw = input.framework ?? 'lit';
+    let snippet;
+    if (fw === 'lit') {
+        snippet = litChartSnippet(chartType);
+    }
+    else {
+        const built = buildUsageSnippetForFramework(fw, 'sky-chart', input.import_style ?? 'per_component');
+        if (!built.ok) {
+            return mcpToolErr(McpErrorCode.USAGE_SNIPPET_FAILED, built.error);
+        }
+        snippet = `${built.snippet}\n\n// Set host type="${hostType}" and bind option (ECharts-shaped object).`;
+    }
+    return jsonText({
+        code: 'OK',
+        chartType,
+        hostType,
+        component: 'sky-chart',
+        import: CHART_CORE_IMPORT,
+        framework: fw,
+        snippet,
+        apiSections: sections,
+        accuracyRules: [
+            'Confirm props and events with get_sky_component_docs(name: sky-chart).',
+            'option is ECharts-shaped JSON — validate untrusted config before binding.',
+            chartType === 'brush'
+                ? 'brush is a range UI: use host start/end (0–100), not a plot renderer.'
+                : `Keep option.series consistent with host type="${hostType}".`
+        ]
+    }, 'api_source');
+}
+//# sourceMappingURL=chart-usage-tool.js.map

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

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

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

@@ -0,0 +1,45 @@
+import type { ComponentDocumentation } from './parse-component-ast.js';
+export type DocSurface = 'props' | 'events' | 'slots' | 'methods';
+export type ComponentDocsRequest = {
+    name?: string;
+    names?: string[];
+    surface?: DocSurface;
+    include_deprecations?: boolean | null;
+    max_example_chars?: number | null;
+    include_raw_lead?: boolean | null;
+    include_internal_lifecycle_methods?: boolean | null;
+};
+export declare function buildDeprecationsPayload(doc: ComponentDocumentation, dataSource: string): {
+    name: string;
+    tagName: string;
+    dataSource: string;
+    component: {
+        deprecated: boolean;
+        replacement: string | null;
+    };
+    members: {
+        properties: {
+            name: string;
+            description: string | null;
+            replacement: string | null;
+        }[];
+        events: {
+            name: string;
+            description: string | null;
+            replacement: string | null;
+        }[];
+        slots: {
+            name: string;
+            description: string | null;
+            replacement: string | null;
+        }[];
+    };
+    foundAnyDeprecation: boolean;
+};
+export declare function handleGetSkyComponentDocs(input: ComponentDocsRequest): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=component-docs-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"component-docs-tool.d.ts","sourceRoot":"","sources":["../src/component-docs-tool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAIvE,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAElE,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,oBAAoB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACtC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,gBAAgB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,kCAAkC,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACrD,CAAC;AAqBF,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;EAgDvF;AAqHD,wBAAsB,yBAAyB,CAAC,KAAK,EAAE,oBAAoB;;;;;GAmD1E"}