@ai-matrx/context-menu 0.0.0 → 0.1.0

package/dist/model-BdF0TqZ3.d.cts

@@ -0,0 +1,107 @@
+type MenuNodeKind = "item" | "section" | "submenu" | "divider";
+interface NodeBase {
+    /** Stable within the design. */
+    id: string;
+    /** The catalog option this was dragged from, when it came from one. */
+    catalogId?: string;
+    /** A designer's note on this one entry ("only on a table row", "merge with Copy"). */
+    note?: string;
+}
+interface MenuItemNode extends NodeBase {
+    kind: "item";
+    label: string;
+    /** A lucide icon name (`Sparkles`, `Copy`). */
+    icon?: string;
+    /** Shown right-aligned (`⌘C`). */
+    shortcut?: string;
+    /** One short line under the label. */
+    hint?: string;
+    /** Shown greyed out — the design says "this exists here but is unavailable now". */
+    disabled?: boolean;
+    /** Red, for actions that remove or discard. */
+    danger?: boolean;
+    /** A checkbox-style toggle item. */
+    toggle?: boolean;
+    /** Drawn as a highlighted, AI-flavoured item. */
+    ai?: boolean;
+}
+interface MenuSectionNode extends NodeBase {
+    kind: "section";
+    /** The small heading. Empty = an unlabelled group. */
+    label: string;
+    children: MenuNode[];
+    /** Starts folded; a click on the heading opens it. */
+    collapsible?: boolean;
+    /** How the section's items are laid out. */
+    layout?: "list" | "grid" | "row";
+}
+interface MenuSubmenuNode extends NodeBase {
+    kind: "submenu";
+    label: string;
+    icon?: string;
+    hint?: string;
+    children: MenuNode[];
+}
+interface MenuDividerNode extends NodeBase {
+    kind: "divider";
+}
+type MenuNode = MenuItemNode | MenuSectionNode | MenuSubmenuNode | MenuDividerNode;
+type MenuContainerNode = MenuSectionNode | MenuSubmenuNode;
+/** Where the menu opens; the builder previews each the way it appears there. */
+declare const MENU_SURFACES: readonly ["text-selection", "editable-field", "table-row", "page", "chat-message", "file", "anywhere"];
+type MenuSurface = (typeof MENU_SURFACES)[number];
+interface MenuLook {
+    density: "compact" | "comfortable";
+    width: number;
+    showIcons: boolean;
+    showShortcuts: boolean;
+    showHints: boolean;
+    /** A search box at the top of the menu. */
+    search: boolean;
+}
+declare const DEFAULT_LOOK: MenuLook;
+interface MenuDesign {
+    /** The design's identity; every version shares it. */
+    designId: string;
+    name: string;
+    surface: MenuSurface;
+    look: MenuLook;
+    nodes: MenuNode[];
+    /** Free notes for whoever builds it. */
+    notes: string;
+}
+declare const DESIGN_FORMAT = 1;
+declare function newId(prefix?: string): string;
+declare function emptyDesign(name?: string): MenuDesign;
+declare function isContainer(node: MenuNode): node is MenuContainerNode;
+/** A deep copy with every id renewed — what a duplicate or a second drop of a template gets. */
+declare function cloneNode<N extends MenuNode>(node: N): N;
+interface Located {
+    node: MenuNode;
+    /** The container's id, or null at the top. */
+    parentId: string | null;
+    index: number;
+    depth: number;
+}
+declare function locate(nodes: readonly MenuNode[], id: string, parentId?: string | null, depth?: number): Located | null;
+declare function contains(node: MenuNode, id: string): boolean;
+declare function countItems(nodes: readonly MenuNode[]): number;
+declare function insertNode(nodes: readonly MenuNode[], parentId: string | null, index: number, node: MenuNode): MenuNode[];
+declare function removeNode(nodes: readonly MenuNode[], id: string): MenuNode[];
+declare function updateNode(nodes: readonly MenuNode[], id: string, patch: Partial<MenuNode>): MenuNode[];
+/**
+ * Move `id` to `index` inside `parentId`. Refuses (returns the tree unchanged) a move into itself
+ * or its own descendant. `index` is in the destination list as it reads BEFORE the move.
+ */
+declare function canMove(nodes: readonly MenuNode[], id: string, parentId: string | null): boolean;
+declare function moveNode(nodes: readonly MenuNode[], id: string, parentId: string | null, index: number): MenuNode[];
+declare function duplicateNode(nodes: readonly MenuNode[], id: string): MenuNode[];
+/** Wrap a node into a new section (or submenu) in its place. */
+declare function wrapNode(nodes: readonly MenuNode[], id: string, kind: "section" | "submenu"): MenuNode[];
+/** Replace a container by its children. */
+declare function unwrapNode(nodes: readonly MenuNode[], id: string): MenuNode[];
+/** A saved document back into a design; anything unreadable becomes an empty design, never a throw. */
+declare function parseDesign(raw: unknown): MenuDesign;
+declare function serializeDesign(design: MenuDesign): string;
+
+export { updateNode as A, wrapNode as B, DEFAULT_LOOK as D, type Located as L, type MenuDesign as M, type MenuNode as a, type MenuItemNode as b, DESIGN_FORMAT as c, MENU_SURFACES as d, type MenuContainerNode as e, type MenuDividerNode as f, type MenuLook as g, type MenuNodeKind as h, type MenuSectionNode as i, type MenuSubmenuNode as j, type MenuSurface as k, canMove as l, cloneNode as m, contains as n, countItems as o, duplicateNode as p, emptyDesign as q, insertNode as r, isContainer as s, locate as t, moveNode as u, newId as v, parseDesign as w, removeNode as x, serializeDesign as y, unwrapNode as z };

package/dist/model-BdF0TqZ3.d.ts

@@ -0,0 +1,107 @@
+type MenuNodeKind = "item" | "section" | "submenu" | "divider";
+interface NodeBase {
+    /** Stable within the design. */
+    id: string;
+    /** The catalog option this was dragged from, when it came from one. */
+    catalogId?: string;
+    /** A designer's note on this one entry ("only on a table row", "merge with Copy"). */
+    note?: string;
+}
+interface MenuItemNode extends NodeBase {
+    kind: "item";
+    label: string;
+    /** A lucide icon name (`Sparkles`, `Copy`). */
+    icon?: string;
+    /** Shown right-aligned (`⌘C`). */
+    shortcut?: string;
+    /** One short line under the label. */
+    hint?: string;
+    /** Shown greyed out — the design says "this exists here but is unavailable now". */
+    disabled?: boolean;
+    /** Red, for actions that remove or discard. */
+    danger?: boolean;
+    /** A checkbox-style toggle item. */
+    toggle?: boolean;
+    /** Drawn as a highlighted, AI-flavoured item. */
+    ai?: boolean;
+}
+interface MenuSectionNode extends NodeBase {
+    kind: "section";
+    /** The small heading. Empty = an unlabelled group. */
+    label: string;
+    children: MenuNode[];
+    /** Starts folded; a click on the heading opens it. */
+    collapsible?: boolean;
+    /** How the section's items are laid out. */
+    layout?: "list" | "grid" | "row";
+}
+interface MenuSubmenuNode extends NodeBase {
+    kind: "submenu";
+    label: string;
+    icon?: string;
+    hint?: string;
+    children: MenuNode[];
+}
+interface MenuDividerNode extends NodeBase {
+    kind: "divider";
+}
+type MenuNode = MenuItemNode | MenuSectionNode | MenuSubmenuNode | MenuDividerNode;
+type MenuContainerNode = MenuSectionNode | MenuSubmenuNode;
+/** Where the menu opens; the builder previews each the way it appears there. */
+declare const MENU_SURFACES: readonly ["text-selection", "editable-field", "table-row", "page", "chat-message", "file", "anywhere"];
+type MenuSurface = (typeof MENU_SURFACES)[number];
+interface MenuLook {
+    density: "compact" | "comfortable";
+    width: number;
+    showIcons: boolean;
+    showShortcuts: boolean;
+    showHints: boolean;
+    /** A search box at the top of the menu. */
+    search: boolean;
+}
+declare const DEFAULT_LOOK: MenuLook;
+interface MenuDesign {
+    /** The design's identity; every version shares it. */
+    designId: string;
+    name: string;
+    surface: MenuSurface;
+    look: MenuLook;
+    nodes: MenuNode[];
+    /** Free notes for whoever builds it. */
+    notes: string;
+}
+declare const DESIGN_FORMAT = 1;
+declare function newId(prefix?: string): string;
+declare function emptyDesign(name?: string): MenuDesign;
+declare function isContainer(node: MenuNode): node is MenuContainerNode;
+/** A deep copy with every id renewed — what a duplicate or a second drop of a template gets. */
+declare function cloneNode<N extends MenuNode>(node: N): N;
+interface Located {
+    node: MenuNode;
+    /** The container's id, or null at the top. */
+    parentId: string | null;
+    index: number;
+    depth: number;
+}
+declare function locate(nodes: readonly MenuNode[], id: string, parentId?: string | null, depth?: number): Located | null;
+declare function contains(node: MenuNode, id: string): boolean;
+declare function countItems(nodes: readonly MenuNode[]): number;
+declare function insertNode(nodes: readonly MenuNode[], parentId: string | null, index: number, node: MenuNode): MenuNode[];
+declare function removeNode(nodes: readonly MenuNode[], id: string): MenuNode[];
+declare function updateNode(nodes: readonly MenuNode[], id: string, patch: Partial<MenuNode>): MenuNode[];
+/**
+ * Move `id` to `index` inside `parentId`. Refuses (returns the tree unchanged) a move into itself
+ * or its own descendant. `index` is in the destination list as it reads BEFORE the move.
+ */
+declare function canMove(nodes: readonly MenuNode[], id: string, parentId: string | null): boolean;
+declare function moveNode(nodes: readonly MenuNode[], id: string, parentId: string | null, index: number): MenuNode[];
+declare function duplicateNode(nodes: readonly MenuNode[], id: string): MenuNode[];
+/** Wrap a node into a new section (or submenu) in its place. */
+declare function wrapNode(nodes: readonly MenuNode[], id: string, kind: "section" | "submenu"): MenuNode[];
+/** Replace a container by its children. */
+declare function unwrapNode(nodes: readonly MenuNode[], id: string): MenuNode[];
+/** A saved document back into a design; anything unreadable becomes an empty design, never a throw. */
+declare function parseDesign(raw: unknown): MenuDesign;
+declare function serializeDesign(design: MenuDesign): string;
+
+export { updateNode as A, wrapNode as B, DEFAULT_LOOK as D, type Located as L, type MenuDesign as M, type MenuNode as a, type MenuItemNode as b, DESIGN_FORMAT as c, MENU_SURFACES as d, type MenuContainerNode as e, type MenuDividerNode as f, type MenuLook as g, type MenuNodeKind as h, type MenuSectionNode as i, type MenuSubmenuNode as j, type MenuSurface as k, canMove as l, cloneNode as m, contains as n, countItems as o, duplicateNode as p, emptyDesign as q, insertNode as r, isContainer as s, locate as t, moveNode as u, newId as v, parseDesign as w, removeNode as x, serializeDesign as y, unwrapNode as z };