@ttsc/unplugin 0.12.3 → 0.13.0

package/lib/api.d.ts

@@ -1 +1,8 @@
+/**
+ * Public API surface for `@ttsc/unplugin`.
+ *
+ * Re-exports everything from `core/index` so consumers can access the unified
+ * `unplugin` instance, the transform helpers, and the option types from the
+ * `@ttsc/unplugin/api` entry point without importing directly from `core/`.
+ */
 export * from "./core/index";

package/lib/api.js

@@ -6,6 +6,7 @@ var options = require('./core/options.js');
 
 
 
+exports.sourceFilePattern = index.sourceFilePattern;
 exports.unplugin = index.default;
 exports.createTtscTransformCache = transform.createTtscTransformCache;
 exports.transformTtsc = transform.transformTtsc;

package/lib/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;"}
+{"version":3,"file":"api.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;"}

package/lib/api.mjs

@@ -1,4 +1,4 @@
-export { default as unplugin } from './core/index.mjs';
+export { sourceFilePattern, default as unplugin } from './core/index.mjs';
 export { createTtscTransformCache, transformTtsc } from './core/transform.mjs';
 export { resolveOptions } from './core/options.mjs';
 //# sourceMappingURL=api.mjs.map

package/lib/bun.d.ts

@@ -1,9 +1,30 @@
 import type { TtscUnpluginOptions } from "./core/options";
+/**
+ * Minimal subset of the Bun plugin API consumed by this adapter.
+ *
+ * Bun does not yet ship TypeScript types for its bundler plugin interface, so
+ * we define the subset we need here. This keeps the adapter free of a Bun
+ * runtime dependency while remaining type-safe.
+ */
 export interface BunLikePlugin {
+    /** Plugin identifier shown in Bun bundler output. */
     name: string;
+    /** Called by Bun when the plugin is registered. */
     setup(build: BunLikeBuild): void | Promise<void>;
 }
+/**
+ * Minimal subset of the Bun `BuildConfig` plugin build object.
+ *
+ * Only the `onLoad` hook is used; other hooks are not needed for a
+ * source-to-source transform.
+ */
 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.
+     */
     onLoad(options: {
         filter: RegExp;
     }, loader: (args: {
@@ -12,4 +33,13 @@ export interface BunLikeBuild {
         contents: string;
     }>): void;
 }
+/**
+ * Create a ttsc plugin for Bun's bundler.
+ *
+ * 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.
+ */
 export default function bun(options?: TtscUnpluginOptions): BunLikePlugin;

package/lib/bun.js

@@ -5,17 +5,26 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var fs = require('node:fs/promises');
 var index = require('./core/index.js');
 
-const sourceFilePattern = /\.[cm]?tsx?$/;
+/**
+ * Create a ttsc plugin for Bun's bundler.
+ *
+ * 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.
+ */
 function bun(options) {
     return {
         name: "ttsc-unplugin",
         setup(build) {
             const raw = index.default.raw(options, {});
-            build.onLoad({ filter: sourceFilePattern }, async (args) => {
+            build.onLoad({ filter: index.sourceFilePattern }, async (args) => {
                 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 };
                 }

package/lib/bun.js.map

@@ -1 +1 @@
-{"version":3,"file":"bun.js","sources":["../src/bun.ts"],"sourcesContent":[null],"names":["unplugin"],"mappings":";;;;;;;AAkBA,MAAM,iBAAiB,GAAG,cAAc;AAE1B,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,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;AACf,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":";;;;;;;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;;;;"}

package/lib/bun.mjs

@@ -1,7 +1,15 @@
 import fs from 'node:fs/promises';
-import unplugin from './core/index.mjs';
+import unplugin, { sourceFilePattern } from './core/index.mjs';
 
-const sourceFilePattern = /\.[cm]?tsx?$/;
+/**
+ * Create a ttsc plugin for Bun's bundler.
+ *
+ * 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.
+ */
 function bun(options) {
     return {
         name: "ttsc-unplugin",
@@ -12,6 +20,7 @@ function bun(options) {
                 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 };
                 }

package/lib/bun.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"bun.mjs","sources":["../src/bun.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAkBA,MAAM,iBAAiB,GAAG,cAAc;AAE1B,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;AACf,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":";;;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;;;;"}

package/lib/core/index.d.ts

@@ -2,6 +2,12 @@ import type { UnpluginInstance } from "unplugin";
 import type { TtscUnpluginOptions } from "./options";
 import { resolveOptions } from "./options";
 import { createTtscTransformCache, transformTtsc } from "./transform";
+/**
+ * Matches any TypeScript or JavaScript source extension (.ts, .tsx, .mts, .cts,
+ * etc.). Shared with the Bun adapter (`bun.ts`) so the filter is defined once
+ * and both adapters stay in sync.
+ */
+export declare const sourceFilePattern: RegExp;
 declare const unplugin: UnpluginInstance<TtscUnpluginOptions | undefined, false>;
 export type { TtscUnpluginCompilerOptionsJson, TtscUnpluginOptions, } from "./options";
 export { createTtscTransformCache, resolveOptions, transformTtsc, unplugin };

package/lib/core/index.js

@@ -7,9 +7,29 @@ var options = require('./options.js');
 var transform = require('./transform.js');
 
 const name = "ttsc-unplugin";
+/**
+ * Matches any TypeScript or JavaScript source extension (.ts, .tsx, .mts, .cts,
+ * etc.). Shared with the Bun adapter (`bun.ts`) so the filter is defined once
+ * and both adapters stay in sync.
+ */
 const sourceFilePattern = /\.[cm]?tsx?$/;
+/** Matches any path segment that is a `node_modules` directory (cross-platform). */
 const nodeModulesPattern = /(?:^|[/\\])node_modules(?:[/\\]|$)/;
+/**
+ * Matches virtual module ids — Rollup/Vite use a leading NUL byte (`\0`) as
+ * convention.
+ */
 const virtualModulePattern = /\0/;
+/**
+ * Unplugin factory that wires the ttsc transform pipeline into any supported
+ * bundler (Vite, Rollup, Rolldown, webpack, Rspack, esbuild, Farm).
+ *
+ * The factory resolves raw options once, creates a per-build transform cache,
+ * and captures Vite alias configuration via the `vite.configResolved` hook so
+ * that path aliases are forwarded to the generated tsconfig overlay. The cache
+ * is cleared on every `buildStart` to avoid stale results across watch-mode
+ * rebuilds.
+ */
 const unpluginFactory = (rawOptions = {}) => {
     const options$1 = options.resolveOptions(rawOptions);
     const transformCache = transform.createTtscTransformCache();
@@ -39,6 +59,13 @@ const unpluginFactory = (rawOptions = {}) => {
     };
 };
 const unplugin = unplugin$1.createUnplugin(unpluginFactory);
+/**
+ * Returns `true` when the module id refers to a real TypeScript/JavaScript
+ * source file that should be processed by the ttsc transform.
+ *
+ * Excluded ids: virtual modules (NUL prefix), `.d.ts` declaration files, and
+ * anything inside `node_modules`.
+ */
 function isTransformTarget(id) {
     return (sourceFilePattern.test(id) &&
         !virtualModulePattern.test(id) &&
@@ -50,5 +77,6 @@ exports.resolveOptions = options.resolveOptions;
 exports.createTtscTransformCache = transform.createTtscTransformCache;
 exports.transformTtsc = transform.transformTtsc;
 exports.default = unplugin;
+exports.sourceFilePattern = sourceFilePattern;
 exports.unplugin = unplugin;
 //# sourceMappingURL=index.js.map

package/lib/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/core/index.ts"],"sourcesContent":[null],"names":["options","resolveOptions","createTtscTransformCache","stripQuery","transformTtsc","createUnplugin","isDeclarationFile"],"mappings":";;;;;;;;AAYA,MAAM,IAAI,GAAG,eAAe;AAC5B,MAAM,iBAAiB,GAAG,cAAc;AACxC,MAAM,kBAAkB,GAAG,oCAAoC;AAC/D,MAAM,oBAAoB,GAAG,IAAI;AAEjC,MAAM,eAAe,GAGjB,CAAC,UAAU,GAAG,EAAE,KAAI;AACtB,IAAA,MAAMA,SAAO,GAAGC,sBAAc,CAAC,UAAU,CAAC;AAC1C,IAAA,MAAM,cAAc,GAAGC,kCAAwB,EAAE;AACjD,IAAA,IAAI,OAAgB;IAEpB,OAAO;QACL,IAAI;AACJ,QAAA,OAAO,EAAE,KAAK;AAEd,QAAA,IAAI,EAAE;AACJ,YAAA,cAAc,CAAC,MAAM,EAAA;AACnB,gBAAA,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK;YAChC,CAAC;AACF,SAAA;QAED,UAAU,GAAA;YACR,cAAc,CAAC,KAAK,EAAE;QACxB,CAAC;AAED,QAAA,gBAAgB,CAAC,EAAE,EAAA;AACjB,YAAA,MAAM,IAAI,GAAGC,oBAAU,CAAC,EAAE,CAAC;AAC3B,YAAA,OAAO,iBAAiB,CAAC,IAAI,CAAC;QAChC,CAAC;AAED,QAAA,MAAM,SAAS,CAAC,MAAM,EAAE,EAAE,EAAA;AACxB,YAAA,MAAM,IAAI,GAAGA,oBAAU,CAAC,EAAE,CAAC;AAC3B,YAAA,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE;AAC5B,gBAAA,OAAO,SAAS;YAClB;AACA,YAAA,OAAOC,uBAAa,CAAC,IAAI,EAAE,MAAM,EAAEJ,SAAO,EAAE,OAAO,EAAE,cAAc,CAAC;QACtE,CAAC;KACF;AACH,CAAC;AAED,MAAM,QAAQ,GACZK,yBAAc,CAAC,eAAe;AAUhC,SAAS,iBAAiB,CAAC,EAAU,EAAA;AACnC,IAAA,QACE,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;AAC1B,QAAA,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,CAACC,2BAAiB,CAAC,EAAE,CAAC;AACtB,QAAA,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;AAEhC;;;;;;;;"}
+{"version":3,"file":"index.js","sources":["../../src/core/index.ts"],"sourcesContent":[null],"names":["options","resolveOptions","createTtscTransformCache","stripQuery","transformTtsc","createUnplugin","isDeclarationFile"],"mappings":";;;;;;;;AAYA,MAAM,IAAI,GAAG,eAAe;AAC5B;;;;AAIG;AACI,MAAM,iBAAiB,GAAG;AACjC;AACA,MAAM,kBAAkB,GAAG,oCAAoC;AAC/D;;;AAGG;AACH,MAAM,oBAAoB,GAAG,IAAI;AAEjC;;;;;;;;;AASG;AACH,MAAM,eAAe,GAGjB,CAAC,UAAU,GAAG,EAAE,KAAI;AACtB,IAAA,MAAMA,SAAO,GAAGC,sBAAc,CAAC,UAAU,CAAC;AAC1C,IAAA,MAAM,cAAc,GAAGC,kCAAwB,EAAE;AACjD,IAAA,IAAI,OAAgB;IAEpB,OAAO;QACL,IAAI;AACJ,QAAA,OAAO,EAAE,KAAK;AAEd,QAAA,IAAI,EAAE;AACJ,YAAA,cAAc,CAAC,MAAM,EAAA;AACnB,gBAAA,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK;YAChC,CAAC;AACF,SAAA;QAED,UAAU,GAAA;YACR,cAAc,CAAC,KAAK,EAAE;QACxB,CAAC;AAED,QAAA,gBAAgB,CAAC,EAAE,EAAA;AACjB,YAAA,MAAM,IAAI,GAAGC,oBAAU,CAAC,EAAE,CAAC;AAC3B,YAAA,OAAO,iBAAiB,CAAC,IAAI,CAAC;QAChC,CAAC;AAED,QAAA,MAAM,SAAS,CAAC,MAAM,EAAE,EAAE,EAAA;AACxB,YAAA,MAAM,IAAI,GAAGA,oBAAU,CAAC,EAAE,CAAC;AAC3B,YAAA,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE;AAC5B,gBAAA,OAAO,SAAS;YAClB;AACA,YAAA,OAAOC,uBAAa,CAAC,IAAI,EAAE,MAAM,EAAEJ,SAAO,EAAE,OAAO,EAAE,cAAc,CAAC;QACtE,CAAC;KACF;AACH,CAAC;AAED,MAAM,QAAQ,GACZK,yBAAc,CAAC,eAAe;AAUhC;;;;;;AAMG;AACH,SAAS,iBAAiB,CAAC,EAAU,EAAA;AACnC,IAAA,QACE,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;AAC1B,QAAA,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,CAACC,2BAAiB,CAAC,EAAE,CAAC;AACtB,QAAA,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;AAEhC;;;;;;;;;"}

package/lib/core/index.mjs

@@ -3,9 +3,29 @@ import { resolveOptions } from './options.mjs';
 import { stripQuery, transformTtsc, isDeclarationFile, createTtscTransformCache } from './transform.mjs';
 
 const name = "ttsc-unplugin";
+/**
+ * Matches any TypeScript or JavaScript source extension (.ts, .tsx, .mts, .cts,
+ * etc.). Shared with the Bun adapter (`bun.ts`) so the filter is defined once
+ * and both adapters stay in sync.
+ */
 const sourceFilePattern = /\.[cm]?tsx?$/;
+/** Matches any path segment that is a `node_modules` directory (cross-platform). */
 const nodeModulesPattern = /(?:^|[/\\])node_modules(?:[/\\]|$)/;
+/**
+ * Matches virtual module ids — Rollup/Vite use a leading NUL byte (`\0`) as
+ * convention.
+ */
 const virtualModulePattern = /\0/;
+/**
+ * Unplugin factory that wires the ttsc transform pipeline into any supported
+ * bundler (Vite, Rollup, Rolldown, webpack, Rspack, esbuild, Farm).
+ *
+ * The factory resolves raw options once, creates a per-build transform cache,
+ * and captures Vite alias configuration via the `vite.configResolved` hook so
+ * that path aliases are forwarded to the generated tsconfig overlay. The cache
+ * is cleared on every `buildStart` to avoid stale results across watch-mode
+ * rebuilds.
+ */
 const unpluginFactory = (rawOptions = {}) => {
     const options = resolveOptions(rawOptions);
     const transformCache = createTtscTransformCache();
@@ -35,6 +55,13 @@ const unpluginFactory = (rawOptions = {}) => {
     };
 };
 const unplugin = createUnplugin(unpluginFactory);
+/**
+ * Returns `true` when the module id refers to a real TypeScript/JavaScript
+ * source file that should be processed by the ttsc transform.
+ *
+ * Excluded ids: virtual modules (NUL prefix), `.d.ts` declaration files, and
+ * anything inside `node_modules`.
+ */
 function isTransformTarget(id) {
     return (sourceFilePattern.test(id) &&
         !virtualModulePattern.test(id) &&
@@ -42,5 +69,5 @@ function isTransformTarget(id) {
         !nodeModulesPattern.test(id));
 }
 
-export { createTtscTransformCache, unplugin as default, resolveOptions, transformTtsc, unplugin };
+export { createTtscTransformCache, unplugin as default, resolveOptions, sourceFilePattern, transformTtsc, unplugin };
 //# sourceMappingURL=index.mjs.map

package/lib/core/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../../src/core/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAYA,MAAM,IAAI,GAAG,eAAe;AAC5B,MAAM,iBAAiB,GAAG,cAAc;AACxC,MAAM,kBAAkB,GAAG,oCAAoC;AAC/D,MAAM,oBAAoB,GAAG,IAAI;AAEjC,MAAM,eAAe,GAGjB,CAAC,UAAU,GAAG,EAAE,KAAI;AACtB,IAAA,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC;AAC1C,IAAA,MAAM,cAAc,GAAG,wBAAwB,EAAE;AACjD,IAAA,IAAI,OAAgB;IAEpB,OAAO;QACL,IAAI;AACJ,QAAA,OAAO,EAAE,KAAK;AAEd,QAAA,IAAI,EAAE;AACJ,YAAA,cAAc,CAAC,MAAM,EAAA;AACnB,gBAAA,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK;YAChC,CAAC;AACF,SAAA;QAED,UAAU,GAAA;YACR,cAAc,CAAC,KAAK,EAAE;QACxB,CAAC;AAED,QAAA,gBAAgB,CAAC,EAAE,EAAA;AACjB,YAAA,MAAM,IAAI,GAAG,UAAU,CAAC,EAAE,CAAC;AAC3B,YAAA,OAAO,iBAAiB,CAAC,IAAI,CAAC;QAChC,CAAC;AAED,QAAA,MAAM,SAAS,CAAC,MAAM,EAAE,EAAE,EAAA;AACxB,YAAA,MAAM,IAAI,GAAG,UAAU,CAAC,EAAE,CAAC;AAC3B,YAAA,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE;AAC5B,gBAAA,OAAO,SAAS;YAClB;AACA,YAAA,OAAO,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,CAAC;QACtE,CAAC;KACF;AACH,CAAC;AAED,MAAM,QAAQ,GACZ,cAAc,CAAC,eAAe;AAUhC,SAAS,iBAAiB,CAAC,EAAU,EAAA;AACnC,IAAA,QACE,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;AAC1B,QAAA,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,CAAC,iBAAiB,CAAC,EAAE,CAAC;AACtB,QAAA,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;AAEhC;;;;"}
+{"version":3,"file":"index.mjs","sources":["../../src/core/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAYA,MAAM,IAAI,GAAG,eAAe;AAC5B;;;;AAIG;AACI,MAAM,iBAAiB,GAAG;AACjC;AACA,MAAM,kBAAkB,GAAG,oCAAoC;AAC/D;;;AAGG;AACH,MAAM,oBAAoB,GAAG,IAAI;AAEjC;;;;;;;;;AASG;AACH,MAAM,eAAe,GAGjB,CAAC,UAAU,GAAG,EAAE,KAAI;AACtB,IAAA,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC;AAC1C,IAAA,MAAM,cAAc,GAAG,wBAAwB,EAAE;AACjD,IAAA,IAAI,OAAgB;IAEpB,OAAO;QACL,IAAI;AACJ,QAAA,OAAO,EAAE,KAAK;AAEd,QAAA,IAAI,EAAE;AACJ,YAAA,cAAc,CAAC,MAAM,EAAA;AACnB,gBAAA,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK;YAChC,CAAC;AACF,SAAA;QAED,UAAU,GAAA;YACR,cAAc,CAAC,KAAK,EAAE;QACxB,CAAC;AAED,QAAA,gBAAgB,CAAC,EAAE,EAAA;AACjB,YAAA,MAAM,IAAI,GAAG,UAAU,CAAC,EAAE,CAAC;AAC3B,YAAA,OAAO,iBAAiB,CAAC,IAAI,CAAC;QAChC,CAAC;AAED,QAAA,MAAM,SAAS,CAAC,MAAM,EAAE,EAAE,EAAA;AACxB,YAAA,MAAM,IAAI,GAAG,UAAU,CAAC,EAAE,CAAC;AAC3B,YAAA,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE;AAC5B,gBAAA,OAAO,SAAS;YAClB;AACA,YAAA,OAAO,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,CAAC;QACtE,CAAC;KACF;AACH,CAAC;AAED,MAAM,QAAQ,GACZ,cAAc,CAAC,eAAe;AAUhC;;;;;;AAMG;AACH,SAAS,iBAAiB,CAAC,EAAU,EAAA;AACnC,IAAA,QACE,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;AAC1B,QAAA,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,CAAC,iBAAiB,CAAC,EAAE,CAAC;AACtB,QAAA,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;AAEhC;;;;"}

package/lib/core/options.d.ts

@@ -1,5 +1,7 @@
 import type { ITtscProjectPluginConfig } from "ttsc";
+/** Raw compiler-options overlay supplied by the caller as a plain JSON value. */
 export type TtscUnpluginCompilerOptionsJson = Record<string, unknown>;
+/** Options accepted by the `@ttsc/unplugin` bundler adapter. */
 export interface TtscUnpluginOptions {
     /**
      * Project config used by the bundler adapter.
@@ -24,9 +26,29 @@ export interface TtscUnpluginOptions {
      */
     plugins?: readonly ITtscProjectPluginConfig[] | false;
 }
+/**
+ * Fully-resolved plugin options with all defaults applied.
+ *
+ * Produced by {@link resolveOptions}; consumed internally by the transform
+ * pipeline. Every field is present and normalised — callers should not
+ * construct this type directly.
+ */
 export interface ResolvedTtscUnpluginOptions {
+    /** Compiler-options overlay applied on top of the discovered tsconfig. */
     compilerOptions: TtscUnpluginCompilerOptionsJson;
+    /**
+     * Resolved plugin list; mirrors the semantics of
+     * {@link TtscUnpluginOptions.plugins}.
+     */
     plugins?: readonly ITtscProjectPluginConfig[] | false;
+    /** Resolved path to the project tsconfig, or `undefined` to auto-discover. */
     project?: string;
 }
+/**
+ * Normalise raw user-supplied options into {@link ResolvedTtscUnpluginOptions}.
+ *
+ * Merges provided values with defaults. The `plugins` field uses an explicit
+ * `"plugins" in options` presence check rather than a falsy guard so that
+ * `plugins: false` (disable all plugins) is preserved as-is.
+ */
 export declare function resolveOptions(options?: TtscUnpluginOptions): ResolvedTtscUnpluginOptions;

package/lib/core/options.js

@@ -4,6 +4,13 @@ const defaultOptions = {
     plugins: undefined,
     project: undefined,
 };
+/**
+ * Normalise raw user-supplied options into {@link ResolvedTtscUnpluginOptions}.
+ *
+ * Merges provided values with defaults. The `plugins` field uses an explicit
+ * `"plugins" in options` presence check rather than a falsy guard so that
+ * `plugins: false` (disable all plugins) is preserved as-is.
+ */
 function resolveOptions(options = {}) {
     return {
         compilerOptions: { ...(options.compilerOptions ?? {}) },

package/lib/core/options.js.map

@@ -1 +1 @@
-{"version":3,"file":"options.js","sources":["../../src/core/options.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAqCA,MAAM,cAAc,GAAgC;AAClD,IACA,OAAO,EAAE,SAAS;AAClB,IAAA,OAAO,EAAE,SAAS;CACnB;AAEK,SAAU,cAAc,CAC5B,OAAA,GAA+B,EAAE,EAAA;IAEjC,OAAO;QACL,eAAe,EAAE,EAAE,IAAI,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC,EAAE;AACvD,QAAA,OAAO,EAAE,SAAS,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,GAAG,cAAc,CAAC,OAAO;AACxE,QAAA,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,cAAc,CAAC,OAAO;KACnD;AACH;;;;"}
+{"version":3,"file":"options.js","sources":["../../src/core/options.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAoDA,MAAM,cAAc,GAAgC;AAClD,IACA,OAAO,EAAE,SAAS;AAClB,IAAA,OAAO,EAAE,SAAS;CACnB;AAED;;;;;;AAMG;AACG,SAAU,cAAc,CAC5B,OAAA,GAA+B,EAAE,EAAA;IAEjC,OAAO;QACL,eAAe,EAAE,EAAE,IAAI,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC,EAAE;AACvD,QAAA,OAAO,EAAE,SAAS,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,GAAG,cAAc,CAAC,OAAO;AACxE,QAAA,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,cAAc,CAAC,OAAO;KACnD;AACH;;;;"}

package/lib/core/options.mjs

@@ -2,6 +2,13 @@ const defaultOptions = {
     plugins: undefined,
     project: undefined,
 };
+/**
+ * Normalise raw user-supplied options into {@link ResolvedTtscUnpluginOptions}.
+ *
+ * Merges provided values with defaults. The `plugins` field uses an explicit
+ * `"plugins" in options` presence check rather than a falsy guard so that
+ * `plugins: false` (disable all plugins) is preserved as-is.
+ */
 function resolveOptions(options = {}) {
     return {
         compilerOptions: { ...(options.compilerOptions ?? {}) },

package/lib/core/options.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"options.mjs","sources":["../../src/core/options.ts"],"sourcesContent":[null],"names":[],"mappings":"AAqCA,MAAM,cAAc,GAAgC;AAClD,IACA,OAAO,EAAE,SAAS;AAClB,IAAA,OAAO,EAAE,SAAS;CACnB;AAEK,SAAU,cAAc,CAC5B,OAAA,GAA+B,EAAE,EAAA;IAEjC,OAAO;QACL,eAAe,EAAE,EAAE,IAAI,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC,EAAE;AACvD,QAAA,OAAO,EAAE,SAAS,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,GAAG,cAAc,CAAC,OAAO;AACxE,QAAA,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,cAAc,CAAC,OAAO;KACnD;AACH;;;;"}
+{"version":3,"file":"options.mjs","sources":["../../src/core/options.ts"],"sourcesContent":[null],"names":[],"mappings":"AAoDA,MAAM,cAAc,GAAgC;AAClD,IACA,OAAO,EAAE,SAAS;AAClB,IAAA,OAAO,EAAE,SAAS;CACnB;AAED;;;;;;AAMG;AACG,SAAU,cAAc,CAC5B,OAAA,GAA+B,EAAE,EAAA;IAEjC,OAAO;QACL,eAAe,EAAE,EAAE,IAAI,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC,EAAE;AACvD,QAAA,OAAO,EAAE,SAAS,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,GAAG,cAAc,CAAC,OAAO;AACxE,QAAA,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,cAAc,CAAC,OAAO;KACnD;AACH;;;;"}

package/lib/core/transform.d.ts

@@ -1,19 +1,92 @@
 import type { ITtscCompilerTransformation } from "ttsc";
 import type { TransformResult } from "unplugin";
 import type { ResolvedTtscUnpluginOptions } from "./options";
+/**
+ * The normalised transform result type that this module produces.
+ *
+ * Excludes the shorthand `string`, `null`, and `undefined` variants of
+ * unplugin's `TransformResult` so callers always receive an object or
+ * `undefined`.
+ */
 export type TtscTransformResult = Exclude<TransformResult, string | null | undefined>;
+/**
+ * Normalised alias entry used when building the `paths` overlay for the
+ * generated tsconfig. Derived from either a Vite array alias or a webpack/
+ * Rspack object alias.
+ */
 export interface TtscTransformAlias {
+    /** The alias key (module specifier prefix). */
     find: string;
+    /** Absolute or cwd-relative path that the alias points to. */
     replacement: string;
 }
+/**
+ * A single entry in the per-build transform cache.
+ *
+ * Stores the full compiler result together with SHA-256 hashes of every input
+ * file. On subsequent transforms the cached entry is validated by comparing
+ * fresh hashes against {@link inputHashes}; a mismatch triggers a full
+ * re-transform of the project.
+ */
 export interface TtscCachedProjectTransform {
+    /**
+     * SHA-256 hash of each project-relative input path at the time of the
+     * transform.
+     */
     inputHashes: Record<string, string>;
+    /** Absolute path to the directory that owns the tsconfig. */
     projectRoot: string;
+    /** Raw compiler output returned by {@link TtscCompiler.transform}. */
     result: ITtscCompilerTransformation;
 }
+/**
+ * Keyed by a stable JSON string that encodes the tsconfig path, compiler
+ * options overlay, plugin list, and alias paths. The value is a `Promise` so
+ * concurrent transforms for the same project share a single in-flight
+ * compilation rather than spawning multiple `TtscCompiler` instances.
+ */
 export type TtscTransformCache = Map<string, Promise<TtscCachedProjectTransform>>;
+/** Create an empty transform cache for a single build session. */
 export declare function createTtscTransformCache(): TtscTransformCache;
+/**
+ * Apply the ttsc plugin transform to a single source file.
+ *
+ * The function is intentionally project-scoped: it compiles the entire tsconfig
+ * project in one shot and extracts the result for `id`. Subsequent calls for
+ * sibling files in the same project reuse the cached result as long as none of
+ * the project's input files have changed (verified by comparing SHA-256
+ * hashes).
+ *
+ * Returns `undefined` when no transform is needed (declaration files, virtual
+ * modules, disabled plugins, or source unchanged after transform).
+ *
+ * @param id - Bundler module id (may carry a query string or virtual prefix).
+ * @param source - Current file content supplied by the bundler.
+ * @param options - Resolved plugin options.
+ * @param aliases - Raw bundler alias configuration (Vite array or webpack
+ *   object).
+ * @param cache - Optional per-build cache; cleared by the caller on
+ *   `buildStart`.
+ */
 export declare function transformTtsc(id: string, source: string, options: ResolvedTtscUnpluginOptions, aliases?: unknown, cache?: TtscTransformCache): Promise<TtscTransformResult | undefined>;
+/**
+ * Strip a query string or hash fragment from a bundler module id.
+ *
+ * Vite appends query parameters (e.g. `?raw`, `?url`, `?inline`) to
+ * differentiate import variants of the same file. We must strip them before
+ * using the id as a file-system path.
+ */
 export declare function stripQuery(id: string): string;
+/**
+ * Returns `true` for TypeScript declaration files (`.d.ts`, `.d.mts`,
+ * `.d.cts`).
+ */
 export declare function isDeclarationFile(id: string): boolean;
+/**
+ * Build the unplugin transform result, or `undefined` when the transform
+ * produced no changes.
+ *
+ * Returning `undefined` instead of `{ code: source }` lets the bundler skip the
+ * unnecessary module update and preserves the original source map.
+ */
 export declare function createTransformResult(source: string, code: string): TtscTransformResult | undefined;