@tempots/beatui 0.75.0 → 0.76.0

package/dist/types/components/json-schema/controls/generic-control.d.ts

@@ -11,9 +11,17 @@ export declare function JSONSchemaGenericControl<T>({ ctx, controller, }: {
 /**
  * Main entry point for JSON Schema controls
  */
-export declare function JSONSchemaControl<T>({ schema, controller, ajv, widgetRegistry, }: {
+export declare function JSONSchemaControl<T>({ schema, controller, ajv, widgetRegistry, setStatus, formValue, validationMode, submitting, }: {
     schema: JSONSchemaDefinition;
     controller: Controller<T>;
     ajv?: import('ajv').default;
     widgetRegistry?: import('../widgets/widget-customization').WidgetRegistry;
+    /** Function to set the form's validation status, available to custom widgets */
+    setStatus?: (status: import('../../form').ControllerValidation) => void;
+    /** Signal containing the entire form's current value */
+    formValue?: import('@tempots/dom').Signal<unknown>;
+    /** Current validation mode */
+    validationMode?: import('../../form').ValidationMode;
+    /** Signal indicating whether the form is currently submitting */
+    submitting?: import('@tempots/dom').Signal<boolean>;
 }): Renderable;

package/dist/types/components/json-schema/json-schema-form.d.ts

@@ -1,5 +1,5 @@
 import { type SchemaObject } from 'ajv';
-import { Value, Renderable } from '@tempots/dom';
+import { Value, Renderable, Signal } from '@tempots/dom';
 import { Controller, ControllerValidation } from '../form';
 import { type CustomWidgets } from './widgets/widget-customization';
 /**
@@ -93,8 +93,14 @@ export interface JSONSchemaFormProps<T> extends JSONSchemaFormExternalOptions {
      * @default true
      */
     applySchemaDefaults?: boolean;
+    /**
+     * Optional signal indicating whether the form is currently submitting.
+     * When provided, custom widgets can disable themselves during submission.
+     * This is passed through to custom widgets via ctx.submitting.
+     */
+    submitting?: Signal<boolean>;
 }
-export declare function JSONSchemaForm<T>({ schema, initialValue, externalSchemas, refResolver, sanitizeAdditional, validationMode, validateDebounceMs, customWidgets, applySchemaDefaults, }: JSONSchemaFormProps<T>, fn: ({ Form, controller, setStatus, }: {
+export declare function JSONSchemaForm<T>({ schema, initialValue, externalSchemas, refResolver, sanitizeAdditional, validationMode, validateDebounceMs, customWidgets, applySchemaDefaults, submitting, }: JSONSchemaFormProps<T>, fn: ({ Form, controller, setStatus, }: {
     Form: Renderable;
     controller: Controller<T>;
     setStatus: (result: ControllerValidation) => void;

package/dist/types/components/json-schema/schema-context.d.ts

@@ -1,6 +1,9 @@
 import type Ajv from 'ajv';
+import type { Signal } from '@tempots/dom';
 import type { JSONSchemaDefinition, JSONSchemaType, SchemaConflict, NotViolation } from './schema-types';
 import type { WidgetRegistry } from './widgets/widget-customization';
+import type { ControllerValidation } from '../form/controller/controller-validation';
+import type { ValidationMode } from '../form/controller/union-controller';
 export type { JSONSchema, JSONSchemaDefinition, JSONSchemaType, SchemaConflict, AllOfMergeResult, NotViolation, } from './schema-types';
 export { mergeAllOf } from './schema-merge';
 export { evaluateNotViolation, composeEffectiveObjectSchema, evaluateIfThenElseOverlay, getEvaluatedProperties, } from './schema-conditionals';
@@ -15,6 +18,26 @@ export type SchemaContextOptions = {
     schemaConflicts?: readonly SchemaConflict[];
     notViolations?: readonly NotViolation[];
     widgetRegistry?: WidgetRegistry;
+    /**
+     * Function to set the form's validation status.
+     * Available for custom widgets that need to perform their own validation.
+     */
+    setStatus?: (status: ControllerValidation) => void;
+    /**
+     * Signal containing the entire form's current value.
+     * Useful for cross-field validation or conditional rendering.
+     */
+    formValue?: Signal<unknown>;
+    /**
+     * Current validation mode ('eager', 'onTouched', 'onSubmit').
+     * Custom widgets may want to behave differently based on this.
+     */
+    validationMode?: ValidationMode;
+    /**
+     * Signal indicating whether the form is currently submitting.
+     * Widgets should typically disable during submission.
+     */
+    submitting?: Signal<boolean>;
 };
 export declare class SchemaContext {
     readonly schema: JSONSchemaDefinition;
@@ -27,6 +50,26 @@ export declare class SchemaContext {
     readonly schemaConflicts: readonly SchemaConflict[];
     readonly notViolations: readonly NotViolation[];
     readonly widgetRegistry: WidgetRegistry | undefined;
+    /**
+     * Function to set the form's validation status.
+     * Available for custom widgets that need to perform their own validation.
+     */
+    readonly setStatus: ((status: ControllerValidation) => void) | undefined;
+    /**
+     * Signal containing the entire form's current value.
+     * Useful for cross-field validation or conditional rendering.
+     */
+    readonly formValue: Signal<unknown> | undefined;
+    /**
+     * Current validation mode ('eager', 'onTouched', 'onSubmit').
+     * Custom widgets may want to behave differently based on this.
+     */
+    readonly validationMode: ValidationMode | undefined;
+    /**
+     * Signal indicating whether the form is currently submitting.
+     * Widgets should typically disable during submission.
+     */
+    readonly submitting: Signal<boolean> | undefined;
     constructor(options: SchemaContextOptions);
     readonly with: (options: Partial<SchemaContextOptions>) => SchemaContext;
     readonly append: (segment: PropertyKey) => SchemaContext;

package/dist/types/components/json-schema/widgets/widget-customization.d.ts

@@ -1,7 +1,8 @@
-import type { Renderable } from '@tempots/dom';
-import type { Controller } from '../../form';
+import type { Renderable, Signal } from '@tempots/dom';
+import type { Controller, ControllerValidation } from '../../form';
 import type { SchemaContext, JSONSchema } from '../schema-context';
 import { type ResolvedWidget } from './utils';
+import type { ValidationMode } from '../../form/controller/union-controller';
 /**
  * Widget factory function signature
  */
@@ -9,6 +10,28 @@ export type WidgetFactory<T = unknown> = (props: {
     controller: Controller<T>;
     ctx: SchemaContext;
     options?: Record<string, unknown>;
+    /**
+     * Function to set the form's validation status.
+     * Use this for advanced widgets that need custom validation.
+     * Also available via `ctx.setStatus`.
+     */
+    setStatus?: (status: ControllerValidation) => void;
+    /**
+     * Signal containing the entire form's current value.
+     * Useful for cross-field validation or conditional rendering.
+     * Also available via `ctx.formValue`.
+     */
+    formValue?: Signal<unknown>;
+    /**
+     * Current validation mode ('eager', 'onTouched', 'onSubmit').
+     * Also available via `ctx.validationMode`.
+     */
+    validationMode?: ValidationMode;
+    /**
+     * Signal indicating whether the form is currently submitting.
+     * Also available via `ctx.submitting`.
+     */
+    submitting?: Signal<boolean>;
 }) => Renderable;
 /**
  * Widget registration entry

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tempots/beatui",
-  "version": "0.75.0",
+  "version": "0.76.0",
   "type": "module",
   "main": "dist/index.umd.js",
   "module": "dist/index.es.js",