@dinofront/design_system 1.1.0 → 1.2.1

package/dist/components/DatePicker/DatePicker.types.d.ts

@@ -18,6 +18,18 @@ export interface DatePickerProps extends BaseProps {
     /** Fill the parent's width (like Input/Select) instead of the intrinsic
      *  min-width. Use inside form grids so dates line up with other fields. */
     fullWidth?: boolean;
+    /** Disable the trigger entirely — blocks both mouse and keyboard activation. */
+    disabled?: boolean;
+    /** Earliest selectable day, inclusive. Earlier days render disabled. Time-of-day is ignored. */
+    minDate?: Date;
+    /** Latest selectable day, inclusive. Later days render disabled. Time-of-day is ignored. */
+    maxDate?: Date;
+    /** Individual days that can't be picked. Matched by calendar day; time-of-day is ignored. */
+    excludeDates?: Date[];
+    /** Switch the trigger to the danger border/ring styles. */
+    error?: boolean;
+    /** Message rendered below the control; also switches the trigger to the danger styles. */
+    errorText?: ReactNode;
     id?: string;
     className?: string;
     wrapperClassName?: string;

package/dist/components/FormField/FormField.types.d.ts

@@ -1,5 +1,5 @@
 import { HTMLAttributes, ReactElement } from 'react';
-import { RefCallBack } from 'react-hook-form';
+import { RefCallBack, SetValueConfig } from 'react-hook-form';
 import { BaseProps } from '../../types';
 /** Deliberately untyped `value`/`onChange`: this render prop feeds whichever
  *  input the consumer wires up (native `value`, Select's `string`, Checkbox's
@@ -13,6 +13,13 @@ export interface FormFieldRenderProps {
     error: boolean;
     errorText?: string;
     dataTestId?: string;
+    /** Imperatively set this field's value, pre-bound to this FormField's
+     *  `name` — for a component whose own change contract doesn't fit RHF's
+     *  field bindings. Defaults `shouldValidate`/`shouldDirty`/`shouldTouch`
+     *  to `true`, overridable via `options`. */
+    setFieldValue: (value: unknown, options?: SetValueConfig) => void;
+    /** True once the field has been touched, changed from its default value, and currently passes validation. */
+    isValid: boolean;
 }
 export interface FormFieldProps extends Omit<HTMLAttributes<HTMLDivElement>, 'defaultValue'>, BaseProps {
     name: string;

package/dist/components/Radio/Radio.types.d.ts

@@ -3,6 +3,7 @@ import { BaseProps } from '../../types';
 export type RadioSize = 'md' | 'sm';
 export interface RadioGroupProps extends BaseProps {
     name?: string;
+    label?: ReactNode;
     value?: string;
     defaultValue?: string;
     onChange?: (value: string) => void;

package/dist/components/Select/Select.types.d.ts

@@ -5,6 +5,13 @@ export interface SelectOption {
     value: string;
     label: ReactNode;
     disabled?: boolean;
+    /** Group heading this option belongs under. Options sharing a group MUST be
+     *  contiguous in the `options` array — the heading is emitted whenever this
+     *  value changes between consecutive options, so a non-contiguous group
+     *  renders its heading more than once. */
+    group?: string;
+    /** Text used for `searchable` matching when `label` isn't a plain string. */
+    searchText?: string;
 }
 export interface SelectProps extends BaseProps {
     options: SelectOption[];
@@ -20,6 +27,16 @@ export interface SelectProps extends BaseProps {
     error?: boolean;
     size?: SelectSize;
     disabled?: boolean;
+    /** Renders a red asterisk next to the label and sets `aria-required` on the trigger. */
+    required?: boolean;
+    /** Shows a spinner in place of the chevron and blocks opening the list. Does not set the native `disabled` attribute. */
+    loading?: boolean;
+    /** Renders a text filter pinned above the open list. */
+    searchable?: boolean;
+    /** Placeholder for the `searchable` filter input. Defaults to `'Search…'`. */
+    searchPlaceholder?: string;
+    /** Shown in place of the list when the filter matches nothing. Defaults to `'No results'`. */
+    emptyText?: string;
     id?: string;
     className?: string;
     wrapperClassName?: string;

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

@@ -6,7 +6,7 @@ export interface UploadRejection {
     file: File;
     reason: UploadRejectionReason;
 }
-export interface UploadProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onClick' | 'onDrop' | 'onDragEnter' | 'onDragOver' | 'onDragLeave' | 'onKeyDown' | 'role' | 'tabIndex' | 'aria-disabled'>, BaseProps {
+export interface UploadProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onClick' | 'onDrop' | 'onDragEnter' | 'onDragOver' | 'onDragLeave' | 'onKeyDown' | 'role' | 'tabIndex' | 'aria-disabled' | 'aria-invalid'>, BaseProps {
     /** Forwarded to the hidden native `<input type="file">`, e.g. `"image/png,image/jpeg"`. */
     accept?: string;
     multiple?: boolean;
@@ -35,6 +35,10 @@ export interface UploadProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onCli
     triggerIcon?: ReactNode;
     label?: ReactNode;
     required?: boolean;
+    /** Switches the dropzone (or, in `button`/`icon` mode, just the message below) to the danger styles. */
+    error?: boolean;
+    /** Message rendered below the control; also switches dropzone mode to the danger styles. */
+    errorText?: ReactNode;
     /** Content rendered on the label row, right of the label text and required marker — e.g. an info tooltip trigger. */
     labelAddons?: ReactNode;
 }

package/dist/hooks/index.d.ts

@@ -1,2 +1,9 @@
 export { useStepper } from './useStepper';
 export type { UseStepperOptions, UseStepperResult } from './useStepper';
+export { useOnOutsideClick } from './useOnOutsideClick';
+export { useEscapeKey } from './useEscapeKey';
+export { useHideBodyScroll } from './useHideBodyScroll';
+export { useIsMobile } from './useIsMobile';
+export { useFormContext } from './useFormContext';
+export { useFormProps } from './useFormProps';
+export type { FormContextValue } from '../lib/FormContext';

package/dist/hooks/useEscapeKey.d.ts

@@ -0,0 +1,4 @@
+/** Fires `onEscape` when the user presses `Escape`, anywhere in the
+ *  document — not scoped to a container, matching how dismissible
+ *  overlays (menus, drawers, popovers) listen for it today. */
+export declare function useEscapeKey(onEscape: () => void, enabled?: boolean): void;

package/dist/hooks/useFormContext.d.ts

@@ -0,0 +1,6 @@
+import { FormContextValue } from '../lib/FormContext';
+/** Reads the ambient form state provided by the nearest `FormContainer`.
+ *  Throws outside one, matching `FormField`'s existing null-check — the
+ *  same failure whether a consumer uses `FormField` or this hook
+ *  directly. */
+export declare function useFormContext(): FormContextValue;

package/dist/hooks/useFormProps.d.ts

@@ -0,0 +1,9 @@
+import { FormContextValue } from '../lib/FormContext';
+/** Reads the ambient form state provided by the nearest `FormContainer` —
+ *  the same context `useFormContext` reads — but never throws outside
+ *  one. Returns an inert default context instead, so call sites migrated
+ *  from an existing `useFormProps()` (e.g. an app's own hrm_ui_lib-shaped
+ *  shim) keep working without adding a null check. Prefer
+ *  `useFormContext` in new code, where a missing `FormContainer` is
+ *  usually a programmer error you want to surface immediately. */
+export declare function useFormProps(): FormContextValue;

package/dist/hooks/useHideBodyScroll.d.ts

@@ -0,0 +1,6 @@
+/** Locks `document.body` scrolling while `active`, restoring whatever
+ *  `overflow` value was set before the first lock once the last active
+ *  caller deactivates. Reference-counted across concurrent callers (e.g.
+ *  a drawer opened from within a modal) so one overlay closing early
+ *  never clobbers another's lock. */
+export declare function useHideBodyScroll(active: boolean): void;

package/dist/hooks/useIsMobile.d.ts

@@ -0,0 +1,9 @@
+/** True when the viewport is at or below `breakpoint` (default 768px).
+ *  Returns `false` during SSR and during the very first client render —
+ *  the effect computes and syncs the real value right after mount, so
+ *  the server-rendered markup and the client's first render always
+ *  agree (no hydration mismatch), at the cost of one extra render after
+ *  mount when the viewport actually is narrow. Subscribes to the media
+ *  query's `change` event rather than `window.resize`, so it only
+ *  re-renders when the mobile/desktop boundary is actually crossed. */
+export declare function useIsMobile(breakpoint?: number): boolean;

package/dist/hooks/useOnOutsideClick.d.ts

@@ -0,0 +1,6 @@
+import { RefObject } from 'react';
+/** Fires `handler` on any `mousedown`/`touchstart` outside `ref.current`.
+ *  No effect while `ref.current` is null or `enabled` is false — callers
+ *  don't need to guard call sites where the ref isn't attached yet (e.g.
+ *  before a portal mounts). */
+export declare function useOnOutsideClick(ref: RefObject<HTMLElement | null> | null | undefined, handler: (event: MouseEvent | TouchEvent) => void, enabled?: boolean): void;