@ai-matrx/canvas 0.2.2 → 0.4.0

package/dist/styles.css

@@ -450,6 +450,23 @@
 
 /* ── bodies ─────────────────────────────────────────────────────────────── */
 
+.mxc-item-toolbar {
+  flex: none;
+  display: flex;
+  align-items: center;
+  gap: 0.25rem;
+  min-height: 2.5rem;
+  padding: 0 0.375rem;
+  border-bottom: 1px solid var(--mxc-border);
+  background: var(--mxc-header-bg);
+  overflow-x: auto;
+  scrollbar-width: none;
+}
+
+.mxc-item-toolbar::-webkit-scrollbar {
+  display: none;
+}
+
 .mxc-item {
   flex: 1 1 auto;
   min-height: 0;

package/dist/{controller-Dv6J6XZm.d.cts → toggleKind-A9v45oSb.d.cts}

@@ -573,4 +573,33 @@ interface CanvasController {
 }
 declare function createCanvasController(options: CanvasControllerOptions): CanvasController;
 
-export { foldCanvasWindows as $, type CanvasOrientation as A, type CanvasPersistencePort as B, type CanvasItemId as C, type CanvasRect as D, type CanvasSessionAttachReason as E, type CanvasSessionDetachReason as F, type CanvasSessionEvent as G, type CanvasSessionHooks as H, type CanvasSplitId as I, type CanvasWindowCloseMode as J, type CanvasWindowFrame as K, type CanvasWindowPorts as L, bindCanvasToReduxStore as M, canvasActions as N, canvasReducer as O, canvasWindowFrame as P, canvasWindowOfPane as Q, type ReduxStoreLike as R, clampDraggedCanvasWidth as S, consoleCanvasErrorSink as T, createCanvasController as U, createCanvasStore as V, createInitialCanvasState as W, createKeyValueCanvasPersistence as X, createLocalStorageCanvasPersistence as Y, defaultCanvasWidth as Z, fitCanvasWidth as _, type CanvasWindowId as a, isCanvasAction as a0, listCanvasWindowIds as a1, resolveCanvasLayoutRules as a2, sanitizeCanvasSnapshot as a3, shouldStackSplit as a4, toPersistableSnapshot as a5, 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 CanvasPane as k, canvasWindowOfItem as l, CANVAS_DEFAULT_WIDTH as m, CANVAS_DESKTOP_LAYOUT_RULES as n, CANVAS_MAIN_WINDOW as o, CANVAS_MIN_SPLIT_FRACTION as p, CANVAS_MIN_WIDTH as q, CANVAS_STORAGE_KEY as r, CANVAS_WEB_LAYOUT_RULES as s, type CanvasControllerOptions as t, type CanvasErrorReport as u, type CanvasErrorSink as v, type CanvasKeyValueStore as w, type CanvasLayoutRules as x, type CanvasOpenInput as y, type CanvasOpenTarget as z };
+/**
+ * "Toggle or focus this kind" — what a toolbar icon does (the desktop's
+ * Terminal/Review/Browser icons, the web's quick-tool launchers):
+ *
+ *   absent      → open it (and reveal the canvas)
+ *   background  → bring it forward: activate its tab, focus its pane, reveal
+ *   visible     → close it (default) or put the canvas away (`whenVisible: "hide"`)
+ *
+ * "Visible" means: on the canvas, the active tab of its pane, and its window's
+ * canvas is open. The same item in a popped-out window counts in that window.
+ */
+
+type CanvasKindVisibility = "absent" | "background" | "visible";
+declare const CANVAS_DEFAULT_KEY = "default";
+/** Stable primitive result — safe in useSyncExternalStore and useSelector. */
+declare function selectCanvasKindVisibility(state: CanvasState, kind: string, key?: string): CanvasKindVisibility;
+interface ToggleKindInput {
+    readonly kind: string;
+    /** Default "default" — one instance of the kind (a toolbar tool). */
+    readonly key?: string | undefined;
+    /** Data for a NEW item; an existing item keeps its data. */
+    readonly data?: CanvasJson | undefined;
+    readonly title?: string | null | undefined;
+    /** What a click does when the item is already in front. Default "close". */
+    readonly whenVisible?: "close" | "hide" | undefined;
+}
+/** Returns what the item is after the click. */
+declare function toggleKind(controller: CanvasController, input: ToggleKindInput): CanvasKindVisibility;
+
+export { createLocalStorageCanvasPersistence as $, type CanvasOpenInput as A, type CanvasOpenTarget as B, type CanvasItemId as C, type CanvasOrientation as D, type CanvasPersistencePort as E, type CanvasRect as F, type CanvasSessionAttachReason as G, type CanvasSessionDetachReason as H, type CanvasSessionEvent as I, type CanvasSessionHooks as J, type CanvasSplitId as K, type CanvasWindowCloseMode as L, type CanvasWindowFrame as M, type CanvasWindowPorts as N, bindCanvasToReduxStore as O, canvasActions as P, canvasReducer as Q, type ReduxStoreLike as R, canvasWindowFrame as S, type ToggleKindInput as T, canvasWindowOfPane as U, clampDraggedCanvasWidth as V, consoleCanvasErrorSink as W, createCanvasController as X, createCanvasStore as Y, createInitialCanvasState as Z, createKeyValueCanvasPersistence as _, type CanvasWindowId as a, defaultCanvasWidth as a0, fitCanvasWidth as a1, foldCanvasWindows as a2, isCanvasAction as a3, listCanvasWindowIds as a4, resolveCanvasLayoutRules as a5, sanitizeCanvasSnapshot as a6, selectCanvasKindVisibility as a7, shouldStackSplit as a8, toPersistableSnapshot as a9, toggleKind as aa, 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 CanvasPane as k, canvasWindowOfItem as l, CANVAS_DEFAULT_KEY as m, CANVAS_DEFAULT_WIDTH as n, CANVAS_DESKTOP_LAYOUT_RULES as o, CANVAS_MAIN_WINDOW as p, CANVAS_MIN_SPLIT_FRACTION as q, CANVAS_MIN_WIDTH as r, CANVAS_STORAGE_KEY as s, CANVAS_WEB_LAYOUT_RULES as t, type CanvasControllerOptions as u, type CanvasErrorReport as v, type CanvasErrorSink as w, type CanvasKeyValueStore as x, type CanvasKindVisibility as y, type CanvasLayoutRules as z };

package/dist/{controller-Dv6J6XZm.d.ts → toggleKind-A9v45oSb.d.ts}

@@ -573,4 +573,33 @@ interface CanvasController {
 }
 declare function createCanvasController(options: CanvasControllerOptions): CanvasController;
 
-export { foldCanvasWindows as $, type CanvasOrientation as A, type CanvasPersistencePort as B, type CanvasItemId as C, type CanvasRect as D, type CanvasSessionAttachReason as E, type CanvasSessionDetachReason as F, type CanvasSessionEvent as G, type CanvasSessionHooks as H, type CanvasSplitId as I, type CanvasWindowCloseMode as J, type CanvasWindowFrame as K, type CanvasWindowPorts as L, bindCanvasToReduxStore as M, canvasActions as N, canvasReducer as O, canvasWindowFrame as P, canvasWindowOfPane as Q, type ReduxStoreLike as R, clampDraggedCanvasWidth as S, consoleCanvasErrorSink as T, createCanvasController as U, createCanvasStore as V, createInitialCanvasState as W, createKeyValueCanvasPersistence as X, createLocalStorageCanvasPersistence as Y, defaultCanvasWidth as Z, fitCanvasWidth as _, type CanvasWindowId as a, isCanvasAction as a0, listCanvasWindowIds as a1, resolveCanvasLayoutRules as a2, sanitizeCanvasSnapshot as a3, shouldStackSplit as a4, toPersistableSnapshot as a5, 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 CanvasPane as k, canvasWindowOfItem as l, CANVAS_DEFAULT_WIDTH as m, CANVAS_DESKTOP_LAYOUT_RULES as n, CANVAS_MAIN_WINDOW as o, CANVAS_MIN_SPLIT_FRACTION as p, CANVAS_MIN_WIDTH as q, CANVAS_STORAGE_KEY as r, CANVAS_WEB_LAYOUT_RULES as s, type CanvasControllerOptions as t, type CanvasErrorReport as u, type CanvasErrorSink as v, type CanvasKeyValueStore as w, type CanvasLayoutRules as x, type CanvasOpenInput as y, type CanvasOpenTarget as z };
+/**
+ * "Toggle or focus this kind" — what a toolbar icon does (the desktop's
+ * Terminal/Review/Browser icons, the web's quick-tool launchers):
+ *
+ *   absent      → open it (and reveal the canvas)
+ *   background  → bring it forward: activate its tab, focus its pane, reveal
+ *   visible     → close it (default) or put the canvas away (`whenVisible: "hide"`)
+ *
+ * "Visible" means: on the canvas, the active tab of its pane, and its window's
+ * canvas is open. The same item in a popped-out window counts in that window.
+ */
+
+type CanvasKindVisibility = "absent" | "background" | "visible";
+declare const CANVAS_DEFAULT_KEY = "default";
+/** Stable primitive result — safe in useSyncExternalStore and useSelector. */
+declare function selectCanvasKindVisibility(state: CanvasState, kind: string, key?: string): CanvasKindVisibility;
+interface ToggleKindInput {
+    readonly kind: string;
+    /** Default "default" — one instance of the kind (a toolbar tool). */
+    readonly key?: string | undefined;
+    /** Data for a NEW item; an existing item keeps its data. */
+    readonly data?: CanvasJson | undefined;
+    readonly title?: string | null | undefined;
+    /** What a click does when the item is already in front. Default "close". */
+    readonly whenVisible?: "close" | "hide" | undefined;
+}
+/** Returns what the item is after the click. */
+declare function toggleKind(controller: CanvasController, input: ToggleKindInput): CanvasKindVisibility;
+
+export { createLocalStorageCanvasPersistence as $, type CanvasOpenInput as A, type CanvasOpenTarget as B, type CanvasItemId as C, type CanvasOrientation as D, type CanvasPersistencePort as E, type CanvasRect as F, type CanvasSessionAttachReason as G, type CanvasSessionDetachReason as H, type CanvasSessionEvent as I, type CanvasSessionHooks as J, type CanvasSplitId as K, type CanvasWindowCloseMode as L, type CanvasWindowFrame as M, type CanvasWindowPorts as N, bindCanvasToReduxStore as O, canvasActions as P, canvasReducer as Q, type ReduxStoreLike as R, canvasWindowFrame as S, type ToggleKindInput as T, canvasWindowOfPane as U, clampDraggedCanvasWidth as V, consoleCanvasErrorSink as W, createCanvasController as X, createCanvasStore as Y, createInitialCanvasState as Z, createKeyValueCanvasPersistence as _, type CanvasWindowId as a, defaultCanvasWidth as a0, fitCanvasWidth as a1, foldCanvasWindows as a2, isCanvasAction as a3, listCanvasWindowIds as a4, resolveCanvasLayoutRules as a5, sanitizeCanvasSnapshot as a6, selectCanvasKindVisibility as a7, shouldStackSplit as a8, toPersistableSnapshot as a9, toggleKind as aa, 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 CanvasPane as k, canvasWindowOfItem as l, CANVAS_DEFAULT_KEY as m, CANVAS_DEFAULT_WIDTH as n, CANVAS_DESKTOP_LAYOUT_RULES as o, CANVAS_MAIN_WINDOW as p, CANVAS_MIN_SPLIT_FRACTION as q, CANVAS_MIN_WIDTH as r, CANVAS_STORAGE_KEY as s, CANVAS_WEB_LAYOUT_RULES as t, type CanvasControllerOptions as u, type CanvasErrorReport as v, type CanvasErrorSink as w, type CanvasKeyValueStore as x, type CanvasKindVisibility as y, type CanvasLayoutRules as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/canvas",
-  "version": "0.2.2",
+  "version": "0.4.0",
   "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",