@ai-matrx/canvas 0.5.2 → 0.6.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { C as CanvasItemId, a as CanvasWindowId, b as CanvasJson, c as CanvasLayoutNode, d as CanvasPaneId, e as CanvasStoreBinding, f as CanvasState, g as CanvasAction, h as CanvasController, i as CanvasItem, j as CanvasExtraWindow, k as CanvasHistoryEntry, l as CanvasPane, m as canvasWindowOfItem } from './toggleKind-BD78LnMB.cjs';
-export { n as CANVAS_DEFAULT_KEY, o as CANVAS_DEFAULT_WIDTH, p as CANVAS_DESKTOP_LAYOUT_RULES, q as CANVAS_HISTORY_LIMIT, r as CANVAS_LAUNCHER_KIND, s as CANVAS_MAIN_WINDOW, t as CANVAS_MIN_SPLIT_FRACTION, u as CANVAS_MIN_WIDTH, v as CANVAS_NARROW_WIDTH, w as CANVAS_STORAGE_KEY, x as CANVAS_WEB_LAYOUT_RULES, y as CanvasControllerOptions, z as CanvasErrorReport, A as CanvasErrorSink, B as CanvasKeyValueStore, D as CanvasKindVisibility, E as CanvasLayoutRules, F as CanvasNavigateInput, G as CanvasOpenInput, H as CanvasOpenTarget, I as CanvasOrientation, J as CanvasPersistencePort, K as CanvasPreferredTarget, L as CanvasPresentation, M as CanvasPresentationOrientation, N as CanvasRect, O as CanvasSessionAttachReason, P as CanvasSessionDetachReason, Q as CanvasSessionEvent, R as CanvasSessionHooks, S as CanvasSplitId, T as CanvasWindowCloseMode, U as CanvasWindowFrame, V as CanvasWindowPorts, W as ReduxStoreLike, X as ToggleKindInput, Y as bindCanvasToReduxStore, Z as canvasActions, _ as canvasOrientation, $ as canvasPresentation, a0 as canvasReducer, a1 as canvasWindowFrame, a2 as canvasWindowOfPane, a3 as clampDraggedCanvasWidth, a4 as consoleCanvasErrorSink, a5 as createCanvasController, a6 as createCanvasStore, a7 as createInitialCanvasState, a8 as createKeyValueCanvasPersistence, a9 as createLocalStorageCanvasPersistence, aa as defaultCanvasWidth, ab as fitCanvasWidth, ac as foldCanvasWindows, ad as isCanvasAction, ae as listCanvasWindowIds, af as preferredFlowDirection, ag as resolveCanvasLayoutRules, ah as sanitizeCanvasSnapshot, ai as selectCanvasKindVisibility, aj as shouldStackSplit, ak as toPersistableSnapshot, al as toggleKind } from './toggleKind-BD78LnMB.cjs';
+import { C as CanvasItemId, a as CanvasWindowId, b as CanvasJson, c as CanvasLayoutNode, d as CanvasPaneId, e as CanvasStoreBinding, f as CanvasState, g as CanvasAction, h as CanvasController, i as CanvasItem, j as CanvasExtraWindow, k as CanvasHistoryEntry, l as CanvasPane, m as canvasWindowOfItem } from './toggleKind-DhDmWExm.cjs';
+export { n as CANVAS_DEFAULT_KEY, o as CANVAS_DEFAULT_WIDTH, p as CANVAS_DESKTOP_LAYOUT_RULES, q as CANVAS_HISTORY_LIMIT, r as CANVAS_KEEP_ALIVE_DEPTH, s as CANVAS_LAUNCHER_KIND, t as CANVAS_MAIN_WINDOW, u as CANVAS_MIN_SPLIT_FRACTION, v as CANVAS_MIN_WIDTH, w as CANVAS_NARROW_WIDTH, x as CANVAS_PHONE_MAX_WIDTH, y as CANVAS_STORAGE_KEY, z as CANVAS_WEB_LAYOUT_RULES, A as CanvasControllerOptions, B as CanvasErrorReport, D as CanvasErrorSink, E as CanvasKeyValueStore, F as CanvasKindVisibility, G as CanvasLayoutRules, H as CanvasNavigateInput, I as CanvasOpenInput, J as CanvasOpenTarget, K as CanvasOrientation, L as CanvasPersistencePort, M as CanvasPreferredTarget, N as CanvasPresentation, O as CanvasPresentationOrientation, P as CanvasRect, Q as CanvasSessionAttachReason, R as CanvasSessionDetachReason, S as CanvasSessionEvent, T as CanvasSessionHooks, U as CanvasSplitId, V as CanvasWindowCloseMode, W as CanvasWindowFrame, X as CanvasWindowPorts, Y as ReduxStoreLike, Z as ToggleKindInput, _ as bindCanvasToReduxStore, $ as canvasActions, a0 as canvasOrientation, a1 as canvasPresentation, a2 as canvasReducer, a3 as canvasWindowFrame, a4 as canvasWindowOfPane, a5 as clampDraggedCanvasWidth, a6 as consoleCanvasErrorSink, a7 as createCanvasController, a8 as createCanvasStore, a9 as createInitialCanvasState, aa as createKeyValueCanvasPersistence, ab as createLocalStorageCanvasPersistence, ac as defaultCanvasWidth, ad as fitCanvasWidth, ae as foldCanvasWindows, af as isCanvasAction, ag as listCanvasWindowIds, ah as preferredFlowDirection, ai as resolveCanvasLayoutRules, aj as sanitizeCanvasSnapshot, ak as selectCanvasKindVisibility, al as shouldStackSplit, am as toPersistableSnapshot, an as toggleKind } from './toggleKind-DhDmWExm.cjs';
 
 declare function canvasItemId(kind: string, key: string): CanvasItemId;
 declare function parseCanvasItemId(id: CanvasItemId): {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as CanvasItemId, a as CanvasWindowId, b as CanvasJson, c as CanvasLayoutNode, d as CanvasPaneId, e as CanvasStoreBinding, f as CanvasState, g as CanvasAction, h as CanvasController, i as CanvasItem, j as CanvasExtraWindow, k as CanvasHistoryEntry, l as CanvasPane, m as canvasWindowOfItem } from './toggleKind-BD78LnMB.js';
-export { n as CANVAS_DEFAULT_KEY, o as CANVAS_DEFAULT_WIDTH, p as CANVAS_DESKTOP_LAYOUT_RULES, q as CANVAS_HISTORY_LIMIT, r as CANVAS_LAUNCHER_KIND, s as CANVAS_MAIN_WINDOW, t as CANVAS_MIN_SPLIT_FRACTION, u as CANVAS_MIN_WIDTH, v as CANVAS_NARROW_WIDTH, w as CANVAS_STORAGE_KEY, x as CANVAS_WEB_LAYOUT_RULES, y as CanvasControllerOptions, z as CanvasErrorReport, A as CanvasErrorSink, B as CanvasKeyValueStore, D as CanvasKindVisibility, E as CanvasLayoutRules, F as CanvasNavigateInput, G as CanvasOpenInput, H as CanvasOpenTarget, I as CanvasOrientation, J as CanvasPersistencePort, K as CanvasPreferredTarget, L as CanvasPresentation, M as CanvasPresentationOrientation, N as CanvasRect, O as CanvasSessionAttachReason, P as CanvasSessionDetachReason, Q as CanvasSessionEvent, R as CanvasSessionHooks, S as CanvasSplitId, T as CanvasWindowCloseMode, U as CanvasWindowFrame, V as CanvasWindowPorts, W as ReduxStoreLike, X as ToggleKindInput, Y as bindCanvasToReduxStore, Z as canvasActions, _ as canvasOrientation, $ as canvasPresentation, a0 as canvasReducer, a1 as canvasWindowFrame, a2 as canvasWindowOfPane, a3 as clampDraggedCanvasWidth, a4 as consoleCanvasErrorSink, a5 as createCanvasController, a6 as createCanvasStore, a7 as createInitialCanvasState, a8 as createKeyValueCanvasPersistence, a9 as createLocalStorageCanvasPersistence, aa as defaultCanvasWidth, ab as fitCanvasWidth, ac as foldCanvasWindows, ad as isCanvasAction, ae as listCanvasWindowIds, af as preferredFlowDirection, ag as resolveCanvasLayoutRules, ah as sanitizeCanvasSnapshot, ai as selectCanvasKindVisibility, aj as shouldStackSplit, ak as toPersistableSnapshot, al as toggleKind } from './toggleKind-BD78LnMB.js';
+import { C as CanvasItemId, a as CanvasWindowId, b as CanvasJson, c as CanvasLayoutNode, d as CanvasPaneId, e as CanvasStoreBinding, f as CanvasState, g as CanvasAction, h as CanvasController, i as CanvasItem, j as CanvasExtraWindow, k as CanvasHistoryEntry, l as CanvasPane, m as canvasWindowOfItem } from './toggleKind-DhDmWExm.js';
+export { n as CANVAS_DEFAULT_KEY, o as CANVAS_DEFAULT_WIDTH, p as CANVAS_DESKTOP_LAYOUT_RULES, q as CANVAS_HISTORY_LIMIT, r as CANVAS_KEEP_ALIVE_DEPTH, s as CANVAS_LAUNCHER_KIND, t as CANVAS_MAIN_WINDOW, u as CANVAS_MIN_SPLIT_FRACTION, v as CANVAS_MIN_WIDTH, w as CANVAS_NARROW_WIDTH, x as CANVAS_PHONE_MAX_WIDTH, y as CANVAS_STORAGE_KEY, z as CANVAS_WEB_LAYOUT_RULES, A as CanvasControllerOptions, B as CanvasErrorReport, D as CanvasErrorSink, E as CanvasKeyValueStore, F as CanvasKindVisibility, G as CanvasLayoutRules, H as CanvasNavigateInput, I as CanvasOpenInput, J as CanvasOpenTarget, K as CanvasOrientation, L as CanvasPersistencePort, M as CanvasPreferredTarget, N as CanvasPresentation, O as CanvasPresentationOrientation, P as CanvasRect, Q as CanvasSessionAttachReason, R as CanvasSessionDetachReason, S as CanvasSessionEvent, T as CanvasSessionHooks, U as CanvasSplitId, V as CanvasWindowCloseMode, W as CanvasWindowFrame, X as CanvasWindowPorts, Y as ReduxStoreLike, Z as ToggleKindInput, _ as bindCanvasToReduxStore, $ as canvasActions, a0 as canvasOrientation, a1 as canvasPresentation, a2 as canvasReducer, a3 as canvasWindowFrame, a4 as canvasWindowOfPane, a5 as clampDraggedCanvasWidth, a6 as consoleCanvasErrorSink, a7 as createCanvasController, a8 as createCanvasStore, a9 as createInitialCanvasState, aa as createKeyValueCanvasPersistence, ab as createLocalStorageCanvasPersistence, ac as defaultCanvasWidth, ad as fitCanvasWidth, ae as foldCanvasWindows, af as isCanvasAction, ag as listCanvasWindowIds, ah as preferredFlowDirection, ai as resolveCanvasLayoutRules, aj as sanitizeCanvasSnapshot, ak as selectCanvasKindVisibility, al as shouldStackSplit, am as toPersistableSnapshot, an as toggleKind } from './toggleKind-DhDmWExm.js';
 
 declare function canvasItemId(kind: string, key: string): CanvasItemId;
 declare function parseCanvasItemId(id: CanvasItemId): {

package/dist/index.js

@@ -2,6 +2,7 @@
 var CANVAS_MAIN_WINDOW = "main";
 var CANVAS_LAUNCHER_KIND = "canvas.launcher";
 var CANVAS_HISTORY_LIMIT = 50;
+var CANVAS_KEEP_ALIVE_DEPTH = 5;
 var CANVAS_MIN_WIDTH = 360;
 var CANVAS_DEFAULT_WIDTH = 640;
 var CANVAS_MIN_SPLIT_FRACTION = 0.12;
@@ -367,8 +368,10 @@ function sendHome(state, itemId, home, activate) {
   next = insertInto(next, homeFrame.focusedPaneId, itemId, activate);
   return activate ? withFrame(next, target, { focusedPaneId: homeFrame.focusedPaneId }) : next;
 }
-function newItem(kind, key, title, data, now, history) {
+function newItem(kind, key, title, data, now, steps) {
   const id = canvasItemId(kind, key);
+  const history = steps?.history ?? [];
+  const kept = steps?.kept ?? [];
   return {
     id,
     kind,
@@ -377,12 +380,14 @@ function newItem(kind, key, title, data, now, history) {
     data,
     openedAt: now,
     updatedAt: now,
-    instance: `${now.toString(36)}:${id}`,
-    ...history && history.length > 0 ? { history: history.slice(-CANVAS_HISTORY_LIMIT) } : {}
+    // A reused instance is the SAME live body coming back (Back, or returning to a kept step).
+    instance: steps?.instance ?? `${now.toString(36)}:${id}`,
+    ...history.length > 0 ? { history: history.slice(-CANVAS_HISTORY_LIMIT) } : {},
+    ...kept.length > 0 ? { kept: kept.slice(-CANVAS_KEEP_ALIVE_DEPTH) } : {}
   };
 }
 function historyEntry(item) {
-  return { kind: item.kind, key: item.key, title: item.title, data: item.data };
+  return { kind: item.kind, key: item.key, title: item.title, data: item.data, ...item.instance ? { instance: item.instance } : {} };
 }
 function replaceInPlace(state, current, next) {
   const pane = paneOf(state, current.id);
@@ -411,17 +416,25 @@ function sanitizeHistory(raw) {
     if (!entry || typeof entry !== "object") continue;
     const e = entry;
     if (typeof e.kind !== "string" || typeof e.key !== "string") continue;
-    out.push({ kind: e.kind, key: e.key, title: typeof e.title === "string" ? e.title : null, data: e.data ?? null });
+    out.push({
+      kind: e.kind,
+      key: e.key,
+      title: typeof e.title === "string" ? e.title : null,
+      data: e.data ?? null,
+      ...typeof e.instance === "string" && e.instance ? { instance: e.instance } : {}
+    });
   }
   return out.slice(-CANVAS_HISTORY_LIMIT);
 }
 function sanitizeItem(item) {
   const history = sanitizeHistory(item.history);
-  const { history: _history, instance, ...rest } = item;
+  const kept = sanitizeHistory(item.kept).slice(-CANVAS_KEEP_ALIVE_DEPTH);
+  const { history: _history, kept: _kept, instance, ...rest } = item;
   return {
     ...rest,
     ...typeof instance === "string" && instance ? { instance } : {},
-    ...history.length > 0 ? { history } : {}
+    ...history.length > 0 ? { history } : {},
+    ...kept.length > 0 ? { kept } : {}
   };
 }
 function clampWidth(width) {
@@ -608,7 +621,22 @@ function canvasReducer(state = createInitialCanvasState(), action) {
         return current.kind === CANVAS_LAUNCHER_KIND ? canvasReducer(focused, canvasActions.closeItem(itemId)) : focused;
       }
       const history = [...current.history ?? [], historyEntry(current)];
-      return replaceInPlace(state, current, newItem(to.kind, to.key, to.title ?? null, to.data ?? null, now, history));
+      const keptAll = current.kept ?? [];
+      const keptIndex = keptAll.findIndex((entry) => canvasItemId(entry.kind, entry.key) === targetId);
+      const revived = keptIndex >= 0 ? keptAll[keptIndex] : void 0;
+      const kept = keptAll.filter((_, i) => i !== keptIndex);
+      return replaceInPlace(
+        state,
+        current,
+        newItem(
+          to.kind,
+          to.key,
+          to.title !== void 0 ? to.title : revived?.title ?? null,
+          to.data !== void 0 ? to.data : revived?.data ?? null,
+          now,
+          { history, kept, instance: revived?.instance }
+        )
+      );
     }
     case `${P}back`: {
       const { itemId, now } = action.payload;
@@ -621,7 +649,12 @@ function canvasReducer(state = createInitialCanvasState(), action) {
       if (state.items[targetId]) {
         return focusExisting(canvasReducer(state, canvasActions.closeItem(itemId)), targetId);
       }
-      return replaceInPlace(state, current, newItem(entry.kind, entry.key, entry.title, entry.data, now, history.slice(0, -1)));
+      const kept = [...(current.kept ?? []).filter((k) => canvasItemId(k.kind, k.key) !== itemId), historyEntry(current)];
+      return replaceInPlace(
+        state,
+        current,
+        newItem(entry.kind, entry.key, entry.title, entry.data, now, { history: history.slice(0, -1), kept, instance: entry.instance })
+      );
     }
     case `${P}closeItem`: {
       const { itemId } = action.payload;
@@ -1458,6 +1491,7 @@ function selectCanvasItemHistory(s, itemId) {
 var selectCanvasCanGoBack = (s, itemId) => (s.items[itemId]?.history?.length ?? 0) > 0;
 
 // src/core/presentation.ts
+var CANVAS_PHONE_MAX_WIDTH = 767;
 var CANVAS_NARROW_WIDTH = 480;
 var SQUARE_BAND = 1.2;
 function canvasOrientation(width, height) {
@@ -1529,11 +1563,13 @@ export {
   CANVAS_DEFAULT_WIDTH,
   CANVAS_DESKTOP_LAYOUT_RULES,
   CANVAS_HISTORY_LIMIT,
+  CANVAS_KEEP_ALIVE_DEPTH,
   CANVAS_LAUNCHER_KIND,
   CANVAS_MAIN_WINDOW,
   CANVAS_MIN_SPLIT_FRACTION,
   CANVAS_MIN_WIDTH,
   CANVAS_NARROW_WIDTH,
+  CANVAS_PHONE_MAX_WIDTH,
   CANVAS_SHORTCUTS,
   CANVAS_STORAGE_KEY,
   CANVAS_WEB_LAYOUT_RULES,