@gemboss/ui 0.58.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 CHANGED
@@ -4,6 +4,91 @@ 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
+
7
92
  ## 0.58.0 (04/11/2026)
8
93
 
9
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,
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 |
@@ -96,9 +97,11 @@ its CSS out of the build with it (`sideEffects`). gzip of the minified file, as
96
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 |
97
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 |
98
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 |
99
- | skill-view | `@gemboss/ui/skill-view.css` | `packages/ui/src/skill-view.css` | `SkillView`, `SkillViewSection`, `SkillRuleList`, `SkillGroup`, `SkillCard`: one skill in a ReaderDialog, tabs as slots, and the cards it opens from (03/11/2026, unreleased) | 1.7 KB | `SkillView` imports it (with reader-dialog.css) |
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 |
100
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) |
101
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") |
102
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) |
103
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 |
104
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) |
@@ -1906,6 +1909,19 @@ import { AppShell, BrandLockup, AccountMenu, AccountMenuItem, Icon, RailItem } f
1906
1909
 
1907
1910
  `menu-browser.test.ts` runs each of these on `Menu` and on plain markup with kit-plain.js, each with a negative control.
1908
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
+
1909
1925
  ## Topbar search (0.6.3)
1910
1926
 
1911
1927
  The admin's "Search ⌘K" box for every surface, as a real form (works with no JavaScript):
@@ -2891,9 +2907,9 @@ GemBoss's Assistant › Skills and content-radar's /v2/skills show the same thin
2891
2907
  | Piece | What it draws |
2892
2908
  | --- | --- |
2893
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. |
2894
- | `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. |
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`. |
2895
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. |
2896
- | `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`, `highlight` (a phase key to light), `toolPrefixes`, `mdClassName`. 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. |
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. |
2897
2913
 
2898
2914
  **The flow canvas is its own entry, and it is lazy.** `@xyflow/react` and `@dagrejs/dagre` are OPTIONAL peers of the kit: only
2899
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).
@@ -2905,8 +2921,11 @@ const SkillFlow = dynamic(() => import("@gemboss/ui/skill-flow").then((m) => m.S
2905
2921
  <SkillFlow flow={flow} phases={[{ key: "read", label: "Read" }, { key: "frame", label: "Frame" }, { key: "build", label: "Build" }, { key: "check", label: "Check" }]} />
2906
2922
  ```
2907
2923
 
2908
- `@gemboss/ui/skill-flow/model` is the data side alone, no peer: `validateFlow(input, { phases })` (one error listing every
2909
- problem), `flowWithHtml`, `phasesIn`, `shortTool`, the zoom maths. A server checks a flow.json with it before a browser gets one.
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).
2910
2929
  The flow format: `{ direction: "TB" | "LR", nodes: [{ id, label, kind: start | step | decision | stop | exit | end, phase,
2911
2930
  detail?, tools?, human?, examples?: [{ title, kind: input | output | good | bad | tool, md }] }], edges: [{ from, to, label?,
2912
2931
  kind: normal | yes | no | loop }] }`; one start, at least one end, no dead end, every node reachable.
@@ -2929,6 +2948,171 @@ import { JobCard, SkillView, SkillStats, SkillRuleList, SkillViewSection } from
2929
2948
  ]} />
2930
2949
  ```
2931
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
+
2932
3116
  ## Collections (0.13.0): tables, lists, grids, boards
2933
3117
 
2934
3118
  Chris settled these on 05/10/2026 after an inventory of 136 hand-made collections on 11 surfaces (86 tables scrolling
@@ -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.58.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;;
@@ -27,8 +27,8 @@ body{margin:0;background:var(--gemboss-app-bg,#f1f1f1);color:var(--gemboss-text)
27
27
  @media (max-width:760px){.cat{grid-template-columns:1fr;padding:16px}.cat-nav{position:static;flex-direction:row;flex-wrap:wrap}}
28
28
  </style></head><body>
29
29
  <div class="cat"><nav class="cat-nav" aria-label="Mục"><a href="#tokens">Token</a><a href="#buttons">Nút</a><a href="#fields">Ô nhập</a><a href="#choice">Tab, nhóm nút, thẻ</a><a href="#surfaces">Thẻ, số liệu, bảng, trạng thái trống</a><a href="#report">Báo cáo</a><a href="#collections">Bảng, list, lưới, board</a><a href="#resizer">Thanh kéo giữa hai cột</a><a href="#modal">Hộp thoại, toast, menu (JS thuần)</a><a href="#sheet">Ngăn trượt cạnh phải</a><a href="#reader">Hộp đọc tài liệu</a><a href="#settings">Hộp cài đặt</a><a href="#switcher">Chuyển dịch vụ</a><a href="#shell">Khung app</a><a href="#nav">Chờ điều hướng</a><a href="#page">Bề rộng nội dung</a><a href="#portal">Cổng công khai: tab trên topbar, tìm kiếm, sáng / tối, người dẫn đầu</a><a href="#site">Trang công khai: thanh trên, logo cỡ site, nút, chân trang</a><a href="#auth">Đăng nhập</a><a href="#setup">Hướng dẫn thiết lập</a><a href="#chat">Thân chat</a><a href="#reactions">Reactions</a><a href="#team-chat">Chat đội</a><a href="#action-card">Thẻ hành động</a><a href="#assistant-engine">Trợ lý: chọn engine</a><a href="#assistant-bridge">Trợ lý: cầu nối trên máy (0.32.0)</a><a href="#assistant-chat">Trợ lý: khung chat (0.29.0)</a><a href="#assistant">Trợ lý: cột phiên</a><a href="#icons">Icon</a><a href="#editor">Editor</a></nav>
30
- <main><header class="cat-head"><h1>@gemboss/ui 0.58.0</h1><p>Ngôn ngữ thiết kế chung của các công cụ GemBoss. Markup dưới mỗi ví dụ là đúng thứ package render ra; bề mặt không dùng React (HTML tĩnh, Python) chép markup này và nạp <code>gemboss-ui.css</code>. Dựng từ gemboss <code>a1e26c0b67cc</code>.</p></header>
31
- <section id="tokens"><h2>Token</h2><p>Đổi giao diện một bề mặt bằng cách đặt lại token, không viết đè class. Tên và giá trị đọc thẳng từ gemboss-ui.css.</p><div class="cat-swatches"><div class="cat-swatch"><i style="background:var(--gemboss-primary)"></i><code>--gemboss-primary</code><span>#1b1c1e</span></div><div class="cat-swatch"><i style="background:var(--gemboss-primary-dark)"></i><code>--gemboss-primary-dark</code><span>#000000</span></div><div class="cat-swatch"><i style="background:var(--gemboss-primary-soft)"></i><code>--gemboss-primary-soft</code><span>#f2f3f5</span></div><div class="cat-swatch"><i style="background:var(--gemboss-accent)"></i><code>--gemboss-accent</code><span>#5661f5</span></div><div class="cat-swatch"><i style="background:var(--gemboss-accent-strong)"></i><code>--gemboss-accent-strong</code><span>#3a44de</span></div><div class="cat-swatch"><i style="background:var(--gemboss-accent-soft)"></i><code>--gemboss-accent-soft</code><span>#eef0fe</span></div><div class="cat-swatch"><i style="background:var(--gemboss-accent-wash)"></i><code>--gemboss-accent-wash</code><span>#f7f8ff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-accent-tint)"></i><code>--gemboss-accent-tint</code><span>#dfe2ff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-accent-mid)"></i><code>--gemboss-accent-mid</code><span>#c9cffd</span></div><div class="cat-swatch"><i style="background:var(--gemboss-text-strong)"></i><code>--gemboss-text-strong</code><span>#1b1c1e</span></div><div class="cat-swatch"><i style="background:var(--gemboss-text)"></i><code>--gemboss-text</code><span>#1b1c1e</span></div><div class="cat-swatch"><i style="background:var(--gemboss-text-muted)"></i><code>--gemboss-text-muted</code><span>#686b71</span></div><div class="cat-swatch"><i style="background:var(--gemboss-surface)"></i><code>--gemboss-surface</code><span>#ffffff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-canvas)"></i><code>--gemboss-canvas</code><span>#ffffff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-preview-canvas)"></i><code>--gemboss-preview-canvas</code><span>#eceef1</span></div><div class="cat-swatch"><i style="background:var(--gemboss-rail-bg)"></i><code>--gemboss-rail-bg</code><span>#ffffff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-panel-bg)"></i><code>--gemboss-panel-bg</code><span>#ffffff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-divider)"></i><code>--gemboss-divider</code><span>#e5e7ea</span></div><div class="cat-swatch"><i style="background:var(--gemboss-divider-soft)"></i><code>--gemboss-divider-soft</code><span>#edeff2</span></div><div class="cat-swatch"><i style="background:var(--gemboss-hover)"></i><code>--gemboss-hover</code><span>#eceef2</span></div><div class="cat-swatch"><i style="background:var(--gemboss-active-bg)"></i><code>--gemboss-active-bg</code><span>#f0f1f4</span></div><div class="cat-swatch"><i style="background:var(--gemboss-active-fg)"></i><code>--gemboss-active-fg</code><span>#1b1c1e</span></div><div class="cat-swatch"><i style="background:var(--gemboss-danger)"></i><code>--gemboss-danger</code><span>#d72c0d</span></div><div class="cat-swatch"><i style="background:var(--gemboss-danger-strong)"></i><code>--gemboss-danger-strong</code><span>#b42318</span></div><div class="cat-swatch"><i style="background:var(--gemboss-danger-soft)"></i><code>--gemboss-danger-soft</code><span>#fff0e9</span></div><div class="cat-swatch"><i style="background:var(--gemboss-danger-border)"></i><code>--gemboss-danger-border</code><span>#f5c9bc</span></div><div class="cat-swatch"><i style="background:var(--gemboss-success)"></i><code>--gemboss-success</code><span>#007f5f</span></div><div class="cat-swatch"><i style="background:var(--gemboss-success-strong)"></i><code>--gemboss-success-strong</code><span>#0a6a4c</span></div><div class="cat-swatch"><i style="background:var(--gemboss-success-soft)"></i><code>--gemboss-success-soft</code><span>#e3f1df</span></div><div class="cat-swatch"><i style="background:var(--gemboss-success-border)"></i><code>--gemboss-success-border</code><span>#b7dfcd</span></div><div class="cat-swatch"><i style="background:var(--gemboss-warning)"></i><code>--gemboss-warning</code><span>#9a6700</span></div><div class="cat-swatch"><i style="background:var(--gemboss-warning-soft)"></i><code>--gemboss-warning-soft</code><span>#fff8e0</span></div><div class="cat-swatch"><i style="background:var(--gemboss-warning-border)"></i><code>--gemboss-warning-border</code><span>#f5d569</span></div><div class="cat-swatch"><i style="background:var(--gemboss-dark-bg)"></i><code>--gemboss-dark-bg</code><span>#0a0a0c</span></div><div class="cat-swatch"><i style="background:var(--gemboss-dark-rail)"></i><code>--gemboss-dark-rail</code><span>#0e0e11</span></div><div class="cat-swatch"><i style="background:var(--gemboss-dark-surface)"></i><code>--gemboss-dark-surface</code><span>#16161a</span></div><div class="cat-swatch"><i style="background:var(--gemboss-dark-surface-2)"></i><code>--gemboss-dark-surface-2</code><span>#1e1e24</span></div><div class="cat-swatch"><i style="background:var(--gemboss-dark-divider)"></i><code>--gemboss-dark-divider</code><span>#2a2a31</span></div><div class="cat-swatch"><i style="background:var(--gemboss-dark-text)"></i><code>--gemboss-dark-text</code><span>#ededf0</span></div><div class="cat-swatch"><i style="background:var(--gemboss-dark-muted)"></i><code>--gemboss-dark-muted</code><span>#9a9aa4</span></div><div class="cat-swatch"><i style="background:var(--gemboss-field-bg)"></i><code>--gemboss-field-bg</code><span>#fdfdfd</span></div><div class="cat-swatch"><i style="background:var(--gemboss-field-bg-hover)"></i><code>--gemboss-field-bg-hover</code><span>#fafafa</span></div><div class="cat-swatch"><i style="background:var(--gemboss-field-ink)"></i><code>--gemboss-field-ink</code><span>#303030</span></div><div class="cat-swatch"><i style="background:var(--gemboss-field-placeholder)"></i><code>--gemboss-field-placeholder</code><span>#616161</span></div><div class="cat-swatch"><i style="background:var(--gemboss-field-line)"></i><code>--gemboss-field-line</code><span>#8a8a8a</span></div><div class="cat-swatch"><i style="background:var(--gemboss-field-line-hover)"></i><code>--gemboss-field-line-hover</code><span>#616161</span></div><div class="cat-swatch"><i style="background:var(--gemboss-field-line-active)"></i><code>--gemboss-field-line-active</code><span>#1a1a1a</span></div><div class="cat-swatch"><i style="background:var(--gemboss-chip-ink)"></i><code>--gemboss-chip-ink</code><span>#303633</span></div><div class="cat-swatch"><i style="background:var(--gemboss-chip-line)"></i><code>--gemboss-chip-line</code><span>#cfd6ce</span></div><div class="cat-swatch"><i style="background:var(--gemboss-chip-line-hover)"></i><code>--gemboss-chip-line-hover</code><span>#aab4ad</span></div><div class="cat-swatch"><i style="background:var(--gemboss-chip-bg-hover)"></i><code>--gemboss-chip-bg-hover</code><span>#f6f7f5</span></div><div class="cat-swatch"><i style="background:var(--gemboss-on-primary)"></i><code>--gemboss-on-primary</code><span>#ffffff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-app-bg)"></i><code>--gemboss-app-bg</code><span>#ffffff</span></div></div><table class="ui-table cat-scale"><thead><tr><th>Token</th><th>Giá trị</th><th>Mẫu</th></tr></thead><tbody><tr><td><code>--gemboss-fs-micro</code></td><td>11px</td><td style="font-size:var(--gemboss-fs-micro)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-fs-caption</code></td><td>12px</td><td style="font-size:var(--gemboss-fs-caption)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-fs-body</code></td><td>14px</td><td style="font-size:var(--gemboss-fs-body)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-fs-body-lg</code></td><td>16px</td><td style="font-size:var(--gemboss-fs-body-lg)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-fs-h3</code></td><td>16px</td><td style="font-size:var(--gemboss-fs-h3)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-fs-h2</code></td><td>20px</td><td style="font-size:var(--gemboss-fs-h2)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-fs-h1</code></td><td>24px</td><td style="font-size:var(--gemboss-fs-h1)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-fs-display</code></td><td>30px</td><td style="font-size:var(--gemboss-fs-display)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-radius-xs</code></td><td>4px</td><td><i class="cat-radius" style="border-radius:var(--gemboss-radius-xs)"></i></td></tr><tr><td><code>--gemboss-radius-sm</code></td><td>6px</td><td><i class="cat-radius" style="border-radius:var(--gemboss-radius-sm)"></i></td></tr><tr><td><code>--gemboss-radius-md</code></td><td>8px</td><td><i class="cat-radius" style="border-radius:var(--gemboss-radius-md)"></i></td></tr><tr><td><code>--gemboss-radius-lg</code></td><td>12px</td><td><i class="cat-radius" style="border-radius:var(--gemboss-radius-lg)"></i></td></tr><tr><td><code>--gemboss-radius-xl</code></td><td>16px</td><td><i class="cat-radius" style="border-radius:var(--gemboss-radius-xl)"></i></td></tr><tr><td><code>--gemboss-radius-2xl</code></td><td>20px</td><td><i class="cat-radius" style="border-radius:var(--gemboss-radius-2xl)"></i></td></tr><tr><td><code>--gemboss-radius-full</code></td><td>999px</td><td><i class="cat-radius" style="border-radius:var(--gemboss-radius-full)"></i></td></tr><tr><td><code>--gemboss-shadow-resting</code></td><td class="cat-small">0 1px 2px rgba(31, 30, 29, 0.04), 0 2px 6px rgba(31, 30, 29, 0.06)</td><td><i class="cat-radius" style="box-shadow:var(--gemboss-shadow-resting);border:0"></i></td></tr><tr><td><code>--gemboss-shadow-raised</code></td><td class="cat-small">0 4px 16px rgba(31, 30, 29, 0.10)</td><td><i class="cat-radius" style="box-shadow:var(--gemboss-shadow-raised);border:0"></i></td></tr><tr><td><code>--gemboss-shadow-overlay</code></td><td class="cat-small">0 16px 48px rgba(31, 30, 29, 0.18)</td><td><i class="cat-radius" style="box-shadow:var(--gemboss-shadow-overlay);border:0"></i></td></tr></tbody></table></section>
30
+ <main><header class="cat-head"><h1>@gemboss/ui 0.59.0</h1><p>Ngôn ngữ thiết kế chung của các công cụ GemBoss. Markup dưới mỗi ví dụ là đúng thứ package render ra; bề mặt không dùng React (HTML tĩnh, Python) chép markup này và nạp <code>gemboss-ui.css</code>. Dựng từ gemboss <code>1ffc88dd69e6</code>.</p></header>
31
+ <section id="tokens"><h2>Token</h2><p>Đổi giao diện một bề mặt bằng cách đặt lại token, không viết đè class. Tên và giá trị đọc thẳng từ gemboss-ui.css.</p><div class="cat-swatches"><div class="cat-swatch"><i style="background:var(--gemboss-primary)"></i><code>--gemboss-primary</code><span>#1b1c1e</span></div><div class="cat-swatch"><i style="background:var(--gemboss-primary-dark)"></i><code>--gemboss-primary-dark</code><span>#000000</span></div><div class="cat-swatch"><i style="background:var(--gemboss-primary-soft)"></i><code>--gemboss-primary-soft</code><span>#f2f3f5</span></div><div class="cat-swatch"><i style="background:var(--gemboss-accent)"></i><code>--gemboss-accent</code><span>#5661f5</span></div><div class="cat-swatch"><i style="background:var(--gemboss-accent-strong)"></i><code>--gemboss-accent-strong</code><span>#3a44de</span></div><div class="cat-swatch"><i style="background:var(--gemboss-accent-soft)"></i><code>--gemboss-accent-soft</code><span>#eef0fe</span></div><div class="cat-swatch"><i style="background:var(--gemboss-accent-wash)"></i><code>--gemboss-accent-wash</code><span>#f7f8ff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-accent-tint)"></i><code>--gemboss-accent-tint</code><span>#dfe2ff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-accent-mid)"></i><code>--gemboss-accent-mid</code><span>#c9cffd</span></div><div class="cat-swatch"><i style="background:var(--gemboss-text-strong)"></i><code>--gemboss-text-strong</code><span>#1b1c1e</span></div><div class="cat-swatch"><i style="background:var(--gemboss-text)"></i><code>--gemboss-text</code><span>#1b1c1e</span></div><div class="cat-swatch"><i style="background:var(--gemboss-text-muted)"></i><code>--gemboss-text-muted</code><span>#686b71</span></div><div class="cat-swatch"><i style="background:var(--gemboss-surface)"></i><code>--gemboss-surface</code><span>#ffffff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-canvas)"></i><code>--gemboss-canvas</code><span>#ffffff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-preview-canvas)"></i><code>--gemboss-preview-canvas</code><span>#eceef1</span></div><div class="cat-swatch"><i style="background:var(--gemboss-rail-bg)"></i><code>--gemboss-rail-bg</code><span>#ffffff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-panel-bg)"></i><code>--gemboss-panel-bg</code><span>#ffffff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-divider)"></i><code>--gemboss-divider</code><span>#e5e7ea</span></div><div class="cat-swatch"><i style="background:var(--gemboss-divider-soft)"></i><code>--gemboss-divider-soft</code><span>#edeff2</span></div><div class="cat-swatch"><i style="background:var(--gemboss-hover)"></i><code>--gemboss-hover</code><span>#eceef2</span></div><div class="cat-swatch"><i style="background:var(--gemboss-active-bg)"></i><code>--gemboss-active-bg</code><span>#f0f1f4</span></div><div class="cat-swatch"><i style="background:var(--gemboss-active-fg)"></i><code>--gemboss-active-fg</code><span>#1b1c1e</span></div><div class="cat-swatch"><i style="background:var(--gemboss-danger)"></i><code>--gemboss-danger</code><span>#d72c0d</span></div><div class="cat-swatch"><i style="background:var(--gemboss-danger-strong)"></i><code>--gemboss-danger-strong</code><span>#b42318</span></div><div class="cat-swatch"><i style="background:var(--gemboss-danger-soft)"></i><code>--gemboss-danger-soft</code><span>#fff0e9</span></div><div class="cat-swatch"><i style="background:var(--gemboss-danger-border)"></i><code>--gemboss-danger-border</code><span>#f5c9bc</span></div><div class="cat-swatch"><i style="background:var(--gemboss-success)"></i><code>--gemboss-success</code><span>#007f5f</span></div><div class="cat-swatch"><i style="background:var(--gemboss-success-strong)"></i><code>--gemboss-success-strong</code><span>#0a6a4c</span></div><div class="cat-swatch"><i style="background:var(--gemboss-success-soft)"></i><code>--gemboss-success-soft</code><span>#e3f1df</span></div><div class="cat-swatch"><i style="background:var(--gemboss-success-border)"></i><code>--gemboss-success-border</code><span>#b7dfcd</span></div><div class="cat-swatch"><i style="background:var(--gemboss-warning)"></i><code>--gemboss-warning</code><span>#9a6700</span></div><div class="cat-swatch"><i style="background:var(--gemboss-warning-soft)"></i><code>--gemboss-warning-soft</code><span>#fff8e0</span></div><div class="cat-swatch"><i style="background:var(--gemboss-warning-border)"></i><code>--gemboss-warning-border</code><span>#f5d569</span></div><div class="cat-swatch"><i style="background:var(--gemboss-dark-bg)"></i><code>--gemboss-dark-bg</code><span>#0a0a0c</span></div><div class="cat-swatch"><i style="background:var(--gemboss-dark-rail)"></i><code>--gemboss-dark-rail</code><span>#0e0e11</span></div><div class="cat-swatch"><i style="background:var(--gemboss-dark-surface)"></i><code>--gemboss-dark-surface</code><span>#16161a</span></div><div class="cat-swatch"><i style="background:var(--gemboss-dark-surface-2)"></i><code>--gemboss-dark-surface-2</code><span>#1e1e24</span></div><div class="cat-swatch"><i style="background:var(--gemboss-dark-divider)"></i><code>--gemboss-dark-divider</code><span>#2a2a31</span></div><div class="cat-swatch"><i style="background:var(--gemboss-dark-text)"></i><code>--gemboss-dark-text</code><span>#ededf0</span></div><div class="cat-swatch"><i style="background:var(--gemboss-dark-muted)"></i><code>--gemboss-dark-muted</code><span>#9a9aa4</span></div><div class="cat-swatch"><i style="background:var(--gemboss-field-bg)"></i><code>--gemboss-field-bg</code><span>#fdfdfd</span></div><div class="cat-swatch"><i style="background:var(--gemboss-field-bg-hover)"></i><code>--gemboss-field-bg-hover</code><span>#fafafa</span></div><div class="cat-swatch"><i style="background:var(--gemboss-field-ink)"></i><code>--gemboss-field-ink</code><span>#303030</span></div><div class="cat-swatch"><i style="background:var(--gemboss-field-placeholder)"></i><code>--gemboss-field-placeholder</code><span>#616161</span></div><div class="cat-swatch"><i style="background:var(--gemboss-field-line)"></i><code>--gemboss-field-line</code><span>#8a8a8a</span></div><div class="cat-swatch"><i style="background:var(--gemboss-field-line-hover)"></i><code>--gemboss-field-line-hover</code><span>#616161</span></div><div class="cat-swatch"><i style="background:var(--gemboss-field-line-active)"></i><code>--gemboss-field-line-active</code><span>#1a1a1a</span></div><div class="cat-swatch"><i style="background:var(--gemboss-chip-ink)"></i><code>--gemboss-chip-ink</code><span>#303633</span></div><div class="cat-swatch"><i style="background:var(--gemboss-chip-line)"></i><code>--gemboss-chip-line</code><span>#cfd6ce</span></div><div class="cat-swatch"><i style="background:var(--gemboss-chip-line-hover)"></i><code>--gemboss-chip-line-hover</code><span>#aab4ad</span></div><div class="cat-swatch"><i style="background:var(--gemboss-chip-bg-hover)"></i><code>--gemboss-chip-bg-hover</code><span>#f6f7f5</span></div><div class="cat-swatch"><i style="background:var(--gemboss-on-primary)"></i><code>--gemboss-on-primary</code><span>#ffffff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-app-bg)"></i><code>--gemboss-app-bg</code><span>#ffffff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-fill-tertiary)"></i><code>--gemboss-fill-tertiary</code><span>#2a2b33</span></div><div class="cat-swatch"><i style="background:var(--gemboss-fill-tertiary-hover)"></i><code>--gemboss-fill-tertiary-hover</code><span>#33353f</span></div><div class="cat-swatch"><i style="background:var(--gemboss-fill-tertiary-active)"></i><code>--gemboss-fill-tertiary-active</code><span>#3a3c46</span></div></div><table class="ui-table cat-scale"><thead><tr><th>Token</th><th>Giá trị</th><th>Mẫu</th></tr></thead><tbody><tr><td><code>--gemboss-fs-micro</code></td><td>11px</td><td style="font-size:var(--gemboss-fs-micro)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-fs-caption</code></td><td>12px</td><td style="font-size:var(--gemboss-fs-caption)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-fs-body</code></td><td>14px</td><td style="font-size:var(--gemboss-fs-body)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-fs-body-lg</code></td><td>16px</td><td style="font-size:var(--gemboss-fs-body-lg)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-fs-h3</code></td><td>16px</td><td style="font-size:var(--gemboss-fs-h3)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-fs-h2</code></td><td>20px</td><td style="font-size:var(--gemboss-fs-h2)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-fs-h1</code></td><td>24px</td><td style="font-size:var(--gemboss-fs-h1)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-fs-display</code></td><td>30px</td><td style="font-size:var(--gemboss-fs-display)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-radius-xs</code></td><td>4px</td><td><i class="cat-radius" style="border-radius:var(--gemboss-radius-xs)"></i></td></tr><tr><td><code>--gemboss-radius-sm</code></td><td>6px</td><td><i class="cat-radius" style="border-radius:var(--gemboss-radius-sm)"></i></td></tr><tr><td><code>--gemboss-radius-md</code></td><td>8px</td><td><i class="cat-radius" style="border-radius:var(--gemboss-radius-md)"></i></td></tr><tr><td><code>--gemboss-radius-lg</code></td><td>12px</td><td><i class="cat-radius" style="border-radius:var(--gemboss-radius-lg)"></i></td></tr><tr><td><code>--gemboss-radius-xl</code></td><td>16px</td><td><i class="cat-radius" style="border-radius:var(--gemboss-radius-xl)"></i></td></tr><tr><td><code>--gemboss-radius-2xl</code></td><td>20px</td><td><i class="cat-radius" style="border-radius:var(--gemboss-radius-2xl)"></i></td></tr><tr><td><code>--gemboss-radius-full</code></td><td>999px</td><td><i class="cat-radius" style="border-radius:var(--gemboss-radius-full)"></i></td></tr><tr><td><code>--gemboss-shadow-resting</code></td><td class="cat-small">0 1px 2px rgba(31, 30, 29, 0.04), 0 2px 6px rgba(31, 30, 29, 0.06)</td><td><i class="cat-radius" style="box-shadow:var(--gemboss-shadow-resting);border:0"></i></td></tr><tr><td><code>--gemboss-shadow-raised</code></td><td class="cat-small">0 4px 16px rgba(31, 30, 29, 0.10)</td><td><i class="cat-radius" style="box-shadow:var(--gemboss-shadow-raised);border:0"></i></td></tr><tr><td><code>--gemboss-shadow-overlay</code></td><td class="cat-small">0 16px 48px rgba(31, 30, 29, 0.18)</td><td><i class="cat-radius" style="box-shadow:var(--gemboss-shadow-overlay);border:0"></i></td></tr></tbody></table></section>
32
32
  <section id="buttons"><h2>Nút</h2><p>Một lớp <code>ui-btn</code>, ba biến thể, tông đỏ, một cỡ nhỏ. Cao 28px dưới chuột như Button của Polaris (ô nhập và ô chọn 32, như TextField), 44px dưới ngón tay và ở khổ điện thoại, cỡ nhỏ cũng vậy. Dùng được trên <code>&lt;button&gt;</code> lẫn <code>&lt;a&gt;</code> (căn giữa sẵn).</p><figure class="cat-demo"><figcaption>Mặc định · chính · ghost · nhỏ · tắt</figcaption><div class="cat-live"><div class="cat-row"><button type="button" class="ui-btn">Lưu nháp</button><button type="button" class="ui-btn ui-btn--primary">Xuất bản</button><button type="button" class="ui-btn ui-btn--ghost">Huỷ</button><button type="button" class="ui-btn ui-btn--sm">Nhỏ</button><button type="button" class="ui-btn ui-btn--primary" disabled>Đang lưu…</button><a class="ui-btn" href="#buttons">Link dạng nút</a></div></div><details class="cat-code"><summary>Markup</summary><pre><code>&lt;div class=&quot;cat-row&quot;&gt;
33
33
  &lt;button type=&quot;button&quot; class=&quot;ui-btn&quot;&gt;Lưu nháp&lt;/button&gt;
34
34
  &lt;button type=&quot;button&quot; class=&quot;ui-btn ui-btn--primary&quot;&gt;Xuất bản&lt;/button&gt;