tailwindcss 4.0.0-alpha.23 → 4.0.0-alpha.25

package/dist/lib.d.mts

@@ -1,3 +1,6 @@
+import { U as UserConfig, P as Plugin } from './types-D_qOw1fc.mjs';
+import { V as Variant, C as Candidate } from './resolve-config-CaMNEFdQ.mjs';
+
 type Rule = {
     kind: 'rule';
     selector: string;
@@ -13,45 +16,54 @@ type Comment = {
     kind: 'comment';
     value: string;
 };
-type AstNode = Rule | Declaration | Comment;
+type Context = {
+    kind: 'context';
+    context: Record<string, string>;
+    nodes: AstNode[];
+};
+type AstNode = Rule | Declaration | Comment | Context;
 
+declare const enum ThemeOptions {
+    NONE = 0,
+    INLINE = 1,
+    REFERENCE = 2,
+    DEFAULT = 4
+}
 declare class Theme {
     #private;
     private values;
     constructor(values?: Map<string, {
         value: string;
-        isReference: boolean;
-        isInline: boolean;
-        isDefault: boolean;
+        options: number;
     }>);
-    add(key: string, value: string, { isReference, isInline, isDefault }?: {
-        isReference?: boolean | undefined;
-        isInline?: boolean | undefined;
-        isDefault?: boolean | undefined;
-    }): void;
+    add(key: string, value: string, options?: ThemeOptions): void;
     keysInNamespaces(themeKeys: ThemeKey[]): string[];
-    get(themeKeys: (ThemeKey | `${ThemeKey}-${string}`)[]): string | null;
+    get(themeKeys: ThemeKey[]): string | null;
     hasDefault(key: string): boolean;
+    getOptions(key: string): number;
     entries(): IterableIterator<[string, {
         value: string;
-        isReference: boolean;
-        isInline: boolean;
-        isDefault: boolean;
+        options: number;
     }]>;
     resolve(candidateValue: string | null, themeKeys: ThemeKey[]): string | null;
     resolveValue(candidateValue: string | null, themeKeys: ThemeKey[]): string | null;
     resolveWith(candidateValue: string, themeKeys: ThemeKey[], nestedKeys?: `--${string}`[]): [string, Record<string, string>] | null;
     namespace(namespace: string): Map<string | null, string>;
 }
-type ThemeKey = '--accent-color' | '--animate' | '--aspect-ratio' | '--backdrop-blur' | '--backdrop-brightness' | '--backdrop-contrast' | '--backdrop-grayscale' | '--backdrop-hue-rotate' | '--backdrop-invert' | '--backdrop-opacity' | '--backdrop-saturate' | '--backdrop-sepia' | '--background-color' | '--background-image' | '--blur' | '--border-color' | '--border-spacing' | '--border-width' | '--box-shadow-color' | '--breakpoint' | '--brightness' | '--caret-color' | '--color' | '--columns' | '--contrast' | '--cursor' | '--default-border-width' | '--default-ring-color' | '--default-ring-width' | '--default-transition-timing-function' | '--default-transition-duration' | '--divide-width' | '--divide-color' | '--drop-shadow' | '--fill' | '--flex-basis' | '--font-family' | '--font-size' | '--font-weight' | '--gap' | '--gradient-color-stop-positions' | '--grayscale' | '--grid-auto-columns' | '--grid-auto-rows' | '--grid-column' | '--grid-column-end' | '--grid-column-start' | '--grid-row' | '--grid-row-end' | '--grid-row-start' | '--grid-template-columns' | '--grid-template-rows' | '--height' | '--hue-rotate' | '--inset' | '--inset-shadow' | '--invert' | '--letter-spacing' | '--line-height' | '--line-clamp' | '--list-style-image' | '--list-style-type' | '--margin' | '--max-height' | '--max-width' | '--min-height' | '--min-width' | '--object-position' | '--opacity' | '--order' | '--outline-color' | '--outline-width' | '--outline-offset' | '--padding' | '--placeholder-color' | '--perspective' | '--perspective-origin' | '--radius' | '--ring-color' | '--ring-offset-color' | '--ring-offset-width' | '--ring-width' | '--rotate' | '--saturate' | '--scale' | '--scroll-margin' | '--scroll-padding' | '--sepia' | '--shadow' | '--size' | '--skew' | '--space' | '--spacing' | '--stroke' | '--stroke-width' | '--text-color' | '--text-decoration-color' | '--text-decoration-thickness' | '--text-indent' | '--text-underline-offset' | '--transform-origin' | '--transition-delay' | '--transition-duration' | '--transition-property' | '--transition-timing-function' | '--translate' | '--width' | '--z-index' | `--default-${string}`;
+type ThemeKey = `--${string}`;
 
 type VariantFn<T extends Variant['kind']> = (rule: Rule, variant: Extract<Variant, {
     kind: T;
 }>) => null | void;
 type CompareFn = (a: Variant, z: Variant) => number;
 declare class Variants {
-    private compareFns;
-    private variants;
+    compareFns: Map<number, CompareFn>;
+    variants: Map<string, {
+        kind: Variant["kind"];
+        order: number;
+        applyFn: VariantFn<any>;
+        compounds: boolean;
+    }>;
     private completions;
     /**
      * Registering a group of variants should result in the same sort number for
@@ -64,15 +76,18 @@ declare class Variants {
      * avoid unnecessarily skipping order numbers.
      */
     private lastOrder;
-    static(name: string, applyFn: VariantFn<'static'>, { compounds }?: {
+    static(name: string, applyFn: VariantFn<'static'>, { compounds, order }?: {
         compounds?: boolean;
+        order?: number;
     }): void;
     fromAst(name: string, ast: AstNode[]): void;
-    functional(name: string, applyFn: VariantFn<'functional'>, { compounds }?: {
+    functional(name: string, applyFn: VariantFn<'functional'>, { compounds, order }?: {
         compounds?: boolean;
+        order?: number;
     }): void;
-    compound(name: string, applyFn: VariantFn<'compound'>, { compounds }?: {
+    compound(name: string, applyFn: VariantFn<'compound'>, { compounds, order }?: {
         compounds?: boolean;
+        order?: number;
     }): void;
     group(fn: () => void, compareFn?: CompareFn): void;
     has(name: string): boolean;
@@ -151,278 +166,37 @@ type DesignSystem = {
     theme: Theme;
     utilities: Utilities;
     variants: Variants;
-    candidatesToCss(classes: string[]): (string | null)[];
     getClassOrder(classes: string[]): [string, bigint | null][];
     getClassList(): ClassEntry[];
     getVariants(): VariantEntry[];
     parseCandidate(candidate: string): Candidate[];
-    parseVariant(variant: string): ReturnType<typeof parseVariant>;
+    parseVariant(variant: string): Variant | null;
     compileAstNodes(candidate: Candidate): ReturnType<typeof compileAstNodes>;
-    getUsedVariants(): ReturnType<typeof parseVariant>[];
-};
-
-type ArbitraryUtilityValue = {
-    kind: 'arbitrary';
-    /**
-     * bg-[color:--my-color]
-     *     ^^^^^
-     */
-    dataType: string | null;
-    /**
-     * bg-[#0088cc]
-     *     ^^^^^^^
-     * bg-[--my_variable]
-     * var(^^^^^^^^^^^^^)
-     */
-    value: string;
-    /**
-     * bg-[--my_variable]
-     *     ^^^^^^^^^^^^^
-     */
-    dashedIdent: string | null;
-};
-type NamedUtilityValue = {
-    kind: 'named';
-    /**
-     * bg-red-500
-     *    ^^^^^^^
-     *
-     * w-1/2
-     *   ^
-     */
-    value: string;
-    /**
-     * w-1/2
-     *   ^^^
-     */
-    fraction: string | null;
-};
-type ArbitraryModifier = {
-    kind: 'arbitrary';
-    /**
-     * bg-red-500/[50%]
-     *             ^^^
-     */
-    value: string;
-    /**
-     * bg-red-500/[--my_variable]
-     *             ^^^^^^^^^^^^^
-     */
-    dashedIdent: string | null;
-};
-type NamedModifier = {
-    kind: 'named';
-    /**
-     * bg-red-500/50
-     *            ^^
-     */
-    value: string;
-};
-type ArbitraryVariantValue = {
-    kind: 'arbitrary';
-    value: string;
-};
-type NamedVariantValue = {
-    kind: 'named';
-    value: string;
-};
-type Variant = 
-/**
- * Arbitrary variants are variants that take a selector and generate a variant
- * on the fly.
- *
- * E.g.: `[&_p]`
- */
-{
-    kind: 'arbitrary';
-    selector: string;
-    compounds: boolean;
-    relative: boolean;
-}
-/**
- * Static variants are variants that don't take any arguments.
- *
- * E.g.: `hover`
- */
- | {
-    kind: 'static';
-    root: string;
-    compounds: boolean;
-}
-/**
- * Functional variants are variants that can take an argument. The argument is
- * either a named variant value or an arbitrary variant value.
- *
- * E.g.:
- *
- * - `aria-disabled`
- * - `aria-[disabled]`
- * - `@container-size`          -> @container, with named value `size`
- * - `@container-[inline-size]` -> @container, with arbitrary variant value `inline-size`
- * - `@container`               -> @container, with no value
- */
- | {
-    kind: 'functional';
-    root: string;
-    value: ArbitraryVariantValue | NamedVariantValue | null;
-    modifier: ArbitraryModifier | NamedModifier | null;
-    compounds: boolean;
-}
-/**
- * Compound variants are variants that take another variant as an argument.
- *
- * E.g.:
- *
- * - `has-[&_p]`
- * - `group-*`
- * - `peer-*`
- */
- | {
-    kind: 'compound';
-    root: string;
-    modifier: ArbitraryModifier | NamedModifier | null;
-    variant: Variant;
-    compounds: boolean;
-};
-type Candidate = 
-/**
- * Arbitrary candidates are candidates that register utilities on the fly with
- * a property and a value.
- *
- * E.g.:
- *
- * - `[color:red]`
- * - `[color:red]/50`
- * - `[color:red]/50!`
- */
-{
-    kind: 'arbitrary';
-    property: string;
-    value: string;
-    modifier: ArbitraryModifier | NamedModifier | null;
-    variants: Variant[];
-    important: boolean;
-    raw: string;
-}
-/**
- * Static candidates are candidates that don't take any arguments.
- *
- * E.g.:
- *
- * - `underline`
- * - `flex`
- */
- | {
-    kind: 'static';
-    root: string;
-    variants: Variant[];
-    negative: boolean;
-    important: boolean;
-    raw: string;
-}
-/**
- * Functional candidates are candidates that can take an argument.
- *
- * E.g.:
- *
- * - `bg-red-500`
- * - `bg-[#0088cc]`
- * - `w-1/2`
- */
- | {
-    kind: 'functional';
-    root: string;
-    value: ArbitraryUtilityValue | NamedUtilityValue | null;
-    modifier: ArbitraryModifier | NamedModifier | null;
-    variants: Variant[];
-    negative: boolean;
-    important: boolean;
-    raw: string;
-};
-declare function parseVariant(variant: string, designSystem: DesignSystem): Variant | null;
-
-interface PluginUtils {
-    theme(keypath: string, defaultValue?: any): any;
-}
-
-type PluginFn = (api: PluginAPI) => void;
-type PluginWithConfig = {
-    handler: PluginFn;
-    config?: UserConfig;
-};
-type PluginWithOptions<T> = {
-    (options?: T): PluginWithConfig;
-    __isOptionsFunction: true;
-};
-type Plugin = PluginFn | PluginWithConfig | PluginWithOptions<any>;
-type PluginAPI = {
-    addBase(base: CssInJs): void;
-    addVariant(name: string, variant: string | string[] | CssInJs): void;
-    addUtilities(utilities: Record<string, CssInJs | CssInJs[]> | Record<string, CssInJs | CssInJs[]>[], options?: {}): void;
-    matchUtilities(utilities: Record<string, (value: string, extra: {
-        modifier: string | null;
-    }) => CssInJs | CssInJs[]>, options?: Partial<{
-        type: string | string[];
-        supportsNegativeValues: boolean;
-        values: Record<string, string> & {
-            __BARE_VALUE__?: (value: NamedUtilityValue) => string | undefined;
-        };
-        modifiers: 'any' | Record<string, string>;
-    }>): void;
-    addComponents(utilities: Record<string, CssInJs> | Record<string, CssInJs>[], options?: {}): void;
-    matchComponents(utilities: Record<string, (value: string, extra: {
-        modifier: string | null;
-    }) => CssInJs>, options?: Partial<{
-        type: string | string[];
-        supportsNegativeValues: boolean;
-        values: Record<string, string> & {
-            __BARE_VALUE__?: (value: NamedUtilityValue) => string | undefined;
-        };
-        modifiers: 'any' | Record<string, string>;
-    }>): void;
-    theme(path: string, defaultValue?: any): any;
-    config(path: string, defaultValue?: any): any;
-    prefix(className: string): string;
-};
-type CssInJs = {
-    [key: string]: string | string[] | CssInJs | CssInJs[];
-};
-
-type ResolvableTo<T> = T | ((utils: PluginUtils) => T);
-type ThemeValue = ResolvableTo<Record<string, unknown>> | null | undefined;
-type ThemeConfig = Record<string, ThemeValue> & {
-    extend?: Record<string, ThemeValue>;
-};
-type ContentFile = string | {
-    raw: string;
-    extension?: string;
+    getVariantOrder(): Map<Variant, number>;
+    resolveThemeValue(path: string): string | undefined;
+    candidatesToCss(classes: string[]): (string | null)[];
 };
-type DarkModeStrategy = false | 'media' | 'class' | ['class', string] | 'selector' | ['selector', string] | ['variant', string | string[]];
-interface UserConfig {
-    presets?: UserConfig[];
-    theme?: ThemeConfig;
-    plugins?: Plugin[];
-}
-interface UserConfig {
-    content?: ContentFile[] | {
-        files: ContentFile[];
-    };
-}
-interface UserConfig {
-    darkMode?: DarkModeStrategy;
-}
 
+type Config = UserConfig;
 type CompileOptions = {
-    loadPlugin?: (path: string) => Promise<Plugin>;
-    loadConfig?: (path: string) => Promise<UserConfig>;
+    base?: string;
+    loadModule?: (id: string, base: string, resourceHint: 'plugin' | 'config') => Promise<{
+        module: Plugin | Config;
+        base: string;
+    }>;
+    loadStylesheet?: (id: string, base: string) => Promise<{
+        content: string;
+        base: string;
+    }>;
 };
 declare function compile(css: string, opts?: CompileOptions): Promise<{
     globs: {
-        origin?: string;
+        base: string;
         pattern: string;
     }[];
     build(candidates: string[]): string;
 }>;
 declare function __unstable__loadDesignSystem(css: string, opts?: CompileOptions): Promise<DesignSystem>;
+declare function postcssPluginWarning(): void;
 
-export { __unstable__loadDesignSystem, compile };
+export { type Config, __unstable__loadDesignSystem, compile, postcssPluginWarning as default };