payload-live-preview 1.0.4 → 1.1.0

package/dist/index.d.cts

@@ -379,6 +379,15 @@ interface CachedElement {
     readonly arraySeparator?: string;
     /** Optional locale code locked onto this element (overrides the global locale). */
     readonly locale?: string;
+    /**
+     * Optional document this binding belongs to, resolved from the nearest
+     * `data-payload-owner` ancestor (the element itself included).
+     *
+     * Only consulted while owner scoping is enabled. Without it a field name is
+     * the sole identity, so every document rendered on the page competes for the
+     * same name.
+     */
+    readonly owner?: string;
 }
 /**
  * Context passed to every field renderer. Provides access to the
@@ -550,6 +559,20 @@ interface LivePreviewClientConfig {
     readonly heartbeatMs?: number;
     /** IntersectionObserver rootMargin. Defaults to `200px`. */
     readonly intersectionRootMargin?: string;
+    /**
+     * Restrict each update to the bindings owned by the document it describes.
+     *
+     * Ownership is declared in markup with `data-payload-owner`, resolved from
+     * the nearest ancestor: `global:<slug>`, `collection:<slug>`, or
+     * `collection:<slug>:<id>`. Payload already sends the edited document's
+     * identity, so nothing else needs configuring.
+     *
+     * Defaults to `false`, which keeps the 1.x behaviour of matching on the
+     * field name alone. Enable it when one page previews more than one document
+     * and a field name is therefore no longer a unique identity. While enabled,
+     * a binding without an owner is never updated.
+     */
+    readonly scopeBindingsByOwner?: boolean;
     /** Bypass the visibility gate (apply every update). Defaults to `false`. */
     readonly disableVisibilityGate?: boolean;
     /** Cache-size threshold above which off-screen updates are queued for replay. Defaults to 50. */
@@ -721,6 +744,15 @@ interface InlineScriptConfig {
      * a production-like origin list. Default `false`.
      */
     readonly disableLocalhostMatching?: boolean;
+    /**
+     * Restrict each update to the bindings owned by the document it describes,
+     * declared in markup with `data-payload-owner` and resolved from the nearest
+     * ancestor. Default `false`, which keeps matching on the field name alone.
+     *
+     * Enable it when one page previews more than one document. While enabled a
+     * binding without an owner is never updated.
+     */
+    readonly scopeBindingsByOwner?: boolean;
     /**
      * Retained for 1.x source compatibility, but has no effect here:
      * `generateInlineScript()` returns a script body and creates no tag.

package/dist/index.d.ts

@@ -379,6 +379,15 @@ interface CachedElement {
     readonly arraySeparator?: string;
     /** Optional locale code locked onto this element (overrides the global locale). */
     readonly locale?: string;
+    /**
+     * Optional document this binding belongs to, resolved from the nearest
+     * `data-payload-owner` ancestor (the element itself included).
+     *
+     * Only consulted while owner scoping is enabled. Without it a field name is
+     * the sole identity, so every document rendered on the page competes for the
+     * same name.
+     */
+    readonly owner?: string;
 }
 /**
  * Context passed to every field renderer. Provides access to the
@@ -550,6 +559,20 @@ interface LivePreviewClientConfig {
     readonly heartbeatMs?: number;
     /** IntersectionObserver rootMargin. Defaults to `200px`. */
     readonly intersectionRootMargin?: string;
+    /**
+     * Restrict each update to the bindings owned by the document it describes.
+     *
+     * Ownership is declared in markup with `data-payload-owner`, resolved from
+     * the nearest ancestor: `global:<slug>`, `collection:<slug>`, or
+     * `collection:<slug>:<id>`. Payload already sends the edited document's
+     * identity, so nothing else needs configuring.
+     *
+     * Defaults to `false`, which keeps the 1.x behaviour of matching on the
+     * field name alone. Enable it when one page previews more than one document
+     * and a field name is therefore no longer a unique identity. While enabled,
+     * a binding without an owner is never updated.
+     */
+    readonly scopeBindingsByOwner?: boolean;
     /** Bypass the visibility gate (apply every update). Defaults to `false`. */
     readonly disableVisibilityGate?: boolean;
     /** Cache-size threshold above which off-screen updates are queued for replay. Defaults to 50. */
@@ -721,6 +744,15 @@ interface InlineScriptConfig {
      * a production-like origin list. Default `false`.
      */
     readonly disableLocalhostMatching?: boolean;
+    /**
+     * Restrict each update to the bindings owned by the document it describes,
+     * declared in markup with `data-payload-owner` and resolved from the nearest
+     * ancestor. Default `false`, which keeps matching on the field name alone.
+     *
+     * Enable it when one page previews more than one document. While enabled a
+     * binding without an owner is never updated.
+     */
+    readonly scopeBindingsByOwner?: boolean;
     /**
      * Retained for 1.x source compatibility, but has no effect here:
      * `generateInlineScript()` returns a script body and creates no tag.