@alfadocs/ui-kit 1.39.0 → 1.41.0

package/dist/_chunks/{treatment-receipt-dUm99mdn.js → treatment-receipt-DU0OewqH.js}

@@ -3,7 +3,7 @@ import { forwardRef as R, useRef as j } from "react";
 import { c as g } from "./index-D2ZczOXr.js";
 import { useTranslation as L } from "react-i18next";
 import { B as f } from "./badge-BudgzTe_.js";
-import { M as u } from "./money-BY-HmKhZ.js";
+import { M as u } from "./money-BXLBIRVO.js";
 import { C as z, S as h } from "./skeleton-B1KTdJ4N.js";
 import { T as S } from "./tag-Ci3xJPcH.js";
 const v = "type-label ds:text-[color:var(--muted-foreground)]", x = g(
@@ -157,4 +157,4 @@ E.displayName = "TreatmentReceipt";
 export {
   E as T
 };
-//# sourceMappingURL=treatment-receipt-dUm99mdn.js.map
+//# sourceMappingURL=treatment-receipt-DU0OewqH.js.map

package/dist/_chunks/trending-up-C_luYBzS.js

@@ -0,0 +1,15 @@
+import { c as e } from "./createLucideIcon-DhHxpK9K.js";
+/**
+ * @license lucide-react v1.22.0 - ISC
+ *
+ * This source code is licensed under the ISC license.
+ * See the LICENSE file in the root directory of this source tree.
+ */
+const o = [
+  ["path", { d: "M16 7h6v6", key: "box55l" }],
+  ["path", { d: "m22 7-8.5 8.5-5-5L2 17", key: "1t1m79" }]
+], n = e("trending-up", o);
+export {
+  n as T
+};
+//# sourceMappingURL=trending-up-C_luYBzS.js.map

package/dist/_chunks/wand-sparkles-DAjKyhz7.js

@@ -0,0 +1,27 @@
+import { c as a } from "./createLucideIcon-DhHxpK9K.js";
+/**
+ * @license lucide-react v1.22.0 - ISC
+ *
+ * This source code is licensed under the ISC license.
+ * See the LICENSE file in the root directory of this source tree.
+ */
+const e = [
+  [
+    "path",
+    {
+      d: "m21.64 3.64-1.28-1.28a1.21 1.21 0 0 0-1.72 0L2.36 18.64a1.21 1.21 0 0 0 0 1.72l1.28 1.28a1.2 1.2 0 0 0 1.72 0L21.64 5.36a1.2 1.2 0 0 0 0-1.72",
+      key: "ul74o6"
+    }
+  ],
+  ["path", { d: "m14 7 3 3", key: "1r5n42" }],
+  ["path", { d: "M5 6v4", key: "ilb8ba" }],
+  ["path", { d: "M19 14v4", key: "blhpug" }],
+  ["path", { d: "M10 2v2", key: "7u0qdc" }],
+  ["path", { d: "M7 8H3", key: "zfb6yr" }],
+  ["path", { d: "M21 16h-4", key: "1cnmox" }],
+  ["path", { d: "M11 3H9", key: "1obp7u" }]
+], d = a("wand-sparkles", e);
+export {
+  d as W
+};
+//# sourceMappingURL=wand-sparkles-DAjKyhz7.js.map

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "1.39.0",
+  "packageVersion": "1.41.0",
   "components": [
     {
       "kind": "component",
@@ -18564,6 +18564,92 @@
         }
       ]
     },
+    {
+      "kind": "pattern",
+      "id": "help-me-write-templates",
+      "composes": [
+        {
+          "component": "rich-text-editor",
+          "as": "editor"
+        },
+        {
+          "component": "editor-overlay",
+          "as": "assistantBar"
+        },
+        {
+          "component": "text-area",
+          "as": "prompt"
+        },
+        {
+          "component": "dropdown-menu",
+          "as": "templatesMenu",
+          "entity": "template"
+        },
+        {
+          "component": "dialog",
+          "as": "templateManager",
+          "entity": "template"
+        },
+        {
+          "component": "dialog",
+          "as": "deleteConfirmation",
+          "entity": "template"
+        },
+        {
+          "component": "alert",
+          "as": "creditsExhausted"
+        },
+        {
+          "component": "alert",
+          "as": "undoNotice"
+        }
+      ],
+      "workflows": [
+        {
+          "name": "run_template",
+          "safety": "phi",
+          "description": "Open the Alia Writing Assistant from the editor's AI pill, open the Templates menu (default template first) and pick a template. It rewrites the selected text, or the whole note when nothing is selected; the draft shows beside the note. Replace swaps the source for the draft, Insert below keeps it and adds the draft after it; the notice that follows offers Undo. Any text typed in the prompt first goes along as extra instructions. Out of AI credits shows a notice instead of a draft.",
+          "descriptionKey": "ui.agent.helpMeWriteTemplates.workflows.runTemplate",
+          "uiActions": [
+            "dropdown-menu.open",
+            "dropdown-menu.close"
+          ],
+          "stateReads": [
+            "dropdown-menu.isOpen"
+          ],
+          "apiActions": [
+            "aiTemplate.generate"
+          ]
+        },
+        {
+          "name": "free_prompt",
+          "safety": "phi",
+          "description": "Type (or dictate with the bar mic) what to write and press Write; the draft is inserted at the caret on Insert.",
+          "descriptionKey": "ui.agent.helpMeWriteTemplates.workflows.freePrompt",
+          "uiActions": [],
+          "apiActions": [
+            "aiTemplate.generate"
+          ]
+        },
+        {
+          "name": "manage_templates",
+          "safety": "write",
+          "description": "Open Manage templates from the Templates menu: list the practice's templates, create or edit one (name, optional short description, instructions for the AI, use as default; names are unique) and delete one after a confirmation. Shown only when the host allows managing.",
+          "descriptionKey": "ui.agent.helpMeWriteTemplates.workflows.manageTemplates",
+          "uiActions": [
+            "dialog.close",
+            "dialog.dismiss"
+          ],
+          "stateReads": [
+            "dialog.isOpen"
+          ],
+          "apiActions": [
+            "aiTemplate.save",
+            "aiTemplate.delete"
+          ]
+        }
+      ]
+    },
     {
       "kind": "pattern",
       "id": "invoices",

package/dist/agent-i18n/en.json

@@ -1741,6 +1741,13 @@
         "reviewEfficiency": "Read the Studio efficiency gauge and open the settings checklist to complete the remaining configuration steps."
       }
     },
+    "helpMeWriteTemplates": {
+      "workflows": {
+        "runTemplate": "Open the Alia Writing Assistant from the editor's AI pill, open the Templates menu (default template first) and pick a template. It rewrites the selected text, or the whole note when nothing is selected; the draft shows beside the note. Replace swaps the source for the draft, Insert below keeps it and adds the draft after it; the notice that follows offers Undo. Any text typed in the prompt first goes along as extra instructions. Out of AI credits shows a notice instead of a draft.",
+        "freePrompt": "Type (or dictate with the bar mic) what to write and press Write; the draft is inserted at the caret on Insert.",
+        "manageTemplates": "Open Manage templates from the Templates menu: list the practice's templates, create or edit one (name, optional short description, instructions for the AI, use as default; names are unique) and delete one after a confirmation. Shown only when the host allows managing."
+      }
+    },
     "invoices": {
       "workflows": {
         "filterInvoices": "Narrow the ledger by number, relation, status, date range or amount using the per-column filters.",

package/dist/components/_shared/format-price.d.ts

@@ -18,6 +18,12 @@
  * behaviour differs.
  */
 export declare function formatPrice(minorUnits: number, currency: string, locale: string): string;
+/**
+ * A first-visit price caption: `0` means the visit is free, so it reads as
+ * the caller's translated word ("Free" / "Gratuito"), never as "€0.00".
+ * Any other amount goes through {@link formatPrice} unchanged.
+ */
+export declare function formatPriceOrFree(minorUnits: number, currency: string, locale: string, freeLabel: string): string;
 /**
  * The same amount as {@link formatPrice}, but broken into its typed parts so
  * a renderer can treat the fraction differently from the rest.

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

@@ -8,7 +8,7 @@ export { computeDueDate, trimesterForWeeks, gestationalMilestones, trimesterHigh
 export { computeAntenatalSchedule, type AntenatalEvent, type ResolvedAntenatalEvent, type AntenatalScheduleOptions, type AntenatalCategory, type AntenatalStatus, type AntenatalCondition, type ScheduleLocale, type GdmRisk, } from './antenatal-schedule';
 export { AntenatalScheduleTimeline, type AntenatalScheduleTimelineProps, } from './antenatal-schedule-timeline';
 export { InsertButton, buildResultText, buildResultHtml, buildResultCardSvg, svgCardToPngDataUri, svgCardToPng, type InsertButtonProps, type InsertVariant, type InsertPayload, type InsertPngResult, type InsertMode, type InsertCardData, type InsertCardField, type InsertCardGauge, type SvgCardToPngOptions, } from './insert-result';
-export { formatPrice } from './format-price';
+export { formatPrice, formatPriceOrFree } from './format-price';
 export { normalizeDiacritics } from './normalize-diacritics';
 export { useDebouncedCallback } from './use-debounced-callback';
 export { useFocusTrap, type UseFocusTrapOptions } from './use-focus-trap';

package/dist/components/ai-consent-banner/ai-consent-banner.d.ts

@@ -4,6 +4,8 @@ declare const rootVariants: (props?: ({
     state?: "required" | "pending" | "granted" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export type AiConsentState = NonNullable<VariantProps<typeof rootVariants>['state']>;
+/** Heading levels `AiConsentBanner.headingLevel` accepts. */
+export type AiConsentBannerHeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
 /** Agent-readiness curated handle. Exposes the structural consent state only. */
 export interface AiConsentBannerHandle {
     /** Current derived state: 'granted' | 'required' | 'pending'. */
@@ -37,6 +39,13 @@ export interface AiConsentBannerProps extends Omit<ComponentPropsWithoutRef<'div
     pending?: boolean;
     /** Fired when the operator confirms the consent grant. */
     onGrantConsent?: () => void;
+    /**
+     * Heading level for the banner's own title, so it can be nested under a
+     * host section's heading without skipping levels (axe `heading-order`).
+     * Additive: default `5` matches the banner's original, unconditional
+     * `<h5>` — every existing consumer is unaffected.
+     */
+    headingLevel?: AiConsentBannerHeadingLevel;
     /** Override the region's accessible name. */
     'aria-label'?: string;
 }

package/dist/components/ai-consent-banner/index.d.ts

@@ -1,4 +1,4 @@
 export { AiConsentBanner } from './ai-consent-banner';
-export type { AiConsentBannerProps, AiConsentBannerHandle, AiConsentState, } from './ai-consent-banner';
+export type { AiConsentBannerProps, AiConsentBannerHandle, AiConsentState, AiConsentBannerHeadingLevel, } from './ai-consent-banner';
 export { aiConsentBannerAgent } from './ai-consent-banner.agent';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/ai-consent-banner/index.js

@@ -1,4 +1,4 @@
-import { A as e, a as o } from "../../_chunks/ai-consent-banner-DvtaM3yg.js";
+import { A as e, a as o } from "../../_chunks/ai-consent-banner-D7I2U-cz.js";
 export {
   e as AiConsentBanner,
   o as aiConsentBannerAgent

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

@@ -159,6 +159,12 @@ export interface BookingProps extends Omit<ComponentPropsWithoutRef<'div'>, 'ari
     allowOperatorSelection?: boolean;
     /** Pins step 4 to this operator. */
     lockedOperatorId?: string;
+    /**
+     * Default: false. When true, the operators offered for a service are the
+     * ones linked to that service, even when specialties are on. The specialty
+     * only groups services.
+     */
+    operatorsByService?: boolean;
     specialties?: BookingSpecialty[];
     services: BookingService[];
     operators?: BookingOperator[];

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

@@ -15,6 +15,12 @@ export interface CascadePolicy {
     lockedOperatorId?: string;
     /** Defaults to `false`. When true, single-service lists auto-pre-fill. */
     autoSelectSingleService?: boolean;
+    /**
+     * Defaults to `false`. When true, the operators offered come from the
+     * chosen service (`appointmentBookingReasonIds`) even when specialties are
+     * on; the specialty only groups services. Added in 1.40.0.
+     */
+    operatorsByService?: boolean;
 }
 export interface CascadeInputs extends CascadePolicy {
     specialties: BookingSpecialty[];

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-Dn3jvv3K.js";
+import { B as A, C as R, O as a, b as s } from "../../_chunks/booking-D43ASl8y.js";
 export {
   A as Booking,
   R as CONFIRMATION_CHANNEL_ORDER,

package/dist/components/contact-profile-card/contact-profile-card.d.ts

@@ -93,8 +93,8 @@ export interface ContactProfileCardProps extends Omit<ComponentPropsWithoutRef<'
     insurances?: string[];
     /**
      * First-visit price in the smallest currency unit (cents / centesimi).
-     * Formatted via `Intl.NumberFormat`. Omit when the consumer doesn't
-     * want to show the price.
+     * Formatted via `Intl.NumberFormat`; `0` renders the translated word
+     * "Free". Omit when the consumer doesn't want to show the price.
      */
     firstVisitPriceCents?: number;
     /** ISO-4217 currency code for the price formatter. Defaults to `EUR`. */

package/dist/components/contact-profile-card/index.js

@@ -1,4 +1,4 @@
-import { C as _, a as O, b as o, c as r } from "../../_chunks/contact-profile-card-Zt6WNg1u.js";
+import { C as _, a as O, b as o, c as r } from "../../_chunks/contact-profile-card-C0WpwpVV.js";
 export {
   _ as CONTACT_PROFILE_CARD_ROW_ICONS,
   O as CONTACT_PROFILE_CARD_ROW_KEYS,

package/dist/components/editor-overlay/index.js

@@ -1,4 +1,4 @@
-import { E as a } from "../../_chunks/editor-overlay-9tcPXNWt.js";
+import { E as a } from "../../_chunks/editor-overlay-DwNKaI22.js";
 export {
   a as EditorOverlay
 };

package/dist/components/index.d.ts

@@ -215,6 +215,7 @@ export * from './workflow';
 export * from '../patterns/alia-assistant';
 export * from '../patterns/anamnesis';
 export * from '../patterns/calendar';
+export * from '../patterns/help-me-write-templates';
 export * from '../patterns/marketplace-app-shell';
 export * from '../patterns/payment-automation-upsell';
 export * from '../patterns/signature-request';

package/dist/components/money/index.js

@@ -1,4 +1,4 @@
-import { M as m } from "../../_chunks/money-BY-HmKhZ.js";
+import { M as m } from "../../_chunks/money-BXLBIRVO.js";
 import { m as n } from "../../_chunks/money.agent-BjJ6gOkx.js";
 export {
   m as Money,

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

@@ -1,3 +1,4 @@
 export { NotesPanel } from './notes-panel';
 export type { NotesPanelProps, NotesPanelNote, NotesPanelNoteActions, NotesPanelSubmission, } from './notes-panel';
+export type { AiConsentGate } from '../rich-text-editor';
 //# sourceMappingURL=index.d.ts.map

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

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

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

@@ -1,6 +1,6 @@
 import { type HTMLAttributes, type ReactNode } from 'react';
 import type { ClinicalNoteCardProps } from '../clinical-note-card';
-import type { RichTextEditorProps, RichTextEditorToolbar, RedactorFactory } from '../rich-text-editor';
+import type { RichTextEditorProps, RichTextEditorToolbar, RedactorFactory, AiConsentGate } from '../rich-text-editor';
 /**
  * One note in the panel — the data subset of `ClinicalNoteCard`.
  *
@@ -138,6 +138,13 @@ export interface NotesPanelProps extends Omit<HTMLAttributes<HTMLElement>, 'titl
     onDictate?: RichTextEditorProps['onDictate'];
     onProofread?: RichTextEditorProps['onProofread'];
     onAutoFormat?: RichTextEditorProps['onAutoFormat'];
+    /**
+     * Patient AI-consent gate for Help-me-write + both mics, forwarded
+     * straight to the rich composer. See `AiConsentGate`. Omit for today's
+     * ungated behaviour. Ignored by the `'plain'` composer (it offers
+     * neither affordance).
+     */
+    aiConsent?: AiConsentGate;
     /** Toggle a note's pinned state — renders an inline pin button per note. */
     onTogglePin?: (id: string) => void;
     /** Toggle a note's flagged state — renders an inline flag button per note. */

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

@@ -1,4 +1,4 @@
-import { P as o } from "../../_chunks/panel-subview-Cc2Wtt7D.js";
+import { P as o } from "../../_chunks/panel-subview-PMBRPFOa.js";
 import { p as r } from "../../_chunks/panel-subview.agent-BIBvE-IW.js";
 export {
   o as PanelSubview,

package/dist/components/practice-results/index.js

@@ -1,4 +1,4 @@
-import { P as t, p as a } from "../../_chunks/practice-results-D_jjzwgf.js";
+import { P as t, p as a } from "../../_chunks/practice-results-D11Zpt27.js";
 export {
   t as PracticeResults,
   a as practiceResultsAgent

package/dist/components/practice-results/practice-results.d.ts

@@ -85,7 +85,8 @@ export interface PracticeResult {
      * `ContactProfileCard.firstVisitPriceCents` — the KIT formats, the
      * consumer never hands over a pre-rendered string.
      *
-     * `0` is a real value meaning "free" and renders as such. Omit the
+     * `0` is a real value meaning "free" and renders the translated word
+     * "Free" (`common.freeOfCharge`), never a zero amount. Omit the
      * field (or pass `undefined`) when the practice has not set a price —
      * the row then disappears completely. Added for HTP-6136.
      */

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

@@ -1,4 +1,5 @@
 import { type RefObject } from 'react';
+import type { RichTextEditorVariable } from './rich-text-editor';
 export type EditorToolbarPreset = 'minimal' | 'standard' | 'full';
 export interface EditorToolbarProps {
     /** Dispatch a Redactor command (and refresh active state). */
@@ -30,6 +31,10 @@ export interface EditorToolbarProps {
      * wired to a menu.
      */
     showExtensions?: boolean;
+    /** Template variables for the "Insert variable" menu (hidden when empty). */
+    variables?: RichTextEditorVariable[];
+    /** Insert a variable chip at the saved caret. */
+    insertVariable?: (token: string) => void;
 }
 export interface TableFloatingToolbarProps {
     active: ReadonlySet<string>;
@@ -63,5 +68,5 @@ export interface ImageFloatingToolbarProps {
     setImageWidth: (pct: number) => void;
 }
 export declare function ImageFloatingToolbar({ areaRef, activeImageEl: img, applyImageClass, setImageWidth, }: ImageFloatingToolbarProps): React.JSX.Element | null;
-export declare function EditorToolbar({ run, active, preset, insertHtml, insertTable, saveSelection, restoreSelection, getSelectedText, uploadImage, enableColor, enableImage, enableTable, showExtensions, }: EditorToolbarProps): React.JSX.Element;
+export declare function EditorToolbar({ run, active, preset, insertHtml, insertTable, saveSelection, restoreSelection, getSelectedText, uploadImage, enableColor, enableImage, enableTable, showExtensions, variables, insertVariable, }: EditorToolbarProps): React.JSX.Element;
 //# sourceMappingURL=editor-toolbar.d.ts.map

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

@@ -1,4 +1,4 @@
 export { RichTextEditor, wrapperVariants } from './rich-text-editor';
-export type { RichTextEditorHandle, RichTextEditorProps, RichTextEditorToolbar, RedactorFactory, } from './rich-text-editor';
+export type { RichTextEditorHandle, RichTextEditorProps, RichTextEditorToolbar, RedactorFactory, AiConsentGate, RichTextEditorVariable, HelpMeWriteRenderContext, } from './rich-text-editor';
 export { richTextEditorAgent } from './rich-text-editor.agent';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,4 +1,4 @@
-import { R as a, r as e, w as i } from "../../_chunks/rich-text-editor-C6fE-uP4.js";
+import { R as a, r as e, w as i } from "../../_chunks/rich-text-editor-D7AKKAQ2.js";
 export {
   a as RichTextEditor,
   e as richTextEditorAgent,

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

@@ -1,7 +1,76 @@
 import { type ReactNode } from 'react';
 import '../../tokens/themes/bridges/redactor-theme.css';
+import { type AiConsentBannerHeadingLevel } from '../ai-consent-banner';
 export type RedactorFactory = (selector: string | HTMLElement, command?: unknown, ...args: unknown[]) => unknown;
 export type RichTextEditorToolbar = 'minimal' | 'standard' | 'full';
+/**
+ * Patient AI-consent gate for the Help-me-write action and both dictation
+ * mics (the editor's own, and the one inside the Help-me-write overlay).
+ * Omit entirely for today's ungated behaviour — no existing host breaks.
+ *
+ * Present and `granted: false`: the affordances stay visible (this never
+ * hides a control), but opening one shows the kit's `AiConsentBanner` in
+ * the same docked slot instead of calling `onRequestAiDraft` / `onDictate`.
+ * When `granted` flips `true` the reader carries on without reopening
+ * anything — the editor resumes exactly the action it gated.
+ *
+ * Present and `granted: true`: normal behaviour, and the Help-me-write
+ * privacy notice records that consent was given.
+ */
+export interface AiConsentGate {
+    /** Whether AI consent has already been recorded for the current patient. */
+    granted: boolean;
+    /** When consent was granted — passed straight to `AiConsentBanner`. */
+    grantedAt?: string | number | Date;
+    /** Who granted consent — passed straight to `AiConsentBanner`. */
+    grantedBy?: string;
+    /** Whether the signed-in reader may grant consent. Default `true`; treated
+     *  as `false` when `onGrant` is absent, so no dead Grant control shows. */
+    canGrant?: boolean;
+    /** The grant is being persisted server-side (host-driven busy state). */
+    pending?: boolean;
+    /**
+     * Fired when the reader confirms the grant in the banner. A returned
+     * promise drives the banner's own pending/Spinner state until it settles,
+     * in addition to (or absent) a host-supplied `pending`.
+     */
+    onGrant?: () => void | Promise<void>;
+}
+/** A template variable the toolbar's "Insert variable" menu offers. */
+export interface RichTextEditorVariable {
+    /** Inserted as `[[token]]`. Letters, digits and underscores only. */
+    token: string;
+    /** Human label shown in the menu (translated by the host). */
+    label: string;
+    /** Optional second line in the menu. */
+    description?: string;
+}
+/** What a host's own Help-me-write surface gets from `renderHelpMeWrite`. */
+export interface HelpMeWriteRenderContext {
+    /** Whether the surface should show (consent is already granted). */
+    open: boolean;
+    onClose: () => void;
+    /** Text of the selection when the reader opened it; '' for a caret. */
+    selectionText: string;
+    getHTML: () => string;
+    getText: () => string;
+    /** Insert at the saved caret, replacing the saved selection if any. */
+    insertAtSelection: (html: string) => void;
+    /** Insert just after the saved selection (or at the saved caret). */
+    insertAfterSelection: (html: string) => void;
+    /** Replace the whole document. */
+    setContent: (html: string) => void;
+    /** The editor's own dictation seam, for a mic inside the surface. */
+    onDictate?: RichTextEditorProps['onDictate'];
+    /** The kit's privacy notice, including the consent-recorded line. */
+    privacyNotice: ReactNode;
+    /**
+     * Opened because dictation ran out of AI credits (its `onDictate` rejected
+     * with an error named `AiCreditsExhaustedError`): show the out-of-credits
+     * state rather than the prompt.
+     */
+    creditsExhausted: boolean;
+}
 export interface RichTextEditorProps {
     /** Opaque instance id — emitted as `data-component-id` for the agent registry. */
     id?: string;
@@ -38,6 +107,12 @@ export interface RichTextEditorProps {
     lang?: string;
     /** Consumer image-upload endpoint → Redactor `imageUpload`. Omitted if absent. */
     imageUploadUrl?: string;
+    /**
+     * Upload an image yourself (your own API client, auth or storage) and
+     * resolve its URL. Wins over `imageUploadUrl` for the toolbar's image
+     * dialog; either one shows the insert-image control.
+     */
+    onUploadImage?: (file: File, signal?: AbortSignal) => Promise<string>;
     /** App keyboard-shortcut seam (e.g. Ctrl/Cmd+Enter to save). */
     onKeyDown?: (event: KeyboardEvent) => void;
     /**
@@ -54,6 +129,20 @@ export interface RichTextEditorProps {
     aiDraftFormat?: 'html' | 'text';
     /** Override the compliance notice shown in the Help-me-write dialog. */
     aiPrivacyNotice?: ReactNode;
+    /**
+     * Patient AI-consent gate for Help-me-write + both mics. See
+     * `AiConsentGate`. Omit for today's ungated behaviour.
+     */
+    aiConsent?: AiConsentGate;
+    /**
+     * Heading level for the `AiConsentBanner` shown while the gate is open —
+     * forwarded straight to its own `headingLevel` so it nests correctly under
+     * whatever heading the host has above this editor (axe `heading-order`).
+     * Default `5` (the banner's own default) suits a standalone editor with no
+     * heading directly above it; a host wrapping the editor under its own
+     * heading (e.g. `NotesPanel`'s `h2`) should pass one level below it.
+     */
+    aiConsentHeadingLevel?: AiConsentBannerHeadingLevel;
     /**
      * Voice dictation. When provided, a DS mic toggle + live-transcript region
      * appear. The kit owns the UI; the consumer runs mic capture + transcription
@@ -82,6 +171,39 @@ export interface RichTextEditorProps {
         html: string;
         signal: AbortSignal;
     }) => Promise<string>;
+    /**
+     * Template variables. When provided, the toolbar gains an "Insert variable"
+     * menu that inserts `[[TOKEN]]` as a chip (Redactor's native `variable`
+     * component, the same markup as platform's plugin). Bare `[[TOKEN]]` text
+     * for these tokens in inbound content renders as a chip too.
+     */
+    variables?: RichTextEditorVariable[];
+    /**
+     * Decide whether a `[[TOKEN]]` is valid. Default: it is one of `variables`
+     * (any letter case). Invalid tokens render as error chips with a message
+     * under the editor, and are reported through `onVariableValidityChange`.
+     */
+    validateVariable?: (token: string) => boolean;
+    /**
+     * The invalid `[[TOKEN]]`s in the document, each once, whenever that set
+     * changes (`[]` when all are valid). Use it to block saving.
+     */
+    onVariableValidityChange?: (invalidTokens: string[]) => void;
+    /**
+     * Bring your own Help-me-write surface (e.g. with practice templates). The
+     * kit keeps the FAB segment, the consent gate and resume-after-grant, and
+     * calls this instead of rendering its own overlay. Render an
+     * `EditorOverlay` from it to dock in the same slot. Wins over the built-in
+     * overlay when both this and `onRequestAiDraft` are set.
+     */
+    renderHelpMeWrite?: (ctx: HelpMeWriteRenderContext) => ReactNode;
+    /**
+     * An AI call ran out of credits: `onDictate` rejected with an error named
+     * `AiCreditsExhaustedError`. With `renderHelpMeWrite` the kit also opens
+     * that surface on its out-of-credits state; without it, the dictation
+     * error line shows.
+     */
+    onAiCreditsExhausted?: () => void;
 }
 /** Block/inline formats the editor can toggle via `applyFormat`. */
 export type EditorFormat = 'bold' | 'italic' | 'strikethrough' | 'bulletedList' | 'numberedList' | 'heading' | 'quote' | 'paragraph';

package/dist/components/sidebar/index.js

@@ -1,4 +1,4 @@
-import { S as r, a as i, b as s, c as d, d as S, e as b, f as t, g as o, h as m, i as n, j as p, k as l, l as c, m as g, n as u, o as I, p as P, q as f, s as h, u as B } from "../../_chunks/sidebar-C-Gr2LL-.js";
+import { S as r, a as i, b as s, c as d, d as S, e as b, f as t, g as o, h as m, i as n, j as p, k as l, l as c, m as g, n as u, o as I, p as P, q as f, s as h, u as B } from "../../_chunks/sidebar-ClTY9lLI.js";
 import { u as k } from "../../_chunks/use-persistent-state-nZwZAnE9.js";
 export {
   r as Sidebar,

package/dist/components/treatment-receipt/index.js

@@ -1,4 +1,4 @@
-import { T as r } from "../../_chunks/treatment-receipt-dUm99mdn.js";
+import { T as r } from "../../_chunks/treatment-receipt-DU0OewqH.js";
 import { t as m } from "../../_chunks/treatment-receipt.agent-bpFm2RPH.js";
 export {
   r as TreatmentReceipt,

package/dist/host-compat.css

@@ -205,7 +205,7 @@
 
 /* ───────────────────────────────────────────────────────────────────────
    SECTION B — non-token declarations.  ORIGINAL LAYER PRESERVED.
-   139 declarations across 135 rules.
+   143 declarations across 139 rules.
 
    Kit-authored arbitrary-value utilities (`ds:w-[20rem]`) and the
    vendored AG Grid rules. These set real properties on real elements,
@@ -523,6 +523,9 @@
   .ds\:text-\[7rem\] {
     font-size:112px;
   }
+  .ds\:\[block-size\:14rem\] {
+    block-size:224px;
+  }
   .ds\:\[block-size\:44rem\] {
     block-size:704px;
   }
@@ -556,6 +559,12 @@
   .ds\:\[max-block-size\:12rem\] {
     max-block-size:192px;
   }
+  .ds\:\[max-block-size\:14rem\] {
+    max-block-size:224px;
+  }
+  .ds\:\[max-block-size\:16rem\] {
+    max-block-size:256px;
+  }
   .ds\:\[max-inline-size\:6\.5rem\] {
     max-inline-size:104px;
   }
@@ -580,6 +589,9 @@
   .ds\:\[max-inline-size\:48rem\] {
     max-inline-size:768px;
   }
+  .ds\:\[max-inline-size\:64rem\] {
+    max-inline-size:1024px;
+  }
   .ds\:\[min-block-size\:18rem\] {
     min-block-size:288px;
   }