@salesforce/ui-bundle-template-feature-angular-object-search 12.5.4

package/dist/force-app/main/default/uiBundles/feature-angular-object-search/src/app/shared/dialog/hlm-dialog.ts

@@ -0,0 +1,24 @@
+import { ChangeDetectionStrategy, Component, forwardRef } from '@angular/core';
+import { BrnDialog, provideBrnDialogDefaultOptions } from '@spartan-ng/brain/dialog';
+import { HlmDialogOverlay } from './hlm-dialog-overlay';
+
+@Component({
+	selector: 'hlm-dialog',
+	exportAs: 'hlmDialog',
+	imports: [HlmDialogOverlay],
+	providers: [
+		{
+			provide: BrnDialog,
+			useExisting: forwardRef(() => HlmDialog),
+		},
+		provideBrnDialogDefaultOptions({
+			// add custom options here
+		}),
+	],
+	changeDetection: ChangeDetectionStrategy.OnPush,
+	template: `
+		<hlm-dialog-overlay />
+		<ng-content />
+	`,
+})
+export class HlmDialog extends BrnDialog {}

package/dist/force-app/main/default/uiBundles/feature-angular-object-search/src/app/shared/dialog/index.ts

@@ -0,0 +1,35 @@
+import { HlmDialog } from './hlm-dialog';
+import { HlmDialogClose } from './hlm-dialog-close';
+import { HlmDialogContent } from './hlm-dialog-content';
+import { HlmDialogDescription } from './hlm-dialog-description';
+import { HlmDialogFooter } from './hlm-dialog-footer';
+import { HlmDialogHeader } from './hlm-dialog-header';
+import { HlmDialogOverlay } from './hlm-dialog-overlay';
+import { HlmDialogPortal } from './hlm-dialog-portal';
+import { HlmDialogTitle } from './hlm-dialog-title';
+import { HlmDialogTrigger } from './hlm-dialog-trigger';
+
+export * from './hlm-dialog';
+export * from './hlm-dialog-close';
+export * from './hlm-dialog-content';
+export * from './hlm-dialog-description';
+export * from './hlm-dialog-footer';
+export * from './hlm-dialog-header';
+export * from './hlm-dialog-overlay';
+export * from './hlm-dialog-portal';
+export * from './hlm-dialog-title';
+export * from './hlm-dialog-trigger';
+export * from './hlm-dialog.service';
+
+export const HlmDialogImports = [
+	HlmDialog,
+	HlmDialogContent,
+	HlmDialogDescription,
+	HlmDialogFooter,
+	HlmDialogHeader,
+	HlmDialogOverlay,
+	HlmDialogPortal,
+	HlmDialogTitle,
+	HlmDialogTrigger,
+	HlmDialogClose,
+] as const;

package/dist/force-app/main/default/uiBundles/feature-angular-object-search/src/app/shared/dropdown-menu/hlm-dropdown-menu-checkbox-indicator.ts

@@ -0,0 +1,21 @@
+import { ChangeDetectionStrategy, Component } from '@angular/core';
+import { NgIcon, provideIcons } from '@ng-icons/core';
+import { lucideCheck } from '@ng-icons/lucide';
+import { classes } from '@spartan-ng/styles/utils';
+
+@Component({
+	selector: 'hlm-dropdown-menu-checkbox-indicator',
+	imports: [NgIcon],
+	providers: [provideIcons({ lucideCheck })],
+	changeDetection: ChangeDetectionStrategy.OnPush,
+	host: { 'data-slot': 'dropdown-menu-checkbox-item-indicator' },
+	template: ` <ng-icon name="lucideCheck" /> `,
+})
+export class HlmDropdownMenuCheckboxIndicator {
+	constructor() {
+		classes(
+			() =>
+				'absolute end-2 flex items-center justify-center [&_ng-icon]:text-[length:--spacing(4)] pointer-events-none opacity-0 group-data-checked/dropdown-menu-checkbox:opacity-100',
+		);
+	}
+}

package/dist/force-app/main/default/uiBundles/feature-angular-object-search/src/app/shared/dropdown-menu/hlm-dropdown-menu-checkbox.ts

@@ -0,0 +1,54 @@
+import { type BooleanInput } from '@angular/cdk/coercion';
+import { CdkMenuItem, CdkMenuItemCheckbox, CdkMenuItemSelectable } from '@angular/cdk/menu';
+import { Directive, booleanAttribute, inject, input } from '@angular/core';
+import { classes } from '@spartan-ng/styles/utils';
+import { HlmDropdownMenuFocusOnHover } from './hlm-dropdown-menu-focus-on-hover';
+
+/** @internal. Use HlmDropdownMenuCheckbox instead. */
+@Directive({
+	selector: '[hlmDropdownMenuCheckboxCdk]',
+	providers: [
+		{ provide: CdkMenuItemCheckbox, useExisting: HlmDropdownMenuCheckboxCdk },
+		{ provide: CdkMenuItemSelectable, useExisting: HlmDropdownMenuCheckboxCdk },
+		{ provide: CdkMenuItem, useExisting: CdkMenuItemSelectable },
+	],
+})
+export class HlmDropdownMenuCheckboxCdk extends CdkMenuItemCheckbox {
+	public readonly keepOpen = input<boolean, BooleanInput>(true, { transform: booleanAttribute });
+
+	public override trigger(options?: { keepOpen: boolean }) {
+		super.trigger({ ...options, keepOpen: this.keepOpen() });
+	}
+}
+
+@Directive({
+	selector: '[hlmDropdownMenuCheckbox],[hlmDropdownMenuCheckboxItem]',
+	hostDirectives: [
+		{
+			directive: HlmDropdownMenuCheckboxCdk,
+			inputs: ['cdkMenuItemDisabled: disabled', 'cdkMenuItemChecked: checked', 'keepOpen'],
+			outputs: ['cdkMenuItemTriggered: triggered'],
+		},
+		HlmDropdownMenuFocusOnHover,
+	],
+	host: {
+		'data-slot': 'dropdown-menu-checkbox-item',
+		'[attr.data-disabled]': '_cdkMenuItem.disabled ? "" : null',
+		'[attr.data-checked]': '_cdkMenuItem.checked ? "" : null',
+		'[attr.data-inset]': 'inset() ? "" : null',
+	},
+})
+export class HlmDropdownMenuCheckbox {
+	protected readonly _cdkMenuItem = inject(HlmDropdownMenuCheckboxCdk);
+
+	public readonly inset = input<boolean, BooleanInput>(false, {
+		transform: booleanAttribute,
+	});
+
+	constructor() {
+		classes(
+			() =>
+				"hover:bg-accent focus:bg-accent hover:text-accent-foreground focus:text-accent-foreground gap-2 rounded-sm py-1.5 ps-2 pe-8 text-sm data-inset:ps-8 [&_ng-icon:not([class*='text-'])]:text-[length:--spacing(4)] group/dropdown-menu-checkbox relative flex w-full cursor-default items-center outline-hidden select-none data-disabled:pointer-events-none data-disabled:opacity-50 [&_ng-icon]:pointer-events-none [&_ng-icon]:shrink-0",
+		);
+	}
+}

package/dist/force-app/main/default/uiBundles/feature-angular-object-search/src/app/shared/dropdown-menu/hlm-dropdown-menu-focus-on-hover.ts

@@ -0,0 +1,35 @@
+import { InputModalityDetector } from '@angular/cdk/a11y';
+import { CdkMenu, CdkMenuItem } from '@angular/cdk/menu';
+import { Directive, inject } from '@angular/core';
+
+/**
+ * @internal
+ * Moves DOM focus to the hovered menu item. CDK menus only move focus with the keyboard, so on a pointer
+ * the highlight would otherwise stay on the last keyboard-focused item (leaving two rows highlighted) and,
+ * when a submenu closes, focus would fall to <body>, the menu stack would report no focus, and the whole
+ * dropdown would collapse. Following the pointer with focus (Radix/shadcn behaviour) keeps a single
+ * highlight and keeps focus inside the menu stack. setActiveMenuItem also syncs the key manager so keyboard
+ * navigation continues from the hovered item.
+ *
+ * Applied as a host directive on every dropdown item type (item, checkbox, radio, sub-trigger).
+ */
+@Directive({
+	selector: '[hlmDropdownMenuFocusOnHover]',
+	host: {
+		'(mouseenter)': '_focusOnHover()',
+	},
+})
+export class HlmDropdownMenuFocusOnHover {
+	private readonly _cdkMenuItem = inject(CdkMenuItem, { self: true });
+	private readonly _parentMenu = inject(CdkMenu, { optional: true });
+	private readonly _inputModality = inject(InputModalityDetector);
+
+	protected _focusOnHover(): void {
+		// Only skip synthetic hovers from touch taps; every real hover (mouse, or keyboard-then-hover,
+		// which leaves the modality as 'keyboard') should move focus to keep a single highlight.
+		if (this._inputModality.mostRecentModality === 'touch' || this._cdkMenuItem.disabled) {
+			return;
+		}
+		this._parentMenu?.setActiveMenuItem(this._cdkMenuItem);
+	}
+}

package/dist/force-app/main/default/uiBundles/feature-angular-object-search/src/app/shared/dropdown-menu/hlm-dropdown-menu-group.ts

@@ -0,0 +1,14 @@
+import { CdkMenuGroup } from '@angular/cdk/menu';
+import { Directive } from '@angular/core';
+import { classes } from '@spartan-ng/styles/utils';
+
+@Directive({
+	selector: '[hlmDropdownMenuGroup],hlm-dropdown-menu-group',
+	hostDirectives: [CdkMenuGroup],
+	host: { 'data-slot': 'dropdown-menu-group' },
+})
+export class HlmDropdownMenuGroup {
+	constructor() {
+		classes(() => 'block');
+	}
+}

package/dist/force-app/main/default/uiBundles/feature-angular-object-search/src/app/shared/dropdown-menu/hlm-dropdown-menu-item-sub-indicator.ts

@@ -0,0 +1,19 @@
+import { ChangeDetectionStrategy, Component } from '@angular/core';
+import { NgIcon, provideIcons } from '@ng-icons/core';
+import { lucideChevronRight } from '@ng-icons/lucide';
+import { classes } from '@spartan-ng/styles/utils';
+
+@Component({
+	selector: 'hlm-dropdown-menu-item-sub-indicator',
+	imports: [NgIcon],
+	providers: [provideIcons({ lucideChevronRight })],
+	changeDetection: ChangeDetectionStrategy.OnPush,
+	template: `
+		<ng-icon name="lucideChevronRight" class="text-[length:--spacing(4)] rtl:rotate-180" />
+	`,
+})
+export class HlmDropdownMenuItemSubIndicator {
+	constructor() {
+		classes(() => 'ms-auto flex items-center justify-center');
+	}
+}

package/dist/force-app/main/default/uiBundles/feature-angular-object-search/src/app/shared/dropdown-menu/hlm-dropdown-menu-item.ts

@@ -0,0 +1,42 @@
+import { type BooleanInput } from '@angular/cdk/coercion';
+import { CdkMenuItem } from '@angular/cdk/menu';
+import { booleanAttribute, Directive, HOST_TAG_NAME, inject, input } from '@angular/core';
+import { classes } from '@spartan-ng/styles/utils';
+import { HlmDropdownMenuFocusOnHover } from './hlm-dropdown-menu-focus-on-hover';
+
+@Directive({
+	selector: '[hlmDropdownMenuItem],hlm-dropdown-menu-item',
+	hostDirectives: [
+		{
+			directive: CdkMenuItem,
+			inputs: ['cdkMenuItemDisabled: disabled'],
+			outputs: ['cdkMenuItemTriggered: triggered'],
+		},
+		HlmDropdownMenuFocusOnHover,
+	],
+	host: {
+		'data-slot': 'dropdown-menu-item',
+		'[attr.disabled]': '_isButton && disabled() ? "" : null',
+		'[attr.data-disabled]': 'disabled() ? "" : null',
+		'[attr.data-variant]': 'variant()',
+		'[attr.data-inset]': 'inset() ? "" : null',
+	},
+})
+export class HlmDropdownMenuItem {
+	protected readonly _isButton = inject(HOST_TAG_NAME) === 'button';
+
+	public readonly disabled = input<boolean, BooleanInput>(false, { transform: booleanAttribute });
+
+	public readonly variant = input<'default' | 'destructive'>('default');
+
+	public readonly inset = input<boolean, BooleanInput>(false, {
+		transform: booleanAttribute,
+	});
+
+	constructor() {
+		classes(
+			() =>
+				"hover:bg-accent focus:bg-accent hover:text-accent-foreground focus:text-accent-foreground data-[variant=destructive]:text-destructive data-[variant=destructive]:hover:bg-destructive/10 data-[variant=destructive]:focus:bg-destructive/10 dark:data-[variant=destructive]:hover:bg-destructive/20 dark:data-[variant=destructive]:focus:bg-destructive/20 data-[variant=destructive]:hover:text-destructive data-[variant=destructive]:focus:text-destructive data-[variant=destructive]:*:[ng-icon]:text-destructive not-data-[variant=destructive]:hover:**:text-accent-foreground not-data-[variant=destructive]:focus:**:text-accent-foreground gap-2 rounded-sm px-2 py-1.5 text-sm data-inset:ps-8 [&_ng-icon:not([class*='text-'])]:text-[length:--spacing(4)] group/dropdown-menu-item relative flex w-full cursor-default items-center outline-hidden select-none data-disabled:pointer-events-none data-disabled:opacity-50 [&_ng-icon]:pointer-events-none [&_ng-icon]:shrink-0",
+		);
+	}
+}

package/dist/force-app/main/default/uiBundles/feature-angular-object-search/src/app/shared/dropdown-menu/hlm-dropdown-menu-label.ts

@@ -0,0 +1,20 @@
+import { type BooleanInput } from '@angular/cdk/coercion';
+import { booleanAttribute, Directive, input } from '@angular/core';
+import { classes } from '@spartan-ng/styles/utils';
+
+@Directive({
+	selector: '[hlmDropdownMenuLabel],hlm-dropdown-menu-label',
+	host: {
+		'data-slot': 'dropdown-menu-label',
+		'[attr.data-inset]': 'inset() ? "" : null',
+	},
+})
+export class HlmDropdownMenuLabel {
+	public readonly inset = input<boolean, BooleanInput>(false, {
+		transform: booleanAttribute,
+	});
+
+	constructor() {
+		classes(() => 'text-muted-foreground px-2 py-1.5 text-xs font-medium data-inset:ps-8 block');
+	}
+}

package/dist/force-app/main/default/uiBundles/feature-angular-object-search/src/app/shared/dropdown-menu/hlm-dropdown-menu-radio-indicator.ts

@@ -0,0 +1,21 @@
+import { ChangeDetectionStrategy, Component } from '@angular/core';
+import { NgIcon, provideIcons } from '@ng-icons/core';
+import { lucideCheck } from '@ng-icons/lucide';
+import { classes } from '@spartan-ng/styles/utils';
+
+@Component({
+	selector: 'hlm-dropdown-menu-radio-indicator',
+	imports: [NgIcon],
+	providers: [provideIcons({ lucideCheck })],
+	changeDetection: ChangeDetectionStrategy.OnPush,
+	host: { 'data-slot': 'dropdown-menu-radio-item-indicator' },
+	template: ` <ng-icon name="lucideCheck" /> `,
+})
+export class HlmDropdownMenuRadioIndicator {
+	constructor() {
+		classes(
+			() =>
+				'absolute end-2 flex items-center justify-center [&_ng-icon]:text-[length:--spacing(4)] pointer-events-none opacity-0 group-data-checked/dropdown-menu-radio:opacity-100',
+		);
+	}
+}

package/dist/force-app/main/default/uiBundles/feature-angular-object-search/src/app/shared/dropdown-menu/hlm-dropdown-menu-radio.ts

@@ -0,0 +1,49 @@
+import { type BooleanInput } from '@angular/cdk/coercion';
+import { CdkMenuItem, CdkMenuItemRadio, CdkMenuItemSelectable } from '@angular/cdk/menu';
+import { Directive, booleanAttribute, inject, input } from '@angular/core';
+import { classes } from '@spartan-ng/styles/utils';
+import { HlmDropdownMenuFocusOnHover } from './hlm-dropdown-menu-focus-on-hover';
+
+/** @internal. Use HlmDropdownMenuRadio instead. */
+@Directive({
+	selector: '[hlmDropdownMenuRadioCdk]',
+	providers: [
+		{ provide: CdkMenuItemRadio, useExisting: HlmDropdownMenuRadioCdk },
+		{ provide: CdkMenuItemSelectable, useExisting: HlmDropdownMenuRadioCdk },
+		{ provide: CdkMenuItem, useExisting: CdkMenuItemSelectable },
+	],
+})
+export class HlmDropdownMenuRadioCdk extends CdkMenuItemRadio {
+	public readonly keepOpen = input<boolean, BooleanInput>(true, { transform: booleanAttribute });
+
+	public override trigger(options?: { keepOpen: boolean }) {
+		super.trigger({ ...options, keepOpen: this.keepOpen() });
+	}
+}
+
+@Directive({
+	selector: '[hlmDropdownMenuRadio]',
+	hostDirectives: [
+		{
+			directive: HlmDropdownMenuRadioCdk,
+			inputs: ['cdkMenuItemDisabled: disabled', 'cdkMenuItemChecked: checked', 'keepOpen'],
+			outputs: ['cdkMenuItemTriggered: triggered'],
+		},
+		HlmDropdownMenuFocusOnHover,
+	],
+	host: {
+		'data-slot': 'dropdown-menu-radio-item',
+		'[attr.data-disabled]': '_cdkMenuItem.disabled ? "" : null',
+		'[attr.data-checked]': '_cdkMenuItem.checked ? "" : null',
+	},
+})
+export class HlmDropdownMenuRadio {
+	protected readonly _cdkMenuItem = inject(HlmDropdownMenuRadioCdk);
+
+	constructor() {
+		classes(
+			() =>
+				"hover:bg-accent focus:bg-accent hover:text-accent-foreground focus:text-accent-foreground gap-2 rounded-sm py-1.5 ps-2 pe-8 text-sm data-inset:ps-8 [&_ng-icon:not([class*='text-'])]:text-[length:--spacing(4)] group/dropdown-menu-radio relative flex w-full cursor-default items-center outline-hidden select-none data-disabled:pointer-events-none data-disabled:opacity-50 [&_ng-icon]:pointer-events-none [&_ng-icon]:shrink-0",
+		);
+	}
+}

package/dist/force-app/main/default/uiBundles/feature-angular-object-search/src/app/shared/dropdown-menu/hlm-dropdown-menu-separator.ts

@@ -0,0 +1,12 @@
+import { Directive } from '@angular/core';
+import { classes } from '@spartan-ng/styles/utils';
+
+@Directive({
+	selector: '[hlmDropdownMenuSeparator],hlm-dropdown-menu-separator',
+	host: { 'data-slot': 'dropdown-menu-separator' },
+})
+export class HlmDropdownMenuSeparator {
+	constructor() {
+		classes(() => 'bg-border -mx-1 my-1 h-px block');
+	}
+}

package/dist/force-app/main/default/uiBundles/feature-angular-object-search/src/app/shared/dropdown-menu/hlm-dropdown-menu-shortcut.ts

@@ -0,0 +1,15 @@
+import { Directive } from '@angular/core';
+import { classes } from '@spartan-ng/styles/utils';
+
+@Directive({
+	selector: '[hlmDropdownMenuShortcut],hlm-dropdown-menu-shortcut',
+	host: { 'data-slot': 'dropdown-menu-shortcut' },
+})
+export class HlmDropdownMenuShortcut {
+	constructor() {
+		classes(
+			() =>
+				'text-muted-foreground group-focus/dropdown-menu-item:text-accent-foreground ml-auto text-xs tracking-widest',
+		);
+	}
+}

package/dist/force-app/main/default/uiBundles/feature-angular-object-search/src/app/shared/dropdown-menu/hlm-dropdown-menu-sub-trigger.ts

@@ -0,0 +1,52 @@
+import { CdkMenuTrigger } from '@angular/cdk/menu';
+import { computed, Directive, effect, forwardRef, inject, input } from '@angular/core';
+import {
+	createMenuPosition,
+	MENU_SIDE,
+	type MenuAlign,
+	type MenuSide,
+} from '@spartan-ng/brain/core';
+import { classes } from '@spartan-ng/styles/utils';
+import { injectHlmDropdownMenuConfig } from './hlm-dropdown-menu-token';
+
+@Directive({
+	selector: '[hlmDropdownMenuSubTrigger]',
+	providers: [{ provide: MENU_SIDE, useExisting: forwardRef(() => HlmDropdownMenuSubTrigger) }],
+	hostDirectives: [
+		{
+			directive: CdkMenuTrigger,
+			inputs: [
+				'cdkMenuTriggerFor: hlmDropdownMenuSubTrigger',
+				'cdkMenuTriggerData: hlmDropdownMenuTriggerData',
+			],
+			outputs: [
+				'cdkMenuOpened: hlmDropdownMenuSubOpened',
+				'cdkMenuClosed: hlmDropdownMenuSubClosed',
+			],
+		},
+	],
+	host: { 'data-slot': 'dropdown-menu-sub-trigger' },
+})
+export class HlmDropdownMenuSubTrigger {
+	private readonly _cdkTrigger = inject(CdkMenuTrigger, { host: true });
+	private readonly _config = injectHlmDropdownMenuConfig();
+
+	public readonly align = input<MenuAlign>(this._config.align);
+	public readonly side = input<MenuSide>(this._config.side);
+
+	private readonly _menuPosition = computed(() => createMenuPosition(this.align(), this.side()));
+
+	constructor() {
+		// CDK sets transform-origin on the submenu content from the resolved position; the content reads it
+		// to animate from the anchored corner and to derive its data-side. Cast tolerates @angular/cdk < 21.2
+		// (we still support >=21.0), where the property is absent and the assignment is a harmless no-op.
+		(this._cdkTrigger as { transformOriginSelector?: string }).transformOriginSelector =
+			'[data-slot="dropdown-menu-sub"]';
+
+		effect(() => {
+			this._cdkTrigger.menuPosition = this._menuPosition();
+		});
+
+		classes(() => 'aria-expanded:bg-accent aria-expanded:text-accent-foreground');
+	}
+}

package/dist/force-app/main/default/uiBundles/feature-angular-object-search/src/app/shared/dropdown-menu/hlm-dropdown-menu-sub.ts

@@ -0,0 +1,53 @@
+import { CdkMenu } from '@angular/cdk/menu';
+import { Directive, ElementRef, inject, signal } from '@angular/core';
+import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
+import {
+	deriveMenuSideFromTransformOrigin,
+	MENU_SIDE,
+	type MenuSide,
+} from '@spartan-ng/brain/core';
+import { classes } from '@spartan-ng/styles/utils';
+
+@Directive({
+	selector: '[hlmDropdownMenuSub],hlm-dropdown-menu-sub',
+	hostDirectives: [CdkMenu],
+	host: {
+		'data-slot': 'dropdown-menu-sub',
+		'[attr.data-state]': '_state()',
+		'[attr.data-side]': '_side()',
+	},
+})
+export class HlmDropdownMenuSub {
+	private readonly _host = inject(CdkMenu);
+	private readonly _elementRef = inject(ElementRef<HTMLElement>);
+	// The sub-trigger provides its configured side; CDK parents this content's injector under it.
+	private readonly _menuSide = inject(MENU_SIDE, { optional: true });
+
+	protected readonly _state = signal('open');
+	protected readonly _side = signal<MenuSide>(this._menuSide?.side() ?? 'right');
+
+	constructor() {
+		this.setSideFromTransformOrigin();
+		// this is a best effort, but does not seem to work currently
+		// TODO: figure out a way for us to know the host is about to be closed. might not be possible with CDK
+		this._host.closed.pipe(takeUntilDestroyed()).subscribe(() => this._state.set('closed'));
+
+		classes(
+			() =>
+				'motion-safe:data-open:animate-in motion-safe:data-closed:animate-out data-closed:fade-out-0 data-open:fade-in-0 data-closed:zoom-out-95 data-open:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 ring-foreground/10 bg-popover text-popover-foreground min-w-[96px] rounded-md p-1 shadow-lg ring-1 duration-100 w-auto',
+		);
+	}
+
+	private setSideFromTransformOrigin() {
+		const side = this._menuSide?.side() ?? 'right';
+		// CDK sets transform-origin on this element synchronously on attach; read it next tick and derive side
+		setTimeout(() => {
+			this._side.set(
+				deriveMenuSideFromTransformOrigin(
+					this._elementRef.nativeElement.style.transformOrigin,
+					side,
+				),
+			);
+		});
+	}
+}

package/dist/force-app/main/default/uiBundles/feature-angular-object-search/src/app/shared/dropdown-menu/hlm-dropdown-menu-token.ts

@@ -0,0 +1,26 @@
+import { InjectionToken, type ValueProvider, inject } from '@angular/core';
+import { type MenuAlign, type MenuSide } from '@spartan-ng/brain/core';
+
+export interface HlmDropdownMenuConfig {
+	align: MenuAlign;
+	side: MenuSide;
+}
+
+const defaultConfig: HlmDropdownMenuConfig = {
+	align: 'start',
+	side: 'bottom',
+};
+
+const HlmDropdownMenuConfigToken = new InjectionToken<HlmDropdownMenuConfig>(
+	'HlmDropdownMenuConfig',
+);
+
+export function provideHlmDropdownMenuConfig(
+	config: Partial<HlmDropdownMenuConfig>,
+): ValueProvider {
+	return { provide: HlmDropdownMenuConfigToken, useValue: { ...defaultConfig, ...config } };
+}
+
+export function injectHlmDropdownMenuConfig(): HlmDropdownMenuConfig {
+	return inject(HlmDropdownMenuConfigToken, { optional: true }) ?? defaultConfig;
+}

package/dist/force-app/main/default/uiBundles/feature-angular-object-search/src/app/shared/dropdown-menu/hlm-dropdown-menu-trigger.ts

@@ -0,0 +1,46 @@
+import { CdkMenuTrigger } from '@angular/cdk/menu';
+import { computed, Directive, effect, forwardRef, inject, input } from '@angular/core';
+import {
+	createMenuPosition,
+	MENU_SIDE,
+	type MenuAlign,
+	type MenuSide,
+} from '@spartan-ng/brain/core';
+import { injectHlmDropdownMenuConfig } from './hlm-dropdown-menu-token';
+
+@Directive({
+	selector: '[hlmDropdownMenuTrigger]',
+	providers: [{ provide: MENU_SIDE, useExisting: forwardRef(() => HlmDropdownMenuTrigger) }],
+	hostDirectives: [
+		{
+			directive: CdkMenuTrigger,
+			inputs: [
+				'cdkMenuTriggerFor: hlmDropdownMenuTrigger',
+				'cdkMenuTriggerData: hlmDropdownMenuTriggerData',
+			],
+			outputs: ['cdkMenuOpened: hlmDropdownMenuOpened', 'cdkMenuClosed: hlmDropdownMenuClosed'],
+		},
+	],
+	host: { 'data-slot': 'dropdown-menu-trigger' },
+})
+export class HlmDropdownMenuTrigger {
+	private readonly _cdkTrigger = inject(CdkMenuTrigger, { host: true });
+	private readonly _config = injectHlmDropdownMenuConfig();
+
+	public readonly align = input<MenuAlign>(this._config.align);
+	public readonly side = input<MenuSide>(this._config.side);
+
+	private readonly _menuPosition = computed(() => createMenuPosition(this.align(), this.side()));
+
+	constructor() {
+		// CDK sets transform-origin on the menu content from the resolved position; the content reads it to
+		// animate from the anchored corner and to derive its data-side. Cast tolerates @angular/cdk < 21.2
+		// (we still support >=21.0), where the property is absent and the assignment is a harmless no-op.
+		(this._cdkTrigger as { transformOriginSelector?: string }).transformOriginSelector =
+			'[data-slot="dropdown-menu"]';
+
+		effect(() => {
+			this._cdkTrigger.menuPosition = this._menuPosition();
+		});
+	}
+}

package/dist/force-app/main/default/uiBundles/feature-angular-object-search/src/app/shared/dropdown-menu/hlm-dropdown-menu.ts

@@ -0,0 +1,57 @@
+import { type NumberInput } from '@angular/cdk/coercion';
+import { CdkMenu } from '@angular/cdk/menu';
+import { Directive, ElementRef, inject, input, numberAttribute, signal } from '@angular/core';
+import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
+import {
+	deriveMenuSideFromTransformOrigin,
+	MENU_SIDE,
+	type MenuSide,
+} from '@spartan-ng/brain/core';
+import { classes } from '@spartan-ng/styles/utils';
+
+@Directive({
+	selector: '[hlmDropdownMenu],hlm-dropdown-menu',
+	hostDirectives: [CdkMenu],
+	host: {
+		'data-slot': 'dropdown-menu',
+		'[attr.data-state]': '_state()',
+		'[attr.data-side]': '_side()',
+		'[style.--side-offset]': 'sideOffset()',
+	},
+})
+export class HlmDropdownMenu {
+	private readonly _host = inject(CdkMenu);
+	private readonly _elementRef = inject(ElementRef<HTMLElement>);
+	// The trigger provides its configured side; CDK parents this content's injector under the trigger's.
+	private readonly _menuSide = inject(MENU_SIDE, { optional: true });
+
+	protected readonly _state = signal('open');
+	protected readonly _side = signal<MenuSide>(this._menuSide?.side() ?? 'bottom');
+
+	public readonly sideOffset = input<number, NumberInput>(1, { transform: numberAttribute });
+
+	constructor() {
+		classes(
+			() =>
+				'motion-safe:data-open:animate-in motion-safe:data-closed:animate-out data-closed:fade-out-0 data-open:fade-in-0 data-closed:zoom-out-95 data-open:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 ring-foreground/10 bg-popover text-popover-foreground min-w-32 rounded-md p-1 shadow-md ring-1 duration-100 my-[--spacing(var(--side-offset))] overflow-x-hidden overflow-y-auto outline-none',
+		);
+
+		this.setSideFromTransformOrigin();
+		// this is a best effort, but does not seem to work currently
+		// TODO: figure out a way for us to know the host is about to be closed. might not be possible with CDK
+		this._host.closed.pipe(takeUntilDestroyed()).subscribe(() => this._state.set('closed'));
+	}
+
+	private setSideFromTransformOrigin() {
+		const side = this._menuSide?.side() ?? 'bottom';
+		// CDK sets transform-origin on this element synchronously on attach; read it next tick and derive side
+		setTimeout(() => {
+			this._side.set(
+				deriveMenuSideFromTransformOrigin(
+					this._elementRef.nativeElement.style.transformOrigin,
+					side,
+				),
+			);
+		});
+	}
+}