@fragments-sdk/mcp 0.7.0 → 0.7.1

package/dist/{chunk-7GGI7JJE.js → chunk-VV2PJ75X.js}

@@ -1,7 +1,7 @@
 import {
   getGuidanceWhen,
   getGuidanceWhenNot
-} from "./chunk-3IHXJEMM.js";
+} from "./chunk-YSRGQDEB.js";
 
 // src/rules.ts
 import { join } from "path";
@@ -109,4 +109,4 @@ function buildRulesContent(data, brandName) {
 export {
   generateRulesFiles
 };
-//# sourceMappingURL=chunk-7GGI7JJE.js.map
+//# sourceMappingURL=chunk-VV2PJ75X.js.map

package/dist/chunk-YSRGQDEB.js

@@ -0,0 +1,93 @@
+// src/snapshot-helpers.ts
+function listComponents(snapshot) {
+  return Object.values(snapshot.components);
+}
+function componentNames(snapshot) {
+  return listComponents(snapshot).map((component) => component.name);
+}
+function listBlocks(snapshot) {
+  return Object.values(snapshot.blocks ?? {});
+}
+function findComponentByName(snapshot, name) {
+  const query = name.toLowerCase();
+  return listComponents(snapshot).find(
+    (component) => component.name.toLowerCase() === query
+  );
+}
+function normalizeComponentRef(value) {
+  return value.trim().toLowerCase();
+}
+function buildCompoundComponent(parent, childName) {
+  const child = parent.compoundChildren.find(
+    (entry) => normalizeComponentRef(entry.name) === normalizeComponentRef(childName)
+  );
+  if (!child) return void 0;
+  const fullName = child.name.includes(".") ? child.name : `${parent.name}.${child.name}`;
+  return {
+    ...parent,
+    id: child.componentId ?? `${parent.id}::${fullName}`,
+    name: fullName,
+    description: child.description ?? "",
+    props: {},
+    propsSummary: [],
+    examples: [],
+    relations: [],
+    compoundChildren: [],
+    publicRef: child.componentId ?? fullName,
+    publicSlug: null,
+    parentComponentId: parent.id,
+    parentComponentName: parent.name
+  };
+}
+function findComponent(snapshot, reference) {
+  const query = normalizeComponentRef(reference);
+  const components = listComponents(snapshot);
+  const exact = components.find((component) => {
+    return normalizeComponentRef(component.name) === query || normalizeComponentRef(component.id) === query || normalizeComponentRef(component.publicRef ?? "") === query;
+  });
+  if (exact) return exact;
+  if (reference.includes(".")) {
+    const [parentName, ...childParts] = reference.split(".");
+    const childName = childParts.join(".");
+    const parent = components.find((component) => {
+      return normalizeComponentRef(component.name) === normalizeComponentRef(parentName) || normalizeComponentRef(component.publicRef ?? "") === normalizeComponentRef(parentName) || normalizeComponentRef(component.id) === normalizeComponentRef(parentName);
+    });
+    if (parent) {
+      const child = buildCompoundComponent(parent, childName);
+      if (child) return child;
+    }
+  }
+  return void 0;
+}
+function getGuidanceWhen(component) {
+  if (component.guidance.when.length > 0) {
+    return component.guidance.when;
+  }
+  if (component.guidance.usageGuidance) {
+    return [component.guidance.usageGuidance];
+  }
+  if (component.guidance.dos.length > 0) {
+    return component.guidance.dos;
+  }
+  return [];
+}
+function getGuidanceWhenNot(component) {
+  if (component.guidance.whenNot.length > 0) {
+    return component.guidance.whenNot;
+  }
+  if (component.guidance.donts.length > 0) {
+    return component.guidance.donts;
+  }
+  return [];
+}
+
+export {
+  listComponents,
+  componentNames,
+  listBlocks,
+  findComponentByName,
+  findComponent,
+  getGuidanceWhen,
+  getGuidanceWhenNot
+};
+//# sourceMappingURL=chunk-YSRGQDEB.js.map

package/dist/chunk-YSRGQDEB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/snapshot-helpers.ts"],"sourcesContent":["import type { McpBlock, McpComponent, McpSnapshot } from '@fragments-sdk/core';\n\nexport type ResolvedMcpComponent = McpComponent & {\n  isCanonical?: boolean;\n};\n\nexport function listComponents(\n  snapshot: Pick<McpSnapshot, 'components'>,\n): ResolvedMcpComponent[] {\n  return Object.values(snapshot.components);\n}\n\nexport function componentNames(snapshot: Pick<McpSnapshot, 'components'>): string[] {\n  return listComponents(snapshot).map((component) => component.name);\n}\n\nexport function listBlocks(snapshot: Pick<McpSnapshot, 'blocks'>): McpBlock[] {\n  return Object.values(snapshot.blocks ?? {});\n}\n\nexport function findComponentByName(\n  snapshot: Pick<McpSnapshot, 'components'>,\n  name: string,\n): ResolvedMcpComponent | undefined {\n  const query = name.toLowerCase();\n  return listComponents(snapshot).find(\n    (component) => component.name.toLowerCase() === query,\n  );\n}\n\nfunction normalizeComponentRef(value: string): string {\n  return value.trim().toLowerCase();\n}\n\nfunction buildCompoundComponent(\n  parent: ResolvedMcpComponent,\n  childName: string,\n): ResolvedMcpComponent | undefined {\n  const child = parent.compoundChildren.find(\n    (entry) => normalizeComponentRef(entry.name) === normalizeComponentRef(childName),\n  );\n  if (!child) return undefined;\n\n  const fullName = child.name.includes('.')\n    ? child.name\n    : `${parent.name}.${child.name}`;\n\n  return {\n    ...parent,\n    id: child.componentId ?? `${parent.id}::${fullName}`,\n    name: fullName,\n    description: child.description ?? '',\n    props: {},\n    propsSummary: [],\n    examples: [],\n    relations: [],\n    compoundChildren: [],\n    publicRef: child.componentId ?? fullName,\n    publicSlug: null,\n    parentComponentId: parent.id,\n    parentComponentName: parent.name,\n  };\n}\n\nexport function findComponent(\n  snapshot: Pick<McpSnapshot, 'components'>,\n  reference: string,\n): ResolvedMcpComponent | undefined {\n  const query = normalizeComponentRef(reference);\n  const components = listComponents(snapshot);\n\n  const exact = components.find((component) => {\n    return (\n      normalizeComponentRef(component.name) === query ||\n      normalizeComponentRef(component.id) === query ||\n      normalizeComponentRef(component.publicRef ?? '') === query\n    );\n  });\n  if (exact) return exact;\n\n  if (reference.includes('.')) {\n    const [parentName, ...childParts] = reference.split('.');\n    const childName = childParts.join('.');\n    const parent = components.find((component) => {\n      return (\n        normalizeComponentRef(component.name) === normalizeComponentRef(parentName) ||\n        normalizeComponentRef(component.publicRef ?? '') ===\n          normalizeComponentRef(parentName) ||\n        normalizeComponentRef(component.id) === normalizeComponentRef(parentName)\n      );\n    });\n\n    if (parent) {\n      const child = buildCompoundComponent(parent, childName);\n      if (child) return child;\n    }\n  }\n\n  return undefined;\n}\n\nexport function getGuidanceWhen(component: ResolvedMcpComponent): string[] {\n  if (component.guidance.when.length > 0) {\n    return component.guidance.when;\n  }\n  if (component.guidance.usageGuidance) {\n    return [component.guidance.usageGuidance];\n  }\n  if (component.guidance.dos.length > 0) {\n    return component.guidance.dos;\n  }\n  return [];\n}\n\nexport function getGuidanceWhenNot(component: ResolvedMcpComponent): string[] {\n  if (component.guidance.whenNot.length > 0) {\n    return component.guidance.whenNot;\n  }\n  if (component.guidance.donts.length > 0) {\n    return component.guidance.donts;\n  }\n  return [];\n}\n"],"mappings":"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","names":[]}

package/dist/index.js

@@ -22,14 +22,14 @@ import {
   telemetryMiddleware,
   tokensFromCompiledTokenData,
   validateSnapshot
-} from "./chunk-LZW5KUXV.js";
+} from "./chunk-HGGAXLRO.js";
 import {
   BRAND
 } from "./chunk-4SVS3AA3.js";
 import {
   generateRulesFiles
-} from "./chunk-7GGI7JJE.js";
-import "./chunk-3IHXJEMM.js";
+} from "./chunk-VV2PJ75X.js";
+import "./chunk-YSRGQDEB.js";
 
 // src/adapters/custom-json.ts
 import { readFile } from "fs/promises";

package/dist/rules-CKBRD3UL.js

@@ -0,0 +1,8 @@
+import {
+  generateRulesFiles
+} from "./chunk-VV2PJ75X.js";
+import "./chunk-YSRGQDEB.js";
+export {
+  generateRulesFiles
+};
+//# sourceMappingURL=rules-CKBRD3UL.js.map

package/dist/server.js

@@ -2,9 +2,9 @@ import {
   createMcpServer,
   createSandboxServer,
   startMcpServer
-} from "./chunk-LZW5KUXV.js";
+} from "./chunk-HGGAXLRO.js";
 import "./chunk-4SVS3AA3.js";
-import "./chunk-3IHXJEMM.js";
+import "./chunk-YSRGQDEB.js";
 export {
   createMcpServer,
   createSandboxServer,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fragments-sdk/mcp",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "license": "FSL-1.1-MIT",
   "description": "Standalone MCP server for Fragments design system — zero-config component discovery with semantic search",
   "mcpName": "io.github.ConanMcN/fragments-mcp",
@@ -62,9 +62,9 @@
     "@modelcontextprotocol/sdk": "^1.0.0",
     "@orama/orama": "^3.1.18",
     "typescript": "^5.7.2",
-    "@fragments-sdk/core": "2.1.0",
     "@fragments-sdk/context": "0.6.1",
-    "@fragments-sdk/govern": "0.3.1"
+    "@fragments-sdk/core": "2.1.0",
+    "@fragments-sdk/govern": "0.3.2"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/dist/chunk-3IHXJEMM.js

@@ -1,47 +0,0 @@
-// src/snapshot-helpers.ts
-function listComponents(snapshot) {
-  return Object.values(snapshot.components);
-}
-function componentNames(snapshot) {
-  return listComponents(snapshot).map((component) => component.name);
-}
-function listBlocks(snapshot) {
-  return Object.values(snapshot.blocks ?? {});
-}
-function findComponentByName(snapshot, name) {
-  const query = name.toLowerCase();
-  return listComponents(snapshot).find(
-    (component) => component.name.toLowerCase() === query
-  );
-}
-function getGuidanceWhen(component) {
-  if (component.guidance.when.length > 0) {
-    return component.guidance.when;
-  }
-  if (component.guidance.usageGuidance) {
-    return [component.guidance.usageGuidance];
-  }
-  if (component.guidance.dos.length > 0) {
-    return component.guidance.dos;
-  }
-  return [];
-}
-function getGuidanceWhenNot(component) {
-  if (component.guidance.whenNot.length > 0) {
-    return component.guidance.whenNot;
-  }
-  if (component.guidance.donts.length > 0) {
-    return component.guidance.donts;
-  }
-  return [];
-}
-
-export {
-  listComponents,
-  componentNames,
-  listBlocks,
-  findComponentByName,
-  getGuidanceWhen,
-  getGuidanceWhenNot
-};
-//# sourceMappingURL=chunk-3IHXJEMM.js.map

package/dist/chunk-3IHXJEMM.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/snapshot-helpers.ts"],"sourcesContent":["import type { McpBlock, McpComponent, McpSnapshot } from '@fragments-sdk/core';\n\nexport function listComponents(snapshot: Pick<McpSnapshot, 'components'>): McpComponent[] {\n  return Object.values(snapshot.components);\n}\n\nexport function componentNames(snapshot: Pick<McpSnapshot, 'components'>): string[] {\n  return listComponents(snapshot).map((component) => component.name);\n}\n\nexport function listBlocks(snapshot: Pick<McpSnapshot, 'blocks'>): McpBlock[] {\n  return Object.values(snapshot.blocks ?? {});\n}\n\nexport function findComponentByName(\n  snapshot: Pick<McpSnapshot, 'components'>,\n  name: string,\n): McpComponent | undefined {\n  const query = name.toLowerCase();\n  return listComponents(snapshot).find(\n    (component) => component.name.toLowerCase() === query,\n  );\n}\n\nexport function getGuidanceWhen(component: McpComponent): string[] {\n  if (component.guidance.when.length > 0) {\n    return component.guidance.when;\n  }\n  if (component.guidance.usageGuidance) {\n    return [component.guidance.usageGuidance];\n  }\n  if (component.guidance.dos.length > 0) {\n    return component.guidance.dos;\n  }\n  return [];\n}\n\nexport function getGuidanceWhenNot(component: McpComponent): string[] {\n  if (component.guidance.whenNot.length > 0) {\n    return component.guidance.whenNot;\n  }\n  if (component.guidance.donts.length > 0) {\n    return component.guidance.donts;\n  }\n  return [];\n}\n"],"mappings":";AAEO,SAAS,eAAe,UAA2D;AACxF,SAAO,OAAO,OAAO,SAAS,UAAU;AAC1C;AAEO,SAAS,eAAe,UAAqD;AAClF,SAAO,eAAe,QAAQ,EAAE,IAAI,CAAC,cAAc,UAAU,IAAI;AACnE;AAEO,SAAS,WAAW,UAAmD;AAC5E,SAAO,OAAO,OAAO,SAAS,UAAU,CAAC,CAAC;AAC5C;AAEO,SAAS,oBACd,UACA,MAC0B;AAC1B,QAAM,QAAQ,KAAK,YAAY;AAC/B,SAAO,eAAe,QAAQ,EAAE;AAAA,IAC9B,CAAC,cAAc,UAAU,KAAK,YAAY,MAAM;AAAA,EAClD;AACF;AAEO,SAAS,gBAAgB,WAAmC;AACjE,MAAI,UAAU,SAAS,KAAK,SAAS,GAAG;AACtC,WAAO,UAAU,SAAS;AAAA,EAC5B;AACA,MAAI,UAAU,SAAS,eAAe;AACpC,WAAO,CAAC,UAAU,SAAS,aAAa;AAAA,EAC1C;AACA,MAAI,UAAU,SAAS,IAAI,SAAS,GAAG;AACrC,WAAO,UAAU,SAAS;AAAA,EAC5B;AACA,SAAO,CAAC;AACV;AAEO,SAAS,mBAAmB,WAAmC;AACpE,MAAI,UAAU,SAAS,QAAQ,SAAS,GAAG;AACzC,WAAO,UAAU,SAAS;AAAA,EAC5B;AACA,MAAI,UAAU,SAAS,MAAM,SAAS,GAAG;AACvC,WAAO,UAAU,SAAS;AAAA,EAC5B;AACA,SAAO,CAAC;AACV;","names":[]}