@ai-matrx/canvas 0.8.4 → 0.9.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-BoFnqhzq.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-BoFnqhzq.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-CI2nBjum.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_HEIGHT, y as CANVAS_PANE_MIN_WIDTH, z as CANVAS_PHONE_MAX_WIDTH, A as CANVAS_STORAGE_KEY, B as CANVAS_WEB_LAYOUT_RULES, D as CanvasControllerOptions, E as CanvasErrorReport, F as CanvasErrorSink, G as CanvasKeyValueStore, H as CanvasKindVisibility, I as CanvasLayoutRules, J as CanvasNavigateInput, K as CanvasOpenInput, L as CanvasOpenTarget, M as CanvasOrientation, N as CanvasPaneMeasure, O as CanvasPersistencePort, P as CanvasPreferredTarget, Q as CanvasPresentation, R as CanvasPresentationOrientation, S as CanvasRect, T as CanvasSessionAttachReason, U as CanvasSessionDetachReason, V as CanvasSessionEvent, W as CanvasSessionHooks, X as CanvasSplitId, Y as CanvasWindowCloseMode, Z as CanvasWindowFrame, _ as CanvasWindowPorts, $ as ReduxStoreLike, a0 as ToggleKindInput, a1 as bindCanvasToReduxStore, a2 as canvasActions, a3 as canvasOrientation, a4 as canvasPresentation, a5 as canvasReducer, a6 as canvasWindowFrame, a7 as canvasWindowOfPane, a8 as clampDraggedCanvasWidth, a9 as consoleCanvasErrorSink, aa as createCanvasController, ab as createCanvasStore, ac as createInitialCanvasState, ad as createKeyValueCanvasPersistence, ae as createLocalStorageCanvasPersistence, af as defaultCanvasWidth, ag as fitCanvasSplit, ah as fitCanvasSplitSizes, ai as fitCanvasWidth, aj as foldCanvasWindows, ak as isCanvasAction, al as listCanvasWindowIds, am as preferredFlowDirection, an as resolveCanvasLayoutRules, ao as sanitizeCanvasSnapshot, ap as selectCanvasKindVisibility, aq as shouldStackSplit, ar as toPersistableSnapshot, as as toggleKind } from './toggleKind-CI2nBjum.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-BoFnqhzq.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-BoFnqhzq.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-CI2nBjum.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_HEIGHT, y as CANVAS_PANE_MIN_WIDTH, z as CANVAS_PHONE_MAX_WIDTH, A as CANVAS_STORAGE_KEY, B as CANVAS_WEB_LAYOUT_RULES, D as CanvasControllerOptions, E as CanvasErrorReport, F as CanvasErrorSink, G as CanvasKeyValueStore, H as CanvasKindVisibility, I as CanvasLayoutRules, J as CanvasNavigateInput, K as CanvasOpenInput, L as CanvasOpenTarget, M as CanvasOrientation, N as CanvasPaneMeasure, O as CanvasPersistencePort, P as CanvasPreferredTarget, Q as CanvasPresentation, R as CanvasPresentationOrientation, S as CanvasRect, T as CanvasSessionAttachReason, U as CanvasSessionDetachReason, V as CanvasSessionEvent, W as CanvasSessionHooks, X as CanvasSplitId, Y as CanvasWindowCloseMode, Z as CanvasWindowFrame, _ as CanvasWindowPorts, $ as ReduxStoreLike, a0 as ToggleKindInput, a1 as bindCanvasToReduxStore, a2 as canvasActions, a3 as canvasOrientation, a4 as canvasPresentation, a5 as canvasReducer, a6 as canvasWindowFrame, a7 as canvasWindowOfPane, a8 as clampDraggedCanvasWidth, a9 as consoleCanvasErrorSink, aa as createCanvasController, ab as createCanvasStore, ac as createInitialCanvasState, ad as createKeyValueCanvasPersistence, ae as createLocalStorageCanvasPersistence, af as defaultCanvasWidth, ag as fitCanvasSplit, ah as fitCanvasSplitSizes, ai as fitCanvasWidth, aj as foldCanvasWindows, ak as isCanvasAction, al as listCanvasWindowIds, am as preferredFlowDirection, an as resolveCanvasLayoutRules, ao as sanitizeCanvasSnapshot, ap as selectCanvasKindVisibility, aq as shouldStackSplit, ar as toPersistableSnapshot, as as toggleKind } from './toggleKind-CI2nBjum.js';
 
 declare function canvasItemId(kind: string, key: string): CanvasItemId;
 declare function parseCanvasItemId(id: CanvasItemId): {

package/dist/index.js

@@ -1018,6 +1018,7 @@ function toPersistableSnapshot(state, isRestorable) {
 
 // src/core/rules.ts
 var CANVAS_PANE_MIN_WIDTH = 280;
+var CANVAS_PANE_MIN_HEIGHT = 200;
 var CANVAS_WEB_LAYOUT_RULES = {
   defaultWidth: CANVAS_DEFAULT_WIDTH,
   minWidth: CANVAS_MIN_WIDTH,
@@ -1031,7 +1032,10 @@ var CANVAS_WEB_LAYOUT_RULES = {
   sideSplit: 0.5,
   // 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
+  paneMinWidth: CANVAS_PANE_MIN_WIDTH,
+  // 2026-10-07 live: Quick Notes / Notifications / Quick Chat stacked in an 800px window left
+  // Notifications its header and one row.
+  paneMinHeight: CANVAS_PANE_MIN_HEIGHT
 };
 var CANVAS_DESKTOP_LAYOUT_RULES = {
   defaultWidth: { fraction: 0.36 },
@@ -1039,7 +1043,8 @@ var CANVAS_DESKTOP_LAYOUT_RULES = {
   centreMinWidth: 520,
   stackSplit: 0.7,
   sideSplit: 0.5,
-  paneMinWidth: 360
+  paneMinWidth: 360,
+  paneMinHeight: CANVAS_PANE_MIN_HEIGHT
 };
 var clampFraction = (value, fallback) => Number.isFinite(value) ? Math.min(0.88, Math.max(0.12, value)) : fallback;
 function resolveCanvasLayoutRules(rules) {
@@ -1051,7 +1056,8 @@ function resolveCanvasLayoutRules(rules) {
     centreMinWidth: positive(merged.centreMinWidth, CANVAS_WEB_LAYOUT_RULES.centreMinWidth),
     stackSplit: clampFraction(merged.stackSplit, 0.5),
     sideSplit: clampFraction(merged.sideSplit, 0.5),
-    paneMinWidth: positive(merged.paneMinWidth, 0)
+    paneMinWidth: positive(merged.paneMinWidth, 0),
+    paneMinHeight: positive(merged.paneMinHeight, 0)
   };
 }
 function defaultCanvasWidth(rules, region) {
@@ -1070,6 +1076,30 @@ function clampDraggedCanvasWidth(next, region, rules) {
 function shouldStackSplit(width, children, rules) {
   return rules.paneMinWidth > 0 && width > 0 && width < rules.paneMinWidth * children;
 }
+function fitCanvasSplit(size, orientation, rules) {
+  if (!size || size.width <= 0 || size.height <= 0) return orientation;
+  const sideFits = rules.paneMinWidth <= 0 || size.width >= 2 * rules.paneMinWidth;
+  const stackFits = rules.paneMinHeight <= 0 || size.height >= 2 * rules.paneMinHeight;
+  if (orientation === "horizontal") return sideFits || stackFits ? "horizontal" : null;
+  return stackFits ? "vertical" : sideFits ? "horizontal" : null;
+}
+function fitCanvasSplitSizes(sizes, total, mins) {
+  if (!(total > 0) || sizes.length === 0) return [...sizes];
+  const sum = sizes.reduce((a, b) => a + b, 0) || 1;
+  const px = sizes.map((s) => s / sum * total);
+  const floor = mins.map((m) => Number.isFinite(m) && m > 0 ? m : 0);
+  const needed = floor.reduce((a, b) => a + b, 0);
+  if (needed >= total) return needed > 0 ? floor.map((m) => m / needed) : px.map((p) => p / total);
+  const short = px.reduce((acc, p, i) => acc + Math.max(0, (floor[i] ?? 0) - p), 0);
+  if (short <= 0) return px.map((p) => p / total);
+  const spare = px.map((p, i) => Math.max(0, p - (floor[i] ?? 0)));
+  const spareSum = spare.reduce((a, b) => a + b, 0);
+  return px.map((p, i) => {
+    const min = floor[i] ?? 0;
+    if (p <= min) return min / total;
+    return (p - short * (spare[i] ?? 0) / spareSum) / total;
+  });
+}
 
 // src/core/commands.ts
 var CANVAS_SHORTCUTS = [
@@ -1167,6 +1197,7 @@ function createCanvasController(options) {
     options,
     onError: options.onError ?? consoleCanvasErrorSink,
     rules: resolveCanvasLayoutRules(options.layoutRules),
+    measures: /* @__PURE__ */ new Set(),
     presentations: /* @__PURE__ */ new Map(),
     presentationListeners: /* @__PURE__ */ new Set(),
     views: /* @__PURE__ */ new Map(),
@@ -1187,6 +1218,14 @@ function view(shared, windowId) {
     for (const listener of [...shared.presentationListeners]) listener();
   };
   const shareFor = (orientation) => orientation === "vertical" ? rules.stackSplit : rules.sideSplit;
+  const measurePane = (paneId) => {
+    for (const measure of shared.measures) {
+      const size = measure(paneId);
+      if (size) return size;
+    }
+    return null;
+  };
+  const fitSplit = (paneId, orientation) => fitCanvasSplit(measurePane(paneId), orientation, rules);
   const acceptable = (input) => {
     if (input.kind !== CANVAS_LAUNCHER_KIND && options.isKnownKind && !options.isKnownKind(input.kind)) {
       onError({ code: "unknown-kind", message: `No canvas kind "${input.kind}" is registered.`, detail: input });
@@ -1217,6 +1256,13 @@ function view(shared, windowId) {
     if (holding) return { paneId: holding };
     return state.panes[frame2.focusedPaneId]?.activeItemId ? preferred : "focused";
   };
+  const splitTargetFor = (asked, forWindow) => {
+    const state = store.getState();
+    const frame2 = canvasWindowFrame(state, forWindow ? canvasWindowId(forWindow) : windowId);
+    if (!frame2) return asked;
+    const fitted = fitSplit(frame2.focusedPaneId, asked === "split-down" ? "vertical" : "horizontal");
+    return fitted === null ? "focused" : fitted === "vertical" ? "split-down" : "split-right";
+  };
   const controller = {
     store,
     windowId,
@@ -1225,7 +1271,8 @@ function view(shared, windowId) {
     getState: () => store.getState(),
     open(input) {
       if (!acceptable(input)) return null;
-      const target = input.target ?? preferredTargetFor(input);
+      const asked = input.target ?? preferredTargetFor(input);
+      const target = asked === "split-down" || asked === "split-right" ? splitTargetFor(asked, input.windowId) : asked;
       const splitShare = target === "split-down" ? rules.stackSplit : target === "split-right" ? rules.sideSplit : void 0;
       const withTarget = input.target === target ? input : { ...input, target };
       const resolved = withTarget.windowId || windowId === CANVAS_MAIN_WINDOW ? withTarget : { ...withTarget, windowId };
@@ -1290,7 +1337,15 @@ function view(shared, windowId) {
     activate: (itemId) => dispatch(canvasActions.activate(itemId)),
     focusPane: (paneId) => dispatch(canvasActions.focusPane(paneId)),
     moveItem: (itemId, toPaneId, index) => dispatch(canvasActions.moveItem(itemId, toPaneId, index)),
-    splitPane: (paneId, orientation, moveItemId) => dispatch(canvasActions.splitPane(paneId, orientation, moveItemId, shareFor(orientation))),
+    splitPane(paneId, orientation, moveItemId) {
+      const fitted = fitSplit(paneId, orientation);
+      if (fitted) dispatch(canvasActions.splitPane(paneId, fitted, moveItemId, shareFor(fitted)));
+    },
+    fitSplit,
+    registerPaneMeasure(measure) {
+      shared.measures.add(measure);
+      return () => void shared.measures.delete(measure);
+    },
     closePane: (paneId) => dispatch(canvasActions.closePane(paneId)),
     resizeSplit: (splitId, sizes) => dispatch(canvasActions.resizeSplit(splitId, sizes)),
     show: (w = windowId) => dispatch(canvasActions.setOpen(true, w)),
@@ -1639,6 +1694,7 @@ export {
   CANVAS_MIN_SPLIT_FRACTION,
   CANVAS_MIN_WIDTH,
   CANVAS_NARROW_WIDTH,
+  CANVAS_PANE_MIN_HEIGHT,
   CANVAS_PANE_MIN_WIDTH,
   CANVAS_PHONE_MAX_WIDTH,
   CANVAS_SHORTCUTS,
@@ -1665,6 +1721,8 @@ export {
   createRemoteCanvasStore,
   defaultCanvasWidth,
   findNonJson,
+  fitCanvasSplit,
+  fitCanvasSplitSizes,
   fitCanvasWidth,
   foldCanvasWindows,
   isCanvasAction,