@gusnips/react 0.9.23 → 0.9.25

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

package/dist/error-boundary.d.ts

@@ -2,27 +2,27 @@ import { Component, type ErrorInfo, type ReactNode } from "react";
 /**
  * The last stop before a white screen.
  *
- * React unmounts the whole tree when a render throws, and an app with no boundary anywhere
- * answers that with a blank page: no words, no navigation, no reload — the most complete dead
- * end a product can produce, and the one the never-dead-end rule cannot reach, because by then
- * there is no component left to render a state from.
+ * React unmounts the whole tree when a render throws, and an app with no boundary anywhere answers
+ * that with a blank page: no words, no navigation, no reload. That is the most complete dead end a
+ * product can produce, and the one the never-dead-end rule cannot reach, because by then there is
+ * no component left to render a state from.
  *
  * It is deliberately dumb. No retry loop, no error reporting, no reset on a timer: it catches,
  * it hands the error to a `fallback` the app draws in its own words, and it offers `reset`.
  * Every donor that baked its own UI in here had to keep a second copy for its second surface;
  * a render prop has no such problem, and the brand stays in the product where it belongs.
  *
- * A class, because `getDerivedStateFromError` has no hook equivalent — this is the one thing in
- * the kit React still has no other way to express.
+ * A class, because `getDerivedStateFromError` has no hook equivalent. This is the one thing in the
+ * kit React still has no other way to express.
  */
 export interface ErrorBoundaryFallbackProps {
     error: Error;
     /** Put the children back. */
     reset: () => void;
     /**
-     * True when the throw was a failed lazy-chunk import — a deploy landed while this tab was
-     * open, so the fix is a reload and NOT a retry (a rejected dynamic import rethrows on
-     * re-render forever). Draw the "updating" screen, not the crash screen.
+     * True when the throw was a failed lazy-chunk import because a deploy landed while this tab was
+     * open, so the fix is a reload and NOT a retry (a rejected dynamic import rethrows on re-render
+     * forever). Draw the "updating" screen, not the crash screen.
      */
     isChunkError: boolean;
 }
@@ -30,9 +30,9 @@ export interface ErrorBoundaryProps {
     /** Drawn instead of the children once something has thrown. */
     fallback: (props: ErrorBoundaryFallbackProps) => ReactNode;
     /**
-     * Changing this value clears the error and remounts the children — pass the route, so
-     * navigating away from a screen that broke actually leaves it rather than carrying its
-     * wreckage to every page after it.
+     * Changing this value clears the error and remounts the children. Pass the route, so navigating
+     * away from a screen that broke actually leaves it rather than carrying its wreckage to every
+     * page after it.
      */
     resetKey?: string;
     /** Called once per catch. Report to whatever the app reports to. */

package/dist/guards.d.ts

@@ -2,9 +2,9 @@ import type { ReactNode } from "react";
 /**
  * Route guards.
  *
- * Two donors wrote these four, gave two of them the same names, and explained them in nearly
- * the same words. What differed was one line — and that line is invariant 4, so it is the
- * reason this file exists rather than being copied a ninth time.
+ * Two donors wrote these four, gave two of them the same names, and explained them in nearly the
+ * same words. What differed was one line. That line is invariant 4, so it is the reason this file
+ * exists rather than being copied a ninth time.
  *
  * These are factories because the destinations are the app's: `paths.signIn` is not something a
  * package can know, and one donor hardcoded `/login` in four places for exactly that reason.
@@ -21,18 +21,18 @@ export interface SessionState {
 /**
  * The answer to a "who is this?" query, in the three states it actually has.
  *
- * This shape is invariant 4. A guard reading `!me?.isStaff` collapses "pending", "failed" and
- * "no" into one branch — so an operator arriving while `/auth/me` is 500ing is told the page
- * does not exist. Wrong cause, no retry, and no request id to quote to support. One donor hit
- * that and fixed it; the other still has the collapsed version.
+ * This shape is invariant 4. A guard reading `!me?.isStaff` collapses "pending", "failed" and "no"
+ * into one branch, so an operator arriving while `/auth/me` is 500ing is told the page does not
+ * exist. Wrong cause, no retry, and no request id to quote to support. One donor hit that and fixed
+ * it; the other still has the collapsed version.
  *
  * `"pending"` and not `"loading"` for one measured reason: it is react-query's own word for this
  * state since v5, and with the words matching a `UseQueryResult<TMe>` satisfies this type
- * STRUCTURALLY — `createRequireProfile(useMe, …)` takes the hook directly, no adapter. With
- * `"loading"` it does not typecheck and every adopter hand-writes the same six-line mapping;
- * eight of the twelve repos this serves are on react-query, and the first migration wrote that
- * mapping before anyone noticed. Nothing here imports react-query at runtime — the type stays
- * structural, so an app on SWR or a plain `useState` still answers it in three lines.
+ * STRUCTURALLY: `createRequireProfile(useMe, …)` takes the hook directly, no adapter. With
+ * `"loading"` it does not typecheck and every adopter hand-writes the same six-line mapping; eight
+ * of the twelve repos this serves are on react-query, and the first migration wrote that mapping
+ * before anyone noticed. Nothing here imports react-query at runtime. The type stays structural, so
+ * an app on SWR or a plain `useState` still answers it in three lines.
  */
 export type MeQuery<TMe> = {
     status: "pending";
@@ -50,8 +50,8 @@ export interface GuardOptions {
 /** Query parameter carrying the route a sign-in interrupted. */
 export declare const AUTH_RETURN_PARAM = "next";
 /**
- * Signed in, or off to sign in — remembering where they were headed, so the redirect afterwards
- * lands on the page they actually wanted rather than the home screen.
+ * Require sign-in and remember where they were headed, so the redirect afterwards lands on the page
+ * they actually wanted rather than the home screen.
  */
 export declare function createRequireAuth(useSession: () => SessionState, signInPath: string, { loading }: GuardOptions): ({ children }: {
     children: ReactNode;
@@ -61,7 +61,7 @@ export declare function createRequireAnonymous(useSession: () => SessionState, h
     children: ReactNode;
 }) => import("react").JSX.Element;
 /**
- * A gate on something the profile says — suspended, staff, on a given plan.
+ * A gate on a profile field, such as whether the person is suspended, staff or on a given plan.
  *
  * `allow` gets the profile and answers yes or no. `onDenied` draws the refusal; `onError` draws
  * the failure, and they are SEPARATE arguments on purpose. That separation is the whole point

package/dist/guards.js

@@ -8,8 +8,8 @@ function signInUrl(signInPath, returnTo) {
     return `${signInPath}${separator}${AUTH_RETURN_PARAM}=${encodeURIComponent(returnTo)}`;
 }
 /**
- * Signed in, or off to sign in — remembering where they were headed, so the redirect afterwards
- * lands on the page they actually wanted rather than the home screen.
+ * Require sign-in and remember where they were headed, so the redirect afterwards lands on the page
+ * they actually wanted rather than the home screen.
  */
 export function createRequireAuth(useSession, signInPath, { loading }) {
     return function RequireAuth({ children }) {
@@ -46,7 +46,7 @@ export function createRequireAnonymous(useSession, homePath, { loading }) {
     };
 }
 /**
- * A gate on something the profile says — suspended, staff, on a given plan.
+ * A gate on a profile field, such as whether the person is suspended, staff or on a given plan.
  *
  * `allow` gets the profile and answers yes or no. `onDenied` draws the refusal; `onError` draws
  * the failure, and they are SEPARATE arguments on purpose. That separation is the whole point

package/dist/hydrate.d.ts

@@ -1,18 +1,17 @@
 /**
  * The browser half of prerendering: deciding whether to hydrate or to mount fresh.
  *
- * Three separate repos invented all of this independently — same constant name, same string
- * value, same decision, and near-identical explaining comments. That is not a coincidence worth
- * deduping; it is one lesson learned three times, and it belongs somewhere it can be learned
- * once.
+ * Three separate repos invented all of this independently, with the same constant name, string
+ * value and decision, and near-identical explaining comments. That is not a coincidence worth
+ * deduping; it is one lesson learned three times, and it belongs somewhere it can be learned once.
  *
  * The constants themselves live in `prerender-contract.ts`, which imports nothing, because the
  * BUILD needs them too and must not pull `react-dom/client` into a Node process to get a string.
  *
  * This module sits behind `@gusnips/react/hydrate` rather than in the barrel for the same reason
- * one rung further out: it is the package's ONLY `react-dom` import, and a React Native app has
- * no react-dom to give. Leaving it in the barrel made `react-dom` a required peer and shut the
- * whole package out of every phone — for one function a phone would never call.
+ * one rung further out: it is the package's ONLY `react-dom` import, and a React Native app has no
+ * react-dom to give. Leaving it in the barrel made `react-dom` a required peer and shut the whole
+ * package out of every phone for one function a phone would never call.
  */
 import type { ReactNode } from "react";
 export { PRERENDERED_ROUTE_ATTR, SHELL_ROUTE } from "./prerender-contract.ts";
@@ -20,16 +19,16 @@ export { PRERENDERED_ROUTE_ATTR, SHELL_ROUTE } from "./prerender-contract.ts";
  * Hydrate the render this file IS, and mount fresh over anything else.
  *
  * "Does the root have children" is the wrong question, and getting it wrong is silent. A static
- * host answers every address it does not publish with the nearest `404.html` — and that file has
- * the not-found page rendered INTO it — so an address served from a shell arrives at a full root
- * holding somebody else's markup. Hydrating that is React reconciling two different pages: it
- * recovers by throwing the whole tree away and says so in the console, which is a page that
- * works and a bug nobody sees. The file names the route it is a render of, so we can simply ask.
+ * host answers every address it does not publish with the nearest `404.html`, which has the
+ * not-found page rendered INTO it. An address served from a shell arrives at a full root holding
+ * somebody else's markup. Hydrating that is React reconciling two different pages: it recovers by
+ * throwing the whole tree away and says so in the console, which is a page that works and a bug
+ * nobody sees. The file names the route it is a render of, so we can simply ask.
  *
- * `route` is passed in rather than read from `window.location` on purpose. A localized app
- * serves `/pt/pricing` from a file rendered for `/pricing`, with the locale carried in the
- * router's `basename` — so the address and the route are different strings, and only the caller
- * knows which one the build wrote.
+ * `route` is passed in rather than read from `window.location` on purpose. A localized app serves
+ * `/pt/pricing` from a file rendered for `/pricing`, with the locale carried in the router's
+ * `basename`, so the address and the route are different strings, and only the caller knows which
+ * one the build wrote.
  *
  * **A trailing slash is not a different page.** The router renders `/precos/` and `/precos` alike,
  * and which one is in the address bar is the host's call: a host serving `precos/index.html`

package/dist/hydrate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hydrate.d.ts","sourceRoot":"","sources":["../src/hydrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAI3F"}
+{"version":3,"file":"hydrate.d.ts","sourceRoot":"","sources":["../src/hydrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAI3F"}

package/dist/hydrate.js

@@ -5,16 +5,16 @@ export { PRERENDERED_ROUTE_ATTR, SHELL_ROUTE } from "./prerender-contract.js";
  * Hydrate the render this file IS, and mount fresh over anything else.
  *
  * "Does the root have children" is the wrong question, and getting it wrong is silent. A static
- * host answers every address it does not publish with the nearest `404.html` — and that file has
- * the not-found page rendered INTO it — so an address served from a shell arrives at a full root
- * holding somebody else's markup. Hydrating that is React reconciling two different pages: it
- * recovers by throwing the whole tree away and says so in the console, which is a page that
- * works and a bug nobody sees. The file names the route it is a render of, so we can simply ask.
+ * host answers every address it does not publish with the nearest `404.html`, which has the
+ * not-found page rendered INTO it. An address served from a shell arrives at a full root holding
+ * somebody else's markup. Hydrating that is React reconciling two different pages: it recovers by
+ * throwing the whole tree away and says so in the console, which is a page that works and a bug
+ * nobody sees. The file names the route it is a render of, so we can simply ask.
  *
- * `route` is passed in rather than read from `window.location` on purpose. A localized app
- * serves `/pt/pricing` from a file rendered for `/pricing`, with the locale carried in the
- * router's `basename` — so the address and the route are different strings, and only the caller
- * knows which one the build wrote.
+ * `route` is passed in rather than read from `window.location` on purpose. A localized app serves
+ * `/pt/pricing` from a file rendered for `/pricing`, with the locale carried in the router's
+ * `basename`, so the address and the route are different strings, and only the caller knows which
+ * one the build wrote.
  *
  * **A trailing slash is not a different page.** The router renders `/precos/` and `/precos` alike,
  * and which one is in the address bar is the host's call: a host serving `precos/index.html`

package/dist/hydrate.js.map

@@ -1 +1 @@
-{"version":3,"file":"hydrate.js","sourceRoot":"","sources":["../src/hydrate.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,cAAc,CAAC,MAAe,EAAE,IAAe,EAAE,KAAoB;IACnF,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,sBAAsB,CAAC,CAAC;IAC7D,IAAI,KAAK,KAAK,IAAI,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;QAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;;QAC3F,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,4DAA4D;AAC5D,SAAS,QAAQ,CAAC,CAAS,EAAE,CAAS;IACpC,MAAM,IAAI,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACrE,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"hydrate.js","sourceRoot":"","sources":["../src/hydrate.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,cAAc,CAAC,MAAe,EAAE,IAAe,EAAE,KAAoB;IACnF,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,sBAAsB,CAAC,CAAC;IAC7D,IAAI,KAAK,KAAK,IAAI,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;QAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;;QAC3F,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,4DAA4D;AAC5D,SAAS,QAAQ,CAAC,CAAS,EAAE,CAAS;IACpC,MAAM,IAAI,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACrE,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC;AAC7B,CAAC"}

package/dist/i18n.d.ts

@@ -8,8 +8,7 @@
  * ```
  *
  * Keeping the options here is what stops a console, a storefront and a docs site in the same
- * product from drifting apart on the details below — each of which is a bug somebody already
- * shipped.
+ * product from drifting apart on the details below. Each is a bug somebody already shipped.
  */
 export interface I18nInitOptions {
     /** The language everything falls back to. */
@@ -27,10 +26,10 @@ export interface I18nInitOptions {
     /**
      * The query parameter that hands a language ACROSS an origin, e.g. `"lang"`.
      *
-     * When set it is detected FIRST, ahead of storage and the browser — it is the only one of the
+     * When set it is detected FIRST, ahead of storage and the browser. It is the only one of the
      * three that somebody chose on purpose and just now. A reader who picked Português on the
-     * storefront and followed a link into the app means it more than their laptop's locale does.
-     * It is cached on arrival, so it decides once and no URL inside the app has to carry it.
+     * storefront and followed a link into the app means it more than their laptop's locale does. It
+     * is cached on arrival, so it decides once and no URL inside the app has to carry it.
      *
      * Only one donor had this. The other has the same split-origin layout and the same problem.
      */
@@ -38,15 +37,15 @@ export interface I18nInitOptions {
     /**
      * Who WRITES {@link storageKey}. The detector, by default.
      *
-     * Pass `"app"` when your own language control writes it. That is not a preference — it is what
-     * a "follow the browser" option costs. Going back to following the browser means clearing the
-     * key and calling `changeLanguage(undefined)`, which re-runs detection; a detector that caches
-     * then writes the language it just detected straight back into the key it was told to clear.
-     * The choice re-pins itself and nothing can reach that state again.
+     * Pass `"app"` when your own language control writes it. A "follow the browser" option needs
+     * this. Going back to following the browser means clearing the key and calling
+     * `changeLanguage(undefined)`, which re-runs detection; a detector that caches then writes the
+     * language it just detected straight back into the key it was told to clear. The choice re-pins
+     * itself and nothing can reach that state again.
      *
      * Three repos on this stack, three answers: one lets the detector write, one writes it from its
-     * own control, and one does both — harmless there only because it offers no "follow the
-     * browser" state. So the rule, rather than the default: one writer per key.
+     * own control, and one does both. Doing both is harmless there only because it offers no "follow
+     * the browser" state. So the rule, rather than the default: one writer per key.
      */
     storageWriter?: "detector" | "app";
 }
@@ -73,13 +72,13 @@ export declare function i18nInitOptions({ fallbackLng, supportedLngs, storageKey
  * i18next ever sees it.
  *
  * Done here rather than through interpolation because i18next v26 has no global interpolation
- * defaults, and these strings are often resolved by dynamic key — so a wrapping `t()` would not
+ * defaults, and these strings are often resolved by dynamic key, so a wrapping `t()` would not
  * reach them. The point is that a rename or a domain move is ONE edit in the brand constants
  * instead of a sweep across every locale file.
  *
- * Returns a fresh tree; the input is untouched. The placeholder names come from `vars`, so
- * adding one needs no change here — two donors hardcoded their own list in the regex and both
- * had to remember to update it.
+ * Returns a fresh tree; the input is untouched. The placeholder names come from `vars`, so adding
+ * one needs no change here. Two donors hardcoded their own list in the regex and both had to
+ * remember to update it.
  */
 export declare function applyBrandVars<T>(resources: T, vars: Record<string, string>): T;
 //# sourceMappingURL=i18n.d.ts.map

package/dist/i18n.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC;;;;;;OAMG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;CACpC;AAED,wBAAgB,eAAe,CAAC,EAC9B,WAAW,EACX,aAAa,EACb,UAAU,EACV,QAAQ,EACR,aAA0B,GAC3B,EAAE,eAAe;;;;;;;;;uCAOK,MAAM,KAAG,MAAM;;;;;;;;EAkCrC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAmB/E"}
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC;;;;;;OAMG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;CACpC;AAED,wBAAgB,eAAe,CAAC,EAC9B,WAAW,EACX,aAAa,EACb,UAAU,EACV,QAAQ,EACR,aAA0B,GAC3B,EAAE,eAAe;;;;;;;;;uCAOK,MAAM,KAAG,MAAM;;;;;;;;EAkCrC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAmB/E"}