efficient-easel 22.0.0 → 23.1.0

package/dist/data/index.d.ts

@@ -1,29 +1,37 @@
-import { D as Data, a as DataConfig, N as Node, S as SlotAddress, F as Found, P as Place, b as SlotEntry, W as WalkInfo } from '../types-DlQIM1YO.js';
-export { B as BlockShape, c as FieldShape, d as FieldsShape, e as NodeProps, R as RootData } from '../types-DlQIM1YO.js';
-export { R as ResolvableItem, a as ResolveCache, b as ResolveOptions, c as ResolveTrigger, d as changedProps, e as createResolveCache, f as deepEqual, r as resolveNodeData } from '../resolve-AJ6WF4EL.js';
+import { N as Node, D as Data, a as DataConfig, S as SlotAddress, F as Found, P as Place, b as SlotEntry, W as WalkInfo } from '../types-Dq180WRV.js';
+export { B as BlockShape, c as FieldShape, d as FieldsShape, e as NodeProps, R as RootData } from '../types-Dq180WRV.js';
+export { R as ResolvableItem, a as ResolveCache, b as ResolveOptions, c as ResolveTrigger, d as changedProps, e as createResolveCache, f as deepEqual, r as resolveNodeData } from '../resolve-Bz4mszpL.js';
 
 /**
  * Finding a node's slots, and reading or writing a value at a prop path.
  *
- * A slot is found the way the old editor finds one: by the FIELDS, not by the value. A
+ * A slot is found the way the old library finds one: by the FIELDS, not by the value. A
  * prop is a slot when its field says `type: 'slot'`; a slot can also sit inside
  * an `object` field or inside each item of an `array` field, and its name is
- * then the prop path the old editor gives it — `items[0].content`, `box.content`.
+ * then the prop path the old library gives it — `items[0].content`, `box.content`.
  *
- * One deliberate difference from the old editor: the old editor also walks an object whose field is
+ * One deliberate difference from the old library: the old library also walks an object whose field is
  * NOT an `object` field using the PARENT's field map, so a key there that
  * happens to share a slot's name is treated as a slot. No document relies on
- * that (a non-array value there crashes the old editor's own walk), and a rule that
+ * that (a non-array value there crashes the old library's own walk), and a rule that
  * depends on a coincidence of names is not one to copy.
  *
  * Order is DECLARATION order — the order the fields are written in the config,
- * which is the order a person reads the block in (`col1` before `col2`). The old editor
+ * which is the order a person reads the block in (`col1` before `col2`). The old library
  * visits slots in reverse, as a side effect of how it fills empty ones; nothing
  * in either app depends on that.
  */
 
 /** One step of a prop path: a key, or an index into an array. */
 type Segment = string | number;
+/** One document node: a string `type` and a `props` object. */
+declare const isNode: (value: unknown) => value is Node;
+/**
+ * A slot's array, read by its SHAPE: non-empty, every item a node. A list field
+ * (stats rows, ticker items) fails and is left alone. The one answer for the
+ * easel and its hosts, so no walk keeps a private copy that drifts.
+ */
+declare const isNodeList: (value: unknown) => value is Node[];
 declare function getIn(value: unknown, segments: readonly Segment[]): unknown;
 
 /** One translated value, and the fingerprint of the base value it was made from. */
@@ -195,7 +203,7 @@ declare function copyTranslation(overlay: TranslationOverlay | null | undefined,
 /**
  * efficient-easel/data — the document, as pure functions.
  *
- * The bottom layer of the engine that replaces the old editor (the blueprint "From
+ * The bottom layer of the engine that replaces the old library (the blueprint "From
  * The Ground Up For Efficient Editor", 2026-09-29, step 1.1). Every function
  * takes a document and returns a new one; nothing here holds state, knows
  * about React, or touches a browser global, so a server component, a Node
@@ -213,17 +221,17 @@ declare function copyTranslation(overlay: TranslationOverlay | null | undefined,
  * round-trip spec pins each one:
  *
  *   1. An empty slot is written as `[]`, and `zones` is written as `{}`.
- *   2. Default props follow the old editor: a new block is created WITH its
+ *   2. Default props follow the old library: a new block is created WITH its
  *      `defaultProps`; the root's `defaultProps` are filled in on open; an
  *      existing block is never back-filled.
  *   3. A root prop that no field declares (a site's `theme`, `fonts`, `scales`)
  *      is kept exactly as it is. Nothing here drops a key it doesn't know.
  *   4. The two older formats are READ — root props written directly on `root`,
- *      and children parked in `zones` — and converted on open, the way the old editor's
+ *      and children parked in `zones` — and converted on open, the way the old library's
  *      `migrate()` converts them. They are never written back.
  *
  * KEY ORDER. The backend stores these documents in Postgres `jsonb`, which does
- * not keep key order, so "the same document as the old editor" means the same keys and
+ * not keep key order, so "the same document as the old library" means the same keys and
  * values. What this layer does promise is stronger for its own round trip: a
  * document that is already in shape comes back as THE SAME OBJECT (so
  * `normalizeData(doc) === doc`), and every edit copies only the nodes on the
@@ -239,7 +247,7 @@ declare function copyTranslation(overlay: TranslationOverlay | null | undefined,
  */
 
 /**
- * What `normalizeData` accepts: any saved document, as loosely as the old editor's own
+ * What `normalizeData` accepts: any saved document, as loosely as the old library's own
  * `Data` type describes one (`root.props` optional). Converting the older
  * shapes is its job, so it must take them without a cast. Every OTHER function
  * here takes the normalised `Data` it returns.
@@ -259,9 +267,9 @@ declare const ROOT_ID = "root";
 declare const ROOT_SLOT = "default-zone";
 /** The top-level list, as an address. */
 declare const ROOT_LIST: SlotAddress;
-/** `{ parentId, slot }` → the old editor's zone key `"<parentId>:<slot>"`. */
+/** `{ parentId, slot }` → the old library's zone key `"<parentId>:<slot>"`. */
 declare const zoneKey: ({ parentId, slot }: SlotAddress) => string;
-/** The old editor's zone key → `{ parentId, slot }`. Ids and prop paths hold no colon. */
+/** The old library's zone key → `{ parentId, slot }`. Ids and prop paths hold no colon. */
 declare function parseZoneKey(key: string): SlotAddress;
 type DataErrorCode = 'not-found' | 'no-slot' | 'bad-index' | 'duplicate-id' | 'cycle' | 'id-change' | 'unknown-type';
 declare class DataError extends Error {
@@ -294,7 +302,7 @@ declare function find(data: Data, config: DataConfig, id: string): Found | null;
 /** The list at an address, or `null` when no such slot exists. */
 declare function getList(data: Data, config: DataConfig, address: SlotAddress): Node[] | null;
 /**
- * What the easel does to a document when it opens it — the same result the old editor
+ * What the easel does to a document when it opens it — the same result the old library
  * reaches on load, with the older formats converted (rule 4):
  *
  *   - `root` holding its props directly becomes `{ props: { …those keys } }`;
@@ -309,7 +317,7 @@ declare function getList(data: Data, config: DataConfig, address: SlotAddress):
  */
 declare function normalizeData(data: DataInput | Data, config: DataConfig): Data;
 /**
- * A new block, the way the Add panel makes one — the old editor's `insert` recipe:
+ * A new block, the way the Add panel makes one — the old library's `insert` recipe:
  * `{ ...defaultProps, id }`, plus any `props` the caller starts it with. The
  * defaults are copied, so two blocks never share an array or object, and every
  * child a default slot seeds gets its own id.
@@ -328,7 +336,7 @@ declare function insert(data: Data, config: DataConfig, place: Place, node: Node
 declare function remove(data: Data, config: DataConfig, id: string): Data;
 /**
  * Move a node to `to`. Within one list, `to.index` is the node's index AFTER
- * the move (the old editor's rule), so `0 … length-1`; into another list it is the index
+ * the move (the old library's rule), so `0 … length-1`; into another list it is the index
  * to insert at, `0 … length`. A move into the node's own subtree is refused.
  */
 declare function move(data: Data, config: DataConfig, id: string, to: Place): Data;
@@ -336,7 +344,7 @@ declare function move(data: Data, config: DataConfig, id: string, to: Place): Da
  * Copy a node, and everything under it, to the place just after it. Every
  * copied node gets a fresh id. `strip` sees each copied node (with its new id)
  * and returns what to keep — the hook for "a copy must not claim the
- * original's baked image" (`bakedId`), which the old editor's own duplicate copied
+ * original's baked image" (`bakedId`), which the old library's own duplicate copied
  * verbatim.
  */
 declare function duplicate(data: Data, config: DataConfig, id: string, options?: {
@@ -354,7 +362,7 @@ declare function copyNode(node: Node, config: DataConfig, options?: {
     strip?: (node: Node) => Node;
 }): Node;
 /**
- * Merge `patch` into a node's props — the old editor's `replace`, for the common case of
+ * Merge `patch` into a node's props — the old library's `replace`, for the common case of
  * changing some props. A key keeps its place; a new key goes on the end;
  * `undefined` clears a key (JSON drops it on save). New children in a patched
  * slot are brought into shape. Changing `id` is refused. A patch that changes
@@ -362,7 +370,7 @@ declare function copyNode(node: Node, config: DataConfig, options?: {
  */
 declare function setProps(data: Data, config: DataConfig, id: string, patch: Record<string, unknown>): Data;
 /**
- * Replace a node wholesale — the old editor's `replace` action: the node keeps its place
+ * Replace a node wholesale — the old library's `replace` action: the node keeps its place
  * and its id, and every prop is the new node's (a key it does not carry is
  * gone, which `setProps` cannot do). Children in its slots that arrive without
  * an id get one, and an id another node already holds is refused, as `insert`
@@ -372,4 +380,4 @@ declare function replaceNode(data: Data, config: DataConfig, id: string, node: N
 /** Merge `patch` into the root's props, the same way `setProps` does. */
 declare function setRoot(data: Data, config: DataConfig, patch: Record<string, unknown>): Data;
 
-export { Data, DataConfig, DataError, type DataErrorCode, type DataInput, Found, Node, Place, ROOT_ID, ROOT_LIST, ROOT_SLOT, type Segment, SlotAddress, SlotEntry, type TranslatableItem, type TranslatablePath, type TranslatedValue, type TranslationEntries, type TranslationOverlay, type TranslationRef, type TranslationStatus, WalkInfo, applyTranslation, copyNode, copyTranslation, createNode, duplicate, extractTranslation, find, getIn, getList, insert, mapIds, move, newId, normalizeData, parseZoneKey, pruneTranslation, rebaseTranslation, remove, replaceNode, setProps, setRoot, slotsOf, translatablePaths, translationFingerprint, translationStatus, walk, zoneKey };
+export { Data, DataConfig, DataError, type DataErrorCode, type DataInput, Found, Node, Place, ROOT_ID, ROOT_LIST, ROOT_SLOT, type Segment, SlotAddress, SlotEntry, type TranslatableItem, type TranslatablePath, type TranslatedValue, type TranslationEntries, type TranslationOverlay, type TranslationRef, type TranslationStatus, WalkInfo, applyTranslation, copyNode, copyTranslation, createNode, duplicate, extractTranslation, find, getIn, getList, insert, isNode, isNodeList, mapIds, move, newId, normalizeData, parseZoneKey, pruneTranslation, rebaseTranslation, remove, replaceNode, setProps, setRoot, slotsOf, translatablePaths, translationFingerprint, translationStatus, walk, zoneKey };

package/dist/data/index.js

@@ -1 +1 @@
-export{DataError,ROOT_ID,ROOT_LIST,ROOT_SLOT,applyTranslation,changedProps,copyNode,copyTranslation,createNode,createResolveCache,deepEqual,duplicate,extractTranslation,find,getList,insert,mapIds,move,newId,normalizeData,parseZoneKey,pruneTranslation,rebaseTranslation,remove,replaceNode,resolveNodeData,setProps,setRoot,slotsOf,translatablePaths,translationFingerprint,translationStatus,walk,zoneKey}from"../chunk-K7BTCBWD.js";export{getIn}from"../chunk-L55YIXDC.js";
+export{DataError,ROOT_ID,ROOT_LIST,ROOT_SLOT,applyTranslation,changedProps,copyNode,copyTranslation,createNode,createResolveCache,deepEqual,duplicate,extractTranslation,find,getList,insert,mapIds,move,newId,normalizeData,parseZoneKey,pruneTranslation,rebaseTranslation,remove,replaceNode,resolveNodeData,setProps,setRoot,slotsOf,translatablePaths,translationFingerprint,translationStatus,walk,zoneKey}from"../chunk-TGZCD6IP.js";export{getIn,isNode,isNodeList}from"../chunk-KXM6YRG2.js";

package/dist/drag/drag.css

@@ -33,7 +33,8 @@
   display: inline-flex;
   pointer-events: none;
 }
-.es-canvas-handle {
+.es-canvas-handle,
+.es-canvas-tag {
   position: relative;
   display: inline-flex;
   align-items: center;
@@ -51,6 +52,14 @@
   pointer-events: none;
   transition: opacity 0.12s;
 }
+/* The selected part's name tag (`tag`, Lewis 2026-10-26): the handle's look
+   (above), placed where it is drawn, never taking the pointer. After the
+   shared rule, so its place and opacity win. */
+.es-canvas-tag {
+  position: absolute;
+  cursor: default;
+  opacity: 1;
+}
 .es-canvas-handle.is-shown {
   opacity: 1;
   pointer-events: auto;

package/dist/drag/index.d.ts

@@ -1,11 +1,11 @@
 import * as react from 'react';
 import { HTMLAttributes, CSSProperties, ReactNode } from 'react';
-import { P as Place } from '../types-DlQIM1YO.js';
-import { D as DragSession } from '../session-CrWwDt7Z.js';
-export { a as DragHeld, c as createDragSession } from '../session-CrWwDt7Z.js';
-export { B as Box, a as CanvasDragLayer, b as CanvasDragLayerProps, C as CanvasDragModel, c as CanvasDropTarget, d as CanvasSeam, e as CanvasSource, f as CanvasZone, E as EMPTY_MEASURE, H as HANDLE_GRACE_MS, M as MeasuredCanvas, g as MeasuredNode, h as canvasTarget, i as contains, j as gapInZone, k as gapLine, l as insertSeams, m as measureCanvas, p as pickSource, s as seamsBetween, n as sourcesAt } from '../CanvasDragLayer-B6Yn9S8T.js';
+import { P as Place } from '../types-Dq180WRV.js';
+import { D as DragSession } from '../session-EsjORLQ0.js';
+export { a as DragHeld, c as createDragSession } from '../session-EsjORLQ0.js';
+export { B as Box, a as CanvasDragLayer, b as CanvasDragLayerProps, C as CanvasDragModel, c as CanvasDropTarget, d as CanvasSeam, e as CanvasSource, f as CanvasZone, E as EMPTY_MEASURE, H as HANDLE_GRACE_MS, M as MeasuredCanvas, g as MeasuredNode, h as canvasTarget, i as contains, j as gapInZone, k as gapLine, l as insertSeams, m as measureCanvas, p as pickSource, s as seamsBetween, n as sourcesAt } from '../CanvasDragLayer-NZpaX6aq.js';
 import { D as DragWords } from '../words-SD4neL0n.js';
-import '../watch-D0bNZRtU.js';
+import '../watch-Unf6SfUf.js';
 
 /**
  * Where a drop lands — the engine's one hit rule, as pure functions (blueprint

package/dist/drag/index.js

@@ -1 +1 @@
-export{AddPanel,CanvasDragLayer,CanvasInsert,EMPTY_MEASURE,HANDLE_GRACE_MS,canvasTarget,contains,gapInZone,gapLine,insertSeams,measureCanvas,pickSource,seamsBetween,sourcesAt}from"../chunk-CUZQ2HMA.js";import"../chunk-TQ5Y6S2X.js";export{AUTO_SCROLL_EDGE,AUTO_SCROLL_MAX_SPEED,autoScrollDelta,autoScrollSpeed,createDragSession,dropEffectFor,dropOnRow,frameScrollBox,gapToMoveIndex,isNoOpDrop,scrollBoxOf,scrollParent,startAutoScroll,stepGap,useTreeDrag}from"../chunk-3S5N4HLJ.js";import"../chunk-P2VEMZH5.js";import"../chunk-GHBK7BKL.js";import"../chunk-LF3FUSCQ.js";import"../chunk-K7BTCBWD.js";import"../chunk-L55YIXDC.js";
+export{AddPanel,CanvasDragLayer,CanvasInsert,EMPTY_MEASURE,HANDLE_GRACE_MS,canvasTarget,contains,gapInZone,gapLine,insertSeams,measureCanvas,pickSource,seamsBetween,sourcesAt}from"../chunk-LN43DP2A.js";import"../chunk-TQ5Y6S2X.js";export{AUTO_SCROLL_EDGE,AUTO_SCROLL_MAX_SPEED,autoScrollDelta,autoScrollSpeed,createDragSession,dropEffectFor,dropOnRow,frameScrollBox,gapToMoveIndex,isNoOpDrop,scrollBoxOf,scrollParent,startAutoScroll,stepGap,useTreeDrag}from"../chunk-6NJHYXJM.js";import"../chunk-P2VEMZH5.js";import"../chunk-YU3WHLGI.js";import"../chunk-LF3FUSCQ.js";import"../chunk-TGZCD6IP.js";import"../chunk-KXM6YRG2.js";

package/dist/draw/index.d.ts

@@ -8,4 +8,4 @@ export { AUTO_RULES, AutoRule, FOLLOW_RULES, VIEW_DESKTOP_MIN, VIEW_TABLET_MIN,
 export { HERO_SLIDER_GOTO_EVENT, HeroSliderGotoDetail } from '../screen/lib/document/preview-events.js';
 export { R as REPEAT_ATTRIBUTE, a as REPEAT_INDEX_ATTRIBUTE } from '../repeat-D65bJS8d.js';
 export { TEXT_STYLE_CASES, TEXT_STYLE_CASE_CSS, TextStyleCase, TextStyleCaseCss, isTextStyleCase, textStyleCaseCss, textStyleCaseOfCss } from '../text-styles/model.js';
-import '../words-gIDCeRv3.js';
+import '../words-B5Gb7KFq.js';

package/dist/easel/easel.css

@@ -1,7 +1,7 @@
 /*
  * efficient-easel/easel — the canvas's own marks (blueprint 5.1): the
  * lists' empty and selected states, and the outlines over the selected and
- * hovered block. The old editor's stylesheet drew these until now; the rules follow it.
+ * hovered block. The old library's stylesheet drew these until now; the rules follow it.
  *
  * The canvas is an iframe of its own, so this sheet must reach it: import it
  * once in the host, and `CanvasFrame` copies the host's stylesheets into the
@@ -51,7 +51,7 @@
   z-index: 0;
 }
 /* A frame that FILLS its parent (`height="fill"`): the page is at least as tall
-   as the frame, as the old editor's `#frame-root` was, so a short page's background and
+   as the frame, as the old library's `#frame-root` was, so a short page's background and
    its top list reach the bottom of the canvas. `height: 1px` gives the root a
    height of its own for a list's `height: 100%` to resolve against. Not on an
    `auto` frame, whose height comes FROM the page: there `100vh` is the frame
@@ -82,8 +82,8 @@
 .es-zone:empty,
 .es-zone.is-area-selected:not(.is-root),
 .es-zone.is-hovering-area:not(.is-root) {
-  background: color-mix(in srgb, var(--es-accent, #2563eb) 6%, transparent);
-  outline: 2px dashed color-mix(in srgb, var(--es-accent, #2563eb) 35%, transparent);
+  background: color-mix(in srgb, var(--es-accent) 6%, transparent);
+  outline: 2px dashed color-mix(in srgb, var(--es-accent) 35%, transparent);
 }
 /* …except an empty list the drag layer draws its "+ Add block" cell over
    (`data-es-empty-cell`, efficient-easel/drag): at rest that slot draws
@@ -96,10 +96,12 @@
 }
 
 /* The outline colour, declared ONCE for the selection, the hover and the
-   words being typed. The accent, with a fallback: the outlines draw inside
-   the canvas frame, which holds the page's sheet and not the chrome's tokens. */
+   words being typed: the chrome's accent, no colour of our own. The outlines
+   draw inside the canvas frame, a document of its own: `--es-accent` reaches
+   it as the frame's `:root` sheet (`canvas/host-tokens`, read off the chrome),
+   so the canvas follows the shell's accent. */
 .es-canvas-outline {
-  --es-canvas-outline-colour: var(--es-accent, #2563eb);
+  --es-canvas-outline-colour: var(--es-accent);
   pointer-events: none;
   box-sizing: border-box;
   z-index: 2147483000;
@@ -114,9 +116,9 @@
 }
 /* A node many pages use live (`CanvasSharedContext`; Shared section design v4,
    Lewis 2026-10-21): its selected and hover outlines in the shell's success
-   colour, as its Layers row and tab are. The frame holds the host's sheets,
-   and with them the shell's tokens; without them, the accent. No colour of
-   our own (harness UI-24). */
+   colour, as its Layers row and tab are. `--status-success-solid` reaches the
+   frame the same way (`canvas/host-tokens`); without it, the accent. No
+   colour of our own (harness UI-24). */
 .es-canvas-outline.is-shared {
   --es-canvas-outline-colour: var(--status-success-solid, var(--es-accent));
 }
@@ -125,11 +127,19 @@
    colour, 4px clear of them, with the selection outline's square corners. It
    is measured from the words' bounding box, so words on three lines get one
    rectangle, not a line round each. Its colour is the one outline colour
-   above: without its fallback the outline is not drawn in the canvas. */
-.es-canvas-outline.is-typing {
+   above: a frame without the chrome's token (`canvas/host-tokens`) draws no
+   outline. */
+.es-canvas-outline.is-typing,
+.es-canvas-outline.is-selected.is-words {
   outline: 2px solid var(--es-canvas-outline-colour);
-  outline-offset: 4px;
-}
+  outline-offset: var(--es-words-clear);
+}
+/* The 4px is WORDS_CLEAR in canvas/dom, the one home: the canvas sets
+   `--es-words-clear` from it on both boxes; no literal here. Selected words
+   wear that same box from the click on (Lewis 2026-10-26, option B): a
+   double-click puts the caret in it and moves nothing. The drag layer keeps
+   the handle, the name and the hint on its corners, measured from the same
+   constant. */
 /* THE POINTER (Lewis 2026-10-20, mockup v4 decision c): on the canvas it is
    the arrow — over words, and over the links and buttons the page drew, which
    the canvas never follows — and the I-beam only inside the words being