dispersa 0.4.3 → 1.0.0

package/dist/index.d.cts

@@ -1,332 +1,11 @@
-import { D as DispersaOptions, B as BuildConfig, a as BuildResult, M as ModifierInputs, R as ResolverDocument } from './index-CNT2Meyf.cjs';
-export { A as AndroidRendererOptions, c as BuildError, d as BuildOutput, C as CssRendererOptions, E as ErrorCode, F as FileFunction, e as FormatOptions, I as IosRendererOptions, L as LifecycleHooks, f as MediaQueryFunction, O as OutputConfig, g as OutputTree, P as PermutationData, i as RenderContext, j as RenderMeta, k as RenderOutput, h as Renderer, S as SelectorFunction, T as TailwindRendererOptions, V as ValidationMode, b as ValidationOptions, l as defineRenderer } from './index-CNT2Meyf.cjs';
-import { R as ResolvedTokens } from './types-Bc0kA7De.cjs';
-export { B as BorderToken, r as BorderValue, k as ColorComponent, j as ColorSpace, C as ColorToken, i as ColorValue, h as ColorValueObject, o as CubicBezierValue, D as DesignTokenValue, d as DimensionToken, l as DimensionValue, e as DurationToken, m as DurationValue, F as FontFamilyValue, n as FontWeightValue, w as GradientStop, G as GradientToken, v as GradientValue, a as ResolvedToken, S as ShadowToken, p as ShadowValueObject, s as StrokeStyleValue, t as StrokeStyleValueObject, T as TokenType, b as TokenValue, c as TokenValueReference, g as TransitionToken, u as TransitionValue, f as TypographyToken, q as TypographyValue, E as isBorderToken, x as isColorToken, y as isDimensionToken, H as isDurationToken, J as isGradientToken, z as isShadowToken, I as isTransitionToken, A as isTypographyToken } from './types-Bc0kA7De.cjs';
-export { T as Transform } from './types-BAv39mum.cjs';
-export { F as Filter } from './types-DWKq-eJj.cjs';
-export { J as JsModuleRendererOptions, a as JsonRendererOptions, P as Preprocessor } from './types-CussyWwe.cjs';
+export { L as LintOptions, b as build, a as buildOrThrow, c as buildPermutation, g as generateTypes, l as lint, d as resolveAllPermutations, r as resolveTokens } from './dispersa-DL3J_Pmz.cjs';
+export { B as BuildConfig, b as BuildError, c as BuildOutput, d as BuildResult, C as CssRendererOptions, D as DispersaOptions, E as ErrorCode, F as FileFunction, e as FormatOptions, L as LifecycleHooks, M as MediaQueryFunction, j as ModifierInputs, O as OutputConfig, f as OutputTree, P as PermutationData, g as RenderContext, h as RenderMeta, i as RenderOutput, R as Renderer, k as ResolverDocument, S as SelectorFunction, V as ValidationMode, a as ValidationOptions, l as defineRenderer } from './index-De6SjZYH.cjs';
+export { B as BorderToken, r as BorderValue, k as ColorComponent, j as ColorSpace, C as ColorToken, i as ColorValue, h as ColorValueObject, o as CubicBezierValue, D as DesignTokenValue, d as DimensionToken, l as DimensionValue, e as DurationToken, m as DurationValue, F as FontFamilyValue, n as FontWeightValue, w as GradientStop, G as GradientToken, v as GradientValue, R as ResolvedToken, a as ResolvedTokens, S as ShadowToken, p as ShadowValueObject, s as StrokeStyleValue, t as StrokeStyleValueObject, c as TokenType, T as TokenValue, b as TokenValueReference, g as TransitionToken, u as TransitionValue, f as TypographyToken, q as TypographyValue, E as isBorderToken, x as isColorToken, y as isDimensionToken, H as isDurationToken, J as isGradientToken, z as isShadowToken, I as isTransitionToken, A as isTypographyToken } from './types-TQHV1MrY.cjs';
+export { T as Transform } from './types-BltzwVYK.cjs';
+export { F as Filter } from './types-CAdUV-fa.cjs';
+export { J as JsModuleRendererOptions, a as JsonRendererOptions, P as Preprocessor } from './types-BHBHRm0a.cjs';
 export { AndroidBuilderConfig, CssBuilderConfig, IosBuilderConfig, JsBuilderConfig, JsonBuilderConfig, TailwindBuilderConfig, android, css, ios, js, json, tailwind } from './builders.cjs';
 export { isOutputTree, outputTree } from './renderers.cjs';
-export { BasePermutationError, CircularReferenceError, ConfigurationError, DispersaError, FileOperationError, ModifierError, TokenReferenceError, ValidationError } from './errors.cjs';
+export { B as BasePermutationError, C as CircularReferenceError, a as ConfigurationError, D as DispersaError, F as FileOperationError, L as LintError, M as ModifierError, T as TokenReferenceError, V as ValidationError } from './errors-qT4sJgSA.cjs';
+export { A as AndroidRendererOptions, I as IosRendererOptions, T as TailwindRendererOptions } from './android-CRDfSB3_.cjs';
 import 'json-schema-to-ts';
-
-/**
- * @license
- * Copyright (c) 2025 Dispersa Contributors
- * SPDX-License-Identifier: MIT
- */
-
-/**
- * DTCG design token processor with multi-format output support
- *
- * Dispersa processes DTCG-compliant design tokens through a configurable pipeline,
- * resolves references and aliases, applies transforms and filters, and generates output
- * in multiple formats (CSS, JSON, JavaScript).
- *
- * **Runtime Validation:**
- * Dispersa validates all configuration inputs at runtime, including constructor options,
- * build configs, output configs, and custom component registrations. This catches
- * configuration errors early with helpful error messages.
- *
- * Features:
- * - **Transforms**: Modify token values and names (e.g., convert colors, change case)
- * - **Filters**: Select which tokens to include in output
- * - **Preprocessors**: Transform raw token data before parsing
- * - **Renderers**: Generate output in various formats
- * - **Runtime validation**: JSON schema validation for all user inputs
- *
- * @example Basic usage with constructor defaults
- * ```typescript
- * const dispersa = new Dispersa({
- *   resolver: './tokens.resolver.json',
- *   buildPath: './output'
- * })
- *
- * const result = await dispersa.build({
- *   outputs: [
- *     css({
- *       name: 'css',
- *       file: 'tokens.css',
- *       preset: 'bundle',
- *       selector: ':root',
- *       transforms: [nameKebabCase()]
- *     })
- *   ]
- * })
- * ```
- *
- * @example Mixed presets per output
- * ```typescript
- * import { css, json } from 'dispersa'
- *
- * const dispersa = new Dispersa({
- *   resolver: './tokens.resolver.json',
- *   buildPath: './output'
- * })
- *
- * await dispersa.build({
- *   outputs: [
- *     css({
- *       name: 'css',
- *       file: 'tokens.css',
- *       preset: 'bundle',
- *       selector: ':root',  // All themes in one CSS file
- *       transforms: [nameKebabCase()]
- *     }),
- *     json({
- *       name: 'json',
- *       file: 'tokens-{theme}.json',  // Separate file per theme
- *       preset: 'standalone',
- *       structure: 'flat'
- *     })
- *   ]
- * })
- * ```
- *
- * @example Using filters and preprocessors
- * ```typescript
- * import { css } from 'dispersa'
- * import { byType } from 'dispersa/filters'
- * import { nameKebabCase } from 'dispersa/transforms'
- *
- * const dispersa = new Dispersa({
- *   resolver: './tokens.resolver.json',
- *   buildPath: './output'
- * })
- *
- * await dispersa.build({
- *   outputs: [
- *     css({
- *       name: 'colors-only',
- *       file: 'colors.css',
- *       preset: 'standalone',
- *       selector: ':root',
- *       filters: [byType('color')],
- *       transforms: [nameKebabCase()]
- *     })
- *   ],
- *   permutations: [
- *     { theme: 'light' },
- *     { theme: 'dark' }
- *   ]
- * })
- * ```
- */
-declare class Dispersa {
-    private validator;
-    private pipeline;
-    private outputProcessor;
-    private orchestrator;
-    private options;
-    /**
-     * Creates a new Dispersa instance
-     *
-     * @param options - Configuration options (optional, can be empty object)
-     * @param options.resolver - Default resolver (file path or inline object, optional if provided at build time)
-     * @param options.buildPath - Default output directory for generated files (omit for in-memory mode)
-     * @throws {ConfigurationError} If options are invalid and validation is enabled
-     */
-    constructor(options?: DispersaOptions);
-    /**
-     * Builds design tokens from a resolver configuration
-     *
-     * Processes tokens through the resolution pipeline, applies preprocessors,
-     * transforms, and filters, then generates output files in multiple formats
-     * for specified outputs.
-     *
-     * **Runtime Validation:**
-     * This method validates the build configuration
-     * and all output configurations before processing, throwing helpful errors for
-     * invalid inputs.
-     *
-     * **Permutation Handling:**
-     * - If `config.permutations` is provided and non-empty, builds those specific permutations
-     * - If `config.permutations` is undefined or empty, auto-discovers all permutations from resolver
-     *
-     * @param config - Build configuration
-     * @param config.resolver - Resolver configuration (file path or inline object, optional if set in constructor)
-     * @param config.outputs - Array of output configurations (renderers, transforms, filters)
-     * @param config.buildPath - Output directory for generated files (omit for in-memory mode, optional if set in constructor)
-     * @param config.transforms - Global transforms to apply to all tokens
-     * @param config.preprocessors - Global preprocessors to apply before parsing
-     * @param config.permutations - Array of modifier inputs for generating variations
-     * @returns Build result with success status and generated output files
-     * @throws {ConfigurationError} If configuration is invalid
-     * @throws {FileOperationError} If file operations fail
-     *
-     * @example Basic build
-     * ```typescript
-     * const dispersa = new Dispersa({
-     *   resolver: './tokens.resolver.json',
-     *   buildPath: './output'
-     * })
-     *
-     * const result = await dispersa.build({
-     *   outputs: [
-     *     css({
-     *       name: 'css',
-     *       file: 'tokens.css',
-     *       preset: 'bundle',
-     *       selector: ':root',
-     *       transforms: [nameKebabCase()]
-     *     })
-     *   ]
-     * })
-     * ```
-     *
-     * @example With filters and multiple presets
-     * ```typescript
-     * const result = await dispersa.build({
-     *   resolver: './tokens.resolver.json',
-     *   outputs: [
-     *     css({
-     *       name: 'css',
-     *       file: 'tokens.css',
-     *       preset: 'bundle',
-     *       selector: ':root',  // All themes in one file
-     *       transforms: [nameKebabCase()]
-     *     }),
-     *     json({
-     *       name: 'json',
-     *       file: 'tokens-{theme}.json',  // Separate file per theme
-     *       preset: 'standalone',
-     *       structure: 'flat'
-     *     })
-     *   ],
-     *   buildPath: './output',
-     *   permutations: [
-     *     { theme: 'light' },
-     *     { theme: 'dark' }
-     *   ]
-     * })
-     * ```
-     */
-    build(config: BuildConfig): Promise<BuildResult>;
-    /**
-     * Builds design tokens and throws on any failure.
-     *
-     * Unlike {@link build}, which catches errors and returns them inside
-     * `BuildResult.errors`, this method propagates the first error as an
-     * exception. Use it when you want fail-fast behavior in CLI or CI workflows.
-     *
-     * @param config - Build configuration specifying resolver, outputs, transforms, etc.
-     * @returns A successful `BuildResult` (never contains errors)
-     * @throws {ConfigurationError} When the build config or resolver is invalid
-     * @throws {DispersaError} When token resolution, transforms, or rendering fails
-     *
-     * @example
-     * ```typescript
-     * try {
-     *   const result = await dispersa.buildOrThrow({
-     *     resolver: './tokens.resolver.json',
-     *     outputs: [css({ name: 'css', file: 'tokens.css' })],
-     *     buildPath: './output',
-     *   })
-     * } catch (error) {
-     *   process.exit(1)
-     * }
-     * ```
-     */
-    buildOrThrow(config: BuildConfig): Promise<BuildResult>;
-    /**
-     * Builds tokens for a single permutation with all configured outputs
-     *
-     * Convenience wrapper around `build()` that forces a single permutation.
-     * This means it has the same runtime validation and error semantics as `build()`:
-     * it returns a `BuildResult` object rather than throwing (use `buildOrThrow()` if you
-     * want fail-fast behavior).
-     *
-     * @param config - Build configuration
-     * @param modifierInputs - Modifier values (e.g., `{ theme: 'dark' }`)
-     * @returns Build result (success, outputs, optional errors)
-     */
-    buildPermutation(config: BuildConfig, modifierInputs?: ModifierInputs): Promise<BuildResult>;
-    /**
-     * Resolve configuration with constructor defaults
-     */
-    private resolveConfig;
-    /**
-     * Resolves tokens for a specific permutation without generating output files
-     *
-     * Useful for programmatic access to resolved token values, testing,
-     * or implementing custom output logic. Returns fully resolved tokens
-     * with all references and aliases resolved.
-     *
-     * @param resolver - Resolver configuration (file path or inline object)
-     * @param modifierInputs - Modifier values for this permutation (e.g., `{ theme: 'dark' }`)
-     * @returns Object mapping token names to resolved token objects
-     * @throws {FileOperationError} If resolver file cannot be read
-     * @throws {TokenReferenceError} If token references cannot be resolved (when validate is enabled)
-     *
-     * @example
-     * ```typescript
-     * const tokens = await dispersa.resolveTokens(
-     *   './tokens.resolver.json',
-     *   { theme: 'dark' }
-     * )
-     *
-     * console.log(tokens['color.background'].$value) // '#1a1a1a'
-     * ```
-     */
-    resolveTokens(resolver: string | ResolverDocument, modifierInputs?: ModifierInputs): Promise<ResolvedTokens>;
-    /**
-     * Resolves tokens for all permutations defined in the resolver
-     *
-     * Auto-discovers all possible permutations from the resolver's modifier
-     * definitions and resolves tokens for each one. Useful for generating
-     * comprehensive token sets or validating all theme variations.
-     *
-     * @param resolver - Resolver configuration (file path or inline object)
-     * @returns Array of resolved token sets with their modifier inputs
-     * @throws {FileOperationError} If resolver file cannot be read
-     * @throws {TokenReferenceError} If token references cannot be resolved (when validate is enabled)
-     *
-     * @example
-     * ```typescript
-     * const permutations = await dispersa.resolveAllPermutations(
-     *   './tokens.resolver.json'
-     * )
-     *
-     * permutations.forEach(({ tokens, modifierInputs }) => {
-     *   console.log(`Theme: ${modifierInputs.theme}`)
-     *   console.log(`Tokens: ${Object.keys(tokens).length}`)
-     * })
-     * ```
-     */
-    resolveAllPermutations(resolver: string | ResolverDocument): Promise<{
-        tokens: ResolvedTokens;
-        modifierInputs: ModifierInputs;
-    }[]>;
-    /**
-     * Generates TypeScript type definitions from resolved tokens
-     *
-     * Creates a `.d.ts` file with type-safe token definitions including:
-     * - Token name union type for autocomplete
-     * - Token value types
-     * - Nested structure types matching token organization
-     *
-     * @param tokens - Resolved tokens object
-     * @param fileName - Path for the generated `.d.ts` file
-     * @param options - Generation options
-     * @param options.moduleName - Name for the exported types (default: 'Tokens')
-     * @returns Promise that resolves when file is written
-     * @throws {FileOperationError} If file cannot be written
-     *
-     * @example
-     * ```typescript
-     * const tokens = await dispersa.resolveTokens('./tokens.resolver.json')
-     * await dispersa.generateTypes(tokens, './src/tokens.d.ts', {
-     *   moduleName: 'DesignTokens'
-     * })
-     *
-     * // Generated types can be used like:
-     * // const tokenName: TokenName = 'color.background'
-     * // const tokens: DesignTokens = { ... }
-     * ```
-     */
-    generateTypes(tokens: ResolvedTokens, fileName: string, options?: {
-        moduleName?: string;
-    }): Promise<void>;
-}
-
-export { BuildConfig, BuildResult, Dispersa, DispersaOptions, ModifierInputs, ResolvedTokens, ResolverDocument };

package/dist/index.d.ts

@@ -1,332 +1,11 @@
-import { D as DispersaOptions, B as BuildConfig, a as BuildResult, M as ModifierInputs, R as ResolverDocument } from './index-CqdaN3X0.js';
-export { A as AndroidRendererOptions, c as BuildError, d as BuildOutput, C as CssRendererOptions, E as ErrorCode, F as FileFunction, e as FormatOptions, I as IosRendererOptions, L as LifecycleHooks, f as MediaQueryFunction, O as OutputConfig, g as OutputTree, P as PermutationData, i as RenderContext, j as RenderMeta, k as RenderOutput, h as Renderer, S as SelectorFunction, T as TailwindRendererOptions, V as ValidationMode, b as ValidationOptions, l as defineRenderer } from './index-CqdaN3X0.js';
-import { R as ResolvedTokens } from './types-Bc0kA7De.js';
-export { B as BorderToken, r as BorderValue, k as ColorComponent, j as ColorSpace, C as ColorToken, i as ColorValue, h as ColorValueObject, o as CubicBezierValue, D as DesignTokenValue, d as DimensionToken, l as DimensionValue, e as DurationToken, m as DurationValue, F as FontFamilyValue, n as FontWeightValue, w as GradientStop, G as GradientToken, v as GradientValue, a as ResolvedToken, S as ShadowToken, p as ShadowValueObject, s as StrokeStyleValue, t as StrokeStyleValueObject, T as TokenType, b as TokenValue, c as TokenValueReference, g as TransitionToken, u as TransitionValue, f as TypographyToken, q as TypographyValue, E as isBorderToken, x as isColorToken, y as isDimensionToken, H as isDurationToken, J as isGradientToken, z as isShadowToken, I as isTransitionToken, A as isTypographyToken } from './types-Bc0kA7De.js';
-export { T as Transform } from './types-CzHa7YkW.js';
-export { F as Filter } from './types-BzNcG-rI.js';
-export { J as JsModuleRendererOptions, a as JsonRendererOptions, P as Preprocessor } from './types-CZb19kiq.js';
+export { L as LintOptions, b as build, a as buildOrThrow, c as buildPermutation, g as generateTypes, l as lint, d as resolveAllPermutations, r as resolveTokens } from './dispersa-BC1kDF5u.js';
+export { B as BuildConfig, b as BuildError, c as BuildOutput, d as BuildResult, C as CssRendererOptions, D as DispersaOptions, E as ErrorCode, F as FileFunction, e as FormatOptions, L as LifecycleHooks, M as MediaQueryFunction, j as ModifierInputs, O as OutputConfig, f as OutputTree, P as PermutationData, g as RenderContext, h as RenderMeta, i as RenderOutput, R as Renderer, k as ResolverDocument, S as SelectorFunction, V as ValidationMode, a as ValidationOptions, l as defineRenderer } from './index-Dajm5rvM.js';
+export { B as BorderToken, r as BorderValue, k as ColorComponent, j as ColorSpace, C as ColorToken, i as ColorValue, h as ColorValueObject, o as CubicBezierValue, D as DesignTokenValue, d as DimensionToken, l as DimensionValue, e as DurationToken, m as DurationValue, F as FontFamilyValue, n as FontWeightValue, w as GradientStop, G as GradientToken, v as GradientValue, R as ResolvedToken, a as ResolvedTokens, S as ShadowToken, p as ShadowValueObject, s as StrokeStyleValue, t as StrokeStyleValueObject, c as TokenType, T as TokenValue, b as TokenValueReference, g as TransitionToken, u as TransitionValue, f as TypographyToken, q as TypographyValue, E as isBorderToken, x as isColorToken, y as isDimensionToken, H as isDurationToken, J as isGradientToken, z as isShadowToken, I as isTransitionToken, A as isTypographyToken } from './types-TQHV1MrY.js';
+export { T as Transform } from './types-DztXKlka.js';
+export { F as Filter } from './types-ebxDimRz.js';
+export { J as JsModuleRendererOptions, a as JsonRendererOptions, P as Preprocessor } from './types-8MLtztK3.js';
 export { AndroidBuilderConfig, CssBuilderConfig, IosBuilderConfig, JsBuilderConfig, JsonBuilderConfig, TailwindBuilderConfig, android, css, ios, js, json, tailwind } from './builders.js';
 export { isOutputTree, outputTree } from './renderers.js';
-export { BasePermutationError, CircularReferenceError, ConfigurationError, DispersaError, FileOperationError, ModifierError, TokenReferenceError, ValidationError } from './errors.js';
+export { B as BasePermutationError, C as CircularReferenceError, a as ConfigurationError, D as DispersaError, F as FileOperationError, L as LintError, M as ModifierError, T as TokenReferenceError, V as ValidationError } from './errors-qT4sJgSA.js';
+export { A as AndroidRendererOptions, I as IosRendererOptions, T as TailwindRendererOptions } from './android-DANJjjPO.js';
 import 'json-schema-to-ts';
-
-/**
- * @license
- * Copyright (c) 2025 Dispersa Contributors
- * SPDX-License-Identifier: MIT
- */
-
-/**
- * DTCG design token processor with multi-format output support
- *
- * Dispersa processes DTCG-compliant design tokens through a configurable pipeline,
- * resolves references and aliases, applies transforms and filters, and generates output
- * in multiple formats (CSS, JSON, JavaScript).
- *
- * **Runtime Validation:**
- * Dispersa validates all configuration inputs at runtime, including constructor options,
- * build configs, output configs, and custom component registrations. This catches
- * configuration errors early with helpful error messages.
- *
- * Features:
- * - **Transforms**: Modify token values and names (e.g., convert colors, change case)
- * - **Filters**: Select which tokens to include in output
- * - **Preprocessors**: Transform raw token data before parsing
- * - **Renderers**: Generate output in various formats
- * - **Runtime validation**: JSON schema validation for all user inputs
- *
- * @example Basic usage with constructor defaults
- * ```typescript
- * const dispersa = new Dispersa({
- *   resolver: './tokens.resolver.json',
- *   buildPath: './output'
- * })
- *
- * const result = await dispersa.build({
- *   outputs: [
- *     css({
- *       name: 'css',
- *       file: 'tokens.css',
- *       preset: 'bundle',
- *       selector: ':root',
- *       transforms: [nameKebabCase()]
- *     })
- *   ]
- * })
- * ```
- *
- * @example Mixed presets per output
- * ```typescript
- * import { css, json } from 'dispersa'
- *
- * const dispersa = new Dispersa({
- *   resolver: './tokens.resolver.json',
- *   buildPath: './output'
- * })
- *
- * await dispersa.build({
- *   outputs: [
- *     css({
- *       name: 'css',
- *       file: 'tokens.css',
- *       preset: 'bundle',
- *       selector: ':root',  // All themes in one CSS file
- *       transforms: [nameKebabCase()]
- *     }),
- *     json({
- *       name: 'json',
- *       file: 'tokens-{theme}.json',  // Separate file per theme
- *       preset: 'standalone',
- *       structure: 'flat'
- *     })
- *   ]
- * })
- * ```
- *
- * @example Using filters and preprocessors
- * ```typescript
- * import { css } from 'dispersa'
- * import { byType } from 'dispersa/filters'
- * import { nameKebabCase } from 'dispersa/transforms'
- *
- * const dispersa = new Dispersa({
- *   resolver: './tokens.resolver.json',
- *   buildPath: './output'
- * })
- *
- * await dispersa.build({
- *   outputs: [
- *     css({
- *       name: 'colors-only',
- *       file: 'colors.css',
- *       preset: 'standalone',
- *       selector: ':root',
- *       filters: [byType('color')],
- *       transforms: [nameKebabCase()]
- *     })
- *   ],
- *   permutations: [
- *     { theme: 'light' },
- *     { theme: 'dark' }
- *   ]
- * })
- * ```
- */
-declare class Dispersa {
-    private validator;
-    private pipeline;
-    private outputProcessor;
-    private orchestrator;
-    private options;
-    /**
-     * Creates a new Dispersa instance
-     *
-     * @param options - Configuration options (optional, can be empty object)
-     * @param options.resolver - Default resolver (file path or inline object, optional if provided at build time)
-     * @param options.buildPath - Default output directory for generated files (omit for in-memory mode)
-     * @throws {ConfigurationError} If options are invalid and validation is enabled
-     */
-    constructor(options?: DispersaOptions);
-    /**
-     * Builds design tokens from a resolver configuration
-     *
-     * Processes tokens through the resolution pipeline, applies preprocessors,
-     * transforms, and filters, then generates output files in multiple formats
-     * for specified outputs.
-     *
-     * **Runtime Validation:**
-     * This method validates the build configuration
-     * and all output configurations before processing, throwing helpful errors for
-     * invalid inputs.
-     *
-     * **Permutation Handling:**
-     * - If `config.permutations` is provided and non-empty, builds those specific permutations
-     * - If `config.permutations` is undefined or empty, auto-discovers all permutations from resolver
-     *
-     * @param config - Build configuration
-     * @param config.resolver - Resolver configuration (file path or inline object, optional if set in constructor)
-     * @param config.outputs - Array of output configurations (renderers, transforms, filters)
-     * @param config.buildPath - Output directory for generated files (omit for in-memory mode, optional if set in constructor)
-     * @param config.transforms - Global transforms to apply to all tokens
-     * @param config.preprocessors - Global preprocessors to apply before parsing
-     * @param config.permutations - Array of modifier inputs for generating variations
-     * @returns Build result with success status and generated output files
-     * @throws {ConfigurationError} If configuration is invalid
-     * @throws {FileOperationError} If file operations fail
-     *
-     * @example Basic build
-     * ```typescript
-     * const dispersa = new Dispersa({
-     *   resolver: './tokens.resolver.json',
-     *   buildPath: './output'
-     * })
-     *
-     * const result = await dispersa.build({
-     *   outputs: [
-     *     css({
-     *       name: 'css',
-     *       file: 'tokens.css',
-     *       preset: 'bundle',
-     *       selector: ':root',
-     *       transforms: [nameKebabCase()]
-     *     })
-     *   ]
-     * })
-     * ```
-     *
-     * @example With filters and multiple presets
-     * ```typescript
-     * const result = await dispersa.build({
-     *   resolver: './tokens.resolver.json',
-     *   outputs: [
-     *     css({
-     *       name: 'css',
-     *       file: 'tokens.css',
-     *       preset: 'bundle',
-     *       selector: ':root',  // All themes in one file
-     *       transforms: [nameKebabCase()]
-     *     }),
-     *     json({
-     *       name: 'json',
-     *       file: 'tokens-{theme}.json',  // Separate file per theme
-     *       preset: 'standalone',
-     *       structure: 'flat'
-     *     })
-     *   ],
-     *   buildPath: './output',
-     *   permutations: [
-     *     { theme: 'light' },
-     *     { theme: 'dark' }
-     *   ]
-     * })
-     * ```
-     */
-    build(config: BuildConfig): Promise<BuildResult>;
-    /**
-     * Builds design tokens and throws on any failure.
-     *
-     * Unlike {@link build}, which catches errors and returns them inside
-     * `BuildResult.errors`, this method propagates the first error as an
-     * exception. Use it when you want fail-fast behavior in CLI or CI workflows.
-     *
-     * @param config - Build configuration specifying resolver, outputs, transforms, etc.
-     * @returns A successful `BuildResult` (never contains errors)
-     * @throws {ConfigurationError} When the build config or resolver is invalid
-     * @throws {DispersaError} When token resolution, transforms, or rendering fails
-     *
-     * @example
-     * ```typescript
-     * try {
-     *   const result = await dispersa.buildOrThrow({
-     *     resolver: './tokens.resolver.json',
-     *     outputs: [css({ name: 'css', file: 'tokens.css' })],
-     *     buildPath: './output',
-     *   })
-     * } catch (error) {
-     *   process.exit(1)
-     * }
-     * ```
-     */
-    buildOrThrow(config: BuildConfig): Promise<BuildResult>;
-    /**
-     * Builds tokens for a single permutation with all configured outputs
-     *
-     * Convenience wrapper around `build()` that forces a single permutation.
-     * This means it has the same runtime validation and error semantics as `build()`:
-     * it returns a `BuildResult` object rather than throwing (use `buildOrThrow()` if you
-     * want fail-fast behavior).
-     *
-     * @param config - Build configuration
-     * @param modifierInputs - Modifier values (e.g., `{ theme: 'dark' }`)
-     * @returns Build result (success, outputs, optional errors)
-     */
-    buildPermutation(config: BuildConfig, modifierInputs?: ModifierInputs): Promise<BuildResult>;
-    /**
-     * Resolve configuration with constructor defaults
-     */
-    private resolveConfig;
-    /**
-     * Resolves tokens for a specific permutation without generating output files
-     *
-     * Useful for programmatic access to resolved token values, testing,
-     * or implementing custom output logic. Returns fully resolved tokens
-     * with all references and aliases resolved.
-     *
-     * @param resolver - Resolver configuration (file path or inline object)
-     * @param modifierInputs - Modifier values for this permutation (e.g., `{ theme: 'dark' }`)
-     * @returns Object mapping token names to resolved token objects
-     * @throws {FileOperationError} If resolver file cannot be read
-     * @throws {TokenReferenceError} If token references cannot be resolved (when validate is enabled)
-     *
-     * @example
-     * ```typescript
-     * const tokens = await dispersa.resolveTokens(
-     *   './tokens.resolver.json',
-     *   { theme: 'dark' }
-     * )
-     *
-     * console.log(tokens['color.background'].$value) // '#1a1a1a'
-     * ```
-     */
-    resolveTokens(resolver: string | ResolverDocument, modifierInputs?: ModifierInputs): Promise<ResolvedTokens>;
-    /**
-     * Resolves tokens for all permutations defined in the resolver
-     *
-     * Auto-discovers all possible permutations from the resolver's modifier
-     * definitions and resolves tokens for each one. Useful for generating
-     * comprehensive token sets or validating all theme variations.
-     *
-     * @param resolver - Resolver configuration (file path or inline object)
-     * @returns Array of resolved token sets with their modifier inputs
-     * @throws {FileOperationError} If resolver file cannot be read
-     * @throws {TokenReferenceError} If token references cannot be resolved (when validate is enabled)
-     *
-     * @example
-     * ```typescript
-     * const permutations = await dispersa.resolveAllPermutations(
-     *   './tokens.resolver.json'
-     * )
-     *
-     * permutations.forEach(({ tokens, modifierInputs }) => {
-     *   console.log(`Theme: ${modifierInputs.theme}`)
-     *   console.log(`Tokens: ${Object.keys(tokens).length}`)
-     * })
-     * ```
-     */
-    resolveAllPermutations(resolver: string | ResolverDocument): Promise<{
-        tokens: ResolvedTokens;
-        modifierInputs: ModifierInputs;
-    }[]>;
-    /**
-     * Generates TypeScript type definitions from resolved tokens
-     *
-     * Creates a `.d.ts` file with type-safe token definitions including:
-     * - Token name union type for autocomplete
-     * - Token value types
-     * - Nested structure types matching token organization
-     *
-     * @param tokens - Resolved tokens object
-     * @param fileName - Path for the generated `.d.ts` file
-     * @param options - Generation options
-     * @param options.moduleName - Name for the exported types (default: 'Tokens')
-     * @returns Promise that resolves when file is written
-     * @throws {FileOperationError} If file cannot be written
-     *
-     * @example
-     * ```typescript
-     * const tokens = await dispersa.resolveTokens('./tokens.resolver.json')
-     * await dispersa.generateTypes(tokens, './src/tokens.d.ts', {
-     *   moduleName: 'DesignTokens'
-     * })
-     *
-     * // Generated types can be used like:
-     * // const tokenName: TokenName = 'color.background'
-     * // const tokens: DesignTokens = { ... }
-     * ```
-     */
-    generateTypes(tokens: ResolvedTokens, fileName: string, options?: {
-        moduleName?: string;
-    }): Promise<void>;
-}
-
-export { BuildConfig, BuildResult, Dispersa, DispersaOptions, ModifierInputs, ResolvedTokens, ResolverDocument };