@dxos/react-ui-menu 0.9.0 → 0.9.1-main.c7dcc2e112

package/dist/types/src/hooks/useGraphMenuActions.d.ts

@@ -0,0 +1,31 @@
+import { Atom } from '@effect-atom/atom-react';
+import { type Graph, Node } from '@dxos/app-graph';
+import { type ActionGraphProps, type MenuActions } from './useMenuActions';
+export type GraphMenuOptions = {
+    /** Group the actions descend from. Defaults to the menu root (top-level toolbar items). */
+    rootId?: string;
+    /** Keep only the actions the predicate accepts (e.g. by `disposition`). */
+    filter?: (action: Node.ActionLike) => boolean;
+};
+/**
+ * Flatten a node's contributed actions (and nested {@link Node.ActionGroup}s) into the
+ * `{ nodes, edges }` an {@link useMenuActions} / `Menu` consumes. The action nodes are spliced
+ * verbatim, so their Effect `data` (and captured `_actionContext`) execute via `executeMenuAction`
+ * without any `onAction` wiring.
+ *
+ * Pure over a `resolve` function so it is testable without a live graph; `resolve(id)` returns the
+ * direct actions for `id` (a node id at the top level, a group id when expanding a group).
+ */
+export declare const buildGraphMenu: (resolve: (id: string) => Node.ActionLike[], nodeId: string, options?: GraphMenuOptions) => ActionGraphProps;
+/**
+ * Read a node's contributed actions from the app-graph as menu `ActionGraphProps`, for splicing into a
+ * hand-built toolbar via `MenuBuilder.subgraph(graphActions(graph, get, nodeId))`. Reactive: reads the
+ * graph's action atoms through `get`, so contributed actions appear/disappear as extensions update.
+ */
+export declare const graphActions: (graph: Graph.ReadableGraph | undefined, get: Atom.Context, nodeId: string | undefined, options?: GraphMenuOptions) => ActionGraphProps;
+/**
+ * Menu actions sourced entirely from a node's app-graph contributions — the common "show every action
+ * the graph offers for this object" toolbar/menu. Compose with hand-built items via {@link graphActions}.
+ */
+export declare const useGraphMenuActions: (graph: Graph.ReadableGraph | undefined, nodeId: string | undefined, options?: GraphMenuOptions) => MenuActions;
+//# sourceMappingURL=useGraphMenuActions.d.ts.map

package/dist/types/src/hooks/useGraphMenuActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGraphMenuActions.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useGraphMenuActions.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAG/C,OAAO,EAAE,KAAK,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAEjB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,MAAM,gBAAgB,GAAG;IAC7B,2FAA2F;IAC3F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,KAAK,OAAO,CAAC;CAC/C,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,YAChB,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC,UAAU,EAAE,UAClC,MAAM,YACL,gBAAgB,KACxB,gBA2BF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,UAChB,KAAK,CAAC,aAAa,GAAG,SAAS,OACjC,IAAI,CAAC,OAAO,UACT,MAAM,GAAG,SAAS,YAChB,gBAAgB,KACzB,gBAC2G,CAAC;AAE/G;;;GAGG;AACH,eAAO,MAAM,mBAAmB,UACvB,KAAK,CAAC,aAAa,GAAG,SAAS,UAC9B,MAAM,GAAG,SAAS,YAChB,gBAAgB,KACzB,WAQF,CAAC"}

package/dist/types/src/hooks/useGraphMenuActions.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=useGraphMenuActions.test.d.ts.map

package/dist/types/src/hooks/useGraphMenuActions.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGraphMenuActions.test.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useGraphMenuActions.test.ts"],"names":[],"mappings":""}

package/dist/types/src/translations.d.ts

@@ -1,7 +1,9 @@
 export declare const translationKey = "@dxos/react-ui-menu";
 export declare const translations: [{
     readonly 'en-US': {
-        readonly "@dxos/react-ui-menu": {};
+        readonly "@dxos/react-ui-menu": {
+            readonly 'toolbar-overflow.menu': 'More';
+        };
     };
 }];
 //# sourceMappingURL=translations.d.ts.map

package/dist/types/src/translations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../src/translations.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,cAAc,wBAAwB,CAAC;AAEpD,eAAO,MAAM,YAAY;;;;EAMM,CAAC"}
+{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../src/translations.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,cAAc,wBAAwB,CAAC;AAEpD,eAAO,MAAM,YAAY;;;qBAIjB,uBAAuB,EAAE,MAAM;;;EAIR,CAAC"}

package/dist/types/src/types.d.ts

@@ -8,19 +8,15 @@ export type MenuSeparator = Node.Node<never, Pick<ToolbarSeparatorProps, 'varian
     type: typeof MenuSeparatorType;
 };
 export declare const isSeparator: (node: Node.Node) => node is MenuSeparator;
-export type MenuSingleSelectActionGroup = {
-    selectCardinality: 'single';
-    value: string;
-};
-export type MenuMultipleSelectActionGroup = {
-    selectCardinality: 'multiple';
-    value: string[];
-};
 export type MenuItemGroup<P extends Record<string, any> = Record<string, any>> = Node.ActionGroup<P>;
 export declare const isMenuGroup: (node: Node.Node) => node is MenuItemGroup;
-export type MenuItem = MenuSeparator | MenuAction | MenuItemGroup;
+/** Graph-sourced menu nodes carry plugin-specific properties validated at runtime. */
+export type GraphMenuItem = Node.Action | Node.ActionGroup;
+export type MenuItem = MenuSeparator | MenuAction | MenuItemGroup | GraphMenuItem;
+/** Group context for graph-backed dropdown menus (any graph node, not only action groups). */
+export type MenuGroupContext = MenuItemGroup | Node.Node;
 /** Atom-family-style accessor: returns an atom of items for a given group (or root when undefined). */
-export type MenuItemsAccessor = (group?: MenuItemGroup) => Atom.Atom<MenuItem[] | null>;
+export type MenuItemsAccessor = (group?: MenuGroupContext) => Atom.Atom<MenuItem[] | null>;
 export type ActionExecutor = (action: MenuAction, params: Node.InvokeProps) => void;
 export type MenuItemsMode = 'additive' | 'replacement';
 export type AddMenuItemsProps = {
@@ -28,7 +24,7 @@ export type AddMenuItemsProps = {
     mode: MenuItemsMode;
     priority?: number;
     items: MenuItem[];
-    groupFilter?: (group?: MenuItemGroup) => boolean;
+    groupFilter?: (group?: MenuGroupContext) => boolean;
 };
 export type MenuItems = Omit<AddMenuItemsProps, 'priority'> & {
     priority: number;

package/dist/types/src/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types/src/util.d.ts

@@ -12,13 +12,17 @@ export declare const fallbackIcon = "ph--circle-dashed--regular";
 export declare const createMenuAction: <P extends {} = {}>(id: string, invoke: () => void, properties: P & MenuActionProperties) => {
     id: string;
     type: string;
-    properties: P & MenuActionProperties;
+    properties: P & import("@dxos/ui-types").MenuItemChrome & {
+        variant?: 'action' | 'toggle';
+        value?: string;
+        checked?: boolean;
+    };
     data: () => Effect.Effect<void, never, never>;
 };
-export declare const createMenuItemGroup: <P extends MenuItemGroupProperties = MenuItemGroupProperties & Partial<MenuActionProperties>>(id: string, properties: P) => {
+export declare const createMenuItemGroup: <P extends MenuItemGroupProperties>(id: string, properties: P) => {
     id: string;
     type: string;
-    properties: P;
+    properties: MenuItemGroupProperties;
     data: typeof Node.actionGroupSymbol;
 };
 export declare const createGapSeparator: (id?: string, source?: string) => {

package/dist/types/src/util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../src/util.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvC,OAAO,EAAE,KAAK,oBAAoB,EAAE,KAAK,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAGzF,OAAO,EAAE,KAAK,UAAU,EAA0C,MAAM,SAAS,CAAC;AAElF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,WAAkB,UAAU,WAAU,IAAI,CAAC,WAAW,KAAQ,OAAO,CAAC,IAAI,CASvG,CAAC;AAEF,eAAO,MAAM,WAAW,WAAY,IAAI,CAAC,UAAU,QAIlD,CAAC;AAEF,eAAO,MAAM,YAAY,+BAA+B,CAAC;AAEzD,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,EAAE,WACvC,MAAM,UACF,MAAM,IAAI,cACN,CAAC,GAAG,oBAAoB;;;;;CAOb,CAAC;AAE1B,eAAO,MAAM,mBAAmB,GAC9B,CAAC,SAAS,uBAAuB,gEAE7B,MAAM,cACE,CAAC;;;;;CAOa,CAAC;AAE7B,eAAO,MAAM,kBAAkB,QAAQ,MAAM,WAAkB,MAAM;;;;;;;cAM5C,KAAK;;;;;kBAOd,OAAO;;CAGrB,CAAC;AAEH,eAAO,MAAM,mBAAmB,QAAQ,MAAM,WAAmB,MAAM;;;;;;;cAM9C,KAAK;;;;;kBAGY,OAAO;;CAC/C,CAAC"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../src/util.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvC,OAAO,EAAE,KAAK,oBAAoB,EAAE,KAAK,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAGzF,OAAO,EAAE,KAAK,UAAU,EAA0C,MAAM,SAAS,CAAC;AAElF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,WAAkB,UAAU,WAAU,IAAI,CAAC,WAAW,KAAQ,OAAO,CAAC,IAAI,CASvG,CAAC;AAEF,eAAO,MAAM,WAAW,WAAY,IAAI,CAAC,UAAU,QAIlD,CAAC;AAEF,eAAO,MAAM,YAAY,+BAA+B,CAAC;AAEzD,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,EAAE,WACvC,MAAM,UACF,MAAM,IAAI,cACN,CAAC,GAAG,oBAAoB;;;;;;;;;CAOb,CAAC;AAE1B,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,uBAAuB,MAAM,MAAM,cAAc,CAAC;;;;;CAMpE,CAAC;AAE7B,eAAO,MAAM,kBAAkB,QAAQ,MAAM,WAAkB,MAAM;;;;;;;cAM5C,KAAK;;;;;kBAOd,OAAO;;CAGrB,CAAC;AAEH,eAAO,MAAM,mBAAmB,QAAQ,MAAM,WAAmB,MAAM;;;;;;;cAM9C,KAAK;;;;;kBAGY,OAAO;;CAC/C,CAAC"}