@fragments-sdk/context 0.3.5 → 0.4.0

package/dist/{chunk-IQMVRBVF.js → chunk-5CV3LGEU.js}

@@ -193,6 +193,19 @@ var CLI_COMMANDS = [
       { flags: "-p, --port <port>", description: "Dev server port", default: "6006" }
     ]
   },
+  {
+    name: "perf",
+    description: "Profile component bundle sizes and performance budgets",
+    category: "quality",
+    usage: "fragments perf [options]",
+    options: [
+      { flags: "-c, --config <path>", description: "Path to config file" },
+      { flags: "--json", description: "Output results as JSON" },
+      { flags: "--component <name>", description: "Measure specific component only" },
+      { flags: "--no-write", description: "Do not write results to fragments.json" },
+      { flags: "--concurrency <n>", description: "Max concurrent measurements", default: "4" }
+    ]
+  },
   {
     name: "test",
     description: "Run interaction tests for fragments with play functions",

package/dist/{chunk-NECSN43I.js → chunk-FGBRIJOT.js}

@@ -245,6 +245,26 @@ var MCP_TOOL_DEFINITIONS = [
     },
     required: ["mode"]
   },
+  {
+    key: "perf",
+    description: "Query component performance data (bundle sizes, complexity tiers, budget status). Returns measured bundle sizes from fragments.json. Run `fragments perf` first to generate measurements.",
+    params: {
+      component: {
+        type: "string",
+        description: "Component name to query (optional, returns all if omitted)"
+      },
+      sort: {
+        type: "string",
+        enum: ["size", "name", "budget"],
+        description: "Sort order: size (largest first), name (alphabetical), budget (most over-budget first). Default: size"
+      },
+      filter: {
+        type: "string",
+        enum: ["lightweight", "moderate", "heavy", "over-budget"],
+        description: "Filter by complexity tier or over-budget status"
+      }
+    }
+  },
   {
     key: "a11y",
     description: "Run an accessibility audit on a component. Returns axe-core violations, a WCAG compliance score, and optional fix suggestions. Requires a running Fragments dev server.",

package/dist/cli-commands/index.js

@@ -1,7 +1,7 @@
 import {
   CLI_COMMANDS,
   CLI_COMMAND_CATEGORIES
-} from "../chunk-IQMVRBVF.js";
+} from "../chunk-5CV3LGEU.js";
 export {
   CLI_COMMANDS,
   CLI_COMMAND_CATEGORIES

package/dist/index.js

@@ -3,11 +3,11 @@ import {
   MCP_TOOL_DEFINITIONS,
   buildMcpTools,
   buildToolNames
-} from "./chunk-NECSN43I.js";
+} from "./chunk-FGBRIJOT.js";
 import {
   CLI_COMMANDS,
   CLI_COMMAND_CATEGORIES
-} from "./chunk-IQMVRBVF.js";
+} from "./chunk-5CV3LGEU.js";
 import {
   chunkByAST,
   chunkByLines,

package/dist/mcp-tools/index.js

@@ -3,7 +3,7 @@ import {
   MCP_TOOL_DEFINITIONS,
   buildMcpTools,
   buildToolNames
-} from "../chunk-NECSN43I.js";
+} from "../chunk-FGBRIJOT.js";
 export {
   CLI_TOOL_EXTENSIONS,
   MCP_TOOL_DEFINITIONS,

package/dist/types/index.d.ts

@@ -71,6 +71,8 @@ interface FragmentContract {
         message: string;
     }>;
     scenarioTags?: string[];
+    /** Per-component performance budget override in bytes (gzipped) */
+    performanceBudget?: number;
 }
 /**
  * Provenance tracking for generated fragments
@@ -90,6 +92,36 @@ interface AIMetadata {
     requiredChildren?: string[];
     commonPatterns?: string[];
 }
+/**
+ * Performance data for a component (from bundle size measurement)
+ */
+/**
+ * A single import contributing to bundle size
+ */
+interface ImportEntry {
+    /** Resolved file path (relative to project root) */
+    path: string;
+    /** Bytes contributed to the bundle */
+    bytes: number;
+    /** Percentage of total bundle size */
+    percent: number;
+}
+interface PerformanceData {
+    /** Gzipped bundle size in bytes */
+    bundleSize: number;
+    /** Raw (minified, not gzipped) bundle size in bytes */
+    rawSize: number;
+    /** Complexity classification */
+    complexity: 'lightweight' | 'moderate' | 'heavy';
+    /** Percentage of budget used (0-100+) */
+    budgetPercent: number;
+    /** Whether the component exceeds its budget */
+    overBudget: boolean;
+    /** ISO timestamp when measured */
+    measuredAt: string;
+    /** Top imports by size (largest first) */
+    imports?: ImportEntry[];
+}
 /**
  * Compiled fragment data (JSON-serializable for AI consumption)
  */
@@ -108,6 +140,8 @@ interface CompiledFragment {
     }>;
     contract?: FragmentContract;
     ai?: AIMetadata;
+    /** Component performance data from bundle size measurement */
+    performance?: PerformanceData;
     _generated?: FragmentGenerated;
 }
 /**
@@ -138,6 +172,21 @@ interface CompiledTokenData {
     total: number;
     categories: Record<string, CompiledTokenEntry[]>;
 }
+/**
+ * Performance summary across all components
+ */
+interface PerformanceSummary {
+    /** Preset name used */
+    preset: string;
+    /** Budget applied in bytes */
+    budget: number;
+    /** Total components measured */
+    total: number;
+    /** Number of components over budget */
+    overBudget: number;
+    /** Distribution by tier */
+    tiers: Record<string, number>;
+}
 /**
  * The compiled fragments.json structure
  */
@@ -150,6 +199,8 @@ interface CompiledFragmentsFile {
     tokens?: CompiledTokenData;
     /** Component relationship graph for AI structural queries */
     graph?: SerializedComponentGraph;
+    /** Performance measurement summary */
+    performanceSummary?: PerformanceSummary;
     /** @deprecated Use blocks instead */
     recipes?: Record<string, CompiledBlock>;
 }
@@ -177,4 +228,4 @@ interface VerifyResult {
     };
 }
 
-export type { AIMetadata, CompiledBlock, CompiledFragment, CompiledFragmentsFile, CompiledTokenData, CompiledTokenEntry, ComponentRelation, FragmentContract, FragmentGenerated, FragmentMeta, FragmentUsage, PropDefinition, Theme, VerifyResult };
+export type { AIMetadata, CompiledBlock, CompiledFragment, CompiledFragmentsFile, CompiledTokenData, CompiledTokenEntry, ComponentRelation, FragmentContract, FragmentGenerated, FragmentMeta, FragmentUsage, ImportEntry, PerformanceData, PerformanceSummary, PropDefinition, Theme, VerifyResult };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fragments-sdk/context",
-  "version": "0.3.5",
+  "version": "0.4.0",
   "license": "FSL-1.1-MIT",
   "description": "Code intelligence and RAG primitives for design system and codebase indexing",
   "author": "Conan McNicholl",