@barocss/kit 0.10.3 → 0.11.0

package/dist/index.d.cts

@@ -385,6 +385,11 @@ export declare type AstNode = {
       * Whether to support opacity values
       */
      supportsOpacity?: boolean;
+     /**
+      * #393: the handlers apply the opacity modifier of an arbitrary / custom-property value themselves (shadow
+      * alpha); otherwise functionalUtility mixes the emitted colour, and emits nothing if there is no colour to mix.
+      */
+     ownsOpacity?: boolean;
      /**
       * The handler function that processes values
       *
@@ -1015,6 +1020,9 @@ export declare type AstNode = {
 
    export declare function registerUtility(util: UtilityRegistration, ctx?: Context): void;
 
+   /** #393: a handler result meaning "this class is invalid": the engine stops trying other registrations. */
+   export declare const REJECT_CLASS: AstNode[];
+
    export declare function resolveTheme(config: Config): Theme;
 
    export declare function rootToCss(nodes: AstNode[], opts?: {
@@ -1023,27 +1031,13 @@ export declare type AstNode = {
 
    export declare function rule(selector: string, nodes: AstNode[], source?: string): AstNode;
 
+   export declare type RuleKey = Array<number | string>;
+
    /**
-    * Tailwind-compatible cascade order for runtime-inserted rules (#254); shared by @barocss/server (#267).
-    *
-    * The runtime discovers classes in DOM order, so without sorting `lg:px-8`
-    * seen before `sm:px-6` would land earlier and lose at >= 1024px. Each rule
-    * gets a sort key derived from its leading `@media` / `@container` preludes:
-    *
-    *   0  base, negated media (`not-md:` → `@media not (…)`, as Tailwind 4.3.3 orders them, #352),
-    *      state media (hover), motion/contrast, unknown
-    *   1  max-* breakpoints        (larger width first)
-    *   2  min-* breakpoints        (smaller width first)
-    *   3  @max-* container queries (larger width first)
-    *   4  @min-* container queries (smaller width first)
-    *   5  orientation, dark (prefers-color-scheme), print, forced-colors
-    *
-    * Nested at-rules (e.g. `sm:dark:`) contribute one key pair per level, so
-    * `sm:` < `sm:dark:` < `md:`. Equal keys keep discovery order.
+    * Full sort key: the #254 variant pairs, then (#401) Tailwind's property sort and the class name.
+    * `candidate` defaults to the rule's first class.
     */
-   export declare type RuleKey = number[];
-
-   export declare function ruleSortKey(rule: string): RuleKey;
+   export declare function ruleSortKey(rule: string, candidate?: string): RuleKey;
 
    /** Internal hook for caches owned by contexts. */
    export declare function setContextCacheReset(reset: () => void): void;

package/dist/index.d.ts

@@ -385,6 +385,11 @@ export declare type AstNode = {
       * Whether to support opacity values
       */
      supportsOpacity?: boolean;
+     /**
+      * #393: the handlers apply the opacity modifier of an arbitrary / custom-property value themselves (shadow
+      * alpha); otherwise functionalUtility mixes the emitted colour, and emits nothing if there is no colour to mix.
+      */
+     ownsOpacity?: boolean;
      /**
       * The handler function that processes values
       *
@@ -1015,6 +1020,9 @@ export declare type AstNode = {
 
    export declare function registerUtility(util: UtilityRegistration, ctx?: Context): void;
 
+   /** #393: a handler result meaning "this class is invalid": the engine stops trying other registrations. */
+   export declare const REJECT_CLASS: AstNode[];
+
    export declare function resolveTheme(config: Config): Theme;
 
    export declare function rootToCss(nodes: AstNode[], opts?: {
@@ -1023,27 +1031,13 @@ export declare type AstNode = {
 
    export declare function rule(selector: string, nodes: AstNode[], source?: string): AstNode;
 
+   export declare type RuleKey = Array<number | string>;
+
    /**
-    * Tailwind-compatible cascade order for runtime-inserted rules (#254); shared by @barocss/server (#267).
-    *
-    * The runtime discovers classes in DOM order, so without sorting `lg:px-8`
-    * seen before `sm:px-6` would land earlier and lose at >= 1024px. Each rule
-    * gets a sort key derived from its leading `@media` / `@container` preludes:
-    *
-    *   0  base, negated media (`not-md:` → `@media not (…)`, as Tailwind 4.3.3 orders them, #352),
-    *      state media (hover), motion/contrast, unknown
-    *   1  max-* breakpoints        (larger width first)
-    *   2  min-* breakpoints        (smaller width first)
-    *   3  @max-* container queries (larger width first)
-    *   4  @min-* container queries (smaller width first)
-    *   5  orientation, dark (prefers-color-scheme), print, forced-colors
-    *
-    * Nested at-rules (e.g. `sm:dark:`) contribute one key pair per level, so
-    * `sm:` < `sm:dark:` < `md:`. Equal keys keep discovery order.
+    * Full sort key: the #254 variant pairs, then (#401) Tailwind's property sort and the class name.
+    * `candidate` defaults to the rule's first class.
     */
-   export declare type RuleKey = number[];
-
-   export declare function ruleSortKey(rule: string): RuleKey;
+   export declare function ruleSortKey(rule: string, candidate?: string): RuleKey;
 
    /** Internal hook for caches owned by contexts. */
    export declare function setContextCacheReset(reset: () => void): void;