@fragments-sdk/cli 0.5.0 → 0.5.2

package/dist/{viewer-XDPD52L7.js → viewer-YDGFDTK5.js}

@@ -9,7 +9,7 @@ import {
 } from "./chunk-2H2JAA3U.js";
 import {
   generateContext
-} from "./chunk-B2TQKOLW.js";
+} from "./chunk-V7YLRR4C.js";
 import {
   BRAND
 } from "./chunk-ICAIQ57V.js";
@@ -242,7 +242,7 @@ var sharedRenderPool = null;
 var browserPoolModule = null;
 async function getSharedRenderPool() {
   if (!browserPoolModule) {
-    browserPoolModule = await import("./service-2T26CBWE.js");
+    browserPoolModule = await import("./service-RWUMZ3EW.js");
   }
   if (!sharedRenderPool) {
     sharedRenderPool = new browserPoolModule.BrowserPool({
@@ -471,7 +471,7 @@ function segmentsPlugin(options) {
             const address = _server.httpServer?.address();
             const port = typeof address === "object" && address ? address.port : 6006;
             const renderViewport = viewport || { width: 800, height: 600 };
-            const { FigmaClient, bufferToBase64Url } = await import("./service-2T26CBWE.js");
+            const { FigmaClient, bufferToBase64Url } = await import("./service-RWUMZ3EW.js");
             const figmaClient = new FigmaClient({
               accessToken: figmaToken
             });
@@ -562,7 +562,7 @@ function segmentsPlugin(options) {
               );
               return;
             }
-            const { FigmaClient } = await import("./service-2T26CBWE.js");
+            const { FigmaClient } = await import("./service-RWUMZ3EW.js");
             const figmaClient = new FigmaClient({ accessToken: figmaToken });
             const { fileKey, nodeId } = figmaClient.parseUrl(figmaUrl);
             const figmaDesignProps = await figmaClient.getNodeProperties(
@@ -603,7 +603,7 @@ function segmentsPlugin(options) {
               }));
               return;
             }
-            const { getSharedTokenRegistry } = await import("./service-2T26CBWE.js");
+            const { getSharedTokenRegistry } = await import("./service-RWUMZ3EW.js");
             const registry = getSharedTokenRegistry();
             if (!registry.isInitialized()) {
               await registry.initialize(config.tokens, projectRoot);
@@ -663,7 +663,7 @@ function segmentsPlugin(options) {
               }));
               return;
             }
-            const { getSharedTokenRegistry } = await import("./service-2T26CBWE.js");
+            const { getSharedTokenRegistry } = await import("./service-RWUMZ3EW.js");
             const registry = getSharedTokenRegistry();
             if (!registry.isInitialized()) {
               await registry.initialize(config.tokens, projectRoot);
@@ -725,7 +725,7 @@ function segmentsPlugin(options) {
               res.end(JSON.stringify({ error: "Could not resolve segment file path" }));
               return;
             }
-            const { getSharedTokenRegistry } = await import("./service-2T26CBWE.js");
+            const { getSharedTokenRegistry } = await import("./service-RWUMZ3EW.js");
             const registry = getSharedTokenRegistry();
             if (!registry.isInitialized()) {
               await registry.initialize(config.tokens, projectRoot);
@@ -851,7 +851,7 @@ function segmentsPlugin(options) {
             }
             const { writeFile, mkdir } = await import("fs/promises");
             const { join: join2 } = await import("path");
-            const { BRAND: BRAND2 } = await import("./core-NJVKKLJ4.js");
+            const { BRAND: BRAND2 } = await import("./core-DKHB7FYV.js");
             const fragmentsDir = join2(projectRoot, BRAND2.dataDir, BRAND2.componentsDir);
             await mkdir(fragmentsDir, { recursive: true });
             const fragmentPath = join2(
@@ -906,7 +906,7 @@ function segmentsPlugin(options) {
             const {
               getSharedTokenRegistry,
               generateTokenPatches
-            } = await import("./service-2T26CBWE.js");
+            } = await import("./service-RWUMZ3EW.js");
             const registry = getSharedTokenRegistry();
             if (!registry.isInitialized()) {
               await registry.initialize(config.tokens, projectRoot);
@@ -1568,7 +1568,7 @@ async function loadFullSegmentForCompare(_server, _segmentFiles, componentName,
   }
 }
 async function compareImages(image1Base64, image2Base64, threshold) {
-  const { DiffEngine, base64UrlToBuffer, bufferToBase64Url } = await import("./service-2T26CBWE.js");
+  const { DiffEngine, base64UrlToBuffer, bufferToBase64Url } = await import("./service-RWUMZ3EW.js");
   const { PNG } = await import("pngjs");
   const buffer1 = base64UrlToBuffer(image1Base64);
   const buffer2 = base64UrlToBuffer(image2Base64);
@@ -11101,4 +11101,4 @@ export {
   segmentsPlugin,
   useTheme
 };
-//# sourceMappingURL=viewer-XDPD52L7.js.map
+//# sourceMappingURL=viewer-YDGFDTK5.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fragments-sdk/cli",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "CLI, MCP server, and dev tools for Fragments design system",
   "type": "module",
   "bin": {
@@ -63,7 +63,8 @@
     "tailwindcss": "^3.4.17",
     "vite": "^6.0.0",
     "vite-plugin-svgr": "^4.5.0",
-    "zod": "^3.24.1"
+    "zod": "^3.24.1",
+    "@fragments-sdk/context": "0.2.0"
   },
   "devDependencies": {
     "@types/babel__generator": "^7.6.8",

package/src/commands/init.ts

@@ -133,7 +133,7 @@ function generateConfig(options: {
   const includeStr = options.includePaths.map((p) => `    '${p}'`).join(",\n");
   const componentStr = options.componentPaths.map((p) => `    '${p}'`).join(",\n");
 
-  return `import type { FragmentsConfig } from '@fragments/core';
+  return `import type { FragmentsConfig } from '@fragments-sdk/cli';
 
 const config: FragmentsConfig = {
   // Glob patterns for finding fragment/story files
@@ -215,7 +215,7 @@ export function Button({
  */
 function generateExampleFragment(): string {
   return `import React from 'react';
-import { defineFragment } from '@fragments/core';
+import { defineFragment } from '@fragments-sdk/cli';
 import { Button } from './Button';
 
 export default defineFragment({

package/src/core/context.ts

@@ -1,380 +1,2 @@
-import type { CompiledSegment, CompiledBlock, PropDefinition } from "./types.js";
-
-/**
- * Placeholder patterns to filter out from usage text.
- * These are generated by the migrate tool and provide no value.
- */
-const PLACEHOLDER_PATTERNS = [
-  /^\w+ component is needed$/i,
-  /^Alternative component is more appropriate$/i,
-  /^Use \w+ when you need/i,
-];
-
-/**
- * Filter out placeholder text from usage arrays
- */
-function filterPlaceholders(items: string[]): string[] {
-  return items.filter(item =>
-    !PLACEHOLDER_PATTERNS.some(pattern => pattern.test(item.trim()))
-  );
-}
-
-/**
- * Options for context generation
- */
-export interface ContextOptions {
-  /** Output format */
-  format?: "markdown" | "json";
-
-  /** What to include in the output */
-  include?: {
-    /** Include prop details (default: true) */
-    props?: boolean;
-    /** Include variant list (default: true) */
-    variants?: boolean;
-    /** Include usage guidelines (default: true) */
-    usage?: boolean;
-    /** Include related components (default: false) */
-    relations?: boolean;
-    /** Include code examples (default: false) */
-    code?: boolean;
-  };
-
-  /** Compact mode - minimal output for token efficiency */
-  compact?: boolean;
-}
-
-/**
- * Result of context generation
- */
-export interface ContextResult {
-  /** The generated context content */
-  content: string;
-  /** Estimated token count */
-  tokenEstimate: number;
-}
-
-/**
- * Generate AI-ready context from compiled segments and optional blocks
- */
-export function generateContext(
-  segments: CompiledSegment[],
-  options: ContextOptions = {},
-  blocks?: CompiledBlock[]
-): ContextResult {
-  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,
-  };
-
-  // Sort segments by category, then name
-  const sorted = [...segments].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);
-}
-
-/**
- * Generate markdown context
- */
-function generateMarkdownContext(
-  segments: CompiledSegment[],
-  include: Required<NonNullable<ContextOptions["include"]>>,
-  compact: boolean,
-  blocks?: CompiledBlock[]
-): ContextResult {
-  const lines: string[] = [];
-
-  lines.push("# Design System Reference");
-  lines.push("");
-
-  // Quick reference table
-  lines.push("## Quick Reference");
-  lines.push("");
-  lines.push("| Component | Category | Use For |");
-  lines.push("|-----------|----------|---------|");
-
-  for (const segment of segments) {
-    const filteredWhen = filterPlaceholders(segment.usage.when);
-    const useFor = filteredWhen.slice(0, 2).join(", ") || segment.meta.description;
-    lines.push(`| ${segment.meta.name} | ${segment.meta.category} | ${truncate(useFor, 50)} |`);
-  }
-
-  lines.push("");
-
-  // If compact mode, stop here
-  if (compact) {
-    const content = lines.join("\n");
-    return {
-      content,
-      tokenEstimate: estimateTokens(content),
-    };
-  }
-
-  // Full component documentation
-  lines.push("## Components");
-  lines.push("");
-
-  for (const segment of segments) {
-    lines.push(`### ${segment.meta.name}`);
-    lines.push("");
-
-    // Status line
-    const statusParts = [`**Category:** ${segment.meta.category}`];
-    if (segment.meta.status) {
-      statusParts.push(`**Status:** ${segment.meta.status}`);
-    }
-    lines.push(statusParts.join(" | "));
-    lines.push("");
-
-    if (segment.meta.description) {
-      lines.push(segment.meta.description);
-      lines.push("");
-    }
-
-    // Usage guidelines (filter out placeholder text)
-    const whenFiltered = filterPlaceholders(segment.usage.when);
-    const whenNotFiltered = filterPlaceholders(segment.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("");
-      }
-    }
-
-    // Props
-    if (include.props && Object.keys(segment.props).length > 0) {
-      lines.push("**Props:**");
-      for (const [name, prop] of Object.entries(segment.props)) {
-        lines.push(`- \`${name}\`: ${formatPropType(prop)}${prop.required ? " (required)" : ""}`);
-      }
-      lines.push("");
-    }
-
-    // Variants
-    if (include.variants && segment.variants.length > 0) {
-      const variantNames = segment.variants.map((v) => v.name).join(", ");
-      lines.push(`**Variants:** ${variantNames}`);
-      lines.push("");
-
-      // Code examples
-      if (include.code) {
-        for (const variant of segment.variants) {
-          if (variant.code) {
-            lines.push(`*${variant.name}:*`);
-            lines.push("```tsx");
-            lines.push(variant.code);
-            lines.push("```");
-            lines.push("");
-          }
-        }
-      }
-    }
-
-    // Relations
-    if (include.relations && segment.relations && segment.relations.length > 0) {
-      lines.push("**Related:**");
-      for (const relation of segment.relations) {
-        lines.push(`- ${relation.component} (${relation.relationship}): ${relation.note}`);
-      }
-      lines.push("");
-    }
-
-    lines.push("---");
-    lines.push("");
-  }
-
-  // Blocks section
-  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),
-  };
-}
-
-/**
- * Generate JSON context
- */
-function generateJsonContext(
-  segments: CompiledSegment[],
-  include: Required<NonNullable<ContextOptions["include"]>>,
-  compact: boolean,
-  blocks?: CompiledBlock[]
-): ContextResult {
-  const categories = [...new Set(segments.map((s) => s.meta.category))].sort();
-
-  interface JsonComponent {
-    category: string;
-    description: string;
-    status?: string;
-    whenToUse?: string[];
-    whenNotToUse?: string[];
-    props?: Record<string, { type: string; required?: boolean; default?: unknown; description: string }>;
-    variants?: string[];
-    relations?: Array<{ component: string; relationship: string; note: string }>;
-  }
-
-  const components: Record<string, JsonComponent> = {};
-
-  for (const segment of segments) {
-    const component: JsonComponent = {
-      category: segment.meta.category,
-      description: segment.meta.description,
-    };
-
-    if (segment.meta.status) {
-      component.status = segment.meta.status;
-    }
-
-    if (!compact) {
-      if (include.usage) {
-        const whenFiltered = filterPlaceholders(segment.usage.when);
-        const whenNotFiltered = filterPlaceholders(segment.usage.whenNot);
-        if (whenFiltered.length > 0) {
-          component.whenToUse = whenFiltered;
-        }
-        if (whenNotFiltered.length > 0) {
-          component.whenNotToUse = whenNotFiltered;
-        }
-      }
-
-      if (include.props && Object.keys(segment.props).length > 0) {
-        component.props = {};
-        for (const [name, prop] of Object.entries(segment.props)) {
-          component.props[name] = {
-            type: formatPropType(prop),
-            description: prop.description,
-          };
-          if (prop.required) {
-            component.props[name].required = true;
-          }
-          if (prop.default !== undefined) {
-            component.props[name].default = prop.default;
-          }
-        }
-      }
-
-      if (include.variants && segment.variants.length > 0) {
-        component.variants = segment.variants.map((v) => v.name);
-      }
-
-      if (include.relations && segment.relations && segment.relations.length > 0) {
-        component.relations = segment.relations.map((r) => ({
-          component: r.component,
-          relationship: r.relationship,
-          note: r.note,
-        }));
-      }
-    }
-
-    components[segment.meta.name] = component;
-  }
-
-  // Build blocks map
-  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,
-      }]))
-    : undefined;
-
-  const output = {
-    version: "1.0",
-    generatedAt: new Date().toISOString(),
-    summary: {
-      totalComponents: segments.length,
-      categories,
-      ...(blocksMap && { totalBlocks: blocks!.length }),
-    },
-    components,
-    ...(blocksMap && { blocks: blocksMap }),
-  };
-
-  const content = JSON.stringify(output, null, 2);
-  return {
-    content,
-    tokenEstimate: estimateTokens(content),
-  };
-}
-
-/**
- * Format a prop type for display
- */
-function formatPropType(prop: PropDefinition): string {
-  if (prop.type === "enum" && prop.values) {
-    return prop.values.map((v) => `"${v}"`).join(" | ");
-  }
-  if (prop.default !== undefined) {
-    return `${prop.type} (default: ${JSON.stringify(prop.default)})`;
-  }
-  return prop.type;
-}
-
-/**
- * Truncate string to max length
- */
-function truncate(str: string, maxLength: number): string {
-  if (str.length <= maxLength) return str;
-  return str.slice(0, maxLength - 3) + "...";
-}
-
-/**
- * Estimate token count (rough approximation: ~4 chars per token)
- */
-function estimateTokens(text: string): number {
-  return Math.ceil(text.length / 4);
-}
+export { generateContext, filterPlaceholders, PLACEHOLDER_PATTERNS } from '@fragments-sdk/context/generate';
+export type { ContextOptions, ContextResult } from '@fragments-sdk/context/generate';

package/src/core/types.ts

@@ -695,44 +695,17 @@ export interface VerifyResult {
   };
 }
 
-/**
- * Compiled segment data (JSON-serializable for AI consumption)
- */
-export interface CompiledSegment {
-  /** File path relative to project root */
-  filePath: string;
-
-  /** Component metadata */
-  meta: SegmentMeta;
-
-  /** Usage guidelines */
-  usage: SegmentUsage;
-
-  /** Props documentation (without render functions) */
-  props: Record<string, PropDefinition>;
-
-  /** Component relationships */
-  relations?: ComponentRelation[];
-
-  /** Variant names and descriptions (without render functions) */
-  variants: Array<{
-    name: string;
-    description: string;
-    code?: string;
-    figma?: string;
-    /** Args/props used to render this variant (for code generation) */
-    args?: Record<string, unknown>;
-  }>;
+// Compiled types — re-exported from @fragments-sdk/context
+export type {
+  CompiledSegment,
+  CompiledBlock,
+  CompiledTokenEntry,
+  CompiledTokenData,
+  CompiledSegmentsFile,
+} from '@fragments-sdk/context/types';
 
-  /** Agent-optimized contract metadata */
-  contract?: SegmentContract;
-
-  /** AI-specific metadata for playground context generation */
-  ai?: AIMetadata;
-
-  /** Provenance tracking (for generated segments) */
-  _generated?: SegmentGenerated;
-}
+// Re-export CompiledBlock under deprecated alias
+import type { CompiledBlock as _CompiledBlock } from '@fragments-sdk/context/types';
 
 /**
  * Block definition — a named composition pattern showing how
@@ -752,70 +725,7 @@ export interface BlockDefinition {
  */
 export type RecipeDefinition = BlockDefinition;
 
-/**
- * Compiled block data (JSON-serializable for AI consumption)
- */
-export interface CompiledBlock {
-  filePath: string;
-  name: string;
-  description: string;
-  category: string;
-  components: string[];
-  code: string;
-  tags?: string[];
-}
-
 /**
  * @deprecated Use CompiledBlock instead
  */
-export type CompiledRecipe = CompiledBlock;
-
-/**
- * A single token entry in the compiled output
- */
-export interface CompiledTokenEntry {
-  /** CSS variable name (e.g., "--fui-color-accent") */
-  name: string;
-  /** Description from inline comment */
-  description?: string;
-}
-
-/**
- * Compiled token data stored in fragments.json
- */
-export interface CompiledTokenData {
-  /** Detected variable prefix (e.g., "--fui-") */
-  prefix: string;
-  /** Total number of tokens */
-  total: number;
-  /** Tokens grouped by category */
-  categories: Record<string, CompiledTokenEntry[]>;
-}
-
-/**
- * The compiled segments.json structure
- */
-export interface CompiledSegmentsFile {
-  /** Version of the schema */
-  version: string;
-
-  /** When this file was generated */
-  generatedAt: string;
-
-  /** Package name for import statements (read from package.json at build time) */
-  packageName?: string;
-
-  /** All compiled segments indexed by component name */
-  segments: Record<string, CompiledSegment>;
-
-  /** All compiled blocks indexed by block name */
-  blocks?: Record<string, CompiledBlock>;
-
-  /** Design tokens (CSS custom properties) extracted from style files */
-  tokens?: CompiledTokenData;
-
-  /**
-   * @deprecated Use blocks instead
-   */
-  recipes?: Record<string, CompiledBlock>;
-}
+export type CompiledRecipe = _CompiledBlock;

package/src/mcp/__tests__/findFragmentsJson.test.ts

@@ -306,6 +306,36 @@ describe('findFragmentsJson', () => {
     });
   });
 
+  describe('exports map fallback', () => {
+    it('finds fragments.json when package exports block ./package.json access', () => {
+      // Simulate a package with an exports map that doesn't expose ./package.json
+      // Node's createRequire.resolve('pkg/package.json') will throw ERR_PACKAGE_PATH_NOT_EXPORTED
+      // The fallback resolves the main entry and walks up to find package.json
+      const depDir = join(root, 'node_modules', 'my-ui-lib');
+      mkdirSync(depDir, { recursive: true });
+
+      writeJson(join(root, 'package.json'), {
+        dependencies: { 'my-ui-lib': '^1.0.0' },
+      });
+      writeJson(join(depDir, 'package.json'), {
+        name: 'my-ui-lib',
+        main: './index.js',
+        // exports that block ./package.json:
+        exports: {
+          '.': './index.js',
+          './fragments.json': './fragments.json',
+        },
+        fragments: 'fragments.json',
+      });
+      writeFileSync(join(depDir, 'index.js'), 'module.exports = {}');
+      writeFileSync(join(depDir, 'fragments.json'), '{}');
+
+      const result = findFragmentsJson(root);
+      expect(result.length).toBe(1);
+      expect(result[0]).toBe(join(depDir, 'fragments.json'));
+    });
+  });
+
   describe('Phase 3: monorepo workspace discovery', () => {
     it('finds fragments via npm/yarn workspaces field', () => {
       // Root has workspaces but does NOT list @my-scope/ui as a dep