react-luna-form 0.0.86 → 0.0.88

package/dist/types/luna-react/src/client/lib/host-value-store.d.ts

@@ -2,6 +2,13 @@ import type { Nullable } from '../../../../luna-core/index';
 export declare const hostValueAtom: import("jotai").PrimitiveAtom<Nullable<Record<string, unknown>>> & {
     init: Nullable<Record<string, unknown>>;
 };
+/** What the host says about one field, with the sentinel already read. */
+export type HostEntry = {
+    /** The host names this field. A field it does not name reads `undefined`. */
+    found: boolean;
+    value: unknown;
+};
+export declare function readHostEntry(entry: unknown): HostEntry;
 /**
  * One field's entry in that record.
  *
@@ -12,19 +19,10 @@ export declare const hostValueAtom: import("jotai").PrimitiveAtom<Nullable<Recor
  * read; doing it at the call site is what keeps this correct where a memo
  * comparator could not be. See `ListPathContext`.
  *
- * Not released the way the per-name families in `store-helper` are, and it does
- * not need to be for the same reason it is keyed this way: a position is reused
- * where a stable id only ever climbs, so the keys here are bounded by the
- * widest the form has ever been rather than by every row it has ever held.
- * Measured going 1 -> 20 -> 14 -> 20 rows: the released families fall back to
- * 23 and this one stays at 29, its high-water mark. Worth knowing before
- * someone reads the absence of a release as an oversight.
+ * Made by whoever subscribes rather than cached by name, so it goes with the
+ * component that asked: a family kept one per name for the life of the page,
+ * and this one was never released at all -- 110 keys after ten definitions of
+ * ten fields. See `useEntryAtom` for the same move on the records a field
+ * writes into.
  */
-/** What the host says about one field, with the sentinel already read. */
-export type HostEntry = {
-    /** The host names this field. A field it does not name reads `undefined`. */
-    found: boolean;
-    value: unknown;
-};
-export declare function readHostEntry(entry: unknown): HostEntry;
-export declare const hostEntryAtom: import("jotai-family").AtomFamily<string, import("jotai").Atom<unknown>>;
+export declare function hostEntryAtom(name: string): import("jotai").Atom<unknown>;

package/dist/types/luna-react/src/client/lib/list-store.d.ts

@@ -1,7 +1,6 @@
 export declare const pendingListRowsAtom: import("jotai").PrimitiveAtom<Record<string, Record<string, unknown>[]>> & {
     init: Record<string, Record<string, unknown>[]>;
 };
-export declare const reportPendingListRowsAtom: import("jotai-family").AtomFamily<string, import("jotai").WritableAtom<Record<string, unknown>[] | undefined, [newValue: Record<string, unknown>[] | undefined], void>>;
 /**
  * What a list on screen is holding: the stable ids of its live rows, in the
  * order they are shown, and the name of every leaf a row owns.
@@ -37,4 +36,3 @@ export type MountedList = {
 export declare const mountedListsAtom: import("jotai").PrimitiveAtom<Record<string, MountedList>> & {
     init: Record<string, MountedList>;
 };
-export declare const reportMountedListAtom: import("jotai-family").AtomFamily<string, import("jotai").WritableAtom<MountedList | undefined, [newValue: MountedList | undefined], void>>;

package/dist/types/luna-react/src/client/lib/resolve-value.d.ts

@@ -1,6 +1 @@
-export type Entry = {
-    found: boolean;
-    value: unknown;
-};
-export declare function resolveEntry(name: string, currentValue: Record<string, unknown> | unknown[]): Entry;
 export declare function resolveValue(name: string, currentValue: Record<string, unknown> | unknown[]): unknown;

package/dist/types/luna-react/src/client/lib/source-store.d.ts

@@ -1,8 +1,11 @@
 import { type DataSource } from '../../../../luna-core/index';
-export declare const reportSourceAtom: import("jotai-family").AtomFamily<string, import("jotai").WritableAtom<DataSource | undefined, [target: string, value: DataSource | undefined], void>>;
-export declare const clearInputSourceAtom: import("jotai").WritableAtom<null, [contributorNames: string[]], void> & {
-    init: null;
+export declare const sourceAtom: import("jotai").PrimitiveAtom<Record<string, Record<string, DataSource>>> & {
+    init: Record<string, Record<string, DataSource>>;
 };
-export declare const releaseInputSourceAtom: import("jotai").WritableAtom<null, [names: string[]], void> & {
+export declare const SOURCE_OPTIONS: {
+    readonly merge: (values: DataSource[]) => DataSource | undefined;
+    readonly validateTarget: (target: string) => boolean;
+};
+export declare const clearInputSourceAtom: import("jotai").WritableAtom<null, [contributorNames: string[]], void> & {
     init: null;
 };

package/dist/types/luna-react/src/client/lib/state-store.d.ts

@@ -2,7 +2,3 @@ import type { FieldState } from '../../../../luna-core/index';
 export declare const fieldStateAtom: import("jotai").PrimitiveAtom<Record<string, FieldState>> & {
     init: Record<string, FieldState>;
 };
-export declare const releaseFieldStateAtom: import("jotai").WritableAtom<null, [names: string[]], void> & {
-    init: null;
-};
-export declare const reportFieldStateAtom: import("jotai-family").AtomFamily<string, import("jotai").WritableAtom<FieldState | undefined, [newValue: FieldState | undefined], void>>;

package/dist/types/luna-react/src/client/lib/store-helper.d.ts

@@ -1,15 +1,10 @@
 import { type PrimitiveAtom } from 'jotai';
-type NestedAtomFamilyOptions<TInner> = {
-    merge?: (values: TInner[]) => TInner | undefined;
-    validateTarget?: (target: string) => boolean;
-};
 export declare function omitKey<T extends Record<string, unknown>>(obj: T, key: string): T;
-export declare function createNestedRecordAtomFamily<TInner, TRecord extends Record<string, Record<string, TInner>> = Record<string, Record<string, TInner>>>(baseAtom: PrimitiveAtom<TRecord>, options?: NestedAtomFamilyOptions<TInner>): import("jotai-family").AtomFamily<string, import("jotai").WritableAtom<TInner | undefined, [target: string, value: TInner | undefined], void>>;
-export declare function createNestedReleaseAtom(family: {
-    remove: (name: string) => void;
-}): import("jotai").WritableAtom<null, [names: string[]], void> & {
-    init: null;
-};
+export declare function createEntryAtom<T>(base: PrimitiveAtom<Record<string, T>>, name: string): import("jotai").WritableAtom<NonNullable<T> | undefined, [next: T | undefined], void>;
+export declare function createContributionAtom<T>(base: PrimitiveAtom<Record<string, Record<string, T>>>, name: string, options: Readonly<{
+    merge: (values: T[]) => T | undefined;
+    validateTarget: (target: string) => boolean;
+}>): import("jotai").WritableAtom<T | undefined, [target: string, value: T | undefined], void>;
 export declare function createNestedClearAtom<TInner>(baseAtom: PrimitiveAtom<Record<string, Record<string, TInner>>>): import("jotai").WritableAtom<null, [contributorNames: string[]], void> & {
     init: null;
 };
@@ -26,9 +21,4 @@ export declare function createAtomStore<T>(initialValue?: Record<string, T>): {
     bulkReport: import("jotai").WritableAtom<null, [newValue: Record<string, T>], void> & {
         init: null;
     };
-    release: import("jotai").WritableAtom<null, [names: string[]], void> & {
-        init: null;
-    };
-    report: import("jotai-family").AtomFamily<string, import("jotai").WritableAtom<NonNullable<T> | undefined, [newValue: T | undefined], void>>;
 };
-export {};

package/dist/types/luna-react/src/client/lib/value-store.d.ts

@@ -7,10 +7,6 @@ export declare const clearAllValueAtom: import("jotai").WritableAtom<null, [], v
 export declare const clearInputValueAtom: import("jotai").WritableAtom<null, [names: string[]], void> & {
     init: null;
 };
-export declare const releaseInputValueAtom: import("jotai").WritableAtom<null, [names: string[]], void> & {
-    init: null;
-};
-export declare const reportValueAtom: import("jotai-family").AtomFamily<string, import("jotai").WritableAtom<{} | undefined, [newValue: unknown], void>>;
 export declare const appliedAutoFillAtom: import("jotai").PrimitiveAtom<Record<string, unknown>> & {
     init: Record<string, unknown>;
 };

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

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

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

@@ -1,4 +1,13 @@
+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;
     title?: string;
 }>): import("react").JSX.Element;
+export type DescriptionTextProps = Readonly<{
+    config?: Config;
+    context?: Record<string, unknown>;
+    localization?: Localization;
+    text?: DescriptionType;
+}>;
+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-set.d.ts → field-set-static.d.ts}

@@ -1,5 +1,5 @@
 import { type Section, type Style } from '../../../../luna-core/index';
-export declare function FieldSet(props: Readonly<{
+export declare function StaticFieldSet(props: Readonly<{
     advanced?: {
         step?: boolean;
     };

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

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

@@ -1,6 +1,13 @@
+import { StaticFieldSet } from './field/field-set-static';
 import { type Definition, type Sections } from '../../../luna-core/index';
 import type { Config, Control, Slot } from '../type';
+import type { Fields } from '../../../luna-core/index';
 import type { FormEvent } from 'react';
+export type GuardProps = Readonly<{
+    children: React.ReactNode;
+    fields: Fields;
+}>;
+export declare function StaticGuard(props: GuardProps): import("react").ReactNode;
 export declare function Form(props: Readonly<{
     advanced?: {
         step?: boolean;
@@ -8,8 +15,11 @@ 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>>;
+    guard?: React.ComponentType<GuardProps>;
     isPending?: boolean;
     noValidate?: boolean;
     onSubmit?: (event: FormEvent<HTMLFormElement>) => void;

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,10 +1,12 @@
+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;
     context?: Record<string, unknown>;
+    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,9 +1,11 @@
-import { type Field } from '../../../luna-core/index';
+import { type DescriptionProps } from './field-description';
+import { type Field, type Localization } from '../../../luna-core/index';
 import type { Config } from '../type';
 export declare function InputLabel(props: Readonly<{
     config?: Config;
     context?: Record<string, unknown>;
+    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,8 +1,10 @@
-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';
 import type { ListProps } from '../field/field-list';
 export type SlotComponents = {
+    description?: React.ComponentType<DescriptionTextProps>;
     field: React.ComponentType<FieldProps>;
     list: React.ComponentType<ListProps>;
 };
@@ -13,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/lib/visibility.d.ts

@@ -0,0 +1,3 @@
+import type { Field, FieldState, Fields, List } from '../../../luna-core/index';
+export declare function isEntryHidden(entry: Fields[number], states: Record<string, FieldState>): boolean;
+export declare function isGuardHidden(states: Record<string, FieldState>, fields: Fields, container?: Field | List): boolean;

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

@@ -0,0 +1,2 @@
+import type { FieldProps } from '../../component/field/field';
+export declare function Field(props: FieldProps): import("react").JSX.Element;

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/list-slot.d.ts

@@ -0,0 +1,2 @@
+import type { ListProps } from '../../component/field/field-list';
+export declare function ListSlot(props: ListProps): import("react").JSX.Element;

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

@@ -0,0 +1,14 @@
+export declare const Slot: (props: Readonly<{
+    children: import("../../type").Children;
+    config: import("../../type").Config;
+    context?: Record<string, unknown>;
+    disabled?: boolean;
+    fields?: import('../../../../luna-core/index').Fields;
+    onValueChange?: (input: {
+        name: string;
+        value: unknown;
+    }) => void;
+    style?: import('../../../../luna-core/index').Style;
+    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