@wealth-os/design-system 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (60) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +81 -2
  3. package/dist/button-MVZPcSXf.js +41 -0
  4. package/dist/charts.d.ts +138 -0
  5. package/dist/charts.js +712 -0
  6. package/dist/command-menu.d.ts +3 -0
  7. package/dist/command-menu.js +41 -0
  8. package/dist/components/advanced-controls.d.ts +138 -0
  9. package/dist/components/badge.d.ts +9 -0
  10. package/dist/components/button-group.d.ts +15 -0
  11. package/dist/components/button.d.ts +11 -0
  12. package/dist/components/command-menu.d.ts +42 -0
  13. package/dist/components/data-display.d.ts +100 -0
  14. package/dist/components/data-table.d.ts +113 -0
  15. package/dist/components/date-input.d.ts +34 -0
  16. package/dist/components/date-range-picker.d.ts +21 -0
  17. package/dist/components/field.d.ts +18 -0
  18. package/dist/components/financial.d.ts +83 -0
  19. package/dist/components/form.d.ts +8 -0
  20. package/dist/components/icon-button.d.ts +11 -0
  21. package/dist/components/icons.d.ts +9 -0
  22. package/dist/components/navigation.d.ts +47 -0
  23. package/dist/components/notice.d.ts +11 -0
  24. package/dist/components/number-input.d.ts +42 -0
  25. package/dist/components/overlays.d.ts +91 -0
  26. package/dist/components/select-menu.d.ts +25 -0
  27. package/dist/components/select.d.ts +21 -0
  28. package/dist/components/status-badge.d.ts +9 -0
  29. package/dist/components/surface.d.ts +15 -0
  30. package/dist/components/text-input.d.ts +6 -0
  31. package/dist/components/textarea.d.ts +5 -0
  32. package/dist/components/validation-message.d.ts +8 -0
  33. package/dist/data-display-BA7t1E4G.js +278 -0
  34. package/dist/data-table.d.ts +2 -0
  35. package/dist/data-table.js +346 -0
  36. package/dist/financial.d.ts +1 -0
  37. package/dist/financial.js +178 -0
  38. package/dist/form-D3G5306m.js +74 -0
  39. package/dist/forms.d.ts +39 -0
  40. package/dist/forms.js +32 -0
  41. package/dist/index.d.ts +22 -0
  42. package/dist/index.js +1382 -0
  43. package/dist/lib/utils.d.ts +3 -0
  44. package/dist/navigation.d.ts +3 -0
  45. package/dist/navigation.js +222 -0
  46. package/dist/notice-D5u9rkFU.js +49 -0
  47. package/dist/overlays-9ArfwHJo.js +219 -0
  48. package/dist/overlays.d.ts +7 -0
  49. package/dist/overlays.js +2 -0
  50. package/dist/reset.css +16 -0
  51. package/dist/styles.css +3 -0
  52. package/dist/tokens.css +118 -0
  53. package/dist/utils-CX-Pz5p6.js +8 -0
  54. package/docs/accessibility.md +128 -0
  55. package/docs/charts.md +47 -0
  56. package/docs/components.md +242 -0
  57. package/docs/data-table.md +87 -0
  58. package/docs/layout-composition.md +224 -0
  59. package/docs/tokens.md +94 -0
  60. package/package.json +116 -4
@@ -0,0 +1,41 @@
1
+ /* empty css */
2
+ import { t as e } from "./utils-CX-Pz5p6.js";
3
+ import { h as t, p as n } from "./overlays-9ArfwHJo.js";
4
+ import "react";
5
+ import { jsx as r, jsxs as i } from "react/jsx-runtime";
6
+ import { Command as a } from "cmdk";
7
+ //#region src/components/command-menu.tsx
8
+ function o({ open: e, onOpenChange: o, label: s = "Command menu", placeholder: c = "Search commands…", emptyMessage: l = "No results found.", children: u }) {
9
+ return /* @__PURE__ */ r(n, {
10
+ open: e,
11
+ onOpenChange: o,
12
+ children: /* @__PURE__ */ r(t, {
13
+ "aria-label": s,
14
+ "aria-describedby": void 0,
15
+ className: "overflow-hidden p-0",
16
+ children: /* @__PURE__ */ i(a, {
17
+ label: s,
18
+ className: "flex max-h-[min(70dvh,32rem)] flex-col",
19
+ children: [/* @__PURE__ */ r(a.Input, {
20
+ placeholder: c,
21
+ className: "h-12 border-b border-border bg-transparent px-4 type-control outline-none placeholder:text-muted-foreground"
22
+ }), /* @__PURE__ */ i(a.List, {
23
+ className: "overflow-y-auto p-2",
24
+ children: [/* @__PURE__ */ r(a.Empty, {
25
+ className: "p-4 text-center type-supporting text-muted-foreground",
26
+ children: l
27
+ }), u]
28
+ })]
29
+ })
30
+ })
31
+ });
32
+ }
33
+ var s = a.Group, c = a.Item, l = a.Separator;
34
+ function u({ className: t, ...n }) {
35
+ return /* @__PURE__ */ r("span", {
36
+ className: e("ml-auto type-metadata tracking-wide text-muted-foreground", t),
37
+ ...n
38
+ });
39
+ }
40
+ //#endregion
41
+ export { o as CommandMenu, s as CommandMenuGroup, c as CommandMenuItem, l as CommandMenuSeparator, u as CommandMenuShortcut };
@@ -0,0 +1,138 @@
1
+ import * as React from "react";
2
+ export type ChoiceOption<T extends string = string> = {
3
+ value: T;
4
+ label: string;
5
+ disabled?: boolean;
6
+ description?: string;
7
+ };
8
+ export interface ComboboxProps<T extends string = string> {
9
+ label: React.ReactNode;
10
+ value: T | "";
11
+ onChange: (value: T | "") => void;
12
+ options: ChoiceOption<T>[];
13
+ help?: React.ReactNode;
14
+ error?: React.ReactNode;
15
+ placeholder?: string;
16
+ emptyMessage?: React.ReactNode;
17
+ disabled?: boolean;
18
+ required?: boolean;
19
+ clearable?: boolean;
20
+ loading?: boolean;
21
+ className?: string;
22
+ id?: string;
23
+ allowCustomValue?: boolean;
24
+ onValueSubmit?: () => void;
25
+ name?: string;
26
+ }
27
+ /** Searchable, controlled single-value listbox. Autocomplete and SearchInput share this engine. */
28
+ export declare function Combobox<T extends string = string>({ label, value, onChange, options, help, error, placeholder, emptyMessage, disabled, required, clearable, loading, className, id, allowCustomValue, onValueSubmit, name }: ComboboxProps<T>): React.JSX.Element;
29
+ export type AutocompleteProps<T extends string = string> = ComboboxProps<T>;
30
+ export declare function Autocomplete<T extends string = string>(props: AutocompleteProps<T>): React.JSX.Element;
31
+ export interface SearchInputProps<T extends string = string> extends Omit<ComboboxProps<T>, "label" | "value" | "onChange" | "clearable" | "options" | "allowCustomValue" | "onValueSubmit"> {
32
+ label: React.ReactNode;
33
+ value: string;
34
+ onChange: (value: string) => void;
35
+ onSubmit?: (value: string) => void;
36
+ options?: ChoiceOption<T>[];
37
+ }
38
+ /** Search field built on the shared Combobox engine; options are optional suggestions. */
39
+ export declare function SearchInput<T extends string = string>({ label, value, onChange, onSubmit, options, ...props }: SearchInputProps<T>): React.JSX.Element;
40
+ export interface MultiSelectProps<T extends string = string> {
41
+ label: React.ReactNode;
42
+ value: T[];
43
+ onChange: (value: T[]) => void;
44
+ options: ChoiceOption<T>[];
45
+ help?: React.ReactNode;
46
+ error?: React.ReactNode;
47
+ placeholder?: string;
48
+ emptyMessage?: React.ReactNode;
49
+ disabled?: boolean;
50
+ required?: boolean;
51
+ name?: string;
52
+ className?: string;
53
+ id?: string;
54
+ }
55
+ /** Controlled multi-value combobox with removable selected chips and a searchable list. */
56
+ export declare function MultiSelect<T extends string = string>({ label, value, onChange, options, help, error, placeholder, emptyMessage, disabled, required, name, className, id }: MultiSelectProps<T>): React.JSX.Element;
57
+ export interface CheckboxProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "type" | "onChange"> {
58
+ label: React.ReactNode;
59
+ help?: React.ReactNode;
60
+ error?: React.ReactNode;
61
+ onChange?: (checked: boolean, event: React.ChangeEvent<HTMLInputElement>) => void;
62
+ }
63
+ export declare function Checkbox({ label, help, error, className, onChange, ...props }: CheckboxProps): React.JSX.Element;
64
+ export interface RadioOption<T extends string> extends ChoiceOption<T> {
65
+ }
66
+ export interface RadioGroupProps<T extends string> {
67
+ label: React.ReactNode;
68
+ value: T | "";
69
+ onChange: (value: T) => void;
70
+ options: RadioOption<T>[];
71
+ help?: React.ReactNode;
72
+ error?: React.ReactNode;
73
+ disabled?: boolean;
74
+ required?: boolean;
75
+ orientation?: "horizontal" | "vertical";
76
+ name?: string;
77
+ className?: string;
78
+ }
79
+ export declare function RadioGroup<T extends string>({ label, value, onChange, options, help, error, disabled, required, orientation, name, className }: RadioGroupProps<T>): React.JSX.Element;
80
+ export interface SwitchProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "type" | "onChange"> {
81
+ label: React.ReactNode;
82
+ description?: React.ReactNode;
83
+ error?: React.ReactNode;
84
+ onChange?: (checked: boolean) => void;
85
+ }
86
+ export declare function Switch({ label, description, error, className, onChange, ...props }: SwitchProps): React.JSX.Element;
87
+ export interface SliderProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "type" | "value" | "defaultValue" | "onChange"> {
88
+ label: React.ReactNode;
89
+ value: number;
90
+ onChange: (value: number) => void;
91
+ help?: React.ReactNode;
92
+ error?: React.ReactNode;
93
+ }
94
+ export declare function Slider({ label, value, onChange, help, error, className, ...props }: SliderProps): React.JSX.Element;
95
+ export interface ToggleProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "onChange"> {
96
+ pressed: boolean;
97
+ onPressedChange: (pressed: boolean) => void;
98
+ }
99
+ export declare function Toggle({ pressed, onPressedChange, className, children, ...props }: ToggleProps): React.JSX.Element;
100
+ export interface ToggleGroupProps<T extends string> {
101
+ label: string;
102
+ value: T | T[];
103
+ onChange: (value: T | T[]) => void;
104
+ options: ChoiceOption<T>[];
105
+ type?: "single" | "multiple";
106
+ disabled?: boolean;
107
+ className?: string;
108
+ }
109
+ /** Shared button group used for both ToggleGroup and SegmentedControl. */
110
+ export declare function ToggleGroup<T extends string>({ label, value, onChange, options, type, disabled, className }: ToggleGroupProps<T>): React.JSX.Element;
111
+ export declare const SegmentedControl: typeof ToggleGroup;
112
+ export interface InputOTPProps {
113
+ label: React.ReactNode;
114
+ value: string;
115
+ onChange: (value: string) => void;
116
+ length?: number;
117
+ error?: React.ReactNode;
118
+ help?: React.ReactNode;
119
+ disabled?: boolean;
120
+ required?: boolean;
121
+ name?: string;
122
+ className?: string;
123
+ }
124
+ export declare function InputOTP({ label, value, onChange, length, error, help, disabled, required, name, className }: InputOTPProps): React.JSX.Element;
125
+ export interface FileUploadProps {
126
+ label: React.ReactNode;
127
+ files: File[];
128
+ onFilesChange: (files: File[]) => void;
129
+ accept?: string;
130
+ multiple?: boolean;
131
+ maxSizeBytes?: number;
132
+ help?: React.ReactNode;
133
+ disabled?: boolean;
134
+ required?: boolean;
135
+ className?: string;
136
+ }
137
+ /** Local file selection only. Does not upload or persist files. */
138
+ export declare function FileUpload({ label, files, onFilesChange, accept, multiple, maxSizeBytes, help, disabled, required, className }: FileUploadProps): React.JSX.Element;
@@ -0,0 +1,9 @@
1
+ import * as React from "react";
2
+ import { type VariantProps } from "class-variance-authority";
3
+ export declare const badgeVariants: (props?: ({
4
+ variant?: "secondary" | "outline" | "default" | null | undefined;
5
+ } & import("class-variance-authority/types").ClassProp) | undefined) => string;
6
+ export interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof badgeVariants> {
7
+ }
8
+ /** Neutral metadata badge. Use StatusBadge when the text conveys a state. */
9
+ export declare const Badge: React.ForwardRefExoticComponent<BadgeProps & React.RefAttributes<HTMLSpanElement>>;
@@ -0,0 +1,15 @@
1
+ import * as React from "react";
2
+ type AccessibleGroupName = {
3
+ "aria-label": string;
4
+ "aria-labelledby"?: never;
5
+ } | {
6
+ "aria-label"?: never;
7
+ "aria-labelledby": string;
8
+ };
9
+ export type ButtonGroupProps = Omit<React.HTMLAttributes<HTMLDivElement>, "role" | "aria-label" | "aria-labelledby"> & AccessibleGroupName & {
10
+ orientation?: "horizontal" | "vertical";
11
+ children: React.ReactNode;
12
+ };
13
+ /** Groups related actions while preserving the native tab order of each button. */
14
+ export declare const ButtonGroup: React.ForwardRefExoticComponent<ButtonGroupProps & React.RefAttributes<HTMLDivElement>>;
15
+ export {};
@@ -0,0 +1,11 @@
1
+ import * as React from "react";
2
+ import { type VariantProps } from "class-variance-authority";
3
+ export declare const buttonVariants: (props?: ({
4
+ variant?: "link" | "destructive" | "primary" | "secondary" | "ghost" | "outline" | null | undefined;
5
+ size?: "sm" | "md" | "lg" | "icon" | "icon-sm" | "icon-lg" | null | undefined;
6
+ } & import("class-variance-authority/types").ClassProp) | undefined) => string;
7
+ export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
8
+ asChild?: boolean;
9
+ }
10
+ /** WealthOS action button. Use a link element with `asChild` for navigation. */
11
+ export declare const Button: React.ForwardRefExoticComponent<ButtonProps & React.RefAttributes<HTMLButtonElement>>;
@@ -0,0 +1,42 @@
1
+ import * as React from "react";
2
+ export interface CommandMenuProps {
3
+ open: boolean;
4
+ onOpenChange: (open: boolean) => void;
5
+ label?: string;
6
+ placeholder?: string;
7
+ emptyMessage?: string;
8
+ children: React.ReactNode;
9
+ }
10
+ export declare function CommandMenu({ open, onOpenChange, label, placeholder, emptyMessage, children }: CommandMenuProps): React.JSX.Element;
11
+ export declare const CommandMenuGroup: React.ForwardRefExoticComponent<{
12
+ children?: React.ReactNode;
13
+ } & Omit<Pick<Pick<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "key" | keyof React.HTMLAttributes<HTMLDivElement>> & {
14
+ ref?: React.Ref<HTMLDivElement>;
15
+ } & {
16
+ asChild?: boolean;
17
+ }, "key" | keyof React.HTMLAttributes<HTMLDivElement> | "asChild">, "value" | "heading"> & {
18
+ heading?: React.ReactNode;
19
+ value?: string;
20
+ forceMount?: boolean;
21
+ } & React.RefAttributes<HTMLDivElement>>;
22
+ export declare const CommandMenuItem: React.ForwardRefExoticComponent<{
23
+ children?: React.ReactNode;
24
+ } & Omit<Pick<Pick<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "key" | keyof React.HTMLAttributes<HTMLDivElement>> & {
25
+ ref?: React.Ref<HTMLDivElement>;
26
+ } & {
27
+ asChild?: boolean;
28
+ }, "key" | keyof React.HTMLAttributes<HTMLDivElement> | "asChild">, "value" | "onSelect" | "disabled"> & {
29
+ disabled?: boolean;
30
+ onSelect?: (value: string) => void;
31
+ value?: string;
32
+ keywords?: string[];
33
+ forceMount?: boolean;
34
+ } & React.RefAttributes<HTMLDivElement>>;
35
+ export declare const CommandMenuSeparator: React.ForwardRefExoticComponent<Pick<Pick<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "key" | keyof React.HTMLAttributes<HTMLDivElement>> & {
36
+ ref?: React.Ref<HTMLDivElement>;
37
+ } & {
38
+ asChild?: boolean;
39
+ }, "key" | keyof React.HTMLAttributes<HTMLDivElement> | "asChild"> & {
40
+ alwaysRender?: boolean;
41
+ } & React.RefAttributes<HTMLDivElement>>;
42
+ export declare function CommandMenuShortcut({ className, ...props }: React.HTMLAttributes<HTMLSpanElement>): React.JSX.Element;
@@ -0,0 +1,100 @@
1
+ import * as React from "react";
2
+ type ElementProps<E extends keyof React.JSX.IntrinsicElements> = React.ComponentPropsWithoutRef<E>;
3
+ export declare const Table: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.TableHTMLAttributes<HTMLTableElement>, HTMLTableElement>, "ref"> & {
4
+ density?: "compact" | "comfortable";
5
+ } & React.RefAttributes<HTMLTableElement>>;
6
+ export declare const TableHeader: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLTableSectionElement>, HTMLTableSectionElement>, "ref"> & React.RefAttributes<HTMLTableSectionElement>>;
7
+ export declare const TableBody: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLTableSectionElement>, HTMLTableSectionElement>, "ref"> & React.RefAttributes<HTMLTableSectionElement>>;
8
+ export declare const TableFooter: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLTableSectionElement>, HTMLTableSectionElement>, "ref"> & React.RefAttributes<HTMLTableSectionElement>>;
9
+ export declare const TableRow: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLTableRowElement>, HTMLTableRowElement>, "ref"> & React.RefAttributes<HTMLTableRowElement>>;
10
+ export declare const TableHead: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.ThHTMLAttributes<HTMLTableHeaderCellElement>, HTMLTableHeaderCellElement>, "ref"> & React.RefAttributes<HTMLTableCellElement>>;
11
+ export declare const TableCell: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.TdHTMLAttributes<HTMLTableDataCellElement>, HTMLTableDataCellElement>, "ref"> & React.RefAttributes<HTMLTableCellElement>>;
12
+ export declare const TableCaption: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & React.RefAttributes<HTMLTableCaptionElement>>;
13
+ export interface AvatarProps extends Omit<ElementProps<"span">, "children"> {
14
+ src?: string;
15
+ alt?: string;
16
+ fallback?: React.ReactNode;
17
+ size?: "sm" | "md" | "lg";
18
+ }
19
+ export declare function Avatar({ src, alt, fallback, size, className, ...props }: AvatarProps): React.JSX.Element;
20
+ export interface AvatarGroupProps extends ElementProps<"div"> {
21
+ max?: number;
22
+ label?: string;
23
+ }
24
+ export declare function AvatarGroup({ max, label, className, children, ...props }: AvatarGroupProps): React.JSX.Element;
25
+ export interface DescriptionListProps extends ElementProps<"dl"> {
26
+ columns?: 1 | 2 | 3;
27
+ }
28
+ export declare function DescriptionList({ columns, className, ...props }: DescriptionListProps): React.JSX.Element;
29
+ export interface KeyValueProps extends ElementProps<"div"> {
30
+ label: React.ReactNode;
31
+ value: React.ReactNode;
32
+ }
33
+ export declare function KeyValue({ label, value, className, ...props }: KeyValueProps): React.JSX.Element;
34
+ export interface DataListProps extends ElementProps<"ul"> {
35
+ density?: "compact" | "comfortable";
36
+ }
37
+ export declare function DataList({ density, className, ...props }: DataListProps): React.JSX.Element;
38
+ export interface EmptyStateProps extends Omit<ElementProps<"div">, "title"> {
39
+ title: React.ReactNode;
40
+ description?: React.ReactNode;
41
+ action?: React.ReactNode;
42
+ icon?: React.ReactNode;
43
+ }
44
+ export declare function EmptyState({ title, description, action, icon, className, ...props }: EmptyStateProps): React.JSX.Element;
45
+ export interface SkeletonProps extends ElementProps<"div"> {
46
+ width?: React.CSSProperties["width"];
47
+ height?: React.CSSProperties["height"];
48
+ circle?: boolean;
49
+ }
50
+ export declare function Skeleton({ width, height, circle, className, style, ...props }: SkeletonProps): React.JSX.Element;
51
+ export interface ProgressProps extends Omit<ElementProps<"div">, "value"> {
52
+ value?: number | null;
53
+ max?: number;
54
+ label: string;
55
+ showValue?: boolean;
56
+ }
57
+ export declare function Progress({ value, max, label, showValue, className, ...props }: ProgressProps): React.JSX.Element;
58
+ export interface CircularProgressProps extends Omit<ElementProps<"div">, "value"> {
59
+ value?: number | null;
60
+ max?: number;
61
+ label: string;
62
+ size?: number;
63
+ strokeWidth?: number;
64
+ }
65
+ export declare function CircularProgress({ value, max, label, size, strokeWidth, className, ...props }: CircularProgressProps): React.JSX.Element;
66
+ export interface SeparatorProps extends ElementProps<"hr"> {
67
+ orientation?: "horizontal" | "vertical";
68
+ }
69
+ export declare function Separator({ orientation, className, ...props }: SeparatorProps): React.JSX.Element;
70
+ export interface ScrollAreaProps extends ElementProps<"div"> {
71
+ orientation?: "horizontal" | "vertical" | "both";
72
+ }
73
+ export declare function ScrollArea({ orientation, className, ...props }: ScrollAreaProps): React.JSX.Element;
74
+ export interface AspectRatioProps extends ElementProps<"div"> {
75
+ ratio?: number;
76
+ }
77
+ export declare function AspectRatio({ ratio, className, style, ...props }: AspectRatioProps): React.JSX.Element;
78
+ export interface StatProps extends ElementProps<"div"> {
79
+ label: React.ReactNode;
80
+ value: React.ReactNode;
81
+ detail?: React.ReactNode;
82
+ trend?: React.ReactNode;
83
+ }
84
+ export declare function Stat({ label, value, detail, trend, className, ...props }: StatProps): React.JSX.Element;
85
+ export interface MetricCardProps extends StatProps {
86
+ icon?: React.ReactNode;
87
+ }
88
+ export declare function MetricCard({ icon, className, ...props }: MetricCardProps): React.JSX.Element;
89
+ export interface TimelineItem {
90
+ id?: React.Key;
91
+ title: React.ReactNode;
92
+ description?: React.ReactNode;
93
+ date?: React.ReactNode;
94
+ status?: "upcoming" | "current" | "complete";
95
+ }
96
+ export interface TimelineProps extends Omit<ElementProps<"ol">, "children"> {
97
+ items: TimelineItem[];
98
+ }
99
+ export declare function Timeline({ items, className, ...props }: TimelineProps): React.JSX.Element;
100
+ export {};
@@ -0,0 +1,113 @@
1
+ import * as React from "react";
2
+ import { type ColumnDef, type ColumnFiltersState, type ColumnPinningState, type ColumnSizingState, type ColumnVisibilityState, type ExpandedState, type PaginationState, type RowSelectionState, type SortingState, type RowData } from "@tanstack/react-table";
3
+ declare const dataTableFeatures: {
4
+ rowSortingFeature: import("@tanstack/react-table").TableFeature;
5
+ columnFilteringFeature: import("@tanstack/react-table").TableFeature;
6
+ globalFilteringFeature: import("@tanstack/react-table").TableFeature;
7
+ rowPaginationFeature: import("@tanstack/react-table").TableFeature;
8
+ rowSelectionFeature: import("@tanstack/react-table").TableFeature;
9
+ columnVisibilityFeature: import("@tanstack/react-table").TableFeature;
10
+ columnSizingFeature: import("@tanstack/react-table").TableFeature;
11
+ columnResizingFeature: import("@tanstack/react-table").TableFeature;
12
+ columnPinningFeature: import("@tanstack/react-table").TableFeature;
13
+ rowExpandingFeature: import("@tanstack/react-table").TableFeature;
14
+ coreRowModel: (table: import("@tanstack/table-core").Table<any, any>) => () => import("@tanstack/table-core").RowModel<any, any>;
15
+ filteredRowModel: (table: import("@tanstack/table-core").Table<any, any>) => () => import("@tanstack/table-core").RowModel<any, any>;
16
+ sortedRowModel: (table: import("@tanstack/table-core").Table<any, any>) => () => import("@tanstack/table-core").RowModel<any, any>;
17
+ paginatedRowModel: (table: import("@tanstack/table-core").Table<any, any>) => () => import("@tanstack/table-core").RowModel<any, any>;
18
+ expandedRowModel: (table: import("@tanstack/table-core").Table<any, any>) => () => import("@tanstack/table-core").RowModel<any, any>;
19
+ sortFns: {
20
+ alphanumeric: import("@tanstack/react-table").CreatedSortFn<any, any>;
21
+ text: import("@tanstack/react-table").CreatedSortFn<any, any>;
22
+ };
23
+ filterFns: {
24
+ includesString: import("@tanstack/react-table").CreatedFilterFn<any, any>;
25
+ };
26
+ };
27
+ export declare function createDataTableColumnHelper<TData extends RowData>(): import("@tanstack/table-core").ColumnHelper<{
28
+ rowSortingFeature: import("@tanstack/table-core").TableFeature;
29
+ columnFilteringFeature: import("@tanstack/table-core").TableFeature;
30
+ globalFilteringFeature: import("@tanstack/table-core").TableFeature;
31
+ rowPaginationFeature: import("@tanstack/table-core").TableFeature;
32
+ rowSelectionFeature: import("@tanstack/table-core").TableFeature;
33
+ columnVisibilityFeature: import("@tanstack/table-core").TableFeature;
34
+ columnSizingFeature: import("@tanstack/table-core").TableFeature;
35
+ columnResizingFeature: import("@tanstack/table-core").TableFeature;
36
+ columnPinningFeature: import("@tanstack/table-core").TableFeature;
37
+ rowExpandingFeature: import("@tanstack/table-core").TableFeature;
38
+ coreRowModel: (table: import("@tanstack/table-core").Table<any, any>) => () => import("@tanstack/table-core").RowModel<any, any>;
39
+ filteredRowModel: (table: import("@tanstack/table-core").Table<any, any>) => () => import("@tanstack/table-core").RowModel<any, any>;
40
+ sortedRowModel: (table: import("@tanstack/table-core").Table<any, any>) => () => import("@tanstack/table-core").RowModel<any, any>;
41
+ paginatedRowModel: (table: import("@tanstack/table-core").Table<any, any>) => () => import("@tanstack/table-core").RowModel<any, any>;
42
+ expandedRowModel: (table: import("@tanstack/table-core").Table<any, any>) => () => import("@tanstack/table-core").RowModel<any, any>;
43
+ sortFns: {
44
+ alphanumeric: import("@tanstack/table-core").CreatedSortFn<any, any>;
45
+ text: import("@tanstack/table-core").CreatedSortFn<any, any>;
46
+ };
47
+ filterFns: {
48
+ includesString: import("@tanstack/table-core").CreatedFilterFn<any, any>;
49
+ };
50
+ }, TData>;
51
+ export type DataTableColumn<TData extends RowData> = ColumnDef<typeof dataTableFeatures, TData>;
52
+ declare module "@tanstack/table-core" {
53
+ interface ColumnMeta<TFeatures extends import("@tanstack/table-core").TableFeatures, TData extends RowData, TValue> {
54
+ align?: "left" | "right" | "center";
55
+ }
56
+ }
57
+ export interface DataTableState {
58
+ sorting: SortingState;
59
+ columnFilters: ColumnFiltersState;
60
+ globalFilter: string;
61
+ pagination: PaginationState;
62
+ rowSelection: RowSelectionState;
63
+ columnVisibility: ColumnVisibilityState;
64
+ columnSizing: ColumnSizingState;
65
+ columnPinning: ColumnPinningState;
66
+ expanded: ExpandedState;
67
+ }
68
+ export interface DataTableProps<TData extends RowData> {
69
+ columns: DataTableColumn<TData>[];
70
+ data: TData[];
71
+ getRowId?: (original: TData, index: number) => string;
72
+ density?: "compact" | "comfortable";
73
+ caption?: React.ReactNode;
74
+ ariaLabel?: string;
75
+ enableSorting?: boolean;
76
+ enableFiltering?: boolean;
77
+ enableGlobalFilter?: boolean;
78
+ enablePagination?: boolean;
79
+ enableRowSelection?: boolean;
80
+ enableColumnVisibility?: boolean;
81
+ enableColumnResizing?: boolean;
82
+ enableColumnPinning?: boolean;
83
+ enableExpanding?: boolean;
84
+ renderSubComponent?: (props: {
85
+ row: TData;
86
+ }) => React.ReactNode;
87
+ loading?: boolean;
88
+ loadingLabel?: string;
89
+ error?: React.ReactNode;
90
+ emptyState?: React.ReactNode;
91
+ pageSizeOptions?: number[];
92
+ manualSorting?: boolean;
93
+ manualFiltering?: boolean;
94
+ manualPagination?: boolean;
95
+ pageCount?: number;
96
+ rowCount?: number;
97
+ state?: Partial<DataTableState>;
98
+ initialState?: Partial<DataTableState>;
99
+ onSortingChange?: (updater: React.SetStateAction<SortingState>) => void;
100
+ onColumnFiltersChange?: (updater: React.SetStateAction<ColumnFiltersState>) => void;
101
+ onGlobalFilterChange?: (updater: React.SetStateAction<string>) => void;
102
+ onPaginationChange?: (updater: React.SetStateAction<PaginationState>) => void;
103
+ onRowSelectionChange?: (updater: React.SetStateAction<RowSelectionState>) => void;
104
+ onColumnVisibilityChange?: (updater: React.SetStateAction<ColumnVisibilityState>) => void;
105
+ onColumnSizingChange?: (updater: React.SetStateAction<ColumnSizingState>) => void;
106
+ onColumnPinningChange?: (updater: React.SetStateAction<ColumnPinningState>) => void;
107
+ onExpandedChange?: (updater: React.SetStateAction<ExpandedState>) => void;
108
+ className?: string;
109
+ toolbar?: React.ReactNode;
110
+ }
111
+ /** WealthOS-rendered table. Pass state + its matching onChange handler to control a slice. */
112
+ export declare function DataTable<TData extends RowData>({ columns, data, getRowId, density, caption, ariaLabel, enableSorting, enableFiltering, enableGlobalFilter, enablePagination, enableRowSelection, enableColumnVisibility, enableColumnResizing, enableColumnPinning, enableExpanding, renderSubComponent, loading, loadingLabel, error, emptyState, pageSizeOptions, manualSorting, manualFiltering, manualPagination, pageCount, rowCount, state, initialState, onSortingChange, onColumnFiltersChange, onGlobalFilterChange, onPaginationChange, onRowSelectionChange, onColumnVisibilityChange, onColumnSizingChange, onColumnPinningChange, onExpandedChange, className, toolbar, }: DataTableProps<TData>): React.JSX.Element;
113
+ export {};
@@ -0,0 +1,34 @@
1
+ import * as React from "react";
2
+ export interface DateInputProps {
3
+ id?: string;
4
+ value: string;
5
+ onChange: (isoDate: string) => void;
6
+ ariaLabel?: string;
7
+ min?: string;
8
+ max?: string;
9
+ disabled?: boolean;
10
+ required?: boolean;
11
+ invalid?: boolean;
12
+ compact?: boolean;
13
+ longDisplay?: boolean;
14
+ className?: string;
15
+ "aria-describedby"?: string;
16
+ "aria-errormessage"?: string;
17
+ "aria-invalid"?: boolean | "true" | "false";
18
+ }
19
+ /** US date text entry + local calendar, with ISO strings at the component boundary. */
20
+ export declare function DateInput({ id: providedId, value, onChange, ariaLabel, min, max, disabled, required, invalid, compact, longDisplay, className, "aria-describedby": describedBy, "aria-errormessage": errorMessage, "aria-invalid": ariaInvalid, }: DateInputProps): React.JSX.Element;
21
+ export declare namespace DateInput {
22
+ var displayName: string;
23
+ }
24
+ export interface UsDateInputProps extends Omit<DateInputProps, "ariaLabel"> {
25
+ label: React.ReactNode;
26
+ help?: React.ReactNode;
27
+ error?: React.ReactNode;
28
+ confirm?: React.ReactNode;
29
+ }
30
+ /** Labeled wrapper for forms that may show a confirmation line under a selected date. */
31
+ export declare function UsDateInput({ label, help, error, confirm, ...dateProps }: UsDateInputProps): React.JSX.Element;
32
+ export declare namespace UsDateInput {
33
+ var displayName: string;
34
+ }
@@ -0,0 +1,21 @@
1
+ import * as React from "react";
2
+ export interface DateRange {
3
+ start: string;
4
+ end: string;
5
+ }
6
+ export interface DateRangePickerProps {
7
+ label: React.ReactNode;
8
+ value: DateRange;
9
+ onChange: (value: DateRange) => void;
10
+ help?: React.ReactNode;
11
+ error?: React.ReactNode;
12
+ min?: string;
13
+ max?: string;
14
+ disabled?: boolean;
15
+ required?: boolean;
16
+ className?: string;
17
+ id?: string;
18
+ }
19
+ /** Controlled ISO date range using the package's established keyboard calendar input. */
20
+ export declare function DateRangePicker({ label, value, onChange, help, error, min, max, disabled, required, className, id }: DateRangePickerProps): React.JSX.Element;
21
+ export declare function isDateRangeValid(value: DateRange, min?: string, max?: string): boolean;
@@ -0,0 +1,18 @@
1
+ import * as React from "react";
2
+ export interface FieldProps {
3
+ label: React.ReactNode;
4
+ help?: React.ReactNode;
5
+ error?: React.ReactNode;
6
+ htmlFor?: string;
7
+ className?: string;
8
+ labelClassName?: string;
9
+ /** Marks the control required and adds a visible Required indicator. */
10
+ required?: boolean;
11
+ /** Adds a visible Optional indicator for forms that label optional inputs. */
12
+ optional?: boolean;
13
+ /** Horizontal fields stack vertically below 640px. */
14
+ orientation?: "vertical" | "horizontal";
15
+ children: React.ReactNode;
16
+ }
17
+ /** Label, control, help, and error wrapper. A single direct control receives generated ARIA ids. */
18
+ export declare function Field({ label, help, error, htmlFor, className, labelClassName, required, optional, orientation, children }: FieldProps): React.JSX.Element;
@@ -0,0 +1,83 @@
1
+ import * as React from "react";
2
+ import { type NoticeProps } from "./notice";
3
+ import { Table } from "./data-display";
4
+ export type FinancialValueState = "estimated" | "stale" | "illustrative" | "unavailable";
5
+ type Precision = "whole" | "cents" | "auto";
6
+ export interface CurrencyValueProps extends Omit<React.ComponentPropsWithoutRef<"span">, "children"> {
7
+ /** A display-ready numeric value. Null and undefined render the unavailable label. */
8
+ value?: number | null;
9
+ /** Use when the caller already owns the exact display formatting. */
10
+ formatted?: string;
11
+ currency?: string;
12
+ locale?: string;
13
+ precision?: Precision;
14
+ unavailableText?: string;
15
+ }
16
+ /** Formats a supplied value only; this component never converts currencies or changes source values. */
17
+ export declare function CurrencyValue({ value, formatted, currency, locale, precision, unavailableText, className, ...props }: CurrencyValueProps): React.JSX.Element;
18
+ export interface PercentageValueProps extends Omit<React.ComponentPropsWithoutRef<"span">, "children"> {
19
+ /** In `rate` mode the value is a fraction (0.125 = 12.5%). In `points` mode it is already in percentage points. */
20
+ value?: number | null;
21
+ formatted?: string;
22
+ mode?: "rate" | "points";
23
+ locale?: string;
24
+ minimumFractionDigits?: number;
25
+ maximumFractionDigits?: number;
26
+ unavailableText?: string;
27
+ }
28
+ export declare function PercentageValue({ value, formatted, mode, locale, minimumFractionDigits, maximumFractionDigits, unavailableText, className, ...props }: PercentageValueProps): React.JSX.Element;
29
+ export interface ShareQuantityProps extends Omit<React.ComponentPropsWithoutRef<"span">, "children"> {
30
+ value?: number | null;
31
+ formatted?: string;
32
+ locale?: string;
33
+ maximumFractionDigits?: number;
34
+ unit?: "share" | "shares" | "RSU" | "RSUs";
35
+ unavailableText?: string;
36
+ }
37
+ export declare function ShareQuantity({ value, formatted, locale, maximumFractionDigits, unit, unavailableText, className, ...props }: ShareQuantityProps): React.JSX.Element;
38
+ export interface EstimateIndicatorProps extends Omit<React.ComponentPropsWithoutRef<"span">, "children"> {
39
+ state: FinancialValueState;
40
+ labels?: Partial<Record<FinancialValueState, string>>;
41
+ }
42
+ export declare function EstimateIndicator({ state, labels, className, ...props }: EstimateIndicatorProps): React.JSX.Element;
43
+ export interface FinancialMetricProps extends Omit<React.ComponentPropsWithoutRef<"section">, "title"> {
44
+ label: React.ReactNode;
45
+ value: React.ReactNode;
46
+ detail?: React.ReactNode;
47
+ state?: FinancialValueState;
48
+ stateLabel?: string;
49
+ }
50
+ export declare function FinancialMetric({ label, value, detail, state, stateLabel, className, ...props }: FinancialMetricProps): React.JSX.Element;
51
+ export interface AllocationSegment {
52
+ /** Stable key for the segment. Defaults to its label. */
53
+ id?: string;
54
+ label: string;
55
+ /** Caller-supplied percentage from 0 through 100. Segment percentages should sum to 100. */
56
+ percentage: number;
57
+ color?: "primary" | "chart-2" | "chart-3" | "chart-4" | "chart-5";
58
+ }
59
+ export interface AllocationBarProps extends Omit<React.ComponentPropsWithoutRef<"figure">, "children"> {
60
+ label: string;
61
+ segments: AllocationSegment[];
62
+ showPercentages?: boolean;
63
+ }
64
+ export declare function AllocationBar({ label, segments, showPercentages, className, ...props }: AllocationBarProps): React.JSX.Element;
65
+ export interface FinancialDataColumn<Row> {
66
+ id: string;
67
+ header: React.ReactNode;
68
+ cell: (row: Row) => React.ReactNode;
69
+ align?: "start" | "end";
70
+ }
71
+ export interface FinancialDataTableProps<Row> extends Omit<React.ComponentProps<typeof Table>, "children"> {
72
+ caption: React.ReactNode;
73
+ rows: Row[];
74
+ columns: FinancialDataColumn<Row>[];
75
+ getRowKey: (row: Row, index: number) => React.Key;
76
+ }
77
+ /** Semantic financial table styling over caller-owned, already ordered rows. */
78
+ export declare function FinancialDataTable<Row>({ caption, rows, columns, getRowKey, className, ...props }: FinancialDataTableProps<Row>): React.JSX.Element;
79
+ export interface AssumptionNoticeProps extends Omit<NoticeProps, "variant"> {
80
+ variant?: "info" | "warning";
81
+ }
82
+ export declare function AssumptionNotice({ variant, title, className, ...props }: AssumptionNoticeProps): React.JSX.Element;
83
+ export {};
@@ -0,0 +1,8 @@
1
+ import * as React from "react";
2
+ import { Field, type FieldProps } from "./field";
3
+ export interface FormProps extends React.FormHTMLAttributes<HTMLFormElement> {
4
+ children: React.ReactNode;
5
+ }
6
+ export declare const Form: React.ForwardRefExoticComponent<FormProps & React.RefAttributes<HTMLFormElement>>;
7
+ export declare const FormField: typeof Field;
8
+ export type { FieldProps as FormFieldProps };