efficient-easel 22.0.0 → 23.1.0

package/README.md

@@ -425,14 +425,14 @@ unknown pastes only between two components of the same type. An empty
 ## The document — `efficient-easel/data`
 
 `efficient-easel/data` (added in 0.67.0) is the bottom layer of the engine that
-replaces the old editor (the blueprint's step 1.1): the saved document as pure
+replaces the old library (the blueprint's step 1.1): the saved document as pure
 functions. It imports nothing and touches no browser global, so the editor's
 store, a Next server component, a Node script and a test all call the same
 code.
 
 **The format does not change.** A document is exactly what Puck 0.20 saves —
 `{ root: { props }, content: [...], zones: {} }`, with a block's children
-inline in its slot props — so no campaign or page migrates when the old editor goes.
+inline in its slot props — so no campaign or page migrates when the old library goes.
 
 ```ts
 import { normalizeData, find, insert, move, remove, duplicate, setProps, setRoot, createNode, walk, ROOT_LIST } from 'efficient-easel/data';
@@ -447,15 +447,16 @@ next = setProps(next, config, id, { level: 3 });
 
 | Export | Notes |
 |---|---|
-| `normalizeData(data, config)` | the old editor's load: missing top-level slots become `[]`, `zones` becomes `{}`, the root's `defaultProps` fill what is missing. Older formats (props written on `root`, children parked in `zones`) are converted the way the old editor's `migrate()` converts them. **A document already in shape comes back as the same object.** |
+| `normalizeData(data, config)` | the old library's load: missing top-level slots become `[]`, `zones` becomes `{}`, the root's `defaultProps` fill what is missing. Older formats (props written on `root`, children parked in `zones`) are converted the way the old library's `migrate()` converts them. **A document already in shape comes back as the same object.** |
 | `find`, `walk`, `slotsOf`, `getList` | Read. `walk` visits parent before children, slots in declaration order; returning a node from the visitor replaces it. |
-| `insert`, `move`, `remove`, `duplicate` | Change the tree. `move` within one list takes the index AFTER the move (the old editor's rule). |
+| `isNode`, `isNodeList` | Shape checks. `isNode`: a string `type` and a `props` object. `isNodeList`: a slot's array — non-empty, every item a node; a list field (stats rows) is not one. The one answer for the easel and every host; do not write your own. |
+| `insert`, `move`, `remove`, `duplicate` | Change the tree. `move` within one list takes the index AFTER the move (the old library's rule). |
 | `setProps`, `setRoot` | Merge props. A key keeps its place; a patch that changes nothing returns the same document. |
 | `createNode(config, type, props?)`, `newId(type)` | A new block the way the Add panel makes one: `{ ...defaultProps, id }`, ids `<Type>-<uuid>`. |
-| `zoneKey`, `parseZoneKey`, `ROOT_LIST` | A place is `{ parentId, slot, index }`; the top-level list is `{ parentId: 'root', slot: 'default-zone' }` — the two halves of the old editor's zone key. |
+| `zoneKey`, `parseZoneKey`, `ROOT_LIST` | A place is `{ parentId, slot, index }`; the top-level list is `{ parentId: 'root', slot: 'default-zone' }` — the two halves of the old library's zone key. |
 
 `config` is the app's block config: only `fields` (which props are slots, including
-slots inside `object` / `array` fields) and `defaultProps` are read, so an old editor
+slots inside `object` / `array` fields) and `defaultProps` are read, so an old library
 `Config` works as it is. A type the config does not know is kept whole.
 
 Every edit copies only the path to the change, so an untouched block is the
@@ -566,11 +567,11 @@ base words under a translation, markers on untranslated rows). Routing and
 `efficient-easel/blocks` (added in 0.92.0) holds the types a block is written
 with: Puck 0.20's `Config`, `ComponentConfig`, `Fields`, `Field`,
 `CustomField`, `ComponentData`, `Data`, `Slot` and `SlotComponent`, with the
-same generics. An app that typed its blocks with the old editor's imports them from here
+same generics. An app that typed its blocks with the old library's imports them from here
 instead, and no block changes. It is types only: nothing in it exists at
 runtime. One key is the engine's own: `translatable` on a field (0.97.0),
 which says whether the prop is written again per language (the translation
-overlay, above). It is optional, so a field written for the old editor is still a field.
+overlay, above). It is optional, so a field written for the old library is still a field.
 
 ```ts
 import type { Config, CustomField, Slot } from 'efficient-easel/blocks';
@@ -591,9 +592,9 @@ const config: Config<{ Hero: HeroProps }> = {
 ## The published renderer — `efficient-easel/render`
 
 `efficient-easel/render` (added in 0.68.0) draws a saved document the way the
-published site does — the drop-in for the old editor's `<Render>` (the blueprint's step
+published site does — the drop-in for the old library's `<Render>` (the blueprint's step
 1.2). Same config, same document, **the same HTML**: the specs hold it to
-Puck 0.20.2's markup, recorded from the old editor's own `<Render>`, byte for byte.
+Puck 0.20.2's markup, recorded from the old library's own `<Render>`, byte for byte.
 
 ```tsx
 import { Render } from 'efficient-easel/render';
@@ -603,18 +604,18 @@ import { Render } from 'efficient-easel/render';
 
 It is a plain function: **no hook, no context, no `'use client'`**. It runs in a
 server component, a client component or a script, and `Render(props)` called
-directly returns the element tree. (The old editor's reads the document from a context
+directly returns the element tree. (The old library's reads the document from a context
 and builds props in hooks, so it only runs as a client component.) Whether the
 blocks themselves can run on the server is up to the blocks.
 
-The block authoring shape is the old editor's, so an app passes the config it has: a
+The block authoring shape is the old library's, so an app passes the config it has: a
 block's `render` gets its props, `editor`, and each slot as a component —
 `render: ({ content: Content }) => <Content className="grid" />` — which draws
 `<div className style>` around its blocks. The top-level list is wrapped in one
-plain `<div>`, and `editor` carries exactly what the old editor's client `<Render>` gave
+plain `<div>`, and `editor` carries exactly what the old library's client `<Render>` gave
 a block at each level. A type the config does not know draws nothing.
 
-**The old editor's name is gone (22.0.0).** The block prop is `editor`, the
+**The old library's name is gone (22.0.0).** The block prop is `editor`, the
 canvas markup `data-easel-*`, the subpaths `screen/lib/document/*`, the
 inspector mode `{ kind: "selection" }` and the root's id `page-root`. What was
 removed, and what replaces each name, is in the CHANGELOG under 22.0.0.
@@ -638,7 +639,7 @@ always has it.
 
 `className` (0.95.0) is an opt-in class for that top-level wrapper, for a host
 whose stylesheet has to reach it: `<Render … className="page" />`. Left out,
-the wrapper is bare and the markup is the old editor's.
+the wrapper is bare and the markup is the old library's.
 
 ## What a block draws with — `efficient-easel/draw`, `efficient-easel/draw/client`
 
@@ -690,7 +691,7 @@ graph to an exact list of files and imports.
 
 `efficient-easel/canvas` (added in 0.70.0, blueprint step 2.1) is the one way
 into the editor's canvas iframe — `#preview-frame`, the engine's own
-same-origin canvas frame (the old editor's, until the editors left it). It replaces the
+same-origin canvas frame (the old library's, until the editors left it). It replaces the
 editors' own polling loops, host-head style injection and hand-written
 coordinate maths.
 
@@ -707,7 +708,7 @@ const tick = useCanvasLayout(canvas);                                    // re-m
 |---|---|
 | `useCanvasFrame(rootRef, { selector?, readySelector? })` | `{ frame, document, window }` or `null`. Found by a MutationObserver and the frame's `load` event — never a timer. `readySelector` waits for the canvas to be drawn in a loaded-but-empty document. |
 | `useCanvasEvent(canvas, type, handler, { on?, capture? })` | A listener on the canvas document (or window) that moves to a replacement document and always calls the latest handler, without re-binding on every render. |
-| `useCanvasStyle(canvas, key, css)` | A `<style>` in the canvas document's head only — re-injected into a replacement, put back if something empties the head (the old editor's AutoFrame does, once), removed on unmount, never written to the host page. |
+| `useCanvasStyle(canvas, key, css)` | A `<style>` in the canvas document's head only — re-injected into a replacement, put back if something empties the head (the old library's AutoFrame does, once), removed on unmount, never written to the host page. |
 | `useCanvasLayout(canvas)` | A number that changes when the canvas scrolls, resizes, is replaced, or the host scrolls or resizes (plus two settle passes). |
 | `frameRectToHost`, `framePointToHost`, `frameScale` | A box or point measured inside the frame, on the host page — through the frame's SCALE (a phone view drawn small). |
 | `fitCanvas({ available, width, maxScale })` | The canvas width and the scale that fits it into the pane. |
@@ -787,7 +788,19 @@ A host's PARTS join the chain (W0): through `CanvasPartsContext` (a
 host says which part of the innermost block is under the pointer, and
 `clickPickPart` puts it after its block: a container's part is one more rung, a
 block with no lists is picked with its part at once. The hover outline draws
-the part (`is-hover-part`); Escape lets a part go before it climbs.
+the part (`is-hover-part`); Escape lets a part go before it climbs. One box per text (Lewis 2026-10-26): a part gets a box of its own
+(`is-hover-part`; with the host's `selectedPart(doc)`, the selected rectangle
+`is-selected is-selected-part` while the block's selected box stands down),
+unless it is its block's only part (`CanvasPart.whole`, a Text block's words)
+in a block with no lists: then the block and its words are one rung and share
+the block box, where the drag handle's label is. With no `whole`, a block with
+no lists is read as that one rung. Without `selectedPart`, the block box as
+before. The LABEL names what is selected (Lewis 2026-10-26):
+while a part with a box of its own is open, the screen hands the drag layer a
+`tag` (`CanvasPart.label`, the Layers name) drawn on the part's box like the
+handle but with no drag dots, and the block's handle is not drawn; to drag
+the block, select the block first or drag its Layers row (`partHasOwnBox` is
+the one rule for the box and the label).
 
 ## Autosave — `efficient-easel/autosave`
 
@@ -997,7 +1010,7 @@ const easel = createEasel<EaselConfig>({ config, data, onChange: (doc) => autosa
   - `bindUndoKeys(target, editor, { leaveTyping: true })` (0.106.0) leaves a
     press where a person types — a text field, a textarea, an editable
     region — to that field's own undo. Left out, a press there undoes the
-    easel's step, as the old editor's did; the provider and the canvas bind so.
+    easel's step, as the old library's did; the provider and the canvas bind so.
 - **Two tabs since 4.0.0: Design and Animation.** A field's `bucket` is one
   of `SETTINGS_BUCKETS`; anything else (the 3.x `Content`, `Style`, `Layout`)
   is ignored, so the rows stay in the tab above them. Inside Design the host
@@ -1022,12 +1035,19 @@ const easel = createEasel<EaselConfig>({ config, data, onChange: (doc) => autosa
   character but letters, digits, `-` and `_` becomes `-u<hex>-`, so `" text"`
   is `<prefix>-fold--u20-text`); the key itself is unchanged for
   `closedFolds`, `onFold` and `data-fold`.
+- **In the phone view `planFields` plans only rows with a phone value.** When
+  `showWhenContext.device` is `"mobile"`, a row that is not a `deviceField("mobile", …)`
+  is not planned or drawn (it would write the desktop value). A heading mark, a
+  slot and a field that draws no control anywhere stay; the `Inspector`'s `lead`
+  is not drawn. `fieldShownInView(field, device)`
+  is the one answer, exported from `efficient-easel/fields`. Desktop, tablet and
+  no device: every row, as before.
 - **`planFields().rows` holds `slot` rows.** They draw nothing and are there so
   the slot's name has a bucket. Filter `row.field.type !== 'slot'` before
   drawing or counting rows of your own.
 - **Inserting a block runs no resolver; `easel.resolveNode` does.** The
-  `insert` action puts the block in with its `defaultProps`, as the old editor's reducer
-  did. What ran a new block's `resolveData` in the old editor was its own drop from the
+  `insert` action puts the block in with its `defaultProps`, as the old library's reducer
+  did. What ran a new block's `resolveData` in the old library was its own drop from the
   component list, and the engine has no drop of its own: the Add list's click
   and the drag's drop are the host's. So follow an insert with it:
 
@@ -1212,7 +1232,7 @@ words, its marks and buttons of the layer's own are `blockLook.rowName`,
 `rowPreview`, `rowMarks` and `rowActions`. A block config's
 `permissions.delete` / `duplicate` set to `false` takes the action off the
 block's rows and its menu, and the inspector is handed the answer for its
-head (`nodeActions`). The frame's words (Page settings, the pinned labels,
+head (`nodeActions`). The frame's words (the pinned labels,
 the band's) are `screen` words too.
 
 Its canvas can be a mail preview's (0.105.0). `devices.fit: "shrink"` draws a
@@ -1330,7 +1350,9 @@ layer, Copy, Copy style). Inside another app's page (`ownsDocument` false) ⌘Z
 editor's ground (its root takes focus, never a tab stop), and never in a text
 field or an editable region, where they are the field's own. A row's
 right-click is that row's: a pinned node's row opens its node's menu, a rung's
-row opens none, and the ground's "Page settings" is `screen.pageSettings`.
+row opens none, and the ground's "This page" (`screen.pageStyles`) is the
+layer's `ScreenBridges.openPageStyles`, drawn only where the layer hands one.
+The tree has no row for the document's own settings (23.0.0).
 And `blockRules.stripCopy(node)` cleans every copy the screen makes — the
 menu's Duplicate and Paste, ⌘V, a saved section put in from Add — of what
 only its original may hold (the campaign designer's baked picture).

package/dist/{CanvasDragLayer-B6Yn9S8T.d.ts → CanvasDragLayer-NZpaX6aq.d.ts}

@@ -1,7 +1,7 @@
 import * as react from 'react';
-import { C as CanvasTarget$1 } from './watch-D0bNZRtU.js';
-import { S as SlotAddress, P as Place } from './types-DlQIM1YO.js';
-import { D as DragSession } from './session-CrWwDt7Z.js';
+import { C as CanvasTarget$1 } from './watch-Unf6SfUf.js';
+import { S as SlotAddress, P as Place } from './types-Dq180WRV.js';
+import { D as DragSession } from './session-EsjORLQ0.js';
 import { D as DragWords } from './words-SD4neL0n.js';
 
 /**
@@ -196,6 +196,17 @@ type CanvasDragLayerProps<I> = {
         /** What the outline says the drop does ("Replace image"). */
         label?: (item: I, source: CanvasSource<I>) => string;
     };
+    /**
+     * The NAME of what is selected when it is a part with a box of its own (a
+     * section's scrolling bar; Lewis 2026-10-26: the label says what is
+     * selected, on the corner of its box). Drawn as the handle is drawn, on the
+     * part's top-left corner, with no drag dots: a part does not drag. The host
+     * leaves the block's handle off meanwhile (`choose`). Absent: no tag.
+     */
+    tag?: {
+        element: Element;
+        label: string;
+    } | null;
     /** The handle CLICKED, not dragged: select what it names. Absent: a click does nothing. */
     onPick?: (item: I) => void;
     /** "+ Add section" in a seam: open the Add panel at that place. */
@@ -207,7 +218,7 @@ type CanvasDragLayerProps<I> = {
     readOnly?: boolean;
     /** Re-measure when this changes — the document's revision. Layout changes re-measure by themselves. */
     revision?: unknown;
-    /** How the canvas is measured. Default: the old editor's markers (./measure). */
+    /** How the canvas is measured. Default: the old library's markers (./measure). */
     measure?: (canvas: CanvasTarget$1, layer: Element) => MeasuredCanvas;
     /**
      * The layer's own words in the host's language:

package/dist/{ScreenDocumentContext-BIK3uWtF.d.ts → ScreenDocumentContext-BDLUYzlM.d.ts}

@@ -621,15 +621,15 @@ type ScreenDocumentValue = {
      *  editing right now. Null while loading and between retargets, so it also
      *  keys any once-per-document work (e.g. the pinned-chrome seed). */
     docId: string | null;
-    /** The document exactly as it was LOADED from the backend: the old editor's initial
+    /** The document exactly as it was LOADED from the backend: the old library's initial
      *  state, and the persisted snapshot a load-time seed must measure itself
-     *  against. Null while loading. Edits live in the old editor's own store, so this does
+     *  against. Null while loading. Edits live in the old library's own store, so this does
      *  NOT track them — it stays the last-loaded layout for the whole session. */
     data: Data | null;
     /** The freshest layout the merchant is actually viewing — the latest edit made
      *  since load (tracked on every onChange, even after the autosave settles), else
      *  the last-loaded `data`. Lets a feature snapshot the live view (e.g. the
-     *  read-only origin backdrop in footer focus) without reaching into the old editor's store.
+     *  read-only origin backdrop in footer focus) without reaching into the old library's store.
      *  Lean accessor (ISP) — never exposes the ref. */
     getLiveData: () => Data | null;
     error: string | null;
@@ -659,7 +659,7 @@ type ScreenDocumentValue = {
     /** "Retry now": a failed save goes again at once instead of waiting out its
      *  backoff. */
     retrySave: () => void;
-    /** Autosave — hand every the old editor onChange to this. */
+    /** Autosave — hand every the old library onChange to this. */
     onChange: (next: Data) => void;
     /** Persist the pending edit immediately; resolves to whether nothing is left
      *  unsaved. */

package/dist/blocks/index.d.ts

@@ -1,17 +1,17 @@
 import { ReactElement, FC, CSSProperties, ReactNode, JSX } from 'react';
-import { P as Permissions, A as AppState } from '../types-DFxBChE3.js';
+import { P as Permissions, A as AppState } from '../types-BljCVdzR.js';
 import '../data/index.js';
-import '../types-DlQIM1YO.js';
-import '../resolve-AJ6WF4EL.js';
-import '../plan-CRUh2kVK.js';
+import '../types-Dq180WRV.js';
+import '../resolve-Bz4mszpL.js';
+import '../plan-D0DgSLnY.js';
 
 /**
  * efficient-easel/blocks — how a block is WRITTEN: its config, its fields, the
  * props its `render` receives and the document it lands in.
  *
- * Blueprint default #3 keeps the old editor's block writing, so the ~119 blocks both apps
+ * Blueprint default #3 keeps the old library's block writing, so the ~119 blocks both apps
  * wrote move onto the engine without a line changed. Until 6.1 those blocks were
- * typed by importing the old editor's own types, which kept the old editor package in both apps'
+ * typed by importing the old library's own types, which kept the old library's package in both apps'
  * dependencies after nothing ran it any more. These are the same shapes, written
  * here — Puck 0.20's `Config`, `ComponentConfig`, `Fields`, `Field`,
  * `CustomField`, `ComponentData`, `Data`, `Slot` and `SlotComponent` — so an app
@@ -20,7 +20,7 @@ import '../plan-CRUh2kVK.js';
  * WHAT IS LEFT OUT, ON PURPOSE:
  *   - the `ConfigParams` form of `Config<{ components, root, fields }>` and the
  *     user field-type extension it carries (neither app uses it);
- *   - everything about the old editor's own app — its store, overrides, plugins and
+ *   - everything about the old library's own app — its store, overrides, plugins and
  *     history. Those are the engine's now (`efficient-easel/easel`).
  *
  * The `editor` prop is what every block's `render` destructures
@@ -49,7 +49,7 @@ type BaseField = {
     metadata?: Metadata;
     visible?: boolean;
     /**
-     * NOT THE OLD EDITOR'S — the engine's (0.97.0). Whether this prop is written again in
+     * NOT THE OLD LIBRARY'S — the engine's (0.97.0). Whether this prop is written again in
      * each language of a multilingual page (`efficient-easel/data`, the
      * translation overlay). Left out, a `text` or `textarea` field is and every
      * other type is not, so a `custom` field that edits words, or a picture with
@@ -104,7 +104,7 @@ type ObjectField<Props = AnyRecord> = BaseField & {
         [SubPropName in keyof Props]: Field<Props[SubPropName]>;
     };
 };
-/** A custom field's drawing: called with the old editor's six props, as both apps wrote them. */
+/** A custom field's drawing: called with the old library's six props, as both apps wrote them. */
 type CustomFieldRender<Value> = (props: {
     field: CustomField<Value>;
     name: string;
@@ -124,9 +124,9 @@ type SlotField = BaseField & {
     disallow?: string[];
 };
 /**
- * The old editor's `external` field: a value picked from a list the app fetches. Neither
+ * The old library's `external` field: a value picked from a list the app fetches. Neither
  * app has one and the Inspector does not draw it — it is in the union only so
- * the union is the old editor's, and a function that takes `Fields` takes the old editor's too.
+ * the union is the old library's, and a function that takes `Fields` takes the old library's too.
  */
 type ExternalField<Props = AnyRecord> = BaseField & {
     type: 'external';

package/dist/canvas/index.d.ts

@@ -1,6 +1,6 @@
 import { RefObject } from 'react';
-import { C as CanvasTarget, W as WatchOptions } from '../watch-D0bNZRtU.js';
-export { B as BLOCK_SELECTOR, a as CANVAS_SELECTOR, L as LIST_SELECTOR, i as isFrameReady, w as watchCanvasFrame } from '../watch-D0bNZRtU.js';
+import { C as CanvasTarget, W as WatchOptions } from '../watch-Unf6SfUf.js';
+export { B as BLOCK_SELECTOR, a as CANVAS_SELECTOR, L as LIST_SELECTOR, i as isFrameReady, w as watchCanvasFrame } from '../watch-Unf6SfUf.js';
 export { R as REPEAT_ATTRIBUTE, a as REPEAT_INDEX_ATTRIBUTE, i as isRepeatCopy, m as mainCopyOf, q as queryAllCopies, b as queryMainCopy } from '../repeat-D65bJS8d.js';
 
 /**
@@ -38,10 +38,19 @@ declare function nodeIdAt(target: EventTarget | null, attribute?: string): strin
  * the canvas's wrapper, and the wrapper's own box is the answer. A block whose
  * drawing leaves the wrapper's flow (the website's header bar is
  * `position: fixed`) leaves the wrapper with no height; then the union of what
- * it drew, its child elements, is the box. Never null: a wrapper with nothing
- * drawn is its own empty box.
+ * it drew is the box: each child element with a box of its own, and inside a
+ * child with none (a host's own wrapper divs round the bar), what that child
+ * drew, the same way. Never null: a wrapper with nothing drawn is its own empty
+ * box.
  */
 declare function drawnBox(el: Element): Box;
+/** Whether one element holds the other (or is it): the same words, however the host stamps them. */
+declare function related(a: Element, b: Element): boolean;
+/** How far the box round typed or selected words stands clear of them, in px
+ *  (Lewis 2026-10-14). The one home: the canvas sets `--es-words-clear` from
+ *  it (`.is-typing`, `.is-selected.is-words` read that, easel.css) and the
+ *  drag layer measures the handle's corner from it. */
+declare const WORDS_CLEAR = 4;
 interface Box {
     left: number;
     top: number;
@@ -134,10 +143,10 @@ declare function removeCanvasStyle(doc: Document, key: string): void;
 /**
  * efficient-easel/canvas — the one way into the editor's canvas frame.
  *
- * Step 2.1 of the engine that replaces the old editor (blueprint "From The Ground Up
+ * Step 2.1 of the engine that replaces the old library (blueprint "From The Ground Up
  * For Efficient Editor", 2026-09-29). Both editors draw their canvas in an
- * iframe — the old editor's `#preview-frame` today, the engine's own same-origin
- * CanvasFrame once the editors leave the old editor — and each reached into it its own
+ * iframe — the old library's `#preview-frame` today, the engine's own same-origin
+ * CanvasFrame once the editors leave the old library — and each reached into it its own
  * way: eight polling loops with eight intervals, stylesheets pushed into the
  * host `<head>` hoping to be mirrored, key listeners re-bound on a one-second
  * timer, coordinate conversions that forgot the frame's scale. This module is
@@ -180,10 +189,13 @@ type CanvasTypingEvent = CustomEvent<{
  * can and are not being typed, else null. The layer over the canvas says how
  * to start — "Double-click to edit" — on that block (Lewis 2026-10-20: one
  * click on a Text block looked like typing, and nothing said it needs two).
+ * `words`: the selected words when they wear the typing box (Lewis 2026-10-26,
+ * option B), for the layer's handle and hint to sit on that box's corners.
  */
 declare const CANVAS_TYPABLE_EVENT = "easel:canvas-typable";
 type CanvasTypableEvent = CustomEvent<{
     id: string | null;
+    words?: Element;
 }>;
 type CanvasEventMap = DocumentEventMap & WindowEventMap & {
     [CANVAS_TYPING_EVENT]: CanvasTypingEvent;
@@ -212,7 +224,7 @@ declare function useCanvasTyping(canvas: CanvasTarget | null): boolean;
  * back in a replacement document, and take it out on unmount. An empty string
  * removes it. Nothing is written to the host page.
  *
- * "Keep" means it comes back if something else takes it out. The old editor's AutoFrame
+ * "Keep" means it comes back if something else takes it out. The old library's AutoFrame
  * empties the frame's `<head>` once, when the host styles it mirrors have
  * loaded (`doc.head.innerHTML = ""` in CopyHostStyles), and nothing orders that
  * after the canvas is published — so a sheet written first would silently go.
@@ -234,4 +246,4 @@ declare function useCanvasLayout(canvas: CanvasTarget | null, { settle }?: {
     settle?: readonly number[];
 }): number;
 
-export { BLOCK_ATTRIBUTE, type Box, CANVAS_TYPABLE_EVENT, CANVAS_TYPING_EVENT, type CanvasFit, CanvasTarget, type CanvasTypableEvent, type CanvasTypingEvent, WatchOptions, clientPointToLayer, drawnBox, elementScale, fitCanvas, framePointToHost, frameRectToHost, frameRectToLayer, frameScale, isTypingTarget, nodeIdAt, removeCanvasStyle, setCanvasNonce, upsertCanvasStyle, useCanvasEvent, useCanvasFrame, useCanvasLayout, useCanvasStyle, useCanvasTyping };
+export { BLOCK_ATTRIBUTE, type Box, CANVAS_TYPABLE_EVENT, CANVAS_TYPING_EVENT, type CanvasFit, CanvasTarget, type CanvasTypableEvent, type CanvasTypingEvent, WORDS_CLEAR, WatchOptions, clientPointToLayer, drawnBox, elementScale, fitCanvas, framePointToHost, frameRectToHost, frameRectToLayer, frameScale, isTypingTarget, nodeIdAt, related, removeCanvasStyle, setCanvasNonce, upsertCanvasStyle, useCanvasEvent, useCanvasFrame, useCanvasLayout, useCanvasStyle, useCanvasTyping };

package/dist/canvas/index.js

@@ -1 +1 @@
-export{BLOCK_ATTRIBUTE,BLOCK_SELECTOR,CANVAS_SELECTOR,CANVAS_TYPABLE_EVENT,CANVAS_TYPING_EVENT,LIST_SELECTOR,clientPointToLayer,drawnBox,elementScale,fitCanvas,framePointToHost,frameRectToHost,frameRectToLayer,frameScale,isFrameReady,isTypingTarget,nodeIdAt,removeCanvasStyle,setCanvasNonce,upsertCanvasStyle,useCanvasEvent,useCanvasFrame,useCanvasLayout,useCanvasStyle,useCanvasTyping,watchCanvasFrame}from"../chunk-GHBK7BKL.js";export{REPEAT_ATTRIBUTE,REPEAT_INDEX_ATTRIBUTE,isRepeatCopy,mainCopyOf,queryAllCopies,queryMainCopy}from"../chunk-LF3FUSCQ.js";
+export{BLOCK_ATTRIBUTE,BLOCK_SELECTOR,CANVAS_SELECTOR,CANVAS_TYPABLE_EVENT,CANVAS_TYPING_EVENT,LIST_SELECTOR,WORDS_CLEAR,clientPointToLayer,drawnBox,elementScale,fitCanvas,framePointToHost,frameRectToHost,frameRectToLayer,frameScale,isFrameReady,isTypingTarget,nodeIdAt,related,removeCanvasStyle,setCanvasNonce,upsertCanvasStyle,useCanvasEvent,useCanvasFrame,useCanvasLayout,useCanvasStyle,useCanvasTyping,watchCanvasFrame}from"../chunk-YU3WHLGI.js";export{REPEAT_ATTRIBUTE,REPEAT_INDEX_ATTRIBUTE,isRepeatCopy,mainCopyOf,queryAllCopies,queryMainCopy}from"../chunk-LF3FUSCQ.js";

package/dist/{canvas-typing-Be4FO4q7.d.ts → canvas-typing-DOBx8dD3.d.ts}

@@ -2,7 +2,7 @@ import * as react from 'react';
 import { ReactNode } from 'react';
 import { MarkStyle, WrapResult, InlineRule, MarkupTool } from 'efficient-shell/markup';
 import { TextAlign, TextToolbarCase, TextToolbarMark } from 'efficient-shell/ui';
-import { C as CopyWords } from './words-BpTjCfqO.js';
+import { C as CopyWords } from './words-Cf5VT2Ic.js';
 
 type CellWords = NonNullable<CopyWords['cells']>;
 interface CopyCell {
@@ -53,7 +53,7 @@ interface CopyThemeColor {
 }
 /**
  * The colour the toolbar's A shows for `current` (a theme colour's name or a
- * hex): the hex itself, or the theme colour's value. One rule for every bar
+ * hex): the hex itself, or theme colour's value. One rule for every bar
  * that opens this window — the panel's text box and the canvas typing bar.
  */
 declare function colorRunOf(current: string | null, colors: readonly CopyThemeColor[] | undefined): string | undefined;
@@ -381,6 +381,9 @@ interface CanvasTypingSession {
         /** The colour the selection wears (a theme colour's name or a hex, a
          *  pending one included), or null: the colour window shows it. */
         color: string | null;
+        /** Whether the selected words wear a mark or a colour that Clear
+         *  formatting would take off (a link stays): the button shows only then. */
+        clearable: boolean;
     };
     /** A mark button pressed (B, I, U, S, superscript, subscript): on the
      *  selected words, or for the words typed next — `markPress`, as the panel
@@ -424,6 +427,13 @@ interface CanvasTypingSession {
      * window stays open, so the focus is not moved.
      */
     color: (color: string | null) => void;
+    /**
+     * Clear formatting (Lewis 2026-10-26): every mark and colour off the
+     * selected words, back to the text's own style (`clearStyle`, which keeps a
+     * link). One edit step; the words stay selected. At a bare caret, the whole
+     * text (`clearRangeOf`, the one rule the panel box and the field bar share).
+     */
+    clear: () => void;
 }
 /** Start typing in the words `element()` drew, or `null` where they are not the string's. */
 declare function startCanvasTyping(o: CanvasTypingOptions): CanvasTypingSession | null;

package/dist/chunk-22I55W37.js

@@ -0,0 +1,2 @@
+import{NO_CONTROL_FIELD as r}from"./chunk-YCSZAP7T.js";import{jsx as n}from"react/jsx-runtime";var t="data-sf-no-control";function o(){/* @__PURE__ */
+return n("span",{[t]:"",hidden:!0})}function e(n,t){return{...n,[r]:t}}export{t as NO_CONTROL_ATTR,o as NoControlMark,e as noControlField};

package/dist/chunk-2FYFAAAK.js

@@ -0,0 +1,2 @@
+import{noControlField as e}from"./chunk-22I55W37.js";import{DEFAULT_SCREEN_WORDS as r}from"./chunk-IYHO4XQX.js";import{deviceMetaOf as n,DEVICE_FIELD_MARKER as t}from"./chunk-YCSZAP7T.js";import{useWords as o}from"./chunk-MFIRYGHW.js";import{usePreviewDevice as i}from"./chunk-BSPCSC45.js";import{jsx as c}from"react/jsx-runtime";function u(e){return"mobile"===e?"mobile":"desktop"}var s={desktop:null,tablet:r.deviceNote.tablet,mobile:r.deviceNote.mobile},d="data-sf-device-hidden";function m(){/* @__PURE__ */
+return c("span",{hidden:!0,[d]:""})}function f({tier:e,render:r,...n}){const t=i();return"each"===e?/* @__PURE__ */c(r,{...n,tier:u(t)}):u(t)===e?/* @__PURE__ */c(r,{...n}):/* @__PURE__ */c(m,{})}function l(e){return n(e)?.inner??e}function p(e,r){const n=r.render;return{...r,[t]:{tier:e,inner:r},render:r=>/* @__PURE__ */c(f,{tier:e,render:n,...r})}}function a(){const e=o("screen",r).deviceNote,n=i(),t="desktop"===n?null:e[n];return t?/* @__PURE__ */c("div",{className:"sf-device-scope",children:t}):/* @__PURE__ */c(m,{})}function h(){return e({type:"custom",render:()=>/* @__PURE__ */c(a,{})},"always")}export{d as DEVICE_HIDDEN_ATTR,s as DEVICE_NOTE,p as deviceField,h as deviceNote,u as shownTier,l as withoutDeviceGate};

package/dist/{chunk-3S5N4HLJ.js → chunk-6NJHYXJM.js}

@@ -1 +1 @@
-import{zoneKey as e}from"./chunk-K7BTCBWD.js";import{useRef as t,useEffect as n,useState as r,useSyncExternalStore as o,useCallback as i}from"react";var l=56,c=16;function a(e){const t=Math.max(e,0);return t>=l?0:Math.ceil(16*(1-t/l))}function u(e,t,n){if(e<t-l||e>n+l)return 0;const r=e-t,o=n-e;return r<l&&r<=o?-a(r):o<l?a(o):0}function s(e){const t=e?.ownerDocument?.defaultView;for(let n=e?.parentElement??null;n;n=n.parentElement){const e=t?.getComputedStyle(n).overflowY;if(("auto"===e||"scroll"===e)&&n.scrollHeight>n.clientHeight)return n}return null}function f(e){const t=e?.ownerDocument?.defaultView?.getComputedStyle(e).overflowY;return e&&("auto"===t||"scroll"===t)&&e.scrollHeight>e.clientHeight?e:s(e)}function d(e){const t=e.scrollingElement??e.documentElement;return t&&t.scrollHeight>t.clientHeight?t:null}function g(e,t=e){const n=t.ownerDocument,r=n.defaultView;if(!r)return()=>{};let o=null,i=0;const l=e=>{o=e.clientY},c=()=>{if(null!==o){const n=t.getBoundingClientRect(),r=u(o,n.top,n.bottom);r&&(e.scrollTop+=r)}i=r.requestAnimationFrame(c)};return n.addEventListener("dragover",l,!0),i=r.requestAnimationFrame(c),()=>{n.removeEventListener("dragover",l,!0),r.cancelAnimationFrame(i)}}function p(e){return/move|all|uninitialized/i.test(e)?"move":"copy"}function m(){let e=null,t=null;const n=/* @__PURE__ */new Set,r=()=>{if(t!==e){t=e;for(const e of[...n])e()}};return{get:()=>e,shown:()=>t,start(t){e=t,globalThis.setTimeout(r,0)},end(){null===e&&null===t||(e=null,r())},subscribe:e=>(n.add(e),()=>{n.delete(e)})}}function v(e,t,n,r){if(e.into)return{side:"into",to:e.into};return"first"===e.pinned||"last"!==e.pinned&&t>n+r/2?{side:"after",to:{...e.place,index:e.place.index+1}}:{side:"before",to:{...e.place,index:e.place.index}}}var D=(t,n)=>e(t)===e(n);function w(e,t){return D(e,t)&&(t.index===e.index||t.index===e.index+1)}function y(e,t){return D(e,t)&&e.index<t.index?t.index-1:t.index}function x(e,t){return{...e,index:t<0?e.index-1:e.index+2}}function h(e,t){if(!t)return e;const n={...t,...e};for(const[r,o]of Object.entries(e)){const e=t[r];"function"==typeof o&&"function"==typeof e&&(n[r]=t=>{o(t),e(t)})}return n}function T(l){const c=t(l);n(()=>{c.current=l});const[a]=r(()=>m()),u=l.session??a,d=o(u.subscribe,u.shown,u.shown),[D,y]=r(null),x=t(null),T=i(()=>{x.current?.(),x.current=null},[]),b=i(()=>{T(),u.end(),y(null)},[u,T]);n(()=>u.subscribe(()=>{u.get()||(T(),y(null))}),[u,T]),n(()=>T,[T]);const k=i((e,t)=>{y(n=>n&&n.key===e&&n.side===t?n:{key:e,side:t})},[]),E=i(e=>{y(t=>t&&t.key===e?null:t)},[]),A=(e,t,n,r)=>!("into"===n?r===e.key:void 0!==e.from&&w(e.from,t))&&c.current.canDrop(e.item,t);return{dragging:d?.item??null,row:(e,t)=>{const{keyOf:n,readOnly:r}=c.current,o=n(e.item),i=!r&&!e.pinned&&!1!==e.canDrag,l=t=>{const n=t.currentTarget.getBoundingClientRect();return v(e,t.clientY,n.top,n.height)},a={draggable:i||void 0,onDragStart:i?t=>{const n=t.currentTarget;u.start({key:o,item:e.item,from:e.place}),t.dataTransfer.effectAllowed="move";try{t.dataTransfer.setData("text/plain",o)}catch{}n.classList.add("is-lifting");const r=n.getBoundingClientRect();t.dataTransfer.setDragImage?.(n,t.clientX-r.left,t.clientY-r.top),n.ownerDocument.defaultView?.setTimeout(()=>n.classList.remove("is-lifting"),0);const i=s(n);T(),x.current=i?g(i):null}:void 0,onDragEnd:i?()=>b():void 0,onDragOver:e=>{const t=u.get();if(!t)return;const n=l(e);A(t,n.to,n.side,o)?(e.preventDefault(),e.dataTransfer.dropEffect=p(e.dataTransfer.effectAllowed),k(o,n.side)):E(o)},onDrop:e=>{const t=u.get();if(!t)return;const n=l(e);A(t,n.to,n.side,o)&&(e.preventDefault(),b(),c.current.onDrop(t.item,n.to))},onKeyDown:t=>{if("ArrowUp"!==t.key&&"ArrowDown"!==t.key)return;if(!t.altKey||t.ctrlKey||t.metaKey||t.shiftKey)return;if(t.preventDefault(),t.repeat||!i)return;const{onStep:n,canStep:r}=c.current,o="ArrowUp"===t.key?-1:1;n&&!1!==r?.(e.item,o)&&n(e.item,o)}};return{draggable:i,dragging:d?.key===o,drop:D?.key===o?D.side:void 0,rowProps:h(a,t)}},seam:(t,n)=>{const r=(o=t.place,`seam:${e(o)}:${o.index}`);var o;const i={onDragOver:e=>{const n=u.get();n&&(A(n,t.place,"before",r)?(e.preventDefault(),e.dataTransfer.dropEffect=p(e.dataTransfer.effectAllowed),k(r,"before")):E(r))},onDrop:e=>{const n=u.get();n&&A(n,t.place,"before",r)&&(e.preventDefault(),b(),c.current.onDrop(n.item,t.place))}};return{drop:D?.key===r,seamProps:h(i,n)}},rootProps:e=>h({onDragEnter:e=>{if(!u.get()||x.current)return;const t=f(e.currentTarget);x.current=t?g(t):null},onDragLeave:e=>{const t=e.relatedTarget;t&&e.currentTarget.contains(t)||y(null)}},e)}}export{l as AUTO_SCROLL_EDGE,c as AUTO_SCROLL_MAX_SPEED,u as autoScrollDelta,a as autoScrollSpeed,m as createDragSession,p as dropEffectFor,v as dropOnRow,d as frameScrollBox,y as gapToMoveIndex,w as isNoOpDrop,f as scrollBoxOf,s as scrollParent,g as startAutoScroll,x as stepGap,T as useTreeDrag};
+import{zoneKey as e}from"./chunk-TGZCD6IP.js";import{useRef as t,useEffect as n,useState as r,useSyncExternalStore as o,useCallback as i}from"react";var l=56,c=16;function a(e){const t=Math.max(e,0);return t>=l?0:Math.ceil(16*(1-t/l))}function u(e,t,n){if(e<t-l||e>n+l)return 0;const r=e-t,o=n-e;return r<l&&r<=o?-a(r):o<l?a(o):0}function s(e){const t=e?.ownerDocument?.defaultView;for(let n=e?.parentElement??null;n;n=n.parentElement){const e=t?.getComputedStyle(n).overflowY;if(("auto"===e||"scroll"===e)&&n.scrollHeight>n.clientHeight)return n}return null}function f(e){const t=e?.ownerDocument?.defaultView?.getComputedStyle(e).overflowY;return e&&("auto"===t||"scroll"===t)&&e.scrollHeight>e.clientHeight?e:s(e)}function d(e){const t=e.scrollingElement??e.documentElement;return t&&t.scrollHeight>t.clientHeight?t:null}function g(e,t=e){const n=t.ownerDocument,r=n.defaultView;if(!r)return()=>{};let o=null,i=0;const l=e=>{o=e.clientY},c=()=>{if(null!==o){const n=t.getBoundingClientRect(),r=u(o,n.top,n.bottom);r&&(e.scrollTop+=r)}i=r.requestAnimationFrame(c)};return n.addEventListener("dragover",l,!0),i=r.requestAnimationFrame(c),()=>{n.removeEventListener("dragover",l,!0),r.cancelAnimationFrame(i)}}function p(e){return/move|all|uninitialized/i.test(e)?"move":"copy"}function m(){let e=null,t=null;const n=/* @__PURE__ */new Set,r=()=>{if(t!==e){t=e;for(const e of[...n])e()}};return{get:()=>e,shown:()=>t,start(t){e=t,globalThis.setTimeout(r,0)},end(){null===e&&null===t||(e=null,r())},subscribe:e=>(n.add(e),()=>{n.delete(e)})}}function v(e,t,n,r){if(e.into)return{side:"into",to:e.into};return"first"===e.pinned||"last"!==e.pinned&&t>n+r/2?{side:"after",to:{...e.place,index:e.place.index+1}}:{side:"before",to:{...e.place,index:e.place.index}}}var D=(t,n)=>e(t)===e(n);function w(e,t){return D(e,t)&&(t.index===e.index||t.index===e.index+1)}function y(e,t){return D(e,t)&&e.index<t.index?t.index-1:t.index}function x(e,t){return{...e,index:t<0?e.index-1:e.index+2}}function h(e,t){if(!t)return e;const n={...t,...e};for(const[r,o]of Object.entries(e)){const e=t[r];"function"==typeof o&&"function"==typeof e&&(n[r]=t=>{o(t),e(t)})}return n}function T(l){const c=t(l);n(()=>{c.current=l});const[a]=r(()=>m()),u=l.session??a,d=o(u.subscribe,u.shown,u.shown),[D,y]=r(null),x=t(null),T=i(()=>{x.current?.(),x.current=null},[]),b=i(()=>{T(),u.end(),y(null)},[u,T]);n(()=>u.subscribe(()=>{u.get()||(T(),y(null))}),[u,T]),n(()=>T,[T]);const k=i((e,t)=>{y(n=>n&&n.key===e&&n.side===t?n:{key:e,side:t})},[]),E=i(e=>{y(t=>t&&t.key===e?null:t)},[]),A=(e,t,n,r)=>!("into"===n?r===e.key:void 0!==e.from&&w(e.from,t))&&c.current.canDrop(e.item,t);return{dragging:d?.item??null,row:(e,t)=>{const{keyOf:n,readOnly:r}=c.current,o=n(e.item),i=!r&&!e.pinned&&!1!==e.canDrag,l=t=>{const n=t.currentTarget.getBoundingClientRect();return v(e,t.clientY,n.top,n.height)},a={draggable:i||void 0,onDragStart:i?t=>{const n=t.currentTarget;u.start({key:o,item:e.item,from:e.place}),t.dataTransfer.effectAllowed="move";try{t.dataTransfer.setData("text/plain",o)}catch{}n.classList.add("is-lifting");const r=n.getBoundingClientRect();t.dataTransfer.setDragImage?.(n,t.clientX-r.left,t.clientY-r.top),n.ownerDocument.defaultView?.setTimeout(()=>n.classList.remove("is-lifting"),0);const i=s(n);T(),x.current=i?g(i):null}:void 0,onDragEnd:i?()=>b():void 0,onDragOver:e=>{const t=u.get();if(!t)return;const n=l(e);A(t,n.to,n.side,o)?(e.preventDefault(),e.dataTransfer.dropEffect=p(e.dataTransfer.effectAllowed),k(o,n.side)):E(o)},onDrop:e=>{const t=u.get();if(!t)return;const n=l(e);A(t,n.to,n.side,o)&&(e.preventDefault(),b(),c.current.onDrop(t.item,n.to))},onKeyDown:t=>{if("ArrowUp"!==t.key&&"ArrowDown"!==t.key)return;if(!t.altKey||t.ctrlKey||t.metaKey||t.shiftKey)return;if(t.preventDefault(),t.repeat||!i)return;const{onStep:n,canStep:r}=c.current,o="ArrowUp"===t.key?-1:1;n&&!1!==r?.(e.item,o)&&n(e.item,o)}};return{draggable:i,dragging:d?.key===o,drop:D?.key===o?D.side:void 0,rowProps:h(a,t)}},seam:(t,n)=>{const r=(o=t.place,`seam:${e(o)}:${o.index}`);var o;const i={onDragOver:e=>{const n=u.get();n&&(A(n,t.place,"before",r)?(e.preventDefault(),e.dataTransfer.dropEffect=p(e.dataTransfer.effectAllowed),k(r,"before")):E(r))},onDrop:e=>{const n=u.get();n&&A(n,t.place,"before",r)&&(e.preventDefault(),b(),c.current.onDrop(n.item,t.place))}};return{drop:D?.key===r,seamProps:h(i,n)}},rootProps:e=>h({onDragEnter:e=>{if(!u.get()||x.current)return;const t=f(e.currentTarget);x.current=t?g(t):null},onDragLeave:e=>{const t=e.relatedTarget;t&&e.currentTarget.contains(t)||y(null)}},e)}}export{l as AUTO_SCROLL_EDGE,c as AUTO_SCROLL_MAX_SPEED,u as autoScrollDelta,a as autoScrollSpeed,m as createDragSession,p as dropEffectFor,v as dropOnRow,d as frameScrollBox,y as gapToMoveIndex,w as isNoOpDrop,f as scrollBoxOf,s as scrollParent,g as startAutoScroll,x as stepGap,T as useTreeDrag};

package/dist/chunk-6QSFJCJT.js

@@ -0,0 +1,21 @@
+import{fieldIsShown as e,shownFields as n}from"./chunk-BPXEFVSQ.js";import{noControlMetaOf as t,deviceMetaOf as l}from"./chunk-YCSZAP7T.js";import{TreeSeam as r}from"./chunk-WHS6Y55E.js";import{DEFAULT_TREE_WORDS as a}from"./chunk-K56YDHYQ.js";import{easelMenuEntries as o}from"./chunk-FIVU2COQ.js";import{SETTINGS_BUCKETS as i,SettingsGroup as s}from"./chunk-FM6JO4WF.js";import{DEFAULT_PANEL_WORDS as c}from"./chunk-KFV7N2DJ.js";import{FieldNumber as d}from"./chunk-Y2T3JX7K.js";import{FieldSelect as u}from"./chunk-KFWNGPW3.js";import{DEFAULT_FIELDS_WORDS as m}from"./chunk-JACEEVVF.js";import{SettingsField as h,SettingsSegmented as p}from"./chunk-S3DUFDQ6.js";import{useWords as f}from"./chunk-MFIRYGHW.js";import{useTreeDrag as b,gapToMoveIndex as g}from"./chunk-6NJHYXJM.js";import{withTip as v}from"./chunk-P2VEMZH5.js";import{Textarea as y,Input as k,ItemCount as x,SortableList as w,ListRow as C,ContextMenu as N,tabPanelId as O,Tabs as j,tabButtonId as S}from"efficient-shell/ui";export{LinkPicker}from"efficient-shell/ui";import{useRef as $,useState as D,useLayoutEffect as I,useId as F}from"react";import{jsx as P,jsxs as L}from"react/jsx-runtime";import{ChevronIcon as E,LockIcon as M,MoveUpIcon as T,MoveDownIcon as W,DuplicateIcon as z,TrashIcon as A}from"efficient-shell/icons/efficient";function R({id:e,value:n,onChange:t,placeholder:l,multiline:r=!1,rows:a=3,readOnly:o=!1,ariaLabel:i,ariaLabelledBy:s}){const c=n??"";return r?/* @__PURE__ */P(y,{id:e,size:"sm",className:"es-fin",value:c,rows:a,placeholder:l,readOnly:o,"aria-label":i,"aria-labelledby":s,onChange:e=>t(e.target.value)}):/* @__PURE__ */P(k,{id:e,size:"md",className:"es-fin",type:"text",value:c,placeholder:l,readOnly:o,"aria-label":i,"aria-labelledby":s,onChange:e=>t(e.target.value)})}function H(e,n,t){const l=e.slice();return l.splice(Math.max(0,Math.min(n,l.length)),0,t),l}function J(e,n,t){const l=e.slice(),[r]=l.splice(n,1);return l.splice(Math.max(0,Math.min(t,l.length)),0,r),l}function Y(e,n){return e.filter((e,t)=>t!==n)}function K(e){return null===e||"object"!=typeof e?e:JSON.parse(JSON.stringify(e))}var V='input, textarea, select, button, [contenteditable]:not([contenteditable="false"]), [tabindex]',B={parentId:"list",slot:"items"};function Q({label:e,icon:n,noun:t,items:l,onChange:i,newItem:s,summary:c,itemName:d,thumb:u,min:h=0,max:p,readOnly:y=!1,open:k,onOpen:O,renderItem:j,renderRow:S,canRemove:F,lockedReason:R,fixed:Q=!1,removeOnRow:X=!0,canDuplicate:Z,above:U,head:q=!0}){const G=f("fields",m).list,_=f("tree",a),ee=t??G.item,ne=!y&&!Q&&("number"!=typeof p||l.length<p),te=l.length<=h,le=e=>!!F&&!F(l[e],e),re=e=>!y&&!Q&&X&&!te&&!le(e),ae=e=>ne&&(!Z||Z(l[e],e)),oe=(e,n)=>d?d(e,n):G.itemName({noun:ee,n:n+1}),ie=$([]),se=$(null),[ce,de]=D(null),ue=$(null),[me,he]=D(null),[pe,fe]=D("");I(()=>{const e=se.current;if(!e)return;se.current=null;const n=ie.current[e.index]?.querySelectorAll(V)[e.nth]??ie.current[e.index];if(n?.focus(),n&&null!==e.start&&"setSelectionRange"in n)try{n.setSelectionRange(e.start,e.end)}catch{}});const be=(e,n)=>{if(n<0||n>=l.length||n===e)return;const t=ie.current[e],r=t?.ownerDocument.activeElement;if(t&&r&&t.contains(r)){const e=[...t.querySelectorAll(V)].indexOf(r),l=r;se.current={index:n,nth:e,start:"number"==typeof l.selectionStart?l.selectionStart:null,end:"number"==typeof l.selectionEnd?l.selectionEnd:null}}i(J(l,e,n));const a=function(e,n,t){return null===e?null:e===n?t:n<e&&t>=e?e-1:n>e&&t<=e?e+1:e}(k,e,n);a!==k&&O(a),fe(G.moved({n:n+1,total:l.length}))},ge=e=>{ne&&(i(H(l,e,s())),S?(se.current={index:e,nth:0,start:null,end:null},null!==k&&k>=e&&O(k+1)):O(e))},ve=e=>{re(e)&&(i(Y(l,e)),k===e?O(null):null!==k&&k>e&&O(k-1))},ye=b({keyOf:e=>String(e),canDrop:(e,n)=>n.parentId===B.parentId&&n.slot===B.slot,onDrop:(e,n)=>{const t=g({...B,index:e},n);t!==e&&be(e,t)},onStep:(e,n)=>be(e,e+n),canStep:(e,n)=>e+n>=0&&e+n<l.length,readOnly:y}),ke=e=>{const n=[];return e>0&&n.push({label:G.moveUp,icon:/* @__PURE__ */P(T,{size:14}),shortcut:"⌥↑",onClick:()=>be(e,e-1)}),e<l.length-1&&n.push({label:G.moveDown,icon:/* @__PURE__ */P(W,{size:14}),shortcut:"⌥↓",onClick:()=>be(e,e+1)}),ae(e)&&n.push({label:G.duplicate,icon:/* @__PURE__ */P(z,{size:14}),onClick:()=>(e=>{ae(e)&&(i(H(l,e+1,K(l[e]))),null!==k&&k>e&&O(k+1))})(e)}),re(e)&&n.push({label:G.delete,icon:/* @__PURE__ */P(A,{size:14}),danger:!0,onClick:()=>ve(e)}),n},xe=(e,n,t,l)=>{y||0===ke(e).length||he({index:e,x:n,y:t,owner:l})},we=e=>n=>{const t=l.slice();t[e]=n,i(t)};/* @__PURE__ */
+return L("div",{className:"es-list",children:[q?/* @__PURE__ */L("div",{className:"es-list-head",children:[
+/* @__PURE__ */L("span",{className:"es-list-label",children:[n?/* @__PURE__ */P("span",{className:"es-field-icon","aria-hidden":"true",children:n}):null,e]}),
+/* @__PURE__ */P(x,{count:l.length,label:G.count({noun:ee,n:l.length}),showZero:!0})]}):null,U?/* @__PURE__ */P("div",{className:"es-list-above",children:U}):null,l.length?/* @__PURE__ */L(w,{"aria-label":e,spacing:"comfortable",className:"es-list-rows",rootProps:ye.rootProps(),children:[l.map((e,n)=>{const t=ye.row({item:n,place:{...B,index:n}}),l=t.draggable&&ce!==n,a=!S&&k===n,o=!y&&!Q&&X&&le(n),i=["es-list-row",S?"is-inline":"is-item",a?"is-open":"",l?"is-draggable":"",t.dragging?"is-dragging":"",t.drop?`is-drop-${t.drop}`:""].filter(Boolean).join(" ");return[n>0?/* @__PURE__ */P(r,{...ye.seam({place:{...B,index:n}}),onAdd:ne?()=>ge(n):void 0,label:G.addHere({noun:ee})},`seam-${n}`):null,
+/* @__PURE__ */P(C,{className:i,flat:!!S,active:a,draggable:t.draggable,dragHint:_.dragHint,dragging:t.dragging,drop:"before"===t.drop||"after"===t.drop?t.drop:void 0,onMove:t.draggable?e=>be(n,"up"===e?n-1:n+1):void 0,rowRef:e=>{ie.current[n]=e},rowProps:{...t.rowProps,draggable:l||void 0,onPointerDown:e=>{const l=e.target.closest?.('input, textarea, select, [contenteditable]:not([contenteditable="false"])'),r=!!l&&l===l.ownerDocument.activeElement;e.currentTarget.draggable=t.draggable&&!r,ue.current=l&&!r?l:null,de(r?n:null)},onDragStart:e=>{const n=ue.current;ue.current=null,n&&n.ownerDocument.activeElement===n&&n.blur(),t.rowProps.onDragStart?.(e)},onContextMenu:e=>{y||(e.preventDefault(),e.stopPropagation(),xe(n,e.clientX,e.clientY,e.currentTarget))},onKeyDown:e=>{if("ContextMenu"===e.key||e.shiftKey&&"F10"===e.key){e.preventDefault();const t=e.currentTarget.ownerDocument,l=e=>e.preventDefault();t.addEventListener("contextmenu",l,{capture:!0,once:!0}),t.defaultView?.setTimeout(()=>t.removeEventListener("contextmenu",l,{capture:!0}),500);const r=e.currentTarget.getBoundingClientRect();return void xe(n,r.left+24,r.bottom,e.currentTarget)}t.rowProps.onKeyDown?.(e)}},actions:y||Q||!X?void 0:o?v(R?R(e,n):G.locked,/* @__PURE__ */P("span",{className:"es-list-lock",role:"img","aria-label":R?R(e,n):G.locked,children:/* @__PURE__ */P(M,{size:13})})):v(G.deleteItem({noun:ee}),/* @__PURE__ */P("button",{type:"button",className:"es-list-x","aria-label":G.deleteItem({noun:ee}),disabled:!re(n),onClick:()=>ve(n),children:"×"})),below:a?/* @__PURE__ */P("div",{className:"es-list-item",children:j(e,n,we(n))}):void 0,children:S?/* @__PURE__ */P("div",{className:"es-list-row-main",children:S(e,n,we(n))}):/* @__PURE__ */L("button",{type:"button",className:"es-list-open","aria-expanded":a,onClick:()=>O(a?null:n),children:[u?/* @__PURE__ */P("span",{className:"es-list-thumb","aria-hidden":"true",children:u(e,n)}):null,
+/* @__PURE__ */P("span",{className:"es-list-row-name",children:oe(e,n)}),/* @__PURE__ */P("span",c?{className:"es-list-row-summary",children:c(e,n)}:{className:"es-list-row-summary"}),
+/* @__PURE__ */P(E,{size:14,className:"es-list-chev","aria-hidden":"true"})]})},n)]}),
+/* @__PURE__ */P(r,{...ye.seam({place:{...B,index:l.length}})})]}):null,y||Q?null:/* @__PURE__ */P("button",{type:"button",className:"es-list-add",disabled:!ne,onClick:()=>ge(l.length),children:G.add({noun:ee})}),
+/* @__PURE__ */P("span",{className:"es-list-said","aria-live":"polite",children:pe}),me&&me.index<l.length?
+/* @__PURE__ */P(N,{at:{x:me.x,y:me.y},owner:me.owner,onClose:()=>he(null),items:o(ke(me.index))}):null]})}var X=e=>e<6?e+1:6,Z=(e,n)=>"string"==typeof e.label&&e.label?e.label:n;function U({field:e,name:t,id:l,value:r,onChange:a,readOnly:o,context:i,showWhenContext:c,renderers:d,headingLevel:u=3}){const[m,h]=D(!0),p=r&&"object"==typeof r?r:{};/* @__PURE__ */
+return P(s,{id:`${l}-group`,title:Z(e,t),open:m,onToggle:h,level:u,children:Object.entries(n(e.objectFields,{values:p,context:c})).map(([e,n])=>/* @__PURE__ */P(G,{field:n,name:`${t}.${e}`,id:`${l}-${e}`,value:p[e],onChange:n=>a({...p,[e]:n}),readOnly:o,context:i,showWhenContext:c,renderers:d,headingLevel:X(u)},e))})}function q({field:e,name:t,id:l,value:r,onChange:a,readOnly:o,context:i,showWhenContext:s,renderers:c,openItem:d,onOpenItem:u,headingLevel:m}){const[h,p]=D(null),f=u?d??null:h,b=u??p,g=Array.isArray(r)?r:[],v=e.getItemSummary;/* @__PURE__ */
+return P(Q,{label:Z(e,t),icon:e.icon,noun:"string"==typeof e.noun?e.noun:void 0,items:g,onChange:a,newItem:()=>K({...e.defaultItemProps??{}}),summary:v?(e,n)=>v(e,n):void 0,min:e.min,max:e.max,readOnly:o,open:f,onOpen:b,renderItem:(r,a,d)=>Object.entries(n(e.arrayFields,{values:r,context:s})).map(([e,n])=>/* @__PURE__ */P(G,{field:n,name:`${t}[${a}].${e}`,id:`${l}-${a}-${e}`,value:r?.[e],onChange:n=>d({...r,[e]:n}),readOnly:o,context:i,showWhenContext:s,renderers:c,headingLevel:m},e))})}function G(e){const{field:n,name:t,id:l,value:r,onChange:a,readOnly:o,context:i,renderers:s}=e;if(!n||n.marker||!1===n.visible)return null;const c=s?.[n.type];if(c)return c({field:n,name:t,id:l,value:r,onChange:a,readOnly:o});switch(n.type){case"custom":{const e={...i,field:n,name:t,id:l,value:r,onChange:a,readOnly:o};return n.render(e)}case"text":case"textarea":/* @__PURE__ */
+return P(h,{label:Z(n,t),htmlFor:l,icon:n.icon,hint:n.hint,children:/* @__PURE__ */P(R,{id:l,value:"string"==typeof r?r:null==r?"":String(r),onChange:a,placeholder:n.placeholder,multiline:"textarea"===n.type,readOnly:o})});case"number":/* @__PURE__ */
+return P(h,{label:Z(n,t),htmlFor:l,icon:n.icon,hint:n.hint,children:/* @__PURE__ */P(d,{id:l,value:"number"==typeof r?r:void 0,onChange:a,min:n.min,max:n.max,step:n.step,placeholder:n.placeholder,readOnly:o})});case"select":{const e=`${l}-label`;/* @__PURE__ */
+return P(h,{label:Z(n,t),labelId:e,htmlFor:l,icon:n.icon,hint:n.hint,children:/* @__PURE__ */P(u,{id:l,value:r,options:n.options,onChange:a,readOnly:o,ariaLabelledBy:e})})}case"radio":/* @__PURE__ */
+return P(h,{label:Z(n,t),icon:n.icon,hint:n.hint,children:/* @__PURE__ */P(p,{ariaLabel:Z(n,t),value:r,options:n.options.map(e=>({id:e.value,label:e.label,icon:e.icon,disabled:e.disabled||o})),onChange:e=>{o||a(e)}})});case"object":/* @__PURE__ */
+return P(U,{...e,field:n});case"array":/* @__PURE__ */
+return P(q,{...e,field:n});case"slot":return null}}function _(e,n){if("mobile"!==n)return!0;const r=e;if(!r||r.marker||"slot"===r.type||"always"===t(e))return!0;const a=l(e)?.tier;return"mobile"===a||"each"===a}var ee={},ne=e=>i.includes(e);function te(n,t){let l,r=i[0];const a=[],o=/* @__PURE__ */new Set;for(const[i,s]of Object.entries(n))s&&(ne(s.bucket)&&((s.marker||s.bucket!==r)&&(l=void 0),r=s.bucket),s.marker&&"string"==typeof s.fold?l={key:i,title:s.fold}:s.marker&&!1===s.fold&&(l=void 0),s.marker||!1===s.visible||t&&!e(s,t)||t&&!_(s,t.context?.device)||(a.push(l?{name:i,field:s,bucket:r,fold:l}:{name:i,field:s,bucket:r}),"slot"!==s.type&&o.add(r)));return{rows:a,buckets:i.filter(e=>o.has(e))}}function le(e){return new Map(te(e).rows.map(e=>[e.name,e.bucket]))}function re(e){const n=[];for(const t of e){const e=n[n.length-1];e&&e.fold?.key===t.fold?.key?e.rows.push(t):n.push({fold:t.fold,rows:[t]})}return n}function ae({fields:e,values:n,onChange:t,readOnly:l=!1,context:r,showWhenContext:a,tab:o,onTab:i,tabs:d=!0,tabIcons:u,renderers:m,idPrefix:h,ariaLabel:p,lead:b,children:g,leadFold:v,closedFolds:y,onFold:k,headingLevel:x=3}){const w=f("panel",c),C=F(),N=h??`es-insp${C.replace(/:/g,"")}`,$=te(e,{values:n,context:a}),[I,E]=D(void 0),M=o??I,T=M&&$.buckets.includes(M)?M:$.buckets[0],[W,z]=D(null),A=W&&W.panel===N&&$.rows.some(e=>e.name===W.name)?W:null,R=d&&$.buckets.length>1,H=R&&T?O(N,T):`${N}-rows`,[J,Y]=D(()=>/* @__PURE__ */new Set),K=y??J,V=(e,n)=>{/* @__PURE__ */return P(s,{title:e.title,open:!K.has(e.key),onToggle:n=>((e,n)=>{void 0===y&&Y(t=>{const l=new Set(t);return n?l.delete(e):l.add(e),l}),k?.(e,n)})(e.key,n),id:`${N}-fold-${t=e.key,[...t].map(e=>/[A-Za-z0-9_-]/.test(e)?e:`-u${e.codePointAt(0).toString(16)}-`).join("")}`,level:x,children:n});var t},B=e=>R&&e!==T,Q=({name:e,field:o,bucket:i,fold:s})=>/* @__PURE__ */P("div",{className:"es-insp-row","data-field":e,"data-bucket":i,hidden:!!B(i)||void 0,children:/* @__PURE__ */P(G,{field:o,name:e,id:`${N}-${e}`,value:n[e],onChange:n=>t(e,n),readOnly:l,context:r,showWhenContext:a,renderers:m,openItem:A&&A.name===e?A.index:null,onOpenItem:n=>z(null===n?null:{panel:N,name:e,index:n}),headingLevel:s?X(x):x})},e);/* @__PURE__ */
+return L("div",{className:"es-insp",children:[R?/* @__PURE__ */P("div",{className:"es-insp-tabs",children:/* @__PURE__ */P(j,{variant:"underline",block:!0,"aria-label":p??w.settings,idPrefix:N,value:T,onChange:e=>{const n=e;void 0===o&&E(n),i?.(n)},items:$.buckets.map(e=>{const n=w.buckets[e],t=u?.[e];return t?{id:e,icon:t,label:/* @__PURE__ */P("span",{className:"sr-only",children:n}),tooltip:n}:{id:e,label:n}})})}):null,
+/* @__PURE__ */L("div",{className:"es-insp-rows",id:H,role:R?"tabpanel":void 0,"aria-labelledby":R&&T?S(N,T):void 0,children:[b&&_(ee,a?.device)?v?/* @__PURE__ */P("div",{className:"es-insp-band","data-fold":v.key,children:V(v,b)}):b:null,re($.rows).map((e,n)=>{if(!e.fold)return e.rows.map(Q);const t=e.rows[0].bucket,l=e.rows.every(e=>"slot"===e.field.type);/* @__PURE__ */
+return P("div",{className:"es-insp-band","data-fold":e.fold.key,"data-bucket":t,hidden:!(!B(t)&&!l)||void 0,children:V(e.fold,e.rows.map(Q))},`fold-${e.fold.key}-${n}`)}),g]})]})}export{R as FieldText,ae as Inspector,G as InspectorField,Q as ListField,le as bucketsOf,K as copyItem,_ as fieldShownInView,H as insertAt,Z as labelOf,J as moveTo,te as planFields,Y as removeAt};

package/dist/{chunk-BTDI7JAA.js → chunk-A6ZP5II4.js}

@@ -1,2 +1,2 @@
-import{routeSharedHostMessage as e}from"./chunk-77IWWW6X.js";import{describeLoadFailure as r,hostLoadRefusal as n}from"./chunk-ERR437B5.js";import{editLockOf as t}from"./chunk-GMCZXMOV.js";import{NO_DOCUMENT_ADDRESSING as o}from"./chunk-RLBXE4EU.js";import{saveStatusOf as u,resetForDocumentSwitch as a}from"./chunk-HNKB2ZYR.js";import{isExpiredSession as s,readEaselFailure as i}from"./chunk-CLOS6SSX.js";import{useAdminBridge as l}from"./chunk-BIK3AO2V.js";import{STATUS_UNREACHABLE as c}from"./chunk-KCOBHPN6.js";import{useEaselSession as d}from"./chunk-YM4UEGBV.js";import{backendOf as f,setSessionDocumentSite as m}from"./chunk-SNF5764Q.js";import{useEaselHost as k}from"./chunk-MQA7OFRA.js";import{DEFAULT_SCREEN_WORDS as v}from"./chunk-EB6NI2VK.js";import{useAutosave as g}from"./chunk-NDRZP6YR.js";import{canWriteDocument as p,newEaselClientId as h,reloadIfVersionMoved as y,openUnansweredClaim as w,FAIL_OPEN_RETRY_MS as b,CLAIM_FAIL_OPEN_MS as S,holderOf as I}from"./chunk-THWO5YVZ.js";import{useWords as P}from"./chunk-MFIRYGHW.js";import{createContext as j,useContext as B,useState as R,useMemo as E,useCallback as O,useEffect as H,useRef as A}from"react";import{jsx as C}from"react/jsx-runtime";var M={content:[],root:{},zones:{}};var N=j(null);function T(){const e=B(N);if(!e)throw new Error("useStorefrontDocument must be used within StorefrontDocumentProvider");return e}function V({target:j,addressing:B=o,onHostMessage:T,children:V}){const F=B,{homeSlug:D,entryMayBounce:L,entryBounce:W,onSwitch:Y,tellsHost:K,adapterFor:U,migrateRenamedProps:X,describeMissing:Z,onLoadFailed:x}=F,[G,Q]=R(j),z=k(),_=d(),q=E(()=>f(_),[_]),J=E(()=>t(_),[_]),$="template"===G.kind,ee="template"===G.kind?G.id:null,re="template"===G.kind?G.pageSlug??D??"":"document"===G.kind?G.slug??"":G.slug,ne="page"===G.kind?G.siteId??null:null,te=_.blocks,oe=E(()=>U(G,q,te),[U,q,te,G.kind,"template"===G.kind?G.id:"document"===G.kind?G.record:G.siteId]),ue=oe.capabilities,ae=O(e=>_.documentHooks?.stored?.(e)??e,[_]);H(()=>{m(_,ne)},[_,ne]);const se=A(G);H(()=>{se.current=G},[G]);const{token:ie,tokenRef:le,capabilities:ce}=l({onMessage:r=>{if(T?.(r)||e(r))return;const n=r;if("storefront-editor:navigate"===n?.type){const e=r;e?.target&&Rr(e.target)}}}),de=!_.usesBridgedToken||null!==ie,fe=oe.lock,me=Boolean(q.lock),[ke,ve]=R(null),[ge,pe]=R(null),[he,ye]=R(null),[we,be]=R(null),Se=P("screen",v),Ie=we?function(e,r){if(null!==e.sentence)return e.sentence;if(!e.missing)return r.loadFailed({cause:e.cause});switch(e.target.kind){case"template":return r.missingTemplatePage;case"document":return r.missingDocument;default:return r.missingPage({slug:e.slug})}}(we,Se):null,[Pe,je]=R(null),Be=A(null),Re=A(null),[Ee,Oe]=R(!1),He=A(null),[Ae,Ce]=R(null),Me=A(null),[Ne,Te]=R(null),[Ve,Fe]=R(!1),De=A(null);H(()=>{De.current=Ne},[Ne]);const[Le,We]=R(ue.hasEditLock?{kind:"checking"}:{kind:"editing"}),Ye=A(Le);H(()=>{Ye.current=Le},[Le]);const Ke=A(()=>Promise.resolve(!1)),Ue=O(e=>{Re.current=e,Oe(!0)},[]),Xe=g({save:async({id:e,data:r})=>{if(p(Ye.current)){if(!await Ke.current(e,r)){if(!p(Ye.current))return void Ue({id:e,data:r});throw new Error("page save did not land")}}else Ue({id:e,data:r})},onFailure:(e,r)=>{0===r&&z.send("storefront-editor:save-failed")}}),{state:Ze,push:xe,flush:Ge,pause:Qe,resume:ze,stop:_e,reset:qe,retryNow:Je,hasPending:$e}=Xe,er=A(Ze);H(()=>{er.current=Ze},[Ze]);const rr=u(Ze),nr=O(()=>{const e=Re.current;e&&(Re.current=null,Oe(!1),xe(e))},[xe]),tr=A("");tr.current||(tr.current=h());const[or,ur]=R(0),ar=A(!1),[sr,ir]=R(L(j)),lr=A(!1);H(()=>{if(lr.current)return;lr.current=!0;const e=z.address.search(),r=W(j,e);r?z.address.load(r):L(j)&&ir(!1)},[j,z]);const cr=z.send;H(()=>{if(!de)return;let e=!1;const t=se.current,o=oe.resolve(re),u=_.documentHooks?.opening?.({slug:re,isTemplate:$,capabilities:ue});return o.then(async r=>{if(e)return;if(!r)return"page"===t.kind&&null!==D&&re!==D?void z.address.load({kind:"page",slug:D,siteId:ne??void 0}):(be({target:t,slug:re,missing:!0,sentence:Z?.(t)??null}),void x?.(t,null));const n=r.readOnlyReason?r.readOnlyReason:null;Be.current=n,je(n),ve(r.id),pe(r.kind??null),Me.current=r.version??null;const o=r.layout,a=o&&Object.keys(o).length?o:M,s=X(a),i=u?await u(s):s;e||ye(i)}).catch(o=>{e||(console.error("[storefront-editor] document load failed",o),be({target:t,slug:re,missing:!1,sentence:n(o,{slug:re},_),cause:r(o,_)}),x?.(t,o))}),()=>{e=!0}},[de,ie,$,oe,re]);const dr=O(e=>new Promise(r=>{const n=Date.now(),t=setInterval(()=>{const o=le.current;o&&o!==e?(clearInterval(t),r(o)):Date.now()-n>6e3&&(clearInterval(t),r(null))},200)}),[]),fr=O(async e=>{const r=le.current;if(!r&&_.usesBridgedToken)return{ok:!1,error:new Error("no editor token")};try{return{ok:!0,value:await e(r??"")}}catch(n){if(s(n,_)){cr("storefront-editor:auth-expired");const n=r?await dr(r):null;if(n)try{return{ok:!0,value:await e(n)}}catch(e){return{ok:!1,error:e}}}return{ok:!1,error:n}}},[cr,dr,_]),mr=O(async e=>{const r=le.current?await fr(e):{ok:!1};return r.ok||cr("storefront-editor:save-failed"),r.ok},[cr,fr]),kr=O(async(e,r,n=!1)=>{if(null!==Be.current)return!1;if(!p(Ye.current))return!1;if(De.current)return!1;const t=await fr(()=>oe.saveLayout(e,r,Me.current,tr.current));if(t.ok)return Me.current=t.value.version??Me.current,Fe(!1),!0;const o=J.readLockTaken(t.error);if(o){const e={kind:"takenover",holder:o};return Ye.current=e,We(e),!1}const u=J.readSaveConflict(t.error);if(u){if(u.savedByYou&&!n&&oe.rereadVersion){const n=await fr(()=>oe.rereadVersion(e));if(n.ok&&n.value)return Me.current=n.value,Ke.current(e,r,!0)}_e(),De.current=u,Te(u)}return Fe(i(t.error,_)?.status===c),!1},[oe,fr,_e,_]);H(()=>{Ke.current=kr},[kr]);const vr=O(e=>{if(null!==Be.current)return;if(cr("storefront-editor:dirty"),!ke)return;const r=ae(e);He.current=r,p(Ye.current)?xe({id:ke,data:r}):Ue({id:ke,data:r})},[ke,cr,Ue,xe,ae]),gr=O(async()=>{p(Ye.current)&&nr();return await Ge()&&null==Re.current},[nr,Ge]),pr=A(gr);H(()=>{pr.current=gr},[gr]);const hr=A(fr);H(()=>{hr.current=fr},[fr]);const yr=O(()=>{z.address.reload()},[z]),wr=A(()=>Promise.resolve(!1));H(()=>{wr.current=()=>{const e=oe.rereadVersion;return ke&&e?y({ours:Me.current,stored:async()=>{const r=await hr.current(()=>e(ke));return r.ok?r.value:null},hasPending:()=>null!=Re.current||$e(),reload:yr}):Promise.resolve(!1)}},[oe,ke,$e,yr]);const br=null!==Pe;H(()=>{if(!fe||!ke||!de||br)return;let e=!1,r=null,n=null;const t=tr.current,o={claim:async e=>{const r=await hr.current(()=>fe.claim(ke,t,e));if(r.ok)return{heartbeat_seconds:r.value.heartbeatSeconds};throw r.error},cancelled:()=>e,currentAccess:()=>Ye.current,heldWrite:()=>({pending:null!=Re.current||$e(),autoSaveEnabled:!er.current.paused,saveConflict:null!=De.current}),setAccess:e=>{Ye.current=e,We(e)},releaseHeldWrite:()=>{pr.current()},startHeartbeat:e=>{r&&clearInterval(r),r=setInterval(()=>{u(!1)},e)},stopHeartbeat:()=>{r&&(clearInterval(r),r=null)},reloadIfMoved:()=>{wr.current()}},u=J.makeClaimBeat(o),a=ar.current;return ar.current=!1,a||(We({kind:"checking"}),n=setTimeout(()=>{n=null,w(o)&&o.startHeartbeat(b)},S)),u(a).finally(()=>{n&&clearTimeout(n),n=null}),()=>{e=!0,n&&clearTimeout(n),r&&clearInterval(r),fe.release(ke,t).catch(()=>{})}},[ke,fe,de,ie,or,br]);const Sr=O(()=>{fe&&ke&&(ar.current=!0,ur(e=>e+1))},[ke,fe]),Ir=O(()=>{We(e=>{const r="blocked"===e.kind||"takenover"===e.kind?e.holder:null;return r?{kind:"readonly",holder:r}:e})},[]),Pr=O(()=>{er.current.paused?(p(Ye.current)&&nr(),ze()):Qe()},[nr,Qe,ze]),jr=O(()=>{Je()},[Je]),Br=O(e=>{He.current=null,a("template"!==e.kind&&me,{resetAutosave:()=>{qe(),Re.current=null,Oe(!1)},setVersion:e=>{Me.current=e},setSaveConflict:Te,setAccess:We}),Y(e),Q(e),Be.current=null,je(null),ve(null),pe(null),ye(null),be(null),z.address.show(e),"document"!==e.kind&&K(e)&&z.send("storefront-editor:navigated",{target:e})},[qe,z,me,Y,K]),Rr=O(e=>{if(function(e,r,n){if(e.kind!==r.kind)return!1;if("template"===e.kind){const t=r;return e.id===t.id&&(e.pageSlug??n)===(t.pageSlug??n)}if("document"===e.kind){const n=r;return e.record===n.record&&(e.slug??"")===(n.slug??"")}const t=r;return e.slug===t.slug&&e.siteId===t.siteId}(e,se.current,D))return;const r=null!=Re.current;if(!r&&!$e())return void Br(e);const n=er.current;r||n.paused||n.failed||n.stopped?Ce(e):Ge().then(r=>{r?Br(e):Ce(e)})},[Br,$e,Ge,D]),Er=O(()=>Ce(null),[]),Or=O(()=>{Ce(e=>(e&&Br(e),null))},[Br]),Hr=O(async()=>{const e=Ae;if(!e)return;await gr()&&(Ce(null),Br(e))},[Ae,gr,Br]),Ar=O(async e=>{if(null!==Be.current)return;if(!ke)return;if(!p(Ye.current)||De.current)return;const r=ae(e);if(!await kr(ke,r))return void(De.current||cr("storefront-editor:save-failed"));const n=oe.publish;if(!ue.canPublish||!n)return void cr("storefront-editor:saved");const t=await fr(()=>n(ke,Me.current??void 0));if(!t.ok){const{error:e}=t;return void cr("storefront-editor:publish-failed",{reason:e instanceof Error&&e.message?e.message:null})}Me.current=t.value.version??Me.current,cr("storefront-editor:published")},[ke,oe,ue.canPublish,cr,kr,fr,ae]);/* @__PURE__ */
-return C(N.Provider,{value:{target:G,adapter:oe,capabilities:ue,templateId:ee,currentSlug:re,currentKind:ge,siteId:ne,ready:de,token:ie,tokenRef:le,notifyParent:cr,bridgeCapabilities:ce,runAuthed:mr,docId:ke,data:he,getLiveData:()=>He.current??he,error:Ie,redirecting:sr,saveStatus:rr,saveState:Ze,autoSaveEnabled:!Ze.paused,autoSaveStoppedByConflict:Ze.stopped,hasUnsavedEdits:Ze.pending||Ee,toggleAutoSave:Pr,retrySave:jr,onChange:vr,flushSave:gr,onPublish:Ar,access:Le,readOnly:null!==I(Le)||null!==Pe||null!==Ne,readOnlyReason:Pe,takeOverEditing:Sr,viewReadOnly:Ir,saveConflict:Ne,saveUnreachable:Ve,reloadFromServer:yr,navigate:Rr,pendingNav:Ae,cancelPendingNav:Er,discardAndNavigate:Or,saveAndNavigate:Hr},children:V})}export{N as ScreenDocumentContext,V as ScreenDocumentProvider,T as useScreenDocument};
+import{routeSharedHostMessage as e}from"./chunk-77IWWW6X.js";import{describeLoadFailure as r,hostLoadRefusal as n}from"./chunk-ERR437B5.js";import{editLockOf as t}from"./chunk-GMCZXMOV.js";import{NO_DOCUMENT_ADDRESSING as o}from"./chunk-RLBXE4EU.js";import{saveStatusOf as u,resetForDocumentSwitch as a}from"./chunk-HNKB2ZYR.js";import{isExpiredSession as s,readEaselFailure as i}from"./chunk-CLOS6SSX.js";import{useAdminBridge as l}from"./chunk-BIK3AO2V.js";import{STATUS_UNREACHABLE as c}from"./chunk-KCOBHPN6.js";import{useEaselSession as d}from"./chunk-YM4UEGBV.js";import{backendOf as f,setSessionDocumentSite as m}from"./chunk-SNF5764Q.js";import{useEaselHost as k}from"./chunk-MQA7OFRA.js";import{DEFAULT_SCREEN_WORDS as v}from"./chunk-IYHO4XQX.js";import{useAutosave as g}from"./chunk-NDRZP6YR.js";import{canWriteDocument as p,newEaselClientId as h,reloadIfVersionMoved as y,openUnansweredClaim as w,FAIL_OPEN_RETRY_MS as b,CLAIM_FAIL_OPEN_MS as S,holderOf as I}from"./chunk-THWO5YVZ.js";import{useWords as P}from"./chunk-MFIRYGHW.js";import{createContext as j,useContext as R,useState as B,useMemo as O,useCallback as E,useEffect as H,useRef as A}from"react";import{jsx as C}from"react/jsx-runtime";var M={content:[],root:{},zones:{}};var N=j(null);function T(){const e=R(N);if(!e)throw new Error("useStorefrontDocument must be used within StorefrontDocumentProvider");return e}function F({target:j,addressing:R=o,onHostMessage:T,children:F}){const V=R,{homeSlug:D,entryMayBounce:L,entryBounce:W,onSwitch:Y,tellsHost:X,adapterFor:K,migrateRenamedProps:U,describeMissing:Z,onLoadFailed:x}=V,[G,Q]=B(j),z=k(),_=d(),q=O(()=>f(_),[_]),J=O(()=>t(_),[_]),$="template"===G.kind,ee="template"===G.kind?G.id:null,re="template"===G.kind?G.pageSlug??D??"":"document"===G.kind?G.slug??"":G.slug,ne="page"===G.kind?G.siteId??null:null,te=_.blocks,oe=O(()=>K(G,q,te),[K,q,te,G.kind,"template"===G.kind?G.id:"document"===G.kind?G.record:G.siteId]),ue=oe.capabilities,ae=E(e=>_.documentHooks?.stored?.(e)??e,[_]);H(()=>{m(_,ne)},[_,ne]);const se=A(G);H(()=>{se.current=G},[G]);const{token:ie,tokenRef:le,capabilities:ce}=l({onMessage:r=>{if(T?.(r)||e(r))return;const n=r;if("storefront-editor:navigate"===n?.type){const e=r;e?.target&&Br(e.target)}}}),de=!_.usesBridgedToken||null!==ie,fe=oe.lock,me=Boolean(q.lock),[ke,ve]=B(null),[ge,pe]=B(null),[he,ye]=B(null),[we,be]=B(null),Se=P("screen",v),Ie=we?function(e,r){if(null!==e.sentence)return e.sentence;if(!e.missing)return r.loadFailed({cause:e.cause});switch(e.target.kind){case"template":return r.missingTemplatePage;case"document":return r.missingDocument;default:return r.missingPage({slug:e.slug})}}(we,Se):null,[Pe,je]=B(null),Re=A(null),Be=A(null),[Oe,Ee]=B(!1),He=A(null),[Ae,Ce]=B(null),Me=A(null),[Ne,Te]=B(null),[Fe,Ve]=B(!1),De=A(null);H(()=>{De.current=Ne},[Ne]);const[Le,We]=B(ue.hasEditLock?{kind:"checking"}:{kind:"editing"}),Ye=A(Le);H(()=>{Ye.current=Le},[Le]);const Xe=A(()=>Promise.resolve(!1)),Ke=E(e=>{Be.current=e,Ee(!0)},[]),Ue=g({save:async({id:e,data:r})=>{if(p(Ye.current)){if(!await Xe.current(e,r)){if(!p(Ye.current))return void Ke({id:e,data:r});throw new Error("page save did not land")}}else Ke({id:e,data:r})},onFailure:(e,r)=>{0===r&&z.send("storefront-editor:save-failed")}}),{state:Ze,push:xe,flush:Ge,pause:Qe,resume:ze,stop:_e,reset:qe,retryNow:Je,hasPending:$e}=Ue,er=A(Ze);H(()=>{er.current=Ze},[Ze]);const rr=u(Ze),nr=E(()=>{const e=Be.current;e&&(Be.current=null,Ee(!1),xe(e))},[xe]),tr=A("");tr.current||(tr.current=h());const[or,ur]=B(0),ar=A(!1),[sr,ir]=B(L(j)),lr=A(!1);H(()=>{if(lr.current)return;lr.current=!0;const e=z.address.search(),r=W(j,e);r?z.address.load(r):L(j)&&ir(!1)},[j,z]);const cr=z.send;H(()=>{if(!de)return;let e=!1;const t=se.current,o=oe.resolve(re),u=_.documentHooks?.opening?.({slug:re,isTemplate:$,capabilities:ue});return o.then(async r=>{if(e)return;if(!r)return"page"===t.kind&&null!==D&&re!==D?void z.address.load({kind:"page",slug:D,siteId:ne??void 0}):(be({target:t,slug:re,missing:!0,sentence:Z?.(t)??null}),void x?.(t,null));const n=r.readOnlyReason?r.readOnlyReason:null;Re.current=n,je(n),ve(r.id),pe(r.kind??null),Me.current=r.version??null;const o=r.layout,a=o&&Object.keys(o).length?o:M,s=U(a),i=u?await u(s):s;e||ye(i)}).catch(o=>{e||(console.error("[storefront-editor] document load failed",o),be({target:t,slug:re,missing:!1,sentence:n(o,{slug:re},_),cause:r(o,_)}),x?.(t,o))}),()=>{e=!0}},[de,ie,$,oe,re]);const dr=E(e=>new Promise(r=>{const n=Date.now(),t=setInterval(()=>{const o=le.current;o&&o!==e?(clearInterval(t),r(o)):Date.now()-n>6e3&&(clearInterval(t),r(null))},200)}),[]),fr=E(async e=>{const r=le.current;if(!r&&_.usesBridgedToken)return{ok:!1,error:new Error("no editor token")};try{return{ok:!0,value:await e(r??"")}}catch(n){if(s(n,_)){cr("storefront-editor:auth-expired");const n=r?await dr(r):null;if(n)try{return{ok:!0,value:await e(n)}}catch(e){return{ok:!1,error:e}}}return{ok:!1,error:n}}},[cr,dr,_]),mr=E(async e=>{const r=le.current?await fr(e):{ok:!1};return r.ok||cr("storefront-editor:save-failed"),r.ok},[cr,fr]),kr=E(async(e,r,n=!1)=>{if(null!==Re.current)return!1;if(!p(Ye.current))return!1;if(De.current)return!1;const t=await fr(()=>oe.saveLayout(e,r,Me.current,tr.current));if(t.ok)return Me.current=t.value.version??Me.current,Ve(!1),!0;const o=J.readLockTaken(t.error);if(o){const e={kind:"takenover",holder:o};return Ye.current=e,We(e),!1}const u=J.readSaveConflict(t.error);if(u){if(u.savedByYou&&!n&&oe.rereadVersion){const n=await fr(()=>oe.rereadVersion(e));if(n.ok&&n.value)return Me.current=n.value,Xe.current(e,r,!0)}_e(),De.current=u,Te(u)}return Ve(i(t.error,_)?.status===c),!1},[oe,fr,_e,_]);H(()=>{Xe.current=kr},[kr]);const vr=E(e=>{if(null!==Re.current)return;if(cr("storefront-editor:dirty"),!ke)return;const r=ae(e);He.current=r,p(Ye.current)?xe({id:ke,data:r}):Ke({id:ke,data:r})},[ke,cr,Ke,xe,ae]),gr=E(async()=>{p(Ye.current)&&nr();return await Ge()&&null==Be.current},[nr,Ge]),pr=A(gr);H(()=>{pr.current=gr},[gr]);const hr=A(fr);H(()=>{hr.current=fr},[fr]);const yr=E(()=>{z.address.reload()},[z]),wr=A(()=>Promise.resolve(!1));H(()=>{wr.current=()=>{const e=oe.rereadVersion;return ke&&e?y({ours:Me.current,stored:async()=>{const r=await hr.current(()=>e(ke));return r.ok?r.value:null},hasPending:()=>null!=Be.current||$e(),reload:yr}):Promise.resolve(!1)}},[oe,ke,$e,yr]);const br=null!==Pe;H(()=>{if(!fe||!ke||!de||br)return;let e=!1,r=null,n=null;const t=tr.current,o={claim:async e=>{const r=await hr.current(()=>fe.claim(ke,t,e));if(r.ok)return{heartbeat_seconds:r.value.heartbeatSeconds};throw r.error},cancelled:()=>e,currentAccess:()=>Ye.current,heldWrite:()=>({pending:null!=Be.current||$e(),autoSaveEnabled:!er.current.paused,saveConflict:null!=De.current}),setAccess:e=>{Ye.current=e,We(e)},releaseHeldWrite:()=>{pr.current()},startHeartbeat:e=>{r&&clearInterval(r),r=setInterval(()=>{u(!1)},e)},stopHeartbeat:()=>{r&&(clearInterval(r),r=null)},reloadIfMoved:()=>{wr.current()}},u=J.makeClaimBeat(o),a=ar.current;return ar.current=!1,a||(We({kind:"checking"}),n=setTimeout(()=>{n=null,w(o)&&o.startHeartbeat(b)},S)),u(a).finally(()=>{n&&clearTimeout(n),n=null}),()=>{e=!0,n&&clearTimeout(n),r&&clearInterval(r),fe.release(ke,t).catch(()=>{})}},[ke,fe,de,ie,or,br]);const Sr=E(()=>{fe&&ke&&(ar.current=!0,ur(e=>e+1))},[ke,fe]),Ir=E(()=>{We(e=>{const r="blocked"===e.kind||"takenover"===e.kind?e.holder:null;return r?{kind:"readonly",holder:r}:e})},[]),Pr=E(()=>{er.current.paused?(p(Ye.current)&&nr(),ze()):Qe()},[nr,Qe,ze]),jr=E(()=>{Je()},[Je]),Rr=E(e=>{He.current=null,a("template"!==e.kind&&me,{resetAutosave:()=>{qe(),Be.current=null,Ee(!1)},setVersion:e=>{Me.current=e},setSaveConflict:Te,setAccess:We}),Y(e),Q(e),Re.current=null,je(null),ve(null),pe(null),ye(null),be(null),z.address.show(e),"document"!==e.kind&&X(e)&&z.send("storefront-editor:navigated",{target:e})},[qe,z,me,Y,X]),Br=E(e=>{if(function(e,r,n){if(e.kind!==r.kind)return!1;if("template"===e.kind){const t=r;return e.id===t.id&&(e.pageSlug??n)===(t.pageSlug??n)}if("document"===e.kind){const n=r;return e.record===n.record&&(e.slug??"")===(n.slug??"")}const t=r;return e.slug===t.slug&&e.siteId===t.siteId}(e,se.current,D))return;const r=null!=Be.current;if(!r&&!$e())return void Rr(e);const n=er.current;r||n.paused||n.failed||n.stopped?Ce(e):Ge().then(r=>{r?Rr(e):Ce(e)})},[Rr,$e,Ge,D]),Or=E(()=>Ce(null),[]),Er=E(()=>{Ce(e=>(e&&Rr(e),null))},[Rr]),Hr=E(async()=>{const e=Ae;if(!e)return;await gr()&&(Ce(null),Rr(e))},[Ae,gr,Rr]),Ar=E(async e=>{if(null!==Re.current)return;if(!ke)return;if(!p(Ye.current)||De.current)return;const r=ae(e);if(!await kr(ke,r))return void(De.current||cr("storefront-editor:save-failed"));const n=oe.publish;if(!ue.canPublish||!n)return void cr("storefront-editor:saved");const t=await fr(()=>n(ke,Me.current??void 0));if(!t.ok){const{error:e}=t;return void cr("storefront-editor:publish-failed",{reason:e instanceof Error&&e.message?e.message:null})}Me.current=t.value.version??Me.current,cr("storefront-editor:published")},[ke,oe,ue.canPublish,cr,kr,fr,ae]);/* @__PURE__ */
+return C(N.Provider,{value:{target:G,adapter:oe,capabilities:ue,templateId:ee,currentSlug:re,currentKind:ge,siteId:ne,ready:de,token:ie,tokenRef:le,notifyParent:cr,bridgeCapabilities:ce,runAuthed:mr,docId:ke,data:he,getLiveData:()=>He.current??he,error:Ie,redirecting:sr,saveStatus:rr,saveState:Ze,autoSaveEnabled:!Ze.paused,autoSaveStoppedByConflict:Ze.stopped,hasUnsavedEdits:Ze.pending||Oe,toggleAutoSave:Pr,retrySave:jr,onChange:vr,flushSave:gr,onPublish:Ar,access:Le,readOnly:null!==I(Le)||null!==Pe||null!==Ne,readOnlyReason:Pe,takeOverEditing:Sr,viewReadOnly:Ir,saveConflict:Ne,saveUnreachable:Fe,reloadFromServer:yr,navigate:Br,pendingNav:Ae,cancelPendingNav:Or,discardAndNavigate:Er,saveAndNavigate:Hr},children:F})}export{N as ScreenDocumentContext,F as ScreenDocumentProvider,T as useScreenDocument};

package/dist/{chunk-IWCKVZHS.js → chunk-AGWKB77Q.js}

@@ -1 +1 @@
-import{changedProps as e}from"./chunk-K7BTCBWD.js";import{useState as t,useRef as r,useEffect as n}from"react";function i({id:i,node:l,block:d,parent:o=null,appState:a=null}){const u=d?.fields??{},[s,c]=t(()=>({id:i,fields:u,loading:!1})),p=r(null),f=r(null),g=r({parent:o,appState:a,id:i});return g.current={parent:o,appState:a,id:i},n(()=>{if(!l||!d)return;const t=f.current!==i;f.current=i;let r=s.fields;t&&(r=u,p.current=null,c({id:i,fields:u,loading:!1}));const n=d.resolveFields;if(!n)return void(t||c(e=>({...e,fields:u})));let o=!1;const a=p.current&&(p.current.props?.id??"root")===(l.props?.id??"root")?p.current:null,m=setTimeout(()=>{o||c(e=>e.id===i?{...e,loading:!0}:e)},50);return Promise.resolve(n(l,{changed:e(l,a),fields:u,lastFields:r,lastData:a,appState:g.current.appState,parent:g.current.parent})).then(e=>{clearTimeout(m),o||g.current.id!==i||(p.current=l,c({id:i,fields:e,loading:!1}))}),()=>{o=!0,clearTimeout(m)}},[i,l,d]),s.id===i?{fields:s.fields,loading:s.loading}:{fields:u,loading:!1}}export{i as useResolvedFields};
+import{changedProps as e}from"./chunk-TGZCD6IP.js";import{useState as t,useRef as r,useEffect as n}from"react";function i({id:i,node:l,block:d,parent:o=null,appState:a=null}){const u=d?.fields??{},[s,c]=t(()=>({id:i,fields:u,loading:!1})),p=r(null),f=r(null),g=r({parent:o,appState:a,id:i});return g.current={parent:o,appState:a,id:i},n(()=>{if(!l||!d)return;const t=f.current!==i;f.current=i;let r=s.fields;t&&(r=u,p.current=null,c({id:i,fields:u,loading:!1}));const n=d.resolveFields;if(!n)return void(t||c(e=>({...e,fields:u})));let o=!1;const a=p.current&&(p.current.props?.id??"root")===(l.props?.id??"root")?p.current:null,m=setTimeout(()=>{o||c(e=>e.id===i?{...e,loading:!0}:e)},50);return Promise.resolve(n(l,{changed:e(l,a),fields:u,lastFields:r,lastData:a,appState:g.current.appState,parent:g.current.parent})).then(e=>{clearTimeout(m),o||g.current.id!==i||(p.current=l,c({id:i,fields:e,loading:!1}))}),()=>{o=!0,clearTimeout(m)}},[i,l,d]),s.id===i?{fields:s.fields,loading:s.loading}:{fields:u,loading:!1}}export{i as useResolvedFields};