teacss 0.9.4 → 0.10.2

package/README.md

@@ -1,119 +1,3 @@
-# TeaCSS
+# teacss
 
-The development tool package for TeaCSS.
-
-It provides the `teacss` command and four subpaths: the `teacss/cli`
-programmatic API, `teacss/core`, and the preset factories. The package has no
-root entry; `import "teacss"` fails. Runtime class helpers live in
-`@teacss/classes`.
-
-## Install
-
-Install `teacss` as a development dependency with the adapter and host for the
-project's build tool:
-
-| Build tool     | Development packages            |
-| -------------- | ------------------------------- |
-| Vite           | `@teacss/vite vite`             |
-| Astro          | `@teacss/astro astro vite`      |
-| Rsbuild        | `@teacss/rsbuild @rsbuild/core` |
-| PostCSS        | `@teacss/postcss postcss`       |
-| Bun Build      | `@teacss/bun`                   |
-| Standalone CLI | Included with `teacss`        |
-
-For example, `npm install --save-dev teacss @teacss/vite vite` sets up Vite.
-For standalone output, install only `teacss` and run its CLI:
-
-```sh
-npx teacss "src/**/*.{ts,tsx,html}" --preset standard -o tea.css
-```
-
-`--preset standard` enables utilities when the project has no CSS entry. Add
-`--watch` to rebuild as source files change, and include `tea.css` in the page.
-
-The programmatic `build` API is available from `teacss/cli`:
-
-```ts
-import { build } from "teacss/cli";
-```
-
-Example with Vite:
-
-```ts
-import { defineConfig } from "vite";
-import { pluginTeacss } from "@teacss/vite";
-
-export default defineConfig({ plugins: [pluginTeacss()] });
-```
-
-```css
-@presets "standard,icons,official";
-@source "./src/**/*.{ts,tsx,html}";
-@teacss;
-```
-
-```ts
-import "virtual:teacss.css";
-```
-
-## Presets
-
-Start with the recommended preset set. Remove any vocabulary the project does not
-use:
-
-```css
-@presets "standard,icons,official";
-```
-
-Official includes `article`, `article-hans` and `article-hant` for long-form content
-and does not enable Standard. Preset factories are available from subpaths:
-
-| Import                    | Export              |
-| ------------------------- | ------------------- |
-| `teacss/preset-standard` | `presetStandard`    |
-| `teacss/preset-official` | `presetOfficial`    |
-| `teacss/preset-icons`     | `presetIcons`       |
-| `teacss/core`             | Core engine exports |
-
-## Runtime classes
-
-Install `@teacss/classes` as an application dependency to compose class
-strings at runtime:
-
-```sh
-npm install @teacss/classes
-```
-
-```ts
-import { cn, recipe, type ClassProp, type VariantProps } from "@teacss/classes";
-
-cn("p:4 d:flex", "p:8"); // "d:flex p:8"
-
-const badge = recipe({
-  defaults: "d:inline-flex p:2",
-  variants: {
-    tone: { accent: "bg-color:blue-500 text-color:white" },
-  },
-});
-
-type BadgeProps = VariantProps<typeof badge> & ClassProp;
-```
-
-`cn` understands Standard conflicts and merges all `icon:value` declarations
-by prefix without validating values. `recipe` uses string or named-element
-`defaults` for base styles, `variants` for conditional styles, and
-`defaultVariants` for initial selections. It supports compounds and extension
-within the same loaded classes module.
-These functions and their `ClassDict`, `ClassValue`, `Merger`, `ClassProp`,
-`RecipeIntrospection`, `Reciper`, and `VariantProps` types are exported only by
-`@teacss/classes`.
-
-Custom merger hooks, injected recipe mergers, and preset-only merge entries are
-not supported. See the [migration guide](../../docs/guides/upgrading-to-0-6.md#2-classes-与-recipe)
-when upgrading an integration that used them.
-
-Standard constant tables come from `@teacss/preset-standard/constants`.
-
-Pre-1.0. Syntax, configuration, and APIs may change before the stable release.
-
-[MIT](LICENSE)
+`teacss` is the TeaCSS command-line binary, compiled from the Rust engine in this repository. Install it with `npm i -D teacss`, then run `teacss build` to write the CSS for a project once or `teacss watch` to rewrite it on every change (`teacss --help` lists the options). A class token that matches no rule but is close to one is reported on stderr as `teacss: warning: unmatched token "bgcolor:red" (did you mean "bg-color:red"?)`, once per token, and the exit code stays 0; `--unmatched error` turns these into one `E_UNMATCHED` error with exit code 1, and `--unmatched off` silences them. The package itself is a launcher: it runs the binary of the `@teacss/command-<platform>` package that npm installed for your platform, and when none matches it prints the eight supported platforms and the `cargo install` command that builds the binary from source.

package/bin/teacss.mjs

@@ -1,3 +1,53 @@
 #!/usr/bin/env node
+// Runs the `teacss` binary of the host's @teacss/command-<platform> package (v10.2 §4.2).
+import { spawnSync } from "node:child_process";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
 
-import "@teacss/cli/cli";
+/** npm platform suffix → Rust target, as packages/engine/scripts/targets.ts names them. */
+const SUPPORTED = [
+  ["darwin-arm64", "aarch64-apple-darwin"],
+  ["darwin-x64", "x86_64-apple-darwin"],
+  ["linux-arm64-gnu", "aarch64-unknown-linux-gnu"],
+  ["linux-arm64-musl", "aarch64-unknown-linux-musl"],
+  ["linux-x64-gnu", "x86_64-unknown-linux-gnu"],
+  ["linux-x64-musl", "x86_64-unknown-linux-musl"],
+  ["win32-arm64-msvc", "aarch64-pc-windows-msvc"],
+  ["win32-x64-msvc", "x86_64-pc-windows-msvc"],
+];
+
+const INSTALL_HINT = "cargo install --git https://github.com/teacss/teacss-rs teacss-command";
+
+/** `<os>-<cpu>[-<libc>]`; on Linux a glibc runtime version in the process report means gnu, its absence musl. */
+function hostSuffix() {
+  const { platform, arch } = process;
+  if (platform === "linux") {
+    const glibc = process.report?.getReport()?.header?.glibcVersionRuntime;
+    return `linux-${arch}-${glibc ? "gnu" : "musl"}`;
+  }
+  if (platform === "win32") return `win32-${arch}-msvc`;
+  return `${platform}-${arch}`;
+}
+
+function supportMatrix(suffix) {
+  const width = Math.max(...SUPPORTED.map(([name]) => name.length));
+  const rows = SUPPORTED.map(([name, triple]) => `  ${name.padEnd(width)}  ${triple}`);
+  return [`teacss: no prebuilt binary for ${suffix}: package @teacss/command-${suffix} is not installed.`, "Supported platforms (npm package suffix, Rust target):", ...rows, `Build it from source instead: ${INSTALL_HINT}`, ""].join("\n");
+}
+
+const suffix = hostSuffix();
+let packageDir;
+try {
+  packageDir = dirname(createRequire(import.meta.url).resolve(`@teacss/command-${suffix}/package.json`));
+} catch {
+  process.stderr.write(supportMatrix(suffix));
+  process.exit(1);
+}
+
+const binary = join(packageDir, process.platform === "win32" ? "teacss.exe" : "teacss");
+const result = spawnSync(binary, process.argv.slice(2), { stdio: "inherit" });
+if (result.error) {
+  process.stderr.write(`teacss: cannot run ${binary}: ${result.error.message}\n`);
+  process.exit(1);
+}
+process.exit(result.status ?? 1);

package/package.json

@@ -1,45 +1,40 @@
 {
   "name": "teacss",
-  "version": "0.9.4",
-  "description": "TeaCSS developer tooling with a CLI and engine and preset subpaths.",
-  "homepage": "https://css.teasim.com",
-  "funding": "https://github.com/sponsors/billgo",
+  "version": "0.10.2",
+  "description": "TeaCSS command-line binary (teacss build, teacss watch), compiled from the Rust engine",
   "license": "MIT",
-  "author": "Billgo <hi@billgo.me>",
-  "sideEffects": false,
   "type": "module",
-  "exports": {
-    "./cli": "./dist/cli.js",
-    "./core": "./dist/core.js",
-    "./preset-icons": "./dist/preset-icons.js",
-    "./preset-official": "./dist/preset-official.js",
-    "./preset-standard": "./dist/preset-standard.js",
-    "./package.json": "./package.json"
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/teacss/teacss-rs.git",
+    "directory": "packages/command"
   },
+  "homepage": "https://github.com/teacss/teacss-rs/tree/master/packages/command#readme",
   "bin": {
-    "teacss": "./bin/teacss.mjs"
+    "teacss": "bin/teacss.mjs"
   },
   "files": [
     "bin",
-    "dist",
-    "README.md"
+    "LICENSE"
   ],
-  "scripts": {
-    "build": "bunx rimraf dist && bunx tsdown --config tsdown.config.mts",
-    "dev": "tsdown --watch"
+  "engines": {
+    "node": ">=26"
   },
-  "dependencies": {
-    "@teacss/cli": "0.9.4",
-    "@teacss/core": "0.9.4",
-    "@teacss/engine": "0.9.4",
-    "@teacss/preset-icons": "0.9.4",
-    "@teacss/preset-official": "0.9.4",
-    "@teacss/preset-standard": "0.9.4"
+  "optionalDependencies": {
+    "@teacss/command-darwin-arm64": "0.10.2",
+    "@teacss/command-darwin-x64": "0.10.2",
+    "@teacss/command-linux-arm64-gnu": "0.10.2",
+    "@teacss/command-linux-arm64-musl": "0.10.2",
+    "@teacss/command-linux-x64-gnu": "0.10.2",
+    "@teacss/command-linux-x64-musl": "0.10.2",
+    "@teacss/command-win32-arm64-msvc": "0.10.2",
+    "@teacss/command-win32-x64-msvc": "0.10.2"
   },
-  "engines": {
-    "node": ">=22.12.0"
+  "scripts": {
+    "test": "node --test \"tests/**/*.test.mjs\""
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
   }
 }

package/dist/cli.d.ts

@@ -1,2 +0,0 @@
-import { CliOptions, CliWatchSession, build, checkProject, initializeConfig } from "@teacss/cli";
-export { type CliOptions, type CliWatchSession, build, checkProject, initializeConfig };

package/dist/cli.js

@@ -1 +0,0 @@
-import{build as e,checkProject as t,initializeConfig as n}from"@teacss/cli";export{e as build,t as checkProject,n as initializeConfig};

package/dist/core.d.ts

@@ -1,2 +0,0 @@
-import { Preset, Rule, UserConfig, Variant, createGenerator } from "@teacss/core";
-export { type Preset, type Rule, type UserConfig, type Variant, createGenerator };

package/dist/core.js

@@ -1 +0,0 @@
-import{createGenerator as e}from"@teacss/core";export{e as createGenerator};

package/dist/preset-icons.d.ts

@@ -1,3 +0,0 @@
-import preset_icons_default from "@teacss/preset-icons";
-export * from "@teacss/preset-icons";
-export { preset_icons_default as default };

package/dist/preset-icons.js

@@ -1 +0,0 @@
-import e from"@teacss/preset-icons";export*from"@teacss/preset-icons";export{e as default};

package/dist/preset-official.d.ts

@@ -1,3 +0,0 @@
-import preset_official_default from "@teacss/preset-official";
-export * from "@teacss/preset-official";
-export { preset_official_default as default };

package/dist/preset-official.js

@@ -1 +0,0 @@
-import e from"@teacss/preset-official";export*from"@teacss/preset-official";export{e as default};

package/dist/preset-standard.d.ts

@@ -1,3 +0,0 @@
-import preset_standard_default from "@teacss/preset-standard";
-export * from "@teacss/preset-standard";
-export { preset_standard_default as default };

package/dist/preset-standard.js

@@ -1 +0,0 @@
-import e from"@teacss/preset-standard";export*from"@teacss/preset-standard";export{e as default};