@barocss/kit 0.8.1 → 0.9.0

package/dist/index.d.ts

@@ -289,7 +289,15 @@ export declare type AstNode = {
 
  export declare type FunctionalUtilityExtra = {
      opacity?: string;
+     /** The theme key that matched, set when it is a colour key (or the utility lists no `colors` namespace). */
      realThemeValue?: string;
+     /**
+      * #338: the theme namespace that resolved the key and the key itself. On a root shared by colours and another
+      * namespace (`border-*`: colors + borderWidth), a key from the other namespace leaves `realThemeValue` unset so the
+      * colour branch does not claim it; the handler dispatches on `themeNamespace` instead.
+      */
+     themeNamespace?: string;
+     themeKey?: string;
  };
 
  export declare type FunctionalUtilityOptions = {
@@ -568,11 +576,6 @@ export declare type AstNode = {
     */
    export declare function hasCommentDelimiter(text: string): boolean;
 
-   /**
-    * #224: true when a utility value (or a whole utility token) cannot change the structure of the declaration block it
-    * is pasted into. Rejects, outside quotes: `{`, `}`, `;`, unbalanced or mismatched ()/[], and a quote left open.
-    * Commas are allowed (values are not selector lists), so this is isSafeVariantValue with top-level commas allowed.
-    */
    /** #248: a comment opener or closer anywhere in a variant (quoted or not) could leave a comment unclosed in the output. */
    export declare function hasCommentToken(value: string): boolean;
 
@@ -817,6 +820,14 @@ export declare type AstNode = {
        getProcessedClasses(): string[];
    }
 
+   /**
+    * #332: true when an emitted selector or at-rule prelude has balanced, correctly nested `()`, `[]` and `{}` and
+    * no open quote. CSS escapes (backslash pairs) and quoted strings are skipped, so escaped brackets from a class
+    * name never count. Top-level commas are allowed (selector lists, `:is(a, b)`). Checked on the final composed
+    * string: an unbalanced prelude in concatenated CSS text would swallow the rules that follow it.
+    */
+   export declare function isBalancedPrelude(text: string): boolean;
+
    export declare function isDebug(): boolean;
 
    /**
@@ -830,6 +841,19 @@ export declare type AstNode = {
 
    export declare function isStructureSafeValue(value: string): boolean;
 
+   /**
+    * #224: true when a utility value (or a whole utility token) cannot change the structure of the declaration block it
+    * is pasted into. Rejects, outside quotes: `{`, `}`, `;`, unbalanced or mismatched ()/[], and a quote left open.
+    * Commas are allowed (values are not selector lists), so this is isSafeVariantValue with top-level commas allowed.
+    */
+   /**
+    * #332: a variant token's bracket groups must be well formed. An empty group (`[]`, as in an empty
+    * `has-[]`/`group-has-[]`/`[]` variant) has nothing to select and emits nothing. A token that opens with `[`
+    * is one arbitrary variant: its first group must close at the token's last character, so two adjacent groups
+    * are never read as a single variant whose inner text is unbalanced. CSS escapes and quoted strings are skipped.
+    */
+   export declare function isWellFormedVariantBrackets(value: string): boolean;
+
    /**
     * Converts a single BaroJsonInput object into an AST tree.
     * Bypasses string parsing and directly invokes utility/modifier handlers.
@@ -1120,6 +1144,12 @@ export declare type AstNode = {
      */
     export declare function themeGetter(themeObj: Theme, ...path: (string | number)[]): unknown;
 
+    /** #300: the literal value of `theme.<namespace>.<key>` when it is a string, else null. */
+    export declare function themeKeyValue(ctx: Context, namespace: string, key: string): string | null;
+
+    /** #300: `var(--<varPrefix>-<key>)` when `theme.<namespace>.<key>` exists (the :root var BaroCSS emits for it), else null. */
+    export declare function themeKeyVar(ctx: Context, namespace: string, key: string, varPrefix: string): string | null;
+
     export declare function themeToCssVars(theme: Theme): string;
 
     export declare interface Token {