@gemboss/ui 0.73.0 → 0.75.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -4,6 +4,51 @@ 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.75.0 (16/11/2026)
8
+
9
+ **A plain select under a thumb is drawn at a field's size in its 44px box: `select-drawn.css`** (16/11/2026; Chris 13/11: "vẽ 28, khối 44",
10
+ every control). `.ui-select` is floored to 44 in the finger tier (ui.css, kit-plain.css) and drew the whole 44: gemform's registration
11
+ Dialog showed a 44 status select beside Email and Delete drawn at 28 (0.71.0's buttons).
12
+ - A new entry, `@gemboss/ui/select-drawn.css` (ui.css is in the frozen bundle). In the finger tier it draws a `.ui-select` as the kit
13
+ draws a field there (gemboss-field-drawn.css, the admin's Polaris Select): 36 below 48em, where its words are 16px; 32 from 48em under a
14
+ finger; `--slim` at its mouse 30. The box stays 44.
15
+ - A <select> has no `::before`, so the drawing is the box itself: the top and bottom of the 44 are a transparent border (still the
16
+ target), the fill is clipped to the padding box, the line is an inset shadow on it, and the outer radius is elliptical so the drawing's
17
+ corners are the field's radius. The line restates each state's colour (`--ui-select-line`: rest, hover, keyboard focus, refused); the
18
+ focus ring is 2px inside the drawing (an outline would ring the 44).
19
+ - `select-drawn-size-browser.test.ts` reads it off the pixels, from the source and minified: 36 / 32 / 30 in a 44, each state's line the
20
+ same colour as the mouse's border in that state, the ring inside, no outline. Negative control: ui.css and kit-plain.css alone draw the
21
+ 44 whole; with the hover, refused or ring rule taken out, the test goes red on that rule. 417 B gzip, ceiling 929 (measured + slack).
22
+ - ON UPGRADE: link `@gemboss/ui/select-drawn.css` after gemboss-ui.css (or the parts) on a surface that draws `.ui-select`. Without it
23
+ the select stays drawn at 44. A surface that sets its own `border` on a `.ui-select` keeps a 44 drawing (its border replaces the bands).
24
+
25
+ **GemNews is now GemSpace** (16/11/2026, Chris: the new tab is a workspace, news is one part of it). The switcher's `gemnews` entry
26
+ reads GemSpace and opens `https://space.gemboss.ai/admin`, in `services.ts` and `service-switcher-plain.js` alike. The id stays
27
+ `gemnews`, so a surface that marks itself current with it keeps working. The old address still serves the admin.
28
+
29
+ ## 0.74.0 (16/11/2026)
30
+
31
+ **The gem's facet in each Gem's colour: `facet` and `--gb-gem-facet`, `GEM_FACETS`** (16/11/2026; Chris 15/11: a Gem's logo is the
32
+ GemBoss gem, "đổi màu đi chút để đồng bộ", and each service's favicon already draws its colour). The lockup, the sign-in's mark and
33
+ the tile drew the facet iris on every service.
34
+ - `BrandLockup`, `SiteBrand`, `AuthLayout` (its default mark) and `GemMark` take `facet`, a colour; without it the facet reads
35
+ `--gb-gem-facet`, so a surface sets it once on `:root` and styles over no kit class. With neither, the markup's colour is what it
36
+ was (#5661F5 on the lockups, #8a93ff on the tile).
37
+ - The colour is in the polygon's `fill` attribute and its inline style: the style reads the variable, the attribute is what is left
38
+ under a CSP that drops inline styles (never the SVG's default black). "Continue with GemBoss" pins its mark to GemBoss's colour.
39
+ - `GEM_FACETS` (`core`, `understand`, `build`, `sell`, `measure`, `retain`, `spread`) and `type GemFacet`, from the index and
40
+ `@gemboss/ui/services`. No CSS: no entry, no ceiling moves.
41
+ - `brand-gem.test.tsx` holds the markup; `site-browser.test.tsx` holds what Chromium paints (the variable, the prop over it, a CSP
42
+ with a negative control). README "The gem's facet".
43
+
44
+ **`Metrics` and `Metric`: big numbers on cards** (15/11/2026, GemLoop's seller screens). The plain kit's large metric card
45
+ (`ui-metrics--grid` › `ui-metric--lg`, `__val`, `__lbl` above the number, `__foot`) as React parts with their own entry,
46
+ `@gemboss/ui/metrics.css`, so the admin, which never loads kit-plain.css, draws it without a copy of its own (GemPersonalizer's Home and
47
+ GemTroop drew theirs by hand). Same class names as kit-plain, so a plain page and a React one look alike. With `href` the whole card is
48
+ the link.
49
+
50
+ **A `trash` icon** (16/11/2026), drawn on the set's 20px grid, in `icons.tsx` and `icons-plain.js`: the admin Inbox row's Delete.
51
+
7
52
  ## 0.73.0 (16/11/2026)
8
53
 
9
54
  **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:
package/README.md CHANGED
@@ -103,6 +103,7 @@ its CSS out of the build with it (`sideEffects`). gzip of the minified file, as
103
103
  | range-bar | `@gemboss/ui/range-bar.css` | `packages/ui/src/range-bar.css` | `RangeBar`: a value against a market's spread on one axis (0.43.0) | 0.6 KB | `RangeBar` imports it |
104
104
  | progress-ring | `@gemboss/ui/progress-ring.css` | `packages/ui/src/progress-ring.css` | `ProgressRing`: "3 of 5" as a ring (0.43.0) | 0.2 KB | `ProgressRing` imports it |
105
105
  | progress-bar | `@gemboss/ui/progress-bar.css` | `packages/ui/src/progress-bar.css` | `ProgressBar`: how far along, a thin bar a screen places anywhere (unreleased) | 0.3 KB | `ProgressBar` imports it |
106
+ | metrics | `@gemboss/ui/metrics.css` | `packages/ui/src/metrics.css` | `Metrics`, `Metric`: big numbers on cards in an even grid, the plain kit's `ui-metric--lg` for React hosts (unreleased) | 0.3 KB | `Metrics` / `Metric` import it |
106
107
  | audiences-table | `@gemboss/ui/audiences-table.css` | `packages/ui/src/audiences-table.css` | `AudiencesTable`: a store's audiences (source chip, On site, Can email, 7 days, Used by), GemBoss Reach and GemReach's admin (unreleased) | 0.4 KB | `AudiencesTable` imports it, with IndexTable's collections.css |
107
108
  | spot-art | `@gemboss/ui/spot-art.css` | `packages/ui/src/spot-art.css` | `SpotArt`: six brand pictures for pauses and empty states (0.43.0) | 0.4 KB | `SpotArt` imports it |
108
109
  | kind-art | `@gemboss/ui/kind-art.css` | `packages/ui/src/kind-art.css` | `KindArt`: the cream strip across the top of a "pick a kind" card, one bold drawing per kind (04/11/2026, unreleased) | 0.6 KB | `KindArt` imports it; a plain-HTML page links it |
@@ -132,6 +133,7 @@ its CSS out of the build with it (`sideEffects`). gzip of the minified file, as
132
133
  | gemboss-field-drawn | `@gemboss/ui/gemboss-field-drawn.css` | `packages/ui/src/gemboss-field-drawn.css` | a field made of parts (`.gemboss-field--group`) under a thumb or at a phone's width drawn at a Polaris field's size in its 44px box: 36, 32 from 48em under a finger (15/11/2026, its own entry: gemboss-field.css is in the frozen bundle) | 0.4 KB | a surface that draws a group links it (the admin's SettingsDialog imports it) |
133
134
  | chat-cards-drawn | `@gemboss/ui/chat-cards-drawn.css` | `packages/ui/src/chat-cards-drawn.css` | a chat CTA and a page card's Open under a thumb drawn at their mouse size, 38 and 32, in their 44px box; the glow on the drawing (15/11/2026, its own entry: chat-cards.css is at its ceiling) | 0.4 KB | `chat-cards.tsx` imports it after chat-cards.css |
134
135
  | chips-drawn | `@gemboss/ui/chips-drawn.css` | `packages/ui/src/chips-drawn.css` | every chip in `.ui-chips` (a link, a toggle, a static one) in the finger tier drawn at its mouse 30 in its 44px box (15/11/2026, its own entry: ui.css is in the frozen bundle) | 0.3 KB | a surface that draws `.ui-chips` links it after gemboss-ui.css (or the parts) |
136
+ | select-drawn | `@gemboss/ui/select-drawn.css` | `packages/ui/src/select-drawn.css` | a plain `.ui-select` in the finger tier drawn at a field's size in its 44px box: 36, 32 from 48em under a finger, `--slim` 30; each state's line as the mouse's border, the focus ring inside (16/11/2026, its own entry: ui.css is in the frozen bundle) | 0.4 KB | a surface that draws `.ui-select` links it after gemboss-ui.css (or the parts) |
135
137
  | bundle | `@gemboss/ui/gemboss-ui.css` | `gemboss-ui.css` | core + components + shell + auth + assistant + chat + portal + theme-dark | 21.9 KB | compatibility only (see CHANGELOG 0.23.0) |
136
138
 
137
139
  The core alone is 14.7 KB against 21.7 for the bundle (each part opens with a short header naming the gemboss commit, kept through minify, so a surface serving the parts can still say which commit its CSS is); a list page adds collections (4.6), a sign-in page auth (2.6).
@@ -1707,7 +1709,7 @@ The groups, in order, are how a store is built and then run (`SERVICE_GROUPS`, s
1707
1709
  | GemBoss | GemBoss (the seller app and the ops console) |
1708
1710
  | Build the store | GemFactory, GemMedia, GemForm, GemX |
1709
1711
  | Read the market | GemWatcher, GemMarket, GemPixel, GemCapture, Search Radar |
1710
- | Content and community | GemPress, Content Radar, GemCommunity, GemCommunity News |
1712
+ | Content and community | GemPress, Content Radar, GemCommunity, GemSpace (id `gemnews`) |
1711
1713
  | Customers | GemCare, GemFeedback |
1712
1714
  | Team and partners | Partner Radar, Taskdesk |
1713
1715
 
@@ -2187,6 +2189,7 @@ import { AppShell, BrandLockup, AccountMenu, AccountMenuItem, Icon, RailItem } f
2187
2189
  - `BrandLockup`: the admin wordmark's gem and proportions (26px tall, 13.3px/700 name) with your
2188
2190
  product's name. The name hides below 460px, as the admin's wordmark does. `switcher={{ current: "gemfactory" }}`
2189
2191
  (0.36.0) adds the button that opens every other Gem service right after it: README "ServiceSwitcher".
2192
+ `facet` (16/11/2026) colours the gem's table facet: README "The gem's facet" below.
2190
2193
  - `AccountMenu`: the admin's 32px initials chip and popover (same CSS). A `<details>`, so it opens
2191
2194
  without JavaScript on a page that never hydrates; with React it also closes on an outside click and
2192
2195
  on Escape. `AccountMenuItem` is a link (`href`), a POST form (`formAction`), or a button; a caller's `className` is added to the
@@ -2234,6 +2237,33 @@ import { AppShell, BrandLockup, AccountMenu, AccountMenuItem, Icon, RailItem } f
2234
2237
  stays a select. Off (`disabled`), it shows its choice with no hover and a quiet chevron: a field the screen shows and does not change
2235
2238
  there (Who sees what's Everyone else, version A).
2236
2239
 
2240
+ ### The gem's facet (16/11/2026, unreleased)
2241
+
2242
+ Every Gem's logo is the GemBoss gem; only the top "table" facet changes colour, by the role the Gem plays (Chris 15/11/2026;
2243
+ the set is gembusiness `strategy/2026-11-vision/logos`, and each service's favicon already draws it). `GEM_FACETS` (also on
2244
+ `@gemboss/ui/services`, plain data) holds the colours: `core` #5661F5 (GemBoss), `understand` #38A3F1, `build` #9B7BFF, `sell`
2245
+ #16B88A, `measure` #2CC5C5, `retain` #F0457E, `spread` #F5A524.
2246
+
2247
+ ```css
2248
+ /* One line in the surface's own stylesheet colours every gem the kit draws there, the header's and the sign-in's: */
2249
+ :root { --gb-gem-facet: #38A3F1; }
2250
+ ```
2251
+
2252
+ ```tsx
2253
+ // …or per gem, which wins over the variable:
2254
+ <BrandLockup name="GemWatcher" href="/" facet={GEM_FACETS.understand} />
2255
+ <AuthLayout brand="GemWatcher" facet={GEM_FACETS.understand}>…</AuthLayout>
2256
+ ```
2257
+
2258
+ | | |
2259
+ |---|---|
2260
+ | Who takes it | `BrandLockup`, `SiteBrand`, `AuthLayout` (its default mark; not a `mark` of your own) and `GemMark`, as `facet` (any CSS colour) |
2261
+ | With neither | what each drew before: the lockups' iris #5661F5, the tile's lighter #8a93ff |
2262
+ | How | the colour is the polygon's `fill` attribute AND its inline `style`: the style reads the variable (`var()` in a presentation attribute is not read by every browser), and the attribute is what is left where a CSP without `'unsafe-inline'` drops inline styles, so a strict page keeps iris or the prop's colour, never black. No new CSS |
2263
+ | GemBoss's own mark | "Continue with GemBoss" pins its `GemMark` to #8a93ff, so it stays GemBoss's on a Gem that set the variable. A surface that draws GemBoss's mark itself with `GemMark` does the same (`facet="#8a93ff"`) |
2264
+ | A plain-HTML page | writes the colour into its copy of the polygon (`fill="#38A3F1"`) |
2265
+ | Tests | `brand-gem.test.tsx` (the markup); `site-browser.test.tsx` "the gem's facet, painted" (the colour Chromium paints: nothing set, the variable, the prop over it, and under a CSP with the style dropped, with a negative control) |
2266
+
2237
2267
  ## Topbar search (0.6.3)
2238
2268
 
2239
2269
  The admin's "Search ⌘K" box for every surface, as a real form (works with no JavaScript):
@@ -3369,6 +3399,17 @@ draw their pictures and figures from here, so one change moves both. Their own e
3369
3399
  sentence, its one button at the end (`<Notice action={<button className="ui-btn">Turn off</button>}>… no difference for 30 days.</Notice>`).
3370
3400
  No tone is a card on the page's ground; `tone` takes the core notice's colours.
3371
3401
 
3402
+ `Metrics` and `Metric` (their own entry, `@gemboss/ui/metrics.css`, unreleased) are the plain kit's large metric cards for a React host
3403
+ that never loads kit-plain.css: an even grid of cards, each its name above a big number and one muted line under it. With `href` the
3404
+ whole card is the link (`linkAs` for the app's Link). A number the screen does not know is not passed: leave the card out.
3405
+
3406
+ ```tsx
3407
+ <Metrics label="Numbers">
3408
+ <Metric label="Live subscriptions" value="1,284" href="/app/plugins/gemloop?tab=subscriptions" linkAs={Link} />
3409
+ <Metric label="Next 7 days" value="$9,840" foot="286 charges" />
3410
+ </Metrics>
3411
+ ```
3412
+
3372
3413
  ## Audiences (05/11/2026, unreleased): `AudiencesTable`, a store's audiences
3373
3414
 
3374
3415
  The list of a store's audiences as GemBoss › Reach › Audiences draws it (board GroupsTable on the canvas "Một lõi, ba cửa"; Chris
@@ -8,7 +8,7 @@
8
8
  .cat-code summary{padding:10px 16px;font-size:13px;cursor:pointer;color:var(--gemboss-text-muted);border-top:1px solid var(--gemboss-divider);min-height:24px}
9
9
  .cat-code pre,.cat-api{margin:0;padding:12px 16px;overflow:auto;background:#0f1012;color:#e8e8e6;font-size:12px;line-height:1.5;border-radius:0}
10
10
  .cat-api{border-radius:12px;margin:0 0 16px}</style></head><body><div class="cat">
11
- <h1>@gemboss/ui 0.73.0 · Editor</h1>
11
+ <h1>@gemboss/ui 0.75.0 · Editor</h1>
12
12
  <p>Khung của mọi editor: <code>EditorFrame</code> (cột trái · khe kéo · preview · cột phải dock trên mép phải preview) và <code>EditorTopbar</code> (← · tiêu đề · cụm giữa · cụm phải · dòng trạng thái). Là đúng khung của theme / page / section editor trong admin. Gói chỉ vẽ KHUNG; chat, Configure, canvas, page picker, menu, Publish là của editor, đi vào bằng slot. Trang HTML thuần nạp <code>editor.css</code> + <code>editor-plain.js</code> rồi gọi <code>gembossUI.initEditorFrame()</code>: kéo khe (chuột, chạm, phím mũi tên / Home / End), đổi thiết bị, mở ⋯ và Publish ▾, ẩn cột trái, Chat | Preview trên điện thoại. <a href="index.html">← Catalog</a></p>
13
13
  <h2>React</h2><pre class="cat-api"><code>import &quot;@gemboss/ui/editor.css&quot;;
14
14
  import { EditorFrame, EditorTopbar, EditorBack, EditorChatToggle, EditorPaneTabs, EditorSaveState, DeviceToggle } from &quot;@gemboss/ui/editor&quot;;