@djangocfg/ui-tools 2.1.416 → 2.1.418

package/dist/composer-registry/index.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Minimal imperative handle every text-editor surface implements so
+ * an external tool (voice dictation, command palette, AI suggestion)
+ * can read/write its text content without traversing React.
+ *
+ * Methods are optional so a host can register a partial handle
+ * (e.g. only `getValue` + `setValue`), and the caller checks before use.
+ */
+interface ComposerHandle {
+    /** Move keyboard focus into the composer's editable surface. */
+    focus: () => void;
+    /** Move the caret to the very end of the input. */
+    moveCursorToEnd?: () => void;
+    /** Read the current draft text. Voice dictation anchors partial
+     *  transcripts onto the user's already-typed prefix via this. */
+    getValue?: () => string;
+    /** Replace the current draft text. Voice dictation pushes interim
+     *  and final transcripts through this without owning a controlled
+     *  binding. */
+    setValue?: (value: string) => void;
+}
+/**
+ * `@djangocfg/ui-tools/composer-registry`
+ *
+ * Cross-tool bridge: the currently-active text composer's handle.
+ *
+ * Producer side (`@djangocfg/ui-tools/chat` and TipTap hosts):
+ *   register their composer's imperative handle via `attachComposer`.
+ *
+ * Consumer side (`@djangocfg/ui-tools/speech-recognition`):
+ *   reads the active handle via `useActiveComposer`/`getActiveComposer`
+ *   and pipes voice transcripts into it.
+ *
+ * Why this lives in its own subpath (not inside `chat`)
+ * ----------------------------------------------------
+ * `chat` and `speech-recognition` are sibling subpath exports. If the
+ * registry lived inside `chat`, then `speech-recognition` would have
+ * to reach into it via a cross-tool relative import — and under Vite
+ * dev's dependency optimizer that file ends up loaded TWICE (once via
+ * the `./chat` URL, once via the `./speech-recognition` relative-up
+ * URL), giving the producer and the consumer two separate `let active`
+ * slots. The active handle registered by chat would be invisible to
+ * speech-recognition (and vice versa).
+ *
+ * Putting the registry in its own dedicated subpath (a single tool
+ * that NEITHER chat nor speech-recognition cross-import — they both
+ * import this one as their dependency) means Vite resolves it from a
+ * single URL across the whole graph. One module instance, one shared
+ * `active` slot.
+ *
+ * Semantics: one active composer per realm. The most recent
+ * `registerComposer(handle)` wins; `registerComposer(null)` clears it.
+ */
+type Listener = (handle: ComposerHandle | null) => void;
+/** Set or replace the active composer handle. Pass `null` to clear. */
+declare function registerComposer(handle: ComposerHandle | null): void;
+/**
+ * Convenience for components: register on mount, unregister on
+ * unmount. Returns a cleanup function suitable for `useEffect`.
+ */
+declare function attachComposer(handle: ComposerHandle): () => void;
+/** Read the current active handle (no subscription). */
+declare function getActiveComposer(): ComposerHandle | null;
+/** Subscribe to handle changes; returns an unsubscribe fn. */
+declare function subscribeComposer(listener: Listener): () => void;
+/**
+ * React hook: re-renders the caller whenever the active composer
+ * changes. Built on `useSyncExternalStore` so concurrent rendering,
+ * SSR, and dev-mode strict-effects all behave correctly.
+ */
+declare function useActiveComposer(): ComposerHandle | null;
+
+export { type ComposerHandle, attachComposer, getActiveComposer, registerComposer, subscribeComposer, useActiveComposer };

package/dist/composer-registry/index.mjs

@@ -0,0 +1,39 @@
+import { __name } from '../chunk-PAWJFY3S.mjs';
+import { useCallback, useSyncExternalStore } from 'react';
+
+var active = null;
+var listeners = /* @__PURE__ */ new Set();
+function registerComposer(handle) {
+  active = handle;
+  for (const fn of listeners) fn(active);
+}
+__name(registerComposer, "registerComposer");
+function attachComposer(handle) {
+  registerComposer(handle);
+  return () => {
+    if (active === handle) registerComposer(null);
+  };
+}
+__name(attachComposer, "attachComposer");
+function getActiveComposer() {
+  return active;
+}
+__name(getActiveComposer, "getActiveComposer");
+function subscribeComposer(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+__name(subscribeComposer, "subscribeComposer");
+function useActiveComposer() {
+  const subscribe = useCallback((onChange) => {
+    return subscribeComposer(onChange);
+  }, []);
+  return useSyncExternalStore(subscribe, getActiveComposer, () => null);
+}
+__name(useActiveComposer, "useActiveComposer");
+
+export { attachComposer, getActiveComposer, registerComposer, subscribeComposer, useActiveComposer };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/composer-registry/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tools/integration/ComposerRegistry/index.ts"],"names":[],"mappings":";;;AA6DA,IAAI,MAAA,GAAgC,IAAA;AACpC,IAAM,SAAA,uBAAgB,GAAA,EAAc;AAG7B,SAAS,iBAAiB,MAAA,EAAqC;AACpE,EAAA,MAAA,GAAS,MAAA;AACT,EAAA,KAAA,MAAW,EAAA,IAAM,SAAA,EAAW,EAAA,CAAG,MAAM,CAAA;AACvC;AAHgB,MAAA,CAAA,gBAAA,EAAA,kBAAA,CAAA;AAST,SAAS,eAAe,MAAA,EAAoC;AACjE,EAAA,gBAAA,CAAiB,MAAM,CAAA;AACvB,EAAA,OAAO,MAAM;AACX,IAAA,IAAI,MAAA,KAAW,MAAA,EAAQ,gBAAA,CAAiB,IAAI,CAAA;AAAA,EAC9C,CAAA;AACF;AALgB,MAAA,CAAA,cAAA,EAAA,gBAAA,CAAA;AAQT,SAAS,iBAAA,GAA2C;AACzD,EAAA,OAAO,MAAA;AACT;AAFgB,MAAA,CAAA,iBAAA,EAAA,mBAAA,CAAA;AAKT,SAAS,kBAAkB,QAAA,EAAgC;AAChE,EAAA,SAAA,CAAU,IAAI,QAAQ,CAAA;AACtB,EAAA,OAAO,MAAM;AACX,IAAA,SAAA,CAAU,OAAO,QAAQ,CAAA;AAAA,EAC3B,CAAA;AACF;AALgB,MAAA,CAAA,iBAAA,EAAA,mBAAA,CAAA;AAYT,SAAS,iBAAA,GAA2C;AACzD,EAAA,MAAM,SAAA,GAAY,WAAA,CAAY,CAAC,QAAA,KAAyB;AACtD,IAAA,OAAO,kBAAkB,QAAQ,CAAA;AAAA,EACnC,CAAA,EAAG,EAAE,CAAA;AACL,EAAA,OAAO,oBAAA,CAAqB,SAAA,EAAW,iBAAA,EAAmB,MAAM,IAAI,CAAA;AACtE;AALgB,MAAA,CAAA,iBAAA,EAAA,mBAAA,CAAA","file":"index.mjs","sourcesContent":["'use client';\n\nimport { useCallback, useSyncExternalStore } from 'react';\n\n/**\n * Minimal imperative handle every text-editor surface implements so\n * an external tool (voice dictation, command palette, AI suggestion)\n * can read/write its text content without traversing React.\n *\n * Methods are optional so a host can register a partial handle\n * (e.g. only `getValue` + `setValue`), and the caller checks before use.\n */\nexport interface ComposerHandle {\n  /** Move keyboard focus into the composer's editable surface. */\n  focus: () => void;\n  /** Move the caret to the very end of the input. */\n  moveCursorToEnd?: () => void;\n  /** Read the current draft text. Voice dictation anchors partial\n   *  transcripts onto the user's already-typed prefix via this. */\n  getValue?: () => string;\n  /** Replace the current draft text. Voice dictation pushes interim\n   *  and final transcripts through this without owning a controlled\n   *  binding. */\n  setValue?: (value: string) => void;\n}\n\n/**\n * `@djangocfg/ui-tools/composer-registry`\n *\n * Cross-tool bridge: the currently-active text composer's handle.\n *\n * Producer side (`@djangocfg/ui-tools/chat` and TipTap hosts):\n *   register their composer's imperative handle via `attachComposer`.\n *\n * Consumer side (`@djangocfg/ui-tools/speech-recognition`):\n *   reads the active handle via `useActiveComposer`/`getActiveComposer`\n *   and pipes voice transcripts into it.\n *\n * Why this lives in its own subpath (not inside `chat`)\n * ----------------------------------------------------\n * `chat` and `speech-recognition` are sibling subpath exports. If the\n * registry lived inside `chat`, then `speech-recognition` would have\n * to reach into it via a cross-tool relative import — and under Vite\n * dev's dependency optimizer that file ends up loaded TWICE (once via\n * the `./chat` URL, once via the `./speech-recognition` relative-up\n * URL), giving the producer and the consumer two separate `let active`\n * slots. The active handle registered by chat would be invisible to\n * speech-recognition (and vice versa).\n *\n * Putting the registry in its own dedicated subpath (a single tool\n * that NEITHER chat nor speech-recognition cross-import — they both\n * import this one as their dependency) means Vite resolves it from a\n * single URL across the whole graph. One module instance, one shared\n * `active` slot.\n *\n * Semantics: one active composer per realm. The most recent\n * `registerComposer(handle)` wins; `registerComposer(null)` clears it.\n */\n\ntype Listener = (handle: ComposerHandle | null) => void;\n\nlet active: ComposerHandle | null = null;\nconst listeners = new Set<Listener>();\n\n/** Set or replace the active composer handle. Pass `null` to clear. */\nexport function registerComposer(handle: ComposerHandle | null): void {\n  active = handle;\n  for (const fn of listeners) fn(active);\n}\n\n/**\n * Convenience for components: register on mount, unregister on\n * unmount. Returns a cleanup function suitable for `useEffect`.\n */\nexport function attachComposer(handle: ComposerHandle): () => void {\n  registerComposer(handle);\n  return () => {\n    if (active === handle) registerComposer(null);\n  };\n}\n\n/** Read the current active handle (no subscription). */\nexport function getActiveComposer(): ComposerHandle | null {\n  return active;\n}\n\n/** Subscribe to handle changes; returns an unsubscribe fn. */\nexport function subscribeComposer(listener: Listener): () => void {\n  listeners.add(listener);\n  return () => {\n    listeners.delete(listener);\n  };\n}\n\n/**\n * React hook: re-renders the caller whenever the active composer\n * changes. Built on `useSyncExternalStore` so concurrent rendering,\n * SSR, and dev-mode strict-effects all behave correctly.\n */\nexport function useActiveComposer(): ComposerHandle | null {\n  const subscribe = useCallback((onChange: () => void) => {\n    return subscribeComposer(onChange);\n  }, []);\n  return useSyncExternalStore(subscribe, getActiveComposer, () => null);\n}\n"]}

package/dist/tree/index.cjs

@@ -5,9 +5,9 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var chunkPK6SKIKE_cjs = require('../chunk-PK6SKIKE.cjs');
 var React = require('react');
 var lib = require('@djangocfg/ui-core/lib');
-var components = require('@djangocfg/ui-core/components');
 var dialogService = require('@djangocfg/ui-core/lib/dialog-service');
 var lucideReact = require('lucide-react');
+var components = require('@djangocfg/ui-core/components');
 var jsxRuntime = require('react/jsx-runtime');
 var core = require('@dnd-kit/core');
 var hooks = require('@djangocfg/ui-core/hooks');
@@ -1071,6 +1071,47 @@ function useResolvedMenu(opts) {
   ]);
 }
 chunkPK6SKIKE_cjs.__name(useResolvedMenu, "useResolvedMenu");
+function renderItemsAsContextMenu(rowProps, items, trigger) {
+  return /* @__PURE__ */ jsxRuntime.jsxs(components.ContextMenu, { children: [
+    /* @__PURE__ */ jsxRuntime.jsx(components.ContextMenuTrigger, { asChild: true, children: trigger }),
+    /* @__PURE__ */ jsxRuntime.jsx(components.ContextMenuContent, { children: items.map((item, idx) => {
+      if (item === "separator") {
+        return /* @__PURE__ */ jsxRuntime.jsx(components.ContextMenuSeparator, {}, `sep-${idx}`);
+      }
+      const Icon = item.icon;
+      return /* @__PURE__ */ jsxRuntime.jsxs(
+        components.ContextMenuItem,
+        {
+          disabled: item.disabled,
+          variant: item.destructive ? "destructive" : void 0,
+          onSelect: () => item.onSelect(rowProps),
+          children: [
+            Icon ? /* @__PURE__ */ jsxRuntime.jsx(Icon, {}) : null,
+            item.label,
+            item.shortcut ? /* @__PURE__ */ jsxRuntime.jsx(components.ContextMenuShortcut, { children: item.shortcut }) : null
+          ]
+        },
+        item.id
+      );
+    }) })
+  ] });
+}
+chunkPK6SKIKE_cjs.__name(renderItemsAsContextMenu, "renderItemsAsContextMenu");
+function tidyMenuItems(items) {
+  const out = [];
+  for (const it of items) {
+    if (it === "separator") {
+      if (out.length === 0) continue;
+      if (out[out.length - 1] === "separator") continue;
+      out.push(it);
+    } else {
+      out.push(it);
+    }
+  }
+  while (out.length > 0 && out[out.length - 1] === "separator") out.pop();
+  return out;
+}
+chunkPK6SKIKE_cjs.__name(tidyMenuItems, "tidyMenuItems");
 
 // src/tools/data/Tree/data/dnd.ts
 function resolveDropZone(input) {
@@ -1435,6 +1476,20 @@ function TreeProvider(props) {
     copyToClipboard: clipboard.copyToClipboard,
     pasteFromClipboard: clipboard.pasteFromClipboard
   });
+  const finalRenderContextMenu = React.useMemo(
+    () => {
+      if (renderContextMenu) return renderContextMenu;
+      const resolve = resolvedContextMenuActions;
+      if (!resolve) return void 0;
+      return (rowProps, trigger) => {
+        const items = resolve(rowProps);
+        const cleaned = items ? tidyMenuItems(items) : null;
+        if (!cleaned || cleaned.length === 0) return trigger;
+        return renderItemsAsContextMenu(rowProps, cleaned, trigger);
+      };
+    },
+    [renderContextMenu, resolvedContextMenuActions]
+  );
   const value = React.useMemo(
     () => ({
       // state
@@ -1476,7 +1531,7 @@ function TreeProvider(props) {
       renderIcon,
       renderLabel,
       renderActions,
-      renderContextMenu,
+      renderContextMenu: finalRenderContextMenu,
       adapter,
       resolvedContextMenuActions,
       getNodeById: /* @__PURE__ */ chunkPK6SKIKE_cjs.__name((id) => nodeById.get(id), "getNodeById"),
@@ -1513,7 +1568,7 @@ function TreeProvider(props) {
       renderIcon,
       renderLabel,
       renderActions,
-      renderContextMenu,
+      finalRenderContextMenu,
       adapter,
       resolvedContextMenuActions,
       nodeById,
@@ -2789,47 +2844,6 @@ function useTreeFinderHotkeys(opts) {
   return { ref };
 }
 chunkPK6SKIKE_cjs.__name(useTreeFinderHotkeys, "useTreeFinderHotkeys");
-function renderItemsAsContextMenu(rowProps, items, trigger) {
-  return /* @__PURE__ */ jsxRuntime.jsxs(components.ContextMenu, { children: [
-    /* @__PURE__ */ jsxRuntime.jsx(components.ContextMenuTrigger, { asChild: true, children: trigger }),
-    /* @__PURE__ */ jsxRuntime.jsx(components.ContextMenuContent, { children: items.map((item, idx) => {
-      if (item === "separator") {
-        return /* @__PURE__ */ jsxRuntime.jsx(components.ContextMenuSeparator, {}, `sep-${idx}`);
-      }
-      const Icon = item.icon;
-      return /* @__PURE__ */ jsxRuntime.jsxs(
-        components.ContextMenuItem,
-        {
-          disabled: item.disabled,
-          variant: item.destructive ? "destructive" : void 0,
-          onSelect: () => item.onSelect(rowProps),
-          children: [
-            Icon ? /* @__PURE__ */ jsxRuntime.jsx(Icon, {}) : null,
-            item.label,
-            item.shortcut ? /* @__PURE__ */ jsxRuntime.jsx(components.ContextMenuShortcut, { children: item.shortcut }) : null
-          ]
-        },
-        item.id
-      );
-    }) })
-  ] });
-}
-chunkPK6SKIKE_cjs.__name(renderItemsAsContextMenu, "renderItemsAsContextMenu");
-function tidyMenuItems(items) {
-  const out = [];
-  for (const it of items) {
-    if (it === "separator") {
-      if (out.length === 0) continue;
-      if (out[out.length - 1] === "separator") continue;
-      out.push(it);
-    } else {
-      out.push(it);
-    }
-  }
-  while (out.length > 0 && out[out.length - 1] === "separator") out.pop();
-  return out;
-}
-chunkPK6SKIKE_cjs.__name(tidyMenuItems, "tidyMenuItems");
 function TreeRoot(props) {
   const {
     data,
@@ -2863,6 +2877,7 @@ function TreeRoot(props) {
     persistSelection = false,
     adapter,
     defaultMenuItems,
+    actionsRef,
     className,
     style
   } = props;
@@ -2905,7 +2920,8 @@ function TreeRoot(props) {
           enableSearch,
           enableTypeAhead,
           enableFinderHotkeys,
-          renderRow
+          renderRow,
+          actionsRef
         }
       )
     }
@@ -2918,10 +2934,29 @@ function TreeRootShell({
   enableSearch,
   enableTypeAhead,
   enableFinderHotkeys,
-  renderRow
+  renderRow,
+  actionsRef
 }) {
   const containerRef = React.useRef(null);
   const ctx = useTreeContext();
+  React.useEffect(() => {
+    if (!actionsRef) return;
+    actionsRef.current = {
+      refresh: ctx.refresh,
+      refreshAll: ctx.refreshAll,
+      expandAll: ctx.expandAll,
+      collapseAll: ctx.collapseAll
+    };
+    return () => {
+      if (actionsRef.current) actionsRef.current = null;
+    };
+  }, [
+    actionsRef,
+    ctx.refresh,
+    ctx.refreshAll,
+    ctx.expandAll,
+    ctx.collapseAll
+  ]);
   const isMulti = ctx.selectionMode === "multiple";
   const { ref: keyboardRef } = useTreeKeyboard({
     rows: ctx.flatRows,
@@ -2998,21 +3033,6 @@ function TreeRootShell({
     onMatch: onTypeAheadMatch,
     enabled: enableTypeAhead
   });
-  const finalRenderContextMenu = React.useMemo(() => {
-    if (ctx.renderContextMenu) return ctx.renderContextMenu;
-    const resolve = ctx.resolvedContextMenuActions;
-    if (!resolve) return void 0;
-    return (rowProps, trigger) => {
-      const items = resolve(rowProps);
-      const cleaned = items ? tidyMenuItems(items) : null;
-      if (!cleaned || cleaned.length === 0) return trigger;
-      return renderItemsAsContextMenu(rowProps, cleaned, trigger);
-    };
-  }, [ctx.renderContextMenu, ctx.resolvedContextMenuActions]);
-  const childCtx = React.useMemo(
-    () => ({ ...ctx, renderContextMenu: finalRenderContextMenu }),
-    [ctx, finalRenderContextMenu]
-  );
   const treeBody = /* @__PURE__ */ jsxRuntime.jsxs(
     "div",
     {
@@ -3038,8 +3058,7 @@ function TreeRootShell({
       ]
     }
   );
-  const body = finalRenderContextMenu === ctx.renderContextMenu ? treeBody : /* @__PURE__ */ jsxRuntime.jsx(TreeContext.Provider, { value: childCtx, children: treeBody });
-  return /* @__PURE__ */ jsxRuntime.jsx(TreeDndProvider, { children: body });
+  return /* @__PURE__ */ jsxRuntime.jsx(TreeDndProvider, { children: treeBody });
 }
 chunkPK6SKIKE_cjs.__name(TreeRootShell, "TreeRootShell");
 var TreeRoot_default = TreeRoot;