@ttsc/unplugin 0.16.12 → 0.17.1

package/lib/bun-register.d.ts

@@ -0,0 +1,19 @@
+import type { TtscUnpluginOptions } from "./core/options";
+/**
+ * Register the ttsc transform as a Bun **runtime** plugin.
+ *
+ * The other `@ttsc/unplugin/*` adapters cover bundlers (`Bun.build`, Vite,
+ * Webpack, …). This entry is the runtime counterpart: loading it registers the
+ * same transform on Bun's module loader, so `bun run` / `bun test` apply ttsc
+ * plugins (e.g. typia's `typia/lib/transform`) as files are imported, with no
+ * bundling step. Wire it up once via a `bunfig.toml` preload entry —
+ * `preload = ["@ttsc/unplugin/bun-register"]` — or imperatively with
+ * `import "@ttsc/unplugin/bun-register"`. Options are read from the nearest
+ * `tsconfig.json`, identical to the bundler adapters.
+ *
+ * @throws When called explicitly off the Bun runtime (`globalThis.Bun.plugin`
+ *   is unavailable). The auto-registration below stays silent off Bun so the
+ *   module is harmless to import from Node (tests, tooling).
+ */
+export declare function register(options?: TtscUnpluginOptions): void;
+export default register;

package/lib/bun-register.js

@@ -0,0 +1,47 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var bun = require('./bun.js');
+
+/**
+ * Register the ttsc transform as a Bun **runtime** plugin.
+ *
+ * The other `@ttsc/unplugin/*` adapters cover bundlers (`Bun.build`, Vite,
+ * Webpack, …). This entry is the runtime counterpart: loading it registers the
+ * same transform on Bun's module loader, so `bun run` / `bun test` apply ttsc
+ * plugins (e.g. typia's `typia/lib/transform`) as files are imported, with no
+ * bundling step. Wire it up once via a `bunfig.toml` preload entry —
+ * `preload = ["@ttsc/unplugin/bun-register"]` — or imperatively with
+ * `import "@ttsc/unplugin/bun-register"`. Options are read from the nearest
+ * `tsconfig.json`, identical to the bundler adapters.
+ *
+ * @throws When called explicitly off the Bun runtime (`globalThis.Bun.plugin`
+ *   is unavailable). The auto-registration below stays silent off Bun so the
+ *   module is harmless to import from Node (tests, tooling).
+ */
+function register(options) {
+    const runtime = bunRuntime();
+    if (runtime === undefined) {
+        throw new Error("@ttsc/unplugin/bun-register must run under the Bun runtime " +
+            "(globalThis.Bun.plugin is unavailable). Use a bundler adapter such as " +
+            "@ttsc/unplugin/vite for non-Bun toolchains.");
+    }
+    runtime.plugin(bun.default(options));
+}
+function bunRuntime() {
+    const runtime = globalThis.Bun;
+    return runtime !== undefined && typeof runtime.plugin === "function"
+        ? runtime
+        : undefined;
+}
+// Auto-register on import so a `bunfig.toml` `preload` entry — which only
+// imports the module — takes effect. Guarded so importing from Node (a stray
+// import, or a unit test) is a harmless no-op rather than a throw.
+if (bunRuntime() !== undefined) {
+    register();
+}
+
+exports.default = register;
+exports.register = register;
+//# sourceMappingURL=bun-register.js.map

package/lib/bun-register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bun-register.js","sources":["../src/bun-register.ts"],"sourcesContent":[null],"names":["bun"],"mappings":";;;;;;AAcA;;;;;;;;;;;;;;;AAeG;AACG,SAAU,QAAQ,CAAC,OAA6B,EAAA;AACpD,IAAA,MAAM,OAAO,GAAG,UAAU,EAAE;AAC5B,IAAA,IAAI,OAAO,KAAK,SAAS,EAAE;QACzB,MAAM,IAAI,KAAK,CACb,6DAA6D;YAC3D,wEAAwE;AACxE,YAAA,6CAA6C,CAChD;IACH;IACA,OAAO,CAAC,MAAM,CAACA,WAAG,CAAC,OAAO,CAAC,CAAC;AAC9B;AAEA,SAAS,UAAU,GAAA;AACjB,IAAA,MAAM,OAAO,GAAI,UAAyC,CAAC,GAAG;IAC9D,OAAO,OAAO,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK;AACxD,UAAE;UACA,SAAS;AACf;AAEA;AACA;AACA;AACA,IAAI,UAAU,EAAE,KAAK,SAAS,EAAE;AAC9B,IAAA,QAAQ,EAAE;AACZ;;;;;"}

package/lib/bun-register.mjs

@@ -0,0 +1,42 @@
+import bun from './bun.mjs';
+
+/**
+ * Register the ttsc transform as a Bun **runtime** plugin.
+ *
+ * The other `@ttsc/unplugin/*` adapters cover bundlers (`Bun.build`, Vite,
+ * Webpack, …). This entry is the runtime counterpart: loading it registers the
+ * same transform on Bun's module loader, so `bun run` / `bun test` apply ttsc
+ * plugins (e.g. typia's `typia/lib/transform`) as files are imported, with no
+ * bundling step. Wire it up once via a `bunfig.toml` preload entry —
+ * `preload = ["@ttsc/unplugin/bun-register"]` — or imperatively with
+ * `import "@ttsc/unplugin/bun-register"`. Options are read from the nearest
+ * `tsconfig.json`, identical to the bundler adapters.
+ *
+ * @throws When called explicitly off the Bun runtime (`globalThis.Bun.plugin`
+ *   is unavailable). The auto-registration below stays silent off Bun so the
+ *   module is harmless to import from Node (tests, tooling).
+ */
+function register(options) {
+    const runtime = bunRuntime();
+    if (runtime === undefined) {
+        throw new Error("@ttsc/unplugin/bun-register must run under the Bun runtime " +
+            "(globalThis.Bun.plugin is unavailable). Use a bundler adapter such as " +
+            "@ttsc/unplugin/vite for non-Bun toolchains.");
+    }
+    runtime.plugin(bun(options));
+}
+function bunRuntime() {
+    const runtime = globalThis.Bun;
+    return runtime !== undefined && typeof runtime.plugin === "function"
+        ? runtime
+        : undefined;
+}
+// Auto-register on import so a `bunfig.toml` `preload` entry — which only
+// imports the module — takes effect. Guarded so importing from Node (a stray
+// import, or a unit test) is a harmless no-op rather than a throw.
+if (bunRuntime() !== undefined) {
+    register();
+}
+
+export { register as default, register };
+//# sourceMappingURL=bun-register.mjs.map

package/lib/bun-register.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bun-register.mjs","sources":["../src/bun-register.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAcA;;;;;;;;;;;;;;;AAeG;AACG,SAAU,QAAQ,CAAC,OAA6B,EAAA;AACpD,IAAA,MAAM,OAAO,GAAG,UAAU,EAAE;AAC5B,IAAA,IAAI,OAAO,KAAK,SAAS,EAAE;QACzB,MAAM,IAAI,KAAK,CACb,6DAA6D;YAC3D,wEAAwE;AACxE,YAAA,6CAA6C,CAChD;IACH;IACA,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC9B;AAEA,SAAS,UAAU,GAAA;AACjB,IAAA,MAAM,OAAO,GAAI,UAAyC,CAAC,GAAG;IAC9D,OAAO,OAAO,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK;AACxD,UAAE;UACA,SAAS;AACf;AAEA;AACA;AACA;AACA,IAAI,UAAU,EAAE,KAAK,SAAS,EAAE;AAC9B,IAAA,QAAQ,EAAE;AACZ;;;;"}

package/lib/bun.d.ts

@@ -12,6 +12,8 @@ export interface BunLikePlugin {
     /** Called by Bun when the plugin is registered. */
     setup(build: BunLikeBuild): void | Promise<void>;
 }
+/** Bun loader identifiers this adapter can emit (only TypeScript is matched). */
+export type BunLoader = "ts" | "tsx";
 /**
  * Minimal subset of the Bun `BuildConfig` plugin build object.
  *
@@ -23,7 +25,10 @@ export interface BunLikeBuild {
      * Register a loader callback for files matching `filter`.
      *
      * The callback receives the absolute file path and must return the
-     * transformed file contents.
+     * transformed file contents plus the `loader` Bun should apply next. The
+     * `loader` matters most for the runtime path (`Bun.plugin`), where Bun must
+     * be told the returned contents are still TypeScript so it keeps transpiling
+     * them before execution.
      */
     onLoad(options: {
         filter: RegExp;
@@ -31,15 +36,22 @@ export interface BunLikeBuild {
         path: string;
     }) => Promise<{
         contents: string;
+        loader: BunLoader;
     }>): void;
 }
 /**
- * Create a ttsc plugin for Bun's bundler.
+ * Create a ttsc plugin for Bun's bundler AND runtime.
  *
  * Bun does not implement the unplugin protocol, so this adapter instantiates
  * the raw unplugin transform and wires it to Bun's `onLoad` hook manually. The
  * adapter reads each matching file from disk and forwards the content to the
  * ttsc transform; if the transform returns no changes the original source is
  * passed through unchanged.
+ *
+ * The same object works for `Bun.build({ plugins: [ttsc()] })` (bundler) and
+ * for `Bun.plugin(ttsc())` / a `bunfig.toml` preload (runtime) — see
+ * `bun-register`. Every result carries an explicit `loader` so Bun keeps
+ * transpiling the emitted TypeScript at runtime; `sourceFilePattern` only
+ * matches TypeScript, so the loader is always `ts`/`tsx`.
  */
 export default function bun(options?: TtscUnpluginOptions): BunLikePlugin;

package/lib/bun.js

@@ -6,13 +6,19 @@ var fs = require('node:fs/promises');
 var index = require('./core/index.js');
 
 /**
- * Create a ttsc plugin for Bun's bundler.
+ * Create a ttsc plugin for Bun's bundler AND runtime.
  *
  * Bun does not implement the unplugin protocol, so this adapter instantiates
  * the raw unplugin transform and wires it to Bun's `onLoad` hook manually. The
  * adapter reads each matching file from disk and forwards the content to the
  * ttsc transform; if the transform returns no changes the original source is
  * passed through unchanged.
+ *
+ * The same object works for `Bun.build({ plugins: [ttsc()] })` (bundler) and
+ * for `Bun.plugin(ttsc())` / a `bunfig.toml` preload (runtime) — see
+ * `bun-register`. Every result carries an explicit `loader` so Bun keeps
+ * transpiling the emitted TypeScript at runtime; `sourceFilePattern` only
+ * matches TypeScript, so the loader is always `ts`/`tsx`.
  */
 function bun(options) {
     return {
@@ -20,25 +26,34 @@ function bun(options) {
         setup(build) {
             const raw = index.default.raw(options, {});
             build.onLoad({ filter: index.sourceFilePattern }, async (args) => {
+                const loader = bunLoaderFor(args.path);
                 const source = await fs.readFile(args.path, "utf8");
                 const result = typeof raw.transform === "function"
                     ? await raw.transform.call({}, source, args.path)
                     : undefined;
                 // Unpack both shorthand string and object result shapes.
                 if (typeof result === "string") {
-                    return { contents: result };
+                    return { contents: result, loader };
                 }
                 if (typeof result === "object" &&
                     result !== null &&
                     "code" in result &&
                     typeof result.code === "string") {
-                    return { contents: result.code };
+                    return { contents: result.code, loader };
                 }
-                return { contents: source };
+                return { contents: source, loader };
             });
         },
     };
 }
+/**
+ * Pick the Bun loader for a matched file. `sourceFilePattern` is
+ * `/\.[cm]?tsx?$/`, so a trailing `x` (`.tsx`/`.ctsx`/`.mtsx`) is JSX-flavored
+ * TypeScript and everything else (`.ts`/`.cts`/`.mts`) is plain TypeScript.
+ */
+function bunLoaderFor(filePath) {
+    return /x$/i.test(filePath) ? "tsx" : "ts";
+}
 
 exports.default = bun;
 //# sourceMappingURL=bun.js.map

package/lib/bun.js.map

@@ -1 +1 @@
-{"version":3,"file":"bun.js","sources":["../src/bun.ts"],"sourcesContent":[null],"names":["unplugin","sourceFilePattern"],"mappings":";;;;;;;AAwCA;;;;;;;;AAQG;AACW,SAAU,GAAG,CAAC,OAA6B,EAAA;IACvD,OAAO;AACL,QAAA,IAAI,EAAE,eAAe;AACrB,QAAA,KAAK,CAAC,KAAK,EAAA;YACT,MAAM,GAAG,GAAGA,aAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,EAAyB,CAAC;AAC5D,YAAA,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAEC,uBAAiB,EAAE,EAAE,OAAO,IAAI,KAAI;AACzD,gBAAA,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;AACnD,gBAAA,MAAM,MAAM,GACV,OAAO,GAAG,CAAC,SAAS,KAAK;AACvB,sBAAE,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAW,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI;sBACvD,SAAS;;AAEf,gBAAA,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;AAC9B,oBAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE;gBAC7B;gBACA,IACE,OAAO,MAAM,KAAK,QAAQ;AAC1B,oBAAA,MAAM,KAAK,IAAI;AACf,oBAAA,MAAM,IAAI,MAAM;AAChB,oBAAA,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAC/B;AACA,oBAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE;gBAClC;AACA,gBAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE;AAC7B,YAAA,CAAC,CAAC;QACJ,CAAC;KACF;AACH;;;;"}
+{"version":3,"file":"bun.js","sources":["../src/bun.ts"],"sourcesContent":[null],"names":["unplugin","sourceFilePattern"],"mappings":";;;;;;;AAgDA;;;;;;;;;;;;;;AAcG;AACW,SAAU,GAAG,CAAC,OAA6B,EAAA;IACvD,OAAO;AACL,QAAA,IAAI,EAAE,eAAe;AACrB,QAAA,KAAK,CAAC,KAAK,EAAA;YACT,MAAM,GAAG,GAAGA,aAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,EAAyB,CAAC;AAC5D,YAAA,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAEC,uBAAiB,EAAE,EAAE,OAAO,IAAI,KAAI;gBACzD,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;AACtC,gBAAA,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;AACnD,gBAAA,MAAM,MAAM,GACV,OAAO,GAAG,CAAC,SAAS,KAAK;AACvB,sBAAE,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAW,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI;sBACvD,SAAS;;AAEf,gBAAA,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;AAC9B,oBAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE;gBACrC;gBACA,IACE,OAAO,MAAM,KAAK,QAAQ;AAC1B,oBAAA,MAAM,KAAK,IAAI;AACf,oBAAA,MAAM,IAAI,MAAM;AAChB,oBAAA,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAC/B;oBACA,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE;gBAC1C;AACA,gBAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE;AACrC,YAAA,CAAC,CAAC;QACJ,CAAC;KACF;AACH;AAEA;;;;AAIG;AACH,SAAS,YAAY,CAAC,QAAgB,EAAA;AACpC,IAAA,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,KAAK,GAAG,IAAI;AAC5C;;;;"}

package/lib/bun.mjs

@@ -2,13 +2,19 @@ import fs from 'node:fs/promises';
 import unplugin, { sourceFilePattern } from './core/index.mjs';
 
 /**
- * Create a ttsc plugin for Bun's bundler.
+ * Create a ttsc plugin for Bun's bundler AND runtime.
  *
  * Bun does not implement the unplugin protocol, so this adapter instantiates
  * the raw unplugin transform and wires it to Bun's `onLoad` hook manually. The
  * adapter reads each matching file from disk and forwards the content to the
  * ttsc transform; if the transform returns no changes the original source is
  * passed through unchanged.
+ *
+ * The same object works for `Bun.build({ plugins: [ttsc()] })` (bundler) and
+ * for `Bun.plugin(ttsc())` / a `bunfig.toml` preload (runtime) — see
+ * `bun-register`. Every result carries an explicit `loader` so Bun keeps
+ * transpiling the emitted TypeScript at runtime; `sourceFilePattern` only
+ * matches TypeScript, so the loader is always `ts`/`tsx`.
  */
 function bun(options) {
     return {
@@ -16,25 +22,34 @@ function bun(options) {
         setup(build) {
             const raw = unplugin.raw(options, {});
             build.onLoad({ filter: sourceFilePattern }, async (args) => {
+                const loader = bunLoaderFor(args.path);
                 const source = await fs.readFile(args.path, "utf8");
                 const result = typeof raw.transform === "function"
                     ? await raw.transform.call({}, source, args.path)
                     : undefined;
                 // Unpack both shorthand string and object result shapes.
                 if (typeof result === "string") {
-                    return { contents: result };
+                    return { contents: result, loader };
                 }
                 if (typeof result === "object" &&
                     result !== null &&
                     "code" in result &&
                     typeof result.code === "string") {
-                    return { contents: result.code };
+                    return { contents: result.code, loader };
                 }
-                return { contents: source };
+                return { contents: source, loader };
             });
         },
     };
 }
+/**
+ * Pick the Bun loader for a matched file. `sourceFilePattern` is
+ * `/\.[cm]?tsx?$/`, so a trailing `x` (`.tsx`/`.ctsx`/`.mtsx`) is JSX-flavored
+ * TypeScript and everything else (`.ts`/`.cts`/`.mts`) is plain TypeScript.
+ */
+function bunLoaderFor(filePath) {
+    return /x$/i.test(filePath) ? "tsx" : "ts";
+}
 
 export { bun as default };
 //# sourceMappingURL=bun.mjs.map

package/lib/bun.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"bun.mjs","sources":["../src/bun.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAwCA;;;;;;;;AAQG;AACW,SAAU,GAAG,CAAC,OAA6B,EAAA;IACvD,OAAO;AACL,QAAA,IAAI,EAAE,eAAe;AACrB,QAAA,KAAK,CAAC,KAAK,EAAA;YACT,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,EAAyB,CAAC;AAC5D,YAAA,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,iBAAiB,EAAE,EAAE,OAAO,IAAI,KAAI;AACzD,gBAAA,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;AACnD,gBAAA,MAAM,MAAM,GACV,OAAO,GAAG,CAAC,SAAS,KAAK;AACvB,sBAAE,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAW,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI;sBACvD,SAAS;;AAEf,gBAAA,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;AAC9B,oBAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE;gBAC7B;gBACA,IACE,OAAO,MAAM,KAAK,QAAQ;AAC1B,oBAAA,MAAM,KAAK,IAAI;AACf,oBAAA,MAAM,IAAI,MAAM;AAChB,oBAAA,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAC/B;AACA,oBAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE;gBAClC;AACA,gBAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE;AAC7B,YAAA,CAAC,CAAC;QACJ,CAAC;KACF;AACH;;;;"}
+{"version":3,"file":"bun.mjs","sources":["../src/bun.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAgDA;;;;;;;;;;;;;;AAcG;AACW,SAAU,GAAG,CAAC,OAA6B,EAAA;IACvD,OAAO;AACL,QAAA,IAAI,EAAE,eAAe;AACrB,QAAA,KAAK,CAAC,KAAK,EAAA;YACT,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,EAAyB,CAAC;AAC5D,YAAA,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,iBAAiB,EAAE,EAAE,OAAO,IAAI,KAAI;gBACzD,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;AACtC,gBAAA,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;AACnD,gBAAA,MAAM,MAAM,GACV,OAAO,GAAG,CAAC,SAAS,KAAK;AACvB,sBAAE,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAW,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI;sBACvD,SAAS;;AAEf,gBAAA,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;AAC9B,oBAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE;gBACrC;gBACA,IACE,OAAO,MAAM,KAAK,QAAQ;AAC1B,oBAAA,MAAM,KAAK,IAAI;AACf,oBAAA,MAAM,IAAI,MAAM;AAChB,oBAAA,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAC/B;oBACA,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE;gBAC1C;AACA,gBAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE;AACrC,YAAA,CAAC,CAAC;QACJ,CAAC;KACF;AACH;AAEA;;;;AAIG;AACH,SAAS,YAAY,CAAC,QAAgB,EAAA;AACpC,IAAA,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,KAAK,GAAG,IAAI;AAC5C;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttsc/unplugin",
-  "version": "0.16.12",
+  "version": "0.17.1",
   "description": "Bundler adapters for ttsc plugins.",
   "main": "lib/index.js",
   "module": "lib/index.mjs",
@@ -21,6 +21,11 @@
       "import": "./lib/bun.mjs",
       "default": "./lib/bun.js"
     },
+    "./bun-register": {
+      "types": "./lib/bun-register.d.ts",
+      "import": "./lib/bun-register.mjs",
+      "default": "./lib/bun-register.js"
+    },
     "./esbuild": {
       "types": "./lib/esbuild.d.ts",
       "import": "./lib/esbuild.mjs",
@@ -102,7 +107,7 @@
     "tslib": "^2.8.1",
     "typescript": "7.0.1-rc",
     "vite": "^7.1.12",
-    "ttsc": "0.16.12"
+    "ttsc": "0.17.1"
   },
   "repository": {
     "type": "git",

package/src/bun-register.ts

@@ -0,0 +1,57 @@
+import bun, { type BunLikePlugin } from "./bun";
+import type { TtscUnpluginOptions } from "./core/options";
+
+/**
+ * Minimal shape of the Bun runtime global used to register a runtime plugin.
+ *
+ * Declared locally so the package needs no `bun-types` dependency; at runtime
+ * Bun exposes `Bun.plugin`, which accepts the same object the bundler adapter
+ * returns.
+ */
+interface BunRuntimeGlobal {
+  plugin(plugin: BunLikePlugin): void;
+}
+
+/**
+ * Register the ttsc transform as a Bun **runtime** plugin.
+ *
+ * The other `@ttsc/unplugin/*` adapters cover bundlers (`Bun.build`, Vite,
+ * Webpack, …). This entry is the runtime counterpart: loading it registers the
+ * same transform on Bun's module loader, so `bun run` / `bun test` apply ttsc
+ * plugins (e.g. typia's `typia/lib/transform`) as files are imported, with no
+ * bundling step. Wire it up once via a `bunfig.toml` preload entry —
+ * `preload = ["@ttsc/unplugin/bun-register"]` — or imperatively with
+ * `import "@ttsc/unplugin/bun-register"`. Options are read from the nearest
+ * `tsconfig.json`, identical to the bundler adapters.
+ *
+ * @throws When called explicitly off the Bun runtime (`globalThis.Bun.plugin`
+ *   is unavailable). The auto-registration below stays silent off Bun so the
+ *   module is harmless to import from Node (tests, tooling).
+ */
+export function register(options?: TtscUnpluginOptions): void {
+  const runtime = bunRuntime();
+  if (runtime === undefined) {
+    throw new Error(
+      "@ttsc/unplugin/bun-register must run under the Bun runtime " +
+        "(globalThis.Bun.plugin is unavailable). Use a bundler adapter such as " +
+        "@ttsc/unplugin/vite for non-Bun toolchains.",
+    );
+  }
+  runtime.plugin(bun(options));
+}
+
+function bunRuntime(): BunRuntimeGlobal | undefined {
+  const runtime = (globalThis as { Bun?: BunRuntimeGlobal }).Bun;
+  return runtime !== undefined && typeof runtime.plugin === "function"
+    ? runtime
+    : undefined;
+}
+
+// Auto-register on import so a `bunfig.toml` `preload` entry — which only
+// imports the module — takes effect. Guarded so importing from Node (a stray
+// import, or a unit test) is a harmless no-op rather than a throw.
+if (bunRuntime() !== undefined) {
+  register();
+}
+
+export default register;

package/src/bun.ts

@@ -19,6 +19,9 @@ export interface BunLikePlugin {
   setup(build: BunLikeBuild): void | Promise<void>;
 }
 
+/** Bun loader identifiers this adapter can emit (only TypeScript is matched). */
+export type BunLoader = "ts" | "tsx";
+
 /**
  * Minimal subset of the Bun `BuildConfig` plugin build object.
  *
@@ -30,22 +33,33 @@ export interface BunLikeBuild {
    * Register a loader callback for files matching `filter`.
    *
    * The callback receives the absolute file path and must return the
-   * transformed file contents.
+   * transformed file contents plus the `loader` Bun should apply next. The
+   * `loader` matters most for the runtime path (`Bun.plugin`), where Bun must
+   * be told the returned contents are still TypeScript so it keeps transpiling
+   * them before execution.
    */
   onLoad(
     options: { filter: RegExp },
-    loader: (args: { path: string }) => Promise<{ contents: string }>,
+    loader: (args: {
+      path: string;
+    }) => Promise<{ contents: string; loader: BunLoader }>,
   ): void;
 }
 
 /**
- * Create a ttsc plugin for Bun's bundler.
+ * Create a ttsc plugin for Bun's bundler AND runtime.
  *
  * Bun does not implement the unplugin protocol, so this adapter instantiates
  * the raw unplugin transform and wires it to Bun's `onLoad` hook manually. The
  * adapter reads each matching file from disk and forwards the content to the
  * ttsc transform; if the transform returns no changes the original source is
  * passed through unchanged.
+ *
+ * The same object works for `Bun.build({ plugins: [ttsc()] })` (bundler) and
+ * for `Bun.plugin(ttsc())` / a `bunfig.toml` preload (runtime) — see
+ * `bun-register`. Every result carries an explicit `loader` so Bun keeps
+ * transpiling the emitted TypeScript at runtime; `sourceFilePattern` only
+ * matches TypeScript, so the loader is always `ts`/`tsx`.
  */
 export default function bun(options?: TtscUnpluginOptions): BunLikePlugin {
   return {
@@ -53,6 +67,7 @@ export default function bun(options?: TtscUnpluginOptions): BunLikePlugin {
     setup(build) {
       const raw = unplugin.raw(options, {} as UnpluginContextMeta);
       build.onLoad({ filter: sourceFilePattern }, async (args) => {
+        const loader = bunLoaderFor(args.path);
         const source = await fs.readFile(args.path, "utf8");
         const result =
           typeof raw.transform === "function"
@@ -60,7 +75,7 @@ export default function bun(options?: TtscUnpluginOptions): BunLikePlugin {
             : undefined;
         // Unpack both shorthand string and object result shapes.
         if (typeof result === "string") {
-          return { contents: result };
+          return { contents: result, loader };
         }
         if (
           typeof result === "object" &&
@@ -68,10 +83,19 @@ export default function bun(options?: TtscUnpluginOptions): BunLikePlugin {
           "code" in result &&
           typeof result.code === "string"
         ) {
-          return { contents: result.code };
+          return { contents: result.code, loader };
         }
-        return { contents: source };
+        return { contents: source, loader };
       });
     },
   };
 }
+
+/**
+ * Pick the Bun loader for a matched file. `sourceFilePattern` is
+ * `/\.[cm]?tsx?$/`, so a trailing `x` (`.tsx`/`.ctsx`/`.mtsx`) is JSX-flavored
+ * TypeScript and everything else (`.ts`/`.cts`/`.mts`) is plain TypeScript.
+ */
+function bunLoaderFor(filePath: string): BunLoader {
+  return /x$/i.test(filePath) ? "tsx" : "ts";
+}