@vireocodedev/ui 0.2.0 → 0.2.1

package/dist/core/components/feedback/VireoLoadingRegion/VireoLoadingRegion.classes.js

@@ -0,0 +1,12 @@
+import { generateUtilityClass, generateUtilityClasses } from "@mui/material";
+import { VIREO_LOADING_REGION_NAME, VIREO_LOADING_REGION_SLOTS, } from "./VireoLoadingRegion.identity.js";
+/** Returns the generated utility class name for a VireoLoadingRegion slot or state. */
+export function getVireoLoadingRegionUtilityClass(slot) {
+    return generateUtilityClass(VIREO_LOADING_REGION_NAME, slot);
+}
+/** Generated utility class names keyed by each public VireoLoadingRegion class key. */
+export const vireoLoadingRegionClasses = generateUtilityClasses(VIREO_LOADING_REGION_NAME, [
+    ...VIREO_LOADING_REGION_SLOTS,
+    "loading",
+    "loadingVisible",
+]);

package/dist/core/components/feedback/VireoLoadingRegion/VireoLoadingRegion.d.ts

@@ -0,0 +1,4 @@
+import React from "react";
+import { type VireoLoadingRegionProps } from "./VireoLoadingRegion.types.js";
+/** Owns reveal timing, busy semantics, and one polite announcement for a loading region. */
+export declare const VireoLoadingRegion: React.ForwardRefExoticComponent<Omit<VireoLoadingRegionProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/core/components/feedback/VireoLoadingRegion/VireoLoadingRegion.identity.d.ts

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

package/dist/core/components/feedback/VireoLoadingRegion/VireoLoadingRegion.identity.js

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

package/dist/core/components/feedback/VireoLoadingRegion/VireoLoadingRegion.js

@@ -0,0 +1,52 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { joinClassNames, mergeSx, resolveSlotProps } from "../../../../core/utils/muiutils.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 { VIREO_LOADING_TOKENS } from "../../../../core/constants/loading.constants.js";
+import { getVireoLoadingRegionUtilityClass } from "./VireoLoadingRegion.classes.js";
+import { VIREO_LOADING_REGION_NAME } from "./VireoLoadingRegion.identity.js";
+import { VireoLoadingRegionRoot, VireoLoadingRegionStatus } from "./VireoLoadingRegion.styled.js";
+function useUtilityClasses(ownerState, classes) {
+    return composeClasses({
+        root: ["root", ownerState.loading && "loading", ownerState.loadingVisible && "loadingVisible"],
+        status: ["status"],
+    }, getVireoLoadingRegionUtilityClass, classes);
+}
+/** Owns reveal timing, busy semantics, and one polite announcement for a loading region. */
+export const VireoLoadingRegion = React.forwardRef(function VireoLoadingRegion(inProps, forwardedRef) {
+    const props = useThemeProps({ props: inProps, name: VIREO_LOADING_REGION_NAME });
+    const { announce = true, children, className, classes: classesProp, loading, loadingLabel, revealDelay = VIREO_LOADING_TOKENS.revealDelay, slotProps = {}, slots = {}, style, sx, ...other } = props;
+    const normalizedRevealDelay = Math.max(0, revealDelay);
+    const [delayedLoadingVisible, setDelayedLoadingVisible] = React.useState(loading && normalizedRevealDelay === 0);
+    React.useEffect(() => {
+        if (!loading) {
+            setDelayedLoadingVisible(false);
+            return undefined;
+        }
+        if (normalizedRevealDelay === 0) {
+            setDelayedLoadingVisible(true);
+            return undefined;
+        }
+        setDelayedLoadingVisible(false);
+        const timer = window.setTimeout(() => setDelayedLoadingVisible(true), normalizedRevealDelay);
+        return () => window.clearTimeout(timer);
+    }, [loading, normalizedRevealDelay]);
+    const loadingVisible = loading && delayedLoadingVisible;
+    const ownerState = {
+        announce,
+        loading,
+        loadingVisible,
+        revealDelay: normalizedRevealDelay,
+    };
+    const classes = useUtilityClasses(ownerState, classesProp);
+    const resolvedRootSlotProps = resolveSlotProps(slotProps.root, ownerState);
+    const { className: rootSlotClassName, ref: rootSlotRef, style: rootSlotStyle, sx: rootSlotSx, ...rootSlotOther } = resolvedRootSlotProps;
+    const rootRef = useForkRef(forwardedRef, rootSlotRef);
+    const resolvedStatusSlotProps = resolveSlotProps(slotProps.status, ownerState);
+    const { className: statusSlotClassName, ref: statusSlotRef, style: statusSlotStyle, sx: statusSlotSx, ...statusSlotOther } = resolvedStatusSlotProps;
+    const content = typeof children === "function" ? children({ loading, loadingVisible }) : children;
+    return (_jsxs(VireoLoadingRegionRoot, { ...other, ...rootSlotOther, as: slots.root ?? "div", ref: rootRef, ownerState: ownerState, "aria-busy": loading ? "true" : "false", "data-loading-state": loadingVisible ? "visible" : loading ? "pending" : "idle", className: joinClassNames(classes.root, className, rootSlotClassName), style: { ...style, ...rootSlotStyle }, sx: mergeSx(sx, rootSlotSx), children: [content, announce && loadingVisible ? (_jsx(VireoLoadingRegionStatus, { ...statusSlotOther, as: slots.status ?? "span", ref: statusSlotRef, ownerState: ownerState, className: joinClassNames(classes.status, statusSlotClassName), style: statusSlotStyle, sx: statusSlotSx, role: "status", "aria-live": "polite", "aria-atomic": "true", children: loadingLabel })) : null] }));
+});
+VireoLoadingRegion.displayName = VIREO_LOADING_REGION_NAME;

package/dist/core/components/feedback/VireoLoadingRegion/VireoLoadingRegion.styled.d.ts

@@ -0,0 +1,7 @@
+import { type StyledSlotComponent } from "../../../../core/utils/muiutils.js";
+import { type BoxProps } from "@mui/material";
+import { type VireoLoadingRegionOwnerState } from "./VireoLoadingRegion.types.js";
+type VireoLoadingRegionStyledSlotComponent<TProps extends object> = StyledSlotComponent<TProps, VireoLoadingRegionOwnerState>;
+export declare const VireoLoadingRegionRoot: VireoLoadingRegionStyledSlotComponent<BoxProps>;
+export declare const VireoLoadingRegionStatus: VireoLoadingRegionStyledSlotComponent<BoxProps<"span">>;
+export {};

package/dist/core/components/feedback/VireoLoadingRegion/VireoLoadingRegion.styled.js

@@ -0,0 +1,23 @@
+import { Box } from "@mui/material";
+import { styled } from "@mui/material/styles";
+import { VIREO_LOADING_REGION_NAME } from "./VireoLoadingRegion.identity.js";
+export const VireoLoadingRegionRoot = styled(Box, {
+    name: VIREO_LOADING_REGION_NAME,
+    slot: "Root",
+    overridesResolver: (_props, styles) => styles.root,
+})({ minWidth: 0 });
+export const VireoLoadingRegionStatus = styled(Box, {
+    name: VIREO_LOADING_REGION_NAME,
+    slot: "Status",
+    overridesResolver: (_props, styles) => styles.status,
+})({
+    position: "absolute",
+    width: 1,
+    height: 1,
+    padding: 0,
+    margin: -1,
+    overflow: "hidden",
+    clip: "rect(0 0 0 0)",
+    whiteSpace: "nowrap",
+    border: 0,
+});

package/dist/core/components/feedback/VireoLoadingRegion/VireoLoadingRegion.types.d.ts

@@ -0,0 +1,55 @@
+import type { VireoDataAttributeValue, VireoThemeComponent } from "../../../../core/utils/muiutils.js";
+import type { BoxProps } from "@mui/material";
+import type { CreateSlotsAndSlotProps, SlotProps } from "@mui/material/utils";
+import type React from "react";
+import { type VireoLoadingRegionClasses, type VireoLoadingRegionClassKey } from "./VireoLoadingRegion.classes.js";
+import type { VIREO_LOADING_REGION_NAME, VireoLoadingRegionSlotName } from "./VireoLoadingRegion.identity.js";
+export type VireoLoadingRegionRenderState = {
+    loading: boolean;
+    loadingVisible: boolean;
+};
+export type VireoLoadingRegionOwnerState = VireoLoadingRegionRenderState & {
+    announce: boolean;
+    revealDelay: number;
+};
+export interface VireoLoadingRegionRootSlotPropsOverrides {
+    [key: `data-${string}`]: VireoDataAttributeValue;
+}
+export interface VireoLoadingRegionStatusSlotPropsOverrides {
+    [key: `data-${string}`]: VireoDataAttributeValue;
+}
+/** Replaceable semantic regions exposed by {@link VireoLoadingRegion}. */
+export type VireoLoadingRegionSlots = {
+    [TSlotName in VireoLoadingRegionSlotName]: React.ElementType;
+};
+/** Slot props exposed by {@link VireoLoadingRegion}. */
+export type VireoLoadingRegionSlotsAndSlotProps = CreateSlotsAndSlotProps<VireoLoadingRegionSlots, {
+    /** @default 'div' */
+    root: SlotProps<"div", VireoLoadingRegionRootSlotPropsOverrides, VireoLoadingRegionOwnerState>;
+    /** @default 'span' */
+    status: SlotProps<"span", VireoLoadingRegionStatusSlotPropsOverrides, VireoLoadingRegionOwnerState>;
+}>;
+/** Props owned by {@link VireoLoadingRegion}. */
+export type VireoLoadingRegionOwnProps = VireoLoadingRegionSlotsAndSlotProps & {
+    /** Whether this boundary should announce prolonged loading. Nested visual-only regions should disable this. @default true */
+    announce?: boolean;
+    /** Stable content or a render function receiving the normalized loading state. */
+    children: React.ReactNode | ((state: VireoLoadingRegionRenderState) => React.ReactNode);
+    /** Override or extend the utility classes applied to each slot. */
+    classes?: Partial<VireoLoadingRegionClasses>;
+    /** Whether this region is waiting for content. */
+    loading: boolean;
+    /** Concise status announced after the reveal delay. */
+    loadingLabel: React.ReactNode;
+    /** Delay before visual placeholders and the status announcement become visible. */
+    revealDelay?: number;
+};
+/** Props VireoLoadingRegion inherits from its default root after excluding component-owned props. */
+export type VireoLoadingRegionInheritedProps = Omit<BoxProps<"div">, "aria-busy" | "children" | "component">;
+/** Props accepted by {@link VireoLoadingRegion}. */
+export type VireoLoadingRegionProps = VireoLoadingRegionOwnProps & VireoLoadingRegionInheritedProps;
+declare module "@mui/material/styles" {
+    interface Components<Theme = unknown> {
+        [VIREO_LOADING_REGION_NAME]?: VireoThemeComponent<VireoLoadingRegionProps, VireoLoadingRegionClassKey, VireoLoadingRegionOwnerState, Theme>;
+    }
+}

package/dist/core/components/feedback/VireoLoadingRegion/VireoLoadingRegion.types.js

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

package/dist/core/components/feedback/VireoLoadingRegion/index.d.ts

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

package/dist/core/components/feedback/VireoLoadingRegion/index.js

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

package/dist/core/components/feedback/VireoSkeleton/VireoSkeleton.classes.d.ts

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

package/dist/core/components/feedback/VireoSkeleton/VireoSkeleton.classes.js

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

package/dist/core/components/feedback/VireoSkeleton/VireoSkeleton.d.ts

@@ -0,0 +1,4 @@
+import React from "react";
+import { type VireoSkeletonProps } from "./VireoSkeleton.types.js";
+/** Silent placeholder leaf for preserving text, icon, or media geometry while content loads. */
+export declare const VireoSkeleton: React.ForwardRefExoticComponent<Omit<VireoSkeletonProps, "ref"> & React.RefAttributes<HTMLSpanElement>>;

package/dist/core/components/feedback/VireoSkeleton/VireoSkeleton.identity.d.ts

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

package/dist/core/components/feedback/VireoSkeleton/VireoSkeleton.identity.js

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

package/dist/core/components/feedback/VireoSkeleton/VireoSkeleton.js

@@ -0,0 +1,26 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { joinClassNames, mergeSx, resolveSlotProps } from "../../../../core/utils/muiutils.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 { getVireoSkeletonUtilityClass } from "./VireoSkeleton.classes.js";
+import { VIREO_SKELETON_NAME } from "./VireoSkeleton.identity.js";
+import { VireoSkeletonRoot } from "./VireoSkeleton.styled.js";
+function useUtilityClasses(_ownerState, classes) {
+    return composeClasses({
+        root: ["root"],
+    }, getVireoSkeletonUtilityClass, classes);
+}
+/** Silent placeholder leaf for preserving text, icon, or media geometry while content loads. */
+export const VireoSkeleton = React.forwardRef(function VireoSkeleton(inProps, forwardedRef) {
+    const props = useThemeProps({ props: inProps, name: VIREO_SKELETON_NAME });
+    const { children, className, classes: classesProp, slotProps = {}, slots = {}, style, sx, variant = "text", ...other } = props;
+    const ownerState = { hasChildren: children !== undefined, variant };
+    const classes = useUtilityClasses(ownerState, classesProp);
+    const resolvedRootSlotProps = resolveSlotProps(slotProps.root, ownerState);
+    const { className: rootSlotClassName, ref: rootSlotRef, style: rootSlotStyle, sx: rootSlotSx, ...rootSlotOther } = resolvedRootSlotProps;
+    const rootRef = useForkRef(forwardedRef, rootSlotRef);
+    return (_jsx(VireoSkeletonRoot, { ...other, ...rootSlotOther, as: slots.root, ref: rootRef, ownerState: ownerState, animation: false, "aria-hidden": "true", variant: variant, className: joinClassNames(classes.root, className, rootSlotClassName), style: { ...style, ...rootSlotStyle }, sx: mergeSx(sx, rootSlotSx), children: children }));
+});
+VireoSkeleton.displayName = VIREO_SKELETON_NAME;

package/dist/core/components/feedback/VireoSkeleton/VireoSkeleton.styled.d.ts

@@ -0,0 +1,6 @@
+import { type StyledSlotComponent } from "../../../../core/utils/muiutils.js";
+import { type SkeletonProps } from "@mui/material";
+import { type VireoSkeletonOwnerState } from "./VireoSkeleton.types.js";
+type VireoSkeletonStyledSlotComponent<TProps extends object> = StyledSlotComponent<TProps, VireoSkeletonOwnerState>;
+export declare const VireoSkeletonRoot: VireoSkeletonStyledSlotComponent<SkeletonProps>;
+export {};

package/dist/core/components/feedback/VireoSkeleton/VireoSkeleton.styled.js

@@ -0,0 +1,27 @@
+import { VIREO_LOADING_TOKENS } from "../../../../core/constants/loading.constants.js";
+import { Skeleton } from "@mui/material";
+import { alpha, keyframes, styled } from "@mui/material/styles";
+import { VIREO_SKELETON_NAME } from "./VireoSkeleton.identity.js";
+const vireoSkeletonPulse = keyframes({
+    "0%, 100%": { backgroundColor: "var(--VireoSkeleton-baseColor)" },
+    "50%": { backgroundColor: "var(--VireoSkeleton-highlightColor)" },
+});
+export const VireoSkeletonRoot = styled(Skeleton, {
+    name: VIREO_SKELETON_NAME,
+    slot: "Root",
+    overridesResolver: (_props, styles) => styles.root,
+})(({ theme }) => {
+    const baseColor = theme.vars?.palette.Skeleton.bg ?? alpha(theme.palette.text.primary, 0.11);
+    const highlightColor = theme.vars?.palette.action.selected ?? alpha(theme.palette.text.primary, 0.18);
+    return {
+        "--VireoSkeleton-baseColor": baseColor,
+        "--VireoSkeleton-highlightColor": highlightColor,
+        backgroundColor: "var(--VireoSkeleton-baseColor)",
+        animation: `${vireoSkeletonPulse} ${VIREO_LOADING_TOKENS.skeletonAnimationDuration}ms ease-in-out infinite`,
+        pointerEvents: "none",
+        userSelect: "none",
+        "@media (prefers-reduced-motion: reduce)": {
+            animation: "none",
+        },
+    };
+});

package/dist/core/components/feedback/VireoSkeleton/VireoSkeleton.types.d.ts

@@ -0,0 +1,41 @@
+import type { VireoDataAttributeValue, VireoThemeComponent } from "../../../../core/utils/muiutils.js";
+import type { SkeletonProps } from "@mui/material";
+import type { CreateSlotsAndSlotProps, SlotProps } from "@mui/material/utils";
+import type React from "react";
+import { type VireoSkeletonClasses, type VireoSkeletonClassKey } from "./VireoSkeleton.classes.js";
+import type { VIREO_SKELETON_NAME, VireoSkeletonSlotName } from "./VireoSkeleton.identity.js";
+export type VireoSkeletonVariant = NonNullable<SkeletonProps["variant"]>;
+export type VireoSkeletonOwnerState = {
+    hasChildren: boolean;
+    variant: VireoSkeletonVariant;
+};
+export interface VireoSkeletonRootSlotPropsOverrides {
+    [key: `data-${string}`]: VireoDataAttributeValue;
+}
+/** Replaceable semantic regions exposed by {@link VireoSkeleton}. */
+export type VireoSkeletonSlots = {
+    [TSlotName in VireoSkeletonSlotName]: React.ElementType;
+};
+/** Slot props exposed by {@link VireoSkeleton}. */
+export type VireoSkeletonSlotsAndSlotProps = CreateSlotsAndSlotProps<VireoSkeletonSlots, {
+    /** @default MUI Skeleton */
+    root: SlotProps<"span", VireoSkeletonRootSlotPropsOverrides, VireoSkeletonOwnerState>;
+}>;
+/** Props owned by {@link VireoSkeleton}. */
+export type VireoSkeletonOwnProps = VireoSkeletonSlotsAndSlotProps & {
+    /** Optional content whose rendered geometry the skeleton should preserve. */
+    children?: React.ReactNode;
+    /** Override or extend the utility classes applied to each slot. */
+    classes?: Partial<VireoSkeletonClasses>;
+    /** Shape of the placeholder. @default 'text' */
+    variant?: VireoSkeletonVariant;
+};
+/** Props VireoSkeleton inherits from its default root after excluding component-owned props. */
+export type VireoSkeletonInheritedProps = Omit<SkeletonProps, "animation" | "children" | "classes" | "component" | "variant">;
+/** Props accepted by {@link VireoSkeleton}. */
+export type VireoSkeletonProps = VireoSkeletonOwnProps & VireoSkeletonInheritedProps;
+declare module "@mui/material/styles" {
+    interface Components<Theme = unknown> {
+        [VIREO_SKELETON_NAME]?: VireoThemeComponent<VireoSkeletonProps, VireoSkeletonClassKey, VireoSkeletonOwnerState, Theme>;
+    }
+}

package/dist/core/components/feedback/VireoSkeleton/VireoSkeleton.types.js

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

package/dist/core/components/feedback/VireoSkeleton/index.d.ts

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

package/dist/core/components/feedback/VireoSkeleton/index.js

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

package/dist/core/components/feedback/VireoStatusDot/VireoStatusDot.classes.d.ts

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

package/dist/core/components/feedback/VireoStatusDot/VireoStatusDot.classes.js

@@ -0,0 +1,11 @@
+import { generateUtilityClass, generateUtilityClasses } from "@mui/material";
+import { VIREO_STATUS_DOT_NAME, VIREO_STATUS_DOT_SLOTS } from "./VireoStatusDot.identity.js";
+/** Returns the generated utility class name for a VireoStatusDot slot or state. */
+export function getVireoStatusDotUtilityClass(slot) {
+    return generateUtilityClass(VIREO_STATUS_DOT_NAME, slot);
+}
+/** Generated utility class names keyed by each public VireoStatusDot class key. */
+export const vireoStatusDotClasses = generateUtilityClasses(VIREO_STATUS_DOT_NAME, [
+    ...VIREO_STATUS_DOT_SLOTS,
+    "selected",
+]);

package/dist/core/components/feedback/VireoStatusDot/VireoStatusDot.d.ts

@@ -0,0 +1,6 @@
+import React from "react";
+import { type VireoStatusDotProps } from "./VireoStatusDot.types.js";
+/**
+ * Displays a compact semantic status marker with theme-aware colors and optional standalone labelling.
+ */
+export declare const VireoStatusDot: React.ForwardRefExoticComponent<Omit<VireoStatusDotProps, "ref"> & React.RefAttributes<HTMLSpanElement>>;

package/dist/core/components/feedback/VireoStatusDot/VireoStatusDot.identity.d.ts

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

package/dist/core/components/feedback/VireoStatusDot/VireoStatusDot.identity.js

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

package/dist/core/components/feedback/VireoStatusDot/VireoStatusDot.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { joinClassNames, mergeSx, resolveSlotProps } from "../../../../core/utils/muiutils.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 { getVireoStatusDotUtilityClass } from "./VireoStatusDot.classes.js";
+import { VIREO_STATUS_DOT_NAME } from "./VireoStatusDot.identity.js";
+import { VireoStatusDotRoot } from "./VireoStatusDot.styled.js";
+function useUtilityClasses(ownerState, classes) {
+    return composeClasses({
+        root: ["root", ownerState.selected && "selected"],
+    }, getVireoStatusDotUtilityClass, classes);
+}
+/**
+ * Displays a compact semantic status marker with theme-aware colors and optional standalone labelling.
+ */
+export const VireoStatusDot = React.forwardRef(function VireoStatusDot(inProps, forwardedRef) {
+    const props = useThemeProps({ props: inProps, name: VIREO_STATUS_DOT_NAME });
+    const { className, classes: classesProp, color, label, selected = false, size = 8, slotProps = {}, slots = {}, style, sx, ...other } = props;
+    const ownerState = {
+        color,
+        labeled: Boolean(label),
+        selected,
+        size,
+    };
+    const classes = useUtilityClasses(ownerState, classesProp);
+    const resolvedRootSlotProps = resolveSlotProps(slotProps.root, ownerState);
+    const { className: rootSlotClassName, ref: rootSlotRef, style: rootSlotStyle, sx: rootSlotSx, ...rootSlotOther } = resolvedRootSlotProps;
+    const rootRef = useForkRef(forwardedRef, rootSlotRef);
+    return (_jsx(VireoStatusDotRoot, { ...other, ...rootSlotOther, as: slots.root ?? "span", ref: rootRef, ownerState: ownerState, "aria-hidden": label ? undefined : true, "aria-label": label, role: label ? "img" : undefined, className: joinClassNames(classes.root, className, rootSlotClassName), style: { ...style, ...rootSlotStyle }, sx: mergeSx(sx, rootSlotSx) }));
+});
+VireoStatusDot.displayName = VIREO_STATUS_DOT_NAME;

package/dist/core/components/feedback/VireoStatusDot/VireoStatusDot.styled.d.ts

@@ -0,0 +1,6 @@
+import { type StyledSlotComponent } from "../../../../core/utils/muiutils.js";
+import { type BoxProps } from "@mui/material";
+import { type VireoStatusDotOwnerState } from "./VireoStatusDot.types.js";
+type VireoStatusDotStyledSlotComponent<TProps extends object> = StyledSlotComponent<TProps, VireoStatusDotOwnerState>;
+export declare const VireoStatusDotRoot: VireoStatusDotStyledSlotComponent<BoxProps>;
+export {};

package/dist/core/components/feedback/VireoStatusDot/VireoStatusDot.styled.js

@@ -0,0 +1,19 @@
+import { Box } from "@mui/material";
+import { styled } from "@mui/material/styles";
+import { VIREO_STATUS_DOT_NAME } from "./VireoStatusDot.identity.js";
+export const VireoStatusDotRoot = styled(Box, {
+    name: VIREO_STATUS_DOT_NAME,
+    slot: "Root",
+    overridesResolver: ({ ownerState }, styles) => [styles.root, ownerState.selected && styles.selected],
+})(({ theme, ownerState }) => ({
+    backgroundColor: ownerState.selected
+        ? theme.palette.common.white
+        : ownerState.color === "standard"
+            ? theme.palette.text.primary
+            : theme.palette[ownerState.color].main,
+    borderRadius: "50%",
+    display: "inline-block",
+    flex: "0 0 auto",
+    height: ownerState.size,
+    width: ownerState.size,
+}));

package/dist/core/components/feedback/VireoStatusDot/VireoStatusDot.types.d.ts

@@ -0,0 +1,49 @@
+import type { VireoDataAttributeValue } from "../../../../core/utils/muiutils.js";
+import type { BoxProps } from "@mui/material";
+import type { VireoThemeComponent } from "../../../../core/utils/muiutils.js";
+import type { CreateSlotsAndSlotProps, SlotProps } from "@mui/material/utils";
+import type React from "react";
+import { type VireoStatusDotClasses, type VireoStatusDotClassKey } from "./VireoStatusDot.classes.js";
+import type { VIREO_STATUS_DOT_NAME, VireoStatusDotSlotName } from "./VireoStatusDot.identity.js";
+export type VireoStatusDotColor = "success" | "error" | "warning" | "info" | "standard";
+export type VireoStatusDotSize = number | string;
+export type VireoStatusDotOwnerState = {
+    color: VireoStatusDotColor;
+    labeled: boolean;
+    selected: boolean;
+    size: VireoStatusDotSize;
+};
+export interface VireoStatusDotRootSlotPropsOverrides {
+    [key: `data-${string}`]: VireoDataAttributeValue;
+}
+/** Replaceable semantic regions exposed by {@link VireoStatusDot}. */
+export type VireoStatusDotSlots = {
+    [TSlotName in VireoStatusDotSlotName]: React.ElementType;
+};
+/** Slot props exposed by {@link VireoStatusDot}. */
+export type VireoStatusDotSlotsAndSlotProps = CreateSlotsAndSlotProps<VireoStatusDotSlots, {
+    /** @default 'span' */
+    root: SlotProps<"span", VireoStatusDotRootSlotPropsOverrides, VireoStatusDotOwnerState>;
+}>;
+/** Props owned by {@link VireoStatusDot}. */
+export type VireoStatusDotOwnProps = VireoStatusDotSlotsAndSlotProps & {
+    /** Semantic color represented by the dot. */
+    color: VireoStatusDotColor;
+    /** Accessible label for a standalone dot. Omit when adjacent text already conveys its meaning. */
+    label?: string;
+    /** Inverts the dot for selected or emphasized surfaces. @default false */
+    selected?: boolean;
+    /** Diameter of the dot. Numbers are interpreted as pixels. @default 8 */
+    size?: VireoStatusDotSize;
+    /** Override or extend the utility classes applied to each slot. */
+    classes?: Partial<VireoStatusDotClasses>;
+};
+/** Props VireoStatusDot inherits from its default root after excluding component-owned props. */
+export type VireoStatusDotInheritedProps = Omit<BoxProps<"span">, "aria-hidden" | "aria-label" | "children" | "color" | "component" | "role">;
+/** Props accepted by {@link VireoStatusDot}. */
+export type VireoStatusDotProps = VireoStatusDotOwnProps & VireoStatusDotInheritedProps;
+declare module "@mui/material/styles" {
+    interface Components<Theme = unknown> {
+        [VIREO_STATUS_DOT_NAME]?: VireoThemeComponent<VireoStatusDotProps, VireoStatusDotClassKey, VireoStatusDotOwnerState, Theme>;
+    }
+}

package/dist/core/components/feedback/VireoStatusDot/VireoStatusDot.types.js

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

package/dist/core/components/feedback/VireoStatusDot/index.d.ts

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

package/dist/core/components/feedback/VireoStatusDot/index.js

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

package/dist/core/components/layout/VireoSlidingScreenStack/VireoSlidingScreenStack.classes.d.ts

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

package/dist/core/components/layout/VireoSlidingScreenStack/VireoSlidingScreenStack.classes.js

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

package/dist/core/components/layout/VireoSlidingScreenStack/VireoSlidingScreenStack.d.ts

@@ -0,0 +1,4 @@
+import React from "react";
+import { type VireoSlidingScreenStackProps } from "./VireoSlidingScreenStack.types.js";
+/** Animates a controlled collection of full-width screens along one horizontal track. */
+export declare const VireoSlidingScreenStack: React.ForwardRefExoticComponent<Omit<VireoSlidingScreenStackProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/core/components/layout/VireoSlidingScreenStack/VireoSlidingScreenStack.identity.d.ts

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

package/dist/core/components/layout/VireoSlidingScreenStack/VireoSlidingScreenStack.identity.js

@@ -0,0 +1,4 @@
+/** Stable component name shared by every VireoSlidingScreenStack integration point. */
+export const VIREO_SLIDING_SCREEN_STACK_NAME = "VireoSlidingScreenStack";
+/** Canonical public slots exposed by VireoSlidingScreenStack, in rendered DOM order. */
+export const VIREO_SLIDING_SCREEN_STACK_SLOTS = ["root", "track", "screen"];

package/dist/core/components/layout/VireoSlidingScreenStack/VireoSlidingScreenStack.js

@@ -0,0 +1,35 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createElement as _createElement } from "react";
+import { joinClassNames, mergeSx, resolveSlotProps } from "../../../../core/utils/muiutils.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 { getVireoSlidingScreenStackUtilityClass, } from "./VireoSlidingScreenStack.classes.js";
+import { VIREO_SLIDING_SCREEN_STACK_NAME, } from "./VireoSlidingScreenStack.identity.js";
+import { VireoSlidingScreenStackRoot, VireoSlidingScreenStackScreen, VireoSlidingScreenStackTrack, } from "./VireoSlidingScreenStack.styled.js";
+function useUtilityClasses(_ownerState, classes) {
+    return composeClasses({ root: ["root"], track: ["track"], screen: ["screen"] }, getVireoSlidingScreenStackUtilityClass, classes);
+}
+/** Animates a controlled collection of full-width screens along one horizontal track. */
+export const VireoSlidingScreenStack = React.forwardRef(function VireoSlidingScreenStack(inProps, forwardedRef) {
+    const props = useThemeProps({ props: inProps, name: VIREO_SLIDING_SCREEN_STACK_NAME });
+    const { activeScreen, className, classes: classesProp, screens, slotProps = {}, slots = {}, style, sx, ...other } = props;
+    const activeScreenIndex = Math.max(screens.findIndex(screen => screen.id === activeScreen), 0);
+    const ownerState = { activeScreenIndex, screenCount: Math.max(screens.length, 1) };
+    const classes = useUtilityClasses(ownerState, classesProp);
+    const rootSlotProps = resolveSlotProps(slotProps.root, ownerState);
+    const trackSlotProps = resolveSlotProps(slotProps.track, ownerState);
+    const screenSlotProps = resolveSlotProps(slotProps.screen, ownerState);
+    const { className: rootClassName, ref: rootRef, style: rootStyle, sx: rootSx, ...rootOther } = rootSlotProps;
+    const { className: trackClassName, ...trackOther } = trackSlotProps;
+    const { className: screenClassName, style: screenStyle, ...screenOther } = screenSlotProps;
+    const ref = useForkRef(forwardedRef, rootRef);
+    return (_jsx(VireoSlidingScreenStackRoot, { ...other, ...rootOther, as: slots.root ?? "div", ref: ref, ownerState: ownerState, className: joinClassNames(classes.root, className, rootClassName), style: { ...style, ...rootStyle }, sx: mergeSx(sx, rootSx), children: _jsx(VireoSlidingScreenStackTrack, { ...trackOther, as: slots.track ?? "div", ownerState: ownerState, className: joinClassNames(classes.track, trackClassName), "data-active-index": activeScreenIndex, children: screens.map((screen, index) => (_createElement(VireoSlidingScreenStackScreen, { ...screenOther, key: screen.id, as: slots.screen ?? "div", ownerState: ownerState, className: joinClassNames(classes.screen, screenClassName), style: {
+                    ...screenStyle,
+                    pointerEvents: index === activeScreenIndex ? undefined : "none",
+                    transform: `translateX(${(index - activeScreenIndex) * 100}%)`,
+                    visibility: index === activeScreenIndex ? "visible" : "hidden",
+                }, "aria-hidden": index !== activeScreenIndex, "data-screen-id": screen.id }, screen.children))) }) }));
+});
+VireoSlidingScreenStack.displayName = VIREO_SLIDING_SCREEN_STACK_NAME;

package/dist/core/components/layout/VireoSlidingScreenStack/VireoSlidingScreenStack.styled.d.ts

@@ -0,0 +1,8 @@
+import { type StyledSlotComponent } from "../../../../core/utils/muiutils.js";
+import { type BoxProps } from "@mui/material";
+import { type VireoSlidingScreenStackOwnerState } from "./VireoSlidingScreenStack.types.js";
+type Slot = StyledSlotComponent<BoxProps, VireoSlidingScreenStackOwnerState>;
+export declare const VireoSlidingScreenStackRoot: Slot;
+export declare const VireoSlidingScreenStackTrack: Slot;
+export declare const VireoSlidingScreenStackScreen: Slot;
+export {};