efficient-easel 24.2.0 → 25.1.0

package/dist/copy-place-CQIemdtU.d.ts

@@ -0,0 +1,25 @@
+/** One drawn copy's place. */
+interface RepeatCopy {
+    /** The block whose slot is drawn once per row. */
+    ownerId: string;
+    /** That slot (`template`). */
+    slot: string;
+    /** The row this copy is drawn for; 0 is the main copy. */
+    index: number;
+    /** How many copies the owner draws (greys a host's "move later" on the last). */
+    count: number;
+    /**
+     * The copy of an OUTER template this copy's owner is drawn in, when there
+     * is one: the inner index alone names no row (row 2 of the cards in outer
+     * row 1). Left out at the top.
+     */
+    outer?: RepeatCopy;
+}
+/**
+ * The copy `el` is in — the NEAREST wrapper with both names, with the chain
+ * of outer copies round it — or null outside every copy, or where the
+ * wrapper's zone key or index cannot be read.
+ */
+declare function repeatCopyAt(el: Element): RepeatCopy | null;
+
+export { type RepeatCopy as R, repeatCopyAt as r };

package/dist/data/index.d.ts

@@ -316,6 +316,9 @@ declare function getList(data: Data, config: DataConfig, address: SlotAddress):
  * A document already in shape is returned as the same object.
  */
 declare function normalizeData(data: DataInput | Data, config: DataConfig): Data;
+/** A plain copy that shares nothing with the original; `undefined` stays
+ *  `undefined`. The one deep copy of the package (a document is JSON). */
+declare function clone<T>(value: T): T;
 /**
  * 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
@@ -380,4 +383,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, isNode, isNodeList, 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, clone, 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-TGZCD6IP.js";export{getIn,isNode,isNodeList}from"../chunk-KXM6YRG2.js";
+export{DataError,ROOT_ID,ROOT_LIST,ROOT_SLOT,applyTranslation,changedProps,clone,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-EUFDQ4KL.js";export{getIn,isNode,isNodeList}from"../chunk-KXM6YRG2.js";

package/dist/dom-BpxMcHFP.d.ts

@@ -0,0 +1,200 @@
+/**
+ * A TEMPLATE DRAWN MANY TIMES (section parts plan §3.2, row B5, 2026-10-23).
+ *
+ * A data block (a product grid, a list of posts) holds ONE `template` slot of
+ * real blocks and draws it once per data row. So the same block ids are in the
+ * canvas several times. The host wraps each drawn copy:
+ *
+ *   <div data-sf-repeat="<ownerId>:template" data-sf-repeat-index={i}>
+ *
+ * Index 0 is the MAIN copy. The blocks inside keep their real
+ * `data-easel-block` / `data-easel-dnd` ids in every copy, so a click on any
+ * copy selects the template block. What the canvas does with the copies:
+ *   - the hover and the selected outline are drawn on every copy;
+ *   - only the main copy's lists are drop targets (the others are pictures);
+ *   - a lookup of one element by id reads the main copy.
+ *
+ * The two names are written HERE, once. The website draws the wrappers with
+ * them (it imports them from `efficient-easel/draw`, a render entry), so the
+ * string is never typed twice. Pure DOM, no import, nothing run at import.
+ *
+ * A page with no `data-sf-repeat` gets the same answers as before: every
+ * helper below falls back to the first match.
+ */
+/** The wrapper round one drawn copy of a template: `"<ownerId>:<slot>"`. */
+declare const REPEAT_ATTRIBUTE = "data-sf-repeat";
+/** Which copy the wrapper holds: `"0"` is the main copy. */
+declare const REPEAT_INDEX_ATTRIBUTE = "data-sf-repeat-index";
+/**
+ * Is `el` in a copy that is NOT the main one — inside (or itself) a wrapper
+ * whose index is not 0, at any depth (a template inside a copy of an outer
+ * template is a copy too)? False for a block in no wrapper at all.
+ */
+declare function isRepeatCopy(el: Element): boolean;
+/** The main copy among `matches`: the first that is not a copy, else the first. */
+declare function mainCopyOf<T extends Element>(matches: Iterable<T>): T | null;
+/**
+ * `root.querySelector(selector)`, but the main copy when a template is drawn
+ * many times. With no `data-sf-repeat` it is exactly `querySelector`.
+ */
+declare function queryMainCopy<T extends Element = Element>(root: ParentNode, selector: string): T | null;
+/**
+ * The element for `selector` in every drawn copy: the main copy first, then
+ * each other copy in page order. With no `data-sf-repeat` it is the first
+ * match alone, as `querySelector` answers — a second element with the same id
+ * that is not a drawn copy is never added.
+ */
+declare function queryAllCopies<T extends Element = Element>(root: ParentNode, selector: string): T[];
+/**
+ * THE WRAPPER ROUND ONE DRAWN COPY (card copy typing, 2026-10-30): the
+ * nearest element with BOTH names (a wrapper missing its index is passed
+ * over), its zone key as written (`"<ownerId>:<slot>"`) and its index — or
+ * null outside every copy, or where the index is not a whole number. The
+ * zone key is read by the data layer's one parser (`efficient-easel/data`
+ * `parseZoneKey`, in `easel/copy-place`): this file imports nothing, because
+ * `draw` reads it.
+ */
+declare function repeatWrapperAt(el: Element): {
+    wrapper: Element;
+    zone: string;
+    index: number;
+} | null;
+
+/**
+ * The small facts every canvas surface needs, written once — pure DOM, no
+ * React, nothing run at import.
+ *
+ * Each answers a question both editors used to answer for themselves, and
+ * sometimes differently (the blueprint's §2 rows 6–10):
+ *
+ *   isTypingTarget   is this keystroke someone TYPING, so a shortcut must stay out?
+ *   nodeIdAt         which block did this pointer event land on?
+ *   frameScale       how much is the canvas frame scaled (a phone view drawn small)?
+ *   frameRectToHost  where is a box measured INSIDE the frame, on the host page?
+ *   fitCanvas        how wide is the canvas, and at what scale does it fit?
+ *   canvas styles    a stylesheet that lives in the canvas document ONLY.
+ */
+/**
+ * Is the event's target somewhere a person TYPES — a text field, a textarea, a
+ * native select, an editable region? A shortcut (undo, delete, copy style) must
+ * not fire there: the key belongs to the field. Duck-typed rather than
+ * `instanceof`, because a canvas element belongs to the frame's own realm and
+ * is not an instance of the host's `HTMLElement`.
+ */
+declare function isTypingTarget(target: EventTarget | null): boolean;
+/** The attribute on every block the canvas draws. */
+declare const BLOCK_ATTRIBUTE = "data-easel-block";
+
+/**
+ * The id of the block a pointer event landed on: the NEAREST ancestor (or the
+ * target itself) carrying `attribute`. `null` on bare canvas.
+ */
+declare function nodeIdAt(target: EventTarget | null, attribute?: string): string | null;
+/**
+ * The box a block DREW, in its frame's viewport (8.2.0). Most blocks draw inside
+ * 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 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;
+    width: number;
+    height: number;
+}
+/**
+ * How much the frame is drawn scaled on the host page: its on-screen width over
+ * its layout width. The storefront draws tablet and phone at their real widths
+ * and scales the frame down to fit the pane; the campaign designer does not
+ * scale. 1 when the frame has no layout width yet.
+ */
+declare function frameScale(frame: HTMLElement): number;
+/**
+ * A box measured INSIDE the frame (an element's getBoundingClientRect in the
+ * frame's own viewport) as a box on the HOST page, relative to `origin` — the
+ * overlay layer the box will be drawn in — and through the frame's scale. The
+ * scale is the term both apps' own conversions left out on a scaled view.
+ */
+declare function frameRectToHost(frame: HTMLElement, box: Box, origin?: Element | null): Box;
+/**
+ * How much `el` is drawn scaled on screen: its on-screen width over its layout
+ * width. 1 when it is not scaled, or has no layout width yet. An overlay that
+ * shares a scaled ancestor with the frame (the storefront scales the whole
+ * device box, frame and overlay together) is scaled too, and its own CSS pixels
+ * are then that much smaller or larger than the screen's.
+ */
+declare function elementScale(el: Element): number;
+/**
+ * A box measured inside the frame as a box in `layer`'s OWN CSS coordinates —
+ * what an absolutely positioned child of `layer` is placed with. The same as
+ * `frameRectToHost` when the layer is not scaled; when it shares a scaled
+ * ancestor with the frame, every screen distance is divided back into the
+ * layer's pixels, or everything it draws lands the scale's factor away.
+ */
+declare function frameRectToLayer(frame: HTMLElement, box: Box, layer: Element): Box;
+/** A pointer position on the HOST page (clientX/clientY there) in `layer`'s own CSS coordinates. */
+declare function clientPointToLayer(layer: Element, x: number, y: number): {
+    x: number;
+    y: number;
+};
+/** A pointer position inside the frame (clientX/clientY there) on the host page. */
+declare function framePointToHost(frame: HTMLElement, x: number, y: number, origin?: Element | null): {
+    x: number;
+    y: number;
+};
+interface CanvasFit {
+    /** The canvas's layout width — the device's, or the pane's for a fluid view. */
+    width: number;
+    /** The scale that fits `width` into the pane, capped at `maxScale`. */
+    scale: number;
+    /** What the canvas occupies on screen: `width * scale`. */
+    shownWidth: number;
+}
+/**
+ * The canvas width and scale for a pane `available` px wide. A device with no
+ * width of its own (desktop, an email's inbox view) takes the pane's width at
+ * scale 1; a device width that does not fit is scaled down to fit, and one that
+ * does is scaled up no further than `maxScale` (the storefront allows 2; pass 1
+ * for "never enlarge").
+ */
+declare function fitCanvas({ available, width, maxScale, }: {
+    available: number;
+    width?: number | null;
+    maxScale?: number;
+}): CanvasFit;
+/**
+ * Say which CSP nonce the stylesheets this module puts in `doc` must carry —
+ * for a host whose policy allows inline styles by nonce (`style-src
+ * 'nonce-…'`), where a `<style>` without it is refused. Every sheet
+ * `upsertCanvasStyle` / `useCanvasStyle` creates in `doc` afterwards wears it.
+ *
+ * `CanvasFrame` (`efficient-easel/easel`) calls this with its `nonce` prop as
+ * it builds the frame, so a host says it once; a host that builds its own
+ * frame calls it itself. `undefined` (or `''`) forgets it.
+ */
+declare function setCanvasNonce(doc: Document, nonce: string | undefined): void;
+/**
+ * Put `css` in the canvas document's `<head>` under `key`, replacing what that
+ * key held before. It lives in the canvas ONLY — not mirrored from the host
+ * head, so it cannot leak into the host page, and not dependent on anyone
+ * noticing a change to it. Writes nothing when the text is already current.
+ * A new sheet carries the document's nonce, when it was given one
+ * ({@link setCanvasNonce}).
+ */
+declare function upsertCanvasStyle(doc: Document, key: string, css: string): HTMLStyleElement;
+/** Take `key`'s stylesheet out of the canvas document, if it is there. */
+declare function removeCanvasStyle(doc: Document, key: string): void;
+
+export { BLOCK_ATTRIBUTE as B, type CanvasFit as C, REPEAT_ATTRIBUTE as R, WORDS_CLEAR as W, REPEAT_INDEX_ATTRIBUTE as a, type Box as b, clientPointToLayer as c, drawnBox as d, elementScale as e, fitCanvas as f, framePointToHost as g, frameRectToHost as h, frameRectToLayer as i, frameScale as j, isRepeatCopy as k, isTypingTarget as l, mainCopyOf as m, nodeIdAt as n, queryMainCopy as o, removeCanvasStyle as p, queryAllCopies as q, related as r, repeatWrapperAt as s, setCanvasNonce as t, upsertCanvasStyle as u };

package/dist/drag/index.d.ts

@@ -1,9 +1,8 @@
 import * as react from 'react';
 import { HTMLAttributes, CSSProperties, ReactNode } from 'react';
 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 DragSession } from '../CanvasDragLayer-DXeQGrwJ.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, g as DragHeld, E as EMPTY_MEASURE, H as HANDLE_GRACE_MS, M as MeasuredCanvas, h as MeasuredNode, i as canvasTarget, j as contains, k as createDragSession, l as gapInZone, m as gapLine, n as insertSeams, o as measureCanvas, p as pickSource, s as seamsBetween, q as sourcesAt } from '../CanvasDragLayer-DXeQGrwJ.js';
 import { D as DragWords } from '../words-SD4neL0n.js';
 import '../watch-Unf6SfUf.js';
 

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-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";
+export{AddPanel,CanvasDragLayer,CanvasInsert,EMPTY_MEASURE,HANDLE_GRACE_MS,canvasTarget,contains,gapInZone,gapLine,insertSeams,measureCanvas,pickSource,seamsBetween,sourcesAt}from"../chunk-SQTVXE5D.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-3XECMGXX.js";import"../chunk-P2VEMZH5.js";import"../chunk-TOKMFZPB.js";import"../chunk-FR7EEKFF.js";import"../chunk-7UFKEX72.js";import"../chunk-EUFDQ4KL.js";import"../chunk-KXM6YRG2.js";

package/dist/draw/index.d.ts

@@ -6,6 +6,6 @@ export { RowNameRule, rootRowName, sectionRenameProp, slotChildName, slotChildRe
 export { FOOTER_TYPE, HEADER_TYPE, NodeLocation, ROOT_ZONE, SlotConfigView, TREE_MAX_DEPTH, TreeItem, blockNodeActions, childSlotsOf, locateNode, missingPinnedTypes, nestsInTree, newNodeId, pinnedDuplicateIds, pinnedDuplicateIndices, slotChildrenIn, slotFieldsOf } from '../screen/lib/document/content-tree.js';
 export { AUTO_RULES, AutoRule, FOLLOW_RULES, VIEW_DESKTOP_MIN, VIEW_TABLET_MIN, VIEW_TIERS, VIEW_TIER_LABEL, ViewTier, ViewValueKind, ViewValues, isAuto, phoneKey, resolveViewValue, tabletKey, viewTierForWidth } from '../screen/lib/content/view-tiers.js';
 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 { B as BLOCK_ATTRIBUTE, R as REPEAT_ATTRIBUTE, a as REPEAT_INDEX_ATTRIBUTE } from '../dom-BpxMcHFP.js';
 export { TEXT_STYLE_CASES, TEXT_STYLE_CASE_CSS, TextStyleCase, TextStyleCaseCss, isTextStyleCase, textStyleCaseCss, textStyleCaseOfCss } from '../text-styles/model.js';
 import '../words-B5Gb7KFq.js';

package/dist/draw/index.js

@@ -1 +1 @@
-export{SCALAR_TEXT_CONTROLS,TEXT_CONTROL_KINDS}from"../chunk-I6SK6ZDT.js";export{AUTO_RULES,FOLLOW_RULES,VIEW_DESKTOP_MIN,VIEW_TABLET_MIN,VIEW_TIERS,VIEW_TIER_LABEL,isAuto,phoneKey,resolveViewValue,tabletKey,viewTierForWidth}from"../chunk-E52W3M5I.js";export{rootRowName,sectionRenameProp,slotChildName,slotChildRenameProp,slotChildRowName}from"../chunk-5NHQ452C.js";export{hidableText,readHidable}from"../chunk-6UAEFOJ4.js";export{HERO_SLIDER_GOTO_EVENT}from"../chunk-AJ2SUSET.js";export{ANCHOR_FIELD_KEYS,FOLD_FIELD_MARKER,LINK_FIELD_MARKER,MEDIA_FIELD_MARKER,SCAFFOLD_FIELD_MARKER,TEXT_FIELD_MARKER,foldMetaOf,textFieldIdentifier}from"../chunk-ANPOR6EY.js";export{PART_SEP,decodePartId,encodePartId}from"../chunk-R4AUZVA3.js";export{FOOTER_TYPE,HEADER_TYPE,ROOT_ZONE,TREE_MAX_DEPTH,blockNodeActions,childSlotsOf,locateNode,missingPinnedTypes,nestsInTree,newNodeId,pinnedDuplicateIds,pinnedDuplicateIndices,slotChildrenIn,slotFieldsOf}from"../chunk-TCAAOYQY.js";export{TEXT_STYLE_CASES,TEXT_STYLE_CASE_CSS,isTextStyleCase,textStyleCaseCss,textStyleCaseOfCss}from"../chunk-YHZSBL2N.js";export{REPEAT_ATTRIBUTE,REPEAT_INDEX_ATTRIBUTE}from"../chunk-LF3FUSCQ.js";
+export{SCALAR_TEXT_CONTROLS,TEXT_CONTROL_KINDS}from"../chunk-I6SK6ZDT.js";export{AUTO_RULES,FOLLOW_RULES,VIEW_DESKTOP_MIN,VIEW_TABLET_MIN,VIEW_TIERS,VIEW_TIER_LABEL,isAuto,phoneKey,resolveViewValue,tabletKey,viewTierForWidth}from"../chunk-E52W3M5I.js";export{HERO_SLIDER_GOTO_EVENT}from"../chunk-AJ2SUSET.js";export{rootRowName,sectionRenameProp,slotChildName,slotChildRenameProp,slotChildRowName}from"../chunk-5NHQ452C.js";export{hidableText,readHidable}from"../chunk-6UAEFOJ4.js";export{ANCHOR_FIELD_KEYS,FOLD_FIELD_MARKER,LINK_FIELD_MARKER,MEDIA_FIELD_MARKER,SCAFFOLD_FIELD_MARKER,TEXT_FIELD_MARKER,foldMetaOf,textFieldIdentifier}from"../chunk-ANPOR6EY.js";export{PART_SEP,decodePartId,encodePartId}from"../chunk-R4AUZVA3.js";export{FOOTER_TYPE,HEADER_TYPE,ROOT_ZONE,TREE_MAX_DEPTH,blockNodeActions,childSlotsOf,locateNode,missingPinnedTypes,nestsInTree,newNodeId,pinnedDuplicateIds,pinnedDuplicateIndices,slotChildrenIn,slotFieldsOf}from"../chunk-TCAAOYQY.js";export{TEXT_STYLE_CASES,TEXT_STYLE_CASE_CSS,isTextStyleCase,textStyleCaseCss,textStyleCaseOfCss}from"../chunk-YHZSBL2N.js";export{BLOCK_ATTRIBUTE}from"../chunk-FR7EEKFF.js";export{REPEAT_ATTRIBUTE,REPEAT_INDEX_ATTRIBUTE}from"../chunk-7UFKEX72.js";

package/dist/easel/index.d.ts

@@ -8,6 +8,8 @@ import { c as ResolveTrigger, a as ResolveCache, R as ResolvableItem } from '../
 import * as react from 'react';
 import { ReactNode, CSSProperties, ComponentType, ReactElement } from 'react';
 import { TextToolbarProps } from 'efficient-shell/ui';
+import { R as RepeatCopy } from '../copy-place-CQIemdtU.js';
+export { r as repeatCopyAt } from '../copy-place-CQIemdtU.js';
 import { C as CopyBoxLastTool, a as CopyThemeColor, b as CanvasTypingEnd } from '../canvas-typing-DOBx8dD3.js';
 import { InlineRule } from 'efficient-shell/markup';
 import { b as NodeOpsHost, C as ClipboardEntry } from '../useNodeOps-igxrnEhq.js';
@@ -452,6 +454,13 @@ interface CanvasTypingTarget {
     skip?: string;
     /** The host's ONE writer for these words — the panel's text box's. */
     write: (next: string) => void;
+    /**
+     * The prop of the words' block these words are saved in (`text`). Given,
+     * words typed in a drawn copy of a card template go to the host's
+     * `CanvasTyping.onCopyText` with it; left out, they are written through
+     * `write` as before.
+     */
+    key?: string;
     /** Draw the words afresh (after an IME composition wrote into them). */
     remount?: () => void;
     /**
@@ -500,6 +509,58 @@ interface CanvasTyping {
     atSelection?: () => CanvasTypingTarget | null;
     /** Typing started or ended: the host's text toolbar comes to the words, its panel follows. */
     onChange?: (state: CanvasTypingState) => void;
+    /**
+     * Words typed in a DRAWN COPY of a card template (card copy typing,
+     * 2026-10-30). A copy is drawn for a row of its owner's data, so what it
+     * shows is the row's, not the template's: each write of the session (every
+     * edit step, an undo in the words included) comes here with the copy's
+     * place instead of going through the target's `write`. Asked only when the
+     * words are inside a `data-sf-repeat` wrapper (`repeatCopyAt`) — the
+     * main copy, row 0, too — and the target names its `key`. The session
+     * starts from `copyValue`'s answer; with none, from the template's string
+     * when the copy draws it, else from the words the copy SHOWS (plain: their
+     * marks are not known). Enter after a click on a copy types that copy.
+     *
+     * Return `false` to say these words are the template's own (the block is
+     * not bound to the row): easel writes them through the target's `write`,
+     * as before. Left out, typing in a copy is what it was.
+     */
+    onCopyText?: (edit: CanvasCopyText) => boolean | void;
+    /**
+     * The copy's words AS SAVED, in the string's grammar (`rules`): the row's
+     * value with its marks (bold, a link, a colour), for the session to start
+     * from, so the first key keeps them. Asked when a copy session starts.
+     * `undefined`, or left out: the session starts as `onCopyText` says.
+     * Return `undefined` wherever `onCopyText` would return `false` (words
+     * that are the template's own): a row's string there would start the
+     * session from words `write` does not hold.
+     */
+    copyValue?: (copy: CanvasCopyPlace) => string | undefined;
+}
+/** A drawn copy's words: the copy's place (`RepeatCopy`, its `outer` chain
+ *  included), the template block the words are in and the prop they are
+ *  saved in (`CanvasTypingTarget.key`). */
+type CanvasCopyPlace = RepeatCopy & {
+    nodeId: string;
+    key: string;
+};
+/** Words typed in a drawn copy (`CanvasTyping.onCopyText`): where, and what. */
+interface CanvasCopyText {
+    /** The block whose slot is drawn once per row. */
+    ownerId: string;
+    /** That slot (`template`). */
+    slot: string;
+    /** The row the copy is drawn for; 0 is the main copy. */
+    index: number;
+    /** The copy of an outer template this copy's owner is drawn in, when
+     *  there is one (`RepeatCopy.outer`): the inner index alone names no row. */
+    outer?: RepeatCopy;
+    /** The template block the words are in. */
+    nodeId: string;
+    /** The prop the words are saved in (`CanvasTypingTarget.key`). */
+    key: string;
+    /** The words, in the string's grammar (`rules`), after this edit. */
+    text: string;
 }
 interface EaselCanvasProps {
     /** Draw in an iframe of the easel's own (default), or straight into the page. */
@@ -632,6 +693,11 @@ interface SelectedFields {
  * selected when the change began.
  */
 declare function useSelectedFields(): SelectedFields;
+/** The selected node's host, or `null` outside an editor (a guard, a harness),
+ *  where `useSelectedFields` throws: a row then reads nothing and writes
+ *  nothing. The ONE place that catch is made. Called unconditionally, so hook
+ *  order never changes. */
+declare function useSelectedHost(): SelectedFields | null;
 /**
  * The ROOT's fields and write, whatever is selected: `useSelectedFields` with
  * nothing selected, for a panel that edits the page beside a selection — the
@@ -679,4 +745,4 @@ declare function bindUndoKeys(doc: Document, easel: Pick<Easel, 'undo' | 'redo'>
     leaveTyping?: boolean;
 }): () => void;
 
-export { CHROME_ATTR, type CanvasChrome, CanvasChromeContext, CanvasFrame, type CanvasFrameProps, type CanvasOverlay, type CanvasPart, type CanvasParts, CanvasPartsContext, CanvasPassThroughContext, CanvasSharedContext, type CanvasSlotProps, type CanvasTyping, type CanvasTypingState, type CanvasTypingTarget, DEFAULT_UI, type Easel, EaselAction, EaselCanvas, type EaselCanvasProps, EaselConfig, EaselCore, type EaselOptions, EaselProvider, type EaselProviderProps, EaselUi, EaselView, EditDocument, NodeSelection, Permissions, type SelectedFields, bindUndoKeys, createEasel, createUseEasel, partHasOwnBox, recordsByDefault, reduce, uiView, useEasel, useEaselApi, useEaselNodeOps, useRootFields, useSelectedFields, validSelection };
+export { CHROME_ATTR, type CanvasChrome, CanvasChromeContext, type CanvasCopyPlace, type CanvasCopyText, CanvasFrame, type CanvasFrameProps, type CanvasOverlay, type CanvasPart, type CanvasParts, CanvasPartsContext, CanvasPassThroughContext, CanvasSharedContext, type CanvasSlotProps, type CanvasTyping, type CanvasTypingState, type CanvasTypingTarget, DEFAULT_UI, type Easel, EaselAction, EaselCanvas, type EaselCanvasProps, EaselConfig, EaselCore, type EaselOptions, EaselProvider, type EaselProviderProps, EaselUi, EaselView, EditDocument, NodeSelection, Permissions, RepeatCopy, type SelectedFields, bindUndoKeys, createEasel, createUseEasel, partHasOwnBox, recordsByDefault, reduce, uiView, useEasel, useEaselApi, useEaselNodeOps, useRootFields, useSelectedFields, useSelectedHost, validSelection };

package/dist/easel/index.js

@@ -1 +1 @@
-export{CHROME_ATTR,CanvasChromeContext,CanvasFrame,CanvasPartsContext,CanvasPassThroughContext,CanvasSharedContext,DEFAULT_UI,EaselCanvas,EaselProvider,EditDocument,bindUndoKeys,createEasel,createUseEasel,partHasOwnBox,recordsByDefault,reduce,uiView,useEasel,useEaselApi,useEaselNodeOps,useRootFields,useSelectedFields,validSelection}from"../chunk-FJTCSQWK.js";import"../chunk-TBY3DFKS.js";import"../chunk-AGWKB77Q.js";import"../chunk-RPMSET77.js";import"../chunk-HZSZT3BE.js";import"../chunk-KRL3IUV3.js";import"../chunk-MFIRYGHW.js";import"../chunk-YU3WHLGI.js";import"../chunk-LF3FUSCQ.js";import"../chunk-TGZCD6IP.js";import"../chunk-KXM6YRG2.js";
+export{CHROME_ATTR,CanvasChromeContext,CanvasFrame,CanvasPartsContext,CanvasPassThroughContext,CanvasSharedContext,DEFAULT_UI,EaselCanvas,EaselProvider,EditDocument,bindUndoKeys,createEasel,createUseEasel,partHasOwnBox,recordsByDefault,reduce,uiView,useEasel,useEaselApi,useEaselNodeOps,useRootFields,useSelectedFields,useSelectedHost,validSelection}from"../chunk-BBD3FLU3.js";export{repeatCopyAt}from"../chunk-JQQFB7EZ.js";import"../chunk-TBY3DFKS.js";import"../chunk-K53PQAMP.js";import"../chunk-QTHQPJWA.js";import"../chunk-HZSZT3BE.js";import"../chunk-PMRN5Z3T.js";import"../chunk-MFIRYGHW.js";import"../chunk-TOKMFZPB.js";import"../chunk-FR7EEKFF.js";import"../chunk-7UFKEX72.js";import"../chunk-EUFDQ4KL.js";import"../chunk-KXM6YRG2.js";

package/dist/edit-lock/index.d.ts

@@ -20,52 +20,6 @@ type LockWords = {
     someone: string;
 };
 
-/**
- * Who may WRITE the open document, and what to tell the operator when they may
- * not — for EVERY editor in the house.
- *
- * This module is the merge of two files that had grown side by side and said
- * the same things in two places (card 11161):
- *
- *   * `efficient-admin-portal/src/components/email/campaignEditLock.ts` — the
- *     campaign designer's copy, which alone had the TAKE-OVER half;
- *   * `efficient-storefront/lib/editor-page-lock.ts` — the storefront editor's copy,
- *     which alone had the claim/heartbeat driver, the auth-rejection rule and
- *     the "a template has no lock" rule.
- *
- * Neither was a subset of the other, so this file keeps EVERY capability of
- * both, and both editors now import it instead of carrying a copy.
- *
- * TWO INDEPENDENT PROTECTIONS, and it matters which is which:
- *
- *   * the SAVE-TIME version check is what actually protects work. The backend
- *     refuses a document write whose base version has moved on, so no amount of
- *     client-side confusion can erase a colleague's edits. Nothing here can
- *     weaken it — the token travels with the write and the server decides.
- *   * this advisory LOCK only stops two people STARTING, and is soft on
- *     purpose: it expires, it can always be taken over, and — see
- *     `accessAfterClaimFailure` — it FAILS OPEN. A lock that could refuse to
- *     let anybody edit would be worse than no lock at all. A save consults it
- *     in one case only: a tab somebody TOOK the document from is refused
- *     (`EDIT_LOCK_TAKEN`, read by `readLockTaken`), so it stops at its next
- *     save instead of its next heartbeat.
- *
- * The backend rule is one rule shared by both (efficient/editlock.py). These
- * are two CONSUMERS of one server-side contract, which is exactly why one
- * client module can serve them.
- *
- * WHAT IS NOT SHARED, and why there is a factory rather than plain functions:
- * the two editors talk to the backend through different HTTP clients, so a
- * failure arrives as an `AxiosError` in one and as an `ApiError` in the other,
- * and the refused-save payload carries a different `code`. Those two facts —
- * and nothing else — are handed in by the consumer through `createEditLock`.
- * The module itself imports no HTTP client and knows about no repo.
- *
- * LEAF DISCIPLINE: pure TypeScript. No React, no `document`/`window`, no
- * dependency at all. `crypto` is touched inside a function, never at module
- * eval, so a Next server component may import this module safely.
- */
-
 /** The `edit-lock` body — identical for every editable document. */
 type EditLockBody = {
     held_by_you: boolean;

package/dist/edit-lock/index.js

@@ -1 +1 @@
-export{CLAIM_FAIL_OPEN_MS,EDIT_LOCK_TAKEN,FAIL_OPEN_RETRY_MS,accessForNewDocument,canWriteDocument,createEditLock,describeAge,documentPermissions,documentVersionMoved,holderOf,nameOrSomeone,newEaselClientId,openUnansweredClaim,readLockHolder,reloadIfVersionMoved,shouldReleaseHeldWrite,shouldReloadAfterTakeover}from"../chunk-THWO5YVZ.js";import"../chunk-RE4LP46F.js";
+export{CLAIM_FAIL_OPEN_MS,EDIT_LOCK_TAKEN,FAIL_OPEN_RETRY_MS,accessForNewDocument,canWriteDocument,createEditLock,describeAge,documentPermissions,documentVersionMoved,holderOf,nameOrSomeone,newEaselClientId,openUnansweredClaim,readLockHolder,reloadIfVersionMoved,shouldReleaseHeldWrite,shouldReloadAfterTakeover}from"../chunk-YYD257TD.js";import"../chunk-RE4LP46F.js";import"../chunk-EUFDQ4KL.js";import"../chunk-KXM6YRG2.js";

package/dist/fields/fields.css

@@ -129,46 +129,12 @@ span:has(> .es-fnum) { display: flex; min-width: 0; }
 .es-list-row-main { flex: 1 1 auto; min-width: 0; min-height: 32px; display: flex; align-items: center; font-size: var(--text-xs, 12px); color: var(--es-text); }
 .es-list-row-main > * { flex: 1 1 auto; min-width: 0; }
 
-/* A many-field item: its name, its summary, a chevron that turns when open. */
-.es-list-open {
-  flex: 1 1 auto;
-  min-width: 0;
-  display: flex;
-  align-items: center;
-  gap: 4px;
-  height: 32px;
-  padding: 0;
-  border: 0;
-  background: none;
-  color: var(--es-text);
-  font: inherit;
-  font-size: var(--text-xs, 12px);
-  text-align: left;
-  cursor: inherit;
-}
-.es-list-open:focus-visible { outline: 2px solid var(--es-accent); outline-offset: 1px; border-radius: var(--radius-sm); }
-.es-list-thumb { flex: none; display: inline-flex; align-items: center; }
-.es-list-row-name { flex: none; font-weight: 600; white-space: nowrap; }
-.es-list-row-summary { flex: 1 1 auto; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; color: var(--es-muted); }
-.es-list-chev { flex: none; color: var(--es-icon); transition: transform 0.12s; }
-.es-list-row.is-open .es-list-chev { transform: rotate(90deg); }
-
-.es-list-x {
-  flex: none;
-  width: 28px;
-  height: 32px;
-  border: 0;
-  border-radius: var(--es-row-radius);
-  background: transparent;
-  color: var(--es-muted);
-  font: inherit;
-  font-size: var(--text-base, 16px);
-  line-height: 1;
-  cursor: pointer;
-}
-.es-list-x:hover:not(:disabled) { background: var(--es-danger-tint); color: var(--es-danger); }
-.es-list-x:disabled { color: var(--es-disabled); cursor: default; }
-.es-list-x:focus-visible { outline: 2px solid var(--es-accent); outline-offset: 2px; }
+/* A many-field item: the shell's fold button (`ListRow` `title` / `onToggle`)
+   holds its name and, after it, its summary — quiet beside the bold name. */
+.es-list-row-name,
+.es-list-row-summary { font-size: var(--text-xs, 12px); }
+.es-list-row-summary { margin-left: var(--es-space-4, 4px); font-weight: 400; color: var(--es-muted); }
+
 .es-list-lock {
   flex: none;
   width: 28px;

package/dist/fields/index.d.ts

@@ -433,11 +433,6 @@ declare function insertAt<T>(items: readonly T[], index: number, item: T): T[];
 declare function moveTo<T>(items: readonly T[], from: number, to: number): T[];
 /** The list without the item at `index`. */
 declare function removeAt<T>(items: readonly T[], index: number): T[];
-/**
- * A copy of an item: a deep copy of plain data, so editing the copy never
- * writes through to the original (a list item is JSON — the old library stored it so).
- */
-declare function copyItem<T>(item: T): T;
 declare function ListField<T>({ label, icon, noun: ownNoun, items, onChange, newItem, summary, itemName, thumb, min, max, readOnly, open, onOpen, renderItem, renderRow, canRemove: removable, lockedReason, fixed, removeOnRow, canDuplicate, above, head, }: ListFieldProps<T>): react.JSX.Element;
 
 /**
@@ -552,4 +547,4 @@ declare function optionFor<V>(options: readonly FieldOption<V>[], value: V | und
 declare function FieldSelect<V>(props: FieldSelectManyProps<V>): ReactNode;
 declare function FieldSelect<V>(props: FieldSelectOneProps<V>): ReactNode;
 
-export { FieldNumber, FieldNumberProps, FieldOption, type FieldPlan, FieldRenderer, FieldSelect, FieldSelectManyProps, FieldSelectOneProps, FieldSlider, FieldSliderProps, FieldText, FieldTextProps, type FieldsBlock, Inspector, InspectorField, InspectorFieldDef, type InspectorFieldProps, InspectorFields, type InspectorProps, ListField, type ListFieldProps, type PlannedFold, type PlannedRow, type ResolvedFieldsInput, SettingsBucket, type ShowWhenInput, bucketsOf, copyItem, fieldIsShown, fieldShownInView, insertAt, labelOf, moveTo, optionFor, planFields, removeAt, shownFields, useResolvedFields };
+export { FieldNumber, FieldNumberProps, FieldOption, type FieldPlan, FieldRenderer, FieldSelect, FieldSelectManyProps, FieldSelectOneProps, FieldSlider, FieldSliderProps, FieldText, FieldTextProps, type FieldsBlock, Inspector, InspectorField, InspectorFieldDef, type InspectorFieldProps, InspectorFields, type InspectorProps, ListField, type ListFieldProps, type PlannedFold, type PlannedRow, type ResolvedFieldsInput, SettingsBucket, type ShowWhenInput, bucketsOf, fieldIsShown, fieldShownInView, insertAt, labelOf, moveTo, optionFor, planFields, removeAt, shownFields, useResolvedFields };

package/dist/fields/index.js

@@ -1 +1 @@
-export{FieldText,Inspector,InspectorField,LinkPicker,ListField,bucketsOf,copyItem,fieldShownInView,insertAt,labelOf,moveTo,planFields,removeAt}from"../chunk-H4Z2V56N.js";export{fieldIsShown,showWhenOf,shownFields,withShowWhen}from"../chunk-BPXEFVSQ.js";import"../chunk-YCSZAP7T.js";import"../chunk-WHS6Y55E.js";import"../chunk-K56YDHYQ.js";export{FieldSlider}from"../chunk-ZEH6QLBH.js";export{useResolvedFields}from"../chunk-AGWKB77Q.js";import"../chunk-FIVU2COQ.js";import"../chunk-FM6JO4WF.js";import"../chunk-KFV7N2DJ.js";export{FieldNumber}from"../chunk-Y2T3JX7K.js";export{FieldSelect,optionFor}from"../chunk-KFWNGPW3.js";import"../chunk-JACEEVVF.js";import"../chunk-CZAAGBVL.js";import"../chunk-MFIRYGHW.js";import"../chunk-6NJHYXJM.js";import"../chunk-P2VEMZH5.js";import"../chunk-TGZCD6IP.js";import"../chunk-KXM6YRG2.js";
+export{FieldText,Inspector,InspectorField,LinkPicker,ListField,bucketsOf,fieldShownInView,insertAt,labelOf,moveTo,planFields,removeAt}from"../chunk-U3LTJSBU.js";export{fieldIsShown,showWhenOf,shownFields,withShowWhen}from"../chunk-BPXEFVSQ.js";import"../chunk-YCSZAP7T.js";export{FieldSlider}from"../chunk-ZEH6QLBH.js";import"../chunk-WHS6Y55E.js";import"../chunk-FM6JO4WF.js";import"../chunk-K56YDHYQ.js";import"../chunk-KFV7N2DJ.js";export{useResolvedFields}from"../chunk-K53PQAMP.js";import"../chunk-FIVU2COQ.js";export{FieldNumber}from"../chunk-Y2T3JX7K.js";export{FieldSelect,optionFor}from"../chunk-KFWNGPW3.js";import"../chunk-MIX7EGRG.js";import"../chunk-DX3VILZ3.js";import"../chunk-JACEEVVF.js";import"../chunk-MFIRYGHW.js";import"../chunk-3XECMGXX.js";import"../chunk-P2VEMZH5.js";import"../chunk-EUFDQ4KL.js";import"../chunk-KXM6YRG2.js";

package/dist/node-ops/index.js

@@ -1 +1 @@
-export{createNodeClipboard,nodeMenuItems}from"../chunk-P5VYGWYO.js";import"../chunk-WK3AFPXY.js";export{canStep,clickPick,clickPickPart,fromItemSelector,nextInChain,nodeChain,parentStep,planDuplicate,planMove,planPaste,planRemove,planRestore,planSetProps,planStep,planSwap,toItemSelector,useNodeOps}from"../chunk-RPMSET77.js";import"../chunk-TGZCD6IP.js";import"../chunk-KXM6YRG2.js";
+export{createNodeClipboard,nodeMenuItems}from"../chunk-P5VYGWYO.js";import"../chunk-WK3AFPXY.js";export{canStep,clickPick,clickPickPart,fromItemSelector,nextInChain,nodeChain,parentStep,planDuplicate,planMove,planPaste,planRemove,planRestore,planSetProps,planStep,planSwap,toItemSelector,useNodeOps}from"../chunk-QTHQPJWA.js";import"../chunk-EUFDQ4KL.js";import"../chunk-KXM6YRG2.js";