@fragments-sdk/cli 0.5.2 → 0.7.0

package/dist/{chunk-ICAIQ57V.js → chunk-6JBGU74P.js}

@@ -1,4 +1,4 @@
-import { createRequire } from 'module'; const require = createRequire(import.meta.url);
+import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
 
 // src/core/constants.ts
 var BRAND = {
@@ -152,7 +152,9 @@ var relationshipTypeSchema = z.enum([
   "sibling",
   "parent",
   "child",
-  "composition"
+  "composition",
+  "complementary",
+  "used-by"
 ]);
 var componentRelationSchema = z.object({
   component: z.string().min(1),
@@ -244,4 +246,4 @@ export {
   segmentsConfigSchema,
   recipeDefinitionSchema
 };
-//# sourceMappingURL=chunk-ICAIQ57V.js.map
+//# sourceMappingURL=chunk-6JBGU74P.js.map

package/dist/chunk-6JBGU74P.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/constants.ts","../src/core/schema.ts"],"sourcesContent":["/**\n * Brand constants for easy rebranding if domain availability requires it.\n * All naming throughout the codebase should reference these constants.\n */\nexport const BRAND = {\n  /** Display name (e.g., \"Fragments\") */\n  name: \"Fragments\",\n\n  /** Lowercase name for file paths and CLI (e.g., \"fragments\") */\n  nameLower: \"fragments\",\n\n  /** File extension for fragment definition files (e.g., \".fragment.tsx\") */\n  fileExtension: \".fragment.tsx\",\n\n  /** Legacy file extension for segments (still supported for migration) */\n  legacyFileExtension: \".segment.tsx\",\n\n  /** JSON file extension for compiled output */\n  jsonExtension: \".fragment.json\",\n\n  /** Default output file name (e.g., \"fragments.json\") */\n  outFile: \"fragments.json\",\n\n  /** Config file name (e.g., \"fragments.config.ts\") */\n  configFile: \"fragments.config.ts\",\n\n  /** Legacy config file name (still supported for migration) */\n  legacyConfigFile: \"segments.config.ts\",\n\n  /** CLI command name (e.g., \"fragments\") */\n  cliCommand: \"fragments\",\n\n  /** Package scope (e.g., \"@fragments\") */\n  packageScope: \"@fragments\",\n\n  /** Directory for storing fragments, registry, and cache */\n  dataDir: \".fragments\",\n\n  /** Components subdirectory within .fragments/ */\n  componentsDir: \"components\",\n\n  /** Registry file name */\n  registryFile: \"registry.json\",\n\n  /** Context file name (AI-ready markdown) */\n  contextFile: \"context.md\",\n\n  /** Screenshots subdirectory */\n  screenshotsDir: \"screenshots\",\n\n  /** Cache subdirectory (gitignored) */\n  cacheDir: \"cache\",\n\n  /** Diff output subdirectory (gitignored) */\n  diffDir: \"diff\",\n\n  /** Manifest filename */\n  manifestFile: \"manifest.json\",\n\n  /** Prefix for localStorage keys (e.g., \"fragments-\") */\n  storagePrefix: \"fragments-\",\n\n  /** Static viewer HTML file name */\n  viewerHtmlFile: \"fragments-viewer.html\",\n\n  /** MCP tool name prefix (e.g., \"fragments_\") */\n  mcpToolPrefix: \"fragments_\",\n\n  /** File extension for block definition files */\n  blockFileExtension: \".block.ts\",\n\n  /** @deprecated Use blockFileExtension instead */\n  recipeFileExtension: \".recipe.ts\",\n\n  /** Vite plugin namespace */\n  vitePluginNamespace: \"fragments-core-shim\",\n} as const;\n\nexport type Brand = typeof BRAND;\n\n/**\n * Default configuration values for the service.\n * These can be overridden in fragments.config.ts\n */\nexport const DEFAULTS = {\n  /** Default viewport dimensions */\n  viewport: {\n    width: 1280,\n    height: 800,\n  },\n\n  /** Default diff threshold (percentage) */\n  diffThreshold: 5,\n\n  /** Browser pool size */\n  poolSize: 3,\n\n  /** Idle timeout before browser shutdown (ms) - 5 minutes */\n  idleTimeoutMs: 5 * 60 * 1000,\n\n  /** Delay after render before capture (ms) */\n  captureDelayMs: 100,\n\n  /** Font loading timeout (ms) */\n  fontTimeoutMs: 3000,\n\n  /** Default theme */\n  theme: \"light\" as const,\n\n  /** Dev server port */\n  port: 6006,\n} as const;\n\nexport type Defaults = typeof DEFAULTS;\n","import { z } from 'zod';\n\n/**\n * Zod schemas for runtime validation of segment definitions\n */\n\n// Figma property mapping schemas\nconst figmaStringMappingSchema = z.object({\n  __type: z.literal('figma-string'),\n  figmaProperty: z.string().min(1),\n});\n\nconst figmaBooleanMappingSchema = z.object({\n  __type: z.literal('figma-boolean'),\n  figmaProperty: z.string().min(1),\n  valueMapping: z.object({ true: z.unknown(), false: z.unknown() }).optional(),\n});\n\nconst figmaEnumMappingSchema = z.object({\n  __type: z.literal('figma-enum'),\n  figmaProperty: z.string().min(1),\n  valueMapping: z.record(z.unknown()),\n});\n\nconst figmaInstanceMappingSchema = z.object({\n  __type: z.literal('figma-instance'),\n  figmaProperty: z.string().min(1),\n});\n\nconst figmaChildrenMappingSchema = z.object({\n  __type: z.literal('figma-children'),\n  layers: z.array(z.string().min(1)),\n});\n\nconst figmaTextContentMappingSchema = z.object({\n  __type: z.literal('figma-text-content'),\n  layer: z.string().min(1),\n});\n\nexport const figmaPropMappingSchema = z.discriminatedUnion('__type', [\n  figmaStringMappingSchema,\n  figmaBooleanMappingSchema,\n  figmaEnumMappingSchema,\n  figmaInstanceMappingSchema,\n  figmaChildrenMappingSchema,\n  figmaTextContentMappingSchema,\n]);\n\nexport const segmentMetaSchema = z.object({\n  name: z.string().min(1),\n  description: z.string().min(1),\n  category: z.string().min(1),\n  tags: z.array(z.string()).optional(),\n  status: z.enum(['stable', 'beta', 'deprecated', 'experimental']).optional(),\n  since: z.string().optional(),\n  figma: z.string().url().optional(),\n  figmaProps: z.record(figmaPropMappingSchema).optional(),\n});\n\nexport const segmentUsageSchema = z.object({\n  when: z.array(z.string()).min(1),\n  whenNot: z.array(z.string()).min(1),\n  guidelines: z.array(z.string()).optional(),\n  accessibility: z.array(z.string()).optional(),\n});\n\nexport const propTypeSchema: z.ZodType<string> = z.enum([\n  'string',\n  'number',\n  'boolean',\n  'enum',\n  'function',\n  'node',\n  'element',\n  'object',\n  'array',\n  'union',\n  'custom',\n]);\n\nexport const propDefinitionSchema = z.object({\n  type: propTypeSchema,\n  values: z.array(z.string()).readonly().optional(),\n  default: z.unknown().optional(),\n  description: z.string().optional(),\n  required: z.boolean().optional(),\n  constraints: z.array(z.string()).optional(),\n  typeDetails: z.record(z.unknown()).optional(),\n});\n\nexport const relationshipTypeSchema = z.enum([\n  'alternative',\n  'sibling',\n  'parent',\n  'child',\n  'composition',\n  'complementary',\n  'used-by',\n]);\n\nexport const componentRelationSchema = z.object({\n  component: z.string().min(1),\n  relationship: relationshipTypeSchema,\n  note: z.string().min(1),\n});\n\nexport const segmentVariantSchema = z.object({\n  name: z.string().min(1),\n  description: z.string().min(1),\n  render: z.function().returns(z.unknown()),\n  code: z.string().optional(),\n  figma: z.string().url().optional(),\n});\n\n/**\n * Schema for banned patterns in codebase\n */\nexport const segmentBanSchema = z.object({\n  pattern: z.string().min(1),\n  message: z.string().min(1),\n});\n\n/**\n * Schema for agent-optimized contract metadata\n */\nexport const segmentContractSchema = z.object({\n  propsSummary: z.array(z.string()).optional(),\n  a11yRules: z.array(z.string()).optional(),\n  bans: z.array(segmentBanSchema).optional(),\n  scenarioTags: z.array(z.string()).optional(),\n});\n\n/**\n * Schema for provenance tracking of generated segments\n */\nexport const segmentGeneratedSchema = z.object({\n  source: z.enum(['storybook', 'manual', 'ai']),\n  sourceFile: z.string().optional(),\n  confidence: z.number().min(0).max(1).optional(),\n  timestamp: z.string().datetime().optional(),\n});\n\n/**\n * Schema for AI-specific metadata for playground context generation\n */\nexport const aiMetadataSchema = z.object({\n  compositionPattern: z.enum(['compound', 'simple', 'controlled']).optional(),\n  subComponents: z.array(z.string()).optional(),\n  requiredChildren: z.array(z.string()).optional(),\n  commonPatterns: z.array(z.string()).optional(),\n});\n\n/**\n * Schema for block definitions\n */\nexport const blockDefinitionSchema = z.object({\n  name: z.string().min(1),\n  description: z.string().min(1),\n  category: z.string().min(1),\n  components: z.array(z.string().min(1)).min(1),\n  code: z.string().min(1),\n  tags: z.array(z.string()).optional(),\n});\n\nexport const segmentDefinitionSchema = z.object({\n  component: z.any(), // Allow any component type (function, class, forwardRef, etc.)\n  meta: segmentMetaSchema,\n  usage: segmentUsageSchema,\n  props: z.record(propDefinitionSchema),\n  relations: z.array(componentRelationSchema).optional(),\n  variants: z.array(segmentVariantSchema), // Allow empty variants array\n  contract: segmentContractSchema.optional(),\n  ai: aiMetadataSchema.optional(),\n  _generated: segmentGeneratedSchema.optional(),\n});\n\n/**\n * Config schema - validates required fields, passes through optional config objects.\n * Type definitions are in types.ts - schema just ensures basic structure.\n */\nexport const segmentsConfigSchema = z.object({\n  include: z.array(z.string()).min(1),\n  exclude: z.array(z.string()).optional(),\n  components: z.array(z.string()).optional(),\n  outFile: z.string().optional(),\n  framework: z.enum(['react', 'vue', 'svelte']).optional(),\n  figmaFile: z.string().url().optional(),\n  figmaToken: z.string().optional(),\n  screenshots: z.object({}).passthrough().optional(),\n  service: z.object({}).passthrough().optional(),\n  registry: z.object({}).passthrough().optional(),\n  tokens: z.object({\n    include: z.array(z.string()).min(1),\n  }).passthrough().optional(),\n});\n\n/**\n * @deprecated Use blockDefinitionSchema instead\n */\nexport const recipeDefinitionSchema = blockDefinitionSchema;\n"],"mappings":"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","names":[]}