@xmachines/play-dom 2.1.1 → 3.0.0

package/dist/PlayRenderer.js

@@ -13,8 +13,58 @@
 import { watchSignal } from "@xmachines/play-signals";
 import { createAtom } from "@xstate/store";
 import { xstateStoreStateStore } from "@xmachines/json-render-xstate";
-import { createViewStoreLifecycle, refreshContextSubtree } from "@xmachines/play-actor";
+import { createReportGuard, createViewStoreLifecycle, refreshContextSubtree, } from "@xmachines/play-actor";
 import { createIncrementalRenderer } from "@xmachines/json-render-dom";
+/**
+ * What the report guard writes, and what it lets through.
+ *
+ * It CONTAINS a handler of the host that throws, exactly as the four framework renderers
+ * do. The five hold one rule, and a caller learns it one time: a handler of the host never
+ * defeats the containment. A host that must escalate raises the failure from a task of its
+ * own, which reaches the global handler of the page in every one of the five.
+ *
+ * It stands ABOVE the doc comment of the class, and so does every other declaration of
+ * this module: a declaration takes the comment block that stands directly before it, so a
+ * const or a function placed between that comment and the class takes the documentation
+ * of `PlayRenderer` with it, and the class reaches the generated reference with none.
+ */
+const GUARD_MESSAGES = {
+    noHandler: "[@xmachines/play-dom] PlayRenderer contained a failed rebuild of the view. " +
+        "Give an onError option to receive it.",
+    handlerThrew: "[@xmachines/play-dom] the onError handler of the host threw. " +
+        "PlayRenderer contained the failure of the view all the same.",
+};
+/**
+ * Runs one release of a caller, and it contains a failure of that release.
+ *
+ * Every release that the two teardown paths below run is CODE OF A CALLER: the
+ * `unsubscribe` of a store that the host gave, and the watch cleanups that the inner
+ * renderer registered. Each one can throw, and a throw must stop neither path.
+ *
+ * `resetFailedRebuild()` runs the releases of a FAILED rebuild, BEFORE the renderer
+ * contains the failure of the view. A throw there takes the containment down with it: the
+ * catch that called it reaches `contain()` never, so the failure of the view reaches no
+ * handler, the dead tree stays on the screen, and the failure of the release escapes in
+ * its place — which is both outcomes that the containment exists to prevent.
+ *
+ * `disconnect()` has no containment to defeat, and it has the same rule for a second
+ * reason: a throw from the first release skips every release after it, it skips the clear
+ * of the container, and it skips the reset of the identity. The renderer then holds a
+ * half teardown that no caller can complete.
+ *
+ * Each release therefore stands alone, and a failure of one goes to `console.error`.
+ */
+function releaseQuietly(release) {
+    if (!release)
+        return;
+    try {
+        release();
+    }
+    catch (releaseFailure) {
+        console.error("[@xmachines/play-dom] a release of PlayRenderer threw. " +
+            "The renderer completed the teardown all the same.", releaseFailure);
+    }
+}
 /**
  * PlayRenderer connects the `currentView` signal of an actor to the DOM renderer.
  *
@@ -65,6 +115,15 @@ export class PlayRenderer {
     actor;
     registry;
     options;
+    /**
+     * True from the start of `connect()` to the end of `disconnect()`.
+     *
+     * The watcher cannot answer this question. `connect()` installs it AFTER the
+     * synchronous first render, so a host that calls `connect()` again from the `onError`
+     * of that render finds no watcher, and a test of the watcher alone would skip the
+     * `disconnect()` and leave the guard of the abandoned connection alive for ever.
+     */
+    connected = false;
     unwatch = null;
     storeUnsubscribe = null;
     /**
@@ -89,6 +148,8 @@ export class PlayRenderer {
      */
     lastViewKey = undefined;
     currentStore = null;
+    /** The fallback element, built at the first moment that the renderer shows it. */
+    fallbackElement = null;
     /**
      * The shared coordinator of the store lifecycle, from @xmachines/play-actor. It
      * seeds the store again on a change of the viewKey, it refreshes /context in place
@@ -105,6 +166,27 @@ export class PlayRenderer {
      * call, which is rare but correct, changes no detached DOM tree.
      */
     alive = true;
+    /**
+     * The report guard, from @xmachines/play-actor.
+     *
+     * It blocks a reset that the host calls from INSIDE the report, and every reset once
+     * the renderer is disconnected. The five renderers share the one implementation.
+     *
+     * `alive` cannot answer the second half. A contained failure sets that flag to `false`
+     * and the next emission sets it back, because it guards the callback of the store
+     * subscription — a reset that a host keeps outlives both.
+     */
+    // It is NOT readonly: `disconnect()` disposes the guard, and `connect()` revives the
+    // renderer, so a reconnected renderer needs a guard that is not spent.
+    guard = createReportGuard(GUARD_MESSAGES);
+    /**
+     * The retry that every report of THIS connection hands the host.
+     *
+     * `connect()` builds one, beside the guard that it belongs to. The four framework
+     * renderers hand the host one reset for the life of the provider, and this field holds
+     * the same rule for the life of the connection.
+     */
+    retry = this.retryOf(this.guard);
     /**
      * @param container - The `HTMLElement` to render into. Each view transition clears it and fills it again.
      * @param actor     - The actor with the `currentView` signal. It must implement `Viewable`.
@@ -118,6 +200,8 @@ export class PlayRenderer {
      *   - `validationFunctions` — your own check functions. They are available at `ctx.ctx.validationFunctions`.
      *   - `navigate`            — the navigation callback. The renderer calls it for `onSuccess: { navigate: "..." }`.
      *   - `onRenderError`       — the `(error, name)` handler of a component render error and of an action handler rejection. It stops the `console.error` fallback.
+     *   - `onError`             — the `(error, reset)` handler of a failure of a complete rebuild. The renderer contains such a failure always, and this option says where the report goes.
+     *   - `fallback`            — the element to show for every null view, and after a contained failure.
      */
     constructor(container, actor, registry, options = {}) {
         this.container = container;
@@ -135,16 +219,55 @@ export class PlayRenderer {
      * renderer first.
      */
     connect() {
-        if (this.unwatch !== null)
+        if (this.connected)
             this.disconnect();
-        this.render(this.actor.currentView.get());
-        this.unwatch = watchSignal(this.actor.currentView, (view) => this.render(view));
+        this.connected = true;
+        const guard = createReportGuard(GUARD_MESSAGES);
+        this.guard = guard;
+        // ONE retry for the connection, as the four framework renderers hand the host one
+        // reset for the life of the provider. A retry built for each report gives a host
+        // that keys a Map on the callback one entry for each failure.
+        this.retry = this.retryOf(guard);
+        // The first render is SYNCHRONOUS, and it can reach `onError`. It needs no `try`: the
+        // renderer contains a failed rebuild, and the guard contains a handler of the host
+        // that throws, so this call returns for every view that a caller can give.
+        const seeded = this.actor.currentView.get();
+        this.render(seeded);
+        // A host that tears the renderer down from the handler — a fatal view, and the host
+        // gives up — calls `disconnect()` while this method still runs, and the line below
+        // would then hand the renderer a live watcher again: it renders into a container
+        // that the host released, and the watcher outlives the actor.
+        //
+        // A host that CONNECTS again from the handler reaches the same line. The `connected`
+        // flag above makes that call disconnect this connection first, so both hosts dispose
+        // the guard of THIS call. Ask that guard, and not the field: the field holds the
+        // guard of the connection that took the place of this one.
+        if (guard.blocked())
+            return;
+        this.unwatch = watchSignal(this.actor.currentView, (view) => {
+            this.render(view);
+        });
+        // The actor can hold ANOTHER view already. The render above is synchronous, and a
+        // host that REPAIRS the actor from the handler — a bad initial view, and the host
+        // sends a recovery event — moves the signal between the read and the line above.
+        // `watchSignal` seeds nothing, so the repaired view would wait for the next
+        // emission of the actor, and a screen that shows the fallback of a failure that the
+        // host repaired already would wait with it. Render the view that the actor holds
+        // NOW.
+        //
+        // This runs one time, and it loops for no host: a repair from THIS render reaches
+        // the watcher above, which is installed already.
+        const current = this.actor.currentView.get();
+        if (current !== seeded)
+            this.render(current);
     }
     /**
      * Stops the watch and clears the container.
      */
     disconnect() {
-        this.unwatch?.();
+        this.connected = false;
+        this.guard.dispose();
+        releaseQuietly(this.unwatch);
         this.unwatch = null;
         // Set the refs to null first. A rerender callback that is still in flight therefore
         // sees null, and it stops.
@@ -159,9 +282,10 @@ export class PlayRenderer {
         // Set alive = false before the storeUnsub() call. A synchronous rerender callback
         // from inside unsubscribe() therefore returns at once.
         this.alive = false;
-        storeUnsub?.();
+        // See releaseQuietly: a throw of one release must skip none of the work below it.
+        releaseQuietly(storeUnsub);
         for (const cleanup of watchCleanups)
-            cleanup();
+            releaseQuietly(cleanup);
         this.container.replaceChildren();
         // The rule of the lifetime: the store that stays alive dies with the connection.
         this.lastViewKey = undefined;
@@ -195,7 +319,16 @@ export class PlayRenderer {
             this.lastViewKey === view.viewKey &&
             this.currentStore !== null &&
             this.storeUnsubscribe !== null) {
-            refreshContextSubtree(this.currentStore, view);
+            // The fast path reads `spec.state` too, so it fails exactly as a rebuild does.
+            // It sat OUTSIDE the try below, so a stream that keeps its viewKey and emits a
+            // spec with an accessor that throws escaped the callback of watchSignal
+            // uncontained, with the stale tree still on the screen.
+            try {
+                refreshContextSubtree(this.currentStore, view);
+            }
+            catch (error) {
+                this.failView(error);
+            }
             return;
         }
         this.alive = true;
@@ -204,9 +337,13 @@ export class PlayRenderer {
         // callback sees a live storeUnsubscribe, and it enters the rerender path again with
         // an old view and an old store.
         // disconnect() uses the same capture-then-clear pattern.
+        // See releaseQuietly. This release is code of a caller, and it runs on the path of a
+        // view that WORKS: a throw here would abort the render of a good view, and it would
+        // leave the renderer with the tree of the previous view on the screen and half of
+        // its registrations released.
         const oldUnsub = this.storeUnsubscribe;
         this.storeUnsubscribe = null;
-        oldUnsub?.();
+        releaseQuietly(oldUnsub);
         // Release the watch cleanups of the first render of the previous view.
         // Without this step, the watch subscriptions of the previous view stay active between
         // a view transition and the first store update of the new view. They then hold a
@@ -215,13 +352,18 @@ export class PlayRenderer {
         const prevWatchCleanups = [...this.watchCleanups];
         this.watchCleanups = new Set();
         for (const cleanup of prevWatchCleanups)
-            cleanup();
+            releaseQuietly(cleanup);
         this.container.replaceChildren();
         // A null emission is a gap between two views, and not a new view: keep lastViewKey
         // and currentStore. A return to the same identity therefore uses the store below
         // again. disconnect() stays the boundary of the lifetime.
-        if (!view)
+        if (!view) {
+            // Show the fallback for EVERY null view, and not for the first mount only. The
+            // four framework providers hold the same rule: a null currentView renders the
+            // placeholder content of the provider, at any moment of the life of the tree.
+            this.showFallback();
             return;
+        }
         // Resolve the store through the shared lifecycle. There are three results: the
         // external store, which is the controlled mode, and the coordinator refreshes its
         // /context, because the machinery owns /context in both modes; the store that the
@@ -230,16 +372,134 @@ export class PlayRenderer {
         // is gone, and the coordinator refreshes /context in place, because the context can
         // move during the gap); or a new store of this view, with the values of the composed
         // state.
-        const resolution = this.storeLifecycle.resolve(this.actor, view, this.options.store);
-        this.lastViewKey = view.viewKey;
-        // The code keeps the store without a guard, for the refresh of the fast path of a slice.
-        this.currentStore = resolution.store;
+        // The resolution stands INSIDE the try. It reads `spec.state`, and a spec can fail
+        // there — the accessor of a projection throws, or a seed of the store does. Such a
+        // failure aborts the rebuild exactly as a failure of renderView does, so the
+        // containment must cover it. The ErrorBoundary of play-solid covers the same
+        // accessor, and packages/play-solid/test/PlayRenderer-edge-error-boundary.test.tsx
+        // holds that rule.
         try {
+            const resolution = this.storeLifecycle.resolve(this.actor, view, this.options.store);
+            this.lastViewKey = view.viewKey;
+            // The code keeps the store without a guard, for the refresh of the fast path of a slice.
+            this.currentStore = resolution.store;
             this.renderView(view, resolution.guardedStore);
         }
         catch (error) {
-            this.resetFailedRebuild();
-            throw error;
+            // Containment: the renderer holds a failure of the complete rebuild ALWAYS. It
+            // propagates none — not out of connect() for the initial view, and not out of
+            // the callback of watchSignal for a later view. No option turns this on, and
+            // none turns it off.
+            // failView() clears the container and fills it with the fallback, exactly as on
+            // a null view. The next view that renders clears the container again, which
+            // removes the fallback.
+            this.failView(error);
+        }
+    }
+    /**
+     * The end of a render that failed, in ONE place.
+     *
+     * Three paths render — the fast path of a slice, the complete rebuild, and the write
+     * of the store — and each one ends here. The ORDER is load-bearing: the reset takes
+     * the registrations of the dead tree down BEFORE the report, so a handler of the host
+     * that renders again meets a renderer that holds nothing of the failed attempt. A
+     * second copy of the pair is a second chance to put the two in the other order.
+     *
+     * @param error - The failure that the renderer contains.
+     */
+    failView(error) {
+        this.resetFailedRebuild();
+        this.contain(error);
+    }
+    /**
+     * Clears the screen of the failed view, shows the fallback, and reports the failure.
+     *
+     * The renderer contains such a failure ALWAYS. No option turns the containment on,
+     * and none turns it off: `onError` says where the report goes, and `fallback` says
+     * what the empty container shows. The four framework renderers hold the same rule,
+     * because an error boundary of a framework is not an option that a caller turns off.
+     * A host that must escalate a failure raises it from a task of its own —
+     * `queueMicrotask(() => { throw error; })` — because the guard contains a handler
+     * that throws, exactly as the four framework renderers do.
+     *
+     * The container is cleared FIRST. The fast path of a slice holds the live tree of the
+     * previous emission, and that tree is dead as soon as the refresh throws, so the
+     * renderer must not keep it on the screen. A clear container also lets the fallback
+     * stand alone.
+     *
+     * The SCREEN comes first, and the report second: a handler that throws — a reporter
+     * that fails, or one that re-raises to escalate — must not defeat the containment
+     * that it was given to observe. With the order reversed the container stays empty AND
+     * the error escapes, which is both outcomes that the containment exists to prevent.
+     */
+    contain(error) {
+        this.container.replaceChildren();
+        this.showFallback();
+        // Without `onError` the error reaches no handler and no caller. Write it to
+        // `console.error`, in the same way as the inner renderer does for a component that
+        // throws without an `onRenderError` handler. A silent crash is the one result that
+        // no caller can debug.
+        const { onError } = this.options;
+        // The guard and the retry of THIS connection, read one time. A `connect()` that the
+        // handler starts replaces both fields, and this report belongs to the connection
+        // that reported.
+        const guard = this.guard;
+        const retry = this.retry;
+        guard.report(error, onError && (() => onError(error, retry)));
+    }
+    /**
+     * Builds the retry that one report hands the host.
+     *
+     * The read of the signal happens at the moment of the CALL: a retry that held the view
+     * that failed would take a host off the healthy screen and back onto the one that
+     * threw.
+     *
+     * The retry belongs to the guard of ITS connection, and it asks that guard alone. A
+     * host may KEEP the callback — a "Retry" button of a toast outlives the route that
+     * opened it — and `disconnect()` disposes the guard that was live then. `connect()`
+     * disconnects a connected renderer first, so every guard that leaves the field is a
+     * disposed guard, and a retry of an older connection stays dead. The rule of the prop
+     * is one rule: a reset after `disconnect()` does nothing.
+     *
+     * @param guard - The guard of the connection that this retry belongs to.
+     */
+    retryOf(guard) {
+        return () => {
+            if (guard.blocked())
+                return;
+            this.render(this.actor.currentView.get());
+        };
+    }
+    /**
+     * Appends the fallback element to the container, which the caller cleared already.
+     * The renderer calls it for a null view, and after a failure of a rebuild that it
+     * contains. Both callers clear the container first. `appendChild` moves the node.
+     * Therefore a second call adds no copy.
+     */
+    showFallback() {
+        const fallback = this.options.fallback;
+        if (fallback == null)
+            return;
+        // The producer of the fallback is CODE OF THE HOST, and it can throw: a template
+        // lookup that finds nothing, a DOM API that the runtime lacks. This method runs on
+        // the null path outside every try, and inside `contain()` after the containment
+        // decided to hold an error — so a throw here escaped `connect()` and the callback
+        // of watchSignal uncontained, and it turned a contained failure into an uncontained
+        // one with the container empty.
+        //
+        // The report goes to `console.error` and NOT to `onError`: this method runs from
+        // inside `contain()`, and a second trip through the containment would report the
+        // failure of the fallback as a failure of the view.
+        try {
+            // A producer runs at the first moment that the renderer needs the element, and
+            // the memo keeps it: a later null view of THIS renderer shows the same node, and
+            // a renderer whose view is never null builds nothing at all.
+            this.fallbackElement ??= typeof fallback === "function" ? fallback() : fallback;
+            this.container.appendChild(this.fallbackElement);
+        }
+        catch (error) {
+            console.error("[@xmachines/play-dom] the fallback of PlayRenderer failed to build. " +
+                "The container stays empty.", error);
         }
     }
     /**
@@ -247,11 +507,34 @@ export class PlayRenderer {
      * tree, because the container is empty already. Therefore this code resets the view
      * identity. The next emission, also one with the same viewKey, then makes a
      * complete render again. It does not patch a store that nothing shows.
+     *
+     * It releases the watch subscriptions of the dead tree too. A complete rebuild
+     * releases them before it builds again, and disconnect() releases them at the end of
+     * the life of the renderer — but a failure takes the DOM down HERE, between those two
+     * moments. Without this step one update of the store of the host runs every watch
+     * action of a tree that nothing shows, against detached elements, with `send` still
+     * bound to the actor. The fast path of a slice leaves a live tree of its own, and it
+     * reaches this code only when it fails.
      */
     resetFailedRebuild() {
+        // Capture both, clear both, and set alive = false BEFORE the unsubscribe — the
+        // order of disconnect(). Some StateStore implementations fire a synchronous
+        // callback from inside their own unsubscribe(). Without the flag that callback
+        // passes the guard and runs incremental.update() on the tree that this method is
+        // taking down, with `send` still bound to the actor; without the capture it also
+        // overwrites watchCleanups before the loop below reaches it. render() sets the
+        // flag to true again on the complete rebuild that the next emission makes, and the
+        // fast path of a slice needs storeUnsubscribe, which is null from here.
         const failedUnsub = this.storeUnsubscribe;
+        const failedWatchCleanups = [...this.watchCleanups];
         this.storeUnsubscribe = null;
-        failedUnsub?.();
+        this.watchCleanups = new Set();
+        this.alive = false;
+        // See releaseQuietly. This method runs BEFORE contain(), so a throw here would take
+        // the place of the failure of the view that the renderer contains.
+        releaseQuietly(failedUnsub);
+        for (const cleanup of failedWatchCleanups)
+            releaseQuietly(cleanup);
         this.lastViewKey = undefined;
         this.currentStore = null;
         this.storeLifecycle.reset();
@@ -356,7 +639,22 @@ export class PlayRenderer {
             // callbacks synchronously inside its own unsubscribe() call.
             if (!this.alive)
                 return;
-            incremental.update();
+            // The try CONTAINS a failed update, exactly as the try of render() contains a
+            // failed rebuild. `incremental.update()` resolves the props of every element that
+            // the write touched, and it rebuilds the COMPLETE tree when the store hands back
+            // the snapshot that it held — so a `$computed` function that throws on the new
+            // state aborts the render here. This callback runs from inside `store.update()`,
+            // which an ACTION HANDLER of the host calls, so such a throw left the renderer
+            // through a path that no option of this class covers: `onError` heard nothing,
+            // the dead tree stayed on the screen, and the failure reached the caller of the
+            // action instead. The containment of a failure of the view is one rule, and it
+            // holds on every path that renders.
+            try {
+                incremental.update();
+            }
+            catch (error) {
+                this.failView(error);
+            }
         });
         incremental.render();
     }

package/dist/PlayRenderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"PlayRenderer.js","sourceRoot":"","sources":["../src/PlayRenderer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"PlayRenderer.js","sourceRoot":"","sources":["../src/PlayRenderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EACN,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,GACrB,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAKvE;;;;;;;;;;;;GAYG;AACH,MAAM,cAAc,GAAG;IACtB,SAAS,EACR,6EAA6E;QAC7E,uCAAuC;IACxC,YAAY,EACX,+DAA+D;QAC/D,8DAA8D;CAC/D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAS,cAAc,CAAC,OAAwC;IAC/D,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,IAAI,CAAC;QACJ,OAAO,EAAE,CAAC;IACX,CAAC;IAAC,OAAO,cAAc,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,CACZ,yDAAyD;YACxD,mDAAmD,EACpD,cAAc,CACd,CAAC;IACH,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,OAAO,YAAY;IA+FN;IACA;IACA;IACA;IAjGlB;;;;;;;OAOG;IACK,SAAS,GAAG,KAAK,CAAC;IAClB,OAAO,GAAwB,IAAI,CAAC;IACpC,gBAAgB,GAAwB,IAAI,CAAC;IACrD;;;;;;;OAOG;IACK,aAAa,GAAG,IAAI,GAAG,EAAc,CAAC;IAC9C;;;;;;;;;;OAUG;IACK,WAAW,GAAuB,SAAS,CAAC;IAC5C,YAAY,GAAsB,IAAI,CAAC;IAC/C,kFAAkF;IAC1E,eAAe,GAAuB,IAAI,CAAC;IACnD;;;;;;;OAOG;IACc,cAAc,GAAuB,wBAAwB,CAAC,CAAC,IAAI,EAAE,EAAE,CACvF,qBAAqB,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CACjD,CAAC;IACF;;;;;OAKG;IACK,KAAK,GAAG,IAAI,CAAC;IAErB;;;;;;;;;OASG;IACH,qFAAqF;IACrF,uEAAuE;IAC/D,KAAK,GAAgB,iBAAiB,CAAC,cAAc,CAAC,CAAC;IAE/D;;;;;;OAMG;IACK,KAAK,GAAe,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAErD;;;;;;;;;;;;;;;OAeG;IACH,YACkB,SAAsB,EACtB,KAA8C,EAC9C,QAAqB,EACrB,UAA0B,EAAE;QAH5B,cAAS,GAAT,SAAS,CAAa;QACtB,UAAK,GAAL,KAAK,CAAyC;QAC9C,aAAQ,GAAR,QAAQ,CAAa;QACrB,YAAO,GAAP,OAAO,CAAqB;IAC3C,CAAC;IAEJ;;;;;;;;OAQG;IACH,OAAO;QACN,IAAI,IAAI,CAAC,SAAS;YAAE,IAAI,CAAC,UAAU,EAAE,CAAC;QACtC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,MAAM,KAAK,GAAG,iBAAiB,CAAC,cAAc,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,kFAAkF;QAClF,iFAAiF;QACjF,8DAA8D;QAC9D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACjC,sFAAsF;QACtF,mFAAmF;QACnF,2EAA2E;QAC3E,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;QAC5C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACpB,oFAAoF;QACpF,mFAAmF;QACnF,iFAAiF;QACjF,8DAA8D;QAC9D,EAAE;QACF,qFAAqF;QACrF,qFAAqF;QACrF,iFAAiF;QACjF,2DAA2D;QAC3D,IAAI,KAAK,CAAC,OAAO,EAAE;YAAE,OAAO;QAC5B,IAAI,CAAC,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE;YAC3D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;QACH,kFAAkF;QAClF,kFAAkF;QAClF,iFAAiF;QACjF,4EAA4E;QAC5E,oFAAoF;QACpF,iFAAiF;QACjF,OAAO;QACP,EAAE;QACF,kFAAkF;QAClF,iDAAiD;QACjD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;QAC7C,IAAI,OAAO,KAAK,MAAM;YAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,UAAU;QACT,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACrB,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,oFAAoF;QACpF,2BAA2B;QAC3B,kFAAkF;QAClF,oFAAoF;QACpF,iFAAiF;QACjF,sDAAsD;QACtD,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC;QACzC,MAAM,aAAa,GAAG,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC;QAC9C,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAC7B,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC;QAC/B,kFAAkF;QAClF,uDAAuD;QACvD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,kFAAkF;QAClF,cAAc,CAAC,UAAU,CAAC,CAAC;QAC3B,KAAK,MAAM,OAAO,IAAI,aAAa;YAAE,cAAc,CAAC,OAAO,CAAC,CAAC;QAC7D,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC;QACjC,iFAAiF;QACjF,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED;;;;;;OAMG;IACH,IAAI,iBAAiB;QACpB,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;IAChC,CAAC;IAEO,MAAM,CAAC,IAAqB;QACnC,2EAA2E;QAC3E,mFAAmF;QACnF,sFAAsF;QACtF,qFAAqF;QACrF,iFAAiF;QACjF,+EAA+E;QAC/E,+DAA+D;QAC/D,oFAAoF;QACpF,+EAA+E;QAC/E,sFAAsF;QACtF,4EAA4E;QAC5E,IACC,IAAI,KAAK,IAAI;YACb,IAAI,CAAC,OAAO,KAAK,SAAS;YAC1B,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC,OAAO;YACjC,IAAI,CAAC,YAAY,KAAK,IAAI;YAC1B,IAAI,CAAC,gBAAgB,KAAK,IAAI,EAC7B,CAAC;YACF,+EAA+E;YAC/E,+EAA+E;YAC/E,wEAAwE;YACxE,wDAAwD;YACxD,IAAI,CAAC;gBACJ,qBAAqB,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;YAChD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;YACD,OAAO;QACR,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,gFAAgF;QAChF,mFAAmF;QACnF,oFAAoF;QACpF,gCAAgC;QAChC,yDAAyD;QACzD,qFAAqF;QACrF,oFAAoF;QACpF,kFAAkF;QAClF,8BAA8B;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC;QACvC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAC7B,cAAc,CAAC,QAAQ,CAAC,CAAC;QAEzB,uEAAuE;QACvE,sFAAsF;QACtF,iFAAiF;QACjF,iFAAiF;QACjF,MAAM;QACN,MAAM,iBAAiB,GAAG,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC;QAClD,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC;QAC/B,KAAK,MAAM,OAAO,IAAI,iBAAiB;YAAE,cAAc,CAAC,OAAO,CAAC,CAAC;QAEjE,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC;QACjC,mFAAmF;QACnF,iFAAiF;QACjF,0DAA0D;QAC1D,IAAI,CAAC,IAAI,EAAE,CAAC;YACX,+EAA+E;YAC/E,8EAA8E;YAC9E,8EAA8E;YAC9E,IAAI,CAAC,YAAY,EAAE,CAAC;YACpB,OAAO;QACR,CAAC;QAED,+EAA+E;QAC/E,kFAAkF;QAClF,kFAAkF;QAClF,kFAAkF;QAClF,qFAAqF;QACrF,oFAAoF;QACpF,qFAAqF;QACrF,SAAS;QACT,mFAAmF;QACnF,mFAAmF;QACnF,6EAA6E;QAC7E,6EAA6E;QAC7E,mFAAmF;QACnF,mBAAmB;QACnB,IAAI,CAAC;YACJ,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACrF,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC;YAChC,yFAAyF;YACzF,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,KAAK,CAAC;YAErC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,+EAA+E;YAC/E,8EAA8E;YAC9E,6EAA6E;YAC7E,qBAAqB;YACrB,gFAAgF;YAChF,4EAA4E;YAC5E,wBAAwB;YACxB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACF,CAAC;IAED;;;;;;;;;;OAUG;IACK,QAAQ,CAAC,KAAc;QAC9B,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACK,OAAO,CAAC,KAAc;QAC7B,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC;QACjC,IAAI,CAAC,YAAY,EAAE,CAAC;QAEpB,4EAA4E;QAC5E,mFAAmF;QACnF,mFAAmF;QACnF,uBAAuB;QACvB,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QACjC,oFAAoF;QACpF,iFAAiF;QACjF,iBAAiB;QACjB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACK,OAAO,CAAC,KAAkB;QACjC,OAAO,GAAS,EAAE;YACjB,IAAI,KAAK,CAAC,OAAO,EAAE;gBAAE,OAAO;YAC5B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3C,CAAC,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,YAAY;QACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QACvC,IAAI,QAAQ,IAAI,IAAI;YAAE,OAAO;QAC7B,iFAAiF;QACjF,mFAAmF;QACnF,gFAAgF;QAChF,kFAAkF;QAClF,oFAAoF;QACpF,gCAAgC;QAChC,EAAE;QACF,iFAAiF;QACjF,iFAAiF;QACjF,oDAAoD;QACpD,IAAI,CAAC;YACJ,+EAA+E;YAC/E,iFAAiF;YACjF,6DAA6D;YAC7D,IAAI,CAAC,eAAe,KAAK,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;YAChF,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CACZ,sEAAsE;gBACrE,4BAA4B,EAC7B,KAAK,CACL,CAAC;QACH,CAAC;IACF,CAAC;IAED;;;;;;;;;;;;;OAaG;IACK,kBAAkB;QACzB,+EAA+E;QAC/E,4EAA4E;QAC5E,+EAA+E;QAC/E,iFAAiF;QACjF,iFAAiF;QACjF,+EAA+E;QAC/E,mFAAmF;QACnF,wEAAwE;QACxE,MAAM,WAAW,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAC1C,MAAM,mBAAmB,GAAG,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC;QACpD,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAC7B,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,oFAAoF;QACpF,mEAAmE;QACnE,cAAc,CAAC,WAAW,CAAC,CAAC;QAC5B,KAAK,MAAM,OAAO,IAAI,mBAAmB;YAAE,cAAc,CAAC,OAAO,CAAC,CAAC;QACnE,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED;;;;;;;OAOG;IACK,UAAU,CAAC,IAAc,EAAE,YAAwB;QAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE9C,iDAAiD;QACjD,mFAAmF;QACnF,6EAA6E;QAC7E,MAAM,QAAQ,GAAa,CAAC,OAAO,EAAE,EAAE;YACtC,MAAM,IAAI,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;YACxC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YAC3B,oFAAoF;YACpF,kFAAkF;YAClF,iFAAiF;YACjF,oFAAoF;YACpF,6DAA6D;YAC7D,qFAAqF;YACrF,2EAA2E;YAC3E,UAAU;YACV,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC,CAAC;QAEF,8FAA8F;QAC9F,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc;YAC3C,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,QAAQ,CACpC,GAAG,EAAE,CAAC,QAAQ,EACd,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,CAChC;YACF,CAAC,CAAC,EAAE,CAAC;QAEN,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;QAErC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;QACzC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;QAC3C,MAAM,mBAAmB,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC;QAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;QACzC,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;QAEjD,4EAA4E;QAC5E,iFAAiF;QACjF,kFAAkF;QAClF,oFAAoF;QACpF,mFAAmF;QACnF,iFAAiF;QACjF,oFAAoF;QACpF,uFAAuF;QACvF,sCAAsC;QACtC,EAAE;QACF,qFAAqF;QACrF,iFAAiF;QACjF,oFAAoF;QACpF,mFAAmF;QACnF,qFAAqF;QACrF,uFAAuF;QACvF,6EAA6E;QAC7E,iFAAiF;QACjF,uBAAuB;QACvB,EAAE;QACF,kFAAkF;QAClF,uFAAuF;QACvF,QAAQ;QACR,MAAM,aAAa,GAAsB;YACxC,IAAI;YACJ,QAAQ;YACR,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,YAAY,EAAE,CAAC,OAAmB,EAAgB,EAAE;gBACnD,mFAAmF;gBACnF,qFAAqF;gBACrF,iFAAiF;gBACjF,8EAA8E;gBAC9E,kEAAkE;gBAClE,MAAM,KAAK,GAAG,GAAS,EAAE;oBACxB,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBACjC,OAAO,EAAE,CAAC;gBACX,CAAC,CAAC;gBACF,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBAC9B,OAAO,KAAK,CAAC;YACd,CAAC;YACD,GAAG,CAAC,mBAAmB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjD,CAAC;QAEF,2EAA2E;QAC3E,gFAAgF;QAChF,sFAAsF;QACtF,sFAAsF;QACtF,uFAAuF;QACvF,kFAAkF;QAClF,wEAAwE;QACxE,MAAM,WAAW,GAAG,yBAAyB,CAC5C,IAAI,EACJ,YAAY,EACZ,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,SAAS,EACd,aAAa,CACb,CAAC;QAEF,sFAAsF;QACtF,kDAAkD;QAClD,IAAI,CAAC,gBAAgB,GAAG,YAAY,CAAC,SAAS,CAAC,GAAG,EAAE;YACnD,+DAA+D;YAC/D,iFAAiF;YACjF,6DAA6D;YAC7D,IAAI,CAAC,IAAI,CAAC,KAAK;gBAAE,OAAO;YACxB,8EAA8E;YAC9E,kFAAkF;YAClF,iFAAiF;YACjF,+EAA+E;YAC/E,iFAAiF;YACjF,+EAA+E;YAC/E,+EAA+E;YAC/E,gFAAgF;YAChF,+EAA+E;YAC/E,oCAAoC;YACpC,IAAI,CAAC;gBACJ,WAAW,CAAC,MAAM,EAAE,CAAC;YACtB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;QACF,CAAC,CAAC,CAAC;QACH,WAAW,CAAC,MAAM,EAAE,CAAC;IACtB,CAAC;CACD"}

package/dist/create-play-ui.d.ts

@@ -6,9 +6,9 @@
  * it returns a `disconnect` cleanup function.
  *
  * The factory holds the factory options (`functions`, `validationFunctions`,
- * `navigate`, `onRenderError`, and `fallback`) from the moment of its creation, and
- * it applies them on every `mount()` call. Give the mount options (`store` and
- * `loading`) to the `mount()` call itself, through `MountOptions`.
+ * `navigate`, `onRenderError`, `onError`, and `fallback`) from the moment of its
+ * creation, and it applies them on every `mount()` call. Give the mount options
+ * (`store` and `loading`) to the `mount()` call itself, through `MountOptions`.
  *
  * This factory is parallel to `<PlayUIProvider registryResult={...}>` in the
  * framework renderers.
@@ -31,6 +31,7 @@
  *
  * @packageDocumentation
  */
+import { type Cleanup } from "@xmachines/play";
 import type { AbstractActor, Viewable } from "@xmachines/play-actor";
 import type { AnyActorLogic } from "xstate";
 import type { StateStore } from "@xmachines/json-render-core";
@@ -41,7 +42,8 @@ import type { CreatePlayUIOptions } from "./types.js";
  *
  * They replace or complete the factory options, for one actor and one container.
  * The `createPlayUI` call sets the factory options (`functions`,
- * `validationFunctions`, `navigate`, `onRenderError`, and `fallback`) one time.
+ * `validationFunctions`, `navigate`, `onRenderError`, `onError`, and `fallback`) one
+ * time.
  */
 export interface MountOptions {
     /**
@@ -63,8 +65,32 @@ export interface MountOptions {
  * Call it with `(actor, container, mountOptions?)` to start the renderer.
  * It returns a `disconnect` cleanup function. That function stops the render and
  * clears the container.
+ *
+ * The return is a plain function here, because a consumer WRITES a value of this type
+ * to wrap or to stand in for a mount. A {@link Cleanup} return would refuse every such
+ * function that hands a plain release back. {@link DisposablePlayUI} narrows it for the
+ * value that {@link createPlayUI} builds, which nothing writes by hand.
  */
 export type MountFn = (actor: AbstractActor<AnyActorLogic> & Viewable, container: HTMLElement, options?: MountOptions) => () => void;
+/**
+ * The mount function that {@link createPlayUI} builds.
+ *
+ * It IS a {@link MountFn}, and it says one thing more: the mount hands back a
+ * {@link Cleanup}, so a caller may release it with `using` and write no teardown.
+ *
+ * ```ts
+ * const mount = createPlayUI(registryResult);
+ * {
+ *   using stop = mount(actor, container);
+ *   // stop() runs at the end of the scope, and after an exception too
+ * }
+ * ```
+ *
+ * A narrowed return and not a narrowed `MountFn`: the return type of a function may
+ * narrow, so this costs a consumer that writes a `MountFn` nothing. The parameters come
+ * from `MountFn` through `Parameters`, so the two signatures cannot drift.
+ */
+export type DisposablePlayUI = (...args: Parameters<MountFn>) => Cleanup;
 /**
  * Creates the mount function of the complete DOM renderer.
  *
@@ -80,8 +106,12 @@ export type MountFn = (actor: AbstractActor<AnyActorLogic> & Viewable, container
  *   - `validationFunctions` — your own check functions. They are available at `ctx.ctx.validationFunctions`.
  *   - `navigate`            — the navigation callback. The renderer calls it for `onSuccess: { navigate: "..." }`.
  *   - `onRenderError`       — the `(error, name)` handler of a component render error and of an action handler rejection.
- *   - `fallback`            — the element to show when the first view of the actor is `null`.
- * @returns The `MountFn`: `(actor, container, mountOptions?) → disconnect`
+ *   - `onError`             — the `(error, reset)` handler of a failure of a complete rebuild. The renderer
+ *                             contains such a failure always, and this option says where the report goes.
+ *   - `fallback`            — the content to show when the view of the actor is `null`, and after a contained
+ *                             failure of a rebuild. Give a FUNCTION when the factory mounts more than one
+ *                             time, so that each renderer owns its own element.
+ * @returns The {@link DisposablePlayUI}: `(actor, container, mountOptions?) → disconnect`
  */
-export declare function createPlayUI(registryResult: DefineRegistryResult, options?: CreatePlayUIOptions): MountFn;
+export declare function createPlayUI(registryResult: DefineRegistryResult, options?: CreatePlayUIOptions): DisposablePlayUI;
 //# sourceMappingURL=create-play-ui.d.ts.map

package/dist/create-play-ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-play-ui.d.ts","sourceRoot":"","sources":["../src/create-play-ui.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC5B;;;;OAIG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,OAAO,GAAG,CACrB,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,QAAQ,EAC9C,SAAS,EAAE,WAAW,EACtB,OAAO,CAAC,EAAE,YAAY,KAClB,MAAM,IAAI,CAAC;AAEhB;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAC3B,cAAc,EAAE,oBAAoB,EACpC,OAAO,GAAE,mBAAwB,GAC/B,OAAO,CA8CT"}
+{"version":3,"file":"create-play-ui.d.ts","sourceRoot":"","sources":["../src/create-play-ui.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EAAa,KAAK,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC5B;;;;OAIG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,OAAO,GAAG,CACrB,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,QAAQ,EAC9C,SAAS,EAAE,WAAW,EACtB,OAAO,CAAC,EAAE,YAAY,KAClB,MAAM,IAAI,CAAC;AAEhB;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAC3B,cAAc,EAAE,oBAAoB,EACpC,OAAO,GAAE,mBAAwB,GAC/B,gBAAgB,CAyDlB"}