veryfront 0.1.1238 → 0.1.1239

package/esm/src/react/components/ui/dialog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dialog.d.ts","sourceRoot":"","sources":["../../../../../src/src/react/components/ui/dialog.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"dialog.d.ts","sourceRoot":"","sources":["../../../../../src/src/react/components/ui/dialog.tsx"],"names":[],"mappings":"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"}

package/esm/src/react/components/ui/dialog.js

@@ -1,7 +1,25 @@
 /**
- * Dependency-free dialog primitive with a Studio-compatible part API. It
- * provides modal focus containment, focus restoration, document scroll
- * locking, stable ARIA relationships, and Escape/overlay dismissal.
+ * Dialog - BASIC fork of @radix-ui/react-dialog with the same API shape (Root /
+ * Trigger / Content + Header / Title / Description / Body / Footer / Action /
+ * Cancel / Close / Form). Classes ported 1:1 from Studio's `Dialog` (tokens
+ * remapped; `Heading` level 2 + `Text` inlined). Modal overlay + centered panel;
+ * dismisses on `Escape` and overlay click. A11y work tracked in modal-surface.tsx.
+ *
+ * @example
+ * ```tsx
+ * import { Button, Dialog, DialogAction, DialogCancel, DialogContent, DialogFooter, DialogTitle, DialogTrigger } from "veryfront/ui";
+ *
+ * <Dialog>
+ *   <DialogTrigger asChild><Button variant="destructive">Delete</Button></DialogTrigger>
+ *   <DialogContent>
+ *     <DialogTitle>Delete project?</DialogTitle>
+ *     <DialogFooter>
+ *       <DialogCancel>Cancel</DialogCancel>
+ *       <DialogAction onClick={remove}>Delete</DialogAction>
+ *     </DialogFooter>
+ *   </DialogContent>
+ * </Dialog>;
+ * ```
  *
  * @module react/components/ui/dialog
  */
@@ -9,32 +27,34 @@ import * as React from "react";
 import { cx as cn } from "./cva.js";
 import { ScrollFade } from "./scroll-fade.js";
 import { Button, LoadingButton } from "./button.js";
-import { createModalSurfaceParts } from "./modal-surface.js";
+import { useAdapter } from "./adapter/context.js";
 import { useIsomorphicLayoutEffect } from "./use-isomorphic-layout-effect.js";
-// Per-skin context + machinery -- distinct from Drawer's instance so a
-// DrawerClose nested inside a Dialog cannot accidentally close the Dialog.
-const { ModalRoot: _Root, useModal: _hook, ModalTrigger: _Trigger, ModalClose: _Close, ModalContent: _Content, } = createModalSurfaceParts("Dialog");
-/** Dialog root — owns open state. */
+/** Dialog root - owns open state. */
 export function Dialog(props) {
-    return React.createElement(_Root, { ...props });
+    const { dialog } = useAdapter();
+    return React.createElement(dialog.Root, { ...props });
 }
-/** Trigger — opens the dialog. `asChild` merges onto the child element. */
+/** Trigger - opens the dialog. `asChild` merges onto the child element. */
 export function DialogTrigger(props) {
-    return React.createElement(_Trigger, { ...props });
+    const { dialog } = useAdapter();
+    return React.createElement(dialog.Trigger, { ...props });
 }
-/** Modal surface — overlay + centered panel, rendered while open. */
+/** Modal surface - overlay + centered panel, rendered while open. */
 export function DialogContent({ className, children, "aria-describedby": describedBy, ...props }) {
-    const modal = _hook();
-    return (React.createElement(_Content, { "aria-describedby": describedBy ?? (modal.descriptionPresent ? modal.descriptionId : undefined), className: cn("fixed left-1/2 top-1/2 z-50 w-[calc(100%-3rem)] max-w-xl max-h-[85vh] -translate-x-1/2 -translate-y-1/2", "rounded-xl bg-[var(--dialog)] text-[var(--foreground)] shadow-lg outline-none overflow-hidden flex flex-col", className), ...props }, children));
+    const { dialog } = useAdapter();
+    const modal = dialog.useDialog();
+    return (React.createElement(dialog.Content, { "aria-describedby": describedBy ?? (modal.descriptionPresent ? modal.descriptionId : undefined), className: cn("fixed left-1/2 top-1/2 z-50 w-[calc(100%_-_3rem)] max-w-xl max-h-[85vh] -translate-x-1/2 -translate-y-1/2", "rounded-xl bg-[var(--dialog)] text-[var(--foreground)] shadow-lg outline-none overflow-hidden flex flex-col", className), ...props }, children));
 }
 /** Left-aligned title + description block. */
 export function DialogHeader({ className, ...props }) {
     return React.createElement("div", { className: cn("flex flex-col px-6 pt-6 shrink-0", className), ...props });
 }
-/** Dialog title — Studio Heading level 2 (20px). Semibold so Inter reads at
- * Studio's medium-on-Söhne weight (workbench heading convention). */
+/** Dialog title - Studio Heading level 2 (20px). Semibold so Inter reads at
+ * Studio's medium-on-Söhne weight (workbench heading convention). Registers its
+ * id with the adapter so the panel adopts `aria-labelledby`. */
 export function DialogTitle({ className, id, ...props }) {
-    const modal = _hook();
+    const { dialog } = useAdapter();
+    const modal = dialog.useDialog();
     const resolvedId = id ?? modal.defaultTitleId;
     useIsomorphicLayoutEffect(() => {
         modal.setTitleId(resolvedId);
@@ -43,17 +63,14 @@ export function DialogTitle({ className, id, ...props }) {
             modal.setTitlePresent(false);
             modal.setTitleId((current) => current === resolvedId ? modal.defaultTitleId : current);
         };
-    }, [
-        modal.defaultTitleId,
-        modal.setTitleId,
-        modal.setTitlePresent,
-        resolvedId,
-    ]);
+    }, [modal.defaultTitleId, modal.setTitleId, modal.setTitlePresent, resolvedId]);
     return (React.createElement("h2", { id: resolvedId, className: cn("text-xl font-semibold text-[var(--foreground)]", className), ...props }));
 }
-/** Dialog description — body text, left-aligned. */
+/** Dialog description - body text, left-aligned. Registers its id with the
+ * adapter so the panel adopts `aria-describedby`. */
 export function DialogDescription({ className, id, ...props }) {
-    const modal = _hook();
+    const { dialog } = useAdapter();
+    const modal = dialog.useDialog();
     const resolvedId = id ?? modal.defaultDescriptionId;
     useIsomorphicLayoutEffect(() => {
         modal.setDescriptionId(resolvedId);
@@ -74,7 +91,7 @@ export function DialogDescription({ className, id, ...props }) {
 export function DialogBody({ className, children, ...props }) {
     return (React.createElement(ScrollFade, { edges: "bottom", className: cn("px-6 mt-6 pb-1 min-h-0 flex flex-col gap-4 text-left", className), ...props }, children));
 }
-/** Sticky footer row — action left, cancel right. */
+/** Sticky footer row - action left, cancel right. */
 export function DialogFooter({ className, ...props }) {
     return React.createElement("div", { className: cn("p-6 flex justify-start gap-3 shrink-0", className), ...props });
 }
@@ -88,7 +105,8 @@ export function DialogAction({ isLoading, variant = "primary", size = "default",
 }
 /** Alternate button (secondary, default size) that closes the dialog. */
 export function DialogCancel({ className, variant = "secondary", size = "default", onClick, ...props }) {
-    const ctx = _hook();
+    const { dialog } = useAdapter();
+    const ctx = dialog.useDialog();
     return (React.createElement(Button, { variant: variant, size: size, className: className, onClick: (e) => {
             onClick?.(e);
             if (!e.defaultPrevented)
@@ -97,5 +115,6 @@ export function DialogCancel({ className, variant = "secondary", size = "default
 }
 /** Closes the dialog. `asChild` merges onto the child element. */
 export function DialogClose(props) {
-    return React.createElement(_Close, { ...props });
+    const { dialog } = useAdapter();
+    return React.createElement(dialog.Close, { ...props });
 }

package/esm/src/react/components/ui/drawer.d.ts

@@ -1,28 +1,51 @@
 /**
- * Dependency-free bottom-sheet primitive with the Studio part API used by
- * Veryfront. It shares the dialog's modal focus, ARIA, scroll-lock, and
- * dismissal contracts while presenting a drawer surface.
+ * Drawer - BASIC bottom-sheet fork of Studio's `Drawer` (which is a large
+ * Vaul-style component). Same API shape for the parts we need: Root / Trigger /
+ * Content (overlay + sheet + drag handle) / Title / Header / Body / Footer /
+ * Close. Surface classes ported 1:1 from Studio (tokens remapped). Slides up
+ * from the bottom; dismisses on `Escape` and overlay click. A11y work tracked
+ * in modal-surface.tsx.
+ *
+ * @example
+ * ```tsx
+ * import { Button, Drawer, DrawerContent, DrawerTitle, DrawerTrigger } from "veryfront/ui";
+ *
+ * <Drawer>
+ *   <DrawerTrigger asChild><Button>Edit</Button></DrawerTrigger>
+ *   <DrawerContent><DrawerTitle>Edit profile</DrawerTitle></DrawerContent>
+ * </Drawer>;
+ * ```
  *
  * @module react/components/ui/drawer
  */
 import * as React from "react";
 /** Props accepted by `<Drawer>`. */
 export interface DrawerProps {
+    /** The trigger and content parts to compose. */
     children: React.ReactNode;
+    /** Controlled open state (pair with `onOpenChange`). */
     open?: boolean;
+    /** Initial open state when uncontrolled. */
     defaultOpen?: boolean;
+    /** Fires when the open state changes. */
     onOpenChange?: (open: boolean) => void;
 }
-/** Drawer root — owns open state. */
+/** Drawer root - owns open state (via the adapter's drawer engine). */
 export declare function Drawer(props: DrawerProps): React.ReactElement;
-/** Trigger — opens the drawer. `asChild` merges onto the child element. */
+/** Trigger - opens the drawer. `asChild` merges onto the child element. */
 export declare function DrawerTrigger(props: React.ButtonHTMLAttributes<HTMLButtonElement> & {
     asChild?: boolean;
     ref?: React.Ref<HTMLButtonElement>;
 }): React.ReactElement;
-/** Bottom sheet — overlay + sliding surface with a drag handle. */
-export declare function DrawerContent({ children, className, ...props }: React.HTMLAttributes<HTMLDivElement>): React.ReactElement | null;
-/** Drawer title — 18px medium (Studio Heading-ish). Add `sr-only` to hide. */
+/** Props accepted by `<DrawerContent>`. */
+export interface DrawerContentProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** React 19: ref is a regular prop, forwarded to the drawer panel. */
+    ref?: React.Ref<HTMLDivElement>;
+}
+/** Bottom sheet - overlay + sliding surface with a drag handle. */
+export declare function DrawerContent({ children, className, ...props }: DrawerContentProps): React.ReactElement | null;
+/** Drawer title - 18px medium (Studio Heading-ish). Add `sr-only` to hide.
+ * Registers its id with the adapter so the sheet adopts `aria-labelledby`. */
 export declare function DrawerTitle({ className, id, ...props }: React.HTMLAttributes<HTMLHeadingElement>): React.ReactElement;
 /** Header column wrapper. */
 export declare function DrawerHeader({ className, ...props }: React.HTMLAttributes<HTMLDivElement>): React.ReactElement;

package/esm/src/react/components/ui/drawer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"drawer.d.ts","sourceRoot":"","sources":["../../../../../src/src/react/components/ui/drawer.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAe/B,oCAAoC;AACpC,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACxC;AAED,qCAAqC;AACrC,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,KAAK,CAAC,YAAY,CAE7D;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAC3B,KAAK,EACD,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,GAC7C;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;CAAE,GAC5D,KAAK,CAAC,YAAY,CAEpB;AAED,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAkBlE;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,EAC1B,SAAS,EACT,EAAE,EACF,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,kBAAkB,CAAC,GAAG,KAAK,CAAC,YAAY,CAuB/D;AAED,6BAA6B;AAC7B,wBAAgB,YAAY,CAC1B,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,GAC5D,KAAK,CAAC,YAAY,CAEpB;AAED,4BAA4B;AAC5B,wBAAgB,UAAU,CACxB,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,GAC5D,KAAK,CAAC,YAAY,CAOpB;AAED,iDAAiD;AACjD,wBAAgB,YAAY,CAC1B,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,GAC5D,KAAK,CAAC,YAAY,CAUpB;AAED,kEAAkE;AAClE,wBAAgB,WAAW,CACzB,KAAK,EACD,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,GAC7C;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;CAAE,GAC5D,KAAK,CAAC,YAAY,CAEpB"}
+{"version":3,"file":"drawer.d.ts","sourceRoot":"","sources":["../../../../../src/src/react/components/ui/drawer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAU/B,oCAAoC;AACpC,MAAM,WAAW,WAAW;IAC1B,gDAAgD;IAChD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,wDAAwD;IACxD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,4CAA4C;IAC5C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yCAAyC;IACzC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACxC;AAED,uEAAuE;AACvE,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,KAAK,CAAC,YAAY,CAG7D;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAC3B,KAAK,EACD,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,GAC7C;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;CAAE,GAC5D,KAAK,CAAC,YAAY,CAGpB;AAED,2CAA2C;AAC3C,MAAM,WAAW,kBAAmB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC9E,sEAAsE;IACtE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;CACjC;AAED,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,SAAS,EACT,GAAG,KAAK,EACT,EAAE,kBAAkB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAmBhD;AAED;8EAC8E;AAC9E,wBAAgB,WAAW,CAAC,EAC1B,SAAS,EACT,EAAE,EACF,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,kBAAkB,CAAC,GAAG,KAAK,CAAC,YAAY,CAmB/D;AAED,6BAA6B;AAC7B,wBAAgB,YAAY,CAC1B,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,GAC5D,KAAK,CAAC,YAAY,CAEpB;AAED,4BAA4B;AAC5B,wBAAgB,UAAU,CACxB,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,GAC5D,KAAK,CAAC,YAAY,CAOpB;AAED,iDAAiD;AACjD,wBAAgB,YAAY,CAC1B,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,GAC5D,KAAK,CAAC,YAAY,CAUpB;AAED,kEAAkE;AAClE,wBAAgB,WAAW,CACzB,KAAK,EACD,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,GAC7C;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;CAAE,GAC5D,KAAK,CAAC,YAAY,CAGpB"}

package/esm/src/react/components/ui/drawer.js

@@ -1,32 +1,47 @@
 /**
- * Dependency-free bottom-sheet primitive with the Studio part API used by
- * Veryfront. It shares the dialog's modal focus, ARIA, scroll-lock, and
- * dismissal contracts while presenting a drawer surface.
+ * Drawer - BASIC bottom-sheet fork of Studio's `Drawer` (which is a large
+ * Vaul-style component). Same API shape for the parts we need: Root / Trigger /
+ * Content (overlay + sheet + drag handle) / Title / Header / Body / Footer /
+ * Close. Surface classes ported 1:1 from Studio (tokens remapped). Slides up
+ * from the bottom; dismisses on `Escape` and overlay click. A11y work tracked
+ * in modal-surface.tsx.
+ *
+ * @example
+ * ```tsx
+ * import { Button, Drawer, DrawerContent, DrawerTitle, DrawerTrigger } from "veryfront/ui";
+ *
+ * <Drawer>
+ *   <DrawerTrigger asChild><Button>Edit</Button></DrawerTrigger>
+ *   <DrawerContent><DrawerTitle>Edit profile</DrawerTitle></DrawerContent>
+ * </Drawer>;
+ * ```
  *
  * @module react/components/ui/drawer
  */
 import * as React from "react";
 import { cx as cn } from "./cva.js";
-import { createModalSurfaceParts } from "./modal-surface.js";
+import { useAdapter } from "./adapter/context.js";
 import { useIsomorphicLayoutEffect } from "./use-isomorphic-layout-effect.js";
-// Per-skin context + machinery -- distinct from Dialog's instance so a
-// DialogClose nested inside a Drawer cannot accidentally close the Drawer.
-const { ModalRoot: _Root, useModal: _hook, ModalTrigger: _Trigger, ModalClose: _Close, ModalContent: _Content, } = createModalSurfaceParts("Drawer");
-/** Drawer root — owns open state. */
+/** Drawer root - owns open state (via the adapter's drawer engine). */
 export function Drawer(props) {
-    return React.createElement(_Root, { ...props });
+    const { drawer } = useAdapter();
+    return React.createElement(drawer.Root, { ...props });
 }
-/** Trigger — opens the drawer. `asChild` merges onto the child element. */
+/** Trigger - opens the drawer. `asChild` merges onto the child element. */
 export function DrawerTrigger(props) {
-    return React.createElement(_Trigger, { ...props });
+    const { drawer } = useAdapter();
+    return React.createElement(drawer.Trigger, { ...props });
 }
-/** Bottom sheet — overlay + sliding surface with a drag handle. */
+/** Bottom sheet - overlay + sliding surface with a drag handle. */
 export function DrawerContent({ children, className, ...props }) {
-    return (React.createElement(_Content, { className: cn("fixed inset-x-0 bottom-0 z-50 flex flex-col max-h-[85vh] w-full rounded-t-xl bg-[var(--drawer)] text-[var(--foreground)] outline-none", className), lead: React.createElement("div", { "aria-hidden": "true", className: "mx-auto mt-3 h-[3px] w-[30px] shrink-0 rounded-full bg-[var(--outline-border)]" }), ...props }, children));
+    const { drawer } = useAdapter();
+    return (React.createElement(drawer.Content, { className: cn("fixed inset-x-0 bottom-0 z-50 flex flex-col max-h-[85vh] w-full rounded-t-xl bg-[var(--drawer)] text-[var(--foreground)] outline-none", className), lead: React.createElement("div", { "aria-hidden": "true", className: "mx-auto mt-3 h-[3px] w-[30px] shrink-0 rounded-full bg-[var(--outline-border)]" }), ...props }, children));
 }
-/** Drawer title — 18px medium (Studio Heading-ish). Add `sr-only` to hide. */
+/** Drawer title - 18px medium (Studio Heading-ish). Add `sr-only` to hide.
+ * Registers its id with the adapter so the sheet adopts `aria-labelledby`. */
 export function DrawerTitle({ className, id, ...props }) {
-    const modal = _hook();
+    const { drawer } = useAdapter();
+    const modal = drawer.useDrawer();
     const resolvedId = id ?? modal.defaultTitleId;
     useIsomorphicLayoutEffect(() => {
         modal.setTitleId(resolvedId);
@@ -35,12 +50,7 @@ export function DrawerTitle({ className, id, ...props }) {
             modal.setTitlePresent(false);
             modal.setTitleId((current) => current === resolvedId ? modal.defaultTitleId : current);
         };
-    }, [
-        modal.defaultTitleId,
-        modal.setTitleId,
-        modal.setTitlePresent,
-        resolvedId,
-    ]);
+    }, [modal.defaultTitleId, modal.setTitleId, modal.setTitlePresent, resolvedId]);
     return (React.createElement("h2", { id: resolvedId, className: cn("text-lg font-medium text-[var(--foreground)]", className), ...props }));
 }
 /** Header column wrapper. */
@@ -57,5 +67,6 @@ export function DrawerFooter({ className, ...props }) {
 }
 /** Closes the drawer. `asChild` merges onto the child element. */
 export function DrawerClose(props) {
-    return React.createElement(_Close, { ...props });
+    const { drawer } = useAdapter();
+    return React.createElement(drawer.Close, { ...props });
 }

package/esm/src/react/components/ui/dropdown-menu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dropdown-menu.d.ts","sourceRoot":"","sources":["../../../../../src/src/react/components/ui/dropdown-menu.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"dropdown-menu.d.ts","sourceRoot":"","sources":["../../../../../src/src/react/components/ui/dropdown-menu.tsx"],"names":[],"mappings":"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"}

package/esm/src/react/components/ui/dropdown-menu.js

@@ -9,8 +9,8 @@ import * as React from "react";
 import { cx as cn } from "./cva.js";
 import { getPolymorphicButtonType, Slot } from "./slot.js";
 import { createAnchoredSurfaceParts, } from "./anchored-surface.js";
-import { focusWithoutScroll, getFocusableElements } from "./focus-management.js";
-const TYPEAHEAD_RESET_MS = 700;
+import { focusWithoutScroll } from "./focus-management.js";
+import { useMenuContentKeyboard } from "./menu-keyboard.js";
 // Per-skin context + machinery -- distinct from Popover's instance so a
 // Popover nested inside a DropdownMenu cannot accidentally close the menu.
 const { Context: _ctx, AnchoredRoot: _Root, AnchoredTrigger: _Trigger, AnchoredContent: _Content } = createAnchoredSurfaceParts();
@@ -27,79 +27,11 @@ export function DropdownMenuContent({ children, className, align = "start", onKe
     if (!ctx) {
         throw new Error("DropdownMenuContent must be used within <DropdownMenu>");
     }
-    const typeaheadRef = React.useRef({ buffer: "", lastTypedAt: 0 });
-    const handleKeyDown = (event) => {
-        onKeyDown?.(event);
-        if (event.defaultPrevented ||
-            event.nativeEvent.isComposing ||
-            event.nativeEvent.keyCode === 229) {
-            return;
-        }
-        const items = [...event.currentTarget.querySelectorAll("[role='menuitem']:not([aria-disabled='true'])")];
-        const activeIndex = items.indexOf(event.currentTarget.ownerDocument.activeElement);
-        const focusAt = (index) => {
-            const item = items[(index + items.length) % items.length];
-            if (item)
-                focusWithoutScroll(item);
-        };
-        switch (event.key) {
-            case "ArrowDown":
-                event.preventDefault();
-                focusAt(activeIndex + 1);
-                return;
-            case "ArrowUp":
-                event.preventDefault();
-                focusAt(activeIndex < 0 ? items.length - 1 : activeIndex - 1);
-                return;
-            case "Home":
-                event.preventDefault();
-                focusAt(0);
-                return;
-            case "End":
-                event.preventDefault();
-                focusAt(items.length - 1);
-                return;
-            case "Tab": {
-                event.preventDefault();
-                const trigger = ctx.triggerRef.current;
-                const document = event.currentTarget.ownerDocument;
-                const candidates = getFocusableElements(document.body).filter((element) => !event.currentTarget.contains(element));
-                const triggerIndex = trigger ? candidates.indexOf(trigger) : -1;
-                const next = event.shiftKey ? candidates[triggerIndex - 1] : candidates[triggerIndex + 1];
-                ctx.setOpen(false);
-                queueMicrotask(() => {
-                    if (next?.isConnected)
-                        focusWithoutScroll(next);
-                    else if (trigger?.isConnected)
-                        focusWithoutScroll(trigger);
-                });
-                return;
-            }
-        }
-        if (event.key.length !== 1 || event.altKey || event.ctrlKey ||
-            event.metaKey) {
-            return;
-        }
-        const now = Date.now();
-        const previous = typeaheadRef.current;
-        const buffer = now - previous.lastTypedAt > TYPEAHEAD_RESET_MS
-            ? event.key
-            : previous.buffer + event.key;
-        typeaheadRef.current = { buffer, lastTypedAt: now };
-        const normalizedBuffer = buffer.normalize("NFKC").toLocaleLowerCase();
-        const repeatedCharacter = [...normalizedBuffer].every((character) => character === normalizedBuffer[0]);
-        const query = repeatedCharacter ? normalizedBuffer[0] : normalizedBuffer;
-        for (let offset = 1; offset <= items.length; offset += 1) {
-            const item = items[(activeIndex + offset + items.length) % items.length];
-            const text = item?.textContent?.normalize("NFKC").trim()
-                .replace(/\s+/g, " ").toLocaleLowerCase();
-            if (item && text?.startsWith(query)) {
-                event.preventDefault();
-                focusWithoutScroll(item);
-                break;
-            }
-        }
-    };
+    const handleKeyDown = useMenuContentKeyboard({
+        onKeyDown,
+        setOpen: ctx.setOpen,
+        triggerRef: ctx.triggerRef,
+    });
     return (React.createElement(_Content, { ...props, role: "menu", "aria-orientation": "vertical", align: align, initialFocus: "[role='menuitem']:not([aria-disabled='true'])", onKeyDown: handleKeyDown, className: cn("min-w-[260px] p-2.5", className) }, children));
 }
 /** Groups related items with a tight inner gap (Studio: `gap-px p-0.5`). */

package/esm/src/react/components/ui/field.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Field: a form-field wrapper that wires a label, description, and error to a
+ * single control for accessibility. `<Field>` derives a stable base id with
+ * `React.useId()` and shares it (plus derived description/error ids and the
+ * `invalid` flag) through context, so `<FieldLabel>` targets the control via
+ * `htmlFor`, `<FieldControl>` clones its child with the matching `id` +
+ * `aria-describedby` + `aria-invalid`, and `<FieldDescription>` / `<FieldError>`
+ * expose the referenced ids. Self-contained; skinned with the veryfront theme
+ * tokens.
+ *
+ * @example
+ * ```tsx
+ * import { Field, FieldLabel, FieldControl, FieldDescription, FieldError } from "veryfront/ui";
+ * import { Input } from "veryfront/ui";
+ *
+ * <Field invalid>
+ *   <FieldLabel>Email</FieldLabel>
+ *   <FieldControl><Input type="email" /></FieldControl>
+ *   <FieldDescription>Veryfront never shares it.</FieldDescription>
+ *   <FieldError>Enter a valid email.</FieldError>
+ * </Field>;
+ * ```
+ *
+ * @module react/components/ui/field
+ */
+import * as React from "react";
+/** Props accepted by `<Field>`. */
+export interface FieldProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Mark the field invalid: flags the label/control/error via context. @default false */
+    invalid?: boolean;
+    /** React 19: ref is a regular prop. */
+    ref?: React.Ref<HTMLDivElement>;
+}
+/** The field wrapper: derives ids and provides them to its sub-parts. */
+export declare function Field({ invalid, className, children, ref, ...props }: FieldProps): React.ReactElement;
+/** Props accepted by `<FieldLabel>`. */
+export interface FieldLabelProps extends React.LabelHTMLAttributes<HTMLLabelElement> {
+    /** React 19: ref is a regular prop. */
+    ref?: React.Ref<HTMLLabelElement>;
+}
+/** The field's label: wired to the control with `htmlFor`. */
+export declare function FieldLabel({ className, children, ref, ...props }: FieldLabelProps): React.ReactElement;
+/** Props accepted by `<FieldControl>`. */
+export interface FieldControlProps {
+    /** The single form control element to wire: its `id`/`aria-*` are set for you. */
+    children: React.ReactElement;
+    /** React 19: ref is forwarded onto the cloned child control (not a wrapper node). */
+    ref?: React.Ref<HTMLElement>;
+}
+/**
+ * Wiring wrapper: renders no node of its own; clones its single child control
+ * with the shared `id`, `aria-describedby` (the description, plus the error id
+ * when invalid), and `aria-invalid`.
+ */
+export declare function FieldControl({ children, ref }: FieldControlProps): React.ReactElement;
+/** Props accepted by `<FieldDescription>`. */
+export interface FieldDescriptionProps extends React.HTMLAttributes<HTMLParagraphElement> {
+    /** React 19: ref is a regular prop. */
+    ref?: React.Ref<HTMLParagraphElement>;
+}
+/** Helper text describing the field: referenced by the control's `aria-describedby`. */
+export declare function FieldDescription({ className, children, id, ref, ...props }: FieldDescriptionProps): React.ReactElement;
+/** Props accepted by `<FieldError>`. */
+export interface FieldErrorProps extends React.HTMLAttributes<HTMLParagraphElement> {
+    /** React 19: ref is a regular prop. */
+    ref?: React.Ref<HTMLParagraphElement>;
+}
+/** The field's error message: a live `role="alert"`; renders nothing when empty. */
+export declare function FieldError({ className, children, id, ref, ...props }: FieldErrorProps): React.ReactElement | null;
+//# sourceMappingURL=field.d.ts.map

package/esm/src/react/components/ui/field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../../../../src/src/react/components/ui/field.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAmE/B,mCAAmC;AACnC,MAAM,WAAW,UAAW,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACtE,wFAAwF;IACxF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uCAAuC;IACvC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;CACjC;AAED,yEAAyE;AACzE,wBAAgB,KAAK,CAAC,EACpB,OAAe,EACf,SAAS,EACT,QAAQ,EACR,GAAG,EACH,GAAG,KAAK,EACT,EAAE,UAAU,GAAG,KAAK,CAAC,YAAY,CAoDjC;AAED,wCAAwC;AACxC,MAAM,WAAW,eAAgB,SAAQ,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC;IAClF,uCAAuC;IACvC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;CACnC;AAED,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,EACzB,SAAS,EACT,QAAQ,EACR,GAAG,EACH,GAAG,KAAK,EACT,EAAE,eAAe,GAAG,KAAK,CAAC,YAAY,CAiBtC;AAED,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC;IAC7B,qFAAqF;IACrF,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,iBAAiB,GAAG,KAAK,CAAC,YAAY,CAuBrF;AAED,8CAA8C;AAC9C,MAAM,WAAW,qBAAsB,SAAQ,KAAK,CAAC,cAAc,CAAC,oBAAoB,CAAC;IACvF,uCAAuC;IACvC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;CACvC;AAED,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,EAC/B,SAAS,EACT,QAAQ,EACR,EAAE,EACF,GAAG,EACH,GAAG,KAAK,EACT,EAAE,qBAAqB,GAAG,KAAK,CAAC,YAAY,CAiB5C;AAED,wCAAwC;AACxC,MAAM,WAAW,eAAgB,SAAQ,KAAK,CAAC,cAAc,CAAC,oBAAoB,CAAC;IACjF,uCAAuC;IACvC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;CACvC;AAED,oFAAoF;AACpF,wBAAgB,UAAU,CAAC,EACzB,SAAS,EACT,QAAQ,EACR,EAAE,EACF,GAAG,EACH,GAAG,KAAK,EACT,EAAE,eAAe,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAqB7C"}