@gjermundgaraba-designs/pixel-paper 0.26.0 → 0.27.0

package/dist/src/tips/tips.js

@@ -8,20 +8,17 @@ import { defineTaggedUnion } from "foldkit/schema";
 import { modifyFields } from "foldkit/struct";
 import { defineView } from "foldkit/submodel";
 import * as Subscription from "foldkit/subscription";
-import { prefixKeys } from "../subscription/prefixKeys.js";
-// MODEL
-/** Which side of its control the tip opens on: above, or to the right inside a vertical strip
- *  of tools. */
+import { htmlElement } from "../dom/html-element.js";
+import { prefixKeys } from "../subscription/prefix-keys.js";
 const Side = Schema.Literals(["Top", "Right"]);
 /** What brought the tip: a resting pointer or keyboard focus. */
 export const Trigger = Schema.Literals(["Pointer", "Focus"]);
-/** What a tip says: its control's name, and the key that does the same where the control
- *  names one (`data-tip-key`). */
-const Words = { text: Schema.String, maybeKey: Schema.Option(Schema.String), side: Side };
+const Words = {
+    text: Schema.String,
+    maybeKey: Schema.Option(Schema.String),
+    side: Side,
+};
 const ShownWords = { ...Words, trigger: Trigger };
-/** Where the page's tip is. `Cold`: none lately. `Waiting`: a pointer rests on a control, for
- *  a moment first. `Shown`. `Leaving`: the pointer left, with a moment to cross onto the tip.
- *  `Warm`: one just closed, so the next opens at once (sweeping a toolbar reads each name). */
 export const TipState = defineTaggedUnion({
     Cold: {},
     Waiting: Words,
@@ -33,10 +30,9 @@ export const TipState = defineTaggedUnion({
  *  from an earlier one whose Command is still out. */
 export const Model = Schema.Struct({
     id: Schema.String,
-    version: Schema.Number,
+    version: Schema.Finite,
     state: TipState,
 });
-// MESSAGE
 /** Union of all Messages the tip layer can produce. */
 export const Message = defineMessageUnion({
     EnteredTipTarget: Words,
@@ -46,9 +42,9 @@ export const Message = defineMessageUnion({
     BlurredTipTarget: {},
     PressedPointer: {},
     PressedKey: {},
-    CompletedWaitBeforeShowing: { version: Schema.Number },
-    CompletedWaitBeforeHiding: { version: Schema.Number },
-    CompletedWaitBeforeCooling: { version: Schema.Number },
+    CompletedWaitBeforeShowing: { version: Schema.Finite },
+    CompletedWaitBeforeHiding: { version: Schema.Finite },
+    CompletedWaitBeforeCooling: { version: Schema.Finite },
     CompletedShowTip: {},
     CompletedHideTip: {},
 });
@@ -58,28 +54,18 @@ export const init = (config) => (__foldkitBrandViewResult(({
     version: 0,
     state: TipState.Cold(),
 }), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#init"));
-// ACCESSORS
 /** The tip element's id, unique in the document. */
 export const id = (model) => __foldkitBrandViewResult((model.id), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#id");
-/** What brought the tip up, while it shows: a resting pointer or keyboard focus. */
 const maybeShownTrigger = (model) => __foldkitBrandViewResult((Match.value(model.state).pipe(Match.withReturnType(), Match.tag("Shown", "Leaving", ({ trigger }) => __foldkitBrandViewResult((Option.some(trigger)), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#anonymous")), Match.orElse(() => __foldkitBrandViewResult((Option.none()), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#anonymous~2")))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#maybeShownTrigger");
-// COMMAND
-/** A pointer rests this long on a control before its tip opens. */
 const REST = Duration.millis(400);
-/** The time a pointer has to cross from a control onto its tip. */
 const GRACE = Duration.millis(120);
-/** After one tip closes, the next opens at once for this long. */
 const WARMTH = Duration.millis(400);
-/** The attribute that holds a control's tip: its accessible name. */
 const TIP_ATTRIBUTE = "data-tip";
-/** The attribute that holds the key a control's tip prints after its name. */
 const TIP_KEY_ATTRIBUTE = "data-tip-key";
 const TIP_SELECTOR = `[${TIP_ATTRIBUTE}]`;
 const hasText = (element, text) => __foldkitBrandViewResult((element.isConnected && element.getAttribute(TIP_ATTRIBUTE) === text), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#hasText");
-/** The control a tip belongs to, found when it opens: the innermost hovered element with
- *  these words, or the focused one, still the keyboard's. */
 const findTipTarget = (trigger, text) => __foldkitBrandViewResult((Match.value(trigger).pipe(Match.withReturnType(), Match.when("Pointer", () => __foldkitBrandViewResult((Array.findLast(Array.fromIterable(document.querySelectorAll(`${TIP_SELECTOR}:hover`)), (element) => __foldkitBrandViewResult((hasText(element, text)), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#anonymous~4"))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#anonymous~3")), Match.when("Focus", () => __foldkitBrandViewResult((pipe(Option.fromNullishOr(document.activeElement), Option.flatMap((element) => __foldkitBrandViewResult((Option.fromNullishOr(element.closest(TIP_SELECTOR))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#anonymous~6")), Option.filter((element) => __foldkitBrandViewResult((element.matches(":focus-visible") && hasText(element, text)), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#anonymous~7")))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#anonymous~5")), Match.exhaustive)), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#findTipTarget");
-const tipElement = (tipId) => __foldkitBrandViewResult((Option.fromNullishOr(document.getElementById(tipId))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#tipElement");
+const tipElement = (tipId) => __foldkitBrandViewResult((htmlElement(`#${CSS.escape(tipId)}`)), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#tipElement");
 const hidePopover = (tip) => {
     if (tip.matches(":popover-open")) {
         tip.hidePopover();
@@ -92,7 +78,10 @@ const hidePopover = (tip) => {
 export const ShowTip = Command.define("ShowTip", {
     args: { tipId: Schema.String, text: Schema.String, trigger: Trigger },
     messages: [Message.CompletedShowTip],
-    execute: ({ tipId, text, trigger }) => __foldkitBrandViewResult((Render.afterCommit.pipe(Effect.andThen(Effect.try(() => __foldkitBrandViewResult((Option.map(Option.all({ tip: tipElement(tipId), source: findTipTarget(trigger, text) }), ({ tip, source }) => {
+    execute: ({ tipId, text, trigger }) => __foldkitBrandViewResult((Render.afterCommit.pipe(Effect.andThen(Effect.try(() => __foldkitBrandViewResult((Option.map(Option.all({
+        tip: tipElement(tipId),
+        source: findTipTarget(trigger, text),
+    }), ({ tip, source }) => {
         hidePopover(tip);
         tip.showPopover({ source });
     })), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#anonymous~8"))), Effect.ignore, Effect.as(Message.CompletedShowTip()))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#execute"),
@@ -105,32 +94,44 @@ export const HideTip = Command.define("HideTip", {
 });
 /** Waits for a resting pointer. */
 export const WaitBeforeShowing = Command.define("WaitBeforeShowing", {
-    args: { version: Schema.Number },
+    args: { version: Schema.Finite },
     messages: [Message.CompletedWaitBeforeShowing],
     execute: ({ version }) => __foldkitBrandViewResult((Effect.sleep(REST).pipe(Effect.as(Message.CompletedWaitBeforeShowing({ version })))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#execute~3"),
 });
 /** Waits for a pointer crossing onto the tip. */
 export const WaitBeforeHiding = Command.define("WaitBeforeHiding", {
-    args: { version: Schema.Number },
+    args: { version: Schema.Finite },
     messages: [Message.CompletedWaitBeforeHiding],
     execute: ({ version }) => __foldkitBrandViewResult((Effect.sleep(GRACE).pipe(Effect.as(Message.CompletedWaitBeforeHiding({ version })))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#execute~4"),
 });
 /** Waits out the moment after a tip closes in which the next opens at once. */
 export const WaitBeforeCooling = Command.define("WaitBeforeCooling", {
-    args: { version: Schema.Number },
+    args: { version: Schema.Finite },
     messages: [Message.CompletedWaitBeforeCooling],
     execute: ({ version }) => __foldkitBrandViewResult((Effect.sleep(WARMTH).pipe(Effect.as(Message.CompletedWaitBeforeCooling({ version })))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#execute~5"),
 });
-const wordsOf = ({ text, maybeKey, side }) => (__foldkitBrandViewResult(({ text, maybeKey, side }), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#wordsOf"));
+const wordsOf = ({ text, maybeKey, side }) => (__foldkitBrandViewResult(({
+    text,
+    maybeKey,
+    side,
+}), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#wordsOf"));
 const show = (model, words, trigger) => (__foldkitBrandViewResult(({
-    model: modifyFields(model, { state: () => __foldkitBrandViewResult((TipState.Shown({ ...wordsOf(words), trigger })), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#state") }),
+    model: modifyFields(model, {
+        state: () => __foldkitBrandViewResult((TipState.Shown({ ...wordsOf(words), trigger })), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#state"),
+    }),
     commands: [ShowTip({ tipId: model.id, text: words.text, trigger })],
 }), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#show"));
 const hide = (model) => {
     const nextVersion = Number.increment(model.version);
     return __foldkitBrandViewResult(({
-        model: modifyFields(model, { version: () => __foldkitBrandViewResult((nextVersion), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#version"), state: () => __foldkitBrandViewResult((TipState.Warm()), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#state~2") }),
-        commands: [HideTip({ tipId: model.id }), WaitBeforeCooling({ version: nextVersion })],
+        model: modifyFields(model, {
+            version: () => __foldkitBrandViewResult((nextVersion), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#version"),
+            state: () => __foldkitBrandViewResult((TipState.Warm()), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#state~2"),
+        }),
+        commands: [
+            HideTip({ tipId: model.id }),
+            WaitBeforeCooling({ version: nextVersion }),
+        ],
     }), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#hide");
 };
 const wait = (model, words) => {
@@ -156,7 +157,6 @@ const leave = (model, shown) => {
 const cool = (model) => (__foldkitBrandViewResult(({
     model: modifyFields(model, { state: () => __foldkitBrandViewResult((TipState.Cold()), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#state~5") }),
 }), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#cool"));
-/** Closes what shows, forgets what waits. */
 const dismiss = (model) => __foldkitBrandViewResult((TipState.match(model.state, {
     Cold: () => (__foldkitBrandViewResult(({ model }), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#Cold")),
     Waiting: () => __foldkitBrandViewResult((cool(model)), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#Waiting"),
@@ -166,8 +166,8 @@ const dismiss = (model) => __foldkitBrandViewResult((TipState.match(model.state,
 })), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#dismiss");
 const entered = (model, words) => __foldkitBrandViewResult((TipState.match(model.state, {
     Cold: () => __foldkitBrandViewResult((wait(model, words)), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#Cold~2"),
-    Waiting: (waiting) => (__foldkitBrandViewResult((waiting.text === words.text ? { model } : wait(model, words)), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#Waiting~2")),
-    Shown: (shown) => (__foldkitBrandViewResult((shown.text === words.text ? { model } : show(model, words, "Pointer")), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#Shown~2")),
+    Waiting: (waiting) => __foldkitBrandViewResult((waiting.text === words.text ? { model } : wait(model, words)), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#Waiting~2"),
+    Shown: (shown) => __foldkitBrandViewResult((shown.text === words.text ? { model } : show(model, words, "Pointer")), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#Shown~2"),
     Leaving: (leaving) => __foldkitBrandViewResult((leaving.text === words.text
         ? {
             model: modifyFields(model, {
@@ -182,12 +182,15 @@ export const update = (model, message) => __foldkitBrandViewResult((Message.matc
     EnteredTipTarget: (words) => __foldkitBrandViewResult((entered(model, wordsOf(words))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#EnteredTipTarget"),
     LeftTipTarget: () => __foldkitBrandViewResult((TipState.matchOrElse(model.state, {
         Waiting: () => __foldkitBrandViewResult((cool(model)), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#Waiting~3"),
-        Shown: (shown) => (__foldkitBrandViewResult((shown.trigger === "Pointer" ? leave(model, shown) : { model }), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#Shown~3")),
+        Shown: (shown) => __foldkitBrandViewResult((shown.trigger === "Pointer" ? leave(model, shown) : { model }), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#Shown~3"),
     }, () => (__foldkitBrandViewResult(({ model }), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#anonymous~11")))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#LeftTipTarget"),
     EnteredTip: () => __foldkitBrandViewResult((TipState.matchOrElse(model.state, {
         Leaving: (leaving) => (__foldkitBrandViewResult(({
             model: modifyFields(model, {
-                state: () => __foldkitBrandViewResult((TipState.Shown({ ...wordsOf(leaving), trigger: leaving.trigger })), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#state~7"),
+                state: () => __foldkitBrandViewResult((TipState.Shown({
+                    ...wordsOf(leaving),
+                    trigger: leaving.trigger,
+                })), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#state~7"),
             }),
         }), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#Leaving~3")),
     }, () => (__foldkitBrandViewResult(({ model }), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#anonymous~12")))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#EnteredTip"),
@@ -196,15 +199,17 @@ export const update = (model, message) => __foldkitBrandViewResult((Message.matc
     PressedPointer: () => __foldkitBrandViewResult((dismiss(model)), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#PressedPointer"),
     PressedKey: () => __foldkitBrandViewResult((dismiss(model)), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#PressedKey"),
     CompletedWaitBeforeShowing: ({ version }) => __foldkitBrandViewResult((TipState.matchOrElse(model.state, {
-        Waiting: (waiting) => __foldkitBrandViewResult((model.version === version ? show(model, wordsOf(waiting), "Pointer") : { model }), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#Waiting~4"),
+        Waiting: (waiting) => __foldkitBrandViewResult((model.version === version
+            ? show(model, wordsOf(waiting), "Pointer")
+            : { model }), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#Waiting~4"),
     }, () => (__foldkitBrandViewResult(({ model }), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#anonymous~13")))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#CompletedWaitBeforeShowing"),
-    CompletedWaitBeforeHiding: ({ version }) => __foldkitBrandViewResult((TipState.matchOrElse(model.state, { Leaving: () => (__foldkitBrandViewResult((model.version === version ? hide(model) : { model }), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#Leaving~4")) }, () => (__foldkitBrandViewResult(({ model }), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#anonymous~14")))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#CompletedWaitBeforeHiding"),
+    CompletedWaitBeforeHiding: ({ version }) => __foldkitBrandViewResult((TipState.matchOrElse(model.state, {
+        Leaving: () => (__foldkitBrandViewResult((model.version === version ? hide(model) : { model }), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#Leaving~4")),
+    }, () => (__foldkitBrandViewResult(({ model }), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#anonymous~14")))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#CompletedWaitBeforeHiding"),
     CompletedWaitBeforeCooling: ({ version }) => __foldkitBrandViewResult((TipState.matchOrElse(model.state, { Warm: () => (__foldkitBrandViewResult((model.version === version ? cool(model) : { model }), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#Warm~3")) }, () => (__foldkitBrandViewResult(({ model }), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#anonymous~15")))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#CompletedWaitBeforeCooling"),
     CompletedShowTip: () => (__foldkitBrandViewResult(({ model }), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#CompletedShowTip")),
     CompletedHideTip: () => (__foldkitBrandViewResult(({ model }), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#CompletedHideTip")),
 })), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#update");
-/** A control in a vertical strip of tools, or set in vertical writing (a folded rail's title
- *  bar), takes its tip at its side, where the tip would cover the next tool or the top bar. */
 const sideOf = (element) => __foldkitBrandViewResult((element.closest('[aria-orientation="vertical"]') === null &&
     !getComputedStyle(element).writingMode.startsWith("vertical")
     ? "Top"
@@ -215,13 +220,12 @@ const tipTargetOf = (target) => __foldkitBrandViewResult((pipe(Option.liftPredic
     maybeKey: Option.fromNullishOr(element.getAttribute(TIP_KEY_ATTRIBUTE)),
     side: sideOf(element),
 }), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#anonymous~19")))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#anonymous~18")))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#tipTargetOf");
-/** What a pointer arriving over `target` means for the tip: over a control with a tip, over
- *  the tip itself, or over neither. Touch never opens a tip. */
 export const pointerOverMessage = (tipId, event) => {
     if (event.pointerType === "touch") {
         return __foldkitBrandViewResult((Option.none()), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#pointerOverMessage");
     }
-    const isOverTip = event.target instanceof Element && event.target.closest(`#${CSS.escape(tipId)}`) !== null;
+    const isOverTip = event.target instanceof Element &&
+        event.target.closest(`#${CSS.escape(tipId)}`) !== null;
     if (isOverTip) {
         return __foldkitBrandViewResult((Option.some(Message.EnteredTip())), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#pointerOverMessage");
     }
@@ -230,36 +234,33 @@ export const pointerOverMessage = (tipId, event) => {
         onSome: (target) => __foldkitBrandViewResult((Message.EnteredTipTarget(wordsOf(target))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#onSome"),
     }))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#pointerOverMessage");
 };
-/** What focus arriving on `target` means for the tip: keyboard focus (`:focus-visible`) on a
- *  control with a tip shows it; any other focus says nothing. */
 const focusInMessage = (event) => __foldkitBrandViewResult((Option.map(Option.filter(tipTargetOf(event.target), ({ element }) => __foldkitBrandViewResult((element.matches(":focus-visible")), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#anonymous~20")), (target) => __foldkitBrandViewResult((Message.FocusedTipTarget(wordsOf(target))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#anonymous~21"))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#focusInMessage");
-/** Focus leaving a control with a tip, not into a part of itself, closes the tip (and
- *  cancels one still waiting). */
-export const focusOutMessage = (event) => __foldkitBrandViewResult((Option.map(Option.filter(tipTargetOf(event.target), ({ element }) => __foldkitBrandViewResult((!(event.relatedTarget instanceof Node && element.contains(event.relatedTarget))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#anonymous~22")), () => __foldkitBrandViewResult((Message.BlurredTipTarget()), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#anonymous~23"))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#focusOutMessage");
-/** A key pressed while a tip shows closes it and goes on its way. Escape on a tip that
- *  keyboard focus brought up closes the tip and nothing else: it is stopped before a menu or
- *  a dialog sees it. A pointer's tip lets Escape through, and a key that composes text (an
- *  input method) leaves the tip alone. */
+export const focusOutMessage = (event) => __foldkitBrandViewResult((Option.map(Option.filter(tipTargetOf(event.target), ({ element }) => __foldkitBrandViewResult((!(event.relatedTarget instanceof Node &&
+    element.contains(event.relatedTarget))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#anonymous~22")), () => __foldkitBrandViewResult((Message.BlurredTipTarget()), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#anonymous~23"))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#focusOutMessage");
+const isEscapeOnFocusTip = (event, trigger) => __foldkitBrandViewResult((event.key === "Escape" && trigger === "Focus"), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#isEscapeOnFocusTip");
+const keepFromMenusAndDialogs = (event) => {
+    event.preventDefault();
+    event.stopPropagation();
+};
 export const keyMessage = (event, trigger) => {
     if (event.isComposing) {
         return __foldkitBrandViewResult((Option.none()), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#keyMessage");
     }
-    if (event.key === "Escape" && trigger === "Focus") {
-        event.preventDefault();
-        event.stopPropagation();
+    if (isEscapeOnFocusTip(event, trigger)) {
+        keepFromMenusAndDialogs(event);
     }
     return __foldkitBrandViewResult((Option.some(Message.PressedKey())), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#keyMessage");
 };
-const pointerOverChanges = (tipId) => __foldkitBrandViewResult((Dom.streamFromEventFilterMap({
-    target: document,
-    type: "pointerover",
-    filterMapEvent: (event) => __foldkitBrandViewResult((pointerOverMessage(tipId, event)), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#filterMapEvent"),
-}).pipe(Stream.changesWith((previous, next) => __foldkitBrandViewResult((previous._tag === next._tag && sameWords(previous, next)), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#anonymous~24")))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#pointerOverChanges");
 const sameWords = (previous, next) => __foldkitBrandViewResult((previous._tag !== "EnteredTipTarget" ||
     next._tag !== "EnteredTipTarget" ||
     (previous.text === next.text &&
         previous.side === next.side &&
         Equal.equals(previous.maybeKey, next.maybeKey))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#sameWords");
+const pointerOverChanges = (tipId) => __foldkitBrandViewResult((Dom.streamFromEventFilterMap({
+    target: document,
+    type: "pointerover",
+    filterMapEvent: (event) => __foldkitBrandViewResult((pointerOverMessage(tipId, event)), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#filterMapEvent"),
+}).pipe(Stream.changesWith((previous, next) => __foldkitBrandViewResult((previous._tag === next._tag && sameWords(previous, next)), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#anonymous~24")))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#pointerOverChanges");
 const tipSubscriptions = Subscription.make()((entry) => (__foldkitBrandViewResult(({
     pointerAndFocus: entry({ tipId: Schema.String }, {
         modelToDependencies: (model) => (__foldkitBrandViewResult(({ tipId: model.id }), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#modelToDependencies")),
@@ -283,7 +284,9 @@ const tipSubscriptions = Subscription.make()((entry) => (__foldkitBrandViewResul
         ], { concurrency: "unbounded" })), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#dependenciesToStream"),
     }),
     keys: entry({ maybeTrigger: Schema.Option(Trigger) }, {
-        modelToDependencies: (model) => (__foldkitBrandViewResult(({ maybeTrigger: maybeShownTrigger(model) }), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#modelToDependencies~2")),
+        modelToDependencies: (model) => (__foldkitBrandViewResult(({
+            maybeTrigger: maybeShownTrigger(model),
+        }), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#modelToDependencies~2")),
         dependenciesToStream: ({ maybeTrigger }) => __foldkitBrandViewResult((Option.match(maybeTrigger, {
             onNone: () => __foldkitBrandViewResult((Stream.empty), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#onNone~2"),
             onSome: (trigger) => __foldkitBrandViewResult((Dom.streamFromEventFilterMap({
@@ -300,7 +303,6 @@ const tipSubscriptions = Subscription.make()((entry) => (__foldkitBrandViewResul
  *  (`subscriptions("tip")` is keyed `tipPointerAndFocus` and `tipKeys`). Keys are listened to
  *  only while a tip shows. */
 export const subscriptions = (keyPrefix) => __foldkitBrandViewResult((prefixKeys(keyPrefix, tipSubscriptions)), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#subscriptions");
-// VIEW
 const maybeWordsOf = (model) => __foldkitBrandViewResult((Match.value(model.state).pipe(Match.withReturnType(), Match.tag("Waiting", "Shown", "Leaving", (words) => __foldkitBrandViewResult((Option.some(wordsOf(words))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#anonymous~26")), Match.orElse(() => __foldkitBrandViewResult((Option.none()), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#anonymous~27")))), "@gjermundgaraba-designs/pixel-paper/src/tips/tips.js#maybeWordsOf");
 /**
  * The page's one tip: `div.tip[popover="manual"][aria-hidden="true"]`, which shows the words

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/toast/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,SAAS,EACT,SAAS,EACT,OAAO,EACP,KAAK,EACL,UAAU,EACV,OAAO,EACP,EAAE,EACF,IAAI,EACJ,WAAW,EACX,IAAI,EACJ,MAAM,EACN,IAAI,GACL,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACzD,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/toast/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,SAAS,EACT,SAAS,EACT,OAAO,EACP,KAAK,EACL,UAAU,EACV,OAAO,EACP,EAAE,EACF,IAAI,EACJ,WAAW,EACX,IAAI,EACJ,MAAM,EACN,IAAI,GACL,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzD,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/src/toast/stack.d.ts

@@ -12,7 +12,6 @@ export declare const Action: Schema.Struct<{
     readonly label: Schema.String;
 }>;
 export type Action = typeof Action.Type;
-/** What one slip says. */
 export declare const Payload: Schema.Struct<{
     readonly tone: Schema.Literals<readonly ["Ok", "Error", "Quiet"]>;
     readonly title: Schema.String;
@@ -1752,7 +1751,6 @@ declare const stack: {
         entryClassName?: string;
     }>>;
 };
-/** `@foldkit/ui`'s Toast stack, bound to the pixel-paper payload. */
 export declare const Entry: Schema.Struct<{
     readonly id: Schema.String;
     readonly variant: Schema.Literals<readonly ["Info", "Success", "Warning", "Error"]>;
@@ -2906,11 +2904,8 @@ export declare const Entry: Schema.Struct<{
 export type Entry = typeof stack.Entry.Type;
 export type Model = typeof stack.Model.Type;
 export type Message = typeof stack.Message.Type;
-/** The slips on screen, oldest first: every entry but those already leaving. */
-export declare const showing: (model: Model) => ReadonlyArray<Entry>;
-/** The id of the entry `show` added last. */
+export declare const showing: (model: Model) => readonly Entry[];
 export declare const newestId: (model: Model) => Option.Option<string>;
-/** Holds a slip's hold, as the pointer resting on it does (`HoveredEntry`). */
 export declare const hold: (model: Model, entryId: string) => Readonly<{
     model: {
         readonly id: string;
@@ -3064,8 +3059,6 @@ export declare const hold: (model: Model, entryId: string) => Readonly<{
         };
     };
 }>;
-/** Lets a slip's hold run again from its start, as the pointer leaving it does
- *  (`LeftEntry`). */
 export declare const release: (model: Model, entryId: string) => Readonly<{
     model: {
         readonly id: string;

package/dist/src/toast/stack.d.ts.map

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

package/dist/src/toast/stack.js

@@ -1,38 +1,25 @@
 import { brandViewResult as __foldkitBrandViewResult } from 'foldkit/brand'
 import { Toast as UiToast } from "@foldkit/ui";
 import { Array, Option, Schema } from "effect";
-// PAYLOAD
 /** `Ok`: a committed change, in ink, gone after the hold. `Error`: red, and it stays until it
  *  is dismissed or taken back; like every tone it is said politely. `Quiet`: news, nothing
  *  wrong, on the head tint, gone after the hold. */
 export const Tone = Schema.Literals(["Ok", "Error", "Quiet"]);
 /** One small action on a slip (undo, retry). Pressing it reports `SelectedAction` with its id
  *  and dismisses the slip. */
-export const Action = Schema.Struct({ id: Schema.String, label: Schema.String });
-/** What one slip says. */
+export const Action = Schema.Struct({
+    id: Schema.String,
+    label: Schema.String,
+});
 export const Payload = Schema.Struct({
     tone: Tone,
     title: Schema.String,
     maybeBody: Schema.Option(Schema.String),
     maybeAction: Schema.Option(Action),
 });
-// STACK
 const stack = UiToast.make(Payload);
-/** `@foldkit/ui`'s Toast stack, bound to the pixel-paper payload. */
-export const { Entry, Model, Message, OutMessage, init, update, show, dismiss, view } = stack;
-// NOTE: @foldkit/ui gap: Toast exports no accessor for its entries or for whether one is
-// leaving, and `show` does not return the id it gave the entry it added, so these read its
-// Model: an entry stops showing as its leave starts (its animation's `isShowing`), and `show`
-// appends the entry it adds.
-/** The slips on screen, oldest first: every entry but those already leaving. */
+export const { Entry, Model, Message, OutMessage, init, update, show, dismiss, view, } = stack;
 export const showing = (model) => __foldkitBrandViewResult((Array.filter(model.entries, (entry) => __foldkitBrandViewResult((entry.animation.isShowing), "@gjermundgaraba-designs/pixel-paper/src/toast/stack.js#anonymous"))), "@gjermundgaraba-designs/pixel-paper/src/toast/stack.js#showing");
-/** The id of the entry `show` added last. */
 export const newestId = (model) => __foldkitBrandViewResult((Option.map(Array.last(model.entries), (entry) => __foldkitBrandViewResult((entry.id), "@gjermundgaraba-designs/pixel-paper/src/toast/stack.js#anonymous~2"))), "@gjermundgaraba-designs/pixel-paper/src/toast/stack.js#newestId");
-// NOTE: @foldkit/ui gap: Toast has no step that holds or releases a slip from outside, only
-// the pointer's own Messages. `hold` and `release` build those two child Messages, so the
-// pixel-paper stack can hold every slip at once (see `pointerMoved` in toast.ts).
-/** Holds a slip's hold, as the pointer resting on it does (`HoveredEntry`). */
 export const hold = (model, entryId) => __foldkitBrandViewResult((update(model, Message.HoveredEntry({ entryId }))), "@gjermundgaraba-designs/pixel-paper/src/toast/stack.js#hold");
-/** Lets a slip's hold run again from its start, as the pointer leaving it does
- *  (`LeftEntry`). */
 export const release = (model, entryId) => __foldkitBrandViewResult((update(model, Message.LeftEntry({ entryId }))), "@gjermundgaraba-designs/pixel-paper/src/toast/stack.js#release");

package/dist/src/toast/toast.d.ts

@@ -2,7 +2,8 @@ import { Duration, Effect, Option, Schema } from "effect";
 import * as Command from "foldkit/command";
 import * as Mount from "foldkit/mount";
 import * as Update from "foldkit/update";
-import { Action, type Tone } from "./stack.ts";
+import { Action } from "./stack.ts";
+import type { Tone } from "./stack.ts";
 /** Schema for the page's toast stack: the `@foldkit/ui` Toast stack it is built on, which
  *  holds the slips, what holds them on screen (the pointer on a slip, the keyboard in the
  *  stack), and where focus came into the stack from. */
@@ -421,7 +422,7 @@ export type ShowConfig = Readonly<{
 }>;
 /** What `show` returns: the next Model and Commands, and the new slip's id, to take it back
  *  with `dismiss`. */
-type ShowReturn = Update.Return<Model, Message> & Readonly<{
+export type ShowReturn = Update.Return<Model, Message> & Readonly<{
     entryId: string;
 }>;
 /**
@@ -434,11 +435,8 @@ type ShowReturn = Update.Return<Model, Message> & Readonly<{
 export declare const show: (model: Model, config: ShowConfig) => ShowReturn;
 /** Takes a slip back by its id: what it reported has recovered. */
 export declare const dismiss: (model: Model, entryId: string) => StepReturn;
-/** Focus coming into the stack, from outside it: where it came from, so it can go back. */
 export declare const stackFocusIn: (stack: Element, event: FocusEvent) => Option.Option<typeof Message.FocusedStack.Type>;
-/** Focus leaving the stack for somewhere outside it. */
 export declare const stackFocusOut: (stack: Element, event: FocusEvent) => Option.Option<typeof Message.BlurredStack.Type>;
-/** A plain Escape on a slip, not composing and not handled already. */
 export declare const stackKey: (event: KeyboardEvent) => Option.Option<typeof Message.PressedEscape.Type>;
 /** The stack's focus and keys: focus coming in (and from where) and going out, and Escape
  *  on a slip, which takes the newest and keeps a Dialog the stack sits in open (its default is

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

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