@teacss/bun 0.4.6 → 0.5.0

package/README.md

@@ -1,26 +1,12 @@
 # @teacss/bun
 
-**Bun build plugin for TeaCSS.**
-
-## Purpose
-
-The plugin emits `virtual:teacss.css`, resolves CSS-entry configuration, and
-transforms TeaCSS CSS directives.
-
-Use this package when an application or build tool runs through `Bun.build`,
-including programmatic watch builds. It owns Bun's plugin and watcher
-lifecycles; use `@teacss/cli` for standalone CSS output, or the matching
-framework integration when another build system owns the module graph.
-
-Install the owning Bun adapter beside the `teacss` runtime:
+Bun Build integration for TeaCSS.
 
 ```sh
 bun add teacss
-bun add -d @teacss/bun
+bun add --dev @teacss/bun
 ```
 
-## Usage
-
 ```ts
 import { pluginTeacss } from "@teacss/bun";
 
@@ -31,20 +17,16 @@ await Bun.build({
 });
 ```
 
-`pluginTeacss()` is the one-shot `Bun.build` integration. Bun 1.3 does not
-expose watch-dependency registration or invalidation through its JavaScript
-plugin API. For a programmatic watch build, use `watchTeacssBuild`; it watches
-the Bun module graph together with the CSS entry, resolved config dependencies,
-and positive `@source` roots:
+Import `virtual:teacss.css` from the application. `pluginTeacss()` is for a
+one-shot build because Bun's plugin API does not expose watch invalidation.
+
+For programmatic watch builds, use `watchTeacssBuild`:
 
 ```ts
 import { watchTeacssBuild } from "@teacss/bun";
 
 const session = await watchTeacssBuild(
-  {
-    entrypoints: ["./src/index.ts"],
-    outdir: "./dist",
-  },
+  { entrypoints: ["./src/index.ts"], outdir: "./dist" },
   {
     configOrPath: "./index.css",
     onError: (error) => console.error(error),
@@ -54,45 +36,13 @@ const session = await watchTeacssBuild(
 await session.dispose();
 ```
 
-The session exposes the latest successful `result`, background `error`, and
-successful-build `version`. An initial build or config failure still returns an
-active session: `result` is `undefined`, `version` is `0`, and `error` contains
-the failure until a watched change succeeds. With `throw: false`, an
-unsuccessful Bun result likewise calls only `onError` and does not replace the
-last successful result, version, or module inputs.
-
-A successful config reload replaces stale watch roots; a failed reload keeps
-the last successful configuration active while watching the failed attempt's
-dependencies for recovery. Callback failures are logged without changing build
-state. Known watch roots are installed before each build, newly discovered
-module roots receive a stabilizing rebuild, and failed native watchers are
-replaced on the next attempt. Writes outside the tracked config, source, module,
-and entry inputs do not force stabilization. Concurrent `dispose()` calls share
-one completion and wait for all in-flight builds and callbacks. A callback may
-also `await session.dispose()` to stop its own session; that reentrant call
-cannot wait for the invoking callback itself, while disposal started outside a
-callback still waits for the callback to finish.
-
-`Bun.build` added JavaScript metafile support in Bun 1.3.6. On older supported
-Bun versions, the helper omits that option and continues watching entry,
-TeaCSS config, and `@source` roots, but it cannot discover additional
-module-graph inputs outside those roots.
-
-```ts
-import "virtual:teacss.css";
-```
-
-```css
-@preset "standard";
-@source "./src/**/*.{ts,tsx}";
-@teacss;
-```
-
-Default source discovery skips dependency and common build-output directories.
-Explicit `@source` globs remain authoritative and can include those directories.
+The session exposes the latest successful `result`, current `error`, and
+successful-build `version`. Failed rebuilds preserve the last valid result and
+continue watching configuration, module, entry, and positive `@source` roots.
+`dispose()` waits for active work and is safe to call more than once.
 
-## Status
+Bun versions before 1.3.6 cannot expose extra module-graph inputs through a
+metafile, so watch coverage is limited to entries, TeaCSS configuration, and
+`@source` roots.
 
-Pre-1.0. `@teacss/bun` is the owning Bun adapter. Applications import it
-directly from `@teacss/bun`. Source transformers such as `:css:` compile-class
-are not run here.
+Pre-1.0. Source compile-class transformers are not run by this adapter.

package/dist/index.d.ts

@@ -20,8 +20,8 @@ import { BuildConfig, BuildOutput, BunPlugin } from "bun";
  * Like `@teacss/rsbuild`, this path does not run source transformers (so the
  * `:css:` compile-class transform is not applied here).
  */
-declare function pluginTeacss(configOrPath?: UserConfig<object> | string, defaults?: UserConfigDefaults): BunPlugin;
-interface WatchTeacssBuildOptions {
+export declare function pluginTeacss(configOrPath?: UserConfig<object> | string, defaults?: UserConfigDefaults): BunPlugin;
+export interface WatchTeacssBuildOptions {
   /** CSS entry file, discovery root, or inline configuration. */
   configOrPath?: UserConfig<object> | string;
   /** Defaults merged below the resolved TeaCSS configuration. */
@@ -31,7 +31,7 @@ interface WatchTeacssBuildOptions {
   onBuild?: (result: BuildOutput) => void | Promise<void>;
   onError?: (error: unknown) => void | Promise<void>;
 }
-interface TeacssBuildWatchSession {
+export interface TeacssBuildWatchSession {
   /** Latest background rebuild error, cleared by the next successful build. */
   readonly error: unknown | undefined;
   /** Latest successful build result, or undefined until the first success. */
@@ -46,6 +46,5 @@ interface TeacssBuildWatchSession {
  * config and `@source` inputs change. Bun 1.3's plugin API has no dependency
  * registration or invalidation hook, so watch ownership lives in this helper.
  */
-declare function watchTeacssBuild(buildConfig: BuildConfig, options?: WatchTeacssBuildOptions): Promise<TeacssBuildWatchSession>;
-//#endregion
-export { TeacssBuildWatchSession, WatchTeacssBuildOptions, pluginTeacss, watchTeacssBuild };
+export declare function watchTeacssBuild(buildConfig: BuildConfig, options?: WatchTeacssBuildOptions): Promise<TeacssBuildWatchSession>;
+//#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teacss/bun",
-  "version": "0.4.6",
+  "version": "0.5.0",
   "description": "Bun plugin for TeaCSS — generate utilities and inline @apply via Bun.build.",
   "homepage": "https://css.teasim.com",
   "funding": "https://github.com/sponsors/billgo",
@@ -22,14 +22,14 @@
     "dev": "tsdown --watch"
   },
   "dependencies": {
-    "@teacss/core": "0.4.6",
-    "@teacss/directives": "0.4.6",
-    "@teacss/runtime": "0.4.6",
+    "@teacss/core": "0.5.0",
+    "@teacss/directives": "0.5.0",
+    "@teacss/runtime": "0.5.0",
     "tinyglobby": "^0.2.17"
   },
   "devDependencies": {
-    "@teacss/preset-standard": "0.4.6",
-    "bun-types": "^1.3.14",
+    "@teacss/preset-standard": "0.5.0",
+    "bun-types": "^1.4.1",
     "consola": "^3.4.2"
   },
   "engines": {