@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.
- package/CHANGELOG.md +221 -0
- package/README.md +238 -0
- package/catalog/editor.html +1 -1
- package/catalog/index.html +4 -4
- package/gemboss-ui.css +3 -3
- package/node/skill-flow/layout.js +194 -0
- package/node/skill-flow/model.js +279 -0
- package/package.json +31 -1
- package/parts/components.css +1 -1
- package/parts/core.css +1 -1
- package/parts/shell.css +1 -1
- package/src/assistant/host.tsx +21 -5
- package/src/assistant/sessions.tsx +36 -18
- package/src/auth-sso-plain.js +1 -1
- package/src/auth.tsx +2 -0
- package/src/collections.css +1 -1
- package/src/collections.tsx +5 -2
- package/src/dialog.tsx +4 -1
- package/src/editor/controls.tsx +18 -7
- package/src/editor/index.ts +1 -1
- package/src/editor/picker.tsx +9 -3
- package/src/editor/repeater.tsx +26 -14
- package/src/editor/swatch.ts +86 -0
- package/src/editor-color.css +1 -1
- package/src/editor-picker.css +1 -1
- package/src/editor-plain.js +1 -1
- package/src/editor-popover.css +1 -1
- package/src/editor.css +1 -1
- package/src/index.ts +17 -0
- package/src/job-card.css +1 -0
- package/src/job-card.tsx +130 -0
- package/src/list-page.css +1 -1
- package/src/members-data.ts +278 -0
- package/src/members.css +1 -0
- package/src/members.tsx +868 -0
- package/src/menu-extras.css +1 -1
- package/src/menu-select.css +1 -0
- package/src/menu.tsx +39 -12
- package/src/narration.css +1 -0
- package/src/save-bar.css +1 -0
- package/src/save-bar.tsx +50 -0
- package/src/skill-card.css +1 -0
- package/src/skill-card.tsx +146 -0
- package/src/skill-flow/canvas.tsx +593 -0
- package/src/skill-flow/index.ts +12 -0
- package/src/skill-flow/layout.ts +238 -0
- package/src/skill-flow/model.ts +412 -0
- package/src/skill-flow.css +1 -0
- package/src/skill-stats.css +1 -0
- package/src/skill-stats.tsx +213 -0
- package/src/skill-view.css +1 -0
- package/src/skill-view.tsx +249 -0
- 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,
|
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.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 "@gemboss/ui/editor.css";
|
|
14
14
|
import { EditorFrame, EditorTopbar, EditorBack, EditorChatToggle, EditorPaneTabs, EditorSaveState, DeviceToggle } from "@gemboss/ui/editor";
|