teacss 0.3.0 → 0.3.1

package/README.md

@@ -8,8 +8,7 @@ Readable utilities for humans. Predictable syntax for AI agents.
 
 `teacss` is the application-facing package. Its root entry provides the
 official `cn` and `recipe` runtime helpers plus Standard preset constant
-tables, while its subpaths expose the engine, official presets, and supported
-build integrations.
+tables, while its subpaths expose the engine and official presets.
 
 Use it for normal TeaCSS applications. Preset authors, custom integration
 authors, and tooling authors should import the narrower `@teacss/*` packages
@@ -17,18 +16,16 @@ that own those extension APIs; the root entry intentionally does not expose
 low-level factories such as `createDefiner`.
 
 The base installation contains the runtime class helpers, engine core, and
-official presets. Build integrations are opt-in peers so installing `teacss`
-does not also install unused Astro, Vite, Rsbuild, or PostCSS tooling. Install
-the matching `@teacss/*` integration package beside `teacss`; the stable
-`teacss/*` subpath then re-exports that package:
+official presets. Build integrations are separate packages, so install and
+import the one owned by the selected build boundary directly:
 
 | Build boundary | Additional installation | Import |
 | --- | --- | --- |
-| Vite | `bun add -d @teacss/vite vite` | `teacss/vite` |
-| Astro | `bun add -d @teacss/astro astro vite` | `teacss/astro` |
-| Rsbuild | `bun add -d @teacss/rsbuild @rsbuild/core` | `teacss/rsbuild` |
-| PostCSS | `bun add -d @teacss/postcss postcss` | `teacss/postcss` |
-| Bun Build | `bun add -d @teacss/bun` | `teacss/bun` |
+| Vite | `bun add -d @teacss/vite vite` | `@teacss/vite` |
+| Astro | `bun add -d @teacss/astro astro vite` | `@teacss/astro` |
+| Rsbuild | `bun add -d @teacss/rsbuild @rsbuild/core` | `@teacss/rsbuild` |
+| PostCSS | `bun add -d @teacss/postcss postcss` | `@teacss/postcss` |
+| Bun Build | `bun add -d @teacss/bun` | `@teacss/bun` |
 
 The standalone CLI is intentionally separate because `teacss` has no CLI
 subpath or executable:
@@ -69,7 +66,7 @@ bun add -d @teacss/vite vite
 Use the Vite integration:
 
 ```ts
-import { pluginTeacss } from "teacss/vite";
+import { pluginTeacss } from "@teacss/vite";
 
 export default {
   plugins: [pluginTeacss()],
@@ -151,7 +148,7 @@ The application entry exports `recipe`, bound once to its exact official
 import { recipe, type ClassProp, type VariantProps } from "teacss";
 
 const badge = recipe({
-  styles: "d:inline-flex align-items:center radius:full p-x:2",
+  className: "d:inline-flex align-items:center rd:full p-x:2",
   variants: {
     tone: {
       neutral: "bg-color:gray-100 text-color:gray-900",
@@ -178,15 +175,15 @@ function badgeClassName({ className, ...variants }: BadgeProps) {
 }
 ```
 
-A primitive string `styles` value selects the single-element form. Its variant
-choices and compound outputs are strings; the recipe call accepts variants plus
-`className` and returns the merged string directly.
+A primitive string top-level `className` value selects the single-element form.
+Its variant choices and compound outputs are strings; the recipe call accepts
+variants plus caller `className` and returns the merged string directly.
 
-Use a non-empty object `styles` value for multiple elements:
+Use a non-empty object top-level `className` value for multiple elements:
 
 ```ts
 const button = recipe({
-  styles: {
+  className: {
     container: "d:inline-flex align-items:center p:2 p:4@md",
     icon: "inline-size:4x",
   },
@@ -222,21 +219,21 @@ const button = recipe({
     },
     {
       disabled: true,
-      parts: ["container", "icon"],
+      classKeys: ["container", "icon"],
       className: "opacity:80",
     },
   ],
 });
 
-const styles = button({
+const classes = button({
   size: "large",
 });
 
-styles.container({
+classes.container({
   disabled: true,
   className: "p:6",
 });
-styles.icon();
+classes.icon();
 
 type ButtonProps = VariantProps<typeof button> & ClassProp;
 
@@ -245,14 +242,15 @@ function buttonClassName({ className, ...variants }: ButtonProps) {
 }
 ```
 
-There is no distinguished or required `root` key in object `styles`; every
-declared key is an ordinary style name. Variant choices are always target maps.
-A compound either supplies a non-empty `className` target map, or pairs a
-primitive-string `className` with a non-empty `parts` array to broadcast that
-class to several effective named styles. `parts` may name declared or inherited
-styles and must be dense, unique, and free of unknown names. The two compound
-forms are mutually exclusive, and matching entries contribute in declaration
-order. A recipe call returns a readonly resolver for every name.
+There is no distinguished or required `root` key in an object-form top-level
+`className`; every declared key is an ordinary named class. Variant choices are
+always target maps. A compound either supplies a non-empty `className` target
+map, or pairs a primitive-string `className` with a non-empty `classKeys` array
+to broadcast that class to several effective named classes. `classKeys` may
+name declared or inherited classes and must be dense, unique, and free of
+unknown names. The two compound forms are mutually exclusive, and matching
+entries contribute in declaration order. A recipe call returns a readonly
+resolver for every name.
 Recipe-level selections are captured once. A resolver selection is local to
 that invocation, compounds are re-evaluated for it, and `className` appends only
 to that resolver. The one-sided `"true"` choice makes `disabled`
@@ -261,10 +259,10 @@ fragment but can still drive defaults and compounds. Responsive behavior
 remains suffix-only inside static values, such as `p:4@md`; recipe props do not
 accept breakpoint objects.
 
-Every definition without `extend` requires its own `styles` field. An extending
-child may omit `styles` to inherit the parent's string or object mode, base
-fragments, and existing named styles. If a child declares `styles`, it must keep
-that mode; an object child may add new names:
+Every definition without `extend` requires its own `className` field. An
+extending child may omit `className` to inherit the parent's string or object
+mode, base fragments, and existing named classes. If a child declares
+`className`, it must keep that mode; an object child may add new names:
 
 ```ts
 const primaryButton = recipe({
@@ -280,13 +278,20 @@ const primaryButton = recipe({
 
 const strongBadge = recipe({
   extend: badge,
-  styles: "font-weight:700",
+  className: "font-weight:700",
 });
 ```
 
-`parts` is reserved as a variant name. Nested `compoundVariants[].parts` is
-supported; the superseded top-level definition field `parts` is not accepted
-as a compatibility alias.
+`classKeys` is reserved as a variant name, while `parts`, `styles`, and
+`styleKeys` are available as ordinary variant names. Nested
+`compoundVariants[].classKeys` is supported; the retired top-level definition
+field `styles` and former nested `parts` selector are not compatibility aliases.
+
+The repeated `className` spelling is separated by boundary:
+`definition.className` supplies base classes and selects string or object mode,
+`compoundVariants[].className` supplies a compound output, and caller
+`className` is accepted by a single-element recipe call or one named resolver.
+A multi-element recipe call itself accepts shared selections only.
 
 `@teacss/classes` exports the factory rather than a pre-bound definer. This
 integration creates its own `recipe` from the official `cn`; custom

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "teacss",
-  "version": "0.3.0",
-  "description": "The TeaCSS application entry with the official `cn`, `recipe`, engine, presets, and opt-in build integration subpaths.",
+  "version": "0.3.1",
+  "description": "The TeaCSS application entry with the official `cn`, `recipe`, engine, and preset subpaths.",
   "homepage": "https://css.teasim.com",
   "funding": "https://github.com/sponsors/billgo",
   "license": "MIT",
@@ -10,15 +10,10 @@
   "type": "module",
   "exports": {
     ".": "./dist/index.js",
-    "./astro": "./dist/astro.js",
-    "./bun": "./dist/bun.js",
     "./core": "./dist/core.js",
-    "./postcss": "./dist/postcss.js",
     "./preset-articles": "./dist/preset-articles.js",
     "./preset-icons": "./dist/preset-icons.js",
     "./preset-standard": "./dist/preset-standard.js",
-    "./rsbuild": "./dist/rsbuild.js",
-    "./vite": "./dist/vite.js",
     "./package.json": "./package.json"
   },
   "types": "./dist/index.d.ts",
@@ -31,35 +26,11 @@
     "dev": "tsdown --watch"
   },
   "dependencies": {
-    "@teacss/classes": "0.3.0",
-    "@teacss/core": "0.3.0",
-    "@teacss/preset-articles": "0.3.0",
-    "@teacss/preset-icons": "0.3.0",
-    "@teacss/preset-standard": "0.3.0"
-  },
-  "peerDependencies": {
-    "@teacss/astro": "0.3.0",
-    "@teacss/bun": "0.3.0",
-    "@teacss/postcss": "0.3.0",
-    "@teacss/rsbuild": "0.3.0",
-    "@teacss/vite": "0.3.0"
-  },
-  "peerDependenciesMeta": {
-    "@teacss/astro": {
-      "optional": true
-    },
-    "@teacss/bun": {
-      "optional": true
-    },
-    "@teacss/postcss": {
-      "optional": true
-    },
-    "@teacss/rsbuild": {
-      "optional": true
-    },
-    "@teacss/vite": {
-      "optional": true
-    }
+    "@teacss/classes": "0.3.1",
+    "@teacss/core": "0.3.1",
+    "@teacss/preset-articles": "0.3.1",
+    "@teacss/preset-icons": "0.3.1",
+    "@teacss/preset-standard": "0.3.1"
   },
   "engines": {
     "node": ">=22.12.0"

package/dist/astro.d.ts

@@ -1 +0,0 @@
-export * from "@teacss/astro";

package/dist/astro.js

@@ -1 +0,0 @@
-export*from"@teacss/astro";export{};

package/dist/bun.d.ts

@@ -1 +0,0 @@
-export * from "@teacss/bun";

package/dist/bun.js

@@ -1 +0,0 @@
-export*from"@teacss/bun";export{};

package/dist/postcss.d.ts

@@ -1 +0,0 @@
-export * from "@teacss/postcss";

package/dist/postcss.js

@@ -1 +0,0 @@
-export*from"@teacss/postcss";export{};

package/dist/rsbuild.d.ts

@@ -1 +0,0 @@
-export * from "@teacss/rsbuild";

package/dist/rsbuild.js

@@ -1 +0,0 @@
-export*from"@teacss/rsbuild";export{};

package/dist/vite.d.ts

@@ -1 +0,0 @@
-export * from "@teacss/vite";

package/dist/vite.js

@@ -1 +0,0 @@
-export*from"@teacss/vite";export{};