@formality-ui/core 0.2.5 → 0.3.1

package/dist/index.d.cts

@@ -672,8 +672,22 @@ interface EvaluateConditionsInput {
  * - visible: AND logic (any false = false)
  * - setValue: last matching condition wins
  *
- * @param input - Evaluation input with conditions and state
- * @returns Result with resolved disabled, visible, and setValue states
+ * **Signature — object-arg form.** Takes a single {@link EvaluateConditionsInput}
+ * object (`{ conditions, fieldValues, fieldStates?, record?, props? }`) rather
+ * than positional `(conditions, state)` arguments.
+ *
+ * **PRD deviation note (accepted, gap_analysis G4).** PRD §1.3.2's *table*
+ * summarizes this export as `evaluateConditions(conditions, state)`, but PRD
+ * §1.3.2's own *example code* defines and uses the identical
+ * {@link EvaluateConditionsInput} object-arg form implemented here. The table
+ * text is a simplified representation; the object-arg form is the actual, stable
+ * contract and is the shape every framework adapter passes (see e.g.
+ * `@formality-ui/react`'s `useConditions`). No code change is planned.
+ *
+ * @param input - {@link EvaluateConditionsInput} - Evaluation input with
+ *   conditions and state
+ * @returns {@link ConditionResult} - Result with resolved disabled, visible,
+ *   and setValue states
  *
  * @example
  * const result = evaluateConditions({
@@ -730,6 +744,35 @@ declare function mergeConditionResults(results: ConditionResult[]): ConditionRes
  */
 declare function inferFieldsFromConditions(conditions: ConditionDescriptor[]): string[];
 
+/**
+ * Validate a value against a rule specification.
+ *
+ * PRD §1.3.2 headline export for the `validation/validate` module. This is a
+ * THIN WRAPPER over {@link runValidator}: it reorders the arguments into the
+ * ergonomic `(value, rules, validators, formValues)` shape documented in the
+ * PRD, defaults `formValues` to `{}`, and delegates every semantic (named
+ * lookup, factory detection, array short-circuit, async, throw-as-failure) to
+ * `runValidator` — see that function for details.
+ *
+ * This covers the RULES layer only (PRD §9.1). The field-validator and
+ * type-validator layers are wired by the adapter's `Field` Controller
+ * `rules.validate`; this function does not compose them.
+ *
+ * Returns the raw {@link ValidationResult}. Resolve a user-facing message
+ * with {@link resolveErrorMessage}.
+ *
+ * @param value - The value to validate.
+ * @param rules - ValidatorSpec: a named validator (string), an inline
+ *   ValidatorFunction, or an array of either (run in sequence, short-circuiting
+ *   on first failure).
+ * @param validators - Optional named-validators registry (ValidatorsConfig)
+ *   for resolving string `rules`. When omitted, a string rule warns and passes.
+ * @param formValues - Optional full form values for cross-field validation.
+ *   Defaults to `{}`.
+ * @returns The ValidationResult (`true`/`undefined` = valid; `false`/string/
+ *   `{type,message?}` = invalid).
+ */
+declare function validate(value: unknown, rules: ValidatorSpec, validators?: ValidatorsConfig, formValues?: Record<string, unknown>): Promise<ValidationResult | undefined>;
 /**
  * Run a validator specification against a value
  *
@@ -1110,6 +1153,43 @@ declare function createConfigContext(providerConfig: FormalityProviderConfig, fo
     defaultFieldProps: Record<string, unknown>;
     selectDefaultFieldProps: unknown;
 };
+/**
+ * Merge provider + form + (optional) field configs into a resolved pair.
+ *
+ * PRD §1.3.2 headline export for the `config/merge` module. This is a
+ * CONVENIENCE WRAPPER for the common 3-source static merge; it composes the
+ * granular functions and delegates all semantics to them:
+ *
+ *  - `inputConfig` = `resolveInputConfig(resolveFieldType(undefined, field),
+ *                    mergeInputConfigs(provider.inputs, form?.inputs))`.
+ *    The field's type is derived from `field?.type` (default "textField").
+ *  - `fieldConfig.props` = `mergeStaticProps(provider.defaultFieldProps,
+ *                    form?.defaultFieldProps, field?.props)` (provider → form →
+ *                    field; later wins). The field's own config (type, label,
+ *                    disabled, …) is preserved via spread.
+ *
+ * STATIC ONLY. This function does NOT evaluate `selectProps` or
+ * `selectDefaultFieldProps` — those dynamic layers require a `FormState`
+ * (expression evaluation) that a pure merge function cannot supply. For the
+ * full evaluated 8-layer pipeline (PRD §5.3.2 / §6.1), use {@link mergeFieldProps}
+ * from within an adapter that has form state.
+ *
+ * The granular functions ({@link mergeInputConfigs}, {@link resolveInputConfig},
+ * {@link mergeStaticProps}, {@link mergeFieldProps}) remain exported for
+ * advanced use.
+ *
+ * @param provider - Provider config (inputs REQUIRED).
+ * @param form     - Optional form config. When omitted, only provider inputs/
+ *                   defaultFieldProps apply (matches {@link createConfigContext}).
+ * @param field    - Optional field config. Its `type` selects the inputConfig;
+ *                   its `props` are the highest-priority static prop layer.
+ * @returns `{ inputConfig, fieldConfig }`. `inputConfig` is `undefined` when the
+ *          resolved type is not registered and no "textField" default exists.
+ */
+declare function mergeConfigs(provider: FormalityProviderConfig, form?: FormConfig, field?: FieldConfig): {
+    inputConfig: InputConfig | undefined;
+    fieldConfig: FieldConfig;
+};
 
 /**
  * Resolve the initial value for a field
@@ -1119,6 +1199,16 @@ declare function createConfigContext(providerConfig: FormalityProviderConfig, fo
  * 2. record[recordKey] (using recordKey if specified, else fieldName)
  * 3. inputConfig.defaultValue (from input type definition)
  *
+ * **PRD deviation note (accepted, gap_analysis G5).** PRD §1.3.2's table
+ * summarizes this export as `resolveInitialValue(record, config, inputConfig)`.
+ * The implemented signature is a richer superset —
+ * `(fieldName, fieldConfig?, inputConfig?, record?, defaultValues?)` — because
+ * it drives the full priority chain above (defaultValues → record[recordKey] →
+ * inputConfig.defaultValue) from a single call. This is an internal API
+ * consumed by the framework adapters and by {@link resolveAllInitialValues},
+ * not a simplified end-user entry point; the PRD literal form is a condensed
+ * representation. No code change is planned.
+ *
  * @param fieldName - Field name
  * @param fieldConfig - Field configuration
  * @param inputConfig - Input type configuration
@@ -1186,6 +1276,38 @@ declare function getInputDefaultValue(inputConfig?: InputConfig, typeName?: stri
  */
 declare function mergeRecordWithDefaults(record?: Record<string, unknown>, defaults?: Record<string, unknown>): Record<string, unknown>;
 
+/**
+ * Sort fields by their order property
+ *
+ * Canonical location: `config/ordering.ts` (PRD §1.3.1/§1.3.2).
+ *
+ * @param fieldNames - Array of field names
+ * @param fieldConfigs - Map of field configs
+ * @returns Sorted array of field names
+ */
+declare function sortFieldsByOrder(fieldNames: string[], fieldConfigs: Record<string, FieldConfig>): string[];
+/**
+ * Get fields that are not in the declared set
+ *
+ * Canonical location: `config/ordering.ts` (PRD §1.3.1/§1.3.2).
+ *
+ * @param allFields - All field names from config
+ * @param declaredFields - Set of explicitly declared field names
+ * @returns Array of unused field names
+ */
+declare function getUnusedFields(allFields: string[], declaredFields: Set<string>): string[];
+/**
+ * Get ordered unused fields
+ *
+ * Canonical location: `config/ordering.ts` (PRD §1.3.1/§1.3.2).
+ *
+ * @param allFields - All field names from config
+ * @param declaredFields - Set of explicitly declared field names
+ * @param fieldConfigs - Map of field configs
+ * @returns Sorted array of unused field names
+ */
+declare function getOrderedUnusedFields(allFields: string[], declaredFields: Set<string>, fieldConfigs: Record<string, FieldConfig>): string[];
+
 /**
  * Convert a camelCase or PascalCase field name to a human-readable label
  *
@@ -1212,6 +1334,18 @@ declare function humanizeLabel(fieldName: string): string;
  * 5. Field config title (legacy alias)
  * 6. Auto-generated from field name
  *
+ * **PRD deviation note (accepted, gap_analysis G5).** PRD §1.3.2's table
+ * summarizes this export as `resolveLabel(config, fieldName)`. The implemented
+ * signature is a richer superset —
+ * `(fieldName, fieldConfig?, evaluatedSelectProps?, componentProps?)` — because
+ * it resolves the full 6-source priority chain above in one call, which
+ * requires the pre-evaluated `selectProps` and the JSX `componentProps`. This
+ * is an internal API consumed by the framework adapters (e.g.
+ * `@formality-ui/react`'s `Field` calls
+ * `resolveLabel(name, fieldConfig, fieldSelectProps, restProps)`), not a
+ * simplified end-user entry point; the PRD literal form is a condensed
+ * representation. No code change is planned.
+ *
  * @param fieldName - Field name
  * @param fieldConfig - Field configuration
  * @param evaluatedSelectProps - Pre-evaluated selectProps
@@ -1261,30 +1395,5 @@ declare function parseLabelWithUnit(label: string): {
     base: string;
     unit?: string;
 };
-/**
- * Sort fields by their order property
- *
- * @param fieldNames - Array of field names
- * @param fieldConfigs - Map of field configs
- * @returns Sorted array of field names
- */
-declare function sortFieldsByOrder(fieldNames: string[], fieldConfigs: Record<string, FieldConfig>): string[];
-/**
- * Get fields that are not in the declared set
- *
- * @param allFields - All field names from config
- * @param declaredFields - Set of explicitly declared field names
- * @returns Array of unused field names
- */
-declare function getUnusedFields(allFields: string[], declaredFields: Set<string>): string[];
-/**
- * Get ordered unused fields
- *
- * @param allFields - All field names from config
- * @param declaredFields - Set of explicitly declared field names
- * @param fieldConfigs - Map of field configs
- * @returns Sorted array of unused field names
- */
-declare function getOrderedUnusedFields(allFields: string[], declaredFields: Set<string>, fieldConfigs: Record<string, FieldConfig>): string[];
 
-export { type ConditionDescriptor, type ConditionResult, type ErrorMessagesConfig, type EvaluateConditionsInput, type EvaluationContext, FIELD_PROXY_MARKER, FIELD_PROXY_VALUE, type FieldConfig, type FieldError, type FieldState, type FieldStateInput, type FormConfig, type FormFieldsConfig, type FormState, type FormalityProviderConfig, type FormatterFunction, type FormatterSpec, type FormattersConfig, type GroupConfig, type InputConfig, type InputTemplateProps, KEYWORDS, type ParserFunction, type ParserSpec, type ParsersConfig, QUALIFIED_PREFIXES, type SelectFunction, type SelectValue, type ValidationResult, type ValidatorEntry, type ValidatorFactory, type ValidatorFunction, type ValidatorSpec, type ValidatorsConfig, buildEvaluationContext, buildFieldContext, buildFormContext, clearExpressionCache, composeValidators, conditionMatches, createConfigContext, createDefaultFormatters, createDefaultParsers, createErrorMessages, createFieldStateProxy, createFloatFormatter, createFloatParser, createIntParser, createLabelWithUnit, createTrimParser, createValidationError, deepMerge, evaluate, evaluateConditions, evaluateDescriptor, extractValueField, format, formatTypeAsMessage, getErrorType, getInputDefaultValue, getOrderedUnusedFields, getUnusedFields, humanizeLabel, inferFieldsFromConditions, inferFieldsFromDescriptor, inferFieldsFromExpression, isAutoGeneratedLabel, isEmptyValue, isFieldProxy, isValid, maxLength, mergeConditionResults, mergeFieldProps, mergeInputConfigs, mergeRecordWithDefaults, mergeStaticProps, minLength, parse, parseLabelWithUnit, pattern, required, resolveAllInitialValues, resolveErrorMessage, resolveFieldType, resolveFormTitle, resolveInitialValue, resolveInputConfig, resolveLabel, runValidator, runValidatorSync, sortFieldsByOrder, transformFieldName, unwrapFieldProxy };
+export { type ConditionDescriptor, type ConditionResult, type ErrorMessagesConfig, type EvaluateConditionsInput, type EvaluationContext, FIELD_PROXY_MARKER, FIELD_PROXY_VALUE, type FieldConfig, type FieldError, type FieldState, type FieldStateInput, type FormConfig, type FormFieldsConfig, type FormState, type FormalityProviderConfig, type FormatterFunction, type FormatterSpec, type FormattersConfig, type GroupConfig, type InputConfig, type InputTemplateProps, KEYWORDS, type ParserFunction, type ParserSpec, type ParsersConfig, QUALIFIED_PREFIXES, type SelectFunction, type SelectValue, type ValidationResult, type ValidatorEntry, type ValidatorFactory, type ValidatorFunction, type ValidatorSpec, type ValidatorsConfig, buildEvaluationContext, buildFieldContext, buildFormContext, clearExpressionCache, composeValidators, conditionMatches, createConfigContext, createDefaultFormatters, createDefaultParsers, createErrorMessages, createFieldStateProxy, createFloatFormatter, createFloatParser, createIntParser, createLabelWithUnit, createTrimParser, createValidationError, deepMerge, evaluate, evaluateConditions, evaluateDescriptor, extractValueField, format, formatTypeAsMessage, getErrorType, getInputDefaultValue, getOrderedUnusedFields, getUnusedFields, humanizeLabel, inferFieldsFromConditions, inferFieldsFromDescriptor, inferFieldsFromExpression, isAutoGeneratedLabel, isEmptyValue, isFieldProxy, isValid, maxLength, mergeConditionResults, mergeConfigs, mergeFieldProps, mergeInputConfigs, mergeRecordWithDefaults, mergeStaticProps, minLength, parse, parseLabelWithUnit, pattern, required, resolveAllInitialValues, resolveErrorMessage, resolveFieldType, resolveFormTitle, resolveInitialValue, resolveInputConfig, resolveLabel, runValidator, runValidatorSync, sortFieldsByOrder, transformFieldName, unwrapFieldProxy, validate };

package/dist/index.d.ts

@@ -672,8 +672,22 @@ interface EvaluateConditionsInput {
  * - visible: AND logic (any false = false)
  * - setValue: last matching condition wins
  *
- * @param input - Evaluation input with conditions and state
- * @returns Result with resolved disabled, visible, and setValue states
+ * **Signature — object-arg form.** Takes a single {@link EvaluateConditionsInput}
+ * object (`{ conditions, fieldValues, fieldStates?, record?, props? }`) rather
+ * than positional `(conditions, state)` arguments.
+ *
+ * **PRD deviation note (accepted, gap_analysis G4).** PRD §1.3.2's *table*
+ * summarizes this export as `evaluateConditions(conditions, state)`, but PRD
+ * §1.3.2's own *example code* defines and uses the identical
+ * {@link EvaluateConditionsInput} object-arg form implemented here. The table
+ * text is a simplified representation; the object-arg form is the actual, stable
+ * contract and is the shape every framework adapter passes (see e.g.
+ * `@formality-ui/react`'s `useConditions`). No code change is planned.
+ *
+ * @param input - {@link EvaluateConditionsInput} - Evaluation input with
+ *   conditions and state
+ * @returns {@link ConditionResult} - Result with resolved disabled, visible,
+ *   and setValue states
  *
  * @example
  * const result = evaluateConditions({
@@ -730,6 +744,35 @@ declare function mergeConditionResults(results: ConditionResult[]): ConditionRes
  */
 declare function inferFieldsFromConditions(conditions: ConditionDescriptor[]): string[];
 
+/**
+ * Validate a value against a rule specification.
+ *
+ * PRD §1.3.2 headline export for the `validation/validate` module. This is a
+ * THIN WRAPPER over {@link runValidator}: it reorders the arguments into the
+ * ergonomic `(value, rules, validators, formValues)` shape documented in the
+ * PRD, defaults `formValues` to `{}`, and delegates every semantic (named
+ * lookup, factory detection, array short-circuit, async, throw-as-failure) to
+ * `runValidator` — see that function for details.
+ *
+ * This covers the RULES layer only (PRD §9.1). The field-validator and
+ * type-validator layers are wired by the adapter's `Field` Controller
+ * `rules.validate`; this function does not compose them.
+ *
+ * Returns the raw {@link ValidationResult}. Resolve a user-facing message
+ * with {@link resolveErrorMessage}.
+ *
+ * @param value - The value to validate.
+ * @param rules - ValidatorSpec: a named validator (string), an inline
+ *   ValidatorFunction, or an array of either (run in sequence, short-circuiting
+ *   on first failure).
+ * @param validators - Optional named-validators registry (ValidatorsConfig)
+ *   for resolving string `rules`. When omitted, a string rule warns and passes.
+ * @param formValues - Optional full form values for cross-field validation.
+ *   Defaults to `{}`.
+ * @returns The ValidationResult (`true`/`undefined` = valid; `false`/string/
+ *   `{type,message?}` = invalid).
+ */
+declare function validate(value: unknown, rules: ValidatorSpec, validators?: ValidatorsConfig, formValues?: Record<string, unknown>): Promise<ValidationResult | undefined>;
 /**
  * Run a validator specification against a value
  *
@@ -1110,6 +1153,43 @@ declare function createConfigContext(providerConfig: FormalityProviderConfig, fo
     defaultFieldProps: Record<string, unknown>;
     selectDefaultFieldProps: unknown;
 };
+/**
+ * Merge provider + form + (optional) field configs into a resolved pair.
+ *
+ * PRD §1.3.2 headline export for the `config/merge` module. This is a
+ * CONVENIENCE WRAPPER for the common 3-source static merge; it composes the
+ * granular functions and delegates all semantics to them:
+ *
+ *  - `inputConfig` = `resolveInputConfig(resolveFieldType(undefined, field),
+ *                    mergeInputConfigs(provider.inputs, form?.inputs))`.
+ *    The field's type is derived from `field?.type` (default "textField").
+ *  - `fieldConfig.props` = `mergeStaticProps(provider.defaultFieldProps,
+ *                    form?.defaultFieldProps, field?.props)` (provider → form →
+ *                    field; later wins). The field's own config (type, label,
+ *                    disabled, …) is preserved via spread.
+ *
+ * STATIC ONLY. This function does NOT evaluate `selectProps` or
+ * `selectDefaultFieldProps` — those dynamic layers require a `FormState`
+ * (expression evaluation) that a pure merge function cannot supply. For the
+ * full evaluated 8-layer pipeline (PRD §5.3.2 / §6.1), use {@link mergeFieldProps}
+ * from within an adapter that has form state.
+ *
+ * The granular functions ({@link mergeInputConfigs}, {@link resolveInputConfig},
+ * {@link mergeStaticProps}, {@link mergeFieldProps}) remain exported for
+ * advanced use.
+ *
+ * @param provider - Provider config (inputs REQUIRED).
+ * @param form     - Optional form config. When omitted, only provider inputs/
+ *                   defaultFieldProps apply (matches {@link createConfigContext}).
+ * @param field    - Optional field config. Its `type` selects the inputConfig;
+ *                   its `props` are the highest-priority static prop layer.
+ * @returns `{ inputConfig, fieldConfig }`. `inputConfig` is `undefined` when the
+ *          resolved type is not registered and no "textField" default exists.
+ */
+declare function mergeConfigs(provider: FormalityProviderConfig, form?: FormConfig, field?: FieldConfig): {
+    inputConfig: InputConfig | undefined;
+    fieldConfig: FieldConfig;
+};
 
 /**
  * Resolve the initial value for a field
@@ -1119,6 +1199,16 @@ declare function createConfigContext(providerConfig: FormalityProviderConfig, fo
  * 2. record[recordKey] (using recordKey if specified, else fieldName)
  * 3. inputConfig.defaultValue (from input type definition)
  *
+ * **PRD deviation note (accepted, gap_analysis G5).** PRD §1.3.2's table
+ * summarizes this export as `resolveInitialValue(record, config, inputConfig)`.
+ * The implemented signature is a richer superset —
+ * `(fieldName, fieldConfig?, inputConfig?, record?, defaultValues?)` — because
+ * it drives the full priority chain above (defaultValues → record[recordKey] →
+ * inputConfig.defaultValue) from a single call. This is an internal API
+ * consumed by the framework adapters and by {@link resolveAllInitialValues},
+ * not a simplified end-user entry point; the PRD literal form is a condensed
+ * representation. No code change is planned.
+ *
  * @param fieldName - Field name
  * @param fieldConfig - Field configuration
  * @param inputConfig - Input type configuration
@@ -1186,6 +1276,38 @@ declare function getInputDefaultValue(inputConfig?: InputConfig, typeName?: stri
  */
 declare function mergeRecordWithDefaults(record?: Record<string, unknown>, defaults?: Record<string, unknown>): Record<string, unknown>;
 
+/**
+ * Sort fields by their order property
+ *
+ * Canonical location: `config/ordering.ts` (PRD §1.3.1/§1.3.2).
+ *
+ * @param fieldNames - Array of field names
+ * @param fieldConfigs - Map of field configs
+ * @returns Sorted array of field names
+ */
+declare function sortFieldsByOrder(fieldNames: string[], fieldConfigs: Record<string, FieldConfig>): string[];
+/**
+ * Get fields that are not in the declared set
+ *
+ * Canonical location: `config/ordering.ts` (PRD §1.3.1/§1.3.2).
+ *
+ * @param allFields - All field names from config
+ * @param declaredFields - Set of explicitly declared field names
+ * @returns Array of unused field names
+ */
+declare function getUnusedFields(allFields: string[], declaredFields: Set<string>): string[];
+/**
+ * Get ordered unused fields
+ *
+ * Canonical location: `config/ordering.ts` (PRD §1.3.1/§1.3.2).
+ *
+ * @param allFields - All field names from config
+ * @param declaredFields - Set of explicitly declared field names
+ * @param fieldConfigs - Map of field configs
+ * @returns Sorted array of unused field names
+ */
+declare function getOrderedUnusedFields(allFields: string[], declaredFields: Set<string>, fieldConfigs: Record<string, FieldConfig>): string[];
+
 /**
  * Convert a camelCase or PascalCase field name to a human-readable label
  *
@@ -1212,6 +1334,18 @@ declare function humanizeLabel(fieldName: string): string;
  * 5. Field config title (legacy alias)
  * 6. Auto-generated from field name
  *
+ * **PRD deviation note (accepted, gap_analysis G5).** PRD §1.3.2's table
+ * summarizes this export as `resolveLabel(config, fieldName)`. The implemented
+ * signature is a richer superset —
+ * `(fieldName, fieldConfig?, evaluatedSelectProps?, componentProps?)` — because
+ * it resolves the full 6-source priority chain above in one call, which
+ * requires the pre-evaluated `selectProps` and the JSX `componentProps`. This
+ * is an internal API consumed by the framework adapters (e.g.
+ * `@formality-ui/react`'s `Field` calls
+ * `resolveLabel(name, fieldConfig, fieldSelectProps, restProps)`), not a
+ * simplified end-user entry point; the PRD literal form is a condensed
+ * representation. No code change is planned.
+ *
  * @param fieldName - Field name
  * @param fieldConfig - Field configuration
  * @param evaluatedSelectProps - Pre-evaluated selectProps
@@ -1261,30 +1395,5 @@ declare function parseLabelWithUnit(label: string): {
     base: string;
     unit?: string;
 };
-/**
- * Sort fields by their order property
- *
- * @param fieldNames - Array of field names
- * @param fieldConfigs - Map of field configs
- * @returns Sorted array of field names
- */
-declare function sortFieldsByOrder(fieldNames: string[], fieldConfigs: Record<string, FieldConfig>): string[];
-/**
- * Get fields that are not in the declared set
- *
- * @param allFields - All field names from config
- * @param declaredFields - Set of explicitly declared field names
- * @returns Array of unused field names
- */
-declare function getUnusedFields(allFields: string[], declaredFields: Set<string>): string[];
-/**
- * Get ordered unused fields
- *
- * @param allFields - All field names from config
- * @param declaredFields - Set of explicitly declared field names
- * @param fieldConfigs - Map of field configs
- * @returns Sorted array of unused field names
- */
-declare function getOrderedUnusedFields(allFields: string[], declaredFields: Set<string>, fieldConfigs: Record<string, FieldConfig>): string[];
 
-export { type ConditionDescriptor, type ConditionResult, type ErrorMessagesConfig, type EvaluateConditionsInput, type EvaluationContext, FIELD_PROXY_MARKER, FIELD_PROXY_VALUE, type FieldConfig, type FieldError, type FieldState, type FieldStateInput, type FormConfig, type FormFieldsConfig, type FormState, type FormalityProviderConfig, type FormatterFunction, type FormatterSpec, type FormattersConfig, type GroupConfig, type InputConfig, type InputTemplateProps, KEYWORDS, type ParserFunction, type ParserSpec, type ParsersConfig, QUALIFIED_PREFIXES, type SelectFunction, type SelectValue, type ValidationResult, type ValidatorEntry, type ValidatorFactory, type ValidatorFunction, type ValidatorSpec, type ValidatorsConfig, buildEvaluationContext, buildFieldContext, buildFormContext, clearExpressionCache, composeValidators, conditionMatches, createConfigContext, createDefaultFormatters, createDefaultParsers, createErrorMessages, createFieldStateProxy, createFloatFormatter, createFloatParser, createIntParser, createLabelWithUnit, createTrimParser, createValidationError, deepMerge, evaluate, evaluateConditions, evaluateDescriptor, extractValueField, format, formatTypeAsMessage, getErrorType, getInputDefaultValue, getOrderedUnusedFields, getUnusedFields, humanizeLabel, inferFieldsFromConditions, inferFieldsFromDescriptor, inferFieldsFromExpression, isAutoGeneratedLabel, isEmptyValue, isFieldProxy, isValid, maxLength, mergeConditionResults, mergeFieldProps, mergeInputConfigs, mergeRecordWithDefaults, mergeStaticProps, minLength, parse, parseLabelWithUnit, pattern, required, resolveAllInitialValues, resolveErrorMessage, resolveFieldType, resolveFormTitle, resolveInitialValue, resolveInputConfig, resolveLabel, runValidator, runValidatorSync, sortFieldsByOrder, transformFieldName, unwrapFieldProxy };
+export { type ConditionDescriptor, type ConditionResult, type ErrorMessagesConfig, type EvaluateConditionsInput, type EvaluationContext, FIELD_PROXY_MARKER, FIELD_PROXY_VALUE, type FieldConfig, type FieldError, type FieldState, type FieldStateInput, type FormConfig, type FormFieldsConfig, type FormState, type FormalityProviderConfig, type FormatterFunction, type FormatterSpec, type FormattersConfig, type GroupConfig, type InputConfig, type InputTemplateProps, KEYWORDS, type ParserFunction, type ParserSpec, type ParsersConfig, QUALIFIED_PREFIXES, type SelectFunction, type SelectValue, type ValidationResult, type ValidatorEntry, type ValidatorFactory, type ValidatorFunction, type ValidatorSpec, type ValidatorsConfig, buildEvaluationContext, buildFieldContext, buildFormContext, clearExpressionCache, composeValidators, conditionMatches, createConfigContext, createDefaultFormatters, createDefaultParsers, createErrorMessages, createFieldStateProxy, createFloatFormatter, createFloatParser, createIntParser, createLabelWithUnit, createTrimParser, createValidationError, deepMerge, evaluate, evaluateConditions, evaluateDescriptor, extractValueField, format, formatTypeAsMessage, getErrorType, getInputDefaultValue, getOrderedUnusedFields, getUnusedFields, humanizeLabel, inferFieldsFromConditions, inferFieldsFromDescriptor, inferFieldsFromExpression, isAutoGeneratedLabel, isEmptyValue, isFieldProxy, isValid, maxLength, mergeConditionResults, mergeConfigs, mergeFieldProps, mergeInputConfigs, mergeRecordWithDefaults, mergeStaticProps, minLength, parse, parseLabelWithUnit, pattern, required, resolveAllInitialValues, resolveErrorMessage, resolveFieldType, resolveFormTitle, resolveInitialValue, resolveInputConfig, resolveLabel, runValidator, runValidatorSync, sortFieldsByOrder, transformFieldName, unwrapFieldProxy, validate };

package/dist/index.js

@@ -717,6 +717,9 @@ function inferFieldsFromConditions(conditions) {
 }
 
 // src/validation/validate.ts
+async function validate(value, rules, validators, formValues) {
+  return runValidator(rules, value, formValues ?? {}, validators);
+}
 function runSingleValidator(validator, value, formValues) {
   try {
     return validator(value, formValues);
@@ -1201,6 +1204,20 @@ function createConfigContext(providerConfig, formConfig) {
     selectDefaultFieldProps: formConfig?.selectDefaultFieldProps ?? providerConfig.selectDefaultFieldProps
   };
 }
+function mergeConfigs(provider, form, field) {
+  const mergedInputs = mergeInputConfigs(provider.inputs, form?.inputs);
+  const type = resolveFieldType(void 0, field, "textField");
+  const inputConfig = resolveInputConfig(type, mergedInputs);
+  const fieldConfig = {
+    ...field,
+    props: mergeStaticProps(
+      provider.defaultFieldProps,
+      form?.defaultFieldProps,
+      field?.props
+    )
+  };
+  return { inputConfig, fieldConfig };
+}
 
 // src/config/defaults.ts
 function resolveInitialValue(fieldName, fieldConfig, inputConfig, record, defaultValues) {
@@ -1296,6 +1313,22 @@ function mergeRecordWithDefaults(record, defaults) {
   return result;
 }
 
+// src/config/ordering.ts
+function sortFieldsByOrder(fieldNames, fieldConfigs) {
+  return [...fieldNames].sort((a, b) => {
+    const orderA = fieldConfigs[a]?.order ?? Infinity;
+    const orderB = fieldConfigs[b]?.order ?? Infinity;
+    return orderA - orderB;
+  });
+}
+function getUnusedFields(allFields, declaredFields) {
+  return allFields.filter((name) => !declaredFields.has(name));
+}
+function getOrderedUnusedFields(allFields, declaredFields, fieldConfigs) {
+  const unused = getUnusedFields(allFields, declaredFields);
+  return sortFieldsByOrder(unused, fieldConfigs);
+}
+
 // src/labels/resolve.ts
 function humanizeLabel(fieldName) {
   if (!fieldName) {
@@ -1347,21 +1380,7 @@ function parseLabelWithUnit(label) {
   }
   return { base: label };
 }
-function sortFieldsByOrder(fieldNames, fieldConfigs) {
-  return [...fieldNames].sort((a, b) => {
-    const orderA = fieldConfigs[a]?.order ?? Infinity;
-    const orderB = fieldConfigs[b]?.order ?? Infinity;
-    return orderA - orderB;
-  });
-}
-function getUnusedFields(allFields, declaredFields) {
-  return allFields.filter((name) => !declaredFields.has(name));
-}
-function getOrderedUnusedFields(allFields, declaredFields, fieldConfigs) {
-  const unused = getUnusedFields(allFields, declaredFields);
-  return sortFieldsByOrder(unused, fieldConfigs);
-}
 
-export { FIELD_PROXY_MARKER, FIELD_PROXY_VALUE, KEYWORDS, QUALIFIED_PREFIXES, buildEvaluationContext, buildFieldContext, buildFormContext, clearExpressionCache, composeValidators, conditionMatches, createConfigContext, createDefaultFormatters, createDefaultParsers, createErrorMessages, createFieldStateProxy, createFloatFormatter, createFloatParser, createIntParser, createLabelWithUnit, createTrimParser, createValidationError, deepMerge, evaluate, evaluateConditions, evaluateDescriptor, extractValueField, format, formatTypeAsMessage, getErrorType, getInputDefaultValue, getOrderedUnusedFields, getUnusedFields, humanizeLabel, inferFieldsFromConditions, inferFieldsFromDescriptor, inferFieldsFromExpression, isAutoGeneratedLabel, isEmptyValue, isFieldProxy, isValid, maxLength, mergeConditionResults, mergeFieldProps, mergeInputConfigs, mergeRecordWithDefaults, mergeStaticProps, minLength, parse, parseLabelWithUnit, pattern, required, resolveAllInitialValues, resolveErrorMessage, resolveFieldType, resolveFormTitle, resolveInitialValue, resolveInputConfig, resolveLabel, runValidator, runValidatorSync, sortFieldsByOrder, transformFieldName, unwrapFieldProxy };
+export { FIELD_PROXY_MARKER, FIELD_PROXY_VALUE, KEYWORDS, QUALIFIED_PREFIXES, buildEvaluationContext, buildFieldContext, buildFormContext, clearExpressionCache, composeValidators, conditionMatches, createConfigContext, createDefaultFormatters, createDefaultParsers, createErrorMessages, createFieldStateProxy, createFloatFormatter, createFloatParser, createIntParser, createLabelWithUnit, createTrimParser, createValidationError, deepMerge, evaluate, evaluateConditions, evaluateDescriptor, extractValueField, format, formatTypeAsMessage, getErrorType, getInputDefaultValue, getOrderedUnusedFields, getUnusedFields, humanizeLabel, inferFieldsFromConditions, inferFieldsFromDescriptor, inferFieldsFromExpression, isAutoGeneratedLabel, isEmptyValue, isFieldProxy, isValid, maxLength, mergeConditionResults, mergeConfigs, mergeFieldProps, mergeInputConfigs, mergeRecordWithDefaults, mergeStaticProps, minLength, parse, parseLabelWithUnit, pattern, required, resolveAllInitialValues, resolveErrorMessage, resolveFieldType, resolveFormTitle, resolveInitialValue, resolveInputConfig, resolveLabel, runValidator, runValidatorSync, sortFieldsByOrder, transformFieldName, unwrapFieldProxy, validate };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map