dispersa 0.4.0 → 0.4.2

package/dist/{index-BkvV7Z54.d.cts → index-CNT2Meyf.d.cts}

@@ -3,6 +3,73 @@ import { B as BuildConfigBase, O as OutputConfigBase, P as Preprocessor, D as Di
 import { T as Transform } from './types-BAv39mum.cjs';
 import { R as ResolvedTokens } from './types-Bc0kA7De.cjs';
 
+/**
+ * @fileoverview DTCG Resolver types (2025.10 specification)
+ *
+ * The resolver system allows defining token sources, modifiers (themes, modes),
+ * and the order in which they should be resolved and merged.
+ *
+ * ResolverDocument type is defined here to match DTCG 2025.10.
+ */
+type ReferenceObject = {
+    $ref: string;
+};
+type TokenSource = ReferenceObject | Record<string, unknown>;
+type Set = {
+    sources: TokenSource[];
+    description?: string;
+    $extensions?: Record<string, unknown>;
+};
+type Modifier = {
+    contexts: Record<string, TokenSource[]>;
+    description?: string;
+    default?: string;
+    $extensions?: Record<string, unknown>;
+};
+type InlineSet = Set & {
+    name: string;
+    type: 'set';
+};
+type InlineModifier = Modifier & {
+    name: string;
+    type: 'modifier';
+};
+type ResolverDocument = {
+    $schema?: string;
+    name?: string;
+    version: '2025.10';
+    description?: string;
+    sets?: Record<string, Set>;
+    modifiers?: Record<string, Modifier>;
+    resolutionOrder: (ReferenceObject | InlineSet | InlineModifier)[];
+    $defs?: Record<string, unknown>;
+};
+/**
+ * Map of modifier names to selected context values
+ *
+ * Used to specify which variation of each modifier to use when resolving tokens.
+ * Can be made type-safe by providing a generic type parameter.
+ *
+ * @template T - Optional specific type for modifier values (defaults to generic Record)
+ *
+ * @example
+ * ```typescript
+ * // Generic (default):
+ * const inputs: ModifierInputs = {
+ *   theme: 'dark',
+ *   platform: 'mobile'
+ * }
+ *
+ * // Type-safe:
+ * type MyModifiers = { theme: 'light' | 'dark', platform: 'web' | 'mobile' }
+ * const inputs: ModifierInputs<MyModifiers> = {
+ *   theme: 'dark',  // ✅ Autocomplete!
+ *   platform: 'mobile'
+ * }
+ * ```
+ */
+type ModifierInputs<T extends Record<string, string> = Record<string, string>> = T;
+
 /**
  * @license MIT
  * Copyright (c) 2025-present Dispersa Contributors
@@ -128,6 +195,11 @@ type AndroidRendererOptions = {
 
 /**
  * @fileoverview Renderer system types for token output generation
+ *
+ * Note: renderers/types and config have a mutual type-only dependency.
+ * RenderContext references OutputConfig, while OutputConfig references
+ * Renderer/FormatOptions. This is acceptable because type imports are
+ * erased at runtime and the coupling is genuine.
  */
 
 /**
@@ -325,7 +397,7 @@ type CssRendererOptions = {
 /**
  * Error code identifying the type of build error
  */
-type ErrorCode = 'TOKEN_REFERENCE' | 'CIRCULAR_REFERENCE' | 'VALIDATION' | 'COLOR_PARSE' | 'DIMENSION_FORMAT' | 'FILE_OPERATION' | 'CONFIGURATION' | 'BASE_PERMUTATION' | 'MODIFIER' | 'UNKNOWN';
+type ErrorCode = 'TOKEN_REFERENCE' | 'CIRCULAR_REFERENCE' | 'VALIDATION' | 'FILE_OPERATION' | 'CONFIGURATION' | 'BASE_PERMUTATION' | 'MODIFIER' | 'UNKNOWN';
 /**
  * Structured error from a build operation
  *
@@ -355,73 +427,6 @@ type BuildResult = {
     errors?: BuildError[];
 };
 
-/**
- * @fileoverview DTCG Resolver types (2025.10 specification)
- *
- * The resolver system allows defining token sources, modifiers (themes, modes),
- * and the order in which they should be resolved and merged.
- *
- * ResolverDocument type is defined here to match DTCG 2025.10.
- */
-type ReferenceObject = {
-    $ref: string;
-};
-type TokenSource = ReferenceObject | Record<string, unknown>;
-type Set = {
-    sources: TokenSource[];
-    description?: string;
-    $extensions?: Record<string, unknown>;
-};
-type Modifier = {
-    contexts: Record<string, TokenSource[]>;
-    description?: string;
-    default?: string;
-    $extensions?: Record<string, unknown>;
-};
-type InlineSet = Set & {
-    name: string;
-    type: 'set';
-};
-type InlineModifier = Modifier & {
-    name: string;
-    type: 'modifier';
-};
-type ResolverDocument = {
-    $schema?: string;
-    name?: string;
-    version: '2025.10';
-    description?: string;
-    sets?: Record<string, Set>;
-    modifiers?: Record<string, Modifier>;
-    resolutionOrder: (ReferenceObject | InlineSet | InlineModifier)[];
-    $defs?: Record<string, unknown>;
-};
-/**
- * Map of modifier names to selected context values
- *
- * Used to specify which variation of each modifier to use when resolving tokens.
- * Can be made type-safe by providing a generic type parameter.
- *
- * @template T - Optional specific type for modifier values (defaults to generic Record)
- *
- * @example
- * ```typescript
- * // Generic (default):
- * const inputs: ModifierInputs = {
- *   theme: 'dark',
- *   platform: 'mobile'
- * }
- *
- * // Type-safe:
- * type MyModifiers = { theme: 'light' | 'dark', platform: 'web' | 'mobile' }
- * const inputs: ModifierInputs<MyModifiers> = {
- *   theme: 'dark',  // ✅ Autocomplete!
- *   platform: 'mobile'
- * }
- * ```
- */
-type ModifierInputs<T extends Record<string, string> = Record<string, string>> = T;
-
 /**
  * @fileoverview Validation configuration types
  */
@@ -449,6 +454,12 @@ type ValidationOptions = {
 
 /**
  * @fileoverview Configuration types for Dispersa
+ *
+ * Note: config and renderers/types have a mutual type-only dependency.
+ * OutputConfig references Renderer/FormatOptions, while RenderContext
+ * references OutputConfig. This is acceptable because type imports are
+ * erased at runtime and the coupling is genuine (config describes how
+ * to drive renderers).
  */
 
 /**
@@ -472,7 +483,13 @@ type LifecycleHooks = {
     /** Called after all outputs have been processed (success or failure) */
     onBuildEnd?: (result: BuildResult) => void | Promise<void>;
 };
-
+/**
+ * Function that generates an output file path based on modifier inputs.
+ *
+ * Used as the `file` property on `OutputConfig` and builder configs when
+ * the file name needs to vary per permutation.
+ */
+type FileFunction = (modifierInputs: ModifierInputs) => string;
 /**
  * Output configuration for a single build target
  *
@@ -577,7 +594,7 @@ type OutputConfig<TOptions extends FormatOptions = FormatOptions> = Omit<OutputC
      * }
      * ```
      */
-    file?: string | ((modifierInputs: ModifierInputs) => string);
+    file?: string | FileFunction;
     /**
      * Renderer-specific options passed to the formatter.
      */
@@ -683,11 +700,6 @@ type BuildConfig = Omit<BuildConfigBase, 'outputs' | 'filters' | 'transforms' |
     /** Global lifecycle hooks for the build process */
     hooks?: LifecycleHooks;
 };
-/**
- * Global options for Dispersa instance behavior
- *
- * Uses the generated base type from schemas - all properties match exactly.
- */
 /**
  * Dispersa options with runtime-only validation helpers
  *
@@ -701,4 +713,4 @@ type DispersaOptions = Omit<DispersaOptionsBase, 'validation'> & {
     validation?: ValidationOptions;
 };
 
-export { type AndroidRendererOptions as A, type BuildConfig as B, type CssRendererOptions as C, type DispersaOptions as D, type ErrorCode as E, type FormatOptions as F, type IosRendererOptions as I, type LifecycleHooks as L, type ModifierInputs as M, type OutputConfig as O, type PermutationData as P, type ResolverDocument as R, type SelectorFunction as S, type TailwindRendererOptions as T, type ValidationOptions as V, type BuildResult as a, type ValidationMode as b, type BuildError as c, type BuildOutput as d, type MediaQueryFunction as e, type OutputTree as f, type Renderer as g, type RenderContext as h, type RenderMeta as i, type RenderOutput as j, defineRenderer as k };
+export { type AndroidRendererOptions as A, type BuildConfig as B, type CssRendererOptions as C, type DispersaOptions as D, type ErrorCode as E, type FileFunction as F, type IosRendererOptions as I, type LifecycleHooks as L, type ModifierInputs as M, type OutputConfig as O, type PermutationData as P, type ResolverDocument as R, type SelectorFunction as S, type TailwindRendererOptions as T, type ValidationMode as V, type BuildResult as a, type ValidationOptions as b, type BuildError as c, type BuildOutput as d, type FormatOptions as e, type MediaQueryFunction as f, type OutputTree as g, type Renderer as h, type RenderContext as i, type RenderMeta as j, type RenderOutput as k, defineRenderer as l };

package/dist/{index-DJ_UHSQG.d.ts → index-CqdaN3X0.d.ts}

@@ -3,6 +3,73 @@ import { B as BuildConfigBase, O as OutputConfigBase, P as Preprocessor, D as Di
 import { T as Transform } from './types-CzHa7YkW.js';
 import { R as ResolvedTokens } from './types-Bc0kA7De.js';
 
+/**
+ * @fileoverview DTCG Resolver types (2025.10 specification)
+ *
+ * The resolver system allows defining token sources, modifiers (themes, modes),
+ * and the order in which they should be resolved and merged.
+ *
+ * ResolverDocument type is defined here to match DTCG 2025.10.
+ */
+type ReferenceObject = {
+    $ref: string;
+};
+type TokenSource = ReferenceObject | Record<string, unknown>;
+type Set = {
+    sources: TokenSource[];
+    description?: string;
+    $extensions?: Record<string, unknown>;
+};
+type Modifier = {
+    contexts: Record<string, TokenSource[]>;
+    description?: string;
+    default?: string;
+    $extensions?: Record<string, unknown>;
+};
+type InlineSet = Set & {
+    name: string;
+    type: 'set';
+};
+type InlineModifier = Modifier & {
+    name: string;
+    type: 'modifier';
+};
+type ResolverDocument = {
+    $schema?: string;
+    name?: string;
+    version: '2025.10';
+    description?: string;
+    sets?: Record<string, Set>;
+    modifiers?: Record<string, Modifier>;
+    resolutionOrder: (ReferenceObject | InlineSet | InlineModifier)[];
+    $defs?: Record<string, unknown>;
+};
+/**
+ * Map of modifier names to selected context values
+ *
+ * Used to specify which variation of each modifier to use when resolving tokens.
+ * Can be made type-safe by providing a generic type parameter.
+ *
+ * @template T - Optional specific type for modifier values (defaults to generic Record)
+ *
+ * @example
+ * ```typescript
+ * // Generic (default):
+ * const inputs: ModifierInputs = {
+ *   theme: 'dark',
+ *   platform: 'mobile'
+ * }
+ *
+ * // Type-safe:
+ * type MyModifiers = { theme: 'light' | 'dark', platform: 'web' | 'mobile' }
+ * const inputs: ModifierInputs<MyModifiers> = {
+ *   theme: 'dark',  // ✅ Autocomplete!
+ *   platform: 'mobile'
+ * }
+ * ```
+ */
+type ModifierInputs<T extends Record<string, string> = Record<string, string>> = T;
+
 /**
  * @license MIT
  * Copyright (c) 2025-present Dispersa Contributors
@@ -128,6 +195,11 @@ type AndroidRendererOptions = {
 
 /**
  * @fileoverview Renderer system types for token output generation
+ *
+ * Note: renderers/types and config have a mutual type-only dependency.
+ * RenderContext references OutputConfig, while OutputConfig references
+ * Renderer/FormatOptions. This is acceptable because type imports are
+ * erased at runtime and the coupling is genuine.
  */
 
 /**
@@ -325,7 +397,7 @@ type CssRendererOptions = {
 /**
  * Error code identifying the type of build error
  */
-type ErrorCode = 'TOKEN_REFERENCE' | 'CIRCULAR_REFERENCE' | 'VALIDATION' | 'COLOR_PARSE' | 'DIMENSION_FORMAT' | 'FILE_OPERATION' | 'CONFIGURATION' | 'BASE_PERMUTATION' | 'MODIFIER' | 'UNKNOWN';
+type ErrorCode = 'TOKEN_REFERENCE' | 'CIRCULAR_REFERENCE' | 'VALIDATION' | 'FILE_OPERATION' | 'CONFIGURATION' | 'BASE_PERMUTATION' | 'MODIFIER' | 'UNKNOWN';
 /**
  * Structured error from a build operation
  *
@@ -355,73 +427,6 @@ type BuildResult = {
     errors?: BuildError[];
 };
 
-/**
- * @fileoverview DTCG Resolver types (2025.10 specification)
- *
- * The resolver system allows defining token sources, modifiers (themes, modes),
- * and the order in which they should be resolved and merged.
- *
- * ResolverDocument type is defined here to match DTCG 2025.10.
- */
-type ReferenceObject = {
-    $ref: string;
-};
-type TokenSource = ReferenceObject | Record<string, unknown>;
-type Set = {
-    sources: TokenSource[];
-    description?: string;
-    $extensions?: Record<string, unknown>;
-};
-type Modifier = {
-    contexts: Record<string, TokenSource[]>;
-    description?: string;
-    default?: string;
-    $extensions?: Record<string, unknown>;
-};
-type InlineSet = Set & {
-    name: string;
-    type: 'set';
-};
-type InlineModifier = Modifier & {
-    name: string;
-    type: 'modifier';
-};
-type ResolverDocument = {
-    $schema?: string;
-    name?: string;
-    version: '2025.10';
-    description?: string;
-    sets?: Record<string, Set>;
-    modifiers?: Record<string, Modifier>;
-    resolutionOrder: (ReferenceObject | InlineSet | InlineModifier)[];
-    $defs?: Record<string, unknown>;
-};
-/**
- * Map of modifier names to selected context values
- *
- * Used to specify which variation of each modifier to use when resolving tokens.
- * Can be made type-safe by providing a generic type parameter.
- *
- * @template T - Optional specific type for modifier values (defaults to generic Record)
- *
- * @example
- * ```typescript
- * // Generic (default):
- * const inputs: ModifierInputs = {
- *   theme: 'dark',
- *   platform: 'mobile'
- * }
- *
- * // Type-safe:
- * type MyModifiers = { theme: 'light' | 'dark', platform: 'web' | 'mobile' }
- * const inputs: ModifierInputs<MyModifiers> = {
- *   theme: 'dark',  // ✅ Autocomplete!
- *   platform: 'mobile'
- * }
- * ```
- */
-type ModifierInputs<T extends Record<string, string> = Record<string, string>> = T;
-
 /**
  * @fileoverview Validation configuration types
  */
@@ -449,6 +454,12 @@ type ValidationOptions = {
 
 /**
  * @fileoverview Configuration types for Dispersa
+ *
+ * Note: config and renderers/types have a mutual type-only dependency.
+ * OutputConfig references Renderer/FormatOptions, while RenderContext
+ * references OutputConfig. This is acceptable because type imports are
+ * erased at runtime and the coupling is genuine (config describes how
+ * to drive renderers).
  */
 
 /**
@@ -472,7 +483,13 @@ type LifecycleHooks = {
     /** Called after all outputs have been processed (success or failure) */
     onBuildEnd?: (result: BuildResult) => void | Promise<void>;
 };
-
+/**
+ * Function that generates an output file path based on modifier inputs.
+ *
+ * Used as the `file` property on `OutputConfig` and builder configs when
+ * the file name needs to vary per permutation.
+ */
+type FileFunction = (modifierInputs: ModifierInputs) => string;
 /**
  * Output configuration for a single build target
  *
@@ -577,7 +594,7 @@ type OutputConfig<TOptions extends FormatOptions = FormatOptions> = Omit<OutputC
      * }
      * ```
      */
-    file?: string | ((modifierInputs: ModifierInputs) => string);
+    file?: string | FileFunction;
     /**
      * Renderer-specific options passed to the formatter.
      */
@@ -683,11 +700,6 @@ type BuildConfig = Omit<BuildConfigBase, 'outputs' | 'filters' | 'transforms' |
     /** Global lifecycle hooks for the build process */
     hooks?: LifecycleHooks;
 };
-/**
- * Global options for Dispersa instance behavior
- *
- * Uses the generated base type from schemas - all properties match exactly.
- */
 /**
  * Dispersa options with runtime-only validation helpers
  *
@@ -701,4 +713,4 @@ type DispersaOptions = Omit<DispersaOptionsBase, 'validation'> & {
     validation?: ValidationOptions;
 };
 
-export { type AndroidRendererOptions as A, type BuildConfig as B, type CssRendererOptions as C, type DispersaOptions as D, type ErrorCode as E, type FormatOptions as F, type IosRendererOptions as I, type LifecycleHooks as L, type ModifierInputs as M, type OutputConfig as O, type PermutationData as P, type ResolverDocument as R, type SelectorFunction as S, type TailwindRendererOptions as T, type ValidationOptions as V, type BuildResult as a, type ValidationMode as b, type BuildError as c, type BuildOutput as d, type MediaQueryFunction as e, type OutputTree as f, type Renderer as g, type RenderContext as h, type RenderMeta as i, type RenderOutput as j, defineRenderer as k };
+export { type AndroidRendererOptions as A, type BuildConfig as B, type CssRendererOptions as C, type DispersaOptions as D, type ErrorCode as E, type FileFunction as F, type IosRendererOptions as I, type LifecycleHooks as L, type ModifierInputs as M, type OutputConfig as O, type PermutationData as P, type ResolverDocument as R, type SelectorFunction as S, type TailwindRendererOptions as T, type ValidationMode as V, type BuildResult as a, type ValidationOptions as b, type BuildError as c, type BuildOutput as d, type FormatOptions as e, type MediaQueryFunction as f, type OutputTree as g, type Renderer as h, type RenderContext as i, type RenderMeta as j, type RenderOutput as k, defineRenderer as l };