@noego/wood 0.4.7 → 0.4.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noego/wood",
-  "version": "0.4.7",
+  "version": "0.4.8",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -20,9 +20,11 @@
     "loaders",
     "docs",
     "src/components/",
+    "src/client/app_env.ts",
     "src/client/controller_contract.ts",
     "src/controller/controller_lifecycle.ts",
-    "src/navigation/navigation_identity.ts"
+    "src/navigation/navigation_identity.ts",
+    "src/runtime/app_env.ts"
   ],
   "exports": {
     ".": {

package/src/client/app_env.ts

@@ -0,0 +1,21 @@
+import type { WoodAppEnv } from '../runtime/app_env.js';
+
+export type { WoodAppEnv };
+
+// Stored on globalThis because this module is loaded twice at runtime: once in
+// wood's bundled dist (startWood) and once as raw source via the Svelte
+// component exports (NavigationShell); a module-local variable would not be shared.
+const CLIENT_APP_ENV_SYMBOL = Symbol.for('@noego/wood.client.app-env');
+
+type GlobalWithAppEnv = typeof globalThis & { [CLIENT_APP_ENV_SYMBOL]?: WoodAppEnv };
+
+export function setWoodAppEnv(value: unknown): void {
+  if (value === 'dev' || value === 'local' || value === 'packaged') {
+    (globalThis as GlobalWithAppEnv)[CLIENT_APP_ENV_SYMBOL] = value;
+  }
+}
+
+/** Environment tier of the running app, resolved by the main process during startWood boot. */
+export function getWoodAppEnv(): WoodAppEnv {
+  return (globalThis as GlobalWithAppEnv)[CLIENT_APP_ENV_SYMBOL] ?? 'packaged';
+}

package/src/runtime/app_env.ts

@@ -0,0 +1,27 @@
+export type WoodAppEnv = 'dev' | 'local' | 'packaged';
+
+/**
+ * Resolve the runtime environment tier for the running app:
+ * - 'dev'      — launched via `wood dev` (WOOD_MODE=development in the env)
+ * - 'local'    — built output run directly (`electron .`), not packaged
+ * - 'packaged' — installed/packaged app (electron-forge etc.)
+ */
+export async function resolveWoodAppEnv(
+  env: NodeJS.ProcessEnv = process.env,
+): Promise<WoodAppEnv> {
+  // ELECTRON_RENDERER_URL is set by electron-vite dev (same signal wood uses to
+  // choose loadURL vs loadFile); WOOD_MODE covers the wood CLI child env.
+  if (env.WOOD_MODE === 'development' || env.ELECTRON_RENDERER_URL) {
+    return 'dev';
+  }
+  try {
+    const electron = await import('electron');
+    const app = (electron as { app?: { isPackaged?: boolean } }).app;
+    if (app && app.isPackaged === false) {
+      return 'local';
+    }
+  } catch {
+    // Electron unavailable (tests/node) — treat as packaged so no ribbon shows.
+  }
+  return 'packaged';
+}