@barocss/kit 0.4.0 → 0.5.0

package/dist/index.d.ts

@@ -1,3 +1,6 @@
+/** Arbitrary property class `[prop:value]` (parser sets token.property). */
+export declare const arbitraryPropertyRegistration: UtilityRegistration;
+
 /**
  * AST cache management
  */
@@ -203,6 +206,12 @@ export declare type AstNode = {
       * default: true (full preflight)
       */
      preflight?: PreflightLevel;
+     /**
+      * Enable kit console diagnostics (off by default).
+      * This sets a process-wide flag (see setDebug): it affects every context, and a
+      * config without this key leaves the current flag unchanged.
+      */
+     debug?: boolean;
      /**
       * @deprecated Contexts now own their caches. Creating a context does not
       * clear caches that belong to another context.
@@ -248,6 +257,13 @@ export declare type AstNode = {
 
  export declare function escapeClassName(className: string): string;
 
+ /**
+  * Add Tailwind-style spacing inside calc()/min()/max()/clamp():
+  * `calc(100%-2rem)` -> `calc(100% - 2rem)`. Leaves nested non-math functions
+  * (var(--x-y)), unary signs and exponents (1e-3) alone.
+  */
+ export declare function expandThemeFunctions(value: string): string;
+
  declare type Function_2 = (...args: unknown[]) => unknown;
 
  export declare function functionalModifier(match: ModifierRegistration['match'], modifySelector: ModifierRegistration['modifySelector'], wrap?: ModifierRegistration['wrap'], options?: Partial<ModifierRegistration>, ctx?: Context): void;
@@ -536,6 +552,14 @@ export declare type AstNode = {
 
    export declare function getUtility(ctx?: Context): UtilityRegistration[];
 
+   /**
+    * #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;
+
    export declare type HasItems = {
        items?: AstNode[];
    };
@@ -763,6 +787,19 @@ export declare type AstNode = {
        getProcessedClasses(): string[];
    }
 
+   export declare function isDebug(): boolean;
+
+   /**
+    * #221: isSafeVariantValue for a whole variant token, except that has-[…]/not-[…] (optionally group-/peer-) may
+    * carry a comma at the top level of their bracket value: those variants wrap the value in `:has()`/`:not()`.
+    * The value itself must still be balanced and free of `{`, `}` and `;`, so it cannot close the pseudo-class.
+    */
+   export declare function isSafeVariantToken(value: string): boolean;
+
+   export declare function isSafeVariantValue(value: string, allowTopLevelComma?: boolean): boolean;
+
+   export declare function isStructureSafeValue(value: string): boolean;
+
    /**
     * Converts a single BaroJsonInput object into an AST tree.
     * Bypasses string parsing and directly invokes utility/modifier handlers.
@@ -812,6 +849,8 @@ export declare type AstNode = {
        source?: string;
    };
 
+   export declare function normalizeMathSpacing(value: string): string;
+
    /**
     * optimizeAst
     * Merges/organizes AST generated by parseClassToAst into an optimized AST tree based on decl-to-root path.
@@ -881,6 +920,8 @@ export declare type AstNode = {
         opacity?: string;
         priority?: number;
         important?: boolean;
+        /** Set for an arbitrary property class (`[prop:value]`); `value` holds the raw value. */
+        property?: string;
         [key: string]: unknown;
     }
 
@@ -926,13 +967,17 @@ export declare type AstNode = {
 
     export declare function resolveTheme(config: Config): Theme;
 
-    export declare function rootToCss(nodes: AstNode[]): string;
+    export declare function rootToCss(nodes: AstNode[], opts?: {
+        minify?: boolean;
+    }): string;
 
     export declare function rule(selector: string, nodes: AstNode[], source?: string): AstNode;
 
     /** Internal hook for caches owned by contexts. */
     export declare function setContextCacheReset(reset: () => void): void;
 
+    export declare function setDebug(enabled: boolean): void;
+
     /**
      * staticModifier: A helper that registers a modifier name and an array of CSS selectors directly to the registry
      *