fix: tailwind variants generate without useUI hook

in file

Author: Austin1serb

.github/workflows/release.yml

@@ -1,7 +1,7 @@
 name: Release
 
 on:
-  workflow_dispatch:   # manual "Run workflow"
+  workflow_dispatch: # manual "Run workflow"
 
 permissions:
   contents: write
@@ -39,8 +39,8 @@ jobs:
         id: release
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
-          config-file: .release-please-config.json      # your config
-          manifest-file: .release-please-manifest.json  # version manifest
+          config-file: .release-please-config.json # your config
+          manifest-file: .release-please-manifest.json # version manifest
 
       # 4 ▸ Only continue if at least one package was released
       - uses: actions/setup-node@v4

AGENTS.md

@@ -7,7 +7,7 @@ Use these tips when working with the codebase or generating examples.
 
 ## How React Zero-UI works
 
-1. `useUI()` writes to `document.body.dataset` using keys you specify. 
+1. `useUI()` writes to `document.body.dataset` using keys you specify.
 
 ```tsx
 const [staleValue, setValue] = useUI<'open' | 'closed'>('sidebar', 'closed');
@@ -61,11 +61,13 @@ const [, setTheme] = useUI<'light' | 'dark'>('theme', 'light');
 ```tsx
 const [, setTheme] = useUI<'light' | 'dark'>('theme', 'light');
 // Simply pass a ref to the element
-<div ref={setTheme.ref} className="theme-light:bg-white theme-dark:bg-black" />
-
+<div
+	ref={setTheme.ref}
+	className="theme-light:bg-white theme-dark:bg-black"
+/>;
 ```
 
-Now the data-* will flip on that element, and the styles will be scoped to that element, or its children.
+Now the data-\* will flip on that element, and the styles will be scoped to that element, or its children.
 
 ---
 

docs/assets/internal.md

@@ -1,6 +1,6 @@
 # Internal docs
 
-Below is a **"mental model"** of the Zero‑UI variant extractor—distilled so that *another* human (or LLM) can reason about, extend, or safely refactor the code‑base.
+Below is a **"mental model"** of the Zero‑UI variant extractor—distilled so that _another_ human (or LLM) can reason about, extend, or safely refactor the code‑base.
 
 ---
 
@@ -13,13 +13,12 @@ Below is a **"mental model"** of the Zero‑UI variant extractor—distilled so
    ```
 
 2. **Resolve** (using §3) the `stateKey` and `initialValue` arguments **at build‑time.**
-
-   * `stateKey` must be a *local*, static string.
-   * `initialValue` follows the same rule.
+   - `stateKey` must be a _local_, static string.
+   - `initialValue` follows the same rule.
 
 3. **Globally scan all project files** for **variant tokens that match any discovered `stateKey`**—regardless of where hooks are declared. `(scanner.cts) → scanVariantTokens`
 
-   *Examples*
+   _Examples_
 
    ```html
    <!-- stateKey‑true:bg-black  →  value = "true" -->
@@ -45,9 +44,9 @@ source files ─►           ├─► Map<key,Set<value>>
 
    ```ts
    type VariantData = {
-     key: string;          // 'stateKey'
-     values: string[];     // ['light', 'dark', …]  (unique & sorted)
-     initialValue: string; // from 2nd arg of useUI()
+   	key: string; // 'stateKey'
+   	values: string[]; // ['light', 'dark', …]  (unique & sorted)
+   	initialValue: string; // from 2nd arg of useUI()
    };
    ```
 
@@ -66,18 +65,18 @@ source files ─►           ├─► Map<key,Set<value>>
 
 ## 2. Pipeline overview (AST + global token scan)
 
-| Stage | Scope & algorithm | Output |
-| --- | --- | --- |
-| **A - collectUseUIHooks** | Single AST traversal per file.<br>• Validate `useUI()` shapes.<br>• Resolve **stateKey** & **initialValue** with **`literalFromNode`** (§3).<br>• Builds global set of all state keys. | `HookMeta[]` = `{ stateKey, initialValue }[]`, global `Set<stateKey>` |
-| **B - global scanVariantTokens** | Single global regex scan pass over all files (same glob & delimiters Tailwind uses).<br>Matches tokens for **every stateKey discovered in Stage A**. | `Map<stateKey, Set<value>>` |
+| Stage                            | Scope & algorithm                                                                                                                                                                      | Output                                                                |
+| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
+| **A - collectUseUIHooks**        | Single AST traversal per file.<br>• Validate `useUI()` shapes.<br>• Resolve **stateKey** & **initialValue** with **`literalFromNode`** (§3).<br>• Builds global set of all state keys. | `HookMeta[]` = `{ stateKey, initialValue }[]`, global `Set<stateKey>` |
+| **B - global scanVariantTokens** | Single global regex scan pass over all files (same glob & delimiters Tailwind uses).<br>Matches tokens for **every stateKey discovered in Stage A**.                                   | `Map<stateKey, Set<value>>`                                           |
 
 The pipeline now ensures tokens are captured globally—regardless of hook declarations in each file.
 
 ---
 
 ## 3. The literal‑resolution micro‑framework
 
-Everything funnels through **`literalFromNode`**. Think of it as a deterministic *static evaluator* restricted to a very small grammar.
+Everything funnels through **`literalFromNode`**. Think of it as a deterministic _static evaluator_ restricted to a very small grammar.
 
 ### 3.1 Supported input forms (stateKey & initialValue)
 
@@ -112,11 +111,11 @@ Everything funnels through **`literalFromNode`**. Think of it as a deterministic
 
 ### 3.2 Resolvers
 
-| Helper | Purpose |
-| -- | -- |
-| **`resolveTemplateLiteral`** | Ensures every `${expr}` resolves via `literalFromNode`. |
-| **`resolveLocalConstIdentifier`** | Maps an `Identifier` → its `const` initializer *iff* initializer is a local static string/template. Imported bindings rejected explicitly. |
-| **`resolveMemberExpression`** | Static walk of `obj.prop`, `obj['prop']`, `obj?.prop`, arrays, numeric indexes, optional‑chaining… Throws if unresolved. |
+| Helper                            | Purpose                                                                                                                                    |
+| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
+| **`resolveTemplateLiteral`**      | Ensures every `${expr}` resolves via `literalFromNode`.                                                                                    |
+| **`resolveLocalConstIdentifier`** | Maps an `Identifier` → its `const` initializer _iff_ initializer is a local static string/template. Imported bindings rejected explicitly. |
+| **`resolveMemberExpression`**     | Static walk of `obj.prop`, `obj['prop']`, `obj?.prop`, arrays, numeric indexes, optional‑chaining… Throws if unresolved.                   |
 | **`literalFromNode`**             | Router calling above; memoised (`WeakMap`) per AST node.                                                                                   |
 
 Resolvers throw contextual errors via **`throwCodeFrame`** (`@babel/code-frame`).
@@ -125,27 +124,27 @@ Resolvers throw contextual errors via **`throwCodeFrame`** (`@babel/code-frame`)
 
 ## 4. Validation rules
 
-| Position in `useUI` | Allowed value | Example error |
-| --- | --- | --- |
-| **stateKey (arg 0)** | Local static string | `State key cannot be resolved at build‑time.` |
-| **initialValue (arg 1)** | Same rule as above. | `Initial value cannot be resolved …` |
+| Position in `useUI`      | Allowed value       | Example error                                 |
+| ------------------------ | ------------------- | --------------------------------------------- |
+| **stateKey (arg 0)**     | Local static string | `State key cannot be resolved at build‑time.` |
+| **initialValue (arg 1)** | Same rule as above. | `Initial value cannot be resolved …`          |
 
 Imported bindings must be re‑cast locally.
 
 ---
 
 ## 5. Performance notes
 
-* **Global LRU file‑cache** avoids re‑parsing unchanged files (`mtime:size`).
-* **Parallel parsing** (`os.cpus().length-1` concurrent tasks).
-* **Regex-based global token scanning** (fast Tailwind‑style parsing).
+- **Global LRU file‑cache** avoids re‑parsing unchanged files (`mtime:size`).
+- **Parallel parsing** (`os.cpus().length-1` concurrent tasks).
+- **Regex-based global token scanning** (fast Tailwind‑style parsing).
 
 ---
 
 ## 6. Unsupported cases
 
-* Runtime constructs (`import.meta`, dynamic imports).
-* Cross‑file constants.
-* Non‑string values (numbers, booleans).
-* Private class fields.
-* No analysis of setter functions (runtime-only).
+- Runtime constructs (`import.meta`, dynamic imports).
+- Cross‑file constants.
+- Non‑string values (numbers, booleans).
+- Private class fields.
+- No analysis of setter functions (runtime-only).

examples/demo/package.json

@@ -32,4 +32,4 @@
 		"tailwindcss": "^4.1.10",
 		"typescript": "^5"
 	}
-}
+}

examples/demo/src/app/globals.css

@@ -6,10 +6,10 @@
 		0px 2px 2px -1.5px rgba(0, 0, 0, 0.32), 0px 4.4px 4.4px -2.25px rgba(0, 0, 0, 0.3), 0px 9.8px 9.8px -3px rgba(0, 0, 0, 0.25),
 		0px 25px 25px -3.75px rgba(0, 0, 0, 0.11), 0px -5px 5px -3.75px rgba(0, 0, 0, 0.11);
 }
-div.relative.py-10{
-    padding: 0;
+div.relative.py-10 {
+	padding: 0;
 
-	.min-h-\[750px\]{
+	.min-h-\[750px\] {
 		min-height: auto;
 		margin: 80px auto;
 	}

package.json

@@ -45,4 +45,4 @@
 		"tsx": "^4.20.3",
 		"typescript": "^5.8.3"
 	}
-}
+}

packages/cli/package.json

@@ -21,4 +21,4 @@
 		"tailwindcss": "^4.0.0",
 		"@tailwindcss/postcss": "^4.1.8"
 	}
-}
+}