@mp3wizard/figma-console-mcp 1.14.0

package/dist/apps/design-system-dashboard/scoring/engine.js

@@ -0,0 +1,93 @@
+/**
+ * Design System Health Dashboard — Scoring Engine
+ *
+ * Main orchestrator that runs all 6 category scorers against raw Figma data
+ * and produces a Lighthouse-style health score.
+ *
+ * Data flow:
+ *   DesignSystemRawData → scoreDesignSystem() → DashboardData (JSON)
+ */
+import { scoreAccessibility } from "./accessibility.js";
+import { classifyComponents, scoreComponentMetadata, } from "./component-metadata.js";
+import { scoreConsistency } from "./consistency.js";
+import { scoreCoverage } from "./coverage.js";
+import { scoreNamingSemantics } from "./naming-semantics.js";
+import { scoreTokenArchitecture } from "./token-architecture.js";
+import { getStatus } from "./types.js";
+/**
+ * Collect actionable findings from scored categories.
+ * Returns up to 5 human-readable strings from the worst findings,
+ * prioritizing "fail" severity, then "warning", sorted by score ascending.
+ */
+function generateSummary(categories) {
+    const actionableFindings = [];
+    for (const category of categories) {
+        for (const finding of category.findings) {
+            if (finding.severity === "fail" || finding.severity === "warning") {
+                actionableFindings.push({
+                    ...finding,
+                    categoryLabel: category.label,
+                });
+            }
+        }
+    }
+    // Sort: fail before warning, then by score ascending (worst first)
+    actionableFindings.sort((a, b) => {
+        const severityOrder = { fail: 0, warning: 1, pass: 2, info: 3 };
+        const aSev = severityOrder[a.severity];
+        const bSev = severityOrder[b.severity];
+        if (aSev !== bSev)
+            return aSev - bSev;
+        return a.score - b.score;
+    });
+    return actionableFindings
+        .slice(0, 5)
+        .map((f) => `[${f.categoryLabel}] ${f.label}: ${f.details ?? "Needs improvement."}`);
+}
+/**
+ * Score a design system's health from raw Figma data.
+ *
+ * Runs all 6 category scorers and produces a weighted overall score.
+ * Category weights sum to 1.0:
+ *   - Naming & Semantics:   0.20
+ *   - Token Architecture:   0.20
+ *   - Component Metadata:   0.20
+ *   - Accessibility:        0.15
+ *   - Consistency:          0.15
+ *   - Coverage:             0.10
+ *
+ * @param data - Raw Figma data (variables, collections, components, styles)
+ * @returns Complete dashboard payload with overall score, categories, and summary
+ */
+export function scoreDesignSystem(data) {
+    const categories = [
+        scoreNamingSemantics(data),
+        scoreTokenArchitecture(data),
+        scoreComponentMetadata(data),
+        scoreAccessibility(data),
+        scoreConsistency(data),
+        scoreCoverage(data),
+    ];
+    const overall = Math.round(categories.reduce((sum, c) => sum + c.score * c.weight, 0));
+    const summary = generateSummary(categories);
+    const classification = classifyComponents(data);
+    return {
+        overall,
+        status: getStatus(overall),
+        categories,
+        summary,
+        meta: {
+            componentCount: data.components.length,
+            variableCount: data.variables.length,
+            collectionCount: data.collections.length,
+            styleCount: data.styles.length,
+            componentSetCount: data.componentSets.length,
+            standaloneCount: classification.standalone.length,
+            variantCount: classification.variants.length,
+            timestamp: Date.now(),
+        },
+        fileInfo: data.fileInfo,
+        dataAvailability: data.dataAvailability,
+    };
+}
+//# sourceMappingURL=engine.js.map

package/dist/apps/design-system-dashboard/scoring/engine.js.map

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

package/dist/apps/design-system-dashboard/scoring/naming-semantics.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Naming & Semantics Scorer (weight: 0.20)
+ *
+ * Checks whether design system names describe intent rather than appearance.
+ * Evaluates variable naming, component naming, variant naming, and boolean
+ * naming conventions against semantic best practices.
+ */
+import type { CategoryScore, DesignSystemRawData } from "./types.js";
+/**
+ * Naming & Semantics category scorer.
+ * Returns the average score across all naming checks.
+ */
+export declare function scoreNamingSemantics(data: DesignSystemRawData): CategoryScore;
+//# sourceMappingURL=naming-semantics.d.ts.map

package/dist/apps/design-system-dashboard/scoring/naming-semantics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming-semantics.d.ts","sourceRoot":"","sources":["../../../../src/apps/design-system-dashboard/scoring/naming-semantics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAW,MAAM,YAAY,CAAC;AAoV9E;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,aAAa,CAoB7E"}

package/dist/apps/design-system-dashboard/scoring/naming-semantics.js

@@ -0,0 +1,309 @@
+/**
+ * Naming & Semantics Scorer (weight: 0.20)
+ *
+ * Checks whether design system names describe intent rather than appearance.
+ * Evaluates variable naming, component naming, variant naming, and boolean
+ * naming conventions against semantic best practices.
+ */
+import { buildCollectionNameMap, clamp, getSeverity } from "./types.js";
+/** Maximum examples to include in a finding. */
+const MAX_EXAMPLES = 5;
+/** Color words that indicate visual (non-semantic) naming. */
+const VISUAL_COLOR_WORDS = [
+    "red",
+    "blue",
+    "green",
+    "yellow",
+    "orange",
+    "purple",
+    "pink",
+    "black",
+    "white",
+    "gray",
+    "grey",
+    "cyan",
+    "magenta",
+    "teal",
+    "indigo",
+    "violet",
+    "brown",
+    "lime",
+    "amber",
+    "emerald",
+    "rose",
+    "sky",
+    "slate",
+    "zinc",
+    "stone",
+    "neutral",
+];
+/** Visual variant values that should be replaced with semantic ones. */
+const VISUAL_VARIANT_VALUES = [
+    "red",
+    "blue",
+    "green",
+    "yellow",
+    "orange",
+    "purple",
+    "pink",
+    "black",
+    "white",
+    "gray",
+    "grey",
+    "cyan",
+];
+/** Semantic variant values that indicate good naming. */
+const SEMANTIC_VARIANT_VALUES = [
+    "primary",
+    "secondary",
+    "tertiary",
+    "danger",
+    "warning",
+    "success",
+    "info",
+    "error",
+    "disabled",
+    "default",
+    "accent",
+    "muted",
+    "destructive",
+    "outline",
+    "ghost",
+    "link",
+];
+const PASCAL_CASE_RE = /^[A-Z][a-zA-Z0-9]*$/;
+const BOOLEAN_PREFIX_RE = /^(is|has|can|should|will|did|was|with|show|hide|enable|disable)/i;
+/**
+ * Extract the leaf segment from a variable name.
+ * e.g. "color/action/primary" -> "primary", "color.blue.500" -> "500"
+ */
+function getLeafName(name) {
+    const parts = name.split(/[/.]/);
+    return parts[parts.length - 1];
+}
+/**
+ * Check if a name contains visual color words in its leaf segments.
+ */
+function containsVisualColorWord(name) {
+    const leaf = getLeafName(name).toLowerCase();
+    return VISUAL_COLOR_WORDS.some((word) => leaf === word || leaf.startsWith(`${word}-`));
+}
+/**
+ * Score variable naming for semantic quality.
+ * Variables should use semantic names (color.action.primary) rather than
+ * visual names (color.blue.500).
+ */
+function scoreVariableNaming(data) {
+    const colorVars = data.variables.filter((v) => v.resolvedType === "COLOR");
+    if (colorVars.length === 0) {
+        return {
+            id: "naming-variable-semantic",
+            label: "Variable naming",
+            score: 100,
+            severity: "info",
+            tooltip: "Variables should describe intent (e.g. color/action/primary) rather than appearance (e.g. color/blue/500). Semantic names survive theme changes.",
+            details: "No color variables to evaluate.",
+        };
+    }
+    const collectionNames = buildCollectionNameMap(data.collections);
+    const visualVars = colorVars.filter((v) => containsVisualColorWord(v.name));
+    const semanticRatio = 1 - visualVars.length / colorVars.length;
+    const score = clamp(semanticRatio * 100);
+    return {
+        id: "naming-variable-semantic",
+        label: "Variable naming",
+        score,
+        severity: getSeverity(score),
+        tooltip: "Variables should describe intent (e.g. color/action/primary) rather than appearance (e.g. color/blue/500). Semantic names survive theme changes.",
+        details: visualVars.length > 0
+            ? `${visualVars.length} of ${colorVars.length} color variables use visual names instead of semantic names.`
+            : `All ${colorVars.length} color variables use semantic names.`,
+        examples: visualVars.length > 0
+            ? visualVars.slice(0, MAX_EXAMPLES).map((v) => v.name)
+            : undefined,
+        locations: visualVars.length > 0
+            ? visualVars.slice(0, MAX_EXAMPLES).map((v) => ({
+                name: v.name,
+                collection: collectionNames.get(v.variableCollectionId),
+                type: "variable",
+            }))
+            : undefined,
+    };
+}
+/**
+ * Score component naming for consistency.
+ * Components should use PascalCase and avoid mixed abbreviations.
+ */
+function scoreComponentNaming(data) {
+    const components = data.components;
+    if (components.length === 0) {
+        return {
+            id: "naming-component-casing",
+            label: "Component naming",
+            score: 100,
+            severity: "info",
+            tooltip: "Component names should use consistent PascalCase (e.g. Button, IconStar). Consistent casing improves discoverability.",
+            details: "No components to evaluate.",
+        };
+    }
+    let pascalCount = 0;
+    const nonPascalComps = [];
+    for (const comp of components) {
+        // Component names may use path separators; check each segment
+        const segments = comp.name.split("/").map((s) => s.trim());
+        const allPascal = segments.every((seg) => PASCAL_CASE_RE.test(seg));
+        if (allPascal) {
+            pascalCount++;
+        }
+        else {
+            nonPascalComps.push(comp.name);
+        }
+    }
+    const ratio = pascalCount / components.length;
+    const score = clamp(ratio * 100);
+    return {
+        id: "naming-component-casing",
+        label: "Component naming",
+        score,
+        severity: getSeverity(score),
+        tooltip: "Component names should use consistent PascalCase (e.g. Button, IconStar). Consistent casing improves discoverability.",
+        details: `${pascalCount} of ${components.length} components use consistent PascalCase naming.`,
+        examples: nonPascalComps.length > 0
+            ? nonPascalComps.slice(0, MAX_EXAMPLES)
+            : undefined,
+    };
+}
+/**
+ * Score variant naming for semantic quality.
+ * Variant values should be semantic (primary, danger) rather than
+ * visual (blue, red). Also checks for consistent size naming.
+ */
+function scoreVariantNaming(data) {
+    // Components with variants have a componentSetId (Plugin API),
+    // containing_frame.containingComponentSet (REST API), or component_set_id (file JSON)
+    const variantComponents = data.components.filter((c) => c.componentSetId ||
+        c.containing_frame?.containingComponentSet ||
+        c.component_set_id);
+    if (variantComponents.length === 0) {
+        return {
+            id: "naming-variant-semantic",
+            label: "Variant naming",
+            score: 100,
+            severity: "info",
+            tooltip: "Variant values should use semantic terms (primary, danger) rather than visual ones (red, blue). This decouples design from implementation.",
+            details: "No variant components to evaluate.",
+        };
+    }
+    // Extract variant info from component names (e.g., "Button/Primary" or "Size=Small, Color=Primary")
+    let semanticCount = 0;
+    let visualCount = 0;
+    const visualVariantComps = [];
+    for (const comp of variantComponents) {
+        const nameLower = comp.name.toLowerCase();
+        const hasVisual = VISUAL_VARIANT_VALUES.some((v) => nameLower === v ||
+            nameLower.includes(`=${v}`) ||
+            nameLower.includes(`, ${v}`));
+        const hasSemantic = SEMANTIC_VARIANT_VALUES.some((v) => nameLower === v ||
+            nameLower.includes(`=${v}`) ||
+            nameLower.includes(`, ${v}`));
+        if (hasSemantic)
+            semanticCount++;
+        if (hasVisual) {
+            visualCount++;
+            visualVariantComps.push(comp.name);
+        }
+    }
+    const totalEvaluated = semanticCount + visualCount;
+    if (totalEvaluated === 0) {
+        return {
+            id: "naming-variant-semantic",
+            label: "Variant naming",
+            score: 75,
+            severity: "warning",
+            tooltip: "Variant values should use semantic terms (primary, danger) rather than visual ones (red, blue). This decouples design from implementation.",
+            details: "Variant values could not be classified as semantic or visual.",
+        };
+    }
+    const ratio = semanticCount / totalEvaluated;
+    const score = clamp(ratio * 100);
+    return {
+        id: "naming-variant-semantic",
+        label: "Variant naming",
+        score,
+        severity: getSeverity(score),
+        tooltip: "Variant values should use semantic terms (primary, danger) rather than visual ones (red, blue). This decouples design from implementation.",
+        details: visualCount > 0
+            ? `${visualCount} variant values use visual names. Prefer semantic names like "primary", "danger".`
+            : "Variant values use semantic naming conventions.",
+        examples: visualVariantComps.length > 0
+            ? visualVariantComps.slice(0, MAX_EXAMPLES)
+            : undefined,
+    };
+}
+/**
+ * Score boolean variable naming.
+ * Boolean variables should follow is-, has-, can- prefix patterns.
+ */
+function scoreBooleanNaming(data) {
+    const boolVars = data.variables.filter((v) => v.resolvedType === "BOOLEAN");
+    if (boolVars.length === 0) {
+        return {
+            id: "naming-boolean-prefix",
+            label: "Boolean naming",
+            score: 100,
+            severity: "info",
+            tooltip: "Boolean variables should start with is, has, can, show, or similar prefixes (e.g. isDisabled). This makes their purpose immediately clear.",
+            details: "No boolean variables to evaluate.",
+        };
+    }
+    const collectionNames = buildCollectionNameMap(data.collections);
+    const missingPrefix = boolVars.filter((v) => {
+        const leaf = getLeafName(v.name);
+        return !BOOLEAN_PREFIX_RE.test(leaf);
+    });
+    const correctCount = boolVars.length - missingPrefix.length;
+    const ratio = correctCount / boolVars.length;
+    const score = clamp(ratio * 100);
+    return {
+        id: "naming-boolean-prefix",
+        label: "Boolean naming",
+        score,
+        severity: getSeverity(score),
+        tooltip: "Boolean variables should start with is, has, can, show, or similar prefixes (e.g. isDisabled). This makes their purpose immediately clear.",
+        details: missingPrefix.length > 0
+            ? `${missingPrefix.length} of ${boolVars.length} boolean variables lack is*/has*/can* prefixes.`
+            : `All ${boolVars.length} boolean variables use proper prefixes.`,
+        examples: missingPrefix.length > 0
+            ? missingPrefix.slice(0, MAX_EXAMPLES).map((v) => v.name)
+            : undefined,
+        locations: missingPrefix.length > 0
+            ? missingPrefix.slice(0, MAX_EXAMPLES).map((v) => ({
+                name: v.name,
+                collection: collectionNames.get(v.variableCollectionId),
+                type: "variable",
+            }))
+            : undefined,
+    };
+}
+/**
+ * Naming & Semantics category scorer.
+ * Returns the average score across all naming checks.
+ */
+export function scoreNamingSemantics(data) {
+    const findings = [
+        scoreVariableNaming(data),
+        scoreComponentNaming(data),
+        scoreVariantNaming(data),
+        scoreBooleanNaming(data),
+    ];
+    const score = clamp(findings.reduce((sum, f) => sum + f.score, 0) / findings.length);
+    return {
+        id: "naming-semantics",
+        label: "Naming & Semantics",
+        shortLabel: "Naming",
+        score,
+        weight: 0.2,
+        findings,
+    };
+}
+//# sourceMappingURL=naming-semantics.js.map

package/dist/apps/design-system-dashboard/scoring/naming-semantics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming-semantics.js","sourceRoot":"","sources":["../../../../src/apps/design-system-dashboard/scoring/naming-semantics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,sBAAsB,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAExE,gDAAgD;AAChD,MAAM,YAAY,GAAG,CAAC,CAAC;AAEvB,8DAA8D;AAC9D,MAAM,kBAAkB,GAAG;IAC1B,KAAK;IACL,MAAM;IACN,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,MAAM;IACN,OAAO;IACP,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,SAAS;IACT,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,MAAM;IACN,OAAO;IACP,SAAS;IACT,MAAM;IACN,KAAK;IACL,OAAO;IACP,MAAM;IACN,OAAO;IACP,SAAS;CACT,CAAC;AAEF,wEAAwE;AACxE,MAAM,qBAAqB,GAAG;IAC7B,KAAK;IACL,MAAM;IACN,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,MAAM;IACN,OAAO;IACP,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;CACN,CAAC;AAEF,yDAAyD;AACzD,MAAM,uBAAuB,GAAG;IAC/B,SAAS;IACT,WAAW;IACX,UAAU;IACV,QAAQ;IACR,SAAS;IACT,SAAS;IACT,MAAM;IACN,OAAO;IACP,UAAU;IACV,SAAS;IACT,QAAQ;IACR,OAAO;IACP,aAAa;IACb,SAAS;IACT,OAAO;IACP,MAAM;CACN,CAAC;AAEF,MAAM,cAAc,GAAG,qBAAqB,CAAC;AAC7C,MAAM,iBAAiB,GACtB,kEAAkE,CAAC;AAEpE;;;GAGG;AACH,SAAS,WAAW,CAAC,IAAY;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACjC,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,SAAS,uBAAuB,CAAC,IAAY;IAC5C,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IAC7C,OAAO,kBAAkB,CAAC,IAAI,CAC7B,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,CACtD,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,mBAAmB,CAAC,IAAyB;IACrD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,OAAO,CAAC,CAAC;IAE3E,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;YACN,EAAE,EAAE,0BAA0B;YAC9B,KAAK,EAAE,iBAAiB;YACxB,KAAK,EAAE,GAAG;YACV,QAAQ,EAAE,MAAM;YAChB,OAAO,EACN,kJAAkJ;YACnJ,OAAO,EAAE,iCAAiC;SAC1C,CAAC;IACH,CAAC;IAED,MAAM,eAAe,GAAG,sBAAsB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACjE,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,uBAAuB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5E,MAAM,aAAa,GAAG,CAAC,GAAG,UAAU,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;IAC/D,MAAM,KAAK,GAAG,KAAK,CAAC,aAAa,GAAG,GAAG,CAAC,CAAC;IAEzC,OAAO;QACN,EAAE,EAAE,0BAA0B;QAC9B,KAAK,EAAE,iBAAiB;QACxB,KAAK;QACL,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC;QAC5B,OAAO,EACN,kJAAkJ;QACnJ,OAAO,EACN,UAAU,CAAC,MAAM,GAAG,CAAC;YACpB,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,OAAO,SAAS,CAAC,MAAM,8DAA8D;YAC3G,CAAC,CAAC,OAAO,SAAS,CAAC,MAAM,sCAAsC;QACjE,QAAQ,EACP,UAAU,CAAC,MAAM,GAAG,CAAC;YACpB,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACtD,CAAC,CAAC,SAAS;QACb,SAAS,EACR,UAAU,CAAC,MAAM,GAAG,CAAC;YACpB,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC9C,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,UAAU,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,oBAAoB,CAAC;gBACvD,IAAI,EAAE,UAAU;aAChB,CAAC,CAAC;YACJ,CAAC,CAAC,SAAS;KACb,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAAC,IAAyB;IACtD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IAEnC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO;YACN,EAAE,EAAE,yBAAyB;YAC7B,KAAK,EAAE,kBAAkB;YACzB,KAAK,EAAE,GAAG;YACV,QAAQ,EAAE,MAAM;YAChB,OAAO,EACN,uHAAuH;YACxH,OAAO,EAAE,4BAA4B;SACrC,CAAC;IACH,CAAC;IAED,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC/B,8DAA8D;QAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACnE,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5E,IAAI,SAAS,EAAE,CAAC;YACf,WAAW,EAAE,CAAC;QACf,CAAC;aAAM,CAAC;YACP,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;IACF,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC;IAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;IAEjC,OAAO;QACN,EAAE,EAAE,yBAAyB;QAC7B,KAAK,EAAE,kBAAkB;QACzB,KAAK;QACL,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC;QAC5B,OAAO,EACN,uHAAuH;QACxH,OAAO,EAAE,GAAG,WAAW,OAAO,UAAU,CAAC,MAAM,+CAA+C;QAC9F,QAAQ,EACP,cAAc,CAAC,MAAM,GAAG,CAAC;YACxB,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC;YACvC,CAAC,CAAC,SAAS;KACb,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,IAAyB;IACpD,+DAA+D;IAC/D,sFAAsF;IACtF,MAAM,iBAAiB,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAC/C,CAAC,CAAC,EAAE,EAAE,CACL,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,gBAAgB,EAAE,sBAAsB;QAC1C,CAAC,CAAC,gBAAgB,CACnB,CAAC;IAEF,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpC,OAAO;YACN,EAAE,EAAE,yBAAyB;YAC7B,KAAK,EAAE,gBAAgB;YACvB,KAAK,EAAE,GAAG;YACV,QAAQ,EAAE,MAAM;YAChB,OAAO,EACN,4IAA4I;YAC7I,OAAO,EAAE,oCAAoC;SAC7C,CAAC;IACH,CAAC;IAED,oGAAoG;IACpG,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,MAAM,kBAAkB,GAAa,EAAE,CAAC;IAExC,KAAK,MAAM,IAAI,IAAI,iBAAiB,EAAE,CAAC;QACtC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,SAAS,GAAG,qBAAqB,CAAC,IAAI,CAC3C,CAAC,CAAC,EAAE,EAAE,CACL,SAAS,KAAK,CAAC;YACf,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAC7B,CAAC;QACF,MAAM,WAAW,GAAG,uBAAuB,CAAC,IAAI,CAC/C,CAAC,CAAC,EAAE,EAAE,CACL,SAAS,KAAK,CAAC;YACf,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAC7B,CAAC;QAEF,IAAI,WAAW;YAAE,aAAa,EAAE,CAAC;QACjC,IAAI,SAAS,EAAE,CAAC;YACf,WAAW,EAAE,CAAC;YACd,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;IACF,CAAC;IAED,MAAM,cAAc,GAAG,aAAa,GAAG,WAAW,CAAC;IACnD,IAAI,cAAc,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;YACN,EAAE,EAAE,yBAAyB;YAC7B,KAAK,EAAE,gBAAgB;YACvB,KAAK,EAAE,EAAE;YACT,QAAQ,EAAE,SAAS;YACnB,OAAO,EACN,4IAA4I;YAC7I,OAAO,EAAE,+DAA+D;SACxE,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,aAAa,GAAG,cAAc,CAAC;IAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;IAEjC,OAAO;QACN,EAAE,EAAE,yBAAyB;QAC7B,KAAK,EAAE,gBAAgB;QACvB,KAAK;QACL,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC;QAC5B,OAAO,EACN,4IAA4I;QAC7I,OAAO,EACN,WAAW,GAAG,CAAC;YACd,CAAC,CAAC,GAAG,WAAW,mFAAmF;YACnG,CAAC,CAAC,iDAAiD;QACrD,QAAQ,EACP,kBAAkB,CAAC,MAAM,GAAG,CAAC;YAC5B,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC;YAC3C,CAAC,CAAC,SAAS;KACb,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,kBAAkB,CAAC,IAAyB;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC;IAE5E,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO;YACN,EAAE,EAAE,uBAAuB;YAC3B,KAAK,EAAE,gBAAgB;YACvB,KAAK,EAAE,GAAG;YACV,QAAQ,EAAE,MAAM;YAChB,OAAO,EACN,4IAA4I;YAC7I,OAAO,EAAE,mCAAmC;SAC5C,CAAC;IACH,CAAC;IAED,MAAM,eAAe,GAAG,sBAAsB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAEjE,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAC3C,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;IAE5D,MAAM,KAAK,GAAG,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;IAEjC,OAAO;QACN,EAAE,EAAE,uBAAuB;QAC3B,KAAK,EAAE,gBAAgB;QACvB,KAAK;QACL,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC;QAC5B,OAAO,EACN,4IAA4I;QAC7I,OAAO,EACN,aAAa,CAAC,MAAM,GAAG,CAAC;YACvB,CAAC,CAAC,GAAG,aAAa,CAAC,MAAM,OAAO,QAAQ,CAAC,MAAM,iDAAiD;YAChG,CAAC,CAAC,OAAO,QAAQ,CAAC,MAAM,yCAAyC;QACnE,QAAQ,EACP,aAAa,CAAC,MAAM,GAAG,CAAC;YACvB,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACzD,CAAC,CAAC,SAAS;QACb,SAAS,EACR,aAAa,CAAC,MAAM,GAAG,CAAC;YACvB,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACjD,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,UAAU,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,oBAAoB,CAAC;gBACvD,IAAI,EAAE,UAAU;aAChB,CAAC,CAAC;YACJ,CAAC,CAAC,SAAS;KACb,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAyB;IAC7D,MAAM,QAAQ,GAAc;QAC3B,mBAAmB,CAAC,IAAI,CAAC;QACzB,oBAAoB,CAAC,IAAI,CAAC;QAC1B,kBAAkB,CAAC,IAAI,CAAC;QACxB,kBAAkB,CAAC,IAAI,CAAC;KACxB,CAAC;IAEF,MAAM,KAAK,GAAG,KAAK,CAClB,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAC/D,CAAC;IAEF,OAAO;QACN,EAAE,EAAE,kBAAkB;QACtB,KAAK,EAAE,oBAAoB;QAC3B,UAAU,EAAE,QAAQ;QACpB,KAAK;QACL,MAAM,EAAE,GAAG;QACX,QAAQ;KACR,CAAC;AACH,CAAC"}

package/dist/apps/design-system-dashboard/scoring/token-architecture.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Token Architecture Scorer (weight: 0.20)
+ *
+ * Evaluates the depth and organization of the token system.
+ * Checks collection organization, mode coverage, alias usage,
+ * token tier depth, type distribution, and description coverage.
+ */
+import type { CategoryScore, DesignSystemRawData } from "./types.js";
+/**
+ * Token Architecture category scorer.
+ * Returns the average score across all token architecture checks.
+ */
+export declare function scoreTokenArchitecture(data: DesignSystemRawData): CategoryScore;
+//# sourceMappingURL=token-architecture.d.ts.map

package/dist/apps/design-system-dashboard/scoring/token-architecture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-architecture.d.ts","sourceRoot":"","sources":["../../../../src/apps/design-system-dashboard/scoring/token-architecture.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAW,MAAM,YAAY,CAAC;AA+X9E;;;GAGG;AACH,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,mBAAmB,GACvB,aAAa,CAsBf"}