@alfadocs/ui-kit 1.45.0 → 1.47.0

package/dist/components/booking/booking-types.d.ts

@@ -13,6 +13,48 @@ export interface BookingSpecialty {
     /** Restrict to operators-on-page when lockedOperatorId is set. */
     operatorIds?: string[];
 }
+/**
+ * One appointment payment, in currency minor units. Set it only when the
+ * platform AppointmentBookingReason.requireAdvancePayment is true.
+ */
+export interface BookingServicePayment {
+    /** No platform field: the consumer derives it, e.g. deposit when advanceAmount < price. */
+    kind: 'full' | 'deposit';
+    /** Platform advanceAmount (euros) x 100. NOT price, which only feeds priceLabel. */
+    amountCents: number;
+    /** Defaults to EUR, the only currency production charges. */
+    currencyCode?: string;
+}
+export interface BookingResolvedPayment extends BookingServicePayment {
+    serviceId: string;
+    currencyCode: string;
+}
+export interface BookingPaymentSession {
+    /** Opaque hold identity. Keep Stripe credentials in the consumer, keyed by this id. */
+    id: string;
+    payment: BookingResolvedPayment;
+}
+export interface BookingSubmitResult {
+    paymentSession: BookingPaymentSession;
+}
+export type BookingPaymentState = {
+    sessionId: string;
+    status: 'ready' | 'cancelled' | 'paid';
+} | {
+    sessionId: string;
+    status: 'processing';
+    phase: 'payment' | 'completion';
+} | {
+    sessionId: string;
+    status: 'failed';
+    phase: 'payment' | 'completion';
+    error?: ReactNode;
+};
+export interface BookingPaymentRenderContext {
+    session: BookingPaymentSession;
+    payment: BookingResolvedPayment;
+    state: BookingPaymentState;
+}
 export interface BookingService {
     id: string;
     label: string;
@@ -27,6 +69,8 @@ export interface BookingService {
      * string verbatim. Added in 1.6.0.
      */
     priceLabel?: string;
+    /** Mandatory online payment for this service only. Never inferred from priceLabel. */
+    payment?: BookingServicePayment;
     /** Required when useSpecialties is true. */
     specialtyId?: string;
     /** Operators who can perform this service. */
@@ -50,6 +94,8 @@ export interface BookingOperator {
 export interface BookingSlot {
     /** Opaque unique key within `availableSlots[date]`. */
     key: string;
+    /** Actual service booked when serviceIds contains several search alternatives. */
+    serviceId?: string;
     /** HH:mm 24h — used for display. */
     time: string;
     available: boolean;
@@ -70,6 +116,8 @@ export interface BookingDetails {
      * only when the service carries that text; omitted otherwise.
      */
     criticalInformationAccepted?: boolean;
+    /** Included only when the patient accepts this service's payment quote. */
+    paymentAccepted?: boolean;
     codiceFiscale?: string;
     dateOfBirth?: string;
     insuranceNumber?: string;
@@ -122,6 +170,7 @@ export interface BookingSubmitPayload {
     value: BookingValue;
     /** Fully populated + validated (privacy + terms ticked, required fields filled). */
     details: BookingDetails;
+    payment?: BookingResolvedPayment;
 }
 export interface BookingValidationResult {
     valid: boolean;
@@ -179,6 +228,16 @@ export interface BookingProps extends Omit<ComponentPropsWithoutRef<'div'>, 'ari
     showReturningPatientFlag?: boolean;
     privacyPolicyUrl?: string;
     termsUrl?: string;
+    paymentTermsUrl?: string;
+    /** Publish paid only after the server verifies payment AND saves the appointment. */
+    paymentState?: BookingPaymentState;
+    /** Render PaymentForm here. The consumer owns Stripe credentials and completion calls. */
+    renderPayment?: (context: BookingPaymentRenderContext) => ReactNode;
+    /**
+     * Completion retry only: never render card entry or start another payment here.
+     * Supply it with renderPayment; without it a failed completion shows only the error.
+     */
+    renderPaymentCompletion?: (context: BookingPaymentRenderContext) => ReactNode;
     validateCodiceFiscale?: BookingValidator;
     validateInsuranceNumber?: BookingValidator;
     /** Default: false. Specialty auto-select on length=1 is always on. */
@@ -198,7 +257,7 @@ export interface BookingProps extends Omit<ComponentPropsWithoutRef<'div'>, 'ari
     defaultConfirmationChannels?: ConfirmationChannel[];
     value: BookingValue;
     onChange: (next: BookingValue) => void;
-    onSubmit: (payload: BookingSubmitPayload) => void | Promise<void>;
+    onSubmit: (payload: BookingSubmitPayload) => void | BookingSubmitResult | Promise<void | BookingSubmitResult>;
     /**
      * Calendar/date-strip shimmer — set true while `availableDates` is being
      * fetched. When omitted, the kit falls back to `loadingSlots` for the

package/dist/components/booking/booking.d.ts

@@ -1,5 +1,5 @@
 import type { BookingProps } from './booking-types';
-export type { BookingDetails, BookingHandle, BookingOperator, BookingProps, BookingService, BookingSlot, BookingSpecialty, BookingSubmitPayload, BookingValidationResult, BookingValidator, BookingValue, BookingVariant, ConfirmationChannel, InsuranceType, } from './booking-types';
+export type { BookingPaymentSession, BookingPaymentState, BookingPaymentRenderContext, BookingSubmitResult, BookingServicePayment, BookingResolvedPayment, BookingDetails, BookingHandle, BookingOperator, BookingProps, BookingService, BookingSlot, BookingSpecialty, BookingSubmitPayload, BookingValidationResult, BookingValidator, BookingValue, BookingVariant, ConfirmationChannel, InsuranceType, } from './booking-types';
 export { CONFIRMATION_CHANNEL_ORDER } from './booking-types';
 export { OPERATORS_ALL } from './cascade';
 export declare const Booking: import("react").ForwardRefExoticComponent<BookingProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/booking/details-form.d.ts

@@ -1,5 +1,5 @@
 import { type ReactNode } from 'react';
-import type { BookingDetails, BookingValidator, ConfirmationChannel } from './booking-types';
+import type { BookingDetails, BookingResolvedPayment, BookingValidator, ConfirmationChannel } from './booking-types';
 export interface BookingDetailsFormProps {
     value: Partial<BookingDetails>;
     onChange: (next: Partial<BookingDetails>) => void;
@@ -13,6 +13,10 @@ export interface BookingDetailsFormProps {
     showReturningPatientFlag?: boolean;
     privacyPolicyUrl?: string;
     termsUrl?: string;
+    payment?: BookingResolvedPayment;
+    paymentTermsUrl?: string;
+    /** Prevent submit when the selected service's payment cannot be resolved. */
+    paymentBlocked?: boolean;
     /**
      * The selected service's `criticalInformationToAccept`. When set (and not
      * blank), a "Before you book" block renders above the consents and the

package/dist/components/booking/index.d.ts

@@ -1,5 +1,5 @@
 export { Booking } from './booking';
-export type { BookingProps, BookingHandle, BookingVariant, BookingValue, BookingService, BookingSpecialty, BookingSlot, BookingOperator, BookingDetails, BookingSubmitPayload, BookingValidator, BookingValidationResult, ConfirmationChannel, InsuranceType, } from './booking';
+export type { BookingPaymentSession, BookingPaymentState, BookingPaymentRenderContext, BookingSubmitResult, BookingServicePayment, BookingResolvedPayment, BookingProps, BookingHandle, BookingVariant, BookingValue, BookingService, BookingSpecialty, BookingSlot, BookingOperator, BookingDetails, BookingSubmitPayload, BookingValidator, BookingValidationResult, ConfirmationChannel, InsuranceType, } from './booking';
 export { CONFIRMATION_CHANNEL_ORDER, OPERATORS_ALL } from './booking';
 export { bookingAgent } from './booking.agent';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/booking/index.js

@@ -1,4 +1,4 @@
-import { B as A, C as R, O as a, b as s } from "../../_chunks/booking-D43ASl8y.js";
+import { B as A, C as R, O as a, b as s } from "../../_chunks/booking-C4MwImkS.js";
 export {
   A as Booking,
   R as CONFIRMATION_CHANNEL_ORDER,

package/dist/components/booking/payment.d.ts

@@ -0,0 +1,9 @@
+import type { BookingResolvedPayment, BookingService, BookingSlot } from './booking-types';
+export declare function resolveServicePayment(service: BookingService): BookingResolvedPayment | undefined;
+/** Selected services are search alternatives, never a shopping basket. */
+export declare function resolveBookingPayment(services: BookingService[], serviceIds: string[], slot?: BookingSlot): {
+    payment?: BookingResolvedPayment;
+    blocked: boolean;
+};
+export declare function paymentIdentity(payment?: BookingResolvedPayment): string;
+//# sourceMappingURL=payment.d.ts.map

package/dist/components/booking/use-booking-payment.d.ts

@@ -0,0 +1,14 @@
+import type { BookingDetails, BookingPaymentSession, BookingProps, BookingSubmitPayload } from './booking-types';
+export declare function useBookingPayment({ services, value, availableSlots, onSubmit, onChange, paymentState, submitting, paymentTermsUrl, renderPayment, }: Pick<BookingProps, 'services' | 'value' | 'availableSlots' | 'onSubmit' | 'onChange' | 'paymentState' | 'submitting' | 'paymentTermsUrl' | 'renderPayment'>): {
+    payment: import("./booking-types").BookingResolvedPayment | undefined;
+    blocked: boolean;
+    state: import("./booking-types").BookingPaymentState | undefined;
+    activeSession: BookingPaymentSession | undefined;
+    submit: (details: BookingDetails) => Promise<void>;
+    reset: () => void;
+    status: "idle" | "submitting" | "payment" | "success" | "error";
+    snapshot?: BookingSubmitPayload;
+    session?: BookingPaymentSession;
+    cancelled?: boolean;
+};
+//# sourceMappingURL=use-booking-payment.d.ts.map

package/dist/components/button-group/index.js

@@ -1,4 +1,4 @@
-import { B as t } from "../../_chunks/button-group-R32U7SyV.js";
+import { B as t } from "../../_chunks/button-group-CA1tmu39.js";
 export {
   t as ButtonGroup
 };

package/dist/components/calendar/index.js

@@ -1,4 +1,4 @@
-import { C as r, c as l, r as n } from "../../_chunks/calendar-U6N0F99w.js";
+import { C as r, c as l, r as n } from "../../_chunks/calendar-OzSeTb4V.js";
 export {
   r as Calendar,
   l as calendarAgent,

package/dist/components/calendar-event-card/index.js

@@ -1,4 +1,4 @@
-import { C as e } from "../../_chunks/calendar-event-card-DKUnT9Be.js";
+import { C as e } from "../../_chunks/calendar-event-card-B6N5h1dO.js";
 export {
   e as CalendarEventCard
 };

package/dist/components/chart/index.js

@@ -1,4 +1,4 @@
-import { C as t, c as s, a as c } from "../../_chunks/chart-PF2krCZC.js";
+import { C as t, c as s, a as c } from "../../_chunks/chart-D8ucl8hH.js";
 export {
   t as Chart,
   s as chartAgent,

package/dist/components/data-table/index.js

@@ -1,7 +1,7 @@
-import { D as r, E as l, T as t, a as s, b as d, c as o, d as n, e as i, f as R, i as C, g as T } from "../../_chunks/data-table-CcAx_I1w.js";
-import { B as g, C as D, a as b, E as x, b as c, R as p, T as u, c as m, r as E, u as f } from "../../_chunks/editable-currency-cell-renderer-Psb6XKHR.js";
+import { D as r, E as l, T as t, a as s, b as d, c as o, d as n, e as i, f as R, i as C, g as T } from "../../_chunks/data-table-DnKOmEVw.js";
+import { B as g, C as D, a as b, E as x, b as c, R as p, T as u, c as m, r as E, u as f } from "../../_chunks/editable-currency-cell-renderer-OUkUv7U4.js";
 import { D as h, a as A, b as w, I as y, L as I, N as L, c as N, S as P, d as W, e as B, T as U, f as _, g as k, U as v } from "../../_chunks/link-cell-renderer-s3oHzOwi.js";
-import { A as X, a as j } from "../../_chunks/actions-cell-renderer-BXBy9c0f.js";
+import { A as X, a as j } from "../../_chunks/actions-cell-renderer-B5m9lwgC.js";
 export {
   X as ActionsCellRenderer,
   g as BalanceCellRenderer,

package/dist/components/face-scheme/index.js

@@ -1,4 +1,4 @@
-import { A as e, F as o, a as n, b as A, c as i, d as f, e as t, I, f as N, g as T, h as F, i as _, j as E, k as c, l as h, m as r, n as p, o as O, p as S, q as m, r as l, s as d, t as C, u as D } from "../../_chunks/face-scheme-Bm6pe7R8.js";
+import { A as e, F as o, a as n, b as A, c as i, d as f, e as t, I, f as N, g as T, h as F, i as _, j as E, k as c, l as h, m as r, n as p, o as O, p as S, q as m, r as l, s as d, t as C, u as D } from "../../_chunks/face-scheme-mIhwrQXt.js";
 export {
   e as ANNOTATION_TOOL_KIND,
   o as FACE_ANNOTATION_TOOLS,

package/dist/components/file-manager/index.js

@@ -1,4 +1,4 @@
-import { F as r, f } from "../../_chunks/file-manager-BfLQxF5t.js";
+import { F as r, f } from "../../_chunks/file-manager-DOcJGIx2.js";
 export {
   r as FileManager,
   f as fileManagerAgent

package/dist/components/freemium-paywall/index.js

@@ -1,4 +1,4 @@
-import { F as m, f as l } from "../../_chunks/freemium-paywall-Cz-O9lQD.js";
+import { F as m, f as l } from "../../_chunks/freemium-paywall-BaW5ODc9.js";
 export {
   m as FreemiumPaywall,
   l as freemiumPaywallAgent

package/dist/components/header-settings/index.js

@@ -1,4 +1,4 @@
-import { H as t } from "../../_chunks/header-settings-CTe45iDy.js";
+import { H as t } from "../../_chunks/header-settings-BEfx_-TF.js";
 export {
   t as HeaderSettings
 };

package/dist/components/hover-card/hover-card.d.ts

@@ -65,6 +65,10 @@ export interface HoverCardContentProps extends Omit<ComponentPropsWithoutRef<typ
 export interface HoverCardHeadingProps extends HTMLAttributes<HTMLHeadingElement> {
     as?: 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
 }
+export declare function useHoverCardTiming(): {
+    cancelClose: () => void;
+    closeWithDelay: () => void;
+};
 export declare const HoverCard: typeof HoverCardRoot & {
     Root: typeof HoverCardRoot;
     Trigger: import("react").ForwardRefExoticComponent<Omit<RadixPopover.PopoverTriggerProps & import("react").RefAttributes<HTMLButtonElement>, "ref"> & import("react").RefAttributes<HTMLButtonElement>>;

package/dist/components/hover-card/index.d.ts

@@ -1,4 +1,4 @@
-export { HoverCard } from './hover-card';
+export { HoverCard, useHoverCardTiming } from './hover-card';
 export type { HoverCardProps, HoverCardContentProps, HoverCardHeadingProps, HoverCardTriggerProps, HoverCardAnchorProps, HoverCardHandle, HoverCardSide, } from './hover-card';
 export { hoverCardAgent } from './hover-card.agent';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/hover-card/index.js

@@ -1,6 +1,7 @@
-import { H as e, h as o } from "../../_chunks/hover-card-BMJBVqIf.js";
+import { H as e, h as o, u as s } from "../../_chunks/hover-card-nUae8NPJ.js";
 export {
   e as HoverCard,
-  o as hoverCardAgent
+  o as hoverCardAgent,
+  s as useHoverCardTiming
 };
 //# sourceMappingURL=index.js.map

package/dist/components/icon-button-group/index.js

@@ -1,4 +1,4 @@
-import { I as t } from "../../_chunks/icon-button-group-DkkdIygu.js";
+import { I as t } from "../../_chunks/icon-button-group-DZKC6KGf.js";
 export {
   t as IconButtonGroup
 };

package/dist/components/index.d.ts

@@ -117,7 +117,8 @@ export * from './tabs';
 export * from './theme-toggle';
 export * from './agenda-card';
 export * from './agenda-tray';
-export * from './ai-consent-banner';
+export * from './ai-permission-notice';
+export * from './ai-credits-notice';
 export * from './alert';
 export * from './appointment-card';
 export * from './appointment-peek';

package/dist/components/notes-panel/index.js

@@ -1,4 +1,4 @@
-import { N as a } from "../../_chunks/notes-panel-Dkk9QPPX.js";
+import { N as a } from "../../_chunks/notes-panel-CHbDDMx8.js";
 export {
   a as NotesPanel
 };

package/dist/components/notes-panel/notes-panel.d.ts

@@ -169,6 +169,16 @@ export interface NotesPanelProps extends Omit<HTMLAttributes<HTMLElement>, 'titl
     onUploadImage?: RichTextEditorProps['onUploadImage'];
     /** An AI call ran out of credits. See `RichTextEditor`. */
     onAiCreditsExhausted?: RichTextEditorProps['onAiCreditsExhausted'];
+    /** Show the editor extensions affordance. See `RichTextEditor`. */
+    showExtensions?: RichTextEditorProps['showExtensions'];
+    extensions?: RichTextEditorProps['extensions'];
+    extensionContext?: RichTextEditorProps['extensionContext'];
+    onExtensionRun?: RichTextEditorProps['onExtensionRun'];
+    /**
+     * Shows the AI-credits/bundles hover card on every AI action trigger in
+     * the composer. See `RichTextEditor`.
+     */
+    aiCreditsNotice?: RichTextEditorProps['aiCreditsNotice'];
     /**
      * Rendered just above the composer — e.g. the Help-me-write templates
      * pattern's `undoNotice`. Renders in both add and edit mode, whenever the

package/dist/components/patient-details/index.js

@@ -1,4 +1,4 @@
-import { P as e, p as i } from "../../_chunks/patient-details-C8ImUrVg.js";
+import { P as e, p as i } from "../../_chunks/patient-details-yrgkSeEY.js";
 export {
   e as PatientDetails,
   i as patientDetailsAgent

package/dist/components/patient-summary-card/index.js

@@ -1,4 +1,4 @@
-import { P as t, p as m } from "../../_chunks/patient-summary-card-BhmKB2KR.js";
+import { P as t, p as m } from "../../_chunks/patient-summary-card-CmEFflGS.js";
 export {
   t as PatientSummaryCard,
   m as patientSummaryCardAgent

package/dist/components/patient-table/index.js

@@ -1,4 +1,4 @@
-import { B as s, C as l, N as n, P as t, a as C, T as i, b as o, g as T, u as p } from "../../_chunks/balance-badge-cell-o6LldMUA.js";
+import { B as s, C as l, N as n, P as t, a as C, T as i, b as o, g as T, u as p } from "../../_chunks/balance-badge-cell-YGrYdrvR.js";
 export {
   s as BalanceBadgeCell,
   l as CarePlanStatusCell,

package/dist/components/payment-form/index.d.ts

@@ -1,4 +1,4 @@
 export { PaymentForm, formatPaymentAmount, stripCardLikeDigits, stripeErrorCodeToI18nKey, paymentFormVariants, paymentSubmitButtonVariants, } from './payment-form';
-export type { PaymentFormProps, PaymentFormHandle, PaymentFormStatus, PaymentCurrency, } from './payment-form';
+export type { PaymentFormProps, PaymentFormHandle, PaymentFormStatus, PaymentFormIntentStatus, PaymentFormBillingDetails, PaymentCurrency, } from './payment-form';
 export { paymentFormAgent } from './payment-form.agent';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/payment-form/index.js

@@ -1,4 +1,4 @@
-import { P as r, f as s, p as m, a as e, s as n, b as o, c as i } from "../../_chunks/payment-form-BHMDqW9C.js";
+import { P as r, f as s, p as m, a as e, s as n, b as o, c as i } from "../../_chunks/payment-form-DqJFiplX.js";
 export {
   r as PaymentForm,
   s as formatPaymentAmount,

package/dist/components/payment-form/payment-form.d.ts

@@ -1,5 +1,19 @@
-import { type Stripe } from '@stripe/stripe-js';
+import type { Stripe } from '@stripe/stripe-js';
 export type PaymentCurrency = string;
+/** Stripe's known PaymentIntent states. Only `succeeded` means paid. */
+export type PaymentFormIntentStatus = 'requires_payment_method' | 'requires_confirmation' | 'requires_action' | 'processing' | 'requires_capture' | 'canceled' | 'succeeded';
+/** Complete invoicing address only. Never contains card details. */
+export interface PaymentFormBillingDetails {
+    name: string;
+    address: {
+        line1: string;
+        line2: string | null;
+        city: string;
+        state: string;
+        postalCode: string;
+        country: string;
+    };
+}
 export interface PaymentFormProps {
     /** Opaque instance id — emitted as `data-component-id` for the agent registry. */
     id?: string;
@@ -18,6 +32,8 @@ export interface PaymentFormProps {
      * own intent type wins). Defaults to `'payment'`.
      */
     mode?: 'payment' | 'setup';
+    /** Restrict deferred Elements to cards. With a client secret, the server intent controls methods. */
+    cardOnly?: boolean;
     /**
      * Deferred-confirm callback. Called at submit time (after client-side
      * field validation succeeds) so your server can mint a PaymentIntent and
@@ -27,14 +43,20 @@ export interface PaymentFormProps {
      * charge is attempted.
      */
     onCreatePaymentIntent?: () => Promise<string>;
+    /** Preview-only validation completed. Awaited without creating or confirming a payment. */
+    onPreviewValidated?: () => void | Promise<void>;
     /** Stripe publishable key (`pk_test_…` / `pk_live_…`). */
     publishableKey: string;
+    /** Connected account used to create the intent. Ignored by an injected Stripe instance. */
+    stripeAccount?: string;
     /** ISO-4217 currency code (e.g. 'EUR', 'USD', 'JPY'). */
     currency: PaymentCurrency;
     /** Amount in the currency's smallest unit (cents for EUR/USD, yen for JPY). */
     amount: number;
     /** Called with the PaymentIntent id on successful confirmation. */
     onSuccess?: (paymentIntentId: string) => void;
+    /** Observes confirmed intent states, including payments still awaiting completion. */
+    onPaymentStatusChange?: (status: PaymentFormIntentStatus, paymentIntentId: string) => void;
     /** Called with a sanitised error (no PAN digits, no Stripe English strings). */
     onError?: (error: {
         code: string;
@@ -42,6 +64,16 @@ export interface PaymentFormProps {
     }) => void;
     /** Show the billing-address collector below the payment fields. */
     billingAddress?: boolean;
+    /** Show and require a complete billing address before confirming payment. */
+    requireBillingAddress?: boolean;
+    /** Initial name/address for each Elements session. Does not enable or validate the collector. */
+    defaultBillingDetails?: PaymentFormBillingDetails;
+    /**
+     * Save complete billing details before confirmation or any redirect. Enables
+     * the address collector; rejection blocks payment and permits a retry.
+     * Not called in validation-only preview mode. Never logs or stores details.
+     */
+    onBillingDetails?: (details: PaymentFormBillingDetails) => void | Promise<void>;
     /** Locale override — defaults to the active i18next locale. */
     locale?: string;
     /** Accessible label for the form. */
@@ -72,12 +104,12 @@ export interface PaymentFormHandle {
      * `getStatus()` / `getErrorKey()` afterwards for the outcome.
      */
     submit: () => Promise<void>;
-    /** Reset the form to its initial state. */
+    /** Clear recoverable errors. A pending or paid attempt requires a new session. */
     reset: () => void;
     /** Lifecycle of the current attempt. */
     getStatus: () => PaymentFormStatus;
     /**
-     * True when Stripe reports the payment fields as complete. `submit`
+     * True when Stripe reports the payment fields, and any required billing address, as complete. `submit`
      * is refused (the button is disabled) while this is false outside
      * preview mode.
      */

package/dist/components/phone-input/index.js

@@ -1,4 +1,4 @@
-import { P as n, c as p, p as t, a as e } from "../../_chunks/phone-input-BsZIoE36.js";
+import { P as n, c as p, p as t, a as e } from "../../_chunks/phone-input-IWrGOCwm.js";
 export {
   n as PhoneInput,
   p as countryTriggerVariants,

package/dist/components/rich-text-editor/editor-extensions.d.ts

@@ -0,0 +1,54 @@
+import type { ReactNode } from 'react';
+import type { TFunction } from 'i18next';
+import type { InsertPayload } from '../_shared/insert-result';
+import type { HelpMeWriteRenderContext } from './rich-text-editor';
+export type EditorExtensionContext = 'note' | 'diagnosis' | 'document' | string;
+export interface EditorExtensionRenderContext {
+    html: string;
+    text: string;
+    selectionText: HelpMeWriteRenderContext['selectionText'];
+    scope: HelpMeWriteRenderContext['scope'];
+    /** Inserts at the captured selection, then closes. Image modes require an upload seam. */
+    insert: (payload: InsertPayload) => Promise<void>;
+    close: () => void;
+    signal: AbortSignal;
+}
+export type EditorExtensionRunContext = EditorExtensionRenderContext;
+/** Outcomes contain no editor content or host error messages. */
+export type EditorExtensionRunResult = {
+    status: 'success';
+} | {
+    status: 'error';
+} | {
+    status: 'aborted';
+};
+export interface EditorExtension {
+    id: string;
+    /** Translated host label, or a kit translation key. */
+    label: string;
+    description?: string;
+    icon?: ReactNode;
+    /** Absent means everywhere. Restricted entries require a matching editor context. */
+    contexts?: EditorExtensionContext[];
+    source?: {
+        kind: 'kit' | 'marketplace';
+        appName?: string;
+        appIconUrl?: string;
+    };
+    kind: 'panel' | 'action';
+    render?: (ctx: EditorExtensionRenderContext) => ReactNode;
+    run?: (ctx: EditorExtensionRunContext) => Promise<InsertPayload | null>;
+}
+/**
+ * Resolve an extension's `label` for display.
+ *
+ * `label` is either a kit translation key or a string the host has already
+ * translated, so it has to survive the round trip untouched when it is the
+ * latter. i18next reads `:` as its namespace separator and splits any key on
+ * it unless the key also carries a space, comma, `?`, `!` or `;` — so a host
+ * label like `ICD-10:lookup` came back as `lookup`, the prefix silently eaten
+ * (caught in review on #183). `nsSeparator: false` turns that parse off, and
+ * `defaultValue` returns the label verbatim when there is no key to look up.
+ */
+export declare function resolveExtensionLabel(t: TFunction, label: string): string;
+//# sourceMappingURL=editor-extensions.d.ts.map

package/dist/components/rich-text-editor/editor-toolbar.d.ts

@@ -31,6 +31,7 @@ export interface EditorToolbarProps {
      * wired to a menu.
      */
     showExtensions?: boolean;
+    extensionControl?: ReactNode;
     /** Template variables for the "Insert variable" menu (hidden when empty). */
     variables?: RichTextEditorVariable[];
     /** Most-recently-used tokens, most recent first — rendered as the menu's
@@ -100,5 +101,5 @@ export interface SelectionFloatingToolbarProps {
     children?: ReactNode;
 }
 export declare function SelectionFloatingToolbar({ active, run, areaRef, getEditorRoot, suppressed, holdOpen, children, }: SelectionFloatingToolbarProps): React.JSX.Element | null;
-export declare function EditorToolbar({ run, active, preset, insertHtml, insertTable, saveSelection, restoreSelection, getSelectedText, uploadImage, enableColor, enableImage, enableTable, showExtensions, variables, recentVariableTokens, insertVariable, }: EditorToolbarProps): React.JSX.Element;
+export declare function EditorToolbar({ run, active, preset, insertHtml, insertTable, saveSelection, restoreSelection, getSelectedText, uploadImage, enableColor, enableImage, enableTable, showExtensions, extensionControl, variables, recentVariableTokens, insertVariable, }: EditorToolbarProps): React.JSX.Element;
 //# sourceMappingURL=editor-toolbar.d.ts.map

package/dist/components/rich-text-editor/help-me-write-overlay.d.ts

@@ -21,5 +21,9 @@ export interface HelpMeWriteOverlayProps {
         onFinalTranscript: (text: string) => void;
     }) => Promise<void>;
 }
+/** Shared safe failure surface for requests made from the editor dock. */
+export declare function EditorRequestError({ id }: {
+    id?: string;
+}): React.JSX.Element;
 export declare function HelpMeWriteOverlay({ open, onClose, onRequestAiDraft, onInsert, previewAsHtml, privacyNotice, onDictate, }: HelpMeWriteOverlayProps): React.JSX.Element;
 //# sourceMappingURL=help-me-write-overlay.d.ts.map

package/dist/components/rich-text-editor/index.d.ts

@@ -1,4 +1,6 @@
 export { RichTextEditor, wrapperVariants } from './rich-text-editor';
 export type { RichTextEditorHandle, RichTextEditorProps, RichTextEditorToolbar, RedactorFactory, AiConsentGate, RichTextEditorVariable, HelpMeWriteRenderContext, RichTextEditorAiTemplate, RichTextEditorAiTemplates, RichTextEditorAiActionRequest, RichTextEditorAiApplied, } from './rich-text-editor';
 export { richTextEditorAgent } from './rich-text-editor.agent';
+export type { EditorExtension, EditorExtensionContext, EditorExtensionRenderContext, EditorExtensionRunContext, EditorExtensionRunResult, } from './editor-extensions';
+export { kitEditorExtensions } from './kit-extensions';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/rich-text-editor/index.js

@@ -1,7 +1,9 @@
-import { R as a, r as e, w as i } from "../../_chunks/rich-text-editor-BrAvNajV.js";
+import { R as i, r as o, w as a } from "../../_chunks/rich-text-editor-BwDV2XkZ.js";
+import { k as s } from "../../_chunks/kit-extensions-DuoFF1R3.js";
 export {
-  a as RichTextEditor,
-  e as richTextEditorAgent,
-  i as wrapperVariants
+  i as RichTextEditor,
+  s as kitEditorExtensions,
+  o as richTextEditorAgent,
+  a as wrapperVariants
 };
 //# sourceMappingURL=index.js.map

package/dist/components/rich-text-editor/kit-extensions.d.ts

@@ -0,0 +1,4 @@
+import type { EditorExtension } from './editor-extensions';
+/** Labels are resolved by the editor's useTranslation, including live locale changes. */
+export declare const kitEditorExtensions: EditorExtension[];
+//# sourceMappingURL=kit-extensions.d.ts.map

package/dist/components/rich-text-editor/rich-text-editor.d.ts

@@ -1,6 +1,8 @@
 import { type ReactNode } from 'react';
 import '../../tokens/themes/bridges/redactor-theme.css';
-import { type AiConsentBannerHeadingLevel } from '../ai-consent-banner';
+import { type AiConsentBannerHeadingLevel } from '../ai-permission-notice';
+import type { EditorExtension, EditorExtensionContext, EditorExtensionRunResult } from './editor-extensions';
+import { type AiCreditsNoticeProps } from '../ai-credits-notice';
 export type RedactorFactory = (selector: string | HTMLElement, command?: unknown, ...args: unknown[]) => unknown;
 export type RichTextEditorToolbar = 'minimal' | 'standard' | 'full';
 /**
@@ -149,8 +151,11 @@ export interface RichTextEditorProps {
     ariaLabel?: string;
     /** Size variant for the minimum block-size of the editing region. */
     minHeight?: 'sm' | 'md' | 'lg' | 'fill';
-    /** Show a right-aligned editor-extensions affordance (visual placeholder). */
+    /** @deprecated Pass extensions instead. Forces the disabled placeholder for one release. */
     showExtensions?: boolean;
+    extensions?: EditorExtension[];
+    extensionContext?: EditorExtensionContext;
+    onExtensionRun?: (id: string, result: EditorExtensionRunResult) => void;
     /** Extra class names on the wrapper. */
     className?: string;
     /** Inject the Redactor factory explicitly; else `window.$R` / `window.Redactor`. */
@@ -285,6 +290,17 @@ export interface RichTextEditorProps {
      * error line shows.
      */
     onAiCreditsExhausted?: () => void;
+    /**
+     * Shows an `AiCreditsNotice` hover card on every AI action trigger — the
+     * pill's segments (dictation, templates, proofread, auto-format,
+     * Help me write), the selection bubble's AI buttons, and both mics. Omit
+     * it for today's ungated behaviour: no card, no change. Present, it
+     * replaces any tooltip a wrapped trigger would otherwise show (one
+     * floating layer per trigger, never two) and never interferes with the
+     * consent gate — the button's own click still runs the action, or opens
+     * the gate, exactly as it does without this prop.
+     */
+    aiCreditsNotice?: AiCreditsNoticeProps;
 }
 /** Block/inline formats the editor can toggle via `applyFormat`. */
 export type EditorFormat = 'bold' | 'italic' | 'strikethrough' | 'bulletedList' | 'numberedList' | 'heading' | 'quote' | 'paragraph';

package/dist/components/stepper-accordion/index.js

@@ -1,4 +1,4 @@
-import { S as e } from "../../_chunks/stepper-accordion-DmVykr5F.js";
+import { S as e } from "../../_chunks/stepper-accordion-jMR8NaOB.js";
 import { s as t } from "../../_chunks/stepper-accordion.agent-cmEguIdx.js";
 export {
   e as StepperAccordion,

package/dist/components/tasks-panel/index.js

@@ -1,4 +1,4 @@
-import { T as e, t } from "../../_chunks/tasks-panel-CpcikOeY.js";
+import { T as e, t } from "../../_chunks/tasks-panel-DncuBPIZ.js";
 export {
   e as TasksPanel,
   t as tasksPanelAgent

package/dist/components/theme-toggle/index.js

@@ -1,4 +1,4 @@
-import { T as o, t } from "../../_chunks/theme-toggle-bI0pgDDv.js";
+import { T as o, t } from "../../_chunks/theme-toggle-BP0XRGMM.js";
 export {
   o as ThemeToggle,
   t as themeToggleAgent