xt-components 0.5.5 → 0.6.0

package/index.d.ts

@@ -1,10 +1,10 @@
 import * as _angular_core from '@angular/core';
 import { Signal, WritableSignal, InputSignal, OutputEmitterRef, Type, InjectionToken, AfterViewInit, OnInit } from '@angular/core';
 import { FormGroup, AbstractControl, FormBuilder } from '@angular/forms';
-import { XtTypeInfo, XtTypeResolver, XtTypeHandler, MappingHelper } from 'xt-type';
+import { XtTypeInfo, XtTypeReference, XtTypeResolver, XtTypeHandler, MappingHelper } from 'xt-type';
 import * as xt_components from 'xt-components';
-import { NgComponentOutlet } from '@angular/common';
 import { Observable } from 'rxjs';
+import { NgComponentOutlet } from '@angular/common';
 
 type XtComponentInfo<T> = {
     componentName: string;
@@ -57,6 +57,24 @@ type XtContext<T> = {
     subName?: string;
     parentFormGroup?: FormGroup;
     localFormGroup?: FormGroup;
+    /**
+     * When the value in the context is a reference to another type
+     */
+    reference?: XtTypeReference;
+    /**
+     * If it's a reference, we keep the context referenced
+     */
+    referencedContext?: XtContext<any>;
+    /**
+     * creates the referencedContext by using this referenced value
+     * @param val
+     *
+    updateReferencedContext(val: any, valueType?:string): void;*/
+    /**
+     * Signal when all the asynchronously defined subreferences are resolved.
+     *
+    subReferencesResolved: WritableSignal<boolean>;
+  */
     parentContext?: XtContext<any>;
     isInForm(): boolean;
     formGroup(): FormGroup | undefined;
@@ -72,6 +90,8 @@ type XtContext<T> = {
     valueType?: string;
     toString(): string;
     listActions: WritableSignal<XtAction<T>[] | null>;
+    isReference(): boolean;
+    setReferenceInfo(ref: XtTypeReference): void;
 };
 type XtDisplayMode = 'INLINE_VIEW' | 'FULL_VIEW' | 'FULL_EDITABLE' | 'LIST_VIEW';
 declare class XtBaseContext<T> implements XtContext<T> {
@@ -98,6 +118,14 @@ declare class XtBaseContext<T> implements XtContext<T> {
      */
     nonFormValue?: WritableSignal<T | null>;
     valueType?: string;
+    /**
+     * When the value in the context is a reference to another type
+     */
+    reference?: XtTypeReference;
+    /**
+     * If it's a reference, we keep the context referenced
+     *
+    referencedContext?:XtContext<any>;*/
     /**
      * Keeps track of all the possible actions for this context
      * @protected
@@ -131,6 +159,23 @@ declare class XtBaseContext<T> implements XtContext<T> {
     elementSetContext(elementIndex: number): XtContext<any>;
     subContext(subName: string | undefined | null, subType?: string, typeResolver?: XtTypeResolver | null): XtContext<any>;
     formGroup(): FormGroup | undefined;
+    isReference(): boolean;
+    setReferenceInfo(reference: XtTypeReference): void;
+    /**
+     * creates the referencedContext by using this referenced value
+     * @param val
+     *
+    updateReferencedContext(val: any, valueType?:string): void {
+      if (!this.isReference()) throw new Error ('This context '+this.toString()+' is not a reference.');
+  
+      if( this.referencedContext==null) {
+        let refDisplayMode = 'INLINE_VIEW' as XtDisplayMode;
+        if (this.displayMode=='FULL_VIEW') refDisplayMode = 'FULL_VIEW';
+        this.referencedContext = new XtBaseContext(refDisplayMode);
+      }
+      this.referencedContext.setDisplayValue(val);
+      if( valueType!=null) this.referencedContext.valueType=valueType;
+    }*/
     toString(): string;
 }
 
@@ -191,6 +236,11 @@ declare class XtPluginRegistry {
     static readonly ANY_OBJECT_TYPE = "ANY_OBJECT_TYPE";
     static readonly ANY_PRIMITIVE_SET = "ANY_PRIMITIVE_SET";
     static readonly ANY_OBJECT_SET = "ANY_OBJECT_SET";
+    /**
+     * Whenever a component can handle any type of reference to a single entity or to multiple entities.
+     */
+    static readonly ANY_SINGLE_REFERENCE = "ANY_SINGLE_REFERENCE";
+    static readonly ANY_MULTIPLE_REFERENCE = "ANY_MULTIPLE_REFERENCE";
     registerPlugin(info: XtPluginInfo): void;
     registerComponent<T>(info: XtComponentInfo<T>): void;
     findComponentsForType<T>(valueType: string | null | undefined, value?: T): XtComponentInfo<any>[];
@@ -205,6 +255,75 @@ declare class XtPluginRegistry {
     }[];
 }
 
+/**
+ * Wrapper around xt-store manager: You can use it to check if xt-store is included or not, and decide what to do
+ *
+ * This allows plugins to potentially use xt-store whenever included in the applications running the plugin
+ */
+
+declare class StoreSupport {
+    protected static testStoreManager?: IStoreManager;
+    static isStoreManagerAvailable(): boolean;
+    static getStoreManager(): IStoreManager;
+    static setTestStoreManager(testStoreManager: IStoreManager): void;
+    static newStoreCriteria(name: string, value: any, operator?: IStoreCriteriaOperator): IStoreCriteria;
+}
+/**
+ * Interface definition for xt-store component.
+ * We re-define them here to avoid importing xt-store in all plugins that don't need it.
+ */
+interface IDataTransformer<T> {
+    /**
+     * Enable transformation of data right after it has been loaded from the store
+     * @param source
+     */
+    postLoadingTransformation(source: any[]): T[];
+}
+interface IDocumentInfo {
+    documentName: string;
+    isUrl: boolean;
+    documentId?: string;
+}
+type IStoreCriteriaOperator = '=' | '<' | '<=';
+interface IStoreCriteria {
+    name: string;
+    value: any;
+    operator: IStoreCriteriaOperator;
+}
+interface IStoreProvider<T> {
+    storeEntity(name: string, entity: T): Promise<T>;
+    /**
+     * Rejects the promise if the entity is not found
+     * @param name
+     * @param key
+     */
+    safeLoadEntity(name: string, key: any): Promise<T>;
+    loadEntity(name: string, key: any): Promise<T | undefined>;
+    deleteEntity(name: string, key: any): Promise<boolean>;
+    searchEntities(name: string, ...criteria: IStoreCriteria[]): Observable<Array<T>>;
+    searchAndPrepareEntities(name: string, sort?: any, groupBy?: any, transformer?: IDataTransformer<T>, ...criteria: any[]): Observable<any>;
+    canStoreDocument(): boolean;
+    /**
+     * Upload one document to a server store and returns the url or the id needed to retrieve them.
+     * @param toStore
+     * @param position
+     */
+    storeDocument(toStore: File): Promise<IDocumentInfo>;
+    /**
+     * Upload documents to a server store and returns the url or the id needed to retrieve them.
+     * @param toStore
+     * @param position
+     */
+    storeDocuments(toStore: File[]): Observable<IDocumentInfo>;
+}
+interface IStoreManager {
+    getProvider<T = never>(name?: string): IStoreProvider<T> | undefined;
+    getProviderSafe<T = never>(name?: string): IStoreProvider<T>;
+    getDefaultProvider<T = never>(): IStoreProvider<T> | undefined;
+    getDefaultProviderSafe<T = never>(): IStoreProvider<T>;
+    newStoreCriteria(name: string, value: any, operator: IStoreCriteriaOperator): IStoreCriteria;
+}
+
 /**
  * An all in one helper class, enabling manipulation of the context, with data and type associated with it.
  */
@@ -263,6 +382,13 @@ declare class XtResolverService {
      */
     safeDuplicate<T>(context: XtContext<T>, value: T): T;
     resolveMappingOf<U, T>(context: XtContext<T>, targetType: string, value?: T): MappingHelper<U, T> | undefined;
+    resolveReferencedValue<T, U>(context: XtContext<T>, storeMgr: IStoreManager): Promise<U | U[] | null | undefined>;
+    resolvePendingReferences(): void;
+    /**
+     * Calculates the values that can be referenced by the reference & value of this context
+     * @param context
+     */
+    findPossibleReferences<T, U>(context: XtContext<T>): Observable<U[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<XtResolverService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<XtResolverService>;
 }
@@ -325,6 +451,7 @@ declare class XtRenderComponent<T> implements AfterViewInit {
     outlet: Signal<NgComponentOutlet<any>>;
     constructor();
     context: Signal<XtContext<any>>;
+    realContext: Signal<XtContext<any>>;
     type: Signal<Type<XtComponent<T>> | null>;
     /**
      * Transfers the input and outputs from the host to the rendered component
@@ -346,6 +473,7 @@ declare class XtRenderSubComponent<T> implements AfterViewInit {
     outputs: _angular_core.OutputEmitterRef<XtComponentOutput>;
     outlet: Signal<NgComponentOutlet<any>>;
     resolverService: XtResolverService;
+    realContext: Signal<XtContext<T>>;
     type: Signal<Type<XtComponent<T>> | null>;
     /**
      * Transfers the input and outputs from the host to the rendered component
@@ -417,67 +545,6 @@ declare class XtMessageHandler {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<XtMessageHandler>;
 }
 
-/**
- * Wrapper around xt-store manager: You can use it to check if xt-store is included or not, and decide what to do
- *
- * This allow plugins to potentially use xt-store whenever included in the applications running the plugin
- */
-
-declare class StoreSupport {
-    protected static testStoreManager?: IStoreManager;
-    static isStoreManagerAvailable(): boolean;
-    static getStoreManager(): IStoreManager;
-    static setTestStoreManager(testStoreManager: IStoreManager): void;
-}
-/**
- * Interface definition for xt-store component.
- * We re-define them here to avoid importing xt-store in all plugins that don't need it.
- */
-interface IDataTransformer<T> {
-    /**
-     * Enable transformation of data right after it has been loaded from the store
-     * @param source
-     */
-    postLoadingTransformation(source: any[]): T[];
-}
-interface IDocumentInfo {
-    documentName: string;
-    isUrl: boolean;
-    documentId?: string;
-}
-interface IStoreProvider<T> {
-    storeEntity(name: string, entity: T): Promise<T>;
-    /**
-     * Rejects the promise if the entity is not found
-     * @param name
-     * @param key
-     */
-    safeLoadEntity(name: string, key: any): Promise<T>;
-    loadEntity(name: string, key: any): Promise<T | undefined>;
-    deleteEntity(name: string, key: any): Promise<boolean>;
-    searchEntities(name: string, ...criteria: any[]): Observable<Array<T>>;
-    searchAndPrepareEntities(name: string, sort?: any, groupBy?: any, transformer?: IDataTransformer<T>, ...criteria: any[]): Observable<any>;
-    canStoreDocument(): boolean;
-    /**
-     * Upload one document to a server store and returns the url or the id needed to retrieve them.
-     * @param toStore
-     * @param position
-     */
-    storeDocument(toStore: File): Promise<IDocumentInfo>;
-    /**
-     * Upload documents to a server store and returns the url or the id needed to retrieve them.
-     * @param toStore
-     * @param position
-     */
-    storeDocuments(toStore: File[]): Observable<IDocumentInfo>;
-}
-interface IStoreManager {
-    getProvider<T = never>(name?: string): IStoreProvider<T> | undefined;
-    getProviderSafe<T = never>(name?: string): IStoreProvider<T>;
-    getDefaultProvider<T = never>(): IStoreProvider<T> | undefined;
-    getDefaultProviderSafe<T = never>(): IStoreProvider<T>;
-}
-
 declare function attachToFormGroup(formGroup: FormGroup, controlName: string, value: any, valueType?: string, resolver?: XtTypeResolver): void;
 declare function updateFormGroupWithValue(formGroup: FormGroup, value: {
     [key: string]: any;
@@ -566,6 +633,7 @@ declare class TestStoreManager implements IStoreManager {
     getProviderSafe<T = never>(name?: string): IStoreProvider<T>;
     getDefaultProvider<T = never>(): IStoreProvider<T> | undefined;
     getDefaultProviderSafe<T = never>(): IStoreProvider<T>;
+    newStoreCriteria(name: string, value: any, operator: IStoreCriteriaOperator): IStoreCriteria;
 }
 declare class TestStoreProvider<T = never> implements IStoreProvider<T> {
     protected data: Map<string, Map<string, any>>;
@@ -575,7 +643,7 @@ declare class TestStoreProvider<T = never> implements IStoreProvider<T> {
     safeLoadEntity(name: string, key: any): Promise<T>;
     loadEntity(name: string, key: any): Promise<T | undefined>;
     deleteEntity(name: string, key: any): Promise<boolean>;
-    searchEntities(name: string, ...criteria: any[]): Observable<T[]>;
+    searchEntities(name: string, ...criteria: TestStoreCriteria[]): Observable<T[]>;
     searchAndPrepareEntities(name: string, sort?: any, groupBy?: any, transformer?: IDataTransformer<T> | undefined, ...criteria: any[]): Observable<any>;
     canStoreDocument(): boolean;
     storeDocument(toStore: File): Promise<IDocumentInfo>;
@@ -587,6 +655,13 @@ declare class TestDocumentInfo implements IDocumentInfo {
     documentId?: string;
     constructor(documentName: string, isUrl: boolean, documentId?: string);
 }
+declare class TestStoreCriteria implements IStoreCriteria {
+    name: string;
+    value: any;
+    operator: '=' | '<=' | '<';
+    constructor(name: string, value: any, operator?: IStoreCriteriaOperator);
+    filter(toFilter: any): boolean;
+}
 
-export { HostTestFormComponent, HostTestSimpleComponent, HostTestTypedComponent, HostTestTypedFormComponent, StoreSupport, StoreTestHelper, TestDocumentInfo, TestStoreManager, TestStoreProvider, XT_REGISTRY_TOKEN, XT_RESOLVER_TOKEN, XT_TYPE_RESOLVER_TOKEN, XtBaseContext, XtCompositeComponent, XtMessageHandler, XtPluginRegistry, XtRenderComponent, XtRenderSubComponent, XtResolvedComponent, XtResolverService, XtSimpleComponent, XtUnitTestHelper, attachToFormGroup, initXtPluginRegistry, updateFormGroupWithValue, xtPluginRegistry };
-export type { IDataTransformer, IDocumentInfo, IStoreManager, IStoreProvider, XtActionHandler, XtActionHandlerInfo, XtActionInfo, XtActionResult, XtComponent, XtComponentInfo, XtComponentInput, XtComponentOutput, XtContext, XtDisplayMode, XtInputType, XtOutputType, XtPluginInfo, XtResolver, XtTypeHandlerInfo };
+export { HostTestFormComponent, HostTestSimpleComponent, HostTestTypedComponent, HostTestTypedFormComponent, StoreSupport, StoreTestHelper, TestDocumentInfo, TestStoreCriteria, TestStoreManager, TestStoreProvider, XT_REGISTRY_TOKEN, XT_RESOLVER_TOKEN, XT_TYPE_RESOLVER_TOKEN, XtBaseContext, XtCompositeComponent, XtMessageHandler, XtPluginRegistry, XtRenderComponent, XtRenderSubComponent, XtResolvedComponent, XtResolverService, XtSimpleComponent, XtUnitTestHelper, attachToFormGroup, initXtPluginRegistry, updateFormGroupWithValue, xtPluginRegistry };
+export type { IDataTransformer, IDocumentInfo, IStoreCriteria, IStoreCriteriaOperator, IStoreManager, IStoreProvider, XtActionHandler, XtActionHandlerInfo, XtActionInfo, XtActionResult, XtComponent, XtComponentInfo, XtComponentInput, XtComponentOutput, XtContext, XtDisplayMode, XtInputType, XtOutputType, XtPluginInfo, XtResolver, XtTypeHandlerInfo };

package/package.json

@@ -1,6 +1,9 @@
 {
   "name": "xt-components",
-  "version": "0.5.5",
+  "version": "0.6.0",
+  "repository": {
+    "url": "https://github.com/dont-code/ng-xtend.git"
+  },
   "peerDependencies": {
     "@angular/animations": "^20.2.3",
     "@angular/common": "^20.2.3",