@usefragments/core 1.0.0

package/dist/chunk-X34IA4LR.js

@@ -0,0 +1,319 @@
+// src/generate/index.ts
+var PLACEHOLDER_PATTERNS = [
+  /^\w+ component is needed$/i,
+  /^Alternative component is more appropriate$/i,
+  /^Use \w+ when you need/i
+];
+function filterPlaceholders(items) {
+  if (!items) return [];
+  return items.filter(
+    (item) => !PLACEHOLDER_PATTERNS.some((pattern) => pattern.test(item.trim()))
+  );
+}
+function generateContext(fragments, options = {}, blocks) {
+  const format = options.format ?? "markdown";
+  const compact = options.compact ?? false;
+  const include = {
+    props: options.include?.props ?? true,
+    variants: options.include?.variants ?? true,
+    usage: options.include?.usage ?? true,
+    relations: options.include?.relations ?? false,
+    code: options.include?.code ?? false
+  };
+  const sorted = [...fragments].sort((a, b) => {
+    const catCompare = a.meta.category.localeCompare(b.meta.category);
+    if (catCompare !== 0) return catCompare;
+    return a.meta.name.localeCompare(b.meta.name);
+  });
+  if (format === "json") {
+    return generateJsonContext(sorted, include, compact, blocks);
+  }
+  return generateMarkdownContext(sorted, include, compact, blocks);
+}
+function generateMarkdownContext(fragments, include, compact, blocks) {
+  const lines = [];
+  lines.push("# Design System Reference");
+  lines.push("");
+  lines.push("## Quick Reference");
+  lines.push("");
+  lines.push("| Component | Category | Use For |");
+  lines.push("|-----------|----------|---------|");
+  for (const fragment of fragments) {
+    const filteredWhen = filterPlaceholders(fragment.usage.when);
+    const useFor = filteredWhen.slice(0, 2).join(", ") || fragment.meta.description;
+    lines.push(`| ${fragment.meta.name} | ${fragment.meta.category} | ${truncate(useFor, 50)} |`);
+  }
+  lines.push("");
+  if (compact) {
+    const content2 = lines.join("\n");
+    return { content: content2, tokenEstimate: estimateTokens(content2) };
+  }
+  lines.push("## Components");
+  lines.push("");
+  for (const fragment of fragments) {
+    lines.push(`### ${fragment.meta.name}`);
+    lines.push("");
+    const statusParts = [`**Category:** ${fragment.meta.category}`];
+    if (fragment.meta.status) {
+      statusParts.push(`**Status:** ${fragment.meta.status}`);
+    }
+    lines.push(statusParts.join(" | "));
+    lines.push("");
+    if (fragment.meta.description) {
+      lines.push(fragment.meta.description);
+      lines.push("");
+    }
+    const whenFiltered = filterPlaceholders(fragment.usage.when);
+    const whenNotFiltered = filterPlaceholders(fragment.usage.whenNot);
+    if (include.usage && (whenFiltered.length > 0 || whenNotFiltered.length > 0)) {
+      if (whenFiltered.length > 0) {
+        lines.push("**When to use:**");
+        for (const when of whenFiltered) {
+          lines.push(`- ${when}`);
+        }
+        lines.push("");
+      }
+      if (whenNotFiltered.length > 0) {
+        lines.push("**When NOT to use:**");
+        for (const whenNot of whenNotFiltered) {
+          lines.push(`- ${whenNot}`);
+        }
+        lines.push("");
+      }
+    }
+    if (fragment.ai?.compositionPattern) {
+      const ai = fragment.ai;
+      const parts = [`**Composition:** ${ai.compositionPattern}`];
+      if (ai.subComponents && ai.subComponents.length > 0) {
+        parts.push(`Sub-components: ${ai.subComponents.map((s) => `${fragment.meta.name}.${s}`).join(", ")}`);
+      }
+      if (ai.requiredChildren && ai.requiredChildren.length > 0) {
+        parts.push(`Required: ${ai.requiredChildren.map((c) => `${fragment.meta.name}.${c}`).join(", ")}`);
+      }
+      lines.push(parts.join(" | "));
+      lines.push("");
+      if (ai.commonPatterns && ai.commonPatterns.length > 0) {
+        lines.push("**Patterns:**");
+        for (const pattern of ai.commonPatterns) {
+          lines.push(`- \`${pattern}\``);
+        }
+        lines.push("");
+      }
+    }
+    if (fragment.contract) {
+      const contract = fragment.contract;
+      if (contract.propsSummary && contract.propsSummary.length > 0) {
+        lines.push(`**Props:** ${contract.propsSummary.join(", ")}`);
+        lines.push("");
+      } else if (include.props && Object.keys(fragment.props).length > 0) {
+        lines.push("**Props:**");
+        for (const [name, prop] of Object.entries(fragment.props)) {
+          lines.push(`- \`${name}\`: ${formatPropType(prop)}${prop.required ? " (required)" : ""}`);
+        }
+        lines.push("");
+      }
+      if (contract.compoundChildren && Object.keys(contract.compoundChildren).length > 0) {
+        lines.push("**Sub-components:**");
+        for (const [childName, childMeta] of Object.entries(contract.compoundChildren)) {
+          const parts = [`\`${fragment.meta.name}.${childName}\``];
+          if (childMeta.required) parts.push("(required)");
+          if (childMeta.description) parts.push(`\u2014 ${childMeta.description}`);
+          lines.push(`- ${parts.join(" ")}`);
+        }
+        lines.push("");
+      }
+      if (contract.canonicalUsage && contract.canonicalUsage.length > 0) {
+        lines.push("**Usage examples:**");
+        for (const usage of contract.canonicalUsage) {
+          lines.push("```tsx");
+          lines.push(usage);
+          lines.push("```");
+        }
+        lines.push("");
+      }
+      if (contract.a11yRules && contract.a11yRules.length > 0) {
+        lines.push(`**A11y:** ${contract.a11yRules.join(", ")}`);
+        lines.push("");
+      }
+      if (contract.bans && contract.bans.length > 0) {
+        lines.push("**Banned patterns:**");
+        for (const ban of contract.bans) {
+          lines.push(`- \`${ban.pattern}\`: ${ban.message}`);
+        }
+        lines.push("");
+      }
+    } else if (include.props && Object.keys(fragment.props).length > 0) {
+      lines.push("**Props:**");
+      for (const [name, prop] of Object.entries(fragment.props)) {
+        lines.push(`- \`${name}\`: ${formatPropType(prop)}${prop.required ? " (required)" : ""}`);
+      }
+      lines.push("");
+    }
+    if (include.variants && fragment.variants.length > 0) {
+      const variantNames = fragment.variants.map((v) => v.name).join(", ");
+      lines.push(`**Variants:** ${variantNames}`);
+      lines.push("");
+      if (include.code) {
+        for (const variant of fragment.variants) {
+          if (variant.code) {
+            lines.push(`*${variant.name}:*`);
+            lines.push("```tsx");
+            lines.push(variant.code);
+            lines.push("```");
+            lines.push("");
+          }
+        }
+      }
+    }
+    if (include.relations && fragment.relations && fragment.relations.length > 0) {
+      lines.push("**Related:**");
+      for (const relation of fragment.relations) {
+        lines.push(`- ${relation.component} (${relation.relationship}): ${relation.note}`);
+      }
+      lines.push("");
+    }
+    lines.push("---");
+    lines.push("");
+  }
+  if (blocks && blocks.length > 0) {
+    lines.push("## Blocks");
+    lines.push("");
+    lines.push("Composition patterns showing how components wire together.");
+    lines.push("");
+    for (const block of blocks) {
+      lines.push(`### ${block.name}`);
+      lines.push("");
+      lines.push(block.description);
+      lines.push("");
+      lines.push(`**Category:** ${block.category}`);
+      lines.push(`**Components:** ${block.components.join(", ")}`);
+      if (block.tags && block.tags.length > 0) {
+        lines.push(`**Tags:** ${block.tags.join(", ")}`);
+      }
+      lines.push("");
+      lines.push("```tsx");
+      lines.push(block.code);
+      lines.push("```");
+      lines.push("");
+      lines.push("---");
+      lines.push("");
+    }
+  }
+  const content = lines.join("\n");
+  return { content, tokenEstimate: estimateTokens(content) };
+}
+function generateJsonContext(fragments, include, compact, blocks) {
+  const categories = [...new Set(fragments.map((s) => s.meta.category))].sort();
+  const components = {};
+  for (const fragment of fragments) {
+    const component = {
+      category: fragment.meta.category,
+      description: fragment.meta.description
+    };
+    if (fragment.meta.status) {
+      component.status = fragment.meta.status;
+    }
+    if (!compact) {
+      if (include.usage) {
+        const whenFiltered = filterPlaceholders(fragment.usage.when);
+        const whenNotFiltered = filterPlaceholders(fragment.usage.whenNot);
+        if (whenFiltered.length > 0) component.whenToUse = whenFiltered;
+        if (whenNotFiltered.length > 0) component.whenNotToUse = whenNotFiltered;
+      }
+      if (fragment.ai?.compositionPattern) {
+        const ai = fragment.ai;
+        const comp = { pattern: ai.compositionPattern };
+        if (ai.subComponents && ai.subComponents.length > 0) {
+          comp.subComponents = ai.subComponents;
+        }
+        if (ai.requiredChildren && ai.requiredChildren.length > 0) {
+          comp.requiredChildren = ai.requiredChildren;
+        }
+        if (ai.commonPatterns && ai.commonPatterns.length > 0) {
+          comp.commonPatterns = ai.commonPatterns;
+        }
+        component.composition = comp;
+      }
+      if (fragment.contract?.propsSummary && fragment.contract.propsSummary.length > 0) {
+        component.propsSummary = fragment.contract.propsSummary;
+      }
+      if (fragment.contract?.compoundChildren && Object.keys(fragment.contract.compoundChildren).length > 0) {
+        component.compoundChildren = fragment.contract.compoundChildren;
+      }
+      if (fragment.contract?.canonicalUsage && fragment.contract.canonicalUsage.length > 0) {
+        component.canonicalUsage = fragment.contract.canonicalUsage;
+      }
+      if (fragment.contract?.a11yRules && fragment.contract.a11yRules.length > 0) {
+        component.a11yRules = fragment.contract.a11yRules;
+      }
+      if (fragment.contract?.bans && fragment.contract.bans.length > 0) {
+        component.bans = fragment.contract.bans;
+      }
+      if (include.props && Object.keys(fragment.props).length > 0) {
+        component.props = {};
+        for (const [name, prop] of Object.entries(fragment.props)) {
+          component.props[name] = {
+            type: formatPropType(prop),
+            description: prop.description
+          };
+          if (prop.required) component.props[name].required = true;
+          if (prop.default !== void 0) component.props[name].default = prop.default;
+        }
+      }
+      if (include.variants && fragment.variants.length > 0) {
+        component.variants = fragment.variants.map((v) => v.name);
+      }
+      if (include.relations && fragment.relations && fragment.relations.length > 0) {
+        component.relations = fragment.relations.map((r) => ({
+          component: r.component,
+          relationship: r.relationship,
+          note: r.note
+        }));
+      }
+    }
+    components[fragment.meta.name] = component;
+  }
+  const blocksMap = blocks && blocks.length > 0 ? Object.fromEntries(blocks.map((b) => [b.name, {
+    description: b.description,
+    category: b.category,
+    components: b.components,
+    code: b.code,
+    tags: b.tags
+  }])) : void 0;
+  const output = {
+    version: "1.0",
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    summary: {
+      totalComponents: fragments.length,
+      categories,
+      ...blocksMap && { totalBlocks: blocks.length }
+    },
+    components,
+    ...blocksMap && { blocks: blocksMap }
+  };
+  const content = JSON.stringify(output, null, 2);
+  return { content, tokenEstimate: estimateTokens(content) };
+}
+function formatPropType(prop) {
+  if (prop.type === "enum" && prop.values) {
+    return prop.values.map((v) => `"${v}"`).join(" | ");
+  }
+  if (prop.default !== void 0) {
+    return `${prop.type} (default: ${JSON.stringify(prop.default)})`;
+  }
+  return prop.type;
+}
+function truncate(str, maxLength) {
+  if (str.length <= maxLength) return str;
+  return str.slice(0, maxLength - 3) + "...";
+}
+function estimateTokens(text) {
+  return Math.ceil(text.length / 4);
+}
+
+export {
+  PLACEHOLDER_PATTERNS,
+  filterPlaceholders,
+  generateContext
+};
+//# sourceMappingURL=chunk-X34IA4LR.js.map

package/dist/chunk-X34IA4LR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/generate/index.ts"],"sourcesContent":["/**\n * Context generation for AI agents.\n *\n * Generates AI-ready context documents from compiled fragment data.\n */\n\nimport type { CompiledFragment, CompiledBlock, PropDefinition } from '../compiled-types/index.js';\n\n/**\n * Placeholder patterns to filter out from usage text.\n */\nexport const PLACEHOLDER_PATTERNS = [\n  /^\\w+ component is needed$/i,\n  /^Alternative component is more appropriate$/i,\n  /^Use \\w+ when you need/i,\n];\n\n/**\n * Filter out placeholder text from usage arrays\n */\nexport function filterPlaceholders(items: string[] | undefined): string[] {\n  if (!items) return [];\n  return items.filter(item =>\n    !PLACEHOLDER_PATTERNS.some(pattern => pattern.test(item.trim()))\n  );\n}\n\n/**\n * Options for context generation\n */\nexport interface ContextOptions {\n  format?: \"markdown\" | \"json\";\n  include?: {\n    props?: boolean;\n    variants?: boolean;\n    usage?: boolean;\n    relations?: boolean;\n    code?: boolean;\n  };\n  compact?: boolean;\n}\n\n/**\n * Result of context generation\n */\nexport interface ContextResult {\n  content: string;\n  tokenEstimate: number;\n}\n\n/**\n * Generate AI-ready context from compiled fragments and optional blocks\n */\nexport function generateContext(\n  fragments: CompiledFragment[],\n  options: ContextOptions = {},\n  blocks?: CompiledBlock[]\n): ContextResult {\n  const format = options.format ?? \"markdown\";\n  const compact = options.compact ?? false;\n\n  const include = {\n    props: options.include?.props ?? true,\n    variants: options.include?.variants ?? true,\n    usage: options.include?.usage ?? true,\n    relations: options.include?.relations ?? false,\n    code: options.include?.code ?? false,\n  };\n\n  const sorted = [...fragments].sort((a, b) => {\n    const catCompare = a.meta.category.localeCompare(b.meta.category);\n    if (catCompare !== 0) return catCompare;\n    return a.meta.name.localeCompare(b.meta.name);\n  });\n\n  if (format === \"json\") {\n    return generateJsonContext(sorted, include, compact, blocks);\n  }\n\n  return generateMarkdownContext(sorted, include, compact, blocks);\n}\n\nfunction generateMarkdownContext(\n  fragments: CompiledFragment[],\n  include: Required<NonNullable<ContextOptions[\"include\"]>>,\n  compact: boolean,\n  blocks?: CompiledBlock[]\n): ContextResult {\n  const lines: string[] = [];\n\n  lines.push(\"# Design System Reference\");\n  lines.push(\"\");\n\n  lines.push(\"## Quick Reference\");\n  lines.push(\"\");\n  lines.push(\"| Component | Category | Use For |\");\n  lines.push(\"|-----------|----------|---------|\");\n\n  for (const fragment of fragments) {\n    const filteredWhen = filterPlaceholders(fragment.usage.when);\n    const useFor = filteredWhen.slice(0, 2).join(\", \") || fragment.meta.description;\n    lines.push(`| ${fragment.meta.name} | ${fragment.meta.category} | ${truncate(useFor, 50)} |`);\n  }\n\n  lines.push(\"\");\n\n  if (compact) {\n    const content = lines.join(\"\\n\");\n    return { content, tokenEstimate: estimateTokens(content) };\n  }\n\n  lines.push(\"## Components\");\n  lines.push(\"\");\n\n  for (const fragment of fragments) {\n    lines.push(`### ${fragment.meta.name}`);\n    lines.push(\"\");\n\n    const statusParts = [`**Category:** ${fragment.meta.category}`];\n    if (fragment.meta.status) {\n      statusParts.push(`**Status:** ${fragment.meta.status}`);\n    }\n    lines.push(statusParts.join(\" | \"));\n    lines.push(\"\");\n\n    if (fragment.meta.description) {\n      lines.push(fragment.meta.description);\n      lines.push(\"\");\n    }\n\n    const whenFiltered = filterPlaceholders(fragment.usage.when);\n    const whenNotFiltered = filterPlaceholders(fragment.usage.whenNot);\n\n    if (include.usage && (whenFiltered.length > 0 || whenNotFiltered.length > 0)) {\n      if (whenFiltered.length > 0) {\n        lines.push(\"**When to use:**\");\n        for (const when of whenFiltered) {\n          lines.push(`- ${when}`);\n        }\n        lines.push(\"\");\n      }\n\n      if (whenNotFiltered.length > 0) {\n        lines.push(\"**When NOT to use:**\");\n        for (const whenNot of whenNotFiltered) {\n          lines.push(`- ${whenNot}`);\n        }\n        lines.push(\"\");\n      }\n    }\n\n    // Composition data (from ai metadata)\n    if (fragment.ai?.compositionPattern) {\n      const ai = fragment.ai;\n      const parts: string[] = [`**Composition:** ${ai.compositionPattern}`];\n      if (ai.subComponents && ai.subComponents.length > 0) {\n        parts.push(`Sub-components: ${ai.subComponents.map(s => `${fragment.meta.name}.${s}`).join(', ')}`);\n      }\n      if (ai.requiredChildren && ai.requiredChildren.length > 0) {\n        parts.push(`Required: ${ai.requiredChildren.map(c => `${fragment.meta.name}.${c}`).join(', ')}`);\n      }\n      lines.push(parts.join(' | '));\n      lines.push(\"\");\n      if (ai.commonPatterns && ai.commonPatterns.length > 0) {\n        lines.push(\"**Patterns:**\");\n        for (const pattern of ai.commonPatterns) {\n          lines.push(`- \\`${pattern}\\``);\n        }\n        lines.push(\"\");\n      }\n    }\n\n    // Contract data\n    if (fragment.contract) {\n      const contract = fragment.contract;\n      if (contract.propsSummary && contract.propsSummary.length > 0) {\n        lines.push(`**Props:** ${contract.propsSummary.join(', ')}`);\n        lines.push(\"\");\n      } else if (include.props && Object.keys(fragment.props).length > 0) {\n        lines.push(\"**Props:**\");\n        for (const [name, prop] of Object.entries(fragment.props)) {\n          lines.push(`- \\`${name}\\`: ${formatPropType(prop)}${prop.required ? \" (required)\" : \"\"}`);\n        }\n        lines.push(\"\");\n      }\n      if (contract.compoundChildren && Object.keys(contract.compoundChildren).length > 0) {\n        lines.push(\"**Sub-components:**\");\n        for (const [childName, childMeta] of Object.entries(contract.compoundChildren)) {\n          const parts: string[] = [`\\`${fragment.meta.name}.${childName}\\``];\n          if (childMeta.required) parts.push(\"(required)\");\n          if (childMeta.description) parts.push(`— ${childMeta.description}`);\n          lines.push(`- ${parts.join(' ')}`);\n        }\n        lines.push(\"\");\n      }\n      if (contract.canonicalUsage && contract.canonicalUsage.length > 0) {\n        lines.push(\"**Usage examples:**\");\n        for (const usage of contract.canonicalUsage) {\n          lines.push(\"```tsx\");\n          lines.push(usage);\n          lines.push(\"```\");\n        }\n        lines.push(\"\");\n      }\n      if (contract.a11yRules && contract.a11yRules.length > 0) {\n        lines.push(`**A11y:** ${contract.a11yRules.join(', ')}`);\n        lines.push(\"\");\n      }\n      if (contract.bans && contract.bans.length > 0) {\n        lines.push(\"**Banned patterns:**\");\n        for (const ban of contract.bans) {\n          lines.push(`- \\`${ban.pattern}\\`: ${ban.message}`);\n        }\n        lines.push(\"\");\n      }\n    } else if (include.props && Object.keys(fragment.props).length > 0) {\n      lines.push(\"**Props:**\");\n      for (const [name, prop] of Object.entries(fragment.props)) {\n        lines.push(`- \\`${name}\\`: ${formatPropType(prop)}${prop.required ? \" (required)\" : \"\"}`);\n      }\n      lines.push(\"\");\n    }\n\n    if (include.variants && fragment.variants.length > 0) {\n      const variantNames = fragment.variants.map((v) => v.name).join(\", \");\n      lines.push(`**Variants:** ${variantNames}`);\n      lines.push(\"\");\n\n      if (include.code) {\n        for (const variant of fragment.variants) {\n          if (variant.code) {\n            lines.push(`*${variant.name}:*`);\n            lines.push(\"```tsx\");\n            lines.push(variant.code);\n            lines.push(\"```\");\n            lines.push(\"\");\n          }\n        }\n      }\n    }\n\n    if (include.relations && fragment.relations && fragment.relations.length > 0) {\n      lines.push(\"**Related:**\");\n      for (const relation of fragment.relations) {\n        lines.push(`- ${relation.component} (${relation.relationship}): ${relation.note}`);\n      }\n      lines.push(\"\");\n    }\n\n    lines.push(\"---\");\n    lines.push(\"\");\n  }\n\n  if (blocks && blocks.length > 0) {\n    lines.push(\"## Blocks\");\n    lines.push(\"\");\n    lines.push(\"Composition patterns showing how components wire together.\");\n    lines.push(\"\");\n\n    for (const block of blocks) {\n      lines.push(`### ${block.name}`);\n      lines.push(\"\");\n      lines.push(block.description);\n      lines.push(\"\");\n      lines.push(`**Category:** ${block.category}`);\n      lines.push(`**Components:** ${block.components.join(\", \")}`);\n      if (block.tags && block.tags.length > 0) {\n        lines.push(`**Tags:** ${block.tags.join(\", \")}`);\n      }\n      lines.push(\"\");\n      lines.push(\"```tsx\");\n      lines.push(block.code);\n      lines.push(\"```\");\n      lines.push(\"\");\n      lines.push(\"---\");\n      lines.push(\"\");\n    }\n  }\n\n  const content = lines.join(\"\\n\");\n  return { content, tokenEstimate: estimateTokens(content) };\n}\n\nfunction generateJsonContext(\n  fragments: CompiledFragment[],\n  include: Required<NonNullable<ContextOptions[\"include\"]>>,\n  compact: boolean,\n  blocks?: CompiledBlock[]\n): ContextResult {\n  const categories = [...new Set(fragments.map((s) => s.meta.category))].sort();\n\n  interface JsonComponent {\n    category: string;\n    description: string;\n    status?: string;\n    whenToUse?: string[];\n    whenNotToUse?: string[];\n    composition?: {\n      pattern: string;\n      subComponents?: string[];\n      requiredChildren?: string[];\n      commonPatterns?: string[];\n    };\n    propsSummary?: string[];\n    compoundChildren?: Record<string, { required?: boolean; accepts?: string[]; description?: string }>;\n    canonicalUsage?: string[];\n    props?: Record<string, { type: string; required?: boolean; default?: unknown; description: string }>;\n    variants?: string[];\n    relations?: Array<{ component: string; relationship: string; note: string }>;\n    a11yRules?: string[];\n    bans?: Array<{ pattern: string; message: string }>;\n  }\n\n  const components: Record<string, JsonComponent> = {};\n\n  for (const fragment of fragments) {\n    const component: JsonComponent = {\n      category: fragment.meta.category,\n      description: fragment.meta.description,\n    };\n\n    if (fragment.meta.status) {\n      component.status = fragment.meta.status;\n    }\n\n    if (!compact) {\n      if (include.usage) {\n        const whenFiltered = filterPlaceholders(fragment.usage.when);\n        const whenNotFiltered = filterPlaceholders(fragment.usage.whenNot);\n        if (whenFiltered.length > 0) component.whenToUse = whenFiltered;\n        if (whenNotFiltered.length > 0) component.whenNotToUse = whenNotFiltered;\n      }\n\n      // Composition data\n      if (fragment.ai?.compositionPattern) {\n        const ai = fragment.ai;\n        const comp: NonNullable<JsonComponent['composition']> = { pattern: ai.compositionPattern! };\n        if (ai.subComponents && ai.subComponents.length > 0) {\n          comp.subComponents = ai.subComponents;\n        }\n        if (ai.requiredChildren && ai.requiredChildren.length > 0) {\n          comp.requiredChildren = ai.requiredChildren;\n        }\n        if (ai.commonPatterns && ai.commonPatterns.length > 0) {\n          comp.commonPatterns = ai.commonPatterns;\n        }\n        component.composition = comp;\n      }\n\n      // Contract data\n      if (fragment.contract?.propsSummary && fragment.contract.propsSummary.length > 0) {\n        component.propsSummary = fragment.contract.propsSummary;\n      }\n      if (fragment.contract?.compoundChildren && Object.keys(fragment.contract.compoundChildren).length > 0) {\n        component.compoundChildren = fragment.contract.compoundChildren;\n      }\n      if (fragment.contract?.canonicalUsage && fragment.contract.canonicalUsage.length > 0) {\n        component.canonicalUsage = fragment.contract.canonicalUsage;\n      }\n      if (fragment.contract?.a11yRules && fragment.contract.a11yRules.length > 0) {\n        component.a11yRules = fragment.contract.a11yRules;\n      }\n      if (fragment.contract?.bans && fragment.contract.bans.length > 0) {\n        component.bans = fragment.contract.bans;\n      }\n\n      if (include.props && Object.keys(fragment.props).length > 0) {\n        component.props = {};\n        for (const [name, prop] of Object.entries(fragment.props)) {\n          component.props[name] = {\n            type: formatPropType(prop),\n            description: prop.description,\n          };\n          if (prop.required) component.props[name].required = true;\n          if (prop.default !== undefined) component.props[name].default = prop.default;\n        }\n      }\n\n      if (include.variants && fragment.variants.length > 0) {\n        component.variants = fragment.variants.map((v) => v.name);\n      }\n\n      if (include.relations && fragment.relations && fragment.relations.length > 0) {\n        component.relations = fragment.relations.map((r) => ({\n          component: r.component,\n          relationship: r.relationship,\n          note: r.note,\n        }));\n      }\n    }\n\n    components[fragment.meta.name] = component;\n  }\n\n  const blocksMap = blocks && blocks.length > 0\n    ? Object.fromEntries(blocks.map(b => [b.name, {\n        description: b.description,\n        category: b.category,\n        components: b.components,\n        code: b.code,\n        tags: b.tags,\n      }]))\n    : undefined;\n\n  const output = {\n    version: \"1.0\",\n    generatedAt: new Date().toISOString(),\n    summary: {\n      totalComponents: fragments.length,\n      categories,\n      ...(blocksMap && { totalBlocks: blocks!.length }),\n    },\n    components,\n    ...(blocksMap && { blocks: blocksMap }),\n  };\n\n  const content = JSON.stringify(output, null, 2);\n  return { content, tokenEstimate: estimateTokens(content) };\n}\n\nfunction formatPropType(prop: PropDefinition): string {\n  if (prop.type === \"enum\" && prop.values) {\n    return prop.values.map((v) => `\"${v}\"`).join(\" | \");\n  }\n  if (prop.default !== undefined) {\n    return `${prop.type} (default: ${JSON.stringify(prop.default)})`;\n  }\n  return prop.type;\n}\n\nfunction truncate(str: string, maxLength: number): string {\n  if (str.length <= maxLength) return str;\n  return str.slice(0, maxLength - 3) + \"...\";\n}\n\nfunction estimateTokens(text: string): number {\n  return Math.ceil(text.length / 4);\n}\n"],"mappings":"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","names":["content"]}