Introduce Section Alias condition const (#19633)

* Refactor section conditions into subfolders

Split section condition logic into 'section-alias' and 'section-user-permission' subfolders, each with their own constants, manifests, and types. Updated imports and manifest aggregation to use the new structure for improved modularity and maintainability.

* use const

* fix build

* Refactor section alias condition to use constant

Replaces hardcoded 'Umb.Condition.SectionAlias' strings with the UMB_SECTION_ALIAS_CONDITION_ALIAS constant across all manifests and related files. This improves maintainability and consistency by centralizing the section alias condition reference.

Author: madsrasmussen

.github/contributing-backoffice.md

@@ -114,7 +114,7 @@ To declare the Published Cache Status Dashboard as a new manifest, we need to ad
 	},
 	conditions: [
 		{
-			alias: 'Umb.Condition.SectionAlias',
+			alias: UMB_SECTION_ALIAS_CONDITION_ALIAS,
 			match: 'Umb.Section.Settings',
 		},
 	],

src/Umbraco.Web.UI.Client/examples/collection/collection/card-view/index.ts

@@ -1,4 +1,5 @@
 import type { ManifestDashboard } from '@umbraco-cms/backoffice/dashboard';
+import { UMB_SECTION_ALIAS_CONDITION_ALIAS } from '@umbraco-cms/backoffice/section';
 
 const dashboard: ManifestDashboard = {
 	type: 'dashboard',
@@ -12,7 +13,7 @@ const dashboard: ManifestDashboard = {
 	},
 	conditions: [
 		{
-			alias: 'Umb.Condition.SectionAlias',
+			alias: UMB_SECTION_ALIAS_CONDITION_ALIAS,
 			match: 'Umb.Section.Content',
 		},
 	],

src/Umbraco.Web.UI.Client/examples/collection/collection/table-view/index.ts

@@ -1 +1,2 @@
-export const UMB_SECTION_USER_PERMISSION_CONDITION_ALIAS = 'Umb.Condition.SectionUserPermission';
+export * from './section-alias/constants.js';
+export * from './section-user-permission/constants.js';

src/Umbraco.Web.UI.Client/examples/validation-context/index.ts

@@ -1,18 +1,4 @@
-import { UMB_SECTION_USER_PERMISSION_CONDITION_ALIAS } from './constants.js';
-import { UmbSectionAliasCondition } from './section-alias.condition.js';
-import { UmbSectionUserPermissionCondition } from './section-user-permission.condition.js';
+import { manifests as sectionAliasManifests } from './section-alias/manifests.js';
+import { manifests as sectionUserPermissionManifests } from './section-user-permission/manifests.js';
 
-export const manifests: Array<UmbExtensionManifest> = [
-	{
-		type: 'condition',
-		name: 'Section User Permission Condition',
-		alias: UMB_SECTION_USER_PERMISSION_CONDITION_ALIAS,
-		api: UmbSectionUserPermissionCondition,
-	},
-	{
-		type: 'condition',
-		name: 'Section Alias Condition',
-		alias: 'Umb.Condition.SectionAlias',
-		api: UmbSectionAliasCondition,
-	},
-];
+export const manifests: Array<UmbExtensionManifest> = [...sectionAliasManifests, ...sectionUserPermissionManifests];

src/Umbraco.Web.UI.Client/src/packages/core/section/conditions/constants.ts

@@ -0,0 +1 @@
+export const UMB_SECTION_ALIAS_CONDITION_ALIAS = 'Umb.Condition.SectionAlias';

src/Umbraco.Web.UI.Client/src/packages/core/section/conditions/manifests.ts

@@ -0,0 +1,11 @@
+import { UMB_SECTION_ALIAS_CONDITION_ALIAS } from './constants.js';
+import { UmbSectionAliasCondition } from './section-alias.condition.js';
+
+export const manifests: Array<UmbExtensionManifest> = [
+	{
+		type: 'condition',
+		name: 'Section Alias Condition',
+		alias: UMB_SECTION_ALIAS_CONDITION_ALIAS,
+		api: UmbSectionAliasCondition,
+	},
+];

src/Umbraco.Web.UI.Client/src/packages/core/section/conditions/section-alias/constants.ts

@@ -1,6 +1,6 @@
-import { UmbConditionBase } from '../../extension-registry/conditions/condition-base.controller.js';
-import { UMB_SECTION_CONTEXT } from '../section.context.js';
-import type { SectionAliasConditionConfig } from './types.js';
+import { UmbConditionBase } from '../../../extension-registry/conditions/condition-base.controller.js';
+import { UMB_SECTION_CONTEXT } from '../../section.context.js';
+import type { SectionAliasConditionConfig } from '../types.js';
 import type { UmbControllerHost } from '@umbraco-cms/backoffice/controller-api';
 import type { UmbConditionControllerArguments, UmbExtensionCondition } from '@umbraco-cms/backoffice/extension-api';
 

src/Umbraco.Web.UI.Client/src/packages/core/section/conditions/section-alias/manifests.ts

@@ -0,0 +1,22 @@
+import type { UMB_SECTION_ALIAS_CONDITION_ALIAS } from './constants.js';
+import type { UmbConditionConfigBase } from '@umbraco-cms/backoffice/extension-api';
+
+export type SectionAliasConditionConfig = UmbConditionConfigBase<typeof UMB_SECTION_ALIAS_CONDITION_ALIAS> & {
+	/**
+	 * Define the section that this extension should be available in
+	 * @example "Umb.Section.Content"
+	 */
+	match: string;
+	/**
+	 * Define one or more workspaces that this extension should be available in
+	 * @example
+	 * ["Umb.Section.Content", "Umb.Section.Media"]
+	 */
+	oneOf?: Array<string>;
+};
+
+declare global {
+	interface UmbExtensionConditionConfigMap {
+		UmbSectionAliasConditionConfig: SectionAliasConditionConfig;
+	}
+}