@sonordev/site-kit 7.1.1 → 7.2.0

package/dist/shared/fresh-fetch.d.ts

@@ -21,8 +21,7 @@
  *     that directory between builds (Netlify does), so every later build
  *     replays the first response. That's how public/llms.txt shipped a
  *     months-old copy: its fetch carried no option, was cached with a one-year
- *     revalidate, and each build rewrote the same stale file (found on
- *     vsfconsultingservices.com, 2026-09-15).
+ *     revalidate, and each build rewrote the same stale file.
  *
  * So we call the original fetch Next keeps on the patched one and stay
  * invisible to the framework: no bailout, no cache entry, no effect on the

package/dist/shared/identity.d.ts

@@ -2,7 +2,7 @@
  * @sonordev/site-kit/shared — Unified Identity Management
  *
  * Single source of truth for visitor and session IDs across
- * Analytics, Signal, and Engage modules.
+ * Analytics, Signal, chat and popups.
  *
  * Storage keys:
  *   localStorage:    _sk_vid   (visitor ID, persists ~forever)

package/dist/shared/layers.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The layer a site's widgets stack on when the site sets nothing: popups,
+ * banners and toasts (SitePopups) and the chat launcher (SiteChat), with the
+ * chat window one below. Single source of truth for that default; the
+ * layout's `chat.zIndex` (or the deprecated `engage.zIndex`) overrides it.
+ */
+export declare const DEFAULT_WIDGET_Z_INDEX = 9999;

package/dist/shared/mid-form.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @sonordev/site-kit shared: is the visitor in the middle of a form?
+ *
+ * SINGLE SOURCE OF TRUTH for whether something may open over the page right
+ * now. SitePopups asks before any popup or toast opens on its own (whatever
+ * the trigger: immediate, delay, scroll or exit intent) and waits while the
+ * answer is yes.
+ * Don't write a second check; extend this one.
+ *
+ * Why it matters: a modal popup takes focus and hides the rest of the page
+ * from assistive technology while it's open. Opening one mid-form throws a
+ * person out of the field they're typing in, and an agent browser filling the
+ * form for someone (they act on the accessibility tree) loses every field it
+ * was about to fill.
+ *
+ * Mid-form means any of:
+ * - focus is on a field (input, textarea, select) that belongs to a form, or
+ *   inside a frame in a form (a payment provider's card field);
+ * - a form has a field the visitor filled: a value that isn't empty and isn't
+ *   the one the page rendered with, or one they typed into (watchFormInput);
+ * - a site-kit form is carrying what the visitor typed into its server-rendered
+ *   shell before it upgraded (FormEnhancer marks its wrapper
+ *   `data-sk-carried`; the upgraded fields are new elements nobody typed into
+ *   yet, and React keeps their default equal to their value);
+ * - a site-kit form is sending (`data-sk-state="submitting"`).
+ *
+ * Fields a visitor doesn't fill don't count: hidden inputs, buttons, fields
+ * nobody can see or reach (inert or aria-hidden), and site-kit's trap field.
+ */
+/**
+ * Remember which fields the visitor types into from here on. React keeps a
+ * controlled field's default value equal to its current value, so comparing
+ * the two can't see what someone typed into one; the input event can.
+ * Idempotent: one pair of capture listeners per document, kept for the page's
+ * life. SitePopups starts it when it mounts.
+ */
+export declare function watchFormInput(doc?: Document): void;
+/** Whether the visitor is in the middle of a form (see the module comment for what counts). */
+export declare function isVisitorMidForm(doc?: Document): boolean;
+export interface MidFormWaitOptions {
+    doc?: Document;
+    /** How long after focus leaves a field to look again. Default 1500ms. */
+    settleMs?: number;
+    /** How often to look again while waiting. Default 5000ms. */
+    pollMs?: number;
+}
+/**
+ * Run `open` now if the visitor isn't mid-form, otherwise as soon as they
+ * aren't: a moment after focus leaves a field, or on the next poll (a form
+ * that sent and cleared, or went away). Never gives up on its own; the
+ * returned function cancels the wait. `open` runs at most once.
+ */
+export declare function whenNotMidForm(open: () => void, options?: MidFormWaitOptions): () => void;

package/dist/shared/next-files.d.ts

@@ -4,7 +4,7 @@
  * SINGLE SOURCE OF TRUTH for "find the root layout / a page / the proxy". Each
  * CLI check used to carry its own candidate list, and the lists drifted: the OG
  * wiring rule only looked for `app/layout.tsx`, so `doctor` told a site whose
- * root layout is `app/layout.jsx` (heinrich-law-nextjs, 2026-09-14) that it had
+ * root layout is `app/layout.jsx` that it had
  * no layout at all. `geo` knew about `.jsx` but not `src/app`, and none of them
  * knew about `proxy.ts`. Route every lookup through here; never re-fork a list.
  *

package/dist/shared/publishCredential.d.ts

@@ -10,7 +10,7 @@
  *     `@sonordev/agency-site-kit`'s `AgencySiteKitLayout`.
  *
  * Do not re-fork this. Before it existed, agency sites hand-rolled their own
- * "set the globals on mount" component (upforge's `UptradeSiteKitInit`), and
+ * "set the globals on mount" component, and
  * because those copies had no access to the token manager they published the
  * RAW `sonor_` key into the client bundle — the exact exposure the mint exists
  * to prevent. Any layout that puts a credential on `window` goes through here.

package/dist/shared/reporting-gate.d.ts

@@ -1,6 +1,6 @@
 /**
  * Single source of truth for client reporting eligibility and credentials.
- * Analytics, fleet, SitemapSync and Engage all resolve through this gate.
+ * Analytics, fleet, SitemapSync, chat and popups all resolve through this gate.
  * Kept separate from transport wrappers so non-analytics modules stay lean.
  */
 /** Resolved destination for an analytics send. */

package/dist/shared/uuid.d.ts

@@ -10,8 +10,7 @@
  * deployed site viewed before its TLS cert provisions — or in older Safari,
  * `crypto.randomUUID` is `undefined`, so calling it unguarded throws
  * "crypto.randomUUID is not a function" DURING RENDER and crashes the whole
- * page. (Observed live on ramseydeal.com, 2026-07-21, while its cert was
- * pending.)
+ * page. (Observed live on a site whose cert was still pending.)
  *
  * `uuid()` degrades gracefully and NEVER throws:
  *   1. crypto.randomUUID()      — fast path; modern secure contexts.

package/dist/shared/version.d.ts

@@ -7,4 +7,4 @@
  * it matches package.json at publish time, and version.test.ts asserts it in
  * dev, so it can't silently drift.
  */
-export declare const SITE_KIT_VERSION = "7.1.1";
+export declare const SITE_KIT_VERSION = "7.2.0";

package/dist/shared/visual-viewport-gap.d.ts

@@ -3,8 +3,8 @@
  *
  * Single source of truth for measuring how far the layout viewport extends
  * below the visual viewport and publishing it as `--sk-vv-layout-gap` on
- * <html>. Moved into the kit from queencityriverboats.com and
- * destinyyachtcharters.com, which each carried a byte-identical copy.
+ * <html>. Moved into the kit from two sites that each carried a
+ * byte-identical copy.
  *
  * On a phone the two viewports can disagree (browser chrome, in-app browsers,
  * pinch zoom, an on-screen keyboard), and `position: fixed; bottom: …` is
@@ -15,7 +15,7 @@
  *   bottom: calc(24px + env(safe-area-inset-bottom, 0px) + var(--sk-vv-layout-gap, 0px));
  *
  * The Echo launcher and chat popup already include it (see
- * engage/launcher-placement.ts), so mounting the tracker is all a site needs
+ * chat/launcher-placement.ts), so mounting the tracker is all a site needs
  * for those; the property is also there for the site's own fixed UI.
  *
  * Opt-in on purpose. The gap also grows to the keyboard's height while a

package/dist/signal/index.js

@@ -1,6 +1,6 @@
 'use client';
-import { useSignalExperiment, useSignalEvent } from '../chunk-Q3S26EQA.js';
-export { SignalBridge, useSignal, useSignalConfig, useSignalEvent, useSignalExperiment, useSignalOutcome } from '../chunk-Q3S26EQA.js';
+import { useSignalExperiment, useSignalEvent } from '../chunk-S54ECQGY.js';
+export { SignalBridge, useSignal, useSignalConfig, useSignalEvent, useSignalExperiment, useSignalOutcome } from '../chunk-S54ECQGY.js';
 import '../chunk-PKBMQBKP.js';
 import React, { useEffect } from 'react';
 import { jsx, Fragment } from 'react/jsx-runtime';

package/dist/signal/types.d.ts

@@ -8,7 +8,7 @@ export interface SignalConfig {
     version: string;
     /** Whether Signal is enabled for this project */
     enabled: boolean;
-    /** Engage element overrides */
+    /** Popup overrides (the key keeps the retired Engage module's name) */
     engage?: {
         popups?: Record<string, EngageOverride>;
         nudges?: Record<string, EngageOverride>;

package/dist/site-config/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Site config from Portal (project-info) by API key.
+ * Site config from Sonor (project-info) by API key.
  * Resolves site_url and domain so consumers only need SONOR_API_KEY.
  */
 export interface SiteConfig {
@@ -11,7 +11,7 @@ export interface GetSiteConfigOptions {
     apiUrl?: string;
 }
 /**
- * Fetch site_url and domain from Portal project-info for the given API key.
+ * Fetch site_url and domain from Sonor project-info for the given API key.
  * Uses in-memory cache (TTL 10 min) keyed by apiKey.
  * Safe for Edge (middleware) and Node (route handlers).
  */

package/dist/sitemap/index.d.ts

@@ -2,7 +2,7 @@
  * @sonordev/site-kit - Sitemap Generator
  *
  * Automatically generates sitemap.xml from Next.js app directory structure.
- * Works at build time to discover all pages and sync them to Portal API.
+ * Works at build time to discover all pages and sync them to Sonor API.
  *
  * @example
  * ```ts
@@ -36,10 +36,10 @@ export interface SitemapEntry {
     images?: string[];
 }
 export interface SitemapConfig {
-    /** Base URL for the site (optional when apiKey is set; then resolved from Portal project-info) */
+    /** Base URL for the site (optional when apiKey is set; then resolved from Sonor project-info) */
     baseUrl?: string;
     /**
-     * Sub-site host this build belongs to (e.g. `bd-charlotte.com`) — the
+     * Sub-site host this build belongs to (e.g. `charlotte.example.com`) — the
      * multi-site `site` dimension. One Sonor project can host many domains, and
      * seo_pages is unique on (project_id, site, url), so shared paths like `/`
      * and `/terms` keep one row PER HOST. Tagging the sync keeps this build's
@@ -95,11 +95,11 @@ export interface SitemapConfig {
     resolveGenerateStaticParams?: boolean;
     /** Priority overrides by path pattern */
     priorities?: Record<string, number>;
-    /** Portal API URL for syncing (defaults to SONOR_API_URL or https://api.sonor.io) */
+    /** Sonor API URL for syncing (defaults to SONOR_API_URL or https://api.sonor.io) */
     apiUrl?: string;
-    /** Portal API key for syncing (defaults to SONOR_API_KEY) */
+    /** Sonor API key for syncing (defaults to SONOR_API_KEY) */
     apiKey?: string;
-    /** Disable auto-sync to Portal API */
+    /** Disable auto-sync to Sonor API */
     disableSync?: boolean;
     /** When true, await meta optimization before build completes (for build-time llms.txt with managed_llm_schema) */
     awaitMetaOptimization?: boolean;
@@ -111,7 +111,7 @@ export interface SitemapConfig {
      * build. It used to default to 120000ms, which only worked because a stale
      * Data Cache entry answered the request instantly (see shared/fresh-fetch.ts).
      *
-     * The write still often won't fit, and no value here makes it fit. Measured against a 191-page site, Portal takes ~27s for
+     * The write still often won't fit, and no value here makes it fit. Measured against a 191-page site, Sonor takes ~27s for
      * llms.txt and ~53s for llms-full.txt, because it generates each through
      * Signal's AEO skill (an LLM call). ~80s combined, inside a route Next
      * allows 60s. Any value low enough to protect the route is too low for the
@@ -123,7 +123,7 @@ export interface SitemapConfig {
      * dropped from the build — the fix is architectural, not numeric: set
      * `optimizedLLMsTxt: false` here and call `writeLLMsTxtToPublic` from a
      * postbuild script instead, where nothing imposes a 60s ceiling. Run it
-     * after `next build` so the sitemap has already synced to Portal, which is
+     * after `next build` so the sitemap has already synced to Sonor, which is
      * what the generation reads.
      *
      * Timing out is safe either way: writeLLMsTxtToPublic never persists a
@@ -136,10 +136,10 @@ export interface SitemapConfig {
     /**
      * The llms.txt "Agent access" section (writeLLMsTxtToPublic's `mcp`).
      * Default: on only for site-kit's built-in MCP server; a site with its own
-     * (upforge.io) is left alone. `false` forces it off, `true` on.
+     * is left alone. `false` forces it off, `true` on.
      */
     llmsAgentAccess?: boolean;
-    /** When Portal returns empty services, use this to supply local site data for llms.txt */
+    /** When Sonor returns empty services, use this to supply local site data for llms.txt */
     getLocalData?: () => Promise<import('../llms/types').LLMsDataResponse | null>;
     /** Pass-through to GET /api/public/llms/txt?publicSummaryOnly=true and local llms fallback */
     llmsPublicSummaryOnly?: boolean;
@@ -180,7 +180,7 @@ export interface SyncSitemapOptions {
     site?: string;
 }
 /**
- * Sync sitemap entries to Portal API
+ * Sync sitemap entries to Sonor API
  * Called automatically by createSitemap at build time
  */
 export declare function syncSitemapToPortal(entries: SitemapEntry[], apiUrl: string, apiKey: string, options?: SyncSitemapOptions): Promise<{
@@ -190,7 +190,7 @@ export declare function syncSitemapToPortal(entries: SitemapEntry[], apiUrl: str
 }>;
 /**
  * Create a sitemap generator function for Next.js
- * Automatically syncs to Portal API at build time.
+ * Automatically syncs to Sonor API at build time.
  *
  * @example
  * ```ts
@@ -203,7 +203,7 @@ export declare function syncSitemapToPortal(entries: SitemapEntry[], apiUrl: str
  * ```
  */
 /**
- * Fetches published portfolio items from Portal API and returns them as sitemap paths.
+ * Fetches published portfolio items from Sonor API and returns them as sitemap paths.
  * Use this in createSitemap's additionalPaths to include portfolio routes.
  *
  * @example

package/dist/sitemap/index.js

@@ -1,11 +1,11 @@
-export { createSitemap, getPortfolioPaths, syncSitemapToPortal } from '../chunk-HAG4YIZY.js';
+export { createSitemap, getPortfolioPaths, syncSitemapToPortal } from '../chunk-R46IQIGK.js';
 import '../chunk-Z22QVHT4.js';
-import '../chunk-J4D6ZXRW.js';
-import '../chunk-GLHQ3LRO.js';
+import '../chunk-QL6XNPSD.js';
+import '../chunk-6U3VLV2C.js';
 import '../chunk-L5UOHS6E.js';
 import '../chunk-WMVK77ND.js';
 import '../chunk-VX5CMNMM.js';
-import '../chunk-4Y5FWDPM.js';
+import '../chunk-NZ4RXN3G.js';
 import '../chunk-MJP63SSS.js';
 import '../chunk-ZEGVKVD5.js';
 import '../chunk-YVKRYQRG.js';

package/dist/sitemap/shared.d.ts

@@ -15,8 +15,8 @@
  * carry it when the site does.
  *
  * The copies had already drifted (one treated `''` as the homepage, the others
- * didn't; one stripped embedded domains, another only rejected them). Keeping
- * one implementation is the CLAUDE.md "consolidate duplicated logic" rule.
+ * didn't; one stripped embedded domains, another only rejected them), so
+ * there's one implementation now.
  *
  * Pure string logic only — NO Node built-ins, NO React — so this file is safe to
  * import from the browser `SitemapSync` client component AND from the Node CLI.
@@ -100,7 +100,7 @@ export declare function isMalformedSitemapPath(path: string): boolean;
  * Next gives a prerendered route 60s (`staticPageGenerationTimeout`), then
  * retries it and fails the build. Sonor generates llms.txt through an LLM call
  * that takes roughly 27-60s, so the write can't reliably fit, and it runs
- * after the Portal sync has already spent part of the budget. Until 2026-09 a
+ * after Sonor sync has already spent part of the budget. Until 2026-09 a
  * one-year Data Cache entry hid this: the call ran live only on a site's first
  * build, and every later build replayed the stored response (a stale file).
  * With reads fresh (shared/fresh-fetch.ts), the write gets whatever is left of

package/dist/sites/site-param.d.ts

@@ -2,8 +2,8 @@
  * Append `site=<host>` to an API URL or endpoint path. Returns the input
  * unchanged when the host resolves empty.
  *
- *   withSiteParam('/public/articles/posts?page=2', 'bd-charlotte.com')
- *     → '/public/articles/posts?page=2&site=bd-charlotte.com'
+ *   withSiteParam('/public/articles/posts?page=2', 'charlotte.example.com')
+ *     → '/public/articles/posts?page=2&site=charlotte.example.com'
  */
 export declare function withSiteParam(url: string, site?: string): string;
 /**

package/dist/slots/ManagedRichText.d.ts

@@ -23,7 +23,7 @@ export interface ManagedRichTextProps extends Omit<SlotResolveOptions, 'fallback
  * ```tsx
  * <div className="prose">
  *   <ManagedRichText id="about-intro" page="/about">
- *     {`We've built homes in **Cincinnati** since 1998.\n\n- Custom builds\n- Remodels`}
+ *     {`We've built homes in **Springfield** since 1998.\n\n- Custom builds\n- Remodels`}
  *   </ManagedRichText>
  * </div>
  * ```

package/dist/slots/ManagedSlot.d.ts

@@ -22,7 +22,7 @@ export interface ManagedSlotProps extends Omit<SlotResolveOptions, 'fallback'> {
  * ```tsx
  * <h1 className="hero-title">
  *   <ManagedSlot id="home-hero-headline" page="/">
- *     New Homes in Cincinnati & Northern Kentucky
+ *     New Homes in Springfield and Beyond
  *   </ManagedSlot>
  * </h1>
  * ```

package/dist/slots/index.d.ts

@@ -2,9 +2,7 @@
  * @sonordev/site-kit/website/slots — Managed Slots (3.0 spine, Pillar 1)
  *
  * Named, Sonor-managed copy inside developer-owned markup: text, rich text,
- * links and lists (the Website CMS; docs/WEBSITE-CMS.md).
- * Static-safe, fallback-first, signature-verified.
- * See docs/SITE-KIT-3.0-SPEC-SLOTS.md.
+ * links and lists. Static-safe, fallback-first, signature-verified.
  */
 export { ManagedSlot, default } from './ManagedSlot';
 export type { ManagedSlotProps } from './ManagedSlot';

package/dist/{socket-loader-R24ZSRSQ.js → socket-loader-CGIPEG74.js}

@@ -1,6 +1,6 @@
 import './chunk-PKBMQBKP.js';
 
-// src/engage/socket-loader.ts
+// src/chat/socket-loader.ts
 async function createSocket(url, opts) {
   const { io } = await import(
     /* webpackChunkName: "socket-io" */

package/dist/sync/index.js

@@ -1,6 +1,6 @@
-export { BookingWidget } from '../chunk-ZAWANWUS.js';
-export { createBooking, createSlotHold, detectTimezone, fetchAvailability, fetchAvailableDates, fetchBookingTypeDetails, fetchBookingTypes, formatDate, formatDuration, formatTime, prepareMeeting, releaseSlotHold } from '../chunk-EFPS56JA.js';
-import '../chunk-PXZ7LAOY.js';
-import '../chunk-OUNRFXDC.js';
-import '../chunk-6OL23QYD.js';
+export { BookingWidget } from '../chunk-GGORNBSC.js';
+export { createBooking, createSlotHold, detectTimezone, fetchAvailability, fetchAvailableDates, fetchBookingTypeDetails, fetchBookingTypes, formatDate, formatDuration, formatTime, prepareMeeting, releaseSlotHold } from '../chunk-BKY2ZNM7.js';
+import '../chunk-D6ZC7XKZ.js';
+import '../chunk-K4ZHAURD.js';
+import '../chunk-F24FNCTK.js';
 import '../chunk-PKBMQBKP.js';

package/dist/types.d.ts

@@ -1,7 +1,7 @@
 /**
  * @sonordev/site-kit - Shared types across all modules
  *
- * Site-kit ONLY calls Portal API - never Supabase directly.
+ * Site-kit ONLY calls Sonor API - never Supabase directly.
  * All data access goes through api.sonor.io with API key auth.
  */
 export interface BaseEntity {
@@ -14,6 +14,8 @@ export interface ProjectScoped {
 }
 export * from './seo/types';
 export * from './analytics/types';
-export * from './engage/types';
+export * from './chat/types';
+export * from './website/popup-types';
+export type { EngageAnalytics, EngageConfig, EngageElement, TargetingRules, TriggerConfig, WidgetConfig, WidgetType } from './engage/types';
 export * from './forms/types';
 export * from './articles/types';

package/dist/website/BlocksPopup.d.ts

@@ -3,7 +3,7 @@
  *
  * The site side of a blocks popup: re-checks the blocks, measures the site's
  * design once when the popup opens, and hands both to PopupBlocks.
- * EngageWidget loads this with a dynamic import, so the renderer, the
+ * SitePopups loads this with a dynamic import, so the renderer, the
  * contract and the design measurement download only when a blocks popup is
  * actually about to show (most page loads have none).
  */

package/dist/website/PopupBlocks.d.ts

@@ -3,7 +3,7 @@
  *
  * Draws a popup from its blocks (heading, formatted text, image, button,
  * divider) in the site's own design. SINGLE renderer for both places a popup
- * appears: on the site (EngageWidget, fed the measured tokens) and in Sonor's
+ * appears: on the site (SitePopups, fed the measured tokens) and in Sonor's
  * builder preview (fed the tokens the site reported). React only, no Next
  * imports, so the dashboard can import it as-is.
  *
@@ -11,15 +11,17 @@
  * `--sk-site-*` variables, set on this popup's root from `tokens` (never on
  * :root, so nothing leaks into the site's own CSS).
  *
- * The dashboard keeps a byte-identical copy (sonor-frontend
- * src/lib/site-kit/website/PopupBlocks.tsx, with contract.ts and color.ts
- * beside it) until @sonordev/contracts replaces the mirrors; its drift test
- * fails when they differ. Edit here, then copy.
+ * The dashboard keeps a byte-identical copy until @sonordev/contracts
+ * replaces the mirrors; its drift test fails when they differ. Edit here,
+ * then copy.
  *
  * Accessibility: a centred popup is a modal dialog (labelled by its heading,
  * focus moves in and is kept there, Escape and the overlay close it, focus
  * goes back where it was). A bar is a labelled region, a slide-in a
- * non-modal dialog; both close on Escape. Text HTML is re-sanitized on render.
+ * non-modal dialog; both close on Escape. The focus and Escape behavior is
+ * usePopupDialog (../shared/dialog), so the builder's copy needs that file
+ * beside it. Text HTML is re-sanitized on
+ * render.
  */
 import React from 'react';
 import { type PopupBlock, type SiteDesignTokens } from './contract';

package/dist/website/SitePopups.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @sonordev/site-kit/website/popups - SitePopups: the popups, banners and
+ * toasts published for this site (Sonor → Website → Popups & Banners).
+ *
+ * Each shows where and when Sonor says (pages, devices, trigger, frequency,
+ * schedule), drawn from its blocks in the site's own design by PopupBlocks.
+ * SiteKitLayout mounts it for you (its `popups` prop); mount it yourself only
+ * on a site without SiteKitLayout. A project with nothing published costs one
+ * request and draws nothing. The renderer downloads when a popup first opens.
+ */
+import React from 'react';
+import { type AnalyticsGateOptions } from '../shared/reporting-gate';
+export interface SitePopupsProps extends AnalyticsGateOptions {
+    apiUrl?: string;
+    apiKey?: string;
+    /** The layer popups, banners and toasts stack on. Default: 9999. */
+    zIndex?: number;
+    debug?: boolean;
+}
+/**
+ * Same gate as analytics (frames, localhost, a key to send with): a popup in
+ * a case study's device frame is shown to the agency's visitor, not this
+ * site's, and its impressions would count against this site.
+ */
+export declare function SitePopups(props: SitePopupsProps): React.JSX.Element | null;

package/dist/website/images.js

@@ -1,6 +1,6 @@
-export { ManagedImage, assignImageToSlot, clearImageSlot, fetchManagedImage, fetchManagedImages, listImageFiles, uploadImage } from '../chunk-542MIHNP.js';
+export { ManagedImage, assignImageToSlot, clearImageSlot, fetchManagedImage, fetchManagedImages, listImageFiles, uploadImage } from '../chunk-JMLK6MH7.js';
 export { ManagedFavicon, getManagedFaviconUrl } from '../chunk-GW7GSBO7.js';
-import '../chunk-PXZ7LAOY.js';
-import '../chunk-OUNRFXDC.js';
-import '../chunk-6OL23QYD.js';
+import '../chunk-D6ZC7XKZ.js';
+import '../chunk-K4ZHAURD.js';
+import '../chunk-F24FNCTK.js';
 import '../chunk-PKBMQBKP.js';

package/dist/website/index.js

@@ -1,13 +1,13 @@
 'use client';
-export { SiteDesignReporter } from '../chunk-ICFRH2ED.js';
-export { SITE_DESIGN_PATH, cleanFontStack, colorToHex, getSiteDesignTokens, measureSiteDesign, readDeclaredDesign, sendSiteDesign } from '../chunk-ODADQM6Z.js';
-export { DEFAULT_POPUP_TOKENS, PopupBlocks } from '../chunk-JSZN6LDZ.js';
+export { SiteDesignReporter } from '../chunk-5YCEMV2L.js';
+export { SITE_DESIGN_PATH, cleanFontStack, colorToHex, getSiteDesignTokens, measureSiteDesign, readDeclaredDesign, sendSiteDesign } from '../chunk-JJ3DELUL.js';
+export { DEFAULT_POPUP_TOKENS, PopupBlocks } from '../chunk-BF7TZYC3.js';
 import '../chunk-IHG36STL.js';
 import '../chunk-YC7ELZS3.js';
 import '../chunk-S22FSH7C.js';
 import '../chunk-43OCZ3JA.js';
 import '../chunk-EKBEOXTH.js';
-import '../chunk-PXZ7LAOY.js';
-import '../chunk-OUNRFXDC.js';
-import '../chunk-6OL23QYD.js';
+import '../chunk-D6ZC7XKZ.js';
+import '../chunk-K4ZHAURD.js';
+import '../chunk-F24FNCTK.js';
 import '../chunk-PKBMQBKP.js';

package/dist/website/popup-rules.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @sonordev/site-kit/website/popups - the rules SitePopups applies to the
+ * popups, banners and toasts published for a site, as pure functions (the
+ * package's tests have no DOM).
+ */
+import type { SitePopup } from './popup-types';
+import type { PopupPlacement } from './PopupBlocks';
+/** Exact path, or a prefix ending in `*`. The grammar Sonor stores page patterns in. */
+export declare function matchPath(pathname: string, pattern: string): boolean;
+export type DeviceType = 'desktop' | 'mobile' | 'tablet';
+export declare function deviceFromUserAgent(ua: string): DeviceType;
+/**
+ * The storage key that remembers a visitor saw (closed or clicked) a popup.
+ * The `_engage_` prefix predates the Website module; renaming it would show
+ * every "once" popup to visitors who already closed it.
+ */
+export declare function seenKey(popupId: string): string;
+interface SeenStore {
+    local: Pick<Storage, 'getItem'> | null;
+    session: Pick<Storage, 'getItem'> | null;
+}
+/** Whether a popup's targeting and frequency cap allow it on this page, for this visitor. */
+export declare function isEligible(popup: SitePopup, pathname: string, device: DeviceType, store: SeenStore, now?: number): boolean;
+/**
+ * What a popup draws as: centred over a dimmed page, a bar along an edge, or
+ * a slide-in (a toast) in a corner. Its `layout` says what it actually is;
+ * `type` describes it for older kits. Undefined for a popup without blocks:
+ * that's Sonor's Engage Studio `design_json`, which this kit doesn't draw.
+ * Single source of truth for which popups SitePopups draws, the
+ * one-popup-at-a-time rule and the form wait.
+ */
+export declare function popupPlacement(popup: SitePopup): PopupPlacement | undefined;
+/**
+ * Whether a popup waits until the visitor isn't mid-form before it opens on
+ * its own (shared/mid-form). Popups and toasts do. Banners don't: they
+ * neither take focus nor hide the page.
+ */
+export declare function waitsForForms(popup: SitePopup): boolean;
+/**
+ * The active list after `id` asks to show. A popup (the kind centred over a
+ * dimmed page) waits while another is open, so two never stack; banners and
+ * toasts show alongside. Popups arrive from Sonor highest priority first, so
+ * the first popup to trigger is the one that wins a tie.
+ */
+export declare function activatePopup(active: string[], id: string, popups: SitePopup[]): string[];
+export {};