@nifrajs/web 5.5.1 → 5.6.0

package/dist/islands.js

@@ -1,24 +1,36 @@
 /**
- * @nifrajs/web/islands - the framework-agnostic islands client runtime.
+ * @nifrajs/web/islands - the islands client runtime: interactivity for server-rendered pages without a
+ * framework runtime.
  *
- * An "island" is a server-rendered `<nifra-island>` element whose interactivity is mounted by a small
- * **plain-DOM** enhancer instead of a framework runtime. On a route that opts out of full-document
- * hydration (`export const hydrate = false`), the page ships **zero** framework JS; only the island
- * bundle (this runtime + your enhancers) loads. This variant ships ~99% less client JS than full
- * React hydration on a mostly-static page - the framework runtime is the cost, and islands skip it
- * entirely here.
+ * An island is a server-rendered element marked `data-island="<id>"`. Its interactivity is mounted by
+ * an enhancer instead of hydration, so on a route with `export const hydrate = false` the page ships
+ * no framework JS; only the island bundle (this runtime + your enhancers) loads via `islandScripts`.
  *
- * Server side: render the marker with `@nifrajs/web-react`'s `<Island>` (or any framework's host element
- * `<nifra-island data-id data-strategy data-props>`). Props are JSON-encoded inline in `data-props`
- * (attribute-escaped by the framework) - no central registry, so concurrent SSR renders never share
- * state. Client side: bundle one entry that calls `mountIslands({ <id>: enhancer })` and load it via
- * the route's `islandScripts`.
+ * Two tiers, one mount:
+ *   - `defineIsland((el, props) => cleanup)` - plain DOM code. The default.
+ *   - `bindIsland(({ state, onDispose }) => handlers)` - signals the markup binds by name through a
+ *     closed set of `data-bind-*` attributes. No expression language: names only.
+ * `signal`/`computed`/`effect`, a keyed `bindList` and an async `resource` work inside either tier;
+ * whatever an enhancer creates stops when its island unmounts.
+ *
+ * Server side: `<div data-island="counter" data-island-props="${islandProps({ start: 0 })}">`, or
+ * `@nifrajs/web-react`'s `<Island>`. Optional `data-island-strategy` (`load` | `idle` | `visible` |
+ * `media`, with `data-island-media`). Props travel as JSON in the attribute - no central registry, so
+ * concurrent SSR renders never share state. Nothing inside a `data-island-ignore` element mounts or
+ * binds: render user HTML there.
  */
-import { MAX_MEDIA_QUERY_LENGTH, scheduleTrigger, } from "@nifrajs/island-trigger";
-export { MAX_MEDIA_QUERY_LENGTH, scheduleTrigger };
+import { bindScope } from "./internal/island-bindings.js";
+import { mountIsland } from "./internal/island-mount.js";
+import { owned } from "./internal/island-owner.js";
+import { signal } from "./internal/island-signals.js";
+import { PAGE_HIDE_EVENT, PAGE_SHOW_EVENT } from "./internal/page-events.js";
+export { MAX_MEDIA_QUERY_LENGTH, scheduleTrigger, } from "@nifrajs/island-trigger";
+export { bindList, } from "./internal/island-list.js";
+export { resource } from "./internal/island-resource.js";
+export { batch, computed, effect, signal, untrack, } from "./internal/island-signals.js";
 /**
  * Author a typed enhancer. Pure identity at runtime (zero cost, tree-shaken away) - its only job is
- * to pin the `data-props` shape so `el` and `props` are typed inside the body and the enhancer is
+ * to pin the props shape so `el` and `props` are typed inside the body and the enhancer is
  * assignable to `mountIslands`. Prefer this over an inline arrow whenever an island reads props:
  *
  *   const counter = defineIsland<{ start: number }>((el, props) => {
@@ -30,80 +42,128 @@ export { MAX_MEDIA_QUERY_LENGTH, scheduleTrigger };
  *   })
  *   mountIslands({ counter })
  *
- * The props type is a contract, not a validator - `data-props` is JSON authored by your own SSR, so
- * it is trusted framing, not user input. Keep the enhancer body imperative: read the DOM, wire
- * listeners, return cleanup. No hidden reactivity to get wrong.
+ * The props type is a contract, not a validator - `data-island-props` is JSON authored by your own
+ * SSR, so it is trusted framing, not user input. Keep the enhancer body imperative: read the DOM,
+ * wire listeners, return cleanup.
  */
 export function defineIsland(enhancer) {
     return enhancer;
 }
-/** Parse an island's inline `data-props` JSON; malformed/absent → `undefined` (never throws). */
-function readProps(el) {
-    const raw = el.dataset.props;
-    if (raw === undefined || raw === "")
-        return undefined;
-    try {
-        return JSON.parse(raw);
-    }
-    catch {
-        return undefined;
-    }
+const onPage = (type, el, callback) => {
+    if (typeof document === "undefined")
+        return () => { };
+    const listener = (event) => {
+        if (event.target instanceof Node && event.target.contains(el))
+            callback();
+    };
+    document.addEventListener(type, listener);
+    return () => document.removeEventListener(type, listener);
+};
+/**
+ * Run `callback` each time the `keepAlive` page `el` renders in is hidden behind another page, just
+ * before it leaves the document. An island in a kept page stays mounted, and its timers and window
+ * listeners keep running, while the page is hidden: pause them here. Returns its removal - hand it back
+ * as part of the enhancer's cleanup. Never runs outside a kept page.
+ *
+ *   const clock = defineIsland((el) => {
+ *     let timer = setInterval(tick, 1000)
+ *     const hide = onPageHide(el, () => clearInterval(timer))
+ *     const show = onPageShow(el, () => { timer = setInterval(tick, 1000) })
+ *     return () => { hide(); show(); clearInterval(timer) }
+ *   })
+ */
+export function onPageHide(el, callback) {
+    return onPage(PAGE_HIDE_EVENT, el, callback);
+}
+/** Run `callback` each time the `keepAlive` page `el` renders in is shown again; returns its removal. */
+export function onPageShow(el, callback) {
+    return onPage(PAGE_SHOW_EVENT, el, callback);
 }
 /**
- * Find every `<nifra-island data-id>` under `root` (default `document`) and enhance each with the
- * matching enhancer, honoring its `data-strategy`. An island whose `id` has no enhancer is left as
- * inert SSR HTML (forward-compatible). An enhancer that throws is isolated - it never blocks the
- * others (each island is independent). Returns a disposer that cancels pending triggers and runs every
- * enhancer's cleanup (call it on soft-nav teardown; harmless if your app never navigates).
+ * The binding tier: `setup` creates the island's state and returns the event handlers its markup
+ * names; the island's `data-bind-*` attributes then bind them.
+ *
+ *   data-bind-text="count"   data-bind-show="open"   data-bind-class="active:open"
+ *   data-bind-attr="aria-expanded:open"   data-bind-value="query"   data-bind-on="click:add"
+ *
+ * Attribute values are signal and handler names, never code; an unknown name warns once and the
+ * server-rendered content stays as it is. A binding belongs to its nearest island.
+ *
+ * A setup or binding that throws stops everything the island started before the error reaches
+ * `mountIslands`. On unmount every cleanup runs; one that throws is logged and the rest still run.
  */
-export function mountIslands(enhancers, options = {}) {
-    const root = options.root ?? document;
-    const disposers = [];
-    for (const el of root.querySelectorAll("nifra-island[data-id]")) {
-        const id = el.dataset.id;
-        if (id === undefined)
-            continue;
-        const enhancer = enhancers[id];
-        if (enhancer === undefined)
-            continue; // no enhancer for this id → leave it as inert SSR markup
-        const props = readProps(el);
-        const strategyAttr = el.dataset.strategy;
-        const strategy = strategyAttr === "idle" || strategyAttr === "visible" || strategyAttr === "load"
-            ? strategyAttr
-            : strategyAttr === "media" &&
-                el.dataset.media !== undefined &&
-                el.dataset.media.length > 0 &&
-                el.dataset.media.length <= MAX_MEDIA_QUERY_LENGTH
-                ? { media: el.dataset.media }
-                : strategyAttr === undefined
-                    ? "load"
-                    : undefined;
-        // Invalid media markers remain inert rather than silently becoming eager. Their SSR content stays
-        // usable, and untrusted HTML cannot turn an oversized query into an unexpected trigger.
-        if (strategy === undefined)
-            continue;
-        const run = () => {
-            try {
-                const cleanup = enhancer(el, props);
-                if (typeof cleanup === "function")
-                    disposers.push(cleanup);
-            }
-            catch (err) {
-                // One island's failure must not take down the others; surface it without throwing.
-                console.error(`[nifra/islands] enhancer "${id}" failed:`, err);
+export function bindIsland(setup) {
+    return (root, props) => {
+        const stops = [];
+        let live = true;
+        const seeded = typeof props === "object" && props !== null ? props : {};
+        // No prototype: a state key like `constructor` is an entry like any other.
+        const signals = Object.create(null);
+        const ctx = {
+            root,
+            props,
+            state(key, fallback) {
+                signals[key] ??= signal(Object.hasOwn(seeded, key) ? seeded[key] : fallback);
+                // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: each key's signal is created once, from this call's type
+                return signals[key];
+            },
+            onDispose: (fn) => {
+                if (live)
+                    stops.push(fn);
+                else
+                    fn();
+            },
+        };
+        const dispose = () => {
+            live = false;
+            for (let stop = stops.pop(); stop !== undefined; stop = stops.pop()) {
+                try {
+                    stop();
+                }
+                catch (err) {
+                    console.error("[nifra/islands] cleanup failed:", err);
+                }
             }
         };
-        disposers.push(scheduleTrigger(strategy, run, { target: el }));
+        try {
+            // Owned, so a binding whose first run throws is registered before it throws.
+            owned(stops, () => bindScope(root, { signals, handlers: setup(ctx) ?? {} }, stops));
+        }
+        catch (err) {
+            dispose();
+            throw err;
+        }
+        return dispose;
+    };
+}
+/**
+ * The `data-island-props` value for `props`: JSON. Emit it through an escaping renderer into a quoted
+ * attribute (`data-island-props="${...}"`): unquoted, a space in the JSON ends the value and the rest
+ * parses as attributes.
+ */
+export function islandProps(props) {
+    return JSON.stringify(props);
+}
+/**
+ * Find every `[data-island]` element under `root` (default `document`) and enhance each with the
+ * matching enhancer, honoring its `data-island-strategy`. An island whose id has no enhancer, or that
+ * is already mounted, is left alone, so calling again after a soft navigation mounts only new hosts.
+ * An enhancer that throws is isolated - it never blocks the others. Every effect, list binding and
+ * resource an enhancer creates is owned by its island. Returns a disposer that cancels pending
+ * triggers and tears down every island it mounted (call it on soft-nav teardown).
+ */
+export function mountIslands(
+// `never` admits an enhancer of any props type: each one's props are its own island's JSON.
+enhancers, options = {}) {
+    const disposers = [];
+    for (const el of (options.root ?? document).querySelectorAll("[data-island]:not([data-island-ignore],[data-island-ignore] *)")) {
+        const dispose = mountIsland(el, enhancers);
+        if (dispose !== undefined)
+            disposers.push(dispose);
     }
     return () => {
-        for (const dispose of disposers) {
-            try {
-                dispose();
-            }
-            catch {
-                // best-effort teardown - a failing cleanup must not block the rest
-            }
-        }
+        for (const dispose of disposers.splice(0))
+            dispose();
     };
 }
 /**

package/dist/islands.js.map

@@ -1 +1 @@
-{"version":3,"file":"islands.js","sourceRoot":"","sources":["../src/islands.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"islands.js","sourceRoot":"","sources":["../src/islands.ts"],"names":[],"mappings":"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"}

package/dist/isr.d.ts

@@ -1,3 +1,4 @@
+import { type InvalidationReport } from "./internal/invalidation.js";
 /** A cached SSR response - the bytes + metadata a {@link CacheStore} persists. */
 export interface CachedResponse {
     /** The rendered document (UTF-8 HTML, fully buffered). */
@@ -34,7 +35,9 @@ export interface CacheStore {
      * The current point in this store's purge order. `withISR` takes one before each render and hands it
      * back as {@link CachedResponse.fence}, and `set` skips that entry when its key or one of its tags
      * was purged after the point. Without it, a purge that lands while a page renders is undone when the
-     * render stores the page it built from data read before the purge.
+     * render stores the page it built from data read before the purge. A store whose purges reach other
+     * instances late must also check on read, as {@link KVCacheStore} does: `set` there cannot see a
+     * purge that has not arrived yet.
      */
     readonly fence?: () => number | Promise<number>;
 }
@@ -46,6 +49,10 @@ export declare function serializeISRTags(tags: readonly string[]): string | unde
 /** What a `revalidateTags` function is given: the URL and route params only, both already public. */
 export interface RevalidateTagsInput {
     readonly params: Readonly<Record<string, string>>;
+    /**
+     * The request's URL. On a partially prerendered route and its shared holes, the shell's: the
+     * configured origin, the path and the declared variations, never the visitor's Host or other query.
+     */
     readonly url: URL;
 }
 /**
@@ -132,7 +139,8 @@ export interface KVCacheStoreOptions {
  * binding) - the production-grade shared/durable store ISR wants: cached pages and on-demand purges
  * hold *across* worker instances (unlike the per-instance {@link MemoryCacheStore}). Entries serialize
  * to JSON; every read is validated before it's trusted (a malformed/version-skewed entry is treated as
- * a miss). Construct it in your Workers `fetch` from the binding: `new KVCacheStore(env.ISR_CACHE)`.
+ * a miss). Construct it in your Workers `fetch` from the binding: `new KVCacheStore(env.ISR_CACHE)`,
+ * and give `withISR` the `storeSecret` it signs these pages with.
  *
  * Cloudflare is the default, not a requirement: {@link KVNamespaceLike} is three structural methods,
  * so a Redis, Deno KV, or Upstash binding satisfies it (pass `minExpirationTtl` for their TTL floor).
@@ -142,17 +150,23 @@ export interface KVCacheStoreOptions {
 export declare class KVCacheStore implements CacheStore {
     private readonly kv;
     private readonly putOptions;
+    private readonly pathEpochOptions;
     constructor(kv: KVNamespaceLike, options?: KVCacheStoreOptions);
     get(key: string): Promise<CachedResponse | undefined>;
-    /** Wall-clock time, so purges on any instance order against it. KV is eventually consistent, so the
-     * fence holds only for purges this location has already seen. */
+    /** Wall-clock time, so purges on any instance order against it. KV is eventually consistent, so
+     * `set` refuses only purges this location has already seen; a page stored before a purge reached
+     * its location keeps the older epoch and reads as a miss once the purge arrives. */
     fence(): number;
     set(key: string, value: CachedResponse): Promise<void>;
-    /** Leaves a marker rather than removing the key, so `set` can refuse a render that began before
-     * the purge. The marker reads as a miss. */
+    /** Moves the path's epoch and leaves the page: a page stored under the old epoch reads as a miss,
+     * even one another location stored before this purge reached it, and `set` refuses a render begun
+     * before the purge. */
     delete(key: string): Promise<void>;
     invalidateTag(tag: string): Promise<void>;
     private tagKey;
+    /** The page key under a prefix, or its digest when that would pass KV's key limit. */
+    private pathKey;
+    private pathEpoch;
 }
 /** Minimal platform shape `withISR` needs - just `waitUntil` (edge runtimes extend the response
  * lifetime so background regeneration finishes). Off-edge it's absent and regen runs fire-and-forget. */
@@ -184,6 +198,19 @@ export declare function openCacheChannel(app: object): void;
 export declare function withoutCacheChannel(res: Response): Response;
 export interface ISROptions {
     readonly store: CacheStore;
+    /**
+     * Signs every page written to `store` and checks the signature on every read, so whoever else can
+     * write the store (another service on the same KV namespace, a leaked token) cannot hand visitors a
+     * page this app did not render. Required for every store but a {@link MemoryCacheStore}, whose
+     * pages never leave the process and stay unsigned. The same in every process, at least 32
+     * characters, and random: generate it, such as 32 random bytes as hex, since a guessable secret
+     * can be found from any signed page and then signs pages of its own. A page whose signature is
+     * missing or wrong reads as a miss and renders again, so a new secret only empties the cache. It
+     * cannot stop a store writer from deleting pages, or from putting back an older page this app
+     * stored for the same key. That page keeps its age: still within its freshness window, it is a hit
+     * until the window ends; past it, it serves stale and regenerates.
+     */
+    readonly storeSecret?: string;
     /** Default freshness window (**seconds**) for a cached page; older ⇒ stale (served, regenerated
      * behind). A route overrides it per-page via `export const revalidate` (surfaced as the
      * `x-nifra-isr-revalidate` response header). */
@@ -194,7 +221,10 @@ export interface ISROptions {
      * so host-routed apps do not share entries across tenants. Return `null` to bypass the cache for
      * this request (it goes straight to the app, uncached). Replaces `query` entirely. Under the default
      * key a request carrying `Authorization` or a cookie outside `anonymousCookies` never reads the
-     * store; a custom key takes that decision over, so include whatever identifies the visitor in it. */
+     * store; a custom key takes that decision over, so include whatever identifies the visitor in it.
+     * An action's `revalidate(paths)` keys each path with the action request's own headers, so it purges
+     * the variant that client reads; a variant keyed on another header value (another language) is not
+     * reached - tag those pages and revalidate the tag. */
     readonly key?: (req: Request) => string | null;
     /**
      * Cookie names that never change the page, such as a consent or analytics cookie. Under the default
@@ -217,10 +247,11 @@ export interface ISROptions {
      * fresh, and a draft render is never written to the store (it can't poison the public cache). */
     readonly draftSecret?: string;
     /**
-     * Called when a store call fails: it throws, rejects, or outlives {@link storeTimeoutMs}. The request
-     * is served without the cache either way - a failed read is a miss, a failed write still returns the
-     * rendered page, a failed regeneration keeps the stale entry - so a store outage never changes a
-     * status. Default: one `console.error` line per operation per minute, never naming the cache key.
+     * Called when a store call fails: it throws, rejects, or outlives {@link storeTimeoutMs}, or (op
+     * `"verify"`) a page it returns fails its {@link storeSecret} signature check. The request is served
+     * without the cache either way - a failed read is a miss, a failed write still returns the rendered
+     * page, a failed regeneration keeps the stale entry - so a store outage never changes a status.
+     * Default: one `console.error` line per operation per minute, never naming the cache key.
      */
     readonly onStoreError?: (error: unknown, info: {
         readonly op: ISRStoreOp;
@@ -230,9 +261,25 @@ export interface ISROptions {
      * the request; set it when the store is a network service.
      */
     readonly storeTimeoutMs?: number;
+    /**
+     * Caches below the pages whose entries carry the same tags, such as a `@nifrajs/cache` holding loader
+     * data. An action's `revalidate(paths, data, { tags })` invalidates them first, then this store, then
+     * publishes to live pages, then purges `cdn`; a cache that fails stops the rest, so no client reloads
+     * stale data.
+     */
+    readonly dataCaches?: readonly {
+        invalidateTag(tag: string): unknown;
+    }[];
+    /** A CDN an action's invalidation purges last (a `@nifrajs/web/cdn` provider). */
+    readonly cdn?: CdnPurgeTarget;
+    /**
+     * An action's invalidation that still failed after its retries; the action's own answer never
+     * changes. Default: one `console.error` line naming the operation id and stage.
+     */
+    readonly onInvalidationError?: (report: InvalidationReport) => void;
 }
 /** The store operation an {@link ISROptions.onStoreError} report is about. */
-export type ISRStoreOp = "get" | "set" | "delete" | "fence";
+export type ISRStoreOp = "get" | "set" | "delete" | "fence" | "verify";
 /** Which query parameters an ISR key carries - see {@link ISROptions.query}. */
 export type ISRQuery = "bypass" | "all" | readonly string[];
 /** The default key for a URL under a `query` policy, or `null` when the URL must bypass the cache. */
@@ -240,7 +287,7 @@ export declare const urlKeyOf: (query?: ISRQuery) => ((url: URL) => string | nul
 /**
  * Whether `res` may be stored by a shared cache and served to anyone requesting `req`'s URL: a
  * full-document `GET` 200 `text/html` with no Set-Cookie, no `private`/`no-store`, no `Vary` beyond
- * the data header, and, for a request carrying a cookie or Authorization or accepted by an
+ * the data/swap headers, and, for a request carrying a cookie or Authorization or accepted by an
  * authentication stage, an explicit `public`.
  * The one rule both `withISR` and `@nifrajs/web/cdn` cache by.
  */
@@ -303,6 +350,13 @@ export interface RevalidateEndpointOptions {
     readonly dataCaches?: readonly {
         invalidateTag(tag: string): unknown;
     }[];
+    /**
+     * The app's live runtime: a purge also tells live pages watching a purged tag to reload, after the
+     * caches and before the CDN. A publish that fails answers `502` with `origin: "done"`.
+     */
+    readonly live?: {
+        publish(...keys: string[]): Promise<void>;
+    };
 }
 /**
  * An **on-demand revalidation** (purge) endpoint - a `fetch` handler that drops cached pages by path

package/dist/isr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"isr.d.ts","sourceRoot":"","sources":["../src/isr.ts"],"names":[],"mappings":"AAaA,kFAAkF;AAClF,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAClD,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,sGAAsG;IACtG,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,gGAAgG;IAChG,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC;2FACuF;IACvF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACpC;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,4DAA4D;IAC5D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAA;IACrD,gDAAgD;IAChD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtD,sEAAsE;IACtE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClC,6FAA6F;IAC7F,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACvD;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CAChD;AAYD,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,SAAS,MAAM,EAAE,CAQpF;AAED,qGAAqG;AACrG,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,MAAM,EAAE,CAStE;AAED,uFAAuF;AACvF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAG5E;AAED,qGAAqG;AACrG,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACjD,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAA;CAClB;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,SAAS,MAAM,EAAE,GACjB;IAAE,IAAI,CAAC,KAAK,EAAE,mBAAmB,GAAG,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC,MAAM,CAAC,CAAA;AAInE;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,MAAM,GACd,SAAS,MAAM,EAAE,CAkBnB;AAED,MAAM,WAAW,uBAAuB;IACtC;+EAC2E;IAC3E,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;IACpC,qFAAqF;IACrF,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,UAAU;IACjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAGnB;IACH,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IAErD,OAAO,CAAC,KAAK,CAAI;IACjB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4B;IACvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4B;IAEvD,OAAO,CAAC,UAAU,CAAI;gBAEV,OAAO,GAAE,uBAA4B;IAejD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IA2BrD,KAAK,IAAI,MAAM;IAIf,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBtD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAazC,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,cAAc;CAUvB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,qGAAqG;IACrG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACxC,iEAAiE;IACjE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7F,wCAAwC;IACxC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B;;;;;;;;OAQG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACnC;AA0FD;;;;;;;;;;;GAWG;AACH,qBAAa,YAAa,YAAW,UAAU;IAC7C,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAiB;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiD;gBAEhE,EAAE,EAAE,eAAe,EAAE,OAAO,GAAE,mBAAwB;IA4B5D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAuB3D;qEACiE;IACjE,KAAK,IAAI,MAAM;IAIT,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB5D;gDAC4C;IACtC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/C,OAAO,CAAC,MAAM;CAGf;AAED;yGACyG;AACzG,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;CACzD;AAED,mGAAmG;AACnG,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;CAC1E;AAED;+FAC+F;AAC/F,eAAO,MAAM,iBAAiB,gBAAgB,CAAA;AAE9C,wEAAwE;AACxE,eAAO,MAAM,0BAA0B,qBAAqB,CAAA;AAE5D;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,2BAA2B,CAAA;AAE7D;4FAC4F;AAC5F,eAAO,MAAM,aAAa,EAAE,OAAO,MAA6C,CAAA;AAEhF,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAGlD;AAED,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,QAAQ,GAAG,QAAQ,CAQ3D;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B;;oDAEgD;IAChD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,6FAA6F;IAC7F,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,CAAA;IAC1B;;;;yGAIqG;IACrG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAA;IAC9C;;;;;OAKG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC7C;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAA;IACzB;;qGAEiG;IACjG,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAA;KAAE,KAAK,IAAI,CAAA;IACnF;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CACjC;AAED,8EAA8E;AAC9E,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAA;AA6B3D,gFAAgF;AAChF,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,MAAM,EAAE,CAAA;AAE3D,sGAAsG;AACtG,eAAO,MAAM,QAAQ,GAAI,QAAO,QAAmB,KAAG,CAAC,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,GAAG,IAAI,CAyBjF,CAAA;AAyDD;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,OAAO,EAAE,KAAK,QAAQ,KAAG,OAe7D,CAAA;AA6ED;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CACrB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,UAAU,GAClB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAuR7D;AAKD,oGAAoG;AACpG,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAA;IAC9C,wDAAwD;IACxD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,iFAAiF;IACjF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,oGAAoG;AACpG,MAAM,WAAW,cAAc;IAC7B,KAAK,CACH,MAAM,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,EACjF,QAAQ,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,eAAe,CAAC,CAAA;CAC5B;AAED,+FAA+F;AAC/F,eAAO,MAAM,oBAAoB,MAAM,CAAA;AACvC,eAAO,MAAM,mBAAmB,KAAe,CAAA;AAI/C,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,sEAAsE;IACtE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B;0GACsG;IACtG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,MAAM,CAAA;IACrD;;iCAE6B;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAA;IACzB;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,cAAc,CAAA;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS;QAAE,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,EAAE,CAAA;CACzE;AAQD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,GACjC,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAmH7D"}
+{"version":3,"file":"isr.d.ts","sourceRoot":"","sources":["../src/isr.ts"],"names":[],"mappings":"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"}