@alfadocs/ui-kit 0.41.2 → 0.43.0

package/dist/_chunks/{unit-converter-EUwO6QYq.js → unit-converter-CuXCXJhK.js}

@@ -1,11 +1,11 @@
 import { jsxs as d, jsx as e } from "react/jsx-runtime";
-import { forwardRef as k, useState as g, useMemo as _, useEffect as O } from "react";
-import { c as z } from "./index-D2ZczOXr.js";
-import { useTranslation as j } from "react-i18next";
+import { forwardRef as j, useState as g, useMemo as _, useEffect as A } from "react";
+import { c as B } from "./index-D2ZczOXr.js";
+import { useTranslation as G } from "react-i18next";
 import { F as v } from "./form-field-BOm9hK35.js";
-import { N as A } from "./number-input-Dj5L3pXK.js";
+import { N as Y } from "./number-input-Dj5L3pXK.js";
 import { S as y } from "./select-hsCaJSX3.js";
-import { I as B } from "./insert-result-yJ0QavoN.js";
+import { I as D } from "./insert-result-DisOY2G-.js";
 const F = {
   // weight → base kg
   kg: { id: "kg", category: "weight", factor: 1, offset: 0 },
@@ -28,53 +28,56 @@ const F = {
   length: ["cm", "m", "in", "ft"],
   temperature: ["c", "f"],
   glucose: ["mmol_l", "mg_dl"]
-}, G = [
+}, L = [
   "weight",
   "length",
   "temperature",
   "glucose"
 ];
-function Y(c, o, f) {
-  const r = F[o], n = F[f];
-  if (!r || !n) throw new Error(`Unknown unit: ${o} → ${f}`);
-  if (r.category !== n.category)
+function M(c, r, f) {
+  const o = F[r], n = F[f];
+  if (!o || !n) throw new Error(`Unknown unit: ${r} → ${f}`);
+  if (o.category !== n.category)
     throw new Error(
-      `Cannot convert across categories: ${r.category} → ${n.category}`
+      `Cannot convert across categories: ${o.category} → ${n.category}`
     );
-  return (c * r.factor + r.offset - n.offset) / n.factor;
+  return (c * o.factor + o.offset - n.offset) / n.factor;
 }
-const D = z("ds:flex ds:flex-col ds:gap-[var(--spacing-lg)]", {
+const q = B("ds:flex ds:flex-col ds:gap-[var(--spacing-lg)]", {
   variants: {
     width: { full: "ds:w-full", auto: "ds:inline-flex" }
   },
   defaultVariants: { width: "full" }
-}), L = k(
+}), H = j(
   ({
     defaultCategory: c = "weight",
-    onResultChange: o,
+    onResultChange: r,
     onInsert: f,
-    id: r,
-    width: n,
-    className: C
-  }, U) => {
-    const { t, i18n: b } = j(), [$, E] = g(c), [i, S] = g(null), [m, w] = g(
+    insertVariant: o = "insert",
+    onCopy: n,
+    onError: C,
+    id: U,
+    width: E,
+    className: S
+  }, T) => {
+    const { t, i18n: b } = G(), [$, V] = g(c), [i, k] = g(null), [m, w] = g(
       p[c][0]
     ), [l, x] = g(
       p[c][1]
-    ), T = (s) => {
+    ), O = (s) => {
       const I = s, h = p[I];
-      E(I), w(h[0]), x(h[1] ?? h[0]);
+      V(I), w(h[0]), x(h[1] ?? h[0]);
     }, a = _(
-      () => i === null ? null : Y(i, m, l),
+      () => i === null ? null : M(i, m, l),
       [i, m, l]
     ), u = _(
       () => new Intl.NumberFormat(b.language, { maximumFractionDigits: 3 }),
       [b.language]
     );
-    O(() => {
-      o == null || o(a);
-    }, [a, o]);
-    const V = G.map((s) => ({
+    A(() => {
+      r == null || r(a);
+    }, [a, r]);
+    const z = L.map((s) => ({
       value: s,
       label: t(`unitConverter.category.${s}`)
     })), N = p[$].map((s) => ({
@@ -84,21 +87,21 @@ const D = z("ds:flex ds:flex-col ds:gap-[var(--spacing-lg)]", {
     return /* @__PURE__ */ d(
       "div",
       {
-        ref: U,
+        ref: T,
         "data-component": "unit-converter",
-        "data-component-id": r,
-        className: D({ width: n, className: C }),
+        "data-component-id": U,
+        className: q({ width: E, className: S }),
         children: [
           /* @__PURE__ */ e(v, { label: t("unitConverter.categoryLabel"), children: /* @__PURE__ */ e(
             y,
             {
-              options: V,
+              options: z,
               value: $,
-              onValueChange: T
+              onValueChange: O
             }
           ) }),
           /* @__PURE__ */ d("div", { className: "ds:grid ds:grid-cols-1 ds:gap-[var(--spacing-md)] ds:sm:grid-cols-3", children: [
-            /* @__PURE__ */ e(v, { label: t("unitConverter.value"), children: /* @__PURE__ */ e(A, { mode: "decimal", value: i, onChange: S }) }),
+            /* @__PURE__ */ e(v, { label: t("unitConverter.value"), children: /* @__PURE__ */ e(Y, { mode: "decimal", value: i, onChange: k }) }),
             /* @__PURE__ */ e(v, { label: t("unitConverter.from"), children: /* @__PURE__ */ e(
               y,
               {
@@ -128,10 +131,13 @@ const D = z("ds:flex ds:flex-col ds:gap-[var(--spacing-lg)]", {
               " ",
               t(`unitConverter.units.${l}`)
             ] }),
-            f ? /* @__PURE__ */ e(
-              B,
+            o === "copy" || f ? /* @__PURE__ */ e(
+              D,
               {
+                variant: o,
                 onInsert: f,
+                onCopy: n,
+                onError: C,
                 card: {
                   title: t("insert.title.unitConverter"),
                   fields: [
@@ -157,12 +163,12 @@ const D = z("ds:flex ds:flex-col ds:gap-[var(--spacing-lg)]", {
     );
   }
 );
-L.displayName = "UnitConverter";
+H.displayName = "UnitConverter";
 export {
-  G as C,
+  L as C,
   F as U,
   p as a,
-  L as b,
-  Y as c
+  H as b,
+  M as c
 };
-//# sourceMappingURL=unit-converter-EUwO6QYq.js.map
+//# sourceMappingURL=unit-converter-CuXCXJhK.js.map

package/dist/_chunks/{workflow-map-C3gB0FvB.js → workflow-map-BFNpzTiw.js}

@@ -12,7 +12,7 @@ import { C as Ne } from "./circle-BkqTgYmt.js";
 import { u as Ce } from "./registry-nPAVE19X.js";
 import { A as V } from "./alert-ywPR59NE.js";
 import { B as _e } from "./button-DD_0Xdmr.js";
-import { D as N } from "./dropdown-menu-BC5ZdOMo.js";
+import { D as N } from "./dropdown-menu-CUEXqKis.js";
 import { E } from "./empty-state-BLy7tigq.js";
 import { P as ae } from "./plus-CYKNmfuA.js";
 import { G as ne } from "./globe-BkEFMNSg.js";
@@ -1399,4 +1399,4 @@ export {
   ee as r,
   D as w
 };
-//# sourceMappingURL=workflow-map-C3gB0FvB.js.map
+//# sourceMappingURL=workflow-map-BFNpzTiw.js.map

package/dist/_chunks/{zh-CN-eXB-PFu4.js → zh-CN-De4zwEhx.js}

@@ -1,5 +1,5 @@
-import { o as s, q as i, r as o, v as m } from "./react-day-picker-CdtIiKjx.js";
-import { i as u } from "./isSameWeek-Bim5ftRd.js";
+import { q as s, r as i, v as o, w as m } from "./date-picker-variants-DLi1Va_e.js";
+import { i as u } from "./isSameWeek-HfxKk6Lz.js";
 const c = {
   lessThanXSeconds: {
     one: "不到 1 秒",
@@ -385,4 +385,4 @@ const b = {
 export {
   Q as zhCN
 };
-//# sourceMappingURL=zh-CN-eXB-PFu4.js.map
+//# sourceMappingURL=zh-CN-De4zwEhx.js.map

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "0.41.2",
+  "packageVersion": "0.43.0",
   "components": [
     {
       "kind": "component",

package/dist/brand/product-lockup/product-lockup.d.ts

@@ -19,6 +19,14 @@ export type ProductLockupProps = {
      * gradient/serif treatment is inappropriate.
      */
     monochrome?: boolean;
+    /**
+     * Ink resolution. `'auto'` (default) uses the lockup's intended ink
+     * (`--foreground` for monochrome). `'inherit'` makes the whole lockup ride
+     * `currentColor` — use it with `monochrome` on a coloured brand surface (a
+     * tinted header or split-login panel) so the wordmark + name both take the
+     * surface's text colour rather than clashing with a fixed `--foreground`.
+     */
+    tone?: 'auto' | 'inherit';
     /** Lockup size. Drives both the wordmark and the name's cap height. */
     size?: LockupSize;
     className?: string;
@@ -46,6 +54,14 @@ export declare const ProductLockup: import("react").ForwardRefExoticComponent<{
      * gradient/serif treatment is inappropriate.
      */
     monochrome?: boolean;
+    /**
+     * Ink resolution. `'auto'` (default) uses the lockup's intended ink
+     * (`--foreground` for monochrome). `'inherit'` makes the whole lockup ride
+     * `currentColor` — use it with `monochrome` on a coloured brand surface (a
+     * tinted header or split-login panel) so the wordmark + name both take the
+     * surface's text colour rather than clashing with a fixed `--foreground`.
+     */
+    tone?: "auto" | "inherit";
     /** Lockup size. Drives both the wordmark and the name's cap height. */
     size?: LockupSize;
     className?: string;

package/dist/components/_shared/calendar-class-names.d.ts

@@ -0,0 +1,8 @@
+import type { ClassNames } from 'react-day-picker';
+/**
+ * Partial class-name map passed to every `<DayPicker classNames=…>` in the
+ * kit. Keyed by the rdp v9 enums so a future rdp upgrade surfaces missing
+ * keys at the type level.
+ */
+export declare const calendarClassNames: Partial<ClassNames>;
+//# sourceMappingURL=calendar-class-names.d.ts.map

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

@@ -2,6 +2,7 @@ export { composeRefs } from './compose-refs';
 export { isSafeImageSrc, safeImageSrc } from './safe-image-src';
 export { SafeHtml, sanitiseHtml, type SafeHtmlProfile, type SafeHtmlProps, } from './safe-html';
 export { groupOptions } from './group-options';
+export { InsertButton, buildResultText, buildResultHtml, buildResultCardSvg, svgCardToPngDataUri, type InsertButtonProps, type InsertVariant, type InsertPayload, type InsertMode, type InsertCardData, type InsertCardField, type SvgCardToPngOptions, } from './insert-result';
 export { normalizeDiacritics } from './normalize-diacritics';
 export { useDebouncedCallback } from './use-debounced-callback';
 export { useFocusTrap, type UseFocusTrapOptions } from './use-focus-trap';
@@ -11,6 +12,7 @@ export { INPUT_SURFACE_CHROME, INPUT_SURFACE_TONE, INPUT_SURFACE_HEIGHT, INPUT_S
 export { getDateFnsLocale, getShortDateFormat, useDateFnsLocale, } from './date-locale';
 export { buildDisabledMatcher } from './date-utils';
 export { CalendarChevron } from './calendar-chevron';
+export { calendarClassNames } from './calendar-class-names';
 export { triggerVariants, calendarIconVariants, popoverContentVariants, presetButtonVariants, } from './date-picker-variants';
 export type { OptionShape } from './option';
 export type { TimeValue } from './time';

package/dist/components/_shared/insert-result.d.ts

@@ -1,4 +1,6 @@
+import { type ButtonProps } from '../button';
 export type InsertMode = 'text' | 'image' | 'text-image';
+export type InsertVariant = 'insert' | 'copy';
 export interface InsertCardField {
     label: string;
     value: string;
@@ -12,24 +14,68 @@ export interface InsertCardData {
     highlight?: string;
 }
 export interface InsertPayload {
-    /** Which menu item the user chose. */
+    /** Which button the user chose. */
     mode: InsertMode;
     /** Plain-text summary. Always present. */
     text: string;
     /** Rich HTML summary (heading + list). Always present. */
     html: string;
-    /** Branded SVG result-card markup. Empty for mode `'text'`. */
+    /**
+     * Branded SVG result-card markup. Empty for mode `'text'`.
+     *
+     * Kept for back-compat and for callers that need the live, copy-pasteable
+     * vector. NOTE: SVG can carry `<script>` and is routinely stripped by
+     * rich-text sanitisers, so it is NOT the format to insert into an editor —
+     * use {@link InsertPayload.pngDataUri} for that.
+     */
     svg: string;
-    /** SVG as an `image/svg+xml` data URI for `<img src>`. Empty for `'text'`. */
+    /**
+     * SVG as an `image/svg+xml` data URI for `<img src>`. Empty for `'text'`.
+     *
+     * Same caveat as {@link InsertPayload.svg}: fine for a preview `<img>`, but a
+     * sanitiser-stripped vector once it reaches an editor. Prefer
+     * {@link InsertPayload.pngDataUri}.
+     */
     imageDataUri: string;
+    /**
+     * Async thunk that resolves the result-card to an `image/png` data URI —
+     * the format intended for editor insertion. PNG is a flat raster: it carries
+     * no script and survives the rich-text sanitiser that strips SVG. Resolves to
+     * an empty string for mode `'text'` (no image is built). The PNG is rendered
+     * lazily so the synchronous payload stays cheap; `await payload.pngDataUri()`
+     * only when you actually need the raster.
+     */
+    pngDataUri: () => Promise<string>;
 }
 export interface InsertButtonProps {
     /** Structured result used to build every payload representation. */
     card: InsertCardData;
-    /** Receives the built payload when a menu item is chosen. */
-    onInsert: (payload: InsertPayload) => void;
+    /**
+     * Verb the buttons perform. Defaults to `'insert'`.
+     *
+     * - `'insert'` — fires `onInsert(payload)` (editor-extension context).
+     * - `'copy'` — writes the chosen representation(s) to the clipboard as a
+     *   multi-format `ClipboardItem` (app-shell context).
+     */
+    variant?: InsertVariant;
+    /**
+     * Receives the built payload when a button is pressed.
+     *
+     * Required for the `insert` variant; optional (and ignored) for `copy`.
+     */
+    onInsert?: (payload: InsertPayload) => void;
+    /** `copy` variant only — fired after a successful clipboard write. */
+    onCopy?: (mode: InsertMode) => void;
+    /** `copy` variant only — fired if the clipboard write can't proceed. */
+    onError?: (error: unknown) => void;
     /** Trigger size. Defaults to `'sm'`. */
     size?: 'sm' | 'md' | 'lg';
+    /**
+     * Visual intent of the three trigger buttons (text / image / text+image).
+     * Mirrors the `Button` `intent` prop and applies to every trigger uniformly
+     * so the three stay visually consistent. Defaults to `'primary'`.
+     */
+    intent?: ButtonProps['intent'];
 }
 interface ThemeColours {
     fg: string;
@@ -42,6 +88,32 @@ interface ThemeColours {
 export declare function buildResultText(card: InsertCardData): string;
 export declare function buildResultHtml(card: InsertCardData): string;
 export declare function buildResultCardSvg(card: InsertCardData, c: ThemeColours): string;
-export declare function InsertButton({ card, onInsert, size, }: InsertButtonProps): React.ReactElement;
+/** Options for {@link svgCardToPngDataUri}. */
+export interface SvgCardToPngOptions {
+    /**
+     * Resolved theme colours to paint into the card. When omitted, the card
+     * renders with `currentColor` / transparent fallbacks (see
+     * {@link buildResultCardSvg}) — pass sampled colours for a branded raster.
+     */
+    colours?: ThemeColours;
+    /**
+     * Device-pixel scale factor for the raster. `2` yields a retina-sharp PNG.
+     * Defaults to `1`.
+     */
+    scale?: number;
+}
+/**
+ * Render an {@link InsertCardData} result card to an `image/png` data URI.
+ *
+ * This is the format intended for editor insertion: a flat raster carries no
+ * `<script>` and survives the rich-text sanitiser that strips inline SVG. The
+ * card is built as SVG, loaded into an `<img>`, painted onto a canvas at the
+ * card's intrinsic size (optionally scaled), and read back as `image/png`.
+ *
+ * Browser-only — relies on `Image`, `<canvas>`, and `canvas.toBlob`. Throws if
+ * called in a non-DOM context or if the SVG fails to decode.
+ */
+export declare function svgCardToPngDataUri(card: InsertCardData, opts?: SvgCardToPngOptions): Promise<string>;
+export declare const InsertButton: import("react").ForwardRefExoticComponent<InsertButtonProps & import("react").RefAttributes<HTMLDivElement>>;
 export {};
 //# sourceMappingURL=insert-result.d.ts.map

package/dist/components/address-autocomplete/address-autocomplete.d.ts

@@ -0,0 +1,77 @@
+import { type StructuredAddress, type RawAddressComponent } from './parse-address';
+export type { StructuredAddress, RawAddressComponent };
+/**
+ * A single address suggestion surfaced in the listbox.
+ *
+ * `placeId` keys the row and (in real Google mode) is used to fetch full
+ * details on selection. In MOCK mode the suggestion carries a pre-parsed
+ * `address` so selection resolves without any network call.
+ */
+export interface AddressSuggestion {
+    /** Stable id — the Google place id, or any unique string in mock mode. */
+    placeId: string;
+    /** Primary line shown in the row (e.g. "Via Roma 12"). */
+    primaryText: string;
+    /** Secondary line shown muted under the primary (e.g. "Milan, Italy"). */
+    secondaryText?: string;
+    /**
+     * Pre-parsed structured address. Required in MOCK mode (so selection can
+     * resolve without Google). In real Google mode this is omitted and the
+     * details are fetched on selection.
+     */
+    address?: StructuredAddress;
+}
+/**
+ * Test/story injector. Given the current query it returns the suggestions
+ * to show. Each returned suggestion MUST carry a pre-parsed `address` so
+ * selection resolves without a real Google call.
+ */
+export type GetSuggestions = (query: string) => AddressSuggestion[] | Promise<AddressSuggestion[]>;
+export interface AddressAutocompleteProps {
+    /**
+     * Google Maps JS API key. Consumer-owned; never cached by the kit. When
+     * absent (and no `getSuggestions` injector is given) the field degrades
+     * to a plain free-text input with no suggestions.
+     */
+    apiKey?: string;
+    /** Controlled text value of the input. */
+    value?: string;
+    /** Fires on every keystroke with the new input text. */
+    onValueChange?: (value: string) => void;
+    /** Uncontrolled initial text. Ignored once `value` is set. */
+    defaultValue?: string;
+    /**
+     * Fires when the user picks a suggestion, with the parsed structured
+     * address. In real Google mode the details are fetched first, so this
+     * is async relative to the click.
+     */
+    onSelect?: (address: StructuredAddress) => void;
+    /**
+     * Test-only / mock injector. When provided, the listbox is driven from
+     * its return value instead of a real Google call — even when `apiKey` is
+     * also set (the injector wins, so stories/tests are deterministic).
+     */
+    getSuggestions?: GetSuggestions;
+    /**
+     * Restrict predictions to these CLDR region codes (e.g. `['it']`).
+     * Real-Google mode only.
+     */
+    regionCodes?: string[];
+    /** Visible label is owned by a wrapping FormField; this is a fallback name. */
+    'aria-label'?: string;
+    /** Placeholder text. Falls back to the translated default. */
+    placeholder?: string;
+    /** Debounce before firing a suggestion fetch. Default 250ms. */
+    debounceMs?: number;
+    disabled?: boolean;
+    required?: boolean;
+    readOnly?: boolean;
+    name?: string;
+    /** Field id. Falls back to FormField context id. */
+    id?: string;
+    size?: 'sm' | 'md' | 'lg';
+    tone?: 'default' | 'error';
+    className?: string;
+}
+export declare const AddressAutocomplete: import("react").ForwardRefExoticComponent<AddressAutocompleteProps & import("react").RefAttributes<HTMLInputElement>>;
+//# sourceMappingURL=address-autocomplete.d.ts.map

package/dist/components/address-autocomplete/index.d.ts

@@ -0,0 +1,4 @@
+export { AddressAutocomplete } from './address-autocomplete';
+export type { AddressAutocompleteProps, AddressSuggestion, GetSuggestions, } from './address-autocomplete';
+export { parseAddressComponents, type StructuredAddress, type RawAddressComponent, } from './parse-address';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/address-autocomplete/index.js

@@ -0,0 +1,6 @@
+import { A as o, p } from "../../_chunks/address-autocomplete-CSjMrBvu.js";
+export {
+  o as AddressAutocomplete,
+  p as parseAddressComponents
+};
+//# sourceMappingURL=index.js.map

package/dist/components/address-autocomplete/parse-address.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Structured, app-friendly address. Field semantics match the AlfaDocs
+ * Italian patient-address model: `province` is the 2-letter IT province
+ * code (UPPERCASED) and `country` is the ISO 3166-1 alpha-2 code
+ * (lowercased), matching how the platform stores them.
+ */
+export interface StructuredAddress {
+    /** Street line — route, with the street number joined when present. */
+    street: string;
+    /** Town / city (locality, falling back to postal_town / admin level 3). */
+    city: string;
+    /** Postal / ZIP code. */
+    postcode: string;
+    /** Province — admin level 2 short code, UPPERCASED (e.g. "MI", "RM"). */
+    province: string;
+    /** Country — ISO alpha-2, lowercased (e.g. "it", "gb"). */
+    country: string;
+    /** Google's human-readable formatted address (whole line). */
+    formatted: string;
+}
+/**
+ * Loosened address-component shape accepted by {@link parseAddressComponents}.
+ * Mirrors both Places-API (`longText`/`shortText`) and classic Geocoder
+ * (`long_name`/`short_name`) field names so either source parses without a
+ * pre-pass. `types` is required; the text fields are individually optional.
+ */
+export interface RawAddressComponent {
+    types: string[];
+    longText?: string | null;
+    shortText?: string | null;
+    long_name?: string | null;
+    short_name?: string | null;
+}
+/**
+ * Maps an array of Google address components to a {@link StructuredAddress}.
+ *
+ * Pure: no SDK calls, no DOM, no I/O. `formatted` is passed through from the
+ * caller (Google's `formattedAddress` / `formatted_address`) because it is
+ * not derivable from the component list.
+ *
+ * Mapping rules:
+ * - `street`   = `route`, prefixed with `street_number` when present
+ *                (e.g. "Via Roma 12"). Either part alone is used if the
+ *                other is missing.
+ * - `city`     = `locality`, falling back to `postal_town`, then
+ *                `administrative_area_level_3`.
+ * - `postcode` = `postal_code`.
+ * - `province` = `administrative_area_level_2` SHORT text, UPPERCASED.
+ * - `country`  = `country` SHORT text (ISO alpha-2), lowercased.
+ */
+export declare function parseAddressComponents(components: readonly RawAddressComponent[], formatted?: string): StructuredAddress;
+//# sourceMappingURL=parse-address.d.ts.map

package/dist/components/badge/badge.d.ts

@@ -1,7 +1,7 @@
 import { type ReactNode } from 'react';
 import { type VariantProps } from 'class-variance-authority';
 declare const badgeVariants: (props?: ({
-    variant?: "error" | "neutral" | "info" | "success" | "warning" | "brand" | "accent" | null | undefined;
+    variant?: "error" | "accent" | "neutral" | "info" | "success" | "warning" | "brand" | null | undefined;
     size?: "sm" | "md" | "lg" | null | undefined;
     shape?: "pill" | "rectangular" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;

package/dist/components/bmi-calculator/bmi-calculator.d.ts

@@ -1,5 +1,5 @@
 import { type VariantProps } from 'class-variance-authority';
-import { type InsertPayload } from '../_shared/insert-result';
+import { type InsertPayload, type InsertVariant, type InsertMode } from '../_shared/insert-result';
 import { type UnitSystem, type BmiCategory } from './bmi';
 export interface BmiResult {
     /** BMI in kg/m². */
@@ -17,6 +17,16 @@ export interface BmiCalculatorProps extends VariantProps<typeof rootVariants> {
     onResultChange?: (result: BmiResult | null) => void;
     /** When provided, shows an "Insert" button that emits the result for an editor. */
     onInsert?: (payload: InsertPayload) => void;
+    /**
+     * Which verb the result button performs. Defaults to `'insert'`.
+     * Use `'copy'` in an app-shell surface (no editor to insert into) — the
+     * button writes the result to the clipboard as a multi-format `ClipboardItem`.
+     */
+    insertVariant?: InsertVariant;
+    /** `copy` variant only — fired after a successful clipboard write. */
+    onCopy?: (mode: InsertMode) => void;
+    /** `copy` variant only — fired if the clipboard write can't proceed. */
+    onError?: (error: unknown) => void;
     /** Opaque instance id, emitted as `data-component-id`. */
     id?: string;
     /** Extra class names on the wrapper. */

package/dist/components/bmi-calculator/index.js

@@ -1,4 +1,4 @@
-import { B as m } from "../../_chunks/bmi-calculator-DnEr513I.js";
+import { B as m } from "../../_chunks/bmi-calculator-DuVSFDuw.js";
 import { b as e, a as t, c as r, d as T, e as c, f as i, i as b, k as n, l as f } from "../../_chunks/bmi-BxD-tFzU.js";
 export {
   m as BmiCalculator,

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

package/dist/components/breadcrumb/index.js

@@ -1,4 +1,4 @@
-import { B as e, a as s, b, c as m, d as c, e as d, f as u } from "../../_chunks/breadcrumb-CLlhx7qo.js";
+import { B as e, a as s, b, c as m, d as c, e as d, f as u } from "../../_chunks/breadcrumb-OTbaY70e.js";
 export {
   e as Breadcrumb,
   s as BreadcrumbEllipsis,

package/dist/components/calculator-dialog/index.js

@@ -1,4 +1,4 @@
-import { C as l } from "../../_chunks/calculator-dialog-B74fqpFZ.js";
+import { C as l } from "../../_chunks/calculator-dialog-DdexHrTP.js";
 export {
   l as CalculatorDialog
 };

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

@@ -1,7 +1,7 @@
 import { type HTMLAttributes, type ReactNode } from 'react';
 import { type VariantProps } from 'class-variance-authority';
 declare const cardVariants: (props?: ({
-    variant?: "default" | "elevated" | "outlined" | null | undefined;
+    variant?: "default" | "outlined" | "elevated" | null | undefined;
     interactive?: boolean | null | undefined;
     stretch?: boolean | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;

package/dist/components/chart/chart.d.ts

@@ -29,6 +29,16 @@ export interface ChartProps extends VariantProps<typeof chartVariants> {
     width?: number | string;
     /** Opt-in pattern fills for colour-blind users. */
     patterns?: boolean;
+    /**
+     * Override the series colour ramp. Pass **already-resolved** colour strings
+     * (e.g. the live value of `var(--success)` sampled by the consumer) — these
+     * are handed straight to ApexCharts, which can't read CSS custom properties.
+     * When omitted, the theme bridge's `colors` ramp from `apexcharts-theme.ts`
+     * is used, so existing consumers are unaffected. Typical use: a single-arc
+     * `radialBar` gauge (e.g. BMI) that must change hue with the value —
+     * green in the healthy band, amber/red outside it.
+     */
+    colors?: string[];
     /** Show the ApexCharts toolbar. Defaults to false. */
     toolbar?: boolean;
     /** Locale override — defaults to the active i18next language. */

package/dist/components/chart/index.js

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

package/dist/components/cycle-calculator/cycle-calculator.d.ts

@@ -1,5 +1,5 @@
 import { type VariantProps } from 'class-variance-authority';
-import { type InsertPayload } from '../_shared/insert-result';
+import { type InsertPayload, type InsertVariant, type InsertMode } from '../_shared/insert-result';
 import { type CyclePrediction } from './cycle';
 declare const rootVariants: (props?: ({
     width?: "auto" | "full" | null | undefined;
@@ -9,8 +9,18 @@ export interface CycleCalculatorProps extends VariantProps<typeof rootVariants>
     defaultCycleLength?: number;
     /** Fires whenever a prediction can be computed (and `null` when it can't). */
     onResultChange?: (result: CyclePrediction | null) => void;
-    /** When provided, shows an "Insert" button that emits the result for an editor. */
+    /** When provided, shows the result-action buttons that emit / copy the result. */
     onInsert?: (payload: InsertPayload) => void;
+    /**
+     * Which verb the result button performs. Defaults to `'insert'`.
+     * Use `'copy'` in an app-shell surface (no editor to insert into) — the
+     * button writes the result to the clipboard as a multi-format `ClipboardItem`.
+     */
+    insertVariant?: InsertVariant;
+    /** `copy` variant only — fired after a successful clipboard write. */
+    onCopy?: (mode: InsertMode) => void;
+    /** `copy` variant only — fired if the clipboard write can't proceed. */
+    onError?: (error: unknown) => void;
     /** Opaque instance id, emitted as `data-component-id`. */
     id?: string;
     /** Extra class names on the wrapper. */

package/dist/components/cycle-calculator/index.js

@@ -1,4 +1,4 @@
-import { C as e, L as l, p as r } from "../../_chunks/cycle-calculator-B5Uj9QeT.js";
+import { C as e, L as l, p as r } from "../../_chunks/cycle-calculator-Dln-y1k_.js";
 export {
   e as CycleCalculator,
   l as LUTEAL_PHASE_DAYS,