@barocss/kit 0.10.2 → 0.11.0

package/dist/index.d.cts

@@ -69,6 +69,8 @@ export declare type AstNode = {
  export declare function astToCss(ast: AstNode[], baseSelector?: string, opts?: {
      minify?: boolean;
      important?: boolean;
+     scope?: string;
+     nested?: boolean;
  }, _indent?: string): string;
 
  export declare function atRoot(nodes: AstNode[], source?: string): AstNode;
@@ -383,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
       *
@@ -823,6 +830,14 @@ export declare type AstNode = {
 
   export declare function isSafeVariantValue(value: string, allowTopLevelComma?: boolean): boolean;
 
+  /**
+   * #392: true when every top-level comma part of an emitted selector names `escapedClass` (a class selector
+   * already escaped with escapeClassName, including its leading dot) as a whole class token, or, when
+   * `allowNesting` is set, uses the nesting selector `&`. Escapes, quoted strings and bracket groups are skipped
+   * when splitting. Used as a defence-in-depth serializer check: a rule scoped to no generating class is dropped.
+   */
+  export declare function isScopedSelector(selector: string, escapedClass: string, allowNesting?: boolean): boolean;
+
   export declare function isStructureSafeValue(value: string): boolean;
 
   /**
@@ -1005,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?: {
@@ -1013,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

@@ -69,6 +69,8 @@ export declare type AstNode = {
  export declare function astToCss(ast: AstNode[], baseSelector?: string, opts?: {
      minify?: boolean;
      important?: boolean;
+     scope?: string;
+     nested?: boolean;
  }, _indent?: string): string;
 
  export declare function atRoot(nodes: AstNode[], source?: string): AstNode;
@@ -383,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
       *
@@ -823,6 +830,14 @@ export declare type AstNode = {
 
   export declare function isSafeVariantValue(value: string, allowTopLevelComma?: boolean): boolean;
 
+  /**
+   * #392: true when every top-level comma part of an emitted selector names `escapedClass` (a class selector
+   * already escaped with escapeClassName, including its leading dot) as a whole class token, or, when
+   * `allowNesting` is set, uses the nesting selector `&`. Escapes, quoted strings and bracket groups are skipped
+   * when splitting. Used as a defence-in-depth serializer check: a rule scoped to no generating class is dropped.
+   */
+  export declare function isScopedSelector(selector: string, escapedClass: string, allowNesting?: boolean): boolean;
+
   export declare function isStructureSafeValue(value: string): boolean;
 
   /**
@@ -1005,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?: {
@@ -1013,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;