@alfadocs/ui-kit 0.85.0 → 0.86.0

package/dist/_chunks/info-tip-Bxk3w6UM.js

@@ -0,0 +1,166 @@
+import { jsxs as u, jsx as i } from "react/jsx-runtime";
+import { forwardRef as I, useState as O, useRef as m, useEffect as k, useMemo as z } from "react";
+import { c as C } from "./index-D2ZczOXr.js";
+import { useTranslation as D } from "react-i18next";
+import { P as o } from "./popover-Cc0a69sw.js";
+import { u as P } from "./registry-DvAUVLHh.js";
+import { I as A } from "./info-CGn22peZ.js";
+const R = {
+  id: "info-tip",
+  capabilities: ["open", "close"],
+  state: {
+    isOpen: {
+      type: "boolean",
+      descriptionKey: "ui.agent.infoTip.state.isOpen",
+      description: "True when the info tip card is currently open.",
+      read: (t) => t.getIsOpen()
+    }
+  },
+  actions: {
+    open: {
+      safety: "read",
+      idempotent: !0,
+      descriptionKey: "ui.agent.infoTip.actions.open",
+      description: "Open the info tip card.",
+      invoke: (t) => {
+        t.open();
+      }
+    },
+    close: {
+      safety: "read",
+      idempotent: !0,
+      descriptionKey: "ui.agent.infoTip.actions.close",
+      description: "Close the info tip card.",
+      invoke: (t) => {
+        t.close();
+      }
+    }
+  },
+  domHooks: {
+    root: {
+      attr: "data-component",
+      value: "info-tip",
+      description: "Marks the InfoTip trigger button."
+    },
+    instanceId: {
+      attr: "data-component-id",
+      sourceProp: "id",
+      description: "Sourced from the id prop on InfoTip."
+    }
+  }
+}, S = C(
+  [
+    "ds:relative ds:inline-flex ds:shrink-0 ds:items-center ds:justify-center",
+    "ds:rounded-[var(--radius-full)]",
+    "ds:bg-[var(--card)]",
+    "ds:text-[var(--accent)]",
+    // Single ring: the Lucide Info glyph draws its own accent circle, so the
+    // trigger carries NO CSS border of its own (a border would read as a
+    // second, concentric ring). The white circle comes from `bg-card` showing
+    // through the glyph, lifted by the drop shadow.
+    "ds:shadow-[var(--shadow-sm)]",
+    "ds:cursor-pointer",
+    "ds:transition-[color,box-shadow] ds:motion-reduce:transition-none",
+    "ds:hover:text-[var(--accent-hover)] ds:hover:shadow-[var(--shadow-md)]",
+    "ds:data-[state=open]:text-[var(--accent-hover)] ds:data-[state=open]:shadow-[var(--shadow-md)]",
+    "ds:focus-visible:outline-[length:var(--focus-ring-width)] ds:focus-visible:outline-solid ds:focus-visible:outline-ring ds:focus-visible:outline-offset-[length:var(--focus-ring-offset)]",
+    "ds:forced-colors:focus-visible:outline-[CanvasText]"
+  ].join(" "),
+  {
+    variants: {
+      size: {
+        // Both diameters sit below `--min-target-size` (44/48px), so each
+        // re-uses IconButton's invisible `::before` hit-area expansion to a
+        // full touch target on touch / small screens. From the `sm:`
+        // breakpoint up the pointer is precise, so the expansion relaxes —
+        // but the interactive target must never fall below WCAG 2.5.8's 24px:
+        //   • md (24px visual) already meets the 24px floor, so its `::before`
+        //     is hidden on desktop and the 24px circle IS the target.
+        //   • sm (20px visual) would fall to 20px if hidden — below the floor
+        //     — so instead of hiding, its `::before` shrinks to a persistent
+        //     `--spacing-lg` (24px) minimum that holds on desktop too.
+        sm: 'ds:w-5 ds:h-5 ds:before:absolute ds:before:inset-x-[calc((var(--min-target-size)-100%)/-2)] ds:before:inset-y-[calc((var(--min-target-size)-100%)/-2)] ds:before:content-[""] ds:sm:before:inset-x-[calc((var(--spacing-lg)-100%)/-2)] ds:sm:before:inset-y-[calc((var(--spacing-lg)-100%)/-2)]',
+        md: 'ds:w-6 ds:h-6 ds:before:absolute ds:before:inset-x-[calc((var(--min-target-size)-100%)/-2)] ds:before:inset-y-[calc((var(--min-target-size)-100%)/-2)] ds:before:content-[""] ds:sm:before:hidden'
+      }
+    },
+    defaultVariants: {
+      size: "md"
+    }
+  }
+), j = I(
+  ({
+    content: t,
+    heading: r,
+    size: a = "md",
+    side: v = "top",
+    align: g = "center",
+    "aria-label": h,
+    id: l,
+    className: b
+  }, w) => {
+    const { t: y } = D(), [s, d] = O(!1), n = m(s);
+    k(() => {
+      n.current = s;
+    }, [s]);
+    const T = z(
+      () => ({
+        getIsOpen: () => n.current,
+        open: () => d(!0),
+        close: () => d(!1)
+      }),
+      []
+    );
+    P(R, T, l);
+    const c = m(null), p = () => {
+      c.current = n.current;
+    }, f = h ?? y("infoTip.triggerLabel", "More information");
+    return /* @__PURE__ */ u(o, { openOn: "hover-or-click", open: s, onOpenChange: d, children: [
+      /* @__PURE__ */ i(
+        o.Trigger,
+        {
+          ref: w,
+          "aria-label": f,
+          className: S({ size: a, className: b }),
+          "data-component": "info-tip",
+          "data-component-id": l,
+          onPointerDown: p,
+          onKeyDown: (e) => {
+            (e.key === "Enter" || e.key === " ") && p();
+          },
+          onClick: (e) => {
+            const x = c.current;
+            c.current = null, x === !1 && n.current && e.preventDefault();
+          },
+          children: /* @__PURE__ */ i(
+            A,
+            {
+              "aria-hidden": "true",
+              className: a === "sm" ? "ds:size-5" : "ds:size-6"
+            }
+          )
+        }
+      ),
+      /* @__PURE__ */ u(
+        o.Content,
+        {
+          side: v,
+          align: g,
+          size: a === "sm" ? "sm" : "md",
+          "aria-label": r == null ? f : void 0,
+          onOpenAutoFocus: (e) => e.preventDefault(),
+          onCloseAutoFocus: (e) => e.preventDefault(),
+          children: [
+            r != null && /* @__PURE__ */ i(o.Heading, { children: r }),
+            /* @__PURE__ */ i(o.Description, { children: t })
+          ]
+        }
+      )
+    ] });
+  }
+);
+j.displayName = "InfoTip";
+export {
+  j as I,
+  R as i
+};
+//# sourceMappingURL=info-tip-Bxk3w6UM.js.map

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "0.85.0",
+  "packageVersion": "0.86.0",
   "components": [
     {
       "kind": "component",
@@ -5585,6 +5585,50 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "info-tip",
+      "capabilities": [
+        "open",
+        "close"
+      ],
+      "state": [
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "True when the info tip card is currently open.",
+          "descriptionKey": "ui.agent.infoTip.state.isOpen"
+        }
+      ],
+      "actions": [
+        {
+          "name": "open",
+          "safety": "read",
+          "idempotent": true,
+          "description": "Open the info tip card.",
+          "descriptionKey": "ui.agent.infoTip.actions.open"
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "idempotent": true,
+          "description": "Close the info tip card.",
+          "descriptionKey": "ui.agent.infoTip.actions.close"
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "info-tip",
+          "description": "Marks the InfoTip trigger button."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop on InfoTip."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "kbd",

package/dist/agent-i18n/en.json

@@ -585,6 +585,15 @@
         "reset": "Reset the crop to the centred default for the current aspect."
       }
     },
+    "infoTip": {
+      "state": {
+        "isOpen": "True when the info tip card is currently open."
+      },
+      "actions": {
+        "open": "Open the info tip card.",
+        "close": "Close the info tip card."
+      }
+    },
     "list": {
       "state": {
         "selection": "Ids of currently-selected list items. Empty array when none selected or list is presentational."

package/dist/components/index.d.ts

@@ -117,6 +117,7 @@ export * from './appointment-timeline';
 export * from './dialog';
 export * from './dropdown-menu';
 export * from './finished-terminal';
+export * from './info-tip';
 export * from './live-region';
 export * from './matrix-rain';
 export * from './message-card';

package/dist/components/info-tip/index.d.ts

@@ -0,0 +1,4 @@
+export { InfoTip } from './info-tip';
+export type { InfoTipProps, InfoTipHandle } from './info-tip';
+export { infoTipAgent } from './info-tip.agent';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/info-tip/index.js

@@ -0,0 +1,6 @@
+import { I as f, i as n } from "../../_chunks/info-tip-Bxk3w6UM.js";
+export {
+  f as InfoTip,
+  n as infoTipAgent
+};
+//# sourceMappingURL=index.js.map

package/dist/components/info-tip/info-tip.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { InfoTipHandle } from './info-tip';
+export declare const infoTipAgent: AgentAdapter<InfoTipHandle>;
+//# sourceMappingURL=info-tip.agent.d.ts.map

package/dist/components/info-tip/info-tip.d.ts

@@ -0,0 +1,42 @@
+import { type ReactNode } from 'react';
+export interface InfoTipHandle {
+    getIsOpen: () => boolean;
+    open: () => void;
+    close: () => void;
+}
+export interface InfoTipProps {
+    /** Body of the tip — explanatory text shown in the floating card. */
+    content: ReactNode;
+    /** Optional heading rendered above the body. */
+    heading?: ReactNode;
+    /**
+     * Trigger diameter. Also maps the floating card width:
+     * `sm` → `--popover-size-sm`, `md` → `--popover-size-md`.
+     */
+    size?: 'sm' | 'md';
+    /** Logical side the card opens on. Default `'top'`. */
+    side?: 'start' | 'top' | 'end' | 'bottom';
+    /** Alignment along the side axis. Default `'center'`. */
+    align?: 'start' | 'center' | 'end';
+    /**
+     * Accessible name for the trigger. Defaults to the translated
+     * "More information" chrome string.
+     */
+    'aria-label'?: string;
+    /**
+     * Opaque instance id — emitted as `data-component-id` on the trigger and
+     * used to register the instance with the host agent registry.
+     */
+    id?: string;
+    /** Extra classes merged onto the trigger button. */
+    className?: string;
+}
+/**
+ * InfoTip — a deliberate, branded "more information" affordance: a small
+ * circular trigger that reveals an explanatory card on hover **and** click
+ * (click also serves touch devices). Composes the kit Popover in
+ * `openOn="hover-or-click"` mode — hover intent, keyboard focus, Escape and
+ * focus-return are all handled by the Popover/Radix layer.
+ */
+export declare const InfoTip: import("react").ForwardRefExoticComponent<InfoTipProps & import("react").RefAttributes<HTMLButtonElement>>;
+//# sourceMappingURL=info-tip.d.ts.map

package/dist/i18n/locales/ar.d.ts

@@ -6,6 +6,9 @@
  * Domain: AlfaDocs dental practice management software.
  */
 export declare const arUi: {
+    readonly infoTip: {
+        readonly triggerLabel: "مزيد من المعلومات";
+    };
     readonly opticalPrescription: {
         readonly ariaLabel: "وصفة النظارات";
         readonly metaLabel: "تفاصيل الوصفة";

package/dist/i18n/locales/ar.js

@@ -1,4 +1,7 @@
 const e = {
+  infoTip: {
+    triggerLabel: "مزيد من المعلومات"
+  },
   opticalPrescription: {
     ariaLabel: "وصفة النظارات",
     metaLabel: "تفاصيل الوصفة",

package/dist/i18n/locales/de.d.ts

@@ -6,6 +6,9 @@
  * for AlfaDocs terminology consistency.
  */
 export declare const deUi: {
+    readonly infoTip: {
+        readonly triggerLabel: "Weitere Informationen";
+    };
     readonly opticalPrescription: {
         readonly ariaLabel: "Brillenrezept";
         readonly metaLabel: "Rezeptdetails";

package/dist/i18n/locales/de.js

@@ -1,4 +1,7 @@
 const e = {
+  infoTip: {
+    triggerLabel: "Weitere Informationen"
+  },
   opticalPrescription: {
     ariaLabel: "Brillenrezept",
     metaLabel: "Rezeptdetails",

package/dist/i18n/locales/el.d.ts

@@ -3,6 +3,9 @@
  * Machine-translated from canonical Italian — needs professional review.
  */
 export declare const elUi: {
+    readonly infoTip: {
+        readonly triggerLabel: "Περισσότερες πληροφορίες";
+    };
     readonly opticalPrescription: {
         readonly ariaLabel: "Συνταγή γυαλιών";
         readonly metaLabel: "Στοιχεία συνταγής";

package/dist/i18n/locales/el.js

@@ -1,4 +1,7 @@
 const e = {
+  infoTip: {
+    triggerLabel: "Περισσότερες πληροφορίες"
+  },
   opticalPrescription: {
     ariaLabel: "Συνταγή γυαλιών",
     metaLabel: "Στοιχεία συνταγής",

package/dist/i18n/locales/en.d.ts

@@ -3,6 +3,9 @@
  * Loaded eagerly by config.ts (default locale). All other locales are
  * lazy-loaded via dynamic import — see config.ts + LOADERS map. */
 export declare const enUi: {
+    readonly infoTip: {
+        readonly triggerLabel: "More information";
+    };
     readonly opticalPrescription: {
         readonly ariaLabel: "Glasses prescription";
         readonly metaLabel: "Prescription details";

package/dist/i18n/locales/en.js

@@ -1,4 +1,7 @@
 const e = {
+  infoTip: {
+    triggerLabel: "More information"
+  },
   opticalPrescription: {
     ariaLabel: "Glasses prescription",
     metaLabel: "Prescription details",

package/dist/i18n/locales/es.d.ts

@@ -3,6 +3,9 @@
  * Machine-translated from canonical Italian — needs professional review.
  */
 export declare const esUi: {
+    readonly infoTip: {
+        readonly triggerLabel: "Más información";
+    };
     readonly opticalPrescription: {
         readonly ariaLabel: "Prescripción de gafas";
         readonly metaLabel: "Detalles de la prescripción";

package/dist/i18n/locales/es.js

@@ -1,4 +1,7 @@
 const e = {
+  infoTip: {
+    triggerLabel: "Más información"
+  },
   opticalPrescription: {
     ariaLabel: "Prescripción de gafas",
     metaLabel: "Detalles de la prescripción",

package/dist/i18n/locales/fr.d.ts

@@ -3,6 +3,9 @@
  * Machine-translated from canonical Italian — needs professional review.
  */
 export declare const frUi: {
+    readonly infoTip: {
+        readonly triggerLabel: "Plus d'informations";
+    };
     readonly opticalPrescription: {
         readonly ariaLabel: "Prescription de lunettes";
         readonly metaLabel: "Détails de la prescription";

package/dist/i18n/locales/fr.js

@@ -1,4 +1,7 @@
 const e = {
+  infoTip: {
+    triggerLabel: "Plus d'informations"
+  },
   opticalPrescription: {
     ariaLabel: "Prescription de lunettes",
     metaLabel: "Détails de la prescription",

package/dist/i18n/locales/hi.d.ts

@@ -3,6 +3,9 @@
  * Machine-translated from canonical Italian — needs professional review.
  */
 export declare const hiUi: {
+    readonly infoTip: {
+        readonly triggerLabel: "अधिक जानकारी";
+    };
     readonly opticalPrescription: {
         readonly ariaLabel: "चश्मे का नुस्खा";
         readonly metaLabel: "नुस्खे का विवरण";

package/dist/i18n/locales/hi.js

@@ -1,4 +1,7 @@
 const e = {
+  infoTip: {
+    triggerLabel: "अधिक जानकारी"
+  },
   opticalPrescription: {
     ariaLabel: "चश्मे का नुस्खा",
     metaLabel: "नुस्खे का विवरण",

package/dist/i18n/locales/it.d.ts

@@ -1,5 +1,8 @@
 /** Italian (it) ui resources. Canonical source for the bundle. Lazy-loaded. */
 export declare const itUi: {
+    readonly infoTip: {
+        readonly triggerLabel: "Maggiori informazioni";
+    };
     readonly opticalPrescription: {
         readonly ariaLabel: "Prescrizione per occhiali";
         readonly metaLabel: "Dettagli prescrizione";

package/dist/i18n/locales/it.js

@@ -1,4 +1,7 @@
 const e = {
+  infoTip: {
+    triggerLabel: "Maggiori informazioni"
+  },
   opticalPrescription: {
     ariaLabel: "Prescrizione per occhiali",
     metaLabel: "Dettagli prescrizione",

package/dist/i18n/locales/ja.d.ts

@@ -3,6 +3,9 @@
  * Machine-translated from canonical Italian — needs professional review.
  */
 export declare const jaUi: {
+    readonly infoTip: {
+        readonly triggerLabel: "詳細情報";
+    };
     readonly opticalPrescription: {
         readonly ariaLabel: "眼鏡処方";
         readonly metaLabel: "処方の詳細";

package/dist/i18n/locales/ja.js

@@ -1,4 +1,7 @@
 const e = {
+  infoTip: {
+    triggerLabel: "詳細情報"
+  },
   opticalPrescription: {
     ariaLabel: "眼鏡処方",
     metaLabel: "処方の詳細",

package/dist/i18n/locales/nl.d.ts

@@ -3,6 +3,9 @@
  * Machine-translated from canonical Italian — needs professional review.
  */
 export declare const nlUi: {
+    readonly infoTip: {
+        readonly triggerLabel: "Meer informatie";
+    };
     readonly opticalPrescription: {
         readonly ariaLabel: "Brilrecept";
         readonly metaLabel: "Receptgegevens";

package/dist/i18n/locales/nl.js

@@ -1,4 +1,7 @@
 const e = {
+  infoTip: {
+    triggerLabel: "Meer informatie"
+  },
   opticalPrescription: {
     ariaLabel: "Brilrecept",
     metaLabel: "Receptgegevens",

package/dist/i18n/locales/pl.d.ts

@@ -3,6 +3,9 @@
  * Machine-translated from canonical Italian — needs professional review.
  */
 export declare const plUi: {
+    readonly infoTip: {
+        readonly triggerLabel: "Więcej informacji";
+    };
     readonly opticalPrescription: {
         readonly ariaLabel: "Recepta na okulary";
         readonly metaLabel: "Szczegóły recepty";

package/dist/i18n/locales/pl.js

@@ -1,4 +1,7 @@
 const e = {
+  infoTip: {
+    triggerLabel: "Więcej informacji"
+  },
   opticalPrescription: {
     ariaLabel: "Recepta na okulary",
     metaLabel: "Szczegóły recepty",

package/dist/i18n/locales/pt.d.ts

@@ -4,6 +4,9 @@
  * Variant: European Portuguese.
  */
 export declare const ptUi: {
+    readonly infoTip: {
+        readonly triggerLabel: "Mais informações";
+    };
     readonly opticalPrescription: {
         readonly ariaLabel: "Prescrição de óculos";
         readonly metaLabel: "Detalhes da prescrição";

package/dist/i18n/locales/pt.js

@@ -1,4 +1,7 @@
 const e = {
+  infoTip: {
+    triggerLabel: "Mais informações"
+  },
   opticalPrescription: {
     ariaLabel: "Prescrição de óculos",
     metaLabel: "Detalhes da prescrição",

package/dist/i18n/locales/ro.d.ts

@@ -3,6 +3,9 @@
  * Machine-translated from canonical Italian — needs professional review.
  */
 export declare const roUi: {
+    readonly infoTip: {
+        readonly triggerLabel: "Mai multe informații";
+    };
     readonly opticalPrescription: {
         readonly ariaLabel: "Rețetă pentru ochelari";
         readonly metaLabel: "Detalii rețetă";

package/dist/i18n/locales/ro.js

@@ -1,4 +1,7 @@
 const e = {
+  infoTip: {
+    triggerLabel: "Mai multe informații"
+  },
   opticalPrescription: {
     ariaLabel: "Rețetă pentru ochelari",
     metaLabel: "Detalii rețetă",

package/dist/i18n/locales/ru.d.ts

@@ -3,6 +3,9 @@
  * Machine-translated from canonical Italian — needs professional review.
  */
 export declare const ruUi: {
+    readonly infoTip: {
+        readonly triggerLabel: "Дополнительная информация";
+    };
     readonly opticalPrescription: {
         readonly ariaLabel: "Рецепт на очки";
         readonly metaLabel: "Сведения о рецепте";

package/dist/i18n/locales/ru.js

@@ -1,4 +1,7 @@
 const e = {
+  infoTip: {
+    triggerLabel: "Дополнительная информация"
+  },
   opticalPrescription: {
     ariaLabel: "Рецепт на очки",
     metaLabel: "Сведения о рецепте",

package/dist/i18n/locales/sq.d.ts

@@ -3,6 +3,9 @@
  * Machine-translated from canonical Italian — needs professional review.
  */
 export declare const sqUi: {
+    readonly infoTip: {
+        readonly triggerLabel: "Më shumë informacion";
+    };
     readonly opticalPrescription: {
         readonly ariaLabel: "Recetë për syze";
         readonly metaLabel: "Detajet e recetës";

package/dist/i18n/locales/sq.js

@@ -1,4 +1,7 @@
 const e = {
+  infoTip: {
+    triggerLabel: "Më shumë informacion"
+  },
   opticalPrescription: {
     ariaLabel: "Recetë për syze",
     metaLabel: "Detajet e recetës",

package/dist/i18n/locales/sv.d.ts

@@ -3,6 +3,9 @@
  * Machine-translated from canonical Italian — needs professional review.
  */
 export declare const svUi: {
+    readonly infoTip: {
+        readonly triggerLabel: "Mer information";
+    };
     readonly opticalPrescription: {
         readonly ariaLabel: "Glasögonrecept";
         readonly metaLabel: "Receptuppgifter";

package/dist/i18n/locales/sv.js

@@ -1,4 +1,7 @@
 const e = {
+  infoTip: {
+    triggerLabel: "Mer information"
+  },
   opticalPrescription: {
     ariaLabel: "Glasögonrecept",
     metaLabel: "Receptuppgifter",

package/dist/i18n/locales/tr.d.ts

@@ -3,6 +3,9 @@
  * Machine-translated from canonical Italian — needs professional review.
  */
 export declare const trUi: {
+    readonly infoTip: {
+        readonly triggerLabel: "Daha fazla bilgi";
+    };
     readonly opticalPrescription: {
         readonly ariaLabel: "Gözlük reçetesi";
         readonly metaLabel: "Reçete ayrıntıları";

package/dist/i18n/locales/tr.js

@@ -1,4 +1,7 @@
 const e = {
+  infoTip: {
+    triggerLabel: "Daha fazla bilgi"
+  },
   opticalPrescription: {
     ariaLabel: "Gözlük reçetesi",
     metaLabel: "Reçete ayrıntıları",