npm - @dimasbaguspm/versaur - Versions diffs - 0.0.16 → 0.0.18 - Mend

@dimasbaguspm/versaur 0.0.16 → 0.0.18

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (78) hide show

package/dist/types/forms/price-input/types.d.ts ADDED Viewed

@@ -0,0 +1,15 @@
+import { InputHTMLAttributes } from 'react';
+import { TextInputProps } from '../text-input/types';
+/**
+ * Props for PriceInput component
+ * @property value - The price value as a string (raw, unformatted)
+ * @property onChange - Called when the value changes (returns raw string)
+ * @property allowNegative - Optional: allow negative values (default: false)
+ * @property inputProps - Optional: custom input attributes
+ */
+export interface PriceInputProps extends Omit<TextInputProps, 'type' | 'value' | 'onChange'> {
+    value: string;
+    onChange: (value: string) => void;
+    allowNegative?: boolean;
+    inputProps?: InputHTMLAttributes<HTMLInputElement>;
+}

package/dist/types/forms/price-input/use-price-input.d.ts ADDED Viewed

@@ -0,0 +1,6 @@
+/**
+ * usePriceInputSync synchronizes the local input value with the parent value
+ * @param value - The parent value (string or number)
+ * @param setRawValue - Setter for local raw value
+ */
+export declare function usePriceInputSync(value: string | number, setRawValue: (val: string) => void): void;

package/dist/types/forms/search-input/index.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export { SearchInput } from './search-input';
2	+ export type { SearchInputProps } from './types';

package/dist/types/forms/search-input/search-input.d.ts ADDED Viewed

@@ -0,0 +1,8 @@
+import { SearchInputProps } from './types';
+/**
+ * SearchInput component for Versaur UI
+ *
+ * A styled input field for search, extending TextInput and enforcing HTML search input standards
+ * Follows browser standards and accessibility best practices
+ */
+export declare const SearchInput: import('react').ForwardRefExoticComponent<SearchInputProps & import('react').RefAttributes<HTMLInputElement>>;

package/dist/types/forms/search-input/types.d.ts ADDED Viewed

@@ -0,0 +1,35 @@
+import { TextInputProps } from '../text-input/types';
+/**
+ * Props for the SearchInput component
+ * Extends TextInputProps and enforces type='search' with proper HTML search attributes
+ */
+export interface SearchInputProps extends Omit<TextInputProps, 'type'> {
+    /**
+     * The value of the input
+     */
+    value?: string;
+    /**
+     * Callback when the value changes
+     */
+    onChange?: React.ChangeEventHandler<HTMLInputElement>;
+    /**
+     * Placeholder text for the search input
+     */
+    placeholder?: string;
+    /**
+     * Whether the input is disabled
+     */
+    disabled?: boolean;
+    /**
+     * Whether to show the clear button (native search input feature)
+     */
+    allowClear?: boolean;
+    /**
+     * Autocomplete behavior for the search input
+     */
+    autoComplete?: string;
+    /**
+     * Spellcheck for the search input
+     */
+    spellCheck?: boolean;
+}

package/dist/types/forms/segment-multiple-input/types.d.ts CHANGED Viewed

@@ -9,15 +9,11 @@ export interface SegmentMultipleInputProps extends Omit<InputHTMLAttributes<HTML
      * Semantic variants: success, info, warning, danger
      * Each variant supports outline form for flexible design expression
      */
-    variant?: 'primary' | 'primary-outline' | 'secondary' | 'secondary-outline' | 'tertiary' | 'tertiary-outline' | 'ghost' | 'ghost-outline' | 'neutral' | 'neutral-outline' | 'success' | 'success-outline' | 'info' | 'info-outline' | 'warning' | 'warning-outline' | 'danger' | 'danger-outline';
+    variant?: 'primary' | 'secondary' | 'tertiary' | 'ghost' | 'neutral' | 'success' | 'info' | 'warning' | 'danger';
     /**
      * Size variant for the segment inputs
      */
     size?: 'sm' | 'md' | 'lg';
-    /**
-     * If true, options will fill the parent width equally
-     */
-    fullWidth?: boolean;
     /**
      * Label text to display above the segment group
      */

package/dist/types/forms/segment-single-input/types.d.ts CHANGED Viewed

@@ -9,15 +9,11 @@ export interface SegmentSingleInputProps extends Omit<InputHTMLAttributes<HTMLIn
      * Semantic variants: success, info, warning, danger
      * Each variant supports outline form for flexible design expression
      */
-    variant?: 'primary' | 'primary-outline' | 'secondary' | 'secondary-outline' | 'tertiary' | 'tertiary-outline' | 'ghost' | 'ghost-outline' | 'neutral' | 'neutral-outline' | 'success' | 'success-outline' | 'info' | 'info-outline' | 'warning' | 'warning-outline' | 'danger' | 'danger-outline';
+    variant?: 'primary' | 'secondary' | 'tertiary' | 'ghost' | 'neutral' | 'success' | 'info' | 'warning' | 'danger';
     /**
      * Size variant for the segment inputs
      */
     size?: 'sm' | 'md' | 'lg';
-    /**
-     * If true, the segment group and its options will fill the parent width
-     */
-    fullWidth?: boolean;
     /**
      * Label text to display above the segment group
      */

package/dist/types/forms/switch-input/index.d.ts CHANGED Viewed

@@ -1,3 +1,2 @@
-export * from './switch-input';
-export * from './switch-input.atoms';
-export * from './types';
+export { SwitchInput } from './switch-input';
+export type * from './types';

package/dist/types/forms/time-picker-input/time-picker-input.d.ts CHANGED Viewed

@@ -1,9 +1,9 @@
-import { default as React } from 'react';
 import { TimePickerInputProps } from './types';
 /**
  * TimePickerInput component for Versaur UI
  *
- * Provides a modal-based time picker with hour, minute, and AM/PM selection
- * Follows Material 3 guidelines (no clock UI)
+ * Renders a visually accessible text input
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/time
  */
-export declare const TimePickerInput: React.FC<TimePickerInputProps>;
+export declare const TimePickerInput: import('react').ForwardRefExoticComponent<TimePickerInputProps & import('react').RefAttributes<HTMLInputElement>>;

package/dist/types/forms/time-picker-input/types.d.ts CHANGED Viewed

@@ -1,47 +1,11 @@
-import { ReactNode } from 'react';
-import { ModalRootProps } from '../../overlays/modal';
+import { TextInputProps } from '../text-input';
 /**
  * Props for the TimePickerInput component
  */
-export interface TimePickerInputProps {
-    /**
-     * The selected time value in 12-hour format (e.g., '02:30 PM')
-     */
+export interface TimePickerInputProps extends Omit<TextInputProps, 'type' | 'value' | 'onChange'> {
     value: string;
     /**
      * Called when the time value changes
      */
     onChange: (value: string) => void;
-    /**
-     * Optional label for the input
-     */
-    label?: ReactNode;
-    /**
-     * Optional helper text below the input
-     */
-    helperText?: ReactNode;
-    /**
-     * Whether the input is disabled
-     */
-    disabled?: boolean;
-    /**
-     * Optional error message
-     */
-    error?: ReactNode;
-    /**
-     * Whether to decide the modal placement'
-     */
-    placement?: ModalRootProps['placement'];
-    /**
-     * Optional: ARIA label for dialog
-     */
-    'aria-label'?: string;
-    /**
-     * Optional: ARIA labelledby for dialog
-     */
-    'aria-labelledby'?: string;
-    /**
-     * Optional: ARIA describedby for dialog
-     */
-    'aria-describedby'?: string;
 }

package/dist/types/index.d.ts CHANGED Viewed

@@ -4,3 +4,4 @@ export * from './forms';
 export * from './overlays';
 export * from './primitive';
 export * from './navigation';
+export * from './providers';

package/dist/types/layouts/page-layout/index.d.ts CHANGED Viewed

@@ -1 +1,2 @@
-export * from './page-layout';
+export { PageLayout } from './page-layout';
+export type * from './types';

package/dist/types/overlays/menu/index.d.ts CHANGED Viewed

@@ -1,2 +1,2 @@
-export * from './menu';
-export * from './types';
+export { Menu } from './menu';
+export type * from './types';

package/dist/types/overlays/modal/types.d.ts CHANGED Viewed

@@ -2,7 +2,7 @@ import { HTMLAttributes } from 'react';
 /**
  * Modal component prop types
  */
-export type ModalSize = 'sm' | 'md' | 'lg';
+export type ModalSize = 'sm' | 'md' | 'lg' | 'fit-content';
 export type ModalPlacement = 'top' | 'center';
 /**
  * Modal compound root

package/dist/types/primitive/anchor/types.d.ts CHANGED Viewed

@@ -10,10 +10,16 @@ export interface AnchorProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
     color?: 'primary' | 'secondary' | 'ghost' | 'danger' | 'neutral';
     /**
      * Font size utility (default: 'base')
+     * See: https://tailwindcss.com/docs/font-size
      */
-    fontSize?: string;
+    fontSize?: 'xs' | 'sm' | 'base' | 'lg' | 'xl' | '2xl' | '3xl' | '4xl' | '5xl' | '6xl' | '7xl' | '8xl' | '9xl' | 'inherit' | undefined;
     /**
      * Font weight utility (default: 'medium')
+     * See: https://tailwindcss.com/docs/font-weight
      */
-    fontWeight?: string;
+    fontWeight?: 'thin' | 'extralight' | 'light' | 'normal' | 'medium' | 'semibold' | 'bold' | 'extrabold' | 'black' | 'inherit' | undefined;
+    /**
+     * If true, removes underline style from anchor
+     */
+    quiet?: boolean;
 }

package/dist/types/primitive/description-list/description-list.atoms.d.ts ADDED Viewed

@@ -0,0 +1,13 @@
+import { DescriptionListItemProps, DescriptionListTermProps, DescriptionListDetailsProps } from './types';
+/**
+ * DescriptionList.Item atom
+ */
+export declare const DescriptionListItem: import('react').ForwardRefExoticComponent<DescriptionListItemProps & import('react').RefAttributes<HTMLDivElement>>;
+/**
+ * DescriptionList.Term atom
+ */
+export declare const DescriptionListTerm: import('react').ForwardRefExoticComponent<DescriptionListTermProps & import('react').RefAttributes<HTMLElement>>;
+/**
+ * DescriptionList.Details atom
+ */
+export declare const DescriptionListDetails: import('react').ForwardRefExoticComponent<DescriptionListDetailsProps & import('react').RefAttributes<HTMLElement>>;

package/dist/types/primitive/description-list/description-list.d.ts ADDED Viewed

@@ -0,0 +1,6 @@
+import { DescriptionListProps } from './types';
+export declare const DescriptionList: import('react').ForwardRefExoticComponent<DescriptionListProps & import('react').RefAttributes<HTMLDListElement>> & {
+    Item: import('react').ForwardRefExoticComponent<import('./types').DescriptionListItemProps & import('react').RefAttributes<HTMLDivElement>>;
+    Term: import('react').ForwardRefExoticComponent<import('./types').DescriptionListTermProps & import('react').RefAttributes<HTMLElement>>;
+    Details: import('react').ForwardRefExoticComponent<import('./types').DescriptionListDetailsProps & import('react').RefAttributes<HTMLElement>>;
+};

package/dist/types/primitive/description-list/index.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export { DescriptionList } from './description-list';
2	+ export * from './types';

package/dist/types/primitive/description-list/types.d.ts ADDED Viewed

@@ -0,0 +1,46 @@
+import { ReactNode, HTMLAttributes } from 'react';
+import { TextProps } from '../text';
+/**
+ * Props for the DescriptionList root component
+ */
+export interface DescriptionListProps extends HTMLAttributes<HTMLDListElement> {
+    /**
+     * Children should be DescriptionList.Item elements
+     */
+    children: ReactNode;
+}
+/**
+ * Props for DescriptionList.Item
+ */
+export interface DescriptionListItemProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * Children should be DescriptionList.Term and DescriptionList.Details
+     */
+    children: ReactNode;
+    /**
+     * Number of grid columns to span (default: 4)
+     */
+    span?: number;
+}
+/**
+ * Props for DescriptionList.Term
+ */
+export interface DescriptionListTermProps extends Omit<HTMLAttributes<HTMLElement>, 'children'> {
+    /**
+     * Term label (required, string only)
+     */
+    children: string;
+}
+/**
+ * Props for DescriptionList.Details
+ */
+export interface DescriptionListDetailsProps extends Omit<HTMLAttributes<HTMLElement>, 'children'> {
+    /**
+     * Details value (required, string only)
+     */
+    children: string;
+    /**
+     * Text Color (default: 'black')
+     */
+    color?: TextProps['color'];
+}

package/dist/types/primitive/index.d.ts CHANGED Viewed

@@ -13,3 +13,4 @@ export * from './snackbar';
 export * from './table';
 export * from './text';
 export * from './tile';
+export * from './description-list';

package/dist/types/providers/index.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from './snackbars-provider';

package/dist/types/providers/snackbars-provider/index.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+export { SnackbarsProvider } from './provider';
+export { useSnackbars } from './use-snackbars';
+export type * from './types';

package/dist/types/providers/snackbars-provider/provider.d.ts ADDED Viewed

@@ -0,0 +1,7 @@
+import { FC } from 'react';
+import { SnackbarsProviderProps } from './types';
+/**
+ * SnackbarsProvider manages a queue of snackbars and provides showSnack
+ * Placement: full width bottom for mobile, bottom left for desktop/tablet
+ */
+export declare const SnackbarsProvider: FC<SnackbarsProviderProps>;

package/dist/types/providers/snackbars-provider/types.d.ts ADDED Viewed

@@ -0,0 +1,28 @@
+import { ReactNode } from 'react';
+/**
+ * SnackbarQueueItem: Represents a snackbar in the queue
+ */
+export interface SnackbarQueueItem {
+    /** Unique id for the snackbar */
+    id: string;
+    /** Message content */
+    message: ReactNode;
+    /** Color variant */
+    color?: 'success' | 'info' | 'warning' | 'danger';
+    /** Optional action element */
+    action?: ReactNode;
+    /** Optional duration in milliseconds */
+    duration?: number | null;
+}
+export type ShowSnackFunction = (color: SnackbarQueueItem['color'], message: ReactNode, options?: Partial<Omit<SnackbarQueueItem, 'id' | 'color' | 'message'>>) => void;
+/**
+ * SnackbarsContextValue: Context value for snackbars
+ */
+export interface SnackbarsContextValue {
+    /** Show a snackbar */
+    showSnack: ShowSnackFunction;
+}
+export interface SnackbarsProviderProps {
+    /** Children to render inside the provider */
+    children: ReactNode;
+}

package/dist/types/providers/snackbars-provider/use-snackbars-queue.d.ts ADDED Viewed

@@ -0,0 +1,9 @@
+import { ShowSnackFunction, SnackbarQueueItem } from './types';
+/**
+ * Custom hook to manage snackbar queue and auto-close logic
+ */
+export declare function useSnackbarsQueue(): {
+    queue: SnackbarQueueItem[];
+    showSnack: ShowSnackFunction;
+    removeSnack: (id: string) => void;
+};

package/dist/types/providers/snackbars-provider/use-snackbars.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+/**
+ * useSnackbars: Access the snackbars context and showSnack function
+ */
+export declare function useSnackbars(): import('./types').SnackbarsContextValue;

package/dist/{js → utils}/enforce-subpath-import.js RENAMED Viewed

@@ -1,57 +1,65 @@
 /**
- * ESLint rule for Versaur: enforce sub-path imports for optimal tree-shaking (Flat config compatible)
+ * Auto-generated symbol-to-subpath mapping and ESLint rule for Versaur
+ * Run dist/utils/lint-rules.cjs to update
  */
 const symbolToSubpath = {
-  // primitive
-  Button: 'primitive',
-  ButtonFloat: 'primitive',
-  ButtonIcon: 'primitive',
-  Anchor: 'primitive',
-  Avatar: 'primitive',
-  Badge: 'primitive',
-  Brand: 'primitive',
-  Calculator: 'primitive',
-  Calendar: 'primitive',
-  Icon: 'primitive',
-  Snackbar: 'primitive',
-  Table: 'primitive',
-  Text: 'primitive',
-  Tile: 'primitive',
-  Alert: 'primitive',
-  // overlays
-  Drawer: 'overlays',
-  Modal: 'overlays',
-  Menu: 'overlays',
-  BottomSheet: 'overlays',
-  // navigation
-  Tabs: 'navigation',
-  Breadcrumbs: 'navigation',
-  // layouts
-  AppBar: 'layouts',
-  BottomBar: 'layouts',
-  FormLayout: 'layouts',
-  PageLayout: 'layouts',
-  TopBar: 'layouts',
-  // feedbacks
-  LoadingIndicator: 'feedbacks',
-  ProgressIndicator: 'feedbacks',
-  Skeleton: 'feedbacks',
-  // forms
-  CalculatorInput: 'forms',
-  CheckboxInput: 'forms',
-  ChipInput: 'forms',
-  DateSinglePickerInput: 'forms',
-  DateRangePickerInput: 'forms',
-  RadioInput: 'forms',
-  SegmentMultipleInput: 'forms',
-  SegmentSingleInput: 'forms',
-  SelectInput: 'forms',
-  SwitchInput: 'forms',
-  TextInput: 'forms',
-  TextareaInput: 'forms',
-  TimePickerInput: 'forms',
-}
+  "LoadingIndicator": "feedbacks",
+  "ProgressIndicator": "feedbacks",
+  "Skeleton": "feedbacks",
+  "CheckboxInput": "forms",
+  "ChipMultipleInput": "forms",
+  "ChipSingleInput": "forms",
+  "DateSinglePickerInput": "forms",
+  "EmailInput": "forms",
+  "PriceInput": "forms",
+  "RadioInput": "forms",
+  "SearchInput": "forms",
+  "SegmentMultipleInput": "forms",
+  "SegmentSingleInput": "forms",
+  "SelectInput": "forms",
+  "SwitchInput": "forms",
+  "TextInput": "forms",
+  "TextAreaInput": "forms",
+  "TimePickerInput": "forms",
+  "AppBar": "layouts",
+  "BottomBar": "layouts",
+  "FormLayout": "layouts",
+  "PageLayout": "layouts",
+  "TopBar": "layouts",
+  "Breadcrumbs": "navigation",
+  "Tabs": "navigation",
+  "BottomSheet": "overlays",
+  "Drawer": "overlays",
+  "Menu": "overlays",
+  "Modal": "overlays",
+  "Alert": "primitive",
+  "Anchor": "primitive",
+  "Avatar": "primitive",
+  "Badge": "primitive",
+  "Brand": "primitive",
+  "Button": "primitive",
+  "ButtonFloat": "primitive",
+  "ButtonIcon": "primitive",
+  "Calculator": "primitive",
+  "Calendar": "primitive",
+  "DescriptionList": "primitive",
+  "Icon": "primitive",
+  "Snackbar": "primitive",
+  "Table": "primitive",
+  "Text": "primitive",
+  "Tile": "primitive",
+  "SnackbarsProvider": "providers",
+  "useSnackbars": "providers",
+  "cn": "utils",
+  "cva": "utils",
+  "createVariants": "utils"
+};
+/**
+ * ESLint rule for Versaur: enforce sub-path imports for optimal tree-shaking (Flat config compatible)
+ * This file expects a symbolToSubpath object to be defined in the scope before it is loaded.
+ */
 const rules = {
   meta: {
@@ -116,7 +124,9 @@ const rules = {
   },
 }
-// export array of config objects for flexible flat config usage
+// Compose the config for ESLint Flat config usage
 export const versaurEnforceSubpathImport = [
   {
     plugins: {

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@dimasbaguspm/versaur",
-  "version": "0.0.16",
+  "version": "0.0.18",
   "description": "React UI library with Tailwind CSS",
   "author": "Dimas Bagus Prayogo Mukti<dimas.bagus.pm@gmail.com>",
   "license": "MIT",
@@ -38,14 +38,18 @@
       "import": "./dist/js/overlays/index.js",
       "types": "./dist/types/overlays/index.d.ts"
     },
-    "./styles.css": "./dist/js/styles.css",
-    "./eslint-subpath-import": "./dist/js/enforce-subpath-import.js"
+    "./providers": {
+      "import": "./dist/js/providers/index.js",
+      "types": "./dist/types/providers/index.d.ts"
+    },
+    "./styles.css": "./dist/assets/styles.css",
+    "./eslint-subpath-import": "./dist/utils/enforce-subpath-import.js"
   },
   "files": [
     "dist"
   ],
   "scripts": {
-    "build": "tsc && vite build",
+    "build": "tsc && vite build && node scripts/post-build.cjs",
     "typecheck": "tsc --noEmit",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",