@expeed/ngx-data-mapper 1.0.0 → 1.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expeed/ngx-data-mapper",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Visual data mapping components for Angular - drag-and-drop field mapping with transformations, schema editor with JSON Schema export",
   "keywords": [
     "angular",

package/types/expeed-ngx-data-mapper.d.ts

@@ -1,5 +1,6 @@
 import * as _angular_core from '@angular/core';
 import { AfterViewInit, OnDestroy, EventEmitter, ElementRef, QueryList, OnInit, OnChanges, SimpleChanges } from '@angular/core';
+import { CdkDragDrop } from '@angular/cdk/drag-drop';
 
 interface SchemaField {
     id: string;
@@ -12,11 +13,15 @@ interface SchemaField {
     isArrayItem?: boolean;
     parentArrayPath?: string;
 }
-interface JsonSchema {
+interface SchemaDefinition {
     name: string;
     fields: SchemaField[];
 }
-type TransformationType = 'direct' | 'concat' | 'substring' | 'replace' | 'uppercase' | 'lowercase' | 'dateFormat' | 'extractYear' | 'extractMonth' | 'extractDay' | 'extractHour' | 'extractMinute' | 'extractSecond' | 'numberFormat' | 'template' | 'custom';
+type TransformationType = 'direct' | 'concat' | 'substring' | 'replace' | 'uppercase' | 'lowercase' | 'trim' | 'mask' | 'dateFormat' | 'extractYear' | 'extractMonth' | 'extractDay' | 'extractHour' | 'extractMinute' | 'extractSecond' | 'numberFormat' | 'template';
+interface TransformationCondition {
+    enabled: boolean;
+    root: FilterGroup;
+}
 interface TransformationConfig {
     type: TransformationType;
     separator?: string;
@@ -30,13 +35,14 @@ interface TransformationConfig {
     decimalPlaces?: number;
     prefix?: string;
     suffix?: string;
-    expression?: string;
+    pattern?: string;
+    condition?: TransformationCondition;
 }
 interface FieldMapping {
     id: string;
     sourceFields: SchemaField[];
     targetField: SchemaField;
-    transformation: TransformationConfig;
+    transformations: TransformationConfig[];
     isArrayMapping?: boolean;
     arrayMappingId?: string;
     isArrayToObjectMapping?: boolean;
@@ -93,7 +99,7 @@ interface Connection {
     mappingId: string;
     sourcePoints: ConnectionPoint[];
     targetPoint: ConnectionPoint;
-    transformation: TransformationConfig;
+    transformations: TransformationConfig[];
 }
 interface DragState {
     isDragging: boolean;
@@ -114,6 +120,78 @@ interface DefaultValue {
     valueType: 'string' | 'number' | 'boolean' | 'date';
 }
 
+/**
+ * Standard JSON Schema (draft-07) TypeScript interfaces
+ */
+interface JsonSchema {
+    $schema?: string;
+    $id?: string;
+    title?: string;
+    description?: string;
+    type?: JsonSchemaType | JsonSchemaType[];
+    properties?: Record<string, JsonSchema>;
+    items?: JsonSchema;
+    required?: string[];
+    enum?: (string | number | boolean | null)[];
+    const?: unknown;
+    default?: unknown;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    format?: string;
+    minimum?: number;
+    maximum?: number;
+    exclusiveMinimum?: number;
+    exclusiveMaximum?: number;
+    multipleOf?: number;
+    minItems?: number;
+    maxItems?: number;
+    uniqueItems?: boolean;
+    minProperties?: number;
+    maxProperties?: number;
+    additionalProperties?: boolean | JsonSchema;
+    allOf?: JsonSchema[];
+    anyOf?: JsonSchema[];
+    oneOf?: JsonSchema[];
+    not?: JsonSchema;
+    $ref?: string;
+    definitions?: Record<string, JsonSchema>;
+}
+type JsonSchemaType = 'string' | 'number' | 'integer' | 'boolean' | 'object' | 'array' | 'null';
+/**
+ * Helper type for working with JSON schemas in the UI
+ */
+interface JsonSchemaField {
+    name: string;
+    path: string;
+    schema: JsonSchema;
+    children?: JsonSchemaField[];
+    expanded?: boolean;
+}
+/**
+ * Convert JSON Schema to flat field list for UI rendering
+ */
+declare function schemaToFields(schema: JsonSchema, parentPath?: string): JsonSchemaField[];
+/**
+ * Get the simple type for display purposes
+ */
+declare function getSchemaType(schema: JsonSchema): string;
+/**
+ * Create an empty JSON Schema for a new schema definition
+ */
+declare function createEmptySchema(title?: string): JsonSchema;
+/**
+ * Add a property to a schema
+ */
+declare function addProperty(schema: JsonSchema, name: string, type: JsonSchemaType, options?: {
+    description?: string;
+    required?: boolean;
+}): JsonSchema;
+/**
+ * Remove a property from a schema
+ */
+declare function removeProperty(schema: JsonSchema, name: string): JsonSchema;
+
 declare class MappingService {
     private mappings;
     private arrayMappings;
@@ -150,7 +228,7 @@ declare class MappingService {
     updateArrayToObjectSelector(mappingId: string, selector: ArraySelectorConfig): void;
     removeArrayToObjectMapping(mappingId: string): void;
     updateMapping(mappingId: string, updates: Partial<FieldMapping>): void;
-    updateTransformation(mappingId: string, transformation: TransformationConfig): void;
+    updateTransformations(mappingId: string, transformations: TransformationConfig[]): void;
     removeMapping(mappingId: string): void;
     removeSourceFromMapping(mappingId: string, sourceFieldId: string): void;
     selectMapping(mappingId: string | null): void;
@@ -162,7 +240,11 @@ declare class MappingService {
     removeDefaultValue(targetFieldId: string): void;
     hasDefaultValue(targetFieldId: string): boolean;
     private getValueType;
-    exportMappings(): string;
+    exportMappings(name?: string, description?: string): string;
+    /**
+     * Export mappings as a MappingDocument object (not stringified)
+     */
+    exportMappingsAsObject(name?: string, description?: string): object;
     importMappings(json: string): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MappingService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<MappingService>;
@@ -170,18 +252,34 @@ declare class MappingService {
 
 declare class TransformationService {
     applyTransformation(sourceValues: Record<string, unknown>, sourceFields: SchemaField[], config: TransformationConfig): string;
+    /**
+     * Apply a transformation to a single value (for chained transformations)
+     */
+    applyTransformationToValue(value: unknown, config: TransformationConfig): string;
+    /**
+     * Apply multiple transformations in sequence, respecting conditions
+     */
+    applyTransformations(sourceValues: Record<string, unknown>, sourceFields: SchemaField[], transformations: TransformationConfig[]): string;
     private getValueByPath;
     private applyTemplate;
     private formatDate;
     private extractDatePart;
     private formatNumber;
-    private applyCustomExpression;
+    private applyMask;
     getTransformationLabel(type: TransformationType): string;
     getAvailableTransformations(): {
         type: TransformationType;
         label: string;
         category?: string;
     }[];
+    evaluateCondition(value: unknown, condition: FilterGroup): boolean;
+    private evaluateGroup;
+    private evaluateItem;
+    private evaluateConditionItem;
+    /**
+     * Check if a transformation's condition is met
+     */
+    isConditionMet(value: unknown, config: TransformationConfig): boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TransformationService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<TransformationService>;
 }
@@ -215,37 +313,21 @@ declare class SvgConnectorService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<SvgConnectorService>;
 }
 
-interface JsonSchemaDefinition {
-    type?: string;
-    format?: string;
-    properties?: Record<string, JsonSchemaDefinition>;
-    items?: JsonSchemaDefinition;
+interface SchemaDocument extends JsonSchema {
     $ref?: string;
-    description?: string;
-    enum?: string[];
-    required?: string[];
-    additionalProperties?: boolean | JsonSchemaDefinition;
-}
-interface SchemaDocument {
-    $ref?: string;
-    $defs?: Record<string, JsonSchemaDefinition>;
-    definitions?: Record<string, JsonSchemaDefinition>;
+    $defs?: Record<string, JsonSchema>;
     exclude?: string[];
     include?: string[];
-    properties?: Record<string, JsonSchemaDefinition>;
-    type?: string;
-    title?: string;
-    description?: string;
 }
 interface ModelRegistry {
-    [modelName: string]: JsonSchemaDefinition;
+    [modelName: string]: JsonSchema;
 }
 declare class SchemaParserService {
     private modelRegistry;
     private idCounter;
     registerModels(models: ModelRegistry): void;
     clearRegistry(): void;
-    parseSchema(schemaJson: string | SchemaDocument, schemaName?: string): JsonSchema;
+    parseSchema(schemaJson: string | SchemaDocument, schemaName?: string): SchemaDefinition;
     private resolveRef;
     private buildFields;
     private buildField;
@@ -317,8 +399,8 @@ interface VisualConnection {
     hasFilter: boolean;
 }
 declare class DataMapperComponent implements AfterViewInit, OnDestroy {
-    sourceSchema: JsonSchema;
-    targetSchema: JsonSchema;
+    set sourceSchema(value: JsonSchema | SchemaDocument);
+    set targetSchema(value: JsonSchema | SchemaDocument);
     sampleData: Record<string, unknown>;
     mappingsChange: EventEmitter<FieldMapping[]>;
     svgContainer: ElementRef<HTMLDivElement>;
@@ -326,6 +408,11 @@ declare class DataMapperComponent implements AfterViewInit, OnDestroy {
     private mappingService;
     private svgConnectorService;
     private transformationService;
+    private schemaParserService;
+    private _sourceSchemaInput;
+    private _targetSchemaInput;
+    readonly sourceSchemaForTree: _angular_core.Signal<SchemaDefinition>;
+    readonly targetSchemaForTree: _angular_core.Signal<SchemaDefinition>;
     private sourcePositions;
     private targetPositions;
     connections: _angular_core.WritableSignal<VisualConnection[]>;
@@ -374,7 +461,7 @@ declare class DataMapperComponent implements AfterViewInit, OnDestroy {
     onDefaultValueDelete(): void;
     closeDefaultValuePopover(): void;
     getExistingDefaultValue(fieldId: string): DefaultValue | undefined;
-    onPopoverSave(config: TransformationConfig): void;
+    onPopoverSave(transformations: TransformationConfig[]): void;
     onPopoverDelete(): void;
     closePopover(): void;
     private updateConnections;
@@ -399,14 +486,10 @@ interface EditorField {
     isEditing?: boolean;
     isEditingValues?: boolean;
 }
-interface SchemaDefinition {
-    name: string;
-    fields: EditorField[];
-}
 declare class SchemaEditorComponent {
-    set schema(value: SchemaDefinition | null);
-    schemaChange: EventEmitter<SchemaDefinition>;
-    save: EventEmitter<SchemaDefinition>;
+    set schema(value: JsonSchema | null);
+    schemaChange: EventEmitter<JsonSchema>;
+    save: EventEmitter<JsonSchema>;
     schemaName: _angular_core.WritableSignal<string>;
     fields: _angular_core.WritableSignal<EditorField[]>;
     fieldTypes: Array<{
@@ -443,6 +526,9 @@ declare class SchemaEditorComponent {
     onSchemaNameChange(name: string, input?: HTMLInputElement): void;
     private emitChange;
     onSave(): void;
+    private jsonSchemaToEditorFields;
+    private jsonSchemaPropertyToEditorField;
+    private jsonSchemaTypeToEditorType;
     toJson(): string;
     toJsonSchema(): object;
     private fieldToJsonSchema;
@@ -459,13 +545,15 @@ declare class TransformationPopoverComponent implements OnInit, OnChanges {
         y: number;
     };
     sampleData: Record<string, unknown>;
-    save: EventEmitter<TransformationConfig>;
+    save: EventEmitter<TransformationConfig[]>;
     delete: EventEmitter<void>;
     close: EventEmitter<void>;
     private transformationService;
-    transformationType: TransformationType;
-    config: TransformationConfig;
-    preview: string;
+    steps: TransformationConfig[];
+    stepPreviews: string[];
+    stepInputs: string[];
+    finalPreview: string;
+    expandedStepIndex: number;
     availableTransformations: {
         type: TransformationType;
         label: string;
@@ -474,15 +562,30 @@ declare class TransformationPopoverComponent implements OnInit, OnChanges {
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
     private initFromMapping;
-    onTypeChange(): void;
+    get isMultiStep(): boolean;
+    onStepTypeChange(index: number): void;
     private getDefaultTemplate;
+    addStep(): void;
+    removeStep(index: number): void;
+    onStepDrop(event: CdkDragDrop<TransformationConfig[]>): void;
+    toggleStep(index: number): void;
+    isStepExpanded(index: number): boolean;
     updatePreview(): void;
+    private getValueByPath;
     onConfigChange(): void;
     onSave(): void;
     onDelete(): void;
     onClose(): void;
     getSourceFieldNames(): string;
     getPopoverStyle(): Record<string, string>;
+    getStepTypeLabel(type: TransformationType): string;
+    hasCondition(step: TransformationConfig): boolean;
+    toggleCondition(step: TransformationConfig, enabled: boolean): void;
+    onConditionChange(step: TransformationConfig, group: FilterGroup): void;
+    private createEmptyConditionGroup;
+    getConditionSummary(step: TransformationConfig): string;
+    private summarizeConditionGroup;
+    private getOperatorLabel;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TransformationPopoverComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<TransformationPopoverComponent, "transformation-popover", never, { "mapping": { "alias": "mapping"; "required": false; }; "position": { "alias": "position"; "required": false; }; "sampleData": { "alias": "sampleData"; "required": false; }; }, { "save": "save"; "delete": "delete"; "close": "close"; }, never, never, true, never>;
 }
@@ -600,5 +703,5 @@ declare class DefaultValuePopoverComponent implements OnInit {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DefaultValuePopoverComponent, "default-value-popover", never, { "field": { "alias": "field"; "required": false; }; "existingValue": { "alias": "existingValue"; "required": false; }; "position": { "alias": "position"; "required": false; }; }, { "save": "save"; "delete": "delete"; "close": "close"; }, never, never, true, never>;
 }
 
-export { ArrayFilterModalComponent, ArraySelectorModalComponent, DataMapperComponent, DefaultValuePopoverComponent, MappingService, SchemaEditorComponent, SchemaParserService, SchemaTreeComponent, SvgConnectorService, TransformationPopoverComponent, TransformationService };
-export type { ArrayFilterConfig, ArrayMapping, ArraySelectionMode, ArraySelectorConfig, ArrayToObjectMapping, Connection, ConnectionPath, ConnectionPoint, DefaultValue, DragState, EditorField, FieldMapping, FieldPositionEvent, FilterCondition, FilterGroup, FilterItem, FilterOperator, JsonSchema, JsonSchemaDefinition, ModelRegistry, Point, SchemaDefinition, SchemaDocument, SchemaField, TransformationConfig, TransformationType };
+export { ArrayFilterModalComponent, ArraySelectorModalComponent, DataMapperComponent, DefaultValuePopoverComponent, MappingService, SchemaEditorComponent, SchemaParserService, SchemaTreeComponent, SvgConnectorService, TransformationPopoverComponent, TransformationService, addProperty, createEmptySchema, getSchemaType, removeProperty, schemaToFields };
+export type { ArrayFilterConfig, ArrayMapping, ArraySelectionMode, ArraySelectorConfig, ArrayToObjectMapping, Connection, ConnectionPath, ConnectionPoint, DefaultValue, DragState, FieldMapping, FieldPositionEvent, FilterCondition, FilterGroup, FilterItem, FilterOperator, JsonSchema, JsonSchemaField, JsonSchemaType, ModelRegistry, Point, SchemaDefinition, SchemaDocument, SchemaField, TransformationCondition, TransformationConfig, TransformationType };