@gemboss/ui 0.70.2 → 0.73.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (141) hide show
  1. package/CHANGELOG.md +633 -3
  2. package/README.md +170 -11
  3. package/catalog/editor.html +1 -1
  4. package/catalog/index.html +48 -46
  5. package/gemboss-ui.css +4 -4
  6. package/package.json +32 -1
  7. package/parts/components.css +3 -3
  8. package/parts/core.css +1 -1
  9. package/parts/shell.css +2 -2
  10. package/src/app-nav.css +1 -1
  11. package/src/app-shell.css +1 -1
  12. package/src/assistant/chat-cards.tsx +118 -19
  13. package/src/assistant/chat.tsx +209 -22
  14. package/src/assistant/composer-menus.tsx +7 -2
  15. package/src/assistant/dock.ts +97 -10
  16. package/src/assistant/figures.tsx +119 -0
  17. package/src/assistant/gallery.tsx +67 -0
  18. package/src/assistant/hold.ts +51 -0
  19. package/src/assistant/host.tsx +258 -137
  20. package/src/assistant/ideas.tsx +90 -0
  21. package/src/assistant/index.ts +12 -3
  22. package/src/assistant/plus.tsx +61 -0
  23. package/src/assistant/provider.tsx +121 -24
  24. package/src/assistant/sessions.tsx +54 -20
  25. package/src/assistant/window-host.tsx +215 -0
  26. package/src/assistant/window.ts +120 -0
  27. package/src/assistant-chat.css +1 -1
  28. package/src/assistant-figures.css +1 -0
  29. package/src/assistant-hold.css +1 -0
  30. package/src/assistant-places.css +1 -0
  31. package/src/assistant-plain.js +1 -1
  32. package/src/assistant-plus.css +1 -0
  33. package/src/assistant-window-plain.js +1 -0
  34. package/src/assistant-window.css +1 -0
  35. package/src/assistant.css +1 -1
  36. package/src/auth-extras.css +1 -1
  37. package/src/auth-footer.css +1 -1
  38. package/src/auth-steps.css +1 -1
  39. package/src/auth.css +1 -1
  40. package/src/board-move.ts +2 -1
  41. package/src/chat-attachments.css +1 -1
  42. package/src/chat-cards-drawn.css +1 -0
  43. package/src/chat-cards-float.css +1 -0
  44. package/src/chat-cards.css +1 -1
  45. package/src/chat-composer-menus.css +1 -1
  46. package/src/chat-composer.css +1 -1
  47. package/src/chat-plain.js +6 -6
  48. package/src/chat-shortcuts.css +1 -0
  49. package/src/chat-voice.css +1 -1
  50. package/src/chat.css +1 -1
  51. package/src/chips-drawn.css +1 -0
  52. package/src/collections.css +1 -1
  53. package/src/collections.tsx +4 -2
  54. package/src/create-shell.css +1 -1
  55. package/src/dialog.css +1 -1
  56. package/src/editor/choice-cards.tsx +8 -5
  57. package/src/editor/controls.tsx +36 -9
  58. package/src/editor/field-control.tsx +17 -3
  59. package/src/editor/field-spec.ts +17 -4
  60. package/src/editor/index.ts +2 -0
  61. package/src/editor/media-words.ts +21 -0
  62. package/src/editor-color.css +1 -1
  63. package/src/editor-empty.css +1 -0
  64. package/src/editor-insert.css +1 -1
  65. package/src/editor-inspector-frame.css +1 -1
  66. package/src/editor-media.css +1 -1
  67. package/src/editor-picker-grid.css +1 -1
  68. package/src/editor-picker.css +1 -1
  69. package/src/editor-popover.css +1 -1
  70. package/src/editor-repeater.css +1 -1
  71. package/src/editor-tiles.css +1 -1
  72. package/src/editor.css +1 -1
  73. package/src/email-canvas.css +1 -0
  74. package/src/email-card.tsx +44 -0
  75. package/src/email-editor/canvas.tsx +109 -0
  76. package/src/email-editor/editor.tsx +45 -4
  77. package/src/email-editor/index.ts +2 -1
  78. package/src/email-editor/model.ts +9 -1
  79. package/src/email-editor.css +1 -1
  80. package/src/email-parts.css +1 -0
  81. package/src/email-parts.tsx +81 -0
  82. package/src/email-thumb.css +1 -0
  83. package/src/email-thumb.tsx +206 -0
  84. package/src/feedback-dialog.css +1 -0
  85. package/src/feedback-dialog.tsx +122 -0
  86. package/src/flow-strip.css +1 -0
  87. package/src/flow-strip.tsx +50 -0
  88. package/src/gemboss-field-drawn.css +1 -0
  89. package/src/gemboss-field.css +1 -1
  90. package/src/gems.css +1 -1
  91. package/src/icon-frame.tsx +31 -0
  92. package/src/icons.tsx +9 -9
  93. package/src/index.ts +12 -0
  94. package/src/job-card.css +1 -1
  95. package/src/kit-plain.css +1 -1
  96. package/src/kit-plain.js +1 -1
  97. package/src/language-switcher.css +1 -1
  98. package/src/list-page.css +1 -1
  99. package/src/list-page.tsx +6 -3
  100. package/src/list-toolbar.css +1 -1
  101. package/src/media-card.css +1 -0
  102. package/src/members.css +1 -1
  103. package/src/menu-extras.css +1 -1
  104. package/src/menu-layer.ts +2 -0
  105. package/src/menu-select.css +1 -1
  106. package/src/menu.css +1 -1
  107. package/src/menu.tsx +9 -4
  108. package/src/narration.css +1 -1
  109. package/src/pager-extras.css +1 -1
  110. package/src/pager.css +1 -1
  111. package/src/picture-actions.css +1 -0
  112. package/src/picture-actions.tsx +23 -0
  113. package/src/portal.css +1 -1
  114. package/src/question-card.css +1 -1
  115. package/src/rail-fold.css +1 -1
  116. package/src/reactions.css +1 -1
  117. package/src/reader-dialog.css +1 -1
  118. package/src/report-charts.css +1 -1
  119. package/src/segmented.tsx +6 -0
  120. package/src/service-switcher.css +1 -1
  121. package/src/session-rail-plain.js +1 -1
  122. package/src/settings-dialog.css +1 -1
  123. package/src/setup-guide.css +1 -1
  124. package/src/sheet.css +1 -1
  125. package/src/shell.css +1 -1
  126. package/src/shell.tsx +9 -2
  127. package/src/site.css +1 -1
  128. package/src/skill-card.css +1 -1
  129. package/src/skill-flow.css +1 -1
  130. package/src/skill-pages.css +1 -1
  131. package/src/skill-view.css +1 -1
  132. package/src/stage-path.css +1 -1
  133. package/src/stat-tile.css +1 -0
  134. package/src/stat-tile.tsx +39 -0
  135. package/src/status-list.css +1 -1
  136. package/src/team-chat.css +1 -1
  137. package/src/tray-plain.js +1 -0
  138. package/src/tray-search.tsx +116 -0
  139. package/src/tray.css +1 -0
  140. package/src/tray.tsx +250 -0
  141. package/src/ui.css +1 -1
package/README.md CHANGED
@@ -63,6 +63,9 @@ its CSS out of the build with it (`sideEffects`). gzip of the minified file, as
63
63
  | auth-footer | `@gemboss/ui/auth-footer.css` | `packages/ui/src/auth-footer.css` | `AuthFooter`: theme, language, Help · Terms · Privacy under the sign-in card (24/10/2026) | 0.5 KB | `AuthFooter` imports it (and, through ThemeToggle and LanguageSwitcher, portal.css, theme-dark.css, language-switcher.css) |
64
64
  | auth-steps | `@gemboss/ui/auth-steps.css` | `packages/ui/src/auth-steps.css` | `AuthSteps`, `AuthStepActions`, `AuthChoices`, `AuthChips`: a sign-up of several steps (24/10/2026) | 1.0 KB | those components import it, with auth.css |
65
65
  | assistant | `@gemboss/ui/assistant.css` | `packages/ui/src/assistant.css` | the dock and the launcher | 2.2 KB | `AssistantHost`, the launcher import it |
66
+ | assistant-places | `@gemboss/ui/assistant-places.css` | `packages/ui/src/assistant-places.css` | where the assistant sits (12/11/2026): the left panel, ⋯'s places, the chat button (folded); the popup and window solid | 1.2 KB | `AssistantHost` imports it after assistant.css; a plain page links it beside assistant.css |
67
+ | assistant-window | `@gemboss/ui/assistant-window.css` | `packages/ui/src/assistant-window.css` | the floating window (12/11/2026): its ⋮⋮, its edges and corners, the drop zones while it is dragged | 1.0 KB | `AssistantHost` brings it (through `assistant/window-host.tsx`), after assistant-places.css; a plain page links it with assistant-window-plain.js |
68
+ | tray | `@gemboss/ui/tray.css` | `packages/ui/src/tray.css` | `TrayLayout`: a list docked left, its seam, one pane where only one fits (12/11/2026, the Inbox); the Assistant's thread rail's width and seam (13/11/2026) | 0.5 KB | `TrayLayout` and `SessionRail` import it; a plain page with `tray-plain.js` links it |
66
69
  | portal | `@gemboss/ui/portal.css` | `packages/ui/src/portal.css` | `TopbarNav`, `SearchDialog`, `Avatar`, `Leaderboard`, `Podium`, the `ThemeToggle` button | 2.1 KB | those components import it |
67
70
  | topnav-fold | `@gemboss/ui/topnav-fold.css` | `packages/ui/src/topnav-fold.css` | `TopbarNav`'s folded menu after the frozen bundle (unreleased): `foot`, `foldAt={760}`, `gb-topnav-unfolded`, the open tab's ellipsis | 0.3 KB | `TopbarNav` imports it (after portal.css) |
68
71
  | site | `@gemboss/ui/site.css` | `packages/ui/src/site.css` | the public site layer (0.40.0): the bar, the lockup at the site size, links, buttons, the footer | 1.0 KB | `SiteHeader` / `SiteBrand` import it; a plain-HTML page links it |
@@ -74,6 +77,7 @@ its CSS out of the build with it (`sideEffects`). gzip of the minified file, as
74
77
  | editor-inspector-frame | `@gemboss/ui/editor-inspector-frame.css` | `packages/ui/src/editor-inspector-frame.css` | `InspectorFrame`, `InspectorFrameGroup`: the settings frame every settings surface draws (search, the index of clusters, a cluster's name, a group open, a + line, added with a −) | 1.0 KB | `InspectorFrame` imports it |
75
78
  | editor-insert | `@gemboss/ui/editor-insert.css` | `packages/ui/src/editor-insert.css` | the page editor's insert menu (the + on a picked element) | 0.6 KB | admin `InsertElementMenu` imports it |
76
79
  | email-editor | `@gemboss/ui/email-editor.css` | `packages/ui/src/email-editor.css` | `EmailEditor` and `EmailPreview`: the email editor's column, rows, picker, checks pill and the mail itself (05/11/2026, unreleased) | 2.2 KB | `EmailEditor` / `EmailPreview` import it (with editor.css) |
80
+ | email-canvas | `@gemboss/ui/email-canvas.css` | `packages/ui/src/email-canvas.css` | `EmailCanvas`, the email editor's stage drawn from the real email with a block picked on it, and the brand row over the blocks (15/11/2026, unreleased) | 0.7 KB | `EmailCanvas` / `EmailEditor` import it |
77
81
  | narration | `@gemboss/ui/narration.css` | `packages/ui/src/narration.css` | the narration timeline's own: a step that selects its section, its Undo from here, the plan card pinned at the top of a turn | 0.6 KB | admin `NarrationTimeline` imports it |
78
82
  | editor-rail | `@gemboss/ui/editor-rail.css` | `packages/ui/src/editor-rail.css` | the page editor's 56px rail: the editor frame 56px in, the shell's rail beside it as icons, opened to 240px over the editor (unreleased) | 0.9 KB | admin `EditorRailToggle` imports it |
79
83
  | rail-mini | `@gemboss/ui/rail-mini.css` | `packages/ui/src/rail-mini.css` | the rail folded to 56px of icons (`railMode="mini"`, 0.62.0): rows as icons with their names out of sight, counts as dots, main at 56 | 0.6 KB | `AppNav` imports it; a surface that folds the rail without one links it |
@@ -119,6 +123,15 @@ its CSS out of the build with it (`sideEffects`). gzip of the minified file, as
119
123
  | members | `@gemboss/ui/members.css` | `packages/ui/src/members.css` | `MembersPage`: the members list of every service (chips with counts, the table with a role select per scope and the inline confirm, the drawer, Invite and the CSV check, the phone cards); the `gb-members-*` classes a plain-HTML page writes (04/11/2026, unreleased) | 2.0 KB | `MembersPage` imports it (with list-page.css, sheet.css, portal.css through the kit parts it draws); a plain-HTML page links it (README "Members") |
120
124
  | gems | `@gemboss/ui/gems.css` | `packages/ui/src/gems.css` | The four gems: `--gemboss-gem-emerald` / `-ruby` / `-amber` (sapphire is the iris accent) and the rail count in ruby. Colour with a job: ruby = look here, emerald = it is working, amber = connect and wait; never a button fill (unreleased) | 0.1 KB | the surface links it beside its core (the bundle is frozen) |
121
125
  | gem-holo | `@gemboss/ui/gem-holo.css` | `packages/ui/src/gem-holo.css` | `GemHolo`: Gem, alive, the four gems as one light that morphs and turns while Gem works; CSS only, still under reduced motion (unreleased) | 0.5 KB | `GemHolo` imports it; `@gemboss/ui/gem-holo` loads it after the page |
126
+ | media-card | `@gemboss/ui/media-card.css` | `packages/ui/src/media-card.css` | the media card (`MediaCard`, `ui-card--media`): moved out of `kit-plain.css` (15/11/2026, waits on Chris's OK, same rules, same order), part of the core AND its own file | 0.8 KB | `EmailCard` imports it; an admin page that draws `MediaCard` imports it (the admin never loads kit-plain.css) |
127
+ | email-thumb | `@gemboss/ui/email-thumb.css` | `packages/ui/src/email-thumb.css` | `EmailThumb`, an email drawn as itself in a sandboxed frame and scaled into a card, a 96×72 row or a 56×42 one; `ThumbCell`, a cell with a picture and words (15/11/2026, unreleased) | 0.6 KB | `EmailThumb` / `ThumbCell` import it |
128
+ | picture-actions | `@gemboss/ui/picture-actions.css` | `packages/ui/src/picture-actions.css` | `PictureActions`: a picture's actions on a light scrim on hover, the button on a picture (15/11/2026, unreleased) | 0.4 KB | `PictureActions` (and `EmailCard` through it) imports it |
129
+ | flow-strip | `@gemboss/ui/flow-strip.css` | `packages/ui/src/flow-strip.css` | `FlowStrip`: a flow's steps in one row, joined by arrows (15/11/2026, unreleased) | 0.5 KB | `FlowStrip` imports it |
130
+ | stat-tile | `@gemboss/ui/stat-tile.css` | `packages/ui/src/stat-tile.css` | `StatTile`, `StatTiles`: a home page's number as a card, its line and its sparkline (15/11/2026, unreleased) | 0.3 KB | `StatTile` imports it (and minichart.css through Sparkline) |
131
+ | email-parts | `@gemboss/ui/email-parts.css` | `packages/ui/src/email-parts.css` | `EmailParts`: the top and the foot of the real email beside a brand setting (15/11/2026, unreleased) | 0.5 KB | `EmailParts` imports it |
132
+ | gemboss-field-drawn | `@gemboss/ui/gemboss-field-drawn.css` | `packages/ui/src/gemboss-field-drawn.css` | a field made of parts (`.gemboss-field--group`) under a thumb or at a phone's width drawn at a Polaris field's size in its 44px box: 36, 32 from 48em under a finger (15/11/2026, its own entry: gemboss-field.css is in the frozen bundle) | 0.4 KB | a surface that draws a group links it (the admin's SettingsDialog imports it) |
133
+ | chat-cards-drawn | `@gemboss/ui/chat-cards-drawn.css` | `packages/ui/src/chat-cards-drawn.css` | a chat CTA and a page card's Open under a thumb drawn at their mouse size, 38 and 32, in their 44px box; the glow on the drawing (15/11/2026, its own entry: chat-cards.css is at its ceiling) | 0.4 KB | `chat-cards.tsx` imports it after chat-cards.css |
134
+ | chips-drawn | `@gemboss/ui/chips-drawn.css` | `packages/ui/src/chips-drawn.css` | every chip in `.ui-chips` (a link, a toggle, a static one) in the finger tier drawn at its mouse 30 in its 44px box (15/11/2026, its own entry: ui.css is in the frozen bundle) | 0.3 KB | a surface that draws `.ui-chips` links it after gemboss-ui.css (or the parts) |
122
135
  | bundle | `@gemboss/ui/gemboss-ui.css` | `gemboss-ui.css` | core + components + shell + auth + assistant + chat + portal + theme-dark | 21.9 KB | compatibility only (see CHANGELOG 0.23.0) |
123
136
 
124
137
  The core alone is 14.7 KB against 21.7 for the bundle (each part opens with a short header naming the gemboss commit, kept through minify, so a surface serving the parts can still say which commit its CSS is); a list page adds collections (4.6), a sign-in page auth (2.6).
@@ -418,7 +431,8 @@ its top edge and slides along the bottom, by pointer or keyboard, and remembers
418
431
 
419
432
  The side panel is the DEFAULT shape since 0.8.0 (Chris, 04/10/2026): a browser that never chose opens the assistant
420
433
  there, and `allowSide` defaults to true — a surface whose layout cannot make room passes `allowSide={false}` and gets
421
- the popup. The popup header has "Pin to the side", and the panel carries "Float as a popup" back; the choice is kept
434
+ the popup. ⋯'s places (12/11/2026; "Pin to the side" / "Float as a popup" rows of ⋯ before, a switcher in the header for a day) move it between
435
+ the popup, the side panel, the left panel (`allowLeft`) and full screen; the choice is kept
422
436
  under `<prefix>.shape` (the older `floatShape` key recorded the old default for everyone, so it is not read). The rail
423
437
  link reopens in that shape unless the person last worked full screen. A popup opens as tall as the window allows,
424
438
  12px under the topbar (it was min(480, viewport − 176)); a height the person dragged to is kept, and dragging it back
@@ -469,10 +483,17 @@ Its styles are the `gemboss-assistant-*` rules in `packages/ui/src/shell.css` (t
469
483
  @imports too), and they reach you through `gemboss-ui.css` together with `gemboss-field.css`. The admin passes a second tab ("Talk to a person", gemcare) through `secondTab` and its button
470
484
  through `fullActions`; a surface without those leaves them out.
471
485
 
472
- **The header's ⋯ menu (0.31.0).** The header shows four controls: + (`onNewChat`), full screen, ⋯ and ×. ⋯ holds
473
- what is used once in a while: your rows (`menuItems`, as `AssistantMenuItem`s), "Clear history" when you pass
474
- `onClearHistory` (greyed out with `canClearHistory={false}`; confirm inside your handler), then pin / float and
475
- minimise. Full screen's chrome shows ⋯ too when you pass either. Do not draw a Clear button of your own in the body.
486
+ **The header's ⋯ menu (0.31.0) and where it sits (12/11/2026).** The header shows the title, + (`onNewChat`), ⋯ and ×, nothing
487
+ else. ⋯ is a menu: first where it sits (On the right · On the left with `allowLeft` · Floating window · Full screen, the current one
488
+ checked; a place the window cannot fit is off and its row says why), then your rows (`menuItems`, as `AssistantMenuItem`s) and "Clear
489
+ history" when you pass `onClearHistory` (greyed out with `canClearHistory={false}`; confirm inside your handler). ↓ ↑ Home End move,
490
+ Enter presses, Escape closes onto ⋯. × folds a working assistant into the chat button and closes an idle one. Full screen's chrome
491
+ shows ⋯ too when you pass rows. Do not draw a Clear button of your own in the body.
492
+
493
+ **On the left (12/11/2026).** `allowLeft` offers a full-height panel on the left of the page, beside the rail; the page makes room
494
+ (`<prefix>-left` on <body>). A shell that should fold its rail while it is there reads `useAssistantPresentation()` (the admin does).
495
+ Folded, every place becomes the round chat button in the bottom-right corner, with a dot for what Gem is doing. A press reopens the last
496
+ place, unless `onButtonPress` (a prop; the plain frame's option) returns `true`: the surface opened something itself.
476
497
 
477
498
  ```tsx
478
499
  <AssistantHost title="Radar Assistant" onNewChat={reset} onExpand={expand} onShrink={shrink}
@@ -481,10 +502,12 @@ minimise. Full screen's chrome shows ⋯ too when you pass either. Do not draw a
481
502
  ```
482
503
 
483
504
  **A page with no React (0.44.0): `assistant-plain.js`.** The same frame for a server-rendered page (GemFactory's board,
484
- gemcare): the five shapes, `dock.ts`'s rules copied in ES5, the provider's storage keys, `<prefix>-side` and
505
+ gemcare): the six shapes, `dock.ts`'s rules copied in ES5, the provider's storage keys, `<prefix>-side` and
485
506
  `--gb-assistant-side-w` on `<body>`, the rail link's reopen, the ⋯ menu, the grips and their keys, and the same markup,
486
507
  so `assistant.css` draws it. `assistant-plain-browser.test.ts` holds it to `AssistantProvider` + `AssistantHost`: the same
487
- steps on both, the `.gb-dock` element compared after each one. A classic script after `kit-plain.js`:
508
+ steps on both, the `.gb-dock` element compared after each one. The floating window (12/11/2026) is a second script,
509
+ `assistant-window-plain.js`, loaded beside it with `assistant-window.css`: without it the frame draws the popup. A classic script after
510
+ `kit-plain.js`:
488
511
 
489
512
  ```html
490
513
  <script src="kit-plain.js"></script><script src="chat-plain.js"></script><script src="assistant-plain.js"></script>
@@ -505,7 +528,9 @@ Not in the plain frame yet: `secondTab`, page facts and the popup's open-chat ta
505
528
  **The thread rail, with no React (0.47.0): `session-rail-plain.js`.** `SessionRail` for the same pages: the same
506
529
  markup and classes (shell.css draws both), the search box (case and Vietnamese marks folded), the recency groups, inline
507
530
  rename, the ⋯ menu and its two-step delete. The sessions, and what opening, renaming, pinning or deleting one does, stay
508
- the page's. Hand it to the frame as `rail` and the frame builds the admin's `AssistantWorkspaceLayout` around the body:
531
+ the page's. With `tray-plain.js` loaded before the rail is made (and `tray.css` linked) its right edge is the tray's seam, as
532
+ `SessionRail`'s (13/11/2026): dragged, or the arrows (16, Shift 64), Home and End; a double-click back to 264; 240–480 and never
533
+ past the chat's 360px floor; kept per browser under `widthKey` (default `gemboss.assistant.rail`). Not on the 60px strip, not at 760 and under. Hand it to the frame as `rail` and the frame builds the admin's `AssistantWorkspaceLayout` around the body:
509
534
  the rail in full screen only, `is-dock` in the popup and the panel, the body never moved. `frame.setSwitching(true)` dims
510
535
  the page while the next thread loads; `gembossUI.fullChromeRoom(chatEl)` keeps the first message out from under the
511
536
  full-screen buttons (as `useFullChromeRoom` does for `AssistantChat`). The rail is its own file and its own ceiling (4.5 KB gzip), so a page with no full-screen
@@ -513,7 +538,8 @@ assistant does not pay for it. `assistant-plain-browser.test.ts` holds it to `Se
513
538
  the menu, rename, pin, delete, collapse, an empty list) and the framed layout to `AssistantHost` + `AssistantWorkspaceLayout`.
514
539
 
515
540
  ```html
516
- <script src="kit-plain.js"></script><script src="session-rail-plain.js"></script><script src="assistant-plain.js"></script>
541
+ <link rel="stylesheet" href="tray.css">
542
+ <script src="kit-plain.js"></script><script src="tray-plain.js"></script><script src="session-rail-plain.js"></script><script src="assistant-plain.js"></script>
517
543
  <script>
518
544
  const rail = gembossUI.sessionRail({ sessions, activeId, onNewChat, onOpen: openThread, onRename: rename,
519
545
  onDelete: remove, titleMaxLength: 120, storageKey: "gemfactory.assistant.railCollapsed" });
@@ -1469,10 +1495,31 @@ smaller and save room (GemFeedback #1099). Measured at 1280 with a mouse:
1469
1495
  | Title | 14px / 650 | 15px / 620 | **14px / 650** |
1470
1496
  | `ui-btn` in `__head` / `__foot` | 28 tall, 12px, padding 0/12 | 32, 13px, 0/16 | **28, 12px, 0/12**; 44 under a thumb or ≤ 767px |
1471
1497
  | Body / foot padding | 16 / 16 | 16/20 / 12/20 | **16 / 12/16** |
1472
- | Scrim | rgba(0,0,0,.5), no blur | .6, blur 2px | **.5, no blur** (`::backdrop` too) |
1498
+ | Scrim | rgba(0,0,0,.5), no blur | .6, blur 2px | **.5, no blur** (`::backdrop` too) until 13/11/2026; now "What lies behind a popup", below |
1473
1499
 
1474
1500
  Popup only: `--ui-control-h` stays 32, and a button outside a popup is still 32 tall.
1475
1501
 
1502
+ ### What lies behind a popup (13/11/2026)
1503
+
1504
+ Chris, 13/11/2026: "the design system has a frosted glass background under an overlay". The density above stays Polaris's; the
1505
+ scrim is the kit's own. Black .5 with no blur left the page's text as sharp as the popup's.
1506
+
1507
+ | Shape | Behind it | Rule |
1508
+ |---|---|---|
1509
+ | Centred, at a popup's width (460, `wide` 620, a picker's 960): `Dialog`, `ConfirmDialog`, `FeedbackDialog`, the portal's search, `openModal` (`.ui-overlay`) | the ink at .22, `rgba(31,30,29,.22)`, under the kit's frost, `blur(14px) saturate(1.4)` (the one the menus and the top bar wear) | `dialog.ui-modal::backdrop` in `dialog.css` and `kit-plain.css`; `.ui-overlay` in `ui.css` |
1510
+ | Beside the page: `Sheet` | `rgba(0,0,0,.3)`, no frost: the list it was opened from stays readable | `sheet.css` |
1511
+ | The size of a screen: `ReaderDialog`, `SettingsDialog` | `rgba(0,0,0,.5)`, no frost: the page is a thin frame there, so the frost would not be seen while the whole window is blurred under it for as long as it is open | `reader-dialog.css`, `settings-dialog.css` |
1512
+
1513
+ A popup built on `dialog.ui-modal`, or opened in `.ui-overlay`, is frosted unless the surface's own sheet turns the frost off by
1514
+ name for it (`backdrop-filter: none`, and the `-webkit-` one: Safari before 18 reads only that). A surface with a side panel or a
1515
+ screen-sized popup of its own does so: on the dialog's `::backdrop`, or on the overlay through `openModal({ overlayClass: "x" })` and
1516
+ `.ui-overlay.x { background: rgba(0,0,0,.5); -webkit-backdrop-filter: none; backdrop-filter: none; }` (the admin's Modal at
1517
+ `size="lg"` is the example). The fill is for a light page: the kit has no dark theme, and a dark surface keeps a darker fill in
1518
+ its own sheet (the admin's console does). Where `backdrop-filter` is missing the scrim is the ink at .22 alone. Held in
1519
+ Chromium by `modal-density.test.ts`, `kit-look.test.ts`, `confirm-dialog-browser.test.tsx` (frosted) and by the Sheet's, the
1520
+ reader's and the settings' browser tests (not frosted; each one's control runs without its sheet and finds the frost);
1521
+ `dialog-frame-one-copy.test.ts` holds the two copies of the dialog's rule equal.
1522
+
1476
1523
  `.ui-modal__body` and `.ui-modal__foot` moved from `kit-plain.css` to `ui.css`. The admin loads `ui.css` and not
1477
1524
  `kit-plain.css`, so before 0.7.3 its kit popups drew a body with no padding and two foot buttons touching
1478
1525
  (AutopilotConfirmModal). The scrolling layout of a tall popup stays in `kit-plain.css`.
@@ -1520,7 +1567,7 @@ does: keep it idempotent. A route that draws the sheet (Next's intercepting rout
1520
1567
  | Behaviour | It is `Dialog` with `ui-sheet` on it (one render tree, one hook, `useModalDialog`): Escape, ✕ and a click on the backdrop close it (a press that STARTED on the backdrop: a selection dragged out of the panel does not), `onClose` hears each once, the page behind is inert and holds still (`html:has(dialog.ui-modal:modal) { overflow: hidden }` in kit-plain.css, one rule for every modal kit popup), the panel itself takes focus on open (not the head's first link), focus goes back to the row. The subtitle describes the popup (`aria-describedby`); the name is the title alone |
1521
1568
  | Size | the full height; 560 wide, `wide` 760, from 768px up; the whole screen below that; head, ✕ and buttons at the popup's density (README "Popup density") |
1522
1569
  | Motion | slides in from the right (200 ms); none under `prefers-reduced-motion` |
1523
- | Scrim | `rgba(0,0,0,.3)`, lighter than the centred popup's `.5`: the list stays readable beside it |
1570
+ | Scrim | `rgba(0,0,0,.3)` and no frost (the centred popup frosts the page behind it, "What lies behind a popup"): the list stays readable beside it |
1524
1571
  | CSS | `sheet.css`, its own entry, loaded by the component. Every selector is `dialog.ui-modal.ui-sheet…` ((0,2,1), so it holds whatever order the sheets load in) or the page lock. It lays itself out (no padding, border-box, a column whose body scrolls), so it works on a surface that loads `ui.css` alone; the head's subtitle and actions are styled by `kit-plain.css`. A plain-HTML surface links `@gemboss/ui/sheet.css` beside `gemboss-ui.css` and opens the markup with `showModal()`, never the `open` attribute (no scrim, page not inert) |
1525
1572
 
1526
1573
  The body scrolls under a head that stays, and scrolling past its end does not scroll the list (`overscroll-behavior:
@@ -2015,6 +2062,77 @@ The surface owns where the seam sits and what it does. Five rules, each paid for
2015
2062
  React surfaces: `useResizableChatPanel` in the admin is the reference. Others write the same markup and
2016
2063
  the five rules by hand; the catalog's "Thanh kéo giữa hai cột" shows the markup.
2017
2064
 
2065
+ ## Figures under an answer: `ChatFigures` (13/11/2026, unreleased)
2066
+
2067
+ Numbers drawn under the words of a chat answer, with the line that says where they come from (Gem Plus slice 2, boards artifact
2068
+ DmPeQEJDAZXdiTxzmFv5UL: "stats, chart, source line"). The answer names one or two; the figures carry the rest. Built from the report's
2069
+ vocabulary (`ui-metrics` from ui.css, `ui-barlist` from report-charts.css, which it imports), so a report drawn later from the same
2070
+ figures looks the same. Its frame is its own entry, `@gemboss/ui/assistant-figures.css` (0.2 KB gzip).
2071
+
2072
+ ```tsx
2073
+ import { ChatFigures } from "@gemboss/ui/assistant";
2074
+ <ChatFigures title="Skincare & beauty" source="From pages and ads live in this niche…" figures={[
2075
+ { id: "carry", title: "What pages behind long-running ads carry", sub: "…", brands: "100+",
2076
+ rows: [{ key: "guarantee", label: "Money-back guarantee", proven: 60, all: 31 }] }, // bar = proven, "all pages 31%" beside it
2077
+ { id: "lands", title: "Where long-running ads land", brands: "50+", rows: [{ key: "product", label: "Product page", share: 54 }] },
2078
+ { id: "tiers", title: "Landing pages with three price cards", brands: "20+", value: 24.1, rows: [] }, // a number tile
2079
+ ]} />
2080
+ ```
2081
+
2082
+ - Shares only: every number it prints is a percentage (`figurePct`: whole from 10 up, one decimal below). The base is said as the
2083
+ surface gives it (`from 100+ brands`); the component adds no total and no date.
2084
+ - `labels` takes the surface's words (`from`, `vsAll`, `region`); English by default.
2085
+ - Colours are the chat's tokens, so the Gem Plus panel (`gb-dock--plus`) draws it in its own look.
2086
+
2087
+ ### "/" in the message box: ChatComposer `shortcuts` (13/11/2026, unreleased)
2088
+
2089
+ Questions a surface offers behind a "/" (Gem Plus slice 4: the question library). Typing "/" lists them over the text box, filtered by
2090
+ every word after the slash (the question or what it `sub` says it gets), six at most. ↑/↓ move, Enter or Tab (or a press) put the
2091
+ question in the box to edit or send, Escape closes the list. No `shortcuts`: "/" is a character, nothing changes.
2092
+
2093
+ ```tsx
2094
+ <ChatComposer value={draft} onChange={setDraft} onSend={send}
2095
+ shortcuts={[{ label: "How is my market moving this month?", sub: "Gets: numbers", prompt: "How is my market moving this month?" }]} />
2096
+ ```
2097
+
2098
+ ### Real pages under an answer: `ChatPageGallery` (13/11/2026, unreleased)
2099
+
2100
+ Pictures to choose by, two to a row, each with its label, a line of what it shows and one **Use this layout** link (Gem Plus slice 3).
2101
+ Same entry as `ChatFigures` (`assistant-figures.css`, 0.45 KB gzip with both).
2102
+
2103
+ ```tsx
2104
+ import { ChatPageGallery } from "@gemboss/ui/assistant";
2105
+ <ChatPageGallery title="Advertorials that work in Pet" onUse={(href) => navigate(href)}
2106
+ pages={[{ label: "Real advertorial 1", meta: "Advertorial · 3 ads seen in the last 30 days", thumb_url, href }]} />
2107
+ ```
2108
+
2109
+ - The button is a real link (`href`): a plain press calls `onUse(href)`, a modified click opens a new tab.
2110
+ - A tall page's picture shows its top, cropped at 4:5. The component says only what it is given: whether a card may name whose page
2111
+ it is, is the surface's call (the admin never does).
2112
+
2113
+ ## Gem Plus: `ChatPlusChip` and AssistantHost `plus` (13/11/2026, unreleased)
2114
+
2115
+ A mode switch for a chat that can answer about the market as well as the store (Gem Plus boards, artifact
2116
+ DmPeQEJDAZXdiTxzmFv5UL; Chris: "đúng chính xác rồi làm đi"). Its own entry, `@gemboss/ui/assistant-plus.css`, imported by both
2117
+ pieces: every surface that draws AssistantHost loads it (1.1 KB gzip, the host writes `gb-dock--plus`).
2118
+
2119
+ ```tsx
2120
+ import { AssistantHost, ChatPlusChip } from "@gemboss/ui/assistant";
2121
+ <ChatComposer stacked rows={1} tools={<ChatPlusChip state={locked ? "locked" : on ? "on" : "off"} onPress={press} />} … />
2122
+ <AssistantHost plus={on} gold={hasPlan && !on} …>…</AssistantHost>
2123
+ ```
2124
+
2125
+ - `ChatPlusChip` sits in the composer's `tools`, on the right beside the microphone and send, with the box `stacked` so the words keep
2126
+ their whole row (13/11/2026; it was in `leading`, where it took the words' room): 28px under a mouse, 44px under a finger or below
2127
+ 768. `locked` is a door (`aria-haspopup="dialog"`, a lock, no `aria-pressed`): the surface opens its way up; `off` / `on` are a
2128
+ switch. Its words are props (`labels`); what Plus does and who may have it are the surface's.
2129
+ - The chip says Research (Chris 13/11/2026: Gem Plus's mode, "bật lên là nó thành màu đen"). `AssistantHost gold` adds `gb-dock--gold`:
2130
+ the plan's chat while Research is off, light on an ivory ground with gold trim (accents, primary button, header rule, the chip's
2131
+ outline). `plus` wins over `gold`.
2132
+ - `AssistantHost plus` adds `gb-dock--plus`: the panel restates its tokens (obsidian and gold), both `--gemboss-*` and `--ui-*` (the
2133
+ kit computes `--ui-*` once on `:root`, so they would not follow), so every part of the chat follows without a rule of its own. Only
2134
+ colours written as literals elsewhere get a rule: the seller's bubble, the answer's primary button, the header's switch.
2135
+
2018
2136
  ## The assistant launcher (0.4.2; not floating since 0.6.0)
2019
2137
 
2020
2138
  The top-right corner of the topbar is the ACCOUNT (`AccountMenu`). The assistant button is NOT a floating button: 0.4.2
@@ -3306,6 +3424,47 @@ import { emailChecks, type EmailDraft } from "@gemboss/ui/email-editor/model"; /
3306
3424
  - Classes: `gb-emailed-*` (the editor), `gb-email-*` (the mail); every one drawn is styled by `email-editor.css`
3307
3425
  (`email-editor.test.tsx`).
3308
3426
 
3427
+ ## Emails as themselves (15/11/2026, unreleased): `EmailThumb`, `EmailCard`, `PictureActions`, `ThumbCell`, `FlowStrip`, `StatTile`, `EmailParts`
3428
+
3429
+ GemBoss Reach and GemReach's Ops console show a store's emails as the emails they are (canvas NqQGmVzRJMjv536LLbMGaT, Chris
3430
+ 15/11/2026: rows K–U, J2 Q9 "an iframe first, a PNG later"). The pieces the boards marked "kit cần thêm":
3431
+
3432
+ - **`EmailThumb`** draws one email's HTML (GemReach's `GET /t/v1/templates/:id/thumbnail`: the store's brand kit, a sample person,
3433
+ the marketing footer) in an iframe with `srcdoc` and `sandbox=""` (no script runs), laid out at 664px (GemReach's mail turns
3434
+ into its phone layout at 620 and under) and scaled into its box with a transform. `size`: `fill` (a card's 4:3 picture), `list`
3435
+ (96×72), `sm` (56×42). With `load`, nothing is asked until the box is within 200px of the screen, at most four at a time on a
3436
+ page, and `cacheKey` keeps the answer for the page. While it comes: the skeleton sheen; an email that does not draw: an envelope.
3437
+ `frameCss` (default `EMAIL_THUMB_FRAME`) puts it on white from the top of its card.
3438
+
3439
+ ```tsx
3440
+ <EmailThumb title="Welcome to Lumen" cacheKey={`${id}@${version}`} load={() => fetch(url).then((r) => r.ok ? r.json() : null).then((b) => b?.html ?? null)} />
3441
+ ```
3442
+ - **`EmailCard`**: the kit's `MediaCard` at 4:3 with an `EmailThumb` as its picture, its name as the link, ONE meta line ("Welcome
3443
+ flow"; "· Transactional" there, never a chip), its state as a tag, and `actions` on the picture on hover. `frame` puts a Stage
3444
+ around the email (a recipe card). It imports `media-card.css`, since the admin never loads kit-plain.css.
3445
+ - **`PictureActions`**: two or three buttons on a light scrim (`rgba(27, 28, 30, .07)`) over the whole picture, in MediaCard's `menu`
3446
+ slot, shown on hover or when a key reaches them. A secondary `ui-btn` in it is white with a small shadow: the button on a picture.
3447
+ Not drawn under a finger (`hover: none`): the tap opens the card.
3448
+ - **`ThumbCell`**: a table cell or a row's start with a picture: the thumb, the name in bold with its context muted after a middle
3449
+ dot, one line under it (a `FlowStrip`, a subject).
3450
+ - **`FlowStrip`**: a flow's steps as an ordered list of 24px pills joined by arrows: `start` in ink, `wait` grey, `email` on the
3451
+ iris tint (its words for a screen reader only), `split` white; `max` ends in "+N"; `md` a size up.
3452
+ - **`StatTile` / `StatTiles`**: a label, the number (24/32 bold), one line (`tone="up"` in the success colour), the sparkline when
3453
+ there is a series; three in a row, one column on a phone. The kit's `ui-stat` stays the pill in a row of figures.
3454
+ - **`EmailParts`**: "In every email · as sent": the email's first row (the logo) and its last (the address, the links), each in its
3455
+ own frame, `sandbox="allow-same-origin"` only so the page can read the part's height (still no script); `mark` rings the foot in
3456
+ the warning tone, `note` says why.
3457
+
3458
+ `email-thumb-browser.test.tsx` holds the drawing to Chromium: the frame fills its box, the grey is gone, a far card does not ask,
3459
+ and no script in an email runs (with its negative controls).
3460
+
3461
+ ### The stage is the real email (15/11/2026, unreleased): `EmailCanvas`, `EmailEditor canvas="real"`
3462
+
3463
+ `EmailEditor` with `canvas="real"` draws its stage from `sent.html` (the sender's preview of the unsaved words, with `data-gr-block` marks) in
3464
+ `EmailCanvas`: an iframe with `sandbox="allow-same-origin"` only (no script runs; the editor reads the frame's layout and hears its clicks), a
3465
+ click picks a block, the picked block is ringed on its own box with its name and Edit · ↑ · ↓ · Delete outside it, Desktop (640) or Mobile
3466
+ (390 in a phone's frame), Dark. `brandRow` (`logo`, `color`, `edit`) tops Sections with what the brand kit puts in every email.
3467
+
3309
3468
  ## Members (04/11/2026, unreleased): `MembersPage`, one members list for every service
3310
3469
 
3311
3470
  Chris approved the pattern on 04/11/2026 (design "GemBoss Members Pattern"): GemCommunity Admin › Members, GemCare People and
@@ -8,7 +8,7 @@
8
8
  .cat-code summary{padding:10px 16px;font-size:13px;cursor:pointer;color:var(--gemboss-text-muted);border-top:1px solid var(--gemboss-divider);min-height:24px}
9
9
  .cat-code pre,.cat-api{margin:0;padding:12px 16px;overflow:auto;background:#0f1012;color:#e8e8e6;font-size:12px;line-height:1.5;border-radius:0}
10
10
  .cat-api{border-radius:12px;margin:0 0 16px}</style></head><body><div class="cat">
11
- <h1>@gemboss/ui 0.70.2 · Editor</h1>
11
+ <h1>@gemboss/ui 0.73.0 · Editor</h1>
12
12
  <p>Khung của mọi editor: <code>EditorFrame</code> (cột trái · khe kéo · preview · cột phải dock trên mép phải preview) và <code>EditorTopbar</code> (← · tiêu đề · cụm giữa · cụm phải · dòng trạng thái). Là đúng khung của theme / page / section editor trong admin. Gói chỉ vẽ KHUNG; chat, Configure, canvas, page picker, menu, Publish là của editor, đi vào bằng slot. Trang HTML thuần nạp <code>editor.css</code> + <code>editor-plain.js</code> rồi gọi <code>gembossUI.initEditorFrame()</code>: kéo khe (chuột, chạm, phím mũi tên / Home / End), đổi thiết bị, mở ⋯ và Publish ▾, ẩn cột trái, Chat | Preview trên điện thoại. <a href="index.html">← Catalog</a></p>
13
13
  <h2>React</h2><pre class="cat-api"><code>import &quot;@gemboss/ui/editor.css&quot;;
14
14
  import { EditorFrame, EditorTopbar, EditorBack, EditorChatToggle, EditorPaneTabs, EditorSaveState, DeviceToggle } from &quot;@gemboss/ui/editor&quot;;