@taocompany/magic-grid-mcp 0.0.0-stage → 0.14.0

package/dist/tools/findRecipes.js

@@ -0,0 +1,104 @@
+const STOP = new Set([
+    'a',
+    'an',
+    'the',
+    'and',
+    'or',
+    'to',
+    'for',
+    'with',
+    '的',
+    '与',
+    '和',
+    '表格',
+    'magic',
+    'grid',
+]);
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .split(/[^\p{L}\p{N}_]+/u)
+        .map((t) => t.trim())
+        .filter((t) => t.length > 1 && !STOP.has(t));
+}
+function camelToKebab(name) {
+    return name.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();
+}
+function extractUsedProps(code, knownProps) {
+    const used = [];
+    for (const name of knownProps) {
+        const kebab = camelToKebab(name);
+        const patterns = [
+            new RegExp(`\\b${name}\\b`),
+            new RegExp(`:${name}\\s*=`),
+            new RegExp(`\\b${kebab}\\s*=`),
+            new RegExp(`:${kebab}\\s*=`),
+        ];
+        if (patterns.some((re) => re.test(code))) {
+            used.push(name);
+        }
+    }
+    return used.sort();
+}
+function scoreRecipe(queryTokens, recipe) {
+    const docTokens = tokenize(`${recipe.id} ${recipe.intent} ${recipe.code}`);
+    const docSet = new Set(docTokens);
+    let score = 0;
+    for (const t of queryTokens) {
+        if (docSet.has(t))
+            score += 2;
+        else if (docTokens.some((d) => d.includes(t) || t.includes(d)))
+            score += 1;
+    }
+    if (queryTokens.some((t) => recipe.id.includes(t)))
+        score += 3;
+    return score;
+}
+export function findRecipes(manifest, input) {
+    const limit = Math.min(Math.max(input.limit ?? 3, 1), 5);
+    const recipes = manifest.recipes ?? [];
+    const queryTokens = tokenize(input.intent);
+    if (recipes.length === 0) {
+        return {
+            libraryVersion: manifest.libraryVersion,
+            matches: [],
+            warn: 'manifest 中无 recipes；请升级 @taocompany/magic-grid 并重新 build。',
+        };
+    }
+    if (queryTokens.length === 0) {
+        const fallback = recipes.slice(0, limit);
+        const propNames = new Set(manifest.props.map((p) => p.name));
+        return {
+            libraryVersion: manifest.libraryVersion,
+            matches: fallback.map((r) => ({
+                id: r.id,
+                intent: r.intent,
+                score: 0,
+                code: r.code,
+                propsUsed: extractUsedProps(r.code, propNames),
+            })),
+            warn: 'intent 过短，返回前几条 recipe 作为兜底。',
+        };
+    }
+    const propNames = new Set(manifest.props.map((p) => p.name));
+    const ranked = recipes
+        .map((recipe) => ({
+        recipe,
+        score: scoreRecipe(queryTokens, recipe),
+    }))
+        .filter((r) => r.score > 0)
+        .sort((a, b) => b.score - a.score);
+    const top = ranked.length > 0
+        ? ranked.slice(0, limit)
+        : recipes.slice(0, limit).map((recipe) => ({ recipe, score: 0 }));
+    return {
+        libraryVersion: manifest.libraryVersion,
+        matches: top.map(({ recipe, score }) => ({
+            id: recipe.id,
+            intent: recipe.intent,
+            score,
+            code: recipe.code,
+            propsUsed: extractUsedProps(recipe.code, propNames),
+        })),
+    };
+}

package/dist/tools/getComponentApi.d.ts

@@ -0,0 +1,33 @@
+import type { ResolveManifestResult } from '../types.js';
+export type ComponentApiSection = 'props' | 'emits' | 'slots' | 'api' | 'expose' | 'types' | 'columnDef';
+export interface GetComponentApiInput {
+    section?: ComponentApiSection;
+    names?: string[];
+    query?: string;
+}
+export interface ApiItemBase {
+    name: string;
+    type?: string;
+    default?: string;
+    required?: boolean;
+    notes?: string;
+    signature?: string;
+    payloadType?: string;
+    kind?: string;
+    description?: string;
+}
+export interface GetComponentApiResult {
+    libraryVersion: string;
+    source: 'manifest' | 'package-parse';
+    section: ComponentApiSection;
+    items: ApiItemBase[];
+    total: number;
+    truncated?: boolean;
+    versionMismatch?: {
+        installed: string;
+        manifest: string;
+    };
+    warn?: string;
+}
+export declare function getComponentApi(resolved: ResolveManifestResult, input?: GetComponentApiInput): GetComponentApiResult;
+//# sourceMappingURL=getComponentApi.d.ts.map

package/dist/tools/getComponentApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getComponentApi.d.ts","sourceRoot":"","sources":["../../src/tools/getComponentApi.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAe,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAErE,MAAM,MAAM,mBAAmB,GAC3B,OAAO,GACP,OAAO,GACP,OAAO,GACP,KAAK,GACL,QAAQ,GACR,OAAO,GACP,WAAW,CAAA;AAEf,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,mBAAmB,CAAA;IAC7B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,MAAM,CAAA;IACtB,MAAM,EAAE,UAAU,GAAG,eAAe,CAAA;IACpC,OAAO,EAAE,mBAAmB,CAAA;IAC5B,KAAK,EAAE,WAAW,EAAE,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,eAAe,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;IACzD,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAoFD,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,qBAAqB,EAC/B,KAAK,GAAE,oBAAyB,GAC/B,qBAAqB,CAmDvB"}

package/dist/tools/getComponentApi.js

@@ -0,0 +1,115 @@
+import fs from 'node:fs';
+import path from 'node:path';
+const MAX_OUTPUT_CHARS = 28_000;
+function readInstalledVersion(packageRoot) {
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(packageRoot, 'package.json'), 'utf8'));
+        return pkg.version;
+    }
+    catch {
+        return undefined;
+    }
+}
+function matchesFilter(name, notes, names, query) {
+    if (names && names.length > 0) {
+        const set = new Set(names.map((n) => n.toLowerCase()));
+        if (!set.has(name.toLowerCase()))
+            return false;
+    }
+    if (query && query.trim()) {
+        const q = query.trim().toLowerCase();
+        const hay = `${name} ${notes ?? ''}`.toLowerCase();
+        if (!hay.includes(q))
+            return false;
+    }
+    return true;
+}
+function sectionItems(manifest, section) {
+    switch (section) {
+        case 'props':
+            return manifest.props.map((p) => ({
+                name: p.name,
+                type: p.type,
+                default: p.default,
+                required: p.required,
+                notes: p.notes,
+            }));
+        case 'emits':
+            return (manifest.emits ?? []).map((e) => ({
+                name: e.name,
+                payloadType: e.payloadType,
+                notes: e.notes,
+            }));
+        case 'slots':
+            return (manifest.slots ?? []).map((s) => ({
+                name: s.name,
+                kind: s.kind,
+                description: s.description,
+                notes: s.description,
+            }));
+        case 'api':
+            return (manifest.gridApi ?? []).map((m) => ({
+                name: m.name,
+                signature: m.signature,
+                notes: m.notes,
+            }));
+        case 'expose':
+            return (manifest.expose ?? []).map((e) => ({
+                name: e.name,
+                type: e.type,
+                notes: e.notes,
+            }));
+        case 'columnDef':
+            return manifest.columnDef.map((c) => ({
+                name: c.name,
+                type: c.type,
+                notes: c.notes,
+            }));
+        case 'types':
+            return [];
+        default:
+            return [];
+    }
+}
+export function getComponentApi(resolved, input = {}) {
+    const { manifest, source, packageRoot } = resolved;
+    const section = input.section ?? 'props';
+    const installed = readInstalledVersion(packageRoot);
+    const versionMismatch = installed && installed !== manifest.libraryVersion
+        ? { installed, manifest: manifest.libraryVersion }
+        : undefined;
+    if (section === 'types') {
+        return {
+            libraryVersion: manifest.libraryVersion,
+            source,
+            section,
+            items: [],
+            total: 0,
+            versionMismatch,
+            warn: 'types 分片尚未写入 api-manifest；请使用 section=props|columnDef 与 names/query，或阅读 @taocompany/magic-grid/types/core。',
+        };
+    }
+    const all = sectionItems(manifest, section);
+    const items = all.filter((item) => matchesFilter(item.name, item.notes ?? item.description, input.names, input.query));
+    let payload = {
+        libraryVersion: manifest.libraryVersion,
+        source,
+        section,
+        items,
+        total: items.length,
+        versionMismatch,
+    };
+    let json = JSON.stringify(payload);
+    if (json.length > MAX_OUTPUT_CHARS) {
+        const ratio = MAX_OUTPUT_CHARS / json.length;
+        const keep = Math.max(5, Math.floor(items.length * ratio * 0.9));
+        payload = {
+            ...payload,
+            items: items.slice(0, keep),
+            total: items.length,
+            truncated: true,
+            warn: `结果过大（${items.length} 项）；已截断为 ${keep} 项。请用 names 或 query 缩小范围。`,
+        };
+    }
+    return payload;
+}

package/dist/types.d.ts

@@ -0,0 +1,96 @@
+export interface ManifestRuleMeta {
+    id: string;
+    severity: 'error' | 'warning';
+    autoFix: boolean;
+    detectable?: 'literal-only' | 'heuristic' | 'static';
+}
+export interface CommonMistake {
+    wrong: string;
+    right: string;
+    kind: 'prop' | 'columnDef';
+}
+export interface ManifestProp {
+    name: string;
+    type?: string;
+    default?: string;
+    required?: boolean;
+    notes?: string;
+}
+export interface ManifestEmit {
+    name: string;
+    payloadType?: string;
+    notes?: string;
+}
+export interface ManifestSlot {
+    name: string;
+    kind?: string;
+    description?: string;
+}
+export interface ManifestGridApiMethod {
+    name: string;
+    signature?: string;
+    notes?: string;
+}
+export interface ManifestExposeField {
+    name: string;
+    type?: string;
+    notes?: string;
+}
+export interface ManifestColumnDefField {
+    name: string;
+    type?: string;
+    notes?: string;
+}
+export interface ManifestRecipe {
+    id: string;
+    intent: string;
+    code: string;
+}
+export interface ApiManifest {
+    manifestVersion: number;
+    libraryVersion: string;
+    props: ManifestProp[];
+    emits?: ManifestEmit[];
+    slots?: ManifestSlot[];
+    expose?: ManifestExposeField[];
+    gridApi?: ManifestGridApiMethod[];
+    columnDef: ManifestColumnDefField[];
+    rules: ManifestRuleMeta[];
+    commonMistakes: CommonMistake[];
+    recipes?: ManifestRecipe[];
+}
+export interface ValidationFix {
+    kind: string;
+    from?: string;
+    to?: string;
+}
+export interface ValidationIssue {
+    file: string;
+    line: number;
+    rule: string;
+    severity: 'error' | 'warning';
+    message: string;
+    fix?: ValidationFix;
+}
+export interface UncheckedItem {
+    reason: string;
+    at: string;
+    detail: string;
+}
+export type ValidateScore = 'pass' | 'pass-with-warnings' | 'fail';
+export interface ValidateUsageResult {
+    libraryVersion: string;
+    source: 'manifest' | 'package-parse';
+    manifestPath?: string;
+    errors: ValidationIssue[];
+    unchecked: UncheckedItem[];
+    coverage: number;
+    score: ValidateScore;
+}
+export interface ResolveManifestResult {
+    manifest: ApiManifest;
+    source: 'manifest' | 'package-parse';
+    manifestPath: string;
+    packageRoot: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/validate/propTypeLiteral.d.ts

@@ -0,0 +1,4 @@
+import type { ParsedAttr } from '../scan/parseMagicGrid.js';
+import type { ValidationIssue } from '../types.js';
+export declare function checkPropTypeLiteral(file: string, attr: ParsedAttr, errors: ValidationIssue[]): boolean;
+//# sourceMappingURL=propTypeLiteral.d.ts.map

package/dist/validate/propTypeLiteral.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"propTypeLiteral.d.ts","sourceRoot":"","sources":["../../src/validate/propTypeLiteral.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAoBlD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,eAAe,EAAE,GACxB,OAAO,CAqCT"}

package/dist/validate/propTypeLiteral.js

@@ -0,0 +1,48 @@
+/** 字面量 prop 的枚举/形态校验（v1 · 仅高频误写） */
+const STRING_ENUM_PROPS = {
+    rowSelection: ['single', 'multiple'],
+    size: ['mini', 'small', 'default', 'large'],
+};
+const NUMERIC_PROPS = new Set([
+    'rowHeight',
+    'rowBuffer',
+    'scrollEndFlushMs',
+    'headerHeight',
+    'floatingFiltersHeight',
+]);
+function resolvePropName(name) {
+    return name.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+}
+export function checkPropTypeLiteral(file, attr, errors) {
+    if (attr.isBinding || attr.literalValue === true) {
+        return false;
+    }
+    const value = typeof attr.literalValue === 'string' ? attr.literalValue.trim() : null;
+    if (value === null) {
+        return false;
+    }
+    const propKey = resolvePropName(attr.name);
+    const allowed = STRING_ENUM_PROPS[propKey];
+    if (allowed && !allowed.includes(value)) {
+        errors.push({
+            file,
+            line: attr.line,
+            rule: 'prop-type-literal',
+            severity: 'error',
+            message: `${attr.name}="${value}" 无效，允许值：${allowed.join(' | ')}`,
+            fix: { kind: 'fix-literal', from: value, to: allowed[0] ?? '' },
+        });
+        return true;
+    }
+    if (NUMERIC_PROPS.has(propKey) && value !== '' && Number.isNaN(Number(value))) {
+        errors.push({
+            file,
+            line: attr.line,
+            rule: 'prop-type-literal',
+            severity: 'error',
+            message: `${attr.name} 应为数字字面量，收到 "${value}"`,
+        });
+        return true;
+    }
+    return false;
+}

package/dist/validate/validateUsage.d.ts

@@ -0,0 +1,9 @@
+import type { ResolveManifestResult } from '../resolveManifest.js';
+import type { ValidateUsageResult } from '../types.js';
+interface ValidateOptions {
+    cwd?: string;
+    paths: string[];
+}
+export declare function validateMagicGridUsage(resolved: ResolveManifestResult, options: ValidateOptions): ValidateUsageResult;
+export {};
+//# sourceMappingURL=validateUsage.d.ts.map

package/dist/validate/validateUsage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateUsage.d.ts","sourceRoot":"","sources":["../../src/validate/validateUsage.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAClE,OAAO,KAAK,EAGV,mBAAmB,EAEpB,MAAM,aAAa,CAAA;AAWpB,UAAU,eAAe;IACvB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,EAAE,eAAe,GACvB,mBAAmB,CAmIrB"}