alepha 0.11.9 → 0.11.10

package/react/form.d.ts

@@ -1,211 +0,0 @@
-import * as _alepha_core0 from "alepha";
-import { Alepha, Static, TObject, TSchema } from "alepha";
-import { InputHTMLAttributes, ReactNode } from "react";
-import * as _alepha_logger0 from "alepha/logger";
-
-//#region src/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: _alepha_logger0.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/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/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/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/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: _alepha_core0.Service<_alepha_core0.Module>;
-//#endregion
-export { AlephaReactForm, FormCtrlOptions, FormEventLike, FormModel, FormState, InputField, InputHTMLAttributesLike, SchemaToInput, UseFormStateReturn, useForm, useFormState };
-//# sourceMappingURL=index.d.ts.map

package/react/form.js

@@ -1 +0,0 @@
-export * from '@alepha/react-form'

package/react/head.cjs

@@ -1,8 +0,0 @@
-'use strict';
-var m = require('@alepha/react-head');
-Object.keys(m).forEach(function (k) {
-	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-		enumerable: true,
-		get: function () { return m[k]; }
-	});
-});

package/react/head.d.ts

@@ -1,120 +0,0 @@
-import * as _alepha_core1 from "alepha";
-import { Descriptor, KIND } from "alepha";
-import { PageConfigSchema, PageRoute, ReactRouterState, TPropsDefault, TPropsParentDefault } from "alepha/react";
-import { ServerTimingProvider } from "alepha/server";
-
-//#region src/interfaces/Head.d.ts
-interface Head extends SimpleHead {
-  description?: string;
-  keywords?: string[];
-  author?: string;
-  robots?: string;
-  themeColor?: string;
-  viewport?: string | {
-    width?: string;
-    height?: string;
-    initialScale?: string;
-    maximumScale?: string;
-    userScalable?: "no" | "yes" | "0" | "1";
-    interactiveWidget?: "resizes-visual" | "resizes-content" | "overlays-content";
-  };
-  og?: {
-    title?: string;
-    description?: string;
-    image?: string;
-    url?: string;
-    type?: string;
-  };
-  twitter?: {
-    card?: string;
-    title?: string;
-    description?: string;
-    image?: string;
-    site?: string;
-  };
-}
-interface SimpleHead {
-  title?: string;
-  titleSeparator?: string;
-  htmlAttributes?: Record<string, string>;
-  bodyAttributes?: Record<string, string>;
-  meta?: Array<{
-    name: string;
-    content: string;
-  }>;
-}
-//#endregion
-//#region src/providers/HeadProvider.d.ts
-declare class HeadProvider {
-  global?: Head | (() => Head);
-  protected getGlobalHead(): Head | undefined;
-  fillHead(state: ReactRouterState): void;
-  protected fillHeadByPage(page: PageRoute, state: ReactRouterState, props: Record<string, any>): void;
-}
-//#endregion
-//#region src/descriptors/$head.d.ts
-/**
- * Set global `<head>` options for the application.
- */
-declare const $head: {
-  (options: HeadDescriptorOptions): HeadDescriptor;
-  [KIND]: typeof HeadDescriptor;
-};
-type HeadDescriptorOptions = Head | (() => Head);
-declare class HeadDescriptor extends Descriptor<HeadDescriptorOptions> {
-  protected readonly provider: HeadProvider;
-  protected onInit(): void;
-}
-//#endregion
-//#region src/hooks/useHead.d.ts
-/**
- * ```tsx
- * const App = () => {
- *   const [head, setHead] = useHead({
- *     // will set the document title on the first render
- *     title: "My App",
- *   });
- *
- *   return (
- *     // This will update the document title when the button is clicked
- *     <button onClick={() => setHead({ title: "Change Title" })}>
- *       Change Title {head.title}
- *     </button>
- *   );
- * }
- * ```
- */
-declare const useHead: (options?: UseHeadOptions) => UseHeadReturn;
-type UseHeadOptions = Head | ((previous?: Head) => Head);
-type UseHeadReturn = [Head, (head?: Head | ((previous?: Head) => Head)) => void];
-//#endregion
-//#region src/providers/ServerHeadProvider.d.ts
-declare class ServerHeadProvider {
-  protected readonly headProvider: HeadProvider;
-  protected readonly serverTimingProvider: ServerTimingProvider;
-  protected readonly onServerRenderEnd: _alepha_core1.HookDescriptor<"react:server:render:end">;
-  renderHead(template: string, head: SimpleHead): string;
-  protected mergeAttributes(existing: string, attrs: Record<string, string>): string;
-  protected parseAttributes(attrStr: string): Record<string, string>;
-  protected escapeHtml(str: string): string;
-}
-//#endregion
-//#region src/index.d.ts
-declare module "alepha/react" {
-  interface PageDescriptorOptions<TConfig extends PageConfigSchema = PageConfigSchema, TProps extends object = TPropsDefault, TPropsParent extends object = TPropsParentDefault> {
-    head?: Head | ((props: TProps, previous?: Head) => Head);
-  }
-  interface ReactRouterState {
-    head: Head;
-  }
-}
-/**
- * Fill `<head>` server & client side.
- *
- * @see {@link ServerHeadProvider}
- * @module alepha.react.head
- */
-declare const AlephaReactHead: _alepha_core1.Service<_alepha_core1.Module>;
-//#endregion
-export { $head, AlephaReactHead, Head, HeadDescriptor, HeadDescriptorOptions, ServerHeadProvider, SimpleHead, UseHeadOptions, UseHeadReturn, useHead };
-//# sourceMappingURL=index.d.ts.map

package/react/head.js

@@ -1 +0,0 @@
-export * from '@alepha/react-head'

package/react/i18n.cjs

@@ -1,8 +0,0 @@
-'use strict';
-var m = require('@alepha/react-i18n');
-Object.keys(m).forEach(function (k) {
-	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-		enumerable: true,
-		get: function () { return m[k]; }
-	});
-});

package/react/i18n.d.ts

@@ -1,168 +0,0 @@
-import * as _alepha_core1 from "alepha";
-import { Alepha, Descriptor, KIND, TypeBoxError } from "alepha";
-import { DateTime, DateTimeProvider } from "alepha/datetime";
-import * as _alepha_logger0 from "alepha/logger";
-import * as _alepha_server_cookies0 from "alepha/server/cookies";
-import * as typebox0 from "typebox";
-
-//#region src/components/Localize.d.ts
-interface LocalizeProps {
-  value: string | number | Date | DateTime | TypeBoxError;
-  /**
-   * Options for number formatting (when value is a number)
-   * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/NumberFormat
-   */
-  number?: Intl.NumberFormatOptions;
-  /**
-   * Options for date formatting (when value is a Date or DateTime)
-   * Can be:
-   * - A dayjs format string (e.g., "LLL", "YYYY-MM-DD", "dddd, MMMM D YYYY")
-   * - "fromNow" for relative time (e.g., "2 hours ago")
-   * - Intl.DateTimeFormatOptions for native formatting
-   * @see https://day.js.org/docs/en/display/format
-   * @see https://day.js.org/docs/en/display/from-now
-   */
-  date?: string | "fromNow" | Intl.DateTimeFormatOptions;
-  /**
-   * Timezone to display dates in (when value is a Date or DateTime)
-   * Uses IANA timezone names (e.g., "America/New_York", "Europe/Paris", "Asia/Tokyo")
-   * @see https://day.js.org/docs/en/timezone/timezone
-   */
-  timezone?: string;
-}
-declare const Localize: (props: LocalizeProps) => string;
-//#endregion
-//#region src/hooks/useI18n.d.ts
-/**
- * Hook to access the i18n service.
- */
-declare const useI18n: <S extends object, K$1 extends keyof ServiceDictionary<S>>() => I18nProvider<S, K$1>;
-type ServiceDictionary<T extends object> = { [K in keyof T]: T[K] extends DictionaryDescriptor<infer U> ? U : never };
-//#endregion
-//#region src/providers/I18nProvider.d.ts
-declare class I18nProvider<S extends object, K$1 extends keyof ServiceDictionary<S>> {
-  protected logger: _alepha_logger0.Logger;
-  protected alepha: Alepha;
-  protected dateTimeProvider: DateTimeProvider;
-  protected cookie: _alepha_server_cookies0.AbstractCookieDescriptor<typebox0.TString>;
-  readonly registry: Array<{
-    name: string;
-    lang: string;
-    loader: () => Promise<Record<string, string>>;
-    translations: Record<string, string>;
-  }>;
-  options: {
-    fallbackLang: string;
-  };
-  dateFormat: {
-    format: (value: Date) => string;
-  };
-  numberFormat: {
-    format: (value: number) => string;
-  };
-  get languages(): string[];
-  constructor();
-  protected readonly onRender: _alepha_core1.HookDescriptor<"server:onRequest">;
-  protected readonly onStart: _alepha_core1.HookDescriptor<"start">;
-  protected refreshLocale(): void;
-  setLang: (lang: string) => Promise<void>;
-  protected readonly mutate: _alepha_core1.HookDescriptor<"state:mutate">;
-  get lang(): string;
-  translate: (key: string, args?: string[]) => string;
-  readonly l: (value: I18nLocalizeType, options?: I18nLocalizeOptions) => string;
-  readonly tr: (key: keyof ServiceDictionary<S>[K$1], options?: {
-    args?: string[];
-    default?: string;
-  }) => string;
-  protected render(item: string, args: string[]): string;
-}
-type I18nLocalizeType = string | number | Date | DateTime | TypeBoxError;
-interface I18nLocalizeOptions {
-  /**
-   * Options for number formatting (when value is a number)
-   * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/NumberFormat
-   */
-  number?: Intl.NumberFormatOptions;
-  /**
-   * Options for date formatting (when value is a Date or DateTime)
-   * Can be:
-   * - A dayjs format string (e.g., "LLL", "YYYY-MM-DD", "dddd, MMMM D YYYY")
-   * - "fromNow" for relative time (e.g., "2 hours ago")
-   * - Intl.DateTimeFormatOptions for native formatting
-   * @see https://day.js.org/docs/en/display/format
-   * @see https://day.js.org/docs/en/display/from-now
-   */
-  date?: string | "fromNow" | Intl.DateTimeFormatOptions;
-  /**
-   * Timezone to display dates in (when value is a Date or DateTime)
-   * Uses IANA timezone names (e.g., "America/New_York", "Europe/Paris", "Asia/Tokyo")
-   * @see https://day.js.org/docs/en/timezone/timezone
-   */
-  timezone?: string;
-}
-//#endregion
-//#region src/descriptors/$dictionary.d.ts
-/**
- * Register a dictionary entry for translations.
- *
- * It allows you to define a set of translations for a specific language.
- * Entry can be lazy-loaded, which is useful for large dictionaries or when translations are not needed immediately.
- *
- * @example
- * ```ts
- * import { $dictionary } from "alepha/react-i18n";
- *
- * const Example = () => {
- *   const { tr } = useI18n<App, "en">();
- *   return <div>{tr("hello")}</div>; //
- * }
- *
- * class App {
- *
- *   en = $dictionary({
- *     // { default: { hello: "Hey" } }
- *     lazy: () => import("./translations/en.ts"),
- *   });
- *
- *   home = $page({
- *     path: "/",
- *     component: Example,
- *   })
- * }
- *
- * run(App);
- * ```
- */
-declare const $dictionary: {
-  <T extends Record<string, string>>(options: DictionaryDescriptorOptions<T>): DictionaryDescriptor<T>;
-  [KIND]: typeof DictionaryDescriptor;
-};
-interface DictionaryDescriptorOptions<T extends Record<string, string>> {
-  lang?: string;
-  name?: string;
-  lazy: () => Promise<{
-    default: T;
-  }>;
-}
-declare class DictionaryDescriptor<T extends Record<string, string>> extends Descriptor<DictionaryDescriptorOptions<T>> {
-  protected provider: I18nProvider<object, never>;
-  protected onInit(): void;
-}
-//#endregion
-//#region src/index.d.ts
-declare module "alepha" {
-  interface State {
-    "alepha.react.i18n.lang"?: string;
-  }
-}
-/**
- * Add i18n support to your Alepha React application. SSR and CSR compatible.
- *
- * It supports lazy loading of translations and provides a context to access the current language.
- *
- * @module alepha.react.i18n
- */
-declare const AlephaReactI18n: _alepha_core1.Service<_alepha_core1.Module>;
-//#endregion
-export { $dictionary, AlephaReactI18n, DictionaryDescriptor, DictionaryDescriptorOptions, I18nLocalizeOptions, I18nLocalizeType, I18nProvider, Localize, type LocalizeProps, ServiceDictionary, useI18n };
-//# sourceMappingURL=index.d.ts.map

package/react/i18n.js

@@ -1 +0,0 @@
-export * from '@alepha/react-i18n'

package/react.cjs

@@ -1,8 +0,0 @@
-'use strict';
-var m = require('@alepha/react');
-Object.keys(m).forEach(function (k) {
-	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-		enumerable: true,
-		get: function () { return m[k]; }
-	});
-});