@alepha/react 0.12.1 → 0.13.1

package/dist/form/index.d.cts

@@ -1,419 +0,0 @@
-import * as alepha8 from "alepha";
-import { Alepha, LogLevel, LoggerInterface, Static, TObject, TSchema, TypeBoxError } from "alepha";
-import { InputHTMLAttributes, ReactNode } from "react";
-import dayjsDuration from "dayjs/plugin/duration.js";
-import DayjsApi, { Dayjs, ManipulateType, PluginFunc } from "dayjs";
-
-//#region ../alepha/src/logger/schemas/logEntrySchema.d.ts
-declare const logEntrySchema: alepha8.TObject<{
-  level: alepha8.TUnsafe<"SILENT" | "TRACE" | "DEBUG" | "INFO" | "WARN" | "ERROR">;
-  message: alepha8.TString;
-  service: alepha8.TString;
-  module: alepha8.TString;
-  context: alepha8.TOptional<alepha8.TString>;
-  app: alepha8.TOptional<alepha8.TString>;
-  data: alepha8.TOptional<alepha8.TAny>;
-  timestamp: alepha8.TNumber;
-}>;
-type LogEntry = Static<typeof logEntrySchema>;
-//#endregion
-//#region ../alepha/src/datetime/providers/DateTimeProvider.d.ts
-type DateTime = DayjsApi.Dayjs;
-type Duration = dayjsDuration.Duration;
-type DurationLike = number | dayjsDuration.Duration | [number, ManipulateType];
-declare class DateTimeProvider {
-  static PLUGINS: Array<PluginFunc<any>>;
-  protected alepha: Alepha;
-  protected ref: DateTime | null;
-  protected readonly timeouts: Timeout[];
-  protected readonly intervals: Interval[];
-  constructor();
-  protected readonly onStart: alepha8.HookDescriptor<"start">;
-  protected readonly onStop: alepha8.HookDescriptor<"stop">;
-  setLocale(locale: string): void;
-  isDateTime(value: unknown): value is DateTime;
-  /**
-   * Create a new UTC DateTime instance.
-   */
-  utc(date: string | number | Date | Dayjs | null | undefined): DateTime;
-  /**
-   * Create a new DateTime instance.
-   */
-  of(date: string | number | Date | Dayjs | null | undefined): DateTime;
-  /**
-   * Get the current date as a string.
-   */
-  toISOString(date?: Date | string | DateTime): string;
-  /**
-   * Get the current date.
-   */
-  now(): DateTime;
-  /**
-   * Get the current date as a string.
-   *
-   * This is much faster than `DateTimeProvider.now().toISOString()` as it avoids creating a DateTime instance.
-   */
-  nowISOString(): string;
-  /**
-   * Get the current date as milliseconds since epoch.
-   *
-   * This is much faster than `DateTimeProvider.now().valueOf()` as it avoids creating a DateTime instance.
-   */
-  nowMillis(): number;
-  /**
-   * Get the current date as a string.
-   *
-   * @protected
-   */
-  protected getCurrentDate(): DateTime;
-  /**
-   * Create a new Duration instance.
-   */
-  duration: (duration: DurationLike, unit?: ManipulateType) => Duration;
-  isDurationLike(value: unknown): value is DurationLike;
-  /**
-   * Return a promise that resolves after the next tick.
-   * It uses `setTimeout` with 0 ms delay.
-   */
-  tick(): Promise<void>;
-  /**
-   * Wait for a certain duration.
-   *
-   * You can clear the timeout by using the `AbortSignal` API.
-   * Aborted signal will resolve the promise immediately, it does not reject it.
-   */
-  wait(duration: DurationLike, options?: {
-    signal?: AbortSignal;
-    now?: number;
-  }): Promise<void>;
-  createInterval(run: () => unknown, duration: DurationLike, start?: boolean): Interval;
-  /**
-   * Run a callback after a certain duration.
-   */
-  createTimeout(callback: () => void, duration: DurationLike, now?: number): Timeout;
-  clearTimeout(timeout: Timeout): void;
-  clearInterval(interval: Interval): void;
-  /**
-   * Run a function with a deadline.
-   */
-  deadline<T>(fn: (signal: AbortSignal) => Promise<T>, duration: DurationLike): Promise<T>;
-  /**
-   * Add time to the current date.
-   */
-  travel(duration: DurationLike, unit?: ManipulateType): Promise<void>;
-  /**
-   * Stop the time.
-   */
-  pause(): DateTime;
-  /**
-   * Reset the reference date.
-   */
-  reset(): void;
-}
-interface Interval {
-  timer?: any;
-  duration: number;
-  run: () => unknown;
-}
-interface Timeout {
-  now: number;
-  timer?: any;
-  duration: number;
-  callback: () => void;
-  clear: () => void;
-}
-//#endregion
-//#region ../alepha/src/logger/providers/LogDestinationProvider.d.ts
-declare abstract class LogDestinationProvider {
-  abstract write(message: string, entry: LogEntry): void;
-}
-//#endregion
-//#region ../alepha/src/logger/providers/LogFormatterProvider.d.ts
-declare abstract class LogFormatterProvider {
-  abstract format(entry: LogEntry): string;
-}
-//#endregion
-//#region ../alepha/src/logger/services/Logger.d.ts
-declare class Logger implements LoggerInterface {
-  protected readonly alepha: Alepha;
-  protected readonly formatter: LogFormatterProvider;
-  protected readonly destination: LogDestinationProvider;
-  protected readonly dateTimeProvider: DateTimeProvider;
-  protected readonly levels: Record<string, number>;
-  protected readonly service: string;
-  protected readonly module: string;
-  protected readonly app?: string;
-  protected appLogLevel: string;
-  protected logLevel: LogLevel;
-  constructor(service: string, module: string);
-  get context(): string | undefined;
-  get level(): string;
-  parseLevel(level: string, app: string): LogLevel;
-  private matchesPattern;
-  asLogLevel(something: string): LogLevel;
-  error(message: string, data?: unknown): void;
-  warn(message: string, data?: unknown): void;
-  info(message: string, data?: unknown): void;
-  debug(message: string, data?: unknown): void;
-  trace(message: string, data?: unknown): void;
-  protected log(level: LogLevel, message: string, data?: unknown): void;
-  protected emit(entry: LogEntry, message?: string): void;
-}
-//#endregion
-//#region ../alepha/src/logger/index.d.ts
-declare const envSchema: alepha8.TObject<{
-  /**
-   * Default log level for the application.
-   *
-   * Default by environment:
-   * - dev = info
-   * - prod = info
-   * - test = error
-   *
-   * Levels are: "trace" | "debug" | "info" | "warn" | "error" | "silent"
-   *
-   * Level can be set for a specific module:
-   *
-   * @example
-   * LOG_LEVEL=my.module.name:debug,info # Set debug level for my.module.name and info for all other modules
-   * LOG_LEVEL=alepha:trace, info # Set trace level for all alepha modules and info for all other modules
-   */
-  LOG_LEVEL: alepha8.TOptional<alepha8.TString>;
-  /**
-   * Built-in log formats.
-   * - "json" - JSON format, useful for structured logging and log aggregation. {@link JsonFormatterProvider}
-   * - "pretty" - Simple text format, human-readable, with colors. {@link SimpleFormatterProvider}
-   * - "raw" - Raw format, no formatting, just the message.  {@link RawFormatterProvider}
-   */
-  LOG_FORMAT: alepha8.TOptional<alepha8.TUnsafe<"json" | "pretty" | "raw">>;
-}>;
-declare module "alepha" {
-  interface Env extends Partial<Static<typeof envSchema>> {}
-  interface State {
-    /**
-     * Current log level for the application or specific modules.
-     */
-    "alepha.logger.level"?: string;
-  }
-  interface Hooks {
-    log: {
-      message?: string;
-      entry: LogEntry;
-    };
-  }
-}
-//#endregion
-//#region src/form/services/FormModel.d.ts
-/**
- * FormModel is a dynamic form handler that generates form inputs based on a provided TypeBox schema.
- * It manages form state, handles input changes, and processes form submissions with validation.
- *
- * It means to be injected and used within React components to provide a structured way to create and manage forms.
- *
- * @see {@link useForm}
- */
-declare class FormModel<T extends TObject> {
-  readonly id: string;
-  readonly options: FormCtrlOptions<T>;
-  protected readonly log: Logger;
-  protected readonly alepha: Alepha;
-  protected readonly values: Record<string, any>;
-  protected submitInProgress: boolean;
-  input: SchemaToInput<T>;
-  get submitting(): boolean;
-  constructor(id: string, options: FormCtrlOptions<T>);
-  get element(): HTMLFormElement;
-  get currentValues(): Record<string, any>;
-  get props(): {
-    id: string;
-    noValidate: boolean;
-    onSubmit: (ev?: FormEventLike) => void;
-    onReset: (event: FormEventLike) => Promise<void>;
-  };
-  readonly reset: (event: FormEventLike) => Promise<void>;
-  readonly submit: () => Promise<void>;
-  /**
-   * Restructures flat keys like "address.city" into nested objects like { address: { city: ... } }
-   * Values are already typed from onChange, so no conversion is needed.
-   */
-  protected restructureValues(store: Record<string, any>): Record<string, any>;
-  /**
-   * Helper to restructure a flat key like "address.city" into nested object structure.
-   * The value is already typed, so we just assign it to the nested path.
-   */
-  protected restructureNestedValue(values: Record<string, any>, key: string, value: any): void;
-  protected createProxyFromSchema<T extends TObject>(options: FormCtrlOptions<T>, schema: TSchema, context: {
-    parent: string;
-    store: Record<string, any>;
-  }): SchemaToInput<T>;
-  protected createInputFromSchema<T extends TObject>(name: keyof Static<T> & string, options: FormCtrlOptions<T>, schema: TObject, required: boolean, context: {
-    parent: string;
-    store: Record<string, any>;
-  }): InputField;
-  /**
-   * Convert an input value to the correct type based on the schema.
-   * Handles raw DOM values (strings, booleans from checkboxes, Files, etc.)
-   */
-  protected getValueFromInput(input: any, schema: TSchema): any;
-  protected valueToInputEntry(value: any): string | number | boolean;
-}
-type SchemaToInput<T extends TObject> = { [K in keyof T["properties"]]: T["properties"][K] extends TObject ? SchemaToInput<T["properties"][K]> : InputField };
-interface FormEventLike {
-  preventDefault?: () => void;
-  stopPropagation?: () => void;
-}
-interface InputField {
-  path: string;
-  required: boolean;
-  props: InputHTMLAttributesLike;
-  schema: TSchema;
-  set: (value: any) => void;
-  form: FormModel<any>;
-}
-type InputHTMLAttributesLike = Pick<InputHTMLAttributes<unknown>, "id" | "name" | "type" | "value" | "defaultValue" | "required" | "maxLength" | "minLength" | "aria-label" | "autoComplete"> & {
-  value?: any;
-  defaultValue?: any;
-  onChange?: (event: any) => void;
-};
-type FormCtrlOptions<T extends TObject> = {
-  /**
-   * The schema defining the structure and validation rules for the form.
-   * This should be a TypeBox schema object.
-   */
-  schema: T;
-  /**
-   * Callback function to handle form submission.
-   * This function will receive the parsed and validated form values.
-   */
-  handler: (values: Static<T>, args: {
-    form: HTMLFormElement;
-  }) => unknown;
-  /**
-   * Optional initial values for the form fields.
-   * This can be used to pre-populate the form with existing data.
-   */
-  initialValues?: Partial<Static<T>>;
-  /**
-   * Optional function to create custom field attributes.
-   * This can be used to add custom validation, styles, or other attributes.
-   */
-  onCreateField?: (name: keyof Static<T> & string, schema: TSchema) => InputHTMLAttributes<unknown>;
-  /**
-   * If defined, this will generate a unique ID for each field, prefixed with this string.
-   *
-   * > "username" with id="form-123" will become "form-123-username".
-   *
-   * If omitted, IDs will not be generated.
-   */
-  id?: string;
-  onError?: (error: Error, args: {
-    form: HTMLFormElement;
-  }) => void;
-  onChange?: (key: string, value: any, store: Record<string, any>) => void;
-  onReset?: () => void;
-};
-//#endregion
-//#region src/form/components/FormState.d.ts
-declare const FormState: <T extends TObject>(props: {
-  form: FormModel<T>;
-  children: (state: {
-    loading: boolean;
-    dirty: boolean;
-  }) => ReactNode;
-}) => ReactNode;
-//#endregion
-//#region src/form/hooks/useForm.d.ts
-/**
- * Custom hook to create a form with validation and field management.
- * This hook uses TypeBox schemas to define the structure and validation rules for the form.
- * It provides a way to handle form submission, field creation, and value management.
- *
- * @example
- * ```tsx
- * import { t } from "alepha";
- *
- * const form = useForm({
- *   schema: t.object({
- *     username: t.text(),
- *     password: t.text(),
- *   }),
- *   handler: (values) => {
- *     console.log("Form submitted with values:", values);
- *   },
- * });
- *
- * return (
- *   <form {...form.props}>
- *     <input {...form.input.username.props} />
- *     <input {...form.input.password.props} />
- *     <button type="submit">Submit</button>
- *   </form>
- * );
- * ```
- */
-declare const useForm: <T extends TObject>(options: FormCtrlOptions<T>, deps?: any[]) => FormModel<T>;
-//#endregion
-//#region src/form/hooks/useFormState.d.ts
-interface UseFormStateReturn {
-  loading: boolean;
-  dirty: boolean;
-  values?: Record<string, any>;
-  error?: Error;
-}
-declare const useFormState: <T extends TObject, Keys extends keyof UseFormStateReturn>(target: FormModel<T> | {
-  form: FormModel<T>;
-  path: string;
-}, _events?: Keys[]) => Pick<UseFormStateReturn, Keys>;
-//#endregion
-//#region src/form/errors/FormValidationError.d.ts
-declare class FormValidationError extends TypeBoxError {
-  readonly name = "ValidationError";
-  constructor(options: {
-    message: string;
-    path: string;
-  });
-}
-//#endregion
-//#region src/form/index.d.ts
-declare module "alepha" {
-  interface Hooks {
-    "form:change": {
-      id: string;
-      path: string;
-      value: any;
-    };
-    "form:reset": {
-      id: string;
-      values: Record<string, any>;
-    };
-    "form:submit:begin": {
-      id: string;
-    };
-    "form:submit:success": {
-      id: string;
-      values: Record<string, any>;
-    };
-    "form:submit:error": {
-      id: string;
-      error: Error;
-    };
-    "form:submit:end": {
-      id: string;
-    };
-  }
-}
-/**
- * React hooks for managing forms in Alepha applications.
- *
- * This module provides a set of hooks to simplify form handling, validation, and submission in React applications built with Alepha.
- *
- * It includes:
- * - `useForm`: A hook for managing form state, validation, and submission.
- *
- * @see {@link useForm}
- * @module alepha.react.form
- */
-declare const AlephaReactForm: alepha8.Service<alepha8.Module>;
-//#endregion
-export { AlephaReactForm, FormCtrlOptions, FormEventLike, FormModel, FormState, FormValidationError, InputField, InputHTMLAttributesLike, SchemaToInput, UseFormStateReturn, useForm, useFormState };
-//# sourceMappingURL=index.d.cts.map

package/dist/head/chunk-DhGyd7sr.js

@@ -1,28 +0,0 @@
-//#region rolldown:runtime
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") {
-		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-			key = keys[i];
-			if (!__hasOwnProp.call(to, key) && key !== except) {
-				__defProp(to, key, {
-					get: ((k) => from[k]).bind(null, key),
-					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-				});
-			}
-		}
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-
-//#endregion
-export {  };