@nxgt/material-core 0.9.1 → 0.11.0

package/dist/lib/code-errors.js

@@ -0,0 +1,37 @@
+// src/lib/code-errors.ts
+function defaultCodeOf(issue) {
+  if (issue.code !== "custom")
+    return;
+  const code = issue.params?.code;
+  return typeof code === "string" ? code : undefined;
+}
+function isEmptyRequired(issue) {
+  if (issue.code === "too_small")
+    return issue.origin === "string" && Number(issue.minimum) === 1;
+  if (issue.code === "invalid_type")
+    return issue.input === undefined || issue.input === null;
+  return false;
+}
+function createCodeErrorMap({
+  translate,
+  codeOf = defaultCodeOf,
+  fallback
+}) {
+  return (issue) => {
+    const code = codeOf(issue);
+    if (code) {
+      const words = translate(code, issue.params);
+      if (words !== undefined && words !== code)
+        return words;
+    }
+    return fallback(issue);
+  };
+}
+export {
+  createCodeErrorMap,
+  defaultCodeOf,
+  isEmptyRequired
+};
+
+//# debugId=7DC5306E81E48FAB64756E2164756E21
+//# sourceMappingURL=code-errors.js.map

package/dist/lib/code-errors.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/lib/code-errors.ts"],
+  "sourcesContent": [
+    "/**\n * The part of a zod issue a code error map reads, by shape: core has no zod\n * dependency, and every issue zod 4 hands an error map is assignable to it.\n */\nexport type CodeIssue = {\n\treadonly code: string;\n\t/** A custom issue's params: `.refine(…, { params: { code } })`. */\n\treadonly params?: Record<string, unknown> | undefined;\n\t/** The value that failed. */\n\treadonly input?: unknown;\n\t/** What a size issue measured: `'string'`, `'number'`, `'array'`… */\n\treadonly origin?: string | undefined;\n\treadonly minimum?: unknown;\n\treadonly maximum?: unknown;\n\treadonly expected?: unknown;\n\treadonly message?: string | undefined;\n};\n\n/** The words for an issue, or `undefined` to let zod word it. */\nexport type CodeErrorMap = (issue: CodeIssue) => string | undefined;\n\nexport type CodeErrorMapOptions = {\n\t/**\n\t * The app's words for `code`, interpolating `params` (the custom issue's\n\t * params, so `{ code, min: 3 }` can read \"At least 3\"). `undefined`, or\n\t * the code returned verbatim (what a translator does with a key it lacks),\n\t * means there are no words for it: `fallback` words the issue instead.\n\t */\n\ttranslate: (\n\t\tcode: string,\n\t\tparams: Record<string, unknown> | undefined,\n\t) => string | undefined;\n\t/**\n\t * Which code an issue carries. Defaults to {@link defaultCodeOf}: a custom\n\t * issue's `params.code`, when it is a string.\n\t */\n\tcodeOf?: (issue: CodeIssue) => string | undefined;\n\t/**\n\t * Words an issue with no code, or one whose code has no words: the\n\t * libraries pass `zodLocaleError({ language, translate })`.\n\t */\n\tfallback: CodeErrorMap;\n};\n\n/** A custom issue's `params.code`, when it is a string; otherwise none. */\nexport function defaultCodeOf(issue: CodeIssue): string | undefined {\n\tif (issue.code !== 'custom') return undefined;\n\tconst code = issue.params?.code;\n\treturn typeof code === 'string' ? code : undefined;\n}\n\n/**\n * Whether an issue only says the field was left empty: a string shorter than\n * one character (`z.string().min(1)`), or a value of the wrong type that is\n * not there at all (`undefined` or `null`).\n *\n * @example\n * ```ts\n * createCodeErrorMap({\n *   translate,\n *   fallback,\n *   codeOf: (issue) =>\n *     isEmptyRequired(issue) ? 'errors.required' : defaultCodeOf(issue),\n * });\n * ```\n */\nexport function isEmptyRequired(issue: CodeIssue): boolean {\n\tif (issue.code === 'too_small')\n\t\treturn issue.origin === 'string' && Number(issue.minimum) === 1;\n\tif (issue.code === 'invalid_type')\n\t\treturn issue.input === undefined || issue.input === null;\n\treturn false;\n}\n\n/**\n * A zod 4 error map that words an issue by the code it carries, in the\n * app's words: a refinement's `params.code` (an API error code, say) reads\n * as `translate(code, params)`. An issue with no code, or whose code\n * `translate` has no words for, is worded by `fallback`.\n *\n * @example\n * ```ts\n * import { createCodeErrorMap } from '@nxgt/material-core/code-errors';\n *\n * const error = createCodeErrorMap({\n *   translate: (code, params) => translate(code, params, language),\n *   fallback: zodLocaleError({ language, translate }),\n * });\n * schema.safeParse(values, { error });\n * ```\n */\nexport function createCodeErrorMap({\n\ttranslate,\n\tcodeOf = defaultCodeOf,\n\tfallback,\n}: CodeErrorMapOptions): CodeErrorMap {\n\treturn (issue) => {\n\t\tconst code = codeOf(issue);\n\t\tif (code) {\n\t\t\tconst words = translate(code, issue.params);\n\t\t\tif (words !== undefined && words !== code) return words;\n\t\t}\n\t\treturn fallback(issue);\n\t};\n}\n"
+  ],
+  "mappings": ";AA6CO,SAAS,aAAa,CAAC,OAAsC;AAAA,EACnE,IAAI,MAAM,SAAS;AAAA,IAAU;AAAA,EAC7B,MAAM,OAAO,MAAM,QAAQ;AAAA,EAC3B,OAAO,OAAO,SAAS,WAAW,OAAO;AAAA;AAkBnC,SAAS,eAAe,CAAC,OAA2B;AAAA,EAC1D,IAAI,MAAM,SAAS;AAAA,IAClB,OAAO,MAAM,WAAW,YAAY,OAAO,MAAM,OAAO,MAAM;AAAA,EAC/D,IAAI,MAAM,SAAS;AAAA,IAClB,OAAO,MAAM,UAAU,aAAa,MAAM,UAAU;AAAA,EACrD,OAAO;AAAA;AAoBD,SAAS,kBAAkB;AAAA,EACjC;AAAA,EACA,SAAS;AAAA,EACT;AAAA,GACqC;AAAA,EACrC,OAAO,CAAC,UAAU;AAAA,IACjB,MAAM,OAAO,OAAO,KAAK;AAAA,IACzB,IAAI,MAAM;AAAA,MACT,MAAM,QAAQ,UAAU,MAAM,MAAM,MAAM;AAAA,MAC1C,IAAI,UAAU,aAAa,UAAU;AAAA,QAAM,OAAO;AAAA,IACnD;AAAA,IACA,OAAO,SAAS,KAAK;AAAA;AAAA;",
+  "debugId": "7DC5306E81E48FAB64756E2164756E21",
+  "names": []
+}

package/dist/lib/focus-control.js

@@ -1,43 +1,11 @@
-// src/lib/focus-control.ts
-var TABBABLE = 'input:not([type="hidden"]):not(:disabled):not([tabindex="-1"]), textarea:not(:disabled):not([tabindex="-1"]), select:not(:disabled):not([tabindex="-1"]), button:not(:disabled):not([tabindex="-1"]), [contenteditable="true"], [tabindex]:not([tabindex="-1"])';
-function firstControl(roots) {
-  for (const root of roots) {
-    const controls = root.matches(TABBABLE) ? [root] : root.querySelectorAll(TABBABLE);
-    for (const control of controls) {
-      if (control.getClientRects().length)
-        return control;
-    }
-  }
-  return null;
-}
-function focusHandle(roots) {
-  return {
-    focus: () => {
-      firstControl(roots)?.focus();
-      setTimeout(() => {
-        const list = [...roots];
-        const active = list[0]?.ownerDocument.activeElement ?? null;
-        if (!list.some((root) => root.contains(active))) {
-          firstControl(list)?.focus();
-        }
-      });
-    },
-    select: () => {
-      const control = firstControl(roots);
-      if (control && "select" in control) {
-        control.select();
-      }
-    },
-    setCustomValidity: () => {
-      return;
-    },
-    reportValidity: () => true
-  };
-}
+import {
+  firstControl2,
+  focusHandle2
+} from "../chunks/index-407b6zs0.js";
 export {
-  firstControl,
-  focusHandle
+  firstControl2 as firstControl,
+  focusHandle2 as focusHandle
 };
 
-//# debugId=F6055B3989727FBE64756E2164756E21
+//# debugId=3CD7CAE6F251A45964756E2164756E21
 //# sourceMappingURL=focus-control.js.map

package/dist/lib/focus-control.js.map

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/lib/focus-control.ts"],
+  "sources": [],
   "sourcesContent": [
-    "/** What a user can Tab to inside a field. */\nconst TABBABLE =\n\t'input:not([type=\"hidden\"]):not(:disabled):not([tabindex=\"-1\"]), textarea:not(:disabled):not([tabindex=\"-1\"]), select:not(:disabled):not([tabindex=\"-1\"]), button:not(:disabled):not([tabindex=\"-1\"]), [contenteditable=\"true\"], [tabindex]:not([tabindex=\"-1\"])';\n\n/**\n * The first control of `roots` a user can reach, in document order: one a\n * user can Tab to that is rendered — not a `display: none` input a library\n * keeps for forms. A root that is itself such a control is its own first\n * control. `null` when none is. Reads the DOM when called.\n */\nexport function firstControl(roots: Iterable<Element>): HTMLElement | null {\n\tfor (const root of roots) {\n\t\tconst controls = root.matches(TABBABLE)\n\t\t\t? [root as HTMLElement]\n\t\t\t: root.querySelectorAll<HTMLElement>(TABBABLE);\n\t\tfor (const control of controls) {\n\t\t\tif (control.getClientRects().length) return control;\n\t\t}\n\t}\n\treturn null;\n}\n\n/** What a form library calls on the element a field registered. */\nexport type FocusHandle = {\n\tfocus: () => void;\n\tselect: () => void;\n\tsetCustomValidity: (message: string) => void;\n\treportValidity: () => boolean;\n};\n\n/**\n * A stand-in element for a field made of several controls, for a form\n * library that focuses an invalid field by calling `focus()` on what the\n * field registered (React Hook Form's `field.ref`). `focus()` focuses the\n * first control of `roots` a user can reach, looked up when it is called —\n * `roots` is read live, so pass the field's own set — and again a turn\n * later when focus is not in the field by then: the error that triggered it\n * may re-render the field and replace its control. `select()` selects that\n * control's text when it has any. Native validation is not used:\n * `setCustomValidity` does nothing and `reportValidity` returns `true`.\n */\nexport function focusHandle(roots: Iterable<Element>): FocusHandle {\n\treturn {\n\t\tfocus: () => {\n\t\t\tfirstControl(roots)?.focus();\n\t\t\tsetTimeout(() => {\n\t\t\t\tconst list = [...roots];\n\t\t\t\tconst active = list[0]?.ownerDocument.activeElement ?? null;\n\t\t\t\tif (!list.some((root) => root.contains(active))) {\n\t\t\t\t\tfirstControl(list)?.focus();\n\t\t\t\t}\n\t\t\t});\n\t\t},\n\t\tselect: () => {\n\t\t\tconst control = firstControl(roots);\n\t\t\tif (control && 'select' in control) {\n\t\t\t\t(control as HTMLInputElement).select();\n\t\t\t}\n\t\t},\n\t\tsetCustomValidity: () => undefined,\n\t\treportValidity: () => true,\n\t};\n}\n"
   ],
-  "mappings": ";AACA,IAAM,WACL;AAQM,SAAS,YAAY,CAAC,OAA8C;AAAA,EAC1E,WAAW,QAAQ,OAAO;AAAA,IACzB,MAAM,WAAW,KAAK,QAAQ,QAAQ,IACnC,CAAC,IAAmB,IACpB,KAAK,iBAA8B,QAAQ;AAAA,IAC9C,WAAW,WAAW,UAAU;AAAA,MAC/B,IAAI,QAAQ,eAAe,EAAE;AAAA,QAAQ,OAAO;AAAA,IAC7C;AAAA,EACD;AAAA,EACA,OAAO;AAAA;AAsBD,SAAS,WAAW,CAAC,OAAuC;AAAA,EAClE,OAAO;AAAA,IACN,OAAO,MAAM;AAAA,MACZ,aAAa,KAAK,GAAG,MAAM;AAAA,MAC3B,WAAW,MAAM;AAAA,QAChB,MAAM,OAAO,CAAC,GAAG,KAAK;AAAA,QACtB,MAAM,SAAS,KAAK,IAAI,cAAc,iBAAiB;AAAA,QACvD,IAAI,CAAC,KAAK,KAAK,CAAC,SAAS,KAAK,SAAS,MAAM,CAAC,GAAG;AAAA,UAChD,aAAa,IAAI,GAAG,MAAM;AAAA,QAC3B;AAAA,OACA;AAAA;AAAA,IAEF,QAAQ,MAAM;AAAA,MACb,MAAM,UAAU,aAAa,KAAK;AAAA,MAClC,IAAI,WAAW,YAAY,SAAS;AAAA,QAClC,QAA6B,OAAO;AAAA,MACtC;AAAA;AAAA,IAED,mBAAmB,MAAG;AAAA,MAAG;AAAA;AAAA,IACzB,gBAAgB,MAAM;AAAA,EACvB;AAAA;",
-  "debugId": "F6055B3989727FBE64756E2164756E21",
+  "mappings": "",
+  "debugId": "3CD7CAE6F251A45964756E2164756E21",
   "names": []
 }

package/dist/lib/pdf-download.d.ts

@@ -1,10 +1,5 @@
 import { type PdfSource } from './pdf-source';
-/**
- * How long an object URL outlives the click that started its download or
- * opened its tab. Revoking it synchronously cancels the download in Firefox
- * and Safari, which read the URL after `click()` returns.
- */
-export declare const OBJECT_URL_TTL_MS = 60000;
+export { OBJECT_URL_TTL_MS } from './save-blob';
 export type PdfFileOptions = {
     /** Name of the saved file; `.pdf` is added when missing. */
     fileName?: string;

package/dist/lib/pdf-download.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pdf-download.d.ts","sourceRoot":"","sources":["../../src/lib/pdf-download.ts"],"names":[],"mappings":"AACA,OAAO,EAIN,KAAK,SAAS,EAEd,MAAM,cAAc,CAAC;AAEtB;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAExC,MAAM,MAAM,cAAc,GAAG;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MACP,UAAU,GACV,IAAI,GACJ,SAAS,GACT,OAAO,CAAC,UAAU,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CAC1C,CAAC;AA8EF;;;;;GAKG;AACH,wBAAsB,eAAe,CACpC,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE,cAAmB,iBAW5B;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CACjC,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAM,iBA8B7C"}
+{"version":3,"file":"pdf-download.d.ts","sourceRoot":"","sources":["../../src/lib/pdf-download.ts"],"names":[],"mappings":"AACA,OAAO,EAIN,KAAK,SAAS,EAEd,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,cAAc,GAAG;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MACP,UAAU,GACV,IAAI,GACJ,SAAS,GACT,OAAO,CAAC,UAAU,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CAC1C,CAAC;AAsDF;;;;;GAKG;AACH,wBAAsB,eAAe,CACpC,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE,cAAmB,iBAW5B;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CACjC,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAM,iBA8B7C"}

package/dist/lib/pdf-download.js

@@ -1,8 +1,10 @@
 import {
-  OBJECT_URL_TTL_MS2,
   downloadPdfFile2,
   printPdfFile2
-} from "../chunks/index-h3vjydz7.js";
+} from "../chunks/index-r93kpbtg.js";
+import {
+  OBJECT_URL_TTL_MS2
+} from "../chunks/index-15vj9xbx.js";
 import"../chunks/index-paaaedrm.js";
 import"../chunks/index-5r6rzp43.js";
 export {
@@ -11,5 +13,5 @@ export {
   printPdfFile2 as printPdfFile
 };
 
-//# debugId=A31116C0601A104A64756E2164756E21
+//# debugId=ACA699EE49816B1764756E2164756E21
 //# sourceMappingURL=pdf-download.js.map

package/dist/lib/pdf-download.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "A31116C0601A104A64756E2164756E21",
+  "debugId": "ACA699EE49816B1764756E2164756E21",
   "names": []
 }

package/dist/lib/print-only.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `@nxgt/material-core/print-only` — prints one element of the page and
+ * nothing else, without an inline style or a new window: the page's
+ * stylesheet does the hiding. Both libraries ship the rules (`print-only.css`,
+ * through their `styles.css`): under
+ * `html[data-nxgt-print]`, print media shows only `[data-nxgt-print-target]`.
+ * Reads the DOM only when called.
+ */
+/** Set on `<html>` while printing, to the `name` given to {@link printOnly}. */
+export declare const PRINT_ATTRIBUTE = "data-nxgt-print";
+/** Set on the element being printed. */
+export declare const PRINT_TARGET_ATTRIBUTE = "data-nxgt-print-target";
+/**
+ * Marks `target` as the only thing to print, opens the browser's print
+ * dialog and unmarks it once printing is over: on `afterprint`, or as soon as
+ * `print()` returns where it blocks until the dialog closes (it fired
+ * `beforeprint` before returning). The returned function unmarks it at once —
+ * call it when the element goes away, for a browser whose `print()` returns
+ * early and never says it is done.
+ *
+ * @example
+ * ```ts
+ * const stop = printOnly(card, 'recovery-codes');
+ * // later, when the card unmounts:
+ * stop();
+ * ```
+ */
+export declare function printOnly(target: HTMLElement, name?: string): () => void;
+//# sourceMappingURL=print-only.d.ts.map

package/dist/lib/print-only.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"print-only.d.ts","sourceRoot":"","sources":["../../src/lib/print-only.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,gFAAgF;AAChF,eAAO,MAAM,eAAe,oBAAoB,CAAC;AACjD,wCAAwC;AACxC,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAE/D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,SAAY,GAAG,MAAM,IAAI,CA0B3E"}

package/dist/lib/print-only.js

@@ -0,0 +1,39 @@
+// src/lib/print-only.ts
+var PRINT_ATTRIBUTE = "data-nxgt-print";
+var PRINT_TARGET_ATTRIBUTE = "data-nxgt-print-target";
+function printOnly(target, name = "element") {
+  const doc = target.ownerDocument;
+  const view = doc.defaultView ?? window;
+  const root = doc.documentElement;
+  let began = false;
+  const onBegin = () => {
+    began = true;
+  };
+  const clear = () => {
+    view.removeEventListener("beforeprint", onBegin);
+    view.removeEventListener("afterprint", clear);
+    root.removeAttribute(PRINT_ATTRIBUTE);
+    target.removeAttribute(PRINT_TARGET_ATTRIBUTE);
+  };
+  root.setAttribute(PRINT_ATTRIBUTE, name);
+  target.setAttribute(PRINT_TARGET_ATTRIBUTE, "");
+  view.addEventListener("beforeprint", onBegin);
+  view.addEventListener("afterprint", clear);
+  try {
+    view.print();
+  } catch (error) {
+    clear();
+    throw error;
+  }
+  if (began)
+    clear();
+  return clear;
+}
+export {
+  PRINT_ATTRIBUTE,
+  PRINT_TARGET_ATTRIBUTE,
+  printOnly
+};
+
+//# debugId=BF8B5FF251A0F79964756E2164756E21
+//# sourceMappingURL=print-only.js.map

package/dist/lib/print-only.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/lib/print-only.ts"],
+  "sourcesContent": [
+    "/**\n * `@nxgt/material-core/print-only` — prints one element of the page and\n * nothing else, without an inline style or a new window: the page's\n * stylesheet does the hiding. Both libraries ship the rules (`print-only.css`,\n * through their `styles.css`): under\n * `html[data-nxgt-print]`, print media shows only `[data-nxgt-print-target]`.\n * Reads the DOM only when called.\n */\n\n/** Set on `<html>` while printing, to the `name` given to {@link printOnly}. */\nexport const PRINT_ATTRIBUTE = 'data-nxgt-print';\n/** Set on the element being printed. */\nexport const PRINT_TARGET_ATTRIBUTE = 'data-nxgt-print-target';\n\n/**\n * Marks `target` as the only thing to print, opens the browser's print\n * dialog and unmarks it once printing is over: on `afterprint`, or as soon as\n * `print()` returns where it blocks until the dialog closes (it fired\n * `beforeprint` before returning). The returned function unmarks it at once —\n * call it when the element goes away, for a browser whose `print()` returns\n * early and never says it is done.\n *\n * @example\n * ```ts\n * const stop = printOnly(card, 'recovery-codes');\n * // later, when the card unmounts:\n * stop();\n * ```\n */\nexport function printOnly(target: HTMLElement, name = 'element'): () => void {\n\tconst doc = target.ownerDocument;\n\tconst view = doc.defaultView ?? window;\n\tconst root = doc.documentElement;\n\tlet began = false;\n\tconst onBegin = () => {\n\t\tbegan = true;\n\t};\n\tconst clear = () => {\n\t\tview.removeEventListener('beforeprint', onBegin);\n\t\tview.removeEventListener('afterprint', clear);\n\t\troot.removeAttribute(PRINT_ATTRIBUTE);\n\t\ttarget.removeAttribute(PRINT_TARGET_ATTRIBUTE);\n\t};\n\troot.setAttribute(PRINT_ATTRIBUTE, name);\n\ttarget.setAttribute(PRINT_TARGET_ATTRIBUTE, '');\n\tview.addEventListener('beforeprint', onBegin);\n\tview.addEventListener('afterprint', clear);\n\ttry {\n\t\tview.print();\n\t} catch (error) {\n\t\tclear();\n\t\tthrow error;\n\t}\n\tif (began) clear();\n\treturn clear;\n}\n"
+  ],
+  "mappings": ";AAUO,IAAM,kBAAkB;AAExB,IAAM,yBAAyB;AAiB/B,SAAS,SAAS,CAAC,QAAqB,OAAO,WAAuB;AAAA,EAC5E,MAAM,MAAM,OAAO;AAAA,EACnB,MAAM,OAAO,IAAI,eAAe;AAAA,EAChC,MAAM,OAAO,IAAI;AAAA,EACjB,IAAI,QAAQ;AAAA,EACZ,MAAM,UAAU,MAAM;AAAA,IACrB,QAAQ;AAAA;AAAA,EAET,MAAM,QAAQ,MAAM;AAAA,IACnB,KAAK,oBAAoB,eAAe,OAAO;AAAA,IAC/C,KAAK,oBAAoB,cAAc,KAAK;AAAA,IAC5C,KAAK,gBAAgB,eAAe;AAAA,IACpC,OAAO,gBAAgB,sBAAsB;AAAA;AAAA,EAE9C,KAAK,aAAa,iBAAiB,IAAI;AAAA,EACvC,OAAO,aAAa,wBAAwB,EAAE;AAAA,EAC9C,KAAK,iBAAiB,eAAe,OAAO;AAAA,EAC5C,KAAK,iBAAiB,cAAc,KAAK;AAAA,EACzC,IAAI;AAAA,IACH,KAAK,MAAM;AAAA,IACV,OAAO,OAAO;AAAA,IACf,MAAM;AAAA,IACN,MAAM;AAAA;AAAA,EAEP,IAAI;AAAA,IAAO,MAAM;AAAA,EACjB,OAAO;AAAA;",
+  "debugId": "BF8B5FF251A0F79964756E2164756E21",
+  "names": []
+}

package/dist/lib/repeatable-group.d.ts

@@ -0,0 +1,70 @@
+/** Which way a row moves: towards the first row, or towards the last. */
+export type RowMoveDirection = 'up' | 'down';
+/**
+ * Where the focus goes once a RepeatableGroup's rows have changed: a row's
+ * first field, the Add button, or one of a row's move buttons. Indexes are
+ * 0-based, in the rows as they are after the change.
+ */
+export type RowFocusTarget = {
+    kind: 'field';
+    index: number;
+} | {
+    kind: 'add';
+} | {
+    kind: 'move';
+    index: number;
+    direction: RowMoveDirection;
+};
+/**
+ * What the group's polite live region says about a change. `index`, `from`
+ * and `to` are 1-based: they are what a user reads ("period 2").
+ */
+export type RowAnnouncement = {
+    kind: 'added';
+    index: number;
+} | {
+    kind: 'removed';
+    index: number;
+} | {
+    kind: 'moved';
+    from: number;
+    to: number;
+};
+/** Another row can be added: no `max`, or fewer rows than it. */
+export declare const canAddRow: (count: number, max?: number) => boolean;
+/** A row can be removed: no `min`, or more rows than it. */
+export declare const canRemoveRow: (count: number, min?: number) => boolean;
+/**
+ * The index the row at `index` moves to, or `null` when it cannot move that
+ * way (the first row up, the last one down).
+ */
+export declare function rowMoveTarget(index: number, direction: RowMoveDirection, count: number): number | null;
+/**
+ * Where the focus goes once the row at `removed` is gone and `remaining`
+ * rows are left: the row that took its place, else the row before it (the
+ * last one was removed), else the Add button (no row is left).
+ */
+export declare function focusAfterRemove(removed: number, remaining: number): RowFocusTarget;
+/**
+ * Where the focus goes once a row moved `direction` to `to`: the button that
+ * moved it, so the user can press it again — unless the row can no longer
+ * move that way (it reached the first or the last place, and that button is
+ * now disabled), then the other move button of the same row.
+ */
+export declare function focusAfterMove(to: number, direction: RowMoveDirection, count: number): RowFocusTarget;
+/** The `data-slot` of each row and of its fields. */
+export declare const ROW_SLOT = "repeatable-group-row";
+export declare const ROW_FIELDS_SLOT = "repeatable-group-fields";
+/**
+ * The attribute that marks the Add button: an attribute of its own, as the
+ * button keeps the `data-slot` of the library's Button.
+ */
+export declare const ADD_ATTRIBUTE = "data-repeatable-group-add";
+/**
+ * Moves the focus to `target` inside the group's `root`: the first control a
+ * user can reach in the row's fields, the Add button (`data-repeatable-group-add`), or the row's move
+ * button (`data-move="up"` / `"down"`). Reads the DOM when called; returns
+ * whether something took the focus.
+ */
+export declare function focusRowTarget(root: Element, target: RowFocusTarget): boolean;
+//# sourceMappingURL=repeatable-group.d.ts.map

package/dist/lib/repeatable-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repeatable-group.d.ts","sourceRoot":"","sources":["../../src/lib/repeatable-group.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,MAAM,CAAC;AAE7C;;;;GAIG;AACH,MAAM,MAAM,cAAc,GACvB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAEhE;;;GAGG;AACH,MAAM,MAAM,eAAe,GACxB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/C,iEAAiE;AACjE,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,EAAE,MAAM,MAAM,KAAG,OACvB,CAAC;AAElC,4DAA4D;AAC5D,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,EAAE,MAAM,MAAM,KAAG,OAC1B,CAAC;AAElC;;;GAGG;AACH,wBAAgB,aAAa,CAC5B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,MAAM,GACX,MAAM,GAAG,IAAI,CAGf;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GACf,cAAc,CAGhB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC7B,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,MAAM,GACX,cAAc,CAIhB;AAED,qDAAqD;AACrD,eAAO,MAAM,QAAQ,yBAAyB,CAAC;AAC/C,eAAO,MAAM,eAAe,4BAA4B,CAAC;AACzD;;;GAGG;AACH,eAAO,MAAM,aAAa,8BAA8B,CAAC;AAEzD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAK7E"}

package/dist/lib/repeatable-group.js

@@ -0,0 +1,59 @@
+import {
+  firstControl2
+} from "../chunks/index-407b6zs0.js";
+
+// src/lib/repeatable-group.ts
+var canAddRow = (count, max) => max === undefined || count < max;
+var canRemoveRow = (count, min) => min === undefined || count > min;
+function rowMoveTarget(index, direction, count) {
+  const to = direction === "up" ? index - 1 : index + 1;
+  return to < 0 || to >= count ? null : to;
+}
+function focusAfterRemove(removed, remaining) {
+  if (remaining <= 0)
+    return { kind: "add" };
+  return { kind: "field", index: Math.min(removed, remaining - 1) };
+}
+function focusAfterMove(to, direction, count) {
+  const stays = rowMoveTarget(to, direction, count) !== null;
+  const other = direction === "up" ? "down" : "up";
+  return { kind: "move", index: to, direction: stays ? direction : other };
+}
+var ROW_SLOT = "repeatable-group-row";
+var ROW_FIELDS_SLOT = "repeatable-group-fields";
+var ADD_ATTRIBUTE = "data-repeatable-group-add";
+function focusRowTarget(root, target) {
+  const el = targetElement(root, target);
+  if (!el)
+    return false;
+  el.focus();
+  return el.ownerDocument.activeElement === el;
+}
+function targetElement(root, target) {
+  if (target.kind === "add") {
+    return root.querySelector(`[${ADD_ATTRIBUTE}]`);
+  }
+  const rows = root.querySelectorAll(`[data-slot="${ROW_SLOT}"]`);
+  const row = rows[target.index];
+  if (!row)
+    return null;
+  if (target.kind === "move") {
+    return row.querySelector(`[data-move="${target.direction}"]`);
+  }
+  const fields = row.querySelector(`[data-slot="${ROW_FIELDS_SLOT}"]`);
+  return firstControl2([fields ?? row]);
+}
+export {
+  ADD_ATTRIBUTE,
+  ROW_FIELDS_SLOT,
+  ROW_SLOT,
+  canAddRow,
+  canRemoveRow,
+  focusAfterMove,
+  focusAfterRemove,
+  focusRowTarget,
+  rowMoveTarget
+};
+
+//# debugId=EF31DAFB676F33B564756E2164756E21
+//# sourceMappingURL=repeatable-group.js.map

package/dist/lib/repeatable-group.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/lib/repeatable-group.ts"],
+  "sourcesContent": [
+    "import { firstControl } from './focus-control';\n\n/** Which way a row moves: towards the first row, or towards the last. */\nexport type RowMoveDirection = 'up' | 'down';\n\n/**\n * Where the focus goes once a RepeatableGroup's rows have changed: a row's\n * first field, the Add button, or one of a row's move buttons. Indexes are\n * 0-based, in the rows as they are after the change.\n */\nexport type RowFocusTarget =\n\t| { kind: 'field'; index: number }\n\t| { kind: 'add' }\n\t| { kind: 'move'; index: number; direction: RowMoveDirection };\n\n/**\n * What the group's polite live region says about a change. `index`, `from`\n * and `to` are 1-based: they are what a user reads (\"period 2\").\n */\nexport type RowAnnouncement =\n\t| { kind: 'added'; index: number }\n\t| { kind: 'removed'; index: number }\n\t| { kind: 'moved'; from: number; to: number };\n\n/** Another row can be added: no `max`, or fewer rows than it. */\nexport const canAddRow = (count: number, max?: number): boolean =>\n\tmax === undefined || count < max;\n\n/** A row can be removed: no `min`, or more rows than it. */\nexport const canRemoveRow = (count: number, min?: number): boolean =>\n\tmin === undefined || count > min;\n\n/**\n * The index the row at `index` moves to, or `null` when it cannot move that\n * way (the first row up, the last one down).\n */\nexport function rowMoveTarget(\n\tindex: number,\n\tdirection: RowMoveDirection,\n\tcount: number,\n): number | null {\n\tconst to = direction === 'up' ? index - 1 : index + 1;\n\treturn to < 0 || to >= count ? null : to;\n}\n\n/**\n * Where the focus goes once the row at `removed` is gone and `remaining`\n * rows are left: the row that took its place, else the row before it (the\n * last one was removed), else the Add button (no row is left).\n */\nexport function focusAfterRemove(\n\tremoved: number,\n\tremaining: number,\n): RowFocusTarget {\n\tif (remaining <= 0) return { kind: 'add' };\n\treturn { kind: 'field', index: Math.min(removed, remaining - 1) };\n}\n\n/**\n * Where the focus goes once a row moved `direction` to `to`: the button that\n * moved it, so the user can press it again — unless the row can no longer\n * move that way (it reached the first or the last place, and that button is\n * now disabled), then the other move button of the same row.\n */\nexport function focusAfterMove(\n\tto: number,\n\tdirection: RowMoveDirection,\n\tcount: number,\n): RowFocusTarget {\n\tconst stays = rowMoveTarget(to, direction, count) !== null;\n\tconst other: RowMoveDirection = direction === 'up' ? 'down' : 'up';\n\treturn { kind: 'move', index: to, direction: stays ? direction : other };\n}\n\n/** The `data-slot` of each row and of its fields. */\nexport const ROW_SLOT = 'repeatable-group-row';\nexport const ROW_FIELDS_SLOT = 'repeatable-group-fields';\n/**\n * The attribute that marks the Add button: an attribute of its own, as the\n * button keeps the `data-slot` of the library's Button.\n */\nexport const ADD_ATTRIBUTE = 'data-repeatable-group-add';\n\n/**\n * Moves the focus to `target` inside the group's `root`: the first control a\n * user can reach in the row's fields, the Add button (`data-repeatable-group-add`), or the row's move\n * button (`data-move=\"up\"` / `\"down\"`). Reads the DOM when called; returns\n * whether something took the focus.\n */\nexport function focusRowTarget(root: Element, target: RowFocusTarget): boolean {\n\tconst el = targetElement(root, target);\n\tif (!el) return false;\n\tel.focus();\n\treturn el.ownerDocument.activeElement === el;\n}\n\nfunction targetElement(\n\troot: Element,\n\ttarget: RowFocusTarget,\n): HTMLElement | null {\n\tif (target.kind === 'add') {\n\t\treturn root.querySelector<HTMLElement>(`[${ADD_ATTRIBUTE}]`);\n\t}\n\tconst rows = root.querySelectorAll(`[data-slot=\"${ROW_SLOT}\"]`);\n\tconst row = rows[target.index];\n\tif (!row) return null;\n\tif (target.kind === 'move') {\n\t\treturn row.querySelector<HTMLElement>(`[data-move=\"${target.direction}\"]`);\n\t}\n\tconst fields = row.querySelector(`[data-slot=\"${ROW_FIELDS_SLOT}\"]`);\n\treturn firstControl([fields ?? row]);\n}\n"
+  ],
+  "mappings": ";;;;;AAyBO,IAAM,YAAY,CAAC,OAAe,QACxC,QAAQ,aAAa,QAAQ;AAGvB,IAAM,eAAe,CAAC,OAAe,QAC3C,QAAQ,aAAa,QAAQ;AAMvB,SAAS,aAAa,CAC5B,OACA,WACA,OACgB;AAAA,EAChB,MAAM,KAAK,cAAc,OAAO,QAAQ,IAAI,QAAQ;AAAA,EACpD,OAAO,KAAK,KAAK,MAAM,QAAQ,OAAO;AAAA;AAQhC,SAAS,gBAAgB,CAC/B,SACA,WACiB;AAAA,EACjB,IAAI,aAAa;AAAA,IAAG,OAAO,EAAE,MAAM,MAAM;AAAA,EACzC,OAAO,EAAE,MAAM,SAAS,OAAO,KAAK,IAAI,SAAS,YAAY,CAAC,EAAE;AAAA;AAS1D,SAAS,cAAc,CAC7B,IACA,WACA,OACiB;AAAA,EACjB,MAAM,QAAQ,cAAc,IAAI,WAAW,KAAK,MAAM;AAAA,EACtD,MAAM,QAA0B,cAAc,OAAO,SAAS;AAAA,EAC9D,OAAO,EAAE,MAAM,QAAQ,OAAO,IAAI,WAAW,QAAQ,YAAY,MAAM;AAAA;AAIjE,IAAM,WAAW;AACjB,IAAM,kBAAkB;AAKxB,IAAM,gBAAgB;AAQtB,SAAS,cAAc,CAAC,MAAe,QAAiC;AAAA,EAC9E,MAAM,KAAK,cAAc,MAAM,MAAM;AAAA,EACrC,IAAI,CAAC;AAAA,IAAI,OAAO;AAAA,EAChB,GAAG,MAAM;AAAA,EACT,OAAO,GAAG,cAAc,kBAAkB;AAAA;AAG3C,SAAS,aAAa,CACrB,MACA,QACqB;AAAA,EACrB,IAAI,OAAO,SAAS,OAAO;AAAA,IAC1B,OAAO,KAAK,cAA2B,IAAI,gBAAgB;AAAA,EAC5D;AAAA,EACA,MAAM,OAAO,KAAK,iBAAiB,eAAe,YAAY;AAAA,EAC9D,MAAM,MAAM,KAAK,OAAO;AAAA,EACxB,IAAI,CAAC;AAAA,IAAK,OAAO;AAAA,EACjB,IAAI,OAAO,SAAS,QAAQ;AAAA,IAC3B,OAAO,IAAI,cAA2B,eAAe,OAAO,aAAa;AAAA,EAC1E;AAAA,EACA,MAAM,SAAS,IAAI,cAAc,eAAe,mBAAmB;AAAA,EACnE,OAAO,cAAa,CAAC,UAAU,GAAG,CAAC;AAAA;",
+  "debugId": "EF31DAFB676F33B564756E2164756E21",
+  "names": []
+}

package/dist/lib/save-blob.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Saving a Blob as a file through a temporary `<a download>`: what
+ * `/pdf-download` and `/two-factor`'s `downloadText` share. Reads the DOM
+ * only when called.
+ */
+/**
+ * How long an object URL outlives the click that started its download or
+ * opened its tab. Revoking it synchronously cancels the download in Firefox
+ * and Safari, which read the URL after `click()` returns.
+ */
+export declare const OBJECT_URL_TTL_MS = 60000;
+export declare function revokeLater(url: string): void;
+export declare function clickLink(href: string, attributes: Record<string, string>): void;
+/** Saves a Blob under `fileName`, and revokes its URL once the save began. */
+export declare function saveBlob(blob: Blob, fileName: string): void;
+//# sourceMappingURL=save-blob.d.ts.map

package/dist/lib/save-blob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-blob.d.ts","sourceRoot":"","sources":["../../src/lib/save-blob.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAExC,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,QAEtC;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,QAWzE;AAED,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,QAIpD"}

package/dist/lib/submit-guard.d.ts

@@ -0,0 +1,72 @@
+/** How {@link SubmitGuard.once} treats what `run` returns. */
+export type SubmitOnceOptions = {
+    /**
+     * A result that is not a promise (a handler that returned early, say)
+     * settles the guard at once. Default `false`: the guard then waits for
+     * `settle()`, which suits a request followed by a busy flag
+     * ({@link busySettler}). Without one, return the request's promise or set
+     * this.
+     */
+    settleSync?: boolean;
+};
+/** One submit in flight: see {@link createSubmitGuard}. */
+export type SubmitGuard = {
+    /**
+     * `run`, wrapped so it runs only when no submit is on its way. The wrapper
+     * returns what `run` returned — a promise as one that settles as `run`'s
+     * does, rejection included — or `undefined` when the call was dropped.
+     * A dropped call whose first argument is an event (a form's `submit`)
+     * has its default prevented, so it never falls back to the browser's own
+     * submission, which would reload the page.
+     */
+    once<A extends unknown[], R>(run: (...args: A) => R, options?: SubmitOnceOptions): (...args: A) => R | undefined;
+    /**
+     * Opens the guard again: the next call goes through. Given a run (from
+     * {@link SubmitGuard.pendingRun}), only while that run is still the one
+     * on its way: a late `settle(run)` never reopens it over a newer one.
+     */
+    settle(run?: number): void;
+    /** The run on its way (an increasing number), or `undefined` when open. */
+    pendingRun(): number | undefined;
+};
+/**
+ * Lets one submit through until the request it started settles. A second
+ * click, or Enter, before the busy state renders (a disabled or loading
+ * button only stops clicks once rendered, and never Enter) would post again,
+ * and may abort the first request mid-call.
+ *
+ * `settle()` opens it again. A `run` that returns a promise settles it when
+ * that promise ends, fulfilled or rejected; a `run` that throws settles it
+ * and rethrows; any other result keeps it closed until `settle()`, unless
+ * `once(run, { settleSync: true })`. So: return the request's promise, or
+ * follow the request with a busy flag ({@link busySettler}). The guard never
+ * swallows a rejection: the promise the wrapper returns rejects as `run`'s
+ * did, for the caller to handle (left unhandled, it is reported as `run`'s
+ * would have been), and the guard adds no promise of its own that could
+ * reject unhandled.
+ *
+ * @example
+ * ```ts
+ * const guard = createSubmitGuard();
+ * const submit = guard.once((values: Values) => save(values));
+ * form.addEventListener('submit', (event) => {
+ *   event.preventDefault();
+ *   submit(read(form)); // a second submit before `save` ends is dropped
+ * });
+ * ```
+ */
+export declare function createSubmitGuard(): SubmitGuard;
+/**
+ * Follows a request's busy flag for `guard`: call the function it returns
+ * with each value of the flag. Once the flag was true and is false again, it
+ * settles the run that was on its way when the flag rose — never a newer one
+ * — or, when none was, the run on its way when it falls.
+ *
+ * @example
+ * ```ts
+ * const onBusy = busySettler(guard);
+ * router.subscribe((state) => onBusy(state.navigation.state !== 'idle'));
+ * ```
+ */
+export declare function busySettler(guard: SubmitGuard): (busy: boolean) => void;
+//# sourceMappingURL=submit-guard.d.ts.map

package/dist/lib/submit-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit-guard.d.ts","sourceRoot":"","sources":["../../src/lib/submit-guard.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,MAAM,MAAM,iBAAiB,GAAG;IAC/B;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,2DAA2D;AAC3D,MAAM,MAAM,WAAW,GAAG;IACzB;;;;;;;OAOG;IACH,IAAI,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EAC1B,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,EACtB,OAAO,CAAC,EAAE,iBAAiB,GACzB,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;IACjC;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,2EAA2E;IAC3E,UAAU,IAAI,MAAM,GAAG,SAAS,CAAC;CACjC,CAAC;AAcF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAuC/C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAcvE"}

package/dist/lib/submit-guard.js

@@ -0,0 +1,69 @@
+// src/lib/submit-guard.ts
+var preventDefault = (event) => {
+  const target = event;
+  if (typeof target?.preventDefault === "function")
+    event.preventDefault();
+};
+var isThenable = (value) => typeof value === "object" && value !== null && typeof value.then === "function";
+function createSubmitGuard() {
+  let pending = false;
+  let run = 0;
+  const settle = (id) => {
+    if (id === undefined || id === run)
+      pending = false;
+  };
+  return {
+    once(submit, options = {}) {
+      return (...args) => {
+        if (pending) {
+          preventDefault(args[0]);
+          return;
+        }
+        pending = true;
+        run += 1;
+        const id = run;
+        let ran;
+        try {
+          ran = submit(...args);
+        } catch (error) {
+          settle(id);
+          throw error;
+        }
+        if (!isThenable(ran)) {
+          if (options.settleSync)
+            settle(id);
+          return ran;
+        }
+        const settled = Promise.resolve(ran).finally(() => settle(id));
+        return settled;
+      };
+    },
+    settle,
+    pendingRun: () => pending ? run : undefined
+  };
+}
+function busySettler(guard) {
+  let rose = false;
+  let runAtRise;
+  return (busy) => {
+    if (busy) {
+      if (!rose)
+        runAtRise = guard.pendingRun();
+      rose = true;
+      return;
+    }
+    if (!rose)
+      return;
+    rose = false;
+    const run = runAtRise ?? guard.pendingRun();
+    if (run !== undefined)
+      guard.settle(run);
+  };
+}
+export {
+  busySettler,
+  createSubmitGuard
+};
+
+//# debugId=0F5FC92C3A2BF8E064756E2164756E21
+//# sourceMappingURL=submit-guard.js.map

package/dist/lib/submit-guard.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/lib/submit-guard.ts"],
+  "sourcesContent": [
+    "/** How {@link SubmitGuard.once} treats what `run` returns. */\nexport type SubmitOnceOptions = {\n\t/**\n\t * A result that is not a promise (a handler that returned early, say)\n\t * settles the guard at once. Default `false`: the guard then waits for\n\t * `settle()`, which suits a request followed by a busy flag\n\t * ({@link busySettler}). Without one, return the request's promise or set\n\t * this.\n\t */\n\tsettleSync?: boolean;\n};\n\n/** One submit in flight: see {@link createSubmitGuard}. */\nexport type SubmitGuard = {\n\t/**\n\t * `run`, wrapped so it runs only when no submit is on its way. The wrapper\n\t * returns what `run` returned — a promise as one that settles as `run`'s\n\t * does, rejection included — or `undefined` when the call was dropped.\n\t * A dropped call whose first argument is an event (a form's `submit`)\n\t * has its default prevented, so it never falls back to the browser's own\n\t * submission, which would reload the page.\n\t */\n\tonce<A extends unknown[], R>(\n\t\trun: (...args: A) => R,\n\t\toptions?: SubmitOnceOptions,\n\t): (...args: A) => R | undefined;\n\t/**\n\t * Opens the guard again: the next call goes through. Given a run (from\n\t * {@link SubmitGuard.pendingRun}), only while that run is still the one\n\t * on its way: a late `settle(run)` never reopens it over a newer one.\n\t */\n\tsettle(run?: number): void;\n\t/** The run on its way (an increasing number), or `undefined` when open. */\n\tpendingRun(): number | undefined;\n};\n\n/** Prevents the default of a dropped call's event, if it carries one. */\nconst preventDefault = (event: unknown) => {\n\tconst target = event as { preventDefault?: unknown } | null;\n\tif (typeof target?.preventDefault === 'function')\n\t\t(event as Event).preventDefault();\n};\n\nconst isThenable = (value: unknown): value is PromiseLike<unknown> =>\n\ttypeof value === 'object' &&\n\tvalue !== null &&\n\ttypeof (value as { then?: unknown }).then === 'function';\n\n/**\n * Lets one submit through until the request it started settles. A second\n * click, or Enter, before the busy state renders (a disabled or loading\n * button only stops clicks once rendered, and never Enter) would post again,\n * and may abort the first request mid-call.\n *\n * `settle()` opens it again. A `run` that returns a promise settles it when\n * that promise ends, fulfilled or rejected; a `run` that throws settles it\n * and rethrows; any other result keeps it closed until `settle()`, unless\n * `once(run, { settleSync: true })`. So: return the request's promise, or\n * follow the request with a busy flag ({@link busySettler}). The guard never\n * swallows a rejection: the promise the wrapper returns rejects as `run`'s\n * did, for the caller to handle (left unhandled, it is reported as `run`'s\n * would have been), and the guard adds no promise of its own that could\n * reject unhandled.\n *\n * @example\n * ```ts\n * const guard = createSubmitGuard();\n * const submit = guard.once((values: Values) => save(values));\n * form.addEventListener('submit', (event) => {\n *   event.preventDefault();\n *   submit(read(form)); // a second submit before `save` ends is dropped\n * });\n * ```\n */\nexport function createSubmitGuard(): SubmitGuard {\n\tlet pending = false;\n\t// Which run is on its way: an older run's promise (or busy flag) ending\n\t// late never reopens the guard over a newer one.\n\tlet run = 0;\n\tconst settle = (id?: number) => {\n\t\tif (id === undefined || id === run) pending = false;\n\t};\n\treturn {\n\t\tonce(submit, options = {}) {\n\t\t\treturn (...args) => {\n\t\t\t\tif (pending) {\n\t\t\t\t\tpreventDefault(args[0]);\n\t\t\t\t\treturn undefined;\n\t\t\t\t}\n\t\t\t\tpending = true;\n\t\t\t\trun += 1;\n\t\t\t\tconst id = run;\n\t\t\t\tlet ran: ReturnType<typeof submit>;\n\t\t\t\ttry {\n\t\t\t\t\tran = submit(...args);\n\t\t\t\t} catch (error) {\n\t\t\t\t\tsettle(id);\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t\tif (!isThenable(ran)) {\n\t\t\t\t\tif (options.settleSync) settle(id);\n\t\t\t\t\treturn ran;\n\t\t\t\t}\n\t\t\t\t// The one chain on `ran`, handed back: a rejection reaches the\n\t\t\t\t// caller, never a second, unhandled promise. It is the same\n\t\t\t\t// promise type for a native promise (`Promise.resolve` returns it).\n\t\t\t\tconst settled = Promise.resolve(ran).finally(() => settle(id));\n\t\t\t\treturn settled as unknown as typeof ran;\n\t\t\t};\n\t\t},\n\t\tsettle,\n\t\tpendingRun: () => (pending ? run : undefined),\n\t};\n}\n\n/**\n * Follows a request's busy flag for `guard`: call the function it returns\n * with each value of the flag. Once the flag was true and is false again, it\n * settles the run that was on its way when the flag rose — never a newer one\n * — or, when none was, the run on its way when it falls.\n *\n * @example\n * ```ts\n * const onBusy = busySettler(guard);\n * router.subscribe((state) => onBusy(state.navigation.state !== 'idle'));\n * ```\n */\nexport function busySettler(guard: SubmitGuard): (busy: boolean) => void {\n\tlet rose = false;\n\tlet runAtRise: number | undefined;\n\treturn (busy) => {\n\t\tif (busy) {\n\t\t\tif (!rose) runAtRise = guard.pendingRun();\n\t\t\trose = true;\n\t\t\treturn;\n\t\t}\n\t\tif (!rose) return;\n\t\trose = false;\n\t\tconst run = runAtRise ?? guard.pendingRun();\n\t\tif (run !== undefined) guard.settle(run);\n\t};\n}\n"
+  ],
+  "mappings": ";AAqCA,IAAM,iBAAiB,CAAC,UAAmB;AAAA,EAC1C,MAAM,SAAS;AAAA,EACf,IAAI,OAAO,QAAQ,mBAAmB;AAAA,IACpC,MAAgB,eAAe;AAAA;AAGlC,IAAM,aAAa,CAAC,UACnB,OAAO,UAAU,YACjB,UAAU,QACV,OAAQ,MAA6B,SAAS;AA4BxC,SAAS,iBAAiB,GAAgB;AAAA,EAChD,IAAI,UAAU;AAAA,EAGd,IAAI,MAAM;AAAA,EACV,MAAM,SAAS,CAAC,OAAgB;AAAA,IAC/B,IAAI,OAAO,aAAa,OAAO;AAAA,MAAK,UAAU;AAAA;AAAA,EAE/C,OAAO;AAAA,IACN,IAAI,CAAC,QAAQ,UAAU,CAAC,GAAG;AAAA,MAC1B,OAAO,IAAI,SAAS;AAAA,QACnB,IAAI,SAAS;AAAA,UACZ,eAAe,KAAK,EAAE;AAAA,UACtB;AAAA,QACD;AAAA,QACA,UAAU;AAAA,QACV,OAAO;AAAA,QACP,MAAM,KAAK;AAAA,QACX,IAAI;AAAA,QACJ,IAAI;AAAA,UACH,MAAM,OAAO,GAAG,IAAI;AAAA,UACnB,OAAO,OAAO;AAAA,UACf,OAAO,EAAE;AAAA,UACT,MAAM;AAAA;AAAA,QAEP,IAAI,CAAC,WAAW,GAAG,GAAG;AAAA,UACrB,IAAI,QAAQ;AAAA,YAAY,OAAO,EAAE;AAAA,UACjC,OAAO;AAAA,QACR;AAAA,QAIA,MAAM,UAAU,QAAQ,QAAQ,GAAG,EAAE,QAAQ,MAAM,OAAO,EAAE,CAAC;AAAA,QAC7D,OAAO;AAAA;AAAA;AAAA,IAGT;AAAA,IACA,YAAY,MAAO,UAAU,MAAM;AAAA,EACpC;AAAA;AAeM,SAAS,WAAW,CAAC,OAA6C;AAAA,EACxE,IAAI,OAAO;AAAA,EACX,IAAI;AAAA,EACJ,OAAO,CAAC,SAAS;AAAA,IAChB,IAAI,MAAM;AAAA,MACT,IAAI,CAAC;AAAA,QAAM,YAAY,MAAM,WAAW;AAAA,MACxC,OAAO;AAAA,MACP;AAAA,IACD;AAAA,IACA,IAAI,CAAC;AAAA,MAAM;AAAA,IACX,OAAO;AAAA,IACP,MAAM,MAAM,aAAa,MAAM,WAAW;AAAA,IAC1C,IAAI,QAAQ;AAAA,MAAW,MAAM,OAAO,GAAG;AAAA;AAAA;",
+  "debugId": "0F5FC92C3A2BF8E064756E2164756E21",
+  "names": []
+}