@nezam.ai/web-toolbar

Browser toolbar package that exposes two surfaces:

• createControl / renderControl for the office-style application toolbar used by forms and grouped controls.
• createToolbar / normalizeToolbarDefinition for the generic item toolbar API used by diagram and editor surfaces.
• createGridToolbar / renderGridToolbar for the demo-style filter/search toolbar with row count, namebox, and toolbar actions.
• The grid toolbar emits onToolbarAction, onSearchChange, onApplySearch, and related callback hooks for app-specific filtering behavior.
• describeGridToolbarEvents is available for registering toolbar button click descriptors in host runtimes.

Standalone showcase pages live under demos/ and demonstrate the package as a mountable browser surface with multiple live toolbar demos. The gallery currently includes ribbon, ribbon tab cycle, ribbon visibility cycle, ribbon hidden and disabled, empty ribbon fallback, ribbon descriptors, ribbon descriptor updates, ribbon top buttons, ribbon primary and secondary, ribbon icon and leading, ribbon icon label fallbacks, ribbon icon aliases, ribbon parent label tabs, ribbon label fallbacks, ribbon metadata fallbacks, ribbon navigation metadata, ribbon action label fallbacks, command bar, separator layout, separator implicit ids, grid search, legacy aliases, row-count alias, row-count text alias, search aria label, search mode, namebox label, action aliases, action title fallbacks, action icon aliases, namebox visibility, cell mode, focus shortcuts, keyboard enter, keyboard escape, search aliases, filter and sort callbacks, callback aliases, grid descriptor updates, grid runtime swap, grid event detail, lifecycle teardown, command load swaps, runtime cycles, menu reloads, teardown cycles, update lifecycle, focus state, state restore, focus restore, command context swap, policy inspection, normalization snapshot, gate inspection, command state cycle, command state aliases, command-state aliases, validation state cycle, context mode cycle, selection rules, requires-selection aliases, option data, item data inspector, event data detail, option gating, option-state aliases, option validation cycle, option host gate, option enabled alias, item enabled alias, option method actions, items shorthand, serialize snapshots, load array shorthand, dispatch shorthand, validation lab, activation tour, activation errors, toggle state, segmented state, menu state, disabled state, event detail, listener lifecycle, listener rebind, diagram bridge, dispatch relay, dispatch precedence, method precedence, diagram methods, diagram active state, option selection alias, defaults, hidden-namebox, grid normalization inspector, disabled actions, pressed actions, row-count update, imperative API, descriptor explorer, and grid variant demos. Run npm run demo in this package to serve the showcase locally. Open http://127.0.0.1:4173/toolbar/demos/ in the browser after the server starts.

The package is the public entrypoint and owns its implementation.