@gemboss/ui 0.65.0 → 0.67.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 +349 -2
- package/README.md +33 -4
- package/catalog/editor.html +21 -13
- package/catalog/index.html +6 -6
- package/gemboss-ui.css +3 -3
- package/package.json +10 -1
- package/parts/components.css +2 -2
- package/parts/core.css +1 -1
- package/parts/shell.css +1 -1
- package/src/assistant/engine.tsx +2 -18
- package/src/auth.tsx +1 -15
- package/src/board-auto-more.tsx +168 -0
- package/src/collections.tsx +10 -1
- package/src/confirm-buttons.ts +37 -0
- package/src/confirm-dialog.css +1 -0
- package/src/confirm-dialog.tsx +128 -0
- package/src/copy-field.css +1 -0
- package/src/copy-field.tsx +48 -0
- package/src/copy-text.ts +20 -0
- package/src/create-shell.css +1 -1
- package/src/create-shell.tsx +7 -4
- package/src/dialog.css +1 -0
- package/src/dialog.tsx +46 -7
- package/src/editor/choice-cards.tsx +71 -0
- package/src/editor/controls.tsx +61 -19
- package/src/editor/field-control.tsx +146 -58
- package/src/editor/field-frame.tsx +20 -10
- package/src/editor/field-spec.ts +43 -8
- package/src/editor/index.ts +16 -5
- package/src/editor/items-field.tsx +185 -0
- package/src/editor/items.ts +126 -0
- package/src/editor/label-side.ts +11 -4
- package/src/editor/panel.tsx +39 -12
- package/src/editor/repeater.tsx +37 -7
- package/src/editor/secret-field.tsx +118 -0
- package/src/editor/switch.tsx +34 -0
- package/src/editor-color.css +1 -1
- package/src/editor-grow.css +1 -0
- package/src/editor-insert.css +1 -1
- package/src/editor-plain.js +1 -1
- package/src/editor-repeater.css +1 -1
- package/src/editor-switch.css +1 -0
- package/src/editor.css +1 -1
- package/src/eye-icon.tsx +14 -0
- package/src/gemboss-field.css +1 -1
- package/src/icons-plain.js +1 -0
- package/src/icons.tsx +9 -0
- package/src/index.ts +7 -1
- package/src/kit-plain.css +1 -1
- package/src/list-page.css +1 -1
- package/src/list-page.tsx +94 -51
- package/src/list-toolbar.css +1 -0
- package/src/list-toolbar.tsx +85 -0
- package/src/menu-keys.ts +3 -1
- package/src/search-dialog.tsx +4 -1
- package/src/segmented.tsx +24 -6
- package/src/service-switcher.tsx +2 -2
- package/src/settings-dialog.tsx +2 -2
- package/src/ui.css +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,7 +2,355 @@
|
|
|
2
2
|
|
|
3
3
|
Versions up to 0.9.0 are described in the README, each in the section that introduced it.
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## 0.67.0 (09/11/2026)
|
|
6
|
+
|
|
7
|
+
**A question in the viewer's language, all of it** (09/11/2026; GemCommunity asks in en / vi / zh, gemcommunity #451). `ConfirmDialog`
|
|
8
|
+
`retryLabel`: the refused button's words (default "Try again"), and `closeLabel`: the ✕'s name (default "Close", passed to the
|
|
9
|
+
kit's Dialog). Without them nothing changes. confirm-buttons.ts takes `retryLabel` too (not shown once a refusal is final:
|
|
10
|
+
`canRetry={false}` keeps the action's words, off).
|
|
11
|
+
|
|
12
|
+
**The Items control opens an item picked elsewhere** (09/11/2026, Items editor PR 2: the canvas ↔ row link).
|
|
13
|
+
- `ItemsField` `open` (`{ index, field?, seq }`): that item's row opens alone and comes into view, and the field that shows the part picked
|
|
14
|
+
is marked (`data-canvas-focus`, outlined in editor-repeater.css), the focus left where the seller is. Read once per `seq`: moving or
|
|
15
|
+
removing rows afterwards opens no other row. `index` and `onActive` speak the STORED list's places (a row the host holds unsaved sits
|
|
16
|
+
among the shown ones and is heard as null).
|
|
17
|
+
- `ItemsField` `keepDraftsAs`: unsaved rows kept by name, so they outlive the control (a panel drawn again) and show in every control of
|
|
18
|
+
the same list.
|
|
19
|
+
- `RepeaterList` `openRequest` (`{ key, seq }`) opens a row from outside; with `single`, `onActive` now hears each row opened by hand or
|
|
20
|
+
by itself (added, duplicated) and the open one folded (null), inline as in a popover, so a host shows that item on its page.
|
|
21
|
+
|
|
22
|
+
**The Items control: every list setting, one control** (09/11/2026; Chris "one shared control set", fast and handy, clicks before typing).
|
|
23
|
+
- `ItemsField` (`@gemboss/ui/editor`), on `RepeaterList` + `useKeyedRows`: each item one line (its picture or its words, a ⋯ with Move
|
|
24
|
+
up / Move down / Duplicate / Remove), its grip drags it, Alt+↑ / ↓ moves it; a click opens that item's fields in place, one item at a
|
|
25
|
+
time, drawn by `FieldRows` so each label sits where the label-side table says; "+ Add <item>" puts in the list's `starter` row, opens it
|
|
26
|
+
and focuses its first field; `min` / `max` turn Remove / Add and Duplicate off, each saying why; `rowHolds` keeps a row the host cannot
|
|
27
|
+
save yet as a draft, unsaved. ONE write per change: the whole list. Remove asks nothing (every host draws it with an Undo).
|
|
28
|
+
- FieldSpec `repeater` is drawn with it (FieldControl): it was boxes per row, keyed by index, no reorder, a write per key typed and an
|
|
29
|
+
object drawn as "[object Object]". New on the spec: `fields` (a row's fields, any kind a form draws; `from`: older keys a value is
|
|
30
|
+
stored under), `noun`, `min`, `max`, `starter`, `title`, `thumb`. `item` stays, and without `starter` "+ Add" still puts in every key
|
|
31
|
+
empty, so a list's stored rows keep their shape.
|
|
32
|
+
- `editor/items.ts` (`@gemboss/ui/editor/items`, no React): a row read and written as stored. One field's write keeps every other key, a
|
|
33
|
+
picture's alt text (`{ url, altText }`), an older key's name, a string row as a string; emptying a field the row does not hold changes
|
|
34
|
+
nothing; a value its control cannot show is kept and named, never drawn as words.
|
|
35
|
+
- `RepeaterList` `single` (one row open at a time), `canRemove` / `removeWhy`; `FieldRows` `shopId` (an app's kinds in every field of a run).
|
|
36
|
+
- A text box's or a text area's count ("2/4", `maxLength`) sits under its box, at the box's end (`.gemboss-ei-count`), wherever it is drawn:
|
|
37
|
+
in a row it ran across the field like a note, so it stood under the label. A number's bounds and a field's help still run across.
|
|
38
|
+
|
|
39
|
+
**A SecretField box is never filled with a saved login** (09/11/2026; GemPersonalizer's Gearment keys, #7102). Its box says
|
|
40
|
+
`autocomplete="new-password"`, not `"off"`: Chrome ignores "off" on a password box and can fill the seller's saved admin.gemboss.ai
|
|
41
|
+
password into it, which a save then stores as a partner's key and sends to that partner (the admin's own gate,
|
|
42
|
+
a-secret-field-is-not-a-login-form.test.ts, measured it 07/10/2026). "new-password" is the value Chrome never fills; it may offer to
|
|
43
|
+
suggest a password, a nuisance, not a leak. Every SecretField takes it (no prop sets it back), and `password-autocomplete.test.tsx` holds
|
|
44
|
+
it: each state that draws the box renders "new-password", and a scan of packages/ui fails on any password box (a literal
|
|
45
|
+
`type="password"`, a `type={…}` that can be one, or an HTML string) that says "off". Markup change: a host that read the box's
|
|
46
|
+
`autocomplete` as "off" reads "new-password".
|
|
47
|
+
|
|
48
|
+
**A text box names the phone's keypad** (09/11/2026; one control set, GemPersonalizer's orders tab). `FieldSpec` text `inputMode`
|
|
49
|
+
(`decimal` | `numeric`): the keypad for a value kept as typed text (a cost typed as "12.50"); a `number` field keeps its own. Text
|
|
50
|
+
`verbatim`: an ID typed as written elsewhere (Gearment's store ID) is not spell-checked, corrected, capitalised or filled from the
|
|
51
|
+
browser's remembered entries, as the raw box it replaces was not (unlike `code`, it keeps the text face and its label beside it).
|
|
52
|
+
`Checkbox` `labelHidden`: its words read only, the box alone in the middle of a 44px square (`.gemboss-ei-check--bare`, editor.css,
|
|
53
|
+
which travels with the Checkbox); a tick on a print file's tile was 26px wide under a finger. A worded checkbox is unchanged (a min-width on it would
|
|
54
|
+
undo its min-content floor in a row and split its words). The orders tab's Gearment keys (SecretField), routing lists, sample state,
|
|
55
|
+
partner settings, mockup cost box and print-file tick are the kit's: the admin's one-control-set list 46 → 40 files.
|
|
56
|
+
|
|
57
|
+
**`Board` `autoMore`: a server-paged column reads on as it is scrolled** (09/11/2026; Chris on content-radar's Ideas board: "scroll
|
|
58
|
+
xuống dưới là infinite loop luôn chứ nhỉ"). `<Board autoMore …>` (or `autoMore={{ max, margin }}`): when a column's `ui-more` row comes
|
|
59
|
+
within 400px of the bottom of the scrolling area (the nearest scrolling ancestor, else the viewport) the row's own control is pressed, at
|
|
60
|
+
most 4 times a column, then the button is left for the reader, so what is under the board stays reachable. Only a press handled in place
|
|
61
|
+
counts: `onLoadMore`'s button or a router link (`linkAs` + `scroll: false`); a plain `<a>` (its navigation is cancelled, it would reload the
|
|
62
|
+
page at the top again and again) and kit-plain's `fetchMore` link (it moves focus and speaks) are left to the reader. One press in flight for the
|
|
63
|
+
whole document (a router keeps only the last of several navigations, so three columns ending together and pressed at once loaded one:
|
|
64
|
+
content-radar's Ideas, 09/11/2026): a press is over when its cards grow, its navigation has landed, its button is back after "Loading…",
|
|
65
|
+
its column is gone, or after 20 s (link) / 8 s (button); a press that added nothing rests that column 8 s while the others go on. A row the
|
|
66
|
+
reader has passed counts as reached while the reader is still beside the board, so a short column whose end went by while another page
|
|
67
|
+
loaded still reads on; below the whole board nothing loads; a column scrolled out sideways loads when shown. The column with the fewest
|
|
68
|
+
automatic loads goes first. A
|
|
69
|
+
column drawn anew with fewer cards (a new filter) starts over. Its client half is
|
|
70
|
+
an island the board draws inside itself (board-auto-more.tsx, `data-gb-auto-more`), so the board stays plain and needs no id.
|
|
71
|
+
board-auto-more.test.ts in Chromium (test:ui-browser): both ways, 1280 and 390, max, the plain link, fetchMore, a filter, a failed load, a
|
|
72
|
+
scrolling panel, negative controls without `autoMore`.
|
|
73
|
+
|
|
74
|
+
## 0.66.0 (09/11/2026)
|
|
75
|
+
|
|
76
|
+
**The icon set for surfaces without React: `@gemboss/ui/icons-plain.js`** (09/11/2026; GemNews' side rail and widget panel are plain
|
|
77
|
+
JavaScript, and a hand-copied path drifts). A classic script that adds to `globalThis.gembossUI`, like every other `*-plain.js`.
|
|
78
|
+
- `gembossUI.icon(name, { size, title })` returns the SVG `<Icon name size title>` renders (fill on the `<g>`, `aria-hidden` unless
|
|
79
|
+
titled, then `role="img"` + `<title>`, escaped as React escapes it). `size` as `<Icon>` takes it. An unknown name returns "" and
|
|
80
|
+
nothing throws, `null` options included.
|
|
81
|
+
- `gembossUI.ICON_NAMES`: the set's names, in icons.tsx order.
|
|
82
|
+
- Its `ICONS` block is written the way service-switcher-plain.js's and team-chat-plain.js's are: by `icons-plain.test.ts`, from
|
|
83
|
+
`renderToStaticMarkup(<Icon>)` (`UPDATE_PLAIN_CATALOGUE=1`). The test is red when the block and icons.tsx differ, when any icon
|
|
84
|
+
(plain, sized in px or a CSS length, titled with quotes and markup) differs from `<Icon>`, or when the package stops exporting or
|
|
85
|
+
shipping the file; negative controls move a path, hand-edit the file and swap the apostrophe escape.
|
|
86
|
+
- New icons, drawn on the same 20px grid with the 1.5px stroke: `chevronUp`, `bookmark`, `trophy`, `flame`, `grip`, `timer` (an
|
|
87
|
+
hourglass), `target`.
|
|
88
|
+
- Weight ceiling: `packages/ui/src/icons-plain.js` in weight-budget.json.
|
|
89
|
+
|
|
90
|
+
**A CSS value that runs long is read whole: the text field's `code`** (09/11/2026; §9.1, measured on prod in Theme editor › Global
|
|
91
|
+
styles at 1366: Mono font, Subtle and Strong border were 174px one-line boxes beside their labels in a 330px panel, the stack 172px and
|
|
92
|
+
the strong border 270px out of sight).
|
|
93
|
+
- `FieldSpec` text `code?: boolean`: a line of code or a CSS value that runs long (a condition's expression, a font stack, a border, a
|
|
94
|
+
shadow), the one `code` (the element panel's "Show when" expression, which drew a one-line monospace box, is drawn by it too). `controlOf` names it the `code`
|
|
95
|
+
control, so its label is above (LABEL_SIDE, unchanged) and every surface that declares such a field gets it.
|
|
96
|
+
- `FieldControl` draws it as `CodeLine`: one line of text in a monospace box across the field that wraps and grows with it
|
|
97
|
+
(`textarea.gemboss-ei-code-line` in `editor-grow.css`, its own entry since editor.css had no room; `field-sizing: content`; where a browser lacks that, the component sets the height, again when the
|
|
98
|
+
box's width changes). Enter commits (it leaves the box, as a text box's Enter does), not the Enter that ends an input method's
|
|
99
|
+
composition; a line break typed or pasted becomes a space, the caret staying where it was. No spell check, no autocorrect. Not with
|
|
100
|
+
`prefix` or `inputType` (not drawn with `code`).
|
|
101
|
+
- Chromium test `editor-code-line-browser.test.tsx`: a value over 420px all in sight at 280 / 330 / 400 and a phone's 390, the
|
|
102
|
+
fallback without `field-sizing`, Enter, paste and the caret, an input method's Enter, a short value one line; the same value in a
|
|
103
|
+
text box beside its label (as on main) as its negative control.
|
|
104
|
+
|
|
105
|
+
**The Items control: every list setting, one control** (09/11/2026; Chris "one shared control set", fast and handy, clicks before typing).
|
|
106
|
+
- `ItemsField` (`@gemboss/ui/editor`), on `RepeaterList` + `useKeyedRows`: each item one line (its picture or its words, a ⋯ with Move
|
|
107
|
+
up / Move down / Duplicate / Remove), its grip drags it, Alt+↑ / ↓ moves it; a click opens that item's fields in place, one item at a
|
|
108
|
+
time, drawn by `FieldRows` so each label sits where the label-side table says; "+ Add <item>" puts in the list's `starter` row, opens it
|
|
109
|
+
and focuses its first field; `min` / `max` turn Remove / Add and Duplicate off, each saying why; `rowHolds` keeps a row the host cannot
|
|
110
|
+
save yet as a draft, unsaved. ONE write per change: the whole list. Remove asks nothing (every host draws it with an Undo).
|
|
111
|
+
- FieldSpec `repeater` is drawn with it (FieldControl): it was boxes per row, keyed by index, no reorder, a write per key typed and an
|
|
112
|
+
object drawn as "[object Object]". New on the spec: `fields` (a row's fields, any kind a form draws; `from`: older keys a value is
|
|
113
|
+
stored under), `noun`, `min`, `max`, `starter`, `title`, `thumb`. `item` stays, and without `starter` "+ Add" still puts in every key
|
|
114
|
+
empty, so a list's stored rows keep their shape.
|
|
115
|
+
- `editor/items.ts` (`@gemboss/ui/editor/items`, no React): a row read and written as stored. One field's write keeps every other key, a
|
|
116
|
+
picture's alt text (`{ url, altText }`), an older key's name, a string row as a string; emptying a field the row does not hold changes
|
|
117
|
+
nothing; a value its control cannot show is kept and named, never drawn as words.
|
|
118
|
+
- `RepeaterList` `single` (one row open at a time), `canRemove` / `removeWhy`; `FieldRows` `shopId` (an app's kinds in every field of a run).
|
|
119
|
+
- A text box's or a text area's count ("2/4", `maxLength`) sits under its box, at the box's end (`.gemboss-ei-count`), wherever it is drawn:
|
|
120
|
+
in a row it ran across the field like a note, so it stood under the label. A number's bounds and a field's help still run across.
|
|
121
|
+
|
|
122
|
+
**A colour row is ONE field, and its hex is never cut** (09/11/2026; §9.1, measured on prod in Theme editor › Global styles at 1366:
|
|
123
|
+
a 330px panel, the label-beside row's 174px control column left the hex box 62px between the swatch and a 64px % box, and 8 of 9 hex
|
|
124
|
+
values were cut, "#6b7280" scrollWidth 80 in 60).
|
|
125
|
+
- `ColorControl`: the hex and its opacity are one field, as Figma and Shopify draw it: `[swatch] [#6b7280 │ 100%]`. The group is the
|
|
126
|
+
kit's field box (`gemboss-field gemboss-field--group gemboss-ei-color-group`); the text box (in `.gemboss-ei-color-box`, under the
|
|
127
|
+
theme colour's name) and the % box (`data-alpha`) are its `gemboss-field__bare` parts, a hairline between them. Each part keeps its
|
|
128
|
+
name (the label's; "… opacity"). Markup change: a host that styled `.gemboss-ei-color > .gemboss-ei-inp` or read the text box as
|
|
129
|
+
`gemboss-field` reads the group now.
|
|
130
|
+
- editor-color.css (ONE FIELD): the group starts from room for the widest 7-digit hex and "100%" in its own face (`13.5ch + 19px`:
|
|
131
|
+
"#DDDDDD" 8.8ch in Arial, "100%" 4.7ch in Verdana), lanes 8 · 2 and 3 · 3px, so swatch, hex and % share one line from a 330px panel
|
|
132
|
+
up and at a phone's 390. Where the line is shorter (a panel under ~320px, a phone's 320, a 44px swatch under a finger at 330) the field
|
|
133
|
+
goes under the swatch, the column wide: never cut. A field with no % part (a theme colour) needs room for its hex part only. Focus:
|
|
134
|
+
the group's ring, and a line under the part that has it. 44px tall under a finger at any width, and the % part at least 44px wide there in any face (its "100%" room is 41px in a narrow face at 13px: Liberation Sans in CI), counted in the group's room. The two boxes' widths (64 / 72px % box,
|
|
135
|
+
96px text box at a phone's width) are gone.
|
|
136
|
+
- gemboss-field.css: a field group's disabled look and its hover guard read any `gemboss-field__bare` part inside it, not only a direct
|
|
137
|
+
child (`:has(.gemboss-field__bare:disabled)`): the colour field's hex part sits in its own box, and an off field with no % part
|
|
138
|
+
still showed the hover border.
|
|
139
|
+
- editor-plain.js: the % part it adds once a colour is typed into a row drawn with none is the group's last part, with the text box's
|
|
140
|
+
classes. It went right after the text, inside the text box, and cut the hex. Same gzip weight as before.
|
|
141
|
+
- Chromium test `editor-color-hex-never-cut-browser.test.tsx`: panels 280 / 330 / 400 at a fine pointer (one line at 330 and 400),
|
|
142
|
+
a phone's 390 and 320, 330 under a finger, focus and names, the plain page, each in the system face, a narrow one (Arial / Liberation
|
|
143
|
+
Sans) and a wide one (Verdana / DejaVu Sans), so macOS and CI measure the same widths; main's markup and CSS, and main's insertion
|
|
144
|
+
(on "#DDDDDD", the widest hex), as its negative controls.
|
|
145
|
+
|
|
146
|
+
**What the theme editor's last hand-built controls needed** (09/11/2026; one control set, Chris 08/11: "một bộ control dùng chung"). The
|
|
147
|
+
element panel's Style and Show when, the POD buy box's pickers and print area, a theme section's words, Layout style and Custom CSS, and
|
|
148
|
+
Global styles' menus, form set, Quick view and style pack drew their own `<select>` / `<input>` / `<textarea>` / radio cards; they are the
|
|
149
|
+
kit's now (the admin's one-control-set list: 53 → 46 files). Added once, here:
|
|
150
|
+
- `ChoiceCards` (`@gemboss/ui/editor`): one choice of a few where each needs its words and a picture to be told apart before it is picked.
|
|
151
|
+
Real radios in one group (`name`): Tab enters at the one picked, the arrow keys move the pick; each card is its radio's label, one 44px
|
|
152
|
+
target at every width; the picture before the words or after them (`pictureAt`). Its look is in editor.css (`.gemboss-ei-choice*`).
|
|
153
|
+
- `SelectOption` `group`: a list draws a heading (`<optgroup>`) for each run of choices naming the same group (an element's styles: This
|
|
154
|
+
shop · Shared library). Chips draw none.
|
|
155
|
+
- `FieldSpec` text `code`: a line of code (a condition's expression), monospace, not spell-checked, its label above (the table's `code`).
|
|
156
|
+
One `code` since its merge with the CSS-value line (below): drawn as `CodeLine`, which wraps and grows; no one-line monospace box.
|
|
157
|
+
- `FieldControl` `note`: a line in sight under a select or a switch, inside its field (a row's note spans it), the control described by it
|
|
158
|
+
(`<id>-note`). `listId`: a `<datalist>` the host draws once for many text boxes (a menu's addresses).
|
|
159
|
+
- A number box steps with ↑ / ↓ as the browser's own number box does: by its `step` (1 by default), held to its bounds, an empty box from
|
|
160
|
+
its floor; each step is a draft like a key typed, written when the box is left.
|
|
161
|
+
- `describedBy` reaches On / Off and chips (on their group), as FieldControl's doc already said; `Seg` and `Segmented` take `describedBy`.
|
|
162
|
+
- A text or number box keeps what is typed when a host hands its draft back as the value (a host that shows each draft at once): a "0"
|
|
163
|
+
typed in a box held to 1 stays "0" until the box is left, then it is 1. Any other value from outside replaces the draft, as before.
|
|
164
|
+
|
|
165
|
+
**ChoiceCards: a card shown but not choosable** (09/11/2026; one control set, the plugin kernel's Uninstall dialog: Erase my data stays
|
|
166
|
+
in sight for a member who is not the store's Owner, off, its line saying why). `ChoiceCard` `disabled`: its radio off, the card faded
|
|
167
|
+
(`data-disabled`, the group's own look); the other cards stay choosable. The plugin kernel's last Polaris and hand-built controls (Show in
|
|
168
|
+
the menu, a widget's Theme, a library row's name and live tick, each theme's live look, Uninstall's Keep / Erase and its tick, a review
|
|
169
|
+
card's tick) are the kit's now: the admin's one-control-set list 46 → 40 files.
|
|
170
|
+
|
|
171
|
+
**What the theme editor's last hand-built controls needed** (09/11/2026; one control set, Chris 08/11: "một bộ control dùng chung"). The
|
|
172
|
+
element panel's Style and Show when, the POD buy box's pickers and print area, a theme section's words, Layout style and Custom CSS, and
|
|
173
|
+
Global styles' menus, form set, Quick view and style pack drew their own `<select>` / `<input>` / `<textarea>` / radio cards; they are the
|
|
174
|
+
kit's now (the admin's one-control-set list: 53 → 46 files). Added once, here:
|
|
175
|
+
- `ChoiceCards` (`@gemboss/ui/editor`): one choice of a few where each needs its words and a picture to be told apart before it is picked.
|
|
176
|
+
Real radios in one group (`name`): Tab enters at the one picked, the arrow keys move the pick; each card is its radio's label, one 44px
|
|
177
|
+
target at every width; the picture before the words or after them (`pictureAt`). Its look is in editor.css (`.gemboss-ei-choice*`).
|
|
178
|
+
- `SelectOption` `group`: a list draws a heading (`<optgroup>`) for each run of choices naming the same group (an element's styles: This
|
|
179
|
+
shop · Shared library). Chips draw none.
|
|
180
|
+
- `FieldSpec` text `code`: a line of code (a condition's expression), monospace, not spell-checked, its label above (the table's `code`).
|
|
181
|
+
- `FieldControl` `note`: a line in sight under a select or a switch, inside its field (a row's note spans it), the control described by it
|
|
182
|
+
(`<id>-note`). `listId`: a `<datalist>` the host draws once for many text boxes (a menu's addresses).
|
|
183
|
+
- A number box steps with ↑ / ↓ as the browser's own number box does: by its `step` (1 by default), held to its bounds, an empty box from
|
|
184
|
+
its floor; each step is a draft like a key typed, written when the box is left.
|
|
185
|
+
- `describedBy` reaches On / Off and chips (on their group), as FieldControl's doc already said; `Seg` and `Segmented` take `describedBy`.
|
|
186
|
+
- A text or number box keeps what is typed when a host hands its draft back as the value (a host that shows each draft at once): a "0"
|
|
187
|
+
typed in a box held to 1 stays "0" until the box is left, then it is 1. Any other value from outside replaces the draft, as before.
|
|
188
|
+
|
|
189
|
+
**What the Studio's own controls needed** (09/11/2026; one control set: the Studio's moments, run-funnel checks, holiday skin, media import,
|
|
190
|
+
canvas prompt bars, go-live link, cart-canvas switch and insert menu drew Polaris fields or raw boxes of their own; the admin's one-control-set
|
|
191
|
+
list 46 → 38 files). Added once, here:
|
|
192
|
+
- `CopyField` (`@gemboss/ui`, its own entry `copy-field.css`): a value to take away. Its read-only box (focus selects it), Copy link (Copied
|
|
193
|
+
for two seconds, or "Copy it by hand" with the box selected when the browser refuses the clipboard) and the host's actions after it, one row.
|
|
194
|
+
- `Switch` (`@gemboss/ui/editor`, its own entry `editor-switch.css`): on / off in place where a field's On / Off does not fit (a part's switch
|
|
195
|
+
on a canvas tag). The plain kit's `.ui-switch` numbers for a host without kit-plain.css; 44px under a finger, at least 24px under a mouse.
|
|
196
|
+
- `SelectOption` `disabled`: a list's option shown and not pickable ("Removed from the library", "This page has no sections").
|
|
197
|
+
- `PickSearch` and `PickerSearch` exported from `@gemboss/ui/editor`: the pickers' own search box for a host's combobox (the insert menu).
|
|
198
|
+
`editor-insert.css` no longer sizes a bare `input.gemboss-editor-insert-search` (the box is PickSearch's).
|
|
199
|
+
- No change to `ChatComposer`: with no chips it is already one row, the box and Send on it (both canvas prompt bars draw it so).
|
|
200
|
+
|
|
201
|
+
**What the theme editor's last hand-built controls needed** (09/11/2026; one control set, Chris 08/11: "một bộ control dùng chung"). The
|
|
202
|
+
element panel's Style and Show when, the POD buy box's pickers and print area, a theme section's words, Layout style and Custom CSS, and
|
|
203
|
+
Global styles' menus, form set, Quick view and style pack drew their own `<select>` / `<input>` / `<textarea>` / radio cards; they are the
|
|
204
|
+
kit's now (the admin's one-control-set list: 53 → 46 files). Added once, here:
|
|
205
|
+
- `ChoiceCards` (`@gemboss/ui/editor`): one choice of a few where each needs its words and a picture to be told apart before it is picked.
|
|
206
|
+
Real radios in one group (`name`): Tab enters at the one picked, the arrow keys move the pick; each card is its radio's label, one 44px
|
|
207
|
+
target at every width; the picture before the words or after them (`pictureAt`). Its look is in editor.css (`.gemboss-ei-choice*`).
|
|
208
|
+
- `SelectOption` `group`: a list draws a heading (`<optgroup>`) for each run of choices naming the same group (an element's styles: This
|
|
209
|
+
shop · Shared library). Chips draw none.
|
|
210
|
+
- `FieldSpec` text `code`: a line of code (a condition's expression), monospace, not spell-checked, its label above (the table's `code`).
|
|
211
|
+
- `FieldControl` `note`: a line in sight under a select or a switch, inside its field (a row's note spans it), the control described by it
|
|
212
|
+
(`<id>-note`). `listId`: a `<datalist>` the host draws once for many text boxes (a menu's addresses).
|
|
213
|
+
- A number box steps with ↑ / ↓ as the browser's own number box does: by its `step` (1 by default), held to its bounds, an empty box from
|
|
214
|
+
its floor; each step is a draft like a key typed, written when the box is left.
|
|
215
|
+
- `describedBy` reaches On / Off and chips (on their group), as FieldControl's doc already said; `Seg` and `Segmented` take `describedBy`.
|
|
216
|
+
- A text or number box keeps what is typed when a host hands its draft back as the value (a host that shows each draft at once): a "0"
|
|
217
|
+
typed in a box held to 1 stays "0" until the box is left, then it is 1. Any other value from outside replaces the draft, as before.
|
|
218
|
+
|
|
219
|
+
**`ListToolbar`: the row over a list** (09/11/2026; Chris 08/11: one control set, audit row 8). A search that grows to fill the row
|
|
220
|
+
and, at its right, the list's choices as selects (filters, then sort), its view switch and what acts on the same list (`tools`). One
|
|
221
|
+
row; on a phone the search keeps its line and the rest wraps under it. Built from the kit's own parts: the one text field
|
|
222
|
+
(`gemboss-field--group` holding the search glyph, the count while there is a search, and a clear that keeps the focus in the field;
|
|
223
|
+
the browser's own ✕ is hidden), `.ui-select`, `IconSegmented`. Its own entry, `list-toolbar.css` (0.4 KB gzip: the row's layout and
|
|
224
|
+
the clear). The GemBoss admin's 22 list screens draw it through components/shell/ListToolbar; the toolkits laid out rows of their
|
|
225
|
+
own (`gc-filters`, `cp-toolbar`) and can move onto it. list-toolbar-browser.test.tsx (1280 mouse, 390 finger, a negative control).
|
|
226
|
+
|
|
227
|
+
**An embedded editor's top bar is no longer under the app frame's nav on a phone** (09/11/2026). `main:has(.gemboss-editor)`
|
|
228
|
+
clipped with `overflow: hidden`, which made `main` the scroll container of the app frame's sticky nav: on a phone the nav's `top: 56px`
|
|
229
|
+
counted from `main` (already at 56) and drew 56px low, over the embedded editor's top bar (GemSeel › Cart box on prod: a tap on Save
|
|
230
|
+
landed on a nav tab). `overflow: clip` cuts the same overflow without being a scroll container. Chromium test
|
|
231
|
+
`embedded-editor-under-sticky-nav-browser.test.ts`, with `hidden` restored as its negative control.
|
|
232
|
+
|
|
233
|
+
|
|
234
|
+
- `FieldFrame` / `PartsFrame` `labels` (`FrameClusterLabels`): a host's own name for a cluster where the kit's (Look · Layout · Visibility ·
|
|
235
|
+
Code) would say the wrong thing; the plugin kernel's settings name theirs Look and Behavior (one control set 08/11/2026).
|
|
236
|
+
|
|
237
|
+
**Global styles in the settings frame** (09/11/2026; one settings frame: every settings surface in the element panel's frame).
|
|
238
|
+
- `FieldFrame` `after`: the host's parts after every one of the schema's groups in Look, its shared groups' chips too (the admin's Global
|
|
239
|
+
styles: its form set, product cards and bundle picker after its colours and type). Searched as every part is. A Look of `after` parts
|
|
240
|
+
only is drawn.
|
|
241
|
+
- A part's search skips what sits under `[data-search-skip]` (a widget's preview inside a part: its headings and labels are no setting's).
|
|
242
|
+
- Removed: `.gemboss-bundle-look .gemboss-ei-body` 44px rules (the admin's bundle form is a group of the settings frame, its rows the kit's
|
|
243
|
+
sizes: 44px under a finger).
|
|
244
|
+
|
|
245
|
+
**Checkbox: a yes the seller gives** (09/11/2026; one control set: the plain kit's `.ui-check` had no React control, and the admin, which
|
|
246
|
+
cannot load kit-plain.css, drew five of its own in its publish review).
|
|
247
|
+
- `Checkbox` (`@gemboss/ui/editor`): a box and its own words in one label (`label.ui-check.gemboss-ei-check`), one target, `describedBy`,
|
|
248
|
+
off with `disabled` and its `why` in the tooltip. For a consent or a pick in a list; a setting's On / Off stays FieldControl's `toggle`.
|
|
249
|
+
- ONE checkbox look: `.gemboss-ei-check` / `.gemboss-ei-checkbox` (editor.css) carry `.ui-check`'s numbers (a 44px target at every width,
|
|
250
|
+
an 18px box in the kit's accent, the words at the host's size, faded and not-allowed while off), for a host without kit-plain.css; a kit
|
|
251
|
+
test holds the two to the same numbers.
|
|
252
|
+
|
|
253
|
+
**A number box takes the decimal keypad, and reads a comma as its point** (09/11/2026; one control set: GemPersonalizer's print widths in
|
|
254
|
+
inches, its print box in percent and a size chart's measurements were Polaris number boxes and raw `inputmode=decimal` cells).
|
|
255
|
+
`FieldSpec` `number` takes `inputMode` (`decimal` | `numeric`), the text box's option: default `numeric`, which on an iPhone has no point,
|
|
256
|
+
so "12.5" could not be typed there; `decimal` opens digits and a point. Every kit number box reads a comma typed for its point as one: the
|
|
257
|
+
decimal keypad of a comma locale (vi, de) has a "," and no ".", and "31,25" read as no number left the box empty (a commit of ""). For each
|
|
258
|
+
key, the commit, the echo check and ↑ / ↓. Chromium cases in editor-field-control-browser.test.tsx, with the decimal keypad and without.
|
|
259
|
+
- A refused field is painted in the admin too: `.gemboss-field[aria-invalid="true"]` (and a field group holding one) moved from
|
|
260
|
+
kit-plain.css to gemboss-field.css, the field's own sheet. The admin loads no kit-plain.css, so a FieldControl given `invalid` (quiz's
|
|
261
|
+
page address, cookie-consent's answer id, GemPersonalizer's print numbers) set `aria-invalid` and drew a plain box. Plain pages load
|
|
262
|
+
both sheets, the field's first: the same look. The plain list and text area (`.ui-select`, `.ui-textarea`) keep theirs in kit-plain.css.
|
|
263
|
+
|
|
264
|
+
**SecretField: a secret the seller gives** (09/11/2026; one control set: every admin surface that takes a token or a key drew its own
|
|
265
|
+
password box, Polaris' or a raw input, each with its own words for "it is stored").
|
|
266
|
+
- `SecretField` (`@gemboss/ui/editor`): the masked box (autocomplete off, no spell check, 1Password and LastPass told to stay out; a
|
|
267
|
+
browser's own password manager may still offer to save it), Show / Hide for checking a paste (masked again when emptied), Paste (the
|
|
268
|
+
clipboard, never over what was typed meanwhile, with a line saying ⌘V / Ctrl+V when the browser refuses it), Enter for the host's submit.
|
|
269
|
+
Copy, cut and a drag out do nothing: a secret goes in, it does not come back out. Stored (`saved`, with its `at`), the box is gone: "Saved,
|
|
270
|
+
ends in …" with at most the last four characters the host hands (`secretTail`), never the secret, and Replace opens an empty box (Cancel
|
|
271
|
+
closes it; `replacing` controlled or not, `onReplacing`).
|
|
272
|
+
- `EyeIcon` is one module (eye-icon.tsx), drawn by PasswordField and SecretField.
|
|
273
|
+
- `LABEL_SIDE.secret` (beside): its box and buttons in the control column, the buttons under the box where the column is narrow.
|
|
274
|
+
|
|
275
|
+
- `Menu` (React): a click outside closes it in the capture phase (09/11/2026), so a control that stops its own click (the funnel
|
|
276
|
+
board's offer cards and rule pills) no longer leaves the menu floating over what it opened. menu-browser.test.ts 24, with the
|
|
277
|
+
bubble-phase listener as its negative control. The plain menus (kit-plain.js `initMenus`) still listen in the bubble phase:
|
|
278
|
+
that listener also closes a chosen row's menu after the row's own handler, so it moves on its own.
|
|
279
|
+
- `Segmented`: an option with an `href` is a link (`linkAs` for the app's Link), the one on `aria-current="page"` (ui.css already
|
|
280
|
+
draws `.ui-seg a[aria-current]`), and its press is the link's own, so a filter that is a URL keeps a new tab and a copied link;
|
|
281
|
+
`onChange` is optional for a group of links (09/11/2026, Analytics' device). segmented-browser.test.tsx: the links, and `scroll`
|
|
282
|
+
at 320 in a flex row (the group scrolls, the last option reachable whole) with its negative control (without it the last shows
|
|
283
|
+
5 of its 64px).
|
|
284
|
+
|
|
285
|
+
**`PanelTabs` is the admin's one tab row** (09/11/2026; Chris 08/11: one control set). The funnel inspector and the workflow panel
|
|
286
|
+
drew their own tablists (two looks, one with no keys); both are `PanelTabs` now, and the admin's gate `one-tab-row.test.ts` names the
|
|
287
|
+
rows not moved yet. `PanelTabs` with roving focus now takes Home and End (the first and the last tab), beside ← → (the WAI-ARIA tabs
|
|
288
|
+
pattern).
|
|
289
|
+
For the offer editor's Offer · Who & when · Design (UI book OF-1, moved the same day), an inspector row's tab takes `hint` (a muted
|
|
290
|
+
second line, the tab's description rather than part of its name; the row becomes a size container and under 300px only the labels
|
|
291
|
+
stay; every tab of such a row is drawn in the same column), `tabId` (its own id, for the panel's `aria-labelledby`) and `title` (a
|
|
292
|
+
tooltip); the row takes `flush` (no margin of its own, in a card outside the editor's column). editor.css 8.7 KB gzip of 9.0.
|
|
293
|
+
|
|
294
|
+
**Every label beside its control in the element panel** (09/11/2026; Chris 04–08/11: every setting that fits one row has its label beside
|
|
295
|
+
it, decided by one table). The label-side table and `Field`:
|
|
296
|
+
- `LABEL_SIDE.screens` is `beside`: Screens is three device pictures, each named in its tooltip and for a screen reader, as a vertical
|
|
297
|
+
alignment's pictures are (label-side audit decision E). Its three words did not fit the control column, so it was the last one-row
|
|
298
|
+
choice with its label above.
|
|
299
|
+
- `LABEL_SIDE.note` (`above`): a sentence where a control would be (a value filled from the section's copy, a product's metafield, a
|
|
300
|
+
list's content source; a setting edited in another place). The admin's gate reads a labelled field that holds words and no control as one.
|
|
301
|
+
- `Field` `labelId`: the label's own id, for a control that is a group of boxes it names (`aria-labelledby`).
|
|
302
|
+
- `Field` `onBlur`: the focus leaving a part of the field, after the part's own blur (a text box saved when the focus leaves its toolbar,
|
|
303
|
+
chips and link box too).
|
|
304
|
+
|
|
305
|
+
**A bar with no centre is one row and keeps its name** (08/11/2026). `EditorTopbar` with no `center` (a plugin's editor: Cart box,
|
|
306
|
+
Banner, a popup) borrowed the page editor's narrow rows: at 390 it drew ← on one row, Save alone on a second and an empty third, 133px
|
|
307
|
+
tall, with its name hidden below 1200px. Matching on the empty centre (`editor.css`), it is now one row at every width with the name
|
|
308
|
+
ellipsised and Save at the right; every bar with a centre (page, section, theme editors) is unchanged. Chromium test
|
|
309
|
+
`editor-topbar-no-centre-browser.test.ts` with a negative control on the stylesheet without the block.
|
|
310
|
+
|
|
311
|
+
- `FieldSpec` `text`: `inputType: "date"`, the browser's own date picker (value YYYY-MM-DD), for a day a form asks for (GemSeel's export
|
|
312
|
+
dates, one control set 08/11/2026). A `url`, `search` or `date` box sets `autocomplete="off"`: the browser's remembered entries would cover
|
|
313
|
+
the results, the picker or the buttons under it.
|
|
314
|
+
|
|
315
|
+
**PageActions: a page's header actions, as ListPage draws them, on any page** (08/11/2026; Chris 08/11: one control set, the same
|
|
316
|
+
component on every surface). The admin's Store hub is a Polaris Page, not a ListPage, and drew its own copy of the fold.
|
|
317
|
+
Added
|
|
318
|
+
- `PageActions` (`primaryAction` or `primary`, `secondaryActions`, `moreActions`, `actionGroups`, `linkAs`): the header actions
|
|
319
|
+
ListPage draws, now its own component, and ListPage draws them with it (the same markup and classes). The first two secondary
|
|
320
|
+
actions stand from a 560px column, all of them are behind one ⋯ below it and below 768px; `moreActions` are behind ⋯ at every
|
|
321
|
+
width; the primary stands last (`primaryAction` a node, or `primary` an action drawn dark with the secondary ones' rules: off with
|
|
322
|
+
its reason, busy, a link). With no secondary action there is one ⋯, not a wide and a narrow one.
|
|
323
|
+
- The column is the nearest `ui-page-column` query container. ListPage's page is one (`container: ui-list-page ui-page-column`,
|
|
324
|
+
`ui-list-page` kept for the admin's own queries); another page names its column so.
|
|
325
|
+
- `ListPageAction.busy`: off, with these words in place of its own ("Reading your site…"), on the button (aria-busy) and its ⋯ row.
|
|
326
|
+
- The admin's Store header is PageActions since this (gemboss #6961), its copy gone. Its Journal's Share report moves from before
|
|
327
|
+
⋯ to after it (the primary, last, as every kit and Polaris header).
|
|
328
|
+
- The actions' words and fill variables are on `.ui-list-page__actions` too, so they read the same outside a ListPage.
|
|
329
|
+
|
|
330
|
+
**ConfirmDialog: the question before an act the server does, for every app** (09/11/2026; Chris 08/11: one control set). It was the
|
|
331
|
+
admin's own, drawn in a Polaris Modal: a portal under the browser's top layer, so a confirm asked from a kit Sheet or Dialog opened behind
|
|
332
|
+
it, and seven admin screens drew a red button of their own in a kit Dialog instead. Now it is the kit's Dialog, so it opens over anything.
|
|
333
|
+
Added
|
|
334
|
+
- `ConfirmDialog` (`open`, `title`, `action`, `destructive`, `alternative`, `cancelLabel`, `busyCloseLabel`, `disabled`, `busy`, `error`,
|
|
335
|
+
`canRetry`, `wide`, `onConfirm`, `onClose`): the admin's API and rules unchanged. It stays open while the server answers (Escape, ✕, the
|
|
336
|
+
backdrop and Cancel wait too, unless `busyCloseLabel` names a way out for a long batch), says a refusal in place with Try again, closes
|
|
337
|
+
when the caller turns `open` false, and calls `onClose` only for a person's close. Its body is mounted only while it is shown, as the
|
|
338
|
+
Polaris Modal's was. An off button is `aria-disabled` and keeps the focus in the question; the focus starts on Cancel. `wide`: 620
|
|
339
|
+
instead of 460, for a question that lists what goes. Its own entry, `confirm-dialog.css`: its sentence and its busy ring.
|
|
340
|
+
- `useConfirmAsk<T>()`: one question about one thing (a row's Delete): `ask(item)`, `confirm(act)` (busy while it runs; a refusal the
|
|
341
|
+
act returns stays in the question; null closes it), `close`, and the item kept after it closes.
|
|
342
|
+
- `Dialog` `dismissible` (default true): false while a question waits. Escape (anywhere, including a second press, which Chrome lets
|
|
343
|
+
through a prevented `cancel`), ✕ and the backdrop do nothing.
|
|
344
|
+
- `dialog.css`, imported by Dialog (so by Sheet, ConfirmDialog, SettingsDialog, the service switcher and SearchDialog too): the native
|
|
345
|
+
popup's frame (no browser padding, the .5 scrim, the body scrolling between a fixed head and foot). kit-plain.css keeps the same for a
|
|
346
|
+
plain-HTML page; a surface that loads ui.css without it (the admin) stood every kit Dialog in the browser's 1em padding and 10% scrim.
|
|
347
|
+
Changed
|
|
348
|
+
- `.ui-modal--wide` and the destructive button (`ui-btn--critical`, `ui-btn--primary ui-btn--critical`) move from kit-plain.css to
|
|
349
|
+
ui.css: the admin's red buttons drew as plain ones (a confirm's Delete, the cart canvas's Throw it away).
|
|
350
|
+
- Tab belongs to the open kit popup (`holdTab`, in Dialog, Sheet, SettingsDialog, the service switcher and SearchDialog): a dialog of the
|
|
351
|
+
page it was opened from (Polaris' Modal, the admin's Modal) no longer hears a Tab from the popup's own content. Their traps prevented
|
|
352
|
+
the key at their last control and focused their first, which the browser refuses under a modal dialog, so Tab was stuck on a kit
|
|
353
|
+
popup's last button. A dialog drawn inside the popup keeps its own Tab.
|
|
6
354
|
|
|
7
355
|
## 0.65.0 (08/11/2026)
|
|
8
356
|
|
|
@@ -2412,7 +2760,6 @@ Changed
|
|
|
2412
2760
|
- The phone topbar with a switcher in it: under 360px the search's floor drops from 96 to 56px (the bar has no other
|
|
2413
2761
|
room: ☰, mark, button, search, assistant, account). A bar without the switcher is unchanged.
|
|
2414
2762
|
|
|
2415
|
-
|
|
2416
2763
|
## 0.35.7 (15/10/2026)
|
|
2417
2764
|
|
|
2418
2765
|
**The rail's scrollbar runs down the rail's edge.** The 12px side gutter was padding on `.icon-nav`, so the scroll box
|
package/README.md
CHANGED
|
@@ -87,6 +87,8 @@ its CSS out of the build with it (`sideEffects`). gzip of the minified file, as
|
|
|
87
87
|
| minichart | `@gemboss/ui/minichart.css` | `packages/ui/src/minichart.css` | `Sparkline`, `ShareBar` (0.30.0) | 0.5 KB | those components import it |
|
|
88
88
|
| setup-guide | `@gemboss/ui/setup-guide.css` | `packages/ui/src/setup-guide.css` | `SetupGuide` (0.30.0) | 0.9 KB | `SetupGuide` imports it |
|
|
89
89
|
| reader-dialog | `@gemboss/ui/reader-dialog.css` | `packages/ui/src/reader-dialog.css` | `ReaderDialog`: the popup sized for reading a document (0.41.0) | 0.4 KB | `ReaderDialog` imports it |
|
|
90
|
+
| confirm-dialog | `@gemboss/ui/confirm-dialog.css` | `packages/ui/src/confirm-dialog.css` | `ConfirmDialog`: the question before an act the server does, its sentence and its busy ring (09/11/2026, unreleased) | 0.3 KB | `ConfirmDialog` imports it |
|
|
91
|
+
| dialog | `@gemboss/ui/dialog.css` | `packages/ui/src/dialog.css` | `Dialog` and everything drawn in it or through `useModalDialog` (Sheet, ConfirmDialog, SettingsDialog, the service switcher, SearchDialog): the native popup's frame where ui.css is loaded without kit-plain.css (09/11/2026, unreleased) | 0.2 KB | `Dialog` imports it |
|
|
90
92
|
| service-switcher | `@gemboss/ui/service-switcher.css` | `packages/ui/src/service-switcher.css` | `ServiceSwitcher` and `Switcher`: the button after the brand and its panel (0.36.0; any list, illustrated tiles 0.40.0) | 2.2 KB | `ServiceSwitcher` imports it, and `BrandLockup` through it (README "ServiceSwitcher") |
|
|
91
93
|
| language-switcher | `@gemboss/ui/language-switcher.css` | `packages/ui/src/language-switcher.css` | `LanguageSwitcher`: the globe + "EN" / "VI" / "中" and the menu of languages (21/10/2026; works without the core) | 1.1 KB | `LanguageSwitcher` imports it; a plain-HTML page links it with `language-switcher-plain.js` (README "LanguageSwitcher") |
|
|
92
94
|
| team-chat | `@gemboss/ui/team-chat.css` | `packages/ui/src/team-chat.css` | the team chat layer (20/10/2026): rail, messages, composer, thread and people panels, the screen's layout | 3.6 KB | `TeamChat` and its pieces import it (with `Avatar`'s portal.css and `Reactions`' reactions.css); a plain-HTML page links it (README "The team chat layer") |
|
|
@@ -1693,6 +1695,27 @@ import { FLEET_LANGUAGES, LanguageSwitcher, matchLanguage } from "@gemboss/ui";
|
|
|
1693
1695
|
| CSS | `language-switcher.css`, its own entry, 1.1 KB gzip, imported by the component. The menu's base rules (the core's `ui-menu` ones) are repeated there with the core's values, so a page that links only this file (gemboss.ai, whose pages the core would reset; GemNews's extension) draws the same menu. The surface and the box at zero specificity (`:where`); the rows, the hint and the separator at ONE class (0,1,0, since 22/10/2026), the core's own weight: an app's `button { font: inherit }` (0,0,1) cannot make them 16px, and one class of the app's (`.gb-lang__item { … }` after it, `.my-bar .gb-lang__item`) restyles them on purpose (the gap and corners take two: `.gb-lang__item.ui-menu__item`, so app-shell.css's unset tokens on a page without the core cannot zero the gap). Tokens, so `data-theme="dark"` follows, each with its light value as the fallback: no core, no `gemboss-tokens.css`, still right (light) |
|
|
1694
1696
|
| The topbar | AppShell's phone bar (☰, brand, search, toggle, switcher, account chip) fits it at 320 / 360 / 390, between ThemeToggle and the chip, no horizontal scroll. A portal `Topbar` with `TopbarNav` does NOT have that room (GemFeedback: brand, tab menu, search, theme, Sign in, no room for a 55px button at 320–390, and at 601–687 the tabs ran under it): there the switcher goes in the folded tab menu, `TopbarNav foot`, and its end-slot copy wears `gb-topnav-unfolded` (README "Public portal pieces" › TopbarNav) |
|
|
1695
1697
|
|
|
1698
|
+
### Plain HTML: icons, `@gemboss/ui/icons-plain.js` (09/11/2026)
|
|
1699
|
+
|
|
1700
|
+
The `Icon` set for a page with no React (GemNews' side rail and widget panel). A classic script that ADDS to `gembossUI`, like every
|
|
1701
|
+
other `*-plain.js`: after `kit-plain.js` when the page has it, on its own when it does not; by `src`, or inlined. Never copy a path into
|
|
1702
|
+
a surface: it stops following the set.
|
|
1703
|
+
|
|
1704
|
+
```html
|
|
1705
|
+
<script src="ui/icons-plain.js"></script> <!-- GemNews copies it from node_modules like language-switcher.css -->
|
|
1706
|
+
<script>
|
|
1707
|
+
button.innerHTML = gembossUI.icon("search") + "<span>Search</span>"; // decorative: aria-hidden="true"
|
|
1708
|
+
mark.innerHTML = gembossUI.icon("bookmark", { size: 16, title: "Saved" }); // named: role="img" + <title>
|
|
1709
|
+
</script>
|
|
1710
|
+
```
|
|
1711
|
+
|
|
1712
|
+
| | |
|
|
1713
|
+
| --- | --- |
|
|
1714
|
+
| `gembossUI.icon(name, { size, title })` | the SVG `<Icon name size title>` renders (20px grid, 1.5px stroke, fill on the `<g>`; empty shapes self-closed). `size` as `<Icon>` takes it: 20 when absent, else as given (px or a CSS length). Unknown name: `""`; nothing throws, `null` options included |
|
|
1715
|
+
| `gembossUI.ICON_NAMES` | every name, in icons.tsx order |
|
|
1716
|
+
| Where the shapes come from | the `ICONS` block between `// icons:begin` and `// icons:end`, WRITTEN by `icons-plain.test.ts` from `renderToStaticMarkup(<Icon>)`, the way service-switcher-plain.js's and team-chat-plain.js's are. After changing icons.tsx: `UPDATE_PLAIN_CATALOGUE=1 npx vitest run packages/ui/src/icons-plain.test.ts`; the test is red until you do |
|
|
1717
|
+
| Weight | about 3 KB gzip minified, the whole set (load it once); ceiling in weight-budget.json |
|
|
1718
|
+
|
|
1696
1719
|
### Plain HTML: `gembossUI.languageSwitcher()` (21/10/2026)
|
|
1697
1720
|
|
|
1698
1721
|
For a page with no React (gemboss.ai, GemNews's extension popup, GemFactory, GemCare, GemPress): `language-switcher-plain.js`
|
|
@@ -2114,10 +2137,14 @@ import { Avatar, Dialog, Leaderboard, Podium, SearchDialog, ThemeToggle, themeSc
|
|
|
2114
2137
|
chriskoh26/gemboss-www, published on npm): the whole site kit (tokens from one `system.json`, header with the mega
|
|
2115
2138
|
menu, footer, sections, the rules Claude Code follows in `AGENTS.md`, and a CLI that checks a site and reports gaps).
|
|
2116
2139
|
Chris chose it on 24/10/2026 so GemPages, Gemians and every other GemCommerce website follow one kit. This layer stays
|
|
2117
|
-
until the pages still on it (
|
|
2118
|
-
|
|
2119
|
-
|
|
2120
|
-
|
|
2140
|
+
until the pages still on it (the community home) move over; do not adopt it on a new page. **GemNews is not one of them**
|
|
2141
|
+
(Chris 09/11/2026: "đồng bộ style của gemnews và gemcommunity và theo gemboss ui"): the GemNews new tab and news.gemboss.ai
|
|
2142
|
+
are an APP surface, like GemCommunity's member pages, and follow `@gemboss/ui` (tokens, `theme-dark.css`, the plain kit,
|
|
2143
|
+
`icons-plain.js`), not `@gemboss/website-ui`.
|
|
2144
|
+
|
|
2145
|
+
**Which layer.** A PUBLIC page (gemboss.ai, the docs, a product's home page before sign-in) uses this layer. An APP
|
|
2146
|
+
surface (the admin, a portal behind sign-in, GemFeedback's board, GemCommunity's member pages, the GemNews new tab and
|
|
2147
|
+
news.gemboss.ai) keeps `Topbar` + `BrandLockup` and the rest of `@gemboss/ui`. Chris 20/10/2026: "có gemboss
|
|
2121
2148
|
ui thì có gemboss website ui"; measured the same day, the public pages had drifted on the same detail: the logo name 18px on
|
|
2122
2149
|
gemboss.ai and the docs, 16px on news, 13.3px on the community home; the bar 65 / 57 / 69 / 56px.
|
|
2123
2150
|
|
|
@@ -3535,6 +3562,7 @@ node packages/ui/scripts/collections-gate.mjs --url https://partner-radar.ops.ge
|
|
|
3535
3562
|
|---|---|---|
|
|
3536
3563
|
| A work list: items with an #ID, filters, a review queue, links people send each other (GemFactory board) | **Pages**, `ui-pager` with numbers, position in the URL (`?p=3`) | Back returns to the same place, a link opens the same page, the total is visible. Infinite scroll loses all three. |
|
|
3537
3564
|
| One column of a Kanban (GemFactory), or a feed read top to bottom | **Load more**, `ui-more` | Nobody jumps to page 9 of one column or of a feed. |
|
|
3565
|
+
| The same, where the reader scans down a long column (content-radar Ideas) | **Load more** that loads itself: a server-paged `Board` with `autoMore` (09/11/2026) | The column reads on; after 4 automatic loads the button is back, so the footer and the next column stay reachable. Only loads handled in place (onLoadMore, a router link) are pressed. |
|
|
3538
3566
|
|
|
3539
3567
|
`ui-pager`: `<a rel="prev">` · page links · `<span class="ui-pager__gap" aria-hidden="true">…</span>` · the current page as
|
|
3540
3568
|
`<a aria-current="page">` (filled) · `<a rel="next">` · `<span class="ui-pager__range">201–250 of 655</span>` (pushed right).
|
|
@@ -3604,6 +3632,7 @@ something the base cannot express, add a token or a prop here, and every surface
|
|
|
3604
3632
|
| `gemboss-ui.css` | built at stage time and shipped minified (0.19.0); since 0.23.0 the COMPATIBILITY BUNDLE, frozen: `apps/admin/scripts/export-ui-css.mjs` (tokens + kit + field + `packages/ui/src/shell.css`, with Polaris `--p-*` resolved to their fallbacks) + `packages/ui/src/app-shell.css` + `auth.css` + `assistant.css` + `menu.css` + `kit-plain.css` + `chat.css` + `chat-composer.css` (`packages/ui/scripts/build-css.mjs`) |
|
|
3605
3633
|
| `packages/ui/src/shell.css` | the SHARED SHELL (rail, topbar, main, mobile drawer, the assistant's thread rail, popover surface, account chip). Exported as `@gemboss/ui/shell-source.css` since 0.23.0 (`@gemboss/ui/shell.css` is the built part). The admin's `gemboss-shell.css` @imports it on line 2; the export refuses a shared-shell rule in the admin's sheet or an admin-only rule here (one owner). |
|
|
3606
3634
|
| `packages/ui/src/menu-plain.js` | 23/10/2026: `gembossUI.initMenuKeys()`, a menu's roles and keys and one menu open at a time for plain HTML (`@gemboss/ui/menu-plain.js`), the same as `menu-keys.ts`. After `kit-plain.js`; runs by itself. See "Plain-HTML behaviour". |
|
|
3635
|
+
| `packages/ui/src/icons-plain.js` | 09/11/2026: `gembossUI.icon(name, { size, title })` and `gembossUI.ICON_NAMES`, the icon set for plain HTML (`@gemboss/ui/icons-plain.js`), the same SVG as `<Icon>`. Its `ICONS` block is written by `icons-plain.test.ts` (`UPDATE_PLAIN_CATALOGUE=1`), never by hand. See "Plain HTML: icons". |
|
|
3607
3636
|
| `packages/ui/src/menu.css` | 23/10/2026: the ⋯ menu and its icon button, moved out of `kit-plain.css` (same rules, same order in the core). Imported by `Menu`; see "Menu". |
|
|
3608
3637
|
| `packages/ui/src/kit-plain.css` | primitives for surfaces that render plain HTML, not React (0.2.1): key/value list (the menu and the icon button are `menu.css` since 23/10/2026); 0.3.0 adds `ui-link` / `ui-prose`, the media card (`ui-card--media`, `__media`, `__body`, `__foot`) and the popup's `ui-modal__body` / `__foot`. Shipped inside `gemboss-ui.css`; the admin does not import it (its first-load CSS budget has ~0.1 KB headroom).; (0.4.0) report pages: delta, large KPI grid, bar list, column chart, legend, funnel, card grid, section head. |
|
|
3609
3638
|
| `packages/ui/src/kit-plain.js` | 0.3.0: the behaviour those surfaces each wrote by hand: `gembossUI.openModal` (Escape, backdrop, Tab trap, stacking, ask-before-close, focus back), `toast` (text, error tone), `initMenus` (outside click, item with focus back on ⋯ first, blur, Escape closes the menu before the popup); 0.5.0: `confirm`, `initShell`, `initPasswordFields` / `resetPasswordFields`. A classic script: inline it or `<script src>`; see "Plain-HTML behaviour" above. |
|