@sovereignfs/ui 0.37.0 → 0.41.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sovereignfs/ui",
-  "version": "0.37.0",
+  "version": "0.41.0",
   "type": "module",
   "description": "Sovereign Design System — design tokens and React components.",
   "keywords": [

package/src/components/BalanceChip/BalanceChip.module.css

@@ -0,0 +1,32 @@
+.chip {
+  display: inline-flex;
+  align-items: center;
+  max-width: 100%;
+  min-height: 24px;
+  padding: 2px var(--sv-space-2);
+  border: 1px solid var(--sv-color-border);
+  border-radius: var(--sv-radius-full);
+  font-family: var(--sv-font-family);
+  font-size: var(--sv-font-size-xs);
+  font-weight: var(--sv-font-weight-semibold);
+  line-height: 1.2;
+  white-space: nowrap;
+}
+
+.owed {
+  color: var(--sv-color-success-text);
+  background: var(--sv-color-success-surface);
+  border-color: var(--sv-color-success-border);
+}
+
+.owes {
+  color: var(--sv-color-error-text);
+  background: var(--sv-color-error-surface);
+  border-color: var(--sv-color-error-border);
+}
+
+.settled {
+  color: var(--sv-color-text-muted);
+  background: var(--sv-color-surface-sunken);
+  border-color: var(--sv-color-border);
+}

package/src/components/BalanceChip/BalanceChip.stories.tsx

@@ -0,0 +1,45 @@
+import type { Meta, StoryObj } from '@storybook/react-vite';
+import { BalanceChip } from './BalanceChip';
+
+const meta = {
+  title: 'Components/BalanceChip',
+  component: BalanceChip,
+  parameters: {
+    layout: 'centered',
+    docs: {
+      description: {
+        component:
+          'Inline net-balance indicator — green when owed to them, red when they owe, neutral when settled. Not tied to expense-splitting specifically: any plugin tracking a signed balance between people can use it.',
+      },
+    },
+  },
+  args: {
+    amountCents: 2500,
+    currency: 'USD',
+  },
+} satisfies Meta<typeof BalanceChip>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Owed: Story = {
+  args: { amountCents: 2500, currency: 'USD' },
+};
+
+export const Owes: Story = {
+  args: { amountCents: -1350, currency: 'USD' },
+};
+
+export const SettledUp: Story = {
+  args: { amountCents: 0, currency: 'USD' },
+};
+
+export const AllStates: Story = {
+  render: () => (
+    <div style={{ display: 'flex', gap: 'var(--sv-space-2)' }}>
+      <BalanceChip amountCents={2500} currency="USD" />
+      <BalanceChip amountCents={-1350} currency="USD" />
+      <BalanceChip amountCents={0} currency="USD" />
+    </div>
+  ),
+};

package/src/components/BalanceChip/BalanceChip.tsx

@@ -0,0 +1,33 @@
+import styles from './BalanceChip.module.css';
+
+export interface BalanceChipProps {
+  /** Smallest currency unit (cents). Positive = owed to them, negative = they owe, zero = settled. */
+  amountCents: number;
+  /** ISO 4217 currency code, e.g. "USD". */
+  currency: string;
+  className?: string;
+}
+
+function formatAbsCents(cents: number): string {
+  return (Math.abs(cents) / 100).toFixed(2);
+}
+
+/**
+ * BalanceChip — inline balance indicator (green = owed to them, red = they
+ * owe, neutral = settled up). For any plugin tracking who-owes-whom — not
+ * Tally-specific despite the naming; "amountCents" is a generic signed net
+ * balance, not tied to expense-splitting semantics.
+ */
+export function BalanceChip({ amountCents, currency, className }: BalanceChipProps) {
+  const direction = amountCents > 0 ? 'owed' : amountCents < 0 ? 'owes' : 'settled';
+  const text =
+    direction === 'settled'
+      ? 'Settled up'
+      : `${direction === 'owed' ? 'Owed' : 'Owes'} ${currency} ${formatAbsCents(amountCents)}`;
+
+  return (
+    <span className={[styles.chip, styles[direction], className].filter(Boolean).join(' ')}>
+      {text}
+    </span>
+  );
+}

package/src/components/CurrencyInput/CurrencyInput.stories.tsx

@@ -0,0 +1,50 @@
+import { useState } from 'react';
+import type { Meta, StoryObj } from '@storybook/react-vite';
+import { CurrencyInput } from './CurrencyInput';
+
+const meta = {
+  title: 'Components/CurrencyInput',
+  component: CurrencyInput,
+  parameters: {
+    layout: 'padded',
+    docs: {
+      description: {
+        component:
+          'Decimal amount entry that reports its value as integer cents, matching the "amounts are always smallest-unit integers" data-model convention. Preserves in-progress typing (e.g. a trailing decimal point) instead of reformatting on every keystroke.',
+      },
+    },
+  },
+  args: {
+    valueCents: null,
+    onValueChange: () => {},
+  },
+} satisfies Meta<typeof CurrencyInput>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+function ControlledCurrencyInput({ initialCents }: { initialCents: number | null }) {
+  const [cents, setCents] = useState<number | null>(initialCents);
+  return (
+    <CurrencyInput
+      valueCents={cents}
+      onValueChange={setCents}
+      placeholder="0.00"
+      aria-label="Amount"
+    />
+  );
+}
+
+export const Empty: Story = {
+  render: () => <ControlledCurrencyInput initialCents={null} />,
+};
+
+export const Prefilled: Story = {
+  render: () => <ControlledCurrencyInput initialCents={4250} />,
+};
+
+export const Disabled: Story = {
+  render: () => (
+    <CurrencyInput valueCents={1000} onValueChange={() => {}} aria-label="Amount" disabled />
+  ),
+};

package/src/components/CurrencyInput/CurrencyInput.tsx

@@ -0,0 +1,60 @@
+'use client';
+
+import { useState } from 'react';
+import { Input, type InputProps } from '../Input/Input';
+
+export interface CurrencyInputProps extends Omit<
+  InputProps,
+  'value' | 'onChange' | 'type' | 'inputMode'
+> {
+  /** Smallest currency unit (cents) — never a float. Null when the field is empty or unparsable. */
+  valueCents: number | null;
+  onValueChange: (cents: number | null) => void;
+}
+
+function centsToText(cents: number): string {
+  return (cents / 100).toFixed(2);
+}
+
+function textToCents(text: string): number | null {
+  const trimmed = text.trim();
+  if (!trimmed) return null;
+  const parsed = Number(trimmed);
+  if (!Number.isFinite(parsed)) return null;
+  return Math.round(parsed * 100);
+}
+
+/**
+ * CurrencyInput — decimal amount entry that reports its value as integer
+ * cents, matching Sovereign's "amounts are always smallest-unit integers"
+ * data-model convention (never a float in application state).
+ *
+ * Keeps its own text buffer rather than deriving display text from
+ * `valueCents` on every keystroke — reformatting mid-type (e.g. "12." → the
+ * trailing decimal point) would fight the user's cursor. It only
+ * re-syncs from `valueCents` when the prop changes to something the current
+ * text doesn't already represent (an external reset/prefill), so typing
+ * remains uninterrupted while the parsed amount stays in lockstep with the
+ * parent's state.
+ */
+export function CurrencyInput({ valueCents, onValueChange, ...rest }: CurrencyInputProps) {
+  const [text, setText] = useState(() => (valueCents != null ? centsToText(valueCents) : ''));
+
+  if (textToCents(text) !== valueCents) {
+    setText(valueCents != null ? centsToText(valueCents) : '');
+  }
+
+  return (
+    <Input
+      {...rest}
+      type="text"
+      inputMode="decimal"
+      value={text}
+      onChange={(e) => {
+        const next = e.currentTarget.value;
+        setText(next);
+        onValueChange(textToCents(next));
+      }}
+    />
+  );
+}

package/src/components/FileDropzone/FileDropzone.module.css

@@ -0,0 +1,63 @@
+.dropzone {
+  display: flex;
+  align-items: center;
+  gap: var(--sv-space-4);
+  width: 100%;
+  box-sizing: border-box;
+  padding: var(--sv-space-4) var(--sv-space-5);
+  border: 1.5px dashed var(--sv-color-border);
+  border-radius: var(--sv-radius-md);
+  background-color: var(--sv-color-surface-raised);
+  cursor: pointer;
+  transition:
+    background-color 0.12s ease,
+    border-color 0.12s ease;
+}
+
+@media (hover: hover) {
+  .dropzone:hover {
+    background-color: var(--sv-color-surface-sunken);
+    border-color: var(--sv-color-border-strong);
+  }
+}
+
+.dropzoneActive {
+  background-color: var(--sv-color-surface-sunken);
+  border-color: var(--sv-color-border-strong);
+}
+
+.dropzoneDisabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+
+.icon {
+  display: inline-flex;
+  flex-shrink: 0;
+  color: var(--sv-color-text-muted);
+}
+
+.text {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  min-width: 0;
+}
+
+.title {
+  font-size: var(--sv-font-size-sm);
+  font-weight: var(--sv-font-weight-medium);
+  color: var(--sv-color-text-primary);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.hint {
+  font-size: var(--sv-font-size-xs);
+  color: var(--sv-color-text-muted);
+}
+
+.hiddenInput {
+  display: none;
+}

package/src/components/FileDropzone/FileDropzone.tsx

@@ -0,0 +1,109 @@
+'use client';
+
+import type { DragEvent, ReactNode } from 'react';
+import { useRef, useState } from 'react';
+import { Icon } from '../Icon/Icon';
+import styles from './FileDropzone.module.css';
+
+export interface FileDropzoneProps {
+  /** Native `<input type="file">` `name` attribute — set this to submit the
+   * file as part of a native `<form action={...}>` (Server Action) request. */
+  name?: string;
+  /** Native `<input type="file">` `accept` attribute, e.g. `".zip,application/zip"`. */
+  accept?: string;
+  /** Icon shown beside the label — a file-type glyph. Defaults to a generic file icon. */
+  icon?: ReactNode;
+  /** Primary label — e.g. "Choose a ZIP file", or the selected file's name. */
+  label: string;
+  /** Secondary hint — e.g. "or drag and drop here", or the selected file's size. */
+  hint?: string;
+  /** Called with the picked or dropped file, or `null` if the input is cleared. */
+  onFileSelect: (file: File | null) => void;
+  /** Accessible name for the control — describe what will be uploaded. */
+  ariaLabel: string;
+  disabled?: boolean;
+  className?: string;
+}
+
+/**
+ * A styled drag-and-drop file picker: a dashed-border dropzone wrapping a
+ * visually-hidden native `<input type="file">`, so the native picker still
+ * opens on click and the field participates in normal form semantics. A
+ * dropped file is written into the input's own `FileList` (via `DataTransfer`)
+ * so `name` + native `<form action>` submission sees it exactly like a
+ * click-picked file — not just the `onFileSelect` callback.
+ *
+ * Caller owns the selected-file state and passes `label`/`hint` accordingly
+ * (e.g. swap to the picked file's name/size) — this component is otherwise
+ * uncontrolled and stateless beyond its own drag-hover visual.
+ *
+ * Do not pass `required` through to a wrapping form's validation via this
+ * field — `display: none` on the hidden input does not exempt it from HTML5
+ * constraint validation, so a `required` hidden input can block submission
+ * with no visible field for the user to focus. Validate `onFileSelect`'s
+ * result in application code instead.
+ */
+export function FileDropzone({
+  name,
+  accept,
+  icon,
+  label,
+  hint,
+  onFileSelect,
+  ariaLabel,
+  disabled,
+  className,
+}: FileDropzoneProps) {
+  const [dragging, setDragging] = useState(false);
+  const inputRef = useRef<HTMLInputElement>(null);
+
+  return (
+    <label
+      className={[
+        styles.dropzone,
+        dragging ? styles.dropzoneActive : '',
+        disabled ? styles.dropzoneDisabled : '',
+        className,
+      ]
+        .filter(Boolean)
+        .join(' ')}
+      onDragOver={(event: DragEvent) => {
+        if (disabled) return;
+        event.preventDefault();
+        setDragging(true);
+      }}
+      onDragLeave={() => setDragging(false)}
+      onDrop={(event: DragEvent) => {
+        if (disabled) return;
+        event.preventDefault();
+        setDragging(false);
+        const dropped = event.dataTransfer.files[0];
+        if (!dropped) return;
+        if (inputRef.current && typeof DataTransfer !== 'undefined') {
+          const transfer = new DataTransfer();
+          transfer.items.add(dropped);
+          inputRef.current.files = transfer.files;
+        }
+        onFileSelect(dropped);
+      }}
+    >
+      <span className={styles.icon} aria-hidden="true">
+        {icon ?? <Icon name="file" size="lg" aria-hidden />}
+      </span>
+      <span className={styles.text}>
+        <span className={styles.title}>{label}</span>
+        {hint && <span className={styles.hint}>{hint}</span>}
+      </span>
+      <input
+        ref={inputRef}
+        type="file"
+        name={name}
+        aria-label={ariaLabel}
+        accept={accept}
+        disabled={disabled}
+        onChange={(event) => onFileSelect(event.target.files?.[0] ?? null)}
+        className={styles.hiddenInput}
+      />
+    </label>
+  );
+}

package/src/components/FileDropzone/__tests__/FileDropzone.test.tsx

@@ -0,0 +1,67 @@
+// @vitest-environment jsdom
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { cleanup, fireEvent, render, screen } from '@testing-library/react';
+import { FileDropzone } from '../FileDropzone';
+
+afterEach(cleanup);
+
+describe('FileDropzone', () => {
+  it('renders the label and hint', () => {
+    render(
+      <FileDropzone
+        label="Choose a ZIP file"
+        hint="or drag and drop here"
+        ariaLabel="Upload ZIP file"
+        onFileSelect={vi.fn()}
+      />,
+    );
+    expect(screen.getByText('Choose a ZIP file')).toBeDefined();
+    expect(screen.getByText('or drag and drop here')).toBeDefined();
+  });
+
+  it('exposes an accessible name via aria-label', () => {
+    render(
+      <FileDropzone label="Choose a file" ariaLabel="Upload font file" onFileSelect={vi.fn()} />,
+    );
+    expect(screen.getByLabelText('Upload font file')).toBeDefined();
+  });
+
+  it('forwards accept to the native file input', () => {
+    render(
+      <FileDropzone
+        label="Choose a file"
+        ariaLabel="Upload"
+        accept=".zip"
+        onFileSelect={vi.fn()}
+      />,
+    );
+    const input = screen.getByLabelText('Upload') as HTMLInputElement;
+    expect(input.accept).toBe('.zip');
+  });
+
+  it('calls onFileSelect with the picked file', () => {
+    const onFileSelect = vi.fn();
+    render(<FileDropzone label="Choose a file" ariaLabel="Upload" onFileSelect={onFileSelect} />);
+    const input = screen.getByLabelText('Upload') as HTMLInputElement;
+    const file = new File(['content'], 'font.woff2');
+    fireEvent.change(input, { target: { files: [file] } });
+    expect(onFileSelect).toHaveBeenCalledWith(file);
+  });
+
+  it('calls onFileSelect with the dropped file', () => {
+    const onFileSelect = vi.fn();
+    render(<FileDropzone label="Choose a file" ariaLabel="Upload" onFileSelect={onFileSelect} />);
+    const dropzone = screen.getByLabelText('Upload').closest('label');
+    if (!dropzone) throw new Error('dropzone label not found');
+    const file = new File(['content'], 'font.woff2');
+    fireEvent.drop(dropzone, { dataTransfer: { files: [file] } });
+    expect(onFileSelect).toHaveBeenCalledWith(file);
+  });
+
+  it('is disabled when the disabled prop is set', () => {
+    render(
+      <FileDropzone label="Choose a file" ariaLabel="Upload" disabled onFileSelect={vi.fn()} />,
+    );
+    expect((screen.getByLabelText('Upload') as HTMLInputElement).disabled).toBe(true);
+  });
+});

package/src/components/Icon/icons/external-link.tsx

@@ -0,0 +1,22 @@
+// Generated by scripts/generate-icons.ts — do not edit.
+// Source: Lucide (https://lucide.dev) — ISC license, see packages/ui/NOTICE.
+import type { SVGProps } from 'react';
+
+export function ExternalLinkIcon(props: SVGProps<SVGSVGElement>) {
+  return (
+    <svg
+      xmlns="http://www.w3.org/2000/svg"
+      viewBox="0 0 24 24"
+      fill="none"
+      stroke="currentColor"
+      strokeWidth="2"
+      strokeLinecap="round"
+      strokeLinejoin="round"
+      {...props}
+    >
+      <path d="M15 3h6v6" />
+      <path d="M10 14 21 3" />
+      <path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6" />
+    </svg>
+  );
+}

package/src/components/Icon/icons/file.tsx

@@ -0,0 +1,21 @@
+// Generated by scripts/generate-icons.ts — do not edit.
+// Source: Lucide (https://lucide.dev) — ISC license, see packages/ui/NOTICE.
+import type { SVGProps } from 'react';
+
+export function FileIcon(props: SVGProps<SVGSVGElement>) {
+  return (
+    <svg
+      xmlns="http://www.w3.org/2000/svg"
+      viewBox="0 0 24 24"
+      fill="none"
+      stroke="currentColor"
+      strokeWidth="2"
+      strokeLinecap="round"
+      strokeLinejoin="round"
+      {...props}
+    >
+      <path d="M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z" />
+      <path d="M14 2v5a1 1 0 0 0 1 1h5" />
+    </svg>
+  );
+}

package/src/components/Icon/icons/index.ts

@@ -29,6 +29,9 @@ import { AlertTriangleIcon } from './alert-triangle';
 import { CalendarIcon } from './calendar';
 import { SlidersHorizontalIcon } from './sliders-horizontal';
 import { EllipsisVerticalIcon } from './ellipsis-vertical';
+import { FileIcon } from './file';
+import { UploadIcon } from './upload';
+import { ExternalLinkIcon } from './external-link';
 import { BananaIcon } from './banana';
 import { AppleIcon } from './apple';
 import { CarrotIcon } from './carrot';
@@ -80,6 +83,9 @@ export type IconName =
   | 'calendar'
   | 'sliders-horizontal'
   | 'ellipsis-vertical'
+  | 'file'
+  | 'upload'
+  | 'external-link'
   | 'banana'
   | 'apple'
   | 'carrot'
@@ -133,6 +139,9 @@ export const ICONS: Record<IconName, IconComponent> = {
   calendar: CalendarIcon,
   'sliders-horizontal': SlidersHorizontalIcon,
   'ellipsis-vertical': EllipsisVerticalIcon,
+  file: FileIcon,
+  upload: UploadIcon,
+  'external-link': ExternalLinkIcon,
   banana: BananaIcon,
   apple: AppleIcon,
   carrot: CarrotIcon,
@@ -184,6 +193,9 @@ export { AlertTriangleIcon } from './alert-triangle';
 export { CalendarIcon } from './calendar';
 export { SlidersHorizontalIcon } from './sliders-horizontal';
 export { EllipsisVerticalIcon } from './ellipsis-vertical';
+export { FileIcon } from './file';
+export { UploadIcon } from './upload';
+export { ExternalLinkIcon } from './external-link';
 export { BananaIcon } from './banana';
 export { AppleIcon } from './apple';
 export { CarrotIcon } from './carrot';

package/src/components/Icon/icons/upload.tsx

@@ -0,0 +1,22 @@
+// Generated by scripts/generate-icons.ts — do not edit.
+// Source: Lucide (https://lucide.dev) — ISC license, see packages/ui/NOTICE.
+import type { SVGProps } from 'react';
+
+export function UploadIcon(props: SVGProps<SVGSVGElement>) {
+  return (
+    <svg
+      xmlns="http://www.w3.org/2000/svg"
+      viewBox="0 0 24 24"
+      fill="none"
+      stroke="currentColor"
+      strokeWidth="2"
+      strokeLinecap="round"
+      strokeLinejoin="round"
+      {...props}
+    >
+      <path d="M12 3v12" />
+      <path d="m17 8-5-5-5 5" />
+      <path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4" />
+    </svg>
+  );
+}

package/src/components/MemberMultiSelect/MemberMultiSelect.module.css

@@ -0,0 +1,27 @@
+.group {
+  display: grid;
+  gap: var(--sv-space-2);
+}
+
+.label {
+  font-size: var(--sv-font-size-xs);
+  font-weight: var(--sv-font-weight-semibold);
+  color: var(--sv-color-text-muted);
+}
+
+.row {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: var(--sv-space-2);
+}
+
+.trailing {
+  flex-shrink: 0;
+  max-width: 8rem;
+}
+
+.hint {
+  font-size: var(--sv-font-size-xs);
+  color: var(--sv-color-text-muted);
+}

package/src/components/MemberMultiSelect/MemberMultiSelect.stories.tsx

@@ -0,0 +1,74 @@
+import { useState } from 'react';
+import type { Meta, StoryObj } from '@storybook/react-vite';
+import { CurrencyInput } from '../CurrencyInput/CurrencyInput';
+import { MemberMultiSelect, type MemberMultiSelectOption } from './MemberMultiSelect';
+
+const meta = {
+  title: 'Components/MemberMultiSelect',
+  component: MemberMultiSelect,
+  parameters: {
+    layout: 'padded',
+    docs: {
+      description: {
+        component:
+          'Checkbox list for picking any number of people from an already-resolved set of options. Domain-agnostic about who an option represents — instance users and guest members are both just `{id, label}`, so nothing special is needed to include guests. Not a directory search or invite flow; pair with SuggestionInput for that.',
+      },
+    },
+  },
+  args: {
+    options: [],
+    selectedIds: new Set(),
+    onToggle: () => {},
+  },
+} satisfies Meta<typeof MemberMultiSelect>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+const OPTIONS: MemberMultiSelectOption[] = [
+  { id: '1', label: 'Priya' },
+  { id: '2', label: 'Jamie (guest)' },
+  { id: '3', label: 'Sam' },
+];
+
+function ControlledMultiSelect({ withTrailing = false }: { withTrailing?: boolean }) {
+  const [selected, setSelected] = useState<Set<string>>(new Set(['1', '3']));
+  const [amounts, setAmounts] = useState<Record<string, number | null>>({});
+
+  return (
+    <MemberMultiSelect
+      options={OPTIONS}
+      selectedIds={selected}
+      onToggle={(id, checked) => {
+        setSelected((prev) => {
+          const next = new Set(prev);
+          if (checked) next.add(id);
+          else next.delete(id);
+          return next;
+        });
+      }}
+      label="Split between"
+      hint={withTrailing ? 'Remaining: 0.00' : undefined}
+      renderTrailing={
+        withTrailing
+          ? (id) => (
+              <CurrencyInput
+                valueCents={amounts[id] ?? null}
+                onValueChange={(cents) => setAmounts((prev) => ({ ...prev, [id]: cents }))}
+                placeholder="0.00"
+                aria-label={`Amount for ${OPTIONS.find((o) => o.id === id)?.label}`}
+              />
+            )
+          : undefined
+      }
+    />
+  );
+}
+
+export const Default: Story = {
+  render: () => <ControlledMultiSelect />,
+};
+
+export const WithTrailingAmountInput: Story = {
+  render: () => <ControlledMultiSelect withTrailing />,
+};