@zerowire/unplugin 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,69 @@
-# Temporary Holding Version
+# @zerowire/unplugin
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Universal Ahead-of-Time build plugin for zerowire TypeScript binary codec and validator.
+
+## Overview
+
+`@zerowire/unplugin` intercepts `compileWireCodec<T>()` macro calls in TypeScript code at build time and transforms them into compiled, branchless `DataView` validators, lazy Flyweight classes, and binary encoders. AST extraction and layout packing run via native Rust (`oxc_parser`), operating at sub-millisecond speeds without calling `tsc`.
+
+Supported bundlers include Vite, Rolldown, Rollup, and esbuild.
+
+## Installation
+
+```bash
+pnpm add -D @zerowire/unplugin @zerowire/runtime
+# or
+npm install -D @zerowire/unplugin @zerowire/runtime
+# or
+bun add -d @zerowire/unplugin @zerowire/runtime
+```
+
+## Bundler Configuration
+
+### Vite
+
+```typescript
+// vite.config.ts
+import { defineConfig } from "vite";
+import { zerowireVite } from "@zerowire/unplugin";
+
+export default defineConfig({
+  plugins: [zerowireVite()],
+});
+```
+
+### Rollup and Rolldown
+
+```javascript
+// rollup.config.js
+import { zerowireRollup } from "@zerowire/unplugin";
+
+export default {
+  plugins: [zerowireRollup()],
+};
+```
+
+### esbuild
+
+```typescript
+import esbuild from "esbuild";
+import { zerowireEsbuild } from "@zerowire/unplugin";
+
+await esbuild.build({
+  entryPoints: ["src/index.ts"],
+  bundle: true,
+  outfile: "dist/bundle.js",
+  plugins: [zerowireEsbuild()],
+});
+```
+
+## How It Works
+
+1. During bundling, `@zerowire/unplugin` scans imported source files for `compileWireCodec<T>()` markers.
+2. The Rust compiler extracts the target interface `T` using `oxc_parser` and `oxc_allocator`.
+3. The layout packer sorts fixed fields by alignment (8B -> 4B -> 2B -> 1B) and emits a self-contained JavaScript codec module.
+4. The call site is replaced with the compiled codec class, providing zero-overhead execution with no runtime compiler dependency.
+
+## License
+
+MIT OR Apache-2.0

package/dist/esbuild.d.ts

@@ -0,0 +1,3 @@
+declare const _default: (options?: import("./index.js").ZeroWirePluginOptions | undefined) => import("unplugin").EsbuildPlugin;
+export default _default;
+//# sourceMappingURL=esbuild.d.ts.map

package/dist/esbuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"esbuild.d.ts","sourceRoot":"","sources":["../src/esbuild.ts"],"names":[],"mappings":";AACA,wBAAgC"}

package/dist/esbuild.js

@@ -0,0 +1,3 @@
+import { unplugin } from "./index.js";
+export default unplugin.esbuild;
+//# sourceMappingURL=esbuild.js.map

package/dist/esbuild.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"esbuild.js","sourceRoot":"","sources":["../src/esbuild.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,eAAe,QAAQ,CAAC,OAAO,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export interface ZeroWirePluginOptions {
+    /** Target file extensions to transform (default: ['.ts', '.tsx']) */
+    include?: string[];
+}
+export declare const unplugin: import("unplugin").UnpluginInstance<ZeroWirePluginOptions | undefined, boolean>;
+export declare const vite: (options?: ZeroWirePluginOptions | undefined) => import("unplugin").VitePlugin<any> | import("unplugin").VitePlugin<any>[];
+export declare const rollup: (options?: ZeroWirePluginOptions | undefined) => import("rollup").Plugin<any> | import("rollup").Plugin<any>[];
+export declare const esbuild: (options?: ZeroWirePluginOptions | undefined) => import("unplugin").EsbuildPlugin;
+export default unplugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,qBAAqB;IACpC,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,eAAO,MAAM,QAAQ,iFAkCnB,CAAC;AAEH,eAAO,MAAM,IAAI,4HAAgB,CAAC;AAClC,eAAO,MAAM,MAAM,gHAAkB,CAAC;AACtC,eAAO,MAAM,OAAO,mFAAmB,CAAC;AACxC,eAAe,QAAQ,CAAC"}

package/dist/index.js

@@ -0,0 +1,39 @@
+//! @zerowire/unplugin: Ahead-of-Time build plugin for Vite, Rolldown, esbuild, and Rollup.
+import { createUnplugin } from "unplugin";
+import { compileWireCodec } from "@zerowire/napi";
+export const unplugin = createUnplugin((options = {}) => {
+    const includeExts = options?.include ?? [".ts", ".tsx"];
+    return {
+        name: "zerowire-plugin",
+        transformInclude(id) {
+            return includeExts.some((ext) => id.endsWith(ext));
+        },
+        transform(code, id) {
+            if (!code.includes("compileWireCodec") && !code.includes("compileCodec")) {
+                return null;
+            }
+            try {
+                const result = compileWireCodec(code, undefined);
+                // Replace compileWireCodec<T>() macro calls with compiled codec instantiation
+                const macroRegex = /(?:export\s+const\s+(\w+)\s*=\s*)?compile(?:Wire)?Codec<(\w+)>\(\);?/g;
+                const transformed = code.replace(macroRegex, (_match, varName, _typeName) => {
+                    const exportVar = varName ? `export const ${varName} = ${result.targetType}Codec;` : "";
+                    return `${result.jsCode}\n${exportVar}`;
+                });
+                return {
+                    code: transformed,
+                    map: null,
+                };
+            }
+            catch (err) {
+                console.error(`[@zerowire/unplugin] Failed to transform ${id}:`, err);
+                return null;
+            }
+        },
+    };
+});
+export const vite = unplugin.vite;
+export const rollup = unplugin.rollup;
+export const esbuild = unplugin.esbuild;
+export default unplugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAE3F,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAOlD,MAAM,CAAC,MAAM,QAAQ,GAAG,cAAc,CAAoC,CAAC,OAAO,GAAG,EAAE,EAAE,EAAE;IACzF,MAAM,WAAW,GAAG,OAAO,EAAE,OAAO,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAExD,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,gBAAgB,CAAC,EAAE;YACjB,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QACrD,CAAC;QACD,SAAS,CAAC,IAAI,EAAE,EAAE;YAChB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;gBACzE,OAAO,IAAI,CAAC;YACd,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;gBAEjD,8EAA8E;gBAC9E,MAAM,UAAU,GAAG,uEAAuE,CAAC;gBAE3F,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE;oBAC1E,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,gBAAgB,OAAO,MAAM,MAAM,CAAC,UAAU,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;oBACxF,OAAO,GAAG,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC1C,CAAC,CAAC,CAAC;gBAEH,OAAO;oBACL,IAAI,EAAE,WAAW;oBACjB,GAAG,EAAE,IAAI;iBACV,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,4CAA4C,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;gBACtE,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;AAClC,MAAM,CAAC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;AACtC,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;AACxC,eAAe,QAAQ,CAAC"}

package/dist/rollup.d.ts

@@ -0,0 +1,3 @@
+declare const _default: (options?: import("./index.js").ZeroWirePluginOptions | undefined) => import("rollup").Plugin<any> | import("rollup").Plugin<any>[];
+export default _default;
+//# sourceMappingURL=rollup.d.ts.map

package/dist/rollup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollup.d.ts","sourceRoot":"","sources":["../src/rollup.ts"],"names":[],"mappings":";AACA,wBAA+B"}

package/dist/rollup.js

@@ -0,0 +1,3 @@
+import { unplugin } from "./index.js";
+export default unplugin.rollup;
+//# sourceMappingURL=rollup.js.map

package/dist/rollup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollup.js","sourceRoot":"","sources":["../src/rollup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,eAAe,QAAQ,CAAC,MAAM,CAAC"}

package/dist/vite.d.ts

@@ -0,0 +1,3 @@
+declare const _default: (options?: import("./index.js").ZeroWirePluginOptions | undefined) => import("unplugin").VitePlugin<any> | import("unplugin").VitePlugin<any>[];
+export default _default;
+//# sourceMappingURL=vite.d.ts.map

package/dist/vite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":";AACA,wBAA6B"}

package/dist/vite.js

@@ -0,0 +1,3 @@
+import { unplugin } from "./index.js";
+export default unplugin.vite;
+//# sourceMappingURL=vite.js.map

package/dist/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.js","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,eAAe,QAAQ,CAAC,IAAI,CAAC"}

package/package.json

@@ -1,6 +1,43 @@
 {
   "name": "@zerowire/unplugin",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "AOT build plugin for zerowire TypeScript validator and binary codec",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./vite": {
+      "import": "./dist/vite.js",
+      "types": "./dist/vite.d.ts"
+    },
+    "./esbuild": {
+      "import": "./dist/esbuild.js",
+      "types": "./dist/esbuild.d.ts"
+    },
+    "./rollup": {
+      "import": "./dist/rollup.js",
+      "types": "./dist/rollup.d.ts"
+    }
+  },
+  "dependencies": {
+    "@zerowire/runtime": "0.1.1",
+    "unplugin": "^2.2.0"
+  },
+  "devDependencies": {
+    "@zerowire/napi": "0.1.1",
+    "typescript": "^5.8.0",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
 }