@barocss/kit 0.8.0 → 0.8.2

package/dist/index.d.ts

@@ -568,14 +568,16 @@ 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;
 
+   /**
+    * #323: true when emitted text contains a markup end-tag opener (less-than then slash). Generated CSS can be
+    * placed inside an HTML style element, where that sequence could end the element early. CSS escapes in the
+    * output never form it, and a lone less-than (range media queries) stays allowed.
+    */
+   export declare function hasHtmlEndTagOpener(text: string): boolean;
+
    export declare type HasItems = {
        items?: AstNode[];
    };
@@ -810,6 +812,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;
 
    /**
@@ -823,6 +833,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.