@picked/client 0.0.1-dev.1788925875333 → 0.0.1-next.1

package/dist/types/schema-registry.d.ts

@@ -1,206 +0,0 @@
-/** @file Schema registry types augmented by generated `picked-env.d.ts`. */
-import type { Content } from './entities/content/content';
-import type { FieldValue as ResponseFieldValue } from './entities/field/field';
-/**
- * Augmented by generated `picked-env.d.ts`. Empty by default.
- *
- * @example
- * // After codegen:
- * // interface PickedSchemaRegistry {
- * //   contentModels: { 'welcome-page': WelcomePageContent }
- * // }
- */
-export interface PickedSchemaRegistry {
-}
-type ContentModelsMap = PickedSchemaRegistry extends {
-    contentModels: infer M extends Record<string, unknown>;
-} ? M : Record<string, Record<string, unknown>>;
-type StepContentModelsMap = PickedSchemaRegistry extends {
-    stepContentModels: infer S extends Record<string, string>;
-} ? S : Record<string, string>;
-type StepFieldKeysMap = PickedSchemaRegistry extends {
-    stepFieldKeys: infer S extends Record<string, string>;
-} ? S : Record<string, string>;
-type FieldValuesMap = PickedSchemaRegistry extends {
-    fieldValues: infer F extends Record<string, unknown>;
-} ? F : never;
-type FeatureValuesMap = PickedSchemaRegistry extends {
-    featureValues: infer F extends Record<string, boolean | string>;
-} ? F : never;
-/**
- * Widens a key union so it still accepts a key the workspace does not declare.
- *
- * Features, actions, fields, steps and experiences can all be defined in the application
- * rather than the workspace — `createClient({ features })` and `client.registerField()`
- * among them — and those keys are absent from the generated schema. Intersecting with an
- * object type keeps TypeScript from collapsing `K | string` down to `string`, so an editor
- * still suggests the workspace's keys while any other string is accepted.
- *
- * The `Known*` union beside each key type stays closed, for a caller that wants only what
- * the workspace declares.
- */
-type AnyString = string & Record<never, never>;
-/**
- * Feature keys the workspace declares. Closed: a locally-defined feature is not in it.
- *
- * @example
- * type Keys = KnownFeatureKeys
- */
-export type KnownFeatureKeys = PickedSchemaRegistry extends {
-    featureKeys: infer K extends string;
-} ? K : string;
-/**
- * Value a feature key can resolve to.
- *
- * A text feature declares its arms in the schema, so its key narrows to that union. Every
- * other key — a boolean feature, a feature registered in application code, a
- * `?picked-feature=` override — reads as the general `boolean | string`, which is the
- * documented contract for a key the workspace does not declare.
- *
- * @param {PropertyKey} K - Feature key from the workspace schema.
- * @example
- * type Hero = FeatureValueFor<'hero'>
- */
-export type FeatureValueFor<K extends PropertyKey> = FeatureValuesMap extends never ? boolean | string : K extends keyof FeatureValuesMap ? FeatureValuesMap[K] : boolean | string;
-/**
- * Feature keys — the workspace union when augmented, plus any locally-defined key.
- *
- * @example
- * type Keys = FeatureKeys
- */
-export type FeatureKeys = PickedSchemaRegistry extends {
-    featureKeys: infer K extends string;
-} ? K | AnyString : string;
-/**
- * Step keys the workspace declares. Closed: a locally-registered step is not in it.
- *
- * @example
- * type Keys = KnownStepKeys
- */
-export type KnownStepKeys = PickedSchemaRegistry extends {
-    stepKeys: infer K extends string;
-} ? K : string;
-/**
- * Step keys — the workspace union when augmented, plus any locally-registered key.
- *
- * @example
- * type Keys = StepKeys
- */
-export type StepKeys = PickedSchemaRegistry extends {
-    stepKeys: infer K extends string;
-} ? K | AnyString : string;
-/**
- * Action keys the workspace declares. Closed: an action the app registers on its own is
- * not in it.
- *
- * @example
- * type Keys = KnownActionKeys
- */
-export type KnownActionKeys = PickedSchemaRegistry extends {
-    actionKeys: infer K extends string;
-} ? K : string;
-/**
- * Action keys — the workspace union when augmented, plus any key the app registers.
- *
- * @example
- * type Keys = ActionKeys
- */
-export type ActionKeys = PickedSchemaRegistry extends {
-    actionKeys: infer K extends string;
-} ? K | AnyString : string;
-/**
- * Experience keys the workspace declares. Closed: a locally-registered experience is not
- * in it.
- *
- * @example
- * type Keys = KnownExperienceKeys
- */
-export type KnownExperienceKeys = PickedSchemaRegistry extends {
-    experienceKeys: infer K extends string;
-} ? K : string;
-/**
- * Experience keys — the workspace union when augmented, plus any locally-registered key.
- *
- * @example
- * type Keys = ExperienceKeys
- */
-export type ExperienceKeys = PickedSchemaRegistry extends {
-    experienceKeys: infer K extends string;
-} ? K | AnyString : string;
-/**
- * Field keys the workspace declares. Closed: a locally-registered field is not in it.
- *
- * @example
- * type Keys = KnownFieldKeys
- */
-export type KnownFieldKeys = FieldValuesMap extends never ? string : keyof FieldValuesMap & string;
-/**
- * Field keys — the workspace union when augmented, plus any locally-registered key.
- *
- * A key outside the workspace reads as the general {@link FieldValueFor} value type, which
- * is how every value resolver here already treats one.
- *
- * @example
- * type Keys = FieldKeys
- */
-export type FieldKeys = FieldValuesMap extends never ? string : KnownFieldKeys | AnyString;
-/**
- * Union of every content model bound to a step layout.
- *
- * @example
- * type Union = StepLayoutContent
- */
-export type StepLayoutContent = ContentModelsMap[StepContentModelsMap[keyof StepContentModelsMap] & keyof ContentModelsMap];
-/**
- * Content type for a specific step key, via the step -> model map.
- *
- * @param {PropertyKey} K - Step key from the workspace schema.
- * @example
- * type Main = ContentForStep<'main'>
- */
-export type ContentForStep<K extends PropertyKey> = K extends keyof StepContentModelsMap ? ContentModelsMap[StepContentModelsMap[K] & keyof ContentModelsMap] : StepLayoutContent;
-/**
- * Field keys bound to a specific step key, via the step → field-keys map.
- * Falls back to all workspace {@link FieldKeys} when the registry has no
- * `stepFieldKeys` entry for `K` (old snapshots / unaugmented clients).
- *
- * @param {PropertyKey} K - Step key from the workspace schema.
- * @example
- * type MainFields = FieldKeysForStep<'main'>
- */
-export type FieldKeysForStep<K extends PropertyKey> = K extends keyof StepFieldKeysMap ? StepFieldKeysMap[K] & KnownFieldKeys : FieldKeys;
-/**
- * Value type for a field key (always optional at read time).
- *
- * @param {PropertyKey} K - Field key from the workspace schema.
- * @example
- * type Email = FieldValueFor<'email'>
- */
-export type FieldValueFor<K extends PropertyKey> = FieldValuesMap extends never ? ResponseFieldValue : K extends keyof FieldValuesMap ? FieldValuesMap[K] | null : ResponseFieldValue;
-/**
- * A `Content` record whose `data` is narrowed to `TData`.
- *
- * @param {unknown} TData - Explicit content model shape.
- * @example
- * type Typed = TypedContent<WelcomePageContent>
- */
-export type TypedContent<TData> = Omit<Content, 'data'> & {
-    data: TData;
-};
-/**
- * The Content record a `reference` field value points at.
- *
- * A generated pointer carries the target's shape on its optional `data` member, so the
- * referenced record narrows to that shape. A value the generator knows nothing about —
- * an unaugmented client, or a field that accepts any Content Model — falls back to the
- * untyped {@link Content}. A repeatable field resolves through its element type.
- *
- * @param {unknown} TValue - The raw `reference` field value read from a content blob.
- * @example
- * type Author = ReferencedContent<WelcomePageContent['author']>
- */
-export type ReferencedContent<TValue> = NonNullable<TValue> extends readonly (infer TElement)[] ? ReferencedContent<TElement> : NonNullable<TValue> extends {
-    data?: infer TData;
-} ? [NonNullable<TData>] extends [never] ? Content : TypedContent<NonNullable<TData>> : Content;
-export type { StepContentModelsMap };
-//# sourceMappingURL=schema-registry.d.ts.map

package/dist/types/schema-registry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema-registry.d.ts","sourceRoot":"","sources":["../../src/schema-registry.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AACzD,OAAO,KAAK,EAAE,UAAU,IAAI,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAE9E;;;;;;;;GAQG;AAEH,MAAM,WAAW,oBAAoB;CAAG;AAGxC,KAAK,gBAAgB,GAAG,oBAAoB,SAAS;IACnD,aAAa,EAAE,MAAM,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACvD,GACG,CAAC,GACD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAE3C,KAAK,oBAAoB,GAAG,oBAAoB,SAAS;IACvD,iBAAiB,EAAE,MAAM,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC1D,GACG,CAAC,GACD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAE1B,KAAK,gBAAgB,GAAG,oBAAoB,SAAS;IACnD,aAAa,EAAE,MAAM,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACtD,GACG,CAAC,GACD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAE1B,KAAK,cAAc,GAAG,oBAAoB,SAAS;IACjD,WAAW,EAAE,MAAM,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrD,GACG,CAAC,GACD,KAAK,CAAA;AAET,KAAK,gBAAgB,GAAG,oBAAoB,SAAS;IACnD,aAAa,EAAE,MAAM,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,CAAA;CAChE,GACG,CAAC,GACD,KAAK,CAAA;AAET;;;;;;;;;;;GAWG;AACH,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;AAE9C;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,SAAS;IAC1D,WAAW,EAAE,MAAM,CAAC,SAAS,MAAM,CAAA;CACpC,GACG,CAAC,GACD,MAAM,CAAA;AAEV;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,WAAW,IAAI,gBAAgB,SAAS,KAAK,GAC/E,OAAO,GAAG,MAAM,GAChB,CAAC,SAAS,MAAM,gBAAgB,GAC9B,gBAAgB,CAAC,CAAC,CAAC,GACnB,OAAO,GAAG,MAAM,CAAA;AAEtB;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,oBAAoB,SAAS;IAAE,WAAW,EAAE,MAAM,CAAC,SAAS,MAAM,CAAA;CAAE,GAC1F,CAAC,GAAG,SAAS,GACb,MAAM,CAAA;AAEV;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,oBAAoB,SAAS;IAAE,QAAQ,EAAE,MAAM,CAAC,SAAS,MAAM,CAAA;CAAE,GACzF,CAAC,GACD,MAAM,CAAA;AAEV;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,oBAAoB,SAAS;IAAE,QAAQ,EAAE,MAAM,CAAC,SAAS,MAAM,CAAA;CAAE,GACpF,CAAC,GAAG,SAAS,GACb,MAAM,CAAA;AAEV;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,oBAAoB,SAAS;IACzD,UAAU,EAAE,MAAM,CAAC,SAAS,MAAM,CAAA;CACnC,GACG,CAAC,GACD,MAAM,CAAA;AAEV;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,oBAAoB,SAAS;IAAE,UAAU,EAAE,MAAM,CAAC,SAAS,MAAM,CAAA;CAAE,GACxF,CAAC,GAAG,SAAS,GACb,MAAM,CAAA;AAEV;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,SAAS;IAC7D,cAAc,EAAE,MAAM,CAAC,SAAS,MAAM,CAAA;CACvC,GACG,CAAC,GACD,MAAM,CAAA;AAEV;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,oBAAoB,SAAS;IACxD,cAAc,EAAE,MAAM,CAAC,SAAS,MAAM,CAAA;CACvC,GACG,CAAC,GAAG,SAAS,GACb,MAAM,CAAA;AAEV;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,cAAc,SAAS,KAAK,GAAG,MAAM,GAAG,MAAM,cAAc,GAAG,MAAM,CAAA;AAElG;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,GAAG,cAAc,SAAS,KAAK,GAAG,MAAM,GAAG,cAAc,GAAG,SAAS,CAAA;AAE1F;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,oBAAoB,CAAC,MAAM,oBAAoB,CAAC,GAC/F,MAAM,gBAAgB,CAAC,CAAA;AAEzB;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,WAAW,IAAI,CAAC,SAAS,MAAM,oBAAoB,GACpF,gBAAgB,CAAC,oBAAoB,CAAC,CAAC,CAAC,GAAG,MAAM,gBAAgB,CAAC,GAClE,iBAAiB,CAAA;AAErB;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,WAAW,IAAI,CAAC,SAAS,MAAM,gBAAgB,GAClF,gBAAgB,CAAC,CAAC,CAAC,GAAG,cAAc,GACpC,SAAS,CAAA;AAEb;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,WAAW,IAAI,cAAc,SAAS,KAAK,GAC3E,kBAAkB,GAClB,CAAC,SAAS,MAAM,cAAc,GAC5B,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,GACxB,kBAAkB,CAAA;AAExB;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAA;AAEzE;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,iBAAiB,CAAC,MAAM,IAClC,WAAW,CAAC,MAAM,CAAC,SAAS,SAAS,CAAC,MAAM,QAAQ,CAAC,EAAE,GACnD,iBAAiB,CAAC,QAAQ,CAAC,GAC3B,WAAW,CAAC,MAAM,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,KAAK,CAAA;CAAE,GAChD,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAClC,OAAO,GACP,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,GAClC,OAAO,CAAA;AAEf,YAAY,EAAE,oBAAoB,EAAE,CAAA"}

package/dist/types/server/serialize.d.ts

@@ -1,87 +0,0 @@
-/**
- * @file Server-side `serialize` helper: synchronously registers a project config, selects the
- * experiences whose conditions pass for a given URL, fetches content for the selected
- * experiences that reference CMS layout content, and returns a plain-JSON snapshot for SSR
- * hydration.
- *
- * The snapshot is plain JSON: `projectConfig` travels so the client renders against the exact
- * config the server selected with (critical for preview), and `conditionResults` carries the
- * memoized selection so the client's first paint reuses the server's results without re-evaluating.
- */
-import type { ContentBlob, ProjectConfig } from '@picked/delivery-api-client';
-import type { Picked } from '../picked';
-/** Subset of `Location` fields that can be injected into the selection context. */
-export interface SerializeLocation {
-    href: string;
-    pathname: string;
-    search: string;
-    hostname: string;
-    origin: string;
-    protocol: string;
-    port: string;
-    host: string;
-    hash: string;
-}
-/** Optional attributes injected into the selection context (currently the URL). */
-export interface SerializeAttributes {
-    location?: Partial<SerializeLocation>;
-}
-/** Parameters for {@link serialize}. */
-export interface SerializeParams {
-    /** URL attributes injected into the selection context. */
-    attributes?: SerializeAttributes;
-    /**
-     * Preview token for this request, so preview (unpublished) config and content resolve during
-     * preview SSR. The server has no `searchParams`, so the token cannot be recovered otherwise.
-     */
-    previewToken?: string;
-    /**
-     * Per-content-fetch timeout in milliseconds for the API path, so a slow or hung upstream cannot
-     * stall the SSR render indefinitely. On timeout the blob is skipped and the render proceeds.
-     * Defaults to {@link DEFAULT_CONTENT_TIMEOUT_MS}.
-     */
-    timeoutMs?: number;
-}
-/**
- * Plain-JSON SSR snapshot produced by {@link serialize} and consumed by the client provider.
- */
-export interface PickedSnapshot {
-    /** The project version the snapshot was selected against, or `null` when unknown. */
-    versionId: string | null;
-    /** The project config the server selected with (travels for preview parity). */
-    projectConfig: ProjectConfig;
-    /**
-     * Deduped content blobs for the selected experiences — the steps' own layout
-     * content and every entry reached from it through a `reference` field. The
-     * client provider seeds the whole array into the content registry, so both
-     * resolve identically on the server render and the first client paint.
-     */
-    content: ContentBlob[];
-    /** Memoized condition-evaluation results keyed by rule hash. */
-    conditionResults: Record<string, boolean>;
-}
-/**
- * Selects the experiences whose conditions pass for a URL and returns a plain-JSON snapshot for
- * SSR hydration.
- *
- * Config and content both resolve through the client, which keeps them on one source: a bundled
- * render cannot pair a bundled config with API-fetched content from a newer publish. Content is
- * deduped by blob id, and each API read carries a deadline so a slow upstream cannot stall the
- * render.
- *
- * Registration is synchronous (no `client.start()`), so the client's stores are populated before
- * selection. The condition-results store is reset at entry, and `serialize` expects a per-request
- * client — concurrent calls on one client are not supported. Each experience's own condition is
- * evaluated through the memoized evaluator against the injected URL; client-level
- * precondition/condition are not evaluated here in v1.
- *
- * @param {Picked} client - The Picked client to select with, and to resolve data through.
- * @param {SerializeParams} [params] - URL attributes, preview token, and content timeout.
- * @returns {Promise<PickedSnapshot>} The plain-JSON snapshot of config, content, and condition results.
- * @example
- * const snapshot = await serialize(client, {
- *   attributes: { location: { pathname: '/promo' } },
- * })
- */
-export declare function serialize(client: Picked, params?: SerializeParams): Promise<PickedSnapshot>;
-//# sourceMappingURL=serialize.d.ts.map

package/dist/types/server/serialize.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../../src/server/serialize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EAEd,MAAM,6BAA6B,CAAA;AAEpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAKvC,mFAAmF;AACnF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,mFAAmF;AACnF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAA;CACtC;AAKD,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,UAAU,CAAC,EAAE,mBAAmB,CAAA;IAChC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qFAAqF;IACrF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,gFAAgF;IAChF,aAAa,EAAE,aAAa,CAAA;IAC5B;;;;;OAKG;IACH,OAAO,EAAE,WAAW,EAAE,CAAA;IACtB,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC1C;AAoCD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,eAAoB,GAC3B,OAAO,CAAC,cAAc,CAAC,CA6EzB"}

package/dist/types/typed-content.d.ts

@@ -1,17 +0,0 @@
-/** @file Bridges untyped content registry stores to codegen-narrowed consumer types. */
-import type { Store } from 'effector';
-import type { Content } from './entities/content/content';
-import type { TypedContent } from './schema-registry';
-/**
- * Maps an untyped content store to a codegen-narrowed `TypedContent` store. The
- * `TData` narrowing is compile-time only (no runtime shape check); records whose
- * `data` is not an object map to `null`.
- *
- * @template {Record<string, unknown>} TData
- * @param {Store<Content | null>} store - Registry store from `client.contents.getById`.
- * @returns {Store<TypedContent<TData> | null>} Store whose `data` is narrowed to `TData`.
- * @example
- * const banner = toTypedContentStore<WelcomePage>(client.contents.getById('lc_banner'))
- */
-export declare function toTypedContentStore<TData extends Record<string, unknown>>(store: Store<Content | null>): Store<TypedContent<TData> | null>;
-//# sourceMappingURL=typed-content.d.ts.map

package/dist/types/typed-content.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"typed-content.d.ts","sourceRoot":"","sources":["../../src/typed-content.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AACrC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAoBrD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvE,KAAK,EAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,GAC3B,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAWnC"}

package/dist/types/utils/client-telemetry.d.ts

@@ -1,25 +0,0 @@
-/**
- * @file The telemetry hooks one client exposes.
- *
- * The observer belongs to the client that registered it, so several clients on
- * one page observe only their own traffic.
- */
-import type { DeliveryAPIRequestObserver } from '../data-source/request-observer';
-/** One client's telemetry hooks. */
-export interface ClientTelemetry {
-    /** Registers the observer wrapped around this client's delivery API requests, or clears it. */
-    observeDeliveryAPIRequests: (next: DeliveryAPIRequestObserver | null) => void;
-    /** The observer in force, or `null` while none is registered. */
-    readonly deliveryAPIRequestObserver: DeliveryAPIRequestObserver | null;
-}
-/**
- * Creates the telemetry hooks for one client.
- *
- * The observer is read per request, so registering one after an earlier fetch
- * still applies to the next.
- *
- * @returns {ClientTelemetry} The hooks to register through and read from.
- * @example const telemetry = createClientTelemetry()
- */
-export declare function createClientTelemetry(): ClientTelemetry;
-//# sourceMappingURL=client-telemetry.d.ts.map

package/dist/types/utils/client-telemetry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client-telemetry.d.ts","sourceRoot":"","sources":["../../../src/utils/client-telemetry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAA;AAEjF,oCAAoC;AACpC,MAAM,WAAW,eAAe;IAC9B,+FAA+F;IAC/F,0BAA0B,EAAE,CAAC,IAAI,EAAE,0BAA0B,GAAG,IAAI,KAAK,IAAI,CAAA;IAC7E,iEAAiE;IACjE,QAAQ,CAAC,0BAA0B,EAAE,0BAA0B,GAAG,IAAI,CAAA;CACvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CAWvD"}

package/dist/types/utils/content-path.d.ts

@@ -1,37 +0,0 @@
-/**
- * @file Content-path parsing for live-preview patches.
- *
- * Paths address a field inside a Content Entry's delivered `data` blob using the format the Picked
- * API already emits for content-data validation errors — `$.sections[0].data.title`, rooted at `$`,
- * with `.key` for object keys and `[n]` for array indices. Reusing that format keeps one convention
- * across validation errors and preview patches instead of inventing a second.
- *
- * Content-model field keys are constrained to `/^[a-z][a-z0-9_]*$/` server-side, so no key can
- * contain `.` or `[` and the string form needs no escaping.
- */
-/** One step along a content path: an object key, or an array index. */
-export type ContentPathSegment = string | number;
-/**
- * Parses a content path into its segments.
- *
- * Returns an empty list for the root path *and* for anything malformed. Callers treat an empty list
- * as "no addressable target" and skip the operation, so a corrupt or hostile path from another
- * frame degrades to a no-op instead of throwing inside a customer's page.
- *
- * @param {string} path - The path to parse, for example `$.sections[0].data.title`.
- * @returns {ContentPathSegment[]} The parsed segments, or `[]` for the root or an invalid path.
- * @example
- * parseContentPath('$.sections[0].data.title') // ['sections', 0, 'data', 'title']
- */
-export declare function parseContentPath(path: string): ContentPathSegment[];
-/**
- * Formats segments back into a content path. Inverse of {@link parseContentPath} for every
- * well-formed path.
- *
- * @param {readonly ContentPathSegment[]} segments - The segments to format.
- * @returns {string} The path string, or `'$'` when there are no segments.
- * @example
- * formatContentPath(['sections', 0, 'data', 'title']) // '$.sections[0].data.title'
- */
-export declare function formatContentPath(segments: readonly ContentPathSegment[]): string;
-//# sourceMappingURL=content-path.d.ts.map

package/dist/types/utils/content-path.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"content-path.d.ts","sourceRoot":"","sources":["../../../src/utils/content-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,uEAAuE;AACvE,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,CAAA;AA2ChD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAYnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,GAAG,MAAM,CAOjF"}

package/dist/types/utils/html-asset-value.d.ts

@@ -1,20 +0,0 @@
-/** @file Resolved CMS `html-asset` field value delivered inline to consumers. */
-/**
- * A resolved `html-asset` content field. The API inlines the file's text at `content` server-side
- * (`content: null` when the underlying file could not be resolved); there is no separate URL to fetch.
- */
-export interface HtmlAssetValue {
-    readonly id: string;
-    readonly content: string | null;
-}
-/**
- * Narrows an untyped resolved content-field value (for example `content.body` from `getStepContent()` /
- * `useStepContent()`) to {@link HtmlAssetValue}.
- *
- * @param {unknown} value - A field value from the resolved content blob.
- * @returns {value is HtmlAssetValue} True when `value` is `{ id: string; content: string | null }`.
- * @example
- * if (isHtmlAssetValue(content.body)) render(content.body.content)
- */
-export declare function isHtmlAssetValue(value: unknown): value is HtmlAssetValue;
-//# sourceMappingURL=html-asset-value.d.ts.map

package/dist/types/utils/html-asset-value.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"html-asset-value.d.ts","sourceRoot":"","sources":["../../../src/utils/html-asset-value.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAEjF;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAChC;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CASxE"}

package/dist/types/utils/inert-script-report.d.ts

@@ -1,40 +0,0 @@
-/**
- * @file Relays the count of preview-inserted subtrees whose scripts were neutralised.
- *
- * The render layer (`@picked/react`'s `HtmlRender`) knows how many script-bearing subtrees a
- * preview morph inserted; the preview receiver knows how to tell the dashboard. Neither should
- * import the other, so the count passes through this tiny module. Every framework binding's render
- * path reports into the same receiver through it.
- *
- * The count is cumulative for the session and only ever grows, which matches how the editor uses
- * it: "some markup you added is inert until you save", not a per-edit delta.
- */
-/** Listener notified when the cumulative inert-subtree count changes. */
-type InertScriptListener = (total: number) => void;
-/**
- * Records that a preview render inserted `count` subtrees whose scripts were neutralised.
- *
- * @param {number} count - Subtrees neutralised by the render that just completed.
- * @returns {void} Nothing.
- * @example reportInertScriptSubtrees(2)
- */
-export declare function reportInertScriptSubtrees(count: number): void;
-/**
- * Subscribes to the cumulative inert-subtree count, invoking `listener` immediately with the
- * current total so a late subscriber (the receiver connects after first paint) is not left behind.
- *
- * @param {InertScriptListener} listener - Called with the running total.
- * @returns {() => void} Unsubscribe function.
- * @example const stop = onInertScriptSubtrees((n) => post({ inertScriptSubtrees: n }))
- */
-export declare function onInertScriptSubtrees(listener: InertScriptListener): () => void;
-/**
- * Resets the cumulative count and drops every listener. Exposed for tests, which share a module
- * registry across cases.
- *
- * @returns {void} Nothing.
- * @example resetInertScriptReport()
- */
-export declare function resetInertScriptReport(): void;
-export {};
-//# sourceMappingURL=inert-script-report.d.ts.map

package/dist/types/utils/inert-script-report.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"inert-script-report.d.ts","sourceRoot":"","sources":["../../../src/utils/inert-script-report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,yEAAyE;AACzE,KAAK,mBAAmB,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;AAKlD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAI7D;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,IAAI,CAM/E;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAG7C"}

package/dist/types/utils/node-tree/get-next-node-from-action.d.ts

@@ -1,25 +0,0 @@
-/** @file Utility to resolve the next flow node after an action node runs. */
-import type { ExperienceEdge, ExperienceNode } from '../../entities/experience/experience';
-/**
- * Resolves the next node after an action node from its success or failure outcome.
- *
- * The explicit outcome branch is preferred (sourceHandle `'true'` for success and
- * `'false'` for failure). When that branch is absent, a plain handle-less edge is used
- * as a fallback, so an action wired as a bare continue (for example the builder's
- * addNext connector) passes through instead of dead-ending. Explicit success and failure
- * branches therefore still win, while a plain connection becomes a pass-through.
- *
- * @param {boolean} success - Whether the action succeeded (`true`) or failed (`false`).
- * @param {string} actionNodeId - The ID of the action node in the graph.
- * @param {ExperienceNode[]} nodes - All nodes in the experience graph.
- * @param {ExperienceEdge[]} edges - All edges in the experience graph.
- * @returns {ExperienceNode | undefined} The next node, or `undefined` when the action node
- * has neither an edge for the outcome nor a plain edge (a genuine terminal).
- * @example
- * ```typescript
- * // `success` is false only when the action threw; that routes to the onFail edge.
- * const nextNode = getNextNodeFromAction(succeeded, 'action-1', nodes, edges)
- * ```
- */
-export declare function getNextNodeFromAction(success: boolean, actionNodeId: string, nodes: ExperienceNode[], edges: ExperienceEdge[]): ExperienceNode | undefined;
-//# sourceMappingURL=get-next-node-from-action.d.ts.map

package/dist/types/utils/node-tree/get-next-node-from-action.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"get-next-node-from-action.d.ts","sourceRoot":"","sources":["../../../../src/utils/node-tree/get-next-node-from-action.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAA;AAE1F;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,cAAc,EAAE,EACvB,KAAK,EAAE,cAAc,EAAE,GACtB,cAAc,GAAG,SAAS,CAO5B"}

package/dist/types/utils/node-tree/get-next-node-from-condition.d.ts

@@ -1,17 +0,0 @@
-/** @file Utility to resolve the next flow node after evaluating a condition. */
-import type { ExperienceEdge, ExperienceNode } from '../../entities/experience/experience';
-/**
- * Returns the next node in the experience graph based on a condition result.
- *
- * @param conditionResult - Whether the condition evaluated to true or false.
- * @param conditionNodeId - The ID of the condition node in the graph.
- * @param nodes - All nodes in the experience graph.
- * @param edges - All edges in the experience graph.
- * @returns The next node to navigate to, or undefined if no matching edge exists.
- * @example
- * ```typescript
- * const nextNode = await getNextNodeFromCondition(true, 'cond-1', nodes, edges)
- * ```
- */
-export declare function getNextNodeFromCondition(conditionResult: boolean, conditionNodeId: string, nodes: ExperienceNode[], edges: ExperienceEdge[]): Promise<ExperienceNode | undefined>;
-//# sourceMappingURL=get-next-node-from-condition.d.ts.map

package/dist/types/utils/node-tree/get-next-node-from-condition.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"get-next-node-from-condition.d.ts","sourceRoot":"","sources":["../../../../src/utils/node-tree/get-next-node-from-condition.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAA;AAE1F;;;;;;;;;;;;GAYG;AACH,wBAAsB,wBAAwB,CAC5C,eAAe,EAAE,OAAO,EACxB,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,cAAc,EAAE,EACvB,KAAK,EAAE,cAAc,EAAE,uCAOxB"}

package/dist/types/utils/picked-config.d.ts

@@ -1,39 +0,0 @@
-/** @file Resolves the project id for a Picked client from options, window config, or script tag attributes. */
-import type { CreateClientOptions } from '../client';
-/** Subset of {@link CreateClientOptions} exposed on `window.pickedConfig`. */
-interface WindowPickedConfig {
-    organizationId?: string;
-    projectId?: string;
-    previewToken?: string;
-    apiUrl?: string;
-    dashboardUrl?: string;
-    documentationSiteUrl?: string;
-}
-declare global {
-    interface Window {
-        pickedConfig?: WindowPickedConfig;
-    }
-}
-/**
- * Reads `window.pickedConfig` when running in a browser.
- *
- * @template ExtendedPickedConfig - Additional keys consumers attach to the window config.
- * @returns {Readonly<Partial<CreateClientOptions> & ExtendedPickedConfig> | undefined} The window config, if set.
- * @example
- * getPickedConfig<{ theme: string }>()?.theme
- */
-export declare function getPickedConfig<ExtendedPickedConfig extends Record<string, unknown> | undefined>(): Readonly<Partial<CreateClientOptions> & ExtendedPickedConfig> | undefined;
-/**
- * Resolves the Picked project id from the supplied options, falling back to
- * `window.pickedConfig.projectId` and then to a `data-projectid` (or
- * `project-id`) attribute on a `picked_script`/`picked`/`cvly` script tag.
- *
- * @param {CreateClientOptions} options - Options passed to `createClient`.
- * @returns {string} The resolved project id.
- * @throws {Error} If no project id can be resolved from any source.
- * @example
- * getCreateClientProjectId({ projectId: 'proj-abc' })
- */
-export declare function getCreateClientProjectId(options: CreateClientOptions): string;
-export {};
-//# sourceMappingURL=picked-config.d.ts.map

package/dist/types/utils/picked-config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"picked-config.d.ts","sourceRoot":"","sources":["../../../src/utils/picked-config.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAC/G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAGpD,8EAA8E;AAC9E,UAAU,kBAAkB;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,YAAY,CAAC,EAAE,kBAAkB,CAAA;KAClC;CACF;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,oBAAoB,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,+EAUjE;AAyCD;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAqB7E"}

package/dist/types/utils/preview-session.d.ts

@@ -1,12 +0,0 @@
-/** Search parameter the dashboard appends to the preview iframe's URL. */
-export declare const PREVIEW_TOKEN_PARAM = "preview-token";
-/**
- * Whether this frame is running as a Picked live-preview session: inside an iframe, with a preview
- * token on the URL.
- *
- * @returns {boolean} True when the frame is a preview session.
- * @example
- * if (isPreviewSession()) enableMorphingRender()
- */
-export declare function isPreviewSession(): boolean;
-//# sourceMappingURL=preview-session.d.ts.map

package/dist/types/utils/preview-session.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"preview-session.d.ts","sourceRoot":"","sources":["../../../src/utils/preview-session.ts"],"names":[],"mappings":"AAUA,0EAA0E;AAC1E,eAAO,MAAM,mBAAmB,kBAAkB,CAAA;AAElD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAG1C"}

package/dist/types/utils/rehydrate-scripts.d.ts

@@ -1,50 +0,0 @@
-/** @file Re-executes Picked-tagged <script> elements that innerHTML left inert. */
-/** Inert script type the Picked transform stamps on classic scripts it blesses for rehydration. */
-export declare const PICKED_SCRIPT_TYPE = "application/picked-javascript";
-/** Inert script type the Picked transform stamps on `type="module"` scripts it blesses for rehydration. */
-export declare const PICKED_MODULE_SCRIPT_TYPE = "application/picked-module";
-/** Marker set on resurrected scripts so rehydration is idempotent. */
-export declare const PICKED_HYDRATED_ATTR = "data-picked-hydrated";
-declare global {
-    /**
-     * Root node of the currently-executing rehydrated inline script. Published only for the duration of
-     * that script's synchronous run so shadow-scoped page scripts can locate their own root, since
-     * `document.currentScript` is `null` inside a shadow tree.
-     */
-    var __pickedEmbedScriptRoot: Node | null | undefined;
-}
-/**
- * Re-creates every Picked-tagged (`type="application/picked-javascript"` or
- * `type="application/picked-module"`) script under `root` as a fresh, executable element, so
- * scripts inserted via `innerHTML` (which never run) execute — restored as `type="module"` for the
- * latter. Untagged scripts, including data blocks such as `application/json` or `importmap`, are left
- * untouched. In-place replacement preserves document order. Because `document.currentScript` is `null`
- * inside a shadow tree, each inline script's own root is published on `globalThis.__pickedEmbedScriptRoot`
- * while it runs, so shadow-scoped page scripts read `window.__pickedEmbedScriptRoot` to find their own root.
- *
- * Classic inline scripts are pre-parsed with the `Function` constructor and skipped only when that
- * throws a `SyntaxError`, so a body that would blank the experience on insertion is logged and left
- * inert. Any other failure says nothing about the body — a CSP omitting `'unsafe-eval'` throws an
- * `EvalError` and Trusted Types throws a `TypeError` however well the body parses — so the script is
- * injected unchanged and the page keeps working under those policies.
- *
- * This function intentionally references only globals and its own parameter, never the exported
- * `PICKED_*` constants above, so {@link buildRehydrateBootstrap} can serialise it with `.toString()` for
- * injection into a sandboxed iframe, where module imports are unavailable.
- *
- * @param {ParentNode} root - Element, ShadowRoot, or Document whose tagged scripts to rehydrate.
- * @returns {Promise<void>} Resolves after external (`src`) scripts have settled (load or error).
- * @example
- * await rehydrateScripts(shadowRoot)
- */
-export declare function rehydrateScripts(root: ParentNode): Promise<void>;
-/**
- * Builds an inline `<script>` string that runs {@link rehydrateScripts} against the injected document.
- * For splicing into an iframe `srcDoc` (or any HTML string) where module imports are unavailable.
- *
- * @returns {string} A self-contained `<script>…</script>` string.
- * @example
- * html.replace('</body>', buildRehydrateBootstrap() + '</body>')
- */
-export declare function buildRehydrateBootstrap(): string;
-//# sourceMappingURL=rehydrate-scripts.d.ts.map

package/dist/types/utils/rehydrate-scripts.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rehydrate-scripts.d.ts","sourceRoot":"","sources":["../../../src/utils/rehydrate-scripts.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAEnF,mGAAmG;AACnG,eAAO,MAAM,kBAAkB,kCAAkC,CAAA;AACjE,2GAA2G;AAC3G,eAAO,MAAM,yBAAyB,8BAA8B,CAAA;AACpE,sEAAsE;AACtE,eAAO,MAAM,oBAAoB,yBAAyB,CAAA;AAE1D,OAAO,CAAC,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,uBAAuB,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAAA;CACrD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAoGtE;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD"}