test(v7-h02): localStorage shim + hydration test un-skip

vbgui/tests/setup.ts: full Storage shim when jsdom omits localStorage
or supplies a non-Storage stub, exposed on both globalThis and window.

vbgui/tests/useProjects.test.tsx: the hydration test is no longer
skipped — with the shim it observes the persisted entry across
renderHook calls (waitFor on vbgui_projects_v1 before unmount).

vbgui/vite.config.ts: set jsdom URL so localStorage origin is stable
across test files (Storage is keyed by origin in jsdom).

Author: apstenku123

vbgui/tests/setup.ts

@@ -18,3 +18,45 @@ if (!("DOMMatrixReadOnly" in globalThis)) {
   (globalThis as unknown as { DOMMatrixReadOnly: unknown }).DOMMatrixReadOnly =
     DOMMatrixReadOnlyShim;
 }
+
+function hasUsableStorage(storage: Storage | undefined): storage is Storage {
+  return storage != null &&
+    typeof storage.getItem === "function" &&
+    typeof storage.setItem === "function" &&
+    typeof storage.removeItem === "function" &&
+    typeof storage.clear === "function";
+}
+
+if (!hasUsableStorage(globalThis.localStorage)) {
+  const values = new Map<string, string>();
+  const storage: Storage = {
+    get length() {
+      return values.size;
+    },
+    clear() {
+      values.clear();
+    },
+    getItem(key: string) {
+      return values.get(key) ?? null;
+    },
+    key(index: number) {
+      return Array.from(values.keys())[index] ?? null;
+    },
+    removeItem(key: string) {
+      values.delete(key);
+    },
+    setItem(key: string, value: string) {
+      values.set(key, value);
+    },
+  };
+  Object.defineProperty(globalThis, "localStorage", {
+    configurable: true,
+    value: storage,
+  });
+  if (typeof window !== "undefined") {
+    Object.defineProperty(window, "localStorage", {
+      configurable: true,
+      value: storage,
+    });
+  }
+}

vbgui/tests/useProjects.test.tsx

@@ -1,5 +1,5 @@
 import { describe, it, expect, beforeEach } from "vitest";
-import { renderHook, act } from "@testing-library/react";
+import { renderHook, act, waitFor } from "@testing-library/react";
 import { useProjects } from "@/hooks/useProjects";
 
 describe("V7-H02 useProjects", () => {
@@ -76,10 +76,14 @@ describe("V7-H02 useProjects", () => {
     expect(aa?.payload).toEqual({ v: 1 });
   });
 
-  it.skip("hydrates from localStorage on next mount (jsdom stub does not persist across renderHook)", () => {
+  it("hydrates from localStorage on next mount", async () => {
     const { result, unmount } = renderHook(
       () => useProjects<{ v: number }>());
     act(() => { result.current.create("alpha", { v: 1 }); });
+    await waitFor(() => {
+      expect(window.localStorage.getItem("vbgui_projects_v1"))
+        .not.toBeNull();
+    });
     unmount();
     // Fresh mount — should see the persisted project.
     const { result: r2 } = renderHook(

vbgui/vite.config.ts

@@ -10,6 +10,9 @@ export default defineConfig({
   server: { port: 5173, strictPort: false },
   test: {
     environment: "jsdom",
+    environmentOptions: {
+      jsdom: { url: "http://localhost/" },
+    },
     globals: true,
     setupFiles: ["tests/setup.ts"],
     css: false,