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

package/dist/nuxt/index.cjs

@@ -35,7 +35,7 @@ __export(nuxt_exports, {
 module.exports = __toCommonJS(nuxt_exports);
 
 // src/version.ts
-var VERSION = "0.1.0-beta.5";
+var VERSION = "0.2.0-beta.2";
 
 // src/core/constants.ts
 var COOKIE_PREVIEW_MODE = "Prepr-Preview-Mode";
@@ -48,6 +48,24 @@ var PARAM_VARIANT = "prepr_preview_ab";
 var PARAM_HIDE_BAR = "prepr_hide_bar";
 var ONE_YEAR_SECONDS = 60 * 60 * 24 * 365;
 
+// 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/middleware.ts
 var UTM_PARAMS = [
   "utm_source",
@@ -131,7 +149,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";
@@ -151,16 +170,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) {
@@ -173,7 +192,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) {
@@ -352,16 +371,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
   };
@@ -380,8 +402,8 @@ function getActiveVariant(headers) {
 function getPreprHeaders(headers) {
   return getPreprHeadersFromHeaders(headers);
 }
-async function getToolbarProps(headers, token) {
-  return getToolbarPropsFromHeaders(headers, token);
+async function getToolbarProps(headers, token, features) {
+  return getToolbarPropsFromHeaders(headers, token, features);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/nuxt/index.d.cts

@@ -1,6 +1,67 @@
+interface PreprSegment {
+    readonly _id: string;
+    readonly name: string;
+}
+/**
+ * Per-feature config. `false` is shorthand for `{ enabled: false }`; the object
+ * form leaves room for per-feature options later without a breaking change.
+ */
+type PreprFeatureConfig = boolean | {
+    enabled?: boolean;
+};
+/** Toolkit features a consumer can turn off. Omitted keys stay enabled. */
+interface PreprFeatures {
+    /** Segment picker, `Prepr-Segments` header and its cookie/query param. */
+    segments?: PreprFeatureConfig;
+    /** A/B variant switch, `Prepr-ABtesting` header and its cookie/query param. */
+    abTesting?: PreprFeatureConfig;
+    /**
+     * The site's own click-to-edit: the toolbar's Edit mode control, the stega
+     * tooltip/overlay and the close-edit pill.
+     *
+     * NOT a security control, and NOT the Prepr editor's live preview. When the
+     * site is framed by the editor, `prepr:initVE` still activates edit mode —
+     * that is the CMS operating inside its own iframe, not an affordance offered
+     * to visitors. See iframe-bridge.ts.
+     */
+    editMode?: PreprFeatureConfig;
+}
+interface PreprToolbarProps {
+    readonly activeSegment: string | null;
+    readonly activeVariant: string | null;
+    /** Available segments to personalize on. */
+    readonly segments?: readonly PreprSegment[];
+    /** @deprecated Alias for `segments`. */
+    readonly data?: readonly PreprSegment[];
+}
+type PreprVariant = 'A' | 'B';
+interface PreprHeaders {
+    readonly 'prepr-customer-id'?: string;
+    readonly 'Prepr-Segments'?: string;
+    readonly 'Prepr-ABtesting'?: PreprVariant;
+    readonly 'Prepr-Preview-Bar'?: 'true';
+    readonly 'Prepr-Context-utm_source'?: string;
+    readonly 'Prepr-Context-utm_medium'?: string;
+    readonly 'Prepr-Context-utm_term'?: string;
+    readonly 'Prepr-Context-utm_content'?: string;
+    readonly 'Prepr-Context-utm_campaign'?: string;
+    readonly 'Prepr-Context-initial_referral'?: string;
+    readonly 'Prepr-Visitor-IP'?: string;
+    readonly 'Prepr-Hubspot-Id'?: string;
+    readonly 'Prepr-Customer-Id-Created'?: 'true';
+    readonly 'Prepr-User-Agent'?: string;
+}
+type PreprErrorCode = 'INVALID_TOKEN' | 'MISSING_TOKEN' | 'HTTP_ERROR' | 'FETCH_ERROR' | 'INVALID_RESPONSE' | 'CONTEXT_ERROR';
+
 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;
 }
@@ -52,37 +113,6 @@ declare function handlePreprRequest(event: H3EventLike, options?: PreprMiddlewar
  */
 declare function getPreprHeadersFromEvent(event: Pick<H3EventLike, 'context'>): Headers;
 
-interface PreprSegment {
-    readonly _id: string;
-    readonly name: string;
-}
-interface PreprToolbarProps {
-    readonly activeSegment: string | null;
-    readonly activeVariant: string | null;
-    /** Available segments to personalize on. */
-    readonly segments?: readonly PreprSegment[];
-    /** @deprecated Alias for `segments`. */
-    readonly data?: readonly PreprSegment[];
-}
-type PreprVariant = 'A' | 'B';
-interface PreprHeaders {
-    readonly 'prepr-customer-id'?: string;
-    readonly 'Prepr-Segments'?: string;
-    readonly 'Prepr-ABtesting'?: PreprVariant;
-    readonly 'Prepr-Preview-Bar'?: 'true';
-    readonly 'Prepr-Context-utm_source'?: string;
-    readonly 'Prepr-Context-utm_medium'?: string;
-    readonly 'Prepr-Context-utm_term'?: string;
-    readonly 'Prepr-Context-utm_content'?: string;
-    readonly 'Prepr-Context-utm_campaign'?: string;
-    readonly 'Prepr-Context-initial_referral'?: string;
-    readonly 'Prepr-Visitor-IP'?: string;
-    readonly 'Prepr-Hubspot-Id'?: string;
-    readonly 'Prepr-Customer-Id-Created'?: 'true';
-    readonly 'Prepr-User-Agent'?: string;
-}
-type PreprErrorCode = 'INVALID_TOKEN' | 'MISSING_TOKEN' | 'HTTP_ERROR' | 'FETCH_ERROR' | 'INVALID_RESPONSE' | 'CONTEXT_ERROR';
-
 /** Returns the Prepr Customer ID from the request headers. */
 declare function getPreprUUID(headers: Headers): string | null;
 /** Returns the active segment from the request headers. */
@@ -96,7 +126,7 @@ declare function getPreprHeaders(headers: Headers): PreprHeaders;
  * Prepr GraphQL token. Ungated — gate on preview mode yourself (e.g.
  * `import.meta.dev`).
  */
-declare function getToolbarProps(headers: Headers, token: string): Promise<PreprToolbarProps>;
+declare function getToolbarProps(headers: Headers, token: string, features?: PreprFeatures): Promise<PreprToolbarProps>;
 
 /** Error thrown by the token helpers and the segments fetch. */
 declare class PreprError extends Error {

package/dist/nuxt/index.d.ts

@@ -1,6 +1,67 @@
+interface PreprSegment {
+    readonly _id: string;
+    readonly name: string;
+}
+/**
+ * Per-feature config. `false` is shorthand for `{ enabled: false }`; the object
+ * form leaves room for per-feature options later without a breaking change.
+ */
+type PreprFeatureConfig = boolean | {
+    enabled?: boolean;
+};
+/** Toolkit features a consumer can turn off. Omitted keys stay enabled. */
+interface PreprFeatures {
+    /** Segment picker, `Prepr-Segments` header and its cookie/query param. */
+    segments?: PreprFeatureConfig;
+    /** A/B variant switch, `Prepr-ABtesting` header and its cookie/query param. */
+    abTesting?: PreprFeatureConfig;
+    /**
+     * The site's own click-to-edit: the toolbar's Edit mode control, the stega
+     * tooltip/overlay and the close-edit pill.
+     *
+     * NOT a security control, and NOT the Prepr editor's live preview. When the
+     * site is framed by the editor, `prepr:initVE` still activates edit mode —
+     * that is the CMS operating inside its own iframe, not an affordance offered
+     * to visitors. See iframe-bridge.ts.
+     */
+    editMode?: PreprFeatureConfig;
+}
+interface PreprToolbarProps {
+    readonly activeSegment: string | null;
+    readonly activeVariant: string | null;
+    /** Available segments to personalize on. */
+    readonly segments?: readonly PreprSegment[];
+    /** @deprecated Alias for `segments`. */
+    readonly data?: readonly PreprSegment[];
+}
+type PreprVariant = 'A' | 'B';
+interface PreprHeaders {
+    readonly 'prepr-customer-id'?: string;
+    readonly 'Prepr-Segments'?: string;
+    readonly 'Prepr-ABtesting'?: PreprVariant;
+    readonly 'Prepr-Preview-Bar'?: 'true';
+    readonly 'Prepr-Context-utm_source'?: string;
+    readonly 'Prepr-Context-utm_medium'?: string;
+    readonly 'Prepr-Context-utm_term'?: string;
+    readonly 'Prepr-Context-utm_content'?: string;
+    readonly 'Prepr-Context-utm_campaign'?: string;
+    readonly 'Prepr-Context-initial_referral'?: string;
+    readonly 'Prepr-Visitor-IP'?: string;
+    readonly 'Prepr-Hubspot-Id'?: string;
+    readonly 'Prepr-Customer-Id-Created'?: 'true';
+    readonly 'Prepr-User-Agent'?: string;
+}
+type PreprErrorCode = 'INVALID_TOKEN' | 'MISSING_TOKEN' | 'HTTP_ERROR' | 'FETCH_ERROR' | 'INVALID_RESPONSE' | 'CONTEXT_ERROR';
+
 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;
 }
@@ -52,37 +113,6 @@ declare function handlePreprRequest(event: H3EventLike, options?: PreprMiddlewar
  */
 declare function getPreprHeadersFromEvent(event: Pick<H3EventLike, 'context'>): Headers;
 
-interface PreprSegment {
-    readonly _id: string;
-    readonly name: string;
-}
-interface PreprToolbarProps {
-    readonly activeSegment: string | null;
-    readonly activeVariant: string | null;
-    /** Available segments to personalize on. */
-    readonly segments?: readonly PreprSegment[];
-    /** @deprecated Alias for `segments`. */
-    readonly data?: readonly PreprSegment[];
-}
-type PreprVariant = 'A' | 'B';
-interface PreprHeaders {
-    readonly 'prepr-customer-id'?: string;
-    readonly 'Prepr-Segments'?: string;
-    readonly 'Prepr-ABtesting'?: PreprVariant;
-    readonly 'Prepr-Preview-Bar'?: 'true';
-    readonly 'Prepr-Context-utm_source'?: string;
-    readonly 'Prepr-Context-utm_medium'?: string;
-    readonly 'Prepr-Context-utm_term'?: string;
-    readonly 'Prepr-Context-utm_content'?: string;
-    readonly 'Prepr-Context-utm_campaign'?: string;
-    readonly 'Prepr-Context-initial_referral'?: string;
-    readonly 'Prepr-Visitor-IP'?: string;
-    readonly 'Prepr-Hubspot-Id'?: string;
-    readonly 'Prepr-Customer-Id-Created'?: 'true';
-    readonly 'Prepr-User-Agent'?: string;
-}
-type PreprErrorCode = 'INVALID_TOKEN' | 'MISSING_TOKEN' | 'HTTP_ERROR' | 'FETCH_ERROR' | 'INVALID_RESPONSE' | 'CONTEXT_ERROR';
-
 /** Returns the Prepr Customer ID from the request headers. */
 declare function getPreprUUID(headers: Headers): string | null;
 /** Returns the active segment from the request headers. */
@@ -96,7 +126,7 @@ declare function getPreprHeaders(headers: Headers): PreprHeaders;
  * Prepr GraphQL token. Ungated — gate on preview mode yourself (e.g.
  * `import.meta.dev`).
  */
-declare function getToolbarProps(headers: Headers, token: string): Promise<PreprToolbarProps>;
+declare function getToolbarProps(headers: Headers, token: string, features?: PreprFeatures): Promise<PreprToolbarProps>;
 
 /** Error thrown by the token helpers and the segments fetch. */
 declare class PreprError extends Error {

package/dist/nuxt/index.js

@@ -1,5 +1,5 @@
 // src/version.ts
-var VERSION = "0.1.0-beta.5";
+var VERSION = "0.2.0-beta.2";
 
 // src/core/constants.ts
 var COOKIE_PREVIEW_MODE = "Prepr-Preview-Mode";
@@ -12,6 +12,24 @@ var PARAM_VARIANT = "prepr_preview_ab";
 var PARAM_HIDE_BAR = "prepr_hide_bar";
 var ONE_YEAR_SECONDS = 60 * 60 * 24 * 365;
 
+// 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/middleware.ts
 var UTM_PARAMS = [
   "utm_source",
@@ -95,7 +113,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";
@@ -115,16 +134,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) {
@@ -137,7 +156,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) {
@@ -316,16 +335,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
   };
@@ -344,8 +366,8 @@ function getActiveVariant(headers) {
 function getPreprHeaders(headers) {
   return getPreprHeadersFromHeaders(headers);
 }
-async function getToolbarProps(headers, token) {
-  return getToolbarPropsFromHeaders(headers, token);
+async function getToolbarProps(headers, token, features) {
+  return getToolbarPropsFromHeaders(headers, token, features);
 }
 export {
   PREPR_CONTEXT_KEY,

package/dist/{pixel-DVSJQC0K.d.cts → pixel-763p7m6A.d.cts}

@@ -9,9 +9,65 @@ interface PreprSegment {
     readonly _id: string;
     readonly name: string;
 }
+/**
+ * Per-feature config. `false` is shorthand for `{ enabled: false }`; the object
+ * form leaves room for per-feature options later without a breaking change.
+ */
+type PreprFeatureConfig = boolean | {
+    enabled?: boolean;
+};
+/** Toolkit features a consumer can turn off. Omitted keys stay enabled. */
+interface PreprFeatures {
+    /** Segment picker, `Prepr-Segments` header and its cookie/query param. */
+    segments?: PreprFeatureConfig;
+    /** A/B variant switch, `Prepr-ABtesting` header and its cookie/query param. */
+    abTesting?: PreprFeatureConfig;
+    /**
+     * The site's own click-to-edit: the toolbar's Edit mode control, the stega
+     * tooltip/overlay and the close-edit pill.
+     *
+     * NOT a security control, and NOT the Prepr editor's live preview. When the
+     * site is framed by the editor, `prepr:initVE` still activates edit mode —
+     * that is the CMS operating inside its own iframe, not an affordance offered
+     * to visitors. See iframe-bridge.ts.
+     */
+    editMode?: PreprFeatureConfig;
+}
+/** `PreprFeatures` with every key resolved to a boolean. */
+interface ResolvedPreprFeatures {
+    readonly segments: boolean;
+    readonly abTesting: boolean;
+    readonly editMode: boolean;
+}
 interface PreprToolbarOptions {
     debug?: boolean;
     locale?: Locale;
+    /** Disable features app-wide. Pass the same object to the middleware. */
+    features?: PreprFeatures;
+}
+/**
+ * Options for the preview runtime. Two independent axes: `features` decides
+ * *what runs*, `ui` decides *whether the toolbar is visible*.
+ */
+interface PreprPreviewOptions extends PreprToolbarOptions {
+    /**
+     * Mount the visible `<prepr-toolbar>` element. Default `true`.
+     *
+     * `false` keeps every non-visual side effect wired — click-to-edit, the
+     * editor bridge, scroll restore, cookies and headers — with no chrome of its
+     * own. That is how a site gets live editing, or editor scroll restore, while
+     * rendering its own UI instead of the bar.
+     *
+     * Already implied inside the editor's iframe (the CMS owns the chrome there)
+     * and by `?prepr_hide_bar=true`, so this option is for consumers who want a
+     * headless preview by their own choice.
+     */
+    ui?: boolean;
+    /**
+     * Replace the `*.prepr.io` editor-origin wildcard with an exact list.
+     * Intended for self-hosted editors; when set, the wildcard no longer applies.
+     */
+    allowedEditorOrigins?: string[];
 }
 interface PreprToolbarProps {
     readonly activeSegment: string | null;
@@ -21,6 +77,13 @@ interface PreprToolbarProps {
     /** @deprecated Alias for `segments`. */
     readonly data?: readonly PreprSegment[];
 }
+/**
+ * Prop type for the framework `<PreprToolbar>` components: the toolbar data
+ * plus the options bag core `createPreprPreview` accepts.
+ */
+interface PreprToolbarComponentProps extends PreprToolbarProps {
+    options?: PreprPreviewOptions;
+}
 type PreprHeaderName = 'prepr-customer-id' | 'Prepr-Segments' | 'Prepr-ABtesting' | 'Prepr-User-Agent';
 type PreprVariant = 'A' | 'B';
 type PreprEnvironment = 'preview' | 'production';
@@ -91,4 +154,4 @@ declare function trackEvent(name: string, data?: string | Record<string, unknown
 /** Loader-independent like `trackEvent`; warns once if no pixel is installed. */
 declare function setTrackingParam(key: string, value: string): void;
 
-export { type Locale as L, type PreprSegment as P, type PreprVariant as a, type PreprToolbarProps as b, type PreprToolbarOptions as c, type PreprErrorCode as d, type PreprHeaders as e, type PreprEnvironment as f, type PreprEventType as g, type PreprHeaderName as h, type PreprPixelConfig as i, loadTrackingPixel as l, setTrackingParam as s, trackEvent as t };
+export { type Locale as L, type PreprFeatures as P, type ResolvedPreprFeatures as R, type PreprSegment as a, type PreprVariant as b, type PreprToolbarProps as c, type PreprPreviewOptions as d, type PreprErrorCode as e, type PreprHeaders as f, type PreprEnvironment as g, type PreprEventType as h, type PreprFeatureConfig as i, type PreprHeaderName as j, type PreprPixelConfig as k, type PreprToolbarComponentProps as l, type PreprToolbarOptions as m, loadTrackingPixel as n, setTrackingParam as s, trackEvent as t };

package/dist/{pixel-DVSJQC0K.d.ts → pixel-763p7m6A.d.ts}

@@ -9,9 +9,65 @@ interface PreprSegment {
     readonly _id: string;
     readonly name: string;
 }
+/**
+ * Per-feature config. `false` is shorthand for `{ enabled: false }`; the object
+ * form leaves room for per-feature options later without a breaking change.
+ */
+type PreprFeatureConfig = boolean | {
+    enabled?: boolean;
+};
+/** Toolkit features a consumer can turn off. Omitted keys stay enabled. */
+interface PreprFeatures {
+    /** Segment picker, `Prepr-Segments` header and its cookie/query param. */
+    segments?: PreprFeatureConfig;
+    /** A/B variant switch, `Prepr-ABtesting` header and its cookie/query param. */
+    abTesting?: PreprFeatureConfig;
+    /**
+     * The site's own click-to-edit: the toolbar's Edit mode control, the stega
+     * tooltip/overlay and the close-edit pill.
+     *
+     * NOT a security control, and NOT the Prepr editor's live preview. When the
+     * site is framed by the editor, `prepr:initVE` still activates edit mode —
+     * that is the CMS operating inside its own iframe, not an affordance offered
+     * to visitors. See iframe-bridge.ts.
+     */
+    editMode?: PreprFeatureConfig;
+}
+/** `PreprFeatures` with every key resolved to a boolean. */
+interface ResolvedPreprFeatures {
+    readonly segments: boolean;
+    readonly abTesting: boolean;
+    readonly editMode: boolean;
+}
 interface PreprToolbarOptions {
     debug?: boolean;
     locale?: Locale;
+    /** Disable features app-wide. Pass the same object to the middleware. */
+    features?: PreprFeatures;
+}
+/**
+ * Options for the preview runtime. Two independent axes: `features` decides
+ * *what runs*, `ui` decides *whether the toolbar is visible*.
+ */
+interface PreprPreviewOptions extends PreprToolbarOptions {
+    /**
+     * Mount the visible `<prepr-toolbar>` element. Default `true`.
+     *
+     * `false` keeps every non-visual side effect wired — click-to-edit, the
+     * editor bridge, scroll restore, cookies and headers — with no chrome of its
+     * own. That is how a site gets live editing, or editor scroll restore, while
+     * rendering its own UI instead of the bar.
+     *
+     * Already implied inside the editor's iframe (the CMS owns the chrome there)
+     * and by `?prepr_hide_bar=true`, so this option is for consumers who want a
+     * headless preview by their own choice.
+     */
+    ui?: boolean;
+    /**
+     * Replace the `*.prepr.io` editor-origin wildcard with an exact list.
+     * Intended for self-hosted editors; when set, the wildcard no longer applies.
+     */
+    allowedEditorOrigins?: string[];
 }
 interface PreprToolbarProps {
     readonly activeSegment: string | null;
@@ -21,6 +77,13 @@ interface PreprToolbarProps {
     /** @deprecated Alias for `segments`. */
     readonly data?: readonly PreprSegment[];
 }
+/**
+ * Prop type for the framework `<PreprToolbar>` components: the toolbar data
+ * plus the options bag core `createPreprPreview` accepts.
+ */
+interface PreprToolbarComponentProps extends PreprToolbarProps {
+    options?: PreprPreviewOptions;
+}
 type PreprHeaderName = 'prepr-customer-id' | 'Prepr-Segments' | 'Prepr-ABtesting' | 'Prepr-User-Agent';
 type PreprVariant = 'A' | 'B';
 type PreprEnvironment = 'preview' | 'production';
@@ -91,4 +154,4 @@ declare function trackEvent(name: string, data?: string | Record<string, unknown
 /** Loader-independent like `trackEvent`; warns once if no pixel is installed. */
 declare function setTrackingParam(key: string, value: string): void;
 
-export { type Locale as L, type PreprSegment as P, type PreprVariant as a, type PreprToolbarProps as b, type PreprToolbarOptions as c, type PreprErrorCode as d, type PreprHeaders as e, type PreprEnvironment as f, type PreprEventType as g, type PreprHeaderName as h, type PreprPixelConfig as i, loadTrackingPixel as l, setTrackingParam as s, trackEvent as t };
+export { type Locale as L, type PreprFeatures as P, type ResolvedPreprFeatures as R, type PreprSegment as a, type PreprVariant as b, type PreprToolbarProps as c, type PreprPreviewOptions as d, type PreprErrorCode as e, type PreprHeaders as f, type PreprEnvironment as g, type PreprEventType as h, type PreprFeatureConfig as i, type PreprHeaderName as j, type PreprPixelConfig as k, type PreprToolbarComponentProps as l, type PreprToolbarOptions as m, loadTrackingPixel as n, setTrackingParam as s, trackEvent as t };