@alfadocs/ui-kit-debug 1.73.2 → 1.74.0

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

@@ -2,6 +2,7 @@ import { type HTMLAttributes, type ReactNode } from 'react';
 import { type UsePasswordRequirementsOptions } from '../../components/password-input';
 import { type SelectOption } from '../../components/select';
 import { type BrandMarkMotion } from '../_shared/brand-mark';
+import { type RegistrationFieldVerification, type RegistrationVerifiableField } from './use-contact-verification';
 /** 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];
@@ -92,6 +93,19 @@ export interface RegistrationFormProps extends Omit<HTMLAttributes<HTMLDivElemen
      * posted. Keep any heading inside it below the card's own level.
      */
     children?: ReactNode;
+    /**
+     * A short notice above the fields, as plain text already translated. It
+     * shows as an info alert, quiet to screen readers (it is not news). For
+     * a server-rendered page that can only pass JSON. Comes before
+     * `benefits` and `children`.
+     */
+    notice?: string;
+    /**
+     * What the person gets, one short line each, already translated. They
+     * show as a compact list with a tick. Comes after `notice` and before
+     * `children`.
+     */
+    benefits?: string[];
     /**
      * The fields to show. Default: all of them, which is the doctor form.
      * A patient form is `['email', 'password', 'passwordConfirm', 'terms']`.
@@ -174,9 +188,21 @@ export interface RegistrationFormProps extends Omit<HTMLAttributes<HTMLDivElemen
      * required.
      */
     termsLabel?: ReactNode;
+    /**
+     * `termsLabel` as a string, for a host that can only pass JSON. Already
+     * translated. Mark the links with `<terms>…</terms>` and
+     * `<privacy>…</privacy>`: they lead to `termsHref` and `privacyHref`
+     * (new tab; without a safe address, the words show without a link).
+     * Any other tag shows its text only. No marker: plain text. Ignored
+     * when `termsLabel` is set.
+     */
+    termsLabelText?: string;
     /** A line shown with the terms box and read out with it, e.g. "We
      *  will not send you any advertising". Pass it translated. */
     termsDescription?: ReactNode;
+    /** `termsDescription` as a string, with the same markers as
+     *  `termsLabelText`. Ignored when `termsDescription` is set. */
+    termsDescriptionText?: string;
     /** Adds "Already have an account? Sign in". Same rule as `termsHref`. */
     loginHref?: string;
     /** A Google reCAPTCHA v2 site key of the invisible type. The check
@@ -223,6 +249,23 @@ export interface RegistrationFormProps extends Omit<HTMLAttributes<HTMLDivElemen
      * `fieldNames` is left out: the form's own field wins.
      */
     hiddenFields?: Readonly<Record<string, string>>;
+    /**
+     * Proves an email or a phone number with a code before the form
+     * submits. For each field named here the card shows "Send code" beside
+     * the field, a code box once a code is out, and locks the field
+     * (read-only, still posted) when the code is right. The host sends and
+     * checks the codes on its server, which must also refuse the form when
+     * the value was not verified: this is a convenience for the person,
+     * not the check. Without it the form is unchanged.
+     *
+     * `Confirm email` stays; leave `emailConfirm` out of `fields` to drop it.
+     */
+    verification?: Partial<Record<RegistrationVerifiableField, RegistrationFieldVerification>>;
+    /**
+     * With `verification`, the form does not submit until every field named
+     * there is verified. Default true.
+     */
+    requireVerification?: boolean;
 }
 /**
  * The registration form card, for doctors and for patients. The host

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

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

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

@@ -0,0 +1,38 @@
+import type { RegistrationVerifiableField, UseContactVerificationReturn } from './use-contact-verification';
+/** The message a failed send leaves under the field. */
+export declare function useSendFailureMessage(state: UseContactVerificationReturn): string | undefined;
+interface VerificationActionProps {
+    state: UseContactVerificationReturn;
+    /** True when the value could be an address or a number. */
+    canSend: boolean;
+}
+/** "Send code", beside the field. Gone once a code is out. */
+export declare function VerificationAction({ state, canSend, }: VerificationActionProps): import("react/jsx-runtime").JSX.Element | null;
+interface VerificationPanelProps {
+    field: RegistrationVerifiableField;
+    state: UseContactVerificationReturn;
+    /** Hide "Change email": the address cannot be edited here. */
+    canChange?: boolean;
+    /** Show "Change" beside the success line of a field that started
+     *  verified (`allowChange`). The email shows it elsewhere. */
+    changeWhenVerified?: boolean;
+    /** Called after "Change" unlocks the field, to focus it. */
+    onUnlocked?: () => void;
+    /** Called once when the code is right, to put focus back on the field. */
+    onVerified: () => void;
+}
+/** What sits under the field: the code box, or the success line. */
+export declare function VerificationPanel({ field, state, canChange, changeWhenVerified, onUnlocked, onVerified, }: VerificationPanelProps): import("react/jsx-runtime").JSX.Element;
+interface ChangeSlotProps {
+    field: RegistrationVerifiableField;
+    state: UseContactVerificationReturn;
+    /** Called after the field is unlocked, to focus it. */
+    onUnlocked: () => void;
+}
+/**
+ * "Change email", in the cell where Confirm email sits. A hidden label
+ * line above it keeps the action level with the input beside it.
+ */
+export declare function VerificationChangeSlot({ field, state, onUnlocked, }: ChangeSlotProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=registration-verification.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registration-verification.d.ts","sourceRoot":"","sources":["../../../src/patterns/registration-form/registration-verification.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAEV,2BAA2B,EAC3B,4BAA4B,EAC7B,MAAM,4BAA4B,CAAC;AAqBpC,wDAAwD;AACxD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,4BAA4B,GAClC,MAAM,GAAG,SAAS,CAGpB;AAED,UAAU,uBAAuB;IAC/B,KAAK,EAAE,4BAA4B,CAAC;IACpC,2DAA2D;IAC3D,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,OAAO,GACR,EAAE,uBAAuB,kDA4BzB;AAED,UAAU,sBAAsB;IAC9B,KAAK,EAAE,2BAA2B,CAAC;IACnC,KAAK,EAAE,4BAA4B,CAAC;IACpC,8DAA8D;IAC9D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;kEAC8D;IAC9D,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,oEAAoE;AACpE,wBAAgB,iBAAiB,CAAC,EAChC,KAAK,EACL,KAAK,EACL,SAAgB,EAChB,kBAA0B,EAC1B,UAAU,EACV,UAAU,GACX,EAAE,sBAAsB,2CA0LxB;AAED,UAAU,eAAe;IACvB,KAAK,EAAE,2BAA2B,CAAC;IACnC,KAAK,EAAE,4BAA4B,CAAC;IACpC,uDAAuD;IACvD,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,KAAK,EACL,KAAK,EACL,UAAU,GACX,EAAE,eAAe,2CA+BjB"}

package/dist/patterns/registration-form/use-contact-verification.d.ts

@@ -0,0 +1,107 @@
+/** The fields that can be verified by a code. */
+export type RegistrationVerifiableField = 'email' | 'phone';
+/** Why a send or a check failed. */
+export type RegistrationCodeFailure = 'invalid' | 'expired' | 'rate_limited' | 'error';
+/** What the host answers when a code is sent or checked. */
+export interface RegistrationCodeResult {
+    ok: boolean;
+    /** Already translated by the host. Shown under the field when `ok` is
+     *  false, instead of the kit's own wording for `reason`. */
+    message?: string;
+    reason?: RegistrationCodeFailure;
+    /** With `rate_limited`: seconds before another send is allowed. */
+    retryAfterSeconds?: number;
+    /** After a send: seconds before "Send a new code" works. Default 30. */
+    resendAfterSeconds?: number;
+    /** Development only. The host passes it only when its server says this
+     *  is a development environment; it shows in an info alert. */
+    devCode?: string;
+    /** After a check: the value the server verified. Informational. */
+    value?: string;
+}
+/** Options both ways of verifying a field share. */
+export interface RegistrationFieldVerificationOptions {
+    /** Digits in the code. Default 6. */
+    codeLength?: number;
+    /** True when the server already holds this value as verified, such as
+     *  a page that reopens after a refused post. */
+    verified?: boolean;
+    /**
+     * With `verified`: the person may still change the value. The field
+     * shows as verified with a "Change" action; pressing it unlocks the
+     * field. Typing back exactly the value that started verified (trimmed,
+     * case ignored) is verified again with no code; any other value needs
+     * a code. Without it, `verified` locks the field with no way back.
+     * A plain boolean, so it works from JSON.
+     */
+    allowChange?: boolean;
+    /** Called with `true` once the code is right. */
+    onVerifiedChange?: (verified: boolean) => void;
+}
+/** Callbacks: for a React host that calls its own API. */
+export interface RegistrationFieldVerificationCallbacks extends RegistrationFieldVerificationOptions {
+    /** Sends a code to the value. Resolve, never reject: a rejection is
+     *  shown as a failure with reason `error`. */
+    onSendCode: (value: string) => Promise<RegistrationCodeResult>;
+    /** Checks the code the person typed for the value. */
+    onVerifyCode: (value: string, code: string) => Promise<RegistrationCodeResult>;
+    sendUrl?: never;
+    verifyUrl?: never;
+}
+/**
+ * URLs: data only, for a host that mounts the form from JSON. The kit
+ * POSTs JSON to each (same origin, cookies sent). Send body:
+ * `{ "value" }`. Verify body: `{ "value", "code" }`. The answer is a
+ * `RegistrationCodeResult` as JSON, on success and on failure. A path or
+ * an address on this site only.
+ */
+export interface RegistrationFieldVerificationUrls extends RegistrationFieldVerificationOptions {
+    sendUrl: string;
+    verifyUrl: string;
+    onSendCode?: never;
+    onVerifyCode?: never;
+}
+/** How one field is verified: both callbacks, or both URLs. */
+export type RegistrationFieldVerification = RegistrationFieldVerificationCallbacks | RegistrationFieldVerificationUrls;
+export type ContactVerificationStatus = 'idle' | 'sending' | 'sent' | 'verifying' | 'verified';
+export interface ContactVerificationFailure {
+    reason: RegistrationCodeFailure;
+    /** The host's own message, when it gave one. */
+    message?: string;
+}
+export declare const DEFAULT_CODE_LENGTH = 6;
+export declare const DEFAULT_RESEND_SECONDS = 30;
+export interface UseContactVerificationOptions {
+    /** Undefined: the field is not verified and the hook does nothing. */
+    config: RegistrationFieldVerification | undefined;
+    /** The value now in the field. */
+    value: string;
+}
+export interface UseContactVerificationReturn {
+    /** True when the field takes part in verification. */
+    enabled: boolean;
+    status: ContactVerificationStatus;
+    /** True once the server has accepted the value. */
+    verified: boolean;
+    codeLength: number;
+    code: string;
+    setCode: (code: string) => void;
+    failure: ContactVerificationFailure | null;
+    /** Seconds left before a new code may be sent; 0 when it may. */
+    cooldown: number;
+    devCode: string | undefined;
+    /** The value the code went to. */
+    sentTo: string;
+    send: () => void;
+    verify: (code?: string) => void;
+    /** Back to idle: the person wants to change the value. */
+    reset: () => void;
+    /** True when the server's "verified" may be changed (`allowChange`)
+     *  and the field is verified right now. */
+    changeable: boolean;
+    /** Unlocks a `changeable` field so the value can be edited. */
+    unlock: () => void;
+}
+/** Runs one field's verification step. */
+export declare function useContactVerification({ config, value, }: UseContactVerificationOptions): UseContactVerificationReturn;
+//# sourceMappingURL=use-contact-verification.d.ts.map

package/dist/patterns/registration-form/use-contact-verification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-contact-verification.d.ts","sourceRoot":"","sources":["../../../src/patterns/registration-form/use-contact-verification.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,9 @@
+import type { RegistrationCodeResult, RegistrationFieldVerification } from './use-contact-verification';
+/** Posts JSON to a path or same-origin URL. Never rejects. */
+export declare function postVerification(url: string, payload: Record<string, string>): Promise<RegistrationCodeResult>;
+/** The two callbacks for a field, whichever way the host configured it. */
+export declare function verificationHandlers(config: RegistrationFieldVerification): {
+    onSendCode: (value: string) => Promise<RegistrationCodeResult>;
+    onVerifyCode: (value: string, code: string) => Promise<RegistrationCodeResult>;
+};
+//# sourceMappingURL=verification-requests.d.ts.map

package/dist/patterns/registration-form/verification-requests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-requests.d.ts","sourceRoot":"","sources":["../../../src/patterns/registration-form/verification-requests.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAEV,sBAAsB,EACtB,6BAA6B,EAC9B,MAAM,4BAA4B,CAAC;AA0CpC,8DAA8D;AAC9D,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,OAAO,CAAC,sBAAsB,CAAC,CAwDjC;AAED,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,6BAA6B,GAAG;IAC3E,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC/D,YAAY,EAAE,CACZ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,KACT,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACtC,CAkBA"}

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

@@ -0,0 +1,3 @@
+export { SendRegistrationLinkForm, SEND_REGISTRATION_LINK_FIELDS, } from './send-registration-link-form';
+export type { SendRegistrationLinkFormProps, SendRegistrationLinkField, SendRegistrationLinkFieldNames, SendRegistrationLinkValues, SendRegistrationLinkInitialValues, SendRegistrationLinkErrors, SendRegistrationLinkGuidance, SendRegistrationLinkSent, } from './send-registration-link-form';
+//# sourceMappingURL=index.d.ts.map

package/dist/patterns/send-registration-link-form/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/patterns/send-registration-link-form/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,6BAA6B,EAC7B,yBAAyB,EACzB,8BAA8B,EAC9B,0BAA0B,EAC1B,iCAAiC,EACjC,0BAA0B,EAC1B,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,+BAA+B,CAAC"}

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

@@ -0,0 +1,6 @@
+import { S as o, a as r } from "../../_chunks/send-registration-link-form-pO2bGjGa.js";
+export {
+  o as SEND_REGISTRATION_LINK_FIELDS,
+  r as SendRegistrationLinkForm
+};
+//# sourceMappingURL=index.js.map

package/dist/patterns/send-registration-link-form/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

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

@@ -0,0 +1,80 @@
+import { type HTMLAttributes } from 'react';
+/** The fields of the form, in the order they appear. */
+export declare const SEND_REGISTRATION_LINK_FIELDS: readonly ["email", "emailConfirm", "phone", "phoneConfirm", "allowLoginUntil"];
+export type SendRegistrationLinkField = (typeof SEND_REGISTRATION_LINK_FIELDS)[number];
+/** What `onSubmit` receives once every check has passed. */
+export interface SendRegistrationLinkValues {
+    email: string;
+    /** As typed. It matches `email` apart from case and outer spaces. */
+    emailConfirm: string;
+    /** In E.164 form, e.g. `+393331234567`. */
+    phone: string;
+    /** In E.164 form. Equal to `phone`. */
+    phoneConfirm: string;
+    /** `yyyy-MM-dd`. */
+    allowLoginUntil: string;
+}
+/** Values to show when the form opens, e.g. after a refused post.
+ *  `allowLoginUntil` is `yyyy-MM-dd`. */
+export type SendRegistrationLinkInitialValues = Partial<SendRegistrationLinkValues>;
+/** Messages from the server, already translated by the host: one per
+ *  field, plus `form` for a message about the whole form. */
+export type SendRegistrationLinkErrors = Partial<Record<SendRegistrationLinkField | 'form', string>>;
+/** The host's own form field names, e.g. `send_registration_link[email]`. */
+export type SendRegistrationLinkFieldNames = Partial<Record<SendRegistrationLinkField, string>>;
+/** Guidance for the person sending, in the host's own words. */
+export interface SendRegistrationLinkGuidance {
+    /** The notice's heading. Pass it translated. */
+    title: string;
+    /** One short point each. Pass them translated. Plain text. */
+    points: readonly string[];
+}
+/** The result of a send, shown instead of the form. */
+export interface SendRegistrationLinkSent {
+    /** The address the email went to. */
+    email: string;
+    /** The last day the link allows login, `yyyy-MM-dd`. */
+    allowLoginUntil: string;
+}
+export interface SendRegistrationLinkFormProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title' | 'onSubmit'> {
+    /** Replaces the heading "Send a registration link". Pass it translated. */
+    title?: string;
+    /** The heading's level. Default 2, for a page that has its own `h1`. */
+    headingLevel?: 1 | 2 | 3;
+    /** A warning-style notice above the form. The kit has no copy for it. */
+    guidance?: SendRegistrationLinkGuidance;
+    /** The first day that can be chosen, `yyyy-MM-dd`. Default: tomorrow. */
+    minDate?: string;
+    /** The last day that can be chosen, `yyyy-MM-dd`. Default: no limit.
+     *  Keep it equal to the server's. */
+    maxDate?: string;
+    /** Values to show when the form opens. Read once. */
+    initialValues?: SendRegistrationLinkInitialValues;
+    /** Messages from the server. Each shows on its field until the user
+     *  changes that field, and the form takes focus when they are present
+     *  at load. */
+    errors?: SendRegistrationLinkErrors;
+    /** Fields that refuse paste, so the user types them. Default: none.
+     *  Refusing a paste in `phoneConfirm` is silent: use it with care. */
+    blockPaste?: readonly ('email' | 'emailConfirm' | 'phoneConfirm')[];
+    /** Replaces the button's "Send registration link". Translated. */
+    submitLabel?: string;
+    /** True while a React host sends the values. */
+    submitting?: boolean;
+    /** Shows the result instead of the form. */
+    sent?: SendRegistrationLinkSent;
+    /** Where "Send another link" leads. Same-site path or full address. */
+    sendAnotherHref?: string;
+    /** For a native form post: the host's field names. When set, the
+     *  browser posts the form. */
+    fieldNames?: SendRegistrationLinkFieldNames;
+    /** Where the post goes. Default: the current address. Same site only. */
+    action?: string;
+    /** Extra hidden inputs for a native post, by name: the CSRF token. */
+    hiddenFields?: Readonly<Record<string, string>>;
+    /** For React hosts: called once every check has passed. Not called when
+     *  `fieldNames` is set. */
+    onSubmit?: (values: SendRegistrationLinkValues) => void;
+}
+export declare const SendRegistrationLinkForm: import("react").ForwardRefExoticComponent<SendRegistrationLinkFormProps & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=send-registration-link-form.d.ts.map

package/dist/patterns/send-registration-link-form/send-registration-link-form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-registration-link-form.d.ts","sourceRoot":"","sources":["../../../src/patterns/send-registration-link-form/send-registration-link-form.tsx"],"names":[],"mappings":"AAWA,OAAO,EAML,KAAK,cAAc,EACpB,MAAM,OAAO,CAAC;AAkCf,wDAAwD;AACxD,eAAO,MAAM,6BAA6B,gFAMhC,CAAC;AAEX,MAAM,MAAM,yBAAyB,GACnC,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjD,4DAA4D;AAC5D,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,YAAY,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;yCACyC;AACzC,MAAM,MAAM,iCAAiC,GAC3C,OAAO,CAAC,0BAA0B,CAAC,CAAC;AAEtC;6DAC6D;AAC7D,MAAM,MAAM,0BAA0B,GAAG,OAAO,CAC9C,MAAM,CAAC,yBAAyB,GAAG,MAAM,EAAE,MAAM,CAAC,CACnD,CAAC;AAEF,6EAA6E;AAC7E,MAAM,MAAM,8BAA8B,GAAG,OAAO,CAClD,MAAM,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAC1C,CAAC;AAEF,gEAAgE;AAChE,MAAM,WAAW,4BAA4B;IAC3C,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED,uDAAuD;AACvD,MAAM,WAAW,wBAAwB;IACvC,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,6BAA8B,SAAQ,IAAI,CACzD,cAAc,CAAC,cAAc,CAAC,EAC9B,OAAO,GAAG,UAAU,CACrB;IACC,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,4BAA4B,CAAC;IACxC,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;yCACqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,aAAa,CAAC,EAAE,iCAAiC,CAAC;IAClD;;mBAEe;IACf,MAAM,CAAC,EAAE,0BAA0B,CAAC;IACpC;0EACsE;IACtE,UAAU,CAAC,EAAE,SAAS,CAAC,OAAO,GAAG,cAAc,GAAG,cAAc,CAAC,EAAE,CAAC;IACpE,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,wBAAwB,CAAC;IAChC,uEAAuE;IACvE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;kCAC8B;IAC9B,UAAU,CAAC,EAAE,8BAA8B,CAAC;IAC5C,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD;+BAC2B;IAC3B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,0BAA0B,KAAK,IAAI,CAAC;CACzD;AA6BD,eAAO,MAAM,wBAAwB,0HAsgBpC,CAAC"}

package/dist/speech/aws-transcribe.d.ts

@@ -0,0 +1,65 @@
+/** What the host's server needs to sign the Transcribe URL. */
+export interface AwsTranscribeUrlRequest {
+    /** An Amazon Transcribe language code, such as `it-IT`. */
+    readonly languageCode: string;
+    readonly mediaEncoding: 'pcm';
+    /** Hz. One of 8000, 16000, 44100 or 48000, matching the audio sent. */
+    readonly sampleRate: number;
+}
+export interface AwsTranscribeDictationOptions {
+    /**
+     * Fetches a pre-signed `wss://transcribestreaming.<region>.amazonaws.com`
+     * URL for this request from the host's server. Honour `signal`: it aborts
+     * when the user stops before the stream opens.
+     */
+    getUrl: (request: AwsTranscribeUrlRequest, signal: AbortSignal) => Promise<string>;
+    /** The Transcribe language code, or a function read at each start. */
+    languageCode: string | (() => string);
+}
+/** The kit's dictation seam (`onDictate`). */
+export type DictationSession = (ctx: {
+    signal: AbortSignal;
+    onPartialTranscript: (text: string) => void;
+    onFinalTranscript: (text: string) => void;
+}) => Promise<void>;
+export type AwsTranscribeErrorCode = 
+/** The browser cannot capture audio or open the stream. */
+'unsupported'
+/** The user or the browser refused the microphone. */
+ | 'permission'
+/** The host could not sign a URL. */
+ | 'url'
+/** The WebSocket failed. */
+ | 'connection'
+/** Transcribe refused or stopped the stream. */
+ | 'service';
+export declare class AwsTranscribeError extends Error {
+    readonly code: AwsTranscribeErrorCode;
+    constructor(code: AwsTranscribeErrorCode, detail?: string);
+}
+/** `it` or `it-IT` → `it-IT`; null for a language this map does not cover. */
+export declare function awsLanguageCode(uiLanguage: string): string | null;
+/** The PCM rate to send for an audio context running at `contextRate`. */
+export declare function transmitSampleRate(contextRate: number): number;
+/** Linear resampling, enough for speech. */
+export declare function resample(input: Float32Array, fromRate: number, toRate: number): Float32Array;
+/** Float samples to little-endian 16-bit PCM. */
+export declare function toPcm16(input: Float32Array): Uint8Array;
+/** The results inside a TranscriptEvent payload. */
+export declare function transcriptResults(payload: unknown): {
+    text: string;
+    partial: boolean;
+}[];
+/** Whether this browser can run Transcribe dictation at all. */
+export declare function isAwsTranscribeSupported(): boolean;
+/**
+ * Dictation through Amazon Transcribe, for any of the kit's `onDictate` props.
+ *
+ * Each call is one session: it resolves when the stream ends (after the user
+ * stops and Transcribe has sent its last phrase) and rejects with an
+ * `AwsTranscribeError` when it cannot start or fails. Finished phrases arrive
+ * through `onFinalTranscript`, including one that completes just after the
+ * user stops; the phrase being spoken arrives through `onPartialTranscript`.
+ */
+export declare function createAwsTranscribeDictation(options: AwsTranscribeDictationOptions): DictationSession;
+//# sourceMappingURL=aws-transcribe.d.ts.map

package/dist/speech/aws-transcribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aws-transcribe.d.ts","sourceRoot":"","sources":["../../src/speech/aws-transcribe.ts"],"names":[],"mappings":"AAgBA,+DAA+D;AAC/D,MAAM,WAAW,uBAAuB;IACtC,2DAA2D;IAC3D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC;IAC9B,uEAAuE;IACvE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,6BAA6B;IAC5C;;;;OAIG;IACH,MAAM,EAAE,CACN,OAAO,EAAE,uBAAuB,EAChC,MAAM,EAAE,WAAW,KAChB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,sEAAsE;IACtE,YAAY,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;CACvC;AAED,8CAA8C;AAC9C,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE;IACnC,MAAM,EAAE,WAAW,CAAC;IACpB,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEpB,MAAM,MAAM,sBAAsB;AAChC,2DAA2D;AACzD,aAAa;AACf,sDAAsD;GACpD,YAAY;AACd,qCAAqC;GACnC,KAAK;AACP,4BAA4B;GAC1B,YAAY;AACd,gDAAgD;GAC9C,SAAS,CAAC;AAEd,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;gBAC1B,IAAI,EAAE,sBAAsB,EAAE,MAAM,CAAC,EAAE,MAAM;CAS1D;AAaD,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIjE;AAMD,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED,4CAA4C;AAC5C,wBAAgB,QAAQ,CACtB,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,YAAY,CAYd;AAED,iDAAiD;AACjD,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,UAAU,CAQvD;AAOD,oDAAoD;AACpD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,OAAO,GACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,EAAE,CAetC;AAaD,gEAAgE;AAChE,wBAAgB,wBAAwB,IAAI,OAAO,CAOlD;AAsED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,6BAA6B,GACrC,gBAAgB,CA6OlB"}

package/dist/speech/event-stream.d.ts

@@ -0,0 +1,13 @@
+/** CRC-32 (IEEE, as gzip), which event-stream uses for both checksums. */
+export declare function crc32(bytes: Uint8Array): number;
+export type EventHeaders = Readonly<Record<string, string>>;
+/** One event-stream message. */
+export declare function encodeMessage(headers: EventHeaders, payload: Uint8Array): Uint8Array;
+/** Reads one message. Throws on a truncated or corrupted frame. */
+export declare function decodeMessage(buffer: ArrayBuffer): {
+    headers: EventHeaders;
+    payload: Uint8Array;
+};
+/** An AudioEvent carrying 16-bit PCM. An empty one ends the stream. */
+export declare function audioEvent(pcm: Uint8Array): Uint8Array;
+//# sourceMappingURL=event-stream.d.ts.map

package/dist/speech/event-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-stream.d.ts","sourceRoot":"","sources":["../../src/speech/event-stream.ts"],"names":[],"mappings":"AAsBA,0EAA0E;AAC1E,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAM/C;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAoC5D,gCAAgC;AAChC,wBAAgB,aAAa,CAC3B,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,UAAU,GAClB,UAAU,CAYZ;AAED,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG;IAClD,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,UAAU,CAAC;CACrB,CAoCA;AAED,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,GAAG,EAAE,UAAU,GAAG,UAAU,CAStD"}