@sugarcube-org/core 0.0.1-alpha.6 → 0.0.1-alpha.7

package/dist/index.d.ts

@@ -1,5 +1,95 @@
 import { z } from 'zod';
 
+/**
+ * Directional variants for utility properties
+ */
+type DirectionalVariant = "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all";
+/**
+ * Properties-first utility configuration
+ * This is the approach where users configure utilities by CSS property
+ * Made it separate in case we want other types of configs later
+ */
+type PropertyUtilityConfig = {
+    source: string;
+    directions?: DirectionalVariant | DirectionalVariant[];
+    prefix?: string;
+    stripDuplicates?: boolean;
+    collection?: string;
+};
+
+type ColorFallbackStrategy = "native" | "polyfill";
+type FluidConfig = {
+    min: number;
+    max: number;
+};
+type TokenCollection = {
+    source: string[];
+    themes?: Record<string, string[]>;
+};
+/**
+ * Multiple named collections of tokens.
+ * Each key is a collection name (e.g., "base", "ui", "marketing").
+ */
+type TokenCollections = Record<string, TokenCollection>;
+type UserTransformsConfig = {
+    fluid?: FluidConfig;
+    colorFallbackStrategy?: ColorFallbackStrategy;
+};
+/**
+ * Configuration for transforms applied to tokens during processing (internal config)
+ */
+type TransformsConfig = {
+    fluid: FluidConfig;
+    colorFallbackStrategy: ColorFallbackStrategy;
+};
+/**
+ * Configuration for output directories (user config - optional fields)
+ */
+type UserOutputConfig = {
+    css?: string;
+    components?: string;
+    separate?: boolean;
+};
+/**
+ * Configuration for output directories (internal config - required fields)
+ */
+type OutputConfig = {
+    css: string;
+    components?: string;
+    separate: boolean;
+};
+/**
+ * Utilities configuration
+ * This is the approach where users configure utilities by CSS property
+ * Can be a single configuration or an array of configurations
+ */
+type UtilitiesConfig = Record<string, PropertyUtilityConfig | PropertyUtilityConfig[]>;
+interface UserConfig {
+    tokens?: TokenCollection | TokenCollections;
+    transforms?: UserTransformsConfig;
+    output?: UserOutputConfig;
+    utilities?: UtilitiesConfig;
+}
+/**
+ * Internal configuration type - what code uses (complete, required fields)
+ */
+interface InternalConfig {
+    tokens?: TokenCollection | TokenCollections;
+    transforms: TransformsConfig;
+    output: OutputConfig;
+    utilities?: UtilitiesConfig;
+}
+
+/**
+ * Base error type that all other error types extend from.
+ * Used as the foundation for all error types in the system.
+ * Provides a consistent structure for error messages across the codebase.
+ */
+type BaseError = {
+    /** A human-readable error message describing what went wrong */
+    message: string;
+};
+
 /**
  * A token value that can either be a raw value or a reference.
  * This is the base type for all token values in the W3C Design Token Format.
@@ -97,9 +187,20 @@ type StructuralCompositeType = "strokeStyle";
 type CompositeTokenValue<T extends CompositeTokenType = CompositeTokenType> = T extends "typography" ? Typography : T extends "border" ? Border : T extends "shadow" ? Shadow : T extends "gradient" ? Gradient : T extends "transition" ? Transition : T extends "strokeStyle" ? StrokeStyle : never;
 /**
  * A color value in any valid CSS color format.
- * This can be any string that is valid in CSS color contexts.
- */
-type Color = string;
+ * This can be either:
+ * - A string that is valid in CSS color contexts (legacy format)
+ * - A W3C color object with colorSpace, components, and optional alpha/hex
+ */
+type Color = string | {
+    /** The color space - supports "oklch" and "display-p3" */
+    colorSpace: "oklch" | "display-p3";
+    /** Array of 3 numbers representing the color components */
+    components: [number, number, number];
+    /** Optional alpha value between 0 and 1 (defaults to 1 if omitted) */
+    alpha?: number;
+    /** Optional hex fallback value for compatibility */
+    hex?: string;
+};
 /**
  * A dimensional value with a numeric value and unit.
  * Used for measurements like width, height, spacing, etc.
@@ -255,157 +356,6 @@ type GradientStop = {
  */
 type Gradient = GradientStop[];
 
-/**
- * Directional variants for utility properties
- */
-type DirectionalVariant = "top" | "right" | "bottom" | "left" | "x" | "y" | "full";
-/**
- * Configuration for utility generation
- */
-type UtilityConfig = {
-    properties?: string[];
-    typeMap?: Partial<Record<TokenType, string[]>>;
-    custom?: Record<string, string>;
-    prefix?: string;
-    stripLevels?: number;
-    directions?: DirectionalVariant | DirectionalVariant[];
-};
-/**
- * Definition of a generated utility class
- */
-type UtilityDefinition = {
-    className: string;
-    property: string;
-    value: string;
-    tokenPath: string[];
-};
-
-/**
- * Supported color formats for CSS output
- */
-type ColorFormat = "hex" | "rgb" | "rgba" | "hsl" | "hsla" | "oklch" | "p3";
-/**
- * Configuration for fluid (responsive) values
- */
-type FluidConfig = {
-    /** Minimum viewport width in pixels */
-    min: number;
-    /** Maximum viewport width in pixels */
-    max: number;
-};
-/**
- * A collection of token files with shared namespace.
- * Represents either a starter kit or custom token collection.
- */
-type TokenCollection = {
-    /** Array of source file paths for this collection */
-    source: string[];
-    /** Optional theme-specific source files */
-    themes?: Record<string, string[]>;
-};
-/**
- * Multiple named collections of tokens.
- * Each key is a collection name (e.g., "base", "ui", "marketing").
- */
-type TokenCollections = Record<string, TokenCollection>;
-/**
- * Configuration for transforms applied to tokens during processing
- */
-type TransformsConfig = {
-    /** Configuration for fluid (responsive) values */
-    fluid?: FluidConfig;
-    /** Default color format for all color tokens */
-    colorFormat?: ColorFormat;
-    /** Prefix to add to all CSS variable names */
-    prefix?: string;
-};
-/**
- * Configuration for output directories (user config - optional fields)
- */
-type UserOutputConfig = {
-    /** Directory where CSS files will be written */
-    css?: string;
-    /** Directory containing token source files */
-    tokens?: string;
-    /** Directory for component files */
-    components?: string;
-    /** Whether to generate separate CSS files by token type (default: false) */
-    separate?: boolean;
-};
-/**
- * Configuration for output directories (internal config - required fields)
- */
-type OutputConfig = {
-    /** Directory where CSS files will be written */
-    css: string;
-    /** Directory containing token source files */
-    tokens: string;
-    /** Directory for component files */
-    components?: string;
-    /** Whether to generate separate CSS files by token type */
-    separate: boolean;
-};
-/**
- * Configuration for utility class generation
- */
-type UtilitiesConfig = {
-    /** Include core utilities (static, always-available utilities) */
-    core?: boolean;
-} & Record<string, UtilityConfig | UtilityConfig[]>;
-/**
- * Configuration for component framework integration
- */
-type ComponentsConfig = {
-    /** The component framework to use */
-    framework?: "react" | "astro";
-    /** List of installed component names */
-    installed?: string[];
-};
-/**
- * User configuration type - what users write (minimal, optional fields)
- */
-interface UserConfig {
-    /** Token source configuration, either a single collection or multiple named collections */
-    tokens: TokenCollection | TokenCollections;
-    /** Optional transforms applied during token processing */
-    transforms?: TransformsConfig;
-    /** Optional output configuration for generated files */
-    output?: UserOutputConfig;
-    /** Configuration for utility class generation */
-    utilities?: UtilitiesConfig;
-    /** Configuration for component framework integration */
-    components?: ComponentsConfig;
-    /** List of plugin names to load */
-    plugins?: string[];
-}
-/**
- * Internal configuration type - what code uses (complete, required fields)
- */
-interface SugarcubeConfig {
-    /** Token source configuration, either a single collection or multiple named collections */
-    tokens: TokenCollection | TokenCollections;
-    /** Optional transforms applied during token processing */
-    transforms?: TransformsConfig;
-    /** Required output configuration for generated files */
-    output: OutputConfig;
-    /** Configuration for utility class generation */
-    utilities?: UtilitiesConfig;
-    /** Configuration for component framework integration */
-    components?: ComponentsConfig;
-    /** List of plugin names to load */
-    plugins?: string[];
-}
-
-/**
- * Base error type that all other error types extend from.
- * Used as the foundation for all error types in the system.
- * Provides a consistent structure for error messages across the codebase.
- */
-type BaseError = {
-    /** A human-readable error message describing what went wrong */
-    message: string;
-};
-
 /**
  * Source information for a token, tracking its collection and theme.
  * This metadata helps with error reporting and token organization.
@@ -433,53 +383,6 @@ type TokenTree = {
     sourcePath: string;
 };
 
-/**
- * An error that occurred during token flattening.
- * Extends the base error type with flattening-specific information.
- */
-type FlattenError = BaseError & {
-    /** The path to the token that failed flattening */
-    path: string;
-    /** Source information about where the token was loaded from */
-    source: TokenSource;
-};
-
-/**
- * Represents a single CSS file output with its path and content
- */
-type CSSFile = {
-    /** The path where the CSS file will be written */
-    path: string;
-    /** The CSS content to write to the file */
-    css: string;
-};
-/**
- * Represents multiple CSS file outputs from generateSeparateFiles or generateSingleFile
- */
-type CSSFileOutput = CSSFile[];
-
-/**
- * Data structure for loading tokens from memory.
- * Maps file paths to their token content and metadata.
- * Used for programmatic token loading.
- */
-type TokenMemoryData = Record<string, {
-    /** The collection name this token belongs to */
-    collection: string;
-    /** Optional theme name for themed tokens */
-    theme?: string;
-    /** The raw token content as a string */
-    content: string;
-}>;
-/**
- * An error that occurred during token loading.
- * Extends the base error type with file-specific information.
- */
-type LoadError = BaseError & {
-    /** The file path where the error occurred */
-    file: string;
-};
-
 /**
  * A resolved token with its final value.
  * Contains both the original token data and its resolved value after reference resolution.
@@ -529,230 +432,325 @@ type ResolutionError = BaseError & {
 };
 
 /**
- * An error that occurred during token validation.
- * Extends the base error type with token-specific information.
+ * A token that has been converted to CSS properties.
+ * Extends ResolvedToken with CSS-specific properties.
+ * @template T The type of token
  */
-type ValidationError = BaseError & {
-    /** The path to the token that failed validation */
-    path: string;
-    /** Source information about where the token was loaded from */
-    source: TokenSource;
+type ConvertedToken<T extends TokenType = TokenType> = ResolvedToken<T> & {
+    /** The CSS properties generated from the token */
+    $cssProperties: CSSProperties<T>;
 };
-
 /**
- * Result of running any pipeline.
- * Contains the generated output, token trees, and any errors.
+ * A collection of converted tokens.
+ * Maps token paths to their converted values or metadata nodes.
  */
-type PipelineResult = {
-    /** The generated output (e.g. CSS files) */
-    output: CSSFileOutput;
-    /** The loaded token trees */
-    trees: TokenTree[];
-    /** Any errors that occurred during pipeline execution */
-    errors: PipelineErrors;
+type ConvertedTokens = {
+    [lookupKey: string]: ConvertedToken | NodeMetadata;
 };
 /**
- * Common error types that can occur during pipeline execution.
- * Organizes errors by the pipeline stage where they occurred.
+ * A collection of converted tokens organized by theme.
+ * Each theme contains its own set of converted tokens.
  */
-type PipelineErrors = {
-    /** Errors that occurred during token loading */
-    load: LoadError[];
-    /** Errors that occurred during token flattening */
-    flatten: FlattenError[];
-    /** Errors that occurred during token validation */
-    validation: ValidationError[];
-    /** Errors that occurred during token resolution */
-    resolution: ResolutionError[];
+type ConvertedThemeTokenSet = {
+    /** The default theme's tokens */
+    default: ConvertedTokens;
+    /** Additional theme-specific tokens */
+    [theme: string]: ConvertedTokens;
 };
 /**
- * Defines how tokens should be loaded and processed.
- * Either from files using a config, or from memory with token data.
+ * A collection of converted tokens organized by collection and theme.
+ * The top-level structure for all converted tokens.
  */
-type TokenPipelineSource = {
-    type: "files";
-    config: SugarcubeConfig;
-} | {
-    type: "memory";
-    data: Record<string, {
-        collection: string;
-        content: string;
+type NormalizedConvertedTokens = {
+    [collection: string]: ConvertedThemeTokenSet;
+};
+/**
+ * CSS property types for different token types.
+ * Maps token types to their corresponding CSS property structures.
+ * @template T The type of token
+ */
+type CSSProperties<T extends TokenType> = T extends SimpleTokenType ? SimpleCSSProperties : T extends AlwaysDecomposedType ? AlwaysDecomposedProperties : T extends "border" ? CSSBorderProperties : T extends "shadow" ? CSSShadowProperties : T extends "gradient" ? CSSGradientProperties : T extends "transition" ? CSSTransitionProperties : T extends StructuralCompositeType ? SimpleCSSProperties : never;
+/**
+ * Simple CSS properties with a single value.
+ * Used for tokens that map to a single CSS property.
+ */
+type SimpleCSSProperties = {
+    /** The CSS value */
+    value: string | number;
+    /** Optional feature queries for responsive values */
+    featureValues?: Array<{
+        query: string;
+        value: string;
     }>;
-    config: SugarcubeConfig;
 };
 /**
- * Options for loading tokens in the pipeline.
- * Specifies whether to load tokens from files or memory.
+ * CSS properties that are always broken down into multiple properties.
+ * Currently only used for typography tokens.
  */
-type TokenLoader = {
-    type: "files";
-    paths: SugarcubeConfig;
-} | {
-    type: "memory";
-    data: TokenMemoryData;
+type AlwaysDecomposedProperties = CSSTypographyProperties;
+/**
+ * CSS properties specific to typography tokens.
+ * Maps typography tokens to their corresponding CSS properties.
+ */
+type CSSTypographyProperties = {
+    /** The font family to use */
+    "font-family": string;
+    /** The font size */
+    "font-size": string;
+    /** The font weight */
+    "font-weight"?: number | string;
+    /** The letter spacing */
+    "letter-spacing"?: string;
+    /** The line height */
+    "line-height"?: number | string;
 };
-
 /**
- * Core token processing pipeline that handles loading, validation, and resolution of tokens.
- * This is the foundation for all other token processing operations.
- *
- * This pipeline:
- * 1. Loads token trees from config or memory
- * 2. Flattens trees into a single structure
- * 3. Validates tokens for correctness
- * 4. Resolves all token references
- *
- * Each stage can produce errors which are collected and returned in the result.
- *
- * @param source - The source of tokens to process, either from memory or config
- * @returns An object containing the processed trees, resolved tokens, and any errors
- *
- * @example
- * const result = await tokenProcessingPipeline({ type: "config", config });
- * if (result.errors.validation.length > 0) {
- *   console.error("Validation failed:", result.errors.validation);
- * }
+ * CSS properties for specific token types.
+ * These types represent tokens that map to single CSS properties.
  */
-declare function tokenProcessingPipeline(source: TokenPipelineSource): Promise<{
-    trees: TokenTree[];
-    resolved: ResolvedTokens;
-    errors: PipelineResult["errors"];
-}>;
+/**
+ * CSS properties for border tokens.
+ */
+type CSSBorderProperties = {
+    /** The border value */
+    value: string;
+};
+/**
+ * CSS properties for shadow tokens.
+ */
+type CSSShadowProperties = {
+    /** The shadow value */
+    value: string;
+};
+/**
+ * CSS properties for gradient tokens.
+ */
+type CSSGradientProperties = {
+    /** The gradient value */
+    value: string;
+};
+/**
+ * CSS properties for transition tokens.
+ */
+type CSSTransitionProperties = {
+    /** The transition value */
+    value: string;
+};
+
+/**
+ * Represents a single CSS file output with its path and content
+ */
+type CSSFile = {
+    /** The path where the CSS file will be written */
+    path: string;
+    /** The CSS content to write to the file */
+    css: string;
+    /** The collection name (e.g., "default", "base", "ui", "marketing") */
+    collection: string;
+};
+/**
+ * Represents multiple CSS file outputs from generateSeparateFiles or generateSingleFile
+ */
+type CSSFileOutput = CSSFile[];
+
+declare function generateCSSVariables(convertedTokens: NormalizedConvertedTokens, config: InternalConfig): Promise<CSSFileOutput>;
+
+/**
+ * An error that occurred during token flattening.
+ * Extends the base error type with flattening-specific information.
+ */
+type FlattenError = BaseError & {
+    /** The path to the token that failed flattening */
+    path: string;
+    /** Source information about where the token was loaded from */
+    source: TokenSource;
+};
 
 /**
  * Result of loading a Sugarcube configuration file
  */
-type LoadConfigResult = {
+type LoadedConfig = {
     /** The validated configuration */
-    config: SugarcubeConfig;
+    config: InternalConfig;
     /** The path to the config file that was loaded */
     configPath: string;
 };
 /**
- * Loads and validates the sugarcube configuration file from disk.
- *
- * This function:
- * 1. Reads the config file from the specified path
- * 2. Parses and validates the configuration
- * 3. Returns the validated configuration object and the path used
- *
- * @param configPath - Path to the config file (default: "sugarcube.config.json")
- * @returns A promise that resolves to the validated configuration and config path
- * @throws Error if the config file is not found or invalid
- *
- * @example
- * // Load default config file
- * const { config, configPath } = await loadConfig();
- *
- * // Load custom config file
- * const { config, configPath } = await loadConfig("./config/sugarcube.json");
+ * Data structure for loading tokens from memory.
+ * Maps file paths to their token content and metadata.
+ * Used for programmatic token loading.
  */
-declare function loadConfig(configPath?: string): Promise<LoadConfigResult>;
-
+type TokenMemoryData = Record<string, {
+    /** The collection name this token belongs to */
+    collection: string;
+    /** Optional theme name for themed tokens */
+    theme?: string;
+    /** The raw token content as a string */
+    content: string;
+}>;
 /**
- * Validates a user configuration object against the schema and normalizes it.
- *
- * This function:
- * 1. Validates the configuration structure using the user schema
- * 2. Normalizes the configuration by filling in defaults
- * 3. Validates the complete configuration using the internal schema
- * 4. Checks for duplicate filenames across collections
- * 5. Returns the validated and normalized configuration
- *
- * @param config - The user configuration object to validate
- * @returns The validated and normalized configuration
- * @throws Error if the configuration is invalid or contains duplicate filenames
- *
- * @example
- * const config = {
- *   tokens: {
- *     source: ["tokens.json"]
- *   }
- * };
- * const validatedConfig = validateConfig(config);
- * // validatedConfig.output.css === "src/styles" (default filled in)
+ * An error that occurred during token loading.
+ * Extends the base error type with file-specific information.
  */
-declare function validateConfig(config: Partial<UserConfig>): SugarcubeConfig;
+type LoadError = BaseError & {
+    /** The file path where the error occurred */
+    file: string;
+};
+
 /**
- * Parses and validates a JSON configuration string.
- *
- * This function:
- * 1. Parses the JSON string into a configuration object
- * 2. Validates and normalizes the configuration using validateConfig
- * 3. Returns the validated and normalized configuration
- *
- * @param configString - The JSON configuration string to parse and validate
- * @returns The validated and normalized configuration
- * @throws Error if the JSON is invalid or the configuration is invalid
- *
- * @example
- * const configString = `{
- *   "tokens": {
- *     "source": ["tokens.json"]
- *   }
- * }`;
- * const config = parseAndValidateConfig(configString);
- * // config.output.css === "src/styles" (default filled in)
+ * An error that occurred during token validation.
+ * Extends the base error type with token-specific information.
  */
-declare function parseAndValidateConfig(configString: string): SugarcubeConfig;
+type ValidationError = BaseError & {
+    /** The path to the token that failed validation */
+    path: string;
+    /** Source information about where the token was loaded from */
+    source: TokenSource;
+};
 
 /**
- * Default configuration values
+ * Result of running any pipeline.
+ * Contains the generated output, token trees, and any errors.
  */
-declare const DEFAULT_CONFIG: {
-    readonly output: {
-        readonly css: "src/styles";
-        readonly tokens: "src/design-tokens";
-        readonly components: "src/ui/components";
-        readonly separate: false;
-    };
+type PipelineResult = {
+    /** The generated output (e.g. CSS files) */
+    output: CSSFileOutput;
+    /** The loaded token trees */
+    trees: TokenTree[];
+    /** Any errors that occurred during pipeline execution */
+    errors: PipelineErrors;
+};
+/**
+ * Common error types that can occur during pipeline execution.
+ * Organizes errors by the pipeline stage where they occurred.
+ */
+type PipelineErrors = {
+    /** Errors that occurred during token loading */
+    load: LoadError[];
+    /** Errors that occurred during token flattening */
+    flatten: FlattenError[];
+    /** Errors that occurred during token validation */
+    validation: ValidationError[];
+    /** Errors that occurred during token resolution */
+    resolution: ResolutionError[];
 };
 /**
- * Normalizes a user configuration by filling in default values.
+ * Defines how tokens should be loaded and processed.
+ * Either from files using a config, or from memory with token data.
+ */
+type TokenPipelineSource = {
+    type: "files";
+    config: InternalConfig;
+} | {
+    type: "memory";
+    data: Record<string, {
+        collection: string;
+        content: string;
+    }>;
+    config: InternalConfig;
+};
+/**
+ * Options for loading tokens in the pipeline.
+ * Specifies whether to load tokens from files or memory.
+ */
+type TokenLoader = {
+    type: "files";
+    paths: InternalConfig;
+} | {
+    type: "memory";
+    data: TokenMemoryData;
+};
+
+/**
+ * Core token processing pipeline that handles loading, validation, and resolution of tokens.
+ * This is the foundation for all other token processing operations.
+ *
+ * This pipeline:
+ * 1. Loads token trees from config or memory
+ * 2. Flattens trees into a single structure
+ * 3. Validates tokens for correctness
+ * 4. Resolves all token references
  *
- * This function takes a minimal user config (with optional fields) and
- * returns a complete internal config (with all required fields).
+ * Each stage can produce errors which are collected and returned in the result.
  *
- * @param userConfig - The user configuration with optional fields
- * @returns A complete configuration with all defaults filled in
+ * @param source - The source of tokens to process, either from memory or config
+ * @returns An object containing the processed trees, resolved tokens, and any errors
  *
  * @example
- * const userConfig = {
- *   tokens: { source: ["tokens/*.json"] }
- * };
- * const completeConfig = normalizeConfig(userConfig);
- * // completeConfig.output.css === "src/styles"
- * // completeConfig.output.tokens === "src/design-tokens"
- * // completeConfig.output.components === "src/ui/components"
- * // completeConfig.output.separate === false
+ * const result = await loadAndResolveTokens({ type: "config", config });
+ * if (result.errors.validation.length > 0) {
+ *   console.error("Validation failed:", result.errors.validation);
+ * }
  */
-declare function normalizeConfig(userConfig: UserConfig): SugarcubeConfig;
+declare function loadAndResolveTokens(source: TokenPipelineSource): Promise<{
+    trees: TokenTree[];
+    resolved: ResolvedTokens;
+    errors: PipelineResult["errors"];
+}>;
+
+type NamedUtilityValue = {
+    kind: "named";
+    value: string;
+    fraction: string | null;
+};
+type ArbitraryUtilityValue = {
+    kind: "arbitrary";
+    value: string;
+};
+type UtilityValue = NamedUtilityValue | ArbitraryUtilityValue;
+type StaticVariant = {
+    kind: "static";
+    root: string;
+};
+type FunctionalVariant = {
+    kind: "functional";
+    root: string;
+    value: UtilityValue;
+};
+type Variant = StaticVariant | FunctionalVariant;
+type StaticCandidate = {
+    kind: "static";
+    root: string;
+    variants: Variant[];
+    raw: string;
+};
+type FunctionalCandidate = {
+    kind: "functional";
+    root: string;
+    value: UtilityValue | null;
+    variants: Variant[];
+    raw: string;
+};
+type Candidate = StaticCandidate | FunctionalCandidate;
+interface StaticUtilityPattern {
+    properties: string[];
+    validator: (candidate: Candidate) => boolean;
+    generator: (candidate: Candidate) => string;
+}
 
 /**
- * Gets all token source file paths from the configuration.
+ * Processes and converts token trees into CSS-ready format.
+ * This pipeline:
+ * 1. Processes trees with resolved tokens to create a unified structure
+ * 2. Normalizes tokens into a collection-theme organization
+ * 3. Converts tokens to their CSS representations with properties
  *
- * This function handles both single and multiple collection configurations:
- * - Single collection: Returns the source array directly
- * - Multiple collections: Flattens and returns all source paths from all collections
  *
+ * @param trees - The token trees to process
+ * @param resolved - The resolved tokens for processing
  * @param config - The sugarcube configuration
- * @returns An array of all token source file paths
+ * @param validationErrors - Optional array of validation errors. Tokens with validation errors will be filtered out before conversion.
+ * @returns The processed and converted tokens ready for CSS generation
  *
  * @example
- * // Single collection
- * getTokenPathsFromConfig({ tokens: { source: ["tokens.json"] } })
- * // Returns: ["tokens.json"]
- *
- * // Multiple collections
- * getTokenPathsFromConfig({
- *   tokens: {
- *     base: { source: ["base.json"] },
- *     ui: { source: ["ui.json"] }
- *   }
- * })
- * // Returns: ["base.json", "ui.json"]
+ * const convertedTokens = await processAndConvertTokens(trees, resolved, config);
+ * // convertedTokens = { collection: { theme: { "token.path": { $cssProperties: {...} } } } }
  */
-declare function getTokenPathsFromConfig(config: SugarcubeConfig): string[];
+declare function processAndConvertTokens(trees: TokenTree[], resolved: ResolvedTokens, config: InternalConfig, validationErrors?: ValidationError[]): Promise<NormalizedConvertedTokens>;
+
+declare function generateIndex(stylesDir: string, config: InternalConfig): Promise<string>;
+declare function shouldRegenerateIndex(stylesDir: string, config: InternalConfig): Promise<boolean>;
+
 /**
  * Writes CSS files to disk, creating directories as needed.
  *
@@ -793,79 +791,107 @@ declare function writeCSSVariablesToDisk(output: CSSFileOutput): Promise<CSSFile
  */
 declare function writeCSSUtilitiesToDisk(output: CSSFileOutput): Promise<CSSFileOutput>;
 
+declare function findConfigFile(basePath?: string): string | null;
+declare function configFileExists(basePath?: string): boolean;
+declare function loadTSConfig(configPath: string): Promise<unknown>;
+declare function loadUserConfig(configPath?: string): Promise<{
+    config: UserConfig;
+    configPath: string;
+}>;
+declare function loadInternalConfig(configPath?: string): Promise<LoadedConfig>;
+
+/**
+ * Validates a user configuration object against the user schema.
+ *
+ * @param config - The user configuration object to validate
+ * @returns The validated user configuration
+ * @throws Error if the configuration is invalid
+ */
+declare function validateUserConfig(config: Partial<UserConfig>): UserConfig;
 /**
- * Generates utility CSS classes from resolved tokens based on utility configuration.
- * This function creates CSS utility classes that map token values to CSS properties.
+ * Validates an internal configuration object against the internal schema and checks for duplicate filenames.
  *
- * The generation process:
- * 1. Iterates through all resolved tokens
- * 2. Matches tokens against utility configurations
- * 3. Generates CSS rules for each matching token and property
- * 4. Handles directional variants (e.g., padding-top, margin-right) if configured
- * 5. Formats and returns the final CSS string
+ * @param config - The internal configuration object to validate
+ * @returns The validated internal configuration
+ * @throws Error if the configuration is invalid or contains duplicate filenames
+ */
+declare function validateInternalConfig(config: InternalConfig): InternalConfig;
+/**
+ * Validates a user configuration object against the schema and fills in defaults.
  *
- * The generated CSS uses CSS custom properties (variables) to reference token values,
- * maintaining the connection between tokens and their usage in utilities.
+ * This function:
+ * 1. Validates the configuration structure using the user schema
+ * 2. Fills in default values
+ * 3. Validates the complete configuration using the internal schema
+ * 4. Checks for duplicate filenames across collections
+ * 5. Returns the validated configuration with defaults filled in
  *
- * @param tokens - The resolved tokens to generate utilities from
- * @param config - The sugarcube configuration containing utility settings
- * @returns An object containing the generated CSS, errors, and warnings
+ * @param config - The user configuration object to validate
+ * @returns The validated configuration with defaults filled in
+ * @throws Error if the configuration is invalid or contains duplicate filenames
  *
  * @example
- * const { css } = generateUtilityCSS(resolvedTokens, config);
- * // css = ".u-p-4 { padding: var(--spacing-4); }\n.u-mt-2 { margin-top: var(--spacing-2); }"
+ * const config = {
+ *   tokens: {
+ *     source: ["tokens.json"]
+ *   }
+ * };
+ * const validatedConfig = validateConfig(config);
+ * // validatedConfig.output.css === "src/styles" (default filled in)
  */
-declare function generateCSSUtilityClasses(tokens: ResolvedTokens, config: SugarcubeConfig): {
-    output: CSSFileOutput;
-    errors: Error[];
-};
-
+declare function validateConfig(config: Partial<UserConfig>): InternalConfig;
 /**
- * Generates CSS variables from processed token trees and resolved tokens.
- * This pipeline handles the conversion of tokens into CSS variable format.
+ * Parses and validates a JSON configuration string.
  *
- * This pipeline:
- * 1. Processes trees with resolved tokens
- * 2. Normalizes tokens into a collection-theme structure
- * 3. Converts tokens to CSS-ready format
- * 4. Generates final CSS output
+ * This function:
+ * 1. Parses the JSON string into a configuration object
+ * 2. Validates and normalizes the configuration using validateConfig
+ * 3. Returns the validated and normalized configuration
  *
- * @param trees - The processed token trees
- * @param resolved - The resolved tokens
- * @param config - The sugarcube configuration
- * @returns An object containing the generated CSS output
+ * @param configString - The JSON configuration string to parse and validate
+ * @returns The validated and normalized configuration
+ * @throws Error if the JSON is invalid or the configuration is invalid
  *
  * @example
- * const { output } = await cssVariablesPipeline(trees, resolved, config);
- * // output = [{ path: "path/to/output.css", css: ":root { ... }" }]
+ * const configString = `{
+ *   "tokens": {
+ *     "source": ["tokens.json"]
+ *   }
+ * }`;
+ * const config = parseAndValidateConfig(configString);
+ * // config.output.css === "src/styles" (default filled in)
  */
-declare function generateCSSVariables(trees: TokenTree[], resolved: ResolvedTokens, config: SugarcubeConfig): Promise<{
-    output: CSSFileOutput;
-}>;
+declare function parseAndValidateConfig(configString: string): InternalConfig;
 
-declare function generateIndex(stylesDir: string, config: SugarcubeConfig): Promise<string>;
-declare function shouldRegenerateIndex(stylesDir: string, config: SugarcubeConfig): Promise<boolean>;
+/**
+ * Fills in default values for any omitted fields in a user configuration.
+ *
+ * This function takes a user config (with optional fields) and
+ * returns a complete internal config (with all required fields filled in).
+ *
+ * @param userConfig - The user configuration with optional fields
+ * @returns A complete configuration with all defaults filled in
+ *
+ * @example
+ * const userConfig = {
+ *   tokens: { source: ["tokens/*.json"] }
+ * };
+ * const completeConfig = fillDefaults(userConfig);
+ * // completeConfig.output.css === "src/styles"
+ * // completeConfig.output.components === "src/ui/components"
+ * // completeConfig.output.separate === false
+ */
+declare function fillDefaults(userConfig: UserConfig): InternalConfig;
 
 interface CSSImport {
     path: string;
     layer: string;
     relativePath: string;
 }
-declare function discoverAllFiles(stylesDir: string, config: SugarcubeConfig): Promise<CSSImport[]>;
+declare function discoverAllFiles(stylesDir: string, config: InternalConfig): Promise<CSSImport[]>;
 
 declare function generateIndexContent(files: CSSImport[]): string;
 
-declare const SUGARCUBE_FILE = "_sugarcube.css";
-declare const GLOBAL_DIR = "global";
-declare const UTILITIES_DIR = "utilities";
-declare const VARIABLES_FILE_SUFFIX = ".variables.css";
-declare const TOKENS_FILE_SUFFIX = ".tokens.json";
-declare const DEFAULT_VARIABLES_FILENAME = "tokens";
-declare const DEFAULT_UTILITIES_FILENAME = "utilities.css";
-declare const DEFAULT_STYLES_PATH = "src/styles";
-declare const DEFAULT_DESIGN_TOKENS_PATH = "src/design-tokens";
-declare const SUGARCUBE_CONFIG_FILE = "sugarcube.config.json";
-
 declare class Instrumentation implements Disposable {
     #private;
     private defaultFlush;
@@ -877,361 +903,120 @@ declare class Instrumentation implements Disposable {
     [Symbol.dispose](): void;
 }
 
-declare const userConfigSchema: z.ZodObject<{
-    tokens: z.ZodUnion<[z.ZodObject<{
-        source: z.ZodArray<z.ZodString, "many">;
-        themes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
-    }, "strip", z.ZodTypeAny, {
-        source: string[];
-        themes?: Record<string, string[]> | undefined;
-    }, {
-        source: string[];
-        themes?: Record<string, string[]> | undefined;
-    }>, z.ZodRecord<z.ZodString, z.ZodObject<{
-        source: z.ZodArray<z.ZodString, "many">;
-        themes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
-    }, "strip", z.ZodTypeAny, {
-        source: string[];
-        themes?: Record<string, string[]> | undefined;
-    }, {
-        source: string[];
-        themes?: Record<string, string[]> | undefined;
-    }>>]>;
-    transforms: z.ZodOptional<z.ZodObject<{
-        fluid: z.ZodOptional<z.ZodObject<{
-            min: z.ZodNumber;
-            max: z.ZodNumber;
-        }, "strip", z.ZodTypeAny, {
-            min: number;
-            max: number;
-        }, {
-            min: number;
-            max: number;
-        }>>;
-        colorFormat: z.ZodOptional<z.ZodEnum<["hex", "rgb", "rgba", "hsl", "hsla", "oklch", "p3"]>>;
-        prefix: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        prefix?: string | undefined;
-        fluid?: {
-            min: number;
-            max: number;
-        } | undefined;
-        colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | "hsla" | "oklch" | "p3" | undefined;
-    }, {
-        prefix?: string | undefined;
-        fluid?: {
-            min: number;
-            max: number;
-        } | undefined;
-        colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | "hsla" | "oklch" | "p3" | undefined;
-    }>>;
-    output: z.ZodOptional<z.ZodObject<{
-        css: z.ZodOptional<z.ZodString>;
-        tokens: z.ZodOptional<z.ZodString>;
-        components: z.ZodOptional<z.ZodString>;
-        separate: z.ZodOptional<z.ZodBoolean>;
-    }, "strip", z.ZodTypeAny, {
-        tokens?: string | undefined;
-        css?: string | undefined;
-        components?: string | undefined;
-        separate?: boolean | undefined;
-    }, {
-        tokens?: string | undefined;
-        css?: string | undefined;
-        components?: string | undefined;
-        separate?: boolean | undefined;
-    }>>;
-    utilities: z.ZodOptional<z.ZodObject<{
-        core: z.ZodOptional<z.ZodBoolean>;
-    }, "strip", z.ZodUnion<[z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }>, z.ZodArray<z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }>, "many">]>, z.objectOutputType<{
-        core: z.ZodOptional<z.ZodBoolean>;
-    }, z.ZodUnion<[z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }>, z.ZodArray<z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }>, "many">]>, "strip">, z.objectInputType<{
-        core: z.ZodOptional<z.ZodBoolean>;
-    }, z.ZodUnion<[z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }>, z.ZodArray<z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }>, "many">]>, "strip">>>;
-    components: z.ZodOptional<z.ZodObject<{
-        framework: z.ZodOptional<z.ZodEnum<["react", "astro"]>>;
-        installed: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, "strip", z.ZodTypeAny, {
-        framework?: "react" | "astro" | undefined;
-        installed?: string[] | undefined;
-    }, {
-        framework?: "react" | "astro" | undefined;
-        installed?: string[] | undefined;
-    }>>;
-    plugins: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-}, "strip", z.ZodTypeAny, {
-    tokens: {
-        source: string[];
-        themes?: Record<string, string[]> | undefined;
-    } | Record<string, {
-        source: string[];
-        themes?: Record<string, string[]> | undefined;
-    }>;
-    utilities?: z.objectOutputType<{
-        core: z.ZodOptional<z.ZodBoolean>;
-    }, z.ZodUnion<[z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }>, z.ZodArray<z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }>, "many">]>, "strip"> | undefined;
-    output?: {
-        tokens?: string | undefined;
-        css?: string | undefined;
-        components?: string | undefined;
-        separate?: boolean | undefined;
-    } | undefined;
-    transforms?: {
-        prefix?: string | undefined;
-        fluid?: {
-            min: number;
-            max: number;
-        } | undefined;
-        colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | "hsla" | "oklch" | "p3" | undefined;
-    } | undefined;
-    components?: {
-        framework?: "react" | "astro" | undefined;
-        installed?: string[] | undefined;
-    } | undefined;
-    plugins?: string[] | undefined;
-}, {
-    tokens: {
-        source: string[];
-        themes?: Record<string, string[]> | undefined;
-    } | Record<string, {
-        source: string[];
-        themes?: Record<string, string[]> | undefined;
-    }>;
-    utilities?: z.objectInputType<{
-        core: z.ZodOptional<z.ZodBoolean>;
-    }, z.ZodUnion<[z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }>, z.ZodArray<z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }>, "many">]>, "strip"> | undefined;
-    output?: {
-        tokens?: string | undefined;
-        css?: string | undefined;
-        components?: string | undefined;
-        separate?: boolean | undefined;
-    } | undefined;
-    transforms?: {
-        prefix?: string | undefined;
-        fluid?: {
-            min: number;
-            max: number;
-        } | undefined;
-        colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | "hsla" | "oklch" | "p3" | undefined;
-    } | undefined;
-    components?: {
-        framework?: "react" | "astro" | undefined;
-        installed?: string[] | undefined;
-    } | undefined;
-    plugins?: string[] | undefined;
-}>;
-declare const internalConfigSchema: z.ZodObject<{
-    tokens: z.ZodUnion<[z.ZodObject<{
+type CSSObject = Record<string, string | number | undefined>;
+declare function convertConfigToUnoRules(utilitiesConfig: UtilitiesConfig, tokens: NormalizedConvertedTokens): Array<[RegExp, (m: RegExpMatchArray) => CSSObject]>;
+
+declare const SUGARCUBE_FILE = "_sugarcube.css";
+declare const GLOBAL_DIR = "global";
+declare const UTILITIES_DIR = "utilities";
+declare const VARIABLES_FILE_SUFFIX = ".variables.gen.css";
+declare const DEFAULT_VARIABLES_FILENAME = "tokens";
+declare const DEFAULT_UTILITIES_FILENAME = "utilities.gen.css";
+declare const DEFAULT_STYLES_PATH = "src/styles";
+declare const DEFAULT_DESIGN_TOKENS_PATH = "src/design-tokens";
+declare const SUGARCUBE_CONFIG_FILE = "sugarcube.config.ts";
+
+declare const DEFAULT_CONFIG: {
+    readonly output: {
+        readonly css: "src/styles";
+        readonly components: "src/components/ui";
+        readonly separate: false;
+    };
+    readonly transforms: {
+        readonly fluid: {
+            readonly min: 320;
+            readonly max: 1200;
+        };
+        readonly colorFallbackStrategy: "native";
+    };
+};
+
+declare const DEFAULT_COLLECTION = "default";
+declare const DEFAULT_THEME = "default";
+
+declare const ErrorMessages: {
+    readonly LOAD: {
+        readonly NO_FILES_FOUND: (pattern: string) => string;
+        readonly INVALID_JSON: (path: string, message: string) => string;
+        readonly GLOB_ERROR: (pattern: string, error: string) => string;
+    };
+    readonly FLATTEN: {
+        readonly INVALID_TOKEN_NAME: (name: string) => string;
+        readonly MISSING_DOLLAR_PREFIX: (path: string) => string;
+        readonly INVALID_TOKEN_NESTING: (path: string) => string;
+        readonly COMPOSITE_TOKEN_MISSING_TYPE: (path: string) => string;
+        readonly CONFLICT_TOKEN_VS_GROUP: (path: string) => string;
+        readonly CONFLICT_INCOMPATIBLE_TYPES: (expected: string, received: string, path: string) => string;
+    };
+    readonly METADATA: {
+        readonly COLLECTION_ERROR: (message: string) => string;
+        readonly INVALID_EXTENSIONS: (path: string) => string;
+        readonly INVALID_DESCRIPTION: (path: string) => string;
+    };
+    readonly VALIDATE: {
+        readonly MISSING_TYPE: (path: string) => string;
+        readonly UNKNOWN_TOKEN_TYPE: (type: string, path: string) => string;
+        readonly INVALID_COLOR: (value: unknown, path: string) => string;
+        readonly INVALID_DIMENSION: (value: unknown, path: string) => string;
+        readonly INVALID_DIMENSION_UNIT: (unit: unknown, path: string) => string;
+        readonly INVALID_FONT_FAMILY: (value: unknown, path: string) => string;
+        readonly INVALID_FONT_WEIGHT: (value: unknown, path: string) => string;
+        readonly INVALID_DURATION: (value: unknown, path: string) => string;
+        readonly INVALID_DURATION_UNIT: (unit: unknown, path: string) => string;
+        readonly INVALID_CUBIC_BEZIER: (value: unknown, path: string) => string;
+        readonly INVALID_STROKE_STYLE: (value: unknown, path: string) => string;
+        readonly INVALID_STROKE_LINE_CAP: (value: unknown, path: string) => string;
+        readonly INVALID_BORDER: (value: unknown, path: string) => string;
+        readonly INVALID_SHADOW: (value: unknown, path: string) => string;
+        readonly INVALID_SHADOW_INSET: (value: unknown, path: string) => string;
+        readonly INVALID_TRANSITION: (value: unknown, path: string) => string;
+        readonly INVALID_GRADIENT: (value: unknown, path: string) => string;
+        readonly INVALID_GRADIENT_STOP_POSITION: (value: unknown, path: string) => string;
+        readonly INVALID_TYPOGRAPHY: (value: unknown, path: string) => string;
+        readonly MISSING_REQUIRED_PROPERTY: (prop: string, path: string) => string;
+        readonly INVALID_NUMBER: (value: unknown, path: string) => string;
+        readonly INVALID_ARRAY: (value: unknown, path: string) => string;
+        readonly MISSING_FLUID_CONFIG: (path: string) => string;
+        readonly INVALID_FLUID_DIMENSION: (value: unknown, path: string) => string;
+        readonly INVALID_VIEWPORT_CONFIG: (value: unknown, path: string) => string;
+        readonly MISMATCHED_UNITS: (unit1: unknown, unit2: unknown, path: string) => string;
+        readonly INVALID_FLUID_VALUE_RANGE: (path: string) => string;
+        readonly INVALID_TOKEN_TYPE: (expected: string, received: string, path: string) => string;
+        readonly INVALID_TYPE: (expected: string, value: unknown, path: string) => string;
+        readonly INVALID_ENUM_VALUE: (enumValues: unknown[], value: unknown, path: string) => string;
+    };
+    readonly RESOLVE: {
+        readonly CIRCULAR_REFERENCE: (path: string, ref: string) => string;
+        readonly REFERENCE_NOT_FOUND: (ref: string, path: string) => string;
+        readonly TYPE_MISMATCH: (path: string) => string;
+    };
+    readonly GENERATE: {
+        readonly INVALID_CSS_VALUE: (key: string, value: unknown) => string;
+        readonly INVALID_VARIABLE_NAME: (path: string, name: string) => string;
+    };
+    readonly CONFIG: {
+        readonly INVALID_JSON: (error: string) => string;
+        readonly INVALID_CONFIG: (path: string, message: string) => string;
+        readonly DUPLICATE_FILENAMES: (collection: string, filename: string, paths: string[]) => string;
+        readonly FILE_NOT_FOUND: (path: string) => string;
+    };
+    readonly UTILITIES: {
+        readonly RESERVED_PREFIX: (prefix: string, tokenType: string) => string;
+        readonly DUPLICATE_CLASS_NAME: (className: string, paths: string[]) => string;
+        readonly INVALID_PROPERTY_MAPPING: (tokenType: string) => string;
+        readonly DUPLICATE_PREFIX: (prefix: string, tokenType: string) => string;
+        readonly INVALID_COLLECTION: (property: string, collection: string, availableCollections: string[]) => string;
+        readonly TOKEN_PATH_CONFLICT: (tokenPath: string, collections: string) => string;
+        readonly MISSING_SOURCE: (property: string) => string;
+        readonly INVALID_SOURCE_PATTERN: (property: string, source: string) => string;
+        readonly INVALID_DIRECTIONS: (property: string) => string;
+        readonly INVALID_CONFIG_OBJECT: "utilitiesConfig must be an object";
+        readonly INVALID_TOKENS_OBJECT: "tokens must be an object";
+    };
+};
+
+declare const userConfigSchema: z.ZodObject<{
+    tokens: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodObject<{
         source: z.ZodArray<z.ZodString, "many">;
         themes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
     }, "strip", z.ZodTypeAny, {
@@ -1240,7 +1025,7 @@ declare const internalConfigSchema: z.ZodObject<{
     }, {
         source: string[];
         themes?: Record<string, string[]> | undefined;
-    }>, z.ZodRecord<z.ZodString, z.ZodObject<{
+    }>>, z.ZodObject<{
         source: z.ZodArray<z.ZodString, "many">;
         themes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
     }, "strip", z.ZodTypeAny, {
@@ -1249,7 +1034,7 @@ declare const internalConfigSchema: z.ZodObject<{
     }, {
         source: string[];
         themes?: Record<string, string[]> | undefined;
-    }>>]>;
+    }>]>>;
     transforms: z.ZodOptional<z.ZodObject<{
         fluid: z.ZodOptional<z.ZodObject<{
             min: z.ZodNumber;
@@ -1261,330 +1046,139 @@ declare const internalConfigSchema: z.ZodObject<{
             min: number;
             max: number;
         }>>;
-        colorFormat: z.ZodOptional<z.ZodEnum<["hex", "rgb", "rgba", "hsl", "hsla", "oklch", "p3"]>>;
-        prefix: z.ZodOptional<z.ZodString>;
+        colorFallbackStrategy: z.ZodOptional<z.ZodEnum<["native", "polyfill"]>>;
     }, "strip", z.ZodTypeAny, {
-        prefix?: string | undefined;
         fluid?: {
             min: number;
             max: number;
         } | undefined;
-        colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | "hsla" | "oklch" | "p3" | undefined;
+        colorFallbackStrategy?: "native" | "polyfill" | undefined;
     }, {
-        prefix?: string | undefined;
         fluid?: {
             min: number;
             max: number;
         } | undefined;
-        colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | "hsla" | "oklch" | "p3" | undefined;
+        colorFallbackStrategy?: "native" | "polyfill" | undefined;
     }>>;
-    output: z.ZodObject<{
-        css: z.ZodString;
-        tokens: z.ZodString;
-        components: z.ZodString;
-        separate: z.ZodBoolean;
-    }, "strip", z.ZodTypeAny, {
-        tokens: string;
-        css: string;
-        components: string;
-        separate: boolean;
-    }, {
-        tokens: string;
-        css: string;
-        components: string;
-        separate: boolean;
-    }>;
-    utilities: z.ZodOptional<z.ZodObject<{
-        core: z.ZodOptional<z.ZodBoolean>;
-    }, "strip", z.ZodUnion<[z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }>, z.ZodArray<z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }>, "many">]>, z.objectOutputType<{
-        core: z.ZodOptional<z.ZodBoolean>;
-    }, z.ZodUnion<[z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }>, z.ZodArray<z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    output: z.ZodOptional<z.ZodObject<{
+        css: z.ZodOptional<z.ZodString>;
+        components: z.ZodOptional<z.ZodString>;
+        separate: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
+        css?: string | undefined;
+        components?: string | undefined;
+        separate?: boolean | undefined;
     }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }>, "many">]>, "strip">, z.objectInputType<{
-        core: z.ZodOptional<z.ZodBoolean>;
-    }, z.ZodUnion<[z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        css?: string | undefined;
+        components?: string | undefined;
+        separate?: boolean | undefined;
+    }>>;
+    utilities: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodObject<{
+        source: z.ZodString;
+        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full", "all"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full", "all"]>, "many">]>>;
         prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        stripDuplicates: z.ZodOptional<z.ZodBoolean>;
+        collection: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
+        source: string;
+        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all")[] | undefined;
         prefix?: string | undefined;
-        stripLevels?: number | undefined;
+        stripDuplicates?: boolean | undefined;
+        collection?: string | undefined;
     }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
+        source: string;
+        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all")[] | undefined;
         prefix?: string | undefined;
-        stripLevels?: number | undefined;
+        stripDuplicates?: boolean | undefined;
+        collection?: string | undefined;
     }>, z.ZodArray<z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        source: z.ZodString;
+        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full", "all"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full", "all"]>, "many">]>>;
         prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        stripDuplicates: z.ZodOptional<z.ZodBoolean>;
+        collection: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
+        source: string;
+        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all")[] | undefined;
         prefix?: string | undefined;
-        stripLevels?: number | undefined;
+        stripDuplicates?: boolean | undefined;
+        collection?: string | undefined;
     }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
+        source: string;
+        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all")[] | undefined;
         prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }>, "many">]>, "strip">>>;
-    components: z.ZodOptional<z.ZodObject<{
-        framework: z.ZodOptional<z.ZodEnum<["react", "astro"]>>;
-        installed: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, "strip", z.ZodTypeAny, {
-        framework?: "react" | "astro" | undefined;
-        installed?: string[] | undefined;
-    }, {
-        framework?: "react" | "astro" | undefined;
-        installed?: string[] | undefined;
-    }>>;
-    plugins: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        stripDuplicates?: boolean | undefined;
+        collection?: string | undefined;
+    }>, "many">]>>>;
 }, "strip", z.ZodTypeAny, {
-    tokens: {
+    tokens?: {
         source: string[];
         themes?: Record<string, string[]> | undefined;
     } | Record<string, {
         source: string[];
         themes?: Record<string, string[]> | undefined;
-    }>;
-    output: {
-        tokens: string;
-        css: string;
-        components: string;
-        separate: boolean;
-    };
-    utilities?: z.objectOutputType<{
-        core: z.ZodOptional<z.ZodBoolean>;
-    }, z.ZodUnion<[z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }>, z.ZodArray<z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }>, "many">]>, "strip"> | undefined;
+    }> | undefined;
     transforms?: {
-        prefix?: string | undefined;
         fluid?: {
             min: number;
             max: number;
         } | undefined;
-        colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | "hsla" | "oklch" | "p3" | undefined;
+        colorFallbackStrategy?: "native" | "polyfill" | undefined;
     } | undefined;
-    components?: {
-        framework?: "react" | "astro" | undefined;
-        installed?: string[] | undefined;
+    output?: {
+        css?: string | undefined;
+        components?: string | undefined;
+        separate?: boolean | undefined;
     } | undefined;
-    plugins?: string[] | undefined;
+    utilities?: Record<string, {
+        source: string;
+        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all")[] | undefined;
+        prefix?: string | undefined;
+        stripDuplicates?: boolean | undefined;
+        collection?: string | undefined;
+    } | {
+        source: string;
+        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all")[] | undefined;
+        prefix?: string | undefined;
+        stripDuplicates?: boolean | undefined;
+        collection?: string | undefined;
+    }[]> | undefined;
 }, {
-    tokens: {
+    tokens?: {
         source: string[];
         themes?: Record<string, string[]> | undefined;
     } | Record<string, {
         source: string[];
         themes?: Record<string, string[]> | undefined;
-    }>;
-    output: {
-        tokens: string;
-        css: string;
-        components: string;
-        separate: boolean;
-    };
-    utilities?: z.objectInputType<{
-        core: z.ZodOptional<z.ZodBoolean>;
-    }, z.ZodUnion<[z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }>, z.ZodArray<z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }>, "many">]>, "strip"> | undefined;
+    }> | undefined;
     transforms?: {
-        prefix?: string | undefined;
         fluid?: {
             min: number;
             max: number;
         } | undefined;
-        colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | "hsla" | "oklch" | "p3" | undefined;
+        colorFallbackStrategy?: "native" | "polyfill" | undefined;
     } | undefined;
-    components?: {
-        framework?: "react" | "astro" | undefined;
-        installed?: string[] | undefined;
+    output?: {
+        css?: string | undefined;
+        components?: string | undefined;
+        separate?: boolean | undefined;
     } | undefined;
-    plugins?: string[] | undefined;
+    utilities?: Record<string, {
+        source: string;
+        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all")[] | undefined;
+        prefix?: string | undefined;
+        stripDuplicates?: boolean | undefined;
+        collection?: string | undefined;
+    } | {
+        source: string;
+        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all")[] | undefined;
+        prefix?: string | undefined;
+        stripDuplicates?: boolean | undefined;
+        collection?: string | undefined;
+    }[]> | undefined;
 }>;
-declare const configSchema: z.ZodObject<{
-    tokens: z.ZodUnion<[z.ZodObject<{
+declare const internalConfigSchema: z.ZodObject<{
+    tokens: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodObject<{
         source: z.ZodArray<z.ZodString, "many">;
         themes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
     }, "strip", z.ZodTypeAny, {
@@ -1593,7 +1187,7 @@ declare const configSchema: z.ZodObject<{
     }, {
         source: string[];
         themes?: Record<string, string[]> | undefined;
-    }>, z.ZodRecord<z.ZodString, z.ZodObject<{
+    }>>, z.ZodObject<{
         source: z.ZodArray<z.ZodString, "many">;
         themes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
     }, "strip", z.ZodTypeAny, {
@@ -1602,9 +1196,9 @@ declare const configSchema: z.ZodObject<{
     }, {
         source: string[];
         themes?: Record<string, string[]> | undefined;
-    }>>]>;
-    transforms: z.ZodOptional<z.ZodObject<{
-        fluid: z.ZodOptional<z.ZodObject<{
+    }>]>>;
+    transforms: z.ZodObject<{
+        fluid: z.ZodObject<{
             min: z.ZodNumber;
             max: z.ZodNumber;
         }, "strip", z.ZodTypeAny, {
@@ -1613,328 +1207,159 @@ declare const configSchema: z.ZodObject<{
         }, {
             min: number;
             max: number;
-        }>>;
-        colorFormat: z.ZodOptional<z.ZodEnum<["hex", "rgb", "rgba", "hsl", "hsla", "oklch", "p3"]>>;
-        prefix: z.ZodOptional<z.ZodString>;
+        }>;
+        colorFallbackStrategy: z.ZodEnum<["native", "polyfill"]>;
     }, "strip", z.ZodTypeAny, {
-        prefix?: string | undefined;
-        fluid?: {
+        fluid: {
             min: number;
             max: number;
-        } | undefined;
-        colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | "hsla" | "oklch" | "p3" | undefined;
+        };
+        colorFallbackStrategy: "native" | "polyfill";
     }, {
-        prefix?: string | undefined;
-        fluid?: {
+        fluid: {
             min: number;
             max: number;
-        } | undefined;
-        colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | "hsla" | "oklch" | "p3" | undefined;
-    }>>;
-    output: z.ZodOptional<z.ZodObject<{
-        css: z.ZodOptional<z.ZodString>;
-        tokens: z.ZodOptional<z.ZodString>;
-        components: z.ZodOptional<z.ZodString>;
-        separate: z.ZodOptional<z.ZodBoolean>;
-    }, "strip", z.ZodTypeAny, {
-        tokens?: string | undefined;
-        css?: string | undefined;
-        components?: string | undefined;
-        separate?: boolean | undefined;
-    }, {
-        tokens?: string | undefined;
-        css?: string | undefined;
-        components?: string | undefined;
-        separate?: boolean | undefined;
-    }>>;
-    utilities: z.ZodOptional<z.ZodObject<{
-        core: z.ZodOptional<z.ZodBoolean>;
-    }, "strip", z.ZodUnion<[z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }>, z.ZodArray<z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }>, "many">]>, z.objectOutputType<{
-        core: z.ZodOptional<z.ZodBoolean>;
-    }, z.ZodUnion<[z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }>, z.ZodArray<z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        };
+        colorFallbackStrategy: "native" | "polyfill";
+    }>;
+    output: z.ZodObject<{
+        css: z.ZodString;
+        components: z.ZodString;
+        separate: z.ZodBoolean;
     }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
+        components: string;
+        css: string;
+        separate: boolean;
     }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }>, "many">]>, "strip">, z.objectInputType<{
-        core: z.ZodOptional<z.ZodBoolean>;
-    }, z.ZodUnion<[z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        components: string;
+        css: string;
+        separate: boolean;
+    }>;
+    utilities: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodObject<{
+        source: z.ZodString;
+        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full", "all"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full", "all"]>, "many">]>>;
         prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        stripDuplicates: z.ZodOptional<z.ZodBoolean>;
+        collection: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
+        source: string;
+        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all")[] | undefined;
         prefix?: string | undefined;
-        stripLevels?: number | undefined;
+        stripDuplicates?: boolean | undefined;
+        collection?: string | undefined;
     }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
+        source: string;
+        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all")[] | undefined;
         prefix?: string | undefined;
-        stripLevels?: number | undefined;
+        stripDuplicates?: boolean | undefined;
+        collection?: string | undefined;
     }>, z.ZodArray<z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        source: z.ZodString;
+        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full", "all"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full", "all"]>, "many">]>>;
         prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        stripDuplicates: z.ZodOptional<z.ZodBoolean>;
+        collection: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
+        source: string;
+        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all")[] | undefined;
         prefix?: string | undefined;
-        stripLevels?: number | undefined;
+        stripDuplicates?: boolean | undefined;
+        collection?: string | undefined;
     }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
+        source: string;
+        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all")[] | undefined;
         prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }>, "many">]>, "strip">>>;
-    components: z.ZodOptional<z.ZodObject<{
-        framework: z.ZodOptional<z.ZodEnum<["react", "astro"]>>;
-        installed: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, "strip", z.ZodTypeAny, {
-        framework?: "react" | "astro" | undefined;
-        installed?: string[] | undefined;
-    }, {
-        framework?: "react" | "astro" | undefined;
-        installed?: string[] | undefined;
-    }>>;
-    plugins: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        stripDuplicates?: boolean | undefined;
+        collection?: string | undefined;
+    }>, "many">]>>>;
 }, "strip", z.ZodTypeAny, {
-    tokens: {
+    output: {
+        components: string;
+        css: string;
+        separate: boolean;
+    };
+    transforms: {
+        fluid: {
+            min: number;
+            max: number;
+        };
+        colorFallbackStrategy: "native" | "polyfill";
+    };
+    tokens?: {
         source: string[];
         themes?: Record<string, string[]> | undefined;
     } | Record<string, {
         source: string[];
         themes?: Record<string, string[]> | undefined;
-    }>;
-    utilities?: z.objectOutputType<{
-        core: z.ZodOptional<z.ZodBoolean>;
-    }, z.ZodUnion<[z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }>, z.ZodArray<z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }>, "many">]>, "strip"> | undefined;
-    output?: {
-        tokens?: string | undefined;
-        css?: string | undefined;
-        components?: string | undefined;
-        separate?: boolean | undefined;
-    } | undefined;
-    transforms?: {
-        prefix?: string | undefined;
-        fluid?: {
+    }> | undefined;
+    utilities?: Record<string, {
+        source: string;
+        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all")[] | undefined;
+        prefix?: string | undefined;
+        stripDuplicates?: boolean | undefined;
+        collection?: string | undefined;
+    } | {
+        source: string;
+        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all")[] | undefined;
+        prefix?: string | undefined;
+        stripDuplicates?: boolean | undefined;
+        collection?: string | undefined;
+    }[]> | undefined;
+}, {
+    output: {
+        components: string;
+        css: string;
+        separate: boolean;
+    };
+    transforms: {
+        fluid: {
             min: number;
             max: number;
-        } | undefined;
-        colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | "hsla" | "oklch" | "p3" | undefined;
-    } | undefined;
-    components?: {
-        framework?: "react" | "astro" | undefined;
-        installed?: string[] | undefined;
-    } | undefined;
-    plugins?: string[] | undefined;
-}, {
-    tokens: {
+        };
+        colorFallbackStrategy: "native" | "polyfill";
+    };
+    tokens?: {
         source: string[];
         themes?: Record<string, string[]> | undefined;
     } | Record<string, {
         source: string[];
         themes?: Record<string, string[]> | undefined;
-    }>;
-    utilities?: z.objectInputType<{
-        core: z.ZodOptional<z.ZodBoolean>;
-    }, z.ZodUnion<[z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }>, z.ZodArray<z.ZodObject<{
-        typeMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<["color", "dimension", "fluidDimension", "duration", "cubicBezier", "fontFamily", "fontWeight", "number", "border", "shadow", "gradient", "transition", "strokeStyle"]>, z.ZodArray<z.ZodString, "many">>>;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full"]>, "many">]>>;
-        properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        prefix: z.ZodOptional<z.ZodString>;
-        stripLevels: z.ZodOptional<z.ZodNumber>;
-        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }, {
-        properties?: string[] | undefined;
-        custom?: Record<string, string> | undefined;
-        typeMap?: Partial<Record<"number" | "color" | "dimension" | "fluidDimension" | "duration" | "cubicBezier" | "fontFamily" | "fontWeight" | "border" | "shadow" | "gradient" | "transition" | "strokeStyle", string[]>> | undefined;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full")[] | undefined;
-        prefix?: string | undefined;
-        stripLevels?: number | undefined;
-    }>, "many">]>, "strip"> | undefined;
-    output?: {
-        tokens?: string | undefined;
-        css?: string | undefined;
-        components?: string | undefined;
-        separate?: boolean | undefined;
-    } | undefined;
-    transforms?: {
-        prefix?: string | undefined;
-        fluid?: {
-            min: number;
-            max: number;
-        } | undefined;
-        colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | "hsla" | "oklch" | "p3" | undefined;
-    } | undefined;
-    components?: {
-        framework?: "react" | "astro" | undefined;
-        installed?: string[] | undefined;
-    } | undefined;
-    plugins?: string[] | undefined;
+    }> | undefined;
+    utilities?: Record<string, {
+        source: string;
+        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all")[] | undefined;
+        prefix?: string | undefined;
+        stripDuplicates?: boolean | undefined;
+        collection?: string | undefined;
+    } | {
+        source: string;
+        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all")[] | undefined;
+        prefix?: string | undefined;
+        stripDuplicates?: boolean | undefined;
+        collection?: string | undefined;
+    }[]> | undefined;
 }>;
 
-export { type CSSFileOutput, DEFAULT_CONFIG, DEFAULT_DESIGN_TOKENS_PATH, DEFAULT_STYLES_PATH, DEFAULT_UTILITIES_FILENAME, DEFAULT_VARIABLES_FILENAME, GLOBAL_DIR, Instrumentation, type LoadConfigResult, type OutputConfig, type PipelineResult, type ResolvedToken, type ResolvedTokens, SUGARCUBE_CONFIG_FILE, SUGARCUBE_FILE, type SugarcubeConfig, TOKENS_FILE_SUFFIX, type TokenCollection, type TokenCollections, type TokenLoader, type TokenPipelineSource, type TokenTree, UTILITIES_DIR, type UserConfig, type UserOutputConfig, type UtilitiesConfig, type UtilityDefinition, VARIABLES_FILE_SUFFIX, configSchema, discoverAllFiles, generateCSSUtilityClasses, generateCSSVariables, generateIndex, generateIndexContent, getTokenPathsFromConfig, internalConfigSchema, loadConfig, normalizeConfig, parseAndValidateConfig, shouldRegenerateIndex, tokenProcessingPipeline, userConfigSchema, validateConfig, writeCSSUtilitiesToDisk, writeCSSVariablesToDisk };
+/**
+ * Type guards for configuration objects.
+ * Functions to check the structure and type of configuration data.
+ */
+/**
+ * Type guard to check if tokens is a single collection.
+ *
+ * @param tokens - The tokens configuration to check
+ * @returns True if tokens is a single collection, false if it's multiple collections
+ *
+ * @example
+ * if (isSingleCollection(config.tokens)) {
+ *   // config.tokens is TokenCollection
+ * } else {
+ *   // config.tokens is TokenCollections
+ * }
+ */
+declare function isSingleCollection(tokens: TokenCollection | TokenCollections): tokens is TokenCollection;
+
+declare function isResolvedToken(token: unknown): token is ResolvedToken;
+declare function isResolvedTokenOfType<T extends TokenType>(token: unknown, type: T): token is ResolvedToken<T>;
+
+export { type ArbitraryUtilityValue, type CSSFileOutput, type Candidate, DEFAULT_COLLECTION, DEFAULT_CONFIG, DEFAULT_DESIGN_TOKENS_PATH, DEFAULT_STYLES_PATH, DEFAULT_THEME, DEFAULT_UTILITIES_FILENAME, DEFAULT_VARIABLES_FILENAME, ErrorMessages, type FunctionalCandidate, type FunctionalVariant, GLOBAL_DIR, Instrumentation, type InternalConfig, type LoadedConfig, type NamedUtilityValue, type NormalizedConvertedTokens, type OutputConfig, type PipelineResult, type ResolvedToken, type ResolvedTokens, SUGARCUBE_CONFIG_FILE, SUGARCUBE_FILE, type StaticCandidate, type StaticUtilityPattern, type StaticVariant, type TokenCollection, type TokenCollections, type TokenLoader, type TokenPipelineSource, type TokenTree, UTILITIES_DIR, type UserConfig, type UserOutputConfig, type UtilitiesConfig, type UtilityValue, VARIABLES_FILE_SUFFIX, type Variant, configFileExists, convertConfigToUnoRules, discoverAllFiles, fillDefaults, findConfigFile, generateCSSVariables, generateIndex, generateIndexContent, internalConfigSchema, isResolvedToken, isResolvedTokenOfType, isSingleCollection, loadAndResolveTokens, loadInternalConfig, loadTSConfig, loadUserConfig, parseAndValidateConfig, processAndConvertTokens, shouldRegenerateIndex, userConfigSchema, validateConfig, validateInternalConfig, validateUserConfig, writeCSSUtilitiesToDisk, writeCSSVariablesToDisk };