@rohal12/spindle 0.43.6 → 0.44.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rohal12/spindle",
-  "version": "0.43.6",
+  "version": "0.44.0",
   "type": "module",
   "description": "A Preact-based story format for Twine 2.",
   "license": "Unlicense",
@@ -61,28 +61,29 @@
     "micromark": "^4.0.2",
     "micromark-extension-gfm-strikethrough": "^2.1.0",
     "micromark-extension-gfm-table": "^2.1.1",
-    "preact": "^10.28.4",
-    "zustand": "^5.0.11"
+    "preact": "^10.29.0",
+    "zustand": "^5.0.12"
   },
   "lint-staged": {
     "*": "prettier --write --ignore-unknown"
   },
   "devDependencies": {
-    "@preact/preset-vite": "^2.10.3",
-    "@rohal12/twee-ts": "^1.1.2",
+    "@preact/preset-vite": "^2.10.5",
+    "@rohal12/twee-ts": "^1.14.0",
     "@types/js-yaml": "^4.0.9",
-    "@types/react": "^18.3.28",
-    "@vitest/coverage-v8": "^4.0.18",
-    "happy-dom": "^20.8.3",
+    "@types/node": "^25.5.0",
+    "@types/react": "^19.2.14",
+    "@vitest/coverage-v8": "^4.1.2",
+    "happy-dom": "^20.8.9",
     "husky": "^9.1.7",
     "js-yaml": "^4.1.1",
-    "lint-staged": "^16.3.2",
+    "lint-staged": "^16.4.0",
     "playwright": "^1.58.2",
     "prettier": "^3.8.1",
-    "typescript": "^5.9.3",
-    "vite": "^7.3.1",
-    "vite-plugin-singlefile": "^2.3.0",
+    "typescript": "^6.0.2",
+    "vite": "^8.0.3",
+    "vite-plugin-singlefile": "^2.3.2",
     "vitepress": "^1.6.4",
-    "vitest": "^4.0.18"
+    "vitest": "^4.1.2"
   }
 }

package/src/story-api.ts

@@ -113,6 +113,37 @@ function ensureVariableChangedSubscription(): void {
   });
 }
 
+/** Traverse a dot-delimited path on an object and return the value. */
+function getByPath(obj: Record<string, unknown>, path: string): unknown {
+  const segments = path.split('.');
+  let current: unknown = obj[segments[0]!];
+  for (let i = 1; i < segments.length; i++) {
+    if (current == null) return undefined;
+    current = (current as Record<string, unknown>)[segments[i]!];
+  }
+  return current;
+}
+
+/** Set a value at a dot-delimited path on an object (must be an Immer draft for mutation). */
+function setByPath(
+  obj: Record<string, unknown>,
+  path: string,
+  value: unknown,
+): void {
+  const segments = path.split('.');
+  let current: Record<string, unknown> = obj;
+  for (let i = 0; i < segments.length - 1; i++) {
+    const next = current[segments[i]!];
+    if (next == null || typeof next !== 'object') {
+      throw new TypeError(
+        `spindle: Cannot set property "${segments[i + 1]}" on ${typeof next} (at "${segments.slice(0, i + 1).join('.')}")`,
+      );
+    }
+    current = next as Record<string, unknown>;
+  }
+  current[segments[segments.length - 1]!] = value;
+}
+
 export interface StoryAPI {
   get(name: string): unknown;
   set(name: string, value: unknown): void;
@@ -192,30 +223,43 @@ export interface StoryAPI {
   };
 }
 
+/** Set a single variable, resolving dot-paths if present. */
+function setOne(name: string, value: unknown): void {
+  const isTransient = name.startsWith('%');
+  const key = isTransient ? name.slice(1) : name;
+  const namespace = isTransient ? 'transient' : 'variables';
+
+  if (key.includes('.')) {
+    useStoryStore.setState((state) => {
+      setByPath(state[namespace] as Record<string, unknown>, key, value);
+    });
+  } else {
+    const state = useStoryStore.getState();
+    if (isTransient) {
+      state.setTransient(key, value);
+    } else {
+      state.setVariable(key, value);
+    }
+  }
+}
+
 function createStoryAPI(): StoryAPI {
   return {
     get(name: string): unknown {
-      if (name.startsWith('%')) {
-        return useStoryStore.getState().transient[name.slice(1)];
-      }
-      return useStoryStore.getState().variables[name];
+      const isTransient = name.startsWith('%');
+      const key = isTransient ? name.slice(1) : name;
+      const store = isTransient
+        ? useStoryStore.getState().transient
+        : useStoryStore.getState().variables;
+      return key.includes('.') ? getByPath(store, key) : store[key];
     },
 
     set(nameOrVars: string | Record<string, unknown>, value?: unknown): void {
-      const state = useStoryStore.getState();
       if (typeof nameOrVars === 'string') {
-        if (nameOrVars.startsWith('%')) {
-          state.setTransient(nameOrVars.slice(1), value);
-        } else {
-          state.setVariable(nameOrVars, value);
-        }
+        setOne(nameOrVars, value);
       } else {
         for (const [k, v] of Object.entries(nameOrVars)) {
-          if (k.startsWith('%')) {
-            state.setTransient(k.slice(1), v);
-          } else {
-            state.setVariable(k, v);
-          }
+          setOne(k, v);
         }
       }
     },