@praxisui/core 9.0.0-beta.84 → 9.0.0-beta.86

package/README.md

@@ -58,6 +58,80 @@ export class IconsComponent {}
 
 Hosts should load the icon fonts they use. Without the classic Material Icons font, ligature names such as `clear` can render as visible text.
 
+Use `PraxisIconButtonComponent` for icon-only actions. It keeps the native
+`button` contract, centers the glyph, and preserves a 44px pointer target even
+when the visible surface is compact. It accepts the same `mi:`, `mso:`, `msr:`
+and `mss:` icon-family prefixes as `PraxisIconDirective`; unprefixed names keep
+the legacy Material Icons behavior.
+
+```ts
+import { Component, signal } from '@angular/core';
+import { PraxisIconButtonComponent } from '@praxisui/core';
+
+@Component({
+  imports: [PraxisIconButtonComponent],
+  template: `
+    <button
+      type="button"
+      [praxisIconButton]="'mic'"
+      size="compact"
+      [pressed]="isListening()"
+      aria-label="Ditar pedido"
+    ></button>
+  `,
+})
+export class ComposerActionsComponent {
+  readonly isListening = signal(false);
+}
+```
+
+Public inputs:
+
+| Input | Values | Default | Purpose |
+| --- | --- | --- | --- |
+| `praxisIconButton` | icon name or canonical family-prefixed icon | required | Glyph materialized inside the button |
+| `size` | `dense`, `compact`, `standard` | `standard` | Governed target, visible surface and glyph density |
+| `appearance` | `plain`, `filled` | `plain` | Transparent or emphasized action surface |
+| `presentation` | `icon`, `projected` | `icon` | Uses the named glyph or host-projected governed presentation |
+| `pressed` | `true`, `false`, `null` | `null` | Persistent toggle/listening state and native `aria-pressed`; `null` omits the attribute |
+| `busy` | boolean | `false` | Replaces the glyph with the canonical progress indicator and publishes `aria-busy` |
+
+The component defaults the native host to `type="button"`; an explicit host
+attribute still documents intent and prevents accidental form submission in
+templates that are later refactored. Every icon-only action must have an
+accessible name, normally `aria-label`, supplied by the host or its i18n layer.
+The consumer remains responsible for `[disabled]` while busy when repeated
+activation must be blocked.
+Use `presentation="projected"` when an icon-only action is presented by a
+governed component such as `PraxisRichContent`; the canonical button continues
+to own interaction geometry while the projected renderer owns content semantics.
+
+The component owns target, surface and glyph alignment. Consumers may set
+`--praxis-icon-button-filled-background` and
+`--praxis-icon-button-filled-foreground` to materialize a governed semantic
+tone, but should not override the target, surface or icon size variables.
+Hosts must load the font family selected by the icon prefix and provide the
+Praxis Material 3 semantic color tokens.
+
+Governed density matrix:
+
+| Size | Pointer target | Visible surface | Glyph | Intended use |
+| --- | ---: | ---: | ---: | --- |
+| `standard` | 44px | 40px | 22px | Primary and standalone icon actions |
+| `compact` | 44px | 36px | 20px | Composers, headers and frequent application actions |
+| `dense` | 36px | 32px | 18px | Secondary actions inside constrained editorial toolbars |
+
+On coarse pointers, `dense` automatically restores a 44px pointer target while
+keeping its 32px visible surface. Do not use `dense` for a primary action, an
+isolated destructive action, pagination, or a control that must remain easy to
+acquire under operational pressure. Density changes presentation only; it must
+not encode authorization, importance or business state.
+
+Migration from `mat-icon-button` should remove local MDC/Material internal
+variables and local width, height, padding or icon-margin fixes. Keep
+domain-specific state, labels and action authorization in the owning component;
+the Core primitive owns presentation and native interaction only.
+
 ### Semantic theme surfaces
 
 `PraxisThemeSurfaceTokens` is the public semantic bridge for runtime surfaces. It deliberately avoids Material or MDC selectors, so a host can theme Praxis overlays, borders and focus states without patching component internals.
@@ -225,7 +299,7 @@ Core exports:
 - models for table config, fields, forms, rich content, editorial content, widget pages, global actions, resource discovery, domain knowledge/rules, analytics, query context, loading, and collection export
 - helpers for schema ids, ETag fetch, field mapping, config merge, validation, IDs, inline filter controls, global action refs, and form hooks
 - dynamic widget/page runtime components and metadata
-- UI helpers such as icon picker, empty state card, resource quick connect, schema viewer, and `PraxisIconDirective`
+- UI helpers such as icon picker, empty state card, resource quick connect, schema viewer, `PraxisIconDirective`, and `PraxisIconButtonComponent`
 
 See the package `public-api.ts` for the full export list.
 

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-07-20T15:03:50.126Z",
+  "generatedAt": "2026-07-22T03:01:56.888Z",
   "packageName": "@praxisui/core",
-  "packageVersion": "9.0.0-beta.84",
+  "packageVersion": "9.0.0-beta.86",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 4,