@salesforce/ui-bundle-template-app-angular-template-b2x 11.60.0 → 11.62.0

package/dist/force-app/main/default/uiBundles/angularextapp/src/app/shared/spartan/dropdown-menu/src/lib/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/angularextapp/src/app/shared/spartan/dropdown-menu/src/lib/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/angularextapp/src/app/shared/spartan/dropdown-menu/src/lib/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/angularextapp/src/app/shared/spartan/dropdown-menu/src/lib/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/angularextapp/src/app/shared/spartan/dropdown-menu/src/lib/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/angularextapp/src/app/shared/spartan/dropdown-menu/src/lib/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/angularextapp/src/app/shared/spartan/dropdown-menu/src/lib/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/angularextapp/src/app/shared/spartan/dropdown-menu/src/lib/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/angularextapp/src/app/shared/spartan/dropdown-menu/src/lib/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/angularextapp/src/app/shared/spartan/dropdown-menu/src/lib/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/angularextapp/src/app/shared/spartan/dropdown-menu/src/lib/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/angularextapp/src/app/shared/spartan/dropdown-menu/src/lib/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/angularextapp/src/app/shared/spartan/dropdown-menu/src/lib/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,
+				),
+			);
+		});
+	}
+}

package/dist/force-app/main/default/uiBundles/angularextapp/src/app/shared/spartan/field/src/index.ts

@@ -0,0 +1,34 @@
+import { HlmField } from './lib/hlm-field';
+import { HlmFieldContent } from './lib/hlm-field-content';
+import { HlmFieldDescription } from './lib/hlm-field-description';
+import { HlmFieldError } from './lib/hlm-field-error';
+import { HlmFieldGroup } from './lib/hlm-field-group';
+import { HlmFieldLabel } from './lib/hlm-field-label';
+import { HlmFieldLegend } from './lib/hlm-field-legend';
+import { HlmFieldSeparator } from './lib/hlm-field-separator';
+import { HlmFieldSet } from './lib/hlm-field-set';
+import { HlmFieldTitle } from './lib/hlm-field-title';
+
+export * from './lib/hlm-field';
+export * from './lib/hlm-field-content';
+export * from './lib/hlm-field-description';
+export * from './lib/hlm-field-error';
+export * from './lib/hlm-field-group';
+export * from './lib/hlm-field-label';
+export * from './lib/hlm-field-legend';
+export * from './lib/hlm-field-separator';
+export * from './lib/hlm-field-set';
+export * from './lib/hlm-field-title';
+
+export const HlmFieldImports = [
+	HlmField,
+	HlmFieldContent,
+	HlmFieldDescription,
+	HlmFieldError,
+	HlmFieldGroup,
+	HlmFieldLabel,
+	HlmFieldLegend,
+	HlmFieldSeparator,
+	HlmFieldSet,
+	HlmFieldTitle,
+] as const;

package/dist/force-app/main/default/uiBundles/angularextapp/src/app/shared/spartan/field/src/lib/hlm-field-content.ts

@@ -0,0 +1,12 @@
+import { Directive } from '@angular/core';
+import { classes } from '@spartan-ng/styles/utils';
+
+@Directive({
+	selector: '[hlmFieldContent],hlm-field-content',
+	host: { 'data-slot': 'field-content' },
+})
+export class HlmFieldContent {
+	constructor() {
+		classes(() => 'gap-0.5 group/field-content flex flex-1 flex-col leading-snug');
+	}
+}

package/dist/force-app/main/default/uiBundles/angularextapp/src/app/shared/spartan/field/src/lib/hlm-field-description.ts

@@ -0,0 +1,53 @@
+import { Directive, effect, EffectRef, inject, input, OnDestroy } from '@angular/core';
+import { BrnFieldA11yService } from '@spartan-ng/brain/field';
+import { classes } from '@spartan-ng/styles/utils';
+
+@Directive({
+	selector: '[hlmFieldDescription],hlm-field-description',
+	host: {
+		'data-slot': 'field-description',
+		'[attr.id]': 'id()',
+	},
+})
+export class HlmFieldDescription implements OnDestroy {
+	private static _id = 0;
+
+	private readonly _a11y = inject(BrnFieldA11yService, { optional: true, host: true });
+
+	public readonly id = input<string>(`hlm-field-description-${HlmFieldDescription._id++}`);
+
+	private _registeredId?: string;
+
+	private readonly _cleanup: EffectRef | null = this._a11y
+		? effect(() => {
+				const a11y = this._a11y;
+				if (!a11y) return;
+
+				const id = this.id();
+				if (this._registeredId && this._registeredId !== id) {
+					a11y.unregisterDescription(this._registeredId);
+				}
+
+				if (this._registeredId !== id) {
+					a11y.registerDescription(id);
+					this._registeredId = id;
+				}
+			})
+		: null;
+
+	constructor() {
+		classes(() => [
+			'text-muted-foreground text-start text-sm [[data-variant=legend]+&]:-mt-1.5 leading-normal font-normal group-has-data-horizontal/field:text-balance',
+			'last:mt-0 nth-last-2:-mt-1',
+			'[&>a:hover]:text-primary [&>a]:underline [&>a]:underline-offset-4',
+		]);
+	}
+
+	ngOnDestroy() {
+		this._cleanup?.destroy();
+
+		if (this._registeredId) {
+			this._a11y?.unregisterDescription(this._registeredId);
+		}
+	}
+}

package/dist/force-app/main/default/uiBundles/angularextapp/src/app/shared/spartan/field/src/lib/hlm-field-error.ts

@@ -0,0 +1,100 @@
+import { BooleanInput } from '@angular/cdk/coercion';
+import {
+	booleanAttribute,
+	ChangeDetectionStrategy,
+	Component,
+	computed,
+	effect,
+	EffectRef,
+	inject,
+	input,
+	OnDestroy,
+} from '@angular/core';
+import { BrnField, BrnFieldA11yService } from '@spartan-ng/brain/field';
+import { classes } from '@spartan-ng/styles/utils';
+
+@Component({
+	selector: 'hlm-field-error',
+	changeDetection: ChangeDetectionStrategy.OnPush,
+	host: {
+		role: 'alert',
+		'data-slot': 'field-error',
+		'[attr.id]': 'id()',
+		'[hidden]': '!_display()',
+	},
+	template: `
+		@if (_display()) {
+			<ng-content />
+		}
+	`,
+})
+export class HlmFieldError implements OnDestroy {
+	private static _id = 0;
+
+	private readonly _field = inject(BrnField, { optional: true });
+	private readonly _a11y = inject(BrnFieldA11yService, { optional: true, host: true });
+
+	private _registeredId?: string | undefined;
+
+	private readonly _hasParentField = !!this._field;
+
+	/** The unique ID for the field error. If none is supplied, it will be auto-generated. */
+	public readonly id = input<string>(`hlm-field-error-${HlmFieldError._id++}`);
+
+	/**
+	 * The name of the specific validator error key to match (e.g. 'required').
+	 * When omitted, the error is shown if any validation error is present.
+	 */
+	public readonly validator = input<string>();
+
+	/** Forces the error message to be visible regardless of the control's validation state. */
+	public readonly forceShow = input<boolean, BooleanInput>(false, { transform: booleanAttribute });
+
+	protected readonly _display = computed(
+		() => !this._hasParentField || this.forceShow() || this._hasError(),
+	);
+
+	protected readonly _hasError = computed(() => {
+		const errors = this._field?.errors();
+		if (!errors) return false;
+
+		const validator = this.validator();
+		const spartanInvalid = this._field?.controlState()?.spartanInvalid;
+
+		if (!spartanInvalid) return false;
+
+		return validator ? validator in errors : Object.keys(errors).length > 0;
+	});
+
+	private readonly _cleanup: EffectRef | null = this._a11y
+		? effect(() => {
+				const a11y = this._a11y;
+				if (!a11y) return;
+
+				const id = this.id();
+				const hasError = this._hasError();
+
+				if (this._registeredId && (this._registeredId !== id || !hasError)) {
+					a11y.unregisterError(this._registeredId);
+					this._registeredId = undefined;
+				}
+
+				if (hasError && this._registeredId !== id) {
+					a11y.registerError(id);
+					this._registeredId = id;
+				}
+			})
+		: null;
+
+	constructor() {
+		classes(() => 'text-destructive text-sm font-normal');
+	}
+
+	ngOnDestroy() {
+		this._cleanup?.destroy();
+
+		if (this._registeredId) {
+			this._a11y?.unregisterError(this._registeredId);
+		}
+	}
+}

package/dist/force-app/main/default/uiBundles/angularextapp/src/app/shared/spartan/field/src/lib/hlm-field-group.ts

@@ -0,0 +1,15 @@
+import { Directive } from '@angular/core';
+import { classes } from '@spartan-ng/styles/utils';
+
+@Directive({
+	selector: '[hlmFieldGroup],hlm-field-group',
+	host: { 'data-slot': 'field-group' },
+})
+export class HlmFieldGroup {
+	constructor() {
+		classes(
+			() =>
+				'gap-5 data-[slot=checkbox-group]:gap-3 *:data-[slot=field-group]:gap-4 group/field-group @container/field-group flex w-full flex-col',
+		);
+	}
+}