@amplifyup/sdk 0.1.62 → 0.1.64

package/dist/{query-3AXnQgzO.d.ts → query-BLjZYjHJ.d.ts}

@@ -1,4 +1,4 @@
-import { i as AmplifyUpTarget } from './types-Db_eLrfU.js';
+import { i as AmplifyUpTarget, y as ListRow } from './types-C32MgOiv.js';
 
 /**
  * On-request variant selection (tier 3).
@@ -60,7 +60,8 @@ declare function selectVariants(options: SelectVariantsOptions): Promise<SelectV
  * 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.
- * Results are plain CMS rows, not Field envelopes, and are not canvas-editable.
+ * 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';
@@ -148,7 +149,7 @@ interface QueryContentOptions {
  * });
  * ```
  */
-declare function queryContent<T = Record<string, unknown>>(options: QueryContentOptions): Promise<QueryResult<T>>;
+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;
 /**

package/dist/{query-DIZjc7st.d.mts → query-DuRilU_n.d.mts}

@@ -1,4 +1,4 @@
-import { i as AmplifyUpTarget } from './types-Db_eLrfU.mjs';
+import { i as AmplifyUpTarget, y as ListRow } from './types-C32MgOiv.mjs';
 
 /**
  * On-request variant selection (tier 3).
@@ -60,7 +60,8 @@ declare function selectVariants(options: SelectVariantsOptions): Promise<SelectV
  * 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.
- * Results are plain CMS rows, not Field envelopes, and are not canvas-editable.
+ * 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';
@@ -148,7 +149,7 @@ interface QueryContentOptions {
  * });
  * ```
  */
-declare function queryContent<T = Record<string, unknown>>(options: QueryContentOptions): Promise<QueryResult<T>>;
+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;
 /**

package/dist/react.d.mts

@@ -1,10 +1,9 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { P as PageConfig, c as AmplifyUpConfig, e as AmplifyPageContextInput, C as ContentSource, A as AmplifyContentMeta } from './types-Db_eLrfU.mjs';
-export { Z as ZoneConfig } from './types-Db_eLrfU.mjs';
-import React__default, { ReactNode } from 'react';
-import { L as LayoutComponentProps, F as Field$1 } from './AmplifyRenderer-W7eqltSj.mjs';
-export { A as AmplifyRenderer, b as Fields, I as ImageValue, a as isBrandedFields, i as isFieldEnvelope, t as toFieldEnvelopes } from './AmplifyRenderer-W7eqltSj.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-DIZjc7st.mjs';
+import { L as LayoutComponentProps, P as PageConfig, F as Field$1, l as FIELDS_BRAND, c as AmplifyUpConfig, e as AmplifyPageContextInput, C as ContentSource, A as AmplifyContentMeta } from './types-C32MgOiv.mjs';
+export { w as FieldRef, x as Fields, z as ImageValue, y as ListRow, B as PortableRef, Z as ZoneConfig, m as attachFieldEnvelopes, p as composerStoreKey, o as envelopeListRows, v as isBrandedFields, s as isFieldEnvelope, u as isReadOnlyRowField, q as listOwnerFromSpec, t as toFieldEnvelopes } from './types-C32MgOiv.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-DuRilU_n.mjs';
 export { i as isComposerPreview, a as isPreviewRequest, b as isWorkingContentRequest } from './preview-_vHmzRen.mjs';
 
 type RenderComponentContext = {
@@ -81,16 +80,41 @@ declare function Slot({ name, className, }: {
     name: string;
     className?: string;
 }): react_jsx_runtime.JSX.Element | null;
-declare function Field(props: {
-    /** Envelope from `props.fields` (`{ value, name }`). */
-    field?: Field$1<unknown>;
+type RejectFieldInput<T> = [T] extends [readonly unknown[]] ? never : T extends {
+    readonly [FIELDS_BRAND]: true;
+} ? never : T;
+/**
+ * Field Component
+ *
+ * Pass a field envelope: `<Field field={fields.title} />`.
+ * For a computed value, pass `value` and `name`.
+ *
+ * For markdown / rich text fields, use {@link RichText} instead.
+ * Do not pass a list or a list row — use `<Field field={post.title} />`.
+ *
+ * @example
+ * ```tsx
+ * function Hero({ fields }: { fields: Fields<{ title: string; description: string }> }) {
+ *   return (
+ *     <section className="hero">
+ *       <h1>
+ *         <Field field={fields.title} />
+ *       </h1>
+ *       <p>{fields.description.value}</p>
+ *     </section>
+ *   );
+ * }
+ * ```
+ */
+declare function Field<T = unknown>(props: {
+    /** Envelope from `props.fields` (`{ value, name, ref? }`). Lists and rows are not allowed. */
+    field?: Field$1<RejectFieldInput<T>>;
     /** Computed value — requires `name`. */
-    value?: unknown;
+    value?: RejectFieldInput<T>;
     /** Required with `value` for computed values. */
     name?: string;
     className?: string;
-    render?: (value: any) => ReactNode;
-}): string | number | true | Iterable<React__default.ReactNode> | react_jsx_runtime.JSX.Element | null;
+}): react_jsx_runtime.JSX.Element | null;
 /**
  * RichText - Renders a markdown (or HTML string) value as formatted HTML.
  *
@@ -109,10 +133,10 @@ declare function Field(props: {
  * }
  * ```
  */
-declare function RichText(props: {
-    field?: Field$1<string | null>;
+declare function RichText<T = string | null>(props: {
+    field?: Field$1<RejectFieldInput<T>>;
     /** Computed markdown — requires `name`. */
-    value?: string | null;
+    value?: RejectFieldInput<T>;
     /** Required with `value` for computed values. */
     name?: string;
     className?: string;
@@ -135,17 +159,16 @@ declare function RichText(props: {
  * }
  * ```
  */
-declare function Image(props: {
-    field?: Field$1<unknown>;
+declare function Image<T = unknown>(props: {
+    field?: Field$1<RejectFieldInput<T>>;
     /** Computed image — requires `name`. */
-    value?: unknown;
+    value?: RejectFieldInput<T>;
     /** Required with `value` for computed values. */
     name?: string;
     alt?: string;
-} & Omit<React__default.ImgHTMLAttributes<HTMLImageElement>, 'src' | 'alt' | 'name'>): react_jsx_runtime.JSX.Element | null;
+} & Omit<react__default.ImgHTMLAttributes<HTMLImageElement>, 'src' | 'alt' | 'name'>): react_jsx_runtime.JSX.Element | null;
 
-declare function ComposerProvider({ layoutNodeId, children, }: {
-    layoutNodeId?: string;
+declare function ComposerProvider({ children, }: {
     children: ReactNode;
 }): react_jsx_runtime.JSX.Element;
 declare function MaybeComposerProvider({ enabled, layoutNodeId, children, }: {

package/dist/react.d.ts

@@ -1,10 +1,9 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { P as PageConfig, c as AmplifyUpConfig, e as AmplifyPageContextInput, C as ContentSource, A as AmplifyContentMeta } from './types-Db_eLrfU.js';
-export { Z as ZoneConfig } from './types-Db_eLrfU.js';
-import React__default, { ReactNode } from 'react';
-import { L as LayoutComponentProps, F as Field$1 } from './AmplifyRenderer-BQ8-H2H4.js';
-export { A as AmplifyRenderer, b as Fields, I as ImageValue, a as isBrandedFields, i as isFieldEnvelope, t as toFieldEnvelopes } from './AmplifyRenderer-BQ8-H2H4.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-3AXnQgzO.js';
+import { L as LayoutComponentProps, P as PageConfig, F as Field$1, l as FIELDS_BRAND, c as AmplifyUpConfig, e as AmplifyPageContextInput, C as ContentSource, A as AmplifyContentMeta } from './types-C32MgOiv.js';
+export { w as FieldRef, x as Fields, z as ImageValue, y as ListRow, B as PortableRef, Z as ZoneConfig, m as attachFieldEnvelopes, p as composerStoreKey, o as envelopeListRows, v as isBrandedFields, s as isFieldEnvelope, u as isReadOnlyRowField, q as listOwnerFromSpec, t as toFieldEnvelopes } from './types-C32MgOiv.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-BLjZYjHJ.js';
 export { i as isComposerPreview, a as isPreviewRequest, b as isWorkingContentRequest } from './preview-_vHmzRen.js';
 
 type RenderComponentContext = {
@@ -81,16 +80,41 @@ declare function Slot({ name, className, }: {
     name: string;
     className?: string;
 }): react_jsx_runtime.JSX.Element | null;
-declare function Field(props: {
-    /** Envelope from `props.fields` (`{ value, name }`). */
-    field?: Field$1<unknown>;
+type RejectFieldInput<T> = [T] extends [readonly unknown[]] ? never : T extends {
+    readonly [FIELDS_BRAND]: true;
+} ? never : T;
+/**
+ * Field Component
+ *
+ * Pass a field envelope: `<Field field={fields.title} />`.
+ * For a computed value, pass `value` and `name`.
+ *
+ * For markdown / rich text fields, use {@link RichText} instead.
+ * Do not pass a list or a list row — use `<Field field={post.title} />`.
+ *
+ * @example
+ * ```tsx
+ * function Hero({ fields }: { fields: Fields<{ title: string; description: string }> }) {
+ *   return (
+ *     <section className="hero">
+ *       <h1>
+ *         <Field field={fields.title} />
+ *       </h1>
+ *       <p>{fields.description.value}</p>
+ *     </section>
+ *   );
+ * }
+ * ```
+ */
+declare function Field<T = unknown>(props: {
+    /** Envelope from `props.fields` (`{ value, name, ref? }`). Lists and rows are not allowed. */
+    field?: Field$1<RejectFieldInput<T>>;
     /** Computed value — requires `name`. */
-    value?: unknown;
+    value?: RejectFieldInput<T>;
     /** Required with `value` for computed values. */
     name?: string;
     className?: string;
-    render?: (value: any) => ReactNode;
-}): string | number | true | Iterable<React__default.ReactNode> | react_jsx_runtime.JSX.Element | null;
+}): react_jsx_runtime.JSX.Element | null;
 /**
  * RichText - Renders a markdown (or HTML string) value as formatted HTML.
  *
@@ -109,10 +133,10 @@ declare function Field(props: {
  * }
  * ```
  */
-declare function RichText(props: {
-    field?: Field$1<string | null>;
+declare function RichText<T = string | null>(props: {
+    field?: Field$1<RejectFieldInput<T>>;
     /** Computed markdown — requires `name`. */
-    value?: string | null;
+    value?: RejectFieldInput<T>;
     /** Required with `value` for computed values. */
     name?: string;
     className?: string;
@@ -135,17 +159,16 @@ declare function RichText(props: {
  * }
  * ```
  */
-declare function Image(props: {
-    field?: Field$1<unknown>;
+declare function Image<T = unknown>(props: {
+    field?: Field$1<RejectFieldInput<T>>;
     /** Computed image — requires `name`. */
-    value?: unknown;
+    value?: RejectFieldInput<T>;
     /** Required with `value` for computed values. */
     name?: string;
     alt?: string;
-} & Omit<React__default.ImgHTMLAttributes<HTMLImageElement>, 'src' | 'alt' | 'name'>): react_jsx_runtime.JSX.Element | null;
+} & Omit<react__default.ImgHTMLAttributes<HTMLImageElement>, 'src' | 'alt' | 'name'>): react_jsx_runtime.JSX.Element | null;
 
-declare function ComposerProvider({ layoutNodeId, children, }: {
-    layoutNodeId?: string;
+declare function ComposerProvider({ children, }: {
     children: ReactNode;
 }): react_jsx_runtime.JSX.Element;
 declare function MaybeComposerProvider({ enabled, layoutNodeId, children, }: {