@preprio/toolkit 0.1.0-beta.5 → 0.2.0-beta.2

package/dist/index.cjs

@@ -23,7 +23,7 @@ __export(src_exports, {
   PreprError: () => PreprError,
   PreprToolbarElement: () => PreprToolbarElement,
   VERSION: () => VERSION,
-  createPreprToolbar: () => createPreprToolbar,
+  createPreprPreview: () => createPreprPreview,
   createToolbarStore: () => createToolbarStore,
   definePreprToolbar: () => definePreprToolbar,
   extractAccessToken: () => extractAccessToken,
@@ -35,6 +35,7 @@ __export(src_exports, {
   getToolbarPropsFromHeaders: () => getToolbarPropsFromHeaders,
   loadTrackingPixel: () => loadTrackingPixel,
   processPreprRequest: () => processPreprRequest,
+  resolveFeatures: () => resolveFeatures,
   setTrackingParam: () => setTrackingParam,
   stegaClean: () => stegaClean,
   trackEvent: () => trackEvent,
@@ -43,7 +44,25 @@ __export(src_exports, {
 module.exports = __toCommonJS(src_exports);
 
 // src/version.ts
-var VERSION = "0.1.0-beta.5";
+var VERSION = "0.2.0-beta.2";
+
+// src/core/features.ts
+function isEnabled(config) {
+  if (typeof config === "boolean") return config;
+  return config?.enabled ?? true;
+}
+function resolveFeatures(features) {
+  return {
+    segments: isEnabled(features?.segments),
+    abTesting: isEnabled(features?.abTesting),
+    editMode: isEnabled(features?.editMode)
+  };
+}
+var ALL_FEATURES_ENABLED = Object.freeze({
+  segments: true,
+  abTesting: true,
+  editMode: true
+});
 
 // src/core/constants.ts
 var COOKIE_PREVIEW_MODE = "Prepr-Preview-Mode";
@@ -326,7 +345,7 @@ function createIframeBridge(store, options = {}) {
         const top = data.scrollPosition;
         setTimeout(() => window.scrollTo(0, top), 1);
       }
-      store.set({ previewMode: true, editMode: data.editMode ?? true });
+      store?.set({ previewMode: true, editMode: data.editMode ?? true });
     }
     if (!parentOrigin || evt.origin !== parentOrigin) return;
     if (data?.event === "prepr:getScrollPosition") {
@@ -952,7 +971,8 @@ var DEFAULT_STATE = {
   editMode: false,
   previewMode: false,
   toolbarOpen: false,
-  isIframe: false
+  isIframe: false,
+  features: ALL_FEATURES_ENABLED
 };
 function createToolbarStore(initial = {}) {
   let state = { ...DEFAULT_STATE, ...initial };
@@ -987,7 +1007,7 @@ function cookieOpts() {
   };
 }
 function createChangeHandler(deps) {
-  const { store, stega, syncAutoClean } = deps;
+  const { store, stega, syncAutoClean, features, editingEnabled } = deps;
   function updateParams(patch) {
     const [path, existing] = splitPath(deps.currentPath());
     const params = new URLSearchParams(existing);
@@ -1003,7 +1023,7 @@ function createChangeHandler(deps) {
   }
   return function handleChange(before, after) {
     const paramPatch = {};
-    if (before.selectedSegment !== after.selectedSegment) {
+    if (features.segments && before.selectedSegment !== after.selectedSegment) {
       if (after.selectedSegment === null) {
         removeCookie(COOKIE_SEGMENT, "/", crossSiteCookieOptions());
       } else {
@@ -1014,7 +1034,7 @@ function createChangeHandler(deps) {
         segment: after.selectedSegment ?? void 0
       });
     }
-    if (before.selectedVariant !== after.selectedVariant) {
+    if (features.abTesting && before.selectedVariant !== after.selectedVariant) {
       if (after.selectedVariant === null) {
         removeCookie(COOKIE_VARIANT, "/", crossSiteCookieOptions());
       } else {
@@ -1029,7 +1049,7 @@ function createChangeHandler(deps) {
       updateParams(paramPatch);
     }
     if (before.editMode !== after.editMode) {
-      if (after.editMode) {
+      if (after.editMode && editingEnabled) {
         stega.start();
       } else {
         stega.stop();
@@ -1600,9 +1620,10 @@ function StatusPill({
   t: t3,
   handlers
 }) {
+  const { features } = state;
   const defaultSegmentName = state.segments.find((s2) => s2._id === "all_other_users")?.name ?? t3("adaptiveContent.allOtherUsers");
   let segmentLabel;
-  if (!state.previewMode) {
+  if (!state.previewMode || !features.segments) {
     segmentLabel = t3("common.user");
   } else if (state.selectedSegment !== null) {
     const seg = state.segments.find((s2) => s2._id === state.selectedSegment);
@@ -1626,7 +1647,7 @@ function StatusPill({
           {
             class: "prepr-status-variant",
             "data-prepr": "status-variant",
-            hidden: !state.previewMode,
+            hidden: !features.abTesting || !state.previewMode,
             children: state.selectedVariant === "B" ? "B" : "A"
           }
         ),
@@ -1635,7 +1656,7 @@ function StatusPill({
           {
             class: "prepr-status-x",
             "data-prepr": "status-x",
-            hidden: !state.previewMode || state.selectedSegment === null,
+            hidden: !features.segments || !state.previewMode || state.selectedSegment === null,
             children: /* @__PURE__ */ u2(RawSvg, { svg: XMARK_ICON_SVG })
           }
         )
@@ -1655,7 +1676,7 @@ function CloseEditPill({
       class: "prepr-close-edit-pill",
       "data-prepr": "close-edit-pill",
       "aria-label": t3("editingTools.ariaCloseEditMode"),
-      hidden: !state.editMode || state.isIframe,
+      hidden: !state.features.editMode || !state.editMode || state.isIframe,
       onClick: () => handlers.onCloseEditPill(),
       children: [
         /* @__PURE__ */ u2("span", { "data-prepr": "close-edit-label", children: t3("editingTools.editMode") }),
@@ -1671,7 +1692,9 @@ function Panel({
   segmentFilter,
   handlers
 }) {
-  const hasPersonalization = state.selectedSegment !== null || state.selectedVariant !== null;
+  const { features } = state;
+  const hasPersonalization = features.segments && state.selectedSegment !== null || features.abTesting && state.selectedVariant !== null;
+  const showAdaptive = features.segments || features.abTesting;
   return /* @__PURE__ */ u2(S, { children: [
     /* @__PURE__ */ u2(
       "style",
@@ -1714,12 +1737,12 @@ function Panel({
             children: [
               /* @__PURE__ */ u2(Header, { t: t3, onClose: handlers.onClose }),
               /* @__PURE__ */ u2("div", { class: "prepr-section", "data-prepr": "section-adaptive", children: [
-                /* @__PURE__ */ u2("span", { class: "prepr-section-label", "data-prepr": "adaptive-label", children: t3("adaptiveContent.adaptiveContent") }),
+                /* @__PURE__ */ u2("span", { class: "prepr-section-label", "data-prepr": "adaptive-label", children: showAdaptive ? t3("adaptiveContent.adaptiveContent") : t3("adaptiveContent.enablePreview") }),
                 /* @__PURE__ */ u2("div", { class: "prepr-row", children: [
                   /* @__PURE__ */ u2("h2", { class: "prepr-row-title", "data-prepr": "preview-label", children: t3("adaptiveContent.enablePreview") }),
                   /* @__PURE__ */ u2(PreviewSelector, { state, t: t3, handlers })
                 ] }),
-                /* @__PURE__ */ u2("div", { class: "prepr-row", children: [
+                features.segments && /* @__PURE__ */ u2("div", { class: "prepr-row", children: [
                   /* @__PURE__ */ u2("h2", { class: "prepr-row-title", "data-prepr": "segment-label", children: t3("adaptiveContent.segment") }),
                   /* @__PURE__ */ u2(
                     SegmentListbox,
@@ -1732,12 +1755,12 @@ function Panel({
                     }
                   )
                 ] }),
-                /* @__PURE__ */ u2("div", { class: "prepr-row", children: [
+                features.abTesting && /* @__PURE__ */ u2("div", { class: "prepr-row", children: [
                   /* @__PURE__ */ u2("h2", { class: "prepr-row-title", "data-prepr": "variant-label", children: t3("adaptiveContent.ABVariant") }),
                   /* @__PURE__ */ u2(VariantSelector, { state, handlers })
                 ] })
               ] }),
-              /* @__PURE__ */ u2("div", { class: "prepr-section", "data-prepr": "section-editing", children: [
+              features.editMode && /* @__PURE__ */ u2("div", { class: "prepr-section", "data-prepr": "section-editing", children: [
                 /* @__PURE__ */ u2("span", { class: "prepr-section-label", "data-prepr": "editing-label", children: t3("editingTools.editingTools") }),
                 /* @__PURE__ */ u2("div", { class: "prepr-row", children: [
                   /* @__PURE__ */ u2("h2", { class: "prepr-row-title", "data-prepr": "edit-label", children: t3("editingTools.editMode") }),
@@ -1790,26 +1813,28 @@ var PreprToolbarElement = class extends HTMLElementBase {
       onToggle: () => this.set({ toolbarOpen: !this.state.toolbarOpen }),
       onClose: () => this.set({ toolbarOpen: false }),
       onPreviewMode: (value) => this.set({ previewMode: value }),
-      onEditMode: (value) => this.set({ editMode: value }),
+      onEditMode: (value) => {
+        if (!this.state.features.editMode) return;
+        this.set({ editMode: value });
+      },
       onVariant: (value) => {
+        if (!this.state.features.abTesting) return;
         if (!this.state.previewMode) return;
         this.set({ selectedVariant: value });
       },
       // Reset contract: segment to none, variant to 'A' — NOT null, since the
       // resulting `variant_changed` must carry 'A' on the wire — edit mode off.
-      onReset: () => this.set({
-        selectedSegment: null,
-        selectedVariant: "A",
-        editMode: false
-      }),
+      // Disabled features are left untouched: their state is already inert and
+      // writing it would emit events for a feature the consumer turned off.
+      onReset: () => this.set(this.resetPatch({ editMode: false })),
       onStatusPill: () => {
         if (!this.state.previewMode) {
           this.set({ previewMode: true });
           return;
         }
-        if (this.state.selectedSegment !== null || this.state.selectedVariant !== "A") {
-          this.set({ selectedSegment: null, selectedVariant: "A" });
-        }
+        const patch = this.resetPatch();
+        const dirty = "selectedSegment" in patch && this.state.selectedSegment !== null || "selectedVariant" in patch && this.state.selectedVariant !== "A";
+        if (dirty) this.set(patch);
       },
       onCloseEditPill: () => this.set({ editMode: false }),
       onSegmentButtonClick: () => this.toggleListbox(!this.listboxOpen),
@@ -1859,6 +1884,14 @@ var PreprToolbarElement = class extends HTMLElementBase {
   set(patch) {
     this.store?.set(patch);
   }
+  /** Reset patch covering only the enabled personalization features. */
+  resetPatch(base = {}) {
+    const { features } = this.state;
+    const patch = { ...base };
+    if (features.segments) patch.selectedSegment = null;
+    if (features.abTesting) patch.selectedVariant = "A";
+    return patch;
+  }
   // Synchronous: Preact's top-level render() mutates the DOM before returning.
   renderPanel(state) {
     const root = this.shadowRoot;
@@ -2017,6 +2050,7 @@ var PreprToolbarElement = class extends HTMLElementBase {
     ) ?? null;
   }
   chooseSegment(id) {
+    if (!this.state.features.segments) return;
     this.listboxOpen = false;
     this.segmentFilter = "";
     this.set({ selectedSegment: id });
@@ -2031,8 +2065,8 @@ function definePreprToolbar() {
   }
 }
 
-// src/core/create-toolbar.ts
-var debug7 = createScopedLogger("create-toolbar");
+// src/core/create-preview.ts
+var debug7 = createScopedLogger("create-preview");
 var controllerStores = /* @__PURE__ */ new WeakMap();
 function defaultNavigation() {
   return {
@@ -2053,7 +2087,7 @@ function resolveLocale(options) {
   }
   return "en";
 }
-function createPreprToolbar(opts) {
+function createPreprPreview(opts = {}) {
   const { props, options } = opts;
   const navigation = opts.navigation ?? defaultNavigation();
   initDebugLogger(options?.debug ?? false);
@@ -2066,36 +2100,40 @@ function createPreprToolbar(opts) {
   const search = new URLSearchParams(window.location.search);
   const hideBar = search.get(PARAM_HIDE_BAR) === "true";
   if (hideBar) {
-    debug7.log(`${PARAM_HIDE_BAR}=true \u2014 skipping mount`);
-    return noop();
+    debug7.log(`${PARAM_HIDE_BAR}=true \u2014 no visible toolbar`);
   }
+  const mountUi = (options?.ui ?? true) && !isIframe && !hideBar;
   const locale = resolveLocale(options);
+  const features = resolveFeatures(options?.features);
   const previewMode = getCookie(COOKIE_PREVIEW_MODE) === "true";
   const toolbarOpen = getCookie(COOKIE_TOOLBAR_OPEN) === "true";
-  const cookieSegment = getCookie(COOKIE_SEGMENT);
-  const cookieVariant = getCookie(COOKIE_VARIANT);
-  const rawVariant = props.activeVariant ?? cookieVariant;
+  const cookieSegment = features.segments ? getCookie(COOKIE_SEGMENT) : null;
+  const cookieVariant = features.abTesting ? getCookie(COOKIE_VARIANT) : null;
+  const rawVariant = features.abTesting ? props?.activeVariant ?? cookieVariant : null;
   const selectedVariant = rawVariant === "A" || rawVariant === "B" ? rawVariant : null;
   const store = createToolbarStore({
     locale,
-    segments: buildSegments(props.segments ?? props.data ?? []),
-    selectedSegment: props.activeSegment ?? cookieSegment ?? null,
+    features,
+    segments: features.segments ? buildSegments(props?.segments ?? props?.data ?? []) : [],
+    selectedSegment: features.segments ? props?.activeSegment ?? cookieSegment ?? null : null,
     selectedVariant,
     previewMode,
     toolbarOpen,
     isIframe
   });
   let el = null;
-  if (!isIframe) {
+  if (mountUi) {
     definePreprToolbar();
     el = document.createElement("prepr-toolbar");
     document.body.appendChild(el);
     el.connect(store, (key) => t(key, locale));
   }
+  const editingEnabled = features.editMode || isIframe;
   const stega = createStegaController({
-    // The CMS deep-link tooltip is noise inside the editor; clicking the
-    // element itself requests the edit there.
-    tooltip: !isIframe,
+    // The CMS deep-link tooltip is chrome, so it follows the same decision as
+    // the bar: noise inside the editor (clicking the element itself requests
+    // the edit there), and unwanted in a headless preview that asked for no UI.
+    tooltip: mountUi,
     // In the editor, ask the parent to focus the field instead of opening a new
     // tab. Standalone previews keep the window.open behaviour.
     onEdit: ({ href, origin, id, field }) => {
@@ -2119,6 +2157,8 @@ function createPreprToolbar(opts) {
   }
   const handleChange = createChangeHandler({
     store,
+    features,
+    editingEnabled,
     navigate: (url) => navigation.navigate(url),
     currentPath: () => navigation.currentPath(),
     reload: navigation.reload ?? (() => window.location.reload()),
@@ -2132,7 +2172,9 @@ function createPreprToolbar(opts) {
     handleChange(before, state);
   });
   syncAutoClean(store.get().previewMode);
-  const bridge = createIframeBridge(store);
+  const bridge = createIframeBridge(store, {
+    allowedEditorOrigins: options?.allowedEditorOrigins
+  });
   sendPreprEvent("getScrollPosition", { value: 0 }, {
     allowUntrustedTarget: true
   });
@@ -2147,7 +2189,7 @@ function createPreprToolbar(opts) {
       bridge.stop();
     }
     el?.remove();
-    debug7.log("toolbar destroyed");
+    debug7.log("preview destroyed");
   }
   const controller = { destroy };
   controllerStores.set(controller, store);
@@ -2290,16 +2332,19 @@ async function getPreprEnvironmentSegments(token) {
     );
   }
 }
-async function getToolbarPropsFromHeaders(headers, token) {
+async function getToolbarPropsFromHeaders(headers, token, features) {
+  const resolved = resolveFeatures(features);
   let segments = [];
-  try {
-    segments = await getPreprEnvironmentSegments(token);
-  } catch {
-    segments = [];
+  if (resolved.segments) {
+    try {
+      segments = await getPreprEnvironmentSegments(token);
+    } catch {
+      segments = [];
+    }
   }
   return {
-    activeSegment: getActiveSegmentFromHeaders(headers),
-    activeVariant: getActiveVariantFromHeaders(headers),
+    activeSegment: resolved.segments ? getActiveSegmentFromHeaders(headers) : null,
+    activeVariant: resolved.abTesting ? getActiveVariantFromHeaders(headers) : null,
     segments,
     data: segments
   };
@@ -2374,7 +2419,8 @@ function processPreprRequest(request, opts) {
   if (!opts?.preview) {
     return { requestHeaders, responseCookies };
   }
-  const hasPreviewParams = searchParams.has(PARAM_SEGMENT) || searchParams.has(PARAM_VARIANT);
+  const features = resolveFeatures(opts?.features);
+  const hasPreviewParams = features.segments && searchParams.has(PARAM_SEGMENT) || features.abTesting && searchParams.has(PARAM_VARIANT);
   if (!hasPreviewParams) {
     const previewModeCookie = requestCookies.get(COOKIE_PREVIEW_MODE);
     const previewModeEnabled = previewModeCookie !== "false";
@@ -2394,16 +2440,16 @@ function processPreprRequest(request, opts) {
     });
   }
   if (!isLivePreview) {
-    const segmentCookie = requestCookies.get(COOKIE_SEGMENT);
+    const segmentCookie = features.segments ? requestCookies.get(COOKIE_SEGMENT) : void 0;
     if (segmentCookie) {
       requestHeaders.set("Prepr-Segments", segmentCookie);
     }
-    const abCookie = requestCookies.get(COOKIE_VARIANT);
+    const abCookie = features.abTesting ? requestCookies.get(COOKIE_VARIANT) : void 0;
     if (abCookie) {
       requestHeaders.set("Prepr-ABtesting", abCookie);
     }
   }
-  const previewAb = searchParams.get(PARAM_VARIANT);
+  const previewAb = features.abTesting ? searchParams.get(PARAM_VARIANT) : null;
   if (previewAb !== null) {
     requestHeaders.set("Prepr-ABtesting", previewAb);
     if (!isLivePreview) {
@@ -2416,7 +2462,7 @@ function processPreprRequest(request, opts) {
       });
     }
   }
-  const previewSegment = searchParams.get(PARAM_SEGMENT);
+  const previewSegment = features.segments ? searchParams.get(PARAM_SEGMENT) : null;
   if (previewSegment !== null) {
     requestHeaders.set("Prepr-Segments", previewSegment);
     if (!isLivePreview) {
@@ -2500,7 +2546,7 @@ function setTrackingParam(key, value) {
   PreprError,
   PreprToolbarElement,
   VERSION,
-  createPreprToolbar,
+  createPreprPreview,
   createToolbarStore,
   definePreprToolbar,
   extractAccessToken,
@@ -2512,6 +2558,7 @@ function setTrackingParam(key, value) {
   getToolbarPropsFromHeaders,
   loadTrackingPixel,
   processPreprRequest,
+  resolveFeatures,
   setTrackingParam,
   stegaClean,
   trackEvent,

package/dist/index.d.cts

@@ -1,11 +1,18 @@
-import { L as Locale, P as PreprSegment, a as PreprVariant, b as PreprToolbarProps, c as PreprToolbarOptions, d as PreprErrorCode, e as PreprHeaders } from './pixel-DVSJQC0K.cjs';
-export { f as PreprEnvironment, g as PreprEventType, h as PreprHeaderName, i as PreprPixelConfig, l as loadTrackingPixel, s as setTrackingParam, t as trackEvent } from './pixel-DVSJQC0K.cjs';
+import { P as PreprFeatures, R as ResolvedPreprFeatures, L as Locale, a as PreprSegment, b as PreprVariant, c as PreprToolbarProps, d as PreprPreviewOptions, e as PreprErrorCode, f as PreprHeaders } from './pixel-763p7m6A.cjs';
+export { g as PreprEnvironment, h as PreprEventType, i as PreprFeatureConfig, j as PreprHeaderName, k as PreprPixelConfig, l as PreprToolbarComponentProps, m as PreprToolbarOptions, n as loadTrackingPixel, s as setTrackingParam, t as trackEvent } from './pixel-763p7m6A.cjs';
 
 /**
  * Package version; must match package.json. Lives in its own leaf module so
  * core can import it without cycling through the barrel.
  */
-declare const VERSION = "0.1.0-beta.5";
+declare const VERSION = "0.2.0-beta.2";
+
+/**
+ * Resolve a `PreprFeatures` bag to plain booleans, defaulting every omitted key
+ * to enabled. Shared by the toolbar and the middleware so both sides agree on
+ * what a given config means.
+ */
+declare function resolveFeatures(features?: PreprFeatures): ResolvedPreprFeatures;
 
 interface ToolbarState {
     locale: Locale;
@@ -16,6 +23,11 @@ interface ToolbarState {
     previewMode: boolean;
     toolbarOpen: boolean;
     isIframe: boolean;
+    /**
+     * Set once at construction, never patched. Lives here so the panel and the
+     * element read it the same way they read everything else.
+     */
+    features: ResolvedPreprFeatures;
 }
 interface ToolbarStore {
     get(): ToolbarState;
@@ -25,7 +37,7 @@ interface ToolbarStore {
 /**
  * Framework-free store for toolbar state. Deliberately pure: it holds state and
  * notifies subscribers, nothing else. Cookies, postMessage and reloads are side
- * effects owned by the mount controller (create-toolbar.ts).
+ * effects owned by the mount controller (create-preview.ts).
  */
 declare function createToolbarStore(initial?: Partial<ToolbarState>): ToolbarStore;
 
@@ -45,21 +57,32 @@ interface PreprNavigationAdapter {
      */
     reload?(): void;
 }
-interface CreatePreprToolbarOptions {
-    props: PreprToolbarProps;
-    options?: PreprToolbarOptions;
+interface CreatePreprPreviewOptions {
+    /**
+     * Toolbar data. Optional: a headless preview (`ui: false`) that only wants
+     * click-to-edit or scroll restore has no segment list to pass.
+     */
+    props?: PreprToolbarProps;
+    options?: PreprPreviewOptions;
     navigation?: PreprNavigationAdapter;
 }
-interface PreprToolbarController {
+interface PreprPreviewController {
     destroy(): void;
 }
 /**
- * Composition root: hydrates state from props + cookies, mounts
- * `<prepr-toolbar>`, and wires the collaborators — the change handler
- * (toolbar-change-handler.ts), the stega click-to-edit controller, the
- * auto-clean pass and the editor bridge (iframe-bridge.ts).
+ * Composition root for the Prepr preview runtime: hydrates state from props +
+ * cookies, optionally mounts `<prepr-toolbar>`, and wires the collaborators —
+ * the change handler (toolbar-change-handler.ts), the stega click-to-edit
+ * controller, the auto-clean pass and the editor bridge (iframe-bridge.ts).
+ *
+ * Two independent axes control what runs:
+ * - `options.features` — which features are active at all (segments, A/B,
+ *   click-to-edit).
+ * - `options.ui` — whether the visible toolbar is mounted. `ui: false` keeps
+ *   every non-visual side effect wired, which is how a headless preview gets
+ *   click-to-edit or editor scroll restore with no chrome of its own.
  */
-declare function createPreprToolbar(opts: CreatePreprToolbarOptions): PreprToolbarController;
+declare function createPreprPreview(opts?: CreatePreprPreviewOptions): PreprPreviewController;
 
 type Translate = (key: string) => string;
 declare const HTMLElementBase: typeof HTMLElement;
@@ -69,7 +92,7 @@ declare const HTMLElementBase: typeof HTMLElement;
  *
  * This element is the controller: it owns interaction state (listbox open,
  * keyboard nav, tooltip positioning, outside-click) and writes back ONLY via
- * `store.set(...)`. Cookies/postMessage/navigation belong to create-toolbar.ts,
+ * `store.set(...)`. Cookies/postMessage/navigation belong to create-preview.ts,
  * which subscribes to the same store.
  *
  * State reaches `<Panel>` as a prop rather than internal Preact state, so every
@@ -87,6 +110,8 @@ declare class PreprToolbarElement extends HTMLElementBase {
     disconnectedCallback(): void;
     private get state();
     private set;
+    /** Reset patch covering only the enabled personalization features. */
+    private resetPatch;
     private renderPanel;
     private tip;
     /**
@@ -112,6 +137,14 @@ declare class PreprToolbarElement extends HTMLElementBase {
 /** Idempotent, including across bundles that each try to define the element. */
 declare function definePreprToolbar(): void;
 
+interface IframeBridgeOptions {
+    /**
+     * Replace the `*.prepr.io` wildcard with an exact origin list. Intended for
+     * self-hosted editors; when set, the wildcard no longer applies.
+     */
+    allowedEditorOrigins?: string[];
+}
+
 /** Error thrown by the token helpers and the segments fetch. */
 declare class PreprError extends Error {
     readonly code: PreprErrorCode;
@@ -152,8 +185,12 @@ declare function getPreprEnvironmentSegments(token: string): Promise<PreprSegmen
  * Never throws: a failed segments fetch yields an empty list so the toolbar
  * still renders. The list is returned under both `segments` and the deprecated
  * `data` alias.
+ *
+ * Pass the same `features` object you give the toolbar and the middleware: with
+ * segments disabled the `_Segments` request is skipped entirely, saving a
+ * round-trip per page.
  */
-declare function getToolbarPropsFromHeaders(headers: Headers, token: string): Promise<PreprToolbarProps>;
+declare function getToolbarPropsFromHeaders(headers: Headers, token: string, features?: PreprFeatures): Promise<PreprToolbarProps>;
 
 interface CookieSpec {
     name: string;
@@ -177,6 +214,12 @@ interface PreprMiddlewareResult {
 interface PreprMiddlewareOptions {
     /** Enable preview-mode headers (segment/AB overrides, preview bar). */
     preview?: boolean;
+    /**
+     * Disable features app-wide. Pass the same object you give the toolbar: a
+     * disabled feature injects no header and persists no cookie, whatever the
+     * request carries.
+     */
+    features?: PreprFeatures;
     /** Override the version reported in Prepr-Package (mainly for tests). */
     version?: string;
 }
@@ -187,4 +230,4 @@ interface PreprMiddlewareOptions {
  */
 declare function processPreprRequest(request: Request, opts?: PreprMiddlewareOptions): PreprMiddlewareResult;
 
-export { type CookieSpec, type CreatePreprToolbarOptions, PreprError, PreprErrorCode, PreprHeaders, type PreprMiddlewareOptions, type PreprMiddlewareResult, type PreprNavigationAdapter, PreprSegment, type PreprToolbarController, PreprToolbarElement, PreprToolbarOptions, PreprToolbarProps, PreprVariant, type ToolbarState, type ToolbarStore, VERSION, createPreprToolbar, createToolbarStore, definePreprToolbar, extractAccessToken, getActiveSegmentFromHeaders, getActiveVariantFromHeaders, getPreprEnvironmentSegments, getPreprHeadersFromHeaders, getPreprUUIDFromHeaders, getToolbarPropsFromHeaders, processPreprRequest, stegaClean, validatePreprToken };
+export { type CookieSpec, type CreatePreprPreviewOptions, type IframeBridgeOptions, PreprError, PreprErrorCode, PreprFeatures, PreprHeaders, type PreprMiddlewareOptions, type PreprMiddlewareResult, type PreprNavigationAdapter, type PreprPreviewController, PreprPreviewOptions, PreprSegment, PreprToolbarElement, PreprToolbarProps, PreprVariant, ResolvedPreprFeatures, type ToolbarState, type ToolbarStore, VERSION, createPreprPreview, createToolbarStore, definePreprToolbar, extractAccessToken, getActiveSegmentFromHeaders, getActiveVariantFromHeaders, getPreprEnvironmentSegments, getPreprHeadersFromHeaders, getPreprUUIDFromHeaders, getToolbarPropsFromHeaders, processPreprRequest, resolveFeatures, stegaClean, validatePreprToken };