@gemboss/ui 0.58.0 → 0.60.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 +127 -0
- package/README.md +239 -5
- package/catalog/editor.html +1 -1
- package/catalog/index.html +2 -2
- package/gemboss-ui.css +2 -2
- package/node/skill-flow/layout.js +194 -0
- package/node/skill-flow/model.js +279 -0
- package/package.json +20 -2
- package/parts/components.css +1 -1
- package/parts/core.css +1 -1
- package/parts/shell.css +1 -1
- package/src/auth-sso-plain.js +1 -1
- package/src/auth.tsx +2 -0
- package/src/editor.css +1 -1
- package/src/index-table.tsx +10 -3
- package/src/index.ts +19 -1
- package/src/kind-art.css +1 -0
- package/src/kind-art.tsx +132 -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/notice.css +1 -0
- package/src/notice.tsx +34 -0
- package/src/progress-bar.css +1 -0
- package/src/progress-bar.tsx +45 -0
- package/src/skill-card.css +1 -0
- package/src/skill-card.tsx +146 -0
- package/src/skill-flow/canvas.tsx +43 -24
- package/src/skill-flow/index.ts +3 -1
- package/src/skill-flow/layout.ts +15 -6
- package/src/skill-flow/model.ts +216 -60
- package/src/skill-flow.css +1 -1
- package/src/skill-view.css +1 -1
- package/src/skill-view.tsx +101 -109
- package/src/theme-dark.css +1 -1
- package/src/versions.css +1 -0
- package/src/versions.tsx +62 -0
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,133 @@ 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.60.0 (04/11/2026)
|
|
8
|
+
|
|
9
|
+
**A progress bar a screen places anywhere** (04/11/2026, GemX on the UI book, board ubl-PL-1b: a rule's days on Plan's Testing card).
|
|
10
|
+
|
|
11
|
+
Added
|
|
12
|
+
- `ProgressBar` (`value`, `max`, `label`, `tone`: `ink` | `accent` | `success` | `critical`, `size`: `sm` 4px | `md` 8px) and
|
|
13
|
+
`progressBarValue` (pure: the value pinned into 0..max; a max that is not a positive number is an empty bar). A `<progress>`, so it
|
|
14
|
+
fills under a CSP that forbids inline style. Its own entry, `@gemboss/ui/progress-bar.css`.
|
|
15
|
+
|
|
16
|
+
**The row a test and a personalization share** (04/11/2026, Chris on GemX board ubl-AB-6p: "Updating GemBoss UI updates everything in
|
|
17
|
+
sync"). The admin's Tests table (UI book AB-6) and Funnels › Personalize drew the same version pair and the same figures from two
|
|
18
|
+
copies; both draw them from the kit now.
|
|
19
|
+
|
|
20
|
+
Added
|
|
21
|
+
- `VersionPair` (`a`, `b`, `tags`, `lit`): everyone's version beside another, each a 3:4 picture (the surface's own, or a blank card)
|
|
22
|
+
with its letter on the corner; `lit` lights the letter that leads or that an audience is shown.
|
|
23
|
+
- `Figure` (`value`, `cap`, `strong`, `tone`: pos · accent · muted, `capTone`, `end`): a table figure, its value over its cap, right
|
|
24
|
+
in a numeric cell. Both in their own entry, `@gemboss/ui/versions.css`.
|
|
25
|
+
- `Notice` (`children`, `action`, `icon`, `tone`, `role`): the core's `ui-notice` on one line, an icon, the sentence and its one button
|
|
26
|
+
at the end, on the page's own ground (Funnels › Personalize's 30-day nudge). Its own entry, `@gemboss/ui/notice.css`.
|
|
27
|
+
- `IndexTable` `mediaColumn: { header }`: each row's `media` in a column of its own before the title, left out when the table folds
|
|
28
|
+
(`data-condensed="hide"`). A `VersionPair` there keeps the column as narrow as its pictures. Without it, nothing changes.
|
|
29
|
+
|
|
30
|
+
**A "pick a kind" card draws its kind, legibly: `KindArt`** (04/11/2026, UI book OF-2; Chris on prod: the New offer picker's
|
|
31
|
+
pictures were "bé tí hin chả nhìn ra gì", too tiny to make out).
|
|
32
|
+
|
|
33
|
+
Added
|
|
34
|
+
- `KindArt` (`glyph`, `title`, `className`) and `KIND_GLYPHS`: the cream strip across the top of a picker's card, 50px tall, with one
|
|
35
|
+
bold drawing of the kind at the UI book's size (`signup`, `quantity-break`, `bundle`, `upgrade`, `cross-sell`, `cart-add-on`, `gift`,
|
|
36
|
+
`reward-tiers`, `bought-together`, `post-purchase`, `order-bump`). Painted by tokens, decorative unless given a `title`, nothing in
|
|
37
|
+
it is text. Its own entry, `@gemboss/ui/kind-art.css` (0.6 KB gzip). The admin's New offer picker is the first surface.
|
|
38
|
+
|
|
39
|
+
## 0.59.0 (04/11/2026)
|
|
40
|
+
|
|
41
|
+
**Members: one members list for every service** (04/11/2026, Chris approved the design "GemBoss Members Pattern": GemCare's People
|
|
42
|
+
screen made calmer, for GemCommunity Admin › Members, GemCare People and the other admins).
|
|
43
|
+
|
|
44
|
+
Added
|
|
45
|
+
- `MembersPage` (`people`, `roles`, `scopes`, `currentUserId`, `filters`, `columns`, `rowActions`, `inlineAction`, `drawerActions`,
|
|
46
|
+
`detail`, `canChangeRole`, `onRoleChange`, `onInvite`, `onCheckImport`, `onImport`, `notice`, `secondaryActions`, `labels`, and
|
|
47
|
+
`filter` / `query` / `selectedId` to hold them yourself): inside `ListPage`, the chips All · Team · Pending + the app's own with
|
|
48
|
+
their counts, the search (accents folded), the table (Person · a role select per scope · Status · the app's columns · Last
|
|
49
|
+
active · one inline action and the ⋯), a role change confirmed on the row (Change / Cancel, then Undo in a toast; never
|
|
50
|
+
`window.confirm`; your own row read-only), Invite as a two-tab popup (one person; many from a CSV: Check shows each line, then
|
|
51
|
+
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
|
|
52
|
+
from `labels` (`MEMBERS_LABELS`). Its own entry, `@gemboss/ui/members.css`; the `gb-members-*` classes are the plain-HTML contract
|
|
53
|
+
(README "Members").
|
|
54
|
+
- `@gemboss/ui/members-data` (also from the index): `parseMembersCsv`, `memberCounts`, `visibleMembers`, `roleChangeStep`,
|
|
55
|
+
`lastRoleGuard`, `foldText`, `roleOf` and the types (`MemberPerson`, `MemberRole`, `MemberScope`, …). No React, no stylesheet.
|
|
56
|
+
|
|
57
|
+
**ListPage's header actions read in dark** (04/11/2026, seen on GemCommunity's doc reader: "Copy link", "Full screen" and ⋯ were
|
|
58
|
+
#e3e3e3 under near-white words). Fixed: their fill reads `--gemboss-fill-tertiary`, `-hover`, `-active` (new, dark values in
|
|
59
|
+
`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,
|
|
60
|
+
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.
|
|
61
|
+
|
|
62
|
+
**"Continue with GemBoss" says `?sso=not_company`** (04/11/2026, Chris: every staff console admits only @gemboss.ai and
|
|
63
|
+
@gemcommerce.com addresses). A console that refuses a GemBoss account off those domains sends the browser back with
|
|
64
|
+
`?sso=not_company`; `AuthContinueWithGemBoss` and its plain twin `auth-sso-plain.js` now say "Use your @gemboss.ai or
|
|
65
|
+
@gemcommerce.com account." under the button (before, an unknown reason read as "That sign-in did not go through").
|
|
66
|
+
|
|
67
|
+
**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
|
|
68
|
+
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
|
|
69
|
+
canvas onto `SkillFlow`). Every addition is optional: GemBoss's Assistant › Skills draws what it drew before.
|
|
70
|
+
|
|
71
|
+
Added
|
|
72
|
+
- `@gemboss/ui/skill-flow/model` and the new `@gemboss/ui/skill-flow/layout` (`layoutFlow`, `nodeSize`: dagre, no React) ship as plain
|
|
73
|
+
JavaScript too, under the `node` export condition of the PUBLISHED manifest (`node/skill-flow/*.js`, compiled from the .ts by
|
|
74
|
+
`build()`, scripts/pack-lib.mjs `NODE_COPIES` / `stagedManifest`): Node imports them from node_modules with no TypeScript step (an
|
|
75
|
+
MCP server, a script, `node --test`). A bundler and TypeScript keep the .ts (`types`, `default`); the repo's own manifest stays on
|
|
76
|
+
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
|
|
77
|
+
(CommonJS) as well as 3.x in plain Node.
|
|
78
|
+
- `validateFlow(input, { phases, messages })`: a problem is a code with params (`FlowProblemParams`, `FlowProblemCode`), the words a
|
|
79
|
+
table the caller may replace in part or whole (`FlowMessages`; `FLOW_MESSAGES` is the English, word for word as before), and the
|
|
80
|
+
error a `FlowError` whose `problems` are the list as data (`{ code, params, at? }`, `at` a node, one of its examples or an edge);
|
|
81
|
+
`flowProblemText` says one. `layoutFlow` and `SkillFlow` take `messages` too.
|
|
82
|
+
- `SkillFlow`: `noteTone="bad"` (the note in the danger tint, said as an alert: a broken flow.json drawn with a stand-in);
|
|
83
|
+
`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
|
|
84
|
+
here", drawn by the kit now). `SkillFlowLabels` gains `legend` (the legend's name for a screen reader) and `expandTip` (the Expand
|
|
85
|
+
button's tooltip); left out, each takes the words it used to borrow (`fullTitle`, `expand`), so a surface that renamed those keeps
|
|
86
|
+
them. `skillFlowLabels(labels)` is that merge.
|
|
87
|
+
- `SkillViewBody` (`SkillViewBodyProps`): the popup's head and tabs without the dialog, for a pane or the preview beside an "Edit with
|
|
88
|
+
AI" chat; its tab row sticks to the top of whatever scrolls round it and stays inside its edges. `SkillView` is a ReaderDialog round
|
|
89
|
+
it (`className="ui-reader__scroll"`), as before. Both take `iconSize` (a picture of its own, a 96px mascot, bare instead of the 44px
|
|
90
|
+
tile, the head wider and centred), `callout` + `calloutLabel` (a tinted box, its label in small caps before the first line:
|
|
91
|
+
content-radar's "Kitchen"), `badges` (the kit's `ui-badge`, after the facts; a long one wraps), `note` (a quiet line under them:
|
|
92
|
+
"Suggested when: …") and `tabsLabel`. `intro` is a block now, so two lines (English and a muted translation) fit.
|
|
93
|
+
- `SkillCard`: `iconSize` (a 72px mascot, bare), `badgeTone` (`new` iris, the default; `ready` green; `beta` amber; `research` /
|
|
94
|
+
`later` grey), `aside` (a second name after the title), `children` (under the line, inside the card: a framework's steps, a usage
|
|
95
|
+
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
|
|
96
|
+
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
|
|
97
|
+
corners, a 16px title, the line at most two lines). `SkillCardProps`, `SkillBadgeTone`.
|
|
98
|
+
- `SkillGroup`: `mark` (a coloured square before the name, any CSS colour), `aside` (its second name) and `minCardWidth` (px; default
|
|
99
|
+
220, content-radar 270). `SkillGroupProps`.
|
|
100
|
+
|
|
101
|
+
Changed
|
|
102
|
+
- `SkillGroup` and `SkillCard` live in skill-card.tsx with their own entry, `@gemboss/ui/skill-card.css` (the component imports it; a
|
|
103
|
+
page that writes the markup links it beside skill-view.css). Their rules left skill-view.css, whose ceiling went down with them.
|
|
104
|
+
|
|
105
|
+
**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
|
|
106
|
+
characters). Fixed: `.gemboss-layer-type` (Layers, the Canvas section list) and the text of `.gemboss-pageedit-chip` ("Selected: …")
|
|
107
|
+
break a word longer than the row (`overflow-wrap: anywhere`, which also lets a flex item shrink below the word), and the chip's
|
|
108
|
+
buttons keep their size (`flex: none`); `.gemboss-ei-title` (the panel head, whose `overflow: hidden` cut the word) breaks it with
|
|
109
|
+
`break-word`, so a short title in a box sized to its content is never broken mid-word. The ceiling of
|
|
110
|
+
packages/ui/src/editor.css goes from 8690 to 8730 B gzip for it (+40 B; Chris approved, 04/11/2026).
|
|
111
|
+
|
|
112
|
+
**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
|
|
113
|
+
condition", and the When / Then menus of a moment after it).
|
|
114
|
+
|
|
115
|
+
Added
|
|
116
|
+
- `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
|
|
117
|
+
finger or below 768; the words name it, `label` still names the list. Without `text` it is the ⋯ it was.
|
|
118
|
+
- `MenuItem` takes `icon` (a 16px mark before the label, muted ink) and `description` (one muted caption line under the label, which
|
|
119
|
+
wraps). The tag at a row's end ("New", "Later") is its `hint`, and a row not built yet is `disabled`, as before.
|
|
120
|
+
- `MenuGroup` takes `overline`: its title in small capitals, for a menu of actions in parts ("Known before the page shows · can pick
|
|
121
|
+
a page"). A group of choices keeps its plain title.
|
|
122
|
+
- In `menu-extras.css` (0.7 KB gzip, under its ceiling). Tests: `menu-sections.test.tsx`.
|
|
123
|
+
|
|
124
|
+
**A menu as a select** (04/11/2026, GemX New moment, boards ubm-PZ-4w / ubm-PZ-4t; Chris: what a dialog needs that the kit lacks goes
|
|
125
|
+
into the kit, so every menu gets it).
|
|
126
|
+
|
|
127
|
+
Added
|
|
128
|
+
- `Menu` takes `select`: the trigger is a field as wide as its column, the current choice (cut with "…") and a chevron, a select's
|
|
129
|
+
height (32, 44 under a finger or below 768) in the field colours; named "label: choice" when the choice is words; its list 280 to
|
|
130
|
+
420 wide. Its rows are a menu in parts' (`MenuGroup overline`, `MenuItem icon` / `description` / `hint="Later"` / `disabled`).
|
|
131
|
+
Its own entry, `@gemboss/ui/menu-select.css` (0.4 KB gzip), imported by `Menu`; `menu-select.test.tsx`.
|
|
132
|
+
(Recorded after the release: the code shipped in 0.59.0.)
|
|
133
|
+
|
|
7
134
|
## 0.58.0 (04/11/2026)
|
|
8
135
|
|
|
9
136
|
**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 |
|
|
@@ -89,16 +90,20 @@ its CSS out of the build with it (`sideEffects`). gzip of the minified file, as
|
|
|
89
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 |
|
|
90
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 |
|
|
91
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 |
|
|
93
|
+
| progress-bar | `@gemboss/ui/progress-bar.css` | `packages/ui/src/progress-bar.css` | `ProgressBar`: how far along, a thin bar a screen places anywhere (unreleased) | 0.3 KB | `ProgressBar` imports it |
|
|
92
94
|
| spot-art | `@gemboss/ui/spot-art.css` | `packages/ui/src/spot-art.css` | `SpotArt`: six brand pictures for pauses and empty states (0.43.0) | 0.4 KB | `SpotArt` imports it |
|
|
95
|
+
| kind-art | `@gemboss/ui/kind-art.css` | `packages/ui/src/kind-art.css` | `KindArt`: the cream strip across the top of a "pick a kind" card, one bold drawing per kind (04/11/2026, unreleased) | 0.6 KB | `KindArt` imports it; a plain-HTML page links it |
|
|
93
96
|
| logo-sheet | `@gemboss/ui/logo-sheet.css` | `packages/ui/src/logo-sheet.css` | `LogoSheet`: one logo as a person judges it, the mark on a checkerboard, the lockup on a light and a dark header, the favicon at its real 32px (unreleased) | 0.5 KB | `LogoSheet` imports it |
|
|
94
97
|
| stage-path | `@gemboss/ui/stage-path.css` | `packages/ui/src/stage-path.css` | `StagePath`: stages that unlock in order, each a card with its number (✓ when done), its count and a thin bar; the current one in ink (unreleased) | 0.7 KB | `StagePath` imports it; a plain-HTML page links it (README "Review pieces") |
|
|
95
98
|
| 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 |
|
|
96
99
|
| 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
100
|
| 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
101
|
| 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`, `
|
|
102
|
+
| skill-view | `@gemboss/ui/skill-view.css` | `packages/ui/src/skill-view.css` | `SkillView`, `SkillViewBody`, `SkillViewSection`, `SkillRuleList`: one skill in a ReaderDialog (or alone), tabs as slots (03/11/2026, unreleased) | 1.4 KB | `SkillView` imports it (with reader-dialog.css) |
|
|
103
|
+
| 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
104
|
| 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
105
|
| skill-flow | `@gemboss/ui/skill-flow.css` | `packages/ui/src/skill-flow.css` | `SkillFlow`: a skill's flow canvas, its OWN lazy entry `@gemboss/ui/skill-flow` (React Flow + dagre, optional peers) (03/11/2026, unreleased) | 3.4 KB | the canvas imports it, with `@xyflow/react/dist/style.css` |
|
|
106
|
+
| 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
107
|
| 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
108
|
| 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
109
|
| 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 +1911,19 @@ import { AppShell, BrandLockup, AccountMenu, AccountMenuItem, Icon, RailItem } f
|
|
|
1906
1911
|
|
|
1907
1912
|
`menu-browser.test.ts` runs each of these on `Menu` and on plain markup with kit-plain.js, each with a negative control.
|
|
1908
1913
|
|
|
1914
|
+
A menu of actions in parts (Unreleased, 04/11/2026: Audiences' "+ Add a condition"): `<Menu label="Add a condition"
|
|
1915
|
+
text="Add a condition" icon={plus}>` opens from its words (link colour, no box, 24px / 44 under a finger); each part is a
|
|
1916
|
+
`MenuGroup overline` (its title in small capitals); each row a `MenuItem icon={mark} description="what it asks" hint="New"`
|
|
1917
|
+
(a 16px muted mark, the label over a muted caption line, the tag on the right); a row not built yet is `disabled` with
|
|
1918
|
+
`hint="Later"`. CSS in `menu-extras.css`; `menu-sections.test.tsx` holds the markup. One menu for every such list: no page
|
|
1919
|
+
draws its own.
|
|
1920
|
+
|
|
1921
|
+
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">`
|
|
1922
|
+
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
|
|
1923
|
+
"When: About to leave"; its rows are the parts above, the chosen one `checked`. CSS in its own entry, `menu-select.css`, which
|
|
1924
|
+
`Menu` imports; `menu-select.test.tsx` holds the markup. For a choice whose rows say more than an `<option>` can; a plain choice
|
|
1925
|
+
stays a select.
|
|
1926
|
+
|
|
1909
1927
|
## Topbar search (0.6.3)
|
|
1910
1928
|
|
|
1911
1929
|
The admin's "Search ⌘K" box for every surface, as a real form (works with no JavaScript):
|
|
@@ -2749,6 +2767,7 @@ entry, each presentational and server-renderable (no state, no effect):
|
|
|
2749
2767
|
| `BriefingCard` | one proposal at the top of a screen: a `eyebrow` tag, the sentence (`title`), `lead` with the numbers, `evidence` chips, `actions` (one to three buttons) and `art`. An iris wash, no border: the one loud thing on the screen. Not `ActionCard`: that lists the changes of one apply; a briefing is a proposal that has not become a change yet. |
|
|
2750
2768
|
| `RangeBar` | a value against a market's spread on one axis: `band` (where half of it sits), `mid`, `you`, `ticks`. `size="sm"` is the shape for a metric tile; `size="lg"` adds the labels. The surface passes the words and the numbers (`labels`, `format`): the bar does no money maths. `rangeBarGeometry` is the pure part, for a plain-HTML page. |
|
|
2751
2769
|
| `ProgressRing` | "3 of 5" as a ring with the count inside. `progressRingGeometry` is the pure arc. A `max` that is not a positive number is an empty ring, never NaN. |
|
|
2770
|
+
| `ProgressBar` | how far along one thing is, as a thin `<progress>` (no inline style): `value`, `max`, `tone` (`ink` by default, `accent`, `success`, `critical`), `size` (`sm` 4px, `md` 8px), `label` (read out; without it the bar is hidden beside words that say the same). `progressBarValue` pins the numbers: a `max` that is not a positive number is an empty bar, never NaN. |
|
|
2752
2771
|
| `SpotArt` | six pictures in the brand's gem drawing style (`gem-radar`, `orbit`, `people`, `page`, `plug`, `price`) for the pauses and empty states a text-only screen lacks. Painted by tokens, decorative by default, an image only when given a `title`. |
|
|
2753
2772
|
| `QuestionCard` choices made by looking (unreleased) | a choice's `media` is a picture across the top of it (spans and images: the choice is a `<label>`), `layout="tiles"` puts the choices side by side (three on a card, one column on a phone), and a choice's `disabled` shows it greyed with its radio off (an option that failed its checks: seen, not choosable); the confirm stays off while a disabled choice is the value. GemBoss Brand › Logo is the first surface: three AI logos, one confirmed. |
|
|
2754
2773
|
| `LogoSheet` (unreleased) | one logo the way it has to be judged before it becomes a store's: the mark on a checkerboard (a white box around it shows), the name lockup on a light header and on a dark one (`lockup`, `lockupDark`), and the favicon at 32 × 32 CSS px beside the name, as a tab shows it. Every picture is a file the surface already has; nothing is drawn or scaled. Spans only, so it can be a `QuestionCard` choice's `media`. |
|
|
@@ -2761,6 +2780,31 @@ in `theme-dark.css`. They are fills, never text.
|
|
|
2761
2780
|
The contract every surface keeps: nothing is saved by choosing, only by the confirm, and what the confirm did is shown with Undo
|
|
2762
2781
|
after (`ActionCard`'s outcome, or the surface's own). The first choice is the assistant's best guess and says where it came from;
|
|
2763
2782
|
a question with no guess to offer is asked in the assistant's chat, not here.
|
|
2783
|
+
## Kind art (04/11/2026, unreleased): `KindArt`
|
|
2784
|
+
|
|
2785
|
+
A picker that asks "which kind?" (a new offer, a popup, a plugin, a funnel) shows each kind as a card, and the card's picture is what
|
|
2786
|
+
a person reads first. The New offer picker drew each kind's real widget shrunk into a 76 × 56 tile, its words 4px tall; Chris on prod,
|
|
2787
|
+
04/11/2026: too tiny to make out, the UI book's drawings are nicer. `KindArt` is the UI book's drawing (OF-2, `of-art` / `of-k*`), at
|
|
2788
|
+
its size, for every picker:
|
|
2789
|
+
|
|
2790
|
+
```tsx
|
|
2791
|
+
import { KindArt } from "@gemboss/ui";
|
|
2792
|
+
|
|
2793
|
+
<label className="my-pick__card"><input type="radio" … /><KindArt glyph="bundle" /><span>Bundle</span>…</label>
|
|
2794
|
+
```
|
|
2795
|
+
|
|
2796
|
+
- The strip: 50px tall, as wide as its card, a hairline (`--gemboss-divider-soft`), 8px corners, on cream (`#fbf7f1`, a shopper's
|
|
2797
|
+
page: the one colour the kit does not name, set once on `.ui-kind-art`; `data-theme="dark"` puts the canvas there). The drawing
|
|
2798
|
+
sits in its middle at the board's size in px and only shrinks, with a card narrower than it.
|
|
2799
|
+
- One grammar, painted by tokens: white boxes with a hairline, grey lines where words would be, ink for what the shopper presses or has
|
|
2800
|
+
picked (a button, the chosen row, a tick), iris for a saving, a bar that fills toward round stops, products as small tiles (a jar, a
|
|
2801
|
+
moon, a gummy), "+" and "→" in muted ink. Nothing in a drawing is text.
|
|
2802
|
+
- `glyph`, one of `KIND_GLYPHS`: `signup`, `quantity-break`, `bundle`, `upgrade`, `cross-sell`, `cart-add-on`, `gift`,
|
|
2803
|
+
`reward-tiers`, `bought-together`, `post-purchase`, `order-bump` (the eleven offer kinds; a picker with new kinds adds its drawings
|
|
2804
|
+
here, in the same grammar, so every screen draws a kind the same way). One that got past the type draws the strip alone.
|
|
2805
|
+
- Decorative (`aria-hidden`): the card's name says what it is. `title` makes it an image with that name, where the picture is the
|
|
2806
|
+
only thing that says it. Server-renderable, no inline style. Its own entry, `kind-art.css` (0.6 KB gzip).
|
|
2807
|
+
|
|
2764
2808
|
## Report pages (0.4.0)
|
|
2765
2809
|
|
|
2766
2810
|
Plain CSS in `kit-plain.css` for a numbers page written by hand (first user: gemnews `/admin`, 03/10/2026; that page moved to GemCommunity the same day, so gemnews no longer takes the package). The
|
|
@@ -2891,9 +2935,9 @@ GemBoss's Assistant › Skills and content-radar's /v2/skills show the same thin
|
|
|
2891
2935
|
| Piece | What it draws |
|
|
2892
2936
|
| --- | --- |
|
|
2893
2937
|
| `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. |
|
|
2938
|
+
| `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
2939
|
| `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
|
|
2940
|
+
| `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
2941
|
|
|
2898
2942
|
**The flow canvas is its own entry, and it is lazy.** `@xyflow/react` and `@dagrejs/dagre` are OPTIONAL peers of the kit: only
|
|
2899
2943
|
`@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 +2949,11 @@ const SkillFlow = dynamic(() => import("@gemboss/ui/skill-flow").then((m) => m.S
|
|
|
2905
2949
|
<SkillFlow flow={flow} phases={[{ key: "read", label: "Read" }, { key: "frame", label: "Frame" }, { key: "build", label: "Build" }, { key: "check", label: "Check" }]} />
|
|
2906
2950
|
```
|
|
2907
2951
|
|
|
2908
|
-
`@gemboss/ui/skill-flow/model` is the data side alone, no peer: `validateFlow(input, { phases })` (one
|
|
2909
|
-
problem
|
|
2952
|
+
`@gemboss/ui/skill-flow/model` is the data side alone, no peer: `validateFlow(input, { phases, messages? })` (one `FlowError` listing
|
|
2953
|
+
every problem, its `problems` as codes with params, the words English unless `messages` says them otherwise), `flowWithHtml`,
|
|
2954
|
+
`phasesIn`, `shortTool`, the zoom maths. A server checks a flow.json with it before a browser gets one. `@gemboss/ui/skill-flow/layout`
|
|
2955
|
+
is `layoutFlow` alone (dagre). The published package carries both as plain JavaScript under the `node` condition, so plain Node
|
|
2956
|
+
imports them from node_modules (04/11/2026).
|
|
2910
2957
|
The flow format: `{ direction: "TB" | "LR", nodes: [{ id, label, kind: start | step | decision | stop | exit | end, phase,
|
|
2911
2958
|
detail?, tools?, human?, examples?: [{ title, kind: input | output | good | bad | tool, md }] }], edges: [{ from, to, label?,
|
|
2912
2959
|
kind: normal | yes | no | loop }] }`; one start, at least one end, no dead end, every node reachable.
|
|
@@ -2929,6 +2976,193 @@ import { JobCard, SkillView, SkillStats, SkillRuleList, SkillViewSection } from
|
|
|
2929
2976
|
]} />
|
|
2930
2977
|
```
|
|
2931
2978
|
|
|
2979
|
+
## Versions (unreleased): `VersionPair`, `Figure`, and IndexTable's `mediaColumn`
|
|
2980
|
+
|
|
2981
|
+
The row a test and a personalization share (UI book AB-6, GemX board ubl-AB-6p). The admin's Tests table and Funnels › Personalize
|
|
2982
|
+
draw their pictures and figures from here, so one change moves both. Their own entry, `@gemboss/ui/versions.css`.
|
|
2983
|
+
|
|
2984
|
+
```tsx
|
|
2985
|
+
<IndexTable label="Personalizations" mediaColumn={{ header: "Versions" }}
|
|
2986
|
+
columns={[{ key: "what", header: "Personalization" }, { key: "adds", header: "Adds", numeric: true }, { key: "conf", header: "Confidence", numeric: true }]}
|
|
2987
|
+
rows={[{ id, title, sub: where, href, media: <VersionPair a={<Poster page={a} />} b={<Poster page={b} />} lit="b" />,
|
|
2988
|
+
cells: { adds: <Figure value="+31%" tone="pos" />, conf: <Figure value="96%" cap="calls at 95%" strong /> } }]} />
|
|
2989
|
+
```
|
|
2990
|
+
|
|
2991
|
+
- `VersionPair`: `a` and `b` are the surface's own pictures (null draws a blank card), held to 3:4 with their letters (`tags`, default
|
|
2992
|
+
A and B) on the corner. `lit: "a" | "b"` lights one letter: the version that leads a test, the one an audience is shown.
|
|
2993
|
+
- `Figure`: the value, and under it its cap in the caption's size. `strong` for the figure a column is about, `tone` for what kind of
|
|
2994
|
+
number it is (`pos` a gain, `accent` a version's letter, `muted` a dash or a word), `capTone: "pos"` for a lift under a leader.
|
|
2995
|
+
- `mediaColumn`: IndexTable puts each row's `media` in a column of its own before the title, and leaves it out when it folds.
|
|
2996
|
+
|
|
2997
|
+
`Notice` (its own entry, `@gemboss/ui/notice.css`) is the core's `ui-notice` on one line with what to do about it: an icon, the
|
|
2998
|
+
sentence, its one button at the end (`<Notice action={<button className="ui-btn">Turn off</button>}>… no difference for 30 days.</Notice>`).
|
|
2999
|
+
No tone is a card on the page's ground; `tone` takes the core notice's colours.
|
|
3000
|
+
|
|
3001
|
+
## Members (04/11/2026, unreleased): `MembersPage`, one members list for every service
|
|
3002
|
+
|
|
3003
|
+
Chris approved the pattern on 04/11/2026 (design "GemBoss Members Pattern"): GemCommunity Admin › Members, GemCare People and
|
|
3004
|
+
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.
|
|
3005
|
+
Invite, the CSV import and one person's details open when asked for; security stays in Settings and the page shows one line
|
|
3006
|
+
when there is something to do there. The kit draws the frame, the table, the role selects, the inline confirm, Invite, the
|
|
3007
|
+
CSV check, the drawer and the phone cards; an app declares its roles, scopes, chips, columns, ⋯ actions and drawer slot.
|
|
3008
|
+
|
|
3009
|
+
```tsx
|
|
3010
|
+
import { MembersPage, lastRoleGuard } from "@gemboss/ui";
|
|
3011
|
+
|
|
3012
|
+
<MembersPage
|
|
3013
|
+
people={people} // [{ id, name, email, avatar?, status, role? | roles?: { [scopeId]: roleId }, lastActive?, signIn? }]
|
|
3014
|
+
roles={[{ id: "admin", label: "Admin", staff: true }, { id: "mod", label: "Mod", staff: true }, "member"]}
|
|
3015
|
+
scopes={[{ id: community.slug, label: community.name }]} // GemCare: two workspaces
|
|
3016
|
+
currentUserId={me.id}
|
|
3017
|
+
filters={LIFECYCLE_CHIPS} columns={[chapterCol, lifecycleCol, levelCol]}
|
|
3018
|
+
canChangeRole={lastRoleGuard(people, "admin")}
|
|
3019
|
+
onRoleChange={(person, scope, role) => api("set-role", { userId: person.id, scope, role })}
|
|
3020
|
+
onInvite={invite} onCheckImport={checkCsv} onImport={importCsv}
|
|
3021
|
+
rowActions={[moveChapter, tag, { label: "Remove from group", danger: true, onAction: remove }]}
|
|
3022
|
+
inlineAction={(p) => (p.status === "pending" ? { label: "Approve", onAction: () => approve(p) } : null)}
|
|
3023
|
+
drawerActions={(p) => [{ label: "Sign out everywhere", onAction: signOut }, { label: "Lock", danger: true, onAction: lock }]}
|
|
3024
|
+
detail={(person) => <CommunityProfile person={person} />}
|
|
3025
|
+
notice={unsecured ? { message: `${unsecured} staff without 2FA`, action: { label: "See in Settings", href: "/settings/security" } } : null}
|
|
3026
|
+
secondaryActions={[{ content: "Export CSV", url: "/members.csv", external: true }]}
|
|
3027
|
+
labels={MEMBERS_VI} // any subset of MEMBERS_LABELS; English is the default
|
|
3028
|
+
/>
|
|
3029
|
+
```
|
|
3030
|
+
|
|
3031
|
+
| Part | What it does |
|
|
3032
|
+
| --- | --- |
|
|
3033
|
+
| 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 |
|
|
3034
|
+
| 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) |
|
|
3035
|
+
| Search | name and email, accents and case folded ("le" finds "Lê"); `query` + `onQueryChange` to hold it |
|
|
3036
|
+
| 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) |
|
|
3037
|
+
| 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) |
|
|
3038
|
+
| 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 |
|
|
3039
|
+
| 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 |
|
|
3040
|
+
| 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 |
|
|
3041
|
+
| 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 |
|
|
3042
|
+
| Words | every word from `labels` (`MEMBERS_LABELS` has them in English; `statuses` merges by key). Pass vi / zh |
|
|
3043
|
+
|
|
3044
|
+
**The CSV.** One person per line: `email, name, role, scope`. A first line of column names is read as the header (`email`,
|
|
3045
|
+
`name`, `role`, `scope` or `workspace`, in any order; other columns are ignored), else that order. A role or a scope by its id or
|
|
3046
|
+
its label, any case; none takes `defaultRole` (else the last role declared, the least) and the first scope. `"…"` may hold a comma;
|
|
3047
|
+
semicolons or tabs when the first line has more of them. Blank and `#` lines are skipped. A line is skipped, with its line number
|
|
3048
|
+
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).
|
|
3049
|
+
`parseMembersCsv` and the rest of the rules (`memberCounts`, `visibleMembers`, `roleChangeStep`, `lastRoleGuard`, `foldText`) are
|
|
3050
|
+
plain data in `@gemboss/ui/members-data`, no React, no stylesheet: a server checks an import with the same rules.
|
|
3051
|
+
|
|
3052
|
+
### Plain HTML: `gb-members-*`
|
|
3053
|
+
|
|
3054
|
+
A surface with no React (GemCare) links `@gemboss/ui/members.css` beside the core, `portal.css` (the avatar) and, for the drawer,
|
|
3055
|
+
`sheet.css`; it writes this markup and does the behaviour itself (filtering, the confirm, the drawer with `showModal()`; kit-plain.js
|
|
3056
|
+
gives the toast and the ⋯ menu). `members.test.tsx` holds every `gb-members-*` class below to one `members.css` styles.
|
|
3057
|
+
|
|
3058
|
+
<!-- members: plain -->
|
|
3059
|
+
```html
|
|
3060
|
+
<div class="gb-members">
|
|
3061
|
+
<div class="ui-list-page">
|
|
3062
|
+
<header class="ui-list-page__head">
|
|
3063
|
+
<div class="ui-list-page__title-row"><h1 class="ui-list-page__title">People</h1></div>
|
|
3064
|
+
<p class="ui-list-page__subtitle">9 people · 1 locked</p>
|
|
3065
|
+
<div class="ui-list-page__actions"><button type="button" class="ui-btn ui-btn--primary">Invite</button></div>
|
|
3066
|
+
</header>
|
|
3067
|
+
<div class="ui-list-page__notices">
|
|
3068
|
+
<div class="gb-members-notice gb-members-notice--warning">
|
|
3069
|
+
<span class="gb-members-notice__text">2 staff without 2FA</span>
|
|
3070
|
+
<a class="gb-members-notice__action" href="/settings/security">See in Settings</a>
|
|
3071
|
+
</div>
|
|
3072
|
+
</div>
|
|
3073
|
+
<div class="ui-list-page__toolbar">
|
|
3074
|
+
<div class="gb-members-bar">
|
|
3075
|
+
<div class="gb-members-chips" role="group" aria-label="Show">
|
|
3076
|
+
<button type="button" class="gb-members-chip" aria-pressed="true">All<span class="gb-members-chip__n">9</span></button>
|
|
3077
|
+
<button type="button" class="gb-members-chip" aria-pressed="false">Locked<span class="gb-members-chip__n">1</span></button>
|
|
3078
|
+
<span class="gb-members-sep" aria-hidden="true"></span>
|
|
3079
|
+
<button type="button" class="gb-members-chip" aria-pressed="false">GemPages care<span class="gb-members-chip__n">7</span></button>
|
|
3080
|
+
</div>
|
|
3081
|
+
<input type="search" class="gemboss-field gb-members-search" placeholder="Search name or email" aria-label="Search members">
|
|
3082
|
+
</div>
|
|
3083
|
+
</div>
|
|
3084
|
+
<section class="ui-card ui-list-page__card">
|
|
3085
|
+
<div class="gb-members-scroll">
|
|
3086
|
+
<table class="ui-table gb-members-table">
|
|
3087
|
+
<thead><tr><th scope="col">Person</th><th scope="col">GemBoss care</th><th scope="col">GemPages care</th><th scope="col">Status</th>
|
|
3088
|
+
<th scope="col">Last active</th><th scope="col" class="gb-members-actions"><span class="ui-sr-only">Actions</span></th></tr></thead>
|
|
3089
|
+
<tbody>
|
|
3090
|
+
<tr class="gb-members-row gb-members-row--changing">
|
|
3091
|
+
<th scope="row" class="gb-members-person">
|
|
3092
|
+
<span class="gb-members-who">
|
|
3093
|
+
<span class="gb-avatar gb-avatar--32" data-tone="1" aria-hidden="true">LT</span>
|
|
3094
|
+
<span class="gb-members-who__text">
|
|
3095
|
+
<span class="gb-members-who__line"><button type="button" class="gb-members-name">Linh Trần</button></span>
|
|
3096
|
+
<span class="gb-members-email">linh.tran@gem.example</span>
|
|
3097
|
+
</span>
|
|
3098
|
+
</span>
|
|
3099
|
+
</th>
|
|
3100
|
+
<td><select class="ui-select ui-select--slim gb-members-role gb-members-role--changing" aria-label="GemBoss care role for Linh Trần">
|
|
3101
|
+
<option value="supervisor" selected>Supervisor</option><option value="cs_agent">CS agent</option></select></td>
|
|
3102
|
+
<td><span class="gb-members-role gb-members-role--ro" title="An admin of this workspace keeps the role.">Admin</span></td>
|
|
3103
|
+
<td><span class="gb-members-status"><i class="gb-members-dot" aria-hidden="true"></i>Active</span></td>
|
|
3104
|
+
<td class="gb-members-last">3 hours ago</td>
|
|
3105
|
+
<td class="gb-members-actions">
|
|
3106
|
+
<span class="gb-members-confirm" role="group" aria-label="Change to Supervisor in GemBoss care?">
|
|
3107
|
+
<span class="gb-members-confirm__q" aria-live="polite">Change to Supervisor in GemBoss care?</span>
|
|
3108
|
+
<button type="button" class="ui-btn ui-btn--sm ui-btn--primary">Change</button>
|
|
3109
|
+
<button type="button" class="ui-btn ui-btn--sm">Cancel</button>
|
|
3110
|
+
</span>
|
|
3111
|
+
</td>
|
|
3112
|
+
</tr>
|
|
3113
|
+
<tr class="gb-members-row">
|
|
3114
|
+
<th scope="row" class="gb-members-person">…</th>
|
|
3115
|
+
<td>…</td><td>…</td>
|
|
3116
|
+
<td><span class="gb-members-status gb-members-status--locked"><i class="gb-members-dot" aria-hidden="true"></i>Locked</span></td>
|
|
3117
|
+
<td class="gb-members-last">never</td>
|
|
3118
|
+
<td class="gb-members-actions"><span class="gb-members-rowactions">
|
|
3119
|
+
<button type="button" class="ui-btn ui-btn--sm">Let back in</button>
|
|
3120
|
+
<details class="ui-menu ui-menu--end">…</details></span></td>
|
|
3121
|
+
</tr>
|
|
3122
|
+
</tbody>
|
|
3123
|
+
</table>
|
|
3124
|
+
</div>
|
|
3125
|
+
<ul class="gb-members-cards">
|
|
3126
|
+
<li class="gb-members-card">
|
|
3127
|
+
<button type="button" class="gb-members-card__open">
|
|
3128
|
+
<span class="gb-avatar gb-avatar--32" data-tone="1" aria-hidden="true">LT</span>
|
|
3129
|
+
<span class="gb-members-card__text"><span class="gb-members-card__name">Linh Trần</span>
|
|
3130
|
+
<span class="gb-members-card__meta">Supervisor / Admin · Active · 3 hours ago</span></span>
|
|
3131
|
+
<svg class="gb-members-card__go">…</svg>
|
|
3132
|
+
</button>
|
|
3133
|
+
</li>
|
|
3134
|
+
</ul>
|
|
3135
|
+
</section>
|
|
3136
|
+
</div>
|
|
3137
|
+
</div>
|
|
3138
|
+
<!-- The drawer: the kit's Sheet (dialog.ui-modal.ui-sheet), its body: -->
|
|
3139
|
+
<div class="gb-members-drawer">
|
|
3140
|
+
<section class="gb-members-drawer__sec" aria-label="Roles">
|
|
3141
|
+
<h3 class="gb-members-drawer__h">Roles</h3>
|
|
3142
|
+
<dl class="gb-members-kv">
|
|
3143
|
+
<div class="gb-members-kv__row"><dt>GemBoss care</dt><dd><select class="ui-select ui-select--slim gb-members-role">…</select></dd></div>
|
|
3144
|
+
<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>
|
|
3145
|
+
</dl>
|
|
3146
|
+
</section>
|
|
3147
|
+
<section class="gb-members-drawer__sec" aria-label="Sign-in">
|
|
3148
|
+
<h3 class="gb-members-drawer__h">Sign-in</h3>
|
|
3149
|
+
<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>
|
|
3150
|
+
<div class="gb-members-drawer__buttons"><button type="button" class="ui-btn ui-btn--sm">Sign out everywhere</button>
|
|
3151
|
+
<button type="button" class="ui-btn ui-btn--sm gb-members-btn--danger">Lock</button></div>
|
|
3152
|
+
</section>
|
|
3153
|
+
<div class="gb-members-drawer__slot">…the app's own…</div>
|
|
3154
|
+
</div>
|
|
3155
|
+
```
|
|
3156
|
+
|
|
3157
|
+
The rest of the classes (the Invite popup's `gb-members-tabs`, `-panel`, `-form`, `-field`, `-field__label`, `-input`, `-note`,
|
|
3158
|
+
`-error`, `-csv`, `-tools`, `-check`, `-check__row` (`--skip`), `-check__mark`, `-check__what`, `-check__why`; `gb-members-you`,
|
|
3159
|
+
`gb-members-tag--ok`, `gb-members-status--invited`, `gb-members-notice--info`) are drawn by `members.tsx`, the reference.
|
|
3160
|
+
|
|
3161
|
+
`members-browser.test.tsx` (Chromium, in `test:ui-browser`) clicks through it at 1440 and 390: the chips and the search, a role
|
|
3162
|
+
change confirmed, cancelled, escaped and undone, the drawer at the right edge and the focus back on the name, the ⋯ with its
|
|
3163
|
+
danger row, Invite › Many from paste to Import, the cards and the sideways chips on a phone, the drawer's own confirm, dark, and
|
|
3164
|
+
an app's bare `button:hover` rule (negative control: a plain button does turn black).
|
|
3165
|
+
|
|
2932
3166
|
## Collections (0.13.0): tables, lists, grids, boards
|
|
2933
3167
|
|
|
2934
3168
|
Chris settled these on 05/10/2026 after an inventory of 136 hand-made collections on 11 surfaces (86 tables scrolling
|
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.60.0 · Editor</h1>
|
|
12
12
|
<p>Khung của mọi editor: <code>EditorFrame</code> (cột trái · khe kéo · preview · cột phải dock trên mép phải preview) và <code>EditorTopbar</code> (← · tiêu đề · cụm giữa · cụm phải · dòng trạng thái). Là đúng khung của theme / page / section editor trong admin. Gói chỉ vẽ KHUNG; chat, Configure, canvas, page picker, menu, Publish là của editor, đi vào bằng slot. Trang HTML thuần nạp <code>editor.css</code> + <code>editor-plain.js</code> rồi gọi <code>gembossUI.initEditorFrame()</code>: kéo khe (chuột, chạm, phím mũi tên / Home / End), đổi thiết bị, mở ⋯ và Publish ▾, ẩn cột trái, Chat | Preview trên điện thoại. <a href="index.html">← Catalog</a></p>
|
|
13
13
|
<h2>React</h2><pre class="cat-api"><code>import "@gemboss/ui/editor.css";
|
|
14
14
|
import { EditorFrame, EditorTopbar, EditorBack, EditorChatToggle, EditorPaneTabs, EditorSaveState, DeviceToggle } from "@gemboss/ui/editor";
|
package/catalog/index.html
CHANGED
|
@@ -27,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.
|
|
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.60.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>269acfc78e16</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><button></code> lẫn <code><a></code> (căn giữa sẵn).</p><figure class="cat-demo"><figcaption>Mặc định · chính · ghost · nhỏ · tắt</figcaption><div class="cat-live"><div class="cat-row"><button type="button" class="ui-btn">Lưu nháp</button><button type="button" class="ui-btn ui-btn--primary">Xuất bản</button><button type="button" class="ui-btn ui-btn--ghost">Huỷ</button><button type="button" class="ui-btn ui-btn--sm">Nhỏ</button><button type="button" class="ui-btn ui-btn--primary" disabled>Đang lưu…</button><a class="ui-btn" href="#buttons">Link dạng nút</a></div></div><details class="cat-code"><summary>Markup</summary><pre><code><div class="cat-row">
|
|
33
33
|
<button type="button" class="ui-btn">Lưu nháp</button>
|
|
34
34
|
<button type="button" class="ui-btn ui-btn--primary">Xuất bản</button>
|