@masterteam/formula-builder 0.0.22 → 0.0.24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masterteam/formula-builder",
-  "version": "0.0.22",
+  "version": "0.0.24",
   "publishConfig": {
     "directory": "../../../dist/masterteam/formula-builder",
     "linkDirectory": true,
@@ -19,8 +19,8 @@
     "rxjs": "^7.8.2",
     "tailwindcss": "^4.2.2",
     "tailwindcss-primeui": "^0.6.1",
-    "@masterteam/components": "^0.0.207",
-    "@masterteam/icons": "^0.0.17"
+    "@masterteam/icons": "^0.0.17",
+    "@masterteam/components": "^0.0.221"
   },
   "sideEffects": false,
   "exports": {

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

@@ -80,6 +80,11 @@ interface FormulaBuilderNextTokensResponse {
     version?: string;
     generatedAt?: string;
 }
+/** A single selectable value of a lookup / status / lookup-matrix property. */
+interface FormulaPropertyItem {
+    key: string;
+    name: string;
+}
 
 interface FormulaBuilderValue {
     expression: string;
@@ -102,6 +107,8 @@ type SegmentMeta = PathSegment & {
 interface FormulaBuilderUiConfig {
     toolbarTabs?: readonly ToolbarTab[];
     codeOnly?: boolean;
+    builderOnly?: boolean;
+    valueMode?: 'object' | 'expression';
     hideToolbar?: boolean;
     hideStatusBar?: boolean;
     isProcessBuilder?: boolean;
@@ -138,6 +145,10 @@ declare class FormulaBuilder implements ControlValueAccessor, OnDestroy {
     readonly toolbarTabs: _angular_core.InputSignal<readonly ToolbarTab[]>;
     /** Force code editor mode and hide the mode toggle */
     readonly codeOnly: _angular_core.InputSignal<boolean>;
+    /** Keep the block builder active and hide the code-mode toggle. */
+    readonly builderOnly: _angular_core.InputSignal<boolean>;
+    /** ControlValueAccessor output shape. `expression` emits the formula string. */
+    readonly valueMode: _angular_core.InputSignal<"object" | "expression">;
     /** Use Process Builder current-only Formula Engine endpoints */
     readonly isProcessBuilder: _angular_core.InputSignal<boolean>;
     /** Emits validation result on change */
@@ -155,6 +166,7 @@ declare class FormulaBuilder implements ControlValueAccessor, OnDestroy {
     readonly resolvedContextEntityTypeKey: _angular_core.Signal<string | undefined>;
     readonly isModuleContext: _angular_core.Signal<boolean>;
     readonly autocompleteProvider: (request: AutocompleteRequest) => Observable<AutocompleteResponse | null>;
+    private fetchAutocomplete$;
     /** Editor mode */
     readonly editorMode: _angular_core.WritableSignal<"builder" | "code">;
     readonly isCodeMode: _angular_core.Signal<boolean>;
@@ -183,8 +195,8 @@ declare class FormulaBuilder implements ControlValueAccessor, OnDestroy {
     private readonly propertyLoadingPath;
     constructor();
     ngOnDestroy(): void;
-    writeValue(value: FormulaBuilderValue | null): void;
-    registerOnChange(fn: (value: FormulaBuilderValue) => void): void;
+    writeValue(value: FormulaBuilderValue | string | null): void;
+    registerOnChange(fn: (value: FormulaBuilderValue | string) => void): void;
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     /** Handle formula change from editor */
@@ -204,6 +216,7 @@ declare class FormulaBuilder implements ControlValueAccessor, OnDestroy {
     private exitCodeMode;
     /** Clear the formula */
     clear(): void;
+    private shouldUseCodeMode;
     private resolveExpressionValue;
     private applyFormulaValue;
     private rebuildBuilderFromExpression;
@@ -255,11 +268,24 @@ declare class FormulaBuilder implements ControlValueAccessor, OnDestroy {
     readonly propertyOptions: _angular_core.Signal<{
         key: string;
         name: any;
+        viewType: string | undefined;
     }[]>;
     readonly selectedProperty: _angular_core.Signal<{
         key: string;
         name: any;
+        viewType: string | undefined;
     } | null>;
+    /** Selectable values of the chosen lookup/status/lookup-matrix property. */
+    readonly lookupItems: _angular_core.WritableSignal<FormulaPropertyItem[]>;
+    /** Whether the property-items request is in flight. */
+    readonly isLookupItemsLoading: _angular_core.WritableSignal<boolean>;
+    /** Currently selected lookup value key (the form inserted into the formula). */
+    readonly lookupValueKey: _angular_core.WritableSignal<string>;
+    private lookupItemsRequestId;
+    /** True when the selected field draws its values from a fixed lookup set. */
+    readonly isLookupProperty: _angular_core.Signal<boolean>;
+    /** Insert-value action is enabled once a lookup value has been picked. */
+    readonly canInsertLookupValue: _angular_core.Signal<boolean>;
     readonly canInsertProperty: _angular_core.Signal<boolean>;
     setPropertyScope(scope: string): void;
     setPathSegmentValue(index: number, value: string | null): void;
@@ -273,9 +299,35 @@ declare class FormulaBuilder implements ControlValueAccessor, OnDestroy {
         name: string;
     }[];
     insertSelectedProperty(insertBlock: (block: SmartBlock) => void): void;
+    /**
+     * Insert the picked lookup value as a string literal. The executable form
+     * carries the stable lookup KEY (locale-independent) while the chip shows
+     * the friendly NAME — e.g. `… == "completed"` rendered as `… == Completed`.
+     */
+    insertSelectedLookupValue(insertBlock: (block: SmartBlock) => void): void;
+    /**
+     * Detect that the cursor (in the code editor) is positioned to type the
+     * right-hand value of a comparison against a property, e.g.
+     * `@Current::task_status == "in_`. Returns the compared property key, whether
+     * an opening quote was already typed, and the partial value typed so far.
+     */
+    private detectLookupValueContext;
+    /**
+     * Avoid a wasted request for properties we already know aren't lookups; for
+     * keys whose view type isn't loaded yet, let property-items be the authority.
+     */
+    private shouldFetchLookupItems;
+    private findLoadedPropertyViewType;
+    /**
+     * Build an autocomplete response from a lookup property's values. The inserted
+     * text carries the stable key wrapped in quotes (the opening quote is dropped
+     * when the user already typed one), matching the key-as-value contract used by
+     * the toolbar Value row.
+     */
+    private buildLookupValueResponse;
     getOperatorDisplayName(token: string): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<FormulaBuilder, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FormulaBuilder, "mt-formula-builder", never, { "propertiesByPath": { "alias": "propertiesByPath"; "required": false; "isSignal": true; }; "levelSchemaId": { "alias": "levelSchemaId"; "required": false; "isSignal": true; }; "moduleId": { "alias": "moduleId"; "required": false; "isSignal": true; }; "contextEntityTypeKey": { "alias": "contextEntityTypeKey"; "required": false; "isSignal": true; }; "templateId": { "alias": "templateId"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "hideToolbar": { "alias": "hideToolbar"; "required": false; "isSignal": true; }; "hideStatusBar": { "alias": "hideStatusBar"; "required": false; "isSignal": true; }; "toolbarTabs": { "alias": "toolbarTabs"; "required": false; "isSignal": true; }; "codeOnly": { "alias": "codeOnly"; "required": false; "isSignal": true; }; "isProcessBuilder": { "alias": "isProcessBuilder"; "required": false; "isSignal": true; }; }, { "validationChange": "validationChange"; "tokensChange": "tokensChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FormulaBuilder, "mt-formula-builder", never, { "propertiesByPath": { "alias": "propertiesByPath"; "required": false; "isSignal": true; }; "levelSchemaId": { "alias": "levelSchemaId"; "required": false; "isSignal": true; }; "moduleId": { "alias": "moduleId"; "required": false; "isSignal": true; }; "contextEntityTypeKey": { "alias": "contextEntityTypeKey"; "required": false; "isSignal": true; }; "templateId": { "alias": "templateId"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "hideToolbar": { "alias": "hideToolbar"; "required": false; "isSignal": true; }; "hideStatusBar": { "alias": "hideStatusBar"; "required": false; "isSignal": true; }; "toolbarTabs": { "alias": "toolbarTabs"; "required": false; "isSignal": true; }; "codeOnly": { "alias": "codeOnly"; "required": false; "isSignal": true; }; "builderOnly": { "alias": "builderOnly"; "required": false; "isSignal": true; }; "valueMode": { "alias": "valueMode"; "required": false; "isSignal": true; }; "isProcessBuilder": { "alias": "isProcessBuilder"; "required": false; "isSignal": true; }; }, { "validationChange": "validationChange"; "tokensChange": "tokensChange"; }, never, never, true, never>;
 }
 
 type FormulaApiMode$1 = 'default' | 'current-only';
@@ -287,9 +339,17 @@ declare class FormulaContextService {
     private readonly contextCache;
     private readonly propertiesCache;
     private readonly nextTokensCache;
+    private readonly propertyItemsCache;
     loadContext(schemaId: number, moduleId?: number, contextEntityTypeKey?: string, mode?: FormulaApiMode$1): Observable<FormulaBuilderContextResponse | null>;
     getScopeProperties(schemaId: number, component: string | undefined, tablePath: string, moduleId?: number, mode?: FormulaApiMode$1): Observable<FormulaPropertyDescriptor[]>;
     getNextTokens(schemaId: number, component: string, tablePath: string, moduleId?: number, mode?: FormulaApiMode$1): Observable<FormulaBuilderNextTokensResponse | null>;
+    /**
+     * Selectable values for a lookup / status / lookup-matrix property.
+     * The backend responds 400 (VAL_001) for any non-lookup property, which we
+     * swallow into an empty list — callers gate the value picker on a known
+     * lookup view type, so an empty result simply means "no picker".
+     */
+    getPropertyItems(propertyKey: string, mode?: FormulaApiMode$1): Observable<FormulaPropertyItem[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<FormulaContextService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<FormulaContextService>;
 }