payload-live-preview 2.0.0-beta.0 → 2.0.0

package/dist/fragment.d.cts

@@ -5,7 +5,9 @@
  *
  * Browser-side reporting sites write the literal (`code: 'LP0603'`) rather than
  * reading it from this record: the frozen table would then ship in the inline
- * runtime for the sake of six characters. Server-side tools may import it.
+ * runtime for the sake of six characters — it did, 1 287 B in every page, for
+ * the one read Z6 left in the strategy runner, and `diagnostic-codes.test.ts`
+ * now holds the artifact free of it. Server-side tools may import it.
  */
 /**
  * Every diagnostic code the runtime can report, by name.
@@ -23,6 +25,8 @@ declare const DIAGNOSTIC_CODES: Readonly<{
     readonly ReferrerOnlyTrust: "LP0102";
     /** A plugin declares a runtime range this runtime does not satisfy; it was refused. */
     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. */
     readonly OrphanField: "LP0201";
     /** Owner scoping is on and the update names no document it could belong to. */
@@ -43,10 +47,24 @@ declare const DIAGNOSTIC_CODES: Readonly<{
     readonly StructuralUnstableKeys: "LP0406";
     /** A binding asks for a delivery strategy this release does not have; it is left unchanged. */
     readonly UnsupportedStrategy: "LP0407";
+    /** `data-payload-format` names a format the vocabulary does not contain; the default formatting was used instead. */
+    readonly UnknownValueFormat: "LP0408";
+    /** The strict sanitizer removed an attribute the 1.x `'compat'` policy kept. */
+    readonly SanitizerDroppedAttribute: "LP0409";
+    /** A Lexical block has no renderer; the markup the server rendered for it is kept instead. */
+    readonly UnrenderedBlockKept: "LP0410";
+    /** A patch cannot reach what the server would have drawn; `onUnfaithfulPatch` decided what happens next. */
+    readonly UnfaithfulPatch: "LP0411";
+    /** The first write to a date, number or checkbox binding replaced a different reading of the same value. */
+    readonly ServerFormatReplaced: "LP0412";
+    /** A Lexical block has no renderer, and the write could not keep the markup the server rendered for it; it is gone. */
+    readonly UnrenderedBlockLost: "LP0413";
     /** A message was rejected before it reached the update pipeline. */
     readonly MessageRejected: "LP0501";
     /** A preview token was rejected. */
     readonly TokenRejected: "LP0502";
+    /** A trusted origin sent a message this protocol version does not recognise. */
+    readonly ProtocolShapeUnknown: "LP0503";
     /** A consumer event handler threw. */
     readonly HandlerThrew: "LP0601";
     /** A consumer transform threw; the original value was kept. */
@@ -57,11 +75,13 @@ declare const DIAGNOSTIC_CODES: Readonly<{
     readonly StartupFailed: "LP0605";
     /** Sending the ready handshake failed. */
     readonly ReadyFailed: "LP0606";
+    /** The page declared hydration, but no React commit or Vue mount came within the cap; the runtime started without waiting. */
+    readonly HydrationWaitTimedOut: "LP0607";
     /** The audit found no runtime in a response that carried preview intent. */
     readonly AuditRuntimeMissing: "LP0701";
     /** The preview response declares no `frame-ancestors`. */
     readonly AuditNoFrameAncestors: "LP0702";
-    /** `X-Frame-Options` forbids framing, which no CSP can undo. */
+    /** `X-Frame-Options` forbids framing, which no CSP can undo; `SAMEORIGIN` forbids it from another origin only. */
     readonly AuditFrameOptionsBlocks: "LP0703";
     /** Binding attributes are served to anonymous visitors. */
     readonly AuditBindingsExposed: "LP0704";
@@ -81,10 +101,12 @@ declare const DIAGNOSTIC_CODES: Readonly<{
     readonly FragmentUnauthorized: "LP0803";
     /** A fragment response arrived for a revision that was already superseded and was discarded. */
     readonly FragmentSuperseded: "LP0804";
-    /** A route refresh was requested again for the same revision; the loop guard stopped it. */
+    /** A route refresh was refused: the loop guard, or the strategy's minimum interval. */
     readonly RouteRefreshLoop: "LP0805";
     /** A boundary asks for the fragment strategy but no fragment handler is configured; it is patched. */
     readonly FragmentStrategyUnavailable: "LP0806";
+    /** A revision changed a field with no binding; `onUnfaithfulPatch` refreshed the route. */
+    readonly UnboundChangeRefresh: "LP0807";
     /** 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. */
@@ -103,7 +125,7 @@ type DiagnosticCode = (typeof DIAGNOSTIC_CODES)[keyof typeof DIAGNOSTIC_CODES];
 
 /** What produced an update: the runtime's DOM patching, a server-rendered fragment, or a route refresh. */
 type UpdateSource = 'patch' | 'fragment' | 'route';
-/** Marks a server-rendered boundary; the value is the registry id the server may render. */
+/** Marks a server-rendered boundary; the value is the registry id the server may render. @internal */
 declare const FRAGMENT_ATTRIBUTE = "data-payload-fragment";
 /** One revision, as a strategy sees it, with the runtime capabilities it may use. */
 interface FragmentContext {
@@ -149,7 +171,21 @@ interface RouteContext {
     readonly signal: AbortSignal;
     readonly isCurrent: () => boolean;
     readonly log: (code: DiagnosticCode, detail: string) => void;
+    /**
+     * Ask to be run again in `delayMs`, once. A strategy that refuses a refresh
+     * because it is rate-limiting itself uses this: the window is a rate limit
+     * and not a filter, so what falls inside it still has to reach the preview.
+     * The runtime runs at most one such request, and only while the revision that
+     * asked is still the current one.
+     */
+    readonly retryAfter?: (delayMs: number) => void;
 }
+/**
+ * What one refresh did. `refused` is the strategy's own brake and not a
+ * failure — it is counted separately, because a number that mixes a planned
+ * pause with a broken request cannot be read.
+ */
+type RouteOutcome = 'refreshed' | 'failed' | 'refused' | 'superseded';
 /**
  * Whether a revision needs the whole route re-rendered, and how. After a
  * refresh the runtime rescans and re-applies the revision, so the unsaved
@@ -157,7 +193,7 @@ interface RouteContext {
  */
 interface RouteStrategy {
     readonly plan: (root: ParentNode, changedFields: ReadonlySet<string>) => boolean;
-    readonly refresh: (context: RouteContext) => Promise<'refreshed' | 'failed' | 'superseded'>;
+    readonly refresh: (context: RouteContext) => Promise<RouteOutcome>;
 }
 interface StrategyHandlers {
     readonly fragment?: FragmentStrategy;
@@ -167,13 +203,15 @@ interface StrategyHandlers {
  * Explicit `data-payload-strategy` wins; otherwise a binding inside a fragment
  * boundary belongs to the fragment, one in `<head>` to the route, the rest is
  * patched. An unknown explicit value resolves to `undefined` (LP0407).
+ * @internal
  */
 declare function resolveStrategy(element: Element): UpdateSource | undefined;
 
 /** Fragment boundaries: how a `data-payload-fragment` element is read and which ones an update touches. */
 
-/** Distinguishes several boundaries of one registry id; unique among siblings. */
+/** Distinguishes several boundaries of one registry id; unique among siblings. @internal */
 declare const FRAGMENT_KEY_ATTRIBUTE = "data-payload-fragment-key";
+/** @internal */
 interface FragmentBoundary {
     readonly element: Element;
     /** Registry id — never a path, module or function name. */
@@ -182,7 +220,7 @@ interface FragmentBoundary {
     /** Fields whose change re-renders the boundary; empty means any field. */
     readonly dependsOn: readonly string[];
 }
-/** One revision's request to a per-boundary handler. */
+/** One revision's request to a per-boundary handler. @internal */
 interface StrategyRequest {
     readonly revision: number;
     readonly receivedAt: number;
@@ -193,6 +231,7 @@ interface StrategyRequest {
     /** Aborted when a newer revision arrives or the runtime stops. */
     readonly signal: AbortSignal;
 }
+/** @internal */
 type FragmentOutcome = {
     readonly status: 'rendered';
     /** The boundary's new inner HTML. */
@@ -205,10 +244,11 @@ type FragmentOutcome = {
 } | {
     readonly status: 'superseded';
 };
-/** Renders one boundary for one revision. Must honour `request.signal`. */
+/** Renders one boundary for one revision. Must honour `request.signal`. @internal */
 type FragmentHandler = (request: StrategyRequest, boundary: FragmentBoundary) => Promise<FragmentOutcome>;
+/** @internal */
 declare function describeBoundary(element: Element): FragmentBoundary | null;
-/** The boundaries under `root` that `changedFields` touch; one inside an island is the island's business. */
+/** The boundaries under `root` that `changedFields` touch; one inside an island is the island's business. @internal */
 declare function collectFragmentBoundaries(root: ParentNode, changedFields: ReadonlySet<string>): readonly FragmentBoundary[];
 
 /**
@@ -236,22 +276,24 @@ interface FragmentStrategyOptions {
         readonly search: string;
     };
 }
+/** @internal */
 declare function createFragmentHandler(options: FragmentStrategyOptions): FragmentHandler;
 
 /**
  * The route strategy: when a revision touches what no smaller strategy can
- * render, fetch the route again and morph it in place. A refresh inside
- * `minIntervalMs` is refused as LP0805. See ADR 0011.
+ * render, ask the host's own router to re-render it, or else fetch the route
+ * again and morph it in place. A refresh inside `minIntervalMs` is refused as
+ * LP0805 and handed back for a trailing run. See ADR 0011.
  */
 
-/** Sent with every refresh so a server can tell a preview refresh from navigation. */
+/** Sent with every refresh so a server can tell a preview refresh from navigation. @internal */
 declare const ROUTE_REFRESH_HEADER = "x-payload-live-preview";
 interface RouteStrategyOptions {
     /** `fetch` to use; defaults to the global one. */
     readonly fetch?: (url: string, init?: RequestInit) => Promise<Response>;
     /** Per-refresh timeout. Default 8000 ms. */
     readonly timeoutMs?: number;
-    /** Shortest gap between two refreshes; one inside it is refused with LP0805. Default 1000 ms. */
+    /** Shortest gap between two refreshes; one inside it is refused with LP0805 and run when the gap closes. Default 1000 ms. */
     readonly minIntervalMs?: number;
     /** The document to refresh; defaults to `document`. */
     readonly document?: Document;
@@ -266,7 +308,7 @@ interface RouteStrategyOptions {
         readonly scrollTo: (x: number, y: number) => void;
     };
 }
-/** An explicit `data-payload-strategy="route"`, or a binding in `<head>`. */
+/** An explicit `data-payload-strategy="route"`, or a binding in `<head>`. @internal */
 declare function isRouteBound(element: Element): boolean;
 declare function createRouteStrategy(options?: RouteStrategyOptions): RouteStrategy;
 
@@ -275,9 +317,11 @@ declare function createRouteStrategy(options?: RouteStrategyOptions): RouteStrat
  * and what it answers. Both sides validate the shape; nothing on the wire
  * names code, paths or templates. See ADR 0011.
  */
-/** Bumped when the request or response shape changes incompatibly. */
+/** Bumped when the request or response shape changes incompatibly. @internal */
 declare const FRAGMENT_PROTOCOL_VERSION = 1;
+/** @internal */
 declare const FRAGMENT_VERSION_HEADER = "x-payload-fragment-version";
+/** @internal */
 interface FragmentRequestBody {
     /** Registry id of the boundary (`data-payload-fragment`). */
     readonly fragment: string;
@@ -294,6 +338,7 @@ interface FragmentRequestBody {
     /** The unsaved form state as the admin posted it, after the runtime's merge. */
     readonly fields: Readonly<Record<string, unknown>>;
 }
+/** @internal */
 interface FragmentResponseBody {
     /** The boundary's new inner HTML. */
     readonly html: string;
@@ -310,9 +355,9 @@ interface FragmentResponseBody {
         readonly durationMs?: number;
     };
 }
-/** Shape check for a request body; `null` when it is not one. */
+/** Shape check for a request body; `null` when it is not one. @internal */
 declare function parseFragmentRequest(value: unknown): FragmentRequestBody | null;
-/** Shape check for a response body; `null` when it is not one. */
+/** Shape check for a response body; `null` when it is not one. @internal */
 declare function parseFragmentResponse(value: unknown): FragmentResponseBody | null;
 
 /**
@@ -325,9 +370,10 @@ declare function parseFragmentResponse(value: unknown): FragmentResponseBody | n
  * The strategy the runtime drives, built on a per-boundary handler: plan the
  * boundaries, render each, morph a success, patch a failure. A late or
  * aborted render is dropped, never applied.
+ * @internal
  */
 declare function fragmentStrategyFrom(handler: FragmentHandler): FragmentStrategy;
 /** The strategy for a fragment endpoint: hand it to the runtime as `strategies.fragment`. */
 declare function createFragmentStrategy(options: FragmentStrategyOptions): FragmentStrategy;
 
-export { DIAGNOSTIC_CODES, type DiagnosticCode, FRAGMENT_ATTRIBUTE, FRAGMENT_KEY_ATTRIBUTE, FRAGMENT_PROTOCOL_VERSION, FRAGMENT_VERSION_HEADER, type FragmentBoundary, type FragmentContext, type FragmentHandler, type FragmentOutcome, type FragmentReport, type FragmentRequestBody, type FragmentResponseBody, type FragmentStrategy, type FragmentStrategyOptions, ROUTE_REFRESH_HEADER, type RouteContext, type RouteStrategy, type RouteStrategyOptions, type StrategyHandlers, type StrategyRequest, type UpdateSource, collectFragmentBoundaries, createFragmentHandler, createFragmentStrategy, createRouteStrategy, describeBoundary, fragmentStrategyFrom, isRouteBound, parseFragmentRequest, parseFragmentResponse, resolveStrategy };
+export { DIAGNOSTIC_CODES, type DiagnosticCode, FRAGMENT_ATTRIBUTE, FRAGMENT_KEY_ATTRIBUTE, FRAGMENT_PROTOCOL_VERSION, FRAGMENT_VERSION_HEADER, type FragmentBoundary, type FragmentContext, type FragmentHandler, type FragmentOutcome, type FragmentReport, type FragmentRequestBody, type FragmentResponseBody, type FragmentStrategy, type FragmentStrategyOptions, ROUTE_REFRESH_HEADER, type RouteContext, type RouteOutcome, type RouteStrategy, type RouteStrategyOptions, type StrategyHandlers, type StrategyRequest, type UpdateSource, collectFragmentBoundaries, createFragmentHandler, createFragmentStrategy, createRouteStrategy, describeBoundary, fragmentStrategyFrom, isRouteBound, parseFragmentRequest, parseFragmentResponse, resolveStrategy };

package/dist/fragment.d.ts

@@ -5,7 +5,9 @@
  *
  * Browser-side reporting sites write the literal (`code: 'LP0603'`) rather than
  * reading it from this record: the frozen table would then ship in the inline
- * runtime for the sake of six characters. Server-side tools may import it.
+ * runtime for the sake of six characters — it did, 1 287 B in every page, for
+ * the one read Z6 left in the strategy runner, and `diagnostic-codes.test.ts`
+ * now holds the artifact free of it. Server-side tools may import it.
  */
 /**
  * Every diagnostic code the runtime can report, by name.
@@ -23,6 +25,8 @@ declare const DIAGNOSTIC_CODES: Readonly<{
     readonly ReferrerOnlyTrust: "LP0102";
     /** A plugin declares a runtime range this runtime does not satisfy; it was refused. */
     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. */
     readonly OrphanField: "LP0201";
     /** Owner scoping is on and the update names no document it could belong to. */
@@ -43,10 +47,24 @@ declare const DIAGNOSTIC_CODES: Readonly<{
     readonly StructuralUnstableKeys: "LP0406";
     /** A binding asks for a delivery strategy this release does not have; it is left unchanged. */
     readonly UnsupportedStrategy: "LP0407";
+    /** `data-payload-format` names a format the vocabulary does not contain; the default formatting was used instead. */
+    readonly UnknownValueFormat: "LP0408";
+    /** The strict sanitizer removed an attribute the 1.x `'compat'` policy kept. */
+    readonly SanitizerDroppedAttribute: "LP0409";
+    /** A Lexical block has no renderer; the markup the server rendered for it is kept instead. */
+    readonly UnrenderedBlockKept: "LP0410";
+    /** A patch cannot reach what the server would have drawn; `onUnfaithfulPatch` decided what happens next. */
+    readonly UnfaithfulPatch: "LP0411";
+    /** The first write to a date, number or checkbox binding replaced a different reading of the same value. */
+    readonly ServerFormatReplaced: "LP0412";
+    /** A Lexical block has no renderer, and the write could not keep the markup the server rendered for it; it is gone. */
+    readonly UnrenderedBlockLost: "LP0413";
     /** A message was rejected before it reached the update pipeline. */
     readonly MessageRejected: "LP0501";
     /** A preview token was rejected. */
     readonly TokenRejected: "LP0502";
+    /** A trusted origin sent a message this protocol version does not recognise. */
+    readonly ProtocolShapeUnknown: "LP0503";
     /** A consumer event handler threw. */
     readonly HandlerThrew: "LP0601";
     /** A consumer transform threw; the original value was kept. */
@@ -57,11 +75,13 @@ declare const DIAGNOSTIC_CODES: Readonly<{
     readonly StartupFailed: "LP0605";
     /** Sending the ready handshake failed. */
     readonly ReadyFailed: "LP0606";
+    /** The page declared hydration, but no React commit or Vue mount came within the cap; the runtime started without waiting. */
+    readonly HydrationWaitTimedOut: "LP0607";
     /** The audit found no runtime in a response that carried preview intent. */
     readonly AuditRuntimeMissing: "LP0701";
     /** The preview response declares no `frame-ancestors`. */
     readonly AuditNoFrameAncestors: "LP0702";
-    /** `X-Frame-Options` forbids framing, which no CSP can undo. */
+    /** `X-Frame-Options` forbids framing, which no CSP can undo; `SAMEORIGIN` forbids it from another origin only. */
     readonly AuditFrameOptionsBlocks: "LP0703";
     /** Binding attributes are served to anonymous visitors. */
     readonly AuditBindingsExposed: "LP0704";
@@ -81,10 +101,12 @@ declare const DIAGNOSTIC_CODES: Readonly<{
     readonly FragmentUnauthorized: "LP0803";
     /** A fragment response arrived for a revision that was already superseded and was discarded. */
     readonly FragmentSuperseded: "LP0804";
-    /** A route refresh was requested again for the same revision; the loop guard stopped it. */
+    /** A route refresh was refused: the loop guard, or the strategy's minimum interval. */
     readonly RouteRefreshLoop: "LP0805";
     /** A boundary asks for the fragment strategy but no fragment handler is configured; it is patched. */
     readonly FragmentStrategyUnavailable: "LP0806";
+    /** A revision changed a field with no binding; `onUnfaithfulPatch` refreshed the route. */
+    readonly UnboundChangeRefresh: "LP0807";
     /** 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. */
@@ -103,7 +125,7 @@ type DiagnosticCode = (typeof DIAGNOSTIC_CODES)[keyof typeof DIAGNOSTIC_CODES];
 
 /** What produced an update: the runtime's DOM patching, a server-rendered fragment, or a route refresh. */
 type UpdateSource = 'patch' | 'fragment' | 'route';
-/** Marks a server-rendered boundary; the value is the registry id the server may render. */
+/** Marks a server-rendered boundary; the value is the registry id the server may render. @internal */
 declare const FRAGMENT_ATTRIBUTE = "data-payload-fragment";
 /** One revision, as a strategy sees it, with the runtime capabilities it may use. */
 interface FragmentContext {
@@ -149,7 +171,21 @@ interface RouteContext {
     readonly signal: AbortSignal;
     readonly isCurrent: () => boolean;
     readonly log: (code: DiagnosticCode, detail: string) => void;
+    /**
+     * Ask to be run again in `delayMs`, once. A strategy that refuses a refresh
+     * because it is rate-limiting itself uses this: the window is a rate limit
+     * and not a filter, so what falls inside it still has to reach the preview.
+     * The runtime runs at most one such request, and only while the revision that
+     * asked is still the current one.
+     */
+    readonly retryAfter?: (delayMs: number) => void;
 }
+/**
+ * What one refresh did. `refused` is the strategy's own brake and not a
+ * failure — it is counted separately, because a number that mixes a planned
+ * pause with a broken request cannot be read.
+ */
+type RouteOutcome = 'refreshed' | 'failed' | 'refused' | 'superseded';
 /**
  * Whether a revision needs the whole route re-rendered, and how. After a
  * refresh the runtime rescans and re-applies the revision, so the unsaved
@@ -157,7 +193,7 @@ interface RouteContext {
  */
 interface RouteStrategy {
     readonly plan: (root: ParentNode, changedFields: ReadonlySet<string>) => boolean;
-    readonly refresh: (context: RouteContext) => Promise<'refreshed' | 'failed' | 'superseded'>;
+    readonly refresh: (context: RouteContext) => Promise<RouteOutcome>;
 }
 interface StrategyHandlers {
     readonly fragment?: FragmentStrategy;
@@ -167,13 +203,15 @@ interface StrategyHandlers {
  * Explicit `data-payload-strategy` wins; otherwise a binding inside a fragment
  * boundary belongs to the fragment, one in `<head>` to the route, the rest is
  * patched. An unknown explicit value resolves to `undefined` (LP0407).
+ * @internal
  */
 declare function resolveStrategy(element: Element): UpdateSource | undefined;
 
 /** Fragment boundaries: how a `data-payload-fragment` element is read and which ones an update touches. */
 
-/** Distinguishes several boundaries of one registry id; unique among siblings. */
+/** Distinguishes several boundaries of one registry id; unique among siblings. @internal */
 declare const FRAGMENT_KEY_ATTRIBUTE = "data-payload-fragment-key";
+/** @internal */
 interface FragmentBoundary {
     readonly element: Element;
     /** Registry id — never a path, module or function name. */
@@ -182,7 +220,7 @@ interface FragmentBoundary {
     /** Fields whose change re-renders the boundary; empty means any field. */
     readonly dependsOn: readonly string[];
 }
-/** One revision's request to a per-boundary handler. */
+/** One revision's request to a per-boundary handler. @internal */
 interface StrategyRequest {
     readonly revision: number;
     readonly receivedAt: number;
@@ -193,6 +231,7 @@ interface StrategyRequest {
     /** Aborted when a newer revision arrives or the runtime stops. */
     readonly signal: AbortSignal;
 }
+/** @internal */
 type FragmentOutcome = {
     readonly status: 'rendered';
     /** The boundary's new inner HTML. */
@@ -205,10 +244,11 @@ type FragmentOutcome = {
 } | {
     readonly status: 'superseded';
 };
-/** Renders one boundary for one revision. Must honour `request.signal`. */
+/** Renders one boundary for one revision. Must honour `request.signal`. @internal */
 type FragmentHandler = (request: StrategyRequest, boundary: FragmentBoundary) => Promise<FragmentOutcome>;
+/** @internal */
 declare function describeBoundary(element: Element): FragmentBoundary | null;
-/** The boundaries under `root` that `changedFields` touch; one inside an island is the island's business. */
+/** The boundaries under `root` that `changedFields` touch; one inside an island is the island's business. @internal */
 declare function collectFragmentBoundaries(root: ParentNode, changedFields: ReadonlySet<string>): readonly FragmentBoundary[];
 
 /**
@@ -236,22 +276,24 @@ interface FragmentStrategyOptions {
         readonly search: string;
     };
 }
+/** @internal */
 declare function createFragmentHandler(options: FragmentStrategyOptions): FragmentHandler;
 
 /**
  * The route strategy: when a revision touches what no smaller strategy can
- * render, fetch the route again and morph it in place. A refresh inside
- * `minIntervalMs` is refused as LP0805. See ADR 0011.
+ * render, ask the host's own router to re-render it, or else fetch the route
+ * again and morph it in place. A refresh inside `minIntervalMs` is refused as
+ * LP0805 and handed back for a trailing run. See ADR 0011.
  */
 
-/** Sent with every refresh so a server can tell a preview refresh from navigation. */
+/** Sent with every refresh so a server can tell a preview refresh from navigation. @internal */
 declare const ROUTE_REFRESH_HEADER = "x-payload-live-preview";
 interface RouteStrategyOptions {
     /** `fetch` to use; defaults to the global one. */
     readonly fetch?: (url: string, init?: RequestInit) => Promise<Response>;
     /** Per-refresh timeout. Default 8000 ms. */
     readonly timeoutMs?: number;
-    /** Shortest gap between two refreshes; one inside it is refused with LP0805. Default 1000 ms. */
+    /** Shortest gap between two refreshes; one inside it is refused with LP0805 and run when the gap closes. Default 1000 ms. */
     readonly minIntervalMs?: number;
     /** The document to refresh; defaults to `document`. */
     readonly document?: Document;
@@ -266,7 +308,7 @@ interface RouteStrategyOptions {
         readonly scrollTo: (x: number, y: number) => void;
     };
 }
-/** An explicit `data-payload-strategy="route"`, or a binding in `<head>`. */
+/** An explicit `data-payload-strategy="route"`, or a binding in `<head>`. @internal */
 declare function isRouteBound(element: Element): boolean;
 declare function createRouteStrategy(options?: RouteStrategyOptions): RouteStrategy;
 
@@ -275,9 +317,11 @@ declare function createRouteStrategy(options?: RouteStrategyOptions): RouteStrat
  * and what it answers. Both sides validate the shape; nothing on the wire
  * names code, paths or templates. See ADR 0011.
  */
-/** Bumped when the request or response shape changes incompatibly. */
+/** Bumped when the request or response shape changes incompatibly. @internal */
 declare const FRAGMENT_PROTOCOL_VERSION = 1;
+/** @internal */
 declare const FRAGMENT_VERSION_HEADER = "x-payload-fragment-version";
+/** @internal */
 interface FragmentRequestBody {
     /** Registry id of the boundary (`data-payload-fragment`). */
     readonly fragment: string;
@@ -294,6 +338,7 @@ interface FragmentRequestBody {
     /** The unsaved form state as the admin posted it, after the runtime's merge. */
     readonly fields: Readonly<Record<string, unknown>>;
 }
+/** @internal */
 interface FragmentResponseBody {
     /** The boundary's new inner HTML. */
     readonly html: string;
@@ -310,9 +355,9 @@ interface FragmentResponseBody {
         readonly durationMs?: number;
     };
 }
-/** Shape check for a request body; `null` when it is not one. */
+/** Shape check for a request body; `null` when it is not one. @internal */
 declare function parseFragmentRequest(value: unknown): FragmentRequestBody | null;
-/** Shape check for a response body; `null` when it is not one. */
+/** Shape check for a response body; `null` when it is not one. @internal */
 declare function parseFragmentResponse(value: unknown): FragmentResponseBody | null;
 
 /**
@@ -325,9 +370,10 @@ declare function parseFragmentResponse(value: unknown): FragmentResponseBody | n
  * The strategy the runtime drives, built on a per-boundary handler: plan the
  * boundaries, render each, morph a success, patch a failure. A late or
  * aborted render is dropped, never applied.
+ * @internal
  */
 declare function fragmentStrategyFrom(handler: FragmentHandler): FragmentStrategy;
 /** The strategy for a fragment endpoint: hand it to the runtime as `strategies.fragment`. */
 declare function createFragmentStrategy(options: FragmentStrategyOptions): FragmentStrategy;
 
-export { DIAGNOSTIC_CODES, type DiagnosticCode, FRAGMENT_ATTRIBUTE, FRAGMENT_KEY_ATTRIBUTE, FRAGMENT_PROTOCOL_VERSION, FRAGMENT_VERSION_HEADER, type FragmentBoundary, type FragmentContext, type FragmentHandler, type FragmentOutcome, type FragmentReport, type FragmentRequestBody, type FragmentResponseBody, type FragmentStrategy, type FragmentStrategyOptions, ROUTE_REFRESH_HEADER, type RouteContext, type RouteStrategy, type RouteStrategyOptions, type StrategyHandlers, type StrategyRequest, type UpdateSource, collectFragmentBoundaries, createFragmentHandler, createFragmentStrategy, createRouteStrategy, describeBoundary, fragmentStrategyFrom, isRouteBound, parseFragmentRequest, parseFragmentResponse, resolveStrategy };
+export { DIAGNOSTIC_CODES, type DiagnosticCode, FRAGMENT_ATTRIBUTE, FRAGMENT_KEY_ATTRIBUTE, FRAGMENT_PROTOCOL_VERSION, FRAGMENT_VERSION_HEADER, type FragmentBoundary, type FragmentContext, type FragmentHandler, type FragmentOutcome, type FragmentReport, type FragmentRequestBody, type FragmentResponseBody, type FragmentStrategy, type FragmentStrategyOptions, ROUTE_REFRESH_HEADER, type RouteContext, type RouteOutcome, type RouteStrategy, type RouteStrategyOptions, type StrategyHandlers, type StrategyRequest, type UpdateSource, collectFragmentBoundaries, createFragmentHandler, createFragmentStrategy, createRouteStrategy, describeBoundary, fragmentStrategyFrom, isRouteBound, parseFragmentRequest, parseFragmentResponse, resolveStrategy };

package/dist/fragment.js

@@ -1,2 +1,2 @@
-var e="data-payload-island";function t(t){return"astro-island"===t.tagName.toLowerCase()||t.hasAttribute(e)}function n(t){return"patch"===t.getAttribute(e)}function isInsideIsland(e){let r=e;for(;null!==r;){if(t(r)&&!n(r))return!0;r=r.parentElement}return!1}function r(e){if(null==e)return[];const t=/* @__PURE__ */new Set,n=[];for(const r of e.split(/[\s,]+/)){const e=r.trim();0===e.length||t.has(e)||(t.add(e),n.push(e))}return n}var o="data-payload-fragment";function i(e){const t=e.getAttribute("data-payload-strategy");return null!==t&&t.length>0?"patch"===t||"fragment"===t||"route"===t?t:void 0:null!==function(e){return e.closest(`[${o}]`)}(e)?"fragment":null!==e.closest("head")?"route":"patch"}var a="data-payload-fragment-key";function s(e){const t=e.getAttribute(o);if(null===t||0===t.length)return null;const n=e.getAttribute(a);return{element:e,id:t,key:null===n||0===n.length?void 0:n,dependsOn:r(e.getAttribute("data-payload-depends"))}}function l(e,t){const n=[];for(const r of e.querySelectorAll(`[${o}]`)){const e=s(r);null===e||isInsideIsland(r)||e.dependsOn.length>0&&!e.dependsOn.some(e=>t.has(e))||n.push(e)}return n}var u=1,c="x-payload-fragment-version";function d(e,t){if(t>12||"object"!=typeof e||null===e)return t;let n=t;for(const r of Object.values(e))if(n=Math.max(n,d(r,t+1)),n>12)break;return n}function f(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}function g(e){if(!f(e))return null;const t=e.fragment;if("string"!=typeof t||!/^[a-z][a-z0-9-]{0,63}$/iu.test(t))return null;const n=e.key;if(void 0!==n&&("string"!=typeof n||n.length>128))return null;const r=e.route;if("string"!=typeof r||!r.startsWith("/")||r.length>2048)return null;const o=e.search;if("string"!=typeof o||o.length>4096||""!==o&&!o.startsWith("?"))return null;const i=e.revision;if("number"!=typeof i||!Number.isInteger(i)||i<0)return null;const a=[];for(const t of["locale","collectionSlug","globalSlug"]){const n=e[t];if(void 0!==n){if("string"!=typeof n||n.length>128)return null;a.push(n)}else a.push(void 0)}const[s,l,u]=a,c=e.fields;return!f(c)||d(c,0)>12?null:{fragment:t,..."string"==typeof n?{key:n}:{},route:r,search:o,revision:i,...void 0!==s?{locale:s}:{},...void 0!==l?{collectionSlug:l}:{},...void 0!==u?{globalSlug:u}:{},fields:c}}function m(e){if(!f(e))return null;const{html:t,boundary:n,revision:r,metadata:o}=e;return"string"!=typeof t?null:f(n)&&"string"==typeof n.id?void 0!==n.key&&"string"!=typeof n.key||"number"!=typeof r?null:f(o)&&"string"==typeof o.renderedAt&&"string"==typeof o.renderer?e:null:null}var h={status:"superseded"};function p(e,t){return{status:"failed",code:e,reason:t}}function y(e){const t=function(e){const t=()=>{throw new TypeError('createFragmentStrategy: endpoint must be a same-origin path starting with "/"')};if(("string"!=typeof e||!e.startsWith("/")||e.startsWith("//")||e.includes("\\"))&&t(),"undefined"!=typeof location){let n;try{n=new URL(e,location.href)}catch{n=void 0}n?.origin!==location.origin&&t()}return e}(e.endpoint),n=e.timeoutMs??5e3,r=e.maxResponseBytes??524288,o=function(e){let t=0;const n=[];return async r=>{t<e?t+=1:await new Promise(e=>{n.push(e)});try{return await r()}finally{(()=>{const e=n.shift();void 0===e?t-=1:e()})()}}}(Math.max(1,e.maxConcurrent??4)),i=/* @__PURE__ */new Map;return(a,s)=>{const l=`${s.id} ${s.key??""} ${String(a.revision)}`,u=i.get(l);if(void 0!==u)return u;const d=o(()=>async function(o,i){const a=()=>o.signal.aborted;if(a())return h;const s=e.location??location,l=function(e){const t={};for(const[n,r]of Object.entries(e))void 0!==r&&(t[n]=r);return t}({fragment:i.id,key:i.key,route:s.pathname,search:s.search,revision:o.revision,locale:o.locale,collectionSlug:o.collectionSlug,globalSlug:o.globalSlug,fields:o.fields}),u=new AbortController,d=()=>{u.abort()};o.signal.addEventListener("abort",d,{once:!0});const f={timedOut:!1},g=setTimeout(()=>{f.timedOut=!0,u.abort()},n),y=e=>a()?h:f.timedOut?p("LP0801",`timeout after ${String(n)} ms`):p("LP0801",function(e){return e instanceof Error?e.message:String(e)}(e));try{let s;try{s=await(e.fetch??fetch)(t,{method:"POST",credentials:"same-origin",headers:{...e.headers,accept:"application/json","content-type":"application/json",[c]:String(1)},body:JSON.stringify(l),signal:u.signal})}catch(e){return y(e)}if(a())return h;if(401===s.status||403===s.status)return p("LP0803",`endpoint refused the preview (${String(s.status)})`);if(!s.ok)return p("LP0801",`endpoint answered ${String(s.status)}`);const d=s.headers.get("content-type")??"";if(!d.toLowerCase().startsWith("application/json"))return p("LP0802",`unexpected content type "${d}"`);if(Number(s.headers.get("content-length")??"0")>r)return p("LP0802","response exceeds the size limit");let g,b;try{g=await async function(e,t,n){const r=e.body;if("object"!=typeof(o=r)||null===o||"function"!=typeof o.getReader){const n=await e.text();return(new TextEncoder).encode(n).byteLength>t?null:n}var o;const i=r.getReader(),a=()=>{i.cancel().catch(()=>{})};n.addEventListener("abort",a,{once:!0});const s=new TextDecoder;let l="",u=0;try{for(;;){const{done:e,value:n}=await i.read();if(e)break;if(u+=n.byteLength,u>t)return a(),null;l+=s.decode(n,{stream:!0})}}finally{n.removeEventListener("abort",a)}return l+s.decode()}(s,r,u.signal)}catch(e){return y(e)}if(a())return h;if(f.timedOut)return p("LP0801",`timeout after ${String(n)} ms`);if(null===g)return p("LP0802","response exceeds the size limit");try{b=JSON.parse(g)}catch{return p("LP0802","response is not JSON")}const v=m(b);return null===v?p("LP0802","response has the wrong shape"):v.boundary.id!==i.id?p("LP0802","response is for another boundary"):v.revision!==o.revision?h:{status:"rendered",html:v.html,metadata:v.metadata}}finally{clearTimeout(g),o.signal.removeEventListener("abort",d)}}(a,s));i.set(l,d);const f=()=>{i.get(l)===d&&i.delete(l)};return d.then(f,f),d}}var b=Object.freeze({NoTrustedOrigin:"LP0101",ReferrerOnlyTrust:"LP0102",PluginIncompatible:"LP0103",OrphanField:"LP0201",UnattributableUpdate:"LP0202",VisibilityGateDeferred:"LP0301",UnsafeAttributeWrite:"LP0401",TextTargetHasChildren:"LP0402",MissingArrayTemplate:"LP0403",StructuralItemUnkeyed:"LP0404",StructuralDuplicateKey:"LP0405",StructuralUnstableKeys:"LP0406",UnsupportedStrategy:"LP0407",MessageRejected:"LP0501",TokenRejected:"LP0502",HandlerThrew:"LP0601",TransformThrew:"LP0602",RendererThrew:"LP0603",StartupFailed:"LP0605",ReadyFailed:"LP0606",AuditRuntimeMissing:"LP0701",AuditNoFrameAncestors:"LP0702",AuditFrameOptionsBlocks:"LP0703",AuditBindingsExposed:"LP0704",AuditGateThresholdExceeded:"LP0705",AuditUnownedBindings:"LP0706",AuditNoBindings:"LP0707",AuditNotAPage:"LP0708",FragmentRequestFailed:"LP0801",FragmentResponseInvalid:"LP0802",FragmentUnauthorized:"LP0803",FragmentSuperseded:"LP0804",RouteRefreshLoop:"LP0805",FragmentStrategyUnavailable:"LP0806",V2ReadinessGap:"LP0709",RuntimeOnPublicPage:"LP0710"}),v="data-payload-owned",L=/* @__PURE__ */new Set(["open","value","checked","selected"]);function P(e,t){for(const n of t.keyAttributes){const t=e.getAttribute(n);if(null!==t&&t.length>0)return`${n}=${t}`}}function A(t){if(t.tagName.toLowerCase().includes("-"))return!0;if(t.hasAttribute(e)||t.hasAttribute(v))return!0;const n=t.getAttribute("contenteditable");return null!==n&&"false"!==n}function S(e,t,n){if(!function(e,t){return e.tagName===t.tagName&&e.namespaceURI===t.namespaceURI&&!A(e)&&!A(t)}(e,t))return t;const r=function(e){const t=e.ownerDocument.activeElement;if(!(t instanceof HTMLElement&&e.contains(t)))return null;return{element:t,selection:t instanceof HTMLInputElement||t instanceof HTMLTextAreaElement?[t.selectionStart,t.selectionEnd]:null}}(e);return function(e,t){for(const n of Array.from(e.attributes))t.hasAttribute(n.name)||L.has(n.name.toLowerCase())||e.removeAttribute(n.name);for(const n of Array.from(t.attributes))e.getAttribute(n.name)!==n.value&&e.setAttribute(n.name,n.value)}(e,t),!0!==n.retainChildrenOf?.(e,t)&&function(e,t,n){const r=function(e,t){const n=/* @__PURE__ */new Map;let r;for(const o of Array.from(e.children)){const e=P(o,t);void 0!==e&&(n.has(e)?r??=e.slice(e.indexOf("=")+1):n.set(e,o))}return void 0!==r&&t.onDuplicateKey?.(e,r),n}(e,n),o=new Set(r.values()),i=Array.from(e.childNodes).filter(e=>!o.has(e)),a=/* @__PURE__ */new Set,s=/* @__PURE__ */new Set,l=Array.from(t.childNodes);let u=e.firstChild,c=0;for(let t=0;t<l.length;t+=1){const o=l[t];let d=null,f=o instanceof Element?P(o,n):void 0;if(void 0!==f&&s.has(f)&&(f=void 0),void 0!==f){s.add(f);const e=r.get(f);if(void 0!==e&&!a.has(e)&&(d=w(e,o,n)===e?e:null,null===d)){e.replaceWith(o),a.add(o),u=o.nextSibling;continue}}else{for(;c<i.length;){const r=i[c];if(c+=1,!a.has(r)){if(T(r,o)){d=w(r,o,n)===r?r:null,null===d&&(e.replaceChild(o,r),a.add(o),u=o.nextSibling);break}if(r instanceof Element){const n=l[t+1];if(!(o instanceof Element)||void 0!==n&&T(r,n)){c-=1;break}e.replaceChild(o,r),a.add(o),u=o.nextSibling;break}if(!(o instanceof Element)){e.replaceChild(o,r),a.add(o),u=o.nextSibling;break}}}if(null===d&&a.has(o))continue}const g=d??o;for(a.add(g);null!==u&&u!==g&&!a.has(u)&&E(u);)u=u.nextSibling;g!==u&&e.insertBefore(g,u),u=g.nextSibling}for(const t of Array.from(e.childNodes))a.has(t)||t.remove()}(e,t,n),function(e){if(null===e)return;const{element:t,selection:n}=e;if(t.ownerDocument.activeElement!==t&&t.isConnected)try{t.focus({preventScroll:!0});const[e,r]=n??[null,null];null!==e&&null!==r&&t.setSelectionRange(e,r)}catch{}}(r),e}function w(e,t,n){return e instanceof Element&&t instanceof Element?A(e)&&A(t)?e:S(e,t,n):(e.nodeValue!==t.nodeValue&&(e.nodeValue=t.nodeValue),e)}function E(e){return e.nodeType===Node.TEXT_NODE&&0===(e.nodeValue??"").trim().length}function T(e,t){return e.nodeType===t.nodeType&&(!(e instanceof Element&&t instanceof Element)||e.tagName===t.tagName&&e.namespaceURI===t.namespaceURI)}var k="data-payload-strategy",x="data-payload-field",N="x-payload-live-preview";function O(e){const t=e.getAttribute(k);return null!==t?"route"===t:null!==e.closest("head")}function $(e){const t=e.getAttribute(x),n=r(e.getAttribute("data-payload-depends"));return null===t||0===t.length?n:[t,...n]}function R(e){if("META"===e.tagName){const t=e.getAttribute("name")??e.getAttribute("property");return null===t?null:`meta:${t}`}return"LINK"===e.tagName&&"canonical"===e.getAttribute("rel")?"link:canonical":null}function C(e={}){const t=e.timeoutMs??8e3,n=e.minIntervalMs??1e3;let r=-1/0;return{plan(e,t){for(const n of e.querySelectorAll(`[${x}], [${k}="route"]`)){if(!O(n))continue;const e=$(n);if(0===e.length||e.some(e=>t.has(e)))return!0}return!1},async refresh(i){const s=Date.now();if(s-r<n)return i.log("LP0805",`route refresh for revision ${String(i.revision)} refused: the previous one was ${String(s-r)} ms ago`),"failed";r=s;const l=e.document??document,u=e.location??location,c=e.window??window,d=new AbortController,f=()=>{d.abort()};i.signal.addEventListener("abort",f,{once:!0});const g=setTimeout(()=>{d.abort()},t),m=e=>i.signal.aborted?"superseded":(i.log("LP0801",e instanceof Error?e.message:String(e)),"failed");try{let t;try{t=await(e.fetch??fetch)(u.href,{method:"GET",credentials:"same-origin",cache:"no-store",headers:{accept:"text/html",[N]:"route"},signal:d.signal})}catch(e){return m(e)}if(i.signal.aborted)return"superseded";if(!t.ok||!(t.headers.get("content-type")??"").includes("text/html"))return i.log("LP0802",`route answered ${String(t.status)} ${t.headers.get("content-type")??""}`),"failed";try{const e=await t.text();if(!i.isCurrent())return"superseded";const n=(new DOMParser).parseFromString(e,"text/html"),r=c.scrollX,s=c.scrollY;return function(e,t){t.title!==e.title&&(e.title=t.title);const n=/* @__PURE__ */new Map;for(const t of e.head.querySelectorAll("meta, link")){const e=R(t);null===e||n.has(e)||n.set(e,t)}const r=/* @__PURE__ */new Set;for(const o of t.head.querySelectorAll("meta, link")){const t=R(o);if(null===t)continue;r.add(t);const i=n.get(t);if(void 0!==i){if(!i.hasAttribute(v))for(const e of Array.from(o.attributes))i.getAttribute(e.name)!==e.value&&i.setAttribute(e.name,e.value)}else e.head.append(e.importNode(o,!0))}for(const[e,t]of n)r.has(e)||t.hasAttribute(v)||t.remove()}(l,n),S(l.body,n.body,{keyAttributes:["data-payload-key",a,o],retainChildrenOf:e=>e.hasAttribute(o)}),c.scrollTo(r,s),"refreshed"}catch(e){return m(e)}}finally{clearTimeout(g),i.signal.removeEventListener("abort",f)}}}}function M(e){return{plan:(e,t)=>l(e,t).map(e=>e.element),async render(t,n){const r={rendered:0,failed:0,superseded:0},o={revision:t.revision,receivedAt:t.receivedAt,fields:t.fields,locale:t.locale,collectionSlug:t.collectionSlug,globalSlug:t.globalSlug,signal:t.signal};return await Promise.all(n.map(async n=>{const i=s(n);if(null===i)return;let a;try{a=await e(o,i)}catch(e){a={status:"failed",code:"LP0801",reason:e instanceof Error?e.message:String(e)}}return t.isCurrent()&&"superseded"!==a.status?"rendered"===a.status?(t.morph(n,a.html),t.rendered(n,i.id,i.key),void(r.rendered+=1)):(t.failed(n,i.id,i.key,a.code,a.reason),t.isCurrent()&&t.patch(n),void(r.failed+=1)):(r.superseded+=1,void t.log("LP0804",`fragment "${i.id}" for revision ${String(o.revision)} discarded as superseded`))})),r}}}function I(e){return M(y(e))}export{b as DIAGNOSTIC_CODES,o as FRAGMENT_ATTRIBUTE,a as FRAGMENT_KEY_ATTRIBUTE,u as FRAGMENT_PROTOCOL_VERSION,c as FRAGMENT_VERSION_HEADER,N as ROUTE_REFRESH_HEADER,l as collectFragmentBoundaries,y as createFragmentHandler,I as createFragmentStrategy,C as createRouteStrategy,s as describeBoundary,M as fragmentStrategyFrom,O as isRouteBound,g as parseFragmentRequest,m as parseFragmentResponse,i as resolveStrategy};
+function e(e,t){const n=new AbortController;let r=!1;const o=()=>{n.abort()};e.addEventListener("abort",o,{once:!0});const i=setTimeout(()=>{r=!0,n.abort()},t);return{signal:n.signal,timedOut:()=>r,dispose:()=>{clearTimeout(i),e.removeEventListener("abort",o)}}}function t(e){return e instanceof Error?e.message:String(e)}var n="data-payload-island";function r(e){return function(e){return"astro-island"===e.tagName.toLowerCase()||e.hasAttribute(n)}(e)&&!("patch"===e.getAttribute(n))}function isInsideIsland(e){let t=e;for(;null!==t;){if(r(t))return!0;t=t.parentElement}return!1}function o(e){if(null==e)return[];const t=/* @__PURE__ */new Set,n=[];for(const r of e.split(/[\s,]+/)){const e=r.trim();0===e.length||t.has(e)||(t.add(e),n.push(e))}return n}var i="data-payload-fragment";function a(e){const t=e.getAttribute("data-payload-strategy");return null!==t&&t.length>0?"patch"===t||"fragment"===t||"route"===t?t:void 0:null!==function(e){return e.closest(`[${i}]`)}(e)?"fragment":null!==e.closest("head")?"route":"patch"}var s="data-payload-fragment-key";function l(e){const t=e.getAttribute(i);if(null===t||0===t.length)return null;const n=e.getAttribute(s);return{element:e,id:t,key:null===n||0===n.length?void 0:n,dependsOn:o(e.getAttribute("data-payload-depends"))}}function u(e,t){const n=[];for(const r of e.querySelectorAll(`[${i}]`)){const e=l(r);null===e||isInsideIsland(r)||e.dependsOn.length>0&&!e.dependsOn.some(e=>t.has(e))||n.push(e)}return n}var c=1,d="x-payload-fragment-version";function f(e,t){if(t>12||"object"!=typeof e||null===e)return t;let n=t;for(const r of Object.values(e))if(n=Math.max(n,f(r,t+1)),n>12)break;return n}function g(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}function h(e){if(!g(e))return null;const t=e.fragment;if("string"!=typeof t||!/^[a-z][a-z0-9-]{0,63}$/iu.test(t))return null;const n=e.key;if(void 0!==n&&("string"!=typeof n||n.length>128))return null;const r=e.route;if("string"!=typeof r||!r.startsWith("/")||r.length>2048)return null;const o=e.search;if("string"!=typeof o||o.length>4096||""!==o&&!o.startsWith("?"))return null;const i=e.revision;if("number"!=typeof i||!Number.isInteger(i)||i<0)return null;const a=[];for(const t of["locale","collectionSlug","globalSlug"]){const n=e[t];if(void 0!==n){if("string"!=typeof n||n.length>128)return null;a.push(n)}else a.push(void 0)}const[s,l,u]=a,c=e.fields;return!g(c)||f(c,0)>12?null:{fragment:t,..."string"==typeof n?{key:n}:{},route:r,search:o,revision:i,...void 0!==s?{locale:s}:{},...void 0!==l?{collectionSlug:l}:{},...void 0!==u?{globalSlug:u}:{},fields:c}}function p(e){if(!g(e))return null;const{html:t,boundary:n,revision:r,metadata:o}=e;return"string"!=typeof t?null:g(n)&&"string"==typeof n.id?void 0!==n.key&&"string"!=typeof n.key||"number"!=typeof r?null:g(o)&&"string"==typeof o.renderedAt&&"string"==typeof o.renderer?e:null:null}var m={status:"superseded"};function y(e,t){return{status:"failed",code:e,reason:t}}function b(n){const r=function(e){const t=()=>{throw new TypeError('createFragmentStrategy: endpoint must be a same-origin path starting with "/"')};if(("string"!=typeof e||!e.startsWith("/")||e.startsWith("//")||e.includes("\\"))&&t(),"undefined"!=typeof location){let n;try{n=new URL(e,location.href)}catch{n=void 0}n?.origin!==location.origin&&t()}return e}(n.endpoint),o=n.timeoutMs??5e3,i=n.maxResponseBytes??524288,a=function(e){let t=0;const n=[];return async r=>{t<e?t+=1:await new Promise(e=>{n.push(e)});try{return await r()}finally{(()=>{const e=n.shift();void 0===e?t-=1:e()})()}}}(Math.max(1,n.maxConcurrent??4)),s=/* @__PURE__ */new Map;return(l,u)=>{const c=`${u.id} ${u.key??""} ${String(l.revision)}`,f=s.get(c);if(void 0!==f)return f;const g=a(()=>async function(a,s){const l=()=>a.signal.aborted;if(l())return m;const u=n.location??location,c=function(e){const t={};for(const[n,r]of Object.entries(e))void 0!==r&&(t[n]=r);return t}({fragment:s.id,key:s.key,route:u.pathname,search:u.search,revision:a.revision,locale:a.locale,collectionSlug:a.collectionSlug,globalSlug:a.globalSlug,fields:a.fields}),f=e(a.signal,o),g=e=>l()?m:f.timedOut()?y("LP0801",`timeout after ${String(o)} ms`):y("LP0801",t(e));try{let e;try{e=await(n.fetch??fetch)(r,{method:"POST",credentials:"same-origin",headers:{...n.headers,accept:"application/json","content-type":"application/json",[d]:String(1)},body:JSON.stringify(c),signal:f.signal})}catch(e){return g(e)}if(l())return m;if(401===e.status||403===e.status)return y("LP0803",`endpoint refused the preview (${String(e.status)})`);if(!e.ok)return y("LP0801",`endpoint answered ${String(e.status)}`);const t=e.headers.get("content-type")??"";if(!t.toLowerCase().startsWith("application/json"))return y("LP0802",`unexpected content type "${t}"`);if(Number(e.headers.get("content-length")??"0")>i)return y("LP0802","response exceeds the size limit");let u,h;try{u=await async function(e,t,n){const r=e.body;if("object"!=typeof(o=r)||null===o||"function"!=typeof o.getReader){const n=await e.text();return(new TextEncoder).encode(n).byteLength>t?null:n}var o;const i=r.getReader(),a=()=>{i.cancel().catch(()=>{})};n.addEventListener("abort",a,{once:!0});const s=new TextDecoder;let l="",u=0;try{for(;;){const{done:e,value:n}=await i.read();if(e)break;if(u+=n.byteLength,u>t)return a(),null;l+=s.decode(n,{stream:!0})}}finally{n.removeEventListener("abort",a)}return l+s.decode()}(e,i,f.signal)}catch(e){return g(e)}if(l())return m;if(f.timedOut())return y("LP0801",`timeout after ${String(o)} ms`);if(null===u)return y("LP0802","response exceeds the size limit");try{h=JSON.parse(u)}catch{return y("LP0802","response is not JSON")}const b=p(h);return null===b?y("LP0802","response has the wrong shape"):b.boundary.id!==s.id?y("LP0802","response is for another boundary"):b.revision!==a.revision?m:{status:"rendered",html:b.html,metadata:b.metadata}}finally{f.dispose()}}(l,u));s.set(c,g);const h=()=>{s.get(c)===g&&s.delete(c)};return g.then(h,h),g}}var v=Object.freeze({NoTrustedOrigin:"LP0101",ReferrerOnlyTrust:"LP0102",PluginIncompatible:"LP0103",ProfileFeatureOmitted:"LP0104",OrphanField:"LP0201",UnattributableUpdate:"LP0202",VisibilityGateDeferred:"LP0301",UnsafeAttributeWrite:"LP0401",TextTargetHasChildren:"LP0402",MissingArrayTemplate:"LP0403",StructuralItemUnkeyed:"LP0404",StructuralDuplicateKey:"LP0405",StructuralUnstableKeys:"LP0406",UnsupportedStrategy:"LP0407",UnknownValueFormat:"LP0408",SanitizerDroppedAttribute:"LP0409",UnrenderedBlockKept:"LP0410",UnfaithfulPatch:"LP0411",ServerFormatReplaced:"LP0412",UnrenderedBlockLost:"LP0413",MessageRejected:"LP0501",TokenRejected:"LP0502",ProtocolShapeUnknown:"LP0503",HandlerThrew:"LP0601",TransformThrew:"LP0602",RendererThrew:"LP0603",StartupFailed:"LP0605",ReadyFailed:"LP0606",HydrationWaitTimedOut:"LP0607",AuditRuntimeMissing:"LP0701",AuditNoFrameAncestors:"LP0702",AuditFrameOptionsBlocks:"LP0703",AuditBindingsExposed:"LP0704",AuditGateThresholdExceeded:"LP0705",AuditUnownedBindings:"LP0706",AuditNoBindings:"LP0707",AuditNotAPage:"LP0708",FragmentRequestFailed:"LP0801",FragmentResponseInvalid:"LP0802",FragmentUnauthorized:"LP0803",FragmentSuperseded:"LP0804",RouteRefreshLoop:"LP0805",FragmentStrategyUnavailable:"LP0806",UnboundChangeRefresh:"LP0807",V2ReadinessGap:"LP0709",RuntimeOnPublicPage:"LP0710"}),L="data-payload-owned",P=/* @__PURE__ */new Set(["open","value","checked","selected"]);function A(e,t){for(const n of t.keyAttributes){const t=e.getAttribute(n);if(null!==t&&t.length>0)return`${n}=${t}`}}function S(e){if(e.tagName.toLowerCase().includes("-"))return!0;if(e.hasAttribute(n)||e.hasAttribute(L))return!0;const t=e.getAttribute("contenteditable");return null!==t&&"false"!==t}function w(e,t,n){if(!function(e,t){return e.tagName===t.tagName&&e.namespaceURI===t.namespaceURI&&!S(e)&&!S(t)}(e,t))return t;const r=function(e){const t=e.ownerDocument.activeElement;if(!(t instanceof HTMLElement&&e.contains(t)))return null;return{element:t,selection:t instanceof HTMLInputElement||t instanceof HTMLTextAreaElement?[t.selectionStart,t.selectionEnd]:null}}(e);return function(e,t){for(const n of Array.from(e.attributes))t.hasAttribute(n.name)||P.has(n.name.toLowerCase())||e.removeAttribute(n.name);for(const n of Array.from(t.attributes))e.getAttribute(n.name)!==n.value&&e.setAttribute(n.name,n.value)}(e,t),!0!==n.retainChildrenOf?.(e,t)&&function(e,t,n){const r=function(e,t){const n=/* @__PURE__ */new Map;let r;for(const o of Array.from(e.children)){const e=A(o,t);void 0!==e&&(n.has(e)?r??=e.slice(e.indexOf("=")+1):n.set(e,o))}return void 0!==r&&t.onDuplicateKey?.(e,r),n}(e,n),o=new Set(r.values()),i=Array.from(e.childNodes).filter(e=>!o.has(e)),a=/* @__PURE__ */new Set,s=/* @__PURE__ */new Set,l=Array.from(t.childNodes);let u=e.firstChild,c=0;for(let t=0;t<l.length;t+=1){const o=l[t];let d=null,f=o instanceof Element?A(o,n):void 0;if(void 0!==f&&s.has(f)&&(f=void 0),void 0!==f){s.add(f);const e=r.get(f);if(void 0!==e&&!a.has(e)&&(d=k(e,o,n)===e?e:null,null===d)){e.replaceWith(o),a.add(o),u=o.nextSibling;continue}}else{for(;c<i.length;){const r=i[c];if(c+=1,!a.has(r)){if(x(r,o)){d=k(r,o,n)===r?r:null,null===d&&(e.replaceChild(o,r),a.add(o),u=o.nextSibling);break}if(r instanceof Element){const n=l[t+1];if(!(o instanceof Element)||void 0!==n&&x(r,n)){c-=1;break}e.replaceChild(o,r),a.add(o),u=o.nextSibling;break}if(!(o instanceof Element)){e.replaceChild(o,r),a.add(o),u=o.nextSibling;break}}}if(null===d&&a.has(o))continue}const g=d??o;for(a.add(g);null!==u&&u!==g&&!a.has(u)&&T(u);)u=u.nextSibling;g!==u&&e.insertBefore(g,u),u=g.nextSibling}for(const t of Array.from(e.childNodes))a.has(t)||t.remove()}(e,t,n),function(e){if(null===e)return;const{element:t,selection:n}=e;if(t.ownerDocument.activeElement!==t&&t.isConnected)try{t.focus({preventScroll:!0});const[e,r]=n??[null,null];null!==e&&null!==r&&t.setSelectionRange(e,r)}catch{}}(r),e}function k(e,t,n){return e instanceof Element&&t instanceof Element?S(e)&&S(t)?e:w(e,t,n):(e.nodeValue!==t.nodeValue&&(e.nodeValue=t.nodeValue),e)}function T(e){return e.nodeType===Node.TEXT_NODE&&0===(e.nodeValue??"").trim().length}function x(e,t){return e.nodeType===t.nodeType&&(!(e instanceof Element&&t instanceof Element)||e.tagName===t.tagName&&e.namespaceURI===t.namespaceURI)}var E="data-payload-strategy",O="data-payload-field",R="x-payload-live-preview";function N(e){const t=e.getAttribute(E);return null!==t?"route"===t:null!==e.closest("head")}function $(e){const t=e.getAttribute(O),n=o(e.getAttribute("data-payload-depends"));return null===t||0===t.length?n:[t,...n]}function U(e){if("META"===e.tagName){const t=e.getAttribute("name")??e.getAttribute("property");return null===t?null:`meta:${t}`}return"LINK"===e.tagName&&"canonical"===e.getAttribute("rel")?"link:canonical":null}function C(n={}){const r=n.timeoutMs??8e3,o=n.minIntervalMs??1e3;let a=-1/0;return{plan(e,t){for(const n of e.querySelectorAll(`[${O}], [${E}="route"]`)){if(!N(n))continue;const e=$(n);if(0===e.length||e.some(e=>t.has(e)))return!0}return!1},async refresh(l){const u=Date.now(),c=o-(u-a);if(c>0)return l.retryAfter?.(c),l.log("LP0805",`route refresh for revision ${String(l.revision)} refused: the previous one was ${String(u-a)} ms ago`),"refused";a=u;const d=n.document??document,f=n.location??location,g=n.window??window,h=e(l.signal,r),p=e=>{if(l.signal.aborted)return"superseded";const n=h.timedOut()?`route refresh timed out after ${String(r)} ms`:t(e);return l.log("LP0801",n),"failed"};try{const e=("undefined"==typeof window?void 0:window)?.__livePreviewRouteRefresh;if(void 0!==e){try{await e()}catch(e){return p(e)}return l.isCurrent()?"refreshed":"superseded"}let t;try{t=await(n.fetch??fetch)(f.href,{method:"GET",credentials:"same-origin",cache:"no-store",headers:{accept:"text/html",[R]:"route"},signal:h.signal})}catch(e){return p(e)}if(l.signal.aborted)return"superseded";if(!t.ok||!(t.headers.get("content-type")??"").includes("text/html"))return l.log("LP0802",`route answered ${String(t.status)} ${t.headers.get("content-type")??""}`),"failed";try{const e=await t.text();if(!l.isCurrent())return"superseded";const n=(new DOMParser).parseFromString(e,"text/html"),r=g.scrollX,o=g.scrollY;return function(e,t){t.title!==e.title&&(e.title=t.title);const n=/* @__PURE__ */new Map;for(const t of e.head.querySelectorAll("meta, link")){const e=U(t);null===e||n.has(e)||n.set(e,t)}const r=/* @__PURE__ */new Set;for(const o of t.head.querySelectorAll("meta, link")){const t=U(o);if(null===t)continue;r.add(t);const i=n.get(t);if(void 0!==i){if(!i.hasAttribute(L))for(const e of Array.from(o.attributes))i.getAttribute(e.name)!==e.value&&i.setAttribute(e.name,e.value)}else e.head.append(e.importNode(o,!0))}for(const[e,t]of n)r.has(e)||t.hasAttribute(L)||t.remove()}(d,n),w(d.body,n.body,{keyAttributes:["data-payload-key",s,i],retainChildrenOf:e=>e.hasAttribute(i)}),g.scrollTo(r,o),"refreshed"}catch(e){return p(e)}}finally{h.dispose()}}}}function F(e){return{plan:(e,t)=>u(e,t).map(e=>e.element),async render(n,r){const o={rendered:0,failed:0,superseded:0},i={revision:n.revision,receivedAt:n.receivedAt,fields:n.fields,locale:n.locale,collectionSlug:n.collectionSlug,globalSlug:n.globalSlug,signal:n.signal};return await Promise.all(r.map(async r=>{const a=l(r);if(null===a)return;let s;try{s=await e(i,a)}catch(e){s={status:"failed",code:"LP0801",reason:t(e)}}return n.isCurrent()&&"superseded"!==s.status?"rendered"===s.status?(n.morph(r,s.html),n.rendered(r,a.id,a.key),void(o.rendered+=1)):(n.failed(r,a.id,a.key,s.code,s.reason),n.isCurrent()&&n.patch(r),void(o.failed+=1)):(o.superseded+=1,void n.log("LP0804",`fragment "${a.id}" for revision ${String(i.revision)} discarded as superseded`))})),o}}}function M(e){return F(b(e))}export{v as DIAGNOSTIC_CODES,i as FRAGMENT_ATTRIBUTE,s as FRAGMENT_KEY_ATTRIBUTE,c as FRAGMENT_PROTOCOL_VERSION,d as FRAGMENT_VERSION_HEADER,R as ROUTE_REFRESH_HEADER,u as collectFragmentBoundaries,b as createFragmentHandler,M as createFragmentStrategy,C as createRouteStrategy,l as describeBoundary,F as fragmentStrategyFrom,N as isRouteBound,h as parseFragmentRequest,p as parseFragmentResponse,a as resolveStrategy};
 //# sourceMappingURL=fragment.js.map