@codefast/ui 0.3.15 → 0.3.16-canary.0

package/dist/hooks/use-pagination.d.mts

@@ -1,4 +1,7 @@
 //#region src/hooks/use-pagination.d.ts
+/**
+ * @since 0.3.16-canary.0
+ */
 interface UsePaginationProps {
   /**
    * Current active page number.
@@ -20,6 +23,8 @@ interface UsePaginationProps {
 }
 /**
  * Ellipsis marker used to collapse ranges in pagination output.
+ *
+ * @since 0.3.16-canary.0
  */
 declare const ELLIPSIS = "\u2022\u2022\u2022";
 /**
@@ -41,6 +46,8 @@ declare const ELLIPSIS = "\u2022\u2022\u2022";
  *   totalResults: 100
  * });
  * ```
+ *
+ * @since 0.3.16-canary.0
  */
 declare function usePagination({
   currentPage,

package/dist/hooks/use-pagination.mjs

@@ -3,6 +3,8 @@ import { useMemo } from "react";
 //#region src/hooks/use-pagination.ts
 /**
 * Ellipsis marker used to collapse ranges in pagination output.
+*
+* @since 0.3.16-canary.0
 */
 const ELLIPSIS = "•••";
 /**
@@ -18,14 +20,14 @@ const createRange = (start, end) => {
 };
 /**
 * Compute a pagination structure for result sets.
-*
+* 
 * Returns a mixed array of page numbers and the `ELLIPSIS` marker representing
 * collapsed ranges. The shape adapts to the total pages and the requested
 * sibling window around the current page.
-*
+* 
 * @param props - Pagination options. See {@link UsePaginationProps}.
 * @returns Array of page numbers and `ELLIPSIS` representing the pagination model.
-*
+* 
 * @example
 * ```tsx
 * const paginationRange = usePagination({
@@ -35,6 +37,8 @@ const createRange = (start, end) => {
 *   totalResults: 100
 * });
 * ```
+*
+* @since 0.3.16-canary.0
 */
 function usePagination({ currentPage, resultsPerPage, siblingPagesCount = 1, totalResults }) {
 	return useMemo(() => {

package/dist/primitives/checkbox-group.d.mts

@@ -90,10 +90,14 @@ interface CheckboxGroupBaseProps {
 }
 /**
  * Props for the CheckboxGroup component
+ *
+ * @since 0.3.16-canary.0
  */
 type CheckboxGroupProps = CheckboxGroupBaseProps & ComponentProps<"div">;
 /**
  * CheckboxGroup component that manages a group of checkboxes with roving focus
+ *
+ * @since 0.3.16-canary.0
  */
 declare function CheckboxGroup({
   __scopeCheckboxGroup,
@@ -110,6 +114,8 @@ declare function CheckboxGroup({
 }: ScopedProps<CheckboxGroupProps>): JSX.Element;
 /**
  * Props for the CheckboxGroupItem component
+ *
+ * @since 0.3.16-canary.0
  */
 interface CheckboxGroupItemProps extends Omit<ComponentProps<typeof CheckboxPrimitive.Root>, "checked" | "defaultChecked" | "name" | "onCheckedChange"> {
   /**
@@ -123,6 +129,8 @@ interface CheckboxGroupItemProps extends Omit<ComponentProps<typeof CheckboxPrim
 }
 /**
  * Individual checkbox item within a CheckboxGroup
+ *
+ * @since 0.3.16-canary.0
  */
 declare function CheckboxGroupItem({
   __scopeCheckboxGroup,
@@ -131,10 +139,14 @@ declare function CheckboxGroupItem({
 }: ScopedProps<CheckboxGroupItemProps>): JSX.Element;
 /**
  * Props for the CheckboxGroupIndicator component
+ *
+ * @since 0.3.16-canary.0
  */
 type CheckboxGroupIndicatorProps = ComponentProps<typeof CheckboxPrimitive.Indicator>;
 /**
  * Visual indicator component for a CheckboxGroupItem
+ *
+ * @since 0.3.16-canary.0
  */
 declare function CheckboxGroupIndicator({
   __scopeCheckboxGroup,

package/dist/primitives/checkbox-group.mjs

@@ -15,6 +15,8 @@ const useCheckboxScope = createCheckboxScope();
 const [CheckboxGroupContextProvider, useCheckboxGroupContext] = createCheckboxGroupContext(CHECKBOX_GROUP_NAME);
 /**
 * CheckboxGroup component that manages a group of checkboxes with roving focus
+*
+* @since 0.3.16-canary.0
 */
 function CheckboxGroup({ __scopeCheckboxGroup, defaultValue, dir, disabled = false, loop = true, name, onValueChange, orientation, required = false, value: valueProperty, ...props }) {
 	/**
@@ -67,6 +69,8 @@ function CheckboxGroup({ __scopeCheckboxGroup, defaultValue, dir, disabled = fal
 const ITEM_NAME = "CheckboxGroupItem";
 /**
 * Individual checkbox item within a CheckboxGroup
+*
+* @since 0.3.16-canary.0
 */
 function CheckboxGroupItem({ __scopeCheckboxGroup, disabled, ...props }) {
 	/**
@@ -111,6 +115,8 @@ function CheckboxGroupItem({ __scopeCheckboxGroup, disabled, ...props }) {
 }
 /**
 * Visual indicator component for a CheckboxGroupItem
+*
+* @since 0.3.16-canary.0
 */
 function CheckboxGroupIndicator({ __scopeCheckboxGroup, ...props }) {
 	/**

package/dist/primitives/input-number.d.mts

@@ -16,6 +16,8 @@ type ScopedProps<P> = P & {
 declare const createInputNumberScope: _$_radix_ui_react_context0.CreateScope;
 /**
  * Props for the main InputNumber component.
+ *
+ * @since 0.3.16-canary.0
  */
 interface InputNumberProps extends ComponentProps<typeof Input> {
   /**
@@ -63,11 +65,19 @@ interface InputNumberProps extends ComponentProps<typeof Input> {
    */
   value?: number;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function InputNumber(numberInputProps: ScopedProps<InputNumberProps>): JSX.Element;
 /**
  * Defines the props for the `InputNumberField` component.
+ *
+ * @since 0.3.16-canary.0
  */
 type InputNumberFieldProps = Omit<ComponentProps<typeof InputField>, "defaultValue" | "disabled" | "id" | "max" | "min" | "onChange" | "prefix" | "readOnly" | "step" | "value">;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function InputNumberField({
   __scopeInputNumber,
   onBlur,
@@ -90,9 +100,21 @@ declare function NumberStepperButton({
   operation,
   ...props
 }: ScopedProps<NumberStepperButtonProps>): JSX.Element;
+/**
+ * @since 0.3.16-canary.0
+ */
 type InputNumberIncrementButtonProps = Omit<ComponentProps<typeof NumberStepperButton>, "operation">;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function InputNumberIncrementButton(props: InputNumberIncrementButtonProps): JSX.Element;
+/**
+ * @since 0.3.16-canary.0
+ */
 type InputNumberDecrementButtonProps = Omit<ComponentProps<typeof NumberStepperButton>, "operation">;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function InputNumberDecrementButton(props: InputNumberDecrementButtonProps): JSX.Element;
 //#endregion
 export { InputNumberDecrementButton as DecrementButton, InputNumberDecrementButton, InputNumberField as Field, InputNumberField, InputNumberIncrementButton as IncrementButton, InputNumberIncrementButton, InputNumber, InputNumber as Root, type InputNumberDecrementButtonProps, type InputNumberFieldProps, type InputNumberIncrementButtonProps, type InputNumberProps, createInputNumberScope };

package/dist/primitives/input-number.mjs

@@ -12,6 +12,9 @@ const NUMBER_INPUT_NAME = "InputNumber";
 const [createInputNumberContext, createInputNumberScope] = createContextScope(NUMBER_INPUT_NAME, [createInputScope]);
 const useInputScope = createInputScope();
 const [InputNumberContextProvider, useInputNumberContext] = createInputNumberContext(NUMBER_INPUT_NAME);
+/**
+* @since 0.3.16-canary.0
+*/
 function InputNumber(numberInputProps) {
 	const { __scopeInputNumber, ariaDecrementLabel, ariaIncrementLabel, defaultValue, formatOptions = {
 		minimumFractionDigits: 0,
@@ -148,6 +151,9 @@ function InputNumber(numberInputProps) {
 * The name of the InputNumberField component constant.
 */
 const NUMBER_INPUT_FIELD_NAME = "InputNumberField";
+/**
+* @since 0.3.16-canary.0
+*/
 function InputNumberField({ __scopeInputNumber, onBlur, onKeyDown, ...props }) {
 	const inputScope = useInputScope(__scopeInputNumber);
 	const { defaultValue, disabled, formatValue, id, inputRef, max, min, onChange, onDecrement, onDecrementToMin, onIncrement, onIncrementToMax, parseValue, readOnly, step, value } = useInputNumberContext(NUMBER_INPUT_FIELD_NAME, __scopeInputNumber);
@@ -426,12 +432,18 @@ function NumberStepperButton({ __scopeInputNumber, operation, ...props }) {
 		...props
 	});
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function InputNumberIncrementButton(props) {
 	return /* @__PURE__ */ jsx(NumberStepperButton, {
 		operation: "increment",
 		...props
 	});
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function InputNumberDecrementButton(props) {
 	return /* @__PURE__ */ jsx(NumberStepperButton, {
 		operation: "decrement",

package/dist/primitives/input.d.mts

@@ -57,13 +57,23 @@ interface InputBehaviorProps {
 }
 /**
  * Combined props for the Input component
+ *
+ * @since 0.3.16-canary.0
  */
 type InputProps = PropsWithChildren<InputBehaviorProps & InputVisualProps>;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function Input(inputProps: ScopedProps<InputProps>): JSX.Element;
 /**
  * Props for the InputField component
+ *
+ * @since 0.3.16-canary.0
  */
 type InputFieldProps = ComponentProps<"input">;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function InputField({
   __scopeInput,
   ...props

package/dist/primitives/input.mjs

@@ -6,6 +6,9 @@ import { useComposedRefs } from "@radix-ui/react-compose-refs";
 const INPUT_NAME = "Input";
 const [createInputContext, createInputScope] = createContextScope(INPUT_NAME);
 const [InputContextProvider, useInputContext] = createInputContext(INPUT_NAME);
+/**
+* @since 0.3.16-canary.0
+*/
 function Input(inputProps) {
 	const { __scopeInput, children, disabled, loaderPosition = "prefix", loading, prefix, readOnly, spinner, suffix, ...props } = inputProps;
 	/**
@@ -58,6 +61,9 @@ function Input(inputProps) {
 	});
 }
 const INPUT_FIELD_NAME = "InputField";
+/**
+* @since 0.3.16-canary.0
+*/
 function InputField({ __scopeInput, ...props }) {
 	/**
 	* Context values from parent Input component

package/dist/primitives/progress-circle.d.mts

@@ -24,6 +24,9 @@ interface Threshold {
   value: number;
 }
 declare const createProgressCircleScope: _$_radix_ui_react_context0.CreateScope;
+/**
+ * @since 0.3.16-canary.0
+ */
 interface ProgressCircleProviderProps {
   /**
    * React children to be rendered inside the progress circle
@@ -92,6 +95,8 @@ interface ProgressCircleProviderProps {
  *   <ProgressCircleValue />
  * </ProgressCircleProvider>
  * ```
+ *
+ * @since 0.3.16-canary.0
  */
 declare function ProgressCircleProvider({
   __scopeProgressCircle,
@@ -106,46 +111,69 @@ declare function ProgressCircleProvider({
   thresholds,
   value
 }: ScopedProps<ProgressCircleProviderProps>): ReactNode;
+/**
+ * @since 0.3.16-canary.0
+ */
 type ProgressCircleProps = ComponentProps<"div">;
 /**
  * Root component for the progress circle
  *
  * Serves as a wrapper for other progress circle components.
+ *
+ * @since 0.3.16-canary.0
  */
 declare function ProgressCircle({
   __scopeProgressCircle,
   ...props
 }: ScopedProps<ProgressCircleProps>): ReactNode;
+/**
+ * @since 0.3.16-canary.0
+ */
 type ProgressCircleSVGProps = ComponentProps<"svg">;
 /**
  * SVG container for the progress circle
  *
  * Renders the SVG with accessibility attributes and supports indeterminate state.
+ *
+ * @since 0.3.16-canary.0
  */
 declare function ProgressCircleSVG({
   __scopeProgressCircle,
   ...props
 }: ScopedProps<ProgressCircleSVGProps>): ReactNode;
+/**
+ * @since 0.3.16-canary.0
+ */
 type ProgressCircleTrackProps = ComponentProps<"circle">;
 /**
  * Background circle for the progress indicator
  *
  * Renders the static track of the progress circle.
+ *
+ * @since 0.3.16-canary.0
  */
 declare function ProgressCircleTrack({
   __scopeProgressCircle,
   ...props
 }: ScopedProps<ProgressCircleTrackProps>): ReactNode;
+/**
+ * @since 0.3.16-canary.0
+ */
 type ProgressCircleIndicatorProps = ComponentProps<"circle">;
 /**
  * Foreground circle showing progress
  *
  * Renders the dynamic progress indicator with stroke dash properties.
+ *
+ * @since 0.3.16-canary.0
  */
 declare function ProgressCircleIndicator({
   __scopeProgressCircle,
   ...props
 }: ScopedProps<ProgressCircleIndicatorProps>): ReactNode;
+/**
+ * @since 0.3.16-canary.0
+ */
 interface ProgressCircleValueProps extends Omit<ComponentProps<"div">, "children"> {
   children?: ((context: {
     value: number | undefined;
@@ -156,6 +184,8 @@ interface ProgressCircleValueProps extends Omit<ComponentProps<"div">, "children
  * Displays the current progress value
  *
  * Supports custom content or default value text rendering.
+ *
+ * @since 0.3.16-canary.0
  */
 declare function ProgressCircleValue({
   __scopeProgressCircle,

package/dist/primitives/progress-circle.mjs

@@ -8,10 +8,10 @@ const [createProgressCircleContext, createProgressCircleScope] = createContextSc
 const [ProgressCircleContextProvider, useProgressCircleContext] = createProgressCircleContext(PROGRESS_CIRCLE_PROVIDER_NAME);
 /**
 * Provides context for the ProgressCircle component
-*
+* 
 * Manages calculations for rendering the circular progress indicator,
 * including value clamping, sizing, thresholds, and indeterminate state.
-*
+* 
 * @example
 * ```tsx
 * <ProgressCircleProvider
@@ -32,6 +32,8 @@ const [ProgressCircleContextProvider, useProgressCircleContext] = createProgress
 *   <ProgressCircleValue />
 * </ProgressCircleProvider>
 * ```
+*
+* @since 0.3.16-canary.0
 */
 function ProgressCircleProvider({ __scopeProgressCircle, children, formatValue, id: propertyId, max = 100, min = 0, size = 48, startAngle = -90, strokeWidth = 4, thresholds, value }) {
 	const uniqueId = useId();
@@ -78,8 +80,10 @@ function ProgressCircleProvider({ __scopeProgressCircle, children, formatValue,
 }
 /**
 * Root component for the progress circle
-*
+* 
 * Serves as a wrapper for other progress circle components.
+*
+* @since 0.3.16-canary.0
 */
 function ProgressCircle({ __scopeProgressCircle, ...props }) {
 	return /* @__PURE__ */ jsx("div", { ...props });
@@ -87,8 +91,10 @@ function ProgressCircle({ __scopeProgressCircle, ...props }) {
 const PROGRESS_CIRCLE_SVG_NAME = "ProgressCircleSVG";
 /**
 * SVG container for the progress circle
-*
+* 
 * Renders the SVG with accessibility attributes and supports indeterminate state.
+*
+* @since 0.3.16-canary.0
 */
 function ProgressCircleSVG({ __scopeProgressCircle, ...props }) {
 	const { clampedValue, id, max, min, size, valueText } = useProgressCircleContext(PROGRESS_CIRCLE_SVG_NAME, __scopeProgressCircle);
@@ -109,8 +115,10 @@ function ProgressCircleSVG({ __scopeProgressCircle, ...props }) {
 const PROGRESS_CIRCLE_TRACK_NAME = "ProgressCircleTrack";
 /**
 * Background circle for the progress indicator
-*
+* 
 * Renders the static track of the progress circle.
+*
+* @since 0.3.16-canary.0
 */
 function ProgressCircleTrack({ __scopeProgressCircle, ...props }) {
 	const { center, radius, strokeWidth, threshold } = useProgressCircleContext(PROGRESS_CIRCLE_TRACK_NAME, __scopeProgressCircle);
@@ -127,8 +135,10 @@ function ProgressCircleTrack({ __scopeProgressCircle, ...props }) {
 const PROGRESS_CIRCLE_INDICATOR_NAME = "ProgressCircleIndicator";
 /**
 * Foreground circle showing progress
-*
+* 
 * Renders the dynamic progress indicator with stroke dash properties.
+*
+* @since 0.3.16-canary.0
 */
 function ProgressCircleIndicator({ __scopeProgressCircle, ...props }) {
 	const { center, circumference, radius, rotationTransform, strokeDashoffset, strokeWidth, threshold } = useProgressCircleContext(PROGRESS_CIRCLE_INDICATOR_NAME, __scopeProgressCircle);
@@ -149,8 +159,10 @@ function ProgressCircleIndicator({ __scopeProgressCircle, ...props }) {
 const PROGRESS_CIRCLE_VALUE_NAME = "ProgressCircleValue";
 /**
 * Displays the current progress value
-*
+* 
 * Supports custom content or default value text rendering.
+*
+* @since 0.3.16-canary.0
 */
 function ProgressCircleValue({ __scopeProgressCircle, children, ...props }) {
 	const { clampedValue, valueText } = useProgressCircleContext(PROGRESS_CIRCLE_VALUE_NAME, __scopeProgressCircle);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codefast/ui",
-  "version": "0.3.15",
+  "version": "0.3.16-canary.0",
   "description": "Core UI components library built with React and Tailwind CSS",
   "keywords": [
     "components",
@@ -403,7 +403,7 @@
     "sonner": "^2.0.7",
     "tw-animate-css": "^1.4.0",
     "vaul": "^1.1.2",
-    "@codefast/tailwind-variants": "0.3.15"
+    "@codefast/tailwind-variants": "0.3.16-canary.0"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.2.4",
@@ -413,7 +413,7 @@
     "@testing-library/user-event": "^14.6.1",
     "@types/jest-axe": "^3.5.9",
     "@types/node": "^25.6.0",
-    "@typescript/native-preview": "7.0.0-dev.20260502.1",
+    "@typescript/native-preview": "7.0.0-dev.20260504.1",
     "@vitejs/plugin-react": "^6.0.1",
     "@vitest/coverage-v8": "^4.1.5",
     "jest-axe": "^10.0.0",
@@ -422,7 +422,7 @@
     "tailwindcss": "^4.2.4",
     "typescript": "^6.0.3",
     "vitest": "^4.1.5",
-    "@codefast/typescript-config": "0.3.15"
+    "@codefast/typescript-config": "0.3.16-canary.0"
   },
   "peerDependencies": {
     "@types/react": "^19.0",