@pagehub/sdk 0.1.0

package/dist/utils/logger.d.ts

@@ -0,0 +1,26 @@
+/**
+ * SDK logger — single output surface for every internal `console.*` call.
+ *
+ * Hosts can replace the default (which calls through to `console.*`) with
+ * `setSdkLogger()` to silence the SDK, pipe it into Sentry, or tag entries.
+ *
+ * Defaults call through lazily (no captured reference) so tests can still
+ * stub `console.warn = () => {}` without first swapping the SDK logger.
+ */
+export type SdkLogLevel = "debug" | "log" | "info" | "warn" | "error";
+export interface SdkLogger {
+    debug: (...args: unknown[]) => void;
+    log: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+}
+export declare function setSdkLogger(logger: Partial<SdkLogger> | null): void;
+export declare function getSdkLogger(): SdkLogger;
+/**
+ * Scoped logger — prefixes every entry with `[scope]`.
+ * Use one per module so disabling a noisy area is a single line in the host.
+ */
+export declare function createScopedLogger(scope: string): SdkLogger;
+export declare const sdkLog: SdkLogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEtE,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACpC,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAClC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACrC;AAYD,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI,GAAG,IAAI,CAYpE;AAED,wBAAgB,YAAY,IAAI,SAAS,CAExC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAS3D;AAED,eAAO,MAAM,MAAM,WAA4B,CAAC"}

package/dist/utils/lz.d.ts

@@ -0,0 +1,5 @@
+export declare function compressJsonToBase64Lz(input: unknown): string;
+export declare function decompressBase64LzToString(input: string): string;
+export declare function decompressBase64LzToJson<T = any>(input: string): T;
+export declare function tryDecompressBase64LzToJson<T = any>(input: unknown): T | null;
+//# sourceMappingURL=lz.d.ts.map

package/dist/utils/lz.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lz.d.ts","sourceRoot":"","sources":["../../src/utils/lz.ts"],"names":[],"mappings":"AAEA,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAG7D;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKhE;AAED,wBAAgB,wBAAwB,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAGlE;AAED,wBAAgB,2BAA2B,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,GAAG,IAAI,CAO7E"}

package/dist/utils/media/errors.d.ts

@@ -0,0 +1,21 @@
+import { PageHubError } from '../errors';
+export type MediaUploadErrorCode = "too_large" | "bad_mime" | "quota" | "cf_rejected" | "auth" | "rate_limited" | "network" | "unknown";
+export declare class MediaUploadError extends PageHubError {
+    readonly code: MediaUploadErrorCode;
+    status?: number;
+    constructor(code: MediaUploadErrorCode, message: string, status?: number);
+}
+/**
+ * Map a signed-URL-issuer non-OK response into a MediaUploadError. Building
+ * block for {@link MediaUploadHandler} implementations whose backend returns
+ * `{ error, code, status }` (with or without the structured code). Falls
+ * back sensibly on missing fields (older deploy, proxy error page, etc).
+ */
+export declare function parseApiMediaGetError(res: Response): Promise<MediaUploadError>;
+/**
+ * Map a Cloudflare direct_upload non-OK response into a MediaUploadError.
+ * Cloudflare returns `{ errors: [{ message }], success: false }` for most
+ * failures; 415 is AVIF-rejection territory.
+ */
+export declare function parseCloudflareError(res: Response): Promise<MediaUploadError>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/media/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/utils/media/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,MAAM,oBAAoB,GAC5B,WAAW,GACX,UAAU,GACV,OAAO,GACP,aAAa,GACb,MAAM,GACN,cAAc,GACd,SAAS,GACT,SAAS,CAAC;AAoBd,qBAAa,gBAAiB,SAAQ,YAAY;IAIhD,SAAiB,IAAI,EAAE,oBAAoB,CAAC;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEJ,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAMzE;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmBpF;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAkBnF"}

package/dist/utils/media/media.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Media management utilities — CRUD for pageMedia on ROOT_NODE
+ */
+/** Bare Cloudflare-style image id when background.imageType was not persisted */
+export declare const looksLikeCdnImageId: (content: string) => boolean;
+/** Calculate optimal background image size based on viewport and device pixel ratio */
+export declare const calculateOptimalBackgroundSize: () => number;
+export declare const registerMediaWithBackground: (query: any, actions: any, mediaId: string, mediaType?: string, componentId?: string) => void;
+export declare const unregisterMediaFromBackground: (query: any, actions: any, mediaId: string) => void;
+export declare const getPageMedia: (query: any) => any;
+/**
+ * Get the resolved URL for a media id.
+ * @param pageMedia - Array of media records (from `ROOT.props.pageMedia`).
+ *   Editor call sites pass `query.node(ROOT_NODE).get()?.data?.props?.pageMedia`.
+ *   Walker call sites read from `rootProps.pageMedia` directly.
+ */
+export declare const getMediaContent: (pageMedia: any[] | null | undefined, mediaId: string) => string | null;
+export declare const getResponsiveImageAttrs: (pageMedia: any[] | null | undefined, mediaId: string) => {
+    src: string;
+    srcset: string;
+    sizes: string;
+};
+export declare const getMediaById: (query: any, mediaId: string) => any | null;
+export declare const updateMediaMetadata: (query: any, actions: any, mediaId: string, metadata: {
+    alt?: string;
+    title?: string;
+    description?: string;
+}) => void;
+export declare const syncPageMedia: (query: any, actions: any) => string[];
+//# sourceMappingURL=media.d.ts.map

package/dist/utils/media/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../../src/utils/media/media.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,KAAG,OAKrD,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,8BAA8B,QAAO,MAKjD,CAAC;AAIF,eAAO,MAAM,2BAA2B,GACtC,OAAO,GAAG,EACV,SAAS,GAAG,EACZ,SAAS,MAAM,EACf,YAAW,MAAc,EACzB,cAAc,MAAM,SAwBrB,CAAC;AAEF,eAAO,MAAM,6BAA6B,GAAI,OAAO,GAAG,EAAE,SAAS,GAAG,EAAE,SAAS,MAAM,SAYtF,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,OAAO,GAAG,QAStC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAC1B,WAAW,GAAG,EAAE,GAAG,IAAI,GAAG,SAAS,EACnC,SAAS,MAAM,KACd,MAAM,GAAG,IAuBX,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,WAAW,GAAG,EAAE,GAAG,IAAI,GAAG,SAAS,EACnC,SAAS,MAAM;;;;CA4BhB,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,OAAO,GAAG,EAAE,SAAS,MAAM,KAAG,GAAG,GAAG,IAWhE,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC9B,OAAO,GAAG,EACV,SAAS,GAAG,EACZ,SAAS,MAAM,EACf,UAAU;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,SAajE,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,OAAO,GAAG,EAAE,SAAS,GAAG,aAqCrD,CAAC"}

package/dist/utils/media/preprocess.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Client-side image preparation before upload.
+ *
+ * Steps (in order):
+ * 1. Convert AVIF → JPEG (Cloudflare Images 415s AVIFs despite spec).
+ * 2. Resize if wider than `maxWidth` (default 2680px) to sidestep CF's
+ *    dimension and size ceilings.
+ *
+ * Non-image files pass through unchanged.
+ *
+ * Throws a typed {@link MediaUploadError} with `code: "bad_mime"` when
+ * AVIF-→-JPEG conversion fails (browser can't decode AVIF, etc.) — callers
+ * surface the message; there's no useful retry path since manual conversion
+ * would run the same failed decoder. Resize failures are swallowed (we fall
+ * back to the original file) because CF will still accept it, just without
+ * our dimension hint.
+ */
+export declare function prepareImageForUpload(file: File, opts?: {
+    maxWidth?: number;
+}): Promise<File>;
+//# sourceMappingURL=preprocess.d.ts.map

package/dist/utils/media/preprocess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preprocess.d.ts","sourceRoot":"","sources":["../../../src/utils/media/preprocess.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,IAAI,EACV,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,OAAO,CAAC,IAAI,CAAC,CAsBf"}

package/dist/utils/media/registry.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Media upload handler registry.
+ *
+ * The SDK ships UI (Media Manager, image crop, standalone picker, etc.) that
+ * needs to upload image files somewhere, but it does NOT know where "somewhere"
+ * is — that's host-app business. Hosts register a handler on boot; the SDK
+ * calls it through `uploadImageToCdn`.
+ *
+ * Mirrors `registerClientDataFetcher` / `registerSubmissionHandler`.
+ */
+export type MediaUploadDestination = "cf-images" | "r2";
+export interface MediaUploadHandlerInput {
+    /** The file to upload. Already preprocessed (resize + AVIF→JPEG) by the SDK
+     *  for images. Non-image files pass through untouched. */
+    file: File;
+    /** Optional abort signal forwarded from the caller. */
+    signal?: AbortSignal;
+}
+export interface MediaUploadHandlerResult {
+    /** Identifier the host's CDN returned for the uploaded file. */
+    mediaId: string;
+    /** Which storage tier holds the file — drives delete routing and the
+     *  delivery URL shape on the SDK side. */
+    destination: MediaUploadDestination;
+    /** Public URL ready to drop into `<img>`, `<video>`, or `<a href>`.
+     *  Hosts can compute this however they like (CF variant URL, R2 public
+     *  bucket, signed URL, custom domain); the SDK just passes it through. */
+    deliveryURL: string;
+}
+/**
+ * Host-supplied implementation. Throws on failure — ideally a
+ * {@link MediaUploadError} from `./errors` so the SDK UI can read a typed
+ * `code` and message.
+ */
+export type MediaUploadHandler = (input: MediaUploadHandlerInput) => Promise<MediaUploadHandlerResult>;
+export declare function registerMediaUploadHandler(fn: MediaUploadHandler | null): void;
+export declare function getMediaUploadHandler(): MediaUploadHandler | null;
+/**
+ * Default `<input accept>` value when no host has registered an accept
+ * provider — the SDK's known-good image MIME list (matches what Cloudflare
+ * Images accepts via direct_upload).
+ */
+export declare const DEFAULT_IMAGE_ACCEPT = "image/png,image/jpeg,image/jpg,image/gif,image/webp,image/avif,image/svg+xml";
+/**
+ * Returns the comma-separated MIME / extension list to pass to a file
+ * `<input accept>` for *new* uploads. The SDK has no concept of "plan tiers"
+ * or "allowed media types" — that policy lives in the host app. Hosts that
+ * support more than images register a provider; otherwise the SDK falls back
+ * to {@link DEFAULT_IMAGE_ACCEPT}.
+ */
+export type MediaAcceptProvider = () => string;
+export declare function registerMediaUploadAccept(fn: MediaAcceptProvider | null): void;
+export declare function getUploadAccept(): string;
+//# sourceMappingURL=registry.d.ts.map

package/dist/utils/media/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/utils/media/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG,IAAI,CAAC;AAExD,MAAM,WAAW,uBAAuB;IACtC;8DAC0D;IAC1D,IAAI,EAAE,IAAI,CAAC;IACX,uDAAuD;IACvD,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB;8CAC0C;IAC1C,WAAW,EAAE,sBAAsB,CAAC;IACpC;;8EAE0E;IAC1E,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,KAAK,EAAE,uBAAuB,KAC3B,OAAO,CAAC,wBAAwB,CAAC,CAAC;AAIvC,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,kBAAkB,GAAG,IAAI,GAAG,IAAI,CAE9E;AAED,wBAAgB,qBAAqB,IAAI,kBAAkB,GAAG,IAAI,CAEjE;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,iFAC+C,CAAC;AAEjF;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,MAAM,CAAC;AAI/C,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,mBAAmB,GAAG,IAAI,GAAG,IAAI,CAE9E;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC"}

package/dist/utils/media/transform.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Pure browser-only image transforms shared between SDK preprocess and any
+ * other surface that needs to reshape a File before upload.
+ *
+ * Lives at the `utils/media/` layer so nothing here reaches into `chrome/`.
+ */
+/** Convert AVIF file to JPEG (some CDNs, incl. Cloudflare Images, 415 AVIFs). */
+export declare function convertAvifToJpeg(file: File): Promise<File>;
+/** Resize image client-side if wider than maxWidth, preserving aspect ratio. */
+export declare function resizeImageIfNeeded(file: File, maxWidth?: number): Promise<File>;
+//# sourceMappingURL=transform.d.ts.map

package/dist/utils/media/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/utils/media/transform.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAgC3D;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,GAAE,MAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAyCtF"}

package/dist/utils/media/upload.d.ts

@@ -0,0 +1,41 @@
+import { MediaUploadDestination } from './registry';
+export { MediaUploadError } from './errors';
+export type { MediaUploadErrorCode } from './errors';
+export { parseApiMediaGetError, parseCloudflareError } from './errors';
+export { prepareImageForUpload } from './preprocess';
+export { registerMediaUploadHandler, getMediaUploadHandler, registerMediaUploadAccept, getUploadAccept, DEFAULT_IMAGE_ACCEPT, type MediaUploadHandler, type MediaUploadHandlerInput, type MediaUploadHandlerResult, type MediaUploadDestination, type MediaAcceptProvider, } from './registry';
+export interface UploadImageResult {
+    mediaId: string;
+    /** Which storage tier got the file — drives render/delete branching. */
+    destination: MediaUploadDestination;
+    /** Ready-to-use public URL of the stored asset. */
+    deliveryURL: string;
+    /** Post-preprocessing file that was actually sent to the host CDN. */
+    file: File;
+    width?: number;
+    height?: number;
+}
+export interface UploadImageOptions {
+    /** Skip `prepareImageForUpload`. Use when the caller already shaped the file
+     *  (e.g. the image cropper outputs exact dimensions). */
+    skipPreprocess?: boolean;
+    /** Abort mid-flight via AbortController. */
+    signal?: AbortSignal;
+    /** Extract and return image dimensions. Default true for images. */
+    includeDimensions?: boolean;
+}
+/**
+ * Shared upload entry point used by every SDK editor surface that needs to
+ * put an image on the host's CDN: Media Manager, image crop, AI generation,
+ * standalone picker, and the host's own chat assistant.
+ *
+ * Pipeline:
+ *   1. `prepareImageForUpload` (AVIF→JPEG + resize) — skippable per-call.
+ *   2. Delegate network work to the registered {@link MediaUploadHandler}.
+ *   3. Best-effort dimension extraction.
+ *
+ * Throws {@link MediaUploadError} on every failure; callers surface
+ * `err.message` to the user.
+ */
+export declare function uploadImageToCdn(file: File, opts?: UploadImageOptions): Promise<UploadImageResult>;
+//# sourceMappingURL=upload.d.ts.map

package/dist/utils/media/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../src/utils/media/upload.ts"],"names":[],"mappings":"AAGA,OAAO,EAAyB,KAAK,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEhF,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,YAAY,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,yBAAyB,EACzB,eAAe,EACf,oBAAoB,EACpB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,WAAW,EAAE,sBAAsB,CAAC;IACpC,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC;6DACyD;IACzD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,IAAI,EACV,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,iBAAiB,CAAC,CAgC5B"}

package/dist/utils/modifierUtils.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Modifier expansion utilities.
+ *
+ * Modifiers are named class presets stored on ROOT.props.modifiers.
+ * Nodes reference them by name in className (e.g. "icon-button").
+ * This module expands those names into real Tailwind/DaisyUI class tokens
+ * so every rendering path sees actual classes — no @utility @apply needed.
+ */
+interface ModifierDef {
+    name: string;
+    classes?: string;
+    requires?: string;
+}
+/**
+ * Built-in component definitions ship default modifiers via the catalog
+ * registry (see `catalogRegistry.ts`). Callers (sanitizeNodeMap, compile-css)
+ * supply the resolved def list and we look up modifiers by `def.name`.
+ */
+interface BuiltinDefWithModifiers {
+    name: string;
+}
+/**
+ * Build a { modifierName → "class1 class2 ..." } lookup from ROOT.props.modifiers.
+ * Includes `requires` classes prepended (e.g. "btn" base for "btn-primary" variant).
+ *
+ * If `builtinDefs` is supplied, def-shipped modifiers are added FIRST so any
+ * site-level modifier with the same name OVERRIDES the built-in. This lets
+ * components ship default named patterns (e.g. `accordion-slide-fade` on
+ * Container) that the runtime expander actually consumes.
+ */
+export declare function buildModifierExpansionMap(modifiers: Record<string, ModifierDef[]>, builtinDefs?: BuiltinDefWithModifiers[]): Map<string, string>;
+/**
+ * Replace modifier names in a className string with their expanded classes.
+ * Non-modifier tokens pass through unchanged. Deduplicates the result.
+ */
+export declare function expandModifierClassName(className: string, expansionMap: Map<string, string>): string;
+/**
+ * Walk a CraftJS node map and expand modifier names in every node's className.
+ * Also populates `root.activeModifiers` and `root.modifierClasses` metadata
+ * so the editor knows which modifiers are active and can update them centrally.
+ *
+ * Mutates and returns the same object (no deep clone — caller owns the data).
+ */
+export declare function expandModifiersInNodes(nodes: Record<string, any>, builtinDefs?: BuiltinDefWithModifiers[]): Record<string, any>;
+/** Craft `custom` key: library insert carries block `modifiers` until merged into ROOT (one undo step). */
+export declare const PH_PENDING_BLOCK_MODIFIERS_KEY = "phPendingBlockModifiers";
+/**
+ * Merge library/block `modifiers` into root props (same semantics as mcp-core `mergeBlockModifiersIntoRoot`).
+ *
+ * **Contract mirror:** Keep in lockstep with `packages/mcp-core/src/helpers/modifiers.js`.
+ * If upsert rules change, update both — no shared package by design.
+ *
+ * Mutates `rootProps` (initializes `modifiers` if missing).
+ */
+export declare function mergeBlockModifiersIntoRootProps(rootProps: Record<string, any>, blockModifiers: Record<string, ModifierDef[]> | null | undefined): void;
+/**
+ * Deep-clone `structure` and expand every `props.className` using a **pre-built** expansion map.
+ * Does not mutate `structure`. Prefer this when the caller already ran `buildModifierExpansionMap`.
+ */
+export declare function expandStructureWithModifierMap(structure: any, expansionMap: Map<string, string>): any;
+/**
+ * Deep-clone `structure` and expand modifier shortcut tokens in every `props.className`
+ * using `blockModifiers` (library block shape). For previews only — does not mutate input.
+ */
+export declare function expandStructureWithModifiers(structure: any, blockModifiers: Record<string, ModifierDef[]> | null | undefined): any;
+export {};
+//# sourceMappingURL=modifierUtils.d.ts.map

package/dist/utils/modifierUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modifierUtils.d.ts","sourceRoot":"","sources":["../../src/utils/modifierUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,UAAU,uBAAuB;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd;AAkBD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,EACxC,WAAW,CAAC,EAAE,uBAAuB,EAAE,GACtC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAcrB;AAID;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,MAAM,CAoBR;AAID;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1B,WAAW,CAAC,EAAE,uBAAuB,EAAE,GACtC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CA0CrB;AAED,2GAA2G;AAC3G,eAAO,MAAM,8BAA8B,4BAA4B,CAAC;AAExE;;;;;;;GAOG;AACH,wBAAgB,gCAAgC,CAC9C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC9B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAC/D,IAAI,CAeN;AA0BD;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,GAAG,EACd,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,GAAG,CAKL;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,GAAG,EACd,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAC/D,GAAG,CAUL"}

package/dist/utils/motion.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Wraps a tag/component with `motion.create()` when the node has a
+ * non-CSS animation preset. CSS-only presets pass through unchanged.
+ *
+ * framer-motion is lazy-loaded — only fetched when a non-CSS animation
+ * actually mounts, keeping ~120KB off viewer route chunks.
+ */
+export declare const motionIt: (props: any, tagOrComponent: any, enabled?: boolean) => any;
+//# sourceMappingURL=motion.d.ts.map

package/dist/utils/motion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion.d.ts","sourceRoot":"","sources":["../../src/utils/motion.ts"],"names":[],"mappings":"AAsCA;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,GAAG,EAAE,gBAAgB,GAAG,EAAE,iBAAe,QAKxE,CAAC"}

package/dist/utils/nativeVideo.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Helpers for HTML5 <video> vs iframe embeds (Video component).
+ */
+/** Treat as direct file when path (before query) ends with a known video extension. */
+export declare function isDirectVideoFileUrl(raw: string | undefined | null): boolean;
+type SerializedNodes = Record<string, {
+    props?: Record<string, unknown>;
+} | undefined>;
+/**
+ * Resolve public video URL for R2 uploads from ROOT.pageMedia (serialized Craft tree).
+ * Matches editor behavior of getMediaContent for type "r2".
+ */
+export declare function resolveR2VideoSrcFromSerializedTree(nodes: SerializedNodes | undefined, mediaId: string | undefined | null): string | null;
+/**
+ * Boolean + preload attributes for static <video> and React (spread onto <video>).
+ */
+export declare function nativeVideoPlaybackFields(props: Record<string, unknown> | undefined): {
+    autoPlay?: boolean;
+    muted?: boolean;
+    loop?: boolean;
+    playsInline?: boolean;
+    controls?: boolean;
+    preload?: string;
+};
+export {};
+//# sourceMappingURL=nativeVideo.d.ts.map

package/dist/utils/nativeVideo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeVideo.d.ts","sourceRoot":"","sources":["../../src/utils/nativeVideo.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,uFAAuF;AACvF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAU5E;AAED,KAAK,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,SAAS,CAAC,CAAC;AAEvF;;;GAGG;AACH,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,eAAe,GAAG,SAAS,EAClC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GACjC,MAAM,GAAG,IAAI,CAUf;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG;IACrF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CASA"}

package/dist/utils/normalizeDesignTags.d.ts

@@ -0,0 +1,3 @@
+/** Dedupe, trim, cap count — same rules as app `utils/designIntent.ts`. */
+export declare function normalizeDesignTags(tags: string[]): string[];
+//# sourceMappingURL=normalizeDesignTags.d.ts.map

package/dist/utils/normalizeDesignTags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeDesignTags.d.ts","sourceRoot":"","sources":["../../src/utils/normalizeDesignTags.ts"],"names":[],"mappings":"AAGA,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAW5D"}

package/dist/utils/page/pageManagement.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Page management utilities — isolation, counting, ref resolution, variables
+ */
+/** Persisted when the editor canvas shows every page (not isolated to one). */
+export declare const EDITOR_ALL_PAGES_STORAGE = "__all_pages__";
+/** Returns true when the isolate value points to an actual page (not "show all"). */
+export declare function hasPageIsolation(value: string | null | undefined): value is string;
+export declare function listPageNodeIds(query: any): string[];
+/** Home page id, or first page node under ROOT when none is marked home. */
+export declare function getDefaultEditorPageId(query: any): string | null;
+/**
+ * Show only one page in the CraftJS tree by hiding all other page nodes.
+ * Pass `pageId = null` to show all pages (un-isolate).
+ *
+ * This is the in-tree isolation path (all pages loaded in memory).
+ * For per-page sharding (fetch + deserialize), use `isolatePageLazy`.
+ */
+export declare function isolatePageInTree(query: any, actions: any, pageId: string | null, setIsolate: (v: string) => void): void;
+export declare function getLoadedPages(): ReadonlySet<string>;
+export declare function markPageLoaded(pageNodeId: string): void;
+export declare function clearLoadedPages(): void;
+/**
+ * Switch to a page. If the page is not in the CraftJS tree, fetches it
+ * via `fetchPage` and replaces the tree (shared + new page only).
+ * Old page nodes are evicted — only one page lives in the DOM/tree at a time.
+ *
+ * Returns true if a fetch was needed (caller can show/hide loading state).
+ */
+export declare function isolatePageLazy(active: string | null, query: any, actions: any, setIsolate: (v: string) => void, fetchPage?: (pageNodeId: string) => Promise<{
+    content: string;
+} | null>): Promise<boolean>;
+/**
+ * Page index entry — produced either from the live Craft tree (editor) or
+ * from `rootProps._pageIndex` injected by SSR for sharded single-page loads.
+ */
+export interface PageIndexEntry {
+    isHomePage?: boolean;
+    displayName: string;
+}
+export type PageIndex = Record<string, PageIndexEntry>;
+/**
+ * One-stop extractor for editor call sites — reads ROOT_NODE.data.props once
+ * and pre-builds the page index. Replaces the query.node(ROOT_NODE) reads
+ * scattered throughout components. Returns empty/null for missing root.
+ *
+ * Walker callers do NOT use this — they have rootProps + pageIndex directly.
+ */
+export interface ExtractedRootData {
+    rootProps: Record<string, any>;
+    pageMedia: any[] | null;
+    pageIndex: PageIndex;
+}
+export declare function extractRootDataFromQuery(query: any): ExtractedRootData;
+/**
+ * Build a PageIndex from a Craft query — editor call sites use this once
+ * per render to feed `resolvePageRef`. Walker callers read
+ * `rootProps._pageIndex` directly (already in PageIndex shape).
+ */
+export declare function buildPageIndexFromQuery(query: any): PageIndex;
+export declare const resolvePageRef: (url: string, pageIndex: PageIndex | null | undefined, currentPath?: string) => string;
+export { replaceVariables } from '../design/variables';
+//# sourceMappingURL=pageManagement.d.ts.map

package/dist/utils/page/pageManagement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pageManagement.d.ts","sourceRoot":"","sources":["../../../src/utils/page/pageManagement.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,+EAA+E;AAC/E,eAAO,MAAM,wBAAwB,kBAAkB,CAAC;AAExD,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,IAAI,MAAM,CAElF;AAID,wBAAgB,eAAe,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,EAAE,CAOpD;AAED,4EAA4E;AAC5E,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,CAchE;AAID;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,GAAG,EACV,OAAO,EAAE,GAAG,EACZ,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,QAoChC;AAOD,wBAAgB,cAAc,IAAI,WAAW,CAAC,MAAM,CAAC,CAEpD;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAEvD;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,KAAK,EAAE,GAAG,EACV,OAAO,EAAE,GAAG,EACZ,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,EAC/B,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,GACtE,OAAO,CAAC,OAAO,CAAC,CA+BlB;AAID;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,SAAS,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,GAAG,GAAG,iBAAiB,CActE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,GAAG,GAAG,SAAS,CAyB7D;AAED,eAAO,MAAM,cAAc,GACzB,KAAK,MAAM,EACX,WAAW,SAAS,GAAG,IAAI,GAAG,SAAS,EACvC,cAAc,MAAM,KACnB,MAqCF,CAAC;AAKF,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/utils/page/pageNavigation.d.ts

@@ -0,0 +1,76 @@
+/**
+ * @pagehub/sdk — Page Navigation Store
+ *
+ * Module-scoped external store (same pattern as usePanelUrl.ts) that is the
+ * single source of truth for which page is active in the editor.
+ *
+ * The host app provides a `urlStrategy` via config so the SDK stays
+ * host-agnostic (no Next.js, no /build/ prefix knowledge).
+ */
+export interface UrlStrategy {
+    /** Build a URL path for a given page. */
+    buildPageUrl: (ctx: {
+        siteId: string;
+        pageSlug: string;
+        isHomePage: boolean;
+    }) => string;
+    /** Build a URL path for the site root (home page). */
+    buildSiteUrl: (ctx: {
+        siteId: string;
+    }) => string;
+    /** Parse the current URL to extract a page slug. null = no page slug in URL. */
+    parsePageSlug: () => string | null;
+    /** Parse the current URL to extract the site ID. null = not yet saved. */
+    parseSiteId: () => string | null;
+}
+export interface PageNavState {
+    /** Currently active page node ID (null = nothing isolated). */
+    activePageId: string | null;
+    /** Site ID from the host (null = unsaved / fresh build). */
+    siteId: string | null;
+}
+interface PageNavInit {
+    urlStrategy: UrlStrategy | null;
+    /** Resolve a URL slug to a CraftJS page node ID. Used on popstate (back/forward). */
+    resolvePageIdFromSlug: (slug: string) => string | null;
+    /** Get the home page node ID. */
+    getHomePageId: () => string | null;
+    /** Called when the store wants to isolate a page in CraftJS. May be async for lazy loading. */
+    onIsolate: (pageId: string | null) => void | Promise<void>;
+}
+/**
+ * Initialize the page navigation store. Called once from ViewportShell on mount.
+ * Returns the initial page ID that should be isolated.
+ */
+export declare function initPageNavigation(opts: PageNavInit): string | null;
+/**
+ * Update the onIsolate callback. Called when the closure needs refreshing
+ * (e.g., when config.callbacks changes).
+ */
+export declare function updateOnIsolate(fn: PageNavInit["onIsolate"]): void;
+/**
+ * Navigate to a page. Updates state, pushes URL, and isolates.
+ */
+export declare function navigateToPage(pageId: string, displayName: string, isHomePage: boolean, customSlug?: string): void;
+/**
+ * Called when the host app's first save returns a site ID.
+ * Uses replaceState (not pushState) so back doesn't go to /build with no slug.
+ */
+export declare function setSiteId(id: string): void;
+/** Get the current site ID without subscribing to React updates. */
+export declare function getSiteId(): string | null;
+/** Get the current active page ID without subscribing. */
+export declare function getActivePageId(): string | null;
+/**
+ * Set active page ID directly (used for localStorage restore
+ * and initial isolation without URL changes).
+ */
+export declare function setActivePageId(pageId: string | null): void;
+export declare function usePageNavigation(): {
+    activePageId: string;
+    siteId: string;
+    navigateToPage: typeof navigateToPage;
+    setSiteId: typeof setSiteId;
+};
+export {};
+//# sourceMappingURL=pageNavigation.d.ts.map

package/dist/utils/page/pageNavigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pageNavigation.d.ts","sourceRoot":"","sources":["../../../src/utils/page/pageNavigation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,YAAY,EAAE,CAAC,GAAG,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,KAAK,MAAM,CAAC;IACzF,sDAAsD;IACtD,YAAY,EAAE,CAAC,GAAG,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC;IAClD,gFAAgF;IAChF,aAAa,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACnC,0EAA0E;IAC1E,WAAW,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,+DAA+D;IAC/D,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,4DAA4D;IAC5D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,UAAU,WAAW;IACnB,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,qFAAqF;IACrF,qBAAqB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IACvD,iCAAiC;IACjC,aAAa,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACnC,+FAA+F;IAC/F,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAsFD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAwBnE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,WAAW,CAAC,WAAW,CAAC,GAAG,IAAI,CAElE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,OAAO,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI,CAkBN;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAgB1C;AAED,oEAAoE;AACpE,wBAAgB,SAAS,IAAI,MAAM,GAAG,IAAI,CAEzC;AAED,0DAA0D;AAC1D,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAE/C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAG3D;AAID,wBAAgB,iBAAiB;;;;;EAQhC"}

package/dist/utils/parseHeadHTML.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Parse a raw HTML string into a list of head-legal React-emittable tags.
+ * Used by Embed.headCode/footCode and Background.props.inject.{head,footer} to
+ * hoist scripts/styles/etc. into the document head via next/head during SSR.
+ */
+export interface HeadTag {
+    tag: "script" | "style" | "meta" | "link" | "title";
+    attrs: Record<string, string>;
+    inner: string;
+}
+export declare function parseHeadHTML(html: string | undefined | null): HeadTag[];
+/** djb2 content hash — stable across SSR + client for next/head key dedup. */
+export declare function hashTag(t: HeadTag): string;
+//# sourceMappingURL=parseHeadHTML.d.ts.map

package/dist/utils/parseHeadHTML.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseHeadHTML.d.ts","sourceRoot":"","sources":["../../src/utils/parseHeadHTML.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACpD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;CACf;AAID,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,EAAE,CA8BxE;AAED,8EAA8E;AAC9E,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAK1C"}

package/dist/utils/pathPatternParams.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Per-page path patterns (`pathPattern` on the page Container) + tail segment matching.
+ * Shared by server connector fetch and client Container binding resolution.
+ */
+export type PrepareViewerRoute = "subdomain" | "view" | "static";
+/**
+ * Path segments after the page slug — aligned across subdomain / view / static.
+ *
+ * - **subdomain** (`pages/[[...slug]].tsx`): `['pageSlug', 'products', 'handle']` → `['products','handle']`
+ * - **view** (`pages/view/[[...slug]].tsx`): `query.slug` = `[templateSlug, pageSlug, ...tail]`
+ * - **static** (`pages/static/[[...slug]].tsx`): `[domain, pageSlug, ...tail]` → tail after domain+page
+ */
+export declare function getPathTailSegments(route: PrepareViewerRoute, options: {
+    query?: Record<string, string | string[] | undefined> | null;
+    catchAllSlug?: string[] | null;
+}): string[];
+/**
+ * Match URL path tail segments against a pattern like `products/:handle` or `:handle`.
+ * Literal segments must match exactly; `:name` captures one segment.
+ */
+export declare function matchPathPattern(pattern: string | null | undefined, segments: string[]): Record<string, string> | null;
+/** First page node with a non-empty `pathPattern` in assembled Craft JSON. */
+export declare function findPagePathPattern(nodes: Record<string, any> | null | undefined): string | null;
+export declare function resolveRouteParamsForPathPattern(pathPattern: string | null, pathTailSegments: string[] | undefined): Record<string, string>;
+//# sourceMappingURL=pathPatternParams.d.ts.map

package/dist/utils/pathPatternParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathPatternParams.d.ts","sourceRoot":"","sources":["../../src/utils/pathPatternParams.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC;AAOjE;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC;IAC7D,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CAChC,GACA,MAAM,EAAE,CAWV;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAClC,QAAQ,EAAE,MAAM,EAAE,GACjB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAsB/B;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAUhG;AAED,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,gBAAgB,EAAE,MAAM,EAAE,GAAG,SAAS,GACrC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASxB"}

package/dist/utils/phStorage.d.ts

@@ -0,0 +1,10 @@
+export declare const phStorage: {
+    /** Raw string read — drop-in for localStorage.getItem */
+    get(key: string): string | null;
+    /** Parsed JSON read with fallback */
+    getJSON<T>(key: string, fallback?: T | null): T | null;
+    /** Write — strings stored as-is, everything else JSON-stringified */
+    set(key: string, value: unknown): void;
+    remove(key: string): void;
+};
+//# sourceMappingURL=phStorage.d.ts.map

package/dist/utils/phStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phStorage.d.ts","sourceRoot":"","sources":["../../src/utils/phStorage.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,SAAS;IACpB,yDAAyD;aAChD,MAAM,GAAG,MAAM,GAAG,IAAI;IAQ/B,qCAAqC;YAC7B,CAAC,OAAO,MAAM,aAAY,CAAC,GAAG,IAAI,GAAU,CAAC,GAAG,IAAI;IAS5D,qEAAqE;aAC5D,MAAM,SAAS,OAAO,GAAG,IAAI;gBAM1B,MAAM,GAAG,IAAI;CAK1B,CAAC"}

package/dist/utils/relation.d.ts

@@ -0,0 +1,14 @@
+import { RelationProps } from '../components/types';
+export declare function getRelation(props: any): RelationProps | undefined;
+export declare function getBelongsTo(props: any): string | undefined;
+export declare function getHasMany(props: any): string[];
+export declare function getRelationType(props: any): string | undefined;
+/** Mutate a CraftJS setProp callback argument to set a relation field. */
+export declare function setRelationField<K extends keyof RelationProps>(props: any, key: K, value: RelationProps[K]): void;
+/** Mutate a setProp callback argument to clear the entire relation object. */
+export declare function clearRelation(props: any): void;
+/** Push a child id onto the master's hasMany[]. Creates relation/hasMany if missing. */
+export declare function addHasMany(props: any, childId: string): void;
+/** Remove a child id from the master's hasMany[]. */
+export declare function removeHasMany(props: any, childId: string): void;
+//# sourceMappingURL=relation.d.ts.map

package/dist/utils/relation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation.d.ts","sourceRoot":"","sources":["../../src/utils/relation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,wBAAgB,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,aAAa,GAAG,SAAS,CAEjE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,GAAG,SAAS,CAE3D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,EAAE,CAE/C;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,GAAG,SAAS,CAE9D;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,aAAa,EAC5D,KAAK,EAAE,GAAG,EACV,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GACtB,IAAI,CAGN;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI,CAE9C;AAED,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAI5D;AAED,qDAAqD;AACrD,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAI/D"}