@masterteam/formula-builder 0.0.25 → 0.0.27

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masterteam/formula-builder",
-  "version": "0.0.25",
+  "version": "0.0.27",
   "publishConfig": {
     "directory": "../../../dist/masterteam/formula-builder",
     "linkDirectory": true,
@@ -20,7 +20,7 @@
     "tailwindcss": "^4.2.2",
     "tailwindcss-primeui": "^0.6.1",
     "@masterteam/icons": "^0.0.17",
-    "@masterteam/components": "^0.0.223"
+    "@masterteam/components": "^0.0.227"
   },
   "sideEffects": false,
   "exports": {

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

@@ -11,6 +11,8 @@ 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 */
@@ -165,6 +207,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 */
@@ -327,7 +390,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; }; "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 +398,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 +453,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 */