@ai-matrx/canvas 0.8.5 → 0.9.1

package/dist/styles.css

@@ -453,9 +453,9 @@
  * THE STRIP takes the header's free width (flex-basis 0: what it shows never
  * changes how wide it is). Tabs share it evenly — 12rem each with room,
  * shrinking together to a readable floor (--mxc-tab-min: icon + ~10 letters +
- * "…") — and past the floor the tab list scrolls sideways (no scrollbar drawn;
- * wheel, trackpad and the current tab kept in view) beside "All tabs". A tab
- * never shrinks to a sliver and nothing overlaps a control.
+ * "…") — and past the floor only the tabs that fit WHOLE are drawn, around
+ * the current one; "All tabs" holds the rest. A tab is never sliced at an
+ * edge, never a sliver, and nothing overlaps a control.
  */
 .mxc-tabstrip {
   flex: 1 1 0;
@@ -474,17 +474,16 @@
   display: flex;
   align-items: center;
   gap: 0.125rem;
-  overflow-x: auto;
-  overflow-y: hidden;
-  overscroll-behavior-x: contain;
-  scrollbar-width: none;
+  overflow: hidden;
 }
 
-.mxc-tabs::-webkit-scrollbar {
-  display: none;
+/* The current tab alone is wider than the room (a phone's header): it goes under its floor, its name ending in "…". */
+.mxc-tabs[data-squeezed] > .mxc-tab,
+.mxc-tabs[data-squeezed] > .mxc-tab-group {
+  min-width: 0;
 }
 
-/* "All tabs": a chevron and how many tabs are out of sight. */
+/* "All tabs": how many tabs are out of the strip, and a chevron. */
 .mxc-tab-list {
   flex: none;
   width: auto;
@@ -493,6 +492,12 @@
   padding: 0 0.25rem;
 }
 
+.mxc-tab-list-count {
+  font-size: 0.6875rem;
+  font-variant-numeric: tabular-nums;
+  line-height: 1;
+}
+
 .mxc-tab-list-menu {
   max-height: min(24rem, 70vh);
   overflow-y: auto;

package/dist/{toggleKind-BoFnqhzq.d.cts → toggleKind-CI2nBjum.d.cts}

@@ -491,6 +491,12 @@ declare function toPersistableSnapshot(state: CanvasState, isRestorable: (kind:
  */
 /** The web's narrowest side-by-side pane (px): below it, a side-by-side split renders stacked. */
 declare const CANVAS_PANE_MIN_WIDTH = 280;
+/**
+ * The shortest pane (px): its header plus a body that shows a few rows of a
+ * list. A stack gives every pane at least this; a split that cannot opens the
+ * other way, or as a tab.
+ */
+declare const CANVAS_PANE_MIN_HEIGHT = 200;
 interface CanvasLayoutRules {
     /** Width before the person drags the edge: CSS px, or a fraction of the region the canvas shares. */
     readonly defaultWidth: number | {
@@ -506,6 +512,8 @@ interface CanvasLayoutRules {
     readonly sideSplit: number;
     /** Side-by-side panes that would be narrower than this render stacked. 0 = never. */
     readonly paneMinWidth: number;
+    /** Stacked panes keep at least this height; a split that would go under it opens the other way or as a tab. 0 = never. */
+    readonly paneMinHeight: number;
 }
 /** The web app's numbers (the defaults). */
 declare const CANVAS_WEB_LAYOUT_RULES: CanvasLayoutRules;
@@ -525,6 +533,26 @@ declare function fitCanvasWidth(stored: number | null, region: number, rules: Ca
 declare function clampDraggedCanvasWidth(next: number, region: number, rules: CanvasLayoutRules): number;
 /** Whether a side-by-side split this wide (px) with this many children renders stacked. */
 declare function shouldStackSplit(width: number, children: number, rules: CanvasLayoutRules): boolean;
+/**
+ * Where a new split of a pane this size goes. The asked orientation when both
+ * panes keep their minimum; else the other axis when IT fits; else null — the
+ * new tab joins the pane instead (a pane is never split into two too small to
+ * use). A side-by-side split that is too narrow but tall enough is kept: it
+ * renders stacked (`shouldStackSplit`) and gets its columns back when wider.
+ * An unmeasured pane (no size) splits as asked.
+ */
+declare function fitCanvasSplit(size: {
+    readonly width: number;
+    readonly height: number;
+} | null | undefined, orientation: "horizontal" | "vertical", rules: CanvasLayoutRules): "horizontal" | "vertical" | null;
+/**
+ * A split's shares, fitted so every child keeps its minimum (px) along the
+ * split: what a child is short of comes out of the children above their
+ * minimum, in proportion to their spare room. When the minimums together do
+ * not fit, each child gets its minimum's share of the room. `total` 0 (not
+ * measured) keeps the shares.
+ */
+declare function fitCanvasSplitSizes(sizes: readonly number[], total: number, mins: readonly number[]): number[];
 
 /**
  * The canvas controller: the ONE imperative API every caller uses. It wraps a
@@ -643,8 +671,20 @@ interface CanvasController {
     activate(itemId: CanvasItemId): void;
     focusPane(paneId: CanvasPaneId): void;
     moveItem(itemId: CanvasItemId, toPaneId: CanvasPaneId, index?: number): void;
-    /** Splits with the layout rules' share (stackSplit for "vertical", sideSplit for "horizontal"). */
+    /**
+     * Splits with the layout rules' share (stackSplit for "vertical", sideSplit for "horizontal").
+     * A split that would leave a pane under `paneMinHeight` / `paneMinWidth` goes the other way, or
+     * not at all (see `fitSplit`).
+     */
     splitPane(paneId: CanvasPaneId, orientation: CanvasOrientation, moveItemId?: CanvasItemId): void;
+    /**
+     * Where a split of this pane would go right now: the asked orientation, the other one when only
+     * it keeps both panes usable, or null (no room — a "split" open joins the pane as a tab).
+     * Measured through `registerPaneMeasure`; an unmeasured pane splits as asked.
+     */
+    fitSplit(paneId: CanvasPaneId, orientation: CanvasOrientation): CanvasOrientation | null;
+    /** A column reports its panes' drawn sizes (px) so splits respect the minimums. Returns the unregister. */
+    registerPaneMeasure(measure: CanvasPaneMeasure): () => void;
     closePane(paneId: CanvasPaneId): void;
     resizeSplit(splitId: CanvasSplitId, sizes: readonly number[]): void;
     show(windowId?: CanvasWindowId): void;
@@ -672,6 +712,11 @@ interface CanvasController {
     /** Loads the persisted snapshot, starts autosave and session tracking. Returns a disposer. */
     start(): () => void;
 }
+/** A pane's drawn size in CSS px, or null when this measurer does not draw it. */
+type CanvasPaneMeasure = (paneId: CanvasPaneId) => {
+    readonly width: number;
+    readonly height: number;
+} | null;
 declare function createCanvasController(options: CanvasControllerOptions): CanvasController;
 
 /**
@@ -751,4 +796,4 @@ interface ToggleKindInput {
 /** Returns what the item is after the click. */
 declare function toggleKind(controller: CanvasController, input: ToggleKindInput): CanvasKindVisibility;
 
-export { bindCanvasToReduxStore as $, CANVAS_WEB_LAYOUT_RULES as A, type CanvasControllerOptions as B, type CanvasItemId as C, type CanvasErrorReport as D, type CanvasErrorSink as E, type CanvasKeyValueStore as F, type CanvasKindVisibility as G, type CanvasLayoutRules as H, type CanvasNavigateInput as I, type CanvasOpenInput as J, type CanvasOpenTarget as K, type CanvasOrientation as L, type CanvasPersistencePort as M, type CanvasPreferredTarget as N, type CanvasPresentation as O, type CanvasPresentationOrientation as P, type CanvasRect as Q, type CanvasSessionAttachReason as R, type CanvasSessionDetachReason as S, type CanvasSessionEvent as T, type CanvasSessionHooks as U, type CanvasSplitId as V, type CanvasWindowCloseMode as W, type CanvasWindowFrame as X, type CanvasWindowPorts as Y, type ReduxStoreLike as Z, type ToggleKindInput as _, type CanvasWindowId as a, canvasActions as a0, canvasOrientation as a1, canvasPresentation as a2, canvasReducer as a3, canvasWindowFrame as a4, canvasWindowOfPane as a5, clampDraggedCanvasWidth as a6, consoleCanvasErrorSink as a7, createCanvasController as a8, createCanvasStore as a9, createInitialCanvasState as aa, createKeyValueCanvasPersistence as ab, createLocalStorageCanvasPersistence as ac, defaultCanvasWidth as ad, fitCanvasWidth as ae, foldCanvasWindows as af, isCanvasAction as ag, listCanvasWindowIds as ah, preferredFlowDirection as ai, resolveCanvasLayoutRules as aj, sanitizeCanvasSnapshot as ak, selectCanvasKindVisibility as al, shouldStackSplit as am, toPersistableSnapshot as an, toggleKind as ao, type CanvasJson as b, type CanvasLayoutNode as c, type CanvasPaneId as d, type CanvasStoreBinding as e, type CanvasState as f, type CanvasAction as g, type CanvasController as h, type CanvasItem as i, type CanvasExtraWindow as j, type CanvasHistoryEntry as k, type CanvasPane as l, canvasWindowOfItem as m, CANVAS_DEFAULT_KEY as n, CANVAS_DEFAULT_WIDTH as o, CANVAS_DESKTOP_LAYOUT_RULES as p, CANVAS_HISTORY_LIMIT as q, CANVAS_KEEP_ALIVE_DEPTH as r, CANVAS_LAUNCHER_KIND as s, CANVAS_MAIN_WINDOW as t, CANVAS_MIN_SPLIT_FRACTION as u, CANVAS_MIN_WIDTH as v, CANVAS_NARROW_WIDTH as w, CANVAS_PANE_MIN_WIDTH as x, CANVAS_PHONE_MAX_WIDTH as y, CANVAS_STORAGE_KEY as z };
+export { type ReduxStoreLike as $, CANVAS_STORAGE_KEY as A, CANVAS_WEB_LAYOUT_RULES as B, type CanvasItemId as C, type CanvasControllerOptions as D, type CanvasErrorReport as E, type CanvasErrorSink as F, type CanvasKeyValueStore as G, type CanvasKindVisibility as H, type CanvasLayoutRules as I, type CanvasNavigateInput as J, type CanvasOpenInput as K, type CanvasOpenTarget as L, type CanvasOrientation as M, type CanvasPaneMeasure as N, type CanvasPersistencePort as O, type CanvasPreferredTarget as P, type CanvasPresentation as Q, type CanvasPresentationOrientation as R, type CanvasRect as S, type CanvasSessionAttachReason as T, type CanvasSessionDetachReason as U, type CanvasSessionEvent as V, type CanvasSessionHooks as W, type CanvasSplitId as X, type CanvasWindowCloseMode as Y, type CanvasWindowFrame as Z, type CanvasWindowPorts as _, type CanvasWindowId as a, type ToggleKindInput as a0, bindCanvasToReduxStore as a1, canvasActions as a2, canvasOrientation as a3, canvasPresentation as a4, canvasReducer as a5, canvasWindowFrame as a6, canvasWindowOfPane as a7, clampDraggedCanvasWidth as a8, consoleCanvasErrorSink as a9, createCanvasController as aa, createCanvasStore as ab, createInitialCanvasState as ac, createKeyValueCanvasPersistence as ad, createLocalStorageCanvasPersistence as ae, defaultCanvasWidth as af, fitCanvasSplit as ag, fitCanvasSplitSizes as ah, fitCanvasWidth as ai, foldCanvasWindows as aj, isCanvasAction as ak, listCanvasWindowIds as al, preferredFlowDirection as am, resolveCanvasLayoutRules as an, sanitizeCanvasSnapshot as ao, selectCanvasKindVisibility as ap, shouldStackSplit as aq, toPersistableSnapshot as ar, toggleKind as as, type CanvasJson as b, type CanvasLayoutNode as c, type CanvasPaneId as d, type CanvasStoreBinding as e, type CanvasState as f, type CanvasAction as g, type CanvasController as h, type CanvasItem as i, type CanvasExtraWindow as j, type CanvasHistoryEntry as k, type CanvasPane as l, canvasWindowOfItem as m, CANVAS_DEFAULT_KEY as n, CANVAS_DEFAULT_WIDTH as o, CANVAS_DESKTOP_LAYOUT_RULES as p, CANVAS_HISTORY_LIMIT as q, CANVAS_KEEP_ALIVE_DEPTH as r, CANVAS_LAUNCHER_KIND as s, CANVAS_MAIN_WINDOW as t, CANVAS_MIN_SPLIT_FRACTION as u, CANVAS_MIN_WIDTH as v, CANVAS_NARROW_WIDTH as w, CANVAS_PANE_MIN_HEIGHT as x, CANVAS_PANE_MIN_WIDTH as y, CANVAS_PHONE_MAX_WIDTH as z };

package/dist/{toggleKind-BoFnqhzq.d.ts → toggleKind-CI2nBjum.d.ts}

@@ -491,6 +491,12 @@ declare function toPersistableSnapshot(state: CanvasState, isRestorable: (kind:
  */
 /** The web's narrowest side-by-side pane (px): below it, a side-by-side split renders stacked. */
 declare const CANVAS_PANE_MIN_WIDTH = 280;
+/**
+ * The shortest pane (px): its header plus a body that shows a few rows of a
+ * list. A stack gives every pane at least this; a split that cannot opens the
+ * other way, or as a tab.
+ */
+declare const CANVAS_PANE_MIN_HEIGHT = 200;
 interface CanvasLayoutRules {
     /** Width before the person drags the edge: CSS px, or a fraction of the region the canvas shares. */
     readonly defaultWidth: number | {
@@ -506,6 +512,8 @@ interface CanvasLayoutRules {
     readonly sideSplit: number;
     /** Side-by-side panes that would be narrower than this render stacked. 0 = never. */
     readonly paneMinWidth: number;
+    /** Stacked panes keep at least this height; a split that would go under it opens the other way or as a tab. 0 = never. */
+    readonly paneMinHeight: number;
 }
 /** The web app's numbers (the defaults). */
 declare const CANVAS_WEB_LAYOUT_RULES: CanvasLayoutRules;
@@ -525,6 +533,26 @@ declare function fitCanvasWidth(stored: number | null, region: number, rules: Ca
 declare function clampDraggedCanvasWidth(next: number, region: number, rules: CanvasLayoutRules): number;
 /** Whether a side-by-side split this wide (px) with this many children renders stacked. */
 declare function shouldStackSplit(width: number, children: number, rules: CanvasLayoutRules): boolean;
+/**
+ * Where a new split of a pane this size goes. The asked orientation when both
+ * panes keep their minimum; else the other axis when IT fits; else null — the
+ * new tab joins the pane instead (a pane is never split into two too small to
+ * use). A side-by-side split that is too narrow but tall enough is kept: it
+ * renders stacked (`shouldStackSplit`) and gets its columns back when wider.
+ * An unmeasured pane (no size) splits as asked.
+ */
+declare function fitCanvasSplit(size: {
+    readonly width: number;
+    readonly height: number;
+} | null | undefined, orientation: "horizontal" | "vertical", rules: CanvasLayoutRules): "horizontal" | "vertical" | null;
+/**
+ * A split's shares, fitted so every child keeps its minimum (px) along the
+ * split: what a child is short of comes out of the children above their
+ * minimum, in proportion to their spare room. When the minimums together do
+ * not fit, each child gets its minimum's share of the room. `total` 0 (not
+ * measured) keeps the shares.
+ */
+declare function fitCanvasSplitSizes(sizes: readonly number[], total: number, mins: readonly number[]): number[];
 
 /**
  * The canvas controller: the ONE imperative API every caller uses. It wraps a
@@ -643,8 +671,20 @@ interface CanvasController {
     activate(itemId: CanvasItemId): void;
     focusPane(paneId: CanvasPaneId): void;
     moveItem(itemId: CanvasItemId, toPaneId: CanvasPaneId, index?: number): void;
-    /** Splits with the layout rules' share (stackSplit for "vertical", sideSplit for "horizontal"). */
+    /**
+     * Splits with the layout rules' share (stackSplit for "vertical", sideSplit for "horizontal").
+     * A split that would leave a pane under `paneMinHeight` / `paneMinWidth` goes the other way, or
+     * not at all (see `fitSplit`).
+     */
     splitPane(paneId: CanvasPaneId, orientation: CanvasOrientation, moveItemId?: CanvasItemId): void;
+    /**
+     * Where a split of this pane would go right now: the asked orientation, the other one when only
+     * it keeps both panes usable, or null (no room — a "split" open joins the pane as a tab).
+     * Measured through `registerPaneMeasure`; an unmeasured pane splits as asked.
+     */
+    fitSplit(paneId: CanvasPaneId, orientation: CanvasOrientation): CanvasOrientation | null;
+    /** A column reports its panes' drawn sizes (px) so splits respect the minimums. Returns the unregister. */
+    registerPaneMeasure(measure: CanvasPaneMeasure): () => void;
     closePane(paneId: CanvasPaneId): void;
     resizeSplit(splitId: CanvasSplitId, sizes: readonly number[]): void;
     show(windowId?: CanvasWindowId): void;
@@ -672,6 +712,11 @@ interface CanvasController {
     /** Loads the persisted snapshot, starts autosave and session tracking. Returns a disposer. */
     start(): () => void;
 }
+/** A pane's drawn size in CSS px, or null when this measurer does not draw it. */
+type CanvasPaneMeasure = (paneId: CanvasPaneId) => {
+    readonly width: number;
+    readonly height: number;
+} | null;
 declare function createCanvasController(options: CanvasControllerOptions): CanvasController;
 
 /**
@@ -751,4 +796,4 @@ interface ToggleKindInput {
 /** Returns what the item is after the click. */
 declare function toggleKind(controller: CanvasController, input: ToggleKindInput): CanvasKindVisibility;
 
-export { bindCanvasToReduxStore as $, CANVAS_WEB_LAYOUT_RULES as A, type CanvasControllerOptions as B, type CanvasItemId as C, type CanvasErrorReport as D, type CanvasErrorSink as E, type CanvasKeyValueStore as F, type CanvasKindVisibility as G, type CanvasLayoutRules as H, type CanvasNavigateInput as I, type CanvasOpenInput as J, type CanvasOpenTarget as K, type CanvasOrientation as L, type CanvasPersistencePort as M, type CanvasPreferredTarget as N, type CanvasPresentation as O, type CanvasPresentationOrientation as P, type CanvasRect as Q, type CanvasSessionAttachReason as R, type CanvasSessionDetachReason as S, type CanvasSessionEvent as T, type CanvasSessionHooks as U, type CanvasSplitId as V, type CanvasWindowCloseMode as W, type CanvasWindowFrame as X, type CanvasWindowPorts as Y, type ReduxStoreLike as Z, type ToggleKindInput as _, type CanvasWindowId as a, canvasActions as a0, canvasOrientation as a1, canvasPresentation as a2, canvasReducer as a3, canvasWindowFrame as a4, canvasWindowOfPane as a5, clampDraggedCanvasWidth as a6, consoleCanvasErrorSink as a7, createCanvasController as a8, createCanvasStore as a9, createInitialCanvasState as aa, createKeyValueCanvasPersistence as ab, createLocalStorageCanvasPersistence as ac, defaultCanvasWidth as ad, fitCanvasWidth as ae, foldCanvasWindows as af, isCanvasAction as ag, listCanvasWindowIds as ah, preferredFlowDirection as ai, resolveCanvasLayoutRules as aj, sanitizeCanvasSnapshot as ak, selectCanvasKindVisibility as al, shouldStackSplit as am, toPersistableSnapshot as an, toggleKind as ao, type CanvasJson as b, type CanvasLayoutNode as c, type CanvasPaneId as d, type CanvasStoreBinding as e, type CanvasState as f, type CanvasAction as g, type CanvasController as h, type CanvasItem as i, type CanvasExtraWindow as j, type CanvasHistoryEntry as k, type CanvasPane as l, canvasWindowOfItem as m, CANVAS_DEFAULT_KEY as n, CANVAS_DEFAULT_WIDTH as o, CANVAS_DESKTOP_LAYOUT_RULES as p, CANVAS_HISTORY_LIMIT as q, CANVAS_KEEP_ALIVE_DEPTH as r, CANVAS_LAUNCHER_KIND as s, CANVAS_MAIN_WINDOW as t, CANVAS_MIN_SPLIT_FRACTION as u, CANVAS_MIN_WIDTH as v, CANVAS_NARROW_WIDTH as w, CANVAS_PANE_MIN_WIDTH as x, CANVAS_PHONE_MAX_WIDTH as y, CANVAS_STORAGE_KEY as z };
+export { type ReduxStoreLike as $, CANVAS_STORAGE_KEY as A, CANVAS_WEB_LAYOUT_RULES as B, type CanvasItemId as C, type CanvasControllerOptions as D, type CanvasErrorReport as E, type CanvasErrorSink as F, type CanvasKeyValueStore as G, type CanvasKindVisibility as H, type CanvasLayoutRules as I, type CanvasNavigateInput as J, type CanvasOpenInput as K, type CanvasOpenTarget as L, type CanvasOrientation as M, type CanvasPaneMeasure as N, type CanvasPersistencePort as O, type CanvasPreferredTarget as P, type CanvasPresentation as Q, type CanvasPresentationOrientation as R, type CanvasRect as S, type CanvasSessionAttachReason as T, type CanvasSessionDetachReason as U, type CanvasSessionEvent as V, type CanvasSessionHooks as W, type CanvasSplitId as X, type CanvasWindowCloseMode as Y, type CanvasWindowFrame as Z, type CanvasWindowPorts as _, type CanvasWindowId as a, type ToggleKindInput as a0, bindCanvasToReduxStore as a1, canvasActions as a2, canvasOrientation as a3, canvasPresentation as a4, canvasReducer as a5, canvasWindowFrame as a6, canvasWindowOfPane as a7, clampDraggedCanvasWidth as a8, consoleCanvasErrorSink as a9, createCanvasController as aa, createCanvasStore as ab, createInitialCanvasState as ac, createKeyValueCanvasPersistence as ad, createLocalStorageCanvasPersistence as ae, defaultCanvasWidth as af, fitCanvasSplit as ag, fitCanvasSplitSizes as ah, fitCanvasWidth as ai, foldCanvasWindows as aj, isCanvasAction as ak, listCanvasWindowIds as al, preferredFlowDirection as am, resolveCanvasLayoutRules as an, sanitizeCanvasSnapshot as ao, selectCanvasKindVisibility as ap, shouldStackSplit as aq, toPersistableSnapshot as ar, toggleKind as as, type CanvasJson as b, type CanvasLayoutNode as c, type CanvasPaneId as d, type CanvasStoreBinding as e, type CanvasState as f, type CanvasAction as g, type CanvasController as h, type CanvasItem as i, type CanvasExtraWindow as j, type CanvasHistoryEntry as k, type CanvasPane as l, canvasWindowOfItem as m, CANVAS_DEFAULT_KEY as n, CANVAS_DEFAULT_WIDTH as o, CANVAS_DESKTOP_LAYOUT_RULES as p, CANVAS_HISTORY_LIMIT as q, CANVAS_KEEP_ALIVE_DEPTH as r, CANVAS_LAUNCHER_KIND as s, CANVAS_MAIN_WINDOW as t, CANVAS_MIN_SPLIT_FRACTION as u, CANVAS_MIN_WIDTH as v, CANVAS_NARROW_WIDTH as w, CANVAS_PANE_MIN_HEIGHT as x, CANVAS_PANE_MIN_WIDTH as y, CANVAS_PHONE_MAX_WIDTH as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/canvas",
-  "version": "0.8.5",
+  "version": "0.9.1",
   "description": "The AI Matrx canvas: a docked right-hand column with split panes, tabs, full screen, a kind registry, Redux-compatible state and persistence.",
   "type": "module",
   "main": "./dist/index.cjs",