efficient-easel 0.102.0 → 0.104.0

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/device-fields.d.ts

@@ -38,7 +38,7 @@ import '../content/view-tiers.js';
  * WHY THE HIDDEN FIELD LEAVES NO GAP. Puck wraps every top-level field in its
  * own padded `_PuckFields-field_` box before it calls `render`, so a field that
  * renders nothing would still cost ~37px of empty panel. The gate instead paints
- * a zero-size marker and `components/storefront-editor.css` collapses the
+ * a zero-size marker and this package's `screen.css` collapses the
  * wrapper that contains one — the same "reach the wrapper Puck owns" trick the
  * fold reflow in `controls.tsx` already relies on, expressed as one CSS rule
  * instead of a second DOM pass (so it cannot race the fold's).
@@ -64,7 +64,9 @@ declare function shownTier(device: PreviewDevice): DeviceTier;
  */
 declare const DEVICE_NOTE: Readonly<Record<PreviewDevice, string | null>>;
 /** The attribute the stylesheet looks for to collapse a gated-off field's Puck
- *  wrapper. Declared here, matched once in `components/storefront-editor.css`. */
+ *  wrapper. Declared here, matched once in this package's `screen.css`, which
+ *  every host that mounts the screen loads (it sat in the website's sheet until
+ *  0.103.0, so a second host's hidden rows kept their space). */
 declare const DEVICE_HIDDEN_ATTR = "data-sf-device-hidden";
 /** A house control's render, seen from outside: the builders in `controls.tsx`
  *  each type their own props, so the gate takes the widest shape that can be

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/style-clipboard.js

@@ -1 +1 @@
-export{copyNodeStyle,nodeStyleRows,planNodePaste,shopFieldKind,siteStyleScope}from"../../../chunk-PP44LCJM.js";import"../../../chunk-PWZOS45R.js";import"../../../chunk-7F52SZOI.js";import"../../../chunk-R2HLPNQF.js";import"../../../chunk-ZE7I3PLX.js";import"../../../chunk-DUVRZ456.js";import"../../../chunk-BSPCSC45.js";import"../../../chunk-57DJOKXT.js";import"../../../chunk-6WY6ZXJG.js";import"../../../chunk-L5KW4HG5.js";
+export{copyNodeStyle,nodeStyleRows,planNodePaste,shopFieldKind,siteStyleScope}from"../../../chunk-Q2HPBMG5.js";import"../../../chunk-ZE7I3PLX.js";import"../../../chunk-PWZOS45R.js";import"../../../chunk-7F52SZOI.js";import"../../../chunk-R2HLPNQF.js";import"../../../chunk-DUVRZ456.js";import"../../../chunk-BSPCSC45.js";import"../../../chunk-57DJOKXT.js";import"../../../chunk-6WY6ZXJG.js";import"../../../chunk-L5KW4HG5.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
@@ -305,6 +325,15 @@ interface ScreenBridges {
     /** …and `barTrail` stands between Refresh and the main button: a way out to
      *  where the document is read. */
     barTrail?: () => ReactNode;
+    /**
+     * …and `barMain` IS the main button, in its place at the end of the cluster
+     * (0.103.0): the layer's own way to finish with the document — the campaign
+     * designer's Done — where the screen draws Publish (a document that
+     * publishes) or Save. What comes back is placed as it is, nothing round it,
+     * and returning nothing leaves the place empty. Absent, the screen draws its
+     * own button, as it always has.
+     */
+    barMain?: () => ReactNode;
     /**
      * The layer's own buttons in the rail. The screen draws the rail as Add, its
      * own Layers and the host's Media library; a layer has two places in it.
@@ -441,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. */
@@ -507,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,
@@ -557,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
@@ -567,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. */
@@ -584,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
@@ -613,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
@@ -662,6 +801,24 @@ interface ScreenParts {
      *  sections, and which are edited in a panel of the layer's. Data and three
      *  plain functions, and handed here for the reason the rules are. */
     pinned?: ScreenPinnedNodes;
+    /**
+     * Is the save pill also the autosave's on / off switch (0.103.0)? The screen
+     * draws the pill as a button that pauses the autosave and resumes it; a
+     * layer whose editor always saves (the campaign designer) says false, and the
+     * pill is the same words and the same dot with nothing to press. "Retry now"
+     * stays beside a failed save either way. Absent, true: the switch, as the
+     * 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
@@ -695,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. */
@@ -717,6 +877,13 @@ declare function useScreenLeftView(): ScreenLeftViewRules;
 /** Which node types the layer pins in the top-level list, and which are its
  *  groups of sections. With no layer, none. */
 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;
@@ -724,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, 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,useStandaloneScreenBridges}from"../../chunk-5464H65G.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";

package/dist/screen/lib/section-templates.d.ts

@@ -1,5 +1,20 @@
 import { SectionTemplateStore } from './section-template-types.js';
+import { EaselSession } from './session.js';
 import './puck/content-tree.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 '../../edit-lock/index.js';
+import './host-chrome.js';
+import './links/link-filters.js';
+import '../../LinkPicker-W2Rtxetz.js';
+import './document-contract.js';
+import './document-hooks.js';
 
 /**
  * The section templates of the editor on this page — whichever store its
@@ -18,6 +33,15 @@ import './puck/content-tree.js';
  * website's sections into the other's.
  */
 
+/** The section templates of the editor on this page (`currentEaselSession`). */
 declare const sectionTemplates: SectionTemplateStore;
+/**
+ * The section templates of ONE editor's session (0.103.0): what the screen's
+ * own Add panel lists, so an editor mounted beside the page's (a session made
+ * with `claimsPage: false`) lists its own backend's templates, never the page
+ * editor's. For the page's own editor it is the same store as
+ * {@link sectionTemplates}.
+ */
+declare function sectionTemplatesOf(session: EaselSession): SectionTemplateStore;
 
-export { sectionTemplates };
+export { sectionTemplates, sectionTemplatesOf };

package/dist/screen/lib/section-templates.js

@@ -1 +1 @@
-export{sectionTemplates}from"../../chunk-J4RAY75C.js";import"../../chunk-AJBJ74ME.js";import"../../chunk-KDYIMJTZ.js";
+export{sectionTemplates,sectionTemplatesOf}from"../../chunk-BVN33R76.js";import"../../chunk-KCOBHPN6.js";import"../../chunk-RSCMJIWS.js";

package/dist/screen/lib/session-context.d.ts

@@ -7,6 +7,8 @@ import '../../data/index.js';
 import '../../types-41704JE4.js';
 import '../../resolve-D68pb3Bx.js';
 import '../../plan-DChbUXdS.js';
+import './backend-error.js';
+import '../../edit-lock/index.js';
 import './host-chrome.js';
 import './links/link-filters.js';
 import '../../LinkPicker-W2Rtxetz.js';
@@ -18,7 +20,9 @@ import './puck/content-tree.js';
 /**
  * Hand `session` to the editor below, and make it the page's current one for
  * as long as this is mounted (see `activateEaselSession` for why it happens in
- * render AND in an effect).
+ * render AND in an effect) — unless it was made not to claim the page
+ * (`claimsPage: false`, 0.103.0): an editor mounted beside the page's is
+ * handed its session here and nowhere else.
  */
 declare function EaselSessionProvider({ session, children }: {
     session: EaselSession;

package/dist/screen/lib/session-context.js

@@ -1 +1 @@
-export{EaselSessionProvider,useEaselSession}from"../../chunk-6TZTKAB5.js";import"../../chunk-AJBJ74ME.js";
+export{EaselSessionProvider,useEaselSession}from"../../chunk-O7Q4DDJT.js";import"../../chunk-RSCMJIWS.js";