@gemboss/ui 0.71.0 → 0.73.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 (75) hide show
  1. package/CHANGELOG.md +377 -2
  2. package/README.md +145 -2
  3. package/catalog/editor.html +1 -1
  4. package/catalog/index.html +3 -3
  5. package/gemboss-ui.css +4 -4
  6. package/package.json +16 -1
  7. package/parts/components.css +3 -3
  8. package/parts/core.css +1 -1
  9. package/parts/shell.css +2 -2
  10. package/src/app-nav.css +1 -1
  11. package/src/assistant/chat-cards.tsx +118 -19
  12. package/src/assistant/chat.tsx +97 -12
  13. package/src/assistant/figures.tsx +119 -0
  14. package/src/assistant/gallery.tsx +67 -0
  15. package/src/assistant/host.tsx +29 -15
  16. package/src/assistant/ideas.tsx +90 -0
  17. package/src/assistant/index.ts +8 -1
  18. package/src/assistant/plus.tsx +61 -0
  19. package/src/assistant-chat.css +1 -1
  20. package/src/assistant-figures.css +1 -0
  21. package/src/assistant-plus.css +1 -0
  22. package/src/assistant.css +1 -1
  23. package/src/board-move.ts +2 -1
  24. package/src/chat-cards-drawn.css +1 -0
  25. package/src/chat-cards-float.css +1 -0
  26. package/src/chat-cards.css +1 -1
  27. package/src/chat-composer-menus.css +1 -1
  28. package/src/chat-composer.css +1 -1
  29. package/src/chat-shortcuts.css +1 -0
  30. package/src/chat-voice.css +1 -1
  31. package/src/chat.css +1 -1
  32. package/src/chips-drawn.css +1 -0
  33. package/src/collections.tsx +4 -2
  34. package/src/dialog.css +1 -1
  35. package/src/editor/choice-cards.tsx +8 -5
  36. package/src/editor/controls.tsx +8 -5
  37. package/src/editor/field-control.tsx +8 -3
  38. package/src/editor/field-spec.ts +12 -3
  39. package/src/editor/index.ts +2 -0
  40. package/src/editor/media-words.ts +21 -0
  41. package/src/editor-empty.css +1 -1
  42. package/src/editor-media.css +1 -1
  43. package/src/editor.css +1 -1
  44. package/src/email-canvas.css +1 -0
  45. package/src/email-card.tsx +44 -0
  46. package/src/email-editor/canvas.tsx +109 -0
  47. package/src/email-editor/editor.tsx +45 -4
  48. package/src/email-editor/index.ts +2 -1
  49. package/src/email-editor/model.ts +9 -1
  50. package/src/email-parts.css +1 -0
  51. package/src/email-parts.tsx +81 -0
  52. package/src/email-thumb.css +1 -0
  53. package/src/email-thumb.tsx +206 -0
  54. package/src/flow-strip.css +1 -0
  55. package/src/flow-strip.tsx +50 -0
  56. package/src/gemboss-field-drawn.css +1 -0
  57. package/src/index.ts +11 -0
  58. package/src/kit-plain.css +1 -1
  59. package/src/kit-plain.js +1 -1
  60. package/src/list-page.tsx +6 -3
  61. package/src/media-card.css +1 -0
  62. package/src/menu-layer.ts +2 -0
  63. package/src/menu-select.css +1 -1
  64. package/src/menu.css +1 -1
  65. package/src/picture-actions.css +1 -0
  66. package/src/picture-actions.tsx +23 -0
  67. package/src/reader-dialog.css +1 -1
  68. package/src/segmented.tsx +6 -0
  69. package/src/settings-dialog.css +1 -1
  70. package/src/sheet.css +1 -1
  71. package/src/shell.css +1 -1
  72. package/src/shell.tsx +9 -2
  73. package/src/stat-tile.css +1 -0
  74. package/src/stat-tile.tsx +39 -0
  75. package/src/ui.css +1 -1
package/CHANGELOG.md CHANGED
@@ -4,6 +4,383 @@ Versions up to 0.9.0 are described in the README, each in the section that intro
4
4
 
5
5
  ## Unreleased
6
6
 
7
+ ## 0.73.0 (16/11/2026)
8
+
9
+ **Every chip in `.ui-chips` is drawn at its mouse 30 in the finger tier, toggles and phone widths included** (16/11/2026; Chris 13/11:
10
+ "vẽ 28, khối 44", then "làm đi" on the chips). 0.72.0's chips-drawn.css drew only a link chip and only under a coarse pointer: a toggle
11
+ chip (`.ui-chips > button.ui-tag--chip`, kit-plain.css: GemCommunity's member directory and access pickers) still drew its whole 44, and
12
+ a mouse at phone width (the kit's finger tier is `(pointer: coarse), (max-width: 47.9975em)`) got no drawing at all.
13
+ - `chips-drawn.css` now works in the kit's finger tier, on every `.ui-chips > .ui-tag--chip` (a link, a toggle, a static chip beside
14
+ them), and gives a link chip its 44 floor there too, as a toggle already had (ui.css floors a link only under a coarse pointer; a
15
+ surface that added the width itself, as GemCommunity's globals.css, can drop it).
16
+ - The drawing is placed `clamp(-1px, 50% - 15px, 6px)` from the padding edge instead of 6px: a 44 box draws 30, a chip nobody floored
17
+ (a static 26) draws its whole box instead of 12px less, a label on two lines keeps 7px around it.
18
+ - `chips-drawn-size-browser.test.ts` adds the toggles, a two-line label, a static chip and a mouse at 390; run on 0.72.0's rules it
19
+ fails on the toggle (`[44, null]`, drawn whole). Measured 394 B gzip; its ceiling stays 831.
20
+
21
+ **The toast's action and ✕ are 44 and 48px boxes, drawn at their desktop size** (15/11/2026; "vẽ 28, khối 44", Chris 13/11). On a
22
+ phone the admin's "Open Pages on a computer. · Send the link" toast is the way to a computer's screen; at 390 with touch its action
23
+ was 99×26 and its ✕ 24×24. In the base rules, not a finger-only block (a bigger box under a mouse draws nothing different, and a media
24
+ block cost more than `gemboss-ui.css` had left). Every number on the space scale (the typography gate refused 10 and −9): the ✕ is 48
25
+ with 12px around its chip and `margin: -12px`, so its margin box is the old 24px chip, painted in the content box, and its hover sets
26
+ `background-color` so the chip stays clipped; the action is 44 with `margin-block: -8px`, so the pill grows 2px. `toast-drawn-size-browser.test.ts`
27
+ measures it as written and through the admin's cssnano. `gemboss-ui.css` ceiling 23523 → 23540 B gzip (on node 24 as CI: main 23510, with
28
+ these rules 23530, +20 B), Chris's OK 15/11.
29
+
30
+ ## 0.72.0 (15/11/2026)
31
+
32
+ Never published: npm goes 0.71.0 → 0.73.0, which carries everything below as well. Read both sections when upgrading.
33
+
34
+ **The email editor draws the real email on its stage: `EmailCanvas`, `canvas="real"`, the brand row; products keep `layout` and
35
+ `button_style`** (15/11/2026; canvas NqQGmVzRJMjv536LLbMGaT Q1, Q2, J1 G31; gemreach #183). The editor drew the mail itself: the store's
36
+ name where the brand kit has a logo, black buttons where the brand's are green, columns without their pictures; only "As sent" was the email.
37
+ - `EmailCanvas` (`@gemboss/ui/email-editor`, its own entry `email-canvas.css`): the sender's HTML in `<iframe srcdoc sandbox="allow-same-origin">`
38
+ (no script; the same origin lets the editor read where each block stands and hear a click), each `data-gr-block` pickable, the picked
39
+ one ringed on its own box with its name and Edit · ↑ · ↓ · Delete outside it (a heading's ring never covers the logo), Desktop at 640,
40
+ Mobile at 390 in a phone's frame, Dark through the frame's colour scheme, a new build dimming the last.
41
+ - `EmailEditor` `canvas="real"` draws the stage with it under the envelope once `sent.html` is there; "As sent" then only hides the
42
+ picking. `brandRow` puts the brand kit's logo, its button colour and Edit at the top of Sections.
43
+ - `ProductsBlock` `layout` (`grid` | `card`; `list` is the default, never stored) and `button_style` (`secondary`), offered in the block's
44
+ settings (Layout · Buttons); an edit elsewhere keeps them, so a save no longer turns a grid back into a list.
45
+ - `email-canvas-browser.test.tsx` holds it in Chromium (a click picks the block and the ring is its box below the logo, a link goes
46
+ nowhere, the frame is the email's height, no script runs; negative control: a click outside every block picks nothing).
47
+
48
+ **Emails as themselves: `EmailThumb`, `EmailCard`, `PictureActions`, `ThumbCell`, `FlowStrip`, `StatTile`, `EmailParts`** (15/11/2026;
49
+ Chris approved canvas NqQGmVzRJMjv536LLbMGaT, "bám sát mà làm", and J2 Q9: real thumbnails from an iframe first). GemBoss Reach and
50
+ GemReach's Ops console drew every email as the same drawn envelope (G30, G32); the boards draw the store's real emails, and mark six
51
+ pieces "kit cần thêm". Each is its own entry, with its ceiling: email-thumb.css, picture-actions.css, flow-strip.css,
52
+ stat-tile.css, email-parts.css (README "Emails as themselves").
53
+ - `EmailThumb`: the email's HTML in `<iframe srcdoc sandbox="">`, laid out at 664px and scaled into a card (4:3), a 96×72 row or a
54
+ 56×42 one; lazy (200px before the screen, four at a time, kept per `cacheKey`), the skeleton sheen until it draws.
55
+ - `EmailCard`: MediaCard at 4:3 + EmailThumb + PictureActions. `PictureActions`: Preview · Edit · More on a light scrim on hover, a
56
+ secondary button on a picture drawn white. `ThumbCell`: a cell with a picture, a name, its context and one more line.
57
+ - `FlowStrip`: start, waits, emails and splits in a row joined by arrows. `StatTile`: label, number, one line, sparkline.
58
+ - `EmailParts`: the top and the foot of the real email beside the Email brand card (R1), the foot ringed while the address waits (R2).
59
+ - **`media-card.css` (needs Chris's OK, the core is frozen):** the media card's rules move out of kit-plain.css to their own file just
60
+ before it, same rules, same order, no new weight (as menu.css, pager.css and report-charts.css did): the admin never loads
61
+ kit-plain.css, so a `MediaCard` there had no picture frame, no 4:3 and no title link over the card. `EmailCard` imports it.
62
+
63
+ **`AppNav` speaks the rail's words** (15/11/2026; Chris 14/11 kept the plugin's own column over tabs, "khó mở rộng", and left the rest
64
+ to us; canvas https://claude.ai/artifact/Bef9bXC2ezokroNzB9rBLw, way 2). The column, its grey, its header and its foot stay. In
65
+ `app-nav.css`:
66
+ - a group's heading is drawn as the rail's "Advanced" (`rail-fold.css` `.gnav-head`): `--gemboss-fs-micro`, 600, `.02em`, muted,
67
+ the word as written, no longer in capitals at `.04em`;
68
+ - the open row keeps its white fill and ring and carries the rail's "you are here" bar (`shell.css` `.gnav-subitem.active::before`:
69
+ 3×15, `--gemboss-primary`), 4px in from its edge. Not on a phone, where the open row is already a filled chip.
70
+ - `app-nav.test.tsx` holds both to the rail's own rules. `packages/ui/src/app-nav.css` stays under its ceiling (1.8 of 2.2 KB gzip).
71
+
72
+ **`consumeEscape` is exported** (14/11/2026, gemboss #7567). The kit's own layers already used it (Dialog, Popover, the pickers): it
73
+ stops an Escape's keydown AND the keyup after it, because a Polaris Modal closes on the keyup. The admin's update box, now frosted
74
+ whenever it is up, takes Escape at the window and needed the same, so a Polaris Modal behind its grey does not close with it.
75
+
76
+ **`AssistantChat` takes `shortPlaceholder`** (14/11/2026) and hands it to `ChatComposer`, which swaps to it when the full placeholder
77
+ does not fit the field (a ✦ or a chip in the lead takes room) and goes to two rows when even that does not. Found rolling 0.71.0 into
78
+ gemreach: its line was cut ("…reset khô") at every width, 130–275 px of field under a 307–367 px line. `chat-plain.js` already did this.
79
+
80
+ **A segmented control under a thumb is drawn at its desktop size, in 44px boxes** (14/11/2026; Chris 13/11: "vẽ 28, khối 44",
81
+ the control after the button). Measured on production at 390 with touch: groups were 46 tall.
82
+ - `ui.css`: under `(pointer: coarse), (max-width: 47.9975em)` each segment keeps its 44px box; the group's line is its `::before`, 28
83
+ tall in its middle, and a segment's fill, divider and picked line are the segment's `::before` at its declared height (26),
84
+ inheriting what the cascade gives the segment (hover, picked, a surface's colours). The group no longer clips (`overflow:
85
+ visible`); a picked segment is rounded on its own. Its clip is `!important`, as the button's: the picked and hovered rules set
86
+ `background` with the shorthand.
87
+ - ON UPGRADE: a surface whose segmented group WRAPS into rows draws a grid, not a 28 line: opt it out as the admin's link picker
88
+ does (gemboss-shell.css: group `overflow: clip; border-image: none`, both `::before` `content: none`, its segments' clip and
89
+ border-image back with `!important`). A segment that sets its own `height` (the editor's device switch, 44) is drawn at it.
90
+ - `segmented-drawn-size-browser.test.ts` reads it off the pixels (icons, words, links, the screen switch, the studio bar's 26 boxes,
91
+ the link picker's wrapped tabs), from the source and as next build minifies it, with its negative control.
92
+ - weight-budget.json: each ceiling moves by what this block adds, measured against main without it, so its slack is kept:
93
+ `gemboss-ui.css` 23,234 → 23,364 B gzip (+130), `parts/components.css` 8,889 → 9,017 (+122, and +6 for the outline fix, #7536),
94
+ `packages/ui/src/ui.css` 4,703 → 4,834 (+125, and +6 for #7536). Same reason as the button's: Chris chose this way knowing it adds CSS.
95
+
96
+ **Questions to try, at the end of a conversation** (13/11/2026, Chris: "a button that always suggests five more questions, so sellers
97
+ discover more"). On a phone the admin is Gem's chat, so asking is how a seller finds what is there.
98
+ - `ChatIdeasChip`: "Suggest questions", a 28px pill in the shape of Research's (44px under a finger), never gold. `aria-expanded`,
99
+ `aria-controls` when the tray is on the page.
100
+ - `ChatIdeasTray`: "Try asking", the chat's own chips (`.gemboss-ec-chip`, 44px always; a press is the surface's to send), "5 more" and a
101
+ close (both 44px under a finger). The surface owns the questions and what it has shown.
102
+ - Not in ChatComposer's strip: measured at 390 under a finger, "+", ✦, Research, the microphone and send leave 33px, and a chip there
103
+ was cut under the microphone. Styles in chat-composer-menus.css, which every Gem chat already loads.
104
+
105
+ **One vocabulary for picking a picture or a video** (13–14/11/2026, Chris on a library section's Video field: "chưa đúng chuẩn control";
106
+ gemboss #7449, #7483). New CSS-free entry `@gemboss/ui/editor/media-words` (re-exported by `@gemboss/ui/editor`):
107
+ - `MEDIA_PASTE_LABEL` ("Paste a URL"), now the default of MediaCard's `pasteLabel` (optional); `ImageControl` passes none.
108
+ - `mediaPickLabel(glyph, holds)`: a card's chip, "Select image" / "Select video", "Replace" once it holds media.
109
+ - `mediaActionLabel(glyph, holds)`: where the media is named (a menu row, a dialog's title), "Select image" / "Replace image".
110
+ editor-media.css: a broken VIDEO thumb is the video's icon struck through (`[data-thumb=broken][data-glyph=video]`); the broken rule set the
111
+ image's struck icon on every card. editor.css: `.gemboss-ei-hint--error`, a field's error line in the error tone (`--gemboss-danger-strong`,
112
+ EdField's error state); by class, not `[role=alert]` (some alert hints are notices, and a standing problem is no alert).
113
+
114
+ **The words typed in the composer take the panel's colour** (13/11/2026, Chris: "khi chuyển sang màu đen thì cái input text chữ nó ko
115
+ thành màu trắng"). chat.css `.gemboss-ec-input textarea` sets `color: inherit`: a textarea does not inherit colour (the browser gives it
116
+ `fieldtext`), so on Gem Plus's black Research panel the words were drawn rgb(0, 0, 0) on #17140f. Measured in Chromium: black panel
117
+ rgb(0, 0, 0) → rgb(242, 236, 223); the gold and the plain panels draw them in their text colour (rgb(48, 48, 48)) instead of pure black.
118
+ `font: inherit` replaces `font-family: inherit` (the size and line height are set after it): the words typed take the panel's weight,
119
+ 450 like every line of the conversation, where the textarea alone was 400; and the rule stays inside the frozen bundle's ceiling.
120
+
121
+ **Full screen wears Gem Plus's look** (13/11/2026, Chris: "giao diện chat khi chuyển sang full nó ko toàn bộ đen theo … hoặc vàng").
122
+ assistant-plus.css: `.gb-dock--plus` and `.gb-dock--gold` restate `--gemboss-app-bg`, the colour `.gb-dock-full` paints. Measured in
123
+ Chromium, full screen: rgb(255, 255, 255) → rgb(20, 18, 14) black, rgb(255, 252, 245) gold.
124
+
125
+ **The Research chip sits beside send, and the words keep their row** (13/11/2026, Chris: "cái research đẹp nhưng hơi tốn không gian của
126
+ input, có lẽ nó nên nằm về bên phải cạnh nút enter", then "làm đi").
127
+ - `ChatPlusChip` goes in ChatComposer `tools` (on the right, before the microphone and send), out of `leading`.
128
+ - **ChatComposer marks `stacked`** with `data-stacked` on its box, so a gate reading the box tells two rows on purpose from a box that
129
+ wrapped. The admin's Assistant stacks its box, one line tall while empty: the words take the box's whole width (357px in a 400px
130
+ panel, against 90–135px beside the chip), the toolbar under them ("+", ✦ on the left; the chip, the microphone and send on the right).
131
+
132
+ **The page behind a popup is frosted** (13/11/2026, Chris: "the design system has a frosted glass background under an overlay").
133
+ - `dialog.ui-modal::backdrop` (`Dialog`, `ConfirmDialog`, `FeedbackDialog`, the portal's search; `dialog.css` and `kit-plain.css`) and
134
+ `.ui-overlay` (`openModal`, `ui.css`) draw the ink at .22 under the kit's frost, `blur(14px) saturate(1.4)`. They were black .5
135
+ with no blur (0.7.3, Polaris's number).
136
+ - Two shapes keep a plain scrim and turn the frost off by name: the side panel, `Sheet` (`rgba(0,0,0,.3)`, as before), and the
137
+ popup the size of a screen, `ReaderDialog` and `SettingsDialog` (`rgba(0,0,0,.5)`, as before).
138
+ - ON UPGRADE: a surface's own popup on `dialog.ui-modal` or in `.ui-overlay` (`openModal`) gets the frost. One that is a side panel
139
+ or the size of a screen turns it off in its own sheet (`backdrop-filter: none`, prefixed too; for `openModal`, on its
140
+ `overlayClass`); a dark surface keeps a darker fill there. README "What lies behind a popup" has the table, the two snippets and
141
+ the tests that hold it.
142
+ - weight-budget.json: the frozen bundle `gemboss-ui.css` 22,949 → 22,987 B gzip (+38, nearly all of it the frost's text standing
143
+ once in `ui.css` for the overlay; with the dialog's rule alone it measured +3). Every other file is inside its ceiling. Chris's
144
+ OK, 13/11/2026 ("bạn quyết cho tôi", asked with the number).
145
+
146
+ **ChatComposer decides one row or two again when a web font lands** (13/11/2026, gemboss #7382: the admin's composer gate red at 1366,
147
+ "an empty box with room for its words is two rows", twice in three runs).
148
+ - `packages/ui/src/assistant/chat.tsx`: the rows and the density listen to `document.fonts` `loadingdone` (and `ready`). The lead's
149
+ chips and the short placeholder were measured in the fallback font (DejaVu on Linux, wider than Inter); a box that chose two rows kept
150
+ them once Inter left room for one, since nothing it watched changed size on two rows. Test:
151
+ `packages/ui/src/assistant/composer-rows-browser.test.tsx` (a font stood in by a stylesheet; red without the listener).
152
+ - Not in `packages/ui/src/chat-plain.js` yet: it has the same gap, and it sits at its weight ceiling to the byte (the smallest fix is
153
+ +2 B gzip).
154
+
155
+ **An outlined button keeps its outline under a thumb, as the admin ships it** (14/11/2026, fix of the entry below). next build's
156
+ minifier (cssnano-simple) merged `::before`'s three border longhands into `border: inherit`, which also inherits the button's empty
157
+ `border-image`: on production every outlined kit button ("Start a funnel" on Home at 390) drew no outline on a phone. `::before`
158
+ now declares `border-image: none` after them, which survives the merge.
159
+ - ON UPGRADE: nothing to do.
160
+ - `button-drawn-size-browser.test.ts` now also reads the file as next build minifies it, with a negative control (the minified rule
161
+ without `border-image: none` draws no outline). The source alone passed while production was broken.
162
+
163
+ **A button under a thumb is drawn at its desktop size, in its 44px box** (14/11/2026; Chris 13/11: "các control trên mobile cũng
164
+ phải chuẩn như trên desktop… nó bị to hơn", then, of two ways, "vẽ 28, khối 44").
165
+ - `ui.css`: under `(pointer: coarse), (max-width: 47.9975em)` a `.ui-btn` keeps its 44px box (the floors are unchanged: the target
166
+ is the button, and two buttons never share one), but its fill, border and corners are drawn by `::before` at the size the button
167
+ declares (`width`/`height`: 28, or 32 where the admin sets 32), centred. The button's own fill is clipped to its words and its
168
+ border is an empty `border-image`; `::before` inherits both, so variants, hover, ON and a surface's override follow by themselves.
169
+ - ON UPGRADE: nothing to do. A surface that draws its own `::before` on a `.ui-btn` loses it under a thumb (none in the fleet,
170
+ 14/11/2026). A `.ui-btn` on `<input>` would lose its fill there: use `<button>`.
171
+ - `button-drawn-size-browser.test.ts` reads it off the pixels in Chromium (a finger at 1366, a mouse at 390, a mouse at 1366
172
+ unchanged) with its negative control; seen the same in WebKit.
173
+ - weight-budget.json: `gemboss-ui.css` 23,038 → 23,154 B gzip (+116, the rule itself). Chris chose this way knowing it adds CSS;
174
+ the ceiling moves by what it measured.
175
+
176
+ **The account chip under a thumb is drawn at its desktop 32, in its 44px box** (14/11/2026, the next control of the entry above).
177
+ Measured on production at 390 with touch: the top bar's account circle was a 44px circle with its line, the one control of the
178
+ phone bar drawn bigger than on a desktop.
179
+ - `shell.css`: where the chip is a 44 box (`(pointer: coarse)`, and 306–460px), `::before` draws its 32 circle, inheriting its fill
180
+ and line so hover and the open menu follow; the chip paints its fill only under its letters and its line as an empty
181
+ `border-image`. `border-image: none` on `::before` survives next build's minifier (the outline fix, gemboss #7536).
182
+ - The admin's own top bar Gem door (`gb-tb-btn`, apps/admin gemboss-shell.css) declares 32 on a phone, so the kit draws it lit and
183
+ pressed at 32, not 44.
184
+ - `top-bar-drawn-size-browser.test.ts` reads both off the pixels, from the source and as next build minifies it, with a negative
185
+ control (the rules as they were draw the whole 44).
186
+ - weight-budget.json: `gemboss-ui.css` 23,154 → 23,234 B gzip (+80: this rule +74, and the outline fix +6, measured together so the
187
+ two do not turn main red once both land). Same reason as the entry above: Chris chose this way knowing it adds CSS.
188
+
189
+ **The chat's own controls under a thumb are drawn at their mouse 28, in 44px boxes** (14/11/2026; Chris 13/11: "vẽ 28, khối 44",
190
+ the controls after the button, the top bar and segmented). Measured on production at 390 with touch: New chat, Talk to a person,
191
+ ⋯, "+", Suggest questions and Send were drawn 44 (desktop 28).
192
+ - `chat.css`: under `(pointer: coarse), (max-width: 47.9975em)` the dock's `.gb-dock-shrink` and full-screen New chat, Send, Stop,
193
+ the paperclip, the mic and Suggest questions keep a 44px box; their fill, line and corners are their `::before` at the size they
194
+ declare (28), inheriting what the cascade gives them. Their touch rules (`assistant.css`, `chat-composer.css`,
195
+ `assistant-chat.css`, `chat-voice.css`, `chat-composer-menus.css`) keep the 28 declared and put 44 in the minimums; the bigger
196
+ touch glyphs and words went with it (drawn as under a mouse). "+" and ✦ are kit buttons (ui.css draws them); the box-shadow
197
+ hairline of "+" and of Suggest questions moves to the drawing; the mic's listening ring is 28.
198
+ - ON UPGRADE: a surface that sized one of these controls to 44 itself under a thumb is drawn at that 44: declare the mouse size and
199
+ 44 in the minimums instead.
200
+ - `chat-drawn-size-browser.test.ts` reads it off the pixels (390 with a mouse, the composer under a finger at 1366), from the
201
+ source and as next build minifies it, with its negative control. Research's pill (assistant-plus.css) follows once #7526 lands.
202
+ - weight-budget.json: `gemboss-ui.css` 23,364 → 23,523 B gzip (+159, what this adds, measured against main without it, so its
203
+ slack is kept). `packages/ui/src/chat.css` grows 207 B inside its own ceiling. Same reason as the button's: Chris chose this way
204
+ knowing it adds CSS.
205
+
206
+ **`RailCount` takes `dot`** (13/11/2026, Chris: "ở home chỉ là dấu chấm… inbox mới hiển thị số… để nhìn ko bị overlap duplicate").
207
+ - The folded rail's 8px dot in the full rail too, its count read as its label. For a row whose number is on the sub-row that opens
208
+ it: the admin's Home shows a dot for what needs the seller, Home › Inbox the number.
209
+
210
+ **Gem Plus's mode is Research; AssistantHost `gold`** (13/11/2026, Chris: "một mode là research bật lên là nó thành màu đen", "bản
211
+ growth là ai assistant dát vàng rồi").
212
+ - `ChatPlusChip` says Research (`CHAT_PLUS_LABELS`) with a magnifier.
213
+ - `AssistantHost gold`: `gb-dock--gold`, the plan's chat while Research is off: an ivory ground, a gold rule under the header, gold
214
+ accents and primary button (text accent #8f6514, AA on white), the seller's bubble cream, the Research chip outlined in gold. `plus`
215
+ wins over it. In `packages/ui/src/assistant-plus.css`, within its ceiling.
216
+
217
+ **Gem Plus: `ChatPlusChip` and AssistantHost `plus`** (13/11/2026, Chris on the Gem Plus boards, artifact DmPeQEJDAZXdiTxzmFv5UL: "đúng
218
+ chính xác rồi làm đi"; gemboss: the Assistant's composer and panel).
219
+ - `ChatPlusChip` (`@gemboss/ui/assistant`): Plus in the composer's chip strip, `locked` / `off` / `on`; locked is a door to the
220
+ surface's dialog, off / on a switch. `CHAT_PLUS_LABELS` are its words.
221
+ - `AssistantHost plus`: `gb-dock--plus` on the panel, the Plus look (obsidian and gold) by restating the chat's tokens.
222
+ - A new entry, `assistant-plus.css` (scripts/parts.mjs ENTRIES, export `./assistant-plus.css`), imported by plus.tsx and host.tsx;
223
+ weight-budget.json: `packages/ui/src/assistant-plus.css` 1578 B gzip (measured 1066 + 512 slack), a new component's own ceiling.
224
+
225
+ **`ChatComposerProps.stacked`: a box that is always two rows** (13/11/2026, gemboss New: "describe what I want" on top of New, "cao 2
226
+ dòng cho input cho sướng"). The text over the toolbar whatever the words' length, so an empty box shows its whole placeholder and does
227
+ not grow a row on the first wrap; nothing is measured for it. Off by default: every chat keeps one row while its words fit.
228
+ - Its text box is two lines tall unless `rows` says otherwise (`rows ?? (stacked ? 2 : 1)`), and changing `stacked` lays the box out
229
+ again.
230
+ - With an empty lead (no "+", no chips) it stands beside send as every bare box does, still two lines tall: no surface draws one,
231
+ and a CSS rule to put it over the toolbar pushed the admin dashboard's first load over its budget (gemboss #7380).
232
+ - chat-plain.js has no `stacked` yet: no plain caller needs one, and its 24 B would pass chat-plain.js's 9645 B ceiling.
233
+
234
+ **editor.css drops the theme editor's page picker trigger** (14/11/2026, gemboss #7504: the admin's theme editor is the try door's, its
235
+ seller's bar and PagePicker gone). `.gemboss-pagepicker`, `.gemboss-pagepicker > .gemboss-pagepicker-trigger`, its picture rules and its
236
+ 44px touch rule are removed; nothing draws them (the admin's `a-tap-target-rule-outlived-its-markup` caught the touch rule). The note
237
+ (`.gemboss-pagepicker-note`, `-note-link`) stays: the canvas's product picker draws it. ON UPGRADE: nothing, unless a surface drew its own
238
+ `.gemboss-pagepicker-trigger`.
239
+
240
+ **AssistantHost: full screen with no way back** (13/11/2026, Gems/CLAUDE.md §16, Chris: on a phone or a tablet the admin "chỉ có giao
241
+ diện chính là chat thôi").
242
+ - `onShrink` is optional. Absent, full screen draws no "Shrink to popup" (or "Back to the side panel") button, the small screen's ⋯
243
+ has no such row, and the ⋯ itself is not drawn when nothing else is in it. Every host that passes it today is unchanged.
244
+
245
+ **A menu's list is as wide as its rows** (13/11/2026, the Inbox's filter: "bóp nhỏ vào theo tiêu chuẩn nào đó … nhìn thưa rời rạc").
246
+ - menu-select.css: the list had a 280px floor for every select, so the Inbox's five one-word filters opened 280 wide from a 63px field.
247
+ It is now as wide as its longest row (as Polaris draws a Popover: no floor), never narrower than its field (a browser's own select
248
+ list), at most 420 unless the field is wider, never wider than the screen less its 8px edges. Rows with a line under their words
249
+ (MenuItem `description`: New moment, Who sees what) keep the 280 column.
250
+ - menu.css: a ⋯ menu's list is as wide as its longest row (it had a 220px floor, a "Mark all read" alone in a 220px box). Polaris
251
+ sets no floor. The core loses the declaration (gemboss-ui.css sits at its ceiling; a 112 floor gzipped 4 B over it).
252
+ - menu-layer.ts `floatMenu` and kit-plain.js set `--ui-menu-trigger` (the trigger's width) on every list they float: in the top layer
253
+ the list is fixed, and `100%` would be the screen's width. menu-select.css is the one reader today.
254
+
255
+ **ChatComposer decides its rows again when a stylesheet lands** (13/11/2026). A CSS chunk that loads after the box first measured (the
256
+ admin's Assistant in a production build) left it without the one-row rules (assistant-chat.css `[data-rows="1"]`): the toolbar sat under
257
+ the text, the box chose two rows with room for one, and nothing it watches changed when the rules arrived. The admin's composer gate read
258
+ it as "an empty box with room for its words is two rows" on six PRs from 13/11 13:44 UTC, the first 14 minutes after #7382 merged. Now
259
+ a `load` of a `<link rel="stylesheet">` (caught on capture) refits the rows and steps the chips' density again, as a web font's
260
+ `loadingdone` does. Reproduced in a rig that served those rules 1.2 s
261
+ late: two rows 12/12 before, one row 12/12 after; `composer-rows-browser.test.tsx` holds it, red without the listener.
262
+
263
+ **`ChatFigures`: figures under a chat answer** (13/11/2026, Gem Plus slice 2; boards artifact DmPeQEJDAZXdiTxzmFv5UL).
264
+ - `ChatFigures`, `CHAT_FIGURES_LABELS`, `figurePct` (`@gemboss/ui/assistant`): shares drawn under an answer as `ui-metrics` tiles and
265
+ `ui-barlist` rows (a compared row: the group's share as the bar, everyone's beside it), a caption per figure (what it measures, its
266
+ base as a floor), the source line.
267
+ - A new entry, `assistant-figures.css` (scripts/parts.mjs ENTRIES, export `./assistant-figures.css`), imported by figures.tsx after
268
+ report-charts.css; weight-budget.json: `packages/ui/src/assistant-figures.css` 764 B gzip (measured 252 + 512 slack).
269
+
270
+ **`ChatPageGallery`: real pages under a chat answer** (13/11/2026, Gem Plus slice 3).
271
+ - `ChatPageGallery`, `CHAT_GALLERY_LABELS` (`@gemboss/ui/assistant`): two to a row, picture (4:5, its top), label, line, and a real
272
+ link "Use this layout" (`onUse(href)` on a plain press). Its frame joins `assistant-figures.css` (parts.mjs `by` gains gallery.tsx):
273
+ 252 → 454 B gzip, under its 764 B ceiling.
274
+
275
+ **ChatComposer `shortcuts`: "/" lists questions** (13/11/2026, Gem Plus slice 4; board C3 "Gõ / ra lối tắt").
276
+ - `shortcuts` (`ChatShortcut`: label, prompt, sub) and `shortcutsLabel`: a "/" at the start of the box lists them over the text box
277
+ (a row of its own, as the note above), filtered by every word after the slash, six at most; ↑/↓ move, Enter or Tab (or a press)
278
+ put the question in the box to edit or send, Escape closes the list at that text. `aria-autocomplete="list"`, the list a listbox
279
+ the text box points at (`aria-controls`, `aria-activedescendant`). `shortcutMatches` is the filter. Absent: "/" is a character.
280
+ - A new entry, `chat-shortcuts.css` (parts.mjs ENTRIES, export `./chat-shortcuts.css`), imported by chat.tsx: the list's rules, out of
281
+ chat-composer-menus.css, which "Suggest questions" (#7459) brought to its 1288 B ceiling; weight-budget.json 891 B (measured + slack).
282
+ A row is 44px under a finger.
283
+
284
+ **Board: a card can be `fixed`** (BoardCard, 14/11/2026, Operator › Tasks: a running job beside the seller's ideas).
285
+ - It is drawn without the drag and the keyboard pick-up while its neighbours keep both, and the board's drag never lifts a card that
286
+ is not draggable (a link inside it is, by default). src/board-fixed.test.tsx.
287
+
288
+ **"Gem is waiting on you" stands out, says how it is answered, and takes several picks** (14/11/2026, Chris: "nên có màu khác … để nó
289
+ nổi lên trên cái chat này … vẫn thẩm mỹ và theo design system"; "các lựa chọn luôn phải có Something else"; one answer is a radio,
290
+ several are tick boxes, and a tick can come with words of one's own).
291
+ - `.gemboss-ec-decide` is Gem's iris instead of white with a gold line: `accent-wash` ground, `accent-tint` edge, QuestionCard's 3px
292
+ `accent-soft` ring; its line `accent-strong` after an iris dot. A question is not a warning, so the warning gold is gone. No motion.
293
+ - `ChatDecide` takes `how` ("Pick one", "Pick any"), drawn after the line, quieter, outside the group's name.
294
+ - `ChatChoices` takes `pick: "one" | "many"`. "one": a round mark on every row of a poll (a chip among the cards becomes a row), a press
295
+ answers as before. "many" with `onSend(picked, other)`: real check boxes behind their rows, Something else a tick whose row opens a
296
+ `gemboss-field`, a count and Send (`sendLabel`, `pickedLabel`); Enter in the field sends; a new question starts unticked.
297
+ - `other` (Something else) is now drawn on a chip row too, as its last chip (`.gemboss-ec-chip-other`, dashed), not on polls only.
298
+ - A choice's label wraps an unbroken word (`overflow-wrap: anywhere`): a product title or URL pushed a 320px panel sideways.
299
+ - Several picks answer once per question (a double press, or Enter then Send, before the surface turns busy sends nothing more), and a
300
+ press on Something else's caption unticks it without hiding the words typed there (typing ticks it again).
301
+ - The box's whole look moved to ChatDecide's own sheet, `chat-cards.css` (one owner, CLAUDE.md §9.3); `assistant-chat.css` keeps only
302
+ where it sits against the message box. A surface that re-themes the accent (Growth's gold panel) re-themes the box with it.
303
+ - Weight: `chat-cards.css` 2.4 of its 2.4 KB ceiling, `assistant-chat.css` 1.3 of 1.4 KB. No ceiling raised.
304
+
305
+ **A switch with nothing chosen marks the option the page draws** (14/11/2026, editor standard layer 5: an empty field says what the
306
+ page draws; an element's Letter case is two chips, None · AA, with no box to say it in). `SegmentedOption.drawn` / `SegOption.drawn`:
307
+ not pressed, that chip wears the empty field's face, a dashed ring inside it in `--ui-text-muted` (editor-empty.css `.ui-seg>[data-drawn]`),
308
+ and says "Not set: what the page draws now" (`aria-description`), as an empty list says the drawn value greyed. `FieldSpec` segmented
309
+ takes `drawn` (the option's value); FieldControl marks it only while nothing is stored, and a value the chips do not offer marks none.
310
+
311
+ **`.gemboss-page-draft-status` removed from editor.css** (14/11/2026). The admin's page opening (PageOpening) was the last markup
312
+ carrying it; it now draws the canvas's board, where every way into a page lands (gemboss, New opens on the canvas). No other repo used it.
313
+
314
+ **Gem Plus is the plan, not a mode: one Plus look, a chip that says Plus** (14/11/2026, Chris: "giao diện vàng là được rồi còn ko cần
315
+ phải bật tắt research mode, đổi cái label research đó thành Plus", then "merge cái màu đen với cái màu vàng làm một… và phân biệt với
316
+ cái màu trắng (chưa upgrade)").
317
+ - `ChatPlusChip`: named **Plus**, two states, `locked` (a lock) and `on` (gold); `off` is gone. A press opens what Plus is in both
318
+ (`aria-haspopup="dialog"`), it switches nothing (no `aria-pressed`). `CHAT_PLUS_LABELS` is `{ name, locked, on }`; the icon is ✦.
319
+ - `AssistantHost`: `gold` is gone with the ivory gold panel (`.gb-dock--gold`); `plus` is the one Plus look, obsidian and gold, for a
320
+ store whose plan has it. A store without it keeps the white panel. assistant-plus.css: 1.1 KB gzip, smaller.
321
+
322
+ **The Plus chip under a thumb is drawn at its mouse 28, in its 44px box** (15/11/2026; Chris 13/11: "vẽ 28, khối 44", the composer's
323
+ last control drawn 44: measured on production at 390 with touch, after the chat's own controls went to 28).
324
+ - `packages/ui/src/assistant-plus.css`: under `(pointer: coarse), (max-width: 47.9975em)` the chip keeps its declared 28, its mouse
325
+ padding and its 12px words, and puts 44 in its minimum; its fill is clipped to its words and its ring dropped, and its `::before`,
326
+ at the declared 28, inherits the fill (locked white, the gold, either hover) and wears the ring of its state (the hairline locked,
327
+ the gold line and glow on). As Suggest questions beside it is drawn; here because this sheet is the chip's one owner.
328
+ - `chat-drawn-size-browser.test.ts` reads it off the pixels (locked and on, at 390 and under a mouse at 1366), from the source and as
329
+ next build minifies it, with its negative control (main's rule before this, `height: 44px`, draws the 44 whole).
330
+ - assistant-plus.css: 1.2 KB gzip, under its 1,578 B ceiling.
331
+
332
+ **A chat CTA and a page card's Open under a thumb are drawn at their mouse size, 38 and 32, in their 44px box** (15/11/2026; Chris
333
+ 13/11: "vẽ 28, khối 44"). Measured on production at 390 with touch: "Open in Tests" was drawn 44 under a composer drawn 28.
334
+ - New entry `packages/ui/src/chat-cards-drawn.css` (`@gemboss/ui/chat-cards-drawn.css`), imported by `chat-cards.tsx` after
335
+ chat-cards.css (and by the admin's FunnelBuildPanel). Born an entry: in chat-cards.css these rules put it 190 B gzip over its
336
+ ceiling, so chat-cards.css is untouched. Its ceiling: 912 B gzip (measured + slack).
337
+ - The button's fill is clipped to its words, its line and glow dropped (`!important`), and its `::before`, inset by half the
338
+ difference, inherits the fill and the line and wears the glow. The glow is `--gemboss-ec-cta-glow`: chat-cards-drawn.css restates
339
+ chat-cards.css's value, and `packages/ui/src/assistant-plus.css` now draws Gem Plus's gold one through the same variable.
340
+ - `chat-drawn-size-browser.test.ts` reads it off the pixels (ghost, primary, Gem Plus's primary, a page card's Open; 390 and a mouse
341
+ at 1366), holds the glow under a finger equal to the glow under a mouse, and its negative control draws the 44 whole without the entry.
342
+
343
+ **The question waiting on the person floats over the thread** (15/11/2026; Chris: "nó là popup… hiệu ứng gương mờ đè lên content bên
344
+ dưới", "tối ưu không gian", "nếu dài có scroll ko"). New entry `chat-cards-float.css`, imported by `chat-cards.tsx` after
345
+ `chat-cards.css` (that sheet was at its weight ceiling). `ChatDecide` placed last in the thread's scroll (`.gemboss-ec-scroll >
346
+ .gemboss-ec-decide`) sticks to its foot, frosted with the dock's numbers (blur 14px, saturate 1.4, the wash at 82%; solid where
347
+ `backdrop-filter` is missing), never taller than `min(55vh, 420px)` (the choices scroll inside, the line and the question stay), its
348
+ choices in a grid (3 in one row at 1366, one per row on a phone). Measured before at 1366×900 with the box under the thread: 3 choices
349
+ took 246px and left the thread 401px, 8 left it 81px. ON UPGRADE: put the box inside your thread's scroll to get the float; outside it, it
350
+ keeps its place and only gains the frost, the cap and the grid. `assistant-chat.css` drops `.gemboss-ec-decide + .gemboss-ec-input`.
351
+ On a Mac, End in "Something else"'s field scrolls the choices (a scrolled view); ⌘→ goes to the end.
352
+
353
+ **A field made of parts under a thumb or at a phone's width is drawn at a Polaris field's size there, in its 44px box** (15/11/2026;
354
+ Chris 13/11: "vẽ 28, khối 44", the field after the button; 36 on a phone chosen under his delegation, as the admin draws Polaris's
355
+ TextField and Select, gemboss #7639). Measured on production at 390 with touch: Settings' "Search settings" was drawn 44 above
356
+ Account's Polaris fields.
357
+ - New entry `packages/ui/src/gemboss-field-drawn.css` (`@gemboss/ui/gemboss-field-drawn.css`, born an entry: gemboss-field.css is in
358
+ the frozen bundle, and these rules would have raised `gemboss-ui.css` by 119 B and `parts/components.css` by 125 B over their
359
+ ceilings). A surface that draws `.gemboss-field--group` links it: the admin's SettingsDialog imports it (the one group on its phone
360
+ screens). Not an @import in gemboss-shell.css, whose imports some 30 harnesses read by name. Its ceiling: 942 B gzip (430 measured + slack). The frozen bundle does not move.
361
+ - Under `(pointer: coarse), (max-width: 47.9975em)` a `.gemboss-field--group` keeps its 44 box and is drawn 36 (its words are 16px
362
+ there), and 32 under a finger from 48em; its fill is clipped to its words and its border hidden (`!important`, as a kit button's),
363
+ and its `::before` inherits them, so hover, focus and an error follow. The focus ring moves to the drawing; the group no longer
364
+ clips. Not a group with a colour swatch (the swatch is the whole 44 target) nor the editor's colour group (its hairline is full
365
+ height). A bare `input.gemboss-field` has no `::before` and is drawn 44 still.
366
+ - `gemboss-field-drawn-size-browser.test.ts` reads it off the pixels (390 with a finger and a mouse, 1024 with a finger, 1366 with a
367
+ mouse; an error, the focus ring; the two that keep their box), from the source and as next build minifies it, with its negative
368
+ control (the field's sheet alone draws the 44 whole).
369
+
370
+ **A link chip under a thumb is drawn at its mouse 30, in its 44px box** (15/11/2026; Chris 13/11: "vẽ 28, khối 44", then "làm đi" on
371
+ the chips). `.ui-chips > a.ui-tag--chip` is 30 tall under a mouse at every width and got a 44 floor under a coarse pointer, which drew
372
+ the whole 44: filter rows on GemCommunity, GemFeedback, GemReach and the toolkits looked a size bigger on a phone.
373
+ - New entry `packages/ui/src/chips-drawn.css` (`@gemboss/ui/chips-drawn.css`), born an entry: ui.css is in the frozen bundle
374
+ (gemboss-ui.css 7 B under its ceiling). Its ceiling: 831 B gzip (measured + slack). The bundle does not move.
375
+ - ON UPGRADE: link `@gemboss/ui/chips-drawn.css` after gemboss-ui.css (or the parts) on a surface that draws `.ui-chips`. Without it
376
+ the chips stay as they were (drawn 44 under a finger).
377
+ - Under `(pointer: coarse)` the chip keeps its 44 box; its own fill is clipped to its words and its line hidden (`!important`), and
378
+ its `::before`, 7px in top and bottom, inherits them, so the picked tone and hover follow; the focus ring moves to the drawing. A
379
+ chip shorter than 44 stays 44 wide (its floor), drawn as wide.
380
+ - `chips-drawn-size-browser.test.ts` reads it off the pixels (under a finger: 44 box, drawn 30, the page outside the drawing, the
381
+ picked tone inside it, the ring on it; under a mouse at 1366 and 390: its own 30), from the source and as next build minifies it,
382
+ with its negative control (ui.css alone draws the 44 whole).
383
+
7
384
  ## 0.71.0 (13/11/2026)
8
385
 
9
386
  **A hover tint only where a pointer hovers; the chat's markdown in every engine; the left panel's seam within reach** (13/11/2026,
@@ -53,7 +430,6 @@ strip, at 760px and under (the strip), or in full screen on a phone (one New cha
53
430
  both frames in full screen (1280: the hairline, a drag, the range, kept, a reload; the keys; 900: the chat's floor; 760, 390, collapsed:
54
431
  no seam), with two negative controls (tray.css without the rail's width rule; without the rule that keeps the seam off a narrow rail).
55
432
 
56
-
57
433
  **TraySearch: the full Assistant's search box, one for every tray** (13/11/2026, gemboss #7363: the Inbox's search "giống như bên ai
58
434
  assistant có icon search bấm vào reveal ra search", "dùng lại component của bên ai assistant ở full mode").
59
435
  - `TraySearch` and `openTraySearch` (`@gemboss/ui/tray-search`, also from `@gemboss/ui/tray`): the box SessionRail drew, lifted. Same
@@ -746,7 +1122,6 @@ counted from `main` (already at 56) and drew 56px low, over the embedded editor'
746
1122
  landed on a nav tab). `overflow: clip` cuts the same overflow without being a scroll container. Chromium test
747
1123
  `embedded-editor-under-sticky-nav-browser.test.ts`, with `hidden` restored as its negative control.
748
1124
 
749
-
750
1125
  - `FieldFrame` / `PartsFrame` `labels` (`FrameClusterLabels`): a host's own name for a cluster where the kit's (Look · Layout · Visibility ·
751
1126
  Code) would say the wrong thing; the plugin kernel's settings name theirs Look and Behavior (one control set 08/11/2026).
752
1127