@mp3wizard/figma-console-mcp 1.14.0

package/dist/apps/design-system-dashboard/scoring/component-metadata.js

@@ -0,0 +1,358 @@
+/**
+ * Component Metadata Scorer (weight: 0.20)
+ *
+ * Checks component quality and completeness within the design system.
+ * Evaluates description presence, description quality, property completeness,
+ * variant structure, and category organization.
+ *
+ * Scores against "scorable units" (component sets + standalone components)
+ * rather than raw variant count to avoid inflated totals.
+ */
+import { clamp, getSeverity } from "./types.js";
+/** Maximum examples to include in a finding. */
+const MAX_EXAMPLES = 5;
+/** Minimum description length to be considered "quality" documentation. */
+const MIN_QUALITY_DESC_LENGTH = 20;
+/**
+ * Build a lookup structure for matching components to variant groups.
+ * Collects component set node IDs for `containing_frame.containingComponentSet`
+ * matching (primary REST API path) and name prefixes as fallback.
+ */
+function buildComponentSetLookup(data) {
+    const nodeIds = new Set();
+    const namePrefixes = new Set();
+    for (const cs of data.componentSets) {
+        if (cs.node_id)
+            nodeIds.add(cs.node_id);
+        if (cs.name)
+            namePrefixes.add(cs.name + "/");
+    }
+    return { nodeIds, namePrefixes };
+}
+/**
+ * Check if a component belongs to a variant set.
+ *
+ * Detection order:
+ * 1. Plugin API: `componentSetId` (set on ComponentNode by Figma plugin runtime)
+ * 2. REST API: `containing_frame.containingComponentSet` (present on variants
+ *    returned by GET /v1/files/:key/components)
+ * 3. File JSON: `component_set_id` (snake_case field on COMPONENT nodes in file tree)
+ * 4. Name prefix: variant names starting with "SetName/" (some API formats)
+ * 5. Frame node ID: containing_frame.nodeId matching a known component set node
+ */
+function isComponentInSet(component, lookup) {
+    // Plugin API: direct componentSetId
+    if (component.componentSetId)
+        return true;
+    // REST API: containing_frame.containingComponentSet is set on variant components
+    if (component.containing_frame?.containingComponentSet)
+        return true;
+    // File JSON: snake_case variant of componentSetId
+    if (component.component_set_id)
+        return true;
+    // Name-based fallback: variant names may start with "SetName/"
+    if (component.name) {
+        for (const prefix of lookup.namePrefixes) {
+            if (component.name.startsWith(prefix))
+                return true;
+        }
+    }
+    // Frame node ID fallback
+    const frameNodeId = component.containing_frame?.nodeId;
+    if (frameNodeId && lookup.nodeIds.has(frameNodeId))
+        return true;
+    return false;
+}
+/**
+ * Classify components into standalone, variants, and component sets.
+ * Scoring evaluates `scorableUnits` (standalone + componentSets)
+ * instead of the raw component list which double-counts variants.
+ */
+export function classifyComponents(data) {
+    const lookup = buildComponentSetLookup(data);
+    const standalone = [];
+    const variants = [];
+    for (const comp of data.components) {
+        if (isComponentInSet(comp, lookup)) {
+            variants.push(comp);
+        }
+        else {
+            standalone.push(comp);
+        }
+    }
+    return {
+        standalone,
+        variants,
+        componentSets: data.componentSets,
+        scorableUnits: [...standalone, ...data.componentSets],
+    };
+}
+// ---------------------------------------------------------------------------
+// Scoring functions (operate on scorable units)
+// ---------------------------------------------------------------------------
+/**
+ * Score description presence across scorable units.
+ * Component sets and standalone components should have non-empty descriptions.
+ */
+function scoreDescriptionPresence(classification) {
+    const { scorableUnits } = classification;
+    if (scorableUnits.length === 0) {
+        return {
+            id: "component-desc-presence",
+            label: "Description presence",
+            score: 100,
+            severity: "info",
+            tooltip: "Components and component sets should have descriptions. Descriptions appear in Figma's asset panel and help designers find the right component.",
+            details: "No components to evaluate.",
+        };
+    }
+    const withDesc = scorableUnits.filter((c) => c.description && c.description.trim().length > 0);
+    const withoutDesc = scorableUnits.filter((c) => !c.description || c.description.trim().length === 0);
+    const ratio = withDesc.length / scorableUnits.length;
+    const score = clamp(ratio * 100);
+    return {
+        id: "component-desc-presence",
+        label: "Description presence",
+        score,
+        severity: getSeverity(score),
+        tooltip: "Components and component sets should have descriptions. Descriptions appear in Figma's asset panel and help designers find the right component.",
+        details: `${withDesc.length} of ${scorableUnits.length} components have descriptions (${Math.round(ratio * 100)}%).`,
+        examples: withoutDesc.length > 0
+            ? withoutDesc.slice(0, MAX_EXAMPLES).map((c) => c.name)
+            : undefined,
+        locations: withoutDesc.length > 0
+            ? withoutDesc.slice(0, MAX_EXAMPLES).map((c) => ({
+                name: c.name,
+                nodeId: c.node_id,
+                type: "component",
+            }))
+            : undefined,
+    };
+}
+/**
+ * Score description quality.
+ * Descriptions should be meaningful (>20 chars), not just the component name.
+ */
+function scoreDescriptionQuality(classification) {
+    const { scorableUnits } = classification;
+    const withDesc = scorableUnits.filter((c) => c.description && c.description.trim().length > 0);
+    if (withDesc.length === 0) {
+        return {
+            id: "component-desc-quality",
+            label: "Description quality",
+            score: 0,
+            severity: scorableUnits.length === 0 ? "info" : "fail",
+            tooltip: "Descriptions should be meaningful (20+ characters) and explain usage, not just repeat the name. Good descriptions reduce misuse.",
+            details: scorableUnits.length === 0
+                ? "No components to evaluate."
+                : "No components have descriptions to evaluate quality.",
+        };
+    }
+    const shortDescs = withDesc.filter((c) => c.description.trim().length < MIN_QUALITY_DESC_LENGTH);
+    const qualityCount = withDesc.length - shortDescs.length;
+    const ratio = qualityCount / withDesc.length;
+    const score = clamp(ratio * 100);
+    return {
+        id: "component-desc-quality",
+        label: "Description quality",
+        score,
+        severity: getSeverity(score),
+        tooltip: "Descriptions should be meaningful (20+ characters) and explain usage, not just repeat the name. Good descriptions reduce misuse.",
+        details: shortDescs.length > 0
+            ? `${shortDescs.length} of ${withDesc.length} descriptions are too short (<${MIN_QUALITY_DESC_LENGTH} chars). Provide usage guidance, not just names.`
+            : `All ${withDesc.length} descriptions provide meaningful documentation.`,
+        examples: shortDescs.length > 0
+            ? shortDescs.slice(0, MAX_EXAMPLES).map((c) => c.name)
+            : undefined,
+    };
+}
+/**
+ * Score property completeness.
+ * Standalone components should define properties for flexibility.
+ * Component sets inherently have properties via their variants.
+ */
+function scorePropertyCompleteness(classification) {
+    const { standalone, componentSets, scorableUnits } = classification;
+    if (scorableUnits.length === 0) {
+        return {
+            id: "component-property-completeness",
+            label: "Property completeness",
+            score: 100,
+            severity: "info",
+            tooltip: "Components should expose properties or use variant sets. Properties make components flexible and reduce the need for detaching instances.",
+            details: "No components to evaluate.",
+        };
+    }
+    // Component sets always count as having properties (they are variant groups)
+    // For standalone, check if they have any property definitions
+    const standaloneWithProps = standalone.filter((c) => c.componentPropertyDefinitions &&
+        Object.keys(c.componentPropertyDefinitions).length > 0);
+    const standaloneWithoutProps = standalone.filter((c) => !c.componentPropertyDefinitions ||
+        Object.keys(c.componentPropertyDefinitions).length === 0);
+    const withProperties = standaloneWithProps.length + componentSets.length;
+    const ratio = withProperties / scorableUnits.length;
+    const score = clamp(ratio * 100);
+    return {
+        id: "component-property-completeness",
+        label: "Property completeness",
+        score,
+        severity: getSeverity(score),
+        tooltip: "Components should expose properties or use variant sets. Properties make components flexible and reduce the need for detaching instances.",
+        details: `${withProperties} of ${scorableUnits.length} components have defined properties or variants (${Math.round(ratio * 100)}%).`,
+        examples: standaloneWithoutProps.length > 0
+            ? standaloneWithoutProps.slice(0, MAX_EXAMPLES).map((c) => c.name)
+            : undefined,
+        locations: standaloneWithoutProps.length > 0
+            ? standaloneWithoutProps.slice(0, MAX_EXAMPLES).map((c) => ({
+                name: c.name,
+                nodeId: c.node_id,
+                type: "component",
+            }))
+            : undefined,
+    };
+}
+/**
+ * Score variant structure.
+ * A higher ratio of component sets to total scorable units indicates
+ * good use of variant organization.
+ */
+function scoreVariantStructure(classification) {
+    const { standalone, componentSets, scorableUnits } = classification;
+    if (scorableUnits.length === 0) {
+        return {
+            id: "component-variant-structure",
+            label: "Variant structure",
+            score: 100,
+            severity: "info",
+            tooltip: "Related component variants should be organized into component sets. Sets make variant switching easy and reduce component sprawl.",
+            details: "No components to evaluate.",
+        };
+    }
+    const setCount = componentSets.length;
+    const ratio = setCount / scorableUnits.length;
+    const score = clamp(ratio * 100);
+    return {
+        id: "component-variant-structure",
+        label: "Variant structure",
+        score,
+        severity: getSeverity(score),
+        tooltip: "Related component variants should be organized into component sets. Sets make variant switching easy and reduce component sprawl.",
+        details: setCount > 0
+            ? `${setCount} of ${scorableUnits.length} components use variant sets (${Math.round(ratio * 100)}%). ${standalone.length} standalone component${standalone.length === 1 ? "" : "s"}.`
+            : "No components use variant structures. Consider organizing components into sets with variants.",
+        examples: standalone.length > 0 && setCount > 0
+            ? standalone.slice(0, MAX_EXAMPLES).map((c) => `${c.name} (standalone)`)
+            : undefined,
+    };
+}
+/**
+ * Score category organization.
+ * Components should use path separators (/) for logical grouping.
+ */
+function scoreCategoryOrganization(classification) {
+    const { scorableUnits } = classification;
+    if (scorableUnits.length === 0) {
+        return {
+            id: "component-category-org",
+            label: "Category organization",
+            score: 100,
+            severity: "info",
+            tooltip: 'Component names should use path separators (/) for grouping (e.g. Forms/Input). Organized naming improves asset panel navigation.',
+            details: "No components to evaluate.",
+        };
+    }
+    const withPath = scorableUnits.filter((c) => c.name?.includes("/"));
+    const withoutPath = scorableUnits.filter((c) => !c.name?.includes("/"));
+    const ratio = withPath.length / scorableUnits.length;
+    const score = clamp(ratio * 100);
+    return {
+        id: "component-category-org",
+        label: "Category organization",
+        score,
+        severity: getSeverity(score),
+        tooltip: 'Component names should use path separators (/) for grouping (e.g. Forms/Input). Organized naming improves asset panel navigation.',
+        details: withPath.length > 0
+            ? `${withPath.length} of ${scorableUnits.length} components use path-based grouping (${Math.round(ratio * 100)}%).`
+            : 'No components use path separators for grouping. Use "/" in names for organization (e.g., "Forms/Input").',
+        examples: withoutPath.length > 0
+            ? withoutPath.slice(0, MAX_EXAMPLES).map((c) => c.name)
+            : undefined,
+        locations: withoutPath.length > 0
+            ? withoutPath.slice(0, MAX_EXAMPLES).map((c) => ({
+                name: c.name,
+                nodeId: c.node_id,
+                type: "component",
+            }))
+            : undefined,
+    };
+}
+/** Matches Figma auto-generated layer names like "Frame 347", "Group 12", "Rectangle 5". */
+const GENERIC_NAME_RE = /^(Frame|Group|Rectangle|Ellipse|Line|Polygon|Vector|Text|Image|Slice|Component|Instance|Section|Boolean\s*Group)\s*\d*$/i;
+/**
+ * Score generic layer naming.
+ * Published components should have intentional names, not auto-generated ones.
+ */
+function scoreGenericNaming(classification) {
+    const { scorableUnits } = classification;
+    if (scorableUnits.length === 0) {
+        return {
+            id: "component-generic-naming",
+            label: "Layer naming",
+            score: 100,
+            severity: "info",
+            tooltip: "Published components should have intentional names. Auto-generated names like Frame 347 or Group 12 indicate layers that were never renamed.",
+            details: "No components to evaluate.",
+        };
+    }
+    const genericComps = scorableUnits.filter((c) => {
+        const segments = (c.name || "").split("/").map((s) => s.trim());
+        return segments.some((seg) => GENERIC_NAME_RE.test(seg));
+    });
+    const ratio = 1 - genericComps.length / scorableUnits.length;
+    const score = clamp(ratio * 100);
+    return {
+        id: "component-generic-naming",
+        label: "Layer naming",
+        score,
+        severity: getSeverity(score),
+        tooltip: "Published components should have intentional names. Auto-generated names like Frame 347 or Group 12 indicate layers that were never renamed.",
+        details: genericComps.length > 0
+            ? `${genericComps.length} of ${scorableUnits.length} components have auto-generated layer names (e.g. Frame, Group, Rectangle).`
+            : "All components have intentional names.",
+        examples: genericComps.length > 0
+            ? genericComps.slice(0, MAX_EXAMPLES).map((c) => c.name)
+            : undefined,
+        locations: genericComps.length > 0
+            ? genericComps.slice(0, MAX_EXAMPLES).map((c) => ({
+                name: c.name,
+                nodeId: c.node_id,
+                type: "component",
+            }))
+            : undefined,
+    };
+}
+/**
+ * Component Metadata category scorer.
+ * Returns the average score across all component metadata checks.
+ */
+export function scoreComponentMetadata(data) {
+    const classification = classifyComponents(data);
+    const findings = [
+        scoreDescriptionPresence(classification),
+        scoreDescriptionQuality(classification),
+        scorePropertyCompleteness(classification),
+        scoreVariantStructure(classification),
+        scoreCategoryOrganization(classification),
+        scoreGenericNaming(classification),
+    ];
+    const score = clamp(findings.reduce((sum, f) => sum + f.score, 0) / findings.length);
+    return {
+        id: "component-metadata",
+        label: "Component Metadata",
+        shortLabel: "Components",
+        score,
+        weight: 0.2,
+        findings,
+    };
+}
+//# sourceMappingURL=component-metadata.js.map

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * Consistency Scorer (weight: 0.15)
+ *
+ * Checks pattern uniformity across the design system.
+ * Evaluates naming delimiter consistency, casing consistency,
+ * size value consistency, and mode naming consistency.
+ */
+import type { CategoryScore, DesignSystemRawData } from "./types.js";
+/**
+ * Consistency category scorer.
+ * Returns the average score across all consistency checks.
+ */
+export declare function scoreConsistency(data: DesignSystemRawData): CategoryScore;
+//# sourceMappingURL=consistency.d.ts.map

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

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