@alfadocs/ui-kit 0.16.0 → 0.17.0

package/dist/components/copy-field/copy-field.d.ts

@@ -0,0 +1,50 @@
+import { type HTMLAttributes, type ReactNode } from 'react';
+import { type VariantProps } from 'class-variance-authority';
+declare const fieldVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+    disabled?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+declare const valueVariants: (props?: ({
+    intent?: "default" | "primary" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
+    wrap?: boolean | null | undefined;
+    hasStartIcon?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+type FieldSize = NonNullable<VariantProps<typeof fieldVariants>['size']>;
+type ValueIntent = NonNullable<VariantProps<typeof valueVariants>['intent']>;
+export interface CopyFieldProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'onCopy'> {
+    /** The value displayed in the read-only field and copied on click. */
+    value: string;
+    /** Field height + padding. Mirrors TextInput sizes. */
+    size?: FieldSize;
+    /**
+     * `primary` tints the value text with `--primary` — matches the
+     * link-style emphasis used by the telehealth showSession page.
+     */
+    intent?: ValueIntent;
+    /**
+     * Leading icon slot, decorative. Use `lucide-react` icons like
+     * `<Link2 />` for a URL, `<KeyRound />` for a token.
+     */
+    startIcon?: ReactNode;
+    /**
+     * `false` (default) truncates long values with ellipsis on a single
+     * line. `true` allows wrap with `overflow-wrap: anywhere`.
+     */
+    wrap?: boolean;
+    /** Override the default 'Copy' button label. */
+    copyLabel?: ReactNode;
+    /** Override the default 'Copied' success-state label. */
+    copiedLabel?: ReactNode;
+    /** Milliseconds before the button reverts to its default state. Default 2000. */
+    copiedDuration?: number;
+    /** ARIA label for the read-only textbox. Defaults to the i18n key. */
+    ariaLabel?: string;
+    /** Fires once after a successful clipboard write. */
+    onCopy?: (value: string) => void;
+    /** Greys both the field and the button; the button doesn't fire onCopy. */
+    disabled?: boolean;
+}
+export declare const CopyField: import("react").ForwardRefExoticComponent<CopyFieldProps & import("react").RefAttributes<HTMLDivElement>>;
+export {};
+//# sourceMappingURL=copy-field.d.ts.map

package/dist/components/copy-field/index.d.ts

@@ -0,0 +1,5 @@
+export { CopyField } from './copy-field';
+export type { CopyFieldProps } from './copy-field';
+export { copyFieldAgent } from './copy-field.agent';
+export type { CopyFieldHandle } from './copy-field.agent';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,6 @@
+import { C as p, c as a } from "../../_chunks/copy-field-BCHAZ8QV.js";
+export {
+  p as CopyField,
+  a as copyFieldAgent
+};
+//# sourceMappingURL=index.js.map

package/dist/components/index.d.ts

@@ -14,6 +14,7 @@ export * from './checkbox';
 export * from './checkbox-group';
 export * from './color-picker';
 export * from './combobox';
+export * from './copy-field';
 export * from './date-picker';
 export * from './date-range-picker';
 export * from './date-time-picker';

package/dist/components/navigation-menu/index.js

@@ -1,4 +1,4 @@
-import { N as i, a as t, b as e, c as o, d as g, e as s, f as u, g as v, n as M } from "../../_chunks/navigation-menu-Bav1d_wA.js";
+import { N as i, a as t, b as e, c as o, d as g, e as s, f as u, g as v, n as M } from "../../_chunks/navigation-menu-DdufF-_4.js";
 import { S as r } from "../../_chunks/skip-link-BaSMtPwB.js";
 export {
   i as NavigationMenu,

package/dist/components/pagination/index.js

@@ -1,4 +1,4 @@
-import { P as n, a as s, b as t, c as g, d as o, e as P, f as e, g as p, p as l } from "../../_chunks/pagination-OQBlnb1H.js";
+import { P as n, a as s, b as t, c as g, d as o, e as P, f as e, g as p, p as l } from "../../_chunks/pagination-F1ei4khE.js";
 export {
   n as Pagination,
   s as PaginationEllipsis,

package/dist/components/public-header/index.d.ts

@@ -1,3 +1,3 @@
-export { PublicHeader, type PublicHeaderHandle, type PublicHeaderProps, type PublicHeaderNavLinkProps, } from './public-header';
+export { PublicHeader, type PublicHeaderHandle, type PublicHeaderProps, type PublicHeaderNavLinkProps, type PublicHeaderNavDropdownProps, type PublicHeaderDropdownCardProps, type PublicHeaderDropdownLinkProps, } from './public-header';
 export { publicHeaderAgent } from './public-header.agent';
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/components/public-header/public-header.d.ts

@@ -32,12 +32,47 @@ export interface PublicHeaderNavLinkProps extends Omit<AnchorHTMLAttributes<HTML
     active?: boolean;
     children: ReactNode;
 }
+export interface PublicHeaderNavDropdownProps {
+    /** Trigger label (the visible nav item text). */
+    label: ReactNode;
+    /**
+     * `false` (default) renders a single-card dropdown anchored near the trigger
+     * (Settori-style). `true` renders a wide multi-card mega-menu spanning the
+     * pill's full inline width (Soluzioni-style).
+     */
+    wide?: boolean;
+    /** Cards / content inside the dropdown panel. */
+    children: ReactNode;
+    /** Optional id; not required — used only for analytics / test selectors. */
+    id?: string;
+}
+export interface PublicHeaderDropdownCardProps {
+    /**
+     * Optional href — when provided the card title becomes a clickable
+     * anchor with a `→` arrow indicator. Without href, the title is
+     * a static heading (Settori-style).
+     */
+    href?: string;
+    title: ReactNode;
+    /** Optional subtitle / muted helper text under the title. */
+    subtitle?: ReactNode;
+    /** Sub-list contents (typically PublicHeader.DropdownLink children). */
+    children?: ReactNode;
+}
+export interface PublicHeaderDropdownLinkProps extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'children'> {
+    href: string;
+    active?: boolean;
+    children: ReactNode;
+}
 declare const rootVariants: (props?: ({
-    variant?: "dark" | "default" | "transparent" | null | undefined;
+    variant?: "dark" | "default" | "pill" | "transparent" | null | undefined;
     sticky?: "none" | "top" | "scroll-up" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export declare const PublicHeader: import("react").ForwardRefExoticComponent<PublicHeaderProps & import("react").RefAttributes<HTMLElement>> & {
     NavLink: import("react").ForwardRefExoticComponent<PublicHeaderNavLinkProps & import("react").RefAttributes<HTMLAnchorElement>>;
+    NavDropdown: import("react").ForwardRefExoticComponent<PublicHeaderNavDropdownProps & import("react").RefAttributes<HTMLButtonElement>>;
+    DropdownCard: import("react").ForwardRefExoticComponent<PublicHeaderDropdownCardProps & import("react").RefAttributes<HTMLDivElement>>;
+    DropdownLink: import("react").ForwardRefExoticComponent<PublicHeaderDropdownLinkProps & import("react").RefAttributes<HTMLAnchorElement>>;
 };
 export {};
 //# sourceMappingURL=public-header.d.ts.map

package/dist/hooks/use-controllable-state.d.ts

@@ -0,0 +1,10 @@
+export interface UseControllableStateOptions<T> {
+    /** Controlled value. When defined, the hook is in controlled mode. */
+    value?: T;
+    /** Initial state when uncontrolled. Ignored once `value` is set.  */
+    defaultValue?: T;
+    /** Fires on every write — controlled callers must apply it.       */
+    onChange?: (next: T) => void;
+}
+export declare function useControllableState<T>({ value, defaultValue, onChange, }: UseControllableStateOptions<T>): [T | undefined, (next: T) => void];
+//# sourceMappingURL=use-controllable-state.d.ts.map

package/dist/hooks/use-copy-to-clipboard.d.ts

@@ -0,0 +1,45 @@
+export type CopyStatus = 'idle' | 'copied' | 'error';
+export interface UseCopyToClipboardOptions {
+    /**
+     * Auto-reset to `'idle'` this many ms after a successful copy. Pass
+     * `0` to disable auto-reset (caller drives the lifecycle). @default 2000
+     */
+    resetAfterMs?: number;
+    /**
+     * Override the underlying clipboard writer. When omitted the hook
+     * uses `navigator.clipboard.writeText`. Pass your own writer to add
+     * a legacy `document.execCommand('copy')` fallback for non-HTTPS
+     * contexts, or to instrument the call for telemetry. Must resolve
+     * `true` on success, `false` on failure (do not throw).
+     */
+    writer?: (value: string) => Promise<boolean>;
+}
+export interface UseCopyToClipboardReturn {
+    /** Current status. `'idle'` until the first `copy()` call. */
+    status: CopyStatus;
+    /** Last value successfully copied, or `null`. */
+    copiedValue: string | null;
+    /** Copy `value` to the clipboard. Returns `true` on success. */
+    copy: (value: string) => Promise<boolean>;
+    /** Reset to `'idle'` immediately. */
+    reset: () => void;
+}
+/**
+ * Copy a string to the system clipboard with status tracking.
+ *
+ * Uses `navigator.clipboard.writeText` (https-only / focus-required, but
+ * universally available in modern browsers). Falls back gracefully —
+ * `copy()` returns `false` and sets `status: 'error'` when the Clipboard
+ * API is unavailable or the call rejects.
+ *
+ * Status auto-resets to `'idle'` after `resetAfterMs` ms by default so
+ * the common "show ✓ for 2s after click" UX has zero glue code.
+ *
+ * @example
+ *   const { status, copy } = useCopyToClipboard();
+ *   <Button onClick={() => copy(value)}>
+ *     {status === 'copied' ? 'Copied!' : 'Copy'}
+ *   </Button>
+ */
+export declare function useCopyToClipboard(options?: UseCopyToClipboardOptions): UseCopyToClipboardReturn;
+//# sourceMappingURL=use-copy-to-clipboard.d.ts.map

package/dist/i18n/config.js

@@ -53,6 +53,13 @@ const a = {
     vatNumberLabel: "VAT no.:",
     phoneLabel: "Phone:"
   },
+  copyField: {
+    copy: "Copy",
+    copied: "Copied",
+    valueLabel: "Value to copy",
+    copySuccess: "Copied to clipboard",
+    copyFailed: "Copy failed"
+  },
   inputs: {
     switch: {
       on: "On",
@@ -1068,6 +1075,13 @@ const a = {
     vatNumberLabel: "P. IVA:",
     phoneLabel: "Telefono:"
   },
+  copyField: {
+    copy: "Copia",
+    copied: "Copiato",
+    valueLabel: "Valore da copiare",
+    copySuccess: "Copiato negli appunti",
+    copyFailed: "Copia non riuscita"
+  },
   inputs: {
     switch: {
       on: "Attivo",
@@ -2049,6 +2063,13 @@ const a = {
     vatNumberLabel: "USt-IdNr.:",
     phoneLabel: "Telefon:"
   },
+  copyField: {
+    copy: "Kopieren",
+    copied: "Kopiert",
+    valueLabel: "Wert zum Kopieren",
+    copySuccess: "In Zwischenablage kopiert",
+    copyFailed: "Kopieren fehlgeschlagen"
+  },
   inputs: {
     switch: {
       on: "An",

package/dist/i18n/resources.d.ts

@@ -51,6 +51,13 @@ export declare const enUi: {
         readonly vatNumberLabel: "VAT no.:";
         readonly phoneLabel: "Phone:";
     };
+    readonly copyField: {
+        readonly copy: "Copy";
+        readonly copied: "Copied";
+        readonly valueLabel: "Value to copy";
+        readonly copySuccess: "Copied to clipboard";
+        readonly copyFailed: "Copy failed";
+    };
     readonly inputs: {
         readonly switch: {
             readonly on: "On";
@@ -1082,6 +1089,13 @@ export declare const itUi: {
         readonly vatNumberLabel: "P. IVA:";
         readonly phoneLabel: "Telefono:";
     };
+    readonly copyField: {
+        readonly copy: "Copia";
+        readonly copied: "Copiato";
+        readonly valueLabel: "Valore da copiare";
+        readonly copySuccess: "Copiato negli appunti";
+        readonly copyFailed: "Copia non riuscita";
+    };
     readonly inputs: {
         readonly switch: {
             readonly on: "Attivo";
@@ -2088,6 +2102,13 @@ export declare const deUi: {
         readonly vatNumberLabel: "USt-IdNr.:";
         readonly phoneLabel: "Telefon:";
     };
+    readonly copyField: {
+        readonly copy: "Kopieren";
+        readonly copied: "Kopiert";
+        readonly valueLabel: "Wert zum Kopieren";
+        readonly copySuccess: "In Zwischenablage kopiert";
+        readonly copyFailed: "Kopieren fehlgeschlagen";
+    };
     readonly inputs: {
         readonly switch: {
             readonly on: "An";