@codefast/ui 0.3.14 → 0.3.16-canary.0

package/dist/components/table.d.mts

@@ -1,42 +1,90 @@
 import { ComponentProps, JSX } from "react";
 
 //#region src/components/table.d.ts
+/**
+ * @since 0.3.16-canary.0
+ */
 type TableProps = ComponentProps<"table">;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function Table({
   className,
   ...props
 }: TableProps): JSX.Element;
+/**
+ * @since 0.3.16-canary.0
+ */
 type TableHeaderProps = ComponentProps<"thead">;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function TableHeader({
   className,
   ...props
 }: TableHeaderProps): JSX.Element;
+/**
+ * @since 0.3.16-canary.0
+ */
 type TableBodyProps = ComponentProps<"tbody">;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function TableBody({
   className,
   ...props
 }: TableBodyProps): JSX.Element;
+/**
+ * @since 0.3.16-canary.0
+ */
 type TableFooterProps = ComponentProps<"tfoot">;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function TableFooter({
   className,
   ...props
 }: TableFooterProps): JSX.Element;
+/**
+ * @since 0.3.16-canary.0
+ */
 type TableRowProps = ComponentProps<"tr">;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function TableRow({
   className,
   ...props
 }: TableRowProps): JSX.Element;
+/**
+ * @since 0.3.16-canary.0
+ */
 type TableHeadProps = ComponentProps<"th">;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function TableHead({
   className,
   ...props
 }: TableHeadProps): JSX.Element;
+/**
+ * @since 0.3.16-canary.0
+ */
 type TableCellProps = ComponentProps<"td">;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function TableCell({
   className,
   ...props
 }: TableCellProps): JSX.Element;
+/**
+ * @since 0.3.16-canary.0
+ */
 type TableCaptionProps = ComponentProps<"caption">;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function TableCaption({
   className,
   ...props

package/dist/components/table.mjs

@@ -1,6 +1,9 @@
 import { cn } from "../lib/utils.mjs";
 import { jsx } from "react/jsx-runtime";
 //#region src/components/table.tsx
+/**
+* @since 0.3.16-canary.0
+*/
 function Table({ className, ...props }) {
 	return /* @__PURE__ */ jsx("div", {
 		className: cn("relative", "w-full overflow-auto"),
@@ -12,6 +15,9 @@ function Table({ className, ...props }) {
 		})
 	});
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function TableHeader({ className, ...props }) {
 	return /* @__PURE__ */ jsx("thead", {
 		className: cn("*:border-b", "*:has-aria-expanded:bg-transparent", className),
@@ -19,6 +25,9 @@ function TableHeader({ className, ...props }) {
 		...props
 	});
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function TableBody({ className, ...props }) {
 	return /* @__PURE__ */ jsx("tbody", {
 		className: cn("*:last-child:border-0", className),
@@ -26,6 +35,9 @@ function TableBody({ className, ...props }) {
 		...props
 	});
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function TableFooter({ className, ...props }) {
 	return /* @__PURE__ */ jsx("tfoot", {
 		className: cn("bg-muted/50 font-medium", "*:border-t *:border-b-0", "*:has-aria-expanded:bg-transparent", className),
@@ -33,6 +45,9 @@ function TableFooter({ className, ...props }) {
 		...props
 	});
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function TableRow({ className, ...props }) {
 	return /* @__PURE__ */ jsx("tr", {
 		className: cn("border-b", "transition-colors", "hover:bg-muted/50", "has-aria-expanded:bg-muted/50", "data-selected:bg-muted", className),
@@ -40,6 +55,9 @@ function TableRow({ className, ...props }) {
 		...props
 	});
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function TableHead({ className, ...props }) {
 	return /* @__PURE__ */ jsx("th", {
 		className: cn("p-2", "text-left align-middle font-medium", className),
@@ -47,6 +65,9 @@ function TableHead({ className, ...props }) {
 		...props
 	});
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function TableCell({ className, ...props }) {
 	return /* @__PURE__ */ jsx("td", {
 		className: cn("p-2", "align-middle", className),
@@ -54,6 +75,9 @@ function TableCell({ className, ...props }) {
 		...props
 	});
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function TableCaption({ className, ...props }) {
 	return /* @__PURE__ */ jsx("caption", {
 		className: cn("mt-4", "text-sm text-muted-foreground", className),

package/dist/components/tabs.d.mts

@@ -2,22 +2,46 @@ import { ComponentProps, JSX } from "react";
 import * as TabsPrimitive from "@radix-ui/react-tabs";
 
 //#region src/components/tabs.d.ts
+/**
+ * @since 0.3.16-canary.0
+ */
 type TabsProps = ComponentProps<typeof TabsPrimitive.Root>;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function Tabs({
   className,
   ...props
 }: TabsProps): JSX.Element;
+/**
+ * @since 0.3.16-canary.0
+ */
 type TabsListProps = ComponentProps<typeof TabsPrimitive.List>;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function TabsList({
   className,
   ...props
 }: TabsListProps): JSX.Element;
+/**
+ * @since 0.3.16-canary.0
+ */
 type TabsTriggerProps = ComponentProps<typeof TabsPrimitive.Trigger>;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function TabsTrigger({
   className,
   ...props
 }: TabsTriggerProps): JSX.Element;
+/**
+ * @since 0.3.16-canary.0
+ */
 type TabsContentProps = ComponentProps<typeof TabsPrimitive.Content>;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function TabsContent({
   className,
   ...props

package/dist/components/tabs.mjs

@@ -3,6 +3,9 @@ import { cn } from "../lib/utils.mjs";
 import { jsx } from "react/jsx-runtime";
 import * as TabsPrimitive from "@radix-ui/react-tabs";
 //#region src/components/tabs.tsx
+/**
+* @since 0.3.16-canary.0
+*/
 function Tabs({ className, ...props }) {
 	return /* @__PURE__ */ jsx(TabsPrimitive.Root, {
 		className: cn("flex flex-col gap-2", className),
@@ -10,6 +13,9 @@ function Tabs({ className, ...props }) {
 		...props
 	});
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function TabsList({ className, ...props }) {
 	return /* @__PURE__ */ jsx(TabsPrimitive.List, {
 		className: cn("inline-flex w-fit items-center justify-center gap-1 px-1 py-1", "rounded-xl", "bg-muted text-muted-foreground", className),
@@ -17,6 +23,9 @@ function TabsList({ className, ...props }) {
 		...props
 	});
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function TabsTrigger({ className, ...props }) {
 	return /* @__PURE__ */ jsx(TabsPrimitive.Trigger, {
 		className: cn("inline-flex items-center justify-center gap-1.5", "px-2 py-1.5", "rounded-lg", "text-sm font-medium whitespace-nowrap text-muted-foreground", "transition", "not-dark:outline-hidden", "hover:not-disabled:text-foreground", "focus-visible:ring-3 focus-visible:ring-ring/50", "disabled:opacity-50", "dark:focus-visible:-outline-offset-1 dark:focus-visible:outline-ring", "data-active:bg-background data-active:text-foreground data-active:shadow-sm", "dark:data-active:bg-input/50", "dark:focus-visible:data-active:outline-1", "[&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4", className),
@@ -24,6 +33,9 @@ function TabsTrigger({ className, ...props }) {
 		...props
 	});
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function TabsContent({ className, ...props }) {
 	return /* @__PURE__ */ jsx(TabsPrimitive.Content, {
 		className: cn("mt-2", "rounded-xl ring-ring/50 outline-ring", "focus-visible:ring-4 focus-visible:outline-1", className),

package/dist/components/textarea.d.mts

@@ -1,7 +1,13 @@
 import { ComponentProps, JSX } from "react";
 
 //#region src/components/textarea.d.ts
+/**
+ * @since 0.3.16-canary.0
+ */
 type TextareaProps = ComponentProps<"textarea">;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function Textarea({
   className,
   ...props

package/dist/components/textarea.mjs

@@ -1,6 +1,9 @@
 import { cn } from "../lib/utils.mjs";
 import { jsx } from "react/jsx-runtime";
 //#region src/components/textarea.tsx
+/**
+* @since 0.3.16-canary.0
+*/
 function Textarea({ className, ...props }) {
 	return /* @__PURE__ */ jsx("textarea", {
 		className: cn("flex min-h-16 w-full grow px-3 py-2", "rounded-lg border border-input shadow-xs outline-hidden", "text-base", "transition", "placeholder:text-muted-foreground", "hover:not-disabled:not-focus-visible:border-ring/60", "focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50", "disabled:opacity-50", "aria-invalid:border-destructive", "focus-within:aria-invalid:ring-destructive/20", "hover:not-disabled:not-focus-within:aria-invalid:border-destructive/60", "md:text-sm", "dark:bg-input/30", "dark:focus-within:aria-invalid:ring-destructive/40", className),

package/dist/components/toggle-group.d.mts

@@ -7,9 +7,15 @@ import * as ToggleGroupPrimitive from "@radix-ui/react-toggle-group";
 type ScopedProps<P> = P & {
   __scopeToggleGroup?: Scope;
 };
+/**
+ * @since 0.3.16-canary.0
+ */
 type ToggleGroupProps = ComponentProps<typeof ToggleGroupPrimitive.Root> & ToggleVariants & {
   spacing?: number;
 };
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function ToggleGroup({
   __scopeToggleGroup,
   children,
@@ -19,7 +25,13 @@ declare function ToggleGroup({
   variant,
   ...props
 }: ScopedProps<ToggleGroupProps>): JSX.Element;
+/**
+ * @since 0.3.16-canary.0
+ */
 type ToggleGroupItemProps = ScopedProps<ComponentProps<typeof ToggleGroupPrimitive.Item>>;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function ToggleGroupItem({
   __scopeToggleGroup,
   children,

package/dist/components/toggle-group.mjs

@@ -10,6 +10,9 @@ const TOGGLE_GROUP_NAME = "ToggleGroup";
 const [createToggleGroupContext] = createContextScope(TOGGLE_GROUP_NAME, [createToggleGroupScope]);
 const useToggleGroupScope = createToggleGroupScope();
 const [ToggleGroupProvider, useToggleGroupContext] = createToggleGroupContext(TOGGLE_GROUP_NAME);
+/**
+* @since 0.3.16-canary.0
+*/
 function ToggleGroup({ __scopeToggleGroup, children, className, size, spacing = 0, variant, ...props }) {
 	const toggleGroupScope = useToggleGroupScope(__scopeToggleGroup);
 	return /* @__PURE__ */ jsx(ToggleGroupProvider, {
@@ -31,6 +34,9 @@ function ToggleGroup({ __scopeToggleGroup, children, className, size, spacing =
 	});
 }
 const TOGGLE_GROUP_ITEM_NAME = "ToggleGroupItem";
+/**
+* @since 0.3.16-canary.0
+*/
 function ToggleGroupItem({ __scopeToggleGroup, children, className, ...props }) {
 	const { size, spacing, variant } = useToggleGroupContext(TOGGLE_GROUP_ITEM_NAME, __scopeToggleGroup);
 	const toggleGroupScope = useToggleGroupScope(__scopeToggleGroup);

package/dist/components/toggle.d.mts

@@ -4,6 +4,9 @@ import { ComponentProps, JSX } from "react";
 import * as TogglePrimitive from "@radix-ui/react-toggle";
 
 //#region src/components/toggle.d.ts
+/**
+ * @since 0.3.16-canary.0
+ */
 declare const toggleVariants: _$_codefast_tailwind_variants0.VariantFunctionType<{
   size: {
     default: string[];
@@ -15,8 +18,17 @@ declare const toggleVariants: _$_codefast_tailwind_variants0.VariantFunctionType
     outline: string[];
   };
 }, Record<string, never>>;
+/**
+ * @since 0.3.16-canary.0
+ */
 type ToggleVariants = VariantProps<typeof toggleVariants>;
+/**
+ * @since 0.3.16-canary.0
+ */
 interface ToggleProps extends ComponentProps<typeof TogglePrimitive.Root>, ToggleVariants {}
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function Toggle({
   children,
   className,

package/dist/components/toggle.mjs

@@ -3,6 +3,9 @@ import { tv } from "../lib/utils.mjs";
 import { jsx } from "react/jsx-runtime";
 import * as TogglePrimitive from "@radix-ui/react-toggle";
 //#region src/components/toggle.tsx
+/**
+* @since 0.3.16-canary.0
+*/
 const toggleVariants = tv({
 	base: [
 		"inline-flex items-center justify-center gap-2",
@@ -37,6 +40,9 @@ const toggleVariants = tv({
 		variant: "default"
 	}
 });
+/**
+* @since 0.3.16-canary.0
+*/
 function Toggle({ children, className, size, variant, ...props }) {
 	return /* @__PURE__ */ jsx(TogglePrimitive.Root, {
 		className: toggleVariants({

package/dist/components/tooltip.d.mts

@@ -2,26 +2,56 @@ import { ComponentProps, JSX } from "react";
 import * as TooltipPrimitive from "@radix-ui/react-tooltip";
 
 //#region src/components/tooltip.d.ts
+/**
+ * @since 0.3.16-canary.0
+ */
 type TooltipProviderProps = ComponentProps<typeof TooltipPrimitive.Provider>;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function TooltipProvider({
   ...props
 }: TooltipProviderProps): JSX.Element;
+/**
+ * @since 0.3.16-canary.0
+ */
 type TooltipProps = ComponentProps<typeof TooltipPrimitive.Root>;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function Tooltip({
   ...props
 }: TooltipProps): JSX.Element;
+/**
+ * @since 0.3.16-canary.0
+ */
 type TooltipTriggerProps = ComponentProps<typeof TooltipPrimitive.Trigger>;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function TooltipTrigger({
   ...props
 }: TooltipTriggerProps): JSX.Element;
+/**
+ * @since 0.3.16-canary.0
+ */
 type TooltipContentProps = ComponentProps<typeof TooltipPrimitive.Content>;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function TooltipContent({
   children,
   className,
   sideOffset,
   ...props
 }: TooltipContentProps): JSX.Element;
+/**
+ * @since 0.3.16-canary.0
+ */
 type TooltipArrowProps = ComponentProps<typeof TooltipPrimitive.Arrow>;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function TooltipArrow({
   className,
   ...props

package/dist/components/tooltip.mjs

@@ -3,24 +3,36 @@ import { cn } from "../lib/utils.mjs";
 import { jsx, jsxs } from "react/jsx-runtime";
 import * as TooltipPrimitive from "@radix-ui/react-tooltip";
 //#region src/components/tooltip.tsx
+/**
+* @since 0.3.16-canary.0
+*/
 function TooltipProvider({ ...props }) {
 	return /* @__PURE__ */ jsx(TooltipPrimitive.Provider, {
 		"data-slot": "tooltip-provider",
 		...props
 	});
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function Tooltip({ ...props }) {
 	return /* @__PURE__ */ jsx(TooltipPrimitive.Root, {
 		"data-slot": "tooltip",
 		...props
 	});
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function TooltipTrigger({ ...props }) {
 	return /* @__PURE__ */ jsx(TooltipPrimitive.Trigger, {
 		"data-slot": "tooltip-trigger",
 		...props
 	});
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function TooltipContent({ children, className, sideOffset = 4, ...props }) {
 	return /* @__PURE__ */ jsx(TooltipPrimitive.Portal, { children: /* @__PURE__ */ jsxs(TooltipPrimitive.Content, {
 		className: cn("z-50", "w-fit max-w-(--radix-tooltip-content-available-width) px-3 py-1.5", "rounded-md", "bg-primary text-xs text-balance text-primary-foreground", "ease-ui data-[state=delayed-open]:animate-in data-[state=delayed-open]:fade-in-0 data-[state=delayed-open]:zoom-in-95", "data-[state=delayed-open]:data-side-top:slide-in-from-bottom-2", "data-[state=delayed-open]:data-side-right:slide-in-from-left-2", "data-[state=delayed-open]:data-side-bottom:slide-in-from-top-2", "data-[state=delayed-open]:data-side-left:slide-in-from-right-2", "data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95", "data-closed:data-side-top:slide-out-to-bottom-2", "data-closed:data-side-right:slide-out-to-left-2", "data-closed:data-side-bottom:slide-out-to-top-2", "data-closed:data-side-left:slide-out-to-right-2", "origin-(--radix-tooltip-content-transform-origin)", className),
@@ -31,6 +43,9 @@ function TooltipContent({ children, className, sideOffset = 4, ...props }) {
 		children: [children, /* @__PURE__ */ jsx(TooltipArrow, {})]
 	}) });
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function TooltipArrow({ className, ...props }) {
 	return /* @__PURE__ */ jsx(TooltipPrimitive.Arrow, {
 		className: cn("fill-primary", className),

package/dist/hooks/use-animated-value.d.mts

@@ -15,6 +15,8 @@
  * const value = useAnimatedValue(75, 1000, true);
  * return <div>{value}%</div>;
  * ```
+ *
+ * @since 0.3.16-canary.0
  */
 declare function useAnimatedValue(targetValue: null | number, duration: number, animate?: boolean): number;
 //#endregion

package/dist/hooks/use-animated-value.mjs

@@ -3,20 +3,22 @@ import { useEffect, useRef, useState } from "react";
 //#region src/hooks/use-animated-value.ts
 /**
 * Produce a smoothly animated numeric value in response to changes.
-*
+* 
 * Applies a time-based easing (easeOutQuad) between the current and target values
 * over the specified duration. When disabled, the value updates immediately.
-*
+* 
 * @param targetValue - Target number to animate toward; null resolves to 0.
 * @param duration - Animation duration in milliseconds.
 * @param animate - When false, bypasses animation and sets the value directly.
 * @returns The current (rounded) animated value.
-*
+* 
 * @example
 * ```tsx
 * const value = useAnimatedValue(75, 1000, true);
 * return <div>{value}%</div>;
 * ```
+*
+* @since 0.3.16-canary.0
 */
 function useAnimatedValue(targetValue, duration, animate) {
 	const actualTargetValue = targetValue ?? 0;

package/dist/hooks/use-copy-to-clipboard.d.mts

@@ -15,6 +15,8 @@
  * const { copyToClipboard, isCopied } = useCopyToClipboard({ timeout: 1500 });
  * <button onClick={() => copyToClipboard("Hello")}>{isCopied ? "Copied" : "Copy"}</button>
  * ```
+ *
+ * @since 0.3.16-canary.0
  */
 declare function useCopyToClipboard({
   onCopy,

package/dist/hooks/use-copy-to-clipboard.mjs

@@ -3,20 +3,22 @@ import { useState } from "react";
 //#region src/hooks/use-copy-to-clipboard.ts
 /**
 * Provide clipboard copy capability with a transient copied state.
-*
+* 
 * Internally uses the Clipboard API when available and sets a temporary
 * `isCopied` flag for UI feedback. A custom callback may be invoked upon copy.
-*
+* 
 * @param options - Configuration options.
 *   - onCopy: Callback invoked after a successful copy.
 *   - timeout: Duration in milliseconds to keep `isCopied` true. Defaults to 2000.
 * @returns An object with a `copyToClipboard` function and an `isCopied` flag.
-*
+* 
 * @example
 * ```tsx
 * const { copyToClipboard, isCopied } = useCopyToClipboard({ timeout: 1500 });
 * <button onClick={() => copyToClipboard("Hello")}>{isCopied ? "Copied" : "Copy"}</button>
 * ```
+*
+* @since 0.3.16-canary.0
 */
 function useCopyToClipboard({ onCopy, timeout = 2e3 } = {}) {
 	const [isCopied, setIsCopied] = useState(false);

package/dist/hooks/use-is-mobile.d.mts

@@ -16,6 +16,8 @@
  *   // Render compact layout
  * }
  * ```
+ *
+ * @since 0.3.16-canary.0
  */
 declare function useIsMobile(mobileBreakpoint?: number): boolean;
 //#endregion

package/dist/hooks/use-is-mobile.mjs

@@ -3,14 +3,14 @@ import { useMediaQuery } from "./use-media-query.mjs";
 //#region src/hooks/use-is-mobile.ts
 /**
 * Determine whether the current viewport should be treated as mobile.
-*
+* 
 * Uses {@link useMediaQuery} to evaluate a max-width media query derived from the
 * provided breakpoint. By default, widths below 768px are considered mobile.
-*
+* 
 * @param mobileBreakpoint - Pixel width used as the mobile breakpoint. Values strictly
 * less than this breakpoint are treated as mobile. Defaults to 768.
 * @returns true when the viewport width is less than the given breakpoint; otherwise false.
-*
+* 
 * @example
 * ```tsx
 * const isMobile = useIsMobile();
@@ -18,6 +18,8 @@ import { useMediaQuery } from "./use-media-query.mjs";
 *   // Render compact layout
 * }
 * ```
+*
+* @since 0.3.16-canary.0
 */
 function useIsMobile(mobileBreakpoint = 768) {
 	return useMediaQuery(`(max-width: ${(mobileBreakpoint - 1).toString()}px)`);

package/dist/hooks/use-media-query.d.mts

@@ -12,6 +12,8 @@
  * ```tsx
  * const isNarrow = useMediaQuery("(max-width: 768px)");
  * ```
+ *
+ * @since 0.3.16-canary.0
  */
 declare function useMediaQuery(query: string): boolean;
 //#endregion

package/dist/hooks/use-media-query.mjs

@@ -3,17 +3,19 @@ import { useEffect, useState } from "react";
 //#region src/hooks/use-media-query.ts
 /**
 * Subscribe to a CSS media query and receive its match state.
-*
+* 
 * Evaluates the query immediately (when supported) and updates on changes
 * via an event listener.
-*
+* 
 * @param query - A valid media query string (e.g., "(max-width: 768px)").
 * @returns true when the media query currently matches; otherwise false.
-*
+* 
 * @example
 * ```tsx
 * const isNarrow = useMediaQuery("(max-width: 768px)");
 * ```
+*
+* @since 0.3.16-canary.0
 */
 function useMediaQuery(query) {
 	/**

package/dist/hooks/use-mutation-observer.d.mts

@@ -13,6 +13,8 @@ import { RefObject } from "react";
  * @returns void
  *
  * @see [MutationObserver](https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver)
+ *
+ * @since 0.3.16-canary.0
  */
 declare function useMutationObserver(ref: RefObject<HTMLElement | null>, callback: MutationCallback, options?: MutationObserverInit): void;
 //#endregion

package/dist/hooks/use-mutation-observer.mjs

@@ -12,16 +12,18 @@ const defaultOptions = {
 };
 /**
 * Observe DOM mutations on a referenced element and invoke a callback.
-*
+* 
 * Attaches a MutationObserver to the provided element reference with the given
 * options and calls the callback whenever mutations occur.
-*
+* 
 * @param ref - Ref to the target HTMLElement to observe.
 * @param callback - Mutation callback invoked with observed records.
 * @param options - Observer configuration. Defaults watch attributes, characterData, childList, subtree.
 * @returns void
-*
+* 
 * @see [MutationObserver](https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver)
+*
+* @since 0.3.16-canary.0
 */
 function useMutationObserver(ref, callback, options = defaultOptions) {
 	useEffect(() => {