@masterteam/formula-builder 0.0.26 → 0.0.28

package/package.json

@@ -1,26 +1,26 @@
 {
   "name": "@masterteam/formula-builder",
-  "version": "0.0.26",
+  "version": "0.0.28",
   "publishConfig": {
     "directory": "../../../dist/masterteam/formula-builder",
     "linkDirectory": true,
     "access": "public"
   },
   "peerDependencies": {
-    "@angular/common": "^21.2.8",
-    "@angular/core": "^21.2.8",
-    "@angular/forms": "^21.2.8",
-    "@angular/cdk": "^21.2.6",
-    "@primeuix/themes": "^2.0.3",
-    "@tailwindcss/postcss": "^4.2.2",
-    "@jsverse/transloco": "^8.3.0",
-    "postcss": "^8.5.9",
-    "primeng": "21.1.5",
-    "rxjs": "^7.8.2",
-    "tailwindcss": "^4.2.2",
-    "tailwindcss-primeui": "^0.6.1",
-    "@masterteam/components": "^0.0.226",
-    "@masterteam/icons": "^0.0.17"
+    "@angular/common": "catalog:angular21",
+    "@angular/core": "catalog:angular21",
+    "@angular/forms": "catalog:angular21",
+    "@angular/cdk": "catalog:angular21",
+    "@primeuix/themes": "catalog:",
+    "@tailwindcss/postcss": "catalog:",
+    "@jsverse/transloco": "catalog:i18n",
+    "postcss": "catalog:",
+    "primeng": "catalog:",
+    "rxjs": "catalog:angular21",
+    "tailwindcss": "catalog:",
+    "tailwindcss-primeui": "catalog:",
+    "@masterteam/components": "workspace:^",
+    "@masterteam/icons": "workspace:^"
   },
   "sideEffects": false,
   "exports": {
@@ -36,6 +36,6 @@
   "typings": "types/masterteam-formula-builder.d.ts",
   "type": "module",
   "dependencies": {
-    "tslib": "^2.8.1"
+    "tslib": "catalog:angular21"
   }
 }

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

@@ -4,13 +4,15 @@ import { OnDestroy } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
 import { RadioItem } from '@masterteam/components/radio-cards';
 import { Observable } from 'rxjs';
-import { FunctionCategoryGroup, AutocompleteRequest as AutocompleteRequest$1, AutocompleteResponse as AutocompleteResponse$1, ValidationResult as ValidationResult$1, FormulaToken, ToolbarTab, SmartBlock } from '@masterteam/components/formula';
+import { FunctionCategoryGroup, AutocompleteRequest as AutocompleteRequest$1, AutocompleteResponse as AutocompleteResponse$1, ValidationResult as ValidationResult$1, FormulaToken, ToolbarTab, OperatorDefinition, SmartBlock } from '@masterteam/components/formula';
 export { ArgumentSlot, BlockType, DragBehavior, FormulaToken, FunctionCategoryGroup, FunctionDefinition, OperatorDefinition, SmartBlock, TokenType, ValidationError, ValidationResult, createFunctionBlock, createLiteralBlock, createOperatorBlock, createPropertyBlock } from '@masterteam/components/formula';
 
 type ValidationResult = ValidationResult$1;
 type AutocompleteResponse = AutocompleteResponse$1;
 interface AutocompleteRequest extends AutocompleteRequest$1 {
     moduleId?: number;
+    /** Canonical context id, e.g. `Module:123` / `Level:5/Module:10`. */
+    contextKey?: string;
 }
 /** Validation request payload (for API calls) */
 interface ValidationRequest {
@@ -19,6 +21,8 @@ interface ValidationRequest {
     levelSchemaId?: number;
     moduleId?: number;
     templateId?: number;
+    /** Canonical context id, e.g. `Module:123` / `Level:5/Module:10`. */
+    contextKey?: string;
 }
 /** Function catalog response from API */
 interface FunctionCatalogResponse {
@@ -64,8 +68,37 @@ interface FormulaEngineSchemaDescriptor {
     generatedAt?: string;
 }
 
+/**
+ * How the backend resolves a formula's execution surface for a context.
+ * `InlineCurrentOnly` — standalone module / current-only authoring (only
+ * `@Current::Property` is valid); `EntityBacked` — full workspace/level
+ * authoring with navigation scopes. Serialized as strings by the API.
+ */
+type FormulaExecutionProfile = 'InlineCurrentOnly' | 'EntityBacked' | (string & {});
+/**
+ * The kind of context a `contextKey` resolves to. `StandaloneModule` is a
+ * module opened without a workspace/level (e.g. `General Task`) addressed as
+ * `Module:{moduleId}`. Serialized as strings by the API.
+ */
+type FormulaContextKind = 'StandaloneModule' | (string & {});
 interface FormulaBuilderContextResponse {
     schemaId: number;
+    /**
+     * Canonical schema id to use for subsequent properties/next-tokens calls.
+     * For standalone modules this equals the module id. Falls back to `schemaId`
+     * when the backend omits it.
+     */
+    formulaSchemaId?: number;
+    /** Canonical context identifier the response was resolved from. */
+    contextKey?: string;
+    contextKind?: FormulaContextKind;
+    executionProfile?: FormulaExecutionProfile;
+    /**
+     * Scope tokens the FE may surface for this context. Standalone modules
+     * return only `['Current']`. When present, the builder gates visible
+     * navigation scopes to this list.
+     */
+    supportedScopeTokens?: string[];
     contextEntityTypeKey?: string;
     schemaDescriptor: FormulaEngineSchemaDescriptor;
     currentProperties: FormulaPropertyDescriptor[];
@@ -131,6 +164,15 @@ declare class FormulaBuilder implements ControlValueAccessor, OnDestroy {
     readonly levelSchemaId: _angular_core.InputSignal<number | undefined>;
     /** Optional module ID when the formula is scoped inside a level-linked module */
     readonly moduleId: _angular_core.InputSignal<number | undefined>;
+    /**
+     * Canonical context identifier — `Module:{id}` / `Level:{id}` /
+     * `Level:{id}/Module:{id}`. When set it is the source of truth for the
+     * context kind and execution profile: it is the only way to address a
+     * standalone module (no workspace/level schema), and the builder loads its
+     * context, scopes, functions and validation through it. When omitted the
+     * legacy `levelSchemaId` + `moduleId` flow is used unchanged.
+     */
+    readonly contextKey: _angular_core.InputSignal<string | undefined>;
     /** Optional current context entity key, e.g. LevelData or Risk */
     readonly contextEntityTypeKey: _angular_core.InputSignal<string | undefined>;
     /** Template ID for validation context */
@@ -143,6 +185,10 @@ declare class FormulaBuilder implements ControlValueAccessor, OnDestroy {
     readonly hideStatusBar: _angular_core.InputSignal<boolean>;
     /** Visible toolbar tabs */
     readonly toolbarTabs: _angular_core.InputSignal<readonly ToolbarTab[]>;
+    /** Optional host-owned function catalog. Takes precedence over API context. */
+    readonly functionCategories: _angular_core.InputSignal<FunctionCategoryGroup[]>;
+    /** Operators shown in the formula toolbar. */
+    readonly operators: _angular_core.InputSignal<OperatorDefinition[]>;
     /** 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. */
@@ -165,6 +211,27 @@ declare class FormulaBuilder implements ControlValueAccessor, OnDestroy {
     readonly expression: _angular_core.Signal<string>;
     readonly resolvedContextEntityTypeKey: _angular_core.Signal<string | undefined>;
     readonly isModuleContext: _angular_core.Signal<boolean>;
+    /** Trimmed canonical context key, or undefined when not supplied. */
+    readonly resolvedContextKey: _angular_core.Signal<string | undefined>;
+    /**
+     * True when authoring is current-only (a standalone module / `Module:{id}`).
+     * Prefers the resolved context (execution profile / kind) once loaded, and
+     * falls back to the shape of the context key before the context arrives so
+     * navigation scopes never flash for a standalone module.
+     */
+    readonly isCurrentOnlyContext: _angular_core.Signal<boolean>;
+    /**
+     * Scope tokens the backend allows for this context, or null when it doesn't
+     * constrain them (legacy contexts). Used to gate the visible navigation.
+     */
+    readonly supportedScopeTokens: _angular_core.Signal<string[] | null>;
+    /**
+     * Schema id for downstream properties / next-token / validation calls. The
+     * context response is authoritative (a standalone module resolves its own
+     * `formulaSchemaId`); falls back to the `levelSchemaId` input for legacy
+     * flows and before the context loads.
+     */
+    readonly effectiveSchemaId: _angular_core.Signal<number | undefined>;
     readonly autocompleteProvider: (request: AutocompleteRequest) => Observable<AutocompleteResponse | null>;
     private fetchAutocomplete$;
     /** Editor mode */
@@ -184,8 +251,8 @@ declare class FormulaBuilder implements ControlValueAccessor, OnDestroy {
     readonly isValidating: _angular_core.Signal<boolean>;
     /** Builder context from API */
     readonly builderContext: _angular_core.WritableSignal<FormulaBuilderContextResponse | null>;
-    /** Function categories from context */
-    readonly functionCategories: _angular_core.Signal<_masterteam_formula_builder.FunctionCategoryGroup[]>;
+    /** Function categories from the host, context API, or validation fallback. */
+    readonly resolvedFunctionCategories: _angular_core.Signal<FunctionCategoryGroup[]>;
     /** Is builder context loading */
     readonly isContextLoading: _angular_core.WritableSignal<boolean>;
     private contextRequestId;
@@ -327,7 +394,7 @@ declare class FormulaBuilder implements ControlValueAccessor, OnDestroy {
     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; }; "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>;
+    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; }; "contextKey": { "alias": "contextKey"; "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; }; "functionCategories": { "alias": "functionCategories"; "required": false; "isSignal": true; }; "operators": { "alias": "operators"; "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';
@@ -335,14 +402,22 @@ declare class FormulaContextService {
     private readonly http;
     private readonly apiUrl;
     private getBaseUrl;
+    private buildLegacyContextUrl;
     private unwrapResponse;
     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>;
+    /**
+     * Load the builder context. When `contextKey` is provided it is the canonical
+     * context identifier (`Module:123` / `Level:5` / `Level:5/Module:10`) and the
+     * context-key endpoint is used — this is the only way to address a standalone
+     * module, which has no workspace/level schema id. Otherwise the legacy
+     * schema-id path endpoint is used unchanged.
+     */
+    loadContext(schemaId: number | undefined, moduleId?: number, contextEntityTypeKey?: string, mode?: FormulaApiMode$1, contextKey?: string): Observable<FormulaBuilderContextResponse | null>;
+    getScopeProperties(schemaId: number, component: string | undefined, tablePath: string, moduleId?: number, mode?: FormulaApiMode$1, contextKey?: string): Observable<FormulaPropertyDescriptor[]>;
+    getNextTokens(schemaId: number, component: string, tablePath: string, moduleId?: number, mode?: FormulaApiMode$1, contextKey?: string): 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
@@ -382,9 +457,9 @@ declare class FormulaValidatorService {
     /** Setup debounced validation stream */
     private setupValidationStream;
     /** Validate formula (debounced) */
-    validate(formula: string, knownProperties?: string[], levelSchemaId?: number, moduleId?: number, templateId?: number, apiMode?: FormulaApiMode): void;
+    validate(formula: string, knownProperties?: string[], levelSchemaId?: number, moduleId?: number, templateId?: number, apiMode?: FormulaApiMode, contextKey?: string): void;
     /** Validate formula immediately (no debounce) */
-    validateImmediate(formula: string, knownProperties?: string[], levelSchemaId?: number, moduleId?: number, templateId?: number, apiMode?: FormulaApiMode): Observable<ValidationResult>;
+    validateImmediate(formula: string, knownProperties?: string[], levelSchemaId?: number, moduleId?: number, templateId?: number, apiMode?: FormulaApiMode, contextKey?: string): Observable<ValidationResult>;
     /** Call validation API */
     private callValidateApi;
     /** Reset validation state */