@gemboss/ui 0.61.0 → 0.64.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 (45) hide show
  1. package/CHANGELOG.md +153 -0
  2. package/README.md +163 -2
  3. package/catalog/editor.html +1 -1
  4. package/catalog/index.html +3 -3
  5. package/gemboss-ui.css +3 -3
  6. package/package.json +15 -1
  7. package/parts/components.css +3 -3
  8. package/parts/core.css +1 -1
  9. package/parts/shell.css +1 -1
  10. package/src/app-nav.css +1 -0
  11. package/src/app-nav.tsx +236 -0
  12. package/src/assistant/chat.tsx +67 -4
  13. package/src/assistant/dictation.ts +292 -0
  14. package/src/assistant/index.ts +4 -1
  15. package/src/audiences-table.css +1 -0
  16. package/src/audiences-table.tsx +167 -0
  17. package/src/chat-voice.css +1 -0
  18. package/src/editor/frame-context.ts +9 -0
  19. package/src/editor/index.ts +8 -0
  20. package/src/editor/inspector-frame.tsx +285 -0
  21. package/src/editor/label-side.ts +79 -0
  22. package/src/editor/panel.tsx +23 -6
  23. package/src/editor/repeater.tsx +9 -3
  24. package/src/editor-inspector-frame.css +1 -0
  25. package/src/editor.css +1 -1
  26. package/src/email-editor/editor.tsx +434 -0
  27. package/src/email-editor/index.ts +16 -0
  28. package/src/email-editor/model.ts +357 -0
  29. package/src/email-editor/preview.tsx +208 -0
  30. package/src/email-editor.css +1 -0
  31. package/src/gem-at-work.css +1 -0
  32. package/src/gem-at-work.ts +1165 -0
  33. package/src/index.ts +17 -1
  34. package/src/kit-plain.css +1 -1
  35. package/src/rail-mini.css +1 -0
  36. package/src/report-charts.css +1 -0
  37. package/src/shell.tsx +36 -8
  38. package/src/skill-feedback.css +1 -0
  39. package/src/skill-feedback.tsx +67 -0
  40. package/src/skill-history.css +1 -0
  41. package/src/skill-history.tsx +116 -0
  42. package/src/skill-pages.css +1 -0
  43. package/src/skill-pages.tsx +204 -0
  44. package/src/skill-tabs-group.tsx +45 -0
  45. package/src/skill-view.tsx +7 -1
package/CHANGELOG.md CHANGED
@@ -4,6 +4,159 @@ Versions up to 0.9.0 are described in the README, each in the section that intro
4
4
 
5
5
  ## Unreleased
6
6
 
7
+ ## 0.64.0 (08/11/2026)
8
+
9
+ **Gem at work: where the work is, the crew is** (08/11/2026; Chris 06/11: "vấn đề ở đâu nhiều thì con trỏ liên quan hoạt động nhiều hơn").
10
+ - `GemActivity.trades` (optional, still contract v1) and the `GemTrade` type: how much of a step's work is words, layout, pictures, buttons, the look or a check.
11
+ - The crew follows it: the warmest trades (cooling by half every 45 s) come beside the work ahead of the usual pair, walk more of the beats and say what they fix; still four on the page at most.
12
+
13
+ **Skill rows: `when` and a node `note`** (08/11/2026; the reviews of gemlabs #1597 and gemboss #6873 found content-radar working
14
+ around both). `SkillFeedbackRow.when`: right after `who`, in the quiet small type (`.ui-skillfb__when`), for when a comment was left and
15
+ its state (Fixed, Resolved): no longer inside the bold name. `SkillVersionRow.note` is a node (phrasing content: text, or a `<span>`
16
+ per line), so a surface can add what the version changed under its note.
17
+
18
+ **Speak instead of typing** (08/11/2026, UI book B15-voice; Chris 07/11: "Browser speech"). The browser's own speech to text (the Web
19
+ Speech API) in the chat composer, once, for every chat that types into it. Moved from the admin (lib/dictation.ts, lib/use-dictation.ts).
20
+ - `ChatComposer` `voice` (`true` or `{ lang, silenceMs, firstWordsMs }`): a microphone after the tools (44px at every pointer), what is said
21
+ written into the box as it is said (interim results) after what was typed and editable, pressing again or a pause (6 s after the last
22
+ words) stops, typing / Send / the box turning off stops it at once. A line over the text box while it listens ("Listening" and
23
+ `DICTATION_NOTE`: "Your browser turns your voice into text. In Chrome this goes through Google.") or when it failed (a blocked microphone
24
+ says where the switch is; an error mid-way says the text is kept). Never sends. No button where the browser has no recognition, or the
25
+ page's frame may not use the microphone. `aria-pressed`, one label; the ring round it pulses unless motion is reduced.
26
+ - `AssistantChat` `voice`: passed to its composer, so a surface drawing the package's whole chat turns the mic on the same way.
27
+ - A stop the browser never ends (Safari, a dropped speech service) is ended after 2 s and says so; a second press ends it at once.
28
+ - `voice.likelyLang` (and `dictationLanguage`'s third argument): a language only guessed, used where the browser lists it.
29
+ - `useDictation`, `useCanDictate`, `canDictate`, `appendDictated`, `dictationLanguage`, `dictationProblemText`, `DICTATION_NOTE`
30
+ (`@gemboss/ui/assistant`, and `@gemboss/ui/assistant/dictation` with no CSS on the way) for a box that is not a chat.
31
+ - `chat-voice.css` (new entry, imported by `ChatComposer`): the microphone and its line. Not in `gemboss-ui.css` (frozen).
32
+ - `ChatLabels` gains `speak`, `stopListening`, `listening`.
33
+
34
+ ## 0.63.0 (08/11/2026)
35
+
36
+ **Skills pages, as content-radar drew them** (found switching content-radar to these parts, its before and after rendered side
37
+ by side): the QA judge chip is purple (`#f1ebfd` / `#5b2fc0`: the tokens it named are the ink and a grey); a tab group's
38
+ current page keeps its underline; a section's action link ("Source file") is 24px on a finger; only a Markdown table the
39
+ surface did not wrap scrolls itself (`.ui-skilldoc__md > table`), so a wrapped one keeps its full width.
40
+
41
+ - `useKeyedRows` (07/11/2026): a stored list is compared with our writes in one key order (`spelled`), so a write the store answers in its own spelling (Postgres JSONB orders an object's keys by length) is that write coming back. Read as a change from elsewhere, it dropped the newer write still on its way: of two quick Adds in the page editor's elements fold, one was lost.
42
+
43
+ **Skills pages** (07/11/2026, Chris: the Skills pages of GemBoss admin and content-radar draw from one kit). Content-radar's Skills
44
+ pages, taken into the kit so GemBoss admin and content-radar draw the same parts. Links go through `renderLink: SkillLinkRender`
45
+ (next/link, a PendingLink or a plain `<a>`), so the parts need no router and render on the server.
46
+ - `skill-pages.css` (new entry): `SkillsTabs` (Skills · Rules · Building blocks; a tab may be a group with a menu), the Rules book
47
+ (`SkillRuleSummary` counts, `SkillRuleSection`, `SkillGuardGroups` a card per group, `SkillCheckTable` with `wide: "rule" | "check"`,
48
+ `SkillRuleChip`, `SkillRuleLevel`) and Building blocks (`SkillLayerList`, `SkillDocJump`, `SkillDoc`, `SkillDocHistory`). On a coarse
49
+ pointer or a narrow screen its controls are 44px and its list links 24px. A section's link in a `.ui-tabs` row may be
50
+ `aria-current="true"` (drawn as current, rule in this entry: gemboss-ui.css is frozen).
51
+ - `skill-feedback.css` (new entry): `SkillFeedbackList` (rows of badges, who, aside, a quote, a body, fine print, actions),
52
+ `SkillFeedbackBar`, `SkillFeedbackHead`.
53
+ - `skill-history.css` (new entry, 05/11/2026): `SkillVersionList`, `SkillDiff`, `SkillChangeCard`, a skill pack's History.
54
+ - `SkillRuleHoldChip` (skill-view.tsx): the chip saying how a rule is held, one owner for `SkillRuleList` and the Rules book.
55
+
56
+ - `report-charts.css` (06/11/2026, Chris's OK): `ui-barlist`, `ui-chart` and `ui-legend` move out of `kit-plain.css` to their own entry just before it in the core, the same rules in the same order, so an admin page can import them. Plain-HTML surfaces load what they did.
57
+
58
+ **Gem at work** (05/11/2026, ADR 0013): `createGemAtWork`, what Gem is doing drawn on the page it is doing it to: Gem's crew (Gem
59
+ and six experts, each an arrow and a name), a ring naming the block, the box dragged at its real size, the words written into the
60
+ block itself, sections a build adds stacked as soft cards in the page's column (the page makes room for them, so its footer moves
61
+ down), and `reveal(ids?)` building the saved sections in, two or three of the crew at once each dragging a block's box out, a
62
+ picture coming up through its tint. The calm clock draws each step long enough to be seen and words at reading pace, trailing Gem
63
+ but never leading it (`clock: "live"` for each activity as it arrives; `idle()` resolves once it has caught up). `catchUp(activities)` draws a turn's
64
+ past at once with nothing moving, for a frame that joins mid-turn (the person switched between Page and Canvas). It reads only the
65
+ activity contract v1 (`GemActivity`, exported here as the contract's one body), finds blocks by `data-gem-el-id` /
66
+ `data-gem-section-id`, steps down a ladder it reports through `onFallback`, and puts back every word and style it touched. Only
67
+ transform, opacity and clip-path move. New entry `gem-at-work.css`; browser test `gem-at-work-browser.test.ts` (in `test:ui-browser`).
68
+
69
+ **One settings frame** (one settings frame slice 1, 06/11/2026; Chris found three frames around one set of settings controls). The
70
+ element panel's frame is the standard, taken out of the admin's ElementNodePanel into the kit as it was (same classes' rules, same
71
+ markup, its own part):
72
+
73
+ Added
74
+ - `InspectorFrame` (`@gemboss/ui/editor`, `editor/inspector-frame.tsx`): `div.gemboss-ei-frame[data-settings-frame]` (display: contents)
75
+ › the host's head › `InspectorSearch` › the index of clusters (`nav.gemboss-ei-index[data-settings-index]`, Look · Layout · Visibility ·
76
+ Code, one press to each, the one the panel stands in marked as it scrolls) › an aside › the lead › each cluster's name
77
+ (`InspectorClusterBreak`, `[data-panel-cluster]`) and its groups. A search's results take the place of the index, the lead and the clusters.
78
+ - `InspectorFrameGroup`: a group in one of three states, one element for the three (a chip pressed keeps its place and the focus):
79
+ `open` (its name), `add` (its name and a +, a pill when marked `chip` in an `InspectorChips` run), `added` (its rows, a −, small actions).
80
+ - `INSPECTOR_CLUSTERS`, `InspectorSearch`, `InspectorClusterBreak`.
81
+ - `InspectorFrame` `searching`: a search shown in place (the index and the clusters' names hidden, the lead kept, nothing drawn again), and
82
+ `InspectorFramePart`: a part that is not a group (a section's words), in its place, `hidden` while a search does not find it.
83
+
84
+ Changed
85
+ - `InspectorGroup` `collapsible={false}` inside an `InspectorFrame` is the frame's open group (`.gemboss-ei-grp` › `.gemboss-ei-openhead`),
86
+ decided by InspectorGroup itself (`editor/frame-context.ts`); outside a frame it is the form's static group as before.
87
+ - Its own part `editor-inspector-frame.css` (0.9 KB gzip, ceiling 1,351 B): only a surface that draws the frame loads it.
88
+
89
+ **A store's audiences** (05/11/2026, board GroupsTable on the canvas "Một lõi, ba cửa"; Chris: one word and one list, Audiences. GemBoss
90
+ › Reach › Audiences, and GemReach's own admin after it).
91
+
92
+ Added
93
+ - `AudiencesTable` (`rows`: `name`, `source`: `site` | `email` | `imported` | `gemcare`, `sync`, `onSite`, `canEmail`, `delta`, `deltaTone`,
94
+ `usedBy`, `href`; `labels`, `linkAs`, `flush`, `state`), on `IndexTable`: Audience with its source chip and sync note, On site (a dash
95
+ where there is no count), Can email (a dash where it is not known), 7 days (toned by its sign) and Used by, the whole row opening the audience. `audienceDeltaTone`,
96
+ `audienceCount`, `audiencesTableColumns`, `audiencesTableRows`, `AudienceSourceChip` and `AUDIENCES_TABLE_LABELS` beside it. Its own entry,
97
+ `@gemboss/ui/audiences-table.css`.
98
+
99
+ **The email editor** (05/11/2026, Chris approved canvas JQkjqVVb "Email editor": "editor thư theo bố cục Page editor").
100
+
101
+ Added
102
+ - `@gemboss/ui/email-editor`, its own entry: `EmailEditor` (the page editor's layout: ← back to where it was opened, name and
103
+ Draft · version, Desktop · Mobile and Dark, "Send me a test", Save; ONE resizable left column with Chat · Sections · Settings, the
104
+ chat a slot that stays mounted; the mail on the stage; "+" under the picked block, at the end and in Sections; ↑ ↓ and Alt+↑ ↓;
105
+ nothing dragged; a checks pill), `EmailPreview`, and the model (`@gemboss/ui/email-editor/model`, pure): GemReach's block list as
106
+ it is (src/templates/blocks.ts at a341451) plus two proposals, `products` (this person's order, cart or views; GemReach #106) and
107
+ `review` (the GemReview ask). "Heading + text" is GemReach's `hero` without a picture. The button's personal link is
108
+ `{{funnel_url}}`, the link GemReach signs when it builds the mail (72 h). `emailChecks` runs 18 of GemReach's checks by their ids
109
+ until the server's replace them (`checks` prop).
110
+ - `email-editor.css`, its own entry (2.2 KB gzip), imported by `EmailEditor` and `EmailPreview`.
111
+
112
+ **Where a label goes is its control's, in one table** (Chris 04/11 and 05/11/2026: label left, control right for every one-value
113
+ setting, as GemPages; only a long text, a list, a spacing box, media, a gradient's editor or a drawing under its label). Measured before:
114
+ 98 hand-built labelled rows in 30 admin files, each deciding its side; every label on the wrong side was in one of them
115
+ (`_local/gemboss/label-beside-audit-2026-11-05.md`).
116
+
117
+ Added
118
+ - `LABEL_SIDE`, `labelSide(control)`, `isFieldControlKind`, `FieldControlKind`, `LabelSide` (`@gemboss/ui/editor`, `editor/label-side.ts`, no
119
+ React): the one table. A one-line text box, a link and a date are beside their label now, as a list is; a line of code (`code`) is
120
+ above. `screens` and `font-pick` are above until those controls are reworked (three device glyphs; the font as a list).
121
+ - `Field` `control`: the control the field holds; its label goes on that control's side. `row` is deprecated (kept for a surface pinned
122
+ to an older kit; ignored when `control` is given).
123
+
124
+ Changed
125
+ - **Layout change for any surface that sets `row` (or a `--row` class) outside an inspector group:** the row CSS is no longer scoped
126
+ to `.gemboss-ei-grp` / `.gemboss-ei-group`. A `.gemboss-ei-fld--row` is laid out as a row (label 2 parts, control 3) wherever it is,
127
+ at the same specificity as the scoped rules. Before, outside a group it drew its label above (the admin's page settings drawer: Store
128
+ header, Store footer, Font loading asked for a row and stacked).
129
+ - A row's notes (`.gemboss-ei-hint` children: its help, a limit or a count, what a link opens) run across the field under the row
130
+ instead of the control column, outside a group and inside one alike (a group's help shows there once its ? is pressed).
131
+
132
+ Removed
133
+ - `.gemboss-ei-addrow`: nothing has drawn it since gemboss #5042 (searched gemboss, gemfactory, gemcare, gempress, gemlabs,
134
+ gemcommunity on 05/11/2026). Removing it keeps `editor.css` under its weight ceiling with the rules above (8,733 → 8,719 B gzip,
135
+ ceiling 8,730).
136
+ - `.gemboss-ei-range` has no side margins: a full-width slider in a row ran 2px past its field.
137
+
138
+ ## 0.62.0 (05/11/2026)
139
+
140
+ **A section that opens as an app of its own: the rail folds to its icons, and the section brings its own grey nav** (Chris 05/11/2026:
141
+ "vào plugin co sidebar menu lại thành dạng thanh icon … để toàn bộ không gian cho plugin", "mọi plugin nên tổ chức như cách bạn tổ chức cho
142
+ gempersonalizer … visual ko đánh nhau với thanh icon"; canvas https://claude.ai/artifact/Hsou4RYohWWXpzv1jHbtYZ, direction A). Not
143
+ published: the admin reads the workspace package; publishing for other surfaces is Chris's call.
144
+
145
+ Added
146
+ - `railMode` on `AppShell` and `Shell` (`"full"` | `"mini"`, type `RailMode`): `mini` puts `data-rail="mini"` on the shell and, from
147
+ 761px, folds the rail to 56px of icons (32px rows under a mouse, 44 under a finger, as the page editor's closed rail), `main` and the
148
+ holding cover start at 56, and so does Gem full screen or pinned below 1100. A `RailItem` with a label in words takes it as `title`
149
+ and `aria-label` (not the `aria-label` when a count follows it, so the count stays in its name); the label stays in the markup, out
150
+ of sight, shown beside the rail on keyboard focus. `RailCount` is a dot, its count in its `aria-label`. Sub rows and headings go;
151
+ the phone's drawer is the full rail. `full`, the default, adds nothing to the markup. Its own entry, `@gemboss/ui/rail-mini.css`,
152
+ brought by `AppNav`.
153
+ - `AppNav` (`identity`: icon, name, status, `tone`; `groups[{ heading?, items[{ label, href, current?, count?, badge?, badgeLabel? }] }]`;
154
+ `foot`; `onSwitch` / `switchMenu` / `switchLabel` / `switchHeading`; `linkAs`; `onItemClick`), `AppNavLink` (a foot row), `AppNavPublish`
155
+ ("N changes not live" + Publish, or "Live on your store"), `AppNavSwitchRow` (a row of the switcher's menu: dot, name, note) and `AppNavFrame` (the nav beside the
156
+ page's 900 column; the shell's main gives up its gutter for it). Words only, 216 wide on a new token, `--gemboss-appnav-bg`
157
+ (#f6f6f7, declared in the entry: gemboss-ui.css is frozen); at 768px and below the header and one row of chips. Its own entry,
158
+ `@gemboss/ui/app-nav.css` (1.7 KB gzip).
159
+
7
160
  ## 0.61.0 (05/11/2026)
8
161
 
9
162
  **The skills UI without content-radar's overrides** (04/11/2026: the four kit gaps content-radar's move to 0.59.0 found, gemlabs
package/README.md CHANGED
@@ -72,12 +72,17 @@ its CSS out of the build with it (`sideEffects`). gzip of the minified file, as
72
72
  | editor-repeater | `@gemboss/ui/editor-repeater.css` | `packages/ui/src/editor-repeater.css` | `RepeaterList`: a setting that is a list, as rows | 0.9 KB | `RepeaterList` imports it |
73
73
  | editor-tiles | `@gemboss/ui/editor-tiles.css` | `packages/ui/src/editor-tiles.css` | `ChoiceTiles`: a closed choice of shapes as picture tiles | 0.5 KB | `ChoiceTiles` imports it |
74
74
  | editor-chips | `@gemboss/ui/editor-chips.css` | `packages/ui/src/editor-chips.css` | `InspectorChips`: a run of inspector groups where one holding nothing is a chip | 0.4 KB | `InspectorChips` imports it |
75
+ | 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 −) | 0.9 KB | `InspectorFrame` imports it |
75
76
  | 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 |
77
+ | 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) |
76
78
  | 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 |
77
79
  | 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 |
80
+ | 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 |
81
+ | app-nav | `@gemboss/ui/app-nav.css` | `packages/ui/src/app-nav.css` | `AppNav`, `AppNavFrame`: a section's own grey nav beside the folded rail, and its chips on a phone (0.62.0) | 1.7 KB | `AppNav` imports it (with rail-mini.css) |
78
82
  | reactions | `@gemboss/ui/reactions.css` | `packages/ui/src/reactions.css` | the emoji reactions and their picker | 0.8 KB | `Reactions` / `ReactionPicker` import it |
79
83
  | assistant-engine | `@gemboss/ui/assistant-engine.css` | `packages/ui/src/assistant-engine.css` | the engine picker (chip + Settings › AI & engines) and the bridge notice | 1.9 KB | `EnginePicker` / `EngineSettings` / `BridgeNotice` import it |
80
84
  | chat | `@gemboss/ui/chat.css` + `chat-composer.css` | `packages/ui/src/chat.css`, `packages/ui/src/chat-composer.css` | the chat body, the composer | 3.0 + 0.9 KB | the chat components (0.29.0); a page writing the markup links them |
85
+ | chat-voice | `@gemboss/ui/chat-voice.css` | `packages/ui/src/chat-voice.css` | the composer's microphone (`ChatComposer` `voice`) and its line over the text box (B15-voice, 08/11/2026) | 0.7 KB | `ChatComposer` imports it |
81
86
  | assistant-chat | `@gemboss/ui/assistant-chat.css` | `packages/ui/src/assistant-chat.css` | the chat pieces the package draws (0.29.0): column, starters that wrap, meta, errors, notes, paperclip | 0.9 KB | `AssistantChat` and its pieces import it |
82
87
  | minichart | `@gemboss/ui/minichart.css` | `packages/ui/src/minichart.css` | `Sparkline`, `ShareBar` (0.30.0) | 0.5 KB | those components import it |
83
88
  | setup-guide | `@gemboss/ui/setup-guide.css` | `packages/ui/src/setup-guide.css` | `SetupGuide` (0.30.0) | 0.9 KB | `SetupGuide` imports it |
@@ -91,6 +96,7 @@ its CSS out of the build with it (`sideEffects`). gzip of the minified file, as
91
96
  | range-bar | `@gemboss/ui/range-bar.css` | `packages/ui/src/range-bar.css` | `RangeBar`: a value against a market's spread on one axis (0.43.0) | 0.6 KB | `RangeBar` imports it |
92
97
  | progress-ring | `@gemboss/ui/progress-ring.css` | `packages/ui/src/progress-ring.css` | `ProgressRing`: "3 of 5" as a ring (0.43.0) | 0.2 KB | `ProgressRing` imports it |
93
98
  | progress-bar | `@gemboss/ui/progress-bar.css` | `packages/ui/src/progress-bar.css` | `ProgressBar`: how far along, a thin bar a screen places anywhere (unreleased) | 0.3 KB | `ProgressBar` imports it |
99
+ | audiences-table | `@gemboss/ui/audiences-table.css` | `packages/ui/src/audiences-table.css` | `AudiencesTable`: a store's audiences (source chip, On site, Can email, 7 days, Used by), GemBoss Reach and GemReach's admin (unreleased) | 0.4 KB | `AudiencesTable` imports it, with IndexTable's collections.css |
94
100
  | spot-art | `@gemboss/ui/spot-art.css` | `packages/ui/src/spot-art.css` | `SpotArt`: six brand pictures for pauses and empty states (0.43.0) | 0.4 KB | `SpotArt` imports it |
95
101
  | kind-art | `@gemboss/ui/kind-art.css` | `packages/ui/src/kind-art.css` | `KindArt`: the cream strip across the top of a "pick a kind" card, one bold drawing per kind (04/11/2026, unreleased) | 0.6 KB | `KindArt` imports it; a plain-HTML page links it |
96
102
  | logo-sheet | `@gemboss/ui/logo-sheet.css` | `packages/ui/src/logo-sheet.css` | `LogoSheet`: one logo as a person judges it, the mark on a checkerboard, the lockup on a light and a dark header, the favicon at its real 32px (unreleased) | 0.5 KB | `LogoSheet` imports it |
@@ -102,6 +108,9 @@ its CSS out of the build with it (`sideEffects`). gzip of the minified file, as
102
108
  | skill-view | `@gemboss/ui/skill-view.css` | `packages/ui/src/skill-view.css` | `SkillView`, `SkillViewBody`, `SkillViewSection`, `SkillRuleList`: one skill in a ReaderDialog (or alone), tabs as slots (03/11/2026, unreleased) | 1.4 KB | `SkillView` imports it (with reader-dialog.css) |
103
109
  | skill-card | `@gemboss/ui/skill-card.css` | `packages/ui/src/skill-card.css` | `SkillGroup`, `SkillCard`: the cards a skill's popup opens from (04/11/2026, unreleased) | 1.3 KB | `SkillCard` / `SkillGroup` import it |
104
110
  | skill-stats | `@gemboss/ui/skill-stats.css` | `packages/ui/src/skill-stats.css` | `SkillStats`: one skill's usage, runs, engines, outcomes, versions (03/11/2026, unreleased) | 1.0 KB | `SkillStats` imports it (and minichart.css through ShareBar) |
111
+ | skill-history | `@gemboss/ui/skill-history.css` | `packages/ui/src/skill-history.css` | `SkillVersionList`, `SkillDiff`, `SkillChangeCard`: a skill pack's History, versions with Compare, a proposal's changes (05/11/2026, unreleased) | 0.6 KB | `SkillVersionList` / `SkillDiff` / `SkillChangeCard` import it |
112
+ | skill-pages | `@gemboss/ui/skill-pages.css` | `packages/ui/src/skill-pages.css` | `SkillsTabs`, the Rules book (`SkillRuleSummary`, `SkillRuleSection`, `SkillGuardGroups`, `SkillCheckTable`, `SkillRuleChip`, `SkillRuleLevel`), Building blocks (`SkillLayerList`, `SkillDocJump`, `SkillDoc`, `SkillDocHistory`): content-radar's Skills pages (07/11/2026, unreleased) | 1.7 KB | the components in `skill-pages.tsx` import it |
113
+ | skill-feedback | `@gemboss/ui/skill-feedback.css` | `packages/ui/src/skill-feedback.css` | `SkillFeedbackList`, `SkillFeedbackBar`, `SkillFeedbackHead`: runs and feedback on a skill, content-radar's Feedback tab (07/11/2026, unreleased) | 0.4 KB | `SkillFeedbackList` imports it |
105
114
  | skill-flow | `@gemboss/ui/skill-flow.css` | `packages/ui/src/skill-flow.css` | `SkillFlow`: a skill's flow canvas, its OWN lazy entry `@gemboss/ui/skill-flow` (React Flow + dagre, optional peers) (03/11/2026, unreleased) | 3.4 KB | the canvas imports it, with `@xyflow/react/dist/style.css` |
106
115
  | 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") |
107
116
  | 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) |
@@ -197,6 +206,53 @@ One component for a page that lists one kind of thing (the admin's Rules first;
197
206
  Colours are Polaris' where Polaris is loaded (`--p-color-text`, `--p-color-text-secondary`, `--p-color-bg-fill-tertiary`),
198
207
  the kit's tokens elsewhere.
199
208
 
209
+ ## AppNav and the mini rail (0.62.0): a section that opens as an app of its own
210
+
211
+ Chris, 05/11/2026: entering a plugin folds the main menu to icons so the plugin gets the space, and every plugin is laid out the
212
+ same way, its visuals never clashing with the icon rail (canvas https://claude.ai/artifact/Hsou4RYohWWXpzv1jHbtYZ, direction A).
213
+ Three planes: the rail is icons on white, the section's nav is words on light grey, the page is white.
214
+
215
+ ```tsx
216
+ <AppShell railMode="mini" rail={…} railBottom={…}>
217
+ <AppNavFrame nav={(
218
+ <AppNav identity={{ icon: <Icon/>, name: "GemReview", status: "On · 2 places", tone: "on" }}
219
+ switchLabel="Switch plugin" switchHeading="Your plugins"
220
+ switchMenu={<>{others.map((o) => <AppNavSwitchRow key={o.id} href={o.href} name={o.name} tone={o.on ? "on" : "off"} note={o.on ? null : "Off"} current={o.id === id} />)}<hr /><AppNavSwitchRow href="/app/plugins" icon={<GridIcon />} name="All plugins" /></>}
221
+ groups={[
222
+ { items: [{ label: "Home", href: "?tab=home", current: true }, { label: "Reviews", href: "?tab=reviews", badge: 4, badgeLabel: "4 need you" }] },
223
+ { heading: "Library", items: [{ label: "Widgets", href: "?tab=widgets", count: 3 }] },
224
+ { heading: "Numbers", items: [{ label: "Insights", href: "?tab=insights" }] },
225
+ ]}
226
+ foot={<><AppNavLink href="?tab=settings">Settings</AppNavLink><AppNavPublish changes={2} onPublish={publish} busy={publishing} /></>}
227
+ linkAs={Link} onItemClick={(item, e) => { e.preventDefault(); openTab(item.href); }} />
228
+ )}>
229
+ {page}
230
+ </AppNavFrame>
231
+ </AppShell>
232
+ ```
233
+
234
+ - `railMode` (`AppShell`, `Shell`): `mini` puts `data-rail="mini"` on the shell, and from 761px the rail is 56px of icons (the page
235
+ editor's closed rail, the same numbers: 32px rows under a mouse, 44 under a finger), `main` starts at 56, the holding cover and Gem
236
+ full screen or pinned start there too. A `RailItem` whose label is words takes it as its `title` and its `aria-label` (not the
237
+ `aria-label` when a `RailCount` follows it: the hidden label and the count name it); the label stays in the markup, out of sight,
238
+ and shows beside the rail on keyboard focus. A `RailCount` is a dot whose `aria-label` is the count. Sub rows and headings go. On
239
+ a phone nothing changes: the drawer opens the full rail. `full`, the default, adds nothing to the markup. The rules are
240
+ `rail-mini.css`, which `AppNav` brings; a surface that folds the rail without an AppNav imports `@gemboss/ui/rail-mini.css`.
241
+ - `AppNav`: `identity` (`icon` on a 32px iris tile, `name`, `status` with a dot in `tone`: `on` · `off` · `wait`), `groups`
242
+ (`heading?`, `items: { label, href, current?, count?, badge?, badgeLabel? }`), `foot`. With `onSwitch` or `switchMenu` the header is
243
+ a button with a chevron; `switchMenu` opens under it, 280 wide over the page, `switchHeading` over its rows (Escape, a press outside
244
+ or a row followed closes it). `AppNavSwitchRow`: a dot in `tone`, an `icon`, the `name`, a `note` at the end; `current` is shaded. Words only in the rows:
245
+ 216 wide on `--gemboss-appnav-bg` (#f6f6f7, its own token in this entry), rows 32 tall, 0 12 inside, 8 round, 13/500; the current
246
+ row (`aria-current="page"`) white, 600, on a hairline ring; headings 11/600 caps; a badge an iris pill, a count muted at the end.
247
+ `linkAs` renders the links (a router's), `onItemClick` hears a row pressed first (a surface that changes the page itself).
248
+ - `AppNavLink` is a foot row (Settings), `AppNavPublish` the foot's Publish: "N changes not live" and the button (`pending` when the
249
+ changes cannot be counted, `busy` while it runs), else `live` with a tick ("Live on your store"; null draws nothing).
250
+ - `AppNavFrame` lays the nav beside the page: the nav sticks under the topbar, full height; the page is the kit's 900 column; the
251
+ shell's `main` gives up its gutter while it holds one.
252
+ - At 768px and below the same data is the header and one row of chips, the current one filled near-black; headings and counts go,
253
+ the foot's rows join the chips.
254
+ - Any section draws it (a plugin, the admin's Reach): nothing in it knows what the section is.
255
+
200
256
  ## Page width (0.8.1)
201
257
 
202
258
  Chris, 04/10/2026: the rail on the left, and on the right a content column with the same max width on every
@@ -812,7 +868,7 @@ import "@gemboss/ui/editor.css"; // only on the screens that show an editor
812
868
  | Preview | `.gemboss-pv` › `.gemboss-pv-stage` › `.gemboss-pv-frame` (`.desktop` / `.tablet` / `.mobile`, `.gemboss-pv-fit` for scale-to-fit) › `iframe.gemboss-pv-iframe`; `.gemboss-pv-spin`; empty state `.gemboss-pv-empty` (`-art`, `-title`, `-sub`, `-cta`). Device toggle `.gemboss-pv-devices › button.gemboss-pv-device` |
813
869
  | Left column | tab row `div.gemboss-ec-tabs[role=tablist] › button[role=tab][aria-selected]` (add `.gemboss-ec-tab` for the 44px pointer floors); Configure pane `.gemboss-ec-dock-body` |
814
870
  | Inspector | `.gemboss-ei` (`--docked` inside the Configure pane) › `.gemboss-ei-head` (`-title`, `-x`, `-savedot`), `.gemboss-ei-tabs › .gemboss-ei-tab`, `.gemboss-ei-body`, `.gemboss-ei-foot`. Groups `.gemboss-ei-group › .gemboss-ei-grouphead` (collapsible) and `.gemboss-ei-gh` / `.gemboss-ei-grp`. Field `.gemboss-ei-fld › label + control + .gemboss-ei-hint` |
815
- | Controls | text / select `.gemboss-field.gemboss-ei-inp` (+ `.gemboss-ei-mono`), a number with its unit inside `UnitField` (`label.gemboss-field.gemboss-field--group` › `.gemboss-field__bare` + `.gemboss-field__suffix`, 0.40.0; `.gemboss-ei-suffix` is gone), segmented `.gemboss-ei-seg`, colour `.gemboss-ei-color` / `.gemboss-ei-swatches › .gemboss-ei-sw` / `.gemboss-ei-swatch`, range `.gemboss-ei-range` + `.gemboss-ei-rangeval`, spacing box `.gemboss-ei-edgebox › .gemboss-ei-edge`, image `.gemboss-ei-img` (`-thumb`, `-ctl`, `-actions`, `-info`, `-name`, `-meta`, `-drop`, `-grid`, `-cell`), repeater `.gemboss-ei-rep-item` (`-head`, `-acts`, `-add`), blocks `.gemboss-ei-block` (`-head`, `-x`), add `.gemboss-ei-addrow` (its buttons are the kit's `.ui-btn` via `ChipButton`, 0.40.0; `.gemboss-ei-addchip` is gone), element tree `.gemboss-ei-tree › .gemboss-ei-tnode` (`-tname`, `-tacts`, `-tadd`), notes `.gemboss-ei-note`, `.gemboss-ei-oos` (`-h`), `.gemboss-ei-empty`, drag `.gemboss-ei-drag` / `.gemboss-ei-dragmask` |
871
+ | Controls | text / select `.gemboss-field.gemboss-ei-inp` (+ `.gemboss-ei-mono`), a number with its unit inside `UnitField` (`label.gemboss-field.gemboss-field--group` › `.gemboss-field__bare` + `.gemboss-field__suffix`, 0.40.0; `.gemboss-ei-suffix` is gone), segmented `.gemboss-ei-seg`, colour `.gemboss-ei-color` / `.gemboss-ei-swatches › .gemboss-ei-sw` / `.gemboss-ei-swatch`, range `.gemboss-ei-range` + `.gemboss-ei-rangeval`, spacing box `.gemboss-ei-edgebox › .gemboss-ei-edge`, image `.gemboss-ei-img` (`-thumb`, `-ctl`, `-actions`, `-info`, `-name`, `-meta`, `-drop`, `-grid`, `-cell`), repeater `.gemboss-ei-rep-item` (`-head`, `-acts`, `-add`), blocks `.gemboss-ei-block` (`-head`, `-x`), element tree `.gemboss-ei-tree › .gemboss-ei-tnode` (`-tname`, `-tacts`, `-tadd`), notes `.gemboss-ei-note`, `.gemboss-ei-oos` (`-h`), `.gemboss-ei-empty`, drag `.gemboss-ei-drag` / `.gemboss-ei-dragmask` |
816
872
  | Layers | `.gemboss-layers` › `.gemboss-layer-head` + `.gemboss-layers-list` › `.gemboss-layer` (`.is-sel`) › `.gemboss-layer-main` (`.gemboss-layer-type`) + `.gemboss-layer-acts` (`.gemboss-layer-del`) |
817
873
  | Settings drawer | `.gemboss-settings` › `.gemboss-picker-head` + `.gemboss-settings-body` › the kit's `Field`s (`.gemboss-ei-fld`), `.gemboss-settings-grouphead`, `-gen`, `-note`, `-error`; `.gemboss-settings-foot` (`-save`, `-cancel`); backdrop `.gemboss-picker-backdrop`, empty `.gemboss-picker-empty` |
818
874
  | Page / section editor bar | `.gemboss-pageedit` (`-top`, `-title`, `-kind`, `-status`, `-standing`, `-scope`, `-modes`, `-notice`, `-chip`, `-pv`; the left cluster's gap is `--gemboss-tb-gap`, 12px, for a child that hands it back; above 1000px the bar's tracks are `auto fit-content(100%) auto`, so its free space sits beside the centre), `.gemboss-sec-type`, section insert `.gemboss-sec-insert-*`, draft preview `.gemboss-page-draft-stage` / `-status`, `.gemboss-page-section-content`, global styles bundle `.gemboss-bundle-look` |
@@ -943,7 +999,10 @@ import { ColorControl, EdgeBox, Field, ImageControl, InspectorGroup, PanelAction
943
999
  | `PanelHeader`, `PanelAction` | `header.gemboss-ei-head` › `.gemboss-ei-title` (+ `small` subtitle) · `.gemboss-ei-act` buttons · `.gemboss-ei-x` ✕ | ✕ only with `onClose` (a docked panel has none); `onDragStart` adds `.gemboss-ei-drag` and takes the mouse-down of a floating panel. |
944
1000
  | `InspectorGroup` | `.gemboss-ei-grp` › `button.gemboss-ei-gh` (13px / 650, the chevron at its end, `note` as `.gemboss-ei-gh-note`) + the body | `aria-expanded`, `data-open`; closed, CSS hides everything after the header (`.gemboss-ei-grp>.gemboss-ei-gh[data-open="closed"]~*`, a class heavier than any field's own `display`; the body stays mounted; an inline `display` on the body's first element would still win over that, so give it a bare wrapper). Controlled (`open` + `onOpenChange`, which receives the NEXT state) or not (`defaultOpen`). `attrs`: `data-*` on the group itself, so a page that finds groups by an attribute needs no wrapper (a wrapper drops the divider between groups). `collapsible={false}`: the schema form's static group, `section.gemboss-ei-group` › `h4.gemboss-ei-grouphead` + `hint`. |
945
1001
  | `InspectorChips` | `.gemboss-ei-chips` › groups in their own order; a group marked `data-chip` (an `InspectorGroup`'s `attrs`, or a `.gemboss-ei-grp` line of the caller's) is its first child alone as a pill (28px, 44 under a finger, 8px apart, no chevron); the others take the whole width | Its own part, `editor-chips.css` (31/10/2026, Control UI C32 slice 3: the element panel's empty shared groups). The caller marks and unmarks a group; it stays the same element under the same parent, so a chip that opens keeps the focus. editor.css weighs a folded group's padding as the group's own (`:where(:has(…))`, (0,1,0)), so a chip's rule needs no extra weight. |
946
- | `Field` | `.gemboss-ei-fld` › `label` (13px / 500; `htmlFor`; `labelValue` as `.gemboss-ei-rangeval` at its right edge) · control · `hint` | No label when `label` is undefined / null. `className` (the admin's `togrow`), `style`. `aside`: a control on the label line, at its right, beside the label and not in it (a spacing field's shape). |
1002
+ | `InspectorFrame` | `div.gemboss-ei-frame[data-settings-frame]` (display: contents) › head · `InspectorSearch` (`.gemboss-ei-find`) · `nav.gemboss-ei-index` (`data-jump` per cluster, `aria-current` on the one in view) · aside · lead · per cluster `div.gemboss-ei-cluster[data-panel-cluster]` › `.gemboss-ei-cluster-name` and its groups | The settings frame (06/11/2026, the element panel's, for every settings surface): its own part, `editor-inspector-frame.css`. A cluster with no content is neither drawn nor indexed; `results` (a search's) replace the index, the lead and the clusters. The index moves the panel's own scroller, not the page. |
1003
+ | `InspectorFramePart` | `div.gemboss-ei-part[data-frame-part]` (display: contents), `hidden` while a search does not find it | A part of the panel that is not one of its groups (a section's words, its options), in its place in its cluster: a search shown in place (`InspectorFrame` `searching`) never draws it again from nothing. A static `InspectorGroup` inside the frame is drawn as the frame's open group (InspectorGroup decides it). |
1004
+ | `InspectorFrameGroup` | `state="open"`: `.gemboss-ei-grp[data-open-group]` › `.gemboss-ei-openhead`. `"add"`: `.gemboss-ei-grp.gemboss-ei-addline[data-add-group]` › `button.gemboss-ei-addhead` (name, `.gemboss-ei-addplus` +). `"added"`: `.gemboss-ei-grp[data-added-group]` › `.gemboss-ei-addedhead` (name, `.gemboss-ei-headacts` › acts, `button.gemboss-ei-addsign[data-remove-group]` −) and the rows | One element in the three states, so a group added stays where it was with the focus in it. `chip` in an `InspectorChips` run draws the + line as a pill. What + and − write is the caller's. |
1005
+ | `Field` | `.gemboss-ei-fld` › `label` (13px / 500; `htmlFor`; `labelValue` as `.gemboss-ei-rangeval` at its right edge) · control · `hint` | No label when `label` is undefined / null. `control` (05/11/2026, unreleased): the control it holds, by the one table `LABEL_SIDE` (`labelSide`, `isFieldControlKind`): `select`, `chips`, `toggle`, `color`, `value`, `number`, `range`, `pick`, `text`, `link`, `date` put the label beside it (`.gemboss-ei-fld--row`, a row wherever it is, not only in a group); `textarea`, `list`, `edges`, `image`, `tiles`, `gradient`, `drawing`, `code` keep it above, and so do `screens` and `font-pick` until those controls are reworked. A row's notes (`.gemboss-ei-hint`, its help included) run across the field under it. `row` is deprecated (a side by hand). `className` (the admin's `togrow`), `style`. `aside`: a control on the label line, at its right, beside the label and not in it (a spacing field's shape). |
947
1006
  | `Seg` | `.gemboss-ei-seg[role=group]` › `button[aria-pressed][data-value]` (`.on`) | A click hands back the option's value; `label` names the group; `style` on the group. |
948
1007
  | `ColorControl` | `.gemboss-ei-color` › `button.gemboss-ei-swatch` + text box | The swatch opens the kit's picker (Popover + ColorPicker), which commits on every pick (a drag at most every 80 ms). The text box keeps a draft, each key sent to `onDraft` for a host that holds unsaved edits, and commits on blur (every blur) or Enter. A value the swatch cannot show (a token, a gradient) disables it and says why under it (`swatchState`). |
949
1008
  | `RangeControl` | `input[type=range].gemboss-ei-range` | Every change, as a number (drag, arrows, Home / End). Show the value with `Field`'s `labelValue`. |
@@ -2807,6 +2866,55 @@ import { KindArt } from "@gemboss/ui";
2807
2866
  - Decorative (`aria-hidden`): the card's name says what it is. `title` makes it an image with that name, where the picture is the
2808
2867
  only thing that says it. Server-renderable, no inline style. Its own entry, `kind-art.css` (0.6 KB gzip).
2809
2868
 
2869
+ ## Gem at work (05/11/2026, unreleased; ADR 0013): `createGemAtWork`
2870
+
2871
+ What Gem is doing, drawn on the page it is doing it to, while a turn runs. Gem's crew (Gem leading, then a copy, a layout, an image
2872
+ and a CRO expert, QA and smart styling, each an arrow with its name; kept on Chris's word, 05/11: "giữ lại làm cho sinh động và dễ
2873
+ hiểu") goes to the block being changed; a ring names it; the expert for that kind of work drags the box out from its corner at its
2874
+ real size; the words arrive IN the block itself; what changed lights up once at the end. It reads ONE thing, the activity contract
2875
+ v1, never the agent's stream: the admin's reader (`apps/admin/src/lib/gem-activity.ts`) turns the stream into activities, so a
2876
+ renamed tool changes a line in its map.
2877
+
2878
+ ```ts
2879
+ import { createGemAtWork } from "@gemboss/ui";
2880
+
2881
+ const gem = createGemAtWork({ onFallback: (level) => count(level), onStatus: (text) => setStatus(text) });
2882
+ reader.read(event).forEach((activity) => gem.push(activity)); // every stream event, as it arrives
2883
+ gem.reveal(["s-hero", "s-faq"]); // saved sections arrived: built in after what is still being drawn (no ids: every section)
2884
+ await gem.idle(); // the calm clock has drawn everything that arrived
2885
+ gem.catchUp(turnSoFar); // a frame that joins mid-turn (Page ⇄ Canvas): the turn so far, drawn at once, nothing moving
2886
+ gem.skip(); // the person pressed Skip: the page as it is, at once
2887
+ gem.destroy(); // the layer leaves the page
2888
+ ```
2889
+
2890
+ - **The calm clock** (Chris 05/11: "các bước cũng ko cần phải quá nhanh… để mắt người nhìn kịp"): activities are drawn in order,
2891
+ each held long enough to be seen (a thought 1.2 s, a finished line 0.7 s, a check 1.8 s), words typed at 28 characters a second.
2892
+ It may trail Gem, never lead it: it only ever draws what has arrived, and more than 12 s behind it hurries in proportion.
2893
+ `clock: "live"` draws each activity the moment it arrives.
2894
+ - **The grammar.** `think`/`plan`: the crew arrives, Gem's tag says the step. `focus`: the layout expert goes to the block and a ring
2895
+ names it. `draft`: the box dragged out at its real size (W × H), two guides across its section, the words written into the
2896
+ block's own text node (a caret where the next word goes). A section this turn adds (`created`) that the page does not have yet is a
2897
+ soft card in the page's content column, its words in the page's own font, each next one stacked below; the page makes room for
2898
+ them (one empty block after its last section), so its footer moves down instead of being drawn over. `apply`: a tick. `check`: QA
2899
+ sweeps a scan line down the screen. `fail`: Gem and the ring turn red for 2.4 s, the words go back. `land`: what changed lights up
2900
+ for 1.6 s; the crew leaves. At most four are on the page at once: Gem, the one at work, and two trades beside it walking slowly along the block's edges, off its words; the others are gone until their trade comes up. The walk stops with the turn.
2901
+ - **Where the work is, the crew is.** An activity may say how much of its work is each trade (`trades: { copy, layout, image, cro, check, style }`: the fields an edit wrote, the words a check's findings use). Each trade warms by that count (at most 5 a step) and cools by half every 45 s; one warm enough comes beside the work ahead of the usual pair, takes more of the walk's beats, and says what it fixes ("Layout expert · fixing the layout"). A check, a save or a refusal that names trades changes who walks beside the work at once; QA riding its sweep counts as one of the two.
2902
+ - **`reveal(ids?)`**: saved sections, each through **one order, overview to detail**: structure (frames that paint something), pictures, headlines, words, buttons, then QA's sweep; within a step blocks go top to bottom and left to right; Gem's tag names the step. A section taller than the screen goes a screenful at a time, each through the whole order, so the page only moves down. An expert goes to a block's corner, holds the mouse down and drags its box out; words wipe in behind a caret, a picture's box fills with tint and the picture comes up through it. Nothing is outlined ahead of the boxes (Chris 05/11: a box dragged over a box already there makes no sense).
2903
+ - **Targets by stable ids only**: `[data-gem-el-id]`, then `[data-gem-section-id]`, the first match that has a box (a custom-liquid
2904
+ section is a `display: contents` wrapper around an inner section with the same id; `find` replaces the lookup). **The ladder**: an
2905
+ element it cannot find is drawn on its section, a section it cannot find at page level, and an error anywhere skips to the page
2906
+ as it is; `onFallback(level, activity)` reports each step down.
2907
+ - **One layer, no hooks in the page.** Words written into a block are its own text node's value only, put back by `skip()`,
2908
+ `destroy()` and a refusal (left for the saved page when a turn lands a change); the one block put in the page is the room for
2909
+ sections on their way, taken out with them; `reveal()` puts every style it touched back as it was. Under a bar that sticks to the
2910
+ top of the screen the layer is cut at the bar's edge, so what is drawn scrolls under it as the page does. The page is followed
2911
+ down as Gem works, unless the person moved it themselves in the last 4 s; a page drawn at its full height (the Studio's Canvas
2912
+ pans it) cannot scroll, so `onLook(top, height)` tells its host where to move the board.
2913
+ - **Light.** Only transform, opacity and clip-path move, nothing loops, the stylesheet animates nothing. `mode`: `full`, `subtle`
2914
+ (rings, words and the light, no crew or dragged box) or `off`; `crew` sets how many of the seven draw. With prefers-reduced-motion
2915
+ nothing travels or animates. A store theme's resets (`svg { max-width: 100% }`) do not shrink the crew's arrows.
2916
+ - Plain DOM, no React: the same file runs in the preview frame (gemsite copies it byte for byte). Its own entry, `gem-at-work.css`.
2917
+
2810
2918
  ## Report pages (0.4.0)
2811
2919
 
2812
2920
  Plain CSS in `kit-plain.css` for a numbers page written by hand (first user: gemnews `/admin`, 03/10/2026; that page moved to GemCommunity the same day, so gemnews no longer takes the package). The
@@ -2816,6 +2924,7 @@ surface computes every number and ratio; the kit only draws. Markup for each is
2816
2924
  top, big value, a foot line for the comparison.
2817
2925
  - `ui-delta` (`--good` / `--bad`): change vs a previous period. Good or bad is the surface's call (reads up is good,
2818
2926
  bounce up is bad); the arrow is direction, written in the markup. No tone = neutral or "no previous period".
2927
+ - A page without the core (the admin) imports `@gemboss/ui/report-charts.css` for `ui-barlist`, `ui-chart` and `ui-legend`.
2819
2928
  - `ui-barlist`: horizontal bars. `--v` (0..1) is the length, `--c` the colour; label and value on one line, the bar
2820
2929
  full width below it, so no fixed label column gets squeezed at 320px. `__share`, `__note`.
2821
2930
  - `ui-chart`: stacked columns over time plus an optional hollow-dot series. `--v` per segment and dot, `data-max`
@@ -3004,6 +3113,58 @@ draw their pictures and figures from here, so one change moves both. Their own e
3004
3113
  sentence, its one button at the end (`<Notice action={<button className="ui-btn">Turn off</button>}>… no difference for 30 days.</Notice>`).
3005
3114
  No tone is a card on the page's ground; `tone` takes the core notice's colours.
3006
3115
 
3116
+ ## Audiences (05/11/2026, unreleased): `AudiencesTable`, a store's audiences
3117
+
3118
+ The list of a store's audiences as GemBoss › Reach › Audiences draws it (board GroupsTable on the canvas "Một lõi, ba cửa"; Chris
3119
+ 05/11/2026: one word and one list, Audiences). GemReach's own admin lists a brand's with the same columns, in its own words. Built on
3120
+ `IndexTable`: the whole row opens the audience, the row folds into a list below 768 of its container, and loading and empty are the
3121
+ table's own states. Its own entry, `@gemboss/ui/audiences-table.css`, imported by the component.
3122
+
3123
+ ```tsx
3124
+ <AudiencesTable linkAs={Link} flush rows={[
3125
+ { id: "quiz-dry", name: "Quiz: dry skin", source: "site", sync: "synced 4 min ago", onSite: 1240, canEmail: 412,
3126
+ delta: "+40%", usedBy: "Flow: Quiz result · Campaign: Dry skin bundle", href: "/app/reach/audiences/quiz-dry" },
3127
+ ]} />
3128
+ ```
3129
+
3130
+ - Columns, in the board's order: Audience (the name; under it the source as a chip, `site` "On site + email" | `email` "Email only" |
3131
+ `imported` | `gemcare`, and `sync`, how fresh it is), On site (a dash when `onSite` is null), Can email (in ink: the figure that matters),
3132
+ 7 days, Used by (muted, cut with an ellipsis).
3133
+ - Counts are numbers, written with grouped thousands (`audienceCount`). The week's change is the caller's words ("+40%", "+4", "−3%", "—");
3134
+ `audienceDeltaTone` reads its sign (green up, red down, muted flat), and `deltaTone` overrides it.
3135
+ - `labels` takes other words, the source names included (`AUDIENCES_TABLE_LABELS` holds the English defaults; GemReach's admin says People
3136
+ and Live rules). `audiencesTableColumns` and `audiencesTableRows` are the same pieces for a surface that draws its own `IndexTable`, and `AudienceSourceChip` is the chip on its own, for an audience's page.
3137
+
3138
+ ## Email editor (05/11/2026, unreleased): `EmailEditor`, `EmailPreview`, and GemReach's blocks
3139
+
3140
+ Chris approved the email editor on canvas JQkjqVVb (05/11/2026): the page editor's layout, every editor's (one left column, Chat ·
3141
+ Sections · Settings, the chat a tab kept mounted; "+" adds, nothing is dragged; no right inspector). GemBoss draws it in the funnel
3142
+ (`/app/reach/emails/[id]/edit`), and GemReach's admin can take the same component for its own (admin/src/pages/EmailEditor.tsx).
3143
+
3144
+ ```tsx
3145
+ import { EmailEditor } from "@gemboss/ui/email-editor"; // brings editor.css and email-editor.css
3146
+ import { emailChecks, type EmailDraft } from "@gemboss/ui/email-editor/model"; // pure: a server or a test reads it
3147
+
3148
+ <EmailEditor draft={draft} onChange={setDraft} brand={brandKit}
3149
+ back={{ place: "Night Serum funnel", href: "/app/funnels?open=cmp_1", as: Link }}
3150
+ chat={<YourAssistantChat />} people={[{ id: "anna", label: "Anna · bought 23 days ago", data: { first_name: "Anna" } }]}
3151
+ productsFor={(person, source) => products} opens="Refill page, built for each buyer"
3152
+ saveState={saveState} dirty={draft !== saved} onSave={save} onSendTest={sendTest} />
3153
+ ```
3154
+
3155
+ - **The body is GemReach's** (`EmailDraft.body` = its `Block[]`, field for field): a body saved here is one GemReach renders. Two
3156
+ kinds are proposals until GemReach has them: `products` (`source`: order, cart, viewed) and `review`. Kinds the "+" offers, in the
3157
+ board's order: Logo (`header`), Image, Heading + text (`hero` without a picture), Products, Button, Review ask, Footer. Other
3158
+ GemReach kinds load and draw; their settings stay in GemReach for now.
3159
+ - **Personal link**: a button whose url is `{{funnel_url}}` opens a page built for each person (GemReach signs it while building the
3160
+ mail, 72 hours, no address in it); its row and its settings say so with a chip.
3161
+ - **Checks**: `emailChecks(draft, brand, data)` runs 18 of GemReach's checks by their ids and names (src/templates/check-ids.ts); the
3162
+ pill says "18 of 18 checks pass" and opens the list (`StatusList`). Pass the server's with `checks`.
3163
+ - **The preview** is drawn from the blocks for one person (`people`), in the brand's colours, Desktop 600 / Mobile 375, Dark. It is
3164
+ not GemReach's sent HTML; wire the editor to GemReach's preview route to show that.
3165
+ - Classes: `gb-emailed-*` (the editor), `gb-email-*` (the mail); every one drawn is styled by `email-editor.css`
3166
+ (`email-editor.test.tsx`).
3167
+
3007
3168
  ## Members (04/11/2026, unreleased): `MembersPage`, one members list for every service
3008
3169
 
3009
3170
  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.61.0 · Editor</h1>
11
+ <h1>@gemboss/ui 0.64.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;;
@@ -27,7 +27,7 @@ body{margin:0;background:var(--gemboss-app-bg,#f1f1f1);color:var(--gemboss-text)
27
27
  @media (max-width:760px){.cat{grid-template-columns:1fr;padding:16px}.cat-nav{position:static;flex-direction:row;flex-wrap:wrap}}
28
28
  </style></head><body>
29
29
  <div class="cat"><nav class="cat-nav" aria-label="Mục"><a href="#tokens">Token</a><a href="#buttons">Nút</a><a href="#fields">Ô nhập</a><a href="#choice">Tab, nhóm nút, thẻ</a><a href="#surfaces">Thẻ, số liệu, bảng, trạng thái trống</a><a href="#report">Báo cáo</a><a href="#collections">Bảng, list, lưới, board</a><a href="#resizer">Thanh kéo giữa hai cột</a><a href="#modal">Hộp thoại, toast, menu (JS thuần)</a><a href="#sheet">Ngăn trượt cạnh phải</a><a href="#reader">Hộp đọc tài liệu</a><a href="#settings">Hộp cài đặt</a><a href="#switcher">Chuyển dịch vụ</a><a href="#shell">Khung app</a><a href="#nav">Chờ điều hướng</a><a href="#page">Bề rộng nội dung</a><a href="#portal">Cổng công khai: tab trên topbar, tìm kiếm, sáng / tối, người dẫn đầu</a><a href="#site">Trang công khai: thanh trên, logo cỡ site, nút, chân trang</a><a href="#auth">Đăng nhập</a><a href="#setup">Hướng dẫn thiết lập</a><a href="#chat">Thân chat</a><a href="#reactions">Reactions</a><a href="#team-chat">Chat đội</a><a href="#action-card">Thẻ hành động</a><a href="#assistant-engine">Trợ lý: chọn engine</a><a href="#assistant-bridge">Trợ lý: cầu nối trên máy (0.32.0)</a><a href="#assistant-chat">Trợ lý: khung chat (0.29.0)</a><a href="#assistant">Trợ lý: cột phiên</a><a href="#icons">Icon</a><a href="#editor">Editor</a></nav>
30
- <main><header class="cat-head"><h1>@gemboss/ui 0.61.0</h1><p>Ngôn ngữ thiết kế chung của các công cụ GemBoss. Markup dưới mỗi ví dụ là đúng thứ package render ra; bề mặt không dùng React (HTML tĩnh, Python) chép markup này và nạp <code>gemboss-ui.css</code>. Dựng từ gemboss <code>426ccb8ced86</code>.</p></header>
30
+ <main><header class="cat-head"><h1>@gemboss/ui 0.64.0</h1><p>Ngôn ngữ thiết kế chung của các công cụ GemBoss. Markup dưới mỗi ví dụ là đúng thứ package render ra; bề mặt không dùng React (HTML tĩnh, Python) chép markup này và nạp <code>gemboss-ui.css</code>. Dựng từ gemboss <code>59db27020e58</code>.</p></header>
31
31
  <section id="tokens"><h2>Token</h2><p>Đổi giao diện một bề mặt bằng cách đặt lại token, không viết đè class. Tên và giá trị đọc thẳng từ gemboss-ui.css.</p><div class="cat-swatches"><div class="cat-swatch"><i style="background:var(--gemboss-primary)"></i><code>--gemboss-primary</code><span>#1b1c1e</span></div><div class="cat-swatch"><i style="background:var(--gemboss-primary-dark)"></i><code>--gemboss-primary-dark</code><span>#000000</span></div><div class="cat-swatch"><i style="background:var(--gemboss-primary-soft)"></i><code>--gemboss-primary-soft</code><span>#f2f3f5</span></div><div class="cat-swatch"><i style="background:var(--gemboss-accent)"></i><code>--gemboss-accent</code><span>#5661f5</span></div><div class="cat-swatch"><i style="background:var(--gemboss-accent-strong)"></i><code>--gemboss-accent-strong</code><span>#3a44de</span></div><div class="cat-swatch"><i style="background:var(--gemboss-accent-soft)"></i><code>--gemboss-accent-soft</code><span>#eef0fe</span></div><div class="cat-swatch"><i style="background:var(--gemboss-accent-wash)"></i><code>--gemboss-accent-wash</code><span>#f7f8ff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-accent-tint)"></i><code>--gemboss-accent-tint</code><span>#dfe2ff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-accent-mid)"></i><code>--gemboss-accent-mid</code><span>#c9cffd</span></div><div class="cat-swatch"><i style="background:var(--gemboss-text-strong)"></i><code>--gemboss-text-strong</code><span>#1b1c1e</span></div><div class="cat-swatch"><i style="background:var(--gemboss-text)"></i><code>--gemboss-text</code><span>#1b1c1e</span></div><div class="cat-swatch"><i style="background:var(--gemboss-text-muted)"></i><code>--gemboss-text-muted</code><span>#686b71</span></div><div class="cat-swatch"><i style="background:var(--gemboss-surface)"></i><code>--gemboss-surface</code><span>#ffffff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-canvas)"></i><code>--gemboss-canvas</code><span>#ffffff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-preview-canvas)"></i><code>--gemboss-preview-canvas</code><span>#eceef1</span></div><div class="cat-swatch"><i style="background:var(--gemboss-rail-bg)"></i><code>--gemboss-rail-bg</code><span>#ffffff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-panel-bg)"></i><code>--gemboss-panel-bg</code><span>#ffffff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-divider)"></i><code>--gemboss-divider</code><span>#e5e7ea</span></div><div class="cat-swatch"><i style="background:var(--gemboss-divider-soft)"></i><code>--gemboss-divider-soft</code><span>#edeff2</span></div><div class="cat-swatch"><i style="background:var(--gemboss-hover)"></i><code>--gemboss-hover</code><span>#eceef2</span></div><div class="cat-swatch"><i style="background:var(--gemboss-active-bg)"></i><code>--gemboss-active-bg</code><span>#f0f1f4</span></div><div class="cat-swatch"><i style="background:var(--gemboss-active-fg)"></i><code>--gemboss-active-fg</code><span>#1b1c1e</span></div><div class="cat-swatch"><i style="background:var(--gemboss-danger)"></i><code>--gemboss-danger</code><span>#d72c0d</span></div><div class="cat-swatch"><i style="background:var(--gemboss-danger-strong)"></i><code>--gemboss-danger-strong</code><span>#b42318</span></div><div class="cat-swatch"><i style="background:var(--gemboss-danger-soft)"></i><code>--gemboss-danger-soft</code><span>#fff0e9</span></div><div class="cat-swatch"><i style="background:var(--gemboss-danger-border)"></i><code>--gemboss-danger-border</code><span>#f5c9bc</span></div><div class="cat-swatch"><i style="background:var(--gemboss-success)"></i><code>--gemboss-success</code><span>#007f5f</span></div><div class="cat-swatch"><i style="background:var(--gemboss-success-strong)"></i><code>--gemboss-success-strong</code><span>#0a6a4c</span></div><div class="cat-swatch"><i style="background:var(--gemboss-success-soft)"></i><code>--gemboss-success-soft</code><span>#e3f1df</span></div><div class="cat-swatch"><i style="background:var(--gemboss-success-border)"></i><code>--gemboss-success-border</code><span>#b7dfcd</span></div><div class="cat-swatch"><i style="background:var(--gemboss-warning)"></i><code>--gemboss-warning</code><span>#9a6700</span></div><div class="cat-swatch"><i style="background:var(--gemboss-warning-soft)"></i><code>--gemboss-warning-soft</code><span>#fff8e0</span></div><div class="cat-swatch"><i style="background:var(--gemboss-warning-border)"></i><code>--gemboss-warning-border</code><span>#f5d569</span></div><div class="cat-swatch"><i style="background:var(--gemboss-dark-bg)"></i><code>--gemboss-dark-bg</code><span>#0a0a0c</span></div><div class="cat-swatch"><i style="background:var(--gemboss-dark-rail)"></i><code>--gemboss-dark-rail</code><span>#0e0e11</span></div><div class="cat-swatch"><i style="background:var(--gemboss-dark-surface)"></i><code>--gemboss-dark-surface</code><span>#16161a</span></div><div class="cat-swatch"><i style="background:var(--gemboss-dark-surface-2)"></i><code>--gemboss-dark-surface-2</code><span>#1e1e24</span></div><div class="cat-swatch"><i style="background:var(--gemboss-dark-divider)"></i><code>--gemboss-dark-divider</code><span>#2a2a31</span></div><div class="cat-swatch"><i style="background:var(--gemboss-dark-text)"></i><code>--gemboss-dark-text</code><span>#ededf0</span></div><div class="cat-swatch"><i style="background:var(--gemboss-dark-muted)"></i><code>--gemboss-dark-muted</code><span>#9a9aa4</span></div><div class="cat-swatch"><i style="background:var(--gemboss-field-bg)"></i><code>--gemboss-field-bg</code><span>#fdfdfd</span></div><div class="cat-swatch"><i style="background:var(--gemboss-field-bg-hover)"></i><code>--gemboss-field-bg-hover</code><span>#fafafa</span></div><div class="cat-swatch"><i style="background:var(--gemboss-field-ink)"></i><code>--gemboss-field-ink</code><span>#303030</span></div><div class="cat-swatch"><i style="background:var(--gemboss-field-placeholder)"></i><code>--gemboss-field-placeholder</code><span>#616161</span></div><div class="cat-swatch"><i style="background:var(--gemboss-field-line)"></i><code>--gemboss-field-line</code><span>#8a8a8a</span></div><div class="cat-swatch"><i style="background:var(--gemboss-field-line-hover)"></i><code>--gemboss-field-line-hover</code><span>#616161</span></div><div class="cat-swatch"><i style="background:var(--gemboss-field-line-active)"></i><code>--gemboss-field-line-active</code><span>#1a1a1a</span></div><div class="cat-swatch"><i style="background:var(--gemboss-chip-ink)"></i><code>--gemboss-chip-ink</code><span>#303633</span></div><div class="cat-swatch"><i style="background:var(--gemboss-chip-line)"></i><code>--gemboss-chip-line</code><span>#cfd6ce</span></div><div class="cat-swatch"><i style="background:var(--gemboss-chip-line-hover)"></i><code>--gemboss-chip-line-hover</code><span>#aab4ad</span></div><div class="cat-swatch"><i style="background:var(--gemboss-chip-bg-hover)"></i><code>--gemboss-chip-bg-hover</code><span>#f6f7f5</span></div><div class="cat-swatch"><i style="background:var(--gemboss-on-primary)"></i><code>--gemboss-on-primary</code><span>#ffffff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-app-bg)"></i><code>--gemboss-app-bg</code><span>#ffffff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-fill-tertiary)"></i><code>--gemboss-fill-tertiary</code><span>#2a2b33</span></div><div class="cat-swatch"><i style="background:var(--gemboss-fill-tertiary-hover)"></i><code>--gemboss-fill-tertiary-hover</code><span>#33353f</span></div><div class="cat-swatch"><i style="background:var(--gemboss-fill-tertiary-active)"></i><code>--gemboss-fill-tertiary-active</code><span>#3a3c46</span></div></div><table class="ui-table cat-scale"><thead><tr><th>Token</th><th>Giá trị</th><th>Mẫu</th></tr></thead><tbody><tr><td><code>--gemboss-fs-micro</code></td><td>11px</td><td style="font-size:var(--gemboss-fs-micro)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-fs-caption</code></td><td>12px</td><td style="font-size:var(--gemboss-fs-caption)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-fs-body</code></td><td>14px</td><td style="font-size:var(--gemboss-fs-body)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-fs-body-lg</code></td><td>16px</td><td style="font-size:var(--gemboss-fs-body-lg)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-fs-h3</code></td><td>16px</td><td style="font-size:var(--gemboss-fs-h3)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-fs-h2</code></td><td>20px</td><td style="font-size:var(--gemboss-fs-h2)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-fs-h1</code></td><td>24px</td><td style="font-size:var(--gemboss-fs-h1)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-fs-display</code></td><td>30px</td><td style="font-size:var(--gemboss-fs-display)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-radius-xs</code></td><td>4px</td><td><i class="cat-radius" style="border-radius:var(--gemboss-radius-xs)"></i></td></tr><tr><td><code>--gemboss-radius-sm</code></td><td>6px</td><td><i class="cat-radius" style="border-radius:var(--gemboss-radius-sm)"></i></td></tr><tr><td><code>--gemboss-radius-md</code></td><td>8px</td><td><i class="cat-radius" style="border-radius:var(--gemboss-radius-md)"></i></td></tr><tr><td><code>--gemboss-radius-lg</code></td><td>12px</td><td><i class="cat-radius" style="border-radius:var(--gemboss-radius-lg)"></i></td></tr><tr><td><code>--gemboss-radius-xl</code></td><td>16px</td><td><i class="cat-radius" style="border-radius:var(--gemboss-radius-xl)"></i></td></tr><tr><td><code>--gemboss-radius-2xl</code></td><td>20px</td><td><i class="cat-radius" style="border-radius:var(--gemboss-radius-2xl)"></i></td></tr><tr><td><code>--gemboss-radius-full</code></td><td>999px</td><td><i class="cat-radius" style="border-radius:var(--gemboss-radius-full)"></i></td></tr><tr><td><code>--gemboss-shadow-resting</code></td><td class="cat-small">0 1px 2px rgba(31, 30, 29, 0.04), 0 2px 6px rgba(31, 30, 29, 0.06)</td><td><i class="cat-radius" style="box-shadow:var(--gemboss-shadow-resting);border:0"></i></td></tr><tr><td><code>--gemboss-shadow-raised</code></td><td class="cat-small">0 4px 16px rgba(31, 30, 29, 0.10)</td><td><i class="cat-radius" style="box-shadow:var(--gemboss-shadow-raised);border:0"></i></td></tr><tr><td><code>--gemboss-shadow-overlay</code></td><td class="cat-small">0 16px 48px rgba(31, 30, 29, 0.18)</td><td><i class="cat-radius" style="box-shadow:var(--gemboss-shadow-overlay);border:0"></i></td></tr></tbody></table></section>
32
32
  <section id="buttons"><h2>Nút</h2><p>Một lớp <code>ui-btn</code>, ba biến thể, tông đỏ, một cỡ nhỏ. Cao 28px dưới chuột như Button của Polaris (ô nhập và ô chọn 32, như TextField), 44px dưới ngón tay và ở khổ điện thoại, cỡ nhỏ cũng vậy. Dùng được trên <code>&lt;button&gt;</code> lẫn <code>&lt;a&gt;</code> (căn giữa sẵn).</p><figure class="cat-demo"><figcaption>Mặc định · chính · ghost · nhỏ · tắt</figcaption><div class="cat-live"><div class="cat-row"><button type="button" class="ui-btn">Lưu nháp</button><button type="button" class="ui-btn ui-btn--primary">Xuất bản</button><button type="button" class="ui-btn ui-btn--ghost">Huỷ</button><button type="button" class="ui-btn ui-btn--sm">Nhỏ</button><button type="button" class="ui-btn ui-btn--primary" disabled>Đang lưu…</button><a class="ui-btn" href="#buttons">Link dạng nút</a></div></div><details class="cat-code"><summary>Markup</summary><pre><code>&lt;div class=&quot;cat-row&quot;&gt;
33
33
  &lt;button type=&quot;button&quot; class=&quot;ui-btn&quot;&gt;Lưu nháp&lt;/button&gt;
@@ -13032,7 +13032,7 @@ document.querySelector(&quot;.gb-tc-body&quot;).append(tc.jumpToLatest({ count:
13032
13032
  &lt;/section&gt;
13033
13033
  &lt;/div&gt;
13034
13034
  &lt;/div&gt;</code></pre></details></figure></section>
13035
- <section id="assistant"><h2>Trợ lý: cột phiên</h2><p><code>SessionRail</code> (React). Khung toàn màn hình / cửa sổ nổi / cột phải cao hết màn (<code>allowSide</code>) / thanh là <code>AssistantHost</code>, cần React vì có trạng thái.</p><figure class="cat-demo"><figcaption>SessionRail</figcaption><div class="cat-live"><div style="height:360px;display:flex"><aside class="gemboss-assistant-rail"><div class="gemboss-assistant-rail-top"><button type="button" class="gemboss-assistant-newchat" title="Phiên mới"><svg viewBox="0 0 20 20" aria-hidden="true" focusable="false"><g fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"><path d="M11 4H5.5A1.5 1.5 0 0 0 4 5.5v9A1.5 1.5 0 0 0 5.5 16h9a1.5 1.5 0 0 0 1.5-1.5V9"></path><path d="M14.5 3.5l2 2L10 12H8v-2z"></path></g></svg><span>Phiên mới</span></button><button type="button" class="gemboss-assistant-collapse" aria-label="Collapse sidebar" title="Collapse"><svg viewBox="0 0 20 20" aria-hidden="true" focusable="false"><g fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"><path d="M12 5l-5 5 5 5"></path></g></svg></button></div><div class="gemboss-assistant-search gemboss-field gemboss-field--group"><svg viewBox="0 0 20 20" aria-hidden="true" focusable="false"><g fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"><circle cx="9" cy="9" r="5"></circle><path d="M13 13l3.5 3.5"></path></g></svg><input class="gemboss-field__bare" placeholder="Tìm phiên…" aria-label="Search history" value=""/><kbd class="gemboss-assistant-kbd">/</kbd></div><div class="gemboss-assistant-threads"><div class="gemboss-assistant-group"><div class="gemboss-assistant-group-label">Đã ghim</div><div class="gemboss-assistant-thread"><button type="button" class="gemboss-assistant-thread-main" title="So sánh advertorial với listicle"><span class="gemboss-assistant-thread-titlerow"><svg viewBox="0 0 20 20" class="gemboss-assistant-pin-dot" aria-hidden="true" focusable="false"><path d="M8 3.5h4l-.5 5 2.5 2.5H6l2.5-2.5z" fill="currentColor"></path><path d="M10 11v5.5" stroke="currentColor" stroke-width="1.6" stroke-linecap="round"></path></svg><span class="gemboss-assistant-thread-title">So sánh advertorial với listicle</span></span><span class="gemboss-assistant-thread-meta">26/9/2026</span></button><div class="gemboss-assistant-thread-actions"><button type="button" class="gemboss-assistant-thread-act" aria-label="Options"><svg viewBox="0 0 20 20" aria-hidden="true" focusable="false"><g fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"><circle cx="5" cy="10" r=".8"></circle><circle cx="10" cy="10" r=".8"></circle><circle cx="15" cy="10" r=".8"></circle></g></svg></button></div></div></div><div class="gemboss-assistant-group"><div class="gemboss-assistant-group-label">Hôm nay</div><div class="gemboss-assistant-thread active"><button type="button" class="gemboss-assistant-thread-main" title="Store nào đang dựng loạt landing?"><span class="gemboss-assistant-thread-titlerow"><span class="gemboss-assistant-thread-title">Store nào đang dựng loạt landing?</span></span><span class="gemboss-assistant-thread-meta">3 giờ trước</span></button><div class="gemboss-assistant-thread-actions"><button type="button" class="gemboss-assistant-thread-act" aria-label="Options"><svg viewBox="0 0 20 20" aria-hidden="true" focusable="false"><g fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"><circle cx="5" cy="10" r=".8"></circle><circle cx="10" cy="10" r=".8"></circle><circle cx="15" cy="10" r=".8"></circle></g></svg></button></div></div></div><div class="gemboss-assistant-group"><div class="gemboss-assistant-group-label">Hôm qua</div><div class="gemboss-assistant-thread"><button type="button" class="gemboss-assistant-thread-main" title="Landing điểm cao nhất của corpus"><span class="gemboss-assistant-thread-titlerow"><span class="gemboss-assistant-thread-title">Landing điểm cao nhất của corpus</span></span><span class="gemboss-assistant-thread-meta">1 ngày trước</span></button><div class="gemboss-assistant-thread-actions"><button type="button" class="gemboss-assistant-thread-act" aria-label="Options"><svg viewBox="0 0 20 20" aria-hidden="true" focusable="false"><g fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"><circle cx="5" cy="10" r=".8"></circle><circle cx="10" cy="10" r=".8"></circle><circle cx="15" cy="10" r=".8"></circle></g></svg></button></div></div></div></div></aside></div></div><details class="cat-code"><summary>Markup</summary><pre><code>&lt;div style=&quot;height:360px;display:flex&quot;&gt;
13035
+ <section id="assistant"><h2>Trợ lý: cột phiên</h2><p><code>SessionRail</code> (React). Khung toàn màn hình / cửa sổ nổi / cột phải cao hết màn (<code>allowSide</code>) / thanh là <code>AssistantHost</code>, cần React vì có trạng thái.</p><figure class="cat-demo"><figcaption>SessionRail</figcaption><div class="cat-live"><div style="height:360px;display:flex"><aside class="gemboss-assistant-rail"><div class="gemboss-assistant-rail-top"><button type="button" class="gemboss-assistant-newchat" title="Phiên mới"><svg viewBox="0 0 20 20" aria-hidden="true" focusable="false"><g fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"><path d="M11 4H5.5A1.5 1.5 0 0 0 4 5.5v9A1.5 1.5 0 0 0 5.5 16h9a1.5 1.5 0 0 0 1.5-1.5V9"></path><path d="M14.5 3.5l2 2L10 12H8v-2z"></path></g></svg><span>Phiên mới</span></button><button type="button" class="gemboss-assistant-collapse" aria-label="Collapse sidebar" title="Collapse"><svg viewBox="0 0 20 20" aria-hidden="true" focusable="false"><g fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"><path d="M12 5l-5 5 5 5"></path></g></svg></button></div><div class="gemboss-assistant-search gemboss-field gemboss-field--group"><svg viewBox="0 0 20 20" aria-hidden="true" focusable="false"><g fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"><circle cx="9" cy="9" r="5"></circle><path d="M13 13l3.5 3.5"></path></g></svg><input class="gemboss-field__bare" placeholder="Tìm phiên…" aria-label="Search history" value=""/><kbd class="gemboss-assistant-kbd">/</kbd></div><div class="gemboss-assistant-threads"><div class="gemboss-assistant-group"><div class="gemboss-assistant-group-label">Đã ghim</div><div class="gemboss-assistant-thread"><button type="button" class="gemboss-assistant-thread-main" title="So sánh advertorial với listicle"><span class="gemboss-assistant-thread-titlerow"><svg viewBox="0 0 20 20" class="gemboss-assistant-pin-dot" aria-hidden="true" focusable="false"><path d="M8 3.5h4l-.5 5 2.5 2.5H6l2.5-2.5z" fill="currentColor"></path><path d="M10 11v5.5" stroke="currentColor" stroke-width="1.6" stroke-linecap="round"></path></svg><span class="gemboss-assistant-thread-title">So sánh advertorial với listicle</span></span><span class="gemboss-assistant-thread-meta">29/9/2026</span></button><div class="gemboss-assistant-thread-actions"><button type="button" class="gemboss-assistant-thread-act" aria-label="Options"><svg viewBox="0 0 20 20" aria-hidden="true" focusable="false"><g fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"><circle cx="5" cy="10" r=".8"></circle><circle cx="10" cy="10" r=".8"></circle><circle cx="15" cy="10" r=".8"></circle></g></svg></button></div></div></div><div class="gemboss-assistant-group"><div class="gemboss-assistant-group-label">Hôm nay</div><div class="gemboss-assistant-thread active"><button type="button" class="gemboss-assistant-thread-main" title="Store nào đang dựng loạt landing?"><span class="gemboss-assistant-thread-titlerow"><span class="gemboss-assistant-thread-title">Store nào đang dựng loạt landing?</span></span><span class="gemboss-assistant-thread-meta">3 giờ trước</span></button><div class="gemboss-assistant-thread-actions"><button type="button" class="gemboss-assistant-thread-act" aria-label="Options"><svg viewBox="0 0 20 20" aria-hidden="true" focusable="false"><g fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"><circle cx="5" cy="10" r=".8"></circle><circle cx="10" cy="10" r=".8"></circle><circle cx="15" cy="10" r=".8"></circle></g></svg></button></div></div></div><div class="gemboss-assistant-group"><div class="gemboss-assistant-group-label">Hôm qua</div><div class="gemboss-assistant-thread"><button type="button" class="gemboss-assistant-thread-main" title="Landing điểm cao nhất của corpus"><span class="gemboss-assistant-thread-titlerow"><span class="gemboss-assistant-thread-title">Landing điểm cao nhất của corpus</span></span><span class="gemboss-assistant-thread-meta">1 ngày trước</span></button><div class="gemboss-assistant-thread-actions"><button type="button" class="gemboss-assistant-thread-act" aria-label="Options"><svg viewBox="0 0 20 20" aria-hidden="true" focusable="false"><g fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"><circle cx="5" cy="10" r=".8"></circle><circle cx="10" cy="10" r=".8"></circle><circle cx="15" cy="10" r=".8"></circle></g></svg></button></div></div></div></div></aside></div></div><details class="cat-code"><summary>Markup</summary><pre><code>&lt;div style=&quot;height:360px;display:flex&quot;&gt;
13036
13036
  &lt;aside class=&quot;gemboss-assistant-rail&quot;&gt;
13037
13037
  &lt;div class=&quot;gemboss-assistant-rail-top&quot;&gt;
13038
13038
  &lt;button type=&quot;button&quot; class=&quot;gemboss-assistant-newchat&quot; title=&quot;Phiên mới&quot;&gt;
@@ -13081,7 +13081,7 @@ document.querySelector(&quot;.gb-tc-body&quot;).append(tc.jumpToLatest({ count:
13081
13081
  &lt;/svg&gt;
13082
13082
  &lt;span class=&quot;gemboss-assistant-thread-title&quot;&gt;So sánh advertorial với listicle&lt;/span&gt;
13083
13083
  &lt;/span&gt;
13084
- &lt;span class=&quot;gemboss-assistant-thread-meta&quot;&gt;26/9/2026&lt;/span&gt;
13084
+ &lt;span class=&quot;gemboss-assistant-thread-meta&quot;&gt;29/9/2026&lt;/span&gt;
13085
13085
  &lt;/button&gt;
13086
13086
  &lt;div class=&quot;gemboss-assistant-thread-actions&quot;&gt;
13087
13087
  &lt;button type=&quot;button&quot; class=&quot;gemboss-assistant-thread-act&quot; aria-label=&quot;Options&quot;&gt;