payload-live-preview 2.0.2 → 2.0.4

package/dist/index.d.cts

@@ -158,12 +158,15 @@ interface LivePreviewInspection {
 /**
  * The fidelity verdicts as `inspect()` reports them (LP0411). A positive
  * `unfaithful` beside `escalated: 0` is a page that keeps a degraded patch —
- * because `mode` says so, or because neither `fragments.handler` nor
- * `route.handler` is there to escalate to.
+ * because `mode` says so, or because `canEscalate` is false: neither
+ * `fragments.handler` nor `route.handler` is there to escalate to, which the
+ * runtime also says once as LP0808 when `mode` is `'escalate'`.
  */
 interface InspectionFidelity {
     /** `onUnfaithfulPatch` as resolved from both of its names. */
     readonly mode: 'ignore' | 'warn' | 'escalate';
+    /** Whether a fragment or route strategy exists for `'escalate'` to hand a patch to. */
+    readonly canEscalate: boolean;
     /** Bindings reported unfaithful since start — once per element, like LP0411, and under every mode. */
     readonly unfaithful: number;
     /** Of those, how many were handed to the fragment or route strategy. */
@@ -302,10 +305,12 @@ declare const DIAGNOSTIC_CODES: Readonly<{
     readonly PluginIncompatible: "LP0103";
     /** The page carries the lean runtime and needs a feature that profile leaves out. */
     readonly ProfileFeatureOmitted: "LP0104";
-    /** An update named a field with no binding anchor on the page. */
+    /** An update named an empty field with no binding anchor on the page; an edit to it has nowhere to land. */
     readonly OrphanField: "LP0201";
     /** Owner scoping is on and the update names no document it could belong to. */
     readonly UnattributableUpdate: "LP0202";
+    /** An update carried a value for a field the page binds nowhere; editing it changes nothing on this page. */
+    readonly UnboundField: "LP0203";
     /** The visibility gate held offscreen writes back until they scroll into view. */
     readonly VisibilityGateDeferred: "LP0301";
     /** A value was refused because the attribute or the value itself is unsafe. */
@@ -382,6 +387,8 @@ declare const DIAGNOSTIC_CODES: Readonly<{
     readonly FragmentStrategyUnavailable: "LP0806";
     /** A revision changed a field with no binding; `onUnfaithfulPatch` refreshed the route. */
     readonly UnboundChangeRefresh: "LP0807";
+    /** `onUnfaithfulPatch: 'escalate'` found no route or fragment strategy to hand an unfaithful patch to; the page keeps it. */
+    readonly EscalationUnavailable: "LP0808";
     /** A readiness row is not yet at its 2.0 value; `pll doctor --v2` reports it. */
     readonly V2ReadinessGap: "LP0709";
     /** The preview runtime is served to anonymous visitors, not only inside the admin frame. */
@@ -1939,8 +1946,9 @@ declare function previewBindingsFromLocals(locals: unknown, options?: {
 
 /**
  * Hydrated islands own their subtree, so the runtime never patches inside one.
- * Instead every flush dispatches `payload-live-preview:update` on each island
- * root with the update in `detail`. `data-payload-island="patch"` opts back in.
+ * Instead every flush that carried a change dispatches `payload-live-preview:update`
+ * on each island root with the update in `detail`, whether or not a binding
+ * outside the islands was written. `data-payload-island="patch"` opts back in.
  * @internal
  */
 declare const ISLAND_EVENT = "payload-live-preview:update";

package/dist/index.d.ts

@@ -158,12 +158,15 @@ interface LivePreviewInspection {
 /**
  * The fidelity verdicts as `inspect()` reports them (LP0411). A positive
  * `unfaithful` beside `escalated: 0` is a page that keeps a degraded patch —
- * because `mode` says so, or because neither `fragments.handler` nor
- * `route.handler` is there to escalate to.
+ * because `mode` says so, or because `canEscalate` is false: neither
+ * `fragments.handler` nor `route.handler` is there to escalate to, which the
+ * runtime also says once as LP0808 when `mode` is `'escalate'`.
  */
 interface InspectionFidelity {
     /** `onUnfaithfulPatch` as resolved from both of its names. */
     readonly mode: 'ignore' | 'warn' | 'escalate';
+    /** Whether a fragment or route strategy exists for `'escalate'` to hand a patch to. */
+    readonly canEscalate: boolean;
     /** Bindings reported unfaithful since start — once per element, like LP0411, and under every mode. */
     readonly unfaithful: number;
     /** Of those, how many were handed to the fragment or route strategy. */
@@ -302,10 +305,12 @@ declare const DIAGNOSTIC_CODES: Readonly<{
     readonly PluginIncompatible: "LP0103";
     /** The page carries the lean runtime and needs a feature that profile leaves out. */
     readonly ProfileFeatureOmitted: "LP0104";
-    /** An update named a field with no binding anchor on the page. */
+    /** An update named an empty field with no binding anchor on the page; an edit to it has nowhere to land. */
     readonly OrphanField: "LP0201";
     /** Owner scoping is on and the update names no document it could belong to. */
     readonly UnattributableUpdate: "LP0202";
+    /** An update carried a value for a field the page binds nowhere; editing it changes nothing on this page. */
+    readonly UnboundField: "LP0203";
     /** The visibility gate held offscreen writes back until they scroll into view. */
     readonly VisibilityGateDeferred: "LP0301";
     /** A value was refused because the attribute or the value itself is unsafe. */
@@ -382,6 +387,8 @@ declare const DIAGNOSTIC_CODES: Readonly<{
     readonly FragmentStrategyUnavailable: "LP0806";
     /** A revision changed a field with no binding; `onUnfaithfulPatch` refreshed the route. */
     readonly UnboundChangeRefresh: "LP0807";
+    /** `onUnfaithfulPatch: 'escalate'` found no route or fragment strategy to hand an unfaithful patch to; the page keeps it. */
+    readonly EscalationUnavailable: "LP0808";
     /** A readiness row is not yet at its 2.0 value; `pll doctor --v2` reports it. */
     readonly V2ReadinessGap: "LP0709";
     /** The preview runtime is served to anonymous visitors, not only inside the admin frame. */
@@ -1939,8 +1946,9 @@ declare function previewBindingsFromLocals(locals: unknown, options?: {
 
 /**
  * Hydrated islands own their subtree, so the runtime never patches inside one.
- * Instead every flush dispatches `payload-live-preview:update` on each island
- * root with the update in `detail`. `data-payload-island="patch"` opts back in.
+ * Instead every flush that carried a change dispatches `payload-live-preview:update`
+ * on each island root with the update in `detail`, whether or not a binding
+ * outside the islands was written. `data-payload-island="patch"` opts back in.
  * @internal
  */
 declare const ISLAND_EVENT = "payload-live-preview:update";