@ai-matrx/canvas 0.6.0 → 0.7.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-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';
+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-CAI7pndj.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_PANE_MIN_WIDTH, y as CANVAS_PHONE_MAX_WIDTH, z as CANVAS_STORAGE_KEY, A as CANVAS_WEB_LAYOUT_RULES, B as CanvasControllerOptions, D as CanvasErrorReport, E as CanvasErrorSink, F as CanvasKeyValueStore, G as CanvasKindVisibility, H as CanvasLayoutRules, I as CanvasNavigateInput, J as CanvasOpenInput, K as CanvasOpenTarget, L as CanvasOrientation, M as CanvasPersistencePort, N as CanvasPreferredTarget, O as CanvasPresentation, P as CanvasPresentationOrientation, Q as CanvasRect, R as CanvasSessionAttachReason, S as CanvasSessionDetachReason, T as CanvasSessionEvent, U as CanvasSessionHooks, V as CanvasSplitId, W as CanvasWindowCloseMode, X as CanvasWindowFrame, Y as CanvasWindowPorts, Z as ReduxStoreLike, _ as ToggleKindInput, $ as bindCanvasToReduxStore, a0 as canvasActions, a1 as canvasOrientation, a2 as canvasPresentation, a3 as canvasReducer, a4 as canvasWindowFrame, a5 as canvasWindowOfPane, a6 as clampDraggedCanvasWidth, a7 as consoleCanvasErrorSink, a8 as createCanvasController, a9 as createCanvasStore, aa as createInitialCanvasState, ab as createKeyValueCanvasPersistence, ac as createLocalStorageCanvasPersistence, ad as defaultCanvasWidth, ae as fitCanvasWidth, af as foldCanvasWindows, ag as isCanvasAction, ah as listCanvasWindowIds, ai as preferredFlowDirection, aj as resolveCanvasLayoutRules, ak as sanitizeCanvasSnapshot, al as selectCanvasKindVisibility, am as shouldStackSplit, an as toPersistableSnapshot, ao as toggleKind } from './toggleKind-CAI7pndj.cjs';
 
 declare function canvasItemId(kind: string, key: string): CanvasItemId;
 declare function parseCanvasItemId(id: CanvasItemId): {
@@ -73,7 +73,7 @@ declare function shareStructure<T>(prev: T, next: T): T;
  * through `runCanvasCommand`, so both paths do exactly the same thing.
  */
 
-type CanvasCommandId = "canvas.toggle" | "canvas.toggleFullscreen" | "canvas.exitFullscreen" | "canvas.closeTab" | "canvas.nextTab" | "canvas.previousTab" | "canvas.splitRight" | "canvas.splitDown";
+type CanvasCommandId = "canvas.toggle" | "canvas.toggleFullscreen" | "canvas.exitFullscreen" | "canvas.closeTab" | "canvas.nextTab" | "canvas.previousTab" | "canvas.splitRight" | "canvas.splitDown" | "canvas.back" | "canvas.forward";
 /**
  * When a shortcut applies:
  *  - "presented": a canvas column is on screen in this window;
@@ -146,5 +146,14 @@ declare const selectCanvasWindowOfItem: typeof canvasWindowOfItem;
 declare function selectCanvasItemHistory(s: CanvasState, itemId: CanvasItemId): readonly CanvasHistoryEntry[];
 /** Whether a tab offers Back (it navigated in place). */
 declare const selectCanvasCanGoBack: (s: CanvasState, itemId: CanvasItemId) => boolean;
+/** Whether a tab offers Forward (it went Back and has not navigated elsewhere since). */
+declare const selectCanvasCanGoForward: (s: CanvasState, itemId: CanvasItemId) => boolean;
+/**
+ * The ONE pane a phone presents: the focused pane when it holds a tab, else
+ * the first pane that does (an empty pane is never presented over tabs that
+ * exist — the header and the body always describe the same pane), else the
+ * focused one.
+ */
+declare function selectCanvasPresentedPaneId(s: CanvasState, windowId?: CanvasWindowId): CanvasPaneId | null;
 
-export { CANVAS_SHORTCUTS, CanvasAction, type CanvasCommandId, CanvasController, CanvasExtraWindow, CanvasHistoryEntry, CanvasItem, CanvasItemId, CanvasJson, type CanvasKeyInput, CanvasLayoutNode, CanvasPane, CanvasPaneId, type CanvasShortcut, type CanvasShortcutWhen, CanvasState, CanvasStoreBinding, CanvasWindowId, type RemoteCanvasStore, type RemoteCanvasStoreOptions, canvasItemId, canvasShortcutHint, canvasWindowId, canvasWindowOfItem, createRemoteCanvasStore, findNonJson, isCanvasJson, listPaneIds, matchesCanvasAccelerator, normalizeSizes, parseCanvasItemId, runCanvasCommand, selectCanvasActiveItem, selectCanvasCanGoBack, selectCanvasExtraWindow, selectCanvasFocusedPaneId, selectCanvasIsFullscreen, selectCanvasIsHydrated, selectCanvasIsOpen, selectCanvasItem, selectCanvasItemCount, selectCanvasItemHistory, selectCanvasLayout, selectCanvasPane, selectCanvasPaneCount, selectCanvasWidth, selectCanvasWindowItemCount, selectCanvasWindowOfItem, selectCanvasWindows, shareStructure };
+export { CANVAS_SHORTCUTS, CanvasAction, type CanvasCommandId, CanvasController, CanvasExtraWindow, CanvasHistoryEntry, CanvasItem, CanvasItemId, CanvasJson, type CanvasKeyInput, CanvasLayoutNode, CanvasPane, CanvasPaneId, type CanvasShortcut, type CanvasShortcutWhen, CanvasState, CanvasStoreBinding, CanvasWindowId, type RemoteCanvasStore, type RemoteCanvasStoreOptions, canvasItemId, canvasShortcutHint, canvasWindowId, canvasWindowOfItem, createRemoteCanvasStore, findNonJson, isCanvasJson, listPaneIds, matchesCanvasAccelerator, normalizeSizes, parseCanvasItemId, runCanvasCommand, selectCanvasActiveItem, selectCanvasCanGoBack, selectCanvasCanGoForward, selectCanvasExtraWindow, selectCanvasFocusedPaneId, selectCanvasIsFullscreen, selectCanvasIsHydrated, selectCanvasIsOpen, selectCanvasItem, selectCanvasItemCount, selectCanvasItemHistory, selectCanvasLayout, selectCanvasPane, selectCanvasPaneCount, selectCanvasPresentedPaneId, selectCanvasWidth, selectCanvasWindowItemCount, selectCanvasWindowOfItem, selectCanvasWindows, shareStructure };

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-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';
+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-CAI7pndj.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_PANE_MIN_WIDTH, y as CANVAS_PHONE_MAX_WIDTH, z as CANVAS_STORAGE_KEY, A as CANVAS_WEB_LAYOUT_RULES, B as CanvasControllerOptions, D as CanvasErrorReport, E as CanvasErrorSink, F as CanvasKeyValueStore, G as CanvasKindVisibility, H as CanvasLayoutRules, I as CanvasNavigateInput, J as CanvasOpenInput, K as CanvasOpenTarget, L as CanvasOrientation, M as CanvasPersistencePort, N as CanvasPreferredTarget, O as CanvasPresentation, P as CanvasPresentationOrientation, Q as CanvasRect, R as CanvasSessionAttachReason, S as CanvasSessionDetachReason, T as CanvasSessionEvent, U as CanvasSessionHooks, V as CanvasSplitId, W as CanvasWindowCloseMode, X as CanvasWindowFrame, Y as CanvasWindowPorts, Z as ReduxStoreLike, _ as ToggleKindInput, $ as bindCanvasToReduxStore, a0 as canvasActions, a1 as canvasOrientation, a2 as canvasPresentation, a3 as canvasReducer, a4 as canvasWindowFrame, a5 as canvasWindowOfPane, a6 as clampDraggedCanvasWidth, a7 as consoleCanvasErrorSink, a8 as createCanvasController, a9 as createCanvasStore, aa as createInitialCanvasState, ab as createKeyValueCanvasPersistence, ac as createLocalStorageCanvasPersistence, ad as defaultCanvasWidth, ae as fitCanvasWidth, af as foldCanvasWindows, ag as isCanvasAction, ah as listCanvasWindowIds, ai as preferredFlowDirection, aj as resolveCanvasLayoutRules, ak as sanitizeCanvasSnapshot, al as selectCanvasKindVisibility, am as shouldStackSplit, an as toPersistableSnapshot, ao as toggleKind } from './toggleKind-CAI7pndj.js';
 
 declare function canvasItemId(kind: string, key: string): CanvasItemId;
 declare function parseCanvasItemId(id: CanvasItemId): {
@@ -73,7 +73,7 @@ declare function shareStructure<T>(prev: T, next: T): T;
  * through `runCanvasCommand`, so both paths do exactly the same thing.
  */
 
-type CanvasCommandId = "canvas.toggle" | "canvas.toggleFullscreen" | "canvas.exitFullscreen" | "canvas.closeTab" | "canvas.nextTab" | "canvas.previousTab" | "canvas.splitRight" | "canvas.splitDown";
+type CanvasCommandId = "canvas.toggle" | "canvas.toggleFullscreen" | "canvas.exitFullscreen" | "canvas.closeTab" | "canvas.nextTab" | "canvas.previousTab" | "canvas.splitRight" | "canvas.splitDown" | "canvas.back" | "canvas.forward";
 /**
  * When a shortcut applies:
  *  - "presented": a canvas column is on screen in this window;
@@ -146,5 +146,14 @@ declare const selectCanvasWindowOfItem: typeof canvasWindowOfItem;
 declare function selectCanvasItemHistory(s: CanvasState, itemId: CanvasItemId): readonly CanvasHistoryEntry[];
 /** Whether a tab offers Back (it navigated in place). */
 declare const selectCanvasCanGoBack: (s: CanvasState, itemId: CanvasItemId) => boolean;
+/** Whether a tab offers Forward (it went Back and has not navigated elsewhere since). */
+declare const selectCanvasCanGoForward: (s: CanvasState, itemId: CanvasItemId) => boolean;
+/**
+ * The ONE pane a phone presents: the focused pane when it holds a tab, else
+ * the first pane that does (an empty pane is never presented over tabs that
+ * exist — the header and the body always describe the same pane), else the
+ * focused one.
+ */
+declare function selectCanvasPresentedPaneId(s: CanvasState, windowId?: CanvasWindowId): CanvasPaneId | null;
 
-export { CANVAS_SHORTCUTS, CanvasAction, type CanvasCommandId, CanvasController, CanvasExtraWindow, CanvasHistoryEntry, CanvasItem, CanvasItemId, CanvasJson, type CanvasKeyInput, CanvasLayoutNode, CanvasPane, CanvasPaneId, type CanvasShortcut, type CanvasShortcutWhen, CanvasState, CanvasStoreBinding, CanvasWindowId, type RemoteCanvasStore, type RemoteCanvasStoreOptions, canvasItemId, canvasShortcutHint, canvasWindowId, canvasWindowOfItem, createRemoteCanvasStore, findNonJson, isCanvasJson, listPaneIds, matchesCanvasAccelerator, normalizeSizes, parseCanvasItemId, runCanvasCommand, selectCanvasActiveItem, selectCanvasCanGoBack, selectCanvasExtraWindow, selectCanvasFocusedPaneId, selectCanvasIsFullscreen, selectCanvasIsHydrated, selectCanvasIsOpen, selectCanvasItem, selectCanvasItemCount, selectCanvasItemHistory, selectCanvasLayout, selectCanvasPane, selectCanvasPaneCount, selectCanvasWidth, selectCanvasWindowItemCount, selectCanvasWindowOfItem, selectCanvasWindows, shareStructure };
+export { CANVAS_SHORTCUTS, CanvasAction, type CanvasCommandId, CanvasController, CanvasExtraWindow, CanvasHistoryEntry, CanvasItem, CanvasItemId, CanvasJson, type CanvasKeyInput, CanvasLayoutNode, CanvasPane, CanvasPaneId, type CanvasShortcut, type CanvasShortcutWhen, CanvasState, CanvasStoreBinding, CanvasWindowId, type RemoteCanvasStore, type RemoteCanvasStoreOptions, canvasItemId, canvasShortcutHint, canvasWindowId, canvasWindowOfItem, createRemoteCanvasStore, findNonJson, isCanvasJson, listPaneIds, matchesCanvasAccelerator, normalizeSizes, parseCanvasItemId, runCanvasCommand, selectCanvasActiveItem, selectCanvasCanGoBack, selectCanvasCanGoForward, selectCanvasExtraWindow, selectCanvasFocusedPaneId, selectCanvasIsFullscreen, selectCanvasIsHydrated, selectCanvasIsOpen, selectCanvasItem, selectCanvasItemCount, selectCanvasItemHistory, selectCanvasLayout, selectCanvasPane, selectCanvasPaneCount, selectCanvasPresentedPaneId, selectCanvasWidth, selectCanvasWindowItemCount, selectCanvasWindowOfItem, selectCanvasWindows, shareStructure };

package/dist/index.js

@@ -172,6 +172,8 @@ var canvasActions = {
   navigate: (itemId, to) => ({ type: `${P}navigate`, payload: { itemId, to, now: Date.now() } }),
   /** Returns a tab to what it showed before its last navigate. */
   back: (itemId) => ({ type: `${P}back`, payload: { itemId, now: Date.now() } }),
+  /** Re-does the last Back (the step Back left), with that step's live body. */
+  forward: (itemId) => ({ type: `${P}forward`, payload: { itemId, now: Date.now() } }),
   closeItem: (itemId) => ({ type: `${P}closeItem`, payload: { itemId } }),
   closeOthers: (itemId) => ({ type: `${P}closeOthers`, payload: { itemId } }),
   activate: (itemId) => ({ type: `${P}activate`, payload: { itemId } }),
@@ -372,6 +374,7 @@ function newItem(kind, key, title, data, now, steps) {
   const id = canvasItemId(kind, key);
   const history = steps?.history ?? [];
   const kept = steps?.kept ?? [];
+  const forward = steps?.forward ?? [];
   return {
     id,
     kind,
@@ -383,7 +386,8 @@ function newItem(kind, key, title, data, now, steps) {
     // 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) } : {}
+    ...kept.length > 0 ? { kept: kept.slice(-CANVAS_KEEP_ALIVE_DEPTH) } : {},
+    ...forward.length > 0 ? { forward: forward.slice(-CANVAS_HISTORY_LIMIT) } : {}
   };
 }
 function historyEntry(item) {
@@ -429,12 +433,14 @@ function sanitizeHistory(raw) {
 function sanitizeItem(item) {
   const history = sanitizeHistory(item.history);
   const kept = sanitizeHistory(item.kept).slice(-CANVAS_KEEP_ALIVE_DEPTH);
-  const { history: _history, kept: _kept, instance, ...rest } = item;
+  const forward = sanitizeHistory(item.forward);
+  const { history: _history, kept: _kept, forward: _forward, instance, ...rest } = item;
   return {
     ...rest,
     ...typeof instance === "string" && instance ? { instance } : {},
     ...history.length > 0 ? { history } : {},
-    ...kept.length > 0 ? { kept } : {}
+    ...kept.length > 0 ? { kept } : {},
+    ...forward.length > 0 ? { forward } : {}
   };
 }
 function clampWidth(width) {
@@ -625,6 +631,9 @@ function canvasReducer(state = createInitialCanvasState(), action) {
       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);
+      const forwardAll = current.forward ?? [];
+      const nextForward = forwardAll[forwardAll.length - 1];
+      const forward = nextForward && canvasItemId(nextForward.kind, nextForward.key) === targetId ? forwardAll.slice(0, -1) : [];
       return replaceInPlace(
         state,
         current,
@@ -634,7 +643,7 @@ function canvasReducer(state = createInitialCanvasState(), action) {
           to.title !== void 0 ? to.title : revived?.title ?? null,
           to.data !== void 0 ? to.data : revived?.data ?? null,
           now,
-          { history, kept, instance: revived?.instance }
+          { history, kept, forward, instance: revived?.instance }
         )
       );
     }
@@ -650,10 +659,36 @@ function canvasReducer(state = createInitialCanvasState(), action) {
         return focusExisting(canvasReducer(state, canvasActions.closeItem(itemId)), targetId);
       }
       const kept = [...(current.kept ?? []).filter((k) => canvasItemId(k.kind, k.key) !== itemId), historyEntry(current)];
+      const forward = [...current.forward ?? [], 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 })
+        newItem(entry.kind, entry.key, entry.title, entry.data, now, { history: history.slice(0, -1), kept, forward, instance: entry.instance })
+      );
+    }
+    case `${P}forward`: {
+      const { itemId, now } = action.payload;
+      const current = state.items[itemId];
+      const forwardAll = current?.forward ?? [];
+      const entry = forwardAll[forwardAll.length - 1];
+      if (!current || !entry || !paneOf(state, itemId)) return state;
+      const targetId = canvasItemId(entry.kind, entry.key);
+      if (targetId === itemId) return state;
+      if (state.items[targetId]) {
+        return focusExisting(canvasReducer(state, canvasActions.closeItem(itemId)), targetId);
+      }
+      const keptAll = current.kept ?? [];
+      const revived = keptAll.find((k) => canvasItemId(k.kind, k.key) === targetId);
+      const kept = keptAll.filter((k) => canvasItemId(k.kind, k.key) !== targetId);
+      return replaceInPlace(
+        state,
+        current,
+        newItem(entry.kind, entry.key, entry.title, entry.data, now, {
+          history: [...current.history ?? [], historyEntry(current)],
+          kept,
+          forward: forwardAll.slice(0, -1),
+          instance: revived?.instance ?? entry.instance
+        })
       );
     }
     case `${P}closeItem`: {
@@ -982,6 +1017,7 @@ function toPersistableSnapshot(state, isRestorable) {
 }
 
 // src/core/rules.ts
+var CANVAS_PANE_MIN_WIDTH = 280;
 var CANVAS_WEB_LAYOUT_RULES = {
   defaultWidth: CANVAS_DEFAULT_WIDTH,
   minWidth: CANVAS_MIN_WIDTH,
@@ -989,7 +1025,9 @@ var CANVAS_WEB_LAYOUT_RULES = {
   // Split down 70/30 like the desktop: what opens below (notifications, a feed) is the smaller pane.
   stackSplit: 0.7,
   sideSplit: 0.5,
-  paneMinWidth: 0
+  // A pane narrower than this cannot show a header (Back, a readable tab, "+", the menu, close) and a
+  // body side by side with another: a split right that would go under it stacks instead.
+  paneMinWidth: CANVAS_PANE_MIN_WIDTH
 };
 var CANVAS_DESKTOP_LAYOUT_RULES = {
   defaultWidth: { fraction: 0.36 },
@@ -1036,6 +1074,9 @@ var CANVAS_SHORTCUTS = [
   { id: "canvas.toggleFullscreen", accelerator: "CmdOrCtrl+Shift+Enter", when: "canvas-focus", label: "Expand canvas", web: true },
   { id: "canvas.splitRight", accelerator: "CmdOrCtrl+Alt+\\", when: "canvas-focus", label: "Split right", web: true },
   { id: "canvas.splitDown", accelerator: "CmdOrCtrl+Alt+Shift+\\", when: "canvas-focus", label: "Split down", web: true },
+  // Browsers own ⌘[ / ⌘] for their own history: data for a desktop host (and the header's Back / Forward).
+  { id: "canvas.back", accelerator: "CmdOrCtrl+[", when: "canvas-focus", label: "Back", web: false },
+  { id: "canvas.forward", accelerator: "CmdOrCtrl+]", when: "canvas-focus", label: "Forward", web: false },
   { id: "canvas.closeTab", accelerator: "CmdOrCtrl+W", when: "canvas-focus", label: "Close tab", web: false },
   { id: "canvas.nextTab", accelerator: "Ctrl+Tab", when: "canvas-focus", label: "Next tab", web: false },
   { id: "canvas.previousTab", accelerator: "Ctrl+Shift+Tab", when: "canvas-focus", label: "Previous tab", web: false }
@@ -1085,11 +1126,17 @@ function runCanvasCommand(controller, id, windowId = controller.windowId) {
       if (!frame2?.isOpen || !pane) return false;
       controller.splitPane(pane.id, id === "canvas.splitRight" ? "horizontal" : "vertical", pane.itemIds.length > 1 ? pane.activeItemId ?? void 0 : void 0);
       return true;
+    case "canvas.back":
+      if (!frame2?.isOpen || !pane?.activeItemId) return false;
+      return controller.back(pane.activeItemId) !== null;
+    case "canvas.forward":
+      if (!frame2?.isOpen || !pane?.activeItemId) return false;
+      return controller.forward(pane.activeItemId) !== null;
     default:
       return false;
   }
 }
-var CODE_FOR = { "\\": "Backslash", Tab: "Tab", Escape: "Escape", Enter: "Enter" };
+var CODE_FOR = { "\\": "Backslash", "[": "BracketLeft", "]": "BracketRight", Tab: "Tab", Escape: "Escape", Enter: "Enter" };
 function matchesCanvasAccelerator(input, accelerator, isMac) {
   const parts = accelerator.split("+");
   const key = parts.pop() ?? "";
@@ -1206,6 +1253,13 @@ function view(shared, windowId) {
       dispatch(canvasActions.back(itemId));
       return canvasItemId(entry.kind, entry.key);
     },
+    forward(itemId) {
+      const forward = store.getState().items[itemId]?.forward ?? [];
+      const entry = forward[forward.length - 1];
+      if (!entry) return null;
+      dispatch(canvasActions.forward(itemId));
+      return canvasItemId(entry.kind, entry.key);
+    },
     newTab(paneId) {
       const state = store.getState();
       const frame2 = canvasWindowFrame(state, windowId);
@@ -1489,6 +1543,16 @@ function selectCanvasItemHistory(s, itemId) {
   return s.items[itemId]?.history ?? NO_HISTORY;
 }
 var selectCanvasCanGoBack = (s, itemId) => (s.items[itemId]?.history?.length ?? 0) > 0;
+var selectCanvasCanGoForward = (s, itemId) => (s.items[itemId]?.forward?.length ?? 0) > 0;
+function selectCanvasPresentedPaneId(s, windowId) {
+  const f = frame(s, windowId);
+  if (!f) return null;
+  const ids = listPaneIds(f.layout);
+  const holds = (id) => (s.panes[id]?.itemIds.length ?? 0) > 0;
+  const focused = ids.find((id) => id === f.focusedPaneId);
+  if (focused && holds(focused)) return focused;
+  return ids.find(holds) ?? focused ?? ids[0] ?? null;
+}
 
 // src/core/presentation.ts
 var CANVAS_PHONE_MAX_WIDTH = 767;
@@ -1538,7 +1602,9 @@ function toggleKind(controller, input) {
   const before = selectCanvasKindVisibility(controller.getState(), input.kind, key);
   if (before === "visible") {
     if ((input.whenVisible ?? "close") === "close") {
+      const windowId = canvasWindowOfItem(controller.getState(), itemId);
       controller.close(itemId);
+      if (windowId && selectCanvasWindowItemCount(controller.getState(), windowId) === 0) controller.hide(windowId);
     } else {
       controller.hide(canvasWindowOfItem(controller.getState(), itemId) ?? void 0);
     }
@@ -1569,6 +1635,7 @@ export {
   CANVAS_MIN_SPLIT_FRACTION,
   CANVAS_MIN_WIDTH,
   CANVAS_NARROW_WIDTH,
+  CANVAS_PANE_MIN_WIDTH,
   CANVAS_PHONE_MAX_WIDTH,
   CANVAS_SHORTCUTS,
   CANVAS_STORAGE_KEY,
@@ -1609,6 +1676,7 @@ export {
   sanitizeCanvasSnapshot,
   selectCanvasActiveItem,
   selectCanvasCanGoBack,
+  selectCanvasCanGoForward,
   selectCanvasExtraWindow,
   selectCanvasFocusedPaneId,
   selectCanvasIsFullscreen,
@@ -1621,6 +1689,7 @@ export {
   selectCanvasLayout,
   selectCanvasPane,
   selectCanvasPaneCount,
+  selectCanvasPresentedPaneId,
   selectCanvasWidth,
   selectCanvasWindowItemCount,
   selectCanvasWindowOfItem,