@gusnips/react 0.9.24 → 0.9.26

package/dist/commands.js.map

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

package/dist/copy.d.ts

@@ -8,9 +8,9 @@ export interface CopyOptions {
     failedMs?: number;
 }
 /**
- * A copy with an outcome the reader can see. What it says stays yours — "Copied", or "Select it
- * and copy it yourself", in a label or a toast — and so does announcing it: a label that changes
- * needs `aria-live="polite"` to be heard.
+ * A copy with an outcome the reader can see. You choose what it says, such as "Copied" or "Select
+ * it and copy it yourself", in a label or a toast. You also choose how to announce it: a label that
+ * changes needs `aria-live="polite"` to be heard.
  *
  * The outcome goes back to `"idle"` on its own. A "Copied" that never clears makes the second copy
  * look like it did not take.

package/dist/copy.js

@@ -18,9 +18,9 @@ export async function copyText(text) {
     }
 }
 /**
- * A copy with an outcome the reader can see. What it says stays yours — "Copied", or "Select it
- * and copy it yourself", in a label or a toast — and so does announcing it: a label that changes
- * needs `aria-live="polite"` to be heard.
+ * A copy with an outcome the reader can see. You choose what it says, such as "Copied" or "Select
+ * it and copy it yourself", in a label or a toast. You also choose how to announce it: a label that
+ * changes needs `aria-live="polite"` to be heard.
  *
  * The outcome goes back to `"idle"` on its own. A "Copied" that never clears makes the second copy
  * look like it did not take.

package/dist/deploy-recovery.d.ts

@@ -5,26 +5,26 @@
  * every hashed asset underneath whatever tabs are already open, and those tabs go on running
  * yesterday's bundle. It surfaces two ways, and only one of them looks like a missing file:
  *
- *   1. The next navigation asks for a chunk whose hashed name is gone. React's lazy boundary
- *      throws, and the person gets a white screen on a click that worked a minute ago.
- *   2. The old bundle reads a field the API has since renamed, and throws. That one arrives as a
- *      plain `TypeError` with nothing in it about a deploy — no file, no hash, no signal.
+ * 1. The next navigation asks for a chunk whose hashed name is gone. React's lazy boundary throws,
+ * and the person gets a white screen on a click that worked a minute ago. 2. The old bundle reads a
+ * field the API has since renamed, and throws. That one arrives as a plain `TypeError` with nothing
+ * in it about a deploy: no file, no hash, no signal.
  *
  * So there are two detectors here and they are not interchangeable. {@link isChunkLoadError}
- * matches the message, which is all you have for a failure that never reaches a boundary.
- * {@link isStaleBuild} asks the server, which is evidence rather than a guess — and it is the
- * only one that catches case 2 at all.
+ * matches the message, which is all you have for a failure that never reaches a boundary. {@link
+ * isStaleBuild} asks the server for evidence rather than a guess. It is the only one that catches
+ * case 2 at all.
  *
  * **The deepest fix is not in this file, and it is worth more than everything in it.** A static
- * host answers a missing `/assets/x.js` with the SPA fallback — `index.html`, at a 200, as
- * `text/html` — which is what the browser's "MIME type text/html" module-script refusal actually
- * is. Hosts then match cache rules against the REQUEST PATH rather than the outcome, so the
- * `immutable, max-age=31536000` rule written for hashed assets gets applied to that HTML body:
- * one poisoned asset URL, at the edge and in every browser that touched it, for a year. One
- * adopter removed the cause instead of recovering from it — no blanket fallback over `/assets/`,
- * and an edge function that refuses to answer an asset path with `text/html` — which turns a
- * dead chunk into a real, uncacheable 404 and lets everything below be recovery rather than the
- * plan. A package cannot ship that; it can refuse to let it go unwritten.
+ * host answers a missing `/assets/x.js` with the SPA fallback, `index.html`, at a 200, as
+ * `text/html`. That is what the browser's "MIME type text/html" module-script refusal actually is.
+ * Hosts then match cache rules against the REQUEST PATH rather than the outcome, so the `immutable,
+ * max-age=31536000` rule written for hashed assets gets applied to that HTML body: one poisoned
+ * asset URL, at the edge and in every browser that touched it, for a year. One adopter removed the
+ * cause instead of recovering from it: no blanket fallback over `/assets/`, and an edge function
+ * that refuses to answer an asset path with `text/html`. That turns a dead chunk into a real,
+ * uncacheable 404 and lets everything below be recovery rather than the plan. A package cannot ship
+ * that; it can refuse to let it go unwritten.
  */
 /**
  * One stamp for every reason to reload, which is the part that is easy to get wrong.
@@ -40,14 +40,14 @@
  */
 export declare const RELOAD_GUARD_KEY = "frontkit:reload-at";
 /**
- * A lazy-chunk fetch failure — recoverable by reloading.
+ * A lazy-chunk fetch failure that a reload can fix.
  *
- * Matched by message because no browser gives it a shared type. Every phrasing in the wild is
- * here: Chrome/Edge "Failed to fetch dynamically imported module", Firefox "error loading
- * dynamically imported module", Safari "Importing a module script failed", webpack's
- * ChunkLoadError and "Loading chunk N failed", and the SPA-fallback "MIME type" refusal —
- * which is the one that fires on a static host that has not fixed the cause above, because the
- * missing `.js` is answered with `index.html`.
+ * Matched by message because no browser gives it a shared type. Every phrasing in the wild is here:
+ * Chrome/Edge "Failed to fetch dynamically imported module", Firefox "error loading dynamically
+ * imported module", Safari "Importing a module script failed", webpack's ChunkLoadError and
+ * "Loading chunk N failed", and the SPA-fallback "MIME type" refusal. The last one that fires on a
+ * static host that has not fixed the cause above, because the missing `.js` is answered with
+ * `index.html`.
  *
  * A standalone predicate rather than a method on the boundary, so a global `unhandledrejection`
  * handler can classify the same failure without importing a component.
@@ -56,13 +56,13 @@ export declare function isChunkLoadError(error: unknown): boolean;
 /**
  * Is the build this tab is running still the one being served?
  *
- * Asked of the server, so the answer is evidence rather than a guess. Everything ambiguous —
- * offline, a non-200, a captive portal, a probe that times out — resolves to `false`: dressing a
- * genuine bug up as an update hides it from the user and from us.
+ * Asked of the server, so the answer is evidence rather than a guess. An offline request, a non-200
+ * response, a captive portal or a timed-out probe resolves to `false`: dressing a genuine bug up as
+ * an update hides it from the user and from us.
  *
  * It asks for the PAGE, not for the asset, and that is not the obvious choice. A missing asset
  * looks like the direct question, but a CDN commonly serves assets with a long `s-maxage`, so a
- * bundle a deploy retired an hour ago still answers 200 from the edge — it would report "current"
+ * bundle a deploy retired an hour ago still answers 200 from the edge. It would report "current"
  * during exactly the window when skew is most likely. The page is the one URL that cannot lie: it
  * ships `max-age=0, must-revalidate` and never enters the edge cache.
  */
@@ -73,9 +73,9 @@ export declare function isStaleBuild(): Promise<boolean>;
  * rather than watching the same attempt loop.
  *
  * The guard is the part that matters. Reloading on a failure is obvious; reloading on a failure
- * that the reload does not fix is an infinite loop with the user inside it. At most one reload
- * per minute, so a genuinely broken deploy degrades to the error screen — which can at least say
- * something — instead of flickering forever.
+ * that the reload does not fix is an infinite loop with the user inside it. At most one reload per
+ * minute, so a genuinely broken deploy shows the error screen instead of flickering forever. That
+ * screen can at least say something.
  *
  * `sessionStorage` and not `localStorage`: the guard is about this tab's current predicament, and
  * a stale stamp in another tab must not suppress a reload this one needs. Wrapped because storage
@@ -86,22 +86,22 @@ export declare function reloadOnce(): boolean;
 /**
  * Vite's *hint* failure, which is not the same thing and must not be treated as one.
  *
- * Vite injects a speculative `<link rel="stylesheet">` for a chunk's CSS before importing it.
- * When that link fails, the import itself still runs right after and usually succeeds — so this
- * one is worth swallowing, where a failure of the import is the real thing
- * {@link isChunkLoadError} matches. Vite builds this message in exactly one place and only ever
- * for a stylesheet link; script hints never reject.
+ * Vite injects a speculative `<link rel="stylesheet">` for a chunk's CSS before importing it. When
+ * that link fails, the import itself still runs right after and usually succeeds, so this one is
+ * worth swallowing, where a failure of the import is the real thing {@link isChunkLoadError}
+ * matches. Vite builds this message in exactly one place and only ever for a stylesheet link;
+ * script hints never reject.
  */
 export declare function isPreloadHintFailure(error: unknown): boolean;
 /**
  * Install the `vite:preloadError` listener. Call once, from the browser entry.
  *
- * Vite offers `preventDefault()` here so an app can own a failed asset itself — but taking that
- * deal unconditionally resolves the dynamic import with `undefined` (Vite's helper ends in
+ * Vite offers `preventDefault()` here so an app can own a failed asset itself, but taking that deal
+ * unconditionally resolves the dynamic import with `undefined` (Vite's helper ends in
  * `baseModule().catch(handlePreloadError)`), and `React.lazy` then reads `.default` off nothing.
- * The user gets the crash screen and the developer gets a TypeError with only React frames in
- * it, naming no chunk. So it is taken ONLY for a failed preload hint, where the import still
- * runs. A real module failure is left to throw, where the error boundary can recognise it.
+ * The user gets the crash screen and the developer gets a TypeError with only React frames in it,
+ * naming no chunk. So it is taken ONLY for a failed preload hint, where the import still runs. A
+ * real module failure is left to throw, where the error boundary can recognise it.
  */
 export declare function installPreloadErrorHandler(): void;
 //# sourceMappingURL=deploy-recovery.d.ts.map

package/dist/deploy-recovery.js

@@ -5,26 +5,26 @@
  * every hashed asset underneath whatever tabs are already open, and those tabs go on running
  * yesterday's bundle. It surfaces two ways, and only one of them looks like a missing file:
  *
- *   1. The next navigation asks for a chunk whose hashed name is gone. React's lazy boundary
- *      throws, and the person gets a white screen on a click that worked a minute ago.
- *   2. The old bundle reads a field the API has since renamed, and throws. That one arrives as a
- *      plain `TypeError` with nothing in it about a deploy — no file, no hash, no signal.
+ * 1. The next navigation asks for a chunk whose hashed name is gone. React's lazy boundary throws,
+ * and the person gets a white screen on a click that worked a minute ago. 2. The old bundle reads a
+ * field the API has since renamed, and throws. That one arrives as a plain `TypeError` with nothing
+ * in it about a deploy: no file, no hash, no signal.
  *
  * So there are two detectors here and they are not interchangeable. {@link isChunkLoadError}
- * matches the message, which is all you have for a failure that never reaches a boundary.
- * {@link isStaleBuild} asks the server, which is evidence rather than a guess — and it is the
- * only one that catches case 2 at all.
+ * matches the message, which is all you have for a failure that never reaches a boundary. {@link
+ * isStaleBuild} asks the server for evidence rather than a guess. It is the only one that catches
+ * case 2 at all.
  *
  * **The deepest fix is not in this file, and it is worth more than everything in it.** A static
- * host answers a missing `/assets/x.js` with the SPA fallback — `index.html`, at a 200, as
- * `text/html` — which is what the browser's "MIME type text/html" module-script refusal actually
- * is. Hosts then match cache rules against the REQUEST PATH rather than the outcome, so the
- * `immutable, max-age=31536000` rule written for hashed assets gets applied to that HTML body:
- * one poisoned asset URL, at the edge and in every browser that touched it, for a year. One
- * adopter removed the cause instead of recovering from it — no blanket fallback over `/assets/`,
- * and an edge function that refuses to answer an asset path with `text/html` — which turns a
- * dead chunk into a real, uncacheable 404 and lets everything below be recovery rather than the
- * plan. A package cannot ship that; it can refuse to let it go unwritten.
+ * host answers a missing `/assets/x.js` with the SPA fallback, `index.html`, at a 200, as
+ * `text/html`. That is what the browser's "MIME type text/html" module-script refusal actually is.
+ * Hosts then match cache rules against the REQUEST PATH rather than the outcome, so the `immutable,
+ * max-age=31536000` rule written for hashed assets gets applied to that HTML body: one poisoned
+ * asset URL, at the edge and in every browser that touched it, for a year. One adopter removed the
+ * cause instead of recovering from it: no blanket fallback over `/assets/`, and an edge function
+ * that refuses to answer an asset path with `text/html`. That turns a dead chunk into a real,
+ * uncacheable 404 and lets everything below be recovery rather than the plan. A package cannot ship
+ * that; it can refuse to let it go unwritten.
  */
 /**
  * One stamp for every reason to reload, which is the part that is easy to get wrong.
@@ -44,14 +44,14 @@ const RELOAD_WINDOW_MS = 60_000;
  *  land on the real error screen instead of an endless spinner. */
 const PROBE_TIMEOUT_MS = 4_000;
 /**
- * A lazy-chunk fetch failure — recoverable by reloading.
+ * A lazy-chunk fetch failure that a reload can fix.
  *
- * Matched by message because no browser gives it a shared type. Every phrasing in the wild is
- * here: Chrome/Edge "Failed to fetch dynamically imported module", Firefox "error loading
- * dynamically imported module", Safari "Importing a module script failed", webpack's
- * ChunkLoadError and "Loading chunk N failed", and the SPA-fallback "MIME type" refusal —
- * which is the one that fires on a static host that has not fixed the cause above, because the
- * missing `.js` is answered with `index.html`.
+ * Matched by message because no browser gives it a shared type. Every phrasing in the wild is here:
+ * Chrome/Edge "Failed to fetch dynamically imported module", Firefox "error loading dynamically
+ * imported module", Safari "Importing a module script failed", webpack's ChunkLoadError and
+ * "Loading chunk N failed", and the SPA-fallback "MIME type" refusal. The last one that fires on a
+ * static host that has not fixed the cause above, because the missing `.js` is answered with
+ * `index.html`.
  *
  * A standalone predicate rather than a method on the boundary, so a global `unhandledrejection`
  * handler can classify the same failure without importing a component.
@@ -86,13 +86,13 @@ function runningEntry() {
 /**
  * Is the build this tab is running still the one being served?
  *
- * Asked of the server, so the answer is evidence rather than a guess. Everything ambiguous —
- * offline, a non-200, a captive portal, a probe that times out — resolves to `false`: dressing a
- * genuine bug up as an update hides it from the user and from us.
+ * Asked of the server, so the answer is evidence rather than a guess. An offline request, a non-200
+ * response, a captive portal or a timed-out probe resolves to `false`: dressing a genuine bug up as
+ * an update hides it from the user and from us.
  *
  * It asks for the PAGE, not for the asset, and that is not the obvious choice. A missing asset
  * looks like the direct question, but a CDN commonly serves assets with a long `s-maxage`, so a
- * bundle a deploy retired an hour ago still answers 200 from the edge — it would report "current"
+ * bundle a deploy retired an hour ago still answers 200 from the edge. It would report "current"
  * during exactly the window when skew is most likely. The page is the one URL that cannot lie: it
  * ships `max-age=0, must-revalidate` and never enters the edge cache.
  */
@@ -119,9 +119,9 @@ export async function isStaleBuild() {
  * rather than watching the same attempt loop.
  *
  * The guard is the part that matters. Reloading on a failure is obvious; reloading on a failure
- * that the reload does not fix is an infinite loop with the user inside it. At most one reload
- * per minute, so a genuinely broken deploy degrades to the error screen — which can at least say
- * something — instead of flickering forever.
+ * that the reload does not fix is an infinite loop with the user inside it. At most one reload per
+ * minute, so a genuinely broken deploy shows the error screen instead of flickering forever. That
+ * screen can at least say something.
  *
  * `sessionStorage` and not `localStorage`: the guard is about this tab's current predicament, and
  * a stale stamp in another tab must not suppress a reload this one needs. Wrapped because storage
@@ -145,11 +145,11 @@ export function reloadOnce() {
 /**
  * Vite's *hint* failure, which is not the same thing and must not be treated as one.
  *
- * Vite injects a speculative `<link rel="stylesheet">` for a chunk's CSS before importing it.
- * When that link fails, the import itself still runs right after and usually succeeds — so this
- * one is worth swallowing, where a failure of the import is the real thing
- * {@link isChunkLoadError} matches. Vite builds this message in exactly one place and only ever
- * for a stylesheet link; script hints never reject.
+ * Vite injects a speculative `<link rel="stylesheet">` for a chunk's CSS before importing it. When
+ * that link fails, the import itself still runs right after and usually succeeds, so this one is
+ * worth swallowing, where a failure of the import is the real thing {@link isChunkLoadError}
+ * matches. Vite builds this message in exactly one place and only ever for a stylesheet link;
+ * script hints never reject.
  */
 export function isPreloadHintFailure(error) {
     return error instanceof Error && error.message.startsWith("Unable to preload CSS for");
@@ -157,12 +157,12 @@ export function isPreloadHintFailure(error) {
 /**
  * Install the `vite:preloadError` listener. Call once, from the browser entry.
  *
- * Vite offers `preventDefault()` here so an app can own a failed asset itself — but taking that
- * deal unconditionally resolves the dynamic import with `undefined` (Vite's helper ends in
+ * Vite offers `preventDefault()` here so an app can own a failed asset itself, but taking that deal
+ * unconditionally resolves the dynamic import with `undefined` (Vite's helper ends in
  * `baseModule().catch(handlePreloadError)`), and `React.lazy` then reads `.default` off nothing.
- * The user gets the crash screen and the developer gets a TypeError with only React frames in
- * it, naming no chunk. So it is taken ONLY for a failed preload hint, where the import still
- * runs. A real module failure is left to throw, where the error boundary can recognise it.
+ * The user gets the crash screen and the developer gets a TypeError with only React frames in it,
+ * naming no chunk. So it is taken ONLY for a failed preload hint, where the import still runs. A
+ * real module failure is left to throw, where the error boundary can recognise it.
  */
 export function installPreloadErrorHandler() {
     window.addEventListener("vite:preloadError", (event) => {

package/dist/describe-error.d.ts

@@ -3,21 +3,21 @@ import { ApiError } from "./api-error.ts";
  * Turning anything thrown into copy a person can act on.
  *
  * The API already answers with a message written for a developer, a stable `messageKey` for the
- * domain refusals, and `details` carrying the parts that make a refusal actionable. This is the
- * one place that decides what the SCREEN says — which is not always the same sentence.
- * "Monthly quota spent, upgrade or buy a pack" is right in a JSON body and wrong under a button
- * that could just say what to do next.
+ * domain refusals, and `details` carrying the parts that make a refusal actionable. This is the one
+ * place that decides what the SCREEN says. It is not always the same sentence. "Monthly quota
+ * spent, upgrade or buy a pack" is right in a JSON body and wrong under a button that could just
+ * say what to do next.
  *
  * `cause` is what happened. `fix` is what to do about it. **A surface that shows only the first
- * half is the dead end this exists to prevent** — which is why the type has two fields and not
- * one, and why `fix` being absent should be a deliberate choice at each call site rather than
- * the default nobody noticed.
+ * half is the dead end this exists to prevent**. That is why the type has two fields and not one,
+ * and why `fix` being absent should be a deliberate choice at each call site rather than the
+ * default nobody noticed.
  *
- * `fix`, and not the `hint` this returned until 0.6.0. `ErrorStateProps` — the contract this same
- * package ships for the component that renders this — has always called it `fix`, so every
- * adopter wrote `fix={hint}` at every error surface: a rename adapter, which is the shape of an
- * API we got wrong. It also clears a collision, because in at least one adopter a form field's
- * `hint` is the requirement text under the input, which is a different thing entirely.
+ * `fix`, and not the `hint` this returned until 0.6.0. `ErrorStateProps`, the contract this same
+ * package ships for the component that renders this, has always called it `fix`, so every adopter
+ * wrote `fix={hint}` at every error surface: a rename adapter, which is the shape of an API we got
+ * wrong. It also clears a collision, because in at least one adopter a form field's `hint` is the
+ * requirement text under the input, which is a different thing entirely.
  *
  * The per-code switch stays in the product: two donors' switches shared their SHAPE and almost
  * no arms, because the arms are that API's vocabulary. What ships is the scaffolding around it,
@@ -26,11 +26,11 @@ import { ApiError } from "./api-error.ts";
 /**
  * Which control to offer beside the words.
  *
- * The fourth adopter had this and the package did not, which left every adopter re-deriving
- * "can a second attempt fix this" from its own switch — beside a `shouldRetry` already deciding
- * exactly that for react-query. Two answers to one question drift, and the drift is visible: a
- * screen offering "try again" for a refusal the query layer refuses to retry, so the button does
- * nothing and the reader presses it twice.
+ * The fourth adopter had this and the package did not, which left every adopter re-deriving "can a
+ * second attempt fix this" from its own switch, beside a `shouldRetry` already deciding exactly
+ * that for react-query. Two answers to one question drift, and the drift is visible: a screen
+ * offering "try again" for a refusal the query layer refuses to retry, so the button does nothing
+ * and the reader presses it twice.
  *
  * So this is DERIVED from `shouldRetry`, not switched on separately. One rule, two consumers.
  */
@@ -49,7 +49,7 @@ export interface ErrorCopy {
     cause: string;
     /** What to do about it. Its absence should be a decision, not an oversight. */
     fix?: string;
-    /** Override the derived kind — a 429 whose code means a spent quota is `"none"`, not `"wait"`. */
+    /** Override the derived kind. A 429 whose code means a spent quota is `"none"`, not `"wait"`. */
     recover?: RecoveryKind;
     /** Override the request id. Rarely wanted; the envelope's is used by default. */
     reference?: string;
@@ -59,14 +59,14 @@ export interface DescribedError extends ErrorCopy {
     recover: RecoveryKind;
 }
 /**
- * The subset of i18next's `t` this module needs — typed here so `i18next` stays optional.
+ * The subset of i18next's `t` this module needs, typed here so `i18next` stays optional.
  *
- * `Key` is a parameter and not plain `string` for a reason the first migration found. Every app
- * on this stack declares `CustomTypeOptions.resources`, which types `t` to accept ONLY the keys
- * its catalog has — so a `t` is not assignable to anything asking for `(key: string) => string`,
- * and the adopter is left with a cast. Naming the keys instead turns that around: each function
- * below asks for exactly the keys it looks up, a typed `t` accepts a superset of them and goes
- * in directly, and a catalog missing one is a compile error rather than a raw key on screen.
+ * `Key` is a parameter and not plain `string` for a reason the first migration found. Every app on
+ * this stack declares `CustomTypeOptions.resources`, which types `t` to accept ONLY the keys its
+ * catalog has, so a `t` is not assignable to anything asking for `(key: string) => string`, and the
+ * adopter is left with a cast. Naming the keys instead turns that around: each function below asks
+ * for exactly the keys it looks up, a typed `t` accepts a superset of them and goes in directly,
+ * and a catalog missing one is a compile error rather than a raw key on screen.
  */
 export type Translate<Key extends string = string> = (key: Key, params?: Record<string, unknown>) => string;
 /** The three names {@link humanizeWait} looks up, under whatever prefix you pass it. */
@@ -75,8 +75,8 @@ type WaitName = "waitSeconds" | "waitMinutes" | "waitHours";
  * Every name {@link createErrorDescriber} looks up itself. Your catalog carries all of them.
  *
  * The three wait names are deliberately NOT here, which is the other half of 0.6.0. This module
- * used to humanize a stated wait itself, so `waitSeconds`/`waitMinutes`/`waitHours` — each with
- * an ICU plural — landed in the key union of every adopter's `t` whether or not a wait was ever
+ * used to humanize a stated wait itself, so `waitSeconds`/`waitMinutes`/`waitHours`, each with an
+ * ICU plural, landed in the key union of every adopter's `t` whether or not a wait was ever
  * rendered. An app that formats waits with `Intl.RelativeTimeFormat` needs none of them and was
  * left adding six entries per language to satisfy a compiler. `formatWait` owns that now.
  */
@@ -86,26 +86,26 @@ type CopyName = "network" | "networkHint" | "unexpected" | "retrySoon";
  *
  * i18next keeps `seatLimitReached_one` and `seatLimitReached_other`; the server sends
  * `serverErrors.seatLimitReached`, because that is the key a person resolves with a `count`. So
- * `Object.keys` on a catalog does NOT contain the name the server actually sends, and a gate
- * built from it alone rejects a sentence the app is carrying — falling back to the server's
- * English for the one refusal that had a written answer. Measured in the seventh migration: two
- * of that API's 112 keys, both of them plan limits, both of them the exact screen where a
- * specific sentence earns its keep.
+ * `Object.keys` on a catalog does NOT contain the name the server actually sends, and a gate built
+ * from it alone rejects a sentence the app is carrying, falling back to the server's English for
+ * the one refusal that had a written answer. Measured in the seventh migration: two of that API's
+ * 112 keys, both of them plan limits, both of them the exact screen where a specific sentence earns
+ * its keep.
  */
 type PluralSuffix = "zero" | "one" | "two" | "few" | "many" | "other";
 type PluralBase<N extends string> = N extends `${infer Base}_${PluralSuffix}` ? Base : N;
 /**
- * "in 4 minutes" / "in 2 hours" — a wait nobody has to convert from seconds.
+ * Format a wait as "in 4 minutes" or "in 2 hours", without making the reader convert seconds.
  *
  * The thresholds are deliberately not round: 90 seconds rather than 60, so "in 75 seconds" does
  * not become the less precise "in 1 minute", and 90 minutes rather than 60 for the same reason
  * one rung up. Needs `waitSeconds` / `waitMinutes` / `waitHours` under `prefix`, each with a
  * `count` plural.
  *
- * This is what you pass as `formatWait` when your catalog carries those three:
- * `formatWait: (secs) => humanizeWait(t, secs, "errors.")`. An app that formats a wait with
- * `Intl.RelativeTimeFormat` passes its own one-liner instead and needs no wait keys at all —
- * which also gets it correct plurals in languages with more than two forms, for free.
+ * This is what you pass as `formatWait` when your catalog carries those three: `formatWait: (secs)
+ * => humanizeWait(t, secs, "errors.")`. An app that formats a wait with `Intl.RelativeTimeFormat`
+ * passes its own one-liner instead and needs no wait keys at all. It also gets correct plurals in
+ * languages with more than two forms, for free.
  */
 export declare function humanizeWait<Prefix extends string>(t: Translate<`${Prefix}${WaitName}`>, secs: number, prefix: Prefix): string;
 export interface ErrorContext {
@@ -129,17 +129,17 @@ interface DescriberRules {
      * How a stated wait becomes words, for the `wait` an arm reads off its context.
      *
      * Required rather than defaulted, because there is no answer that is right for everyone and a
-     * default hid the cost: {@link humanizeWait} reads three ICU plural keys out of your catalog,
-     * and an app that already formats relative time with `Intl` would have had to add them to
-     * compile. Say which you want — `(secs) => humanizeWait(t, secs, "errors.")`, or your own
-     * `(secs) => formatIn(secs, locale)` — and the catalog you need is the one you can see.
+     * default hid the cost: {@link humanizeWait} reads three ICU plural keys out of your catalog, and
+     * an app that already formats relative time with `Intl` would have had to add them to compile.
+     * Pass `(secs) => humanizeWait(t, secs, "errors.")` or your own `(secs) => formatIn(secs,
+     * locale)`. The choice makes the catalog you need visible.
      */
     formatWait: (secs: number) => string;
     /**
      * Per-code copy. Everything not listed falls through to the default arm.
      *
-     * The arms look up the app's own keys, so they close over the app's `t` rather than being
-     * handed one — this module has no names for that copy and no business typing it.
+     * The arms look up the app's own keys, so they close over the app's `t` rather than being handed
+     * one. This module has no names for that copy and no business typing it.
      *
      * Annotate your object `Partial<Record<YourErrorCode, ErrorArm>>` where you write it, and a
      * code that does not exist is a compile error at the arm rather than a branch that never runs.
@@ -149,21 +149,21 @@ interface DescriberRules {
      * What to say when nothing in `codes` matches: a code this build has no arm for, or an answer
      * with no envelope at all.
      *
-     * The built-in arm hands the reader the server's own `message`, and for one API in the fleet
-     * that is right — its message IS the sentence a person should read. For another it is exactly
+     * The built-in arm hands the reader the server's own `message`, and for one API in the fleet that
+     * is right, because its message IS the sentence a person should read. For another it is exactly
      * wrong: that repo's own i18n rules say `message` is "the English fallback for logs", and it
      * ships three languages, so the built-in would put developer English in front of a reader who
-     * does not speak it. One default cannot be right for both, and the one baked in here was
-     * simply the first adopter's convention, mistaken for a fact.
+     * does not speak it. One default cannot be right for both, and the one baked in here was simply
+     * the first adopter's convention, mistaken for a fact.
      *
      * An arm here is also handed the stated wait, which the built-in spends on nothing: a refusal
      * with no arm of its own could state its expiry and have that go unsaid.
      */
     fallback?: ErrorArm;
     /**
-     * The codes that mean "this limit does not clear by waiting" — **the same list you hand
-     * `queryDefaults`**, because it answers the same question and a second copy is a second
-     * chance to disagree with the retry rule. Declare it once in the app and pass it twice.
+     * The codes that mean "this limit does not clear by waiting". Pass **the same list to
+     * `queryDefaults`**, because it answers the same question and a second copy is a second chance to
+     * disagree with the retry rule. Declare it once in the app and pass it twice.
      */
     durableLimitCodes?: readonly string[];
     /** Longest stated wait still worth a retry rather than a countdown. Matches `queryDefaults`. */
@@ -173,23 +173,23 @@ export interface ErrorDescriberOptions<Prefix extends string, ServerPrefix exten
     /**
      * Checked against the keys, never used to find them: the three type parameters come from
      * `copyPrefix`, `messageKeyPrefix` and `knownMessageKeys`. With `t` as a source too, the call
-     * every adopter writes — an inline `(key, params) => i18n.t(key, params)` beside an inline arm —
+     * every adopter writes, an inline `(key, params) => i18n.t(key, params)` beside an inline arm,
      * failed overload resolution (TS2769, measured on TypeScript 5.9.3) once the one-language
-     * overload existed, although this signature alone accepted it. A typed `t` missing a key is
-     * still refused.
+     * overload existed, although this signature alone accepted it. A typed `t` missing a key is still
+     * refused.
      */
     t: Translate<NoInfer<`${Prefix}${CopyName}` | `${ServerPrefix}${ServerName | PluralBase<ServerName>}`>>;
     /** Catalog namespace for this module's own copy, e.g. `"errors."`. */
     copyPrefix: Prefix;
     /**
      * The server's own catalog namespace, e.g. `"serverErrors."`. A `messageKey` outside it is
-     * ignored — the server names a sentence, it does not get to name any key in the app.
+     * ignored. The server names a sentence, it does not get to name any key in the app.
      *
-     * The `code` is read under this prefix too, for an API that has no `messageKey` field and
-     * lets the code name the sentence — one repo in the fleet has 98 of those, `errors.NOT_FOUND`
-     * and its siblings, against another repo's `messageKey`. Both are the same claim ("the server
-     * named a sentence this app carries"), both pass the same gate below, and an app that uses
-     * neither is unaffected because nothing matches.
+     * The `code` is read under this prefix too, for an API that has no `messageKey` field and lets
+     * the code name the sentence. One repo in the fleet has 98 of those, `errors.NOT_FOUND` and its
+     * siblings, against another repo's `messageKey`. Both are the same claim ("the server named a
+     * sentence this app carries"), both pass the same gate below, and an app that uses neither is
+     * unaffected because nothing matches.
      */
     messageKeyPrefix: ServerPrefix;
     /**
@@ -197,13 +197,13 @@ export interface ErrorDescriberOptions<Prefix extends string, ServerPrefix exten
      * catalog. Passing the catalog itself is both the membership test and the proof the compiler
      * wants: a name that is in it IS a key, so the lookup below needs no cast.
      *
-     * It is required because leaving it out is not a smaller version of this — it is the bug the
-     * option exists to prevent. i18next answers a key it does not have with the key itself, so a
+     * It is required because leaving it out reintroduces the bug the option exists to prevent rather
+     * than making this smaller. i18next answers a key it does not have with the key itself, so a
      * deploy landing ahead of the bundle a tab is still running would render `serverErrors.foo` at
      * somebody. A name that is absent falls back to the server's English `message` instead.
      *
-     * Hand it over as it is. A plural sits in the catalog under suffixed names while the server
-     * names the base, so the base is admitted too — see {@link PluralBase}.
+     * Hand it over as it is. A plural sits in the catalog under suffixed names while the server names
+     * the base, so the base is admitted too. See {@link PluralBase}.
      */
     knownMessageKeys: Record<ServerName, unknown>;
     /**
@@ -211,13 +211,13 @@ export interface ErrorDescriberOptions<Prefix extends string, ServerPrefix exten
      *
      * The envelope carries what the SERVER knows, which is not always a word anyone should read: a
      * role id (`admin`), an action verb (`approve_content`). The sentence needs whatever the app's
-     * own screens call those things, and the substitution happens here — inside the one lookup that
-     * reads `params` — so there is nowhere else an adopter could intervene. Without this seam the
-     * choice is to ship the raw id into `{{role}}`, or to stop using the server's sentence at all
-     * and re-resolve every key by hand, which is how i18n ended up inside a transport once already.
+     * own screens call those things, and the substitution happens here, inside the one lookup that
+     * reads `params`. There is nowhere else an adopter could intervene. Without this seam the choice
+     * is to ship the raw id into `{{role}}`, or to stop using the server's sentence at all and
+     * re-resolve every key by hand, which is how i18n ended up inside a transport once already.
      *
      * Optional, and identity by default: an API whose params are already words passes nothing. It
-     * deliberately takes only the params — an arm that needs the error has `ctx` for that.
+     * deliberately takes only the params. An arm that needs the error has `ctx` for that.
      */
     localizeParams?: (params: Record<string, string | number> | undefined) => Record<string, unknown> | undefined;
 }

package/dist/describe-error.d.ts.map

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

package/dist/describe-error.js

@@ -3,17 +3,17 @@ import { ApiError } from "./api-error.js";
 import { shouldRetry } from "./query.js";
 const PLURAL_SUFFIX = /_(zero|one|two|few|many|other)$/;
 /**
- * "in 4 minutes" / "in 2 hours" — a wait nobody has to convert from seconds.
+ * Format a wait as "in 4 minutes" or "in 2 hours", without making the reader convert seconds.
  *
  * The thresholds are deliberately not round: 90 seconds rather than 60, so "in 75 seconds" does
  * not become the less precise "in 1 minute", and 90 minutes rather than 60 for the same reason
  * one rung up. Needs `waitSeconds` / `waitMinutes` / `waitHours` under `prefix`, each with a
  * `count` plural.
  *
- * This is what you pass as `formatWait` when your catalog carries those three:
- * `formatWait: (secs) => humanizeWait(t, secs, "errors.")`. An app that formats a wait with
- * `Intl.RelativeTimeFormat` passes its own one-liner instead and needs no wait keys at all —
- * which also gets it correct plurals in languages with more than two forms, for free.
+ * This is what you pass as `formatWait` when your catalog carries those three: `formatWait: (secs)
+ * => humanizeWait(t, secs, "errors.")`. An app that formats a wait with `Intl.RelativeTimeFormat`
+ * passes its own one-liner instead and needs no wait keys at all. It also gets correct plurals in
+ * languages with more than two forms, for free.
  */
 export function humanizeWait(t, secs, prefix) {
     // Up, never to the nearest: a wait is a floor, and "in 2 hours" for 2h24 sends the reader back