@cube-dev/ui-kit 0.121.4 → 0.121.6

package/docs/tasty/tasty-static.md

@@ -11,9 +11,30 @@
 - **Performance-critical pages** — Zero runtime overhead for styling
 - **Landing pages** — Minimal bundle size with pre-generated CSS
 
-## Quick Start
+## Requirements
+
+The zero-runtime mode is part of the main `@tenphi/tasty` package but requires additional peer dependencies depending on your setup:
+
+| Dependency | Version | Required for |
+|---|---|---|
+| `@babel/core` | >= 7.24 | Babel plugin (`@tenphi/tasty/babel-plugin`) |
+| `@babel/helper-plugin-utils` | >= 7.24 | Babel plugin |
+| `@babel/types` | >= 7.24 | Babel plugin |
+| `jiti` | >= 2.6 | Next.js wrapper (`@tenphi/tasty/next`) when using `configFile` option |
+
+All of these are declared as optional peer dependencies of `@tenphi/tasty`. Install only what your setup requires:
+
+```bash
+# For any Babel-based setup (Vite, custom Babel config, etc.)
+pnpm add -D @babel/core @babel/helper-plugin-utils @babel/types
+
+# For Next.js with TypeScript config file
+pnpm add -D @babel/core @babel/helper-plugin-utils @babel/types jiti
+```
+
+---
 
-The zero-runtime mode is part of the main `@tenphi/tasty` package. No additional packages required.
+## Quick Start
 
 ### Basic Usage
 
@@ -134,6 +155,9 @@ module.exports = {
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
 | `output` | `string` | `'tasty.css'` | Path for generated CSS file |
+| `configFile` | `string` | — | Absolute path to a TS/JS module that default-exports a `TastyZeroConfig` object. JSON-serializable alternative to `config` — required for Turbopack. |
+| `config` | `TastyZeroConfig \| () => TastyZeroConfig` | `{}` | Inline config object or factory function. Takes precedence over `configFile`. |
+| `configDeps` | `string[]` | `[]` | Absolute file paths that affect config (for cache invalidation) |
 | `config.states` | `Record<string, string>` | `{}` | Predefined state aliases |
 | `config.devMode` | `boolean` | `false` | Add source comments to CSS |
 | `config.recipes` | `Record<string, RecipeStyles>` | `{}` | Predefined style recipes |
@@ -176,23 +200,43 @@ const card = tastyStatic({
 
 ## Next.js Integration
 
-```javascript
-// next.config.js
-const { withTastyZero } = require('@tenphi/tasty/next');
+The `withTastyZero` wrapper configures both **webpack** and **Turbopack** automatically. No `--webpack` flag is needed — it works with whichever bundler Next.js uses.
+
+```typescript
+// next.config.ts
+import { withTastyZero } from '@tenphi/tasty/next';
 
-module.exports = withTastyZero({
+export default withTastyZero({
   output: 'public/tasty.css',
-  config: {
-    states: {
-      '@mobile': '@media(w < 768px)',
-    },
-    devMode: process.env.NODE_ENV === 'development',
-  },
+  configFile: './app/tasty-zero.config.ts',
+  configDeps: ['./app/theme.ts'],
 })({
   reactStrictMode: true,
 });
 ```
 
+### `withTastyZero` Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `output` | `string` | `'public/tasty.css'` | Output path for CSS relative to project root |
+| `enabled` | `boolean` | `true` | Enable/disable the plugin |
+| `configFile` | `string` | — | Path to a TS/JS module that default-exports `TastyZeroConfig`. Recommended for Turbopack compatibility. |
+| `config` | `TastyZeroConfig` | — | Inline config object. For static configs that don't change during dev. |
+| `configDeps` | `string[]` | `[]` | Extra files the config depends on (for cache invalidation) |
+
+### Turbopack Support
+
+Starting with Next.js 16, Turbopack is the default bundler. `withTastyZero` supports it out of the box by injecting `turbopack.rules` with `babel-loader` and JSON-serializable options.
+
+The `configFile` option is key for Turbopack — it passes a file path (JSON-serializable) instead of a function, and the Babel plugin loads the config internally via jiti.
+
+**Requirements**: `babel-loader` must be installed in your project:
+
+```bash
+pnpm add babel-loader
+```
+
 ### Including the CSS
 
 ```tsx
@@ -372,5 +416,6 @@ const card = tastyStatic({
 
 ## Related
 
-- [Usage Guide](usage.md) — Runtime styling: component creation, state mappings, sub-elements, variants, and hooks
+- [Style DSL](dsl.md) — State maps, tokens, units, extending semantics (shared by runtime and static)
+- [Runtime API](runtime.md) — Runtime styling: `tasty()` factory, component props, variants, sub-elements, hooks
 - [Configuration](configuration.md) — Global configuration: tokens, recipes, custom units, and style handlers

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cube-dev/ui-kit",
-  "version": "0.121.4",
+  "version": "0.121.6",
   "type": "module",
   "description": "UIKit for Cube Projects",
   "repository": {
@@ -45,7 +45,7 @@
     "@react-types/shared": "^3.32.1",
     "@tabler/icons-react": "^3.31.0",
     "@tanstack/react-virtual": "^3.13.12",
-    "@tenphi/tasty": "0.9.0",
+    "@tenphi/tasty": "0.13.0",
     "clipboard-copy": "^4.0.1",
     "clsx": "^1.1.1",
     "diff": "^8.0.3",
@@ -81,7 +81,6 @@
     "@size-limit/webpack-why": "^8.2.4",
     "@statoscope/cli": "^5.20.1",
     "@storybook/addon-docs": "^10.2.3",
-    "@storybook/addon-links": "^10.2.3",
     "@storybook/react-vite": "^10.2.3",
     "@tenphi/eslint-plugin-tasty": "^0.3.1",
     "@testing-library/dom": "^10.4.1",
@@ -99,8 +98,8 @@
     "@typescript-eslint/eslint-plugin": "^8.31.0",
     "@typescript-eslint/parser": "^8.31.0",
     "@uiw/react-codemirror": "^4.25.4",
-    "@vitejs/plugin-react": "^4.3.2",
-    "@vitest/coverage-v8": "^4.0.18",
+    "@vitejs/plugin-react": "^6.0.0",
+    "@vitest/coverage-v8": "^4.1.0",
     "best-effort-json-parser": "^1.2.1",
     "bytes": "^3.1.2",
     "chromatic": "^13.1.4",
@@ -129,12 +128,11 @@
     "serve-handler": "^6.1.6",
     "size-limit": "^8.2.6",
     "storybook": "^10.2.3",
-    "storybook-addon-turbo-build": "^2.0.1",
     "tsdown": "^0.20.3",
     "typescript": "^5.6.3",
     "typescript-eslint": "^8.31.0",
-    "vite": "^7.1.3",
-    "vitest": "^4.0.18"
+    "vite": "^8.0.0",
+    "vitest": "^4.1.0"
   },
   "browserslist": [
     "last 2 Chrome versions",
@@ -168,6 +166,7 @@
     "clear": "pnpm clear:dist && rimraf ./storybook-docs ./storybook-static ./node_modules/.cache",
     "clear:dist": "rimraf ./dist",
     "release": "pnpm build && changeset publish --provenance",
-    "add-icons": "cd src/icons && node add-new-icon.js && pnpm fix"
+    "add-icons": "cd src/icons && node add-new-icon.js && pnpm fix",
+    "audit-docs": "node scripts/audit-docs.mjs"
   }
 }