@dxos/plugin-status-bar 0.8.4-main.9735255 → 0.8.4-main.9be5663bfe

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-status-bar",
-  "version": "0.8.4-main.9735255",
+  "version": "0.8.4-main.9be5663bfe",
   "description": "Status bar plugin",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -12,6 +12,12 @@
   "author": "DXOS.org",
   "sideEffects": true,
   "type": "module",
+  "imports": {
+    "#capabilities": "./src/capabilities/index.ts",
+    "#components": "./src/components/index.ts",
+    "#containers": "./src/containers/index.ts",
+    "#meta": "./src/meta.ts"
+  },
   "exports": {
     ".": {
       "source": "./src/index.ts",
@@ -31,35 +37,36 @@
   "dependencies": {
     "@fluentui/react-tabster": "9.26.11",
     "@radix-ui/react-slot": "1.1.2",
-    "date-fns": "^3.3.1",
-    "effect": "3.19.11",
+    "date-fns": "^3.6.0",
+    "effect": "3.20.0",
     "react-resize-detector": "^11.0.1",
-    "@dxos/async": "0.8.4-main.9735255",
-    "@dxos/echo": "0.8.4-main.9735255",
-    "@dxos/operation": "0.8.4-main.9735255",
-    "@dxos/app-framework": "0.8.4-main.9735255",
-    "@dxos/plugin-observability": "0.8.4-main.9735255",
-    "@dxos/react-client": "0.8.4-main.9735255",
-    "@dxos/react-ui-form": "0.8.4-main.9735255",
-    "@dxos/schema": "0.8.4-main.9735255",
-    "@dxos/util": "0.8.4-main.9735255"
+    "@dxos/app-framework": "0.8.4-main.9be5663bfe",
+    "@dxos/app-toolkit": "0.8.4-main.9be5663bfe",
+    "@dxos/echo": "0.8.4-main.9be5663bfe",
+    "@dxos/operation": "0.8.4-main.9be5663bfe",
+    "@dxos/react-client": "0.8.4-main.9be5663bfe",
+    "@dxos/plugin-observability": "0.8.4-main.9be5663bfe",
+    "@dxos/react-ui-form": "0.8.4-main.9be5663bfe",
+    "@dxos/util": "0.8.4-main.9be5663bfe",
+    "@dxos/async": "0.8.4-main.9be5663bfe",
+    "@dxos/schema": "0.8.4-main.9be5663bfe"
   },
   "devDependencies": {
     "@types/react": "~19.2.7",
     "@types/react-dom": "~19.2.3",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "vite": "7.1.9",
-    "@dxos/react-ui": "0.8.4-main.9735255",
-    "@dxos/storybook-utils": "0.8.4-main.9735255",
-    "@dxos/ui-theme": "0.8.4-main.9735255"
+    "vite": "^7.1.11",
+    "@dxos/react-ui": "0.8.4-main.9be5663bfe",
+    "@dxos/storybook-utils": "0.8.4-main.9be5663bfe",
+    "@dxos/ui-theme": "0.8.4-main.9be5663bfe"
   },
   "peerDependencies": {
-    "effect": "3.19.11",
+    "effect": "3.20.0",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "@dxos/react-ui": "0.8.4-main.9735255",
-    "@dxos/ui-theme": "0.8.4-main.9735255"
+    "@dxos/ui-theme": "0.8.4-main.9be5663bfe",
+    "@dxos/react-ui": "0.8.4-main.9be5663bfe"
   },
   "publishConfig": {
     "access": "public"

package/src/StatusBarPlugin.ts

@@ -2,14 +2,16 @@
 // Copyright 2024 DXOS.org
 //
 
-import { Common, Plugin } from '@dxos/app-framework';
+import { Plugin } from '@dxos/app-framework';
+import { AppPlugin } from '@dxos/app-toolkit';
+
+import { ReactSurface } from '#capabilities';
+import { meta } from '#meta';
 
-import { ReactSurface } from './capabilities';
-import { meta } from './meta';
 import { translations } from './translations';
 
 export const StatusBarPlugin = Plugin.define(meta).pipe(
-  Common.Plugin.addTranslationsModule({ translations }),
-  Common.Plugin.addSurfaceModule({ activate: ReactSurface }),
+  AppPlugin.addSurfaceModule({ activate: ReactSurface }),
+  AppPlugin.addTranslationsModule({ translations }),
   Plugin.make,
 );

package/src/capabilities/index.ts

@@ -2,4 +2,6 @@
 // Copyright 2025 DXOS.org
 //
 
-export * from './react-surface';
+import { Capability } from '@dxos/app-framework';
+
+export const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));

package/src/capabilities/react-surface.tsx

@@ -0,0 +1,33 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+import React from 'react';
+
+import { Capabilities, Capability } from '@dxos/app-framework';
+import { Surface } from '@dxos/app-framework/ui';
+
+import { StatusBarActions, StatusBarPanel, VersionNumber } from '#containers';
+
+export default Capability.makeModule(() =>
+  Effect.succeed(
+    Capability.contributes(Capabilities.ReactSurface, [
+      Surface.create({
+        id: 'status-bar',
+        role: 'status-bar',
+        component: () => <StatusBarPanel />,
+      }),
+      Surface.create({
+        id: 'status-bar--r1-footer',
+        role: 'status-bar--r1-footer',
+        component: () => <StatusBarActions />,
+      }),
+      Surface.create({
+        id: 'version-info',
+        role: 'version-info',
+        component: () => <VersionNumber />,
+      }),
+    ]),
+  ),
+);

package/src/components/StatusBar/StatusBar.stories.tsx

@@ -0,0 +1,45 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { type Meta, type StoryObj } from '@storybook/react-vite';
+import React from 'react';
+
+import { Icon, IconButton } from '@dxos/react-ui';
+import { withTheme } from '@dxos/react-ui/testing';
+
+import { StatusBar } from './index';
+
+const DefaultStory = () => (
+  <StatusBar.EndContent>
+    <StatusBar.Button>
+      <Icon icon='ph--mailbox--regular' />
+      <StatusBar.Text>Quick feedback</StatusBar.Text>
+    </StatusBar.Button>
+    <a href='https://dxos.org/discord' target='_blank' rel='noopener noreferrer'>
+      <StatusBar.Button>
+        <Icon icon='ph--discord-logo--regular' />
+        <StatusBar.Text>Join us on Discord</StatusBar.Text>
+      </StatusBar.Button>
+    </a>
+    <StatusBar.Item>
+      <IconButton variant='ghost' icon='ph--lightning--regular' iconOnly label='Online' />
+    </StatusBar.Item>
+  </StatusBar.EndContent>
+);
+
+const meta = {
+  title: 'plugins/plugin-status-bar/components/StatusBar',
+  component: StatusBar as any,
+  render: DefaultStory,
+  decorators: [withTheme()],
+  parameters: {
+    layout: 'centered',
+  },
+} satisfies Meta<typeof StatusBar>;
+
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};

package/src/components/{StatusBar.tsx → StatusBar/StatusBar.tsx}

@@ -8,6 +8,26 @@ import React, { type ComponentPropsWithRef, type PropsWithChildren, type ReactNo
 import { type ThemedClassName } from '@dxos/react-ui';
 import { mx } from '@dxos/ui-theme';
 
+//
+// Item
+//
+
+type StatusBarItemProps = ThemedClassName<PropsWithChildren>;
+
+const StatusBarItem = forwardRef<HTMLDivElement, StatusBarItemProps>(
+  ({ classNames, children, ...props }, forwardedRef) => {
+    return (
+      <div {...props} role='status' className={mx('grid place-items-center', classNames)} ref={forwardedRef}>
+        {children}
+      </div>
+    );
+  },
+);
+
+//
+// Text
+//
+
 type StatusBarTextProps = ThemedClassName<{ children: ReactNode }>;
 
 const StatusBarText = forwardRef<HTMLSpanElement, StatusBarTextProps>(({ classNames, children }, forwardedRef) => (
@@ -16,14 +36,21 @@ const StatusBarText = forwardRef<HTMLSpanElement, StatusBarTextProps>(({ classNa
   </span>
 ));
 
+//
+// Button
+//
+
 type StatusBarButtonProps = ThemedClassName<ComponentPropsWithRef<'button'> & { asChild?: boolean }>;
 
+/**
+ * @deprecated
+ */
 const StatusBarButton = forwardRef<HTMLButtonElement, StatusBarButtonProps>(
   ({ classNames, children, asChild, ...props }, forwardedRef) => {
     const classes = mx(
-      'flex items-center justify-center gap-2 p-1 pli-2 rounded-sm',
+      'flex items-center justify-center gap-2 p-1 px-2 rounded-xs',
       'select-none cursor-pointer dx-focus-ring text-description text-xs',
-      'hover:bg-neutral-75 active:bg-neutral-150 dark:hover:bg-neutral-750 dark:active:bg-neutral-700',
+      'hover:bg-neutral-100 active:bg-neutral-200 dark:hover:bg-neutral-700 dark:active:bg-neutral-600',
       classNames,
     );
 
@@ -39,22 +66,9 @@ const StatusBarButton = forwardRef<HTMLButtonElement, StatusBarButtonProps>(
   },
 );
 
-export default StatusBarButton;
-
-type StatusBarItemProps = ThemedClassName<ComponentPropsWithRef<'div'>>;
-
-const StatusBarItem = forwardRef<HTMLDivElement, StatusBarItemProps>(
-  ({ classNames, children, ...props }, forwardedRef) => (
-    <div
-      role='menuitem'
-      className={mx('flex items-center justify-center gap-2 p-1 pli-2 rounded-sm select-none', classNames)}
-      ref={forwardedRef}
-      {...props}
-    >
-      {children}
-    </div>
-  ),
-);
+//
+// Content
+//
 
 type StartContentProps = ThemedClassName<PropsWithChildren<{}>>;
 
@@ -64,6 +78,10 @@ const StartContent = forwardRef<HTMLDivElement, StartContentProps>(({ classNames
   </div>
 ));
 
+//
+// EndContent
+//
+
 type EndContentProps = ThemedClassName<PropsWithChildren<{}>>;
 
 const EndContent = forwardRef<HTMLDivElement, EndContentProps>(({ classNames, children }, forwardedRef) => (
@@ -72,9 +90,13 @@ const EndContent = forwardRef<HTMLDivElement, EndContentProps>(({ classNames, ch
   </div>
 ));
 
+//
+// StatusBar
+//
+
 export const StatusBar = {
-  Text: StatusBarText,
   Item: StatusBarItem,
+  Text: StatusBarText,
   Button: StatusBarButton,
   StartContent,
   EndContent,

package/src/components/StatusBar/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+export * from './StatusBar';

package/src/components/index.ts

@@ -3,5 +3,3 @@
 //
 
 export * from './StatusBar';
-export * from './StatusBarPanel';
-export * from './VersionNumber';

package/src/containers/StatusBarActions/StatusBarActions.stories.tsx

@@ -0,0 +1,61 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { type Meta, type StoryObj } from '@storybook/react-vite';
+
+import { Config } from '@dxos/react-client';
+import { withClientProvider } from '@dxos/react-client/testing';
+import { withLayout, withTheme } from '@dxos/react-ui/testing';
+
+import { translations } from '../../translations';
+import { StatusBarActions } from './StatusBarActions';
+
+const meta: Meta<typeof StatusBarActions> = {
+  title: 'plugins/plugin-status-bar/containers/StatusBarActions',
+  component: StatusBarActions,
+  decorators: [
+    withTheme(),
+    withLayout({
+      layout: 'centered',
+      classNames: 'w-[calc(var(--dx-complementary-sidebar-size)_-_var(--dx-rail-content))]',
+    }),
+    withClientProvider({
+      config: new Config({
+        version: 1,
+        runtime: {
+          client: {
+            storage: {
+              persistent: false,
+            },
+          },
+          app: {
+            build: {
+              version: '0.8.3-beta.b78990fdd5',
+              timestamp: '2024-06-01T12:00:00.000Z',
+              commitHash: 'b78990fdd5',
+            },
+            env: {
+              DX_ENVIRONMENT: 'development',
+            },
+          },
+          services: {
+            edge: {
+              url: 'https://edge-dev.dxos.org',
+            },
+          },
+        },
+      }),
+    }),
+  ],
+  parameters: {
+    layout: 'centered',
+    translations,
+  },
+};
+
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};

package/src/containers/StatusBarActions/StatusBarActions.tsx

@@ -0,0 +1,70 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import React, { useState } from 'react';
+
+import { useConfig } from '@dxos/react-client';
+import { Icon, Popover, useTranslation } from '@dxos/react-ui';
+
+import { StatusBar } from '#components';
+import { meta } from '#meta';
+
+import VersionNumber from '../VersionNumber';
+
+export type StatusBarActionsProps = {};
+
+export const StatusBarActions = (_props: StatusBarActionsProps) => {
+  const { t } = useTranslation(meta.id);
+  const [open, setOpen] = useState(false);
+
+  return (
+    <Popover.Root open={open} onOpenChange={setOpen}>
+      <div role='none' className='h-full flex items-center px-2 gap-2'>
+        <EnvironmentLabel />
+        <VersionNumber />
+        <div role='none' className='grow' />
+        <StatusBar.Button asChild>
+          <a href='https://dxos.org/discord' target='_blank' rel='noopener noreferrer'>
+            <Icon icon='ph--discord-logo--regular' />
+            <StatusBar.Text classNames='hidden sm:block'>{t('discord.label')}</StatusBar.Text>
+          </a>
+        </StatusBar.Button>
+        <StatusBar.Button asChild>
+          <a href='https://github.com/dxos/dxos' target='_blank' rel='noopener noreferrer'>
+            <Icon icon='ph--github-logo--regular' />
+            <StatusBar.Text classNames='hidden sm:block'>{t('github.label')}</StatusBar.Text>
+          </a>
+        </StatusBar.Button>
+      </div>
+    </Popover.Root>
+  );
+};
+
+const ENV_LABELS: Record<string, string> = {
+  'edge-dev': 'Dev',
+  'edge-main': 'Main',
+  'edge-labs': 'Labs',
+  'edge-production': 'Production',
+};
+
+const EnvironmentLabel = () => {
+  const config = useConfig();
+  const edgeUrl = config.values.runtime?.services?.edge?.url;
+  if (!edgeUrl) {
+    return null;
+  }
+  const part = new URL(edgeUrl).host.split('.')[0];
+  const edgeEnv = ENV_LABELS[part];
+  if (!edgeEnv) {
+    return null;
+  }
+
+  return (
+    <StatusBar.Item>
+      <StatusBar.Text classNames='text-xs text-subdued border border-separator rounded-full px-1'>
+        <span title={edgeEnv}>{edgeEnv[0]}</span>
+      </StatusBar.Text>
+    </StatusBar.Item>
+  );
+};

package/src/containers/StatusBarActions/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+export { StatusBarActions as default } from './StatusBarActions';

package/src/containers/StatusBarPanel/StatusBarPanel.tsx

@@ -0,0 +1,21 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import React from 'react';
+
+import { Surface } from '@dxos/app-framework/ui';
+
+import StatusBarActionsDefault from '../StatusBarActions';
+
+export type StatusBarPanelProps = {};
+
+export const StatusBarPanel = (_props: StatusBarPanelProps) => {
+  return (
+    <>
+      <StatusBarActionsDefault />
+      <span role='separator' className='grow' />
+      <Surface.Surface role='status' />
+    </>
+  );
+};

package/src/containers/StatusBarPanel/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+export { StatusBarPanel as default } from './StatusBarPanel';

package/src/containers/VersionNumber/VersionNumber.tsx

@@ -0,0 +1,97 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { formatDistance } from 'date-fns/formatDistance';
+import React from 'react';
+
+import { useConfig } from '@dxos/react-client';
+import { Icon, Link, Message, Popover, Trans, useTranslation } from '@dxos/react-ui';
+
+import { StatusBar } from '#components';
+import { meta } from '#meta';
+
+export type VersionNumberProps = {};
+
+const repo = 'https://github.com/dxos/dxos';
+
+const VERSION_REGEX = /([\d.]+)/;
+
+export const VersionNumber = (_props: VersionNumberProps) => {
+  const { t } = useTranslation(meta.id);
+  const config = useConfig();
+  const { version, timestamp, commitHash } = config.values.runtime?.app?.build ?? {};
+  const [_, v] = version?.match(VERSION_REGEX) ?? [];
+
+  const releaseUrl =
+    config.values.runtime?.app?.env?.DX_ENVIRONMENT === 'production'
+      ? `${repo}/releases/tag/v${version}`
+      : `${repo}/commit/${commitHash}`;
+
+  const previewUrl = 'https://docs.dxos.org/composer#technology-preview';
+
+  return (
+    <Popover.Root>
+      <Popover.Trigger asChild>
+        <StatusBar.Button classNames='h-full text-xs'>{v}</StatusBar.Button>
+      </Popover.Trigger>
+      <Popover.Portal>
+        <Popover.Content side='top' role='message' classNames='z-[12] max-w-[min(calc(100vw-16px),40ch)]'>
+          <Message.Root valence='info' classNames='rounded-b-none p-4'>
+            <Message.Title>{t('warning.title')}</Message.Title>
+            <Message.Content>
+              {t('technology-preview.message')}
+              <br />
+              <Link href={previewUrl} target='_blank' rel='noreferrer' variant='neutral'>
+                {t('learn-more.label')}
+                <Icon icon='ph--arrow-square-out--bold' classNames='dx-icon-inline ms-1' />
+              </Link>
+            </Message.Content>
+          </Message.Root>
+          <div role='none' className='flex flex-col ps-9 pe-4 py-2 gap-1 space-b-2 text-base-surface-text'>
+            {timestamp && (
+              <div>
+                <p>
+                  {t('released.message', {
+                    released: formatDistance(new Date(timestamp), new Date(), { addSuffix: true }),
+                  })}
+                </p>
+                <div>
+                  <span className='dx-tag dx-tag--neutral -ml-1'>{version}</span>
+                </div>
+              </div>
+            )}
+            <div>
+              <p>
+                <Link href={releaseUrl} target='_blank' rel='noreferrer' variant='neutral'>
+                  {t('see-release.label')}
+                  <Icon icon='ph--arrow-square-out--bold' size={4} classNames='dx-icon-inline ms-1' />
+                </Link>
+              </p>
+              <p>
+                <Trans
+                  {...{
+                    t,
+                    i18nKey: 'powered-by-dxos.message',
+                    components: {
+                      dxos: (
+                        <Link
+                          classNames='text-green-500'
+                          href='https://dxos.org'
+                          target='_blank'
+                          rel='noreferrer'
+                          variant='neutral'
+                        />
+                      ),
+                    },
+                  }}
+                />
+              </p>
+            </div>
+          </div>
+          <Popover.Arrow />
+        </Popover.Content>
+      </Popover.Portal>
+    </Popover.Root>
+  );
+};

package/src/containers/VersionNumber/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+export { VersionNumber as default } from './VersionNumber';

package/src/containers/index.ts

@@ -0,0 +1,9 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { type ComponentType, lazy } from 'react';
+
+export const StatusBarActions: ComponentType<any> = lazy(() => import('./StatusBarActions'));
+export const StatusBarPanel: ComponentType<any> = lazy(() => import('./StatusBarPanel'));
+export const VersionNumber: ComponentType<any> = lazy(() => import('./VersionNumber'));

package/src/meta.ts

@@ -6,7 +6,7 @@ import { type Plugin } from '@dxos/app-framework';
 import { trim } from '@dxos/util';
 
 export const meta: Plugin.Meta = {
-  id: 'dxos.org/plugin/status-bar',
+  id: 'org.dxos.plugin.status-bar',
   name: 'Status Bar',
   description: trim`
     Persistent bottom bar displaying workspace status information and quick actions.

package/src/translations.ts

@@ -4,22 +4,22 @@
 
 import { type Resource } from '@dxos/react-ui';
 
-import { meta } from './meta';
+import { meta } from '#meta';
 
 export const translations = [
   {
     'en-US': {
       [meta.id]: {
-        'plugin name': 'Status Bar',
-        'warning title': 'WARNING',
-        'technology preview message': 'Composer is currently in beta.',
-        'learn more label': 'Learn more',
-        'released message': 'This version released {{released}}.',
-        'see release label': 'See release on GitHub',
-        'powered by dxos message': 'Powered by <dxos>DXOS</dxos>',
-        'discord label': 'Discord',
-        'github label': 'GitHub',
-        'feedback label': 'Feedback',
+        'plugin.name': 'Status Bar',
+        'warning.title': 'WARNING',
+        'technology-preview.message': 'Composer is currently in beta.',
+        'learn-more.label': 'Learn more',
+        'released.message': 'This version was released {{released}}.',
+        'see-release.label': 'See release on GitHub',
+        'powered-by-dxos.message': 'Powered by <dxos>DXOS</dxos>',
+        'discord.label': 'Discord',
+        'github.label': 'GitHub',
+        'feedback.label': 'Feedback',
       },
     },
   },