@sonordev/site-kit 8.5.2 → 8.7.0

package/dist/contracts/portfolio.d.ts

@@ -26,6 +26,176 @@ export interface FrameReadyMessage {
 export declare function isFrameReadyMessage(data: unknown): data is FrameReadyMessage;
 /** Bump on breaking changes to the collapse policy. */
 export declare const PORTFOLIO_CONTRACT_VERSION: 1;
+/** The four beats, in reading order. */
+export declare const CASE_STUDY_STAGES: readonly ['problem', 'build', 'proof', 'outcome'];
+export type CaseStudyStage = (typeof CASE_STUDY_STAGES)[number];
+/** The generic name of each beat and the question its sections answer. */
+export declare const CASE_STUDY_STAGE_COPY: Record<CaseStudyStage, {
+    name: string;
+    question: string;
+}>;
+/**
+ * A site's own names for the four stages ("Heat", "Shape", "Temper",
+ * "Finish"), set per project in the dashboard (branding is per project) and
+ * read everywhere a stage is named: the editor, the public portfolio config,
+ * the site itself. A stage left unnamed falls back to its generic name. The
+ * ids never change; only what people see does.
+ */
+export type CaseStudyStageNames = Partial<Record<CaseStudyStage, string>>;
+/** The longest a stage name may run. It's a heading word, a rail label, a tab. */
+export declare const STAGE_NAME_MAX_CHARS = 24;
+/**
+ * What's wrong with a set of stage names, or an empty list. Absent passes
+ * (generic names); present must be an object of short text keyed by stage.
+ */
+export declare function stageNamesProblems(names: unknown): string[];
+/** The name a stage is shown under: the site's own when set, else the generic one. */
+export declare function stageName(names: CaseStudyStageNames | null | undefined, stage: CaseStudyStage): string;
+/**
+ * Every section type a case study can hold, in canonical reading order:
+ * hero, then each stage's sections, then the two that aren't rendered as
+ * sections of the story (SEO metadata, the closing CTA). This is THE list;
+ * the Sonor API and agency-site-kit import it rather than keeping their own.
+ */
+export declare const PORTFOLIO_SECTION_TYPES: readonly ['portfolioHero', 'portfolioChallenges', 'portfolioBeforeAfter', 'portfolioStrategy', 'portfolioSiteArchitecture', 'portfolioDesignSystem', 'portfolioFeatureSpotlight', 'portfolioGallery', 'portfolioVideo', 'portfolioTechStack', 'portfolioPerformance', 'portfolioSpeedComparison', 'portfolioResults', 'portfolioMetricsTimeline', 'portfolioConversionFunnel', 'portfolioServices', 'portfolioTeam', 'portfolioTestimonial', 'portfolioDetails', 'portfolioSeo', 'portfolioCTA'];
+export type PortfolioSectionType = (typeof PORTFOLIO_SECTION_TYPES)[number];
+export declare function isPortfolioSectionType(value: unknown): value is PortfolioSectionType;
+/**
+ * Which stage each section belongs to. Null for the hero (it opens the page,
+ * above the story), SEO metadata (never rendered as a section) and the CTA
+ * (closes the page, after the story). Typed over every section type so a new
+ * type without a stage is a compile error, not a section that renders last.
+ */
+export declare const SECTION_STAGE: Record<PortfolioSectionType, CaseStudyStage | null>;
+/** The stage a section type belongs to, or null when it sits outside the story. Unknown types are null. */
+export declare function sectionStage(type: string): CaseStudyStage | null;
+/**
+ * The one section each stage can't do without. A stage with other sections
+ * but not this one is told so by {@link caseStudyStageStatus}: a proof stage
+ * that's only a speed comparison has no measurement of the finished build.
+ */
+export declare const STAGE_CORE_SECTION: Record<CaseStudyStage, PortfolioSectionType>;
+/**
+ * Canonical display order, derived from the list above so it can't disagree
+ * with the stages. Renderers sort by this when nobody has reordered; the
+ * dashboard's stored order only ever moves a section within its stage.
+ */
+export declare const PORTFOLIO_SECTION_ORDER: Record<PortfolioSectionType, number>;
+/** The least a section needs for the ordering helpers: its type. Anything else rides along. */
+export interface SectionLike {
+    sectionType: string;
+}
+/**
+ * The sections in the order the case study reads.
+ *
+ * The arc always wins: the hero, then problem, build, proof, outcome, then
+ * the CTA. Within a stage, the agency's own order is kept once it has
+ * reordered in the dashboard (`sectionsOrdered`); otherwise the canonical
+ * order. Before this, a reordered case study rendered in exactly its stored
+ * order, so Results could sit above Challenges and the page read backwards.
+ * Never mutates.
+ */
+export declare function orderSections<T extends SectionLike>(sections: readonly T[] | null | undefined, options?: {
+    sectionsOrdered?: boolean;
+}): T[];
+/** One beat of the story with the sections that tell it. */
+export interface CaseStudyStageGroup<T extends SectionLike = SectionLike> {
+    stage: CaseStudyStage;
+    /** 1-based position among the stages this case study actually has. */
+    index: number;
+    sections: T[];
+}
+/**
+ * The story's beats, in order, each with its sections in reading order
+ * ({@link orderSections}). A stage with no sections is left out and the
+ * numbering follows, so a software case study with nothing measured runs
+ * problem, build, outcome as 1, 2, 3. The hero, SEO and CTA aren't in any
+ * group; a renderer places them itself.
+ */
+export declare function groupSectionsByStage<T extends SectionLike>(sections: readonly T[] | null | undefined, options?: {
+    sectionsOrdered?: boolean;
+}): CaseStudyStageGroup<T>[];
+/** What each stage of a case study has and what it's missing. */
+export interface CaseStudyStageStatus {
+    stage: CaseStudyStage;
+    /** The section types present, in reading order. */
+    present: PortfolioSectionType[];
+    /** True when the stage's core section ({@link STAGE_CORE_SECTION}) is present. */
+    complete: boolean;
+    /** Null when complete; otherwise one sentence on what the stage is missing. */
+    missing: string | null;
+}
+/**
+ * Each stage's status, all four, in order, whether or not the case study has
+ * sections in it. The dashboard shows these beside the editor so an empty
+ * proof stage is seen before the case study is published, not after.
+ */
+export declare function caseStudyStageStatus(sections: readonly SectionLike[] | null | undefined): CaseStudyStageStatus[];
+export interface CaseStudyNarrative {
+    /** One sentence: what this project was, in the end. */
+    thesis: string;
+    /** One or two sentences opening each stage, specific to this project. A stage may be left unwritten. */
+    stages: Partial<Record<CaseStudyStage, string>>;
+}
+/** The longest a thesis or a stage lede may run. Longer is a paragraph, and the sections are the paragraphs. */
+export declare const NARRATIVE_MAX_CHARS = 320;
+/**
+ * What's wrong with a narrative, or an empty list when nothing is. An absent
+ * narrative is legacy data and passes (renderers fall back to house copy);
+ * one that's present must be prose, under the length, with no unknown stage.
+ */
+export declare function narrativeProblems(narrative: unknown): string[];
+/** Agent-native contract: JSON Schema for {@link CaseStudyNarrative}. */
+export declare const CASE_STUDY_NARRATIVE_JSON_SCHEMA: {
+    readonly $schema: 'http://json-schema.org/draft-07/schema#';
+    readonly $id: 'https://sonor.io/schemas/case-study-narrative.v1.json';
+    readonly title: 'CaseStudyNarrative';
+    readonly description: 'The thesis of a case study and the lede that opens each of its four stages.';
+    readonly type: 'object';
+    readonly required: readonly ['thesis'];
+    readonly properties: {
+        readonly thesis: {
+            readonly type: 'string';
+            readonly minLength: 1;
+            readonly maxLength: 320;
+        };
+        readonly stages: {
+            readonly type: 'object';
+            readonly properties: {
+                [k: string]: {
+                    type: string;
+                    maxLength: number;
+                };
+            };
+            readonly additionalProperties: false;
+        };
+    };
+    readonly additionalProperties: false;
+};
+export interface ChallengeLike {
+    id?: string | null;
+    title?: string;
+}
+export interface PhaseLike {
+    resolves?: readonly string[] | null;
+}
+export interface ResultLike {
+    proves?: readonly string[] | null;
+}
+/** A stable id for the n-th challenge (1-based): "c1", "c2"… Writers that don't mint their own use this. */
+export declare function challengeId(position: number): string;
+/**
+ * The problems with how a case study's story hangs together, each one
+ * sentence, or an empty list. Read by the generator's audit and the
+ * dashboard. It judges links only where they've been written: a case study
+ * whose challenges carry no ids has nothing to check and passes, so legacy
+ * content isn't failed for predating the thread.
+ */
+export declare function caseStudyFlowProblems(input: {
+    challenges?: readonly ChallengeLike[] | null;
+    phases?: readonly PhaseLike[] | null;
+    results?: readonly ResultLike[] | null;
+}): string[];
 /** Minimal KPI shape the policy reads — callers pass their own richer tiles. */
 export interface KpiLike {
     label: string;

package/dist/contracts/public-url-host.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The shared literal-host SSRF policy. Pass URL.hostname (which canonicalizes
+ * numeric IPv4 spellings), or an address returned by a DNS lookup. IPv6 may
+ * have the brackets URL.hostname retains. This isn't a URL validator and
+ * doesn't trim input, resolve DNS, follow redirects or open a connection.
+ * Callers still enforce their protocol/port rules and check or pin the DNS
+ * addresses used by each connection; a false result alone can't prove a
+ * destination is public.
+ */
+export declare function isBlockedPublicUrlHost(rawHost: string): boolean;

package/dist/contracts/publication-branding.d.ts

@@ -0,0 +1,151 @@
+import { type BroadcastStyleId, type PublicationCardLayout } from './broadcast-layouts';
+import { type PublicationCharter } from './publication-charter';
+export { PUBLICATION_CHARTER_FIELDS, parsePublicationCharter, parseSiteCharters, publicationCharterContext, publicationCharterFor, type PublicationCharter, } from './publication-charter';
+/** The stored profile's version. A breaking change to the shape bumps it. */
+export declare const PUBLICATION_BRANDING_VERSION: 1;
+/** Where a publication appears. `social` overrides every social network; each network can override again. */
+export declare const PUBLICATION_PLATFORMS: readonly ['publication', 'email', 'social', 'instagram', 'facebook', 'linkedin', 'gbp'];
+export type PublicationPlatform = (typeof PUBLICATION_PLATFORMS)[number];
+/** The sections of a profile and of each platform override, in the order they're read. */
+export declare const PUBLICATION_BRANDING_SECTIONS: readonly ['identity', 'colors', 'typography', 'editorial', 'newsletter'];
+export type PublicationBrandingSection = (typeof PUBLICATION_BRANDING_SECTIONS)[number];
+export declare const PUBLICATION_IDENTITY_FIELDS: readonly ['publicationName', 'wordmark', 'tagline', 'publisherName', 'publisherUrl', 'publisherLogoUrl', 'logos', 'squareLogoUrl', 'fullLogoUrl'];
+export declare const PUBLICATION_LOGO_VARIANTS: readonly ['default', 'light', 'dark'];
+export declare const PUBLICATION_COLOR_FIELDS: readonly ['primary', 'secondary', 'accent', 'background', 'surface', 'text', 'muted', 'border'];
+export declare const PUBLICATION_TYPOGRAPHY_FIELDS: readonly ['heading', 'body', 'mono', 'emailHeadingFallback', 'emailBodyFallback'];
+export declare const PUBLICATION_EDITORIAL_FIELDS: readonly ['articleStyle', 'cardLayout', 'focusClosingBackground', 'charter', 'siteCharters'];
+export declare const FOCUS_CLOSING_BACKGROUNDS: readonly ['planned_photo', 'article_atmosphere'];
+export declare const PUBLICATION_NEWSLETTER_FIELDS: readonly ['name', 'tagline', 'layout', 'maxWidth'];
+/** Fonts every email client has, the only families an email fallback may name. Lowercase. */
+export declare const EMAIL_SAFE_FONTS: ReadonlySet<string>;
+/** CSS generic families: written bare and lowercase in a font stack, never quoted. */
+export declare const GENERIC_FONT_FAMILIES: ReadonlySet<string>;
+export interface PublicationIdentity {
+    publicationName?: string;
+    wordmark?: string;
+    tagline?: string;
+    publisherName?: string;
+    publisherUrl?: string;
+    /** The publisher's attribution mark, separate from the publication masthead. */
+    publisherLogoUrl?: string;
+    /** The publication's square mark; independent of theme variants and publisher attribution. */
+    squareLogoUrl?: string;
+    /** The publication's full/display logo; wordmark remains a text fallback. */
+    fullLogoUrl?: string;
+    /** Legacy theme variants, not square/full logo roles. */
+    logos?: {
+        default?: string;
+        light?: string;
+        dark?: string;
+    };
+}
+export interface PublicationColors {
+    primary?: string;
+    secondary?: string;
+    accent?: string;
+    background?: string;
+    surface?: string;
+    text?: string;
+    muted?: string;
+    border?: string;
+}
+export interface PublicationTypography {
+    heading?: string;
+    body?: string;
+    mono?: string;
+    emailHeadingFallback?: string;
+    emailBodyFallback?: string;
+}
+export interface PublicationEditorial {
+    charter?: PublicationCharter;
+    siteCharters?: Record<string, PublicationCharter>;
+    /** Shared Broadcast style for articles, reviews and generated posts; portfolio is excluded. Legacy wire name. */
+    articleStyle?: BroadcastStyleId;
+    cardLayout?: PublicationCardLayout;
+    /** Focus closing frames may reuse the article's saved atmosphere and real author portrait. */
+    focusClosingBackground?: (typeof FOCUS_CLOSING_BACKGROUNDS)[number];
+}
+export interface PublicationNewsletter {
+    name?: string;
+    tagline?: string;
+    layout?: 'editorial';
+    maxWidth?: 600 | 640;
+}
+export interface PublicationBrandingSections {
+    identity?: PublicationIdentity;
+    colors?: PublicationColors;
+    typography?: PublicationTypography;
+    editorial?: PublicationEditorial;
+    newsletter?: PublicationNewsletter;
+}
+/** Exactly the object stored in projects.settings.publication_branding. */
+export interface PublicationBranding extends PublicationBrandingSections {
+    version: typeof PUBLICATION_BRANDING_VERSION;
+    platforms?: Partial<Record<PublicationPlatform, PublicationBrandingSections>>;
+}
+export type PublicationBrandingProfile = PublicationBranding;
+type LeafPatch<T> = {
+    [K in keyof T]?: NonNullable<T[K]> extends object ? LeafPatch<NonNullable<T[K]>> : T[K] | null;
+};
+export type PublicationBrandingSectionsPatch = LeafPatch<PublicationBrandingSections>;
+/** A change: any leaf set to a value, or to null to clear that override. */
+export interface PublicationBrandingPatch extends PublicationBrandingSectionsPatch {
+    version?: typeof PUBLICATION_BRANDING_VERSION;
+    platforms?: Partial<Record<PublicationPlatform, PublicationBrandingSectionsPatch>>;
+}
+/**
+ * A refusal, naming the field: `publication_branding.colors.primary: use a
+ * valid opaque color`. One case throws a plain Error instead: a charter set on
+ * a channel override, which belongs to the publication or a site.
+ */
+export declare class PublicationBrandingValidationError extends Error {
+    readonly path: string;
+    constructor(path: string, reason: string);
+}
+/** True for a control character (U+0000-U+001F, U+007F) anywhere in the text. */
+export declare function containsControlCharacters(value: string): boolean;
+/**
+ * A CSS font stack as data, never a stylesheet fragment: quoted family names
+ * and lowercase generic families joined by commas ("'Brand Display',serif"),
+ * or undefined when the value carries rules, variables, url() or anything
+ * that isn't a family name. The theme aliases heading, body and mono drop out.
+ */
+export declare function safeFontStack(value: unknown): string | undefined;
+export interface PublicationBrandingValidatorOptions {
+    /**
+     * True when a URL's hostname must never be stored as a logo or publisher
+     * URL: loopback, private and link-local ranges, `localhost` and the like.
+     * Each API passes the shared `public-url-host` policy. It receives
+     * `new URL(value).hostname`, so IPv6 keeps its brackets.
+     */
+    isBlockedHost: (hostname: string) => boolean;
+}
+export interface PublicationBrandingValidator {
+    /** A whole saved profile. Retired card layouts still read. */
+    validatePublicationBranding(value: unknown): PublicationBranding;
+    /** A change. Leaves may be null (clear that override); a card layout must be one drawn today. */
+    validatePublicationBrandingPatch(value: unknown): PublicationBrandingPatch;
+    /** The sections of a profile or a platform override, at `path`. */
+    validatePublicationBrandingSections(input: unknown, path: string, patch: boolean): PublicationBrandingSections | PublicationBrandingSectionsPatch;
+    /**
+     * The saved profile with the change applied: a null leaf clears just that
+     * override and empty containers are pruned. No profile yet reads as
+     * `{ version: 1 }`; a change that sets nothing returns the profile as it was.
+     */
+    mergePublicationBrandingPatch(current: unknown, patch: unknown): PublicationBranding;
+    /** One text leaf: trimmed, 1 to max characters (0 when empty is allowed), no control characters. */
+    text(value: unknown, path: string, max: number, empty?: boolean): string;
+    /** One URL leaf: a public HTTPS URL without credentials, normalized. */
+    url(value: unknown, path: string): string;
+    /** One font leaf, normalized by safeFontStack; email fallbacks may name only EMAIL_SAFE_FONTS. */
+    font(value: unknown, path: string, emailSafe?: boolean): string;
+}
+/**
+ * Leaf-wise merge of a validated change into a profile layer: a null leaf
+ * deletes that key, an object merges recursively, and a container left empty
+ * is removed. The inputs are never mutated. The Sonor API layers resolved
+ * branding with the same merge.
+ */
+export declare function mergePublicationBrandingLayers(current: Record<string, unknown>, patch: Record<string, unknown>): Record<string, unknown>;
+/** Single source of truth for publication-branding validation, bound to the caller's host guard. */
+export declare function createPublicationBrandingValidator(options: PublicationBrandingValidatorOptions): PublicationBrandingValidator;

package/dist/contracts/publication-charter.d.ts

@@ -0,0 +1,14 @@
+/**
+ * A publication's editorial charter: data-only direction (who it's for, what
+ * they're deciding, the proof it holds itself to), never evidence of
+ * expertise or permission to publish private material. Part of
+ * `@sonordev/contracts/publication-branding`, which re-exports it; Signal's
+ * writers read it into their prompts and the Sonor API stores it in a
+ * publication's branding. Pure: no I/O, no Node built-ins.
+ */
+export declare const PUBLICATION_CHARTER_FIELDS: readonly ['audience', 'readerDecisions', 'perspective', 'expertise', 'proofStandards', 'tone', 'recurringSeries', 'nonAuthority'];
+export type PublicationCharter = Partial<Record<typeof PUBLICATION_CHARTER_FIELDS[number], string>>;
+export declare function parsePublicationCharter(value: unknown, patch?: boolean): PublicationCharter;
+export declare function parseSiteCharters(value: unknown, patch?: boolean): Record<string, PublicationCharter>;
+export declare function publicationCharterFor(editorial: unknown, site?: string | null): PublicationCharter;
+export declare function publicationCharterContext(charter?: PublicationCharter): string;

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

@@ -29,6 +29,8 @@ export declare const SITE_CACHE_TAGS: {
     readonly portfolio: 'portfolio';
     /** Products, services, events and membership plans (commerce-kit). */
     readonly commerce: 'commerce';
+    /** Published managed landing pages. Draft previews never enter this cache. */
+    readonly funnels: 'sonor-funnels';
 };
 export type SiteCacheTag = (typeof SITE_CACHE_TAGS)[keyof typeof SITE_CACHE_TAGS];
 /** The body Sonor POSTs to the revalidation route. */

package/dist/fleet/index.js

@@ -1,11 +1,11 @@
 'use client';
-export { FLEET_HEARTBEAT_PATH, FleetHeartbeat, detectNextVersion, sendFleetHeartbeat } from '../chunk-ZDUTXHM6.js';
+export { FLEET_HEARTBEAT_PATH, FleetHeartbeat, detectNextVersion, sendFleetHeartbeat } from '../chunk-5WHBYQJ4.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-DLM4FFNH.js';
-import '../chunk-EKBEOXTH.js';
-import '../chunk-GDQKDL3E.js';
-import '../chunk-OEA7U4HJ.js';
+import '../chunk-QTBAKOCZ.js';
+import '../chunk-VEJD5EJ2.js';
+import '../chunk-UYOE3HA4.js';
+import '../chunk-P5PRR2BB.js';
 import '../chunk-W7OPEMGJ.js';
-import '../chunk-CFSIGEUW.js';
+import '../chunk-MNORERMF.js';
 import '../chunk-PKBMQBKP.js';

package/dist/forms/FileField.d.ts

@@ -24,5 +24,7 @@ export interface FileFieldProps {
     classPrefix: string;
     baseInputStyle: React.CSSProperties;
     onChange: (value: unknown) => void;
+    ariaInvalid?: boolean;
+    describedBy?: string;
 }
-export declare function FileField({ field, inputId, classPrefix, baseInputStyle, onChange, }: FileFieldProps): React.JSX.Element;
+export declare function FileField({ field, inputId, classPrefix, baseInputStyle, onChange, ariaInvalid, describedBy, }: FileFieldProps): React.JSX.Element;

package/dist/forms/PrivateFileField.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import type { FileFieldProps } from './FileField';
+export declare function PrivateFileField({ field, inputId, onChange, ariaInvalid, describedBy }: Pick<FileFieldProps, 'field' | 'inputId' | 'onChange' | 'ariaInvalid' | 'describedBy'>): React.JSX.Element;

package/dist/forms/index.js

@@ -1,25 +1,25 @@
 'use client';
-export { configureFormsApi, defineForm, field, formsApi, initializeForms } from '../chunk-2QFIYYMP.js';
-export { FormClient, ManagedForm } from '../chunk-3PT6SO65.js';
-import '../chunk-DLTLXYOV.js';
-export { DatePicker } from '../chunk-SOD2F6C2.js';
+export { configureFormsApi, defineForm, field, formsApi, initializeForms } from '../chunk-RHT7OZNF.js';
 export { FormCelebration } from '../chunk-YGGDU6C3.js';
-export { useForm, useFormTracking } from '../chunk-27LYZVPP.js';
+export { FormClient, ManagedForm } from '../chunk-L2KSHJS2.js';
+import '../chunk-36ZMNBXZ.js';
+export { DatePicker } from '../chunk-SOD2F6C2.js';
+export { useForm, useFormTracking } from '../chunk-LGWN6KCN.js';
 import '../chunk-Q6E4OPGG.js';
 import '../chunk-5ROTTMBL.js';
-export { FormEnhancer } from '../chunk-GLLFIE2R.js';
+export { FormEnhancer } from '../chunk-G5FD7UXK.js';
 import '../chunk-C2FZBUSS.js';
 import '../chunk-YC7ELZS3.js';
 import '../chunk-DXO6SBMD.js';
-export { FormField as FormFieldComponent, autocompleteFor } from '../chunk-TYAVHRWH.js';
-export { DEFAULT_FORM_SUCCESS_MESSAGE } from '../chunk-5SQK3D53.js';
+export { FormField as FormFieldComponent, autocompleteFor } from '../chunk-CVADNHJ4.js';
+export { DEFAULT_FORM_SUCCESS_MESSAGE } from '../chunk-TYSIAWC3.js';
 import '../chunk-HW7B43E5.js';
 import '../chunk-NJCTQH2P.js';
 import '../chunk-L2V5PUFN.js';
 import '../chunk-GJWI74ZZ.js';
 import '../chunk-5TM3WPCI.js';
-import '../chunk-GDQKDL3E.js';
-import '../chunk-OEA7U4HJ.js';
+import '../chunk-UYOE3HA4.js';
+import '../chunk-P5PRR2BB.js';
 import '../chunk-W7OPEMGJ.js';
-import '../chunk-CFSIGEUW.js';
+import '../chunk-MNORERMF.js';
 import '../chunk-PKBMQBKP.js';

package/dist/forms/private-file-rules.d.ts

@@ -0,0 +1,8 @@
+export declare const PRIVATE_FILE_MAX_BYTES: number;
+export declare const PRIVATE_FILE_TYPES: readonly ['application/pdf', 'image/jpeg', 'image/png', 'image/webp'];
+export declare const PRIVATE_FILE_ACCEPT = ".pdf,.jpg,.jpeg,.png,.webp";
+export declare function validatePrivateFileSelection(files: Array<{
+    name: string;
+    size: number;
+    type: string;
+}>, maxFiles?: number): string | null;

package/dist/forms/server.js

@@ -1,11 +1,11 @@
-export { ServerForm, getFormConfig } from '../chunk-ZSU7KTIE.js';
-import '../chunk-GLLFIE2R.js';
+export { ServerForm, getFormConfig } from '../chunk-DPYGC7WE.js';
+import '../chunk-G5FD7UXK.js';
 import '../chunk-C2FZBUSS.js';
 import '../chunk-YC7ELZS3.js';
-export { StaticForm } from '../chunk-LNSF6BJC.js';
+export { StaticForm } from '../chunk-VPZJ7ZTL.js';
 import '../chunk-DXO6SBMD.js';
-import '../chunk-TYAVHRWH.js';
-import '../chunk-5SQK3D53.js';
+import '../chunk-CVADNHJ4.js';
+import '../chunk-TYSIAWC3.js';
 import '../chunk-HW7B43E5.js';
 import '../chunk-NJCTQH2P.js';
 import '../chunk-C7TLGL3R.js';

package/dist/forms/static.js

@@ -1,7 +1,7 @@
-export { StaticForm } from '../chunk-LNSF6BJC.js';
+export { StaticForm } from '../chunk-VPZJ7ZTL.js';
 import '../chunk-DXO6SBMD.js';
-import '../chunk-TYAVHRWH.js';
-import '../chunk-5SQK3D53.js';
+import '../chunk-CVADNHJ4.js';
+import '../chunk-TYSIAWC3.js';
 import '../chunk-HW7B43E5.js';
 import '../chunk-NJCTQH2P.js';
 import '../chunk-PKBMQBKP.js';

package/dist/forms/styles.css

@@ -439,4 +439,20 @@
   color: var(--sk-text-tertiary);
   margin: 8px 0;
 }
-
+.sk-file-dropzone { position: relative; display: flex; flex-direction: column; align-items: center; justify-content: center; gap: 8px; min-height: 180px; padding: 24px 16px; border: 1.5px dashed rgba(var(--sk-primary-rgb), .38); border-radius: 12px; background: rgba(var(--sk-primary-rgb), .035); color: var(--sk-primary); text-align: center; cursor: pointer; }
+.sk-file-dropzone--active, .sk-file-dropzone:focus-within { outline: 2px solid var(--sk-primary); outline-offset: 3px; background: rgba(var(--sk-primary-rgb), .075); }
+.sk-file-dropzone--busy { cursor: progress; }
+.sk-file-dropzone__title { display: block; font-size: 15px; font-weight: 600; }
+.sk-file-dropzone__hint { font-size: 12px; color: var(--sk-text-secondary); }
+.sk-file-dropzone__hint span { color: var(--sk-primary); text-decoration: underline; text-underline-offset: 3px; }
+.sk-file-dropzone__formats { font-size: 10px; color: var(--sk-text-tertiary); margin-top: 4px; }
+.sk-file-dropzone__input { position: absolute; width: 1px; height: 1px; padding: 0; margin: -1px; overflow: hidden; clip-path: inset(50%); white-space: nowrap; }
+.sk-private-files__list { list-style: none; padding: 0; margin: 12px 0 0; }
+.sk-private-files__list li { display: flex; align-items: center; gap: 12px; justify-content: space-between; border: 1px solid rgba(var(--sk-primary-rgb), .15); border-radius: 9px; padding: 12px; margin-top: 8px; }
+.sk-private-files__name { min-width: 0; overflow-wrap: anywhere; font-size: 12px; color: var(--sk-text-primary); }
+.sk-private-files__name small { display: block; font-size: 10px; color: var(--sk-text-tertiary); margin-top: 4px; }
+.sk-private-files__list li > div { display: flex; gap: 10px; flex-shrink: 0; }
+.sk-private-files__list button { padding: 5px 0; min-height: 32px; font-size: 10px; color: var(--sk-primary); cursor: pointer; text-decoration: underline; text-underline-offset: 3px; }
+.sk-private-files__list button:disabled { opacity: .5; cursor: wait; }
+.sk-private-files__status { font-size: 10px; color: var(--sk-text-tertiary); margin: 9px 0 0; line-height: 1.7; }
+.sk-private-files__error { font-size: 12px; color: var(--sk-error); margin: 9px 0 0; line-height: 1.7; }

package/dist/forms/types.d.ts

@@ -107,6 +107,10 @@ export interface FieldOption {
     label: string;
 }
 export interface ValidationRules {
+    /** Use private Sonor attachment storage instead of the public media upload. */
+    private_attachments?: boolean;
+    /** Private document fields accept 1 to 4 files. */
+    max_files?: number;
     min_length?: number;
     max_length?: number;
     min?: number;

package/dist/images/index.js

@@ -1,6 +1,6 @@
-export { ManagedImage, assignImageToSlot, clearImageSlot, fetchManagedImage, fetchManagedImages, listImageFiles, uploadImage } from '../chunk-Q4Y3WIHE.js';
+export { ManagedImage, assignImageToSlot, clearImageSlot, fetchManagedImage, fetchManagedImages, listImageFiles, uploadImage } from '../chunk-HWQPCZOX.js';
 export { ManagedFavicon, getManagedFaviconUrl } from '../chunk-GW7GSBO7.js';
-import '../chunk-GDQKDL3E.js';
-import '../chunk-OEA7U4HJ.js';
-import '../chunk-CFSIGEUW.js';
+import '../chunk-UYOE3HA4.js';
+import '../chunk-P5PRR2BB.js';
+import '../chunk-MNORERMF.js';
 import '../chunk-PKBMQBKP.js';

package/dist/index.js

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

package/dist/landing/contract.d.ts

@@ -1,13 +1,2 @@
-/**
- * Landing-page campaign contract.
- *
- * normalizeCampaignSlug is an inlined MIRROR of the Sonor API's campaign
- * normalizer (the CANONICAL copy); keep the function body byte-identical.
- * Both sides assert the same fixed vectors (this package's
- * landing/contract.test.ts), so silent drift fails CI on either side.
- *
- * A slug normalized here always matches the server's canonical form, so the
- * campaign a developer declares in code is exactly the identity the
- * dashboard reports on.
- */
-export declare function normalizeCampaignSlug(input?: string | null): string | null;
+/** Compatibility entry. The shared contract owns campaign normalization. */
+export { normalizeCampaignSlug } from '../contracts/campaign-normalize';

package/dist/landing/contract.js

@@ -0,0 +1,2 @@
+export { normalizeCampaignSlug } from '../chunk-3MJNBOUO.js';
+import '../chunk-PKBMQBKP.js';

package/dist/landing/index.js

@@ -1,3 +1,5 @@
-export { LandingPage } from '../chunk-JJ4JS3LD.js';
-export { landingPageMetadata, normalizeCampaignSlug } from '../chunk-OSYCOC3K.js';
+import '../chunk-BTHEQDN4.js';
+export { LandingPage } from '../chunk-PAYCK7FC.js';
+export { normalizeCampaignSlug } from '../chunk-3MJNBOUO.js';
+export { landingPageMetadata } from '../chunk-JESLPEST.js';
 import '../chunk-PKBMQBKP.js';

package/dist/landing/managed-server.d.ts

@@ -0,0 +1,21 @@
+import 'server-only';
+import React from 'react';
+import type { Metadata } from 'next';
+import { type ResolveServerApiConfigOptions } from '../server/server-fetch';
+import { type PublishedFunnelPage } from '../contracts/funnels';
+export interface GetPublishedFunnelPageOptions extends ResolveServerApiConfigOptions {
+    /** Explicit registered site host. No primary-domain or sibling-site fallback. */
+    site: string;
+}
+/** Current published pointer, uncached so pointer changes take effect at the next read. */
+export declare function getPublishedFunnelPage(slug: string, options: GetPublishedFunnelPageOptions): Promise<PublishedFunnelPage | null>;
+export declare function managedFunnelMetadata(page: PublishedFunnelPage): Metadata;
+export interface ManagedFunnelPageProps {
+    page: PublishedFunnelPage;
+    /** Expiring owner dashboard preview only. Never fetches or mounts a live form. */
+    preview?: boolean;
+    /** Optional server transport overrides; never forwarded to browser markup. */
+    configOptions?: ResolveServerApiConfigOptions;
+}
+/** Server-rendered content plus the existing managed browser form and deferred analytics contract. */
+export declare function ManagedFunnelPage({ page: input, preview, configOptions }: ManagedFunnelPageProps): Promise<React.JSX.Element>;

package/dist/landing/managed.d.ts

@@ -0,0 +1,11 @@
+import React, { type ReactNode } from 'react';
+import { type PublishedFunnelPage } from '../contracts/funnels';
+export interface FunnelPageContentProps {
+    page: PublishedFunnelPage;
+    /** A live managed form supplied by the server adapter. Never used in a preview. */
+    conversion?: ReactNode;
+    /** Private dashboard preview. All conversion controls are inert. */
+    preview?: boolean;
+}
+/** Bounded SSR layout for newsletter, requested-guide and inquiry content. */
+export declare function FunnelPageContent({ page: input, conversion, preview }: FunnelPageContentProps): React.JSX.Element;

package/dist/landing/metadata.js

@@ -0,0 +1,2 @@
+export { landingPageMetadata } from '../chunk-JESLPEST.js';
+import '../chunk-PKBMQBKP.js';

package/dist/landing/server.d.ts

@@ -29,3 +29,8 @@
  */
 export { landingPageMetadata } from './metadata';
 export { normalizeCampaignSlug } from './contract';
+export { getPublishedFunnelPage, managedFunnelMetadata, ManagedFunnelPage } from './managed-server';
+export type { GetPublishedFunnelPageOptions, ManagedFunnelPageProps } from './managed-server';
+export { FunnelPageContent } from './managed';
+export type { FunnelPageContentProps } from './managed';
+export type { PublishedFunnelPage } from '../contracts/funnels';

package/dist/landing/server.js

@@ -1,3 +1,20 @@
-import '../chunk-7ZWO5HDQ.js';
-export { landingPageMetadata, normalizeCampaignSlug } from '../chunk-OSYCOC3K.js';
+export { FunnelPageContent, ManagedFunnelPage, getPublishedFunnelPage, managedFunnelMetadata } from '../chunk-FXR5PJDL.js';
+import '../chunk-PAYCK7FC.js';
+export { normalizeCampaignSlug } from '../chunk-3MJNBOUO.js';
+export { landingPageMetadata } from '../chunk-JESLPEST.js';
+import '../chunk-XHYE24HU.js';
+import '../chunk-DPYGC7WE.js';
+import '../chunk-G5FD7UXK.js';
+import '../chunk-C2FZBUSS.js';
+import '../chunk-YC7ELZS3.js';
+import '../chunk-VPZJ7ZTL.js';
+import '../chunk-DXO6SBMD.js';
+import '../chunk-CVADNHJ4.js';
+import '../chunk-TYSIAWC3.js';
+import '../chunk-HW7B43E5.js';
+import '../chunk-NJCTQH2P.js';
+import '../chunk-C7TLGL3R.js';
+import '../chunk-MH2DSGC6.js';
+import '../chunk-S22FSH7C.js';
+import '../chunk-A4CC4ZG3.js';
 import '../chunk-PKBMQBKP.js';