@pushwoosh/websdk-common 0.0.0 → 6.16.0

package/web-popups/constants.d.ts

@@ -0,0 +1,71 @@
+import { type CSSProperties } from 'react';
+import { type WebPopupButtonVariant, type WebPopupColors, type WebPopupRatingScale, type WebPopupResolvedColors, type WebPopupSlot, type WebPopupTextVariant } from './types';
+/**
+ * Current stored-format version (WebPopupJson.version). Version 2 = the
+ * layout-tree format (nested containers + Content/Image leaves, named content
+ * zones). Version 1 (flat layout + single slot list) is retired without a
+ * migration path — v1 popups are treated as broken, same as the pre-engine
+ * ai-builder format.
+ */
+export declare const WEB_POPUP_VERSION = 2;
+export declare const WEB_POPUP_LAYOUT_MAX_DEPTH = 10;
+export declare const WEB_POPUP_LAYOUT_MAX_NODES = 100;
+/** Protocols allowed in button hrefs (plus relative `#`/`/`/`?` prefixes). */
+export declare const SAFE_URL_PROTOCOL: RegExp;
+export declare const WEB_POPUP_FONT_STACK = "Inter, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif";
+export declare const WEB_POPUP_TEXT_COLOR = "#101828";
+export declare const WEB_POPUP_TEXT_SECONDARY_COLOR = "#667085";
+export declare const WEB_POPUP_ACCENT_COLOR = "#2970FF";
+export declare const WEB_POPUP_BACKGROUND_COLOR = "#FFFFFF";
+/** Label over an accent fill in the light scheme; dark picks it by accent luminance. */
+export declare const WEB_POPUP_ON_ACCENT_COLOR = "#FFFFFF";
+export declare const WEB_POPUP_DEFAULT_COLORS: WebPopupColors;
+/** Fallback width used when a fixed-width context needs a number anyway. */
+export declare const WEB_POPUP_DEFAULT_WIDTH = 360;
+export declare const WEB_POPUP_TEXT_VARIANT_STYLES: Record<WebPopupTextVariant, CSSProperties>;
+/**
+ * A text slot's color: the palette's main/secondary role by variant; in an
+ * 'inverse' zone (over a background image) — colors.textInverse, with the
+ * secondary variants toned translucent. Undefined for a non-inverse 'icon'
+ * (an emoji line inherits — its glyphs aren't recolorable anyway).
+ */
+export declare function webPopupTextColor(variant: WebPopupTextVariant, colors: WebPopupColors, inverse: boolean): string | undefined;
+/** The dark fill under a container's background image while it loads. */
+export declare const WEB_POPUP_BG_SECTION_FALLBACK = "#1D2939";
+export type WebPopupSlotRole = 'heading' | 'text' | 'action';
+export declare function webPopupSlotRole(slot: WebPopupSlot): WebPopupSlotRole;
+export declare function webPopupSlotGap(prev: WebPopupSlotRole, next: WebPopupSlotRole): number;
+export declare const WEB_POPUP_TEXT_SLOT_PADDING = "4px 0";
+export declare const WEB_POPUP_BUTTON_SLOT_PADDING = "8px 0 4px";
+/**
+ * The button pill both button slots and a form slot's submit button render
+ * with — buttons pair the accent with white (primary = accent fill + white
+ * label, secondary = white fill + accent outline). Shared with the editor's
+ * canvas (parity contract).
+ */
+export declare function webPopupButtonPillStyle(variant: WebPopupButtonVariant, colors: WebPopupResolvedColors): CSSProperties;
+export declare const WEB_POPUP_FORM_INPUT_BORDER = "#D0D5DD";
+export declare const WEB_POPUP_FORM_ERROR_COLOR = "#D92D20";
+/** The error red lifted for a dark background — the same Untitled UI ramp, three steps up. */
+export declare const WEB_POPUP_FORM_ERROR_COLOR_DARK = "#FDA29B";
+export declare function webPopupFormInputStyle(colors: WebPopupResolvedColors, borderColor?: string): CSSProperties;
+export declare const WEB_POPUP_FORM_DEFAULTS: {
+    readonly submitLabel: "Subscribe";
+    readonly successMessage: "Thanks for subscribing!";
+    readonly confirmEmailMessage: "Please check your inbox and confirm your email.";
+};
+export declare const WEB_POPUP_CHOICE_DEFAULTS: {
+    readonly submitLabel: "Save";
+    readonly successMessage: "Thanks! Your choice is saved.";
+};
+export declare const WEB_POPUP_RATING_DEFAULTS: {
+    readonly submitLabel: "Send";
+    readonly successMessage: "Thanks for the feedback!";
+};
+export declare function webPopupRatingScores(scale: WebPopupRatingScale): number[];
+/** Options a `choice` slot may carry; exported so the editor can't offer one normalization drops. */
+export declare const WEB_POPUP_MAX_CHOICE_OPTIONS = 12;
+/** What a slot says when the host callback rejected: nothing actionable, so it's retryable. */
+export declare const WEB_POPUP_RETRY_ERROR = "Something went wrong. Please try again.";
+export declare const WEB_POPUP_KEYFRAMES = "\n@keyframes pw-vpopup-fade { from { opacity: 0; } }\n@keyframes pw-vpopup-slide { from { opacity: 0; translate: 0 28px; } }\n@keyframes pw-vpopup-overlay { from { opacity: 0; } }\n@keyframes pw-vpopup-page { from { opacity: 0; } }\n";
+export declare const WEB_POPUP_PAGE_TRANSITION_MS = 300;

package/web-popups/constants.js

@@ -0,0 +1,216 @@
+/**
+ * Current stored-format version (WebPopupJson.version). Version 2 = the
+ * layout-tree format (nested containers + Content/Image leaves, named content
+ * zones). Version 1 (flat layout + single slot list) is retired without a
+ * migration path — v1 popups are treated as broken, same as the pre-engine
+ * ai-builder format.
+ */
+export const WEB_POPUP_VERSION = 2;
+// Bomb protection for the embedded layout tree — the json travels through a
+// public API, so the parser refuses to walk pathological trees.
+export const WEB_POPUP_LAYOUT_MAX_DEPTH = 10;
+export const WEB_POPUP_LAYOUT_MAX_NODES = 100;
+/** Protocols allowed in button hrefs (plus relative `#`/`/`/`?` prefixes). */
+export const SAFE_URL_PROTOCOL = /^(https?:|mailto:|tel:)/i;
+export const WEB_POPUP_FONT_STACK = 'Inter, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif';
+// Palette defaults (mirror the editor's popup theme) — what a popup gets for
+// any WebPopupColors entry its json doesn't set.
+export const WEB_POPUP_TEXT_COLOR = '#101828';
+export const WEB_POPUP_TEXT_SECONDARY_COLOR = '#667085';
+export const WEB_POPUP_ACCENT_COLOR = '#2970FF';
+export const WEB_POPUP_BACKGROUND_COLOR = '#FFFFFF';
+/** Label over an accent fill in the light scheme; dark picks it by accent luminance. */
+export const WEB_POPUP_ON_ACCENT_COLOR = '#FFFFFF';
+export const WEB_POPUP_DEFAULT_COLORS = {
+  background: WEB_POPUP_BACKGROUND_COLOR,
+  accent: WEB_POPUP_ACCENT_COLOR,
+  text: WEB_POPUP_TEXT_COLOR,
+  textSecondary: WEB_POPUP_TEXT_SECONDARY_COLOR,
+  textInverse: '#FFFFFF'
+};
+/** Fallback width used when a fixed-width context needs a number anyway. */
+export const WEB_POPUP_DEFAULT_WIDTH = 360;
+// Per-variant text styles — the same numbers the editor's canvas derives from
+// its theme presets. No colors here: those come from the popup palette via
+// webPopupTextColor below.
+export const WEB_POPUP_TEXT_VARIANT_STYLES = {
+  h1: {
+    fontSize: 24,
+    fontWeight: 600,
+    lineHeight: 1.25
+  },
+  h2: {
+    fontSize: 18,
+    fontWeight: 600,
+    lineHeight: 1.3
+  },
+  h3: {
+    fontSize: 16,
+    fontWeight: 600,
+    lineHeight: 1.35
+  },
+  body: {
+    fontSize: 14,
+    fontWeight: 'normal',
+    lineHeight: 1.5
+  },
+  caption: {
+    fontSize: 12,
+    fontWeight: 'normal',
+    lineHeight: 1.4
+  },
+  eyebrow: {
+    fontSize: 11,
+    fontWeight: 600,
+    letterSpacing: '0.08em',
+    lineHeight: 1.4
+  },
+  icon: {
+    fontSize: 24,
+    lineHeight: 1.2
+  }
+};
+// Inverse-tone translucency per text style: headings full-strength, the
+// secondary variants toned down — same rhythm the palette's default white
+// set always had.
+const INVERSE_TEXT_ALPHAS = {
+  h1: 1,
+  h2: 1,
+  h3: 1,
+  icon: 1,
+  eyebrow: 0.8,
+  body: 0.9,
+  caption: 0.75
+};
+// colors.textInverse at the given opacity. Only #rgb/#rrggbb can be blended;
+// any other author-supplied css color renders full-strength rather than
+// being guessed at.
+function inverseColorAt(color, alpha) {
+  if (alpha >= 1) return color;
+  const hex = /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/.exec(color)?.[1];
+  if (!hex) return color;
+  const full = hex.length === 3 ? hex.split('').map(c => c + c).join('') : hex;
+  const [r, g, b] = [0, 2, 4].map(i => parseInt(full.slice(i, i + 2), 16));
+  return `rgba(${r}, ${g}, ${b}, ${alpha})`;
+}
+/**
+ * A text slot's color: the palette's main/secondary role by variant; in an
+ * 'inverse' zone (over a background image) — colors.textInverse, with the
+ * secondary variants toned translucent. Undefined for a non-inverse 'icon'
+ * (an emoji line inherits — its glyphs aren't recolorable anyway).
+ */
+export function webPopupTextColor(variant, colors, inverse) {
+  if (inverse) return inverseColorAt(colors.textInverse, INVERSE_TEXT_ALPHAS[variant] ?? 1);
+  if (variant === 'icon') return undefined;
+  return variant === 'caption' || variant === 'eyebrow' ? colors.textSecondary : colors.text;
+}
+/** The dark fill under a container's background image while it loads. */
+export const WEB_POPUP_BG_SECTION_FALLBACK = '#1D2939';
+const HEADING_VARIANTS = ['h1', 'h2', 'h3', 'icon'];
+export function webPopupSlotRole(slot) {
+  // An icon reads as the line above a title, so it hugs what follows; a
+  // countdown wants a block's air, which the 'action' fallback gives it.
+  if (slot.type === 'glyph') return 'heading';
+  if (slot.type !== 'text') return 'action';
+  return HEADING_VARIANTS.includes(slot.variant) ? 'heading' : 'text';
+}
+export function webPopupSlotGap(prev, next) {
+  if (next === 'action') return prev === 'action' ? 6 : 16;
+  if (next === 'text' && prev === 'heading') return 4;
+  return 8;
+}
+// Paddings INSIDE a form slot (field rows, submit pill); the rhythm above
+// owns the space BETWEEN slots.
+export const WEB_POPUP_TEXT_SLOT_PADDING = '4px 0';
+export const WEB_POPUP_BUTTON_SLOT_PADDING = '8px 0 4px';
+/**
+ * The button pill both button slots and a form slot's submit button render
+ * with — buttons pair the accent with white (primary = accent fill + white
+ * label, secondary = white fill + accent outline). Shared with the editor's
+ * canvas (parity contract).
+ */
+export function webPopupButtonPillStyle(variant, colors) {
+  return {
+    display: 'block',
+    boxSizing: 'border-box',
+    width: '100%',
+    padding: '10px 25px',
+    borderRadius: 6,
+    fontSize: 14,
+    fontWeight: 600,
+    fontFamily: 'inherit',
+    lineHeight: 1.5,
+    textAlign: 'center',
+    textDecoration: 'none',
+    cursor: 'pointer',
+    ...(variant === 'secondary' ? {
+      backgroundColor: colors.surface,
+      color: colors.accent,
+      border: `1px solid ${colors.accent}`
+    } : {
+      backgroundColor: colors.accent,
+      color: colors.onAccent,
+      border: 'none'
+    })
+  };
+}
+// Form-slot input chrome, shared with the editor's canvas (parity contract):
+// a `surface` card whatever the zone tone, only the border varies.
+export const WEB_POPUP_FORM_INPUT_BORDER = '#D0D5DD';
+export const WEB_POPUP_FORM_ERROR_COLOR = '#D92D20';
+/** The error red lifted for a dark background — the same Untitled UI ramp, three steps up. */
+export const WEB_POPUP_FORM_ERROR_COLOR_DARK = '#FDA29B';
+export function webPopupFormInputStyle(colors, borderColor = colors.border) {
+  return {
+    display: 'block',
+    boxSizing: 'border-box',
+    width: '100%',
+    padding: '10px 12px',
+    borderRadius: 6,
+    fontSize: 14,
+    fontFamily: 'inherit',
+    lineHeight: 1.5,
+    backgroundColor: colors.surface,
+    color: colors.surfaceText,
+    border: `1px solid ${borderColor}`,
+    outline: 'none'
+  };
+}
+// What a normalized form slot falls back to when the json omits the copy —
+// also the editor's defaults for a freshly added slot.
+export const WEB_POPUP_FORM_DEFAULTS = {
+  submitLabel: 'Subscribe',
+  successMessage: 'Thanks for subscribing!',
+  confirmEmailMessage: 'Please check your inbox and confirm your email.'
+};
+// What a normalized choice slot falls back to when the json omits the copy.
+export const WEB_POPUP_CHOICE_DEFAULTS = {
+  submitLabel: 'Save',
+  successMessage: 'Thanks! Your choice is saved.'
+};
+// Same, for a rating slot.
+export const WEB_POPUP_RATING_DEFAULTS = {
+  submitLabel: 'Send',
+  successMessage: 'Thanks for the feedback!'
+};
+// The scores a scale offers, in display order; thumbs are 0/1 so `score` stays
+// "higher is better" everywhere. Shared with the editor canvas (parity).
+export function webPopupRatingScores(scale) {
+  if (scale === 'nps') return [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
+  if (scale === 'stars') return [1, 2, 3, 4, 5];
+  return [0, 1];
+}
+/** Options a `choice` slot may carry; exported so the editor can't offer one normalization drops. */
+export const WEB_POPUP_MAX_CHOICE_OPTIONS = 12;
+/** What a slot says when the host callback rejected: nothing actionable, so it's retryable. */
+export const WEB_POPUP_RETRY_ERROR = 'Something went wrong. Please try again.';
+export const WEB_POPUP_KEYFRAMES = `
+@keyframes pw-vpopup-fade { from { opacity: 0; } }
+@keyframes pw-vpopup-slide { from { opacity: 0; translate: 0 28px; } }
+@keyframes pw-vpopup-overlay { from { opacity: 0; } }
+@keyframes pw-vpopup-page { from { opacity: 0; } }
+`;
+// Page-switch transition: the incoming page's content fades in while explicit
+// px sizes glide instead of jumping (auto sizes still snap — 'auto' can't be
+// transitioned). One duration for both so they read as a single move.
+export const WEB_POPUP_PAGE_TRANSITION_MS = 300;

package/web-popups/glyphs.d.ts

@@ -0,0 +1,8 @@
+import { type WebPopupGlyphName, type WebPopupGlyphSize } from './types';
+export declare const WEB_POPUP_GLYPH_PATHS: Record<WebPopupGlyphName, string>;
+/** The icon names a `glyph` slot may carry — derived, never a second list. */
+export declare const WEB_POPUP_GLYPH_NAMES: WebPopupGlyphName[];
+/** The sizes a glyph slot may take, px; the first is the normalization default. */
+export declare const WEB_POPUP_GLYPH_SIZES: WebPopupGlyphSize[];
+/** The thumb a 'thumbs' rating draws; not author-selectable, so not in the whitelist. */
+export declare const WEB_POPUP_THUMB_UP_PATH: string;

package/web-popups/glyphs.js

@@ -0,0 +1,30 @@
+// Hand-authored 24×24 stroke geometry, inline (no icon package in a script that
+// loads on the customer's site). EXHAUSTIVE: a name without geometry won't compile.
+export const WEB_POPUP_GLYPH_PATHS = {
+  bell: 'M6 10a6 6 0 0 1 12 0c0 4 1.5 5.5 2 6H4c.5-.5 2-2 2-6M10 20a2 2 0 0 0 4 0',
+  gift: 'M3 11h18v9a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1zM2.5 7h19v4h-19zM12 7v14' + 'M12 7c-1 0-3-.2-3.5-1a2 2 0 0 1 3.5-1 2 2 0 0 1 3.5 1c-.5.8-2.5 1-3.5 1z',
+  cart: 'M2 4h2.2l2.4 11.2A2 2 0 0 0 8.6 17H19M6 7h15l-2.2 7.5H8' + 'M10.5 20a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0M19.5 20a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0',
+  chart: 'M3 21h18M7 21V11M12 21V6M17 21v-8',
+  lock: 'M5 11h14v10H5zM8 11V8a4 4 0 0 1 8 0v3',
+  calendar: 'M4 6h16v15H4zM4 10h16M9 3v4M15 3v4',
+  check: 'M4 13l5 5L20 6',
+  star: 'M12 3l2.9 5.9 6.5.9-4.7 4.6 1.1 6.5-5.8-3.1-5.8 3.1 1.1-6.5L2.6 9.8l6.5-.9z',
+  clock: 'M21 12a9 9 0 1 1-18 0 9 9 0 0 1 18 0M12 7v5l4 2',
+  tag: 'M20.6 13.4l-7.2 7.2a2 2 0 0 1-2.8 0l-7-7A2 2 0 0 1 3 12.2V5a2 2 0 0 1 2-2h7.2a2 2 0 0 1 1.4.6' + 'l7 7a2 2 0 0 1 0 2.8zM9 8a1 1 0 1 1-2 0 1 1 0 0 1 2 0',
+  mail: 'M3 6h18v12H3zM3 7l9 6 9-6',
+  phone: 'M7 2h10a1 1 0 0 1 1 1v18a1 1 0 0 1-1 1H7a1 1 0 0 1-1-1V3a1 1 0 0 1 1-1M10 19h4',
+  download: 'M12 3v12M7 11l5 5 5-5M4 20h16',
+  play: 'M8 5l12 7-12 7z',
+  shield: 'M12 3l8 3v6c0 5-3.4 8.6-8 10-4.6-1.4-8-5-8-10V6z',
+  sparkle: 'M12 3l1.8 5.2L19 10l-5.2 1.8L12 17l-1.8-5.2L5 10l5.2-1.8z' + 'M18 15l.9 2.1 2.1.9-2.1.9-.9 2.1-.9-2.1L15 18l2.1-.9z',
+  percent: 'M19 5L5 19M8.5 8.5a2.5 2.5 0 1 1-5 0 2.5 2.5 0 0 1 5 0M20.5 15.5a2.5 2.5 0 1 1-5 0 2.5 2.5 0 0 1 5 0',
+  truck: 'M2 7h12v10H2zM14 10h4l3 3v4h-7' + 'M8.5 19a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0M20 19a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0',
+  ticket: 'M4 7h16v4a2 2 0 0 0 0 4v3H4v-3a2 2 0 0 0 0-4zM14 7v12',
+  user: 'M20 21a8 8 0 0 0-16 0M16 7a4 4 0 1 1-8 0 4 4 0 0 1 8 0'
+};
+/** The icon names a `glyph` slot may carry — derived, never a second list. */
+export const WEB_POPUP_GLYPH_NAMES = Object.keys(WEB_POPUP_GLYPH_PATHS);
+/** The sizes a glyph slot may take, px; the first is the normalization default. */
+export const WEB_POPUP_GLYPH_SIZES = [24, 32, 48];
+/** The thumb a 'thumbs' rating draws; not author-selectable, so not in the whitelist. */
+export const WEB_POPUP_THUMB_UP_PATH = 'M8 21V10l3.5-7A2 2 0 0 1 14 5v5h4.5a2 2 0 0 1 2 2.4' + 'l-1.3 6A2 2 0 0 1 17.2 21zM8 10H3.5v11H8';

package/web-popups/helpers.d.ts

@@ -0,0 +1,84 @@
+import { type WebPopupColors, type WebPopupDark, type WebPopupJson, type WebPopupParams, type WebPopupPlacement, type WebPopupResolvedPage, type WebPopupValueParam } from './types';
+export declare function safeUrl(url: string | undefined): string | undefined;
+/**
+ * The target/rel pair a popup link renders with: only an exact '_self' opts
+ * out of the default new tab (and of its noreferrer, which same-tab
+ * navigation doesn't need). One rule for both link kinds — the reader's
+ * button anchors and the sanitizer's inline text links.
+ */
+export declare function webPopupLinkTargetAttrs(target: string | null | undefined): {
+    target: '_blank' | '_self';
+    rel?: 'noreferrer';
+};
+/**
+ * Sanitize a text slot's html before it's injected into the page. The editor
+ * only ever writes inline formatting, but the json travels through a public
+ * API and renders on customers' sites — so on render only the inline tags
+ * survive (anything else is unwrapped to its text), every attribute is
+ * dropped, and links keep only a safeUrl-approved href plus their tab choice
+ * (target="_self" stays; everything else opens in a new tab).
+ */
+export declare function sanitizeWebPopupHtml(html: string): string;
+type LegacyColorFields = {
+    background?: unknown;
+    accent?: unknown;
+};
+/**
+ * The popup palette from API-writable params: `colors` entries when present,
+ * the legacy top-level background/accent underneath, palette defaults for the
+ * rest — always a complete WebPopupColors.
+ */
+export declare function normalizeWebPopupColors(params: Partial<WebPopupParams> & LegacyColorFields): WebPopupColors;
+export declare function normalizeWebPopupDark(params: Partial<WebPopupParams>, light: WebPopupColors): WebPopupDark | undefined;
+export declare function parseWebPopupJson(json: string): WebPopupJson | null;
+/** The editor's save path: model → PopupFormContent.json string. */
+export declare function stringifyWebPopup(params: WebPopupParams): string;
+/**
+ * The page's named layout values from API-writable json: capped count,
+ * whitelisted keys, short '$'-free value strings (substitution is single-pass
+ * and this keeps refs from even *looking* chainable), validated controls.
+ */
+export declare function normalizeWebPopupValues(raw: unknown): WebPopupValueParam[];
+/** The values as a substitution map (see substituteWebPopupLayoutValues). */
+export declare function webPopupValuesMap(values: WebPopupValueParam[]): Record<string, string>;
+/**
+ * Every subscription form code the popup's form slots reference (unique,
+ * empty codes skipped) — what a host records view stats for. Reads the RAW
+ * params (tolerant of malformed slots), so it works on parsed-but-unresolved
+ * json.
+ */
+export declare function collectWebPopupFormCodes(params: WebPopupParams): string[];
+export declare function webPopupExpired(params: WebPopupParams, nowMs: number): boolean;
+/**
+ * The popup box-size ceiling px, mirroring the layout tree's px clamp: the
+ * json is API-writable and the size lands as inline style on the customer's
+ * page. The editor clamps its Width/Height inputs to it too.
+ */
+export declare const WEB_POPUP_MAX_SIZE_PX = 2000;
+/**
+ * A page's final box dimension: the page's own (null = explicitly auto) over
+ * the chrome's, validated — a finite positive number clamped to the ceiling,
+ * or the literal 'stretch' (fill the viewport along that axis). 'stretch' is
+ * a HEIGHT value: the width axis has no such literal — absent already means
+ * stretch — so there an API-written one degrades to that same absence. A
+ * malformed page value falls back to the chrome (like an absent one), a
+ * malformed chrome value = auto. Exported for the editor — it must resolve
+ * and validate exactly like the runtime (parity contract), never fork this.
+ */
+export declare function resolveWebPopupPageSize(own: number | 'stretch' | null | undefined, shared: number | 'stretch' | undefined, axis: 'width'): number | undefined;
+export declare function resolveWebPopupPageSize(own: number | 'stretch' | null | undefined, shared: number | 'stretch' | undefined, axis: 'height'): number | 'stretch' | undefined;
+/**
+ * The renderable pages: each page carries its own embedded layout tree — no
+ * kind catalog at runtime. The page's named values are substituted into the
+ * tree first ($key tokens), then the result is validated/normalized
+ * (whitelisted props, unknown container types degrade to a Vertical stack) —
+ * so substituted values pass the same clamps as literals; pages whose layout
+ * isn't a tree at all are dropped. An empty result means the popup can't be
+ * rendered. width/height come out FINAL (page override ?? chrome, validated)
+ * — the renderer never falls back itself.
+ */
+export declare function resolveWebPopupPages(params: WebPopupParams): WebPopupResolvedPage[];
+/** The page shown first: startPage when it exists, else the first page. */
+export declare function startPageOf(params: WebPopupParams, pages: WebPopupResolvedPage[]): WebPopupResolvedPage;
+export declare function placementMaxSize(placement: WebPopupPlacement): string;
+export {};