@ic-reactor/vite-plugin 0.8.0 → 0.10.0

package/README.md

@@ -31,7 +31,7 @@ export default defineConfig({
 
 ```ts
 // src/clients.ts
-import { ClientManager } from "@ic-reactor/react"
+import { ClientManager } from "@ic-reactor/core"
 import { QueryClient } from "@tanstack/react-query"
 
 export const queryClient = new QueryClient()
@@ -43,6 +43,9 @@ export const clientManager = new ClientManager({
 
 The plugin generates files under `src/declarations/<canister>/` by default.
 
+If you want non-React output, set `target: "core"` and install the matching
+runtime package instead of `@ic-reactor/react`.
+
 ## Options
 
 ```ts
@@ -56,6 +59,7 @@ icReactor({
   ],
   outDir: "src/declarations",
   clientManagerPath: "../../clients",
+  target: "react",
   injectEnvironment: true,
 })
 ```
@@ -66,6 +70,7 @@ icReactor({
 - `didFile`
 - `outDir`
 - `clientManagerPath`
+- `target`
 - `mode`
 - `canisterId`
 
@@ -77,11 +82,16 @@ Supported `mode` values:
 - `CandidDisplayReactor`
 - `MetadataDisplayReactor`
 
+Supported `target` values:
+
+- `react` (default): generates the reactor plus bound React hooks
+- `core`: generates only the typed reactor exports with no React dependency
+
 ## Local Development Behavior
 
 When `injectEnvironment` is enabled during `vite dev`, the plugin:
 
-1. asks `icp-cli` for the local network status
+1. asks `icp` for the local network status
 2. resolves configured canister IDs
 3. sets the `ic_env` cookie
 4. proxies `/api` to the local replica

package/dist/index.cjs

@@ -83,11 +83,13 @@ function icReactor(options) {
     canisters,
     outDir = "src/declarations",
     clientManagerPath = "../../clients",
+    target = "react",
     injectEnvironment = true
   } = options;
   const globalConfig = {
     outDir,
-    clientManagerPath
+    clientManagerPath,
+    target
   };
   const projectRoot = process.cwd();
   const resolveDidPath = (didFile) => import_node_path.default.normalize(
@@ -100,7 +102,7 @@ function icReactor(options) {
     name: "ic-reactor-plugin",
     enforce: "pre",
     // Run before other plugins
-    config(config, { command }) {
+    config(_config, { command }) {
       if (command !== "serve" || !injectEnvironment) {
         return {};
       }
@@ -148,28 +150,29 @@ function icReactor(options) {
     },
     async buildStart() {
       console.log(
-        `[ic-reactor] Generating hooks for ${canisters.length} canisters...`
+        `[ic-reactor] Generating canister bindings for ${canisters.length} canisters...`
       );
-      for (const canisterConfig of canisters) {
-        try {
-          const result = await (0, import_codegen.runCanisterPipeline)({
-            canisterConfig,
-            projectRoot,
-            globalConfig
-          });
-          if (!result.success) {
+      await Promise.allSettled(
+        canisters.map(async (canisterConfig) => {
+          try {
+            const result = await (0, import_codegen.runCanisterPipeline)({
+              canisterConfig,
+              projectRoot,
+              globalConfig
+            });
+            if (!result.success) {
+              console.error(
+                `[ic-reactor] Failed to generate ${canisterConfig.name}: ${result.error}`
+              );
+            }
+          } catch (err) {
             console.error(
-              `[ic-reactor] Failed to generate ${canisterConfig.name}: ${result.error}`
+              `[ic-reactor] Error generating ${canisterConfig.name}:`,
+              err
             );
-          } else {
           }
-        } catch (err) {
-          console.error(
-            `[ic-reactor] Error generating ${canisterConfig.name}:`,
-            err
-          );
-        }
-      }
+        })
+      );
     },
     handleHotUpdate({ file, server }) {
       if (file.endsWith(".did")) {

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { CanisterConfig } from '@ic-reactor/codegen';
+import { CanisterConfig, CodegenTarget } from '@ic-reactor/codegen';
 
 /**
  * @ic-reactor/vite-plugin
@@ -25,6 +25,11 @@ interface IcReactorPluginOptions {
      * Default: "../../clients"
      */
     clientManagerPath?: string;
+    /**
+     * Default generated runtime target.
+     * Default: "react"
+     */
+    target?: CodegenTarget;
     /**
      * Automatically inject `ic_env` cookie for local development?
      * Default: true

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { CanisterConfig } from '@ic-reactor/codegen';
+import { CanisterConfig, CodegenTarget } from '@ic-reactor/codegen';
 
 /**
  * @ic-reactor/vite-plugin
@@ -25,6 +25,11 @@ interface IcReactorPluginOptions {
      * Default: "../../clients"
      */
     clientManagerPath?: string;
+    /**
+     * Default generated runtime target.
+     * Default: "react"
+     */
+    target?: CodegenTarget;
     /**
      * Automatically inject `ic_env` cookie for local development?
      * Default: true

package/dist/index.js

@@ -51,11 +51,13 @@ function icReactor(options) {
     canisters,
     outDir = "src/declarations",
     clientManagerPath = "../../clients",
+    target = "react",
     injectEnvironment = true
   } = options;
   const globalConfig = {
     outDir,
-    clientManagerPath
+    clientManagerPath,
+    target
   };
   const projectRoot = process.cwd();
   const resolveDidPath = (didFile) => path.normalize(
@@ -68,7 +70,7 @@ function icReactor(options) {
     name: "ic-reactor-plugin",
     enforce: "pre",
     // Run before other plugins
-    config(config, { command }) {
+    config(_config, { command }) {
       if (command !== "serve" || !injectEnvironment) {
         return {};
       }
@@ -116,28 +118,29 @@ function icReactor(options) {
     },
     async buildStart() {
       console.log(
-        `[ic-reactor] Generating hooks for ${canisters.length} canisters...`
+        `[ic-reactor] Generating canister bindings for ${canisters.length} canisters...`
       );
-      for (const canisterConfig of canisters) {
-        try {
-          const result = await runCanisterPipeline({
-            canisterConfig,
-            projectRoot,
-            globalConfig
-          });
-          if (!result.success) {
+      await Promise.allSettled(
+        canisters.map(async (canisterConfig) => {
+          try {
+            const result = await runCanisterPipeline({
+              canisterConfig,
+              projectRoot,
+              globalConfig
+            });
+            if (!result.success) {
+              console.error(
+                `[ic-reactor] Failed to generate ${canisterConfig.name}: ${result.error}`
+              );
+            }
+          } catch (err) {
             console.error(
-              `[ic-reactor] Failed to generate ${canisterConfig.name}: ${result.error}`
+              `[ic-reactor] Error generating ${canisterConfig.name}:`,
+              err
             );
-          } else {
           }
-        } catch (err) {
-          console.error(
-            `[ic-reactor] Error generating ${canisterConfig.name}:`,
-            err
-          );
-        }
-      }
+        })
+      );
     },
     handleHotUpdate({ file, server }) {
       if (file.endsWith(".did")) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ic-reactor/vite-plugin",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "Vite plugin for zero-config IC reactor generation from Candid files",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -37,17 +37,17 @@
     "url": "https://github.com/B3Pay/ic-reactor/issues"
   },
   "dependencies": {
-    "@ic-reactor/codegen": "0.8.0"
+    "@ic-reactor/codegen": "0.10.0"
   },
   "peerDependencies": {
     "vite": "^4.2.0 || ^5.0.0 || ^6.0.0 || ^7.0.0"
   },
   "devDependencies": {
-    "@icp-sdk/bindgen": "^0.2.2",
-    "@types/node": "^25.3.5",
+    "@icp-sdk/bindgen": "^0.3.0",
+    "@types/node": "^25.5.2",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.18"
+    "vitest": "^4.1.2"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --tsconfig tsconfig.json",

package/src/env.ts

@@ -1,7 +1,7 @@
 /**
  * Environment Injection Utilities
  *
- * Handles detecting the local IC environment (via `dfx` or `icp` CLI)
+ * Handles detecting the local IC environment via the `icp` CLI
  * and building the `ic_env` cookie for the browser.
  */
 
@@ -15,16 +15,13 @@ export interface IcEnvironment {
 }
 
 /**
- * Detect the IC environment using the `icp` or `dfx` CLI.
+ * Detect the IC environment using the `icp` CLI.
  */
 export function getIcEnvironmentInfo(
   canisterNames: string[]
 ): IcEnvironment | null {
   const environment = process.env.ICP_ENVIRONMENT || "local"
 
-  // We try `icp` first, but could fallback to `dfx` logic if needed.
-  // For now, assuming `icp` CLI is available based on previous code.
-
   try {
     const networkStatus = JSON.parse(
       execFileSync("icp", ["network", "status", "-e", environment, "--json"], {

package/src/index.test.ts

@@ -78,7 +78,7 @@ describe("icReactor", () => {
   describe("config", () => {
     it("should set up API proxy and headers when icp-cli is available", () => {
       ;(execFileSync as any).mockImplementation(
-        (command: string, args: string[], options: any) => {
+        (command: string, args: string[], _options: any) => {
           if (
             command === "icp" &&
             args.includes("network") &&
@@ -112,7 +112,7 @@ describe("icReactor", () => {
 
     it("should prefer configured canisterId over CLI-discovered env values", () => {
       ;(execFileSync as any).mockImplementation(
-        (command: string, args: string[], options: any) => {
+        (command: string, args: string[], _options: any) => {
           if (
             command === "icp" &&
             args.includes("network") &&
@@ -181,6 +181,7 @@ describe("icReactor", () => {
         globalConfig: {
           outDir: "src/declarations",
           clientManagerPath: "../../clients",
+          target: "react",
         },
       })
     })
@@ -227,6 +228,26 @@ describe("icReactor", () => {
         globalConfig: {
           outDir: "src/declarations",
           clientManagerPath: "../../clients",
+          target: "react",
+        },
+      })
+    })
+
+    it("should pass the configured runtime target to codegen", async () => {
+      const plugin = createVitePlugin({
+        ...mockOptions,
+        target: "core",
+      })
+
+      await (plugin.buildStart as any)()
+
+      expect(runCanisterPipeline).toHaveBeenCalledWith({
+        canisterConfig: mockOptions.canisters[0],
+        projectRoot: expect.any(String),
+        globalConfig: {
+          outDir: "src/declarations",
+          clientManagerPath: "../../clients",
+          target: "core",
         },
       })
     })

package/src/index.ts

@@ -13,6 +13,7 @@ import {
   runCanisterPipeline,
   type CanisterConfig,
   type CodegenConfig,
+  type CodegenTarget,
 } from "@ic-reactor/codegen"
 import { getIcEnvironmentInfo, buildIcEnvCookie } from "./env.js"
 
@@ -32,6 +33,11 @@ export interface IcReactorPluginOptions {
    * Default: "../../clients"
    */
   clientManagerPath?: string
+  /**
+   * Default generated runtime target.
+   * Default: "react"
+   */
+  target?: CodegenTarget
   /**
    * Automatically inject `ic_env` cookie for local development?
    * Default: true
@@ -44,13 +50,18 @@ export function icReactor(options: IcReactorPluginOptions): any {
     canisters,
     outDir = "src/declarations",
     clientManagerPath = "../../clients",
+    target = "react",
     injectEnvironment = true,
   } = options
 
   // Construct a partial CodegenConfig to pass to the pipeline
-  const globalConfig: Pick<CodegenConfig, "outDir" | "clientManagerPath"> = {
+  const globalConfig: Pick<
+    CodegenConfig,
+    "outDir" | "clientManagerPath" | "target"
+  > = {
     outDir,
     clientManagerPath,
+    target,
   }
   const projectRoot = process.cwd()
   const resolveDidPath = (didFile: string) =>
@@ -67,7 +78,7 @@ export function icReactor(options: IcReactorPluginOptions): any {
     name: "ic-reactor-plugin",
     enforce: "pre", // Run before other plugins
 
-    config(config, { command }) {
+    config(_config, { command }) {
       if (command !== "serve" || !injectEnvironment) {
         return {}
       }
@@ -131,36 +142,35 @@ export function icReactor(options: IcReactorPluginOptions): any {
       // ── Code Generation ──────────────────────────────────────────────────
 
       console.log(
-        `[ic-reactor] Generating hooks for ${canisters.length} canisters...`
+        `[ic-reactor] Generating canister bindings for ${canisters.length} canisters...`
       )
 
-      for (const canisterConfig of canisters) {
-        try {
-          // If .did file is missing, we might want to attempt pulling it?
-          // For now, pipeline fails if missing. The old plugin logic to "download"
-          // is omitted for simplicity unless requested, to keep "codegen" pure.
-
-          const result = await runCanisterPipeline({
-            canisterConfig,
-            projectRoot,
-            globalConfig,
-          })
-
-          if (!result.success) {
+      await Promise.allSettled(
+        canisters.map(async (canisterConfig) => {
+          try {
+            // If .did file is missing, we might want to attempt pulling it?
+            // For now, pipeline fails if missing. The old plugin logic to "download"
+            // is omitted for simplicity unless requested, to keep "codegen" pure.
+
+            const result = await runCanisterPipeline({
+              canisterConfig,
+              projectRoot,
+              globalConfig,
+            })
+
+            if (!result.success) {
+              console.error(
+                `[ic-reactor] Failed to generate ${canisterConfig.name}: ${result.error}`
+              )
+            }
+          } catch (err) {
             console.error(
-              `[ic-reactor] Failed to generate ${canisterConfig.name}: ${result.error}`
+              `[ic-reactor] Error generating ${canisterConfig.name}:`,
+              err
             )
-          } else {
-            // Optional: log success
-            // console.log(`[ic-reactor] Generated ${canisterConfig.name} hooks`)
           }
-        } catch (err) {
-          console.error(
-            `[ic-reactor] Error generating ${canisterConfig.name}:`,
-            err
-          )
-        }
-      }
+        })
+      )
     },
 
     handleHotUpdate({ file, server }) {