@saar-ai/web-widget 0.6.0 → 0.7.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.
@@ -0,0 +1,81 @@
1
+ import { type PointerEvent as ReactPointerEvent, type RefObject } from 'react';
2
+ import { type DesktopAlign } from './geometry.js';
3
+ /**
4
+ * THE DESKTOP DRAG — docs/DOCK_SPEC.md §9.1's `layout.draggable`, added
5
+ * 2026-09-11.
6
+ *
7
+ * On a desktop pointer the shopper may slide the dock sideways and drop it at
8
+ * `left`, `center` or `right`. Five rules, and every one of them is a way the
9
+ * gesture becomes a defect rather than a convenience:
10
+ *
11
+ * 1. **Horizontal only.** The bottom edge is the dock's entire contract with
12
+ * the merchant's furniture — §8.3 stacks above their sticky bar, §8.1
13
+ * clears the home indicator. A dock a shopper can park halfway up a
14
+ * product page is a dock that covers merchandise (§1 rule 3). There is no
15
+ * vertical term anywhere below, which is stronger than clamping one.
16
+ * 2. **`transform` per frame, and nothing else** (§7.1 rule 1). The ANCHOR
17
+ * (`left`/`right` on the fixed container) is not touched until the
18
+ * gesture settles, so no frame of a drag costs the merchant's document a
19
+ * layout. The value is a CSS custom property written straight onto the
20
+ * container (rule 5) — a drag that went through React state would
21
+ * re-render the transcript inside the sheet sixty times a second.
22
+ * 3. **Under `DRAG_TAP_SLOP_PX`, it was a tap.** The handle is the row's
23
+ * mark, which also toggles the sheet, and the pill, which opens the
24
+ * concierge. Both are pressed far more often than they are dragged, and a
25
+ * mouse that travels three pixels between press and release is a click
26
+ * everywhere else the shopper has ever clicked.
27
+ * 4. **The release SNAPS with §7.2's FLIP easing**, by the same mechanism
28
+ * the pill ↔ row swap uses: the anchor changes, the element is put back
29
+ * where the eye last saw it with one `transform`, and that transform is
30
+ * animated to zero. Measuring after the commit is what makes this exact —
31
+ * the three anchors are not the same distance apart, and computing the
32
+ * offset from the gesture instead would drift by a gutter.
33
+ * 5. **The window hears the release.** A pointer dragging a 48 px row across
34
+ * a 1440 px viewport leaves the handle almost immediately, and a
35
+ * `pointerup` that never reaches the handler leaves the dock translated,
36
+ * with its transitions off, until some future drag happens to finish.
37
+ *
38
+ * The hook owns no geometry of its own: `snapAlign` decides where a release
39
+ * lands and `readStoredAlign`/`persistAlign` own the storage key, all three
40
+ * in `geometry.ts` — because `cdn/dock-dom.ts` drags the PILL with exactly
41
+ * the same three, and §4.2 gives the two renderers one frame to disagree in.
42
+ */
43
+ export interface DockDragOptions {
44
+ /** §9.1: a desktop viewport, a `pointer: fine` device, and the tenant said yes. */
45
+ readonly enabled: boolean;
46
+ /** §9.1's `layout.desktopAlign` — the starting position, and the fallback. */
47
+ readonly published: DesktopAlign;
48
+ /** The window the dock is living in — see `dock.tsx`'s `ownerWindowOf`. */
49
+ readonly win: Window | null;
50
+ /** §7.2's swap duration, 0 under reduced motion (§7.1 rule 10). */
51
+ readonly durationMs: number;
52
+ /**
53
+ * The pill, for rule 4's second half.
54
+ *
55
+ * The container's FLIP cannot express the pill's move: `pillAnchor` decides
56
+ * which END of the container the pill hangs off, and an alignment that
57
+ * changes SIDE changes that too — an untransitionable `left`/`right` swap,
58
+ * on top of the container's own move. So the pill is measured in its own
59
+ * right, before and after, and animated from the real first rect to the
60
+ * real last one.
61
+ */
62
+ readonly pillRef?: RefObject<HTMLElement | null>;
63
+ }
64
+ export interface DockDragResult {
65
+ /** Where the dock sits: the shopper's remembered choice, else the tenant's. */
66
+ readonly align: DesktopAlign;
67
+ /** Did the gesture that just ended MOVE? Its trailing `click` has to be swallowed. */
68
+ readonly consumeClick: () => boolean;
69
+ /** Spread onto the handle — the row's mark, or the pill. */
70
+ readonly handleProps: {
71
+ onPointerDown?: (event: ReactPointerEvent<HTMLElement>) => void;
72
+ };
73
+ }
74
+ /** The one custom property a drag writes (§7.1 rule 5). */
75
+ export declare const DRAG_VAR = "--wgt-drag-x";
76
+ export declare function useDockDrag(containerRef: {
77
+ current: HTMLElement | null;
78
+ }, { enabled, published, win, durationMs, pillRef }: DockDragOptions): DockDragResult;
79
+ /** §7.2's easing, re-exported so the stylesheet's own value has a source. */
80
+ export declare const DRAG_SETTLE_EASING = "cubic-bezier(0.2, 0, 0, 1)";
81
+ //# sourceMappingURL=dock-drag.d.ts.map
@@ -0,0 +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,EAKL,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,CA2QhB;AAED,6EAA6E;AAC7E,eAAO,MAAM,kBAAkB,+BAAc,CAAC"}
@@ -1,10 +1,10 @@
1
1
  /**
2
- * THE DOCK'S MOTION — docs/DOCK_SPEC.md §7, as the four primitives every
3
- * surface under `dock/` shares.
2
+ * THE DOCK'S MOTION — docs/DOCK_SPEC.md §7, as the primitives every surface
3
+ * under `dock/` shares.
4
4
  *
5
5
  * §7.1 is a gate, not guidance, and `tools/check-widget-motion.mjs` enforces
6
- * rule 1 (compositor only) over this whole package. The other four rules the
7
- * dock cannot get right by writing CSS alone live here:
6
+ * rule 1 (compositor only) over this whole package. The rules the dock cannot
7
+ * get right by writing CSS alone live here:
8
8
  *
9
9
  * - **rule 4 — `will-change` is transient.** Set by the animation's start,
10
10
  * removed on `transitionend`. A permanent `will-change: transform` on a
@@ -22,6 +22,14 @@
22
22
  * - **rule 10 — reduced motion wins.** Every duration below collapses to 0
23
23
  * and the FLIP is skipped entirely. {@link usePrefersReducedMotion} is the
24
24
  * single read, so no surface can forget it.
25
+ * - **rule 12 — transitions finalise without `transitionend`.** A hidden tab
26
+ * does not advance a CSS transition, so a dock that waits for the event
27
+ * waits forever and strands itself mid-swap with both forms
28
+ * `visibility: hidden`. {@link useMotionOff} folds "the tab is hidden"
29
+ * into rule 10's single read, and `motion-gate.ts` owns the fallback
30
+ * timer, the explicit end state and the `visibilitychange` finalisation —
31
+ * it is React-free because the core dock (`cdn/dock-dom.ts`) has the same
32
+ * hazard and cannot afford a framework.
25
33
  * - **§7.2's pill ↔ row FLIP.** Measure both boxes, animate the difference
26
34
  * on `transform` alone. Never `width`/`height`/`left` — see the guard.
27
35
  *
@@ -30,6 +38,7 @@
30
38
  * without a layout engine jsdom does not have.
31
39
  */
32
40
  import { type RefObject } from 'react';
41
+ import { type MotionEndState } from './motion-gate.js';
33
42
  /** §7.2 — the pill ↔ row swap, and the recede/expand that reuses it. */
34
43
  export declare const SWAP_MS = 240;
35
44
  export declare const RECEDE_MS = 200;
@@ -59,6 +68,27 @@ export declare const SHEET_DISMISS_FRACTION = 0.4;
59
68
  * static dock is always correct, an animated one is not.
60
69
  */
61
70
  export declare function usePrefersReducedMotion(): boolean;
71
+ /**
72
+ * §7.1 rule 12 — `document.visibilityState`, as a subscription.
73
+ *
74
+ * A one-shot read at mount would be the wrong answer for the whole of the
75
+ * rest of the visit, and the visit is where this matters: the shopper taps
76
+ * the pill and then locks the phone. Both edges are reported, because both
77
+ * change what the dock is allowed to do — hidden means "apply the end state,
78
+ * animate nothing", visible means "a stalled transition, if there is one, has
79
+ * to be finalised now".
80
+ */
81
+ export declare function useDocumentHidden(): boolean;
82
+ /**
83
+ * "Motion is off." §7.1 rule 10 and rule 12 in ONE read, because a surface
84
+ * that has to remember two of them will eventually remember one.
85
+ *
86
+ * `prefers-reduced-motion` is a preference and a hidden tab is a fact, but
87
+ * they ask the dock for the same thing: skip the animation, apply the end
88
+ * state now. Every duration in {@link useDockDurations} collapses to 0, the
89
+ * FLIP does not start, and the caption swaps in place.
90
+ */
91
+ export declare function useMotionOff(): boolean;
62
92
  /**
63
93
  * §7.1 rule 5 — a per-frame custom-property writer.
64
94
  *
@@ -98,8 +128,19 @@ export declare function useCssVars(ref: RefObject<HTMLElement | null>): (name: s
98
128
  * the timer left the listener attached and `will-change` set on a node that
99
129
  * no longer renders, so the layer survived the component and the closure
100
130
  * survived with it.
131
+ *
132
+ * ## Why the promotion is not the only thing this arms (§7.1 rule 12)
133
+ *
134
+ * The `transitionend` this waits for never arrives in a hidden tab, and a
135
+ * sheet whose reveal was interrupted by a lock screen is not merely a layer
136
+ * left promoted — it is a `visibility: hidden` box that the shopper cannot
137
+ * see or reach. `arm(endState)` therefore hands the whole finalisation to
138
+ * `motion-gate.ts`: the fallback timer, the `visibilitychange` edge, and the
139
+ * explicit end state the surface passes in. Armed while the tab is already
140
+ * hidden (or with a zeroed duration), it promotes nothing at all and applies
141
+ * that end state synchronously — there is no animation to give a layer to.
101
142
  */
102
- export declare function useTransientWillChange(ref: RefObject<HTMLElement | null>, properties?: string, ms?: number): () => void;
143
+ export declare function useTransientWillChange(ref: RefObject<HTMLElement | null>, properties?: string, ms?: number): (endState?: MotionEndState) => void;
103
144
  /** A box, as the FLIP needs it. Deliberately not a `DOMRect` — the arithmetic is testable without one. */
104
145
  export interface FlipBox {
105
146
  readonly x: number;
@@ -123,6 +164,63 @@ export interface FlipBox {
123
164
  export declare function flipTransform(from: FlipBox, to: FlipBox): string;
124
165
  /** §7.2's waveform smoothing — the same 0.25 lerp the analyser feeds. */
125
166
  export declare function lerp(current: number, target: number, factor?: number): number;
167
+ /**
168
+ * §7.2's two forms at rest, as the inline properties a §7.1 rule 12
169
+ * finalisation writes.
170
+ *
171
+ * These MIRROR `.wgt-row[data-form='pill']` and `.wgt-pill[data-form='row']`
172
+ * in `styles/concierge.css` — the cascade is still what draws the dock, and
173
+ * this table is only ever written for the one frame in which a stalled
174
+ * transition is being cancelled. `dock-motion.test.ts` reads the stylesheet
175
+ * and asserts the two agree, because a divergence here is invisible until a
176
+ * shopper locks their phone mid-swap and comes back to a dock in the wrong
177
+ * shape.
178
+ */
179
+ export declare const FORM_END_STATE: {
180
+ /** Either form, showing. The base rule for both boxes. */
181
+ readonly shown: {
182
+ readonly visibility: 'visible';
183
+ readonly opacity: '1';
184
+ readonly transform: 'none';
185
+ };
186
+ /** `.wgt-pill[data-form='row']`. */
187
+ readonly pillHidden: {
188
+ readonly visibility: 'hidden';
189
+ readonly opacity: '0';
190
+ readonly transform: 'scale(0.92)';
191
+ };
192
+ /** `.wgt-row[data-form='pill']`. */
193
+ readonly rowHidden: {
194
+ readonly visibility: 'hidden';
195
+ readonly opacity: '0';
196
+ readonly transform: 'scale(0.98)';
197
+ };
198
+ };
199
+ /**
200
+ * §3.3's sheet at each end of its reveal, as the inline properties a §7.1
201
+ * rule 12 finalisation writes.
202
+ *
203
+ * Mirrors `.wgt-sheet` and `.wgt-sheet[data-snap='closed']` in
204
+ * `styles/concierge.css`, and `dock-motion.test.ts` asserts they agree. The
205
+ * open state keeps `transform` expressed through `--wgt-sheet-y` rather than
206
+ * as a resolved `translateY(0px)`: the drag writes that custom property once
207
+ * per frame (§7.1 rule 5), and a finaliser that resolved it would pin the
208
+ * sheet to wherever the last gesture left it.
209
+ */
210
+ export declare const SHEET_END_STATE: {
211
+ readonly open: {
212
+ readonly visibility: 'visible';
213
+ readonly opacity: '1';
214
+ readonly 'clip-path': 'inset(0 0 0 0)';
215
+ readonly transform: 'translateY(var(--wgt-sheet-y, 0px))';
216
+ };
217
+ readonly closed: {
218
+ readonly visibility: 'hidden';
219
+ readonly opacity: '0';
220
+ readonly 'clip-path': 'inset(100% 0 0 0)';
221
+ readonly transform: 'translateY(8px)';
222
+ };
223
+ };
126
224
  /**
127
225
  * The pill ↔ row swap (§7.2), driven by whichever box is showing.
128
226
  *
@@ -132,14 +230,26 @@ export declare function lerp(current: number, target: number, factor?: number):
132
230
  * the change puts the incoming one back where the outgoing one was and
133
231
  * releases it. One layout read, one style write, no host reflow.
134
232
  *
135
- * Under reduced motion it does nothing at all: §7.1 rule 10, and the state is
136
- * always also in text (the live region), so nothing is lost.
233
+ * Under reduced motion, or in a hidden tab, it does nothing at all but write
234
+ * both end states: §7.1 rules 10 and 12, and the state is always also in text
235
+ * (the live region), so nothing is lost. `motionOff` is the caller's single
236
+ * read of both (see {@link useMotionOff}).
237
+ *
238
+ * ## The FLIP is not the only thing being finalised here
239
+ *
240
+ * The WAAPI animation below is the cross-fade's TRAVEL. The cross-fade
241
+ * itself — `opacity`, `transform`, and the `visibility` that takes the
242
+ * outgoing form out of the tab order — is a CSS transition on both elements,
243
+ * driven by `data-form`, and it is the one that froze on production: a hidden
244
+ * tab left `.wgt-row` at `opacity: 0.6`, `visibility: hidden` with the pill
245
+ * hidden too, so there was nothing on screen to tap. Each form therefore gets
246
+ * its own finaliser, with its own end state, on every swap.
137
247
  */
138
- export declare function useFormFlip(pillRef: RefObject<HTMLElement | null>, rowRef: RefObject<HTMLElement | null>, form: 'pill' | 'row', reducedMotion: boolean, durationMs?: number): void;
248
+ export declare function useFormFlip(pillRef: RefObject<HTMLElement | null>, rowRef: RefObject<HTMLElement | null>, form: 'pill' | 'row', motionOff: boolean, durationMs?: number): void;
139
249
  /**
140
- * The durations every dock surface reads, already collapsed for reduced
141
- * motion. One object so a component never writes `reduced ? 0 : 240` itself
142
- * and never forgets the `reduced` half.
250
+ * The durations every dock surface reads, already collapsed for the two cases
251
+ * where there is no animation. One object so a component never writes
252
+ * `off ? 0 : 240` itself and never forgets the `off` half.
143
253
  */
144
254
  export interface DockDurations {
145
255
  readonly swap: number;
@@ -151,5 +261,10 @@ export interface DockDurations {
151
261
  readonly border: number;
152
262
  readonly control: number;
153
263
  }
154
- export declare function useDockDurations(reducedMotion: boolean): DockDurations;
264
+ /**
265
+ * @param motionOff §7.1 rule 10 (`prefers-reduced-motion`) OR rule 12 (the
266
+ * tab is hidden and the browser will not advance a transition in it). See
267
+ * {@link useMotionOff}, which is how every caller reads both at once.
268
+ */
269
+ export declare function useDockDurations(motionOff: boolean): DockDurations;
155
270
  //# sourceMappingURL=dock-motion.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"dock-motion.d.ts","sourceRoot":"","sources":["../../src/dock/dock-motion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,EAAqD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE1F,wEAAwE;AACxE,eAAO,MAAM,OAAO,MAAM,CAAC;AAC3B,eAAO,MAAM,SAAS,MAAM,CAAC;AAC7B,eAAO,MAAM,WAAW,+BAA+B,CAAC;AACxD,2FAA2F;AAC3F,eAAO,MAAM,aAAa,MAAM,CAAC;AACjC,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,kBAAkB,+BAA+B,CAAC;AAC/D,uCAAuC;AACvC,eAAO,MAAM,aAAa,MAAM,CAAC;AACjC,gEAAgE;AAChE,eAAO,MAAM,UAAU,MAAM,CAAC;AAC9B,eAAO,MAAM,SAAS,MAAM,CAAC;AAC7B,eAAO,MAAM,UAAU,MAAM,CAAC;AAC9B,iDAAiD;AACjD,eAAO,MAAM,UAAU,OAAO,CAAC;AAC/B,mFAAmF;AACnF,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,oFAAoF;AACpF,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAiBjD;AAeD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GACjC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAqCvC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EAClC,UAAU,SAAuB,EACjC,EAAE,SAAU,GACX,MAAM,IAAI,CAoCZ;AAED,0GAA0G;AAC1G,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,GAAG,MAAM,CAQhE;AAOD,yEAAyE;AACzE,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,SAAa,GAAG,MAAM,CAEjF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EACtC,MAAM,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EACrC,IAAI,EAAE,MAAM,GAAG,KAAK,EACpB,aAAa,EAAE,OAAO,EACtB,UAAU,SAAU,GACnB,IAAI,CAsCN;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,OAAO,GAAG,aAAa,CA0BtE"}
1
+ {"version":3,"file":"dock-motion.d.ts","sourceRoot":"","sources":["../../src/dock/dock-motion.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,4 @@
1
- import type { RefObject } from 'react';
1
+ import type { PointerEvent as ReactPointerEvent, RefObject } from 'react';
2
2
  import { type DockIdentityView } from './dock-row.js';
3
3
  import type { DockMark } from './dock-state.js';
4
4
  /**
@@ -32,7 +32,12 @@ export interface DockPillProps {
32
32
  readonly expandLabel: string;
33
33
  readonly form: 'pill' | 'row';
34
34
  readonly onPress: () => void;
35
+ /** §9.1 — the pill IS the drag handle when the tenant allows it. */
36
+ readonly draggable?: boolean;
37
+ readonly dragHandleProps?: {
38
+ onPointerDown?: (event: ReactPointerEvent<HTMLElement>) => void;
39
+ };
35
40
  readonly pillRef?: RefObject<HTMLButtonElement | null>;
36
41
  }
37
- export declare function DockPill({ identity, mark, label, line, expandLabel, form, onPress, pillRef, }: DockPillProps): import("react").JSX.Element;
42
+ export declare function DockPill({ identity, mark, label, line, expandLabel, form, onPress, draggable, dragHandleProps, pillRef, }: DockPillProps): import("react").JSX.Element;
38
43
  //# 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,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,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,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;CACxD;AAED,wBAAgB,QAAQ,CAAC,EACvB,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,WAAW,EACX,IAAI,EACJ,OAAO,EACP,OAAO,GACR,EAAE,aAAa,+BA4Bf"}
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;CACxD;AAED,wBAAgB,QAAQ,CAAC,EACvB,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,WAAW,EACX,IAAI,EACJ,OAAO,EACP,SAAS,EACT,eAAe,EACf,OAAO,GACR,EAAE,aAAa,+BAiCf"}
@@ -1,4 +1,4 @@
1
- import type { RefObject } from 'react';
1
+ import type { PointerEvent as ReactPointerEvent, RefObject } from 'react';
2
2
  import { type WidgetMessages } from '../messages.js';
3
3
  import type { DockControl, DockMark, DockView } from './dock-state.js';
4
4
  /**
@@ -115,6 +115,17 @@ export interface DockRowProps {
115
115
  /** §11 — the mark's accessible name carries the live/rest state in words. */
116
116
  readonly markStateLabel: string;
117
117
  readonly onMarkPress: () => void;
118
+ /**
119
+ * §3.3 (revised 2026-09-11) — the sheet is up, so the two corners the row
120
+ * shares with it are square. An attribute rather than a class, because it
121
+ * is a STATE of the row and not a second kind of row.
122
+ */
123
+ readonly sheetOpen?: boolean;
124
+ /** §9.1 — the MARK is the row's drag handle; `touch-action: none` lands there only. */
125
+ readonly draggable?: boolean;
126
+ readonly dragHandleProps?: {
127
+ onPointerDown?: (event: ReactPointerEvent<HTMLElement>) => void;
128
+ };
118
129
  }
119
- export declare function DockRow({ view, identity, form, messages, captionLine, captionSwapKey, captionTestId, draft, onDraftChange, onSubmit, placeholder, composerDisabled, onControl, onMicDown, onMicUp, interruptLabelled, micOpen, micDisabled, micUnavailableReason, attachBusy, rowRef, inputRef, captionDurationMs, markStateLabel, onMarkPress, }: DockRowProps): import("react").JSX.Element;
130
+ export declare function DockRow({ view, identity, form, messages, captionLine, captionSwapKey, captionTestId, draft, onDraftChange, onSubmit, placeholder, composerDisabled, onControl, onMicDown, onMicUp, interruptLabelled, micOpen, micDisabled, micUnavailableReason, attachBusy, rowRef, inputRef, captionDurationMs, markStateLabel, onMarkPress, sheetOpen, draggable, dragHandleProps, }: DockRowProps): import("react").JSX.Element;
120
131
  //# 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":"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"}
1
+ {"version":3,"file":"dock-row.d.ts","sourceRoot":"","sources":["../../src/dock/dock-row.tsx"],"names":[],"mappings":"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"}
@@ -80,10 +80,20 @@ export interface DockSheetProps {
80
80
  readonly onDismiss: () => void;
81
81
  /** Bumped whenever the contents grew, so the scroll can follow a reader who was at the bottom. */
82
82
  readonly followKey?: unknown;
83
+ /**
84
+ * §3.4 — is the sheet showing the WHOLE transcript rather than the latest
85
+ * exchange?
86
+ *
87
+ * False→true is the shopper asking for the history, by either route: the
88
+ * "Show conversation" control, or dragging the sheet open by its handle.
89
+ * That one transition is the only thing this prop is read for — see the
90
+ * follow effect's `justRevealed`.
91
+ */
92
+ readonly historyRevealed?: boolean;
83
93
  readonly sheetRef?: RefObject<HTMLDivElement | null>;
84
94
  /** 0 under reduced motion (§7.1 rule 10). */
85
95
  readonly durationMs: number;
86
96
  readonly dragHandleLabel: string;
87
97
  }
88
- export declare function DockSheet({ snap, onSnapChange, label, peekOnly, header, children, onDismiss, followKey, sheetRef, durationMs, dragHandleLabel, }: DockSheetProps): import("react").JSX.Element;
98
+ export declare function DockSheet({ snap, onSnapChange, label, peekOnly, header, children, onDismiss, followKey, historyRevealed, sheetRef, durationMs, dragHandleLabel, }: DockSheetProps): import("react").JSX.Element;
89
99
  //# sourceMappingURL=dock-sheet.d.ts.map
@@ -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;AAKf;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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,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,QAAQ,EACR,UAAU,EACV,eAAe,GAChB,EAAE,cAAc,+BAmThB"}
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,+BAkXhB"}
@@ -218,4 +218,45 @@ export declare const idleDockInput: DockStateInput;
218
218
  * @returns everything the row, the caption and the sheet need for one render
219
219
  */
220
220
  export declare function deriveDockState(input: DockStateInput): DockView;
221
+ /**
222
+ * A transcript turn, as the EXCHANGE split reads it: its speaker and nothing
223
+ * else.
224
+ *
225
+ * §3.4's split is a decision about the conversation's shape, so it lives here
226
+ * with the rest of them — and it takes speakers rather than turns because a
227
+ * turn carries text, cards, attachments, a locale and a delivery state, none
228
+ * of which this decision looks at. Nothing about the widget's turn type
229
+ * therefore reaches this module, which is what keeps it assertable without a
230
+ * DOM (`dock-state.test.ts`).
231
+ */
232
+ export type DockSpeaker = 'caller' | 'agent' | 'event';
233
+ /**
234
+ * §3.4 (revised 2026-09-11) — where the LATEST EXCHANGE begins.
235
+ *
236
+ * An exchange is the shopper's line and the reply to it. The latest one
237
+ * therefore starts at the LAST caller turn and runs to the end, so a reply
238
+ * that arrived as three turns (a filler, the answer, the cards) stays whole.
239
+ *
240
+ * Two cases are not that shape and both are real:
241
+ *
242
+ * - the shopper has not spoken yet. The concierge opens with a greeting of
243
+ * its own, and a proactive nudge can add a second line before anybody has
244
+ * typed; the latest exchange is then the LAST agent turn alone, because
245
+ * two unanswered agent lines are two things said, not one exchange.
246
+ * - a `speaker: 'event'` row — §3.4's handoff marker. It is something that
247
+ * happened TO an exchange rather than a turn in one, so it never starts a
248
+ * new one and never ends the search for the caller line above it.
249
+ */
250
+ export declare function latestExchangeStart(speakers: readonly DockSpeaker[]): number;
251
+ /**
252
+ * How many exchanges the transcript holds — the number "Show conversation"
253
+ * is offered on (§3.4: the control exists only when there is more than one).
254
+ *
255
+ * A caller line opens an exchange; anything said BEFORE the first one (the
256
+ * greeting, a proactive nudge) is an exchange of its own, because it is
257
+ * something the shopper can scroll back to and would otherwise be counted as
258
+ * nothing at all — leaving a dock that shows a greeting, then an answer, and
259
+ * claims there is nothing more to see.
260
+ */
261
+ export declare function exchangeCount(speakers: readonly DockSpeaker[]): number;
221
262
  //# sourceMappingURL=dock-state.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"dock-state.d.ts","sourceRoot":"","sources":["../../src/dock/dock-state.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"dock-state.d.ts","sourceRoot":"","sources":["../../src/dock/dock-state.ts"],"names":[],"mappings":"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"}
@@ -67,6 +67,15 @@ export interface DockLayoutView {
67
67
  readonly desktopWidth: DesktopWidth;
68
68
  /** §5.4. `never` has no pill at all — no recede, no minimise control. */
69
69
  readonly minimised: 'never' | 'shopper' | 'startMinimised';
70
+ /**
71
+ * §9.1 (added 2026-09-11) — may a DESKTOP shopper drag the dock sideways?
72
+ *
73
+ * Optional, defaulted `true`, because the api field is younger than this
74
+ * component: a host still passing a `layout` without it must get §9.1's
75
+ * default rather than a dock that refuses to move. Mobile never drags
76
+ * whatever this says — the gesture competes with the page's own scroll.
77
+ */
78
+ readonly draggable?: boolean;
70
79
  }
71
80
  /** The tenant's `copy[locale]` (§9.1), as the dock reads it. */
72
81
  export interface DockCopyView {
@@ -191,6 +200,31 @@ export interface DockProps {
191
200
  readonly shelf?: ChatCards;
192
201
  /** The text session's transcript, supplied by the caller (`voice-widget.tsx`). */
193
202
  readonly transcript?: ReactNode;
203
+ /**
204
+ * §3.4 (revised 2026-09-11) — the LATEST EXCHANGE, for a text session's
205
+ * `peek` sheet: the shopper's last line and the reply to it, with whatever
206
+ * that reply brought.
207
+ *
208
+ * A second NODE rather than a count the dock slices itself, because the
209
+ * dock is handed a rendered transcript and has no idea what a turn is. The
210
+ * host renders the same turn list twice from one component — sliced at
211
+ * `latestExchangeStart` (`dock-state.ts`) — so a card, a price or an
212
+ * attachment cannot bind differently in the two views.
213
+ *
214
+ * Absent ⇒ the whole transcript is shown at both snap points, which is what
215
+ * every host that has not been updated gets and is the behaviour this
216
+ * revision replaced.
217
+ */
218
+ readonly latestExchange?: ReactNode;
219
+ /**
220
+ * How many exchanges the transcript holds (`exchangeCount`).
221
+ *
222
+ * The ONE number "Show conversation" is offered on: at one exchange the
223
+ * latest view IS the transcript, and a control that expands a sheet to show
224
+ * exactly what it already showed is a control that teaches the shopper not
225
+ * to press things.
226
+ */
227
+ readonly exchangeCount?: number;
194
228
  /** Anything the sheet holds beside its main content: the basket, chips, the handoff marker. */
195
229
  readonly sheetExtra?: ReactNode;
196
230
  /** Bumped when the sheet's contents grew, so the scroll can follow a reader at the bottom. */
@@ -1 +1 @@
1
- {"version":3,"file":"dock.d.ts","sourceRoot":"","sources":["../../src/dock/dock.tsx"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"dock.d.ts","sourceRoot":"","sources":["../../src/dock/dock.tsx"],"names":[],"mappings":"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"}
@@ -41,8 +41,18 @@ export declare const DESKTOP_GUTTER = 16;
41
41
  export declare const BOTTOM_FLOOR = 10;
42
42
  /** Desktop bottom inset (§3.1). */
43
43
  export declare const DESKTOP_BOTTOM = 16;
44
- /** Gap between the sheet's floor and the row above it (§3.3). */
45
- export declare const SHEET_GAP = 8;
44
+ /**
45
+ * Gap between the sheet's floor and the row above it (§3.3).
46
+ *
47
+ * ZERO since 2026-09-11. The 8 px gap read as two unrelated boxes stacked on
48
+ * a merchant's page rather than as one surface the concierge grew, which is
49
+ * what §3.3's "a bottom sheet whose floor is the row" was always describing.
50
+ * The constant stays rather than being deleted: it is the number the sheet's
51
+ * `bottom` is written from, both renderers have to agree about it, and a
52
+ * reader who finds `bottom: var(--wgt-row-h)` in the stylesheet needs
53
+ * somewhere that says why there is nothing added to it.
54
+ */
55
+ export declare const SHEET_GAP = 0;
46
56
  /** The one breakpoint. Below it the dock is full-width and thumb-anchored. */
47
57
  export declare const DESKTOP_BREAKPOINT = 768;
48
58
  /**
@@ -93,6 +103,68 @@ export declare const SHEET_TOP_CLEARANCE = 24;
93
103
  * storage key is two ways for one preference to be lost.
94
104
  */
95
105
  export declare const DOCK_MINIMISED_STORAGE_KEY = "wgt_dock_minimised";
106
+ /**
107
+ * §9.1's `layout.draggable` — where a shopper's own horizontal position is
108
+ * remembered, per visitor and per origin.
109
+ *
110
+ * Beside {@link DOCK_MINIMISED_STORAGE_KEY} and for the same reason: the core
111
+ * dock reads it BEFORE first paint (so a returning shopper never watches the
112
+ * dock slide across the page to where they left it) and the React dock writes
113
+ * it when a drag settles. Two copies of a storage key is two ways for one
114
+ * preference to be lost.
115
+ */
116
+ export declare const DOCK_ALIGN_STORAGE_KEY = "wgt_dock_align";
117
+ /**
118
+ * Under this many pixels of travel, a press-and-release is a TAP (§9.1).
119
+ *
120
+ * Six rather than the sheet drag's four: the sheet's handle does nothing but
121
+ * drag, so a hair-trigger costs nothing, while the pill and the mark are the
122
+ * dock's two most-pressed controls and a mouse that travels three pixels
123
+ * between press and release is a click in every other piece of software the
124
+ * shopper uses. Below it the gesture never became a drag at all — no
125
+ * alignment is written and the press's own click is left to run.
126
+ */
127
+ export declare const DRAG_TAP_SLOP_PX = 6;
128
+ /**
129
+ * Where a released drag lands (§9.1): the third of the viewport the dock's
130
+ * CENTRE finished in.
131
+ *
132
+ * Thirds rather than nearest-edge, because `center` is one of the three
133
+ * answers and an edge-distance rule can never return it. Pure, and shared by
134
+ * both renderers — the pill's drag is `cdn/dock-dom.ts`'s and the row's is
135
+ * `dock/dock-drag.ts`'s, and a dock that snapped differently depending on
136
+ * which one the shopper grabbed would be a bug nobody could describe.
137
+ *
138
+ * A degenerate viewport (0 wide, or a `NaN` centre from a `pointercancel`
139
+ * that carried no coordinates) resolves to `center`: the tenant's own default,
140
+ * and the only answer that cannot put the dock off the edge of the screen.
141
+ */
142
+ export declare function snapAlign(centreX: number, viewportWidth: number): DesktopAlign;
143
+ /**
144
+ * `localStorage`, wrapped once for the whole dock.
145
+ *
146
+ * Both preferences the dock remembers (§5.4's minimise, §9.1's alignment) are
147
+ * read by `cdn/dock-dom.ts` before first paint and written by the React dock,
148
+ * so four near-identical `try`/`catch` blocks were four copies of the same
149
+ * three lines in an artefact every visitor to every merchant page downloads.
150
+ *
151
+ * The `try` is the load-bearing part and is not optional: `localStorage`
152
+ * THROWS on access — not on use — in a third-party frame with storage access
153
+ * blocked, in Safari's private mode past its quota, and behind a merchant's
154
+ * own cookie wall. A dock that took the storefront's script down over a
155
+ * remembered position is worse than a dock that forgets one.
156
+ */
157
+ export declare function readStored(win: Window, key: string): string | undefined;
158
+ export declare function writeStored(win: Window, key: string, value: string): void;
159
+ /**
160
+ * The shopper's remembered alignment, or `undefined` where there is none.
161
+ *
162
+ * Anything that is not one of §9.1's three values is `undefined` rather than
163
+ * a default: the key is on the MERCHANT's origin, shared with whatever else
164
+ * their page stores, and a value we did not write is not a preference.
165
+ */
166
+ export declare function readStoredAlign(win: Window): DesktopAlign | undefined;
167
+ export declare function persistAlign(win: Window, align: DesktopAlign): void;
96
168
  /** §5.6 — how long a proactive nudge holds the row open before it recedes. */
97
169
  export declare const PROACTIVE_NUDGE_MS = 8000;
98
170
  export type DesktopWidth = keyof typeof DESKTOP_WIDTHS;