efficient-easel 0.102.0 → 0.104.0

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

@@ -1,4 +1,5 @@
 import { Config } from '../../blocks/index.js';
+import { HostFailures } from './backend-error.js';
 import { EaselChrome } from './host-chrome.js';
 import { WebsiteEditLock } from './document-contract.js';
 import { EaselDocumentHooks } from './document-hooks.js';
@@ -9,6 +10,7 @@ import '../../data/index.js';
 import '../../types-41704JE4.js';
 import '../../resolve-D68pb3Bx.js';
 import '../../plan-DChbUXdS.js';
+import '../../edit-lock/index.js';
 import './links/link-filters.js';
 import '../../LinkPicker-W2Rtxetz.js';
 import './puck/content-tree.js';
@@ -38,6 +40,17 @@ import './puck/content-tree.js';
  * editor's last writes — the autosave's flush on unmount, the lock's release —
  * on its own backend and token while the next editor is already mounting.
  *
+ * AN EDITOR BESIDE IT (0.103.0). The admin portal mounts the campaign designer
+ * in one window while the website editor is open in another, in one page. The
+ * designer's session is made with `claimsPage: false`: it never becomes "the
+ * editor on this page", so the website's loaders and HTTP client go on reading
+ * the website's session (its token, its site, its backend), and the designer
+ * reads its own only through its provider and what it is handed to. What used
+ * to be one per page and is a host's own — the backend a session falls back on,
+ * how a host's client errors read — a session may carry for itself
+ * (`defaultBackend`, `hostFailures`), so the second host never has to replace
+ * the first host's page-wide registration to bring its own.
+ *
  * WHERE NO EDITOR IS MOUNTED — the shop's own pages, a dev harness, a guard —
  * there is the AMBIENT session: the EFFICIENT client, no token until somebody
  * sets one. That is exactly what the old singletons were.
@@ -141,6 +154,28 @@ interface EaselSession {
      * blocks — or null when it does nothing. Read once, with the backend.
      */
     readonly documentHooks: EaselDocumentHooks | null;
+    /**
+     * Whether this session is THE EDITOR ON THIS PAGE while it is mounted
+     * (0.103.0): the one {@link currentEaselSession} answers, which code outside
+     * the editor's React tree reads — a host's loaders, its HTTP client — and
+     * the holder of what the page has one of (the tab's block clipboard,
+     * components/NodeContextMenu). True, as every session was before.
+     *
+     * False for an editor mounted BESIDE the page's (the campaign designer in
+     * the admin, beside the website editor): mounting it leaves the page's
+     * current session as it was, it is read only through its provider
+     * (`useEaselSession`) and what it is handed to, and it keeps a block
+     * clipboard of its own registry's.
+     */
+    readonly claimsPage: boolean;
+    /**
+     * How the host's own client errors read, for this session's editor alone
+     * (lib/backend-error `HostFailures`, 0.103.0) — or null, and it reads them
+     * as the page's host said (`provideHostFailures`), as before. A host
+     * mounted beside another brings its own here rather than replacing the
+     * page's: the two are told apart by whose editor a failure happened in.
+     */
+    readonly hostFailures: HostFailures | null;
     /** The console's sign-in: the admin JWT and the legacy brand scope. */
     readonly auth: {
         token: string | null;
@@ -172,13 +207,16 @@ type DefaultBackend = (session: EaselSession) => SessionBackend;
  * A registration rather than an import, because the direction matters: the
  * editor is the builder's and a host's client is the host's (doc/adr/0002).
  * It is one default for the app, not a choice per editor — an embedder that
- * wants another backend for one editor passes `backend`, as before.
+ * wants another backend for one editor passes `backend`, as before, or a
+ * default of that session's own (`createEaselSession({ defaultBackend })`,
+ * 0.103.0), which this one never replaces and is never replaced by.
  */
 declare function provideDefaultBackend(make: DefaultBackend): void;
 /**
  * The backend one editor session talks to: the embedder's own when it supplied
- * one, else the host's default — one client per session, built the first time
- * it is asked for and bound to THAT session's token and website.
+ * one, else the session's own default when it was made with one, else the
+ * host's page-wide default — one client per session, built the first time it
+ * is asked for and bound to THAT session's token and website.
  *
  * Throws when there is neither: an editor with no backend can load and save
  * nothing, and falling back to "no pages" would look like an empty website.
@@ -200,18 +238,33 @@ declare function createEaselSession(options?: {
     registry?: Config | null;
     chrome?: EaselChrome | null;
     documentHooks?: EaselDocumentHooks | null;
+    /** Is this the editor on this page while it is mounted? Default true; see
+     *  {@link EaselSession.claimsPage}. */
+    claimsPage?: boolean;
+    /** What makes this session's backend when `backend` is not given, in
+     *  place of the page's (`provideDefaultBackend`), bound to this session.
+     *  Default: the page's. A backend it makes waits for the console's token
+     *  only when it is the EFFICIENT client (`EFFICIENT_BACKEND`). */
+    defaultBackend?: DefaultBackend | null;
+    /** How this session's host client errors read; default the page's. See
+     *  {@link EaselSession.hostFailures}. */
+    hostFailures?: HostFailures | null;
 }): EaselSession;
 /** Record the website a session's open document belongs to. */
 declare function setSessionDocumentSite(session: EaselSession, siteId: string | null | undefined): void;
 /** Record the website the host bridged in with an auth grant. */
 declare function setSessionBridgedSite(session: EaselSession, siteId: string | null | undefined): void;
-/** The session of the editor mounted on this page — the ambient one when none is. */
+/** The session of the editor mounted on this page — the ambient one when none is.
+ *  Never a session made with `claimsPage: false`, mounted or not. */
 declare function currentEaselSession(): EaselSession;
 /**
  * Make `session` the page's current one. IDEMPOTENT, and called from two places
  * on purpose: while the editor RENDERS (so a child's effect — which runs before
  * its parent's — already reads the right session) and from the editor's own
  * effect (which is what survives React StrictMode's mount, unmount, mount).
+ *
+ * A session that does not claim the page (`claimsPage: false`) is left out,
+ * whoever asks: the editor beside the page's never takes its place.
  */
 declare function activateEaselSession(session: EaselSession): void;
 /**
@@ -252,4 +305,4 @@ declare function efficientClientOpen(): boolean;
 /** Start the ambient session again from nothing (tests; a guard between cases). */
 declare function resetAmbientEaselSession(): void;
 
-export { EFFICIENT_BACKEND, type EaselSession, type SessionBackend, type SessionBlocks, activateEaselSession, backendOf, createEaselSession, currentEaselSession, deactivateEaselSession, efficientClientOpen, isEfficientBackend, provideDefaultBackend, resetAmbientEaselSession, sessionRegistry, setSessionBridgedSite, setSessionDocumentSite };
+export { type DefaultBackend, EFFICIENT_BACKEND, type EaselSession, type SessionBackend, type SessionBlocks, activateEaselSession, backendOf, createEaselSession, currentEaselSession, deactivateEaselSession, efficientClientOpen, isEfficientBackend, provideDefaultBackend, resetAmbientEaselSession, sessionRegistry, setSessionBridgedSite, setSessionDocumentSite };

package/dist/screen/lib/session.js

@@ -1 +1 @@
-export{EFFICIENT_BACKEND,activateEaselSession,backendOf,createEaselSession,currentEaselSession,deactivateEaselSession,efficientClientOpen,isEfficientBackend,provideDefaultBackend,resetAmbientEaselSession,sessionRegistry,setSessionBridgedSite,setSessionDocumentSite}from"../../chunk-AJBJ74ME.js";
+export{EFFICIENT_BACKEND,activateEaselSession,backendOf,createEaselSession,currentEaselSession,deactivateEaselSession,efficientClientOpen,isEfficientBackend,provideDefaultBackend,resetAmbientEaselSession,sessionRegistry,setSessionBridgedSite,setSessionDocumentSite}from"../../chunk-RSCMJIWS.js";

package/dist/screen/screen.css

@@ -8,6 +8,11 @@
  * the screen (that repo's doc/adr/0004): a rule is here when every `sf-` class
  * it names is drawn by the screen, so every host that mounts the screen gets
  * it; a rule that names a class only a host draws stays in that host's sheet.
+ * A `data-sf-*` marker the screen's own modules paint counts the same way: the
+ * rule that gives it its meaning is here (0.103.0), since a marker no sheet
+ * reads is a box that still takes its space. `tests/screen-css-closure` mounts
+ * the screen with easel's sheets alone and holds every class and marker it
+ * draws to a rule in them.
  * The `sf-` names are kept: the hosts' sheets and their guards address them.
  *
  * Load it after the other easel sheets and before a host's own sheet, which is
@@ -953,6 +958,15 @@
   line-height: 1;
 }
 
+/* ── Device-aware fields (lib/puck/device-fields.tsx) ─────────────────────────
+   A control that belongs to a device the canvas is not showing paints a
+   zero-size marker instead of itself, and its row (efficient-easel's public
+   `.es-insp-row`, blueprint 4.4) collapses when it holds one, so no gap is left.
+   One declarative rule; the row's own "nothing drawn" case is `:empty`. */
+.es-insp-row:has(> [data-sf-device-hidden]) {
+  display: none !important;
+}
+
 /* ── NO DIVIDER HAIRLINES IN THIS PANEL (card 66334) ──────────────────────────
    The owner asked for these lines to go twice. Deleting our own was only part of
    it: the rule below is drawn by a PACKAGE, it is the majority of what is

package/dist/screen/words.d.ts

@@ -0,0 +1,65 @@
+/**
+ * The assembled screen's own words (`efficient-easel/strings`, group
+ * `screen`): what it says while a document opens, what it says when one will
+ * not, the word it calls the document in the edit notice, and the words of
+ * the Layers tree's frame round the document's nodes (0.103.0): its first
+ * row, the pinned groups, the band of sections and the band's "+".
+ *
+ * They came with the screen from the website editor, written into the
+ * provider, the mount and the notice; a second host (the campaign designer)
+ * opens campaigns, not storefront pages, and says so in its own words. So the
+ * defaults are the website's English, word for word, and a host lays its own
+ * over them with `EaselStringsProvider`.
+ *
+ * A plain module with no import: the catalogue reads it, and the catalogue
+ * imports nothing (`tests/strings-leaf-safety.test.ts`). Anything with a value
+ * in it is a function.
+ *
+ * What a sentence for a MISSING document is can also depend on the target, and
+ * that is the layer's to say (`DocumentAddressing.describeMissing`): these are
+ * the words the screen says when the layer says none.
+ */
+type ScreenWords = {
+    /** While the document is on its way, and while an entry may still bounce. */
+    loading: string;
+    /** Before the console's sign-in has reached an editor that needs it. */
+    waitingForAuthorization: string;
+    /** A website template's page that could not be opened. */
+    missingTemplatePage: string;
+    /** A website page that is not there, by the slug it was asked for. */
+    missingPage: (v: {
+        slug: string;
+    }) => string;
+    /** A host's own document (`{ kind: "document" }`) that is not there. */
+    missingDocument: string;
+    /** A load that failed: the plain lead-in, then what came back (`cause`). */
+    loadFailed: (v: {
+        cause: string;
+    }) => string;
+    /** What the document is called in the edit notice's sentences ("this page"). */
+    noun: string;
+    /** The Layers tree's first row: the document's own settings, with nothing
+     *  selected. */
+    pageSettings: string;
+    /** The group label over the node pinned first, and the name of its row
+     *  where the layer names it none. */
+    header: string;
+    /** …and over the node pinned last. */
+    footer: string;
+    /** The label over the band of sections on a document with the edit guard
+     *  (a website's page), where the layer gives the band none of its own. */
+    pageSections: string;
+    /** …and on a document without it (a website's template). */
+    templateSections: string;
+    /** The row that ends a band which offers one (`band.addAtEnd`). */
+    addSection: string;
+    /** The "+" in the gap above a section, named by the section it lands before. */
+    addSectionBefore: (v: {
+        name: string;
+    }) => string;
+    /** …and in a gap with no section after it. */
+    addSectionHere: string;
+};
+declare const DEFAULT_SCREEN_WORDS: ScreenWords;
+
+export { DEFAULT_SCREEN_WORDS, type ScreenWords };

package/dist/screen/words.js

@@ -0,0 +1 @@
+export{DEFAULT_SCREEN_WORDS}from"../chunk-LEGAPYPC.js";

package/dist/strings/catalogue.d.ts

@@ -7,6 +7,7 @@ import { F as FieldsWords } from '../words-D8kf071T.js';
 import { N as NodeMenuWords } from '../words-DMG4dYq2.js';
 import { P as PanelWords } from '../words-BGrHZAJJ.js';
 import { P as PickWords } from '../words-is_Vy6hn.js';
+import { ScreenWords } from '../screen/words.js';
 import { S as StyleClipboardWords } from '../words-CnnHb9jo.js';
 import { T as TextStylesWords } from '../words-CRYvAiHX.js';
 import { T as TreeWords } from '../words-DgHcY5qB.js';
@@ -51,7 +52,10 @@ type RailWords = {
  * Every word and sentence this package itself draws or returns — visible text,
  * `aria-label`s, tooltips, placeholders — is an entry here, grouped by the
  * module that says it. What a HOST supplies (a block's name, a field's label, a
- * tile's caption, the document's noun) was never the engine's and is not here.
+ * tile's caption, the document's noun) was never the engine's and is not here —
+ * with one exception: the assembled screen (`efficient-easel/screen`) draws the
+ * edit notice itself, so the noun it says it with is a word of its own group,
+ * the website's "page" until a host says another.
  *
  *   - A plain word is a `string`.
  *   - Anything with a value in it, or a count that can be one or many, is a
@@ -106,6 +110,9 @@ interface EaselStrings {
     canvas: CanvasWords;
     /** `efficient-easel/text-styles` — the Email styles / Site styles list (E6). */
     textStyles: TextStylesWords;
+    /** `efficient-easel/screen` — a document opening, one that will not, and the
+     *  notice's word for the document. */
+    screen: ScreenWords;
 }
 /** Today's English, word for word. */
 declare const DEFAULT_EASEL_STRINGS: EaselStrings;
@@ -124,4 +131,4 @@ type DeepPartial<T> = T extends (...args: never[]) => unknown ? T : T extends ob
  */
 declare function mergeEaselStrings(defaults: EaselStrings, partial?: DeepPartial<EaselStrings> | null): EaselStrings;
 
-export { type CanvasWords, ChromeWords, CopyWords, DEFAULT_EASEL_STRINGS, type DeepPartial, DragWords, type EaselStrings, FieldsWords, LockWords, NodeMenuWords, NoticeWords, PanelWords, PickWords, type RailWords, SaveWords, StyleClipboardWords, TextStylesWords, TreeWords, mergeEaselStrings };
+export { type CanvasWords, ChromeWords, CopyWords, DEFAULT_EASEL_STRINGS, type DeepPartial, DragWords, type EaselStrings, FieldsWords, LockWords, NodeMenuWords, NoticeWords, PanelWords, PickWords, type RailWords, SaveWords, ScreenWords, StyleClipboardWords, TextStylesWords, TreeWords, mergeEaselStrings };

package/dist/strings/catalogue.js

@@ -1 +1 @@
-export{DEFAULT_EASEL_STRINGS,mergeEaselStrings}from"../chunk-UH7TGWHR.js";import"../chunk-M6F6LS3H.js";import"../chunk-6WY6ZXJG.js";import"../chunk-AELNNAFM.js";import"../chunk-3EDSDPIP.js";import"../chunk-QTLAVDJE.js";import"../chunk-WK3AFPXY.js";import"../chunk-H6DDIBQ4.js";import"../chunk-UH7IGZKF.js";import"../chunk-ZAOM6PFH.js";import"../chunk-FPOKPNO4.js";import"../chunk-546BBOPE.js";import"../chunk-ZJEBF4NB.js";import"../chunk-RE4LP46F.js";import"../chunk-2OAZYSWJ.js";import"../chunk-O2NLQBFX.js";
+export{DEFAULT_EASEL_STRINGS,mergeEaselStrings}from"../chunk-QCBWT2XE.js";import"../chunk-M6F6LS3H.js";import"../chunk-6WY6ZXJG.js";import"../chunk-LEGAPYPC.js";import"../chunk-AELNNAFM.js";import"../chunk-3EDSDPIP.js";import"../chunk-QTLAVDJE.js";import"../chunk-WK3AFPXY.js";import"../chunk-H6DDIBQ4.js";import"../chunk-ZJEBF4NB.js";import"../chunk-RE4LP46F.js";import"../chunk-2OAZYSWJ.js";import"../chunk-UH7IGZKF.js";import"../chunk-ZAOM6PFH.js";import"../chunk-FPOKPNO4.js";import"../chunk-546BBOPE.js";import"../chunk-O2NLQBFX.js";

package/dist/strings/index.d.ts

@@ -11,6 +11,7 @@ export { N as NodeMenuWords } from '../words-DMG4dYq2.js';
 export { P as PanelWords } from '../words-BGrHZAJJ.js';
 export { P as PickWords } from '../words-is_Vy6hn.js';
 export { S as SaveWords } from '../words-D_Lnw1Gr.js';
+export { ScreenWords } from '../screen/words.js';
 export { S as StyleClipboardWords } from '../words-CnnHb9jo.js';
 export { T as TextStylesWords } from '../words-CRYvAiHX.js';
 export { T as TreeWords } from '../words-DgHcY5qB.js';

package/dist/strings/index.js

@@ -1,2 +1,2 @@
-import{DEFAULT_EASEL_STRINGS as r,mergeEaselStrings as n}from"../chunk-UH7TGWHR.js";export{DEFAULT_EASEL_STRINGS,mergeEaselStrings}from"../chunk-UH7TGWHR.js";import"../chunk-M6F6LS3H.js";import"../chunk-6WY6ZXJG.js";import"../chunk-AELNNAFM.js";import"../chunk-3EDSDPIP.js";import"../chunk-QTLAVDJE.js";import"../chunk-WK3AFPXY.js";import"../chunk-H6DDIBQ4.js";import"../chunk-UH7IGZKF.js";import"../chunk-ZAOM6PFH.js";import"../chunk-FPOKPNO4.js";import"../chunk-546BBOPE.js";import"../chunk-ZJEBF4NB.js";import"../chunk-RE4LP46F.js";import"../chunk-2OAZYSWJ.js";import{stringsContext as o}from"../chunk-MFIRYGHW.js";import"../chunk-O2NLQBFX.js";import{useContext as t,useMemo as c}from"react";import{jsx as i}from"react/jsx-runtime";function s({value:s,locale:u,children:m}){const e=o(),p=t(e),h=p?.strings??r,j=u??p?.locale??"en",k=c(()=>({strings:n(h,s),locale:j}),[h,s,j]);/* @__PURE__ */
+import{DEFAULT_EASEL_STRINGS as r,mergeEaselStrings as n}from"../chunk-QCBWT2XE.js";export{DEFAULT_EASEL_STRINGS,mergeEaselStrings}from"../chunk-QCBWT2XE.js";import"../chunk-M6F6LS3H.js";import"../chunk-6WY6ZXJG.js";import"../chunk-LEGAPYPC.js";import"../chunk-AELNNAFM.js";import"../chunk-3EDSDPIP.js";import"../chunk-QTLAVDJE.js";import"../chunk-WK3AFPXY.js";import"../chunk-H6DDIBQ4.js";import"../chunk-ZJEBF4NB.js";import"../chunk-RE4LP46F.js";import"../chunk-2OAZYSWJ.js";import"../chunk-UH7IGZKF.js";import"../chunk-ZAOM6PFH.js";import"../chunk-FPOKPNO4.js";import"../chunk-546BBOPE.js";import{stringsContext as o}from"../chunk-MFIRYGHW.js";import"../chunk-O2NLQBFX.js";import{useContext as t,useMemo as c}from"react";import{jsx as i}from"react/jsx-runtime";function s({value:s,locale:u,children:m}){const e=o(),p=t(e),h=p?.strings??r,j=u??p?.locale??"en",k=c(()=>({strings:n(h,s),locale:j}),[h,s,j]);/* @__PURE__ */
 return i(e.Provider,{value:k,children:m})}function u(){return t(o())?.strings??r}function m(){return t(o())?.locale??"en"}export{s as EaselStringsProvider,m as useEaselLocale,u as useEaselStrings};

package/dist/tree/index.d.ts

@@ -1,145 +1,7 @@
 import * as react from 'react';
-import { ReactNode, HTMLAttributes, ButtonHTMLAttributes } from 'react';
-import { T as TreeWords } from '../words-DgHcY5qB.js';
-
-type LayersTreeProps = {
-    /** Extra classes — a host's scroll-bar class, for instance. */
-    className?: string;
-    children?: ReactNode;
-    /** Attributes for the tree's root — `efficient-easel/drag`'s `rootProps()`. */
-    rootProps?: HTMLAttributes<HTMLDivElement>;
-};
-type TreeGroupLabelProps = {
-    children: ReactNode;
-};
-type SubtreeProps = {
-    children?: ReactNode;
-};
-type TreeRowFold = {
-    /** Whether the row's subtree is showing. */
-    open: boolean;
-    /** What folds, in lower case — "section", "column". The caret reads "Collapse section". */
-    label: string;
-    onToggle: () => void;
-};
-type TreeRowProps = {
-    /** A 13px glyph for the row's type. */
-    icon: ReactNode;
-    /** The row's name — the type's label, or a name the person gave it. */
-    name: ReactNode;
-    /**
-     * The thing's own first words, drawn quieter after the name — "Text  BACK IN
-     * STOCK NOW". NEW in 0.42.0: a tree of fifteen rows called "Section" cannot be
-     * searched by eye. The host decides the words and shortens them.
-     */
-    preview?: ReactNode;
-    selected?: boolean;
-    /** Hidden from the page: the name is struck through and the eye stays showing. */
-    hidden?: boolean;
-    /**
-     * The row can be picked up — whole, by `efficient-easel/drag` (0.74.0). It says
-     * so four ways: a faint ⋮ at its left on hover, the grab cursor, a hint after
-     * 0.7 s ("Drag to move · ⌥↑ ⌥↓"), and the row lifted with a shadow while it
-     * moves. A draggable row draws no `handle`: the row IS the handle.
-     */
-    draggable?: boolean;
-    /** The hint a draggable row shows after 0.7 s. Default `words.dragHint`: "Drag to move · ⌥↑ ⌥↓". */
-    dragHint?: string;
-    /** This row is being dragged. */
-    dragging?: boolean;
-    /** Where a drop would land relative to this row, while a drag is over it. */
-    drop?: 'before' | 'after' | 'into';
-    /** Present when the row folds; the row leads with its caret. Absent: the caret column is held open. */
-    fold?: TreeRowFold;
-    /**
-     * Props for the drag handle button (the host's drag-and-drop wiring). Absent:
-     * no handle. The handle is the ONLY drag source, so it is hidden with opacity
-     * and never made unreachable.
-     *
-     * @deprecated since 0.74.0 — a row driven by `efficient-easel/drag` is picked
-     * up whole (`draggable`), and a draggable row draws no handle. Kept until both
-     * editors have moved (blueprint 3.3 / 3.4).
-     */
-    handle?: ButtonHTMLAttributes<HTMLButtonElement>;
-    /** `TreeRowAction`s — laid over the END of the name, shown on hover and focus. */
-    actions?: ReactNode;
-    /** Stands in for the name — a rename box. It must not move the row by a pixel. */
-    nameSlot?: ReactNode;
-    /**
-     * Selects the row. Present: the name box becomes a real <button> — Enter and
-     * Space select from the keyboard — and a selected row says `aria-current`.
-     * Absent: the row selects through `rowProps.onClick`, as 0.42.0 did.
-     */
-    onSelect?: () => void;
-    /** Named state glyphs drawn right after the name — "Hidden on phones". */
-    marks?: ReadonlyArray<TreeRowMark>;
-    /** A count or position pill after the name — "1 of 2". */
-    badge?: ReactNode;
-    /** A non-interactive mark at the row's end — the Lock on a pinned section. */
-    trailing?: {
-        label: string;
-        icon: ReactNode;
-    };
-    /** Drawn inside the row after everything else: overlays such as a drop line. */
-    children?: ReactNode;
-    /** Attributes for the row itself: onClick, drag-over handlers, data-*. */
-    rowProps?: HTMLAttributes<HTMLDivElement> & Record<`data-${string}`, string | number | undefined>;
-    /**
-     * The row's own words — the drag hint and the caret's — in the host's
-     * language: `useEaselStrings().tree` (0.95.0). Left out, English. `dragHint`
-     * above still wins for its one line.
-     */
-    words?: TreeWords;
-};
-type TreeRowMark = {
-    key: string;
-    /** Tooltip and accessible name — the mark is a picture of a state. */
-    label: string;
-    icon: ReactNode;
-};
-type TreeRowActionProps = {
-    /**
-     * `delete` is the red trash; `eye` shows or hides; `plain` is any other action
-     * (a phone toggle, "Duplicate column") in the neutral colour.
-     */
-    kind: 'delete' | 'eye' | 'plain';
-    /** For a toggle: whether it is on. Adds aria-pressed and keeps it visible at rest. */
-    pressed?: boolean;
-    disabled?: boolean;
-    /** Tooltip and accessible name — "Delete Text", "Show Section". */
-    label: string;
-    onClick: () => void;
-    children: ReactNode;
-};
-type TreeEmptySlotProps = {
-    /** A drag is over the slot and may land in it: it lights up and says "Drop here". */
-    drop?: boolean;
-    /** Present: the box is a button that adds here (it opens the Add panel at this place). */
-    onAdd?: () => void;
-    /**
-     * What the box says at rest. Default `words.addBlock` ("Add a block") with
-     * `onAdd`, `words.emptySlot` ("No blocks yet") without.
-     */
-    label?: string;
-    /**
-     * The drag handlers — `efficient-easel/drag`'s
-     * `seam({ place: { ...list, index: 0 } }).seamProps`: an empty list has one
-     * place, its start.
-     */
-    seamProps?: HTMLAttributes<HTMLDivElement>;
-    /** The box's own words in the host's language: `useEaselStrings().tree`. Left out, English. */
-    words?: TreeWords;
-};
-type TreeSeamProps = {
-    /** A drag is over this gap and may land in it: draw the drop line. */
-    drop?: boolean;
-    /** Present: the gap offers a "+" that adds here (it opens the Add panel at this place). */
-    onAdd?: () => void;
-    /** The "+"'s accessible name and tooltip — "Add block here". Required with `onAdd`. */
-    label?: string;
-    /** The drag handlers — `efficient-easel/drag`'s `seam(…).seamProps`. */
-    seamProps?: HTMLAttributes<HTMLDivElement>;
-};
+import { L as LayersTreeProps, S as SubtreeProps, a as TreeGroupLabelProps, b as TreeEmptySlotProps, c as TreeRowProps, d as TreeRowActionProps, e as TreeSeamProps } from '../types-DJDBtdB2.js';
+export { f as TreeRowFold, T as TreeRowMark } from '../types-DJDBtdB2.js';
+export { T as TreeWords } from '../words-DgHcY5qB.js';
 
 /**
  * The Layers tree's container. It declares the TREE's own rhythm — 10px above a
@@ -211,4 +73,4 @@ declare function TreeSeam({ drop, onAdd, label, seamProps }: TreeSeamProps): rea
  */
 declare function TreeEmptySlot({ drop, onAdd, label, seamProps, words }: TreeEmptySlotProps): react.JSX.Element;
 
-export { LayersTree, type LayersTreeProps, Subtree, type SubtreeProps, TREE_DRAG_HINT, TreeEmptySlot, type TreeEmptySlotProps, TreeGroupLabel, type TreeGroupLabelProps, TreeRow, TreeRowAction, type TreeRowActionProps, type TreeRowFold, type TreeRowMark, type TreeRowProps, TreeSeam, type TreeSeamProps, TreeWords };
+export { LayersTree, LayersTreeProps, Subtree, SubtreeProps, TREE_DRAG_HINT, TreeEmptySlot, TreeEmptySlotProps, TreeGroupLabel, TreeGroupLabelProps, TreeRow, TreeRowAction, TreeRowActionProps, TreeRowProps, TreeSeam, TreeSeamProps };

package/dist/types-DJDBtdB2.d.ts

@@ -0,0 +1,143 @@
+import { ReactNode, HTMLAttributes, ButtonHTMLAttributes } from 'react';
+import { T as TreeWords } from './words-DgHcY5qB.js';
+
+type LayersTreeProps = {
+    /** Extra classes — a host's scroll-bar class, for instance. */
+    className?: string;
+    children?: ReactNode;
+    /** Attributes for the tree's root — `efficient-easel/drag`'s `rootProps()`. */
+    rootProps?: HTMLAttributes<HTMLDivElement>;
+};
+type TreeGroupLabelProps = {
+    children: ReactNode;
+};
+type SubtreeProps = {
+    children?: ReactNode;
+};
+type TreeRowFold = {
+    /** Whether the row's subtree is showing. */
+    open: boolean;
+    /** What folds, in lower case — "section", "column". The caret reads "Collapse section". */
+    label: string;
+    onToggle: () => void;
+};
+type TreeRowProps = {
+    /** A 13px glyph for the row's type. */
+    icon: ReactNode;
+    /** The row's name — the type's label, or a name the person gave it. */
+    name: ReactNode;
+    /**
+     * The thing's own first words, drawn quieter after the name — "Text  BACK IN
+     * STOCK NOW". NEW in 0.42.0: a tree of fifteen rows called "Section" cannot be
+     * searched by eye. The host decides the words and shortens them.
+     */
+    preview?: ReactNode;
+    selected?: boolean;
+    /** Hidden from the page: the name is struck through and the eye stays showing. */
+    hidden?: boolean;
+    /**
+     * The row can be picked up — whole, by `efficient-easel/drag` (0.74.0). It says
+     * so four ways: a faint ⋮ at its left on hover, the grab cursor, a hint after
+     * 0.7 s ("Drag to move · ⌥↑ ⌥↓"), and the row lifted with a shadow while it
+     * moves. A draggable row draws no `handle`: the row IS the handle.
+     */
+    draggable?: boolean;
+    /** The hint a draggable row shows after 0.7 s. Default `words.dragHint`: "Drag to move · ⌥↑ ⌥↓". */
+    dragHint?: string;
+    /** This row is being dragged. */
+    dragging?: boolean;
+    /** Where a drop would land relative to this row, while a drag is over it. */
+    drop?: 'before' | 'after' | 'into';
+    /** Present when the row folds; the row leads with its caret. Absent: the caret column is held open. */
+    fold?: TreeRowFold;
+    /**
+     * Props for the drag handle button (the host's drag-and-drop wiring). Absent:
+     * no handle. The handle is the ONLY drag source, so it is hidden with opacity
+     * and never made unreachable.
+     *
+     * @deprecated since 0.74.0 — a row driven by `efficient-easel/drag` is picked
+     * up whole (`draggable`), and a draggable row draws no handle. Kept until both
+     * editors have moved (blueprint 3.3 / 3.4).
+     */
+    handle?: ButtonHTMLAttributes<HTMLButtonElement>;
+    /** `TreeRowAction`s — laid over the END of the name, shown on hover and focus. */
+    actions?: ReactNode;
+    /** Stands in for the name — a rename box. It must not move the row by a pixel. */
+    nameSlot?: ReactNode;
+    /**
+     * Selects the row. Present: the name box becomes a real <button> — Enter and
+     * Space select from the keyboard — and a selected row says `aria-current`.
+     * Absent: the row selects through `rowProps.onClick`, as 0.42.0 did.
+     */
+    onSelect?: () => void;
+    /** Named state glyphs drawn right after the name — "Hidden on phones". */
+    marks?: ReadonlyArray<TreeRowMark>;
+    /** A count or position pill after the name — "1 of 2". */
+    badge?: ReactNode;
+    /** A non-interactive mark at the row's end — the Lock on a pinned section. */
+    trailing?: {
+        label: string;
+        icon: ReactNode;
+    };
+    /** Drawn inside the row after everything else: overlays such as a drop line. */
+    children?: ReactNode;
+    /** Attributes for the row itself: onClick, drag-over handlers, data-*. */
+    rowProps?: HTMLAttributes<HTMLDivElement> & Record<`data-${string}`, string | number | undefined>;
+    /**
+     * The row's own words — the drag hint and the caret's — in the host's
+     * language: `useEaselStrings().tree` (0.95.0). Left out, English. `dragHint`
+     * above still wins for its one line.
+     */
+    words?: TreeWords;
+};
+type TreeRowMark = {
+    key: string;
+    /** Tooltip and accessible name — the mark is a picture of a state. */
+    label: string;
+    icon: ReactNode;
+};
+type TreeRowActionProps = {
+    /**
+     * `delete` is the red trash; `eye` shows or hides; `plain` is any other action
+     * (a phone toggle, "Duplicate column") in the neutral colour.
+     */
+    kind: 'delete' | 'eye' | 'plain';
+    /** For a toggle: whether it is on. Adds aria-pressed and keeps it visible at rest. */
+    pressed?: boolean;
+    disabled?: boolean;
+    /** Tooltip and accessible name — "Delete Text", "Show Section". */
+    label: string;
+    onClick: () => void;
+    children: ReactNode;
+};
+type TreeEmptySlotProps = {
+    /** A drag is over the slot and may land in it: it lights up and says "Drop here". */
+    drop?: boolean;
+    /** Present: the box is a button that adds here (it opens the Add panel at this place). */
+    onAdd?: () => void;
+    /**
+     * What the box says at rest. Default `words.addBlock` ("Add a block") with
+     * `onAdd`, `words.emptySlot` ("No blocks yet") without.
+     */
+    label?: string;
+    /**
+     * The drag handlers — `efficient-easel/drag`'s
+     * `seam({ place: { ...list, index: 0 } }).seamProps`: an empty list has one
+     * place, its start.
+     */
+    seamProps?: HTMLAttributes<HTMLDivElement>;
+    /** The box's own words in the host's language: `useEaselStrings().tree`. Left out, English. */
+    words?: TreeWords;
+};
+type TreeSeamProps = {
+    /** A drag is over this gap and may land in it: draw the drop line. */
+    drop?: boolean;
+    /** Present: the gap offers a "+" that adds here (it opens the Add panel at this place). */
+    onAdd?: () => void;
+    /** The "+"'s accessible name and tooltip — "Add block here". Required with `onAdd`. */
+    label?: string;
+    /** The drag handlers — `efficient-easel/drag`'s `seam(…).seamProps`. */
+    seamProps?: HTMLAttributes<HTMLDivElement>;
+};
+
+export type { LayersTreeProps as L, SubtreeProps as S, TreeRowMark as T, TreeGroupLabelProps as a, TreeEmptySlotProps as b, TreeRowProps as c, TreeRowActionProps as d, TreeSeamProps as e, TreeRowFold as f };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "efficient-easel",
-  "version": "0.102.0",
+  "version": "0.104.0",
   "description": "Efficient Easel: the EFFICIENT editors' shared engine and chrome: the saved document as pure functions, the published renderer, and the editor frame, panels, Layers tree, text grammar and type-in-place box. Published as editor-shell up to 0.66.0 and as efficient-editor up to 0.95.0.",
   "license": "UNLICENSED",
   "author": "Efficient Pty Ltd",
@@ -506,6 +506,11 @@
       "types": "./dist/screen/lib/session-context.d.ts",
       "import": "./dist/screen/lib/session-context.js",
       "default": "./dist/screen/lib/session-context.js"
+    },
+    "./screen/words": {
+      "types": "./dist/screen/words.d.ts",
+      "import": "./dist/screen/words.js",
+      "default": "./dist/screen/words.js"
     }
   },
   "files": [

package/dist/chunk-3U4GP5VA.js

@@ -1,10 +0,0 @@
-import{clientOnly as e}from"./chunk-GXQCZJOP.js";import{ScreenChrome as n}from"./chunk-F2FPZIZV.js";import{ScreenDocumentProvider as t,useScreenDocument as a}from"./chunk-FT35FX7D.js";import{ScreenStoreProvider as i}from"./chunk-VLSTGOVD.js";import{documentPermissions as r}from"./chunk-JUQ6YJCG.js";import{useMemo as s}from"react";import{jsx as d,jsxs as o,Fragment as c}from"react/jsx-runtime";var l=e(i),m=e(n);function g({saving:e,onCancel:n,onDiscard:t,onSave:a}){/* @__PURE__ */
-return d("div",{className:"fixed inset-0 z-[200] flex items-center justify-center bg-black/30 p-4",role:"dialog","aria-modal":"true","aria-labelledby":"sf-leave-title",children:/* @__PURE__ */o("div",{className:"w-full max-w-sm rounded-lg bg-white p-5 shadow-xl",children:[
-/* @__PURE__ */d("h2",{id:"sf-leave-title",className:"text-[15px] font-semibold text-zinc-900",children:"Unsaved changes"}),
-/* @__PURE__ */d("p",{className:"mt-2 text-[13px] leading-relaxed text-zinc-600",children:"Your most recent edits haven’t finished saving yet. Save them before switching, or leave and discard them."}),
-/* @__PURE__ */o("div",{className:"mt-4 flex justify-end gap-2",children:[
-/* @__PURE__ */d("button",{type:"button",onClick:n,className:"rounded-md border border-zinc-300 px-3 py-[7px] text-[13px] font-medium text-zinc-700 transition-colors hover:bg-zinc-100",children:"Cancel"}),
-/* @__PURE__ */d("button",{type:"button",onClick:t,className:"rounded-md border border-red-200 px-3 py-[7px] text-[13px] font-medium text-red-600 transition-colors hover:bg-red-50",children:"Discard & leave"}),
-/* @__PURE__ */d("button",{type:"button",onClick:a,disabled:e,className:"rounded-md bg-blue-600 px-3 py-[7px] text-[13px] font-medium text-white transition-colors hover:bg-blue-700 disabled:opacity-60",children:e?"Saving…":"Save & leave"})]})]})})}function h({target:e,addressing:n,onHostMessage:a,children:i}){/* @__PURE__ */
-return d(t,{target:e,addressing:n,onHostMessage:a,children:i})}var p=(e,n)=>/* @__PURE__ */o(c,{children:[e,n]});function u({config:e,parts:n,wrap:t=p}){const{data:i,error:o,redirecting:c,ready:h,saveStatus:u,readOnly:v,onChange:f,pendingNav:x,cancelPendingNav:b,discardAndNavigate:N,saveAndNavigate:y}=a(),C=s(()=>r(!v),[v]);return c?/* @__PURE__ */d("div",{className:"sf-msg",children:"Loading…"}):o?/* @__PURE__ */d("div",{className:"sf-msg sf-msg--error",children:o}):h?i?t(
-/* @__PURE__ */d(l,{config:e,data:i,onChange:f,permissions:C,parts:n,children:/* @__PURE__ */d(m,{})}),x&&/* @__PURE__ */d(g,{saving:"saving"===u,onCancel:b,onDiscard:N,onSave:()=>{y()}})):/* @__PURE__ */d("div",{className:"sf-msg",children:"Loading…"}):/* @__PURE__ */d("div",{className:"sf-msg",children:"Waiting for editor authorization…"})}export{u as DocumentScreen,h as ScreenMount};

package/dist/chunk-5464H65G.js

@@ -1,4 +0,0 @@
-import{EaselCanvas as n,useSelectedFields as e}from"./chunk-P67FP7PG.js";import{Inspector as t}from"./chunk-BXZ6WLHC.js";import{DesktopIcon as r}from"./chunk-L5KW4HG5.js";import{createContext as o,useContext as i}from"react";import{jsx as u}from"react/jsx-runtime";var l={kind:"puck"};function s(n,e){const t=n,r=e,o=Object.keys(t);return o.length===Object.keys(r).length&&o.every(n=>Object.is(t[n],r[n]))}var c={},a=()=>c,d=()=>"",f=()=>{},p={isLockedBlock:()=>!1,duplicateBlocked:()=>null,nestDepth:()=>0,newSectionNode:()=>null,canAddTo:()=>null,blockIsOffered:()=>!0},k={labelAtLevel:(n,e,t)=>t,descriptions:{},categoryLabel:()=>{},firstSection:null,blockRowName:(n,e)=>e(n.type),plainText:n=>n,Icon:()=>null,Thumbnail:()=>null,useProducts:()=>null},h={options:[{id:"desktop",label:"Desktop",icon:/* @__PURE__ */u(r,{})}],initial:"desktop",fluid:"desktop",widths:{desktop:2e3}},m={read:()=>"sections",write:()=>{},forSelection:(n,e)=>n?"sections":e},v={first:null,last:null,firstGroup:null,lastGroup:null,isSectionGroup:()=>!1,sectionGroupZone:()=>"",panelOf:()=>null};function b(){/* @__PURE__ */
-return u(n,{height:"fill"})}function g(){const{id:n,fields:r,values:o,readOnly:i,onChange:l}=e();/* @__PURE__ */
-return u("div",{className:"es-sidepanel es-sidepanel--right",children:/* @__PURE__ */u(t,{fields:r,values:o,onChange:l,readOnly:i,idPrefix:n})})}var O=o({});function j({parts:n,children:e}){/* @__PURE__ */
-return u(O.Provider,{value:n,children:e})}function y(){return i(O)}function P(){return(y().useOwnerName??d)()}function w(n,e,t,r){return(y().useBridges??a)(n,e,t,r)}function G(n){return(y().useStandaloneBridges??a)(n)}function L(n,e){(y().useDocumentPass??f)(n,e)}function B(){return y().blockRules??p}function S(){return y().blockLook??k}function x(){return y().devices??h}function C(){return y().leftView??m}function N(){return y().pinned??v}function D(){return y().Canvas??b}function I(){return y().Inspector??g}export{l as SELECTION_MODE,j as ScreenPartsProvider,s as sameInspectorMode,S as useScreenBlockLook,B as useScreenBlockRules,w as useScreenBridges,D as useScreenCanvasFrame,x as useScreenDevices,L as useScreenDocumentPass,I as useScreenInspectorPanel,C as useScreenLeftView,P as useScreenOwnerName,y as useScreenParts,N as useScreenPinned,G as useStandaloneScreenBridges};

package/dist/chunk-6FY3PZS3.js

@@ -1 +0,0 @@
-import{hasMediaPanel as e,requestPanelPick as t}from"./chunk-ZZ7VLIHQ.js";var n=/* @__PURE__ */new Map,r=0;function i(i,o){if(!i.connected)return Promise.resolve(null);const c=(r+=1,`mp-${"undefined"!=typeof crypto&&"randomUUID"in crypto?crypto.randomUUID():String(r)}`);return e()?t({requestId:c,accept:o.accept,title:o.title,file:o.file??null}):new Promise(e=>{n.set(c,e),i.send("storefront-editor:open-media-picker",{requestId:c,accept:o.accept,title:o.title,...o.file?{file:o.file}:{}})})}function o(e,t){const r=n.get(e);r&&(n.delete(e),r(t))}export{i as requestMediaPick,o as resolveMediaPick};