@boreal-ui/types 0.0.9012-alpha.0

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

@@ -0,0 +1,269 @@
+import type { AriaRole, ReactNode } from "react";
+import { LabelPositionType, RoundingType, ShadowType, StateType, ThemeType } from "../../types/types";
+/**
+ * Represents a single option in the Select component.
+   * @default false
+   */
+export interface Option {
+    /** The value to be used for the option. */
+    value: string;
+    /** The display label for the option. */
+    label: string;
+    /** Whether this specific option is disabled. */
+    disabled?: boolean;
+}
+/**
+ * Props for the Select component.
+ */
+export interface SelectProps {
+    /**
+     * Theme for styling.
+     * "primary" | "secondary" | "tertiary" | "quaternary" | "clear"
+     *
+     * @default configured default theme (fallback: "primary")
+     */
+    theme?: ThemeType;
+    /**
+     * Adds translucent glass styling to the select wrapper.
+     *
+     * @default configured default glass setting (fallback: false)
+     */
+    glass?: boolean;
+    /**
+     * State variant for styling.
+     * "success" | "error" | "warning" | "disabled" | ""
+     *
+     */
+    state?: StateType;
+    /**
+     * If true, the select element is styled as outlined.
+     *
+     * @default configured default outline setting (fallback: false)
+     */
+    outline?: boolean;
+    /**
+     * An array of options that will be rendered as dropdown choices.
+     */
+    options: Option[];
+    /**
+     * The current selected value.
+     */
+    value: string;
+    /**
+     * Callback fired when the selected option changes.
+     * Receives the new value as an argument.
+     */
+    onChange: (value: string) => void;
+    /**
+     * If provided, the select element will render options asynchronously.
+     * Should return a Promise resolving to Option[] based on search query.
+     */
+    asyncOptions?: (query: string) => Promise<Option[]>;
+    /**
+     * Optional polling interval for updating options in milliseconds.
+     *
+     * @default 0
+     */
+    pollInterval?: number;
+    /**
+     * Placeholder text to display when no option is selected.
+     *
+     * @default "Select an option"
+     */
+    placeholder?: string;
+    /**
+     * Rounding style of the select element.
+     * "none" | "small" | "medium" | "large" | "full"
+     *
+     * @default configured default rounding (fallback: "medium")
+     */
+    rounding?: RoundingType;
+    /**
+     * Shadow style of the select element.
+     * "none" | "light" | "medium" | "strong" | "intense"
+     *
+     * @default configured default shadow (fallback: "light")
+     */
+    shadow?: ShadowType;
+    /** Whether the select element is required. */
+    required?: boolean;
+    /**
+     * Whether the select element is disabled.
+     *
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Name for the select element.
+     */
+    name?: string;
+    /**
+     * Optional visible label describing what the select is for.
+     */
+    label?: ReactNode;
+    /**
+     * Position of the label relative to the select.
+     *
+     * @default "top"
+     */
+    labelPosition?: LabelPositionType;
+    /**
+     * Optional id for the underlying select element.
+     */
+    id?: string;
+    /**
+     * Optional form association.
+     */
+    form?: string;
+    /**
+     * Optional autocomplete behavior for compatible use cases.
+     */
+    autoComplete?: string;
+    /**
+     * Optional aria-label for screen readers.
+     * Useful when no visible label is provided.
+     */
+    "aria-label"?: string;
+    /**
+     * Optional aria-labelledby id reference.
+     * Prefer this when an external label element exists.
+     */
+    "aria-labelledby"?: string;
+    /**
+     * Optional description text for the select element.
+     */
+    "aria-description"?: string;
+    /**
+     * Optional aria-describedby id reference for helper/error text.
+     */
+    "aria-describedby"?: string;
+    /**
+     * Marks the field as invalid for assistive technology.
+     * If omitted, component logic may still infer invalid from state === "error".
+     */
+    "aria-invalid"?: boolean;
+    /**
+     * Indicates the field is required to assistive technology.
+     */
+    "aria-required"?: boolean;
+    /**
+     * Indicates the select is busy, useful while async options are loading.
+     */
+    "aria-busy"?: boolean;
+    /**
+     * Optional aria-live setting for async status messaging.
+     *
+     * @default "polite"
+     */
+    "aria-live"?: "off" | "polite" | "assertive";
+    /**
+     * Optional role override.
+     * Usually not needed for a native select, but included for flexibility.
+     */
+    role?: AriaRole;
+    /**
+     * Optional tab index for keyboard navigation control.
+     */
+    tabIndex?: number;
+    /**
+     * Additional class name(s) for custom styling.
+     *
+     */
+    className?: string;
+    /** Additional class names for the outer layout container. */
+    layoutClassName?: string;
+    /** Additional class names for the visible label. */
+    labelClassName?: string;
+    /** Additional class names for the native select element. */
+    selectClassName?: string;
+    /** Additional class names for the dropdown icon wrapper. */
+    iconClassName?: string;
+    /** Additional class names for async loading text. */
+    loadingClassName?: string;
+    /** Additional class names for screen-reader-only description text. */
+    srOnlyClassName?: string;
+    /**
+     * Optional test ID for testing frameworks.
+     *
+     * @default dataTestId ?? "select"
+     */
+    testId?: string;
+    /** Backward-compatible alias for test ID attributes. */
+    "data-testid"?: string;
+}
+export interface BaseSelectProps extends SelectProps {
+    /**
+     * Framework-specific class name map supplied by the core or Next wrapper.
+     */
+    classMap: Record<string, string>;
+}
+export interface ThemeSelectProps {
+    /**
+     * Theme variant applied to the component.
+     */
+    theme?: ThemeType;
+    /**
+     * Whether to apply the glass visual treatment.
+     */
+    glass?: boolean;
+    /**
+     * Shadow style applied to the component.
+     */
+    shadow?: ShadowType;
+    /**
+     * Corner rounding applied to the component.
+     */
+    rounding?: RoundingType;
+    /**
+     * Visual state applied to the component.
+     */
+    state?: StateType;
+    /** Optional test ID for testing frameworks. */
+    testId?: string;
+    /** Backward-compatible alias for test ID attributes. */
+    "data-testid"?: string;
+    /**
+     * Optional accessible label for the theme select trigger/input.
+     */
+    "aria-label"?: string;
+    /**
+     * Optional description for screen readers.
+     */
+    "aria-description"?: string;
+    /**
+     * Optional labelled-by reference.
+     */
+    "aria-labelledby"?: string;
+    /**
+     * Optional described-by reference.
+     */
+    "aria-describedby"?: string;
+    /**
+     * Marks the control invalid for assistive technology.
+     */
+    "aria-invalid"?: boolean;
+    /**
+     * Marks the control required for assistive technology.
+     */
+    "aria-required"?: boolean;
+    /**
+     * Whether the component is disabled.
+     */
+    disabled?: boolean;
+    /**
+     * Visible label content for the component.
+     */
+    label?: ReactNode;
+    /**
+     * Label Position prop for ThemeSelect.
+     */
+    labelPosition?: LabelPositionType;
+    /**
+     * HTML name applied to the relevant form element.
+     */
+    name?: string;
+    /**
+     * HTML id applied to the relevant element.
+     */
+    id?: string;
+}

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

@@ -0,0 +1 @@
+{"version":3,"file":"Select.types.d.ts","sourceRoot":"","sources":["../../../../src/components/Select/Select.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,SAAS,EACT,SAAS,EACV,MAAM,eAAe,CAAC;AAEvB;;;KAGK;AACL,MAAM,WAAW,MAAM;IACrB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IAEd,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IAEd,gDAAgD;IAChD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAElC;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEpD;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;IAExB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IAEpB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB;;;;OAIG;IACH,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAElC;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;;OAIG;IACH,WAAW,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,WAAW,CAAC;IAE7C;;;OAGG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;OAEG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;;OAEG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB;;OAEG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;OAEG;IACH,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb"}

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

@@ -0,0 +1,3 @@
+import { BaseSelectProps } from "./Select.types";
+declare const BaseSelect: import("react").ForwardRefExoticComponent<BaseSelectProps & import("react").RefAttributes<HTMLSelectElement>>;
+export default BaseSelect;

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

@@ -0,0 +1 @@
+{"version":3,"file":"SelectBase.d.ts","sourceRoot":"","sources":["../../../../src/components/Select/SelectBase.tsx"],"names":[],"mappings":"AAsBA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,QAAA,MAAM,UAAU,+GAkRf,CAAC;AAGF,eAAe,UAAU,CAAC"}

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

@@ -0,0 +1,3 @@
+import { ThemeSelectProps } from "../../Select.types";
+declare const UserThemeSettings: import("react").ForwardRefExoticComponent<ThemeSelectProps & import("react").RefAttributes<HTMLSelectElement>>;
+export default UserThemeSettings;

package/dist/types/components/Select/ThemeSelect/core/ThemeSelect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeSelect.d.ts","sourceRoot":"","sources":["../../../../../../src/components/Select/ThemeSelect/core/ThemeSelect.tsx"],"names":[],"mappings":"AAQA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,QAAA,MAAM,iBAAiB,gHA2EtB,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

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

@@ -0,0 +1,3 @@
+import { ThemeSelectProps } from "../../Select.types";
+declare const UserThemeSettings: import("react").ForwardRefExoticComponent<ThemeSelectProps & import("react").RefAttributes<HTMLSelectElement>>;
+export default UserThemeSettings;

package/dist/types/components/Select/ThemeSelect/next/ThemeSelect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeSelect.d.ts","sourceRoot":"","sources":["../../../../../../src/components/Select/ThemeSelect/next/ThemeSelect.tsx"],"names":[],"mappings":"AAUA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,QAAA,MAAM,iBAAiB,gHA2EtB,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

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

@@ -0,0 +1,3 @@
+import { SelectProps } from "../Select.types";
+declare const Select: import("react").ForwardRefExoticComponent<SelectProps & import("react").RefAttributes<HTMLSelectElement>>;
+export default Select;

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

@@ -0,0 +1 @@
+{"version":3,"file":"Select.d.ts","sourceRoot":"","sources":["../../../../../src/components/Select/core/Select.tsx"],"names":[],"mappings":"AAGA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AA0C9C,QAAA,MAAM,MAAM,2GAEV,CAAC;AAGH,eAAe,MAAM,CAAC"}

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

@@ -0,0 +1,3 @@
+import { SelectProps } from "../Select.types";
+declare const Select: import("react").ForwardRefExoticComponent<SelectProps & import("react").RefAttributes<HTMLSelectElement>>;
+export default Select;

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

@@ -0,0 +1 @@
+{"version":3,"file":"Select.d.ts","sourceRoot":"","sources":["../../../../../src/components/Select/next/Select.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,QAAA,MAAM,MAAM,2GAEV,CAAC;AAGH,eAAe,MAAM,CAAC"}

package/dist/types/components/Sidebar/Sidebar.helpers.d.ts

@@ -0,0 +1,4 @@
+import type { SidebarLink } from "./Sidebar.types";
+export declare const normalizePath: (path: string) => string;
+export declare const isDescendantPath: (parentPath: string, currentPath: string) => boolean;
+export declare const isActiveRecursive: (link: SidebarLink, matcher: (link: SidebarLink) => boolean) => boolean;

package/dist/types/components/Sidebar/Sidebar.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sidebar.helpers.d.ts","sourceRoot":"","sources":["../../../../src/components/Sidebar/Sidebar.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,WACwB,CAAC;AAEnE,eAAO,MAAM,gBAAgB,GAC3B,YAAY,MAAM,EAClB,aAAa,MAAM,KAClB,OAMF,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,MAAM,WAAW,EACjB,SAAS,CAAC,IAAI,EAAE,WAAW,KAAK,OAAO,KACtC,OAGF,CAAC"}

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

@@ -0,0 +1,273 @@
+import { RoundingType, ShadowType, StateType, ThemeType } from "../../types/index";
+import type { AnchorHTMLAttributes } from "react";
+export interface SidebarLink {
+    /**
+     * Display label for the link.
+     * @default "Sidebar navigation"
+     */
+    label: string;
+    /**
+     * Navigation path or URL for the link.
+     * If omitted, the link may be used as a non-clickable parent for submenu items.
+     */
+    href?: string;
+    /** Optional target attribute for the link. */
+    target?: AnchorHTMLAttributes<HTMLAnchorElement>["target"];
+    /** Optional rel attribute for the link. */
+    rel?: AnchorHTMLAttributes<HTMLAnchorElement>["rel"];
+    /**
+     * Optional child links to render as a collapsible submenu.
+     */
+    children?: SidebarLink[];
+    /**
+     * Optional icon to display next to the label.
+     */
+    icon?: React.ReactNode;
+    /**
+     * Optional accessible label override for this specific link.
+     * Useful when the visible label is abbreviated or unclear.
+     */
+    "aria-label"?: string;
+    /**
+     * Optional accessible description for this specific link.
+     * Can be used to provide extra context for screen reader users.
+     */
+    "aria-description"?: string;
+    /**
+     * Whether this item should be announced as disabled.
+     * Useful for non-interactive or temporarily unavailable items.
+     */
+    "aria-disabled"?: boolean;
+}
+export interface SidebarFooterLink {
+    /**
+     * Display label for the footer link.
+     */
+    label: string;
+    /**
+     * Navigation path or URL for the footer link.
+     */
+    href: string;
+    /** Optional target attribute for the footer link. */
+    target?: AnchorHTMLAttributes<HTMLAnchorElement>["target"];
+    /** Optional rel attribute for the footer link. */
+    rel?: AnchorHTMLAttributes<HTMLAnchorElement>["rel"];
+    /**
+     * Optional icon to display next to the label.
+     */
+    icon?: React.ReactNode;
+    /**
+     * Optional accessible label override for this footer link.
+     */
+    "aria-label"?: string;
+    /**
+     * Optional accessible description for this footer link.
+     */
+    "aria-description"?: string;
+    /**
+     * Whether this footer link should be announced as disabled.
+     */
+    "aria-disabled"?: boolean;
+}
+export interface SidebarProps {
+    /**
+     * Array of navigation links to render in the sidebar.
+     * Each link may optionally include a nested submenu.
+     */
+    links: SidebarLink[];
+    /**
+     * Whether to display a footer section at the bottom of the sidebar.
+     * Defaults to `false`.
+     *
+     * @default false
+     */
+    showFooter?: boolean;
+    /**
+     * Array of footer links to render when `showFooter` is `true`.
+     */
+    footerLinks?: SidebarFooterLink[];
+    /**
+     * Optional version string displayed in the sidebar footer.
+     * Example: "v1.2.3"
+     */
+    footerVersion?: string;
+    /**
+     * Theme for styling.
+     * Determines the base color scheme for the sidebar.
+     * - "primary" | "secondary" | "tertiary" | "quaternary" | "clear"
+     *
+     * @default configured default theme (fallback: "primary")
+     */
+    theme?: ThemeType;
+    /**
+     * If true, applies a translucent glass surface using the selected theme/state.
+     * Defaults to `false`.
+     *
+     * @default configured default glass setting (fallback: false)
+     */
+    glass?: boolean;
+    /**
+     * State variant for styling.
+     * Typically used to apply semantic states to the component.
+     * - "success" | "error" | "warning" | "disabled" | ""
+     *
+     */
+    state?: StateType;
+    /**
+     * If true, the sidebar is styled with an outline variant.
+     * Defaults to `false`.
+     *
+     * @default configured default outline setting (fallback: false)
+     */
+    outline?: boolean;
+    /**
+     * Rounding style for the sidebar container.
+     * - "none" | "small" | "medium" | "large" | "full"
+     *
+     * @default configured default rounding (fallback: "medium")
+     */
+    rounding?: RoundingType;
+    /**
+     * Shadow style for the sidebar container.
+     * - "none" | "light" | "medium" | "strong" | "intense"
+     *
+     * @default configured default shadow (fallback: "light")
+     */
+    shadow?: ShadowType;
+    /**
+     * Additional class name(s) for applying custom styles.
+     *
+     */
+    className?: string;
+    /**
+     * Additional class name for the inner navigation wrapper.
+     */
+    navClassName?: string;
+    /**
+     * Additional class name for all sidebar lists.
+     */
+    listClassName?: string;
+    /**
+     * Additional class name for nested child lists.
+     */
+    childListClassName?: string;
+    /**
+     * Additional class name for each list item.
+     */
+    itemClassName?: string;
+    /**
+     * Additional class name for link-style items.
+     */
+    linkClassName?: string;
+    /**
+     * Additional class name for child link-style items.
+     */
+    childLinkClassName?: string;
+    /**
+     * Additional class name applied when a link/item is active.
+     */
+    activeClassName?: string;
+    /**
+     * Additional class name for expandable parent buttons.
+     */
+    expandButtonClassName?: string;
+    /**
+     * Additional class name for item icons.
+     */
+    iconClassName?: string;
+    /**
+     * Additional class name for expandable item labels.
+     */
+    expandLabelClassName?: string;
+    /**
+     * Additional class name for chevron icons.
+     */
+    chevronClassName?: string;
+    /**
+     * Additional class name applied when the chevron is open.
+     */
+    chevronOpenClassName?: string;
+    /**
+     * Additional class name for submenu containers.
+     */
+    submenuClassName?: string;
+    /**
+     * Additional class name applied when a submenu is open.
+     */
+    submenuOpenClassName?: string;
+    /**
+     * Additional class name for the footer wrapper.
+     */
+    footerClassName?: string;
+    /**
+     * Additional class name for footer links.
+     */
+    footerLinkClassName?: string;
+    /**
+     * Additional class name for the footer version text.
+     */
+    footerVersionClassName?: string;
+    /**
+     * Optional test ID for testing frameworks.
+     *
+     * @default dataTestId ?? "sidebar"
+     */
+    testId?: string;
+    /** Backward-compatible alias for test ID attributes. */
+    "data-testid"?: string;
+    /**
+     * Accessible label for the navigation landmark.
+     * Prefer the kebab-case ARIA prop for consistency with other React ARIA props.
+     *
+     * @default "Sidebar navigation"
+     */
+    "aria-label"?: string;
+    /**
+     * ID reference to one or more elements that label the sidebar navigation landmark.
+     * Takes precedence over aria-label when both are provided.
+     */
+    "aria-labelledby"?: string;
+    /**
+     * ID reference to one or more elements that describe the sidebar navigation landmark.
+     */
+    "aria-describedby"?: string;
+    /**
+     * Optional label for the footer landmark when footer content is rendered.
+     * Example: "Sidebar footer links"
+     *
+     * @default "Sidebar footer"
+     */
+    footerAriaLabel?: string;
+    /**
+     * Optional ID reference to label the footer landmark.
+     */
+    footerAriaLabelledBy?: string;
+    /**
+     * Optional accessible label generator for expandable parent items.
+     * Useful when you want screen readers to hear something more descriptive
+     * than the visible text alone.
+     */
+    getExpandButtonAriaLabel?: (link: SidebarLink, isOpen: boolean) => string;
+    /**
+     * Optional accessible description generator for expandable parent items.
+     */
+    getExpandButtonAriaDescription?: (link: SidebarLink, isOpen: boolean) => string;
+    /**
+     * Optional callback used to determine whether a link should be styled as active.
+     */
+    isLinkActive?: (link: SidebarLink) => boolean;
+    /**
+     * Optional callback used to determine whether a link contains an active child.
+     */
+    hasActiveChild?: (link: SidebarLink) => boolean;
+}
+export interface BaseSidebarProps extends SidebarProps {
+    /**
+     * Framework-specific class name map supplied by the core or Next wrapper.
+     */
+    classMap: Record<string, string>;
+    /**
+     * Component implementation used to render the link portion.
+     */
+    LinkComponent?: React.ElementType;
+}

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

@@ -0,0 +1 @@
+{"version":3,"file":"Sidebar.types.d.ts","sourceRoot":"","sources":["../../../../src/components/Sidebar/Sidebar.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAElD,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,8CAA8C;IAC9C,MAAM,CAAC,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,CAAC,QAAQ,CAAC,CAAC;IAE3D,2CAA2C;IAC3C,GAAG,CAAC,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,CAAC,KAAK,CAAC,CAAC;IAErD;;OAEG;IACH,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IAEzB;;OAEG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAEvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb,qDAAqD;IACrD,MAAM,CAAC,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,CAAC,QAAQ,CAAC,CAAC;IAE3D,kDAAkD;IAClD,GAAG,CAAC,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,CAAC,KAAK,CAAC,CAAC;IAErD;;OAEG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAEvB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,KAAK,EAAE,WAAW,EAAE,CAAC;IAErB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAElC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;IAExB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IAEpB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAEhC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,KAAK,MAAM,CAAC;IAE1E;;OAEG;IACH,8BAA8B,CAAC,EAAE,CAC/B,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,OAAO,KACZ,MAAM,CAAC;IAEZ;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC;IAE9C;;OAEG;IACH,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC;CACjD;AAED,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;OAEG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC;CACnC"}

package/dist/types/components/Sidebar/SidebarBase.d.ts

@@ -0,0 +1,4 @@
+import React from "react";
+import { BaseSidebarProps } from "./Sidebar.types";
+declare const SidebarBase: React.FC<BaseSidebarProps>;
+export default SidebarBase;

package/dist/types/components/Sidebar/SidebarBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SidebarBase.d.ts","sourceRoot":"","sources":["../../../../src/components/Sidebar/SidebarBase.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA+C,MAAM,OAAO,CAAC;AAWpE,OAAO,EAAE,gBAAgB,EAAe,MAAM,iBAAiB,CAAC;AAEhE,QAAA,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAqX3C,CAAC;AAIF,eAAe,WAAW,CAAC"}

package/dist/types/components/Sidebar/core/Sidebar.d.ts

@@ -0,0 +1,4 @@
+import React from "react";
+import { SidebarProps } from "../Sidebar.types";
+declare const Sidebar: React.FC<SidebarProps>;
+export default Sidebar;

package/dist/types/components/Sidebar/core/Sidebar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sidebar.d.ts","sourceRoot":"","sources":["../../../../../src/components/Sidebar/core/Sidebar.tsx"],"names":[],"mappings":"AACA,OAAO,KAAmB,MAAM,OAAO,CAAC;AAExC,OAAO,gBAAgB,CAAC;AACxB,OAAO,EAAe,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA0D7D,QAAA,MAAM,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CAmCnC,CAAC;AAGF,eAAe,OAAO,CAAC"}

package/dist/types/components/Sidebar/next/Sidebar.d.ts

@@ -0,0 +1,4 @@
+import React from "react";
+import { SidebarProps } from "../Sidebar.types";
+declare const Sidebar: React.FC<SidebarProps>;
+export default Sidebar;

package/dist/types/components/Sidebar/next/Sidebar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sidebar.d.ts","sourceRoot":"","sources":["../../../../../src/components/Sidebar/next/Sidebar.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,OAAO,EAAe,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAO7D,QAAA,MAAM,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CAsCnC,CAAC;AAGF,eAAe,OAAO,CAAC"}