efficient-easel 21.1.0 → 23.0.0

package/README.md

@@ -7,7 +7,7 @@ what a section is, and each editor brings its own blocks and its own data.
 The EFFICIENT editors' shared engine and chrome — the campaign designer
 (`efficient-admin-portal`) and the website editor (`efficient-storefront`) draw from
 one source instead of hand-rolling and drifting — and the engine both run on,
-which replaced Puck (`@measured/puck`) layer by layer and has carried none of
+which replaced the open-source editor library the two editors began on, layer by layer, and has carried none of
 it since 0.93.0.
 
 > **Published as `efficient-easel`** on public npm from 0.96.0 (it was
@@ -61,7 +61,7 @@ down too.
 
 ## Why
 
-The storefront editor (`efficient-storefront`, Next 16 + Puck) and the campaign
+The storefront editor (`efficient-storefront`, Next 16) and the campaign
 designer (`efficient-admin-portal`, Vite/React) each hand-rolled their own narrow
 left icon-rail. They had already drifted — button 34px vs 36px, icon 18px vs
 20px, radius 9 vs 8, a CSS-var accent vs a Tailwind one. `EaselRail` is the one
@@ -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 Puck (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 Puck 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)` | Puck'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 Puck'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 (Puck'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 Puck'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 a Puck
+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 Puck'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 Puck 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 Puck'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 Puck'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,28 +604,21 @@ 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. (Puck'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 Puck's, so an app passes the config it has: a
-block's `render` gets its props, `editor` (and `puck`, its deprecated twin: the same
-value), and each slot as a component —
+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 Puck's client `<Render>` gave
-`puck` at each level. A type the config does not know draws nothing.
+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.
 
-**Retiring the name "Puck" (21.1.0).** The new names ship beside the old ones;
-easel 22 removes the old. Deprecated, with what replaces each:
-
-| Deprecated | Use |
-|---|---|
-| block prop `puck` (types: `WithBlockProps`) | `editor` — the same value |
-| `efficient-easel/screen/lib/puck/*` (24 subpaths) | `efficient-easel/screen/lib/document/*` — the old ones re-export the new |
-| `data-puck-component`, `data-puck-dropzone`, `data-puck-entry`, `data-puck-dnd`, `data-puck-preview` | `data-easel-block`, `data-easel-dropzone`, `data-easel-entry`, `data-easel-dnd`, `data-easel-preview` — both are drawn; easel's own reads and `BLOCK_ATTRIBUTE`, `BLOCK_SELECTOR`, `LIST_SELECTOR` use the new (`LEGACY_BLOCK_ATTRIBUTE` names the old) |
-| inspector mode `{ kind: "puck" }` | `SELECTION_MODE`, now `{ kind: "selection" }`; `isSelectionMode(mode)` accepts both spellings |
-| the root's `id: "puck-root"` | `page-root`, in easel 22 (the recorded fixtures hold the old id until then) |
+**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.
 
 **A slot says how many blocks it holds** (Unreleased). Each slot component
 has a read-only `blockCount`: the blocks it draws. A block of a type the
@@ -645,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 Puck'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`
 
@@ -697,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 (Puck'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.
 
@@ -714,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 (Puck'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. |
@@ -794,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`
 
@@ -1004,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 Puck'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
@@ -1033,8 +1039,8 @@ const easel = createEasel<EaselConfig>({ config, data, onChange: (doc) => autosa
   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 Puck's reducer
-  did. What ran a new block's `resolveData` in Puck 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:
 
@@ -1219,7 +1225,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
@@ -1337,7 +1343,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-CFUcBbgc.d.ts → CanvasDragLayer-NZpaX6aq.d.ts}

@@ -1,7 +1,7 @@
 import * as react from 'react';
-import { C as CanvasTarget$1 } from './watch-D8xZow3y.js';
-import { S as SlotAddress, P as Place } from './types-41704JE4.js';
-import { D as DragSession } from './session-DSQFmIvx.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: Puck'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-1RgtGKWR.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: Puck'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 Puck'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 Puck'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 Puck 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-Cq53lL8d.js';
+import { P as Permissions, A as AppState } from '../types-BljCVdzR.js';
 import '../data/index.js';
-import '../types-41704JE4.js';
-import '../resolve-D68pb3Bx.js';
-import '../plan-CZS902DV.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 Puck'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 Puck's own types, which kept `@measured/puck` 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,11 +20,11 @@ import '../plan-CZS902DV.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 Puck's own editor — 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 `puck` prop keeps its name: it is what every block's `render` destructures
- * (`puck.isEditing`, `puck.renderDropZone`), and renaming it is the block rewrite
+ * The `editor` prop is what every block's `render` destructures
+ * (`editor.isEditing`, `editor.renderDropZone`), and renaming it is the block rewrite
  * default #3 rules out. Its type is `BlockContext`.
  *
  * TYPES ONLY — nothing here exists at runtime, so a server component, a test
@@ -49,7 +49,7 @@ type BaseField = {
     metadata?: Metadata;
     visible?: boolean;
     /**
-     * NOT PUCK'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 Puck'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[];
 };
 /**
- * Puck'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 Puck's, and a function that takes `Fields` takes Puck'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';
@@ -240,7 +240,7 @@ type DropZoneProps = {
 type SlotComponent = ((props?: Omit<DropZoneProps, 'zone'>) => ReactNode) & {
     readonly blockCount?: number;
 };
-/** The `editor` prop every block's `render` receives; `puck` is the same value under its old name. */
+/** The `editor` prop every block's `render` receives. */
 type BlockContext = {
     renderDropZone: FC<DropZoneProps>;
     metadata: Metadata;
@@ -249,15 +249,13 @@ type BlockContext = {
 };
 type WithBlockProps<Props> = Props & {
     editor: BlockContext;
-    /** @deprecated The same value as `editor`; removed in easel 22. */
-    puck: BlockContext;
     editMode?: boolean;
 };
 type WithChildren<Props> = Props & {
     children: ReactNode;
 };
-type AsFieldProps<Props> = Omit<Props, 'children' | 'editor' | 'puck' | 'editMode'>;
-/** A block's `render`: its own props with slots as `SlotComponent`s, its id, `editor` and the deprecated `puck`. */
+type AsFieldProps<Props> = Omit<Props, 'children' | 'editor' | 'editMode'>;
+/** A block's `render`: its own props with slots as `SlotComponent`s, its id and `editor`. */
 type BlockComponent<Props> = (props: WithId<WithBlockProps<{
     [K in keyof Props]: WithDeepSlots<Props[K], SlotComponent>;
 }>>) => JSX.Element;

package/dist/{buckets-Sw94ll9I.d.ts → buckets-_MGDYJlb.d.ts}

@@ -6,7 +6,7 @@
  * tabs that hold a setting — an empty tab is hidden, never drawn.
  *
  * ONE list for both editors. The website editor wrote the first one in
- * `efficient-storefront/lib/puck/field-groups.ts` (`BUCKETS`); from 0.43.0 it
+ * the storefront's old field-groups module (`BUCKETS`); from 0.43.0 it
  * lives here, so the campaign editor spells its panel with the same words in
  * the same order instead of keeping a second list.
  */

package/dist/canvas/index.d.ts

@@ -1,7 +1,7 @@
 import { RefObject } from 'react';
-import { C as CanvasTarget, W as WatchOptions } from '../watch-D8xZow3y.js';
-export { B as BLOCK_SELECTOR, a as CANVAS_SELECTOR, L as LIST_SELECTOR, i as isFrameReady, w as watchCanvasFrame } from '../watch-D8xZow3y.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-BNgSq2Nw.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';
 
 /**
  * The small facts every canvas surface needs, written once — pure DOM, no
@@ -27,8 +27,6 @@ export { R as REPEAT_ATTRIBUTE, a as REPEAT_INDEX_ATTRIBUTE, i as isRepeatCopy,
 declare function isTypingTarget(target: EventTarget | null): boolean;
 /** The attribute on every block the canvas draws. */
 declare const BLOCK_ATTRIBUTE = "data-easel-block";
-/** @deprecated Puck 0.20's name for {@link BLOCK_ATTRIBUTE}, still drawn beside it; removed in easel 22. */
-declare const LEGACY_BLOCK_ATTRIBUTE = "data-puck-component";
 
 /**
  * The id of the block a pointer event landed on: the NEAREST ancestor (or the
@@ -40,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;
@@ -136,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 Puck (blueprint "Puck 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 — Puck's `#preview-frame` today, the engine's own same-origin
- * CanvasFrame once the editors leave Puck — 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
@@ -182,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;
@@ -214,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. Puck'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.
@@ -236,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, LEGACY_BLOCK_ATTRIBUTE, 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,LEGACY_BLOCK_ATTRIBUTE,LIST_SELECTOR,clientPointToLayer,drawnBox,elementScale,fitCanvas,framePointToHost,frameRectToHost,frameRectToLayer,frameScale,isFrameReady,isTypingTarget,nodeIdAt,removeCanvasStyle,setCanvasNonce,upsertCanvasStyle,useCanvasEvent,useCanvasFrame,useCanvasLayout,useCanvasStyle,useCanvasTyping,watchCanvasFrame}from"../chunk-4FD7TAOE.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-I67UW5UG.js → chunk-3P735WOM.js}

@@ -1,7 +1,7 @@
-import{clientOnly as r}from"./chunk-GXQCZJOP.js";import{ScreenChrome as n}from"./chunk-YVFYWAYU.js";import{ScreenStoreProvider as e}from"./chunk-GWYNMSIP.js";import{ScreenDocumentProvider as i,useScreenDocument as a}from"./chunk-BTDI7JAA.js";import{DEFAULT_SCREEN_WORDS as o}from"./chunk-EB6NI2VK.js";import{documentPermissions as s}from"./chunk-THWO5YVZ.js";import{useWords as c}from"./chunk-MFIRYGHW.js";import{useMemo as t,useState as d,useRef as l,useEffect as m,useCallback as g}from"react";import{Dialog as h,Button as f}from"efficient-shell/ui";import{jsx as u,jsxs as p,Fragment as v}from"react/jsx-runtime";var k=r(e),N=r(n);function C({onCancel:r,onDiscard:n,onSave:e}){const i=c("screen",o).leave,[a,s]=d(!1),t=l(!0);m(()=>(t.current=!0,()=>{t.current=!1}),[]);const k=g(async()=>{s(!0);try{await e()}finally{t.current&&s(!1)}},[e]);/* @__PURE__ */
+import{clientOnly as r}from"./chunk-GXQCZJOP.js";import{ScreenChrome as n}from"./chunk-VZUXOZGP.js";import{ScreenStoreProvider as e}from"./chunk-XJ23ULBP.js";import{ScreenDocumentProvider as i,useScreenDocument as a}from"./chunk-A6ZP5II4.js";import{DEFAULT_SCREEN_WORDS as o}from"./chunk-IYHO4XQX.js";import{documentPermissions as s}from"./chunk-THWO5YVZ.js";import{useWords as c}from"./chunk-MFIRYGHW.js";import{useMemo as t,useState as d,useRef as l,useEffect as m,useCallback as g}from"react";import{Dialog as h,Button as f}from"efficient-shell/ui";import{jsx as u,jsxs as p,Fragment as v}from"react/jsx-runtime";var k=r(e),C=r(n);function j({onCancel:r,onDiscard:n,onSave:e}){const i=c("screen",o).leave,[a,s]=d(!1),t=l(!0);m(()=>(t.current=!0,()=>{t.current=!1}),[]);const k=g(async()=>{s(!0);try{await e()}finally{t.current&&s(!1)}},[e]);/* @__PURE__ */
 return u(h,{open:!0,role:"alertdialog",size:"sm",title:i.title,onClose:r,footer:/* @__PURE__ */p(v,{children:[
 /* @__PURE__ */u(f,{variant:"secondary",onClick:r,children:i.cancel}),
 /* @__PURE__ */u(f,{variant:"ghost-danger",onClick:n,children:i.discard}),
-/* @__PURE__ */u(f,{variant:"primary",loading:a,onClick:()=>{k()},children:i.save})]}),children:i.body})}function j({target:r,addressing:n,onHostMessage:e,children:a}){/* @__PURE__ */
-return u(i,{target:r,addressing:n,onHostMessage:e,children:a})}var y=(r,n)=>/* @__PURE__ */p(v,{children:[r,n]});function A({config:r,parts:n,wrap:e=y}){const{data:i,error:d,redirecting:l,ready:m,readOnly:g,onChange:h,pendingNav:f,cancelPendingNav:p,discardAndNavigate:v,saveAndNavigate:j}=a(),A=t(()=>s(!g),[g]),Y=c("screen",o);return l?/* @__PURE__ */u("div",{className:"sf-msg",children:Y.loading}):d?/* @__PURE__ */u("div",{className:"sf-msg sf-msg--error",children:d}):m?i?e(
-/* @__PURE__ */u(k,{config:r,data:i,onChange:h,permissions:A,parts:n,children:/* @__PURE__ */u(N,{})}),f&&/* @__PURE__ */u(C,{onCancel:p,onDiscard:v,onSave:j})):/* @__PURE__ */u("div",{className:"sf-msg",children:Y.loading}):/* @__PURE__ */u("div",{className:"sf-msg",children:Y.waitingForAuthorization})}export{A as DocumentScreen,j as ScreenMount};
+/* @__PURE__ */u(f,{variant:"primary",loading:a,onClick:()=>{k()},children:i.save})]}),children:i.body})}function y({target:r,addressing:n,onHostMessage:e,children:a}){/* @__PURE__ */
+return u(i,{target:r,addressing:n,onHostMessage:e,children:a})}var N=(r,n)=>/* @__PURE__ */p(v,{children:[r,n]});function H({config:r,parts:n,wrap:e=N}){const{data:i,error:d,redirecting:l,ready:m,readOnly:g,onChange:h,pendingNav:f,cancelPendingNav:p,discardAndNavigate:v,saveAndNavigate:y}=a(),H=t(()=>s(!g),[g]),O=c("screen",o);return l?/* @__PURE__ */u("div",{className:"sf-msg",children:O.loading}):d?/* @__PURE__ */u("div",{className:"sf-msg sf-msg--error",children:d}):m?i?e(
+/* @__PURE__ */u(k,{config:r,data:i,onChange:h,permissions:H,parts:n,children:/* @__PURE__ */u(C,{})}),f&&/* @__PURE__ */u(j,{onCancel:p,onDiscard:v,onSave:y})):/* @__PURE__ */u("div",{className:"sf-msg",children:O.loading}):/* @__PURE__ */u("div",{className:"sf-msg",children:O.waitingForAuthorization})}export{H as DocumentScreen,y as ScreenMount};

package/dist/{chunk-KWLHKKZO.js → chunk-4YUC7B7E.js}

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

package/dist/chunk-6F5GO337.js

@@ -0,0 +1 @@
+import{useSectionOps as o}from"./chunk-FOOK54T2.js";import{SELECTION_MODE as e}from"./chunk-GXRS52JD.js";import{decodePartId as r,encodePartId as t}from"./chunk-R4AUZVA3.js";import{useEasel as n}from"./chunk-KXTXYINN.js";import{usePreviewParts as p}from"./chunk-467WWV4I.js";import{useCallback as d,useEffect as c}from"react";var s=o=>"part"===o.kind;function m({mode:m,setMode:i,onOpenPart:a}){const{getSelectorForId:u}=n(o=>o),I=o(),{setSelectedPartId:f,setSelectHandler:k}=p(),l=d(o=>{const t=r(o);if(!t)return;const{nodeId:n,propKey:p}=t;p?(i(o=>s(o)&&o.nodeId===n&&o.propKey===p?o:{kind:"part",nodeId:n,propKey:p}),a?.(n)):i(o=>"part"===o.kind?e:o)},[i,a]);c(()=>{k(l)},[k,l]);const K=s(m)?t(m.nodeId,m.propKey):null;c(()=>{f(K)},[K,f]);return{selectNode:d(o=>{i(()=>e);const r=u(o);r&&I.select(r)},[i,u,I]),openPartId:K}}export{m as usePartBridge};

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};