dispersa 0.1.3 → 0.2.0

package/dist/{index-CPB9Ea9U.d.ts → index-BP52gB00.d.ts}

@@ -4,71 +4,127 @@ import { T as Transform } from './types-DdPWYkgh.js';
 import { R as ResolvedTokens } from './types-C1GpiJ6q.js';
 
 /**
- * @fileoverview DTCG Resolver types (2025.10 specification)
+ * @license MIT
+ * Copyright (c) 2025-present Dispersa Contributors
  *
- * The resolver system allows defining token sources, modifiers (themes, modes),
- * and the order in which they should be resolved and merged.
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+/**
+ * Options for Tailwind CSS v4 renderer
  *
- * ResolverDocument type is defined here to match DTCG 2025.10.
+ * Controls how tokens are converted to Tailwind v4 @theme CSS variables.
+ *
+ * @example Bundle with dark mode overrides
+ * ```typescript
+ * tailwind({
+ *   name: 'tailwind',
+ *   file: 'theme.css',
+ *   preset: 'bundle',
+ *   selector: (modifier, context, isBase) => {
+ *     if (isBase) return ':root'
+ *     return `[data-${modifier}="${context}"]`
+ *   },
+ * })
+ * ```
  */
-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>;
+type TailwindRendererOptions = {
+    preset?: 'bundle' | 'standalone';
+    includeImport?: boolean;
+    namespace?: string;
+    minify?: boolean;
+    selector?: string | SelectorFunction;
+    mediaQuery?: string | MediaQueryFunction;
 };
+
 /**
- * Map of modifier names to selected context values
+ * @license MIT
+ * Copyright (c) 2025-present Dispersa Contributors
  *
- * Used to specify which variation of each modifier to use when resolving tokens.
- * Can be made type-safe by providing a generic type parameter.
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+/**
+ * Options for iOS/SwiftUI renderer
+ */
+type IosRendererOptions = {
+    preset?: 'standalone';
+    accessLevel?: 'public' | 'internal';
+    /**
+     * Output structure:
+     * - `'enum'` — nested enums inside a single root enum
+     * - `'grouped'` — namespace enum with separate extensions per token group
+     */
+    structure?: 'enum' | 'grouped';
+    enumName?: string;
+    /** Namespace enum name used in grouped mode (default: 'DesignTokens') */
+    extensionNamespace?: string;
+    colorSpace?: 'sRGB' | 'displayP3';
+    /**
+     * Target Swift language version.
+     * - `'5.9'` (default) — standard static let declarations
+     * - `'6.0'` — adds `nonisolated(unsafe)` to static properties for
+     *   Swift 6 strict concurrency compliance
+     */
+    swiftVersion?: '5.9' | '6.0';
+    /** Number of spaces per indentation level (default 4) */
+    indent?: number;
+    /** Add @frozen annotation to enums and structs for ABI stability (default false) */
+    frozen?: boolean;
+};
+
+/**
+ * @license MIT
+ * Copyright (c) 2025-present Dispersa Contributors
  *
- * @template T - Optional specific type for modifier values (defaults to generic Record)
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+/**
+ * Options for Android/Jetpack Compose renderer
  *
- * @example
- * ```typescript
- * // Generic (default):
- * const inputs: ModifierInputs = {
- *   theme: 'dark',
- *   platform: 'mobile'
- * }
+ * Note: `packageName` is marked optional for type compatibility with the Renderer
+ * generic, but is validated as required at runtime in the renderer's format() method.
  *
- * // Type-safe:
- * type MyModifiers = { theme: 'light' | 'dark', platform: 'web' | 'mobile' }
- * const inputs: ModifierInputs<MyModifiers> = {
- *   theme: 'dark',  // ✅ Autocomplete!
- *   platform: 'mobile'
- * }
- * ```
+ * @experimental This type is experimental. Properties and behavior may change.
  */
-type ModifierInputs<T extends Record<string, string> = Record<string, string>> = T;
+type AndroidRendererOptions = {
+    preset?: 'standalone' | 'bundle';
+    packageName?: string;
+    objectName?: string;
+    /**
+     * Color output format for Kotlin Color initializers.
+     * - `'argb_hex'` (default) — `Color(0xAARRGGBB)` hex literal
+     * - `'argb_float'` — `Color(r, g, b, a)` float components
+     *
+     * Legacy aliases: `'argb8'` maps to `'argb_hex'`, `'argb_floats'` maps to `'argb_float'`.
+     */
+    colorFormat?: 'argb_hex' | 'argb_float' | 'argb8' | 'argb_floats';
+    /**
+     * Color space for generated Color values.
+     * - `'sRGB'` (default) — standard sRGB color space
+     * - `'displayP3'` — Display P3 wide gamut via `ColorSpaces.DisplayP3`
+     */
+    colorSpace?: 'sRGB' | 'displayP3';
+    /**
+     * Structure mode for token organization.
+     * - `'nested'` (default) — mirror token path hierarchy as nested objects
+     * - `'flat'` — group tokens by $type into semantic sub-objects (Colors, Spacing, etc.)
+     */
+    structure?: 'nested' | 'flat';
+    /**
+     * Kotlin visibility modifier for the generated object and its members.
+     * - `undefined` (default) — no explicit modifier, which means `public` in Kotlin
+     * - `'public'` — explicit `public object` / `public val`
+     * - `'internal'` — `internal object` / `internal val` (useful for KMP / multi-module)
+     */
+    visibility?: 'public' | 'internal';
+    /** Number of spaces per indentation level (default 4) */
+    indent?: number;
+};
 
 /**
  * @fileoverview Renderer system types for token output generation
@@ -299,6 +355,73 @@ 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
  */
@@ -578,4 +701,4 @@ type DispersaOptions = Omit<DispersaOptionsBase, 'validation'> & {
     validation?: ValidationOptions;
 };
 
-export { type BuildConfig as B, type CssRendererOptions as C, type DispersaOptions as D, type ErrorCode as E, type FormatOptions as F, 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 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 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 };

package/dist/{index-DKf9WMQG.d.cts → index-CePv_bgv.d.cts}

@@ -4,71 +4,127 @@ import { T as Transform } from './types-DM5faYUn.cjs';
 import { R as ResolvedTokens } from './types-C1GpiJ6q.cjs';
 
 /**
- * @fileoverview DTCG Resolver types (2025.10 specification)
+ * @license MIT
+ * Copyright (c) 2025-present Dispersa Contributors
  *
- * The resolver system allows defining token sources, modifiers (themes, modes),
- * and the order in which they should be resolved and merged.
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+/**
+ * Options for Tailwind CSS v4 renderer
  *
- * ResolverDocument type is defined here to match DTCG 2025.10.
+ * Controls how tokens are converted to Tailwind v4 @theme CSS variables.
+ *
+ * @example Bundle with dark mode overrides
+ * ```typescript
+ * tailwind({
+ *   name: 'tailwind',
+ *   file: 'theme.css',
+ *   preset: 'bundle',
+ *   selector: (modifier, context, isBase) => {
+ *     if (isBase) return ':root'
+ *     return `[data-${modifier}="${context}"]`
+ *   },
+ * })
+ * ```
  */
-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>;
+type TailwindRendererOptions = {
+    preset?: 'bundle' | 'standalone';
+    includeImport?: boolean;
+    namespace?: string;
+    minify?: boolean;
+    selector?: string | SelectorFunction;
+    mediaQuery?: string | MediaQueryFunction;
 };
+
 /**
- * Map of modifier names to selected context values
+ * @license MIT
+ * Copyright (c) 2025-present Dispersa Contributors
  *
- * Used to specify which variation of each modifier to use when resolving tokens.
- * Can be made type-safe by providing a generic type parameter.
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+/**
+ * Options for iOS/SwiftUI renderer
+ */
+type IosRendererOptions = {
+    preset?: 'standalone';
+    accessLevel?: 'public' | 'internal';
+    /**
+     * Output structure:
+     * - `'enum'` — nested enums inside a single root enum
+     * - `'grouped'` — namespace enum with separate extensions per token group
+     */
+    structure?: 'enum' | 'grouped';
+    enumName?: string;
+    /** Namespace enum name used in grouped mode (default: 'DesignTokens') */
+    extensionNamespace?: string;
+    colorSpace?: 'sRGB' | 'displayP3';
+    /**
+     * Target Swift language version.
+     * - `'5.9'` (default) — standard static let declarations
+     * - `'6.0'` — adds `nonisolated(unsafe)` to static properties for
+     *   Swift 6 strict concurrency compliance
+     */
+    swiftVersion?: '5.9' | '6.0';
+    /** Number of spaces per indentation level (default 4) */
+    indent?: number;
+    /** Add @frozen annotation to enums and structs for ABI stability (default false) */
+    frozen?: boolean;
+};
+
+/**
+ * @license MIT
+ * Copyright (c) 2025-present Dispersa Contributors
  *
- * @template T - Optional specific type for modifier values (defaults to generic Record)
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+/**
+ * Options for Android/Jetpack Compose renderer
  *
- * @example
- * ```typescript
- * // Generic (default):
- * const inputs: ModifierInputs = {
- *   theme: 'dark',
- *   platform: 'mobile'
- * }
+ * Note: `packageName` is marked optional for type compatibility with the Renderer
+ * generic, but is validated as required at runtime in the renderer's format() method.
  *
- * // Type-safe:
- * type MyModifiers = { theme: 'light' | 'dark', platform: 'web' | 'mobile' }
- * const inputs: ModifierInputs<MyModifiers> = {
- *   theme: 'dark',  // ✅ Autocomplete!
- *   platform: 'mobile'
- * }
- * ```
+ * @experimental This type is experimental. Properties and behavior may change.
  */
-type ModifierInputs<T extends Record<string, string> = Record<string, string>> = T;
+type AndroidRendererOptions = {
+    preset?: 'standalone' | 'bundle';
+    packageName?: string;
+    objectName?: string;
+    /**
+     * Color output format for Kotlin Color initializers.
+     * - `'argb_hex'` (default) — `Color(0xAARRGGBB)` hex literal
+     * - `'argb_float'` — `Color(r, g, b, a)` float components
+     *
+     * Legacy aliases: `'argb8'` maps to `'argb_hex'`, `'argb_floats'` maps to `'argb_float'`.
+     */
+    colorFormat?: 'argb_hex' | 'argb_float' | 'argb8' | 'argb_floats';
+    /**
+     * Color space for generated Color values.
+     * - `'sRGB'` (default) — standard sRGB color space
+     * - `'displayP3'` — Display P3 wide gamut via `ColorSpaces.DisplayP3`
+     */
+    colorSpace?: 'sRGB' | 'displayP3';
+    /**
+     * Structure mode for token organization.
+     * - `'nested'` (default) — mirror token path hierarchy as nested objects
+     * - `'flat'` — group tokens by $type into semantic sub-objects (Colors, Spacing, etc.)
+     */
+    structure?: 'nested' | 'flat';
+    /**
+     * Kotlin visibility modifier for the generated object and its members.
+     * - `undefined` (default) — no explicit modifier, which means `public` in Kotlin
+     * - `'public'` — explicit `public object` / `public val`
+     * - `'internal'` — `internal object` / `internal val` (useful for KMP / multi-module)
+     */
+    visibility?: 'public' | 'internal';
+    /** Number of spaces per indentation level (default 4) */
+    indent?: number;
+};
 
 /**
  * @fileoverview Renderer system types for token output generation
@@ -299,6 +355,73 @@ 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
  */
@@ -578,4 +701,4 @@ type DispersaOptions = Omit<DispersaOptionsBase, 'validation'> & {
     validation?: ValidationOptions;
 };
 
-export { type BuildConfig as B, type CssRendererOptions as C, type DispersaOptions as D, type ErrorCode as E, type FormatOptions as F, 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 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 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 };