@nucleux/personality 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,37 @@
-# Temporary Holding Version
+# @nucleux/personality
 
-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.
+Personality — the voice and tone the assistant speaks in — 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
+
+- **`Personality`** — the `tone-matrix`: a radio group of tones with roving focus (arrow keys, Home/End). `options` (`ToneOption`: `value`, `label`, `icon`, `description`), `value` / `defaultValue` / `onValueChange`, `label`; **`defaultTones`**
+- **`PersonalityVoiceCard`** — the `voice-card`: `quote` + `tags`
+- **`PersonalitySampleDialog`** — the `sample-dialog`: `turns` (`from` user/agent, `text`, `fixed`) built on Bubble; `fixed` lines carry a lock and "Same in every personality"
+
+Tone changes how the agent writes, never what it may do: keep permission, caveat and refusal strings outside it.
+
+## Install
+
+```bash
+pnpm add @nucleux/personality @nucleux/tokens
+```
+
+`react` / `react-dom` are peer dependencies.
+
+## Usage
+
+```tsx
+import { Personality, PersonalityVoiceCard, PersonalitySampleDialog } from "@nucleux/personality";
+
+<PersonalityVoiceCard quote="Here's what I found. Want me to dig in?" tags={["calm", "proactive"]} />
+<Personality value={tone} onValueChange={setTone} />
+```
+
+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,154 @@
+"use client";
+'use strict';
+
+var React = require('react');
+var lucideReact = require('lucide-react');
+var utils = require('@nucleux/utils');
+var bubble = require('@nucleux/bubble');
+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 defaultTones = [
+  { value: "professional", label: "Professional" },
+  { value: "friendly", label: "Friendly" },
+  { value: "direct", label: "Direct" },
+  { value: "playful", label: "Playful" }
+];
+var Personality = React__namespace.forwardRef(
+  ({ options = defaultTones, value, defaultValue, onValueChange, label = "Tone", className, ...props }, ref) => {
+    const [internal, setInternal] = React__namespace.useState(defaultValue);
+    const current = value !== void 0 ? value : internal;
+    const refs = React__namespace.useRef([]);
+    const descId = React__namespace.useId();
+    const select = (next) => {
+      if (value === void 0) setInternal(next);
+      onValueChange?.(next);
+    };
+    const selectedIndex = options.findIndex((o) => o.value === current);
+    const tabStop = selectedIndex >= 0 ? selectedIndex : 0;
+    const onKeyDown = (e, index) => {
+      const last = options.length - 1;
+      let next = null;
+      if (e.key === "ArrowRight" || e.key === "ArrowDown") next = index === last ? 0 : index + 1;
+      else if (e.key === "ArrowLeft" || e.key === "ArrowUp") next = index === 0 ? last : index - 1;
+      else if (e.key === "Home") next = 0;
+      else if (e.key === "End") next = last;
+      if (next === null) return;
+      e.preventDefault();
+      refs.current[next]?.focus();
+      select(options[next].value);
+    };
+    return /* @__PURE__ */ jsxRuntime.jsxs("div", { ref, "data-variant": "tone-matrix", className: utils.cn("flex flex-col gap-2", className), ...props, children: [
+      label && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-xs font-medium text-muted-foreground", children: label }),
+      /* @__PURE__ */ jsxRuntime.jsx("div", { role: "radiogroup", "aria-label": typeof label === "string" ? label : "Tone", className: "flex flex-wrap gap-1.5", children: options.map((option, index) => {
+        const active = current === option.value;
+        return /* @__PURE__ */ jsxRuntime.jsxs(
+          "button",
+          {
+            ref: (el) => {
+              refs.current[index] = el;
+            },
+            type: "button",
+            role: "radio",
+            "aria-checked": active,
+            "aria-describedby": option.description ? `${descId}-${index}` : void 0,
+            tabIndex: index === tabStop ? 0 : -1,
+            onClick: () => select(option.value),
+            onKeyDown: (e) => onKeyDown(e, index),
+            className: utils.cn(
+              "inline-flex items-center gap-1.5 rounded-full border px-3 py-1.5 text-sm transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring [&_svg]:size-3.5",
+              active ? "border-brand bg-brand-muted text-foreground" : "border-border bg-background text-muted-foreground hover:bg-accent hover:text-foreground"
+            ),
+            children: [
+              option.icon,
+              option.label,
+              option.description && /* @__PURE__ */ jsxRuntime.jsx("span", { id: `${descId}-${index}`, className: "sr-only", children: option.description })
+            ]
+          },
+          option.value
+        );
+      }) })
+    ] });
+  }
+);
+Personality.displayName = "Personality";
+var PersonalityVoiceCard = React__namespace.forwardRef(
+  ({ quote, tags = [], label = "Voice", className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsxs(
+    "figure",
+    {
+      ref,
+      "aria-label": label,
+      "data-variant": "voice-card",
+      className: utils.cn("m-0 rounded-xl border border-border bg-background p-4", className),
+      ...props,
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsxs("blockquote", { className: "m-0 text-sm italic leading-5 text-foreground/80", children: [
+          "\u201C",
+          quote,
+          "\u201D"
+        ] }),
+        tags.length > 0 && /* @__PURE__ */ jsxRuntime.jsxs("figcaption", { className: "mt-3", children: [
+          /* @__PURE__ */ jsxRuntime.jsx("span", { className: "sr-only", children: "Voice: " }),
+          /* @__PURE__ */ jsxRuntime.jsx("ul", { className: "flex flex-wrap gap-1.5", children: tags.map((tag) => /* @__PURE__ */ jsxRuntime.jsx(
+            "li",
+            {
+              className: "rounded-full border border-border bg-muted px-2.5 py-0.5 text-[11px] text-muted-foreground",
+              children: tag
+            },
+            tag
+          )) })
+        ] })
+      ]
+    }
+  )
+);
+PersonalityVoiceCard.displayName = "PersonalityVoiceCard";
+var PersonalitySampleDialog = React__namespace.forwardRef(
+  ({ turns, agentName = "Assistant", label = "Sample dialog", className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx(
+    "div",
+    {
+      ref,
+      role: "group",
+      "aria-label": label,
+      "data-variant": "sample-dialog",
+      className: utils.cn("flex flex-col gap-1.5", className),
+      ...props,
+      children: turns.map((turn, i) => /* @__PURE__ */ jsxRuntime.jsx(bubble.Bubble, { variant: turn.from === "user" ? "secondary" : "outline", align: turn.from === "user" ? "end" : "start", children: /* @__PURE__ */ jsxRuntime.jsxs(bubble.BubbleContent, { className: "text-xs leading-[18px]", children: [
+        /* @__PURE__ */ jsxRuntime.jsx("span", { className: "sr-only", children: turn.from === "user" ? "You said: " : `${agentName} said: ` }),
+        turn.text,
+        turn.fixed && /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "mt-1 flex items-center gap-1 text-[11px] text-muted-foreground", children: [
+          /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Lock, { "aria-hidden": "true", className: "size-3" }),
+          "Same in every personality"
+        ] })
+      ] }) }, i))
+    }
+  )
+);
+PersonalitySampleDialog.displayName = "PersonalitySampleDialog";
+
+exports.Personality = Personality;
+exports.PersonalitySampleDialog = PersonalitySampleDialog;
+exports.PersonalityVoiceCard = PersonalityVoiceCard;
+exports.defaultTones = defaultTones;
+//# 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","Bubble","BubbleContent","Lock"],"mappings":"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","file":"index.cjs","sourcesContent":["import * as React from \"react\";\nimport { Lock } from \"lucide-react\";\nimport { cn } from \"@nucleux/utils\";\nimport { Bubble, BubbleContent } from \"@nucleux/bubble\";\n\nexport interface ToneOption {\n  /** Stable value passed to `onValueChange`. */\n  value: string;\n  /** Display label. */\n  label: React.ReactNode;\n  /** Optional leading icon. */\n  icon?: React.ReactNode;\n  /** One-line description of the writing style, used as the option's accessible description. */\n  description?: string;\n}\n\n/** The default set of output tones. */\nexport const defaultTones: ToneOption[] = [\n  { value: \"professional\", label: \"Professional\" },\n  { value: \"friendly\", label: \"Friendly\" },\n  { value: \"direct\", label: \"Direct\" },\n  { value: \"playful\", label: \"Playful\" },\n];\n\nexport interface PersonalityProps\n  extends Omit<React.HTMLAttributes<HTMLDivElement>, \"onChange\"> {\n  /** Tone options. Defaults to {@link defaultTones}. */\n  options?: ToneOption[];\n  /** Selected value (controlled). */\n  value?: string;\n  /** Initial value (uncontrolled). */\n  defaultValue?: string;\n  /** Called when a tone is chosen. */\n  onValueChange?: (value: string) => void;\n  /** Group label. Defaults to `\"Tone\"`. */\n  label?: React.ReactNode;\n}\n\n/**\n * The `tone-matrix`: a small set of tones the person can nudge the agent\n * into for a session — more formal, more casual. A radio group with\n * roving focus (arrow keys move and select, Home / End jump). Tone changes\n * how the agent writes, never what it may do: keep permission, caveat and\n * refusal strings outside it. Pair with `PersonalityVoiceCard` and\n * `PersonalitySampleDialog` to preview a voice.\n */\nexport const Personality = React.forwardRef<HTMLDivElement, PersonalityProps>(\n  ({ options = defaultTones, value, defaultValue, onValueChange, label = \"Tone\", className, ...props }, ref) => {\n    const [internal, setInternal] = React.useState<string | undefined>(defaultValue);\n    const current = value !== undefined ? value : internal;\n    const refs = React.useRef<(HTMLButtonElement | null)[]>([]);\n    const descId = React.useId();\n    const select = (next: string) => {\n      if (value === undefined) setInternal(next);\n      onValueChange?.(next);\n    };\n    const selectedIndex = options.findIndex((o) => o.value === current);\n    const tabStop = selectedIndex >= 0 ? selectedIndex : 0;\n\n    const onKeyDown = (e: React.KeyboardEvent, index: number) => {\n      const last = options.length - 1;\n      let next: number | null = null;\n      if (e.key === \"ArrowRight\" || e.key === \"ArrowDown\") next = index === last ? 0 : index + 1;\n      else if (e.key === \"ArrowLeft\" || e.key === \"ArrowUp\") next = index === 0 ? last : index - 1;\n      else if (e.key === \"Home\") next = 0;\n      else if (e.key === \"End\") next = last;\n      if (next === null) return;\n      e.preventDefault();\n      refs.current[next]?.focus();\n      select(options[next]!.value);\n    };\n\n    return (\n      <div ref={ref} data-variant=\"tone-matrix\" className={cn(\"flex flex-col gap-2\", className)} {...props}>\n        {label && <span className=\"text-xs font-medium text-muted-foreground\">{label}</span>}\n        <div role=\"radiogroup\" aria-label={typeof label === \"string\" ? label : \"Tone\"} className=\"flex flex-wrap gap-1.5\">\n          {options.map((option, index) => {\n            const active = current === option.value;\n            return (\n              <button\n                key={option.value}\n                ref={(el) => {\n                  refs.current[index] = el;\n                }}\n                type=\"button\"\n                role=\"radio\"\n                aria-checked={active}\n                aria-describedby={option.description ? `${descId}-${index}` : undefined}\n                tabIndex={index === tabStop ? 0 : -1}\n                onClick={() => select(option.value)}\n                onKeyDown={(e) => onKeyDown(e, index)}\n                className={cn(\n                  \"inline-flex items-center gap-1.5 rounded-full border px-3 py-1.5 text-sm transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring [&_svg]:size-3.5\",\n                  active\n                    ? \"border-brand bg-brand-muted text-foreground\"\n                    : \"border-border bg-background text-muted-foreground hover:bg-accent hover:text-foreground\",\n                )}\n              >\n                {option.icon}\n                {option.label}\n                {option.description && (\n                  <span id={`${descId}-${index}`} className=\"sr-only\">\n                    {option.description}\n                  </span>\n                )}\n              </button>\n            );\n          })}\n        </div>\n      </div>\n    );\n  },\n);\nPersonality.displayName = \"Personality\";\n\nexport interface PersonalityVoiceCardProps extends React.HTMLAttributes<HTMLElement> {\n  /** A sample utterance in the agent's voice. */\n  quote: React.ReactNode;\n  /** Voice tags — \"calm\", \"proactive\", \"never breathless\". */\n  tags?: string[];\n  /** Accessible name of the card. Default \"Voice\". */\n  label?: string;\n}\n\n/**\n * The `voice-card`: one sample utterance plus voice tags, showing the\n * agent's tone at a glance — for greetings and onboarding.\n */\nexport const PersonalityVoiceCard = React.forwardRef<HTMLElement, PersonalityVoiceCardProps>(\n  ({ quote, tags = [], label = \"Voice\", className, ...props }, ref) => (\n    <figure\n      ref={ref}\n      aria-label={label}\n      data-variant=\"voice-card\"\n      className={cn(\"m-0 rounded-xl border border-border bg-background p-4\", className)}\n      {...props}\n    >\n      <blockquote className=\"m-0 text-sm italic leading-5 text-foreground/80\">“{quote}”</blockquote>\n      {tags.length > 0 && (\n        <figcaption className=\"mt-3\">\n          <span className=\"sr-only\">Voice: </span>\n          <ul className=\"flex flex-wrap gap-1.5\">\n            {tags.map((tag) => (\n              <li\n                key={tag}\n                className=\"rounded-full border border-border bg-muted px-2.5 py-0.5 text-[11px] text-muted-foreground\"\n              >\n                {tag}\n              </li>\n            ))}\n          </ul>\n        </figcaption>\n      )}\n    </figure>\n  ),\n);\nPersonalityVoiceCard.displayName = \"PersonalityVoiceCard\";\n\nexport interface PersonalitySampleTurn {\n  /** Who speaks. */\n  from: \"user\" | \"agent\";\n  /** What they say. */\n  text: React.ReactNode;\n  /**\n   * The line is fixed — a permission request, caveat or refusal that stays\n   * the same in every personality. Marked with a lock and \"Same in every personality\".\n   */\n  fixed?: boolean;\n}\n\nexport interface PersonalitySampleDialogProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** The exchange, in order. */\n  turns: PersonalitySampleTurn[];\n  /** Agent name for screen readers (\"Aria said\"). Default \"Assistant\". */\n  agentName?: string;\n  /** Accessible name of the sample. Default \"Sample dialog\". */\n  label?: string;\n}\n\n/**\n * The `sample-dialog`: a short exchange that demonstrates the voice in a\n * real interaction — the team keeps it as a regression test, and a\n * personality picker can preview it before applying. Lines marked `fixed`\n * carry a lock: they read the same in every personality.\n */\nexport const PersonalitySampleDialog = React.forwardRef<HTMLDivElement, PersonalitySampleDialogProps>(\n  ({ turns, agentName = \"Assistant\", label = \"Sample dialog\", className, ...props }, ref) => (\n    <div\n      ref={ref}\n      role=\"group\"\n      aria-label={label}\n      data-variant=\"sample-dialog\"\n      className={cn(\"flex flex-col gap-1.5\", className)}\n      {...props}\n    >\n      {turns.map((turn, i) => (\n        <Bubble key={i} variant={turn.from === \"user\" ? \"secondary\" : \"outline\"} align={turn.from === \"user\" ? \"end\" : \"start\"}>\n          <BubbleContent className=\"text-xs leading-[18px]\">\n            <span className=\"sr-only\">{turn.from === \"user\" ? \"You said: \" : `${agentName} said: `}</span>\n            {turn.text}\n            {turn.fixed && (\n              <span className=\"mt-1 flex items-center gap-1 text-[11px] text-muted-foreground\">\n                <Lock aria-hidden=\"true\" className=\"size-3\" />\n                Same in every personality\n              </span>\n            )}\n          </BubbleContent>\n        </Bubble>\n      ))}\n    </div>\n  ),\n);\nPersonalitySampleDialog.displayName = \"PersonalitySampleDialog\";\n"]}

package/dist/index.d.cts

@@ -0,0 +1,76 @@
+import * as React from 'react';
+
+interface ToneOption {
+    /** Stable value passed to `onValueChange`. */
+    value: string;
+    /** Display label. */
+    label: React.ReactNode;
+    /** Optional leading icon. */
+    icon?: React.ReactNode;
+    /** One-line description of the writing style, used as the option's accessible description. */
+    description?: string;
+}
+/** The default set of output tones. */
+declare const defaultTones: ToneOption[];
+interface PersonalityProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /** Tone options. Defaults to {@link defaultTones}. */
+    options?: ToneOption[];
+    /** Selected value (controlled). */
+    value?: string;
+    /** Initial value (uncontrolled). */
+    defaultValue?: string;
+    /** Called when a tone is chosen. */
+    onValueChange?: (value: string) => void;
+    /** Group label. Defaults to `"Tone"`. */
+    label?: React.ReactNode;
+}
+/**
+ * The `tone-matrix`: a small set of tones the person can nudge the agent
+ * into for a session — more formal, more casual. A radio group with
+ * roving focus (arrow keys move and select, Home / End jump). Tone changes
+ * how the agent writes, never what it may do: keep permission, caveat and
+ * refusal strings outside it. Pair with `PersonalityVoiceCard` and
+ * `PersonalitySampleDialog` to preview a voice.
+ */
+declare const Personality: React.ForwardRefExoticComponent<PersonalityProps & React.RefAttributes<HTMLDivElement>>;
+interface PersonalityVoiceCardProps extends React.HTMLAttributes<HTMLElement> {
+    /** A sample utterance in the agent's voice. */
+    quote: React.ReactNode;
+    /** Voice tags — "calm", "proactive", "never breathless". */
+    tags?: string[];
+    /** Accessible name of the card. Default "Voice". */
+    label?: string;
+}
+/**
+ * The `voice-card`: one sample utterance plus voice tags, showing the
+ * agent's tone at a glance — for greetings and onboarding.
+ */
+declare const PersonalityVoiceCard: React.ForwardRefExoticComponent<PersonalityVoiceCardProps & React.RefAttributes<HTMLElement>>;
+interface PersonalitySampleTurn {
+    /** Who speaks. */
+    from: "user" | "agent";
+    /** What they say. */
+    text: React.ReactNode;
+    /**
+     * The line is fixed — a permission request, caveat or refusal that stays
+     * the same in every personality. Marked with a lock and "Same in every personality".
+     */
+    fixed?: boolean;
+}
+interface PersonalitySampleDialogProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** The exchange, in order. */
+    turns: PersonalitySampleTurn[];
+    /** Agent name for screen readers ("Aria said"). Default "Assistant". */
+    agentName?: string;
+    /** Accessible name of the sample. Default "Sample dialog". */
+    label?: string;
+}
+/**
+ * The `sample-dialog`: a short exchange that demonstrates the voice in a
+ * real interaction — the team keeps it as a regression test, and a
+ * personality picker can preview it before applying. Lines marked `fixed`
+ * carry a lock: they read the same in every personality.
+ */
+declare const PersonalitySampleDialog: React.ForwardRefExoticComponent<PersonalitySampleDialogProps & React.RefAttributes<HTMLDivElement>>;
+
+export { Personality, type PersonalityProps, PersonalitySampleDialog, type PersonalitySampleDialogProps, type PersonalitySampleTurn, PersonalityVoiceCard, type PersonalityVoiceCardProps, type ToneOption, defaultTones };

package/dist/index.d.ts

@@ -0,0 +1,76 @@
+import * as React from 'react';
+
+interface ToneOption {
+    /** Stable value passed to `onValueChange`. */
+    value: string;
+    /** Display label. */
+    label: React.ReactNode;
+    /** Optional leading icon. */
+    icon?: React.ReactNode;
+    /** One-line description of the writing style, used as the option's accessible description. */
+    description?: string;
+}
+/** The default set of output tones. */
+declare const defaultTones: ToneOption[];
+interface PersonalityProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /** Tone options. Defaults to {@link defaultTones}. */
+    options?: ToneOption[];
+    /** Selected value (controlled). */
+    value?: string;
+    /** Initial value (uncontrolled). */
+    defaultValue?: string;
+    /** Called when a tone is chosen. */
+    onValueChange?: (value: string) => void;
+    /** Group label. Defaults to `"Tone"`. */
+    label?: React.ReactNode;
+}
+/**
+ * The `tone-matrix`: a small set of tones the person can nudge the agent
+ * into for a session — more formal, more casual. A radio group with
+ * roving focus (arrow keys move and select, Home / End jump). Tone changes
+ * how the agent writes, never what it may do: keep permission, caveat and
+ * refusal strings outside it. Pair with `PersonalityVoiceCard` and
+ * `PersonalitySampleDialog` to preview a voice.
+ */
+declare const Personality: React.ForwardRefExoticComponent<PersonalityProps & React.RefAttributes<HTMLDivElement>>;
+interface PersonalityVoiceCardProps extends React.HTMLAttributes<HTMLElement> {
+    /** A sample utterance in the agent's voice. */
+    quote: React.ReactNode;
+    /** Voice tags — "calm", "proactive", "never breathless". */
+    tags?: string[];
+    /** Accessible name of the card. Default "Voice". */
+    label?: string;
+}
+/**
+ * The `voice-card`: one sample utterance plus voice tags, showing the
+ * agent's tone at a glance — for greetings and onboarding.
+ */
+declare const PersonalityVoiceCard: React.ForwardRefExoticComponent<PersonalityVoiceCardProps & React.RefAttributes<HTMLElement>>;
+interface PersonalitySampleTurn {
+    /** Who speaks. */
+    from: "user" | "agent";
+    /** What they say. */
+    text: React.ReactNode;
+    /**
+     * The line is fixed — a permission request, caveat or refusal that stays
+     * the same in every personality. Marked with a lock and "Same in every personality".
+     */
+    fixed?: boolean;
+}
+interface PersonalitySampleDialogProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** The exchange, in order. */
+    turns: PersonalitySampleTurn[];
+    /** Agent name for screen readers ("Aria said"). Default "Assistant". */
+    agentName?: string;
+    /** Accessible name of the sample. Default "Sample dialog". */
+    label?: string;
+}
+/**
+ * The `sample-dialog`: a short exchange that demonstrates the voice in a
+ * real interaction — the team keeps it as a regression test, and a
+ * personality picker can preview it before applying. Lines marked `fixed`
+ * carry a lock: they read the same in every personality.
+ */
+declare const PersonalitySampleDialog: React.ForwardRefExoticComponent<PersonalitySampleDialogProps & React.RefAttributes<HTMLDivElement>>;
+
+export { Personality, type PersonalityProps, PersonalitySampleDialog, type PersonalitySampleDialogProps, type PersonalitySampleTurn, PersonalityVoiceCard, type PersonalityVoiceCardProps, type ToneOption, defaultTones };

package/dist/index.js

@@ -0,0 +1,129 @@
+"use client";
+import * as React from 'react';
+import { Lock } from 'lucide-react';
+import { cn } from '@nucleux/utils';
+import { Bubble, BubbleContent } from '@nucleux/bubble';
+import { jsxs, jsx } from 'react/jsx-runtime';
+
+// src/index.tsx
+var defaultTones = [
+  { value: "professional", label: "Professional" },
+  { value: "friendly", label: "Friendly" },
+  { value: "direct", label: "Direct" },
+  { value: "playful", label: "Playful" }
+];
+var Personality = React.forwardRef(
+  ({ options = defaultTones, value, defaultValue, onValueChange, label = "Tone", className, ...props }, ref) => {
+    const [internal, setInternal] = React.useState(defaultValue);
+    const current = value !== void 0 ? value : internal;
+    const refs = React.useRef([]);
+    const descId = React.useId();
+    const select = (next) => {
+      if (value === void 0) setInternal(next);
+      onValueChange?.(next);
+    };
+    const selectedIndex = options.findIndex((o) => o.value === current);
+    const tabStop = selectedIndex >= 0 ? selectedIndex : 0;
+    const onKeyDown = (e, index) => {
+      const last = options.length - 1;
+      let next = null;
+      if (e.key === "ArrowRight" || e.key === "ArrowDown") next = index === last ? 0 : index + 1;
+      else if (e.key === "ArrowLeft" || e.key === "ArrowUp") next = index === 0 ? last : index - 1;
+      else if (e.key === "Home") next = 0;
+      else if (e.key === "End") next = last;
+      if (next === null) return;
+      e.preventDefault();
+      refs.current[next]?.focus();
+      select(options[next].value);
+    };
+    return /* @__PURE__ */ jsxs("div", { ref, "data-variant": "tone-matrix", className: cn("flex flex-col gap-2", className), ...props, children: [
+      label && /* @__PURE__ */ jsx("span", { className: "text-xs font-medium text-muted-foreground", children: label }),
+      /* @__PURE__ */ jsx("div", { role: "radiogroup", "aria-label": typeof label === "string" ? label : "Tone", className: "flex flex-wrap gap-1.5", children: options.map((option, index) => {
+        const active = current === option.value;
+        return /* @__PURE__ */ jsxs(
+          "button",
+          {
+            ref: (el) => {
+              refs.current[index] = el;
+            },
+            type: "button",
+            role: "radio",
+            "aria-checked": active,
+            "aria-describedby": option.description ? `${descId}-${index}` : void 0,
+            tabIndex: index === tabStop ? 0 : -1,
+            onClick: () => select(option.value),
+            onKeyDown: (e) => onKeyDown(e, index),
+            className: cn(
+              "inline-flex items-center gap-1.5 rounded-full border px-3 py-1.5 text-sm transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring [&_svg]:size-3.5",
+              active ? "border-brand bg-brand-muted text-foreground" : "border-border bg-background text-muted-foreground hover:bg-accent hover:text-foreground"
+            ),
+            children: [
+              option.icon,
+              option.label,
+              option.description && /* @__PURE__ */ jsx("span", { id: `${descId}-${index}`, className: "sr-only", children: option.description })
+            ]
+          },
+          option.value
+        );
+      }) })
+    ] });
+  }
+);
+Personality.displayName = "Personality";
+var PersonalityVoiceCard = React.forwardRef(
+  ({ quote, tags = [], label = "Voice", className, ...props }, ref) => /* @__PURE__ */ jsxs(
+    "figure",
+    {
+      ref,
+      "aria-label": label,
+      "data-variant": "voice-card",
+      className: cn("m-0 rounded-xl border border-border bg-background p-4", className),
+      ...props,
+      children: [
+        /* @__PURE__ */ jsxs("blockquote", { className: "m-0 text-sm italic leading-5 text-foreground/80", children: [
+          "\u201C",
+          quote,
+          "\u201D"
+        ] }),
+        tags.length > 0 && /* @__PURE__ */ jsxs("figcaption", { className: "mt-3", children: [
+          /* @__PURE__ */ jsx("span", { className: "sr-only", children: "Voice: " }),
+          /* @__PURE__ */ jsx("ul", { className: "flex flex-wrap gap-1.5", children: tags.map((tag) => /* @__PURE__ */ jsx(
+            "li",
+            {
+              className: "rounded-full border border-border bg-muted px-2.5 py-0.5 text-[11px] text-muted-foreground",
+              children: tag
+            },
+            tag
+          )) })
+        ] })
+      ]
+    }
+  )
+);
+PersonalityVoiceCard.displayName = "PersonalityVoiceCard";
+var PersonalitySampleDialog = React.forwardRef(
+  ({ turns, agentName = "Assistant", label = "Sample dialog", className, ...props }, ref) => /* @__PURE__ */ jsx(
+    "div",
+    {
+      ref,
+      role: "group",
+      "aria-label": label,
+      "data-variant": "sample-dialog",
+      className: cn("flex flex-col gap-1.5", className),
+      ...props,
+      children: turns.map((turn, i) => /* @__PURE__ */ jsx(Bubble, { variant: turn.from === "user" ? "secondary" : "outline", align: turn.from === "user" ? "end" : "start", children: /* @__PURE__ */ jsxs(BubbleContent, { className: "text-xs leading-[18px]", children: [
+        /* @__PURE__ */ jsx("span", { className: "sr-only", children: turn.from === "user" ? "You said: " : `${agentName} said: ` }),
+        turn.text,
+        turn.fixed && /* @__PURE__ */ jsxs("span", { className: "mt-1 flex items-center gap-1 text-[11px] text-muted-foreground", children: [
+          /* @__PURE__ */ jsx(Lock, { "aria-hidden": "true", className: "size-3" }),
+          "Same in every personality"
+        ] })
+      ] }) }, i))
+    }
+  )
+);
+PersonalitySampleDialog.displayName = "PersonalitySampleDialog";
+
+export { Personality, PersonalitySampleDialog, PersonalityVoiceCard, defaultTones };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import * as React from \"react\";\nimport { Lock } from \"lucide-react\";\nimport { cn } from \"@nucleux/utils\";\nimport { Bubble, BubbleContent } from \"@nucleux/bubble\";\n\nexport interface ToneOption {\n  /** Stable value passed to `onValueChange`. */\n  value: string;\n  /** Display label. */\n  label: React.ReactNode;\n  /** Optional leading icon. */\n  icon?: React.ReactNode;\n  /** One-line description of the writing style, used as the option's accessible description. */\n  description?: string;\n}\n\n/** The default set of output tones. */\nexport const defaultTones: ToneOption[] = [\n  { value: \"professional\", label: \"Professional\" },\n  { value: \"friendly\", label: \"Friendly\" },\n  { value: \"direct\", label: \"Direct\" },\n  { value: \"playful\", label: \"Playful\" },\n];\n\nexport interface PersonalityProps\n  extends Omit<React.HTMLAttributes<HTMLDivElement>, \"onChange\"> {\n  /** Tone options. Defaults to {@link defaultTones}. */\n  options?: ToneOption[];\n  /** Selected value (controlled). */\n  value?: string;\n  /** Initial value (uncontrolled). */\n  defaultValue?: string;\n  /** Called when a tone is chosen. */\n  onValueChange?: (value: string) => void;\n  /** Group label. Defaults to `\"Tone\"`. */\n  label?: React.ReactNode;\n}\n\n/**\n * The `tone-matrix`: a small set of tones the person can nudge the agent\n * into for a session — more formal, more casual. A radio group with\n * roving focus (arrow keys move and select, Home / End jump). Tone changes\n * how the agent writes, never what it may do: keep permission, caveat and\n * refusal strings outside it. Pair with `PersonalityVoiceCard` and\n * `PersonalitySampleDialog` to preview a voice.\n */\nexport const Personality = React.forwardRef<HTMLDivElement, PersonalityProps>(\n  ({ options = defaultTones, value, defaultValue, onValueChange, label = \"Tone\", className, ...props }, ref) => {\n    const [internal, setInternal] = React.useState<string | undefined>(defaultValue);\n    const current = value !== undefined ? value : internal;\n    const refs = React.useRef<(HTMLButtonElement | null)[]>([]);\n    const descId = React.useId();\n    const select = (next: string) => {\n      if (value === undefined) setInternal(next);\n      onValueChange?.(next);\n    };\n    const selectedIndex = options.findIndex((o) => o.value === current);\n    const tabStop = selectedIndex >= 0 ? selectedIndex : 0;\n\n    const onKeyDown = (e: React.KeyboardEvent, index: number) => {\n      const last = options.length - 1;\n      let next: number | null = null;\n      if (e.key === \"ArrowRight\" || e.key === \"ArrowDown\") next = index === last ? 0 : index + 1;\n      else if (e.key === \"ArrowLeft\" || e.key === \"ArrowUp\") next = index === 0 ? last : index - 1;\n      else if (e.key === \"Home\") next = 0;\n      else if (e.key === \"End\") next = last;\n      if (next === null) return;\n      e.preventDefault();\n      refs.current[next]?.focus();\n      select(options[next]!.value);\n    };\n\n    return (\n      <div ref={ref} data-variant=\"tone-matrix\" className={cn(\"flex flex-col gap-2\", className)} {...props}>\n        {label && <span className=\"text-xs font-medium text-muted-foreground\">{label}</span>}\n        <div role=\"radiogroup\" aria-label={typeof label === \"string\" ? label : \"Tone\"} className=\"flex flex-wrap gap-1.5\">\n          {options.map((option, index) => {\n            const active = current === option.value;\n            return (\n              <button\n                key={option.value}\n                ref={(el) => {\n                  refs.current[index] = el;\n                }}\n                type=\"button\"\n                role=\"radio\"\n                aria-checked={active}\n                aria-describedby={option.description ? `${descId}-${index}` : undefined}\n                tabIndex={index === tabStop ? 0 : -1}\n                onClick={() => select(option.value)}\n                onKeyDown={(e) => onKeyDown(e, index)}\n                className={cn(\n                  \"inline-flex items-center gap-1.5 rounded-full border px-3 py-1.5 text-sm transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring [&_svg]:size-3.5\",\n                  active\n                    ? \"border-brand bg-brand-muted text-foreground\"\n                    : \"border-border bg-background text-muted-foreground hover:bg-accent hover:text-foreground\",\n                )}\n              >\n                {option.icon}\n                {option.label}\n                {option.description && (\n                  <span id={`${descId}-${index}`} className=\"sr-only\">\n                    {option.description}\n                  </span>\n                )}\n              </button>\n            );\n          })}\n        </div>\n      </div>\n    );\n  },\n);\nPersonality.displayName = \"Personality\";\n\nexport interface PersonalityVoiceCardProps extends React.HTMLAttributes<HTMLElement> {\n  /** A sample utterance in the agent's voice. */\n  quote: React.ReactNode;\n  /** Voice tags — \"calm\", \"proactive\", \"never breathless\". */\n  tags?: string[];\n  /** Accessible name of the card. Default \"Voice\". */\n  label?: string;\n}\n\n/**\n * The `voice-card`: one sample utterance plus voice tags, showing the\n * agent's tone at a glance — for greetings and onboarding.\n */\nexport const PersonalityVoiceCard = React.forwardRef<HTMLElement, PersonalityVoiceCardProps>(\n  ({ quote, tags = [], label = \"Voice\", className, ...props }, ref) => (\n    <figure\n      ref={ref}\n      aria-label={label}\n      data-variant=\"voice-card\"\n      className={cn(\"m-0 rounded-xl border border-border bg-background p-4\", className)}\n      {...props}\n    >\n      <blockquote className=\"m-0 text-sm italic leading-5 text-foreground/80\">“{quote}”</blockquote>\n      {tags.length > 0 && (\n        <figcaption className=\"mt-3\">\n          <span className=\"sr-only\">Voice: </span>\n          <ul className=\"flex flex-wrap gap-1.5\">\n            {tags.map((tag) => (\n              <li\n                key={tag}\n                className=\"rounded-full border border-border bg-muted px-2.5 py-0.5 text-[11px] text-muted-foreground\"\n              >\n                {tag}\n              </li>\n            ))}\n          </ul>\n        </figcaption>\n      )}\n    </figure>\n  ),\n);\nPersonalityVoiceCard.displayName = \"PersonalityVoiceCard\";\n\nexport interface PersonalitySampleTurn {\n  /** Who speaks. */\n  from: \"user\" | \"agent\";\n  /** What they say. */\n  text: React.ReactNode;\n  /**\n   * The line is fixed — a permission request, caveat or refusal that stays\n   * the same in every personality. Marked with a lock and \"Same in every personality\".\n   */\n  fixed?: boolean;\n}\n\nexport interface PersonalitySampleDialogProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** The exchange, in order. */\n  turns: PersonalitySampleTurn[];\n  /** Agent name for screen readers (\"Aria said\"). Default \"Assistant\". */\n  agentName?: string;\n  /** Accessible name of the sample. Default \"Sample dialog\". */\n  label?: string;\n}\n\n/**\n * The `sample-dialog`: a short exchange that demonstrates the voice in a\n * real interaction — the team keeps it as a regression test, and a\n * personality picker can preview it before applying. Lines marked `fixed`\n * carry a lock: they read the same in every personality.\n */\nexport const PersonalitySampleDialog = React.forwardRef<HTMLDivElement, PersonalitySampleDialogProps>(\n  ({ turns, agentName = \"Assistant\", label = \"Sample dialog\", className, ...props }, ref) => (\n    <div\n      ref={ref}\n      role=\"group\"\n      aria-label={label}\n      data-variant=\"sample-dialog\"\n      className={cn(\"flex flex-col gap-1.5\", className)}\n      {...props}\n    >\n      {turns.map((turn, i) => (\n        <Bubble key={i} variant={turn.from === \"user\" ? \"secondary\" : \"outline\"} align={turn.from === \"user\" ? \"end\" : \"start\"}>\n          <BubbleContent className=\"text-xs leading-[18px]\">\n            <span className=\"sr-only\">{turn.from === \"user\" ? \"You said: \" : `${agentName} said: `}</span>\n            {turn.text}\n            {turn.fixed && (\n              <span className=\"mt-1 flex items-center gap-1 text-[11px] text-muted-foreground\">\n                <Lock aria-hidden=\"true\" className=\"size-3\" />\n                Same in every personality\n              </span>\n            )}\n          </BubbleContent>\n        </Bubble>\n      ))}\n    </div>\n  ),\n);\nPersonalitySampleDialog.displayName = \"PersonalitySampleDialog\";\n"]}

package/package.json

@@ -1,6 +1,59 @@
 {
   "name": "@nucleux/personality",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.6.0",
+  "type": "module",
+  "sideEffects": false,
+  "description": "Personality — the voice and tone the assistant speaks in — Nucleux agentic UI for React.",
+  "keywords": [
+    "nucleux",
+    "react",
+    "ui",
+    "components",
+    "agentic",
+    "ai",
+    "tailwind",
+    "personality"
+  ],
+  "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/bubble": "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/personality"
+  },
+  "homepage": "https://github.com/intelligaia-open-labs/nucleux#readme",
+  "scripts": {
+    "build": "tsup"
+  }
 }