@teacss/bun 0.3.0

package/LICENSE

@@ -0,0 +1,22 @@
+# MIT License
+
+Copyright (c) 2021-PRESENT Anthony Fu <https://github.com/antfu>
+Copyright (c) 2026-PRESENT Billgo <hi@billgo.me>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,97 @@
+# @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.
+
+For an application using the stable facade import, install the adapter beside
+`teacss`:
+
+```sh
+bun add teacss
+bun add -d @teacss/bun
+```
+
+## Usage
+
+```ts
+import { pluginTeacss } from "teacss/bun";
+
+await Bun.build({
+  entrypoints: ["./src/index.ts"],
+  outdir: "./dist",
+  plugins: [pluginTeacss()],
+});
+```
+
+`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:
+
+```ts
+import { watchTeacssBuild } from "teacss/bun";
+
+const session = await watchTeacssBuild(
+  {
+    entrypoints: ["./src/index.ts"],
+    outdir: "./dist",
+  },
+  {
+    configOrPath: "./index.css",
+    onError: (error) => console.error(error),
+  },
+);
+
+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;
+```
+
+## Status
+
+Pre-1.0. Install `@teacss/bun` beside `teacss`, then use the stable
+`teacss/bun` facade subpath in applications. Source transformers such as
+`:css:` compile-class are not run here. Integration authors may import
+`@teacss/bun` directly when they intentionally do not use the facade.

package/dist/index.d.ts

@@ -0,0 +1,51 @@
+import { UserConfig, UserConfigDefaults } from "@teacss/core";
+import { BuildConfig, BuildOutput, BunPlugin } from "bun";
+//#region src/index.d.ts
+/**
+ * Bun plugin for TeaCSS. Use it with `Bun.build` (or a `bunfig.toml` preload):
+ *
+ * ```ts
+ * import { pluginTeacss } from "@teacss/bun";
+ * await Bun.build({ entrypoints: ["./src/index.ts"], plugins: [pluginTeacss()] });
+ * ```
+ *
+ * - `import "virtual:teacss.css"` (or `"teacss.css"`) resolves to the generated
+ *   utilities — scanned from the project's content (the CSS entry's `@source`,
+ *   else the default globs).
+ * - every `.css` gets `@apply` / `@screen` / `theme()` / `icon()` inlined (the
+ *   directive transformer fast-bails when none are present).
+ *
+ * Configuration comes from the CSS entry (`index.css` with `@preset` / `@source`
+ * / `@custom`) or an inline `UserConfig` — there is no `teacss.config.*` file.
+ * 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 {
+  /** CSS entry file, discovery root, or inline configuration. */
+  configOrPath?: UserConfig<object> | string;
+  /** Defaults merged below the resolved TeaCSS configuration. */
+  defaults?: UserConfigDefaults;
+  /** Filesystem event coalescing delay. @default 50 */
+  debounce?: number;
+  onBuild?: (result: BuildOutput) => void | Promise<void>;
+  onError?: (error: unknown) => void | Promise<void>;
+}
+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. */
+  readonly result: BuildOutput | undefined;
+  /** Number of successful builds. */
+  readonly version: number;
+  /** Stop this session without affecting other watch sessions. */
+  dispose(): Promise<void>;
+}
+/**
+ * Rebuild with Bun when either Bun's module graph or TeaCSS's graph-external
+ * 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 };

package/dist/index.js

@@ -0,0 +1 @@
+import{AsyncLocalStorage as e}from"node:async_hooks";import{existsSync as t,statSync as n,watch as r}from"node:fs";import{readFile as i,stat as a}from"node:fs/promises";import{dirname as o,isAbsolute as s,normalize as c,relative as l,resolve as u,sep as d}from"node:path";import f from"node:process";import p from"@teacss/directives";import{applyTransformerPipeline as m,createContext as h,defaultFilesystemGlobs as g}from"@teacss/runtime";import{DEFAULT_SOURCE_IGNORE as _,generateSources as v,readSourceFile as y}from"@teacss/runtime/source-generation";import{glob as b,isDynamicPattern as x}from"tinyglobby";function S(e,t){let n=l(e,t);return n===``||n!==`..`&&!n.startsWith(`..${d}`)&&!s(n)}function C(e){let t=Array.from(new Set(Array.from(e,c))).sort((e,t)=>e.length-t.length||e.localeCompare(t)),n=[];for(let e of t)n.some(t=>S(t,e))||n.push(e);return n}function ee(e,t){let n=t;for(;x(n);){let e=o(n);if(e===n)break;n=e}return u(e,n)}var te=class{createWatcher;onChange;onError;#e=!1;#t=new Map;constructor(e,t,n){this.createWatcher=e,this.onChange=t,this.onError=n}get roots(){return[...this.#t.keys()]}covers(e){for(let t of this.#t.keys())if(S(t,e))return!0;return!1}reconcile(e){if(this.#e)return;let t=C(e),n=new Set(t),r=new Map;try{for(let e of t){if(this.#t.has(e))continue;let t;try{t=this.createWatcher(e,(t,n)=>{this.onChange(n==null?void 0:u(e,n.toString()))});let n=t;t.on(`error`,t=>{this.#t.get(e)===n&&(this.#t.delete(e),this.closeWatcher(n)),this.onError(t)}),r.set(e,t)}catch(e){throw t&&this.closeWatcher(t),e}}}catch(e){for(let e of r.values())this.closeWatcher(e);throw e}if(this.#e){for(let e of r.values())this.closeWatcher(e);return}let i=new Map;for(let e of t){let t=this.#t.get(e)??r.get(e);t&&i.set(e,t)}let a=this.#t;this.#t=i;for(let[e,t]of a)n.has(e)||this.closeWatcher(t)}dispose(){if(this.#e)return;this.#e=!0;let e=this.#t;this.#t=new Map;for(let t of e.values())this.closeWatcher(t)}closeWatcher(e){try{e.close()}catch(e){this.onError(e)}}};function ne(e,t,n=Bun.version){let r={...e};return delete r.metafile,Bun.semver.satisfies(n,`>=1.3.6`)&&(r.metafile=!0),{...r,plugins:t}}const w=/^(?:virtual:)?teacss\.css$/,T=/\.css$/,E=`teacss`;function D(e,t={}){return{name:`teacss`,async setup(n){let r=h(e,{...t,transformers:[...t.transformers??[],p()]}),a=n.config.root??f.cwd();await r.updateRoot(a);let s=new Set,c=new Set,l=!0;function u(){let e=r.getConfigFileList()[0];return e?o(e):a}async function d(e){let t=e();s.add(t);try{return await t}finally{s.delete(t)}}n.onStart(async()=>{if(l){l=!1;return}await Promise.allSettled(s);for(let e of c)await r.extract(``,e);c.clear(),await r.reloadConfig()}),n.onResolve({filter:w},()=>({path:`teacss.css`,namespace:E})),n.onLoad({filter:/.*/,namespace:E},()=>d(async()=>{let e=await b((await r.getConfig()).content?.filesystem??g,{cwd:u(),absolute:!0,ignore:_}),t=e.map(y),{css:n}=await v(r.generator,e,t,{minify:!1});return{contents:n,loader:`css`}})),n.onLoad({filter:T},e=>d(async()=>{let t=await i(e.path,`utf8`);return c.add(e.path),{contents:(await m(r,t,e.path))?.code??t,loader:`css`}}))}}}function re(e){let r=e;for(n(r,{throwIfNoEntry:!1})?.isFile()&&(r=o(r));!t(r);){let e=o(r);if(e===r)break;r=e}return r}function ie(e){return`${e.mtimeMs}:${e.ctimeMs}:${e.size}:${e.ino}`}async function O(n,i={}){let c=u(n.root??f.cwd()),l=n.entrypoints.map(e=>s(e)?e:u(c,e)),{configOrPath:d,defaults:p={},debounce:m=50,onBuild:v,onError:y}=i,x=h(d,p),S=new Set,C=!1,w=!1,T,E,O=!1,k,A=!1,j=!1,M=0,N=!1,P=``,F=new Set,I,L,R=0,z=new Set,B=new e;function V(){let e=x.getConfigFileList()[0];return e?o(e):c}async function H(){return await b(x.generator.config.content?.filesystem??g,{cwd:V(),absolute:!0,ignore:_})}function ae(e){let t=e.content?.filesystem;if(!t)return e;let n=V();return{...e,content:{...e.content,filesystem:t.map(e=>e.startsWith(`!`)?`!${u(n,e.slice(1))}`:u(n,e))}}}function U(e,t,n){if(!t)return Promise.resolve();let r={active:!0},i;return i=B.run(r,()=>Promise.resolve().then(()=>t(n)).catch(t=>console.error(`[@teacss/bun] watch ${e} callback failed:`,t)).finally(()=>{r.active=!1,z.delete(i)})),z.add(i),i}async function oe(){for(;z.size>0;)await Promise.all(z)}function W(e){return w?Promise.resolve():(I=e,U(`error`,y,e))}function se(e,t=S){let n=new Set([...x.getConfigFileList(),...l,...t,...e]);if(typeof d!=`object`){let e=typeof d==`string`?u(c,d):c;n.add(e)}let r=V();for(let e of x.generator.config.content?.filesystem??g)e.startsWith(`!`)||n.add(ee(r,e));return n}function G(e,t=S){return new Set([...x.getConfigFileList(),...l,...t,...e])}async function K(e){let t=new Set(e.flatMap(e=>[...e])),n=new Map(await Promise.all([...t].map(async e=>{try{return[e,`${e}:${ie(await a(e))}`]}catch(t){if(t.code===`ENOENT`)return[e,`${e}:missing`];throw t}})));return e.map(e=>[...e].sort().map(e=>n.get(e)).join(`|`))}async function ce(e,t=S){return(await K([G(e,t)]))[0]}let q=new te((e,t)=>r(e,{recursive:!0},t),e=>{if(e!==void 0&&F.has(e)&&M++,!A){j=!0;return}$()},e=>{W(e),A?$():j=!0});function J(e,t=S){return F=G(e,t),q.reconcile(Array.from(se(e,t),re))}function Y(e,t,n){return AggregateError([e,t],n)}function X(e,n){return new Set(Object.keys(e.metafile?.inputs??{}).map(e=>s(e)?e:u(c,e)).filter(e=>!n||t(e)))}async function Z(e,t=S){if(w)return;let n=e,r=[];try{r=await H()}catch(e){n=Y(n,e,`TeaCSS build and source discovery failed`)}if(!w){try{J(r,t)}catch(e){n=Y(n,e,`TeaCSS build and watcher reconciliation failed`)}await W(n)}}async function le(){if(w)return;let e=M;if(C?await x.reloadConfig():(C=!0,await x.updateRoot(c)),w)return;let t=await H();if(w||(J(t),w))return;let r=await ce(t);if(w)return;let i=N;if(N=!1,!i&&R>0&&I===void 0&&r===P)return;let a=ae(await x.getConfig());if(w)return;let o=[...(n.plugins??[]).filter(e=>e.name!==`teacss`),D(a)],s=await Bun.build(ne(n,o));if(w)return;if(!s.success){await Z(s,new Set([...S,...X(s,!1)]));return}let l=X(s,!0),u=await H();if(w)return;let d=[...l].some(e=>!q.covers(e));if(J(u,l),w)return;let[f,p]=await K([G(u),G(u,l)]);if(w)return;let m=d||f!==r||M!==e;L=s,I=void 0,R++,S=l,P=p,await U(`build`,v,s),m&&(N=!0,A?O=!0:j=!0)}async function Q(){try{await le()}catch(e){await Z(e)}}async function ue(){do O=!1,await Q();while(O&&!w)}function $(){w||(E&&clearTimeout(E),E=setTimeout(()=>{E=void 0,O=!0,k||=ue().finally(()=>{k=void 0,O&&!w&&$()})},m))}function de(){w=!0,E&&clearTimeout(E),E=void 0,q.dispose()}return await Q(),A=!0,j&&$(),{get error(){return I},get result(){return L},get version(){return R},dispose(){return B.getStore()?.active?(de(),Promise.resolve()):(T??=(async()=>{de(),await k,await oe()})(),T)}}}export{D as pluginTeacss,O as watchTeacssBuild};

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@teacss/bun",
+  "version": "0.3.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",
+  "license": "MIT",
+  "author": "Billgo <hi@billgo.me>",
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.js",
+    "./package.json": "./package.json"
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "bunx tsdown --config tsdown.config.mts",
+    "dev": "tsdown --watch"
+  },
+  "dependencies": {
+    "@teacss/core": "0.3.0",
+    "@teacss/directives": "0.3.0",
+    "@teacss/runtime": "0.3.0",
+    "tinyglobby": "^0.2.17"
+  },
+  "devDependencies": {
+    "@teacss/preset-standard": "0.3.0",
+    "bun-types": "^1.3.14"
+  },
+  "engines": {
+    "bun": ">=1.1.0",
+    "node": ">=22.12.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}