@amplifyup/sdk 0.1.78 → 0.2.0

package/dist/query-DYjs4LQQ.d.mts

@@ -0,0 +1,262 @@
+import { A as AmplifyUpTarget } from './types-ffQNIQCK.mjs';
+
+/**
+ * On-request variant selection (tier 3).
+ *
+ * Decisions happen on AmplifyUp Edge. The client asks after the view has
+ * rendered; the Worker returns variant keys only. Profile data never leaves
+ * the edge. This helper is the JS wrapper around POST /v1/select — the same
+ * wire format is the contract for Flutter / native / .NET clients. No DOM
+ * or Next.js assumptions.
+ */
+
+interface SelectVariantsResult {
+    siteId: string;
+    view: string;
+    variantKeys: Record<string, string>;
+    meta?: Record<string, unknown>;
+}
+declare class SelectVariantsError extends Error {
+    status: number;
+    body: unknown;
+    constructor(message: string, status: number, body?: unknown);
+}
+interface FetchEdgeSelectOptions {
+    edgeUrl: string;
+    trackingId?: string;
+    site?: string;
+    view: string;
+    anonId: string;
+    sessionId?: string;
+    zones?: string[];
+    /** Request-local facts the edge cannot observe (app version, screen class). */
+    context?: Record<string, unknown>;
+    fetch?: typeof fetch;
+    signal?: AbortSignal;
+}
+declare function fetchEdgeSelect(options: FetchEdgeSelectOptions): Promise<SelectVariantsResult>;
+interface SelectVariantsOptions {
+    trackingId?: string;
+    site?: string;
+    view: string;
+    anonId: string;
+    sessionId?: string;
+    zones?: string[];
+    context?: Record<string, unknown>;
+    target?: AmplifyUpTarget;
+    edgeUrl?: string;
+    fetch?: typeof fetch;
+    signal?: AbortSignal;
+}
+/**
+ * Ask Edge to decide deferred rules for a view. Returns variant keys to pass
+ * to `/v1/resolve?variants=`.
+ */
+declare function selectVariants(options: SelectVariantsOptions): Promise<SelectVariantsResult>;
+
+/**
+ * Field envelopes — same shape in published, draft, and Composer edit.
+ * `{ value, name, ref? }` where `name` is the path within the owning record
+ * (`title`, `author.name`). Page-level fields omit `ref`.
+ * `ref` is stamped from the connection that produced the row
+ * (`providerId`, AmplifyUp `entity`, `id`) — never from a CMS `_type`.
+ * Produced once at the Edge resolve boundary (`fetchEdgeResolve`) and again
+ * on the SDK for `queryContent` rows.
+ */
+declare const FIELDS_BRAND: unique symbol;
+type ImageValue = {
+    url: string;
+    alt?: string;
+    width?: number;
+    height?: number;
+};
+/** Connection that produced a list row. Omitted on page-level fields. */
+type FieldRef = {
+    providerId: string;
+    entity: string;
+    id: string;
+};
+/** AmplifyUp entity + provider from the connection that produced a list. */
+type ListOwner = {
+    providerId: string;
+    entity: string;
+};
+type ConnectionLike = {
+    mode?: string;
+    providerId?: string;
+    entity?: string;
+    spec?: {
+        providerId?: string;
+        entity?: string;
+    };
+};
+type FieldReadLike = {
+    resource: string;
+    path?: string;
+    /** Schema field kind (image, string, object, …) from the component definition. */
+    kind?: string;
+};
+type EnvelopeSources = {
+    connections?: Record<string, ConnectionLike | null | undefined>;
+    reads?: Record<string, FieldReadLike>;
+};
+type Field<T> = {
+    value: T;
+    name: string;
+    ref?: FieldRef;
+    /** Row field with no write target — display only in Composer. */
+    readOnly?: true;
+};
+/** Portable entry identity after normalize (`id` required). */
+type PortableRef = {
+    id: string;
+    type?: string;
+};
+type IdentifierKey = 'id' | '_id' | 'slug' | 'key' | '_key' | 'docId' | '_type' | 'type';
+type IsPlainObject<T> = T extends object ? T extends readonly unknown[] ? false : T extends ImageValue ? false : true : false;
+type AsRecord<T> = T extends Record<string, unknown> ? T : Record<string, unknown>;
+/** A list row: enveloped fields plus a plain `id`. */
+type ListRow<T extends Record<string, unknown> = Record<string, unknown>> = Fields<T> & {
+    id: string;
+};
+type FieldsProp<T> = NonNullable<T> extends ImageValue ? Field<T | null> : NonNullable<T> extends readonly (infer U)[] ? IsPlainObject<U> extends true ? Field<Array<ListRow<AsRecord<U>>>> : Field<T> : IsPlainObject<NonNullable<T>> extends true ? Fields<NonNullable<T>> : Field<T>;
+type Fields<T> = {
+    readonly [FIELDS_BRAND]: true;
+} & {
+    [K in keyof T]-?: K extends IdentifierKey ? T[K] : FieldsProp<T[K]>;
+};
+/** Props passed into site components. Raw CMS bags are not assignable. */
+type LayoutComponentProps<T extends Record<string, unknown> = Record<string, unknown>> = {
+    fields: Fields<T>;
+};
+declare function isBrandedFields(value: unknown): value is Fields<Record<string, unknown>>;
+declare function isFieldEnvelope(value: unknown): value is Field<unknown>;
+declare function isReadOnlyRowField(value: unknown): boolean;
+declare function composerStoreKey(name: string, ref?: FieldRef | null, layoutNodeId?: string): string;
+declare function listOwnerFromSpec(spec: {
+    providerId?: string;
+    entity?: string;
+} | null | undefined): ListOwner | undefined;
+type EnvelopeScope = {
+    ref?: FieldRef;
+    readOnly?: boolean;
+    owners?: (fieldName: string) => ListOwner | undefined;
+    /** Schema-driven: true when the field at this path is a scalar leaf. */
+    leaf?: (path: string) => boolean;
+};
+/**
+ * Wrap a props bag as envelopes. Already-enveloped bags are returned as-is.
+ * Nested plain objects become nested bags; portable images stay a leaf.
+ * Object arrays become list rows (`Fields` + plain `id`); `name` is the path
+ * within the record when `ref` is set.
+ */
+declare function toFieldEnvelopes<T extends Record<string, unknown>>(source: T | null | undefined, prefix?: string, scope?: EnvelopeScope | FieldRef): Fields<T>;
+declare function envelopeListRows<T extends Record<string, unknown> = Record<string, unknown>>(items: unknown[], owner?: ListOwner | null): Array<ListRow<T>>;
+/** Attach branded `fields` once. Keeps sibling keys (e.g. zoneId). */
+declare function attachFieldEnvelopes(props: Record<string, unknown> | null | undefined, sources?: EnvelopeSources | Record<string, ConnectionLike | null | undefined>): Record<string, unknown>;
+
+/**
+ * Runtime content queries.
+ *
+ * Page resolve covers data known at Deploy. Visitor-triggered data — search,
+ * load more, pickers — runs here: the browser asks AmplifyUp, AmplifyUp asks
+ * the CMS. Only entities published with the page can be queried.
+ * Edge JSON stays raw. `queryContent` envelopes rows on the SDK so they
+ * edit in Composer the same way as list-field rows.
+ */
+
+type QueryFilterOp = 'eq' | 'neq' | 'in' | 'nin' | 'gt' | 'gte' | 'lt' | 'lte' | 'contains' | 'exists';
+interface QueryFilter {
+    field: string;
+    op: QueryFilterOp;
+    value?: unknown;
+}
+interface QuerySort {
+    field: string;
+    dir: 'asc' | 'desc';
+}
+/**
+ * Provider-neutral query. AmplifyUp compiles this for the connected CMS —
+ * it never contains CMS query syntax. Same shape Composer saves on a
+ * query connection, and the shape returned in `{field}Pagination.spec`.
+ */
+interface QuerySpec {
+    providerId: string;
+    entity: string;
+    filter: QueryFilter[];
+    sort: QuerySort[];
+    limit: number;
+    offset: number;
+}
+/** Pagination meta added to list props when a query connection is paginated. */
+interface QueryPagination {
+    hasMore: boolean;
+    limit: number;
+    offset: number;
+    nextOffset: number;
+    spec: QuerySpec;
+}
+interface QueryResult<T = Record<string, unknown>> {
+    results: T[];
+    count: number;
+    hasMore: boolean;
+    limit: number;
+    offset: number;
+    nextOffset: number;
+    /** True when a content source failed and results may be incomplete. */
+    degraded?: boolean;
+}
+declare class QueryContentError extends Error {
+    status: number;
+    body: unknown;
+    constructor(message: string, status: number, body?: unknown);
+}
+interface FetchEdgeQueryOptions {
+    edgeUrl: string;
+    trackingId: string;
+    /** Published route the query belongs to (provides sources + entity mapping). */
+    route: string;
+    spec: QuerySpec;
+    siteId?: string | null;
+    fetch?: typeof fetch;
+    signal?: AbortSignal;
+}
+/**
+ * Low-level runtime query against a known Edge URL.
+ * Most callers should use `queryContent`, which resolves the URL for them.
+ */
+declare function fetchEdgeQuery<T = Record<string, unknown>>(options: FetchEdgeQueryOptions): Promise<QueryResult<T>>;
+interface QueryContentOptions {
+    trackingId: string;
+    /** Published route the query belongs to, e.g. '/insights'. */
+    route: string;
+    spec: QuerySpec;
+    siteId?: string | null;
+    target?: AmplifyUpTarget;
+    fetch?: typeof fetch;
+    signal?: AbortSignal;
+}
+/**
+ * Run a content query at request time (search, load more, pickers).
+ *
+ * Start from the published spec on a paginated list prop so filters and sort
+ * stay owned by Composer:
+ *
+ * ```ts
+ * const next = await queryContent({
+ *   trackingId,
+ *   route: '/insights',
+ *   spec: { ...postsPagination.spec, offset: postsPagination.nextOffset },
+ * });
+ * ```
+ */
+declare function queryContent<T extends Record<string, unknown> = Record<string, unknown>>(options: QueryContentOptions): Promise<QueryResult<ListRow<T>>>;
+/** Convenience: next page from pagination meta on a list prop. */
+declare function nextPageSpec(pagination: QueryPagination): QuerySpec;
+/**
+ * Convenience: same published query, filtered by a visitor's search term.
+ * Resets to the first page. Empty terms return the unfiltered spec.
+ */
+declare function searchSpec(pagination: QueryPagination, field: string, term: string): QuerySpec;
+
+export { type FieldRef as A, type Fields as B, type LayoutComponentProps as C, type FetchEdgeSelectOptions as F, type ImageValue as I, type ListRow as L, type PortableRef as P, QueryContentError as Q, SelectVariantsError as S, type SelectVariantsOptions as a, type SelectVariantsResult as b, fetchEdgeQuery as c, searchSpec as d, type QueryContentOptions as e, fetchEdgeSelect as f, type FetchEdgeQueryOptions as g, type QueryResult as h, type QueryPagination as i, type QuerySpec as j, type QueryFilter as k, type QueryFilterOp as l, type QuerySort as m, nextPageSpec as n, type Field as o, FIELDS_BRAND as p, queryContent as q, attachFieldEnvelopes as r, selectVariants as s, toFieldEnvelopes as t, envelopeListRows as u, composerStoreKey as v, listOwnerFromSpec as w, isFieldEnvelope as x, isReadOnlyRowField as y, isBrandedFields as z };

package/dist/query-Xo9cy-2F.d.ts

@@ -0,0 +1,262 @@
+import { A as AmplifyUpTarget } from './types-ffQNIQCK.js';
+
+/**
+ * On-request variant selection (tier 3).
+ *
+ * Decisions happen on AmplifyUp Edge. The client asks after the view has
+ * rendered; the Worker returns variant keys only. Profile data never leaves
+ * the edge. This helper is the JS wrapper around POST /v1/select — the same
+ * wire format is the contract for Flutter / native / .NET clients. No DOM
+ * or Next.js assumptions.
+ */
+
+interface SelectVariantsResult {
+    siteId: string;
+    view: string;
+    variantKeys: Record<string, string>;
+    meta?: Record<string, unknown>;
+}
+declare class SelectVariantsError extends Error {
+    status: number;
+    body: unknown;
+    constructor(message: string, status: number, body?: unknown);
+}
+interface FetchEdgeSelectOptions {
+    edgeUrl: string;
+    trackingId?: string;
+    site?: string;
+    view: string;
+    anonId: string;
+    sessionId?: string;
+    zones?: string[];
+    /** Request-local facts the edge cannot observe (app version, screen class). */
+    context?: Record<string, unknown>;
+    fetch?: typeof fetch;
+    signal?: AbortSignal;
+}
+declare function fetchEdgeSelect(options: FetchEdgeSelectOptions): Promise<SelectVariantsResult>;
+interface SelectVariantsOptions {
+    trackingId?: string;
+    site?: string;
+    view: string;
+    anonId: string;
+    sessionId?: string;
+    zones?: string[];
+    context?: Record<string, unknown>;
+    target?: AmplifyUpTarget;
+    edgeUrl?: string;
+    fetch?: typeof fetch;
+    signal?: AbortSignal;
+}
+/**
+ * Ask Edge to decide deferred rules for a view. Returns variant keys to pass
+ * to `/v1/resolve?variants=`.
+ */
+declare function selectVariants(options: SelectVariantsOptions): Promise<SelectVariantsResult>;
+
+/**
+ * Field envelopes — same shape in published, draft, and Composer edit.
+ * `{ value, name, ref? }` where `name` is the path within the owning record
+ * (`title`, `author.name`). Page-level fields omit `ref`.
+ * `ref` is stamped from the connection that produced the row
+ * (`providerId`, AmplifyUp `entity`, `id`) — never from a CMS `_type`.
+ * Produced once at the Edge resolve boundary (`fetchEdgeResolve`) and again
+ * on the SDK for `queryContent` rows.
+ */
+declare const FIELDS_BRAND: unique symbol;
+type ImageValue = {
+    url: string;
+    alt?: string;
+    width?: number;
+    height?: number;
+};
+/** Connection that produced a list row. Omitted on page-level fields. */
+type FieldRef = {
+    providerId: string;
+    entity: string;
+    id: string;
+};
+/** AmplifyUp entity + provider from the connection that produced a list. */
+type ListOwner = {
+    providerId: string;
+    entity: string;
+};
+type ConnectionLike = {
+    mode?: string;
+    providerId?: string;
+    entity?: string;
+    spec?: {
+        providerId?: string;
+        entity?: string;
+    };
+};
+type FieldReadLike = {
+    resource: string;
+    path?: string;
+    /** Schema field kind (image, string, object, …) from the component definition. */
+    kind?: string;
+};
+type EnvelopeSources = {
+    connections?: Record<string, ConnectionLike | null | undefined>;
+    reads?: Record<string, FieldReadLike>;
+};
+type Field<T> = {
+    value: T;
+    name: string;
+    ref?: FieldRef;
+    /** Row field with no write target — display only in Composer. */
+    readOnly?: true;
+};
+/** Portable entry identity after normalize (`id` required). */
+type PortableRef = {
+    id: string;
+    type?: string;
+};
+type IdentifierKey = 'id' | '_id' | 'slug' | 'key' | '_key' | 'docId' | '_type' | 'type';
+type IsPlainObject<T> = T extends object ? T extends readonly unknown[] ? false : T extends ImageValue ? false : true : false;
+type AsRecord<T> = T extends Record<string, unknown> ? T : Record<string, unknown>;
+/** A list row: enveloped fields plus a plain `id`. */
+type ListRow<T extends Record<string, unknown> = Record<string, unknown>> = Fields<T> & {
+    id: string;
+};
+type FieldsProp<T> = NonNullable<T> extends ImageValue ? Field<T | null> : NonNullable<T> extends readonly (infer U)[] ? IsPlainObject<U> extends true ? Field<Array<ListRow<AsRecord<U>>>> : Field<T> : IsPlainObject<NonNullable<T>> extends true ? Fields<NonNullable<T>> : Field<T>;
+type Fields<T> = {
+    readonly [FIELDS_BRAND]: true;
+} & {
+    [K in keyof T]-?: K extends IdentifierKey ? T[K] : FieldsProp<T[K]>;
+};
+/** Props passed into site components. Raw CMS bags are not assignable. */
+type LayoutComponentProps<T extends Record<string, unknown> = Record<string, unknown>> = {
+    fields: Fields<T>;
+};
+declare function isBrandedFields(value: unknown): value is Fields<Record<string, unknown>>;
+declare function isFieldEnvelope(value: unknown): value is Field<unknown>;
+declare function isReadOnlyRowField(value: unknown): boolean;
+declare function composerStoreKey(name: string, ref?: FieldRef | null, layoutNodeId?: string): string;
+declare function listOwnerFromSpec(spec: {
+    providerId?: string;
+    entity?: string;
+} | null | undefined): ListOwner | undefined;
+type EnvelopeScope = {
+    ref?: FieldRef;
+    readOnly?: boolean;
+    owners?: (fieldName: string) => ListOwner | undefined;
+    /** Schema-driven: true when the field at this path is a scalar leaf. */
+    leaf?: (path: string) => boolean;
+};
+/**
+ * Wrap a props bag as envelopes. Already-enveloped bags are returned as-is.
+ * Nested plain objects become nested bags; portable images stay a leaf.
+ * Object arrays become list rows (`Fields` + plain `id`); `name` is the path
+ * within the record when `ref` is set.
+ */
+declare function toFieldEnvelopes<T extends Record<string, unknown>>(source: T | null | undefined, prefix?: string, scope?: EnvelopeScope | FieldRef): Fields<T>;
+declare function envelopeListRows<T extends Record<string, unknown> = Record<string, unknown>>(items: unknown[], owner?: ListOwner | null): Array<ListRow<T>>;
+/** Attach branded `fields` once. Keeps sibling keys (e.g. zoneId). */
+declare function attachFieldEnvelopes(props: Record<string, unknown> | null | undefined, sources?: EnvelopeSources | Record<string, ConnectionLike | null | undefined>): Record<string, unknown>;
+
+/**
+ * Runtime content queries.
+ *
+ * Page resolve covers data known at Deploy. Visitor-triggered data — search,
+ * load more, pickers — runs here: the browser asks AmplifyUp, AmplifyUp asks
+ * the CMS. Only entities published with the page can be queried.
+ * Edge JSON stays raw. `queryContent` envelopes rows on the SDK so they
+ * edit in Composer the same way as list-field rows.
+ */
+
+type QueryFilterOp = 'eq' | 'neq' | 'in' | 'nin' | 'gt' | 'gte' | 'lt' | 'lte' | 'contains' | 'exists';
+interface QueryFilter {
+    field: string;
+    op: QueryFilterOp;
+    value?: unknown;
+}
+interface QuerySort {
+    field: string;
+    dir: 'asc' | 'desc';
+}
+/**
+ * Provider-neutral query. AmplifyUp compiles this for the connected CMS —
+ * it never contains CMS query syntax. Same shape Composer saves on a
+ * query connection, and the shape returned in `{field}Pagination.spec`.
+ */
+interface QuerySpec {
+    providerId: string;
+    entity: string;
+    filter: QueryFilter[];
+    sort: QuerySort[];
+    limit: number;
+    offset: number;
+}
+/** Pagination meta added to list props when a query connection is paginated. */
+interface QueryPagination {
+    hasMore: boolean;
+    limit: number;
+    offset: number;
+    nextOffset: number;
+    spec: QuerySpec;
+}
+interface QueryResult<T = Record<string, unknown>> {
+    results: T[];
+    count: number;
+    hasMore: boolean;
+    limit: number;
+    offset: number;
+    nextOffset: number;
+    /** True when a content source failed and results may be incomplete. */
+    degraded?: boolean;
+}
+declare class QueryContentError extends Error {
+    status: number;
+    body: unknown;
+    constructor(message: string, status: number, body?: unknown);
+}
+interface FetchEdgeQueryOptions {
+    edgeUrl: string;
+    trackingId: string;
+    /** Published route the query belongs to (provides sources + entity mapping). */
+    route: string;
+    spec: QuerySpec;
+    siteId?: string | null;
+    fetch?: typeof fetch;
+    signal?: AbortSignal;
+}
+/**
+ * Low-level runtime query against a known Edge URL.
+ * Most callers should use `queryContent`, which resolves the URL for them.
+ */
+declare function fetchEdgeQuery<T = Record<string, unknown>>(options: FetchEdgeQueryOptions): Promise<QueryResult<T>>;
+interface QueryContentOptions {
+    trackingId: string;
+    /** Published route the query belongs to, e.g. '/insights'. */
+    route: string;
+    spec: QuerySpec;
+    siteId?: string | null;
+    target?: AmplifyUpTarget;
+    fetch?: typeof fetch;
+    signal?: AbortSignal;
+}
+/**
+ * Run a content query at request time (search, load more, pickers).
+ *
+ * Start from the published spec on a paginated list prop so filters and sort
+ * stay owned by Composer:
+ *
+ * ```ts
+ * const next = await queryContent({
+ *   trackingId,
+ *   route: '/insights',
+ *   spec: { ...postsPagination.spec, offset: postsPagination.nextOffset },
+ * });
+ * ```
+ */
+declare function queryContent<T extends Record<string, unknown> = Record<string, unknown>>(options: QueryContentOptions): Promise<QueryResult<ListRow<T>>>;
+/** Convenience: next page from pagination meta on a list prop. */
+declare function nextPageSpec(pagination: QueryPagination): QuerySpec;
+/**
+ * Convenience: same published query, filtered by a visitor's search term.
+ * Resets to the first page. Empty terms return the unfiltered spec.
+ */
+declare function searchSpec(pagination: QueryPagination, field: string, term: string): QuerySpec;
+
+export { type FieldRef as A, type Fields as B, type LayoutComponentProps as C, type FetchEdgeSelectOptions as F, type ImageValue as I, type ListRow as L, type PortableRef as P, QueryContentError as Q, SelectVariantsError as S, type SelectVariantsOptions as a, type SelectVariantsResult as b, fetchEdgeQuery as c, searchSpec as d, type QueryContentOptions as e, fetchEdgeSelect as f, type FetchEdgeQueryOptions as g, type QueryResult as h, type QueryPagination as i, type QuerySpec as j, type QueryFilter as k, type QueryFilterOp as l, type QuerySort as m, nextPageSpec as n, type Field as o, FIELDS_BRAND as p, queryContent as q, attachFieldEnvelopes as r, selectVariants as s, toFieldEnvelopes as t, envelopeListRows as u, composerStoreKey as v, listOwnerFromSpec as w, isFieldEnvelope as x, isReadOnlyRowField as y, isBrandedFields as z };

package/dist/react.d.mts

@@ -1,24 +1,21 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { L as LayoutComponentProps, P as PageConfig, F as Field$1, m as FIELDS_BRAND, d as AmplifyUpConfig, f as AmplifyPageContextInput, C as ContentSource, A as AmplifyContentMeta } from './types-D4TSd2Yt.mjs';
-export { x as FieldRef, y as Fields, B as ImageValue, z as ListRow, D as PortableRef, Z as ZoneConfig, o as attachFieldEnvelopes, q as composerStoreKey, p as envelopeListRows, w as isBrandedFields, u as isFieldEnvelope, v as isReadOnlyRowField, s as listOwnerFromSpec, t as toFieldEnvelopes } from './types-D4TSd2Yt.mjs';
-import react__default, { ReactNode } from 'react';
-export { AmplifyRenderer } from './AmplifyRenderer.mjs';
-export { Q as QueryContentError, e as QueryContentOptions, k as QueryFilter, l as QueryFilterOp, i as QueryPagination, h as QueryResult, m as QuerySort, j as QuerySpec, S as SelectVariantsError, a as SelectVariantsOptions, b as SelectVariantsResult, n as nextPageSpec, q as queryContent, d as searchSpec, s as selectVariants } from './query-CV8x3oQT.mjs';
+import { P as PageConfig, f as AmplifyUpConfig, h as AmplifyPageContextInput, C as ContentSource, a as AmplifyContentMeta } from './types-ffQNIQCK.mjs';
+export { Z as ZoneConfig } from './types-ffQNIQCK.mjs';
+import react__default, { ReactNode, FC } from 'react';
+import { C as ComponentRegistry } from './AmplifyRenderer-CPUr9Bkc.mjs';
+export { A as AmplifyRenderer, d as defineComponentRegistry } from './AmplifyRenderer-CPUr9Bkc.mjs';
+import { o as Field$1, p as FIELDS_BRAND } from './query-DYjs4LQQ.mjs';
+export { A as FieldRef, B as Fields, I as ImageValue, C as LayoutComponentProps, L as ListRow, P as PortableRef, Q as QueryContentError, e as QueryContentOptions, k as QueryFilter, l as QueryFilterOp, i as QueryPagination, h as QueryResult, m as QuerySort, j as QuerySpec, S as SelectVariantsError, a as SelectVariantsOptions, b as SelectVariantsResult, r as attachFieldEnvelopes, v as composerStoreKey, u as envelopeListRows, z as isBrandedFields, x as isFieldEnvelope, y as isReadOnlyRowField, w as listOwnerFromSpec, n as nextPageSpec, q as queryContent, d as searchSpec, s as selectVariants, t as toFieldEnvelopes } from './query-DYjs4LQQ.mjs';
 export { i as isComposerPreview, a as isPreviewRequest, b as isWorkingContentRequest } from './preview-_vHmzRen.mjs';
 
-type RenderComponentContext = {
-    /** Unique layout-tree node id — required when multiple instances share a component type. */
-    layoutNodeId: string;
-};
-type RenderComponentFn = (componentId: string, props: LayoutComponentProps, slots?: Record<string, ReactNode>, context?: RenderComponentContext) => ReactNode;
 interface AmplifyPageContentProps {
     /**
      * Native page content shown to visitors when no AmplifyUp layout is configured.
      * Never rendered in Composer preview — only the layout canvas is shown there.
      */
     fallback?: ReactNode;
-    /** Maps AmplifyUp component IDs to your React components. */
-    renderComponent: RenderComponentFn;
+    /** The generated component registry. `<AmplifyPage />` passes it for you. */
+    registry: ComponentRegistry;
     /** SSG/ISR layout from the server. Client overlay applies only when variants differ. */
     pageConfig?: PageConfig | null;
     /**
@@ -41,7 +38,15 @@ interface AmplifyPageContentProps {
  * Live pages paint the SSG/ISR layout first. Client Edge resolve (visitor id)
  * overlays only when the personalized tree differs from that static HTML.
  */
-declare function AmplifyPageContent({ fallback, renderComponent, pageConfig: pageConfigProp, forceComposerPreview, previewLoadingComponent, previewEmptyComponent, loadingComponent, emptyComponent, errorComponent, }: AmplifyPageContentProps): react_jsx_runtime.JSX.Element | null;
+declare function AmplifyPageContent(contentProps: AmplifyPageContentProps): react_jsx_runtime.JSX.Element | null;
+
+type AmplifyPageProps = Omit<AmplifyPageContentProps, 'registry'>;
+/**
+ * Used by the generated registry module to export `<AmplifyPage />`. The
+ * binding happens in that client module because a server `page.tsx` can't
+ * pass components to a client component.
+ */
+declare const bindAmplifyPage: (registry: ComponentRegistry) => FC<AmplifyPageProps>;
 
 /**
  * True when the page is running inside AmplifyUp Composer.
@@ -57,13 +62,6 @@ declare function useInComposer(force?: boolean): boolean;
 /** @deprecated Prefer `useInComposer`. Kept for internal AmplifyPageContent. */
 declare function useComposerPreviewFlag(force?: boolean): boolean;
 
-declare function ComponentContextProvider({ children, slots, props, layoutNodeId, componentId, }: {
-    children: ReactNode;
-    slots?: Record<string, ReactNode>;
-    props?: Record<string, any>;
-    layoutNodeId?: string;
-    componentId?: string;
-}): react_jsx_runtime.JSX.Element;
 /**
  * Slot Component
  *
@@ -230,4 +228,4 @@ interface AmplifyUpProviderProps {
 declare function AmplifyUpProvider({ children, config, pageContext, }: AmplifyUpProviderProps): react_jsx_runtime.JSX.Element;
 declare function useAmplifyUp(): AmplifyUpContextType;
 
-export { AmplifyContentMeta, AmplifyPageContent, AmplifyUpProvider, ComponentContextProvider, ComposerLayoutStatusProvider, ComposerProvider, ContentSource, Field, Field$1 as FieldEnvelope, Image, LayoutComponentProps, MaybeComposerProvider, PageConfig, RichText, Slot, type SlotState, resolveSlotState, slotShowsAddComponent, slotStateFromEl, useAmplifyUp, useComposerPreviewFlag, useInComposer };
+export { AmplifyContentMeta, AmplifyPageContent, type AmplifyPageContentProps, type AmplifyPageProps, AmplifyUpProvider, ComponentRegistry, ComposerLayoutStatusProvider, ComposerProvider, ContentSource, Field, Field$1 as FieldEnvelope, Image, MaybeComposerProvider, PageConfig, RichText, Slot, type SlotState, bindAmplifyPage, resolveSlotState, slotShowsAddComponent, slotStateFromEl, useAmplifyUp, useComposerPreviewFlag, useInComposer };

package/dist/react.d.ts

@@ -1,24 +1,21 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { L as LayoutComponentProps, P as PageConfig, F as Field$1, m as FIELDS_BRAND, d as AmplifyUpConfig, f as AmplifyPageContextInput, C as ContentSource, A as AmplifyContentMeta } from './types-D4TSd2Yt.js';
-export { x as FieldRef, y as Fields, B as ImageValue, z as ListRow, D as PortableRef, Z as ZoneConfig, o as attachFieldEnvelopes, q as composerStoreKey, p as envelopeListRows, w as isBrandedFields, u as isFieldEnvelope, v as isReadOnlyRowField, s as listOwnerFromSpec, t as toFieldEnvelopes } from './types-D4TSd2Yt.js';
-import react__default, { ReactNode } from 'react';
-export { AmplifyRenderer } from './AmplifyRenderer.js';
-export { Q as QueryContentError, e as QueryContentOptions, k as QueryFilter, l as QueryFilterOp, i as QueryPagination, h as QueryResult, m as QuerySort, j as QuerySpec, S as SelectVariantsError, a as SelectVariantsOptions, b as SelectVariantsResult, n as nextPageSpec, q as queryContent, d as searchSpec, s as selectVariants } from './query-B23UsNIv.js';
+import { P as PageConfig, f as AmplifyUpConfig, h as AmplifyPageContextInput, C as ContentSource, a as AmplifyContentMeta } from './types-ffQNIQCK.js';
+export { Z as ZoneConfig } from './types-ffQNIQCK.js';
+import react__default, { ReactNode, FC } from 'react';
+import { C as ComponentRegistry } from './AmplifyRenderer-BNWBrFQN.js';
+export { A as AmplifyRenderer, d as defineComponentRegistry } from './AmplifyRenderer-BNWBrFQN.js';
+import { o as Field$1, p as FIELDS_BRAND } from './query-Xo9cy-2F.js';
+export { A as FieldRef, B as Fields, I as ImageValue, C as LayoutComponentProps, L as ListRow, P as PortableRef, Q as QueryContentError, e as QueryContentOptions, k as QueryFilter, l as QueryFilterOp, i as QueryPagination, h as QueryResult, m as QuerySort, j as QuerySpec, S as SelectVariantsError, a as SelectVariantsOptions, b as SelectVariantsResult, r as attachFieldEnvelopes, v as composerStoreKey, u as envelopeListRows, z as isBrandedFields, x as isFieldEnvelope, y as isReadOnlyRowField, w as listOwnerFromSpec, n as nextPageSpec, q as queryContent, d as searchSpec, s as selectVariants, t as toFieldEnvelopes } from './query-Xo9cy-2F.js';
 export { i as isComposerPreview, a as isPreviewRequest, b as isWorkingContentRequest } from './preview-_vHmzRen.js';
 
-type RenderComponentContext = {
-    /** Unique layout-tree node id — required when multiple instances share a component type. */
-    layoutNodeId: string;
-};
-type RenderComponentFn = (componentId: string, props: LayoutComponentProps, slots?: Record<string, ReactNode>, context?: RenderComponentContext) => ReactNode;
 interface AmplifyPageContentProps {
     /**
      * Native page content shown to visitors when no AmplifyUp layout is configured.
      * Never rendered in Composer preview — only the layout canvas is shown there.
      */
     fallback?: ReactNode;
-    /** Maps AmplifyUp component IDs to your React components. */
-    renderComponent: RenderComponentFn;
+    /** The generated component registry. `<AmplifyPage />` passes it for you. */
+    registry: ComponentRegistry;
     /** SSG/ISR layout from the server. Client overlay applies only when variants differ. */
     pageConfig?: PageConfig | null;
     /**
@@ -41,7 +38,15 @@ interface AmplifyPageContentProps {
  * Live pages paint the SSG/ISR layout first. Client Edge resolve (visitor id)
  * overlays only when the personalized tree differs from that static HTML.
  */
-declare function AmplifyPageContent({ fallback, renderComponent, pageConfig: pageConfigProp, forceComposerPreview, previewLoadingComponent, previewEmptyComponent, loadingComponent, emptyComponent, errorComponent, }: AmplifyPageContentProps): react_jsx_runtime.JSX.Element | null;
+declare function AmplifyPageContent(contentProps: AmplifyPageContentProps): react_jsx_runtime.JSX.Element | null;
+
+type AmplifyPageProps = Omit<AmplifyPageContentProps, 'registry'>;
+/**
+ * Used by the generated registry module to export `<AmplifyPage />`. The
+ * binding happens in that client module because a server `page.tsx` can't
+ * pass components to a client component.
+ */
+declare const bindAmplifyPage: (registry: ComponentRegistry) => FC<AmplifyPageProps>;
 
 /**
  * True when the page is running inside AmplifyUp Composer.
@@ -57,13 +62,6 @@ declare function useInComposer(force?: boolean): boolean;
 /** @deprecated Prefer `useInComposer`. Kept for internal AmplifyPageContent. */
 declare function useComposerPreviewFlag(force?: boolean): boolean;
 
-declare function ComponentContextProvider({ children, slots, props, layoutNodeId, componentId, }: {
-    children: ReactNode;
-    slots?: Record<string, ReactNode>;
-    props?: Record<string, any>;
-    layoutNodeId?: string;
-    componentId?: string;
-}): react_jsx_runtime.JSX.Element;
 /**
  * Slot Component
  *
@@ -230,4 +228,4 @@ interface AmplifyUpProviderProps {
 declare function AmplifyUpProvider({ children, config, pageContext, }: AmplifyUpProviderProps): react_jsx_runtime.JSX.Element;
 declare function useAmplifyUp(): AmplifyUpContextType;
 
-export { AmplifyContentMeta, AmplifyPageContent, AmplifyUpProvider, ComponentContextProvider, ComposerLayoutStatusProvider, ComposerProvider, ContentSource, Field, Field$1 as FieldEnvelope, Image, LayoutComponentProps, MaybeComposerProvider, PageConfig, RichText, Slot, type SlotState, resolveSlotState, slotShowsAddComponent, slotStateFromEl, useAmplifyUp, useComposerPreviewFlag, useInComposer };
+export { AmplifyContentMeta, AmplifyPageContent, type AmplifyPageContentProps, type AmplifyPageProps, AmplifyUpProvider, ComponentRegistry, ComposerLayoutStatusProvider, ComposerProvider, ContentSource, Field, Field$1 as FieldEnvelope, Image, MaybeComposerProvider, PageConfig, RichText, Slot, type SlotState, bindAmplifyPage, resolveSlotState, slotShowsAddComponent, slotStateFromEl, useAmplifyUp, useComposerPreviewFlag, useInComposer };