@riverbankcms/sdk 0.77.0 → 0.78.0

package/dist/_dts/db/src/schemas/forms.d.ts

@@ -364,13 +364,13 @@ export declare const formFieldSchema: z.ZodObject<{
         date: "date";
         time: "time";
         email: "email";
-        url: "url";
-        select: "select";
-        textarea: "textarea";
         text: "text";
-        tel: "tel";
-        radio: "radio";
+        textarea: "textarea";
+        select: "select";
         checkbox: "checkbox";
+        radio: "radio";
+        url: "url";
+        tel: "tel";
         consent: "consent";
     }>;
     required: z.ZodDefault<z.ZodBoolean>;
@@ -425,13 +425,13 @@ declare const bookingQuestionScalarFieldSchema: z.ZodObject<{
         date: "date";
         time: "time";
         email: "email";
-        url: "url";
-        select: "select";
-        textarea: "textarea";
         text: "text";
-        tel: "tel";
-        radio: "radio";
+        textarea: "textarea";
+        select: "select";
         checkbox: "checkbox";
+        radio: "radio";
+        url: "url";
+        tel: "tel";
     }>;
 }, z.core.$strict>;
 declare const bookingQuestionDocumentUploadFieldSchema: z.ZodObject<{
@@ -481,13 +481,13 @@ export declare const bookingQuestionFieldSchema: z.ZodDiscriminatedUnion<[z.ZodO
         date: "date";
         time: "time";
         email: "email";
-        url: "url";
-        select: "select";
-        textarea: "textarea";
         text: "text";
-        tel: "tel";
-        radio: "radio";
+        textarea: "textarea";
+        select: "select";
         checkbox: "checkbox";
+        radio: "radio";
+        url: "url";
+        tel: "tel";
     }>;
 }, z.core.$strict>, z.ZodObject<{
     id: z.ZodString;
@@ -540,13 +540,13 @@ export declare const bookingQuestionsSectionSchema: z.ZodObject<{
             date: "date";
             time: "time";
             email: "email";
-            url: "url";
-            select: "select";
-            textarea: "textarea";
             text: "text";
-            tel: "tel";
-            radio: "radio";
+            textarea: "textarea";
+            select: "select";
             checkbox: "checkbox";
+            radio: "radio";
+            url: "url";
+            tel: "tel";
         }>;
     }, z.core.$strict>, z.ZodObject<{
         id: z.ZodString;
@@ -602,13 +602,13 @@ export declare const bookingQuestionsDetailedSchemaSchema: z.ZodObject<{
                 date: "date";
                 time: "time";
                 email: "email";
-                url: "url";
-                select: "select";
-                textarea: "textarea";
                 text: "text";
-                tel: "tel";
-                radio: "radio";
+                textarea: "textarea";
+                select: "select";
                 checkbox: "checkbox";
+                radio: "radio";
+                url: "url";
+                tel: "tel";
             }>;
         }, z.core.$strict>, z.ZodObject<{
             id: z.ZodString;
@@ -646,13 +646,13 @@ export declare const formSchemaSchema: z.ZodObject<{
             date: "date";
             time: "time";
             email: "email";
-            url: "url";
-            select: "select";
-            textarea: "textarea";
             text: "text";
-            tel: "tel";
-            radio: "radio";
+            textarea: "textarea";
+            select: "select";
             checkbox: "checkbox";
+            radio: "radio";
+            url: "url";
+            tel: "tel";
             consent: "consent";
         }>;
         required: z.ZodDefault<z.ZodBoolean>;
@@ -705,13 +705,13 @@ export declare const bookingQuestionsFlatSchemaSchema: z.ZodObject<{
             date: "date";
             time: "time";
             email: "email";
-            url: "url";
-            select: "select";
-            textarea: "textarea";
             text: "text";
-            tel: "tel";
-            radio: "radio";
+            textarea: "textarea";
+            select: "select";
             checkbox: "checkbox";
+            radio: "radio";
+            url: "url";
+            tel: "tel";
         }>;
     }, z.core.$strict>, z.ZodObject<{
         id: z.ZodString;
@@ -763,13 +763,13 @@ export declare const bookingQuestionsStoredSchemaSchema: z.ZodUnion<readonly [z.
             date: "date";
             time: "time";
             email: "email";
-            url: "url";
-            select: "select";
-            textarea: "textarea";
             text: "text";
-            tel: "tel";
-            radio: "radio";
+            textarea: "textarea";
+            select: "select";
             checkbox: "checkbox";
+            radio: "radio";
+            url: "url";
+            tel: "tel";
         }>;
     }, z.core.$strict>, z.ZodObject<{
         id: z.ZodString;
@@ -824,13 +824,13 @@ export declare const bookingQuestionsStoredSchemaSchema: z.ZodUnion<readonly [z.
                 date: "date";
                 time: "time";
                 email: "email";
-                url: "url";
-                select: "select";
-                textarea: "textarea";
                 text: "text";
-                tel: "tel";
-                radio: "radio";
+                textarea: "textarea";
+                select: "select";
                 checkbox: "checkbox";
+                radio: "radio";
+                url: "url";
+                tel: "tel";
             }>;
         }, z.core.$strict>, z.ZodObject<{
             id: z.ZodString;
@@ -900,13 +900,13 @@ export declare const createFormPayloadSchema: z.ZodObject<{
                 date: "date";
                 time: "time";
                 email: "email";
-                url: "url";
-                select: "select";
-                textarea: "textarea";
                 text: "text";
-                tel: "tel";
-                radio: "radio";
+                textarea: "textarea";
+                select: "select";
                 checkbox: "checkbox";
+                radio: "radio";
+                url: "url";
+                tel: "tel";
                 consent: "consent";
             }>;
             required: z.ZodDefault<z.ZodBoolean>;

package/dist/_dts/media-core/src/assetsInUseSummary.d.ts

@@ -0,0 +1,34 @@
+export type AssetsInUseStage = 'draft' | 'published';
+export type AssetsInUseLocationLike = Readonly<{
+    kind: 'pageBlock';
+    pageDraftPath?: string | null;
+    pagePublishedPath?: string | null;
+    pageTitle?: string | null;
+    stage: AssetsInUseStage;
+    blockKind: string;
+}> | Readonly<{
+    kind: 'contentEntry';
+    routeDraftPath?: string | null;
+    routePublishedPath?: string | null;
+    entryTitle: string;
+    stage: AssetsInUseStage;
+}> | Readonly<{
+    kind: 'productFileDownload';
+    productTitle: string;
+}>;
+export type AssetsInUseItemLike = Readonly<{
+    usedCount: number;
+}>;
+export type AssetsInUseResponseLike<TItem extends AssetsInUseItemLike> = Readonly<{
+    items: readonly TItem[];
+}>;
+export type AssetsInUseSummary<TItem extends AssetsInUseItemLike> = Readonly<{
+    usedItems: readonly TItem[];
+    totalAssets: number;
+    totalLocations: number;
+    totalAssetLabel: 'item' | 'items';
+    totalLocationLabel: 'place' | 'places';
+}>;
+export declare function formatMediaUsageStage(stage: AssetsInUseStage): string;
+export declare function mediaUsageLocationLabel(location: AssetsInUseLocationLike): string;
+export declare function summarizeAssetsInUse<TItem extends AssetsInUseItemLike>(usage: AssetsInUseResponseLike<TItem> | null): AssetsInUseSummary<TItem>;

package/dist/_dts/media-core/src/bulkDeletePlanning.d.ts

@@ -0,0 +1,24 @@
+export type MediaUsageCheckItemWithCount = Readonly<{
+    usedCount: number;
+}>;
+export type MediaUsageCheckResponseWithCounts = Readonly<{
+    items: readonly MediaUsageCheckItemWithCount[];
+}>;
+export type BulkDeleteResultLike = Readonly<{
+    deleted: number;
+    failed: number;
+}>;
+export type BulkDeleteOptions = Readonly<{
+    deleteObjects?: boolean;
+    cascadeLabels?: boolean;
+}>;
+export declare const BULK_DELETE_IN_PROGRESS_MESSAGE = "Delete already in progress";
+export type BulkDeleteCompletionToast = Readonly<{
+    kind: 'success';
+    message: string;
+}> | Readonly<{
+    kind: 'error';
+    message: string;
+}>;
+export declare function hasMediaUsage(response: MediaUsageCheckResponseWithCounts): boolean;
+export declare function planBulkDeleteCompletionToast(result: BulkDeleteResultLike): BulkDeleteCompletionToast;

package/dist/_dts/media-core/src/canonicalCropReview.d.ts

@@ -0,0 +1,66 @@
+export type UploadReviewTargetLike<TAsset> = Readonly<{
+    status: string;
+    asset?: TAsset | null;
+}>;
+export type CanonicalCropTarget<TAsset, TUpload> = Readonly<{
+    kind: 'upload';
+    upload: TUpload;
+    asset: TAsset;
+}> | Readonly<{
+    kind: 'asset';
+    asset: TAsset;
+}>;
+type CanonicalCropDialogState<TAsset, TUpload> = Readonly<{
+    kind: 'closed';
+}> | Readonly<{
+    kind: 'editing';
+    target: CanonicalCropTarget<TAsset, TUpload>;
+}> | Readonly<{
+    kind: 'saving';
+    target: CanonicalCropTarget<TAsset, TUpload>;
+}> | Readonly<{
+    kind: 'error';
+    target: CanonicalCropTarget<TAsset, TUpload>;
+    message: string;
+}>;
+export type CanonicalCropReviewState<TAsset, TUpload> = Readonly<{
+    reviewingIds: ReadonlySet<string>;
+    dialog: CanonicalCropDialogState<TAsset, TUpload>;
+}>;
+export type CanonicalCropDialogView<TAsset, TUpload> = Readonly<{
+    kind: 'closed';
+    asset: null;
+    error: null;
+    saving: false;
+    target: null;
+}> | Readonly<{
+    kind: 'open';
+    asset: TAsset;
+    error: string | null;
+    saving: boolean;
+    target: CanonicalCropTarget<TAsset, TUpload>;
+}>;
+export type CanonicalCropReviewAction<TAsset, TUpload> = Readonly<{
+    type: 'mark-reviewing';
+    uploadId: string;
+    reviewing: boolean;
+}> | Readonly<{
+    type: 'open-crop';
+    target: CanonicalCropTarget<TAsset, TUpload>;
+}> | Readonly<{
+    type: 'close-crop';
+}> | Readonly<{
+    type: 'submit-crop';
+}> | Readonly<{
+    type: 'crop-failed';
+    message: string;
+}> | Readonly<{
+    type: 'crop-completed';
+}>;
+export declare function createInitialCanonicalCropReviewState<TAsset, TUpload>(): CanonicalCropReviewState<TAsset, TUpload>;
+export declare function isReviewReady<TAsset, TUpload extends UploadReviewTargetLike<TAsset>>(upload: TUpload): upload is TUpload & {
+    asset: TAsset;
+};
+export declare function canonicalCropReviewReducer<TAsset, TUpload>(state: CanonicalCropReviewState<TAsset, TUpload>, action: CanonicalCropReviewAction<TAsset, TUpload>): CanonicalCropReviewState<TAsset, TUpload>;
+export declare function getCanonicalCropDialogView<TAsset, TUpload>(state: CanonicalCropReviewState<TAsset, TUpload>): CanonicalCropDialogView<TAsset, TUpload>;
+export {};

package/dist/_dts/media-core/src/classifyAllPlanning.d.ts

@@ -0,0 +1,48 @@
+export type MediaClassifyJobStatus = 'pending' | 'processing' | 'completed' | 'failed';
+export type ClassifySummary = Readonly<{
+    processed: number;
+    skipped: number;
+    failures: number;
+}>;
+export declare const EMPTY_CLASSIFY_SUMMARY: ClassifySummary;
+export type ClassifyJobState = Readonly<{
+    id: string;
+    status: MediaClassifyJobStatus;
+    summary: ClassifySummary;
+    completed: boolean;
+}>;
+export type ClassifyRunJobLike = Readonly<{
+    id: string;
+    status: MediaClassifyJobStatus;
+}>;
+export type ClassifyRunPayloadLike = Readonly<{
+    job?: ClassifyRunJobLike | null;
+    summary?: ClassifySummary | null;
+    completed?: boolean;
+}>;
+export type ClassifyWorkflowResult = Readonly<{
+    kind: 'nothingToClassify';
+    reason: string;
+}> | Readonly<{
+    kind: 'completed';
+    summary: ClassifySummary;
+    job: ClassifyJobState;
+}>;
+export type ClassifyCompletionToast = Readonly<{
+    kind: 'none';
+}> | Readonly<{
+    kind: 'success';
+    message: string;
+}> | Readonly<{
+    kind: 'warning';
+    message: string;
+}> | Readonly<{
+    kind: 'info';
+    message: string;
+}>;
+export declare function normalizeClassifySummary(summary: ClassifySummary | null | undefined): ClassifySummary;
+export declare function createCompletedClassifyResult(input: {
+    fallbackJobId: string;
+    runPayload: ClassifyRunPayloadLike;
+}): ClassifyWorkflowResult;
+export declare function planClassifyCompletionToast(result: ClassifyWorkflowResult): ClassifyCompletionToast;

package/dist/_dts/media-core/src/filename.d.ts

@@ -0,0 +1 @@
+export declare function filenameExtension(filename: string): string | null;

package/dist/_dts/media-core/src/index.d.ts

@@ -14,7 +14,16 @@ export * from './fileDownloadResolution';
 export * from './fileAssetDeletion';
 export * from './fileAssetCompatibility';
 export * from './fileMimeDetection';
+export * from './filename';
+export * from './uploadVerificationContract';
 export * from './videoPrep';
+export * from './videoAssetRepair';
+export * from './canonicalCropReview';
+export * from './mediaAssetUsageStatus';
+export * from './assetsInUseSummary';
+export * from './bulkDeletePlanning';
+export * from './classifyAllPlanning';
+export * from './mediaSettingsState';
 export * from './videoSlotPolicy';
 export * from './identifiers';
 export { getImageUrl, getDirectImageUrl, getDirectImageUrlForRelativePath, getDirectImageUrlForSiteScopedPath, getDirectImageUrlForBucketPath, getDirectImageUrlForStoragePath, getDirectImageUrlForMediaAsset, isRelativeDirectImageStoragePath, isSiteScopedDirectImageStoragePath, type DirectImageMediaAsset, type DirectImageUrlOptions, type DirectImageUrlPathTarget, type ImageProxyFit, type ImageProxyParams, } from './url';
@@ -32,3 +41,4 @@ export * from './mediaWriteNormalizer';
 export { walkAndCollectImageAttrs, pickFilenameFromUrl, type RichTextImageAttrsRef, } from './richTextImageCollector';
 export * from './richTextImageWriteNormalizer';
 export * from './mediaUsageProjection';
+export * from './portableMediaReferences';

package/dist/_dts/media-core/src/mediaAssetUsageStatus.d.ts

@@ -0,0 +1,47 @@
+export type UsageCheckedAssetLike = Readonly<{
+    id: string;
+    mimeType: string;
+}>;
+export type MediaUsageCheckItemLike = Readonly<{
+    assetId: string;
+    usedCount: number;
+}>;
+export type MediaUsageCheckResponseLike = Readonly<{
+    items: readonly MediaUsageCheckItemLike[];
+}>;
+export type StoredAssetUsageStatus = Readonly<{
+    kind: 'unknown';
+}> | Readonly<{
+    kind: 'checking';
+}> | Readonly<{
+    kind: 'eligible';
+    usedCount: 0;
+}> | Readonly<{
+    kind: 'ineligible';
+    usedCount: number;
+}> | Readonly<{
+    kind: 'notApplicable';
+}> | Readonly<{
+    kind: 'failed';
+    message: string;
+}>;
+export type StoredAssetUsageStatusByAssetId = Readonly<Record<string, StoredAssetUsageStatus>>;
+export declare function getRasterAssetIds(assets: readonly UsageCheckedAssetLike[]): readonly string[];
+export declare function getMissingAssetUsageIds(input: {
+    rasterAssetIds: readonly string[];
+    storedStatusByAssetId: StoredAssetUsageStatusByAssetId;
+    inFlightAssetIds: ReadonlySet<string>;
+}): readonly string[];
+export declare function markAssetUsageChecking(statusByAssetId: StoredAssetUsageStatusByAssetId, assetIds: readonly string[]): StoredAssetUsageStatusByAssetId;
+export declare function applyAssetUsageResponse(input: {
+    statusByAssetId: StoredAssetUsageStatusByAssetId;
+    requestedAssetIds: readonly string[];
+    response: MediaUsageCheckResponseLike;
+}): StoredAssetUsageStatusByAssetId;
+export declare function applyAssetUsageFailure(input: {
+    statusByAssetId: StoredAssetUsageStatusByAssetId;
+    requestedAssetIds: readonly string[];
+    message: string;
+}): StoredAssetUsageStatusByAssetId;
+export declare function removeInFlightAssetIds(inFlightAssetIds: ReadonlySet<string>, completedAssetIds: readonly string[]): ReadonlySet<string>;
+export declare function getStoredAssetUsageStatusForAsset(asset: UsageCheckedAssetLike, statusByAssetId: StoredAssetUsageStatusByAssetId): StoredAssetUsageStatus;

package/dist/_dts/media-core/src/mediaSettingsState.d.ts

@@ -0,0 +1,3 @@
+export declare function readPersistVariantsEnabled(settings: Readonly<{
+    persistVariants: boolean | null | undefined;
+}>): boolean;

package/dist/_dts/media-core/src/portableMediaReferences.d.ts

@@ -0,0 +1,38 @@
+type PortableMediaReferenceSource = 'media-field' | 'rich-text-image';
+export type PortableMediaReference = Readonly<{
+    kind: 'assetId';
+    assetId: string;
+    location: string;
+    source: PortableMediaReferenceSource;
+} | {
+    kind: 'identifier';
+    identifier: string;
+    location: string;
+    source: PortableMediaReferenceSource;
+}>;
+export type PortableMediaReferenceSummary = Readonly<{
+    references: PortableMediaReference[];
+    assetIds: string[];
+    identifiers: string[];
+}>;
+type PortableMediaLookupAsset = Readonly<{
+    id: string;
+    identifier?: string | null;
+}>;
+type PortableMediaLookup<TAsset extends PortableMediaLookupAsset> = Readonly<{
+    byId: Map<string, TAsset>;
+    byIdentifier: Map<string, TAsset>;
+}>;
+export type PortableMediaResolution<TAsset extends PortableMediaLookupAsset> = Readonly<{
+    kind: 'resolved';
+    reference: PortableMediaReference;
+    asset: TAsset;
+} | {
+    kind: 'missing';
+    reference: PortableMediaReference;
+}>;
+export declare function summarizePortableMediaReferences(references: readonly PortableMediaReference[]): PortableMediaReferenceSummary;
+export declare function collectPortableMediaReferencesFromContent(content: unknown): PortableMediaReferenceSummary;
+export declare function buildPortableMediaLookup<TAsset extends PortableMediaLookupAsset>(assets: readonly TAsset[]): PortableMediaLookup<TAsset>;
+export declare function resolvePortableMediaReferences<TAsset extends PortableMediaLookupAsset>(references: readonly PortableMediaReference[], lookup: PortableMediaLookup<TAsset>): PortableMediaResolution<TAsset>[];
+export {};

package/dist/_dts/media-core/src/uploadVerificationContract.d.ts

@@ -0,0 +1,28 @@
+import { type FileKind, type UploadIntent } from './fileDomain';
+/**
+ * Shared upload boundary contract derived from the caller-provided filename and
+ * declared MIME type. Accept surfaces, session creation, and finalization
+ * should all consult this module so file-kind acceptance and verification
+ * cannot drift apart.
+ */
+export type UploadCandidateDescriptor = Readonly<{
+    name: string;
+    type?: string | null;
+}>;
+export type UploadVerificationStrategy = Readonly<{
+    tag: 'magic-only';
+}> | Readonly<{
+    tag: 'text-fallback';
+    detectedMimeType: 'text/plain' | 'text/csv';
+}> | Readonly<{
+    tag: 'rtf-fallback';
+    detectedMimeType: 'application/rtf';
+}>;
+export type AcceptedUploadKindContract = Readonly<{
+    kind: FileKind;
+    verification: UploadVerificationStrategy;
+}>;
+export declare const PRODUCT_FILE_EXTENSION_TAGS: readonly ["pdf", "docx", "txt", "rtf", "csv", "zip", "mp3", "m4a", "wav", "ogg", "flac", "webm", "mp4", "mov"];
+export declare function resolveAcceptedUploadKindContract(candidate: UploadCandidateDescriptor): AcceptedUploadKindContract | undefined;
+export declare function isUploadKindCompatibleWithIntent(intent: UploadIntent, kind: FileKind): boolean;
+export declare function resolveVerifiedMimeTypeFromContract(buffer: Uint8Array | null, contract: AcceptedUploadKindContract | undefined): string | undefined;

package/dist/_dts/media-core/src/videoAssetRepair.d.ts

@@ -0,0 +1,38 @@
+import type { MediaAssetId } from '../../core/src/index';
+export type VideoRepairAssetLike = Readonly<{
+    id: MediaAssetId;
+    filename: string;
+    siteId: string;
+    mimeType: string;
+    thumbnailAssetId?: string | null;
+    durationSeconds?: number | null;
+    width?: number | null;
+    height?: number | null;
+}>;
+export type VideoAssetRepairPlan = Readonly<{
+    tag: 'none';
+}> | Readonly<{
+    tag: 'repair-metadata';
+    assetId: MediaAssetId;
+    filename: string;
+    siteId: string;
+    processingLabel: 'Reading video metadata';
+    processingText: 'Reading video metadata...';
+}> | Readonly<{
+    tag: 'repair-thumbnail-and-metadata';
+    assetId: MediaAssetId;
+    filename: string;
+    siteId: string;
+    processingLabel: 'Generating thumbnail';
+    processingText: 'Generating thumbnail...';
+}>;
+export type RunnableVideoAssetRepairPlan = Exclude<VideoAssetRepairPlan, {
+    tag: 'none';
+}>;
+export type VideoAssetRepairQueueState = Readonly<{
+    isProcessing: boolean;
+    isCompleted: boolean;
+    isFailed: boolean;
+}>;
+export declare function planVideoAssetRepair(asset: VideoRepairAssetLike): VideoAssetRepairPlan;
+export declare function shouldQueueVideoAssetRepair(plan: VideoAssetRepairPlan, queueState: VideoAssetRepairQueueState): plan is RunnableVideoAssetRepairPlan;

package/dist/_dts/media-editor/src/mediaEditorDebug.d.ts

@@ -0,0 +1 @@
+export declare function logMediaEditorDebug(event: string, payload: Record<string, unknown>): void;

package/dist/_dts/path-utils/src/index.d.ts

@@ -0,0 +1,8 @@
+export type PathSegment = string | number;
+export declare function parsePath(path: string | Array<PathSegment>): Array<PathSegment>;
+export declare function segmentsToPath(segments: Array<PathSegment>): string | undefined;
+export declare function getAtPath<T = unknown>(source: unknown, path: string | Array<PathSegment>): T | undefined;
+export declare function setAtPath(target: Record<string, unknown> | Array<unknown>, path: string | Array<PathSegment>, value: unknown): void;
+export declare function toAbsolutePath(base: string | undefined | null, path: string): string;
+export * from './redirectPaths';
+export * from './safeAppPath';

package/dist/_dts/path-utils/src/redirectPaths.d.ts

@@ -0,0 +1,26 @@
+export type RedirectPathParseError = {
+    tag: 'MISSING';
+} | {
+    tag: 'EMPTY';
+} | {
+    tag: 'CONTROL_CHAR';
+} | {
+    tag: 'BACKSLASH';
+} | {
+    tag: 'EXTERNAL_URL';
+} | {
+    tag: 'INVALID_PATH';
+} | {
+    tag: 'ENCODED_SEPARATOR';
+};
+export type RedirectPathParseResult = {
+    ok: true;
+    value: string;
+} | {
+    ok: false;
+    error: RedirectPathParseError;
+};
+export declare function parseInternalRedirectPath(value: unknown): RedirectPathParseResult;
+export declare function sanitizeInternalRedirectPath(value: unknown): string | null;
+export declare function parseSameOriginRedirectPath(value: unknown, baseUrl: string | URL): RedirectPathParseResult;
+export declare function sanitizeSameOriginRedirectPath(value: unknown, baseUrl: string | URL): string | null;

package/dist/_dts/path-utils/src/safeAppPath.d.ts

@@ -0,0 +1,26 @@
+import { type RedirectPathParseError } from './redirectPaths';
+declare const __brand: unique symbol;
+type Brand<T, B extends string> = T & {
+    readonly [__brand]: B;
+};
+/**
+ * A redirect path that has been validated as a safe, same-origin relative path.
+ *
+ * Parse once at the boundary, then carry the branded value inward instead of
+ * re-validating ad hoc string inputs in every auth flow.
+ */
+export type SafeAppPath = Brand<string, 'SafeAppPath'>;
+export type SafeAppPathParseError = RedirectPathParseError;
+export type SafeAppPathParseResult = {
+    ok: true;
+    value: SafeAppPath;
+} | {
+    ok: false;
+    error: SafeAppPathParseError;
+};
+export declare function parseSafeAppPath(value: unknown): SafeAppPathParseResult;
+export declare function sanitizeSafeAppPath(value: unknown): SafeAppPath | null;
+export declare function assertSafeAppPath(value: string): SafeAppPath;
+export declare function safeAppPathOrFallback(value: unknown, fallback: SafeAppPath): SafeAppPath;
+export declare function buildSafeRedirectUrl(path: SafeAppPath, baseUrl: string | URL): URL;
+export {};

package/dist/_dts/preview-next/src/client/preview/SiteChromeCustomizeButton.d.ts

@@ -1,4 +1,5 @@
 import type { SiteChromeEditableSurfaceKind } from './SiteChromeEditableSurface';
-export declare function SiteChromeCustomizeButton({ surface, }: {
+export declare function SiteChromeCustomizeButton({ surface, containerClassName, }: {
     surface: SiteChromeEditableSurfaceKind;
+    containerClassName?: string;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/_dts/preview-next/src/client/preview/SiteChromeCustomizeContext.d.ts

@@ -13,6 +13,9 @@ type SiteChromeCustomizeSurfaceState = Readonly<{
     kind: 'available';
     surface: 'header';
     label: string;
+    currentLayoutId: HeaderLayoutId;
+    currentLayoutLabel: string;
+    layoutOptions: readonly SiteChromeLookOption<HeaderLayoutId>[];
     currentId: HeaderStyleId;
     currentLabel: string;
     options: readonly SiteChromeLookOption<HeaderStyleId>[];
@@ -35,6 +38,7 @@ type SiteChromeCustomizeSurfaceState = Readonly<{
 type SiteChromeCustomizeContextValue = Readonly<{
     getSurfaceState: (surface: SiteChromeEditableSurfaceKind) => SiteChromeCustomizeSurfaceState;
     cycleSurfaceLook: (surface: SiteChromeEditableSurfaceKind, direction: 'prev' | 'next') => void;
+    cycleSurfaceLayout: (surface: SiteChromeEditableSurfaceKind, direction: 'prev' | 'next') => void;
 }>;
 export type SiteChromeCustomizeProviderProps = Readonly<{
     children: ReactNode;