@dxos/ui-theme 0.0.0 → 0.8.4-main.05e74ebcff

package/src/css/components/panel.css

@@ -0,0 +1,117 @@
+/**
+ * Panel — applies bg-{hue}-surface / text-{hue}-foreground / border-{hue}-border tokens via data-hue attribute or BEM modifier.
+ * Example: <div className='dx-panel' data-hue='blue'>...</div>
+ * Example: <div className='dx-panel dx-panel--blue'>...</div>
+ */
+
+@layer dx-components {
+  [data-hue='neutral'] .dx-panel,
+  .dx-panel--neutral {
+    @apply bg-neutral-surface text-neutral-foreground border-neutral-border;
+  }
+
+  [data-hue='red'] .dx-panel,
+  .dx-panel--red {
+    @apply bg-red-surface text-red-foreground border-red-border;
+  }
+
+  [data-hue='orange'] .dx-panel,
+  .dx-panel--orange {
+    @apply bg-orange-surface text-orange-foreground border-orange-border;
+  }
+
+  [data-hue='amber'] .dx-panel,
+  .dx-panel--amber {
+    @apply bg-amber-surface text-amber-foreground border-amber-border;
+  }
+
+  [data-hue='yellow'] .dx-panel,
+  .dx-panel--yellow {
+    @apply bg-yellow-surface text-yellow-foreground border-yellow-border;
+  }
+
+  [data-hue='lime'] .dx-panel,
+  .dx-panel--lime {
+    @apply bg-lime-surface text-lime-foreground border-lime-border;
+  }
+
+  [data-hue='green'] .dx-panel,
+  .dx-panel--green {
+    @apply bg-green-surface text-green-foreground border-green-border;
+  }
+
+  [data-hue='emerald'] .dx-panel,
+  .dx-panel--emerald {
+    @apply bg-emerald-surface text-emerald-foreground border-emerald-border;
+  }
+
+  [data-hue='teal'] .dx-panel,
+  .dx-panel--teal {
+    @apply bg-teal-surface text-teal-foreground border-teal-border;
+  }
+
+  [data-hue='cyan'] .dx-panel,
+  .dx-panel--cyan {
+    @apply bg-cyan-surface text-cyan-foreground border-cyan-border;
+  }
+
+  [data-hue='sky'] .dx-panel,
+  .dx-panel--sky {
+    @apply bg-sky-surface text-sky-foreground border-sky-border;
+  }
+
+  [data-hue='blue'] .dx-panel,
+  .dx-panel--blue {
+    @apply bg-blue-surface text-blue-foreground border-blue-border;
+  }
+
+  [data-hue='indigo'] .dx-panel,
+  .dx-panel--indigo {
+    @apply bg-indigo-surface text-indigo-foreground border-indigo-border;
+  }
+
+  [data-hue='violet'] .dx-panel,
+  .dx-panel--violet {
+    @apply bg-violet-surface text-violet-foreground border-violet-border;
+  }
+
+  [data-hue='purple'] .dx-panel,
+  .dx-panel--purple {
+    @apply bg-purple-surface text-purple-foreground border-purple-border;
+  }
+
+  [data-hue='fuchsia'] .dx-panel,
+  .dx-panel--fuchsia {
+    @apply bg-fuchsia-surface text-fuchsia-foreground border-fuchsia-border;
+  }
+
+  [data-hue='pink'] .dx-panel,
+  .dx-panel--pink {
+    @apply bg-pink-surface text-pink-foreground border-pink-border;
+  }
+
+  [data-hue='rose'] .dx-panel,
+  .dx-panel--rose {
+    @apply bg-rose-surface text-rose-foreground border-rose-border;
+  }
+
+  [data-hue='info'] .dx-panel,
+  .dx-panel--info {
+    @apply bg-info-surface text-info-foreground border-info-border;
+  }
+
+  [data-hue='success'] .dx-panel,
+  .dx-panel--success {
+    @apply bg-success-surface text-success-foreground border-success-border;
+  }
+
+  [data-hue='warning'] .dx-panel,
+  .dx-panel--warning {
+    @apply bg-warning-surface text-warning-foreground border-warning-border;
+  }
+
+  [data-hue='error'] .dx-panel,
+  .dx-panel--error {
+    @apply bg-error-surface text-error-foreground border-error-border;
+  }
+}

package/src/css/components/scrollbar.css

@@ -0,0 +1,24 @@
+/**
+ * Scrolling 
+ * Pseudo-classes are not supported by Tailwind.
+ */
+
+@layer dx-components {
+  ::-webkit-scrollbar-thumb:hover {
+    @apply bg-scrollbar-thumb-hover!;
+  }
+  ::-webkit-scrollbar-thumb:active {
+    @apply bg-scrollbar-thumb-active!;
+  }
+
+  .dx-scrollbar-thin::-webkit-scrollbar {
+    @apply w-[4px];
+  }
+  .dx-scrollbar-thin::-webkit-scrollbar-thumb {
+    @apply bg-transparent;
+    transition: background 0.15s;
+  }
+  .dx-scrollbar-thin:hover::-webkit-scrollbar-thumb {
+    @apply bg-scrollbar-thumb;
+  }
+}

package/src/css/components/selected.css

@@ -0,0 +1,76 @@
+/**
+ * Selected / Current / Highlighted state utilities.
+ *
+ * See `./selected.md` for the ARIA pairing grammar — every class below
+ * fires off a specific attribute and silently does nothing without it.
+ */
+
+@layer dx-components {
+  /*
+   * Pure visual affordance, no ARIA pair. Combine with dx-selected or dx-current.
+   *
+   * Picks the hover variant matching the element's underlying state:
+   *   - neither aria-selected nor aria-current → hover-surface
+   *   - aria-selected="true"                   → selected-surface-hover
+   *   - aria-current="true"                    → current-surface-hover (wins if both)
+   *
+   * Higher-specificity rules (attribute selectors) override the plain :hover rule,
+   * and `aria-current` is listed last so it beats `aria-selected` at equal specificity.
+   */
+  .dx-hover {
+    @apply cursor-pointer
+      hover:bg-hover-surface! hover:text-hover-foreground!
+      hover:aria-selected:bg-selected-surface-hover! hover:aria-selected:text-selected-foreground!
+      hover:aria-[current=true]:bg-current-surface-hover! hover:aria-[current=true]:text-current-foreground!;
+  }
+  .dx-hover-row {
+    @apply group-hover/row:bg-hover-surface! group-hover/row:text-hover-foreground!
+      group-hover/row:group-aria-selected/row:bg-selected-surface-hover!
+      group-hover/row:group-aria-selected/row:text-selected-foreground!
+      group-hover/row:group-aria-[current=true]/row:bg-current-surface-hover!
+      group-hover/row:group-aria-[current=true]/row:text-current-foreground!;
+  }
+
+  /*
+   * Pairs with `aria-selected`. Use for listbox/option selection (master/detail).
+   * `!` is required: these utilities live in the `dx-components` layer, but
+   * background utilities like `bg-card-surface` live in Tailwind's
+   * `utilities` layer (declared later in the cascade), so without
+   * `!important` the card background would override the state colour.
+   *
+   * NOTE: Declared before `.dx-current` so that when an element has both
+   * `aria-selected="true"` and `aria-current="true"`, `dx-current` wins at
+   * equal specificity (consistent with how `dx-hover` resolves the same
+   * conflict).
+   */
+  .dx-selected {
+    @apply aria-selected:bg-selected-surface! aria-selected:text-selected-foreground!
+      aria-selected:font-semibold aria-selected:tracking-normal
+      transition-[color,font-variation-settings,letter-spacing];
+  }
+
+  /*
+   * Pairs with `aria-current="true|page|…"`. Use for "you are here" navigation.
+   *
+   * The ring uses the subdued focus indicator (neutral) rather than the
+   * accent blue — `dx-current` marks position, not focus, so a saturated
+   * ring would compete with the actual keyboard focus ring.
+   */
+  .dx-current {
+    @apply dx-ring-pseudo
+      aria-[current=true]:bg-current-surface! aria-[current=true]:text-current-foreground!
+      aria-[current=true]:after:ring-focus-ring-subtle!;
+  }
+  .dx-current-row {
+    @apply group-aria-[current=true]/row:bg-current-surface! group-aria-[current=true]/row:text-current-foreground!;
+  }
+
+  /*
+   * Pairs with Radix-managed `data-highlighted`. Don't set the attribute manually.
+   */
+  .dx-highlighted {
+    @apply data-[highlighted]:bg-current-surface
+      data-[highlighted]:text-current-foreground
+      hover:data-[highlighted]:bg-current-surface-hover;
+  }
+}

package/src/css/components/selected.md

@@ -0,0 +1,101 @@
+# `dx-*` selection / navigation grammar
+
+Companion to `selected.css`. The four selection-state utilities below are
+each bound to a specific ARIA attribute (or `data-*`) selector. **The
+class only fires when the matching ARIA attribute is set on the same
+element.** Mismatches (e.g. `dx-current` paired with `aria-selected`)
+silently render as a plain row.
+
+| Class            | Bound selector         | Pair with                          | Use when                                                                                                                                                                                                    |
+| ---------------- | ---------------------- | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `dx-hover`       | `hover:`               | (no ARIA — pure visual affordance) | Always, on any clickable row. Adds the cursor + hover bg/text.                                                                                                                                              |
+| `dx-selected`    | `aria-selected:`       | `aria-selected={boolean}`          | A row is "the chosen one" driving a master/detail panel. Listbox / option pattern. Multi-select OK.                                                                                                         |
+| `dx-current`     | `aria-[current=true]:` | `aria-current='true'`              | A row is "where you are" in a navigation set (current page, current step). At most one current per group. The CSS variant fires only on `aria-current='true'`, so use that literal even on `<a>`/nav links. |
+| `dx-highlighted` | `data-[highlighted]:`  | Radix `data-highlighted` (managed) | A Radix-managed transient highlight (menu / combobox active option). Don't set the attribute manually.                                                                                                      |
+
+## Rules
+
+1. **Never combine `dx-selected` and `dx-current` on the same element**
+   unless you also set both `aria-selected` and `aria-current`. They
+   express different things (chosen vs you-are-here) and the visual
+   weight is similar enough that combining them defeats both.
+2. **`aria-pressed`, `aria-checked`, `aria-expanded`, `aria-disabled`
+   are not selection-row attributes.** None of the `dx-*` selection
+   utilities pair with them. Toggle buttons (mute/unmute) want
+   `aria-pressed`; a selection row wants `aria-selected`.
+3. **`aria-selected` is only valid on roles that admit it** — `option`,
+   `tab`, `gridcell`, `row`, `treeitem`, `columnheader`, `rowheader`.
+   On a plain `<button>` inside a `<ul role='listbox'>`, give the button
+   `role='option'` so assistive tech sees the attribute.
+4. **`dx-active` does not exist.** If you see it in code it's a no-op
+   string. Use `dx-selected` (selection) or `dx-current` (navigation)
+   instead.
+5. **Set ARIA before adding the class.** The class is inert without
+   the attribute; it's not a fallback styler. Reviewers should reject
+   PRs that add `dx-selected` without `aria-selected`.
+
+## Canonical patterns
+
+### Selectable row in a list (master/detail)
+
+```tsx
+<ul role='listbox' aria-label='…'>
+  {items.map((item) => (
+    <li key={item.id} role='presentation'>
+      <button
+        type='button'
+        role='option'
+        aria-selected={item.id === selectedId}
+        className='dx-hover dx-selected'
+        onClick={() => onSelect(item.id)}
+      >
+        {item.label}
+      </button>
+    </li>
+  ))}
+</ul>
+```
+
+### "You are here" in a navigation list
+
+```tsx
+<nav>
+  <ul>
+    {pages.map((page) => (
+      <li key={page.href}>
+        <a
+          href={page.href}
+          aria-current={page.href === currentHref ? 'true' : undefined}
+          className='dx-hover dx-current'
+        >
+          {page.label}
+        </a>
+      </li>
+    ))}
+  </ul>
+</nav>
+```
+
+### Toggle button (NOT a row)
+
+Don't reach for `dx-selected` here. Toggle buttons want their own
+visual treatment via `aria-pressed:` variants — out of scope for this
+file.
+
+```tsx
+<button type='button' aria-pressed={muted} onClick={toggleMute}>
+  {muted ? 'Unmute' : 'Mute'}
+</button>
+```
+
+## Enforcing the grammar
+
+A future ESLint rule could flag:
+
+- `dx-selected` without `aria-selected` on the same element.
+- `dx-current` without `aria-current` on the same element.
+- `dx-active` literal anywhere.
+
+Until that exists, reviewers and the `react-ui-list` `RowList` /
+`CardList` containers (which set both attribute and class together)
+are the enforcement.

package/src/css/components/surface.css

@@ -0,0 +1,34 @@
+/**
+ * Surfaces
+ */
+
+@layer dx-components {
+  .dx-base-surface {
+    @apply bg-base-surface text-base-foreground;
+    --surface-bg: var(--color-base-surface);
+  }
+
+  .dx-sidebar-surface {
+    @apply bg-sidebar-surface text-base-foreground;
+    --surface-bg: var(--color-sidebar-surface);
+  }
+
+  .dx-modal-surface {
+    @apply bg-modal-surface text-base-foreground backdrop-blur-md;
+    --surface-bg: var(--color-modal-surface);
+  }
+
+  .dx-attention-surface {
+    @apply bg-attention-surface text-base-foreground;
+    --surface-bg: var(--color-attention-surface);
+  }
+}
+
+/* TODO(burdon): Resolve. */
+/* @layer dx-tokens {
+  .dx-sidebar-surface, .dx-modal-surface {
+    --color-hover-surface: light-dark(var(--color-neutral-300), var(--color-neutral-700));
+    --color-input-surface: light-dark(var(--color-neutral-200), var(--color-neutral-800));
+    --color-separator: light-dark(var(--color-neutral-300), var(--color-neutral-700));
+  }
+} */

package/src/css/components/tag.css

@@ -0,0 +1,132 @@
+/**
+ * Tag
+ */
+
+@layer dx-components {
+  .dx-tag {
+    @apply inline-block text-xs font-semibold m-0.5 px-1 rounded-sm cursor-default truncate;
+    padding-block: var(--spacing-tag-padding-block);
+    user-select: none;
+  }
+
+  .dx-tag--anchor {
+    /* NOTE: Margin offsets padding so that border is flush with text. This should only apply to anchor tags inside of Codemirror. */
+    @apply inline cursor-pointer -mx-[3px] px-[2px] py-0.5 border rounded-xs transition-colors;
+    /** TODO(burdon): Configure secondary color. */
+    @apply bg-group-surface text-sky-foreground border-sky-border;
+
+    &:hover {
+      @apply bg-hover-surface;
+    }
+  }
+
+  .dx-tag[data-hue='neutral'],
+  .dx-tag--neutral {
+    @apply bg-neutral-surface text-neutral-foreground;
+  }
+
+  .dx-tag[data-hue='red'],
+  .dx-tag--red {
+    @apply bg-red-surface text-red-foreground;
+  }
+
+  .dx-tag[data-hue='orange'],
+  .dx-tag--orange {
+    @apply bg-orange-surface text-orange-foreground;
+  }
+
+  .dx-tag[data-hue='amber'],
+  .dx-tag--amber {
+    @apply bg-amber-surface text-amber-foreground;
+  }
+
+  .dx-tag[data-hue='yellow'],
+  .dx-tag--yellow {
+    @apply bg-yellow-surface text-yellow-foreground;
+  }
+
+  .dx-tag[data-hue='lime'],
+  .dx-tag--lime {
+    @apply bg-lime-surface text-lime-foreground;
+  }
+
+  .dx-tag[data-hue='green'],
+  .dx-tag--green {
+    @apply bg-green-surface text-green-foreground;
+  }
+
+  .dx-tag[data-hue='emerald'],
+  .dx-tag--emerald {
+    @apply bg-emerald-surface text-emerald-foreground;
+  }
+
+  .dx-tag[data-hue='teal'],
+  .dx-tag--teal {
+    @apply bg-teal-surface text-teal-foreground;
+  }
+
+  .dx-tag[data-hue='cyan'],
+  .dx-tag--cyan {
+    @apply bg-cyan-surface text-cyan-foreground;
+  }
+
+  .dx-tag[data-hue='sky'],
+  .dx-tag--sky {
+    @apply bg-sky-surface text-sky-foreground;
+  }
+
+  .dx-tag[data-hue='blue'],
+  .dx-tag--blue {
+    @apply bg-blue-surface text-blue-foreground;
+  }
+
+  .dx-tag[data-hue='indigo'],
+  .dx-tag--indigo {
+    @apply bg-indigo-surface text-indigo-foreground;
+  }
+
+  .dx-tag[data-hue='violet'],
+  .dx-tag--violet {
+    @apply bg-violet-surface text-violet-foreground;
+  }
+
+  .dx-tag[data-hue='purple'],
+  .dx-tag--purple {
+    @apply bg-purple-surface text-purple-foreground;
+  }
+
+  .dx-tag[data-hue='fuchsia'],
+  .dx-tag--fuchsia {
+    @apply bg-fuchsia-surface text-fuchsia-foreground;
+  }
+
+  .dx-tag[data-hue='pink'],
+  .dx-tag--pink {
+    @apply bg-pink-surface text-pink-foreground;
+  }
+
+  .dx-tag[data-hue='rose'],
+  .dx-tag--rose {
+    @apply bg-rose-surface text-rose-foreground;
+  }
+
+  .dx-tag[data-hue='info'],
+  .dx-tag--info {
+    @apply bg-cyan-surface text-cyan-foreground;
+  }
+
+  .dx-tag[data-hue='success'],
+  .dx-tag--success {
+    @apply bg-emerald-surface text-emerald-foreground;
+  }
+
+  .dx-tag[data-hue='warning'],
+  .dx-tag--warning {
+    @apply bg-amber-surface text-amber-foreground;
+  }
+
+  .dx-tag[data-hue='error'],
+  .dx-tag--error {
+    @apply bg-rose-surface text-rose-foreground;
+  }
+}

package/src/css/components/text.css

@@ -0,0 +1,124 @@
+/**
+ * Text
+ * Example: <span className='dx-text' data-hue={getHashHue(object.id)}>
+ */
+
+@layer dx-components {
+  /*
+   * System
+   */
+
+  .dx-text[data-hue='info'],
+  .dx-text--info {
+    @apply text-cyan-text;
+  }
+
+  .dx-text[data-hue='success'],
+  .dx-text--success {
+    @apply text-emerald-text;
+  }
+
+  .dx-text[data-hue='warning'],
+  .dx-text--warning {
+    @apply text-amber-text;
+  }
+
+  .dx-text[data-hue='error'],
+  .dx-text--error {
+    @apply text-rose-text;
+  }
+
+  /*
+   * Colors
+   */
+
+  .dx-text[data-hue='neutral'],
+  .dx-text--neutral {
+    @apply text-neutral-text;
+  }
+
+  .dx-text[data-hue='red'],
+  .dx-text--red {
+    @apply text-red-text;
+  }
+
+  .dx-text[data-hue='orange'],
+  .dx-text--orange {
+    @apply text-orange-text;
+  }
+
+  .dx-text[data-hue='amber'],
+  .dx-text--amber {
+    @apply text-amber-text;
+  }
+
+  .dx-text[data-hue='yellow'],
+  .dx-text--yellow {
+    @apply text-yellow-text;
+  }
+
+  .dx-text[data-hue='lime'],
+  .dx-text--lime {
+    @apply text-lime-text;
+  }
+
+  .dx-text[data-hue='green'],
+  .dx-text--green {
+    @apply text-green-text;
+  }
+
+  .dx-text[data-hue='emerald'],
+  .dx-text--emerald {
+    @apply text-emerald-text;
+  }
+
+  .dx-text[data-hue='teal'],
+  .dx-text--teal {
+    @apply text-teal-text;
+  }
+
+  .dx-text[data-hue='cyan'],
+  .dx-text--cyan {
+    @apply text-cyan-text;
+  }
+
+  .dx-text[data-hue='sky'],
+  .dx-text--sky {
+    @apply text-sky-text;
+  }
+
+  .dx-text[data-hue='blue'],
+  .dx-text--blue {
+    @apply text-blue-text;
+  }
+
+  .dx-text[data-hue='indigo'],
+  .dx-text--indigo {
+    @apply text-indigo-text;
+  }
+
+  .dx-text[data-hue='violet'],
+  .dx-text--violet {
+    @apply text-violet-text;
+  }
+
+  .dx-text[data-hue='purple'],
+  .dx-text--purple {
+    @apply text-purple-text;
+  }
+
+  .dx-text[data-hue='fuchsia'],
+  .dx-text--fuchsia {
+    @apply text-fuchsia-text;
+  }
+
+  .dx-text[data-hue='pink'],
+  .dx-text--pink {
+    @apply text-pink-text;
+  }
+
+  .dx-text[data-hue='rose'],
+  .dx-text--rose {
+    @apply text-rose-text;
+  }
+}

package/src/css/integrations/codemirror.css

@@ -0,0 +1,34 @@
+/**
+ * CodeMirror
+ * Uses @theme (not @layer) so Tailwind generates text-cm-* / bg-cm-* utility classes
+ * consumed by ui-editor. Compare: tldraw.css uses @layer to map tokens onto tldraw's
+ * own variables without generating utilities.
+ * TODO(burdon): This could move into the ui-editor package (similar to graph.css).
+ */
+
+/** TODO(burdon): Move to ui-editor */
+@theme {
+  --color-cm-codeblock: oklch(from var(--color-neutral-500) l c h / 0.1);
+  --color-cm-active-line: light-dark(
+    oklch(from var(--color-neutral-200) l c h / 0.5),
+    oklch(from var(--color-neutral-800) l c h / 0.5)
+  );
+  --color-cm-separator: var(--color-blue-500);
+  --color-cm-cursor: light-dark(var(--color-neutral-900), var(--color-neutral-100));
+  --color-cm-selection: light-dark(
+    oklch(from var(--color-blue-400) l c h / 0.5),
+    oklch(from var(--color-blue-600) l c h / 0.5)
+  );
+  --color-cm-focused-selection: light-dark(var(--color-blue-400), var(--color-blue-600));
+  --color-cm-highlight: light-dark(var(--color-neutral-950), var(--color-neutral-50));
+  --color-cm-highlight-surface: light-dark(var(--color-sky-200), var(--color-cyan-800));
+  --color-cm-comment-text: light-dark(var(--color-neutral-50), var(--color-neutral-950));
+  --color-cm-comment-surface: light-dark(var(--color-amber-800), var(--color-amber-200));
+
+  /* Markdown syntax highlighting */
+  --color-cm-code: light-dark(var(--color-stone-600), var(--color-stone-400));
+  --color-cm-code-inline: light-dark(var(--color-green-500), var(--color-green-500));
+  --color-cm-code-mark: var(--color-blue-500);
+  --color-cm-heading: light-dark(var(--color-blue-700), var(--color-blue-300));
+  --color-cm-heading-number: light-dark(var(--color-blue-600), var(--color-blue-400));
+}

package/src/css/integrations/tldraw.css

@@ -0,0 +1,14 @@
+/**
+ * Tldraw
+ */
+
+/** TODO(burdon): Move to tldraw */
+.tl-background {
+  --color-background: var(--color-base-surface);
+}
+.tl-container.tl-theme__light,
+.tl-container.tl-theme__dark {
+  --color-selected: var(--color-accent-surface);
+  --color-panel: var(--color-modal-surface);
+  --color-panel-contrast: var(--color-separator);
+}