@acorex-platform/module-location-management-client 0.0.15 → 0.0.18

package/fesm2022/acorex-platform-module-location-management-client-contracts.mjs

@@ -0,0 +1,2694 @@
+import { AXPSystemActionType, resolveMultiLanguageString, formatAddressData, AXPWidgetsList, AXPWidgetsCatalog, AXPRegionalSetting } from '@acorex-platform/framework-shared/core';
+import { entityMasterCreateAction, entityMasterBulkDeleteAction, entityMasterDeleteAction, entityMasterViewAction, AXPEntityCommandScope, entityDetailsEditAction, entityOverrideDetailsViewAction, createAllQueryView, entityMasterCrudActions, entityMasterRecordActions } from '@acorex-platform/framework-shared/entity';
+import { AXPLocaleManagementDataSourceKeys } from '@acorex-platform/module-locale-management-contracts';
+
+//#region ---- Datasource keys ----
+/** Location Management datasource registry names. */
+const AXMLocationManagementDataSourceKeys = {
+    Countries: 'countries',
+    Provinces: 'provinces',
+    Cities: 'cities',
+};
+//#endregion
+
+// Management feature removed - module name is used directly as feature key
+const AXMLocationManagementFeatureKeys = {};
+
+const config = {
+    i18n: 'location-management',
+};
+const RootConfig = {
+    config,
+    module: {
+        name: 'LocationManagement',
+        title: '@location-management:module.title',
+        icon: 'fa-light fa-map-marker-alt',
+    },
+    entities: {
+        location: {
+            name: 'Location',
+            title: '@location-management:locations.entities.location.title',
+            titlePlural: '@location-management:locations.entities.location.plural',
+            icon: 'fa-light fa-map-marker-alt',
+        },
+        locationType: {
+            name: 'LocationType',
+            title: '@location-management:location-types.entities.location-type.title',
+            titlePlural: '@location-management:location-types.entities.location-type.plural',
+            icon: 'fa-light fa-tags',
+        },
+        locationRole: {
+            name: 'LocationRole',
+            title: '@location-management:location-roles.entities.location-role.title',
+            titlePlural: '@location-management:location-roles.entities.location-role.plural',
+            icon: 'fa-light fa-map-pin',
+        },
+        geographicRegion: {
+            name: 'GeographicRegion',
+            title: '@location-management:geographic-regions.entities.geographic-region.title',
+            titlePlural: '@location-management:geographic-regions.entities.geographic-region.plural',
+            icon: 'fa-light fa-globe',
+        },
+        locationAssignment: {
+            name: 'LocationAssignment',
+            title: `@${config.i18n}:location-assignments.entities.location-assignment.title`,
+            titlePlural: `@${config.i18n}:location-assignments.entities.location-assignment.plural`,
+            icon: 'fa-light fa-building-user',
+        },
+    },
+};
+
+//#region ---- Command keys ----
+const ASSIGN_EXISTING_LOCATION = `${RootConfig.module.name}.${RootConfig.entities.locationAssignment.name}:AssignExistingLocation`;
+const CREATE_WITH_NEW_LOCATION = `${RootConfig.module.name}.${RootConfig.entities.locationAssignment.name}:CreateWithNewLocation`;
+//#endregion
+//#region ---- Location assignment related-entity actions ----
+const assigneeProcessOptions = () => ({
+    process: {
+        redirect: false,
+        canCreateNewOne: true,
+        data: {
+            'ownerRef.type': '{{ host.entity() }}',
+            'ownerRef.id': '{{ host.eval("id") }}',
+            'ownerRef.title': '{{ host.eval("party.title") }}',
+        },
+    },
+});
+/** Read-only assignments list on Location detail (no create/update/delete). */
+function locationAssignmentReadOnlyRelatedActions() {
+    return [
+        { ...entityMasterCreateAction(), hidden: true },
+        { ...entityMasterBulkDeleteAction(), hidden: true },
+        { ...entityMasterDeleteAction(), hidden: true },
+        { ...entityMasterViewAction(), hidden: true },
+    ];
+}
+function locationAssignmentPartyCreateAction() {
+    const assigneeOptions = assigneeProcessOptions();
+    return {
+        name: 'Create',
+        title: '@general:actions.create.title',
+        command: { name: 'Entity:Create' },
+        icon: 'fa-light fa-plus',
+        priority: 'primary',
+        type: AXPSystemActionType.Create,
+        scope: AXPEntityCommandScope.TypeLevel,
+        items: [
+            {
+                name: 'AssignExistingLocation',
+                title: '@location-management:location-assignments.actions.assign-existing-location.title',
+                command: { name: ASSIGN_EXISTING_LOCATION, options: assigneeOptions },
+                icon: 'fa-light fa-map-marker-alt',
+                priority: 'primary',
+                type: AXPSystemActionType.Create,
+                scope: AXPEntityCommandScope.TypeLevel,
+            },
+            {
+                name: 'CreateWithNewLocation',
+                title: '@location-management:location-assignments.actions.create-with-new-location.title',
+                command: { name: CREATE_WITH_NEW_LOCATION, options: assigneeOptions },
+                icon: 'fa-light fa-location-plus',
+                priority: 'primary',
+                type: AXPSystemActionType.Create,
+                scope: AXPEntityCommandScope.TypeLevel,
+            },
+        ],
+    };
+}
+/**
+ * Actions for LocationAssignment when shown from Party/Customer/Supplier.
+ * Create menu: assign existing location or create new location with assignee prefilled.
+ */
+function locationAssignmentDetailsCrudActionsForPartyContext(_partyIdContextPath = 'id') {
+    return [
+        { ...entityMasterCreateAction(), hidden: true },
+        locationAssignmentPartyCreateAction(),
+        entityDetailsEditAction(),
+        entityOverrideDetailsViewAction(),
+    ];
+}
+//#endregion
+
+//#region ---- Imports ----
+//#endregion
+//#region ---- Constants ----
+/** Canonical assignee type for party-scoped location assignment links. */
+const LOCATION_ASSIGNMENT_PARTY_TYPE = 'BusinessCore.Party';
+//#endregion
+//#region ---- Display helpers ----
+/** Resolves assignee display title from host/process data (plain string or multi-language object). */
+function resolveLocationAssignmentDisplayTitle(locale, ...candidates) {
+    for (const candidate of candidates) {
+        if (candidate == null || candidate === '') {
+            continue;
+        }
+        const resolved = resolveMultiLanguageString(candidate, locale).trim();
+        if (resolved) {
+            return resolved;
+        }
+    }
+    return '';
+}
+/** Builds a location snapshot for nested LocationAssignment display fields. */
+function buildLocationAssignmentLocationSnapshot(locationRow, locationId) {
+    const fullAddress = locationRow['fullAddress']?.trim() || formatAddressData(locationRow)?.trim() || undefined;
+    const toRegionRef = (value) => {
+        if (value == null) {
+            return undefined;
+        }
+        if (typeof value === 'object') {
+            const record = value;
+            const title = record['title'];
+            return title != null ? { title: String(title) } : undefined;
+        }
+        return { title: String(value) };
+    };
+    return {
+        id: locationId,
+        title: locationRow['title'],
+        fullAddress,
+        street1: locationRow['street1'],
+        street2: locationRow['street2'],
+        postalCode: locationRow['postalCode'],
+        city: toRegionRef(locationRow['city']),
+        state: toRegionRef(locationRow['state']),
+        country: toRegionRef(locationRow['country']),
+    };
+}
+/** Builds a person snapshot for nested LocationAssignment site-contact fields. */
+function buildLocationAssignmentPersonSnapshot(personRow, personId) {
+    const fullName = personRow['fullName'] ??
+        [personRow['firstName'], personRow['lastName']].filter(Boolean).join(' ').trim();
+    return {
+        id: personId,
+        fullName: fullName || undefined,
+        phones: personRow['phones'],
+        emails: personRow['emails'],
+    };
+}
+//#endregion
+//#region ---- Filter helpers ----
+/** Filters LocationAssignment rows for a location detail context. */
+function locationAssignmentLocationConditions(locationIdContextPath = 'id') {
+    return [
+        {
+            name: 'locationId',
+            operator: { type: 'equal' },
+            value: `{{context.eval("${locationIdContextPath}")}}`,
+        },
+    ];
+}
+/** Filters LocationAssignment rows for the current details-view host entity. */
+function locationAssignmentPartyConditions(hostIdContextPath = 'id') {
+    return [
+        {
+            name: 'ownerRef.type',
+            operator: { type: 'equal' },
+            value: '{{ host.entity() }}',
+        },
+        {
+            name: 'ownerRef.id',
+            operator: { type: 'equal' },
+            value: `{{ host.eval("${hostIdContextPath}") }}`,
+        },
+    ];
+}
+//#endregion
+//#region ---- Form layout helpers ----
+/** Assignee lookup omitted when injected from party/customer/supplier context. */
+const LOCATION_ASSIGNMENT_REF_PROPERTY_NAMES = ['ownerRef.id', 'ownerRef.type'];
+/** Location lookup omitted when injected from location detail context. */
+const LOCATION_ASSIGNMENT_LOCATION_PROPERTY_NAMES = ['locationId'];
+function omitLocationAssignmentRefFromEditLayouts(layouts) {
+    return layouts.filter((layout) => !LOCATION_ASSIGNMENT_REF_PROPERTY_NAMES.includes(layout.name));
+}
+function omitLocationAssignmentLocationFromEditLayouts(layouts) {
+    return layouts.filter((layout) => !LOCATION_ASSIGNMENT_LOCATION_PROPERTY_NAMES.includes(layout.name));
+}
+//#endregion
+//#region ---- Property factories ----
+/** Polymorphic assignee lookup (AssessmentCase subjectRef pattern). */
+function createLocationAssignmentOwnerRefLookupProperty(groupId, options = {}) {
+    const readonly = options.readonly ?? false;
+    return {
+        name: 'ownerRef.id',
+        title: '@location-management:location-assignments.entities.location-assignment.fields.assignee.title',
+        groupId,
+        options: readonly
+            ? { sort: { enabled: false }, filter: { advance: { enabled: false }, inline: { enabled: false } } }
+            : { sort: { enabled: true }, filter: { advance: { enabled: true }, inline: { enabled: true } } },
+        schema: {
+            dataType: 'string',
+            readonly,
+            interface: {
+                type: AXPWidgetsList.Editors.LookupBox,
+                options: {
+                    readonly,
+                    entity: "{{ context.eval('ownerRef.type') }}",
+                    textField: 'title',
+                    valueField: 'id',
+                    expose: [
+                        { source: 'id', target: 'ownerRef.id' },
+                        { source: 'title', target: 'ownerRef.title' },
+                    ],
+                    triggers: [{ event: "{{ events.context('ownerRef.type') }}", action: '{{ widget.refresh() }}' }],
+                },
+            },
+        },
+        validations: [{ rule: 'required' }],
+    };
+}
+/** Hidden assignee type field; defaults to BusinessCore.Party. */
+function createLocationAssignmentOwnerRefTypeProperty(groupId) {
+    return {
+        name: 'ownerRef.type',
+        title: '@location-management:location-assignments.entities.location-assignment.fields.assignee-type.title',
+        groupId,
+        schema: {
+            dataType: 'string',
+            visible: false,
+            defaultValue: LOCATION_ASSIGNMENT_PARTY_TYPE,
+            interface: { type: AXPWidgetsList.Editors.TextBox },
+        },
+    };
+}
+//#endregion
+
+const AXPLocationManagementMenuKeys = {
+    Root: 'location-management:menu',
+    Locations: 'location-management:menu:locations',
+    Divider1: 'location-management:menu:divider-1',
+    LocationTypes: 'location-management:menu:location-types',
+    LocationRoles: 'location-management:menu:location-roles',
+    GeographicRegions: 'location-management:menu:geographic-regions',
+};
+
+const moduleKey = RootConfig.module.name;
+const entitiesKey = RootConfig.entities;
+const manageKey = AXPSystemActionType.Manage;
+const viewKey = AXPSystemActionType.View;
+const updateKey = AXPSystemActionType.Update;
+const deleteKey = AXPSystemActionType.Delete;
+const createKey = AXPSystemActionType.Create;
+const AXMLocationManagementPermissionsKeys = {
+    LocationManagement: {
+        Management: `${moduleKey}:${manageKey}`,
+        Locations: {
+            Management: `${moduleKey}:${entitiesKey.location.name}:${manageKey}`,
+            View: `${moduleKey}:${entitiesKey.location.name}:${viewKey}`,
+            Edit: `${moduleKey}:${entitiesKey.location.name}:${updateKey}`,
+            Delete: `${moduleKey}:${entitiesKey.location.name}:${deleteKey}`,
+            Create: `${moduleKey}:${entitiesKey.location.name}:${createKey}`,
+        },
+        LocationTypes: {
+            Management: `${moduleKey}:${entitiesKey.locationType.name}:${manageKey}`,
+            View: `${moduleKey}:${entitiesKey.locationType.name}:${viewKey}`,
+            Edit: `${moduleKey}:${entitiesKey.locationType.name}:${updateKey}`,
+            Delete: `${moduleKey}:${entitiesKey.locationType.name}:${deleteKey}`,
+            Create: `${moduleKey}:${entitiesKey.locationType.name}:${createKey}`,
+        },
+        LocationRoles: {
+            Management: `${moduleKey}:${entitiesKey.locationRole.name}:${manageKey}`,
+            View: `${moduleKey}:${entitiesKey.locationRole.name}:${viewKey}`,
+            Edit: `${moduleKey}:${entitiesKey.locationRole.name}:${updateKey}`,
+            Delete: `${moduleKey}:${entitiesKey.locationRole.name}:${deleteKey}`,
+            Create: `${moduleKey}:${entitiesKey.locationRole.name}:${createKey}`,
+        },
+        GeographicRegions: {
+            Management: `${moduleKey}:${entitiesKey.geographicRegion.name}:${manageKey}`,
+            View: `${moduleKey}:${entitiesKey.geographicRegion.name}:${viewKey}`,
+            Edit: `${moduleKey}:${entitiesKey.geographicRegion.name}:${updateKey}`,
+            Delete: `${moduleKey}:${entitiesKey.geographicRegion.name}:${deleteKey}`,
+            Create: `${moduleKey}:${entitiesKey.geographicRegion.name}:${createKey}`,
+        },
+    },
+};
+
+async function geographicRegionFactory() {
+    const entityDef = {
+        module: RootConfig.module.name,
+        name: RootConfig.entities.geographicRegion.name,
+        parentKey: 'parentId',
+        title: RootConfig.entities.geographicRegion.title,
+        icon: RootConfig.entities.geographicRegion.icon,
+        formats: {
+            individual: RootConfig.entities.geographicRegion.title,
+            plural: RootConfig.entities.geographicRegion.titlePlural,
+            searchResult: {
+                title: '{{ name }}',
+                description: '{{ context.eval("type") + (context.eval("parentId") ? " (Child)" : "") }}',
+            },
+        },
+        plugins: [{ name: 'archive' }],
+        groups: [
+            {
+                id: 'basic-info',
+                title: '@general:terms.interface.basic-info',
+            },
+            {
+                id: 'geographic-data',
+                title: '@general:terms.interface.geographic-details',
+            },
+            {
+                id: 'additional-info',
+                title: '@general:terms.interface.additional-info',
+            },
+            {
+                id: 'settings',
+                title: '@general:terms.interface.settings',
+            },
+        ],
+        properties: [
+            {
+                name: 'title',
+                title: '@general:terms.common.title',
+                groupId: 'basic-info',
+                options: {
+                    sort: {
+                        enabled: true,
+                    },
+                    filter: {
+                        advance: {
+                            enabled: true,
+                        },
+                        inline: {
+                            enabled: true,
+                        },
+                    },
+                },
+                schema: {
+                    dataType: 'string',
+                    interface: {
+                        type: AXPWidgetsCatalog.text,
+                        options: {
+                            placeholder: 'Enter region title',
+                        },
+                    },
+                },
+                validations: [
+                    {
+                        rule: 'required',
+                    },
+                ],
+            },
+            {
+                name: 'code',
+                title: '@general:terms.common.code',
+                groupId: 'basic-info',
+                options: {
+                    sort: {
+                        enabled: true,
+                    },
+                    filter: {
+                        advance: {
+                            enabled: true,
+                        },
+                        inline: {
+                            enabled: true,
+                        },
+                    },
+                },
+                schema: {
+                    dataType: 'string',
+                    interface: {
+                        type: AXPWidgetsCatalog.text,
+                        options: {
+                            placeholder: 'Region code (e.g., CA, US)',
+                        },
+                    },
+                },
+            },
+            {
+                name: 'type',
+                title: '@location-management:geographic-regions.entities.geographic-region.fields.type',
+                groupId: 'basic-info',
+                options: {
+                    sort: {
+                        enabled: true,
+                    },
+                    filter: {
+                        advance: {
+                            enabled: true,
+                        },
+                        inline: {
+                            enabled: true,
+                        },
+                    },
+                },
+                schema: {
+                    dataType: 'string',
+                    interface: {
+                        type: AXPWidgetsCatalog.select,
+                        options: {
+                            valueField: 'code',
+                            textField: 'title',
+                            dataSource: [
+                                { code: 'country', title: 'Country' },
+                                { code: 'state', title: 'State/Province' },
+                                { code: 'city', title: 'City' },
+                                { code: 'district', title: 'District' },
+                                { code: 'subdistrict', title: 'Subdistrict' },
+                                { code: 'territory', title: 'Territory' },
+                            ],
+                        },
+                    },
+                },
+                validations: [
+                    {
+                        rule: 'required',
+                    },
+                ],
+            },
+            {
+                name: 'parentId',
+                title: '@location-management:geographic-regions.entities.geographic-region.fields.parent-region',
+                groupId: 'basic-info',
+                options: {
+                    filter: {
+                        advance: {
+                            enabled: true,
+                        },
+                        inline: {
+                            enabled: true,
+                        },
+                    },
+                },
+                schema: {
+                    dataType: 'object',
+                    interface: {
+                        type: AXPWidgetsCatalog.lookup,
+                        options: {
+                            entity: `${RootConfig.module.name}.${RootConfig.entities.geographicRegion.name}`,
+                            expose: [
+                                { source: 'id', target: 'parentRegion.id' },
+                                { source: 'name', target: 'parentRegion.name' },
+                                { source: 'type', target: 'parentRegion.type' },
+                            ],
+                        },
+                    },
+                },
+            },
+            {
+                name: 'coordinates',
+                title: '@location-management:geographic-regions.entities.geographic-region.fields.coordinates',
+                groupId: 'geographic-data',
+                options: {
+                    filter: {
+                        advance: {
+                            enabled: false,
+                        },
+                    },
+                },
+                schema: {
+                    dataType: 'string',
+                    interface: {
+                        type: AXPWidgetsCatalog.map,
+                        options: {
+                            hasDraw: true,
+                            maxPolygon: 0,
+                            fitToDraw: true,
+                        },
+                    },
+                },
+            },
+            {
+                name: 'timezone',
+                title: '@location-management:geographic-regions.entities.geographic-region.fields.timezone',
+                groupId: 'geographic-data',
+                options: {
+                    filter: {
+                        advance: {
+                            enabled: true,
+                        },
+                    },
+                },
+                schema: {
+                    dataType: 'string',
+                    defaultValue: `{{ settings.get('${AXPRegionalSetting.TimeZone}') }}`,
+                    interface: {
+                        type: AXPWidgetsCatalog.select,
+                        options: {
+                            allowSearch: true,
+                            valueField: 'code',
+                            placeholder: 'e.g., America/New_York',
+                            dataSource: AXPLocaleManagementDataSourceKeys.Timezones,
+                        },
+                    },
+                },
+            },
+            {
+                name: 'population',
+                title: '@location-management:geographic-regions.entities.geographic-region.fields.population',
+                groupId: 'additional-info',
+                options: {
+                    filter: {
+                        advance: {
+                            enabled: true,
+                        },
+                    },
+                },
+                schema: {
+                    dataType: 'number',
+                    interface: {
+                        type: AXPWidgetsCatalog.number,
+                        options: {
+                            minValue: 0,
+                        },
+                    },
+                },
+            },
+            {
+                name: 'area',
+                title: '@location-management:geographic-regions.entities.geographic-region.fields.area',
+                groupId: 'additional-info',
+                options: {
+                    filter: {
+                        advance: {
+                            enabled: true,
+                        },
+                    },
+                },
+                schema: {
+                    dataType: 'number',
+                    interface: {
+                        type: AXPWidgetsCatalog.number,
+                        options: {
+                            minValue: 0,
+                            placeholder: 'Area in square kilometers',
+                        },
+                    },
+                },
+            },
+            {
+                name: 'currencyId',
+                title: '@location-management:geographic-regions.entities.geographic-region.fields.currency',
+                groupId: 'additional-info',
+                options: {
+                    sort: { enabled: false },
+                    filter: {
+                        advance: {
+                            enabled: true,
+                        },
+                        inline: { enabled: false },
+                    },
+                },
+                schema: {
+                    dataType: 'string',
+                    interface: {
+                        type: AXPWidgetsCatalog.lookup,
+                        options: {
+                            entity: `${"FinancialCore"}.${"Currency"}`,
+                            multiple: false,
+                            look: 'select',
+                            textField: 'code',
+                            valueField: 'id',
+                            expose: [
+                                { source: 'id', target: 'currency.id' },
+                                { source: 'code', target: 'currency.code' },
+                                { source: 'title', target: 'currency.title' },
+                                { source: 'symbol', target: 'currency.symbol' },
+                            ],
+                        },
+                    },
+                },
+            },
+        ],
+        columns: [
+            { name: 'title', options: { width: '400px', order: 1 } },
+            { name: 'code', options: { width: '150px', order: 2 } },
+            { name: 'type', options: { width: '150px', dataPath: 'type.title', order: 3 } },
+            { name: 'currencyId', options: { width: '150px', dataPath: 'currency.code', order: 4 } },
+        ],
+        interfaces: {
+            master: {
+                create: {
+                    sections: [
+                        {
+                            id: 'basic-info',
+                        },
+                        {
+                            id: 'geographic-data',
+                        },
+                        {
+                            id: 'additional-info',
+                        },
+                        {
+                            id: 'settings',
+                        },
+                    ],
+                    properties: [
+                        {
+                            name: 'title',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                    md: {
+                                        colSpan: 6,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'code',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                    md: {
+                                        colSpan: 6,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'type',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                    md: {
+                                        colSpan: 6,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'parentId',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                    md: {
+                                        colSpan: 6,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'coordinates',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'timezone',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                    md: {
+                                        colSpan: 4,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'population',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                    md: {
+                                        colSpan: 4,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'area',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                    md: {
+                                        colSpan: 4,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'currencyId',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                    md: {
+                                        colSpan: 4,
+                                    },
+                                },
+                            },
+                        },
+                    ],
+                },
+                update: {
+                    sections: [
+                        {
+                            id: 'basic-info',
+                        },
+                        {
+                            id: 'geographic-data',
+                        },
+                        {
+                            id: 'additional-info',
+                        },
+                        {
+                            id: 'settings',
+                        },
+                    ],
+                    properties: [
+                        {
+                            name: 'title',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                    md: {
+                                        colSpan: 6,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'code',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                    md: {
+                                        colSpan: 6,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'type',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                    md: {
+                                        colSpan: 6,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'parentId',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                    md: {
+                                        colSpan: 6,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'coordinates',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'timezone',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                    md: {
+                                        colSpan: 4,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'population',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                    md: {
+                                        colSpan: 4,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'area',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                    md: {
+                                        colSpan: 4,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'currencyId',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                    md: {
+                                        colSpan: 4,
+                                    },
+                                },
+                            },
+                        },
+                    ],
+                },
+                single: {
+                    title: '{{title}}',
+                    sections: [
+                        {
+                            id: 'basic-info',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 12,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            id: 'geographic-data',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 12,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            id: 'additional-info',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 12,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            id: 'settings',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 12,
+                                    },
+                                },
+                            },
+                        },
+                    ],
+                    properties: [
+                        {
+                            name: 'title',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 6,
+                                        order: 1,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'code',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 6,
+                                        order: 2,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'type',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 6,
+                                        order: 3,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'parentId',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 6,
+                                        order: 4,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'coordinates',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 12,
+                                        order: 5,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'timezone',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 4,
+                                        order: 6,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'population',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 4,
+                                        order: 7,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'area',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 4,
+                                        order: 8,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'currencyId',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 4,
+                                        order: 9,
+                                    },
+                                },
+                            },
+                        },
+                    ],
+                    actions: [...entityMasterRecordActions()],
+                },
+                list: {
+                    actions: [...entityMasterCrudActions()],
+                    views: [
+                        createAllQueryView({
+                            sorts: [{ name: 'title', dir: 'asc' }],
+                        }),
+                    ],
+                },
+            },
+        },
+    };
+    return entityDef;
+}
+
+async function locationFactory() {
+    const entityDef = {
+        module: RootConfig.module.name,
+        name: RootConfig.entities.location.name,
+        icon: 'fa-solid fa-location-dot',
+        title: RootConfig.entities.location.title,
+        formats: {
+            individual: RootConfig.entities.location.title,
+            plural: RootConfig.entities.location.titlePlural,
+            searchResult: {
+                title: '{{ title }}',
+                description: '{{ fullAddress }}',
+            },
+        },
+        plugins: [
+            { name: 'archive' },
+            {
+                name: 'computed-property',
+                options: {
+                    fields: [
+                        {
+                            name: 'fullAddress',
+                            title: '@general:terms.common.address',
+                            value: '{{ address.format({ street1: context.eval("street1"), street2: context.eval("street2"), country: context.eval("country"), state: context.eval("state"), city: context.eval("city"), postalCode: context.eval("postalCode") }) }}',
+                            group: {
+                                id: 'address',
+                                title: '@location-management:locations.entities.location.groups.address-details',
+                            },
+                            visible: false,
+                            recompute: { middleware: true },
+                            showAs: { type: AXPWidgetsCatalog.text },
+                        },
+                    ],
+                },
+            },
+        ],
+        groups: [
+            {
+                id: 'basic-info',
+                title: '@general:terms.interface.basic-info',
+            },
+            {
+                id: 'address',
+                title: '@location-management:locations.entities.location.groups.address-details',
+            },
+            {
+                id: 'geographic',
+                title: '@general:terms.interface.geographic-details',
+            },
+            {
+                id: 'additional',
+                title: '@general:terms.interface.additional-info',
+            },
+        ],
+        properties: [
+            {
+                name: 'code',
+                title: '@location-management:locations.entities.location.fields.code',
+                groupId: 'basic-info',
+                options: {
+                    sort: {
+                        enabled: true,
+                    },
+                    filter: {
+                        advance: {
+                            enabled: true,
+                        },
+                        inline: {
+                            enabled: true,
+                        },
+                    },
+                },
+                schema: {
+                    dataType: 'string',
+                    interface: {
+                        type: AXPWidgetsCatalog.text,
+                        options: {
+                            placeholder: 'Optional location code',
+                        },
+                    },
+                },
+            },
+            {
+                name: 'title',
+                title: '@general:terms.common.title',
+                groupId: 'basic-info',
+                options: {
+                    sort: {
+                        enabled: true,
+                    },
+                    filter: {
+                        advance: {
+                            enabled: true,
+                        },
+                        inline: {
+                            enabled: true,
+                        },
+                    },
+                },
+                schema: {
+                    dataType: 'string',
+                    interface: {
+                        type: AXPWidgetsCatalog.text,
+                        options: {
+                            placeholder: 'Enter location name',
+                        },
+                    },
+                },
+                validations: [
+                    {
+                        rule: 'required',
+                    },
+                ],
+            },
+            {
+                name: 'locationTypeId',
+                title: '@location-management:locations.entities.location.fields.location-type',
+                groupId: 'basic-info',
+                options: {
+                    sort: {
+                        enabled: true,
+                    },
+                    filter: {
+                        advance: {
+                            enabled: true,
+                        },
+                        inline: {
+                            enabled: true,
+                        },
+                    },
+                },
+                schema: {
+                    dataType: 'object',
+                    interface: {
+                        type: AXPWidgetsCatalog.lookup,
+                        options: {
+                            entity: `${RootConfig.module.name}.${RootConfig.entities.locationType.name}`,
+                            look: 'select',
+                            expose: [
+                                { source: 'id', target: 'locationType.id' },
+                                { source: 'title', target: 'locationType.title' },
+                            ],
+                        },
+                    },
+                },
+                validations: [
+                    {
+                        rule: 'required',
+                    },
+                ],
+            },
+            {
+                name: 'street1',
+                title: '@location-management:locations.entities.location.fields.street1',
+                groupId: 'address',
+                options: {
+                    sort: {
+                        enabled: true,
+                    },
+                    filter: {
+                        advance: {
+                            enabled: true,
+                        },
+                        inline: {
+                            enabled: true,
+                        },
+                    },
+                },
+                schema: {
+                    dataType: 'string',
+                    interface: {
+                        type: AXPWidgetsCatalog.text,
+                        options: {
+                            placeholder: 'Enter street address',
+                        },
+                    },
+                },
+                validations: [
+                    {
+                        rule: 'required',
+                    },
+                ],
+            },
+            {
+                name: 'street2',
+                title: '@location-management:locations.entities.location.fields.street2',
+                groupId: 'address',
+                options: {
+                    filter: {
+                        advance: {
+                            enabled: true,
+                        },
+                    },
+                },
+                schema: {
+                    dataType: 'string',
+                    interface: {
+                        type: AXPWidgetsCatalog.text,
+                        options: {
+                            placeholder: 'Apartment, suite, etc.',
+                        },
+                    },
+                },
+            },
+            {
+                name: 'countryId',
+                title: '@location-management:locations.entities.location.fields.country',
+                groupId: 'address',
+                options: {
+                    sort: {
+                        enabled: true,
+                    },
+                    filter: {
+                        advance: {
+                            enabled: true,
+                        },
+                        inline: {
+                            enabled: true,
+                        },
+                    },
+                },
+                schema: {
+                    dataType: 'object',
+                    interface: {
+                        type: AXPWidgetsCatalog.lookup,
+                        options: {
+                            entity: `${RootConfig.module.name}.${RootConfig.entities.geographicRegion.name}`,
+                            look: 'select',
+                            allowCreate: 'quick',
+                            create: {
+                                enable: true,
+                            },
+                            expose: [
+                                { source: 'id', target: 'country.id' },
+                                { source: 'title', target: 'country.title' },
+                            ],
+                            filter: {
+                                logic: 'and',
+                                filters: [
+                                    { field: 'type.code', operator: { type: 'equal' }, value: 'country' },
+                                ],
+                            },
+                        },
+                    },
+                },
+            },
+            {
+                name: 'stateId',
+                title: '@location-management:locations.entities.location.fields.state',
+                groupId: 'address',
+                options: {
+                    filter: {
+                        advance: {
+                            enabled: true,
+                        },
+                        inline: {
+                            enabled: true,
+                        },
+                    },
+                },
+                schema: {
+                    dataType: 'object',
+                    interface: {
+                        type: AXPWidgetsCatalog.lookup,
+                        options: {
+                            look: 'select',
+                            entity: `${RootConfig.module.name}.${RootConfig.entities.geographicRegion.name}`,
+                            allowCreate: 'quick',
+                            disabled: '{{ !context.eval("countryId") }}',
+                            create: {
+                                enable: true,
+                                context: {
+                                    parentId: '{{ context.eval("countryId") }}',
+                                    type: { code: 'state' },
+                                },
+                            },
+                            expose: [
+                                { source: 'id', target: 'state.id' },
+                                { source: 'title', target: 'state.title' },
+                            ],
+                            filter: {
+                                logic: 'and',
+                                filters: [
+                                    {
+                                        field: 'parentId',
+                                        operator: {
+                                            type: 'equal',
+                                        },
+                                        value: '{{ context.eval("countryId") }}',
+                                    },
+                                    {
+                                        field: 'type.code',
+                                        operator: {
+                                            type: 'equal',
+                                        },
+                                        value: 'state',
+                                    },
+                                ],
+                            },
+                        },
+                        triggers: [
+                            {
+                                event: "{{ events.context('countryId') }}",
+                                action: `{{ widget.setValue(null); context.set('state.title', null); context.set('cityId', null); context.set('city.id', null); context.set('city.title', null); widget.refresh(); }}`,
+                            },
+                        ],
+                    },
+                },
+            },
+            {
+                name: 'cityId',
+                title: '@location-management:locations.entities.location.fields.city',
+                groupId: 'address',
+                options: {
+                    filter: {
+                        advance: {
+                            enabled: true,
+                        },
+                        inline: {
+                            enabled: true,
+                        },
+                    },
+                },
+                schema: {
+                    dataType: 'object',
+                    interface: {
+                        type: AXPWidgetsCatalog.lookup,
+                        options: {
+                            look: 'select',
+                            entity: `${RootConfig.module.name}.${RootConfig.entities.geographicRegion.name}`,
+                            allowCreate: 'quick',
+                            disabled: '{{ !context.eval("stateId") }}',
+                            create: {
+                                enable: true,
+                                context: {
+                                    parentId: '{{ context.eval("stateId") }}',
+                                    type: { code: 'city' },
+                                },
+                            },
+                            expose: [
+                                { source: 'id', target: 'city.id' },
+                                { source: 'title', target: 'city.title' },
+                            ],
+                            filter: {
+                                logic: 'and',
+                                filters: [
+                                    {
+                                        field: 'parentId',
+                                        operator: {
+                                            type: 'equal',
+                                        },
+                                        value: '{{ context.eval("stateId") }}',
+                                    },
+                                    {
+                                        field: 'type.code',
+                                        operator: {
+                                            type: 'equal',
+                                        },
+                                        value: 'city',
+                                    },
+                                ],
+                            },
+                        },
+                        triggers: [
+                            {
+                                event: "{{ events.context('stateId') }}",
+                                action: `{{ widget.setValue(null); context.set('city.title', null); widget.refresh(); }}`,
+                            },
+                            {
+                                event: "{{ events.context('countryId') }}",
+                                action: `{{ widget.setValue(null); context.set('city.title', null); widget.refresh(); }}`,
+                            },
+                        ],
+                    },
+                },
+            },
+            {
+                name: 'postalCode',
+                title: '@location-management:locations.entities.location.fields.postal-code',
+                groupId: 'address',
+                options: {
+                    filter: {
+                        advance: {
+                            enabled: true,
+                        },
+                        inline: {
+                            enabled: true,
+                        },
+                    },
+                },
+                schema: {
+                    dataType: 'string',
+                    interface: {
+                        type: AXPWidgetsCatalog.text,
+                        options: {
+                            placeholder: 'Postal/ZIP code',
+                        },
+                    },
+                },
+                validations: [
+                    {
+                        rule: 'required',
+                    },
+                ],
+            },
+            {
+                name: 'hasCoordinates',
+                title: '@location-management:locations.entities.location.fields.coordinates',
+                groupId: 'geographic',
+                schema: {
+                    dataType: 'boolean',
+                    defaultValue: false,
+                    interface: {
+                        type: AXPWidgetsCatalog.toggle,
+                    },
+                },
+            },
+            {
+                name: 'coordinates',
+                title: '@location-management:locations.entities.location.fields.coordinates',
+                groupId: 'geographic',
+                schema: {
+                    dataType: 'string',
+                    visible: '{{ context.eval("hasCoordinates") == true || !!context.eval("coordinates") }}',
+                    interface: {
+                        type: AXPWidgetsCatalog.map,
+                        options: {
+                            hasDraw: true,
+                            maxPolygon: 0,
+                            fitToDraw: true,
+                        },
+                        triggers: [
+                            {
+                                event: "{{ events.context('hasCoordinates') }}",
+                                action: `{{ widget.clear() }}`,
+                            },
+                        ],
+                    },
+                },
+            },
+            {
+                name: 'timezone',
+                title: '@location-management:locations.entities.location.fields.timezone',
+                groupId: 'geographic',
+                options: {
+                    filter: {
+                        advance: {
+                            enabled: true,
+                        },
+                    },
+                },
+                schema: {
+                    dataType: 'string',
+                    defaultValue: `{{ settings.get('${AXPRegionalSetting.TimeZone}') }}`,
+                    interface: {
+                        type: AXPWidgetsCatalog.select,
+                        options: {
+                            allowSearch: true,
+                            valueField: 'code',
+                            placeholder: 'e.g., America/New_York',
+                            dataSource: AXPLocaleManagementDataSourceKeys.Timezones,
+                        },
+                    },
+                },
+            },
+            {
+                name: 'parentLocationId',
+                title: '@location-management:locations.entities.location.fields.parent-location',
+                groupId: 'basic-info',
+                options: {
+                    filter: {
+                        advance: {
+                            enabled: true,
+                        },
+                        inline: {
+                            enabled: true,
+                        },
+                    },
+                },
+                schema: {
+                    dataType: 'object',
+                    interface: {
+                        type: AXPWidgetsCatalog.lookup,
+                        options: {
+                            entity: `${RootConfig.module.name}.${RootConfig.entities.location.name}`,
+                            expose: [
+                                { source: 'id', target: 'parentLocation.id' },
+                                { source: 'title', target: 'parentLocation.title' },
+                            ],
+                        },
+                    },
+                },
+            },
+            {
+                name: 'description',
+                title: '@general:terms.common.description',
+                groupId: 'basic-info',
+                options: {
+                    filter: {
+                        advance: {
+                            enabled: true,
+                        },
+                    },
+                },
+                schema: {
+                    dataType: 'string',
+                    interface: {
+                        type: AXPWidgetsCatalog.largeText,
+                        options: {
+                            rows: 3,
+                        },
+                    },
+                },
+            },
+        ],
+        columns: [
+            { name: 'code' },
+            { name: 'title' },
+            { name: 'locationTypeId', options: { dataPath: 'locationType.title' } },
+            { name: 'street1' },
+            { name: 'postalCode' },
+            { name: 'cityId', options: { dataPath: 'city.title' } },
+            { name: 'stateId', options: { dataPath: 'state.title' } },
+            { name: 'countryId', options: { dataPath: 'country.title' } },
+        ],
+        relatedEntities: [
+            {
+                entity: `${RootConfig.module.name}.${RootConfig.entities.locationAssignment.name}`,
+                title: '@location-management:locations.entities.location.related-entities.assignments.title',
+                icon: RootConfig.entities.locationAssignment.icon,
+                columns: [
+                    { name: 'ownerRef.id', options: { dataPath: 'ownerRef.title' } },
+                    { name: 'roleId', options: { dataPath: 'role.title' } },
+                    { name: 'personId', options: { dataPath: 'person.fullName' } },
+                    { name: 'person.phones' },
+                    { name: 'notes' },
+                ],
+                conditions: locationAssignmentLocationConditions('id'),
+                actions: [...locationAssignmentReadOnlyRelatedActions()],
+                layout: { type: 'page-list', position: 'after', order: 1 },
+            },
+        ],
+        interfaces: {
+            master: {
+                create: {
+                    sections: [
+                        {
+                            id: 'basic-info',
+                        },
+                        {
+                            id: 'address',
+                        },
+                        {
+                            id: 'geographic',
+                        },
+                        {
+                            id: 'additional',
+                        },
+                    ],
+                    properties: [
+                        {
+                            name: 'code',
+                        },
+                        {
+                            name: 'title',
+                        },
+                        {
+                            name: 'locationTypeId',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                    md: {
+                                        colSpan: 6,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'street1',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'street2',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'countryId',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                    md: {
+                                        colSpan: 4,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'stateId',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                    md: {
+                                        colSpan: 4,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'cityId',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                    md: {
+                                        colSpan: 4,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'postalCode',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                    md: {
+                                        colSpan: 4,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'hasCoordinates',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 6,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'coordinates',
+                            layout: {
+                                label: {
+                                    visible: false,
+                                },
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'timezone',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                        colStart: 1,
+                                    },
+                                    md: {
+                                        colSpan: 4,
+                                        colStart: 1,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'parentLocationId',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                    md: {
+                                        colSpan: 6,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'description',
+                        },
+                    ],
+                },
+                update: {
+                    sections: [
+                        {
+                            id: 'basic-info',
+                        },
+                        {
+                            id: 'address',
+                        },
+                        {
+                            id: 'geographic',
+                        },
+                        {
+                            id: 'additional',
+                        },
+                        {
+                            id: 'settings',
+                        },
+                    ],
+                    properties: [
+                        {
+                            name: 'code',
+                        },
+                        {
+                            name: 'title',
+                        },
+                        {
+                            name: 'locationTypeId',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                    md: {
+                                        colSpan: 6,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'description',
+                        },
+                        {
+                            name: 'parentLocationId',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                    md: {
+                                        colSpan: 6,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'street1',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'street2',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'cityId',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                    md: {
+                                        colSpan: 4,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'stateId',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                    md: {
+                                        colSpan: 4,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'countryId',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                    md: {
+                                        colSpan: 4,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'postalCode',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                    md: {
+                                        colSpan: 4,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'hasCoordinates',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 6,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'coordinates',
+                            layout: {
+                                label: {
+                                    visible: false,
+                                },
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'timezone',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                        colStart: 1,
+                                    },
+                                    md: {
+                                        colSpan: 4,
+                                        colStart: 1,
+                                    },
+                                },
+                            },
+                        },
+                    ],
+                },
+                single: {
+                    title: '{{title}}',
+                    description: '{{ fullAddress }}',
+                    sections: [
+                        {
+                            id: 'basic-info',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 12,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            id: 'address',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 12,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            id: 'geographic',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 12,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            id: 'additional',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 12,
+                                    },
+                                },
+                            },
+                        },
+                    ],
+                    properties: [
+                        {
+                            name: 'code',
+                        },
+                        {
+                            name: 'title',
+                        },
+                        {
+                            name: 'locationTypeId',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 6,
+                                        order: 3,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'description',
+                        },
+                        {
+                            name: 'parentLocationId',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 6,
+                                        order: 11,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'street1',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 12,
+                                        order: 4,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'street2',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 12,
+                                        order: 5,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'cityId',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 4,
+                                        order: 6,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'stateId',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 4,
+                                        order: 7,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'countryId',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 4,
+                                        order: 8,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'postalCode',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 4,
+                                        order: 9,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'hasCoordinates',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 6,
+                                        order: 10,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'coordinates',
+                            layout: {
+                                label: {
+                                    visible: false,
+                                },
+                                positions: {
+                                    lg: {
+                                        colSpan: 12,
+                                        order: 11,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'timezone',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 4,
+                                        colStart: 1,
+                                        order: 12,
+                                    },
+                                },
+                            },
+                        },
+                    ],
+                    actions: [...entityMasterRecordActions()],
+                },
+                list: {
+                    actions: [...entityMasterCrudActions()],
+                    views: [
+                        createAllQueryView({
+                            sorts: [{ name: 'title', dir: 'asc' }],
+                        }),
+                    ],
+                },
+            },
+        },
+    };
+    return entityDef;
+}
+
+//#endregion
+//#region ----   Entity Factory   ----
+async function locationAssignmentFactory() {
+    const entityDef = {
+        module: RootConfig.module.name,
+        name: RootConfig.entities.locationAssignment.name,
+        title: RootConfig.entities.locationAssignment.title,
+        icon: RootConfig.entities.locationAssignment.icon,
+        formats: {
+            individual: RootConfig.entities.locationAssignment.title,
+            plural: RootConfig.entities.locationAssignment.titlePlural,
+            searchResult: {
+                title: '{{ location.title }}',
+                description: '@location-management:location-assignments.entities.location-assignment.search-result-description',
+            },
+        },
+        plugins: [{ name: 'notes' }],
+        groups: [{ id: 'basic-info', title: '@general:terms.interface.basic-info' }],
+        properties: [
+            {
+                name: 'locationId',
+                title: '@location-management:location-assignments.entities.location-assignment.fields.location.title',
+                groupId: 'basic-info',
+                options: {
+                    sort: { enabled: true },
+                    filter: { advance: { enabled: true }, inline: { enabled: true } },
+                },
+                schema: {
+                    dataType: 'string',
+                    interface: {
+                        type: AXPWidgetsList.Editors.LookupBox,
+                        options: {
+                            entity: `${RootConfig.module.name}.${RootConfig.entities.location.name}`,
+                            multiple: false,
+                            textField: 'title',
+                            columns: ['title', 'code', 'fullAddress', 'locationTypeId'],
+                            allowCreate: 'quick',
+                            expose: [
+                                { source: 'id', target: 'location.id' },
+                                { source: 'title', target: 'location.title' },
+                                { source: 'fullAddress', target: 'location.fullAddress' },
+                                { source: 'street1', target: 'location.street1' },
+                                { source: 'street2', target: 'location.street2' },
+                                { source: 'postalCode', target: 'location.postalCode' },
+                                { source: 'city.title', target: 'location.city.title' },
+                                { source: 'state.title', target: 'location.state.title' },
+                                { source: 'country.title', target: 'location.country.title' },
+                            ],
+                        },
+                    },
+                },
+                validations: [{ rule: 'required' }],
+            },
+            createLocationAssignmentOwnerRefTypeProperty('basic-info'),
+            createLocationAssignmentOwnerRefLookupProperty('basic-info'),
+            {
+                name: 'roleId',
+                title: '@location-management:location-assignments.entities.location-assignment.fields.role.title',
+                groupId: 'basic-info',
+                options: {
+                    sort: { enabled: true },
+                    filter: { advance: { enabled: true }, inline: { enabled: true } },
+                },
+                schema: {
+                    dataType: 'string',
+                    interface: {
+                        type: AXPWidgetsCatalog.lookup,
+                        options: {
+                            look: 'select',
+                            entity: `${RootConfig.module.name}.${RootConfig.entities.locationRole.name}`,
+                            multiple: false,
+                            expose: [
+                                { source: 'id', target: 'role.id' },
+                                { source: 'title', target: 'role.title' },
+                            ],
+                        },
+                    },
+                },
+                validations: [{ rule: 'required' }],
+            },
+            {
+                name: 'personId',
+                title: '@location-management:location-assignments.entities.location-assignment.fields.contact.title',
+                groupId: 'basic-info',
+                options: {
+                    sort: { enabled: true },
+                    filter: { advance: { enabled: true }, inline: { enabled: true } },
+                },
+                schema: {
+                    dataType: 'string',
+                    interface: {
+                        type: AXPWidgetsCatalog.lookup,
+                        options: {
+                            entity: 'PersonCore.Person',
+                            multiple: false,
+                            textField: 'fullName',
+                            columns: ['fullName', 'phones', 'emails'],
+                            allowCreate: 'quick',
+                            expose: [
+                                { source: 'id', target: 'person.id' },
+                                { source: 'fullName', target: 'person.fullName' },
+                                { source: 'phones', target: 'person.phones' },
+                                { source: 'emails', target: 'person.emails' },
+                            ],
+                        },
+                    },
+                },
+            },
+        ],
+        columns: [
+            {
+                name: 'locationId',
+                title: '@general:terms.common.title',
+                options: { dataPath: 'location.title' },
+            },
+            {
+                name: 'roleId',
+                title: '@location-management:location-assignments.entities.location-assignment.fields.role.title',
+                options: { dataPath: 'role.title' },
+            },
+            {
+                name: 'location.fullAddress',
+                title: '@general:terms.geography.address',
+                options: { width: '280px' },
+            },
+            {
+                name: 'personId',
+                title: '@general:terms.people.contact',
+                options: { dataPath: 'person.fullName' },
+            },
+            {
+                name: 'person.phones',
+                title: '@general:terms.communication.phones',
+                options: { width: '180px' },
+            },
+            {
+                name: 'ownerRef.id',
+                title: '@location-management:location-assignments.entities.location-assignment.fields.assignee.title',
+                options: { dataPath: 'ownerRef.title' },
+            },
+            {
+                name: 'notes',
+                title: '@general:terms.common.notes',
+            },
+        ],
+        interfaces: {
+            master: {
+                create: {
+                    sections: [{ id: 'basic-info' }],
+                    properties: [
+                        { name: 'locationId', layout: { positions: { lg: { colSpan: 12, order: 1 } } } },
+                        { name: 'ownerRef.id', layout: { positions: { lg: { colSpan: 6, order: 2 } } } },
+                        { name: 'roleId', layout: { positions: { lg: { colSpan: 6, order: 3 } } } },
+                        { name: 'personId', layout: { positions: { lg: { colSpan: 6, order: 4 } } } },
+                    ],
+                },
+                update: {
+                    sections: [{ id: 'basic-info' }],
+                    properties: [
+                        { name: 'locationId', layout: { positions: { lg: { colSpan: 12, order: 1 } } } },
+                        { name: 'ownerRef.id', layout: { positions: { lg: { colSpan: 6, order: 2 } } } },
+                        { name: 'roleId', layout: { positions: { lg: { colSpan: 6, order: 3 } } } },
+                        { name: 'personId', layout: { positions: { lg: { colSpan: 6, order: 4 } } } },
+                    ],
+                },
+                single: {
+                    title: '{{ location.title }}',
+                    sections: [{ id: 'basic-info', layout: { positions: { lg: { colSpan: 12 } } } }],
+                    properties: [
+                        { name: 'locationId', layout: { positions: { lg: { colSpan: 12, order: 1 } } } },
+                        { name: 'ownerRef.id', layout: { positions: { lg: { colSpan: 6, order: 2 } } } },
+                        { name: 'roleId', layout: { positions: { lg: { colSpan: 6, order: 3 } } } },
+                        { name: 'personId', layout: { positions: { lg: { colSpan: 6, order: 4 } } } },
+                    ],
+                    actions: [...entityMasterRecordActions()],
+                },
+                list: {
+                    actions: [...entityMasterCrudActions()],
+                    views: [
+                        createAllQueryView({
+                            sorts: [{ name: 'locationId', dir: 'asc' }],
+                        }),
+                    ],
+                },
+            },
+        },
+    };
+    return entityDef;
+}
+//#endregion
+
+//#endregion
+
+//#endregion
+//#region ----   Entity Factory   ----
+async function locationRoleFactory() {
+    const sections = [{ id: 'basic-info', layout: { positions: { lg: { colSpan: 12 } } } }];
+    const createPropertyLayouts = [
+        { name: 'title', layout: { positions: { lg: { colSpan: 12, order: 1 } } } },
+        { name: 'description', layout: { positions: { lg: { colSpan: 12, order: 2 } } } },
+    ];
+    const modifyPropertyLayouts = [
+        { name: 'name', layout: { positions: { lg: { colSpan: 6, order: 1 } } } },
+        { name: 'title', layout: { positions: { lg: { colSpan: 6, order: 2 } } } },
+        { name: 'description', layout: { positions: { lg: { colSpan: 12, order: 3 } } } },
+    ];
+    const entityDef = {
+        module: RootConfig.module.name,
+        name: RootConfig.entities.locationRole.name,
+        title: RootConfig.entities.locationRole.title,
+        icon: RootConfig.entities.locationRole.icon,
+        formats: {
+            individual: RootConfig.entities.locationRole.title,
+            plural: RootConfig.entities.locationRole.titlePlural,
+            searchResult: {
+                title: '{{ title }}',
+                description: '@location-management:location-roles.entities.location-role.search-result-description',
+            },
+        },
+        plugins: [
+            { name: 'history' },
+            { name: 'compare' },
+            { name: 'clone' },
+            { name: 'derived-name' },
+            {
+                name: 'unique-fields',
+                options: {
+                    fields: 'name',
+                    scope: 'global',
+                },
+            },
+        ],
+        groups: [{ id: 'basic-info', title: '@general:terms.interface.basic-info' }],
+        properties: [
+            {
+                name: 'id',
+                title: '@general:terms.common.id',
+                groupId: 'basic-info',
+                schema: {
+                    dataType: 'uuid',
+                    visible: false,
+                    readonly: true,
+                    unique: { enabled: true },
+                },
+            },
+            {
+                name: 'name',
+                title: '@location-management:location-roles.entities.location-role.fields.name.title',
+                groupId: 'basic-info',
+                options: {
+                    sort: { enabled: true },
+                    filter: { advance: { enabled: true }, inline: { enabled: true } },
+                },
+                schema: {
+                    dataType: 'string',
+                    interface: {
+                        type: AXPWidgetsList.Editors.TextBox,
+                        options: {
+                            placeholder: '@location-management:location-roles.entities.location-role.fields.name.placeholder',
+                        },
+                    },
+                },
+                validations: [{ rule: 'required' }, { rule: 'variable-name' }],
+            },
+            {
+                name: 'title',
+                title: '@general:terms.common.title',
+                groupId: 'basic-info',
+                options: {
+                    sort: { enabled: true },
+                    filter: { advance: { enabled: true }, inline: { enabled: true } },
+                },
+                schema: {
+                    dataType: 'string',
+                    interface: {
+                        type: AXPWidgetsList.Editors.TextBox,
+                        options: {
+                            placeholder: '@location-management:location-roles.entities.location-role.fields.title.placeholder',
+                        },
+                    },
+                },
+                validations: [{ rule: 'required' }],
+            },
+            {
+                name: 'description',
+                title: '@general:terms.common.description',
+                groupId: 'basic-info',
+                options: {
+                    sort: { enabled: false },
+                    filter: { advance: { enabled: true }, inline: { enabled: false } },
+                },
+                schema: {
+                    dataType: 'string',
+                    interface: {
+                        type: AXPWidgetsList.Editors.LargeTextBox,
+                        options: {
+                            rows: 3,
+                            placeholder: '@location-management:location-roles.entities.location-role.fields.description.placeholder',
+                        },
+                    },
+                },
+            },
+        ],
+        columns: [
+            { name: 'title', options: { width: '220px', order: 1 } },
+            { name: 'name', options: { width: '140px', order: 2 } },
+            { name: 'description', options: { width: '320px', order: 3 } },
+        ],
+        interfaces: {
+            master: {
+                create: { sections, properties: createPropertyLayouts },
+                update: { sections, properties: modifyPropertyLayouts },
+                single: {
+                    title: '{{ title }}',
+                    sections,
+                    properties: modifyPropertyLayouts,
+                    actions: [...entityMasterRecordActions()],
+                },
+                list: {
+                    actions: [...entityMasterCrudActions()],
+                    views: [
+                        createAllQueryView({
+                            sorts: [{ name: 'title', dir: 'asc' }],
+                        }),
+                    ],
+                },
+            },
+        },
+    };
+    return entityDef;
+}
+//#endregion
+
+async function locationTypeFactory() {
+    const i18n = RootConfig.config.i18n;
+    const entityDef = {
+        module: RootConfig.module.name,
+        name: RootConfig.entities.locationType.name,
+        title: RootConfig.entities.locationType.title,
+        formats: {
+            individual: RootConfig.entities.locationType.title,
+            plural: RootConfig.entities.locationType.titlePlural,
+            searchResult: {
+                title: '{{ title }}',
+                description: '{{ description }}',
+            },
+        },
+        groups: [
+            {
+                id: 'basic-info',
+                title: '@general:terms.interface.basic-info',
+            },
+            {
+                id: 'appearance',
+                title: '@general:terms.interface.appearance',
+            },
+            {
+                id: 'settings',
+                title: '@general:terms.interface.settings',
+            },
+        ],
+        plugins: [
+            { name: 'archive' },
+            { name: 'color' },
+            { name: 'icon' },
+        ],
+        properties: [
+            {
+                name: 'title',
+                title: '@general:terms.common.title',
+                groupId: 'basic-info',
+                options: {
+                    sort: {
+                        enabled: true,
+                    },
+                    filter: {
+                        advance: {
+                            enabled: true,
+                        },
+                        inline: {
+                            enabled: true,
+                        },
+                    },
+                },
+                schema: {
+                    dataType: 'string',
+                    interface: {
+                        type: AXPWidgetsCatalog.text,
+                        options: {
+                            placeholder: 'Enter location type name',
+                        },
+                    },
+                },
+                validations: [
+                    {
+                        rule: 'required',
+                    },
+                ],
+            },
+            {
+                name: 'description',
+                title: '@general:terms.common.description',
+                groupId: 'basic-info',
+                options: {
+                    filter: {
+                        advance: {
+                            enabled: true,
+                        },
+                    },
+                },
+                schema: {
+                    dataType: 'string',
+                    interface: {
+                        type: AXPWidgetsCatalog.largeText,
+                        options: {
+                            rows: 3,
+                        },
+                    },
+                },
+            },
+        ],
+        columns: [{ name: 'title' }, { name: 'description' }],
+        interfaces: {
+            master: {
+                create: {
+                    sections: [
+                        {
+                            id: 'basic-info',
+                        },
+                        {
+                            id: 'appearance',
+                        },
+                        {
+                            id: 'settings',
+                        },
+                    ],
+                    properties: [
+                        {
+                            name: 'title',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'description',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                },
+                            },
+                        },
+                    ],
+                },
+                update: {
+                    sections: [
+                        {
+                            id: 'basic-info',
+                        },
+                        {
+                            id: 'appearance',
+                        },
+                        {
+                            id: 'settings',
+                        },
+                    ],
+                    properties: [
+                        {
+                            name: 'title',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'description',
+                            layout: {
+                                positions: {
+                                    sm: {
+                                        colSpan: 12,
+                                    },
+                                },
+                            },
+                        },
+                    ],
+                },
+                single: {
+                    title: '{{title}}',
+                    sections: [
+                        {
+                            id: 'basic-info',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 12,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            id: 'appearance',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 12,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            id: 'settings',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 12,
+                                    },
+                                },
+                            },
+                        },
+                    ],
+                    properties: [
+                        {
+                            name: 'title',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 12,
+                                        order: 1,
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            name: 'description',
+                            layout: {
+                                positions: {
+                                    lg: {
+                                        colSpan: 12,
+                                        order: 2,
+                                    },
+                                },
+                            },
+                        },
+                    ],
+                    actions: [...entityMasterRecordActions()],
+                },
+                list: {
+                    actions: [...entityMasterCrudActions()],
+                    views: [
+                        createAllQueryView({
+                            sorts: [{ name: 'title', dir: 'asc' }],
+                        }),
+                    ],
+                },
+            },
+        },
+    };
+    return entityDef;
+}
+
+//#region ---- Contracts barrel ----
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { AXMLocationManagementDataSourceKeys, AXMLocationManagementFeatureKeys, AXMLocationManagementPermissionsKeys, AXPLocationManagementMenuKeys, LOCATION_ASSIGNMENT_LOCATION_PROPERTY_NAMES, LOCATION_ASSIGNMENT_PARTY_TYPE, LOCATION_ASSIGNMENT_REF_PROPERTY_NAMES, RootConfig, buildLocationAssignmentLocationSnapshot, buildLocationAssignmentPersonSnapshot, createLocationAssignmentOwnerRefLookupProperty, createLocationAssignmentOwnerRefTypeProperty, geographicRegionFactory, locationAssignmentDetailsCrudActionsForPartyContext, locationAssignmentFactory, locationAssignmentLocationConditions, locationAssignmentPartyConditions, locationAssignmentReadOnlyRelatedActions, locationFactory, locationRoleFactory, locationTypeFactory, omitLocationAssignmentLocationFromEditLayouts, omitLocationAssignmentRefFromEditLayouts, resolveLocationAssignmentDisplayTitle };
+//# sourceMappingURL=acorex-platform-module-location-management-client-contracts.mjs.map