@sevenfold/setto-client 0.13.0 → 0.15.0

package/dist/chrome.d.ts

@@ -24,12 +24,25 @@ export interface SettoChromeHandshake {
     /**
      * The same, for the page at `/setto`.
      *
-     * A second slot because the dashboard is not an overlay: it belongs in the
-     * host's own route, where the customer navigated to it. Registering nothing
-     * leaves the bundled dashboard in place, which is what keeps a chrome that
-     * fails to load from taking the admin down with it.
+     * @deprecated Use `mountSlot('admin', …)`. Kept because a chrome bundle
+     * older than this file may still call it, and the whole point of this file
+     * is that it never has to change again.
      */
     mountAdmin: (Component: React.ComponentType) => void;
+    /**
+     * Offer a component for a named place in the host: `admin` for the page at
+     * `/setto`, `toolbar` for the editor's floating menu.
+     *
+     * Named rather than one method per surface, because every new method here
+     * costs a re-pin of the whole fleet — the exact price this file exists to
+     * avoid paying. A new surface is now a string the host already understands,
+     * or one it will simply ignore.
+     *
+     * Registering nothing leaves the host's own version in place. That is what
+     * keeps a chrome bundle that fails to load, or throws while rendering, from
+     * taking the editor down with it.
+     */
+    mountSlot: (name: string, Component: React.ComponentType) => void;
     /**
      * The host's own `useSetto`, callable from the chrome.
      *
@@ -58,6 +71,8 @@ export interface SettoChromeHandshake {
         } | null;
         sitesLoaded: boolean;
         editMode: boolean;
+        /** A signed-out visitor trying the editor on setto.no. */
+        guestEdit: boolean;
         authLoading: boolean;
     };
     /** Told whenever that state changes. Returns an unsubscribe. */
@@ -70,8 +85,11 @@ declare global {
     }
 }
 /**
- * What the host should render at `/setto`, or null while the chrome has not
- * offered anything. Callers fall back to their bundled dashboard.
+ * What the host should render in a named place, or null while the chrome has
+ * offered nothing — including after it offered something that threw. Callers
+ * render their own version when this is null; every one of them must have one.
  */
+export declare function useSettoChromeSlot(name: string): React.ComponentType | null;
+/** @deprecated Use `useSettoChromeSlot('admin')`. */
 export declare function useSettoAdminChrome(): React.ComponentType | null;
 export declare function SettoChrome(): import("react/jsx-runtime").JSX.Element | null;

package/dist/edit-mode/toolbar-fallback.d.ts

@@ -0,0 +1 @@
+export declare function ToolbarUnavailable(): import("react/jsx-runtime").JSX.Element | null;

package/dist/guest-edit.d.ts

@@ -1,16 +1,22 @@
-import { type ReactNode } from 'react';
-interface GuestEditContextValue {
-    active: boolean;
-    start: () => void;
-    stop: () => void;
-}
+import type { ReactNode } from 'react';
 /**
  * Lets visitors inline-edit a marketing site (e.g. setto.no) without auth —
  * text, section/block colours, icons and list items. Changes are session-only
  * and never published. Real Setto edit mode always takes precedence.
+ *
+ * A provider in name only since 2026-09-09: the state moved into the main
+ * context so the chrome could see it, and what is left here is the one thing
+ * guest mode adds — the section toolbar, over a page nobody is signed in to.
+ * The component comes from Setto like the rest of the editing chrome, so there
+ * is nothing to draw until it arrives, and nothing to draw at all if it does
+ * not. That is the right failure for a demo.
  */
 export declare function GuestEditProvider({ children }: {
     children: ReactNode;
 }): import("react/jsx-runtime").JSX.Element;
+export interface GuestEditContextValue {
+    active: boolean;
+    start: () => void;
+    stop: () => void;
+}
 export declare function useGuestEdit(): GuestEditContextValue;
-export {};

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { SettoProvider, useSetto } from './provider';
 export { GuestEditProvider, useGuestEdit } from './guest-edit';
 export { SettoPreviewBar, isPreviewHost, previewBarState } from './preview-bar';
-export { SettoChrome } from './chrome';
+export { SettoChrome, useSettoChromeSlot } from './chrome';
 export type { SettoChromeHandshake } from './chrome';
 export { T } from './T';
 export { SettoSection } from './SettoSection';
@@ -35,4 +35,10 @@ export { extractContentKeys, type ContentKeyRequirements, } from './block-tree/e
 export { BLOCK_REGISTRY, BLOCK_TYPES, nodeChildren } from './block-tree/registry';
 export type { BlockTypeMeta } from './block-tree/registry';
 export { SETTO_BASE, siteHomeUrl, isAdminRoute, isAdminDeploymentView, adminViewUrl, currentAdminView, isAdminPanelView, adminRedirectUrl, CHECKOUT_INTENT, checkoutIntentUrl, wantsCheckout, withoutCheckoutIntent, } from './lib/urls';
-export { IN_PROGRESS_STATUSES, isDeploymentInProgress, isDeploymentStale, STALE_PENDING_MS, STALE_BUILDING_MS, fetchInProgressDeploymentId, waitForDeploymentByCommit, useDeploymentStatus, PublishProgressBar, } from './edit-mode/deployment-status';
+export { SettoMark } from './edit-mode/setto-mark';
+export { isLinkContext } from './lib/link-context';
+export { useCoarsePointer } from './lib/use-coarse-pointer';
+export { FAB_SIZE, FAB_INSET } from './edit-mode/constants';
+export { EMPTY_I18N_STORE_SNAPSHOT } from './lib/i18n-store';
+export type { I18nStoreSnapshot } from './lib/i18n-store';
+export { IN_PROGRESS_STATUSES, isDeploymentInProgress, isDeploymentStale, STALE_PENDING_MS, STALE_BUILDING_MS, fetchInProgressDeploymentId, waitForDeploymentByCommit, useDeploymentStatus, PublishProgressBar, PublishProgressSteps, } from './edit-mode/deployment-status';

package/dist/lib/i18n-store.d.ts

@@ -56,6 +56,16 @@ export declare class I18nStore {
         namespace?: string;
     });
     snapshot(): I18nStoreSnapshot;
+    /**
+     * Put a locale file into i18next as the published baseline.
+     *
+     * Same reason as `languages`: the editor chrome cannot reach the live
+     * i18next instance from its own bundle, and this store already holds it.
+     * Deep and overwriting, which is what seeding a baseline means — the file
+     * from the repository is the truth, and any draft on top of it lives here,
+     * not in i18next.
+     */
+    addBaselineBundle(lng: string, resources: Record<string, unknown>): void;
     subscribe(listener: Listener): () => void;
     /**
      * Returns the current rendered value for a key in a given language,
@@ -111,7 +121,20 @@ export declare class I18nStore {
     serialiseBundles(): Record<string, unknown>;
     /** Runs `fn` and notifies consumers once, however many edits it makes. */
     batch(fn: () => void): void;
-    private languages;
+    /**
+     * Every language this site has content for, in i18next's own order.
+     *
+     * Public because the editor chrome needs it and cannot get it the usual way:
+     * that code runs in a second bundle whose `react-i18next` is a different
+     * module instance from the host's, so its `useTranslation` finds no
+     * initialised i18next and reports no languages at all. This store is the
+     * host's own object, handed across by reference, and it already holds the
+     * live instance.
+     *
+     * Deduplicated, because i18next appends its fallback chain and every caller
+     * was doing that itself.
+     */
+    languages(fallback: string): string[];
     private valueOrUndefined;
     private setOrDelete;
     /** Every string key under `prefix`, nested to any depth. */

package/dist/provider.d.ts

@@ -25,6 +25,18 @@ export interface SettoContextValue {
     store: I18nStore | null;
     themeStore: ThemeStore | null;
     assetStore: AssetStore | null;
+    /** The section the editor has selected, or null. */
+    selectedSectionId: string | null;
+    selectSection: (id: string | null) => void;
+    /**
+     * True while a signed-out visitor is trying the editor (setto.no).
+     *
+     * Here beside `editMode` rather than in `GuestEditProvider`'s own context
+     * for the same reason the selected section is: the chrome that draws the
+     * section toolbar sits above that provider and can call only `useSetto`.
+     */
+    guestEdit: boolean;
+    setGuestEdit: (on: boolean) => void;
 }
 /**
  * Exported for one caller: the chrome bundle.

package/dist/section-context.d.ts

@@ -1,10 +1,15 @@
-import { type ReactNode } from 'react';
-interface SectionEditContextValue {
+/**
+ * Which section the editor has selected.
+ *
+ * A context of its own until 2026-09-09, when the section toolbar moved out to
+ * the chrome served by setto-server. That bundle can call exactly one hook of
+ * the host's — `useSetto` — so the state moved into the main context and this
+ * became an adapter. Kept because `SettoSection` and `SettoBlock` read it on
+ * every render of every page, and renaming that in thirteen pinned sites buys
+ * nothing.
+ */
+export interface SectionEditContextValue {
     selectedId: string | null;
     selectSection: (id: string | null) => void;
 }
-export declare function SectionEditProvider({ children }: {
-    children: ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
 export declare function useSectionEdit(): SectionEditContextValue;
-export {};