@elle96/ng-json-schema-manager 0.1.4 → 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, ChangeDetectorRef, SimpleChanges, OnInit } 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,15 +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>;
@@ -154,7 +206,7 @@ declare class JsonSchemaFormComponent implements OnChanges, OnDestroy {
     /** When true, all field errors are shown regardless of touched/dirty state. */
     showErrors: boolean;
     private valueSub?;
-    constructor(schemaService: JsonSchemaFormService, resolver: JsonSchemaResolverService, validation: JsonSchemaValidationService, cdr: ChangeDetectorRef, stylesService: JsonSchemaStylesService);
+    constructor(schemaService: JsonSchemaFormService, resolver: JsonSchemaResolverService, validation: JsonSchemaValidationService, cdr: ChangeDetectorRef, options: JsonSchemaFormOptions, stylesService: JsonSchemaStylesService);
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
     /**
@@ -165,22 +217,17 @@ declare class JsonSchemaFormComponent implements OnChanges, OnDestroy {
     validate(): boolean;
     private buildForm;
     private updateErrors;
-    /**
-     * Recursively coerces string values to numbers/booleans where the schema declares
-     * type "number" or "integer". This is needed because <input type="number"> always
-     * returns a string to Angular's FormControl, but Ajv validates against the JSON type.
-     */
-    private normalizeValue;
     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;
@@ -200,7 +247,7 @@ declare class JsonSchemaNodeComponent implements OnInit, OnDestroy {
     /** 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. */
@@ -209,7 +256,10 @@ declare class JsonSchemaNodeComponent implements OnInit, OnDestroy {
     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;
@@ -243,7 +293,7 @@ declare class JsonSchemaNodeComponent implements OnInit, OnDestroy {
     private applyConditional;
     private applyDependencies;
     private mergeSchemas;
-    static ɵfac: i0.ɵɵFactoryDeclaration<JsonSchemaNodeComponent, 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>;
 }
 
@@ -253,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.4",
+  "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": {