@jarenjs/app 0.72.0 → 0.72.3

package/README.md

@@ -168,12 +168,21 @@ Jaren owns state and orchestration; the widget owns its DOM. Its `props` come fr
 Two IDE-shaped primitives ship ready to bind, so a two-pane surface (the studio, the play playground) doesn't re-implement them:
 
 - **`createSplitterWidget({ action, grid, rail, cssVar, min, max, step })`** — a drag handle over a pane boundary. It drives a CSS ratio variable *live* during a drag (no per-move dispatch — that would flood the transaction log and undo) and commits the ratio through `action` on pointer-up only, plus keyboard resize as an ARIA separator. Register it like any widget; parameterize the grid/rail selectors, the CSS variable and the commit action so each surface binds its own.
+
+  Widget props accept `axis: 'x' | 'y'` (default `'x'`) for side-by-side or
+  stacked panes. The widget also writes `${cssVar}-first` and
+  `${cssVar}-rest` as fractional grid tracks. Pointer cancellation restores
+  the starting ratio without committing; vertical resizing uses Up/Down.
 - **`createDocStore({ storage, key })`** — a keyed `save`/`load`/`remove`/`names`/`all` CRUD over an injected `storage` (`localStorage` in the browser, an in-memory object in tests), so the package never touches `localStorage` itself. Paired with **`encodeShare(snapshot)`** / **`decodeShare(token)`**, a Unicode-safe base64url share-link codec (a corrupt token decodes to `null`, never a throw), it is the new/save/load/delete/share pattern behind the studio and play surfaces.
 
 Collection keys and document names such as `__proto__` are ordinary own
 members of the document store and survive persistence. Loading a name
 that has not been saved returns `undefined`, including prototype-member names.
 
+Stores created with the same storage adapter share one in-memory root, read
+once. Saves and removals preserve other collections, including when the
+adapter cannot persist writes. A new adapter starts a new read of storage.
+
 ## Invariants the model can't cheat
 
 ```javascript

package/dist/types/docstore.d.ts

@@ -5,8 +5,9 @@
  * the host so the package stays free of `localStorage`.
  *
  * `createDocStore` is a keyed CRUD over an injected `storage` ({ read, write }):
- * the store is one JSON object `{ [key]: { name → value } }`, read once at
- * creation and written back on every mutation. `encodeShare` / `decodeShare`
+ * the store is one JSON object `{ [key]: { name → value } }`, read once per
+ * storage adapter, shared by its collections and written back on every
+ * mutation. `encodeShare` / `decodeShare`
  * turn a small snapshot into a Unicode-safe base64url token and back —
  * forgivingly: a corrupt token decodes to `null`, never a throw.
  */

package/dist/types/splitter.d.ts

@@ -6,7 +6,9 @@
  * DOM call is guarded so it mounts inertly over a headless stub (there the
  * live drag is browser-verified). The host binds it as a widget and
  * parameterizes the grid/rail selectors, the CSS variable and the commit
- * action, so studio, play and any future two-pane surface share one splitter.
+ * action. Widget props `{ ratio, axis: 'x' | 'y' }` select the live direction;
+ * the axis defaults to x. The ratio's `-first`/`-rest` CSS variables carry
+ * fractional tracks for stacked grids after their fixed toolbar and gaps.
  */
 /**
  * @param {Object} opts

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jarenjs/app",
   "private": false,
-  "version": "0.72.0",
+  "version": "0.72.3",
   "type": "module",
   "main": "./src/index.js",
   "types": "./dist/types/index.d.ts",
@@ -50,8 +50,8 @@
     "prepack": "npm run build:types"
   },
   "dependencies": {
-    "@jarenjs/core": "^0.72.0",
-    "@jarenjs/json": "^0.72.0",
-    "@jarenjs/view": "^0.72.0"
+    "@jarenjs/core": "^0.72.3",
+    "@jarenjs/json": "^0.72.3",
+    "@jarenjs/view": "^0.72.3"
   }
 }

package/src/docstore.js

@@ -6,13 +6,18 @@
  * the host so the package stays free of `localStorage`.
  *
  * `createDocStore` is a keyed CRUD over an injected `storage` ({ read, write }):
- * the store is one JSON object `{ [key]: { name → value } }`, read once at
- * creation and written back on every mutation. `encodeShare` / `decodeShare`
+ * the store is one JSON object `{ [key]: { name → value } }`, read once per
+ * storage adapter, shared by its collections and written back on every
+ * mutation. `encodeShare` / `decodeShare`
  * turn a small snapshot into a Unicode-safe base64url token and back —
  * forgivingly: a corrupt token decodes to `null`, never a throw.
  */
 
 import { setObjectMember } from '@jarenjs/core/object';
+import { createWeakCache } from '@jarenjs/core/cache';
+
+/** Collection handles share their adapter's root, including unsaved fallback data. */
+const storesByStorage = createWeakCache();
 
 /**
  * @param {Object} opts
@@ -29,8 +34,8 @@ import { setObjectMember } from '@jarenjs/core/object';
  * }}
  */
 export function createDocStore({ storage, key = 'experiments' }) {
-  // read once; keep the SAME object reference for every write-back
-  const store = storage.read() ?? {};
+  // Read once per adapter; every collection writes the same current root.
+  const store = storesByStorage.getOrCreate(storage, () => storage.read() ?? {});
   if (!Object.hasOwn(store, key) || store[key] == null) setObjectMember(store, key, {});
   return {
     save(name, value) { setObjectMember(store[key], name, value); storage.write(store); },

package/src/splitter.js

@@ -7,7 +7,9 @@
  * DOM call is guarded so it mounts inertly over a headless stub (there the
  * live drag is browser-verified). The host binds it as a widget and
  * parameterizes the grid/rail selectors, the CSS variable and the commit
- * action, so studio, play and any future two-pane surface share one splitter.
+ * action. Widget props `{ ratio, axis: 'x' | 'y' }` select the live direction;
+ * the axis defaults to x. The ratio's `-first`/`-rest` CSS variables carry
+ * fractional tracks for stacked grids after their fixed toolbar and gaps.
  */
 
 /**
@@ -44,22 +46,30 @@ export function createSplitterWidget(opts) {
       const gridOf = () => (typeof host.closest === 'function' ? host.closest(gridSel) : null);
       const applyRatio = (r) => {
         gridOf()?.style?.setProperty?.(cssVar, String(r));
+        gridOf()?.style?.setProperty?.(cssVar + '-first', `${r}fr`);
+        gridOf()?.style?.setProperty?.(cssVar + '-rest', `${1 - r}fr`);
         host.setAttribute?.('aria-valuenow', String(Math.round(r * 100)));
+        host.setAttribute?.('aria-orientation', handle.axis === 'y' ? 'horizontal' : 'vertical');
       };
-      // pointer x → the left content pane's share of the (post-rail) span
-      const ratioAt = (clientX) => {
+      // A rail spans the content rows, so its top excludes the toolbar
+      // when the same content is stacked vertically.
+      const ratioAt = (clientX, clientY) => {
         const g = gridOf();
         if (g === null) return handle.ratio;
         const rail = railSel !== null && typeof g.querySelector === 'function' ? g.querySelector(railSel) : null;
         const box = g.getBoundingClientRect();
-        const left = rail !== null ? rail.getBoundingClientRect().right : box.left;
-        if (!(box.right > left)) return handle.ratio;
-        return clamp((clientX - left) / (box.right - left));
+        const railBox = rail?.getBoundingClientRect();
+        const vertical = handle.axis === 'y';
+        const start = vertical ? (railBox?.top ?? box.top) : (railBox?.right ?? box.left);
+        const end = vertical ? (railBox?.bottom ?? box.bottom) : box.right;
+        const point = vertical ? clientY : clientX;
+        if (!(end > start) || !Number.isFinite(point)) return handle.ratio;
+        return clamp((point - start) / (end - start));
       };
       const onMove = (e) => {
         if (!handle.dragging) return;
         e.preventDefault?.();
-        handle.ratio = ratioAt(e.clientX);
+        handle.ratio = ratioAt(e.clientX, e.clientY);
         applyRatio(handle.ratio); // live only — the commit is on pointer-up
       };
       const onUp = () => {
@@ -67,20 +77,32 @@ export function createSplitterWidget(opts) {
         handle.dragging = false;
         doc?.removeEventListener?.('pointermove', onMove);
         doc?.removeEventListener?.('pointerup', onUp);
+        doc?.removeEventListener?.('pointercancel', onCancel);
         emit({ action, with: handle.ratio });
       };
+      const onCancel = () => {
+        if (!handle.dragging) return;
+        handle.dragging = false;
+        handle.ratio = handle.startRatio;
+        applyRatio(handle.ratio);
+        doc?.removeEventListener?.('pointermove', onMove);
+        doc?.removeEventListener?.('pointerup', onUp);
+        doc?.removeEventListener?.('pointercancel', onCancel);
+      };
       const onDown = (e) => {
         if (e.button !== undefined && e.button !== 0) return;
         handle.dragging = true;
+        handle.startRatio = handle.ratio;
         e.preventDefault?.();
         doc?.addEventListener?.('pointermove', onMove);
         doc?.addEventListener?.('pointerup', onUp);
+        doc?.addEventListener?.('pointercancel', onCancel);
       };
       const onKey = (e) => {
         const s = e.shiftKey ? fineStep : step;
         let next = null;
-        if (e.key === 'ArrowLeft' || e.key === 'ArrowDown') next = clamp(handle.ratio - s);
-        else if (e.key === 'ArrowRight' || e.key === 'ArrowUp') next = clamp(handle.ratio + s);
+        if (e.key === 'ArrowLeft' || e.key === (handle.axis === 'y' ? 'ArrowUp' : 'ArrowDown')) next = clamp(handle.ratio - s);
+        else if (e.key === 'ArrowRight' || e.key === (handle.axis === 'y' ? 'ArrowDown' : 'ArrowUp')) next = clamp(handle.ratio + s);
         else if (e.key === 'Home') next = min;
         else if (e.key === 'End') next = max;
         if (next === null) return;
@@ -90,7 +112,9 @@ export function createSplitterWidget(opts) {
         emit({ action, with: next });
       };
 
-      const handle = { host, doc, ratio: clamp(Number(props?.ratio ?? 0.5)), dragging: false, applyRatio, onMove, onUp };
+      const handle = { host, doc, ratio: clamp(Number(props?.ratio ?? 0.5)),
+        axis: props?.axis === 'y' ? 'y' : 'x', startRatio: 0.5,
+        dragging: false, applyRatio, onMove, onUp, onCancel };
       applyRatio(handle.ratio);
       host.addEventListener?.('pointerdown', onDown);
       host.addEventListener?.('keydown', onKey);
@@ -98,6 +122,12 @@ export function createSplitterWidget(opts) {
       return handle;
     },
     update(handle, props) {
+      const axis = props?.axis === 'y' ? 'y' : 'x';
+      if (axis !== handle.axis) {
+        handle.onCancel();
+        handle.axis = axis;
+        handle.applyRatio(handle.ratio);
+      }
       const r = clamp(Number(props?.ratio ?? 0.5));
       if (r !== handle.ratio && !handle.dragging) {
         handle.ratio = r;
@@ -108,6 +138,7 @@ export function createSplitterWidget(opts) {
       for (const [type, fn] of handle.hostListeners) handle.host.removeEventListener?.(type, fn);
       handle.doc?.removeEventListener?.('pointermove', handle.onMove);
       handle.doc?.removeEventListener?.('pointerup', handle.onUp);
+      handle.doc?.removeEventListener?.('pointercancel', handle.onCancel);
     },
   };
 }