@vireocodedev/ui 0.2.0 → 0.2.1

package/dist/capabilities/infinite-canvas/components/overlays/VireoInfiniteCanvasOverlay/VireoInfiniteCanvasOverlay.js

@@ -0,0 +1,41 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { joinClassNames, mergeSx, resolveSlotProps } from "../../../../../core/public.js";
+import { unstable_composeClasses as composeClasses } from "@mui/material";
+import { useThemeProps } from "@mui/material/styles";
+import { useForkRef } from "@mui/material/utils";
+import React from "react";
+import { getVireoInfiniteCanvasOverlayUtilityClass, } from "./VireoInfiniteCanvasOverlay.classes.js";
+import { VIREO_INFINITE_CANVAS_OVERLAY_NAME, } from "./VireoInfiniteCanvasOverlay.identity.js";
+import { VireoInfiniteCanvasOverlayContent, VireoInfiniteCanvasOverlayRoot } from "./VireoInfiniteCanvasOverlay.styled.js";
+function getPositionSx(position, offset) {
+    return {
+        "top-left": { top: offset, left: offset },
+        top: { top: offset, left: "50%", transform: "translateX(-50%)" },
+        "top-right": { top: offset, right: offset },
+        right: { top: "50%", right: offset, transform: "translateY(-50%)" },
+        "bottom-right": { bottom: offset, right: offset },
+        bottom: { bottom: offset, left: "50%", transform: "translateX(-50%)" },
+        "bottom-left": { bottom: offset, left: offset },
+        left: { top: "50%", left: offset, transform: "translateY(-50%)" },
+    }[position];
+}
+function useUtilityClasses(classes) {
+    return composeClasses({ root: ["root"], content: ["content"] }, getVireoInfiniteCanvasOverlayUtilityClass, classes);
+}
+/** Pins interactive controls above the canvas without applying the world transform. */
+export const VireoInfiniteCanvasOverlay = React.forwardRef(function VireoInfiniteCanvasOverlay(inProps, forwardedRef) {
+    const props = useThemeProps({ props: inProps, name: VIREO_INFINITE_CANVAS_OVERLAY_NAME });
+    const { children, className, classes: classesProp, offset = 16, position = "top-right", slotProps = {}, slots = {}, style, sx, ...other } = props;
+    const ownerState = { position };
+    const classes = useUtilityClasses(classesProp);
+    const root = resolveSlotProps(slotProps.root, ownerState);
+    const content = resolveSlotProps(slotProps.content, ownerState);
+    const ref = useForkRef(forwardedRef, root.ref);
+    const Content = slots.content ?? VireoInfiniteCanvasOverlayContent;
+    const anchored = getPositionSx(position, offset);
+    return (_jsx(VireoInfiniteCanvasOverlayRoot, { ...other, ...root, as: slots.root ?? "div", ref: ref, ownerState: ownerState, className: joinClassNames(classes.root, className, root.className), style: { ...style, ...root.style }, sx: mergeSx(sx, root.sx), children: _jsx(Content, { ...content, ownerState: ownerState, className: joinClassNames(classes.content, content.className), sx: mergeSx(anchored, content.sx), onPointerDown: (event) => {
+                event.stopPropagation();
+                content.onPointerDown?.(event);
+            }, children: children }) }));
+});
+VireoInfiniteCanvasOverlay.displayName = VIREO_INFINITE_CANVAS_OVERLAY_NAME;

package/dist/capabilities/infinite-canvas/components/overlays/VireoInfiniteCanvasOverlay/VireoInfiniteCanvasOverlay.styled.d.ts

@@ -0,0 +1,5 @@
+import { type StyledSlotComponent } from "../../../../../core/public.js";
+import { type BoxProps } from "@mui/material";
+import type { VireoInfiniteCanvasOverlayOwnerState } from "./VireoInfiniteCanvasOverlay.types.js";
+export declare const VireoInfiniteCanvasOverlayRoot: StyledSlotComponent<BoxProps, VireoInfiniteCanvasOverlayOwnerState>;
+export declare const VireoInfiniteCanvasOverlayContent: StyledSlotComponent<BoxProps, VireoInfiniteCanvasOverlayOwnerState>;

package/dist/capabilities/infinite-canvas/components/overlays/VireoInfiniteCanvasOverlay/VireoInfiniteCanvasOverlay.styled.js

@@ -0,0 +1,13 @@
+import { Box } from "@mui/material";
+import { styled } from "@mui/material/styles";
+import { VIREO_INFINITE_CANVAS_OVERLAY_NAME } from "./VireoInfiniteCanvasOverlay.identity.js";
+export const VireoInfiniteCanvasOverlayRoot = styled(Box, { name: VIREO_INFINITE_CANVAS_OVERLAY_NAME, slot: "Root", overridesResolver: (_p, s) => s.root })({
+    inset: 0,
+    pointerEvents: "none",
+    position: "absolute",
+});
+export const VireoInfiniteCanvasOverlayContent = styled(Box, {
+    name: VIREO_INFINITE_CANVAS_OVERLAY_NAME,
+    slot: "Content",
+    overridesResolver: (_p, s) => s.content,
+})({ pointerEvents: "auto", position: "absolute" });

package/dist/capabilities/infinite-canvas/components/overlays/VireoInfiniteCanvasOverlay/VireoInfiniteCanvasOverlay.types.d.ts

@@ -0,0 +1,36 @@
+import type { VireoInfiniteCanvasOverlayPosition } from "../../../../../capabilities/infinite-canvas/types/infiniteCanvas.types.js";
+import type { VireoDataAttributeValue, VireoThemeComponent } from "../../../../../core/public.js";
+import type { BoxProps } from "@mui/material";
+import type { CreateSlotsAndSlotProps, SlotProps } from "@mui/material/utils";
+import type React from "react";
+import type { VireoInfiniteCanvasOverlayClasses, VireoInfiniteCanvasOverlayClassKey } from "./VireoInfiniteCanvasOverlay.classes.js";
+import type { VIREO_INFINITE_CANVAS_OVERLAY_NAME, VireoInfiniteCanvasOverlaySlotName } from "./VireoInfiniteCanvasOverlay.identity.js";
+export type VireoInfiniteCanvasOverlayOwnerState = {
+    position: VireoInfiniteCanvasOverlayPosition;
+};
+export interface VireoInfiniteCanvasOverlayRootSlotPropsOverrides {
+    [key: `data-${string}`]: VireoDataAttributeValue;
+}
+export interface VireoInfiniteCanvasOverlayContentSlotPropsOverrides {
+    [key: `data-${string}`]: VireoDataAttributeValue;
+}
+export type VireoInfiniteCanvasOverlaySlots = {
+    [TSlotName in VireoInfiniteCanvasOverlaySlotName]: React.ElementType;
+};
+export type VireoInfiniteCanvasOverlaySlotsAndSlotProps = CreateSlotsAndSlotProps<VireoInfiniteCanvasOverlaySlots, {
+    root: SlotProps<"div", VireoInfiniteCanvasOverlayRootSlotPropsOverrides, VireoInfiniteCanvasOverlayOwnerState>;
+    content: SlotProps<"div", VireoInfiniteCanvasOverlayContentSlotPropsOverrides, VireoInfiniteCanvasOverlayOwnerState>;
+}>;
+export type VireoInfiniteCanvasOverlayOwnProps = VireoInfiniteCanvasOverlaySlotsAndSlotProps & {
+    children: React.ReactNode;
+    position?: VireoInfiniteCanvasOverlayPosition;
+    offset?: number;
+    classes?: Partial<VireoInfiniteCanvasOverlayClasses>;
+};
+export type VireoInfiniteCanvasOverlayInheritedProps = Omit<BoxProps<"div">, "children" | "component" | "position">;
+export type VireoInfiniteCanvasOverlayProps = VireoInfiniteCanvasOverlayOwnProps & VireoInfiniteCanvasOverlayInheritedProps;
+declare module "@mui/material/styles" {
+    interface Components<Theme = unknown> {
+        [VIREO_INFINITE_CANVAS_OVERLAY_NAME]?: VireoThemeComponent<VireoInfiniteCanvasOverlayProps, VireoInfiniteCanvasOverlayClassKey, VireoInfiniteCanvasOverlayOwnerState, Theme>;
+    }
+}

package/dist/capabilities/infinite-canvas/components/overlays/VireoInfiniteCanvasOverlay/VireoInfiniteCanvasOverlay.types.js

@@ -0,0 +1 @@
+export {};

package/dist/capabilities/infinite-canvas/components/overlays/VireoInfiniteCanvasOverlay/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./VireoInfiniteCanvasOverlay.js";
+export * from "./VireoInfiniteCanvasOverlay.classes.js";
+export * from "./VireoInfiniteCanvasOverlay.types.js";

package/dist/capabilities/infinite-canvas/components/overlays/VireoInfiniteCanvasOverlay/index.js

@@ -0,0 +1,3 @@
+export * from "./VireoInfiniteCanvasOverlay.js";
+export * from "./VireoInfiniteCanvasOverlay.classes.js";
+export * from "./VireoInfiniteCanvasOverlay.types.js";

package/dist/capabilities/infinite-canvas/contexts/VireoInfiniteCanvasContext/VireoInfiniteCanvasContext.d.ts

@@ -0,0 +1,21 @@
+import type { VireoCanvasPoint, VireoCanvasTransform } from "../../../../capabilities/infinite-canvas/types/infiniteCanvas.types.js";
+import React from "react";
+export type VireoInfiniteCanvasContextValue = {
+    transform: VireoCanvasTransform;
+    scale: number;
+    pan: VireoCanvasPoint;
+    minScale: number;
+    maxScale: number;
+    target: HTMLDivElement | null;
+    clientToWorld: (point: VireoCanvasPoint) => VireoCanvasPoint;
+    worldToClient: (point: VireoCanvasPoint) => VireoCanvasPoint;
+    getViewportCenterWorld: () => VireoCanvasPoint;
+    setTransform: (transform: VireoCanvasTransform) => void;
+    resetTransform: () => void;
+    zoomIn: () => void;
+    zoomOut: () => void;
+    isFullscreen: boolean;
+    isFullscreenSupported: boolean;
+    toggleFullscreen: () => Promise<void>;
+};
+export declare const VireoInfiniteCanvasContext: React.Context<VireoInfiniteCanvasContextValue | null>;

package/dist/capabilities/infinite-canvas/contexts/VireoInfiniteCanvasContext/VireoInfiniteCanvasContext.js

@@ -0,0 +1,2 @@
+import React from "react";
+export const VireoInfiniteCanvasContext = React.createContext(null);

package/dist/capabilities/infinite-canvas/hooks/useVireoInfiniteCanvas/useVireoInfiniteCanvas.d.ts

@@ -0,0 +1,2 @@
+/** Accesses transform state and coordinate/fullscreen actions for the nearest VireoInfiniteCanvas. */
+export declare function useVireoInfiniteCanvas(): import("../../../../capabilities/infinite-canvas/contexts/VireoInfiniteCanvasContext/VireoInfiniteCanvasContext.js").VireoInfiniteCanvasContextValue;

package/dist/capabilities/infinite-canvas/hooks/useVireoInfiniteCanvas/useVireoInfiniteCanvas.js

@@ -0,0 +1,9 @@
+import { VireoInfiniteCanvasContext } from "../../../../capabilities/infinite-canvas/contexts/VireoInfiniteCanvasContext/VireoInfiniteCanvasContext.js";
+import React from "react";
+/** Accesses transform state and coordinate/fullscreen actions for the nearest VireoInfiniteCanvas. */
+export function useVireoInfiniteCanvas() {
+    const context = React.useContext(VireoInfiniteCanvasContext);
+    if (!context)
+        throw new Error("useVireoInfiniteCanvas must be used within VireoInfiniteCanvas");
+    return context;
+}

package/dist/capabilities/infinite-canvas/public.d.ts

@@ -0,0 +1,7 @@
+export * from "./components/layout/VireoInfiniteCanvas/index.js";
+export * from "./components/layout/VireoInfiniteCanvasBody/index.js";
+export * from "./components/overlays/VireoInfiniteCanvasOverlay/index.js";
+export type { VireoInfiniteCanvasContextValue } from "./contexts/VireoInfiniteCanvasContext/VireoInfiniteCanvasContext.js";
+export * from "./hooks/useVireoInfiniteCanvas/useVireoInfiniteCanvas.js";
+export type * from "./types/infiniteCanvas.types.js";
+export * from "./utils/infiniteCanvas.utils.js";

package/dist/capabilities/infinite-canvas/public.js

@@ -0,0 +1,5 @@
+export * from "./components/layout/VireoInfiniteCanvas/index.js";
+export * from "./components/layout/VireoInfiniteCanvasBody/index.js";
+export * from "./components/overlays/VireoInfiniteCanvasOverlay/index.js";
+export * from "./hooks/useVireoInfiniteCanvas/useVireoInfiniteCanvas.js";
+export * from "./utils/infiniteCanvas.utils.js";

package/dist/capabilities/infinite-canvas/types/infiniteCanvas.types.d.ts

@@ -0,0 +1,9 @@
+export type VireoCanvasPoint = {
+    x: number;
+    y: number;
+};
+export type VireoCanvasTransform = {
+    scale: number;
+    pan: VireoCanvasPoint;
+};
+export type VireoInfiniteCanvasOverlayPosition = "top-left" | "top" | "top-right" | "right" | "bottom-right" | "bottom" | "bottom-left" | "left";

package/dist/capabilities/infinite-canvas/types/infiniteCanvas.types.js

@@ -0,0 +1 @@
+export {};

package/dist/capabilities/infinite-canvas/utils/infiniteCanvas.utils.d.ts

@@ -0,0 +1,4 @@
+import type { VireoCanvasPoint, VireoCanvasTransform } from "../../../capabilities/infinite-canvas/types/infiniteCanvas.types.js";
+export declare function clampCanvasScale(scale: number, minScale: number, maxScale: number): number;
+export declare function normalizeCanvasTransform(transform: VireoCanvasTransform, minScale: number, maxScale: number): VireoCanvasTransform;
+export declare function zoomCanvasAtPoint(transform: VireoCanvasTransform, scale: number, point: VireoCanvasPoint): VireoCanvasTransform;

package/dist/capabilities/infinite-canvas/utils/infiniteCanvas.utils.js

@@ -0,0 +1,13 @@
+export function clampCanvasScale(scale, minScale, maxScale) {
+    return Math.max(minScale, Math.min(maxScale, scale));
+}
+export function normalizeCanvasTransform(transform, minScale, maxScale) {
+    return { scale: clampCanvasScale(transform.scale, minScale, maxScale), pan: transform.pan };
+}
+export function zoomCanvasAtPoint(transform, scale, point) {
+    const ratio = scale / transform.scale;
+    return {
+        scale,
+        pan: { x: point.x - ratio * (point.x - transform.pan.x), y: point.y - ratio * (point.y - transform.pan.y) },
+    };
+}

package/dist/capabilities/overlays/components/overlays/VireoBottomDrawer/VireoBottomDrawer.classes.d.ts

@@ -0,0 +1,9 @@
+import { type VireoBottomDrawerSlotName } from "./VireoBottomDrawer.identity.js";
+/** Utility classes available to VireoBottomDrawer. */
+export type VireoBottomDrawerClasses = Record<VireoBottomDrawerSlotName, string>;
+/** Valid keys for VireoBottomDrawer utility classes and theme style overrides. */
+export type VireoBottomDrawerClassKey = keyof VireoBottomDrawerClasses;
+/** Returns the generated utility class name for a VireoBottomDrawer slot or state. */
+export declare function getVireoBottomDrawerUtilityClass(slot: string): string;
+/** Generated utility class names keyed by each public VireoBottomDrawer class key. */
+export declare const vireoBottomDrawerClasses: VireoBottomDrawerClasses;

package/dist/capabilities/overlays/components/overlays/VireoBottomDrawer/VireoBottomDrawer.classes.js

@@ -0,0 +1,10 @@
+import { generateUtilityClass, generateUtilityClasses } from "@mui/material";
+import { VIREO_BOTTOM_DRAWER_NAME, VIREO_BOTTOM_DRAWER_SLOTS, } from "./VireoBottomDrawer.identity.js";
+/** Returns the generated utility class name for a VireoBottomDrawer slot or state. */
+export function getVireoBottomDrawerUtilityClass(slot) {
+    return generateUtilityClass(VIREO_BOTTOM_DRAWER_NAME, slot);
+}
+/** Generated utility class names keyed by each public VireoBottomDrawer class key. */
+export const vireoBottomDrawerClasses = generateUtilityClasses(VIREO_BOTTOM_DRAWER_NAME, [
+    ...VIREO_BOTTOM_DRAWER_SLOTS,
+]);

package/dist/capabilities/overlays/components/overlays/VireoBottomDrawer/VireoBottomDrawer.d.ts

@@ -0,0 +1,4 @@
+import React from "react";
+import { type VireoBottomDrawerProps } from "./VireoBottomDrawer.types.js";
+/** Renders the standard swipeable Vireo bottom-sheet surface and grab handle. */
+export declare const VireoBottomDrawer: React.ForwardRefExoticComponent<Omit<VireoBottomDrawerProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/capabilities/overlays/components/overlays/VireoBottomDrawer/VireoBottomDrawer.identity.d.ts

@@ -0,0 +1,6 @@
+/** Stable component name shared by every VireoBottomDrawer integration point. */
+export declare const VIREO_BOTTOM_DRAWER_NAME = "VireoBottomDrawer";
+/** Canonical public slots exposed by VireoBottomDrawer, in rendered DOM order. */
+export declare const VIREO_BOTTOM_DRAWER_SLOTS: readonly ["root", "puller"];
+/** Public slot names exposed by VireoBottomDrawer. */
+export type VireoBottomDrawerSlotName = (typeof VIREO_BOTTOM_DRAWER_SLOTS)[number];

package/dist/capabilities/overlays/components/overlays/VireoBottomDrawer/VireoBottomDrawer.identity.js

@@ -0,0 +1,4 @@
+/** Stable component name shared by every VireoBottomDrawer integration point. */
+export const VIREO_BOTTOM_DRAWER_NAME = "VireoBottomDrawer";
+/** Canonical public slots exposed by VireoBottomDrawer, in rendered DOM order. */
+export const VIREO_BOTTOM_DRAWER_SLOTS = ["root", "puller"];

package/dist/capabilities/overlays/components/overlays/VireoBottomDrawer/VireoBottomDrawer.js

@@ -0,0 +1,60 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { joinClassNames, mergeSx, resolveSlotProps } from "../../../../../core/public.js";
+import { unstable_composeClasses as composeClasses } from "@mui/material";
+import { useThemeProps } from "@mui/material/styles";
+import { useForkRef } from "@mui/material/utils";
+import React from "react";
+import { getVireoBottomDrawerUtilityClass } from "./VireoBottomDrawer.classes.js";
+import { VIREO_BOTTOM_DRAWER_NAME } from "./VireoBottomDrawer.identity.js";
+import { VireoBottomDrawerPuller, VireoBottomDrawerRoot } from "./VireoBottomDrawer.styled.js";
+const IS_IOS = typeof navigator !== "undefined" && /iPad|iPhone|iPod/.test(navigator.userAgent);
+function useUtilityClasses(ownerState, classes) {
+    return composeClasses({
+        root: ["root"],
+        puller: ["puller"],
+    }, getVireoBottomDrawerUtilityClass, classes);
+}
+/** Renders the standard swipeable Vireo bottom-sheet surface and grab handle. */
+export const VireoBottomDrawer = React.forwardRef(function VireoBottomDrawer(inProps, forwardedRef) {
+    const props = useThemeProps({ props: inProps, name: VIREO_BOTTOM_DRAWER_NAME });
+    const { children, className, classes: classesProp, height, keepMounted = false, maxHeight, onClose, onExited, onOpen, open, slotProps = {}, slots = {}, style, sx, useBackdrop = true, ...other } = props;
+    const ownerState = {
+        open,
+        hasFixedHeight: height !== undefined,
+        keepMounted,
+        useBackdrop,
+    };
+    const classes = useUtilityClasses(ownerState, classesProp);
+    const resolvedRootSlotProps = resolveSlotProps(slotProps.root, ownerState);
+    const resolvedPullerSlotProps = resolveSlotProps(slotProps.puller, ownerState);
+    const { className: rootSlotClassName, onClose: rootSlotOnClose, onOpen: rootSlotOnOpen, ref: rootSlotRef, style: rootSlotStyle, sx: rootSlotSx, ...rootSlotOther } = resolvedRootSlotProps;
+    const rootRef = useForkRef(forwardedRef, rootSlotRef);
+    const { className: pullerSlotClassName, ...pullerSlotOther } = resolvedPullerSlotProps;
+    const handleClose = React.useCallback(event => {
+        if (event)
+            rootSlotOnClose?.(event);
+        if (!event?.defaultPrevented)
+            onClose();
+    }, [onClose, rootSlotOnClose]);
+    const handleOpen = React.useCallback(event => {
+        if (event)
+            rootSlotOnOpen?.(event);
+        if (!event?.defaultPrevented)
+            onOpen?.();
+    }, [onOpen, rootSlotOnOpen]);
+    return (_jsxs(VireoBottomDrawerRoot, { ...other, ...rootSlotOther, as: slots.root, ref: rootRef, ownerState: ownerState, className: joinClassNames(classes.root, className, rootSlotClassName), style: { ...style, ...rootSlotStyle }, sx: mergeSx(sx, rootSlotSx), anchor: "bottom", open: open, onClose: handleClose, onOpen: handleOpen, disableSwipeToOpen: true, disableBackdropTransition: !IS_IOS, disableDiscovery: IS_IOS, hideBackdrop: !useBackdrop, keepMounted: keepMounted, slotProps: {
+            paper: {
+                sx: {
+                    borderTopLeftRadius: 16,
+                    borderTopRightRadius: 16,
+                    overflow: "hidden",
+                    display: "flex",
+                    flexDirection: "column",
+                    ...(height ? { height } : {}),
+                    ...(maxHeight ? { maxHeight } : {}),
+                },
+            },
+            transition: { onExited },
+        }, children: [_jsx(VireoBottomDrawerPuller, { ...pullerSlotOther, as: slots.puller, ownerState: ownerState, className: joinClassNames(classes.puller, pullerSlotClassName), "aria-hidden": "true" }), children] }));
+});
+VireoBottomDrawer.displayName = VIREO_BOTTOM_DRAWER_NAME;

package/dist/capabilities/overlays/components/overlays/VireoBottomDrawer/VireoBottomDrawer.styled.d.ts

@@ -0,0 +1,7 @@
+import { type StyledSlotComponent } from "../../../../../core/public.js";
+import { type BoxProps, type SwipeableDrawerProps } from "@mui/material";
+import { type VireoBottomDrawerOwnerState } from "./VireoBottomDrawer.types.js";
+type VireoBottomDrawerStyledSlotComponent<TProps extends object> = StyledSlotComponent<TProps, VireoBottomDrawerOwnerState>;
+export declare const VireoBottomDrawerRoot: VireoBottomDrawerStyledSlotComponent<SwipeableDrawerProps>;
+export declare const VireoBottomDrawerPuller: VireoBottomDrawerStyledSlotComponent<BoxProps>;
+export {};

package/dist/capabilities/overlays/components/overlays/VireoBottomDrawer/VireoBottomDrawer.styled.js

@@ -0,0 +1,26 @@
+import { Box, SwipeableDrawer } from "@mui/material";
+import { styled } from "@mui/material/styles";
+import { VIREO_BOTTOM_DRAWER_NAME } from "./VireoBottomDrawer.identity.js";
+export const VireoBottomDrawerRoot = styled(SwipeableDrawer, {
+    name: VIREO_BOTTOM_DRAWER_NAME,
+    slot: "Root",
+    overridesResolver: (_props, styles) => styles.root,
+})({});
+export const VireoBottomDrawerPuller = styled(Box, {
+    name: VIREO_BOTTOM_DRAWER_NAME,
+    slot: "Puller",
+    overridesResolver: (_props, styles) => styles.puller,
+})(({ theme }) => ({
+    flexShrink: 0,
+    display: "flex",
+    justifyContent: "center",
+    paddingTop: theme.spacing(1),
+    paddingBottom: theme.spacing(0.5),
+    "&::after": {
+        content: '""',
+        width: 32,
+        height: 4,
+        borderRadius: 2,
+        backgroundColor: theme.palette.grey[300],
+    },
+}));

package/dist/capabilities/overlays/components/overlays/VireoBottomDrawer/VireoBottomDrawer.types.d.ts

@@ -0,0 +1,55 @@
+import type { VireoDataAttributeValue, VireoThemeComponent } from "../../../../../core/public.js";
+import type { Box, SwipeableDrawer, SwipeableDrawerProps } from "@mui/material";
+import type { CreateSlotsAndSlotProps, SlotProps } from "@mui/material/utils";
+import type React from "react";
+import { type VireoBottomDrawerClasses, type VireoBottomDrawerClassKey } from "./VireoBottomDrawer.classes.js";
+import type { VIREO_BOTTOM_DRAWER_NAME, VireoBottomDrawerSlotName } from "./VireoBottomDrawer.identity.js";
+export type VireoBottomDrawerOwnerState = {
+    open: boolean;
+    hasFixedHeight: boolean;
+    keepMounted: boolean;
+    useBackdrop: boolean;
+};
+export interface VireoBottomDrawerRootSlotPropsOverrides {
+    [key: `data-${string}`]: VireoDataAttributeValue;
+}
+export interface VireoBottomDrawerPullerSlotPropsOverrides {
+    [key: `data-${string}`]: VireoDataAttributeValue;
+}
+/** Replaceable semantic regions exposed by {@link VireoBottomDrawer}. */
+export type VireoBottomDrawerSlots = {
+    [TSlotName in VireoBottomDrawerSlotName]: React.ElementType;
+};
+/** Slot props exposed by {@link VireoBottomDrawer}. */
+export type VireoBottomDrawerSlotsAndSlotProps = CreateSlotsAndSlotProps<VireoBottomDrawerSlots, {
+    /** @default SwipeableDrawer */
+    root: SlotProps<typeof SwipeableDrawer, VireoBottomDrawerRootSlotPropsOverrides, VireoBottomDrawerOwnerState>;
+    /** @default Box */
+    puller: SlotProps<typeof Box, VireoBottomDrawerPullerSlotPropsOverrides, VireoBottomDrawerOwnerState>;
+}>;
+/** Props owned by {@link VireoBottomDrawer}. */
+export type VireoBottomDrawerOwnProps = VireoBottomDrawerSlotsAndSlotProps & {
+    open: boolean;
+    onClose: () => void;
+    onExited?: () => void;
+    onOpen?: () => void;
+    children: React.ReactNode;
+    /** Fixed drawer height. Prefer this or maxHeight, not both. */
+    height?: string;
+    /** Maximum height for a content-sized drawer. */
+    maxHeight?: string;
+    keepMounted?: boolean;
+    /** Whether the modal backdrop is visible. @default true */
+    useBackdrop?: boolean;
+    /** Override or extend the utility classes applied to each slot. */
+    classes?: Partial<VireoBottomDrawerClasses>;
+};
+/** Props VireoBottomDrawer inherits from its default root after excluding component-owned props. */
+export type VireoBottomDrawerInheritedProps = Omit<SwipeableDrawerProps, "anchor" | "children" | "disableBackdropTransition" | "disableDiscovery" | "disableSwipeToOpen" | "hideBackdrop" | "keepMounted" | "onClose" | "onOpen" | "open" | "slotProps">;
+/** Props accepted by {@link VireoBottomDrawer}. */
+export type VireoBottomDrawerProps = VireoBottomDrawerOwnProps & VireoBottomDrawerInheritedProps;
+declare module "@mui/material/styles" {
+    interface Components<Theme = unknown> {
+        [VIREO_BOTTOM_DRAWER_NAME]?: VireoThemeComponent<VireoBottomDrawerProps, VireoBottomDrawerClassKey, VireoBottomDrawerOwnerState, Theme>;
+    }
+}

package/dist/capabilities/overlays/components/overlays/VireoBottomDrawer/VireoBottomDrawer.types.js

@@ -0,0 +1 @@
+export {};

package/dist/capabilities/overlays/components/overlays/VireoBottomDrawer/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./VireoBottomDrawer.js";
+export * from "./VireoBottomDrawer.classes.js";
+export * from "./VireoBottomDrawer.types.js";

package/dist/capabilities/overlays/components/overlays/VireoBottomDrawer/index.js

@@ -0,0 +1,3 @@
+export * from "./VireoBottomDrawer.js";
+export * from "./VireoBottomDrawer.classes.js";
+export * from "./VireoBottomDrawer.types.js";

package/dist/capabilities/overlays/components/overlays/VireoDockedSidePanel/VireoDockedSidePanel.classes.d.ts

@@ -0,0 +1,9 @@
+import { type VireoDockedSidePanelSlotName } from "./VireoDockedSidePanel.identity.js";
+/** Utility classes available to VireoDockedSidePanel. */
+export type VireoDockedSidePanelClasses = Record<VireoDockedSidePanelSlotName, string>;
+/** Valid keys for VireoDockedSidePanel utility classes and theme style overrides. */
+export type VireoDockedSidePanelClassKey = keyof VireoDockedSidePanelClasses;
+/** Returns the generated utility class name for a VireoDockedSidePanel slot or state. */
+export declare function getVireoDockedSidePanelUtilityClass(slot: string): string;
+/** Generated utility class names keyed by each public VireoDockedSidePanel class key. */
+export declare const vireoDockedSidePanelClasses: VireoDockedSidePanelClasses;

package/dist/capabilities/overlays/components/overlays/VireoDockedSidePanel/VireoDockedSidePanel.classes.js

@@ -0,0 +1,8 @@
+import { generateUtilityClass, generateUtilityClasses } from "@mui/material";
+import { VIREO_DOCKED_SIDE_PANEL_NAME, VIREO_DOCKED_SIDE_PANEL_SLOTS, } from "./VireoDockedSidePanel.identity.js";
+/** Returns the generated utility class name for a VireoDockedSidePanel slot or state. */
+export function getVireoDockedSidePanelUtilityClass(slot) {
+    return generateUtilityClass(VIREO_DOCKED_SIDE_PANEL_NAME, slot);
+}
+/** Generated utility class names keyed by each public VireoDockedSidePanel class key. */
+export const vireoDockedSidePanelClasses = generateUtilityClasses(VIREO_DOCKED_SIDE_PANEL_NAME, [...VIREO_DOCKED_SIDE_PANEL_SLOTS]);

package/dist/capabilities/overlays/components/overlays/VireoDockedSidePanel/VireoDockedSidePanel.d.ts

@@ -0,0 +1,15 @@
+import React from "react";
+/**
+ * Renders an adjacent side-panel surface with coordinated enter and exit transitions.
+ */
+export declare const VireoDockedSidePanel: React.ForwardRefExoticComponent<import("./VireoDockedSidePanel.types.js").VireoDockedSidePanelSlotsAndSlotProps & {
+    open: boolean;
+    width: import("../../../public.js").ResponsiveOverlayFrameDesktopSidePanelWidth;
+    minWidth: number;
+    maxWidth: number;
+    isResizing?: boolean;
+    resizeHandle?: React.ReactNode;
+    onExited?: () => void;
+    children: React.ReactNode;
+    classes?: Partial<import("./VireoDockedSidePanel.classes.js").VireoDockedSidePanelClasses>;
+} & import("./VireoDockedSidePanel.types.js").VireoDockedSidePanelInheritedProps & React.RefAttributes<HTMLDivElement>>;

package/dist/capabilities/overlays/components/overlays/VireoDockedSidePanel/VireoDockedSidePanel.identity.d.ts

@@ -0,0 +1,6 @@
+/** Stable component name shared by every VireoDockedSidePanel integration point. */
+export declare const VIREO_DOCKED_SIDE_PANEL_NAME = "VireoDockedSidePanel";
+/** Canonical public slots exposed by VireoDockedSidePanel, in rendered DOM order. */
+export declare const VIREO_DOCKED_SIDE_PANEL_SLOTS: readonly ["root", "surface"];
+/** Public slot names exposed by VireoDockedSidePanel. */
+export type VireoDockedSidePanelSlotName = (typeof VIREO_DOCKED_SIDE_PANEL_SLOTS)[number];

package/dist/capabilities/overlays/components/overlays/VireoDockedSidePanel/VireoDockedSidePanel.identity.js

@@ -0,0 +1,4 @@
+/** Stable component name shared by every VireoDockedSidePanel integration point. */
+export const VIREO_DOCKED_SIDE_PANEL_NAME = "VireoDockedSidePanel";
+/** Canonical public slots exposed by VireoDockedSidePanel, in rendered DOM order. */
+export const VIREO_DOCKED_SIDE_PANEL_SLOTS = ["root", "surface"];