@nsaa/core 0.1.0-alpha.2 → 0.1.0-alpha.3

package/README.md

@@ -17,7 +17,20 @@ import { Button, SoundProvider } from "@nsaa/core";
 ```
 
 Fonts are yours to load: the tokens name Geist (body), Newsreader (the editorial theme) and Geist
-Mono, and fall back to the system sans. For example, in your HTML `<head>`:
+Mono, and fall back to the system sans. Self-host them with Fontsource (works under a strict CSP such
+as `font-src 'self'`; the tokens list the Fontsource names first, so no `@font-face` is needed):
+
+```sh
+pnpm add @fontsource-variable/geist @fontsource-variable/geist-mono @fontsource-variable/newsreader
+```
+
+```css
+@import "@fontsource-variable/geist";
+@import "@fontsource-variable/geist-mono";
+@import "@fontsource-variable/newsreader"; /* editorial theme only */
+```
+
+Or link Google Fonts in your HTML `<head>`:
 
 ```html
 <link rel="preconnect" href="https://fonts.googleapis.com" />
@@ -28,12 +41,21 @@ Mono, and fall back to the system sans. For example, in your HTML `<head>`:
 />
 ```
 
-| Entry                     | What                                                                          |
-| ------------------------- | ----------------------------------------------------------------------------- |
-| `@nsaa/core`              | components, `SoundProvider`, `LoaderProvider`, `Spinner` (featured 8 loaders) |
-| `@nsaa/core/loaders`      | all 29 loading.dev loaders, `registerLoaders`                                 |
-| `@nsaa/core/loaders/text` | text and AI loaders (ShimmerText, Typing, …)                                  |
-| `@nsaa/core/sound-uisfx`  | the UISFX sound engine for `SoundProvider`                                    |
-| `@nsaa/core/styles.css`   | tokens, the shadcn alias layer and the feel layer                             |
+Sound: `lazyUisfxPlayer()` (recommended) loads the UISFX engine on the first interaction;
+`createUisfxPlayer()` from `@nsaa/core/sound-uisfx` loads it up front.
+
+```tsx
+const player = lazyUisfxPlayer();
+<SoundProvider player={player}>…</SoundProvider>;
+```
+
+| Entry                        | What                                                                                 |
+| ---------------------------- | ------------------------------------------------------------------------------------ |
+| `@nsaa/core`                 | components, `SoundProvider`, `lazyUisfxPlayer`, `LoaderProvider`, `Spinner`          |
+| `@nsaa/core/loaders`         | all 29 loading.dev loaders, `registerLoaders`                                        |
+| `@nsaa/core/loaders/text`    | text and AI loaders (ShimmerText, Typing, …)                                         |
+| `@nsaa/core/sound-uisfx`     | the UISFX sound engine for `SoundProvider`                                           |
+| `@nsaa/core/styles.css`      | tokens, the shadcn alias layer, the feel layer, every component's sources            |
+| `@nsaa/core/styles-base.css` | the same without Tailwind sources; add `@nsaa/core/sources/<name>.css` per component |
 
 Peer dependencies: `react` and `react-dom` 19. MIT; third-party notices in `NOTICE`.

package/dist/_virtual/_rolldown/runtime.js

@@ -0,0 +1,13 @@
+"use client";
+// \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+export { __exportAll };

package/dist/alert/alert.d.ts

@@ -2,13 +2,14 @@
 import { VariantProps } from "class-variance-authority";
 import * as React from "react";
 declare const alertVariants: (props?: ({
-  variant?: "default" | "destructive" | null | undefined;
+  variant?: "success" | "warning" | "default" | "destructive" | "info" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 declare function Alert({ className, variant, announce, ...props }: React.ComponentProps<"div"> & VariantProps<typeof alertVariants> & {
   /**
    * The error sound (feedback.error) when the Alert appears (#114). Left unset it's automatic: a
    * destructive Alert plays it when a person's action caused it (within the browser's transient
-   * activation window), never on load. `true` always plays it, `false` never does.
+   * activation window), never on load. `true` always plays it, `false` never does. Success and
+   * warning are silent unless `announce` is set, then play feedback.success / feedback.warning.
    */
   announce?: boolean;
 }): React.JSX.Element;

package/dist/alert/alert.js

@@ -9,15 +9,20 @@ import * as React from "react";
 const alertVariants = cva("group/alert relative grid w-full gap-0.5 rounded-lg border px-2.5 py-2 text-left text-sm has-data-[slot=alert-action]:relative has-data-[slot=alert-action]:pr-18 has-[>svg]:grid-cols-[auto_1fr] has-[>svg]:gap-x-2 *:[svg]:row-span-2 *:[svg]:translate-y-0.5 *:[svg]:text-current *:[svg:not([class*='size-'])]:size-4", {
 	variants: { variant: {
 		default: "bg-card text-card-foreground",
-		destructive: "bg-card text-destructive *:data-[slot=alert-description]:text-destructive/90 *:[svg]:text-current"
+		destructive: "bg-card text-destructive *:data-[slot=alert-description]:text-destructive/90 *:[svg]:text-current",
+		success: "border-positive-subtle-active bg-positive-subtle text-on-positive-subtle-foreground *:data-[slot=alert-description]:text-on-positive-subtle-foreground",
+		warning: "border-warning-subtle-active bg-warning-subtle text-on-warning-subtle-foreground *:data-[slot=alert-description]:text-on-warning-subtle-foreground",
+		info: "border-info-subtle-active bg-info-subtle text-on-info-subtle-foreground *:data-[slot=alert-description]:text-on-info-subtle-foreground"
 	} },
 	defaultVariants: { variant: "default" }
 });
 function Alert({ className, variant, announce, ...props }) {
 	const cue = useCue("alert");
 	const destructive = variant === "destructive";
+	const announceCue = variant === "success" || variant === "warning" ? variant : "destructive";
 	const appear = React.useEffectEvent(() => {
-		if (announce === true || destructive && recentUserAction()) cue("destructive");
+		if (variant === "info") return;
+		if (announce === true || destructive && recentUserAction()) cue(announceCue);
 	});
 	React.useEffect(() => {
 		if (announce !== false && (destructive || announce)) appear();

package/dist/alert-dialog/alert-dialog.js

@@ -3,18 +3,23 @@
 import { cn } from "../lib/cn.js";
 import { useCue } from "../sound/sound-map.js";
 import { Button } from "../button/button.js";
+import { OpenerContext, useFinalFocus, useOpener } from "../lib/opener.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { AlertDialog } from "@base-ui/react/alert-dialog";
 // src/alert-dialog/alert-dialog.tsx
 function AlertDialog$1({ onOpenChange, ...props }) {
 	const cue = useCue("alert-dialog");
-	return /* @__PURE__ */ jsx(AlertDialog.Root, {
-		"data-slot": "alert-dialog",
-		onOpenChange: (open, details) => {
-			onOpenChange?.(open, details);
-			if (!details.isCanceled) cue(open ? "open" : "close");
-		},
-		...props
+	const opener = useOpener(props.open);
+	return /* @__PURE__ */ jsx(OpenerContext.Provider, {
+		value: opener,
+		children: /* @__PURE__ */ jsx(AlertDialog.Root, {
+			"data-slot": "alert-dialog",
+			onOpenChange: (open, details) => {
+				onOpenChange?.(open, details);
+				if (!details.isCanceled) cue(open ? "open" : "close");
+			},
+			...props
+		})
 	});
 }
 function AlertDialogTrigger({ ...props }) {
@@ -37,6 +42,7 @@ function AlertDialogOverlay({ className, ...props }) {
 	});
 }
 function AlertDialogContent({ className, size = "default", ...props }) {
+	props.finalFocus = useFinalFocus(props.finalFocus);
 	return /* @__PURE__ */ jsxs(AlertDialogPortal, { children: [/* @__PURE__ */ jsx(AlertDialogOverlay, {}), /* @__PURE__ */ jsx(AlertDialog.Popup, {
 		"data-slot": "alert-dialog-content",
 		"data-size": size,

package/dist/dialog/dialog.js

@@ -3,18 +3,23 @@
 import { cn } from "../lib/cn.js";
 import { useCue } from "../sound/sound-map.js";
 import { Button } from "../button/button.js";
+import { OpenerContext, useFinalFocus, useOpener } from "../lib/opener.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { Dialog } from "@base-ui/react/dialog";
 // src/dialog/dialog.tsx
 function Dialog$1({ onOpenChange, ...props }) {
 	const cue = useCue("dialog");
-	return /* @__PURE__ */ jsx(Dialog.Root, {
-		"data-slot": "dialog",
-		onOpenChange: (open, details) => {
-			onOpenChange?.(open, details);
-			if (!details.isCanceled) cue(open ? "open" : "close");
-		},
-		...props
+	const opener = useOpener(props.open);
+	return /* @__PURE__ */ jsx(OpenerContext.Provider, {
+		value: opener,
+		children: /* @__PURE__ */ jsx(Dialog.Root, {
+			"data-slot": "dialog",
+			onOpenChange: (open, details) => {
+				onOpenChange?.(open, details);
+				if (!details.isCanceled) cue(open ? "open" : "close");
+			},
+			...props
+		})
 	});
 }
 function DialogTrigger({ ...props }) {
@@ -43,6 +48,7 @@ function DialogOverlay({ className, ...props }) {
 	});
 }
 function DialogContent({ className, children, showCloseButton = true, ...props }) {
+	props.finalFocus = useFinalFocus(props.finalFocus);
 	return /* @__PURE__ */ jsxs(DialogPortal, { children: [/* @__PURE__ */ jsx(DialogOverlay, {}), /* @__PURE__ */ jsxs(Dialog.Popup, {
 		"data-slot": "dialog-content",
 		className: cn("fixed top-1/2 left-1/2 z-50 grid w-full max-w-[calc(100%-2rem)] -translate-x-1/2 -translate-y-1/2 gap-4 rounded-xl bg-popover p-4 text-sm text-popover-foreground ring-1 ring-foreground/10 duration-100 outline-none sm:max-w-sm data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95", className),

package/dist/index.d.ts

@@ -65,6 +65,7 @@ import "./skeleton/index.js";
 import { Slider } from "./slider/slider.js";
 import "./slider/index.js";
 import { SoundCue, SoundPlayer, SoundProvider, SoundProviderProps, useSound } from "./sound/sound.js";
+import { lazyUisfxPlayer } from "./sound/lazy-uisfx.js";
 import { SOUND_MAP, SoundComponent } from "./sound/sound-map.js";
 import { LoaderProvider, LoaderProviderProps } from "./spinner/loader-provider.js";
 import { LoaderComponent, registerLoader, registerLoaders } from "./spinner/registry.js";
@@ -87,4 +88,4 @@ import "./toolbar/index.js";
 import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "./tooltip/tooltip.js";
 import "./tooltip/index.js";
 import "./lib/track-input-modality.js";
-export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertAction, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogMedia, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, Avatar, AvatarBadge, AvatarFallback, AvatarGroup, AvatarGroupCount, AvatarImage, Badge, Button, Calendar, CalendarDayButton, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, Combobox, ComboboxChip, ComboboxChips, ComboboxChipsInput, ComboboxCollection, ComboboxContent, ComboboxEmpty, ComboboxGroup, ComboboxInput, ComboboxItem, ComboboxLabel, ComboboxList, ComboboxSeparator, ComboboxTrigger, ComboboxValue, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DirectionProvider, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerSwipeHandle, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Empty, EmptyContent, EmptyDescription, EmptyHeader, type EmptyIllustrationOptions, EmptyMedia, EmptyTitle, Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, FieldSeparator, FieldSet, FieldTitle, IconSwap, type IconSwapProps, Input, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputGroupTextarea, InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot, Kbd, KbdGroup, Label, type LoaderComponent, LoaderProvider, type LoaderProviderProps, NativeSelect, NativeSelectOptGroup, NativeSelectOption, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, Popover, PopoverContent, PopoverDescription, PopoverHeader, PopoverTitle, PopoverTrigger, RadioGroup, RadioGroupItem, SOUND_MAP, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Skeleton, SkeletonContent, Slider, type SoundComponent, type SoundCue, type SoundPlayer, SoundProvider, type SoundProviderProps, Spinner, type SpinnerProps, type SpinnerVariant, Switch, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, Toast, ToastAction, ToastClose, ToastContent, ToastDescription, ToastPortal, ToastProvider, ToastTitle, ToastViewport, Toaster, ToggleGroup, type ToggleGroupItemProps, type ToggleGroupMultipleProps, type ToggleGroupProps, type ToggleGroupSingleProps, type ToggleGroupSize, type ToggleGroupVariant, Toolbar, type ToolbarButtonProps, type ToolbarGroupProps, type ToolbarInputProps, type ToolbarLinkProps, type ToolbarProps, type ToolbarSize, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, badgeVariants, buttonVariants, cn, createToastManager, registerLoader, registerLoaders, tabsListVariants, toast, useComboboxAnchor, useEmptyIllustration, useSound, useToastManager };
+export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertAction, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogMedia, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, Avatar, AvatarBadge, AvatarFallback, AvatarGroup, AvatarGroupCount, AvatarImage, Badge, Button, Calendar, CalendarDayButton, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, Combobox, ComboboxChip, ComboboxChips, ComboboxChipsInput, ComboboxCollection, ComboboxContent, ComboboxEmpty, ComboboxGroup, ComboboxInput, ComboboxItem, ComboboxLabel, ComboboxList, ComboboxSeparator, ComboboxTrigger, ComboboxValue, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DirectionProvider, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerSwipeHandle, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Empty, EmptyContent, EmptyDescription, EmptyHeader, type EmptyIllustrationOptions, EmptyMedia, EmptyTitle, Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, FieldSeparator, FieldSet, FieldTitle, IconSwap, type IconSwapProps, Input, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputGroupTextarea, InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot, Kbd, KbdGroup, Label, type LoaderComponent, LoaderProvider, type LoaderProviderProps, NativeSelect, NativeSelectOptGroup, NativeSelectOption, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, Popover, PopoverContent, PopoverDescription, PopoverHeader, PopoverTitle, PopoverTrigger, RadioGroup, RadioGroupItem, SOUND_MAP, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Skeleton, SkeletonContent, Slider, type SoundComponent, type SoundCue, type SoundPlayer, SoundProvider, type SoundProviderProps, Spinner, type SpinnerProps, type SpinnerVariant, Switch, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, Toast, ToastAction, ToastClose, ToastContent, ToastDescription, ToastPortal, ToastProvider, ToastTitle, ToastViewport, Toaster, ToggleGroup, type ToggleGroupItemProps, type ToggleGroupMultipleProps, type ToggleGroupProps, type ToggleGroupSingleProps, type ToggleGroupSize, type ToggleGroupVariant, Toolbar, type ToolbarButtonProps, type ToolbarGroupProps, type ToolbarInputProps, type ToolbarLinkProps, type ToolbarProps, type ToolbarSize, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, badgeVariants, buttonVariants, cn, createToastManager, lazyUisfxPlayer, registerLoader, registerLoaders, tabsListVariants, toast, useComboboxAnchor, useEmptyIllustration, useSound, useToastManager };

package/dist/index.js

@@ -39,6 +39,7 @@ import { RadioGroup, RadioGroupItem } from "./radio-group/radio-group.js";
 import { Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue } from "./select/select.js";
 import { Skeleton, SkeletonContent } from "./skeleton/skeleton.js";
 import { Slider } from "./slider/slider.js";
+import { lazyUisfxPlayer } from "./sound/lazy-uisfx.js";
 import { Switch } from "./switch/switch.js";
 import { Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow } from "./table/table.js";
 import { Tabs, TabsContent, TabsList, TabsTrigger, tabsListVariants } from "./tabs/tabs.js";
@@ -47,4 +48,4 @@ import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "./tool
 import { ToggleGroup } from "./toggle-group/toggle-group.js";
 import { Toolbar } from "./toolbar/toolbar.js";
 import "./lib/track-input-modality.js";
-export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertAction, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogMedia, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, Avatar, AvatarBadge, AvatarFallback, AvatarGroup, AvatarGroupCount, AvatarImage, Badge, Button, Calendar, CalendarDayButton, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, Combobox, ComboboxChip, ComboboxChips, ComboboxChipsInput, ComboboxCollection, ComboboxContent, ComboboxEmpty, ComboboxGroup, ComboboxInput, ComboboxItem, ComboboxLabel, ComboboxList, ComboboxSeparator, ComboboxTrigger, ComboboxValue, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DirectionProvider, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerSwipeHandle, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyMedia, EmptyTitle, Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, FieldSeparator, FieldSet, FieldTitle, IconSwap, Input, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputGroupTextarea, InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot, Kbd, KbdGroup, Label, LoaderProvider, NativeSelect, NativeSelectOptGroup, NativeSelectOption, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, Popover, PopoverContent, PopoverDescription, PopoverHeader, PopoverTitle, PopoverTrigger, RadioGroup, RadioGroupItem, SOUND_MAP, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Skeleton, SkeletonContent, Slider, SoundProvider, Spinner, Switch, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, Toast, ToastAction, ToastClose, ToastContent, ToastDescription, ToastPortal, ToastProvider, ToastTitle, ToastViewport, Toaster, ToggleGroup, Toolbar, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, badgeVariants, buttonVariants, cn, createToastManager, registerLoader, registerLoaders, tabsListVariants, toast, useComboboxAnchor, useEmptyIllustration, useSound, useToastManager };
+export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertAction, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogMedia, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, Avatar, AvatarBadge, AvatarFallback, AvatarGroup, AvatarGroupCount, AvatarImage, Badge, Button, Calendar, CalendarDayButton, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, Combobox, ComboboxChip, ComboboxChips, ComboboxChipsInput, ComboboxCollection, ComboboxContent, ComboboxEmpty, ComboboxGroup, ComboboxInput, ComboboxItem, ComboboxLabel, ComboboxList, ComboboxSeparator, ComboboxTrigger, ComboboxValue, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DirectionProvider, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerSwipeHandle, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyMedia, EmptyTitle, Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, FieldSeparator, FieldSet, FieldTitle, IconSwap, Input, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputGroupTextarea, InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot, Kbd, KbdGroup, Label, LoaderProvider, NativeSelect, NativeSelectOptGroup, NativeSelectOption, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, Popover, PopoverContent, PopoverDescription, PopoverHeader, PopoverTitle, PopoverTrigger, RadioGroup, RadioGroupItem, SOUND_MAP, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Skeleton, SkeletonContent, Slider, SoundProvider, Spinner, Switch, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, Toast, ToastAction, ToastClose, ToastContent, ToastDescription, ToastPortal, ToastProvider, ToastTitle, ToastViewport, Toaster, ToggleGroup, Toolbar, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, badgeVariants, buttonVariants, cn, createToastManager, lazyUisfxPlayer, registerLoader, registerLoaders, tabsListVariants, toast, useComboboxAnchor, useEmptyIllustration, useSound, useToastManager };

package/dist/lib/opener.js

@@ -0,0 +1,29 @@
+"use client";
+import { createContext, useContext, useState } from "react";
+// src/lib/opener.ts
+/**
+* The element that had focus as a controlled dialog opened, recorded during render (#144). React
+* focuses an `autoFocus` field inside the popup on mount, before Base UI records the opener, so
+* with no Trigger focus would fall to `body` on close. (React's "store information from previous
+* renders" pattern: the state update re-renders before anything inside the popup mounts.)
+*/
+function useOpener(open) {
+	const [wasOpen, setWasOpen] = useState(false);
+	const [opener, setOpener] = useState(null);
+	if (!!open !== wasOpen) {
+		setWasOpen(!!open);
+		if (open && typeof document !== "undefined") {
+			const active = document.activeElement;
+			setOpener(active instanceof HTMLElement && active !== document.body ? active : null);
+		}
+	}
+	return opener;
+}
+const OpenerContext = createContext(null);
+/** The popup's `finalFocus`: the app's own, else the recorded opener while it is still in the page. */
+function useFinalFocus(own) {
+	const opener = useContext(OpenerContext);
+	if (own !== void 0 || !opener) return own;
+	return () => opener.isConnected ? opener : true;
+}
+export { OpenerContext, useFinalFocus, useOpener };

package/dist/sound/lazy-uisfx.d.ts

@@ -0,0 +1,20 @@
+
+import { UisfxPlayerOptions, UisfxSoundPlayer, uisfx_d_exports } from "./uisfx.js";
+type Engine = typeof uisfx_d_exports;
+/**
+ * The recommended sound setup (#144): a `SoundPlayer` that loads the UISFX engine on first use, so
+ * it stays out of the app's first load. The first trusted pointer or key action starts the import
+ * (cues before it finishes are skipped, as they would be before unlocking anyway). If the import
+ * fails, say offline, it stays silent and tries again on the next interaction; a cue never throws.
+ *
+ * Create one per app, at module scope:
+ *
+ * ```tsx
+ * const player = lazyUisfxPlayer();
+ * <SoundProvider player={player}>…</SoundProvider>
+ * ```
+ */
+export declare function lazyUisfxPlayer(options?: UisfxPlayerOptions,
+/** @internal Tests swap the import. */
+importEngine?: () => Promise<Engine>): UisfxSoundPlayer;
+export {};

package/dist/sound/lazy-uisfx.js

@@ -0,0 +1,68 @@
+"use client";
+import { sound } from "../tokens/dist/motion.js";
+// src/sound/lazy-uisfx.ts
+const GESTURES = ["pointerdown", "keydown"];
+/**
+* The recommended sound setup (#144): a `SoundPlayer` that loads the UISFX engine on first use, so
+* it stays out of the app's first load. The first trusted pointer or key action starts the import
+* (cues before it finishes are skipped, as they would be before unlocking anyway). If the import
+* fails, say offline, it stays silent and tries again on the next interaction; a cue never throws.
+*
+* Create one per app, at module scope:
+*
+* ```tsx
+* const player = lazyUisfxPlayer();
+* <SoundProvider player={player}>…</SoundProvider>
+* ```
+*/
+function lazyUisfxPlayer(options = {}, importEngine = () => import("./uisfx.js")) {
+	let engine = null;
+	let loading = false;
+	let pack = options.pack;
+	let gestured = false;
+	const listenOn = options.target ?? (typeof window === "undefined" ? void 0 : window);
+	const stopListening = () => {
+		for (const type of GESTURES) listenOn?.removeEventListener(type, onGesture, true);
+	};
+	const load = () => {
+		if (engine || loading) return;
+		loading = true;
+		importEngine().then(({ createUisfxPlayer }) => {
+			engine = createUisfxPlayer({
+				...options,
+				pack
+			});
+			stopListening();
+			if (gestured) engine.unlock();
+		}).catch(() => {}).finally(() => {
+			loading = false;
+		});
+	};
+	function onGesture(event) {
+		if (!event.isTrusted) return;
+		gestured = true;
+		load();
+	}
+	for (const type of GESTURES) listenOn?.addEventListener(type, onGesture, true);
+	const play = ((cue, playOptions) => {
+		if (engine) return engine(cue, playOptions);
+		load();
+	});
+	play.setPack = (next) => {
+		pack = next;
+		engine?.setPack(next);
+	};
+	play.getPack = () => engine?.getPack() ?? pack ?? sound.feel;
+	play.isUnlocked = () => engine?.isUnlocked() ?? false;
+	play.unlock = () => {
+		gestured = true;
+		if (engine) engine.unlock();
+		else load();
+	};
+	play.destroy = async () => {
+		stopListening();
+		await engine?.destroy();
+	};
+	return play;
+}
+export { lazyUisfxPlayer };

package/dist/sound/sound-map.d.ts

@@ -30,6 +30,8 @@ export declare const SOUND_MAP: {
   };
   readonly alert: {
     readonly destructive: "feedback.error";
+    readonly success: "feedback.success";
+    readonly warning: "feedback.warning";
   };
   readonly dialog: {
     readonly open: "navigation.open";

package/dist/sound/sound-map.js

@@ -21,7 +21,11 @@ const SOUND_MAP = {
 	},
 	slider: { commit: "movement.snap" },
 	"input-otp": { invalid: "feedback.error" },
-	alert: { destructive: "feedback.error" },
+	alert: {
+		destructive: "feedback.error",
+		success: "feedback.success",
+		warning: "feedback.warning"
+	},
 	dialog: {
 		open: "navigation.open",
 		close: "navigation.close"

package/dist/sound/uisfx.d.ts

@@ -1,6 +1,9 @@
 
 import { SoundPlayer } from "./sound.js";
 import { PackName } from "uisfx";
+declare namespace uisfx_d_exports {
+  export { SoundPack, UisfxPlayerOptions, UisfxSoundPlayer, createUisfxPlayer, soundPacks };
+}
 export type SoundPack = PackName;
 /** Every UISFX pack, for pickers. */
 export declare const soundPacks: readonly SoundPack[];
@@ -34,4 +37,5 @@ export interface UisfxSoundPlayer extends SoundPlayer {
  * <SoundProvider player={player}>…</SoundProvider>
  * ```
  */
-export declare function createUisfxPlayer({ pack, target }?: UisfxPlayerOptions): UisfxSoundPlayer;
+export declare function createUisfxPlayer({ pack, target }?: UisfxPlayerOptions): UisfxSoundPlayer;
+export { uisfx_d_exports };

package/dist/sources/accordion.css

@@ -0,0 +1,3 @@
+/* @nsaa/core: Tailwind sources for accordion (generated). */
+@source "../accordion/accordion.js";
+@source "../lib/cn.js";

package/dist/sources/alert-dialog.css

@@ -0,0 +1,26 @@
+/* @nsaa/core: Tailwind sources for alert-dialog (generated). */
+@source "../alert-dialog/alert-dialog.js";
+@source "../button/button.js";
+@source "../lib/cn.js";
+@source "../lib/control-defaults.js";
+@source "../lib/opener.js";
+@source "../lib/use-press.js";
+@source "../loaders/arc.js";
+@source "../loaders/bouncing-dots.js";
+@source "../loaders/cap.js";
+@source "../loaders/circular-dots.js";
+@source "../loaders/classic.js";
+@source "../loaders/easing.js";
+@source "../loaders/fade.js";
+@source "../loaders/frame.js";
+@source "../loaders/motion.js";
+@source "../loaders/orbit.js";
+@source "../loaders/pulse.js";
+@source "../loaders/ring.js";
+@source "../loaders/wave.js";
+@source "../sound/sound-map.js";
+@source "../sound/sound.js";
+@source "../spinner/loader-provider.js";
+@source "../spinner/registry.js";
+@source "../spinner/spinner.js";
+@source "../tokens/dist/motion.js";

package/dist/sources/alert.css

@@ -0,0 +1,8 @@
+/* @nsaa/core: Tailwind sources for alert (generated). */
+@source "../alert/alert.js";
+@source "../lib/cn.js";
+@source "../lib/input-modality.js";
+@source "../lib/user-action.js";
+@source "../sound/sound-map.js";
+@source "../sound/sound.js";
+@source "../tokens/dist/motion.js";

package/dist/sources/avatar.css

@@ -0,0 +1,3 @@
+/* @nsaa/core: Tailwind sources for avatar (generated). */
+@source "../avatar/avatar.js";
+@source "../lib/cn.js";

package/dist/sources/badge.css

@@ -0,0 +1,3 @@
+/* @nsaa/core: Tailwind sources for badge (generated). */
+@source "../badge/badge.js";
+@source "../lib/cn.js";

package/dist/sources/button.css

@@ -0,0 +1,24 @@
+/* @nsaa/core: Tailwind sources for button (generated). */
+@source "../button/button.js";
+@source "../lib/cn.js";
+@source "../lib/control-defaults.js";
+@source "../lib/use-press.js";
+@source "../loaders/arc.js";
+@source "../loaders/bouncing-dots.js";
+@source "../loaders/cap.js";
+@source "../loaders/circular-dots.js";
+@source "../loaders/classic.js";
+@source "../loaders/easing.js";
+@source "../loaders/fade.js";
+@source "../loaders/frame.js";
+@source "../loaders/motion.js";
+@source "../loaders/orbit.js";
+@source "../loaders/pulse.js";
+@source "../loaders/ring.js";
+@source "../loaders/wave.js";
+@source "../sound/sound-map.js";
+@source "../sound/sound.js";
+@source "../spinner/loader-provider.js";
+@source "../spinner/registry.js";
+@source "../spinner/spinner.js";
+@source "../tokens/dist/motion.js";

package/dist/sources/calendar.css

@@ -0,0 +1,25 @@
+/* @nsaa/core: Tailwind sources for calendar (generated). */
+@source "../button/button.js";
+@source "../calendar/calendar.js";
+@source "../lib/cn.js";
+@source "../lib/control-defaults.js";
+@source "../lib/use-press.js";
+@source "../loaders/arc.js";
+@source "../loaders/bouncing-dots.js";
+@source "../loaders/cap.js";
+@source "../loaders/circular-dots.js";
+@source "../loaders/classic.js";
+@source "../loaders/easing.js";
+@source "../loaders/fade.js";
+@source "../loaders/frame.js";
+@source "../loaders/motion.js";
+@source "../loaders/orbit.js";
+@source "../loaders/pulse.js";
+@source "../loaders/ring.js";
+@source "../loaders/wave.js";
+@source "../sound/sound-map.js";
+@source "../sound/sound.js";
+@source "../spinner/loader-provider.js";
+@source "../spinner/registry.js";
+@source "../spinner/spinner.js";
+@source "../tokens/dist/motion.js";

package/dist/sources/card.css

@@ -0,0 +1,3 @@
+/* @nsaa/core: Tailwind sources for card (generated). */
+@source "../card/card.js";
+@source "../lib/cn.js";

package/dist/sources/checkbox.css

@@ -0,0 +1,6 @@
+/* @nsaa/core: Tailwind sources for checkbox (generated). */
+@source "../checkbox/checkbox.js";
+@source "../lib/cn.js";
+@source "../sound/sound-map.js";
+@source "../sound/sound.js";
+@source "../tokens/dist/motion.js";

package/dist/sources/collapsible.css

@@ -0,0 +1,2 @@
+/* @nsaa/core: Tailwind sources for collapsible (generated). */
+@source "../collapsible/collapsible.js";

package/dist/sources/combobox.css

@@ -0,0 +1,28 @@
+/* @nsaa/core: Tailwind sources for combobox (generated). */
+@source "../button/button.js";
+@source "../combobox/combobox.js";
+@source "../input-group/input-group.js";
+@source "../input/input.js";
+@source "../lib/cn.js";
+@source "../lib/control-defaults.js";
+@source "../lib/use-press.js";
+@source "../loaders/arc.js";
+@source "../loaders/bouncing-dots.js";
+@source "../loaders/cap.js";
+@source "../loaders/circular-dots.js";
+@source "../loaders/classic.js";
+@source "../loaders/easing.js";
+@source "../loaders/fade.js";
+@source "../loaders/frame.js";
+@source "../loaders/motion.js";
+@source "../loaders/orbit.js";
+@source "../loaders/pulse.js";
+@source "../loaders/ring.js";
+@source "../loaders/wave.js";
+@source "../sound/sound-map.js";
+@source "../sound/sound.js";
+@source "../spinner/loader-provider.js";
+@source "../spinner/registry.js";
+@source "../spinner/spinner.js";
+@source "../textarea/textarea.js";
+@source "../tokens/dist/motion.js";

package/dist/sources/command.css

@@ -0,0 +1,30 @@
+/* @nsaa/core: Tailwind sources for command (generated). */
+@source "../button/button.js";
+@source "../command/command.js";
+@source "../dialog/dialog.js";
+@source "../input-group/input-group.js";
+@source "../input/input.js";
+@source "../lib/cn.js";
+@source "../lib/control-defaults.js";
+@source "../lib/opener.js";
+@source "../lib/use-press.js";
+@source "../loaders/arc.js";
+@source "../loaders/bouncing-dots.js";
+@source "../loaders/cap.js";
+@source "../loaders/circular-dots.js";
+@source "../loaders/classic.js";
+@source "../loaders/easing.js";
+@source "../loaders/fade.js";
+@source "../loaders/frame.js";
+@source "../loaders/motion.js";
+@source "../loaders/orbit.js";
+@source "../loaders/pulse.js";
+@source "../loaders/ring.js";
+@source "../loaders/wave.js";
+@source "../sound/sound-map.js";
+@source "../sound/sound.js";
+@source "../spinner/loader-provider.js";
+@source "../spinner/registry.js";
+@source "../spinner/spinner.js";
+@source "../textarea/textarea.js";
+@source "../tokens/dist/motion.js";

package/dist/sources/context-menu.css

@@ -0,0 +1,6 @@
+/* @nsaa/core: Tailwind sources for context-menu (generated). */
+@source "../context-menu/context-menu.js";
+@source "../lib/cn.js";
+@source "../sound/sound-map.js";
+@source "../sound/sound.js";
+@source "../tokens/dist/motion.js";

package/dist/sources/dialog.css

@@ -0,0 +1,26 @@
+/* @nsaa/core: Tailwind sources for dialog (generated). */
+@source "../button/button.js";
+@source "../dialog/dialog.js";
+@source "../lib/cn.js";
+@source "../lib/control-defaults.js";
+@source "../lib/opener.js";
+@source "../lib/use-press.js";
+@source "../loaders/arc.js";
+@source "../loaders/bouncing-dots.js";
+@source "../loaders/cap.js";
+@source "../loaders/circular-dots.js";
+@source "../loaders/classic.js";
+@source "../loaders/easing.js";
+@source "../loaders/fade.js";
+@source "../loaders/frame.js";
+@source "../loaders/motion.js";
+@source "../loaders/orbit.js";
+@source "../loaders/pulse.js";
+@source "../loaders/ring.js";
+@source "../loaders/wave.js";
+@source "../sound/sound-map.js";
+@source "../sound/sound.js";
+@source "../spinner/loader-provider.js";
+@source "../spinner/registry.js";
+@source "../spinner/spinner.js";
+@source "../tokens/dist/motion.js";

package/dist/sources/drawer.css

@@ -0,0 +1,6 @@
+/* @nsaa/core: Tailwind sources for drawer (generated). */
+@source "../drawer/drawer.js";
+@source "../lib/cn.js";
+@source "../sound/sound-map.js";
+@source "../sound/sound.js";
+@source "../tokens/dist/motion.js";