@gemboss/ui 0.55.1 → 0.56.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 +372 -0
- package/README.md +10 -8
- package/catalog/editor.html +58 -34
- package/catalog/index.html +5 -5
- package/gemboss-ui.css +3 -3
- package/package.json +5 -1
- package/parts/components.css +2 -2
- package/parts/core.css +1 -1
- package/parts/shell.css +1 -1
- package/src/assistant/host.tsx +49 -2
- package/src/assistant/provider.tsx +18 -7
- package/src/assistant-chat.css +1 -1
- package/src/assistant-plain.js +1 -1
- package/src/assistant.css +1 -1
- package/src/chat.css +1 -1
- package/src/collections.css +1 -1
- package/src/collections.tsx +11 -2
- package/src/create-shell.css +1 -1
- package/src/create-shell.tsx +24 -9
- package/src/editor/color-picker.tsx +8 -4
- package/src/editor/controls.tsx +404 -58
- package/src/editor/index.ts +5 -3
- package/src/editor/layers.tsx +1 -1
- package/src/editor/new-value.ts +27 -0
- package/src/editor/panel.tsx +22 -9
- package/src/editor/repeater.tsx +66 -29
- package/src/editor/swatch.ts +7 -0
- package/src/editor/tiles.tsx +5 -3
- package/src/editor-color.css +1 -1
- package/src/editor-plain.js +1 -1
- package/src/editor-repeater.css +1 -1
- package/src/editor-tiles.css +1 -1
- package/src/editor.css +1 -1
- package/src/gem-holo.css +1 -0
- package/src/gem-holo.tsx +31 -0
- package/src/gemboss-field.css +1 -1
- package/src/gems.css +1 -0
- package/src/index.ts +3 -1
- package/src/kit-plain.css +1 -1
- package/src/list-page.tsx +6 -3
- package/src/menu.tsx +3 -1
- package/src/page-tabs.tsx +14 -0
- package/src/pager-extras.css +1 -1
- package/src/screens-arriving.ts +65 -0
- package/src/segmented.tsx +28 -4
- package/src/stage.css +1 -1
- package/src/stage.tsx +11 -4
- package/src/starting-point.tsx +25 -9
- package/src/ui.css +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,378 @@ 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.56.0 (30/10/2026)
|
|
8
|
+
|
|
9
|
+
**A folded inspector group hides a row field placed straight in it** (30/10/2026, found building Control UI C32 in gemboss).
|
|
10
|
+
|
|
11
|
+
Fixed
|
|
12
|
+
- `.gemboss-ei-gh[data-open="closed"] ~ *` (0,2,0) lost to `:is(.gemboss-ei-grp,.gemboss-ei-group) .gemboss-ei-fld--row{display:grid}`
|
|
13
|
+
(0,2,0, later in the file): a `Field row` that is a direct child of a folded `InspectorGroup` stayed drawn (the element panel's
|
|
14
|
+
folded Visibility group still showed Show when). The rule is now `.gemboss-ei-grp>.gemboss-ei-gh[data-open="closed"]~*` (0,3,0);
|
|
15
|
+
a header must be the group's own child, as `InspectorGroup` draws it.
|
|
16
|
+
|
|
17
|
+
**A board can show all its columns at once** (30/10/2026, UI book PL-1).
|
|
18
|
+
|
|
19
|
+
Added
|
|
20
|
+
- `Board` `minColumn` (px): the columns share the board's own width (the board sets `--ui-board-col`, which the one `.ui-board` rule reads; +8 B gzip), so all are seen,
|
|
21
|
+
down to that many px each; narrower than that the board scrolls as before. Plan's four stages pass 150: they fit the 852px list
|
|
22
|
+
column (201px each) and the 677px board at 1024 (157px), both measured on the rig. At the kit's 240 floor the board scrolled sideways at every desktop width
|
|
23
|
+
and its last column showed half (prod, 1280). A floor that is not a positive number is ignored. The phone's 78% columns are
|
|
24
|
+
unchanged.
|
|
25
|
+
|
|
26
|
+
**Assistant · full screen on a phone: the chrome folds into one ⋯** (30/10/2026, Chris: "trên mobile chiếm nhiều không gian quá, chắc
|
|
27
|
+
cần co các nút lại thành dấu 3 chấm… update cả trên gemboss ui").
|
|
28
|
+
|
|
29
|
+
Changed
|
|
30
|
+
- `AssistantHost` full screen at `COMPACT_CHROME_QUERY` (≤ 640px): instead of a row of round buttons above the chat (the surface's
|
|
31
|
+
`fullActions`, ⋯, shrink — five 44px buttons on Content Radar's Writer Studio), ONE ⋯. It holds the surface's `fullActions` as
|
|
32
|
+
rows with their labels (a press closes the menu, as a row does), the surface's rows (`menuItems`, Clear history) and the way back
|
|
33
|
+
("Back to the side panel" / "Shrink to popup"). Wider screens are unchanged. No new prop: every surface gets it.
|
|
34
|
+
- The way to a person stays OUT of the ⋯, words and all: a `fullActions` button marked `gb-dock-shrink-keep` (the admin's "Talk to a
|
|
35
|
+
person") keeps its place in the chrome.
|
|
36
|
+
- `assistant-plain.js` (GemPress, GemFactory) folds the same way at the same query, and rebuilds when the window crosses it
|
|
37
|
+
(`assistant-plain-browser.test.ts` now compares the two frames at 390px too).
|
|
38
|
+
|
|
39
|
+
Removed
|
|
40
|
+
- The ≤ 560px rules that made the full-screen chrome's buttons icon-only (`.gb-dock-shrink span` hidden, 44px circles) and the two that
|
|
41
|
+
gave labels back (`.gb-dock-shrink-keep`, and assistant-chat.css's icon-less `:not(:has(svg))`): on a phone those buttons are rows
|
|
42
|
+
in the ⋯ now, so nothing hides a label. `gemboss-ui.css` −31 B gzip, assistant.css −34 B, assistant-chat.css −67 B;
|
|
43
|
+
`assistant-plain.js` +137 B (its ceiling raised with Chris's OK).
|
|
44
|
+
|
|
45
|
+
**Settings · Chat looks as it did when its proportions were right** (30/10/2026, Chris).
|
|
46
|
+
|
|
47
|
+
Changed
|
|
48
|
+
- `PanelTabs` `column` (`.gemboss-ec-tabs`) is back to the look of #702 (23/07 to 05/10/2026): the picked tab bordered on the
|
|
49
|
+
surface with a 2px underline in the primary, no track. Its size is that look's on the scale: 32px tabs in 13px / 600 (12.5px /
|
|
50
|
+
600 then), the row padded 8px. The 05/10 density pass made it 28px in 12px, and C31 (above) a grey track with a white pill. The
|
|
51
|
+
editor's tab icons are 14px again. The inspector's Settings · Advanced keeps C31's track.
|
|
52
|
+
|
|
53
|
+
**The panel's spacing has four tiers, and every tab row one look** (30/10/2026, Control UI C31).
|
|
54
|
+
|
|
55
|
+
Changed
|
|
56
|
+
- `editor.css` declares the panel's proximity tiers once, on `:root`: `--gemboss-ei-gap-part` 4px (a label to its box, a box to its
|
|
57
|
+
chips, a hint), `--gemboss-ei-gap-setting` 16px (settings in a group; it was 12), `--gemboss-ei-gap-sub` 24px (a titled part of a
|
|
58
|
+
group, marked `data-ei-sub`), `--gemboss-ei-gap-group` 16px a side of a group's divider. Under a finger (`(pointer: coarse),
|
|
59
|
+
(max-width: 47.9975em)`) 4 / 12 / 20 / 12. Inside a setting against between settings was 6 : 12; it is 4 : 16.
|
|
60
|
+
- `PanelTabs` `column` (`.gemboss-ec-tabs`, an editor's Settings · Chat) is the inspector's look, one size up: a track in
|
|
61
|
+
`--gemboss-active-bg` with a white pill for the picked tab, 32px tabs in 13px text with 16px icons, 6px of track around them;
|
|
62
|
+
no border or underline. 44px tabs at 767 and below, as before.
|
|
63
|
+
- `PanelTabs` `inspector` (`.gemboss-ei-tabs`): its track is visible (it was `--gemboss-panel-bg`, the column's own white) and its
|
|
64
|
+
words 13px (28px tabs, as before); an unpicked tab under the pointer is tinted.
|
|
65
|
+
- A tab under the pointer is the divider's grey, a visible step under the track (the hover grey was 3 levels off it).
|
|
66
|
+
- Headers a host draws itself mark `data-ei-head`: the setting after one stands `--gemboss-ei-gap-head` off (8px, 4 under a finger),
|
|
67
|
+
as after a group's own header. Inside a `data-ei-sub` part its rows are a setting apart and its head's gap under its head; a part not
|
|
68
|
+
added yet is its + line, `data-ei-sub="line"`, and + lines stack 4px apart.
|
|
69
|
+
- `.gemboss-ei-group` (FieldRenderer's forms) is padded the group tier, 12 under a finger like `.gemboss-ei-grp`.
|
|
70
|
+
|
|
71
|
+
**A field's label line takes a mark** (30/10/2026, Control UI C30 slice 2).
|
|
72
|
+
|
|
73
|
+
Added
|
|
74
|
+
- `Field` `mark`: a small control right after the label, on its line, outside the `<label>` (so pressing it never focuses the
|
|
75
|
+
input), before the `aside`. The element panel puts its dot there, on a value set for the screen being edited. No CSS of its own:
|
|
76
|
+
the line's existing rules hold it, and a button in a field already gets the 44px floor under a finger.
|
|
77
|
+
|
|
78
|
+
**A list's row has one ⋯** (30/10/2026, Control UI C26 slice 2).
|
|
79
|
+
|
|
80
|
+
Changed
|
|
81
|
+
- `RepeaterList`: a row's four buttons (↑ ↓, duplicate, ✕, named "Move question 3 up", "Duplicate question 3", "Remove question 3")
|
|
82
|
+
are one ⋯, the kit's `Menu`, named "More actions for question 3" ("More actions for Plans item 3" without `item`), whose rows are
|
|
83
|
+
Move up, Move down, Duplicate and Remove. A test or a surface that pressed the old buttons opens the ⋯ and picks the row. The
|
|
84
|
+
grip and Alt+↑ / ↓ still move a row. At 320px an item's name had 66px beside the four buttons; it has 204.
|
|
85
|
+
- Duplicate at a full list (`canAdd` false) is off and says "List is full".
|
|
86
|
+
- After Remove the focus goes to the next row's ⋯, else the one before, else the add button, else the list.
|
|
87
|
+
- `.gemboss-ei-rep-acts` holds the `details.ui-menu`; its CSS reaches the ⋯ (`> .ui-menu > summary`) only, never the menu's rows.
|
|
88
|
+
- `MenuItem`: a space before its `hint`, so the row's name reads "Duplicate List is full", not "DuplicateList is full". The row is a
|
|
89
|
+
flex box, so nothing moves on screen.
|
|
90
|
+
|
|
91
|
+
**A media card holds one chip and a ⋯** (30/10/2026, Control UI C19 / C20).
|
|
92
|
+
|
|
93
|
+
Changed
|
|
94
|
+
- `MediaCard`: once it holds media (`name` set), its paste chip and Remove are rows of one ⋯ (the kit's `Menu`, named by
|
|
95
|
+
`menuLabel`): "Paste a URL" (`pasteLabel`), the caller's `more` (`MenuItem`s), then Remove (`onRemove`, a ⋯ also while a link is
|
|
96
|
+
set that plays nothing). Empty, its ways in stay chips, `whileEmpty` after the paste chip (✨ Generate). While the box is open
|
|
97
|
+
there is no ⋯ (opening it takes the focus from the box, whose blur writes): Remove is a chip beside it then. `before` may be a
|
|
98
|
+
function of whether the card holds media, to name its chip as the card shows ("Select image" / "Replace"). At 320px an image card
|
|
99
|
+
was two rows of chips, 136px; it is one, 86px.
|
|
100
|
+
- The box opens with the address in use selected, so a paste replaces it (the caret at its end put the new address after the old
|
|
101
|
+
one, and that was written). Enter and Escape give the focus back to the paste chip, else the ⋯; after Remove, to the paste chip.
|
|
102
|
+
- `ImageControl` (an image card): `more`, `whileEmpty` and `menuLabel` go to the card; `actions` may be a function of whether it
|
|
103
|
+
holds an image; its Remove is the ⋯'s row. Without `onFile`, as before.
|
|
104
|
+
|
|
105
|
+
**A media card for an image and a video** (30/10/2026, Control UI C20 slice 2).
|
|
106
|
+
|
|
107
|
+
Added
|
|
108
|
+
- `MediaCard`: the `.gemboss-ei-img` card as one component, the one owner of its look and of its box (§9.3): a 56px picture
|
|
109
|
+
(`thumbUrl`, or a `picture` node such as a video's first frame) beside the media's `name` and `meta`, else `empty`; the address
|
|
110
|
+
box behind a paste chip (`pasteLabel`), held by the caller (`open`, `onOpenChange`); `onKeep` (false: refused, the box stays with
|
|
111
|
+
what was typed), `onLeave` (Escape); chips `before` and `after` the paste chip; `boxAutoFocus` false to reopen the box for a
|
|
112
|
+
refused write without taking the focus. The admin's video card draws through it.
|
|
113
|
+
|
|
114
|
+
Changed
|
|
115
|
+
- `ImageControl` with `onFile` draws through `MediaCard`. One change: leaving the URL box for a chip of the card (Tab) keeps the URL
|
|
116
|
+
and closes the box, as leaving it for anything else did; it stayed open holding a URL already kept.
|
|
117
|
+
|
|
118
|
+
**A list names its rows** (29/10/2026, Control UI C26).
|
|
119
|
+
|
|
120
|
+
Added
|
|
121
|
+
- `RepeaterList` `item`: what one row is ("question", "plan"). A row with no name reads "Question 3", its buttons "Move question 3
|
|
122
|
+
up", "Duplicate question 3", "Remove question 3", the add button "+ Add question" unless `addLabel` says otherwise. Without it, as
|
|
123
|
+
before ("Item 3", "Remove Plans item 3", "+ Add item").
|
|
124
|
+
|
|
125
|
+
**An image card says its file size** (29/10/2026, Control UI C19 slice 2).
|
|
126
|
+
|
|
127
|
+
Added
|
|
128
|
+
- `ImageControl` `bytesOf`: the caller's size for an image URL, read after its pixels ("640 × 400 · 188 KB"); `fileSizeWords`, as
|
|
129
|
+
the Finder says a size (1 KB = 1,000 bytes).
|
|
130
|
+
|
|
131
|
+
**A chip in words says its number** (29/10/2026, Control UI C03).
|
|
132
|
+
|
|
133
|
+
Changed
|
|
134
|
+
- `ValueControl`: a preset with a `title` is named and shown on hover as "<label>, <title>" ("Medium, 720 px"), for a chip named in
|
|
135
|
+
words over a number. A preset without one is as before.
|
|
136
|
+
- `ValueControl` / `editor.css`: a row whose chips are words (two or more; `.gemboss-ei-value--words`) sizes each chip from its word, with 8px sides,
|
|
137
|
+
and shares what is left; 44px wide at a phone's width. Equal cells cut a weight's "Semibold" even at 1280 and "Medium" in 288px at
|
|
138
|
+
320. A row of numbers keeps its equal cells.
|
|
139
|
+
|
|
140
|
+
**An image is a card you can drop a file on** (29/10/2026, Control UI C19).
|
|
141
|
+
|
|
142
|
+
Added
|
|
143
|
+
- `ImageControl` `onFile`: a file dropped on the control goes to the caller (the store's library, in the admin), and the URL it answers
|
|
144
|
+
is used at once; a refusal is said under it (`role="alert"`). With it the control is an image card: a 56px thumbnail beside the
|
|
145
|
+
file's name (`imageFileName`, new: decoded, no query; "Embedded image" for a `data:` URL) and its size in pixels once the browser has
|
|
146
|
+
read it; empty, "Drop an image here" (and "Uploading…"). The URL box waits behind "Paste a URL": it opens focused; Enter keeps the URL,
|
|
147
|
+
Escape leaves it as it was, and either way the focus is back on "Paste a URL". A URL the caller puts in its `draft` (picked,
|
|
148
|
+
generated) is what the card shows until the value comes back. `nameOf`: the caller's name for an image URL (a library keeps an
|
|
149
|
+
upload's own file name while its URL is a content hash), asked for the image the card shows. An image that does not load reads
|
|
150
|
+
"Can't load this image". While the URL box is open its chips keep their press (they do not take the focus from the box). An upload
|
|
151
|
+
that answers after another choice (Remove, a URL kept, a new value) is dropped. A file dropped on a card that cannot take it now
|
|
152
|
+
(disabled, uploading) is held, not left to the browser.
|
|
153
|
+
- `ChipButton` forwards its ref.
|
|
154
|
+
|
|
155
|
+
Changed
|
|
156
|
+
- `ImageControl`: "Clear" reads "Remove". Without `onFile` the control is as it was (thumbnail, URL box, chips); the thumbnail is 56px,
|
|
157
|
+
and the chips wrap.
|
|
158
|
+
|
|
159
|
+
**A value of its own lights no chip** (29/10/2026, Control UI C09).
|
|
160
|
+
|
|
161
|
+
Changed
|
|
162
|
+
- `ValueControl`: a box value that is none of the chips lights none of them. It lit the chip whose value is "" (the one that clears),
|
|
163
|
+
since `Seg` lights "" for no value at all: Max width 500 px read "None", a Delay of 0.3 s read "0". An empty box still lights the ""
|
|
164
|
+
chip.
|
|
165
|
+
|
|
166
|
+
**Colour rows and four-chip rows fit a phone** (29/10/2026, Control UI C10).
|
|
167
|
+
|
|
168
|
+
Changed
|
|
169
|
+
- `editor-color.css`: under a finger or below 768px the colour box asks for 96px (`flex-basis`), so the % box beside it wraps under it
|
|
170
|
+
when the line is shorter. It shrank instead: at 320px a colour row beside its label had a 44px box, `#1A1A1A` read "#1", on every
|
|
171
|
+
colour row of the element panel.
|
|
172
|
+
- `ColorControl` / `editor-plain.js`: the % box's width is `editor-color.css`'s, not an inline `flex: 0 0 64px`: 64px, and 72px there,
|
|
173
|
+
where "100%" (41px at 16px) was cut in its 38px.
|
|
174
|
+
- `editor.css`: below 360px, a row beside its label whose chips are four (a shadow's None · Subtle · Medium · Large) puts its label
|
|
175
|
+
above and the chips across the field: four need 176px at 44 each, and the control column is 168 at 320.
|
|
176
|
+
|
|
177
|
+
**A theme colour reads by its name** (29/10/2026, Control UI C13).
|
|
178
|
+
|
|
179
|
+
Changed
|
|
180
|
+
- `ColorControl`: a `var(--gem-color-<role>)` value reads "Accent · Theme", drawn over the box (`.gemboss-ei-color-name` in the new
|
|
181
|
+
`.gemboss-ei-color-box`) while it is not focused; the name is the matching theme chip's (a chip without a group is a theme one), else
|
|
182
|
+
the token's own (`themeColorName`, new in `swatch.ts`: no palette needed, any case). The box's value never changes: focused, the
|
|
183
|
+
token shows, selected whole (again on a click's mouseup), so what is typed replaces it. A box under 150px (200px at a phone's 16px
|
|
184
|
+
type) keeps the name and drops "· Theme". A save that disables the box gives the name back.
|
|
185
|
+
|
|
186
|
+
**Updates above the screens wait for them to arrive** (29/10/2026).
|
|
187
|
+
|
|
188
|
+
Added
|
|
189
|
+
- `@gemboss/ui/screens-arriving`: `whenScreensHaveArrived(fn)` runs `fn` once no streamed screen's HTML is waiting for its
|
|
190
|
+
reveal (React's hidden `<div hidden id="S:…">`, there until its stylesheets load and its batch is revealed, at most one per
|
|
191
|
+
300 ms), at the latest after 3 s; `screensWaitingToShow()` says whether one is. React draws such a boundary again on the
|
|
192
|
+
client on any update, a transition too: on the admin's page editor, warm reloads, 1 of 5 opens drew the editor again. A
|
|
193
|
+
boundary whose HTML has not come yet is not waited for. One watch for every caller; once the document has finished with
|
|
194
|
+
nothing left, callers run at once.
|
|
195
|
+
|
|
196
|
+
Changed
|
|
197
|
+
- `AssistantProvider`: its restore from storage waits for that, then goes in its transition.
|
|
198
|
+
|
|
199
|
+
**A spacing field in the shape its sides have** (29/10/2026, Control UI C02).
|
|
200
|
+
|
|
201
|
+
Added
|
|
202
|
+
- `EdgeBox` takes `boxes` (each `{ key, mark, name }`) for boxes other than the four sides: one for all sides, vertical ·
|
|
203
|
+
horizontal, top · bottom. Generic over the box key; without `boxes` it is T · R · B · L as before. The boxes share the row's
|
|
204
|
+
width (1, 2 or 4).
|
|
205
|
+
- `Field` takes `aside`: a control on the label line, at its right, beside the label and not in it (a spacing field's shape).
|
|
206
|
+
|
|
207
|
+
**The assistant's restore lets the screens below hydrate** (29/10/2026).
|
|
208
|
+
|
|
209
|
+
Changed
|
|
210
|
+
- `AssistantProvider`: the popup's size, offset, shape and side width restored from storage after mount are set in a
|
|
211
|
+
transition. The provider sits above every screen, React sends its context change into every Suspense
|
|
212
|
+
boundary that has not hydrated yet, and a boundary that receives an urgent update before its code has arrived is drawn again
|
|
213
|
+
on the client: on the admin's page editor, 4 of 6 cold opens, the screen gone for up to a second. `setSideAllowed` stays
|
|
214
|
+
urgent (the host registers it before paint on the first open), and so do a screen's facts (they must match the path the
|
|
215
|
+
assistant is told).
|
|
216
|
+
|
|
217
|
+
**The picked segment is seen** (29/10/2026, Control UI C16).
|
|
218
|
+
|
|
219
|
+
Changed
|
|
220
|
+
- `ui.css`: the picked segment of every `.ui-seg` (`Segmented`, the editor's `Seg`, kit-plain's `[aria-pressed=true]`, a tab link's
|
|
221
|
+
`aria-current="page"`) carries a 1px outline of its text colour inside it, 15:1 against its fill. The fill alone was 1.13:1 on a
|
|
222
|
+
white surface, a hovered segment read darker than the picked one, and in forced colours nothing told them apart. The focus ring
|
|
223
|
+
takes its place while focused. One look for every switch, as before (no-hand-rolled-switch).
|
|
224
|
+
The line follows the group's corner (`--ui-radius-md` − 1px), so an end segment's frame is not cut by the group's rounded clip. A
|
|
225
|
+
disabled segment picked through `aria-pressed` or `aria-current` keeps its look on hover, as `.active` did.
|
|
226
|
+
- `kit-plain.css`: its copy of the picked look for `[aria-pressed=true]` goes (ui.css's rule carries it), and its 44px rules for
|
|
227
|
+
`.ui-seg` fold into the block with the same media, without the `min-height` and icon `min-width` that ui.css already sets in both
|
|
228
|
+
media. gemboss-ui.css: 22740 B gzip of its 22743 B ceiling (main 22735).
|
|
229
|
+
|
|
230
|
+
**A folded inspector group is one line** (29/10/2026, Control UI C29).
|
|
231
|
+
|
|
232
|
+
Changed
|
|
233
|
+
- `editor.css`: a `.gemboss-ei-grp` whose header is closed takes 8px above and below (37px a line under a mouse, was 53), and 2px
|
|
234
|
+
under a finger (49px, was 77: room for the head's focus ring at the pane's edge). Its divider stays; an open group keeps its 16px.
|
|
235
|
+
|
|
236
|
+
**A light stage, and the doors on it** (29/10/2026, UI book FN-2).
|
|
237
|
+
|
|
238
|
+
Added
|
|
239
|
+
- `Stage tone="light"`: the accent wash with iris dots, white windows and tiles with a soft lift (`StageTone` gains "light").
|
|
240
|
+
- `StartingPoint tone`: every door's picture on that stage. A door's `secondary` draws its button plain, so a screen keeps one
|
|
241
|
+
black button. `art: "page"` with `address`: one window whose bar is a page's address, for a door that starts from a page.
|
|
242
|
+
|
|
243
|
+
**The create shell's pictures turn light** (29/10/2026, UI book CF-1: the night-blue stage behind a funnel's five tiles read as dark
|
|
244
|
+
and busy).
|
|
245
|
+
|
|
246
|
+
Changed
|
|
247
|
+
- `CreatePath` draws its steps as white tiles with iris arrows on the light dotted ground (accent wash), not on the `Stage`.
|
|
248
|
+
- A door's art is the light iris tile (`--gemboss-accent-soft`, iris glyph), on the open door too.
|
|
249
|
+
|
|
250
|
+
Added
|
|
251
|
+
- `CreateDoorArt` "link": a chain link, for a door that starts from a pasted address ("From a page you have").
|
|
252
|
+
- `CreateCard picture={null}`: no picture box, for a card that is a way out of the grid ("Not sure which one?").
|
|
253
|
+
|
|
254
|
+
**A tile's shape, drawn elsewhere** (28/10/2026): `tileShapeStyle(shape, box = 26)` is exported from `@gemboss/ui/editor`, the
|
|
255
|
+
rectangle ChoiceTiles draws for a w×h shape, so a row that shows the shape chosen (the admin's Aspect ratio PickButton, 18px) draws it
|
|
256
|
+
by the same rule.
|
|
257
|
+
|
|
258
|
+
**One focus ring in the editors** (28/10/2026, editor roadmap: an element panel drew three focus rings, and none on a picked tile).
|
|
259
|
+
|
|
260
|
+
Changed
|
|
261
|
+
- Every ring in the editors' sheets is `--ui-focus` (iris), the one ring decided on 02/10/2026: the editor bar's back, ghost,
|
|
262
|
+
Publish and device buttons, its menus, the section inserter, the draft status, the repeater's buttons and picture tiles drew
|
|
263
|
+
`--gemboss-primary` (near-black), the draft status #2563eb. A picked tile's ring sits 2px out from its near-black border.
|
|
264
|
+
- The kit's field, control and pager rings (`gemboss-field.css`, `ui.css`, `pager-extras.css`) paint `--ui-focus` itself, not Polaris'
|
|
265
|
+
`--p-color-border-focus` first: in the admin Polaris' sheet loads after the shell and set that token back to #005bd3, so fields and
|
|
266
|
+
pickers drew blue beside iris tabs.
|
|
267
|
+
- The editor chat's Send button, its markdown links and the composer's focus glow use `--ui-focus` (near-black, the text colour).
|
|
268
|
+
- The colour swatch has a focus ring (it showed the browser's default), 2px out from its open iris border.
|
|
269
|
+
- `one-focus-ring.test.ts`: every rule of the package that paints a ring on focus (outline, outline-color, box-shadow) paints
|
|
270
|
+
`var(--ui-focus` itself, but a white ring on a dark toast and 38 rules outside the editors listed as debt (the list only shrinks;
|
|
271
|
+
the sheets a seller edits with, editor*, chat, gemboss-field and ui, owe nothing).
|
|
272
|
+
|
|
273
|
+
**A value control is two rows, not three** (28/10/2026, editor roadmap: the control audit of 27/10 measured the four settings drawn so,
|
|
274
|
+
line height, letter spacing, max width and min height, at ~39% of a Settings panel's height, 94px each).
|
|
275
|
+
|
|
276
|
+
Changed
|
|
277
|
+
- `ValueControl` draws the number box and its slider first, then the named values. In a label-beside `Field` of an inspector group
|
|
278
|
+
(`.gemboss-ei-fld--row` inside `.gemboss-ei-grp` / `.gemboss-ei-group`) the box and the slider take the label's line and the chips
|
|
279
|
+
and the note the field's width under it (editor.css, three rules); alone or in a stacked field they stack box first. Focus follows
|
|
280
|
+
what is read: the box, the slider, the chips. Custom keeps the box and the slider behind its chip as before.
|
|
281
|
+
- `PickButton` takes `describedBy` (`aria-describedby`): a line that says more about what is chosen (the font field's "not on Google
|
|
282
|
+
Fonts" note) stays tied to the button that names it.
|
|
283
|
+
- `PickButton` takes `className` (where the row sits: the theme editor's bar sizes its page picker under a finger) and hands its
|
|
284
|
+
click event to `onClick` (a trigger inside something that closes on a press outside stops it there). The theme editor's page
|
|
285
|
+
picker is a PickButton now; the `.gemboss-pagepicker-trigger` look rules (border, padding, hover, the label and caret spans) are
|
|
286
|
+
gone, its width cap (~220px), its bold 13px name at every width, its 18px icons and its finger size kept.
|
|
287
|
+
- `PickButton` takes `title` (a hover hint where no label beside it says what it chooses: the bar's page picker). Open
|
|
288
|
+
(`aria-expanded`), its box takes Polaris' active input border (`--gemboss-field-line-active`), so the popover's trigger is seen; and its picture is at least 20px
|
|
289
|
+
wide, not exactly, so a font's "Aa" in a wide face or at a phone's 16px stays in its box.
|
|
290
|
+
|
|
291
|
+
**The four gems and Gem, alive** (25/10/2026, Chris: the dashboard is "khá trung tính an toàn đen trắng" and needs rich touches
|
|
292
|
+
that keep it clean; then advertorialx.com's hero effect, "vừa sạch mà làm cho nó nguy hiểm"; canvas YMjMbXo, boards 1–3, approved).
|
|
293
|
+
|
|
294
|
+
Added
|
|
295
|
+
- `gems.css`, an entry a surface links beside its core: `--gemboss-gem-emerald` #0f9d74, `--gemboss-gem-ruby` #d81b55 and
|
|
296
|
+
`--gemboss-gem-amber` #c27c0e (sapphire is the iris accent), and the rail count (`.gnav-count`) in ruby with white on it, at
|
|
297
|
+
two classes so it wins over app-shell.css in any load order. An entry, not the core: gemboss-ui.css is frozen and measured
|
|
298
|
+
22741 B gzip against its 22743 ceiling, and three more tokens cost 36 B of it. One job each: ruby = look here (new, hot,
|
|
299
|
+
waiting for you; never an error, which stays `--gemboss-danger`), emerald = it is working, amber = connect and wait. Never a
|
|
300
|
+
button fill. `gem-` because they are the stones themselves, the same in dark (so the dark-palette rule leaves them out).
|
|
301
|
+
- `Stage` takes a `tone` ("sapphire", the default, "emerald", "amber", "ruby"): the same light and grid, another stone, five
|
|
302
|
+
variables per tone in stage.css (under its ceiling). Exported type `StageTone`.
|
|
303
|
+
- `GemHolo` (gem-holo.tsx + gem-holo.css, its own entry, and the `@gemboss/ui/gem-holo` subpath for a `next/dynamic` import):
|
|
304
|
+
the four gems as one light that morphs (border-radius) and turns (transform); `busy` is faster, `facets` draws the gem's
|
|
305
|
+
outline over it. CSS only, no script and no canvas; still under prefers-reduced-motion; `aria-hidden`.
|
|
306
|
+
|
|
307
|
+
Changed
|
|
308
|
+
- editor.css: the kit's icon buttons (`.gemboss-pv-device`: ↶ ↷, ⋯ on every editor bar) are 44 × 44 under a finger AND at a
|
|
309
|
+
phone's width (`(pointer: coarse), (max-width: 47.9975em)`); they were 38 × 38 under a finger only, so the theme editor's
|
|
310
|
+
bar, which had no copy of its own, stood at 38 on a tablet (measured 22/10/2026). The page editor's own 44 is now this one
|
|
311
|
+
rule, and the bar's ← Back, chat toggle, + Add section, Publish and page picker are 44 at a phone's width under any pointer
|
|
312
|
+
too (they were under a finger only).
|
|
313
|
+
- editor.css: the tablet device frame (`.gemboss-pv-frame.tablet`) is 770px and `box-sizing: border-box`, so the page inside
|
|
314
|
+
it is 768px wide; it was 768 with its 1px border inside under the admin's global border-box, a 766px page. With screen
|
|
315
|
+
values that inherit mobile ← tablet ← desktop and a phone cut at 767px (Chris 26/10/2026, the GemPages model), 766 drew
|
|
316
|
+
the PHONE's values in a frame labelled Tablet (measured in Chromium: 766 before, 768 after). The phone frame is unchanged
|
|
317
|
+
(388px inside, under the cut). editor.css is its own entry: gemboss-ui.css does not change.
|
|
318
|
+
|
|
319
|
+
**The full type scale in the settings panel** (Chris 26/10/2026: "full type scale like GemPages v7: H1–H6, P1–P3 + Custom"). The
|
|
320
|
+
admin's text styles are H1 · H2 · H3 · H4 · H5 · H6 · P1 · P2 · P3 · Custom (P3 = the theme step `text-xs`, seam 1.0.110).
|
|
321
|
+
|
|
322
|
+
Added
|
|
323
|
+
- `Segmented` takes `wrap` (options per row): past that many the group is a grid of equal cells in rows, each cell divided from
|
|
324
|
+
the next by its own 1px ring in a 1px gap (a `border-left` divider would draw a second edge at the start of every row and none
|
|
325
|
+
between rows), the last cell taking what is left of its row. A cell pads its sides 4px, not the switch's 12: its width is the
|
|
326
|
+
grid's and its words are centred, so the padding only decides when a word is cut ("Custom" whole in a fifth of 266px). Layout styles on the component, as `scroll` is (gemboss-ui.css has
|
|
327
|
+
no room); opt-in; not with `scroll`. The editor kit's `Seg` passes it through.
|
|
328
|
+
- `ValueControl` takes `custom` (`{ label, open, onOpen }`): a last chip (`data-value="custom"`, so no named value may be `custom`)
|
|
329
|
+
that holds the box and the slider. They show only while `open`, and then that chip is lit and no named value is. The caller
|
|
330
|
+
decides `open` (the chip picked, or a value of its own held) and what the box holds when it opens. Without it the box always
|
|
331
|
+
shows, as before.
|
|
332
|
+
|
|
333
|
+
Changed
|
|
334
|
+
- `ValueControl` wraps its chips into two even rows past six (nine in the 266px column, the narrowest settings column: rows of
|
|
335
|
+
five, the last two cells wide). Every label stays whole and every chip 44 × 44 under a finger and at a phone's width (Chromium,
|
|
336
|
+
unit-field-browser.test.tsx; the negative control, nine in one row, is under 44px and cuts "Custom"). No CSS added.
|
|
337
|
+
|
|
338
|
+
**A control takes a new value in the render that brings it** (27/10/2026, gemboss #5577: after Take latest the held row was gone
|
|
339
|
+
while the page editor's box still showed the seller's typing, and a gate reading that frame went red on CI only).
|
|
340
|
+
|
|
341
|
+
Added
|
|
342
|
+
- `useOnNewValue(take, deps)` (`@gemboss/ui/editor`, new-value.ts): runs `take` while the component renders whenever `deps` differ
|
|
343
|
+
from the last render's, where `useEffect(() => setDraft(value), [value])` did it a commit later. `take` sets this component's
|
|
344
|
+
state (it may read a ref an event writes); `deps` are props or primitives worked out from them.
|
|
345
|
+
|
|
346
|
+
Changed
|
|
347
|
+
- `ColorControl`, `ImageControl` and `ColorPicker` take a value from outside with it: the hex box, the URL box and the square
|
|
348
|
+
change in the same commit as the rest of the panel.
|
|
349
|
+
|
|
350
|
+
**A box with something before its value** (27/10/2026: the page editor's Page settings moved onto the kit's controls, and its URL
|
|
351
|
+
handle is "/pages/" then the handle, in one box).
|
|
352
|
+
|
|
353
|
+
Added
|
|
354
|
+
- `UnitField` takes a `prefix`, inside the box before the value (Polaris TextField's `prefix`), as `unit` is after it:
|
|
355
|
+
`.gemboss-ei-prefix`, in editor.css with the component (gemboss-field.css, where the suffix is, is frozen at its ceiling).
|
|
356
|
+
|
|
357
|
+
Changed
|
|
358
|
+
- editor.css: a rule a host draws right after a field, marked `.gemboss-ei-rule` (`.gemboss-ei-hint gemboss-ei-rule`: what an empty
|
|
359
|
+
field does, a line's grammar), is 4px under the box, as the field's own bounds and count are; the field's 12px put it beside the
|
|
360
|
+
next field. Only a marked one: a group's own hint also follows its last field and belongs to the group.
|
|
361
|
+
- editor.css: a notice's action in a non-collapsible group (a hint, then a button: Older section's Upgrade) is 12px under the
|
|
362
|
+
sentence; the group holds its children bare and it sat 0px under it.
|
|
363
|
+
- `textarea.gemboss-ei-inp.gemboss-mono` is monospace (a field's code box: Custom CSS, Custom JS).
|
|
364
|
+
|
|
365
|
+
Removed
|
|
366
|
+
- `.gemboss-settings-field` (its layout, `> span`, its box width, `small`, its `textarea.gemboss-mono`) and the page editor's own
|
|
367
|
+
`.gemboss-settings-handle span`: nothing in the fleet draws them any more (the page editor was the last). A drawer's body is the
|
|
368
|
+
kit's `Field`s (README, the catalog's Page settings).
|
|
369
|
+
|
|
370
|
+
**A choice made in a popover, shown in one row** (27/10/2026, control audit of the element panel, 71 kinds: a button's Icon drew
|
|
371
|
+
its twenty tiles open, 386px, the tallest setting of its Settings).
|
|
372
|
+
|
|
373
|
+
Added
|
|
374
|
+
- `PickButton` (`@gemboss/ui/editor`): what is chosen (a picture and its name) and a ▾ in one line, in the kit's pressable box
|
|
375
|
+
(`.gemboss-control`: 32px under a mouse, 44px under a finger), `aria-haspopup="dialog"` + `aria-expanded`; it opens the caller's
|
|
376
|
+
`Popover`, as ColorControl's swatch opens the picker. `waiting`: a write it made is on its way, the press does nothing and says it is
|
|
377
|
+
busy, and the button keeps the focus (a disabled one drops it to the page). CSS `.gemboss-ei-pickbtn` in editor.css.
|
|
378
|
+
|
|
7
379
|
## 0.55.1 (25/10/2026)
|
|
8
380
|
|
|
9
381
|
Fixed
|
package/README.md
CHANGED
|
@@ -91,6 +91,8 @@ its CSS out of the build with it (`sideEffects`). gzip of the minified file, as
|
|
|
91
91
|
| 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 |
|
|
92
92
|
| 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 |
|
|
93
93
|
| 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 |
|
|
94
|
+
| 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) |
|
|
95
|
+
| 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 |
|
|
94
96
|
| 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) |
|
|
95
97
|
|
|
96
98
|
The core alone is 14.7 KB against 21.7 for the bundle (each part opens with a short header naming the gemboss commit, kept through minify, so a surface serving the parts can still say which commit its CSS is); a list page adds collections (4.6), a sign-in page auth (2.6).
|
|
@@ -797,9 +799,9 @@ import "@gemboss/ui/editor.css"; // only on the screens that show an editor
|
|
|
797
799
|
| Preview | `.gemboss-pv` › `.gemboss-pv-stage` › `.gemboss-pv-frame` (`.desktop` / `.tablet` / `.mobile`, `.gemboss-pv-fit` for scale-to-fit) › `iframe.gemboss-pv-iframe`; `.gemboss-pv-spin`; empty state `.gemboss-pv-empty` (`-art`, `-title`, `-sub`, `-cta`). Device toggle `.gemboss-pv-devices › button.gemboss-pv-device` |
|
|
798
800
|
| Left column | tab row `div.gemboss-ec-tabs[role=tablist] › button[role=tab][aria-selected]` (add `.gemboss-ec-tab` for the 44px pointer floors); Configure pane `.gemboss-ec-dock-body` |
|
|
799
801
|
| Inspector | `.gemboss-ei` (`--docked` inside the Configure pane) › `.gemboss-ei-head` (`-title`, `-x`, `-savedot`), `.gemboss-ei-tabs › .gemboss-ei-tab`, `.gemboss-ei-body`, `.gemboss-ei-foot`. Groups `.gemboss-ei-group › .gemboss-ei-grouphead` (collapsible) and `.gemboss-ei-gh` / `.gemboss-ei-grp`. Field `.gemboss-ei-fld › label + control + .gemboss-ei-hint` |
|
|
800
|
-
| Controls | text / select `.gemboss-field.gemboss-ei-inp` (+ `.gemboss-ei-mono`), a number with its unit inside `UnitField` (`label.gemboss-field.gemboss-field--group` › `.gemboss-field__bare` + `.gemboss-field__suffix`, 0.40.0; `.gemboss-ei-suffix` is gone), segmented `.gemboss-ei-seg`, colour `.gemboss-ei-color` / `.gemboss-ei-swatches › .gemboss-ei-sw` / `.gemboss-ei-swatch`, range `.gemboss-ei-range` + `.gemboss-ei-rangeval`, spacing box `.gemboss-ei-edgebox › .gemboss-ei-edge`, image `.gemboss-ei-img` (`-thumb`, `-ctl`, `-actions`, `-grid`, `-cell`), repeater `.gemboss-ei-rep-item` (`-head`, `-acts`, `-add`), blocks `.gemboss-ei-block` (`-head`, `-x`), add `.gemboss-ei-addrow` (its buttons are the kit's `.ui-btn` via `ChipButton`, 0.40.0; `.gemboss-ei-addchip` is gone), element tree `.gemboss-ei-tree › .gemboss-ei-tnode` (`-tname`, `-tacts`, `-tadd`), notes `.gemboss-ei-note`, `.gemboss-ei-oos` (`-h`), `.gemboss-ei-empty`, drag `.gemboss-ei-drag` / `.gemboss-ei-dragmask` |
|
|
802
|
+
| Controls | text / select `.gemboss-field.gemboss-ei-inp` (+ `.gemboss-ei-mono`), a number with its unit inside `UnitField` (`label.gemboss-field.gemboss-field--group` › `.gemboss-field__bare` + `.gemboss-field__suffix`, 0.40.0; `.gemboss-ei-suffix` is gone), segmented `.gemboss-ei-seg`, colour `.gemboss-ei-color` / `.gemboss-ei-swatches › .gemboss-ei-sw` / `.gemboss-ei-swatch`, range `.gemboss-ei-range` + `.gemboss-ei-rangeval`, spacing box `.gemboss-ei-edgebox › .gemboss-ei-edge`, image `.gemboss-ei-img` (`-thumb`, `-ctl`, `-actions`, `-info`, `-name`, `-meta`, `-drop`, `-grid`, `-cell`), repeater `.gemboss-ei-rep-item` (`-head`, `-acts`, `-add`), blocks `.gemboss-ei-block` (`-head`, `-x`), add `.gemboss-ei-addrow` (its buttons are the kit's `.ui-btn` via `ChipButton`, 0.40.0; `.gemboss-ei-addchip` is gone), element tree `.gemboss-ei-tree › .gemboss-ei-tnode` (`-tname`, `-tacts`, `-tadd`), notes `.gemboss-ei-note`, `.gemboss-ei-oos` (`-h`), `.gemboss-ei-empty`, drag `.gemboss-ei-drag` / `.gemboss-ei-dragmask` |
|
|
801
803
|
| Layers | `.gemboss-layers` › `.gemboss-layer-head` + `.gemboss-layers-list` › `.gemboss-layer` (`.is-sel`) › `.gemboss-layer-main` (`.gemboss-layer-type`) + `.gemboss-layer-acts` (`.gemboss-layer-del`) |
|
|
802
|
-
| Settings drawer | `.gemboss-settings` › `.gemboss-picker-head` + `.gemboss-settings-body` › `.gemboss-settings-
|
|
804
|
+
| Settings drawer | `.gemboss-settings` › `.gemboss-picker-head` + `.gemboss-settings-body` › the kit's `Field`s (`.gemboss-ei-fld`), `.gemboss-settings-grouphead`, `-gen`, `-note`, `-error`; `.gemboss-settings-foot` (`-save`, `-cancel`); backdrop `.gemboss-picker-backdrop`, empty `.gemboss-picker-empty` |
|
|
803
805
|
| Page / section editor bar | `.gemboss-pageedit` (`-top`, `-title`, `-kind`, `-status`, `-standing`, `-scope`, `-modes`, `-notice`, `-chip`, `-pv`; the left cluster's gap is `--gemboss-tb-gap`, 12px, for a child that hands it back; above 1000px the bar's tracks are `auto fit-content(100%) auto`, so its free space sits beside the centre), `.gemboss-sec-type`, section insert `.gemboss-sec-insert-*`, draft preview `.gemboss-page-draft-stage` / `-status`, `.gemboss-page-section-content`, global styles bundle `.gemboss-bundle-look` |
|
|
804
806
|
| Try door bar | `.gemboss-editor-topbar--guest` › `.gemboss-guest-brand` (`.gemboss-guest-mark`), `-note`, `-keep`, `-signin` |
|
|
805
807
|
|
|
@@ -924,13 +926,13 @@ import { ColorControl, EdgeBox, Field, ImageControl, InspectorGroup, PanelAction
|
|
|
924
926
|
|---|---|---|
|
|
925
927
|
| `PanelTabs` | `variant="column"`: `.gemboss-ec-tabs` › `.gemboss-ec-tab` (Configure · Chat, `icon` before the label). `variant="inspector"`: `.gemboss-ei-tabs` › `.gemboss-ei-tab(.on)` | `role=tablist` / `tab`, `aria-selected`, `data-value` (the tab's id, for plain HTML), `aria-controls` from a tab's `controls`. `roving` (default on): only the selected tab is a Tab stop, ←/→ move the selection and the focus, wrapping. The admin's Configure · Chat row passes `roving={false}` (both tabs Tab stops, no arrows: how it always behaved). |
|
|
926
928
|
| `PanelHeader`, `PanelAction` | `header.gemboss-ei-head` › `.gemboss-ei-title` (+ `small` subtitle) · `.gemboss-ei-act` buttons · `.gemboss-ei-x` ✕ | ✕ only with `onClose` (a docked panel has none); `onDragStart` adds `.gemboss-ei-drag` and takes the mouse-down of a floating panel. |
|
|
927
|
-
| `InspectorGroup` | `.gemboss-ei-grp` › `button.gemboss-ei-gh` (13px / 650, the chevron at its end, `note` as `.gemboss-ei-gh-note`) + the body | `aria-expanded`, `data-open`; closed, CSS hides everything after the header (the body stays mounted; an inline `display` on the body's first element would win over that, so give it a bare wrapper). Controlled (`open` + `onOpenChange`, which receives the NEXT state) or not (`defaultOpen`). `attrs`: `data-*` on the group itself, so a page that finds groups by an attribute needs no wrapper (a wrapper drops the divider between groups). `collapsible={false}`: the schema form's static group, `section.gemboss-ei-group` › `h4.gemboss-ei-grouphead` + `hint`. |
|
|
928
|
-
| `Field` | `.gemboss-ei-fld` › `label` (13px / 500; `htmlFor`; `labelValue` as `.gemboss-ei-rangeval` at its right edge) · control · `hint` | No label when `label` is undefined / null. `className` (the admin's `togrow`), `style`. |
|
|
929
|
+
| `InspectorGroup` | `.gemboss-ei-grp` › `button.gemboss-ei-gh` (13px / 650, the chevron at its end, `note` as `.gemboss-ei-gh-note`) + the body | `aria-expanded`, `data-open`; closed, CSS hides everything after the header (`.gemboss-ei-grp>.gemboss-ei-gh[data-open="closed"]~*`, a class heavier than any field's own `display`; the body stays mounted; an inline `display` on the body's first element would still win over that, so give it a bare wrapper). Controlled (`open` + `onOpenChange`, which receives the NEXT state) or not (`defaultOpen`). `attrs`: `data-*` on the group itself, so a page that finds groups by an attribute needs no wrapper (a wrapper drops the divider between groups). `collapsible={false}`: the schema form's static group, `section.gemboss-ei-group` › `h4.gemboss-ei-grouphead` + `hint`. |
|
|
930
|
+
| `Field` | `.gemboss-ei-fld` › `label` (13px / 500; `htmlFor`; `labelValue` as `.gemboss-ei-rangeval` at its right edge) · control · `hint` | No label when `label` is undefined / null. `className` (the admin's `togrow`), `style`. `aside`: a control on the label line, at its right, beside the label and not in it (a spacing field's shape). |
|
|
929
931
|
| `Seg` | `.gemboss-ei-seg[role=group]` › `button[aria-pressed][data-value]` (`.on`) | A click hands back the option's value; `label` names the group; `style` on the group. |
|
|
930
932
|
| `ColorControl` | `.gemboss-ei-color` › `button.gemboss-ei-swatch` + text box | The swatch opens the kit's picker (Popover + ColorPicker), which commits on every pick (a drag at most every 80 ms). The text box keeps a draft, each key sent to `onDraft` for a host that holds unsaved edits, and commits on blur (every blur) or Enter. A value the swatch cannot show (a token, a gradient) disables it and says why under it (`swatchState`). |
|
|
931
933
|
| `RangeControl` | `input[type=range].gemboss-ei-range` | Every change, as a number (drag, arrows, Home / End). Show the value with `Field`'s `labelValue`. |
|
|
932
|
-
| `EdgeBox` | `.gemboss-ei-edgebox` › four `.gemboss-ei-edge` (box + T / R / B / L) | `onChange(side, raw)` per keystroke, `onCommit()` on blur; Enter blurs. Boxes named "<label> top / right / bottom / left". `narrow` (default) adds `gemboss-field--narrow`; `placeholders`, `ids` per
|
|
933
|
-
| `ImageControl`, `ChipButton` | `.gemboss-ei-img` ›
|
|
934
|
+
| `EdgeBox` | `.gemboss-ei-edgebox` › four `.gemboss-ei-edge` (box + T / R / B / L), or the caller's `boxes` | `onChange(side, raw)` per keystroke, `onCommit()` on blur; Enter blurs. Boxes named "<label> top / right / bottom / left". `narrow` (default) adds `gemboss-field--narrow`; `placeholders`, `ids` per box. `boxes` (`{ key, mark, name }[]`, generic over the key): other boxes than the four sides, one for all, vertical · horizontal, top · bottom (Control UI C02); 1, 2 or 4 share the row's width. What an empty edge means is the caller's. |
|
|
935
|
+
| `ImageControl`, `ChipButton` | `.gemboss-ei-img` › 56px thumbnail (— when empty) · URL box · `.gemboss-ei-img-actions` (`actions`, then Remove while there is a value). With `onFile` (Control UI C19): `.gemboss-ei-img-info` (`-name`, `-meta`: its size in pixels) or, empty, `.gemboss-ei-img-drop`; the URL box behind "Paste a URL"; `[data-over]` while a file is over it | Commits on blur / Enter only when the box changed; Remove commits "". A dropped file goes to `onFile`, and its answered URL is committed (a refusal is said under it). The box's text can be the caller's (`draft` + `onDraftChange`) to put a picked URL in it at once. The thumbnail's `url()` is quoted (`cssUrl`, 0.20.1), so a URL with ")" or a space still shows. |
|
|
934
936
|
| `cssUrl` | | `url("…")` for any URL: quoted, `"` and `\` escaped, a control character as a CSS hex escape. Plain TypeScript (also `@gemboss/ui/editor/css-url`), so a server component can call it; `gembossUI.cssUrl` in editor-plain.js writes the same. Use it for your own image cells (the admin's library grid does). |
|
|
935
937
|
| `swatchState` | | The one rule for what `<input type="color">` can show. Also `@gemboss/ui/editor/swatch` (plain TypeScript, for node). |
|
|
936
938
|
|
|
@@ -980,7 +982,7 @@ import { EditorDrawer, LayerList, LayerTree, SortableLayerList } from "@gemboss/
|
|
|
980
982
|
| `LayerList` | `.gemboss-layers-list` › `.gemboss-layer[data-id]` (`.is-sel`) › `button.gemboss-layer-main` (`.gemboss-layer-type` · `.gemboss-layer-head`) · `.gemboss-layer-acts` | A click selects (`onSelect`; the selected button says `aria-current`). Rows are 34px, 50px with a subtitle. `empty` shows in `.gemboss-picker-empty`. `onToggleHidden`: an eye first among the actions (named "Hide <name>", `aria-pressed` = hidden, the row faded). `depth` per item indents it (`indent` px per level, default 14). Stateless. |
|
|
981
983
|
| `SortableLayerList` | the same, each row `draggable` with a `.gemboss-layer-grip` | `onMove(item, to)` (`to` = the index after the move): drag a row (faded while dragged, a 2px line where it lands), or Alt+↑ / Alt+↓ on its button (the focus stays on the moved row, also when `onMove` answers later). The drag is kept by id. Its own module (`"use client"`): a list that does not reorder does not carry it. |
|
|
982
984
|
| `LayerTree` | `ul.gemboss-ei-tree[role=tree]` › `li.gemboss-ei-tnode[role=treeitem][data-id]` (`.on`, level / position / selection) › `button.gemboss-ei-tname` (+ `small`) · `.gemboss-ei-tacts` · `below` | A click on the name calls `onSelect`; toggling it off is the caller's. Actions show on hover, on the selected row and on focus. 27px rows, 14px per level. |
|
|
983
|
-
| `EditorDrawer` | `.gemboss-picker-backdrop` + `aside.gemboss-settings` (`side="right"`, min(380px, 100%)) or `aside.gemboss-layers` (`side="left"`, 300px) › `before` · `.gemboss-picker-head` (title, ✕) · children · `.gemboss-settings-foot` (`footer`) | ✕ and the backdrop call `onClose`. Mounted while open. The body is the caller's: `.gemboss-settings-body` › `label
|
|
985
|
+
| `EditorDrawer` | `.gemboss-picker-backdrop` + `aside.gemboss-settings` (`side="right"`, min(380px, 100%)) or `aside.gemboss-layers` (`side="left"`, 300px) › `before` · `.gemboss-picker-head` (title, ✕) · children · `.gemboss-settings-foot` (`footer`) | ✕ and the backdrop call `onClose`. Mounted while open. The body is the caller's: `.gemboss-settings-body` › the kit's `Field`s (label, a `.gemboss-ei-inp` box, a `.gemboss-ei-hint` line). |
|
|
984
986
|
|
|
985
987
|
Drag to reorder is pointer only (HTML drag and drop does not start from touch); a list that must reorder on a phone
|
|
986
988
|
keeps ↑ / ↓ buttons in its `actions`, as the admin's does. Kept as the admin had them: the drawer has no Escape and
|
|
@@ -1654,7 +1656,7 @@ const list = useKeyedRows(items, (next) => save({ items: next })); // a stable
|
|
|
1654
1656
|
| Part | Markup | Behaviour |
|
|
1655
1657
|
|---|---|---|
|
|
1656
1658
|
| list | `.gemboss-ei-fld.gemboss-ei-rep` › `label` (+ `.gemboss-ei-rep-count`) · `hint` · `.gemboss-ei-rep-list` · `button.gemboss-ei-rep-add` | the count beside the name; "No items yet." (or `empty`) without rows; `canAdd={false}` turns add and duplicate off |
|
|
1657
|
-
| row | `.gemboss-ei-rep-item[data-key]` (`.is-dragging`, `data-drop=before\|after`) › `.gemboss-ei-rep-head` › `.gemboss-ei-rep-grip` · `button.gemboss-ei-rep-toggle[aria-expanded]` (`.gemboss-ei-rep-title`) · `.gemboss-ei-rep-acts` (
|
|
1659
|
+
| row | `.gemboss-ei-rep-item[data-key]` (`.is-dragging`, `data-drop=before\|after`) › `.gemboss-ei-rep-head` › `.gemboss-ei-rep-grip` · `button.gemboss-ei-rep-toggle[aria-expanded]` (`.gemboss-ei-rep-title`) · `.gemboss-ei-rep-acts` › `details.ui-menu` (one ⋯: Move up, Move down, Duplicate, Remove; Control UI C26 slice 2) | drag the grip (a 2px line where it lands, `useRowDrag`, the Layers rule); the name folds and opens the row; Alt+↑/↓ on it moves the row and keeps the focus; after Remove the focus goes to the next row's ⋯; more than one row opens folded, a row added or duplicated later opens |
|
|
1658
1660
|
| body | `.gemboss-ei-rep-body[role=group]` | drawn only while the row is open |
|
|
1659
1661
|
|
|
1660
1662
|
`useKeyedRows(value, commit)` keeps a key per row that moves, duplicates and is removed with it, so a row's open state and its
|