@ai-matrx/canvas 0.6.1 → 0.7.1

package/dist/react.d.cts

@@ -1,48 +1,6 @@
 import * as react from 'react';
 import { ComponentType, ReactNode, CSSProperties, ButtonHTMLAttributes, HTMLAttributes, ReactElement } from 'react';
-import { P as CanvasRect, d as CanvasPaneId, C as CanvasItemId, a as CanvasWindowId, b as CanvasJson, i as CanvasItem, h as CanvasController, N as CanvasPresentation, S as CanvasSessionEvent, Q as CanvasSessionAttachReason, R as CanvasSessionDetachReason, M as CanvasPreferredTarget, e as CanvasStoreBinding, L as CanvasPersistencePort, D as CanvasErrorSink, G as CanvasLayoutRules, Z as ToggleKindInput, F as CanvasKindVisibility, f as CanvasState } from './toggleKind-DhDmWExm.cjs';
-
-/** One floating thing. Plain data, so a host can draw it in another process. */
-type CanvasFloating = {
-    readonly type: "tooltip";
-    readonly text: string;
-    readonly anchor: CanvasRect;
-    readonly side: "top" | "bottom";
-} | {
-    readonly type: "drop-indicator";
-    readonly rect: CanvasRect;
-    readonly paneId: CanvasPaneId;
-} | {
-    readonly type: "tab-drag";
-    readonly itemId: CanvasItemId;
-    readonly title: string;
-};
-interface CanvasOverlayPort {
-    /** Shows a floating element above everything (native views included); returns its remover. */
-    show(element: CanvasFloating): () => void;
-}
-/** A serializable "…" menu: the package keeps the handlers, a host draws the entries. */
-type CanvasMenuEntry = {
-    readonly type: "item";
-    readonly id: string;
-    readonly label: string;
-    readonly destructive?: boolean;
-} | {
-    readonly type: "separator";
-};
-/** Shows a menu at `anchor` (e.g. Electron `Menu.popup`); resolves the chosen entry id, or null. */
-type CanvasShowMenu = (entries: readonly CanvasMenuEntry[], anchor: CanvasRect) => Promise<string | null>;
-/** A native body's frame: window CSS pixels plus the device pixel ratio. */
-interface CanvasNativeRect extends CanvasRect {
-    readonly devicePixelRatio: number;
-}
-interface CanvasNativeBodyInfo {
-    /** False while package DOM floats over the canvas (a DOM menu, a tab drag): hide the native view. */
-    readonly visible: boolean;
-    readonly windowId: CanvasWindowId;
-}
-/** Reports where a native body sits; null when it is hidden or gone. Called in the frame the layout changed. */
-type CanvasNativeBodyFrame = (itemId: CanvasItemId, rect: CanvasNativeRect | null, info: CanvasNativeBodyInfo) => void;
+import { b as CanvasJson, i as CanvasItem, d as CanvasPaneId, h as CanvasController, a as CanvasWindowId, O as CanvasPresentation, T as CanvasSessionEvent, R as CanvasSessionAttachReason, S as CanvasSessionDetachReason, N as CanvasPreferredTarget, C as CanvasItemId, Q as CanvasRect, e as CanvasStoreBinding, M as CanvasPersistencePort, E as CanvasErrorSink, H as CanvasLayoutRules, _ as ToggleKindInput, G as CanvasKindVisibility, f as CanvasState } from './toggleKind-CAI7pndj.cjs';
 
 /**
  * THE canvas kind registry. A kind is one sort of thing the canvas can show —
@@ -188,6 +146,55 @@ declare function registerCanvasKinds(kinds: readonly AnyCanvasKind[]): () => voi
 declare function getCanvasKind(id: string): AnyCanvasKind | undefined;
 declare function listCanvasKinds(): AnyCanvasKind[];
 
+/**
+ * Puts `items` into the pane menu of the tab `itemId` (the body's own
+ * actions), after the kind's `menuItems`. The latest `items` are read each
+ * time the menu opens; pass `[]` to offer nothing.
+ */
+declare function useCanvasMenuItems(itemId: CanvasItemId | string | null | undefined, items: readonly CanvasMenuItem[]): void;
+
+/** One floating thing. Plain data, so a host can draw it in another process. */
+type CanvasFloating = {
+    readonly type: "tooltip";
+    readonly text: string;
+    readonly anchor: CanvasRect;
+    readonly side: "top" | "bottom";
+} | {
+    readonly type: "drop-indicator";
+    readonly rect: CanvasRect;
+    readonly paneId: CanvasPaneId;
+} | {
+    readonly type: "tab-drag";
+    readonly itemId: CanvasItemId;
+    readonly title: string;
+};
+interface CanvasOverlayPort {
+    /** Shows a floating element above everything (native views included); returns its remover. */
+    show(element: CanvasFloating): () => void;
+}
+/** A serializable "…" menu: the package keeps the handlers, a host draws the entries. */
+type CanvasMenuEntry = {
+    readonly type: "item";
+    readonly id: string;
+    readonly label: string;
+    readonly destructive?: boolean;
+} | {
+    readonly type: "separator";
+};
+/** Shows a menu at `anchor` (e.g. Electron `Menu.popup`); resolves the chosen entry id, or null. */
+type CanvasShowMenu = (entries: readonly CanvasMenuEntry[], anchor: CanvasRect) => Promise<string | null>;
+/** A native body's frame: window CSS pixels plus the device pixel ratio. */
+interface CanvasNativeRect extends CanvasRect {
+    readonly devicePixelRatio: number;
+}
+interface CanvasNativeBodyInfo {
+    /** False while package DOM floats over the canvas (a DOM menu, a tab drag): hide the native view. */
+    readonly visible: boolean;
+    readonly windowId: CanvasWindowId;
+}
+/** Reports where a native body sits; null when it is hidden or gone. Called in the frame the layout changed. */
+type CanvasNativeBodyFrame = (itemId: CanvasItemId, rect: CanvasNativeRect | null, info: CanvasNativeBodyInfo) => void;
+
 /**
  * What the host answers ONCE for every kind. Saving, sharing and history are
  * "handled globally" here; the window ports let a desktop host draw floating
@@ -377,6 +384,32 @@ declare function itemTitle(item: CanvasItem, kind: AnyCanvasKind | undefined): s
 declare function CanvasPaneView({ paneId }: {
     paneId: CanvasPaneId;
 }): react.JSX.Element | null;
+/** A background tab's floor (px): icon + ~7 letters + "…" ("Messag…"). Mirrored to CSS as --mxc-tab-min. */
+declare const CANVAS_TAB_MIN_WIDTH = 88;
+/** The active tab's floor (px): icon + ~8 letters + "…" + its close. Mirrored to CSS as --mxc-tab-active-min. */
+declare const CANVAS_ACTIVE_TAB_MIN_WIDTH = 112;
+/**
+ * Which tabs the strip shows at this width: all of them when every tab fits
+ * at its floor, else as many as fit — always the active one — and the rest
+ * are reached through the "All tabs" menu (Chrome / VS Code). Pure, so the
+ * rule is testable without a layout engine. `width <= 0` (not measured yet)
+ * shows everything.
+ */
+declare function fitCanvasTabs(count: number, activeIndex: number, width: number): {
+    start: number;
+    end: number;
+    overflow: boolean;
+    compact: boolean;
+};
+
+/**
+ * One resize gesture (the canvas edge, a split handle). While it runs:
+ * `:root[data-mxc-resizing]` (cursor, no motion, `user-select: none` in
+ * styles.css), any selection already on the page is cleared, and the
+ * document refuses to START a selection — so dragging an edge across the
+ * page never selects its text, whatever CSS the host loaded.
+ */
+declare function beginCanvasResize(mode: "" | "col" | "row"): () => void;
 
 interface CanvasHeaderButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "children" | "title"> {
     /** Accessible name and tooltip. */
@@ -479,4 +512,4 @@ interface BrowserBarProps {
 /** A browser's back · forward · reload · address bar, for a kind's leading slot or its body. */
 declare function BrowserBar({ url, canGoBack, canGoForward, onBack, onForward, onReload, onNavigate, trailing, className }: BrowserBarProps): react.JSX.Element;
 
-export { type AnyCanvasKind, BrowserBar, type BrowserBarProps, type BrowserTab, BrowserTabs, type BrowserTabsProps, CanvasColumn, type CanvasColumnProps, type CanvasFloating, CanvasFrame, CanvasHeaderButton, type CanvasHeaderButtonProps, type CanvasHostPorts, type CanvasKind, type CanvasKindIcon, CanvasKindIcons, type CanvasKindProps, type CanvasLauncherEntry, type CanvasMenuEntry, type CanvasMenuItem, CanvasMenuTrigger, type CanvasNativeBodyFrame, type CanvasNativeBodyInfo, type CanvasNativeRect, type CanvasOverlayPort, CanvasPaneView, CanvasPanel, CanvasPanelEmpty, type CanvasPanelProps, CanvasProvider, type CanvasProviderProps, type CanvasShowMenu, CanvasTab, type CanvasTabProps, type CanvasTabStripMode, CanvasToggle, CanvasWindowScope, canvasSessionKey, defineCanvasKind, getCanvasKind, itemTitle, listCanvasKinds, registerCanvasKind, registerCanvasKinds, useCanvas, useCanvasColumnWidth, useCanvasHostPorts, useCanvasIsPresented, useCanvasKind, useCanvasKindToggle, useCanvasKinds, useCanvasLauncherEntries, useCanvasLauncherEntry, useCanvasNativeBodies, useCanvasPresentation, useCanvasState, useCanvasWindowId, useOptionalCanvas, useOptionalCanvasState };
+export { type AnyCanvasKind, BrowserBar, type BrowserBarProps, type BrowserTab, BrowserTabs, type BrowserTabsProps, CANVAS_ACTIVE_TAB_MIN_WIDTH, CANVAS_TAB_MIN_WIDTH, CanvasColumn, type CanvasColumnProps, type CanvasFloating, CanvasFrame, CanvasHeaderButton, type CanvasHeaderButtonProps, type CanvasHostPorts, type CanvasKind, type CanvasKindIcon, CanvasKindIcons, type CanvasKindProps, type CanvasLauncherEntry, type CanvasMenuEntry, type CanvasMenuItem, CanvasMenuTrigger, type CanvasNativeBodyFrame, type CanvasNativeBodyInfo, type CanvasNativeRect, type CanvasOverlayPort, CanvasPaneView, CanvasPanel, CanvasPanelEmpty, type CanvasPanelProps, CanvasProvider, type CanvasProviderProps, type CanvasShowMenu, CanvasTab, type CanvasTabProps, type CanvasTabStripMode, CanvasToggle, CanvasWindowScope, beginCanvasResize, canvasSessionKey, defineCanvasKind, fitCanvasTabs, getCanvasKind, itemTitle, listCanvasKinds, registerCanvasKind, registerCanvasKinds, useCanvas, useCanvasColumnWidth, useCanvasHostPorts, useCanvasIsPresented, useCanvasKind, useCanvasKindToggle, useCanvasKinds, useCanvasLauncherEntries, useCanvasLauncherEntry, useCanvasMenuItems, useCanvasNativeBodies, useCanvasPresentation, useCanvasState, useCanvasWindowId, useOptionalCanvas, useOptionalCanvasState };

package/dist/react.d.ts

@@ -1,48 +1,6 @@
 import * as react from 'react';
 import { ComponentType, ReactNode, CSSProperties, ButtonHTMLAttributes, HTMLAttributes, ReactElement } from 'react';
-import { P as CanvasRect, d as CanvasPaneId, C as CanvasItemId, a as CanvasWindowId, b as CanvasJson, i as CanvasItem, h as CanvasController, N as CanvasPresentation, S as CanvasSessionEvent, Q as CanvasSessionAttachReason, R as CanvasSessionDetachReason, M as CanvasPreferredTarget, e as CanvasStoreBinding, L as CanvasPersistencePort, D as CanvasErrorSink, G as CanvasLayoutRules, Z as ToggleKindInput, F as CanvasKindVisibility, f as CanvasState } from './toggleKind-DhDmWExm.js';
-
-/** One floating thing. Plain data, so a host can draw it in another process. */
-type CanvasFloating = {
-    readonly type: "tooltip";
-    readonly text: string;
-    readonly anchor: CanvasRect;
-    readonly side: "top" | "bottom";
-} | {
-    readonly type: "drop-indicator";
-    readonly rect: CanvasRect;
-    readonly paneId: CanvasPaneId;
-} | {
-    readonly type: "tab-drag";
-    readonly itemId: CanvasItemId;
-    readonly title: string;
-};
-interface CanvasOverlayPort {
-    /** Shows a floating element above everything (native views included); returns its remover. */
-    show(element: CanvasFloating): () => void;
-}
-/** A serializable "…" menu: the package keeps the handlers, a host draws the entries. */
-type CanvasMenuEntry = {
-    readonly type: "item";
-    readonly id: string;
-    readonly label: string;
-    readonly destructive?: boolean;
-} | {
-    readonly type: "separator";
-};
-/** Shows a menu at `anchor` (e.g. Electron `Menu.popup`); resolves the chosen entry id, or null. */
-type CanvasShowMenu = (entries: readonly CanvasMenuEntry[], anchor: CanvasRect) => Promise<string | null>;
-/** A native body's frame: window CSS pixels plus the device pixel ratio. */
-interface CanvasNativeRect extends CanvasRect {
-    readonly devicePixelRatio: number;
-}
-interface CanvasNativeBodyInfo {
-    /** False while package DOM floats over the canvas (a DOM menu, a tab drag): hide the native view. */
-    readonly visible: boolean;
-    readonly windowId: CanvasWindowId;
-}
-/** Reports where a native body sits; null when it is hidden or gone. Called in the frame the layout changed. */
-type CanvasNativeBodyFrame = (itemId: CanvasItemId, rect: CanvasNativeRect | null, info: CanvasNativeBodyInfo) => void;
+import { b as CanvasJson, i as CanvasItem, d as CanvasPaneId, h as CanvasController, a as CanvasWindowId, O as CanvasPresentation, T as CanvasSessionEvent, R as CanvasSessionAttachReason, S as CanvasSessionDetachReason, N as CanvasPreferredTarget, C as CanvasItemId, Q as CanvasRect, e as CanvasStoreBinding, M as CanvasPersistencePort, E as CanvasErrorSink, H as CanvasLayoutRules, _ as ToggleKindInput, G as CanvasKindVisibility, f as CanvasState } from './toggleKind-CAI7pndj.js';
 
 /**
  * THE canvas kind registry. A kind is one sort of thing the canvas can show —
@@ -188,6 +146,55 @@ declare function registerCanvasKinds(kinds: readonly AnyCanvasKind[]): () => voi
 declare function getCanvasKind(id: string): AnyCanvasKind | undefined;
 declare function listCanvasKinds(): AnyCanvasKind[];
 
+/**
+ * Puts `items` into the pane menu of the tab `itemId` (the body's own
+ * actions), after the kind's `menuItems`. The latest `items` are read each
+ * time the menu opens; pass `[]` to offer nothing.
+ */
+declare function useCanvasMenuItems(itemId: CanvasItemId | string | null | undefined, items: readonly CanvasMenuItem[]): void;
+
+/** One floating thing. Plain data, so a host can draw it in another process. */
+type CanvasFloating = {
+    readonly type: "tooltip";
+    readonly text: string;
+    readonly anchor: CanvasRect;
+    readonly side: "top" | "bottom";
+} | {
+    readonly type: "drop-indicator";
+    readonly rect: CanvasRect;
+    readonly paneId: CanvasPaneId;
+} | {
+    readonly type: "tab-drag";
+    readonly itemId: CanvasItemId;
+    readonly title: string;
+};
+interface CanvasOverlayPort {
+    /** Shows a floating element above everything (native views included); returns its remover. */
+    show(element: CanvasFloating): () => void;
+}
+/** A serializable "…" menu: the package keeps the handlers, a host draws the entries. */
+type CanvasMenuEntry = {
+    readonly type: "item";
+    readonly id: string;
+    readonly label: string;
+    readonly destructive?: boolean;
+} | {
+    readonly type: "separator";
+};
+/** Shows a menu at `anchor` (e.g. Electron `Menu.popup`); resolves the chosen entry id, or null. */
+type CanvasShowMenu = (entries: readonly CanvasMenuEntry[], anchor: CanvasRect) => Promise<string | null>;
+/** A native body's frame: window CSS pixels plus the device pixel ratio. */
+interface CanvasNativeRect extends CanvasRect {
+    readonly devicePixelRatio: number;
+}
+interface CanvasNativeBodyInfo {
+    /** False while package DOM floats over the canvas (a DOM menu, a tab drag): hide the native view. */
+    readonly visible: boolean;
+    readonly windowId: CanvasWindowId;
+}
+/** Reports where a native body sits; null when it is hidden or gone. Called in the frame the layout changed. */
+type CanvasNativeBodyFrame = (itemId: CanvasItemId, rect: CanvasNativeRect | null, info: CanvasNativeBodyInfo) => void;
+
 /**
  * What the host answers ONCE for every kind. Saving, sharing and history are
  * "handled globally" here; the window ports let a desktop host draw floating
@@ -377,6 +384,32 @@ declare function itemTitle(item: CanvasItem, kind: AnyCanvasKind | undefined): s
 declare function CanvasPaneView({ paneId }: {
     paneId: CanvasPaneId;
 }): react.JSX.Element | null;
+/** A background tab's floor (px): icon + ~7 letters + "…" ("Messag…"). Mirrored to CSS as --mxc-tab-min. */
+declare const CANVAS_TAB_MIN_WIDTH = 88;
+/** The active tab's floor (px): icon + ~8 letters + "…" + its close. Mirrored to CSS as --mxc-tab-active-min. */
+declare const CANVAS_ACTIVE_TAB_MIN_WIDTH = 112;
+/**
+ * Which tabs the strip shows at this width: all of them when every tab fits
+ * at its floor, else as many as fit — always the active one — and the rest
+ * are reached through the "All tabs" menu (Chrome / VS Code). Pure, so the
+ * rule is testable without a layout engine. `width <= 0` (not measured yet)
+ * shows everything.
+ */
+declare function fitCanvasTabs(count: number, activeIndex: number, width: number): {
+    start: number;
+    end: number;
+    overflow: boolean;
+    compact: boolean;
+};
+
+/**
+ * One resize gesture (the canvas edge, a split handle). While it runs:
+ * `:root[data-mxc-resizing]` (cursor, no motion, `user-select: none` in
+ * styles.css), any selection already on the page is cleared, and the
+ * document refuses to START a selection — so dragging an edge across the
+ * page never selects its text, whatever CSS the host loaded.
+ */
+declare function beginCanvasResize(mode: "" | "col" | "row"): () => void;
 
 interface CanvasHeaderButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "children" | "title"> {
     /** Accessible name and tooltip. */
@@ -479,4 +512,4 @@ interface BrowserBarProps {
 /** A browser's back · forward · reload · address bar, for a kind's leading slot or its body. */
 declare function BrowserBar({ url, canGoBack, canGoForward, onBack, onForward, onReload, onNavigate, trailing, className }: BrowserBarProps): react.JSX.Element;
 
-export { type AnyCanvasKind, BrowserBar, type BrowserBarProps, type BrowserTab, BrowserTabs, type BrowserTabsProps, CanvasColumn, type CanvasColumnProps, type CanvasFloating, CanvasFrame, CanvasHeaderButton, type CanvasHeaderButtonProps, type CanvasHostPorts, type CanvasKind, type CanvasKindIcon, CanvasKindIcons, type CanvasKindProps, type CanvasLauncherEntry, type CanvasMenuEntry, type CanvasMenuItem, CanvasMenuTrigger, type CanvasNativeBodyFrame, type CanvasNativeBodyInfo, type CanvasNativeRect, type CanvasOverlayPort, CanvasPaneView, CanvasPanel, CanvasPanelEmpty, type CanvasPanelProps, CanvasProvider, type CanvasProviderProps, type CanvasShowMenu, CanvasTab, type CanvasTabProps, type CanvasTabStripMode, CanvasToggle, CanvasWindowScope, canvasSessionKey, defineCanvasKind, getCanvasKind, itemTitle, listCanvasKinds, registerCanvasKind, registerCanvasKinds, useCanvas, useCanvasColumnWidth, useCanvasHostPorts, useCanvasIsPresented, useCanvasKind, useCanvasKindToggle, useCanvasKinds, useCanvasLauncherEntries, useCanvasLauncherEntry, useCanvasNativeBodies, useCanvasPresentation, useCanvasState, useCanvasWindowId, useOptionalCanvas, useOptionalCanvasState };
+export { type AnyCanvasKind, BrowserBar, type BrowserBarProps, type BrowserTab, BrowserTabs, type BrowserTabsProps, CANVAS_ACTIVE_TAB_MIN_WIDTH, CANVAS_TAB_MIN_WIDTH, CanvasColumn, type CanvasColumnProps, type CanvasFloating, CanvasFrame, CanvasHeaderButton, type CanvasHeaderButtonProps, type CanvasHostPorts, type CanvasKind, type CanvasKindIcon, CanvasKindIcons, type CanvasKindProps, type CanvasLauncherEntry, type CanvasMenuEntry, type CanvasMenuItem, CanvasMenuTrigger, type CanvasNativeBodyFrame, type CanvasNativeBodyInfo, type CanvasNativeRect, type CanvasOverlayPort, CanvasPaneView, CanvasPanel, CanvasPanelEmpty, type CanvasPanelProps, CanvasProvider, type CanvasProviderProps, type CanvasShowMenu, CanvasTab, type CanvasTabProps, type CanvasTabStripMode, CanvasToggle, CanvasWindowScope, beginCanvasResize, canvasSessionKey, defineCanvasKind, fitCanvasTabs, getCanvasKind, itemTitle, listCanvasKinds, registerCanvasKind, registerCanvasKinds, useCanvas, useCanvasColumnWidth, useCanvasHostPorts, useCanvasIsPresented, useCanvasKind, useCanvasKindToggle, useCanvasKinds, useCanvasLauncherEntries, useCanvasLauncherEntry, useCanvasMenuItems, useCanvasNativeBodies, useCanvasPresentation, useCanvasState, useCanvasWindowId, useOptionalCanvas, useOptionalCanvasState };