@saar-ai/web-widget 0.8.0 → 0.10.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/dist/chunks/{chat-e1afSRBr.js → chat-CU9VPqVO.js} +260 -37
- package/dist/chunks/{host-widget-Ce-l1xu1.js → host-widget-BtiYIMwb.js} +5638 -350
- package/dist/chunks/{schemas-D-uDc-9q.js → schemas-YN3wGSGZ.js} +7 -4
- package/dist/chunks/{telemetry-CBblNC6C.js → telemetry-B1xBTk1s.js} +16 -1
- package/dist/dock/dock-drag.d.ts +5 -5
- package/dist/dock/dock-drag.d.ts.map +1 -1
- package/dist/dock/dock-float.d.ts +116 -0
- package/dist/dock/dock-float.d.ts.map +1 -0
- package/dist/dock/dock-motion.d.ts +61 -6
- package/dist/dock/dock-motion.d.ts.map +1 -1
- package/dist/dock/dock-pill.d.ts +18 -1
- package/dist/dock/dock-pill.d.ts.map +1 -1
- package/dist/dock/dock-row.d.ts +128 -10
- package/dist/dock/dock-row.d.ts.map +1 -1
- package/dist/dock/dock-sheet.d.ts.map +1 -1
- package/dist/dock/dock-state.d.ts +129 -9
- package/dist/dock/dock-state.d.ts.map +1 -1
- package/dist/dock/dock.d.ts +137 -25
- package/dist/dock/dock.d.ts.map +1 -1
- package/dist/dock/geometry.d.ts +129 -3
- package/dist/dock/geometry.d.ts.map +1 -1
- package/dist/generated/widget-css.d.ts.map +1 -1
- package/dist/host-routes.d.ts +187 -0
- package/dist/host-routes.d.ts.map +1 -0
- package/dist/host-widget.d.ts +78 -2
- package/dist/host-widget.d.ts.map +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +4 -3889
- package/dist/messages.d.ts +88 -1
- package/dist/messages.d.ts.map +1 -1
- package/dist/mount.d.ts +10 -1
- package/dist/mount.d.ts.map +1 -1
- package/dist/next/index.js +1 -1
- package/dist/rope-knot.d.ts +67 -0
- package/dist/rope-knot.d.ts.map +1 -1
- package/dist/theme/derive.d.ts +1 -1
- package/dist/theme/derive.d.ts.map +1 -1
- package/dist/use-chat-session.d.ts +87 -33
- package/dist/use-chat-session.d.ts.map +1 -1
- package/dist/use-voice-session.d.ts +13 -8
- package/dist/use-voice-session.d.ts.map +1 -1
- package/dist/voice-widget.d.ts +22 -1
- package/dist/voice-widget.d.ts.map +1 -1
- package/dist/widget-cards.d.ts +21 -1
- package/dist/widget-cards.d.ts.map +1 -1
- package/dist/widget-cart-summary.d.ts +10 -1
- package/dist/widget-cart-summary.d.ts.map +1 -1
- package/dist/widget.css +1 -1
- package/package.json +7 -3
- package/src/styles/concierge.css +528 -65
- package/src/styles/dock-surface.css +284 -0
- package/src/styles/tokens.css +22 -6
- package/src/styles/widget-entry.css +3 -0
|
@@ -562,7 +562,7 @@ var guid = /^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-
|
|
|
562
562
|
/** Returns a regex for validating an RFC 9562/4122 UUID.
|
|
563
563
|
*
|
|
564
564
|
* @param version Optionally specify a version 1-8. If no version is specified, all versions are supported. */
|
|
565
|
-
var uuid = (version) => {
|
|
565
|
+
var uuid$1 = (version) => {
|
|
566
566
|
if (!version) return /^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/;
|
|
567
567
|
return new RegExp(`^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-${version}[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$`);
|
|
568
568
|
};
|
|
@@ -1132,8 +1132,8 @@ var $ZodUUID = /*@__PURE__*/ $constructor("$ZodUUID", (inst, def) => {
|
|
|
1132
1132
|
v8: 8
|
|
1133
1133
|
}[def.version];
|
|
1134
1134
|
if (v === void 0) throw new Error(`Invalid UUID version: "${def.version}"`);
|
|
1135
|
-
def.pattern ?? (def.pattern = uuid(v));
|
|
1136
|
-
} else def.pattern ?? (def.pattern = uuid());
|
|
1135
|
+
def.pattern ?? (def.pattern = uuid$1(v));
|
|
1136
|
+
} else def.pattern ?? (def.pattern = uuid$1());
|
|
1137
1137
|
$ZodStringFormat.init(inst, def);
|
|
1138
1138
|
});
|
|
1139
1139
|
var $ZodEmail = /*@__PURE__*/ $constructor("$ZodEmail", (inst, def) => {
|
|
@@ -3732,6 +3732,9 @@ var ZodUUID = /*@__PURE__*/ $constructor("ZodUUID", (inst, def) => {
|
|
|
3732
3732
|
$ZodUUID.init(inst, def);
|
|
3733
3733
|
ZodStringFormat.init(inst, def);
|
|
3734
3734
|
});
|
|
3735
|
+
function uuid(params) {
|
|
3736
|
+
return /* @__PURE__ */ _uuid(ZodUUID, params);
|
|
3737
|
+
}
|
|
3735
3738
|
var ZodURL = /*@__PURE__*/ $constructor("ZodURL", (inst, def) => {
|
|
3736
3739
|
$ZodURL.init(inst, def);
|
|
3737
3740
|
ZodStringFormat.init(inst, def);
|
|
@@ -4283,4 +4286,4 @@ function superRefine(fn, params) {
|
|
|
4283
4286
|
return /* @__PURE__ */ _superRefine(fn, params);
|
|
4284
4287
|
}
|
|
4285
4288
|
//#endregion
|
|
4286
|
-
export { httpUrl as a, number as c, string as d, discriminatedUnion as i, object as l, array as n, literal as o, boolean as r, looseObject as s, _enum as t, record as u };
|
|
4289
|
+
export { httpUrl as a, number as c, string as d, uuid as f, discriminatedUnion as i, object as l, array as n, literal as o, boolean as r, looseObject as s, _enum as t, record as u };
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { c as number, d as string, i as discriminatedUnion, l as object, o as literal, r as boolean, s as looseObject, t as _enum } from "./schemas-
|
|
1
|
+
import { c as number, d as string, i as discriminatedUnion, l as object, o as literal, r as boolean, s as looseObject, t as _enum } from "./schemas-YN3wGSGZ.js";
|
|
2
2
|
//#region ../widget-protocol/dist/telemetry.js
|
|
3
3
|
/**
|
|
4
4
|
* The voice call's wire contract, as the CALLER's browser sees it: what the
|
|
@@ -173,6 +173,21 @@ var TurnLatencyPayloadSchema = object({
|
|
|
173
173
|
/** Caller stopped speaking → first audio they hear. The felt latency. */
|
|
174
174
|
overallMs: number().nullable(),
|
|
175
175
|
/**
|
|
176
|
+
* Caller stopped speaking → the first ACT that reached their screen: a card
|
|
177
|
+
* ringed, a page opened, a grid narrowed.
|
|
178
|
+
*
|
|
179
|
+
* Not a stage and not part of the sum — an eager act tool runs while the
|
|
180
|
+
* model is still dictating the rest of its sentence, so this can land before
|
|
181
|
+
* `overallMs` and that is the concierge acting while it talks. Above
|
|
182
|
+
* `overallMs` it is a navigation waiting for the clause to finish, which is
|
|
183
|
+
* equally correct. `null` is a turn that only spoke.
|
|
184
|
+
*
|
|
185
|
+
* OPTIONAL, and read defensively: a widget bundle older than this field is
|
|
186
|
+
* the ordinary case for the life of a storefront tab, and a worker older than
|
|
187
|
+
* it simply does not send one.
|
|
188
|
+
*/
|
|
189
|
+
firstActMs: number().nullable().optional(),
|
|
190
|
+
/**
|
|
176
191
|
* The turn tier began generating before the turn was confirmed, so most of
|
|
177
192
|
* `agentMs` hid under `eotMs` and the stages will not sum to `overallMs`.
|
|
178
193
|
*/
|
package/dist/dock/dock-drag.d.ts
CHANGED
|
@@ -53,11 +53,11 @@ export interface DockDragOptions {
|
|
|
53
53
|
* The pill, for rule 4's second half.
|
|
54
54
|
*
|
|
55
55
|
* The container's FLIP cannot express the pill's move: `pillAnchor` decides
|
|
56
|
-
*
|
|
57
|
-
*
|
|
58
|
-
* on top of the container's own move. So the pill is
|
|
59
|
-
* right, before and after, and animated from the real
|
|
60
|
-
* real last one.
|
|
56
|
+
* where inside the container the pill sits (either END, or the middle for
|
|
57
|
+
* centre), and an alignment change moves that too — an untransitionable
|
|
58
|
+
* `left`/`right` change, on top of the container's own move. So the pill is
|
|
59
|
+
* measured in its own right, before and after, and animated from the real
|
|
60
|
+
* first rect to the real last one.
|
|
61
61
|
*/
|
|
62
62
|
readonly pillRef?: RefObject<HTMLElement | null>;
|
|
63
63
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"dock-drag.d.ts","sourceRoot":"","sources":["../../src/dock/dock-drag.ts"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,YAAY,IAAI,iBAAiB,EACtC,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAGf,OAAO,
|
|
1
|
+
{"version":3,"file":"dock-drag.d.ts","sourceRoot":"","sources":["../../src/dock/dock-drag.ts"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,YAAY,IAAI,iBAAiB,EACtC,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAGf,OAAO,EAML,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,WAAW,eAAe;IAC9B,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,2EAA2E;IAC3E,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,mEAAmE;IACnE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;;;;;;;OASG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,cAAc;IAC7B,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,sFAAsF;IACtF,QAAQ,CAAC,YAAY,EAAE,MAAM,OAAO,CAAC;IACrC,4DAA4D;IAC5D,QAAQ,CAAC,WAAW,EAAE;QACpB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;KACjE,CAAC;CACH;AAED,2DAA2D;AAC3D,eAAO,MAAM,QAAQ,iBAAiB,CAAC;AAEvC,wBAAgB,WAAW,CACzB,YAAY,EAAE;IAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;CAAE,EAC7C,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,eAAe,GAChE,cAAc,CAuRhB;AAED,6EAA6E;AAC7E,eAAO,MAAM,kBAAkB,+BAAc,CAAC"}
|
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
import type { DockTurn } from './dock.js';
|
|
2
|
+
/**
|
|
3
|
+
* THE FLOAT — docs/DOCK_SPEC.md §3.5: the last turn, on a small surface above
|
|
4
|
+
* the expanded row.
|
|
5
|
+
*
|
|
6
|
+
* The dock's division of labour is fixed: the CAPTION holds only what is live
|
|
7
|
+
* (the shopper's draft, their partial speech, the concierge's current spoken
|
|
8
|
+
* clause), the VISOR holds history, and this holds the one line between them
|
|
9
|
+
* — the last finished turn, or a text reply as it streams. It is what lets a
|
|
10
|
+
* shopper who never opens the visor still read what was just said, which is
|
|
11
|
+
* why the latest-exchange `peek` view (2026-09-11) could be retired.
|
|
12
|
+
*
|
|
13
|
+
* ## Why it no longer hides on its own (revised 2026-09-16)
|
|
14
|
+
*
|
|
15
|
+
* It used to hide as eagerly as it could: `FLOAT_HIDE_MS` (8 s) after the turn
|
|
16
|
+
* finished, and on any page scroll past `PAGE_SCROLL_DUCK_PX`. The reasoning
|
|
17
|
+
* was §1 rule 3 — the page is the shopper's — and on a real storefront it was
|
|
18
|
+
* backwards. The concierge answers a question ABOUT the page, so reading the
|
|
19
|
+
* page is what the shopper does next, and the scroll that carries them to the
|
|
20
|
+
* product being described was the exact gesture that deleted the description.
|
|
21
|
+
* Eight seconds, meanwhile, is shorter than one paragraph of an answer.
|
|
22
|
+
* Reported straight from the marketing site: "the last turn message should not
|
|
23
|
+
* disappear automatically" (2026-09-16).
|
|
24
|
+
*
|
|
25
|
+
* So the float now lasts until something REPLACES it, and the list is closed:
|
|
26
|
+
*
|
|
27
|
+
* - a NEW turn (the answer it was holding is no longer the last thing said);
|
|
28
|
+
* - the pill (§3.2 — the collapsed form carries nothing else), the visor
|
|
29
|
+
* opening (which already holds the turn), or the caption showing the same
|
|
30
|
+
* words — the three the dock reports through {@link DockFloatProps.suppressed};
|
|
31
|
+
* - the shopper DISMISSING it, which is one turn wide: the next turn is a
|
|
32
|
+
* different answer and shows again;
|
|
33
|
+
* - `FLOAT_DUCK_DISMISS_MS` after a DUCK began.
|
|
34
|
+
*
|
|
35
|
+
* The duck is the only clock, and it is not really a clock: §5.1's `ducked`
|
|
36
|
+
* means the shopper scrolled the merchant's page while the concierge was
|
|
37
|
+
* mid-reply, which the dock has already treated as a barge-in. That is a fact
|
|
38
|
+
* about attention rather than a guess from elapsed time, which is what the
|
|
39
|
+
* 8 s timer was. LEAVING the duck does not bring that turn back — the shopper
|
|
40
|
+
* spoke again, so a new answer is coming and replaying the abandoned one
|
|
41
|
+
* would put a stale line over the page at the worst moment.
|
|
42
|
+
*
|
|
43
|
+
* ## Why it stays mounted
|
|
44
|
+
*
|
|
45
|
+
* Hidden is a data attribute, never an unmount, and the last words are held
|
|
46
|
+
* after the turn itself goes away: §7.2's fade-out needs something to fade.
|
|
47
|
+
* Hidden also means `aria-hidden` and `tabIndex={-1}` — `visibility: hidden`
|
|
48
|
+
* does that in a browser, and the attributes say it for anything that does
|
|
49
|
+
* not apply the stylesheet.
|
|
50
|
+
*
|
|
51
|
+
* ## Why it is a container around one big button
|
|
52
|
+
*
|
|
53
|
+
* §11 — the whole line is the control ("tap opens the visor at `expanded`"),
|
|
54
|
+
* so it is a `<button>` named for what it DOES (`dock_show_conversation`) with
|
|
55
|
+
* its drawn content `aria-hidden`. The line itself is already in the
|
|
56
|
+
* transcript's `role="log"`, which announced it when it arrived; naming the
|
|
57
|
+
* button with it would read the reply a second time.
|
|
58
|
+
*
|
|
59
|
+
* It used to be that button and nothing else. The dismiss is a SECOND control
|
|
60
|
+
* on the same surface, and a `<button>` inside a `<button>` is not something
|
|
61
|
+
* a browser or an accessibility tree can represent — so `.wgt-float` became
|
|
62
|
+
* the container and the line became its child. The two are siblings, which is
|
|
63
|
+
* also why the dismiss cannot accidentally open the visor; it stops
|
|
64
|
+
* propagation anyway, because "this press is not that press" should not
|
|
65
|
+
* depend on a DOM shape a later change could undo.
|
|
66
|
+
*/
|
|
67
|
+
export interface DockFloatProps {
|
|
68
|
+
/** The turn to show. Absent, or empty text, hides the float. */
|
|
69
|
+
readonly turn: DockTurn | undefined;
|
|
70
|
+
/**
|
|
71
|
+
* The dock's own reasons the float must not show right now: the pill form,
|
|
72
|
+
* an open visor, the caption already showing these words.
|
|
73
|
+
*/
|
|
74
|
+
readonly suppressed: boolean;
|
|
75
|
+
/**
|
|
76
|
+
* §5.1's `ducked` — the shopper turned to the page mid-reply.
|
|
77
|
+
*
|
|
78
|
+
* The float goes `FLOAT_DUCK_DISMISS_MS` after this goes true. A duck that
|
|
79
|
+
* ENDS inside the window simply cancels it: nothing was hidden, so there is
|
|
80
|
+
* nothing to bring back.
|
|
81
|
+
*/
|
|
82
|
+
readonly ducked: boolean;
|
|
83
|
+
/**
|
|
84
|
+
* The concierge's display name — the speaker label on its lines, and the
|
|
85
|
+
* FALLBACK for any turn that named no speaker of its own.
|
|
86
|
+
*
|
|
87
|
+
* A turn carrying `speakerName` (§3.5 — an operator's line after a handoff)
|
|
88
|
+
* uses that instead. The fallback is not a degraded case: a tenant who never
|
|
89
|
+
* turned `handoff.showOperatorName` on sends no name on any turn ever, and
|
|
90
|
+
* their shopper keeps reading the concierge's name exactly as they did
|
|
91
|
+
* before the handoff.
|
|
92
|
+
*/
|
|
93
|
+
readonly agentName: string;
|
|
94
|
+
/** `dock_float_you` — the speaker label on the shopper's own line. */
|
|
95
|
+
readonly youLabel: string;
|
|
96
|
+
/** The line button's accessible name (`dock_show_conversation`). */
|
|
97
|
+
readonly label: string;
|
|
98
|
+
/** The dismiss control's accessible name (`dock_float_dismiss`). */
|
|
99
|
+
readonly dismissLabel: string;
|
|
100
|
+
readonly onOpen: () => void;
|
|
101
|
+
/**
|
|
102
|
+
* The shopper pressed the dismiss, and the FOCUS has to go somewhere (§11).
|
|
103
|
+
*
|
|
104
|
+
* The control that was pressed is about to sit inside an `aria-hidden`
|
|
105
|
+
* subtree with `tabIndex={-1}` on it; a real browser drops focus off a
|
|
106
|
+
* `visibility: hidden` element to `<body>`, which is outside the widget
|
|
107
|
+
* entirely. Either way a keyboard or screen-reader user was stranded: the
|
|
108
|
+
* next Tab restarted from the top of the merchant's page.
|
|
109
|
+
*
|
|
110
|
+
* The dock answers with the caption field, which is where a shopper who has
|
|
111
|
+
* just put an answer away is going next anyway.
|
|
112
|
+
*/
|
|
113
|
+
readonly onDismiss?: () => void;
|
|
114
|
+
}
|
|
115
|
+
export declare function DockFloat({ turn, suppressed, ducked, agentName, youLabel, label, dismissLabel, onOpen, onDismiss, }: DockFloatProps): import("react").JSX.Element | null;
|
|
116
|
+
//# sourceMappingURL=dock-float.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dock-float.d.ts","sourceRoot":"","sources":["../../src/dock/dock-float.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAG1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AACH,MAAM,WAAW,cAAc;IAC7B,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB;;;;;;;;;OASG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;IAC5B;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACjC;AA6BD,wBAAgB,SAAS,CAAC,EACxB,IAAI,EACJ,UAAU,EACV,MAAM,EACN,SAAS,EACT,QAAQ,EACR,KAAK,EACL,YAAY,EACZ,MAAM,EACN,SAAS,GACV,EAAE,cAAc,sCA0IhB"}
|
|
@@ -53,6 +53,16 @@ export declare const SHEET_SNAP_MS = 200;
|
|
|
53
53
|
export declare const CAPTION_MS = 160;
|
|
54
54
|
export declare const BORDER_MS = 160;
|
|
55
55
|
export declare const CONTROL_MS = 120;
|
|
56
|
+
/**
|
|
57
|
+
* §3.6's ease INTO glass — the slow half of the surface transition, and the
|
|
58
|
+
* one rule 12 has to be able to cancel.
|
|
59
|
+
*
|
|
60
|
+
* The WAKE is 180 ms and stays in `dock-surface.css` alone: the asymmetry is
|
|
61
|
+
* the design (a deliberate exception to §7.1 rules 1 and 11, user decision
|
|
62
|
+
* 2026-09-15), and TypeScript only needs the number it would collapse to
|
|
63
|
+
* zero. See {@link DockDurations.surface}.
|
|
64
|
+
*/
|
|
65
|
+
export declare const SURFACE_MS = 320;
|
|
56
66
|
/** §7.2 — the waveform's per-frame smoothing. */
|
|
57
67
|
export declare const LEVEL_LERP = 0.25;
|
|
58
68
|
/** §5.5 — a page scroll past this much closes the sheet and ducks a live reply. */
|
|
@@ -78,8 +88,26 @@ export declare const SHEET_DISMISS_FRACTION = 0.4;
|
|
|
78
88
|
*
|
|
79
89
|
* A shopper can turn it on mid-session (iOS has it in Control Center), and a
|
|
80
90
|
* dock that only read it at mount would keep animating for the rest of the
|
|
81
|
-
* page.
|
|
82
|
-
*
|
|
91
|
+
* page. A window with no `matchMedia` at all reads `false`, which is the
|
|
92
|
+
* browser's own default for an unsupported query.
|
|
93
|
+
*
|
|
94
|
+
* `useSyncExternalStore` with a server snapshot, for the reason `useViewport`
|
|
95
|
+
* in `dock.tsx` gives at length: this component is SERVER-RENDERED by every
|
|
96
|
+
* React host it has, and a `useState(() => matchesReducedMotion())`
|
|
97
|
+
* initialiser runs on the HYDRATION render too. A server has no `matchMedia`,
|
|
98
|
+
* so it rendered the animated dock while a reduced-motion client rendered the
|
|
99
|
+
* static one, and since `useDockDurations` writes all five durations as
|
|
100
|
+
* inline custom properties on the dock's own root, the mismatch landed on the
|
|
101
|
+
* first element of the subtree and took the whole widget with it. Reported
|
|
102
|
+
* from the marketing dogfood page as a hydration error on every load
|
|
103
|
+
* (2026-09-17).
|
|
104
|
+
*
|
|
105
|
+
* The server snapshot is `false` — the SAFE-TO-HYDRATE value, not the
|
|
106
|
+
* safe-to-animate one, which is the opposite of how this hook's fallback is
|
|
107
|
+
* chosen. That is deliberate and it costs nothing: the durations are read by
|
|
108
|
+
* the next state CHANGE, and nothing changes in the hydration commit, so a
|
|
109
|
+
* reduced-motion visitor never sees a frame of motion — only a value that is
|
|
110
|
+
* corrected before anything could use it.
|
|
83
111
|
*/
|
|
84
112
|
export declare function usePrefersReducedMotion(): boolean;
|
|
85
113
|
/**
|
|
@@ -219,20 +247,28 @@ export declare const FORM_END_STATE: {
|
|
|
219
247
|
* open state keeps `transform` expressed through `--wgt-sheet-y` rather than
|
|
220
248
|
* as a resolved `translateY(0px)`: the drag writes that custom property once
|
|
221
249
|
* per frame (§7.1 rule 5), and a finaliser that resolved it would pin the
|
|
222
|
-
* sheet to wherever the last gesture left it.
|
|
250
|
+
* sheet to wherever the last gesture left it. Its clip does the same for the
|
|
251
|
+
* bottom inset, which follows a downward drag so the visor sinks behind the
|
|
252
|
+
* row instead of being dragged over the page.
|
|
253
|
+
*
|
|
254
|
+
* Closed is the visor tucked away behind the row (revised 2026-09-15): moved
|
|
255
|
+
* down by its own height and clipped from the bottom by the same 100 %, so the
|
|
256
|
+
* reveal slides it up out of the dock with the clip's bottom edge pinned to its
|
|
257
|
+
* resting floor. Side and top insets are negative so the static shadow is not
|
|
258
|
+
* clipped away.
|
|
223
259
|
*/
|
|
224
260
|
export declare const SHEET_END_STATE: {
|
|
225
261
|
readonly open: {
|
|
226
262
|
readonly visibility: 'visible';
|
|
227
263
|
readonly opacity: '1';
|
|
228
|
-
readonly 'clip-path': 'inset(
|
|
264
|
+
readonly 'clip-path': 'inset(-48px -48px max(0px, var(--wgt-sheet-y, 0px)) -48px)';
|
|
229
265
|
readonly transform: 'translateY(var(--wgt-sheet-y, 0px))';
|
|
230
266
|
};
|
|
231
267
|
readonly closed: {
|
|
232
268
|
readonly visibility: 'hidden';
|
|
233
269
|
readonly opacity: '0';
|
|
234
|
-
readonly 'clip-path': 'inset(100%
|
|
235
|
-
readonly transform: 'translateY(
|
|
270
|
+
readonly 'clip-path': 'inset(-48px -48px 100% -48px)';
|
|
271
|
+
readonly transform: 'translateY(100%)';
|
|
236
272
|
};
|
|
237
273
|
};
|
|
238
274
|
/**
|
|
@@ -274,6 +310,25 @@ export interface DockDurations {
|
|
|
274
310
|
readonly caption: number;
|
|
275
311
|
readonly border: number;
|
|
276
312
|
readonly control: number;
|
|
313
|
+
/**
|
|
314
|
+
* §3.6's glass transition — the FOUR paint properties `dock-surface.css`
|
|
315
|
+
* eases (`background-color`, `border-color`, `box-shadow`,
|
|
316
|
+
* `backdrop-filter`, plus the mark's `filter`).
|
|
317
|
+
*
|
|
318
|
+
* It was the one duration in the dock that lived ONLY in CSS, which put it
|
|
319
|
+
* outside rule 12's kill switch even though this module's own doc comment
|
|
320
|
+
* claims "every duration in `useDockDurations` collapses to 0". A hidden tab
|
|
321
|
+
* will not advance a transition and will not fire its `transitionend`, so a
|
|
322
|
+
* row that went glass as the tab was backgrounded came back frozen halfway —
|
|
323
|
+
* the exact production defect recorded at {@link useMotionOff}, on the one
|
|
324
|
+
* surface that was not covered.
|
|
325
|
+
*
|
|
326
|
+
* `dock-row.tsx` writes it onto the ROW, and only when it is zero. The 320 ms
|
|
327
|
+
* ease-in and the 180 ms wake are set by rules that match `.wgt-row` itself,
|
|
328
|
+
* so a value inherited from the dock root could never beat them — and
|
|
329
|
+
* writing it unconditionally would flatten an asymmetry that is the design.
|
|
330
|
+
*/
|
|
331
|
+
readonly surface: number;
|
|
277
332
|
}
|
|
278
333
|
/**
|
|
279
334
|
* @param motionOff §7.1 rule 10 (`prefers-reduced-motion`) OR rule 12 (the
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"dock-motion.d.ts","sourceRoot":"","sources":["../../src/dock/dock-motion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,OAAO,
|
|
1
|
+
{"version":3,"file":"dock-motion.d.ts","sourceRoot":"","sources":["../../src/dock/dock-motion.ts"],"names":[],"mappings":"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"}
|
package/dist/dock/dock-pill.d.ts
CHANGED
|
@@ -38,6 +38,23 @@ export interface DockPillProps {
|
|
|
38
38
|
onPointerDown?: (event: ReactPointerEvent<HTMLElement>) => void;
|
|
39
39
|
};
|
|
40
40
|
readonly pillRef?: RefObject<HTMLButtonElement | null>;
|
|
41
|
+
/** §3.2 — draw the notification dot. */
|
|
42
|
+
readonly unread?: boolean;
|
|
43
|
+
/** §3.2 — appended to the pill's accessible name while `unread`. */
|
|
44
|
+
readonly unreadLabel?: string;
|
|
45
|
+
/**
|
|
46
|
+
* §2/§5.1's `human` — a person holds the conversation, so this mark is
|
|
47
|
+
* theirs too.
|
|
48
|
+
*
|
|
49
|
+
* The pill draws the SAME mark the row does (`DockMarkFace`), and the
|
|
50
|
+
* handoff treatment is a property of the mark rather than of the row: a
|
|
51
|
+
* shopper who minimised mid-handoff still has one thing on screen telling
|
|
52
|
+
* them who they are talking to, and it would be worse than useless if it
|
|
53
|
+
* were the concierge's orb.
|
|
54
|
+
*/
|
|
55
|
+
readonly handoff?: boolean;
|
|
56
|
+
/** The operator's display name, when the payload carried one. See `DockMarkFace`. */
|
|
57
|
+
readonly operatorName?: string;
|
|
41
58
|
}
|
|
42
|
-
export declare function DockPill({ identity, mark, label, line, expandLabel, form, onPress, draggable, dragHandleProps, pillRef, }: DockPillProps): import("react").JSX.Element;
|
|
59
|
+
export declare function DockPill({ identity, mark, label, line, expandLabel, form, onPress, draggable, dragHandleProps, pillRef, unread, unreadLabel, handoff, operatorName, }: DockPillProps): import("react").JSX.Element;
|
|
43
60
|
//# sourceMappingURL=dock-pill.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"dock-pill.d.ts","sourceRoot":"","sources":["../../src/dock/dock-pill.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,IAAI,iBAAiB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAG1E,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,oFAAoF;IACpF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE;QACzB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;KACjE,CAAC;IACF,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"dock-pill.d.ts","sourceRoot":"","sources":["../../src/dock/dock-pill.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,IAAI,iBAAiB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAG1E,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,oFAAoF;IACpF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE;QACzB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;KACjE,CAAC;IACF,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IACvD,wCAAwC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;;;;;OASG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,qFAAqF;IACrF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,QAAQ,CAAC,EACvB,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,WAAW,EACX,IAAI,EACJ,OAAO,EACP,SAAS,EACT,eAAe,EACf,OAAO,EACP,MAAM,EACN,WAAW,EACX,OAAO,EACP,YAAY,GACb,EAAE,aAAa,+BA4Df"}
|
package/dist/dock/dock-row.d.ts
CHANGED
|
@@ -1,14 +1,16 @@
|
|
|
1
1
|
import type { PointerEvent as ReactPointerEvent, RefObject } from 'react';
|
|
2
|
-
import {
|
|
2
|
+
import type { WidgetMessages } from '../messages.js';
|
|
3
3
|
import type { DockControl, DockMark, DockView } from './dock-state.js';
|
|
4
4
|
/**
|
|
5
5
|
* THE ROW — docs/DOCK_SPEC.md §2's four fixed slots, in order, in every state.
|
|
6
6
|
*
|
|
7
7
|
* `MARK | ACTIVITY | CAPTION | CONTROLS ≤3`, 48 px tall (44 px of content plus
|
|
8
8
|
* the 2 px border, which is what lets every control keep a 44 px target
|
|
9
|
-
* inside it — §11). Nothing is ever ADDED to the row: the activity slot
|
|
10
|
-
*
|
|
11
|
-
*
|
|
9
|
+
* inside it — §11). Nothing is ever ADDED to the row: the activity slot is
|
|
10
|
+
* always in the DOM, and when it has nothing to show it COLLAPSES — width and
|
|
11
|
+
* the row gap both go, so the caption takes the space (§2, revised
|
|
12
|
+
* 2026-09-15). The core dock draws its dormant slot already collapsed, so
|
|
13
|
+
* React arriving does not move the caption (§4.2).
|
|
12
14
|
*
|
|
13
15
|
* This component decides nothing. Which controls exist, what the caption
|
|
14
16
|
* says, whether the border is live and how the mark is treated all come from
|
|
@@ -32,14 +34,46 @@ import type { DockControl, DockMark, DockView } from './dock-state.js';
|
|
|
32
34
|
export type DockAvatarKind = 'orb' | 'knot' | 'image' | 'none';
|
|
33
35
|
/** Which gesture pressed the microphone — see `DockRowProps.onMicDown`. */
|
|
34
36
|
export type DockMicSource = 'touch' | 'pointer' | 'key';
|
|
37
|
+
/**
|
|
38
|
+
* "Give me this string, in this tenant's locale."
|
|
39
|
+
*
|
|
40
|
+
* ONE resolver, owned by `dock.tsx` and passed down. Every surface under the
|
|
41
|
+
* dock reads the same catalogue with the same fallback to
|
|
42
|
+
* `defaultWidgetMessages`, and a second implementation of that is a second
|
|
43
|
+
* place for the fallback to drift.
|
|
44
|
+
*/
|
|
45
|
+
export type DockMessage = (key: keyof WidgetMessages, vars?: Record<string, string | number>) => string;
|
|
35
46
|
export interface DockIdentityView {
|
|
36
47
|
readonly name: string;
|
|
37
48
|
readonly avatar: DockAvatarKind;
|
|
38
49
|
readonly avatarUrl?: string;
|
|
39
50
|
}
|
|
51
|
+
/**
|
|
52
|
+
* The INITIALS a handoff disc draws for `name` — one or two letters, or `''`
|
|
53
|
+
* when there is no name to derive them from (DOCK_SPEC §2).
|
|
54
|
+
*
|
|
55
|
+
* The rule is the first character of the first two whitespace-separated
|
|
56
|
+
* words, and it is deliberately that crude. A directory holds whatever a
|
|
57
|
+
* tenant's teammate typed into it: one word ("Amina"), four words ("Maria del
|
|
58
|
+
* Carmen Perez"), a name written in a script with no case to fold ("अमिता
|
|
59
|
+
* शर्मा"), a name whose "letters" are not code units ("李雷" — one character
|
|
60
|
+
* per glyph, but an emoji or an astral-plane script would be two). So:
|
|
61
|
+
*
|
|
62
|
+
* - split on ANY run of whitespace after trimming, which is what makes a
|
|
63
|
+
* pasted " amina rahman " produce `AR` rather than a blank or a space;
|
|
64
|
+
* - `Array.from` before taking the first character, so a surrogate pair is
|
|
65
|
+
* one initial rather than half of one and a lone high surrogate;
|
|
66
|
+
* - `toUpperCase` last, because on a script with no case it is the identity
|
|
67
|
+
* function and on a Latin name it is the whole point.
|
|
68
|
+
*
|
|
69
|
+
* `''` is a real answer, not a failure: it is the cue the mark uses to draw
|
|
70
|
+
* the neutral PERSON glyph instead, which is what a tenant who never turned
|
|
71
|
+
* `handoff.showOperatorName` on gets on every handoff they ever have.
|
|
72
|
+
*/
|
|
73
|
+
export declare function handoffInitials(name: string | undefined): string;
|
|
40
74
|
/**
|
|
41
75
|
* The tenant's mark, at whatever size the row (32 px) or the pill (28 px)
|
|
42
|
-
* asks for.
|
|
76
|
+
* asks for — or, while a PERSON holds the conversation, that person's disc.
|
|
43
77
|
*
|
|
44
78
|
* §9.3 validates `avatarUrl` at publish and `cdn/dock-dom.ts` validates it
|
|
45
79
|
* AGAIN at paint; this does the same, for the same reason: the string becomes
|
|
@@ -47,15 +81,51 @@ export interface DockIdentityView {
|
|
|
47
81
|
* browser makes on our instruction — and a config record can predate a
|
|
48
82
|
* validator or be replayed from an older row. An unusable URL degrades to the
|
|
49
83
|
* plain dot, never to a broken image or a request to somewhere unexpected.
|
|
84
|
+
*
|
|
85
|
+
* ## The handoff treatment (§2, added 2026-09-16)
|
|
86
|
+
*
|
|
87
|
+
* While `handoff` is true the tenant's orb, knot, image or dot is REPLACED by
|
|
88
|
+
* a disc in the tenant's own colours (`--wgt-primary` / `--wgt-on-primary`),
|
|
89
|
+
* carrying the operator's initials or — when the payload carried no name — a
|
|
90
|
+
* neutral person glyph. It replaces rather than sits beside, because the mark
|
|
91
|
+
* answers one question ("who is on the other end of this?") and after a
|
|
92
|
+
* handoff the concierge is not the answer.
|
|
93
|
+
*
|
|
94
|
+
* It is RUNTIME STATE, exactly like the microphone gate beside it: nothing is
|
|
95
|
+
* configured, nothing is persisted, and `handoff` going false brings the
|
|
96
|
+
* tenant's mark back on the next render.
|
|
97
|
+
*
|
|
98
|
+
* This is also the ONE place either surface draws a mark, which is what makes
|
|
99
|
+
* "wherever the mark is drawn" (§2) a fact about this function rather than a
|
|
100
|
+
* rule two call sites have to remember.
|
|
50
101
|
*/
|
|
51
|
-
export declare function DockMarkFace({ identity, mark, size, testId, }: {
|
|
102
|
+
export declare function DockMarkFace({ identity, mark, size, testId, handoff, operatorName, }: {
|
|
52
103
|
identity: DockIdentityView;
|
|
53
104
|
mark: DockMark;
|
|
54
105
|
size: number;
|
|
55
106
|
/** Distinct per surface: the row and the pill both draw a mark. */
|
|
56
107
|
testId?: string;
|
|
108
|
+
/** §5.1's `human` — a person holds the conversation, so the mark is theirs. */
|
|
109
|
+
handoff?: boolean;
|
|
110
|
+
/**
|
|
111
|
+
* That person's display name, when the API sent one.
|
|
112
|
+
*
|
|
113
|
+
* Absent is the DEFAULT and never an error: the api omits the field
|
|
114
|
+
* entirely unless the tenant published `handoff.showOperatorName: true`, so
|
|
115
|
+
* there is nothing to gate on this side and nothing to hide.
|
|
116
|
+
*/
|
|
117
|
+
operatorName?: string;
|
|
57
118
|
}): import("react").JSX.Element;
|
|
58
|
-
/**
|
|
119
|
+
/**
|
|
120
|
+
* §2's activity slot: five bars while audio flows, a thin track during
|
|
121
|
+
* retrieval, three dots while the other side composes.
|
|
122
|
+
*
|
|
123
|
+
* ALWAYS rendered, even with nothing to show. An empty slot collapses to zero
|
|
124
|
+
* width (`dock-surface.css`'s `[data-empty='true']` rule, whose negative end
|
|
125
|
+
* margin also cancels the row's flex gap) and the caption slides into the
|
|
126
|
+
* space. Unmounting the slot instead would make the collapse a snap — a box
|
|
127
|
+
* that no longer exists cannot ease its width — and §2 asks for the slide.
|
|
128
|
+
*/
|
|
59
129
|
export declare function DockActivitySlot({ activity }: {
|
|
60
130
|
activity: DockView['activity'];
|
|
61
131
|
}): import("react").JSX.Element;
|
|
@@ -64,7 +134,16 @@ export interface DockRowProps {
|
|
|
64
134
|
readonly identity: DockIdentityView;
|
|
65
135
|
/** Which form is showing — the row is always in the DOM, so the swap is a visibility change (§7.2). */
|
|
66
136
|
readonly form: 'pill' | 'row';
|
|
67
|
-
|
|
137
|
+
/**
|
|
138
|
+
* The dock's OWN message resolver, passed down rather than rebuilt here.
|
|
139
|
+
*
|
|
140
|
+
* It used to take the `messages` catalogue and re-derive the same
|
|
141
|
+
* `formatMessage(messages[key] ?? defaultWidgetMessages[key], vars)` — a
|
|
142
|
+
* second implementation of a one-line contract, in a budgeted bundle, that
|
|
143
|
+
* would silently stop matching `dock.tsx`'s the day either one grew a
|
|
144
|
+
* fallback the other did not.
|
|
145
|
+
*/
|
|
146
|
+
readonly msg: DockMessage;
|
|
68
147
|
/** The resolved caption line, or `undefined` when the FIELD is the caption. */
|
|
69
148
|
readonly captionLine?: string;
|
|
70
149
|
readonly captionSwapKey: string;
|
|
@@ -112,9 +191,33 @@ export interface DockRowProps {
|
|
|
112
191
|
readonly rowRef?: RefObject<HTMLDivElement | null>;
|
|
113
192
|
readonly inputRef?: RefObject<HTMLInputElement | null>;
|
|
114
193
|
readonly captionDurationMs: number;
|
|
115
|
-
/**
|
|
194
|
+
/**
|
|
195
|
+
* §11 — the mark's accessible name carries the live/rest state in words.
|
|
196
|
+
*
|
|
197
|
+
* It is the SESSION's state and stays that through a handoff: the disc
|
|
198
|
+
* below is a visual treatment, and putting an operator's name in here would
|
|
199
|
+
* both re-read a name the transcript already announced and speak one on a
|
|
200
|
+
* row whose payload may never have carried it.
|
|
201
|
+
*/
|
|
116
202
|
readonly markStateLabel: string;
|
|
117
203
|
readonly onMarkPress: () => void;
|
|
204
|
+
/**
|
|
205
|
+
* §5.5 — "A tap on the row restores the sheet at `peek`."
|
|
206
|
+
*
|
|
207
|
+
* The row's DEAD SPACE only: a press that landed on a control is that
|
|
208
|
+
* control's press, and a press in the caption field is the shopper starting
|
|
209
|
+
* to type. Absent ⇒ the row has nothing to restore, and the tap does
|
|
210
|
+
* nothing rather than opening an empty visor (§5.1).
|
|
211
|
+
*
|
|
212
|
+
* §5.1's interrupt outranks it while the concierge is `speaking`: a shopper
|
|
213
|
+
* who touches a row that is talking at them means "stop", which is the
|
|
214
|
+
* oldest promise the row makes.
|
|
215
|
+
*/
|
|
216
|
+
readonly onRowPress?: () => void;
|
|
217
|
+
/** §2/§5.1's `human` — the mark becomes the operator's disc. See `DockMarkFace`. */
|
|
218
|
+
readonly handoff?: boolean;
|
|
219
|
+
/** The operator's display name, when the payload carried one. See `DockMarkFace`. */
|
|
220
|
+
readonly operatorName?: string;
|
|
118
221
|
/**
|
|
119
222
|
* §3.3 (revised 2026-09-11) — the sheet is up, so the two corners the row
|
|
120
223
|
* shares with it are square. An attribute rather than a class, because it
|
|
@@ -126,6 +229,21 @@ export interface DockRowProps {
|
|
|
126
229
|
readonly dragHandleProps?: {
|
|
127
230
|
onPointerDown?: (event: ReactPointerEvent<HTMLElement>) => void;
|
|
128
231
|
};
|
|
232
|
+
/** §3.6 — draw the row on the glass surface. */
|
|
233
|
+
readonly glass?: boolean;
|
|
234
|
+
/** §3.6 — the shopper woke the glass row (tap/pointer inside it). */
|
|
235
|
+
readonly onWake?: () => void;
|
|
236
|
+
/**
|
|
237
|
+
* §7.1 rule 12 — §3.6's surface transition, or 0 when motion is off.
|
|
238
|
+
*
|
|
239
|
+
* Written onto THIS element and only when it is zero. `dock-surface.css`
|
|
240
|
+
* sets `--wgt-dur-surface` on rules that match `.wgt-row` itself (320 ms
|
|
241
|
+
* into glass, 180 ms waking), so a value inherited from the dock root could
|
|
242
|
+
* never beat them — which is why it is not in `rootStyle` beside the other
|
|
243
|
+
* five — and writing it unconditionally would flatten an asymmetry that is
|
|
244
|
+
* the design. See `DockDurations.surface` for the defect this closes.
|
|
245
|
+
*/
|
|
246
|
+
readonly surfaceDurationMs?: number;
|
|
129
247
|
}
|
|
130
|
-
export declare function DockRow({ view, identity, form,
|
|
248
|
+
export declare function DockRow({ view, identity, form, captionLine, captionSwapKey, captionTestId, draft, onDraftChange, onSubmit, placeholder, composerDisabled, onControl, onMicDown, onMicUp, interruptLabelled, micOpen, micDisabled, micUnavailableReason, attachBusy, rowRef, inputRef, captionDurationMs, markStateLabel, handoff, operatorName, onMarkPress, onRowPress, sheetOpen, draggable, dragHandleProps, glass, onWake, msg, surfaceDurationMs, }: DockRowProps): import("react").JSX.Element;
|
|
131
249
|
//# sourceMappingURL=dock-row.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"dock-row.d.ts","sourceRoot":"","sources":["../../src/dock/dock-row.tsx"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"dock-row.d.ts","sourceRoot":"","sources":["../../src/dock/dock-row.tsx"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"dock-sheet.d.ts","sourceRoot":"","sources":["../../src/dock/dock-sheet.tsx"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAUf;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAE3D;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAQtC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;IACrD,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,iGAAiG;IACjG,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;IAC/B,kGAAkG;IAClG,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;;;;;OAQG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACrD,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,wBAAgB,SAAS,CAAC,EACxB,IAAI,EACJ,YAAY,EACZ,KAAK,EACL,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,SAAS,EACT,SAAS,EACT,eAAuB,EACvB,QAAQ,EACR,UAAU,EACV,eAAe,GAChB,EAAE,cAAc,+
|
|
1
|
+
{"version":3,"file":"dock-sheet.d.ts","sourceRoot":"","sources":["../../src/dock/dock-sheet.tsx"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAUf;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAE3D;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAQtC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;IACrD,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,iGAAiG;IACjG,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;IAC/B,kGAAkG;IAClG,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;;;;;OAQG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACrD,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,wBAAgB,SAAS,CAAC,EACxB,IAAI,EACJ,YAAY,EACZ,KAAK,EACL,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,SAAS,EACT,SAAS,EACT,eAAuB,EACvB,QAAQ,EACR,UAAU,EACV,eAAe,GAChB,EAAE,cAAc,+BAiZhB"}
|