STANDALONE API

Import

Import only the Menu primitives used by the consuming standalone component.

import { NeuralMenu, NeuralMenuGroup, NeuralMenuItem, NeuralMenuSeparatorItem, NeuralMenuTrigger, type NeuralMenuEntry } from '@neural-ng/core/menu';

@Component({ imports: [NeuralMenu, NeuralMenuGroup, NeuralMenuTrigger] })

Inline commands

Data entries support icons, badges, shortcuts, links, separators and disabled commands without becoming a navigation tree.

Category groups

Group labels organize a flat command sequence without becoming selectable items or nested navigation. Data and projected APIs share the same ARIA group semantics.

Popup trigger

The trigger directive connects directly to NeuralButton’s native button, owns ARIA, transfers focus and restores it after Escape.

Logical positions

Start and end follow document direction. The shared Overlay positioner flips or clamps when available space changes.

Projected structure

Use projected primitives when commands are clearer in the template. Data and projected sources remain deliberately exclusive.

Controlled state and dismissal

open is a Signal model. Disable close-on-select for multi-step command surfaces and close explicitly when work is complete.

Links and metadata

Use routerLink for Angular SPA navigation and href for native or external destinations. Data-driven and projected items share the complete Router options contract. Badge and shortcut remain visual metadata; command behavior still flows through itemSelect.

const items: readonly NeuralMenuEntry[] = [
  { key: 'profile', label: 'Profile', iconClass: 'nt-user', shortcut: 'Ctrl P' },
  { key: 'notifications', label: 'Notifications', badge: 4 },
  { separator: true, key: 'main-separator' },
  {
    key: 'docs',
    label: 'Documentation',
    routerLink: ['/docs', 'installation'],
    queryParams: { source: 'menu' },
  },
  { key: 'help', label: 'External help', href: 'https://example.com/help', target: '_blank', rel: 'noopener' },
];

Unstyled and typed class slots

Semantics, keyboard behavior, structural hooks and popup positioning remain while all visual ownership moves to consumer classes.

Component boundary

Menu is a flat command list. PanelMenu owns inline hierarchy; nested flyouts belong to TieredMenu, while application navigation layouts belong to Menubar, Drawer or Sidebar patterns.

Menu inputs

MenuItem inputs

MenuGroup inputs

MenuTrigger inputs

Events

Methods

Typed class slots

Data contract

NeuralMenuEntry is the union of a keyed action, separator, and category group. Group labels are presentation-only; all group and action keys must be stable and unique. When data and projected children coexist, data wins with a development warning.

Component tokens