@vireocodedev/ui 0.2.0 → 0.2.1

package/dist/integrations/hello-pangea-dnd/components/controls/VireoDragHandle/VireoDragHandle.types.d.ts

@@ -0,0 +1,50 @@
+import type { VireoDataAttributeValue, VireoThemeComponent } from "../../../../../core/public.js";
+import type DragIndicatorRounded from "@mui/icons-material/DragIndicatorRounded";
+import type { IconButton, IconButtonProps } from "@mui/material";
+import type { CreateSlotsAndSlotProps, SlotProps } from "@mui/material/utils";
+import type React from "react";
+import { type VireoDragHandleClasses, type VireoDragHandleClassKey } from "./VireoDragHandle.classes.js";
+import type { VIREO_DRAG_HANDLE_NAME, VireoDragHandleSlotName } from "./VireoDragHandle.identity.js";
+export type VireoDragHandleOwnerState = {
+    disabled: boolean;
+    isDragging: boolean;
+};
+export interface VireoDragHandleRootSlotPropsOverrides {
+    [key: `data-${string}`]: VireoDataAttributeValue;
+}
+export interface VireoDragHandleIconSlotPropsOverrides {
+    [key: `data-${string}`]: VireoDataAttributeValue;
+}
+/** Replaceable semantic regions exposed by {@link VireoDragHandle}. */
+export type VireoDragHandleSlots = {
+    [TSlotName in VireoDragHandleSlotName]: React.ElementType;
+};
+/** Slot props exposed by {@link VireoDragHandle}. */
+export type VireoDragHandleSlotsAndSlotProps = CreateSlotsAndSlotProps<VireoDragHandleSlots, {
+    /** @default IconButton */
+    root: SlotProps<typeof IconButton, VireoDragHandleRootSlotPropsOverrides, VireoDragHandleOwnerState>;
+    /** @default DragIndicatorRounded */
+    icon: SlotProps<typeof DragIndicatorRounded, VireoDragHandleIconSlotPropsOverrides, VireoDragHandleOwnerState>;
+}>;
+/** Props owned by {@link VireoDragHandle}. */
+export type VireoDragHandleOwnProps = VireoDragHandleSlotsAndSlotProps & {
+    children?: React.ReactNode;
+    /** Override or extend the utility classes applied to each slot. */
+    classes?: Partial<VireoDragHandleClasses>;
+};
+export type VireoDragHandleAccessibleName = {
+    "aria-label": string;
+    "aria-labelledby"?: string;
+} | {
+    "aria-label"?: string;
+    "aria-labelledby": string;
+};
+/** Props VireoDragHandle inherits from its default root after excluding component-owned props. */
+export type VireoDragHandleInheritedProps = Omit<IconButtonProps, "aria-label" | "aria-labelledby" | "children" | "component" | "disabled">;
+/** Props accepted by {@link VireoDragHandle}. */
+export type VireoDragHandleProps = VireoDragHandleOwnProps & VireoDragHandleAccessibleName & VireoDragHandleInheritedProps;
+declare module "@mui/material/styles" {
+    interface Components<Theme = unknown> {
+        [VIREO_DRAG_HANDLE_NAME]?: VireoThemeComponent<VireoDragHandleProps, VireoDragHandleClassKey, VireoDragHandleOwnerState, Theme>;
+    }
+}

package/dist/integrations/hello-pangea-dnd/components/controls/VireoDragHandle/VireoDragHandle.types.js

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

package/dist/integrations/hello-pangea-dnd/components/controls/VireoDragHandle/index.d.ts

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

package/dist/integrations/hello-pangea-dnd/components/controls/VireoDragHandle/index.js

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

package/dist/integrations/hello-pangea-dnd/components/layout/VireoDropZone/VireoDropZone.classes.d.ts

@@ -0,0 +1,9 @@
+import { type VireoDropZoneSlotName } from "./VireoDropZone.identity.js";
+/** Utility classes available to VireoDropZone. */
+export type VireoDropZoneClasses = Record<VireoDropZoneSlotName | "candidate" | "disabled" | "over" | "rejected", string>;
+/** Valid keys for VireoDropZone utility classes and theme style overrides. */
+export type VireoDropZoneClassKey = keyof VireoDropZoneClasses;
+/** Returns the generated utility class name for a VireoDropZone slot or state. */
+export declare function getVireoDropZoneUtilityClass(slot: string): string;
+/** Generated utility class names keyed by each public VireoDropZone class key. */
+export declare const vireoDropZoneClasses: VireoDropZoneClasses;

package/dist/integrations/hello-pangea-dnd/components/layout/VireoDropZone/VireoDropZone.classes.js

@@ -0,0 +1,14 @@
+import { generateUtilityClass, generateUtilityClasses } from "@mui/material";
+import { VIREO_DROP_ZONE_NAME, VIREO_DROP_ZONE_SLOTS } from "./VireoDropZone.identity.js";
+/** Returns the generated utility class name for a VireoDropZone slot or state. */
+export function getVireoDropZoneUtilityClass(slot) {
+    return generateUtilityClass(VIREO_DROP_ZONE_NAME, slot);
+}
+/** Generated utility class names keyed by each public VireoDropZone class key. */
+export const vireoDropZoneClasses = generateUtilityClasses(VIREO_DROP_ZONE_NAME, [
+    ...VIREO_DROP_ZONE_SLOTS,
+    "candidate",
+    "disabled",
+    "over",
+    "rejected",
+]);

package/dist/integrations/hello-pangea-dnd/components/layout/VireoDropZone/VireoDropZone.d.ts

@@ -0,0 +1,4 @@
+import React from "react";
+import type { VireoDropZoneProps } from "./VireoDropZone.types.js";
+/** Renders a typed reorder list or transfer destination inside VireoDndProvider. */
+export declare const VireoDropZone: React.ForwardRefExoticComponent<Omit<VireoDropZoneProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/integrations/hello-pangea-dnd/components/layout/VireoDropZone/VireoDropZone.identity.d.ts

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

package/dist/integrations/hello-pangea-dnd/components/layout/VireoDropZone/VireoDropZone.identity.js

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

package/dist/integrations/hello-pangea-dnd/components/layout/VireoDropZone/VireoDropZone.js

@@ -0,0 +1,35 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { VireoDndContext } from "../../../../../integrations/hello-pangea-dnd/contexts/VireoDndContext/VireoDndContext.js";
+import { encodeDndIdentifier } from "../../../../../integrations/hello-pangea-dnd/utils/dndIdCodec.js";
+import { DropZoneRoot } from "../../../../../integrations/hello-pangea-dnd/components/layout/VireoDropZone/internal/components/DropZoneRoot/index.js";
+import { Droppable } from "@hello-pangea/dnd";
+import { useThemeProps } from "@mui/material/styles";
+import React from "react";
+import { VIREO_DROP_ZONE_NAME } from "./VireoDropZone.identity.js";
+/** Renders a typed reorder list or transfer destination inside VireoDndProvider. */
+export const VireoDropZone = React.forwardRef(function VireoDropZone(inProps, forwardedRef) {
+    const props = useThemeProps({ props: inProps, name: VIREO_DROP_ZONE_NAME });
+    const { canDrop, disabled = false, disableDefaultFeedback = false, direction = "vertical", group = "default", id, mode, ...rootProps } = props;
+    const context = React.useContext(VireoDndContext);
+    if (!context)
+        throw new Error("VireoDropZone must be used within VireoDndProvider.");
+    const { active, getZone, isDragging, registerZone } = context;
+    const encodedId = React.useMemo(() => encodeDndIdentifier(id, VIREO_DROP_ZONE_NAME), [id]);
+    const registration = React.useMemo(() => ({ id, mode, group, disabled, canDrop }), [canDrop, disabled, group, id, mode]);
+    React.useEffect(() => registerZone(encodedId, registration), [encodedId, registerZone, registration]);
+    const sourceZone = active ? getZone(encodeDndIdentifier(active.source.id, VIREO_DROP_ZONE_NAME)) : undefined;
+    const groupCompatible = !active || sourceZone?.group === group;
+    const accepted = !active ||
+        (groupCompatible &&
+            !disabled &&
+            (canDrop?.({
+                draggable: active.draggable,
+                source: active.source,
+                destination: { id, mode, group },
+            }) ??
+                true));
+    const rejected = isDragging && !accepted;
+    return (_jsx(Droppable, { droppableId: encodedId, type: group, direction: direction, isDropDisabled: disabled || rejected, children: (provided, snapshot) => (_jsx(DropZoneRoot, { ...rootProps, candidate: isDragging && accepted, disabled: disabled, disableDefaultFeedback: disableDefaultFeedback, direction: direction, forwardedRef: forwardedRef, mode: mode, provided: provided, rejected: rejected, snapshot: snapshot })) }));
+});
+VireoDropZone.displayName = VIREO_DROP_ZONE_NAME;

package/dist/integrations/hello-pangea-dnd/components/layout/VireoDropZone/VireoDropZone.styled.d.ts

@@ -0,0 +1,6 @@
+import { type StyledSlotComponent } from "../../../../../core/public.js";
+import { type BoxProps } from "@mui/material";
+import { type VireoDropZoneOwnerState } from "./VireoDropZone.types.js";
+type VireoDropZoneStyledSlotComponent<TProps extends object> = StyledSlotComponent<TProps, VireoDropZoneOwnerState>;
+export declare const VireoDropZoneRoot: VireoDropZoneStyledSlotComponent<BoxProps>;
+export {};

package/dist/integrations/hello-pangea-dnd/components/layout/VireoDropZone/VireoDropZone.styled.js

@@ -0,0 +1,32 @@
+import { Box } from "@mui/material";
+import { styled } from "@mui/material/styles";
+import { VIREO_DROP_ZONE_NAME } from "./VireoDropZone.identity.js";
+export const VireoDropZoneRoot = styled(Box, {
+    name: VIREO_DROP_ZONE_NAME,
+    slot: "Root",
+    overridesResolver: ({ ownerState }, styles) => [
+        styles.root,
+        ownerState.disabled && styles.disabled,
+        ownerState.dropState === "candidate" && styles.candidate,
+        ownerState.dropState === "over" && styles.over,
+        ownerState.dropState === "rejected" && styles.rejected,
+    ],
+})(({ theme, ownerState }) => {
+    if (ownerState.disableDefaultFeedback)
+        return {};
+    return {
+        position: "relative",
+        transition: theme.transitions.create(["background-color", "outline-color"], {
+            duration: theme.transitions.duration.shortest,
+        }),
+        ...(ownerState.dropState === "candidate" && {
+            outline: `2px dashed ${theme.palette.primary.main}`,
+            outlineOffset: -2,
+        }),
+        ...(ownerState.dropState === "over" && {
+            outline: `2px solid ${theme.palette.primary.main}`,
+            outlineOffset: -2,
+            backgroundColor: `color-mix(in srgb, ${theme.palette.primary.main} 10%, transparent)`,
+        }),
+    };
+});

package/dist/integrations/hello-pangea-dnd/components/layout/VireoDropZone/VireoDropZone.types.d.ts

@@ -0,0 +1,56 @@
+import type { VireoDataAttributeValue, VireoThemeComponent } from "../../../../../core/public.js";
+import type { VireoDndDropProposal, VireoDndMode, VireoDropZoneId } from "../../../../../integrations/hello-pangea-dnd/types/dnd.types.js";
+import type { BoxProps } from "@mui/material";
+import type { CreateSlotsAndSlotProps, SlotProps } from "@mui/material/utils";
+import type React from "react";
+import { type VireoDropZoneClasses, type VireoDropZoneClassKey } from "./VireoDropZone.classes.js";
+import type { VIREO_DROP_ZONE_NAME, VireoDropZoneSlotName } from "./VireoDropZone.identity.js";
+export type VireoDropZoneState = "candidate" | "idle" | "over" | "rejected";
+export type VireoDropZoneOwnerState = {
+    direction: "horizontal" | "vertical";
+    disabled: boolean;
+    disableDefaultFeedback: boolean;
+    dropState: VireoDropZoneState;
+    mode: VireoDndMode;
+};
+export interface VireoDropZoneRootSlotPropsOverrides {
+    [key: `data-${string}`]: VireoDataAttributeValue;
+}
+/** Replaceable semantic regions exposed by {@link VireoDropZone}. */
+export type VireoDropZoneSlots = {
+    [TSlotName in VireoDropZoneSlotName]: React.ElementType;
+};
+/** Slot props exposed by {@link VireoDropZone}. */
+export type VireoDropZoneSlotsAndSlotProps = CreateSlotsAndSlotProps<VireoDropZoneSlots, {
+    /** @default 'div' */
+    root: SlotProps<"div", VireoDropZoneRootSlotPropsOverrides, VireoDropZoneOwnerState>;
+}>;
+/** Props owned by {@link VireoDropZone}. */
+export type VireoDropZoneOwnProps = VireoDropZoneSlotsAndSlotProps & {
+    children?: React.ReactNode;
+    /** Override or extend the utility classes applied to each slot. */
+    classes?: Partial<VireoDropZoneClasses>;
+    /** Determines whether the active draggable is accepted by this compatible zone. */
+    canDrop?: (proposal: VireoDndDropProposal) => boolean;
+    /** @default false */
+    disabled?: boolean;
+    /** @default false */
+    disableDefaultFeedback?: boolean;
+    /** @default 'vertical' */
+    direction?: "horizontal" | "vertical";
+    /** Native compatibility group. Zones exchange items only inside the same group. @default 'default' */
+    group?: string;
+    /** Structured identifier unique within the nearest provider. */
+    id: VireoDropZoneId;
+    /** Controls insertion semantics at this destination. */
+    mode: VireoDndMode;
+};
+/** Props VireoDropZone inherits from its default root after excluding component-owned props. */
+export type VireoDropZoneInheritedProps = Omit<BoxProps<"div">, "children" | "component" | "id">;
+/** Props accepted by {@link VireoDropZone}. */
+export type VireoDropZoneProps = VireoDropZoneOwnProps & VireoDropZoneInheritedProps;
+declare module "@mui/material/styles" {
+    interface Components<Theme = unknown> {
+        [VIREO_DROP_ZONE_NAME]?: VireoThemeComponent<VireoDropZoneProps, VireoDropZoneClassKey, VireoDropZoneOwnerState, Theme>;
+    }
+}

package/dist/integrations/hello-pangea-dnd/components/layout/VireoDropZone/VireoDropZone.types.js

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

package/dist/integrations/hello-pangea-dnd/components/layout/VireoDropZone/index.d.ts

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

package/dist/integrations/hello-pangea-dnd/components/layout/VireoDropZone/index.js

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

package/dist/integrations/hello-pangea-dnd/components/layout/VireoDropZone/internal/components/DropZoneRoot/DropZoneRoot.d.ts

@@ -0,0 +1,16 @@
+import type { VireoDropZoneOwnerState, VireoDropZoneProps } from "../../../../../../../../integrations/hello-pangea-dnd/components/layout/VireoDropZone/VireoDropZone.types.js";
+import type { DroppableProvided, DroppableStateSnapshot } from "@hello-pangea/dnd";
+import React from "react";
+type DropZoneRootProps = Omit<VireoDropZoneProps, "canDrop" | "disabled" | "disableDefaultFeedback" | "direction" | "group" | "id" | "mode"> & {
+    candidate: boolean;
+    disabled: boolean;
+    disableDefaultFeedback: boolean;
+    direction: "horizontal" | "vertical";
+    forwardedRef: React.ForwardedRef<HTMLDivElement>;
+    mode: VireoDropZoneOwnerState["mode"];
+    provided: DroppableProvided;
+    rejected: boolean;
+    snapshot: DroppableStateSnapshot;
+};
+export declare function DropZoneRoot({ candidate, children, className, classes: classesProp, disabled, disableDefaultFeedback, direction, forwardedRef, mode, provided, rejected, slotProps, slots, style, sx, snapshot, ...other }: DropZoneRootProps): React.JSX.Element;
+export {};

package/dist/integrations/hello-pangea-dnd/components/layout/VireoDropZone/internal/components/DropZoneRoot/DropZoneRoot.js

@@ -0,0 +1,32 @@
+import { jsxs as _jsxs } from "react/jsx-runtime";
+import { joinClassNames, mergeSx, resolveSlotProps } from "../../../../../../../../core/public.js";
+import { getVireoDropZoneUtilityClass, } from "../../../../../../../../integrations/hello-pangea-dnd/components/layout/VireoDropZone/VireoDropZone.classes.js";
+import { VireoDropZoneRoot } from "../../../../../../../../integrations/hello-pangea-dnd/components/layout/VireoDropZone/VireoDropZone.styled.js";
+import { unstable_composeClasses as composeClasses } from "@mui/material";
+import { useForkRef } from "@mui/material/utils";
+function useUtilityClasses(ownerState, classes) {
+    return composeClasses({
+        root: [
+            "root",
+            ownerState.disabled && "disabled",
+            ownerState.dropState === "candidate" && "candidate",
+            ownerState.dropState === "over" && "over",
+            ownerState.dropState === "rejected" && "rejected",
+        ],
+    }, getVireoDropZoneUtilityClass, classes);
+}
+export function DropZoneRoot({ candidate, children, className, classes: classesProp, disabled, disableDefaultFeedback, direction, forwardedRef, mode, provided, rejected, slotProps = {}, slots = {}, style, sx, snapshot, ...other }) {
+    const dropState = snapshot.isDraggingOver
+        ? "over"
+        : rejected
+            ? "rejected"
+            : candidate
+                ? "candidate"
+                : "idle";
+    const ownerState = { direction, disabled, disableDefaultFeedback, dropState, mode };
+    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, provided.innerRef);
+    return (_jsxs(VireoDropZoneRoot, { ...other, ...rootSlotOther, ...provided.droppableProps, as: slots.root ?? "div", ref: rootRef, ownerState: ownerState, className: joinClassNames(classes.root, className, rootSlotClassName), "data-drop-mode": mode, "data-drop-state": dropState, style: { ...style, ...rootSlotStyle }, sx: mergeSx(sx, rootSlotSx), children: [children, mode === "reorder" && provided.placeholder] }));
+}

package/dist/integrations/hello-pangea-dnd/components/layout/VireoDropZone/internal/components/DropZoneRoot/index.d.ts

@@ -0,0 +1 @@
+export { DropZoneRoot } from "./DropZoneRoot.js";

package/dist/integrations/hello-pangea-dnd/components/layout/VireoDropZone/internal/components/DropZoneRoot/index.js

@@ -0,0 +1 @@
+export { DropZoneRoot } from "./DropZoneRoot.js";

package/dist/integrations/hello-pangea-dnd/contexts/VireoDndContext/VireoDndContext.d.ts

@@ -0,0 +1,15 @@
+import type { VireoDndDropProposal, VireoDndMode, VireoDndState, VireoDropZoneId } from "../../../../integrations/hello-pangea-dnd/types/dnd.types.js";
+import React from "react";
+export type VireoDndZoneRegistration = {
+    id: VireoDropZoneId;
+    mode: VireoDndMode;
+    group: string;
+    disabled: boolean;
+    canDrop?: (proposal: VireoDndDropProposal) => boolean;
+};
+export type VireoDndContextValue = VireoDndState & {
+    getZone: (encodedId: string) => VireoDndZoneRegistration | undefined;
+    registerDraggable: (encodedId: string) => () => void;
+    registerZone: (encodedId: string, registration: VireoDndZoneRegistration) => () => void;
+};
+export declare const VireoDndContext: React.Context<VireoDndContextValue | null>;

package/dist/integrations/hello-pangea-dnd/contexts/VireoDndContext/VireoDndContext.js

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

package/dist/integrations/hello-pangea-dnd/contexts/VireoDraggableItemContext/VireoDraggableItemContext.d.ts

@@ -0,0 +1,10 @@
+import type { DraggableProvidedDragHandleProps } from "@hello-pangea/dnd";
+import React from "react";
+export type VireoDraggableItemContextValue = {
+    disabled: boolean;
+    explicitHandle: boolean;
+    isDragging: boolean;
+    dragHandleProps: DraggableProvidedDragHandleProps | null;
+    registerHandle: () => () => void;
+};
+export declare const VireoDraggableItemContext: React.Context<VireoDraggableItemContextValue | null>;

package/dist/integrations/hello-pangea-dnd/contexts/VireoDraggableItemContext/VireoDraggableItemContext.js

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

package/dist/integrations/hello-pangea-dnd/hooks/useVireoDndState/useVireoDndState.d.ts

@@ -0,0 +1,2 @@
+import type { VireoDndState } from "../../../../integrations/hello-pangea-dnd/types/dnd.types.js";
+export declare function useVireoDndState(): VireoDndState;

package/dist/integrations/hello-pangea-dnd/hooks/useVireoDndState/useVireoDndState.js

@@ -0,0 +1,8 @@
+import { VireoDndContext } from "../../../../integrations/hello-pangea-dnd/contexts/VireoDndContext/VireoDndContext.js";
+import React from "react";
+export function useVireoDndState() {
+    const context = React.useContext(VireoDndContext);
+    if (!context)
+        throw new Error("useVireoDndState must be used within VireoDndProvider.");
+    return { isDragging: context.isDragging, active: context.active, destination: context.destination };
+}

package/dist/integrations/hello-pangea-dnd/providers/VireoDndProvider/VireoDndProvider.d.ts

@@ -0,0 +1,4 @@
+import type { VireoDndProviderProps } from "../../../../integrations/hello-pangea-dnd/types/dnd.types.js";
+import React from "react";
+/** Provides one isolated, typed Hello Pangea drag-and-drop lifecycle. */
+export declare function VireoDndProvider({ children, onBeforeCapture, onBeforeDragStart, onDragStart, onDragUpdate, onDragEnd, ...nativeOptions }: VireoDndProviderProps): React.JSX.Element;

package/dist/integrations/hello-pangea-dnd/providers/VireoDndProvider/VireoDndProvider.js

@@ -0,0 +1,100 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { VireoDndContext, } from "../../../../integrations/hello-pangea-dnd/contexts/VireoDndContext/VireoDndContext.js";
+import { decodeDndIdentifier } from "../../../../integrations/hello-pangea-dnd/utils/dndIdCodec.js";
+import { DragDropContext } from "@hello-pangea/dnd";
+import React from "react";
+const IDLE_STATE = { isDragging: false, active: null, destination: null };
+function decodeStart(start) {
+    return {
+        draggable: decodeDndIdentifier(start.draggableId),
+        source: {
+            id: decodeDndIdentifier(start.source.droppableId),
+            index: start.source.index,
+        },
+    };
+}
+/** Provides one isolated, typed Hello Pangea drag-and-drop lifecycle. */
+export function VireoDndProvider({ children, onBeforeCapture, onBeforeDragStart, onDragStart, onDragUpdate, onDragEnd, ...nativeOptions }) {
+    const parentContext = React.useContext(VireoDndContext);
+    if (parentContext)
+        throw new Error("VireoDndProvider instances cannot be nested.");
+    const [state, setState] = React.useState(IDLE_STATE);
+    const zonesRef = React.useRef(new Map());
+    const draggableCountsRef = React.useRef(new Map());
+    const registerZone = React.useCallback((encodedId, registration) => {
+        if (process.env.NODE_ENV !== "production" && zonesRef.current.has(encodedId)) {
+            console.warn("VireoDndProvider received duplicate VireoDropZone identifiers.");
+        }
+        zonesRef.current.set(encodedId, registration);
+        return () => {
+            if (zonesRef.current.get(encodedId) === registration)
+                zonesRef.current.delete(encodedId);
+        };
+    }, []);
+    const registerDraggable = React.useCallback((encodedId) => {
+        const nextCount = (draggableCountsRef.current.get(encodedId) ?? 0) + 1;
+        draggableCountsRef.current.set(encodedId, nextCount);
+        if (process.env.NODE_ENV !== "production" && nextCount > 1) {
+            console.warn("VireoDndProvider received duplicate VireoDraggableItem identifiers.");
+        }
+        return () => {
+            const remaining = (draggableCountsRef.current.get(encodedId) ?? 1) - 1;
+            if (remaining <= 0)
+                draggableCountsRef.current.delete(encodedId);
+            else
+                draggableCountsRef.current.set(encodedId, remaining);
+        };
+    }, []);
+    const getZone = React.useCallback((encodedId) => zonesRef.current.get(encodedId), []);
+    const handleBeforeCapture = React.useCallback((capture) => onBeforeCapture?.({ draggable: decodeDndIdentifier(capture.draggableId) }), [onBeforeCapture]);
+    const handleBeforeDragStart = React.useCallback((start) => onBeforeDragStart?.(decodeStart(start)), [onBeforeDragStart]);
+    const handleDragStart = React.useCallback((start, provided) => {
+        const decoded = decodeStart(start);
+        setState({ isDragging: true, active: decoded, destination: null });
+        onDragStart?.(decoded, provided);
+    }, [onDragStart]);
+    const decodeUpdate = React.useCallback((update) => {
+        const start = decodeStart(update);
+        const zone = update.destination ? getZone(update.destination.droppableId) : undefined;
+        return {
+            ...start,
+            destination: update.destination && zone ? { id: zone.id, index: update.destination.index, mode: zone.mode } : null,
+        };
+    }, [getZone]);
+    const handleDragUpdate = React.useCallback((update, provided) => {
+        const decoded = decodeUpdate(update);
+        const destinationZone = update.destination ? getZone(update.destination.droppableId) : undefined;
+        const sourceZone = getZone(update.source.droppableId);
+        const accepted = Boolean(decoded.destination &&
+            destinationZone &&
+            !destinationZone.disabled &&
+            sourceZone?.group === destinationZone.group &&
+            (destinationZone.canDrop?.({
+                draggable: decoded.draggable,
+                source: decoded.source,
+                destination: {
+                    id: destinationZone.id,
+                    mode: destinationZone.mode,
+                    group: destinationZone.group,
+                },
+            }) ??
+                true));
+        setState(current => ({
+            isDragging: true,
+            active: current.active ?? { draggable: decoded.draggable, source: decoded.source },
+            destination: decoded.destination ? { ...decoded.destination, accepted } : null,
+        }));
+        onDragUpdate?.(decoded, provided);
+    }, [decodeUpdate, getZone, onDragUpdate]);
+    const handleDragEnd = React.useCallback((result, provided) => {
+        const decoded = decodeUpdate(result);
+        setState(IDLE_STATE);
+        onDragEnd({
+            ...decoded,
+            reason: result.reason === "CANCEL" || decoded.destination === null ? "cancel" : "drop",
+        }, provided);
+    }, [decodeUpdate, onDragEnd]);
+    const value = React.useMemo(() => ({ ...state, getZone, registerDraggable, registerZone }), [getZone, registerDraggable, registerZone, state]);
+    return (_jsx(DragDropContext, { ...nativeOptions, onBeforeCapture: handleBeforeCapture, onBeforeDragStart: handleBeforeDragStart, onDragStart: handleDragStart, onDragUpdate: handleDragUpdate, onDragEnd: handleDragEnd, children: _jsx(VireoDndContext.Provider, { value: value, children: children }) }));
+}

package/dist/integrations/hello-pangea-dnd/public.d.ts

@@ -0,0 +1,6 @@
+export * from "../../integrations/hello-pangea-dnd/components/behavior/VireoDraggableItem/index.js";
+export * from "../../integrations/hello-pangea-dnd/components/controls/VireoDragHandle/index.js";
+export * from "../../integrations/hello-pangea-dnd/components/layout/VireoDropZone/index.js";
+export { useVireoDndState } from "../../integrations/hello-pangea-dnd/hooks/useVireoDndState/useVireoDndState.js";
+export { VireoDndProvider } from "../../integrations/hello-pangea-dnd/providers/VireoDndProvider/VireoDndProvider.js";
+export type * from "../../integrations/hello-pangea-dnd/types/dnd.types.js";

package/dist/integrations/hello-pangea-dnd/public.js

@@ -0,0 +1,6 @@
+"use client";
+export * from "../../integrations/hello-pangea-dnd/components/behavior/VireoDraggableItem/index.js";
+export * from "../../integrations/hello-pangea-dnd/components/controls/VireoDragHandle/index.js";
+export * from "../../integrations/hello-pangea-dnd/components/layout/VireoDropZone/index.js";
+export { useVireoDndState } from "../../integrations/hello-pangea-dnd/hooks/useVireoDndState/useVireoDndState.js";
+export { VireoDndProvider } from "../../integrations/hello-pangea-dnd/providers/VireoDndProvider/VireoDndProvider.js";

package/dist/integrations/hello-pangea-dnd/types/dnd.types.d.ts

@@ -0,0 +1,70 @@
+import type { DragDropContextProps, ResponderProvided } from "@hello-pangea/dnd";
+import type { ReactNode } from "react";
+export type VireoDndJsonValue = string | number | boolean | null | VireoDndJsonValue[] | {
+    [key: string]: VireoDndJsonValue;
+};
+export type VireoDndJsonObject = {
+    [key: string]: VireoDndJsonValue;
+};
+/** Application-wide draggable identifier registry extended through declaration merging. */
+export interface VireoDraggableIdRegistry {
+}
+/** Application-wide drop-zone identifier registry extended through declaration merging. */
+export interface VireoDropZoneIdRegistry {
+}
+type RegisteredIdentifier<TRegistry> = {
+    [TType in keyof TRegistry & string]: {
+        type: TType;
+    } & TRegistry[TType];
+}[keyof TRegistry & string];
+type UnregisteredIdentifier = {
+    type: string;
+} & VireoDndJsonObject;
+export type VireoDraggableId = keyof VireoDraggableIdRegistry extends never ? UnregisteredIdentifier : RegisteredIdentifier<VireoDraggableIdRegistry>;
+export type VireoDropZoneId = keyof VireoDropZoneIdRegistry extends never ? UnregisteredIdentifier : RegisteredIdentifier<VireoDropZoneIdRegistry>;
+export type VireoDndMode = "reorder" | "transfer";
+export type VireoDndLocation = {
+    id: VireoDropZoneId;
+    index: number;
+};
+export type VireoDndDropProposal = {
+    draggable: VireoDraggableId;
+    source: VireoDndLocation;
+    destination: {
+        id: VireoDropZoneId;
+        mode: VireoDndMode;
+        group: string;
+    };
+};
+export type VireoDndDragStart = {
+    draggable: VireoDraggableId;
+    source: VireoDndLocation;
+};
+export type VireoDndDragUpdate = VireoDndDragStart & {
+    destination: (VireoDndLocation & {
+        mode: VireoDndMode;
+    }) | null;
+};
+export type VireoDndDragEndResult = VireoDndDragUpdate & {
+    reason: "drop" | "cancel";
+};
+export type VireoDndState = {
+    isDragging: boolean;
+    active: VireoDndDragStart | null;
+    destination: (VireoDndLocation & {
+        mode: VireoDndMode;
+        accepted: boolean;
+    }) | null;
+};
+export type VireoDndResponderProvided = Pick<ResponderProvided, "announce">;
+export type VireoDndProviderProps = Pick<DragDropContextProps, "autoScrollerOptions" | "dragHandleUsageInstructions" | "enableDefaultSensors" | "nonce" | "sensors"> & {
+    children?: ReactNode;
+    onBeforeCapture?: (event: {
+        draggable: VireoDraggableId;
+    }) => void;
+    onBeforeDragStart?: (event: VireoDndDragStart) => void;
+    onDragStart?: (event: VireoDndDragStart, provided: VireoDndResponderProvided) => void;
+    onDragUpdate?: (event: VireoDndDragUpdate, provided: VireoDndResponderProvided) => void;
+    onDragEnd: (result: VireoDndDragEndResult, provided: VireoDndResponderProvided) => void;
+};
+export {};

package/dist/integrations/hello-pangea-dnd/types/dnd.types.js

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

package/dist/integrations/hello-pangea-dnd/utils/dndIdCodec.d.ts

@@ -0,0 +1,2 @@
+export declare function encodeDndIdentifier(identifier: unknown, componentName: string): string;
+export declare function decodeDndIdentifier<TIdentifier>(encoded: string): TIdentifier;

package/dist/integrations/hello-pangea-dnd/utils/dndIdCodec.js

@@ -0,0 +1,60 @@
+const IDENTIFIER_PREFIX = "vireo-dnd:";
+function normalizeJsonValue(value, path, seen) {
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return value;
+    if (typeof value === "number") {
+        if (!Number.isFinite(value))
+            throw new TypeError(`Vireo DnD identifier at ${path} contains a non-finite number.`);
+        return value;
+    }
+    if (typeof value !== "object") {
+        throw new TypeError(`Vireo DnD identifier at ${path} contains unsupported ${typeof value} data.`);
+    }
+    if (seen.has(value))
+        throw new TypeError(`Vireo DnD identifier at ${path} contains a circular reference.`);
+    seen.add(value);
+    try {
+        if (Array.isArray(value))
+            return value.map((entry, index) => normalizeJsonValue(entry, `${path}[${index}]`, seen));
+        const prototype = Object.getPrototypeOf(value);
+        if (prototype !== Object.prototype && prototype !== null) {
+            throw new TypeError(`Vireo DnD identifier at ${path} must contain only plain objects and arrays.`);
+        }
+        return Object.fromEntries(Object.keys(value)
+            .sort()
+            .map(key => [key, normalizeJsonValue(value[key], `${path}.${key}`, seen)]));
+    }
+    finally {
+        seen.delete(value);
+    }
+}
+export function encodeDndIdentifier(identifier, componentName) {
+    const normalized = normalizeJsonValue(identifier, componentName, new Set());
+    if (normalized === null || Array.isArray(normalized) || typeof normalized !== "object") {
+        throw new TypeError(`${componentName} requires an object identifier.`);
+    }
+    if (typeof normalized.type !== "string" || normalized.type.trim() === "") {
+        throw new TypeError(`${componentName} requires an identifier with a non-empty string "type".`);
+    }
+    return `${IDENTIFIER_PREFIX}${JSON.stringify(normalized)}`;
+}
+export function decodeDndIdentifier(encoded) {
+    if (!encoded.startsWith(IDENTIFIER_PREFIX))
+        throw new TypeError("Received an invalid Vireo DnD identifier.");
+    let parsed;
+    try {
+        parsed = JSON.parse(encoded.slice(IDENTIFIER_PREFIX.length));
+    }
+    catch {
+        throw new TypeError("Received a malformed Vireo DnD identifier.");
+    }
+    const normalized = normalizeJsonValue(parsed, "decoded identifier", new Set());
+    if (normalized === null ||
+        Array.isArray(normalized) ||
+        typeof normalized !== "object" ||
+        typeof normalized.type !== "string" ||
+        normalized.type.trim() === "") {
+        throw new TypeError('Received a Vireo DnD identifier without a non-empty string "type".');
+    }
+    return normalized;
+}