@alfadocs/ui-kit 0.63.0 → 0.65.0

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-DJ9vnzrT.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-nXocS_MX.js";
 export {
   r as PaymentForm,
   s as formatPaymentAmount,

package/dist/components/pdf-viewer/index.js

@@ -1,4 +1,4 @@
-import { P as p, p as a } from "../../_chunks/pdf-viewer-chMpwpA4.js";
+import { P as p, p as a } from "../../_chunks/pdf-viewer-GsfNqeeT.js";
 export {
   p as PDFViewer,
   a as pdfViewerAgent

package/dist/components/periodontal-chart-card/index.js

@@ -1,4 +1,4 @@
-import { P as o, a as t, p as d } from "../../_chunks/periodontal-chart-card-BYs9hax1.js";
+import { P as o, a as t, p as d } from "../../_chunks/periodontal-chart-card-AYyHtU9K.js";
 export {
   o as PERIODONTAL_SITE_ORDER,
   t as PeriodontalChartCard,

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-DfZbPPvh.js";
+import { P as n, c as p, p as t, a as e } from "../../_chunks/phone-input-DVXhNlIl.js";
 export {
   n as PhoneInput,
   p as countryTriggerVariants,

package/dist/components/phone-input/phone-input.d.ts

@@ -36,6 +36,15 @@ export interface PhoneInputProps {
     readOnly?: boolean;
     placeholder?: string;
     popularCountries?: CountryCode[];
+    /**
+     * Restrict the country picker to this set (ISO 3166-1 alpha-2 codes), in
+     * the order given. Unsupported or duplicate codes are dropped; an empty /
+     * all-invalid list is ignored (every country stays selectable).
+     * `popularCountries` is intersected with this set. When the list resolves
+     * to a single country the picker collapses to a fixed, non-interactive
+     * dial code — only the national-number field stays editable.
+     */
+    allowedCountries?: CountryCode[];
     className?: string;
     id?: string;
     name?: string;

package/dist/components/popover/index.js

@@ -1,4 +1,4 @@
-import { P as e, p as r } from "../../_chunks/popover-Devce-tT.js";
+import { P as e, p as r } from "../../_chunks/popover-DTbfAuR0.js";
 export {
   e as Popover,
   r as popoverAgent

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

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

package/dist/components/pregnancy-dating/index.js

@@ -1,4 +1,4 @@
-import { P as r } from "../../_chunks/pregnancy-dating-Dg6dTe1p.js";
+import { P as r } from "../../_chunks/pregnancy-dating-BuzLTwjy.js";
 export {
   r as PregnancyDating
 };

package/dist/components/pregnancy-weight-gain/index.js

@@ -1,4 +1,4 @@
-import { P as s, R as n, T as i, a as r, r as A } from "../../_chunks/pregnancy-weight-gain-DI7X-0JX.js";
+import { P as s, R as n, T as i, a as r, r as A } from "../../_chunks/pregnancy-weight-gain-aicn7qs7.js";
 export {
   s as PregnancyWeightGain,
   n as RATE_BANDS,

package/dist/components/privacy-lock/index.js

@@ -1,4 +1,4 @@
-import { P as o, p as r } from "../../_chunks/privacy-lock-BN3L-alb.js";
+import { P as o, p as r } from "../../_chunks/privacy-lock-C7JyMf0y.js";
 export {
   o as PrivacyLock,
   r as privacyLockAgent

package/dist/components/product-hub-tray/index.js

@@ -1,4 +1,4 @@
-import { P as u, a as o, p as t, b as e } from "../../_chunks/product-hub-panel-CkfZBA3t.js";
+import { P as u, a as o, p as t, b as e } from "../../_chunks/product-hub-panel-CAXDFeGP.js";
 import { i as s } from "../../_chunks/is-safe-url-DkETxeHz.js";
 export {
   u as ProductHubPanel,

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

@@ -1,4 +1,4 @@
-import { P as r, p } from "../../_chunks/public-header.agent-CYQK6T6F.js";
+import { P as r, p } from "../../_chunks/public-header.agent-BOhJgZEU.js";
 export {
   r as PublicHeader,
   p as publicHeaderAgent

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

@@ -1,4 +1,4 @@
-import { R as r, r as s } from "../../_chunks/reviews-panel-CPrXu5TX.js";
+import { R as r, r as s } from "../../_chunks/reviews-panel-DBktKm7i.js";
 export {
   r as ReviewsPanel,
   s as reviewsPanelAgent

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

@@ -0,0 +1,16 @@
+export type EditorToolbarPreset = 'minimal' | 'standard' | 'full';
+export interface EditorToolbarProps {
+    /** Dispatch a Redactor command (and refresh active state). */
+    run: (command: string, ...args: unknown[]) => void;
+    /** Active formats at the caret — toggle buttons render pressed. */
+    active: ReadonlySet<string>;
+    preset: EditorToolbarPreset;
+    /** Show the text-colour control (consumer loaded the fontcolor plugin). */
+    enableColor?: boolean;
+    /** Show the image control (consumer set an image-upload URL). */
+    enableImage?: boolean;
+    /** Show the table control (consumer loaded the table plugin). */
+    enableTable?: boolean;
+}
+export declare function EditorToolbar({ run, active, preset, enableColor, enableImage, enableTable, }: EditorToolbarProps): React.JSX.Element;
+//# sourceMappingURL=editor-toolbar.d.ts.map

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

@@ -0,0 +1,25 @@
+import { type ReactNode } from 'react';
+export interface HelpMeWriteOverlayProps {
+    open: boolean;
+    onClose: () => void;
+    onRequestAiDraft: (ctx: {
+        prompt: string;
+        signal: AbortSignal;
+    }) => Promise<string>;
+    onInsert: (draft: string) => void;
+    /** Preview + insert the draft as HTML (default) or plain text. */
+    previewAsHtml?: boolean;
+    privacyNotice?: ReactNode;
+    /**
+     * Voice dictation into the prompt. Same seam as the editor's `onDictate`:
+     * the consumer runs mic + transcription and pushes text back; the kit appends
+     * finals to the prompt. When omitted, the composer shows no mic.
+     */
+    onDictate?: (ctx: {
+        signal: AbortSignal;
+        onPartialTranscript: (text: string) => void;
+        onFinalTranscript: (text: string) => void;
+    }) => Promise<void>;
+}
+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.js

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

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

@@ -1,3 +1,4 @@
+import { type ReactNode } from 'react';
 import '../../tokens/themes/bridges/redactor-theme.css';
 export type RedactorFactory = (selector: string | HTMLElement, command?: unknown, ...args: unknown[]) => unknown;
 export type RichTextEditorToolbar = 'minimal' | 'standard' | 'full';
@@ -37,13 +38,55 @@ export interface RichTextEditorProps {
     imageUploadUrl?: string;
     /** App keyboard-shortcut seam (e.g. Ctrl/Cmd+Enter to save). */
     onKeyDown?: (event: KeyboardEvent) => void;
+    /**
+     * Help-me-write. When provided, a DS "Help me write" action appears; the kit
+     * opens a dialog, calls this with the prompt + an AbortSignal, sanitises the
+     * returned draft and inserts it at the caret. The backend call / auth /
+     * practiceId all live in the consumer's implementation — never in the kit.
+     */
+    onRequestAiDraft?: (ctx: {
+        prompt: string;
+        signal: AbortSignal;
+    }) => Promise<string>;
+    /** Whether `onRequestAiDraft` returns HTML (default) or plain text. */
+    aiDraftFormat?: 'html' | 'text';
+    /** Override the compliance notice shown in the Help-me-write dialog. */
+    aiPrivacyNotice?: ReactNode;
+    /**
+     * Voice dictation. When provided, a DS mic toggle + live-transcript region
+     * appear. The kit owns the UI; the consumer runs mic capture + transcription
+     * inside the callback and pushes text back via `onPartialTranscript` (drives
+     * the live region) and `onFinalTranscript` (sanitised + inserted at the
+     * caret). Resolve when the session ends; honour `signal` to stop. All
+     * mic / transcription / backend logic stays consumer-side.
+     */
+    onDictate?: (ctx: {
+        signal: AbortSignal;
+        onPartialTranscript: (text: string) => void;
+        onFinalTranscript: (text: string) => void;
+    }) => Promise<void>;
 }
+/** Block/inline formats the editor can toggle via `applyFormat`. */
+export type EditorFormat = 'bold' | 'italic' | 'strikethrough' | 'bulletedList' | 'numberedList' | 'heading' | 'quote' | 'paragraph';
 export interface RichTextEditorHandle {
     getHTML: () => string;
+    /** Plain-text content of the editor (tags stripped). */
+    getText: () => string;
     /** Always '' — Redactor has no native Markdown serializer (see MDX). */
     getMarkdown: () => string;
     /** HTML goes through DOMPurify before reaching Redactor. */
     setContent: (html: string) => void;
+    /**
+     * Insert content at the caret (replacing any selection). HTML is
+     * DOMPurify-sanitised; pass `{ asHtml: false }` for a plain-text insert.
+     * Works with the degraded <textarea> too. This is the seam for inserting
+     * merge/template variables and AI-generated drafts.
+     */
+    insertAtCursor: (content: string, opts?: {
+        asHtml?: boolean;
+    }) => void;
+    /** Toggle/apply a block or inline format on the current selection. */
+    applyFormat: (format: EditorFormat) => void;
     focus: () => void;
     clear: () => void;
 }

package/dist/components/search-bar/index.js

@@ -1,4 +1,4 @@
-import { S as e, f as s, s as t } from "../../_chunks/search-bar-CvN_S0jW.js";
+import { S as e, f as s, s as t } from "../../_chunks/search-bar-SY2BcV2N.js";
 export {
   e as SearchBar,
   s as filterSearchResults,

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

@@ -1,4 +1,4 @@
-import { S as t } from "../../_chunks/search-input-D3aMvi4l.js";
+import { S as t } from "../../_chunks/search-input-DbxrnHkW.js";
 import { s as o } from "../../_chunks/search-input.agent-CfZvViOd.js";
 export {
   t as SearchInput,

package/dist/components/select/index.js

@@ -1,4 +1,4 @@
-import { S as a, a as l, b as S, c, d as s, e as o, f as r, g as p, h as g, i, j as m } from "../../_chunks/select-hsCaJSX3.js";
+import { S as a, a as l, b as S, c, d as s, e as o, f as r, g as p, h as g, i, j as m } from "../../_chunks/select-CEtRcon5.js";
 export {
   a as Select,
   l as SelectContent,

package/dist/components/select/select.d.ts

@@ -62,6 +62,14 @@ export interface SelectProps<T extends string = string> {
     tone?: 'default' | 'error';
     'aria-label'?: string;
     className?: string;
+    /**
+     * Portal target for the listbox. Defaults to `document.body`. Set this to a
+     * parent overlay's content element (e.g. a Popover) when the Select is nested
+     * inside one, so the listbox shares that stacking context and renders above
+     * it instead of behind it (the global z-scale puts `--z-dropdown` below
+     * `--z-popover`).
+     */
+    container?: HTMLElement | null;
 }
 interface SelectComponent {
     <T extends string = string>(props: SelectProps<T> & {

package/dist/components/sheet/index.js

@@ -1,4 +1,4 @@
-import { S as t, s as a } from "../../_chunks/sheet-xbzu4YiY.js";
+import { S as t, s as a } from "../../_chunks/sheet-taJer-Ha.js";
 export {
   t as Sheet,
   a as sheetAgent

package/dist/components/sign-document/index.js

@@ -1,4 +1,4 @@
-import { S as o, s } from "../../_chunks/sign-document--nr5cxsB.js";
+import { S as o, s } from "../../_chunks/sign-document-CdAiHiCh.js";
 export {
   o as SignDocument,
   s as signDocumentAgent

package/dist/components/sign-in-with-alfadocs-button/index.js

@@ -1,4 +1,4 @@
-import { S as n } from "../../_chunks/sign-in-with-alfadocs-button-BpAjVmsI.js";
+import { S as n } from "../../_chunks/sign-in-with-alfadocs-button-LppxjlFt.js";
 export {
   n as SignInWithAlfadocsButton
 };

package/dist/components/signature-field/index.js

@@ -1,4 +1,4 @@
-import { S as i, s as r } from "../../_chunks/signature-field-DbhbpLha.js";
+import { S as i, s as r } from "../../_chunks/signature-field-Dy1JRjzE.js";
 export {
   i as SignatureField,
   r as signatureFieldVariants

package/dist/components/slot-grid/index.js

@@ -1,4 +1,4 @@
-import { S as s, f as e, i as r } from "../../_chunks/slot-grid-BlHHP9Qy.js";
+import { S as s, f as e, i as r } from "../../_chunks/slot-grid-FsqumOaS.js";
 export {
   s as SlotGrid,
   e as findFirstAvailable,

package/dist/components/smart-date/index.d.ts

@@ -0,0 +1,3 @@
+export { SmartDate } from './smart-date';
+export type { SmartDateProps, SmartDateState } from './smart-date';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/smart-date/index.js

@@ -0,0 +1,5 @@
+import { S as t } from "../../_chunks/smart-date-CWikAqZx.js";
+export {
+  t as SmartDate
+};
+//# sourceMappingURL=index.js.map

package/dist/components/smart-date/smart-date.d.ts

@@ -0,0 +1,32 @@
+import { type HTMLAttributes } from 'react';
+import { type VariantProps } from 'class-variance-authority';
+export type SmartDateState = 'overdue' | 'past' | 'today' | 'tomorrow' | 'soon' | 'upcoming';
+declare const smartDateVariants: (props?: ({
+    state?: "past" | "upcoming" | "today" | "overdue" | "tomorrow" | "soon" | null | undefined;
+    size?: "sm" | "md" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export interface SmartDateProps extends Omit<HTMLAttributes<HTMLTimeElement>, 'children'>, Pick<VariantProps<typeof smartDateVariants>, 'size'> {
+    /** The date to display — ISO-8601 string, ms-since-epoch, or a `Date`. */
+    date: string | number | Date;
+    /**
+     * Reference "now" — defaults to the current date. Pin it in stories / tests
+     * (and anywhere deterministic output is required) so the bucketing is stable.
+     */
+    now?: string | number | Date;
+    /**
+     * Treat the date as a deadline: past dates read "Overdue" (destructive)
+     * instead of a neutral elapsed phrase ("Yesterday" / "5 days ago").
+     */
+    deadline?: boolean;
+    /**
+     * Near-future window, in whole days, within which an upcoming date shows a
+     * relative phrase ("In 3 days") alongside the date. Beyond it, just the date.
+     * Default `7`.
+     */
+    soonWithinDays?: number;
+    /** Locale override. Falls back to the active i18next language. */
+    locale?: string;
+}
+export declare const SmartDate: import("react").ForwardRefExoticComponent<SmartDateProps & import("react").RefAttributes<HTMLTimeElement>>;
+export {};
+//# sourceMappingURL=smart-date.d.ts.map

package/dist/components/social-sign-in-button/index.js

@@ -1,4 +1,4 @@
-import { S as t } from "../../_chunks/social-sign-in-button-uJYLM366.js";
+import { S as t } from "../../_chunks/social-sign-in-button-dlpPI5l7.js";
 export {
   t as SocialSignInButton
 };

package/dist/components/spinner/index.js

@@ -1,4 +1,4 @@
-import { S as n } from "../../_chunks/spinner-OjQNn8oN.js";
+import { S as n } from "../../_chunks/spinner-hbwuKwMf.js";
 export {
   n as Spinner
 };

package/dist/components/streaming-text/index.js

@@ -1,4 +1,4 @@
-import { S as t } from "../../_chunks/streaming-text-CfhDqtIT.js";
+import { S as t } from "../../_chunks/streaming-text-BB9mvK4m.js";
 export {
   t as StreamingText
 };

package/dist/components/tabs/index.js

@@ -1,4 +1,4 @@
-import { T as t, a as b, b as T, c as e, t as r } from "../../_chunks/tabs-BpPYVme_.js";
+import { T as t, a as b, b as T, c as e, t as r } from "../../_chunks/tabs-BIQ0ew1T.js";
 export {
   t as Tabs,
   b as TabsContent,

package/dist/components/task-tray/index.js

@@ -1,4 +1,4 @@
-import { T as s, t } from "../../_chunks/task-tray-Cb_hK4yb.js";
+import { T as s, t } from "../../_chunks/task-tray-CAncV-QQ.js";
 export {
   s as TaskTray,
   t as taskTrayAgent

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

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

package/dist/components/toast/index.js

@@ -1,4 +1,4 @@
-import { T as s, t as o, a as e, b as r, c as n, d as c, e as g } from "../../_chunks/toast.agent-B0MCsvdZ.js";
+import { T as s, t as o, a as e, b as r, c as n, d as c, e as g } from "../../_chunks/toast.agent-vuLRRn2a.js";
 export {
   s as Toaster,
   o as toastAgent,

package/dist/components/tooth-scheme/index.d.ts

@@ -1,5 +1,5 @@
 export * from './tooth-scheme';
-export { FDI_TO_META, FDI_TO_UNIVERSAL, FDI_TO_PALMER, CONDITION_COLORS, CONDITION_TOKENS, CONDITION_PATTERNS, TOOTH_SHAPES, chartFromConditions, emptyChart, labelFor, layoutTeeth, } from './tooth-data';
-export type { Anatomy, Arch, Quadrant, Side, Surface, ToothMeta, ToothShape, PositionedTooth, } from './tooth-data';
+export { FDI_TO_META, FDI_TO_UNIVERSAL, FDI_TO_PALMER, CONDITION_COLORS, CONDITION_TOKENS, CONDITION_SIDE_SYMBOL, CONDITION_PLAN_FOLDER, SURFACE_ASSET_NAME, toothImageUrl, conditionSymbolUrl, surfaceSymbolUrl, zonesForTooth, zoneSurface, zonePath, chartFromConditions, emptyChart, labelFor, layoutTeeth, } from './tooth-data';
+export type { Anatomy, Arch, Quadrant, Side, Surface, SurfaceZone, Projection, SideSymbolSpec, ToothMeta, PositionedTooth, } from './tooth-data';
 export { toothSchemeAgent } from './tooth-scheme.agent';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,20 +1,27 @@
-import { C as s, a as t, b as O, F as e, c as o, d as E, P as _, e as I, T as N, f as h, g as S, h as r, l as A, i as C, t as R, r as m } from "../../_chunks/tooth-scheme-CxlsLjfN.js";
+import { C as o, a as t, b as e, c as T, F as O, d as _, e as E, P as I, f as S, S as r, T as N, g as h, h as m, i as n, l as A, j as l, s as C, t as D, k as F, r as c, z as R, m as i, n as L } from "../../_chunks/tooth-scheme-BIx1O2aJ.js";
 export {
-  s as CONDITION_COLORS,
-  t as CONDITION_PATTERNS,
-  O as CONDITION_TOKENS,
-  e as FDI_TO_META,
-  o as FDI_TO_PALMER,
+  o as CONDITION_COLORS,
+  t as CONDITION_PLAN_FOLDER,
+  e as CONDITION_SIDE_SYMBOL,
+  T as CONDITION_TOKENS,
+  O as FDI_TO_META,
+  _ as FDI_TO_PALMER,
   E as FDI_TO_UNIVERSAL,
-  _ as PERMANENT_TEETH,
-  I as PRIMARY_TEETH,
-  N as TOOTH_SHAPES,
-  h as ToothScheme,
-  S as chartFromConditions,
-  r as emptyChart,
+  I as PERMANENT_TEETH,
+  S as PRIMARY_TEETH,
+  r as SURFACE_ASSET_NAME,
+  N as ToothScheme,
+  h as chartFromConditions,
+  m as conditionSymbolUrl,
+  n as emptyChart,
   A as labelFor,
-  C as layoutTeeth,
-  R as toothSchemeAgent,
-  m as toothSchemeVariants
+  l as layoutTeeth,
+  C as surfaceSymbolUrl,
+  D as toothImageUrl,
+  F as toothSchemeAgent,
+  c as toothSchemeVariants,
+  R as zonePath,
+  i as zoneSurface,
+  L as zonesForTooth
 };
 //# sourceMappingURL=index.js.map

package/dist/components/tooth-scheme/tooth-data.d.ts

@@ -3,7 +3,7 @@ export type Dentition = 'permanent' | 'primary' | 'mixed';
 export type Numbering = 'fdi' | 'universal' | 'palmer';
 export type ToothMode = 'interactive' | 'display';
 export type Surface = 'mesial' | 'distal' | 'occlusal' | 'buccal' | 'lingual';
-export type ToothCondition = 'caries' | 'filled' | 'crowned' | 'missing' | 'implant' | 'rootCanal';
+export type ToothCondition = 'caries' | 'filled' | 'crowned' | 'temporaryCrown' | 'bridge' | 'missing' | 'implant' | 'implantExtraction' | 'stub' | 'destroyed' | 'rootCanal';
 export interface ToothState {
     conditions: ToothCondition[];
     surfaces: Surface[];
@@ -43,33 +43,94 @@ export declare const PRIMARY_TEETH: FdiId[];
 export declare const FDI_TO_META: Record<FdiId, ToothMeta>;
 export declare const FDI_TO_UNIVERSAL: Record<FdiId, string>;
 export declare const FDI_TO_PALMER: Record<FdiId, string>;
+/**
+ * FDI used to resolve a tooth's RENDER. There are no separate deciduous
+ * renders — primary teeth reuse the permanent image of the same position
+ * (quadrant 5→1, 6→2, 7→3, 8→4; position digit unchanged), scaled down by
+ * the renderer. Permanent teeth resolve to themselves.
+ */
+export declare function assetFdi(meta: ToothMeta): FdiId;
+/** Render scale applied to a tooth image (primary teeth are smaller). */
+export declare const PRIMARY_TOOTH_SCALE = 0.72;
 /** CSS variable name (without the leading `var(...)`) that drives a condition's colour. */
 export declare const CONDITION_TOKENS: Record<ToothCondition, string>;
 /**
  * Convenience: the `fill="var(--destructive)"` string ready to paste onto
- * an SVG attribute. Kept in sync with `CONDITION_TOKENS`.
+ * an SVG attribute. Kept in sync with `CONDITION_TOKENS`. Used for the legend
+ * swatch + the surface-condition ring; whole-tooth conditions render a
+ * distinct symbol image (the glyph is the colour-independent channel).
  */
 export declare const CONDITION_COLORS: Record<ToothCondition, string>;
-/** SVG `<pattern>` ids declared in `<defs>`. `missing` renders an X glyph instead of a pattern. */
-export declare const CONDITION_PATTERNS: Record<ToothCondition, string>;
-export interface ToothShape {
-    /** Visual width inside the enclosing `<g>`. */
-    width: number;
-    /** Visual height inside the enclosing `<g>`. */
-    height: number;
-    /** SVG `d` attribute for the crown outline. */
-    path: string;
-    /** Optional inner decorative path (occlusal surface on molars, etc.). */
-    innerPath?: string;
+export interface SideSymbolSpec {
+    /** Asset folder under `side/`. */
+    folder: string;
+    /** How the file resolves inside `{folder}/{view}/`. */
+    resolve: 'per-fdi' | 'general' | 'rct';
 }
-export declare const TOOTH_SHAPES: Record<Anatomy, ToothShape>;
-export declare const TOOTH_GAP = 4;
-export declare const TOOTH_ROW_GAP = 24;
+export declare const CONDITION_SIDE_SYMBOL: Partial<Record<ToothCondition, SideSymbolSpec>>;
+/** Resolve the side-view symbol overlay URL for a condition on a tooth. */
+export declare function conditionSymbolUrl(meta: ToothMeta, assetBaseUrl: string, spec: SideSymbolSpec): string;
+export type Projection = 'side' | 'plan';
+/** The user-selectable view: a single projection, or both stacked together. */
+export type ViewMode = Projection | 'both';
+/** Map the clinical `Surface` enum to the asset surface filename token. */
+export declare const SURFACE_ASSET_NAME: Record<Surface, string>;
+/** Conditions that render as per-surface fills in the plan view. */
+export declare const CONDITION_PLAN_FOLDER: Partial<Record<ToothCondition, string>>;
+/** Resolve a per-surface plan-view overlay URL (e.g. caries on the distal). */
+export declare function surfaceSymbolUrl(meta: ToothMeta, assetBaseUrl: string, folder: string, surface: Surface): string;
+/**
+ * Clickable surface regions of a plan-view tooth, named by SCREEN position.
+ * `zoneSurface()` resolves each to the anatomical `Surface` per quadrant.
+ */
+export type SurfaceZone = 'top' | 'bottom' | 'left' | 'right' | 'center';
+/**
+ * Which zones a tooth exposes. Molars & premolars have a central occlusal
+ * table (5 zones); incisors & canines have no occlusal surface to mark, so
+ * their crown splits into 4 directional zones.
+ */
+export declare function zonesForTooth(meta: ToothMeta): SurfaceZone[];
+/**
+ * Map a screen zone to the anatomical surface, QUADRANT-AWARE. Two flips make
+ * this non-trivial (ported from the platform odontogram's `_getAreaBySide`, so
+ * a finding always lands on the correct surface wherever the tooth sits):
+ *
+ *  - mesial / distal (left & right zones) flip between the patient's right
+ *    quadrants {1,4} and left quadrants {2,3} — "toward the midline" reverses.
+ *  - buccal(vestibular) / lingual(oral) (top & bottom zones) flip between the
+ *    upper and lower arch.
+ *  - centre is always occlusal.
+ *
+ * Primary quadrants (5-8) normalise to their permanent counterpart (1-4).
+ */
+export declare function zoneSurface(meta: ToothMeta, zone: SurfaceZone): Surface;
+/**
+ * SVG `d` path for a clickable surface zone within a tooth's local box.
+ * 5-zone teeth frame a central occlusal rect with four edge trapezoids;
+ * 4-zone teeth split the box along both diagonals into four triangles meeting
+ * at the centre.
+ */
+export declare function zonePath(zone: SurfaceZone, rect: {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}, hasCenter: boolean): string;
+export declare const TOOTH_GAP = 5;
+export declare const TOOTH_ROW_GAP = 40;
 export declare const TOOTH_HIT_PAD = 4;
+export declare const TOOTH_SLOT_WIDTH = 36;
+/** Facial-view slot block-size; the plan/occlusal view uses a shorter slot. */
+export declare const TOOTH_SLOT_HEIGHT = 62;
+/**
+ * Resolve a tooth render URL. `view` follows the arch (`top` = upper,
+ * `bottom` = lower); `symbol` selects the artwork layer (`default` is the
+ * healthy tooth; condition/finding overlays use their symbol folder).
+ */
+export declare function toothImageUrl(meta: ToothMeta, assetBaseUrl: string, symbol?: string, projection?: 'side' | 'plan'): string;
 export interface PositionedTooth {
     fdi: FdiId;
     meta: ToothMeta;
-    shape: ToothShape;
     x: number;
     y: number;
 }
@@ -80,7 +141,7 @@ export interface PositionedTooth {
  * is preserved: the patient's right sits on the viewer's left in both
  * arches, regardless of document direction.
  */
-export declare function layoutTeeth(dentition: Dentition): {
+export declare function layoutTeeth(dentition: Dentition, slotHeight?: number): {
     teeth: PositionedTooth[];
     width: number;
     height: number;

package/dist/components/tooth-scheme/tooth-scheme.agent.d.ts

@@ -1,4 +1,6 @@
 import type { AgentAdapter } from '../../agent/types';
 import type { ToothSchemeHandle } from './tooth-scheme';
+import type { Surface, ToothCondition } from './tooth-data';
 export declare const toothSchemeAgent: AgentAdapter<ToothSchemeHandle>;
+export type { Surface, ToothCondition };
 //# sourceMappingURL=tooth-scheme.agent.d.ts.map