@elle96/ng-json-schema-manager 0.1.3 → 0.2.0

package/index.d.ts

@@ -1,6 +1,6 @@
-import { AbstractControl, FormGroup, FormArray, FormControl } from '@angular/forms';
+import { AbstractControl, ControlValueAccessor, FormGroup, FormArray, FormControl } from '@angular/forms';
 import * as i0 from '@angular/core';
-import { OnChanges, OnDestroy, EventEmitter, SimpleChanges, OnInit, ChangeDetectorRef } from '@angular/core';
+import { OnChanges, ElementRef, Renderer2, SimpleChanges, OnDestroy, EventEmitter, ChangeDetectorRef, OnInit } from '@angular/core';
 import { ErrorObject } from 'ajv';
 
 type JsonSchemaType = 'string' | 'number' | 'integer' | 'boolean' | 'object' | 'array' | 'null';
@@ -132,14 +132,67 @@ declare class JsonSchemaStylesService {
     static ɵprov: i0.ɵɵInjectableDeclaration<JsonSchemaStylesService>;
 }
 
+/** Character shown between the integer and decimal part of a number. */
+type DecimalSeparator = '.' | ',';
+/**
+ * Options shared by every node of a form. Provided by `jsm-json-schema-form`, so each form instance has its own.
+ */
+declare class JsonSchemaFormOptions {
+    decimalSeparator: DecimalSeparator;
+    static ɵfac: i0.ɵɵFactoryDeclaration<JsonSchemaFormOptions, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<JsonSchemaFormOptions>;
+}
+/**
+ * Keeps digits, a leading minus and a single decimal separator (written with `separator`);
+ * `,` and `.` are both accepted as input.
+ */
+declare function sanitizeNumericText(text: string, separator: DecimalSeparator): string;
+/** Text → model: empty → `null`, a complete number → number, anything else stays a string (validation reports it). */
+declare function parseNumericText(text: string): number | string | null;
+/** Model → text shown in the input. */
+declare function formatNumeric(value: unknown, separator: DecimalSeparator): string;
+/** Shows decimals with the configured separator inside messages ("must be >= 0.1" → "must be >= 0,1"). */
+declare function localizeNumbers(message: string, separator: DecimalSeparator): string;
+/**
+ * `ControlValueAccessor` for `number`/`integer` fields. The input is a text field (`inputmode="decimal"`), so the
+ * decimal comma is accepted, and the model always holds a JSON number once the text is a complete number.
+ * It never writes to the control while rendering or when the text is unchanged.
+ */
+declare class NumericInputDirective implements ControlValueAccessor, OnChanges {
+    private readonly _el;
+    private readonly _renderer;
+    jsmDecimalSeparator: DecimalSeparator;
+    private _model;
+    private _onChange;
+    private _onTouched;
+    constructor(_el: ElementRef<HTMLInputElement>, _renderer: Renderer2);
+    private _show;
+    ngOnChanges(changes: SimpleChanges): void;
+    writeValue(value: unknown): void;
+    registerOnChange(fn: (value: unknown) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    onInput(): void;
+    onBlur(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NumericInputDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NumericInputDirective, "input[jsmNumeric]", never, { "jsmDecimalSeparator": { "alias": "jsmDecimalSeparator"; "required": false; }; }, {}, never, never, true, never>;
+}
+
 declare class JsonSchemaFormComponent implements OnChanges, OnDestroy {
     private readonly schemaService;
     private readonly resolver;
     private readonly validation;
+    private readonly cdr;
+    private readonly options;
     schema: JsonSchema;
     value?: unknown;
     data?: unknown;
     allowAdditionalProperties: boolean;
+    /**
+     * Decimal separator of number/integer fields. `,` shows and accepts `0,5` (both `,` and `.` are accepted as input
+     * either way); the emitted value is always a JSON number.
+     */
+    decimalSeparator: DecimalSeparator;
     formReady: EventEmitter<FormGroup<any>>;
     valueChange: EventEmitter<unknown>;
     schemaReady: EventEmitter<JsonSchema>;
@@ -150,22 +203,31 @@ declare class JsonSchemaFormComponent implements OnChanges, OnDestroy {
     errorsMap: Map<string, string[]>;
     schemaErrorList: SchemaError[];
     loading: boolean;
+    /** When true, all field errors are shown regardless of touched/dirty state. */
+    showErrors: boolean;
     private valueSub?;
-    constructor(schemaService: JsonSchemaFormService, resolver: JsonSchemaResolverService, validation: JsonSchemaValidationService, stylesService: JsonSchemaStylesService);
+    constructor(schemaService: JsonSchemaFormService, resolver: JsonSchemaResolverService, validation: JsonSchemaValidationService, cdr: ChangeDetectorRef, options: JsonSchemaFormOptions, stylesService: JsonSchemaStylesService);
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
+    /**
+     * Marks all fields as touched and forces error display across the entire form.
+     * Call this from an external "Save" or "Submit" button to show all validation errors at once.
+     * Returns true if the form is valid, false otherwise.
+     */
+    validate(): boolean;
     private buildForm;
     private updateErrors;
     onRootReplaced(control: AbstractControl): void;
     private attachValueSub;
     static ɵfac: i0.ɵɵFactoryDeclaration<JsonSchemaFormComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<JsonSchemaFormComponent, "jsm-json-schema-form", never, { "schema": { "alias": "schema"; "required": true; }; "value": { "alias": "value"; "required": false; }; "data": { "alias": "data"; "required": false; }; "allowAdditionalProperties": { "alias": "allowAdditionalProperties"; "required": false; }; }, { "formReady": "formReady"; "valueChange": "valueChange"; "schemaReady": "schemaReady"; "schemaErrors": "schemaErrors"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<JsonSchemaFormComponent, "jsm-json-schema-form", never, { "schema": { "alias": "schema"; "required": true; }; "value": { "alias": "value"; "required": false; }; "data": { "alias": "data"; "required": false; }; "allowAdditionalProperties": { "alias": "allowAdditionalProperties"; "required": false; }; "decimalSeparator": { "alias": "decimalSeparator"; "required": false; }; }, { "formReady": "formReady"; "valueChange": "valueChange"; "schemaReady": "schemaReady"; "schemaErrors": "schemaErrors"; }, never, never, true, never>;
 }
 
 declare class JsonSchemaNodeComponent implements OnInit, OnDestroy {
     private readonly schemaService;
     private readonly validation;
     private readonly cdr;
+    private readonly options;
     schema: JsonSchema;
     control: AbstractControl;
     label: string;
@@ -175,20 +237,29 @@ declare class JsonSchemaNodeComponent implements OnInit, OnDestroy {
     parent?: FormGroup | FormArray;
     controlKey?: string | number;
     allowAdditionalProperties: boolean;
+    /** When true, errors are shown regardless of touched/dirty state (e.g. triggered by an external save button). */
+    showErrors: boolean;
     controlReplaced: EventEmitter<AbstractControl<any, any, any>>;
     selectedOneOf: number;
     selectedAnyOf: Set<number>;
     newPropertyKey: string;
     propertyError: string;
+    /** Tracks whether this primitive control has been touched (for OnPush CD). */
+    isTouched: boolean;
     private valueSub?;
-    constructor(schemaService: JsonSchemaFormService, validation: JsonSchemaValidationService, cdr: ChangeDetectorRef);
+    constructor(schemaService: JsonSchemaFormService, validation: JsonSchemaValidationService, cdr: ChangeDetectorRef, options: JsonSchemaFormOptions | null);
     ngOnInit(): void;
     ngOnDestroy(): void;
+    /** Called on blur of primitive inputs to trigger CD after Angular marks the control as touched. */
+    onBlur(): void;
     isSimpleChild(key: string): boolean;
     badgeClass(badge: string): string;
     get nodeKind(): 'oneOf' | 'anyOf' | 'allOf' | 'object' | 'array' | 'primitive';
     get resolvedType(): JsonSchema['type'] | 'enum';
-    get inputKind(): 'text' | 'textarea' | 'select' | 'checkbox';
+    get decimalSeparator(): DecimalSeparator;
+    /** `multipleOf` of this node's own schema, exposed as step metadata. */
+    get numericStep(): string;
+    get inputKind(): 'text' | 'number' | 'textarea' | 'select' | 'checkbox';
     get inputType(): string;
     get controlAsGroup(): FormGroup;
     get controlAsFormControl(): FormControl;
@@ -199,6 +270,8 @@ declare class JsonSchemaNodeComponent implements OnInit, OnDestroy {
     get complexKeys(): string[];
     get canAddProperty(): boolean;
     get errorsForPath(): string[];
+    /** Combined errors: Ajv errors from errorsMap + Angular validator errors on the control. */
+    get allErrors(): string[];
     get metaBadges(): string[];
     get activeVariant(): JsonSchema | null;
     get mergedAllOf(): JsonSchema[];
@@ -220,8 +293,8 @@ declare class JsonSchemaNodeComponent implements OnInit, OnDestroy {
     private applyConditional;
     private applyDependencies;
     private mergeSchemas;
-    static ɵfac: i0.ɵɵFactoryDeclaration<JsonSchemaNodeComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<JsonSchemaNodeComponent, "jsm-schema-node", never, { "schema": { "alias": "schema"; "required": true; }; "control": { "alias": "control"; "required": true; }; "label": { "alias": "label"; "required": false; }; "required": { "alias": "required"; "required": false; }; "path": { "alias": "path"; "required": false; }; "errorsMap": { "alias": "errorsMap"; "required": false; }; "parent": { "alias": "parent"; "required": false; }; "controlKey": { "alias": "controlKey"; "required": false; }; "allowAdditionalProperties": { "alias": "allowAdditionalProperties"; "required": false; }; }, { "controlReplaced": "controlReplaced"; }, never, never, true, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<JsonSchemaNodeComponent, [null, null, null, { optional: true; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<JsonSchemaNodeComponent, "jsm-schema-node", never, { "schema": { "alias": "schema"; "required": true; }; "control": { "alias": "control"; "required": true; }; "label": { "alias": "label"; "required": false; }; "required": { "alias": "required"; "required": false; }; "path": { "alias": "path"; "required": false; }; "errorsMap": { "alias": "errorsMap"; "required": false; }; "parent": { "alias": "parent"; "required": false; }; "controlKey": { "alias": "controlKey"; "required": false; }; "allowAdditionalProperties": { "alias": "allowAdditionalProperties"; "required": false; }; "showErrors": { "alias": "showErrors"; "required": false; }; }, { "controlReplaced": "controlReplaced"; }, never, never, true, never>;
 }
 
 declare class JsonSchemaFormModule {
@@ -230,5 +303,16 @@ declare class JsonSchemaFormModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<JsonSchemaFormModule>;
 }
 
-export { JsonSchemaFormComponent, JsonSchemaFormModule, JsonSchemaFormService, JsonSchemaNodeComponent, JsonSchemaResolverService, JsonSchemaStylesService, JsonSchemaValidationService };
-export type { JsonSchema, JsonSchemaArray, JsonSchemaBase, JsonSchemaCombinators, JsonSchemaDraft, JsonSchemaObject, JsonSchemaPrimitive, JsonSchemaType, SchemaError, SchemaFieldContext };
+/**
+ * Coerces values to the types declared by the schema so that the emitted value respects it:
+ * - `number`/`integer` numeric strings become JSON numbers (comma or dot as separator);
+ * - empty numeric values (`""`, whitespace, `null`) leave the key absent, never `""` or `0`;
+ * - integers with decimals are converted to their number but never truncated (validation reports them);
+ * - non-numeric strings are left unchanged (validation reports them).
+ * Descends into properties, patternProperties, additionalProperties, items, prefixItems and combinators.
+ * The same function feeds both the Ajv validation and the emitted value.
+ */
+declare function normalizeValue(schema: JsonSchema, value: unknown): unknown;
+
+export { JsonSchemaFormComponent, JsonSchemaFormModule, JsonSchemaFormOptions, JsonSchemaFormService, JsonSchemaNodeComponent, JsonSchemaResolverService, JsonSchemaStylesService, JsonSchemaValidationService, NumericInputDirective, formatNumeric, localizeNumbers, normalizeValue, parseNumericText, sanitizeNumericText };
+export type { DecimalSeparator, JsonSchema, JsonSchemaArray, JsonSchemaBase, JsonSchemaCombinators, JsonSchemaDraft, JsonSchemaObject, JsonSchemaPrimitive, JsonSchemaType, SchemaError, SchemaFieldContext };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elle96/ng-json-schema-manager",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "description": "Angular JSON Schema form renderer with Tailwind styling, external $ref support, and reactive forms.",
   "homepage": "https://luigiellebalotta.github.io/json-schema-manager/",
   "repository": {