@elliots/bun-plugin-typical 0.2.3 → 0.2.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Elliot Shepherd
+
+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/dist/index.d.mts

@@ -1,130 +1,58 @@
+import { TypicalConfig } from "@elliots/typical";
 import { BunPlugin } from "bun";
 
-//#region ../../dist/src/config.d.ts
-interface TypicalDebugConfig {
-  writeIntermediateFiles?: boolean;
-}
-/**
- * Configuration options for source map generation.
- */
-interface TypicalSourceMapConfig {
-  /**
-   * Generate source maps. Default: true
-   */
-  enabled?: boolean;
-  /**
-   * Include original source content in the map. Default: true
-   */
-  includeContent?: boolean;
-  /**
-   * Use inline source maps (data URL) instead of external files. Default: false
-   */
-  inline?: boolean;
-}
-interface TypicalConfig {
-  include?: string[];
-  exclude?: string[];
-  /**
-   * Controls whether validators are hoisted to module scope for reuse.
-   * - 'auto' (default): Hoist only validators used more than once
-   * - 'never': Never hoist, always generate inline validators
-   * - 'always': Always hoist validators, even if only used once
-   */
-  reusableValidators?: 'auto' | 'never' | 'always';
-  validateCasts?: boolean;
-  hoistRegex?: boolean;
-  debug?: TypicalDebugConfig;
-  /**
-   * Type patterns to skip validation for (supports wildcards).
-   * Use this for types that typia cannot process (e.g., React event types).
-   * Example: ["React.*", "Express.Request", "*.Event"]
-   */
-  ignoreTypes?: string[];
-  /**
-   * Validate function parameters and return types at runtime.
-   * When enabled, typed function parameters get runtime validation calls injected.
-   * Default: true
-   */
-  validateFunctions?: boolean;
+//#region src/core/options.d.ts
+interface Options {
   /**
-   * Transform JSON.parse<T>() calls to validate and filter the parsed result
-   * to only include properties defined in type T.
-   * Default: true
+   * Bun plugin target.
+   * @default 'bun'
    */
-  transformJSONParse?: boolean;
+  target?: "bun" | "browser" | "node";
   /**
-   * Transform JSON.stringify<T>() calls to only stringify properties defined
-   * in type T, preventing accidental data leaks.
-   * Default: true
+   * Patterns to include for transformation.
+   * If empty, all TypeScript files are included.
    */
-  transformJSONStringify?: boolean;
+  include?: (string | RegExp)[];
   /**
-   * Source map generation settings.
-   * Controls whether and how source maps are generated for transformed code.
+   * Patterns to exclude from transformation.
    */
-  sourceMap?: TypicalSourceMapConfig;
+  exclude?: (string | RegExp)[];
   /**
-   * Maximum number of helper functions (_io0, _io1, etc.) that can be generated
-   * for a single type before erroring. Complex DOM types or library types can
-   * generate hundreds of functions which indicates a type that should be excluded.
-   * Set to 0 to disable the limit.
-   * Default: 50
+   * Typical configuration overrides.
    */
-  maxGeneratedFunctions?: number;
-}
-//#endregion
-//#region src/core/options.d.ts
-type FilterPattern = string | RegExp | (string | RegExp)[];
-interface Options {
-  /**
-  * Files to include. Defaults to all .ts/.tsx/.mts/.cts files.
-  */
-  include?: FilterPattern;
-  /**
-  * Files to exclude. Defaults to node_modules.
-  */
-  exclude?: FilterPattern;
-  /**
-  * Bun target environment.
-  * @default 'bun'
-  */
-  target?: "bun" | "browser" | "node";
-  /**
-  * Typical configuration overrides.
-  */
   typical?: Partial<TypicalConfig>;
 }
 //#endregion
 //#region src/core/transform.d.ts
 /**
-* Close the shared transformer and release resources.
-*/
+ * Close the shared transformer and release resources.
+ */
 declare function closeTransformer(): Promise<void>;
 //#endregion
 //#region src/index.d.ts
 /**
-* Create a Bun plugin for Typical transformation.
-*
-* @example
-* ```ts
-* // For Bun.build()
-* import typicalPlugin from '@elliots/bun-plugin-typical'
-*
-* await Bun.build({
-*   entrypoints: ['./src/index.ts'],
-*   outdir: './dist',
-*   plugins: [typicalPlugin()],
-* })
-* ```
-*
-* @example
-* ```ts
-* // For runtime (bunfig.toml preload)
-* import typicalPlugin from '@elliots/bun-plugin-typical'
-*
-* Bun.plugin(typicalPlugin())
-* ```
-*/
+ * Create a Bun plugin for Typical transformation.
+ *
+ * @example
+ * ```ts
+ * // For Bun.build()
+ * import typicalPlugin from '@elliots/bun-plugin-typical'
+ *
+ * await Bun.build({
+ *   entrypoints: ['./src/index.ts'],
+ *   outdir: './dist',
+ *   plugins: [typicalPlugin()],
+ * })
+ * ```
+ *
+ * @example
+ * ```ts
+ * // For runtime (bunfig.toml preload)
+ * import typicalPlugin from '@elliots/bun-plugin-typical'
+ *
+ * Bun.plugin(typicalPlugin())
+ * ```
+ */
 declare function typicalPlugin(rawOptions?: Options): BunPlugin;
 //#endregion
 export { type Options, closeTransformer, typicalPlugin as default, typicalPlugin };

package/dist/index.mjs

@@ -1,3 +1,123 @@
-import { n as typicalPlugin, r as closeTransformer, t as src_default } from "./src-CBBPzozy.mjs";
+import { TypicalTransformer, buildTimer, loadConfig, validateConfig } from "@elliots/typical";
+import { extname, resolve } from "path";
 
+//#region src/core/options.ts
+/**
+* Resolve plugin options with defaults.
+*/
+function resolveOptions(options = {}) {
+	return {
+		target: options.target ?? "bun",
+		include: options.include ?? [],
+		exclude: options.exclude ?? [/node_modules/],
+		typical: options.typical ?? {}
+	};
+}
+
+//#endregion
+//#region src/core/transform.ts
+const TRANSFORM_EXTENSIONS = new Set([
+	".ts",
+	".tsx",
+	".mts",
+	".cts"
+]);
+const LOADER_MAP = {
+	".ts": "ts",
+	".mts": "ts",
+	".cts": "ts",
+	".tsx": "tsx"
+};
+let sharedTransformer = null;
+/**
+* Transform a TypeScript file with Typical.
+*
+* Returns TypeScript code with validation injected.
+* Bun handles the final transpilation to JavaScript.
+*/
+async function transformFile(filePath, config) {
+	buildTimer.start("total-transform");
+	const ext = extname(filePath).toLowerCase();
+	if (!TRANSFORM_EXTENSIONS.has(ext)) {
+		buildTimer.end("total-transform");
+		return;
+	}
+	const resolvedPath = resolve(filePath);
+	buildTimer.start("create-transformer");
+	if (!sharedTransformer) sharedTransformer = new TypicalTransformer(validateConfig(config));
+	buildTimer.end("create-transformer");
+	buildTimer.start("transform");
+	const result = await sharedTransformer.transform(resolvedPath, "ts");
+	buildTimer.end("transform");
+	buildTimer.end("total-transform");
+	if (process.env.DEBUG) console.log(`[bun-plugin-typical] Transformed: ${filePath}`);
+	return {
+		code: result.code,
+		loader: LOADER_MAP[ext] ?? "ts"
+	};
+}
+/**
+* Close the shared transformer and release resources.
+*/
+async function closeTransformer() {
+	if (sharedTransformer) {
+		await sharedTransformer.close();
+		sharedTransformer = null;
+	}
+}
+
+//#endregion
+//#region src/index.ts
+const TS_FILTER = /\.(ts|tsx|mts|cts)$/;
+/**
+* Create a Bun plugin for Typical transformation.
+*
+* @example
+* ```ts
+* // For Bun.build()
+* import typicalPlugin from '@elliots/bun-plugin-typical'
+*
+* await Bun.build({
+*   entrypoints: ['./src/index.ts'],
+*   outdir: './dist',
+*   plugins: [typicalPlugin()],
+* })
+* ```
+*
+* @example
+* ```ts
+* // For runtime (bunfig.toml preload)
+* import typicalPlugin from '@elliots/bun-plugin-typical'
+*
+* Bun.plugin(typicalPlugin())
+* ```
+*/
+function typicalPlugin(rawOptions = {}) {
+	const options = resolveOptions(rawOptions);
+	const typicalConfig = {
+		...loadConfig(),
+		...options.typical
+	};
+	return {
+		name: "bun-plugin-typical",
+		target: options.target,
+		setup(build) {
+			buildTimer.reset();
+			build.onLoad({ filter: TS_FILTER }, async (args) => {
+				if (options.exclude.some((pattern) => typeof pattern === "string" ? args.path.includes(pattern) : pattern.test(args.path))) return;
+				if (options.include.length > 0 && !options.include.some((pattern) => typeof pattern === "string" ? args.path.includes(pattern) : pattern.test(args.path))) return;
+				const result = await transformFile(args.path, typicalConfig);
+				if (!result) return;
+				if (process.env.DEBUG) buildTimer.report("[bun-plugin-typical]");
+				return {
+					contents: result.code,
+					loader: result.loader
+				};
+			});
+		}
+	};
+}
+var src_default = typicalPlugin;
+
+//#endregion
 export { closeTransformer, src_default as default, typicalPlugin };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elliots/bun-plugin-typical",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "Bun plugin for typical - runtime safe TypeScript transformer",
   "keywords": [
     "bun",
@@ -36,7 +36,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@elliots/typical": "0.2.3"
+    "@elliots/typical": "0.2.5"
   },
   "devDependencies": {
     "@types/bun": "^1.0.0",

package/dist/preload.d.mts

@@ -1 +0,0 @@
-export { };

package/dist/preload.mjs

@@ -1,34 +0,0 @@
-import { n as typicalPlugin } from "./src-CBBPzozy.mjs";
-
-//#region src/preload.ts
-/**
-* Convenience module for preloading the Typical plugin.
-*
-* @example
-* ```toml
-* # bunfig.toml
-* preload = ["./preload.ts"]
-* ```
-*
-* @example
-* ```ts
-* // preload.ts
-* import '@elliots/bun-plugin-typical/preload'
-* ```
-*
-* Or with custom options:
-* ```ts
-* // preload.ts
-* import { typicalPlugin } from '@elliots/bun-plugin-typical'
-*
-* Bun.plugin(typicalPlugin({
-*   typical: {
-*     reusableValidators: true,
-*   }
-* }))
-* ```
-*/
-Bun.plugin(typicalPlugin());
-
-//#endregion
-export {  };

package/dist/src-CBBPzozy.mjs

@@ -1,125 +0,0 @@
-import { TypicalTransformer, buildTimer, loadConfig, validateConfig } from "@elliots/typical";
-import { extname, resolve } from "path";
-
-//#region src/core/options.ts
-function normalizePattern(pattern) {
-	if (!pattern) return [];
-	if (Array.isArray(pattern)) return pattern;
-	return [pattern];
-}
-function resolveOptions(options) {
-	return {
-		include: normalizePattern(options.include),
-		exclude: options.exclude ? normalizePattern(options.exclude) : [/node_modules/],
-		target: options.target ?? "bun",
-		typical: options.typical
-	};
-}
-
-//#endregion
-//#region src/core/transform.ts
-const TRANSFORM_EXTENSIONS = new Set([
-	".ts",
-	".tsx",
-	".mts",
-	".cts"
-]);
-const LOADER_MAP = {
-	".ts": "ts",
-	".mts": "ts",
-	".cts": "ts",
-	".tsx": "tsx"
-};
-let sharedTransformer = null;
-/**
-* Transform a TypeScript file with Typical.
-*
-* Returns TypeScript code with validation injected.
-* Bun handles the final transpilation to JavaScript.
-*/
-async function transformFile(filePath, config) {
-	buildTimer.start("total-transform");
-	const ext = extname(filePath).toLowerCase();
-	if (!TRANSFORM_EXTENSIONS.has(ext)) {
-		buildTimer.end("total-transform");
-		return;
-	}
-	const resolvedPath = resolve(filePath);
-	buildTimer.start("create-transformer");
-	if (!sharedTransformer) sharedTransformer = new TypicalTransformer(validateConfig(config));
-	buildTimer.end("create-transformer");
-	buildTimer.start("transform");
-	const result = await sharedTransformer.transform(resolvedPath, "ts");
-	buildTimer.end("transform");
-	buildTimer.end("total-transform");
-	if (process.env.DEBUG) console.log(`[bun-plugin-typical] Transformed: ${filePath}`);
-	return {
-		code: result.code,
-		loader: LOADER_MAP[ext] ?? "ts"
-	};
-}
-/**
-* Close the shared transformer and release resources.
-*/
-async function closeTransformer() {
-	if (sharedTransformer) {
-		await sharedTransformer.close();
-		sharedTransformer = null;
-	}
-}
-
-//#endregion
-//#region src/index.ts
-const TS_FILTER = /\.(ts|tsx|mts|cts)$/;
-/**
-* Create a Bun plugin for Typical transformation.
-*
-* @example
-* ```ts
-* // For Bun.build()
-* import typicalPlugin from '@elliots/bun-plugin-typical'
-*
-* await Bun.build({
-*   entrypoints: ['./src/index.ts'],
-*   outdir: './dist',
-*   plugins: [typicalPlugin()],
-* })
-* ```
-*
-* @example
-* ```ts
-* // For runtime (bunfig.toml preload)
-* import typicalPlugin from '@elliots/bun-plugin-typical'
-*
-* Bun.plugin(typicalPlugin())
-* ```
-*/
-function typicalPlugin(rawOptions = {}) {
-	const options = resolveOptions(rawOptions);
-	const typicalConfig = {
-		...loadConfig(),
-		...options.typical
-	};
-	return {
-		name: "bun-plugin-typical",
-		target: options.target,
-		setup(build) {
-			buildTimer.reset();
-			build.onLoad({ filter: TS_FILTER }, async (args) => {
-				if (options.exclude.some((pattern) => typeof pattern === "string" ? args.path.includes(pattern) : pattern.test(args.path))) return;
-				if (options.include.length > 0 && !options.include.some((pattern) => typeof pattern === "string" ? args.path.includes(pattern) : pattern.test(args.path))) return;
-				const result = await transformFile(args.path, typicalConfig);
-				if (!result) return;
-				if (process.env.DEBUG) buildTimer.report("[bun-plugin-typical]");
-				return {
-					contents: result.code,
-					loader: result.loader
-				};
-			});
-		}
-	};
-}
-var src_default = typicalPlugin;
-
-//#endregion
-export { typicalPlugin as n, closeTransformer as r, src_default as t };