@eifi1/ui-kit 0.28.1 → 0.30.0

package/dist/auth/sign-in-form.js

@@ -0,0 +1,426 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useEffect, useEffectEvent, useId, useRef, useState } from "react";
+import { KeyRound } from "lucide-react";
+import { useKitLabels } from "../i18n/kit-labels.js";
+import { cn } from "../lib/cn.js";
+import { AlertBanner } from "../components/alert-banner.js";
+import { hasMessage } from "../components/choice-parts.js";
+import { CurrentPasswordInput } from "../components/danger-confirm.js";
+import { OneTimeCodeInput } from "../components/one-time-code-input.js";
+import { TextLink } from "../components/text-link.js";
+import { Button, Input } from "../components/ui.js";
+import { authErrorCode, englishRateLimited, isRateLimited, retryAfterSeconds } from "./auth-errors.js";
+import { taggedEmail } from "./email-tag.js";
+import { newPasswordProblem } from "./form-rules.js";
+import { NewPasswordFields } from "./new-password-fields.js";
+const DEFAULT_SIGN_IN_LABELS = {
+  email: "Email",
+  password: "Password",
+  submit: "Sign in",
+  passkey: "Sign in with a passkey",
+  forgotPassword: "Forgot your password?",
+  noAccount: "No account yet?",
+  register: "Create account",
+  invalidCredentials: "The email or password is incorrect.",
+  failed: "Sign-in failed. Please try again.",
+  passkeyFailed: "Passkey sign-in failed.",
+  deactivatedHint: "Account deactivated? Write to {contact}.",
+  tagHint: (taggedAddress) => `Signed up with ${taggedAddress}? Use that address.`,
+  twoFactorTitle: "Two-factor authentication",
+  twoFactorIntro: "Enter the code your authenticator app shows.",
+  code: "2FA code",
+  verify: "Verify",
+  codeInvalid: "Invalid 2FA code.",
+  setPasswordTitle: "Choose a new password",
+  setPasswordIntro: "A new password was requested for this account. Choose one and you are straight back in.",
+  newPassword: "New password",
+  confirmPassword: "Repeat new password",
+  passwordMismatch: "The passwords don't match.",
+  setPasswordSubmit: "Set password and sign in",
+  setPasswordFailed: "The password could not be set.",
+  expired: "This sign-in has expired. Please sign in again.",
+  backToSignIn: "Back to sign in",
+  useRecoveryCode: "Use a backup code",
+  useAuthenticatorCode: "Use your authenticator app",
+  recoveryCode: "Backup code",
+  recoveryIntro: "Enter one of the backup codes you saved when you turned on two-factor authentication.",
+  recoveryCodeHint: (length) => `${length} letters and digits. Dashes and spaces don\u2019t matter.`,
+  recoveryCodeInvalid: "This backup code is not valid, or it has been used already.",
+  rateLimited: englishRateLimited
+};
+function withContact(template, contact) {
+  const node = typeof contact === "string" && contact.includes("@") ? /* @__PURE__ */ jsx(TextLink, { href: `mailto:${contact}`, tone: "secondary", children: contact }, "contact") : /* @__PURE__ */ jsx("span", { children: contact }, "contact");
+  if (!template.includes("{contact}")) return [template, " ", node];
+  return template.split(/(\{contact\})/).filter((part) => part !== "").map((part) => part === "{contact}" ? node : part);
+}
+const HINT_CLASS = "text-xs text-[var(--text-secondary)]";
+const RECOVERY_CODE_LENGTH = 16;
+function recoveryCharacters(value) {
+  return value.replace(/[^\p{L}\p{N}]/gu, "").length;
+}
+const INTRO_CLASS = "text-sm text-[var(--text-secondary)]";
+function SignInForm({
+  onSubmit,
+  onCode,
+  onSetPassword,
+  onPasskey,
+  passkeyAutofill,
+  forgotHref,
+  registerHref,
+  defaultEmail = "",
+  emailTag,
+  deactivatedContact,
+  codeLength = 6,
+  recoveryCode,
+  credentialsContent,
+  twoFactorContent,
+  passwordChangeContent,
+  describeError,
+  onStepChange,
+  headingAs: Heading = "h2",
+  labels: labelsProp,
+  className,
+  ...rest
+}) {
+  const labels = useKitLabels("signIn", DEFAULT_SIGN_IN_LABELS, labelsProp);
+  const [step, setStep] = useState("credentials");
+  const [email, setEmail] = useState(defaultEmail);
+  const [password, setPassword] = useState("");
+  const [code, setCode] = useState("");
+  const [useRecovery, setUseRecovery] = useState(false);
+  const [recovery, setRecovery] = useState("");
+  const [newPassword, setNewPassword] = useState("");
+  const [confirm, setConfirm] = useState("");
+  const [challenge, setChallenge] = useState(
+    null
+  );
+  const [busy, setBusy] = useState(null);
+  const [failure, setFailure] = useState(null);
+  const headingId = useId();
+  const emailRef = useRef(null);
+  const passwordRef = useRef(null);
+  const codeRef = useRef(null);
+  const recoveryRef = useRef(null);
+  const newPasswordRef = useRef(null);
+  const mounted = useRef(true);
+  useEffect(() => {
+    mounted.current = true;
+    return () => {
+      mounted.current = false;
+    };
+  }, []);
+  const goTo = (next) => {
+    setStep(next);
+    onStepChange?.(next);
+  };
+  const present = (answer) => {
+    setFailure(null);
+    if (answer.kind === "signed-in") {
+      setBusy("done");
+      return;
+    }
+    setBusy(null);
+    setPassword("");
+    setCode("");
+    setRecovery("");
+    setUseRecovery(false);
+    setNewPassword("");
+    setConfirm("");
+    if (answer.kind === "2fa") {
+      setChallenge({ token: answer.challengeToken });
+      goTo("2fa");
+    } else if (answer.kind === "password-change") {
+      setChallenge({ token: answer.challengeToken, extra: answer.extra });
+      goTo("password-change");
+    }
+  };
+  const messageFor = (error, action, code2, recoveryUsed) => {
+    const own = describeError?.(error, action);
+    if (hasMessage(own)) return own;
+    if (isRateLimited(error)) return (labels.rateLimited ?? DEFAULT_SIGN_IN_LABELS.rateLimited)(retryAfterSeconds(error));
+    if (action === "password") return code2 === "invalid_credentials" ? labels.invalidCredentials : labels.failed;
+    if (action === "passkey") return labels.passkeyFailed;
+    if (action === "code") {
+      if (code2 === "token_invalid") return labels.expired;
+      return recoveryUsed ? labels.recoveryCodeInvalid ?? DEFAULT_SIGN_IN_LABELS.recoveryCodeInvalid : labels.codeInvalid;
+    }
+    return code2 === "token_invalid" ? labels.expired : labels.setPasswordFailed;
+  };
+  const fail = (error, action, sentEmail, recoveryUsed = false) => {
+    setBusy(null);
+    if (error?.name === "AbortError") return;
+    const code2 = authErrorCode(error);
+    const message = messageFor(error, action, code2, recoveryUsed);
+    if ((action === "code" || action === "set-password") && code2 === "token_invalid") {
+      setChallenge(null);
+      setCode("");
+      setRecovery("");
+      setUseRecovery(false);
+      setNewPassword("");
+      setConfirm("");
+      goTo("credentials");
+    }
+    setFailure({ action, code: code2, message, email: sentEmail });
+  };
+  const attempt = (action, call, sentEmail, recoveryUsed = false) => {
+    if (busy) return;
+    setBusy(action);
+    setFailure(null);
+    let result;
+    try {
+      result = Promise.resolve(call());
+    } catch (error) {
+      result = Promise.reject(error);
+    }
+    result.then(
+      (answer) => {
+        if (mounted.current) present(answer);
+      },
+      (error) => {
+        if (mounted.current) fail(error, action, sentEmail, recoveryUsed);
+      }
+    );
+  };
+  const armAutofill = useEffectEvent((signal) => passkeyAutofill?.(signal));
+  const autofillAnswered = useEffectEvent((answer) => {
+    if (busy === null) present(answer);
+  });
+  useEffect(() => {
+    const controller = new AbortController();
+    let pending;
+    try {
+      pending = Promise.resolve(armAutofill(controller.signal));
+    } catch (error) {
+      pending = Promise.reject(error);
+    }
+    pending.then(
+      (answer) => {
+        if (answer && !controller.signal.aborted && mounted.current) autofillAnswered(answer);
+      },
+      () => {
+      }
+    );
+    return () => controller.abort();
+  }, []);
+  const shownStep = useRef(step);
+  useEffect(() => {
+    if (shownStep.current === step) return;
+    shownStep.current = step;
+    if (step === "2fa") codeRef.current?.focus();
+    else if (step === "password-change") newPasswordRef.current?.focus();
+    else if (emailRef.current?.value) passwordRef.current?.focus();
+    else emailRef.current?.focus();
+  }, [step]);
+  const shownRecovery = useRef(useRecovery);
+  useEffect(() => {
+    if (shownRecovery.current === useRecovery) return;
+    shownRecovery.current = useRecovery;
+    if (step !== "2fa") return;
+    (useRecovery ? recoveryRef : codeRef).current?.focus();
+  }, [useRecovery, step]);
+  const backToCredentials = () => {
+    if (busy) return;
+    setChallenge(null);
+    setFailure(null);
+    setCode("");
+    setRecovery("");
+    setUseRecovery(false);
+    setNewPassword("");
+    setConfirm("");
+    goTo("credentials");
+  };
+  const working = busy !== null;
+  const rootClass = cn("space-y-3", className);
+  if (step === "2fa" && challenge) {
+    const recoveryOn = recoveryCode !== void 0 && recoveryCode !== false;
+    const recoveryLength = (typeof recoveryCode === "object" ? recoveryCode.length : void 0) ?? RECOVERY_CODE_LENGTH;
+    const asRecovery = recoveryOn && useRecovery;
+    const recoveryReady = recoveryCharacters(recovery) === recoveryLength;
+    const ready = asRecovery ? recoveryReady : code.length === codeLength;
+    const submitCode = (e) => {
+      e.preventDefault();
+      if (!ready) return;
+      if (asRecovery) {
+        attempt(
+          "code",
+          () => onCode({ challengeToken: challenge.token, code: recovery.trim(), kind: "recovery" }),
+          void 0,
+          true
+        );
+        return;
+      }
+      attempt("code", () => onCode({ challengeToken: challenge.token, code }));
+    };
+    const switchCode = () => {
+      if (working) return;
+      setFailure(null);
+      setCode("");
+      setRecovery("");
+      setUseRecovery((on) => !on);
+    };
+    const codeError = failure?.action === "code" ? failure.message : void 0;
+    const content = typeof twoFactorContent === "function" ? twoFactorContent(challenge.token) : twoFactorContent;
+    return /* @__PURE__ */ jsxs("div", { ...rest, "data-step": "2fa", className: rootClass, children: [
+      /* @__PURE__ */ jsxs("form", { className: "space-y-3", "aria-labelledby": headingId, onSubmit: submitCode, children: [
+        /* @__PURE__ */ jsx(Heading, { id: headingId, className: "text-base font-semibold text-[var(--text-primary)]", children: labels.twoFactorTitle }),
+        /* @__PURE__ */ jsx("p", { className: INTRO_CLASS, children: asRecovery ? labels.recoveryIntro ?? DEFAULT_SIGN_IN_LABELS.recoveryIntro : labels.twoFactorIntro }),
+        content,
+        asRecovery ? (
+          // A plain text field, not the digits-only one: a backup code is letters and
+          // digits in printed groups. Nothing a phone keyboard would "correct", and no
+          // autofill — the browser's suggestion for an unknown field is the username.
+          /* @__PURE__ */ jsx(
+            Input,
+            {
+              ref: recoveryRef,
+              label: labels.recoveryCode ?? DEFAULT_SIGN_IN_LABELS.recoveryCode,
+              name: "recovery-code",
+              value: recovery,
+              onChange: (e) => {
+                setRecovery(e.target.value);
+                if (failure) setFailure(null);
+              },
+              autoComplete: "off",
+              autoCapitalize: "characters",
+              autoCorrect: "off",
+              spellCheck: false,
+              inputClassName: "font-mono",
+              hint: (labels.recoveryCodeHint ?? DEFAULT_SIGN_IN_LABELS.recoveryCodeHint)(recoveryLength),
+              readOnly: working,
+              error: codeError,
+              required: true
+            }
+          )
+        ) : /* @__PURE__ */ jsx(
+          OneTimeCodeInput,
+          {
+            ref: codeRef,
+            label: labels.code,
+            name: "code",
+            value: code,
+            length: codeLength,
+            onChange: (next) => {
+              setCode(next);
+              if (failure) setFailure(null);
+            },
+            readOnly: working,
+            error: codeError,
+            required: true
+          }
+        ),
+        recoveryOn && /* @__PURE__ */ jsx("p", { className: "text-sm", children: /* @__PURE__ */ jsx(Button, { type: "button", variant: "link", size: "sm", disabled: working, onClick: switchCode, children: asRecovery ? labels.useAuthenticatorCode ?? DEFAULT_SIGN_IN_LABELS.useAuthenticatorCode : labels.useRecoveryCode ?? DEFAULT_SIGN_IN_LABELS.useRecoveryCode }) }),
+        /* @__PURE__ */ jsx(Button, { type: "submit", className: "w-full", disabled: !working && !ready, pending: working, children: labels.verify })
+      ] }),
+      /* @__PURE__ */ jsx(BackLink, { label: labels.backToSignIn, onClick: backToCredentials, disabled: working })
+    ] });
+  }
+  if (step === "password-change" && challenge) {
+    const problem = newPasswordProblem(newPassword, confirm);
+    const submitPassword = (e) => {
+      e.preventDefault();
+      if (problem) return;
+      attempt("set-password", () => onSetPassword({ challengeToken: challenge.token, password: newPassword }));
+    };
+    const content = typeof passwordChangeContent === "function" ? passwordChangeContent(challenge.extra) : passwordChangeContent;
+    return /* @__PURE__ */ jsxs("div", { ...rest, "data-step": "password-change", className: rootClass, children: [
+      /* @__PURE__ */ jsxs("form", { className: "space-y-3", "aria-labelledby": headingId, onSubmit: submitPassword, children: [
+        /* @__PURE__ */ jsx(Heading, { id: headingId, className: "text-base font-semibold text-[var(--text-primary)]", children: labels.setPasswordTitle }),
+        /* @__PURE__ */ jsx("p", { className: INTRO_CLASS, children: labels.setPasswordIntro }),
+        content,
+        email !== "" && /* @__PURE__ */ jsx("input", { type: "email", name: "username", autoComplete: "username", value: email, readOnly: true, hidden: true }),
+        /* @__PURE__ */ jsx(
+          NewPasswordFields,
+          {
+            password: newPassword,
+            confirm,
+            onPasswordChange: setNewPassword,
+            onConfirmChange: setConfirm,
+            busy: working,
+            passwordRef: newPasswordRef,
+            text: { password: labels.newPassword, confirm: labels.confirmPassword, mismatch: labels.passwordMismatch }
+          }
+        ),
+        failure?.action === "set-password" && /* @__PURE__ */ jsx(AlertBanner, { tone: "danger", size: "sm", role: "alert", children: failure.message }),
+        /* @__PURE__ */ jsx(Button, { type: "submit", className: "w-full", disabled: !working && problem !== null, pending: working, children: labels.setPasswordSubmit })
+      ] }),
+      /* @__PURE__ */ jsx(BackLink, { label: labels.backToSignIn, onClick: backToCredentials, disabled: working })
+    ] });
+  }
+  const submitCredentials = (e) => {
+    e.preventDefault();
+    const sent = email.trim();
+    if (sent === "" || password === "") return;
+    attempt("password", () => onSubmit({ email: sent, password }), sent);
+  };
+  const refused = failure?.code === "invalid_credentials";
+  const tagged = refused && failure?.action === "password" && emailTag && failure.email ? taggedEmail(failure.email, emailTag) : null;
+  const showDeactivated = refused && hasMessage(deactivatedContact);
+  return /* @__PURE__ */ jsxs("div", { ...rest, "data-step": "credentials", className: rootClass, children: [
+    /* @__PURE__ */ jsxs("form", { className: "space-y-3", onSubmit: submitCredentials, children: [
+      credentialsContent,
+      /* @__PURE__ */ jsx(
+        Input,
+        {
+          ref: emailRef,
+          type: "email",
+          name: "email",
+          autoComplete: "username webauthn",
+          label: labels.email,
+          value: email,
+          onChange: (e) => setEmail(e.target.value),
+          readOnly: working,
+          required: true
+        }
+      ),
+      /* @__PURE__ */ jsx(
+        CurrentPasswordInput,
+        {
+          ref: passwordRef,
+          name: "password",
+          label: labels.password,
+          value: password,
+          onValueChange: setPassword,
+          busy: working,
+          required: true
+        }
+      ),
+      failure && // One live region for the sentence and its hints: they are one answer.
+      /* @__PURE__ */ jsxs("div", { role: "alert", className: "space-y-1.5", children: [
+        /* @__PURE__ */ jsx(AlertBanner, { tone: "danger", size: "sm", children: failure.message }),
+        showDeactivated && /* @__PURE__ */ jsx("p", { className: HINT_CLASS, children: withContact(labels.deactivatedHint, deactivatedContact) }),
+        tagged && /* @__PURE__ */ jsx("p", { className: HINT_CLASS, children: labels.tagHint(tagged) })
+      ] }),
+      /* @__PURE__ */ jsx(Button, { type: "submit", className: "w-full", pending: busy === "password" || busy === "done", disabled: busy === "passkey", children: labels.submit }),
+      onPasskey && /* @__PURE__ */ jsxs(
+        Button,
+        {
+          type: "button",
+          variant: "secondary",
+          className: "w-full",
+          pending: busy === "passkey",
+          disabled: busy === "password" || busy === "done",
+          onClick: () => attempt("passkey", onPasskey),
+          children: [
+            /* @__PURE__ */ jsx(KeyRound, { "aria-hidden": true, className: "size-4" }),
+            labels.passkey
+          ]
+        }
+      )
+    ] }),
+    forgotHref !== void 0 && /* @__PURE__ */ jsx("p", { className: "text-center text-sm", children: /* @__PURE__ */ jsx(TextLink, { href: forgotHref, tone: "secondary", children: labels.forgotPassword }) }),
+    registerHref !== void 0 && /* @__PURE__ */ jsxs("p", { className: "text-center text-sm text-[var(--text-secondary)]", children: [
+      labels.noAccount,
+      " ",
+      /* @__PURE__ */ jsx(TextLink, { href: registerHref, tone: "primary", children: labels.register })
+    ] })
+  ] });
+}
+function BackLink({ label, onClick, disabled }) {
+  return /* @__PURE__ */ jsx("p", { className: "text-center text-sm", children: /* @__PURE__ */ jsx(Button, { type: "button", variant: "link", tone: "muted", size: "sm", disabled, onClick, children: label }) });
+}
+export {
+  DEFAULT_SIGN_IN_LABELS,
+  SignInForm
+};
+//# sourceMappingURL=sign-in-form.js.map

package/dist/auth/sign-in-form.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/auth/sign-in-form.tsx"],"sourcesContent":["import { useEffect, useEffectEvent, useId, useRef, useState } from \"react\";\nimport type { ComponentPropsWithoutRef, FormEvent, ReactNode } from \"react\";\nimport { KeyRound } from \"lucide-react\";\n\nimport { useKitLabels } from \"../i18n/kit-labels\";\nimport { cn } from \"../lib/cn\";\nimport { AlertBanner } from \"../components/alert-banner\";\nimport { hasMessage } from \"../components/choice-parts\";\nimport { CurrentPasswordInput } from \"../components/danger-confirm\";\nimport { OneTimeCodeInput } from \"../components/one-time-code-input\";\nimport { TextLink } from \"../components/text-link\";\nimport { Button, Input } from \"../components/ui\";\nimport { authErrorCode, englishRateLimited, isRateLimited, retryAfterSeconds } from \"./auth-errors\";\nimport type { KitErrorCode } from \"./auth-errors\";\nimport { taggedEmail } from \"./email-tag\";\nimport { newPasswordProblem } from \"./form-rules\";\nimport { NewPasswordFields } from \"./new-password-fields\";\n\n/* ── The answers (§5.1) ──────────────────────────────────────────────────── */\n\n/**\n * What a sign-in call answers, in the kit's words — docs/auth-harmonization.md §5.1,\n * keksdose's three shapes. The app maps its own HTTP answer to one of these and resolves\n * with it; a refusal REJECTS (with whatever its client throws — {@link authErrorCode}\n * reads the code out of it).\n *\n * | the server answers (keksdose) | resolve with |\n * |---|---|\n * | `TokenResponse` `{access_token, refresh_token, token_type, user}` | `{ kind: \"signed-in\" }`, after the app has stored the session |\n * | `{requires_2fa: true, challenge_token}` | `{ kind: \"2fa\", challengeToken: challenge_token }` |\n * | `{requires_password_change: true, challenge_token, encrypted}` | `{ kind: \"password-change\", challengeToken: challenge_token, extra: { encrypted } }` |\n * | `401 {code: \"invalid_credentials\"}` | reject — let the client's error through |\n *\n * ```ts\n * async function toAnswer(res: TokenResponse | TwoFactorChallenge | PasswordChangeChallenge): Promise<SignInAnswer> {\n *   if (\"requires_2fa\" in res) return { kind: \"2fa\", challengeToken: res.challenge_token };\n *   if (\"requires_password_change\" in res)\n *     return { kind: \"password-change\", challengeToken: res.challenge_token, extra: { encrypted: res.encrypted } };\n *   await onLoginSuccess(res); // store tokens, load /auth/me, switch language\n *   return { kind: \"signed-in\" };\n * }\n * <SignInForm onSubmit={async (v) => toAnswer(await authApi.login(v))} … />\n * ```\n *\n * The same mapping serves `/auth/login/2fa`, `/auth/login/set-password` and the passkey\n * finish, which answer the same union.\n */\nexport type SignInAnswer =\n  | { kind: \"signed-in\" }\n  | { kind: \"2fa\"; challengeToken: string }\n  | {\n      kind: \"password-change\";\n      challengeToken: string;\n      /** The challenge's app fields, passed through untouched — keksdose's `encrypted`,\n       *  which its note on this step reads (`passwordChangeContent`). */\n      extra?: Readonly<Record<string, unknown>>;\n    };\n\n/** The step on screen: the credentials, the second factor, or a new password. */\nexport type SignInStep = \"credentials\" | \"2fa\" | \"password-change\";\n\n/** What the person did when a call failed — {@link SignInFormProps.describeError}'s\n *  second argument. */\nexport type SignInAction = \"password\" | \"passkey\" | \"code\" | \"set-password\";\n\nexport interface SignInCredentials {\n  /** Trimmed. Lower-casing is the server's (§3.1). */\n  email: string;\n  /** As typed, never trimmed. */\n  password: string;\n}\n\nexport interface SignInCodeValues {\n  challengeToken: string;\n  /** Digits only — {@link OneTimeCodeInput} drops the spaces of \"123 456\". A backup code\n   *  (`kind: \"recovery\"`) is trimmed and otherwise as typed: its dashes and case are the\n   *  server's to normalise, as kastlan's `_normalise_backup_code` does. */\n  code: string;\n  /**\n   * 0.30.0: `\"recovery\"` when the person typed one of their backup codes instead\n   * (`recoveryCode`); absent for the authenticator's code, as before. kastlan's\n   * `/auth/login/2fa` takes either in the same `code` and tells them apart itself; an\n   * app whose server takes a backup code elsewhere routes on this.\n   */\n  kind?: \"recovery\";\n}\n\nexport interface SignInNewPasswordValues {\n  challengeToken: string;\n  password: string;\n}\n\n/* ── Labels ──────────────────────────────────────────────────────────────── */\n\n/**\n * Every string `SignInForm` renders — the `signIn` namespace of `<UiKitProvider\n * labels>`, overridable per instance through `labels`. keksdose's words where it has\n * them (`auth.*` in its catalogue).\n */\nexport interface SignInLabels {\n  email: string;\n  password: string;\n  /** The submit button. */\n  submit: string;\n  /** The passkey button (`onPasskey`). */\n  passkey: string;\n  /** The link to `forgotHref`. */\n  forgotPassword: string;\n  /** Before the link to `registerHref`. */\n  noAccount: string;\n  /** The link to `registerHref`. */\n  register: string;\n  /** The ONE answer to an unknown address, a wrong password and a deactivated account\n   *  (`invalid_credentials`, §5.2). */\n  invalidCredentials: string;\n  /** Any other failed sign-in (the network, a 500). */\n  failed: string;\n  /** A failed or refused passkey sign-in. */\n  passkeyFailed: string;\n  /**\n   * The hint under `invalidCredentials` (§2.10), shown when `deactivatedContact` is\n   * given. A TEMPLATE: `{contact}` is replaced by the contact — a `mailto:` link for an\n   * address — so a language puts it where its grammar needs it.\n   */\n  deactivatedHint: string;\n  /** The hint under `invalidCredentials` when `emailTag` is given (§4.5), given the\n   *  typed address with the app's tag: \"Signed up with ada+kastlan@example.com?\". */\n  tagHint: (taggedAddress: string) => string;\n  /** The second-factor step's heading. */\n  twoFactorTitle: string;\n  twoFactorIntro: string;\n  /** The code field's label. */\n  code: string;\n  /** The code step's submit button. */\n  verify: string;\n  /** The code was refused. */\n  codeInvalid: string;\n  /** The set-a-new-password step's heading. */\n  setPasswordTitle: string;\n  setPasswordIntro: string;\n  newPassword: string;\n  confirmPassword: string;\n  passwordMismatch: string;\n  /** The set-a-new-password step's submit button. */\n  setPasswordSubmit: string;\n  setPasswordFailed: string;\n  /** A challenge was refused as `token_invalid` — it expired between the steps; the\n   *  form is back on the credentials. */\n  expired: string;\n  /** From the second and third step back to the credentials. */\n  backToSignIn: string;\n  /*\n   * 0.30.0 — OPTIONAL, like `TwoFactorSettingLabels.qrAlt` and for its reason: a new\n   * required key is a compile error at every call site that annotates this interface\n   * (CONTRIBUTING's additive-API rule). Each falls back to the provider's `signIn`, then\n   * English.\n   */\n  /** The second-factor step's switch to a backup code (`recoveryCode`). */\n  useRecoveryCode?: string;\n  /** The switch back, from the backup-code field to the authenticator's code. */\n  useAuthenticatorCode?: string;\n  /** The backup-code field's label. */\n  recoveryCode?: string;\n  /** The step's intro while a backup code is asked for, in place of `twoFactorIntro`. */\n  recoveryIntro?: string;\n  /** Under the backup-code field, given how many letters and digits a code has. */\n  recoveryCodeHint?: (length: number) => string;\n  /** A refused backup code — wrong, or spent already (each one works once). */\n  recoveryCodeInvalid?: string;\n  /** Any step's request was throttled — HTTP 429 ({@link isRateLimited}) — given the\n   *  wait its `Retry-After` asks for, in seconds ({@link retryAfterSeconds}), or\n   *  `undefined` (or `0`) without one. */\n  rateLimited?: (seconds?: number) => string;\n}\n\n/** `Required`: every key, the 0.30 ones included, has its English here. */\nexport const DEFAULT_SIGN_IN_LABELS: Required<SignInLabels> = {\n  email: \"Email\",\n  password: \"Password\",\n  submit: \"Sign in\",\n  passkey: \"Sign in with a passkey\",\n  forgotPassword: \"Forgot your password?\",\n  noAccount: \"No account yet?\",\n  register: \"Create account\",\n  invalidCredentials: \"The email or password is incorrect.\",\n  failed: \"Sign-in failed. Please try again.\",\n  passkeyFailed: \"Passkey sign-in failed.\",\n  deactivatedHint: \"Account deactivated? Write to {contact}.\",\n  tagHint: (taggedAddress) => `Signed up with ${taggedAddress}? Use that address.`,\n  twoFactorTitle: \"Two-factor authentication\",\n  twoFactorIntro: \"Enter the code your authenticator app shows.\",\n  code: \"2FA code\",\n  verify: \"Verify\",\n  codeInvalid: \"Invalid 2FA code.\",\n  setPasswordTitle: \"Choose a new password\",\n  setPasswordIntro: \"A new password was requested for this account. Choose one and you are straight back in.\",\n  newPassword: \"New password\",\n  confirmPassword: \"Repeat new password\",\n  passwordMismatch: \"The passwords don't match.\",\n  setPasswordSubmit: \"Set password and sign in\",\n  setPasswordFailed: \"The password could not be set.\",\n  expired: \"This sign-in has expired. Please sign in again.\",\n  backToSignIn: \"Back to sign in\",\n  useRecoveryCode: \"Use a backup code\",\n  useAuthenticatorCode: \"Use your authenticator app\",\n  recoveryCode: \"Backup code\",\n  recoveryIntro: \"Enter one of the backup codes you saved when you turned on two-factor authentication.\",\n  recoveryCodeHint: (length) => `${length} letters and digits. Dashes and spaces don’t matter.`,\n  recoveryCodeInvalid: \"This backup code is not valid, or it has been used already.\",\n  rateLimited: englishRateLimited,\n};\n\n/* ── Props ───────────────────────────────────────────────────────────────── */\n\nexport interface SignInFormProps extends Omit<ComponentPropsWithoutRef<\"div\">, \"onSubmit\" | \"children\"> {\n  /**\n   * The credentials step was submitted. Send them, and resolve with the answer\n   * ({@link SignInAnswer}) or reject with the client's error. The form never sends a\n   * request itself (§8): keksdose must see the password on its way, to refuse the same\n   * string as an encryption passphrase later.\n   *\n   * On `signed-in` the form's job is over — it stays busy while the app navigates.\n   */\n  onSubmit: (credentials: SignInCredentials) => Promise<SignInAnswer>;\n  /** The second factor was submitted (`/auth/login/2fa`). Resolves with the next answer\n   *  — keksdose may still require a new password after the code. */\n  onCode: (values: SignInCodeValues) => Promise<SignInAnswer>;\n  /** The new password was submitted (`/auth/login/set-password`). Resolves with the\n   *  answer, `signed-in` in practice; keksdose's `key_wrap_unchanged` note is the app's\n   *  to show from here. */\n  onSetPassword: (values: SignInNewPasswordValues) => Promise<SignInAnswer>;\n  /**\n   * The passkey button was pressed: run the ceremony (`/auth/passkey/login/begin|finish`)\n   * and resolve with its answer. It asks for NO email — a passkey is bound to the site,\n   * and the browser offers every one it holds (keksdose #126). Left out, no button: pass\n   * it only where `PublicKeyCredential` exists.\n   */\n  onPasskey?: () => Promise<SignInAnswer>;\n  /**\n   * Passkey autofill (conditional mediation). The email field is\n   * `autoComplete=\"username webauthn\"`, so a pending `navigator.credentials.get({\n   * mediation: \"conditional\" })` lists the site's passkeys in its dropdown. The form\n   * calls this ONCE on mount; arm the request there and resolve with its answer when the\n   * person picks a passkey, or with `null` when nothing happens. The signal aborts on\n   * unmount — cancel the pending request then (keksdose: `armPasskeyAutofill(onDone,\n   * signal)` + `cancelPasskeyAutofill()`). A rejection is silent: the button stays the\n   * reliable path.\n   */\n  passkeyAutofill?: (signal: AbortSignal) => Promise<SignInAnswer | null | undefined>;\n  /** \"Forgot your password?\" goes here — the app's `/forgot-password`. Left out, no\n   *  link. */\n  forgotHref?: string;\n  /** \"No account yet? Create account\" goes here — `/register`. Left out, no line. */\n  registerHref?: string;\n  /** The email field's start value — the reset page ends on \"Sign in\" with the address\n   *  filled in (§6.3). */\n  defaultEmail?: string;\n  /**\n   * The app's address tag (`\"kastlan\"`, §4.5). After `invalid_credentials` the form also\n   * says \"Signed up with you+kastlan@example.com? Use that address.\" — sign-in stays\n   * exact, and the server looks nothing up.\n   */\n  emailTag?: string;\n  /**\n   * Who a deactivated user writes to (§2.10): an address (drawn as a `mailto:` link) or\n   * the app's own node. Shown after `invalid_credentials` as \"Account deactivated? Write\n   * to …\". Left out, no hint.\n   */\n  deactivatedContact?: ReactNode;\n  /** Digits of the second factor. Default 6 (TOTP). */\n  codeLength?: number;\n  /**\n   * 0.30.0: offer a backup code on the second-factor step (kastlan's 0.29 adoption: its\n   * `/auth/login/2fa` takes one of the eight codes minted at 2FA setup, and the kit's\n   * step had no way to type one). A \"Use a backup code\" switch under the code field\n   * swaps the digits-only {@link OneTimeCodeInput} for a plain text field; the code goes\n   * to `onCode` with the same challenge and `kind: \"recovery\"`.\n   *\n   * `true` for a 16-character code (kastlan's `ABCD-EFGH-JKLM-NPQR`), or `{ length }`.\n   * The length counts letters and digits only — the dashes and spaces a printed code is\n   * grouped with don't count — and \"Verify\" waits for it. Left out, no switch.\n   */\n  recoveryCode?: boolean | { length?: number };\n  /** App content at the top of the credentials step — a notice, a demo button. */\n  credentialsContent?: ReactNode;\n  /**\n   * App content on the second-factor step, under its intro. 0.30.0: pass a function and\n   * it gets the challenge token — kastlan kept its own copy of the token for a \"lost\n   * your device?\" link, which the step now hands over.\n   */\n  twoFactorContent?: ReactNode | ((challengeToken: string) => ReactNode);\n  /**\n   * App content on the set-a-new-password step, under its intro — keksdose's\n   * private-mode note (\"Your encrypted data is untouched …\"), which depends on the\n   * challenge: pass a function and it gets the challenge's `extra`.\n   */\n  passwordChangeContent?: ReactNode | ((extra: Readonly<Record<string, unknown>> | undefined) => ReactNode);\n  /**\n   * The app's own words for a failure, or `undefined` for the kit's: the device being\n   * offline, a throttle with its wait (\"try again in an hour\"). Asked first, for every\n   * failure; what it returns replaces the message, and the `invalid_credentials` hints\n   * still follow. A bare `429` needs none since 0.30.0: the kit says `rateLimited`.\n   */\n  describeError?: (error: unknown, action: SignInAction) => ReactNode | undefined;\n  /** The step changed — retitle the page (`AuthLayout`'s `title`) if the app wants. */\n  onStepChange?: (step: SignInStep) => void;\n  /** The level of the second and third step's heading. Default `h2`, under the page's\n   *  `h1`; one level under `AuthLayout`'s `headingAs` where that is embedded lower. */\n  headingAs?: \"h2\" | \"h3\" | \"h4\" | \"h5\" | \"h6\";\n  labels?: Partial<SignInLabels>;\n}\n\n/* ── Parts ───────────────────────────────────────────────────────────────── */\n\ninterface Failure {\n  action: SignInAction;\n  code: KitErrorCode | undefined;\n  message: ReactNode;\n  /** The address the failed credentials carried — the tag hint names its tagged form. */\n  email?: string;\n}\n\n/** `{contact}` in the template, replaced by the contact (a `mailto:` link for an\n *  address). Split, not interpolated, so the link is an element. A template that lost\n *  its placeholder still shows the contact, after it. */\nfunction withContact(template: string, contact: ReactNode): ReactNode[] {\n  const node =\n    typeof contact === \"string\" && contact.includes(\"@\") ? (\n      <TextLink key=\"contact\" href={`mailto:${contact}`} tone=\"secondary\">\n        {contact}\n      </TextLink>\n    ) : (\n      <span key=\"contact\">{contact}</span>\n    );\n  if (!template.includes(\"{contact}\")) return [template, \" \", node];\n  return template\n    .split(/(\\{contact\\})/)\n    .filter((part) => part !== \"\")\n    .map((part) => (part === \"{contact}\" ? node : part));\n}\n\nconst HINT_CLASS = \"text-xs text-[var(--text-secondary)]\";\n\n/** A backup code's letters and digits — kastlan's: 16, printed `ABCD-EFGH-JKLM-NPQR`. */\nconst RECOVERY_CODE_LENGTH = 16;\n\n/** How many letters and digits a typed backup code has: the dashes and spaces it is\n *  printed in groups with don't count, so \"abcd-efgh ijkl mnop\" is 16 — the count\n *  kastlan's server normalises the code to before it compares. */\nfunction recoveryCharacters(value: string): number {\n  return value.replace(/[^\\p{L}\\p{N}]/gu, \"\").length;\n}\nconst INTRO_CLASS = \"text-sm text-[var(--text-secondary)]\";\n\n/* ── The form ────────────────────────────────────────────────────────────── */\n\n/**\n * Sign-in for every app (docs/auth-harmonization.md §5, §8): email and password, or a\n * passkey; then the second factor when it is on; then a new password when an admin\n * required one. keksdose's `LoginPage` and `ForcedPasswordChangeStep`\n * (features/auth/login-page.tsx, forced-password-change.tsx), as one component.\n *\n * **It never sends a request.** Each step hands its input to a callback and renders the\n * {@link SignInAnswer} it resolves with; a rejection is shown in the step it came from.\n * The challenge token lives in this component's state only, as in keksdose, so a reload\n * costs a fresh sign-in — no route, no storage.\n *\n * **One error for every wrong credential** (§2.10, §5.2): `invalid_credentials` shows one\n * sentence, whatever was wrong, plus two hints UNDER it — \"Account deactivated? Write to\n * …\" (`deactivatedContact`) and \"Signed up with you+kastlan@…? Use that address.\"\n * (`emailTag`). Any other failure says \"Sign-in failed\" and no hint: the hints answer a\n * refused credential, not a network that is down. `describeError` puts the app's words\n * on a failure the kit cannot know (a throttled attempt).\n *\n * **The steps.**\n *  - Credentials: the email field is `username webauthn` (passkey autofill, see\n *    `passkeyAutofill`), the password a `CurrentPasswordInput` (a password manager fills\n *    it and never offers a new one). The submit is not disabled while the fields are\n *    empty: a browser that autofills on load withholds the values until the first\n *    interaction, and a disabled button would swallow that first click. The fields'\n *    own `required` answers an empty submit instead. \"Forgot your password?\" sits under\n *    the buttons, where someone whose password just failed is already looking\n *    (keksdose #198).\n *  - Second factor: {@link OneTimeCodeInput}, focused on arrival. \"Verify\" waits for the\n *    whole code. A refused code stays here with its error; `token_invalid` (the\n *    challenge expired) goes back to the credentials and says why. Kurvenschmiede has\n *    no 2FA yet, and the step is here from the start, so adding it is backend work only\n *    (§10.5). With `recoveryCode` (0.30.0) a switch under the field takes a backup code\n *    instead, through the same `onCode` with `kind: \"recovery\"`.\n *\n * **A throttled request** (HTTP 429, {@link isRateLimited}) says \"Too many attempts. Try\n * again in 30 s.\" on any step (0.30.0) — the wait from its `Retry-After`, else \"Wait a\n * moment and try again.\" — after `describeError`, whose words still come first, and\n * instead of \"wrong password\" or \"invalid code\", which would send the person to try\n * another one.\n *  - New password: new + confirm with the strength meter, the 8-character / 72-byte\n *    rules and nothing else (§8). It reads as explained, not blocked (keksdose): the\n *    person did nothing wrong.\n *\n * The password is dropped from state once the credentials are answered; \"Back to sign in\"\n * returns to an empty password field.\n */\nexport function SignInForm({\n  onSubmit,\n  onCode,\n  onSetPassword,\n  onPasskey,\n  passkeyAutofill,\n  forgotHref,\n  registerHref,\n  defaultEmail = \"\",\n  emailTag,\n  deactivatedContact,\n  codeLength = 6,\n  recoveryCode,\n  credentialsContent,\n  twoFactorContent,\n  passwordChangeContent,\n  describeError,\n  onStepChange,\n  headingAs: Heading = \"h2\",\n  labels: labelsProp,\n  className,\n  ...rest\n}: SignInFormProps) {\n  const labels = useKitLabels(\"signIn\", DEFAULT_SIGN_IN_LABELS, labelsProp);\n  const [step, setStep] = useState<SignInStep>(\"credentials\");\n  const [email, setEmail] = useState(defaultEmail);\n  const [password, setPassword] = useState(\"\");\n  const [code, setCode] = useState(\"\");\n  // 0.30.0: the second factor as a backup code instead of the authenticator's digits.\n  const [useRecovery, setUseRecovery] = useState(false);\n  const [recovery, setRecovery] = useState(\"\");\n  const [newPassword, setNewPassword] = useState(\"\");\n  const [confirm, setConfirm] = useState(\"\");\n  const [challenge, setChallenge] = useState<{ token: string; extra?: Readonly<Record<string, unknown>> } | null>(\n    null,\n  );\n  // What is running: one call at a time. \"done\" after `signed-in` — the app has the\n  // session and is leaving; the buttons stay busy so nothing is sent twice meanwhile.\n  const [busy, setBusy] = useState<SignInAction | \"done\" | null>(null);\n  const [failure, setFailure] = useState<Failure | null>(null);\n  const headingId = useId();\n\n  const emailRef = useRef<HTMLInputElement>(null);\n  const passwordRef = useRef<HTMLInputElement>(null);\n  const codeRef = useRef<HTMLInputElement>(null);\n  const recoveryRef = useRef<HTMLInputElement>(null);\n  const newPasswordRef = useRef<HTMLInputElement>(null);\n\n  // A late answer after unmount (the app navigated away) must not set state.\n  const mounted = useRef(true);\n  useEffect(() => {\n    mounted.current = true;\n    return () => {\n      mounted.current = false;\n    };\n  }, []);\n\n  const goTo = (next: SignInStep) => {\n    setStep(next);\n    onStepChange?.(next);\n  };\n\n  const present = (answer: SignInAnswer) => {\n    setFailure(null);\n    if (answer.kind === \"signed-in\") {\n      setBusy(\"done\");\n      return;\n    }\n    setBusy(null);\n    // The password has done its work; it does not stay in state for the next steps.\n    setPassword(\"\");\n    setCode(\"\");\n    setRecovery(\"\");\n    setUseRecovery(false);\n    setNewPassword(\"\");\n    setConfirm(\"\");\n    if (answer.kind === \"2fa\") {\n      setChallenge({ token: answer.challengeToken });\n      goTo(\"2fa\");\n    } else if (answer.kind === \"password-change\") {\n      setChallenge({ token: answer.challengeToken, extra: answer.extra });\n      goTo(\"password-change\");\n    }\n  };\n\n  const messageFor = (\n    error: unknown,\n    action: SignInAction,\n    code: KitErrorCode | undefined,\n    recoveryUsed: boolean,\n  ): ReactNode => {\n    const own = describeError?.(error, action);\n    if (hasMessage(own)) return own;\n    // After the app's words, before the kit's generic ones (0.30.0): a throttle is\n    // neither a wrong password nor a wrong code, and saying so sends the person to try\n    // another one — which the limiter counts too.\n    if (isRateLimited(error)) return (labels.rateLimited ?? DEFAULT_SIGN_IN_LABELS.rateLimited)(retryAfterSeconds(error));\n    if (action === \"password\") return code === \"invalid_credentials\" ? labels.invalidCredentials : labels.failed;\n    if (action === \"passkey\") return labels.passkeyFailed;\n    if (action === \"code\") {\n      if (code === \"token_invalid\") return labels.expired;\n      return recoveryUsed\n        ? (labels.recoveryCodeInvalid ?? DEFAULT_SIGN_IN_LABELS.recoveryCodeInvalid)\n        : labels.codeInvalid;\n    }\n    return code === \"token_invalid\" ? labels.expired : labels.setPasswordFailed;\n  };\n\n  const fail = (error: unknown, action: SignInAction, sentEmail?: string, recoveryUsed = false) => {\n    setBusy(null);\n    // Our own abort (a passkey ceremony cancelled by the unmount) is no failure.\n    if ((error as { name?: unknown } | null)?.name === \"AbortError\") return;\n    const code = authErrorCode(error);\n    const message = messageFor(error, action, code, recoveryUsed);\n    // The challenge expired between the steps: only a fresh sign-in helps.\n    if ((action === \"code\" || action === \"set-password\") && code === \"token_invalid\") {\n      setChallenge(null);\n      setCode(\"\");\n      setRecovery(\"\");\n      setUseRecovery(false);\n      setNewPassword(\"\");\n      setConfirm(\"\");\n      goTo(\"credentials\");\n    }\n    setFailure({ action, code, message, email: sentEmail });\n  };\n\n  const attempt = (\n    action: SignInAction,\n    call: () => Promise<SignInAnswer>,\n    sentEmail?: string,\n    recoveryUsed = false,\n  ) => {\n    if (busy) return;\n    setBusy(action);\n    setFailure(null);\n    let result: Promise<SignInAnswer>;\n    try {\n      result = Promise.resolve(call());\n    } catch (error) {\n      result = Promise.reject(error);\n    }\n    result.then(\n      (answer) => {\n        if (mounted.current) present(answer);\n      },\n      (error: unknown) => {\n        if (mounted.current) fail(error, action, sentEmail, recoveryUsed);\n      },\n    );\n  };\n\n  // Passkey autofill: armed once, on mount; the signal aborts on unmount. Its answer\n  // arrives whenever the person picks a passkey from the email field's dropdown — and\n  // is dropped if they have meanwhile started a sign-in of their own.\n  const armAutofill = useEffectEvent((signal: AbortSignal) => passkeyAutofill?.(signal));\n  const autofillAnswered = useEffectEvent((answer: SignInAnswer) => {\n    if (busy === null) present(answer);\n  });\n  useEffect(() => {\n    const controller = new AbortController();\n    let pending: Promise<SignInAnswer | null | undefined>;\n    try {\n      pending = Promise.resolve(armAutofill(controller.signal));\n    } catch (error) {\n      pending = Promise.reject(error);\n    }\n    pending.then(\n      (answer) => {\n        if (answer && !controller.signal.aborted && mounted.current) autofillAnswered(answer);\n      },\n      () => {\n        /* silent — unsupported, declined or aborted; the button stays the way in */\n      },\n    );\n    return () => controller.abort();\n  }, []);\n\n  // Focus follows the step — not on mount (where it would pop a phone's keyboard over\n  // the page), only once the person moved to another step.\n  const shownStep = useRef(step);\n  useEffect(() => {\n    if (shownStep.current === step) return;\n    shownStep.current = step;\n    if (step === \"2fa\") codeRef.current?.focus();\n    else if (step === \"password-change\") newPasswordRef.current?.focus();\n    else if (emailRef.current?.value) passwordRef.current?.focus();\n    else emailRef.current?.focus();\n  }, [step]);\n  // The backup-code switch swaps one field for the other under the focus that pressed\n  // it; the field that came in is where the person is going. Only after a switch on\n  // this step — arriving on it is the effect above.\n  const shownRecovery = useRef(useRecovery);\n  useEffect(() => {\n    if (shownRecovery.current === useRecovery) return;\n    shownRecovery.current = useRecovery;\n    if (step !== \"2fa\") return;\n    (useRecovery ? recoveryRef : codeRef).current?.focus();\n  }, [useRecovery, step]);\n\n  const backToCredentials = () => {\n    if (busy) return;\n    setChallenge(null);\n    setFailure(null);\n    setCode(\"\");\n    setRecovery(\"\");\n    setUseRecovery(false);\n    setNewPassword(\"\");\n    setConfirm(\"\");\n    goTo(\"credentials\");\n  };\n\n  const working = busy !== null;\n  const rootClass = cn(\"space-y-3\", className);\n\n  /* ── Step 2: the second factor ── */\n  if (step === \"2fa\" && challenge) {\n    const recoveryOn = recoveryCode !== undefined && recoveryCode !== false;\n    const recoveryLength = (typeof recoveryCode === \"object\" ? recoveryCode.length : undefined) ?? RECOVERY_CODE_LENGTH;\n    const asRecovery = recoveryOn && useRecovery;\n    const recoveryReady = recoveryCharacters(recovery) === recoveryLength;\n    const ready = asRecovery ? recoveryReady : code.length === codeLength;\n    const submitCode = (e: FormEvent) => {\n      e.preventDefault();\n      if (!ready) return;\n      if (asRecovery) {\n        attempt(\n          \"code\",\n          () => onCode({ challengeToken: challenge.token, code: recovery.trim(), kind: \"recovery\" }),\n          undefined,\n          true,\n        );\n        return;\n      }\n      attempt(\"code\", () => onCode({ challengeToken: challenge.token, code }));\n    };\n    const switchCode = () => {\n      if (working) return;\n      setFailure(null);\n      setCode(\"\");\n      setRecovery(\"\");\n      setUseRecovery((on) => !on);\n    };\n    const codeError = failure?.action === \"code\" ? failure.message : undefined;\n    const content =\n      typeof twoFactorContent === \"function\" ? twoFactorContent(challenge.token) : twoFactorContent;\n    return (\n      <div {...rest} data-step=\"2fa\" className={rootClass}>\n        <form className=\"space-y-3\" aria-labelledby={headingId} onSubmit={submitCode}>\n          <Heading id={headingId} className=\"text-base font-semibold text-[var(--text-primary)]\">\n            {labels.twoFactorTitle}\n          </Heading>\n          <p className={INTRO_CLASS}>\n            {asRecovery ? (labels.recoveryIntro ?? DEFAULT_SIGN_IN_LABELS.recoveryIntro) : labels.twoFactorIntro}\n          </p>\n          {content}\n          {asRecovery ? (\n            // A plain text field, not the digits-only one: a backup code is letters and\n            // digits in printed groups. Nothing a phone keyboard would \"correct\", and no\n            // autofill — the browser's suggestion for an unknown field is the username.\n            <Input\n              ref={recoveryRef}\n              label={labels.recoveryCode ?? DEFAULT_SIGN_IN_LABELS.recoveryCode}\n              name=\"recovery-code\"\n              value={recovery}\n              onChange={(e) => {\n                setRecovery(e.target.value);\n                if (failure) setFailure(null);\n              }}\n              autoComplete=\"off\"\n              autoCapitalize=\"characters\"\n              autoCorrect=\"off\"\n              spellCheck={false}\n              inputClassName=\"font-mono\"\n              hint={(labels.recoveryCodeHint ?? DEFAULT_SIGN_IN_LABELS.recoveryCodeHint)(recoveryLength)}\n              readOnly={working}\n              error={codeError}\n              required\n            />\n          ) : (\n            <OneTimeCodeInput\n              ref={codeRef}\n              label={labels.code}\n              name=\"code\"\n              value={code}\n              length={codeLength}\n              onChange={(next) => {\n                setCode(next);\n                if (failure) setFailure(null);\n              }}\n              readOnly={working}\n              error={codeError}\n              required\n            />\n          )}\n          {recoveryOn && (\n            <p className=\"text-sm\">\n              <Button type=\"button\" variant=\"link\" size=\"sm\" disabled={working} onClick={switchCode}>\n                {asRecovery\n                  ? (labels.useAuthenticatorCode ?? DEFAULT_SIGN_IN_LABELS.useAuthenticatorCode)\n                  : (labels.useRecoveryCode ?? DEFAULT_SIGN_IN_LABELS.useRecoveryCode)}\n              </Button>\n            </p>\n          )}\n          <Button type=\"submit\" className=\"w-full\" disabled={!working && !ready} pending={working}>\n            {labels.verify}\n          </Button>\n        </form>\n        <BackLink label={labels.backToSignIn} onClick={backToCredentials} disabled={working} />\n      </div>\n    );\n  }\n\n  /* ── Step 3: a new password ── */\n  if (step === \"password-change\" && challenge) {\n    const problem = newPasswordProblem(newPassword, confirm);\n    const submitPassword = (e: FormEvent) => {\n      e.preventDefault();\n      if (problem) return;\n      attempt(\"set-password\", () => onSetPassword({ challengeToken: challenge.token, password: newPassword }));\n    };\n    const content =\n      typeof passwordChangeContent === \"function\" ? passwordChangeContent(challenge.extra) : passwordChangeContent;\n    return (\n      <div {...rest} data-step=\"password-change\" className={rootClass}>\n        <form className=\"space-y-3\" aria-labelledby={headingId} onSubmit={submitPassword}>\n          <Heading id={headingId} className=\"text-base font-semibold text-[var(--text-primary)]\">\n            {labels.setPasswordTitle}\n          </Heading>\n          <p className={INTRO_CLASS}>{labels.setPasswordIntro}</p>\n          {content}\n          {/* Which account the new password is for, for the password manager: it files\n              the new password under this username instead of guessing. */}\n          {email !== \"\" && (\n            <input type=\"email\" name=\"username\" autoComplete=\"username\" value={email} readOnly hidden />\n          )}\n          <NewPasswordFields\n            password={newPassword}\n            confirm={confirm}\n            onPasswordChange={setNewPassword}\n            onConfirmChange={setConfirm}\n            busy={working}\n            passwordRef={newPasswordRef}\n            text={{ password: labels.newPassword, confirm: labels.confirmPassword, mismatch: labels.passwordMismatch }}\n          />\n          {failure?.action === \"set-password\" && (\n            <AlertBanner tone=\"danger\" size=\"sm\" role=\"alert\">\n              {failure.message}\n            </AlertBanner>\n          )}\n          <Button type=\"submit\" className=\"w-full\" disabled={!working && problem !== null} pending={working}>\n            {labels.setPasswordSubmit}\n          </Button>\n        </form>\n        <BackLink label={labels.backToSignIn} onClick={backToCredentials} disabled={working} />\n      </div>\n    );\n  }\n\n  /* ── Step 1: the credentials ── */\n  const submitCredentials = (e: FormEvent) => {\n    e.preventDefault();\n    const sent = email.trim();\n    if (sent === \"\" || password === \"\") return;\n    attempt(\"password\", () => onSubmit({ email: sent, password }), sent);\n  };\n\n  const refused = failure?.code === \"invalid_credentials\";\n  const tagged =\n    refused && failure?.action === \"password\" && emailTag && failure.email ? taggedEmail(failure.email, emailTag) : null;\n  const showDeactivated = refused && hasMessage(deactivatedContact);\n\n  return (\n    <div {...rest} data-step=\"credentials\" className={rootClass}>\n      <form className=\"space-y-3\" onSubmit={submitCredentials}>\n        {credentialsContent}\n        <Input\n          ref={emailRef}\n          type=\"email\"\n          name=\"email\"\n          // \"webauthn\" lets the browser list passkeys in this field's dropdown, paired\n          // with the conditional request `passkeyAutofill` arms.\n          autoComplete=\"username webauthn\"\n          label={labels.email}\n          value={email}\n          onChange={(e) => setEmail(e.target.value)}\n          readOnly={working}\n          required\n        />\n        <CurrentPasswordInput\n          ref={passwordRef}\n          name=\"password\"\n          label={labels.password}\n          value={password}\n          onValueChange={setPassword}\n          busy={working}\n          required\n        />\n        {failure && (\n          // One live region for the sentence and its hints: they are one answer.\n          <div role=\"alert\" className=\"space-y-1.5\">\n            <AlertBanner tone=\"danger\" size=\"sm\">\n              {failure.message}\n            </AlertBanner>\n            {showDeactivated && (\n              <p className={HINT_CLASS}>{withContact(labels.deactivatedHint, deactivatedContact)}</p>\n            )}\n            {tagged && <p className={HINT_CLASS}>{labels.tagHint(tagged)}</p>}\n          </div>\n        )}\n        <Button type=\"submit\" className=\"w-full\" pending={busy === \"password\" || busy === \"done\"} disabled={busy === \"passkey\"}>\n          {labels.submit}\n        </Button>\n        {onPasskey && (\n          <Button\n            type=\"button\"\n            variant=\"secondary\"\n            className=\"w-full\"\n            pending={busy === \"passkey\"}\n            disabled={busy === \"password\" || busy === \"done\"}\n            onClick={() => attempt(\"passkey\", onPasskey)}\n          >\n            <KeyRound aria-hidden className=\"size-4\" />\n            {labels.passkey}\n          </Button>\n        )}\n      </form>\n      {forgotHref !== undefined && (\n        <p className=\"text-center text-sm\">\n          <TextLink href={forgotHref} tone=\"secondary\">\n            {labels.forgotPassword}\n          </TextLink>\n        </p>\n      )}\n      {registerHref !== undefined && (\n        <p className=\"text-center text-sm text-[var(--text-secondary)]\">\n          {labels.noAccount}{\" \"}\n          <TextLink href={registerHref} tone=\"primary\">\n            {labels.register}\n          </TextLink>\n        </p>\n      )}\n    </div>\n  );\n}\n\n/** \"Back to sign in\" under the second and third step: a button, since it changes the\n *  step in place rather than going anywhere. */\nfunction BackLink({ label, onClick, disabled }: { label: string; onClick: () => void; disabled: boolean }) {\n  return (\n    <p className=\"text-center text-sm\">\n      <Button type=\"button\" variant=\"link\" tone=\"muted\" size=\"sm\" disabled={disabled} onClick={onClick}>\n        {label}\n      </Button>\n    </p>\n  );\n}\n"],"mappings":"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","names":["code"]}

package/dist/auth/status-parts.d.ts

@@ -0,0 +1,78 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+
+/**
+ * The pieces the signed-out status pages share — {@link ForgotPasswordForm},
+ * {@link ResetPasswordForm}, {@link VerifyEmailStatus}, {@link AcceptInvitation} and
+ * {@link NotFoundPage} (docs/auth-harmonization.md §7).
+ *
+ * @internal Not part of the barrel; the pages are.
+ */
+/** A heading level a page part may take. Default `h2`, under the page's `h1`
+ *  (`AuthLayout`'s `title`, the app's name), as on `SignInForm`'s steps; deeper for a
+ *  page embedded in another (a preview, the docs). */
+type AuthHeadingLevel = "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
+/** The form pages' heading: start-aligned, the size of `SignInForm`'s step headings. */
+declare const FORM_HEADING_CLASS = "text-base font-semibold text-[var(--text-primary)]";
+/** The status pages' heading: centred over the centred outcome below it. */
+declare const STATUS_HEADING_CLASS = "text-center text-base font-semibold text-[var(--text-primary)]";
+declare const INTRO_CLASS = "text-sm text-[var(--text-secondary)]";
+/**
+ * kastlan's outcome block (verify-email-page, reset-password-page): the kit's
+ * `EmptyState` without its dashed box, because it already sits in `AuthLayout`'s card —
+ * a box in a box. The icon and the title carry the tone.
+ */
+declare const OUTCOME_CLASS = "border-0 bg-transparent px-0 py-3";
+/** `href` with `key=value` added to its query, before any `#fragment`: the reset page's
+ *  "Sign in" carries the address (`/login?email=ada%40example.com`). */
+declare function withQuery(href: string, key: string, value: string): string;
+/** What a callback's promise came to. */
+type Settled<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: unknown;
+};
+/**
+ * Run `start(key)` ONCE per key, and hand what it settles to into `settle` — unless the
+ * key moved on in the meantime, when the stale answer is dropped.
+ *
+ * keksdose's verify-email and join pages fire their request from an effect behind a
+ * `useRef` guard, and say why: the token is single-use, and StrictMode's
+ * mount → unmount → remount would send it twice and turn a success into "invalid" on
+ * the second answer. The guard is the same here; there is deliberately no "unmounted"
+ * flag set in the cleanup, because StrictMode's simulated unmount would set it and the
+ * remount would never clear the guard — the page would hang on its spinner (the bug
+ * keksdose hit on /join with a react-query observer). A state update after a real
+ * unmount is a no-op in React 18 and later.
+ *
+ * `key === null` runs nothing (no token, not signed in yet) and forgets the last key, so
+ * the same token runs again once it is back.
+ */
+declare function useOncePerKey<T>(key: string | null, start: (key: string) => T | Promise<T>, settle: (key: string, result: Settled<T>) => void): void;
+/** Whether a callback's return is a promise to wait for. A callback that returns
+ *  nothing is done when it returns. */
+declare function isThenable(value: unknown): value is PromiseLike<unknown>;
+/**
+ * Move focus to `ref` when `active` turns true — the outcome a person's own submit led
+ * to ("If an account exists … the link is on its way", "Your password has been
+ * changed"). The submit button they pressed is gone with the form, which drops focus to
+ * `<body>`; a screen reader then hears nothing at all. Focusing the message (a
+ * `tabIndex={-1}` box) reads it out and leaves the next Tab where the page continues.
+ */
+declare function useFocusWhen(active: boolean, ref: {
+    current: HTMLElement | null;
+}): void;
+/** The box {@link useFocusWhen} focuses: centred, no focus ring of its own (it is not a
+ *  control; the ring would read as one). */
+declare function OutcomeMessage({ icon, children, focusRef, className, }: {
+    icon: ReactNode;
+    children: ReactNode;
+    focusRef?: {
+        current: HTMLDivElement | null;
+    };
+    className?: string;
+}): react.JSX.Element;
+
+export { type AuthHeadingLevel, FORM_HEADING_CLASS, INTRO_CLASS, OUTCOME_CLASS, OutcomeMessage, STATUS_HEADING_CLASS, type Settled, isThenable, useFocusWhen, useOncePerKey, withQuery };