@sonordev/site-kit 8.8.0 → 8.9.0

package/dist/press-kit/articles/PublicationSidebar.d.ts

@@ -5,7 +5,7 @@
  * tags, newsletter signup, and custom widgets.
  */
 import React from 'react';
-import { type PublicationRoutingOptions } from './routes';
+import { type PublicationRoutingOptions } from "./routes.js";
 export interface PublicationSidebarProps {
     /** Sonor API URL */
     apiUrl?: string;

package/dist/press-kit/articles/RelatedPosts.d.ts

@@ -4,8 +4,8 @@
  * Fetches and displays related articles via Sonor API
  */
 import React from 'react';
-import type { Article } from './types';
-import { type PublicationRoutingOptions } from './routes';
+import type { Article } from "./types.js";
+import { type PublicationRoutingOptions } from "./routes.js";
 interface RelatedPostsServerProps {
     apiUrl?: string;
     apiKey?: string;

package/dist/press-kit/articles/TableOfContents.d.ts

@@ -2,5 +2,5 @@
  * @sonordev/press-kit/articles - Table of Contents Component
  */
 import React from 'react';
-import type { TableOfContentsProps } from './types';
+import type { TableOfContentsProps } from "./types.js";
 export declare function TableOfContents({ content, className, maxDepth, }: TableOfContentsProps): React.JSX.Element | null;

package/dist/press-kit/articles/article-body.d.ts

@@ -1,4 +1,4 @@
-import type { Article } from './types';
+import type { Article } from "./types.js";
 /**
  * Single source of truth for the HTML an article renders: the stock `Article`
  * and the RSS and Atom feeds all read the body through here, so a fix to the

package/dist/press-kit/articles/article-headings.d.ts

@@ -11,7 +11,7 @@
  * (scripts/bundle-baseline.json). Keep code only the server needs, such as the
  * writer, out of it: a shared chunk ships every export either side uses.
  */
-import type { TocItem } from './types';
+import type { TocItem } from "./types.js";
 /**
  * The value of attribute `name` in an open tag's attributes (the string
  * `openTagAttributes` returns), or null when the tag doesn't have it. Reads

package/dist/press-kit/articles/article-photos.d.ts

@@ -1,4 +1,4 @@
-import type { ArticleEditorialPhoto } from './types';
+import type { ArticleEditorialPhoto } from "./types.js";
 export interface ArticlePhotoImageAttributes {
     src: string;
     srcSet?: string;

package/dist/press-kit/articles/artwork.d.ts

@@ -1,5 +1,5 @@
 import type { CSSProperties } from 'react';
-import type { Article } from './types';
+import type { Article } from "./types.js";
 export interface ArticleArtwork {
     src: string | undefined;
     alt: string;
@@ -11,6 +11,6 @@ export declare function resolveArticleArtwork(post: ArtworkSource, placement?: '
 /** Preserve generated text and graphics across every stock card surface. */
 export declare function articleArtworkImageStyle(artwork: ArticleArtwork): CSSProperties | undefined;
 /** Search/discovery artwork is the representative photograph; social cards stay available separately. */
-export declare function resolveRepresentativeImage(post: Partial<Pick<Article, 'title' | 'representative_image' | 'editorial_image' | 'editorial_image_alt' | 'editorial_image_width' | 'editorial_image_height' | 'featured_image' | 'featured_image_alt' | 'featured_image_width' | 'featured_image_height'>>): import('./types').ArticleImage | undefined;
+export declare function resolveRepresentativeImage(post: Partial<Pick<Article, 'title' | 'representative_image' | 'editorial_image' | 'editorial_image_alt' | 'editorial_image_width' | 'editorial_image_height' | 'featured_image' | 'featured_image_alt' | 'featured_image_width' | 'featured_image_height'>>): import("./types.js").ArticleImage | undefined;
 export declare function articleImageSchema(post: Partial<Article>): object | string | undefined;
 export {};

package/dist/press-kit/articles/author-schema.d.ts

@@ -25,8 +25,8 @@
  *   so an article, its author page and the person's own site describe one
  *   person, which is what a Knowledge Panel is built from.
  */
-import type { ArticleAuthor } from './types';
-import { type PublicationRoutingOptions } from './routes';
+import type { ArticleAuthor } from "./types.js";
+import { type PublicationRoutingOptions } from "./routes.js";
 export type AuthorSchemaOptions = PublicationRoutingOptions & {
     siteUrl?: string;
     siteName?: string;

package/dist/press-kit/articles/author-social.d.ts

@@ -1,4 +1,4 @@
-import type { ArticleAuthor } from './types';
+import type { ArticleAuthor } from "./types.js";
 export interface AuthorSocialLink {
     label: string;
     href: string;

package/dist/press-kit/articles/index.d.ts

@@ -39,23 +39,23 @@
  * }
  * ```
  */
-export type { PublicationDefinition } from './publication-definition';
-export type { ArticleServerProps, ArticleStyles } from './Article';
-export type { ArticleListServerProps, ArticleListStyles } from './ArticleList';
-export type { PublicationSidebarProps } from './PublicationSidebar';
-export { NewsletterWidget } from './NewsletterWidget';
-export type { NewsletterWidgetProps } from './NewsletterWidget';
-export type { PublicationLayoutProps, PublicationPageProps, ArticlePageProps, CategoryPageProps } from './PublicationLayout';
-export { AuthorCard } from './AuthorCard';
-export { AuthorPage } from './AuthorPage';
-export { TableOfContents } from './TableOfContents';
-export { ServiceCallout, ServiceCallouts } from './ServiceCallout';
-export type { ServiceCalloutProps } from './ServiceCallout';
-export { ArticleFAQ } from './ArticleFAQ';
-export type { ArticleEditorialPhoto } from './types';
-export type { ArticleFAQProps, FaqItem } from './ArticleFAQ';
-export { ClusterNavigation } from './ClusterNavigation';
-export type { ClusterNavigationProps } from './ClusterNavigation';
+export type { PublicationDefinition } from "./publication-definition.js";
+export type { ArticleServerProps, ArticleStyles } from "./Article.js";
+export type { ArticleListServerProps, ArticleListStyles } from "./ArticleList.js";
+export type { PublicationSidebarProps } from "./PublicationSidebar.js";
+export { NewsletterWidget } from "./NewsletterWidget.js";
+export type { NewsletterWidgetProps } from "./NewsletterWidget.js";
+export type { PublicationLayoutProps, PublicationPageProps, ArticlePageProps, CategoryPageProps } from "./PublicationLayout.js";
+export { AuthorCard } from "./AuthorCard.js";
+export { AuthorPage } from "./AuthorPage.js";
+export { TableOfContents } from "./TableOfContents.js";
+export { ServiceCallout, ServiceCallouts } from "./ServiceCallout.js";
+export type { ServiceCalloutProps } from "./ServiceCallout.js";
+export { ArticleFAQ } from "./ArticleFAQ.js";
+export type { ArticleEditorialPhoto } from "./types.js";
+export type { ArticleFAQProps, FaqItem } from "./ArticleFAQ.js";
+export { ClusterNavigation } from "./ClusterNavigation.js";
+export type { ClusterNavigationProps } from "./ClusterNavigation.js";
 /**
  * `ClusterLandingPage` is deliberately NOT re-exported here — import it from
  * `@sonordev/press-kit/articles/server-ui`.
@@ -72,9 +72,9 @@ export type { ClusterNavigationProps } from './ClusterNavigation';
  * module, so it keeps `import type { ClusterLandingPageProps }` working for
  * existing consumers.
  */
-export type { ClusterLandingPageProps } from './ClusterLandingPage';
-export * from './types';
-export { articleCategorySlug, createPublicationRoutes, resolveArticleUrl, resolvePublicationUrl } from './routes';
-export type { ArticleRoutePost, PublicationRoutingOptions } from './routes';
-export { resolveArticleArtwork } from './artwork';
-export { addExternalLinkTargets, linkClassificationHost, normalizeSiteHost, resolvePublicationSiteUrl, } from './processArticleHtml';
+export type { ClusterLandingPageProps } from "./ClusterLandingPage.js";
+export * from "./types.js";
+export { articleCategorySlug, createPublicationRoutes, resolveArticleUrl, resolvePublicationUrl } from "./routes.js";
+export type { ArticleRoutePost, PublicationRoutingOptions } from "./routes.js";
+export { resolveArticleArtwork } from "./artwork.js";
+export { addExternalLinkTargets, linkClassificationHost, normalizeSiteHost, resolvePublicationSiteUrl, } from "./processArticleHtml.js";

package/dist/press-kit/articles/news-sitemap.d.ts

@@ -1,5 +1,5 @@
-import type { Article } from './types';
-import { type PublicationRoutingOptions, type ArticleRoutePost } from './routes';
+import type { Article } from "./types.js";
+import { type PublicationRoutingOptions, type ArticleRoutePost } from "./routes.js";
 /** Google only reads articles from the last two days in a News sitemap. */
 export declare const NEWS_SITEMAP_WINDOW_MS: number;
 /** Google's cap per News sitemap. */

package/dist/press-kit/articles/public-reads.d.ts

@@ -1,4 +1,4 @@
-import type { ArticleCategory, Article } from './types';
+import type { ArticleCategory, Article } from "./types.js";
 export interface ArticleReadConfig {
     apiUrl: string;
     apiKey: string;

package/dist/press-kit/articles/publication-reads.d.ts

@@ -1,6 +1,6 @@
 import 'server-only';
-import type { Article } from './types';
-import type { ArticleReadResult } from './public-reads';
+import type { Article } from "./types.js";
+import type { ArticleReadResult } from "./public-reads.js";
 export interface PublicationIssue {
     id: string;
     title: string;

package/dist/press-kit/articles/reading-time.d.ts

@@ -1,4 +1,4 @@
-import type { Article } from './types';
+import type { Article } from "./types.js";
 /**
  * Single source of truth for reading-time display.
  *

package/dist/press-kit/articles/server-core.d.ts

@@ -6,14 +6,14 @@
  * treats `getAllArticleSlugs` / `generateArticleStaticParams` as client code.
  */
 import type { Metadata } from 'next';
-import type { Article as ArticleRecord, ArticleAuthor, TopicCluster, ClusterNavigation } from './types';
-import { ArticleUnavailableError } from './public-reads';
-import { sanitizeExcerpt } from './excerpt';
-import { articleImageSchema, resolveRepresentativeImage } from './artwork';
-import { type PublicationRoutingOptions } from './routes';
-import { type NewsSitemapOptions } from './news-sitemap';
+import type { Article as ArticleRecord, ArticleAuthor, TopicCluster, ClusterNavigation } from "./types.js";
+import { ArticleUnavailableError } from "./public-reads.js";
+import { sanitizeExcerpt } from "./excerpt.js";
+import { articleImageSchema, resolveRepresentativeImage } from "./artwork.js";
+import { type PublicationRoutingOptions } from "./routes.js";
+import { type NewsSitemapOptions } from "./news-sitemap.js";
 export { sanitizeExcerpt, ArticleUnavailableError, resolveRepresentativeImage, articleImageSchema };
-export type { ArticleReadResult } from './public-reads';
+export type { ArticleReadResult } from "./public-reads.js";
 export declare function getArticleResult(slug: string, options?: {
     site?: string;
 }): Promise<{
@@ -466,17 +466,17 @@ export declare function generateAuthorPageMetadata(author: ArticleAuthor, option
  * into the browser bundle. Re-exported so `@sonordev/press-kit/articles/server`
  * keeps its existing public API.
  */
-export { authorEntityId, generateArticleAuthorNode, generateAuthorPersonSchema, generateAuthorSchema, withArticleAuthorIdentity, type AuthorSchemaOptions, } from './author-schema';
+export { authorEntityId, generateArticleAuthorNode, generateAuthorPersonSchema, generateAuthorSchema, withArticleAuthorIdentity, type AuthorSchemaOptions, } from "./author-schema.js";
 /** Sonor article document shape (alias of `Article` from `./types`) */
-export type { Article as ArticleRecord } from './types';
-export { articleCategorySlug, createPublicationRoutes, resolveArticleUrl, resolvePublicationUrl } from './routes';
-export type { ArticleRoutePost, PublicationRoutingOptions } from './routes';
-export { resolveArticleArtwork } from './artwork';
-export { wrapArticleTables, articleTableCss } from './article-tables';
-export { insertArticlePhotos, articlePhotoCss } from './article-photos';
-export type { ArticlePhotoOptions, ArticlePhotoImageAttributes } from './article-photos';
-export type { ArticleEditorialPhoto } from './types';
-export { FEED_DEFAULT_ITEMS, NEWS_SITEMAP_MAX_URLS, NEWS_SITEMAP_WINDOW_MS, buildNewsSitemapXml, cdata, recentNewsPosts } from './news-sitemap';
-export type { NewsSitemapOptions, NewsSitemapPost } from './news-sitemap';
-export { getPublicationIssues, getPublicationIssue, getArticlePreview, createPublicationPreviewHandler, PUBLICATION_PREVIEW_COOKIE, PUBLICATION_PREVIEW_HEADERS } from './publication-reads';
-export type { PublicationIssue, PublicationIssueList, ArticlePreview } from './publication-reads';
+export type { Article as ArticleRecord } from "./types.js";
+export { articleCategorySlug, createPublicationRoutes, resolveArticleUrl, resolvePublicationUrl } from "./routes.js";
+export type { ArticleRoutePost, PublicationRoutingOptions } from "./routes.js";
+export { resolveArticleArtwork } from "./artwork.js";
+export { wrapArticleTables, articleTableCss } from "./article-tables.js";
+export { insertArticlePhotos, articlePhotoCss } from "./article-photos.js";
+export type { ArticlePhotoOptions, ArticlePhotoImageAttributes } from "./article-photos.js";
+export type { ArticleEditorialPhoto } from "./types.js";
+export { FEED_DEFAULT_ITEMS, NEWS_SITEMAP_MAX_URLS, NEWS_SITEMAP_WINDOW_MS, buildNewsSitemapXml, cdata, recentNewsPosts } from "./news-sitemap.js";
+export type { NewsSitemapOptions, NewsSitemapPost } from "./news-sitemap.js";
+export { getPublicationIssues, getPublicationIssue, getArticlePreview, createPublicationPreviewHandler, PUBLICATION_PREVIEW_COOKIE, PUBLICATION_PREVIEW_HEADERS } from "./publication-reads.js";
+export type { PublicationIssue, PublicationIssueList, ArticlePreview } from "./publication-reads.js";

package/dist/press-kit/articles/server-ui.d.ts

@@ -10,23 +10,23 @@ import 'server-only';
  * Use `@sonordev/press-kit/articles/server` for getArticle, getAllArticleSlugs,
  * metadata, RSS, etc.
  */
-export { Article } from './Article';
-export type { ArticleServerProps, ArticleStyles } from './Article';
-export { ArticleList } from './ArticleList';
-export type { ArticleListServerProps, ArticleListStyles } from './ArticleList';
-export { ClusterLandingPage } from './ClusterLandingPage';
-export type { ClusterLandingPageProps } from './ClusterLandingPage';
-export { ClusterNavigation } from './ClusterNavigation';
-export type { ClusterNavigationProps } from './ClusterNavigation';
-export { PublicationLayout, PublicationPage, ArticlePage, CategoryPage } from './PublicationLayout';
-export type { PublicationLayoutProps, PublicationPageProps, ArticlePageProps, CategoryPageProps, } from './PublicationLayout';
-export { PublicationSidebar } from './PublicationSidebar';
-export type { PublicationSidebarProps } from './PublicationSidebar';
-export { RelatedPosts } from './RelatedPosts';
-export { articleCategorySlug, createPublicationRoutes, resolveArticleUrl, resolvePublicationUrl } from './routes';
-export type { ArticleRoutePost, PublicationRoutingOptions } from './routes';
-export { resolveArticleArtwork } from './artwork';
-export { wrapArticleTables, articleTableCss } from './article-tables';
-export { insertArticlePhotos, articlePhotoCss } from './article-photos';
-export type { ArticlePhotoOptions, ArticlePhotoImageAttributes } from './article-photos';
-export type { ArticleEditorialPhoto } from './types';
+export { Article } from "./Article.js";
+export type { ArticleServerProps, ArticleStyles } from "./Article.js";
+export { ArticleList } from "./ArticleList.js";
+export type { ArticleListServerProps, ArticleListStyles } from "./ArticleList.js";
+export { ClusterLandingPage } from "./ClusterLandingPage.js";
+export type { ClusterLandingPageProps } from "./ClusterLandingPage.js";
+export { ClusterNavigation } from "./ClusterNavigation.js";
+export type { ClusterNavigationProps } from "./ClusterNavigation.js";
+export { PublicationLayout, PublicationPage, ArticlePage, CategoryPage } from "./PublicationLayout.js";
+export type { PublicationLayoutProps, PublicationPageProps, ArticlePageProps, CategoryPageProps, } from "./PublicationLayout.js";
+export { PublicationSidebar } from "./PublicationSidebar.js";
+export type { PublicationSidebarProps } from "./PublicationSidebar.js";
+export { RelatedPosts } from "./RelatedPosts.js";
+export { articleCategorySlug, createPublicationRoutes, resolveArticleUrl, resolvePublicationUrl } from "./routes.js";
+export type { ArticleRoutePost, PublicationRoutingOptions } from "./routes.js";
+export { resolveArticleArtwork } from "./artwork.js";
+export { wrapArticleTables, articleTableCss } from "./article-tables.js";
+export { insertArticlePhotos, articlePhotoCss } from "./article-photos.js";
+export type { ArticlePhotoOptions, ArticlePhotoImageAttributes } from "./article-photos.js";
+export type { ArticleEditorialPhoto } from "./types.js";

package/dist/press-kit/articles/types.d.ts

@@ -1,7 +1,7 @@
 /**
  * @sonordev/press-kit/articles - Type definitions
  */
-import type { PublicationRoutingOptions } from './routes';
+import type { PublicationRoutingOptions } from "./routes.js";
 /** Public, approved photo snapshot. Planning briefs and private source metadata stay in Sonor. */
 export interface ArticleEditorialPhoto {
     url: string;

package/dist/proxy/index.d.ts

@@ -41,11 +41,11 @@
  * ```
  */
 import { NextRequest, NextResponse } from 'next/server';
-import { type RedirectConfig } from '../redirects';
-import { type SecurityHeadersConfig } from './securityHeaders';
-export type { SecurityHeadersConfig } from './securityHeaders';
-export { DEFAULT_FRAME_ANCESTORS } from './securityHeaders';
-export { resolveVisitorSegment, encodeSegment, decodeSegment, type VisitorSegment, type SegmentSource, } from './segment';
+import { type RedirectConfig } from "../redirects/index.js";
+import { type SecurityHeadersConfig } from "./securityHeaders.js";
+export type { SecurityHeadersConfig } from "./securityHeaders.js";
+export { DEFAULT_FRAME_ANCESTORS } from "./securityHeaders.js";
+export { resolveVisitorSegment, encodeSegment, decodeSegment, type VisitorSegment, type SegmentSource, } from "./segment.js";
 export interface IdentityConfig {
     /**
      * Also resolve + persist a coarse visitor segment (new-vs-returning + source

package/dist/proxy/index.js

@@ -5,8 +5,8 @@ import { handleManagedRedirects } from '../chunk-HXJ54KAM.js';
 import '../chunk-Z22QVHT4.js';
 import '../chunk-MJP63SSS.js';
 import '../chunk-FESKKJAS.js';
-import '../chunk-A4CC4ZG3.js';
 import { uuid } from '../chunk-GJWI74ZZ.js';
+import '../chunk-A4CC4ZG3.js';
 import '../chunk-PKBMQBKP.js';
 import { NextResponse } from 'next/server.js';
 

package/dist/reputation/TestimonialSection.d.ts

@@ -7,5 +7,5 @@
  * Minimal styling - let site CSS control appearance
  */
 import React from 'react';
-import type { TestimonialSectionProps } from './types';
+import type { TestimonialSectionProps } from "./types.js";
 export declare function TestimonialSection({ title, subtitle, autoplay, autoplayInterval, showRating, showPhoto, maxReviews, featuredOnly, service, className, }: TestimonialSectionProps): React.JSX.Element | null;

package/dist/reputation/VisualReviewCard.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import type { VisualReviewCardProps, VisualReviewGalleryProps } from './types';
+import type { VisualReviewCardProps, VisualReviewGalleryProps } from "./types.js";
 /** Static, server-renderable photo and review card. Review quotes are rendered verbatim. */
 export declare function VisualReviewCard(props: VisualReviewCardProps): React.JSX.Element;
 /** Responsive server-renderable gallery; reviews without photos keep their quote card. */

package/dist/reputation/api.d.ts

@@ -5,7 +5,7 @@
  * Uses API key authentication (x-api-key header) - project is resolved server-side.
  * Includes retry with backoff for rate limiting (429).
  */
-import type { Review, ReviewStats } from './types';
+import type { Review, ReviewStats } from "./types.js";
 interface FetchReviewsOptions {
     service?: string;
     limit?: number;

package/dist/reputation/index.d.ts

@@ -3,7 +3,7 @@
  *
  * Display client reviews and testimonials on your website
  */
-export { TestimonialSection } from './TestimonialSection';
-export { VisualReviewCard, VisualReviewGallery } from './VisualReviewCard';
-export { fetchReviews, fetchReviewStats } from './api';
-export type { Review, ReviewPhoto, ReviewStats, TestimonialSectionProps, VisualReviewCardProps, VisualReviewGalleryProps } from './types';
+export { TestimonialSection } from "./TestimonialSection.js";
+export { VisualReviewCard, VisualReviewGallery } from "./VisualReviewCard.js";
+export { fetchReviews, fetchReviewStats } from "./api.js";
+export type { Review, ReviewPhoto, ReviewStats, TestimonialSectionProps, VisualReviewCardProps, VisualReviewGalleryProps } from "./types.js";

package/dist/reputation/server.d.ts

@@ -5,6 +5,6 @@
  * Importing from `./reputation` (which includes TestimonialSection) pulls in a
  * client-tainted bundle that can't be called from RSC.
  */
-export { fetchReviews, fetchReviewStats } from './api';
-export { VisualReviewCard, VisualReviewGallery } from './VisualReviewCard';
-export type { Review, ReviewPhoto, ReviewStats, TestimonialSectionProps, VisualReviewCardProps, VisualReviewGalleryProps } from './types';
+export { fetchReviews, fetchReviewStats } from "./api.js";
+export { VisualReviewCard, VisualReviewGallery } from "./VisualReviewCard.js";
+export type { Review, ReviewPhoto, ReviewStats, TestimonialSectionProps, VisualReviewCardProps, VisualReviewGalleryProps } from "./types.js";

package/dist/resonance/ResonanceRuntime.d.ts

@@ -0,0 +1,7 @@
+export interface ResonanceRuntimeProps {
+    site: string;
+    apiUrl: string;
+    apiKey: string;
+}
+/** Childless shell: policy is primed before identity effects; controller code loads after hydration. */
+export declare function ResonanceRuntime({ site, apiUrl, apiKey }: ResonanceRuntimeProps): null;

package/dist/resonance/bridge.d.ts

@@ -0,0 +1,16 @@
+import type { ResonanceExperimentExposure } from "../contracts/resonance.js";
+import type { ResonanceController } from "./controller.js";
+export { currentResonanceFormContext } from "./form-context.js";
+/** Capability observation only; never returns the subject proof or grants authority. */
+export declare function getResonanceMeasurementStatus(): {
+    state: "blocked" | "legacy_unconfigured" | "pending" | "ready" | "unknown" | "waiting_for_consent";
+    reason: string | null;
+    policy: "configured" | "legacy_unconfigured" | "resolving";
+    analyticsPermitted: boolean;
+    advertisingPermitted: boolean;
+    providerBlockers: string[];
+};
+export declare function setProviderBlockers(next: readonly string[]): void;
+export declare function registerResonanceController(next: ResonanceController): (() => void) | null;
+/** Actual rendered assignment only. Accepted forms are recorded by the server. */
+export declare function recordResonanceExposure(exposure: ResonanceExperimentExposure): void;

package/dist/resonance/consent-adapter.d.ts

@@ -0,0 +1,26 @@
+import { type MeasurementPurpose, type PurposeChoices } from "../shared/measurement-store.js";
+/** The site's maintained CMP remains the owner. Resonance never creates a competing banner/state. */
+export interface ConsentObservation {
+    valid: boolean;
+    choices: PurposeChoices;
+    observedAt: string;
+    /** Actual current CMP evidence, not an inference from a visit or newsletter opt-in. */
+    source: 'cmp' | 'user_preference';
+}
+export interface ConsentReadContext {
+    projectId: string | null;
+    site: string;
+    configRevision: string | null;
+    policyRevision: string | null;
+    requiredPurposes: readonly MeasurementPurpose[];
+}
+export interface ResonanceConsentAdapter {
+    requiredPurposes: readonly MeasurementPurpose[];
+    /** Return valid:false if existing CMP evidence is invalid for this policy. */
+    read(context?: ConsentReadContext): ConsentObservation | Promise<ConsentObservation>;
+    subscribe(onChange: () => void): () => void;
+}
+export declare const getConsentAdapter: () => ResonanceConsentAdapter | null;
+export declare const subscribeConsentAdapter: (listener: () => void) => (() => void);
+export declare function registerResonanceConsentAdapter(next: ResonanceConsentAdapter): () => void;
+export declare const unknownConsentObservation: () => ConsentObservation;

package/dist/resonance/controller-registry.d.ts

@@ -0,0 +1,14 @@
+/** One existing page-wide Resonance controller registry; no permission or proof owner here. */
+import type { ResonanceExperimentExposure } from "../contracts/resonance.js";
+import type { ResonanceController, RenderedResonanceContext } from "./controller.js";
+interface BridgeStore {
+    controller: ResonanceController | null;
+    blockers: readonly string[];
+    registrationConflict: boolean;
+}
+export declare const resonanceControllerState: BridgeStore;
+/** Internal rendered seam: mint the exposure ID in the actual registered controller, once. */
+export declare function recordRenderedResonanceExposure(exposure: Omit<ResonanceExperimentExposure, 'exposureId'>, context?: RenderedResonanceContext): boolean;
+/** Release only this actual effect's registration; a newer render is untouched. */
+export declare function releaseRenderedResonanceExposure(exposure: Omit<ResonanceExperimentExposure, 'exposureId'>): void;
+export {};

package/dist/resonance/controller.d.ts

@@ -0,0 +1,103 @@
+import { type ResonanceMeasurementOccurrence, type ResonanceExperimentExposure } from "../contracts/resonance.js";
+import type { ConsentObservation, ResonanceConsentAdapter } from "./consent-adapter.js";
+export interface ResonanceTransport {
+    /** Existing sonorFetch adapter; the controller never logs proof or input. */
+    request(path: string, init: RequestInit, stillAllowed?: () => boolean): Promise<{
+        status: number;
+        body: unknown;
+    }>;
+}
+export interface ResonanceControllerOptions {
+    site: string;
+    transport: ResonanceTransport;
+    now?: () => number;
+    /** Lazy current-location read, called only for a new consented page view. No query history. */
+    readClickIdentifiers?: (pathname: string) => unknown;
+    /** Actual current first-party cookies only; called after proof and an owned page mapping. */
+    readMetaCookieObservation?: (pathname: string) => unknown;
+    /** Test seam and lifecycle notification; no provider dispatch happens inside consent capture. */
+    onState?: () => void;
+    onOccurrence?: (event: ResonanceMeasurementOccurrence) => void;
+}
+/** Existing native page-version identity is a local render fence, never a wire token. */
+export interface RenderedResonanceContext {
+    pagePath: string;
+    pageVersionId: string;
+}
+/** One scope's consent/occurrence state machine. No storage, no pre-choice event backlog. */
+export declare class ResonanceController {
+    private readonly options;
+    private config;
+    private proof;
+    private adapter;
+    private unsubscribe;
+    private configEpoch;
+    private readEpoch;
+    private deliveryEpoch;
+    private stopped;
+    private busy;
+    private latest;
+    private latestEpoch;
+    private completedEpoch;
+    private path;
+    private sourceMarker;
+    private navigationSequence;
+    private recordedNavigationKey;
+    private navigation;
+    private renderedFrame;
+    private acceptedExposure;
+    private retry;
+    private expiryTimer;
+    private configExpiryTimer;
+    private refreshTimer;
+    private refreshing;
+    private renewing;
+    private renewalTimer;
+    readonly status: {
+        state: 'unknown' | 'legacy_unconfigured' | 'waiting_for_consent' | 'pending' | 'ready' | 'blocked';
+        reason: string | null;
+    };
+    constructor(options: ResonanceControllerOptions);
+    private now;
+    private changed;
+    /** One current-navigation slot, not a history cache. A true identity change
+     * retires its receipt and retry work; late deliveries cannot rejoin it. */
+    private discardRenderedFrame;
+    private invalidate;
+    private timerDelay;
+    private timers;
+    private scheduleConfigRefresh;
+    /** A safe public read refreshes policy freshness without re-prompting or changing consent. */
+    refreshConfig(): Promise<void>;
+    start(): Promise<void>;
+    setAdapter(adapter: ResonanceConsentAdapter | null): void;
+    private consentContext;
+    private configPolicy;
+    private readConsent;
+    /** Maintained CMP observations may resume valid consent; this never prompts or infers a grant. */
+    observe(observation: ConsentObservation): void;
+    private captureLatest;
+    private verifyProofScope;
+    renew(): Promise<void>;
+    /** Connectivity recovery renews existing proof; it never replays a failed grant. */
+    recover(): Promise<void>;
+    navigate(path: string, sourceMarker?: string | null): void;
+    private recordCurrentNavigation;
+    exposure(experiment: ResonanceExperimentExposure): Promise<void>;
+    /** Internal rendered occurrence seam; retry queues retain the resulting immutable event and ID. */
+    renderedExposure(experiment: Omit<ResonanceExperimentExposure, 'exposureId'>, context?: RenderedResonanceContext): Promise<void> | null;
+    /** Close form attachment immediately, but retain this single bounded frame
+     * while the current assignment is revalidated. An exact native-identity rejoin
+     * keeps its original occurrence/receipt even after an asynchronous fallback.
+     * Navigation, replacement, consent/scope invalidation and stop retire it. */
+    releaseRenderedExposure(experiment: Omit<ResonanceExperimentExposure, 'exposureId'>): void;
+    private exposurePermitted;
+    private submitExposure;
+    private emit;
+    private deliver;
+    /** Explicit network recovery only; identical occurrence ID, never old preference/scope epochs. */
+    retryPending(): void;
+    /** Optional server receipt reference, never a claim that a form converted. */
+    formExposureId(): string | null;
+    stop(): void;
+}

package/dist/resonance/form-context.d.ts

@@ -0,0 +1,5 @@
+/** Actual form-submit seam only. Call per attempt; never attach this to unrelated requests. */
+export declare function currentResonanceFormContext(projectId: string, site: string): {
+    subjectProof: string;
+    exposureId: string | null;
+} | null;

package/dist/resonance/index.d.ts

@@ -0,0 +1,4 @@
+export { ResonanceRuntime, type ResonanceRuntimeProps } from "./ResonanceRuntime.js";
+export { registerResonanceConsentAdapter, type ResonanceConsentAdapter, type ConsentObservation, type ConsentReadContext } from "./consent-adapter.js";
+export { recordResonanceExposure, getResonanceMeasurementStatus } from "./bridge.js";
+export type { MeasurementPurpose, PurposeChoice, PurposeChoices } from "../shared/measurement-policy.js";

package/dist/resonance/index.js

@@ -0,0 +1,9 @@
+'use client';
+export { getResonanceMeasurementStatus, recordResonanceExposure, registerResonanceConsentAdapter } from '../chunk-WYNDBJG7.js';
+export { ResonanceRuntime } from '../chunk-AWLPFFPO.js';
+import '../chunk-MDBXGN6W.js';
+import '../chunk-YC7ELZS3.js';
+import '../chunk-KMNHNCVG.js';
+import '../chunk-MOACHHOJ.js';
+import '../chunk-FRY6PBT6.js';
+import '../chunk-PKBMQBKP.js';