efficient-easel 0.103.0 → 0.104.0

package/dist/screen/lib/media-panel.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ComponentType, ReactNode } from 'react';
-import { H as HostPickedMedia } from '../../host-DJ8Gzsx7.js';
+import { H as HostPickedMedia, E as EaselHost } from '../../host-DJ8Gzsx7.js';
 import '../../blocks/index.js';
 import '../../types-E3HrTPg2.js';
 import '../../data/index.js';
@@ -9,6 +9,8 @@ import '../../resolve-D68pb3Bx.js';
 import '../../plan-DChbUXdS.js';
 import './document-contract.js';
 import './session.js';
+import './backend-error.js';
+import '../../edit-lock/index.js';
 import './host-chrome.js';
 import './links/link-filters.js';
 import '../../LinkPicker-W2Rtxetz.js';
@@ -17,7 +19,6 @@ import './section-template-types.js';
 import './puck/content-tree.js';
 import './document-switch.js';
 import '../../engine-DBxp_v6B.js';
-import '../../edit-lock/index.js';
 import './admin-bridge.js';
 
 /**
@@ -40,13 +41,23 @@ import './admin-bridge.js';
  *   • BROWSING — the rail opens the "media" left view. The host's panel shows
  *     the library to look through, upload to, tidy. `pick` is null.
  *   • PICKING — a field calls `requestMediaPick` (lib/media-picker). With
- *     a panel here, that becomes {@link requestPanelPick}: the chrome lays the
- *     panel over the left panel in pick mode, the host's panel calls `onPick`,
- *     and the field gets the media. Leaving pick mode any other way (the
- *     panel's Cancel, a rail button, closing the panel) settles it `null`.
+ *     a panel here, that becomes a request to THIS provider's pick store: the
+ *     chrome lays the panel over the left panel in pick mode, the host's panel
+ *     calls `onPick`, and the field gets the media. Leaving pick mode any other
+ *     way (the panel's Cancel, a rail button, closing the panel) settles it
+ *     `null`.
  *
- * Module state for the same reason as lib/media-picker: the fields that
- * ask are Puck custom fields, which no prop reaches.
+ * ONE PENDING PICK PER PROVIDER (0.103.0). Until then the pending pick was
+ * module state, one for the page — right while one editor is mounted, and
+ * wrong the moment two are (the admin's website editor and campaign designer):
+ * a field in one laid the other's panel over its own left panel too, and a
+ * Cancel in either settled the other's field. Each provider now keeps its own
+ * {@link MediaPickStore}; the chrome under it reads that one, and a field's
+ * request finds it by the HOST the field asks through (`requestMediaPick(host,
+ * …)` — one host per mounted editor, lib/host), so no prop or context has to
+ * reach the field's click handler. A request whose host no provider sits under
+ * goes to the provider mounted last, which is exactly what the module state
+ * answered, so one mounted editor behaves as it always did.
  */
 /** What a field asked the panel for. `file` is a file dropped straight on the
  *  field: the host uploads it and picks it without waiting for a click. */
@@ -57,6 +68,14 @@ interface MediaPickRequest {
     /** The field's label, e.g. "Background image". */
     title: string;
     file?: File | null;
+    /**
+     * The field's own terms for its host's panel (0.103.0), handed to it
+     * untouched — the campaign designer's logo field asks for `{ bakeableOnly:
+     * true }`. The screen reads none of it. Absent when the field gave none;
+     * the window's `open-media-picker` message never carries it (its shape is
+     * the website's protocol).
+     */
+    options?: Record<string, unknown>;
 }
 /** The props the host's panel component is drawn with. */
 interface MediaPanelProps {
@@ -67,28 +86,73 @@ interface MediaPanelProps {
 }
 /** The host's media library, as a component the editor draws in its panel. */
 type MediaPanelComponent = ComponentType<MediaPanelProps>;
+/**
+ * One editor's pending pick (0.103.0): what its panel is choosing for, and who
+ * waits on the answer. A {@link MediaPanelProvider} makes one for itself.
+ */
+interface MediaPickStore {
+    /** The field the panel is choosing for, or null while nothing is. */
+    current(): MediaPickRequest | null;
+    /**
+     * Open pick mode for one field; resolves with the media chosen, or null. A
+     * second field asking before the first is answered takes the panel over,
+     * and the first resolves null — one panel answers one field.
+     */
+    request(request: MediaPickRequest): Promise<HostPickedMedia | null>;
+    /** Answer the field the panel is choosing for (`media` null: no choice). A
+     *  stale id — an answer for a request already superseded — does nothing. */
+    settle(requestId: string, media: HostPickedMedia | null): void;
+    /** Leave pick mode without a choice, whatever is being chosen. */
+    cancel(): void;
+    subscribe(listener: () => void): () => void;
+}
+declare function createMediaPickStore(): MediaPickStore;
 /** Supply the host's panel to the editor below. `panel` null keeps the old
- *  window: fields ask the host with `open-media-picker`. */
+ *  window: fields ask the host with `open-media-picker`. Sit it under the
+ *  editor's `EaselHostProvider`, as the website's frame does: that host is
+ *  how a field's request finds this provider among several. */
 declare function MediaPanelProvider({ panel, children }: {
     panel: MediaPanelComponent | null;
     children: ReactNode;
 }): react.JSX.Element;
 /** The host's panel for the editor this renders in, or null. */
 declare function useMediaPanel(): MediaPanelComponent | null;
-/** Whether a field's request goes to the panel rather than to the host. */
+/**
+ * The pick store a field's request through `host` goes to, or null when that
+ * editor has no panel and the host is asked with the window's message: the
+ * provider under that host (the last one, if two share it), else the page's
+ * provider, as the one module-wide store answered before 0.103.0.
+ */
+declare function mediaPickStoreFor(host: EaselHost): MediaPickStore | null;
+/** Whether a field's request goes to the panel rather than to the host — of
+ *  the page's provider, the one mounted last. */
 declare function hasMediaPanel(): boolean;
 /**
- * Open the panel in pick mode for one field; resolves with the media chosen, or
- * null. A second field asking before the first is answered takes the panel over,
- * and the first resolves null — one panel answers one field.
+ * Open the page's panel (the provider mounted last) in pick mode for one
+ * field; resolves with the media chosen, or null. A field asks through
+ * `requestMediaPick`, which finds the panel of ITS editor instead.
  */
 declare function requestPanelPick(request: MediaPickRequest): Promise<HostPickedMedia | null>;
-/** Answer the field the panel is choosing for (`media` null: no choice). A
+/** Answer the field a panel is choosing for (`media` null: no choice), in
+ *  whichever editor asked: a request id names one field of one editor. A
  *  stale id — an answer for a request already superseded — does nothing. */
 declare function settlePanelPick(requestId: string, media: HostPickedMedia | null): void;
-/** Leave pick mode without a choice, whatever is being chosen. */
+/** Leave the page's pick mode without a choice, whatever is being chosen.
+ *  Under a provider, `useCancelPanelPick` leaves that editor's. */
 declare function cancelPanelPick(): void;
-/** The field the panel is choosing for, or null while nothing is. */
+/** The field the panel is choosing for, or null while nothing is — in the
+ *  editor this renders in. */
 declare function usePanelPick(): MediaPickRequest | null;
+/** Leave THIS editor's pick mode without a choice (0.103.0): a stable
+ *  function, for the chrome's Escape, rail and panel-closed paths. */
+declare function useCancelPanelPick(): () => void;
+/**
+ * A change of selection leaves pick mode (0.103.0, `ScreenParts
+ * .pickFollowsSelection`): with `follows`, the field still waiting when
+ * `selection` moves is settled with null, as a Cancel would — the field that
+ * asked belongs to the block that is no longer selected. Without it, nothing:
+ * a pick outlives a selection, as it always has.
+ */
+declare function usePickFollowsSelection(follows: boolean, selection: unknown): void;
 
-export { type MediaPanelComponent, type MediaPanelProps, MediaPanelProvider, type MediaPickRequest, cancelPanelPick, hasMediaPanel, requestPanelPick, settlePanelPick, useMediaPanel, usePanelPick };
+export { type MediaPanelComponent, type MediaPanelProps, MediaPanelProvider, type MediaPickRequest, type MediaPickStore, cancelPanelPick, createMediaPickStore, hasMediaPanel, mediaPickStoreFor, requestPanelPick, settlePanelPick, useCancelPanelPick, useMediaPanel, usePanelPick, usePickFollowsSelection };

package/dist/screen/lib/media-panel.js

@@ -1 +1 @@
-export{MediaPanelProvider,cancelPanelPick,hasMediaPanel,requestPanelPick,settlePanelPick,useMediaPanel,usePanelPick}from"../../chunk-ZZ7VLIHQ.js";
+export{MediaPanelProvider,cancelPanelPick,createMediaPickStore,hasMediaPanel,mediaPickStoreFor,requestPanelPick,settlePanelPick,useCancelPanelPick,useMediaPanel,usePanelPick,usePickFollowsSelection}from"../../chunk-Z6BAZFSW.js";import"../../chunk-R5ZVNJLJ.js";

package/dist/screen/lib/media-picker.d.ts

@@ -8,6 +8,8 @@ import '../../resolve-D68pb3Bx.js';
 import '../../plan-DChbUXdS.js';
 import './document-contract.js';
 import './session.js';
+import './backend-error.js';
+import '../../edit-lock/index.js';
 import './host-chrome.js';
 import './links/link-filters.js';
 import '../../LinkPicker-W2Rtxetz.js';
@@ -16,7 +18,6 @@ import './section-template-types.js';
 import './puck/content-tree.js';
 import './document-switch.js';
 import '../../engine-DBxp_v6B.js';
-import '../../edit-lock/index.js';
 import './admin-bridge.js';
 
 /**
@@ -28,6 +29,10 @@ import './admin-bridge.js';
  *   • A host that supplies a MEDIA PANEL (lib/media-panel — the admin
  *     portal, from efficient-web 0.2.0) answers in the editor's own left panel:
  *     the request opens that panel in pick mode, and nothing leaves the editor.
+ *     The panel is the one of the editor the field asks through: `host` is
+ *     that editor's (one per mounted editor), and the provider under it keeps
+ *     its own pending pick (0.103.0), so two editors mounted in one page never
+ *     answer each other's fields.
  *   • Any other host is asked to open its picker window, over the
  *     request/response protocol below. The picker UI lives in the host, so
  *     this module owns the EDITOR half:
@@ -54,11 +59,18 @@ interface PickedMedia {
  * Choose media for a slot; resolves with the chosen media, or null if the user
  * cancelled (or there's no host to ask). `file` is a file dropped straight on
  * the slot — the host uploads it and picks it immediately.
+ *
+ * `options` (0.103.0) are the field's own terms for its host's PANEL, handed to
+ * it untouched on the request (`MediaPickRequest.options`) — the campaign
+ * designer's logo field asks for `{ bakeableOnly: true }`. The window's
+ * `open-media-picker` message carries none: its shape is the website's
+ * protocol, mirrored by the storefront.
  */
 declare function requestMediaPick(host: EaselHost, opts: {
     accept: string;
     title: string;
     file?: File | null;
+    options?: Record<string, unknown>;
 }): Promise<PickedMedia | null>;
 /** Settle a pending pick (called by the central message listener on the admin's
  *  reply). Unknown ids — a stale reply, or a pick meant for another editor

package/dist/screen/lib/media-picker.js

@@ -1 +1 @@
-export{requestMediaPick,resolveMediaPick}from"../../chunk-6FY3PZS3.js";import"../../chunk-ZZ7VLIHQ.js";
+export{requestMediaPick,resolveMediaPick}from"../../chunk-UB7JVPK4.js";import"../../chunk-Z6BAZFSW.js";import"../../chunk-R5ZVNJLJ.js";

package/dist/screen/lib/page-lock.d.ts

@@ -1,5 +1,49 @@
 import { EditLock } from '../../edit-lock/index.js';
+import { EaselSession } from './session.js';
+import '../../blocks/index.js';
+import 'react';
+import '../../types-E3HrTPg2.js';
+import '../../data/index.js';
+import '../../types-41704JE4.js';
+import '../../resolve-D68pb3Bx.js';
+import '../../plan-DChbUXdS.js';
+import './backend-error.js';
+import './host-chrome.js';
+import './links/link-filters.js';
+import '../../LinkPicker-W2Rtxetz.js';
+import './document-contract.js';
+import './document-hooks.js';
+import './section-template-types.js';
+import './puck/content-tree.js';
+
+/**
+ * The storefront editor's binding of the SHARED edit lock.
+ *
+ * The rules themselves — who may write the open document, what a failed claim /
+ * take-over / heartbeat means, how to read a refused save, and the claim driver
+ * that keeps a held write from being lost — live in `efficient-easel/edit-lock` and
+ * are imported straight from there by the code that needs them. This file used
+ * to be a 334-line copy of them; the campaign designer in efficient-admin-portal
+ * carried a second, drifted copy of the same rules. Card 11161 merged the two
+ * into the shared package, and this is all that is left here: the TWO facts that
+ * are genuinely this repo's.
+ *
+ *   1. what a failure looks like HERE (lib/failure: this repo's
+ *      `ApiError`, or the editor backend's `WebsiteBackendError`), and
+ *   2. the `code` this backend puts in a refused-save body for a PAGE.
+ *
+ * Nothing else belongs in this file. A rule a second editor would also need goes
+ * in the shared module, or the copy starts growing back.
+ */
 
 declare const pageEditLock: EditLock;
+/**
+ * The lock's rules for one editor's session (0.103.0): {@link pageEditLock}
+ * itself for a session that reads its host's errors as the page does — every
+ * session before 0.103.0, and the website's still — and, for a session that
+ * brought its own reading (`hostFailures`), the same rules reading a failure
+ * that session's way. Made once per session.
+ */
+declare function editLockOf(session: EaselSession): EditLock;
 
-export { pageEditLock };
+export { editLockOf, pageEditLock };

package/dist/screen/lib/page-lock.js

@@ -1 +1 @@
-export{pageEditLock}from"../../chunk-AKZWUV5Z.js";import"../../chunk-HMX55DYT.js";import"../../chunk-KDYIMJTZ.js";import"../../chunk-JUQ6YJCG.js";import"../../chunk-RE4LP46F.js";
+export{editLockOf,pageEditLock}from"../../chunk-ZOJEFIP4.js";import"../../chunk-4EUWOGZF.js";import"../../chunk-KCOBHPN6.js";import"../../chunk-JUQ6YJCG.js";import"../../chunk-RE4LP46F.js";

package/dist/screen/lib/puck/content-tree.d.ts

@@ -27,6 +27,25 @@ type SlotConfigView = {
  * not know has no slots — and cannot render either, so there is nothing to walk.
  */
 declare function slotFieldsOf(config: SlotConfigView, type: string): string[];
+/**
+ * What a component type's config ALLOWS of the two actions that make another
+ * node or take one away (0.103.0): its `permissions.duplicate` and
+ * `permissions.delete`, each true unless the config says false — the reading
+ * Puck gave a config that carried none. The campaign designer's Product keeps
+ * its Price line this way (`{ delete: false, duplicate: false }`).
+ *
+ * The screen's tree rows, its menu and the inspector head it hands this to
+ * (`ScreenInspectorPanelProps.nodeActions`) all ask HERE, so the three cannot
+ * come to disagree about one block. Only the config's own, never the
+ * easel-wide permissions the edit lock sets: a document somebody else holds is
+ * refused at the writes, as it always was, and draws the rows it drew.
+ *
+ * A type the config does not know allows both, as one with no `permissions`.
+ */
+declare function blockNodeActions(config: SlotConfigView, type: string): {
+    duplicate: boolean;
+    delete: boolean;
+};
 /**
  * A slot child, addressed the way the Layers tree selects it: the node, the
  * compound zone key "<parentId>:<slotName>" Puck's ops take, and its index in
@@ -193,4 +212,4 @@ declare function missingPinnedTypes(live: ReadonlyArray<{
     type?: string;
 }>): string[];
 
-export { FOOTER_TYPE, HEADER_TYPE, type NodeLocation, ROOT_ZONE, type SlotChild, type SlotConfigView, TREE_MAX_DEPTH, type TreeItem, childSlotsOf, locateNode, missingPinnedTypes, nestsInTree, newNodeId, pinnedDuplicateIds, pinnedDuplicateIndices, slotFieldsOf };
+export { FOOTER_TYPE, HEADER_TYPE, type NodeLocation, ROOT_ZONE, type SlotChild, type SlotConfigView, TREE_MAX_DEPTH, type TreeItem, blockNodeActions, childSlotsOf, locateNode, missingPinnedTypes, nestsInTree, newNodeId, pinnedDuplicateIds, pinnedDuplicateIndices, slotFieldsOf };

package/dist/screen/lib/puck/content-tree.js

@@ -1 +1 @@
-export{FOOTER_TYPE,HEADER_TYPE,ROOT_ZONE,TREE_MAX_DEPTH,childSlotsOf,locateNode,missingPinnedTypes,nestsInTree,newNodeId,pinnedDuplicateIds,pinnedDuplicateIndices,slotFieldsOf}from"../../../chunk-FUDHI5I4.js";
+export{FOOTER_TYPE,HEADER_TYPE,ROOT_ZONE,TREE_MAX_DEPTH,blockNodeActions,childSlotsOf,locateNode,missingPinnedTypes,nestsInTree,newNodeId,pinnedDuplicateIds,pinnedDuplicateIndices,slotFieldsOf}from"../../../chunk-7GVLSNFW.js";

package/dist/screen/lib/puck/section-doc.js

@@ -1 +1 @@
-export{cloneNodeWithFreshIds,docToNode,nodeToDoc}from"../../../chunk-AKFJK65Z.js";import"../../../chunk-FUDHI5I4.js";
+export{cloneNodeWithFreshIds,docToNode,nodeToDoc}from"../../../chunk-R2MUSGPS.js";import"../../../chunk-7GVLSNFW.js";

package/dist/screen/lib/puck/slot-child-name.d.ts

@@ -126,7 +126,19 @@ declare function slotChildName(child: SlotChild, wheelName?: (code: string) => s
  * needs at least one character between a pair, so a name that is non-empty
  * cannot strip to nothing and be renamed into its component's label.
  */
-declare function slotChildRowName(child: SlotChild, compLabel: (type: string) => string, plainText: (copy: string) => string, wheelName?: (code: string) => string | undefined): string;
+declare function slotChildRowName<N extends SlotChild>(child: N, compLabel: (type: string) => string, plainText: (copy: string) => string, wheelName?: (code: string) => string | undefined, rowName?: RowNameRule<N>): string;
+/**
+ * THE LAYER'S LAST WORD (0.103.0) — `ScreenBlockLook.rowName`
+ * (lib/screen-parts), the rung a layer may stand above the whole precedence:
+ * handed the node, the level it is named at and what the rule here answered,
+ * it answers the row's name. The campaign designer names its rows by its own
+ * labels, and needs none of the website's rungs.
+ *
+ * An argument and not a rung written here, for the reason the grammar and the
+ * catalog are: this module has no layer. Absent, the rule here is the name, as
+ * it was before the member existed.
+ */
+type RowNameRule<N extends SlotChild = SlotChild> = (node: N, level: "section" | "block", fallback: string) => string;
 /**
  * WHICH PROP A RENAME WRITES — the write side of the rule above, and here for
  * the reason the read side is: naming a slot child has ONE home (card 66194).
@@ -180,7 +192,10 @@ declare function slotChildRenameProp(fields: Record<string, unknown> | undefined
  *
  * `fallback` is the caller's type-level label (`sectionLabel(type)`), which is
  * what every published page reads today and what an unnamed node keeps reading.
+ *
+ * `rowName` is the layer's last word ({@link RowNameRule}), asked at the
+ * SECTION level with what this rung answered.
  */
-declare function rootRowName(node: SlotChild, fallback: string): string;
+declare function rootRowName<N extends SlotChild>(node: N, fallback: string, rowName?: RowNameRule<N>): string;
 
-export { type SlotChild, rootRowName, slotChildName, slotChildRenameProp, slotChildRowName };
+export { type RowNameRule, type SlotChild, rootRowName, slotChildName, slotChildRenameProp, slotChildRowName };

package/dist/screen/lib/puck/slot-child-name.js

@@ -1 +1 @@
-export{rootRowName,slotChildName,slotChildRenameProp,slotChildRowName}from"../../../chunk-HWW4XJOH.js";import"../../../chunk-DUVRZ456.js";import"../../../chunk-6W7WLPZH.js";
+export{rootRowName,slotChildName,slotChildRenameProp,slotChildRowName}from"../../../chunk-QOPY2LQM.js";import"../../../chunk-DUVRZ456.js";import"../../../chunk-6W7WLPZH.js";

package/dist/screen/lib/puck/use-section-ops.d.ts

@@ -80,6 +80,12 @@ type SectionOpsOptions = {
      * un-fix that card.
      */
     readOnly?: boolean;
+    /**
+     * Resolve each node an op puts in (`easel.resolveNode`, trigger `"insert"`).
+     * Default: the layer's rule (`ScreenBlockRules.resolveOnInsert`), else
+     * false — no op resolves anything, as before 0.103.0.
+     */
+    resolveOnInsert?: boolean;
 };
 declare function useSectionOps(options?: SectionOpsOptions): SectionOps;
 

package/dist/screen/lib/puck/use-section-ops.js

@@ -1 +1 @@
-export{useSectionOps}from"../../../chunk-VV5ADNBR.js";import"../../../chunk-FUDHI5I4.js";import"../../../chunk-P67FP7PG.js";import"../../../chunk-AELNNAFM.js";import"../../../chunk-YRLPFZW3.js";import"../../../chunk-D2BCHTQR.js";import"../../../chunk-MFIRYGHW.js";import"../../../chunk-ZNCEOSXO.js";import"../../../chunk-KRXQM65X.js";import"../../../chunk-NKB3KVAB.js";
+export{useSectionOps}from"../../../chunk-A2LFBOUF.js";import"../../../chunk-7GVLSNFW.js";import"../../../chunk-7755VWRT.js";import"../../../chunk-Z6BAZFSW.js";import"../../../chunk-R5ZVNJLJ.js";import"../../../chunk-P67FP7PG.js";import"../../../chunk-AELNNAFM.js";import"../../../chunk-BXZ6WLHC.js";import"../../../chunk-EOJNJCMJ.js";import"../../../chunk-ZFDCDJNZ.js";import"../../../chunk-ZNS7727Y.js";import"../../../chunk-3EDSDPIP.js";import"../../../chunk-QTLAVDJE.js";import"../../../chunk-YRLPFZW3.js";import"../../../chunk-KTVH2ZRL.js";import"../../../chunk-D2BCHTQR.js";import"../../../chunk-EWVJSRRY.js";import"../../../chunk-P6O363EE.js";import"../../../chunk-FPOKPNO4.js";import"../../../chunk-MFIRYGHW.js";import"../../../chunk-BZ5ASXOL.js";import"../../../chunk-67GNT6PF.js";import"../../../chunk-ZNCEOSXO.js";import"../../../chunk-L5KW4HG5.js";import"../../../chunk-KRXQM65X.js";import"../../../chunk-NKB3KVAB.js";

package/dist/screen/lib/screen-parts.d.ts

@@ -3,6 +3,7 @@ import { ReactNode, MouseEvent, ComponentType } from 'react';
 import { Data } from '../../blocks/index.js';
 import { D as DeviceOption } from '../../types-CqY85foL.js';
 import { a as EaselRailItem } from '../../types-DWS-s9z-.js';
+import { T as TreeRowMark } from '../../types-DJDBtdB2.js';
 import { HostProduct } from './host-chrome.js';
 import { EaselSession } from './session.js';
 import { AddTarget } from './puck/add-target-types.js';
@@ -14,8 +15,10 @@ import '../../plan-DChbUXdS.js';
 import '../../edit-lock/index.js';
 import '../../panelWidths-D9hTLR25.js';
 import '../../wordFit-D4S36PvB.js';
+import '../../words-DgHcY5qB.js';
 import './links/link-filters.js';
 import '../../LinkPicker-W2Rtxetz.js';
+import './backend-error.js';
 import './document-contract.js';
 import './document-hooks.js';
 import './section-template-types.js';
@@ -143,6 +146,23 @@ interface ScreenInspectorPanelProps {
     /** Hide the panel: the last button of its head. Omitted by a screen whose
      *  inspector is always in view. */
     onHidePanel?: () => void;
+    /**
+     * Which of the head's two node actions the selected node's BLOCK allows
+     * (0.103.0): its config's `permissions.duplicate` and `permissions.delete`,
+     * each true unless the config says false — the answer the screen's own tree
+     * rows and menu honour, handed on so the head the layer draws honours it
+     * too, hiding or greying a refused one. With nothing selected both are true.
+     * Handed by the page screen; a layer that never reads it draws its head as
+     * it did.
+     */
+    nodeActions?: ScreenNodeActions;
+}
+/** What a block's config allows of the two actions that make another node or
+ *  take one away (`ComponentConfig.permissions`): `false` only where the config
+ *  says so (lib/puck/content-tree `blockNodeActions`). */
+interface ScreenNodeActions {
+    duplicate: boolean;
+    delete: boolean;
 }
 /**
  * The document and its tree of rows, as far as a layer needs them to wire and
@@ -450,6 +470,17 @@ interface ScreenBlockRules {
      * no host chose its blocks, every type is.
      */
     blockIsOffered: (type: string, session?: EaselSession) => boolean;
+    /**
+     * Is a new block RESOLVED as it goes in (0.103.0)? With true, every insert
+     * the screen makes — a section, a block into a slot, a saved template, a
+     * seeded slot child — is followed by `easel.resolveNode(id, { trigger:
+     * 'insert' })`, as the campaign designer's own inserts are: the block's
+     * `resolveData` runs the moment it arrives (seeding its children, stamping a
+     * default), in the insert's own undo step, not at its first edit or the next
+     * time the document opens. Absent, false: an insert runs no resolver, as
+     * the website's never has.
+     */
+    resolveOnInsert?: boolean;
 }
 /** The tier a node is NAMED at: a node at the top of the document is a section,
  *  a node inside another is a block. */
@@ -516,6 +547,41 @@ interface ScreenBlockLook {
      * the screen read the products itself, so its effect keeps its place.
      */
     useProducts: () => readonly HostProduct[] | null;
+    /**
+     * THE LAYER'S LAST WORD ON WHAT A LAYERS ROW SAYS (0.103.0): handed a node,
+     * the level it is named at and `fallback` — what the screen's own naming
+     * rule answered (lib/puck/slot-child-name: a name the node carries, else its
+     * type's label; a pinned row's word) — it answers the row's name. Asked of
+     * every node row the page screen's Layers tree draws, and of the menu's
+     * Select layer flyout, a block's canvas handle and a section's own list of
+     * its children in the inspector, which say the same words. The campaign
+     * designer's rows read its own labels ("Section 2", "Header"). Absent: the
+     * screen's rule, as it named every row.
+     */
+    rowName?: (node: ScreenNode, level: ScreenNodeLevel, fallback: string) => string;
+    /**
+     * The quieter words a node row draws after its name (`TreeRow`'s
+     * `preview`): a node's own first words, so a tree of rows all called
+     * "Section" can be told apart by eye. The layer chooses and shortens them;
+     * nothing (null, undefined, "") draws nothing. Absent: no row has any.
+     */
+    rowPreview?: (node: ScreenNode) => string | null | undefined;
+    /**
+     * The small marks a node row draws right after its name (`TreeRow`'s
+     * `marks`): a state the row only SHOWS, such as "Shown on phones only".
+     * Absent, or nothing handed back: no marks.
+     */
+    rowMarks?: (node: ScreenNode) => ReadonlyArray<TreeRowMark> | null | undefined;
+    /**
+     * The layer's own buttons on a node row, by the node and where it sits:
+     * `TreeRowAction`s (efficient-easel/tree), placed between the screen's trash
+     * and its eye — the campaign designer's phone switch. Asked of every node
+     * row, a locked one and a pinned one too, so the layer decides; what comes
+     * back is placed as it is, and nothing draws nothing. A button that writes
+     * renders a component of the layer's that reaches the document itself.
+     * Absent: the screen's two, as it drew them.
+     */
+    rowActions?: (node: ScreenNode, zone: string, index: number) => ReactNode;
 }
 /**
  * THE DEVICES the canvas can be looked at on. That the top bar has a switch,
@@ -566,9 +632,15 @@ interface ScreenDevices {
  * selected and where a pinned node's row is pressed, and shows what it is
  * handed.
  *
- * The same object for the life of a mount, its three functions plain functions
- * of what they are passed: the screen reads it anywhere, inside the callbacks
- * and effects it does not rebuild for it.
+ * And HOW THE LAYERS TREE FRAMES THEM (0.103.0): which node is pinned where it
+ * is not one type (`isFirst`, `isLast` — the campaign designer's Header and
+ * Footer are both sections, told apart by a prop), how the first one's row is
+ * drawn (`firstRow`) and what the band of sections between them looks like
+ * (`band`). Each is optional, and its default is the tree the website has.
+ *
+ * The same object for the life of a mount, its functions plain functions of
+ * what they are passed: the screen reads it anywhere, inside the callbacks and
+ * effects it does not rebuild for it.
  */
 interface ScreenPinnedNodes {
     /** The type of the node pinned FIRST: the band starts after it. Null when
@@ -576,6 +648,32 @@ interface ScreenPinnedNodes {
     first: string | null;
     /** The type of the node pinned LAST: the band ends at it. */
     last: string | null;
+    /**
+     * Is this top-level node the one pinned first (0.103.0)? Where every node
+     * of the pinned type is not pinned — the campaign designer's Header is an
+     * `EmailSection` with `_region: "header"`, beside body sections of the same
+     * type — the layer says which. The page screen asks it wherever it tested
+     * a node against `first`: the band, the tree, the canvas handles, the menu.
+     * (The section screen, which holds one node, still asks the type.) The
+     * first node that answers yes is the one. Absent: a node of type `first`.
+     */
+    isFirst?: (node: ScreenNode) => boolean;
+    /** …and the one pinned last (the Footer). Absent: a node of type `last`. */
+    isLast?: (node: ScreenNode) => boolean;
+    /**
+     * How the Layers tree draws the node pinned first (0.103.0). `"panel"`: a
+     * row of its own that opens the layer's panel for it (`panelOf`), drawn
+     * whether or not the document holds the node, and none of its children —
+     * the website's Header, whose settings are a panel. `"node"`: the node
+     * itself, selected by its row and folding open into its children, exactly
+     * as the node pinned last is drawn — the campaign designer's Header, a
+     * section with blocks in it. Absent: `"panel"`.
+     */
+    firstRow?: "panel" | "node";
+    /** What the band of sections between the two pins looks like in the tree
+     *  (0.103.0). Absent: a group label in the screen's words, the sections at
+     *  the tree's own depth, and no row after them. */
+    band?: ScreenPinnedBand;
     /** The type of the group of sections pinned first, ahead of everything. */
     firstGroup: string | null;
     /** …and of the one pinned last. */
@@ -593,6 +691,31 @@ interface ScreenPinnedNodes {
      */
     panelOf: (type: string | null | undefined) => ScreenInspectorMode | null;
 }
+/**
+ * THE BAND, AS THE LAYERS TREE FRAMES IT (`ScreenPinnedNodes.band`, 0.103.0):
+ * the sections between the two pins. Where the band starts and ends is the
+ * screen's arithmetic either way; this is only how it is drawn.
+ */
+interface ScreenPinnedBand {
+    /** What the band is called. Absent: the screen's words, `screen.pageSections`
+     *  ("Template · Home page") on a document with the edit guard and
+     *  `screen.templateSections` ("Template · Template") on one without. */
+    label?: string;
+    /** The band is a ROW that folds, its sections under it — the campaign
+     *  designer's Body. Absent or false: a group label over the sections, which
+     *  sit at the tree's own depth. */
+    foldable?: boolean;
+    /** The band ends with an "Add section" row (`screen.addSection`) that opens
+     *  Add at the end of the band, where the band's last "+" does. Hidden while
+     *  the document is read-only, as every "+" is. Absent or false: the band ends
+     *  at its last gap. */
+    addAtEnd?: boolean;
+}
+/** Is `node` the one the layer pins FIRST — its own test (`isFirst`), else a
+ *  node of the `first` type, the test the screen has always made. */
+declare function isPinnedFirst(pinned: ScreenPinnedNodes, node: ScreenNode): boolean;
+/** …and LAST (`isLast`, else a node of the `last` type). */
+declare function isPinnedLast(pinned: ScreenPinnedNodes, node: ScreenNode): boolean;
 /**
  * THE VIEW THE LEFT PANEL IS ON, from one mount to the next. That the panel
  * has views, that one of them is current and that the choice is kept is the
@@ -622,6 +745,13 @@ interface ScreenParts {
      * reads it (components/MediaSidePanel), through `useScreenOwnerName`.
      */
     useOwnerName?: () => string;
+    /**
+     * The Layers head's context line — what the open document is, under the
+     * word "Layers" — as the hook the head calls (0.103.0). The campaign
+     * designer's names the campaign and its variant. Absent: the document's
+     * address, `/${slug}`, as the website's head has always said it.
+     */
+    useDocumentLabel?: () => string;
     /**
      * The layer's wiring between the inspector and what the layer draws in the
      * canvas, as ONE hook the screen calls where it used to hold that wiring: a
@@ -680,6 +810,15 @@ interface ScreenParts {
      * website has it.
      */
     saveSwitch?: boolean;
+    /**
+     * Does a field's media pick give way to a change of selection (0.103.0)? A
+     * field of the selected block asks the host's panel to choose (lib/
+     * media-panel); with true, selecting another block, or none, while it waits
+     * leaves pick mode and settles the field with null, as Cancel would — the
+     * campaign designer's picker belongs to the block it was opened for. Absent,
+     * false: a pick outlives a change of selection, as the website's does.
+     */
+    pickFollowsSelection?: boolean;
     /**
      * THE CANVAS the screen frames: the engine's, as the layer dresses it — the
      * layer's own sheet and theme in the frame, its own say over the outline
@@ -713,6 +852,9 @@ declare function useScreenParts(): ScreenParts;
 /** The layer's bridges, run in the screen. With no layer, nothing runs. */
 /** The name a panel's head gives what is being edited (`useOwnerName`). */
 declare function useScreenOwnerName(): string;
+/** The Layers head's context line (`useDocumentLabel`), or null with no
+ *  layer's, and the screen says the document's address. */
+declare function useScreenDocumentLabel(): string | null;
 declare function useScreenBridges(inspector: ScreenInspector, tree: ScreenTree, canvas: ScreenCanvas, left: ScreenLeftPanel): ScreenBridges;
 /** The layer's bridges for the screen that holds one node by itself. With no
  *  layer, nothing runs. */
@@ -738,6 +880,10 @@ declare function useScreenPinned(): ScreenPinnedNodes;
 /** Whether the save pill is the autosave's switch. With no layer, it is, as
  *  the screen has always drawn it. */
 declare function useScreenSaveSwitch(): boolean;
+/** Leave a field's pick when `selection` changes, if the layer says a pick
+ *  follows the selection (`pickFollowsSelection`). With no layer, a pick
+ *  outlives a change of selection, as it always has. */
+declare function useScreenPickFollowsSelection(selection: unknown): void;
 /** The canvas the layer dresses for the screen to frame. With no layer, the
  *  engine's plain one. */
 declare function useScreenCanvasFrame(): ComponentType;
@@ -745,4 +891,4 @@ declare function useScreenCanvasFrame(): ComponentType;
  *  engine's plain rows for the selection. */
 declare function useScreenInspectorPanel(): ComponentType<ScreenInspectorPanelProps>;
 
-export { type NodeDefaults, SELECTION_MODE, type ScreenBlockLook, type ScreenBlockRules, type ScreenBridges, type ScreenCanvas, type ScreenDevices, type ScreenDocumentOps, type ScreenInspector, type ScreenInspectorMode, type ScreenInspectorPanelProps, type ScreenLeftPanel, type ScreenLeftView, type ScreenLeftViewFrame, type ScreenLeftViewRules, type ScreenNewNode, type ScreenNode, type ScreenNodeLevel, type ScreenNodeMaker, type ScreenPartMode, type ScreenParts, ScreenPartsProvider, type ScreenPinnedNodes, type ScreenRailItem, type ScreenTree, type ScreenTreeFolds, type ScreenTreeRows, sameInspectorMode, useScreenBlockLook, useScreenBlockRules, useScreenBridges, useScreenCanvasFrame, useScreenDevices, useScreenDocumentPass, useScreenInspectorPanel, useScreenLeftView, useScreenOwnerName, useScreenParts, useScreenPinned, useScreenSaveSwitch, useStandaloneScreenBridges };
+export { type NodeDefaults, SELECTION_MODE, type ScreenBlockLook, type ScreenBlockRules, type ScreenBridges, type ScreenCanvas, type ScreenDevices, type ScreenDocumentOps, type ScreenInspector, type ScreenInspectorMode, type ScreenInspectorPanelProps, type ScreenLeftPanel, type ScreenLeftView, type ScreenLeftViewFrame, type ScreenLeftViewRules, type ScreenNewNode, type ScreenNode, type ScreenNodeActions, type ScreenNodeLevel, type ScreenNodeMaker, type ScreenPartMode, type ScreenParts, ScreenPartsProvider, type ScreenPinnedBand, type ScreenPinnedNodes, type ScreenRailItem, type ScreenTree, type ScreenTreeFolds, type ScreenTreeRows, isPinnedFirst, isPinnedLast, sameInspectorMode, useScreenBlockLook, useScreenBlockRules, useScreenBridges, useScreenCanvasFrame, useScreenDevices, useScreenDocumentLabel, useScreenDocumentPass, useScreenInspectorPanel, useScreenLeftView, useScreenOwnerName, useScreenParts, useScreenPickFollowsSelection, useScreenPinned, useScreenSaveSwitch, useStandaloneScreenBridges };

package/dist/screen/lib/screen-parts.js

@@ -1 +1 @@
-export{SELECTION_MODE,ScreenPartsProvider,sameInspectorMode,useScreenBlockLook,useScreenBlockRules,useScreenBridges,useScreenCanvasFrame,useScreenDevices,useScreenDocumentPass,useScreenInspectorPanel,useScreenLeftView,useScreenOwnerName,useScreenParts,useScreenPinned,useScreenSaveSwitch,useStandaloneScreenBridges}from"../../chunk-NBJ2YY6Y.js";import"../../chunk-P67FP7PG.js";import"../../chunk-AELNNAFM.js";import"../../chunk-BXZ6WLHC.js";import"../../chunk-EOJNJCMJ.js";import"../../chunk-ZFDCDJNZ.js";import"../../chunk-ZNS7727Y.js";import"../../chunk-3EDSDPIP.js";import"../../chunk-QTLAVDJE.js";import"../../chunk-YRLPFZW3.js";import"../../chunk-KTVH2ZRL.js";import"../../chunk-D2BCHTQR.js";import"../../chunk-EWVJSRRY.js";import"../../chunk-P6O363EE.js";import"../../chunk-FPOKPNO4.js";import"../../chunk-MFIRYGHW.js";import"../../chunk-BZ5ASXOL.js";import"../../chunk-67GNT6PF.js";import"../../chunk-ZNCEOSXO.js";import"../../chunk-L5KW4HG5.js";import"../../chunk-KRXQM65X.js";import"../../chunk-NKB3KVAB.js";
+export{SELECTION_MODE,ScreenPartsProvider,isPinnedFirst,isPinnedLast,sameInspectorMode,useScreenBlockLook,useScreenBlockRules,useScreenBridges,useScreenCanvasFrame,useScreenDevices,useScreenDocumentLabel,useScreenDocumentPass,useScreenInspectorPanel,useScreenLeftView,useScreenOwnerName,useScreenParts,useScreenPickFollowsSelection,useScreenPinned,useScreenSaveSwitch,useStandaloneScreenBridges}from"../../chunk-7755VWRT.js";import"../../chunk-Z6BAZFSW.js";import"../../chunk-R5ZVNJLJ.js";import"../../chunk-P67FP7PG.js";import"../../chunk-AELNNAFM.js";import"../../chunk-BXZ6WLHC.js";import"../../chunk-EOJNJCMJ.js";import"../../chunk-ZFDCDJNZ.js";import"../../chunk-ZNS7727Y.js";import"../../chunk-3EDSDPIP.js";import"../../chunk-QTLAVDJE.js";import"../../chunk-YRLPFZW3.js";import"../../chunk-KTVH2ZRL.js";import"../../chunk-D2BCHTQR.js";import"../../chunk-EWVJSRRY.js";import"../../chunk-P6O363EE.js";import"../../chunk-FPOKPNO4.js";import"../../chunk-MFIRYGHW.js";import"../../chunk-BZ5ASXOL.js";import"../../chunk-67GNT6PF.js";import"../../chunk-ZNCEOSXO.js";import"../../chunk-L5KW4HG5.js";import"../../chunk-KRXQM65X.js";import"../../chunk-NKB3KVAB.js";