@dxos/plugin-thread 0.8.4-main.fd6878d → 0.9.0

package/src/components/ChannelContainer.tsx

@@ -1,201 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { Rx } from '@effect-rx/rx-react';
-import React, { type ChangeEvent, useCallback, useEffect, useMemo, useState } from 'react';
-
-import { useCapabilities, useCapability } from '@dxos/app-framework';
-import { Context } from '@dxos/context';
-import { failUndefined } from '@dxos/debug';
-import { log } from '@dxos/log';
-import { useClient } from '@dxos/react-client';
-import { fullyQualifiedId, getSpace } from '@dxos/react-client/echo';
-import { useIdentity } from '@dxos/react-client/halo';
-import { ElevationProvider, Input, type ThemedClassName, useTranslation } from '@dxos/react-ui';
-import { ControlGroup, ControlGroupButton, ControlItemInput } from '@dxos/react-ui-form';
-import { MenuProvider, ToolbarMenu, createMenuAction, createMenuItemGroup, useMenuActions } from '@dxos/react-ui-menu';
-import { useSoundEffect } from '@dxos/react-ui-sfx';
-import { StackItem } from '@dxos/react-ui-stack';
-
-import { ThreadCapabilities } from '../capabilities';
-import { meta } from '../meta';
-import { type ChannelType } from '../types';
-
-import { Call } from './Call';
-import ChatContainer from './ChatContainer';
-
-export type ChannelContainerProps = {
-  channel?: ChannelType;
-  roomId?: string;
-  role?: string;
-  fullscreen?: boolean;
-};
-
-/**
- * Renders a call when active, otherwise renders the channel chat.
- */
-export const ChannelContainer = ({ channel, roomId: _roomId, role, fullscreen }: ChannelContainerProps) => {
-  const space = getSpace(channel);
-  const callManager = useCapability(ThreadCapabilities.CallManager);
-  const roomId = _roomId ?? (channel ? fullyQualifiedId(channel) : failUndefined());
-  const identity = useIdentity();
-  const isNamed = !!identity?.profile?.displayName;
-  const joinSound = useSoundEffect('JoinCall');
-  const leaveSound = useSoundEffect('LeaveCall');
-
-  const extensions = useCapabilities(ThreadCapabilities.CallExtension);
-  useEffect(() => {
-    const ctx = new Context();
-    callManager.left.on(ctx, (roomId) => {
-      extensions.forEach((extension) => {
-        void extension.onLeave?.(roomId);
-      });
-    });
-
-    callManager.callStateUpdated.on(ctx, (state) => {
-      extensions.forEach((extension) => {
-        void extension.onCallStateUpdated?.(state);
-      });
-    });
-
-    callManager.mediaStateUpdated.on(ctx, (state) => {
-      extensions.forEach((extension) => {
-        void extension.onMediaStateUpdated?.(state);
-      });
-    });
-
-    return () => {
-      void ctx.dispose();
-    };
-  }, [callManager, extensions]);
-
-  /**
-   * Join the call.
-   */
-  // TODO(wittjosiah): Show preview before joining?
-  const handleJoin = useCallback(async () => {
-    if (!roomId || !channel) {
-      return;
-    }
-
-    if (callManager.joined) {
-      await callManager.leave();
-    }
-
-    try {
-      void joinSound.play();
-      callManager.setRoomId(roomId);
-      await callManager.join();
-      await Promise.all(extensions.map((extension) => extension.onJoin?.({ channel, roomId })));
-    } catch (err) {
-      // TODO(burdon): Error sound.
-      log.catch(err);
-    }
-  }, [extensions, channel, roomId]);
-
-  /**
-   * Leave the call.
-   */
-  const handleLeave = useCallback(async () => {
-    try {
-      void leaveSound.play();
-    } catch (err) {
-      // TODO(burdon): Error sound.
-      log.catch(err);
-    } finally {
-      void callManager.turnAudioOff();
-      void callManager.turnVideoOff();
-      void callManager.turnScreenshareOff();
-      void callManager.leave();
-    }
-  }, [extensions, roomId]);
-
-  const isJoined = callManager.joined && callManager.roomId === roomId;
-
-  return (
-    <StackItem.Content toolbar={!isJoined} classNames={isJoined && 'h-full'}>
-      {isJoined && !isNamed && <DisplayNameMissing />}
-      {isJoined && isNamed && (
-        <Call.Root>
-          <Call.Grid fullscreen={fullscreen} />
-          <Call.Toolbar channel={channel} onLeave={handleLeave} />
-        </Call.Root>
-      )}
-      {!isJoined && channel && channel.defaultThread.target && space && (
-        <>
-          <ChannelToolbar attendableId={fullyQualifiedId(channel)} role={role} onJoinCall={handleJoin} />
-          <ChatContainer space={space} thread={channel.defaultThread.target} />
-        </>
-      )}
-    </StackItem.Content>
-  );
-};
-
-export default ChannelContainer;
-
-const DisplayNameMissing = () => {
-  const { t } = useTranslation(meta.id);
-  const client = useClient();
-  const [displayName, setDisplayName] = useState('');
-  const handleChange = useCallback((event: ChangeEvent<HTMLInputElement>) => setDisplayName(event.target.value), []);
-  const handleSave = useCallback(() => client.halo.updateProfile({ displayName }), [client, displayName]);
-
-  return (
-    <ControlGroup classNames='p-4 place-content-center'>
-      <ControlItemInput title={t('display name label')} description={t('display name description')}>
-        <Input.TextInput
-          value={displayName}
-          onChange={handleChange}
-          placeholder={t('display name input placeholder')}
-          classNames='md:min-is-64'
-        />
-      </ControlItemInput>
-      <ControlGroupButton disabled={!displayName} onClick={handleSave}>
-        {t('set display name label')}
-      </ControlGroupButton>
-    </ControlGroup>
-  );
-};
-
-const useChannelToolbarActions = (onJoinCall?: () => void) => {
-  const creator = useMemo(
-    () =>
-      Rx.make(() => {
-        return {
-          nodes: [
-            createMenuItemGroup('root', {
-              label: ['channel toolbar title', { ns: meta.id }],
-            }),
-            createMenuAction('video-call', () => onJoinCall?.(), {
-              label: ['start video call label', { ns: meta.id }],
-              icon: 'ph--video-camera--regular',
-              type: 'video-call',
-            }),
-          ],
-          edges: [{ source: 'root', target: 'video-call' }],
-        };
-      }),
-    [],
-  );
-
-  return useMenuActions(creator);
-};
-
-type ChannelToolbarProps = ThemedClassName<{
-  attendableId?: string;
-  role?: string;
-  onJoinCall?: () => void;
-}>;
-
-const ChannelToolbar = ({ attendableId, role, onJoinCall, classNames }: ChannelToolbarProps) => {
-  const menuProps = useChannelToolbarActions(onJoinCall);
-
-  return (
-    <ElevationProvider elevation={role === 'section' ? 'positioned' : 'base'}>
-      <MenuProvider {...menuProps} attendableId={attendableId}>
-        <ToolbarMenu classNames={classNames} />
-      </MenuProvider>
-    </ElevationProvider>
-  );
-};

package/src/components/Chat.stories.tsx

@@ -1,89 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-import '@dxos-theme';
-
-import { type Meta } from '@storybook/react-vite';
-import React, { useEffect, useState } from 'react';
-
-import { Capabilities, IntentPlugin, contributes, createSurface } from '@dxos/app-framework';
-import { withPluginManager } from '@dxos/app-framework/testing';
-import { Obj, Ref } from '@dxos/echo';
-import { faker } from '@dxos/random';
-import { useClient } from '@dxos/react-client';
-import { type Space } from '@dxos/react-client/echo';
-import { useIdentity } from '@dxos/react-client/halo';
-import { withClientProvider } from '@dxos/react-client/testing';
-import { Thread } from '@dxos/react-ui-thread';
-import { DataType } from '@dxos/schema';
-import { withLayout, withTheme } from '@dxos/storybook-utils';
-
-import { translations } from '../translations';
-import { ChannelType, ThreadType } from '../types';
-
-import { ChatContainer } from './ChatContainer';
-
-faker.seed(1);
-
-const Story = () => {
-  const client = useClient();
-  const identity = useIdentity();
-  const [space, setSpace] = useState<Space>();
-  const [channel, setChannel] = useState<ChannelType | null>();
-
-  useEffect(() => {
-    if (identity) {
-      setTimeout(async () => {
-        const space = await client.spaces.create();
-        const channel = space.db.add(
-          Obj.make(ChannelType, {
-            defaultThread: Ref.make(Obj.make(ThreadType, { messages: [], status: 'active' })),
-            threads: [],
-          }),
-        );
-        setSpace(space);
-        setChannel(channel);
-      });
-    }
-  }, [identity]);
-
-  if (!identity || !channel || !space || !channel.defaultThread.target) {
-    return null;
-  }
-
-  return (
-    <main className='max-is-prose mli-auto bs-dvh overflow-hidden'>
-      <ChatContainer space={space} thread={channel.defaultThread.target} />
-    </main>
-  );
-};
-
-export const Default = {};
-
-const meta: Meta<typeof Thread.Root> = {
-  title: 'plugins/plugin-thread/Chat',
-  component: Thread.Root,
-  render: () => <Story />,
-  decorators: [
-    withPluginManager({
-      plugins: [IntentPlugin()],
-      capabilities: [
-        contributes(
-          Capabilities.ReactSurface,
-          createSurface({
-            id: 'test',
-            role: 'card',
-            component: ({ role }) => <span>{JSON.stringify({ role })}</span>,
-          }),
-        ),
-      ],
-    }),
-    withTheme,
-    withLayout({ fullscreen: true }),
-    withClientProvider({ createSpace: true, types: [ThreadType, DataType.Message] }),
-  ],
-  parameters: { translations },
-};
-
-export default meta;

package/src/components/ChatContainer.tsx

@@ -1,142 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-import React, { useLayoutEffect, useMemo, useRef, useState } from 'react';
-
-import { Obj, Ref } from '@dxos/echo';
-import { type Space, fullyQualifiedId, useMembers } from '@dxos/react-client/echo';
-import { useIdentity } from '@dxos/react-client/halo';
-import { Icon, ScrollArea, useThemeContext, useTranslation } from '@dxos/react-ui';
-import { createBasicExtensions, createThemeExtensions, listener } from '@dxos/react-ui-editor';
-import { StackItem } from '@dxos/react-ui-stack';
-import { mx } from '@dxos/react-ui-theme';
-import {
-  MessageTextbox,
-  type MessageTextboxProps,
-  Thread,
-  type ThreadRootProps,
-  threadLayout,
-} from '@dxos/react-ui-thread';
-import { DataType } from '@dxos/schema';
-import { isNonNullable } from '@dxos/util';
-
-import { useStatus } from '../hooks';
-import { meta } from '../meta';
-import { type ThreadType } from '../types';
-import { getMessageMetadata } from '../util';
-
-import { command } from './command-extension';
-import { MessageContainer } from './MessageContainer';
-
-export const ChatHeading = ({ attendableId }: { attendableId?: string }) => {
-  const { t } = useTranslation(meta.id);
-  return (
-    <div role='none' className='flex items-center'>
-      <StackItem.SigilButton attendableId={attendableId}>
-        <Icon icon='ph--chat--regular' size={5} />
-      </StackItem.SigilButton>
-      <StackItem.HeadingLabel attendableId={attendableId}>{t('chat heading')}</StackItem.HeadingLabel>
-    </div>
-  );
-};
-
-export type ChatContainerProps = {
-  space: Space;
-  thread: ThreadType;
-  context?: Obj.Any;
-  autoFocusTextbox?: boolean;
-} & Pick<ThreadRootProps, 'current'>;
-
-export const ChatContainer = ({ space, thread, context, current, autoFocusTextbox }: ChatContainerProps) => {
-  const { t } = useTranslation(meta.id);
-  const id = fullyQualifiedId(thread);
-  const identity = useIdentity()!;
-  const members = useMembers(space?.key);
-  const activity = useStatus(space, id);
-  // TODO(wittjosiah): This is a hack to reset the editor after a message is sent.
-  const [_count, _setCount] = useState(0);
-  const rerenderEditor = () => _setCount((count) => count + 1);
-  const [autoFocus, setAutoFocus] = useState(autoFocusTextbox);
-  const threadScrollRef = useRef<HTMLDivElement | null>(null);
-  const { themeMode } = useThemeContext();
-
-  const textboxMetadata = getMessageMetadata(id, identity);
-  const messageRef = useRef('');
-  const extensions = useMemo(
-    () => [
-      createBasicExtensions({ placeholder: t('message placeholder') }),
-      createThemeExtensions({ themeMode }),
-      listener({ onChange: (text) => (messageRef.current = text) }),
-      command,
-    ],
-    [themeMode, _count],
-  );
-
-  // TODO(thure): Factor out.
-  // TODO(thure): `flex-col-reverse` does not work to start the container scrolled to the end while also using
-  //  `ScrollArea`. This is the least-bad way I found to scroll to the end on mount. Note that 0ms was insufficient
-  //  for the desired effect; this is likely hardware-dependent and should be reevaluated.
-  const scrollToEnd = (behavior: ScrollBehavior) =>
-    setTimeout(() => threadScrollRef.current?.scrollIntoView({ behavior, block: 'end' }), 10);
-
-  useLayoutEffect(() => {
-    scrollToEnd('instant');
-  }, []);
-
-  // TODO(burdon): Change to model.
-  const handleCreate: MessageTextboxProps['onSend'] = () => {
-    if (!messageRef.current?.length) {
-      return false;
-    }
-
-    thread.messages.push(
-      Ref.make(
-        Obj.make(DataType.Message, {
-          created: new Date().toISOString(),
-          sender: { identityDid: identity.did },
-          blocks: [{ _tag: 'text', text: messageRef.current }],
-          properties: context ? { context: Ref.make(context) } : undefined,
-        }),
-      ),
-    );
-
-    messageRef.current = '';
-    setAutoFocus(true);
-    scrollToEnd('smooth');
-    rerenderEditor();
-    return true;
-  };
-
-  return (
-    <Thread.Root
-      current={current}
-      id={id}
-      classNames='bs-full grid-rows-[1fr_min-content_min-content] overflow-hidden transition-[padding-block-end] [[data-sidebar-inline-start-state=open]_&]:lg:pbe-0'
-    >
-      <ScrollArea.Root classNames='col-span-2'>
-        <ScrollArea.Viewport classNames='overflow-anchored after:overflow-anchor after:block after:bs-px after:-mbs-px [&>div]:min-bs-full [&>div]:!grid [&>div]:grid-rows-[1fr_0]'>
-          <div role='none' className={mx(threadLayout, 'place-self-end')}>
-            {thread.messages
-              .map((message) => message.target)
-              .filter(isNonNullable)
-              .map((message) => (
-                <MessageContainer key={message.id} message={message} members={members} />
-              ))}
-          </div>
-          {/* NOTE(thure): This can’t also be the `overflow-anchor` because `ScrollArea` injects an interceding node that contains this necessary ref’d element. */}
-          <div role='none' className='bs-px -mbs-px' ref={threadScrollRef} />
-          <ScrollArea.Scrollbar>
-            <ScrollArea.Thumb />
-          </ScrollArea.Scrollbar>
-        </ScrollArea.Viewport>
-      </ScrollArea.Root>
-
-      <MessageTextbox extensions={extensions} autoFocus={autoFocus} onSend={handleCreate} {...textboxMetadata} />
-
-      <Thread.Status activity={activity}>{t('activity message')}</Thread.Status>
-    </Thread.Root>
-  );
-};
-
-export default ChatContainer;

package/src/components/Comments.stories.tsx

@@ -1,93 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-import '@dxos-theme';
-
-import { type Meta } from '@storybook/react-vite';
-import React, { useEffect } from 'react';
-
-import { IntentPlugin } from '@dxos/app-framework';
-import { withPluginManager } from '@dxos/app-framework/testing';
-import { Obj, Query, Relation, Type } from '@dxos/echo';
-import { ClientPlugin } from '@dxos/plugin-client';
-import { faker } from '@dxos/random';
-import { useQuery, useSpace } from '@dxos/react-client/echo';
-import { useIdentity } from '@dxos/react-client/halo';
-import { AnchoredTo, DataType } from '@dxos/schema';
-import { layoutCentered, render, withLayout, withTheme } from '@dxos/storybook-utils';
-
-import { translations } from '../translations';
-import { ThreadType } from '../types';
-
-import { CommentsContainer } from './CommentsContainer';
-import { createCommentThread } from './testing';
-
-faker.seed(1);
-
-const DefaultStory = () => {
-  const identity = useIdentity();
-  const space = useSpace();
-  const anchors = useQuery(space, Query.type(AnchoredTo));
-
-  useEffect(() => {
-    if (identity && space) {
-      const t = setTimeout(async () => {
-        const object = space.db.add(Obj.make(Type.Expando, {}));
-        const thread1 = space.db.add(createCommentThread(identity));
-        const thread2 = space.db.add(createCommentThread(identity));
-        space.db.add(
-          Relation.make(AnchoredTo, {
-            [Relation.Source]: thread1,
-            [Relation.Target]: object,
-          }),
-        );
-        space.db.add(
-          Relation.make(AnchoredTo, {
-            [Relation.Source]: thread2,
-            [Relation.Target]: object,
-          }),
-        );
-      });
-
-      return () => clearTimeout(t);
-    }
-  }, [identity, space]);
-
-  if (!identity || !space || !anchors) {
-    return null;
-  }
-
-  return (
-    <div className='w-[30rem] overflow-y-auto bg-baseSurface'>
-      <CommentsContainer anchors={anchors} onThreadDelete={console.log} />
-    </div>
-  );
-};
-
-const meta: Meta = {
-  title: 'plugins/plugin-thread/Comments',
-  render: render(DefaultStory),
-  decorators: [
-    withTheme,
-    withLayout({ fullscreen: true, classNames: layoutCentered }),
-    withPluginManager({
-      plugins: [
-        IntentPlugin(),
-        ClientPlugin({
-          types: [DataType.Message, ThreadType, AnchoredTo],
-          onClientInitialized: async ({ client }) => {
-            await client.halo.createIdentity();
-          },
-        }),
-      ],
-    }),
-  ],
-  parameters: {
-    translations,
-  },
-};
-
-export default meta;
-
-export const Default = {};

package/src/components/CommentsContainer.tsx

@@ -1,72 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import React, { useEffect } from 'react';
-
-import { Relation } from '@dxos/echo';
-import { fullyQualifiedId } from '@dxos/react-client/echo';
-import { Callout, Icon, Trans, useTranslation } from '@dxos/react-ui';
-import { type AnchoredTo } from '@dxos/schema';
-
-import { meta } from '../meta';
-import { type ThreadType } from '../types';
-
-import { CommentsThreadContainer, type CommentsThreadContainerProps } from './CommentsThreadContainer';
-
-export type CommentsContainerProps = Omit<CommentsThreadContainerProps, 'anchor' | 'current'> & {
-  anchors: AnchoredTo[];
-  currentId?: string;
-  showResolvedThreads?: boolean;
-};
-
-/**
- * Root container for collection of comment threads.
- */
-export const CommentsContainer = ({ anchors, currentId, showResolvedThreads, ...props }: CommentsContainerProps) => {
-  const { t } = useTranslation(meta.id);
-
-  // TODO(wittjosiah): There seems to be a race between thread and anchor being deleted.
-  const filteredAnchors = showResolvedThreads
-    ? anchors.filter((anchor) => !!Relation.getSource(anchor))
-    : anchors.filter((anchor) => {
-        const thread = Relation.getSource(anchor);
-        return thread && thread.status !== 'resolved';
-      });
-
-  useEffect(() => {
-    if (currentId) {
-      document.getElementById(currentId)?.scrollIntoView({ behavior: 'smooth', block: 'end' });
-    }
-  }, [currentId]);
-
-  if (filteredAnchors.length === 0) {
-    return (
-      <div role='none' className='plb-cardSpacingBlock pli-cardSpacingInline'>
-        <Callout.Root>
-          <Callout.Title>
-            <Trans
-              {...{
-                t,
-                i18nKey: 'no comments message',
-                components: {
-                  commentIcon: <Icon icon='ph--chat-text--regular' size={4} classNames='inline-block' />,
-                },
-              }}
-            />
-          </Callout.Title>
-        </Callout.Root>
-      </div>
-    );
-  }
-
-  return (
-    <div>
-      {filteredAnchors.map((anchor) => {
-        const thread = Relation.getSource(anchor) as ThreadType;
-        const threadId = fullyQualifiedId(thread);
-        return <CommentsThreadContainer key={threadId} anchor={anchor} current={currentId === threadId} {...props} />;
-      })}
-    </div>
-  );
-};