@dxos/lit-ui 0.8.4-main.84f28bd → 0.8.4-main.937b3ca

package/package.json

@@ -1,27 +1,35 @@
 {
   "name": "@dxos/lit-ui",
-  "version": "0.8.4-main.84f28bd",
+  "version": "0.8.4-main.937b3ca",
   "description": "Web Components for DXOS using Lit",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dxos/dxos"
+  },
   "license": "MIT",
   "author": "DXOS.org",
-  "sideEffects": true,
+  "sideEffects": [
+    "*.css",
+    "*.pcss"
+  ],
   "type": "module",
   "exports": {
     ".": {
+      "source": "./src/index.ts",
       "types": "./dist/src/index.d.ts",
       "browser": "./dist/src/index.js",
       "node": "./dist/src/index.js"
     },
     "./react": {
+      "source": "./src/react.ts",
       "types": "./dist/src/react.d.ts",
       "browser": "./dist/src/react.js",
       "node": "./dist/src/react.js"
     },
     "./dx-avatar.pcss": "./src/dx-avatar/dx-avatar.pcss",
-    "./dx-tag-picker.pcss": "./src/dx-tag-picker/dx-tag-picker.pcss",
-    "./dx-ref-tag.pcss": "./src/dx-ref-tag/dx-ref-tag.pcss"
+    "./dx-tag-picker.pcss": "./src/dx-tag-picker/dx-tag-picker.pcss"
   },
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
@@ -37,13 +45,14 @@
     "dist"
   ],
   "dependencies": {
-    "@lit/react": "^1.0.5",
-    "lit": "^3.2.0",
-    "@dxos/react-hooks": "0.8.4-main.84f28bd",
-    "@dxos/util": "0.8.4-main.84f28bd"
+    "@lit/react": "^1.0.8",
+    "lit": "^3.3.1",
+    "@dxos/react-hooks": "0.8.4-main.937b3ca",
+    "@dxos/ui-types": "0.8.4-main.937b3ca",
+    "@dxos/util": "0.8.4-main.937b3ca"
   },
   "devDependencies": {
-    "@dxos/test-utils": "0.8.4-main.84f28bd"
+    "@dxos/test-utils": "0.8.4-main.937b3ca"
   },
   "publishConfig": {
     "access": "public"

package/src/defs.ts

@@ -2,7 +2,7 @@
 // Copyright 2025 DXOS.org
 //
 
-// TODO(thure): I was unable to bring this in from `react-ui-types` because toolbox.ts would not acknowledge
+// TODO(thure): I was unable to bring this in from `ui-types` because toolbox.ts would not acknowledge
 //  `"@dxos/lit-ui": [ "packages/ui/lit-ui/src/index.ts" ]` in tsconfig.paths.json. How is this meant to work? How is it
 //  okay with `react-hooks`?
 export type Size =

package/src/{dx-ref-tag/dx-ref-tag.ts → dx-anchor/dx-anchor.ts}

@@ -5,32 +5,20 @@
 // TODO(thure): Find a way to instruct ESLint & Prettier to treat any whitespace between tags rendered in the `html` template function as significant.
 /* eslint-disable */
 
-import { html, LitElement } from 'lit';
+import { LitElement } from 'lit';
 import { customElement, property } from 'lit/decorators.js';
 
-import { makeId } from '@dxos/react-hooks';
-
-export class DxRefTagActivate extends Event {
-  public readonly refId: string;
-  public readonly label: string;
-  public readonly trigger: DxRefTag;
-  constructor(props: { refId: string; label: string; trigger: DxRefTag }) {
-    super('dx-ref-tag-activate');
-    this.refId = props.refId;
-    this.label = props.label;
-    this.trigger = props.trigger;
-  }
-}
+import { DxAnchorActivate } from '@dxos/ui-types';
 
-@customElement('dx-ref-tag')
-export class DxRefTag extends LitElement {
+@customElement('dx-anchor')
+export class DxAnchor extends LitElement {
 
   // TODO(thure): There is a case (in)sensitivity issue here which is pernicious:
   //   Only refactoring the properties here to all-lowercase fixes the binding in `RefField.tsx`, but that
   //   should be unnecessary, and it isn’t an issue for `DxAvatar` or `DxGrid`. What’s going on?
 
   @property({ type: String })
-  refid: string = makeId('dx-ref-tag');
+  refid: string = '';
 
   @property({ type: String })
   rootclassname: string | undefined = undefined;
@@ -38,7 +26,7 @@ export class DxRefTag extends LitElement {
   override connectedCallback (): void {
     super.connectedCallback();
     this.tabIndex = 0;
-    this.classList.add('dx-focus-ring');
+    this.classList.add(this.getAttribute('data-visible-focus')==='false' ? 'outline-none' : 'dx-focus-ring');
     if(this.rootclassname){
       this.classList.add(this.rootclassname);
     }
@@ -53,7 +41,7 @@ export class DxRefTag extends LitElement {
 
   private handleActivate(event: { type: string }): void {
     this.dispatchEvent(
-      new DxRefTagActivate({ refId: this.refid, label: this.textContent ?? '', trigger: this }),
+      new DxAnchorActivate({ refId: this.refid, label: this.textContent ?? '', trigger: this }),
     );
   }
 

package/src/{dx-ref-tag → dx-anchor}/index.ts

@@ -2,4 +2,4 @@
 // Copyright 2025 DXOS.org
 //
 
-export * from './dx-ref-tag';
+export * from './dx-anchor';

package/src/dx-avatar/dx-avatar.lit-stories.ts

@@ -3,17 +3,19 @@
 //
 
 import '@dxos-theme';
-
 import './dx-avatar.pcss';
+
 import { html } from 'lit';
 
 import { type DxAvatarProps } from './dx-avatar';
 
 export default {
   title: 'dx-avatar',
-  parameters: { layout: 'fullscreen' },
+  parameters: {
+    layout: 'centered',
+  },
 };
 
-export const Basic = (props: DxAvatarProps) => {
+export const Basic = (_props: DxAvatarProps) => {
   return html`<dx-avatar hue="teal" fallback="Composer user" icon="/icons.svg#ph--basketball--regular"></dx-avatar>`;
 };

package/src/dx-avatar/dx-avatar.pcss

@@ -20,7 +20,7 @@ dx-avatar {
   @apply relative inline-flex shrink-0;
 
   .dx-avatar__frame {
-    @apply is-full bs-full bg-[--surface-bg];
+    @apply is-full bs-full;
   }
 
   .dx-avatar__frame, .dx-avatar__ring {
@@ -74,5 +74,11 @@ dx-avatar {
       @apply hidden;
     }
   }
+
+  &[data-state-loading-status="error"] {
+    .dx-avatar__image {
+      @apply hidden;
+    }
+  }
 }
 

package/src/dx-avatar/dx-avatar.ts

@@ -2,12 +2,11 @@
 // Copyright 2025 DXOS.org
 //
 
-import { html, svg, LitElement } from 'lit';
-import { customElement, state, property } from 'lit/decorators.js';
+import { LitElement, html, svg } from 'lit';
+import { customElement, property, state } from 'lit/decorators.js';
 import { styleMap } from 'lit/directives/style-map.js';
 
 import { makeId } from '@dxos/react-hooks';
-import { getFirstTwoRenderableChars } from '@dxos/util';
 
 import { type Size } from '../defs';
 
@@ -37,6 +36,7 @@ export type DxAvatarProps = Partial<
   >
 >;
 
+// TODO(burdon): Needs popover.
 @customElement('dx-avatar')
 export class DxAvatar extends LitElement {
   private maskId: string;
@@ -71,7 +71,7 @@ export class DxAvatar extends LitElement {
   hue: string | undefined = undefined;
 
   @property({ type: String })
-  hueVariant: 'fill' | 'surface' = 'fill';
+  hueVariant: 'fill' | 'surface' | 'transparent' = 'fill';
 
   @property({ type: String })
   size: Size = 10;
@@ -113,13 +113,17 @@ export class DxAvatar extends LitElement {
     const r = sizePx / 2 - ringGap - ringWidth;
     const isTextOnly = Boolean(this.fallback && /[0-9a-zA-Z]+/.test(this.fallback));
     const fontScale = (isTextOnly ? 3 : 3.6) * (1 / 1.612);
-    const bg = this.hue
-      ? this.hueVariant === 'surface'
-        ? `var(--dx-${this.hue}Surface)`
-        : `var(--dx-${this.hue}Fill)`
-      : 'var(--surface-bg)';
+    const bg =
+      this.hueVariant === 'transparent'
+        ? 'transparent'
+        : this.hue
+          ? this.hueVariant === 'surface'
+            ? `var(--dx-${this.hue}Surface)`
+            : `var(--dx-${this.hue === 'neutral' ? 'inputSurface' : `${this.hue}Fill`})`
+          : 'var(--surface-bg)';
     const fg =
       this.hue && this.hueVariant === 'surface' ? `var(--dx-${this.hue}SurfaceText)` : 'var(--dx-accentSurfaceText)';
+
     return html`<span
       role="none"
       class=${`dx-avatar${this.rootClassName ? ` ${this.rootClassName}` : ''}`}
@@ -139,62 +143,71 @@ export class DxAvatar extends LitElement {
             ${
               this.variant === 'circle'
                 ? svg`<circle fill="white" cx="50%" cy="50%" r=${r} />`
-                : svg`<rect
-                  fill="white"
-                  width=${2 * r}
-                  height=${2 * r}
-                  x=${ringGap + ringWidth}
-                  y=${ringGap + ringWidth}
-                  rx=${rx}
-                />`
+                : svg`
+                  <rect
+                    fill="white"
+                    width=${2 * r}
+                    height=${2 * r}
+                    x=${ringGap + ringWidth}
+                    y=${ringGap + ringWidth}
+                    rx=${rx}
+                  />`
             }
           </mask>
         </defs>
         ${
           this.variant === 'circle'
-            ? svg` <circle
-              cx="50%"
-              cy="50%"
-              r=${r}
-              fill=${bg}
-            />`
-            : svg` <rect
-              fill=${bg}
-              x=${ringGap + ringWidth}
-              y=${ringGap + ringWidth}
-              width=${2 * r}
-              height=${2 * r}
-              rx=${rx}
-            />`
+            ? svg`
+              <circle
+                cx="50%"
+                cy="50%"
+                r=${r}
+                fill=${bg}
+              />`
+            : svg`
+              <rect
+                fill=${bg}
+                x=${ringGap + ringWidth}
+                y=${ringGap + ringWidth}
+                width=${2 * r}
+                height=${2 * r}
+                rx=${rx}
+              />`
         }
         ${
           this.icon
-            ? svg`<use
+            ? svg`
+              <use
                 class="dx-avatar__icon"
                 href=${this.icon}
                 x=${sizePx / 5}
                 y=${sizePx / 5}
                 width=${(3 * sizePx) / 5}
                 height=${(3 * sizePx) / 5} />`
-            : svg`<text
+            : // NOTE: Firefox currently doesn't fully support alignment-baseline.
+              svg`
+              <text
                 x="50%"
                 y="50%"
                 class="dx-avatar__fallback-text"
                 fill=${fg}
                 text-anchor="middle"
                 alignment-baseline="central"
+                dominant-baseline="middle"
                 font-size=${this.size === 'px' ? '200%' : this.size * fontScale}
                 mask=${`url(#${this.maskId})`}
               >
-                ${getFirstTwoRenderableChars(this.fallback)}
+                ${/\p{Emoji_Presentation}/u.test(this.fallback) ? this.fallback : getInitials(this.fallback)}
               </text>`
         }
         ${
           this.imgSrc &&
-          svg`<image
+          svg`
+            <image
               width="100%"
               height="100%"
               preserveAspectRatio="xMidYMid slice"
+              class="dx-avatar__image"
               href=${this.imgSrc}
               mask=${`url(#${this.maskId})`}
               crossorigin=${this.imgCrossOrigin}
@@ -210,3 +223,17 @@ export class DxAvatar extends LitElement {
     return this;
   }
 }
+
+/**
+ * Returns the first two renderable characters from a string that are separated by non-word characters.
+ * Handles Unicode characters correctly.
+ */
+const getInitials = (label = ''): string[] => {
+  return label
+    .trim()
+    .split(/\s+/)
+    .map((str) => str.replace(/[^\p{L}\p{N}\s]/gu, ''))
+    .filter(Boolean)
+    .slice(0, 2)
+    .map((word) => word[0].toUpperCase());
+};

package/src/dx-icon/dx-icon.ts

@@ -2,7 +2,7 @@
 // Copyright 2025 DXOS.org
 //
 
-import { svg, LitElement } from 'lit';
+import { LitElement, svg } from 'lit';
 import { customElement, property } from 'lit/decorators.js';
 
 import { type Size } from '../defs';

package/src/dx-tag-picker/dx-tag-picker-item.ts

@@ -2,7 +2,7 @@
 // Copyright 2025 DXOS.org
 //
 
-import { html, LitElement } from 'lit';
+import { LitElement, html } from 'lit';
 import { customElement, property } from 'lit/decorators.js';
 
 import { makeId } from '@dxos/react-hooks';

package/src/index.ts

@@ -2,7 +2,7 @@
 // Copyright 2025 DXOS.org
 //
 
+export * from './dx-anchor';
 export * from './dx-avatar';
-export * from './dx-tag-picker';
-export * from './dx-ref-tag';
 export * from './dx-icon';
+export * from './dx-tag-picker';

package/src/react.ts

@@ -2,28 +2,29 @@
 // Copyright 2025 DXOS.org
 //
 
-import { createComponent, type EventName } from '@lit/react';
+import { type EventName, createComponent } from '@lit/react';
 import React, { type ComponentPropsWithRef } from 'react';
 
+import { DX_ANCHOR_ACTIVATE, type DxAnchorActivate } from '@dxos/ui-types';
+
 import {
+  type DxTagPickerItemClick,
+  DxAnchor as NaturalDxAnchor,
   DxAvatar as NaturalDxAvatar,
-  DxRefTag as NaturalDxRefTag,
-  DxIcon as NaturalIcon,
-  type DxRefTagActivate,
   DxTagPickerItem as NaturalDxTagPickerItem,
-  type DxTagPickerItemClick,
+  DxIcon as NaturalIcon,
 } from './index';
 
-export const DxRefTag = createComponent({
-  tagName: 'dx-ref-tag',
-  elementClass: NaturalDxRefTag,
+export const DxAnchor = createComponent({
+  tagName: 'dx-anchor',
+  elementClass: NaturalDxAnchor,
   react: React,
   events: {
-    onActivate: 'dx-ref-tag-activate' as EventName<DxRefTagActivate>,
+    onActivate: DX_ANCHOR_ACTIVATE as EventName<DxAnchorActivate>,
   },
 });
 
-export type DxRefTagProps = ComponentPropsWithRef<typeof DxRefTag>;
+export type DxAnchorProps = ComponentPropsWithRef<typeof DxAnchor>;
 
 export const DxAvatar = createComponent({
   tagName: 'dx-avatar',

package/dist/src/dx-ref-tag/dx-ref-tag.d.ts

@@ -1,19 +0,0 @@
-import { LitElement } from 'lit';
-export declare class DxRefTagActivate extends Event {
-    readonly refId: string;
-    readonly label: string;
-    readonly trigger: DxRefTag;
-    constructor(props: {
-        refId: string;
-        label: string;
-        trigger: DxRefTag;
-    });
-}
-export declare class DxRefTag extends LitElement {
-    refid: string;
-    rootclassname: string | undefined;
-    connectedCallback(): void;
-    private handleActivate;
-    createRenderRoot(): this;
-}
-//# sourceMappingURL=dx-ref-tag.d.ts.map

package/dist/src/dx-ref-tag/dx-ref-tag.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dx-ref-tag.d.ts","sourceRoot":"","sources":["../../../src/dx-ref-tag/dx-ref-tag.ts"],"names":[],"mappings":"AAOA,OAAO,EAAQ,UAAU,EAAE,MAAM,KAAK,CAAC;AAKvC,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,OAAO,EAAE,QAAQ,CAAC;gBACtB,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,QAAQ,CAAA;KAAE;CAMvE;AAED,qBACa,QAAS,SAAQ,UAAU;IAOtC,KAAK,EAAE,MAAM,CAAwB;IAGrC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAa;IAErC,iBAAiB,IAAK,IAAI;IAgBnC,OAAO,CAAC,cAAc;IAMb,gBAAgB,IAAI,IAAI;CAGlC"}

package/dist/src/dx-ref-tag/dx-ref-tag.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"dx-ref-tag.js","sourceRoot":"","sources":["../../../src/dx-ref-tag/dx-ref-tag.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;;;;;;;AAEF,sJAAsJ;AACtJ,oBAAoB;AAEpB,OAAO,EAAQ,UAAU,EAAE,MAAM,KAAK,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAIzC,YAAY,KAA0D;QACpE,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC/B,CAAC;CACF;AAGM,IAAM,QAAQ,GAAd,MAAM,QAAS,SAAQ,UAAU;IAAjC;QAEL,+EAA+E;QAC/E,wGAAwG;QACxG,8FAA8F;;QAG9F,UAAK,GAAW,MAAM,CAAC,YAAY,CAAC,CAAC;QAGrC,kBAAa,GAAuB,SAAS,CAAC;IA2BhD,CAAC;IAzBU,iBAAiB;QACxB,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;QAClB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACpC,IAAG,IAAI,CAAC,aAAa,EAAC,CAAC;YACrB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACzC,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAEpC,IAAI,IAAI,CAAC,YAAY,CAAC,mBAAmB,CAAC,KAAK,MAAM,EAAE,CAAC;YACtD,IAAI,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;QAChD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAEO,cAAc,CAAC,KAAuB;;QAC5C,IAAI,CAAC,aAAa,CAChB,IAAI,gBAAgB,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,MAAA,IAAI,CAAC,WAAW,mCAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAC1F,CAAC;IACJ,CAAC;IAEQ,gBAAgB;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAA;AA9BC;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;uCACU;AAGrC;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;+CACmB;AAVnC,QAAQ;IADpB,aAAa,CAAC,YAAY,CAAC;GACf,QAAQ,CAqCpB"}

package/dist/src/dx-ref-tag/index.d.ts

@@ -1,2 +0,0 @@
-export * from './dx-ref-tag';
-//# sourceMappingURL=index.d.ts.map

package/dist/src/dx-ref-tag/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dx-ref-tag/index.ts"],"names":[],"mappings":"AAIA,cAAc,cAAc,CAAC"}

package/dist/src/dx-ref-tag/index.js

@@ -1,5 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-export * from './dx-ref-tag';
-//# sourceMappingURL=index.js.map

package/dist/src/dx-ref-tag/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/dx-ref-tag/index.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;AAEF,cAAc,cAAc,CAAC"}

package/src/dx-ref-tag/dx-ref-tag.pcss

@@ -1,8 +0,0 @@
-@layer dx-components {
-  dx-ref-tag {
-    @apply inline cursor-pointer pli-1 plb-0.5 border border-separator rounded-sm transition-colors;
-    &:hover {
-      @apply bg-hoverSurface;
-    }
-  }
-}