@barocss/kit 0.6.0 → 0.8.0

package/dist/index.d.ts

@@ -219,6 +219,15 @@ export declare type AstNode = {
       * clear caches that belong to another context.
       */
      clearCacheOnContextChange?: boolean;
+     /**
+      * #287: static custom utilities, the runtime mirror of a stylesheet's static `@utility name { ... }`.
+      * Name → declarations (property → value; CSS custom properties allowed). Each one is registered on
+      * this context only; variants and `!` apply as usual. A name equal to a built-in extends it like
+      * `@utility` in Tailwind 4: the built-in declarations are emitted first, then the custom ones (a later
+      * duplicate property wins). An entry with an invalid name, property or value is skipped whole.
+      * @example utilities: { 'max-w-app': { 'max-width': '72rem', 'margin-inline': 'auto' } }
+      */
+     utilities?: CustomUtilities;
      [key: string]: unknown;
  }
 
@@ -237,6 +246,12 @@ export declare type AstNode = {
 
  export declare function createContext(configObj: Config): Context;
 
+ /** #287: static custom utilities by class name. */
+ export declare type CustomUtilities = Record<string, CustomUtilityDeclarations>;
+
+ /** #287: declarations of one static custom utility (property → value). */
+ export declare type CustomUtilityDeclarations = Record<string, string | number>;
+
  export declare function decl(prop: string, value: string | [string, string][], source?: string): AstNode;
 
  export declare type DeclPath = PathNode[];
@@ -845,6 +860,8 @@ export declare type AstNode = {
        sort?: number;
        description?: string;
        source?: string;
+       /** Static variant name; lets the parser tell `placeholder-shown:` (variant) from a `placeholder-*` utility (#307). */
+       name?: string;
    };
 
    export declare const modifierRegistry: ModifierRegistration[];