@multiplatform.one/core 7.28.1 → 7.29.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multiplatform.one/core",
-  "version": "7.28.1",
+  "version": "7.29.1",
   "description": "Core framework shell, provider composition, and layout factories for multiplatform.one",
   "keywords": [
     "app",
@@ -41,24 +41,24 @@
     "access": "public"
   },
   "dependencies": {
-    "@multiplatform.one/i18n": "7.28.1",
-    "@multiplatform.one/logger": "7.28.1",
-    "@multiplatform.one/platform": "7.28.1",
-    "@multiplatform.one/store": "7.28.1",
-    "@multiplatform.one/theme": "7.28.1",
-    "@tanstack/devtools-event-client": "^0.4.3",
+    "@multiplatform.one/i18n": "7.29.1",
+    "@multiplatform.one/logger": "7.29.1",
+    "@multiplatform.one/platform": "7.29.1",
+    "@multiplatform.one/store": "7.29.1",
+    "@multiplatform.one/theme": "7.29.1",
     "@tanstack/devtools-utils": "^0.4.0",
     "@tanstack/pacer-devtools": "1.3.0",
-    "@tanstack/react-devtools": "^0.10.2",
+    "@tanstack/react-devtools": "0.10.13",
     "@tanstack/react-form-devtools": "0.2.22",
     "react-cookie": "^8.1.2"
   },
   "devDependencies": {
-    "@multiplatform.one/frappe": "7.28.1",
-    "@multiplatform.one/web3": "7.28.1",
+    "@multiplatform.one/frappe": "7.29.1",
+    "@multiplatform.one/web3": "7.29.1",
     "@sentry/react": "^10.51.0",
     "@tanstack/react-query": "^5.100.7",
     "@tanstack/react-query-devtools": "^5.100.7",
+    "@vxrn/color-scheme": "~1.16.5",
     "i18next": "^25.10.10",
     "one": "^1.16.5",
     "react": "19.2.5",
@@ -72,14 +72,13 @@
     "vitest": "^4.1.5"
   },
   "peerDependencies": {
-    "@multiplatform.one/frappe": "^7.28.1",
-    "@multiplatform.one/frappe-ui": "^7.28.1",
-    "@multiplatform.one/keycloak": "^7.28.1",
-    "@multiplatform.one/web3": "^7.28.1",
+    "@multiplatform.one/frappe": "^7.29.1",
+    "@multiplatform.one/frappe-ui": "^7.29.1",
+    "@multiplatform.one/keycloak": "^7.29.1",
+    "@multiplatform.one/web3": "^7.29.1",
     "@sentry/react": "^9.0.0",
     "@tanstack/react-query": "^5.0.0",
     "@tanstack/react-query-devtools": "^5.0.0",
-    "@vxrn/color-scheme": "^1.0.0",
     "expo-font": ">=11.0.0",
     "i18next": "^25.0.0",
     "one": "^1.0.0",
@@ -97,9 +96,6 @@
     "@sentry/react": {
       "optional": true
     },
-    "@vxrn/color-scheme": {
-      "optional": true
-    },
     "i18next": {
       "optional": true
     },

package/src/app/CreateApp.tsx

@@ -103,8 +103,9 @@ export interface TanstackConfig {
   /** Options forwarded to the QueryClient constructor. */
   queryClientOptions?: Record<string, unknown>;
   /**
-   * Pass `useUserScheme` from `one` / `@vxrn/color-scheme` so the theme
-   * devtools panel can control the color scheme (light / dark / system).
+   * Pass `useUserScheme` from `one` so the theme devtools panel can control
+   * the color scheme (light / dark / system). It must be `one`'s: the root
+   * layout paints from that store.
    */
   useUserScheme?: () => {
     setting: "system" | "light" | "dark";

package/src/app/CreateRootLayout.hydration.spec.tsx

@@ -6,12 +6,14 @@ import { describe, expect, it, vi } from "vitest";
 import type { ReactNode } from "react";
 import { createRootLayout } from "./CreateRootLayout.web";
 
-vi.mock("one", () => ({ LoadProgressBar: () => null, Slot: () => null, useMatches: () => [] }));
 vi.mock("tamagui", async () => ({
   useDidFinishSSR: (await import("@tamagui/use-did-finish-ssr")).useDidFinishSSR,
 }));
 const scheme = vi.hoisted(() => ({ value: "light", stored: "dark", system: "dark" }));
-vi.mock("@vxrn/color-scheme", () => ({
+vi.mock("one", () => ({
+  LoadProgressBar: () => null,
+  Slot: () => null,
+  useMatches: () => [],
   SchemeProvider: ({ children }: { children: ReactNode }) => children,
   setUserScheme: (value: string) => {
     scheme.value = value === "system" ? scheme.system : value;

package/src/app/CreateRootLayout.native.tsx

@@ -1,7 +1,6 @@
-import { SchemeProvider, useUserScheme } from "@vxrn/color-scheme";
 import { useFonts } from "expo-font";
 import i18n from "i18next";
-import { Slot, routerStore } from "one";
+import { SchemeProvider, Slot, routerStore, useUserScheme } from "one";
 import type { ComponentType, ReactNode } from "react";
 import { StyleSheet } from "react-native";
 import { GestureHandlerRootView } from "react-native-gesture-handler";
@@ -28,7 +27,7 @@ const styles = StyleSheet.create({
 /**
  * Creates a root layout component for **React Native** (iOS + Android).
  *
- * Handles i18n initialization, color-scheme detection via `@vxrn/color-scheme`,
+ * Handles i18n initialization, color-scheme detection via `one`'s scheme store,
  * and wraps content in `GestureHandlerRootView` → `SafeAreaProvider` →
  * `SchemeProvider` → `AppProvider` → `RootLayout` → `<Slot />`.
  *

package/src/app/CreateRootLayout.schemeClass.spec.tsx

@@ -31,7 +31,12 @@ const env = vi.hoisted(() => {
   return state;
 });
 
-vi.mock("one", () => ({ LoadProgressBar: () => null, Slot: () => null, useMatches: () => [] }));
+vi.mock("one", async () => ({
+  ...(await vi.importActual<typeof import("@vxrn/color-scheme")>("@vxrn/color-scheme")),
+  LoadProgressBar: () => null,
+  Slot: () => null,
+  useMatches: () => [],
+}));
 vi.mock("i18next", () => ({
   default: {
     use: () => ({ init: () => Promise.resolve() }),

package/src/app/CreateRootLayout.schemeInstance.spec.tsx

@@ -0,0 +1,135 @@
+// @vitest-environment jsdom
+/**
+ * MPO-447: an app hands the devtools panel `useUserScheme` from `one`, and the
+ * panel's Scheme knob calls its `set()`. The root layout has to paint from that
+ * same store. When core reached `@vxrn/color-scheme` on its own, shc's lock gave
+ * core 1.16.12 while `one` pins 1.16.5: two stores, one localStorage key. The
+ * click wrote `vxrn-scheme` and `<html>` kept `t_light` until a reload (portal,
+ * console on 7.23.2).
+ *
+ * `one` below re-exports the real store, as the published `one` does. The bare
+ * `@vxrn/color-scheme` specifier is a second copy with its own state, standing
+ * in for the separately resolved one.
+ */
+import type { ReactNode } from "react";
+import { act } from "react";
+import { createRoot } from "react-dom/client";
+import { afterEach, describe, expect, it, vi } from "vitest";
+
+vi.mock("one", async () => ({
+  ...(await vi.importActual<typeof import("@vxrn/color-scheme")>("@vxrn/color-scheme")),
+  LoadProgressBar: () => null,
+  Slot: () => null,
+  useMatches: () => [],
+}));
+vi.mock("@vxrn/color-scheme", async () => {
+  const { useEffect, useLayoutEffect, useReducer } = await import("react");
+  type Setting = "system" | "light" | "dark";
+  let setting: Setting = "light";
+  const listeners = new Set<() => void>();
+  const resolve = () => (setting === "dark" ? "dark" : "light");
+  const setUserScheme = (next: Setting) => {
+    setting = next;
+    for (const listener of listeners) listener();
+  };
+  function useUserScheme() {
+    const [, rerender] = useReducer((n: number) => n + 1, 0);
+    useEffect(() => {
+      listeners.add(rerender);
+      return () => {
+        listeners.delete(rerender);
+      };
+    }, []);
+    return { setting, value: resolve(), set: setUserScheme };
+  }
+  function SchemeProvider({ children }: { children: ReactNode }) {
+    const { value } = useUserScheme();
+    useLayoutEffect(() => {
+      document.documentElement.classList.remove("t_light", "t_dark");
+      document.documentElement.classList.add(`t_${value}`);
+    }, [value]);
+    return children;
+  }
+  return { SchemeProvider, setUserScheme, useUserScheme };
+});
+vi.mock("tamagui", () => ({ useDidFinishSSR: () => true }));
+vi.mock("i18next", () => ({
+  default: {
+    use: () => ({ init: () => Promise.resolve() }),
+    changeLanguage: vi.fn(),
+    language: "en",
+  },
+}));
+vi.mock("react-i18next", () => ({ initReactI18next: {} }));
+vi.mock("@multiplatform.one/platform", () => ({
+  config: { get: (_key: string, fallback?: string) => fallback },
+  isDev: false,
+  platform: { isServer: false },
+}));
+vi.mock("@multiplatform.one/i18n", () => ({ createI18nConfig: () => ({}) }));
+vi.mock("@multiplatform.one/logger", () => ({ logger: { error: vi.fn() } }));
+vi.mock("@multiplatform.one/store", () => ({
+  storage: { getItem: (key: string) => localStorage.getItem(key) },
+}));
+vi.mock("./RuntimePublicConfigScript", () => ({ RuntimePublicConfigScript: () => null }));
+
+vi.stubGlobal("matchMedia", (query: string) => ({
+  matches: false,
+  media: query,
+  addEventListener() {},
+  removeEventListener() {},
+  addListener() {},
+  removeListener() {},
+}));
+
+afterEach(() => {
+  localStorage.clear();
+  document.documentElement.className = "";
+});
+
+describe("the devtools Scheme knob repaints the root live (MPO-447)", () => {
+  it("a set() through one's store flips <html> and the app's scheme without a reload", async () => {
+    localStorage.setItem("vxrn-scheme", "light");
+    const { createRootLayout } = await import("./CreateRootLayout.web");
+    const { useUserScheme } = await import("one");
+    const seen: string[] = [];
+    let setScheme: ((next: "system" | "light" | "dark") => void) | undefined;
+    function Panel() {
+      setScheme = useUserScheme().set;
+      return null;
+    }
+    const Layout = createRootLayout({
+      AppProvider: ({ systemTheme, children }: { systemTheme?: string; children?: ReactNode }) => {
+        seen.push(String(systemTheme));
+        return (
+          <>
+            <Panel />
+            {children}
+          </>
+        );
+      },
+      RootLayout: ({ children }: { children?: ReactNode }) => <>{children}</>,
+      i18n: { languages: ["en"], namespaces: ["common"], defaultLanguage: "en" },
+    } as unknown as Parameters<typeof createRootLayout>[0]);
+
+    const container = document.createElement("div");
+    const root = createRoot(container);
+    await act(async () => {
+      root.render(<Layout />);
+    });
+    expect(document.documentElement.classList.contains("t_light")).toBe(true);
+    expect(seen.at(-1)).toBe("light");
+
+    await act(async () => {
+      setScheme?.("dark");
+    });
+    expect(localStorage.getItem("vxrn-scheme")).toBe("dark");
+    expect(document.documentElement.classList.contains("t_dark")).toBe(true);
+    expect(document.documentElement.classList.contains("t_light")).toBe(false);
+    expect(seen.at(-1)).toBe("dark");
+
+    await act(async () => {
+      root.unmount();
+    });
+  });
+});

package/src/app/CreateRootLayout.web.spec.tsx

@@ -3,8 +3,10 @@ import { describe, expect, it, vi } from "vitest";
 import type { ReactNode } from "react";
 import { createRootLayout } from "./CreateRootLayout.web";
 
-vi.mock("one", () => ({ LoadProgressBar: () => null, Slot: () => null, useMatches: () => [] }));
-vi.mock("@vxrn/color-scheme", () => ({
+vi.mock("one", () => ({
+  LoadProgressBar: () => null,
+  Slot: () => null,
+  useMatches: () => [],
   SchemeProvider: ({ children }: { children: ReactNode }) => children,
   setUserScheme: vi.fn(),
   useUserScheme: () => ({ value: "light" }),

package/src/app/CreateRootLayout.web.tsx

@@ -1,7 +1,16 @@
 import i18n from "i18next";
 import { useDidFinishSSR } from "tamagui";
-import { LoadProgressBar, Slot, useMatches } from "one";
-import { SchemeProvider, setUserScheme, useUserScheme } from "@vxrn/color-scheme";
+// The scheme store comes through `one`, never a bare `@vxrn/color-scheme`: apps
+// hand the devtools panel `one`'s `useUserScheme`, and a second resolved copy
+// of the store would paint <html> from state the panel never writes (MPO-447).
+import {
+  LoadProgressBar,
+  SchemeProvider,
+  Slot,
+  setUserScheme,
+  useMatches,
+  useUserScheme,
+} from "one";
 import type { ComponentType, ReactNode } from "react";
 import { CookiesProvider, Cookies } from "react-cookie";
 import { initReactI18next } from "react-i18next";

package/src/app/TanstackDevtools.tsx

@@ -14,7 +14,12 @@ import { ThemeDevtoolsPanel } from "@multiplatform.one/theme";
 import { storage } from "@multiplatform.one/store";
 import { useEffect, useState } from "react";
 import type { TanstackConfig } from "./CreateApp";
-import { devtoolsOpenHotkey, useDevtoolsKeyboardTrigger, useShakeToOpen } from "./devtoolsTrigger";
+import {
+  devtoolsOpenHotkey,
+  useDevtoolsKeyboardTrigger,
+  useDevtoolsOpenRequests,
+  useShakeToOpen,
+} from "./devtoolsTrigger";
 
 const devtoolsSettingsKey = "tanstack_devtools_settings";
 
@@ -136,6 +141,7 @@ export default function TanstackDevtoolsWrapper({
   // Cmd/Ctrl+Shift+` — capture-phase so apps cannot swallow it. TanStack
   // still receives openHotkey (US-layout e.key sequence) as a fallback.
   useDevtoolsKeyboardTrigger(true);
+  const openRequests = useDevtoolsOpenRequests();
 
   const plugins = [
     {
@@ -179,7 +185,7 @@ export default function TanstackDevtoolsWrapper({
 
   return (
     <TanStackDevtools
-      key={resolvedScheme}
+      key={`${resolvedScheme}:${openRequests}`}
       config={{
         defaultOpen: false,
         triggerHidden: true,

package/src/app/devtoolsTrigger.spec.ts

@@ -14,9 +14,10 @@ import {
   devtoolsArmMotionEvent,
   devtoolsMotionArmedEvent,
   devtoolsOpenHotkey,
-  devtoolsShellPluginId,
-  devtoolsTriggerToggledEvent,
+  devtoolsOpenRequestEvent,
+  devtoolsShellStateKey,
   isDevtoolsOpenHotkeyEvent,
+  isDevtoolsShellOpen,
   isMotionPermissionRequired,
   motionMagnitude,
   openDevtoolsShell,
@@ -284,42 +285,75 @@ describe("createMotionPermissionFlow", () => {
   });
 });
 
-describe("openDevtoolsShell", () => {
+/** A localStorage stand-in holding the shell's persisted state. */
+function memoryStorage(initial?: Record<string, unknown>) {
+  const values = new Map<string, string>();
+  if (initial) values.set(devtoolsShellStateKey, JSON.stringify(initial));
+  return {
+    getItem: (key: string) => values.get(key) ?? null,
+    setItem: (key: string, value: string) => {
+      values.set(key, value);
+    },
+    state: () => JSON.parse(values.get(devtoolsShellStateKey) ?? "null"),
+  };
+}
+
+describe("openDevtoolsShell (MPO-447)", () => {
+  const realWindow = (globalThis as { window?: unknown }).window;
+
   afterEach(() => {
-    (globalThis as { __TANSTACK_EVENT_TARGET__?: EventTarget | null }).__TANSTACK_EVENT_TARGET__ =
-      null;
+    (globalThis as { window?: unknown }).window = realWindow;
   });
 
-  it("emits the shell's trigger-toggled open event on the devtools bus", () => {
-    const bus = new EventTarget();
-    (globalThis as { __TANSTACK_EVENT_TARGET__?: EventTarget | null }).__TANSTACK_EVENT_TARGET__ =
-      bus;
-    // Play the shell's side of the connect handshake.
-    bus.addEventListener("tanstack-connect", () => {
-      bus.dispatchEvent(new CustomEvent("tanstack-connect-success"));
-    });
-    const received: Array<{ type: string; payload: { isOpen: boolean } }> = [];
-    bus.addEventListener("tanstack-dispatch-event", (event) => {
-      received.push((event as CustomEvent).detail);
-    });
-    openDevtoolsShell();
-    expect(received).toHaveLength(1);
-    expect(received[0]).toMatchObject({
-      type: `${devtoolsShellPluginId}:${devtoolsTriggerToggledEvent}`,
-      payload: { isOpen: true },
-    });
-    // Once connected, later shakes emit directly (open-only, never close).
-    openDevtoolsShell();
-    expect(received).toHaveLength(2);
-    expect(received[1]?.payload).toEqual({ isOpen: true });
+  function stubWindow() {
+    const win = new EventTarget();
+    (globalThis as { window?: unknown }).window = win;
+    const requests = vi.fn();
+    win.addEventListener(devtoolsOpenRequestEvent, requests);
+    return requests;
+  }
+
+  it("marks a closed shell open for its next mount and asks for that mount", () => {
+    const requests = stubWindow();
+    const storage = memoryStorage({ persistOpen: false, layout: { tab: "theme" } });
+    openDevtoolsShell(storage);
+    expect(storage.state()).toEqual({ persistOpen: true, layout: { tab: "theme" } });
+    expect(isDevtoolsShellOpen(storage)).toBe(true);
+    expect(requests).toHaveBeenCalledTimes(1);
+  });
+
+  it("opens a shell that never persisted any state", () => {
+    const requests = stubWindow();
+    const storage = memoryStorage();
+    openDevtoolsShell(storage);
+    expect(storage.state()).toEqual({ persistOpen: true });
+    expect(requests).toHaveBeenCalledTimes(1);
+  });
+
+  it("leaves an open shell alone, so a continued shake never remounts or closes it", () => {
+    const requests = stubWindow();
+    const storage = memoryStorage({ persistOpen: true });
+    openDevtoolsShell(storage);
+    openDevtoolsShell(storage);
+    expect(storage.state()).toEqual({ persistOpen: true });
+    expect(requests).not.toHaveBeenCalled();
+  });
+
+  it("recovers from unreadable state instead of throwing", () => {
+    const requests = stubWindow();
+    const storage = memoryStorage();
+    storage.setItem(devtoolsShellStateKey, "{not json");
+    openDevtoolsShell(storage);
+    expect(storage.state()).toEqual({ persistOpen: true });
+    expect(requests).toHaveBeenCalledTimes(1);
   });
 });
 
 describe("upstream contract (installed packages)", () => {
-  // The trigger-toggled bus event is an internal implementation detail of
-  // @tanstack/devtools, not documented public API. Pin it against the
-  // installed packages so an upstream rename fails tests instead of
-  // silently breaking shake-to-open.
+  // The shell has no public open call. What this code relies on is how the
+  // installed shell decides it is open when it mounts, so pin that against
+  // the installed packages: an upstream change fails tests instead of
+  // silently breaking the shortcut and shake-to-open again.
   /**
    * Locate an installed package dir regardless of linker layout: walk
    * ancestor node_modules (hoisted puts everything at the repo root),
@@ -342,26 +376,82 @@ describe("upstream contract (installed packages)", () => {
     return null;
   }
 
-  it("@tanstack/devtools still listens for the trigger-toggled event", () => {
+  function shellDir(): string {
     const reactDevtoolsDir = findInstalled("@tanstack/react-devtools");
     expect(reactDevtoolsDir).toBeTruthy();
     const devtoolsDir = findInstalled("@tanstack/devtools", reactDevtoolsDir as string);
     expect(devtoolsDir).toBeTruthy();
-    const chunkDir = join(devtoolsDir as string, "dist", "devtools");
-    const chunks = readdirSync(chunkDir).filter((f) => f.endsWith(".js"));
-    const hit = chunks.some((f) =>
-      readFileSync(join(chunkDir, f), "utf8").includes(`"${devtoolsTriggerToggledEvent}"`),
-    );
-    expect(hit).toBe(true);
+    return devtoolsDir as string;
+  }
+
+  function distSources(dir: string): string[] {
+    const out: string[] = [];
+    for (const sub of ["devtools", "chunk"]) {
+      const subDir = join(dir, "dist", sub);
+      if (!existsSync(subDir)) continue;
+      for (const file of readdirSync(subDir).filter((f) => f.endsWith(".js"))) {
+        out.push(readFileSync(join(subDir, file), "utf8"));
+      }
+    }
+    return out;
+  }
+
+  it("core pins the shell exactly, and the installed shell is that pin", () => {
+    // A range let shc resolve 0.10.10 while this spec ran against 0.10.2, and
+    // the difference was the whole bug. An exact pin makes an app resolve
+    // the version these contracts were checked on.
+    const pkg = JSON.parse(readFileSync(join(here, "..", "..", "package.json"), "utf8")) as {
+      dependencies: Record<string, string>;
+    };
+    const pinned = pkg.dependencies["@tanstack/react-devtools"];
+    expect(pinned).toMatch(/^\d+\.\d+\.\d+$/);
+    const installed = JSON.parse(
+      readFileSync(
+        join(findInstalled("@tanstack/react-devtools") as string, "package.json"),
+        "utf8",
+      ),
+    ) as { version: string };
+    expect(installed.version).toBe(pinned);
   });
 
-  it("@tanstack/devtools-client still uses the tanstack-devtools-core plugin id", () => {
-    const reactDevtoolsDir = findInstalled("@tanstack/react-devtools");
-    const devtoolsDir = findInstalled("@tanstack/devtools", reactDevtoolsDir as string);
-    const clientDir = findInstalled("@tanstack/devtools-client", devtoolsDir as string);
+  it("the shell stores its state under tanstack_devtools_state", () => {
+    const sources = distSources(shellDir());
+    expect(sources.some((src) => src.includes(`"${devtoolsShellStateKey}"`))).toBe(true);
+  });
+
+  it("a mounting shell opens from persistOpen in that state", () => {
+    const sources = distSources(shellDir());
+    expect(
+      sources.some((src) =>
+        /createSignal\(\s*settings\(\)\.defaultOpen\s*\|\|\s*persistOpen\(\)\s*\)/.test(src),
+      ),
+    ).toBe(true);
+  });
+
+  it("the shell's own event client is inert outside development, so an open cannot ride the bus", async () => {
+    // vitest runs with NODE_ENV !== "development", as a deployed bundle does.
+    // From @tanstack/devtools-event-client 0.5 the shell's client is the NoOp
+    // there: its trigger-toggled subscription registers nothing. If this
+    // fails, upstream dropped the gate and the bus would work again.
+    const clientDir = findInstalled("@tanstack/devtools-client", shellDir());
     expect(clientDir).toBeTruthy();
-    const source = readFileSync(join(clientDir as string, "dist", "esm", "index.js"), "utf8");
-    expect(source).toContain(`pluginId: "${devtoolsShellPluginId}"`);
+    const target = new EventTarget();
+    const added = vi.spyOn(target, "addEventListener");
+    const previous = (globalThis as { __TANSTACK_EVENT_TARGET__?: EventTarget | null })
+      .__TANSTACK_EVENT_TARGET__;
+    (globalThis as { __TANSTACK_EVENT_TARGET__?: EventTarget | null }).__TANSTACK_EVENT_TARGET__ =
+      target;
+    try {
+      const client = await import(
+        pathToFileURL(join(clientDir as string, "dist", "esm", "index.js")).href
+      );
+      const unsubscribe = client.devtoolsEventClient.on("trigger-toggled", () => {});
+      expect(added).not.toHaveBeenCalled();
+      unsubscribe();
+    } finally {
+      (globalThis as { __TANSTACK_EVENT_TARGET__?: EventTarget | null }).__TANSTACK_EVENT_TARGET__ =
+        previous;
+    }
   });
 
   it("@tanstack/pacer-devtools/production resolves the REAL core, not the NoOp", async () => {
@@ -502,6 +592,16 @@ describe("devtools shell wiring", () => {
     expect(shellSource).toContain("useDevtoolsKeyboardTrigger(");
   });
 
+  it("the shortcut and a shake open through openDevtoolsShell, and a request remounts the shell", () => {
+    expect(triggerSource).toMatch(
+      /if \(!isDevtoolsOpenHotkeyEvent\(event\)\) return;[\s\S]*?openDevtoolsShell\(\);/,
+    );
+    expect(triggerSource).toContain("onShake: () => void = openDevtoolsShell");
+    expect(shellSource).toContain("const openRequests = useDevtoolsOpenRequests();");
+    expect(shellSource).toContain("key={`${resolvedScheme}:${openRequests}`}");
+    expect(triggerSource).not.toContain('from "@tanstack/devtools-event-client"');
+  });
+
   it("mounts shake-to-open with the config opt-out", () => {
     expect(shellSource).toContain("useShakeToOpen(tanstackConfig.shakeToOpen !== false)");
   });

package/src/app/devtoolsTrigger.ts

@@ -1,5 +1,4 @@
-import { EventClient } from "@tanstack/devtools-event-client";
-import { useEffect } from "react";
+import { useEffect, useState } from "react";
 
 // ---------------------------------------------------------------------------
 // Keyboard trigger
@@ -41,7 +40,7 @@ export function isDevtoolsOpenHotkeyEvent(event: KeyboardEvent): boolean {
  * shortcut. Capture runs before app-level keydown handlers, so a page
  * that stopPropagation's cannot swallow it. preventDefault +
  * stopImmediatePropagation keep TanStack's own createShortcut from
- * also firing (which would toggle the panel shut again).
+ * also firing, which would toggle the shell it is about to replace.
  */
 export function useDevtoolsKeyboardTrigger(enabled: boolean) {
   useEffect(() => {
@@ -58,41 +57,86 @@ export function useDevtoolsKeyboardTrigger(enabled: boolean) {
 }
 
 // ---------------------------------------------------------------------------
-// Programmatic open — the same event the devtools shell's own trigger emits
+// Programmatic open: persist the shell's open state, then remount it
 // ---------------------------------------------------------------------------
 
 /**
- * Plugin id of the TanStack Devtools shell's internal event client
- * (`devtoolsEventClient` in `@tanstack/devtools-client`). The shell
- * subscribes to `<pluginId>:trigger-toggled` and opens/closes on the
- * payload's `isOpen`. The spec asserts both strings
- * against the installed packages so an upstream rename fails the build
- * instead of silently breaking shake-to-open.
+ * localStorage key the TanStack Devtools shell keeps its own state under. A
+ * mounting shell opens when this state's `persistOpen` is true.
  */
-export const devtoolsShellPluginId = "tanstack-devtools-core";
+export const devtoolsShellStateKey = "tanstack_devtools_state";
 
-/** Event suffix the shell listens on for open/close state changes. */
-export const devtoolsTriggerToggledEvent = "trigger-toggled";
+/**
+ * Window event `openDevtoolsShell` dispatches once it has marked the shell
+ * open. The shell wrapper remounts on it (`useDevtoolsOpenRequests`).
+ */
+export const devtoolsOpenRequestEvent = "mpo:devtools-open";
+
+interface ShellStorage {
+  getItem(key: string): string | null;
+  setItem(key: string, value: string): void;
+}
+
+function shellStorage(): ShellStorage | undefined {
+  try {
+    return typeof localStorage === "undefined" ? undefined : localStorage;
+  } catch {
+    return undefined;
+  }
+}
+
+function readShellState(storage: ShellStorage): Record<string, unknown> {
+  try {
+    const parsed: unknown = JSON.parse(storage.getItem(devtoolsShellStateKey) ?? "null");
+    return parsed && typeof parsed === "object" ? (parsed as Record<string, unknown>) : {};
+  } catch {
+    return {};
+  }
+}
 
-interface DevtoolsShellEventMap {
-  "trigger-toggled": { isOpen: boolean };
+/** True when the shell's persisted state says it is open. */
+export function isDevtoolsShellOpen(storage: ShellStorage | undefined = shellStorage()): boolean {
+  return storage ? readShellState(storage).persistOpen === true : false;
 }
 
-let shellEventClient: EventClient<DevtoolsShellEventMap> | undefined;
+/**
+ * Open the TanStack Devtools shell. Open-only by design: a continued shake
+ * must not re-close the panel, so an open shell is left alone and closing
+ * stays on the close button and Escape.
+ *
+ * The shell exposes no open call, and from `@tanstack/devtools-event-client`
+ * 0.5 its `trigger-toggled` listener is a no-op in every build but
+ * development, so an emitted open never reached a deployed app (MPO-447). What
+ * every shell version does read is `persistOpen` in its stored state, on
+ * mount. This writes it and asks the wrapper to remount the shell.
+ */
+export function openDevtoolsShell(storage: ShellStorage | undefined = shellStorage()): void {
+  if (!storage || isDevtoolsShellOpen(storage)) return;
+  try {
+    storage.setItem(
+      devtoolsShellStateKey,
+      JSON.stringify({ ...readShellState(storage), persistOpen: true }),
+    );
+  } catch {
+    return;
+  }
+  if (typeof window !== "undefined") window.dispatchEvent(new Event(devtoolsOpenRequestEvent));
+}
 
 /**
- * Open the TanStack Devtools shell programmatically by emitting the same
- * bus event the shell's own (hidden) trigger button uses. Open-only by
- * design: a continued shake must not immediately re-close the panel —
- * closing stays on the close button / Escape / the keyboard shortcut.
- * The event client queues emits until the bus connects, so an early shake
- * racing the shell mount is still delivered.
+ * Counts open requests since mount. The shell wrapper folds it into the
+ * shell's React key, so each request mounts a fresh shell that reads the
+ * `persistOpen` `openDevtoolsShell` just wrote.
  */
-export function openDevtoolsShell() {
-  shellEventClient ??= new EventClient<DevtoolsShellEventMap>({
-    pluginId: devtoolsShellPluginId,
-  });
-  shellEventClient.emit(devtoolsTriggerToggledEvent, { isOpen: true });
+export function useDevtoolsOpenRequests(): number {
+  const [requests, setRequests] = useState(0);
+  useEffect(() => {
+    if (typeof window === "undefined") return;
+    const onRequest = () => setRequests((n) => n + 1);
+    window.addEventListener(devtoolsOpenRequestEvent, onRequest);
+    return () => window.removeEventListener(devtoolsOpenRequestEvent, onRequest);
+  }, []);
+  return requests;
 }
 
 // ---------------------------------------------------------------------------

package/types/app/CreateApp.d.ts

@@ -49,8 +49,9 @@ export interface TanstackConfig {
     /** Options forwarded to the QueryClient constructor. */
     queryClientOptions?: Record<string, unknown>;
     /**
-     * Pass `useUserScheme` from `one` / `@vxrn/color-scheme` so the theme
-     * devtools panel can control the color scheme (light / dark / system).
+     * Pass `useUserScheme` from `one` so the theme devtools panel can control
+     * the color scheme (light / dark / system). It must be `one`'s: the root
+     * layout paints from that store.
      */
     useUserScheme?: () => {
         setting: "system" | "light" | "dark";

package/types/app/CreateApp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CreateApp.d.ts","sourceRoot":"","sources":["../../src/app/CreateApp.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"CreateApp.d.ts","sourceRoot":"","sources":["../../src/app/CreateApp.tsx"],"names":[],"mappings":"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"}

package/types/app/CreateRootLayout.native.d.ts

@@ -4,7 +4,7 @@ export type { CreateRootLayoutConfig, HeadConfig, RootLayoutProps, RootLoaderDat
 /**
  * Creates a root layout component for **React Native** (iOS + Android).
  *
- * Handles i18n initialization, color-scheme detection via `@vxrn/color-scheme`,
+ * Handles i18n initialization, color-scheme detection via `one`'s scheme store,
  * and wraps content in `GestureHandlerRootView` → `SafeAreaProvider` →
  * `SchemeProvider` → `AppProvider` → `RootLayout` → `<Slot />`.
  *

package/types/app/CreateRootLayout.native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CreateRootLayout.native.d.ts","sourceRoot":"","sources":["../../src/app/CreateRootLayout.native.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,OAAO,CAAC;AAQtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAGjE,YAAY,EACV,sBAAsB,EACtB,UAAU,EACV,eAAe,EACf,cAAc,EACd,YAAY,GACb,MAAM,oBAAoB,CAAC;AAM5B;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,sBAAsB,GAAG,aAAa,CA+D3E"}
+{"version":3,"file":"CreateRootLayout.native.d.ts","sourceRoot":"","sources":["../../src/app/CreateRootLayout.native.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,OAAO,CAAC;AAQtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAGjE,YAAY,EACV,sBAAsB,EACtB,UAAU,EACV,eAAe,EACf,cAAc,EACd,YAAY,GACb,MAAM,oBAAoB,CAAC;AAM5B;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,sBAAsB,GAAG,aAAa,CA+D3E"}

package/types/app/CreateRootLayout.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CreateRootLayout.web.d.ts","sourceRoot":"","sources":["../../src/app/CreateRootLayout.web.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,OAAO,CAAC;AAQtD,OAAO,KAAK,EAAE,sBAAsB,EAAkB,MAAM,oBAAoB,CAAC;AAEjF,YAAY,EACV,sBAAsB,EACtB,UAAU,EACV,eAAe,EACf,cAAc,EACd,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,sBAAsB,GAAG,aAAa,CAqL3E"}
+{"version":3,"file":"CreateRootLayout.web.d.ts","sourceRoot":"","sources":["../../src/app/CreateRootLayout.web.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,OAAO,CAAC;AAQtD,OAAO,KAAK,EAAE,sBAAsB,EAAkB,MAAM,oBAAoB,CAAC;AAEjF,YAAY,EACV,sBAAsB,EACtB,UAAU,EACV,eAAe,EACf,cAAc,EACd,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,sBAAsB,GAAG,aAAa,CAqL3E"}

package/types/app/TanstackDevtools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TanstackDevtools.d.ts","sourceRoot":"","sources":["../../src/app/TanstackDevtools.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAoClD,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,OAAO,GAAG,MAAM,CAAC;IACjC,cAAc,EAAE,cAAc,CAAC;CAChC;AAkED,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,EAC9C,cAAc,EACd,cAAc,GACf,EAAE,qBAAqB,2CAoEvB"}
+{"version":3,"file":"TanstackDevtools.d.ts","sourceRoot":"","sources":["../../src/app/TanstackDevtools.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAyClD,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,OAAO,GAAG,MAAM,CAAC;IACjC,cAAc,EAAE,cAAc,CAAC;CAChC;AAkED,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,EAC9C,cAAc,EACd,cAAc,GACf,EAAE,qBAAqB,2CAqEvB"}

package/types/app/devtoolsTrigger.d.ts

@@ -26,29 +26,43 @@ export declare function isDevtoolsOpenHotkeyEvent(event: KeyboardEvent): boolean
  * shortcut. Capture runs before app-level keydown handlers, so a page
  * that stopPropagation's cannot swallow it. preventDefault +
  * stopImmediatePropagation keep TanStack's own createShortcut from
- * also firing (which would toggle the panel shut again).
+ * also firing, which would toggle the shell it is about to replace.
  */
 export declare function useDevtoolsKeyboardTrigger(enabled: boolean): void;
 /**
- * Plugin id of the TanStack Devtools shell's internal event client
- * (`devtoolsEventClient` in `@tanstack/devtools-client`). The shell
- * subscribes to `<pluginId>:trigger-toggled` and opens/closes on the
- * payload's `isOpen`. The spec asserts both strings
- * against the installed packages so an upstream rename fails the build
- * instead of silently breaking shake-to-open.
- */
-export declare const devtoolsShellPluginId = "tanstack-devtools-core";
-/** Event suffix the shell listens on for open/close state changes. */
-export declare const devtoolsTriggerToggledEvent = "trigger-toggled";
-/**
- * Open the TanStack Devtools shell programmatically by emitting the same
- * bus event the shell's own (hidden) trigger button uses. Open-only by
- * design: a continued shake must not immediately re-close the panel —
- * closing stays on the close button / Escape / the keyboard shortcut.
- * The event client queues emits until the bus connects, so an early shake
- * racing the shell mount is still delivered.
- */
-export declare function openDevtoolsShell(): void;
+ * localStorage key the TanStack Devtools shell keeps its own state under. A
+ * mounting shell opens when this state's `persistOpen` is true.
+ */
+export declare const devtoolsShellStateKey = "tanstack_devtools_state";
+/**
+ * Window event `openDevtoolsShell` dispatches once it has marked the shell
+ * open. The shell wrapper remounts on it (`useDevtoolsOpenRequests`).
+ */
+export declare const devtoolsOpenRequestEvent = "mpo:devtools-open";
+interface ShellStorage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+}
+/** True when the shell's persisted state says it is open. */
+export declare function isDevtoolsShellOpen(storage?: ShellStorage | undefined): boolean;
+/**
+ * Open the TanStack Devtools shell. Open-only by design: a continued shake
+ * must not re-close the panel, so an open shell is left alone and closing
+ * stays on the close button and Escape.
+ *
+ * The shell exposes no open call, and from `@tanstack/devtools-event-client`
+ * 0.5 its `trigger-toggled` listener is a no-op in every build but
+ * development, so an emitted open never reached a deployed app (MPO-447). What
+ * every shell version does read is `persistOpen` in its stored state, on
+ * mount. This writes it and asks the wrapper to remount the shell.
+ */
+export declare function openDevtoolsShell(storage?: ShellStorage | undefined): void;
+/**
+ * Counts open requests since mount. The shell wrapper folds it into the
+ * shell's React key, so each request mounts a fresh shell that reads the
+ * `persistOpen` `openDevtoolsShell` just wrote.
+ */
+export declare function useDevtoolsOpenRequests(): number;
 /** Defaults: deliberate shakes peak 15–25 m/s²; walking/bumps stay under ~8. */
 export declare const shakeDefaults: {
     /** m/s² a sample must exceed to count as a shake peak. */

package/types/app/devtoolsTrigger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"devtoolsTrigger.d.ts","sourceRoot":"","sources":["../../src/app/devtoolsTrigger.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"devtoolsTrigger.d.ts","sourceRoot":"","sources":["../../src/app/devtoolsTrigger.ts"],"names":[],"mappings":"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"}