hazo_ui 6.0.0 → 6.1.0

package/CHANGE_LOG.md

@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## v6.1.0 (unreleased)
+
+### New
+- feat: add `permissionToast` helper (FR-017) — an opinionated wrapper around
+  `errorToast` that standardizes permission-failure toasts (fixed "Permission
+  required" title, composed missing-permission description, optional action
+  button). Exported alongside `PermissionToastOptions` from `hazo_ui`.
+
 ## v6.0.0 (2026-07-11)
 
 Major — the P1 hazo_theme rehome. hazo_ui stops owning theme tokens, preset, and provider;

package/README.md

@@ -226,7 +226,7 @@ Lightweight, opinionated components for the four ubiquitous async states: **load
 - **[ErrorPage](#errorpage)** - Full-page error fallback with title, description, error code tag, correlation id, and CTAs.
 - **[LoadingTimeout](#loadingtimeout)** - Wraps a loading region and escalates messaging at 5s / 15s / 30s thresholds before showing a retry banner.
 - **[ProgressiveImage](#progressiveimage)** - Three-stage image render: grey placeholder → blurred LQIP → sharp final image.
-- **[HazoUiToaster + toast helpers](#toasts-hazouitoaster--successtoast--errortoast)** - `sonner`-backed toaster with `successToast()` and `errorToast()` imperative helpers.
+- **[HazoUiToaster + toast helpers](#toasts-hazouitoaster--successtoast--errortoast)** - `sonner`-backed toaster with `successToast()`, `errorToast()`, and `permissionToast()` imperative helpers.
 - **[useLoadingState](#useloadingstate)** hook - `{ isLoading, setLoading, withLoading }` with an async wrapper.
 - **[useErrorDisplay](#useerrordisplay)** hook - Passive `{ error, setError, clearError }` that coerces `Error` instances to strings.
 
@@ -3443,6 +3443,29 @@ try { await sync(); } catch (e) {
 | `duration` | `number` (ms) | `3000` success / `5000` error |
 | `action` | `{ label: string; onClick: () => void }` | — |
 
+**`permissionToast(opts: PermissionToastOptions)`** — an opinionated wrapper around
+`errorToast` for permission-failure UX. Always titles the toast `"Permission required"`
+and composes a description from the missing permission key(s) (and optional human
+descriptions), so every "you can't do that" moment in the app reads consistently:
+
+```tsx
+import { permissionToast } from "hazo_ui";
+
+permissionToast({
+  missingPermissions: ["env.migrate"],
+  descriptions: { "env.migrate": "Migrate environments" },
+  action: { label: "Request access", onClick: () => requestAccess() },
+});
+// → "Permission required" / "Missing: `env.migrate` — Migrate environments"
+```
+
+| Prop | Type | Default |
+|---|---|---|
+| `missingPermissions` | `string[]` | **required** |
+| `descriptions` | `Record<string, string>` | — |
+| `action` | `{ label: string; onClick: () => void }` | — |
+| `duration` | `number` (ms) | `5000` |
+
 Also exports `rawToast` (re-export of sonner's `toast`) for advanced use cases.
 
 ### useWakeLock / use_wake_lock

package/dist/index.cjs

@@ -8819,6 +8819,23 @@ function errorToast({ title, description, duration = 5e3, action }) {
     action: action ? { label: action.label, onClick: action.onClick } : void 0
   });
 }
+function permissionToast({
+  missingPermissions,
+  descriptions,
+  action,
+  duration = 5e3
+}) {
+  const description = missingPermissions.length === 0 ? "You do not have permission to perform this action." : `Missing: ${missingPermissions.map((key) => {
+    const label = descriptions?.[key];
+    return label ? `\`${key}\` \u2014 ${label}` : `\`${key}\``;
+  }).join("; ")}`;
+  return errorToast({
+    title: "Permission required",
+    description,
+    action,
+    duration
+  });
+}
 function useLoadingState(initial = false) {
   const [isLoading, setLoading] = React27.useState(initial);
   const withLoading = React27.useCallback(async (fn) => {
@@ -12135,6 +12152,7 @@ exports.get_logger = get_logger;
 exports.isLucideValue = isLucideValue;
 exports.median = median;
 exports.parse_commands_from_text = parse_commands_from_text;
+exports.permissionToast = permissionToast;
 exports.pick_x_label_indices = pick_x_label_indices;
 exports.reset_hazo_ui_config = reset_hazo_ui_config;
 exports.resolve_animation_classes = resolve_animation_classes;