@dxos/plugin-thread 0.8.3-staging.0fa589b → 0.8.4-main.28f8d3d

package/src/components/{CommentContainer.tsx → CommentsThreadContainer.tsx}

@@ -2,97 +2,39 @@
 // Copyright 2023 DXOS.org
 //
 
-import { CheckCircle, X } from '@phosphor-icons/react';
 import React, { useCallback, useMemo, useRef, useState } from 'react';
 
-import { Relation } from '@dxos/echo';
-import { RefArray } from '@dxos/live-object';
+import { Ref, Relation } from '@dxos/echo';
 import { fullyQualifiedId, getSpace, useMembers } from '@dxos/react-client/echo';
 import { useIdentity } from '@dxos/react-client/halo';
-import { Button, Tag, Tooltip, useThemeContext, useTranslation } from '@dxos/react-ui';
+import { IconButton, Tag, Tooltip, useThemeContext, useTranslation } from '@dxos/react-ui';
 import { createBasicExtensions, createThemeExtensions, listener } from '@dxos/react-ui-editor';
-import {
-  getSize,
-  hoverableControlItem,
-  hoverableControls,
-  hoverableFocusedWithinControls,
-  mx,
-} from '@dxos/react-ui-theme';
-import {
-  MessageTextbox,
-  type MessageTextboxProps,
-  Thread,
-  ThreadFooter,
-  ThreadHeading,
-  type ThreadProps,
-} from '@dxos/react-ui-thread';
+import { hoverableControlItem, hoverableControls, hoverableFocusedWithinControls, mx } from '@dxos/react-ui-theme';
+import { MessageTextbox, type MessageTextboxProps, Thread, type ThreadRootProps } from '@dxos/react-ui-thread';
 import { type AnchoredTo } from '@dxos/schema';
 import { isNonNullable } from '@dxos/util';
 
-import { MessageContainer } from './MessageContainer';
-import { command } from './command-extension';
 import { useStatus } from '../hooks';
-import { THREAD_PLUGIN } from '../meta';
+import { meta } from '../meta';
 import { type ThreadType } from '../types';
 import { getMessageMetadata } from '../util';
 
-const sizeClass = getSize(4);
-
-// TODO(thure): #8149
-const commentControlClassNames = '!p-1 !min-bs-0 transition-opacity';
-
-const ToggleResolvedButton = ({
-  isResolved,
-  onResolve,
-}: {
-  isResolved: boolean | undefined;
-  onResolve: () => void;
-}) => {
-  const { t } = useTranslation(THREAD_PLUGIN);
-  const label = t(isResolved ? 'mark as unresolved label' : 'mark as resolved label');
-  return (
-    <Tooltip.Trigger asChild content={label}>
-      <Button
-        variant='ghost'
-        data-testid='thread.toggle-resolved'
-        onClick={onResolve}
-        classNames={[commentControlClassNames, !isResolved && hoverableControlItem]}
-      >
-        <span className='sr-only'>{label}</span>
-        {isResolved ? <CheckCircle className={sizeClass} weight='fill' /> : <CheckCircle className={sizeClass} />}
-      </Button>
-    </Tooltip.Trigger>
-  );
-};
+import { command } from './command-extension';
+import { MessageContainer } from './MessageContainer';
 
-const DeleteThreadButton = ({ onDelete }: { onDelete: () => void }) => {
-  const { t } = useTranslation(THREAD_PLUGIN);
-  const label = t('delete thread label');
-  return (
-    <Tooltip.Trigger asChild content={label}>
-      <Button
-        variant='ghost'
-        data-testid='thread.delete'
-        onClick={onDelete}
-        classNames={[commentControlClassNames, hoverableControlItem]}
-      >
-        <span className='sr-only'>{label}</span>
-        <X className={sizeClass} />
-      </Button>
-    </Tooltip.Trigger>
-  );
-};
+// TODO(burdon): Remove need for p-1.
+export const commentControlClassNames = '!p-1 transition-opacity';
 
-export type CommentContainerProps = {
+export type CommentsThreadContainerProps = {
   anchor: AnchoredTo;
   onAttend?: (anchor: AnchoredTo) => void;
   onComment?: (anchor: AnchoredTo, message: string) => void;
   onResolve?: (anchor: AnchoredTo) => void;
   onMessageDelete?: (anchor: AnchoredTo, messageId: string) => void;
   onThreadDelete?: (anchor: AnchoredTo) => void;
-} & Pick<ThreadProps, 'current'>;
+} & Pick<ThreadRootProps, 'current'>;
 
-export const CommentContainer = ({
+export const CommentsThreadContainer = ({
   anchor,
   current,
   onAttend,
@@ -100,14 +42,14 @@ export const CommentContainer = ({
   onResolve,
   onMessageDelete,
   onThreadDelete,
-}: CommentContainerProps) => {
+}: CommentsThreadContainerProps) => {
+  const { t } = useTranslation(meta.id);
   const identity = useIdentity()!;
   const space = getSpace(anchor);
   const members = useMembers(space?.key);
   const detached = !anchor.anchor;
   const thread = Relation.getSource(anchor) as ThreadType;
   const activity = useStatus(space, fullyQualifiedId(thread));
-  const { t } = useTranslation(THREAD_PLUGIN);
   const threadScrollRef = useRef<HTMLDivElement | null>(null);
   const { themeMode } = useThemeContext();
 
@@ -149,7 +91,13 @@ export const CommentContainer = ({
   }, [anchor, identity]);
 
   return (
-    <Thread onClickCapture={handleAttend} onFocusCapture={handleAttend} current={current} id={fullyQualifiedId(thread)}>
+    <Thread.Root
+      id={fullyQualifiedId(thread)}
+      classNames='pbs-2 border-be border-subduedSeparator last:border-none'
+      current={current}
+      onClickCapture={handleAttend}
+      onFocusCapture={handleAttend}
+    >
       <div
         role='none'
         className={mx(
@@ -160,21 +108,40 @@ export const CommentContainer = ({
       >
         {detached ? (
           <Tooltip.Trigger asChild content={t('detached thread label')} side='top'>
-            <ThreadHeading detached>{thread.name}</ThreadHeading>
+            <Thread.Header detached>{thread.name}</Thread.Header>
           </Tooltip.Trigger>
         ) : (
-          <ThreadHeading>{thread.name}</ThreadHeading>
+          <Thread.Header>{thread.name}</Thread.Header>
         )}
-        <div className='flex flex-row items-center pli-1'>
+        <div className='flex flex-row items-center gap-0.5'>
           {thread.status === 'staged' && <Tag palette='neutral'>{t('draft button')}</Tag>}
           {onResolve && !(thread?.status === 'staged') && (
-            <ToggleResolvedButton isResolved={thread?.status === 'resolved'} onResolve={handleResolve} />
+            <IconButton
+              data-testid='thread.resolve'
+              variant='ghost'
+              icon={thread?.status === 'resolved' ? 'ph--check--fill' : 'ph--check--regular'}
+              iconOnly
+              label={t('resolve thread label')}
+              classNames={[commentControlClassNames, thread?.status !== 'resolved' && hoverableControlItem]}
+              onClick={handleResolve}
+            />
+          )}
+          {onThreadDelete && (
+            <IconButton
+              data-testid='thread.delete'
+              variant='ghost'
+              icon='ph--x--regular'
+              iconOnly
+              label={t('delete thread label')}
+              classNames={[commentControlClassNames, hoverableControlItem]}
+              onClick={handleThreadDelete}
+            />
           )}
-          {onThreadDelete && <DeleteThreadButton onDelete={handleThreadDelete} />}
         </div>
       </div>
+
       {/** TODO(dmaretskyi): How's `thread.messages` undefined? */}
-      {RefArray.targets(thread.messages?.filter(isNonNullable) ?? []).map((message) => (
+      {Ref.Array.targets(thread.messages?.filter(isNonNullable) ?? []).map((message) => (
         <MessageContainer
           key={message.id}
           editable
@@ -183,6 +150,7 @@ export const CommentContainer = ({
           onDelete={handleMessageDelete}
         />
       ))}
+
       {/*
         TODO(wittjosiah): Can't autofocus this generally.
           There can be multiple threads with inputs and they can't all be focused.
@@ -190,9 +158,11 @@ export const CommentContainer = ({
           Need to find a way to autofocus in one scenario only: when a new thread is created.
       */}
       <MessageTextbox extensions={extensions} onSend={handleComment} {...textboxMetadata} />
-      <ThreadFooter activity={activity}>{t('activity message')}</ThreadFooter>
+
+      <Thread.Status activity={activity}>{t('activity message')}</Thread.Status>
+
       {/* 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} />
-    </Thread>
+    </Thread.Root>
   );
 };

package/src/components/Lobby/Lobby.tsx

@@ -5,7 +5,7 @@
 import React, { type FC, type PropsWithChildren, useEffect, useState } from 'react';
 
 import { useCapability } from '@dxos/app-framework';
-import { useTranslation, type ThemedClassName } from '@dxos/react-ui';
+import { type ThemedClassName, useTranslation } from '@dxos/react-ui';
 import { mx } from '@dxos/react-ui-theme';
 
 import { ThreadCapabilities } from '../../capabilities';

package/src/components/Media/VideoObject.stories.tsx

@@ -4,18 +4,19 @@
 
 import '@dxos-theme';
 
-import { type StoryObj, type Meta } from '@storybook/react';
+import { type Meta, type StoryObj } from '@storybook/react-vite';
 import React, { useEffect, useState } from 'react';
 
 import { scheduleTask } from '@dxos/async';
 import { Context } from '@dxos/context';
 import { log } from '@dxos/log';
-import { withTheme, withLayout } from '@dxos/storybook-utils';
+import { withLayout, withTheme } from '@dxos/storybook-utils';
 
-import { VideoObject } from './VideoObject';
 import { getUserMediaTrack } from '../../calls';
 import { ResponsiveContainer } from '../ResponsiveGrid';
 
+import { VideoObject } from './VideoObject';
+
 const meta: Meta<typeof VideoObject> = {
   title: 'plugins/plugin-thread/VideoObject',
   component: VideoObject,

package/src/components/MessageContainer.tsx

@@ -3,34 +3,25 @@
 //
 
 import { EditorView } from '@codemirror/view';
-import { Check, PencilSimple, X } from '@phosphor-icons/react';
 import React, { forwardRef, useCallback, useEffect, useRef, useState } from 'react';
 
 import { Surface } from '@dxos/app-framework';
-import { type Obj, type Type } from '@dxos/echo';
-import { RefArray } from '@dxos/live-object';
+import { type Obj, Ref, type Type } from '@dxos/echo';
 import { PublicKey } from '@dxos/react-client';
 import { type SpaceMember } from '@dxos/react-client/echo';
-import { useIdentity, type Identity } from '@dxos/react-client/halo';
-import { Button, ButtonGroup, Tooltip, useOnTransition, useThemeContext, useTranslation } from '@dxos/react-ui';
+import { type Identity, useIdentity } from '@dxos/react-client/halo';
+import { IconButton, useOnTransition, useThemeContext, useTranslation } from '@dxos/react-ui';
 import { createBasicExtensions, createThemeExtensions, useTextEditor } from '@dxos/react-ui-editor';
-import {
-  getSize,
-  hoverableControlItem,
-  hoverableControls,
-  hoverableFocusedWithinControls,
-  mx,
-} from '@dxos/react-ui-theme';
+import { hoverableControlItem, hoverableControls, hoverableFocusedWithinControls, mx } from '@dxos/react-ui-theme';
 import { MessageHeading, MessageRoot } from '@dxos/react-ui-thread';
 import { type DataType } from '@dxos/schema';
 
-import { command } from './command-extension';
 import { useOnEditAnalytics } from '../hooks';
-import { THREAD_PLUGIN } from '../meta';
+import { meta } from '../meta';
 import { getMessageMetadata } from '../util';
 
-// TODO(thure): #8149
-const messageControlClassNames = ['!p-1 !min-bs-0 transition-opacity', hoverableControlItem];
+import { command } from './command-extension';
+import { commentControlClassNames } from './CommentsThreadContainer';
 
 export type MessageContainerProps = {
   message: DataType.Message;
@@ -40,6 +31,7 @@ export type MessageContainerProps = {
 };
 
 export const MessageContainer = ({ message, members, editable = false, onDelete }: MessageContainerProps) => {
+  const { t } = useTranslation(meta.id);
   const senderIdentity = members.find(
     (member) =>
       (message.sender.identityDid && member.identity.did === message.sender.identityDid) ||
@@ -49,48 +41,41 @@ export const MessageContainer = ({ message, members, editable = false, onDelete
   const userIsAuthor = useIdentity()?.did === messageMetadata.authorId;
   const [editing, setEditing] = useState(false);
   const handleDelete = useCallback(() => onDelete?.(message.id), [message, onDelete]);
-  const { t } = useTranslation(THREAD_PLUGIN);
-  const editLabel = t(editing ? 'save message label' : 'edit message label');
-  const deleteLabel = t('delete message label');
-  const textBlock = message.blocks.find((block) => block.type === 'text');
-  const references = message.blocks.filter((block) => block.type === 'reference').map((block) => block.reference);
+  const textBlock = message.blocks.find((block) => block._tag === 'text');
+  const references = message.blocks.filter((block) => block._tag === 'reference').map((block) => block.reference);
 
   useOnEditAnalytics(message, textBlock, !!editing);
 
   return (
     <MessageRoot {...messageMetadata} classNames={[hoverableControls, hoverableFocusedWithinControls]}>
       <MessageHeading authorName={messageMetadata.authorName} timestamp={messageMetadata.timestamp}>
-        <ButtonGroup classNames='mie-1'>
+        <div className='flex flex-row items-center gap-0.5'>
           {userIsAuthor && editable && (
-            <Tooltip.Trigger asChild content={editLabel}>
-              <Button
-                variant='ghost'
-                data-testid={editing ? 'thread.message.save' : 'thread.message.edit'}
-                classNames={messageControlClassNames}
-                onClick={() => setEditing((editing) => !editing)}
-              >
-                <span className='sr-only'>{editLabel}</span>
-                {editing ? <Check className={getSize(4)} /> : <PencilSimple className={getSize(4)} />}
-              </Button>
-            </Tooltip.Trigger>
+            <IconButton
+              data-testid={editing ? 'thread.message.save' : 'thread.message.edit'}
+              variant='ghost'
+              icon={editing ? 'ph--check--regular' : 'ph--pencil-simple--regular'}
+              iconOnly
+              label={t(editing ? 'save message label' : 'edit message label')}
+              classNames={[commentControlClassNames, hoverableControlItem]}
+              onClick={() => setEditing((editing) => !editing)}
+            />
           )}
           {onDelete && (
-            <Tooltip.Trigger asChild content={deleteLabel}>
-              <Button
-                variant='ghost'
-                data-testid='thread.message.delete'
-                classNames={messageControlClassNames}
-                onClick={() => handleDelete()}
-              >
-                <span className='sr-only'>{deleteLabel}</span>
-                <X className={getSize(4)} />
-              </Button>
-            </Tooltip.Trigger>
+            <IconButton
+              data-testid='thread.message.delete'
+              variant='ghost'
+              icon='ph--x--regular'
+              iconOnly
+              label={t('delete message label')}
+              classNames={[commentControlClassNames, hoverableControlItem]}
+              onClick={() => handleDelete()}
+            />
           )}
-        </ButtonGroup>
+        </div>
       </MessageHeading>
       {textBlock && <TextboxBlock block={textBlock} isAuthor={userIsAuthor} editing={editing} />}
-      {RefArray.targets(references).map((reference, index) => (
+      {Ref.Array.targets(references).map((reference, index) => (
         <MessagePart key={index} part={reference} />
       ))}
     </MessageRoot>

package/src/components/Participant/ParticipantGrid.tsx

@@ -6,10 +6,11 @@ import React, { useEffect, useMemo, useState } from 'react';
 
 import { type ThemedClassName } from '@dxos/react-ui';
 
-import { Participant, SCREENSHARE_SUFFIX } from './Participant';
 import { type UserState } from '../../calls';
 import { ResponsiveGrid } from '../ResponsiveGrid';
 
+import { Participant, SCREENSHARE_SUFFIX } from './Participant';
+
 const getId = (user: UserState): string => user.id!;
 
 export type ParticipantGridProps = ThemedClassName<{

package/src/components/ResponsiveGrid/ResponsiveContainer.stories.tsx

@@ -4,15 +4,16 @@
 
 import '@dxos-theme';
 
-import { type StoryObj, type Meta } from '@storybook/react';
+import { type Meta, type StoryObj } from '@storybook/react-vite';
 import React from 'react';
 
-import { withTheme, withLayout } from '@dxos/storybook-utils';
+import { withLayout, withTheme } from '@dxos/storybook-utils';
 
-import { ResponsiveContainer } from './ResponsiveContainer';
-import translations from '../../translations';
+import { translations } from '../../translations';
 import { VideoObject as VideoObjectComponent } from '../Media';
 
+import { ResponsiveContainer } from './ResponsiveContainer';
+
 const meta: Meta<typeof ResponsiveContainer> = {
   title: 'plugins/plugin-thread/ResponsiveContainer',
   component: ResponsiveContainer,

package/src/components/ResponsiveGrid/ResponsiveGrid.stories.tsx

@@ -4,15 +4,16 @@
 
 import '@dxos-theme';
 
-import { type StoryObj, type Meta } from '@storybook/react';
+import { type Meta, type StoryObj } from '@storybook/react-vite';
 import React, { useEffect, useState } from 'react';
 
 import { faker } from '@dxos/random';
-import { withTheme, withLayout } from '@dxos/storybook-utils';
+import { withLayout, withTheme } from '@dxos/storybook-utils';
+
+import { translations } from '../../translations';
 
 import { ResponsiveGrid, type ResponsiveGridProps } from './ResponsiveGrid';
 import { ResponsiveGridItem, type ResponsiveGridItemProps } from './ResponsiveGridItem';
-import translations from '../../translations';
 
 type TestItem = {
   id: string;
@@ -61,7 +62,7 @@ const meta: Meta<StoryProps> = {
   component: ResponsiveGrid,
   render: (args) => {
     const [pinned, setPinned] = useState<string | undefined>(
-      args.pinned ?? args.items.length > 1 ? args.items[0]?.id : undefined,
+      (args.pinned ?? args.items.length > 1) ? args.items[0]?.id : undefined,
     );
     const [items, setItems] = useState<TestItem[]>(args.items);
     useEffect(() => {

package/src/components/ResponsiveGrid/ResponsiveGrid.tsx

@@ -2,7 +2,7 @@
 // Copyright 2025 DXOS.org
 //
 
-import React, { type ComponentType, type FC, useLayoutEffect, useState, useEffect, useMemo, useCallback } from 'react';
+import React, { type ComponentType, type FC, useCallback, useEffect, useLayoutEffect, useMemo, useState } from 'react';
 import { useResizeDetector } from 'react-resize-detector';
 
 import { invariant } from '@dxos/invariant';

package/src/components/ResponsiveGrid/ResponsiveGridItem.tsx

@@ -2,13 +2,13 @@
 // Copyright 2025 DXOS.org
 //
 
-import React, { useEffect, useState, type CSSProperties, type PropsWithChildren } from 'react';
+import React, { type CSSProperties, type PropsWithChildren, useEffect, useState } from 'react';
 
-import { Icon, IconButton, useTranslation, type ThemedClassName } from '@dxos/react-ui';
+import { Icon, IconButton, type ThemedClassName, useTranslation } from '@dxos/react-ui';
 import { Waveform } from '@dxos/react-ui-sfx';
 import { groupHoverControlItemWithTransition, mx } from '@dxos/react-ui-theme';
 
-import { THREAD_PLUGIN } from '../../meta';
+import { meta } from '../../meta';
 
 export type ResponsiveGridItemProps<T extends object = any> = PropsWithChildren<
   ThemedClassName<{
@@ -45,7 +45,7 @@ export const ResponsiveGridItem = <T extends object = any>({
   speaking,
   onClick,
 }: ResponsiveGridItemProps<T>) => {
-  const { t } = useTranslation(THREAD_PLUGIN);
+  const { t } = useTranslation(meta.id);
   const iconProps: Record<string, { icon: string; label: string; classNames?: string }> = {
     wave: {
       icon: 'ph--hand-waving--duotone',

package/src/components/ThreadComplementary.tsx

@@ -8,8 +8,8 @@ import {
   Capabilities,
   LayoutAction,
   createIntent,
-  useCapability,
   useCapabilities,
+  useCapability,
   useIntentDispatcher,
 } from '@dxos/app-framework';
 import { Filter, Obj, Query, Relation } from '@dxos/echo';
@@ -23,13 +23,13 @@ import { AnchoredTo } from '@dxos/schema';
 
 import { ThreadCapabilities } from '../capabilities';
 import { CommentsContainer } from '../components';
-import { THREAD_PLUGIN } from '../meta';
+import { meta } from '../meta';
 import { ThreadAction, ThreadType } from '../types';
 
 export const ThreadComplementary = ({ subject }: { subject: any }) => {
+  const { t } = useTranslation(meta.id);
   const { dispatchPromise: dispatch } = useIntentDispatcher();
   const identity = useIdentity();
-  const { t } = useTranslation(THREAD_PLUGIN);
   const { tx } = useThemeContext();
   const subjectId = fullyQualifiedId(subject);
 

package/src/components/ThreadSettings.tsx

@@ -7,11 +7,11 @@ import React from 'react';
 // import { useTranslation } from '@dxos/react-ui';
 import { DeprecatedFormContainer } from '@dxos/react-ui-form';
 
-// import { THREAD_PLUGIN } from '../meta';
+// import { meta } from '../meta';
 import type { ThreadSettingsProps } from '../types';
 
 export const ThreadSettings = ({ settings }: { settings: ThreadSettingsProps }) => {
-  // const { t } = useTranslation(THREAD_PLUGIN);
+  // const { t } = useTranslation(meta.id);
 
   return <DeprecatedFormContainer></DeprecatedFormContainer>;
 };

package/src/components/command-extension.ts

@@ -2,7 +2,7 @@
 // Copyright 2024 DXOS.org
 //
 
-import { StreamLanguage, HighlightStyle, syntaxHighlighting } from '@codemirror/language';
+import { HighlightStyle, StreamLanguage, syntaxHighlighting } from '@codemirror/language';
 import { type Extension } from '@codemirror/state';
 
 import { tags } from '@dxos/react-ui-editor';

package/src/components/index.ts

@@ -11,8 +11,8 @@ export const ChatContainer = lazy(() => import('./ChatContainer'));
 export * from './Call';
 export * from './CallDebugPanel';
 export * from './CallSidebar';
-export * from './CommentContainer';
 export * from './CommentsContainer';
+export * from './CommentsThreadContainer';
 export * from './MessageContainer';
 export * from './ThreadComplementary';
 export * from './ThreadSettings';

package/src/components/testing.ts

@@ -16,11 +16,11 @@ export const createCommentThread = (identity: Identity): ThreadType => {
       () =>
         Ref.make(
           Obj.make(DataType.Message, {
+            created: new Date().toISOString(),
             sender: {
               identityDid: faker.datatype.boolean() ? identity.did : IdentityDid.random(),
             },
-            created: new Date().toISOString(),
-            blocks: [{ type: 'text', text: faker.lorem.sentences(3) }],
+            blocks: [{ _tag: 'text', text: faker.lorem.sentences(3) }],
           }),
         ),
       { count: { min: 2, max: 3 } },

package/src/extensions/threads.ts

@@ -6,17 +6,17 @@ import { type Extension } from '@codemirror/state';
 import { EditorView } from '@codemirror/view';
 import { computed, effect } from '@preact/signals-core';
 
-import { createIntent, type PromiseIntentDispatcher } from '@dxos/app-framework';
+import { type PromiseIntentDispatcher, createIntent } from '@dxos/app-framework';
 import { Filter, Obj, Query, Relation } from '@dxos/echo';
-import { type DocumentType } from '@dxos/plugin-markdown/types';
-import { getSpace, getTextInRange, createDocAccessor, fullyQualifiedId, getSource } from '@dxos/react-client/echo';
+import { type Markdown } from '@dxos/plugin-markdown/types';
+import { createDocAccessor, fullyQualifiedId, getSource, getSpace, getTextInRange } from '@dxos/react-client/echo';
 import { comments, createExternalCommentSync } from '@dxos/react-ui-editor';
 import { AnchoredTo } from '@dxos/schema';
 
-import { ThreadAction, ThreadType, type ThreadState } from '../types';
+import { ThreadAction, type ThreadState, ThreadType } from '../types';
 
 // TODO(burdon): Factor out.
-const getName = (doc: DocumentType, anchor: string): string | undefined => {
+const getName = (doc: Markdown.Document, anchor: string): string | undefined => {
   if (doc.content) {
     const [start, end] = anchor.split(':');
     return getTextInRange(createDocAccessor(doc.content.target!, ['content']), start, end);
@@ -26,7 +26,7 @@ const getName = (doc: DocumentType, anchor: string): string | undefined => {
 /**
  * Construct plugins.
  */
-export const threads = (state: ThreadState, doc?: DocumentType, dispatch?: PromiseIntentDispatcher): Extension => {
+export const threads = (state: ThreadState, doc?: Markdown.Document, dispatch?: PromiseIntentDispatcher): Extension => {
   const space = doc && getSpace(doc);
   if (!doc || !space || !dispatch) {
     // Include no-op comments extension here to ensure that the facets are always present when they are expected.

package/src/hooks/index.ts

@@ -5,3 +5,5 @@
 export * from './analytics';
 export * from './useDebugMode';
 export * from './useStatus';
+export * from './useVideoStreamTrack';
+export * from './useInaudibleAudioStreamTrack';

package/src/hooks/useDebugMode.ts

@@ -2,7 +2,7 @@
 // Copyright 2025 DXOS.org
 //
 
-import { useState, useEffect } from 'react';
+import { useEffect, useState } from 'react';
 
 // TODO(burdon): Standardize across plugins/composer.
 export const useDebugMode = () => {

package/src/hooks/useInaudibleAudioStreamTrack.tsx

@@ -0,0 +1,27 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { useEffect, useState } from 'react';
+
+import { scheduleTask } from '@dxos/async';
+import { Context } from '@dxos/context';
+
+import { createInaudibleAudioStreamTrack } from '../calls/util/stub-media-streams';
+
+export const useInaudibleAudioStreamTrack = () => {
+  const [audioStreamTrack, setAudioStreamTrack] = useState<MediaStreamTrack | undefined>(undefined);
+  useEffect(() => {
+    const ctx = new Context();
+    scheduleTask(ctx, async () => {
+      const audioStreamTrack = await createInaudibleAudioStreamTrack({ ctx });
+      setAudioStreamTrack(audioStreamTrack);
+    });
+
+    return () => {
+      void ctx.dispose();
+    };
+  }, []);
+
+  return audioStreamTrack;
+};