@masterteam/components 0.0.91 → 0.0.93

package/types/masterteam-components-business-fields.d.ts

@@ -0,0 +1,114 @@
+import * as _angular_core from '@angular/core';
+import { ControlValueAccessor, Validators, NgControl } from '@angular/forms';
+import { HttpContext } from '@angular/common/http';
+
+/**
+ * One source level inside connection configuration.
+ * Comes from `field.propertyMetadata.configuration.sourceLevels[]`
+ */
+interface ConnectionSourceLevel {
+    levelId: number;
+    levelKey: string;
+    name: {
+        en?: string;
+        ar?: string;
+        [k: string]: string | undefined;
+    };
+    connectionId: number;
+    isOptional: boolean;
+    allowManyToMany: boolean;
+    supportWeights: boolean;
+    optionsQuery: {
+        path: string;
+        method?: string;
+        query?: Record<string, any>;
+    };
+}
+/**
+ * Full connection configuration from `field.propertyMetadata.configuration`.
+ * This is passed as a single input to the component.
+ */
+interface SchemaConnectionConfig {
+    targetLevelId: number;
+    sourceLevelId?: number;
+    propertyKey?: string;
+    valueMode?: string;
+    sourceLevels: ConnectionSourceLevel[];
+    payloadTemplate?: {
+        levelId: number;
+        sources: any[];
+    };
+    sourceItemShape?: Record<string, string>;
+}
+/** One selected source in the connection payload */
+interface ConnectionSource {
+    sourceLevelId: number;
+    sourceLevelDataId: number;
+}
+/** The value shape for a connection field */
+interface ConnectionPayload {
+    levelId: number;
+    sources: ConnectionSource[];
+}
+/**
+ * Internal state tracked per source level dropdown.
+ */
+interface SourceLevelState {
+    source: ConnectionSourceLevel;
+    options: any[];
+    loading: boolean;
+}
+declare class SchemaConnectionField implements ControlValueAccessor {
+    readonly label: _angular_core.InputSignal<string>;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    readonly readonly: _angular_core.InputSignal<boolean>;
+    readonly required: _angular_core.InputSignal<boolean>;
+    readonly filter: _angular_core.InputSignal<boolean>;
+    /**
+     * Full connection configuration object from the API.
+     * Includes `targetLevelId`, `sourceLevels[]`, `payloadTemplate`, etc.
+     */
+    readonly configuration: _angular_core.InputSignal<SchemaConnectionConfig>;
+    /**
+     * Optional HttpContext for API requests (e.g. to set base URL behavior).
+     */
+    readonly context: _angular_core.InputSignal<HttpContext | undefined>;
+    /** The full ConnectionPayload value */
+    value: _angular_core.WritableSignal<ConnectionPayload | null>;
+    disabled: _angular_core.WritableSignal<boolean>;
+    /** Per-source-level state: options + loading */
+    sourceLevelStates: _angular_core.WritableSignal<SourceLevelState[]>;
+    /** Mutable selections per source level: sourceLevelId -> selected value */
+    selections: Record<number, any>;
+    requiredValidator: typeof Validators.required;
+    onTouched: () => void;
+    onModelChange: (value: ConnectionPayload | null) => void;
+    ngControl: NgControl | null;
+    private http;
+    private destroyRef;
+    /**
+     * Source levels from configuration.
+     */
+    readonly sourceLevels: _angular_core.Signal<ConnectionSourceLevel[]>;
+    /**
+     * Percentage width for each dropdown, evenly divided.
+     */
+    readonly dropdownWidth: _angular_core.Signal<string>;
+    constructor();
+    private loadOptions;
+    private updateSourceState;
+    /**
+     * Single handler — no params. Reads all selections, builds the combined payload.
+     */
+    syncValue(): void;
+    private distributeToSelections;
+    writeValue(value: ConnectionPayload | string | null): void;
+    registerOnChange(fn: (value: ConnectionPayload | null) => void): void;
+    registerOnTouched(fn: any): void;
+    setDisabledState(disabled: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SchemaConnectionField, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SchemaConnectionField, "mt-schema-connection-field", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "filter": { "alias": "filter"; "required": false; "isSignal": true; }; "configuration": { "alias": "configuration"; "required": true; "isSignal": true; }; "context": { "alias": "context"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { SchemaConnectionField };
+export type { ConnectionPayload, ConnectionSource, ConnectionSourceLevel, SchemaConnectionConfig, SourceLevelState };

package/types/masterteam-components-formula.d.ts

@@ -590,5 +590,72 @@ declare class FormulaStatusBar {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<FormulaStatusBar, "mt-formula-status-bar", never, { "validation": { "alias": "validation"; "required": false; "isSignal": true; }; "labels": { "alias": "labels"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-export { DEFAULT_OPERATORS, FormulaEditor, FormulaEditorCode, FormulaStatusBar, FormulaToolbar, FormulaToolbarItem, cloneBlock, cloneToken, cloneTokens, createFunctionBlock, createFunctionTokens, createLiteralBlock, createLiteralToken, createOperatorBlock, createOperatorToken, createPropertyBlock, createPropertyToken, findFunctionRange, generateFunctionId, generateSmartBlockId, generateTokenId, getArgumentIndexAtPosition, getFunctionTokens, isValidDropPosition, parseSignature, recalculateDepths, serializeTokens };
-export type { ApiErrorResponse, ArgumentSlot, AutocompleteContext, AutocompleteRequest, AutocompleteResponse, AutocompleteSuggestion, BlockType, DragBehavior, ExampleItem, FormulaToken, FormulaToolbarPropertiesContext, FunctionCategory, FunctionCategoryGroup, FunctionDefinition, FunctionInfo, OperatorDefinition, ParameterDefinition, SmartBlock, TokenType, ToolbarItemType, ToolbarTab, ValidationError, ValidationRequest, ValidationResult, ValidationSeverity, ValidationWarning };
+type FormulaRuntimeDomain = 'condition' | 'validation';
+type FormulaConditionMode = 'auto' | 'show' | 'hide' | 'enable' | 'disable';
+interface FormulaConditionConfig {
+    formulaTokens: string;
+    formulaText?: string;
+    mode?: FormulaConditionMode;
+}
+type FormulaValidationSeverity = 'error' | 'warning';
+interface FormulaValidationRuleConfig {
+    id: string | number;
+    formulaTokens: string;
+    formulaText?: string;
+    message: string;
+    severity: FormulaValidationSeverity;
+    enabled: boolean;
+}
+type FormulaRuntimeMessageCode = 'FORMULA_PARSE_ERROR' | 'FORMULA_EVALUATION_ERROR' | 'FORMULA_FALSE';
+interface FormulaRuntimeMessage {
+    code: FormulaRuntimeMessageCode;
+    severity: FormulaValidationSeverity;
+    message: string;
+    formulaText?: string;
+    ruleId?: string | number;
+    fieldKey?: string;
+}
+interface FormulaEvaluationContext {
+    values: Record<string, any>;
+}
+interface FormulaConditionEvaluation {
+    hidden?: boolean;
+    disabled?: boolean;
+    dependencies: string[];
+    errors: string[];
+}
+interface FormulaValidationEvaluation {
+    valid: boolean;
+    dependencies: string[];
+    errors: string[];
+}
+interface FormulaRuntimeCatalog {
+    domain: FormulaRuntimeDomain;
+    functions: FunctionCategoryGroup[];
+    operators: OperatorDefinition[];
+}
+
+declare const CONDITION_FUNCTION_CATEGORIES: FunctionCategoryGroup[];
+declare const CONDITION_OPERATORS: OperatorDefinition[];
+declare const VALIDATION_FUNCTION_CATEGORIES: FunctionCategoryGroup[];
+declare const VALIDATION_OPERATORS: OperatorDefinition[];
+declare const CONDITION_RUNTIME_CATALOG: FormulaRuntimeCatalog;
+declare const VALIDATION_RUNTIME_CATALOG: FormulaRuntimeCatalog;
+
+type RuntimeFunction = (...args: any[]) => any;
+declare class FormulaRuntimeEngine {
+    private readonly compiledCache;
+    private readonly functionRegistry;
+    constructor(customFunctions?: Record<string, RuntimeFunction>);
+    evaluateCondition(config: FormulaConditionConfig, context: FormulaEvaluationContext): FormulaConditionEvaluation;
+    evaluateValidation(rule: FormulaValidationRuleConfig, context: FormulaEvaluationContext): FormulaValidationEvaluation;
+    extractDependencies(formulaTokens: string): string[];
+    private resolveConditionAction;
+    private getCompiledFormula;
+    private deserializeFormulaTokens;
+    private toLexTokens;
+    private evaluateAst;
+}
+
+export { CONDITION_FUNCTION_CATEGORIES, CONDITION_OPERATORS, CONDITION_RUNTIME_CATALOG, DEFAULT_OPERATORS, FormulaEditor, FormulaEditorCode, FormulaRuntimeEngine, FormulaStatusBar, FormulaToolbar, FormulaToolbarItem, VALIDATION_FUNCTION_CATEGORIES, VALIDATION_OPERATORS, VALIDATION_RUNTIME_CATALOG, cloneBlock, cloneToken, cloneTokens, createFunctionBlock, createFunctionTokens, createLiteralBlock, createLiteralToken, createOperatorBlock, createOperatorToken, createPropertyBlock, createPropertyToken, findFunctionRange, generateFunctionId, generateSmartBlockId, generateTokenId, getArgumentIndexAtPosition, getFunctionTokens, isValidDropPosition, parseSignature, recalculateDepths, serializeTokens };
+export type { ApiErrorResponse, ArgumentSlot, AutocompleteContext, AutocompleteRequest, AutocompleteResponse, AutocompleteSuggestion, BlockType, DragBehavior, ExampleItem, FormulaConditionConfig, FormulaConditionEvaluation, FormulaConditionMode, FormulaEvaluationContext, FormulaRuntimeCatalog, FormulaRuntimeDomain, FormulaRuntimeMessage, FormulaRuntimeMessageCode, FormulaToken, FormulaToolbarPropertiesContext, FormulaValidationEvaluation, FormulaValidationRuleConfig, FormulaValidationSeverity, FunctionCategory, FunctionCategoryGroup, FunctionDefinition, FunctionInfo, OperatorDefinition, ParameterDefinition, SmartBlock, TokenType, ToolbarItemType, ToolbarTab, ValidationError, ValidationRequest, ValidationResult, ValidationSeverity, ValidationWarning };

package/types/masterteam-components-menu.d.ts

@@ -7,6 +7,7 @@ import { ButtonSeverity } from 'primeng/button';
 
 interface MTMenuItem extends Omit<MenuItem, 'icon'> {
     icon?: MTIcon;
+    color?: string;
     severity?: ButtonSeverity | 'danger';
     styleClass?: string;
     id?: string | number;
@@ -41,6 +42,8 @@ declare class Menu {
     show(event: Event): void;
     hide(): void;
     protected getItemIcon(item: any): MTIcon | undefined;
+    protected getItemColor(item: any): string | undefined;
+    protected getAvatarStyle(color: string): Record<string, string>;
     private transformMenuItem;
     private getSeverityClass;
     private handleItemSelect;

package/types/masterteam-components.d.ts

@@ -28,6 +28,30 @@ interface FieldRelationConfig {
     value: any;
     action: FieldRelationAction;
 }
+type FormulaConditionMode = 'auto' | 'show' | 'hide' | 'enable' | 'disable';
+interface FormulaConditionConfig {
+    formulaTokens: string;
+    formulaText?: string;
+    mode?: FormulaConditionMode;
+}
+type FormulaValidationSeverity = 'error' | 'warning';
+interface FormulaValidationRuleConfig {
+    id: string | number;
+    formulaTokens: string;
+    formulaText?: string;
+    message: string;
+    severity: FormulaValidationSeverity;
+    enabled: boolean;
+}
+type FormulaRuntimeMessageCode = 'FORMULA_PARSE_ERROR' | 'FORMULA_EVALUATION_ERROR' | 'FORMULA_FALSE';
+interface FormulaRuntimeMessage {
+    code: FormulaRuntimeMessageCode;
+    severity: FormulaValidationSeverity;
+    message: string;
+    formulaText?: string;
+    ruleId?: string | number;
+    fieldKey?: string;
+}
 interface ResponsiveColSpan {
     xs?: number;
     sm?: number;
@@ -73,6 +97,7 @@ declare abstract class BaseFieldConfig {
     defaultValue?: any;
     customTemplate: string;
     relations: FieldRelationConfig[];
+    formulaCondition?: FormulaConditionConfig;
     constructor(config: {
         key?: string;
         label?: string;
@@ -87,6 +112,7 @@ declare abstract class BaseFieldConfig {
         validators?: ValidatorConfig[];
         order?: number;
         relations?: FieldRelationConfig[];
+        formulaCondition?: FormulaConditionConfig;
         colSpan?: number | ResponsiveColSpan;
     });
 }
@@ -383,8 +409,18 @@ declare class SpacerFieldConfig extends BaseFieldConfig {
         label?: string;
     });
 }
+declare class SchemaConnectionFieldConfig extends BaseFieldConfig {
+    configuration: any;
+    context: HttpContext | undefined;
+    filter: boolean;
+    constructor(config: Omit<BaseFieldConstructorConfig, 'type'> & {
+        configuration: any;
+        context?: HttpContext | undefined;
+        filter?: boolean;
+    });
+}
 type DynamicFieldConfig = {
-    [K in keyof (TextFieldConfig & TextareaFieldConfig & SelectFieldConfig & DateFieldConfig & NumberFieldConfig & SliderFieldConfig & MultiSelectFieldConfig & PickListFieldConfig & CheckboxFieldConfig & ToggleFieldConfig & ColorPickerFieldConfig & IconFieldConfig & SpacerFieldConfig & BaseFieldConfig)]?: (TextFieldConfig & TextareaFieldConfig & SelectFieldConfig & DateFieldConfig & NumberFieldConfig & SliderFieldConfig & MultiSelectFieldConfig & PickListFieldConfig & CheckboxFieldConfig & ToggleFieldConfig & ColorPickerFieldConfig & IconFieldConfig & SpacerFieldConfig & BaseFieldConfig)[K];
+    [K in keyof (TextFieldConfig & TextareaFieldConfig & SelectFieldConfig & DateFieldConfig & NumberFieldConfig & SliderFieldConfig & MultiSelectFieldConfig & PickListFieldConfig & CheckboxFieldConfig & ToggleFieldConfig & ColorPickerFieldConfig & IconFieldConfig & SpacerFieldConfig & SchemaConnectionFieldConfig & BaseFieldConfig)]?: (TextFieldConfig & TextareaFieldConfig & SelectFieldConfig & DateFieldConfig & NumberFieldConfig & SliderFieldConfig & MultiSelectFieldConfig & PickListFieldConfig & CheckboxFieldConfig & ToggleFieldConfig & ColorPickerFieldConfig & IconFieldConfig & SpacerFieldConfig & SchemaConnectionFieldConfig & BaseFieldConfig)[K];
 };
 interface LayoutConfig {
     containerClass?: string;
@@ -394,6 +430,7 @@ interface LayoutConfig {
 interface DynamicFormConfig {
     sections: SectionConfig[];
     layout?: LayoutConfig;
+    validationRules?: FormulaValidationRuleConfig[];
 }
 interface SectionConfig {
     key?: string;
@@ -729,5 +766,5 @@ declare const REQUEST_CONTEXT: HttpContextToken<RequestContextConfig>;
 declare function getLightColor(hexColor: string): string;
 declare function getContrastColor(bgColor: string): string;
 
-export { BaseFacade, BaseFieldConfig, CheckboxFieldConfig, ColorPickerFieldConfig, CrudStateBase, DateFieldConfig, EditorFieldConfig, IconFieldConfig, MultiSelectFieldConfig, NumberFieldConfig, PickListFieldConfig, REQUEST_CONTEXT, RadioButtonFieldConfig, RadioCardsFieldConfig, SelectFieldConfig, SliderFieldConfig, SpacerFieldConfig, TextFieldConfig, TextareaFieldConfig, ToggleFieldConfig, UploadFileFieldConfig, UserSearchFieldConfig, ValidatorConfig, changeBackgroundColor, changePrimaryColor, changeTextColor, createCustomValidator, createEntityAdapter, endLoading, generateTailwindPalette, getContrastColor, getLightColor, handleApiRequest, isInvalid, provideMTComponents, provideMTConfirmation, provideMTMessages, setLoadingError, startLoading, wrapValidatorWithMessage };
-export type { ApiRequestConfig, BaseFieldConstructorConfig, CrudCreateConfig, CrudDeleteConfig, CrudLoadConfig, CrudUpdateConfig, DynamicFieldConfig, DynamicFormConfig, EntityAdapter, FieldRelationAction, FieldRelationConfig, FieldState, FieldType, LayoutConfig, LoadingStateShape, MTThemeOptions, PaletteShade, QueryResult, RequestContextConfig, Response, ResponsiveColSpan, SectionConfig, ValidatorType };
+export { BaseFacade, BaseFieldConfig, CheckboxFieldConfig, ColorPickerFieldConfig, CrudStateBase, DateFieldConfig, EditorFieldConfig, IconFieldConfig, MultiSelectFieldConfig, NumberFieldConfig, PickListFieldConfig, REQUEST_CONTEXT, RadioButtonFieldConfig, RadioCardsFieldConfig, SchemaConnectionFieldConfig, SelectFieldConfig, SliderFieldConfig, SpacerFieldConfig, TextFieldConfig, TextareaFieldConfig, ToggleFieldConfig, UploadFileFieldConfig, UserSearchFieldConfig, ValidatorConfig, changeBackgroundColor, changePrimaryColor, changeTextColor, createCustomValidator, createEntityAdapter, endLoading, generateTailwindPalette, getContrastColor, getLightColor, handleApiRequest, isInvalid, provideMTComponents, provideMTConfirmation, provideMTMessages, setLoadingError, startLoading, wrapValidatorWithMessage };
+export type { ApiRequestConfig, BaseFieldConstructorConfig, CrudCreateConfig, CrudDeleteConfig, CrudLoadConfig, CrudUpdateConfig, DynamicFieldConfig, DynamicFormConfig, EntityAdapter, FieldRelationAction, FieldRelationConfig, FieldState, FieldType, FormulaConditionConfig, FormulaConditionMode, FormulaRuntimeMessage, FormulaRuntimeMessageCode, FormulaValidationRuleConfig, FormulaValidationSeverity, LayoutConfig, LoadingStateShape, MTThemeOptions, PaletteShade, QueryResult, RequestContextConfig, Response, ResponsiveColSpan, SectionConfig, ValidatorType };