@sonordev/site-kit 7.1.2 → 7.2.0

package/dist/forms/useForm.d.ts

@@ -9,7 +9,7 @@
  * const { form, fields, values, errors, setFieldValue, submit, isSubmitting } = useForm('contact-form')
  *
  * return (
- *   <form onSubmit={(e) => { e.preventDefault(); submit() }}>
+ *   <form {...toolAttributes} onSubmit={handleSubmit}>
  *     {fields.map(field => (
  *       <MyCustomInput
  *         key={field.slug}
@@ -24,7 +24,9 @@
  * )
  * ```
  */
-import type { ManagedFormConfig, FormField, FormSubmitResult } from './types';
+import type { DeclarativeToolFormAttributes } from '../mcp/declarative';
+import type { FormEvent } from 'react';
+import type { ManagedFormConfig, FormField, FormSubmitOptions, FormSubmitOutcome, FormSubmitResult } from './types';
 export interface UseFormOptions {
     /** Project ID (defaults to SiteKitLayout config) */
     projectId?: string;
@@ -98,8 +100,23 @@ export interface UseFormReturn {
     validateField: (field: FormField) => string | null;
     /** Check if a field is visible (conditional logic) */
     isFieldVisible: (field: FormField) => boolean;
-    /** Submit the form */
-    submit: () => Promise<void>;
+    /**
+     * Submit the form. Resolves with what happened (sent, invalid, failed,
+     * busy); ignoring the result is fine.
+     */
+    submit: (options?: FormSubmitOptions) => Promise<FormSubmitOutcome>;
+    /**
+     * A ready-made `<form onSubmit>`: prevents the native submit, moves to the
+     * next step or submits, and hands an AI agent that submitted through
+     * WebMCP the outcome. Prefer it to calling `submit()` yourself.
+     */
+    handleSubmit: (event: FormEvent<HTMLFormElement>) => void;
+    /**
+     * WebMCP attributes for your `<form>` (`toolname`, `tooldescription`), so
+     * a browser agent can fill it as a tool. Spread them on the form element.
+     * Null until the form config loads.
+     */
+    toolAttributes: DeclarativeToolFormAttributes | null;
     /** Submission state */
     isSubmitting: boolean;
     isComplete: boolean;

package/dist/forms/webmcp.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @sonordev/site-kit/forms - managed forms as WebMCP tools
+ *
+ * Every managed form carries the declarative WebMCP attributes (`toolname`,
+ * `tooldescription`), so a browser agent can treat it as a tool: it fills the
+ * same controls a person would and the submit runs the same validation and
+ * files the same lead. There is deliberately no `toolautosubmit`. The agent
+ * fills the fields and the person it's helping presses Send, which is the
+ * right default for anything that files a lead or sends a message.
+ *
+ * Browsers that don't implement WebMCP ignore the attributes. Each field's
+ * label is what an agent reads to understand it (FormField adds the help
+ * text as `toolparamdescription` where there is some).
+ *
+ * Single source of truth for a managed form's tool name and description, and
+ * for reading an agent's submit (`SubmitEvent.agentInvoked`, `respondWith`).
+ * FormClient, FormSpotlight, FormStage, StaticForm and useForm all use it.
+ */
+import { type DeclarativeToolFormAttributes } from '../mcp/declarative';
+import type { ManagedFormConfig } from './types';
+/** `contact-page` -> `submit_contact_page`. Stable, snake_case, unique per form. */
+export declare function formToolName(config: Pick<ManagedFormConfig, 'slug'>): string;
+/** The tool description an agent reads to decide whether this form is the one. */
+export declare function formToolDescription(config: Pick<ManagedFormConfig, 'name' | 'form_type' | 'description'>): string;
+/** Spread onto the managed form's `<form>` element. */
+export declare function formToolAttributes(config: Pick<ManagedFormConfig, 'slug' | 'name' | 'form_type' | 'description'>): DeclarativeToolFormAttributes;
+export interface AgentSubmit {
+    /** True when the browser reports that an AI agent submitted the form. */
+    invoked: boolean;
+    /**
+     * Hand the agent the outcome of its submit. Call it synchronously inside
+     * the submit handler, after `preventDefault()`. A no-op unless an agent
+     * submitted and the browser supports `respondWith`.
+     */
+    respond: (outcome: Promise<unknown>) => void;
+}
+/** Read an agent's submit off a native SubmitEvent (`e.nativeEvent` in React). */
+export declare function readAgentSubmit(event: Event | null | undefined): AgentSubmit;

package/dist/images/index.js

@@ -1,6 +1,6 @@
-export { ManagedImage, assignImageToSlot, clearImageSlot, fetchManagedImage, fetchManagedImages, listImageFiles, uploadImage } from '../chunk-ILU5I6RW.js';
+export { ManagedImage, assignImageToSlot, clearImageSlot, fetchManagedImage, fetchManagedImages, listImageFiles, uploadImage } from '../chunk-JMLK6MH7.js';
 export { ManagedFavicon, getManagedFaviconUrl } from '../chunk-GW7GSBO7.js';
-import '../chunk-3SDOQUUF.js';
-import '../chunk-VDF5DFWT.js';
-import '../chunk-AH5Q262S.js';
+import '../chunk-D6ZC7XKZ.js';
+import '../chunk-K4ZHAURD.js';
+import '../chunk-F24FNCTK.js';
 import '../chunk-PKBMQBKP.js';

package/dist/index.d.ts

@@ -15,7 +15,10 @@
 export { SITE_KIT_VERSION } from './shared/version';
 export type { ManagedMetadataResult, ManagedSchemaProps, ManagedFAQData } from './seo/types';
 export type { AnalyticsConfig, AnalyticsEvent, PageView } from './analytics/types';
-export type { EngageElement, WidgetConfig, ChatConfig } from './engage/types';
+export type { ChatConfig } from './chat/types';
+export type { SitePopup } from './website/popup-types';
+/** Deprecated names (engage was retired): SitePopup and SitePopupConfig. */
+export type { EngageElement, WidgetConfig } from './engage/types';
 export type { ManagedFormConfig, FormSubmission, FormSubmitResult, FormField } from './forms/types';
 export type { Article as ArticleType, ArticleAuthor, ArticleCategory } from './articles/types';
 export type { CommerceOffering, CommerceCategory, CommerceVariant, CommerceSchedule, OfferingType, Cart, CartItem, } from './commerce/types';

package/dist/index.js

@@ -1,2 +1,2 @@
-export { SITE_KIT_VERSION } from './chunk-AH5Q262S.js';
+export { SITE_KIT_VERSION } from './chunk-F24FNCTK.js';
 import './chunk-PKBMQBKP.js';

package/dist/layout/SiteKitClientProviders.d.ts

@@ -2,7 +2,7 @@
  * SiteKitClientProviders — Client Island
  *
  * This is the 'use client' boundary for SiteKitLayout.
- * It composes the client-only providers (Analytics, Engage, Signal, SitemapSync)
+ * It composes the client-only providers (Analytics, chat, popups, Signal, SitemapSync)
  * that require React context or browser APIs.
  *
  * All modules are lazy-loaded via next/dynamic so their JS is only downloaded
@@ -10,7 +10,7 @@
  *
  * All modules share a unified identity (visitor ID + session ID) read from
  * the storage-backed singleton (shared/identity), ensuring consistent
- * tracking across Analytics, Signal, and Engage.
+ * tracking across Analytics, Signal, chat and popups.
  *
  * 4.0 INVARIANT — CHILDREN ARE NEVER WRAPPED. Every module here renders as a
  * childless sibling AFTER {children}; nothing provides context around page
@@ -56,7 +56,7 @@ export interface SiteKitClientProvidersProps {
      */
     design?: boolean | DesignConfig;
     /**
-     * Defer Analytics / Engage / SitemapSync until window load + idle or first
+     * Defer Analytics / chat / popups / SitemapSync until window load + idle or first
      * interaction (default true). Pass false to restore legacy eager mounting
      * on hydration. SignalBridge is never deferred — it must apply experiment
      * variants as early as possible.

package/dist/layout/SiteKitLayout.d.ts

@@ -11,7 +11,7 @@
  *
  * Client-side (island):
  *   - AnalyticsProvider (page views, scroll depth, heatmap, web vitals)
- *   - EngageWidget (popups, nudges, chat)
+ *   - SitePopups (Website → Popups & Banners) and SiteChat (Website chat)
  *   - SignalBridge (A/B experiments, behavior tracking)
  *   - SitemapSync (keeps Sonor seo_pages in sync)
  *
@@ -37,7 +37,7 @@
  *
  * @example Opt out of specific features:
  * ```tsx
- * <SiteKitLayout engage={false} signal={false}>
+ * <SiteKitLayout chat={false} popups={false} signal={false}>
  *   {children}
  * </SiteKitLayout>
  * ```
@@ -50,7 +50,7 @@ export interface SiteKitLayoutProps {
     apiKey?: string;
     /** Sonor API URL. Defaults to env or https://api.sonor.io */
     apiUrl?: string;
-    /** Project ID (for Engage chat room routing). Auto-resolved if not provided. */
+    /** Project ID (for chat routing). Auto-resolved if not provided. */
     projectId?: string;
     /** Analytics tracking. true (default) | false | config object */
     analytics?: boolean | AnalyticsConfig;
@@ -100,7 +100,7 @@ export interface SiteKitLayoutProps {
      */
     design?: boolean | DesignConfig;
     /**
-     * Defer client modules (Analytics, Engage, SitemapSync) until window load +
+     * Defer client modules (Analytics, chat, popups, SitemapSync) until window load +
      * idle or the first user interaction, keeping their JS and mount work out of
      * the critical hydration path. Default: true. Pass false to restore legacy
      * eager mounting. SignalBridge is never deferred.

package/dist/layout/client.d.ts

@@ -2,7 +2,7 @@
  * SiteKitClientProviders — Client Island
  *
  * This is the 'use client' boundary for SiteKitLayout.
- * It composes the client-only providers (Analytics, Engage, Signal, SitemapSync)
+ * It composes the client-only providers (Analytics, chat, popups, Signal, SitemapSync)
  * that require React context or browser APIs.
  *
  * All modules are lazy-loaded via next/dynamic so their JS is only downloaded
@@ -10,7 +10,7 @@
  *
  * All modules share a unified identity (visitor ID + session ID) read from
  * the storage-backed singleton (shared/identity), ensuring consistent
- * tracking across Analytics, Signal, and Engage.
+ * tracking across Analytics, Signal, chat and popups.
  *
  * 4.0 INVARIANT — CHILDREN ARE NEVER WRAPPED. Every module here renders as a
  * childless sibling AFTER {children}; nothing provides context around page
@@ -56,7 +56,7 @@ export interface SiteKitClientProvidersProps {
      */
     design?: boolean | DesignConfig;
     /**
-     * Defer Analytics / Engage / SitemapSync until window load + idle or first
+     * Defer Analytics / chat / popups / SitemapSync until window load + idle or first
      * interaction (default true). Pass false to restore legacy eager mounting
      * on hydration. SignalBridge is never deferred — it must apply experiment
      * variants as early as possible.

package/dist/layout/client.js

@@ -1,10 +1,10 @@
 'use client';
-export { SiteKitClientProviders } from '../chunk-HF57LG73.js';
+export { SiteKitClientProviders } from '../chunk-VO3JYRT5.js';
 import '../chunk-6G43IRWR.js';
-import '../chunk-ERXXITG4.js';
-import '../chunk-NK4CSJNP.js';
+import '../chunk-HGFAEDG3.js';
+import '../chunk-CF5QNFYU.js';
 import '../chunk-ZTZQPYP6.js';
-import '../chunk-PHYMNUJU.js';
+import '../chunk-S54ECQGY.js';
 import '../chunk-YC7ELZS3.js';
 import '../chunk-FESKKJAS.js';
 import '../chunk-A4CC4ZG3.js';
@@ -12,7 +12,7 @@ import '../chunk-24QZEO3Q.js';
 import '../chunk-GJWI74ZZ.js';
 import '../chunk-43OCZ3JA.js';
 import '../chunk-EKBEOXTH.js';
-import '../chunk-3SDOQUUF.js';
-import '../chunk-VDF5DFWT.js';
-import '../chunk-AH5Q262S.js';
+import '../chunk-D6ZC7XKZ.js';
+import '../chunk-K4ZHAURD.js';
+import '../chunk-F24FNCTK.js';
 import '../chunk-PKBMQBKP.js';

package/dist/layout/index.js

@@ -1,12 +1,12 @@
-import { SiteKitClientProviders } from '../chunk-HF57LG73.js';
+import { SiteKitClientProviders } from '../chunk-VO3JYRT5.js';
 import '../chunk-6G43IRWR.js';
-import '../chunk-ERXXITG4.js';
-import '../chunk-NK4CSJNP.js';
+import '../chunk-HGFAEDG3.js';
+import '../chunk-CF5QNFYU.js';
 import '../chunk-ZTZQPYP6.js';
 import { ManagedFavicon } from '../chunk-GW7GSBO7.js';
-import '../chunk-PHYMNUJU.js';
+import '../chunk-S54ECQGY.js';
 import '../chunk-YC7ELZS3.js';
-import { resolveClientCredential } from '../chunk-6WIQCXOO.js';
+import { resolveClientCredential } from '../chunk-RPZ7OQGD.js';
 import '../chunk-VX5CMNMM.js';
 import { ManagedScripts } from '../chunk-MVLMXC44.js';
 import { resolveApiOrigin } from '../chunk-X6F6SO4S.js';
@@ -17,9 +17,9 @@ import '../chunk-24QZEO3Q.js';
 import '../chunk-GJWI74ZZ.js';
 import '../chunk-43OCZ3JA.js';
 import '../chunk-EKBEOXTH.js';
-import '../chunk-3SDOQUUF.js';
-import '../chunk-VDF5DFWT.js';
-import '../chunk-AH5Q262S.js';
+import '../chunk-D6ZC7XKZ.js';
+import '../chunk-K4ZHAURD.js';
+import '../chunk-F24FNCTK.js';
 import '../chunk-PKBMQBKP.js';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 

package/dist/layout/types.d.ts

@@ -3,7 +3,7 @@
  * Kept in a shared file so both server (SiteKitLayout) and client
  * (SiteKitClientProviders) components can reference them.
  */
-import type { ChatLauncherPlacement } from '../engage/types';
+import type { ChatLauncherPlacement } from '../chat/types';
 import type { SiteDesignConfig } from '../website/design';
 /**
  * The site's design, for popups (Website → Popups & Banners). site-kit
@@ -47,9 +47,10 @@ export interface AnalyticsConfig {
     allowLocalhost?: boolean;
 }
 /**
- * Launcher placement (`position`, `offsetBottom`, `zIndex`) comes from
- * ChatLauncherPlacement in engage/types, the one definition every Engage
- * config surface extends.
+ * The deprecated `engage` prop's config. Launcher placement (`position`,
+ * `offsetBottom`, `zIndex`) comes from ChatLauncherPlacement in chat/types,
+ * the one definition every chat config surface extends; `zIndex` also stacks
+ * popups.
  */
 export interface EngageConfig extends ChatLauncherPlacement {
     chatEnabled?: boolean;

package/dist/llms/contract.js

@@ -1,2 +1,2 @@
-export { LLMS_DISCLAIMER_MAX_LENGTH, LLMS_PUBLIC_SUMMARY_MAX_LENGTH, LLM_GEO_CONTRACT_VERSION, MANAGED_LLM_SCHEMA_KNOWN_KEYS, isEmittableReviewNode, pickManagedLlmSchemaForJsonLd, sanitizeLlmsDisclaimerLine, sanitizeLlmsPublicSummary, sanitizePrimaryLanguageTag } from '../chunk-4Y5FWDPM.js';
+export { LLMS_DISCLAIMER_MAX_LENGTH, LLMS_PUBLIC_SUMMARY_MAX_LENGTH, LLM_GEO_CONTRACT_VERSION, MANAGED_LLM_SCHEMA_KNOWN_KEYS, clipAtWordBoundary, isEmittableReviewNode, pickManagedLlmSchemaForJsonLd, sanitizeLlmsDisclaimerLine, sanitizeLlmsPublicSummary, sanitizePrimaryLanguageTag } from '../chunk-NZ4RXN3G.js';
 import '../chunk-PKBMQBKP.js';

package/dist/llms/index.js

@@ -1,19 +1,19 @@
-export { createLLMsFullTxtHandler, createLLMsTxtHandler, formatSourcedFactsSection, llmsResponseHeaders } from '../chunk-WWSHFRDL.js';
+export { createLLMsFullTxtHandler, createLLMsTxtHandler, formatSourcedFactsSection, llmsResponseHeaders } from '../chunk-BC4Y3S3D.js';
 export { buildAiDiscoveryHeaders, wantsLlmsDiscoveryLink } from '../chunk-PO2TRJPY.js';
 export { AI_RETRIEVAL_CRAWLERS, AI_TRAINING_CRAWLERS, buildAiCrawlerRules, createRobotsTxtHandler } from '../chunk-QLTDFUJ7.js';
-export { LEGACY_PUBLICATION_PATH, SEO_REVALIDATION_MAX_BODY_BYTES, SEO_REVALIDATION_MAX_ITEMS, createLlmsRevalidateHandler, createSeoRevalidationHandler, parseSeoRevalidationPayload } from '../chunk-VGH4MDTU.js';
+export { LEGACY_PUBLICATION_PATH, SEO_REVALIDATION_MAX_BODY_BYTES, SEO_REVALIDATION_MAX_ITEMS, createLlmsRevalidateHandler, createSeoRevalidationHandler, parseSeoRevalidationPayload } from '../chunk-VHKEF5ZB.js';
 import '../chunk-XTRZGXB2.js';
 export { AEOBlock, AEOCitedContent, AEOClaim, AEOComparison, AEODefinition, AEOEntity, AEOProvenanceList, AEOStep, AEOSteps, AEOSummary, DEFAULT_SPEAKABLE_SELECTORS, SpeakableSchema, createSpeakableSchema, getSpeakableSelectorsForPage } from '../chunk-PSAG45YF.js';
-export { AGENT_ACCESS_HEADING, appendAgentAccessSection, describesMcp, detectMcpServer, formatAgentAccessSection, generateLLMsFullTxt, generateLLMsTxt, writeLLMsTxtToPublic } from '../chunk-QEDHRBAT.js';
-export { getBusinessInfo, getFAQItems, getLLMsData, getOptimizedLLMsTxt, getPageSummaries, getServices } from '../chunk-GLHQ3LRO.js';
+export { AGENT_ACCESS_HEADING, appendAgentAccessSection, describesMcp, detectMcpServer, formatAgentAccessSection, generateLLMsFullTxt, generateLLMsTxt, writeLLMsTxtToPublic } from '../chunk-QL6XNPSD.js';
+export { getBusinessInfo, getFAQItems, getLLMsData, getOptimizedLLMsTxt, getPageSummaries, getServices } from '../chunk-6U3VLV2C.js';
 import '../chunk-L5UOHS6E.js';
 import '../chunk-WMVK77ND.js';
 import '../chunk-VX5CMNMM.js';
-export { LLMS_DISCLAIMER_MAX_LENGTH, LLMS_PUBLIC_SUMMARY_MAX_LENGTH, LLM_GEO_CONTRACT_VERSION, MANAGED_LLM_SCHEMA_KNOWN_KEYS, pickManagedLlmSchemaForJsonLd, sanitizeLlmsDisclaimerLine, sanitizeLlmsPublicSummary, sanitizePrimaryLanguageTag } from '../chunk-4Y5FWDPM.js';
+export { LLMS_DISCLAIMER_MAX_LENGTH, LLMS_PUBLIC_SUMMARY_MAX_LENGTH, LLM_GEO_CONTRACT_VERSION, MANAGED_LLM_SCHEMA_KNOWN_KEYS, pickManagedLlmSchemaForJsonLd, sanitizeLlmsDisclaimerLine, sanitizeLlmsPublicSummary, sanitizePrimaryLanguageTag } from '../chunk-NZ4RXN3G.js';
 import '../chunk-4KZ6W3ZH.js';
 import '../chunk-MJP63SSS.js';
 import '../chunk-YVKRYQRG.js';
 import '../chunk-FESKKJAS.js';
 import '../chunk-A4CC4ZG3.js';
-import '../chunk-AH5Q262S.js';
+import '../chunk-F24FNCTK.js';
 import '../chunk-PKBMQBKP.js';

package/dist/maps/index.js

@@ -1,8 +1,8 @@
 'use client';
 import { monotonicMs } from '../chunk-MH2DSGC6.js';
-import { sonorFetch } from '../chunk-3SDOQUUF.js';
-import '../chunk-VDF5DFWT.js';
-import '../chunk-AH5Q262S.js';
+import { sonorFetch } from '../chunk-D6ZC7XKZ.js';
+import '../chunk-K4ZHAURD.js';
+import '../chunk-F24FNCTK.js';
 import '../chunk-PKBMQBKP.js';
 import { useState, useCallback, useEffect } from 'react';
 import { APIProvider, Map as Map$1, AdvancedMarker, Pin, InfoWindow } from '@vis.gl/react-google-maps';

package/dist/mcp/index.js

@@ -1,5 +1,6 @@
 import { MCP_SUPPORTED_PROTOCOL_VERSIONS, dispatch, errorOutcome, JSONRPC_INVALID_REQUEST, META_CLIENT_INFO, JSONRPC_PARSE_ERROR, MCP_PROTOCOL_VERSION_MODERN } from '../chunk-FYAB6CXS.js';
 export { JSONRPC_METHOD_NOT_FOUND, MCP_ERROR_HEADER_MISMATCH, MCP_ERROR_UNSUPPORTED_PROTOCOL_VERSION, MCP_PROTOCOL_VERSIONS_LEGACY, MCP_PROTOCOL_VERSION_MODERN, MCP_SUPPORTED_PROTOCOL_VERSIONS, META_CLIENT_INFO, META_PROTOCOL_VERSION, META_SERVER_INFO, dispatch, isSupportedVersion, toToolDescriptor, toToolResult, toolErrorResult, validateArgs } from '../chunk-FYAB6CXS.js';
+export { declarativeToolField, declarativeToolForm } from '../chunk-HW7B43E5.js';
 import '../chunk-PKBMQBKP.js';
 
 // src/mcp/types.ts
@@ -273,17 +274,4 @@ function createMcpServerCardHandler(options) {
   };
 }
 
-// src/mcp/declarative.ts
-function declarativeToolForm(options) {
-  const attributes = {
-    toolname: options.name,
-    tooldescription: options.description
-  };
-  if (options.autoSubmit) attributes.toolautosubmit = "";
-  return attributes;
-}
-function declarativeToolField(description) {
-  return { toolparamdescription: description };
-}
-
-export { MCP_SERVER_CARD_LEGACY_PATH, MCP_SERVER_CARD_PATH, MCP_SERVER_CARD_SCHEMA, SITE_KIT_CARD_META_KEY, WEBMCP_SURFACE_HEADER, buildMcpServerCard, createMcpHandler, createMcpServerCardHandler, declarativeToolField, declarativeToolForm, decodeHeaderValue, defineMcpTool, toolCallRecord, validateMcpServerCard };
+export { MCP_SERVER_CARD_LEGACY_PATH, MCP_SERVER_CARD_PATH, MCP_SERVER_CARD_SCHEMA, SITE_KIT_CARD_META_KEY, WEBMCP_SURFACE_HEADER, buildMcpServerCard, createMcpHandler, createMcpServerCardHandler, decodeHeaderValue, defineMcpTool, toolCallRecord, validateMcpServerCard };

package/dist/mcp/sonor.js

@@ -1,30 +1,33 @@
 import { toolErrorResult } from '../chunk-FYAB6CXS.js';
 import { fetchReviews, fetchReviewStats } from '../chunk-EDYHROQ7.js';
 import { getOfferings } from '../chunk-G3NHWMP5.js';
-import { fetchBookingTypes, fetchAvailability } from '../chunk-M3YEPKP7.js';
-import { getLLMsData, getServices, getFAQItems, getPageSummaries } from '../chunk-GLHQ3LRO.js';
-import { getFormConfig } from '../chunk-V3PUVBME.js';
-import '../chunk-VLARKWZU.js';
+import { fetchBookingTypes, fetchAvailability } from '../chunk-BKY2ZNM7.js';
+import { getLLMsData, getServices, getFAQItems, getPageSummaries } from '../chunk-6U3VLV2C.js';
+import { getFormConfig } from '../chunk-5V2V5C3Y.js';
+import '../chunk-OWZ7ATLZ.js';
 import '../chunk-YC7ELZS3.js';
-import '../chunk-CIG5UL2S.js';
+import '../chunk-ZTLMPUO6.js';
 import '../chunk-DXO6SBMD.js';
-import '../chunk-LUXVWITO.js';
-import { getAllArticles, getArticle } from '../chunk-TXBAOEKG.js';
+import '../chunk-4NTBQNHA.js';
+import { getAllArticles, getArticle } from '../chunk-PKGN32AU.js';
 import '../chunk-Y3INC4QJ.js';
 import '../chunk-QXMIKDOL.js';
 import '../chunk-WMVK77ND.js';
 import { resolveFetch } from '../chunk-VX5CMNMM.js';
-import '../chunk-4Y5FWDPM.js';
+import '../chunk-NZ4RXN3G.js';
+import '../chunk-VWWITFWM.js';
 import '../chunk-MJP63SSS.js';
 import { resolveServerApiConfig } from '../chunk-X6F6SO4S.js';
 import '../chunk-MH2DSGC6.js';
 import { resolveSiteHost } from '../chunk-FESKKJAS.js';
 import '../chunk-A4CC4ZG3.js';
+import '../chunk-C2FZBUSS.js';
 import '../chunk-5SQK3D53.js';
+import '../chunk-HW7B43E5.js';
 import '../chunk-NJCTQH2P.js';
-import '../chunk-3SDOQUUF.js';
-import '../chunk-VDF5DFWT.js';
-import { SITE_KIT_VERSION } from '../chunk-AH5Q262S.js';
+import '../chunk-D6ZC7XKZ.js';
+import '../chunk-K4ZHAURD.js';
+import { SITE_KIT_VERSION } from '../chunk-F24FNCTK.js';
 import '../chunk-PKBMQBKP.js';
 import 'server-only';
 import { after } from 'next/server.js';

package/dist/revalidate/index.js

@@ -1,7 +1,7 @@
-import { createSeoRevalidationHandler } from '../chunk-VGH4MDTU.js';
+import { createSeoRevalidationHandler } from '../chunk-VHKEF5ZB.js';
 import '../chunk-XTRZGXB2.js';
 export { SITE_CACHE_TAGS, SITE_REVALIDATE_PATH, isSiteRevalidatePong } from '../chunk-RYVDGXC2.js';
-import '../chunk-AH5Q262S.js';
+import '../chunk-F24FNCTK.js';
 import '../chunk-PKBMQBKP.js';
 
 // src/revalidate/index.ts

package/dist/seo/client.js

@@ -1,9 +1,9 @@
 'use client';
-export { SitemapSync } from '../chunk-UXOGCKL6.js';
+export { SitemapSync } from '../chunk-GEXT7BTE.js';
 import '../chunk-YVKRYQRG.js';
 import '../chunk-43OCZ3JA.js';
 import '../chunk-EKBEOXTH.js';
-import '../chunk-3SDOQUUF.js';
-import '../chunk-VDF5DFWT.js';
-import '../chunk-AH5Q262S.js';
+import '../chunk-D6ZC7XKZ.js';
+import '../chunk-K4ZHAURD.js';
+import '../chunk-F24FNCTK.js';
 import '../chunk-PKBMQBKP.js';

package/dist/seo/index.js

@@ -1,7 +1,8 @@
 export { ManagedNoScripts, ManagedScripts } from '../chunk-MVLMXC44.js';
-import { pickManagedLlmSchemaForJsonLd } from '../chunk-4Y5FWDPM.js';
+import { pickManagedLlmSchemaForJsonLd } from '../chunk-NZ4RXN3G.js';
 import { safeJsonLd } from '../chunk-4KZ6W3ZH.js';
-export { SitemapSync } from '../chunk-UXOGCKL6.js';
+import { withoutSchemaPlaceholders } from '../chunk-VWWITFWM.js';
+export { SitemapSync } from '../chunk-GEXT7BTE.js';
 import { getManagedMetadata } from '../chunk-4YTYGG2C.js';
 export { generateSitemap, getABVariant, getManagedMetadata, getManagedMetadataWithAB, getRedirect, getRobotsDirective, isIndexable } from '../chunk-4YTYGG2C.js';
 import { getContentBlock, getSchemaMarkups, getSEOPageData, getEntityEnhancedSchema, getFAQData, getInternalLinks, getEntities, pruneSchemaTypes } from '../chunk-662ILEZ6.js';
@@ -17,9 +18,9 @@ import '../chunk-FESKKJAS.js';
 import '../chunk-A4CC4ZG3.js';
 import '../chunk-43OCZ3JA.js';
 import '../chunk-EKBEOXTH.js';
-import '../chunk-3SDOQUUF.js';
-import '../chunk-VDF5DFWT.js';
-import '../chunk-AH5Q262S.js';
+import '../chunk-D6ZC7XKZ.js';
+import '../chunk-K4ZHAURD.js';
+import '../chunk-F24FNCTK.js';
 import '../chunk-PKBMQBKP.js';
 import { Suspense } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
@@ -73,10 +74,10 @@ async function ManagedSchemaAsync({
   const page = pageData?.page;
   const siteUrl = pageData?.project?.site_url || "";
   const deny = new Set(excludeTypes ?? []);
-  const fromSonor = (values) => values.map((v) => pruneSchemaTypes(v, deny)).filter((v) => v !== null);
+  const fromSonor = (values) => values.map((v) => withoutPlaceholders(pruneSchemaTypes(v, deny))).filter(isSchemaObject);
   const allSchemas = [
     ...fromSonor(entitySchemas),
-    ...schemas.map((s) => s.schema_json),
+    ...schemas.map((s) => withoutPlaceholders(s.schema_json)).filter(isSchemaObject),
     // Include auto-generated schema from Signal meta optimization
     ...fromSonor(page?.managed_schema ? [page.managed_schema] : []),
     ...additionalSchemas
@@ -127,7 +128,7 @@ async function LLMSchemaAsync({
 }) {
   const { page: pageData, project } = await getSEOPageData(path);
   const raw = pageData?.managed_llm_schema;
-  const picked = pickManagedLlmSchemaForJsonLd(raw);
+  const picked = withoutPlaceholders(pickManagedLlmSchemaForJsonLd(raw));
   if (!picked) {
     return null;
   }
@@ -183,6 +184,12 @@ function createSpeakableWebPageSchema(type, name, url, speakable) {
     speakable: speakableSpec
   };
 }
+function withoutPlaceholders(value) {
+  return withoutSchemaPlaceholders(value).value;
+}
+function isSchemaObject(value) {
+  return value !== null && typeof value === "object";
+}
 function schemaNodeHasType(node, type) {
   if (!node || typeof node !== "object") return false;
   const t = node["@type"];

package/dist/seo/llms/contract.js

@@ -1,2 +1,2 @@
-export { LLMS_DISCLAIMER_MAX_LENGTH, LLMS_PUBLIC_SUMMARY_MAX_LENGTH, LLM_GEO_CONTRACT_VERSION, MANAGED_LLM_SCHEMA_KNOWN_KEYS, isEmittableReviewNode, pickManagedLlmSchemaForJsonLd, sanitizeLlmsDisclaimerLine, sanitizeLlmsPublicSummary, sanitizePrimaryLanguageTag } from '../../chunk-4Y5FWDPM.js';
+export { LLMS_DISCLAIMER_MAX_LENGTH, LLMS_PUBLIC_SUMMARY_MAX_LENGTH, LLM_GEO_CONTRACT_VERSION, MANAGED_LLM_SCHEMA_KNOWN_KEYS, clipAtWordBoundary, isEmittableReviewNode, pickManagedLlmSchemaForJsonLd, sanitizeLlmsDisclaimerLine, sanitizeLlmsPublicSummary, sanitizePrimaryLanguageTag } from '../../chunk-NZ4RXN3G.js';
 import '../../chunk-PKBMQBKP.js';

package/dist/seo/llms.js

@@ -1,19 +1,19 @@
-export { createLLMsFullTxtHandler, createLLMsTxtHandler, formatSourcedFactsSection, llmsResponseHeaders } from '../chunk-WWSHFRDL.js';
+export { createLLMsFullTxtHandler, createLLMsTxtHandler, formatSourcedFactsSection, llmsResponseHeaders } from '../chunk-BC4Y3S3D.js';
 export { buildAiDiscoveryHeaders, wantsLlmsDiscoveryLink } from '../chunk-PO2TRJPY.js';
 export { AI_RETRIEVAL_CRAWLERS, AI_TRAINING_CRAWLERS, buildAiCrawlerRules, createRobotsTxtHandler } from '../chunk-QLTDFUJ7.js';
-export { LEGACY_PUBLICATION_PATH, SEO_REVALIDATION_MAX_BODY_BYTES, SEO_REVALIDATION_MAX_ITEMS, createLlmsRevalidateHandler, createSeoRevalidationHandler, parseSeoRevalidationPayload } from '../chunk-VGH4MDTU.js';
+export { LEGACY_PUBLICATION_PATH, SEO_REVALIDATION_MAX_BODY_BYTES, SEO_REVALIDATION_MAX_ITEMS, createLlmsRevalidateHandler, createSeoRevalidationHandler, parseSeoRevalidationPayload } from '../chunk-VHKEF5ZB.js';
 import '../chunk-XTRZGXB2.js';
 export { AEOBlock, AEOCitedContent, AEOClaim, AEOComparison, AEODefinition, AEOEntity, AEOProvenanceList, AEOStep, AEOSteps, AEOSummary, DEFAULT_SPEAKABLE_SELECTORS, SpeakableSchema, createSpeakableSchema, getSpeakableSelectorsForPage } from '../chunk-PSAG45YF.js';
-export { AGENT_ACCESS_HEADING, appendAgentAccessSection, describesMcp, detectMcpServer, formatAgentAccessSection, generateLLMsFullTxt, generateLLMsTxt, writeLLMsTxtToPublic } from '../chunk-QEDHRBAT.js';
-export { getBusinessInfo, getFAQItems, getLLMsData, getOptimizedLLMsTxt, getPageSummaries, getServices } from '../chunk-GLHQ3LRO.js';
+export { AGENT_ACCESS_HEADING, appendAgentAccessSection, describesMcp, detectMcpServer, formatAgentAccessSection, generateLLMsFullTxt, generateLLMsTxt, writeLLMsTxtToPublic } from '../chunk-QL6XNPSD.js';
+export { getBusinessInfo, getFAQItems, getLLMsData, getOptimizedLLMsTxt, getPageSummaries, getServices } from '../chunk-6U3VLV2C.js';
 import '../chunk-L5UOHS6E.js';
 import '../chunk-WMVK77ND.js';
 import '../chunk-VX5CMNMM.js';
-export { LLMS_DISCLAIMER_MAX_LENGTH, LLMS_PUBLIC_SUMMARY_MAX_LENGTH, LLM_GEO_CONTRACT_VERSION, MANAGED_LLM_SCHEMA_KNOWN_KEYS, pickManagedLlmSchemaForJsonLd, sanitizeLlmsDisclaimerLine, sanitizeLlmsPublicSummary, sanitizePrimaryLanguageTag } from '../chunk-4Y5FWDPM.js';
+export { LLMS_DISCLAIMER_MAX_LENGTH, LLMS_PUBLIC_SUMMARY_MAX_LENGTH, LLM_GEO_CONTRACT_VERSION, MANAGED_LLM_SCHEMA_KNOWN_KEYS, pickManagedLlmSchemaForJsonLd, sanitizeLlmsDisclaimerLine, sanitizeLlmsPublicSummary, sanitizePrimaryLanguageTag } from '../chunk-NZ4RXN3G.js';
 import '../chunk-4KZ6W3ZH.js';
 import '../chunk-MJP63SSS.js';
 import '../chunk-YVKRYQRG.js';
 import '../chunk-FESKKJAS.js';
 import '../chunk-A4CC4ZG3.js';
-import '../chunk-AH5Q262S.js';
+import '../chunk-F24FNCTK.js';
 import '../chunk-PKBMQBKP.js';

package/dist/seo/register-sitemap-cli.js

@@ -458,7 +458,7 @@ async function registerLocalSitemap(options) {
   }
   if (options.writeLlms && result.success) {
     try {
-      const { writeLLMsTxtToPublic } = await import('../writeLLMsTxt-G3JBNBC5.js');
+      const { writeLLMsTxtToPublic } = await import('../writeLLMsTxt-OV24LQVL.js');
       const written = await writeLLMsTxtToPublic({
         // Resolved here too: the sync's own `site` is scoped to the branch that
         // posts, and this runs on the skip path as well.

package/dist/seo/sitemap.js

@@ -1,11 +1,11 @@
-export { createSitemap, getPortfolioPaths, syncSitemapToPortal } from '../chunk-JBE46QJZ.js';
+export { createSitemap, getPortfolioPaths, syncSitemapToPortal } from '../chunk-R46IQIGK.js';
 import '../chunk-Z22QVHT4.js';
-import '../chunk-QEDHRBAT.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/server/index.js

@@ -1,6 +1,6 @@
-export { resolveClientCredential } from '../chunk-6WIQCXOO.js';
+export { resolveClientCredential } from '../chunk-RPZ7OQGD.js';
 import '../chunk-VX5CMNMM.js';
 export { requireServerApiConfig, resolveApiOrigin, resolveServerApiConfig, serverApiFetch } from '../chunk-X6F6SO4S.js';
 import '../chunk-MH2DSGC6.js';
-import '../chunk-AH5Q262S.js';
+import '../chunk-F24FNCTK.js';
 import '../chunk-PKBMQBKP.js';

package/dist/shared/dialog.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @sonordev/site-kit shared: how a popup behaves as a dialog.
+ *
+ * SINGLE SOURCE OF TRUTH for popup focus and Escape. PopupBlocks (Website →
+ * Popups & Banners) calls usePopupDialog. Don't hand-roll another keydown
+ * listener or focus trap.
+ *
+ * - Escape closes, whatever the placement.
+ * - A modal popup takes focus when it opens (the dialog element itself, so a
+ *   screen reader announces its name first; Tab then reaches its controls),
+ *   keeps Tab inside, and hands focus back to where it was when it closes.
+ * - A non-modal one (a bar, a slide-in) leaves focus where it is.
+ *
+ * React only: no Next imports and no other site-kit imports, because Sonor's
+ * popup builder renders PopupBlocks too, from a copy of these files.
+ */
+import { type RefObject } from 'react';
+export interface PopupDialogOptions {
+    /** False for a render that isn't live on the page (the builder preview). Default true. */
+    enabled?: boolean;
+    /** Takes focus, keeps Tab inside and returns focus on close. */
+    modal: boolean;
+    /** Escape calls it. */
+    onClose?: () => void;
+}
+/** Dialog behavior for the popup whose panel (the role="dialog" element) is `panelRef`. */
+export declare function usePopupDialog(panelRef: RefObject<HTMLElement | null>, { enabled, modal, onClose }: PopupDialogOptions): void;

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;