@gemboss/ui 0.68.0 → 0.69.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.
Files changed (48) hide show
  1. package/CHANGELOG.md +148 -5
  2. package/README.md +89 -9
  3. package/catalog/editor.html +10 -8
  4. package/catalog/index.html +617 -566
  5. package/gemboss-ui.css +3 -3
  6. package/package.json +5 -2
  7. package/parts/components.css +1 -1
  8. package/parts/core.css +1 -1
  9. package/parts/shell.css +1 -1
  10. package/src/assistant/attachments.tsx +486 -0
  11. package/src/assistant/chat-cards.tsx +343 -0
  12. package/src/assistant/chat.tsx +29 -6
  13. package/src/assistant/host.tsx +8 -11
  14. package/src/assistant/index.ts +8 -1
  15. package/src/assistant-chat.css +1 -1
  16. package/src/assistant-plain.js +1 -1
  17. package/src/assistant.css +1 -1
  18. package/src/auth-field.css +1 -1
  19. package/src/auth.tsx +4 -2
  20. package/src/chat-attachments.css +1 -0
  21. package/src/chat-cards.css +1 -0
  22. package/src/chat-plain.js +5 -5
  23. package/src/collections.tsx +8 -1
  24. package/src/editor/controls.tsx +51 -10
  25. package/src/editor/field-frame.tsx +4 -10
  26. package/src/editor/index.ts +2 -4
  27. package/src/editor/inspector-frame.tsx +143 -32
  28. package/src/editor/items-field.tsx +8 -3
  29. package/src/editor/items.ts +30 -6
  30. package/src/editor/panel.tsx +4 -5
  31. package/src/editor-inspector-frame.css +1 -1
  32. package/src/editor-media.css +1 -0
  33. package/src/editor-plain.js +1 -1
  34. package/src/editor-rail.css +1 -1
  35. package/src/editor.css +1 -1
  36. package/src/email-editor/editor.tsx +96 -69
  37. package/src/email-editor.css +1 -1
  38. package/src/gem-at-work.css +1 -1
  39. package/src/gem-at-work.ts +177 -33
  40. package/src/gem-holo.css +1 -1
  41. package/src/icons.tsx +42 -0
  42. package/src/index-table-extras.css +1 -0
  43. package/src/index-table.tsx +37 -16
  44. package/src/menu.tsx +7 -3
  45. package/src/narration.css +1 -1
  46. package/src/selection.tsx +22 -12
  47. package/src/editor/chips.tsx +0 -24
  48. package/src/editor-chips.css +0 -1
package/CHANGELOG.md CHANGED
@@ -2,7 +2,145 @@
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
- ## 0.68.0 (10/11/2026)
5
+ ## Unreleased
6
+
7
+ ## 0.69.0 (12/11/2026)
8
+
9
+ 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
10
+ from branches before their PRs merged, and their notes are in this section (`ConfirmDialog` labels, `Dialog` `dirty`, `GrowLine`,
11
+ 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
12
+ (`ChatAttachments`, `ChatDropZone`, `ChatImages`, `ChatLightbox`, #7246), the stream's parts (`ChatCard`, `ChatChoices`, `ChatDecide`,
13
+ `ChatTextChanges`, `ChatPageBands`, `ChatCta`, `ChatFeedback`, #7248), the editor's panels flush (#7256).
14
+
15
+ **What the chat stream draws beside words is the kit's: `ChatCard`, `ChatChoices`, `ChatDecide`, `ChatThing`, `ChatTextChanges`,
16
+ `ChatPageBands`, `ChatCta`, `ChatFeedback`** (11/11/2026, Chris on the UI/UX canvas, board ChatKit: one store of the chat's parts for every
17
+ service). Grown from the admin's own (ChatActions' preview and result cards, DecideThing, TurnTextChanges, ChatPageBands, the feedback row and
18
+ the choices inside GemChat), which now draw these; same `gemboss-ec-*` classes where the admin already named them, one new generic card
19
+ `gb-chat-card` (`thumb` or `icon`, `tag {label, tone}`, `title`, `meta`, `pct`, `note`, `actions`). New: a poll can end in "Something else ·
20
+ Type it below" (`other`); Copy under an answer (`ChatFeedback copyText`); a rating says which one was given (`aria-pressed`). Icons are
21
+ `<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
22
+ stream draws beside words". The editor's `.gemboss-pageedit-chip` now centres an icon in its buttons and keeps a leading icon its size.
23
+
24
+ **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
25
+ names in `<Icon>`: `expand`, `shrink`, `arrowUp`, `stop`, `mic`, `upload`, `media`, `screenshot`, `at`, `tag`, `copy`, `thumbsUp`,
26
+ `thumbsDown`, `undo`, `dot`, `circle`, `square`, `squareCheck` (`CHAT_ICON_NAMES`; `icons-plain.js` keeps the set it had, `PLAIN_ICON_NAMES`,
27
+ so GemNews' rail does not carry them: +134 B gzip measured). `AssistantHost`'s header and mini bar draw `<Icon>` (▲ is `chevronUp`).
28
+ New `ChatStepMark` / `chatStepMarkIcon`: the mark at the start of a step row, used by `ChatSteps` and the admin's NarrationTimeline (✓ ✕ ·
29
+ ✳ ❯ ⏺ ☐ ☑ were text). `ChatPending`'s heartbeat is `GemHolo` (was ✳), as the admin's; a plain page links `gem-holo.css`. `chat-plain.js`
30
+ 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)
31
+ with Chris's OK (11/11/2026). Without gem-holo.css the heartbeat is a pulsing dot (assistant-chat.css), never an empty spot.
32
+
33
+ **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
34
+ `@gemboss/ui/assistant`: `useChatAttachments` (what is attached: checked against the surface's `limits` before it is sent, uploaded with its
35
+ progress, removed, cleared), `useChatDrop` (the whole panel takes dragged files, depth counted), `ChatDropZone`, `ChatAttachments` (the tray for
36
+ 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
37
+ 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
38
+ modal). Words from `attachmentProblem` / `limitsInWords`. Icons from the set (`upload`, `close`), no text glyphs. The rules are the new entry
39
+ `chat-attachments.css` (1.9 KB gzip). First caller: the admin's GemChat.
40
+
41
+ **`IndexTable` carries a table of many columns, selection with exceptions, and a press in progress** (11/11/2026, first caller: the admin's
42
+ 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
43
+ none pickable there is no checkbox column. `bulkBusy` (and `bulkBusyLabel`, default "Working…"): every box and action is off and Escape does
44
+ not clear while a press runs, since answers arrive per row and a selection changed halfway is no longer what was pressed. `selectAllFolded`:
45
+ the folded list keeps the bar, the box and `selectAllLabel`, before anything is ticked; default off. On a column (`CollectionColumn`): `width`, a
46
+ 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
47
+ 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`
48
+ and `ui-index__until-848` say something in one shape only. `BulkBar` takes `idle: "fold"`, `busy` and `busyLabel`. The rules are the new entry
49
+ `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
50
+ 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.
51
+
52
+ **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
53
+ 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
54
+ 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
55
+ 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
56
+ `/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.
57
+
58
+ **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
59
+ a white square). One owner for the 56px picture, `Thumb` (controls.tsx), drawn by `MediaCard` (image card, video card) and the plain
60
+ `ImageControl` alike, and written the same by `editor-plain.js`: its state in `data-thumb`, the address in `--gemboss-thumb` (declared in
61
+ editor.css, whose own rule still draws the image where the new entry is not loaded). The new entry `editor-media.css` (brought by
62
+ `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;
63
+ **an image**, over a checkerboard so a white or see-through one shows its edges; **busy** (`thumbState: "busy"`: an upload, a video loop
64
+ being made), the kit's own spinner (held still under reduced motion) on grey, not on the checkerboard; **held** (media set with no
65
+ picture of its own: a video waiting on its thumbnail), the icon on grey; **broken** (`thumbState: "broken"`, or an address that does not
66
+ load, which the square finds by itself), the icon struck through. The icons are masks on `::before` (`data-glyph="video"` for a video), so
67
+ 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;
68
+ without the rule it paints one, as the empty square did.
69
+
70
+ **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
71
+ 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
72
+ 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
73
+ "Section · Home" there (or the kind in words once a section is renamed), not the section's type. The README and the catalog stop
74
+ showing a slug there.
75
+
76
+ **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
77
+ 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
78
+ (Look · Layout · Visibility · Code) and the cluster's name in capitals (the index's word again), all in one quiet size. Now one bar,
79
+ `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
80
+ 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
81
+ 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
82
+ 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.
83
+ 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
84
+ 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
85
+ 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
86
+ editor). Breaking only for a page that typed into the box without opening it: press `[data-settings-find]` first.
87
+ `editor-inspector-frame-browser.test.tsx` (Chromium: sticky, jump under the bar, focus in and back, Escape, one cluster; negatives without
88
+ the frame's sheet).
89
+
90
+ **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
91
+ 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
92
+ 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
93
+ (§9.1); they were the size of their 12px text.
94
+ Only the first is pushed to the right, so two buttons stand together instead of splitting the free room between them.
95
+
96
+ **`PanelHeader` has no grab handle** (10/11/2026). `onDragStart` (and the `.gemboss-ei-drag` / `.gemboss-ei-dragmask` rules in editor.css)
97
+ 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
98
+ repo of the fleet passes `onDragStart` to `PanelHeader` (grep 10/11/2026: gemboss, gemfactory, gemreach, gemcare, gemcommunity, gemsite,
99
+ gemtheme). Breaking only for such a caller: drop the prop.
100
+
101
+ **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
102
+ 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
103
+ boxes (an `<input>`, a `<textarea>`, `Seg` in a `Field`). It is now `PartsFrame` over `InspectorFrame` (Find a setting, the Look · Layout
104
+ index, the groups) with every control the kit's `FieldControl`: the email's Email, Inbox (Subject, Preview line, From) and Preview as;
105
+ 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
106
+ the same way (`admin/src/pages/email-editor-settings.tsx`). `.gb-emailed-form` and `.gb-emailed-area` are gone from `email-editor.css`.
107
+ `email-editor-settings.test.tsx` (14: every block kind, the email, a divider as the negative).
108
+
109
+ **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
110
+ editor's Slides, Items slice 3). `editor/items.ts`: a row's picture stored as a list (`media: [{ url, altText }, "…"]`, a slide's) is
111
+ 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
112
+ (before, the field said "kept as it is", and a write over it stored one bare address). `ItemsField` `onPickImage(id, current, put)`: the
113
+ 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
114
+ (before, a host could open its library and not say which row the picture was for). Two-argument hosts are unchanged. An image field
115
+ reads the key that holds a picture (`image: []` beside `media: [url]` reads `media`, as a reader taking the first picture does), and a
116
+ row field may be `nullish`: its older keys are read only where its own is unset (`heading ?? label`), so an emptied heading shows empty,
117
+ not the label under it.
118
+
119
+ **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
120
+ 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
121
+ subtitle like "Standard wax and special edition" ran under ✎ ↑ ↓ on prod. It is now `max-width:100%` (what touch already had), cut
122
+ 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.
123
+
124
+ **An image's URL box says what describes it: `ImageControl` `describedBy`** (10/11/2026). The box (behind an image card's "Paste a URL",
125
+ or always shown without `onFile`) carries `aria-describedby`, as a text box's does: the admin's page editor names its "Not saved: …" line
126
+ under a section's picture with it, which its raw address box did before it became the theme's image field.
127
+
128
+ **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
129
+ 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").
130
+ - `InspectorChips`, its part `@gemboss/ui/editor-chips.css` (export, parts.mjs, weight ceiling) and `InspectorFrameGroup`'s `chip`
131
+ 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,
132
+ the whole line the target (28px under a mouse, 44 under a finger). `FieldFrame` draws the look's shared groups as lines in their
133
+ fixed order. A chip pressed opened its group in the middle of a wrapped run and moved every chip after it sideways and up.
134
+ - `InspectorFrameGroup` going `add` → `added` keeps the same element where the line was (its head; the focus on its −, as before), so
135
+ 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
136
+ fades; none under reduced motion). When its rows open below the column's edge, `keepAddedInView` scrolls the frame's column (else
137
+ the page) just enough to show them, never past the group's head (`addedScrollBy`, exported with it).
138
+ - Breaking for a caller of `InspectorChips` or `chip`: the admin was the only one (ElementNodePanel, ChromePanel, TopBarElementSettings).
139
+
140
+ **`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
141
+ EditorOverflowMenu, because the kit's trigger always drew a bordered button. `ghost` adds `ui-btn--ghost` to the icon trigger and nothing
142
+ 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
143
+ 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
144
 
7
145
  **A Dialog asks before it loses work** (10/11/2026, one control set). `Dialog` `dirty`: while it is true, Escape, ✕ and a press
8
146
  on the backdrop open the kit's `ConfirmDialog` over it instead of closing ("Discard unsaved changes?" · Keep editing · Discard and
@@ -34,7 +172,11 @@ only grow-to-text.ts sizes a box to its text, field-control draws one `rows={1}`
34
172
  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
173
  negative controls.
36
174
 
37
- ## 0.67.0 (09/11/2026)
175
+ **Gem at work: a band blocked out first, then filled in** (08/11/2026, gemboss #6962).
176
+ - 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.
177
+
178
+ **Gem at work: what a check found, pinned on its blocks** (08/11/2026, gemboss #6930).
179
+ - `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
180
 
39
181
  **A question in the viewer's language, all of it** (09/11/2026; GemCommunity asks in en / vi / zh, gemcommunity #451). `ConfirmDialog`
40
182
  `retryLabel`: the refused button's words (default "Try again"), and `closeLabel`: the ✕'s name (default "Close", passed to the
@@ -386,6 +528,10 @@ Changed
386
528
 
387
529
  ## 0.65.0 (08/11/2026)
388
530
 
531
+ **Gem at work: the crew at the blocks, many hands** (08/11/2026, gemboss #6925, #6927).
532
+ - 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ị").
533
+ - 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.
534
+
389
535
  **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
536
  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
537
  (components/shell/FieldRenderer.tsx, FieldFrame.tsx, lib/held-knobs.ts, settings-frame-groups.ts, find-a-setting.ts) with their markup,
@@ -434,9 +580,6 @@ contract v1): a line by the work saying what Gem is doing, and a meter of the tu
434
580
  **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
581
  - `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
582
  - 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
583
 
441
584
  **Skill rows: `when` and a node `note`** (08/11/2026; the reviews of gemlabs #1597 and gemboss #6873 found content-radar working
442
585
  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 (sign-in screen, favicon); at 28px in a topbar it reads as a second app
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-chips | `@gemboss/ui/editor-chips.css` | `packages/ui/src/editor-chips.css` | `InspectorChips`: a run of inspector groups where one holding nothing is a chip | 0.4 KB | `InspectorChips` imports it |
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`, drag `.gemboss-ei-drag` / `.gemboss-ei-dragmask` |
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="hero-banner" actions={<PanelAction label="Duplicate section" onClick={dup}>⧉</PanelAction>} />
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); `onDragStart` adds `.gemboss-ei-drag` and takes the mouse-down of a floating panel. |
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. `chip` in an `InspectorChips` run draws the + line as a pill. What + and − write is the caller's. |
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`)