@skdx/react 0.26.0

package/dist/dropdown-menu/DropdownMenuSub.d.ts

@@ -0,0 +1,40 @@
+import { type MenuSubProps } from '../utils/menuSub.js';
+/**
+ * Root of a nested submenu inside `DropdownMenuContent`: owns the submenu's
+ * own open state and provides the popper anchor context its
+ * `DropdownMenuSubTrigger` / `DropdownMenuSubContent` position against.
+ * Renders no DOM element itself.
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenuContent>
+ *   <DropdownMenuItem>Edit</DropdownMenuItem>
+ *   <DropdownMenuSub>
+ *     <DropdownMenuSubTrigger>Share</DropdownMenuSubTrigger>
+ *     <DropdownMenuSubContent>
+ *       <DropdownMenuItem>Email</DropdownMenuItem>
+ *       <DropdownMenuItem>Copy link</DropdownMenuItem>
+ *     </DropdownMenuSubContent>
+ *   </DropdownMenuSub>
+ * </DropdownMenuContent>
+ * ```
+ */
+export declare function DropdownMenuSub(props: Omit<MenuSubProps, 'family'>): import("react").JSX.Element;
+export declare namespace DropdownMenuSub {
+    var displayName: string;
+}
+/**
+ * The parent-menu item that opens a submenu: `role="menuitem"` with
+ * `aria-haspopup="menu"`, `aria-expanded`, `aria-controls` and `data-state`.
+ * Opens on click, Enter, Space or ArrowRight — moving focus to the submenu's
+ * first item — and on hover, which leaves focus where it is.
+ */
+export declare const DropdownMenuSubTrigger: import("react").ForwardRefExoticComponent<Omit<import("../utils/menuSub.js").MenuSubTriggerProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+/**
+ * The submenu's floating panel: `role="menu"`, positioned against
+ * `DropdownMenuSubTrigger` (`side="end"`, `align="start"` by default) via
+ * the same popper layer as `DropdownMenuContent`. Owns its own vertical
+ * roving focus and typeahead; ArrowLeft and Escape close it and refocus the
+ * trigger, leaving the parent menu open.
+ */
+export declare const DropdownMenuSubContent: import("react").ForwardRefExoticComponent<Omit<import("../utils/menuSub.js").MenuSubContentProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;

package/dist/dropdown-menu/DropdownMenuTrigger.d.cts

@@ -0,0 +1,19 @@
+import * as React from 'react';
+import type { DropdownMenuTriggerProps } from './types.cjs';
+/**
+ * Button that opens the menu when clicked, or via Arrow Up/Down, and doubles
+ * as the positioning anchor for `DropdownMenuContent`. Sets
+ * `aria-haspopup="menu"`, `aria-expanded`, `aria-controls`, and
+ * `data-state` (`open`/`closed`).
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenu>
+ *   <DropdownMenuTrigger>Options</DropdownMenuTrigger>
+ *   <DropdownMenuPortal>
+ *     <DropdownMenuContent>…</DropdownMenuContent>
+ *   </DropdownMenuPortal>
+ * </DropdownMenu>
+ * ```
+ */
+export declare const DropdownMenuTrigger: React.ForwardRefExoticComponent<Omit<DropdownMenuTriggerProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;

package/dist/dropdown-menu/DropdownMenuTrigger.d.ts

@@ -0,0 +1,19 @@
+import * as React from 'react';
+import type { DropdownMenuTriggerProps } from './types.js';
+/**
+ * Button that opens the menu when clicked, or via Arrow Up/Down, and doubles
+ * as the positioning anchor for `DropdownMenuContent`. Sets
+ * `aria-haspopup="menu"`, `aria-expanded`, `aria-controls`, and
+ * `data-state` (`open`/`closed`).
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenu>
+ *   <DropdownMenuTrigger>Options</DropdownMenuTrigger>
+ *   <DropdownMenuPortal>
+ *     <DropdownMenuContent>…</DropdownMenuContent>
+ *   </DropdownMenuPortal>
+ * </DropdownMenu>
+ * ```
+ */
+export declare const DropdownMenuTrigger: React.ForwardRefExoticComponent<Omit<DropdownMenuTriggerProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;

package/dist/dropdown-menu/index.d.cts

@@ -0,0 +1,14 @@
+export * from './DropdownMenu.cjs';
+export { DropdownMenuTrigger } from './DropdownMenuTrigger.cjs';
+export { DropdownMenuPortal } from './DropdownMenuPortal.cjs';
+export { DropdownMenuContent } from './DropdownMenuContent.cjs';
+export { DropdownMenuItem } from './DropdownMenuItem.cjs';
+export { DropdownMenuCheckboxItem } from './DropdownMenuCheckboxItem.cjs';
+export { DropdownMenuRadioGroup } from './DropdownMenuRadioGroup.cjs';
+export { DropdownMenuRadioItem } from './DropdownMenuRadioItem.cjs';
+export { DropdownMenuItemIndicator } from './DropdownMenuItemIndicator.cjs';
+export { DropdownMenuGroup } from './DropdownMenuGroup.cjs';
+export { DropdownMenuLabel } from './DropdownMenuLabel.cjs';
+export { DropdownMenuSeparator } from './DropdownMenuSeparator.cjs';
+export { DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger } from './DropdownMenuSub.cjs';
+export type { DropdownMenuProps, DropdownMenuTriggerProps, DropdownMenuPortalProps, DropdownMenuContentProps, DropdownMenuItemProps, DropdownMenuCheckboxItemProps, DropdownMenuRadioGroupProps, DropdownMenuRadioItemProps, DropdownMenuItemIndicatorProps, DropdownMenuGroupProps, DropdownMenuLabelProps, DropdownMenuSeparatorProps, DropdownMenuSubProps, DropdownMenuSubTriggerProps, DropdownMenuSubContentProps, } from './types.cjs';

package/dist/dropdown-menu/index.d.ts

@@ -0,0 +1,14 @@
+export * from './DropdownMenu.js';
+export { DropdownMenuTrigger } from './DropdownMenuTrigger.js';
+export { DropdownMenuPortal } from './DropdownMenuPortal.js';
+export { DropdownMenuContent } from './DropdownMenuContent.js';
+export { DropdownMenuItem } from './DropdownMenuItem.js';
+export { DropdownMenuCheckboxItem } from './DropdownMenuCheckboxItem.js';
+export { DropdownMenuRadioGroup } from './DropdownMenuRadioGroup.js';
+export { DropdownMenuRadioItem } from './DropdownMenuRadioItem.js';
+export { DropdownMenuItemIndicator } from './DropdownMenuItemIndicator.js';
+export { DropdownMenuGroup } from './DropdownMenuGroup.js';
+export { DropdownMenuLabel } from './DropdownMenuLabel.js';
+export { DropdownMenuSeparator } from './DropdownMenuSeparator.js';
+export { DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger } from './DropdownMenuSub.js';
+export type { DropdownMenuProps, DropdownMenuTriggerProps, DropdownMenuPortalProps, DropdownMenuContentProps, DropdownMenuItemProps, DropdownMenuCheckboxItemProps, DropdownMenuRadioGroupProps, DropdownMenuRadioItemProps, DropdownMenuItemIndicatorProps, DropdownMenuGroupProps, DropdownMenuLabelProps, DropdownMenuSeparatorProps, DropdownMenuSubProps, DropdownMenuSubTriggerProps, DropdownMenuSubContentProps, } from './types.js';

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

@@ -0,0 +1,176 @@
+import type * as React from 'react';
+import type { MenuSubContentProps, MenuSubProps, MenuSubTriggerProps } from '../utils/menuSub.cjs';
+import type { PopperContentProps } from '../utils/popper.cjs';
+import type { PortalProps } from '../utils/portal.cjs';
+import type { PrimitivePropsWithRef } from '../utils/primitive.cjs';
+import type { FocusOutsideEvent, InteractOutsideEvent } from '../utils/useDismiss.cjs';
+/** @internal Shared state distributed from {@link DropdownMenu} to its parts via context. Not part of the public API. */
+export interface DropdownMenuContextValue {
+    triggerRef: React.RefObject<HTMLButtonElement | null>;
+    contentRef: React.RefObject<HTMLDivElement | null>;
+    contentId: string;
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+}
+/** Props for the {@link DropdownMenu} root. */
+export interface DropdownMenuProps {
+    /**
+     * The trigger and portal — the menu's own DOM (content, items) is
+     * rendered by {@link DropdownMenuPortal} 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.
+     * @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 `DropdownMenuContent`'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 DropdownMenuTrigger}, the button that opens the menu and anchors its position. */
+export interface DropdownMenuTriggerProps extends PrimitivePropsWithRef<'button'> {
+}
+/** Props for {@link DropdownMenuPortal}, which teleports its children to `document.body`. */
+export interface DropdownMenuPortalProps 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 DropdownMenuContent}, the floating menu panel. Extends
+ * the shared popper positioning props (`side`, `align`, `sideOffset`,
+ * `alignOffset`, `avoidCollisions`, `collisionPadding`).
+ */
+export interface DropdownMenuContentProps extends PopperContentProps {
+    /**
+     * 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;
+    /**
+     * 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 DropdownMenuItem}. */
+export interface DropdownMenuItemProps 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 DropdownMenuCheckboxItem}, a toggleable menu item. */
+export interface DropdownMenuCheckboxItemProps extends DropdownMenuItemProps {
+    /**
+     * 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 DropdownMenuRadioGroup} to its `DropdownMenuRadioItem`s via context. Not part of the public API. */
+export interface MenuRadioGroupContextValue {
+    value?: string;
+    onValueChange?: (value: string) => void;
+}
+/** Props for {@link DropdownMenuRadioGroup}, a container coordinating a set of mutually-exclusive `DropdownMenuRadioItem`s. */
+export interface DropdownMenuRadioGroupProps extends PrimitivePropsWithRef<'div'> {
+    /**
+     * Currently selected item's value, compared against each `DropdownMenuRadioItem`'s own `value`.
+     * @default undefined — no item is selected.
+     */
+    value?: string;
+    /**
+     * Fires with the new value when a `DropdownMenuRadioItem` in this group is selected.
+     * @default undefined — no-op if omitted.
+     */
+    onValueChange?: (value: string) => void;
+}
+/** Props for a single {@link DropdownMenuRadioItem} inside a `DropdownMenuRadioGroup`. */
+export interface DropdownMenuRadioItemProps extends DropdownMenuItemProps {
+    /** Unique identifier compared against the group's selected `value`. */
+    value: string;
+}
+/** Props for {@link DropdownMenuItemIndicator}, the checked-state glyph inside a checkbox/radio item. */
+export interface DropdownMenuItemIndicatorProps 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 DropdownMenuGroup}, a semantic grouping of related items. */
+export interface DropdownMenuGroupProps extends PrimitivePropsWithRef<'div'> {
+}
+/** Props for {@link DropdownMenuLabel}, a non-interactive heading for a group of items. */
+export interface DropdownMenuLabelProps extends PrimitivePropsWithRef<'div'> {
+}
+/** Props for {@link DropdownMenuSeparator}, a visual divider between items or groups. */
+export interface DropdownMenuSeparatorProps extends PrimitivePropsWithRef<'div'> {
+}
+/** Props for {@link DropdownMenuSub}, the root of a nested submenu. */
+export interface DropdownMenuSubProps extends MenuSubProps {
+}
+/** Props for {@link DropdownMenuSubTrigger}, the parent-menu item that opens a submenu and anchors it. */
+export interface DropdownMenuSubTriggerProps extends MenuSubTriggerProps {
+}
+/** Props for {@link DropdownMenuSubContent}, the submenu's floating panel. */
+export interface DropdownMenuSubContentProps extends MenuSubContentProps {
+}

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

@@ -0,0 +1,176 @@
+import type * as React from 'react';
+import type { MenuSubContentProps, MenuSubProps, MenuSubTriggerProps } from '../utils/menuSub.js';
+import type { PopperContentProps } from '../utils/popper.js';
+import type { PortalProps } from '../utils/portal.js';
+import type { PrimitivePropsWithRef } from '../utils/primitive.js';
+import type { FocusOutsideEvent, InteractOutsideEvent } from '../utils/useDismiss.js';
+/** @internal Shared state distributed from {@link DropdownMenu} to its parts via context. Not part of the public API. */
+export interface DropdownMenuContextValue {
+    triggerRef: React.RefObject<HTMLButtonElement | null>;
+    contentRef: React.RefObject<HTMLDivElement | null>;
+    contentId: string;
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+}
+/** Props for the {@link DropdownMenu} root. */
+export interface DropdownMenuProps {
+    /**
+     * The trigger and portal — the menu's own DOM (content, items) is
+     * rendered by {@link DropdownMenuPortal} 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.
+     * @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 `DropdownMenuContent`'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 DropdownMenuTrigger}, the button that opens the menu and anchors its position. */
+export interface DropdownMenuTriggerProps extends PrimitivePropsWithRef<'button'> {
+}
+/** Props for {@link DropdownMenuPortal}, which teleports its children to `document.body`. */
+export interface DropdownMenuPortalProps 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 DropdownMenuContent}, the floating menu panel. Extends
+ * the shared popper positioning props (`side`, `align`, `sideOffset`,
+ * `alignOffset`, `avoidCollisions`, `collisionPadding`).
+ */
+export interface DropdownMenuContentProps extends PopperContentProps {
+    /**
+     * 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;
+    /**
+     * 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 DropdownMenuItem}. */
+export interface DropdownMenuItemProps 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 DropdownMenuCheckboxItem}, a toggleable menu item. */
+export interface DropdownMenuCheckboxItemProps extends DropdownMenuItemProps {
+    /**
+     * 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 DropdownMenuRadioGroup} to its `DropdownMenuRadioItem`s via context. Not part of the public API. */
+export interface MenuRadioGroupContextValue {
+    value?: string;
+    onValueChange?: (value: string) => void;
+}
+/** Props for {@link DropdownMenuRadioGroup}, a container coordinating a set of mutually-exclusive `DropdownMenuRadioItem`s. */
+export interface DropdownMenuRadioGroupProps extends PrimitivePropsWithRef<'div'> {
+    /**
+     * Currently selected item's value, compared against each `DropdownMenuRadioItem`'s own `value`.
+     * @default undefined — no item is selected.
+     */
+    value?: string;
+    /**
+     * Fires with the new value when a `DropdownMenuRadioItem` in this group is selected.
+     * @default undefined — no-op if omitted.
+     */
+    onValueChange?: (value: string) => void;
+}
+/** Props for a single {@link DropdownMenuRadioItem} inside a `DropdownMenuRadioGroup`. */
+export interface DropdownMenuRadioItemProps extends DropdownMenuItemProps {
+    /** Unique identifier compared against the group's selected `value`. */
+    value: string;
+}
+/** Props for {@link DropdownMenuItemIndicator}, the checked-state glyph inside a checkbox/radio item. */
+export interface DropdownMenuItemIndicatorProps 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 DropdownMenuGroup}, a semantic grouping of related items. */
+export interface DropdownMenuGroupProps extends PrimitivePropsWithRef<'div'> {
+}
+/** Props for {@link DropdownMenuLabel}, a non-interactive heading for a group of items. */
+export interface DropdownMenuLabelProps extends PrimitivePropsWithRef<'div'> {
+}
+/** Props for {@link DropdownMenuSeparator}, a visual divider between items or groups. */
+export interface DropdownMenuSeparatorProps extends PrimitivePropsWithRef<'div'> {
+}
+/** Props for {@link DropdownMenuSub}, the root of a nested submenu. */
+export interface DropdownMenuSubProps extends MenuSubProps {
+}
+/** Props for {@link DropdownMenuSubTrigger}, the parent-menu item that opens a submenu and anchors it. */
+export interface DropdownMenuSubTriggerProps extends MenuSubTriggerProps {
+}
+/** Props for {@link DropdownMenuSubContent}, the submenu's floating panel. */
+export interface DropdownMenuSubContentProps extends MenuSubContentProps {
+}

package/dist/editable/Editable.cjs

@@ -0,0 +1 @@
+"use strict";var xe=Object.create;var v=Object.defineProperty;var Pe=Object.getOwnPropertyDescriptor;var Te=Object.getOwnPropertyNames;var Ce=Object.getPrototypeOf,we=Object.prototype.hasOwnProperty;var Me=(t,i)=>{for(var e in i)v(t,e,{get:i[e],enumerable:!0})},q=(t,i,e,a)=>{if(i&&typeof i=="object"||typeof i=="function")for(let r of Te(i))!we.call(t,r)&&r!==e&&v(t,r,{get:()=>i[r],enumerable:!(a=Pe(i,r))||a.enumerable});return t};var s=(t,i,e)=>(e=t!=null?xe(Ce(t)):{},q(i||!t||!t.__esModule?v(e,"default",{value:t,enumerable:!0}):e,t)),ke=t=>q(v({},"__esModule",{value:!0}),t);var he={};Me(he,{Editable:()=>J,EditableCancelTrigger:()=>k,EditableEditTrigger:()=>h,EditableInput:()=>D,EditablePreview:()=>H,EditableProvider:()=>G,EditableSubmitTrigger:()=>L,EditableTextarea:()=>N,useEditableContext:()=>o});module.exports=ke(he);var n=s(require("react"),1),A=require("../utils/createContext.cjs"),F=require("../utils/part.cjs"),z=require("../utils/primitive.cjs"),w=require("../utils/useControllableState.cjs"),M=require("react/jsx-runtime"),[G,o]=(0,A.createSafeContext)("Editable"),J=n.forwardRef(({value:t,defaultValue:i,onValueChange:e,onValueCommit:a,editing:r,defaultEditing:b=!1,onEditChange:fe,placeholder:ce,disabled:R=!1,readOnly:x=!1,required:S=!1,maxLength:be,activationMode:pe="click",submitMode:Ee="both",selectOnFocus:I=!0,...K},ge)=>{let[m="",P]=(0,w.useControllableState)({prop:t,defaultProp:i??"",onChange:e}),[l=!1,g]=(0,w.useControllableState)({prop:r,defaultProp:b,onChange:fe}),O=n.useRef(null),B=n.useRef(null),T=n.useRef(!1),C=n.useRef(m),ve=()=>{R||x||l||(C.current=m,g(!0))},ye=()=>{l&&(P(C.current),g(!1))},Re=()=>{if(l){if(S&&m.trim()===""){P(C.current),g(!1);return}g(!1),a?.(m)}},V=n.useRef(l);return n.useEffect(()=>{if(l){let d=O.current;d&&(d.focus(),I?d.select():d.setSelectionRange(d.value.length,d.value.length))}else if(V.current){let d=document.activeElement;(!d||d===document.body)&&(T.current=!0,B.current?.focus(),T.current=!1)}V.current=l},[l,I]),(0,M.jsx)(G,{value:m,editing:l,placeholder:ce,disabled:R,readOnly:x,required:S,maxLength:be,activationMode:pe,submitMode:Ee,inputRef:O,previewRef:B,returningFocusRef:T,setValue:P,activate:ve,submit:Re,cancel:ye,children:(0,M.jsx)(z.Primitive.div,{"data-state":l?"editing":"preview","data-empty":m===""?"":void 0,"data-disabled":R?"":void 0,"data-readonly":x?"":void 0,...K,...(0,F.skdxPart)("editable","root",K.className),ref:ge})})});J.displayName="Editable";var Q=s(require("react"),1),U=require("../utils/part.cjs"),p=require("../utils/primitive.cjs");var W=require("react/jsx-runtime"),k=Q.forwardRef((t,i)=>{let e=o("EditableCancelTrigger");return e.editing?(0,W.jsx)(p.Primitive.button,{type:"button","data-state":"editing",disabled:e.disabled,...t,...(0,U.skdxPart)("editable","cancel-trigger",t.className),ref:i,onMouseDown:(0,p.composeEventHandlers)(t.onMouseDown,a=>{a.preventDefault()}),onClick:(0,p.composeEventHandlers)(t.onClick,()=>e.cancel())}):null});k.displayName="EditableCancelTrigger";var X=s(require("react"),1),Y=require("../utils/part.cjs"),y=require("../utils/primitive.cjs");var Z=require("react/jsx-runtime"),h=X.forwardRef((t,i)=>{let e=o("EditableEditTrigger");return e.editing?null:(0,Z.jsx)(y.Primitive.button,{type:"button","data-state":"preview",disabled:e.disabled||e.readOnly,"data-disabled":e.disabled?"":void 0,"data-readonly":e.readOnly?"":void 0,...t,...(0,Y.skdxPart)("editable","edit-trigger",t.className),ref:i,onClick:(0,y.composeEventHandlers)(t.onClick,()=>e.activate())})});h.displayName="EditableEditTrigger";var _=s(require("react"),1),$=require("../utils/composeRefs.cjs"),j=require("../utils/part.cjs"),f=require("../utils/primitive.cjs");var ee=require("react/jsx-runtime"),D=_.forwardRef((t,i)=>{let e=o("EditableInput"),a=(0,$.useComposedRefs)(i,e.inputRef);return e.editing?(0,ee.jsx)(f.Primitive.input,{type:"text",value:e.value,placeholder:e.placeholder,disabled:e.disabled,readOnly:e.readOnly,required:e.required,maxLength:e.maxLength,"data-state":"editing","data-empty":e.value===""?"":void 0,...t,...(0,j.skdxPart)("editable","input",t.className),ref:a,onChange:(0,f.composeEventHandlers)(t.onChange,r=>{e.setValue(r.target.value)}),onKeyDown:(0,f.composeEventHandlers)(t.onKeyDown,r=>{if(r.key==="Escape"){r.preventDefault(),e.cancel();return}r.key==="Enter"&&(e.submitMode==="enter"||e.submitMode==="both")&&(r.preventDefault(),e.submit())}),onBlur:(0,f.composeEventHandlers)(t.onBlur,()=>{(e.submitMode==="blur"||e.submitMode==="both")&&e.submit()})}):null});D.displayName="EditableInput";var te=s(require("react"),1),ae=require("../utils/composeRefs.cjs"),ie=require("../utils/part.cjs"),u=require("../utils/primitive.cjs");var re=require("react/jsx-runtime"),H=te.forwardRef(({children:t,...i},e)=>{let a=o("EditablePreview"),r=(0,ae.useComposedRefs)(e,a.previewRef);return a.editing?null:(0,re.jsx)(u.Primitive.span,{role:"button",tabIndex:a.disabled?-1:0,"aria-disabled":a.disabled||void 0,"aria-readonly":a.readOnly||void 0,"data-state":"preview","data-empty":a.value===""?"":void 0,"data-disabled":a.disabled?"":void 0,"data-readonly":a.readOnly?"":void 0,...i,...(0,ie.skdxPart)("editable","preview",i.className),ref:r,onClick:(0,u.composeEventHandlers)(i.onClick,()=>{a.activationMode==="click"&&a.activate()}),onDoubleClick:(0,u.composeEventHandlers)(i.onDoubleClick,()=>{a.activationMode==="dblclick"&&a.activate()}),onFocus:(0,u.composeEventHandlers)(i.onFocus,()=>{a.activationMode==="focus"&&!a.returningFocusRef.current&&a.activate()}),onKeyDown:(0,u.composeEventHandlers)(i.onKeyDown,b=>{b.key!=="Enter"&&b.key!==" "||(b.preventDefault(),a.activate())}),children:t??(a.value||a.placeholder)})});H.displayName="EditablePreview";var oe=s(require("react"),1),ne=require("../utils/part.cjs"),E=require("../utils/primitive.cjs");var le=require("react/jsx-runtime"),L=oe.forwardRef((t,i)=>{let e=o("EditableSubmitTrigger");return e.editing?(0,le.jsx)(E.Primitive.button,{type:"button","data-state":"editing",disabled:e.disabled,...t,...(0,ne.skdxPart)("editable","submit-trigger",t.className),ref:i,onMouseDown:(0,E.composeEventHandlers)(t.onMouseDown,a=>{a.preventDefault()}),onClick:(0,E.composeEventHandlers)(t.onClick,()=>e.submit())}):null});L.displayName="EditableSubmitTrigger";var de=s(require("react"),1),se=require("../utils/composeRefs.cjs"),ue=require("../utils/part.cjs"),c=require("../utils/primitive.cjs");var me=require("react/jsx-runtime"),N=de.forwardRef((t,i)=>{let e=o("EditableTextarea"),a=(0,se.useComposedRefs)(i,e.inputRef);return e.editing?(0,me.jsx)(c.Primitive.textarea,{value:e.value,placeholder:e.placeholder,disabled:e.disabled,readOnly:e.readOnly,required:e.required,maxLength:e.maxLength,"data-state":"editing","data-empty":e.value===""?"":void 0,...t,...(0,ue.skdxPart)("editable","textarea",t.className),ref:a,onChange:(0,c.composeEventHandlers)(t.onChange,r=>{e.setValue(r.target.value)}),onKeyDown:(0,c.composeEventHandlers)(t.onKeyDown,r=>{if(r.key==="Escape"){r.preventDefault(),e.cancel();return}r.key==="Enter"&&(!r.metaKey&&!r.ctrlKey||e.submitMode!=="enter"&&e.submitMode!=="both"||(r.preventDefault(),e.submit()))}),onBlur:(0,c.composeEventHandlers)(t.onBlur,()=>{(e.submitMode==="blur"||e.submitMode==="both")&&e.submit()})}):null});N.displayName="EditableTextarea";0&&(module.exports={Editable,EditableCancelTrigger,EditableEditTrigger,EditableInput,EditablePreview,EditableProvider,EditableSubmitTrigger,EditableTextarea,useEditableContext});

package/dist/editable/Editable.d.cts

@@ -0,0 +1,42 @@
+import * as React from 'react';
+import type { EditableContextValue, EditableProps } from './types.cjs';
+export declare const EditableProvider: {
+    (props: EditableContextValue & {
+        children: React.ReactNode;
+    }): React.JSX.Element;
+    displayName: string;
+}, useEditableContext: (consumerName: string) => EditableContextValue;
+/**
+ * Root of a click-to-edit inline text field: owns the text **and** the
+ * preview/edit mode, and hands both down to its parts via context. Renders a
+ * plain `<div>` carrying `data-state="editing" | "preview"` and `data-empty`
+ * — how preview and input sit in the layout is entirely your CSS.
+ *
+ * Both pieces of state are independently controllable: `value`/`defaultValue`/
+ * `onValueChange` for the text, `editing`/`defaultEditing`/`onEditChange` for
+ * the mode. `value` tracks the live draft, so it changes per keystroke;
+ * `onValueCommit` is the one that fires once, on a successful submit.
+ *
+ * The state machine, in full:
+ * - **Enter edit** — the gesture named by `activationMode` on the preview, or
+ *   Enter/Space while the preview has focus, or `EditableEditTrigger`. The
+ *   pre-edit text is snapshotted, then the input is focused with everything
+ *   selected (`selectOnFocus`, default) or the caret at the end.
+ * - **Submit** — the gestures named by `submitMode`, or `EditableSubmitTrigger`.
+ *   Commits, unless `required` and the draft is blank, in which case the
+ *   snapshot is restored instead and nothing is committed.
+ * - **Cancel** — Escape, always, whatever `submitMode` says, or
+ *   `EditableCancelTrigger`. Restores the snapshot.
+ * - **Either exit returns focus to the preview.** Losing focus to `<body>`
+ *   after an inline edit strands keyboard users mid-page, so the root drives
+ *   this rather than leaving it to the unmounting input.
+ *
+ * @example
+ * ```tsx
+ * <Editable defaultValue="Untitled" placeholder="Name this board" onValueCommit={save}>
+ *   <EditablePreview />
+ *   <EditableInput aria-label="Board name" />
+ * </Editable>
+ * ```
+ */
+export declare const Editable: React.ForwardRefExoticComponent<Omit<EditableProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/editable/Editable.d.ts

@@ -0,0 +1,42 @@
+import * as React from 'react';
+import type { EditableContextValue, EditableProps } from './types.js';
+export declare const EditableProvider: {
+    (props: EditableContextValue & {
+        children: React.ReactNode;
+    }): React.JSX.Element;
+    displayName: string;
+}, useEditableContext: (consumerName: string) => EditableContextValue;
+/**
+ * Root of a click-to-edit inline text field: owns the text **and** the
+ * preview/edit mode, and hands both down to its parts via context. Renders a
+ * plain `<div>` carrying `data-state="editing" | "preview"` and `data-empty`
+ * — how preview and input sit in the layout is entirely your CSS.
+ *
+ * Both pieces of state are independently controllable: `value`/`defaultValue`/
+ * `onValueChange` for the text, `editing`/`defaultEditing`/`onEditChange` for
+ * the mode. `value` tracks the live draft, so it changes per keystroke;
+ * `onValueCommit` is the one that fires once, on a successful submit.
+ *
+ * The state machine, in full:
+ * - **Enter edit** — the gesture named by `activationMode` on the preview, or
+ *   Enter/Space while the preview has focus, or `EditableEditTrigger`. The
+ *   pre-edit text is snapshotted, then the input is focused with everything
+ *   selected (`selectOnFocus`, default) or the caret at the end.
+ * - **Submit** — the gestures named by `submitMode`, or `EditableSubmitTrigger`.
+ *   Commits, unless `required` and the draft is blank, in which case the
+ *   snapshot is restored instead and nothing is committed.
+ * - **Cancel** — Escape, always, whatever `submitMode` says, or
+ *   `EditableCancelTrigger`. Restores the snapshot.
+ * - **Either exit returns focus to the preview.** Losing focus to `<body>`
+ *   after an inline edit strands keyboard users mid-page, so the root drives
+ *   this rather than leaving it to the unmounting input.
+ *
+ * @example
+ * ```tsx
+ * <Editable defaultValue="Untitled" placeholder="Name this board" onValueCommit={save}>
+ *   <EditablePreview />
+ *   <EditableInput aria-label="Board name" />
+ * </Editable>
+ * ```
+ */
+export declare const Editable: React.ForwardRefExoticComponent<Omit<EditableProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/editable/Editable.js

@@ -0,0 +1 @@
+import*as n from"react";import{createSafeContext as _}from"../utils/createContext.js";import{skdxPart as $}from"../utils/part.js";import{Primitive as j}from"../utils/primitive.js";import{useControllableState as M}from"../utils/useControllableState.js";import{jsx as k}from"react/jsx-runtime";var[ee,o]=_("Editable"),te=n.forwardRef(({value:t,defaultValue:r,onValueChange:e,onValueCommit:a,editing:i,defaultEditing:u=!1,onEditChange:z,placeholder:G,disabled:c=!1,readOnly:b=!1,required:R=!1,maxLength:J,activationMode:Q="click",submitMode:U="both",selectOnFocus:x=!0,...P},W)=>{let[s="",p]=M({prop:t,defaultProp:r??"",onChange:e}),[l=!1,m]=M({prop:i,defaultProp:u,onChange:z}),T=n.useRef(null),C=n.useRef(null),E=n.useRef(!1),g=n.useRef(s),X=()=>{c||b||l||(g.current=s,m(!0))},Y=()=>{l&&(p(g.current),m(!1))},Z=()=>{if(l){if(R&&s.trim()===""){p(g.current),m(!1);return}m(!1),a?.(s)}},w=n.useRef(l);return n.useEffect(()=>{if(l){let d=T.current;d&&(d.focus(),x?d.select():d.setSelectionRange(d.value.length,d.value.length))}else if(w.current){let d=document.activeElement;(!d||d===document.body)&&(E.current=!0,C.current?.focus(),E.current=!1)}w.current=l},[l,x]),k(ee,{value:s,editing:l,placeholder:G,disabled:c,readOnly:b,required:R,maxLength:J,activationMode:Q,submitMode:U,inputRef:T,previewRef:C,returningFocusRef:E,setValue:p,activate:X,submit:Z,cancel:Y,children:k(j.div,{"data-state":l?"editing":"preview","data-empty":s===""?"":void 0,"data-disabled":c?"":void 0,"data-readonly":b?"":void 0,...P,...$("editable","root",P.className),ref:W})})});te.displayName="Editable";import*as D from"react";import{skdxPart as ae}from"../utils/part.js";import{composeEventHandlers as h,Primitive as ie}from"../utils/primitive.js";import{jsx as re}from"react/jsx-runtime";var H=D.forwardRef((t,r)=>{let e=o("EditableCancelTrigger");return e.editing?re(ie.button,{type:"button","data-state":"editing",disabled:e.disabled,...t,...ae("editable","cancel-trigger",t.className),ref:r,onMouseDown:h(t.onMouseDown,a=>{a.preventDefault()}),onClick:h(t.onClick,()=>e.cancel())}):null});H.displayName="EditableCancelTrigger";import*as L from"react";import{skdxPart as oe}from"../utils/part.js";import{composeEventHandlers as ne,Primitive as le}from"../utils/primitive.js";import{jsx as de}from"react/jsx-runtime";var N=L.forwardRef((t,r)=>{let e=o("EditableEditTrigger");return e.editing?null:de(le.button,{type:"button","data-state":"preview",disabled:e.disabled||e.readOnly,"data-disabled":e.disabled?"":void 0,"data-readonly":e.readOnly?"":void 0,...t,...oe("editable","edit-trigger",t.className),ref:r,onClick:ne(t.onClick,()=>e.activate())})});N.displayName="EditableEditTrigger";import*as S from"react";import{useComposedRefs as se}from"../utils/composeRefs.js";import{skdxPart as ue}from"../utils/part.js";import{composeEventHandlers as v,Primitive as me}from"../utils/primitive.js";import{jsx as fe}from"react/jsx-runtime";var I=S.forwardRef((t,r)=>{let e=o("EditableInput"),a=se(r,e.inputRef);return e.editing?fe(me.input,{type:"text",value:e.value,placeholder:e.placeholder,disabled:e.disabled,readOnly:e.readOnly,required:e.required,maxLength:e.maxLength,"data-state":"editing","data-empty":e.value===""?"":void 0,...t,...ue("editable","input",t.className),ref:a,onChange:v(t.onChange,i=>{e.setValue(i.target.value)}),onKeyDown:v(t.onKeyDown,i=>{if(i.key==="Escape"){i.preventDefault(),e.cancel();return}i.key==="Enter"&&(e.submitMode==="enter"||e.submitMode==="both")&&(i.preventDefault(),e.submit())}),onBlur:v(t.onBlur,()=>{(e.submitMode==="blur"||e.submitMode==="both")&&e.submit()})}):null});I.displayName="EditableInput";import*as K from"react";import{useComposedRefs as ce}from"../utils/composeRefs.js";import{skdxPart as be}from"../utils/part.js";import{composeEventHandlers as f,Primitive as pe}from"../utils/primitive.js";import{jsx as Ee}from"react/jsx-runtime";var O=K.forwardRef(({children:t,...r},e)=>{let a=o("EditablePreview"),i=ce(e,a.previewRef);return a.editing?null:Ee(pe.span,{role:"button",tabIndex:a.disabled?-1:0,"aria-disabled":a.disabled||void 0,"aria-readonly":a.readOnly||void 0,"data-state":"preview","data-empty":a.value===""?"":void 0,"data-disabled":a.disabled?"":void 0,"data-readonly":a.readOnly?"":void 0,...r,...be("editable","preview",r.className),ref:i,onClick:f(r.onClick,()=>{a.activationMode==="click"&&a.activate()}),onDoubleClick:f(r.onDoubleClick,()=>{a.activationMode==="dblclick"&&a.activate()}),onFocus:f(r.onFocus,()=>{a.activationMode==="focus"&&!a.returningFocusRef.current&&a.activate()}),onKeyDown:f(r.onKeyDown,u=>{u.key!=="Enter"&&u.key!==" "||(u.preventDefault(),a.activate())}),children:t??(a.value||a.placeholder)})});O.displayName="EditablePreview";import*as V from"react";import{skdxPart as ge}from"../utils/part.js";import{composeEventHandlers as B,Primitive as ve}from"../utils/primitive.js";import{jsx as ye}from"react/jsx-runtime";var q=V.forwardRef((t,r)=>{let e=o("EditableSubmitTrigger");return e.editing?ye(ve.button,{type:"button","data-state":"editing",disabled:e.disabled,...t,...ge("editable","submit-trigger",t.className),ref:r,onMouseDown:B(t.onMouseDown,a=>{a.preventDefault()}),onClick:B(t.onClick,()=>e.submit())}):null});q.displayName="EditableSubmitTrigger";import*as A from"react";import{useComposedRefs as Re}from"../utils/composeRefs.js";import{skdxPart as xe}from"../utils/part.js";import{composeEventHandlers as y,Primitive as Pe}from"../utils/primitive.js";import{jsx as Te}from"react/jsx-runtime";var F=A.forwardRef((t,r)=>{let e=o("EditableTextarea"),a=Re(r,e.inputRef);return e.editing?Te(Pe.textarea,{value:e.value,placeholder:e.placeholder,disabled:e.disabled,readOnly:e.readOnly,required:e.required,maxLength:e.maxLength,"data-state":"editing","data-empty":e.value===""?"":void 0,...t,...xe("editable","textarea",t.className),ref:a,onChange:y(t.onChange,i=>{e.setValue(i.target.value)}),onKeyDown:y(t.onKeyDown,i=>{if(i.key==="Escape"){i.preventDefault(),e.cancel();return}i.key==="Enter"&&(!i.metaKey&&!i.ctrlKey||e.submitMode!=="enter"&&e.submitMode!=="both"||(i.preventDefault(),e.submit()))}),onBlur:y(t.onBlur,()=>{(e.submitMode==="blur"||e.submitMode==="both")&&e.submit()})}):null});F.displayName="EditableTextarea";export{te as Editable,H as EditableCancelTrigger,N as EditableEditTrigger,I as EditableInput,O as EditablePreview,ee as EditableProvider,q as EditableSubmitTrigger,F as EditableTextarea,o as useEditableContext};

package/dist/editable/EditableCancelTrigger.d.cts

@@ -0,0 +1,22 @@
+import * as React from 'react';
+import type { EditableCancelTriggerProps } from './types.cjs';
+/**
+ * A button that discards the current draft of an {@link Editable} and restores
+ * the pre-edit text — the pointer equivalent of Escape. Renders `nothing`
+ * outside edit mode.
+ *
+ * Like `EditableSubmitTrigger` it calls `preventDefault()` on mouse-down so
+ * the input keeps focus, and here that is load-bearing rather than merely
+ * tidy: without it, under the default `submitMode="both"`, the blur would
+ * *submit* the very draft this button exists to throw away.
+ *
+ * @example
+ * ```tsx
+ * <Editable defaultValue="Untitled">
+ *   <EditablePreview />
+ *   <EditableInput aria-label="Title" />
+ *   <EditableCancelTrigger>Cancel</EditableCancelTrigger>
+ * </Editable>
+ * ```
+ */
+export declare const EditableCancelTrigger: React.ForwardRefExoticComponent<Omit<EditableCancelTriggerProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;

package/dist/editable/EditableCancelTrigger.d.ts

@@ -0,0 +1,22 @@
+import * as React from 'react';
+import type { EditableCancelTriggerProps } from './types.js';
+/**
+ * A button that discards the current draft of an {@link Editable} and restores
+ * the pre-edit text — the pointer equivalent of Escape. Renders `nothing`
+ * outside edit mode.
+ *
+ * Like `EditableSubmitTrigger` it calls `preventDefault()` on mouse-down so
+ * the input keeps focus, and here that is load-bearing rather than merely
+ * tidy: without it, under the default `submitMode="both"`, the blur would
+ * *submit* the very draft this button exists to throw away.
+ *
+ * @example
+ * ```tsx
+ * <Editable defaultValue="Untitled">
+ *   <EditablePreview />
+ *   <EditableInput aria-label="Title" />
+ *   <EditableCancelTrigger>Cancel</EditableCancelTrigger>
+ * </Editable>
+ * ```
+ */
+export declare const EditableCancelTrigger: React.ForwardRefExoticComponent<Omit<EditableCancelTriggerProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;