@acorex/modules 21.0.0-next.39 → 21.0.0-next.40

package/types/acorex-modules-measurement-core.d.ts

@@ -1,8 +1,8 @@
 import * as i0 from '@angular/core';
 import { Injector } from '@angular/core';
+import { AXPMultiLanguageString, AXPCategoryListItem } from '@acorex/platform/core';
+import { AXPEntityModel, AXPEntityDefinitionLoader } from '@acorex/platform/layout/entity';
 import { AXPEntity, AXPMenuProvider, AXPMenuProviderContext, AXPSearchCommandProvider, AXPSearchResult } from '@acorex/platform/common';
-import { AXPCategoryListItem } from '@acorex/platform/core';
-import { AXPEntityDefinitionLoader } from '@acorex/platform/layout/entity';
 import { AXPPermissionDefinitionProvider, AXPPermissionDefinitionProviderContext } from '@acorex/platform/auth';
 
 declare class AXMMeasurementCoreModule {
@@ -79,24 +79,31 @@ declare const RootConfig: {
     };
 };
 
-interface AXMMeasurementCoreQuantityTypeEntityModel {
-    id: string;
+interface AXMMeasurementCoreQuantityTypeEntityModel extends AXPEntityModel<string> {
     code: string;
-    title: string;
+    title: AXPMultiLanguageString;
     /** Base unit for this quantity type (optional but recommended) */
     baseUomId?: string | null;
-    description?: string | null;
+    baseUnit?: {
+        title: AXPMultiLanguageString;
+        symbol?: string | null;
+    };
+    description?: AXPMultiLanguageString | null;
     isDisabled?: boolean;
 }
 
 declare function quantityTypeFactory(injector: Injector): Promise<AXPEntity>;
 
-interface AXMMeasurementCoreUnitOfMeasureEntityModel {
-    id: string;
+interface AXMMeasurementCoreUnitOfMeasureEntityModel extends AXPEntityModel<string> {
     code: string;
-    title: string;
+    title: AXPMultiLanguageString;
     /** FK -> QuantityType */
     quantityTypeId: string;
+    quantityType?: {
+        id: string;
+        code: string;
+        title: AXPMultiLanguageString;
+    };
     /**
      * Optional conversion factor to the base unit of the QuantityType.
      * Example: if base is mm, then cm.factorToBase = 10
@@ -107,7 +114,7 @@ interface AXMMeasurementCoreUnitOfMeasureEntityModel {
     /** True if this is the base unit */
     isBase?: boolean;
     symbol?: string | null;
-    description?: string | null;
+    description?: AXPMultiLanguageString | null;
     isDisabled?: boolean;
 }
 
@@ -116,31 +123,47 @@ declare function unitOfMeasureFactory(injector: Injector): Promise<AXPEntity>;
 declare function unitConversionFactory(injector: Injector): Promise<AXPEntity>;
 
 type AXMMeasurementCoreConversionOperator = 'multiply' | 'divide';
-interface AXMMeasurementCoreUnitConversionEntityModel {
-    id: string;
+interface AXMMeasurementCoreUnitConversionEntityModel extends AXPEntityModel<string> {
     code?: string | null;
     /** Optional display title (e.g. "Box to Piece") */
-    title?: string | null;
+    title?: AXPMultiLanguageString | null;
     fromUomId: string;
     toUomId: string;
     /** Conversion factor: value_in_to = value_in_from * factor (when operator is multiply) */
     factor: number;
     operator?: AXMMeasurementCoreConversionOperator | null;
-    description?: string | null;
+    description?: AXPMultiLanguageString | null;
+    fromUnit?: {
+        title: AXPMultiLanguageString;
+        symbol?: string | null;
+    };
+    toUnit?: {
+        title: AXPMultiLanguageString;
+        symbol?: string | null;
+    };
     isDisabled?: boolean;
 }
 
 declare function measurementDimensionFactory(injector: Injector): Promise<AXPEntity>;
 
-interface AXMMeasurementCoreMeasurementDimensionEntityModel {
-    id: string;
+interface AXMMeasurementCoreMeasurementDimensionEntityModel extends AXPEntityModel<string> {
     code: string;
-    title: string;
+    title: AXPMultiLanguageString;
     /** FK -> QuantityType */
     quantityTypeId: string;
+    quantityType?: {
+        id: string;
+        code: string;
+        title: AXPMultiLanguageString;
+    };
     /** Default unit for UI (optional) */
     defaultUomId?: string | null;
-    description?: string | null;
+    defaultUom?: {
+        id: string;
+        title: AXPMultiLanguageString;
+        symbol?: string | null;
+    };
+    description?: AXPMultiLanguageString | null;
     isDisabled?: boolean;
 }
 
@@ -148,15 +171,19 @@ declare function measurementRangeFactory(injector: Injector): Promise<AXPEntity>
 
 type AXMMeasurementCoreRangeType = 'acceptable' | 'preferred' | 'tolerance' | 'ideal';
 type AXMMeasurementCoreBoundType = 'closed' | 'open' | 'leftClosed' | 'rightClosed';
-interface AXMMeasurementCoreMeasurementRangeEntityModel {
-    id: string;
+interface AXMMeasurementCoreMeasurementRangeEntityModel extends AXPEntityModel<string> {
     /** FK -> MeasurementDimension */
     measurementDimensionId: string;
+    measurementDimension?: {
+        id: string;
+        code: string;
+        title: AXPMultiLanguageString;
+    };
     /** Optional code for display/identification */
     code?: string | null;
     /** Optional title for display */
-    title?: string | null;
-    description?: string | null;
+    title?: AXPMultiLanguageString | null;
+    description?: AXPMultiLanguageString | null;
     /** Range endpoints */
     min?: number | null;
     max?: number | null;
@@ -164,6 +191,10 @@ interface AXMMeasurementCoreMeasurementRangeEntityModel {
     target?: number | null;
     /** Unit for min/max/target */
     uomId: string;
+    unit?: {
+        title: AXPMultiLanguageString;
+        symbol?: string | null;
+    };
     /** Semantic meaning of this range */
     rangeType?: AXMMeasurementCoreRangeType | null;
     /** Inclusivity of bounds */
@@ -180,10 +211,9 @@ interface AXMMeasurementCoreMeasurementRangeEntityModel {
 declare function sizingProfileFactory(injector: Injector): Promise<AXPEntity>;
 
 type AXMMeasurementCoreSizeMatchStrategy = 'primary-first' | 'all-required';
-interface AXMMeasurementCoreSizingProfileEntityModel {
-    id: string;
+interface AXMMeasurementCoreSizingProfileEntityModel extends AXPEntityModel<string> {
     code: string;
-    title: string;
+    title: AXPMultiLanguageString;
     categoryIds?: string[];
     categories?: AXPCategoryListItem[];
     regionId?: string | null;
@@ -193,16 +223,25 @@ interface AXMMeasurementCoreSizingProfileEntityModel {
     } | null;
     matchStrategy?: AXMMeasurementCoreSizeMatchStrategy | null;
     enforceNoOverlap?: boolean;
-    description?: string | null;
+    description?: AXPMultiLanguageString | null;
     isDisabled?: boolean;
 }
 
 declare function sizingDimensionUsageFactory(injector: Injector): Promise<AXPEntity>;
 
-interface AXMMeasurementCoreSizingDimensionUsageEntityModel {
-    id: string;
+interface AXMMeasurementCoreSizingDimensionUsageEntityModel extends AXPEntityModel<string> {
     sizeChartId: string;
+    sizeChart?: {
+        id: string;
+        code: string;
+        title: AXPMultiLanguageString;
+    };
     measurementDimensionId: string;
+    measurementDimension?: {
+        id: string;
+        code: string;
+        title: AXPMultiLanguageString;
+    };
     /** Required dimensions must be satisfied for a match */
     required?: boolean;
     /** Primary dimension used for primary-first matching (at most one true recommended) */
@@ -215,11 +254,15 @@ interface AXMMeasurementCoreSizingDimensionUsageEntityModel {
 
 declare function sizeItemFactory(injector: Injector): Promise<AXPEntity>;
 
-interface AXMMeasurementCoreSizeItemEntityModel {
-    id: string;
+interface AXMMeasurementCoreSizeItemEntityModel extends AXPEntityModel<string> {
     sizeChartId: string;
+    sizeChart?: {
+        id: string;
+        code: string;
+        title: AXPMultiLanguageString;
+    };
     code: string;
-    title?: string | null;
+    title?: AXPMultiLanguageString | null;
     sortOrder?: number | null;
     isDisabled?: boolean;
 }
@@ -227,13 +270,32 @@ interface AXMMeasurementCoreSizeItemEntityModel {
 declare function sizeRuleFactory(injector: Injector): Promise<AXPEntity>;
 
 type AXMMeasurementCoreRuleMatchBehavior = 'hard' | 'soft' | 'scoring';
-interface AXMMeasurementCoreSizeRuleEntityModel {
-    id: string;
+interface AXMMeasurementCoreSizeRuleEntityModel extends AXPEntityModel<string> {
     /** Sizing profile for filtering and performance; rules are scoped to a profile. */
     sizeChartId: string;
+    sizeChart?: {
+        id: string;
+        code: string;
+        title: AXPMultiLanguageString;
+    };
     sizeItemId: string;
+    sizeItem?: {
+        id: string;
+        code: string;
+        title?: AXPMultiLanguageString | null;
+    };
     measurementDimensionId: string;
+    measurementDimension?: {
+        id: string;
+        code: string;
+        title: AXPMultiLanguageString;
+    };
     measurementRangeId: string;
+    measurementRange?: {
+        id: string;
+        code?: string | null;
+        title?: AXPMultiLanguageString | null;
+    };
     /** Optional matching behavior */
     matchBehavior?: AXMMeasurementCoreRuleMatchBehavior | null;
     /** Optional priority within a size item */

package/types/acorex-modules-organization-management.d.ts

@@ -1,7 +1,10 @@
 import { AXPMultiLanguageString, AXPEntityReference, AXPCategoryListItem } from '@acorex/platform/core';
-import { AXPEntityModel, AXPRecordStateInfo } from '@acorex/platform/layout/entity';
+import { AXPEntityModel } from '@acorex/platform/layout/entity';
 import { AXPSpreadsheetData } from '@acorex/platform/layout/components';
+import { AXPEntity } from '@acorex/platform/common';
 import * as i0 from '@angular/core';
+import { Injector, InjectionToken } from '@angular/core';
+import { AXStyleColorType } from '@acorex/cdk/common';
 import * as i1 from '@angular/common';
 import * as i2 from '@acorex/platform/layout/widget-core';
 
@@ -66,6 +69,12 @@ declare const RootConfig: {
             title: string;
             icon: string;
         };
+        teamBusinessUnit: {
+            name: string;
+            source: string;
+            title: string;
+            icon: string;
+        };
         position: {
             name: string;
             source: string;
@@ -124,7 +133,7 @@ interface AXMOrganizationManagementChartNodeEntityModel extends AXPEntityModel<s
     id: string;
     title: AXPMultiLanguageString;
     subtitle?: AXPMultiLanguageString;
-    description?: AXPMultiLanguageString | null;
+    description?: AXPMultiLanguageString;
     isExpanded?: boolean;
     children?: AXMOrganizationManagementChartNodeEntityModel[];
     icon?: string;
@@ -135,14 +144,27 @@ interface AXMOrganizationManagementChartNodeEntityModel extends AXPEntityModel<s
 }
 
 interface AXMOrganizationManagementCompanyEntityModel extends AXPEntityModel<string> {
-    title: string;
+    title: AXPMultiLanguageString;
 }
 
 interface AXMOrganizationManagementPositionEntityModel extends AXPEntityModel<string> {
     code: string;
     title: AXPMultiLanguageString;
     description?: AXPMultiLanguageString;
-    categoriesId?: string[];
+    jobDefinitionId?: string;
+    jobLevelId: string;
+    jobDefinition?: {
+        id: string;
+        title: AXPMultiLanguageString;
+        jobLevelIds?: string[];
+    };
+    jobLevel?: {
+        id: string;
+        title: AXPMultiLanguageString;
+    };
+    capacity?: number;
+    isManager?: boolean;
+    categoryIds?: string[];
     categories?: AXPCategoryListItem[];
 }
 
@@ -150,7 +172,7 @@ interface AXMOrganizationManagementJobDefinitionEntityModel extends AXPEntityMod
     title: AXPMultiLanguageString;
     description?: AXPMultiLanguageString;
     jobLevelIds?: string[];
-    categoriesId?: string[];
+    categoryIds?: string[];
     categories?: {
         id: string;
         title: AXPMultiLanguageString;
@@ -163,13 +185,57 @@ interface AXMOrganizationManagementJobDefinitionEntityModel extends AXPEntityMod
 interface AXMOrganizationManagementTeamEntityModel extends AXPEntityModel<string> {
     code: string;
     title: AXPMultiLanguageString;
-    leaderId: string;
-    memberIds?: string[];
     description?: AXPMultiLanguageString;
 }
 
-interface AXMOrganizationManagementBusinessUnitEntityModel {
-    id: string;
+/**
+ * Junction record linking a {@link Team} to a {@link BusinessUnit} (many-to-many).
+ */
+interface AXMOrganizationManagementTeamBusinessUnitEntityModel extends AXPEntityModel<string> {
+    teamId: string;
+    businessUnitId: string;
+    /** When true, this link is the preferred owning / reporting business unit for the team. */
+    isPrimary: boolean;
+    effectiveFrom?: string | null;
+    effectiveTo?: string | null;
+    team?: {
+        id: string;
+        code: string;
+        title: AXPMultiLanguageString;
+    };
+    businessUnit?: {
+        id: string;
+        code: string;
+        title: AXPMultiLanguageString;
+    };
+}
+
+interface AXMOrganizationManagementTeamMemberEntityModel extends AXPEntityModel<string> {
+    teamId: string;
+    employeeId: string;
+    roleId: string;
+    team?: {
+        id: string;
+        title: AXPMultiLanguageString;
+    };
+    employee?: {
+        id: string;
+        person: {
+            fullName: string;
+        };
+    };
+    role?: {
+        id: string;
+        title: AXPMultiLanguageString;
+    };
+}
+
+interface AXMOrganizationManagementTeamMemberRoleEntityModel extends AXPEntityModel<string> {
+    title: AXPMultiLanguageString;
+    name: string;
+}
+
+interface AXMOrganizationManagementBusinessUnitEntityModel extends AXPEntityModel<string> {
     code: string;
     title: AXPMultiLanguageString;
     description?: AXPMultiLanguageString;
@@ -188,21 +254,36 @@ interface AXMOrganizationManagementBusinessUnitEntityModel {
     headPositionId?: string | null;
     headPosition?: {
         id: string;
-        title: string;
+        title: AXPMultiLanguageString;
     } | null;
     geographicRegionId?: string | null;
     geographicRegion?: {
         id: string;
         title: string;
     } | null;
-    /** Built-in / system units may set `isImmutable` to block destructive edits in UI and policies. */
-    stateInfo?: AXPRecordStateInfo;
+    /** Expanded from `positionIds` for list/detail grids (same shape as lookups). */
+    positions?: {
+        id: string;
+        title: AXPMultiLanguageString;
+    }[];
+}
+
+declare function factory(injector: Injector): Promise<AXPEntity | null>;
+
+interface AXMOrganizationManagementBusinessUnitTypeEntityModel extends AXPEntityModel<string> {
+    title: AXPMultiLanguageString;
+    name: string;
+    isLocationBased?: boolean;
+    /** Filled by the color plugin (palette / hex). */
+    color?: string;
+    /** Filled by the icon plugin (icon class names). */
+    icon?: string;
 }
 
 interface AXMOrganizationManagementResponsibilityEntityModel extends AXPEntityModel<string> {
     title: AXPMultiLanguageString;
     description?: AXPMultiLanguageString;
-    categoriesId?: string[];
+    categoryIds?: string[];
     categories?: {
         id: string;
         title: AXPMultiLanguageString;
@@ -221,6 +302,10 @@ interface AXMOrganizationManagementJobLevelEntityModel extends AXPEntityModel<st
     level?: number;
 }
 
+/**
+ * Chart node data types for organization chart.
+ */
+
 /**
  * Chart nodes use {@link AXPMultiLanguageString} for every user-visible string on the card
  * (`title`, `subtitle`, `description`) so stored chart JSON and the UI respect locale.
@@ -228,7 +313,7 @@ interface AXMOrganizationManagementJobLevelEntityModel extends AXPEntityModel<st
  * - Prefer **locale maps** `{ 'en-US': '…', 'fa-IR': '…' }` (see `createMultiLanguageString` in platform core).
  * - A **plain string** is allowed as a narrow fallback; the resolver treats it as the value for any locale.
  * - **`metadata`** fields that are shown in templates must also be `AXPMultiLanguageString` (or plain string
- *   with the same rules), not English-only literals baked into the feature code.
+ *   with the same rules), not English-only literals baked into feature code.
  */
 declare enum AXMOrgChartNodeType {
     Company = "Company",
@@ -261,7 +346,7 @@ interface AXMOrganizationNode {
     /** Secondary line (e.g. head summary); use locale map when mixing labels and entity titles. */
     subtitle?: AXPMultiLanguageString;
     /** Body / mission text. */
-    description?: AXPMultiLanguageString | null;
+    description?: AXPMultiLanguageString;
     isExpanded?: boolean;
     children?: AXMOrganizationNode[];
     icon?: string;
@@ -271,6 +356,139 @@ interface AXMOrganizationNode {
     /** Rich card data; any **display** field here should use `AXPMultiLanguageString` like the core node fields. */
     metadata?: Record<string, any>;
 }
+/**
+ * Pill badge on org chart node cards (icon + label). {@link title} is translated in the template.
+ */
+interface AXMOrgChartNodeBadgeItem {
+    /** Font Awesome class segment (e.g. `fa-light fa-building`). */
+    icon: string;
+    title: AXPMultiLanguageString;
+}
+/**
+ * Footer metric cell: icon, numeric or short value, and translated label.
+ */
+interface AXMOrgChartNodeFooterMetric {
+    icon: string;
+    /** Plain display value (formatted number or short text). */
+    value: string;
+    title: AXPMultiLanguageString;
+}
+
+type AXMOrgChartNodeKind = 'company-root' | 'business-unit' | 'position' | 'employee' | 'other';
+interface AXMOrgChartNodeContributionContext {
+    node: AXMOrganizationNode;
+    nodeKind: AXMOrgChartNodeKind;
+    selectedMode: 'location' | 'structure' | 'reporting' | 'positionHierarchy';
+    refreshChart: () => Promise<void>;
+}
+interface AXMOrgChartNodeMenuAction {
+    id: string;
+    /** i18n key (`@scope:...`) or legacy {@link AXPMultiLanguageString} map. */
+    title: string | AXPMultiLanguageString;
+    /** Interpolation params for i18n keys (e.g. `{{ type }}`). */
+    titleParams?: Record<string, string | number>;
+    icon?: string;
+    color?: AXStyleColorType;
+    order?: number;
+    disabled?: boolean;
+    /** When true, renders a separator after this item in the context menu. */
+    break?: boolean;
+    /**
+     * Optional flyout: actions that share the same `submenuGroupId` render as children of one parent row.
+     * Use the same `submenuGroupTitle` for every member; `submenuGroupIcon` may be set on any member (first wins).
+     * If `break` is true on any member, the separator is shown after the parent submenu (not between children).
+     */
+    submenuGroupId?: string;
+    submenuGroupTitle?: string | AXPMultiLanguageString;
+    submenuGroupIcon?: string;
+    execute: (context: AXMOrgChartNodeContributionContext) => Promise<void>;
+}
+interface AXMOrgChartNodeInfoContribution {
+    id: string;
+    title: AXPMultiLanguageString;
+    order?: number;
+    load: (context: AXMOrgChartNodeContributionContext) => Promise<unknown>;
+}
+interface AXMOrgChartNodeContributionProvider {
+    getMenuActions(context: AXMOrgChartNodeContributionContext): Promise<AXMOrgChartNodeMenuAction[]>;
+    getInfoContributions?(context: AXMOrgChartNodeContributionContext): Promise<AXMOrgChartNodeInfoContribution[]>;
+}
+declare const AXM_ORG_CHART_NODE_CONTRIBUTOR: InjectionToken<AXMOrgChartNodeContributionProvider[]>;
+
+/**
+ * Injected by org chart node components to access colors, i18n labels, and expand/collapse.
+ */
+interface AXMOrgChartHostApi {
+    getNodeColors(color: string): Record<string, string>;
+    isNodeSelected(data: AXMOrganizationNode): boolean;
+    selectNode(data: AXMOrganizationNode): void;
+    openNodeContextMenuFromMore(event: unknown, data: AXMOrganizationNode): void;
+    readonly chartML: {
+        vacant: AXPMultiLanguageString;
+        directReports: AXPMultiLanguageString;
+        teams: AXPMultiLanguageString;
+        people: AXPMultiLanguageString;
+        positions: AXPMultiLanguageString;
+        chiefExecutive: AXPMultiLanguageString;
+        /** Business unit detail rows: unit head display name and role title from `metadata.unitHead`. */
+        buHead: AXPMultiLanguageString;
+        buPosition: AXPMultiLanguageString;
+        unitType: AXPMultiLanguageString;
+        businessUnit: AXPMultiLanguageString;
+        location: AXPMultiLanguageString;
+        code: AXPMultiLanguageString;
+        capacity: AXPMultiLanguageString;
+        level: AXPMultiLanguageString;
+        email: AXPMultiLanguageString;
+        phone: AXPMultiLanguageString;
+        employmentType: AXPMultiLanguageString;
+        workMode: AXPMultiLanguageString;
+        /** i18n key for the node “more” control (translate pipe). */
+        more: string;
+        /** i18n key when the context menu has no runnable actions. */
+        noActionsAvailable: string;
+    };
+    getTeamsMembershipCount(data: AXMOrganizationNode): number | null;
+    /** When the card body already shows the assignee (merged unit / manager seat), hide `subtitle` so it is not duplicated. */
+    shouldShowOrgCardSubtitle(data: AXMOrganizationNode): boolean;
+    /** Subtree / seat strip: BU & company snapshot stats, or `position-ic` seats (1 position; people from vacant state or subtree). */
+    getSubtreeRosterCounts(data: AXMOrganizationNode): {
+        people: number;
+        positions: number;
+    } | null;
+    /** Key-value rows for the side detail panel only (not rendered on node cards). */
+    getNodeInfoItems(data: AXMOrganizationNode): Array<{
+        label: AXPMultiLanguageString;
+        value: string;
+    }>;
+    toggleNode(data: AXMOrganizationNode, el?: HTMLDivElement | null): void;
+}
+
+/**
+ * Side panel for the organization chart: mirrors document explorer detail-panel layout/styling for node summary and metadata rows.
+ */
+declare class AXMOrgChartDetailPanelComponent {
+    protected readonly host: AXMOrgChartHostApi;
+    protected readonly OrgChartNodeType: typeof AXMOrgChartNodeType;
+    /** Selected tree node, or `null` when nothing is selected. */
+    readonly node: i0.InputSignal<AXMOrganizationNode | null>;
+    /** Emitted when the user closes the panel (matches explorer close control). */
+    readonly panelClose: i0.OutputEmitterRef<void>;
+    /**
+     * CSS custom properties for {@link AXMOrgChartHostApi.getNodeColors}. Use per-property `[style.--*]` bindings;
+     * a plain `[style]` map does not reliably apply `--node-*` variables in all Angular versions.
+     */
+    protected surfaceVarsForNode(node: AXMOrganizationNode): Record<string, string>;
+    protected surfaceVarsForPrimary(): Record<string, string>;
+    /**
+     * Color argument for {@link AXMOrgChartHostApi.getNodeColors}: semantic token or `metadata.unitTypeColor` (hex/rgb) for business units.
+     */
+    protected nodeColorKey(node: AXMOrganizationNode): string;
+    protected onClose(): void;
+    protected nodeIconClass(node: AXMOrganizationNode): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXMOrgChartDetailPanelComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AXMOrgChartDetailPanelComponent, "axm-org-chart-detail-panel", never, { "node": { "alias": "node"; "required": false; "isSignal": true; }; }, { "panelClose": "panelClose"; }, never, never, true, never>;
+}
 
 declare class AXMOrganizationManagementModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<AXMOrganizationManagementModule, never>;
@@ -278,5 +496,5 @@ declare class AXMOrganizationManagementModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<AXMOrganizationManagementModule>;
 }
 
-export { AXMOrgChartCategory, AXMOrgChartNodeType, AXMOrganizationManagementModule, AXM_ORG_CHART_STRUCTURE_SCHEMA_VERSION, RootConfig };
-export type { AXMOrgChartCardTemplate, AXMOrgChartMergedRoleBlock, AXMOrgChartStructurePayload, AXMOrganizationManagementBusinessUnitEntityModel, AXMOrganizationManagementChartEntityModel, AXMOrganizationManagementChartNodeEntityModel, AXMOrganizationManagementCompanyEntityModel, AXMOrganizationManagementJobDefinitionEntityModel, AXMOrganizationManagementJobLevelEntityModel, AXMOrganizationManagementPositionEntityModel, AXMOrganizationManagementResponsibilityEntityModel, AXMOrganizationManagementResponsibilityLevelEntityModel, AXMOrganizationManagementTeamEntityModel, AXMOrganizationNode, OrgChartMode };
+export { AXMOrgChartCategory, AXMOrgChartDetailPanelComponent, AXMOrgChartNodeType, AXMOrganizationManagementModule, AXM_ORG_CHART_NODE_CONTRIBUTOR, AXM_ORG_CHART_STRUCTURE_SCHEMA_VERSION, RootConfig, factory };
+export type { AXMOrgChartCardTemplate, AXMOrgChartMergedRoleBlock, AXMOrgChartNodeBadgeItem, AXMOrgChartNodeContributionContext, AXMOrgChartNodeContributionProvider, AXMOrgChartNodeFooterMetric, AXMOrgChartNodeInfoContribution, AXMOrgChartNodeKind, AXMOrgChartNodeMenuAction, AXMOrgChartStructurePayload, AXMOrganizationManagementBusinessUnitEntityModel, AXMOrganizationManagementBusinessUnitTypeEntityModel, AXMOrganizationManagementChartEntityModel, AXMOrganizationManagementChartNodeEntityModel, AXMOrganizationManagementCompanyEntityModel, AXMOrganizationManagementJobDefinitionEntityModel, AXMOrganizationManagementJobLevelEntityModel, AXMOrganizationManagementPositionEntityModel, AXMOrganizationManagementResponsibilityEntityModel, AXMOrganizationManagementResponsibilityLevelEntityModel, AXMOrganizationManagementTeamBusinessUnitEntityModel, AXMOrganizationManagementTeamEntityModel, AXMOrganizationManagementTeamMemberEntityModel, AXMOrganizationManagementTeamMemberRoleEntityModel, AXMOrganizationNode, OrgChartMode };

package/types/acorex-modules-security-management.d.ts

@@ -120,15 +120,28 @@ declare class AXMSecurityManagementRolesEntityServiceImpl extends AXMSecurityMan
 }
 
 /**
- * Read-only sign-in gate from the authentication layer (distinct from account `statusId`).
+ * Read-only sign-in gate from the authentication layer (distinct from account `accountState`).
  * Persisted as the enum string value (e.g. `allowed`).
  */
-declare enum AXMUserAuthenticationState {
+declare enum AXMUserAccessState {
     Allowed = "allowed",
     Blocked = "blocked",
     Expired = "expired"
 }
 
+/**
+ * Single operational state derived from account lifecycle and sign-in gate (persisted snapshot in mock/backend).
+ */
+declare enum AXMUserEffectiveState {
+    Pending = "pending",
+    Active = "active",
+    Suspended = "suspended",
+    Inactive = "inactive",
+    Archived = "archived",
+    SignInBlocked = "sign-in-blocked",
+    CredentialExpired = "credential-expired"
+}
+
 declare function usersFactory(): Promise<AXPEntity | null>;
 
 declare class AXMSecurityManagementUsersEntityModule {
@@ -142,10 +155,12 @@ interface AXMSecurityManagementUsersEntityModel extends AXPEntityModel<string> {
     username: string;
     displayName: string;
     password: string;
-    /** Account lifecycle: `security-management.status.user`. */
-    statusId?: string;
-    /** Authentication gate (read-only in UI); lockout and password expiry map here, not to `statusId`. */
-    authenticationState?: AXMUserAuthenticationState;
+    /** Account lifecycle: `security-management.account-state.user`. */
+    accountState?: string;
+    /** Derived operational state: `security-management.effective-state.user` (persisted snapshot in demo/mock). */
+    effectiveState?: AXMUserEffectiveState | string;
+    /** Sign-in gate (read-only in UI); lockout and credential expiry map here, not to `accountState`. */
+    accessState?: AXMUserAccessState;
 }
 
 declare abstract class AXMUsersEntityService extends AXMEntityCrudServiceImpl<string, AXMSecurityManagementUsersEntityModel> {
@@ -387,5 +402,15 @@ declare class AXPPermissionsWidgetColumnComponent extends AXPColumnWidgetCompone
 
 declare const AXPPermissionsWidget: AXPWidgetConfig;
 
-export { AXMPermissionsModule, AXMPolicyService, AXMPolicyServiceImpl, AXMSecurityManagementDeviceSessionsEntityModule, AXMSecurityManagementModule, AXMSecurityManagementRolesEntityModule, AXMSecurityManagementRolesEntityService, AXMSecurityManagementRolesEntityServiceImpl, AXMSecurityManagementUsersEntityModule, AXMUserAuthenticationState, AXMUsersEntityService, AXMUsersEntityServiceImpl, AXPPermissionsEditorComponent, AXPPermissionsEditorPopupComponent, AXPPermissionsWidget, AXPPermissionsWidgetColumnComponent, AXPPermissionsWidgetEditComponent, AXPPermissionsWidgetViewComponent, AXPSecurityManagementFeatureKeys, AXPSecurityManagementMenuKeys, AXPSecurityManagementPermissionKeys, RootConfig, deviceSessionsFactory, policyFactory, rolesFactory, usersFactory };
+interface AXMUserEffectiveStateInputs {
+    accountState: string | undefined;
+    accessState: AXMUserAccessState | undefined;
+}
+/**
+ * Derives the unified operational state from account lifecycle and sign-in gate.
+ * Precedence: archived → pending → inactive → suspended → access expired → access blocked → lifecycle active.
+ */
+declare function resolveAXMUserEffectiveState(input: AXMUserEffectiveStateInputs): AXMUserEffectiveState;
+
+export { AXMPermissionsModule, AXMPolicyService, AXMPolicyServiceImpl, AXMSecurityManagementDeviceSessionsEntityModule, AXMSecurityManagementModule, AXMSecurityManagementRolesEntityModule, AXMSecurityManagementRolesEntityService, AXMSecurityManagementRolesEntityServiceImpl, AXMSecurityManagementUsersEntityModule, AXMUserAccessState, AXMUserEffectiveState, AXMUsersEntityService, AXMUsersEntityServiceImpl, AXPPermissionsEditorComponent, AXPPermissionsEditorPopupComponent, AXPPermissionsWidget, AXPPermissionsWidgetColumnComponent, AXPPermissionsWidgetEditComponent, AXPPermissionsWidgetViewComponent, AXPSecurityManagementFeatureKeys, AXPSecurityManagementMenuKeys, AXPSecurityManagementPermissionKeys, RootConfig, deviceSessionsFactory, policyFactory, resolveAXMUserEffectiveState, rolesFactory, usersFactory };
 export type { AXMPolicyEffect, AXMPolicyEffectRule, AXMPolicyScope, AXMSecurityManagementPolicyEntityModel, AXMSecurityManagementRolesEntityModel, AXMSecurityManagementUsersEntityModel };