@zerotal/inertia 1.6.0 → 1.6.1

package/CHANGELOG.md

@@ -8,6 +8,26 @@ follows the Zerotal monorepo's unified versioning.
 
 ## [Unreleased]
 
+## [1.6.1] — 2026-08-15
+
+### Fixed
+
+- **DevTools reported that the app was not in dev mode, and suggested starting a Vite
+  server.** The advice cannot be followed in a Zerotal app, and the cause was real: the
+  Inertia adapter enables its client-side hooks from a `dev` option whose default is
+  `import.meta.env.DEV` — a Vite convention. Bun's bundler leaves that expression alone, so
+  it survived into the bundle and evaluated to `false` on every build.
+
+  Zerotal now defines `import.meta.env` for every Inertia build, development and production
+  alike, so the adapter's own default resolves. Nothing to configure, and no `dev` option to
+  pass by hand.
+
+  The subtlety worth recording: the adapter writes `import.meta.env?.DEV`, optional-chained
+  — which is why an undefined `import.meta.env` yields `false` rather than throwing, and why
+  a bundler define keyed on `import.meta.env.DEV` **does not match it**. The whole object has
+  to be replaced, not the member. A test pins that, because the member form compiles to a
+  perfectly clean no-op.
+
 ## [1.6.0] — 2026-08-15
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerotal/inertia",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "license": "MIT",
   "maturity": "stable",
   "private": false,
@@ -32,7 +32,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@zerotal/core": "1.6.0"
+    "@zerotal/core": "1.6.1"
   },
   "peerDependencies": {
     "react": "^18 || ^19",

package/src/commands/InertiaBuildCommand.ts

@@ -1,5 +1,5 @@
 import { Command } from "@zerotal/core";
-import { pruneBuildOutput } from "@zerotal/core/dev";
+import { pruneBuildOutput, browserEnvDefines } from "@zerotal/core/dev";
 import { generatePageRegistry } from "../PageRegistry.ts";
 import { detectCssPlugins } from "../css.ts";
 import { detectVuePlugin } from "../vuePlugin.ts";
@@ -55,6 +55,11 @@ export class InertiaBuildCommand extends Command {
       splitting: true, // REQUIRED: creates per-page chunks from dynamic imports
       minify: isProd,
       sourcemap: isProd ? "none" : "external",
+      // `createInertiaApp()`'s `dev` option defaults to `import.meta.env.DEV`, which
+      // Bun leaves in the bundle — so without this the client hooks the DevTools
+      // extension reads are never enabled, and the panel tells you to start a Vite
+      // server that a Zerotal app does not have.
+      define: browserEnvDefines(isProd),
       ...(plugins.length > 0 ? { plugins } : {}),
     });
 

package/src/provider/InertiaProvider.ts

@@ -1,5 +1,10 @@
 import { ServiceProvider, Router, ConfigError, ThrottleMiddleware } from "@zerotal/core";
-import { registerDevBuildHook, pruneBuildOutput, DEV_RELOAD_CLIENT } from "@zerotal/core/dev";
+import {
+  registerDevBuildHook,
+  pruneBuildOutput,
+  browserEnvDefines,
+  DEV_RELOAD_CLIENT,
+} from "@zerotal/core/dev";
 import type { AppEnvironment } from "@zerotal/core";
 import type { ConfigManager } from "@zerotal/core/config";
 import { _setHtmlTemplate, _setPagesDir } from "../inertia.ts";
@@ -123,6 +128,10 @@ export class InertiaProvider extends ServiceProvider {
         splitting: true,
         minify: false,
         sourcemap: "external",
+        // This hook only ever runs under the dev orchestrator, so the build is a
+        // development one by construction — which is what turns on the Inertia
+        // client hooks the DevTools extension reads.
+        define: browserEnvDefines(false),
         ...(plugins.length > 0 ? { plugins } : {}),
       });