neatkit 0.1.0 → 0.3.0

package/dist/components/Icon/index.d.ts

@@ -0,0 +1,36 @@
+export { default as Icon } from "./Icon";
+export type { IconProps } from "./Icon";
+export type { IconType } from "./utils/registry";
+export { default as ChatIcon } from "./icons/ChatIcon";
+export { default as ProjectsIcon } from "./icons/ProjectsIcon";
+export { default as ArticlesIcon } from "./icons/ArticlesIcon";
+export { default as MailIcon } from "./icons/MailIcon";
+export { default as GithubIcon } from "./icons/GithubIcon";
+export { default as GlobeIcon } from "./icons/GlobeIcon";
+export { default as LinkedInIcon } from "./icons/LinkedInIcon";
+export { default as RedditIcon } from "./icons/RedditIcon";
+export { default as ExitIcon } from "./icons/ExitIcon";
+export { default as CameraIcon } from "./icons/CameraIcon";
+export { default as QRCodeIcon } from "./icons/QRCodeIcon";
+export { default as DownloadIcon } from "./icons/DownloadIcon";
+export { default as SaveIcon } from "./icons/SaveIcon";
+export { default as PencilIcon } from "./icons/PencilIcon";
+export { default as ArrowLeftIcon } from "./icons/ArrowLeftIcon";
+export { default as ArrowRightIcon } from "./icons/ArrowRightIcon";
+export { default as CrossIcon } from "./icons/CrossIcon";
+export { default as CheckmarkIcon } from "./icons/CheckmarkIcon";
+export { default as PlusIcon } from "./icons/PlusIcon";
+export { default as MinusIcon } from "./icons/MinusIcon";
+export { default as WindowIcon } from "./icons/WindowIcon";
+export { default as UserIcon } from "./icons/UserIcon";
+export { default as DuplicateIcon } from "./icons/DuplicateIcon";
+export { default as EyeIcon } from "./icons/EyeIcon";
+export { default as EyeOffIcon } from "./icons/EyeOffIcon";
+export { default as SignalIcon } from "./icons/SignalIcon";
+export { default as AudioIcon } from "./icons/AudioIcon";
+export { default as HardwareIcon } from "./icons/HardwareIcon";
+export { default as BurgerIcon } from "./icons/BurgerIcon";
+export { default as RepositoryIcon } from "./icons/RepositoryIcon";
+export { default as KeyIcon } from "./icons/KeyIcon";
+export { default as InfoIcon } from "./icons/InfoIcon";
+export { default as WarningIcon } from "./icons/WarningIcon";

package/dist/components/Icon/utils/registry.d.ts

@@ -0,0 +1,49 @@
+/** The icon graphics indexed by their public names. */
+export declare const iconGraphics: {
+    readonly projects: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly chat: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly articles: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly mail: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly github: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly globe: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly linkedin: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly reddit: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly exit: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly camera: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "qr-code": import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly download: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly save: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly pencil: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "arrow-left": import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "arrow-right": import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly cross: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly checkmark: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly plus: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly minus: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly window: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly user: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly duplicate: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly eye: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "eye-off": import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly signal: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly audio: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly hardware: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly burger: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly repository: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "chevron-down": import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "chevron-up": import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "chevron-left": import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "chevron-right": import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly branch: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly commit: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly folder: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly file: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly tag: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly key: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly git: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly home: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly info: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly warning: import("react").ForwardRefExoticComponent<Omit<import("../icons/types").IconGraphicProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+};
+/** A type representing the icons available through the Icon component. */
+export type IconType = keyof typeof iconGraphics;

package/dist/components/Input/Input.d.ts

@@ -0,0 +1,50 @@
+import { type CSSProperties, type InputHTMLAttributes, type ReactNode } from "react";
+import "./styles/input.css";
+/** A type representing the supported native single-line input types. */
+export type InputType = "email" | "number" | "password" | "search" | "tel" | "text" | "url";
+/** A type representing properties for the Input component. */
+export type InputProps = Omit<InputHTMLAttributes<HTMLInputElement>, "children" | "className" | "style" | "type"> & {
+    /** The additional class name applied to the composite Input root. */
+    className?: string;
+    /** Whether the Input provides a built-in clear action. */
+    clearable?: boolean;
+    /** Whether the Input exposes an invalid semantic and visual state. */
+    invalid?: boolean;
+    /** The content displayed before the editable value. */
+    leading?: ReactNode;
+    /** Whether the Input displays a loading indicator and blocks editing. */
+    loading?: boolean;
+    /** The content displayed after the editable value. */
+    trailing?: ReactNode;
+    /** The inline styles applied to the composite Input root. */
+    style?: CSSProperties;
+    /** The supported native behavior applied to the single-line control. */
+    type?: InputType;
+};
+/**
+ * Renders a themed native single-line input with optional adornments.
+ *
+ * @param props - The properties that configure the Input.
+ * @param forwardedReference - The reference assigned to the native input.
+ *
+ * @returns The rendered Input control.
+ */
+declare const Input: import("react").ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "className" | "style" | "children" | "type"> & {
+    /** The additional class name applied to the composite Input root. */
+    className?: string;
+    /** Whether the Input provides a built-in clear action. */
+    clearable?: boolean;
+    /** Whether the Input exposes an invalid semantic and visual state. */
+    invalid?: boolean;
+    /** The content displayed before the editable value. */
+    leading?: ReactNode;
+    /** Whether the Input displays a loading indicator and blocks editing. */
+    loading?: boolean;
+    /** The content displayed after the editable value. */
+    trailing?: ReactNode;
+    /** The inline styles applied to the composite Input root. */
+    style?: CSSProperties;
+    /** The supported native behavior applied to the single-line control. */
+    type?: InputType;
+} & import("react").RefAttributes<HTMLInputElement>>;
+export default Input;

package/dist/components/Input/index.d.ts

@@ -0,0 +1,2 @@
+export { default as Input } from "./Input";
+export type { InputProps, InputType } from "./Input";

package/dist/components/Modal/Modal.d.ts

@@ -0,0 +1,62 @@
+import { type HTMLAttributes, type ReactNode, type RefObject } from "react";
+import "./styles/modal.css";
+/** A type representing an interaction that requests Modal closure. */
+export type ModalCloseReason = "close-button" | "escape" | "outside";
+/** A type representing properties for the Modal component. */
+export type ModalProps = Omit<HTMLAttributes<HTMLDivElement>, "children" | "onClose" | "title"> & {
+    /** The content displayed inside the Modal panel. */
+    children?: ReactNode;
+    /** The accessible label announced by the close button. */
+    closeButtonLabel?: string;
+    /** Whether the Modal exposes user-operated closing interactions. */
+    exitable?: boolean;
+    /** The preferred element focused when the Modal opens. */
+    initialFocusReference?: RefObject<HTMLElement | null>;
+    /** Whether document scrolling is locked while the Modal is open. */
+    lockScroll?: boolean;
+    /** The callback invoked when an allowed interaction requests closure. */
+    onClose?: (reason: ModalCloseReason) => void;
+    /** Whether the Modal is currently open. */
+    open: boolean;
+    /** The optional element receiving the Modal portal. */
+    portalContainer?: Element | null;
+    /** Whether focus returns to its prior owner when the Modal closes. */
+    restoreFocus?: boolean;
+    /** Whether keyboard and programmatic focus remain inside the Modal. */
+    trapFocus?: boolean;
+    /** The fixed-style heading displayed beside the optional close button. */
+    title?: string;
+};
+/**
+ * Renders a portal-backed modal dialog and its presentational backdrop.
+ *
+ * @param props - The properties that configure the Modal.
+ * @param forwardedReference - The reference assigned to the Modal panel.
+ *
+ * @returns The open, exiting, or unmounted Modal content.
+ */
+declare const Modal: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLDivElement>, "title" | "children" | "onClose"> & {
+    /** The content displayed inside the Modal panel. */
+    children?: ReactNode;
+    /** The accessible label announced by the close button. */
+    closeButtonLabel?: string;
+    /** Whether the Modal exposes user-operated closing interactions. */
+    exitable?: boolean;
+    /** The preferred element focused when the Modal opens. */
+    initialFocusReference?: RefObject<HTMLElement | null>;
+    /** Whether document scrolling is locked while the Modal is open. */
+    lockScroll?: boolean;
+    /** The callback invoked when an allowed interaction requests closure. */
+    onClose?: (reason: ModalCloseReason) => void;
+    /** Whether the Modal is currently open. */
+    open: boolean;
+    /** The optional element receiving the Modal portal. */
+    portalContainer?: Element | null;
+    /** Whether focus returns to its prior owner when the Modal closes. */
+    restoreFocus?: boolean;
+    /** Whether keyboard and programmatic focus remain inside the Modal. */
+    trapFocus?: boolean;
+    /** The fixed-style heading displayed beside the optional close button. */
+    title?: string;
+} & import("react").RefAttributes<HTMLDivElement>>;
+export default Modal;

package/dist/components/Modal/index.d.ts

@@ -0,0 +1,2 @@
+export { default as Modal } from "./Modal";
+export type { ModalCloseReason, ModalProps } from "./Modal";

package/dist/components/PinInput/PinInput.d.ts

@@ -0,0 +1,76 @@
+import { type CSSProperties, type InputHTMLAttributes } from "react";
+import "./styles/pin-input.css";
+/** A type representing the characters accepted by PinInput. */
+export type PinInputMode = "alphanumeric" | "numeric";
+/** A type representing internal PinInput layout custom properties. */
+type PinInputCustomProperties = {
+    /** The number of visual slots displayed in each wrapped row. */
+    "--nk-pin-input-columns"?: number;
+};
+/** A type representing PinInput root styles and layout custom properties. */
+type PinInputStyle = CSSProperties & PinInputCustomProperties;
+/** A type representing properties for the PinInput component. */
+export type PinInputProps = Omit<InputHTMLAttributes<HTMLInputElement>, "children" | "className" | "defaultValue" | "inputMode" | "maxLength" | "minLength" | "onChange" | "onPaste" | "pattern" | "size" | "style" | "type" | "value"> & {
+    /** The additional class name applied to the composite PinInput root. */
+    className?: string;
+    /** Whether entered characters are visually replaced with centered dots. */
+    censored?: boolean;
+    /** The initial value used by an uncontrolled PinInput. */
+    defaultValue?: string;
+    /** Whether the PinInput exposes an invalid semantic and visual state. */
+    invalid?: boolean;
+    /** The character count, constrained to a whole number from three to nine. */
+    length?: number;
+    /** The character set accepted by the native input. */
+    mode?: PinInputMode;
+    /** The native change callback receiving the normalized value. */
+    onChange?: InputHTMLAttributes<HTMLInputElement>["onChange"];
+    /** The callback invoked when every configured character has been entered. */
+    onComplete?: (value: string) => void;
+    /** The native paste callback invoked before built-in paste behavior. */
+    onPaste?: InputHTMLAttributes<HTMLInputElement>["onPaste"];
+    /** The inline styles applied to the composite PinInput root. */
+    style?: PinInputStyle;
+    /** The value used by a controlled PinInput. */
+    value?: string;
+    /** Whether visual slots wrap into two balanced rows. */
+    wrap?: boolean;
+};
+/**
+ * Renders one accessible native input as a segmented one-time-code control.
+ *
+ * PinInput uses a single form value and accessible name while presenting each
+ * character in a separate visual slot.
+ *
+ * @param props - The properties that configure the PinInput.
+ * @param forwardedReference - The reference assigned to the native input.
+ *
+ * @returns The rendered PinInput control.
+ */
+declare const PinInput: import("react").ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "defaultValue" | "className" | "style" | "inputMode" | "children" | "onPaste" | "onChange" | "size" | "type" | "pattern" | "value" | "maxLength" | "minLength"> & {
+    /** The additional class name applied to the composite PinInput root. */
+    className?: string;
+    /** Whether entered characters are visually replaced with centered dots. */
+    censored?: boolean;
+    /** The initial value used by an uncontrolled PinInput. */
+    defaultValue?: string;
+    /** Whether the PinInput exposes an invalid semantic and visual state. */
+    invalid?: boolean;
+    /** The character count, constrained to a whole number from three to nine. */
+    length?: number;
+    /** The character set accepted by the native input. */
+    mode?: PinInputMode;
+    /** The native change callback receiving the normalized value. */
+    onChange?: InputHTMLAttributes<HTMLInputElement>["onChange"];
+    /** The callback invoked when every configured character has been entered. */
+    onComplete?: (value: string) => void;
+    /** The native paste callback invoked before built-in paste behavior. */
+    onPaste?: InputHTMLAttributes<HTMLInputElement>["onPaste"];
+    /** The inline styles applied to the composite PinInput root. */
+    style?: PinInputStyle;
+    /** The value used by a controlled PinInput. */
+    value?: string;
+    /** Whether visual slots wrap into two balanced rows. */
+    wrap?: boolean;
+} & import("react").RefAttributes<HTMLInputElement>>;
+export default PinInput;

package/dist/components/PinInput/hooks/usePinInput.d.ts

@@ -0,0 +1,65 @@
+import { type ChangeEvent, type ClipboardEvent, type FocusEvent, type ForwardedRef, type KeyboardEvent, type PointerEvent, type SyntheticEvent } from "react";
+import type { PinInputMode } from "../PinInput";
+/** A type representing the options used by PinInput behavior. */
+type UsePinInputOptions = {
+    /** The initial value used by an uncontrolled PinInput. */
+    defaultValue: string;
+    /** Whether the native input blocks editing and focus. */
+    disabled: boolean;
+    /** The native input reference supplied by the consumer. */
+    forwardedReference: ForwardedRef<HTMLInputElement>;
+    /** The requested visual character count. */
+    length: number;
+    /** The character set accepted by the native input. */
+    mode: PinInputMode;
+    /** The native change callback receiving normalized content. */
+    onChange?: (event: ChangeEvent<HTMLInputElement>) => void;
+    /** The callback invoked when every character has been entered. */
+    onComplete?: (value: string) => void;
+    /** The native focus callback forwarded after internal focus behavior. */
+    onFocus?: (event: FocusEvent<HTMLInputElement>) => void;
+    /** The native key callback invoked before built-in arrow behavior. */
+    onKeyDown?: (event: KeyboardEvent<HTMLInputElement>) => void;
+    /** The native paste callback invoked before built-in paste behavior. */
+    onPaste?: (event: ClipboardEvent<HTMLInputElement>) => void;
+    /** The native selection callback forwarded after internal selection. */
+    onSelect?: (event: SyntheticEvent<HTMLInputElement>) => void;
+    /** Whether the native input prevents value editing. */
+    readOnly: boolean;
+    /** The value used by a controlled PinInput. */
+    value?: string;
+};
+/** A type representing state and behavior returned to PinInput. */
+type UsePinInputResult = {
+    /** The visual slot represented by the native selection. */
+    activeIndex: number;
+    /** Handles normalized native editing. */
+    handleChange: (event: ChangeEvent<HTMLInputElement>) => void;
+    /** Places initial focus at the first incomplete slot. */
+    handleFocus: (event: FocusEvent<HTMLInputElement>) => void;
+    /** Moves native selection through visual slots. */
+    handleKeyDown: (event: KeyboardEvent<HTMLInputElement>) => void;
+    /** Distributes clipboard content through the native input. */
+    handlePaste: (event: ClipboardEvent<HTMLInputElement>) => void;
+    /** Synchronizes visual and native selection state. */
+    handleSelect: (event: SyntheticEvent<HTMLInputElement>) => void;
+    /** Focuses the visual slot selected with a pointer. */
+    handleSlotPointerDown: (event: PointerEvent<HTMLSpanElement>, index: number) => void;
+    /** The stable callback assigning the native input reference. */
+    inputCallbackReference: (element: HTMLInputElement | null) => void;
+    /** The normalized supported character count. */
+    length: number;
+    /** The normalized value displayed by the control. */
+    renderedValue: string;
+};
+/** The default PinInput character count. */
+export declare const DEFAULT_PIN_LENGTH = 4;
+/**
+ * Manages native PinInput state, selection, paste, and form behavior.
+ *
+ * @param options - The controlled state and native callbacks to coordinate.
+ *
+ * @returns The normalized value and handlers rendered by PinInput.
+ */
+export declare function usePinInput(options: UsePinInputOptions): UsePinInputResult;
+export {};

package/dist/components/PinInput/index.d.ts

@@ -0,0 +1,2 @@
+export { default as PinInput } from "./PinInput";
+export type { PinInputMode, PinInputProps } from "./PinInput";

package/dist/components/Popover/Popover.d.ts

@@ -0,0 +1,93 @@
+import { type HTMLAttributes, type ReactElement, type ReactNode, type RefObject } from "react";
+import type { FloatingPlacement } from "../Portal/utils/floating-position";
+import "./styles/popover.css";
+/** A type representing the preferred placement of a Popover. */
+export type PopoverPlacement = FloatingPlacement;
+/** A type representing an interaction that requests a Popover state change. */
+export type PopoverOpenChangeReason = "escape" | "outside" | "programmatic" | "trigger";
+/** A type representing properties for the Popover component. */
+export type PopoverProps = Omit<HTMLAttributes<HTMLDivElement>, "children" | "defaultValue" | "onChange"> & {
+    /** Whether focus moves inside the panel when it opens. */
+    autoFocus?: boolean;
+    /** The interactive content displayed inside the Popover panel. */
+    children: ReactNode;
+    /** Whether an outside pointer interaction closes the Popover. */
+    closeOnOutsideInteraction?: boolean;
+    /** Whether the Escape key closes the Popover. */
+    closeOnEscape?: boolean;
+    /** Whether an uncontrolled Popover is initially open. */
+    defaultOpen?: boolean;
+    /** Whether Popover behavior is disabled without removing its trigger. */
+    disabled?: boolean;
+    /** The preferred element focused when the Popover opens. */
+    initialFocusReference?: RefObject<HTMLElement | null>;
+    /** The callback receiving Escape before its default closing behavior. */
+    onEscapeKeyDown?: (event: KeyboardEvent) => void;
+    /** The callback invoked for a requested change to the open state. */
+    onOpenChange?: (open: boolean, reason: PopoverOpenChangeReason) => void;
+    /** The callback receiving an outside press before default behavior. */
+    onPointerDownOutside?: (event: PointerEvent) => void;
+    /** The controlled open state of the Popover. */
+    open?: boolean;
+    /** The preferred placement before viewport collision handling. */
+    placement?: PopoverPlacement;
+    /** The optional element receiving the Popover portal. */
+    portalContainer?: Element | null;
+    /** Whether focus returns to the trigger after non-outside closure. */
+    restoreFocus?: boolean;
+    /** Whether keyboard and programmatic focus remain inside the Popover. */
+    trapFocus?: boolean;
+    /**
+     * The single element that receives Popover trigger behavior.
+     *
+     * Custom components must forward standard DOM properties and a reference.
+     */
+    trigger: ReactElement;
+};
+/**
+ * Renders an interactive, click-triggered panel beside one interface element.
+ *
+ * @param props - The properties that configure the Popover.
+ * @param forwardedReference - The reference assigned to the Popover panel.
+ *
+ * @returns The trigger and its portal-backed interactive panel.
+ */
+declare const Popover: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLDivElement>, "defaultValue" | "children" | "onChange"> & {
+    /** Whether focus moves inside the panel when it opens. */
+    autoFocus?: boolean;
+    /** The interactive content displayed inside the Popover panel. */
+    children: ReactNode;
+    /** Whether an outside pointer interaction closes the Popover. */
+    closeOnOutsideInteraction?: boolean;
+    /** Whether the Escape key closes the Popover. */
+    closeOnEscape?: boolean;
+    /** Whether an uncontrolled Popover is initially open. */
+    defaultOpen?: boolean;
+    /** Whether Popover behavior is disabled without removing its trigger. */
+    disabled?: boolean;
+    /** The preferred element focused when the Popover opens. */
+    initialFocusReference?: RefObject<HTMLElement | null>;
+    /** The callback receiving Escape before its default closing behavior. */
+    onEscapeKeyDown?: (event: KeyboardEvent) => void;
+    /** The callback invoked for a requested change to the open state. */
+    onOpenChange?: (open: boolean, reason: PopoverOpenChangeReason) => void;
+    /** The callback receiving an outside press before default behavior. */
+    onPointerDownOutside?: (event: PointerEvent) => void;
+    /** The controlled open state of the Popover. */
+    open?: boolean;
+    /** The preferred placement before viewport collision handling. */
+    placement?: PopoverPlacement;
+    /** The optional element receiving the Popover portal. */
+    portalContainer?: Element | null;
+    /** Whether focus returns to the trigger after non-outside closure. */
+    restoreFocus?: boolean;
+    /** Whether keyboard and programmatic focus remain inside the Popover. */
+    trapFocus?: boolean;
+    /**
+     * The single element that receives Popover trigger behavior.
+     *
+     * Custom components must forward standard DOM properties and a reference.
+     */
+    trigger: ReactElement;
+} & import("react").RefAttributes<HTMLDivElement>>;
+export default Popover;

package/dist/components/Popover/index.d.ts

@@ -0,0 +1,2 @@
+export { default as Popover } from "./Popover";
+export type { PopoverOpenChangeReason, PopoverPlacement, PopoverProps, } from "./Popover";

package/dist/components/Portal/Portal.d.ts

@@ -0,0 +1,19 @@
+import { type ReactNode } from "react";
+/** A type representing properties accepted by an internal Portal. */
+type PortalProps = {
+    /** The content rendered outside its React layout parent. */
+    children: ReactNode;
+    /** The optional element receiving the portal content. */
+    container?: Element | null;
+    /** The optional element whose inherited Neatkit variables are preserved. */
+    inheritFrom?: HTMLElement | null;
+};
+/**
+ * Renders content into a browser-owned container after hydration.
+ *
+ * @param props - The portal destination, design source, and content.
+ *
+ * @returns A server-safe source marker and the mounted browser portal.
+ */
+export default function Portal(props: PortalProps): import("react").JSX.Element;
+export {};

package/dist/components/Portal/contexts/FocusScopeContext.d.ts

@@ -0,0 +1,7 @@
+/** A type representing a focus scope shared with nested portals. */
+export type FocusScopeContextValue = {
+    /** Registers one portalled branch as part of the logical focus scope. */
+    registerBranch: (branch: HTMLElement) => () => void;
+};
+/** The internal React context connecting focus traps with nested portals. */
+export declare const FocusScopeContext: import("react").Context<FocusScopeContextValue | undefined>;

package/dist/components/Portal/hooks/useDismissableLayer.d.ts

@@ -0,0 +1,31 @@
+import { type RefObject } from "react";
+/** A type representing options accepted by a dismissable overlay layer. */
+type DismissableLayerOptions = {
+    /** Whether the layer currently receives dismissal interactions. */
+    active: boolean;
+    /** Whether Escape requests dismissal. */
+    dismissOnEscape?: boolean;
+    /** Whether a pointer press outside every boundary requests dismissal. */
+    dismissOnPointerDownOutside?: boolean;
+    /** The boundaries considered part of the layer. */
+    boundaries: readonly RefObject<HTMLElement | null>[];
+    /** The stable overlay stack identifier for the layer. */
+    layerId: symbol;
+    /** The document owning the layer and its event listeners. */
+    ownerDocument: Document | null;
+    /** The callback receiving an Escape key before dismissal. */
+    onEscapeKeyDown?: (event: KeyboardEvent) => void;
+    /** The callback receiving an outside pointer press before dismissal. */
+    onPointerDownOutside?: (event: PointerEvent) => void;
+    /** The callback invoked after an allowed Escape interaction. */
+    onEscapeDismiss?: () => void;
+    /** The callback invoked after an allowed outside interaction. */
+    onPointerDownOutsideDismiss?: () => void;
+};
+/**
+ * Adds top-layer Escape and outside-pointer dismissal behavior.
+ *
+ * @param options - The layer state, boundaries, and dismissal callbacks.
+ */
+export declare function useDismissableLayer(options: DismissableLayerOptions): void;
+export {};

package/dist/components/Portal/hooks/useFloatingPosition.d.ts

@@ -0,0 +1,12 @@
+import { type FloatingPlacement, type FloatingPosition } from "../utils/floating-position";
+/**
+ * Keeps anchored floating content aligned and inside its viewport.
+ *
+ * @param active - Whether positioning observers should remain active.
+ * @param placement - The preferred floating placement.
+ * @param trigger - The element anchoring the floating panel.
+ * @param panel - The mounted floating panel.
+ *
+ * @returns The current fixed-position coordinates and resolved placement.
+ */
+export declare function useFloatingPosition(active: boolean, placement: FloatingPlacement, trigger: HTMLElement | null, panel: HTMLElement | null): FloatingPosition | null;

package/dist/components/Portal/hooks/useFocusTrap.d.ts

@@ -0,0 +1,24 @@
+import { type RefObject } from "react";
+import type { FocusScopeContextValue } from "../contexts/FocusScopeContext";
+/** A type representing options accepted by the focus trap hook. */
+type FocusTrapOptions = {
+    /** Whether focus containment currently applies. */
+    active: boolean;
+    /** Whether focus moves inside the trap when it activates. */
+    autoFocus?: boolean;
+    /** The element containing focus while the trap is active. */
+    container: HTMLElement | null;
+    /** The optional preferred element focused when the trap opens. */
+    initialFocusReference?: RefObject<HTMLElement | null>;
+    /** The stable overlay stack identifier for the trapped layer. */
+    layerId: symbol;
+    /** Whether focus returns to its prior owner when the trap closes. */
+    restoreFocus?: boolean;
+};
+/**
+ * Traps focus within the topmost overlay and optionally restores its origin.
+ *
+ * @param options - The focus container, stack identity, and focus behavior.
+ */
+export declare function useFocusTrap(options: FocusTrapOptions): FocusScopeContextValue;
+export {};

package/dist/components/Portal/hooks/usePresence.d.ts

@@ -0,0 +1,19 @@
+/** A type representing the visual phase of transition presence. */
+export type PresenceState = "closed" | "closing" | "open";
+/** A type representing a transition presence result. */
+type Presence = {
+    /** Whether the transitioning content remains mounted. */
+    present: boolean;
+    /** The visual phase exposed to component styles. */
+    state: PresenceState;
+};
+/**
+ * Keeps closing content mounted for its exit transition.
+ *
+ * @param open - Whether the content should be visibly open.
+ * @param exitDuration - The maximum exit transition duration in milliseconds.
+ *
+ * @returns The current mount and visual transition state.
+ */
+export declare function usePresence(open: boolean, exitDuration?: number): Presence;
+export {};

package/dist/components/Portal/hooks/useScrollLock.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Locks document scrolling while compensating for the removed scrollbar.
+ *
+ * @param active - Whether the lock should currently apply.
+ * @param ownerDocument - The document whose body scrolling is controlled.
+ */
+export declare function useScrollLock(active: boolean, ownerDocument: Document | null): void;

package/dist/components/Portal/utils/floating-position.d.ts

@@ -0,0 +1,26 @@
+/** A type representing a side available to anchored floating content. */
+export type FloatingPlacement = "bottom" | "left" | "right" | "top";
+/** A type representing the measured position of anchored floating content. */
+export type FloatingPosition = {
+    /** The cross-axis offset at which the arrow points to the trigger. */
+    arrowOffset: number;
+    /** The resolved placement after viewport collision handling. */
+    placement: FloatingPlacement;
+    /** The viewport-relative horizontal position. */
+    left: number;
+    /** The viewport-relative vertical position. */
+    top: number;
+};
+/**
+ * Calculates collision-aware floating coordinates within a viewport.
+ *
+ * @param placement - The preferred floating placement.
+ * @param spacing - The minimum distance from triggers and viewport edges.
+ * @param triggerBounds - The viewport bounds of the anchoring trigger.
+ * @param panelBounds - The measured bounds of the floating panel.
+ * @param viewportWidth - The available viewport width.
+ * @param viewportHeight - The available viewport height.
+ *
+ * @returns The fitted coordinates and resolved floating placement.
+ */
+export declare function calculateFloatingPosition(placement: FloatingPlacement, spacing: number, triggerBounds: DOMRect, panelBounds: DOMRect, viewportWidth: number, viewportHeight: number): FloatingPosition;