@konstructio/ui 0.1.2-alpha.12 → 0.1.2-alpha.121

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

@@ -0,0 +1,145 @@
+import { VariantProps } from 'class-variance-authority';
+import { CSSProperties, FC, PropsWithChildren } from 'react';
+import { ClassNames as DrawerClassNames } from '../Drawer/Drawer.types';
+import { Theme } from '../../domain/theme';
+import { SidebarMode } from './contexts';
+import { SidebarModeProp } from './hooks/useSidebarMode';
+import { wrapperSiderbarVariants } from './Sidebar.variants';
+import { CollapseTriggerProps, FooterProps, LabelProps, LogoProps, NavigationGroupProps, NavigationOptionProps, NavigationProps, NavigationSeparatorProps } from './components';
+/**
+ * Props for the Sidebar component.
+ * A compound component for building application sidebars with navigation.
+ *
+ * @example
+ * ```tsx
+ * <Sidebar canResize minWith={200} maxWith={400}>
+ *   <Sidebar.Logo>
+ *     <img src="/logo.svg" alt="Logo" />
+ *   </Sidebar.Logo>
+ *   <Sidebar.Navigation>
+ *     <Sidebar.NavigationGroup label="Main">
+ *       <Sidebar.NavigationOption href="/dashboard" icon={<Home />}>
+ *         Dashboard
+ *       </Sidebar.NavigationOption>
+ *       <Sidebar.NavigationOption href="/settings" icon={<Settings />}>
+ *         Settings
+ *       </Sidebar.NavigationOption>
+ *     </Sidebar.NavigationGroup>
+ *   </Sidebar.Navigation>
+ *   <Sidebar.Footer>v1.0.0</Sidebar.Footer>
+ * </Sidebar>
+ * ```
+ */
+export interface Props extends Omit<VariantProps<typeof wrapperSiderbarVariants>, 'mode'>, PropsWithChildren {
+    /** Whether the sidebar can be resized by dragging (only in expanded mode) */
+    canResize?: boolean;
+    /** Additional CSS classes for the divider */
+    dividerClassName?: string;
+    /**
+     * Viewport width in pixels below which the sidebar switches to `drawer` mode in `auto` mode (defaults to 640).
+     */
+    drawerBreakpoint?: number;
+    /**
+     * Maximum width in pixels for the drawer panel in `drawer` mode (defaults to 280).
+     * The drawer width is `min(viewport, drawerMaxWidth)`, so on viewports narrower than
+     * the cap it shrinks to fit instead of overflowing.
+     */
+    drawerMaxWidth?: number;
+    /**
+     * Viewport width in pixels at or above which the sidebar switches to `expanded` mode in `auto` mode (defaults to 1024).
+     */
+    expandedBreakpoint?: number;
+    /**
+     * When true, animates the hover-expand width transition with `motion`. Only takes effect
+     * together with `expandOnHover`. Defaults to `true`.
+     */
+    animateOnHover?: boolean;
+    /**
+     * When true and the sidebar is in `collapsed` mode, hovering a navigation option
+     * expands only that option (animated width) to reveal its label. The expanded
+     * option overlays content to its right and does not push siblings. Defaults to `true`.
+     */
+    expandOnHover?: boolean;
+    /** Initial width in pixels when entering expanded mode (defaults to 256, clamped to [minWith, maxWith]) */
+    initialWidth?: number;
+    /** Maximum width when resizing in pixels (defaults to 300) */
+    maxWith?: number;
+    /** Minimum width when resizing in pixels (defaults to 240) */
+    minWith?: number;
+    /** Additional CSS classes for the auto-injected separator between groups in collapsed mode */
+    separatorClassName?: string;
+    /** Additional CSS classes for the hamburger trigger button rendered in drawer mode */
+    triggerClassName?: string;
+    /** Accessible label for the mobile navigation trigger */
+    openNavigationLabel?: string;
+    /**
+     * In `collapsed` mode, expanding through the CollapseTrigger floats the
+     * expanded sidebar over the page behind a scrim instead of pushing the
+     * content. Tapping the scrim, pressing Escape or choosing a destination
+     * collapses it again. The `<aside>` carries `data-overlay` while floating.
+     */
+    expandAsOverlay?: boolean;
+    /** Additional CSS classes for the scrim rendered behind the floating sidebar */
+    overlayClassName?: string;
+    /**
+     * Per-slot class overrides for the underlying `Drawer` rendered in
+     * `drawer` mode. Mirrors `Drawer`'s `classNames` shape: `root`, `overlay`,
+     * `panel`, `closeButton`, `content`, `header`, `body`, `footer`,
+     * `resizeHandle`. Useful for tweaking the close-button position, removing
+     * the panel's horizontal padding so dividers can span edge-to-edge,
+     * raising the root `z-index` past higher-z layers, etc.
+     *
+     * The Sidebar already applies sensible defaults internally (root `z-60`,
+     * panel uses `wrapperClassName`, content `gap-0`); user-provided classes
+     * are appended via `cn`, so they win on conflicts.
+     */
+    drawerClassNames?: DrawerClassNames;
+    /**
+     * Controls the responsive mode of the sidebar.
+     * - `auto` (default): derives the mode from the viewport width
+     *   (`>=1024px` expanded, `640-1023px` collapsed, `<640px` drawer).
+     * - `expanded`, `collapsed`, `drawer`: force a specific mode
+     *   (useful for testing, stories, or manual control).
+     */
+    mode?: SidebarModeProp;
+    /**
+     * SSR / first-paint hint for `auto` mode. `useMediaQuery` cannot run on
+     * the server, so the resolved mode flickers from the desktop default to
+     * the actual viewport-derived mode after hydration. Pass the last-known
+     * mode (e.g. read from a cookie written by a prior client visit) to
+     * make the SSR markup match the actual viewport on subsequent loads.
+     * Ignored when `mode` is anything other than `auto`.
+     */
+    initialMode?: Exclude<SidebarModeProp, 'auto'>;
+    /** Theme override for this component */
+    theme?: Theme;
+    /** Additional CSS classes for the wrapper */
+    wrapperClassName?: string;
+    /**
+     * Inline styles applied to the wrapper `<aside>` (or the drawer panel in
+     * drawer mode). Useful for setting CSS custom properties that drive
+     * theming via the protection stylesheet (e.g.
+     * `--konstruct-sidebar-logo-padding-expanded`), since inline styles
+     * outrank un-layered utilities shipped by federated remote
+     * micro-frontends.
+     */
+    style?: CSSProperties;
+    /** Fired when the effective mode changes, because the user toggled it or the viewport crossed a breakpoint */
+    onModeChange?: (mode: SidebarMode, source: SidebarModeChangeSource) => void;
+}
+export type SidebarModeChangeSource = 'user' | 'viewport';
+/** @deprecated Use Props instead */
+export type SidebarProps = Props;
+/**
+ * Sidebar compound component type with sub-components.
+ */
+export type SidebarChildrenProps = {
+    CollapseTrigger: FC<CollapseTriggerProps>;
+    Footer: FC<FooterProps>;
+    Label: FC<LabelProps>;
+    Logo: FC<LogoProps>;
+    Navigation: FC<NavigationProps>;
+    NavigationGroup: FC<NavigationGroupProps>;
+    NavigationOption: FC<NavigationOptionProps>;
+    NavigationSeparator: FC<NavigationSeparatorProps>;
+};

package/dist/lib/components/Sidebar/Sidebar.variants.d.ts

@@ -0,0 +1,4 @@
+export declare const wrapperSiderbarVariants: (props?: ({
+    mode?: "expanded" | "collapsed" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export declare const dragVariants: (props?: import('class-variance-authority/types').ClassProp | undefined) => string;

package/dist/lib/components/Sidebar/components/CollapseTrigger/CollapseTrigger.d.ts

@@ -0,0 +1,4 @@
+import { FC } from 'react';
+import { Props } from './CollapseTrigger.types';
+declare const CollapseTrigger: FC<Props>;
+export { CollapseTrigger };

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

@@ -0,0 +1,6 @@
+export interface Props {
+    className?: string;
+    /** Fired after the sidebar toggles, with the mode it switched to */
+    onToggle?: (mode: 'collapsed' | 'expanded') => void;
+}
+export type CollapseTriggerProps = Props;

package/dist/lib/components/Sidebar/components/CollapseTrigger/CollapseTrigger.variants.d.ts

@@ -0,0 +1 @@
+export declare const collapseTriggerVariants: (props?: import('class-variance-authority/types').ClassProp | undefined) => string;

package/dist/lib/components/Sidebar/components/Footer/Footer.d.ts

@@ -0,0 +1,4 @@
+import { FC } from 'react';
+import { Props } from './Footer.types';
+declare const Footer: FC<Props>;
+export { Footer };

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

@@ -0,0 +1,8 @@
+import { VariantProps } from 'class-variance-authority';
+import { PropsWithChildren } from 'react';
+import { footerVariants } from './Footer.variants';
+export interface Props extends PropsWithChildren, VariantProps<typeof footerVariants> {
+    className?: string;
+}
+/** @deprecated Use Props instead */
+export type FooterProps = Props;

package/dist/lib/components/Sidebar/components/Footer/Footer.variants.d.ts

@@ -0,0 +1 @@
+export declare const footerVariants: (props?: import('class-variance-authority/types').ClassProp | undefined) => string;

package/dist/lib/components/Sidebar/components/HamburgerTrigger/HamburgerTrigger.d.ts

@@ -0,0 +1,4 @@
+import { FC } from 'react';
+import { Props } from './HamburgerTrigger.types';
+declare const HamburgerTrigger: FC<Props>;
+export { HamburgerTrigger };

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

@@ -0,0 +1,9 @@
+export interface Props {
+    isOpen: boolean;
+    /** Accessible label for the navigation trigger */
+    openNavigationLabel?: string;
+    onClick: VoidFunction;
+    className?: string;
+}
+/** @deprecated Use Props instead */
+export type HamburgerTriggerProps = Props;

package/dist/lib/components/Sidebar/components/HamburgerTrigger/HamburgerTrigger.variants.d.ts

@@ -0,0 +1 @@
+export declare const hamburgerTriggerVariants: (props?: import('class-variance-authority/types').ClassProp | undefined) => string;

package/dist/lib/components/Sidebar/components/Label/Label.d.ts

@@ -0,0 +1,4 @@
+import { FC } from 'react';
+import { Props } from './Label.types';
+declare const Label: FC<Props>;
+export { Label };

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

@@ -0,0 +1,9 @@
+import { VariantProps } from 'class-variance-authority';
+import { PropsWithChildren } from 'react';
+import { typographyVariants } from '../../../Typography/Typography.variants';
+export interface Props extends PropsWithChildren {
+    className?: string;
+    variant?: VariantProps<typeof typographyVariants>['variant'];
+}
+/** @deprecated Use Props instead */
+export type LabelProps = Props;

package/dist/lib/components/Sidebar/components/Logo/Logo.d.ts

@@ -0,0 +1,4 @@
+import { FC } from 'react';
+import { Props } from './Logo.types';
+declare const Logo: FC<Props>;
+export { Logo };

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

@@ -0,0 +1,16 @@
+import { VariantProps } from 'class-variance-authority';
+import { PropsWithChildren } from 'react';
+import { logoVariants } from './Logo.variants';
+export interface Props extends PropsWithChildren, VariantProps<typeof logoVariants> {
+    className?: string;
+    /**
+     * When true, keeps the logo content visible while the sidebar is in
+     * `collapsed` mode. By default the logo content hides in collapsed mode,
+     * while a `Sidebar.CollapseTrigger` placed as a direct child of
+     * `Sidebar.Logo` stays visible so the user can still expand the sidebar.
+     * Defaults to `false`.
+     */
+    showOnCollapse?: boolean;
+}
+/** @deprecated Use Props instead */
+export type LogoProps = Props;

package/dist/lib/components/Sidebar/components/Logo/Logo.variants.d.ts

@@ -0,0 +1,3 @@
+export declare const logoVariants: (props?: ({
+    showOnCollapse?: boolean | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;

package/dist/lib/components/Sidebar/components/Navigation/Navigation.d.ts

@@ -0,0 +1,4 @@
+import { FC } from 'react';
+import { NavigationChildrenProps, Props } from './Navigation.types';
+declare const Navigation: FC<Props> & NavigationChildrenProps;
+export { Navigation };

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

@@ -0,0 +1,18 @@
+import { VariantProps } from 'class-variance-authority';
+import { FC, PropsWithChildren } from 'react';
+import { Props as NavigationGroupProps } from '../NavigationGroup/NavigationGroup.types';
+import { Props as NavigationOptionProps } from '../NavigationOption/NavigationOption.types';
+import { Props as NavigationSeparatorProps } from '../NavigationSeparator/NavigationSeparator.types';
+import { Props as NavigationTitleProps } from '../NavigationTitle/NavigationTitle.types';
+import { navigationVariants } from './Navigation.variants';
+export interface Props extends PropsWithChildren, VariantProps<typeof navigationVariants> {
+    className?: string;
+}
+/** @deprecated Use Props instead */
+export type NavigationProps = Props;
+export type NavigationChildrenProps = {
+    NavigationGroup: FC<NavigationGroupProps>;
+    NavigationOption: FC<NavigationOptionProps>;
+    NavigationSeparator: FC<NavigationSeparatorProps>;
+    NavigationTitle: FC<NavigationTitleProps>;
+};

package/dist/lib/components/Sidebar/components/Navigation/Navigation.variants.d.ts

@@ -0,0 +1 @@
+export declare const navigationVariants: (props?: import('class-variance-authority/types').ClassProp | undefined) => string;

package/dist/lib/components/Sidebar/components/NavigationGroup/NavigationGroup.d.ts

@@ -0,0 +1,4 @@
+import { FC } from 'react';
+import { Props } from './NavigationGroup.types';
+declare const NavigationGroup: FC<Props>;
+export { NavigationGroup };

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

@@ -0,0 +1,10 @@
+import { VariantProps } from 'class-variance-authority';
+import { HtmlHTMLAttributes, PropsWithChildren } from 'react';
+import { navigationGroupsVariants } from './NavigationGroup.variants';
+export interface Props extends PropsWithChildren, VariantProps<typeof navigationGroupsVariants>, Pick<HtmlHTMLAttributes<HTMLDivElement>, 'className' | 'style'> {
+    title?: string;
+    titleClassName?: string;
+    isVisible?: boolean;
+}
+/** @deprecated Use Props instead */
+export type NavigationGroupProps = Props;

package/dist/lib/components/Sidebar/components/NavigationGroup/NavigationGroup.variants.d.ts

@@ -0,0 +1 @@
+export declare const navigationGroupsVariants: (props?: import('class-variance-authority/types').ClassProp | undefined) => string;

package/dist/lib/components/Sidebar/components/NavigationOption/NavigationOption.context.d.ts

@@ -0,0 +1,18 @@
+import { ReactNode } from 'react';
+export interface NavigationOptionContextValue {
+    /**
+     * Whether this NavigationOption is rendered in hover-expandable mode
+     * (collapsed sidebar with `expandOnHover`). When true, Label children
+     * are rendered inside a portaled Radix tooltip and the inline DOM node
+     * is replaced by a visually-hidden span (preserves accessible name).
+     */
+    hasOwnTooltip: boolean;
+    /**
+     * Allows nested Label components to register their children as the
+     * content of the parent NavigationOption tooltip. Effects-only;
+     * unregister on unmount by passing `null`.
+     */
+    registerTooltipContent: (content: ReactNode) => void;
+}
+export declare const NavigationOptionContext: import('react').Context<NavigationOptionContextValue | null>;
+export declare const useNavigationOptionContext: () => NavigationOptionContextValue | null;

package/dist/lib/components/Sidebar/components/NavigationOption/NavigationOption.d.ts

@@ -0,0 +1,4 @@
+import { FC } from 'react';
+import { Props } from './NavigationOption.types';
+declare const NavigationOption: FC<Props>;
+export { NavigationOption };

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

@@ -0,0 +1,56 @@
+import { VariantProps } from 'class-variance-authority';
+import { ReactNode } from 'react';
+import { navigationOptionVariants } from './NavigationOption.variants';
+type NavigationOption = VariantProps<typeof navigationOptionVariants> & {
+    /** Content rendered at the end of the option in expanded mode, e.g. a Badge */
+    badge?: ReactNode;
+    className?: string;
+    /** Delay in ms before `onIntent` fires on hover. Defaults to 80 */
+    intentDelay?: number;
+    isVisible?: boolean;
+    isActive?: boolean;
+    /** Fired when the user shows intent to navigate: hover (debounced), focus, pointer down or touch start. Useful for prefetching */
+    onIntent?: () => void;
+    /**
+     * Whether clicking this option should close the drawer when the Sidebar
+     * is in `drawer` mode. Defaults to `true`. Has no effect in `expanded` or
+     * `collapsed` modes.
+     */
+    closeDrawerOnClick?: boolean;
+    /**
+     * Tooltip content shown on hover when the Sidebar is in `collapsed` mode
+     * with `expandOnHover` (rendered via Radix portal — escapes any overflow
+     * clipping on the consumer side). When omitted, the component falls back
+     * to the content registered by a nested `Sidebar.Label`.
+     */
+    tooltip?: ReactNode;
+    /**
+     * Tailwind classes for the tooltip background. Defaults to
+     * `bg-kubefirst-dark-blue-900`.
+     */
+    tooltipBgClassName?: string;
+    /**
+     * Tailwind classes for the tooltip arrow fill. Defaults to
+     * `fill-kubefirst-dark-blue-900`.
+     */
+    tooltipArrowClassName?: string;
+    /**
+     * Tailwind classes for the tooltip text color. Defaults to `text-white`.
+     */
+    tooltipTextClassName?: string;
+    /**
+     * Additional Tailwind classes merged into the tooltip content node.
+     */
+    tooltipClassName?: string;
+};
+export type Props = NavigationOption & ({
+    role: 'button';
+    children: ReactNode;
+    onClick: VoidFunction;
+} | {
+    role?: never;
+    children: ReactNode;
+});
+/** @deprecated Use Props instead */
+export type NavigationOptionProps = Props;
+export {};

package/dist/lib/components/Sidebar/components/NavigationOption/NavigationOption.variants.d.ts

@@ -0,0 +1,4 @@
+export declare const navigationOptionVariants: (props?: ({
+    isActive?: boolean | null | undefined;
+    hasBadge?: boolean | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;

package/dist/lib/components/Sidebar/components/NavigationSeparator/NavigationSeparator.d.ts

@@ -0,0 +1,4 @@
+import { FC } from 'react';
+import { Props } from './NavigationSeparator.types';
+declare const NavigationSeparator: FC<Props>;
+export { NavigationSeparator };

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

@@ -0,0 +1,7 @@
+import { VariantProps } from 'class-variance-authority';
+import { HTMLAttributes } from 'react';
+import { navigationSeparatorVariant } from './NavigationSeparator.variants';
+export interface Props extends Pick<HTMLAttributes<HTMLDivElement>, 'className' | 'style'>, VariantProps<typeof navigationSeparatorVariant> {
+}
+/** @deprecated Use Props instead */
+export type NavigationSeparatorProps = Props;

package/dist/lib/components/Sidebar/components/NavigationSeparator/NavigationSeparator.variants.d.ts

@@ -0,0 +1 @@
+export declare const navigationSeparatorVariant: (props?: import('class-variance-authority/types').ClassProp | undefined) => string;

package/dist/lib/components/Sidebar/components/NavigationTitle/NavigationTitle.d.ts

@@ -0,0 +1,4 @@
+import { FC } from 'react';
+import { Props } from './NavigationTitle.types';
+declare const NavigationTitle: FC<Props>;
+export { NavigationTitle };

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

@@ -0,0 +1,10 @@
+import { VariantProps } from 'class-variance-authority';
+import { HtmlHTMLAttributes } from 'react';
+import { navigationTitleVariants } from './NavigationTitle.variants';
+export interface Props extends VariantProps<typeof navigationTitleVariants>, Pick<HtmlHTMLAttributes<HTMLHeadingElement>, 'className'> {
+    title: string;
+    className?: string;
+    isVisible?: boolean;
+}
+/** @deprecated Use Props instead */
+export type NavigationTitleProps = Props;

package/dist/lib/components/Sidebar/components/NavigationTitle/NavigationTitle.variants.d.ts

@@ -0,0 +1 @@
+export declare const navigationTitleVariants: (props?: import('class-variance-authority/types').ClassProp | undefined) => string;

package/dist/lib/components/Sidebar/components/Wrapper/Wrapper.d.ts

@@ -0,0 +1,4 @@
+import { FC } from 'react';
+import { Props } from '../../Sidebar.types';
+declare const Wrapper: FC<Props>;
+export { Wrapper };

package/dist/lib/components/Sidebar/components/index.d.ts

@@ -0,0 +1,21 @@
+export * from './CollapseTrigger/CollapseTrigger';
+export type { CollapseTriggerProps } from './CollapseTrigger/CollapseTrigger.types';
+export * from './Footer/Footer';
+export type { FooterProps } from './Footer/Footer.types';
+export * from './HamburgerTrigger/HamburgerTrigger';
+export type { HamburgerTriggerProps } from './HamburgerTrigger/HamburgerTrigger.types';
+export * from './Label/Label';
+export type { LabelProps } from './Label/Label.types';
+export * from './Logo/Logo';
+export type { LogoProps } from './Logo/Logo.types';
+export * from './Navigation/Navigation';
+export type { NavigationProps, NavigationChildrenProps, } from './Navigation/Navigation.types';
+export * from './NavigationGroup/NavigationGroup';
+export type { NavigationGroupProps } from './NavigationGroup/NavigationGroup.types';
+export * from './NavigationOption/NavigationOption';
+export type { NavigationOptionProps } from './NavigationOption/NavigationOption.types';
+export * from './NavigationSeparator/NavigationSeparator';
+export type { NavigationSeparatorProps } from './NavigationSeparator/NavigationSeparator.types';
+export * from './NavigationTitle/NavigationTitle';
+export type { NavigationTitleProps } from './NavigationTitle/NavigationTitle.types';
+export * from './Wrapper/Wrapper';

package/dist/lib/components/Sidebar/contexts/SidebarContext.d.ts

@@ -0,0 +1,28 @@
+export type SidebarMode = 'expanded' | 'collapsed' | 'drawer';
+export interface SidebarContextValue {
+    mode: SidebarMode;
+    isCollapsed: boolean;
+    expandOnHover: boolean;
+    animateOnHover: boolean;
+    separatorClassName?: string;
+    /**
+     * Closes the drawer when the Sidebar is in `drawer` mode. No-op in
+     * `expanded` or `collapsed` modes. Useful for closing the drawer on
+     * navigation events (e.g. when the user clicks a link).
+     */
+    closeDrawer: () => void;
+    /**
+     * Whether the sidebar can be toggled between `expanded` and `collapsed`.
+     * `false` in `drawer` mode, where the drawer's own open/close controls
+     * apply instead.
+     */
+    canToggle: boolean;
+    /**
+     * Toggles the sidebar between `expanded` and `collapsed`, overriding the
+     * viewport-derived mode until the viewport crosses a breakpoint. No-op in
+     * `drawer` mode.
+     */
+    toggleMode: () => void;
+}
+export declare const SidebarContext: import('react').Context<SidebarContextValue>;
+export declare const useSidebarContext: () => SidebarContextValue;

package/dist/lib/components/Sidebar/contexts/index.d.ts

@@ -0,0 +1 @@
+export * from './SidebarContext';

package/dist/lib/components/Sidebar/hooks/index.d.ts

@@ -0,0 +1 @@
+export * from './useSidebarMode';

package/dist/lib/components/Sidebar/hooks/useSidebarMode.d.ts

@@ -0,0 +1,5 @@
+import { SidebarMode } from '../contexts/SidebarContext';
+export type SidebarModeProp = SidebarMode | 'auto';
+export declare const DEFAULT_EXPANDED_BREAKPOINT = 1024;
+export declare const DEFAULT_DRAWER_BREAKPOINT = 640;
+export declare const useSidebarMode: (mode?: SidebarModeProp, expandedBreakpoint?: number, drawerBreakpoint?: number, initialMode?: SidebarMode) => SidebarMode;

package/dist/lib/components/Skeleton/Skeleton.d.ts

@@ -0,0 +1,14 @@
+import { FC } from 'react';
+import { Props } from './Skeleton.types';
+/**
+ * Pulsing placeholder blocks shown while content loads.
+ *
+ * @example
+ * ```tsx
+ * <Skeleton shape="text" count={3} label="Loading activity" />
+ * <Skeleton shape="circle" />
+ * <Skeleton className="h-8 w-40" />
+ * ```
+ */
+declare const Skeleton: FC<Props>;
+export { Skeleton };

package/dist/lib/components/Skeleton/Skeleton.types.d.ts

@@ -0,0 +1,16 @@
+import { VariantProps } from 'class-variance-authority';
+import { Theme } from '../../domain/theme';
+import { skeletonVariants } from './Skeleton.variants';
+export interface Props extends VariantProps<typeof skeletonVariants> {
+    /** Additional CSS classes for each placeholder block, e.g. a width or height */
+    className?: string;
+    /** Number of placeholder blocks to render */
+    count?: number;
+    /** Accessible name announced while the content loads */
+    label?: string;
+    /** Theme override for this component */
+    theme?: Theme;
+    /** Additional CSS classes for the wrapper */
+    wrapperClassName?: string;
+}
+export type SkeletonProps = Props;

package/dist/lib/components/Skeleton/Skeleton.variants.d.ts

@@ -0,0 +1,3 @@
+export declare const skeletonVariants: (props?: ({
+    shape?: "text" | "rect" | "circle" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;

package/dist/lib/components/Slider/Slider.d.ts

@@ -0,0 +1,21 @@
+import { FC } from 'react';
+import { Props } from './Slider.types';
+/**
+ * A single-thumb slider component for selecting a value.
+ * Built on Radix UI Slider for accessibility.
+ *
+ * @example
+ * ```tsx
+ * <Slider
+ *   label="Brightness"
+ *   min={0}
+ *   max={100}
+ *   defaultValue={[75]}
+ *   showValue
+ *   name="brightness"
+ * />
+ * ```
+ *
+ * @see {@link https://konstructio.github.io/konstruct-ui/?path=/docs/components-slider--docs Storybook}
+ */
+export declare const Slider: FC<Props>;

package/dist/lib/components/Slider/Slider.types.d.ts

@@ -0,0 +1,44 @@
+import { SliderProps as SliderPropsBase } from '@radix-ui/react-slider';
+import { VariantProps } from 'class-variance-authority';
+import { Theme } from '../../domain/theme';
+import { sliderVariants } from './Slider.variants';
+/**
+ * Props for the Slider component.
+ * A single-thumb slider for selecting a single value.
+ *
+ * @example
+ * ```tsx
+ * <Slider
+ *   label="Volume"
+ *   min={0}
+ *   max={100}
+ *   defaultValue={[50]}
+ *   showValue
+ *   size="md"
+ * />
+ * ```
+ */
+export interface Props extends VariantProps<typeof sliderVariants> {
+    /** Additional CSS classes */
+    className?: string;
+    /** Initial value as single-element array */
+    defaultValue?: SliderPropsBase['defaultValue'];
+    /** Label displayed above the slider */
+    label?: string;
+    /** Additional CSS classes for the label wrapper */
+    labelWrapperClassName?: string;
+    /** Maximum value for the slider */
+    max?: SliderPropsBase['max'];
+    /** Minimum value for the slider */
+    min?: SliderPropsBase['min'];
+    /** Form field name for the hidden input */
+    name?: string;
+    /** Whether to display the current value */
+    showValue?: boolean;
+    /** Size of the slider track and thumb */
+    size?: 'sm' | 'md' | 'lg';
+    /** Theme override for this component */
+    theme?: Theme;
+}
+/** @deprecated Use Props instead */
+export type SliderProps = Props;

package/dist/lib/components/Slider/Slider.variants.d.ts

@@ -0,0 +1,7 @@
+export declare const sliderVariants: (props?: import('class-variance-authority/types').ClassProp | undefined) => string;
+export declare const trackVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export declare const thumbVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;

package/dist/lib/components/Spinner/Spinner.d.ts

@@ -0,0 +1,4 @@
+import { FC } from 'react';
+import { Props } from './Spinner.types';
+declare const Spinner: FC<Props>;
+export { Spinner };