@gjermundgaraba-designs/pixel-paper 0.12.0 → 0.14.0

package/dist/src/confirmDialog/confirmDialog.js

@@ -15,19 +15,17 @@ export const Model = Schema.Struct({
     dialog: Dialog.Model,
 });
 // MESSAGE
-/** Union of all Messages a confirm dialog can produce. `RequestedCloseWhileHeld`: Escape or a
- *  press on the veil while `isCloseHeld` is set; nothing follows it. */
+/** Union of all Messages a confirm dialog can produce. */
 export const Message = defineMessageUnion({
     GotDialogMessage: { message: Dialog.Message },
     ClickedConfirm: {},
     ClickedCancel: {},
-    RequestedCloseWhileHeld: {},
 });
 // OUT MESSAGE
 /** Union of OutMessages a confirm dialog reports. `Confirmed`: the reader pressed the action;
  *  the dialog stays open until the parent calls `close`. `Cancelled`: cancel, Escape or a click
  *  on the veil; the dialog has closed, and whether that also stops work already running is
- *  the parent's to decide. Never reported while `isCloseHeld` is set. */
+ *  the parent's to decide. Never reported while its ways out are held (`setCloseHeld`). */
 export const OutMessage = defineMessageUnion({
     Confirmed: {},
     Cancelled: {},
@@ -50,21 +48,29 @@ const dialogFold = foldDialog(Dialog, {
 export const update = (model, message) => __foldkitBrandViewResult((Message.match(message, {
     GotDialogMessage: ({ message: dialogMessage }) => __foldkitBrandViewResult((dialogFold.update(model, dialogMessage)), "@gjermundgaraba-designs/pixel-paper/src/confirmDialog/confirmDialog.js#GotDialogMessage"),
     ClickedConfirm: () => (__foldkitBrandViewResult(({ model, outMessage: OutMessage.Confirmed() }), "@gjermundgaraba-designs/pixel-paper/src/confirmDialog/confirmDialog.js#ClickedConfirm")),
-    ClickedCancel: () => __foldkitBrandViewResult((pipe(dialogFold.close(model), Update.withOutMessage(OutMessage.Cancelled()))), "@gjermundgaraba-designs/pixel-paper/src/confirmDialog/confirmDialog.js#ClickedCancel"),
-    RequestedCloseWhileHeld: () => (__foldkitBrandViewResult(({ model }), "@gjermundgaraba-designs/pixel-paper/src/confirmDialog/confirmDialog.js#RequestedCloseWhileHeld")),
+    ClickedCancel: () => __foldkitBrandViewResult((Dialog.isCloseHeld(model.dialog)
+        ? { model }
+        : pipe(dialogFold.close(model), Update.withOutMessage(OutMessage.Cancelled()))), "@gjermundgaraba-designs/pixel-paper/src/confirmDialog/confirmDialog.js#ClickedCancel"),
 })), "@gjermundgaraba-designs/pixel-paper/src/confirmDialog/confirmDialog.js#update");
 /** Opens the confirm dialog: focus starts on the action, or on cancel when it is `isDanger`. */
 export const open = (model) => __foldkitBrandViewResult((dialogFold.open(model)), "@gjermundgaraba-designs/pixel-paper/src/confirmDialog/confirmDialog.js#open");
-/** Closes the confirm dialog without reporting `Cancelled`: call it once confirmed work has
- *  landed. */
+/** Closes the confirm dialog without reporting `Cancelled`, and lets go of a hold: call it
+ *  once confirmed work has landed. */
 export const close = (model) => __foldkitBrandViewResult((dialogFold.close(model)), "@gjermundgaraba-designs/pixel-paper/src/confirmDialog/confirmDialog.js#close");
+/** Holds cancel, Escape and the veil, or lets them go: while held the dialog stays open and
+ *  reports no `Cancelled`, and cancel prints held (`aria-disabled`, in the keyboard). Hold it
+ *  in the update that starts confirmed work whose failure must land here, and let go in the
+ *  update where the work fails; `close` lets go once it lands. */
+export const setCloseHeld = (model, isHeld) => __foldkitBrandViewResult((modifyFields(model, { dialog: (dialog) => __foldkitBrandViewResult((Dialog.setCloseHeld(dialog, isHeld)), "@gjermundgaraba-designs/pixel-paper/src/confirmDialog/confirmDialog.js#dialog~2") })), "@gjermundgaraba-designs/pixel-paper/src/confirmDialog/confirmDialog.js#setCloseHeld");
 // ACCESSORS
 /** The confirm dialog's id, unique in the document. */
 export const id = (model) => __foldkitBrandViewResult((Dialog.id(model.dialog)), "@gjermundgaraba-designs/pixel-paper/src/confirmDialog/confirmDialog.js#id");
 /** Whether the confirm dialog is open. */
 export const isOpen = (model) => __foldkitBrandViewResult((Dialog.isOpen(model.dialog)), "@gjermundgaraba-designs/pixel-paper/src/confirmDialog/confirmDialog.js#isOpen");
-const cardView = (viewInputs, render, h) => {
-    const { isDanger = false, isBusy = false, isDisabled = false, isCloseHeld = false, toDetailView, } = viewInputs;
+/** Whether its ways out are held (`setCloseHeld`). */
+export const isCloseHeld = (model) => __foldkitBrandViewResult((Dialog.isCloseHeld(model.dialog)), "@gjermundgaraba-designs/pixel-paper/src/confirmDialog/confirmDialog.js#isCloseHeld");
+const cardView = (model, viewInputs, render, h) => {
+    const { isDanger = false, isBusy = false, isDisabled = false, toDetailView } = viewInputs;
     const commit = Button.view({
         label: viewInputs.label,
         variant: isDanger ? "Danger" : "Primary",
@@ -77,7 +83,7 @@ const cardView = (viewInputs, render, h) => {
     const cancel = Button.view({
         label: "cancel",
         isDefault: isDanger,
-        isDisabled: isCloseHeld,
+        isDisabled: Dialog.isCloseHeld(model.dialog),
         onClick: Message.ClickedCancel(),
         attributes: isDanger ? render.initialFocus : [],
     }, h);
@@ -108,8 +114,8 @@ const cardView = (viewInputs, render, h) => {
  * double-click through.
  *
  * Work that takes a while stays in the dialog: set `isBusy` while it runs, `close` once it
- * has landed, and on failure keep it open with the error in `toDetailView`. Set
- * `isCloseHeld` with it when the reader must stay to see how it ends.
+ * has landed, and on failure keep it open with the error in `toDetailView`. Hold its ways
+ * out with `setCloseHeld` too when the reader must stay to see how it ends.
  */
 export const view = defineView((model, viewInputs, h) => __foldkitBrandViewResult((h.submodel({
     slotId: id(model),
@@ -119,11 +125,7 @@ export const view = defineView((model, viewInputs, h) => __foldkitBrandViewResul
         isAlert: viewInputs.isDanger ?? false,
         hasDescription: true,
         toLiveRegionView: viewInputs.toLiveRegionView,
-        toView: (render) => __foldkitBrandViewResult((cardView(viewInputs, render, h)), "@gjermundgaraba-designs/pixel-paper/src/confirmDialog/confirmDialog.js#toView"),
+        toView: (render) => __foldkitBrandViewResult((cardView(model, viewInputs, render, h)), "@gjermundgaraba-designs/pixel-paper/src/confirmDialog/confirmDialog.js#toView"),
     },
-    // NOTE: while closing is held, Escape and a press on the veil are handed on as
-    // `RequestedCloseWhileHeld` instead of reaching the Dialog.
-    toParentMessage: (message) => __foldkitBrandViewResult((viewInputs.isCloseHeld === true && Dialog.isCloseRequest(message)
-        ? Message.RequestedCloseWhileHeld()
-        : Message.GotDialogMessage({ message })), "@gjermundgaraba-designs/pixel-paper/src/confirmDialog/confirmDialog.js#toParentMessage~2"),
+    toParentMessage: (message) => __foldkitBrandViewResult((Message.GotDialogMessage({ message })), "@gjermundgaraba-designs/pixel-paper/src/confirmDialog/confirmDialog.js#toParentMessage~2"),
 })), "@gjermundgaraba-designs/pixel-paper/src/confirmDialog/confirmDialog.js#anonymous"));

package/dist/src/confirmDialog/index.d.ts

@@ -1,3 +1,3 @@
-export { Message, Model, OutMessage, close, id, init, isOpen, open, update, view, } from "./confirmDialog.ts";
+export { Message, Model, OutMessage, close, id, init, isCloseHeld, isOpen, open, setCloseHeld, update, view, } from "./confirmDialog.ts";
 export type { InitConfig, ViewInputs } from "./confirmDialog.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/confirmDialog/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/confirmDialog/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,KAAK,EACL,UAAU,EACV,KAAK,EACL,EAAE,EACF,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,MAAM,EACN,IAAI,GACL,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/confirmDialog/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,KAAK,EACL,UAAU,EACV,KAAK,EACL,EAAE,EACF,IAAI,EACJ,WAAW,EACX,MAAM,EACN,IAAI,EACJ,YAAY,EACZ,MAAM,EACN,IAAI,GACL,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/src/confirmDialog/index.js

@@ -1 +1 @@
-export { Message, Model, OutMessage, close, id, init, isOpen, open, update, view, } from "./confirmDialog.js";
+export { Message, Model, OutMessage, close, id, init, isCloseHeld, isOpen, open, setCloseHeld, update, view, } from "./confirmDialog.js";

package/dist/src/contextMenu/contextMenu.d.ts

@@ -84,13 +84,13 @@ export declare const update: (model: Model, message: Message) => Readonly<{
         }>;
     };
     commands?: Update.Commands<{
+        readonly _tag: "PressedEscape";
+    } | {
         readonly _tag: "CompletedFocus";
     } | {
         readonly _tag: "CompletedPlaceSlip";
     } | {
         readonly _tag: "LeftSlip";
-    } | {
-        readonly _tag: "PressedEscape";
     } | {
         readonly _tag: "PressedTab";
     } | {
@@ -163,11 +163,11 @@ export declare const BindPointSlip: Mount.MountDefinitionWithArgs<"BindPointSlip
         readonly y: Schema.Number;
     }>;
 }, {
+    readonly _tag: "PressedEscape";
+} | {
     readonly _tag: "CompletedPlaceSlip";
 } | {
     readonly _tag: "LeftSlip";
-} | {
-    readonly _tag: "PressedEscape";
 } | {
     readonly _tag: "PressedTab";
 }>;
@@ -197,13 +197,13 @@ export declare const view: import("foldkit/submodel").View<{
         readonly maybeReturnFocusId: Option.Option<string>;
     }>;
 }, {
+    readonly _tag: "PressedEscape";
+} | {
     readonly _tag: "CompletedFocus";
 } | {
     readonly _tag: "CompletedPlaceSlip";
 } | {
     readonly _tag: "LeftSlip";
-} | {
-    readonly _tag: "PressedEscape";
 } | {
     readonly _tag: "PressedTab";
 } | {

package/dist/src/dialog/dialog.d.ts

@@ -2,7 +2,8 @@ import { Option, Schema } from "effect";
 import { type ChildAttribute, type Html } from "foldkit/html";
 import * as Mount from "foldkit/mount";
 import type * as Update from "foldkit/update";
-/** Schema for a pixel-paper dialog: the `@foldkit/ui` Dialog it is built on. */
+/** Schema for a pixel-paper dialog: the `@foldkit/ui` Dialog it is built on, and whether its
+ *  ways out are held (`setCloseHeld`). */
 export declare const Model: Schema.Struct<{
     readonly dialog: Schema.Struct<{
         readonly id: Schema.String;
@@ -16,6 +17,7 @@ export declare const Model: Schema.Struct<{
         }>;
         readonly maybeFocusSelector: Schema.Option<Schema.String>;
     }>;
+    readonly isCloseHeld: Schema.Boolean;
 }>;
 export type Model = typeof Model.Type;
 /** Which way h, l and the side arrows move focus in a dialog's action bar. */
@@ -73,6 +75,8 @@ export declare const init: (config: InitConfig) => Model;
 export declare const id: (model: Model) => string;
 /** Whether the dialog is open. */
 export declare const isOpen: (model: Model) => boolean;
+/** Whether the dialog's ways out are held (`setCloseHeld`). */
+export declare const isCloseHeld: (model: Model) => boolean;
 /** Processes a dialog Message and returns the next Model, Commands and OutMessage. */
 export declare const update: (model: Model, message: Message) => Readonly<{
     model: {
@@ -88,6 +92,7 @@ export declare const update: (model: Model, message: Message) => Readonly<{
             };
             readonly maybeFocusSelector: Option.Option<string>;
         };
+        readonly isCloseHeld: boolean;
     };
     commands?: Update.Commands<{
         readonly _tag: "GotDialogMessage";
@@ -134,12 +139,15 @@ export declare const update: (model: Model, message: Message) => Readonly<{
 /** Opens the dialog: focus moves to the element given the `initialFocus` group, else to the
  *  first control, and returns to where it was when the dialog closes. */
 export declare const open: (model: Model) => Update.Return<Model, Message>;
-/** Closes the dialog without reporting `Closed`. */
+/** Closes the dialog without reporting `Closed`, and lets go of a hold. */
 export declare const close: (model: Model) => Update.Return<Model, Message>;
-/** Whether a dialog Message asks to close it: Escape, a press on the veil, or a control given
- *  the `closeButton` group. A parent that holds the dialog open while its work runs leaves
- *  such a Message out of `update`. */
-export declare const isCloseRequest: (message: Message) => boolean;
+/** Holds the dialog's ways out, or lets them go: while held, Escape, a press on the veil and
+ *  a control given the `closeButton` group leave it open and report no `Closed`, so the
+ *  result of work the reader may not walk away from (a save whose failure must land here)
+ *  lands in it. Hold it in the update that starts the work, and let go in the update where
+ *  the work fails, or the reader is shut in with the failure; `close` lets go once it lands.
+ *  Hold the card's own close controls too (`Card.formView`'s `isBusy`). */
+export declare const setCloseHeld: (model: Model, isHeld: boolean) => Model;
 /** Moves focus for one keydown in an action bar, and says which way it moved. It moves only
  *  when the key's target is one of the bar's own actions and there is an action that way:
  *  a key typed in a field, a menu's item or a nested dialog inside the bar, a key an IME is
@@ -149,11 +157,31 @@ export declare const isCloseRequest: (message: Message) => boolean;
 export declare const moveActionFocus: (bar: Element, event: KeyboardEvent) => Option.Option<ActionDirection>;
 /** The action bar's keys: h or ←, and l or →, move focus between its actions (see
  *  `moveActionFocus`). Attached by the `actionBar` group. In a Scene, resolve it with
- *  `Message.PressedActionKey`. */
+ *  `sceneMounts`. */
 export declare const BindActionKeys: Mount.MountDefinitionNoArgs<"BindActionKeys", {
     readonly _tag: "PressedActionKey";
     readonly direction: "Next" | "Previous";
 }>;
+/** What a parent's Scene resolves an open dialog's Mounts with (`@foldkit/ui`'s resources,
+ *  then the action bar's keys), each with a Message that changes nothing:
+ *  `Scene.Mount.resolveAll(...Dialog.sceneMounts)`. It serves every dialog built on this one
+ *  (ConfirmDialog, KeyHelp, CommandPalette), since a Scene lifts the Messages for it. */
+export declare const sceneMounts: readonly [readonly [Mount.MountDefinitionWithArgs<"AcquireResources", {
+    id: Schema.String;
+    focusSelector: Schema.String;
+}, {
+    readonly _tag: "SucceededAcquireResources";
+} | {
+    readonly _tag: "FailedAcquireResources";
+}>, {
+    readonly _tag: "SucceededAcquireResources";
+}], readonly [Mount.MountDefinitionNoArgs<"BindActionKeys", {
+    readonly _tag: "PressedActionKey";
+    readonly direction: "Next" | "Previous";
+}>, {
+    readonly _tag: "PressedActionKey";
+    readonly direction: "Next" | "Previous";
+}]];
 /** Attribute groups a dialog hands its content. Spread each onto the element it names; a Card
  *  takes `title` and `actionBar` directly. None of them carries a class. */
 export type RenderInfo = Readonly<{
@@ -207,6 +235,7 @@ export declare const view: import("foldkit/submodel").View<{
         };
         readonly maybeFocusSelector: Option.Option<string>;
     };
+    readonly isCloseHeld: boolean;
 }, {
     readonly _tag: "GotDialogMessage";
     readonly message: {

package/dist/src/dialog/dialog.d.ts.map

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

package/dist/src/dialog/dialog.js

@@ -10,9 +10,11 @@ import { defineView } from "foldkit/submodel";
 import { isPlain } from "../keys/keys.js";
 import { foldDialog } from "./fold.js";
 // MODEL
-/** Schema for a pixel-paper dialog: the `@foldkit/ui` Dialog it is built on. */
+/** Schema for a pixel-paper dialog: the `@foldkit/ui` Dialog it is built on, and whether its
+ *  ways out are held (`setCloseHeld`). */
 export const Model = Schema.Struct({
     dialog: UiDialog.Model,
+    isCloseHeld: Schema.Boolean,
 });
 /** Which way h, l and the side arrows move focus in a dialog's action bar. */
 const ActionDirection = Schema.Literals(["Previous", "Next"]);
@@ -34,12 +36,15 @@ export const OutMessage = defineMessageUnion({
 /** Creates a closed dialog. */
 export const init = (config) => (__foldkitBrandViewResult(({
     dialog: UiDialog.init({ id: config.id }),
+    isCloseHeld: false,
 }), "@gjermundgaraba-designs/pixel-paper/src/dialog/dialog.js#init"));
 // ACCESSORS
 /** The dialog's id, unique in the document. */
 export const id = (model) => __foldkitBrandViewResult((model.dialog.id), "@gjermundgaraba-designs/pixel-paper/src/dialog/dialog.js#id");
 /** Whether the dialog is open. */
 export const isOpen = (model) => __foldkitBrandViewResult((model.dialog.isOpen), "@gjermundgaraba-designs/pixel-paper/src/dialog/dialog.js#isOpen");
+/** Whether the dialog's ways out are held (`setCloseHeld`). */
+export const isCloseHeld = (model) => __foldkitBrandViewResult((model.isCloseHeld), "@gjermundgaraba-designs/pixel-paper/src/dialog/dialog.js#isCloseHeld");
 // UPDATE
 const toOutMessage = UiDialog.OutMessage.match({
     Opened: () => __foldkitBrandViewResult((undefined), "@gjermundgaraba-designs/pixel-paper/src/dialog/dialog.js#Opened"),
@@ -51,23 +56,27 @@ const dialogFold = foldDialog(UiDialog, {
     toParentMessage: (message) => __foldkitBrandViewResult((Message.GotDialogMessage({ message })), "@gjermundgaraba-designs/pixel-paper/src/dialog/dialog.js#toParentMessage"),
     toParentOutMessage: toOutMessage,
 });
+// NOTE: @foldkit/ui gap: Dialog has no way to hold a close. Escape, a press on the veil and a
+// control given the `closeButton` group all send `RequestedClose`, so a held dialog reads it
+// by its tag and leaves it out.
+const isHeldClose = (model, message) => __foldkitBrandViewResult((model.isCloseHeld && message._tag === "RequestedClose"), "@gjermundgaraba-designs/pixel-paper/src/dialog/dialog.js#isHeldClose");
 /** Processes a dialog Message and returns the next Model, Commands and OutMessage. */
 export const update = (model, message) => __foldkitBrandViewResult((Message.match(message, {
-    GotDialogMessage: ({ message: dialogMessage }) => __foldkitBrandViewResult((dialogFold.update(model, dialogMessage)), "@gjermundgaraba-designs/pixel-paper/src/dialog/dialog.js#GotDialogMessage"),
+    GotDialogMessage: ({ message: dialogMessage }) => __foldkitBrandViewResult((isHeldClose(model, dialogMessage) ? { model } : dialogFold.update(model, dialogMessage)), "@gjermundgaraba-designs/pixel-paper/src/dialog/dialog.js#GotDialogMessage"),
     PressedActionKey: () => (__foldkitBrandViewResult(({ model }), "@gjermundgaraba-designs/pixel-paper/src/dialog/dialog.js#PressedActionKey")),
 })), "@gjermundgaraba-designs/pixel-paper/src/dialog/dialog.js#update");
 /** Opens the dialog: focus moves to the element given the `initialFocus` group, else to the
  *  first control, and returns to where it was when the dialog closes. */
 export const open = (model) => __foldkitBrandViewResult((dialogFold.open(model)), "@gjermundgaraba-designs/pixel-paper/src/dialog/dialog.js#open");
-/** Closes the dialog without reporting `Closed`. */
-export const close = (model) => __foldkitBrandViewResult((dialogFold.close(model)), "@gjermundgaraba-designs/pixel-paper/src/dialog/dialog.js#close");
-// NOTE: @foldkit/ui gap: Dialog takes no input that holds a close. Escape, a press on the
-// veil and a control given the `closeButton` group all send `RequestedClose`, so this reads
-// the Dialog's Message by its tag.
-/** Whether a dialog Message asks to close it: Escape, a press on the veil, or a control given
- *  the `closeButton` group. A parent that holds the dialog open while its work runs leaves
- *  such a Message out of `update`. */
-export const isCloseRequest = (message) => __foldkitBrandViewResult((message._tag === "GotDialogMessage" && message.message._tag === "RequestedClose"), "@gjermundgaraba-designs/pixel-paper/src/dialog/dialog.js#isCloseRequest");
+/** Closes the dialog without reporting `Closed`, and lets go of a hold. */
+export const close = (model) => __foldkitBrandViewResult((dialogFold.close(modifyFields(model, { isCloseHeld: () => __foldkitBrandViewResult((false), "@gjermundgaraba-designs/pixel-paper/src/dialog/dialog.js#isCloseHeld~2") }))), "@gjermundgaraba-designs/pixel-paper/src/dialog/dialog.js#close");
+/** Holds the dialog's ways out, or lets them go: while held, Escape, a press on the veil and
+ *  a control given the `closeButton` group leave it open and report no `Closed`, so the
+ *  result of work the reader may not walk away from (a save whose failure must land here)
+ *  lands in it. Hold it in the update that starts the work, and let go in the update where
+ *  the work fails, or the reader is shut in with the failure; `close` lets go once it lands.
+ *  Hold the card's own close controls too (`Card.formView`'s `isBusy`). */
+export const setCloseHeld = (model, isHeld) => __foldkitBrandViewResult((modifyFields(model, { isCloseHeld: () => __foldkitBrandViewResult((isHeld), "@gjermundgaraba-designs/pixel-paper/src/dialog/dialog.js#isCloseHeld~3") })), "@gjermundgaraba-designs/pixel-paper/src/dialog/dialog.js#setCloseHeld");
 // ACTION BAR KEYS
 const ACTION_BAR_ATTRIBUTE = "data-pixel-paper-action-bar";
 const ACTION_SELECTOR = "button:not(:disabled), a[href]";
@@ -96,7 +105,7 @@ export const moveActionFocus = (bar, event) => {
 };
 /** The action bar's keys: h or ←, and l or →, move focus between its actions (see
  *  `moveActionFocus`). Attached by the `actionBar` group. In a Scene, resolve it with
- *  `Message.PressedActionKey`. */
+ *  `sceneMounts`. */
 export const BindActionKeys = Mount.defineStream("BindActionKeys", {
     messages: [Message.PressedActionKey],
     execute: ({ element }) => __foldkitBrandViewResult((Dom.streamFromEventFilterMap({
@@ -105,6 +114,17 @@ export const BindActionKeys = Mount.defineStream("BindActionKeys", {
         filterMapEvent: (event) => __foldkitBrandViewResult((Option.map(moveActionFocus(element, event), (direction) => __foldkitBrandViewResult((Message.PressedActionKey({ direction })), "@gjermundgaraba-designs/pixel-paper/src/dialog/dialog.js#anonymous~9"))), "@gjermundgaraba-designs/pixel-paper/src/dialog/dialog.js#filterMapEvent"),
     })), "@gjermundgaraba-designs/pixel-paper/src/dialog/dialog.js#execute"),
 });
+/** What a parent's Scene resolves an open dialog's Mounts with (`@foldkit/ui`'s resources,
+ *  then the action bar's keys), each with a Message that changes nothing:
+ *  `Scene.Mount.resolveAll(...Dialog.sceneMounts)`. It serves every dialog built on this one
+ *  (ConfirmDialog, KeyHelp, CommandPalette), since a Scene lifts the Messages for it. */
+export const sceneMounts = [
+    // NOTE: @foldkit/ui gap: its Dialog ships no Scene resolution for its resources Mount, so
+    // this test helper builds the child Message the Mount would report
+    // oxlint-disable-next-line foldkit/no-child-message-construction-in-root
+    [UiDialog.AcquireResources, UiDialog.Message.SucceededAcquireResources()],
+    [BindActionKeys, Message.PressedActionKey({ direction: "Next" })],
+];
 /**
  * A modal dialog on the ink veil with its checker grain, built on `@foldkit/ui`'s Dialog. It
  * opens with `show()` in place, not in the top layer: Foldkit makes the page behind it inert

package/dist/src/dialog/index.d.ts

@@ -1,4 +1,4 @@
-export { BindActionKeys, Message, Model, OutMessage, close, id, init, isCloseRequest, isOpen, open, update, view, } from "./dialog.ts";
+export { BindActionKeys, Message, Model, OutMessage, close, id, init, isCloseHeld, isOpen, open, sceneMounts, setCloseHeld, update, view, } from "./dialog.ts";
 export type { InitConfig, Placement, RenderInfo, ViewInputs } from "./dialog.ts";
 export { foldDialog } from "./fold.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/dialog/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dialog/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,OAAO,EACP,KAAK,EACL,UAAU,EACV,KAAK,EACL,EAAE,EACF,IAAI,EACJ,cAAc,EACd,MAAM,EACN,IAAI,EACJ,MAAM,EACN,IAAI,GACL,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dialog/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,OAAO,EACP,KAAK,EACL,UAAU,EACV,KAAK,EACL,EAAE,EACF,IAAI,EACJ,WAAW,EACX,MAAM,EACN,IAAI,EACJ,WAAW,EACX,YAAY,EACZ,MAAM,EACN,IAAI,GACL,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/dist/src/dialog/index.js

@@ -1,2 +1,2 @@
-export { BindActionKeys, Message, Model, OutMessage, close, id, init, isCloseRequest, isOpen, open, update, view, } from "./dialog.js";
+export { BindActionKeys, Message, Model, OutMessage, close, id, init, isCloseHeld, isOpen, open, sceneMounts, setCloseHeld, update, view, } from "./dialog.js";
 export { foldDialog } from "./fold.js";

package/dist/src/drag/drag.d.ts

@@ -0,0 +1,40 @@
+import { DragAndDrop as UiDragAndDrop } from "@foldkit/ui";
+import { Option, Stream } from "effect";
+/** Where a drag is: nothing pressed, pressed but not yet moved, carried by a pointer, or
+ *  carried by the keyboard. */
+type Phase = "Idle" | "Pressed" | "PointerDragging" | "KeyboardDragging";
+export declare const phaseOf: (dragAndDrop: UiDragAndDrop.Model) => Phase;
+/** Whether an item is carried, by a pointer or the keyboard. */
+export declare const isCarrying: (phase: Phase) => boolean;
+export declare const pressedDraggable: (fields: Parameters<typeof UiDragAndDrop.Message.PressedDraggable>[0]) => UiDragAndDrop.Message;
+export declare const activatedKeyboardDrag: (fields: Parameters<typeof UiDragAndDrop.Message.ActivatedKeyboardDrag>[0]) => UiDragAndDrop.Message;
+export declare const movedPointer: (fields: Parameters<typeof UiDragAndDrop.Message.MovedPointer>[0]) => UiDragAndDrop.Message;
+export declare const releasedPointer: () => UiDragAndDrop.Message;
+export declare const cancelledDrag: () => UiDragAndDrop.Message;
+/** The main mouse button, the only one that lifts. */
+export declare const LEFT_BUTTON = 0;
+/** What a press inside an item may land on without lifting it: its controls, but for the
+ *  buttons `liftingButtons` (a selector list) names, and anything marked `data-no-lift`. */
+export declare const innerControls: (liftingButtons: string) => string;
+/** Takes a plain Escape for `message` and stops it there, so a dialog around the list or the
+ *  page's own key bindings never see it. */
+export declare const takeEscape: <Message>(event: KeyboardEvent, message: Message) => Option.Option<Message>;
+/** Escape on the window, in the capture phase, as `message`. */
+export declare const escapeKeys: <Message>(message: Message) => Stream.Stream<Message>;
+/** Sizes the copy that follows the pointer to the element `sourceSelector` finds, and keeps the
+ *  pointer where it pressed that element. */
+export declare const measureLift: (element: Element, sourceSelector: string, pressX: number, pressY: number) => void;
+/**
+ * Where a pointer at (`clientX`, `clientY`) would put the held item among the others in
+ * `container` (its `[data-sortable-id]` items, the held one, `heldId`, left out): before or
+ * after the item whose centre is closest. Where items sit side by side (two share a top, a
+ * wrapping grid, the held one counted) the pointer's side of that centre is read across, and
+ * in a column of rows it is read down, so one reading serves a list and a grid.
+ */
+export declare const insertionIndex: (container: Element, heldId: string, clientX: number, clientY: number) => number;
+/** While a pointer presses or carries an item, the page is marked
+ *  (`data-pixel-paper-dragging` on the root), so the stylesheet prints the grabbing cursor and
+ *  holds text selection, with no style element of its own. */
+export declare const markDragging: Stream.Stream<never>;
+export {};
+//# sourceMappingURL=drag.d.ts.map

package/dist/src/drag/drag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drag.d.ts","sourceRoot":"","sources":["../../../src/drag/drag.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,IAAI,aAAa,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAiB,MAAM,EAAS,MAAM,EAAQ,MAAM,QAAQ,CAAC;AAKpE;+BAC+B;AAC/B,KAAK,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;AAKzE,eAAO,MAAM,OAAO,gBAAiB,aAAa,CAAC,KAAK,KAAG,KAU1D,CAAC;AAEF,gEAAgE;AAChE,eAAO,MAAM,UAAU,UAAW,KAAK,KAAG,OACmB,CAAC;AAQ9D,eAAO,MAAM,gBAAgB,WACnB,UAAU,CAAC,OAAO,aAAa,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,KACnE,aAAa,CAAC,OAE+B,CAAC;AAEjD,eAAO,MAAM,qBAAqB,WACxB,UAAU,CAAC,OAAO,aAAa,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,KACxE,aAAa,CAAC,OAEoC,CAAC;AAEtD,eAAO,MAAM,YAAY,WACf,UAAU,CAAC,OAAO,aAAa,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,KAC/D,aAAa,CAAC,OAE2B,CAAC;AAE7C,eAAO,MAAM,eAAe,QAAO,aAAa,CAAC,OAER,CAAC;AAE1C,eAAO,MAAM,aAAa,QAAO,aAAa,CAAC,OAER,CAAC;AAIxC,sDAAsD;AACtD,eAAO,MAAM,WAAW,IAAI,CAAC;AAE7B;4FAC4F;AAC5F,eAAO,MAAM,aAAa,mBAAoB,MAAM,KAAG,MASzC,CAAC;AAMf;4CAC4C;AAC5C,eAAO,MAAM,UAAU,GAAI,OAAO,SACzB,aAAa,WACX,OAAO,KACf,MAAM,CAAC,MAAM,CAAC,OAAO,CAQvB,CAAC;AAEF,gEAAgE;AAChE,eAAO,MAAM,UAAU,GAAI,OAAO,WAAW,OAAO,KAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAMxE,CAAC;AAIL;6CAC6C;AAC7C,eAAO,MAAM,WAAW,YACb,OAAO,kBACA,MAAM,UACd,MAAM,UACN,MAAM,KACb,IAQF,CAAC;AAoBF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,cACd,OAAO,UACV,MAAM,WACL,MAAM,WACN,MAAM,KACd,MA+BF,CAAC;AAMF;;8DAE8D;AAC9D,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAK7C,CAAC"}

package/dist/src/drag/drag.js

@@ -0,0 +1,134 @@
+import { brandViewResult as __foldkitBrandViewResult } from 'foldkit/brand'
+// Shared by Board and Sortable, the two users of @foldkit/ui's DragAndDrop: the phase a drag
+// is in, the DragAndDrop Messages both build, what a press lifts, Escape taken before anything
+// else, the lifted copy's measure, and the closest-centre drop target a sortable resolves for
+// a pointer.
+import { DragAndDrop as UiDragAndDrop } from "@foldkit/ui";
+import { Array, Effect, Option, Order, Stream, pipe } from "effect";
+import * as Dom from "foldkit/dom";
+// NOTE: @foldkit/ui gap: DragAndDrop has no accessor for which input holds an item.
+// `ghostStyle` is Some only while a pointer drags, so it tells a pointer drag from a keyboard
+// one.
+export const phaseOf = (dragAndDrop) => {
+    if (Option.isNone(UiDragAndDrop.maybeDraggedItemId(dragAndDrop))) {
+        return __foldkitBrandViewResult(("Idle"), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#phaseOf");
+    }
+    else if (!UiDragAndDrop.isDragging(dragAndDrop)) {
+        return __foldkitBrandViewResult(("Pressed"), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#phaseOf");
+    }
+    else if (Option.isSome(UiDragAndDrop.ghostStyle(dragAndDrop))) {
+        return __foldkitBrandViewResult(("PointerDragging"), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#phaseOf");
+    }
+    else {
+        return __foldkitBrandViewResult(("KeyboardDragging"), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#phaseOf");
+    }
+};
+/** Whether an item is carried, by a pointer or the keyboard. */
+export const isCarrying = (phase) => __foldkitBrandViewResult((phase === "PointerDragging" || phase === "KeyboardDragging"), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#isCarrying");
+// CHILD MESSAGES
+// NOTE: @foldkit/ui gap: DragAndDrop exposes no update capability for a press, a keyboard
+// pick-up, a pointer's move and release, or a cancel, and its `draggable` bundle
+// (`role="option"`, `tabindex`) cannot sit on a grip's button. So Board and Sortable build
+// these child Messages themselves.
+export const pressedDraggable = (fields) => 
+// oxlint-disable-next-line foldkit/no-child-message-construction-in-root
+__foldkitBrandViewResult((UiDragAndDrop.Message.PressedDraggable(fields)), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#pressedDraggable");
+export const activatedKeyboardDrag = (fields) => 
+// oxlint-disable-next-line foldkit/no-child-message-construction-in-root
+__foldkitBrandViewResult((UiDragAndDrop.Message.ActivatedKeyboardDrag(fields)), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#activatedKeyboardDrag");
+export const movedPointer = (fields) => 
+// oxlint-disable-next-line foldkit/no-child-message-construction-in-root
+__foldkitBrandViewResult((UiDragAndDrop.Message.MovedPointer(fields)), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#movedPointer");
+export const releasedPointer = () => 
+// oxlint-disable-next-line foldkit/no-child-message-construction-in-root
+__foldkitBrandViewResult((UiDragAndDrop.Message.ReleasedPointer()), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#releasedPointer");
+export const cancelledDrag = () => 
+// oxlint-disable-next-line foldkit/no-child-message-construction-in-root
+__foldkitBrandViewResult((UiDragAndDrop.Message.CancelledDrag()), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#cancelledDrag");
+// PRESS
+/** The main mouse button, the only one that lifts. */
+export const LEFT_BUTTON = 0;
+/** What a press inside an item may land on without lifting it: its controls, but for the
+ *  buttons `liftingButtons` (a selector list) names, and anything marked `data-no-lift`. */
+export const innerControls = (liftingButtons) => __foldkitBrandViewResult(([
+    "input",
+    "textarea",
+    "select",
+    "a[href]",
+    '[contenteditable]:not([contenteditable="false"])',
+    `button:not(${liftingButtons})`,
+    "[data-no-lift]",
+].join(", ")), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#innerControls");
+// ESCAPE
+// NOTE: @foldkit/ui gap: DragAndDrop's own Escape cancels the move and lets the key travel
+// on, to a dialog around the list. Board and Sortable take the key first and stop it.
+/** Takes a plain Escape for `message` and stops it there, so a dialog around the list or the
+ *  page's own key bindings never see it. */
+export const takeEscape = (event, message) => {
+    if (event.key !== "Escape" || event.isComposing) {
+        return __foldkitBrandViewResult((Option.none()), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#takeEscape");
+    }
+    event.preventDefault();
+    event.stopPropagation();
+    return __foldkitBrandViewResult((Option.some(message)), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#takeEscape");
+};
+/** Escape on the window, in the capture phase, as `message`. */
+export const escapeKeys = (message) => __foldkitBrandViewResult((Dom.streamFromEventFilterMap({
+    target: () => __foldkitBrandViewResult((window), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#target"),
+    type: "keydown",
+    filterMapEvent: (event) => __foldkitBrandViewResult((takeEscape(event, message)), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#filterMapEvent"),
+    options: { capture: true },
+})), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#escapeKeys");
+// LIFTED COPY
+/** Sizes the copy that follows the pointer to the element `sourceSelector` finds, and keeps the
+ *  pointer where it pressed that element. */
+export const measureLift = (element, sourceSelector, pressX, pressY) => {
+    const maybeSource = Option.fromNullishOr(document.querySelector(sourceSelector));
+    if (Option.isSome(maybeSource) && element instanceof HTMLElement) {
+        const rect = maybeSource.value.getBoundingClientRect();
+        element.style.setProperty("--lift-width", `${rect.width}px`);
+        element.style.setProperty("--lift-x", `${rect.left - pressX}px`);
+        element.style.setProperty("--lift-y", `${rect.top - pressY}px`);
+    }
+};
+// POINTER TARGET
+const ROW_TOLERANCE = 1;
+const boxOf = (element) => {
+    const rect = element.getBoundingClientRect();
+    return __foldkitBrandViewResult(({
+        top: rect.top,
+        centreX: rect.left + rect.width / 2,
+        centreY: rect.top + rect.height / 2,
+    }), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#boxOf");
+};
+const isOnSameRow = (box, other) => __foldkitBrandViewResult((Math.abs(other.top - box.top) < ROW_TOLERANCE), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#isOnSameRow");
+/**
+ * Where a pointer at (`clientX`, `clientY`) would put the held item among the others in
+ * `container` (its `[data-sortable-id]` items, the held one, `heldId`, left out): before or
+ * after the item whose centre is closest. Where items sit side by side (two share a top, a
+ * wrapping grid, the held one counted) the pointer's side of that centre is read across, and
+ * in a column of rows it is read down, so one reading serves a list and a grid.
+ */
+export const insertionIndex = (container, heldId, clientX, clientY) => {
+    const items = Array.map(Array.fromIterable(container.querySelectorAll("[data-sortable-id]")), (item) => (__foldkitBrandViewResult(({ id: item.dataset["sortableId"], box: boxOf(item) }), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#anonymous")));
+    // read with the held item in its place: two tiles side by side are a row even while one of
+    // them is held
+    const isTiled = Array.some(items, ({ box }, index) => __foldkitBrandViewResult((Option.exists(Array.get(items, index + 1), (next) => __foldkitBrandViewResult((isOnSameRow(box, next.box)), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#anonymous~3"))), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#anonymous~2"));
+    const boxes = pipe(Array.filter(items, (item) => __foldkitBrandViewResult((item.id !== heldId), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#anonymous~4")), Array.map(({ box }) => __foldkitBrandViewResult((box), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#anonymous~5")));
+    const distance = (box) => __foldkitBrandViewResult((Math.hypot(box.centreX - clientX, box.centreY - clientY)), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#distance");
+    const byDistance = Order.mapInput(Order.Number, ({ box }) => __foldkitBrandViewResult((distance(box)), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#anonymous~6"));
+    return __foldkitBrandViewResult((Array.match(Array.map(boxes, (box, index) => (__foldkitBrandViewResult(({ box, index }), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#anonymous~7"))), {
+        onEmpty: () => __foldkitBrandViewResult((0), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#onEmpty"),
+        onNonEmpty: (candidates) => {
+            const { box, index } = Array.min(candidates, byDistance);
+            const isAfter = isTiled ? clientX > box.centreX : clientY > box.centreY;
+            return __foldkitBrandViewResult((isAfter ? index + 1 : index), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#onNonEmpty");
+        },
+    })), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#insertionIndex");
+};
+// DRAG STYLES
+const DRAGGING_ATTRIBUTE = "data-pixel-paper-dragging";
+/** While a pointer presses or carries an item, the page is marked
+ *  (`data-pixel-paper-dragging` on the root), so the stylesheet prints the grabbing cursor and
+ *  holds text selection, with no style element of its own. */
+export const markDragging = Stream.callback(() => __foldkitBrandViewResult((Effect.acquireRelease(Effect.sync(() => __foldkitBrandViewResult((document.documentElement.setAttribute(DRAGGING_ATTRIBUTE, "")), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#anonymous~9")), () => __foldkitBrandViewResult((Effect.sync(() => __foldkitBrandViewResult((document.documentElement.removeAttribute(DRAGGING_ATTRIBUTE)), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#anonymous~11"))), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#anonymous~10")).pipe(Effect.flatMap(() => __foldkitBrandViewResult((Effect.never), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#anonymous~12")))), "@gjermundgaraba-designs/pixel-paper/src/drag/drag.js#anonymous~8"));

package/dist/src/emptyState/emptyState.d.ts

@@ -3,10 +3,12 @@ import type { Html, HtmlBuilder } from "foldkit/html";
 export type ViewConfig = Readonly<{
     /** Pixel caps: what is missing (`"Nothing queued"`). */
     title: string;
-    /** Makes the title a heading at this level, for an empty state that is the page's or the
-     *  section's main content (a gate, a missing page); a `strong` when not given. It looks the
-     *  same either way. */
-    headingLevel?: 1 | 2 | 3 | 4 | 5 | 6;
+    /** The title's element, which looks the same either way. A heading at this level where the
+     *  empty state is the page's or a section's main content: `3` inside a Panel, whose title is
+     *  an `h2`; `1` for a gate or a missing page. `"Strong"` where it is not (a chart with no
+     *  data, a picture of the state). Required, because the two look alike and only the outline
+     *  tells them apart. */
+    headingLevel: 1 | 2 | 3 | 4 | 5 | 6 | "Strong";
     /** One sentence: how it gets filled. */
     body?: ReadonlyArray<Html | string>;
     /** What fills it: a button under the sentence. */

package/dist/src/emptyState/emptyState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"emptyState.d.ts","sourceRoot":"","sources":["../../../src/emptyState/emptyState.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAItD,8DAA8D;AAC9D,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd;;2BAEuB;IACvB,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACrC,wCAAwC;IACxC,IAAI,CAAC,EAAE,aAAa,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC;IACpC,kDAAkD;IAClD,OAAO,CAAC,EAAE,aAAa,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC;CACxC,CAAC,CAAC;AAEH,yFAAyF;AACzF,eAAO,MAAM,IAAI,GAAI,OAAO,UAAU,UAAU,KAAK,WAAW,CAAC,OAAO,CAAC,KAAG,IAa3E,CAAC"}
+{"version":3,"file":"emptyState.d.ts","sourceRoot":"","sources":["../../../src/emptyState/emptyState.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAItD,8DAA8D;AAC9D,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd;;;;4BAIwB;IACxB,YAAY,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;IAC/C,wCAAwC;IACxC,IAAI,CAAC,EAAE,aAAa,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC;IACpC,kDAAkD;IAClD,OAAO,CAAC,EAAE,aAAa,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC;CACxC,CAAC,CAAC;AAEH,yFAAyF;AACzF,eAAO,MAAM,IAAI,GAAI,OAAO,UAAU,UAAU,KAAK,WAAW,CAAC,OAAO,CAAC,KAAG,IAa3E,CAAC"}

package/dist/src/emptyState/emptyState.js

@@ -4,7 +4,7 @@ import { Array } from "effect";
 export const view = (config, h) => {
     const { title, headingLevel, body = [], actions = [] } = config;
     return __foldkitBrandViewResult((h.div([h.Class("empty")], [
-        headingLevel === undefined
+        headingLevel === "Strong"
             ? h.strong([h.Class("empty-title")], [title])
             : h[`h${headingLevel}`]([h.Class("empty-title")], [title]),
         ...Array.match(body, { onEmpty: () => __foldkitBrandViewResult(([]), "@gjermundgaraba-designs/pixel-paper/src/emptyState/emptyState.js#onEmpty"), onNonEmpty: (sentence) => __foldkitBrandViewResult(([h.p([], sentence)]), "@gjermundgaraba-designs/pixel-paper/src/emptyState/emptyState.js#onNonEmpty") }),

package/dist/src/errorSummary/errorSummary.d.ts

@@ -29,7 +29,7 @@ export type ViewConfig = Readonly<{
  * busy) is a failed submit like any other: render the summary from it and focus it.
  *
  * Each link is a fragment link to its field; a Foldkit application's fragment handler moves
- * focus there (see `SkipLink.focusFragment`).
+ * focus there (`SkipLink.ScrollToFragment`).
  */
 export declare const view: <Message>(config: ViewConfig, h: HtmlBuilder<Message>) => Html;
 //# sourceMappingURL=errorSummary.d.ts.map