@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.
- package/CHANGELOG.md +633 -3
- package/README.md +170 -11
- package/catalog/editor.html +1 -1
- package/catalog/index.html +48 -46
- package/gemboss-ui.css +4 -4
- package/package.json +32 -1
- package/parts/components.css +3 -3
- package/parts/core.css +1 -1
- package/parts/shell.css +2 -2
- package/src/app-nav.css +1 -1
- package/src/app-shell.css +1 -1
- package/src/assistant/chat-cards.tsx +118 -19
- package/src/assistant/chat.tsx +209 -22
- package/src/assistant/composer-menus.tsx +7 -2
- package/src/assistant/dock.ts +97 -10
- package/src/assistant/figures.tsx +119 -0
- package/src/assistant/gallery.tsx +67 -0
- package/src/assistant/hold.ts +51 -0
- package/src/assistant/host.tsx +258 -137
- package/src/assistant/ideas.tsx +90 -0
- package/src/assistant/index.ts +12 -3
- package/src/assistant/plus.tsx +61 -0
- package/src/assistant/provider.tsx +121 -24
- package/src/assistant/sessions.tsx +54 -20
- package/src/assistant/window-host.tsx +215 -0
- package/src/assistant/window.ts +120 -0
- package/src/assistant-chat.css +1 -1
- package/src/assistant-figures.css +1 -0
- package/src/assistant-hold.css +1 -0
- package/src/assistant-places.css +1 -0
- package/src/assistant-plain.js +1 -1
- package/src/assistant-plus.css +1 -0
- package/src/assistant-window-plain.js +1 -0
- package/src/assistant-window.css +1 -0
- package/src/assistant.css +1 -1
- package/src/auth-extras.css +1 -1
- package/src/auth-footer.css +1 -1
- package/src/auth-steps.css +1 -1
- package/src/auth.css +1 -1
- package/src/board-move.ts +2 -1
- package/src/chat-attachments.css +1 -1
- package/src/chat-cards-drawn.css +1 -0
- package/src/chat-cards-float.css +1 -0
- package/src/chat-cards.css +1 -1
- package/src/chat-composer-menus.css +1 -1
- package/src/chat-composer.css +1 -1
- package/src/chat-plain.js +6 -6
- package/src/chat-shortcuts.css +1 -0
- package/src/chat-voice.css +1 -1
- package/src/chat.css +1 -1
- package/src/chips-drawn.css +1 -0
- package/src/collections.css +1 -1
- package/src/collections.tsx +4 -2
- package/src/create-shell.css +1 -1
- package/src/dialog.css +1 -1
- package/src/editor/choice-cards.tsx +8 -5
- package/src/editor/controls.tsx +36 -9
- package/src/editor/field-control.tsx +17 -3
- package/src/editor/field-spec.ts +17 -4
- package/src/editor/index.ts +2 -0
- package/src/editor/media-words.ts +21 -0
- package/src/editor-color.css +1 -1
- package/src/editor-empty.css +1 -0
- package/src/editor-insert.css +1 -1
- package/src/editor-inspector-frame.css +1 -1
- package/src/editor-media.css +1 -1
- package/src/editor-picker-grid.css +1 -1
- package/src/editor-picker.css +1 -1
- package/src/editor-popover.css +1 -1
- package/src/editor-repeater.css +1 -1
- package/src/editor-tiles.css +1 -1
- package/src/editor.css +1 -1
- package/src/email-canvas.css +1 -0
- package/src/email-card.tsx +44 -0
- package/src/email-editor/canvas.tsx +109 -0
- package/src/email-editor/editor.tsx +45 -4
- package/src/email-editor/index.ts +2 -1
- package/src/email-editor/model.ts +9 -1
- package/src/email-editor.css +1 -1
- package/src/email-parts.css +1 -0
- package/src/email-parts.tsx +81 -0
- package/src/email-thumb.css +1 -0
- package/src/email-thumb.tsx +206 -0
- package/src/feedback-dialog.css +1 -0
- package/src/feedback-dialog.tsx +122 -0
- package/src/flow-strip.css +1 -0
- package/src/flow-strip.tsx +50 -0
- package/src/gemboss-field-drawn.css +1 -0
- package/src/gemboss-field.css +1 -1
- package/src/gems.css +1 -1
- package/src/icon-frame.tsx +31 -0
- package/src/icons.tsx +9 -9
- package/src/index.ts +12 -0
- package/src/job-card.css +1 -1
- package/src/kit-plain.css +1 -1
- package/src/kit-plain.js +1 -1
- package/src/language-switcher.css +1 -1
- package/src/list-page.css +1 -1
- package/src/list-page.tsx +6 -3
- package/src/list-toolbar.css +1 -1
- package/src/media-card.css +1 -0
- package/src/members.css +1 -1
- package/src/menu-extras.css +1 -1
- package/src/menu-layer.ts +2 -0
- package/src/menu-select.css +1 -1
- package/src/menu.css +1 -1
- package/src/menu.tsx +9 -4
- package/src/narration.css +1 -1
- package/src/pager-extras.css +1 -1
- package/src/pager.css +1 -1
- package/src/picture-actions.css +1 -0
- package/src/picture-actions.tsx +23 -0
- package/src/portal.css +1 -1
- package/src/question-card.css +1 -1
- package/src/rail-fold.css +1 -1
- package/src/reactions.css +1 -1
- package/src/reader-dialog.css +1 -1
- package/src/report-charts.css +1 -1
- package/src/segmented.tsx +6 -0
- package/src/service-switcher.css +1 -1
- package/src/session-rail-plain.js +1 -1
- package/src/settings-dialog.css +1 -1
- package/src/setup-guide.css +1 -1
- package/src/sheet.css +1 -1
- package/src/shell.css +1 -1
- package/src/shell.tsx +9 -2
- package/src/site.css +1 -1
- package/src/skill-card.css +1 -1
- package/src/skill-flow.css +1 -1
- package/src/skill-pages.css +1 -1
- package/src/skill-view.css +1 -1
- package/src/stage-path.css +1 -1
- package/src/stat-tile.css +1 -0
- package/src/stat-tile.tsx +39 -0
- package/src/status-list.css +1 -1
- package/src/team-chat.css +1 -1
- package/src/tray-plain.js +1 -0
- package/src/tray-search.tsx +116 -0
- package/src/tray.css +1 -0
- package/src/tray.tsx +250 -0
- 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.
|
|
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
|
|
473
|
-
|
|
474
|
-
|
|
475
|
-
|
|
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
|
|
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.
|
|
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.
|
|
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
|
-
<
|
|
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)
|
|
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
|
package/catalog/editor.html
CHANGED
|
@@ -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.
|
|
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 "@gemboss/ui/editor.css";
|
|
14
14
|
import { EditorFrame, EditorTopbar, EditorBack, EditorChatToggle, EditorPaneTabs, EditorSaveState, DeviceToggle } from "@gemboss/ui/editor";
|