react-luna-form 0.0.87 → 0.0.88

package/dist/types/luna-core/util/is-input.d.ts

@@ -1,4 +1,4 @@
-import type { Chips, Column, Field, Input, List, Nullable, Select, Time } from '../type';
+import type { Chips, Column, Date as DateField, Field, Input, List, Nullable, Select, Time } from '../type';
 export declare const isSelectActive: (field: Field) => boolean;
 export declare const isSelectDay: (field: Field) => boolean;
 export declare const isSelectMonth: (field: Field) => boolean;
@@ -6,8 +6,9 @@ export declare const isSelectYear: (field: Field) => boolean;
 export declare const isSelectTimezone: (field: Field) => boolean;
 export declare const isChipsDays: (field: Field) => boolean;
 export declare const isChipsMonths: (field: Field) => boolean;
-export declare const isDate: (field: Field) => field is Field;
+export declare const isDate: (field: Field) => field is DateField;
 export declare const isTime: (field: Field) => field is Time;
+export declare function isDateRange(field: Field): boolean;
 export declare const isCheckbox: (field: Field) => field is Input;
 export declare const isChips: (field: Field) => field is Chips;
 export declare const isRadio: (field: Field) => field is Select;

package/dist/types/luna-core/util/pattern.d.ts

@@ -0,0 +1,28 @@
+/**
+ * What an authored pattern can do to the thread that runs it.
+ *
+ * A pattern that can split the same text between its repetitions in more than
+ * one way backtracks exponentially on a value that almost matches: `^(a+)+$`
+ * holds the thread for seconds on thirty characters, a tab's or a server's.
+ * Only the ambiguity is dangerous. `^[a-z]+(-[a-z]+)*$` repeats a group with a
+ * quantifier inside it as well, and runs in linear time, because every
+ * repetition opens with a `-` that the one before cannot close with.
+ *
+ * So the question asked of each repeated group is not whether it nests a
+ * quantifier but whether its repetitions can overlap: whether the group can
+ * open with a character it can also close with, and then either holds an
+ * unbounded quantifier or offers alternatives that open alike. That is
+ * `(a+)+`, `(\w+\s?)+` and `(a|a)+`, and not `(-[a-z]+)*`, `(,\d+)*` or
+ * `(ab+c)+`.
+ *
+ * It is a reading of the source, not a proof. Characters are reasoned about as
+ * ASCII, with everything beyond it counted as one more symbol, and what the
+ * reader cannot tell apart it reads as any character: it would rather refuse
+ * a safe pattern than run a catastrophic one. Quadratic patterns are not its
+ * concern; they need very long values to hurt.
+ *
+ * Every term works out what it can open and close with as it is read, once,
+ * so reading a pattern costs time in proportion to its length, however it
+ * nests.
+ */
+export declare function backtracksCatastrophically(source: string, flags?: string): boolean;

package/dist/types/luna-core/util/prepare.d.ts

@@ -1,4 +1,5 @@
 import type { Definition, Filterable, Nullable } from '../type';
-export declare function prepare<T extends Filterable>(base?: readonly T[], definition?: Definition): T[];
-export declare function resolveRefs(base: unknown, definition?: Definition, cache?: Map<object, unknown>, visited?: WeakSet<object>): unknown;
+export declare function prepare<T extends Filterable>(base?: readonly T[], definition?: Definition, context?: Record<string, unknown>): T[];
+export declare function resolveRefs(base: unknown, definition?: Definition, context?: Record<string, unknown>): unknown;
+export declare function refOf(value: unknown): string | undefined;
 export declare function entries<T>(values?: Nullable<Record<string, T>>): [key: string, value: T][];

package/dist/types/luna-core/util/schema.d.ts

@@ -8,9 +8,10 @@ export declare function getText(input: Input, translations?: Record<string, stri
 export declare function getNumber(input: Input, translations?: Record<string, string>): z.ZodPreprocess<z.ZodOptional<z.ZodNullable<z.ZodType<number, unknown, z.core.$ZodTypeInternals<number, unknown>>>>, unknown> | z.ZodPreprocess<z.ZodPipe<z.ZodUnknown, z.ZodType<number, unknown, z.core.$ZodTypeInternals<number, unknown>>>, unknown>;
 export declare function getYearSchema(input: Input, translations?: Record<string, string>): z.ZodPreprocess<z.ZodOptional<z.ZodNullable<z.ZodType<number, unknown, z.core.$ZodTypeInternals<number, unknown>>>>, unknown> | z.ZodPreprocess<z.ZodPipe<z.ZodUnknown, z.ZodType<number, unknown, z.core.$ZodTypeInternals<number, unknown>>>, unknown>;
 export declare function getMonthSchema(input: Input, translations?: Record<string, string>): z.ZodPreprocess<z.ZodOptional<z.ZodNullable<z.ZodType<number, unknown, z.core.$ZodTypeInternals<number, unknown>>>>, unknown> | z.ZodPreprocess<z.ZodPipe<z.ZodUnknown, z.ZodType<number, unknown, z.core.$ZodTypeInternals<number, unknown>>>, unknown>;
+export declare function getDateSchema(field: Field, translations?: Record<string, string>): z.ZodPreprocess<z.ZodOptional<z.ZodNullable<z.ZodType<[string, string], unknown, z.core.$ZodTypeInternals<[string, string], unknown>>>>, unknown> | z.ZodPreprocess<z.ZodPipe<z.ZodUnknown, z.ZodType<[string, string], unknown, z.core.$ZodTypeInternals<[string, string], unknown>>>, unknown> | z.ZodPreprocess<z.ZodOptional<z.ZodNullable<z.ZodType<string, unknown, z.core.$ZodTypeInternals<string, unknown>>>>, unknown> | z.ZodPreprocess<z.ZodPipe<z.ZodUnknown, z.ZodType<string, unknown, z.core.$ZodTypeInternals<string, unknown>>>, unknown>;
 export declare function applyCustomValidation(schema: ZodSchema, fields?: Field[], translations?: Record<string, string>): ZodSchema;
 export declare function validateCustom(value: unknown, rules: CustomValidation | Array<CustomValidation>, getValue: (name: string) => unknown, translations?: Record<string, string>): string[];
-export declare function buildFormSchema(sections: Sections, translations?: Record<string, string>, definition?: Definition): z.ZodType;
+export declare function buildFormSchema(sections: Sections, translations?: Record<string, string>, definition?: Definition, context?: Record<string, unknown>): z.ZodType;
 export declare function collectIssues(error: z.ZodError): Array<{
     path: string;
     message: string;

package/dist/types/luna-core/util/string.d.ts

@@ -1,6 +1,13 @@
 export type InterpolateOptions = {
     locale?: string;
+    now?: string;
 };
+/**
+ * What text the form renders is formatted with: the form's language, its
+ * `lang`, and the instant the host gave in `context`. A label and a
+ * description format the same value the same way because they ask here.
+ */
+export declare function renderOptions(lang?: string, context?: Record<string, unknown>): InterpolateOptions;
 /**
  * Replaces placeholders in the format {key} with values from the provided object.
  * Supports nested objects using dot notation (e.g., {user.id}) and pipe filters

package/dist/types/luna-react/src/client/component/field/field-list-preview-item.d.ts

@@ -1,6 +1,7 @@
+import { type Localization } from '../../../../../luna-core/index';
 import type { List, Nullable, PreviewItem } from '../../../../../luna-core/index';
 import type { ReactNode } from 'react';
-export declare function FieldListPreviewItem({ canRemove, children, field, index, isMultiField, itemKey, label, lang, onRemove, previewBadge, previewLabel, previewTags, translations, value, }: {
+export declare function FieldListPreviewItem({ canRemove, children, field, index, isMultiField, itemKey, label, localization, onRemove, previewBadge, previewLabel, previewTags, value, }: {
     canRemove: boolean;
     children: ReactNode;
     field: List;
@@ -8,11 +9,10 @@ export declare function FieldListPreviewItem({ canRemove, children, field, index
     isMultiField: boolean;
     itemKey: string | number;
     label: string;
-    lang?: string;
+    localization?: Localization;
     onRemove: (index: number) => void;
     previewBadge?: PreviewItem;
     previewLabel?: PreviewItem;
     previewTags?: PreviewItem[];
-    translations?: Record<string, string>;
     value?: Nullable<Record<string, unknown> | unknown[]>;
 }): import("react").JSX.Element;

package/dist/types/luna-react/src/client/component/field/field-preview-item.d.ts

@@ -1,7 +1,9 @@
-import { type Option } from '../../../../../luna-core/index';
-export declare function FieldPreviewItem({ className, initialValue, name, options, separator, staticLabel, }: Readonly<{
+import { type DateFormat, type Option } from '../../../../../luna-core/index';
+export declare function FieldPreviewItem({ className, dateFormat, initialValue, lang, name, options, separator, staticLabel, }: Readonly<{
     className?: string;
+    dateFormat?: DateFormat;
     initialValue?: unknown;
+    lang?: string;
     name?: string;
     options?: Array<Option | string>;
     separator?: boolean;

package/dist/types/luna-react/src/client/component/field/field-preview-value.d.ts

@@ -1,5 +1,8 @@
-export declare function FieldPreviewValue({ children, initialValue, name, }: Readonly<{
+import { type DateFormat } from '../../../../../luna-core/index';
+export declare function FieldPreviewValue({ children, dateFormat, initialValue, lang, name, }: Readonly<{
     children: (value: string) => React.ReactNode;
+    dateFormat?: DateFormat;
     initialValue?: unknown;
+    lang?: string;
     name: string;
 }>): import("react").JSX.Element;

package/dist/types/luna-react/src/client/component/field/field-preview.d.ts

@@ -1,12 +1,12 @@
+import { type Localization } from '../../../../../luna-core/index';
 import type { Fields, PreviewItem } from '../../../../../luna-core/index';
 type PreviewProps = Readonly<{
     className?: string;
     fields?: Fields;
     label?: string;
-    lang?: string;
+    localization?: Localization;
     name: string;
     previews: PreviewItem | PreviewItem[];
-    translations?: Record<string, string>;
     value?: Record<string, unknown> | unknown[] | null;
 }>;
 export declare function FieldPreview(props: PreviewProps): import("react").JSX.Element;

package/dist/types/luna-react/src/client/component/formatted-description.d.ts

@@ -1,9 +1,9 @@
-import { type Description as DescriptionType } from '../../../../luna-core/index';
+import { type Description as DescriptionType, type Localization } from '../../../../luna-core/index';
 import type { Config } from '../../type';
 export declare function FormattedDescription(props: Readonly<{
     config?: Config;
     context?: Record<string, unknown>;
+    localization?: Localization;
     text?: DescriptionType;
-    translations?: Record<string, string>;
     value?: unknown;
 }>): import("react").JSX.Element | null;

package/dist/types/luna-react/src/client/component/guard/list-guard.d.ts

@@ -1,2 +1,2 @@
 import type { ListProps } from '../../../component/field/field-list';
-export declare function ListGuard({ children, field, lang, onValueChange, translations, value, }: ListProps): import("react").JSX.Element;
+export declare function ListGuard({ children, field, onValueChange, localization, value, }: ListProps): import("react").JSX.Element;

package/dist/types/luna-react/src/client/component/input-strategies.d.ts

@@ -1,5 +1,14 @@
 import type { Config } from '../../type';
 import type { DataSource, Field, Nullable, Value } from '../../../../luna-core/index';
+/**
+ * What a held value is when the change events run at mount, which has to be
+ * what a change hands them later: a form reopened on saved data reveals what it
+ * revealed when it was filled in. An array travels as one -- a `chips` field's
+ * selections, the two days of a range -- since `String()` on it joins them into
+ * "a,b", which answers to no option, no `when` and no day. Anything else is the
+ * text it would have been typed as.
+ */
+export declare function toChangeValue(value: unknown): Value;
 /**
  * What the input pipeline reads off a change, and all it reads: the new value.
  *
@@ -38,5 +47,4 @@ export type InputStrategies = Readonly<{
     }>) => void;
     buildInitialSelected: (defaultValue: unknown, data: Nullable<unknown[]>, entity: string | undefined) => unknown;
     isInitialReady: (field: Field, defaultValue: unknown, data: Nullable<unknown[]>) => boolean;
-    useExtraProps?: (field: Field) => Record<string, unknown> | undefined;
 }>;

package/dist/types/luna-react/src/client/component/slot/slot.d.ts

@@ -4,12 +4,11 @@ export declare const Slot: (props: Readonly<{
     context?: Record<string, unknown>;
     disabled?: boolean;
     fields?: import('../../../../../luna-core/index').Fields;
-    lang?: string;
     onValueChange?: (input: {
         name: string;
         value: unknown;
     }) => void;
     style?: import('../../../../../luna-core/index').Style;
-    translations?: Record<string, string>;
+    localization?: import('../../../../../luna-core/index').Localization;
     value?: import('../../../../../luna-core/index').Nullable<Record<string, unknown>>;
 }>) => import("react").JSX.Element;

package/dist/types/luna-react/src/client/hook/use-input-core.d.ts

@@ -1,4 +1,4 @@
-import { type AriaAttributes, type CommonProps, type DataAttributes, type DataSource, type Field, type Schema, type Value } from '../../../../luna-core/index';
+import { type AriaAttributes, type CommonProps, type DataAttributes, type DataSource, type Field, type Schema, type Value, type Localization } from '../../../../luna-core/index';
 import type { Config, InputChange } from '../../type';
 export type InputCoreProps = Readonly<{
     ariaAttributes?: AriaAttributes;
@@ -9,13 +9,13 @@ export type InputCoreProps = Readonly<{
     field: Field;
     getField: (name: string) => Field | undefined;
     horizontal?: boolean;
+    localization?: Localization;
     onRegister: (name: string, schema: Schema, field: Field) => void;
     onUnmount: (name: string, options?: {
         keepValue?: boolean;
     }) => void;
     onValueChange?: (input: InputChange) => void;
     readOnly?: boolean;
-    translations?: Record<string, string>;
 }>;
 export declare function useInputCore(props: InputCoreProps, deps: Readonly<{
     setSource: (target: string, source?: DataSource) => void;

package/dist/types/luna-react/src/component/column.d.ts

@@ -1,5 +1,5 @@
 import { type DescriptionTextProps } from './description';
-import { type Column } from '../../../luna-core/index';
+import { type Column, type Localization } from '../../../luna-core/index';
 import type { Config } from '../type';
 export declare function Column(props: Readonly<{
     children?: React.ReactNode;
@@ -7,5 +7,5 @@ export declare function Column(props: Readonly<{
     config?: Config;
     context?: Record<string, unknown>;
     description?: React.ComponentType<DescriptionTextProps>;
-    translations?: Record<string, string>;
+    localization?: Localization;
 }>): import("react").JSX.Element;

package/dist/types/luna-react/src/component/description.d.ts

@@ -1,4 +1,4 @@
-import { type Description as DescriptionType } from '../../../luna-core/index';
+import { type Description as DescriptionType, type Localization } from '../../../luna-core/index';
 import type { Config } from '../type';
 export declare function Description(props: Readonly<{
     children: string | React.ReactNode;
@@ -7,7 +7,7 @@ export declare function Description(props: Readonly<{
 export type DescriptionTextProps = Readonly<{
     config?: Config;
     context?: Record<string, unknown>;
+    localization?: Localization;
     text?: DescriptionType;
-    translations?: Record<string, string>;
 }>;
 export declare function DescriptionText(props: DescriptionTextProps): import("react").JSX.Element | null;

package/dist/types/luna-react/src/component/field/field-list.d.ts

@@ -1,13 +1,12 @@
-import { type List, type Nullable } from '../../../../luna-core/index';
+import { type List, type Nullable, type Localization } from '../../../../luna-core/index';
 export type ListProps = Readonly<{
     children: (index: number) => React.ReactNode;
     field: List;
-    lang?: string;
     onValueChange?: (input: {
         name: string;
         value: unknown;
     }) => void;
-    translations?: Record<string, string>;
+    localization?: Localization;
     value?: Nullable<Record<string, unknown>>;
 }>;
 export declare function FieldList(props: ListProps): import("react").JSX.Element[];

package/dist/types/luna-react/src/component/field/field.d.ts

@@ -1,12 +1,12 @@
-import { type Field, type Style } from '../../../../luna-core/index';
+import { type Field, type Style, type Localization } from '../../../../luna-core/index';
 import type { Children } from '../../type';
 export type FieldProps = Readonly<{
     children: Children;
     disabled?: boolean;
     errors?: string[];
     field: Field;
-    lang?: string;
+    now?: string;
     style?: Style;
-    translations?: Record<string, string>;
+    localization?: Localization;
 }>;
 export declare function Field(props: FieldProps): import("react").JSX.Element;

package/dist/types/luna-react/src/component/field-description.d.ts

@@ -1,9 +1,9 @@
 import type { Config } from '../type';
-import type { Field } from '../../../luna-core/index';
+import type { Field, Localization } from '../../../luna-core/index';
 export type DescriptionProps = Readonly<{
     config?: Config;
     context?: Record<string, unknown>;
     field: Field;
-    translations?: Record<string, string>;
+    localization?: Localization;
 }>;
 export declare function StaticDescription(props: DescriptionProps): import("react").JSX.Element;

package/dist/types/luna-react/src/component/form.d.ts

@@ -15,6 +15,7 @@ export declare function Form(props: Readonly<{
     action?: (formData: FormData) => void;
     children: Slot;
     config: Config;
+    context?: Record<string, unknown>;
     control?: Control;
     definition?: Definition;
     fieldSet?: React.ComponentType<React.ComponentProps<typeof StaticFieldSet>>;

package/dist/types/luna-react/src/component/input/input-base.d.ts

@@ -1,4 +1,4 @@
-import { type Field } from '../../../../luna-core/index';
+import { type Field, type Localization } from '../../../../luna-core/index';
 import type { Children } from '../../type';
 export declare function InputBase(props: Readonly<{
     children: Children;
@@ -6,7 +6,7 @@ export declare function InputBase(props: Readonly<{
     errors?: string[];
     field: Field;
     horizontal?: boolean;
-    lang?: string;
+    localization?: Localization;
+    now?: string;
     readOnly?: boolean;
-    translations?: Record<string, string>;
 }>): import("react").ReactNode;

package/dist/types/luna-react/src/component/input-group.d.ts

@@ -1,6 +1,6 @@
 import { type DescriptionProps } from './field-description';
 import type { Config } from '../type';
-import type { Field } from '../../../luna-core/index';
+import type { Field, Localization } from '../../../luna-core/index';
 export declare function InputGroup(props: Readonly<{
     children: React.ReactNode;
     config?: Config;
@@ -8,5 +8,5 @@ export declare function InputGroup(props: Readonly<{
     description?: React.ComponentType<DescriptionProps>;
     field: Field;
     horizontal?: boolean;
-    translations?: Record<string, string>;
+    localization?: Localization;
 }>): import("react").JSX.Element;

package/dist/types/luna-react/src/component/input-label.d.ts

@@ -1,5 +1,5 @@
 import { type DescriptionProps } from './field-description';
-import { type Field } from '../../../luna-core/index';
+import { type Field, type Localization } from '../../../luna-core/index';
 import type { Config } from '../type';
 export declare function InputLabel(props: Readonly<{
     config?: Config;
@@ -7,5 +7,5 @@ export declare function InputLabel(props: Readonly<{
     description?: React.ComponentType<DescriptionProps>;
     field: Field;
     horizontal?: boolean;
-    translations?: Record<string, string>;
+    localization?: Localization;
 }>): import("react").JSX.Element;

package/dist/types/luna-react/src/component/slot/list-slot.d.ts

@@ -1,2 +1,2 @@
 import type { ListProps } from '../field/field-list';
-export declare function ListSlot({ children, field, lang, translations, value, }: ListProps): import("react").JSX.Element;
+export declare function ListSlot({ children, field, localization, value }: ListProps): import("react").JSX.Element;

package/dist/types/luna-react/src/component/slot/slot-base.d.ts

@@ -1,4 +1,4 @@
-import { type Fields, type Nullable, type Style } from '../../../../luna-core/index';
+import { type Fields, type Nullable, type Style, type Localization } from '../../../../luna-core/index';
 import type { DescriptionTextProps } from '../description';
 import type { Children, Config } from '../../type';
 import type { FieldProps } from '../field/field';
@@ -15,12 +15,11 @@ export declare function SlotBase(props: Readonly<{
     context?: Record<string, unknown>;
     disabled?: boolean;
     fields?: Fields;
-    lang?: string;
     onValueChange?: (input: {
         name: string;
         value: unknown;
     }) => void;
     style?: Style;
-    translations?: Record<string, string>;
+    localization?: Localization;
     value?: Nullable<Record<string, unknown>>;
 }>): import("react").JSX.Element[];

package/dist/types/luna-react/src/component/slot/slot-create.d.ts

@@ -1,5 +1,5 @@
 import type { Children, Config } from '../../type';
-import type { Fields, Nullable, Style } from '../../../../luna-core/index';
+import type { Fields, Localization, Nullable, Style } from '../../../../luna-core/index';
 import type { SlotComponents } from './slot-base';
 export declare function createSlot(components: SlotComponents): (props: Readonly<{
     children: Children;
@@ -7,12 +7,11 @@ export declare function createSlot(components: SlotComponents): (props: Readonly
     context?: Record<string, unknown>;
     disabled?: boolean;
     fields?: Fields;
-    lang?: string;
     onValueChange?: (input: {
         name: string;
         value: unknown;
     }) => void;
     style?: Style;
-    translations?: Record<string, string>;
+    localization?: Localization;
     value?: Nullable<Record<string, unknown>>;
 }>) => import("react").JSX.Element;

package/dist/types/luna-react/src/component/slot/slot-list.d.ts

@@ -1,4 +1,4 @@
-import { type List, type Nullable, type Style } from '../../../../luna-core/index';
+import { type List, type Nullable, type Style, type Localization } from '../../../../luna-core/index';
 import { type SlotComponents } from './slot-base';
 import type { Children, Config } from '../../type';
 export declare function SlotList(props: Readonly<{
@@ -9,12 +9,11 @@ export declare function SlotList(props: Readonly<{
     disabled?: boolean;
     field: List;
     index: number;
-    lang?: string;
     onValueChange?: (input: {
         name: string;
         value: unknown;
     }) => void;
     style?: Style;
-    translations?: Record<string, string>;
+    localization?: Localization;
     value?: Nullable<Record<string, unknown>>;
 }>): import("react").JSX.Element;

package/dist/types/luna-react/src/component/slot/slot.d.ts

@@ -4,12 +4,11 @@ export declare const Slot: (props: Readonly<{
     context?: Record<string, unknown>;
     disabled?: boolean;
     fields?: import('../../../../luna-core/index').Fields;
-    lang?: string;
     onValueChange?: (input: {
         name: string;
         value: unknown;
     }) => void;
     style?: import('../../../../luna-core/index').Style;
-    translations?: Record<string, string>;
+    localization?: import('../../../../luna-core/index').Localization;
     value?: import('../../../../luna-core/index').Nullable<Record<string, unknown>>;
 }>) => import("react").JSX.Element;

package/dist/types/luna-react/src/config/index.d.ts

@@ -1,5 +1,6 @@
 import { type Environment, type Protocol } from '../../../luna-core/index';
 import type { AlertProps, Config, InputConfig } from '../type';
+export { readDateProps, type DateProps } from '../../../luna-core/index';
 export declare function defineConfig<T extends React.ElementType>(options: Readonly<{
     alert?: React.ComponentType<AlertProps>;
     env?: Environment;

package/dist/types/luna-react/src/server/component/input.d.ts

@@ -1,4 +1,4 @@
-import { type AriaAttributes, type CommonProps, type DataAttributes, type Field } from '../../../../luna-core/index';
+import { type AriaAttributes, type CommonProps, type DataAttributes, type Field, type Localization } from '../../../../luna-core/index';
 import type { Config } from '../../type';
 export declare function Input(props: Readonly<{
     ariaAttributes?: AriaAttributes;
@@ -8,6 +8,6 @@ export declare function Input(props: Readonly<{
     dataAttributes?: DataAttributes;
     field: Field;
     horizontal?: boolean;
-    translations?: Record<string, string>;
+    localization?: Localization;
     value?: Record<string, unknown>;
 }>): import("react").ReactNode;

package/dist/types/luna-react/src/server/component/slot.d.ts

@@ -4,12 +4,11 @@ export declare const Slot: (props: Readonly<{
     context?: Record<string, unknown>;
     disabled?: boolean;
     fields?: import('../../../../luna-core/index').Fields;
-    lang?: string;
     onValueChange?: (input: {
         name: string;
         value: unknown;
     }) => void;
     style?: import('../../../../luna-core/index').Style;
-    translations?: Record<string, string>;
+    localization?: import('../../../../luna-core/index').Localization;
     value?: import('../../../../luna-core/index').Nullable<Record<string, unknown>>;
 }>) => import("react").JSX.Element;

package/dist/types/luna-react/src/type.d.ts

@@ -1,4 +1,4 @@
-import type { AriaAttributes, BaseConfig, CommonProps, DataAttributes, Field, Fields, FormStateError } from '../../luna-core/index';
+import type { AriaAttributes, BaseConfig, CommonProps, DataAttributes, Field, Fields, FormStateError, Localization } from '../../luna-core/index';
 export type Slot = (props: {
     disabled?: boolean;
     fields?: Fields;
@@ -12,6 +12,7 @@ export type Children = (props: {
     dataAttributes?: DataAttributes;
     field: Field;
     horizontal?: boolean;
+    localization?: Localization;
     readOnly?: boolean;
 }) => React.ReactNode;
 export type InputConfig<T extends React.ElementType> = {

package/docs/events/change.md

@@ -189,7 +189,7 @@ The `state` action modifies the interactive state or visibility of other fields
 - `action` (string): Must be set to `"state"`.
 - `target` (string | array of strings): The field name, or an array of field names, that the state modifications should be applied to.
 - `state` (object): An object containing the new state to apply. Properties are independent of field names — the form may safely contain a field whose `name` is `"description"`, `"disabled"` or `"hidden"`; `target` identifies the field, the keys inside `state` configure it.
-  - `disabled` (boolean, optional): Whether the field should be disabled.
+  - `disabled` (boolean, optional): Whether the field should be disabled. While the condition holds it takes the place of the field's own `disabled`, in either direction: `false` enables a field declared `"disabled": true`. Once the condition stops holding, the field's own `disabled` applies again.
   - `hidden` (boolean, optional): Whether the field should be hidden from view. **Note:** When a field becomes hidden (`hidden: true`), its current value is automatically cleared from the form state to ensure no non-applicable data is submitted. See [What clearing a hidden target means](#what-clearing-a-hidden-target-means).
   - `description` (string | object, optional): A new description to render for the target field. Supports interpolation, format filters, and **Markdown** (specifically links). e.g. `"Check our [terms](https://example.com) for details."`.
 - `when` (string | array of strings | [Condition object](#the-condition-object), optional): A condition that specifies when this state should be applied.
@@ -409,6 +409,9 @@ Two details:
   `source`, the initial run is held until the data has loaded, so an action
   keyed on the selected entity sees the entity rather than a bare value. Text
   and date fields run as soon as the value is valid.
+- **A date range carries its pair.** A [range](../fields/input.md#a-range-of-days)
+  runs its events with `[from, to]`, at mount and on a click alike: `{value}` is
+  that pair.
 - **A `chips` field carries its array, not an entity.** No single option answers
   to a value that can hold several, so a `chips` change carries the array
   itself, at mount and on a click alike: `{value}` is that array, and there is