@nucleux/caveat 0.0.0-stage → 0.6.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nucleux
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,40 @@
-# Temporary Holding Version
+# @nucleux/caveat
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Caveat — says what is incomplete, uncertain or out of date about an AI result — Nucleux agentic UI for React.
+
+Part of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** — agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).
+
+## Exports
+
+- **`Caveat`** — a calm reminder that AI output can be wrong, or (better) the specific limitation of this result. `variant`: `below-input` (default caption under the composer) / `output-footer` (filled note under output that will be acted on); `icon` (`null` to omit); `actions` (next steps such as "Review sources"). Rendered as `role="note"`.
+- **`CaveatTooltip`** — the `info-tooltip` variant: wraps the generate control (e.g. `Iconography`), shows the caveat on hover and focus, and links it with `aria-describedby`. `content`, `side`, `showIcon`.
+
+Caption-size, muted, never alarming or apologetic; once per surface, repeated only where output will be acted on.
+
+## Install
+
+```bash
+pnpm add @nucleux/caveat @nucleux/tokens
+```
+
+`react` / `react-dom` are peer dependencies.
+
+## Usage
+
+```tsx
+import { Caveat, CaveatTooltip } from "@nucleux/caveat";
+import { Iconography } from "@nucleux/iconography";
+
+<Caveat>Aria may make mistakes. Verify important info.</Caveat>
+<Caveat variant="output-footer" actions={<Button size="sm" variant="ghost">Review sources</Button>}>
+  2 of 8 interviews could not be opened, so this summary reflects 6.
+</Caveat>
+<CaveatTooltip content="Output may be inaccurate"><Iconography label="Generate" /></CaveatTooltip>
+```
+
+Requires the theme once in your app: `import "@nucleux/tokens/styles.css";`
+and the Tailwind preset from `@nucleux/tokens/preset`.
+
+## License
+
+MIT © Nucleux

package/dist/index.cjs

@@ -0,0 +1,81 @@
+"use client";
+'use strict';
+
+var React = require('react');
+var lucideReact = require('lucide-react');
+var utils = require('@nucleux/utils');
+var tooltip = require('@nucleux/tooltip');
+var jsxRuntime = require('react/jsx-runtime');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var React__namespace = /*#__PURE__*/_interopNamespace(React);
+
+// src/index.tsx
+var DEFAULT_TEXT = "AI can make mistakes. Verify important information.";
+var Caveat = React__namespace.forwardRef(
+  ({ variant = "below-input", icon, actions, className, children, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsxs(
+    "p",
+    {
+      ref,
+      role: "note",
+      "data-variant": variant,
+      className: utils.cn(
+        "items-center gap-1.5 text-xs text-muted-foreground [&_svg]:size-3.5 [&_svg]:shrink-0",
+        variant === "output-footer" ? "mt-2.5 flex w-full flex-wrap rounded-md border border-border bg-muted/60 px-2.5 py-2 text-foreground/80" : "inline-flex",
+        className
+      ),
+      ...props,
+      children: [
+        icon === void 0 ? /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Info, { "aria-hidden": "true" }) : icon,
+        /* @__PURE__ */ jsxRuntime.jsx("span", { children: children ?? DEFAULT_TEXT }),
+        actions && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "ml-auto inline-flex flex-wrap items-center gap-1.5", children: actions })
+      ]
+    }
+  )
+);
+Caveat.displayName = "Caveat";
+var CaveatTooltip = React__namespace.forwardRef(
+  ({ content = "Output may be inaccurate", side = "top", showIcon = true, children, ...props }, ref) => {
+    const id = React__namespace.useId();
+    const childProps = children.props;
+    const trigger = React__namespace.cloneElement(children, {
+      "aria-describedby": [childProps["aria-describedby"], id].filter(Boolean).join(" ")
+    });
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      tooltip.Tooltip,
+      {
+        ref,
+        side,
+        content: /* @__PURE__ */ jsxRuntime.jsxs("span", { id, className: "inline-flex items-center gap-1.5 [&_svg]:size-3", children: [
+          showIcon && /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Info, { "aria-hidden": "true" }),
+          content
+        ] }),
+        ...props,
+        children: trigger
+      }
+    );
+  }
+);
+CaveatTooltip.displayName = "CaveatTooltip";
+
+exports.Caveat = Caveat;
+exports.CaveatTooltip = CaveatTooltip;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":["React","jsxs","cn","jsx","Info","Tooltip"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,IAAM,YAAA,GAAe,qDAAA;AAUd,IAAM,MAAA,GAAeA,gBAAA,CAAA,UAAA;AAAA,EAC1B,CAAC,EAAE,OAAA,GAAU,aAAA,EAAe,IAAA,EAAM,OAAA,EAAS,SAAA,EAAW,QAAA,EAAU,GAAG,KAAA,EAAM,EAAG,GAAA,qBAC1EC,eAAA;AAAA,IAAC,GAAA;AAAA,IAAA;AAAA,MACC,GAAA;AAAA,MACA,IAAA,EAAK,MAAA;AAAA,MACL,cAAA,EAAc,OAAA;AAAA,MACd,SAAA,EAAWC,QAAA;AAAA,QACT,sFAAA;AAAA,QACA,OAAA,KAAY,kBACR,yGAAA,GACA,aAAA;AAAA,QACJ;AAAA,OACF;AAAA,MACC,GAAG,KAAA;AAAA,MAEH,QAAA,EAAA;AAAA,QAAA,IAAA,KAAS,MAAA,mBAAYC,cAAA,CAACC,gBAAA,EAAA,EAAK,aAAA,EAAY,QAAO,CAAA,GAAK,IAAA;AAAA,wBACpDD,cAAA,CAAC,MAAA,EAAA,EAAM,QAAA,EAAA,QAAA,IAAY,YAAA,EAAa,CAAA;AAAA,QAC/B,OAAA,oBAAWA,cAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,sDAAsD,QAAA,EAAA,OAAA,EAAQ;AAAA;AAAA;AAAA;AAGhG;AACA,MAAA,CAAO,WAAA,GAAc,QAAA;AAkBd,IAAM,aAAA,GAAsBH,gBAAA,CAAA,UAAA;AAAA,EACjC,CAAC,EAAE,OAAA,GAAU,0BAAA,EAA4B,IAAA,GAAO,KAAA,EAAO,QAAA,GAAW,IAAA,EAAM,QAAA,EAAU,GAAG,KAAA,EAAM,EAAG,GAAA,KAAQ;AACpG,IAAA,MAAM,KAAWA,gBAAA,CAAA,KAAA,EAAM;AACvB,IAAA,MAAM,aAAa,QAAA,CAAS,KAAA;AAC5B,IAAA,MAAM,OAAA,GAAgBA,8BAAa,QAAA,EAAU;AAAA,MAC3C,kBAAA,EAAoB,CAAC,UAAA,CAAW,kBAAkB,CAAA,EAAG,EAAE,CAAA,CAAE,MAAA,CAAO,OAAO,CAAA,CAAE,IAAA,CAAK,GAAG;AAAA,KACvD,CAAA;AAC5B,IAAA,uBACEG,cAAA;AAAA,MAACE,eAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,IAAA;AAAA,QACA,OAAA,kBACEJ,eAAA,CAAC,MAAA,EAAA,EAAK,EAAA,EAAQ,WAAU,iDAAA,EACrB,QAAA,EAAA;AAAA,UAAA,QAAA,oBAAYE,cAAA,CAACC,gBAAA,EAAA,EAAK,aAAA,EAAY,MAAA,EAAO,CAAA;AAAA,UACrC;AAAA,SAAA,EACH,CAAA;AAAA,QAED,GAAG,KAAA;AAAA,QAEH,QAAA,EAAA;AAAA;AAAA,KACH;AAAA,EAEJ;AACF;AACA,aAAA,CAAc,WAAA,GAAc,eAAA","file":"index.cjs","sourcesContent":["import * as React from \"react\";\nimport { Info } from \"lucide-react\";\nimport { cn } from \"@nucleux/utils\";\nimport { Tooltip, type TooltipSide } from \"@nucleux/tooltip\";\n\n/**\n * Where the caveat sits.\n * - `below-input` — a quiet caption under the composer, seen before anything is sent (default).\n * - `output-footer` — a filled note under output that will be acted on (sent, published,\n *   deployed); can carry next steps in `actions`.\n * For the third spec variant, `info-tooltip`, wrap the generate control in `CaveatTooltip`.\n */\nexport type CaveatVariant = \"below-input\" | \"output-footer\";\n\nexport interface CaveatProps extends React.HTMLAttributes<HTMLParagraphElement> {\n  /** Placement style. Default `below-input`. */\n  variant?: CaveatVariant;\n  /** Leading icon. Defaults to an info glyph. Pass `null` to omit. */\n  icon?: React.ReactNode;\n  /**\n   * Next steps that remove the reason for the caveat — \"Review sources\",\n   * \"Reconnect\". Shown after the text; use small Buttons or links.\n   */\n  actions?: React.ReactNode;\n}\n\nconst DEFAULT_TEXT = \"AI can make mistakes. Verify important information.\";\n\n/**\n * A short, calm reminder that AI output can be wrong and should be checked —\n * or, better, the specific limitation of this result (\"2 of 8 interviews\n * could not be opened\"). Caption-size and muted, never alarming or\n * apologetic, once per surface. `below-input` sits under the composer;\n * `output-footer` sits under output that will be acted on and can offer\n * next steps. Rendered as a `note`.\n */\nexport const Caveat = React.forwardRef<HTMLParagraphElement, CaveatProps>(\n  ({ variant = \"below-input\", icon, actions, className, children, ...props }, ref) => (\n    <p\n      ref={ref}\n      role=\"note\"\n      data-variant={variant}\n      className={cn(\n        \"items-center gap-1.5 text-xs text-muted-foreground [&_svg]:size-3.5 [&_svg]:shrink-0\",\n        variant === \"output-footer\"\n          ? \"mt-2.5 flex w-full flex-wrap rounded-md border border-border bg-muted/60 px-2.5 py-2 text-foreground/80\"\n          : \"inline-flex\",\n        className,\n      )}\n      {...props}\n    >\n      {icon === undefined ? <Info aria-hidden=\"true\" /> : icon}\n      <span>{children ?? DEFAULT_TEXT}</span>\n      {actions && <span className=\"ml-auto inline-flex flex-wrap items-center gap-1.5\">{actions}</span>}\n    </p>\n  ),\n);\nCaveat.displayName = \"Caveat\";\n\nexport interface CaveatTooltipProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, \"content\"> {\n  /** The caveat. Default \"Output may be inaccurate\". */\n  content?: React.ReactNode;\n  /** Side of the trigger. Default `top`. */\n  side?: TooltipSide;\n  /** Show the info glyph in the tooltip. Default `true`. */\n  showIcon?: boolean;\n  /** The AI action the caveat rides on — a single focusable element (e.g. an `Iconography` or Button). */\n  children: React.ReactElement;\n}\n\n/**\n * The `info-tooltip` caveat: the reminder rides the generate control,\n * shown on hover and keyboard focus without ever being in the way, and\n * linked to the control with `aria-describedby` so screen readers hear it too.\n */\nexport const CaveatTooltip = React.forwardRef<HTMLSpanElement, CaveatTooltipProps>(\n  ({ content = \"Output may be inaccurate\", side = \"top\", showIcon = true, children, ...props }, ref) => {\n    const id = React.useId();\n    const childProps = children.props as { \"aria-describedby\"?: string };\n    const trigger = React.cloneElement(children, {\n      \"aria-describedby\": [childProps[\"aria-describedby\"], id].filter(Boolean).join(\" \"),\n    } as Record<string, unknown>);\n    return (\n      <Tooltip\n        ref={ref}\n        side={side}\n        content={\n          <span id={id} className=\"inline-flex items-center gap-1.5 [&_svg]:size-3\">\n            {showIcon && <Info aria-hidden=\"true\" />}\n            {content}\n          </span>\n        }\n        {...props}\n      >\n        {trigger}\n      </Tooltip>\n    );\n  },\n);\nCaveatTooltip.displayName = \"CaveatTooltip\";\n"]}

package/dist/index.d.cts

@@ -0,0 +1,49 @@
+import * as React from 'react';
+import { TooltipSide } from '@nucleux/tooltip';
+
+/**
+ * Where the caveat sits.
+ * - `below-input` — a quiet caption under the composer, seen before anything is sent (default).
+ * - `output-footer` — a filled note under output that will be acted on (sent, published,
+ *   deployed); can carry next steps in `actions`.
+ * For the third spec variant, `info-tooltip`, wrap the generate control in `CaveatTooltip`.
+ */
+type CaveatVariant = "below-input" | "output-footer";
+interface CaveatProps extends React.HTMLAttributes<HTMLParagraphElement> {
+    /** Placement style. Default `below-input`. */
+    variant?: CaveatVariant;
+    /** Leading icon. Defaults to an info glyph. Pass `null` to omit. */
+    icon?: React.ReactNode;
+    /**
+     * Next steps that remove the reason for the caveat — "Review sources",
+     * "Reconnect". Shown after the text; use small Buttons or links.
+     */
+    actions?: React.ReactNode;
+}
+/**
+ * A short, calm reminder that AI output can be wrong and should be checked —
+ * or, better, the specific limitation of this result ("2 of 8 interviews
+ * could not be opened"). Caption-size and muted, never alarming or
+ * apologetic, once per surface. `below-input` sits under the composer;
+ * `output-footer` sits under output that will be acted on and can offer
+ * next steps. Rendered as a `note`.
+ */
+declare const Caveat: React.ForwardRefExoticComponent<CaveatProps & React.RefAttributes<HTMLParagraphElement>>;
+interface CaveatTooltipProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, "content"> {
+    /** The caveat. Default "Output may be inaccurate". */
+    content?: React.ReactNode;
+    /** Side of the trigger. Default `top`. */
+    side?: TooltipSide;
+    /** Show the info glyph in the tooltip. Default `true`. */
+    showIcon?: boolean;
+    /** The AI action the caveat rides on — a single focusable element (e.g. an `Iconography` or Button). */
+    children: React.ReactElement;
+}
+/**
+ * The `info-tooltip` caveat: the reminder rides the generate control,
+ * shown on hover and keyboard focus without ever being in the way, and
+ * linked to the control with `aria-describedby` so screen readers hear it too.
+ */
+declare const CaveatTooltip: React.ForwardRefExoticComponent<CaveatTooltipProps & React.RefAttributes<HTMLSpanElement>>;
+
+export { Caveat, type CaveatProps, CaveatTooltip, type CaveatTooltipProps, type CaveatVariant };

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+import * as React from 'react';
+import { TooltipSide } from '@nucleux/tooltip';
+
+/**
+ * Where the caveat sits.
+ * - `below-input` — a quiet caption under the composer, seen before anything is sent (default).
+ * - `output-footer` — a filled note under output that will be acted on (sent, published,
+ *   deployed); can carry next steps in `actions`.
+ * For the third spec variant, `info-tooltip`, wrap the generate control in `CaveatTooltip`.
+ */
+type CaveatVariant = "below-input" | "output-footer";
+interface CaveatProps extends React.HTMLAttributes<HTMLParagraphElement> {
+    /** Placement style. Default `below-input`. */
+    variant?: CaveatVariant;
+    /** Leading icon. Defaults to an info glyph. Pass `null` to omit. */
+    icon?: React.ReactNode;
+    /**
+     * Next steps that remove the reason for the caveat — "Review sources",
+     * "Reconnect". Shown after the text; use small Buttons or links.
+     */
+    actions?: React.ReactNode;
+}
+/**
+ * A short, calm reminder that AI output can be wrong and should be checked —
+ * or, better, the specific limitation of this result ("2 of 8 interviews
+ * could not be opened"). Caption-size and muted, never alarming or
+ * apologetic, once per surface. `below-input` sits under the composer;
+ * `output-footer` sits under output that will be acted on and can offer
+ * next steps. Rendered as a `note`.
+ */
+declare const Caveat: React.ForwardRefExoticComponent<CaveatProps & React.RefAttributes<HTMLParagraphElement>>;
+interface CaveatTooltipProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, "content"> {
+    /** The caveat. Default "Output may be inaccurate". */
+    content?: React.ReactNode;
+    /** Side of the trigger. Default `top`. */
+    side?: TooltipSide;
+    /** Show the info glyph in the tooltip. Default `true`. */
+    showIcon?: boolean;
+    /** The AI action the caveat rides on — a single focusable element (e.g. an `Iconography` or Button). */
+    children: React.ReactElement;
+}
+/**
+ * The `info-tooltip` caveat: the reminder rides the generate control,
+ * shown on hover and keyboard focus without ever being in the way, and
+ * linked to the control with `aria-describedby` so screen readers hear it too.
+ */
+declare const CaveatTooltip: React.ForwardRefExoticComponent<CaveatTooltipProps & React.RefAttributes<HTMLSpanElement>>;
+
+export { Caveat, type CaveatProps, CaveatTooltip, type CaveatTooltipProps, type CaveatVariant };

package/dist/index.js

@@ -0,0 +1,58 @@
+"use client";
+import * as React from 'react';
+import { Info } from 'lucide-react';
+import { cn } from '@nucleux/utils';
+import { Tooltip } from '@nucleux/tooltip';
+import { jsxs, jsx } from 'react/jsx-runtime';
+
+// src/index.tsx
+var DEFAULT_TEXT = "AI can make mistakes. Verify important information.";
+var Caveat = React.forwardRef(
+  ({ variant = "below-input", icon, actions, className, children, ...props }, ref) => /* @__PURE__ */ jsxs(
+    "p",
+    {
+      ref,
+      role: "note",
+      "data-variant": variant,
+      className: cn(
+        "items-center gap-1.5 text-xs text-muted-foreground [&_svg]:size-3.5 [&_svg]:shrink-0",
+        variant === "output-footer" ? "mt-2.5 flex w-full flex-wrap rounded-md border border-border bg-muted/60 px-2.5 py-2 text-foreground/80" : "inline-flex",
+        className
+      ),
+      ...props,
+      children: [
+        icon === void 0 ? /* @__PURE__ */ jsx(Info, { "aria-hidden": "true" }) : icon,
+        /* @__PURE__ */ jsx("span", { children: children ?? DEFAULT_TEXT }),
+        actions && /* @__PURE__ */ jsx("span", { className: "ml-auto inline-flex flex-wrap items-center gap-1.5", children: actions })
+      ]
+    }
+  )
+);
+Caveat.displayName = "Caveat";
+var CaveatTooltip = React.forwardRef(
+  ({ content = "Output may be inaccurate", side = "top", showIcon = true, children, ...props }, ref) => {
+    const id = React.useId();
+    const childProps = children.props;
+    const trigger = React.cloneElement(children, {
+      "aria-describedby": [childProps["aria-describedby"], id].filter(Boolean).join(" ")
+    });
+    return /* @__PURE__ */ jsx(
+      Tooltip,
+      {
+        ref,
+        side,
+        content: /* @__PURE__ */ jsxs("span", { id, className: "inline-flex items-center gap-1.5 [&_svg]:size-3", children: [
+          showIcon && /* @__PURE__ */ jsx(Info, { "aria-hidden": "true" }),
+          content
+        ] }),
+        ...props,
+        children: trigger
+      }
+    );
+  }
+);
+CaveatTooltip.displayName = "CaveatTooltip";
+
+export { Caveat, CaveatTooltip };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":[],"mappings":";;;;;;;AA0BA,IAAM,YAAA,GAAe,qDAAA;AAUd,IAAM,MAAA,GAAe,KAAA,CAAA,UAAA;AAAA,EAC1B,CAAC,EAAE,OAAA,GAAU,aAAA,EAAe,IAAA,EAAM,OAAA,EAAS,SAAA,EAAW,QAAA,EAAU,GAAG,KAAA,EAAM,EAAG,GAAA,qBAC1E,IAAA;AAAA,IAAC,GAAA;AAAA,IAAA;AAAA,MACC,GAAA;AAAA,MACA,IAAA,EAAK,MAAA;AAAA,MACL,cAAA,EAAc,OAAA;AAAA,MACd,SAAA,EAAW,EAAA;AAAA,QACT,sFAAA;AAAA,QACA,OAAA,KAAY,kBACR,yGAAA,GACA,aAAA;AAAA,QACJ;AAAA,OACF;AAAA,MACC,GAAG,KAAA;AAAA,MAEH,QAAA,EAAA;AAAA,QAAA,IAAA,KAAS,MAAA,mBAAY,GAAA,CAAC,IAAA,EAAA,EAAK,aAAA,EAAY,QAAO,CAAA,GAAK,IAAA;AAAA,wBACpD,GAAA,CAAC,MAAA,EAAA,EAAM,QAAA,EAAA,QAAA,IAAY,YAAA,EAAa,CAAA;AAAA,QAC/B,OAAA,oBAAW,GAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,sDAAsD,QAAA,EAAA,OAAA,EAAQ;AAAA;AAAA;AAAA;AAGhG;AACA,MAAA,CAAO,WAAA,GAAc,QAAA;AAkBd,IAAM,aAAA,GAAsB,KAAA,CAAA,UAAA;AAAA,EACjC,CAAC,EAAE,OAAA,GAAU,0BAAA,EAA4B,IAAA,GAAO,KAAA,EAAO,QAAA,GAAW,IAAA,EAAM,QAAA,EAAU,GAAG,KAAA,EAAM,EAAG,GAAA,KAAQ;AACpG,IAAA,MAAM,KAAW,KAAA,CAAA,KAAA,EAAM;AACvB,IAAA,MAAM,aAAa,QAAA,CAAS,KAAA;AAC5B,IAAA,MAAM,OAAA,GAAgB,mBAAa,QAAA,EAAU;AAAA,MAC3C,kBAAA,EAAoB,CAAC,UAAA,CAAW,kBAAkB,CAAA,EAAG,EAAE,CAAA,CAAE,MAAA,CAAO,OAAO,CAAA,CAAE,IAAA,CAAK,GAAG;AAAA,KACvD,CAAA;AAC5B,IAAA,uBACE,GAAA;AAAA,MAAC,OAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,IAAA;AAAA,QACA,OAAA,kBACE,IAAA,CAAC,MAAA,EAAA,EAAK,EAAA,EAAQ,WAAU,iDAAA,EACrB,QAAA,EAAA;AAAA,UAAA,QAAA,oBAAY,GAAA,CAAC,IAAA,EAAA,EAAK,aAAA,EAAY,MAAA,EAAO,CAAA;AAAA,UACrC;AAAA,SAAA,EACH,CAAA;AAAA,QAED,GAAG,KAAA;AAAA,QAEH,QAAA,EAAA;AAAA;AAAA,KACH;AAAA,EAEJ;AACF;AACA,aAAA,CAAc,WAAA,GAAc,eAAA","file":"index.js","sourcesContent":["import * as React from \"react\";\nimport { Info } from \"lucide-react\";\nimport { cn } from \"@nucleux/utils\";\nimport { Tooltip, type TooltipSide } from \"@nucleux/tooltip\";\n\n/**\n * Where the caveat sits.\n * - `below-input` — a quiet caption under the composer, seen before anything is sent (default).\n * - `output-footer` — a filled note under output that will be acted on (sent, published,\n *   deployed); can carry next steps in `actions`.\n * For the third spec variant, `info-tooltip`, wrap the generate control in `CaveatTooltip`.\n */\nexport type CaveatVariant = \"below-input\" | \"output-footer\";\n\nexport interface CaveatProps extends React.HTMLAttributes<HTMLParagraphElement> {\n  /** Placement style. Default `below-input`. */\n  variant?: CaveatVariant;\n  /** Leading icon. Defaults to an info glyph. Pass `null` to omit. */\n  icon?: React.ReactNode;\n  /**\n   * Next steps that remove the reason for the caveat — \"Review sources\",\n   * \"Reconnect\". Shown after the text; use small Buttons or links.\n   */\n  actions?: React.ReactNode;\n}\n\nconst DEFAULT_TEXT = \"AI can make mistakes. Verify important information.\";\n\n/**\n * A short, calm reminder that AI output can be wrong and should be checked —\n * or, better, the specific limitation of this result (\"2 of 8 interviews\n * could not be opened\"). Caption-size and muted, never alarming or\n * apologetic, once per surface. `below-input` sits under the composer;\n * `output-footer` sits under output that will be acted on and can offer\n * next steps. Rendered as a `note`.\n */\nexport const Caveat = React.forwardRef<HTMLParagraphElement, CaveatProps>(\n  ({ variant = \"below-input\", icon, actions, className, children, ...props }, ref) => (\n    <p\n      ref={ref}\n      role=\"note\"\n      data-variant={variant}\n      className={cn(\n        \"items-center gap-1.5 text-xs text-muted-foreground [&_svg]:size-3.5 [&_svg]:shrink-0\",\n        variant === \"output-footer\"\n          ? \"mt-2.5 flex w-full flex-wrap rounded-md border border-border bg-muted/60 px-2.5 py-2 text-foreground/80\"\n          : \"inline-flex\",\n        className,\n      )}\n      {...props}\n    >\n      {icon === undefined ? <Info aria-hidden=\"true\" /> : icon}\n      <span>{children ?? DEFAULT_TEXT}</span>\n      {actions && <span className=\"ml-auto inline-flex flex-wrap items-center gap-1.5\">{actions}</span>}\n    </p>\n  ),\n);\nCaveat.displayName = \"Caveat\";\n\nexport interface CaveatTooltipProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, \"content\"> {\n  /** The caveat. Default \"Output may be inaccurate\". */\n  content?: React.ReactNode;\n  /** Side of the trigger. Default `top`. */\n  side?: TooltipSide;\n  /** Show the info glyph in the tooltip. Default `true`. */\n  showIcon?: boolean;\n  /** The AI action the caveat rides on — a single focusable element (e.g. an `Iconography` or Button). */\n  children: React.ReactElement;\n}\n\n/**\n * The `info-tooltip` caveat: the reminder rides the generate control,\n * shown on hover and keyboard focus without ever being in the way, and\n * linked to the control with `aria-describedby` so screen readers hear it too.\n */\nexport const CaveatTooltip = React.forwardRef<HTMLSpanElement, CaveatTooltipProps>(\n  ({ content = \"Output may be inaccurate\", side = \"top\", showIcon = true, children, ...props }, ref) => {\n    const id = React.useId();\n    const childProps = children.props as { \"aria-describedby\"?: string };\n    const trigger = React.cloneElement(children, {\n      \"aria-describedby\": [childProps[\"aria-describedby\"], id].filter(Boolean).join(\" \"),\n    } as Record<string, unknown>);\n    return (\n      <Tooltip\n        ref={ref}\n        side={side}\n        content={\n          <span id={id} className=\"inline-flex items-center gap-1.5 [&_svg]:size-3\">\n            {showIcon && <Info aria-hidden=\"true\" />}\n            {content}\n          </span>\n        }\n        {...props}\n      >\n        {trigger}\n      </Tooltip>\n    );\n  },\n);\nCaveatTooltip.displayName = \"CaveatTooltip\";\n"]}

package/package.json

@@ -1,6 +1,59 @@
 {
   "name": "@nucleux/caveat",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.6.0",
+  "type": "module",
+  "sideEffects": false,
+  "description": "Caveat — says what is incomplete, uncertain or out of date about an AI result — Nucleux agentic UI for React.",
+  "keywords": [
+    "nucleux",
+    "react",
+    "ui",
+    "components",
+    "agentic",
+    "ai",
+    "tailwind",
+    "caveat"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "dependencies": {
+    "@nucleux/tooltip": "0.6.0",
+    "@nucleux/utils": "0.6.0",
+    "lucide-react": "^0.469.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "@types/react": "^18.3.18",
+    "react": "^18.3.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/intelligaia-open-labs/nucleux.git",
+    "directory": "packages/caveat"
+  },
+  "homepage": "https://github.com/intelligaia-open-labs/nucleux#readme",
+  "scripts": {
+    "build": "tsup"
+  }
 }