@cosmicdrift/kumiko-renderer-web 0.154.2 → 0.155.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-renderer-web",
-  "version": "0.154.2",
+  "version": "0.155.1",
   "description": "Web-platform bindings for @cosmicdrift/kumiko-renderer. HTML default-primitives, browser history-based navigation, EventSource-backed live events, and a one-call createKumikoApp that mounts the whole stack via react-dom.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -16,9 +16,9 @@
     "./styles.css": "./src/styles.css"
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-dispatcher-live": "0.154.2",
-    "@cosmicdrift/kumiko-headless": "0.154.2",
-    "@cosmicdrift/kumiko-renderer": "0.154.2",
+    "@cosmicdrift/kumiko-dispatcher-live": "0.155.1",
+    "@cosmicdrift/kumiko-headless": "0.155.1",
+    "@cosmicdrift/kumiko-renderer": "0.155.1",
     "@radix-ui/react-dialog": "^1.1.15",
     "@radix-ui/react-dropdown-menu": "^2.1.16",
     "@radix-ui/react-label": "^2.1.8",

package/src/app/browser-locale.ts

@@ -67,7 +67,7 @@ export function createBrowserLocaleResolver(
     timeZone: () => timeZone,
     subscribe: store.subscribe,
     setLocale: (next) => {
-      // Early-Return so we don't write localStorage on a no-op. Store's
+      // skip: locale unchanged, avoid redundant localStorage write
       // own Object.is-Gate would already block listener notification,
       // but the persistence side-effect lives outside the store.
       if (next === store.getSnapshot()) return;

package/src/sse/live-events.ts

@@ -41,7 +41,7 @@ export function createEventSourceLiveEvents(
     try {
       parsed = JSON.parse(raw) as LiveEvent["data"];
     } catch {
-      // Malformed payload — drop it. Besser als einen fangenden Listener
+      // skip: malformed SSE payload, drop it rather than crash all subscribers
       // zu crashen und alle anderen subscribers mitzureißen.
       return;
     }
@@ -52,12 +52,15 @@ export function createEventSourceLiveEvents(
   };
 
   const ensureConnected = (): void => {
+    // skip: EventSource already connected
     if (source !== undefined) return;
+    // skip: no window/EventSource available (SSR/non-browser), nothing to connect
     if (typeof window === "undefined" || typeof EventSource === "undefined") return;
     source = new EventSource(url);
   };
 
   const ensureListenersForEntity = (entityName: string): void => {
+    // skip: not connected yet, listeners get wired once ensureConnected runs
     if (source === undefined) return;
     for (const verb of VERBS) {
       const type = `${entityName}.${verb}`;
@@ -70,7 +73,9 @@ export function createEventSourceLiveEvents(
   };
 
   const closeIfEmpty = (): void => {
+    // skip: subscribers remain, connection still needed
     if (subscribers.size > 0) return;
+    // skip: already closed, nothing to close
     if (source === undefined) return;
     source.close();
     source = undefined;

package/src/tokens.ts

@@ -55,6 +55,7 @@ function persistMode(mode: ThemeMode): void {
  *  in der Host-HTML (siehe Header-Kommentar) macht dasselbe synchron
  *  vor dem ersten Paint. */
 export function applyStoredThemeMode(): void {
+  // skip: no document (SSR/non-DOM context), nothing to apply
   if (typeof document === "undefined") return;
   let stored: string | null = null;
   try {
@@ -63,6 +64,7 @@ export function applyStoredThemeMode(): void {
     // skip: localStorage kann werfen (Private-Mode) — ohne gespeicherte
     // Wahl bleibt der Server-/HTML-Default stehen.
   }
+  // skip: no valid persisted mode stored, keep server/HTML default
   if (stored !== "dark" && stored !== "light") return;
   document.documentElement.classList.toggle("dark", stored === "dark");
   notifyThemeChange();
@@ -99,12 +101,14 @@ export function useBrowserTokensApi(): TokensApi {
     tokens: cssVarTokens,
     mode,
     setMode: (next) => {
+      // skip: no document (SSR/non-DOM context), nothing to toggle
       if (typeof document === "undefined") return;
       document.documentElement.classList.toggle("dark", next === "dark");
       persistMode(next);
       notifyThemeChange();
     },
     toggleMode: () => {
+      // skip: no document (SSR/non-DOM context), nothing to toggle
       if (typeof document === "undefined") return;
       const nowDark = document.documentElement.classList.toggle("dark");
       persistMode(nowDark ? "dark" : "light");