@acorex-platform/module-common-client 0.0.54 → 0.0.56

package/i18n/fa-IR/global-search.json

@@ -0,0 +1,38 @@
+{
+  "feature": {
+    "title": "جستجوی سراسری",
+    "description": "جستجو در سراسر پلتفرم برای فرمان‌ها، فایل‌ها و محتوا"
+  },
+  "terms": {
+    "pinned": "سنجاق‌شده",
+    "recent": "اخیر",
+    "clear": "پاک کردن",
+    "search": "جستجو",
+    "search-anything": "هر چیزی را جستجو کنید...",
+    "search-placeholder": "جستجو..."
+  },
+  "commands": {
+    "open-global-search": {
+      "title": "باز کردن جستجوی سراسری",
+      "inputs": {
+        "search-text": { "title": "متن جستجو" }
+      }
+    }
+  },
+  "components": {
+    "search-box": {
+      "title": "جستجوی سراسری",
+      "description": "جستجو برای فرمان‌ها، فایل‌ها و محتوا",
+      "empty-states": {
+        "no-result": {
+          "title": "نتیجه‌ای یافت نشد",
+          "description": "چیزی مطابق جستجوی شما پیدا نشد. لطفاً کلمات کلیدی را دقیق‌تر کنید یا واژه‌های دیگری را امتحان کنید."
+        },
+        "start": {
+          "title": "دنبال چیزی می‌گردید؟",
+          "description": "برای جستجوی فرمان‌ها، فایل‌ها یا هر چیز دیگر، فقط شروع به تایپ کردن کنید!"
+        }
+      }
+    }
+  }
+}

package/i18n/fa-IR/lock-system.json

@@ -0,0 +1,66 @@
+{
+  "feature": {
+    "title": "سیستم قفل",
+    "description": "مدیریت قفل موجودیت‌ها برای جلوگیری از ویرایش همزمان"
+  },
+  "commands": {
+    "lock-entity": { "title": "قفل موجودیت" },
+    "unlock-entity": { "title": "باز کردن قفل موجودیت" }
+  },
+  "actions": {
+    "lock": {
+      "title": "قفل کردن ردیف",
+      "description": "قفل کردن این ردیف برای جلوگیری از ویرایش توسط سایر کاربران"
+    },
+    "unlock": {
+      "title": "بازکردن قفل ردیف",
+      "description": "بازکردن قفل این ردیف برای اجازه ویرایش توسط سایر کاربران"
+    }
+  },
+  "components": {
+    "lock-dialog": {
+      "title": "قفل کردن ردیف",
+      "description": "آیا از قفل کردن این ردیف مطمئن هستید؟ این کار از ویرایش توسط سایر کاربران جلوگیری می‌کند.",
+      "fields": {
+        "reason": {
+          "title": "دلیل (اختیاری)",
+          "placeholder": "دلیل قفل کردن این ردیف را وارد کنید..."
+        },
+        "duration": {
+          "title": "مدت قفل",
+          "options": {
+            "1h": "۱ ساعت",
+            "1d": "۱ روز",
+            "infinite": "نامحدود"
+          }
+        }
+      },
+      "actions": {
+        "confirm": "قفل کردن",
+        "cancel": "انصراف"
+      }
+    },
+    "unlock-dialog": {
+      "title": "بازکردن قفل ردیف",
+      "description": "آیا از بازکردن قفل این ردیف مطمئن هستید؟ با این کار سایر کاربران قادر به ویرایش آن خواهند بود.",
+      "actions": {
+        "confirm": "بازکردن قفل",
+        "cancel": "انصراف"
+      }
+    }
+  },
+  "messages": {
+    "success": {
+      "unlock": {
+        "title": "بازکردن قفل موفق",
+        "description": "ردیف با موفقیت از قفل خارج شد."
+      }
+    },
+    "error": {
+      "unlock": {
+        "title": "بازکردن قفل ناموفق",
+        "description": "بازکردن قفل ردیف انجام نشد. لطفاً دوباره تلاش کنید."
+      }
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acorex-platform/module-common-client",
-  "version": "0.0.54",
+  "version": "0.0.56",
   "sideEffects": false,
   "peerDependencies": {
     "@acorex/cdk": ">=22.0.0",

package/types/acorex-platform-module-common-client-contracts.d.ts

@@ -35,6 +35,7 @@ declare const AXPCommonCommandKeys: {
         readonly CreateDraft: "create-entity-version-draft";
         readonly Publish: "publish-entity-version";
         readonly DeleteDraft: "delete-entity-version-draft";
+        readonly ShowHistory: "show-entity-version-history";
     };
 };
 
@@ -347,8 +348,32 @@ declare const AXP_VERSIONING_ERROR_CODES: {
     readonly HostContentLocked: "VERSIONING_HOST_CONTENT_LOCKED";
     readonly NoDraft: "VERSIONING_NO_DRAFT";
     readonly InvalidPublish: "VERSIONING_INVALID_PUBLISH";
+    readonly CreateDenied: "VERSIONING_CREATE_DENIED";
 };
 declare const AXP_VERSIONING_ERROR_I18N: Record<string, string>;
+/**
+ * Legacy tenant-wide key (kept so existing role grants still work).
+ * New grants use {@link maintainVersioningPermissionKey}.
+ */
+declare const AXP_VERSIONING_MAINTAIN_PERMISSION_LEGACY = "ContentDocuments:Permission:MaintainVersioning";
+/**
+ * @deprecated Use {@link maintainVersioningPermissionKey} for the host entity.
+ * Alias of {@link AXP_VERSIONING_MAINTAIN_PERMISSION_LEGACY}.
+ */
+declare const AXP_VERSIONING_CREATE_DRAFT_PERMISSION = "ContentDocuments:Permission:MaintainVersioning";
+/** Runtime query that lists host entities which declare the versioning plugin. */
+declare const AXP_VERSIONING_LIST_HOST_ENTITIES_QUERY = "Common:ListVersioningHostEntities";
+/**
+ * Seed-time hosts that declare the versioning plugin in module catalogs.
+ * Administrator seed grants these keys; the role UI also discovers new hosts at runtime.
+ */
+declare const AXP_VERSIONING_SEEDED_HOST_ENTITIES: readonly ["DocumentManagement.Document", "FinancialCore.FiscalCalendar"];
+/**
+ * Per-entity Maintain Versioning key: `{Module}:Permission:{Entity}.MaintainVersioning`.
+ */
+declare function maintainVersioningPermissionKey(hostEntityName: string): string;
+/** True when the user has the per-entity key or the legacy tenant-wide key. */
+declare function isMaintainVersioningPermissionGranted(hasPermission: (key: string) => boolean, hostEntityName: string): boolean;
 /** Fields that live only on the host published row. */
 declare const AXP_VERSIONING_HOST_OWN_FIELDS: Set<string>;
 /** Fields that live only on the companion version row. */
@@ -358,6 +383,12 @@ declare const AXP_VERSIONING_COMPANION_OWN_FIELDS: Set<string>;
  * (move in a folder, entity binding). Content fields are blocked when versioning is on.
  */
 declare const AXP_VERSIONING_STRUCTURAL_FIELDS: Set<string>;
+/**
+ * Display identity and live attributes on the published host.
+ * Renaming or editing metadata is not a new revision; replacing the file still is.
+ * Still snapshotted onto companions so publish can copy the latest values.
+ */
+declare const AXP_VERSIONING_HOST_IDENTITY_FIELDS: Set<string>;
 declare function versionCompanionEntityName(hostEntityName: string): string;
 declare function hostEntityNameFromCompanion(companionEntityName: string): string | null;
 declare function isVersionCompanionEntityName(entityName: string): boolean;
@@ -379,6 +410,15 @@ interface AXPVersioningHostDto extends AXPEntityDetailDto<string> {
     version?: number;
     versionId?: string;
     versioningEnabled?: boolean;
+    /** Stamped onto the host payload when a maintainer sees an open draft. */
+    versioningStatus?: string;
+}
+/** One host entity that declares the versioning plugin (permission auto-registration). */
+interface AXPVersioningHostEntityListItem {
+    module: string;
+    name: string;
+    fullName: string;
+    title?: string;
 }
 /** Companion `{Entity}Version` row. Create may send only `sourceId`. */
 interface AXPVersioningCompanionDto extends AXPEntityDetailDto<string> {
@@ -387,5 +427,5 @@ interface AXPVersioningCompanionDto extends AXPEntityDetailDto<string> {
     versioningStatus?: string;
 }
 
-export { AXMCommonSettings, AXMLockSystemSettings, AXPCommonCommandKeys, AXPCommonFeatureKeys, AXPCommonMenuKeys, AXPCommonPermissionGroupKeys, AXPPermissionDomainModules, AXPPermissionKeyModules, AXPVersionHistorySettings, AXPVersioningField, AXPVersioningStatus, AXP_VERSIONING_COMPANION_OWN_FIELDS, AXP_VERSIONING_ERROR_CODES, AXP_VERSIONING_ERROR_I18N, AXP_VERSIONING_HOST_OWN_FIELDS, AXP_VERSIONING_PLUGIN_NAME, AXP_VERSIONING_STRUCTURAL_FIELDS, AXP_VERSION_HISTORY_SETTING_DEFAULTS, COMMON_CATALOG_SCOPE_GENERAL, CommonManifest, RootConfig, hostEntityNameFromCompanion, humanizePermissionCapability, isPermissionEnabledForModules, isVersionCompanionEntityName, resolvePermissionI18nKeys, resolvePermissionModules, resolvePermissionTitleDisplay, versionCompanionEntityName };
-export type { AXPPermissionModulesResolver, AXPVersioningCompanionDto, AXPVersioningHostDto, AXPVersioningPluginOptions, AXPVersioningStatusValue };
+export { AXMCommonSettings, AXMLockSystemSettings, AXPCommonCommandKeys, AXPCommonFeatureKeys, AXPCommonMenuKeys, AXPCommonPermissionGroupKeys, AXPPermissionDomainModules, AXPPermissionKeyModules, AXPVersionHistorySettings, AXPVersioningField, AXPVersioningStatus, AXP_VERSIONING_COMPANION_OWN_FIELDS, AXP_VERSIONING_CREATE_DRAFT_PERMISSION, AXP_VERSIONING_ERROR_CODES, AXP_VERSIONING_ERROR_I18N, AXP_VERSIONING_HOST_IDENTITY_FIELDS, AXP_VERSIONING_HOST_OWN_FIELDS, AXP_VERSIONING_LIST_HOST_ENTITIES_QUERY, AXP_VERSIONING_MAINTAIN_PERMISSION_LEGACY, AXP_VERSIONING_PLUGIN_NAME, AXP_VERSIONING_SEEDED_HOST_ENTITIES, AXP_VERSIONING_STRUCTURAL_FIELDS, AXP_VERSION_HISTORY_SETTING_DEFAULTS, COMMON_CATALOG_SCOPE_GENERAL, CommonManifest, RootConfig, hostEntityNameFromCompanion, humanizePermissionCapability, isMaintainVersioningPermissionGranted, isPermissionEnabledForModules, isVersionCompanionEntityName, maintainVersioningPermissionKey, resolvePermissionI18nKeys, resolvePermissionModules, resolvePermissionTitleDisplay, versionCompanionEntityName };
+export type { AXPPermissionModulesResolver, AXPVersioningCompanionDto, AXPVersioningHostDto, AXPVersioningHostEntityListItem, AXPVersioningPluginOptions, AXPVersioningStatusValue };

package/types/acorex-platform-module-common-client.d.ts

@@ -337,6 +337,10 @@ declare class AXMVersionHistoryPageComponent extends AXPPageLayoutBaseComponent
 
 declare function mapChangeType(t: AXVChangeType): AXPSystemActionType.Create | AXPSystemActionType.Update | AXPSystemActionType.Delete;
 declare function mapOpToAction(op: string): AXPSystemActionType;
+/** True for locales that render history timelines right-to-left. */
+declare function isRtlHistoryLocale(locale: string): boolean;
+/** Old/new value summary for version history rows (arrow follows reading direction). */
+declare function formatVersionHistoryReplaceSummary(oldStr: string, newStr: string, locale: string): string;
 /**
  * Resolves the field lookup key from a JSON Pointer path. Uses last segment for leaf properties.
  * Handles path validation and [object Object] edge cases.
@@ -772,5 +776,5 @@ declare class AXPResourceAppointmentPageComponent extends AXPPageLayoutBaseCompo
     static ɵcmp: i0.ɵɵComponentDeclaration<AXPResourceAppointmentPageComponent, "axp-resource-appointment-page", never, {}, {}, never, never, true, never>;
 }
 
-export { AXMCommonModule, AXMMenuProvider, AXMSettingProvider, AXMVersionHistoryPageComponent, AXPArchivePluginModule, AXPCommonFeatureDefinitionProvider, AXPDerivedNamePluginModule, AXPDisablePluginModule, AXPGlobalSearchModule, AXPGlobalSearchViewModel, AXPHistoryAuditInfoWidget, AXPHistoryModule, AXPLockEntityCommand, AXPResourceAppointmentPageComponent, AXPStatusPluginModule, AXPUniqueFieldsPluginModule, AXPUnlockEntityCommand, AXPValidationRulesModule, AXPVersioningPluginModule, AXP_ENTITY_ARCHIVE_OVERRIDES, AXP_GLOBAL_SEARCH_CONFIG_TOKEN, AXP_RESOURCE_APPOINTMENT_PAGE_CONFIG, ApprovalStatusProvider, AtLeastOneOfValidationRule, HISTORY_PAGE_COMPONENT_KEY, ShowVersionHistoryPopupCommand, StateStatusProvider, TaskStatusProvider, UniqueValidationRule, VARIABLE_NAME_VALIDATION_PATTERN, VariableNameValidationRule, aggregateVersionHistoryBarChartItems, archivePlugin, buildEntityFieldHistoryLineChartSeries, buildProductBasePriceHistoryLineChartSeries, derivedNamePlugin, disablePlugin, getActiveStatuses, getFinalStatuses, getInitialStatuses, getStatusByName, getTransitionsFromStatus, getTransitionsToStatus, historyPlugin, humanizeChange, isValidTransition, isValidVariableName, mapChangeType, mapOpToAction, resolvePathKey, statusPlugin, toVariableName, uniqueFieldsPlugin, versionEntriesToActivityLogs, versioningPlugin };
+export { AXMCommonModule, AXMMenuProvider, AXMSettingProvider, AXMVersionHistoryPageComponent, AXPArchivePluginModule, AXPCommonFeatureDefinitionProvider, AXPDerivedNamePluginModule, AXPDisablePluginModule, AXPGlobalSearchModule, AXPGlobalSearchViewModel, AXPHistoryAuditInfoWidget, AXPHistoryModule, AXPLockEntityCommand, AXPResourceAppointmentPageComponent, AXPStatusPluginModule, AXPUniqueFieldsPluginModule, AXPUnlockEntityCommand, AXPValidationRulesModule, AXPVersioningPluginModule, AXP_ENTITY_ARCHIVE_OVERRIDES, AXP_GLOBAL_SEARCH_CONFIG_TOKEN, AXP_RESOURCE_APPOINTMENT_PAGE_CONFIG, ApprovalStatusProvider, AtLeastOneOfValidationRule, HISTORY_PAGE_COMPONENT_KEY, ShowVersionHistoryPopupCommand, StateStatusProvider, TaskStatusProvider, UniqueValidationRule, VARIABLE_NAME_VALIDATION_PATTERN, VariableNameValidationRule, aggregateVersionHistoryBarChartItems, archivePlugin, buildEntityFieldHistoryLineChartSeries, buildProductBasePriceHistoryLineChartSeries, derivedNamePlugin, disablePlugin, formatVersionHistoryReplaceSummary, getActiveStatuses, getFinalStatuses, getInitialStatuses, getStatusByName, getTransitionsFromStatus, getTransitionsToStatus, historyPlugin, humanizeChange, isRtlHistoryLocale, isValidTransition, isValidVariableName, mapChangeType, mapOpToAction, resolvePathKey, statusPlugin, toVariableName, uniqueFieldsPlugin, versionEntriesToActivityLogs, versioningPlugin };
 export type { AXAtLeastOneOfValidationRuleOptions, AXPArchivePluginOptions, AXPDerivedNameExtension, AXPDerivedNamePluginOptions, AXPDisablePluginOptions, AXPEntityArchiveOverride, AXPEntityHistoryBarChartItem, AXPEntityHistoryLineChartPoint, AXPEntityHistoryLineChartSeries, AXPGlobalSearchConfigs, AXPHistoryPluginOptions, AXPLockEntityCommandOutput, AXPResourceAppointmentPageConfig, AXPStatusPluginGenerateOptions, AXPStatusPluginGenerateViewsOptions, AXPStatusPluginOptions, AXPUnlockEntityCommandOutput, AXVariableNameValidationRuleOptions, GetHistoryLayoutResolver, HistoryDisplayMode, ShowVersionHistoryPopupInput, UniqueFieldsPluginOptions };