@alfadocs/ui-kit 1.54.2 → 1.55.0

package/dist/patterns/error-page/error-page.d.ts

@@ -6,11 +6,13 @@ declare const errorPageVariants: (props?: ({
     surface?: "background" | "card" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 /** A host's own main action: a link (`href`) or a button (`onClick`).
- *  The label is shown as given, so pass it already translated. */
+ *  The label is shown as given, so pass it already translated. A link may
+ *  also take `onClick`, e.g. to record the click: it runs, and the link
+ *  still opens. */
 export type ErrorPageCustomAction = {
     label: string;
     href: string;
-    onClick?: never;
+    onClick?: () => void;
     icon?: ReactNode;
 } | {
     label: string;
@@ -19,6 +21,14 @@ export type ErrorPageCustomAction = {
     icon?: ReactNode;
 };
 export interface ErrorPageProps extends Omit<HTMLAttributes<HTMLElement>, 'title'>, VariantProps<typeof errorPageVariants> {
+    /** `'page'` fills the viewport; `'embedded'` fills its container, under
+     *  the host's own header. Default `'page'`, or `'embedded'` with
+     *  `surface="card"`. */
+    layout?: VariantProps<typeof errorPageVariants>['layout'];
+    /** `'card'` takes a card's colour, for a page set inside a `Card`, and
+     *  then defaults to `layout="embedded"` and `as="div"`. Default
+     *  `'background'`. */
+    surface?: VariantProps<typeof errorPageVariants>['surface'];
     /** HTTP status, `'offline'` for a network error in the browser, or
      *  `'maintenance'` for planned downtime with no HTTP error behind it.
      *  Statuses without their own copy show the generic page. */
@@ -56,6 +66,12 @@ export interface ErrorPageProps extends Omit<HTMLAttributes<HTMLElement>, 'title
      *  with it; where it was "Try again" or "Log in", the home link
      *  stays as the second button. */
     primaryAction?: ErrorPageCustomAction;
+    /** Shows "Go to the home page". Default true. False hides it on every
+     *  status, leaving the status's own main button ("Try again" or "Log
+     *  in"), or `primaryAction` in its place, and "Contact support" when
+     *  `supportHref` is set. On a status whose main button was Home, that
+     *  can leave no button at all. */
+    showHomeLink?: boolean;
     /** Picks the mark's mood whatever the status, e.g. for a status
      *  without its own copy. */
     mood?: ErrorPageMood;
@@ -65,12 +81,20 @@ export interface ErrorPageProps extends Omit<HTMLAttributes<HTMLElement>, 'title
     showStatusLabel?: boolean;
     /** Signs the page with the Alfadocs wordmark. Default true. */
     showLogo?: boolean;
-    /** Renders as `<main>` (default) or `<div>` when the host already has
-     *  a main landmark. */
+    /** Renders as `<main>` or as `<div>` when the host already has a main
+     *  landmark. Default `'main'`, or `'div'` with `surface="card"`. */
     as?: 'main' | 'div';
     /** Moves focus to the heading once shown, and again when the status
-     *  changes. Default true. */
+     *  or `focusKey` changes. Default true. */
     focusHeading?: boolean;
+    /** Moves focus to the heading again when it changes, even under the
+     *  same status: a retry count, say, so a retry that fails the same way
+     *  is announced again. Copy that changes on its own never moves focus. */
+    focusKey?: string | number;
+    /** Scrolls the heading into view, if it is not, when it takes focus.
+     *  Default false, so focus never moves the host's page. Turn it on when
+     *  the page can appear below the fold, as in a long form. */
+    scrollOnFocus?: boolean;
     /** The heading's level. Default 1; pass 2 inside an app page that
      *  already has its own `h1`. */
     headingLevel?: 1 | 2 | 3;

package/dist/patterns/error-page/index.js

@@ -1,5 +1,5 @@
-import { E, a as e, b as o, e as R, r as s } from "../../_chunks/error-page-C15GfNEj.js";
-import { E as _ } from "../../_chunks/error-page-illustration-bFti0VEc.js";
+import { E, a as e, b as o, e as R, r as s } from "../../_chunks/error-page-CpuYbpOB.js";
+import { E as _ } from "../../_chunks/error-page-illustration-BdJLuMdV.js";
 export {
   E as ERROR_PAGE_FALLBACK_LOCALE,
   _ as ERROR_PAGE_MOODS,

package/dist/patterns/forgot-password-form/forgot-password-form.d.ts

@@ -47,8 +47,9 @@ export interface ForgotPasswordFormProps extends Omit<HTMLAttributes<HTMLDivElem
     /**
      * Messages from the server, already translated. The email's message
      * shows on the field until the user changes it; `form` shows above the
-     * field. When messages arrive, focus moves to the email, or to the
-     * message above it when only that says something.
+     * field. When messages arrive, focus moves to the error summary at the
+     * top of the form when the email has a message, or to the message
+     * above the field when only that says something.
      *
      * Do not use a message to say that no account has the address: that
      * tells a stranger who has an account. Show `sent` for every address.

package/dist/patterns/forgot-password-form/index.js

@@ -1,4 +1,4 @@
-import { F as r, a } from "../../_chunks/forgot-password-form-DVVOBEGj.js";
+import { F as r, a } from "../../_chunks/forgot-password-form-DEx-M_QR.js";
 export {
   r as FORGOT_PASSWORD_FORM_FIELDS,
   a as ForgotPasswordForm

package/dist/patterns/help-me-write-templates/index.js

@@ -1,4 +1,4 @@
-import { A as s, a as t, b as r, H as i, c as p, u as l } from "../../_chunks/help-me-write-templates-Cy-iO5AU.js";
+import { A as s, a as t, b as r, H as i, c as p, u as l } from "../../_chunks/help-me-write-templates-B7L3zGsE.js";
 export {
   s as AiCreditsExhaustedError,
   t as AiCreditsExhaustedNotice,

package/dist/patterns/login-form/index.js

@@ -1,4 +1,4 @@
-import { L, a as r, b as s } from "../../_chunks/login-dev-card-q7iTojvV.js";
+import { L, a as r, b as s } from "../../_chunks/login-dev-card-DmZ1B0lB.js";
 export {
   L as LOGIN_FORM_FIELDS,
   r as LoginDevCard,

package/dist/patterns/login-form/login-form.d.ts

@@ -56,10 +56,11 @@ export interface LoginFormProps extends Omit<HTMLAttributes<HTMLDivElement>, 'ti
      * the fields.
      *
      * When messages arrive, the password is emptied and focus moves: to
-     * the first field with a message, or, when only `form` says something,
-     * to the password, which is then described by that message. The same
-     * happens for messages present when the form opens (a page the server
-     * rendered after a failed post).
+     * the error summary at the top of the form, which lists each field
+     * with a message, or, when only `form` says something, to the
+     * password, which is then described by that message. The same happens
+     * for messages present when the form opens (a page the server rendered
+     * after a failed post).
      *
      * Never say which of the two values was wrong: one message for both.
      * Set `submitting` while you send, so the form also notices an answer

package/dist/patterns/marketplace-app-shell/index.js

@@ -1,4 +1,4 @@
-import { C as l, M as o } from "../../_chunks/marketplace-app-shell-DbEfoNxe.js";
+import { C as l, M as o } from "../../_chunks/marketplace-app-shell-Dcx-JEjg.js";
 export {
   l as ConnectWithAlfadocs,
   o as MarketplaceAppShell

package/dist/patterns/payment-automation-upsell/index.js

@@ -1,4 +1,4 @@
-import { P as a } from "../../_chunks/payment-automation-upsell-DNiraNhF.js";
+import { P as a } from "../../_chunks/payment-automation-upsell-DEUfM7EU.js";
 export {
   a as PaymentAutomationUpsell
 };

package/dist/patterns/registration-form/index.d.ts

@@ -1,3 +1,3 @@
 export { RegistrationForm, REGISTRATION_FORM_FIELDS, } from './registration-form';
-export type { RegistrationFormProps, RegistrationFormField, RegistrationFormFieldNames, RegistrationFormValues, RegistrationFormInitialValues, RegistrationFormErrors, RegistrationFormDevBypass, RegistrationFormDevValues, } from './registration-form';
+export type { RegistrationFormProps, RegistrationFormField, RegistrationFormTextField, RegistrationFormFieldNames, RegistrationFormValues, RegistrationFormInitialValues, RegistrationFormErrors, RegistrationFormDevBypass, RegistrationFormDevValues, } from './registration-form';
 //# sourceMappingURL=index.d.ts.map

package/dist/patterns/registration-form/index.js

@@ -1,4 +1,4 @@
-import { R as o, a as r } from "../../_chunks/registration-form-CBDeXzlk.js";
+import { R as o, a as r } from "../../_chunks/registration-form-D7iNqMBF.js";
 export {
   o as REGISTRATION_FORM_FIELDS,
   r as RegistrationForm

package/dist/patterns/registration-form/registration-form.d.ts

@@ -5,6 +5,8 @@ import { type BrandMarkMotion } from '../_shared/brand-mark';
 /** The fields of the form, in the order they appear. */
 export declare const REGISTRATION_FORM_FIELDS: readonly ["firstName", "lastName", "email", "emailConfirm", "password", "passwordConfirm", "phone", "branch", "terms"];
 export type RegistrationFormField = (typeof REGISTRATION_FORM_FIELDS)[number];
+/** The fields built on `TextInput`, which can refuse paste or copy. */
+export type RegistrationFormTextField = Extract<RegistrationFormField, 'firstName' | 'lastName' | 'email' | 'emailConfirm' | 'password' | 'passwordConfirm'>;
 /** What `onSubmit` receives once every check has passed. A field the
  *  form does not show is empty (`''`, or `false` for the terms). */
 export interface RegistrationFormValues {
@@ -107,8 +109,9 @@ export interface RegistrationFormProps extends Omit<HTMLAttributes<HTMLDivElemen
      * fields, as does a message for a field the form does not show.
      *
      * Messages present when the form opens (a page the server rendered
-     * after a failed post) take focus: the first field with a message, or
-     * the message above the fields.
+     * after a failed post) take focus: the error summary at the top of the
+     * form, which lists each field with a message, or the message above the
+     * fields when no field has one.
      *
      * On a React host, when the messages change, both password fields
      * are emptied and focus moves as above. Set `submitting` while you
@@ -130,6 +133,20 @@ export interface RegistrationFormProps extends Omit<HTMLAttributes<HTMLDivElemen
     /** A line under the email field, e.g. "You can change it later in the
      *  settings". Pass it translated. */
     emailDescription?: string;
+    /**
+     * Fields that refuse paste and drop, so the user types them, e.g.
+     * `['passwordConfirm']`. Default: none. Autofill from the browser or a
+     * password manager still works. A refused paste is announced and shown
+     * under the field. The host decides: see the docs for the WCAG
+     * position, which differs between the email and password fields.
+     */
+    blockPaste?: readonly RegistrationFormTextField[];
+    /**
+     * Fields that refuse copy, cut and dragging text out. Default: none.
+     * Browsers already refuse to copy from a password field while it is
+     * hidden. See the docs for the WCAG position.
+     */
+    blockCopy?: readonly RegistrationFormTextField[];
     /** The specialities to choose from. The field shows, and is required,
      *  only when this has entries. */
     branches?: SelectOption[];

package/dist/patterns/signature-request/index.js

@@ -1,4 +1,4 @@
-import { S as o } from "../../_chunks/signature-request-BdolmJk4.js";
+import { S as o } from "../../_chunks/signature-request-rgMsgo-C.js";
 export {
   o as SignatureRequestModal
 };

package/dist/patterns/signed-out-frame/index.js

@@ -1,4 +1,4 @@
-import { S as r, a as d } from "../../_chunks/signed-out-frame-dz1rLJ65.js";
+import { S as r, a as d } from "../../_chunks/signed-out-frame-B2GTIeqA.js";
 export {
   r as SignedOutFrame,
   d as SignedOutHeader