efficient-easel 16.1.0 → 18.0.0

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-NQozKWEz.js';
+import '../../types-Cq53lL8d.js';
 import '../../data/index.js';
 import '../../types-41704JE4.js';
 import '../../resolve-D68pb3Bx.js';
-import '../../plan-CGREINRO.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-chrome.d.ts

@@ -109,19 +109,9 @@ interface EaselChrome {
      *   header   the settings of the host's pinned header, opened by selecting
      *            the header in the canvas or its row in the tree. Without it the
      *            inspector has no such panel.
-     *
-     * …and one the host adds to a panel of the editor's:
-     *
-     *   chromePage   drawn under the page settings of the page that STORES the
-     *            site's chrome (its footer page), on a document with a website
-     *            behind it. The storefront's is "Switch to Box header", which
-     *            builds the header group there from the shop's header row. It
-     *            takes no props: it reads the open document like any other part
-     *            of the editor (`useScreenDocument`, `useEasel`).
      */
     panels?: {
         header?: ComponentType<HostPanelProps>;
-        chromePage?: ComponentType;
     };
     /**
      * A group of the host's own rows in the Pages panel, under the host's own

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-DGmdCaNL.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-NQozKWEz.js';
+import '../../types-Cq53lL8d.js';
 import '../../data/index.js';
 import '../../types-41704JE4.js';
 import '../../resolve-D68pb3Bx.js';
-import '../../plan-CGREINRO.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-RFSLDGDA.js";import"../../chunk-U3JP4VGF.js";import"../../chunk-QX7GVECM.js";import"../../chunk-TBY3DFKS.js";import"../../chunk-ECM5F6JJ.js";import"../../chunk-YRLPFZW3.js";import"../../chunk-X4T6JT3M.js";import"../../chunk-KRXQM65X.js";import"../../chunk-NKB3KVAB.js";import"../../chunk-23VM4PMV.js";import"../../chunk-B4JN227A.js";import"../../chunk-MFIRYGHW.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-DGmdCaNL.js';
+import { H as HostPickedMedia, E as EaselHost } from '../../host-epHo7r8P.js';
 import '../../blocks/index.js';
-import '../../types-NQozKWEz.js';
+import '../../types-Cq53lL8d.js';
 import '../../data/index.js';
 import '../../types-41704JE4.js';
 import '../../resolve-D68pb3Bx.js';
-import '../../plan-CGREINRO.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-DGmdCaNL.js';
+import { H as HostPickedMedia, E as EaselHost } from '../../host-epHo7r8P.js';
 import 'react';
 import '../../blocks/index.js';
-import '../../types-NQozKWEz.js';
+import '../../types-Cq53lL8d.js';
 import '../../data/index.js';
 import '../../types-41704JE4.js';
 import '../../resolve-D68pb3Bx.js';
-import '../../plan-CGREINRO.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-NQozKWEz.js';
+import '../../types-Cq53lL8d.js';
 import '../../data/index.js';
 import '../../types-41704JE4.js';
 import '../../resolve-D68pb3Bx.js';
-import '../../plan-CGREINRO.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/block-choice.d.ts

@@ -15,7 +15,19 @@ type BlockChoice = {
     type: string;
     label: string;
     group?: string;
+    /**
+     * RETIRED: Add does not offer it, and a node of it already in a slot still
+     * belongs there (card [MERGE] One Text Block And Click Through Parts). The
+     * website's Heading and Eyebrow blocks: the Text block took their job, so
+     * nobody starts a new one, and every stored one still draws, edits, moves
+     * and pastes. Read through {@link offeredChoices} wherever a list is shown
+     * to ADD from; the whole list is still the slot's answer to "does this slot
+     * take it?", so a move or a paste reads it unfiltered.
+     */
+    retired?: boolean;
 };
+/** The choices Add offers: every one that is not {@link BlockChoice.retired}, in order. */
+declare function offeredChoices<C extends BlockChoice>(choices: readonly C[]): C[];
 /**
  * One run of consecutive choices sharing a `group` — what a menu draws under one
  * heading.
@@ -49,4 +61,4 @@ type BlockChoiceRun = {
 };
 declare function blockRuns(choices: BlockChoice[]): BlockChoiceRun[];
 
-export { type BlockChoice, type BlockChoiceRun, blockRuns };
+export { type BlockChoice, type BlockChoiceRun, blockRuns, offeredChoices };

package/dist/screen/lib/puck/block-choice.js

@@ -1 +1 @@
-export{blockRuns}from"../../../chunk-HQ4VVRIC.js";
+export{blockRuns,offeredChoices}from"../../../chunk-M2Z775ZC.js";

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-HV56SLR2.js";import"../../../chunk-7F52SZOI.js";import"../../../chunk-VVPZMWJE.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-NQozKWEz.js';
+import '../../../types-Cq53lL8d.js';
 import '../../../data/index.js';
 import '../../../types-41704JE4.js';
 import '../../../resolve-D68pb3Bx.js';
-import '../../../plan-CGREINRO.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-NQozKWEz.js';
+import '../../../types-Cq53lL8d.js';
 import '../../../data/index.js';
 import '../../../types-41704JE4.js';
 import '../../../resolve-D68pb3Bx.js';
-import '../../../plan-CGREINRO.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,28 +5,29 @@ import { panelFieldsOf } from './panel-fields.js';
 import '../../../types-BsyPh6EW.js';
 import 'react';
 import '../../../blocks/index.js';
-import '../../../types-NQozKWEz.js';
+import '../../../types-Cq53lL8d.js';
 import '../../../data/index.js';
 import '../../../types-41704JE4.js';
 import '../../../resolve-D68pb3Bx.js';
-import '../../../plan-CGREINRO.js';
+import '../../../plan-CZS902DV.js';
 import '../../../watch-BTYOJpQU.js';
-import '../../../types-DGyDHiJV.js';
-import '../../../types-CsgMwHHa.js';
+import '../../../types-DT8ywrFQ.js';
+import '../../../types-Cy7rdmXt.js';
 import '../../../wordFit-7XpmhcaW.js';
 import '../../../edit-lock/index.js';
 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-DGmdCaNL.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-L3GSW4XI.js";import"../../../chunk-HV56SLR2.js";import"../../../chunk-MQNBD6AB.js";import"../../../chunk-LER7RKTO.js";import"../../../chunk-7F52SZOI.js";import"../../../chunk-VVPZMWJE.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-CGREINRO.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-NQozKWEz.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-V6VKM2QX.js";import"../../../chunk-U25CP5VX.js";import"../../../chunk-R6WTQWAC.js";import"../../../chunk-U3JP4VGF.js";import"../../../chunk-PLVEGYK6.js";import"../../../chunk-QX7GVECM.js";import"../../../chunk-TBY3DFKS.js";import"../../../chunk-ECM5F6JJ.js";import"../../../chunk-K6EM4F5N.js";import"../../../chunk-BPXEFVSQ.js";import"../../../chunk-XWFH2NHZ.js";import"../../../chunk-4JSBIW5H.js";import"../../../chunk-K56YDHYQ.js";import"../../../chunk-BALFHI3G.js";import"../../../chunk-RC25EGHD.js";import"../../../chunk-KFV7N2DJ.js";import"../../../chunk-67GNT6PF.js";import"../../../chunk-P2VEMZH5.js";import"../../../chunk-YRLPFZW3.js";import"../../../chunk-X4T6JT3M.js";import"../../../chunk-KRXQM65X.js";import"../../../chunk-NKB3KVAB.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";
+export{useSectionOps}from"../../../chunk-A7FF65FL.js";import"../../../chunk-XHSGRH42.js";import"../../../chunk-R6WTQWAC.js";import"../../../chunk-U3JP4VGF.js";import"../../../chunk-PLVEGYK6.js";import"../../../chunk-QEAUF632.js";import"../../../chunk-TBY3DFKS.js";import"../../../chunk-5VD2LGIZ.js";import"../../../chunk-BPXEFVSQ.js";import"../../../chunk-A6Z4SD3I.js";import"../../../chunk-BALFHI3G.js";import"../../../chunk-K56YDHYQ.js";import"../../../chunk-XWFH2NHZ.js";import"../../../chunk-YRLPFZW3.js";import"../../../chunk-RC25EGHD.js";import"../../../chunk-KFV7N2DJ.js";import"../../../chunk-X3TYRF5V.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/save-status.d.ts

@@ -1,7 +1,7 @@
 import { A as AutosaveSnapshot } from '../../engine-CvXpFE86.js';
-import { a as SaveIconState } from '../../types-DGyDHiJV.js';
+import { a as SaveIconState } from '../../types-DT8ywrFQ.js';
 import { ScreenSaveStatusWords } from '../words.js';
-import '../../types-CsgMwHHa.js';
+import '../../types-Cy7rdmXt.js';
 import '../../wordFit-7XpmhcaW.js';
 import 'react';
 import '../../edit-lock/index.js';

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

@@ -2,23 +2,24 @@ import * as react from 'react';
 import { ReactNode, MouseEvent, ComponentType } from 'react';
 import { Data } from '../../blocks/index.js';
 import { C as CanvasTarget } from '../../watch-BTYOJpQU.js';
-import { D as DeviceOption } from '../../types-DGyDHiJV.js';
+import { D as DeviceOption } from '../../types-DT8ywrFQ.js';
 import { P as Place } from '../../types-41704JE4.js';
 import { M as MeasuredCanvas, C as CanvasDragModel } from '../../CanvasDragLayer-dZCPbQCP.js';
 import { E as EaselContextMenuItem } from '../../types-BsyPh6EW.js';
-import { a as EaselRailItem } from '../../types-CsgMwHHa.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-DGmdCaNL.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-NQozKWEz.js';
+import '../../types-Cq53lL8d.js';
 import '../../data/index.js';
 import '../../resolve-D68pb3Bx.js';
-import '../../plan-CGREINRO.js';
+import '../../plan-CZS902DV.js';
 import '../../edit-lock/index.js';
 import '../../panelWidths-D9hTLR25.js';
 import '../../session-DSQFmIvx.js';
@@ -518,28 +519,6 @@ interface ScreenBridges {
      *  from that part's own panel. A layer with nowhere to keep them hands none,
      *  and the panel draws no door. */
     openStyles?: () => void;
-    /**
-     * The open document is the one that STORES what the layer pins: the node
-     * every other document shows pinned and does not hold (the website's: the
-     * page that keeps the site's one footer). It is edited there in place, so
-     * the screen draws that document's tree without the rows an ordinary one has
-     * round its own sections, and without the row that leads to it. Absent, the
-     * document is an ordinary one.
-     */
-    pinnedSource?: boolean;
-    /** …and the way to edit what is pinned from a document that only shows it:
-     *  what a press on its row in the tree does. Where it leads is the layer's
-     *  (the website opens its footer's editor over the page). */
-    editPinnedSource?: () => void;
-    /**
-     * The layer's own way to bring the canvas to a node the screen has selected,
-     * for a document where the screen's plain scroll does not hold: one the
-     * layer draws something above, which reflows and takes the scroll back (the
-     * website's footer, edited under the page it was opened from). Handed back
-     * only for such a document, and the screen then calls it in place of its
-     * scroll; absent, the screen scrolls.
-     */
-    holdCanvasOn?: (id: string) => void;
     /**
      * THE LAYER'S OWN ROWS IN A NODE'S RIGHT-CLICK MENU (0.105.0), by the group
      * each joins (`ScreenMenuRows`): the campaign designer's "Check this image
@@ -555,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
@@ -1109,6 +1113,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
@@ -1473,4 +1515,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-U25CP5VX.js";import"../../chunk-R6WTQWAC.js";import"../../chunk-U3JP4VGF.js";import"../../chunk-PLVEGYK6.js";import"../../chunk-QX7GVECM.js";import"../../chunk-TBY3DFKS.js";import"../../chunk-ECM5F6JJ.js";import"../../chunk-K6EM4F5N.js";import"../../chunk-BPXEFVSQ.js";import"../../chunk-XWFH2NHZ.js";import"../../chunk-4JSBIW5H.js";import"../../chunk-K56YDHYQ.js";import"../../chunk-BALFHI3G.js";import"../../chunk-RC25EGHD.js";import"../../chunk-KFV7N2DJ.js";import"../../chunk-67GNT6PF.js";import"../../chunk-P2VEMZH5.js";import"../../chunk-YRLPFZW3.js";import"../../chunk-X4T6JT3M.js";import"../../chunk-KRXQM65X.js";import"../../chunk-NKB3KVAB.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";
+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-XHSGRH42.js";import"../../chunk-R6WTQWAC.js";import"../../chunk-U3JP4VGF.js";import"../../chunk-PLVEGYK6.js";import"../../chunk-QEAUF632.js";import"../../chunk-TBY3DFKS.js";import"../../chunk-5VD2LGIZ.js";import"../../chunk-BPXEFVSQ.js";import"../../chunk-A6Z4SD3I.js";import"../../chunk-BALFHI3G.js";import"../../chunk-K56YDHYQ.js";import"../../chunk-XWFH2NHZ.js";import"../../chunk-YRLPFZW3.js";import"../../chunk-RC25EGHD.js";import"../../chunk-KFV7N2DJ.js";import"../../chunk-X3TYRF5V.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-NQozKWEz.js';
+import '../../types-Cq53lL8d.js';
 import '../../data/index.js';
 import '../../types-41704JE4.js';
 import '../../resolve-D68pb3Bx.js';
-import '../../plan-CGREINRO.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-NQozKWEz.js';
+import '../../types-Cq53lL8d.js';
 import '../../data/index.js';
 import '../../types-41704JE4.js';
 import '../../resolve-D68pb3Bx.js';
-import '../../plan-CGREINRO.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-NQozKWEz.js';
+import '../../types-Cq53lL8d.js';
 import '../../data/index.js';
 import '../../types-41704JE4.js';
 import '../../resolve-D68pb3Bx.js';
-import '../../plan-CGREINRO.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};