@seekbuddy/dsh-ui 0.0.0-stage → 0.2.0-beta.1

package/dist/types/seekbuddy/Upload.d.ts

@@ -0,0 +1,101 @@
+/** `button`: a trigger button above the list. `dragger`: a dashed drop zone above the list. */
+export type UploadLayout = 'button' | 'dragger';
+export type UploadStatus = 'uploading' | 'done' | 'error';
+export interface UploadItem {
+    /** Stable identity of the item. */
+    uid: string;
+    /** File name shown in the list. */
+    name: string;
+    /** Bytes. */
+    size: number;
+    /** Transfer state of the item. */
+    status: UploadStatus;
+    /** 0–100. */
+    percent: number;
+    /** Present for files picked locally; absent on items the caller backfills from history. */
+    file?: File | undefined;
+    /** Resolved value of `upload()`. */
+    response?: unknown;
+    /** `Error.message` when `upload()` rejected. */
+    error?: string | undefined;
+    /** Address of a backfilled item, for `onPreview`. */
+    url?: string | undefined;
+}
+/** Why a picked file was refused before entering the list. */
+export type UploadRejectReason = 'accept' | 'size' | 'count';
+export interface UploadRejection {
+    /** The refused file. */
+    file: File;
+    /** Which check refused it. */
+    reason: UploadRejectReason;
+}
+/** All user-visible text, localized by the caller. */
+export interface UploadLabels {
+    /** Button caption; the drop zone's title in the `dragger` layout. */
+    trigger: string;
+    /** Caption under the trigger, e.g. ".zip only, up to 10 MB". */
+    hint?: string | undefined;
+    /** `aria-label` of the file list. */
+    list: string;
+    /** `aria-label` of an item's remove button. */
+    remove: string;
+    /** `aria-label` of a failed item's retry button. */
+    retry: string;
+    /** Status text of an item in progress; also names its progress bar. */
+    uploading: string;
+    /** Status text of a finished item. */
+    done: string;
+    /** Status text of a failed item. */
+    error: string;
+}
+export interface UploadProps {
+    /** Default `button`. */
+    layout?: UploadLayout | undefined;
+    /** Same grammar as the input `accept` attribute; non-matching files go to `onReject('accept')`. */
+    accept?: string | undefined;
+    /** Default `false`: a drop of several files keeps the first. */
+    multiple?: boolean | undefined;
+    /** Upper bound on list length; `1` makes a new file replace the current one (antd). */
+    maxCount?: number | undefined;
+    /** Bytes; larger files go to `onReject('size')`. */
+    maxSize?: number | undefined;
+    /** Disables picking, dropping, retry and remove. */
+    disabled?: boolean | undefined;
+    /** Controlled list; echo `onChange` back. Omit for uncontrolled with `defaultItems`. */
+    items?: UploadItem[] | undefined;
+    /** Initial list when uncontrolled. */
+    defaultItems?: UploadItem[] | undefined;
+    /** Extra check after the built-in ones (e.g. a ZIP magic number); `false` or a rejection keeps the file out. */
+    beforeUpload?: ((file: File, files: File[]) => boolean | Promise<boolean>) | undefined;
+    /**
+     * The only transport hook (antd `customRequest`). Resolve → `done` with the value as `response`;
+     * reject → `error` with the message. `signal` aborts when the item is removed mid-flight.
+     */
+    upload: (file: File, context: {
+        onProgress: (percent: number) => void;
+        signal: AbortSignal;
+    }) => Promise<unknown>;
+    /** Every list change: additions, progress, completion, removal. */
+    onChange?: ((items: UploadItem[]) => void) | undefined;
+    /** Files refused by `accept` / `maxSize` / `maxCount`, batched per pick, for the caller to toast. */
+    onReject?: ((rejections: UploadRejection[]) => void) | undefined;
+    /** Return `false` to keep the item. */
+    onRemove?: ((item: UploadItem) => boolean | Promise<boolean>) | undefined;
+    /** Makes file names clickable. */
+    onPreview?: ((item: UploadItem) => void) | undefined;
+    /** Default `true`. */
+    showList?: boolean | undefined;
+    /** All visible and screen-reader text; see `UploadLabels`. */
+    labels: UploadLabels;
+    /** Extra class on the root element, for layout. */
+    className?: string | undefined;
+}
+/**
+ * File picker with a status list: pick or drop → built-in `accept` / `maxSize` / `maxCount`
+ * filter → `beforeUpload` → the item enters the list as `uploading` and `upload()` runs with a
+ * progress callback and an abort signal. The component never talks to the network itself — the
+ * transport (multipart POST, presigned PUT, …) belongs to the caller. Text comes
+ * from `labels`; the component has no strings of its own. Client Component (state, refs),
+ * aggregate entry only.
+ */
+export declare function Upload({ layout, accept, multiple, maxCount, maxSize, disabled, items, defaultItems, beforeUpload, upload, onChange, onReject, onRemove, onPreview, showList, labels, className, }: UploadProps): import("react").JSX.Element;

package/dist/types/seekbuddy/date/Calendar.d.ts

@@ -0,0 +1,94 @@
+import type { DateRange, IsoDate, IsoMonth, WeekStart } from './date.js';
+/** Cell state handed to `labels.dayLabel` so the caller can phrase the screen-reader sentence. */
+export interface CalendarDayState {
+    /** Single mode: the value. Range mode: the start or the end. */
+    selected: boolean;
+    /** The cell is today (`today` prop, or the host's local date). */
+    today: boolean;
+    /** Outside `min` / `max` or refused by `isDateDisabled`. */
+    disabled: boolean;
+    /** Range mode: inside the committed range (ends included). Always false in single mode. */
+    inRange: boolean;
+}
+export interface CalendarLabels {
+    /** `aria-label` of the previous-month button. */
+    previousMonth: string;
+    /** `aria-label` of the next-month button. */
+    nextMonth: string;
+    /** `aria-label` of the previous-year button. */
+    previousYear: string;
+    /** `aria-label` of the next-year button. */
+    nextYear: string;
+    /**
+     * Screen-reader name of one day cell, `(date, state)` → a full sentence such as
+     * "Wednesday, November 24, 2032, selected". Week / month names come from `locale`; this is the only per-cell copy.
+     */
+    dayLabel: (date: IsoDate, state: CalendarDayState) => string;
+}
+export interface CalendarBaseProps {
+    /** Controlled visible month (the left one when two are shown); uncontrolled follows `value`, then `today`. */
+    month?: IsoMonth | undefined;
+    /** Called with the new visible month when the user navigates. */
+    onMonthChange?: ((month: IsoMonth) => void) | undefined;
+    /** Months side by side; single mode defaults to 1, range mode to 2. */
+    numberOfMonths?: 1 | 2 | undefined;
+    /** Earliest selectable day, inclusive. */
+    min?: IsoDate | undefined;
+    /** Latest selectable day, inclusive. */
+    max?: IsoDate | undefined;
+    /** Extra disabling rule on top of `min` / `max` ("weekdays only"). */
+    isDateDisabled?: ((date: IsoDate) => boolean) | undefined;
+    /** BCP 47 tag driving weekday / month names; defaults to the browser language. */
+    locale?: string | undefined;
+    /** 1 = Monday (default), 0 = Sunday. */
+    weekStart?: WeekStart | undefined;
+    /** Injected "today" for tests and non-local zones; defaults to the host's local date. */
+    today?: IsoDate | undefined;
+    /** Navigation and screen-reader text; see `CalendarLabels`. */
+    labels: CalendarLabels;
+    /** Move focus to the tab-stop cell (selected → today → first enabled) on mount. */
+    autoFocus?: boolean | undefined;
+    /** Extra class on the root element, for layout. */
+    className?: string | undefined;
+}
+export interface CalendarSingleProps extends CalendarBaseProps {
+    /** `single` picks one day; `range` picks a start and an end. */
+    mode: 'single';
+    /** Selected day, or `null` for none. */
+    value: IsoDate | null;
+    /** Called with the picked day. */
+    onChange: (date: IsoDate) => void;
+}
+/** A range whose end is still being picked (`end: null`); `DateRange` is the completed form. */
+export interface DateRangeDraft {
+    /** The first picked day. */
+    start: IsoDate;
+    /** `null` until the second day is picked. */
+    end: IsoDate | null;
+}
+export interface CalendarRangeProps extends CalendarBaseProps {
+    /** `single` picks one day; `range` picks a start and an end. */
+    mode: 'range';
+    /** Pass the draft back as-is while the end is pending — the component is fully controlled. */
+    value: DateRange | DateRangeDraft | null;
+    /**
+     * First pick → `{ start, end: null }`; second pick → the ordered `DateRange` (a reversed
+     * pick swaps the ends). A third pick starts a new draft.
+     */
+    onChange: (range: DateRange | DateRangeDraft) => void;
+}
+export type CalendarProps = CalendarSingleProps | CalendarRangeProps;
+/** Position of a cell inside a committed or previewed range (`data-range` / `data-range-preview`). */
+export type CalendarRangePosition = 'start' | 'middle' | 'end' | 'single';
+/**
+ * Month grid with WAI-ARIA grid keyboard support: one roving tab stop for the whole calendar,
+ * arrows move by day / week, Home / End to the week's ends, PageUp / PageDown by month
+ * (Shift: by year), Enter / Space pick. Moving focus past the visible months turns the page.
+ * Padding days from the neighbouring months are visible, clickable (they turn the page as
+ * they pick) and never the tab stop. Range mode adds a two-pick state machine: after the
+ * start is picked, hovering or keyboard-focusing a day previews the range (`data-range-preview`),
+ * the second pick commits it ordered, and committed cells carry `data-range` positions.
+ * Upstream primitives ship no calendar, so this package provides
+ * one; `DatePicker` / `DateRangePicker` compose it.
+ */
+export declare function Calendar(props: CalendarProps): import("react").JSX.Element;

package/dist/types/seekbuddy/date/DatePicker.d.ts

@@ -0,0 +1,29 @@
+import type { CalendarBaseProps, CalendarLabels } from './Calendar.js';
+import type { IsoDate } from './date.js';
+export interface DatePickerLabels extends CalendarLabels {
+    /** The "Today" shortcut button. */
+    today: string;
+    /** Footer text while nothing is selected. */
+    empty: string;
+}
+export interface DatePickerProps extends Omit<CalendarBaseProps, 'numberOfMonths' | 'labels'> {
+    /** Selected day, or `null` for none. */
+    value: IsoDate | null;
+    /** Fires on every cell pick and on "Today" — no draft / apply step. */
+    onChange: (date: IsoDate) => void;
+    /** All visible and screen-reader text; see `DatePickerLabels`. */
+    labels: DatePickerLabels;
+    /**
+     * Footer rendering of the selected day; defaults to an Intl medium date with a short weekday
+     * in `locale` ("Wed, Nov 24, 2032" / "2032年11月24日周三").
+     */
+    formatSelected?: ((date: IsoDate) => string) | undefined;
+}
+/**
+ * Single-date panel: `Calendar mode="single"` plus a footer
+ * with the formatted selection on the left and a "Today" shortcut on the right. "Today" turns
+ * the page to the current month and selects it; it is disabled when today is outside
+ * `min` / `max` or rejected by `isDateDisabled`. The month is owned here (controlled into the
+ * calendar) so the shortcut can turn the page even when today is already the value.
+ */
+export declare function DatePicker({ value, onChange, labels, formatSelected, month, onMonthChange, min, max, isDateDisabled, locale, today: todayProp, className, ...calendar }: DatePickerProps): import("react").JSX.Element;

package/dist/types/seekbuddy/date/DateRangePicker.d.ts

@@ -0,0 +1,41 @@
+import type { CalendarBaseProps, CalendarLabels } from './Calendar.js';
+import type { DateRange } from './date.js';
+export interface DateRangePreset {
+    /** Stable identity of the preset. */
+    key: string;
+    /** Visible preset text, e.g. "Last 7 days". */
+    label: string;
+    /** Computed by the caller — "last 7 days" depends on today and the time zone, not on the component. */
+    range: DateRange;
+}
+export interface DateRangePickerLabels extends CalendarLabels {
+    /** Accessible name of the presets list. */
+    presets: string;
+    /** Caption of the button that discards the draft. */
+    cancel: string;
+    /** Caption of the button that commits the range. */
+    apply: string;
+    /** Status shown (and announced) while the start is picked and the end is still pending. */
+    pickEnd: string;
+}
+export interface DateRangePickerProps extends Omit<CalendarBaseProps, 'labels'> {
+    /** Committed range, or `null` for none. */
+    value: DateRange | null;
+    /** Fires only when "Apply" is pressed with a complete range. */
+    onChange: (range: DateRange) => void;
+    /** Fires after "Cancel" rolled the draft back to `value`. */
+    onCancel?: (() => void) | undefined;
+    /** Shortcut ranges listed on the left; omit to hide the list. */
+    presets?: ReadonlyArray<DateRangePreset> | undefined;
+    /** All visible and screen-reader text; see `DateRangePickerLabels`. */
+    labels: DateRangePickerLabels;
+}
+/**
+ * Range panel: presets on the left, a two-month range
+ * `Calendar` in the middle, "Cancel / Apply" below. Picks inside the panel only edit a draft;
+ * `onChange` fires once on "Apply" with a complete range, "Cancel" restores `value` and calls
+ * `onCancel`. Choosing a preset replaces the draft and turns the page to its start month; a
+ * preset shows a check while the draft equals it exactly. The month is owned here (controlled
+ * into the calendar) so presets can turn the page. Tab order: presets → calendar → Cancel → Apply.
+ */
+export declare function DateRangePicker({ value, onChange, onCancel, presets, labels, month, onMonthChange, numberOfMonths, today: todayProp, className, ...calendar }: DateRangePickerProps): import("react").JSX.Element;

package/dist/types/seekbuddy/date/TimePicker.d.ts

@@ -0,0 +1,35 @@
+import type { IsoTime } from './date.js';
+export type MinuteStep = 1 | 5 | 10 | 15 | 30;
+export interface TimePickerLabels {
+    /** Hours column heading, also the listbox's accessible name. */
+    hours: string;
+    /** Minutes column heading, also the listbox's accessible name. */
+    minutes: string;
+}
+export interface TimePickerProps {
+    /** 24-hour `HH:mm`; `null` highlights the 00:00 position without reporting a value. */
+    value: IsoTime | null;
+    /** Fires on every pick — column click or ↑ / ↓ / Home / End inside a column. */
+    onChange: (time: IsoTime) => void;
+    /** Minute granularity; the minutes column lists only multiples of the step. Default 1. */
+    minuteStep?: MinuteStep | undefined;
+    /** Earliest selectable time, inclusive; earlier options are disabled. */
+    min?: IsoTime | undefined;
+    /** Latest selectable time, inclusive; later options are disabled. */
+    max?: IsoTime | undefined;
+    /** Column headings; see `TimePickerLabels`. */
+    labels: TimePickerLabels;
+    /** Focus the hours column on mount. */
+    autoFocus?: boolean | undefined;
+    /** Extra class on the root element, for layout. */
+    className?: string | undefined;
+}
+/**
+ * Two-column time list: hours 00–23 and minutes in
+ * `minuteStep`, each a `role="listbox"` with one tab stop and `aria-activedescendant`;
+ * ↑ / ↓ / Home / End move the selection and fire `onChange` at once, clicks do the same,
+ * nothing wraps. `min` / `max` disable hours with no reachable minute and minutes outside the
+ * window; a pick that would leave the window is clamped into it. The highlighted option
+ * scrolls to the column's centre on mount and on every change. Upstream ships no time picker.
+ */
+export declare function TimePicker({ value, onChange, minuteStep, min, max, labels, autoFocus, className, }: TimePickerProps): import("react").JSX.Element;

package/dist/types/seekbuddy/date/date.d.ts

@@ -0,0 +1,79 @@
+/** Calendar day, `YYYY-MM-DD`. */
+export type IsoDate = `${number}-${number}-${number}`;
+/** Calendar month, `YYYY-MM`. */
+export type IsoMonth = `${number}-${number}`;
+/** Wall-clock time, 24-hour `HH:mm`. */
+export type IsoTime = `${number}:${number}`;
+/** Closed interval, `start <= end`. */
+export interface DateRange {
+    /** First day of the range, inclusive. */
+    start: IsoDate;
+    /** Last day of the range, inclusive. */
+    end: IsoDate;
+}
+/** First day of the week: 1 = Monday, 0 = Sunday. */
+export type WeekStart = 0 | 1;
+export interface DateParts {
+    y: number;
+    m: number;
+    d: number;
+}
+/** Days in a month (`m` is 1-based). */
+export declare function daysInMonth(y: number, m: number): number;
+/** Split `YYYY-MM-DD`; throws `RangeError` on malformed or impossible dates ("2025-02-30"). */
+export declare function parseIsoDate(iso: string): DateParts;
+export declare function formatIsoDate({ y, m, d }: DateParts): IsoDate;
+/** Split `YYYY-MM`; throws `RangeError` when malformed. */
+export declare function parseIsoMonth(month: string): {
+    y: number;
+    m: number;
+};
+export declare function formatIsoMonth(y: number, m: number): IsoMonth;
+/** The month a date belongs to. */
+export declare function monthOf(iso: IsoDate): IsoMonth;
+/** Today in the host's local time zone (the only place local time is consulted). */
+export declare function todayIso(): IsoDate;
+export declare function addDays(iso: IsoDate, n: number): IsoDate;
+export declare function addMonths(month: IsoMonth, n: number): IsoMonth;
+/**
+ * Same-day-of-month shift that clamps to the target month's length
+ * (2025-01-31 + 1 month → 2025-02-28); used by PageUp / PageDown.
+ */
+export declare function addMonthsToDate(iso: IsoDate, n: number): IsoDate;
+/** Lexicographic order is chronological for zero-padded ISO dates, months and times. */
+export declare function compareIso(a: string, b: string): -1 | 0 | 1;
+/** 0 = Sunday … 6 = Saturday. */
+export declare function weekdayOf(iso: IsoDate): number;
+/** Distance in days from the start of the week (`0` on the week's first day). */
+export declare function weekOffset(iso: IsoDate, weekStart: WeekStart): number;
+/**
+ * Six rows × seven columns covering `month`, padded with the surrounding months' days so
+ * every rendered grid has the same height (the 42 cells the mockups show in grey).
+ */
+export declare function monthGrid(month: IsoMonth, weekStart: WeekStart): IsoDate[];
+export declare function isInRange(iso: IsoDate, range: DateRange): boolean;
+/** Orders two picks into a closed range (clicking the end before the start swaps them). */
+export declare function normalizeRange(a: IsoDate, b: IsoDate): DateRange;
+/** True when `iso` is outside `[min, max]` (either bound optional). */
+export declare function isOutsideBounds(iso: IsoDate, min: IsoDate | undefined, max: IsoDate | undefined): boolean;
+export type WeekdayNameStyle = 'narrow' | 'short' | 'long';
+/** Seven weekday names in `locale`, starting at `weekStart` ("Mon Tue …" or "一 二 …"). */
+export declare function weekdayNames(locale: string | undefined, weekStart: WeekStart, style?: WeekdayNameStyle): string[];
+/** Month heading in `locale` ("November 2032" / "2032年11月"). */
+export declare function monthTitle(locale: string | undefined, month: IsoMonth): string;
+/** Format a calendar day with any `Intl.DateTimeFormat` options (time zone is pinned to UTC). */
+export declare function formatDate(locale: string | undefined, iso: IsoDate, options: Intl.DateTimeFormatOptions): string;
+/** Full date in `locale` for screen readers ("Wednesday, November 24, 2032"). */
+export declare function formatDateLong(locale: string | undefined, iso: IsoDate): string;
+/** Compact date with weekday for pickers' footers ("Wed, Nov 24, 2032" / "2032年11月24日周三"). */
+export declare function formatDateMedium(locale: string | undefined, iso: IsoDate): string;
+/** Split `HH:mm`; throws `RangeError` outside 00:00–23:59. */
+export declare function parseIsoTime(time: string): {
+    h: number;
+    min: number;
+};
+export declare function timeToMinutes(time: IsoTime): number;
+/** Minutes since midnight → `HH:mm`; wraps around the day. */
+export declare function minutesToTime(minutes: number): IsoTime;
+/** Clamp into `[min, max]` (either bound optional). */
+export declare function clampTime(time: IsoTime, min: IsoTime | undefined, max: IsoTime | undefined): IsoTime;

package/dist/types/seekbuddy/date/fields.d.ts

@@ -0,0 +1,45 @@
+import type { DatePickerProps } from './DatePicker.js';
+import type { DateRangePickerProps } from './DateRangePicker.js';
+import type { TimePickerProps } from './TimePicker.js';
+import type { DateRange, IsoDate, IsoTime } from './date.js';
+/** Labels every trigger adds on top of its panel's labels. */
+export interface FieldLabels {
+    /** Read after the value on the trigger ("open date picker") and used as the dialog's name. */
+    open: string;
+}
+export interface DateFieldProps extends DatePickerProps {
+    /** Trigger text for the value; defaults to `YYYY/MM/DD`. */
+    formatValue?: ((date: IsoDate | null) => string) | undefined;
+    /** Trigger text while `value` is `null`. */
+    placeholder?: string | undefined;
+    /** Disables the trigger; the panel cannot open. */
+    disabled?: boolean | undefined;
+    /** The panel's labels plus `open` for the trigger; see `FieldLabels`. */
+    labels: DatePickerProps['labels'] & FieldLabels;
+}
+/** Input-looking trigger that opens a `DatePicker`; a pick (or "Today") closes the panel. */
+export declare function DateField({ formatValue, placeholder, disabled, className, labels, onChange, ...picker }: DateFieldProps): import("react").JSX.Element;
+export interface DateRangeFieldProps extends Omit<DateRangePickerProps, 'onCancel'> {
+    /** Trigger text for the value; defaults to `YYYY/MM/DD - YYYY/MM/DD`. */
+    formatValue?: ((range: DateRange | null) => string) | undefined;
+    /** Trigger text while `value` is `null`. */
+    placeholder?: string | undefined;
+    /** Disables the trigger; the panel cannot open. */
+    disabled?: boolean | undefined;
+    /** The panel's labels plus `open` for the trigger; see `FieldLabels`. */
+    labels: DateRangePickerProps['labels'] & FieldLabels;
+}
+/** Input-looking trigger that opens a `DateRangePicker`; "Apply" reports and closes, "Cancel" just closes. */
+export declare function DateRangeField({ formatValue, placeholder, disabled, className, labels, onChange, ...picker }: DateRangeFieldProps): import("react").JSX.Element;
+export interface TimeFieldProps extends TimePickerProps {
+    /** Trigger text for the value; defaults to the `HH:mm` string itself. */
+    formatValue?: ((time: IsoTime | null) => string) | undefined;
+    /** Trigger text while `value` is `null`. */
+    placeholder?: string | undefined;
+    /** Disables the trigger; the panel cannot open. */
+    disabled?: boolean | undefined;
+    /** The panel's labels plus `open` for the trigger; see `FieldLabels`. */
+    labels: TimePickerProps['labels'] & FieldLabels;
+}
+/** Input-looking trigger that opens a `TimePicker`; picks keep the panel open (both columns are usually adjusted). */
+export declare function TimeField({ formatValue, placeholder, disabled, className, labels, ...picker }: TimeFieldProps): import("react").JSX.Element;

package/dist/types/seekbuddy/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Extra components (`@seekbuddy/dsh-ui/seekbuddy`).
+ *
+ * Everything outside this directory is a copy of the upstream DSH primitives and
+ * is only touched by synchronization (see UPSTREAM.md). Components here are owned
+ * by this package and styled only through `--dsw-*` tokens. They must import DSH
+ * primitives through the public `@seekbuddy/dsh-ui` entry — never by relative
+ * path — so a bundler can alias that entry to another copy of the primitives
+ * (such as the one a DSH web shell already loads).
+ */
+export { Calendar } from './date/Calendar.js';
+export { Card } from './Card.js';
+export type { CardElement, CardPadding, CardProps } from './Card.js';
+export { DangerButton } from './DangerButton.js';
+export type { DangerButtonProps } from './DangerButton.js';
+export { SubtleButton } from './SubtleButton.js';
+export type { SubtleButtonProps } from './SubtleButton.js';
+export type { CalendarBaseProps, CalendarDayState, CalendarLabels, CalendarProps, CalendarRangePosition, CalendarRangeProps, CalendarSingleProps, DateRangeDraft, } from './date/Calendar.js';
+export { DatePicker } from './date/DatePicker.js';
+export type { DatePickerLabels, DatePickerProps } from './date/DatePicker.js';
+export { DateRangePicker } from './date/DateRangePicker.js';
+export type { DateRangePickerLabels, DateRangePickerProps, DateRangePreset } from './date/DateRangePicker.js';
+export { DateField, DateRangeField, TimeField } from './date/fields.js';
+export type { DateFieldProps, DateRangeFieldProps, FieldLabels, TimeFieldProps } from './date/fields.js';
+export { TimePicker } from './date/TimePicker.js';
+export type { MinuteStep, TimePickerLabels, TimePickerProps } from './date/TimePicker.js';
+export type { DateRange, IsoDate, IsoMonth, IsoTime, WeekStart } from './date/date.js';
+export { Empty } from './Empty.js';
+export type { EmptyProps, EmptyStatus } from './Empty.js';
+export { Mark } from './Mark.js';
+export type { MarkKind, MarkProps, MarkSize } from './Mark.js';
+export { MessageProvider, useMessage } from './Message.js';
+export type { MessageApi, MessageClose, MessageOptions, MessageProviderProps, MessageType } from './Message.js';
+export { Pagination, pageItems } from './Pagination.js';
+export type { PaginationItem, PaginationLabels, PaginationProps } from './Pagination.js';
+export { QrCode } from './qr/QrCode.js';
+export type { QrCodeProps } from './qr/QrCode.js';
+export { Spinner } from './Spinner.js';
+export type { SpinnerProps, SpinnerSize, SpinnerTone } from './Spinner.js';
+export { StatusBadge } from './StatusBadge.js';
+export type { StatusBadgeProps, StatusTone } from './StatusBadge.js';
+export { Switch } from './Switch.js';
+export type { SwitchProps, SwitchSize } from './Switch.js';
+export { Tabs } from './Tabs.js';
+export type { TabItem, TabsProps } from './Tabs.js';
+export { Timeline } from './Timeline.js';
+export type { TimelineGroup, TimelineItem, TimelineProps, TimelineStatus } from './Timeline.js';
+export { Upload } from './Upload.js';
+export type { UploadItem, UploadLabels, UploadLayout, UploadProps, UploadRejection, UploadRejectReason, UploadStatus, } from './Upload.js';

package/dist/types/seekbuddy/qr/QrCode.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 把 QR 矩阵画成一张 SVG。
+ *
+ * 画法上两个取舍：
+ * - **一条 `path` 画完所有黑块**，而不是每个模块一个 `rect`：版本 20 有 9409 个模块，
+ *   铺成近万个节点会让弹窗肉眼可见地卡一下；
+ * - **留 4 个模块的静区**（规范要求），否则贴着深色背景的码扫不出来。
+ *
+ * **编码在组件内做**：聚合入口只许转发（`dist/seekbuddy.js` 不能自带运行时代码），
+ * 所以纯函数 `encodeQr` 不对外导出，调用方给文本、拿图。编不出来（空串或超出版本 20）时
+ * 渲染 `fallback`——典型是一条明文链接，宁可退回链接也不画一张扫不出来的码。
+ *
+ * @module
+ */
+import { type ReactNode } from 'react';
+/**
+ * QrCode 属性契约
+ */
+export interface QrCodeProps {
+    /** Text to encode (byte mode, up to 666 bytes). */
+    text: string;
+    /** Accessible name of the image; localized by the caller. */
+    label: string;
+    /** Rendered instead when the text cannot be encoded (empty or too long), typically the link as text. Renders nothing when omitted. */
+    fallback?: ReactNode | undefined;
+    /** Edge length in px. Default 180. */
+    size?: number | undefined;
+    /** Extra class on the root element, for layout. */
+    className?: string | undefined;
+}
+/**
+ * QR code drawn as a single-path SVG with a 4-module quiet zone, black on white in both themes
+ * (scanners need the contrast, so no theme tokens). Encodes in byte mode at error-correction
+ * level M, versions 1–20. Text that cannot be encoded (empty, or over 666 bytes) renders
+ * `fallback` instead.
+ */
+export declare function QrCode({ text, label, fallback, size, className }: QrCodeProps): string | number | boolean | import("react").JSX.Element | Iterable<ReactNode> | null;

package/dist/types/seekbuddy/qr/qr.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 最小 QR 编码器：把一段文本编成 QR 的模块矩阵，纯函数、无依赖、不碰 DOM。
+ *
+ * **为什么自己写而不是装一个库**：扩展组件会被使用方整份打进浏览器包；
+ * 现成的 QR 库要么带 canvas / fs 这类 Node 面（`qrcode` 就是），要么整包拉进来只为画一张码。
+ * 而要画的东西非常单一——一段链接——把编码规则直接写下来更省也更可控。
+ *
+ * **刻意收窄的范围**（够用即止，超出范围时返回 null，由调用方退回纯链接）：
+ * - 只做 **byte 模式**：要编的是 URL，大小写混排，用不上 alphanumeric 那套省位；
+ * - 只做 **纠错等级 M**：屏幕上扫，15% 冗余足够，也让分块表只需要一列；
+ * - 只做 **版本 1–20**（≤666 字节）：链接几百字符封顶，再长的码在屏幕上也难扫。
+ *
+ * 实现按 ISO/IEC 18004 的常规步骤：选版本 → 拼比特流 → 分块算 RS 纠错 → 交错 →
+ * 铺功能图形 → 之字形填数据 → 八种掩模挑罚分最低的 → 写格式信息（v≥7 再写版本信息）。
+ *
+ * 正确性不靠「看起来像个码」：`tests/qr.test.mjs` 拿 `qrcode` 这个成熟实现当参照物，
+ * 逐版本比对整张矩阵（版本、掩模、每一个模块都要一致）。分块表与对齐图形表写错会当场露出来。
+ *
+ * @module
+ */
+/**
+ * 编码结果：正方形模块矩阵。
+ */
+export interface QrMatrix {
+    /** 边长（模块数） */
+    readonly size: number;
+    /** 行优先的模块，`true` 为黑 */
+    readonly modules: readonly boolean[];
+    /** 实际用到的版本号（1–20） */
+    readonly version: number;
+}
+/**
+ * 把文本编成 QR 矩阵（byte 模式，纠错等级 M）。
+ *
+ * @param text - 待编码文本（按 UTF-8 取字节）
+ * @returns 矩阵；空串或超出版本 20 的容量时返回 null（调用方退回纯链接）
+ */
+export declare function encodeQr(text: string): QrMatrix | null;

package/dist/types/theme-bootstrap.d.ts

@@ -0,0 +1,3 @@
+export { DEFAULT_PREFERENCE, THEME_STORAGE_KEY } from './theme-core.js';
+/** Inline this before application content in the root layout to avoid a saved-theme flash. */
+export declare const THEME_BOOTSTRAP_SCRIPT = "(function(){try{var k='dsh-ui-primitives.theme-preference',v=localStorage.getItem(k);if(v!=='light'&&v!=='dark'&&v!=='system')v='system';var d=v==='dark'||(v==='system'&&matchMedia('(prefers-color-scheme: dark)').matches);document.documentElement.style.colorScheme=d?'dark':'light';document.body.toggleAttribute('data-ds-dark-theme',d)}catch(e){var d=matchMedia('(prefers-color-scheme: dark)').matches;document.documentElement.style.colorScheme=d?'dark':'light';document.body.toggleAttribute('data-ds-dark-theme',d)}})();";

package/dist/types/theme-core.d.ts

@@ -0,0 +1,14 @@
+export declare const THEME_PREFERENCES: readonly ['light', 'dark', 'system'];
+export type ThemePreference = (typeof THEME_PREFERENCES)[number];
+export declare const DEFAULT_PREFERENCE: ThemePreference;
+export declare const THEME_STORAGE_KEY = "dsh-ui-primitives.theme-preference";
+type ThemeListener = () => void;
+export declare function isThemePreference(value: unknown): value is ThemePreference;
+export declare function resolveDark(preference: ThemePreference): boolean;
+export declare function applyTheme(preference: ThemePreference): void;
+export declare function initializeTheme(): ThemePreference;
+export declare function setThemePreference(preference: ThemePreference): void;
+export declare function getThemePreference(): ThemePreference;
+export declare function getIsDark(): boolean;
+export declare function subscribeTheme(listener: ThemeListener): () => void;
+export {};

package/dist/types/theme.d.ts

@@ -0,0 +1,4 @@
+export { DEFAULT_PREFERENCE, THEME_PREFERENCES, THEME_STORAGE_KEY, applyTheme, getIsDark, getThemePreference, initializeTheme, isThemePreference, resolveDark, setThemePreference, } from './theme-core.js';
+export type { ThemePreference } from './theme-core.js';
+export declare function useThemePreference(): "dark" | "light" | "system";
+export declare function useIsDark(): boolean;

package/dist/types/tooltip-placement.d.ts

@@ -0,0 +1,34 @@
+/** Deterministic tooltip placement using measured border boxes and viewport coordinates. */
+/** Bubble placement relative to the anchor. */
+export type TooltipSide = 'right' | 'left' | 'bottom' | 'top';
+interface PlacementInput {
+    anchor: {
+        left: number;
+        right: number;
+        top: number;
+        bottom: number;
+    };
+    width: number;
+    height: number;
+    viewportWidth: number;
+    viewportHeight: number;
+    side: TooltipSide;
+    align: 'center' | 'end';
+    gap: number;
+}
+interface TooltipPlacement {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+    side: TooltipSide;
+    /** No complete side fits, so placement is bounded by the viewport instead. */
+    overflow: boolean;
+}
+/**
+ * Prefer the requested side, its opposite, then perpendicular sides without covering the anchor.
+ * @param input - Observed dimensions, anchor edges, viewport and requested placement; horizontal gaps remain 10px.
+ * @returns Border-box coordinates and the selected side; if no side fits, a viewport-bounded fallback.
+ */
+export declare function placeTooltip(input: PlacementInput): TooltipPlacement;
+export {};

package/dist/types/use-clipboard-copy.d.ts

@@ -0,0 +1,13 @@
+/** Clipboard action and its temporary success state. */
+export interface ClipboardCopyState {
+    /** True for one second after an accepted clipboard write. */
+    readonly copied: boolean;
+    /** Write the current text unless a write or success indication is already active. */
+    readonly onCopy: () => void;
+}
+/**
+ * Keep clipboard feedback local to the mounted control and release its reset timer on unmount.
+ * @param text - Exact text to copy when the action is invoked.
+ * @returns Success feedback and a callback stable while text and feedback are unchanged.
+ */
+export declare function useClipboardCopy(text: string): ClipboardCopyState;

package/dist/types/useAnchoredMaxHeight.d.ts

@@ -0,0 +1,13 @@
+import type { RefObject } from 'react';
+/**
+ * Clamp a bottom-anchored overlay's max-height to the viewport.
+ * @param ref - the overlay element; a null current (overlay closed) skips measuring.
+ * @param cap - design max-height in px (the clamp never exceeds it).
+ * @param signal - re-measure trigger: pass the overlay's render state so anchor
+ *   moves (composer growth) re-fit; resize/scroll re-fit while mounted.
+ * @param margin - viewport top margin floor in px; the frame's overlay
+ *   inset widens it. Callers under fixed chrome (the conversation header)
+ *   raise it past their chrome's height.
+ * @returns the max-height to apply inline, in px.
+ */
+export declare function useAnchoredMaxHeight(ref: RefObject<HTMLElement | null>, cap: number, signal: unknown, margin?: number): number;