@onemrvapublic/design-system-mcp-server 2.0.1-rc.1

package/dist/metrics.js

@@ -0,0 +1,271 @@
+// In-process usage metrics for hosted-mode KPIs. Kept in memory; persist to a
+// JSON file (MCP_METRICS_FILE) so they survive restarts, and/or scrape /metrics
+// into Prometheus for history.
+const toolStats = new Map();
+const clientStats = new Map();
+// Keyed by lowercased text; the stored entry keeps the first-seen original.
+const questionStats = new Map();
+let totalCalls = 0;
+let totalErrors = 0;
+const QUESTION_INPUT_MAX = 300; // anything longer is a code payload, never record it
+const QUESTION_STORED_MAX = 120;
+const QUESTION_CAP_DEFAULT = 500;
+const TOP_QUESTIONS_LIMIT = 50;
+// Caps on client-controlled label cardinality.
+const MAX_TRACKED_TOOLS = 100;
+const MAX_TRACKED_CLIENTS = 50;
+const LABEL_VALUE_MAX = 120;
+const OVERFLOW_LABEL = '_other';
+let questionCap = QUESTION_CAP_DEFAULT;
+function clampLabel(value) {
+    return value.length > LABEL_VALUE_MAX
+        ? value.slice(0, LABEL_VALUE_MAX)
+        : value;
+}
+// Cap distinct labels; overflow aggregates under "_other".
+function boundedKey(map, key, cap) {
+    if (map.has(key) || map.size < cap) {
+        return key;
+    }
+    return OVERFLOW_LABEL;
+}
+export function recordToolCall(name, durationMs, ok, client) {
+    const now = new Date().toISOString();
+    const toolKey = boundedKey(toolStats, clampLabel(name), MAX_TRACKED_TOOLS);
+    const clientKey = boundedKey(clientStats, clampLabel(client), MAX_TRACKED_CLIENTS);
+    totalCalls += 1;
+    if (!ok) {
+        totalErrors += 1;
+    }
+    let stat = toolStats.get(toolKey);
+    if (!stat) {
+        stat = { calls: 0, errors: 0, totalMs: 0, maxMs: 0, lastUsedAt: null };
+        toolStats.set(toolKey, stat);
+    }
+    stat.calls += 1;
+    if (!ok) {
+        stat.errors += 1;
+    }
+    stat.totalMs += durationMs;
+    if (durationMs > stat.maxMs) {
+        stat.maxMs = durationMs;
+    }
+    stat.lastUsedAt = now;
+    let cli = clientStats.get(clientKey);
+    if (!cli) {
+        cli = { calls: 0, errors: 0, lastSeenAt: null };
+        clientStats.set(clientKey, cli);
+    }
+    cli.calls += 1;
+    if (!ok) {
+        cli.errors += 1;
+    }
+    cli.lastSeenAt = now;
+}
+// Which argument fields carry the human "question" per tool.
+export const QUESTION_FIELDS = {
+    search_components: ['query'],
+    suggest_component: ['description'],
+    get_component: ['name'],
+    get_component_props: ['name'],
+    get_accessibility_info: ['name'],
+    generate_component_usage: ['name'],
+    audit_component: ['name'],
+    get_figma_component: ['name'],
+    get_design_token: ['name'],
+    get_theme_utility: ['name'],
+    get_jsonforms_renderer: ['name'],
+    compare_components: ['nameA', 'nameB'],
+    explain_token_diff: ['tokenA', 'tokenB'],
+};
+function evictColdestQuestion() {
+    let coldestKey = null;
+    let coldest = null;
+    for (const [key, q] of questionStats) {
+        if (!coldest ||
+            q.count < coldest.count ||
+            (q.count === coldest.count && q.lastAskedAt < coldest.lastAskedAt)) {
+            coldest = q;
+            coldestKey = key;
+        }
+    }
+    if (coldestKey !== null) {
+        questionStats.delete(coldestKey);
+    }
+}
+export function recordQuestion(tool, args) {
+    const fields = QUESTION_FIELDS[tool];
+    if (!fields || typeof args !== 'object' || args === null) {
+        return;
+    }
+    const record = args;
+    for (const field of fields) {
+        const value = record[field];
+        if (typeof value !== 'string') {
+            continue;
+        }
+        const trimmed = value.trim();
+        if (!trimmed || trimmed.length > QUESTION_INPUT_MAX) {
+            continue;
+        }
+        const text = trimmed.slice(0, QUESTION_STORED_MAX);
+        const key = text.toLowerCase();
+        const now = new Date().toISOString();
+        const existing = questionStats.get(key);
+        if (existing) {
+            existing.count += 1;
+            existing.lastAskedAt = now;
+            continue;
+        }
+        if (questionStats.size >= questionCap) {
+            evictColdestQuestion();
+        }
+        questionStats.set(key, { text, tool, count: 1, lastAskedAt: now });
+    }
+}
+export function getMetricsSnapshot() {
+    const tools = [...toolStats.entries()]
+        .map(([tool, s]) => ({
+        tool,
+        calls: s.calls,
+        errors: s.errors,
+        avgMs: s.calls > 0 ? Math.round(s.totalMs / s.calls) : 0,
+        maxMs: Math.round(s.maxMs),
+        lastUsedAt: s.lastUsedAt,
+    }))
+        .sort((a, b) => b.calls - a.calls);
+    const clients = [...clientStats.entries()]
+        .map(([client, s]) => ({
+        client,
+        calls: s.calls,
+        errors: s.errors,
+        lastSeenAt: s.lastSeenAt,
+    }))
+        .sort((a, b) => b.calls - a.calls);
+    const topQuestions = [...questionStats.values()]
+        .sort((a, b) => b.count - a.count)
+        .slice(0, TOP_QUESTIONS_LIMIT)
+        .map(q => ({ ...q }));
+    return {
+        totalCalls,
+        totalErrors,
+        distinctTools: toolStats.size,
+        tools,
+        clients,
+        topQuestions,
+    };
+}
+// Prometheus label escaping (backslash before newline/quote).
+function escapeLabel(value) {
+    return value
+        .replace(/\\/g, '\\\\')
+        .replace(/\n/g, '\\n')
+        .replace(/"/g, '\\"');
+}
+// Prometheus exposition. Questions stay JSON-only (unbounded label cardinality).
+export function renderPrometheusMetrics() {
+    const snap = getMetricsSnapshot();
+    const lines = [
+        '# HELP mcp_tool_calls_total Total MCP tool calls handled.',
+        '# TYPE mcp_tool_calls_total counter',
+        `mcp_tool_calls_total ${snap.totalCalls}`,
+        '# HELP mcp_tool_errors_total Total MCP tool calls that returned an error.',
+        '# TYPE mcp_tool_errors_total counter',
+        `mcp_tool_errors_total ${snap.totalErrors}`,
+        '# HELP mcp_tool_call_total Per-tool call count.',
+        '# TYPE mcp_tool_call_total counter',
+    ];
+    for (const t of snap.tools) {
+        const label = `{tool="${escapeLabel(t.tool)}"}`;
+        lines.push(`mcp_tool_call_total${label} ${t.calls}`);
+        lines.push(`mcp_tool_error_total${label} ${t.errors}`);
+        lines.push(`mcp_tool_latency_avg_ms${label} ${t.avgMs}`);
+        lines.push(`mcp_tool_latency_max_ms${label} ${t.maxMs}`);
+    }
+    lines.push('# HELP mcp_client_calls_total Per-IDE/MCP-client tool call count.');
+    lines.push('# TYPE mcp_client_calls_total counter');
+    for (const c of snap.clients) {
+        lines.push(`mcp_client_calls_total{client="${escapeLabel(c.client)}"} ${c.calls}`);
+    }
+    return `${lines.join('\n')}\n`;
+}
+export function serializeMetrics() {
+    return {
+        version: 1,
+        totalCalls,
+        totalErrors,
+        tools: [...toolStats.entries()],
+        clients: [...clientStats.entries()],
+        questions: [...questionStats.entries()],
+    };
+}
+function num(v) {
+    return typeof v === 'number' && Number.isFinite(v) ? v : 0;
+}
+function strOrNull(v) {
+    return typeof v === 'string' ? v : null;
+}
+// Restores state from parsed JSON. Defensive: bad shapes are skipped, not thrown.
+export function loadMetrics(raw) {
+    if (!raw || typeof raw !== 'object') {
+        return false;
+    }
+    const d = raw;
+    if (d.version !== 1) {
+        return false;
+    }
+    toolStats.clear();
+    clientStats.clear();
+    questionStats.clear();
+    totalCalls = num(d.totalCalls);
+    totalErrors = num(d.totalErrors);
+    for (const e of Array.isArray(d.tools) ? d.tools : []) {
+        if (Array.isArray(e) && typeof e[0] === 'string' && e[1]) {
+            const v = e[1];
+            toolStats.set(e[0], {
+                calls: num(v.calls),
+                errors: num(v.errors),
+                totalMs: num(v.totalMs),
+                maxMs: num(v.maxMs),
+                lastUsedAt: strOrNull(v.lastUsedAt),
+            });
+        }
+    }
+    for (const e of Array.isArray(d.clients) ? d.clients : []) {
+        if (Array.isArray(e) && typeof e[0] === 'string' && e[1]) {
+            const v = e[1];
+            clientStats.set(e[0], {
+                calls: num(v.calls),
+                errors: num(v.errors),
+                lastSeenAt: strOrNull(v.lastSeenAt),
+            });
+        }
+    }
+    for (const e of Array.isArray(d.questions) ? d.questions : []) {
+        if (Array.isArray(e) && typeof e[0] === 'string' && e[1]) {
+            const v = e[1];
+            if (typeof v.text === 'string' && typeof v.tool === 'string') {
+                questionStats.set(e[0], {
+                    text: v.text,
+                    tool: v.tool,
+                    count: num(v.count),
+                    lastAskedAt: strOrNull(v.lastAskedAt) ?? new Date().toISOString(),
+                });
+            }
+        }
+    }
+    return true;
+}
+// Test-only hooks.
+export function __resetMetrics() {
+    toolStats.clear();
+    clientStats.clear();
+    questionStats.clear();
+    totalCalls = 0;
+    totalErrors = 0;
+    questionCap = QUESTION_CAP_DEFAULT;
+}
+export function __setQuestionCapForTests(cap) {
+    questionCap = cap;
+}
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,gFAAgF;AAChF,+BAA+B;AAuB/B,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;AAC9C,MAAM,WAAW,GAAG,IAAI,GAAG,EAAsB,CAAC;AAClD,4EAA4E;AAC5E,MAAM,aAAa,GAAG,IAAI,GAAG,EAAwB,CAAC;AACtD,IAAI,UAAU,GAAG,CAAC,CAAC;AACnB,IAAI,WAAW,GAAG,CAAC,CAAC;AAEpB,MAAM,kBAAkB,GAAG,GAAG,CAAC,CAAC,qDAAqD;AACrF,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAChC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AACjC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAC/B,+CAA+C;AAC/C,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAC9B,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAC/B,MAAM,eAAe,GAAG,GAAG,CAAC;AAC5B,MAAM,cAAc,GAAG,QAAQ,CAAC;AAChC,IAAI,WAAW,GAAG,oBAAoB,CAAC;AAEvC,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,KAAK,CAAC,MAAM,GAAG,eAAe;QACnC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC;QACjC,CAAC,CAAC,KAAK,CAAC;AACZ,CAAC;AAED,2DAA2D;AAC3D,SAAS,UAAU,CAAI,GAAmB,EAAE,GAAW,EAAE,GAAW;IAClE,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC;QACnC,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,UAAkB,EAClB,EAAW,EACX,MAAc;IAEd,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,iBAAiB,CAAC,CAAC;IAC3E,MAAM,SAAS,GAAG,UAAU,CAC1B,WAAW,EACX,UAAU,CAAC,MAAM,CAAC,EAClB,mBAAmB,CACpB,CAAC;IAEF,UAAU,IAAI,CAAC,CAAC;IAChB,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,WAAW,IAAI,CAAC,CAAC;IACnB,CAAC;IAED,IAAI,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;QACvE,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;IAChB,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,IAAI,CAAC,OAAO,IAAI,UAAU,CAAC;IAC3B,IAAI,UAAU,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC;IAC1B,CAAC;IACD,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC;IAEtB,IAAI,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,GAAG,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;QAChD,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAClC,CAAC;IACD,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC;IACf,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;IAClB,CAAC;IACD,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;AACvB,CAAC;AAED,6DAA6D;AAC7D,MAAM,CAAC,MAAM,eAAe,GAAsC;IAChE,iBAAiB,EAAE,CAAC,OAAO,CAAC;IAC5B,iBAAiB,EAAE,CAAC,aAAa,CAAC;IAClC,aAAa,EAAE,CAAC,MAAM,CAAC;IACvB,mBAAmB,EAAE,CAAC,MAAM,CAAC;IAC7B,sBAAsB,EAAE,CAAC,MAAM,CAAC;IAChC,wBAAwB,EAAE,CAAC,MAAM,CAAC;IAClC,eAAe,EAAE,CAAC,MAAM,CAAC;IACzB,mBAAmB,EAAE,CAAC,MAAM,CAAC;IAC7B,gBAAgB,EAAE,CAAC,MAAM,CAAC;IAC1B,iBAAiB,EAAE,CAAC,MAAM,CAAC;IAC3B,sBAAsB,EAAE,CAAC,MAAM,CAAC;IAChC,kBAAkB,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC;IACtC,kBAAkB,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;CACzC,CAAC;AAEF,SAAS,oBAAoB;IAC3B,IAAI,UAAU,GAAkB,IAAI,CAAC;IACrC,IAAI,OAAO,GAAwB,IAAI,CAAC;IAExC,KAAK,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,aAAa,EAAE,CAAC;QACrC,IACE,CAAC,OAAO;YACR,CAAC,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK;YACvB,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,EAClE,CAAC;YACD,OAAO,GAAG,CAAC,CAAC;YACZ,UAAU,GAAG,GAAG,CAAC;QACnB,CAAC;IACH,CAAC;IAED,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,aAAa,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACnC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,IAAa;IACxD,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,MAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QACzD,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,IAA+B,CAAC;IAC/C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,SAAS;QACX,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,kBAAkB,EAAE,CAAC;YACpD,SAAS;QACX,CAAC;QAED,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAExC,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC;YACpB,QAAQ,CAAC,WAAW,GAAG,GAAG,CAAC;YAC3B,SAAS;QACX,CAAC;QAED,IAAI,aAAa,CAAC,IAAI,IAAI,WAAW,EAAE,CAAC;YACtC,oBAAoB,EAAE,CAAC;QACzB,CAAC;QACD,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAkCD,MAAM,UAAU,kBAAkB;IAChC,MAAM,KAAK,GAAgB,CAAC,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;SAChD,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACnB,IAAI;QACJ,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,KAAK,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;QAC1B,UAAU,EAAE,CAAC,CAAC,UAAU;KACzB,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAErC,MAAM,OAAO,GAAkB,CAAC,GAAG,WAAW,CAAC,OAAO,EAAE,CAAC;SACtD,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrB,MAAM;QACN,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,UAAU,EAAE,CAAC,CAAC,UAAU;KACzB,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAErC,MAAM,YAAY,GAAoB,CAAC,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC;SAC9D,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;SACjC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC;SAC7B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAExB,OAAO;QACL,UAAU;QACV,WAAW;QACX,aAAa,EAAE,SAAS,CAAC,IAAI;QAC7B,KAAK;QACL,OAAO;QACP,YAAY;KACb,CAAC;AACJ,CAAC;AAED,8DAA8D;AAC9D,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,KAAK;SACT,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;SACtB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,uBAAuB;IACrC,MAAM,IAAI,GAAG,kBAAkB,EAAE,CAAC;IAClC,MAAM,KAAK,GAAa;QACtB,2DAA2D;QAC3D,qCAAqC;QACrC,wBAAwB,IAAI,CAAC,UAAU,EAAE;QACzC,2EAA2E;QAC3E,sCAAsC;QACtC,yBAAyB,IAAI,CAAC,WAAW,EAAE;QAC3C,iDAAiD;QACjD,oCAAoC;KACrC,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,UAAU,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,sBAAsB,KAAK,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,uBAAuB,KAAK,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACvD,KAAK,CAAC,IAAI,CAAC,0BAA0B,KAAK,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,0BAA0B,KAAK,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,IAAI,CACR,mEAAmE,CACpE,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACpD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CACR,kCAAkC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,CACvE,CAAC;IACJ,CAAC;IAED,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC;AAYD,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,OAAO,EAAE,CAAC;QACV,UAAU;QACV,WAAW;QACX,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;QAC/B,OAAO,EAAE,CAAC,GAAG,WAAW,CAAC,OAAO,EAAE,CAAC;QACnC,SAAS,EAAE,CAAC,GAAG,aAAa,CAAC,OAAO,EAAE,CAAC;KACxC,CAAC;AACJ,CAAC;AAED,SAAS,GAAG,CAAC,CAAU;IACrB,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC;AACD,SAAS,SAAS,CAAC,CAAU;IAC3B,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1C,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,CAAC,GAAG,GAAgC,CAAC;IAC3C,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,SAAS,CAAC,KAAK,EAAE,CAAC;IAClB,WAAW,CAAC,KAAK,EAAE,CAAC;IACpB,aAAa,CAAC,KAAK,EAAE,CAAC;IACtB,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAC/B,WAAW,GAAG,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAEjC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACtD,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAa,CAAC;YAC3B,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;gBAClB,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;gBACnB,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;gBACrB,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;gBACvB,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;gBACnB,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;aACpC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC1D,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAe,CAAC;YAC7B,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;gBACpB,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;gBACnB,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;gBACrB,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;aACpC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC9D,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAiB,CAAC;YAC/B,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7D,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;oBACtB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;oBACnB,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBAClE,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mBAAmB;AACnB,MAAM,UAAU,cAAc;IAC5B,SAAS,CAAC,KAAK,EAAE,CAAC;IAClB,WAAW,CAAC,KAAK,EAAE,CAAC;IACpB,aAAa,CAAC,KAAK,EAAE,CAAC;IACtB,UAAU,GAAG,CAAC,CAAC;IACf,WAAW,GAAG,CAAC,CAAC;IAChB,WAAW,GAAG,oBAAoB,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,GAAW;IAClD,WAAW,GAAG,GAAG,CAAC;AACpB,CAAC"}

package/dist/migration-rules.d.ts

@@ -0,0 +1,29 @@
+export type MigrationConfidence = 'full' | 'partial' | 'manual';
+export type MigrationMode = 'replace' | 'keep' | 'augment';
+export interface MigrationRule {
+    id: string;
+    description: string;
+    detect: RegExp;
+    confidence: MigrationConfidence;
+    dsSelector?: string;
+    keepDirective?: boolean;
+    module: string;
+    package: string;
+    attrNotes?: string[];
+    breakingNotes?: string[];
+    snippet: string;
+    figmaPage?: string;
+}
+export interface RepoMigrationPattern {
+    id: string;
+    detect: RegExp;
+    dsSelector: string;
+    confidence: MigrationConfidence;
+    recommendation: string;
+    migrationMode?: MigrationMode;
+}
+export declare function getRepoDetect(id: string): RegExp;
+export declare function getMigrateRules(dsInputs: (selector: string) => string): MigrationRule[];
+export declare function getRepoMigrationPatterns(): RepoMigrationPattern[];
+export declare function blankComments(text: string, syntax?: 'html' | 'code'): string;
+export declare function extractInlineTemplate(tsCode: string): string | undefined;