efficient-easel 17.0.0 → 18.1.0

package/dist/screen/lib/admin-bridge.d.ts

@@ -1,11 +1,11 @@
 import { RefObject } from 'react';
 import { EaselSession } from './session.js';
 import '../../blocks/index.js';
-import '../../types-kR_4wYBw.js';
+import '../../types-Cq53lL8d.js';
 import '../../data/index.js';
 import '../../types-41704JE4.js';
 import '../../resolve-D68pb3Bx.js';
-import '../../plan-2BLk7pWs.js';
+import '../../plan-CZS902DV.js';
 import './backend-error.js';
 import '../../edit-lock/index.js';
 import './host-chrome.js';
@@ -15,6 +15,7 @@ import './document-contract.js';
 import './document-hooks.js';
 import './section-template-types.js';
 import './puck/content-tree.js';
+import './shared-section-types.js';
 
 /** The `storefront-editor:auth` payload the admin portal bridges in. */
 interface AuthMessage {

package/dist/screen/lib/document-addressing.d.ts

@@ -1,13 +1,13 @@
-export { A as AnyDocumentAddressing, a as DocumentAddressing, N as NO_DOCUMENT_ADDRESSING } from '../../host-Cxbhp0zg.js';
+export { A as AnyDocumentAddressing, a as DocumentAddressing, N as NO_DOCUMENT_ADDRESSING } from '../../host-epHo7r8P.js';
 import './document-contract.js';
 import './session.js';
 import 'react';
 import '../../blocks/index.js';
-import '../../types-kR_4wYBw.js';
+import '../../types-Cq53lL8d.js';
 import '../../data/index.js';
 import '../../types-41704JE4.js';
 import '../../resolve-D68pb3Bx.js';
-import '../../plan-2BLk7pWs.js';
+import '../../plan-CZS902DV.js';
 import './document-switch.js';
 import '../../engine-CvXpFE86.js';
 import '../../edit-lock/index.js';
@@ -19,3 +19,4 @@ import 'efficient-shell/ui';
 import './document-hooks.js';
 import './section-template-types.js';
 import './puck/content-tree.js';
+import './shared-section-types.js';

package/dist/screen/lib/document-hooks.d.ts

@@ -1,11 +1,11 @@
 import { Data } from '../../blocks/index.js';
 import { EaselCapabilities } from './document-contract.js';
 import 'react';
-import '../../types-kR_4wYBw.js';
+import '../../types-Cq53lL8d.js';
 import '../../data/index.js';
 import '../../types-41704JE4.js';
 import '../../resolve-D68pb3Bx.js';
-import '../../plan-2BLk7pWs.js';
+import '../../plan-CZS902DV.js';
 
 /**
  * WHAT A HOST DOES TO A DOCUMENT AS IT OPENS AND AS IT IS STORED.

package/dist/screen/lib/host.d.ts

@@ -1,11 +1,11 @@
 import 'react';
-export { D as DETACHED_EASEL_HOST, E as EaselHost, b as EaselHostAddress, c as EaselHostContext, d as EaselHostProvider, e as EaselMessageType, f as EaselToHostMessage, H as HostPickedMedia, g as HostToEaselMessage, I as InboundHostMessage, S as SectionScreenTarget, h as SendToHost, i as createEaselHost, u as useEaselHost, j as useHostEscape } from '../../host-Cxbhp0zg.js';
+export { D as DETACHED_EASEL_HOST, E as EaselHost, b as EaselHostAddress, c as EaselHostContext, d as EaselHostProvider, e as EaselMessageType, f as EaselToHostMessage, H as HostPickedMedia, g as HostToEaselMessage, I as InboundHostMessage, P as PickedMediaSource, S as SectionScreenTarget, h as SendToHost, i as createEaselHost, u as useEaselHost, j as useHostEscape } from '../../host-epHo7r8P.js';
 import '../../blocks/index.js';
-import '../../types-kR_4wYBw.js';
+import '../../types-Cq53lL8d.js';
 import '../../data/index.js';
 import '../../types-41704JE4.js';
 import '../../resolve-D68pb3Bx.js';
-import '../../plan-2BLk7pWs.js';
+import '../../plan-CZS902DV.js';
 import './document-contract.js';
 import './session.js';
 import './backend-error.js';
@@ -16,6 +16,7 @@ import 'efficient-shell/ui';
 import './document-hooks.js';
 import './section-template-types.js';
 import './puck/content-tree.js';
+import './shared-section-types.js';
 import './document-switch.js';
 import '../../engine-CvXpFE86.js';
 import './admin-bridge.js';

package/dist/screen/lib/key-scope.js

@@ -1 +1 @@
-export{editorRootFocus,isSaveShortcut,useEaselKeyTarget,useEaselSaveKey,useEaselUndoKeys}from"../../chunk-JSH3XKEF.js";import"../../chunk-U3JP4VGF.js";import"../../chunk-BU2YSTLJ.js";import"../../chunk-TBY3DFKS.js";import"../../chunk-YRLPFZW3.js";import"../../chunk-SHS6WCLL.js";import"../../chunk-23VM4PMV.js";import"../../chunk-B4JN227A.js";import"../../chunk-MFIRYGHW.js";import"../../chunk-X4T6JT3M.js";import"../../chunk-KRXQM65X.js";import"../../chunk-NKB3KVAB.js";
+export{editorRootFocus,isSaveShortcut,useEaselKeyTarget,useEaselSaveKey,useEaselUndoKeys}from"../../chunk-YLQYEDUQ.js";import"../../chunk-U3JP4VGF.js";import"../../chunk-QEAUF632.js";import"../../chunk-TBY3DFKS.js";import"../../chunk-YRLPFZW3.js";import"../../chunk-X3TYRF5V.js";import"../../chunk-23VM4PMV.js";import"../../chunk-B4JN227A.js";import"../../chunk-MFIRYGHW.js";import"../../chunk-X4T6JT3M.js";import"../../chunk-KRXQM65X.js";import"../../chunk-NKB3KVAB.js";

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

@@ -1,12 +1,12 @@
 import * as react from 'react';
 import { ComponentType, ReactNode } from 'react';
-import { H as HostPickedMedia, E as EaselHost } from '../../host-Cxbhp0zg.js';
+import { H as HostPickedMedia, E as EaselHost } from '../../host-epHo7r8P.js';
 import '../../blocks/index.js';
-import '../../types-kR_4wYBw.js';
+import '../../types-Cq53lL8d.js';
 import '../../data/index.js';
 import '../../types-41704JE4.js';
 import '../../resolve-D68pb3Bx.js';
-import '../../plan-2BLk7pWs.js';
+import '../../plan-CZS902DV.js';
 import './document-contract.js';
 import './session.js';
 import './backend-error.js';
@@ -17,6 +17,7 @@ import 'efficient-shell/ui';
 import './document-hooks.js';
 import './section-template-types.js';
 import './puck/content-tree.js';
+import './shared-section-types.js';
 import './document-switch.js';
 import '../../engine-CvXpFE86.js';
 import './admin-bridge.js';

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

@@ -1,11 +1,11 @@
-import { E as EaselHost } from '../../host-Cxbhp0zg.js';
+import { H as HostPickedMedia, E as EaselHost } from '../../host-epHo7r8P.js';
 import 'react';
 import '../../blocks/index.js';
-import '../../types-kR_4wYBw.js';
+import '../../types-Cq53lL8d.js';
 import '../../data/index.js';
 import '../../types-41704JE4.js';
 import '../../resolve-D68pb3Bx.js';
-import '../../plan-2BLk7pWs.js';
+import '../../plan-CZS902DV.js';
 import './document-contract.js';
 import './session.js';
 import './backend-error.js';
@@ -16,6 +16,7 @@ import 'efficient-shell/ui';
 import './document-hooks.js';
 import './section-template-types.js';
 import './puck/content-tree.js';
+import './shared-section-types.js';
 import './document-switch.js';
 import '../../engine-CvXpFE86.js';
 import './admin-bridge.js';
@@ -41,7 +42,7 @@ import './admin-bridge.js';
  *     → posts `storefront-editor:open-media-picker` { requestId, accept, title, file }
  *       to the host (lib/host — over postMessage when framed).
  *   The admin (PageBlockEditor) relays the window's result back down:
- *     `storefront-editor:media-picked`        { requestId, media:{id,url,kind} } → resolve(media)
+ *     `storefront-editor:media-picked`        { requestId, media:{id,url,kind,source?} } → resolve(media)
  *     `storefront-editor:media-pick-cancelled`{ requestId }                      → resolve(null)
  *   resolveMediaPick(requestId, …) is called by the central message listener
  *   (ScreenDocumentContext) to settle the pending promise, correlated by id.
@@ -50,11 +51,8 @@ import './admin-bridge.js';
  * custom fields (the media slots) can't receive the listener as a prop.
  */
 
-interface PickedMedia {
-    id: string;
-    url: string;
-    kind: "image" | "video";
-}
+/** The chosen file: the host's own answer, one type for both paths. */
+type PickedMedia = HostPickedMedia;
 /**
  * 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

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

@@ -2,11 +2,11 @@ import { EditLock } from '../../edit-lock/index.js';
 import { EaselSession } from './session.js';
 import '../../blocks/index.js';
 import 'react';
-import '../../types-kR_4wYBw.js';
+import '../../types-Cq53lL8d.js';
 import '../../data/index.js';
 import '../../types-41704JE4.js';
 import '../../resolve-D68pb3Bx.js';
-import '../../plan-2BLk7pWs.js';
+import '../../plan-CZS902DV.js';
 import './backend-error.js';
 import './host-chrome.js';
 import './links/link-filters.js';
@@ -15,6 +15,7 @@ import './document-contract.js';
 import './document-hooks.js';
 import './section-template-types.js';
 import './puck/content-tree.js';
+import './shared-section-types.js';
 
 /**
  * The storefront editor's binding of the SHARED edit lock.

package/dist/screen/lib/puck/device-fields.js

@@ -1 +1 @@
-export{DEVICE_FIELD_MARKER,DEVICE_HIDDEN_ATTR,DEVICE_NOTE,deviceField,deviceMetaOf,deviceNote,shownTier,withoutDeviceGate}from"../../../chunk-FJL3MYPA.js";import"../../../chunk-7F52SZOI.js";import"../../../chunk-EL4F3IN7.js";import"../../../chunk-MFIRYGHW.js";import"../../../chunk-BSPCSC45.js";
+export{DEVICE_FIELD_MARKER,DEVICE_HIDDEN_ATTR,DEVICE_NOTE,deviceField,deviceMetaOf,deviceNote,shownTier,withoutDeviceGate}from"../../../chunk-XHHVMAGM.js";import"../../../chunk-7F52SZOI.js";import"../../../chunk-C2RHV42O.js";import"../../../chunk-MFIRYGHW.js";import"../../../chunk-BSPCSC45.js";

package/dist/screen/lib/puck/palette-sections.d.ts

@@ -1,10 +1,10 @@
 import { Config } from '../../../blocks/index.js';
 import 'react';
-import '../../../types-kR_4wYBw.js';
+import '../../../types-Cq53lL8d.js';
 import '../../../data/index.js';
 import '../../../types-41704JE4.js';
 import '../../../resolve-D68pb3Bx.js';
-import '../../../plan-2BLk7pWs.js';
+import '../../../plan-CZS902DV.js';
 
 /** One offerable section, with the category it is grouped under. */
 type PaletteSection = {

package/dist/screen/lib/puck/section-doc.d.ts

@@ -1,11 +1,11 @@
 import { Data } from '../../../blocks/index.js';
 import { TreeItem } from './content-tree.js';
 import 'react';
-import '../../../types-kR_4wYBw.js';
+import '../../../types-Cq53lL8d.js';
 import '../../../data/index.js';
 import '../../../types-41704JE4.js';
 import '../../../resolve-D68pb3Bx.js';
-import '../../../plan-2BLk7pWs.js';
+import '../../../plan-CZS902DV.js';
 
 declare function nodeToDoc(node: TreeItem): Data;
 declare function docToNode(data: Data): TreeItem | null;

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

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

package/dist/screen/lib/puck/style-clipboard.d.ts

@@ -5,11 +5,11 @@ import { panelFieldsOf } from './panel-fields.js';
 import '../../../types-BsyPh6EW.js';
 import 'react';
 import '../../../blocks/index.js';
-import '../../../types-kR_4wYBw.js';
+import '../../../types-Cq53lL8d.js';
 import '../../../data/index.js';
 import '../../../types-41704JE4.js';
 import '../../../resolve-D68pb3Bx.js';
-import '../../../plan-2BLk7pWs.js';
+import '../../../plan-CZS902DV.js';
 import '../../../watch-BTYOJpQU.js';
 import '../../../types-DT8ywrFQ.js';
 import '../../../types-Cy7rdmXt.js';
@@ -19,14 +19,15 @@ import '../../../panelWidths-D9hTLR25.js';
 import '../../../CanvasDragLayer-dZCPbQCP.js';
 import '../../../session-DSQFmIvx.js';
 import '../../../words-CvwYvkJm.js';
-import '../../../types-D8P9q-BG.js';
+import '../../../types-Bqq6ya0y.js';
 import 'efficient-shell/ui';
 import '../../../words-Cl9xMUYY.js';
 import '../../components/AddSidePanel.js';
 import '../section-template-types.js';
 import './content-tree.js';
+import '../shared-section-types.js';
 import './block-choice.js';
-import '../../../host-Cxbhp0zg.js';
+import '../../../host-epHo7r8P.js';
 import '../document-contract.js';
 import '../session.js';
 import '../backend-error.js';

package/dist/screen/lib/puck/style-clipboard.js

@@ -1 +1 @@
-export{copyNodeStyle,nodeStyleRows,planNodePaste,shopFieldKind,siteStyleScope,styleClipboardOf}from"../../../chunk-XLUVTPKK.js";import"../../../chunk-LER7RKTO.js";import"../../../chunk-FJL3MYPA.js";import"../../../chunk-7F52SZOI.js";import"../../../chunk-MQNBD6AB.js";import"../../../chunk-EL4F3IN7.js";import"../../../chunk-V7U33NF2.js";import"../../../chunk-6WY6ZXJG.js";import"../../../chunk-DUVRZ456.js";import"../../../chunk-BPXEFVSQ.js";import"../../../chunk-MFIRYGHW.js";import"../../../chunk-BSPCSC45.js";
+export{copyNodeStyle,nodeStyleRows,planNodePaste,shopFieldKind,siteStyleScope,styleClipboardOf}from"../../../chunk-VEZPDGDQ.js";import"../../../chunk-LER7RKTO.js";import"../../../chunk-XHHVMAGM.js";import"../../../chunk-7F52SZOI.js";import"../../../chunk-MQNBD6AB.js";import"../../../chunk-C2RHV42O.js";import"../../../chunk-V7U33NF2.js";import"../../../chunk-6WY6ZXJG.js";import"../../../chunk-DUVRZ456.js";import"../../../chunk-BPXEFVSQ.js";import"../../../chunk-MFIRYGHW.js";import"../../../chunk-BSPCSC45.js";

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

@@ -1,9 +1,9 @@
-import { N as NodeSelection } from '../../../plan-2BLk7pWs.js';
+import { N as NodeSelection } from '../../../plan-CZS902DV.js';
 import { Data } from '../../../blocks/index.js';
 import { TreeItem } from './content-tree.js';
 import '../../../types-41704JE4.js';
 import 'react';
-import '../../../types-kR_4wYBw.js';
+import '../../../types-Cq53lL8d.js';
 import '../../../data/index.js';
 import '../../../resolve-D68pb3Bx.js';
 

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

@@ -1 +1 @@
-export{useSectionOps}from"../../../chunk-NFLO4I2N.js";import"../../../chunk-SPQOPWCL.js";import"../../../chunk-R6WTQWAC.js";import"../../../chunk-U3JP4VGF.js";import"../../../chunk-PLVEGYK6.js";import"../../../chunk-BU2YSTLJ.js";import"../../../chunk-TBY3DFKS.js";import"../../../chunk-N3LYD2LK.js";import"../../../chunk-BPXEFVSQ.js";import"../../../chunk-4JSBIW5H.js";import"../../../chunk-K56YDHYQ.js";import"../../../chunk-XWFH2NHZ.js";import"../../../chunk-YRLPFZW3.js";import"../../../chunk-BALFHI3G.js";import"../../../chunk-SHS6WCLL.js";import"../../../chunk-RC25EGHD.js";import"../../../chunk-KFV7N2DJ.js";import"../../../chunk-23VM4PMV.js";import"../../../chunk-B4JN227A.js";import"../../../chunk-2XMHLXMA.js";import"../../../chunk-G3GWAP5R.js";import"../../../chunk-WRFD4EXD.js";import"../../../chunk-36LVP5WD.js";import"../../../chunk-MFIRYGHW.js";import"../../../chunk-67GNT6PF.js";import"../../../chunk-P2VEMZH5.js";import"../../../chunk-X4T6JT3M.js";import"../../../chunk-KRXQM65X.js";import"../../../chunk-NKB3KVAB.js";
+export{useSectionOps}from"../../../chunk-SNB4LQMK.js";import"../../../chunk-W6SDWCOL.js";import"../../../chunk-R6WTQWAC.js";import"../../../chunk-U3JP4VGF.js";import"../../../chunk-PLVEGYK6.js";import"../../../chunk-QEAUF632.js";import"../../../chunk-TBY3DFKS.js";import"../../../chunk-5ZBV5RA6.js";import"../../../chunk-BPXEFVSQ.js";import"../../../chunk-A6Z4SD3I.js";import"../../../chunk-K56YDHYQ.js";import"../../../chunk-XWFH2NHZ.js";import"../../../chunk-YRLPFZW3.js";import"../../../chunk-BALFHI3G.js";import"../../../chunk-X3TYRF5V.js";import"../../../chunk-RC25EGHD.js";import"../../../chunk-KFV7N2DJ.js";import"../../../chunk-23VM4PMV.js";import"../../../chunk-B4JN227A.js";import"../../../chunk-2XMHLXMA.js";import"../../../chunk-G3GWAP5R.js";import"../../../chunk-WRFD4EXD.js";import"../../../chunk-36LVP5WD.js";import"../../../chunk-MFIRYGHW.js";import"../../../chunk-67GNT6PF.js";import"../../../chunk-P2VEMZH5.js";import"../../../chunk-X4T6JT3M.js";import"../../../chunk-KRXQM65X.js";import"../../../chunk-NKB3KVAB.js";

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

@@ -8,17 +8,18 @@ import { M as MeasuredCanvas, C as CanvasDragModel } from '../../CanvasDragLayer
 import { E as EaselContextMenuItem } from '../../types-BsyPh6EW.js';
 import { E as EaselRailItem } from '../../types-Cy7rdmXt.js';
 import { StyleRow } from '../../style-clipboard/index.js';
-import { T as TreeRowMark } from '../../types-D8P9q-BG.js';
+import { T as TreeRowMark } from '../../types-Bqq6ya0y.js';
 import { AddKey } from '../components/AddSidePanel.js';
-import { k as AnyScreenTarget } from '../../host-Cxbhp0zg.js';
+import { k as AnyScreenTarget } from '../../host-epHo7r8P.js';
 import { HostProduct } from './host-chrome.js';
 import { EaselSession } from './session.js';
+import { SharedSectionUse, SharedSection } from './shared-section-types.js';
 import { AddTarget } from './puck/add-target-types.js';
 import { SlotConfigView } from './puck/content-tree.js';
-import '../../types-kR_4wYBw.js';
+import '../../types-Cq53lL8d.js';
 import '../../data/index.js';
 import '../../resolve-D68pb3Bx.js';
-import '../../plan-2BLk7pWs.js';
+import '../../plan-CZS902DV.js';
 import '../../edit-lock/index.js';
 import '../../panelWidths-D9hTLR25.js';
 import '../../session-DSQFmIvx.js';
@@ -533,6 +534,31 @@ interface ScreenBridges {
      *  is the screen; what it returns is rendered in the screen's place. */
     wrap?: (screen: ReactNode) => ReactNode;
 }
+/** The document's half of a shared section (`ScreenPinnedNodes.shared`). */
+interface ScreenSharedSections {
+    /** The pages that use this top-level node, this page among them, when it is
+     *  a shared section; null when it is this page's own, or the header or
+     *  footer. */
+    usedOn: (node: ScreenNode) => readonly SharedSectionUse[] | null;
+    /** Open one of those pages (a press in On N pages ▸). */
+    openPage: (page: SharedSectionUse) => void;
+    /** MAKE SHARED: the store made `section` from `node`. From now on the layer
+     *  holds `node`, where it stands, as that shared section; the page looks the
+     *  same, and its row turns green. */
+    adopt: (node: ScreenNode, section: SharedSection) => void;
+    /** What Add puts on the page for `section` — the node the layer holds as it
+     *  — or null when it cannot go on this page: it is on it already (once per
+     *  page). */
+    nodeOf: (section: SharedSection) => ScreenNode | null;
+    /** DETACH FROM SHARED: this page's own copy of the shared `node`, every id
+     *  fresh (efficient-easel/data `copyNode`). The screen puts it in the node's
+     *  place, one undo step, and the layer holds it as the page's own from then
+     *  on. The other pages keep the shared section. */
+    detach: (node: ScreenNode) => ScreenNode;
+    /** A shared section was deleted: every page that used it now holds its own
+     *  copy, this one included, and the layer takes that in. Optional. */
+    removed?: (section: SharedSection) => void;
+}
 /** A layer's own rows in a node's menu, by the group of the menu each goes at
  *  the end of (efficient-easel/node-ops `nodeMenuItems`' `extras`): `pick`
  *  (Select layer), `make` (Duplicate … Paste), `change` (Rename, Hide …) and
@@ -574,8 +600,12 @@ interface ScreenNewNode {
  */
 interface ScreenBlockRules {
     /** A block that is what its section IS: it may be selected and edited, and
-     *  never removed, hidden, duplicated or dragged. */
-    isLockedBlock: (type: string | undefined) => boolean;
+     *  never removed, hidden, duplicated or dragged. `node` is the node itself,
+     *  where the screen asks of one (every place it does, since 18.1.0): a rule
+     *  that locks ONE node, not a whole type — a shared section another tab
+     *  holds (Shared section design v4). A rule that reads the type alone locks
+     *  by type, as it always did. */
+    isLockedBlock: (type: string | undefined, node?: ScreenNode) => boolean;
     /** Why a second one of this node cannot be made in this document, or null —
      *  a rule of the block's own. */
     duplicateBlocked: (data: unknown, node: unknown) => string | null;
@@ -1087,6 +1117,44 @@ interface ScreenPinnedNodes {
      * as it was.
      */
     groupBadge?: string;
+    /**
+     * SHARED, AND HOW FAR (Shared section design v4, Lewis 2026-10-21): how far
+     * a top-level node reaches when many pages use it live — "On every page",
+     * "On 3 pages" — or null for a node that is this page's own. Asked of each
+     * top-level node, the header and footer and their groups included. For a
+     * node it answers, the screen draws ONE look, green with the shell's
+     * `shared` mark, colour never alone:
+     *   · its Layers row in the shell's shared tone, the mark at the row's end
+     *     and these words in the mark's Tooltip — in place of `groupBadge`;
+     *   · its canvas tab, while it or anything in it is selected or under the
+     *     pointer: the green badge with the mark and the row's name, these words
+     *     in the tab's Tooltip — in place of `groupTab`'s words;
+     *   · its selected and hover outline on the canvas in green
+     *     (`CanvasSharedContext`).
+     * `groupTab` and `groupBadge` still say what they switch (the in-place tree,
+     * the click chain). Absent: nothing is shared, and the screen is as it was.
+     */
+    sharedReach?: (node: ScreenNode) => string | null;
+    /**
+     * …and the DOCUMENT'S HALF of a shared section (Shared section design v4,
+     * Lewis 2026-10-21): the layer holds which top-level nodes are shared
+     * sections, and how a page's document stores them (a reference in its top
+     * level, the section in a document of its own). The screen draws the rows
+     * and asks the store (lib/shared-sections); what changes in the document is
+     * asked here. Handed with a store (`SessionBackend.sharedSections`), the
+     * screen offers:
+     *   · a page's own section's menu: Make shared — a name asked in a dialog,
+     *     the store makes the shared section, `adopt` takes the node in;
+     *   · a shared section's menu: On N pages ▸ (`usedOn`, a press `openPage`),
+     *     Detach from shared (`detach`), and Remove from this page in place of
+     *     Delete, its Layers trash saying so too;
+     *   · Add's "Shared sections" group above "Your templates": a card puts
+     *     `nodeOf` on the page (a reference, never a copy), and the card's menu
+     *     deletes the shared section (`removed`).
+     * Absent: none of these. The header and footer are shared (`sharedReach`)
+     * but answer `usedOn` with null: they keep the menu they have.
+     */
+    shared?: ScreenSharedSections;
     /**
      * …what the screen says ONCE per editing session (the easel session), the
      * first time an edit changes a pinned node or a group of sections: the
@@ -1451,4 +1519,4 @@ declare function useScreenCanvasTarget(): CanvasTarget | null;
  *  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 ScreenCanvasDrag, type ScreenCanvasDragContext, type ScreenCanvasHeadProps, ScreenCanvasTargetProvider, type ScreenDevices, type ScreenDocumentOps, type ScreenDragItem, type ScreenInspector, type ScreenInspectorMode, type ScreenInspectorPanelProps, type ScreenLeftPanel, type ScreenLeftView, type ScreenLeftViewFrame, type ScreenLeftViewRules, type ScreenMainAction, type ScreenMenuItem, type ScreenMenuRows, type ScreenNewNode, type ScreenNode, type ScreenNodeActions, type ScreenNodeLevel, type ScreenNodeMaker, type ScreenPartMode, type ScreenParts, ScreenPartsProvider, type ScreenPinnedBand, type ScreenPinnedNodes, type ScreenRailItem, type ScreenSelector, type ScreenSlot, type ScreenSlotAction, type ScreenSlotMode, type ScreenStyleClipboard, type ScreenStyleDocument, type ScreenStylePastePlan, type ScreenToastExtra, type ScreenTree, type ScreenTreeFolds, type ScreenTreeRows, isPinnedFirst, isPinnedLast, isSlotMode, sameInspectorMode, screenSlotsOf, useScreenBlockLook, useScreenBlockRules, useScreenBridges, useScreenCanvasDrag, useScreenCanvasFrame, useScreenCanvasHead, useScreenCanvasTarget, useScreenDevices, useScreenDocumentLabel, useScreenDocumentPass, useScreenInspectorPanel, useScreenLeftView, useScreenNodeKeys, useScreenNotify, useScreenOwnerName, useScreenParts, useScreenPickFollowsSelection, useScreenPinned, useScreenSaveSwitch, useScreenStorageNamespace, useScreenStyleClipboard, useStandaloneScreenBridges };
+export { type NodeDefaults, SELECTION_MODE, type ScreenBlockLook, type ScreenBlockRules, type ScreenBridges, type ScreenCanvas, type ScreenCanvasDrag, type ScreenCanvasDragContext, type ScreenCanvasHeadProps, ScreenCanvasTargetProvider, type ScreenDevices, type ScreenDocumentOps, type ScreenDragItem, type ScreenInspector, type ScreenInspectorMode, type ScreenInspectorPanelProps, type ScreenLeftPanel, type ScreenLeftView, type ScreenLeftViewFrame, type ScreenLeftViewRules, type ScreenMainAction, type ScreenMenuItem, type ScreenMenuRows, type ScreenNewNode, type ScreenNode, type ScreenNodeActions, type ScreenNodeLevel, type ScreenNodeMaker, type ScreenPartMode, type ScreenParts, ScreenPartsProvider, type ScreenPinnedBand, type ScreenPinnedNodes, type ScreenRailItem, type ScreenSelector, type ScreenSharedSections, type ScreenSlot, type ScreenSlotAction, type ScreenSlotMode, type ScreenStyleClipboard, type ScreenStyleDocument, type ScreenStylePastePlan, type ScreenToastExtra, type ScreenTree, type ScreenTreeFolds, type ScreenTreeRows, isPinnedFirst, isPinnedLast, isSlotMode, sameInspectorMode, screenSlotsOf, useScreenBlockLook, useScreenBlockRules, useScreenBridges, useScreenCanvasDrag, useScreenCanvasFrame, useScreenCanvasHead, useScreenCanvasTarget, useScreenDevices, useScreenDocumentLabel, useScreenDocumentPass, useScreenInspectorPanel, useScreenLeftView, useScreenNodeKeys, useScreenNotify, useScreenOwnerName, useScreenParts, useScreenPickFollowsSelection, useScreenPinned, useScreenSaveSwitch, useScreenStorageNamespace, useScreenStyleClipboard, useStandaloneScreenBridges };

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

@@ -1 +1 @@
-export{SELECTION_MODE,ScreenCanvasTargetProvider,ScreenPartsProvider,isPinnedFirst,isPinnedLast,isSlotMode,sameInspectorMode,screenSlotsOf,useScreenBlockLook,useScreenBlockRules,useScreenBridges,useScreenCanvasDrag,useScreenCanvasFrame,useScreenCanvasHead,useScreenCanvasTarget,useScreenDevices,useScreenDocumentLabel,useScreenDocumentPass,useScreenInspectorPanel,useScreenLeftView,useScreenNodeKeys,useScreenNotify,useScreenOwnerName,useScreenParts,useScreenPickFollowsSelection,useScreenPinned,useScreenSaveSwitch,useScreenStorageNamespace,useScreenStyleClipboard,useStandaloneScreenBridges}from"../../chunk-SPQOPWCL.js";import"../../chunk-R6WTQWAC.js";import"../../chunk-U3JP4VGF.js";import"../../chunk-PLVEGYK6.js";import"../../chunk-BU2YSTLJ.js";import"../../chunk-TBY3DFKS.js";import"../../chunk-N3LYD2LK.js";import"../../chunk-BPXEFVSQ.js";import"../../chunk-4JSBIW5H.js";import"../../chunk-K56YDHYQ.js";import"../../chunk-XWFH2NHZ.js";import"../../chunk-YRLPFZW3.js";import"../../chunk-BALFHI3G.js";import"../../chunk-SHS6WCLL.js";import"../../chunk-RC25EGHD.js";import"../../chunk-KFV7N2DJ.js";import"../../chunk-23VM4PMV.js";import"../../chunk-B4JN227A.js";import"../../chunk-2XMHLXMA.js";import"../../chunk-G3GWAP5R.js";import"../../chunk-WRFD4EXD.js";import"../../chunk-36LVP5WD.js";import"../../chunk-MFIRYGHW.js";import"../../chunk-67GNT6PF.js";import"../../chunk-P2VEMZH5.js";import"../../chunk-X4T6JT3M.js";import"../../chunk-KRXQM65X.js";import"../../chunk-NKB3KVAB.js";
+export{SELECTION_MODE,ScreenCanvasTargetProvider,ScreenPartsProvider,isPinnedFirst,isPinnedLast,isSlotMode,sameInspectorMode,screenSlotsOf,useScreenBlockLook,useScreenBlockRules,useScreenBridges,useScreenCanvasDrag,useScreenCanvasFrame,useScreenCanvasHead,useScreenCanvasTarget,useScreenDevices,useScreenDocumentLabel,useScreenDocumentPass,useScreenInspectorPanel,useScreenLeftView,useScreenNodeKeys,useScreenNotify,useScreenOwnerName,useScreenParts,useScreenPickFollowsSelection,useScreenPinned,useScreenSaveSwitch,useScreenStorageNamespace,useScreenStyleClipboard,useStandaloneScreenBridges}from"../../chunk-W6SDWCOL.js";import"../../chunk-R6WTQWAC.js";import"../../chunk-U3JP4VGF.js";import"../../chunk-PLVEGYK6.js";import"../../chunk-QEAUF632.js";import"../../chunk-TBY3DFKS.js";import"../../chunk-5ZBV5RA6.js";import"../../chunk-BPXEFVSQ.js";import"../../chunk-A6Z4SD3I.js";import"../../chunk-K56YDHYQ.js";import"../../chunk-XWFH2NHZ.js";import"../../chunk-YRLPFZW3.js";import"../../chunk-BALFHI3G.js";import"../../chunk-X3TYRF5V.js";import"../../chunk-RC25EGHD.js";import"../../chunk-KFV7N2DJ.js";import"../../chunk-23VM4PMV.js";import"../../chunk-B4JN227A.js";import"../../chunk-2XMHLXMA.js";import"../../chunk-G3GWAP5R.js";import"../../chunk-WRFD4EXD.js";import"../../chunk-36LVP5WD.js";import"../../chunk-MFIRYGHW.js";import"../../chunk-67GNT6PF.js";import"../../chunk-P2VEMZH5.js";import"../../chunk-X4T6JT3M.js";import"../../chunk-KRXQM65X.js";import"../../chunk-NKB3KVAB.js";

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

@@ -3,11 +3,11 @@ import { EaselSession } from './session.js';
 import './puck/content-tree.js';
 import '../../blocks/index.js';
 import 'react';
-import '../../types-kR_4wYBw.js';
+import '../../types-Cq53lL8d.js';
 import '../../data/index.js';
 import '../../types-41704JE4.js';
 import '../../resolve-D68pb3Bx.js';
-import '../../plan-2BLk7pWs.js';
+import '../../plan-CZS902DV.js';
 import './backend-error.js';
 import '../../edit-lock/index.js';
 import './host-chrome.js';
@@ -15,6 +15,7 @@ import './links/link-filters.js';
 import 'efficient-shell/ui';
 import './document-contract.js';
 import './document-hooks.js';
+import './shared-section-types.js';
 
 /**
  * The section templates of the editor on this page — whichever store its

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

@@ -2,11 +2,11 @@ import * as react from 'react';
 import { ReactNode } from 'react';
 import { EaselSession } from './session.js';
 import '../../blocks/index.js';
-import '../../types-kR_4wYBw.js';
+import '../../types-Cq53lL8d.js';
 import '../../data/index.js';
 import '../../types-41704JE4.js';
 import '../../resolve-D68pb3Bx.js';
-import '../../plan-2BLk7pWs.js';
+import '../../plan-CZS902DV.js';
 import './backend-error.js';
 import '../../edit-lock/index.js';
 import './host-chrome.js';
@@ -16,6 +16,7 @@ import './document-contract.js';
 import './document-hooks.js';
 import './section-template-types.js';
 import './puck/content-tree.js';
+import './shared-section-types.js';
 
 /**
  * Hand `session` to the editor below, and make it the page's current one for

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

@@ -4,12 +4,13 @@ import { EaselChrome } from './host-chrome.js';
 import { WebsiteEditLock } from './document-contract.js';
 import { EaselDocumentHooks } from './document-hooks.js';
 import { SectionTemplateStore } from './section-template-types.js';
+import { SharedSectionStore } from './shared-section-types.js';
 import 'react';
-import '../../types-kR_4wYBw.js';
+import '../../types-Cq53lL8d.js';
 import '../../data/index.js';
 import '../../types-41704JE4.js';
 import '../../resolve-D68pb3Bx.js';
-import '../../plan-2BLk7pWs.js';
+import '../../plan-CZS902DV.js';
 import '../../edit-lock/index.js';
 import './links/link-filters.js';
 import 'efficient-shell/ui';
@@ -79,6 +80,9 @@ interface SessionBackend {
     /** Where the editor's saved sections are kept (lib/section-templates).
      *  Without it there are none to list and none to open. */
     sectionTemplates?: SectionTemplateStore;
+    /** Where the website's shared sections are kept (lib/shared-sections; Shared
+     *  section design v4). Without it there are none to add and none to make. */
+    sharedSections?: SharedSectionStore;
 }
 /**
  * The mark `createEfficientBackend` puts on what it returns, so a session can

package/dist/screen/lib/shared-section-types.d.ts

@@ -0,0 +1,71 @@
+import { TreeItem } from './puck/content-tree.js';
+
+/**
+ * A SHARED SECTION, AND THE STORE A WEBSITE KEEPS THEM IN — the types alone.
+ *
+ * Shared section design v4 (Lewis 2026-10-21): one section that many pages of a
+ * website use live. Change it once, and every page that uses it changes. It is
+ * kept beside the section templates (`section-template-types`) and is their
+ * opposite: a template is COPIED onto a page and keeps no tie to it; a shared
+ * section is put on a page as a REFERENCE to the one section.
+ *
+ * The backend keeps one as a page of kind `section` whose document holds the one
+ * section (efficient-backend `storefront/shared_sections.py`,
+ * `/api/storefront/shared-sections/`), per website. A backend implements the
+ * store; EFFICIENT's adapter is efficient-storefront-blocks
+ * `src/editor/lib/api/shared-sections`. Its draft is saved, renamed and
+ * published as a page, through the pages the backend already has: this store
+ * lists, makes and deletes.
+ */
+
+/** A page that uses a shared section, as the backend names it. */
+interface SharedSectionUse {
+    id: string;
+    slug: string;
+    title: string;
+}
+/** A stored shared section, as the backend serializes it (snake_case). */
+interface SharedSectionRecord {
+    id: string;
+    /** The website it belongs to. */
+    site: string;
+    /** Its name, as Add and the Layers row say it. */
+    title: string;
+    /** Its draft document: the one section is `content[0]`. */
+    layout: {
+        content?: readonly TreeItem[];
+    } | null;
+    layout_updated_at: string | null;
+    is_published: boolean;
+    /** The pages that use it, in their draft or in their live copy. */
+    used_on: readonly SharedSectionUse[];
+}
+/** A shared section with its one section — what the port hands its callers to
+ *  draw or put on a page. */
+interface SharedSection extends SharedSectionRecord {
+    /** The one section, from its draft. */
+    node: TreeItem;
+}
+/** The one section a record's draft holds, or null when it holds none. The
+ *  store's adapters build a {@link SharedSection} with it, so there is one rule
+ *  for where the section is (the backend's `the_section`). */
+declare function sharedSectionOf(record: SharedSectionRecord): SharedSection | null;
+interface SharedSectionStore {
+    /** This website's shared sections, by name. One whose draft holds no section
+     *  is left out: there is nothing to put on a page. */
+    list(): Promise<SharedSection[]>;
+    /**
+     * MAKE SHARED: make a shared section of this website from `node`, named
+     * `title`. It is unpublished; the site's Publish puts it live with the page
+     * that uses it.
+     */
+    create(title: string, node: TreeItem): Promise<SharedSection>;
+    /**
+     * DELETE: every page that used it gets its own copy, in its draft and in its
+     * live copy, so nothing disappears from the website; then it is gone (a soft
+     * delete, kept in the versions).
+     */
+    remove(id: string): Promise<void>;
+}
+
+export { type SharedSection, type SharedSectionRecord, type SharedSectionStore, type SharedSectionUse, sharedSectionOf };

package/dist/screen/lib/shared-section-types.js

@@ -0,0 +1 @@
+function t(t){const n=t.layout?.content?.[0];return n&&"object"==typeof n&&"string"==typeof n.type?{...t,node:n}:null}export{t as sharedSectionOf};

package/dist/screen/lib/shared-sections.d.ts

@@ -0,0 +1,34 @@
+import { SharedSectionStore } from './shared-section-types.js';
+import { EaselSession } from './session.js';
+import './puck/content-tree.js';
+import '../../blocks/index.js';
+import 'react';
+import '../../types-Cq53lL8d.js';
+import '../../data/index.js';
+import '../../types-41704JE4.js';
+import '../../resolve-D68pb3Bx.js';
+import '../../plan-CZS902DV.js';
+import './backend-error.js';
+import '../../edit-lock/index.js';
+import './host-chrome.js';
+import './links/link-filters.js';
+import 'efficient-shell/ui';
+import './document-contract.js';
+import './document-hooks.js';
+import './section-template-types.js';
+
+/**
+ * The shared sections of the editor's website — whichever store its backend
+ * offers (`SessionBackend.sharedSections`). The same arrangement as the section
+ * templates (lib/section-templates): read per call, never captured, and a
+ * backend with none is an EMPTY store, so Add draws no "Shared sections" group
+ * and the menus offer no Make shared. No caller asks "is there a store?".
+ */
+
+/** Whether `session`'s backend keeps shared sections at all: the screen offers
+ *  Make shared only where one can be made. */
+declare function keepsSharedSections(session: EaselSession): boolean;
+/** The shared sections of ONE editor's session (its own backend's). */
+declare function sharedSectionsOf(session: EaselSession): SharedSectionStore;
+
+export { keepsSharedSections, sharedSectionsOf };

package/dist/screen/lib/shared-sections.js

@@ -0,0 +1 @@
+export{keepsSharedSections,sharedSectionsOf}from"../../chunk-43AEUUNQ.js";import"../../chunk-KCOBHPN6.js";import"../../chunk-RSCMJIWS.js";

package/dist/screen/screen.css

@@ -834,6 +834,13 @@
   pointer-events: auto;
   cursor: pointer;
 }
+/* A SHARED node's tab (Shared section design v4, Lewis 2026-10-21): the
+   shell's `shared` mark before the name, inside the badge's line. */
+.es-band-tab-mark {
+  display: inline-flex;
+  align-items: center;
+  margin-right: 4px;
+}
 /* THE LAYERS BADGE ("Every page") gives way below a 240px panel: the row's
    name needs the room (owner 2026-10-15). The side panel is the size
    container (chrome.css). */