@godxjp/ui 6.0.0 → 6.0.1

package/src/props/components/app.prop.ts

@@ -1,99 +0,0 @@
-/** App shell prop types — @see docs/COMPONENTS.md#app */
-import type { Locale } from "date-fns";
-import type { DayPickerProps } from "react-day-picker";
-import type {
-  AppLocale,
-  AppRequestHeaders,
-  AppTimeFormat,
-  AppTimezone,
-  AppTimezoneDefault,
-  AppDateFormat,
-} from "../../app/types";
-import type { ChildrenProp, ClassNameProp, DisabledProp, IdProp } from "../vocabulary";
-
-/** @see AppProvider */
-export type AppProviderProp = {
-  children: ChildrenProp;
-  /** Initial locale when nothing in storage. Default: `vi`. */
-  defaultLocale?: AppLocale;
-  /** Fallback when a translation key is missing. Default: `en`. */
-  fallbackLocale?: AppLocale;
-  /** Initial timezone: IANA id, `browser`, or `system`. Default: `browser`. */
-  defaultTimezone?: AppTimezoneDefault;
-  /** Backend/system timezone when `defaultTimezone` is `system`. */
-  systemTimezone?: AppTimezone;
-  /** Initial clock format. `"locale"` derives from `defaultLocale`. Default: `"locale"`. */
-  defaultTimeFormat?: AppTimeFormat | "locale";
-  /** Initial date display format. `"locale"` derives from `defaultLocale`. Default: `"locale"`. */
-  defaultDateFormat?: AppDateFormat | "locale";
-  /**
-   * IANA ids shown in `TimezonePicker`.
-   * Omit for the full IANA list; set to restrict (e.g. `APP_TIMEZONE_PRESET`).
-   */
-  timezoneOptions?: readonly AppTimezone[];
-  /** localStorage key. Default: `godxjp.app`. */
-  storageKey?: string;
-  /** Persist user choices. Default: true. */
-  persist?: boolean;
-  onLocaleChange?: (locale: AppLocale) => void;
-  onTimezoneChange?: (timezone: AppTimezone) => void;
-  onTimeFormatChange?: (timeFormat: AppTimeFormat) => void;
-  onDateFormatChange?: (dateFormat: AppDateFormat) => void;
-};
-
-/** @see LocalePicker */
-export type LocalePickerProp = {
-  className?: ClassNameProp;
-  disabled?: DisabledProp;
-  id?: IdProp;
-  /** Controlled value; default reads/writes AppProvider. */
-  value?: AppLocale;
-  onChange?: (locale: AppLocale) => void;
-};
-
-/** @see TimezonePicker */
-export type TimezonePickerProp = {
-  className?: ClassNameProp;
-  disabled?: DisabledProp;
-  id?: IdProp;
-  value?: AppTimezone;
-  onChange?: (timezone: AppTimezone) => void;
-  /** Override AppProvider list; omit to use context or full IANA. */
-  options?: readonly AppTimezone[];
-};
-
-/** @see TimeFormatPicker */
-export type TimeFormatPickerProp = {
-  className?: ClassNameProp;
-  disabled?: DisabledProp;
-  id?: IdProp;
-  value?: AppTimeFormat;
-  onChange?: (timeFormat: AppTimeFormat) => void;
-};
-
-/** @see DateFormatPicker */
-export type DateFormatPickerProp = {
-  className?: ClassNameProp;
-  disabled?: DisabledProp;
-  id?: IdProp;
-  value?: AppDateFormat;
-  onChange?: (dateFormat: AppDateFormat) => void;
-};
-
-/** Value exposed by `useAppContext`. */
-export type AppContextValue = {
-  locale: AppLocale;
-  fallbackLocale: AppLocale;
-  timezone: AppTimezone;
-  timeFormat: AppTimeFormat;
-  dateFormat: AppDateFormat;
-  dateFnsLocale: Locale;
-  dayPickerLocale: NonNullable<DayPickerProps["locale"]>;
-  requestHeaders: AppRequestHeaders;
-  /** Configured picker list; `undefined` → full IANA in TimezonePicker. */
-  timezoneOptions?: readonly AppTimezone[];
-  setLocale: (locale: AppLocale) => void;
-  setTimezone: (timezone: AppTimezone) => void;
-  setTimeFormat: (timeFormat: AppTimeFormat) => void;
-  setDateFormat: (dateFormat: AppDateFormat) => void;
-};

package/src/props/components/data-display.prop.ts

@@ -1,73 +0,0 @@
-/** Data Display component prop types — @see docs/COMPONENTS.md#data-display */
-import type * as React from "react";
-import type {
-  ActionProp,
-  ClassNameProp,
-  DescriptionProp,
-  IconProp,
-  TitleProp,
-  ColumnDefProp,
-  GetRowIdProp,
-  OnRowClickProp,
-  OnSelectChangeProp,
-  OnSortChangeProp,
-  OnTableDensityChangeProp,
-  SelectedIdsProp,
-  SortStateProp,
-  StatusToneProp,
-  TableDensityProp,
-  ChildrenProp,
-} from "../vocabulary";
-
-/** @see EmptyState */
-export type EmptyStateProp = {
-  icon?: IconProp;
-  title: TitleProp;
-  description?: DescriptionProp;
-  action?: ActionProp;
-  className?: ClassNameProp;
-};
-
-/** @see KeyValueGrid */
-export type KeyValueGridProp = {
-  items: KeyValueGridItemProp[];
-  columns?: 1 | 2 | 3;
-  className?: ClassNameProp;
-};
-
-export type KeyValueGridItemProp = {
-  label: React.ReactNode;
-  value: React.ReactNode;
-  mono?: boolean;
-};
-
-/** @see StatusBadge */
-export type StatusBadgeProp = {
-  status: string;
-  tone?: StatusToneProp;
-  className?: ClassNameProp;
-};
-
-/** @see DataTable */
-export type DataTableProp<T> = {
-  data: T[];
-  columns: ColumnDefProp<T>[];
-  getRowId?: GetRowIdProp<T>;
-  selectable?: boolean;
-  selected?: SelectedIdsProp;
-  onSelectChange?: OnSelectChangeProp;
-  onRowClick?: OnRowClickProp<T>;
-  density?: TableDensityProp;
-  onDensityChange?: OnTableDensityChangeProp;
-  sort?: SortStateProp;
-  onSortChange?: OnSortChangeProp;
-  loading?: boolean;
-  empty?: React.ReactNode;
-  className?: ClassNameProp;
-  children?: ChildrenProp;
-};
-
-/** @see Badge */
-export type BadgeProp = React.HTMLAttributes<HTMLDivElement> & {
-  variant?: "default" | "secondary" | "destructive" | "outline" | "success" | "warning";
-};

package/src/props/components/data-entry.prop.ts

@@ -1,334 +0,0 @@
-/** Data Entry component prop types — @see docs/COMPONENTS.md#data-entry */
-import type * as CheckboxPrimitive from "@radix-ui/react-checkbox";
-import type * as RadioGroupPrimitive from "@radix-ui/react-radio-group";
-import type * as SliderPrimitive from "@radix-ui/react-slider";
-import type * as SwitchPrimitive from "@radix-ui/react-switch";
-import type { DayPickerProps } from "react-day-picker";
-import type { DateRange } from "react-day-picker";
-import type * as React from "react";
-import type { UploadFileItem } from "../../components/data-entry/upload-types";
-import type {
-  ClassNameProp,
-  DisabledProp,
-  ErrorProp,
-  HelperProp,
-  IdProp,
-  LabelProp,
-  OnChangeProp,
-  OnSearchChangeProp,
-  PlaceholderProp,
-  RequiredProp,
-  ValueProp,
-} from "../vocabulary";
-
-/** @see Input */
-export type InputProp = React.InputHTMLAttributes<HTMLInputElement>;
-
-/** @see Textarea */
-export type TextareaProp = React.TextareaHTMLAttributes<HTMLTextAreaElement>;
-
-/** @see FormField */
-export type FormFieldProp = {
-  id: IdProp;
-  label: LabelProp;
-  required?: RequiredProp;
-  helper?: HelperProp;
-  error?: ErrorProp;
-  /** Optional control rendered inline after the label (e.g. a help button). */
-  labelAddon?: React.ReactNode;
-  className?: ClassNameProp;
-  children: React.ReactNode;
-};
-
-/** @see SearchInput */
-export type SearchInputProp = {
-  id?: IdProp;
-  label?: LabelProp;
-  placeholder?: PlaceholderProp;
-  value?: ValueProp;
-  onChange?: OnChangeProp;
-  onDebouncedChange?: OnSearchChangeProp;
-  debounceMs?: number;
-  className?: ClassNameProp;
-};
-
-/** @see Checkbox — extends Radix checkbox root props. */
-export type CheckboxProp = React.ComponentPropsWithoutRef<typeof CheckboxPrimitive.Root>;
-
-/** Shared option row — Ant Design `CheckboxOptionType`. */
-export type ChoiceOptionProp = {
-  label: React.ReactNode;
-  value: string;
-  disabled?: boolean;
-  description?: React.ReactNode;
-};
-
-/** @see Checkbox.Group */
-export type CheckboxGroupProp = {
-  value?: string[];
-  defaultValue?: string[];
-  onChange?: (value: string[]) => void;
-  options?: ChoiceOptionProp[];
-  orientation?: "horizontal" | "vertical";
-  disabled?: DisabledProp;
-  name?: string;
-  className?: ClassNameProp;
-  children?: React.ReactNode;
-};
-
-/** @see Radio.Group */
-export type RadioGroupProp = {
-  value?: string;
-  defaultValue?: string;
-  onValueChange?: (value: string) => void;
-  options?: ChoiceOptionProp[];
-  orientation?: "horizontal" | "vertical";
-  disabled?: DisabledProp;
-  name?: string;
-  className?: ClassNameProp;
-  children?: React.ReactNode;
-};
-
-/** @see Radio.Item — Radix radio group item. */
-export type RadioProp = React.ComponentPropsWithoutRef<typeof RadioGroupPrimitive.Item>;
-
-/** @see Switch — extends Radix switch root props. */
-export type SwitchProp = React.ComponentPropsWithoutRef<typeof SwitchPrimitive.Root> & {
-  size?: "sm" | "default";
-};
-
-/** @see SwitchField — labelled switch with hidden input for HTML forms. */
-export type SwitchFieldProp = {
-  id: IdProp;
-  label: LabelProp;
-  name: string;
-  required?: RequiredProp;
-  helper?: HelperProp;
-  error?: ErrorProp;
-  labelAddon?: React.ReactNode;
-  className?: ClassNameProp;
-  checked?: boolean;
-  defaultChecked?: boolean;
-  onCheckedChange?: (checked: boolean) => void;
-  disabled?: DisabledProp;
-  size?: SwitchProp["size"];
-};
-
-/** Country row accepted by CountrySelect / CountryOptionLabel.
- *  Accepts either a select-option (`value`) or a summary (`code`). */
-export type CountryOptionProp = {
-  name: string;
-  nativeName?: string | null;
-  flagSvgPath?: string | null;
-  value?: string;
-  code?: string;
-  label?: string;
-};
-
-/** @see CountryOptionLabel — flag + name (+ optional code) row. */
-export type CountryOptionLabelProp = {
-  country: CountryOptionProp;
-  showCode?: boolean;
-  className?: ClassNameProp;
-};
-
-/** @see CountrySelect — country picker built on Select. */
-export type CountrySelectProp = {
-  id: IdProp;
-  name: string;
-  options: CountryOptionProp[];
-  defaultValue?: string | null;
-  required?: RequiredProp;
-  allowEmpty?: boolean;
-  emptyLabel?: string;
-  placeholder?: PlaceholderProp;
-  invalid?: boolean;
-};
-
-/** @see Slider — numeric range (Radix Slider). */
-export type SliderProp = React.ComponentPropsWithoutRef<typeof SliderPrimitive.Root>;
-
-/** @see Calendar — react-day-picker DayPicker. */
-export type CalendarProp = DayPickerProps;
-
-/** @see DatePicker */
-export type DatePickerProp = {
-  value?: Date;
-  onChange?: (date: Date | undefined) => void;
-  placeholder?: PlaceholderProp;
-  disabled?: DisabledProp;
-  className?: ClassNameProp;
-  id?: IdProp;
-  locale?: DayPickerProps["locale"];
-  fromDate?: Date;
-  toDate?: Date;
-};
-
-/** @see DateRangePicker */
-export type DateRangePickerProp = {
-  value?: DateRange;
-  onChange?: (range: DateRange | undefined) => void;
-  placeholder?: PlaceholderProp;
-  disabled?: DisabledProp;
-  className?: ClassNameProp;
-  id?: IdProp;
-  locale?: DayPickerProps["locale"];
-  fromDate?: Date;
-  toDate?: Date;
-};
-
-/** @see TimePicker — popover HH:mm picker (canonical 24h storage). */
-export type TimePickerProp = {
-  value?: string;
-  defaultValue?: string;
-  onChange?: (value: string) => void;
-  placeholder?: PlaceholderProp;
-  disabled?: DisabledProp;
-  className?: ClassNameProp;
-  id?: IdProp;
-  /** Minute column step — default 5 (logistics cut-offs). */
-  minuteStep?: number;
-};
-
-/** @see ColorPicker */
-export type ColorPickerProp = {
-  value?: string;
-  onChange?: (hex: string) => void;
-  disabled?: DisabledProp;
-  className?: ClassNameProp;
-  id?: IdProp;
-  showHexInput?: boolean;
-};
-
-/** Autocomplete option row. */
-export type AutocompleteOptionProp = {
-  value: string;
-  label: string;
-};
-
-/** @see Autocomplete — searchable combobox. */
-export type AutocompleteProp = {
-  options: AutocompleteOptionProp[];
-  value?: ValueProp;
-  onValueChange?: (value: string) => void;
-  placeholder?: PlaceholderProp;
-  searchPlaceholder?: PlaceholderProp;
-  emptyMessage?: string;
-  disabled?: DisabledProp;
-  className?: ClassNameProp;
-  id?: IdProp;
-};
-
-/** @see UploadFileItem */
-export type UploadFileItemProp = UploadFileItem;
-
-/** @see Upload */
-export type UploadVariantProp =
-  | "dropzone"
-  | "button"
-  | "picture-card"
-  | "picture"
-  | "avatar"
-  | "avatar-crop";
-
-/** @see Upload — presentational; wire `onUpload` to media-service in app api.ts */
-export type UploadProp = {
-  variant?: UploadVariantProp;
-  value?: UploadFileItemProp[];
-  defaultValue?: UploadFileItemProp[];
-  onChange?: (items: UploadFileItemProp[]) => void;
-  accept?: string;
-  multiple?: boolean;
-  maxCount?: number;
-  maxSizeBytes?: number;
-  disabled?: DisabledProp;
-  removable?: boolean;
-  /** App: issue → PUT → complete; return mediaId + optional preview URL */
-  onUpload?: (
-    file: File,
-    item: UploadFileItemProp,
-  ) => Promise<{ mediaId: string; previewUrl?: string }>;
-  className?: ClassNameProp;
-  children?: React.ReactNode;
-};
-
-/** Tree node — shared by Cascader options & TreeSelect treeData. */
-export type TreeOptionProp = {
-  value: string;
-  label: React.ReactNode;
-  disabled?: boolean;
-  disableCheckbox?: boolean;
-  isLeaf?: boolean;
-  children?: TreeOptionProp[];
-};
-
-export type TreeFieldNamesProp = {
-  label?: string;
-  value?: string;
-  children?: string;
-};
-
-/** @see Cascader — cascade picker (Popover + multi-column). */
-export type CascaderProp = {
-  options: TreeOptionProp[];
-  value?: string[] | string[][];
-  defaultValue?: string[] | string[][];
-  onChange?: (
-    value: string[] | string[][],
-    selectedOptions?: TreeOptionProp[] | TreeOptionProp[][],
-  ) => void;
-  multiple?: boolean;
-  changeOnSelect?: boolean;
-  showSearch?: boolean;
-  placeholder?: PlaceholderProp;
-  disabled?: DisabledProp;
-  className?: ClassNameProp;
-  id?: IdProp;
-  expandTrigger?: "click" | "hover";
-  fieldNames?: TreeFieldNamesProp;
-  allowClear?: boolean;
-};
-
-export type ShowCheckedStrategyProp = "SHOW_CHILD" | "SHOW_PARENT" | "SHOW_ALL";
-
-/** @see TreeSelect — tree in Popover (cmdk search + expand/collapse). */
-export type TreeSelectProp = {
-  treeData: TreeOptionProp[];
-  value?: string | string[];
-  defaultValue?: string | string[];
-  onChange?: (value: string | string[] | undefined) => void;
-  multiple?: boolean;
-  treeCheckable?: boolean;
-  treeCheckStrictly?: boolean;
-  showSearch?: boolean;
-  showCheckedStrategy?: ShowCheckedStrategyProp;
-  treeDefaultExpandAll?: boolean;
-  placeholder?: PlaceholderProp;
-  disabled?: DisabledProp;
-  allowClear?: boolean;
-  className?: ClassNameProp;
-  id?: IdProp;
-  fieldNames?: TreeFieldNamesProp;
-};
-
-/** @see TransferItem */
-export type TransferItemProp = {
-  key: string;
-  title: React.ReactNode;
-  description?: React.ReactNode;
-  disabled?: boolean;
-};
-
-/** @see Transfer — dual-list shuttle (Checkbox + SearchInput). */
-export type TransferProp = {
-  dataSource: TransferItemProp[];
-  targetKeys: string[];
-  onChange?: (targetKeys: string[], direction: "left" | "right", moveKeys: string[]) => void;
-  titles?: [React.ReactNode, React.ReactNode];
-  showSearch?: boolean;
-  oneWay?: boolean;
-  disabled?: DisabledProp;
-  className?: ClassNameProp;
-  selectedKeys?: [string[], string[]];
-  onSelectChange?: (sourceSelectedKeys: string[], targetSelectedKeys: string[]) => void;
-};

package/src/props/components/feedback.prop.ts

@@ -1,80 +0,0 @@
-/** Feedback component prop types — @see docs/COMPONENTS.md#feedback */
-import type * as React from "react";
-import type {
-  AlertVariantProp,
-  CancelLabelProp,
-  ChildrenProp,
-  ClassNameProp,
-  ConfirmLabelProp,
-  ConfirmVariantProp,
-  DescriptionProp,
-  HandlerProp,
-  IconProp,
-  OpenProp,
-  OnOpenChangeProp,
-  PendingProp,
-  TitleProp,
-} from "../vocabulary";
-
-/** @see Dialog.Confirm */
-export type DialogConfirmProp = {
-  open: OpenProp;
-  onOpenChange: OnOpenChangeProp;
-  title: TitleProp;
-  description?: DescriptionProp;
-  confirmLabel?: ConfirmLabelProp;
-  cancelLabel?: CancelLabelProp;
-  variant?: ConfirmVariantProp;
-  /** Type-to-confirm friction — enables destructive flow (GitHub/Stripe style). */
-  confirmPhrase?: string;
-  onConfirm: HandlerProp;
-  keepOpenOnConfirm?: boolean;
-  pending?: PendingProp;
-};
-
-/** @see Alert */
-export type AlertQueryErrorProp = {
-  error: unknown;
-  onRetry?: HandlerProp;
-  className?: ClassNameProp;
-};
-
-/** @see Alert */
-export type AlertProp = React.HTMLAttributes<HTMLDivElement> & {
-  variant?: AlertVariantProp;
-  /** Pass `false` to hide the default variant icon. */
-  icon?: IconProp | false;
-  onDismiss?: HandlerProp;
-  className?: ClassNameProp;
-  children?: ChildrenProp;
-};
-
-/** @see AlertTitle */
-export type AlertTitleProp = React.HTMLAttributes<HTMLParagraphElement> & {
-  className?: ClassNameProp;
-  children?: ChildrenProp;
-};
-
-/** @see AlertContent — groups title + description; pairs with {@link AlertActions}. */
-export type AlertContentProp = React.HTMLAttributes<HTMLDivElement> & {
-  className?: ClassNameProp;
-  children?: ChildrenProp;
-};
-
-/** @see AlertDescription */
-export type AlertDescriptionProp = React.HTMLAttributes<HTMLParagraphElement> & {
-  className?: ClassNameProp;
-  children?: ChildrenProp;
-};
-
-/** @see AlertActions */
-export type AlertActionsProp = React.HTMLAttributes<HTMLDivElement> & {
-  className?: ClassNameProp;
-  children?: ChildrenProp;
-};
-
-/** @see SkeletonRows */
-export type SkeletonRowsProp = {
-  rows?: number;
-  columns?: number;
-};

package/src/props/components/form.prop.ts

@@ -1,46 +0,0 @@
-/** Form module prop types — react-hook-form + Zod 4 only. */
-import type * as React from "react";
-import type { FieldPath, FieldValues, UseFormProps, UseFormReturn } from "react-hook-form";
-import type { z } from "zod";
-import type { ErrorProp, HelperProp, IdProp, LabelProp, RequiredProp } from "../vocabulary";
-
-/** Schema passed to useZodForm — must be Zod 4 object schema. */
-export type ZodSchemaProp<T extends z.ZodType = z.ZodType> = T;
-
-/** Options for useZodForm (resolver injected automatically). */
-export type UseZodFormOptionsProp<TFieldValues extends FieldValues> = Omit<
-  UseFormProps<TFieldValues>,
-  "resolver"
->;
-
-/** Return type of useZodForm. */
-export type UseZodFormReturnProp<TFieldValues extends FieldValues> = UseFormReturn<TFieldValues>;
-
-/** @see FormRoot */
-export type FormRootProp<TFieldValues extends FieldValues> = {
-  form: UseZodFormReturnProp<TFieldValues>;
-  onSubmit: (values: TFieldValues) => void | Promise<void>;
-  children: React.ReactNode;
-  className?: string;
-  id?: IdProp;
-};
-
-/** @see FormFieldControl */
-export type FormFieldControlProp<TFieldValues extends FieldValues> = {
-  name: FieldPath<TFieldValues>;
-  label: LabelProp;
-  required?: RequiredProp;
-  helper?: HelperProp;
-  className?: string;
-  children: (field: {
-    id: string;
-    name: string;
-    value: unknown;
-    onChange: (...args: unknown[]) => void;
-    onBlur: () => void;
-    ref: React.Ref<HTMLInputElement>;
-  }) => React.ReactNode;
-};
-
-/** Mapped field error from RHF — displayed via FormField error slot. */
-export type FieldErrorMessageProp = ErrorProp;

package/src/props/components/general.prop.ts

@@ -1,18 +0,0 @@
-/** Foundation component prop types — @see docs/COMPONENTS.md#foundation */
-import type * as React from "react";
-import type {
-  AsChildProp,
-  ButtonSizeProp,
-  ButtonVariantProp,
-  DisabledProp,
-  OnClickProp,
-} from "../vocabulary";
-
-/** @see Button */
-export type ButtonProp = React.ButtonHTMLAttributes<HTMLButtonElement> & {
-  variant?: ButtonVariantProp;
-  size?: ButtonSizeProp;
-  asChild?: AsChildProp;
-  onClick?: OnClickProp;
-  disabled?: DisabledProp;
-};