dispersa 0.1.2 → 0.2.0

package/dist/builders.d.cts

@@ -1,4 +1,4 @@
-import { M as ModifierInputs, L as LifecycleHooks, C as CssRendererOptions, O as OutputConfig } from './index-DKf9WMQG.cjs';
+import { M as ModifierInputs, L as LifecycleHooks, C as CssRendererOptions, O as OutputConfig, T as TailwindRendererOptions, I as IosRendererOptions, A as AndroidRendererOptions } from './index-CePv_bgv.cjs';
 import { F as Filter } from './types-BDY1xBmD.cjs';
 import { T as Transform } from './types-DM5faYUn.cjs';
 import { a as JsonRendererOptions, J as JsModuleRendererOptions } from './types-DbufGPrb.cjs';
@@ -224,5 +224,154 @@ type JsBuilderConfig = BuilderConfigBase & JsModuleRendererOptions;
  * ```
  */
 declare function js(config: JsBuilderConfig): OutputConfig<JsModuleRendererOptions>;
+/**
+ * Tailwind CSS v4 builder configuration with flattened options
+ */
+type TailwindBuilderConfig = BuilderConfigBase & TailwindRendererOptions;
+/**
+ * Create Tailwind CSS v4 output configuration with flattened options
+ *
+ * Creates an OutputConfig for Tailwind v4 @theme CSS output. All Tailwind-specific
+ * options (includeImport, namespace, etc.) are provided at the top level for
+ * improved discoverability.
+ *
+ * @param config - Tailwind builder configuration with flattened options
+ * @returns Complete OutputConfig ready for use in build()
+ *
+ * @remarks
+ * The preset defaults to 'bundle' for Tailwind, meaning the base permutation tokens
+ * are used to define the @theme vocabulary. Use preset: 'standalone' for separate files.
+ *
+ * @example Bundle Tailwind theme with transforms
+ * ```typescript
+ * import { tailwind } from 'dispersa'
+ * import { nameKebabCase } from 'dispersa/transforms'
+ *
+ * const config = tailwind({
+ *   name: 'tailwind',
+ *   file: 'theme.css',
+ *   preset: 'bundle',
+ *   includeImport: true,
+ *   transforms: [nameKebabCase()]
+ * })
+ * ```
+ *
+ * @example Standalone files per theme
+ * ```typescript
+ * import { tailwind } from 'dispersa'
+ *
+ * const config = tailwind({
+ *   name: 'tailwind',
+ *   file: 'theme-{theme}.css',
+ *   preset: 'standalone',
+ *   includeImport: false,
+ * })
+ * ```
+ */
+declare function tailwind(config: TailwindBuilderConfig): OutputConfig<TailwindRendererOptions>;
+/**
+ * iOS/SwiftUI builder configuration with flattened options
+ */
+type IosBuilderConfig = BuilderConfigBase & IosRendererOptions;
+/**
+ * Create iOS/SwiftUI output configuration with flattened options
+ *
+ * Creates an OutputConfig for Swift code generation targeting SwiftUI (iOS 17+, Swift 6).
+ * All iOS-specific options (accessLevel, structure, etc.) are provided at the top level.
+ *
+ * @param config - iOS builder configuration with flattened options
+ * @returns Complete OutputConfig ready for use in build()
+ *
+ * @remarks
+ * Only standalone preset is supported. Each permutation generates a separate Swift file.
+ *
+ * @example Enum-based SwiftUI tokens
+ * ```typescript
+ * import { ios } from 'dispersa'
+ *
+ * const config = ios({
+ *   name: 'ios',
+ *   file: 'DesignTokens-{theme}.swift',
+ *   accessLevel: 'public',
+ *   structure: 'enum',
+ *   enumName: 'DesignTokens',
+ *   colorSpace: 'sRGB',
+ * })
+ * ```
+ *
+ * @example Grouped SwiftUI tokens (namespace enum + extensions per group)
+ * ```typescript
+ * import { ios } from 'dispersa'
+ *
+ * const config = ios({
+ *   name: 'ios-tokens',
+ *   file: 'Tokens-{theme}.swift',
+ *   structure: 'grouped',
+ *   colorSpace: 'displayP3',
+ * })
+ * ```
+ */
+declare function ios(config: IosBuilderConfig): OutputConfig<IosRendererOptions>;
+/**
+ * Android/Jetpack Compose builder configuration with flattened options
+ */
+type AndroidBuilderConfig = BuilderConfigBase & AndroidRendererOptions;
+/**
+ * Create Android/Jetpack Compose output configuration with flattened options
+ *
+ * Creates an OutputConfig for Kotlin code generation targeting Jetpack Compose
+ * with Material 3. All Android-specific options (packageName, objectName, etc.)
+ * are provided at the top level.
+ *
+ * @experimental This builder is experimental. Options and generated output may change.
+ * @param config - Android builder configuration with flattened options
+ * @returns Complete OutputConfig ready for use in build()
+ *
+ * @remarks
+ * The `packageName` option is required (Kotlin convention). Supports both
+ * `'standalone'` (default, one file per permutation) and `'bundle'` (all
+ * permutations in a single file) presets.
+ *
+ * @example Standalone Compose tokens with hex colors
+ * ```typescript
+ * import { android } from 'dispersa'
+ *
+ * const config = android({
+ *   name: 'android',
+ *   file: 'DesignTokens-{theme}.kt',
+ *   packageName: 'com.example.tokens',
+ *   objectName: 'DesignTokens',
+ *   colorFormat: 'argb_hex',
+ * })
+ * ```
+ *
+ * @example Flat structure with Display P3 colors
+ * ```typescript
+ * import { android } from 'dispersa'
+ *
+ * const config = android({
+ *   name: 'android-tokens',
+ *   file: 'Tokens-{theme}.kt',
+ *   packageName: 'com.example.design',
+ *   structure: 'flat',
+ *   colorSpace: 'displayP3',
+ *   colorFormat: 'argb_float',
+ * })
+ * ```
+ *
+ * @example Bundle mode — all themes in one file
+ * ```typescript
+ * import { android } from 'dispersa'
+ *
+ * const config = android({
+ *   name: 'android-bundle',
+ *   file: 'DesignTokens.kt',
+ *   packageName: 'com.example.tokens',
+ *   preset: 'bundle',
+ *   structure: 'flat',
+ * })
+ * ```
+ */
+declare function android(config: AndroidBuilderConfig): OutputConfig<AndroidRendererOptions>;
 
-export { type CssBuilderConfig, type JsBuilderConfig, type JsonBuilderConfig, css, js, json };
+export { type AndroidBuilderConfig, type CssBuilderConfig, type IosBuilderConfig, type JsBuilderConfig, type JsonBuilderConfig, type TailwindBuilderConfig, android, css, ios, js, json, tailwind };

package/dist/builders.d.ts

@@ -1,4 +1,4 @@
-import { M as ModifierInputs, L as LifecycleHooks, C as CssRendererOptions, O as OutputConfig } from './index-CPB9Ea9U.js';
+import { M as ModifierInputs, L as LifecycleHooks, C as CssRendererOptions, O as OutputConfig, T as TailwindRendererOptions, I as IosRendererOptions, A as AndroidRendererOptions } from './index-BP52gB00.js';
 import { F as Filter } from './types-Cl-1UYGD.js';
 import { T as Transform } from './types-DdPWYkgh.js';
 import { a as JsonRendererOptions, J as JsModuleRendererOptions } from './types-DJH6_4U9.js';
@@ -224,5 +224,154 @@ type JsBuilderConfig = BuilderConfigBase & JsModuleRendererOptions;
  * ```
  */
 declare function js(config: JsBuilderConfig): OutputConfig<JsModuleRendererOptions>;
+/**
+ * Tailwind CSS v4 builder configuration with flattened options
+ */
+type TailwindBuilderConfig = BuilderConfigBase & TailwindRendererOptions;
+/**
+ * Create Tailwind CSS v4 output configuration with flattened options
+ *
+ * Creates an OutputConfig for Tailwind v4 @theme CSS output. All Tailwind-specific
+ * options (includeImport, namespace, etc.) are provided at the top level for
+ * improved discoverability.
+ *
+ * @param config - Tailwind builder configuration with flattened options
+ * @returns Complete OutputConfig ready for use in build()
+ *
+ * @remarks
+ * The preset defaults to 'bundle' for Tailwind, meaning the base permutation tokens
+ * are used to define the @theme vocabulary. Use preset: 'standalone' for separate files.
+ *
+ * @example Bundle Tailwind theme with transforms
+ * ```typescript
+ * import { tailwind } from 'dispersa'
+ * import { nameKebabCase } from 'dispersa/transforms'
+ *
+ * const config = tailwind({
+ *   name: 'tailwind',
+ *   file: 'theme.css',
+ *   preset: 'bundle',
+ *   includeImport: true,
+ *   transforms: [nameKebabCase()]
+ * })
+ * ```
+ *
+ * @example Standalone files per theme
+ * ```typescript
+ * import { tailwind } from 'dispersa'
+ *
+ * const config = tailwind({
+ *   name: 'tailwind',
+ *   file: 'theme-{theme}.css',
+ *   preset: 'standalone',
+ *   includeImport: false,
+ * })
+ * ```
+ */
+declare function tailwind(config: TailwindBuilderConfig): OutputConfig<TailwindRendererOptions>;
+/**
+ * iOS/SwiftUI builder configuration with flattened options
+ */
+type IosBuilderConfig = BuilderConfigBase & IosRendererOptions;
+/**
+ * Create iOS/SwiftUI output configuration with flattened options
+ *
+ * Creates an OutputConfig for Swift code generation targeting SwiftUI (iOS 17+, Swift 6).
+ * All iOS-specific options (accessLevel, structure, etc.) are provided at the top level.
+ *
+ * @param config - iOS builder configuration with flattened options
+ * @returns Complete OutputConfig ready for use in build()
+ *
+ * @remarks
+ * Only standalone preset is supported. Each permutation generates a separate Swift file.
+ *
+ * @example Enum-based SwiftUI tokens
+ * ```typescript
+ * import { ios } from 'dispersa'
+ *
+ * const config = ios({
+ *   name: 'ios',
+ *   file: 'DesignTokens-{theme}.swift',
+ *   accessLevel: 'public',
+ *   structure: 'enum',
+ *   enumName: 'DesignTokens',
+ *   colorSpace: 'sRGB',
+ * })
+ * ```
+ *
+ * @example Grouped SwiftUI tokens (namespace enum + extensions per group)
+ * ```typescript
+ * import { ios } from 'dispersa'
+ *
+ * const config = ios({
+ *   name: 'ios-tokens',
+ *   file: 'Tokens-{theme}.swift',
+ *   structure: 'grouped',
+ *   colorSpace: 'displayP3',
+ * })
+ * ```
+ */
+declare function ios(config: IosBuilderConfig): OutputConfig<IosRendererOptions>;
+/**
+ * Android/Jetpack Compose builder configuration with flattened options
+ */
+type AndroidBuilderConfig = BuilderConfigBase & AndroidRendererOptions;
+/**
+ * Create Android/Jetpack Compose output configuration with flattened options
+ *
+ * Creates an OutputConfig for Kotlin code generation targeting Jetpack Compose
+ * with Material 3. All Android-specific options (packageName, objectName, etc.)
+ * are provided at the top level.
+ *
+ * @experimental This builder is experimental. Options and generated output may change.
+ * @param config - Android builder configuration with flattened options
+ * @returns Complete OutputConfig ready for use in build()
+ *
+ * @remarks
+ * The `packageName` option is required (Kotlin convention). Supports both
+ * `'standalone'` (default, one file per permutation) and `'bundle'` (all
+ * permutations in a single file) presets.
+ *
+ * @example Standalone Compose tokens with hex colors
+ * ```typescript
+ * import { android } from 'dispersa'
+ *
+ * const config = android({
+ *   name: 'android',
+ *   file: 'DesignTokens-{theme}.kt',
+ *   packageName: 'com.example.tokens',
+ *   objectName: 'DesignTokens',
+ *   colorFormat: 'argb_hex',
+ * })
+ * ```
+ *
+ * @example Flat structure with Display P3 colors
+ * ```typescript
+ * import { android } from 'dispersa'
+ *
+ * const config = android({
+ *   name: 'android-tokens',
+ *   file: 'Tokens-{theme}.kt',
+ *   packageName: 'com.example.design',
+ *   structure: 'flat',
+ *   colorSpace: 'displayP3',
+ *   colorFormat: 'argb_float',
+ * })
+ * ```
+ *
+ * @example Bundle mode — all themes in one file
+ * ```typescript
+ * import { android } from 'dispersa'
+ *
+ * const config = android({
+ *   name: 'android-bundle',
+ *   file: 'DesignTokens.kt',
+ *   packageName: 'com.example.tokens',
+ *   preset: 'bundle',
+ *   structure: 'flat',
+ * })
+ * ```
+ */
+declare function android(config: AndroidBuilderConfig): OutputConfig<AndroidRendererOptions>;
 
-export { type CssBuilderConfig, type JsBuilderConfig, type JsonBuilderConfig, css, js, json };
+export { type AndroidBuilderConfig, type CssBuilderConfig, type IosBuilderConfig, type JsBuilderConfig, type JsonBuilderConfig, type TailwindBuilderConfig, android, css, ios, js, json, tailwind };