@skdx/react 0.26.0

package/dist/context-menu/types.d.cts

@@ -0,0 +1,191 @@
+import type * as React from 'react';
+import type { MenuSubContentProps, MenuSubProps, MenuSubTriggerProps } from '../utils/menuSub.cjs';
+import type { PortalProps } from '../utils/portal.cjs';
+import type { PrimitivePropsWithRef } from '../utils/primitive.cjs';
+import type { FocusOutsideEvent, InteractOutsideEvent } from '../utils/useDismiss.cjs';
+/** @internal Viewport coordinates of the triggering `contextmenu` event. Not part of the public API. */
+export interface Point {
+    x: number;
+    y: number;
+}
+/** @internal Shared state distributed from {@link ContextMenu} to its parts via context. Not part of the public API. */
+export interface ContextMenuContextValue {
+    triggerRef: React.RefObject<HTMLDivElement | null>;
+    contentRef: React.RefObject<HTMLDivElement | null>;
+    contentId: string;
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    point: Point;
+    setPoint: (point: Point) => void;
+}
+/** Props for the {@link ContextMenu} root. */
+export interface ContextMenuProps {
+    /**
+     * The trigger region and portal — the menu's own DOM (content, items) is
+     * rendered by {@link ContextMenuPortal} elsewhere.
+     * @default undefined — renders nothing if omitted.
+     */
+    children?: React.ReactNode;
+    /**
+     * Whether the menu is open, for controlled usage. Pair with `onOpenChange`.
+     * @default undefined — uncontrolled, tracks its own open state internally.
+     */
+    open?: boolean;
+    /**
+     * Whether the menu is initially open, for uncontrolled usage. There is no
+     * pointer event to position it at, so it opens at the viewport's top-left
+     * corner — mainly useful for tests, docs demos, and exit-animation work.
+     * @default false
+     */
+    defaultOpen?: boolean;
+    /**
+     * Fires with the new open state whenever the menu opens or closes, controlled or not.
+     * @default undefined — no-op if omitted.
+     */
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * Fires with the new open state once the change has finished on screen —
+     * after `ContextMenuContent`'s enter or exit animation ends, or as soon as it has
+     * settled when the panel declares no animation. Use it for work that must not race
+     * the transition; use `onOpenChange` for work that must not wait for it.
+     * @default undefined — no-op if omitted.
+     */
+    onOpenChangeComplete?: (open: boolean) => void;
+}
+/** Props for {@link ContextMenuTrigger}, the region that opens the menu on right-click/long-press. */
+export interface ContextMenuTriggerProps extends PrimitivePropsWithRef<'div'> {
+    /**
+     * Disables the context menu for this region, letting the native browser context menu through.
+     * @default false
+     */
+    disabled?: boolean;
+}
+/** Props for {@link ContextMenuPortal}, which teleports its children to `document.body`. */
+export interface ContextMenuPortalProps extends PortalProps {
+    /**
+     * Render the portal even while the menu is closed, instead of unmounting
+     * it. Useful for animation libraries that need the outgoing content
+     * present in the DOM during an exit transition.
+     * @default false
+     */
+    forceMount?: boolean;
+}
+/** Props for {@link ContextMenuContent}, the menu panel positioned at the pointer. */
+export interface ContextMenuContentProps extends PrimitivePropsWithRef<'div'> {
+    /**
+     * Keep this panel mounted even while the menu is closed. Useful for
+     * animation libraries that need the outgoing panel present in the DOM
+     * during an exit transition.
+     * @default false
+     */
+    forceMount?: boolean;
+    /**
+     * Whether Up/Down arrow-key navigation wraps from the last item back to
+     * the first (and vice versa).
+     * @default true
+     */
+    loop?: boolean;
+    /**
+     * Minimum distance (px) kept between the menu and the viewport edge when
+     * clamping its position so it never overflows the screen.
+     * @default 8
+     */
+    collisionPadding?: number;
+    /**
+     * Fires when Escape is pressed while the menu is open. Call `event.preventDefault()` to stop it from closing.
+     * @default undefined — no-op if omitted.
+     */
+    onEscapeKeyDown?: (event: KeyboardEvent) => void;
+    /**
+     * Fires on pointer-down outside the content. Call `event.preventDefault()` to stop the menu from closing.
+     * @default undefined — no-op if omitted.
+     */
+    onPointerDownOutside?: (event: PointerEvent) => void;
+    /**
+     * Fires when focus moves to an element outside the content. Call `event.preventDefault()` to stop the menu from closing. Receives a cancelable stand-in carrying the original `focusin` as its `detail`, since `focusin` itself cannot be canceled.
+     * @default undefined — no-op if omitted.
+     */
+    onFocusOutside?: (event: FocusOutsideEvent) => void;
+    /**
+     * Fires for either kind of outside interaction — pointer-down or focus — immediately before the specific handler above and with the same event, so one `event.preventDefault()` here vetoes the dismissal whichever way it was triggered.
+     * @default undefined — no-op if omitted.
+     */
+    onInteractOutside?: (event: InteractOutsideEvent) => void;
+}
+/** Props for a single {@link ContextMenuItem}. */
+export interface ContextMenuItemProps extends Omit<PrimitivePropsWithRef<'div'>, 'onSelect'> {
+    /**
+     * Excludes the item from roving-focus navigation and blocks selection.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Called when the item is activated. `event.preventDefault()` keeps the menu open.
+     * @default undefined — no-op if omitted.
+     */
+    onSelect?: (event: Event) => void;
+}
+/** Props for {@link ContextMenuCheckboxItem}, a toggleable menu item. */
+export interface ContextMenuCheckboxItemProps extends ContextMenuItemProps {
+    /**
+     * Whether the item is checked, mirroring the checkbox's checked/unchecked visual state.
+     * @default false
+     */
+    checked?: boolean;
+    /**
+     * Fires with the new checked state when the item is selected.
+     * @default undefined — no-op if omitted.
+     */
+    onCheckedChange?: (checked: boolean) => void;
+}
+/** @internal Shared selected-value state distributed from {@link ContextMenuRadioGroup} to its `ContextMenuRadioItem`s via context. Not part of the public API. */
+export interface MenuRadioGroupContextValue {
+    value?: string;
+    onValueChange?: (value: string) => void;
+}
+/** Props for {@link ContextMenuRadioGroup}, a container coordinating a set of mutually-exclusive `ContextMenuRadioItem`s. */
+export interface ContextMenuRadioGroupProps extends PrimitivePropsWithRef<'div'> {
+    /**
+     * Currently selected item's value, compared against each `ContextMenuRadioItem`'s own `value`.
+     * @default undefined — no item is selected.
+     */
+    value?: string;
+    /**
+     * Fires with the new value when a `ContextMenuRadioItem` in this group is selected.
+     * @default undefined — no-op if omitted.
+     */
+    onValueChange?: (value: string) => void;
+}
+/** Props for a single {@link ContextMenuRadioItem} inside a `ContextMenuRadioGroup`. */
+export interface ContextMenuRadioItemProps extends ContextMenuItemProps {
+    /** Unique identifier compared against the group's selected `value`. */
+    value: string;
+}
+/** Props for {@link ContextMenuItemIndicator}, the checked-state glyph inside a checkbox/radio item. */
+export interface ContextMenuItemIndicatorProps extends PrimitivePropsWithRef<'span'> {
+    /**
+     * Render even while unchecked, instead of unmounting. Useful for
+     * animation libraries that need the outgoing indicator present in the DOM
+     * during an exit transition.
+     * @default false
+     */
+    forceMount?: boolean;
+}
+/** Props for {@link ContextMenuGroup}, a semantic grouping of related items. */
+export interface ContextMenuGroupProps extends PrimitivePropsWithRef<'div'> {
+}
+/** Props for {@link ContextMenuLabel}, a non-interactive heading for a group of items. */
+export interface ContextMenuLabelProps extends PrimitivePropsWithRef<'div'> {
+}
+/** Props for {@link ContextMenuSeparator}, a visual divider between items or groups. */
+export interface ContextMenuSeparatorProps extends PrimitivePropsWithRef<'div'> {
+}
+/** Props for {@link ContextMenuSub}, the root of a nested submenu. */
+export interface ContextMenuSubProps extends MenuSubProps {
+}
+/** Props for {@link ContextMenuSubTrigger}, the parent-menu item that opens a submenu and anchors it. */
+export interface ContextMenuSubTriggerProps extends MenuSubTriggerProps {
+}
+/** Props for {@link ContextMenuSubContent}, the submenu's floating panel. */
+export interface ContextMenuSubContentProps extends MenuSubContentProps {
+}

package/dist/context-menu/types.d.ts

@@ -0,0 +1,191 @@
+import type * as React from 'react';
+import type { MenuSubContentProps, MenuSubProps, MenuSubTriggerProps } from '../utils/menuSub.js';
+import type { PortalProps } from '../utils/portal.js';
+import type { PrimitivePropsWithRef } from '../utils/primitive.js';
+import type { FocusOutsideEvent, InteractOutsideEvent } from '../utils/useDismiss.js';
+/** @internal Viewport coordinates of the triggering `contextmenu` event. Not part of the public API. */
+export interface Point {
+    x: number;
+    y: number;
+}
+/** @internal Shared state distributed from {@link ContextMenu} to its parts via context. Not part of the public API. */
+export interface ContextMenuContextValue {
+    triggerRef: React.RefObject<HTMLDivElement | null>;
+    contentRef: React.RefObject<HTMLDivElement | null>;
+    contentId: string;
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    point: Point;
+    setPoint: (point: Point) => void;
+}
+/** Props for the {@link ContextMenu} root. */
+export interface ContextMenuProps {
+    /**
+     * The trigger region and portal — the menu's own DOM (content, items) is
+     * rendered by {@link ContextMenuPortal} elsewhere.
+     * @default undefined — renders nothing if omitted.
+     */
+    children?: React.ReactNode;
+    /**
+     * Whether the menu is open, for controlled usage. Pair with `onOpenChange`.
+     * @default undefined — uncontrolled, tracks its own open state internally.
+     */
+    open?: boolean;
+    /**
+     * Whether the menu is initially open, for uncontrolled usage. There is no
+     * pointer event to position it at, so it opens at the viewport's top-left
+     * corner — mainly useful for tests, docs demos, and exit-animation work.
+     * @default false
+     */
+    defaultOpen?: boolean;
+    /**
+     * Fires with the new open state whenever the menu opens or closes, controlled or not.
+     * @default undefined — no-op if omitted.
+     */
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * Fires with the new open state once the change has finished on screen —
+     * after `ContextMenuContent`'s enter or exit animation ends, or as soon as it has
+     * settled when the panel declares no animation. Use it for work that must not race
+     * the transition; use `onOpenChange` for work that must not wait for it.
+     * @default undefined — no-op if omitted.
+     */
+    onOpenChangeComplete?: (open: boolean) => void;
+}
+/** Props for {@link ContextMenuTrigger}, the region that opens the menu on right-click/long-press. */
+export interface ContextMenuTriggerProps extends PrimitivePropsWithRef<'div'> {
+    /**
+     * Disables the context menu for this region, letting the native browser context menu through.
+     * @default false
+     */
+    disabled?: boolean;
+}
+/** Props for {@link ContextMenuPortal}, which teleports its children to `document.body`. */
+export interface ContextMenuPortalProps extends PortalProps {
+    /**
+     * Render the portal even while the menu is closed, instead of unmounting
+     * it. Useful for animation libraries that need the outgoing content
+     * present in the DOM during an exit transition.
+     * @default false
+     */
+    forceMount?: boolean;
+}
+/** Props for {@link ContextMenuContent}, the menu panel positioned at the pointer. */
+export interface ContextMenuContentProps extends PrimitivePropsWithRef<'div'> {
+    /**
+     * Keep this panel mounted even while the menu is closed. Useful for
+     * animation libraries that need the outgoing panel present in the DOM
+     * during an exit transition.
+     * @default false
+     */
+    forceMount?: boolean;
+    /**
+     * Whether Up/Down arrow-key navigation wraps from the last item back to
+     * the first (and vice versa).
+     * @default true
+     */
+    loop?: boolean;
+    /**
+     * Minimum distance (px) kept between the menu and the viewport edge when
+     * clamping its position so it never overflows the screen.
+     * @default 8
+     */
+    collisionPadding?: number;
+    /**
+     * Fires when Escape is pressed while the menu is open. Call `event.preventDefault()` to stop it from closing.
+     * @default undefined — no-op if omitted.
+     */
+    onEscapeKeyDown?: (event: KeyboardEvent) => void;
+    /**
+     * Fires on pointer-down outside the content. Call `event.preventDefault()` to stop the menu from closing.
+     * @default undefined — no-op if omitted.
+     */
+    onPointerDownOutside?: (event: PointerEvent) => void;
+    /**
+     * Fires when focus moves to an element outside the content. Call `event.preventDefault()` to stop the menu from closing. Receives a cancelable stand-in carrying the original `focusin` as its `detail`, since `focusin` itself cannot be canceled.
+     * @default undefined — no-op if omitted.
+     */
+    onFocusOutside?: (event: FocusOutsideEvent) => void;
+    /**
+     * Fires for either kind of outside interaction — pointer-down or focus — immediately before the specific handler above and with the same event, so one `event.preventDefault()` here vetoes the dismissal whichever way it was triggered.
+     * @default undefined — no-op if omitted.
+     */
+    onInteractOutside?: (event: InteractOutsideEvent) => void;
+}
+/** Props for a single {@link ContextMenuItem}. */
+export interface ContextMenuItemProps extends Omit<PrimitivePropsWithRef<'div'>, 'onSelect'> {
+    /**
+     * Excludes the item from roving-focus navigation and blocks selection.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Called when the item is activated. `event.preventDefault()` keeps the menu open.
+     * @default undefined — no-op if omitted.
+     */
+    onSelect?: (event: Event) => void;
+}
+/** Props for {@link ContextMenuCheckboxItem}, a toggleable menu item. */
+export interface ContextMenuCheckboxItemProps extends ContextMenuItemProps {
+    /**
+     * Whether the item is checked, mirroring the checkbox's checked/unchecked visual state.
+     * @default false
+     */
+    checked?: boolean;
+    /**
+     * Fires with the new checked state when the item is selected.
+     * @default undefined — no-op if omitted.
+     */
+    onCheckedChange?: (checked: boolean) => void;
+}
+/** @internal Shared selected-value state distributed from {@link ContextMenuRadioGroup} to its `ContextMenuRadioItem`s via context. Not part of the public API. */
+export interface MenuRadioGroupContextValue {
+    value?: string;
+    onValueChange?: (value: string) => void;
+}
+/** Props for {@link ContextMenuRadioGroup}, a container coordinating a set of mutually-exclusive `ContextMenuRadioItem`s. */
+export interface ContextMenuRadioGroupProps extends PrimitivePropsWithRef<'div'> {
+    /**
+     * Currently selected item's value, compared against each `ContextMenuRadioItem`'s own `value`.
+     * @default undefined — no item is selected.
+     */
+    value?: string;
+    /**
+     * Fires with the new value when a `ContextMenuRadioItem` in this group is selected.
+     * @default undefined — no-op if omitted.
+     */
+    onValueChange?: (value: string) => void;
+}
+/** Props for a single {@link ContextMenuRadioItem} inside a `ContextMenuRadioGroup`. */
+export interface ContextMenuRadioItemProps extends ContextMenuItemProps {
+    /** Unique identifier compared against the group's selected `value`. */
+    value: string;
+}
+/** Props for {@link ContextMenuItemIndicator}, the checked-state glyph inside a checkbox/radio item. */
+export interface ContextMenuItemIndicatorProps extends PrimitivePropsWithRef<'span'> {
+    /**
+     * Render even while unchecked, instead of unmounting. Useful for
+     * animation libraries that need the outgoing indicator present in the DOM
+     * during an exit transition.
+     * @default false
+     */
+    forceMount?: boolean;
+}
+/** Props for {@link ContextMenuGroup}, a semantic grouping of related items. */
+export interface ContextMenuGroupProps extends PrimitivePropsWithRef<'div'> {
+}
+/** Props for {@link ContextMenuLabel}, a non-interactive heading for a group of items. */
+export interface ContextMenuLabelProps extends PrimitivePropsWithRef<'div'> {
+}
+/** Props for {@link ContextMenuSeparator}, a visual divider between items or groups. */
+export interface ContextMenuSeparatorProps extends PrimitivePropsWithRef<'div'> {
+}
+/** Props for {@link ContextMenuSub}, the root of a nested submenu. */
+export interface ContextMenuSubProps extends MenuSubProps {
+}
+/** Props for {@link ContextMenuSubTrigger}, the parent-menu item that opens a submenu and anchors it. */
+export interface ContextMenuSubTriggerProps extends MenuSubTriggerProps {
+}
+/** Props for {@link ContextMenuSubContent}, the submenu's floating panel. */
+export interface ContextMenuSubContentProps extends MenuSubContentProps {
+}

package/dist/data-list/DataList.cjs

@@ -0,0 +1 @@
+"use strict";var k=Object.create;var s=Object.defineProperty;var v=Object.getOwnPropertyDescriptor;var w=Object.getOwnPropertyNames;var H=Object.getPrototypeOf,M=Object.prototype.hasOwnProperty;var S=(t,a)=>{for(var e in a)s(t,e,{get:a[e],enumerable:!0})},L=(t,a,e,o)=>{if(a&&typeof a=="object"||typeof a=="function")for(let r of w(a))!M.call(t,r)&&r!==e&&s(t,r,{get:()=>a[r],enumerable:!(o=v(a,r))||o.enumerable});return t};var m=(t,a,e)=>(e=t!=null?k(H(t)):{},L(a||!t||!t.__esModule?s(e,"default",{value:t,enumerable:!0}):e,t)),h=t=>L(s({},"__esModule",{value:!0}),t);var z={};S(z,{DataList:()=>c,DataListItem:()=>i,DataListLabel:()=>p,DataListValue:()=>l});module.exports=h(z);var f=m(require("react"),1),D=require("../utils/part.cjs"),d=require("../utils/slot.cjs"),n=require("react/jsx-runtime"),c=f.forwardRef(({asChild:t,orientation:a="horizontal",...e},o)=>(0,n.jsx)(t?d.Slot:"dl",{"data-orientation":a,...e,...(0,D.skdxPart)("data-list","root",e.className),ref:o}));c.displayName="DataList";var y=m(require("react"),1),P=require("../utils/part.cjs"),R=require("../utils/primitive.cjs"),x=require("react/jsx-runtime"),i=y.forwardRef((t,a)=>(0,x.jsx)(R.Primitive.div,{...t,...(0,P.skdxPart)("data-list","item",t.className),ref:a}));i.displayName="DataListItem";var N=m(require("react"),1),b=require("../utils/part.cjs"),E=require("../utils/slot.cjs"),T=require("react/jsx-runtime"),p=N.forwardRef(({asChild:t,...a},e)=>(0,T.jsx)(t?E.Slot:"dt",{...a,...(0,b.skdxPart)("data-list","label",a.className),ref:e}));p.displayName="DataListLabel";var u=m(require("react"),1),C=require("../utils/part.cjs"),I=require("../utils/slot.cjs"),V=require("react/jsx-runtime"),l=u.forwardRef(({asChild:t,...a},e)=>(0,V.jsx)(t?I.Slot:"dd",{...a,...(0,C.skdxPart)("data-list","value",a.className),ref:e}));l.displayName="DataListValue";0&&(module.exports={DataList,DataListItem,DataListLabel,DataListValue});

package/dist/data-list/DataList.d.cts

@@ -0,0 +1,26 @@
+import * as React from 'react';
+import type { DataListProps } from './types.cjs';
+/**
+ * Root of a key/value list. Renders a real `<dl>`, so every
+ * {@link DataListLabel} (`<dt>`) is associated with the
+ * {@link DataListValue} (`<dd>`) that follows it — the association assistive
+ * technology reads, and the one a `<div>`-based "definition grid" throws away.
+ *
+ * The only prop is `orientation`, and it is emitted as `data-orientation`
+ * and nothing more: this library ships no layout CSS, so the pairs are laid
+ * out entirely by your stylesheet selecting on that attribute.
+ *
+ * Behaviourless by design — there is no state, no context and no keyboard
+ * interaction here. The value of this family is the markup it guarantees.
+ *
+ * @example
+ * ```tsx
+ * <DataList orientation="horizontal">
+ *   <DataListItem>
+ *     <DataListLabel>Status</DataListLabel>
+ *     <DataListValue>Active</DataListValue>
+ *   </DataListItem>
+ * </DataList>
+ * ```
+ */
+export declare const DataList: React.ForwardRefExoticComponent<Omit<DataListProps, "ref"> & React.RefAttributes<HTMLDListElement>>;

package/dist/data-list/DataList.d.ts

@@ -0,0 +1,26 @@
+import * as React from 'react';
+import type { DataListProps } from './types.js';
+/**
+ * Root of a key/value list. Renders a real `<dl>`, so every
+ * {@link DataListLabel} (`<dt>`) is associated with the
+ * {@link DataListValue} (`<dd>`) that follows it — the association assistive
+ * technology reads, and the one a `<div>`-based "definition grid" throws away.
+ *
+ * The only prop is `orientation`, and it is emitted as `data-orientation`
+ * and nothing more: this library ships no layout CSS, so the pairs are laid
+ * out entirely by your stylesheet selecting on that attribute.
+ *
+ * Behaviourless by design — there is no state, no context and no keyboard
+ * interaction here. The value of this family is the markup it guarantees.
+ *
+ * @example
+ * ```tsx
+ * <DataList orientation="horizontal">
+ *   <DataListItem>
+ *     <DataListLabel>Status</DataListLabel>
+ *     <DataListValue>Active</DataListValue>
+ *   </DataListItem>
+ * </DataList>
+ * ```
+ */
+export declare const DataList: React.ForwardRefExoticComponent<Omit<DataListProps, "ref"> & React.RefAttributes<HTMLDListElement>>;

package/dist/data-list/DataList.js

@@ -0,0 +1 @@
+import*as r from"react";import{skdxPart as f}from"../utils/part.js";import{Slot as D}from"../utils/slot.js";import{jsx as c}from"react/jsx-runtime";var d=r.forwardRef(({asChild:a,orientation:t="horizontal",...e},o)=>c(a?D:"dl",{"data-orientation":t,...e,...f("data-list","root",e.className),ref:o}));d.displayName="DataList";import*as s from"react";import{skdxPart as n}from"../utils/part.js";import{Primitive as y}from"../utils/primitive.js";import{jsx as P}from"react/jsx-runtime";var m=s.forwardRef((a,t)=>P(y.div,{...a,...n("data-list","item",a.className),ref:t}));m.displayName="DataListItem";import*as i from"react";import{skdxPart as R}from"../utils/part.js";import{Slot as x}from"../utils/slot.js";import{jsx as N}from"react/jsx-runtime";var p=i.forwardRef(({asChild:a,...t},e)=>N(a?x:"dt",{...t,...R("data-list","label",t.className),ref:e}));p.displayName="DataListLabel";import*as l from"react";import{skdxPart as b}from"../utils/part.js";import{Slot as E}from"../utils/slot.js";import{jsx as T}from"react/jsx-runtime";var L=l.forwardRef(({asChild:a,...t},e)=>T(a?E:"dd",{...t,...b("data-list","value",t.className),ref:e}));L.displayName="DataListValue";export{d as DataList,m as DataListItem,p as DataListLabel,L as DataListValue};

package/dist/data-list/DataListItem.d.cts

@@ -0,0 +1,26 @@
+import * as React from 'react';
+import type { DataListItemProps } from './types.cjs';
+/**
+ * Optional grouping wrapper around one {@link DataListLabel} /
+ * {@link DataListValue} pair. Renders a bare `<div>` with **no role and no
+ * ARIA of its own** — deliberately.
+ *
+ * HTML allows exactly one wrapper inside a `<dl>`: a plain `<div>` holding the
+ * `<dt>`/`<dd>` group. Because that div stays generic, the `dl` → `dt`/`dd`
+ * association survives it. Give this element a role, or swap it for anything
+ * that carries one, and the list stops being a description list to assistive
+ * technology.
+ *
+ * It is a styling handle, so keep it one: if you need the pairs to line up in
+ * a grid, put `display: contents` on this element and lay the `<dt>`/`<dd>`
+ * out as grid items of the `<dl>` itself.
+ *
+ * @example
+ * ```tsx
+ * <DataListItem style={{ display: 'contents' }}>
+ *   <DataListLabel>Region</DataListLabel>
+ *   <DataListValue>eu-west-1</DataListValue>
+ * </DataListItem>
+ * ```
+ */
+export declare const DataListItem: React.ForwardRefExoticComponent<Omit<DataListItemProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/data-list/DataListItem.d.ts

@@ -0,0 +1,26 @@
+import * as React from 'react';
+import type { DataListItemProps } from './types.js';
+/**
+ * Optional grouping wrapper around one {@link DataListLabel} /
+ * {@link DataListValue} pair. Renders a bare `<div>` with **no role and no
+ * ARIA of its own** — deliberately.
+ *
+ * HTML allows exactly one wrapper inside a `<dl>`: a plain `<div>` holding the
+ * `<dt>`/`<dd>` group. Because that div stays generic, the `dl` → `dt`/`dd`
+ * association survives it. Give this element a role, or swap it for anything
+ * that carries one, and the list stops being a description list to assistive
+ * technology.
+ *
+ * It is a styling handle, so keep it one: if you need the pairs to line up in
+ * a grid, put `display: contents` on this element and lay the `<dt>`/`<dd>`
+ * out as grid items of the `<dl>` itself.
+ *
+ * @example
+ * ```tsx
+ * <DataListItem style={{ display: 'contents' }}>
+ *   <DataListLabel>Region</DataListLabel>
+ *   <DataListValue>eu-west-1</DataListValue>
+ * </DataListItem>
+ * ```
+ */
+export declare const DataListItem: React.ForwardRefExoticComponent<Omit<DataListItemProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/data-list/DataListLabel.d.cts

@@ -0,0 +1,16 @@
+import * as React from 'react';
+import type { DataListLabelProps } from './types.cjs';
+/**
+ * The key half of a pair. Renders a `<dt>`, which is what associates this
+ * term with the {@link DataListValue} (`<dd>`) that follows it. A `<span>` or
+ * a `<div>` with a class name looks identical and conveys nothing.
+ *
+ * Do not put a `<label>` here: nothing in a data list is a form control, and
+ * `<label>` without a control is a name with nothing to name.
+ *
+ * @example
+ * ```tsx
+ * <DataListLabel>Created</DataListLabel>
+ * ```
+ */
+export declare const DataListLabel: React.ForwardRefExoticComponent<Omit<DataListLabelProps, "ref"> & React.RefAttributes<HTMLElement>>;

package/dist/data-list/DataListLabel.d.ts

@@ -0,0 +1,16 @@
+import * as React from 'react';
+import type { DataListLabelProps } from './types.js';
+/**
+ * The key half of a pair. Renders a `<dt>`, which is what associates this
+ * term with the {@link DataListValue} (`<dd>`) that follows it. A `<span>` or
+ * a `<div>` with a class name looks identical and conveys nothing.
+ *
+ * Do not put a `<label>` here: nothing in a data list is a form control, and
+ * `<label>` without a control is a name with nothing to name.
+ *
+ * @example
+ * ```tsx
+ * <DataListLabel>Created</DataListLabel>
+ * ```
+ */
+export declare const DataListLabel: React.ForwardRefExoticComponent<Omit<DataListLabelProps, "ref"> & React.RefAttributes<HTMLElement>>;

package/dist/data-list/DataListValue.d.cts

@@ -0,0 +1,18 @@
+import * as React from 'react';
+import type { DataListValueProps } from './types.cjs';
+/**
+ * The value half of a pair. Renders a `<dd>`, describing the `<dt>` that
+ * precedes it.
+ *
+ * One `<dt>` may be followed by several `<dd>`s — that is how you express a
+ * key with multiple values (three email addresses, four tags) without
+ * repeating the label.
+ *
+ * @example
+ * ```tsx
+ * <DataListLabel>Owners</DataListLabel>
+ * <DataListValue>Ada</DataListValue>
+ * <DataListValue>Grace</DataListValue>
+ * ```
+ */
+export declare const DataListValue: React.ForwardRefExoticComponent<Omit<DataListValueProps, "ref"> & React.RefAttributes<HTMLElement>>;

package/dist/data-list/DataListValue.d.ts

@@ -0,0 +1,18 @@
+import * as React from 'react';
+import type { DataListValueProps } from './types.js';
+/**
+ * The value half of a pair. Renders a `<dd>`, describing the `<dt>` that
+ * precedes it.
+ *
+ * One `<dt>` may be followed by several `<dd>`s — that is how you express a
+ * key with multiple values (three email addresses, four tags) without
+ * repeating the label.
+ *
+ * @example
+ * ```tsx
+ * <DataListLabel>Owners</DataListLabel>
+ * <DataListValue>Ada</DataListValue>
+ * <DataListValue>Grace</DataListValue>
+ * ```
+ */
+export declare const DataListValue: React.ForwardRefExoticComponent<Omit<DataListValueProps, "ref"> & React.RefAttributes<HTMLElement>>;

package/dist/data-list/index.d.cts

@@ -0,0 +1,5 @@
+export * from './DataList.cjs';
+export { DataListItem } from './DataListItem.cjs';
+export { DataListLabel } from './DataListLabel.cjs';
+export { DataListValue } from './DataListValue.cjs';
+export type { DataListProps, DataListItemProps, DataListLabelProps, DataListValueProps, DataListOrientation, } from './types.cjs';

package/dist/data-list/index.d.ts

@@ -0,0 +1,5 @@
+export * from './DataList.js';
+export { DataListItem } from './DataListItem.js';
+export { DataListLabel } from './DataListLabel.js';
+export { DataListValue } from './DataListValue.js';
+export type { DataListProps, DataListItemProps, DataListLabelProps, DataListValueProps, DataListOrientation, } from './types.js';

package/dist/data-list/types.d.cts

@@ -0,0 +1,27 @@
+import type { PrimitivePropsWithRef } from '../utils/primitive.cjs';
+/** Orientation of the label/value pairs, emitted as `data-orientation` for the brand layer to lay out. */
+export type DataListOrientation = 'horizontal' | 'vertical';
+/** Props for the {@link DataList} root, a `<dl>`. */
+export interface DataListProps extends PrimitivePropsWithRef<'dl'> {
+    /**
+     * How each label/value pair reads: `'horizontal'` puts the value beside its
+     * label, `'vertical'` stacks the value under it. Emitted as
+     * `data-orientation` on the root and nothing else — this library ships no
+     * layout CSS, so the value only changes what your stylesheet can select on,
+     * never how the list renders on its own.
+     * @default 'horizontal' — `data-orientation="horizontal"`; the label/value pair reads as one row.
+     */
+    orientation?: DataListOrientation;
+}
+/**
+ * Props for {@link DataListItem}, the optional `<div>` grouping one
+ * `DataListLabel` with its `DataListValue`.
+ */
+export interface DataListItemProps extends PrimitivePropsWithRef<'div'> {
+}
+/** Props for {@link DataListLabel}, the key half of a pair — a `<dt>`. */
+export interface DataListLabelProps extends PrimitivePropsWithRef<'dt'> {
+}
+/** Props for {@link DataListValue}, the value half of a pair — a `<dd>`. */
+export interface DataListValueProps extends PrimitivePropsWithRef<'dd'> {
+}

package/dist/data-list/types.d.ts

@@ -0,0 +1,27 @@
+import type { PrimitivePropsWithRef } from '../utils/primitive.js';
+/** Orientation of the label/value pairs, emitted as `data-orientation` for the brand layer to lay out. */
+export type DataListOrientation = 'horizontal' | 'vertical';
+/** Props for the {@link DataList} root, a `<dl>`. */
+export interface DataListProps extends PrimitivePropsWithRef<'dl'> {
+    /**
+     * How each label/value pair reads: `'horizontal'` puts the value beside its
+     * label, `'vertical'` stacks the value under it. Emitted as
+     * `data-orientation` on the root and nothing else — this library ships no
+     * layout CSS, so the value only changes what your stylesheet can select on,
+     * never how the list renders on its own.
+     * @default 'horizontal' — `data-orientation="horizontal"`; the label/value pair reads as one row.
+     */
+    orientation?: DataListOrientation;
+}
+/**
+ * Props for {@link DataListItem}, the optional `<div>` grouping one
+ * `DataListLabel` with its `DataListValue`.
+ */
+export interface DataListItemProps extends PrimitivePropsWithRef<'div'> {
+}
+/** Props for {@link DataListLabel}, the key half of a pair — a `<dt>`. */
+export interface DataListLabelProps extends PrimitivePropsWithRef<'dt'> {
+}
+/** Props for {@link DataListValue}, the value half of a pair — a `<dd>`. */
+export interface DataListValueProps extends PrimitivePropsWithRef<'dd'> {
+}

package/dist/date-field/DateField.cjs

@@ -0,0 +1 @@
+"use strict";var P=Object.create;var f=Object.defineProperty;var k=Object.getOwnPropertyDescriptor;var x=Object.getOwnPropertyNames;var H=Object.getPrototypeOf,b=Object.prototype.hasOwnProperty;var w=(e,t)=>{for(var a in t)f(e,a,{get:t[a],enumerable:!0})},C=(e,t,a,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of x(t))!b.call(e,s)&&s!==a&&f(e,s,{get:()=>t[s],enumerable:!(n=k(t,s))||n.enumerable});return e};var E=(e,t,a)=>(a=e!=null?P(H(e)):{},C(t||!e||!e.__esModule?f(a,"default",{value:e,enumerable:!0}):a,e)),N=e=>C(f({},"__esModule",{value:!0}),e);var L={};w(L,{DateField:()=>D});module.exports=N(L);var i=E(require("react"),1),l=require("../utils/dateSegments.cjs"),h=require("../utils/part.cjs"),v=require("../utils/segmentedField.cjs"),S=require("../utils/useControllableState.cjs"),V=require("react/jsx-runtime"),D=i.forwardRef(({value:e,defaultValue:t,onValueChange:a,granularity:n="day",hourCycle:s,locale:p,...g},T)=>{let r=(0,l.resolveHourCycle)(p,s),[u=null,y]=(0,S.useControllableState)({prop:e,defaultProp:t??null,onChange:a}),[R,c]=i.useState(()=>u?(0,l.dateToValues)(u,r):{}),F=o=>(0,l.isComplete)((0,l.buildSegments)({kind:"date",granularity:n,locale:p,hourCycle:r,values:o}))?(0,l.valuesToDate)(o,r):null,d=u?u.getTime():null;return i.useEffect(()=>{c(o=>{let m=F(o);return d===null?m===null?o:{}:m!==null&&m.getTime()===d?o:(0,l.dateToValues)(new Date(d),r)})},[d,r,n,p]),(0,V.jsx)(v.SegmentedField,{family:"date-field",kind:"date",granularity:n,locale:p,hourCycle:r,values:R,onValuesChange:o=>{c(o);let m=F(o);(m?m.getTime():null)!==d&&y(m)},formValue:u?(0,l.dateToFormValue)(u,n):null,onFormReset:()=>{y(t??null),c(t?(0,l.dateToValues)(t,r):{})},...g,...(0,h.skdxPart)("date-field","root",g.className),ref:T})});D.displayName="DateField";0&&(module.exports={DateField});