@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 +21 -0
- package/README.md +40 -0
- package/catalog/editor.html +1 -1
- package/catalog/index.html +48 -48
- package/gemboss-ui.css +1 -1
- package/package.json +2 -1
- package/parts/components.css +1 -1
- package/parts/core.css +1 -1
- package/parts/shell.css +1 -1
- package/src/GemMark.tsx +9 -2
- package/src/auth.tsx +7 -3
- package/src/brand-gem.tsx +10 -2
- package/src/brand.tsx +6 -3
- package/src/editor/field-frame.tsx +5 -3
- package/src/editor/inspector-frame.tsx +3 -2
- package/src/editor-inspector-frame.css +1 -1
- package/src/index.ts +4 -2
- package/src/metrics.css +1 -0
- package/src/metrics.tsx +59 -0
- package/src/services.ts +17 -0
- package/src/site.tsx +3 -3
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
|
package/catalog/editor.html
CHANGED
|
@@ -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.
|
|
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 "@gemboss/ui/editor.css";
|
|
14
14
|
import { EditorFrame, EditorTopbar, EditorBack, EditorChatToggle, EditorPaneTabs, EditorSaveState, DeviceToggle } from "@gemboss/ui/editor";
|