@dxos/react-ui-chat 0.8.4-main.c4373fc → 0.8.4-main.d05539e30a

package/package.json

@@ -1,24 +1,34 @@
 {
   "name": "@dxos/react-ui-chat",
-  "version": "0.8.4-main.c4373fc",
+  "version": "0.8.4-main.d05539e30a",
   "description": "Chat components.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
-  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dxos/dxos"
+  },
+  "license": "FSL-1.1-Apache-2.0",
   "author": "DXOS.org",
   "type": "module",
+  "imports": {
+    "#translations": "./src/translations.ts"
+  },
   "exports": {
     ".": {
       "source": "./src/index.ts",
       "types": "./dist/types/src/index.d.ts",
       "browser": "./dist/lib/browser/index.mjs",
       "node": "./dist/lib/node-esm/index.mjs"
+    },
+    "./translations": {
+      "source": "./src/translations.ts",
+      "types": "./dist/types/src/translations.d.ts",
+      "browser": "./dist/lib/browser/translations.mjs",
+      "node": "./dist/lib/node-esm/translations.mjs"
     }
   },
   "types": "dist/types/src/index.d.ts",
-  "typesVersions": {
-    "*": {}
-  },
   "files": [
     "dist",
     "src"
@@ -28,47 +38,45 @@
     "@codemirror/language": "^6.11.3",
     "@codemirror/search": "^6.5.11",
     "@codemirror/state": "^6.5.2",
-    "@codemirror/view": "^6.38.4",
-    "@fluentui/react-tabster": "^9.24.2",
-    "@preact-signals/safe-react": "^0.9.0",
-    "@preact/signals-core": "^1.12.1",
+    "@codemirror/view": "^6.38.5",
+    "@fluentui/react-tabster": "9.26.11",
     "@radix-ui/react-accordion": "1.2.3",
     "@radix-ui/react-context": "1.1.1",
-    "@dxos/async": "0.8.4-main.c4373fc",
-    "@dxos/debug": "0.8.4-main.c4373fc",
-    "@dxos/echo": "0.8.4-main.c4373fc",
-    "@dxos/invariant": "0.8.4-main.c4373fc",
-    "@dxos/log": "0.8.4-main.c4373fc",
-    "@dxos/live-object": "0.8.4-main.c4373fc",
-    "@dxos/react-ui": "0.8.4-main.c4373fc",
-    "@dxos/react-ui-components": "0.8.4-main.c4373fc",
-    "@dxos/react-ui-editor": "0.8.4-main.c4373fc",
-    "@dxos/react-ui-sfx": "0.8.4-main.c4373fc",
-    "@dxos/react-ui-dnd": "0.8.4-main.c4373fc",
-    "@dxos/react-ui-text-tooltip": "0.8.4-main.c4373fc",
-    "@dxos/react-ui-theme": "0.8.4-main.c4373fc",
-    "@dxos/react-ui-syntax-highlighter": "0.8.4-main.c4373fc",
-    "@dxos/react-ui-types": "0.8.4-main.c4373fc",
-    "@dxos/util": "0.8.4-main.c4373fc"
+    "@dxos/async": "0.8.4-main.d05539e30a",
+    "@dxos/debug": "0.8.4-main.d05539e30a",
+    "@dxos/echo": "0.8.4-main.d05539e30a",
+    "@dxos/react-ui": "0.8.4-main.d05539e30a",
+    "@dxos/log": "0.8.4-main.d05539e30a",
+    "@dxos/invariant": "0.8.4-main.d05539e30a",
+    "@dxos/react-ui-components": "0.8.4-main.d05539e30a",
+    "@dxos/react-ui-dnd": "0.8.4-main.d05539e30a",
+    "@dxos/react-ui-editor": "0.8.4-main.d05539e30a",
+    "@dxos/react-ui-sfx": "0.8.4-main.d05539e30a",
+    "@dxos/react-ui-syntax-highlighter": "0.8.4-main.d05539e30a",
+    "@dxos/ui-editor": "0.8.4-main.d05539e30a",
+    "@dxos/react-ui-text-tooltip": "0.8.4-main.d05539e30a",
+    "@dxos/ui-theme": "0.8.4-main.d05539e30a",
+    "@dxos/ui-types": "0.8.4-main.d05539e30a",
+    "@dxos/util": "0.8.4-main.d05539e30a"
   },
   "devDependencies": {
-    "@types/react": "~19.2.2",
-    "@types/react-dom": "~19.2.1",
-    "effect": "3.18.3",
-    "react": "~19.2.0",
-    "react-dom": "~19.2.0",
-    "vite": "7.1.9",
-    "@dxos/echo": "0.8.4-main.c4373fc",
-    "@dxos/react-client": "0.8.4-main.c4373fc",
-    "@dxos/random": "0.8.4-main.c4373fc",
-    "@dxos/storybook-utils": "0.8.4-main.c4373fc"
+    "@types/react": "~19.2.7",
+    "@types/react-dom": "~19.2.3",
+    "effect": "3.20.0",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
+    "vite": "^8.0.13",
+    "@dxos/echo": "0.8.4-main.d05539e30a",
+    "@dxos/random": "0.8.4-main.d05539e30a",
+    "@dxos/react-client": "0.8.4-main.d05539e30a",
+    "@dxos/storybook-utils": "0.8.4-main.d05539e30a"
   },
   "peerDependencies": {
-    "effect": "^3.13.3",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "@dxos/react-ui": "0.8.4-main.c4373fc",
-    "@dxos/react-ui-theme": "0.8.4-main.c4373fc"
+    "effect": "3.20.0",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
+    "@dxos/react-ui": "0.8.4-main.d05539e30a",
+    "@dxos/ui-theme": "0.8.4-main.d05539e30a"
   },
   "publishConfig": {
     "access": "public"

package/src/components/ChatDialog/ChatDialog.stories.tsx

@@ -6,9 +6,9 @@ import { type Meta, type StoryObj } from '@storybook/react-vite';
 import React, { useState } from 'react';
 
 import { Input, Toolbar } from '@dxos/react-ui';
-import { withTheme } from '@dxos/react-ui/testing';
+import { withLayout, withTheme } from '@dxos/react-ui/testing';
 
-import { translations } from '../../translations';
+import { translations } from '#translations';
 
 import { ChatDialog } from './ChatDialog';
 
@@ -37,7 +37,7 @@ const meta = {
           <ChatDialog.Header title='Chat' />
           <ChatDialog.Content>
             {items.map((item) => (
-              <div key={item} className='pis-4 pbe-1'>
+              <div key={item} className='ps-4 pb-1'>
                 {item}
               </div>
             ))}
@@ -51,9 +51,8 @@ const meta = {
       </>
     );
   },
-  decorators: [withTheme],
+  decorators: [withTheme(), withLayout({ layout: 'column' })],
   parameters: {
-    layout: 'column',
     translations,
   },
 } satisfies Meta<typeof ChatDialog.Root>;

package/src/components/ChatDialog/ChatDialog.tsx

@@ -7,14 +7,16 @@ import React, { type Dispatch, type PropsWithChildren, type SetStateAction, useE
 
 import { Dialog, Icon, IconButton, type ThemedClassName, useControlledState } from '@dxos/react-ui';
 import { ResizeHandle, type Size, resizeAttributes, sizeStyle } from '@dxos/react-ui-dnd';
-import { mx } from '@dxos/react-ui-theme';
+import { mx } from '@dxos/ui-theme';
 
 const preventDefault = (event: Event) => event.preventDefault();
 
 // TODO(burdon): Factor out.
 const Endcap = ({ children }: PropsWithChildren) => {
   return (
-    <div className='grid w-[var(--rail-action)] h-[var(--rail-action)] items-center justify-center'>{children}</div>
+    <div className='grid w-[var(--dx-rail-action)] h-[var(--dx-rail-action)] items-center justify-center'>
+      {children}
+    </div>
   );
 };
 
@@ -47,15 +49,15 @@ type ChatDialogRootProps = PropsWithChildren<{
 
 const ChatDialogRoot = ({
   children,
-  open: _open = false,
-  expanded: expandedParam = false,
+  open: openProp = false,
+  expanded: expandedProp = false,
   onOpenChange,
   onExpandedChange,
   onEscape,
 }: ChatDialogRootProps) => {
   const [size, setSize] = useState<Size>('min-content');
-  const [open, setOpen] = useControlledState<boolean>(_open, onOpenChange);
-  const [expanded, setExpanded] = useControlledState<boolean>(expandedParam, onExpandedChange);
+  const [open, setOpen] = useControlledState<boolean>(openProp, onOpenChange);
+  const [expanded, setExpanded] = useControlledState<boolean>(expandedProp, onExpandedChange);
 
   // NOTE: We set the min size to 5rem (80px), and the header and prompt bar to 40px (i.e., the rail-size) each.
   // The dialog has no vertical padding and has box-content so that when closed it collapses to the size of the header and prompt bar.
@@ -69,12 +71,12 @@ const ChatDialogRoot = ({
       setSize={setSize}
     >
       <Dialog.Root modal={false} open={open} onOpenChange={setOpen}>
-        <div role='none' className='dx-dialog__overlay bg-transparent pointer-events-none' data-block-align='end'>
+        <div className='dx-dialog__overlay bg-transparent pointer-events-none' data-block-align='end'>
           <Dialog.Content
+            size='md'
             inOverlayLayout
             classNames={[
-              'grid grid-rows-[var(--rail-action)_1fr_min-content] p-0 overflow-hidden',
-              'box-content md:is-[35rem] md:max-is-none pointer-events-auto',
+              'grid grid-rows-[var(--dx-rail-action)_1fr_min-content] p-0 overflow-hidden box-content pointer-events-auto',
             ]}
             onEscapeKeyDown={onEscape}
             onInteractOutside={preventDefault}
@@ -93,15 +95,19 @@ ChatDialogRoot.displayName = 'ChatDialog.Root';
 // Header
 //
 
+const CHAT_DIALOG_HEADER_NAME = 'ChatDialog.Header';
+
 type ChatDialogHeaderProps = ThemedClassName<{
   title?: string;
 }>;
 
 const ChatDialogHeader = ({ classNames, title }: ChatDialogHeaderProps) => {
-  const { expanded, setExpanded } = useChatDialogContext(ChatDialogHeader.displayName);
+  const { expanded, setExpanded } = useChatDialogContext(CHAT_DIALOG_HEADER_NAME);
 
   return (
-    <div className={mx('grid grid-cols-[var(--rail-action)_1fr_min-content] items-center overflow-hidden', classNames)}>
+    <div
+      className={mx('grid grid-cols-[var(--dx-rail-action)_1fr_min-content] items-center overflow-hidden', classNames)}
+    >
       <Endcap>
         <Dialog.Close>
           <Icon icon='ph--x--regular' />
@@ -118,7 +124,7 @@ const ChatDialogHeader = ({ classNames, title }: ChatDialogHeaderProps) => {
           variant='ghost'
           icon='ph--caret-up--regular'
           iconOnly
-          classNames={mx('!p-1 [&>svg]:transition [&>svg]:duration-200', expanded && '[&>svg]:rotate-180')}
+          classNames={mx('p-1! [&>svg]:transition [&>svg]:duration-200', expanded && '[&>svg]:rotate-180')}
           label={expanded ? 'Close' : 'Open'}
           onClick={() => setExpanded((expanded) => !expanded)}
         />
@@ -127,16 +133,18 @@ const ChatDialogHeader = ({ classNames, title }: ChatDialogHeaderProps) => {
   );
 };
 
-ChatDialogHeader.displayName = 'ChatDialog.Header';
+ChatDialogHeader.displayName = CHAT_DIALOG_HEADER_NAME;
 
 //
 // Content
 //
 
+const CHAT_DIALOG_CONTENT_NAME = 'ChatDialog.Content';
+
 type ChatDialogContentProps = ThemedClassName<PropsWithChildren>;
 
 const ChatDialogContent = ({ children, classNames }: ChatDialogContentProps) => {
-  const { expanded, size, setSize } = useChatDialogContext(ChatDialogContent.displayName);
+  const { expanded, size, setSize } = useChatDialogContext(CHAT_DIALOG_CONTENT_NAME);
   useEffect(() => {
     setSize(expanded ? 'min-content' : 0);
   }, [expanded]);
@@ -144,8 +152,8 @@ const ChatDialogContent = ({ children, classNames }: ChatDialogContentProps) =>
   return (
     <div
       className={mx(
-        'flex flex-col overflow-y-auto border-t border-b border-subduedSeparator',
-        'transition-[block-size] ease-in-out duration-0 [&:not([data-dx-resizing="true"])]:duration-200',
+        'border-t border-b border-subdued-separator',
+        'transition ease-in-out duration-0 [&:not([data-dx-resizing="true"])]:duration-200',
         classNames,
       )}
       style={{
@@ -167,19 +175,21 @@ const ChatDialogContent = ({ children, classNames }: ChatDialogContentProps) =>
   );
 };
 
-ChatDialogContent.displayName = 'ChatDialog.Content';
+ChatDialogContent.displayName = CHAT_DIALOG_CONTENT_NAME;
 
 //
 // Footer
 //
 
+const CHAT_DIALOG_FOOTER_NAME = 'ChatDialog.Footer';
+
 type ChatDialogFooterProps = ThemedClassName<PropsWithChildren>;
 
 const ChatDialogFooter = ({ children, classNames }: ChatDialogFooterProps) => {
   return <div className={mx(classNames)}>{children}</div>;
 };
 
-ChatDialogFooter.displayName = 'ChatDialog.Footer';
+ChatDialogFooter.displayName = CHAT_DIALOG_FOOTER_NAME;
 
 //
 // ChatDialog

package/src/components/ChatEditor/ChatEditor.stories.tsx

@@ -7,7 +7,7 @@ import { type Meta, type StoryObj } from '@storybook/react-vite';
 import { log } from '@dxos/log';
 import { withTheme } from '@dxos/react-ui/testing';
 
-import { translations } from '../../translations';
+import { translations } from '#translations';
 
 import { ChatEditor } from './ChatEditor';
 import { type ReferenceData } from './references';
@@ -15,7 +15,7 @@ import { type ReferenceData } from './references';
 const meta = {
   title: 'ui/react-ui-chat/ChatEditor',
   component: ChatEditor,
-  decorators: [withTheme],
+  decorators: [withTheme()],
   parameters: {
     layout: 'centered',
     translations,
@@ -31,34 +31,36 @@ type Story = StoryObj<typeof meta>;
 export const Default: Story = {
   args: {
     classNames,
+    placeholder: 'Ask a question...',
   },
 };
 
+// TODO(burdon): Restore and reconcile with suggest/typeahead.
 export const WithSuggestions: Story = {
   args: {
     classNames,
     onSubmit: (text) => {
       log('onSubmit', { text });
     },
-    onSuggest: (text) => {
-      const trimmed = text.trim().toLowerCase();
-      if (trimmed.length < 2) {
-        return [];
-      }
 
-      const suggestions = [
-        'Create a kanban board',
-        'Create a new project',
-        'Find flights to Tokyo',
-        "Let's play chess",
-        'Show me Paris on a map',
-      ];
-
-      return suggestions.filter((s) => s.toLowerCase().startsWith(text));
-    },
+    // onSuggest: (text) => {
+    //   const trimmed = text.trim().toLowerCase();
+    //   if (trimmed.length < 2) {
+    //     return [];
+    //   }
+    //   const suggestions = [
+    //     'Create a kanban board',
+    //     'Create a new project',
+    //     'Find flights to Tokyo',
+    //     "Let's play chess",
+    //     'Show me Paris on a map',
+    //   ];
+    //   return suggestions.filter((s) => s.toLowerCase().startsWith(text));
+    // },
   },
 };
 
+// TODO(burdon): Replace.
 const references: ReferenceData[] = [
   {
     uri: 'dxn:echo:@:AAAAAAAA',

package/src/components/ChatEditor/ChatEditor.tsx

@@ -3,104 +3,57 @@
 //
 
 import { type Extension } from '@codemirror/state';
-import { keymap } from '@codemirror/view';
-import { useFocusFinders } from '@fluentui/react-tabster';
-import React, { forwardRef, useImperativeHandle } from 'react';
+import React, { forwardRef, useMemo } from 'react';
 
 import { type ThemedClassName, useThemeContext } from '@dxos/react-ui';
+import { Editor, type EditorController, type UseTextEditorProps } from '@dxos/react-ui-editor';
 import {
-  type AutocompleteOptions,
   type BasicExtensionsOptions,
-  type UseTextEditorProps,
-  autocomplete,
+  type SubmitOptions,
   createBasicExtensions,
   createThemeExtensions,
-  useTextEditor,
-} from '@dxos/react-ui-editor';
-import { mx } from '@dxos/react-ui-theme';
+  submit,
+  xmlFormatting,
+} from '@dxos/ui-editor';
 import { isTruthy } from '@dxos/util';
 
-import { type ReferencesOptions, references as referencesExtension } from './references';
+import { type ReferencesOptions } from './references';
 
-export interface ChatEditorController {
-  focus(): void;
-  getText(): string;
-  setText(text: string): void;
-}
+export interface ChatEditorController extends EditorController {}
 
 export type ChatEditorProps = ThemedClassName<
   {
     extensions?: Extension;
     references?: ReferencesOptions;
-  } & AutocompleteOptions &
+  } & (SubmitOptions &
     Pick<UseTextEditorProps, 'id' | 'autoFocus'> &
-    Pick<BasicExtensionsOptions, 'lineWrapping' | 'placeholder'>
+    Pick<BasicExtensionsOptions, 'lineWrapping' | 'placeholder'>)
 >;
 
+export const useChatExtensions = ({ extensions, lineWrapping = false, placeholder, onSubmit }: ChatEditorProps) => {
+  const { themeMode } = useThemeContext();
+  return useMemo<Extension[]>(
+    () =>
+      [
+        createThemeExtensions({ themeMode }),
+        createBasicExtensions({ bracketMatching: false, lineWrapping, placeholder }),
+        xmlFormatting(),
+        submit({ onSubmit }),
+        extensions,
+      ].filter(isTruthy),
+    [themeMode, extensions, onSubmit],
+  );
+};
+
 export const ChatEditor = forwardRef<ChatEditorController, ChatEditorProps>(
-  (
-    { classNames, extensions, references, autoFocus, lineWrapping = false, placeholder, onSubmit, onSuggest, onCancel },
-    forwardRef,
-  ) => {
-    const { themeMode } = useThemeContext();
-    const { findNextFocusable, findPrevFocusable } = useFocusFinders();
-    const { parentRef, view } = useTextEditor(
-      () => ({
-        debug: true,
-        autoFocus,
-        extensions: [
-          createThemeExtensions({ themeMode }),
-          createBasicExtensions({ bracketMatching: false, lineWrapping, placeholder }),
-          autocomplete({ onSubmit, onSuggest, onCancel }),
-          references ? referencesExtension({ provider: references.provider }) : [],
-          // TODO(burdon): Standardize.
-          keymap.of([
-            {
-              key: 'Tab',
-              preventDefault: true,
-              run: (view) => {
-                findNextFocusable(view.dom)?.focus();
-                return true;
-              },
-            },
-            {
-              key: 'Shift-Tab',
-              preventDefault: true,
-              run: (view) => {
-                findPrevFocusable(view.dom)?.focus();
-                return true;
-              },
-            },
-          ]),
-          extensions,
-        ].filter(isTruthy),
-      }),
-      [themeMode, extensions, onSubmit, onSuggest, onCancel],
+  ({ classNames, autoFocus, extensions: extensionsProp, lineWrapping = false, placeholder, onSubmit }, forwardRef) => {
+    const extensions = useChatExtensions({ extensions: extensionsProp, lineWrapping, placeholder, onSubmit });
+
+    // TODO(burdon): Popover.
+    return (
+      <Editor.Root ref={forwardRef}>
+        <Editor.View classNames={classNames} autoFocus={autoFocus} extensions={extensions} />
+      </Editor.Root>
     );
-
-    // Expose editor view.
-    useImperativeHandle(forwardRef, () => {
-      return {
-        focus: () => {
-          view?.focus();
-        },
-        getText: () => view?.state.doc.toString() ?? '',
-        setText: (text: string) => {
-          view?.dispatch({
-            changes: {
-              from: 0,
-              to: view.state.doc.length,
-              insert: text,
-            },
-            selection: {
-              anchor: text.length,
-              head: text.length,
-            },
-          });
-        },
-      };
-    }, [view, onSubmit]);
-
-    return <div ref={parentRef} className={mx('is-full', classNames)} />;
   },
 );

package/src/components/ChatEditor/references.ts

@@ -19,10 +19,14 @@ import { invariant } from '@dxos/invariant';
 
 // TODO(dmaretskyi): Consider adding details renderer for when you hover over the reference.
 export type ReferenceData = {
-  uri: string;
+  uri: string; // TODO(burdon): Rename dxn.
   label: string;
 };
 
+/**
+ * @deprecated
+ */
+// TODO(burdon): Remove.
 export interface ReferencesProvider {
   getReferences({ query }: { query: string }): Promise<ReferenceData[]>;
   resolveReference({ uri }: { uri: string }): Promise<ReferenceData | null>;
@@ -45,7 +49,9 @@ export type ReferencesOptions = {
 
 /**
  * Lookup object references.
+ * @deprecated
  */
+// TODO(burdon): Remove.
 export const references = ({ provider, triggerCharacter = '@', debug = false }: ReferencesOptions): Extension => {
   invariant(triggerCharacter.length === 1);
 
@@ -103,7 +109,7 @@ export const references = ({ provider, triggerCharacter = '@', debug = false }:
     },
     {
       decorations: (v) => v.decorations,
-      provide: (plugin) => [
+      provide: () => [
         EditorView.atomicRanges.of(
           (view): DecorationSet => view.plugin(decorationField)?.decorations ?? RangeSet.empty,
         ),
@@ -124,7 +130,7 @@ export const references = ({ provider, triggerCharacter = '@', debug = false }:
     }),
 
     autocompletion({
-      tooltipClass: () => 'shadow rounded',
+      tooltipClass: () => 'shadow rounded-sm',
       activateOnTyping: true,
       aboveCursor: true,
       closeOnBlur: !debug,
@@ -158,18 +164,18 @@ class ReferenceWidget extends WidgetType {
     super();
   }
 
-  override toDOM(): HTMLSpanElement {
-    const span = document.createElement('span');
-    span.textContent = `@ ${this.data.label}`;
-    span.className = 'cm-reference-pill';
-    return span;
+  override ignoreEvent() {
+    return true;
   }
 
-  override eq(other: ReferenceWidget): boolean {
-    return other.data.uri === this.data.uri;
+  override eq(other: this) {
+    return this.data.uri === other.data.uri;
   }
 
-  override ignoreEvent(): boolean {
-    return true;
+  override toDOM() {
+    const span = document.createElement('span');
+    span.textContent = `@${this.data.label}`;
+    span.className = 'cm-reference-pill';
+    return span;
   }
 }