@teacss/postcss 0.4.6 → 0.5.0

package/README.md

@@ -1,40 +1,20 @@
 # @teacss/postcss
 
-**PostCSS integration for TeaCSS.**
+PostCSS 8 integration for TeaCSS.
 
-## Purpose
-
-The plugin runs TeaCSS during the PostCSS pipeline, transforms TeaCSS CSS
-directives, and injects generated utilities into the current stylesheet.
-
-Use this package when PostCSS is the application's CSS build boundary. It owns
-TeaCSS's PostCSS plugin behavior and reports file and directory dependencies to
-the surrounding runner; the runner remains responsible for file watching and
-rebuilds. Projects whose Vite, Astro, Rsbuild, or Bun integration already owns
-TeaCSS generation do not need to add this plugin as a second pipeline.
-
-PostCSS is a host peer rather than a bundled runtime. Install one compatible
-PostCSS 8 copy in the application:
-
-| Package manager | Install command |
-| --- | --- |
-| npm | `npm install teacss && npm install --save-dev @teacss/postcss postcss` |
-| pnpm | `pnpm add teacss && pnpm add --save-dev @teacss/postcss postcss` |
-| Yarn | `yarn add teacss && yarn add --dev @teacss/postcss postcss` |
-| Bun | `bun add teacss && bun add --dev @teacss/postcss postcss` |
-
-## Usage
+```sh
+npm install teacss
+npm install --save-dev @teacss/postcss postcss
+```
 
 ```js
 import { pluginTeacss } from "@teacss/postcss";
 
-export default {
-  plugins: [pluginTeacss()],
-};
+export default { plugins: [pluginTeacss()] };
 ```
 
-Runners that serialize the PostCSS configuration to workers (such as
-Next.js) load the plugin by package name through its default export:
+Runners that serialize configuration to workers, including Next.js, should use
+the package-name form:
 
 ```js
 export default {
@@ -47,23 +27,16 @@ export default {
 ```css
 @preset "standard";
 @source "./src/**/*.{ts,tsx,html}";
-@custom { --color-brand-500: #0f766e; }
 @teacss;
 ```
 
-Use `@teacss;` to choose where generated utilities are injected.
-When a stylesheet has multiple `@teacss` insertion points, each generated layer
-is emitted at most once across bare, `all`, explicit, and negated layer forms.
-Use `@custom {}` to define theme values in the CSS entry; PostCSS resolves
-`theme("...")` in declaration values but does not provide an `@theme` at-rule.
-The plugin reports both file dependencies and stable directory dependencies for
-positive `@source` globs, so PostCSS runners can rebuild when a new matching file
-is created. If a glob's static root does not exist yet, the directory dependency
-falls back to its nearest existing parent. Relative `@source` globs resolve from
-the CSS entry directory, including when the discovered entry is nested at
-`src/index.css`.
+`@teacss;` selects the insertion point. Each generated layer is emitted at
+most once even when the stylesheet has multiple insertion directives. The
+plugin resolves TeaCSS directives and `theme(...)`, reports file and stable
+directory dependencies, and resolves relative `@source` globs from the CSS
+entry.
 
-## Status
+The surrounding PostCSS runner owns watching and rebuilds. Do not add this
+plugin when another TeaCSS build adapter already owns generation.
 
-Pre-1.0. `@teacss/postcss` is the owning PostCSS adapter. Applications install
-it beside the `teacss` runtime and import it directly from `@teacss/postcss`.
+Pre-1.0. Install one compatible PostCSS 8 host.

package/dist/esm.d.mts

@@ -16,6 +16,5 @@ interface TeacssPostcssPluginOptions {
 }
 //#endregion
 //#region src/esm.d.ts
-declare function createPlugin(options: TeacssPostcssPluginOptions): (root: Root, result: Result) => Promise<void>;
-//#endregion
-export { createPlugin };
+export declare function createPlugin(options: TeacssPostcssPluginOptions): (root: Root, result: Result) => Promise<void>;
+//#endregion

package/dist/esm.mjs

@@ -45,7 +45,8 @@ async function parseApply(root, generator, directiveName) {
 	});
 	const resolvedRules = await Promise.all(rules.map(async (rule) => {
 		const group = readGroupApply(rule, directiveName);
-		const parsed = await resolveApplyTokens(splitClassTokens(expandVariantGroup(expandClassGroups(group ? group.body : rule.params))), generator);
+		const classNames = splitClassTokens(expandVariantGroup(expandClassGroups(group ? group.body : rule.params)));
+		const parsed = await resolveApplyTokens(classNames, generator);
 		const missing = missingApplyTokens(parsed);
 		if (missing.length) throw rule.error(formatMissingApplyTokens(missing));
 		return {
@@ -130,11 +131,12 @@ async function parseTheme(root, generator) {
 async function transformDeclarationValue(value, generator) {
 	const replacements = [];
 	const tasks = [];
-	walk(parse(value, {
+	const ast = parse(value, {
 		context: "value",
 		parseCustomProperty: true,
 		positions: true
-	}), function(node) {
+	});
+	walk(ast, function(node) {
 		if (node.type !== "Function" || node.name !== "theme" && node.name !== "icon" || !node.loc) return;
 		tasks.push(resolveCssFunction(generator, node, (start, end) => value.slice(start, end)).then((replacement) => {
 			if (replacement === void 0) return;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { Result, Root } from "postcss";
 import { UserConfig } from "@teacss/core";
 //#region src/types.d.ts
-interface TeacssPostcssPluginOptions {
+export interface TeacssPostcssPluginOptions {
   content?: (string | {
     raw: string;
     extension: string;
@@ -16,12 +16,12 @@ interface TeacssPostcssPluginOptions {
 }
 //#endregion
 //#region src/index.d.ts
-declare function pluginTeacss(options?: TeacssPostcssPluginOptions): {
+export declare function pluginTeacss(options?: TeacssPostcssPluginOptions): {
   postcssPlugin: string;
   plugins: ((root: Root, result: Result) => Promise<void>)[];
 };
-declare namespace pluginTeacss {
+export declare namespace pluginTeacss {
   var postcss: boolean;
 }
 //#endregion
-export { TeacssPostcssPluginOptions, pluginTeacss as default, pluginTeacss };
+export { pluginTeacss as default };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teacss/postcss",
-  "version": "0.4.6",
+  "version": "0.5.0",
   "description": "PostCSS plugin for TeaCSS — generate utilities within a PostCSS pipeline.",
   "homepage": "https://css.teasim.com",
   "funding": "https://github.com/sponsors/billgo",
@@ -23,19 +23,19 @@
     "dev": "tsdown --watch"
   },
   "dependencies": {
-    "@teacss/config": "0.4.6",
-    "@teacss/core": "0.4.6",
-    "@teacss/directives": "0.4.6",
-    "@teacss/rule-helpers": "0.4.6",
-    "@teacss/runtime": "0.4.6",
+    "@teacss/config": "0.5.0",
+    "@teacss/core": "0.5.0",
+    "@teacss/directives": "0.5.0",
+    "@teacss/rule-helpers": "0.5.0",
+    "@teacss/runtime": "0.5.0",
     "css-tree": "^3.2.1",
     "tinyglobby": "^0.2.17"
   },
   "devDependencies": {
-    "@teacss/preset-standard": "0.4.6",
-    "@types/css-tree": "^2.3.11",
+    "@teacss/preset-standard": "0.5.0",
+    "@types/css-tree": "^3.2.0",
     "consola": "^3.4.2",
-    "magic-string": "^1.1.0",
+    "magic-string": "^1.2.3",
     "postcss": "^8.5.22"
   },
   "peerDependencies": {