@gnwebsoft/ui 3.0.0 → 3.0.2

package/dist/index.d.cts

@@ -0,0 +1,14 @@
+export { AuthorizedView, CancelButton, ClearButton, FilterButton, FilterWrapper, FormWrapper, LabelText, ListWrapper, SimpleButton, SimpleToolbar } from './components/index.cjs';
+export { UseTransformOptions, UseTransformReturn, useTransform } from './hooks/index.cjs';
+export { E as EnhancedUseTransformOptions, a as EnhancedUseTransformReturn, F as FieldType, t as transformFactories, u as useEnhancedTransform } from './enhanced-z-I7EHVS.cjs';
+export { ApiResponse, AsyncMultiSelectPayload, AsyncSelectMultiPayload, AsyncSelectPayload, ListResponse, OperationResponse, OptionItem, OptionItem2, PostModel, ValidationErrors, ValueLabel } from './types/index.cjs';
+export { PathArray, api, api2, flattenObjectKeys, getTimezone, handleServerErrors, propertyExists, readValueAsDate, removeLeadingTrailingSlashes, schemaTools, typedWatch, useWatchBatch, useWatchBoolean, useWatchConditional, useWatchDebounced, useWatchDefault, useWatchField, useWatchFields, useWatchForm, useWatchSelector, useWatchTransform } from './utils/index.cjs';
+export { AsyncMultiSelect2, AsyncMultiSelect2Props, AsyncSelect2Payload, BrandedDate, CheckboxElement, CheckboxElementProps, CheckboxGroup, CheckboxGroupProps, DatePickerElement, DatePickerElementCore, DatePickerElementCoreProps, DatePickerElementGridProps, DatePickerElementProps, DatePickerHookReturn, DatePickerValidationConfig, DateTransform, EnhancedTextFieldElement, EnhancedTextFieldElementProps, Option2Item, OptionObject, PasswordElement, RadioButtonGroup, SelectCascadeElement, SelectElement, SelectMultiElement, TextFieldElement, TimePickerElement, TypedDatePickerSlotProps, UseDatePickerStylesOptions, UseDatePickerStylesReturn, UseDatePickerValidationOptions, UseDatePickerValidationReturn, UseDatePickerValueOptions, UseDatePickerValueReturn, ValidatedDate, createDateInputTransform, createDateOutputTransform, createDefaultDatePickerConfig, createStableKey, extractErrorMessage, isParsableDateString, isValidDate, readDatePickerValueAsDate, useDatePickerStyles, useDatePickerValidation, useDatePickerValue } from './wrappers/index.cjs';
+import 'react/jsx-runtime';
+import '@mui/material';
+import 'react';
+import 'react-hook-form';
+import '@mui/x-data-grid';
+import '@mui/x-date-pickers';
+import '@mui/x-date-pickers/internals';
+import 'zod';

package/dist/index.d.ts

@@ -1,18 +1,14 @@
 export { AuthorizedView, CancelButton, ClearButton, FilterButton, FilterWrapper, FormWrapper, LabelText, ListWrapper, SimpleButton, SimpleToolbar } from './components/index.js';
 export { UseTransformOptions, UseTransformReturn, useTransform } from './hooks/index.js';
-export { ApiResponse, ListResponse, OperationResponse, PostModel, ValidationErrors, ValueLabel } from './types/index.js';
-export { api, api2, flattenObjectKeys, getTimezone, handleServerErrors, propertyExists, readValueAsDate, removeLeadingTrailingSlashes, schemaTools } from './utils/index.js';
-export { Field } from './wrappers/index.js';
-export { Field2 } from './wrappers2/index.js';
-export { a as AsyncSelectMultiPayload, A as AsyncSelectPayload } from './AsyncSelectPayload-Cz4bgak0.js';
-export { A as AsyncMultiSelectPayload, O as OptionItem, a as OptionItem2 } from './OptionItem-oN6XnOTJ.js';
+export { E as EnhancedUseTransformOptions, a as EnhancedUseTransformReturn, F as FieldType, t as transformFactories, u as useEnhancedTransform } from './enhanced-z-I7EHVS.js';
+export { ApiResponse, AsyncMultiSelectPayload, AsyncSelectMultiPayload, AsyncSelectPayload, ListResponse, OperationResponse, OptionItem, OptionItem2, PostModel, ValidationErrors, ValueLabel } from './types/index.js';
+export { PathArray, api, api2, flattenObjectKeys, getTimezone, handleServerErrors, propertyExists, readValueAsDate, removeLeadingTrailingSlashes, schemaTools, typedWatch, useWatchBatch, useWatchBoolean, useWatchConditional, useWatchDebounced, useWatchDefault, useWatchField, useWatchFields, useWatchForm, useWatchSelector, useWatchTransform } from './utils/index.js';
+export { AsyncMultiSelect2, AsyncMultiSelect2Props, AsyncSelect2Payload, BrandedDate, CheckboxElement, CheckboxElementProps, CheckboxGroup, CheckboxGroupProps, DatePickerElement, DatePickerElementCore, DatePickerElementCoreProps, DatePickerElementGridProps, DatePickerElementProps, DatePickerHookReturn, DatePickerValidationConfig, DateTransform, EnhancedTextFieldElement, EnhancedTextFieldElementProps, Option2Item, OptionObject, PasswordElement, RadioButtonGroup, SelectCascadeElement, SelectElement, SelectMultiElement, TextFieldElement, TimePickerElement, TypedDatePickerSlotProps, UseDatePickerStylesOptions, UseDatePickerStylesReturn, UseDatePickerValidationOptions, UseDatePickerValidationReturn, UseDatePickerValueOptions, UseDatePickerValueReturn, ValidatedDate, createDateInputTransform, createDateOutputTransform, createDefaultDatePickerConfig, createStableKey, extractErrorMessage, isParsableDateString, isValidDate, readDatePickerValueAsDate, useDatePickerStyles, useDatePickerValidation, useDatePickerValue } from './wrappers/index.js';
 import 'react/jsx-runtime';
 import '@mui/material';
 import 'react';
-import '@mui/material/OverridableComponent';
 import 'react-hook-form';
 import '@mui/x-data-grid';
 import '@mui/x-date-pickers';
 import '@mui/x-date-pickers/internals';
 import 'zod';
-import '@mui/x-date-pickers/models';

package/dist/index.js

@@ -1,58 +1,127 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
-
-
-
-
-
-
-
-
-
-
-var _chunkJKUOV3MNjs = require('./chunk-JKUOV3MN.js');
-require('./chunk-7M2VOCYN.js');
-require('./chunk-6BGQA4BQ.js');
-
-
-var _chunk6NOXJGU2js = require('./chunk-6NOXJGU2.js');
-
-
-var _chunkD3J7MWAUjs = require('./chunk-D3J7MWAU.js');
-
-
-var _chunk6JZ35VQJjs = require('./chunk-6JZ35VQJ.js');
-
-
-
-
-
-
-
-
-
-
-var _chunkI7EIUZKKjs = require('./chunk-I7EIUZKK.js');
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-exports.AuthorizedView = _chunkJKUOV3MNjs.AuthorizedView_default; exports.CancelButton = _chunkJKUOV3MNjs.CancelButton_default; exports.ClearButton = _chunkJKUOV3MNjs.ClearButton_default; exports.Field = _chunkD3J7MWAUjs.Field_default; exports.Field2 = _chunk6NOXJGU2js.Field_default; exports.FilterButton = _chunkJKUOV3MNjs.FilterButton_default; exports.FilterWrapper = _chunkJKUOV3MNjs.FilterWrapper_default; exports.FormWrapper = _chunkJKUOV3MNjs.FormWrapper_default; exports.LabelText = _chunkJKUOV3MNjs.LabelText_default; exports.ListWrapper = _chunkJKUOV3MNjs.ListWrapper_default; exports.SimpleButton = _chunkJKUOV3MNjs.SimpleButton_default; exports.SimpleToolbar = _chunkJKUOV3MNjs.SimpleToolbar_default; exports.api = _chunkI7EIUZKKjs.api; exports.api2 = _chunkI7EIUZKKjs.api2; exports.flattenObjectKeys = _chunkI7EIUZKKjs.flattenObjectKeys; exports.getTimezone = _chunkI7EIUZKKjs.getTimezone; exports.handleServerErrors = _chunkI7EIUZKKjs.handleServerErrors; exports.propertyExists = _chunkI7EIUZKKjs.propertyExists; exports.readValueAsDate = _chunkI7EIUZKKjs.readValueAsDate; exports.removeLeadingTrailingSlashes = _chunkI7EIUZKKjs.removeLeadingTrailingSlashes; exports.schemaTools = _chunkI7EIUZKKjs.schemaTools; exports.useTransform = _chunk6JZ35VQJjs.useTransform;
+import {
+  AuthorizedView_default,
+  CancelButton_default,
+  ClearButton_default,
+  FilterButton_default,
+  FilterWrapper_default,
+  FormWrapper_default,
+  LabelText_default,
+  ListWrapper_default,
+  SimpleButton_default,
+  SimpleToolbar_default
+} from "./chunk-U6SDYCWF.js";
+import "./chunk-OJF67RNM.js";
+import "./chunk-DEPJRTVT.js";
+import {
+  api,
+  api2,
+  flattenObjectKeys,
+  getTimezone,
+  handleServerErrors,
+  propertyExists,
+  readValueAsDate,
+  removeLeadingTrailingSlashes,
+  schemaTools,
+  typedWatch,
+  useWatchBatch,
+  useWatchBoolean,
+  useWatchConditional,
+  useWatchDebounced,
+  useWatchDefault,
+  useWatchField,
+  useWatchFields,
+  useWatchForm,
+  useWatchSelector,
+  useWatchTransform
+} from "./chunk-4H3AFH7A.js";
+import {
+  AsyncMultiSelect2,
+  CheckboxElement,
+  CheckboxGroup,
+  DatePickerElement,
+  DatePickerElementCore,
+  EnhancedTextFieldElement,
+  PasswordElement_default,
+  RadioButtonGroup_default,
+  SelectCascadeElement_default,
+  SelectElement_default,
+  SelectMultiElement_default,
+  TextFieldElement_default,
+  TimePickerElement_default,
+  createDateInputTransform,
+  createDateOutputTransform,
+  createDefaultDatePickerConfig,
+  createStableKey,
+  extractErrorMessage,
+  isParsableDateString,
+  isValidDate,
+  readDatePickerValueAsDate,
+  useDatePickerStyles,
+  useDatePickerValidation,
+  useDatePickerValue
+} from "./chunk-H3GQLELL.js";
+import {
+  transformFactories,
+  useEnhancedTransform,
+  useTransform
+} from "./chunk-DE62KYFK.js";
+export {
+  AsyncMultiSelect2,
+  AuthorizedView_default as AuthorizedView,
+  CancelButton_default as CancelButton,
+  CheckboxElement,
+  CheckboxGroup,
+  ClearButton_default as ClearButton,
+  DatePickerElement,
+  DatePickerElementCore,
+  EnhancedTextFieldElement,
+  FilterButton_default as FilterButton,
+  FilterWrapper_default as FilterWrapper,
+  FormWrapper_default as FormWrapper,
+  LabelText_default as LabelText,
+  ListWrapper_default as ListWrapper,
+  PasswordElement_default as PasswordElement,
+  RadioButtonGroup_default as RadioButtonGroup,
+  SelectCascadeElement_default as SelectCascadeElement,
+  SelectElement_default as SelectElement,
+  SelectMultiElement_default as SelectMultiElement,
+  SimpleButton_default as SimpleButton,
+  SimpleToolbar_default as SimpleToolbar,
+  TextFieldElement_default as TextFieldElement,
+  TimePickerElement_default as TimePickerElement,
+  api,
+  api2,
+  createDateInputTransform,
+  createDateOutputTransform,
+  createDefaultDatePickerConfig,
+  createStableKey,
+  extractErrorMessage,
+  flattenObjectKeys,
+  getTimezone,
+  handleServerErrors,
+  isParsableDateString,
+  isValidDate,
+  propertyExists,
+  readDatePickerValueAsDate,
+  readValueAsDate,
+  removeLeadingTrailingSlashes,
+  schemaTools,
+  transformFactories,
+  typedWatch,
+  useDatePickerStyles,
+  useDatePickerValidation,
+  useDatePickerValue,
+  useEnhancedTransform,
+  useTransform,
+  useWatchBatch,
+  useWatchBoolean,
+  useWatchConditional,
+  useWatchDebounced,
+  useWatchDefault,
+  useWatchField,
+  useWatchFields,
+  useWatchForm,
+  useWatchSelector,
+  useWatchTransform
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFtdLAogICJzb3VyY2VzQ29udGVudCI6IFtdLAogICJtYXBwaW5ncyI6ICIiLAogICJuYW1lcyI6IFtdCn0K

package/dist/types/index.cjs

@@ -0,0 +1,2 @@
+"use strict";require('../chunk-FD57PCAC.cjs');
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbImQ6XFxQcm9qZWN0c1xcZ253ZWItbW9ub3JlcG9cXHBhY2thZ2VzXFx1aVxcZGlzdFxcdHlwZXNcXGluZGV4LmNqcyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSw4Q0FBOEIiLCJmaWxlIjoiRDpcXFByb2plY3RzXFxnbndlYi1tb25vcmVwb1xccGFja2FnZXNcXHVpXFxkaXN0XFx0eXBlc1xcaW5kZXguY2pzIn0=

package/dist/types/index.d.cts

@@ -0,0 +1,241 @@
+import { GridSortModel } from '@mui/x-data-grid';
+
+/**
+ * Type definition for server validation errors structure.
+ *
+ * This type represents the format of validation errors returned from server APIs.
+ * It supports multiple error formats for each field, allowing flexibility in how
+ * validation errors are communicated and processed.
+ *
+ * @example
+ * String error messages:
+ * ```tsx
+ * const errors: ValidationErrors = {
+ *   email: 'Email is required',
+ *   username: 'Username must be unique'
+ * };
+ * ```
+ *
+ * @example
+ * Array of error messages:
+ * ```tsx
+ * const errors: ValidationErrors = {
+ *   password: [
+ *     'Password must be at least 8 characters',
+ *     'Password must contain at least one number',
+ *     'Password must contain at least one special character'
+ *   ]
+ * };
+ * ```
+ *
+ * @example
+ * Boolean flags for validation state:
+ * ```tsx
+ * const errors: ValidationErrors = {
+ *   termsAccepted: false, // Field is invalid
+ *   emailVerified: true   // Field has an error
+ * };
+ * ```
+ *
+ * @example
+ * Structured error objects:
+ * ```tsx
+ * const errors: ValidationErrors = {
+ *   dateOfBirth: {
+ *     key: 'DATE_INVALID',
+ *     message: 'Date of birth must be in the past'
+ *   }
+ * };
+ * ```
+ *
+ * @public
+ */
+interface ValidationErrors {
+    [field: string]: string | string[] | boolean | {
+        key: string;
+        message: string;
+    };
+}
+
+/**
+ * Standardized API response structure for server communications.
+ *
+ * This type defines the common structure for API responses throughout the application,
+ * providing a consistent interface for handling server responses, errors, and data.
+ * It follows a standard error response format with optional success data.
+ *
+ * @template TModel - The type of data contained in the apiData field
+ *
+ * @example
+ * Success response with data:
+ * ```tsx
+ * const userResponse: ApiResponse<User> = {
+ *   status: 200,
+ *   apiData: {
+ *     id: 1,
+ *     name: 'John Doe',
+ *     email: 'john@example.com'
+ *   }
+ * };
+ * ```
+ *
+ * @example
+ * Error response with validation errors:
+ * ```tsx
+ * const errorResponse: ApiResponse<null> = {
+ *   type: 'validation_error',
+ *   title: 'Validation failed',
+ *   status: 400,
+ *   traceId: 'abc123',
+ *   errors: {
+ *     email: 'Email is required',
+ *     password: ['Too short', 'Must contain numbers']
+ *   },
+ *   modelErrors: true
+ * };
+ * ```
+ *
+ * @public
+ */
+interface ApiResponse<TModel> {
+    /**
+     * The type or category of the response/error
+     * @example "validation_error" | "server_error" | "success"
+     */
+    type?: string;
+    /**
+     * Human-readable title or summary of the response
+     * @example "Validation Failed" | "User Created Successfully"
+     */
+    title?: string;
+    /**
+     * HTTP status code of the response
+     * @example 200 | 400 | 500
+     */
+    status?: number;
+    /**
+     * Unique identifier for tracing/debugging the request
+     * @example "abc123-def456-ghi789"
+     */
+    traceId?: string;
+    /**
+     * Field-specific validation errors
+     */
+    errors?: ValidationErrors;
+    /**
+     * Flag indicating if there are model validation errors
+     */
+    modelErrors?: boolean;
+    /**
+     * The actual response data/payload
+     */
+    apiData?: TModel;
+}
+
+interface AsyncSelectPayload {
+    query: string | null;
+    initialValue?: string | number | null;
+}
+interface AsyncSelectMultiPayload {
+    query: string | null;
+    initialValues?: string[] | number[] | null;
+}
+
+/**
+ * Standard option item structure for select components.
+ *
+ * This type defines the expected structure for option items used in
+ * select components throughout the application. It provides a consistent
+ * interface with string labels and values.
+ *
+ * @example
+ * Basic usage:
+ * ```tsx
+ * const categories: OptionItem[] = [
+ *   { Label: 'Technology', Value: 'tech' },
+ *   { Label: 'Finance', Value: 'finance' },
+ *   { Label: 'Healthcare', Value: 'health' }
+ * ];
+ * ```
+ *
+ * @public
+ */
+interface OptionItem {
+    /** Display text shown to the user */
+    Label: string;
+    /** Internal value used for form submission and identification */
+    Value: string;
+}
+/**
+ * Payload structure for async multi-select operations.
+ *
+ * This type defines the data structure used when performing asynchronous
+ * multi-select operations, typically for server-side filtering and loading
+ * of options with pre-selected values.
+ *
+ * @example
+ * Search with initial values:
+ * ```tsx
+ * const payload: AsyncMultiSelectPayload = {
+ *   query: 'john',
+ *   initialValues: ['user1', 'user2', 'user3']
+ * };
+ * ```
+ *
+ * @public
+ */
+interface AsyncMultiSelectPayload {
+    /** Search query string for filtering options */
+    query: string | null;
+    /** Pre-selected values to be included in the selection */
+    initialValues?: string[] | number[] | null;
+}
+/**
+ * Extended option item structure supporting both string and number values.
+ *
+ * This type extends the basic OptionItem to support numeric values,
+ * providing flexibility for different data types while maintaining
+ * the same label-value structure.
+ *
+ * @example
+ * Mixed value types:
+ * ```tsx
+ * const options: OptionItem2[] = [
+ *   { Label: 'First Option', Value: 1 },
+ *   { Label: 'Second Option', Value: 'second' },
+ *   { Label: 'Third Option', Value: 3 }
+ * ];
+ * ```
+ *
+ * @public
+ */
+interface OptionItem2 {
+    /** Display text shown to the user */
+    Label: string;
+    /** Internal value that can be either a number or string */
+    Value: number | string;
+}
+
+interface OperationResponse {
+    id?: number;
+    rowsAffected: number;
+}
+
+interface PostModel<TFilterModel> {
+    filterModel?: TFilterModel;
+    pageOffset: number;
+    pageSize: number;
+    sortField: string | null;
+    sortOrder: "asc" | "desc" | null | undefined;
+    sortModel?: GridSortModel;
+}
+interface ListResponse<TGridModel> {
+    Data: TGridModel[];
+    Total: number;
+}
+interface ValueLabel {
+    Value: number | string;
+    Label: string;
+}
+
+export type { ApiResponse, AsyncMultiSelectPayload, AsyncSelectMultiPayload, AsyncSelectPayload, ListResponse, OperationResponse, OptionItem, OptionItem2, PostModel, ValidationErrors, ValueLabel };