@gemboss/ui 0.63.0 → 0.65.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 +98 -0
- package/README.md +98 -4
- package/catalog/editor.html +1 -1
- package/catalog/index.html +23 -20
- package/gemboss-ui.css +2 -2
- package/package.json +9 -1
- package/parts/components.css +1 -1
- package/parts/core.css +1 -1
- package/parts/shell.css +1 -1
- package/src/assistant/chat.tsx +67 -4
- package/src/assistant/dictation.ts +292 -0
- package/src/assistant/index.ts +4 -1
- package/src/audiences-table.css +1 -0
- package/src/audiences-table.tsx +167 -0
- package/src/chat-voice.css +1 -0
- package/src/editor/color-choices.ts +9 -0
- package/src/editor/controls.tsx +5 -2
- package/src/editor/field-control.tsx +453 -0
- package/src/editor/field-frame.tsx +182 -0
- package/src/editor/field-spec.ts +345 -0
- package/src/editor/index.ts +16 -0
- package/src/editor.css +1 -1
- package/src/email-editor/editor.tsx +462 -0
- package/src/email-editor/index.ts +16 -0
- package/src/email-editor/model.ts +361 -0
- package/src/email-editor/preview.tsx +208 -0
- package/src/email-editor.css +1 -0
- package/src/gem-at-work.css +1 -1
- package/src/gem-at-work.ts +273 -15
- package/src/index.ts +2 -1
- package/src/list-page.tsx +87 -4
- package/src/skill-feedback.css +1 -1
- package/src/skill-feedback.tsx +5 -1
- package/src/skill-history.tsx +2 -1
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,81 @@ 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.65.0 (08/11/2026)
|
|
8
|
+
|
|
9
|
+
**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
|
|
10
|
+
shared component… đừng mỗi cho mỗi kiểu"). Every app draws a settings schema with the same controls: moved from the admin
|
|
11
|
+
(components/shell/FieldRenderer.tsx, FieldFrame.tsx, lib/held-knobs.ts, settings-frame-groups.ts, find-a-setting.ts) with their markup,
|
|
12
|
+
class names and commit rules, so the admin draws exactly as before (967 rendered settings surfaces byte-identical before and after).
|
|
13
|
+
- `FieldSpec` (`@gemboss/ui/editor`): the kit's kinds, `text` · `textarea` · `number` · `range` · `select` · `segmented` · `toggle` · `color`
|
|
14
|
+
· `image` · `repeater` (`KIT_FIELD_KINDS`); `SelectOption<G>` (a choice's `glyph` typed by the app's names), `FieldSchema`, `FieldGroup`.
|
|
15
|
+
- `FieldControl` (one field, its label on the side `LABEL_SIDE` says: `controlOf`, `labelBeside`), `FieldRows` (a group's fields, the label
|
|
16
|
+
on one side for the run: `firstSideFirst`; `off` + `offWhy`, `idPrefix`), `FieldRenderer` (a schema as static titled groups).
|
|
17
|
+
- `FieldFrame`, `PartsFrame`, `usePartHits`: a schema in the settings frame (InspectorFrame): each field where the element panel puts the
|
|
18
|
+
same setting (`frameGroups`: by default every group is the schema's own, `OWN_FRAME_PLACES`; the admin passes the element panel's
|
|
19
|
+
`STYLE_FRAME_PLACES`; an app may pass its own `places`), + and − groups (`groupState`, `knobHolds`,
|
|
20
|
+
`knobClearWrites`, `heldKnobsOnly`), a search shown in place (`settingMatches`, `findSettings`).
|
|
21
|
+
- An app's own kinds: `kinds` (prop on each of the above, or `FieldKindsProvider`), each `{ control, render, spread? }`: `control` its
|
|
22
|
+
label-side name, `render` its drawing (it gets the resolved `id`, `label`, `named` and `base()`, the kit's control for a kit kind it
|
|
23
|
+
replaces), `spread` a kind over several stored settings (read, write only what changed, holds, clear). `glyphs`: the picture a choice's
|
|
24
|
+
`glyph` is drawn as. A kind no one draws is a visible "No control draws “x” settings here." (`[data-unknown-kind]`), never a text box.
|
|
25
|
+
- `ColorChoicesContext` (a colour field's chips; also `@gemboss/ui/editor/color-choices`), `labelize`, the fit of a row of chips
|
|
26
|
+
(`segmentable`, `labelWidthPx`, `chipsFitBeside`, `NARROWEST_COLUMN_PX`, `ROW_CONTROL_COLUMN_PX`).
|
|
27
|
+
- `@gemboss/ui/editor/field-spec`: the schema with no React and no import of another module, for node tests and scripts.
|
|
28
|
+
|
|
29
|
+
**The email editor, wired to GemReach** (08/11/2026, gemboss #6820)
|
|
30
|
+
|
|
31
|
+
Added
|
|
32
|
+
- `EmailEditor` `actions` (the surface's buttons beside Save) and `sent` ("As sent": the sender's own HTML in a sandboxed frame);
|
|
33
|
+
`EmailCheck.severity` (an `error` reads red in the checks list, a `warning` amber).
|
|
34
|
+
|
|
35
|
+
**A list's card waits where it stood while it loads again** (02/11/2026, the admin's layout shifts: GemSeel's Orders card moved
|
|
36
|
+
271px on 19 of 96 visits with a CLS of 0.1 or more, measured in gemboss_admin_vitals).
|
|
37
|
+
|
|
38
|
+
Added
|
|
39
|
+
- `ListPage`'s `holdKey`: where the card stood as the read landed (ready, empty or no match) is kept on this device, per key and
|
|
40
|
+
page width (one localStorage entry, `gb.list-hold`, at most 200 places), and while the list loads again the card waits there,
|
|
41
|
+
kept there if what is above it changes height meanwhile, so the line under the title, the notices and the toolbar that come with
|
|
42
|
+
the read fill the room above it instead of pushing it down. A first visit, a private window, a page without the key, and a page
|
|
43
|
+
the server drew (left where it was painted) are as before.
|
|
44
|
+
|
|
45
|
+
**A chip button can say which one it is** (08/11/2026, gemboss follow-up #7). `ChipButton` `label`: its accessible name when its words are
|
|
46
|
+
one of many alike, as the page editor's "All settings" in each element's group of "Elements in this section" ("All settings for Row").
|
|
47
|
+
|
|
48
|
+
**Gem at work: a line by the work and the goal's meter** (08/11/2026, gemboss #6899). `GemActivity.say` and `GemActivity.goal` (optional,
|
|
49
|
+
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:
|
|
50
|
+
"visual narration", not effects to pass the time).
|
|
51
|
+
|
|
52
|
+
## 0.64.0 (08/11/2026)
|
|
53
|
+
|
|
54
|
+
**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").
|
|
55
|
+
- `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.
|
|
56
|
+
- 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.
|
|
57
|
+
- 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ị").
|
|
58
|
+
- 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.
|
|
59
|
+
- `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).
|
|
60
|
+
|
|
61
|
+
**Skill rows: `when` and a node `note`** (08/11/2026; the reviews of gemlabs #1597 and gemboss #6873 found content-radar working
|
|
62
|
+
around both). `SkillFeedbackRow.when`: right after `who`, in the quiet small type (`.ui-skillfb__when`), for when a comment was left and
|
|
63
|
+
its state (Fixed, Resolved): no longer inside the bold name. `SkillVersionRow.note` is a node (phrasing content: text, or a `<span>`
|
|
64
|
+
per line), so a surface can add what the version changed under its note.
|
|
65
|
+
|
|
66
|
+
**Speak instead of typing** (08/11/2026, UI book B15-voice; Chris 07/11: "Browser speech"). The browser's own speech to text (the Web
|
|
67
|
+
Speech API) in the chat composer, once, for every chat that types into it. Moved from the admin (lib/dictation.ts, lib/use-dictation.ts).
|
|
68
|
+
- `ChatComposer` `voice` (`true` or `{ lang, silenceMs, firstWordsMs }`): a microphone after the tools (44px at every pointer), what is said
|
|
69
|
+
written into the box as it is said (interim results) after what was typed and editable, pressing again or a pause (6 s after the last
|
|
70
|
+
words) stops, typing / Send / the box turning off stops it at once. A line over the text box while it listens ("Listening" and
|
|
71
|
+
`DICTATION_NOTE`: "Your browser turns your voice into text. In Chrome this goes through Google.") or when it failed (a blocked microphone
|
|
72
|
+
says where the switch is; an error mid-way says the text is kept). Never sends. No button where the browser has no recognition, or the
|
|
73
|
+
page's frame may not use the microphone. `aria-pressed`, one label; the ring round it pulses unless motion is reduced.
|
|
74
|
+
- `AssistantChat` `voice`: passed to its composer, so a surface drawing the package's whole chat turns the mic on the same way.
|
|
75
|
+
- A stop the browser never ends (Safari, a dropped speech service) is ended after 2 s and says so; a second press ends it at once.
|
|
76
|
+
- `voice.likelyLang` (and `dictationLanguage`'s third argument): a language only guessed, used where the browser lists it.
|
|
77
|
+
- `useDictation`, `useCanDictate`, `canDictate`, `appendDictated`, `dictationLanguage`, `dictationProblemText`, `DICTATION_NOTE`
|
|
78
|
+
(`@gemboss/ui/assistant`, and `@gemboss/ui/assistant/dictation` with no CSS on the way) for a box that is not a chat.
|
|
79
|
+
- `chat-voice.css` (new entry, imported by `ChatComposer`): the microphone and its line. Not in `gemboss-ui.css` (frozen).
|
|
80
|
+
- `ChatLabels` gains `speak`, `stopListening`, `listening`.
|
|
81
|
+
|
|
7
82
|
## 0.63.0 (08/11/2026)
|
|
8
83
|
|
|
9
84
|
**Skills pages, as content-radar drew them** (found switching content-radar to these parts, its before and after rendered side
|
|
@@ -59,6 +134,29 @@ Changed
|
|
|
59
134
|
decided by InspectorGroup itself (`editor/frame-context.ts`); outside a frame it is the form's static group as before.
|
|
60
135
|
- Its own part `editor-inspector-frame.css` (0.9 KB gzip, ceiling 1,351 B): only a surface that draws the frame loads it.
|
|
61
136
|
|
|
137
|
+
**A store's audiences** (05/11/2026, board GroupsTable on the canvas "Một lõi, ba cửa"; Chris: one word and one list, Audiences. GemBoss
|
|
138
|
+
› Reach › Audiences, and GemReach's own admin after it).
|
|
139
|
+
|
|
140
|
+
Added
|
|
141
|
+
- `AudiencesTable` (`rows`: `name`, `source`: `site` | `email` | `imported` | `gemcare`, `sync`, `onSite`, `canEmail`, `delta`, `deltaTone`,
|
|
142
|
+
`usedBy`, `href`; `labels`, `linkAs`, `flush`, `state`), on `IndexTable`: Audience with its source chip and sync note, On site (a dash
|
|
143
|
+
where there is no count), Can email (a dash where it is not known), 7 days (toned by its sign) and Used by, the whole row opening the audience. `audienceDeltaTone`,
|
|
144
|
+
`audienceCount`, `audiencesTableColumns`, `audiencesTableRows`, `AudienceSourceChip` and `AUDIENCES_TABLE_LABELS` beside it. Its own entry,
|
|
145
|
+
`@gemboss/ui/audiences-table.css`.
|
|
146
|
+
|
|
147
|
+
**The email editor** (05/11/2026, Chris approved canvas JQkjqVVb "Email editor": "editor thư theo bố cục Page editor").
|
|
148
|
+
|
|
149
|
+
Added
|
|
150
|
+
- `@gemboss/ui/email-editor`, its own entry: `EmailEditor` (the page editor's layout: ← back to where it was opened, name and
|
|
151
|
+
Draft · version, Desktop · Mobile and Dark, "Send me a test", Save; ONE resizable left column with Chat · Sections · Settings, the
|
|
152
|
+
chat a slot that stays mounted; the mail on the stage; "+" under the picked block, at the end and in Sections; ↑ ↓ and Alt+↑ ↓;
|
|
153
|
+
nothing dragged; a checks pill), `EmailPreview`, and the model (`@gemboss/ui/email-editor/model`, pure): GemReach's block list as
|
|
154
|
+
it is (src/templates/blocks.ts at a341451) plus two proposals, `products` (this person's order, cart or views; GemReach #106) and
|
|
155
|
+
`review` (the GemReview ask). "Heading + text" is GemReach's `hero` without a picture. The button's personal link is
|
|
156
|
+
`{{funnel_url}}`, the link GemReach signs when it builds the mail (72 h). `emailChecks` runs 18 of GemReach's checks by their ids
|
|
157
|
+
until the server's replace them (`checks` prop).
|
|
158
|
+
- `email-editor.css`, its own entry (2.2 KB gzip), imported by `EmailEditor` and `EmailPreview`.
|
|
159
|
+
|
|
62
160
|
**Where a label goes is its control's, in one table** (Chris 04/11 and 05/11/2026: label left, control right for every one-value
|
|
63
161
|
setting, as GemPages; only a long text, a list, a spacing box, media, a gradient's editor or a drawing under its label). Measured before:
|
|
64
162
|
98 hand-built labelled rows in 30 admin files, each deciding its side; every label on the wrong side was in one of them
|
package/README.md
CHANGED
|
@@ -74,6 +74,7 @@ its CSS out of the build with it (`sideEffects`). gzip of the minified file, as
|
|
|
74
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
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 |
|
|
76
76
|
| 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
|
+
| 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) |
|
|
77
78
|
| 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 |
|
|
78
79
|
| editor-rail | `@gemboss/ui/editor-rail.css` | `packages/ui/src/editor-rail.css` | the page editor's 56px rail: the editor frame 56px in, the shell's rail beside it as icons, opened to 240px over the editor (unreleased) | 0.9 KB | admin `EditorRailToggle` imports it |
|
|
79
80
|
| rail-mini | `@gemboss/ui/rail-mini.css` | `packages/ui/src/rail-mini.css` | the rail folded to 56px of icons (`railMode="mini"`, 0.62.0): rows as icons with their names out of sight, counts as dots, main at 56 | 0.6 KB | `AppNav` imports it; a surface that folds the rail without one links it |
|
|
@@ -81,6 +82,7 @@ its CSS out of the build with it (`sideEffects`). gzip of the minified file, as
|
|
|
81
82
|
| reactions | `@gemboss/ui/reactions.css` | `packages/ui/src/reactions.css` | the emoji reactions and their picker | 0.8 KB | `Reactions` / `ReactionPicker` import it |
|
|
82
83
|
| 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 |
|
|
83
84
|
| 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
|
+
| 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 |
|
|
84
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 |
|
|
85
87
|
| minichart | `@gemboss/ui/minichart.css` | `packages/ui/src/minichart.css` | `Sparkline`, `ShareBar` (0.30.0) | 0.5 KB | those components import it |
|
|
86
88
|
| setup-guide | `@gemboss/ui/setup-guide.css` | `packages/ui/src/setup-guide.css` | `SetupGuide` (0.30.0) | 0.9 KB | `SetupGuide` imports it |
|
|
@@ -94,6 +96,7 @@ its CSS out of the build with it (`sideEffects`). gzip of the minified file, as
|
|
|
94
96
|
| 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 |
|
|
95
97
|
| 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 |
|
|
96
98
|
| 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 |
|
|
99
|
+
| 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 |
|
|
97
100
|
| 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 |
|
|
98
101
|
| 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 |
|
|
99
102
|
| logo-sheet | `@gemboss/ui/logo-sheet.css` | `packages/ui/src/logo-sheet.css` | `LogoSheet`: one logo as a person judges it, the mark on a checkerboard, the lockup on a light and a dark header, the favicon at its real 32px (unreleased) | 0.5 KB | `LogoSheet` imports it |
|
|
@@ -1008,10 +1011,43 @@ import { ColorControl, EdgeBox, Field, ImageControl, InspectorGroup, PanelAction
|
|
|
1008
1011
|
| `cssUrl` | | `url("…")` for any URL: quoted, `"` and `\` escaped, a control character as a CSS hex escape. Plain TypeScript (also `@gemboss/ui/editor/css-url`), so a server component can call it; `gembossUI.cssUrl` in editor-plain.js writes the same. Use it for your own image cells (the admin's library grid does). |
|
|
1009
1012
|
| `swatchState` | | The one rule for what `<input type="color">` can show. Also `@gemboss/ui/editor/swatch` (plain TypeScript, for node). |
|
|
1010
1013
|
|
|
1011
|
-
Two modules behind the entry (`panel`, `controls`), both `"use client"`. Kept in the admin, on purpose: the
|
|
1012
|
-
|
|
1013
|
-
|
|
1014
|
-
|
|
1014
|
+
Two modules behind the entry (`panel`, `controls`), both `"use client"`. Kept in the admin, on purpose: the theme job's
|
|
1015
|
+
media library and image generation, the per-breakpoint spacing model. Since 0.20.0 (#3846) the schema's On / Off toggles
|
|
1016
|
+
and the inspector's Visibility (Show / Hide) rows are `Seg` too, so they say `aria-pressed` like every other segmented row.
|
|
1017
|
+
|
|
1018
|
+
### The schema form: `FieldControl`, `FieldRows`, `FieldFrame` (0.65.0)
|
|
1019
|
+
|
|
1020
|
+
One control per kind of setting, the same on every surface of every app (08/11/2026, one control set; moved from the admin's
|
|
1021
|
+
`FieldRenderer.tsx` / `FieldFrame.tsx` with their markup and commit rules). A schema is data (`FieldSpec`, `FieldSchema`: a field's
|
|
1022
|
+
`kind`, `id`, `label`, `hint` and its kind's own keys); the host owns a flat `values` object and gets `onChange(id, value)`.
|
|
1023
|
+
|
|
1024
|
+
```tsx
|
|
1025
|
+
import { FieldFrame, FieldRows, FieldKindsProvider, type FieldSchema } from "@gemboss/ui/editor";
|
|
1026
|
+
|
|
1027
|
+
const schema: FieldSchema = [{ title: "Content", fields: [
|
|
1028
|
+
{ kind: "text", id: "subject", label: "Subject", maxLength: 120 },
|
|
1029
|
+
{ kind: "select", id: "font", label: "Font", options: [{ value: "sans", label: "Sans" }, { value: "serif", label: "Serif" }] },
|
|
1030
|
+
{ kind: "color", id: "bg", label: "Background" },
|
|
1031
|
+
] }];
|
|
1032
|
+
<FieldFrame schema={schema} values={values} onChange={(id, v) => save({ [id]: v })} onChangeMany={(writes) => saveAll(writes)} />
|
|
1033
|
+
// or, inside a group the host draws itself:
|
|
1034
|
+
<InspectorGroup collapsible={false} title="Content"><FieldRows fields={schema[0]!.fields} values={values} onChange={write} /></InspectorGroup>
|
|
1035
|
+
```
|
|
1036
|
+
|
|
1037
|
+
| Piece | What it does |
|
|
1038
|
+
|---|---|
|
|
1039
|
+
| The kit's kinds | `text` · `textarea` · `number` (a draft, committed on blur or Enter; numbers clamped to `min` / `max`, the bounds said under the box) · `range` · `select` (a stored value it does not offer shown as itself; "Not set" while nothing is stored) · `segmented` (chips where they fit the row's control column, `chipsFitBeside`, else a list) · `toggle` (On / Off) · `color` (`ColorControl`, with the host's chips from `ColorChoicesContext`) · `image` · `repeater`. Each in a `Field` whose `control` is `controlOf(field)`, so its label is on the side the `LABEL_SIDE` table says. |
|
|
1040
|
+
| `FieldControl` | One field. `labelHidden`, `invalid`, `inputId`, `mark` + `describedBy`, `labelMark`, `colorDrafts`, `onDraft`, `onPickImage`, `onBlurCapture`. |
|
|
1041
|
+
| `FieldRows` | A group's fields with the label on one side for the run (`firstSideFirst`); `off` + `offWhy` lock fields and say why; `idPrefix` for a form mounted twice. |
|
|
1042
|
+
| `FieldRenderer` | A schema as a flat run of static titled groups. |
|
|
1043
|
+
| `FieldFrame`, `PartsFrame`, `usePartHits` | The schema in the settings frame (`InspectorFrame`): each field where the element panel puts the same setting when you pass `places` (`STYLE_FRAME_PLACES`, the admin's; by default, `OWN_FRAME_PLACES`, every group is your schema's own, open in Look), + and − groups (`groupState`, `knobHolds`, `knobClearWrites`, one `onChangeMany` write per −), a search shown in place (`settingMatches`). Host parts (`own`, `place`, `who`, `code`) are drawn first in their cluster. |
|
|
1044
|
+
| An app's kinds | `kinds={{ myKind: { control: "date", render: (p) => <MyField id={p.id} label={p.label} value={p.value} onCommit={p.onChange} /> } }}` on any of the above, or once with `FieldKindsProvider`. `control` is the table's name (or a function of the field and value); `spread` describes a kind over several stored settings (read, write only what changed, holds, clear). A kind for a kit kind takes its place, and `p.base()` draws the kit's own (a colour that is sometimes a gradient). The admin registers its value presets, date, link, edges, screens, font and gradient colour this way (`FieldRenderer.tsx` `ADMIN_KINDS`). |
|
|
1045
|
+
| A kind no one draws | A visible line, "No control draws “x” settings here." (`[data-unknown-kind]`), never a text box that seems to work. |
|
|
1046
|
+
| `glyphs` | `(name) => node`: the picture a choice's `glyph` is drawn as; a name it does not draw shows the choice's words. |
|
|
1047
|
+
|
|
1048
|
+
`@gemboss/ui/editor/field-spec` is the schema with no React and no import of another module (a node test can read it as it is):
|
|
1049
|
+
types, `labelize`, the fit (`segmentable`, `labelWidthPx`, the column widths), `firstSideFirst`, the knob rules, the frame's groups and
|
|
1050
|
+
its search. `@gemboss/ui/editor/color-choices` is `ColorChoicesContext` alone.
|
|
1015
1051
|
|
|
1016
1052
|
### Plain HTML: `initEditorPanel()`
|
|
1017
1053
|
|
|
@@ -2895,6 +2931,9 @@ gem.destroy(); // the layer leaves the page
|
|
|
2895
2931
|
them (one empty block after its last section), so its footer moves down instead of being drawn over. `apply`: a tick. `check`: QA
|
|
2896
2932
|
sweeps a scan line down the screen. `fail`: Gem and the ring turn red for 2.4 s, the words go back. `land`: what changed lights up
|
|
2897
2933
|
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.
|
|
2934
|
+
- **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.
|
|
2935
|
+
- **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.
|
|
2936
|
+
- **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.
|
|
2898
2937
|
- **`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).
|
|
2899
2938
|
- **Targets by stable ids only**: `[data-gem-el-id]`, then `[data-gem-section-id]`, the first match that has a box (a custom-liquid
|
|
2900
2939
|
section is a `display: contents` wrapper around an inner section with the same id; `find` replaces the lookup). **The ladder**: an
|
|
@@ -3109,6 +3148,61 @@ draw their pictures and figures from here, so one change moves both. Their own e
|
|
|
3109
3148
|
sentence, its one button at the end (`<Notice action={<button className="ui-btn">Turn off</button>}>… no difference for 30 days.</Notice>`).
|
|
3110
3149
|
No tone is a card on the page's ground; `tone` takes the core notice's colours.
|
|
3111
3150
|
|
|
3151
|
+
## Audiences (05/11/2026, unreleased): `AudiencesTable`, a store's audiences
|
|
3152
|
+
|
|
3153
|
+
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
|
|
3154
|
+
05/11/2026: one word and one list, Audiences). GemReach's own admin lists a brand's with the same columns, in its own words. Built on
|
|
3155
|
+
`IndexTable`: the whole row opens the audience, the row folds into a list below 768 of its container, and loading and empty are the
|
|
3156
|
+
table's own states. Its own entry, `@gemboss/ui/audiences-table.css`, imported by the component.
|
|
3157
|
+
|
|
3158
|
+
```tsx
|
|
3159
|
+
<AudiencesTable linkAs={Link} flush rows={[
|
|
3160
|
+
{ id: "quiz-dry", name: "Quiz: dry skin", source: "site", sync: "synced 4 min ago", onSite: 1240, canEmail: 412,
|
|
3161
|
+
delta: "+40%", usedBy: "Flow: Quiz result · Campaign: Dry skin bundle", href: "/app/reach/audiences/quiz-dry" },
|
|
3162
|
+
]} />
|
|
3163
|
+
```
|
|
3164
|
+
|
|
3165
|
+
- Columns, in the board's order: Audience (the name; under it the source as a chip, `site` "On site + email" | `email` "Email only" |
|
|
3166
|
+
`imported` | `gemcare`, and `sync`, how fresh it is), On site (a dash when `onSite` is null), Can email (in ink: the figure that matters),
|
|
3167
|
+
7 days, Used by (muted, cut with an ellipsis).
|
|
3168
|
+
- Counts are numbers, written with grouped thousands (`audienceCount`). The week's change is the caller's words ("+40%", "+4", "−3%", "—");
|
|
3169
|
+
`audienceDeltaTone` reads its sign (green up, red down, muted flat), and `deltaTone` overrides it.
|
|
3170
|
+
- `labels` takes other words, the source names included (`AUDIENCES_TABLE_LABELS` holds the English defaults; GemReach's admin says People
|
|
3171
|
+
and Live rules). `audiencesTableColumns` and `audiencesTableRows` are the same pieces for a surface that draws its own `IndexTable`, and `AudienceSourceChip` is the chip on its own, for an audience's page.
|
|
3172
|
+
|
|
3173
|
+
## Email editor (05/11/2026, unreleased): `EmailEditor`, `EmailPreview`, and GemReach's blocks
|
|
3174
|
+
|
|
3175
|
+
Chris approved the email editor on canvas JQkjqVVb (05/11/2026): the page editor's layout, every editor's (one left column, Chat ·
|
|
3176
|
+
Sections · Settings, the chat a tab kept mounted; "+" adds, nothing is dragged; no right inspector). GemBoss draws it in the funnel
|
|
3177
|
+
(`/app/reach/emails/[id]/edit`), and GemReach's admin can take the same component for its own (admin/src/pages/EmailEditor.tsx).
|
|
3178
|
+
|
|
3179
|
+
```tsx
|
|
3180
|
+
import { EmailEditor } from "@gemboss/ui/email-editor"; // brings editor.css and email-editor.css
|
|
3181
|
+
import { emailChecks, type EmailDraft } from "@gemboss/ui/email-editor/model"; // pure: a server or a test reads it
|
|
3182
|
+
|
|
3183
|
+
<EmailEditor draft={draft} onChange={setDraft} brand={brandKit}
|
|
3184
|
+
back={{ place: "Night Serum funnel", href: "/app/funnels?open=cmp_1", as: Link }}
|
|
3185
|
+
chat={<YourAssistantChat />} people={[{ id: "anna", label: "Anna · bought 23 days ago", data: { first_name: "Anna" } }]}
|
|
3186
|
+
productsFor={(person, source) => products} opens="Refill page, built for each buyer"
|
|
3187
|
+
saveState={saveState} dirty={draft !== saved} onSave={save} onSendTest={sendTest} />
|
|
3188
|
+
```
|
|
3189
|
+
|
|
3190
|
+
- **The body is GemReach's** (`EmailDraft.body` = its `Block[]`, field for field): a body saved here is one GemReach renders. Two
|
|
3191
|
+
kinds are proposals until GemReach has them: `products` (`source`: order, cart, viewed) and `review`. Kinds the "+" offers, in the
|
|
3192
|
+
board's order: Logo (`header`), Image, Heading + text (`hero` without a picture), Products, Button, Review ask, Footer. Other
|
|
3193
|
+
GemReach kinds load and draw; their settings stay in GemReach for now.
|
|
3194
|
+
- **Personal link**: a button whose url is `{{funnel_url}}` opens a page built for each person (GemReach signs it while building the
|
|
3195
|
+
mail, 72 hours, no address in it); its row and its settings say so with a chip.
|
|
3196
|
+
- **Checks**: `emailChecks(draft, brand, data)` runs 18 of GemReach's checks by their ids and names (src/templates/check-ids.ts); the
|
|
3197
|
+
pill says "18 of 18 checks pass" and opens the list (`StatusList`). Pass the server's with `checks`.
|
|
3198
|
+
- **The preview** is drawn from the blocks for one person (`people`), in the brand's colours, Desktop 600 / Mobile 375, Dark. It is
|
|
3199
|
+
not GemReach's sent HTML: pass that as `sent={{ html, loading, error }}` (GemReach's preview route) and the bar offers **As sent**,
|
|
3200
|
+
which shows it read-only in a frame sandboxed with nothing allowed (no script, no form, not the page's origin).
|
|
3201
|
+
- **`actions`**: the surface's own buttons, between "Send me a test" and Save (GemBoss passes "Approve v3" to a Manager or the Owner
|
|
3202
|
+
only; the editor holds no role rule). A check's `severity` (`error` stops the approval, `warning` is a look) colours its line.
|
|
3203
|
+
- Classes: `gb-emailed-*` (the editor), `gb-email-*` (the mail); every one drawn is styled by `email-editor.css`
|
|
3204
|
+
(`email-editor.test.tsx`).
|
|
3205
|
+
|
|
3112
3206
|
## Members (04/11/2026, unreleased): `MembersPage`, one members list for every service
|
|
3113
3207
|
|
|
3114
3208
|
Chris approved the pattern on 04/11/2026 (design "GemBoss Members Pattern"): GemCommunity Admin › Members, GemCare People and
|
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.65.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";
|
package/catalog/index.html
CHANGED
|
@@ -27,7 +27,7 @@ body{margin:0;background:var(--gemboss-app-bg,#f1f1f1);color:var(--gemboss-text)
|
|
|
27
27
|
@media (max-width:760px){.cat{grid-template-columns:1fr;padding:16px}.cat-nav{position:static;flex-direction:row;flex-wrap:wrap}}
|
|
28
28
|
</style></head><body>
|
|
29
29
|
<div class="cat"><nav class="cat-nav" aria-label="Mục"><a href="#tokens">Token</a><a href="#buttons">Nút</a><a href="#fields">Ô nhập</a><a href="#choice">Tab, nhóm nút, thẻ</a><a href="#surfaces">Thẻ, số liệu, bảng, trạng thái trống</a><a href="#report">Báo cáo</a><a href="#collections">Bảng, list, lưới, board</a><a href="#resizer">Thanh kéo giữa hai cột</a><a href="#modal">Hộp thoại, toast, menu (JS thuần)</a><a href="#sheet">Ngăn trượt cạnh phải</a><a href="#reader">Hộp đọc tài liệu</a><a href="#settings">Hộp cài đặt</a><a href="#switcher">Chuyển dịch vụ</a><a href="#shell">Khung app</a><a href="#nav">Chờ điều hướng</a><a href="#page">Bề rộng nội dung</a><a href="#portal">Cổng công khai: tab trên topbar, tìm kiếm, sáng / tối, người dẫn đầu</a><a href="#site">Trang công khai: thanh trên, logo cỡ site, nút, chân trang</a><a href="#auth">Đăng nhập</a><a href="#setup">Hướng dẫn thiết lập</a><a href="#chat">Thân chat</a><a href="#reactions">Reactions</a><a href="#team-chat">Chat đội</a><a href="#action-card">Thẻ hành động</a><a href="#assistant-engine">Trợ lý: chọn engine</a><a href="#assistant-bridge">Trợ lý: cầu nối trên máy (0.32.0)</a><a href="#assistant-chat">Trợ lý: khung chat (0.29.0)</a><a href="#assistant">Trợ lý: cột phiên</a><a href="#icons">Icon</a><a href="#editor">Editor</a></nav>
|
|
30
|
-
<main><header class="cat-head"><h1>@gemboss/ui 0.
|
|
30
|
+
<main><header class="cat-head"><h1>@gemboss/ui 0.65.0</h1><p>Ngôn ngữ thiết kế chung của các công cụ GemBoss. Markup dưới mỗi ví dụ là đúng thứ package render ra; bề mặt không dùng React (HTML tĩnh, Python) chép markup này và nạp <code>gemboss-ui.css</code>. Dựng từ gemboss <code>36d7725f67f8</code>.</p></header>
|
|
31
31
|
<section id="tokens"><h2>Token</h2><p>Đổi giao diện một bề mặt bằng cách đặt lại token, không viết đè class. Tên và giá trị đọc thẳng từ gemboss-ui.css.</p><div class="cat-swatches"><div class="cat-swatch"><i style="background:var(--gemboss-primary)"></i><code>--gemboss-primary</code><span>#1b1c1e</span></div><div class="cat-swatch"><i style="background:var(--gemboss-primary-dark)"></i><code>--gemboss-primary-dark</code><span>#000000</span></div><div class="cat-swatch"><i style="background:var(--gemboss-primary-soft)"></i><code>--gemboss-primary-soft</code><span>#f2f3f5</span></div><div class="cat-swatch"><i style="background:var(--gemboss-accent)"></i><code>--gemboss-accent</code><span>#5661f5</span></div><div class="cat-swatch"><i style="background:var(--gemboss-accent-strong)"></i><code>--gemboss-accent-strong</code><span>#3a44de</span></div><div class="cat-swatch"><i style="background:var(--gemboss-accent-soft)"></i><code>--gemboss-accent-soft</code><span>#eef0fe</span></div><div class="cat-swatch"><i style="background:var(--gemboss-accent-wash)"></i><code>--gemboss-accent-wash</code><span>#f7f8ff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-accent-tint)"></i><code>--gemboss-accent-tint</code><span>#dfe2ff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-accent-mid)"></i><code>--gemboss-accent-mid</code><span>#c9cffd</span></div><div class="cat-swatch"><i style="background:var(--gemboss-text-strong)"></i><code>--gemboss-text-strong</code><span>#1b1c1e</span></div><div class="cat-swatch"><i style="background:var(--gemboss-text)"></i><code>--gemboss-text</code><span>#1b1c1e</span></div><div class="cat-swatch"><i style="background:var(--gemboss-text-muted)"></i><code>--gemboss-text-muted</code><span>#686b71</span></div><div class="cat-swatch"><i style="background:var(--gemboss-surface)"></i><code>--gemboss-surface</code><span>#ffffff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-canvas)"></i><code>--gemboss-canvas</code><span>#ffffff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-preview-canvas)"></i><code>--gemboss-preview-canvas</code><span>#eceef1</span></div><div class="cat-swatch"><i style="background:var(--gemboss-rail-bg)"></i><code>--gemboss-rail-bg</code><span>#ffffff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-panel-bg)"></i><code>--gemboss-panel-bg</code><span>#ffffff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-divider)"></i><code>--gemboss-divider</code><span>#e5e7ea</span></div><div class="cat-swatch"><i style="background:var(--gemboss-divider-soft)"></i><code>--gemboss-divider-soft</code><span>#edeff2</span></div><div class="cat-swatch"><i style="background:var(--gemboss-hover)"></i><code>--gemboss-hover</code><span>#eceef2</span></div><div class="cat-swatch"><i style="background:var(--gemboss-active-bg)"></i><code>--gemboss-active-bg</code><span>#f0f1f4</span></div><div class="cat-swatch"><i style="background:var(--gemboss-active-fg)"></i><code>--gemboss-active-fg</code><span>#1b1c1e</span></div><div class="cat-swatch"><i style="background:var(--gemboss-danger)"></i><code>--gemboss-danger</code><span>#d72c0d</span></div><div class="cat-swatch"><i style="background:var(--gemboss-danger-strong)"></i><code>--gemboss-danger-strong</code><span>#b42318</span></div><div class="cat-swatch"><i style="background:var(--gemboss-danger-soft)"></i><code>--gemboss-danger-soft</code><span>#fff0e9</span></div><div class="cat-swatch"><i style="background:var(--gemboss-danger-border)"></i><code>--gemboss-danger-border</code><span>#f5c9bc</span></div><div class="cat-swatch"><i style="background:var(--gemboss-success)"></i><code>--gemboss-success</code><span>#007f5f</span></div><div class="cat-swatch"><i style="background:var(--gemboss-success-strong)"></i><code>--gemboss-success-strong</code><span>#0a6a4c</span></div><div class="cat-swatch"><i style="background:var(--gemboss-success-soft)"></i><code>--gemboss-success-soft</code><span>#e3f1df</span></div><div class="cat-swatch"><i style="background:var(--gemboss-success-border)"></i><code>--gemboss-success-border</code><span>#b7dfcd</span></div><div class="cat-swatch"><i style="background:var(--gemboss-warning)"></i><code>--gemboss-warning</code><span>#9a6700</span></div><div class="cat-swatch"><i style="background:var(--gemboss-warning-soft)"></i><code>--gemboss-warning-soft</code><span>#fff8e0</span></div><div class="cat-swatch"><i style="background:var(--gemboss-warning-border)"></i><code>--gemboss-warning-border</code><span>#f5d569</span></div><div class="cat-swatch"><i style="background:var(--gemboss-dark-bg)"></i><code>--gemboss-dark-bg</code><span>#0a0a0c</span></div><div class="cat-swatch"><i style="background:var(--gemboss-dark-rail)"></i><code>--gemboss-dark-rail</code><span>#0e0e11</span></div><div class="cat-swatch"><i style="background:var(--gemboss-dark-surface)"></i><code>--gemboss-dark-surface</code><span>#16161a</span></div><div class="cat-swatch"><i style="background:var(--gemboss-dark-surface-2)"></i><code>--gemboss-dark-surface-2</code><span>#1e1e24</span></div><div class="cat-swatch"><i style="background:var(--gemboss-dark-divider)"></i><code>--gemboss-dark-divider</code><span>#2a2a31</span></div><div class="cat-swatch"><i style="background:var(--gemboss-dark-text)"></i><code>--gemboss-dark-text</code><span>#ededf0</span></div><div class="cat-swatch"><i style="background:var(--gemboss-dark-muted)"></i><code>--gemboss-dark-muted</code><span>#9a9aa4</span></div><div class="cat-swatch"><i style="background:var(--gemboss-field-bg)"></i><code>--gemboss-field-bg</code><span>#fdfdfd</span></div><div class="cat-swatch"><i style="background:var(--gemboss-field-bg-hover)"></i><code>--gemboss-field-bg-hover</code><span>#fafafa</span></div><div class="cat-swatch"><i style="background:var(--gemboss-field-ink)"></i><code>--gemboss-field-ink</code><span>#303030</span></div><div class="cat-swatch"><i style="background:var(--gemboss-field-placeholder)"></i><code>--gemboss-field-placeholder</code><span>#616161</span></div><div class="cat-swatch"><i style="background:var(--gemboss-field-line)"></i><code>--gemboss-field-line</code><span>#8a8a8a</span></div><div class="cat-swatch"><i style="background:var(--gemboss-field-line-hover)"></i><code>--gemboss-field-line-hover</code><span>#616161</span></div><div class="cat-swatch"><i style="background:var(--gemboss-field-line-active)"></i><code>--gemboss-field-line-active</code><span>#1a1a1a</span></div><div class="cat-swatch"><i style="background:var(--gemboss-chip-ink)"></i><code>--gemboss-chip-ink</code><span>#303633</span></div><div class="cat-swatch"><i style="background:var(--gemboss-chip-line)"></i><code>--gemboss-chip-line</code><span>#cfd6ce</span></div><div class="cat-swatch"><i style="background:var(--gemboss-chip-line-hover)"></i><code>--gemboss-chip-line-hover</code><span>#aab4ad</span></div><div class="cat-swatch"><i style="background:var(--gemboss-chip-bg-hover)"></i><code>--gemboss-chip-bg-hover</code><span>#f6f7f5</span></div><div class="cat-swatch"><i style="background:var(--gemboss-on-primary)"></i><code>--gemboss-on-primary</code><span>#ffffff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-app-bg)"></i><code>--gemboss-app-bg</code><span>#ffffff</span></div><div class="cat-swatch"><i style="background:var(--gemboss-fill-tertiary)"></i><code>--gemboss-fill-tertiary</code><span>#2a2b33</span></div><div class="cat-swatch"><i style="background:var(--gemboss-fill-tertiary-hover)"></i><code>--gemboss-fill-tertiary-hover</code><span>#33353f</span></div><div class="cat-swatch"><i style="background:var(--gemboss-fill-tertiary-active)"></i><code>--gemboss-fill-tertiary-active</code><span>#3a3c46</span></div></div><table class="ui-table cat-scale"><thead><tr><th>Token</th><th>Giá trị</th><th>Mẫu</th></tr></thead><tbody><tr><td><code>--gemboss-fs-micro</code></td><td>11px</td><td style="font-size:var(--gemboss-fs-micro)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-fs-caption</code></td><td>12px</td><td style="font-size:var(--gemboss-fs-caption)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-fs-body</code></td><td>14px</td><td style="font-size:var(--gemboss-fs-body)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-fs-body-lg</code></td><td>16px</td><td style="font-size:var(--gemboss-fs-body-lg)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-fs-h3</code></td><td>16px</td><td style="font-size:var(--gemboss-fs-h3)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-fs-h2</code></td><td>20px</td><td style="font-size:var(--gemboss-fs-h2)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-fs-h1</code></td><td>24px</td><td style="font-size:var(--gemboss-fs-h1)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-fs-display</code></td><td>30px</td><td style="font-size:var(--gemboss-fs-display)">Ngôn ngữ thiết kế chung</td></tr><tr><td><code>--gemboss-radius-xs</code></td><td>4px</td><td><i class="cat-radius" style="border-radius:var(--gemboss-radius-xs)"></i></td></tr><tr><td><code>--gemboss-radius-sm</code></td><td>6px</td><td><i class="cat-radius" style="border-radius:var(--gemboss-radius-sm)"></i></td></tr><tr><td><code>--gemboss-radius-md</code></td><td>8px</td><td><i class="cat-radius" style="border-radius:var(--gemboss-radius-md)"></i></td></tr><tr><td><code>--gemboss-radius-lg</code></td><td>12px</td><td><i class="cat-radius" style="border-radius:var(--gemboss-radius-lg)"></i></td></tr><tr><td><code>--gemboss-radius-xl</code></td><td>16px</td><td><i class="cat-radius" style="border-radius:var(--gemboss-radius-xl)"></i></td></tr><tr><td><code>--gemboss-radius-2xl</code></td><td>20px</td><td><i class="cat-radius" style="border-radius:var(--gemboss-radius-2xl)"></i></td></tr><tr><td><code>--gemboss-radius-full</code></td><td>999px</td><td><i class="cat-radius" style="border-radius:var(--gemboss-radius-full)"></i></td></tr><tr><td><code>--gemboss-shadow-resting</code></td><td class="cat-small">0 1px 2px rgba(31, 30, 29, 0.04), 0 2px 6px rgba(31, 30, 29, 0.06)</td><td><i class="cat-radius" style="box-shadow:var(--gemboss-shadow-resting);border:0"></i></td></tr><tr><td><code>--gemboss-shadow-raised</code></td><td class="cat-small">0 4px 16px rgba(31, 30, 29, 0.10)</td><td><i class="cat-radius" style="box-shadow:var(--gemboss-shadow-raised);border:0"></i></td></tr><tr><td><code>--gemboss-shadow-overlay</code></td><td class="cat-small">0 16px 48px rgba(31, 30, 29, 0.18)</td><td><i class="cat-radius" style="box-shadow:var(--gemboss-shadow-overlay);border:0"></i></td></tr></tbody></table></section>
|
|
32
32
|
<section id="buttons"><h2>Nút</h2><p>Một lớp <code>ui-btn</code>, ba biến thể, tông đỏ, một cỡ nhỏ. Cao 28px dưới chuột như Button của Polaris (ô nhập và ô chọn 32, như TextField), 44px dưới ngón tay và ở khổ điện thoại, cỡ nhỏ cũng vậy. Dùng được trên <code><button></code> lẫn <code><a></code> (căn giữa sẵn).</p><figure class="cat-demo"><figcaption>Mặc định · chính · ghost · nhỏ · tắt</figcaption><div class="cat-live"><div class="cat-row"><button type="button" class="ui-btn">Lưu nháp</button><button type="button" class="ui-btn ui-btn--primary">Xuất bản</button><button type="button" class="ui-btn ui-btn--ghost">Huỷ</button><button type="button" class="ui-btn ui-btn--sm">Nhỏ</button><button type="button" class="ui-btn ui-btn--primary" disabled>Đang lưu…</button><a class="ui-btn" href="#buttons">Link dạng nút</a></div></div><details class="cat-code"><summary>Markup</summary><pre><code><div class="cat-row">
|
|
33
33
|
<button type="button" class="ui-btn">Lưu nháp</button>
|
|
@@ -13032,7 +13032,7 @@ document.querySelector(".gb-tc-body").append(tc.jumpToLatest({ count:
|
|
|
13032
13032
|
</section>
|
|
13033
13033
|
</div>
|
|
13034
13034
|
</div></code></pre></details></figure></section>
|
|
13035
|
-
<section id="assistant"><h2>Trợ lý: cột phiên</h2><p><code>SessionRail</code> (React). Khung toàn màn hình / cửa sổ nổi / cột phải cao hết màn (<code>allowSide</code>) / thanh là <code>AssistantHost</code>, cần React vì có trạng thái.</p><figure class="cat-demo"><figcaption>SessionRail</figcaption><div class="cat-live"><div style="height:360px;display:flex"><aside class="gemboss-assistant-rail"><div class="gemboss-assistant-rail-top"><button type="button" class="gemboss-assistant-newchat" title="Phiên mới"><svg viewBox="0 0 20 20" aria-hidden="true" focusable="false"><g fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"><path d="M11 4H5.5A1.5 1.5 0 0 0 4 5.5v9A1.5 1.5 0 0 0 5.5 16h9a1.5 1.5 0 0 0 1.5-1.5V9"></path><path d="M14.5 3.5l2 2L10 12H8v-2z"></path></g></svg><span>Phiên mới</span></button><button type="button" class="gemboss-assistant-collapse" aria-label="Collapse sidebar" title="Collapse"><svg viewBox="0 0 20 20" aria-hidden="true" focusable="false"><g fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"><path d="M12 5l-5 5 5 5"></path></g></svg></button></div><div class="gemboss-assistant-search gemboss-field gemboss-field--group"><svg viewBox="0 0 20 20" aria-hidden="true" focusable="false"><g fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"><circle cx="9" cy="9" r="5"></circle><path d="M13 13l3.5 3.5"></path></g></svg><input class="gemboss-field__bare" placeholder="Tìm phiên…" aria-label="Search history" value=""/><kbd class="gemboss-assistant-kbd">/</kbd></div><div class="gemboss-assistant-threads"><div class="gemboss-assistant-group"><div class="gemboss-assistant-group-label">Đã ghim</div><div class="gemboss-assistant-thread"><button type="button" class="gemboss-assistant-thread-main" title="So sánh advertorial với listicle"><span class="gemboss-assistant-thread-titlerow"><svg viewBox="0 0 20 20" class="gemboss-assistant-pin-dot" aria-hidden="true" focusable="false"><path d="M8 3.5h4l-.5 5 2.5 2.5H6l2.5-2.5z" fill="currentColor"></path><path d="M10 11v5.5" stroke="currentColor" stroke-width="1.6" stroke-linecap="round"></path></svg><span class="gemboss-assistant-thread-title">So sánh advertorial với listicle</span></span><span class="gemboss-assistant-thread-meta">29/9/2026</span></button><div class="gemboss-assistant-thread-actions"><button type="button" class="gemboss-assistant-thread-act" aria-label="Options"><svg viewBox="0 0 20 20" aria-hidden="true" focusable="false"><g fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"><circle cx="5" cy="10" r=".8"></circle><circle cx="10" cy="10" r=".8"></circle><circle cx="15" cy="10" r=".8"></circle></g></svg></button></div></div></div><div class="gemboss-assistant-group"><div class="gemboss-assistant-group-label">Hôm
|
|
13035
|
+
<section id="assistant"><h2>Trợ lý: cột phiên</h2><p><code>SessionRail</code> (React). Khung toàn màn hình / cửa sổ nổi / cột phải cao hết màn (<code>allowSide</code>) / thanh là <code>AssistantHost</code>, cần React vì có trạng thái.</p><figure class="cat-demo"><figcaption>SessionRail</figcaption><div class="cat-live"><div style="height:360px;display:flex"><aside class="gemboss-assistant-rail"><div class="gemboss-assistant-rail-top"><button type="button" class="gemboss-assistant-newchat" title="Phiên mới"><svg viewBox="0 0 20 20" aria-hidden="true" focusable="false"><g fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"><path d="M11 4H5.5A1.5 1.5 0 0 0 4 5.5v9A1.5 1.5 0 0 0 5.5 16h9a1.5 1.5 0 0 0 1.5-1.5V9"></path><path d="M14.5 3.5l2 2L10 12H8v-2z"></path></g></svg><span>Phiên mới</span></button><button type="button" class="gemboss-assistant-collapse" aria-label="Collapse sidebar" title="Collapse"><svg viewBox="0 0 20 20" aria-hidden="true" focusable="false"><g fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"><path d="M12 5l-5 5 5 5"></path></g></svg></button></div><div class="gemboss-assistant-search gemboss-field gemboss-field--group"><svg viewBox="0 0 20 20" aria-hidden="true" focusable="false"><g fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"><circle cx="9" cy="9" r="5"></circle><path d="M13 13l3.5 3.5"></path></g></svg><input class="gemboss-field__bare" placeholder="Tìm phiên…" aria-label="Search history" value=""/><kbd class="gemboss-assistant-kbd">/</kbd></div><div class="gemboss-assistant-threads"><div class="gemboss-assistant-group"><div class="gemboss-assistant-group-label">Đã ghim</div><div class="gemboss-assistant-thread"><button type="button" class="gemboss-assistant-thread-main" title="So sánh advertorial với listicle"><span class="gemboss-assistant-thread-titlerow"><svg viewBox="0 0 20 20" class="gemboss-assistant-pin-dot" aria-hidden="true" focusable="false"><path d="M8 3.5h4l-.5 5 2.5 2.5H6l2.5-2.5z" fill="currentColor"></path><path d="M10 11v5.5" stroke="currentColor" stroke-width="1.6" stroke-linecap="round"></path></svg><span class="gemboss-assistant-thread-title">So sánh advertorial với listicle</span></span><span class="gemboss-assistant-thread-meta">29/9/2026</span></button><div class="gemboss-assistant-thread-actions"><button type="button" class="gemboss-assistant-thread-act" aria-label="Options"><svg viewBox="0 0 20 20" aria-hidden="true" focusable="false"><g fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"><circle cx="5" cy="10" r=".8"></circle><circle cx="10" cy="10" r=".8"></circle><circle cx="15" cy="10" r=".8"></circle></g></svg></button></div></div></div><div class="gemboss-assistant-group"><div class="gemboss-assistant-group-label">Hôm nay</div><div class="gemboss-assistant-thread active"><button type="button" class="gemboss-assistant-thread-main" title="Store nào đang dựng loạt landing?"><span class="gemboss-assistant-thread-titlerow"><span class="gemboss-assistant-thread-title">Store nào đang dựng loạt landing?</span></span><span class="gemboss-assistant-thread-meta">3 giờ trước</span></button><div class="gemboss-assistant-thread-actions"><button type="button" class="gemboss-assistant-thread-act" aria-label="Options"><svg viewBox="0 0 20 20" aria-hidden="true" focusable="false"><g fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"><circle cx="5" cy="10" r=".8"></circle><circle cx="10" cy="10" r=".8"></circle><circle cx="15" cy="10" r=".8"></circle></g></svg></button></div></div></div><div class="gemboss-assistant-group"><div class="gemboss-assistant-group-label">Hôm qua</div><div class="gemboss-assistant-thread"><button type="button" class="gemboss-assistant-thread-main" title="Landing điểm cao nhất của corpus"><span class="gemboss-assistant-thread-titlerow"><span class="gemboss-assistant-thread-title">Landing điểm cao nhất của corpus</span></span><span class="gemboss-assistant-thread-meta">1 ngày trước</span></button><div class="gemboss-assistant-thread-actions"><button type="button" class="gemboss-assistant-thread-act" aria-label="Options"><svg viewBox="0 0 20 20" aria-hidden="true" focusable="false"><g fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"><circle cx="5" cy="10" r=".8"></circle><circle cx="10" cy="10" r=".8"></circle><circle cx="15" cy="10" r=".8"></circle></g></svg></button></div></div></div></div></aside></div></div><details class="cat-code"><summary>Markup</summary><pre><code><div style="height:360px;display:flex">
|
|
13036
13036
|
<aside class="gemboss-assistant-rail">
|
|
13037
13037
|
<div class="gemboss-assistant-rail-top">
|
|
13038
13038
|
<button type="button" class="gemboss-assistant-newchat" title="Phiên mới">
|
|
@@ -13100,7 +13100,7 @@ document.querySelector(".gb-tc-body").append(tc.jumpToLatest({ count:
|
|
|
13100
13100
|
</div>
|
|
13101
13101
|
</div>
|
|
13102
13102
|
<div class="gemboss-assistant-group">
|
|
13103
|
-
<div class="gemboss-assistant-group-label">Hôm
|
|
13103
|
+
<div class="gemboss-assistant-group-label">Hôm nay</div>
|
|
13104
13104
|
<div class="gemboss-assistant-thread active">
|
|
13105
13105
|
<button type="button" class="gemboss-assistant-thread-main" title="Store nào đang dựng loạt landing?">
|
|
13106
13106
|
<span class="gemboss-assistant-thread-titlerow">
|
|
@@ -13123,25 +13123,28 @@ document.querySelector(".gb-tc-body").append(tc.jumpToLatest({ count:
|
|
|
13123
13123
|
</button>
|
|
13124
13124
|
</div>
|
|
13125
13125
|
</div>
|
|
13126
|
-
<
|
|
13127
|
-
|
|
13128
|
-
|
|
13129
|
-
|
|
13130
|
-
<
|
|
13131
|
-
|
|
13132
|
-
|
|
13133
|
-
|
|
13134
|
-
|
|
13135
|
-
|
|
13136
|
-
|
|
13137
|
-
|
|
13126
|
+
</div>
|
|
13127
|
+
<div class="gemboss-assistant-group">
|
|
13128
|
+
<div class="gemboss-assistant-group-label">Hôm qua</div>
|
|
13129
|
+
<div class="gemboss-assistant-thread">
|
|
13130
|
+
<button type="button" class="gemboss-assistant-thread-main" title="Landing điểm cao nhất của corpus">
|
|
13131
|
+
<span class="gemboss-assistant-thread-titlerow">
|
|
13132
|
+
<span class="gemboss-assistant-thread-title">Landing điểm cao nhất của corpus</span>
|
|
13133
|
+
</span>
|
|
13134
|
+
<span class="gemboss-assistant-thread-meta">1 ngày trước</span>
|
|
13135
|
+
</button>
|
|
13136
|
+
<div class="gemboss-assistant-thread-actions">
|
|
13137
|
+
<button type="button" class="gemboss-assistant-thread-act" aria-label="Options">
|
|
13138
|
+
<svg viewBox="0 0 20 20" aria-hidden="true" focusable="false">
|
|
13139
|
+
<g fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round">
|
|
13140
|
+
<circle cx="5" cy="10" r=".8">
|
|
13141
|
+
</circle>
|
|
13142
|
+
<circle cx="10" cy="10" r=".8">
|
|
13138
13143
|
</circle>
|
|
13139
|
-
<circle cx="
|
|
13144
|
+
<circle cx="15" cy="10" r=".8">
|
|
13140
13145
|
</circle>
|
|
13141
|
-
|
|
13142
|
-
|
|
13143
|
-
</g>
|
|
13144
|
-
</svg>
|
|
13146
|
+
</g>
|
|
13147
|
+
</svg>
|
|
13145
13148
|
</button>
|
|
13146
13149
|
</div>
|
|
13147
13150
|
</div>
|
package/gemboss-ui.css
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
/*
|
|
2
2
|
* GemBoss admin design system — GENERATED — do not edit; regenerate from gemboss:
|
|
3
3
|
* node apps/admin/scripts/export-ui-css.mjs --out <path> (npm run export:ui-css)
|
|
4
|
-
* gemboss commit:
|
|
5
|
-
* sources sha256:
|
|
4
|
+
* gemboss commit: 36d7725f67f8f71b4ae56c870ed6228bdccd2da4
|
|
5
|
+
* sources sha256: e0f8fc90d8d83277a6fc8d237339997de3e704437d263ef4a2a2460ac971b648
|
|
6
6
|
* contents: 1 allow-listed rule from apps/admin/src/app/globals.css + packages/ui/src/gemboss-tokens.css
|
|
7
7
|
* (verbatim) + packages/ui/src/ui.css (verbatim) + packages/ui/src/gemboss-field.css (verbatim)
|
|
8
8
|
* + 184 rules from packages/ui/src/shell.css (the shared shell)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@gemboss/ui",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.65.0",
|
|
4
4
|
"description": "GemBoss design system for every surface in the fleet: the admin shell (topbar + rail + drawer) as React components, and the admin stylesheet exported as one CSS file.",
|
|
5
5
|
"license": "UNLICENSED",
|
|
6
6
|
"type": "module",
|
|
@@ -35,6 +35,7 @@
|
|
|
35
35
|
"./shell-source.css": "./src/shell.css",
|
|
36
36
|
"./chat.css": "./src/chat.css",
|
|
37
37
|
"./chat-composer.css": "./src/chat-composer.css",
|
|
38
|
+
"./chat-voice.css": "./src/chat-voice.css",
|
|
38
39
|
"./editor.css": "./src/editor.css",
|
|
39
40
|
"./editor-repeater.css": "./src/editor-repeater.css",
|
|
40
41
|
"./editor-tiles.css": "./src/editor-tiles.css",
|
|
@@ -45,6 +46,7 @@
|
|
|
45
46
|
"./editor-picker.css": "./src/editor-picker.css",
|
|
46
47
|
"./editor-picker-grid.css": "./src/editor-picker-grid.css",
|
|
47
48
|
"./editor-insert.css": "./src/editor-insert.css",
|
|
49
|
+
"./email-editor.css": "./src/email-editor.css",
|
|
48
50
|
"./narration.css": "./src/narration.css",
|
|
49
51
|
"./editor-rail.css": "./src/editor-rail.css",
|
|
50
52
|
"./rail-mini.css": "./src/rail-mini.css",
|
|
@@ -58,6 +60,7 @@
|
|
|
58
60
|
"./range-bar.css": "./src/range-bar.css",
|
|
59
61
|
"./progress-ring.css": "./src/progress-ring.css",
|
|
60
62
|
"./progress-bar.css": "./src/progress-bar.css",
|
|
63
|
+
"./audiences-table.css": "./src/audiences-table.css",
|
|
61
64
|
"./spot-art.css": "./src/spot-art.css",
|
|
62
65
|
"./kind-art.css": "./src/kind-art.css",
|
|
63
66
|
"./gem-at-work.css": "./src/gem-at-work.css",
|
|
@@ -100,7 +103,11 @@
|
|
|
100
103
|
"./reactions-data": "./src/reactions-data.ts",
|
|
101
104
|
"./members-data": "./src/members-data.ts",
|
|
102
105
|
"./editor": "./src/editor/index.ts",
|
|
106
|
+
"./email-editor": "./src/email-editor/index.ts",
|
|
107
|
+
"./email-editor/model": "./src/email-editor/model.ts",
|
|
103
108
|
"./editor/swatch": "./src/editor/swatch.ts",
|
|
109
|
+
"./editor/field-spec": "./src/editor/field-spec.ts",
|
|
110
|
+
"./editor/color-choices": "./src/editor/color-choices.ts",
|
|
104
111
|
"./segmented": "./src/segmented.tsx",
|
|
105
112
|
"./screens-arriving": "./src/screens-arriving.ts",
|
|
106
113
|
"./gem-holo": "./src/gem-holo.tsx",
|
|
@@ -142,6 +149,7 @@
|
|
|
142
149
|
"./session-rail-plain.js": "./src/session-rail-plain.js",
|
|
143
150
|
"./assistant": "./src/assistant/index.ts",
|
|
144
151
|
"./assistant/dock": "./src/assistant/dock.ts",
|
|
152
|
+
"./assistant/dictation": "./src/assistant/dictation.ts",
|
|
145
153
|
"./assistant/markdown": "./src/assistant/chat-markdown.ts",
|
|
146
154
|
"./assistant/engine-mark-art": "./src/assistant/engine-mark-art.ts",
|
|
147
155
|
"./assistant.css": "./src/assistant.css",
|