@fragments-sdk/mcp 0.8.1 → 0.10.0

package/dist/chunk-VV2PJ75X.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/rules.ts"],"sourcesContent":["import { join } from 'node:path';\nimport { writeFileSync, mkdirSync, existsSync } from 'node:fs';\nimport type { McpComponent } from '@fragments-sdk/core';\nimport type { DesignSystemData } from './types.js';\nimport { getGuidanceWhen, getGuidanceWhenNot } from './snapshot-helpers.js';\n\nexport type RulesFormat = 'cursor' | 'claude' | 'copilot';\n\nexport interface RulesGeneratorOptions {\n  data: DesignSystemData;\n  brandName: string;\n  outputDir: string;\n  formats: RulesFormat[];\n  /** Overwrite existing files (default: false — skip and warn) */\n  force?: boolean;\n}\n\n/**\n * Generate IDE rules files from design system data.\n * Returns list of files written. Skips existing files unless force is true.\n */\nexport function generateRulesFiles(options: RulesGeneratorOptions): string[] {\n  const { data, brandName, outputDir, formats, force = false } = options;\n  const content = buildRulesContent(data, brandName);\n  const files: string[] = [];\n\n  for (const format of formats) {\n    let filePath: string;\n    let fileContent: string;\n\n    switch (format) {\n      case 'cursor':\n        filePath = join(outputDir, '.cursorrules');\n        fileContent = content;\n        break;\n      case 'claude':\n        filePath = join(outputDir, 'CLAUDE.md');\n        fileContent = `# CLAUDE.md\\n\\nThis file provides guidance to Claude Code when working with code in this repository.\\n\\n${content}`;\n        break;\n      case 'copilot': {\n        const dir = join(outputDir, '.github');\n        if (!existsSync(dir)) mkdirSync(dir, { recursive: true });\n        filePath = join(dir, 'copilot-instructions.md');\n        fileContent = content;\n        break;\n      }\n    }\n\n    if (!force && existsSync(filePath)) {\n      console.error(`  Skipped ${filePath} (already exists, use --force to overwrite)`);\n      continue;\n    }\n\n    writeFileSync(filePath, fileContent, 'utf-8');\n    files.push(filePath);\n  }\n\n  return files;\n}\n\nfunction buildRulesContent(data: DesignSystemData, brandName: string): string {\n  const sections: string[] = [];\n\n  // Header\n  sections.push(`# ${brandName} Design System Rules\\n`);\n  sections.push(`Always use ${brandName} components and design tokens when building UI. Do not use raw HTML elements, Tailwind classes, or hardcoded CSS values when a design system component or token exists.\\n`);\n\n  // Component inventory\n  const components: McpComponent[] = Object.values(data.components);\n  if (components.length > 0) {\n    sections.push('## Components\\n');\n    const byCategory = new Map<string, string[]>();\n    for (const c of components) {\n      const cat = c.category || 'uncategorized';\n      if (!byCategory.has(cat)) byCategory.set(cat, []);\n      byCategory.get(cat)!.push(c.name);\n    }\n    for (const [cat, names] of byCategory) {\n      sections.push(`### ${cat}\\n`);\n      sections.push(names.map(n => `- ${n}`).join('\\n'));\n      sections.push('');\n    }\n  }\n\n  // Import pattern\n  if (data.defaultPackageName) {\n    sections.push('## Imports\\n');\n    sections.push(`Import components from \\`${data.defaultPackageName}\\`:\\n`);\n    sections.push('```typescript');\n    const exampleNames = components.slice(0, 3).map(c => c.name);\n    sections.push(`import { ${exampleNames.join(', ')} } from '${data.defaultPackageName}';`);\n    sections.push('```\\n');\n  }\n\n  // Tokens\n  if (data.tokens && data.tokens.total > 0) {\n    sections.push('## Design Tokens\\n');\n    sections.push(`Prefix: \\`${data.tokens.prefix}\\`. Use \\`var(--token-name)\\` in CSS/styles.\\n`);\n    sections.push('Available categories:');\n    for (const [cat, tokens] of Object.entries(data.tokens.categories) as Array<\n      [string, typeof data.tokens.categories[string]]\n    >) {\n      sections.push(`- **${cat}** (${tokens.length} tokens)`);\n    }\n    sections.push('');\n  }\n\n  // Usage guidelines (aggregated from all components)\n  const allDos: string[] = [];\n  const allDonts: string[] = [];\n  for (const c of components) {\n    allDos.push(...getGuidanceWhen(c).slice(0, 1).map(w => `${c.name}: ${w}`));\n    allDonts.push(...getGuidanceWhenNot(c).slice(0, 1).map(w => `${c.name}: ${w}`));\n  }\n  if (allDos.length > 0 || allDonts.length > 0) {\n    sections.push('## Usage Guidelines\\n');\n    if (allDos.length > 0) {\n      sections.push('**Do:**');\n      sections.push(allDos.slice(0, 10).map(d => `- ${d}`).join('\\n'));\n      sections.push('');\n    }\n    if (allDonts.length > 0) {\n      sections.push('**Don\\'t:**');\n      sections.push(allDonts.slice(0, 10).map(d => `- ${d}`).join('\\n'));\n      sections.push('');\n    }\n  }\n\n  return sections.join('\\n');\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-YSRGQDEB.js

@@ -1,93 +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 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

@@ -1 +0,0 @@
-{"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":[]}