@gemboss/ui 0.57.0 → 0.59.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 (53) hide show
  1. package/CHANGELOG.md +221 -0
  2. package/README.md +238 -0
  3. package/catalog/editor.html +1 -1
  4. package/catalog/index.html +4 -4
  5. package/gemboss-ui.css +3 -3
  6. package/node/skill-flow/layout.js +194 -0
  7. package/node/skill-flow/model.js +279 -0
  8. package/package.json +31 -1
  9. package/parts/components.css +1 -1
  10. package/parts/core.css +1 -1
  11. package/parts/shell.css +1 -1
  12. package/src/assistant/host.tsx +21 -5
  13. package/src/assistant/sessions.tsx +36 -18
  14. package/src/auth-sso-plain.js +1 -1
  15. package/src/auth.tsx +2 -0
  16. package/src/collections.css +1 -1
  17. package/src/collections.tsx +5 -2
  18. package/src/dialog.tsx +4 -1
  19. package/src/editor/controls.tsx +18 -7
  20. package/src/editor/index.ts +1 -1
  21. package/src/editor/picker.tsx +9 -3
  22. package/src/editor/repeater.tsx +26 -14
  23. package/src/editor/swatch.ts +86 -0
  24. package/src/editor-color.css +1 -1
  25. package/src/editor-picker.css +1 -1
  26. package/src/editor-plain.js +1 -1
  27. package/src/editor-popover.css +1 -1
  28. package/src/editor.css +1 -1
  29. package/src/index.ts +17 -0
  30. package/src/job-card.css +1 -0
  31. package/src/job-card.tsx +130 -0
  32. package/src/list-page.css +1 -1
  33. package/src/members-data.ts +278 -0
  34. package/src/members.css +1 -0
  35. package/src/members.tsx +868 -0
  36. package/src/menu-extras.css +1 -1
  37. package/src/menu-select.css +1 -0
  38. package/src/menu.tsx +39 -12
  39. package/src/narration.css +1 -0
  40. package/src/save-bar.css +1 -0
  41. package/src/save-bar.tsx +50 -0
  42. package/src/skill-card.css +1 -0
  43. package/src/skill-card.tsx +146 -0
  44. package/src/skill-flow/canvas.tsx +593 -0
  45. package/src/skill-flow/index.ts +12 -0
  46. package/src/skill-flow/layout.ts +238 -0
  47. package/src/skill-flow/model.ts +412 -0
  48. package/src/skill-flow.css +1 -0
  49. package/src/skill-stats.css +1 -0
  50. package/src/skill-stats.tsx +213 -0
  51. package/src/skill-view.css +1 -0
  52. package/src/skill-view.tsx +249 -0
  53. package/src/theme-dark.css +1 -1
package/CHANGELOG.md CHANGED
@@ -4,6 +4,227 @@ 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.59.0 (04/11/2026)
8
+
9
+ **Members: one members list for every service** (04/11/2026, Chris approved the design "GemBoss Members Pattern": GemCare's People
10
+ screen made calmer, for GemCommunity Admin › Members, GemCare People and the other admins).
11
+
12
+ Added
13
+ - `MembersPage` (`people`, `roles`, `scopes`, `currentUserId`, `filters`, `columns`, `rowActions`, `inlineAction`, `drawerActions`,
14
+ `detail`, `canChangeRole`, `onRoleChange`, `onInvite`, `onCheckImport`, `onImport`, `notice`, `secondaryActions`, `labels`, and
15
+ `filter` / `query` / `selectedId` to hold them yourself): inside `ListPage`, the chips All · Team · Pending + the app's own with
16
+ their counts, the search (accents folded), the table (Person · a role select per scope · Status · the app's columns · Last
17
+ active · one inline action and the ⋯), a role change confirmed on the row (Change / Cancel, then Undo in a toast; never
18
+ `window.confirm`; your own row read-only), Invite as a two-tab popup (one person; many from a CSV: Check shows each line, then
19
+ Import N), a row opening a `Sheet` with the kit's part and the app's `detail` slot, and cards below a 640px column. Every word
20
+ from `labels` (`MEMBERS_LABELS`). Its own entry, `@gemboss/ui/members.css`; the `gb-members-*` classes are the plain-HTML contract
21
+ (README "Members").
22
+ - `@gemboss/ui/members-data` (also from the index): `parseMembersCsv`, `memberCounts`, `visibleMembers`, `roleChangeStep`,
23
+ `lastRoleGuard`, `foldText`, `roleOf` and the types (`MemberPerson`, `MemberRole`, `MemberScope`, …). No React, no stylesheet.
24
+
25
+ **ListPage's header actions read in dark** (04/11/2026, seen on GemCommunity's doc reader: "Copy link", "Full screen" and ⋯ were
26
+ #e3e3e3 under near-white words). Fixed: their fill reads `--gemboss-fill-tertiary`, `-hover`, `-active` (new, dark values in
27
+ `theme-dark.css`: #2a2b33 / #33353f / #3a3c46, 12.7:1 to 9.9:1 for the dark text) before Polaris' light hex, which stays the fallback,
28
+ so light pages and the admin (Polaris loaded) are unchanged. `list-page-browser.test.ts` case 10 holds 4.5:1 in dark, hovered too.
29
+
30
+ **"Continue with GemBoss" says `?sso=not_company`** (04/11/2026, Chris: every staff console admits only @gemboss.ai and
31
+ @gemcommerce.com addresses). A console that refuses a GemBoss account off those domains sends the browser back with
32
+ `?sso=not_company`; `AuthContinueWithGemBoss` and its plain twin `auth-sso-plain.js` now say "Use your @gemboss.ai or
33
+ @gemcommerce.com account." under the button (before, an unknown reason read as "That sign-in did not go through").
34
+
35
+ **The skills UI takes content-radar's slots, so content-radar can draw its cards, family groups and skill popup with the kit and keep
36
+ its look** (04/11/2026, Chris: "Kit thêm slot, giữ giao diện content-radar"; the eight gaps gemlabs #1567 found when it moved its flow
37
+ canvas onto `SkillFlow`). Every addition is optional: GemBoss's Assistant › Skills draws what it drew before.
38
+
39
+ Added
40
+ - `@gemboss/ui/skill-flow/model` and the new `@gemboss/ui/skill-flow/layout` (`layoutFlow`, `nodeSize`: dagre, no React) ship as plain
41
+ JavaScript too, under the `node` export condition of the PUBLISHED manifest (`node/skill-flow/*.js`, compiled from the .ts by
42
+ `build()`, scripts/pack-lib.mjs `NODE_COPIES` / `stagedManifest`): Node imports them from node_modules with no TypeScript step (an
43
+ MCP server, a script, `node --test`). A bundler and TypeScript keep the .ts (`types`, `default`); the repo's own manifest stays on
44
+ the .ts, since the admin's server code imports the model and the copies exist only after a build. layout.ts reads dagre 1.x
45
+ (CommonJS) as well as 3.x in plain Node.
46
+ - `validateFlow(input, { phases, messages })`: a problem is a code with params (`FlowProblemParams`, `FlowProblemCode`), the words a
47
+ table the caller may replace in part or whole (`FlowMessages`; `FLOW_MESSAGES` is the English, word for word as before), and the
48
+ error a `FlowError` whose `problems` are the list as data (`{ code, params, at? }`, `at` a node, one of its examples or an edge);
49
+ `flowProblemText` says one. `layoutFlow` and `SkillFlow` take `messages` too.
50
+ - `SkillFlow`: `noteTone="bad"` (the note in the danger tint, said as an alert: a broken flow.json drawn with a stand-in);
51
+ `highlight` puts `data-lit` on the lit lane and its boxes, and the lane gets a 2px ink ring inside (content-radar's "this article is
52
+ here", drawn by the kit now). `SkillFlowLabels` gains `legend` (the legend's name for a screen reader) and `expandTip` (the Expand
53
+ button's tooltip); left out, each takes the words it used to borrow (`fullTitle`, `expand`), so a surface that renamed those keeps
54
+ them. `skillFlowLabels(labels)` is that merge.
55
+ - `SkillViewBody` (`SkillViewBodyProps`): the popup's head and tabs without the dialog, for a pane or the preview beside an "Edit with
56
+ AI" chat; its tab row sticks to the top of whatever scrolls round it and stays inside its edges. `SkillView` is a ReaderDialog round
57
+ it (`className="ui-reader__scroll"`), as before. Both take `iconSize` (a picture of its own, a 96px mascot, bare instead of the 44px
58
+ tile, the head wider and centred), `callout` + `calloutLabel` (a tinted box, its label in small caps before the first line:
59
+ content-radar's "Kitchen"), `badges` (the kit's `ui-badge`, after the facts; a long one wraps), `note` (a quiet line under them:
60
+ "Suggested when: …") and `tabsLabel`. `intro` is a block now, so two lines (English and a muted translation) fit.
61
+ - `SkillCard`: `iconSize` (a 72px mascot, bare), `badgeTone` (`new` iris, the default; `ready` green; `beta` amber; `research` /
62
+ `later` grey), `aside` (a second name after the title), `children` (under the line, inside the card: a framework's steps, a usage
63
+ line), `extra` (more of the foot after `meta`: a style, a voice), `actions` (with them the card is a frame: its body the link or
64
+ button, the actions in a bar under it with `meta` and `extra`, OUTSIDE the link) and `size="lg"` (content-radar's room: 18px in, 16px
65
+ corners, a 16px title, the line at most two lines). `SkillCardProps`, `SkillBadgeTone`.
66
+ - `SkillGroup`: `mark` (a coloured square before the name, any CSS colour), `aside` (its second name) and `minCardWidth` (px; default
67
+ 220, content-radar 270). `SkillGroupProps`.
68
+
69
+ Changed
70
+ - `SkillGroup` and `SkillCard` live in skill-card.tsx with their own entry, `@gemboss/ui/skill-card.css` (the component imports it; a
71
+ page that writes the markup links it beside skill-view.css). Their rules left skill-view.css, whose ceiling went down with them.
72
+
73
+ **A long band name breaks inside its row** (04/11/2026, gemboss #6507 gave a band an agent authors its own name, up to 60
74
+ characters). Fixed: `.gemboss-layer-type` (Layers, the Canvas section list) and the text of `.gemboss-pageedit-chip` ("Selected: …")
75
+ break a word longer than the row (`overflow-wrap: anywhere`, which also lets a flex item shrink below the word), and the chip's
76
+ buttons keep their size (`flex: none`); `.gemboss-ei-title` (the panel head, whose `overflow: hidden` cut the word) breaks it with
77
+ `break-word`, so a short title in a box sized to its content is never broken mid-word. The ceiling of
78
+ packages/ui/src/editor.css goes from 8690 to 8730 B gzip for it (+40 B; Chris approved, 04/11/2026).
79
+
80
+ **A menu in parts whose rows say what each one is** (04/11/2026, GemX on the UI Book, board ubm-PZ-2: Funnels › Audiences' "+ Add a
81
+ condition", and the When / Then menus of a moment after it).
82
+
83
+ Added
84
+ - `Menu` takes `text`: a text trigger (the words after `icon`, in the link colour, no box), 24px tall under a mouse and 44 under a
85
+ finger or below 768; the words name it, `label` still names the list. Without `text` it is the ⋯ it was.
86
+ - `MenuItem` takes `icon` (a 16px mark before the label, muted ink) and `description` (one muted caption line under the label, which
87
+ wraps). The tag at a row's end ("New", "Later") is its `hint`, and a row not built yet is `disabled`, as before.
88
+ - `MenuGroup` takes `overline`: its title in small capitals, for a menu of actions in parts ("Known before the page shows · can pick
89
+ a page"). A group of choices keeps its plain title.
90
+ - In `menu-extras.css` (0.7 KB gzip, under its ceiling). Tests: `menu-sections.test.tsx`.
91
+
92
+ ## 0.58.0 (04/11/2026)
93
+
94
+ **The shared skills UI: a job card for the chat, a skill popup, a skill's usage, and a skill's flow on its own lazy entry** (03/11/2026,
95
+ Chris approved the plan "Clone cả store", S5: GemBoss's Assistant › Skills and content-radar's /v2/skills draw the same pieces).
96
+
97
+ Added
98
+ - `JobCard` (`title`, `meta`, `progress`, `steps`, `maxSteps`, `actions`, `labels`) and `jobStepWindow` / `jobProgressShare` (pure): a
99
+ background job pinned in a narrow chat panel or a phone; a thin iris bar, steps as dots with their state in words, at most four round
100
+ the running step and "+N more". Its own entry, `@gemboss/ui/job-card.css`.
101
+ - `SkillView` (a `ReaderDialog` with `back`, `icon`, `intro`, `facts`, `why` and `tabs` as slots; a tab with no content is not drawn),
102
+ `SkillViewSection`, `SkillRuleList`, `SkillGroup` and `SkillCard` (the list it opens from: a job's cards; an icon tile, a title, one
103
+ line, "advertorial · v2"), `SKILL_VIEW_TABS`. Its own entry, `@gemboss/ui/skill-view.css`.
104
+ - `SkillStats` (one entry of the skills usage read: runs, stores, engines with at least one run as a `ShareBar`, outcomes, the rule that
105
+ blocked most, fidelity, published share, versions side by side; "No runs yet" otherwise), `SKILL_ENGINES`, `engineParts`. Its own
106
+ entry, `@gemboss/ui/skill-stats.css`.
107
+ - `@gemboss/ui/skill-flow`: `SkillFlow`, the read-only flow canvas lifted from content-radar (React Flow + dagre), with the lanes a prop
108
+ (`phases`) instead of content-radar's writer phases, and `layoutFlow`; `@gemboss/ui/skill-flow/model`: `validateFlow(input, { phases })`,
109
+ `flowWithHtml`, `phasesIn`, `shortTool`, the zoom maths. Its own entry, `@gemboss/ui/skill-flow.css`. `@xyflow/react` (>= 12.3) and
110
+ `@dagrejs/dagre` (>= 1.1) are OPTIONAL peers: only this entry imports them, never the index.
111
+ - `Dialog` (and so `ReaderDialog`) takes `lead`: a node first in the head, left of the title ("← Skills"), not part of the popup's name.
112
+
113
+ **A form that holds what it has not saved has the kit's Save bar** (03/11/2026, KIT-004, canvas frame-save-toast).
114
+
115
+ Added
116
+ - `SaveBar` (`dirty`, `saving`, `onSave`, `onDiscard`; `message`, `saveLabel`, `discardLabel`, `error`): the ink bar above a form saved
117
+ on its own route, "Unsaved changes" with Discard beside Save. It draws nothing while nothing waits, both buttons are off while a save
118
+ runs (Save reads "Saving…"), and a refused save's reason is said in it as an alert. Its own entry, `@gemboss/ui/save-bar.css`. The
119
+ admin's Focus frame drew it as `FocusSaveBar` until now; that part is now this one.
120
+
121
+ **A mix at shares reads and paints too** (03/11/2026, the admin's gradient rows, Control UI C13).
122
+
123
+ Added
124
+ - In `swatch.ts`, `mixSides` (and `MixPart`): the two sides of an sRGB `color-mix` with their shares, as CSS reads them (a share
125
+ before or after the colour, on one side or on both when they make 100, none for half each). One reading of these rules: the
126
+ colour box uses it, and so does the admin's gradient Add.
127
+
128
+ Changed
129
+ - `mixOf` reads a mix at shares (`color-mix(in srgb, var(--gem-color-border) 75%, #eeeeee)`); each side carries its `share` and
130
+ whether the value wrote one (`weighted`). `mixName` says the shares when they are not half and half ("Border 75% + #eeeeee
131
+ 25%"), and `mixColor` paints at them. Shares that do not make 100 (CSS changes the alpha then) stay no mix.
132
+ - `ColorControl`'s title says "(half of each)" only for a half-and-half mix.
133
+ - `swatchWhy` (and `editor-plain.js`, which says the same) names a half-and-half mix as before, and says "A mix of colors. Type a
134
+ color to use your own." for any other `color-mix` instead of "Kept as written … not a gradient or a name". The plain script
135
+ does not name shares: its weight is at its ceiling.
136
+
137
+ **A mixed colour says what it mixes** (03/11/2026, the admin's gradient rows, Control UI C13).
138
+
139
+ Added
140
+ - In `swatch.ts`, `mixOf` / `mixName` / `mixColor`: `color-mix(in srgb, A, B)`, half of each, read when each side is a theme colour
141
+ or one colour (a gradient's "+ Add color" between theme colours writes one).
142
+ - `ColorControl` names such a value over its box ("Border + #eeeeee · Mix") instead of showing the code, and paints its swatch
143
+ with the mix when its `choices` say the theme colours; without them `swatchWhy` says "A mix of Border and #eeeeee, half of
144
+ each." instead of "Kept as written". `editor-plain.js` says the same (held by `editor-plain-swatch-why.test.ts`).
145
+
146
+ **A picker row's reason is never cut** (02/11/2026, the admin's Add products dialog at 320 px).
147
+
148
+ Fixed
149
+ - In `editor-picker.css`, `.gemboss-ei-pick-note`: a note longer than the row's whole line (a locked row's reason in a phone's
150
+ dialog: "Draft: shoppers can't see it, so it would show nothing.") wraps instead of ending in "…"; the rest gives way on that
151
+ row, as it already did when the note filled the line. A note that fits stays on its line before the rest, and the rows keep 56px.
152
+
153
+ **A list adds several rows in one write, and a picker ticks several** (02/11/2026, the admin's element panel, Control UI C24: a
154
+ product list's "+ Add products").
155
+
156
+ Changed
157
+ - `useKeyedRows`' `add` takes any number of rows (`add(...rows)`) and writes them in ONE commit, so several added together are one
158
+ save and one step to undo. One row, as every caller passes today, writes as before.
159
+
160
+ Added
161
+ - `PickerList`'s `checked` (a `ReadonlySet` of keys): the list is `aria-multiselectable`, every row in the set has the check and
162
+ `aria-selected`, and a pick is the caller's tick or untick. Without it the list chooses one, as before.
163
+
164
+ **A message sent into a running turn says when Gem reads it** (01/11/2026, the admin's chat, narration P4d).
165
+
166
+ Added
167
+ - In `narration.css`, `.gemboss-narr-steer-note`: the muted "· Gem reads it at its next step" after a message the seller sent into a
168
+ running turn, until its run reads it, and "· not read" when the turn ended first. It shares the plan card's waiting note's rule.
169
+
170
+ **A question stops the plan at its step** (01/11/2026, the admin's chat, narration P4c).
171
+
172
+ Added
173
+ - In `narration.css`, `.gemboss-narr-plan-wait`: the muted "· waiting for your answer" after the plan card's step a question stopped
174
+ the turn at, drawn as the step being worked on (`.current`) until the seller answers.
175
+
176
+ **The turn's plan is one card at its top** (01/11/2026, the admin's chat, narration P4a).
177
+
178
+ Changed
179
+ - `@gemboss/ui/narration-link.css` is now `@gemboss/ui/narration.css`: the narration timeline's own entry, as it now holds more than
180
+ a step's link (its Undo from here, and the plan card). Its one consumer, admin `NarrationTimeline`, imports the new name.
181
+
182
+ Added
183
+ - In `narration.css`, the plan card: `.gemboss-narr-plan` (one card first in the turn's list), its head and count ("Plan · 2 of 4"),
184
+ and each step (`.gemboss-narr-plan-step` `.done` / `.current`). Nothing in it moves; open steps are muted, never crossed out.
185
+
186
+ **An activity row can show its kind with an icon** (01/11/2026, the admin's Store › Journal, UI book ST-7: "rows are bare dots").
187
+
188
+ Added
189
+ - `CompactList variant="activity"`: an item's `icon` is drawn in the dot's place, in the existing 20px `.ui-list__icon` slot, which
190
+ the activity list makes opaque and positioned so the rail does not run through it (one rule, +8 bytes gzip). The icon carries its
191
+ own colour; `tone` colours the dot only. Without `icon` the row is as before.
192
+
193
+ **A step in the chat can show its section** (31/10/2026, the page editor's chat, narration P3a).
194
+
195
+ Added
196
+ - `@gemboss/ui/narration-link.css` (31/10/2026), its own entry: in the page editor's chat, a step that touched a section of the page is
197
+ a button that selects that section on the canvas (`.gemboss-narr-link`, admin `NarrationTimeline`). It reads as the row's words,
198
+ underlined on hover and focus, 24px tall. Not in chat.css because the bundle that holds chat.css is frozen.
199
+
200
+ **The thread rail's first row can be the surface's, and its search can wait to be asked for** (31/10/2026, the admin's Gem page,
201
+ UI book AS-1).
202
+
203
+ Added
204
+ - `SessionRail` `head`: drawn in `.gemboss-assistant-rail-top` in place of New chat and collapse (the surface wires `onNewChat` and
205
+ `onToggleCollapsed` to its own buttons). `searchShown` (default true): false draws the search box only while it holds words;
206
+ `onSearchDone` says when it was left empty (Escape, or the focus gone). No CSS. Without them the rail is as before.
207
+
208
+ **The thread rail takes rows of the surface's own above the threads** (29/10/2026, the admin's chat corner, slice 3).
209
+
210
+ Added
211
+ - `SessionRail` `top`: drawn as given between search and the threads, in a collapsed rail and on a phone too (the surface styles
212
+ its rows for both). No CSS. Without it the rail is as before.
213
+
214
+ **The dock's header can say who you are talking to** (29/10/2026, the admin's chat corner, slice 1b).
215
+
216
+ Added
217
+ - `AssistantHost`: `heading` (what the header says in the title's place; `title` still names the region and the status bar),
218
+ `hideTabs` (keep both panes, draw no tab row: the surface switches itself) and `overlay` (a third pane over both, both stay
219
+ mounted; `false` is no overlay). No CSS: the overlay reuses `.gb-dock-pane`, the heading is the surface's own. Without them the
220
+ host is as before.
221
+
222
+ **A popover drawn in place opens under the whole row** (04/11/2026, gemboss: a label beside every setting that fits one row).
223
+
224
+ Fixed
225
+ - `editor-popover.css`: in a group's `Field row`, a `Popover` drawn in place (no top layer, `canFloatMenus()` false) spans both columns
226
+ instead of the ~150px control column. Floating popovers are unchanged.
227
+
7
228
  ## 0.57.0 (31/10/2026)
8
229
 
9
230
  **Collections · show the whole text when the text is the content** (31/10/2026, Content Radar: "các mục content in ra cần viết đầy đủ để
package/README.md CHANGED
@@ -56,6 +56,7 @@ its CSS out of the build with it (`sideEffects`). gzip of the minified file, as
56
56
  | core | `@gemboss/ui/core.css` | `parts/core.css` | the box-sizing reset + the tokens | 1.0 KB | every surface, first |
57
57
  | components | `@gemboss/ui/components.css` | `parts/components.css` | the kit (`ui.css`), the field look, the ⋯ menu and the icon button (`menu.css`), the plain-HTML primitives (`kit-plain.css`: chips, report pieces, popup body) | 8.2 KB | every surface, second |
58
58
  | menu | `@gemboss/ui/menu.css` | `packages/ui/src/menu.css` | the ⋯ menu and its icon button (23/10/2026, moved out of `kit-plain.css`, same rules): part of the core (components, just before `kit-plain.css`, where its rules stood) AND its own file | 0.6 KB | `Menu` imports it, so a surface without the core draws the menu: the admin loads `ui.css` and the shell, never `kit-plain.css` |
59
+ | menu-select | `@gemboss/ui/menu-select.css` | `packages/ui/src/menu-select.css` | the Menu as a select: a field trigger with the choice and a chevron (04/11/2026, its own entry) | 0.4 KB | `Menu` imports it |
59
60
  | shell | `@gemboss/ui/shell.css` | `parts/shell.css` | rail, topbar, main, mobile drawer, the thread rail, topbar slots, base text, page widths (`app-shell.css`) | 5.5 KB | every surface, third |
60
61
  | auth | `@gemboss/ui/auth.css` | `packages/ui/src/auth.css` | the sign-in screen (+ the grid backdrop, 0.30.0) | 2.8 KB | `AuthLayout` & co. import it |
61
62
  | auth-extras | `@gemboss/ui/auth-extras.css` | `packages/ui/src/auth-extras.css` | what the sign-in screen gained after the bundle froze (24/10/2026): the panel's screenshot window, "Forgot password?" on the Password row, the place of the row under the card | 0.7 KB | auth.tsx imports it beside auth.css; a plain page links it after auth.css |
@@ -72,6 +73,7 @@ its CSS out of the build with it (`sideEffects`). gzip of the minified file, as
72
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 |
73
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 |
74
75
  | editor-insert | `@gemboss/ui/editor-insert.css` | `packages/ui/src/editor-insert.css` | the page editor's insert menu (the + on a picked element) | 0.6 KB | admin `InsertElementMenu` imports it |
76
+ | 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 |
75
77
  | 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 |
76
78
  | reactions | `@gemboss/ui/reactions.css` | `packages/ui/src/reactions.css` | the emoji reactions and their picker | 0.8 KB | `Reactions` / `ReactionPicker` import it |
77
79
  | 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 |
@@ -85,6 +87,7 @@ its CSS out of the build with it (`sideEffects`). gzip of the minified file, as
85
87
  | team-chat | `@gemboss/ui/team-chat.css` | `packages/ui/src/team-chat.css` | the team chat layer (20/10/2026): rail, messages, composer, thread and people panels, the screen's layout | 3.6 KB | `TeamChat` and its pieces import it (with `Avatar`'s portal.css and `Reactions`' reactions.css); a plain-HTML page links it (README "The team chat layer") |
86
88
  | question-card | `@gemboss/ui/question-card.css` | `packages/ui/src/question-card.css` | `QuestionCard`: the assistant's one question with one to three answers, the pick chosen (0.43.0) | 0.9 KB | `QuestionCard` imports it |
87
89
  | briefing-card | `@gemboss/ui/briefing-card.css` | `packages/ui/src/briefing-card.css` | `BriefingCard`: one proposal at the top of a screen, on an iris wash (0.43.0) | 0.5 KB | `BriefingCard` imports it |
90
+ | save-bar | `@gemboss/ui/save-bar.css` | `packages/ui/src/save-bar.css` | `SaveBar`: the ink bar above a form that holds what it has not saved, Discard beside Save, a refused save said in it (KIT-004, unreleased) | 0.4 KB | `SaveBar` imports it; a plain-HTML page links it |
88
91
  | 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 |
89
92
  | 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 |
90
93
  | 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 |
@@ -93,6 +96,12 @@ its CSS out of the build with it (`sideEffects`). gzip of the minified file, as
93
96
  | status-matrix | `@gemboss/ui/status-matrix.css` | `packages/ui/src/status-matrix.css` | `StatusMatrix`: rows × columns of "live / total" cells on the kit table, all live or has drafts (unreleased) | 0.3 KB | `StatusMatrix` imports it; a plain-HTML page links it |
94
97
  | translation-row | `@gemboss/ui/translation-row.css` | `packages/ui/src/translation-row.css` | `TranslationRow`: one string under review, source beside target, the checks and the action (unreleased) | 0.6 KB | `TranslationRow` imports it; a plain-HTML page links it |
95
98
  | status-list | `@gemboss/ui/status-list.css` | `packages/ui/src/status-list.css` | `StatusList`: a quiet system-health strip, a dot, a name and one sentence each (unreleased) | 0.5 KB | `StatusList` imports it; a plain-HTML page links it |
99
+ | job-card | `@gemboss/ui/job-card.css` | `packages/ui/src/job-card.css` | `JobCard`: a background job pinned in a narrow chat panel or a phone, a thin bar, its steps as dots, "+N more" (03/11/2026, unreleased) | 0.9 KB | `JobCard` imports it |
100
+ | 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) |
101
+ | 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 |
102
+ | 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) |
103
+ | 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` |
104
+ | 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") |
96
105
  | 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) |
97
106
  | gem-holo | `@gemboss/ui/gem-holo.css` | `packages/ui/src/gem-holo.css` | `GemHolo`: Gem, alive, the four gems as one light that morphs and turns while Gem works; CSS only, still under reduced motion (unreleased) | 0.5 KB | `GemHolo` imports it; `@gemboss/ui/gem-holo` loads it after the page |
98
107
  | bundle | `@gemboss/ui/gemboss-ui.css` | `gemboss-ui.css` | core + components + shell + auth + assistant + chat + portal + theme-dark | 21.9 KB | compatibility only (see CHANGELOG 0.23.0) |
@@ -1900,6 +1909,19 @@ import { AppShell, BrandLockup, AccountMenu, AccountMenuItem, Icon, RailItem } f
1900
1909
 
1901
1910
  `menu-browser.test.ts` runs each of these on `Menu` and on plain markup with kit-plain.js, each with a negative control.
1902
1911
 
1912
+ A menu of actions in parts (Unreleased, 04/11/2026: Audiences' "+ Add a condition"): `<Menu label="Add a condition"
1913
+ text="Add a condition" icon={plus}>` opens from its words (link colour, no box, 24px / 44 under a finger); each part is a
1914
+ `MenuGroup overline` (its title in small capitals); each row a `MenuItem icon={mark} description="what it asks" hint="New"`
1915
+ (a 16px muted mark, the label over a muted caption line, the tag on the right); a row not built yet is `disabled` with
1916
+ `hint="Later"`. CSS in `menu-extras.css`; `menu-sections.test.tsx` holds the markup. One menu for every such list: no page
1917
+ draws its own.
1918
+
1919
+ A menu as a select (Unreleased, 04/11/2026: Who sees what's New moment, When and Then): `<Menu label="When" select="About to leave">`
1920
+ opens from a field as wide as its column (the choice, cut with "…", and a chevron; 32px, 44 under a finger or below 768), named
1921
+ "When: About to leave"; its rows are the parts above, the chosen one `checked`. CSS in its own entry, `menu-select.css`, which
1922
+ `Menu` imports; `menu-select.test.tsx` holds the markup. For a choice whose rows say more than an `<option>` can; a plain choice
1923
+ stays a select.
1924
+
1903
1925
  ## Topbar search (0.6.3)
1904
1926
 
1905
1927
  The admin's "Search ⌘K" box for every surface, as a real form (works with no JavaScript):
@@ -2876,6 +2898,221 @@ import { StagePath, StatusMatrix, TranslationRow, StatusList } from "@gemboss/ui
2876
2898
  <StatusList label="System" items={[{ key: "backups", label: "Backups", text: "nightly · last 22 Oct", tone: "ok", href: "#/settings" }]} />
2877
2899
  ```
2878
2900
 
2901
+ ## The skills UI (03/11/2026, unreleased): `JobCard`, `SkillView`, `SkillStats`, and `SkillFlow` on its own entry
2902
+
2903
+ GemBoss's Assistant › Skills and content-radar's /v2/skills show the same things about a skill (Chris approved the shared UI on
2904
+ 03/11/2026: "an idea lands in both"), so the pieces live here. content-radar drew them first (SkillDialog, SkillView, SkillFlow,
2905
+ 24–26/10/2026); these are those, with every content-radar import made a prop.
2906
+
2907
+ | Piece | What it draws |
2908
+ | --- | --- |
2909
+ | `JobCard` | a job running in the background, for a chat panel ≥ 340px and a phone: `title`, `meta` (one short line; `progress` adds "5/8" before it), `progress: { done, total }` as a 4px iris bar, `steps: [{ label, status }]` (`queued` · `running` · `done` · `failed` · `skipped`) as 7px dots with the state in words beside each, at most `maxSteps` (default 4) chosen round the running step (`jobStepWindow`, pure), the rest behind "+N more"; `actions: [{ label, onClick, primary?, href? }]` as kit buttons. No steps, no progress: a title and its line. Presentational: the surface fetches and polls. |
2910
+ | `SkillView` | one skill in the kit's `ReaderDialog`: `back` ("← Skills" first in the head), `icon`, `intro` (one line), `facts` (quiet chips), `why` (folded behind "Why?"), and `tabs: [{ key, label, count?, content }]`, a tab drawn only when its content is not null, in the order given (`SKILL_VIEW_TABS`: Overview · Flow · Rules · History · Lessons · Stats). The tab row is the kit's `ui-tabs`, sticks to the top while the body scrolls, and the arrow keys move along it. `tab` + `onTab` to hold the tab yourself, else `defaultTab`. `SkillViewSection` (a small heading, a one-line note, the body) and `SkillRuleList` (code, rule, one line, and how it is held: `door`, `gate`, `finish`, `publish`, `measured`, `seeded`, `declared`) are the blocks the tabs are made of. `SkillGroup` (a job's name, one line, a grid of cards) and `SkillCard` (a kit icon on an iris tile, the title, one line, a foot "advertorial · v2" and a stat when there is one; a button, or a link with `href`) are the list the popup opens from. Props only, no fetching. `SkillViewBody` is the popup's body without the dialog. content-radar's slots (04/11/2026), all optional: the head's `iconSize` (a mascot, bare), `callout` + `calloutLabel`, `badges`, `note`; a card's `iconSize`, `badgeTone`, `aside`, `children`, `extra`, `actions` (a bar outside the card's link) and `size="lg"`; a group's `mark`, `aside`, `minCardWidth`. |
2911
+ | `SkillStats` | ONE entry of the usage read both products answer (`GET …/skills/usage?days=N`: `runs`, `runs_7d`, `stores?`, `by_engine`, `outcomes`, `top_blocked_by`, `avg_fidelity`, `published_rate`, `last_used_at`, `by_version`). It draws the counts, who ran it (the kit's `ShareBar` over the engines with at least one run, in a fixed order with a fixed colour each, `SKILL_ENGINES`; one engine is a full bar and "All on Claude", no legend), how runs ended (dots and words, zero outcomes hidden), the rule that blocked it most, the percentages when known, and the versions side by side when there are two. No entry or no runs: "No runs yet", never a zero dressed as data. |
2912
+ | `SkillFlow` (`@gemboss/ui/skill-flow`) | a skill's flow as a read-only React Flow canvas: `flow` (checked by `validateFlow`), `phases: [{ key, label }]` (the lanes, the surface's own: GemBoss's packs Read · Frame · Build · Check, content-radar's writer phases), `labels`, `note` (`noteTone="bad"` for a problem), `highlight` (a phase key to light: `data-lit` and a ring on its lane), `toolPrefixes`, `mdClassName`, `messages` (validateFlow's words). Lanes side by side from a 1100px frame, one stream below; click a box for its details, tools, examples and next steps; zoom bar, ⌘ / Ctrl + wheel, + / − / 0; Expand opens it in a ReaderDialog nearly the whole window. |
2913
+
2914
+ **The flow canvas is its own entry, and it is lazy.** `@xyflow/react` and `@dagrejs/dagre` are OPTIONAL peers of the kit: only
2915
+ `@gemboss/ui/skill-flow` imports them, the index never does (`css-on-demand.test.ts` holds that the index's CSS has no flow in it).
2916
+ A surface that draws flows installs both and loads the entry where a flow is drawn:
2917
+
2918
+ ```tsx
2919
+ // Next: no server render (the canvas measures its frame before it places a box).
2920
+ const SkillFlow = dynamic(() => import("@gemboss/ui/skill-flow").then((m) => m.SkillFlow), { ssr: false });
2921
+ <SkillFlow flow={flow} phases={[{ key: "read", label: "Read" }, { key: "frame", label: "Frame" }, { key: "build", label: "Build" }, { key: "check", label: "Check" }]} />
2922
+ ```
2923
+
2924
+ `@gemboss/ui/skill-flow/model` is the data side alone, no peer: `validateFlow(input, { phases, messages? })` (one `FlowError` listing
2925
+ every problem, its `problems` as codes with params, the words English unless `messages` says them otherwise), `flowWithHtml`,
2926
+ `phasesIn`, `shortTool`, the zoom maths. A server checks a flow.json with it before a browser gets one. `@gemboss/ui/skill-flow/layout`
2927
+ is `layoutFlow` alone (dagre). The published package carries both as plain JavaScript under the `node` condition, so plain Node
2928
+ imports them from node_modules (04/11/2026).
2929
+ The flow format: `{ direction: "TB" | "LR", nodes: [{ id, label, kind: start | step | decision | stop | exit | end, phase,
2930
+ detail?, tools?, human?, examples?: [{ title, kind: input | output | good | bad | tool, md }] }], edges: [{ from, to, label?,
2931
+ kind: normal | yes | no | loop }] }`; one start, at least one end, no dead end, every node reachable.
2932
+
2933
+ **An app's bare `button:hover` rule cannot paint these.** content-radar's global rule painted a plain `<button>` tile black
2934
+ (gemlabs #1530); every button these pieces draw has its own class with its own hover and active states, and
2935
+ `skills-ui-browser.test.tsx` hovers each under that rule (negative control: a plain tile does turn black).
2936
+
2937
+ ```tsx
2938
+ import { JobCard, SkillView, SkillStats, SkillRuleList, SkillViewSection } from "@gemboss/ui";
2939
+
2940
+ <JobCard title="Clone store · glp1sos.com" meta="~3 min left" progress={{ done: 5, total: 8 }}
2941
+ steps={[{ label: "Header + footer", status: "done" }, { label: "Home page", status: "running" }, { label: "Shop all", status: "queued" }]}
2942
+ actions={[{ label: "View", primary: true, onClick: view }]} />
2943
+ <SkillView open={!!id} onClose={close} back={{ label: "Skills" }} title="Advertorial" subtitle="advertorial · v2"
2944
+ intro="A pre-sell page that warms a stranger before the offer." tabs={[
2945
+ { key: "flow", label: "Flow", content: flow ? <SkillFlow flow={flow} phases={PHASES} /> : null },
2946
+ { key: "rules", label: "Rules", count: rules.length, content: <SkillRuleList rules={rules} /> },
2947
+ { key: "stats", label: "Stats", content: <SkillStats usage={usage} days={30} /> },
2948
+ ]} />
2949
+ ```
2950
+
2951
+ ## Members (04/11/2026, unreleased): `MembersPage`, one members list for every service
2952
+
2953
+ Chris approved the pattern on 04/11/2026 (design "GemBoss Members Pattern"): GemCommunity Admin › Members, GemCare People and
2954
+ the other admins list their people the same way. It is GemCare's People screen made calmer: the list first, one layer at a time.
2955
+ Invite, the CSV import and one person's details open when asked for; security stays in Settings and the page shows one line
2956
+ when there is something to do there. The kit draws the frame, the table, the role selects, the inline confirm, Invite, the
2957
+ CSV check, the drawer and the phone cards; an app declares its roles, scopes, chips, columns, ⋯ actions and drawer slot.
2958
+
2959
+ ```tsx
2960
+ import { MembersPage, lastRoleGuard } from "@gemboss/ui";
2961
+
2962
+ <MembersPage
2963
+ people={people} // [{ id, name, email, avatar?, status, role? | roles?: { [scopeId]: roleId }, lastActive?, signIn? }]
2964
+ roles={[{ id: "admin", label: "Admin", staff: true }, { id: "mod", label: "Mod", staff: true }, "member"]}
2965
+ scopes={[{ id: community.slug, label: community.name }]} // GemCare: two workspaces
2966
+ currentUserId={me.id}
2967
+ filters={LIFECYCLE_CHIPS} columns={[chapterCol, lifecycleCol, levelCol]}
2968
+ canChangeRole={lastRoleGuard(people, "admin")}
2969
+ onRoleChange={(person, scope, role) => api("set-role", { userId: person.id, scope, role })}
2970
+ onInvite={invite} onCheckImport={checkCsv} onImport={importCsv}
2971
+ rowActions={[moveChapter, tag, { label: "Remove from group", danger: true, onAction: remove }]}
2972
+ inlineAction={(p) => (p.status === "pending" ? { label: "Approve", onAction: () => approve(p) } : null)}
2973
+ drawerActions={(p) => [{ label: "Sign out everywhere", onAction: signOut }, { label: "Lock", danger: true, onAction: lock }]}
2974
+ detail={(person) => <CommunityProfile person={person} />}
2975
+ notice={unsecured ? { message: `${unsecured} staff without 2FA`, action: { label: "See in Settings", href: "/settings/security" } } : null}
2976
+ secondaryActions={[{ content: "Export CSV", url: "/members.csv", external: true }]}
2977
+ labels={MEMBERS_VI} // any subset of MEMBERS_LABELS; English is the default
2978
+ />
2979
+ ```
2980
+
2981
+ | Part | What it does |
2982
+ | --- | --- |
2983
+ | Frame | the kit's `ListPage`: `title` (default "Members"), one count line (`labels.count`: "28 members · 3 on the team · 2 pending", or your `subtitle`), Invite (when `onInvite` or `onImport` is given) and `secondaryActions`, the `notice` line, then the list's states: `state="loading"` / `"error"` (+ `error`) from the host; empty (`empty`, default "No members yet" + Invite) and "Nobody matches" + Clear filters worked out here |
2984
+ | Chips | a fixed group, **All · Team · Pending**, then the app's `filters: [{ id, label, test(person), count? }]` after a thin line, each with its count over everyone; one on at a time (`aria-pressed`, the on one in ink). Team = holds a role declared `staff` in any scope (not drawn when no role is); Pending = `pending` or `invited` (drawn while someone is). `filter` + `onFilterChange` to hold it yourself (a URL) |
2985
+ | Search | name and email, accents and case folded ("le" finds "Lê"); `query` + `onQueryChange` to hold it |
2986
+ | Table | the kit's `ui-table` (13px, its cells), flush in the card. **Person** is the row header (avatar, name as a button, "you", the email under it) · **Role**, one select per scope (the scope's label as the column's when there are several) · **Status** (a dot and a word: `active` · `pending` · `invited` · `locked`) · the app's `columns: [{ id, header, cell(person), numeric? }]` · **Last active** (`person.lastActive`, worded by the host) · the row's `inlineAction` (one, never a dangerous one) and its ⋯ (`rowActions`, an array or a function of the person; `danger` rows come last, after a line, in red; `when(person)` hides one) |
2987
+ | A role change | choosing a new role tints the row and floats **"Change to Mod?" Change · Cancel** over the row's end, so no column moves; Escape or Cancel puts it back (focus on the select). Change awaits `onRoleChange(person, scopeId, roleId)`, then a toast says it with **Undo** for `undoMs` (6 s; it waits while pointed at or focused), which calls `onRoleChange` with the old role. A rejected promise says so in a red toast and leaves the role. One change at a time (`roleChangeStep`). Never `window.confirm`. No Undo when the person had no role in that scope (taking them out of it is a ⋯ action) |
2988
+ | Read-only | your own row (`currentUserId`), whatever the host says; any role `canChangeRole(person, scopeId)` answers `false` or a reason for (the reason is the box's title); every role when there is no `onRoleChange`. Drawn as the same box, dashed, with no caret. `lastRoleGuard(people, "admin", scopes?, reason?)` is the common rule: the last unlocked holder of a role in a scope keeps it |
2989
+ | Drawer | a press on a row (or its name, Enter on it) opens a `Sheet`: avatar, name, email, the row's ⋯ in its head; **Roles** (a select per scope, the same inline confirm under it), Status; **Sign-in** (`person.signIn: { method?, twoFactor?, last? }`, 2FA as an On / Off tag) and `drawerActions(person)` as buttons (danger ones in red); then the app's slot, `detail(person)`. Escape closes it (while a change waits, Escape cancels the change first); focus goes back to the row's name. `selectedId` + `onSelect` to hold it in the URL |
2990
+ | Invite | a kit `Dialog`, two tabs (arrow keys move between them). **One person**: name, email, role, scope (when several); a bad email is said under the field; `onInvite({ name, email, role, scope })`; a rejection is said in the popup. **Many (CSV)**: paste or Choose a file, Check → each line as ✓ new, ✓ has an account (adds the role), or ! "Line 4: email not valid" skipped → **Import N people** → `onImport(rows)`. The component parses (`parseMembersCsv`) and, when given, asks `onCheckImport(rows)` what the host knows (`[{ email, scope?, existing?, problem? }]`); the host does every write |
2991
+ | Phone | below a 640px column (a container query on `.gb-members`, so the admin at 768 beside its rail gets it too): cards (avatar, name, "Role · Status · last active", the inline action or ›), the chips in one row that scrolls sideways, the search across; the role is changed in the drawer, which is the whole screen |
2992
+ | Words | every word from `labels` (`MEMBERS_LABELS` has them in English; `statuses` merges by key). Pass vi / zh |
2993
+
2994
+ **The CSV.** One person per line: `email, name, role, scope`. A first line of column names is read as the header (`email`,
2995
+ `name`, `role`, `scope` or `workspace`, in any order; other columns are ignored), else that order. A role or a scope by its id or
2996
+ its label, any case; none takes `defaultRole` (else the last role declared, the least) and the first scope. `"…"` may hold a comma;
2997
+ semicolons or tabs when the first line has more of them. Blank and `#` lines are skipped. A line is skipped, with its line number
2998
+ and why, for an email that is not one, a role or scope that does not exist, or an email already on an earlier line (same scope).
2999
+ `parseMembersCsv` and the rest of the rules (`memberCounts`, `visibleMembers`, `roleChangeStep`, `lastRoleGuard`, `foldText`) are
3000
+ plain data in `@gemboss/ui/members-data`, no React, no stylesheet: a server checks an import with the same rules.
3001
+
3002
+ ### Plain HTML: `gb-members-*`
3003
+
3004
+ A surface with no React (GemCare) links `@gemboss/ui/members.css` beside the core, `portal.css` (the avatar) and, for the drawer,
3005
+ `sheet.css`; it writes this markup and does the behaviour itself (filtering, the confirm, the drawer with `showModal()`; kit-plain.js
3006
+ gives the toast and the ⋯ menu). `members.test.tsx` holds every `gb-members-*` class below to one `members.css` styles.
3007
+
3008
+ <!-- members: plain -->
3009
+ ```html
3010
+ <div class="gb-members">
3011
+ <div class="ui-list-page">
3012
+ <header class="ui-list-page__head">
3013
+ <div class="ui-list-page__title-row"><h1 class="ui-list-page__title">People</h1></div>
3014
+ <p class="ui-list-page__subtitle">9 people · 1 locked</p>
3015
+ <div class="ui-list-page__actions"><button type="button" class="ui-btn ui-btn--primary">Invite</button></div>
3016
+ </header>
3017
+ <div class="ui-list-page__notices">
3018
+ <div class="gb-members-notice gb-members-notice--warning">
3019
+ <span class="gb-members-notice__text">2 staff without 2FA</span>
3020
+ <a class="gb-members-notice__action" href="/settings/security">See in Settings</a>
3021
+ </div>
3022
+ </div>
3023
+ <div class="ui-list-page__toolbar">
3024
+ <div class="gb-members-bar">
3025
+ <div class="gb-members-chips" role="group" aria-label="Show">
3026
+ <button type="button" class="gb-members-chip" aria-pressed="true">All<span class="gb-members-chip__n">9</span></button>
3027
+ <button type="button" class="gb-members-chip" aria-pressed="false">Locked<span class="gb-members-chip__n">1</span></button>
3028
+ <span class="gb-members-sep" aria-hidden="true"></span>
3029
+ <button type="button" class="gb-members-chip" aria-pressed="false">GemPages care<span class="gb-members-chip__n">7</span></button>
3030
+ </div>
3031
+ <input type="search" class="gemboss-field gb-members-search" placeholder="Search name or email" aria-label="Search members">
3032
+ </div>
3033
+ </div>
3034
+ <section class="ui-card ui-list-page__card">
3035
+ <div class="gb-members-scroll">
3036
+ <table class="ui-table gb-members-table">
3037
+ <thead><tr><th scope="col">Person</th><th scope="col">GemBoss care</th><th scope="col">GemPages care</th><th scope="col">Status</th>
3038
+ <th scope="col">Last active</th><th scope="col" class="gb-members-actions"><span class="ui-sr-only">Actions</span></th></tr></thead>
3039
+ <tbody>
3040
+ <tr class="gb-members-row gb-members-row--changing">
3041
+ <th scope="row" class="gb-members-person">
3042
+ <span class="gb-members-who">
3043
+ <span class="gb-avatar gb-avatar--32" data-tone="1" aria-hidden="true">LT</span>
3044
+ <span class="gb-members-who__text">
3045
+ <span class="gb-members-who__line"><button type="button" class="gb-members-name">Linh Trần</button></span>
3046
+ <span class="gb-members-email">linh.tran@gem.example</span>
3047
+ </span>
3048
+ </span>
3049
+ </th>
3050
+ <td><select class="ui-select ui-select--slim gb-members-role gb-members-role--changing" aria-label="GemBoss care role for Linh Trần">
3051
+ <option value="supervisor" selected>Supervisor</option><option value="cs_agent">CS agent</option></select></td>
3052
+ <td><span class="gb-members-role gb-members-role--ro" title="An admin of this workspace keeps the role.">Admin</span></td>
3053
+ <td><span class="gb-members-status"><i class="gb-members-dot" aria-hidden="true"></i>Active</span></td>
3054
+ <td class="gb-members-last">3 hours ago</td>
3055
+ <td class="gb-members-actions">
3056
+ <span class="gb-members-confirm" role="group" aria-label="Change to Supervisor in GemBoss care?">
3057
+ <span class="gb-members-confirm__q" aria-live="polite">Change to Supervisor in GemBoss care?</span>
3058
+ <button type="button" class="ui-btn ui-btn--sm ui-btn--primary">Change</button>
3059
+ <button type="button" class="ui-btn ui-btn--sm">Cancel</button>
3060
+ </span>
3061
+ </td>
3062
+ </tr>
3063
+ <tr class="gb-members-row">
3064
+ <th scope="row" class="gb-members-person">…</th>
3065
+ <td>…</td><td>…</td>
3066
+ <td><span class="gb-members-status gb-members-status--locked"><i class="gb-members-dot" aria-hidden="true"></i>Locked</span></td>
3067
+ <td class="gb-members-last">never</td>
3068
+ <td class="gb-members-actions"><span class="gb-members-rowactions">
3069
+ <button type="button" class="ui-btn ui-btn--sm">Let back in</button>
3070
+ <details class="ui-menu ui-menu--end">…</details></span></td>
3071
+ </tr>
3072
+ </tbody>
3073
+ </table>
3074
+ </div>
3075
+ <ul class="gb-members-cards">
3076
+ <li class="gb-members-card">
3077
+ <button type="button" class="gb-members-card__open">
3078
+ <span class="gb-avatar gb-avatar--32" data-tone="1" aria-hidden="true">LT</span>
3079
+ <span class="gb-members-card__text"><span class="gb-members-card__name">Linh Trần</span>
3080
+ <span class="gb-members-card__meta">Supervisor / Admin · Active · 3 hours ago</span></span>
3081
+ <svg class="gb-members-card__go">…</svg>
3082
+ </button>
3083
+ </li>
3084
+ </ul>
3085
+ </section>
3086
+ </div>
3087
+ </div>
3088
+ <!-- The drawer: the kit's Sheet (dialog.ui-modal.ui-sheet), its body: -->
3089
+ <div class="gb-members-drawer">
3090
+ <section class="gb-members-drawer__sec" aria-label="Roles">
3091
+ <h3 class="gb-members-drawer__h">Roles</h3>
3092
+ <dl class="gb-members-kv">
3093
+ <div class="gb-members-kv__row"><dt>GemBoss care</dt><dd><select class="ui-select ui-select--slim gb-members-role">…</select></dd></div>
3094
+ <div class="gb-members-kv__row"><dt>Status</dt><dd><span class="gb-members-status gb-members-status--pending"><i class="gb-members-dot" aria-hidden="true"></i>Pending</span></dd></div>
3095
+ </dl>
3096
+ </section>
3097
+ <section class="gb-members-drawer__sec" aria-label="Sign-in">
3098
+ <h3 class="gb-members-drawer__h">Sign-in</h3>
3099
+ <dl class="gb-members-kv"><div class="gb-members-kv__row"><dt>2FA</dt><dd><span class="gb-members-tag gb-members-tag--warn">Off</span></dd></div></dl>
3100
+ <div class="gb-members-drawer__buttons"><button type="button" class="ui-btn ui-btn--sm">Sign out everywhere</button>
3101
+ <button type="button" class="ui-btn ui-btn--sm gb-members-btn--danger">Lock</button></div>
3102
+ </section>
3103
+ <div class="gb-members-drawer__slot">…the app's own…</div>
3104
+ </div>
3105
+ ```
3106
+
3107
+ The rest of the classes (the Invite popup's `gb-members-tabs`, `-panel`, `-form`, `-field`, `-field__label`, `-input`, `-note`,
3108
+ `-error`, `-csv`, `-tools`, `-check`, `-check__row` (`--skip`), `-check__mark`, `-check__what`, `-check__why`; `gb-members-you`,
3109
+ `gb-members-tag--ok`, `gb-members-status--invited`, `gb-members-notice--info`) are drawn by `members.tsx`, the reference.
3110
+
3111
+ `members-browser.test.tsx` (Chromium, in `test:ui-browser`) clicks through it at 1440 and 390: the chips and the search, a role
3112
+ change confirmed, cancelled, escaped and undone, the drawer at the right edge and the focus back on the name, the ⋯ with its
3113
+ danger row, Invite › Many from paste to Import, the cards and the sideways chips on a phone, the drawer's own confirm, dark, and
3114
+ an app's bare `button:hover` rule (negative control: a plain button does turn black).
3115
+
2879
3116
  ## Collections (0.13.0): tables, lists, grids, boards
2880
3117
 
2881
3118
  Chris settled these on 05/10/2026 after an inventory of 136 hand-made collections on 11 surfaces (86 tables scrolling
@@ -3128,6 +3365,7 @@ something the base cannot express, add a token or a prop here, and every surface
3128
3365
  | `packages/ui/src/icon.svg` | 0.5.0: the GemBoss app icon, for `<link rel="icon" type="image/svg+xml">`. Must stay byte-identical to `apps/admin/src/app/icon.svg` (`kit-look.test.ts` checks). |
3129
3366
  | `packages/ui/src/**/*.tsx` | the components, as TypeScript source. Next: add `@gemboss/ui` to `transpilePackages`. Vite compiles it as is. |
3130
3367
  | `packages/ui/src/next/` | 0.10.0, `@gemboss/ui/next`: `NavLink`, `PendingLink`, `PendingIcon`, `NAV_DWELL_MS`. Needs `next` >= 15.3 (optional peer; only this entry imports it). See "Navigation pending". |
3368
+ | `packages/ui/src/skill-flow/` | 03/11/2026, `@gemboss/ui/skill-flow`: `SkillFlow`, `layoutFlow`, and the model (`@gemboss/ui/skill-flow/model`: `validateFlow`, `flowWithHtml`, the zoom maths). Needs `@xyflow/react` >= 12.3 and `@dagrejs/dagre` >= 1.1 (optional peers; only this entry imports them). See "The skills UI". |
3131
3369
 
3132
3370
  `gemboss-ui.css` is never committed and never edited. To change a colour or a radius, change
3133
3371
  `packages/ui/src/gemboss-tokens.css` / `packages/ui/src/ui.css`; to change the rail, the topbar or the thread rail,
@@ -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.57.0 · Editor</h1>
11
+ <h1>@gemboss/ui 0.59.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;;