@gemboss/ui 0.68.0 → 0.70.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 +166 -5
- package/README.md +89 -9
- package/catalog/editor.html +10 -8
- package/catalog/index.html +615 -564
- package/gemboss-ui.css +3 -3
- package/package.json +6 -2
- package/parts/components.css +1 -1
- package/parts/core.css +1 -1
- package/parts/shell.css +1 -1
- package/src/assistant/attachments.tsx +486 -0
- package/src/assistant/chat-cards.tsx +343 -0
- package/src/assistant/chat.tsx +113 -16
- package/src/assistant/composer-menus.tsx +251 -0
- package/src/assistant/engine.tsx +5 -1
- package/src/assistant/host.tsx +8 -11
- package/src/assistant/index.ts +10 -1
- package/src/assistant-chat.css +1 -1
- package/src/assistant-plain.js +1 -1
- package/src/assistant.css +1 -1
- package/src/auth-field.css +1 -1
- package/src/auth.tsx +4 -2
- package/src/chat-attachments.css +1 -0
- package/src/chat-cards.css +1 -0
- package/src/chat-composer-menus.css +1 -0
- package/src/chat-composer.css +1 -1
- package/src/chat-plain.js +5 -5
- package/src/chat-voice.css +1 -1
- package/src/chat.css +1 -1
- package/src/collections.tsx +8 -1
- package/src/editor/controls.tsx +51 -10
- package/src/editor/field-frame.tsx +4 -10
- package/src/editor/index.ts +2 -4
- package/src/editor/inspector-frame.tsx +143 -32
- package/src/editor/items-field.tsx +8 -3
- package/src/editor/items.ts +30 -6
- package/src/editor/panel.tsx +4 -5
- package/src/editor-inspector-frame.css +1 -1
- package/src/editor-media.css +1 -0
- package/src/editor-plain.js +1 -1
- package/src/editor-rail.css +1 -1
- package/src/editor.css +1 -1
- package/src/email-editor/editor.tsx +96 -69
- package/src/email-editor.css +1 -1
- package/src/gem-at-work.css +1 -1
- package/src/gem-at-work.ts +177 -33
- package/src/gem-holo.css +1 -1
- package/src/icons.tsx +42 -0
- package/src/index-table-extras.css +1 -0
- package/src/index-table.tsx +37 -16
- package/src/menu.tsx +11 -4
- package/src/narration.css +1 -1
- package/src/selection.tsx +22 -12
- package/src/editor/chips.tsx +0 -24
- package/src/editor-chips.css +0 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,7 +2,163 @@
|
|
|
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
|
+
## Unreleased
|
|
6
|
+
|
|
7
|
+
## 0.70.0 (12/11/2026)
|
|
8
|
+
|
|
9
|
+
**One composer for every Gem chat: "+", ✦, the microphone, send** (11/11/2026, canvas board ChatComposer; Chris 10/11/2026: the send,
|
|
10
|
+
mic and paperclip read too big and unbalanced, many products show one "+" for the rest). `ChatComposer` takes `add` ("+": rows the host
|
|
11
|
+
gives a job, each drawn only when it has one: a file picker `onFiles`, the clipboard's picture `paste`, which is drawn only where the browser
|
|
12
|
+
can read the clipboard and says so when it holds none, or a host's own `onSelect` such as the store's Media) and `ai` (✦: `engine`, the same
|
|
13
|
+
`EnginePickerProps` the chip took, listed as "Model", one row per engine with its plan under it, and published to Settings › AI & engines as
|
|
14
|
+
the chip did; `mode`, a surface's work modes as "How far it goes"; "All AI settings…"; `locked` while a turn runs, rows readable and off with
|
|
15
|
+
the reason). Both are the kit's `Menu` (top layer, keys, outside click), drawn from the new `assistant/composer-menus.tsx` and its entry
|
|
16
|
+
`chat-composer-menus.css`. Also new: `mic` (a microphone the host drives: its own listening, or a press that opens another box listening),
|
|
17
|
+
`under` (rows between the text box and the toolbar), `sendLabel` / `sendTitle` (a send that says what it does, and why it is off),
|
|
18
|
+
`autoFocus`, the class `gemboss-ec-input--flush` (a page's own box, no panel margin). Sizes follow §9.1's two tiers: send, stop, the
|
|
19
|
+
microphone, the paperclip, "+" and ✦ are 28px under a mouse at 768 and wider and 44px under a finger or below 768 (they were 44 at every
|
|
20
|
+
pointer); the 44px mouse overlays on those buttons and on the engine chip are gone (the row is 28px tall, an overlay reached into the text).
|
|
21
|
+
The text box is 16px under a finger (iOS zoom). `leading` and `tools` draw as before, so a surface on `EnginePicker` + `ChatAttach` and
|
|
22
|
+
chat-plain.js are unchanged but for the sizes. Exports `ChatComposerAdd`, `ChatComposerAi`, `ChatAddItem`, `ChatAiChoice`,
|
|
23
|
+
`readClipboardImages`, `canReadClipboardImages`, `aiButtonName`.
|
|
24
|
+
|
|
25
|
+
## 0.69.0 (12/11/2026)
|
|
26
|
+
|
|
27
|
+
Published from `main` at this commit. It also carries what 0.67.0 (09/11) and 0.68.0 (10/11) shipped: those two were published
|
|
28
|
+
from branches before their PRs merged, and their notes are in this section (`ConfirmDialog` labels, `Dialog` `dirty`, `GrowLine`,
|
|
29
|
+
the textarea's `grow`). New since 0.68.0, among others: the chat frame's one icon set and `ChatStepMark` (#7244), files in the chat
|
|
30
|
+
(`ChatAttachments`, `ChatDropZone`, `ChatImages`, `ChatLightbox`, #7246), the stream's parts (`ChatCard`, `ChatChoices`, `ChatDecide`,
|
|
31
|
+
`ChatTextChanges`, `ChatPageBands`, `ChatCta`, `ChatFeedback`, #7248), the editor's panels flush (#7256).
|
|
32
|
+
|
|
33
|
+
**What the chat stream draws beside words is the kit's: `ChatCard`, `ChatChoices`, `ChatDecide`, `ChatThing`, `ChatTextChanges`,
|
|
34
|
+
`ChatPageBands`, `ChatCta`, `ChatFeedback`** (11/11/2026, Chris on the UI/UX canvas, board ChatKit: one store of the chat's parts for every
|
|
35
|
+
service). Grown from the admin's own (ChatActions' preview and result cards, DecideThing, TurnTextChanges, ChatPageBands, the feedback row and
|
|
36
|
+
the choices inside GemChat), which now draw these; same `gemboss-ec-*` classes where the admin already named them, one new generic card
|
|
37
|
+
`gb-chat-card` (`thumb` or `icon`, `tag {label, tone}`, `title`, `meta`, `pct`, `note`, `actions`). New: a poll can end in "Something else ·
|
|
38
|
+
Type it below" (`other`); Copy under an answer (`ChatFeedback copyText`); a rating says which one was given (`aria-pressed`). Icons are
|
|
39
|
+
`<Icon>` only (the admin drew Polaris thumbs and ✕ text). Own module and entry `chat-cards.css` (2,457 B gzip ceiling). See README "What the
|
|
40
|
+
stream draws beside words". The editor's `.gemboss-pageedit-chip` now centres an icon in its buttons and keeps a leading icon its size.
|
|
41
|
+
|
|
42
|
+
**The chat frame draws from one icon set** (11/11/2026, Chris on the UI/UX canvas board ChatKit: "đổi icon các thứ cho đồng bộ"). New
|
|
43
|
+
names in `<Icon>`: `expand`, `shrink`, `arrowUp`, `stop`, `mic`, `upload`, `media`, `screenshot`, `at`, `tag`, `copy`, `thumbsUp`,
|
|
44
|
+
`thumbsDown`, `undo`, `dot`, `circle`, `square`, `squareCheck` (`CHAT_ICON_NAMES`; `icons-plain.js` keeps the set it had, `PLAIN_ICON_NAMES`,
|
|
45
|
+
so GemNews' rail does not carry them: +134 B gzip measured). `AssistantHost`'s header and mini bar draw `<Icon>` (▲ is `chevronUp`).
|
|
46
|
+
New `ChatStepMark` / `chatStepMarkIcon`: the mark at the start of a step row, used by `ChatSteps` and the admin's NarrationTimeline (✓ ✕ ·
|
|
47
|
+
✳ ❯ ⏺ ☐ ☑ were text). `ChatPending`'s heartbeat is `GemHolo` (was ✳), as the admin's; a plain page links `gem-holo.css`. `chat-plain.js`
|
|
48
|
+
and `assistant-plain.js` draw the same SVG as the components (parity tests); their ceilings rise by what was measured (+382 B, +38 B gzip)
|
|
49
|
+
with Chris's OK (11/11/2026). Without gem-holo.css the heartbeat is a pulsing dot (assistant-chat.css), never an empty spot.
|
|
50
|
+
|
|
51
|
+
**Files in the chat** (11/11/2026, canvas board ChatKit states 2–11, Chris: "code kỹ cái khung chat … các state đó bạn hãy làm"). New in
|
|
52
|
+
`@gemboss/ui/assistant`: `useChatAttachments` (what is attached: checked against the surface's `limits` before it is sent, uploaded with its
|
|
53
|
+
progress, removed, cleared), `useChatDrop` (the whole panel takes dragged files, depth counted), `ChatDropZone`, `ChatAttachments` (the tray for
|
|
54
|
+
ChatComposer's `top`: a ring while uploading, × to remove, a card for what is not a picture, "8 of 10 · scroll for more →", refused files with
|
|
55
|
+
a red edge and one line saying why), `ChatImages` (a sent message's pictures: one, two, a grid of three with "+N") and `ChatLightbox` (a native
|
|
56
|
+
modal). Words from `attachmentProblem` / `limitsInWords`. Icons from the set (`upload`, `close`), no text glyphs. The rules are the new entry
|
|
57
|
+
`chat-attachments.css` (1.9 KB gzip). First caller: the admin's GemChat.
|
|
58
|
+
|
|
59
|
+
**`IndexTable` carries a table of many columns, selection with exceptions, and a press in progress** (11/11/2026, first caller: the admin's
|
|
60
|
+
Products list, which drew its own table). On a row, `selectable: false`: no box, and select-all and a Shift range pass over it; with rows and
|
|
61
|
+
none pickable there is no checkbox column. `bulkBusy` (and `bulkBusyLabel`, default "Working…"): every box and action is off and Escape does
|
|
62
|
+
not clear while a press runs, since answers arrive per row and a selection changed halfway is no longer what was pressed. `selectAllFolded`:
|
|
63
|
+
the folded list keeps the bar, the box and `selectAllLabel`, before anything is ticked; default off. On a column (`CollectionColumn`): `width`, a
|
|
64
|
+
number or a length and also a floor; `width: "fill"` on the primary, which takes what the others leave and cuts its title there; `wrap` now also
|
|
65
|
+
on other columns; `showFrom: 848`, left out until the table's own container is that wide. Classes `ui-index__when-table`, `ui-index__when-folded`
|
|
66
|
+
and `ui-index__until-848` say something in one shape only. `BulkBar` takes `idle: "fold"`, `busy` and `busyLabel`. The rules are the new entry
|
|
67
|
+
`index-table-extras.css` (brought by `index-table.tsx`; collections.css is at its ceiling). `index-table-browser.test.tsx` (Chromium: each prop, the six
|
|
68
|
+
widths, a negative control for each). Measured with Products' longest values: the table asked for 970px in a frame of 852 before `width`, and fits after.
|
|
69
|
+
|
|
70
|
+
**The sign-in draws the logo's gem, not the app tile** (11/11/2026, Chris on the UI/UX canvas: GemBoss had two logos, a white gem on a black
|
|
71
|
+
square on every sign-in and the line gem beside the name in the topbar). `AuthLayout`'s default `mark` is now `BrandGem`, the topbar logo's
|
|
72
|
+
own drawing, in the screen's ink, so it follows the theme. The black square stays what it is, the app's icon (`GemMark`: favicon, desktop app, the
|
|
73
|
+
Continue with GemBoss button). A surface that passes its own `mark` is unchanged. `gb-auth--alive` loses the sheen that crossed the tile: only the admin uses it, and on a dark card with no tile the band showed as a box moving over nothing. The gem stays above the title, not beside it: `/invite` and
|
|
74
|
+
`/pending` put a whole sentence in that title, which does not fit next to a mark, and the height ladder shrinks a stacked mark without moving the card.
|
|
75
|
+
|
|
76
|
+
**An image or video field's picture says its state** (10/11/2026, Chris on the UI/UX canvas: an empty field and a white image were both
|
|
77
|
+
a white square). One owner for the 56px picture, `Thumb` (controls.tsx), drawn by `MediaCard` (image card, video card) and the plain
|
|
78
|
+
`ImageControl` alike, and written the same by `editor-plain.js`: its state in `data-thumb`, the address in `--gemboss-thumb` (declared in
|
|
79
|
+
editor.css, whose own rule still draws the image where the new entry is not loaded). The new entry `editor-media.css` (brought by
|
|
80
|
+
`controls.tsx`; editor.css had no room under its ceiling) draws each: **empty**, a dashed square on the hover grey with the media's icon;
|
|
81
|
+
**an image**, over a checkerboard so a white or see-through one shows its edges; **busy** (`thumbState: "busy"`: an upload, a video loop
|
|
82
|
+
being made), the kit's own spinner (held still under reduced motion) on grey, not on the checkerboard; **held** (media set with no
|
|
83
|
+
picture of its own: a video waiting on its thumbnail), the icon on grey; **broken** (`thumbState: "broken"`, or an address that does not
|
|
84
|
+
load, which the square finds by itself), the icon struck through. The icons are masks on `::before` (`data-glyph="video"` for a video), so
|
|
85
|
+
the React and plain markup are the same and carry no SVG. Measured in Chromium: a see-through image paints the checkerboard's two colours;
|
|
86
|
+
without the rule it paints one, as the empty square did.
|
|
87
|
+
|
|
88
|
+
**A panel's name and the line under it** (10/11/2026, Chris on the UI/UX canvas: "hero-banner" sat on the name). `PanelHeader`'s name
|
|
89
|
+
is 14/20 (it was 14 on a 1.2 line), the line under it 12/16 in the panel's own font, 2px under the name (it was 11px monospace with no
|
|
90
|
+
space; its size is `--gemboss-fs-caption`). The line says what the panel edits and where, in words: the admin's theme editor now writes
|
|
91
|
+
"Section · Home" there (or the kind in words once a section is renamed), not the section's type. The README and the catalog stop
|
|
92
|
+
showing a slug there.
|
|
93
|
+
|
|
94
|
+
**The settings frame draws fewer layers: tabs, a 🔍, no second cluster name** (10/11/2026; Chris on the UI/UX canvas, threads "rối tầng
|
|
95
|
+
lớp": "bạn làm đi thấy hợp lý ntn thì làm"). Above a panel's first control, `InspectorFrame` stacked the search box, the index
|
|
96
|
+
(Look · Layout · Visibility · Code) and the cluster's name in capitals (the index's word again), all in one quiet size. Now one bar,
|
|
97
|
+
`div.gemboss-ei-bar[data-settings-bar]`, sticky at the panel's top: the index as tabs (the one the panel stands in underlined) and a 🔍 at
|
|
98
|
+
their end (`[data-settings-find]`) that opens the search box in their place, with the focus in it. Escape in an empty box, or ✕, closes it
|
|
99
|
+
and gives the focus back to the 🔍; while it holds words it stays open, and a panel that shows its results instead of its clusters keeps
|
|
100
|
+
the same box and focus. The box is always in the markup, `hidden` while closed. With one cluster there are no tabs: the bar is the box.
|
|
101
|
+
Tabs that do not fit wrap to a second line. The bar's ground reaches into the panel's side insets, so what scrolls under it never shows
|
|
102
|
+
beside it. A cluster's name is a heading for a screen reader only (the tabs say it); between clusters, room. A tab's jump lands its cluster
|
|
103
|
+
8px under the bar, as at open. Closed while the focus was in the box (also when the host's words were emptied), the focus goes to the 🔍. Every surface on the frame takes it at once (element panels, library sections, header/footer, page settings, plugins, the email
|
|
104
|
+
editor). Breaking only for a page that typed into the box without opening it: press `[data-settings-find]` first.
|
|
105
|
+
`editor-inspector-frame-browser.test.tsx` (Chromium: sticky, jump under the bar, focus in and back, Escape, one cluster; negatives without
|
|
106
|
+
the frame's sheet).
|
|
107
|
+
|
|
108
|
+
**The chat's target chip, one look in every editor** (10/11/2026, editor chrome parity). `.gemboss-pageedit-chip` is the chip over a chat's
|
|
109
|
+
message box that says what a turn acts on, which the admin's `ChatTargetChip` now draws in the page editor's chat and the theme editor's
|
|
110
|
+
alike ("Editing: Heading in Hero banner", Settings, ✕). Its buttons are 24px under a mouse and 44px under a finger and at a phone's width
|
|
111
|
+
(§9.1); they were the size of their 12px text.
|
|
112
|
+
Only the first is pushed to the right, so two buttons stand together instead of splitting the free room between them.
|
|
113
|
+
|
|
114
|
+
**`PanelHeader` has no grab handle** (10/11/2026). `onDragStart` (and the `.gemboss-ei-drag` / `.gemboss-ei-dragmask` rules in editor.css)
|
|
115
|
+
made a floating panel's head a drag handle. The admin's floating, draggable inspector was its only caller and went with gemboss #7191; no
|
|
116
|
+
repo of the fleet passes `onDragStart` to `PanelHeader` (grep 10/11/2026: gemboss, gemfactory, gemreach, gemcare, gemcommunity, gemsite,
|
|
117
|
+
gemtheme). Breaking only for such a caller: drop the prop.
|
|
118
|
+
|
|
119
|
+
**The email editor's settings are the settings frame** (10/11/2026, editor plan D5; Chris 08/11: one shell and one control set, "kể cả bên
|
|
120
|
+
GemReach cũng thế, phần email edit các thứ"). `EmailEditor`'s Settings tab, for the email and for a picked block, was a column of its own
|
|
121
|
+
boxes (an `<input>`, a `<textarea>`, `Seg` in a `Field`). It is now `PartsFrame` over `InspectorFrame` (Find a setting, the Look · Layout
|
|
122
|
+
index, the groups) with every control the kit's `FieldControl`: the email's Email, Inbox (Subject, Preview line, From) and Preview as;
|
|
123
|
+
each block's words in its group, its Align under Layout. Each key still reaches the mail at once. GemReach's own editor draws its settings
|
|
124
|
+
the same way (`admin/src/pages/email-editor-settings.tsx`). `.gb-emailed-form` and `.gb-emailed-area` are gone from `email-editor.css`.
|
|
125
|
+
`email-editor-settings.test.tsx` (14: every block kind, the email, a divider as the negative).
|
|
126
|
+
|
|
127
|
+
**The Items control edits a picture that is the first of a list, and a row's Library answers into that row** (09/11/2026; the page
|
|
128
|
+
editor's Slides, Items slice 3). `editor/items.ts`: a row's picture stored as a list (`media: [{ url, altText }, "…"]`, a slide's) is
|
|
129
|
+
editable: the first one with an address is replaced in its place, its alt text and the list's other pictures kept, emptied it comes off
|
|
130
|
+
(before, the field said "kept as it is", and a write over it stored one bare address). `ItemsField` `onPickImage(id, current, put)`: the
|
|
131
|
+
third argument writes the picture the host's library picked into the field of the row that asked, by its key, after the row moved too
|
|
132
|
+
(before, a host could open its library and not say which row the picture was for). Two-argument hosts are unchanged. An image field
|
|
133
|
+
reads the key that holds a picture (`image: []` beside `media: [url]` reads `media`, as a reader taking the first picture does), and a
|
|
134
|
+
row field may be `nullish`: its older keys are read only where its own is unset (`heading ?? label`), so an emptied heading shows empty,
|
|
135
|
+
not the label under it.
|
|
136
|
+
|
|
137
|
+
**A layer row's subtitle is cut at its row** (10/11/2026). `.gemboss-layer-head` was capped at `max-width:195px`, sized for the 300px
|
|
138
|
+
Layers drawer; under a mouse the page editor's section list (313px, a grip and five actions) leaves the row's button 129px, so a
|
|
139
|
+
subtitle like "Standard wax and special edition" ran under ✎ ↑ ↓ on prod. It is now `max-width:100%` (what touch already had), cut
|
|
140
|
+
with its ellipsis at the button's edge. `editor-layers-browser.test.tsx`: the prod row at 313px, and the 195px cap as the negative.
|
|
141
|
+
|
|
142
|
+
**An image's URL box says what describes it: `ImageControl` `describedBy`** (10/11/2026). The box (behind an image card's "Paste a URL",
|
|
143
|
+
or always shown without `onFile`) carries `aria-describedby`, as a text box's does: the admin's page editor names its "Not saved: …" line
|
|
144
|
+
under a section's picture with it, which its raw address box did before it became the theme's image field.
|
|
145
|
+
|
|
146
|
+
**The look's + groups are lines, and a group just added keeps the eye's place** (10/11/2026, Chris: Background, Size, Shadow "mỗi
|
|
147
|
+
cái là một dòng" like Sticky and Motion, "bấm vào nó thêm mà ko bị lộn xộn kiểu bị lost mất tầm nhìn của mắt").
|
|
148
|
+
- `InspectorChips`, its part `@gemboss/ui/editor-chips.css` (export, parts.mjs, weight ceiling) and `InspectorFrameGroup`'s `chip`
|
|
149
|
+
prop are removed. Every empty group, in Look as in Layout, Visibility and Code, is one full-width line: its name, a + at the right,
|
|
150
|
+
the whole line the target (28px under a mouse, 44 under a finger). `FieldFrame` draws the look's shared groups as lines in their
|
|
151
|
+
fixed order. A chip pressed opened its group in the middle of a wrapped run and moved every chip after it sideways and up.
|
|
152
|
+
- `InspectorFrameGroup` going `add` → `added` keeps the same element where the line was (its head; the focus on its −, as before), so
|
|
153
|
+
only the lines after it move, and only down. It is marked for `JUST_ADDED_MS` (1.2 s: `data-just-added`, a focus-tinted ground that
|
|
154
|
+
fades; none under reduced motion). When its rows open below the column's edge, `keepAddedInView` scrolls the frame's column (else
|
|
155
|
+
the page) just enough to show them, never past the group's head (`addedScrollBy`, exported with it).
|
|
156
|
+
- Breaking for a caller of `InspectorChips` or `chip`: the admin was the only one (ElementNodePanel, ChromePanel, TopBarElementSettings).
|
|
157
|
+
|
|
158
|
+
**`Menu` `ghost`: its trigger as a ghost button** (10/11/2026, one control set). On a toolbar of ghost buttons the ⋯ had to be the admin's own
|
|
159
|
+
EditorOverflowMenu, because the kit's trigger always drew a bordered button. `ghost` adds `ui-btn--ghost` to the icon trigger and nothing
|
|
160
|
+
else (the same name, list, keys and float); a `text` trigger (already drawn as a link) and a `select` one (a field) never take it. First user: the funnel board's step
|
|
161
|
+
toolbar (Edit page · Remove step · ⋯ · Add step), with `end` so the list's right edge stays on the ⋯ as before. `menu-ghost.test.tsx`.
|
|
6
162
|
|
|
7
163
|
**A Dialog asks before it loses work** (10/11/2026, one control set). `Dialog` `dirty`: while it is true, Escape, ✕ and a press
|
|
8
164
|
on the backdrop open the kit's `ConfirmDialog` over it instead of closing ("Discard unsaved changes?" · Keep editing · Discard and
|
|
@@ -34,7 +190,11 @@ only grow-to-text.ts sizes a box to its text, field-control draws one `rows={1}`
|
|
|
34
190
|
line, the fallback without `field-sizing`; the same message in a text box (cut at 330) and in two rows (out of sight at 280) as its
|
|
35
191
|
negative controls.
|
|
36
192
|
|
|
37
|
-
|
|
193
|
+
**Gem at work: a band blocked out first, then filled in** (08/11/2026, gemboss #6962).
|
|
194
|
+
- Each band is blocked out first as a wireframe, then filled in: boxes in their kind's colour (pictures crossed, with their size), words typed a letter at a time, extra hands named by their job and the counter as "N agents live" (Chris 08/11, after two more reels: "Dựng khung trước rồi đổ nội dung", "Gõ chữ từng ký tự", "Tác tử có tên việc"). `reveal()` now ends when the turn is skipped, as `idle()` does.
|
|
195
|
+
|
|
196
|
+
**Gem at work: what a check found, pinned on its blocks** (08/11/2026, gemboss #6930).
|
|
197
|
+
- `GemActivity.pins` and `GemPin`: what a check found, on the blocks it is about (a dot in its trade's colour and the finding), turned ✓ when a later check finds that block right (Chris 08/11: show where the problems are).
|
|
38
198
|
|
|
39
199
|
**A question in the viewer's language, all of it** (09/11/2026; GemCommunity asks in en / vi / zh, gemcommunity #451). `ConfirmDialog`
|
|
40
200
|
`retryLabel`: the refused button's words (default "Try again"), and `closeLabel`: the ✕'s name (default "Close", passed to the
|
|
@@ -386,6 +546,10 @@ Changed
|
|
|
386
546
|
|
|
387
547
|
## 0.65.0 (08/11/2026)
|
|
388
548
|
|
|
549
|
+
**Gem at work: the crew at the blocks, many hands** (08/11/2026, gemboss #6925, #6927).
|
|
550
|
+
- The crew goes over the blocks of its trade while Gem works (a curve to a block's corner, a box dragged round it), not along the edges (Chris 08/11: "lờ đờ… không còn thú vị").
|
|
551
|
+
- Sections are built by many hands at once, with a pixel ruler, guides, "+" where the next block goes and a counter of the blocks built (Chris 08/11, after the reel "AI agents build my website"). `gem-at-work.css` ceiling 1509 → 2060 B gzip, with Chris's OK.
|
|
552
|
+
|
|
389
553
|
**One control set: the schema form is the kit's** (08/11/2026; Chris: "các control phải có bộ control và kiểu có sự tái sử dụng dùng chung
|
|
390
554
|
shared component… đừng mỗi cho mỗi kiểu"). Every app draws a settings schema with the same controls: moved from the admin
|
|
391
555
|
(components/shell/FieldRenderer.tsx, FieldFrame.tsx, lib/held-knobs.ts, settings-frame-groups.ts, find-a-setting.ts) with their markup,
|
|
@@ -434,9 +598,6 @@ contract v1): a line by the work saying what Gem is doing, and a meter of the tu
|
|
|
434
598
|
**Gem at work: where the work is, the crew is** (08/11/2026; Chris 06/11: "vấn đề ở đâu nhiều thì con trỏ liên quan hoạt động nhiều hơn").
|
|
435
599
|
- `GemActivity.trades` (optional, still contract v1) and the `GemTrade` type: how much of a step's work is words, layout, pictures, buttons, the look or a check.
|
|
436
600
|
- The crew follows it: the warmest trades (cooling by half every 45 s) come beside the work ahead of the usual pair, walk more of the beats and say what they fix; still four on the page at most.
|
|
437
|
-
- The crew goes over the blocks of its trade while Gem works (a curve to a block's corner, a box dragged round it), not along the edges (Chris 08/11: "lờ đờ… không còn thú vị").
|
|
438
|
-
- Sections are built by many hands at once, with a pixel ruler, guides, "+" where the next block goes and a counter of the blocks built (Chris 08/11, after the reel "AI agents build my website"). `gem-at-work.css` ceiling 1509 → 2060 B gzip, with Chris's OK.
|
|
439
|
-
- `GemActivity.say` and `GemActivity.goal` (optional, contract v1): a line by the work saying what Gem is doing, and a meter of the turn's measured goal from where it started (Chris 08/11: "visual narration", not effects to pass the time).
|
|
440
601
|
|
|
441
602
|
**Skill rows: `when` and a node `note`** (08/11/2026; the reviews of gemlabs #1597 and gemboss #6873 found content-radar working
|
|
442
603
|
around both). `SkillFeedbackRow.when`: right after `who`, in the quiet small type (`.ui-skillfb__when`), for when a comment was left and
|
package/README.md
CHANGED
|
@@ -33,7 +33,7 @@ import { AppShell, RailItem, RailGroup, RailHeading, BrandLockup } from "@gembos
|
|
|
33
33
|
```
|
|
34
34
|
|
|
35
35
|
- The topbar brand is `BrandLockup` (the admin's: gem 20.8×26, name 13.3px/700, 40px box), never a bare
|
|
36
|
-
`GemMark`. `GemMark` is the app TILE (
|
|
36
|
+
`GemMark`. `GemMark` is the app TILE (favicon, desktop app); at 28px in a topbar it reads as a second app
|
|
37
37
|
icon (this example taught that until 0.5.0, and gemwatcher shipped it).
|
|
38
38
|
- Wrap each item in `RailGroup`: the selected pill only exists inside `.gnav-group`.
|
|
39
39
|
- `RailItem` renders `<a>`; pass `as={Link}` (Next) or `as="button"`. Every other prop is forwarded.
|
|
@@ -71,8 +71,7 @@ its CSS out of the build with it (`sideEffects`). gzip of the minified file, as
|
|
|
71
71
|
| editor | `@gemboss/ui/editor.css` | `packages/ui/src/editor.css` | the editors | 7.9 KB | the `@gemboss/ui/editor` components import it |
|
|
72
72
|
| editor-repeater | `@gemboss/ui/editor-repeater.css` | `packages/ui/src/editor-repeater.css` | `RepeaterList`: a setting that is a list, as rows | 0.9 KB | `RepeaterList` imports it |
|
|
73
73
|
| editor-tiles | `@gemboss/ui/editor-tiles.css` | `packages/ui/src/editor-tiles.css` | `ChoiceTiles`: a closed choice of shapes as picture tiles | 0.5 KB | `ChoiceTiles` imports it |
|
|
74
|
-
| editor-
|
|
75
|
-
| editor-inspector-frame | `@gemboss/ui/editor-inspector-frame.css` | `packages/ui/src/editor-inspector-frame.css` | `InspectorFrame`, `InspectorFrameGroup`: the settings frame every settings surface draws (search, the index of clusters, a cluster's name, a group open, a + line, added with a −) | 0.9 KB | `InspectorFrame` imports it |
|
|
74
|
+
| editor-inspector-frame | `@gemboss/ui/editor-inspector-frame.css` | `packages/ui/src/editor-inspector-frame.css` | `InspectorFrame`, `InspectorFrameGroup`: the settings frame every settings surface draws (search, the index of clusters, a cluster's name, a group open, a + line, added with a −) | 1.0 KB | `InspectorFrame` imports it |
|
|
76
75
|
| editor-insert | `@gemboss/ui/editor-insert.css` | `packages/ui/src/editor-insert.css` | the page editor's insert menu (the + on a picked element) | 0.6 KB | admin `InsertElementMenu` imports it |
|
|
77
76
|
| email-editor | `@gemboss/ui/email-editor.css` | `packages/ui/src/email-editor.css` | `EmailEditor` and `EmailPreview`: the email editor's column, rows, picker, checks pill and the mail itself (05/11/2026, unreleased) | 2.2 KB | `EmailEditor` / `EmailPreview` import it (with editor.css) |
|
|
78
77
|
| narration | `@gemboss/ui/narration.css` | `packages/ui/src/narration.css` | the narration timeline's own: a step that selects its section, its Undo from here, the plan card pinned at the top of a turn | 0.6 KB | admin `NarrationTimeline` imports it |
|
|
@@ -83,6 +82,7 @@ its CSS out of the build with it (`sideEffects`). gzip of the minified file, as
|
|
|
83
82
|
| assistant-engine | `@gemboss/ui/assistant-engine.css` | `packages/ui/src/assistant-engine.css` | the engine picker (chip + Settings › AI & engines) and the bridge notice | 1.9 KB | `EnginePicker` / `EngineSettings` / `BridgeNotice` import it |
|
|
84
83
|
| chat | `@gemboss/ui/chat.css` + `chat-composer.css` | `packages/ui/src/chat.css`, `packages/ui/src/chat-composer.css` | the chat body, the composer | 3.0 + 0.9 KB | the chat components (0.29.0); a page writing the markup links them |
|
|
85
84
|
| chat-voice | `@gemboss/ui/chat-voice.css` | `packages/ui/src/chat-voice.css` | the composer's microphone (`ChatComposer` `voice`) and its line over the text box (B15-voice, 08/11/2026) | 0.7 KB | `ChatComposer` imports it |
|
|
85
|
+
| chat-attachments | `@gemboss/ui/chat-attachments.css` | `packages/ui/src/chat-attachments.css` | files in the chat: the drop zone over the panel, the tray in the message box, the pictures of a sent message, one picture large (11/11/2026, unreleased) | 1.9 KB | `ChatDropZone`, `ChatAttachments`, `ChatImages`, `ChatLightbox` import it |
|
|
86
86
|
| assistant-chat | `@gemboss/ui/assistant-chat.css` | `packages/ui/src/assistant-chat.css` | the chat pieces the package draws (0.29.0): column, starters that wrap, meta, errors, notes, paperclip | 0.9 KB | `AssistantChat` and its pieces import it |
|
|
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 |
|
|
@@ -823,6 +823,67 @@ Tests: `packages/ui/src/assistant/chat.test.tsx` (markup, parser, every class st
|
|
|
823
823
|
Enter / IME, Stop in send's place, growing box, density with the mark, following the end, the turn store by id, failed
|
|
824
824
|
turns, full screen's buttons, 44px; each with its negative control).
|
|
825
825
|
|
|
826
|
+
### Files in the chat (11/11/2026, unreleased)
|
|
827
|
+
|
|
828
|
+
Canvas board ChatKit, states 2–11 (Chris 11/11/2026: "vẽ hết các trường hợp ảnh drag vào thì upload lên thì nó hiện ra ntn", then
|
|
829
|
+
"code kỹ cái khung chat"). `@gemboss/ui/assistant`, its own stylesheet entry `chat-attachments.css`.
|
|
830
|
+
|
|
831
|
+
```tsx
|
|
832
|
+
const att = useChatAttachments({ limits, upload }); // limits: { maxFiles, maxBytes, types } — what YOUR turn reads
|
|
833
|
+
const drop = useChatDrop({ enabled: true, onFiles: att.add }); // the whole panel is the target
|
|
834
|
+
<div style={{ position: "relative" }} {...drop.props}>
|
|
835
|
+
{drop.dragging && <ChatDropZone limits={limits} count={drop.count} images={drop.images} />}
|
|
836
|
+
…
|
|
837
|
+
<ChatComposer top={<ChatAttachments items={att.items} max={limits.maxFiles} note={att.note} onRemove={att.remove} onOpen={…} />}
|
|
838
|
+
canSend={!att.uploading && (text !== "" || att.ready.length > 0)} … />
|
|
839
|
+
</div>
|
|
840
|
+
// a sent message: <ChatImages images={[{ src }]} onOpen={(i) => …} />, and <ChatLightbox src onClose />
|
|
841
|
+
```
|
|
842
|
+
|
|
843
|
+
| State (board) | What draws it |
|
|
844
|
+
|---|---|
|
|
845
|
+
| 2 dragged over the panel | `ChatDropZone`: upload icon, "Drop to add to your message", `limitsInWords(limits)`, "3 images" (the browser gives types, not names, mid-drag) |
|
|
846
|
+
| 3 uploading | a ring over each thumbnail, filling with `onProgress` (turning when the upload cannot tell); "Uploading 3 images…"; the host keeps Send off while `uploading` |
|
|
847
|
+
| 4 up | × to remove (24px under a mouse, 44px on a finger), a click opens `ChatLightbox` |
|
|
848
|
+
| 5 pasted | `add(files, { label: "Screenshot" })`: a card, the picture + "Screenshot" + its name |
|
|
849
|
+
| 6 not a picture | a card with the type ("PDF") and the name; refused with `attachmentProblem` when the turn does not read it ("…is not supported yet. Use PNG, JPG, WebP or GIF.") |
|
|
850
|
+
| 7 many | the row scrolls; "8 of 10 · scroll for more →" when `maxFiles > 1` (measured: shown only while some are hidden); past the limit "10 files per message: 2 left out." |
|
|
851
|
+
| 8 refused | red edge, "Not sent", and one line saying why for each; the others still go ("It won't be sent.") |
|
|
852
|
+
| 9–10 sent | `ChatImages`: one large, two side by side, three or more in a grid of three, the sixth "+N" |
|
|
853
|
+
|
|
854
|
+
With `maxFiles: 1` a new file takes the place of the one there (a second paste replaces the first). A surface promises only what its
|
|
855
|
+
turn reads: the admin's limits are its upload route's (`lib/upload-limits.ts`: PNG/JPEG/WebP/GIF, 12 MB) and one image per message,
|
|
856
|
+
because every turn route takes one `imageUrl`. Tests: `attachments.test.tsx` (the checks and the words), `attachments-browser.test.tsx`
|
|
857
|
+
(Chromium: the tray's states, × and the lightbox, the drop zone, targets at 1280 and 390, each with its negative control).
|
|
858
|
+
|
|
859
|
+
### What the stream draws beside words: `chat-cards` (11/11/2026)
|
|
860
|
+
|
|
861
|
+
Chris on the UI/UX canvas (board ChatKit, "kho thành phần"): collect every element that appears in the chat into one store, so the
|
|
862
|
+
other places reuse them; then "code kỹ cái khung chat … update cho tất cả các service theo gemboss ui". Until then the admin drew
|
|
863
|
+
these in its own files, so no other surface could show a card, a poll or a change list the same way. They grew from that code (same
|
|
864
|
+
`gemboss-ec-*` classes where the admin's tests and gates already read them) and live in their own module and stylesheet:
|
|
865
|
+
`import { … } from "@gemboss/ui/assistant"` brings `chat-cards.css`; `@gemboss/ui/chat-cards.css` for a page that draws the classes itself.
|
|
866
|
+
|
|
867
|
+
| Board | Component | What it is | Classes |
|
|
868
|
+
|---|---|---|---|
|
|
869
|
+
| 10–12 | `ChatCard` + `ChatCardButton` | a thing the turn made or is making: `thumb` (or `icon`, a kit icon in a 40px tile), `tag: { label, tone: "answer" \| "change" \| "job" }`, `title`, `meta`, `pct` (a bar only while set; `pctLabel`), `note`, `actions`, `busy` (aria-busy) | `.gb-chat-card` (`-thumb`, `-icon`, `-body`, `-tag[data-tone]`, `-title`, `-meta`, `-bar`, `-note`, `-actions`), `.gb-chat-card-btn.is-primary` |
|
|
870
|
+
| 05, 06 | `ChatChoices` | the answer's choices: plain words are chips; any card (a `hint`, `recommended`, a `picture`, or your `rich(option)`) makes a poll in which plain words stay chips; one "Gem's pick" pill (`pickLabel`); `other` ends a poll with "Something else · Type it below" (the surface focuses its box); `pictureOf` / `hintOf` read a choice's photo and line (a product's price); `busy` turns all off | `.gemboss-ec-chips` › `.gemboss-ec-chip`; `.gemboss-ec-poll` › `.gemboss-ec-opt` (`-pic`, `-col`, `-label`, `-hint`, `-rec`, `-other`) |
|
|
871
|
+
| 07 | `ChatDecide` + `ChatThing` | the last answer's question waiting over the message box: a group named by its line, the thing it is about (picture, name, one line), the question in bold, then the choices | `.gemboss-ec-decide` (assistant-chat.css), `.gb-chat-thing` (`-pic`, `-col`, `-name`, `-meta`), `.gb-chat-question` |
|
|
872
|
+
| 14 | `ChatTextChanges` | the words a turn rewrote: `where`, the old struck (said "Was:"), the new (said "Now:") | `.gemboss-ec-textchanges` › `.gemboss-ec-textchange` (`-where`, `-was`, `-now`) |
|
|
873
|
+
| 13 | `ChatPageBands` | a page's sections as bars: one hue at the `strength` you give, "—" when not measured, an `alert` line of its own, one Open | `.gemboss-ec-pagecard` (`-head`, `-band`, `-track`, `-fill`, `-stuck`, `-open`…) |
|
|
874
|
+
| 16 | `ChatCta` | buttons that lead to the screen where the work is done; the `primary` filled with the kit's arrow, the rest outlined; `disabled` + `title` says why | `.gemboss-ec-cta` › `.gemboss-ec-cta-btn.primary` / `.ghost` |
|
|
875
|
+
| 22 | `ChatFeedback` | under a finished answer: Helpful / Not helpful (given once: that one `aria-pressed`, both off), Copy (a status says "Copied"); `onRate` absent ⇒ Copy only | `.gemboss-ec-fb` › `.gemboss-ec-fb-btn` |
|
|
876
|
+
|
|
877
|
+
Icons are the kit's `<Icon>` only (no ✕ ⌖ 👍 → text glyphs, no Polaris icons, which other services may not use). Every word has an
|
|
878
|
+
English default and a prop. Targets (§9.1): 44px under `(pointer: coarse), (max-width: 47.9975em)`, the rating row 44 wide too; under
|
|
879
|
+
a mouse the admin's sizes (rating 24, card buttons by their words, the CTA 38). Not here yet, because nothing in the fleet has the
|
|
880
|
+
data for them: a Now/After preview inside `ChatDecide`, a page-build card filling band by band, a big-number stat (the admin's metrics
|
|
881
|
+
already wear the kit's `ui-metric`).
|
|
882
|
+
|
|
883
|
+
Tests: `assistant/chat-cards.test.tsx` (markup, every class styled by the kit, no glyph, the entry shipped under a ceiling; negative
|
|
884
|
+
controls), `assistant/chat-cards-browser.test.tsx` (Chromium: a 320px panel with an unbroken word, nothing past its edge; 44px under a
|
|
885
|
+
finger; keyboard to Gem's pick, Enter; a rating once; Copy; each with its negative control).
|
|
886
|
+
|
|
826
887
|
### Plain HTML: `gembossUI.chat` (0.29.0)
|
|
827
888
|
|
|
828
889
|
`chat-plain.js`, after `kit-plain.js` (and `engine-plain.js` when the page has the picker), for a page with no React
|
|
@@ -834,9 +895,18 @@ heartbeat's clock:
|
|
|
834
895
|
```html
|
|
835
896
|
<link rel="stylesheet" href="/ui/chat.css"><link rel="stylesheet" href="/ui/chat-composer.css">
|
|
836
897
|
<link rel="stylesheet" href="/ui/assistant-chat.css"><link rel="stylesheet" href="/ui/assistant-engine.css">
|
|
898
|
+
<link rel="stylesheet" href="/ui/gem-holo.css"><!-- the heartbeat is Gem's hologram (11/11/2026); without it the spot is empty -->
|
|
837
899
|
<script src="/ui/kit-plain.js"></script><script src="/ui/engine-plain.js"></script><script src="/ui/chat-plain.js"></script>
|
|
838
900
|
```
|
|
839
901
|
|
|
902
|
+
**One icon set in the frame (11/11/2026).** Every glyph the chat draws is the GemBoss set's (`<Icon>`, icons.tsx): the header's
|
|
903
|
+
+ / full screen / ⋯ / × and the popup's shrink, the mini bar's `chevronUp` (was ▲), and the mark at the start of a step row,
|
|
904
|
+
`ChatStepMark`: done `check`, failed `close`, running or a call `dot`, a thought `sparkle`, the user's line into a running turn
|
|
905
|
+
`chevronRight`, a plan's step `square` / `squareCheck` (the admin's NarrationTimeline draws its rows with it too). Until then the
|
|
906
|
+
rows typed ✓ ✕ · ✳ ❯ ⏺ ☐ ☑ as text, each at its font's own size, and the header drew its own SVGs at 1.6 and 1.7px. The heartbeat
|
|
907
|
+
(`ChatPending`) is `GemHolo`, as the admin's has been since 25/10. The chat's icons (`CHAT_ICON_NAMES`) are not in
|
|
908
|
+
`icons-plain.js`: `chat-plain.js` and `assistant-plain.js` carry the few they draw, checked against `<Icon>` by their parity tests.
|
|
909
|
+
|
|
840
910
|
```js
|
|
841
911
|
const log = gembossUI.chat.thread(document.getElementById("ai-thread")); // role=log, follows the end
|
|
842
912
|
gembossUI.chat.render(log.el, messages, { intro, starters, onStarter, onOpenSetup: () => picker.openTab("setup"),
|
|
@@ -870,7 +940,7 @@ import "@gemboss/ui/editor.css"; // only on the screens that show an editor
|
|
|
870
940
|
| 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` |
|
|
871
941
|
| 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` |
|
|
872
942
|
| 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` |
|
|
873
|
-
| 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`), element tree `.gemboss-ei-tree › .gemboss-ei-tnode` (`-tname`, `-tacts`, `-tadd`), notes `.gemboss-ei-note`, `.gemboss-ei-oos` (`-h`), `.gemboss-ei-empty
|
|
943
|
+
| 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`), element tree `.gemboss-ei-tree › .gemboss-ei-tnode` (`-tname`, `-tacts`, `-tadd`), notes `.gemboss-ei-note`, `.gemboss-ei-oos` (`-h`), `.gemboss-ei-empty` |
|
|
874
944
|
| 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`) |
|
|
875
945
|
| 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` |
|
|
876
946
|
| 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` |
|
|
@@ -984,7 +1054,7 @@ where it is saved.
|
|
|
984
1054
|
import "@gemboss/ui/editor.css";
|
|
985
1055
|
import { ColorControl, EdgeBox, Field, ImageControl, InspectorGroup, PanelAction, PanelHeader, PanelTabs, RangeControl, Seg } from "@gemboss/ui/editor";
|
|
986
1056
|
|
|
987
|
-
<PanelHeader title="Hero" subtitle="
|
|
1057
|
+
<PanelHeader title="Hero" subtitle="Section · Home" actions={<PanelAction label="Duplicate section" onClick={dup}>⧉</PanelAction>} />
|
|
988
1058
|
<PanelTabs variant="inspector" value={tab} onChange={setTab} tabs={[{ id: "content", label: "Content" }, { id: "design", label: "Design" }]} />
|
|
989
1059
|
<InspectorGroup title="Layout" note="all screens">
|
|
990
1060
|
<Field label="Width"><Seg label="Width" value={width} onChange={setWidth} options={[{ value: "full", label: "Full" }, { value: "contained", label: "Contained" }]} /></Field>
|
|
@@ -998,12 +1068,11 @@ import { ColorControl, EdgeBox, Field, ImageControl, InspectorGroup, PanelAction
|
|
|
998
1068
|
| Component | Draws | Behaviour |
|
|
999
1069
|
|---|---|---|
|
|
1000
1070
|
| `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). |
|
|
1001
|
-
| `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)
|
|
1071
|
+
| `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) |
|
|
1002
1072
|
| `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`. |
|
|
1003
|
-
| `InspectorChips` | `.gemboss-ei-chips` › groups in their own order; a group marked `data-chip` (an `InspectorGroup`'s `attrs`, or a `.gemboss-ei-grp` line of the caller's) is its first child alone as a pill (28px, 44 under a finger, 8px apart, no chevron); the others take the whole width | Its own part, `editor-chips.css` (31/10/2026, Control UI C32 slice 3: the element panel's empty shared groups). The caller marks and unmarks a group; it stays the same element under the same parent, so a chip that opens keeps the focus. editor.css weighs a folded group's padding as the group's own (`:where(:has(…))`, (0,1,0)), so a chip's rule needs no extra weight. |
|
|
1004
1073
|
| `InspectorFrame` | `div.gemboss-ei-frame[data-settings-frame]` (display: contents) › head · `InspectorSearch` (`.gemboss-ei-find`) · `nav.gemboss-ei-index` (`data-jump` per cluster, `aria-current` on the one in view) · aside · lead · per cluster `div.gemboss-ei-cluster[data-panel-cluster]` › `.gemboss-ei-cluster-name` and its groups | The settings frame (06/11/2026, the element panel's, for every settings surface): its own part, `editor-inspector-frame.css`. A cluster with no content is neither drawn nor indexed; `results` (a search's) replace the index, the lead and the clusters. The index moves the panel's own scroller, not the page. |
|
|
1005
1074
|
| `InspectorFramePart` | `div.gemboss-ei-part[data-frame-part]` (display: contents), `hidden` while a search does not find it | A part of the panel that is not one of its groups (a section's words, its options), in its place in its cluster: a search shown in place (`InspectorFrame` `searching`) never draws it again from nothing. A static `InspectorGroup` inside the frame is drawn as the frame's open group (InspectorGroup decides it). |
|
|
1006
|
-
| `InspectorFrameGroup` | `state="open"`: `.gemboss-ei-grp[data-open-group]` › `.gemboss-ei-openhead`. `"add"`: `.gemboss-ei-grp.gemboss-ei-addline[data-add-group]` › `button.gemboss-ei-addhead` (name, `.gemboss-ei-addplus` +). `"added"`: `.gemboss-ei-grp[data-added-group]` › `.gemboss-ei-addedhead` (name, `.gemboss-ei-headacts` › acts, `button.gemboss-ei-addsign[data-remove-group]` −) and the rows | One element in the three states, so a group added stays where it was with the focus in it.
|
|
1075
|
+
| `InspectorFrameGroup` | `state="open"`: `.gemboss-ei-grp[data-open-group]` › `.gemboss-ei-openhead`. `"add"`: `.gemboss-ei-grp.gemboss-ei-addline[data-add-group]` › `button.gemboss-ei-addhead` (name, `.gemboss-ei-addplus` +). `"added"`: `.gemboss-ei-grp[data-added-group]` › `.gemboss-ei-addedhead` (name, `.gemboss-ei-headacts` › acts, `button.gemboss-ei-addsign[data-remove-group]` −) and the rows; `[data-just-added]` for `JUST_ADDED_MS` after a press of its + | One element in the three states, so a group added stays where it was with the focus in it. Added by a press of its + (not by a value an Undo or a write brings): marked a moment, and `keepAddedInView` scrolls its column just enough to show its rows, never past its head (`addedScrollBy`). What + and − write is the caller's. |
|
|
1007
1076
|
| `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. `control` (05/11/2026, unreleased): the control it holds, by the one table `LABEL_SIDE` (`labelSide`, `isFieldControlKind`): `select`, `chips`, `toggle`, `color`, `value`, `number`, `range`, `pick`, `text`, `link`, `date` put the label beside it (`.gemboss-ei-fld--row`, a row wherever it is, not only in a group); `textarea`, `list`, `edges`, `image`, `tiles`, `gradient`, `drawing`, `code` keep it above, and so do `screens` and `font-pick` until those controls are reworked. A row's notes (`.gemboss-ei-hint`, its help included) run across the field under it. `row` is deprecated (a side by hand). `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). |
|
|
1008
1077
|
| `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. |
|
|
1009
1078
|
| `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`). |
|
|
@@ -2960,7 +3029,8 @@ gem.destroy(); // the layer leaves the page
|
|
|
2960
3029
|
for 1.6 s; the crew leaves. At most four are on the page at once: Gem, the one at work, and two trades beside it walking slowly along the block's edges, off its words; the others are gone until their trade comes up. The walk stops with the turn.
|
|
2961
3030
|
- **Where the work is, the crew is.** An activity may say how much of its work is each trade (`trades: { copy, layout, image, cro, check, style }`: the fields an edit wrote, the words a check's findings use). Each trade warms by that count (at most 5 a step) and cools by half every 45 s; one warm enough comes beside the work ahead of the usual pair, takes more of the walk's beats, and says what it fixes ("Layout expert · fixing the layout"). A check, a save or a refusal that names trades changes who walks beside the work at once; QA riding its sweep counts as one of the two.
|
|
2962
3031
|
- **The story as it happens.** An activity may carry `say` (one short line of what Gem is doing there, from the step itself: "Compared with the original: 61% alike") and `goal` (`{ label, done, total, unit? }`, measured, not guessed: a clone's likeness, steps done). The line is drawn just above the work (at its top edge when the screen has no room above), the goal as a meter in the corner opposite Skip with where it started this turn ("Like the original 52% → 61%") and a bar that moves to the new value. Both stay a moment past the landing's light, then go; Skip takes them at once. A new `goal.label` starts its meter again.
|
|
2963
|
-
- **The crew at the blocks, and many hands when sections are built.** While Gem works, the two beside it go over the blocks of their trade where the work is (copy: words, image: pictures, CRO: buttons, layout and styling: frames, QA: any): along a curve to a block's corner, a box with its handles dragged round it, held, let go; their tags say what they look at. When sections are built (`reveal`), up to eight blocks go at once (`BUILD_LANES`), extra hands in their trades' colours join when the crew is busy (`HANDS_MAX`), a pixel ruler runs across the top, guides cross the screen from each dragged box, a "+" marks the next blocks, and a counter at the foot says the hands at work and the blocks built of how many. All of it goes with the build.
|
|
3032
|
+
- **The crew at the blocks, and many hands when sections are built.** While Gem works, the two beside it go over the blocks of their trade where the work is (copy: words, image: pictures, CRO: buttons, layout and styling: frames, QA: any): along a curve to a block's corner, a box with its handles dragged round it, held, let go; their tags say what they look at. When sections are built (`reveal`), up to eight blocks go at once (`BUILD_LANES`), extra hands in their trades' colours join when the crew is busy (`HANDS_MAX`), a pixel ruler runs across the top, guides cross the screen from each dragged box, a "+" marks the next blocks, and a counter at the foot says the hands at work and the blocks built of how many. In full mode each band is blocked out first, as a wireframe: every block's box dragged out in its kind's colour (frames purple, pictures blue and crossed with their size, headings yellow and words green as grey lines, buttons orange). Then the hands fill each box in, words typed a letter at a time (about 70 a second, never more than 1.1 s a block) with a caret where the next goes. Extra hands carry a job's name (Copy, Typeset, Headline, Grid, Image, Render, Crop, QA…) and the counter reads "N agents live · x / y blocks". A skip puts every word back whole. All of it goes with the build.
|
|
3033
|
+
- **Where the problems are.** An activity may carry `pins` (`{ target, say, trade?, ok? }`): each finding of a check on the block it is about, as a dot in its trade's colour by the block's top-right corner with the finding beside it (90 characters at most). A pin a later check sends `ok` for turns "✓ fixed" and goes; a pin whose block is not on the page is left out. They go with the turn, and at once on Skip. (The editor puts a comparison's pins, named by the original's `source` section, on the clone's sections.)
|
|
2964
3034
|
- **`reveal(ids?)`**: saved sections, each through **one order, overview to detail**: structure (frames that paint something), pictures, headlines, words, buttons, then QA's sweep; within a step blocks go top to bottom and left to right; Gem's tag names the step. A section taller than the screen goes a screenful at a time, each through the whole order, so the page only moves down. An expert goes to a block's corner, holds the mouse down and drags its box out; words wipe in behind a caret, a picture's box fills with tint and the picture comes up through it. Nothing is outlined ahead of the boxes (Chris 05/11: a box dragged over a box already there makes no sense).
|
|
2965
3035
|
- **Targets by stable ids only**: `[data-gem-el-id]`, then `[data-gem-section-id]`, the first match that has a box (a custom-liquid
|
|
2966
3036
|
section is a `display: contents` wrapper around an inner section with the same id; `find` replaces the lookup). **The ladder**: an
|
|
@@ -3475,6 +3545,16 @@ the admin's first load (`kit-plain-bundles.test.ts` checks the shell import carr
|
|
|
3475
3545
|
text under it wrap, a long token breaks; the other cells on one caption line,
|
|
3476
3546
|
`data-label` prefixes, `data-condensed="hide"` drops; checkbox and actions kept; rows ≥ 44); sort moves to the chips
|
|
3477
3547
|
of `ui-index__sortbar`. **A data table never folds:** it scrolls in its frame with `--sticky-first`.
|
|
3548
|
+
- **An index table with more columns than its room holds** (11/11/2026; `index-table-extras.css`, React only). Column `width` (a
|
|
3549
|
+
number or a length, the whole cell) is exact and is a floor; `wrap` on a column other than the primary lets its cells wrap inside it;
|
|
3550
|
+
`width: "fill"` on the primary takes what the others leave and cuts the title there, so the table fits however long the names are.
|
|
3551
|
+
`showFrom: 848` leaves a column out until the table's own container is that wide. A container query cannot read a variable, so a new
|
|
3552
|
+
width is a new rule. In a cell or a second line, `ui-index__when-table` and `ui-index__when-folded` say something in one shape only
|
|
3553
|
+
(a count under a header, the whole words where there is none) and `ui-index__until-848` rides until a `showFrom: 848` column shows.
|
|
3554
|
+
- **An index table's selection** (11/11/2026): `selectable: false` on a row leaves it no box, and select-all and a Shift range pass over it
|
|
3555
|
+
(with rows and none pickable, no checkbox column at all). `bulkBusy` turns every box and action off and Escape with them while a
|
|
3556
|
+
press runs, and the bar says `bulkBusyLabel` ("Working…"). `selectAllFolded` keeps the bar, the box and `selectAllLabel`, in the folded
|
|
3557
|
+
list before anything is ticked; as a table the header holds the box and the bar waits for a tick.
|
|
3478
3558
|
- **A data table reads from the top of its rows (0.16.0)**, as Polaris DataTable (`verticalAlign` "top"): one-line
|
|
3479
3559
|
cells sit on the first line of a three-line row, and a 24px cell link is pulled up by half its extra height so its
|
|
3480
3560
|
text lines up (`calc((1lh - 24px) / 2)`). The index table keeps `middle`. The row header (`th.ui-table__rowhead`)
|