Button

Base Button is a focusable command control for one discrete action. It owns activation, disabled gating, focus, transient interaction facts, and the outward click signal; it deliberately does not own a visual language.

P-BASE-BUTTON catalogs two authoring entries for the same protocol:

• the direct base-button Prototype, exported as button from @proto.ui/prototypes-base/button;
• the authored asButton() hook for a derived Prototype that needs to retain Button semantics.

The public props surface currently contains only disabled. Exposed facts are disabled, hovered, focused, focusVisible, and held-down pressed; focusSelf() requests focus, and successful activation emits click. The signal is protocol output, not a props callback and not a promise of a native DOM click implementation.

Button uses the official trigger route for pointer and keyboard activation. Space participates in the press lifecycle and prevents its scrolling default; Enter activation follows the host trigger path. A disabled Button rejects activation and active focus requests, emits no click, and clears transient interaction state.

The Web profile projects command-control accessibility and takes the accessible name from authored content. Form submission, type, name, command integration, and visual variants are outside the current Base guarantee.

The stable 0.2.0 package exports @proto.ui/prototypes-base/button, and the CLI registry exposes base-button. The focused protocol evidence is T-BASE-BUTTON-0001 and packages/prototypes/base/test/as-button.test.ts. This page’s preview exercises the same Web host profile through the Web Component, React, and Vue adapters.

P-BASE-BUTTON is draft. Package publication makes the implementation consumable; it does not turn the draft protocol into a frozen compatibility guarantee.

• P-BASE-BUTTON
• Button source
• Button evidence
• Styled projections: Shadcn Button and Brutalist Button