@sonordev/site-kit 7.4.0 → 8.0.1

package/dist/{chunk-4NTBQNHA.js → chunk-TYAVHRWH.js}

@@ -1,6 +1,85 @@
 import { declarativeToolField } from './chunk-HW7B43E5.js';
 import { jsx, jsxs } from 'react/jsx-runtime';
 
+// src/forms/field-autocomplete.ts
+var TOKEN_BY_KEY = {
+  email: "email",
+  email_address: "email",
+  e_mail: "email",
+  first_name: "given-name",
+  firstname: "given-name",
+  fname: "given-name",
+  given_name: "given-name",
+  last_name: "family-name",
+  lastname: "family-name",
+  lname: "family-name",
+  surname: "family-name",
+  family_name: "family-name",
+  name: "name",
+  full_name: "name",
+  fullname: "name",
+  your_name: "name",
+  contact_name: "name",
+  phone: "tel",
+  phone_number: "tel",
+  telephone: "tel",
+  mobile: "tel",
+  mobile_phone: "tel",
+  cell: "tel",
+  cell_phone: "tel",
+  tel: "tel",
+  company: "organization",
+  company_name: "organization",
+  organization: "organization",
+  organisation: "organization",
+  business_name: "organization",
+  job_title: "organization-title",
+  website: "url",
+  website_url: "url",
+  company_website: "url",
+  url: "url",
+  street_address: "street-address",
+  address_line1: "address-line1",
+  address_line_1: "address-line1",
+  address1: "address-line1",
+  address_line2: "address-line2",
+  address_line_2: "address-line2",
+  address2: "address-line2",
+  city: "address-level2",
+  state: "address-level1",
+  province: "address-level1",
+  zip: "postal-code",
+  zip_code: "postal-code",
+  zipcode: "postal-code",
+  postal_code: "postal-code",
+  postcode: "postal-code",
+  country: "country-name"
+};
+var TOKEN_FIELD_TYPES = /* @__PURE__ */ new Set(["text", "email", "phone", "tel", "select"]);
+function toKey(raw) {
+  return raw.replace(/([a-z0-9])([A-Z])/g, "$1_$2").toLowerCase().replace(/\*/g, "").trim().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
+}
+function withoutGeneratedSuffix(key) {
+  const match = /^(.+)_([a-z0-9]{6,10})$/.exec(key);
+  if (match && /\d/.test(match[2])) return match[1];
+  return key;
+}
+function tokenForKey(raw) {
+  if (!raw) return void 0;
+  const key = toKey(raw);
+  return TOKEN_BY_KEY[key] ?? TOKEN_BY_KEY[withoutGeneratedSuffix(key)];
+}
+function autocompleteFor(field) {
+  if (!TOKEN_FIELD_TYPES.has(field.field_type)) return void 0;
+  const destination = field.destination_field;
+  if (destination && !destination.startsWith("custom.")) {
+    const fromDestination = tokenForKey(destination);
+    if (fromDestination) return fromDestination;
+  }
+  if (field.field_type === "email") return "email";
+  if (field.field_type === "phone" || field.field_type === "tel") return "tel";
+  return tokenForKey(field.slug) ?? tokenForKey(field.label);
+}
 var STYLE_ID = "sk-delight-css";
 var CSS = `
 /* Every frame must carry the centering translateY: the animation fills both
@@ -208,86 +287,6 @@ function FormMomentum({ done, total }) {
     }
   );
 }
-
-// src/forms/field-autocomplete.ts
-var TOKEN_BY_KEY = {
-  email: "email",
-  email_address: "email",
-  e_mail: "email",
-  first_name: "given-name",
-  firstname: "given-name",
-  fname: "given-name",
-  given_name: "given-name",
-  last_name: "family-name",
-  lastname: "family-name",
-  lname: "family-name",
-  surname: "family-name",
-  family_name: "family-name",
-  name: "name",
-  full_name: "name",
-  fullname: "name",
-  your_name: "name",
-  contact_name: "name",
-  phone: "tel",
-  phone_number: "tel",
-  telephone: "tel",
-  mobile: "tel",
-  mobile_phone: "tel",
-  cell: "tel",
-  cell_phone: "tel",
-  tel: "tel",
-  company: "organization",
-  company_name: "organization",
-  organization: "organization",
-  organisation: "organization",
-  business_name: "organization",
-  job_title: "organization-title",
-  website: "url",
-  website_url: "url",
-  company_website: "url",
-  url: "url",
-  street_address: "street-address",
-  address_line1: "address-line1",
-  address_line_1: "address-line1",
-  address1: "address-line1",
-  address_line2: "address-line2",
-  address_line_2: "address-line2",
-  address2: "address-line2",
-  city: "address-level2",
-  state: "address-level1",
-  province: "address-level1",
-  zip: "postal-code",
-  zip_code: "postal-code",
-  zipcode: "postal-code",
-  postal_code: "postal-code",
-  postcode: "postal-code",
-  country: "country-name"
-};
-var TOKEN_FIELD_TYPES = /* @__PURE__ */ new Set(["text", "email", "phone", "tel", "select"]);
-function toKey(raw) {
-  return raw.replace(/([a-z0-9])([A-Z])/g, "$1_$2").toLowerCase().replace(/\*/g, "").trim().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
-}
-function withoutGeneratedSuffix(key) {
-  const match = /^(.+)_([a-z0-9]{6,10})$/.exec(key);
-  if (match && /\d/.test(match[2])) return match[1];
-  return key;
-}
-function tokenForKey(raw) {
-  if (!raw) return void 0;
-  const key = toKey(raw);
-  return TOKEN_BY_KEY[key] ?? TOKEN_BY_KEY[withoutGeneratedSuffix(key)];
-}
-function autocompleteFor(field) {
-  if (!TOKEN_FIELD_TYPES.has(field.field_type)) return void 0;
-  const destination = field.destination_field;
-  if (destination && !destination.startsWith("custom.")) {
-    const fromDestination = tokenForKey(destination);
-    if (fromDestination) return fromDestination;
-  }
-  if (field.field_type === "email") return "email";
-  if (field.field_type === "phone" || field.field_type === "tel") return "tel";
-  return tokenForKey(field.slug) ?? tokenForKey(field.label);
-}
 var SINGLE_CONTROL_TYPES = /* @__PURE__ */ new Set([
   "text",
   "email",
@@ -699,4 +698,4 @@ function FormField({ field, value, error, onChange, onFocus, onBlur, classPrefix
   ] });
 }
 
-export { DelightStyles, FormField, FormMomentum };
+export { DelightStyles, FormField, FormMomentum, autocompleteFor };

package/dist/{chunk-ZTLU3BSW.js → chunk-TZ5RTANX.js}

@@ -1,4 +1,4 @@
-import { getLLMsData, getOptimizedLLMsTxt } from './chunk-4BHRA7TI.js';
+import { getLLMsData, getOptimizedLLMsTxt } from './chunk-JIH32RH2.js';
 import { linkClassificationHost } from './chunk-L5UOHS6E.js';
 import { resolveArticleUrl } from './chunk-WMVK77ND.js';
 import { freshFetch } from './chunk-UAYAJPEP.js';
@@ -312,7 +312,7 @@ async function generateLLMsTxt(options) {
     if (includeEntities) {
       attemptedSections.push("knowledge-graph");
       optionalFetches.push(
-        import('./server-api-BVCBLJKL.js').then(async ({ getEntities, getPrimaryEntity }) => {
+        import('./server-api-EGOKC7Q3.js').then(async ({ getEntities, getPrimaryEntity }) => {
           const [entities, primaryEntity] = await Promise.all([
             getEntities().then((e) => e.slice(0, maxEntities)),
             getPrimaryEntity()

package/dist/{chunk-4YTYGG2C.js → chunk-URJN75ZG.js}

@@ -1,10 +1,14 @@
-import { getSEOPageData, ensureMetadata, getABTest, recordABImpression, getRedirectData, getRobotsData, getSitemapEntries } from './chunk-662ILEZ6.js';
+import { getSEOPageData, ensureMetadata, getABTest, recordABImpression, getRedirectData, getRobotsData, getSitemapEntries } from './chunk-Y35BWW2C.js';
 import { titleProblem, descriptionProblem } from './chunk-BQR4IPBW.js';
 import { resolveSiteHost } from './chunk-FESKKJAS.js';
 
 // src/seo/getManagedMetadata.ts
+var SELF_CANONICAL = "./";
+function mergeAlternates(...parts) {
+  return Object.assign({}, ...parts.filter(Boolean));
+}
 async function getManagedMetadata(options) {
-  const { path, fallback = {}, overrides = {}, favicon: faviconMode = "metadata" } = options;
+  const { path, fallback = {}, overrides = {}, favicon: faviconMode = "metadata", scope = "page" } = options;
   const omitIcons = faviconMode === "component";
   const result = await getSEOPageData(path);
   const pageData = result?.page;
@@ -13,6 +17,7 @@ async function getManagedMetadata(options) {
     const fallbackMeta = {
       ...fallback,
       ...overrides,
+      alternates: mergeAlternates({ canonical: SELF_CANONICAL }, fallback.alternates, overrides.alternates),
       _managed: false,
       _source: "fallback"
     };
@@ -70,18 +75,20 @@ async function getManagedMetadata(options) {
   if (pageData.managed_robots) {
     metadata.robots = pageData.managed_robots;
   }
-  if (pageData.managed_canonical) {
-    metadata.alternates = {
-      ...metadata.alternates,
-      canonical: pageData.managed_canonical
-    };
-  }
-  const langAlts = pageData.language_alternates;
-  if (langAlts && typeof langAlts === "object" && !Array.isArray(langAlts)) {
-    metadata.alternates = {
-      ...metadata.alternates,
-      languages: langAlts
-    };
+  if (scope === "page") {
+    if (pageData.managed_canonical) {
+      metadata.alternates = {
+        ...metadata.alternates,
+        canonical: pageData.managed_canonical
+      };
+    }
+    const langAlts = pageData.language_alternates;
+    if (langAlts && typeof langAlts === "object" && !Array.isArray(langAlts)) {
+      metadata.alternates = {
+        ...metadata.alternates,
+        languages: langAlts
+      };
+    }
   }
   const managedOgTitle = pageData.managed_og_title && !titleProblem(pageData.managed_og_title, identity, { path }) ? pageData.managed_og_title : void 0;
   const managedOgDescription = pageData.managed_og_description && !descriptionProblem(pageData.managed_og_description, identity) ? pageData.managed_og_description : void 0;
@@ -106,6 +113,12 @@ async function getManagedMetadata(options) {
   return {
     ...metadata,
     ...overrides,
+    alternates: mergeAlternates(
+      { canonical: SELF_CANONICAL },
+      metadata.alternates,
+      fallback.alternates,
+      overrides.alternates
+    ),
     _managed: true,
     _source: "database"
   };
@@ -219,7 +232,7 @@ async function generateSitemap(options) {
   }));
 }
 async function registerLocalSitemap(options) {
-  const { registerSitemap } = await import('./server-api-BVCBLJKL.js');
+  const { registerSitemap } = await import('./server-api-EGOKC7Q3.js');
   let entries = options.entries || [];
   if (options.autoDiscover && entries.length === 0) {
     try {
@@ -250,4 +263,4 @@ async function isIndexable(projectId, path) {
   return directive.index;
 }
 
-export { generateSitemap, getABVariant, getManagedMetadata, getManagedMetadataWithAB, getRedirect, getRobotsDirective, isIndexable, registerLocalSitemap };
+export { generateSitemap, getABVariant, getManagedMetadata, getManagedMetadataWithAB, getRedirect, getRobotsDirective, isIndexable, mergeAlternates, registerLocalSitemap };

package/dist/{chunk-FUQTV5O6.js → chunk-VQQV7FOX.js}

@@ -1,6 +1,6 @@
-import { FormEnhancer } from './chunk-PF64OEXC.js';
-import { StaticForm } from './chunk-ZTLMPUO6.js';
-import { serverApiFetch } from './chunk-X6F6SO4S.js';
+import { FormEnhancer } from './chunk-GMXY2OOY.js';
+import { StaticForm } from './chunk-LNSF6BJC.js';
+import { serverApiFetch } from './chunk-C7TLGL3R.js';
 import { jsx } from 'react/jsx-runtime';
 
 async function ServerForm({

package/dist/{chunk-PKGN32AU.js → chunk-XPTJRVL2.js}

@@ -2,7 +2,7 @@ import { generateArticleAuthorNode, resolveArticleArtwork, withArticleAuthorIden
 import { resolveArticleUrl, createPublicationRoutes, resolvePublicationUrl, articleCategorySlug } from './chunk-WMVK77ND.js';
 import { withoutSchemaPlaceholders } from './chunk-VWWITFWM.js';
 import { withSiteParam, withSiteBody } from './chunk-MJP63SSS.js';
-import { resolveServerApiConfig } from './chunk-X6F6SO4S.js';
+import { resolveServerApiConfig } from './chunk-C7TLGL3R.js';
 import { notFound } from 'next/navigation';
 
 // src/articles/public-reads.ts

package/dist/{chunk-662ILEZ6.js → chunk-Y35BWW2C.js}

@@ -1,6 +1,6 @@
-import { SITE_CACHE_TAGS } from './chunk-RYVDGXC2.js';
 import { withSiteBody } from './chunk-MJP63SSS.js';
-import { serverApiFetch, requireServerApiConfig } from './chunk-X6F6SO4S.js';
+import { SITE_CACHE_TAGS } from './chunk-6KU7STM3.js';
+import { serverApiFetch, requireServerApiConfig } from './chunk-C7TLGL3R.js';
 import { postRegisterSitemap, resolveSyncSite } from './chunk-DIKNRN34.js';
 import { cache } from 'react';
 import 'server-only';
@@ -116,10 +116,6 @@ var getInternalLinks = cache(async (sourcePath, options) => {
   );
   return result?.links || [];
 });
-var getContentBlock = cache(async (path, section, site) => {
-  const result = await secureApiPost("/api/public/seo/content", withSiteBody({ path, section }, site));
-  return result?.content || null;
-});
 var getABTest = cache(async (path, field) => {
   const result = await secureApiPost("/api/public/seo/ab-test", { path, field });
   return result?.test || null;
@@ -237,4 +233,4 @@ var getVisibilitySummary = cache(async () => {
   return signalApiGet(`/skills/seo/visibility/${projectId}/summary`);
 });
 
-export { ensureMetadata, getABTest, getContentBlock, getEntities, getEntityEnhancedSchema, getFAQData, getInternalLinks, getManagedScripts, getPrimaryEntity, getRedirectData, getRobotsData, getSEOPageData, getSchemaMarkups, getSitemapEntries, getVisibilityScore, getVisibilitySummary, pruneSchemaTypes, recordABImpression, registerSitemap };
+export { ensureMetadata, getABTest, getEntities, getEntityEnhancedSchema, getFAQData, getInternalLinks, getManagedScripts, getPrimaryEntity, getRedirectData, getRobotsData, getSEOPageData, getSchemaMarkups, getSitemapEntries, getVisibilityScore, getVisibilitySummary, pruneSchemaTypes, recordABImpression, registerSitemap };

package/dist/{chunk-MHGAZ3LL.js → chunk-YGXWG54S.js}

@@ -1,11 +1,9 @@
-import { sonorFetch } from './chunk-3E3PPSNR.js';
+import { getClientApiConfig } from './chunk-3G7YABRA.js';
+import { sonorFetch } from './chunk-55JLUMAC.js';
 
 // src/sync/api.ts
-var DEFAULT_API_URL = "https://api.sonor.io";
 function getApiConfig() {
-  const apiUrl = typeof window !== "undefined" ? window.__SITE_KIT_API_URL__ || DEFAULT_API_URL : DEFAULT_API_URL;
-  const apiKey = typeof window !== "undefined" ? window.__SITE_KIT_API_KEY__ : void 0;
-  return { apiUrl, apiKey };
+  return getClientApiConfig();
 }
 function buildHeaders(isPost = false) {
   const headers = {};

package/dist/{chunk-AH4AXO4P.js → chunk-Z4MK4VOG.js}

@@ -54,7 +54,7 @@ function useSignal() {
   return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
 }
 var LazySignalCore = dynamic(
-  () => import('./SignalCore-HEQYITTM.js').then((m) => ({ default: m.SignalCore })),
+  () => import('./SignalCore-RDQPM2L2.js').then((m) => ({ default: m.SignalCore })),
   { ssr: false }
 );
 function SignalBridge({

package/dist/{chunk-AV4QAK5F.js → chunk-Z6PVFZRI.js}

@@ -1,5 +1,6 @@
 'use client';
-import { detectTimezone, releaseSlotHold, fetchBookingTypeDetails, fetchBookingTypes, fetchAvailability, createSlotHold, createBooking, formatDuration, formatDate, formatTime, prepareMeeting } from './chunk-MHGAZ3LL.js';
+import { detectTimezone, releaseSlotHold, fetchBookingTypeDetails, fetchBookingTypes, fetchAvailability, createSlotHold, createBooking, formatDuration, formatDate, formatTime, prepareMeeting } from './chunk-YGXWG54S.js';
+import { readPublishedApiConfig, DEFAULT_SONOR_API_URL } from './chunk-3G7YABRA.js';
 import { useState, useRef, useMemo, useCallback, useEffect, useId } from 'react';
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
 
@@ -125,7 +126,6 @@ function bookingRecoveryFromError(error) {
   if (/time reservation expired|invalid slot hold|meeting details changed/i.test(message)) return "hold";
   return null;
 }
-var DEFAULT_API_URL = "https://api.sonor.io";
 var DAYS = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
 var MONTHS = [
   "January",
@@ -217,8 +217,9 @@ function BookingWidget({
   autoSelectFirstDay = true,
   styles = {}
 }) {
-  const apiKey = propApiKey || (typeof window !== "undefined" ? window.__SITE_KIT_API_KEY__ : void 0);
-  const apiUrl = propApiUrl || (typeof window !== "undefined" ? window.__SITE_KIT_API_URL__ : void 0) || DEFAULT_API_URL;
+  const published = readPublishedApiConfig();
+  const apiKey = propApiKey || published.apiKey;
+  const apiUrl = propApiUrl || published.apiUrl || DEFAULT_SONOR_API_URL;
   const [step, setStep] = useState(bookingTypeSlug ? "datetime" : "type");
   const [loading, setLoading] = useState(false);
   const [slotsLoading, setSlotsLoading] = useState(false);

package/dist/chunk-ZKADJNR2.js

@@ -0,0 +1,52 @@
+'use client';
+import { VISITOR_ID_KEY, memoryIdentity, SESSION_ID_KEY, SESSION_TIME_KEY } from './chunk-5TM3WPCI.js';
+import { uuid } from './chunk-GJWI74ZZ.js';
+import { useState } from 'react';
+
+function getOrCreateVisitorId() {
+  var _a;
+  if (typeof window === "undefined") return "";
+  let stored = null;
+  try {
+    stored = window.localStorage.getItem(VISITOR_ID_KEY);
+    const visitorId = stored || uuid();
+    window.localStorage.setItem(VISITOR_ID_KEY, visitorId);
+    return visitorId;
+  } catch {
+    return (_a = memoryIdentity).visitorId || (_a.visitorId = stored || uuid());
+  }
+}
+function getOrCreateSessionId(timeoutMinutes = 30) {
+  var _a;
+  if (typeof window === "undefined") return "";
+  const now = Date.now();
+  const timeoutMs = timeoutMinutes * 60 * 1e3;
+  let existingSession = null;
+  try {
+    existingSession = window.sessionStorage.getItem(SESSION_ID_KEY);
+    const lastActivity = window.sessionStorage.getItem(SESSION_TIME_KEY);
+    if (existingSession && lastActivity) {
+      const elapsed = now - parseInt(lastActivity, 10);
+      if (elapsed < timeoutMs) {
+        window.sessionStorage.setItem(SESSION_TIME_KEY, now.toString());
+        window.sessionStorage.setItem(SESSION_ID_KEY, existingSession);
+        return existingSession;
+      }
+    }
+    const newSession = uuid();
+    window.sessionStorage.setItem(SESSION_ID_KEY, newSession);
+    window.sessionStorage.setItem(SESSION_TIME_KEY, now.toString());
+    return newSession;
+  } catch {
+    return (_a = memoryIdentity).sessionId || (_a.sessionId = existingSession || uuid());
+  }
+}
+function useSiteKitIdentity() {
+  const [identity] = useState(() => ({
+    visitorId: getOrCreateVisitorId(),
+    sessionId: getOrCreateSessionId()
+  }));
+  return identity;
+}
+
+export { getOrCreateSessionId, getOrCreateVisitorId, useSiteKitIdentity };

package/dist/client/index.js

@@ -1,14 +1,15 @@
 'use client';
-import { publishSiteCredential } from '../chunk-JRCNUUNG.js';
+import { publishSiteCredential } from '../chunk-6KUCA5HG.js';
+export { VISUAL_VIEWPORT_GAP_PROPERTY, VisualViewportGap, useVisualViewportGap } from '../chunk-6T6CQVNL.js';
 export { useDeferredActivation } from '../chunk-YC7ELZS3.js';
 import '../chunk-FESKKJAS.js';
 import '../chunk-A4CC4ZG3.js';
 export { trackConversion, trackEvent } from '../chunk-LCDVPAMR.js';
-export { VISUAL_VIEWPORT_GAP_PROPERTY, VisualViewportGap, useVisualViewportGap } from '../chunk-6T6CQVNL.js';
-export { getOrCreateSessionId, getOrCreateVisitorId, useSiteKitIdentity } from '../chunk-24QZEO3Q.js';
+export { getOrCreateSessionId, getOrCreateVisitorId, useSiteKitIdentity } from '../chunk-ZKADJNR2.js';
+import '../chunk-5TM3WPCI.js';
 import '../chunk-GJWI74ZZ.js';
-import '../chunk-GK7TV7EK.js';
-import '../chunk-KHQ5GD6T.js';
+import '../chunk-IY6G67EF.js';
+import '../chunk-S5G3A7OZ.js';
 import '../chunk-PKBMQBKP.js';
 
 // src/client/SiteKitCredential.tsx

package/dist/contracts/entries.d.ts

@@ -4,5 +4,5 @@
  * tsup config, its package.json check and the boundary test, so a new
  * contract is added in one place.
  */
-export declare const CONTRACT_ENTRIES: readonly ['forms', 'llms', 'slots', 'slot-content', 'site-cache', 'site-edit', 'website', 'color', 'fleet', 'sites', 'seo-pages', 'seo-meta', 'portfolio', 'voice', 'proposal-sitemap', 'error-page', 'schema-placeholders'];
+export declare const CONTRACT_ENTRIES: readonly ['forms', 'llms', 'slots', 'slot-content', 'site-cache', 'site-edit', 'website', 'color', 'fleet', 'sites', 'seo-pages', 'seo-meta', 'portfolio', 'voice', 'proposal-sitemap', 'error-page', 'schema-placeholders', 'sentences', 'knowledge'];
 export type ContractEntry = (typeof CONTRACT_ENTRIES)[number];

package/dist/contracts/knowledge.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Knowledge contract: which Sonor records Signal reads into a project's
+ * knowledge, the address each record's knowledge is stored under, and the
+ * limits of the call that tells Signal a site's pages changed. The Sonor API
+ * makes those calls and Signal answers them, so both import this as
+ * `@sonordev/contracts/knowledge` instead of keeping lists that drift apart.
+ * The dashboard, which shows the owner what Signal read, reads stored
+ * addresses by the same rules.
+ *
+ * A record's knowledge is stored under a URI built from its kind and id:
+ * `<kind>://<id>` for its first chunk and `<kind>://<id>#<anchor>` for any
+ * more (an article indexed in full, split by heading). The scheme is what
+ * tells a record's rows apart from a page's passages, which are stored under
+ * the page's https URL. The content type can't: an article's record has the
+ * same content type as the page passages beside it, because a live article is
+ * a page on the site.
+ */
+/**
+ * The kinds of Sonor record Signal indexes, in the order the dashboard lists
+ * them: case studies, proof records, managed FAQs, reviews, articles and
+ * commerce offerings. Each kind is also its URI scheme.
+ */
+export declare const KNOWLEDGE_RECORD_KINDS: readonly ["portfolio", "proof", "faq", "review", "article", "offering"];
+export type KnowledgeRecordKind = (typeof KNOWLEDGE_RECORD_KINDS)[number];
+/** True for one of KNOWLEDGE_RECORD_KINDS, spelled exactly (lowercase). */
+export declare function isKnowledgeRecordKind(value: unknown): value is KnowledgeRecordKind;
+/** `<kind>://`, the start every address of that kind shares, for prefix queries. */
+export declare function knowledgeRecordPrefix(kind: KnowledgeRecordKind): string;
+/**
+ * Where a record's knowledge is stored: `<kind>://<id>` for its first chunk,
+ * `<kind>://<id>#<anchor>` for a further one. `id` is the record's UUID, and
+ * checking it is the caller's job: an empty id, or one holding `#`, `?`, `/`
+ * or whitespace, builds an address knowledgeRecordRefOf can't read back.
+ */
+export declare function knowledgeRecordSourceUrl(kind: KnowledgeRecordKind, id: string, anchor?: string | null): string;
+/**
+ * The address an offering had before offerings were records of their own:
+ * `commerce://offering/<id>`. Nothing writes it any more. Signal switches the
+ * row off the next time that offering syncs, and a reader counts it as the
+ * offering until then (knowledgeRecordRefOf).
+ */
+export declare function legacyOfferingSourceUrl(id: string): string;
+/**
+ * The kind of record a stored address belongs to, by its scheme
+ * (`article://<id>#part-2` is 'article'), or null for anything else: a page
+ * passage, an older page summary, a note. Case doesn't matter and surrounding
+ * whitespace is ignored. This is the test for "is this row a record's": it
+ * reads only the scheme, so it doesn't need an id, and an offering's legacy
+ * address isn't a record row by it.
+ */
+export declare function knowledgeRecordKindOf(sourceUrl: string | null | undefined): KnowledgeRecordKind | null;
+/** The record a stored address names. */
+export interface KnowledgeRecordRef {
+    kind: KnowledgeRecordKind;
+    id: string;
+}
+/**
+ * The record a stored address names (`portfolio://<id>#part-2` is
+ * `{ kind: 'portfolio', id }`), or null when it names none. An offering's
+ * legacy address (`commerce://offering/<id>`) names that offering. Case
+ * doesn't matter in the scheme, surrounding whitespace is ignored, and the id
+ * keeps its own case.
+ */
+export declare function knowledgeRecordRefOf(sourceUrl: string | null | undefined): KnowledgeRecordRef | null;
+/**
+ * One page of a site in a page sync: it changed (Signal reads it live) or
+ * left the site (`removed`: Signal switches its passages off). Signal applies
+ * every removal in a call, then reads the changed pages in the order given,
+ * as many as it reads in one call; the rest wait for its nightly sweep. So a
+ * sender puts removals first, then the pages that matter most.
+ */
+export interface KnowledgePageChange {
+    /** The host as the project's pages store it; null or absent is the project's primary domain. */
+    site?: string | null;
+    /** The page's path, from "/". */
+    path: string;
+    removed?: boolean;
+}
+/** The most pages one page sync may name. Signal refuses a longer list outright, so cut the list after ordering it. */
+export declare const KNOWLEDGE_SYNC_MAX_PAGES = 500;
+/** The longest path a page sync may name, in characters. */
+export declare const KNOWLEDGE_SYNC_PATH_MAX_LENGTH = 2048;
+/** The longest host a page sync may name, in characters (a DNS name's limit). */
+export declare const KNOWLEDGE_SYNC_SITE_MAX_LENGTH = 253;

package/dist/contracts/sentences.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Sentences contract: how prose is split into sentences, so the APIs that cut
+ * an excerpt, a carousel slide or a summary out of an article agree on where
+ * a sentence ends. The APIs import it as `@sonordev/contracts/sentences`.
+ *
+ * Lossless: joining the result with spaces gives back every word of the input,
+ * in order. The usual one-liner, `text.match(/[^.!?]+[.!?]+(?=\s|$)/g)`, isn't.
+ * A period it can't use, like the first one in "9 p.m. call", makes match()
+ * skip ahead and silently drop every word before its next match, so a
+ * sentence about a 9 p.m. call comes back as "m.". Don't re-fork a regex for
+ * this.
+ *
+ * A sentence ends at . ! or ? (and any closing quote or bracket after it)
+ * followed by whitespace, then an optional opening quote or bracket, then
+ * A to Z or 0 to 9. Never before a lowercase word or a symbol, and only ASCII
+ * capitals count. It doesn't end at:
+ *  - an abbreviation: a dotted one made of letters ("p.m.", "U.S.", "e.g.",
+ *    "Ph.D."), a single letter ("J.", "Plan A."), or a short form listed below
+ *    (titles, months, days, company suffixes, street suffixes);
+ *  - a label that has a number after it ("No. 5", "Fig. 2", "Ste. 200");
+ *  - a list number ("1.", "Step 2.", "Do three things: 1.").
+ * A piece with no letter in it ("...", "1.") isn't a sentence and joins the
+ * next one. A "!" or "?" is never held back by an abbreviation (only a period
+ * is), though the same start-of-sentence rule applies after it.
+ *
+ * Prices, versions, domains and email addresses ("$4.50", "v2.1",
+ * "example.com") are not abbreviations: a sentence can end after them.
+ *
+ * Where it is unsure it leans toward not splitting, because a sentence that
+ * runs long costs less than a lost word. A period after a short form that
+ * isn't listed ends a sentence like any other.
+ *
+ * It reads sentences, not layout. A newline or a list marker doesn't start a
+ * new sentence by itself, so split text into lines or paragraphs first when
+ * those matter, then split each one.
+ */
+/**
+ * Splits prose into trimmed sentences without dropping or reordering a word.
+ * Empty, blank and nullish input give `[]`, never `null`.
+ *
+ * One pass, linear in the length of the text: each run of . ! ? (and the
+ * closing quotes or brackets after it) is looked at once, an abbreviation or
+ * list-marker check reads only the last few characters, and the check for a
+ * letter reads each character once.
+ */
+export declare function splitSentences(text: string | null | undefined): string[];

package/dist/contracts/site-cache.d.ts

@@ -27,6 +27,8 @@ export declare const SITE_CACHE_TAGS: {
     readonly taxonomy: 'editorial-taxonomy';
     /** Portfolio items (agency-site-kit). */
     readonly portfolio: 'portfolio';
+    /** Products, services, events and membership plans (commerce-kit). */
+    readonly commerce: 'commerce';
 };
 export type SiteCacheTag = (typeof SITE_CACHE_TAGS)[keyof typeof SITE_CACHE_TAGS];
 /** The body Sonor POSTs to the revalidation route. */

package/dist/cta-bar/index.js

@@ -1,5 +1,5 @@
 export { CTA_BAR_BREAKPOINTS, CTA_BAR_SPACE, CtaBar, CtaBarAction, ECHO_CLEARANCE } from '../chunk-LNSNA3W4.js';
 import '../chunk-UPFU63L4.js';
-import '../chunk-LCDVPAMR.js';
 import '../chunk-JE4A5S4F.js';
+import '../chunk-LCDVPAMR.js';
 import '../chunk-PKBMQBKP.js';

package/dist/fleet/index.js

@@ -1,10 +1,11 @@
 'use client';
-export { FLEET_HEARTBEAT_PATH, FleetHeartbeat, detectNextVersion, sendFleetHeartbeat } from '../chunk-EHR4NIMX.js';
+export { FLEET_HEARTBEAT_PATH, FleetHeartbeat, detectNextVersion, sendFleetHeartbeat } from '../chunk-5GB2HHVJ.js';
 export { FLEET_CONTRACT_VERSION, FLEET_MODULES, FLEET_MODULES_MAX, FLEET_SITE_MAX_LENGTH, FLEET_VERSION_MAX_LENGTH, FLEET_VERSION_PATTERN, buildFleetHeartbeatPayload, isFleetModule, normalizeFleetModules, normalizeFleetSite, sanitizeFleetVersion } from '../chunk-ZTZQPYP6.js';
 import '../chunk-YC7ELZS3.js';
-import '../chunk-43OCZ3JA.js';
+import '../chunk-CAH4Y4PY.js';
 import '../chunk-EKBEOXTH.js';
-import '../chunk-3E3PPSNR.js';
-import '../chunk-GK7TV7EK.js';
-import '../chunk-KHQ5GD6T.js';
+import '../chunk-3G7YABRA.js';
+import '../chunk-55JLUMAC.js';
+import '../chunk-IY6G67EF.js';
+import '../chunk-S5G3A7OZ.js';
 import '../chunk-PKBMQBKP.js';