@dinofront/design_system 1.1.0 → 1.2.0

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;