@gemboss/ui 0.73.0 → 0.74.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,27 @@ 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.74.0 (16/11/2026)
8
+
9
+ **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
10
+ 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
11
+ the tile drew the facet iris on every service.
12
+ - `BrandLockup`, `SiteBrand`, `AuthLayout` (its default mark) and `GemMark` take `facet`, a colour; without it the facet reads
13
+ `--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
14
+ was (#5661F5 on the lockups, #8a93ff on the tile).
15
+ - The colour is in the polygon's `fill` attribute and its inline style: the style reads the variable, the attribute is what is left
16
+ under a CSP that drops inline styles (never the SVG's default black). "Continue with GemBoss" pins its mark to GemBoss's colour.
17
+ - `GEM_FACETS` (`core`, `understand`, `build`, `sell`, `measure`, `retain`, `spread`) and `type GemFacet`, from the index and
18
+ `@gemboss/ui/services`. No CSS: no entry, no ceiling moves.
19
+ - `brand-gem.test.tsx` holds the markup; `site-browser.test.tsx` holds what Chromium paints (the variable, the prop over it, a CSP
20
+ with a negative control). README "The gem's facet".
21
+
22
+ **`Metrics` and `Metric`: big numbers on cards** (15/11/2026, GemLoop's seller screens). The plain kit's large metric card
23
+ (`ui-metrics--grid` › `ui-metric--lg`, `__val`, `__lbl` above the number, `__foot`) as React parts with their own entry,
24
+ `@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
25
+ 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
26
+ the link.
27
+
7
28
  ## 0.73.0 (16/11/2026)
8
29
 
9
30
  **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 |
@@ -2187,6 +2188,7 @@ import { AppShell, BrandLockup, AccountMenu, AccountMenuItem, Icon, RailItem } f
2187
2188
  - `BrandLockup`: the admin wordmark's gem and proportions (26px tall, 13.3px/700 name) with your
2188
2189
  product's name. The name hides below 460px, as the admin's wordmark does. `switcher={{ current: "gemfactory" }}`
2189
2190
  (0.36.0) adds the button that opens every other Gem service right after it: README "ServiceSwitcher".
2191
+ `facet` (16/11/2026) colours the gem's table facet: README "The gem's facet" below.
2190
2192
  - `AccountMenu`: the admin's 32px initials chip and popover (same CSS). A `<details>`, so it opens
2191
2193
  without JavaScript on a page that never hydrates; with React it also closes on an outside click and
2192
2194
  on Escape. `AccountMenuItem` is a link (`href`), a POST form (`formAction`), or a button; a caller's `className` is added to the
@@ -2234,6 +2236,33 @@ import { AppShell, BrandLockup, AccountMenu, AccountMenuItem, Icon, RailItem } f
2234
2236
  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
2237
  there (Who sees what's Everyone else, version A).
2236
2238
 
2239
+ ### The gem's facet (16/11/2026, unreleased)
2240
+
2241
+ 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;
2242
+ the set is gembusiness `strategy/2026-11-vision/logos`, and each service's favicon already draws it). `GEM_FACETS` (also on
2243
+ `@gemboss/ui/services`, plain data) holds the colours: `core` #5661F5 (GemBoss), `understand` #38A3F1, `build` #9B7BFF, `sell`
2244
+ #16B88A, `measure` #2CC5C5, `retain` #F0457E, `spread` #F5A524.
2245
+
2246
+ ```css
2247
+ /* One line in the surface's own stylesheet colours every gem the kit draws there, the header's and the sign-in's: */
2248
+ :root { --gb-gem-facet: #38A3F1; }
2249
+ ```
2250
+
2251
+ ```tsx
2252
+ // …or per gem, which wins over the variable:
2253
+ <BrandLockup name="GemWatcher" href="/" facet={GEM_FACETS.understand} />
2254
+ <AuthLayout brand="GemWatcher" facet={GEM_FACETS.understand}>…</AuthLayout>
2255
+ ```
2256
+
2257
+ | | |
2258
+ |---|---|
2259
+ | Who takes it | `BrandLockup`, `SiteBrand`, `AuthLayout` (its default mark; not a `mark` of your own) and `GemMark`, as `facet` (any CSS colour) |
2260
+ | With neither | what each drew before: the lockups' iris #5661F5, the tile's lighter #8a93ff |
2261
+ | 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 |
2262
+ | 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"`) |
2263
+ | A plain-HTML page | writes the colour into its copy of the polygon (`fill="#38A3F1"`) |
2264
+ | 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) |
2265
+
2237
2266
  ## Topbar search (0.6.3)
2238
2267
 
2239
2268
  The admin's "Search ⌘K" box for every surface, as a real form (works with no JavaScript):
@@ -3369,6 +3398,17 @@ draw their pictures and figures from here, so one change moves both. Their own e
3369
3398
  sentence, its one button at the end (`<Notice action={<button className="ui-btn">Turn off</button>}>… no difference for 30 days.</Notice>`).
3370
3399
  No tone is a card on the page's ground; `tone` takes the core notice's colours.
3371
3400
 
3401
+ `Metrics` and `Metric` (their own entry, `@gemboss/ui/metrics.css`, unreleased) are the plain kit's large metric cards for a React host
3402
+ 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
3403
+ 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.
3404
+
3405
+ ```tsx
3406
+ <Metrics label="Numbers">
3407
+ <Metric label="Live subscriptions" value="1,284" href="/app/plugins/gemloop?tab=subscriptions" linkAs={Link} />
3408
+ <Metric label="Next 7 days" value="$9,840" foot="286 charges" />
3409
+ </Metrics>
3410
+ ```
3411
+
3372
3412
  ## Audiences (05/11/2026, unreleased): `AudiencesTable`, a store's audiences
3373
3413
 
3374
3414
  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.74.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;;