xt-components 0.5.0 → 0.5.5

package/index.d.ts

@@ -1,11 +1,49 @@
 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 { XtTypeResolver, XtTypeInfo, XtTypeHandler } from 'xt-type';
+import { XtTypeInfo, XtTypeResolver, XtTypeHandler, MappingHelper } from 'xt-type';
 import * as xt_components from 'xt-components';
 import { NgComponentOutlet } from '@angular/common';
 import { Observable } from 'rxjs';
 
+type XtComponentInfo<T> = {
+    componentName: string;
+    componentClass: T;
+    typesHandled: string[];
+    outputs?: XtOutputType[];
+};
+type XtTypeHandlerInfo<T> = {
+    typesHandled: string[];
+    handlerClass: T;
+};
+type XtActionInfo<T> = {
+    description: string;
+    visible: boolean;
+    handlerClass: any;
+    iconUrl?: string;
+};
+type XtActionHandlerInfo<T> = {
+    types: string[];
+    actions: {
+        [name: string]: XtActionInfo<T>;
+    };
+};
+type XtPluginInfo = {
+    name: string;
+    uriLogo?: string;
+    components?: XtComponentInfo<any>[];
+    types?: XtTypeInfo;
+    typeHandlers?: XtTypeHandlerInfo<any>[];
+    actionHandlers?: XtActionHandlerInfo<any>[];
+};
+
+declare class XtAction<T> {
+    name: string;
+    info: XtActionInfo<T>;
+    enabled: _angular_core.WritableSignal<boolean>;
+    constructor(name: string, info: XtActionInfo<T>, enabled?: boolean);
+}
+
 /**
  * A XtContext provides all the necessary information for an ng-extended component to operate. It is passed from parent to child component and pass
  * - The display mode - View, Inline view or Edit
@@ -33,6 +71,7 @@ type XtContext<T> = {
     value(): T | null | undefined;
     valueType?: string;
     toString(): string;
+    listActions: WritableSignal<XtAction<T>[] | null>;
 };
 type XtDisplayMode = 'INLINE_VIEW' | 'FULL_VIEW' | 'FULL_EDITABLE' | 'LIST_VIEW';
 declare class XtBaseContext<T> implements XtContext<T> {
@@ -59,6 +98,11 @@ declare class XtBaseContext<T> implements XtContext<T> {
      */
     nonFormValue?: WritableSignal<T | null>;
     valueType?: string;
+    /**
+     * Keeps track of all the possible actions for this context
+     * @protected
+     */
+    listActions: WritableSignal<XtAction<T>[] | null>;
     /**
      *
      * @param displayMode
@@ -110,24 +154,6 @@ type XtComponentInput = {
     [key in XtInputType]: InputSignal<any> | undefined;
 };
 
-type XtComponentInfo<T> = {
-    componentName: string;
-    componentClass: T;
-    typesHandled: string[];
-    outputs?: XtOutputType[];
-};
-type XtTypeHandlerInfo<T> = {
-    typesHandled: string[];
-    handlerClass: T;
-};
-type XtPluginInfo = {
-    name: string;
-    uriLogo?: string;
-    components?: XtComponentInfo<any>[];
-    types?: XtTypeInfo;
-    typeHandlers?: XtTypeHandlerInfo<any>[];
-};
-
 declare class XtResolvedComponent {
     componentName: string;
     componentClass: any;
@@ -144,6 +170,7 @@ declare class XtPluginRegistry {
     pluginRegistry: Map<string, XtPluginInfo>;
     componentRegistry: Map<string, XtComponentInfo<any>>;
     componentByTypeCache: Map<string, XtComponentInfo<any>[]>;
+    protected actionByTypeRegistry: Map<string, Map<string, XtActionInfo<any>>>;
     listComponents: _angular_core.WritableSignal<XtComponentInfo<any>[]>;
     listPlugins: _angular_core.WritableSignal<XtPluginInfo[]>;
     /**
@@ -170,23 +197,17 @@ declare class XtPluginRegistry {
     static registry(): XtPluginRegistry;
     findComponentInfo(type: Type<XtComponent<any>>): XtComponentInfo<any> | null;
     getComponentInfo(type: Type<XtComponent<any>>): XtComponentInfo<any>;
+    registerActionHandler<T>(handlerInfo: XtActionHandlerInfo<T>): void;
+    findActionInfo<T>(type: string, actionName: string): XtActionInfo<T> | undefined;
+    listActionInfos<T>(type: string): {
+        name: string;
+        info: XtActionInfo<T>;
+    }[];
 }
 
 /**
- * The global plugin registry.
- * Plugins will register to this when loaded.
+ * An all in one helper class, enabling manipulation of the context, with data and type associated with it.
  */
-
-declare global {
-    var XT_REGISTRY: XtPluginRegistry;
-}
-declare function initXtPluginRegistry(): void;
-declare function xtPluginRegistry(): XtPluginRegistry;
-
-declare const XT_RESOLVER_TOKEN: InjectionToken<XtResolver>;
-declare const XT_TYPE_RESOLVER_TOKEN: InjectionToken<XtTypeResolver>;
-declare const XT_REGISTRY_TOKEN: InjectionToken<XtPluginRegistry>;
-
 declare class XtResolverService {
     pluginRegistry: xt_components.XtPluginRegistry;
     protected baseResolver: XtResolver | null;
@@ -204,6 +225,18 @@ declare class XtResolverService {
     listSubNamesOfType<T>(valueType: string, value?: T): string[];
     registerPlugin(info: XtPluginInfo): void;
     registerTypes(types: XtTypeInfo | undefined, handlers?: XtTypeHandlerInfo<any>[]): void;
+    /**
+     * Calculates all the possible actions for a given context
+     * @param context
+     * @param onlyVisible
+     */
+    possibleActions<T>(context: XtContext<T>, onlyVisible?: boolean): Array<XtAction<T>>;
+    /**
+     * Finds the possible action with the given name for the current type, and runs it in the current value.
+     * If the action is not possible in this context, try a parent context
+     * @param actionName
+     */
+    runAction<T>(context: XtContext<T>, actionName: string, storeMgr?: any): Promise<XtActionResult<any>>;
     protected handlerDefinedFor(newType: string, handlers: XtTypeHandlerInfo<any>[] | undefined): any;
     getComponentInfo<T>(type: Type<XtComponent<T>>): XtResolvedComponent;
     findComponentInfo<T>(type: Type<XtComponent<T>>): XtResolvedComponent | null;
@@ -216,10 +249,55 @@ declare class XtResolverService {
      * @returns a Promise with the module loaded and already registered.
      */
     loadPlugin(url: URL | string): Promise<any>;
+    /**
+     * Based on the type & value of the element, find which property is on its type and returns it's value
+     * @param context
+     * @param subPropertyType
+     * @param value
+     */
+    findSubPropertyWithType<T>(context: XtContext<T>, subPropertyType: string, value: T): any;
+    /**
+     * Creates a duplicate of an object, using our knowledge on its type given by the context
+     * @param context
+     * @param value
+     */
+    safeDuplicate<T>(context: XtContext<T>, value: T): T;
+    resolveMappingOf<U, T>(context: XtContext<T>, targetType: string, value?: T): MappingHelper<U, T> | undefined;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<XtResolverService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<XtResolverService>;
 }
 
+type XtActionResult<Type> = {
+    status: 'success' | 'error' | 'none';
+    warnings?: string[];
+    errors?: string[];
+    value?: Type | null;
+};
+type XtActionHandler<Type> = {
+    /**
+     * Runs an action on a item under the context
+     * @param context
+     * @param actionName
+     * @param store
+     */
+    runAction(context: XtContext<Type>, actionName: string, resolver: XtResolverService, storeMgr?: any): Promise<XtActionResult<Type>>;
+};
+
+/**
+ * The global plugin registry.
+ * Plugins will register to this when loaded.
+ */
+
+declare global {
+    var XT_REGISTRY: XtPluginRegistry;
+}
+declare function initXtPluginRegistry(): void;
+declare function xtPluginRegistry(): XtPluginRegistry;
+
+declare const XT_RESOLVER_TOKEN: InjectionToken<XtResolver>;
+declare const XT_TYPE_RESOLVER_TOKEN: InjectionToken<XtTypeResolver>;
+declare const XT_REGISTRY_TOKEN: InjectionToken<XtPluginRegistry>;
+
 declare class XtBaseOutput implements XtComponentOutput {
     valueSelected: OutputEmitterRef<any> | undefined;
 }
@@ -332,11 +410,11 @@ declare class XtCompositeComponent<T = any> extends XtSimpleComponent<T> {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<XtCompositeComponent<any>, "ng-component", never, {}, {}, never, never, true, never>;
 }
 
-declare class MessageHandler {
+declare class XtMessageHandler {
     errorOccurred(error: any, errorMsg?: string): void;
     warningOccurred(warningMsg?: string): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MessageHandler, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<MessageHandler>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<XtMessageHandler, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<XtMessageHandler>;
 }
 
 /**
@@ -491,8 +569,8 @@ declare class TestStoreManager implements IStoreManager {
 }
 declare class TestStoreProvider<T = never> implements IStoreProvider<T> {
     protected data: Map<string, Map<string, any>>;
-    protected getOrCreateArray(name: string): Map<string, any>;
-    protected extractKey(value: any): string;
+    protected getOrCreateArray(name: string): Map<string, T>;
+    protected extractKey(value: any, create?: boolean): string;
     storeEntity(name: string, entity: T): Promise<T>;
     safeLoadEntity(name: string, key: any): Promise<T>;
     loadEntity(name: string, key: any): Promise<T | undefined>;
@@ -510,5 +588,5 @@ declare class TestDocumentInfo implements IDocumentInfo {
     constructor(documentName: string, isUrl: boolean, documentId?: string);
 }
 
-export { HostTestFormComponent, HostTestSimpleComponent, HostTestTypedComponent, HostTestTypedFormComponent, MessageHandler, StoreSupport, StoreTestHelper, TestDocumentInfo, TestStoreManager, TestStoreProvider, XT_REGISTRY_TOKEN, XT_RESOLVER_TOKEN, XT_TYPE_RESOLVER_TOKEN, XtBaseContext, XtCompositeComponent, XtPluginRegistry, XtRenderComponent, XtRenderSubComponent, XtResolvedComponent, XtResolverService, XtSimpleComponent, XtUnitTestHelper, attachToFormGroup, initXtPluginRegistry, updateFormGroupWithValue, xtPluginRegistry };
-export type { IDataTransformer, IDocumentInfo, IStoreManager, IStoreProvider, XtComponent, XtComponentInfo, XtComponentInput, XtComponentOutput, XtContext, XtDisplayMode, XtInputType, XtOutputType, XtPluginInfo, XtResolver, XtTypeHandlerInfo };
+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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xt-components",
-  "version": "0.5.0",
+  "version": "0.5.5",
   "peerDependencies": {
     "@angular/animations": "^20.2.3",
     "@angular/common": "^20.2.3",