@fragments-sdk/core 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -465,6 +465,39 @@ interface StorybookFilterConfig {
     /** Exclude sub-components detected by directory structure (default: true) */
     excludeSubComponents?: boolean;
 }
+/**
+ * Theme seed configuration.
+ * The 5 root values that derive 120+ CSS custom properties.
+ */
+interface ThemeSeeds {
+    /** Primary brand color as hex (e.g., "#6366f1") */
+    brand?: string;
+    /** Neutral palette name */
+    neutral?: 'stone' | 'ice' | 'earth' | 'sand' | 'fire';
+    /** Spacing density scale */
+    density?: 'compact' | 'default' | 'relaxed';
+    /** Border radius style */
+    radiusStyle?: 'sharp' | 'subtle' | 'default' | 'rounded' | 'pill';
+    /** Danger/error color as hex (e.g., "#ef4444") */
+    danger?: string;
+}
+/**
+ * Visual snapshot testing configuration.
+ */
+interface SnapshotConfig {
+    /** Enable visual snapshot tests (default: false) */
+    enabled: boolean;
+    /** Output directory for snapshot baselines (relative to project root) */
+    outputDir?: string;
+    /** Viewport width for snapshots (default: 1440) */
+    viewportWidth?: number;
+    /** Viewport height for snapshots (default: 1100) */
+    viewportHeight?: number;
+    /** Diff threshold percentage before a snapshot fails (default: 0.1) */
+    threshold?: number;
+    /** Disable CSS animations during capture (default: true) */
+    disableAnimations?: boolean;
+}
 /**
  * Config file structure
  */
@@ -504,6 +537,10 @@ interface FragmentsConfig {
     };
     /** Storybook adapter filtering configuration */
     storybook?: StorybookFilterConfig;
+    /** Theme seed values for the 5-seed theming system */
+    theme?: ThemeSeeds;
+    /** Visual snapshot testing configuration */
+    snapshots?: SnapshotConfig;
 }
 /**
  * Screenshot capture configuration
@@ -1238,16 +1275,16 @@ declare const propDefinitionSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     type: string;
     values?: readonly string[] | undefined;
-    description?: string | undefined;
     default?: unknown;
+    description?: string | undefined;
     required?: boolean | undefined;
     constraints?: string[] | undefined;
     typeDetails?: Record<string, unknown> | undefined;
 }, {
     type: string;
     values?: readonly string[] | undefined;
-    description?: string | undefined;
     default?: unknown;
+    description?: string | undefined;
     required?: boolean | undefined;
     constraints?: string[] | undefined;
     typeDetails?: Record<string, unknown> | undefined;
@@ -1598,16 +1635,16 @@ declare const fragmentDefinitionSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         type: string;
         values?: readonly string[] | undefined;
-        description?: string | undefined;
         default?: unknown;
+        description?: string | undefined;
         required?: boolean | undefined;
         constraints?: string[] | undefined;
         typeDetails?: Record<string, unknown> | undefined;
     }, {
         type: string;
         values?: readonly string[] | undefined;
-        description?: string | undefined;
         default?: unknown;
+        description?: string | undefined;
         required?: boolean | undefined;
         constraints?: string[] | undefined;
         typeDetails?: Record<string, unknown> | undefined;
@@ -1758,8 +1795,8 @@ declare const fragmentDefinitionSchema: z.ZodObject<{
     props: Record<string, {
         type: string;
         values?: readonly string[] | undefined;
-        description?: string | undefined;
         default?: unknown;
+        description?: string | undefined;
         required?: boolean | undefined;
         constraints?: string[] | undefined;
         typeDetails?: Record<string, unknown> | undefined;
@@ -1847,8 +1884,8 @@ declare const fragmentDefinitionSchema: z.ZodObject<{
     props: Record<string, {
         type: string;
         values?: readonly string[] | undefined;
-        description?: string | undefined;
         default?: unknown;
+        description?: string | undefined;
         required?: boolean | undefined;
         constraints?: string[] | undefined;
         typeDetails?: Record<string, unknown> | undefined;
@@ -1937,12 +1974,12 @@ declare const fragmentsConfigSchema: z.ZodObject<{
             bundleSize?: number | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
-        preset?: "strict" | "standard" | "relaxed" | undefined;
+        preset?: "relaxed" | "strict" | "standard" | undefined;
         budgets?: {
             bundleSize?: number | undefined;
         } | undefined;
     }, {
-        preset?: "strict" | "standard" | "relaxed" | undefined;
+        preset?: "relaxed" | "strict" | "standard" | undefined;
         budgets?: {
             bundleSize?: number | undefined;
         } | undefined;
@@ -1997,8 +2034,8 @@ declare const fragmentsConfigSchema: z.ZodObject<{
         requireFullSnippet?: boolean | undefined;
         allowedExternalModules?: string[] | undefined;
     } | undefined;
-    performance?: "strict" | "standard" | "relaxed" | {
-        preset?: "strict" | "standard" | "relaxed" | undefined;
+    performance?: "relaxed" | "strict" | "standard" | {
+        preset?: "relaxed" | "strict" | "standard" | undefined;
         budgets?: {
             bundleSize?: number | undefined;
         } | undefined;
@@ -2031,8 +2068,8 @@ declare const fragmentsConfigSchema: z.ZodObject<{
         requireFullSnippet?: boolean | undefined;
         allowedExternalModules?: string[] | undefined;
     } | undefined;
-    performance?: "strict" | "standard" | "relaxed" | {
-        preset?: "strict" | "standard" | "relaxed" | undefined;
+    performance?: "relaxed" | "strict" | "standard" | {
+        preset?: "relaxed" | "strict" | "standard" | undefined;
         budgets?: {
             bundleSize?: number | undefined;
         } | undefined;
@@ -2870,4 +2907,4 @@ interface PreviewVariantRuntimeProps extends PreviewRuntimeOptions {
  */
 declare function PreviewVariantRuntime({ variant, loadedData, children, }: PreviewVariantRuntimeProps): react_jsx_runtime.JSX.Element;
 
-export { type AIMetadata, BRAND, type BaselineInfo, type BlockDefinition, type BoundingBox, type Brand, type CSF2Story, type CheckStoryExclusionOpts, type CompiledRecipe, type ComplexityTier, type ComponentRelation, type CompositionAnalysis, type CompositionGuideline, type CompositionSuggestion, type CompositionWarning, type ControlType, DEFAULTS, type Decorator, type Defaults, type DesignToken, type DiffResult, type EnhancedStyleDiffItem, type ExclusionReason, type ExclusionResult, type FigmaBooleanMapping, type FigmaChildrenMapping, type FigmaEnumMapping, type FigmaInstanceMapping, type FigmaPropMapping, type FigmaStringMapping, type FigmaTextContentMapping, type Fragment, type FragmentAccessibility, type FragmentComponent, type FragmentContextOptions, type FragmentContract, type FragmentDefinition, type FragmentDoNotItem, type FragmentFigma, type FragmentGenerated, type FragmentIndex, type FragmentMeta as FragmentJsonMeta, type FragmentUsage as FragmentJsonUsage, type FragmentMeta$1 as FragmentMeta, type FragmentPattern, type FragmentRegistry, type FragmentRelated, type FragmentUsage$1 as FragmentUsage, type FragmentVariant, type FragmentsConfig, type InferProps, type Loader, type Manifest, PRESET_NAMES, type ParsedToken, type PerformanceData as PerfData, type PerformanceSummary as PerfSummary, type PerformanceBudgets, type PerformanceConfig, type PlayFunction, type PlayFunctionContext, type PreviewConfig, type PreviewRuntimeOptions, type PreviewRuntimeState, type PreviewVariantLike, PreviewVariantRuntime, type PropDefinition, type PropType, type RecipeDefinition, type RegistryComponentEntry, type RegistryOptions, type RegistryPropEntry, type RelationshipType, type Screenshot, type ScreenshotConfig, type ScreenshotMetadata, type ServiceConfig, type SnippetPolicyConfig, type Story, type StoryArgType, type StoryContext, type StoryMeta, type StoryModule, type StorybookFilterConfig, type Theme, type TokenCategory, type TokenConfig, type TokenFix, type TokenMatchRequest, type TokenMatchResult, type TokenParseError, type TokenParseOutput, type TokenParseResult, type TokenRegistry, type TokenRegistryMeta, type TokenUsageSummary, type VariantLoader, type VerifyRequest, type VerifyResult, type Viewport, aiMetadataSchema, analyzeComposition, blockDefinitionSchema, budgetBar, checkStoryExclusion, classifyComplexity, compileBlock, compileFragment, compileRecipe, componentRelationSchema, defineBlock, defineFragment, defineRecipe, detectSubComponentPaths, executeVariantLoaders, figma, figmaPropMappingSchema, formatBytes, fragmentBanSchema, fragmentContractSchema, fragmentDefinitionSchema, fragmentGeneratedSchema, fragmentMetaSchema, fragmentUsageSchema, fragmentVariantSchema, fragmentsConfigSchema, getPreviewConfig, isConfigExcluded, isExportStory, isFigmaPropMapping, isForceIncluded, parseTokenFile, propDefinitionSchema, recipeDefinitionSchema, resolveFigmaMapping, resolvePerformanceConfig, resolvePreviewRuntimeState, setPreviewConfig, storyModuleToFragment, storyNameFromExport, toId, usePreviewVariantRuntime };
+export { type AIMetadata, BRAND, type BaselineInfo, type BlockDefinition, type BoundingBox, type Brand, type CSF2Story, type CheckStoryExclusionOpts, type CompiledRecipe, type ComplexityTier, type ComponentRelation, type CompositionAnalysis, type CompositionGuideline, type CompositionSuggestion, type CompositionWarning, type ControlType, DEFAULTS, type Decorator, type Defaults, type DesignToken, type DiffResult, type EnhancedStyleDiffItem, type ExclusionReason, type ExclusionResult, type FigmaBooleanMapping, type FigmaChildrenMapping, type FigmaEnumMapping, type FigmaInstanceMapping, type FigmaPropMapping, type FigmaStringMapping, type FigmaTextContentMapping, type Fragment, type FragmentAccessibility, type FragmentComponent, type FragmentContextOptions, type FragmentContract, type FragmentDefinition, type FragmentDoNotItem, type FragmentFigma, type FragmentGenerated, type FragmentIndex, type FragmentMeta as FragmentJsonMeta, type FragmentUsage as FragmentJsonUsage, type FragmentMeta$1 as FragmentMeta, type FragmentPattern, type FragmentRegistry, type FragmentRelated, type FragmentUsage$1 as FragmentUsage, type FragmentVariant, type FragmentsConfig, type InferProps, type Loader, type Manifest, PRESET_NAMES, type ParsedToken, type PerformanceData as PerfData, type PerformanceSummary as PerfSummary, type PerformanceBudgets, type PerformanceConfig, type PlayFunction, type PlayFunctionContext, type PreviewConfig, type PreviewRuntimeOptions, type PreviewRuntimeState, type PreviewVariantLike, PreviewVariantRuntime, type PropDefinition, type PropType, type RecipeDefinition, type RegistryComponentEntry, type RegistryOptions, type RegistryPropEntry, type RelationshipType, type Screenshot, type ScreenshotConfig, type ScreenshotMetadata, type ServiceConfig, type SnapshotConfig, type SnippetPolicyConfig, type Story, type StoryArgType, type StoryContext, type StoryMeta, type StoryModule, type StorybookFilterConfig, type Theme, type ThemeSeeds, type TokenCategory, type TokenConfig, type TokenFix, type TokenMatchRequest, type TokenMatchResult, type TokenParseError, type TokenParseOutput, type TokenParseResult, type TokenRegistry, type TokenRegistryMeta, type TokenUsageSummary, type VariantLoader, type VerifyRequest, type VerifyResult, type Viewport, aiMetadataSchema, analyzeComposition, blockDefinitionSchema, budgetBar, checkStoryExclusion, classifyComplexity, compileBlock, compileFragment, compileRecipe, componentRelationSchema, defineBlock, defineFragment, defineRecipe, detectSubComponentPaths, executeVariantLoaders, figma, figmaPropMappingSchema, formatBytes, fragmentBanSchema, fragmentContractSchema, fragmentDefinitionSchema, fragmentGeneratedSchema, fragmentMetaSchema, fragmentUsageSchema, fragmentVariantSchema, fragmentsConfigSchema, getPreviewConfig, isConfigExcluded, isExportStory, isFigmaPropMapping, isForceIncluded, parseTokenFile, propDefinitionSchema, recipeDefinitionSchema, resolveFigmaMapping, resolvePerformanceConfig, resolvePreviewRuntimeState, setPreviewConfig, storyModuleToFragment, storyNameFromExport, toId, usePreviewVariantRuntime };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fragments-sdk/core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "license": "MIT",
   "description": "Core types, schemas, and runtime API for Fragments component definitions",
   "author": "Conan McNicholl",
@@ -40,7 +40,7 @@
     "zod": "^3.24.1"
   },
   "peerDependencies": {
-    "@fragments-sdk/context": ">=0.4.0",
+    "@fragments-sdk/context": ">=0.4.3",
     "@storybook/csf": "^0.1.0",
     "react": ">=18"
   },
@@ -63,7 +63,7 @@
     "tsup": "^8.3.5",
     "typescript": "^5.7.2",
     "vitest": "^2.1.8",
-    "@fragments-sdk/context": "0.4.2"
+    "@fragments-sdk/context": "0.4.3"
   },
   "scripts": {
     "build": "tsup",

package/src/index.ts

@@ -61,6 +61,9 @@ export type {
   StorybookFilterConfig,
   // Token configuration
   TokenConfig,
+  // Theme and snapshot configuration
+  ThemeSeeds,
+  SnapshotConfig,
   // Compiled token types
   CompiledTokenEntry,
   CompiledTokenData,

package/src/types.ts

@@ -473,6 +473,50 @@ export interface StorybookFilterConfig {
   excludeSubComponents?: boolean;
 }
 
+/**
+ * Theme seed configuration.
+ * The 5 root values that derive 120+ CSS custom properties.
+ */
+export interface ThemeSeeds {
+  /** Primary brand color as hex (e.g., "#6366f1") */
+  brand?: string;
+
+  /** Neutral palette name */
+  neutral?: 'stone' | 'ice' | 'earth' | 'sand' | 'fire';
+
+  /** Spacing density scale */
+  density?: 'compact' | 'default' | 'relaxed';
+
+  /** Border radius style */
+  radiusStyle?: 'sharp' | 'subtle' | 'default' | 'rounded' | 'pill';
+
+  /** Danger/error color as hex (e.g., "#ef4444") */
+  danger?: string;
+}
+
+/**
+ * Visual snapshot testing configuration.
+ */
+export interface SnapshotConfig {
+  /** Enable visual snapshot tests (default: false) */
+  enabled: boolean;
+
+  /** Output directory for snapshot baselines (relative to project root) */
+  outputDir?: string;
+
+  /** Viewport width for snapshots (default: 1440) */
+  viewportWidth?: number;
+
+  /** Viewport height for snapshots (default: 1100) */
+  viewportHeight?: number;
+
+  /** Diff threshold percentage before a snapshot fails (default: 0.1) */
+  threshold?: number;
+
+  /** Disable CSS animations during capture (default: true) */
+  disableAnimations?: boolean;
+}
+
 /**
  * Config file structure
  */
@@ -521,6 +565,12 @@ export interface FragmentsConfig {
 
   /** Storybook adapter filtering configuration */
   storybook?: StorybookFilterConfig;
+
+  /** Theme seed values for the 5-seed theming system */
+  theme?: ThemeSeeds;
+
+  /** Visual snapshot testing configuration */
+  snapshots?: SnapshotConfig;
 }
 
 /**