@equinor/stratus-ui 1.1.0 → 1.3.0

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

@@ -0,0 +1,253 @@
+import { type ChangeEvent, type CSSProperties, type FocusEvent, type InputHTMLAttributes, type ReactElement, type ReactNode, type RefObject, type TextareaHTMLAttributes } from "react";
+import type { CSSProps } from "../../utils/cssProps";
+import type { CSSVars } from "../../utils/cssVars";
+import "./Input.css";
+export type InputVariant = "default" | "success" | "warning" | "error" | "naked";
+type InputVars = "--stratus-input-bg" | "--stratus-input-border" | "--stratus-input-outline-w" | "--stratus-primary" | "--stratus-success" | "--stratus-warning" | "--stratus-error" | "--stratus-text-primary" | "--stratus-text-secondary" | "--stratus-text-disabled";
+type InputStyle = CSSVars<InputVars>;
+export type InputProps = {
+    /** Custom content rendered inside the wrapper (replaces the input). */
+    children?: ReactNode;
+    /** Extra CSS class name on the root element. */
+    className?: string;
+    /** Inline style + CSS variable overrides on the root element. */
+    style?: InputStyle;
+    /**
+     * Ref forwarded to the native `<input>` / `<textarea>`.
+     * @default undefined
+     */
+    inputRef?: RefObject<HTMLInputElement | null>;
+    /**
+     * Additional HTML attributes spread on the native `<input>` / `<textarea>`.
+     * @default {}
+     */
+    inputProps?: InputHTMLAttributes<HTMLInputElement> & TextareaHTMLAttributes<HTMLTextAreaElement>;
+    /**
+     * The HTML `type` attribute for the input.
+     * @default "text"
+     */
+    type?: string;
+    /**
+     * Visual variant.
+     * @default "default"
+     */
+    variant?: InputVariant;
+    /**
+     * Label placed above the input (top-left).
+     * @default undefined
+     */
+    label?: ReactNode;
+    /**
+     * Meta text placed above the input (top-right).
+     * @default undefined
+     */
+    meta?: ReactNode;
+    /**
+     * Helper text placed below the input.
+     * @default undefined
+     */
+    helperText?: ReactNode;
+    /**
+     * Icon placed before the helper text.
+     * @default undefined
+     */
+    helperIcon?: ReactNode;
+    /**
+     * The controlled value.
+     * @default undefined
+     */
+    value?: string | number;
+    /**
+     * The default (uncontrolled) value.
+     * @default undefined
+     */
+    defaultValue?: string | number;
+    /**
+     * Placeholder text.
+     * @default undefined
+     */
+    placeholder?: string;
+    /**
+     * Content rendered at the start of the input wrapper (e.g. icon).
+     * @default undefined
+     */
+    startAdornment?: ReactElement;
+    /**
+     * Content rendered at the end of the input wrapper (e.g. icon).
+     * @default undefined
+     */
+    endAdornment?: ReactElement;
+    /**
+     * Custom outline width override (CSS value).
+     * @default undefined
+     */
+    outlineWidth?: string;
+    /**
+     * If `true`, renders a `<textarea>` instead of `<input>`.
+     * @default false
+     */
+    multiple?: boolean;
+    /**
+     * Compact height (24 px min-height instead of 36 px).
+     * @default false
+     */
+    compact?: boolean;
+    /**
+     * If `true`, the input takes the full width of its container.
+     * @default false
+     */
+    fullWidth?: boolean;
+    /**
+     * If `true`, the input wrapper keeps its focus outline at all times.
+     * @default false
+     */
+    forceFocus?: boolean;
+    /**
+     * If `true`, the input is disabled.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Callback fired when the value changes.
+     * Passes `(value, event)` — matching the opt-ui-core API.
+     * @default undefined
+     */
+    onChange?: (value: string, event: ChangeEvent<HTMLInputElement | HTMLTextAreaElement>) => void;
+    /**
+     * Callback fired when the input receives focus.
+     * @default undefined
+     */
+    onFocus?: (value: string, event: FocusEvent<HTMLInputElement | HTMLTextAreaElement>) => void;
+    /**
+     * Callback fired when the input loses focus.
+     * @default undefined
+     */
+    onBlur?: (value: string, event: FocusEvent<HTMLInputElement | HTMLTextAreaElement>) => void;
+} & CSSProps;
+/**
+ * @example
+ * ```tsx
+ * <Input label="Email" placeholder="you@example.com" variant="default" />
+ * ```
+ */
+export declare const Input: import("react").ForwardRefExoticComponent<{
+    /** Custom content rendered inside the wrapper (replaces the input). */
+    children?: ReactNode;
+    /** Extra CSS class name on the root element. */
+    className?: string;
+    /** Inline style + CSS variable overrides on the root element. */
+    style?: InputStyle;
+    /**
+     * Ref forwarded to the native `<input>` / `<textarea>`.
+     * @default undefined
+     */
+    inputRef?: RefObject<HTMLInputElement | null>;
+    /**
+     * Additional HTML attributes spread on the native `<input>` / `<textarea>`.
+     * @default {}
+     */
+    inputProps?: InputHTMLAttributes<HTMLInputElement> & TextareaHTMLAttributes<HTMLTextAreaElement>;
+    /**
+     * The HTML `type` attribute for the input.
+     * @default "text"
+     */
+    type?: string;
+    /**
+     * Visual variant.
+     * @default "default"
+     */
+    variant?: InputVariant;
+    /**
+     * Label placed above the input (top-left).
+     * @default undefined
+     */
+    label?: ReactNode;
+    /**
+     * Meta text placed above the input (top-right).
+     * @default undefined
+     */
+    meta?: ReactNode;
+    /**
+     * Helper text placed below the input.
+     * @default undefined
+     */
+    helperText?: ReactNode;
+    /**
+     * Icon placed before the helper text.
+     * @default undefined
+     */
+    helperIcon?: ReactNode;
+    /**
+     * The controlled value.
+     * @default undefined
+     */
+    value?: string | number;
+    /**
+     * The default (uncontrolled) value.
+     * @default undefined
+     */
+    defaultValue?: string | number;
+    /**
+     * Placeholder text.
+     * @default undefined
+     */
+    placeholder?: string;
+    /**
+     * Content rendered at the start of the input wrapper (e.g. icon).
+     * @default undefined
+     */
+    startAdornment?: ReactElement;
+    /**
+     * Content rendered at the end of the input wrapper (e.g. icon).
+     * @default undefined
+     */
+    endAdornment?: ReactElement;
+    /**
+     * Custom outline width override (CSS value).
+     * @default undefined
+     */
+    outlineWidth?: string;
+    /**
+     * If `true`, renders a `<textarea>` instead of `<input>`.
+     * @default false
+     */
+    multiple?: boolean;
+    /**
+     * Compact height (24 px min-height instead of 36 px).
+     * @default false
+     */
+    compact?: boolean;
+    /**
+     * If `true`, the input takes the full width of its container.
+     * @default false
+     */
+    fullWidth?: boolean;
+    /**
+     * If `true`, the input wrapper keeps its focus outline at all times.
+     * @default false
+     */
+    forceFocus?: boolean;
+    /**
+     * If `true`, the input is disabled.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Callback fired when the value changes.
+     * Passes `(value, event)` — matching the opt-ui-core API.
+     * @default undefined
+     */
+    onChange?: (value: string, event: ChangeEvent<HTMLInputElement | HTMLTextAreaElement>) => void;
+    /**
+     * Callback fired when the input receives focus.
+     * @default undefined
+     */
+    onFocus?: (value: string, event: FocusEvent<HTMLInputElement | HTMLTextAreaElement>) => void;
+    /**
+     * Callback fired when the input loses focus.
+     * @default undefined
+     */
+    onBlur?: (value: string, event: FocusEvent<HTMLInputElement | HTMLTextAreaElement>) => void;
+} & Partial<CSSProperties> & import("../../utils/cssProps").CSSShorthandProps & import("react").RefAttributes<HTMLDivElement>>;
+export {};
+//# sourceMappingURL=Input.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Input.d.ts","sourceRoot":"","sources":["../../../../src/components/Input/Input.tsx"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,8 @@
+import type { ReactNode } from "react";
+interface InputHelperProps {
+    helperText?: ReactNode;
+    helperIcon?: ReactNode;
+}
+export declare function InputHelper({ helperText, helperIcon }: InputHelperProps): import("react").JSX.Element | null;
+export {};
+//# sourceMappingURL=InputHelper.d.ts.map

package/dist/types/components/Input/InputHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InputHelper.d.ts","sourceRoot":"","sources":["../../../../src/components/Input/InputHelper.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,UAAU,gBAAgB;IACxB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,UAAU,CAAC,EAAE,SAAS,CAAC;CACxB;AAED,wBAAgB,WAAW,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,gBAAgB,sCAWvE"}

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

@@ -0,0 +1,9 @@
+import type { ReactNode } from "react";
+interface InputLabelRowProps {
+    label?: ReactNode;
+    meta?: ReactNode;
+    htmlFor: string;
+}
+export declare function InputLabelRow({ label, meta, htmlFor }: InputLabelRowProps): import("react").JSX.Element | null;
+export {};
+//# sourceMappingURL=InputLabelRow.d.ts.map

package/dist/types/components/Input/InputLabelRow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InputLabelRow.d.ts","sourceRoot":"","sources":["../../../../src/components/Input/InputLabelRow.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,UAAU,kBAAkB;IAC1B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,kBAAkB,sCAazE"}

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

@@ -0,0 +1,36 @@
+import { type ElementType } from "react";
+import type { CSSProps } from "../../utils/cssProps";
+import type { CSSVars } from "../../utils/cssVars";
+import { type PolymorphicProps } from "../../utils/polymorphic";
+import "./Link.css";
+export type LinkColor = "default" | "primary" | "secondary" | "success" | "warning" | "danger" | "disabled";
+type LinkVars = "--stratus-primary" | "--stratus-secondary" | "--stratus-success" | "--stratus-warning" | "--stratus-error" | "--stratus-text-primary" | "--stratus-text-disabled";
+type LinkStyle = CSSVars<LinkVars>;
+export type LinkOwnProps = {
+    /** Extra CSS class name. */
+    className?: string;
+    /** Inline style + CSS variable overrides */
+    style?: LinkStyle;
+    /**
+     * Link color. A named token or any CSS color / hex string.
+     * @default undefined (falls back to primary teal from CSS)
+     */
+    color?: LinkColor | (string & {});
+    /**
+     * Controls when the link has an underline.
+     * @default "hover"
+     */
+    underline?: "none" | "always" | "hover";
+} & CSSProps;
+export type LinkProps<C extends ElementType = "a"> = PolymorphicProps<C, LinkOwnProps>;
+/**
+ * @example
+ * ```tsx
+ * <Link href="https://example.com" color="primary">
+ *   Go to example
+ * </Link>
+ * ```
+ */
+export declare const Link: import("../../utils/polymorphic").PolymorphicComponent<LinkOwnProps, "a">;
+export {};
+//# sourceMappingURL=Link.d.ts.map

package/dist/types/components/Link/Link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Link.d.ts","sourceRoot":"","sources":["../../../../src/components/Link/Link.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,OAAO,CAAC;AAE7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAEL,KAAK,gBAAgB,EAEtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,YAAY,CAAC;AAMpB,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,SAAS,GACT,WAAW,GACX,SAAS,GACT,SAAS,GACT,QAAQ,GACR,UAAU,CAAC;AAEf,KAAK,QAAQ,GACT,mBAAmB,GACnB,qBAAqB,GACrB,mBAAmB,GACnB,mBAAmB,GACnB,iBAAiB,GACjB,wBAAwB,GACxB,yBAAyB,CAAC;AAE9B,KAAK,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEnC,MAAM,MAAM,YAAY,GAAG;IACzB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAClC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;CACzC,GAAG,QAAQ,CAAC;AAEb,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,WAAW,GAAG,GAAG,IAAI,gBAAgB,CACnE,CAAC,EACD,YAAY,CACb,CAAC;AAoBF;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,2EA4DhB,CAAC"}

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

@@ -0,0 +1,133 @@
+import { type ElementType, type ReactNode, type SyntheticEvent } from "react";
+import type { CSSProps } from "../../utils/cssProps";
+import type { CSSVars } from "../../utils/cssVars";
+import type { PolymorphicProps } from "../../utils/polymorphic";
+import "./Menu.css";
+export type MenuMode = "vertical" | "horizontal" | "inline";
+export type SubMenuTriggers = "click" | "hover";
+export interface MenuEvent {
+    menuItemId: string;
+    selected: boolean;
+    selectedIds: string[];
+    open: boolean;
+    openIds: string[];
+}
+export interface MenuItemEvent {
+    id: string;
+    label: ReactNode;
+}
+export interface SubMenuEvent {
+    id: string;
+    label: ReactNode;
+    level?: number;
+}
+export type MenuVars = "--stratus-menu-item-hover" | "--stratus-menu-item-selected" | "--stratus-divider" | "--stratus-focus-ring" | "--stratus-surface";
+export type MenuStyle = CSSVars<MenuVars>;
+export interface MenuContextValue {
+    mode: MenuMode;
+    compact: boolean;
+    disabled: boolean;
+    selectable: boolean;
+    selectedIds: string[];
+    openIds: string[];
+    level: number;
+    triggersSubMenu: SubMenuTriggers | SubMenuTriggers[];
+    isSelected: (id: string) => boolean;
+    isOpen: (id: string) => boolean;
+    toggleSelect: (id: string, e: SyntheticEvent, label: ReactNode) => void;
+    toggleOpen: (id: string, e: SyntheticEvent, label: ReactNode) => void;
+    onClick?: (menuEvent: MenuEvent, event: SyntheticEvent) => void;
+}
+export declare function useMenuCtx(): MenuContextValue | null;
+type MenuOwnProps = {
+    /** Menu children (`MenuItem`, `SubMenu`, `MenuDivider`). */
+    children?: ReactNode;
+    /** Extra CSS class name. */
+    className?: string;
+    /** Inline style + CSS variable overrides */
+    style?: MenuStyle;
+    /**
+     * Layout mode.
+     * @default "vertical"
+     */
+    mode?: MenuMode;
+    /**
+     * Collapse inline sub-menus.
+     * @default false
+     */
+    inlineCollapsed?: boolean;
+    /**
+     * Allow multiple items to be selected simultaneously.
+     * @default false
+     */
+    multiple?: boolean;
+    /**
+     * Enable selection behaviour.
+     * @default true
+     */
+    selectable?: boolean;
+    /**
+     * Currently selected item IDs (controlled).
+     * @default []
+     */
+    selectedIds?: string[];
+    /**
+     * Currently open sub-menu IDs (controlled).
+     * @default []
+     */
+    openIds?: string[];
+    /**
+     * How sub-menus are triggered.
+     * @default "click"
+     */
+    triggersSubMenu?: SubMenuTriggers | SubMenuTriggers[];
+    /**
+     * Use compact styling (32 px height vs 48 px).
+     * @default false
+     */
+    compact?: boolean;
+    /**
+     * Disable all items.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Fired when any item is clicked.
+     */
+    onClick?: (menuEvent: MenuEvent, event: SyntheticEvent) => void;
+    /**
+     * Fired when an item becomes selected.
+     */
+    onSelect?: (menuEvent: MenuEvent, event: SyntheticEvent) => void;
+    /**
+     * Fired when an item is deselected.
+     */
+    onDeselect?: (menuEvent: MenuEvent, event: SyntheticEvent) => void;
+    /**
+     * Fired when a sub-menu opens.
+     */
+    onOpen?: (menuEvent: MenuEvent, event: SyntheticEvent) => void;
+    /**
+     * Fired when a sub-menu closes.
+     */
+    onClose?: (menuEvent: MenuEvent, event: SyntheticEvent) => void;
+} & CSSProps;
+export type MenuProps<T extends ElementType = "ul"> = PolymorphicProps<T, MenuOwnProps>;
+/**
+ * Manages selection and open state for `MenuItem`, `SubMenu`, and
+ * `MenuDivider` children. Supports vertical, horizontal, and inline modes.
+ *
+ * @example
+ * ```tsx
+ * <Menu selectedIds={["item-1"]} selectable>
+ *   <MenuItem id="item-1">First</MenuItem>
+ *   <MenuDivider />
+ *   <MenuItem id="item-2">Second</MenuItem>
+ * </Menu>
+ * ```
+ */
+export declare const Menu: import("../../utils/polymorphic").PolymorphicComponent<MenuOwnProps, "ul">;
+export { MenuDivider, type MenuDividerProps } from "./MenuDivider";
+export { MenuItem, type MenuItemProps } from "./MenuItem";
+export { MenuSubMenu, SubMenu, type SubMenuProps } from "./SubMenu";
+//# sourceMappingURL=Menu.d.ts.map

package/dist/types/components/Menu/Menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Menu.d.ts","sourceRoot":"","sources":["../../../../src/components/Menu/Menu.tsx"],"names":[],"mappings":"AAAA,OAAO,EAMH,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,cAAc,EACtB,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,yBAAyB,CAAC;AAEhF,OAAO,YAAY,CAAC;AAMpB,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,YAAY,GAAG,QAAQ,CAAC;AAE5D,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,OAAO,CAAC;AAEhD,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD,MAAM,MAAM,QAAQ,GAChB,2BAA2B,GAC3B,8BAA8B,GAC9B,mBAAmB,GACnB,sBAAsB,GACtB,mBAAmB,CAAC;AAExB,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;AAM1C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,eAAe,GAAG,eAAe,EAAE,CAAC;IACrD,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IACpC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IAChC,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACxE,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACtE,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CACjE;AAID,wBAAgB,UAAU,4BAEzB;AAMD,KAAK,YAAY,GAAG;IAClB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;OAGG;IACH,eAAe,CAAC,EAAE,eAAe,GAAG,eAAe,EAAE,CAAC;IACtD;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAChE;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IACjE;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IACnE;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAC/D;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CACjE,GAAG,QAAQ,CAAC;AAEb,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,WAAW,GAAG,IAAI,IAAI,gBAAgB,CACpE,CAAC,EACD,YAAY,CACb,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,IAAI,4EAmLhB,CAAC;AAMF,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/dist/types/components/Menu/MenuDivider.d.ts

@@ -0,0 +1,26 @@
+import { type HTMLAttributes } from "react";
+import { type MenuStyle } from "./Menu";
+export interface MenuDividerProps extends Omit<HTMLAttributes<HTMLHRElement>, "color" | "style"> {
+    /** Extra CSS class name. */
+    className?: string;
+    /** Inline style overrides. */
+    style?: MenuStyle;
+    /**
+     * Override the auto-detected orientation.
+     * By default: horizontal in a vertical menu, vertical in a horizontal menu.
+     */
+    orientation?: "horizontal" | "vertical";
+    /**
+     * Divider line colour.
+     */
+    color?: string;
+    /**
+     * Divider thickness in px.
+     */
+    size?: number;
+}
+/**
+ * A visual separator between `MenuItem`s.
+ */
+export declare const MenuDivider: import("react").ForwardRefExoticComponent<MenuDividerProps & import("react").RefAttributes<HTMLHRElement>>;
+//# sourceMappingURL=MenuDivider.d.ts.map

package/dist/types/components/Menu/MenuDivider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MenuDivider.d.ts","sourceRoot":"","sources":["../../../../src/components/Menu/MenuDivider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAGH,KAAK,cAAc,EACtB,MAAM,OAAO,CAAC;AAGf,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AAEpD,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAC5C,cAAc,CAAC,aAAa,CAAC,EAC7B,OAAO,GAAG,OAAO,CAClB;IACC,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;OAGG;IACH,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;IACxC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,4GAoDvB,CAAC"}

package/dist/types/components/Menu/MenuItem.d.ts

@@ -0,0 +1,46 @@
+import { type ElementType, type ReactNode, type SyntheticEvent } from "react";
+import type { CSSProps } from "../../utils/cssProps";
+import type { PolymorphicProps } from "../../utils/polymorphic";
+import { type MenuItemEvent, type MenuStyle } from "./Menu";
+type MenuItemOwnProps = {
+    /** MenuItem content (label text or elements). */
+    children?: ReactNode;
+    /** Extra CSS class name. */
+    className?: string;
+    /** Inline style + CSS variable overrides */
+    style?: MenuStyle;
+    /**
+     * Unique item identifier. Auto-generated if not provided.
+     * Used for selection / event callbacks.
+     */
+    id?: string;
+    /**
+     * Content rendered before the label.
+     */
+    startAdornment?: ReactNode;
+    /**
+     * Content rendered after the label.
+     */
+    endAdornment?: ReactNode;
+    /**
+     * Disable this item.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * When `false`, the item has no hover/active interactions.
+     * @default true
+     */
+    clickable?: boolean;
+    /**
+     * Fired when this item is clicked. Receives `MenuItemEvent`.
+     */
+    onClick?: (menuItemEvent: MenuItemEvent, event: SyntheticEvent) => void;
+} & CSSProps;
+export type MenuItemProps<T extends ElementType = "li"> = PolymorphicProps<T, MenuItemOwnProps>;
+/**
+ * A single item inside a `Menu`.
+ */
+export declare const MenuItem: import("../../utils/polymorphic").PolymorphicComponent<MenuItemOwnProps, "li">;
+export {};
+//# sourceMappingURL=MenuItem.d.ts.map

package/dist/types/components/Menu/MenuItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MenuItem.d.ts","sourceRoot":"","sources":["../../../../src/components/Menu/MenuItem.tsx"],"names":[],"mappings":"AAAA,OAAO,EAGH,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,cAAc,EACtB,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,yBAAyB,CAAC;AAGhF,OAAO,EAA8B,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExF,KAAK,gBAAgB,GAAG;IACtB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B;;OAEG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,aAAa,EAAE,aAAa,EAAE,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CACzE,GAAG,QAAQ,CAAC;AAEb,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,WAAW,GAAG,IAAI,IAAI,gBAAgB,CACxE,CAAC,EACD,gBAAgB,CACjB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,gFA8GpB,CAAC"}

package/dist/types/components/Menu/SubMenu.d.ts

@@ -0,0 +1,45 @@
+import { type LiHTMLAttributes, type ReactNode, type SyntheticEvent } from "react";
+import { type MenuStyle, type SubMenuEvent } from "./Menu";
+export interface SubMenuProps extends Omit<LiHTMLAttributes<HTMLLIElement>, "title" | "onClick" | "style"> {
+    /** Sub-menu trigger label. */
+    title: ReactNode;
+    /** Sub-menu children (nested `MenuItem`, etc.). */
+    children?: ReactNode;
+    /** Extra CSS class name. */
+    className?: string;
+    /** Inline style overrides. */
+    style?: MenuStyle;
+    /**
+     * Unique sub-menu identifier. Auto-generated if not provided.
+     */
+    id?: string;
+    /**
+     * Content rendered before the title.
+     */
+    startAdornment?: ReactNode;
+    /**
+     * Show the arrow indicator.
+     * @default true
+     */
+    arrow?: boolean;
+    /**
+     * Disable this sub-menu.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Fired when the sub-menu trigger is clicked.
+     */
+    onClick?: (subMenuEvent: SubMenuEvent, event: SyntheticEvent) => void;
+}
+/**
+ * A collapsible/flyout sub-menu inside a `Menu`.
+ *
+ * In `"inline"` mode the children collapse/expand below the trigger.
+ * In `"vertical"` / `"horizontal"` modes the children appear in a
+ * positioned flyout.
+ */
+export declare const SubMenu: import("react").ForwardRefExoticComponent<SubMenuProps & import("react").RefAttributes<HTMLLIElement>>;
+/** Alias for backwards compatibility with `@equinor/opt-ui-core`. */
+export declare const MenuSubMenu: import("react").ForwardRefExoticComponent<SubMenuProps & import("react").RefAttributes<HTMLLIElement>>;
+//# sourceMappingURL=SubMenu.d.ts.map

package/dist/types/components/Menu/SubMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubMenu.d.ts","sourceRoot":"","sources":["../../../../src/components/Menu/SubMenu.tsx"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,OAAO,CAAC;AAKf,OAAO,EAAc,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC;AAWvE,MAAM,WAAW,YAAa,SAAQ,IAAI,CACxC,gBAAgB,CAAC,aAAa,CAAC,EAC/B,OAAO,GAAG,SAAS,GAAG,OAAO,CAC9B;IACC,8BAA8B;IAC9B,KAAK,EAAE,SAAS,CAAC;IACjB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CACvE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,wGAkNnB,CAAC;AAIF,qEAAqE;AACrE,eAAO,MAAM,WAAW,wGAAU,CAAC"}