@vertz/ui-primitives 0.2.15 → 0.2.17

package/dist/src/slider/slider.d.ts

@@ -0,0 +1,36 @@
+import { Signal } from "@vertz/ui";
+interface ElementAttrs {
+	class?: string;
+	id?: string;
+	style?: string;
+	title?: string;
+	role?: string;
+	tabindex?: number | string;
+	hidden?: boolean | string;
+	autofocus?: boolean;
+	[key: `data-${string}`]: string | undefined;
+	[key: `aria-${string}`]: string | undefined;
+}
+interface SliderOptions extends ElementAttrs {
+	defaultValue?: number;
+	min?: number;
+	max?: number;
+	step?: number;
+	disabled?: boolean;
+	onValueChange?: (value: number) => void;
+}
+interface SliderState {
+	value: Signal<number>;
+	disabled: Signal<boolean>;
+}
+interface SliderElements {
+	root: HTMLDivElement;
+	thumb: HTMLDivElement;
+	track: HTMLDivElement;
+}
+declare const Slider: {
+	Root: (options?: SliderOptions) => SliderElements & {
+		state: SliderState;
+	};
+};
+export { SliderState, SliderOptions, SliderElements, Slider };

package/dist/src/slider/slider.js

@@ -0,0 +1,10 @@
+import {
+  Slider
+} from "../../shared/chunk-8ak7vdk1.js";
+import"../../shared/chunk-jctqs9m4.js";
+import"../../shared/chunk-vvjyx7fe.js";
+import"../../shared/chunk-dpsgb1xw.js";
+import"../../shared/chunk-8y1jf6xr.js";
+export {
+  Slider
+};

package/dist/src/switch/switch.d.ts

@@ -0,0 +1,21 @@
+interface ElementAttrs {
+	class?: string;
+	id?: string;
+	style?: string;
+	title?: string;
+	role?: string;
+	tabindex?: number | string;
+	hidden?: boolean | string;
+	autofocus?: boolean;
+	[key: `data-${string}`]: string | undefined;
+	[key: `aria-${string}`]: string | undefined;
+}
+interface SwitchOptions extends ElementAttrs {
+	defaultChecked?: boolean;
+	disabled?: boolean;
+	onCheckedChange?: (checked: boolean) => void;
+}
+declare const Switch: {
+	Root: (options?: SwitchOptions) => HTMLButtonElement;
+};
+export { SwitchOptions, Switch };

package/dist/src/switch/switch.js

@@ -0,0 +1,9 @@
+import {
+  Switch
+} from "../../shared/chunk-7kpsyjd7.js";
+import"../../shared/chunk-jctqs9m4.js";
+import"../../shared/chunk-dpsgb1xw.js";
+import"../../shared/chunk-8y1jf6xr.js";
+export {
+  Switch
+};

package/dist/src/tabs/tabs.d.ts

@@ -0,0 +1,35 @@
+import { Signal } from "@vertz/ui";
+interface ElementAttrs {
+	class?: string;
+	id?: string;
+	style?: string;
+	title?: string;
+	role?: string;
+	tabindex?: number | string;
+	hidden?: boolean | string;
+	autofocus?: boolean;
+	[key: `data-${string}`]: string | undefined;
+	[key: `aria-${string}`]: string | undefined;
+}
+interface TabsOptions extends ElementAttrs {
+	defaultValue?: string;
+	orientation?: "horizontal" | "vertical";
+	onValueChange?: (value: string) => void;
+}
+interface TabsState {
+	value: Signal<string>;
+}
+interface TabsElements {
+	root: HTMLDivElement;
+	list: HTMLDivElement;
+}
+declare const Tabs: {
+	Root: (options?: TabsOptions) => TabsElements & {
+		state: TabsState;
+		Tab: (value: string, label?: string) => {
+			trigger: HTMLButtonElement;
+			panel: HTMLDivElement;
+		};
+	};
+};
+export { TabsState, TabsOptions, TabsElements, Tabs };

package/dist/src/tabs/tabs.js

@@ -0,0 +1,11 @@
+import {
+  Tabs
+} from "../../shared/chunk-8nk0ya7a.js";
+import"../../shared/chunk-e2v1c9ex.js";
+import"../../shared/chunk-jctqs9m4.js";
+import"../../shared/chunk-vvjyx7fe.js";
+import"../../shared/chunk-dpsgb1xw.js";
+import"../../shared/chunk-8y1jf6xr.js";
+export {
+  Tabs
+};

package/dist/src/toast/toast.d.ts

@@ -0,0 +1,36 @@
+import { Signal } from "@vertz/ui";
+interface ElementAttrs {
+	class?: string;
+	id?: string;
+	style?: string;
+	title?: string;
+	role?: string;
+	tabindex?: number | string;
+	hidden?: boolean | string;
+	autofocus?: boolean;
+	[key: `data-${string}`]: string | undefined;
+	[key: `aria-${string}`]: string | undefined;
+}
+interface ToastOptions extends ElementAttrs {
+	duration?: number;
+	politeness?: "polite" | "assertive";
+}
+interface ToastMessage {
+	id: string;
+	content: string;
+	el: HTMLDivElement;
+}
+interface ToastState {
+	messages: Signal<ToastMessage[]>;
+}
+interface ToastElements {
+	region: HTMLDivElement;
+}
+declare const Toast: {
+	Root: (options?: ToastOptions) => ToastElements & {
+		state: ToastState;
+		announce: (content: string) => ToastMessage;
+		dismiss: (id: string) => void;
+	};
+};
+export { ToastState, ToastOptions, ToastMessage, ToastElements, Toast };

package/dist/src/toast/toast.js

@@ -0,0 +1,9 @@
+import {
+  Toast
+} from "../../shared/chunk-gkddsbmh.js";
+import"../../shared/chunk-vvjyx7fe.js";
+import"../../shared/chunk-dpsgb1xw.js";
+import"../../shared/chunk-8y1jf6xr.js";
+export {
+  Toast
+};

package/dist/src/toggle/toggle.d.ts

@@ -0,0 +1,21 @@
+interface ElementAttrs {
+	class?: string;
+	id?: string;
+	style?: string;
+	title?: string;
+	role?: string;
+	tabindex?: number | string;
+	hidden?: boolean | string;
+	autofocus?: boolean;
+	[key: `data-${string}`]: string | undefined;
+	[key: `aria-${string}`]: string | undefined;
+}
+interface ToggleOptions extends ElementAttrs {
+	defaultPressed?: boolean;
+	disabled?: boolean;
+	onPressedChange?: (pressed: boolean) => void;
+}
+declare const Toggle: {
+	Root: (options?: ToggleOptions) => HTMLButtonElement;
+};
+export { ToggleOptions, Toggle };

package/dist/src/toggle/toggle.js

@@ -0,0 +1,9 @@
+import {
+  Toggle
+} from "../../shared/chunk-n9nwx58j.js";
+import"../../shared/chunk-jctqs9m4.js";
+import"../../shared/chunk-dpsgb1xw.js";
+import"../../shared/chunk-8y1jf6xr.js";
+export {
+  Toggle
+};

package/dist/src/toggle-group/toggle-group.d.ts

@@ -0,0 +1,34 @@
+import { Signal } from "@vertz/ui";
+interface ElementAttrs {
+	class?: string;
+	id?: string;
+	style?: string;
+	title?: string;
+	role?: string;
+	tabindex?: number | string;
+	hidden?: boolean | string;
+	autofocus?: boolean;
+	[key: `data-${string}`]: string | undefined;
+	[key: `aria-${string}`]: string | undefined;
+}
+interface ToggleGroupOptions extends ElementAttrs {
+	type?: "single" | "multiple";
+	defaultValue?: string[];
+	orientation?: "horizontal" | "vertical";
+	disabled?: boolean;
+	onValueChange?: (value: string[]) => void;
+}
+interface ToggleGroupState {
+	value: Signal<string[]>;
+	disabled: Signal<boolean>;
+}
+interface ToggleGroupElements {
+	root: HTMLDivElement;
+}
+declare const ToggleGroup: {
+	Root: (options?: ToggleGroupOptions) => ToggleGroupElements & {
+		state: ToggleGroupState;
+		Item: (value: string) => HTMLButtonElement;
+	};
+};
+export { ToggleGroupState, ToggleGroupOptions, ToggleGroupElements, ToggleGroup };

package/dist/src/toggle-group/toggle-group.js

@@ -0,0 +1,10 @@
+import {
+  ToggleGroup
+} from "../../shared/chunk-gt0wth9h.js";
+import"../../shared/chunk-e2v1c9ex.js";
+import"../../shared/chunk-jctqs9m4.js";
+import"../../shared/chunk-vvjyx7fe.js";
+import"../../shared/chunk-dpsgb1xw.js";
+export {
+  ToggleGroup
+};

package/dist/src/tooltip/tooltip.d.ts

@@ -0,0 +1,44 @@
+import { Signal } from "@vertz/ui";
+interface ElementAttrs {
+	class?: string;
+	id?: string;
+	style?: string;
+	title?: string;
+	role?: string;
+	tabindex?: number | string;
+	hidden?: boolean | string;
+	autofocus?: boolean;
+	[key: `data-${string}`]: string | undefined;
+	[key: `aria-${string}`]: string | undefined;
+}
+import { Middleware, Placement, Strategy } from "@floating-ui/dom";
+interface FloatingOptions {
+	placement?: Placement;
+	strategy?: Strategy;
+	offset?: number;
+	flip?: boolean;
+	shift?: boolean;
+	middleware?: Middleware[];
+	matchReferenceWidth?: boolean;
+	portal?: boolean;
+	/** Override the reference element used for positioning (e.g., a custom trigger wrapping the primitive trigger). */
+	referenceElement?: HTMLElement;
+}
+interface TooltipOptions extends ElementAttrs {
+	delay?: number;
+	onOpenChange?: (open: boolean) => void;
+	positioning?: FloatingOptions;
+}
+interface TooltipState {
+	open: Signal<boolean>;
+}
+interface TooltipElements {
+	trigger: HTMLElement;
+	content: HTMLDivElement;
+}
+declare const Tooltip: {
+	Root: (options?: TooltipOptions) => TooltipElements & {
+		state: TooltipState;
+	};
+};
+export { TooltipState, TooltipOptions, TooltipElements, Tooltip };

package/dist/src/tooltip/tooltip.js

@@ -0,0 +1,11 @@
+import {
+  Tooltip
+} from "../../shared/chunk-9hj9p7s2.js";
+import"../../shared/chunk-0mcr52hc.js";
+import"../../shared/chunk-jctqs9m4.js";
+import"../../shared/chunk-vvjyx7fe.js";
+import"../../shared/chunk-dpsgb1xw.js";
+import"../../shared/chunk-8y1jf6xr.js";
+export {
+  Tooltip
+};

package/dist/src/utils.d.ts

@@ -0,0 +1,176 @@
+import { onAnimationsComplete } from "@vertz/ui/internals";
+/**
+* Set aria-expanded on an element.
+*/
+declare function setExpanded(el: HTMLElement, expanded: boolean): void;
+/**
+* Toggle aria-expanded on an element. Returns the new value.
+*/
+declare function toggleExpanded(el: HTMLElement): boolean;
+/**
+* Set aria-selected on an element.
+*/
+declare function setSelected(el: HTMLElement, selected: boolean): void;
+/**
+* Set aria-hidden on an element and toggle visual display.
+*
+* aria-hidden alone only affects assistive technology — it does not visually
+* hide the element. We pair it with style.display so that primitives like
+* Dialog, Tabs, and Tooltip actually disappear when hidden.
+*/
+declare function setHidden(el: HTMLElement, hidden: boolean): void;
+/**
+* Hide an element after its CSS exit animations complete.
+* Sets aria-hidden immediately for screen readers, but defers
+* style.display = 'none' until animations finish.
+*
+* For showing (hidden=false), the display is set immediately
+* so enter animations can play.
+*/
+declare function setHiddenAnimated(el: HTMLElement, hidden: boolean): void;
+/**
+* Set aria-checked on an element. Supports boolean and 'mixed' for indeterminate.
+*/
+declare function setChecked(el: HTMLElement, checked: boolean | "mixed"): void;
+/**
+* Set aria-disabled on an element.
+*/
+declare function setDisabled(el: HTMLElement, disabled: boolean): void;
+/**
+* Set data-state attribute for CSS styling hooks.
+*/
+declare function setDataState(el: HTMLElement, state: string): void;
+/**
+* Link two elements with aria-controls.
+*/
+declare function setControls(trigger: HTMLElement, contentId: string): void;
+/**
+* Link an element to its label via aria-labelledby.
+*/
+declare function setLabelledBy(el: HTMLElement, labelId: string): void;
+/**
+* Link an element to its description via aria-describedby.
+*/
+declare function setDescribedBy(el: HTMLElement, descriptionId: string): void;
+/**
+* Set aria-valuenow, aria-valuemin, and aria-valuemax for range widgets.
+*/
+declare function setValueRange(el: HTMLElement, now: number, min: number, max: number): void;
+/**
+* Shared dismiss utility for floating elements.
+* Handles click-outside and Escape key dismissal.
+*/
+interface DismissOptions {
+	onDismiss: () => void;
+	insideElements: HTMLElement[];
+	escapeKey?: boolean;
+	clickOutside?: boolean;
+}
+/**
+* Set up dismissal listeners (click-outside + Escape key).
+* Returns a cleanup function that removes all listeners.
+*/
+declare function createDismiss(options: DismissOptions): () => void;
+import { Middleware, Placement, Strategy, VirtualElement } from "@floating-ui/dom";
+interface FloatingOptions {
+	placement?: Placement;
+	strategy?: Strategy;
+	offset?: number;
+	flip?: boolean;
+	shift?: boolean;
+	middleware?: Middleware[];
+	matchReferenceWidth?: boolean;
+	portal?: boolean;
+	/** Override the reference element used for positioning (e.g., a custom trigger wrapping the primitive trigger). */
+	referenceElement?: HTMLElement;
+}
+interface FloatingResult {
+	cleanup: () => void;
+	update: () => Promise<void>;
+}
+/**
+* Position a floating element relative to a reference element.
+* Uses @floating-ui/dom under the hood for robust viewport-aware positioning.
+*/
+declare function createFloatingPosition(reference: HTMLElement | VirtualElement, floating: HTMLElement, options?: FloatingOptions): FloatingResult;
+/**
+* Create a virtual element for positioning at mouse coordinates (e.g., context menu).
+*/
+declare function virtualElement(x: number, y: number): VirtualElement;
+/**
+* Get all focusable elements within a container.
+*/
+declare function getFocusableElements(container: HTMLElement): HTMLElement[];
+/**
+* Create a focus trap within a container element.
+* When Tab is pressed at the last element, focus wraps to the first.
+* When Shift+Tab is pressed at the first element, focus wraps to the last.
+*
+* Returns a cleanup function to remove the trap.
+*/
+declare function trapFocus(container: HTMLElement): () => void;
+/**
+* Focus the first focusable element within a container.
+*/
+declare function focusFirst(container: HTMLElement): void;
+/**
+* Save the currently focused element and return a function to restore focus.
+*/
+declare function saveFocus(): () => void;
+/**
+* Apply roving tabindex to a set of elements.
+* Only the active item has tabindex="0"; all others have tabindex="-1".
+*/
+declare function setRovingTabindex(items: HTMLElement[], activeIndex: number): void;
+/**
+* Generate a unique ID string with an optional prefix.
+* IDs are deterministic within a session (incrementing counter).
+*/
+declare function uniqueId(prefix?: string): string;
+/**
+* Generate a pair of linked IDs for trigger/content relationships.
+* Returns { triggerId, contentId } for use with aria-controls / aria-labelledby.
+*/
+declare function linkedIds(prefix?: string): {
+	triggerId: string;
+	contentId: string;
+};
+/**
+* Reset the ID counter (useful for tests).
+*/
+declare function resetIdCounter(): void;
+/**
+* Keyboard event helpers for WAI-ARIA patterns.
+* Provides key constants and navigation handlers for common patterns.
+*/
+declare const Keys: {
+	readonly Enter: "Enter";
+	readonly Space: " ";
+	readonly Escape: "Escape";
+	readonly ArrowUp: "ArrowUp";
+	readonly ArrowDown: "ArrowDown";
+	readonly ArrowLeft: "ArrowLeft";
+	readonly ArrowRight: "ArrowRight";
+	readonly Home: "Home";
+	readonly End: "End";
+	readonly Tab: "Tab";
+};
+/**
+* Check if a keyboard event matches one of the given keys.
+*/
+declare function isKey(event: KeyboardEvent, ...keys: string[]): boolean;
+/**
+* Handle arrow key navigation within a list of elements.
+* Supports ArrowUp/Down for vertical lists, ArrowLeft/Right for horizontal.
+* Also supports Home/End for jumping to first/last.
+*/
+declare function handleListNavigation(event: KeyboardEvent, items: HTMLElement[], options?: {
+	orientation?: "vertical" | "horizontal";
+	loop?: boolean;
+}): HTMLElement | null;
+/**
+* Handle activation keys (Enter and Space).
+* Calls the handler and prevents default behavior.
+*/
+declare function handleActivation(event: KeyboardEvent, handler: () => void): void;
+export { virtualElement, uniqueId, trapFocus, toggleExpanded, setValueRange, setSelected, setRovingTabindex, setLabelledBy, setHiddenAnimated, setHidden, setExpanded, setDisabled, setDescribedBy, setDataState, setControls, setChecked, saveFocus, resetIdCounter, onAnimationsComplete, linkedIds, isKey, handleListNavigation, handleActivation, getFocusableElements, focusFirst, createFloatingPosition, createDismiss, Keys, FloatingResult, FloatingOptions, DismissOptions };

package/dist/src/utils.js

@@ -0,0 +1,72 @@
+import {
+  createDismiss
+} from "../shared/chunk-a6wp8c32.js";
+import {
+  focusFirst,
+  getFocusableElements,
+  saveFocus,
+  setRovingTabindex,
+  trapFocus
+} from "../shared/chunk-e2v1c9ex.js";
+import {
+  createFloatingPosition,
+  virtualElement
+} from "../shared/chunk-0mcr52hc.js";
+import {
+  Keys,
+  handleActivation,
+  handleListNavigation,
+  isKey
+} from "../shared/chunk-jctqs9m4.js";
+import {
+  setChecked,
+  setControls,
+  setDataState,
+  setDescribedBy,
+  setDisabled,
+  setExpanded,
+  setHidden,
+  setHiddenAnimated,
+  setLabelledBy,
+  setSelected,
+  setValueRange,
+  toggleExpanded
+} from "../shared/chunk-vvjyx7fe.js";
+import {
+  linkedIds,
+  resetIdCounter,
+  uniqueId
+} from "../shared/chunk-8y1jf6xr.js";
+
+// src/utils.ts
+import { onAnimationsComplete } from "@vertz/ui/internals";
+export {
+  virtualElement,
+  uniqueId,
+  trapFocus,
+  toggleExpanded,
+  setValueRange,
+  setSelected,
+  setRovingTabindex,
+  setLabelledBy,
+  setHiddenAnimated,
+  setHidden,
+  setExpanded,
+  setDisabled,
+  setDescribedBy,
+  setDataState,
+  setControls,
+  setChecked,
+  saveFocus,
+  resetIdCounter,
+  onAnimationsComplete,
+  linkedIds,
+  isKey,
+  handleListNavigation,
+  handleActivation,
+  getFocusableElements,
+  focusFirst,
+  createFloatingPosition,
+  createDismiss,
+  Keys
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertz/ui-primitives",
-  "version": "0.2.15",
+  "version": "0.2.17",
   "type": "module",
   "license": "MIT",
   "description": "Headless UI primitives for Vertz — Accordion, Dialog, Select, and more",
@@ -13,16 +13,16 @@
     "access": "public",
     "provenance": true
   },
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "import": "./dist/src/index.js",
+      "types": "./dist/src/index.d.ts"
     },
     "./utils": {
-      "import": "./dist/utils.js",
-      "types": "./dist/utils.d.ts"
+      "import": "./dist/src/utils.js",
+      "types": "./dist/src/utils.d.ts"
     }
   },
   "files": [
@@ -36,11 +36,11 @@
   },
   "dependencies": {
     "@floating-ui/dom": "^1.7.5",
-    "@vertz/ui": "^0.2.14"
+    "@vertz/ui": "^0.2.16"
   },
   "devDependencies": {
     "@happy-dom/global-registrator": "^20.7.0",
-    "@vertz/ui-compiler": "^0.2.14",
+    "@vertz/ui-compiler": "^0.2.16",
     "bunup": "^0.16.31",
     "happy-dom": "^20.7.0",
     "typescript": "^5.7.0"
@@ -48,5 +48,7 @@
   "engines": {
     "node": ">=22"
   },
-  "sideEffects": false
+  "sideEffects": [
+    "./dist/shared/*.js"
+  ]
 }