@fragments-sdk/cli 0.7.0 → 0.7.2

package/dist/mcp-bin.js

@@ -2,11 +2,11 @@
 import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
 import {
   generateContext
-} from "./chunk-TJ34N7C7.js";
+} from "./chunk-OOGTG5FM.js";
 import {
   BRAND,
   DEFAULTS
-} from "./chunk-6JBGU74P.js";
+} from "./chunk-GHYYFAQN.js";
 
 // src/mcp/server.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -58,7 +58,7 @@ var _service = null;
 async function getService() {
   if (!_service) {
     try {
-      _service = await import("./service-T2L7VLTE.js");
+      _service = await import("./service-PVGTYUKX.js");
     } catch {
       throw new Error(
         "Visual tools require playwright. Install it with: npm install playwright"
@@ -230,16 +230,16 @@ function createMcpServer(config) {
       }
     }
   );
-  let segmentsData = null;
-  const segmentPackageMap = /* @__PURE__ */ new Map();
+  let fragmentsData = null;
+  const fragmentPackageMap = /* @__PURE__ */ new Map();
   let defaultPackageName = null;
   let browserPool = null;
   let storageManager = null;
   let diffEngine = null;
   let isPoolWarming = false;
-  async function loadSegments() {
-    if (segmentsData) {
-      return segmentsData;
+  async function loadFragments() {
+    if (fragmentsData) {
+      return fragmentsData;
     }
     const paths = findFragmentsJson(config.projectRoot);
     if (paths.length === 0) {
@@ -248,41 +248,41 @@ function createMcpServer(config) {
       );
     }
     const content = await readFile(paths[0], "utf-8");
-    segmentsData = JSON.parse(content);
-    if (!segmentsData.blocks && segmentsData.recipes) {
-      segmentsData.blocks = segmentsData.recipes;
+    fragmentsData = JSON.parse(content);
+    if (!fragmentsData.blocks && fragmentsData.recipes) {
+      fragmentsData.blocks = fragmentsData.recipes;
     }
-    if (segmentsData.packageName) {
-      for (const name of Object.keys(segmentsData.segments)) {
-        segmentPackageMap.set(name, segmentsData.packageName);
+    if (fragmentsData.packageName) {
+      for (const name of Object.keys(fragmentsData.fragments)) {
+        fragmentPackageMap.set(name, fragmentsData.packageName);
       }
     }
     for (let i = 1; i < paths.length; i++) {
       const extra = JSON.parse(await readFile(paths[i], "utf-8"));
       if (extra.packageName) {
-        for (const name of Object.keys(extra.segments)) {
-          segmentPackageMap.set(name, extra.packageName);
+        for (const name of Object.keys(extra.fragments)) {
+          fragmentPackageMap.set(name, extra.packageName);
         }
       }
-      Object.assign(segmentsData.segments, extra.segments);
+      Object.assign(fragmentsData.fragments, extra.fragments);
       const extraBlocks = extra.blocks ?? extra.recipes;
       if (extraBlocks) {
-        segmentsData.blocks = { ...segmentsData.blocks, ...extraBlocks };
+        fragmentsData.blocks = { ...fragmentsData.blocks, ...extraBlocks };
       }
     }
-    return segmentsData;
+    return fragmentsData;
   }
-  async function getPackageName(segmentName) {
-    await loadSegments();
-    if (segmentName) {
-      const segPkg = segmentPackageMap.get(segmentName);
+  async function getPackageName(fragmentName) {
+    await loadFragments();
+    if (fragmentName) {
+      const segPkg = fragmentPackageMap.get(fragmentName);
       if (segPkg) return segPkg;
     }
     if (defaultPackageName) {
       return defaultPackageName;
     }
-    if (segmentsData?.packageName) {
-      defaultPackageName = segmentsData.packageName;
+    if (fragmentsData?.packageName) {
+      defaultPackageName = fragmentsData.packageName;
       return defaultPackageName;
     }
     const packageJsonPath = join(config.projectRoot, "package.json");
@@ -356,7 +356,7 @@ function createMcpServer(config) {
         // DISCOVER — list, suggest, context, alternatives
         // ================================================================
         case TOOL_NAMES.discover: {
-          const data = await loadSegments();
+          const data = await loadFragments();
           const useCase = args2?.useCase ?? void 0;
           const componentForAlts = args2?.component ?? void 0;
           const category = args2?.category ?? void 0;
@@ -367,9 +367,9 @@ function createMcpServer(config) {
           const includeCode = args2?.includeCode ?? false;
           const includeRelations = args2?.includeRelations ?? false;
           if (compact || args2?.format && !useCase && !componentForAlts && !category && !search && !status) {
-            const segments2 = Object.values(data.segments);
+            const fragments2 = Object.values(data.fragments);
             const allBlocks = Object.values(data.blocks ?? data.recipes ?? {});
-            const { content: ctxContent, tokenEstimate } = generateContext(segments2, {
+            const { content: ctxContent, tokenEstimate } = generateContext(fragments2, {
               format,
               compact,
               include: {
@@ -411,7 +411,7 @@ function createMcpServer(config) {
                 synonyms.forEach((syn) => expandedTerms.add(syn));
               }
             });
-            const scored = Object.values(data.segments).map((s) => {
+            const scored = Object.values(data.fragments).map((s) => {
               let score = 0;
               const reasons = [];
               const nameLower = s.meta.name.toLowerCase();
@@ -535,14 +535,14 @@ function createMcpServer(config) {
             };
           }
           if (componentForAlts) {
-            const segment = Object.values(data.segments).find(
+            const fragment = Object.values(data.fragments).find(
               (s) => s.meta.name.toLowerCase() === componentForAlts.toLowerCase()
             );
-            if (!segment) {
+            if (!fragment) {
               throw new Error(`Component "${componentForAlts}" not found. Use fragments_discover to see available components.`);
             }
-            const relations = segment.relations ?? [];
-            const referencedBy = Object.values(data.segments).filter(
+            const relations = fragment.relations ?? [];
+            const referencedBy = Object.values(data.fragments).filter(
               (s) => s.relations?.some((r) => r.component.toLowerCase() === componentForAlts.toLowerCase())
             ).map((s) => ({
               component: s.meta.name,
@@ -553,8 +553,8 @@ function createMcpServer(config) {
                 (r) => r.component.toLowerCase() === componentForAlts.toLowerCase()
               )?.note
             }));
-            const sameCategory = Object.values(data.segments).filter(
-              (s) => s.meta.category === segment.meta.category && s.meta.name.toLowerCase() !== componentForAlts.toLowerCase()
+            const sameCategory = Object.values(data.fragments).filter(
+              (s) => s.meta.category === fragment.meta.category && s.meta.name.toLowerCase() !== componentForAlts.toLowerCase()
             ).map((s) => ({
               component: s.meta.name,
               description: s.meta.description
@@ -563,8 +563,8 @@ function createMcpServer(config) {
               content: [{
                 type: "text",
                 text: JSON.stringify({
-                  component: segment.meta.name,
-                  category: segment.meta.category,
+                  component: fragment.meta.name,
+                  category: fragment.meta.category,
                   directRelations: relations,
                   referencedBy,
                   sameCategory,
@@ -573,7 +573,7 @@ function createMcpServer(config) {
               }]
             };
           }
-          const segments = Object.values(data.segments).filter((s) => {
+          const fragments = Object.values(data.fragments).filter((s) => {
             if (category && s.meta.category !== category) return false;
             if (status && (s.meta.status ?? "stable") !== status) return false;
             if (search) {
@@ -595,10 +595,10 @@ function createMcpServer(config) {
             content: [{
               type: "text",
               text: JSON.stringify({
-                total: segments.length,
-                segments,
-                categories: [...new Set(segments.map((s) => s.category))],
-                hint: segments.length === 0 ? "No components found. Try broader search terms or check available categories." : segments.length > 5 ? "Use fragments_discover with useCase for recommendations, or fragments_inspect for details on a specific component." : void 0
+                total: fragments.length,
+                fragments,
+                categories: [...new Set(fragments.map((s) => s.category))],
+                hint: fragments.length === 0 ? "No components found. Try broader search terms or check available categories." : fragments.length > 5 ? "Use fragments_discover with useCase for recommendations, or fragments_inspect for details on a specific component." : void 0
               }, null, 2)
             }]
           };
@@ -607,7 +607,7 @@ function createMcpServer(config) {
         // INSPECT — get + guidelines + example in one call
         // ================================================================
         case TOOL_NAMES.inspect: {
-          const data = await loadSegments();
+          const data = await loadFragments();
           const componentName = args2?.component;
           const fields = args2?.fields;
           const variantName = args2?.variant ?? void 0;
@@ -616,14 +616,14 @@ function createMcpServer(config) {
           if (!componentName) {
             throw new Error("component is required");
           }
-          const segment = Object.values(data.segments).find(
+          const fragment = Object.values(data.fragments).find(
             (s) => s.meta.name.toLowerCase() === componentName.toLowerCase()
           );
-          if (!segment) {
+          if (!fragment) {
             throw new Error(`Component "${componentName}" not found. Use fragments_discover to see available components.`);
           }
-          const pkgName = await getPackageName(segment.meta.name);
-          let variants = segment.variants;
+          const pkgName = await getPackageName(fragment.meta.name);
+          let variants = fragment.variants;
           if (variantName) {
             const query = variantName.toLowerCase();
             let filtered = variants.filter(
@@ -643,7 +643,7 @@ function createMcpServer(config) {
               variants = filtered;
             } else {
               throw new Error(
-                `Variant "${variantName}" not found for ${componentName}. Available: ${segment.variants.map((v) => v.name).join(", ")}`
+                `Variant "${variantName}" not found for ${componentName}. Available: ${fragment.variants.map((v) => v.name).join(", ")}`
               );
             }
           }
@@ -667,44 +667,44 @@ function createMcpServer(config) {
             return {
               variant: variant.name,
               description: variant.description,
-              code: `<${segment.meta.name} />`,
+              code: `<${fragment.meta.name} />`,
               note: "No code example provided in fragment. Refer to props for customization."
             };
           });
-          const propsReference = Object.entries(segment.props ?? {}).map(([propName, prop]) => ({
+          const propsReference = Object.entries(fragment.props ?? {}).map(([propName, prop]) => ({
             name: propName,
             type: prop.type,
             required: prop.required,
             default: prop.default,
             description: prop.description
           }));
-          const propConstraints = Object.entries(segment.props ?? {}).filter(([, prop]) => prop.constraints && prop.constraints.length > 0).map(([pName, prop]) => ({
+          const propConstraints = Object.entries(fragment.props ?? {}).filter(([, prop]) => prop.constraints && prop.constraints.length > 0).map(([pName, prop]) => ({
             prop: pName,
             constraints: prop.constraints
           }));
           const fullResult = {
             // Component data (from old "get")
-            meta: segment.meta,
-            props: segment.props,
-            variants: segment.variants,
-            relations: segment.relations,
-            contract: segment.contract,
-            generated: segment._generated,
+            meta: fragment.meta,
+            props: fragment.props,
+            variants: fragment.variants,
+            relations: fragment.relations,
+            contract: fragment.contract,
+            generated: fragment._generated,
             // Guidelines (from old "guidelines")
             guidelines: {
-              when: filterPlaceholders(segment.usage?.when),
-              whenNot: filterPlaceholders(segment.usage?.whenNot),
-              guidelines: segment.usage?.guidelines ?? [],
-              accessibility: segment.usage?.accessibility ?? [],
+              when: filterPlaceholders(fragment.usage?.when),
+              whenNot: filterPlaceholders(fragment.usage?.whenNot),
+              guidelines: fragment.usage?.guidelines ?? [],
+              accessibility: fragment.usage?.accessibility ?? [],
               propConstraints,
-              alternatives: segment.relations?.filter((r) => r.relationship === "alternative").map((r) => ({
+              alternatives: fragment.relations?.filter((r) => r.relationship === "alternative").map((r) => ({
                 component: r.component,
                 note: r.note
               })) ?? []
             },
             // Examples (from old "example")
             examples: {
-              import: `import { ${segment.meta.name} } from '${pkgName}';`,
+              import: `import { ${fragment.meta.name} } from '${pkgName}';`,
               code: examples,
               propsReference
             }
@@ -721,7 +721,7 @@ function createMcpServer(config) {
         // BLOCKS — composition patterns
         // ================================================================
         case TOOL_NAMES.blocks: {
-          const data = await loadSegments();
+          const data = await loadFragments();
           const blockName = args2?.name;
           const search = args2?.search?.toLowerCase() ?? void 0;
           const component = args2?.component?.toLowerCase() ?? void 0;
@@ -781,7 +781,7 @@ function createMcpServer(config) {
         // TOKENS — list CSS custom properties by category
         // ================================================================
         case TOOL_NAMES.tokens: {
-          const data = await loadSegments();
+          const data = await loadFragments();
           const category = args2?.category?.toLowerCase() ?? void 0;
           const search = args2?.search?.toLowerCase() ?? void 0;
           const tokenData = data.tokens;
@@ -841,7 +841,7 @@ function createMcpServer(config) {
         // IMPLEMENT — one-shot discover + inspect + blocks + tokens
         // ================================================================
         case TOOL_NAMES.implement: {
-          const data = await loadSegments();
+          const data = await loadFragments();
           const useCase = args2?.useCase;
           if (!useCase) {
             throw new Error("useCase is required");
@@ -866,7 +866,7 @@ function createMcpServer(config) {
             const synonyms = synonymMap[term];
             if (synonyms) synonyms.forEach((syn) => expandedTerms.add(syn));
           });
-          const scored = Object.values(data.segments).map((s) => {
+          const scored = Object.values(data.fragments).map((s) => {
             let score = 0;
             const nameLower = s.meta.name.toLowerCase();
             if (searchTerms.some((t) => nameLower.includes(t))) score += 15;
@@ -881,11 +881,11 @@ function createMcpServer(config) {
             if (s.meta.category && searchTerms.some((t) => s.meta.category.toLowerCase().includes(t))) score += 8;
             if (s.meta.status === "stable") score += 5;
             if (s.meta.status === "deprecated") score -= 25;
-            return { segment: s, score };
+            return { fragment: s, score };
           });
           const topMatches = scored.filter((s) => s.score >= 8).sort((a, b) => b.score - a.score).slice(0, 3);
           const components = await Promise.all(
-            topMatches.map(async ({ segment: s, score }) => {
+            topMatches.map(async ({ fragment: s, score }) => {
               const pkgName = await getPackageName(s.meta.name);
               const examples = s.variants.slice(0, 2).map((v) => ({
                 variant: v.name,
@@ -910,7 +910,7 @@ function createMcpServer(config) {
           const allBlocks = Object.values(data.blocks ?? data.recipes ?? {});
           const matchingBlocks = allBlocks.filter((b) => {
             const haystack = [b.name, b.description, ...b.tags ?? [], ...b.components, b.category].join(" ").toLowerCase();
-            return searchTerms.some((t) => haystack.includes(t)) || topMatches.some(({ segment }) => b.components.some((c) => c.toLowerCase() === segment.meta.name.toLowerCase()));
+            return searchTerms.some((t) => haystack.includes(t)) || topMatches.some(({ fragment }) => b.components.some((c) => c.toLowerCase() === fragment.meta.name.toLowerCase()));
           }).slice(0, 2).map((b) => ({ name: b.name, description: b.description, components: b.components, code: b.code }));
           const tokenData = data.tokens;
           let relevantTokens;
@@ -1147,17 +1147,17 @@ Suggestion: ${result.suggestion}` : ""}`
         // FIX — unchanged
         // ================================================================
         case TOOL_NAMES.fix: {
-          const data = await loadSegments();
+          const data = await loadFragments();
           const componentName = args2?.component;
           const variantName = args2?.variant ?? void 0;
           const fixType = args2?.fixType ?? "all";
           if (!componentName) {
             throw new Error("component is required");
           }
-          const segment = Object.values(data.segments).find(
+          const fragment = Object.values(data.fragments).find(
             (s) => s.meta.name.toLowerCase() === componentName.toLowerCase()
           );
-          if (!segment) {
+          if (!fragment) {
             throw new Error(`Component "${componentName}" not found. Use fragments_discover to see available components.`);
           }
           const baseUrl = config.viewerUrl ?? "http://localhost:6006";