@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.
- package/CHANGELOG.md +153 -0
- package/README.md +163 -2
- package/catalog/editor.html +1 -1
- package/catalog/index.html +3 -3
- package/gemboss-ui.css +3 -3
- package/package.json +15 -1
- package/parts/components.css +3 -3
- package/parts/core.css +1 -1
- package/parts/shell.css +1 -1
- package/src/app-nav.css +1 -0
- package/src/app-nav.tsx +236 -0
- package/src/assistant/chat.tsx +67 -4
- package/src/assistant/dictation.ts +292 -0
- package/src/assistant/index.ts +4 -1
- package/src/audiences-table.css +1 -0
- package/src/audiences-table.tsx +167 -0
- package/src/chat-voice.css +1 -0
- package/src/editor/frame-context.ts +9 -0
- package/src/editor/index.ts +8 -0
- package/src/editor/inspector-frame.tsx +285 -0
- package/src/editor/label-side.ts +79 -0
- package/src/editor/panel.tsx +23 -6
- package/src/editor/repeater.tsx +9 -3
- package/src/editor-inspector-frame.css +1 -0
- package/src/editor.css +1 -1
- package/src/email-editor/editor.tsx +434 -0
- package/src/email-editor/index.ts +16 -0
- package/src/email-editor/model.ts +357 -0
- package/src/email-editor/preview.tsx +208 -0
- package/src/email-editor.css +1 -0
- package/src/gem-at-work.css +1 -0
- package/src/gem-at-work.ts +1165 -0
- package/src/index.ts +17 -1
- package/src/kit-plain.css +1 -1
- package/src/rail-mini.css +1 -0
- package/src/report-charts.css +1 -0
- package/src/shell.tsx +36 -8
- package/src/skill-feedback.css +1 -0
- package/src/skill-feedback.tsx +67 -0
- package/src/skill-history.css +1 -0
- package/src/skill-history.tsx +116 -0
- package/src/skill-pages.css +1 -0
- package/src/skill-pages.tsx +204 -0
- package/src/skill-tabs-group.tsx +45 -0
- 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`),
|
|
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
|
-
| `
|
|
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
|
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.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 "@gemboss/ui/editor.css";
|
|
14
14
|
import { EditorFrame, EditorTopbar, EditorBack, EditorChatToggle, EditorPaneTabs, EditorSaveState, DeviceToggle } from "@gemboss/ui/editor";
|
package/catalog/index.html
CHANGED
|
@@ -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.
|
|
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><button></code> lẫn <code><a></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><div class="cat-row">
|
|
33
33
|
<button type="button" class="ui-btn">Lưu nháp</button>
|
|
@@ -13032,7 +13032,7 @@ document.querySelector(".gb-tc-body").append(tc.jumpToLatest({ count:
|
|
|
13032
13032
|
</section>
|
|
13033
13033
|
</div>
|
|
13034
13034
|
</div></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">
|
|
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><div style="height:360px;display:flex">
|
|
13036
13036
|
<aside class="gemboss-assistant-rail">
|
|
13037
13037
|
<div class="gemboss-assistant-rail-top">
|
|
13038
13038
|
<button type="button" class="gemboss-assistant-newchat" title="Phiên mới">
|
|
@@ -13081,7 +13081,7 @@ document.querySelector(".gb-tc-body").append(tc.jumpToLatest({ count:
|
|
|
13081
13081
|
</svg>
|
|
13082
13082
|
<span class="gemboss-assistant-thread-title">So sánh advertorial với listicle</span>
|
|
13083
13083
|
</span>
|
|
13084
|
-
<span class="gemboss-assistant-thread-meta">
|
|
13084
|
+
<span class="gemboss-assistant-thread-meta">29/9/2026</span>
|
|
13085
13085
|
</button>
|
|
13086
13086
|
<div class="gemboss-assistant-thread-actions">
|
|
13087
13087
|
<button type="button" class="gemboss-assistant-thread-act" aria-label="Options">
|