hazo_ui 5.1.1 → 6.1.0

package/CHANGE_LOG.md

@@ -5,6 +5,41 @@ 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;
+`hazo_theme` is now the single source and a **required** peer.
+
+### Breaking
+- **`useTheme()` return shape changed**: `{ theme, ... }` → `{ mode, setMode, themeSet, setThemeSet, ... }`.
+  Rename all `useTheme().theme` call sites to `.mode`.
+- **Removed package exports** `hazo_ui/styles.css` and `hazo_ui/tailwind-preset`. Import
+  `hazo_theme/theme.css` (and use hazo_theme's tokens) instead.
+- **`hazo_theme` peer flipped optional → required** (`^1.0.0`). Consumers must install hazo_theme.
+- **Persisted-pref reset (one-time)**: theme `storageKey` default `"theme"` → `"hazo-theme"`, so a
+  user's saved mode resets to `system` once.
+
+### Migration
+- Replace `@import "hazo_ui/styles.css"` (and any `hazo_ui/tailwind-preset` usage) with
+  `@import "hazo_theme/theme.css"`; add `@source ".../hazo_theme/dist"` where you scan hazo_ui.
+- `npm install hazo_theme@^1.0.0` alongside hazo_ui.
+
+### New
+- Chrome components sourced from hazo_theme's brand-identity contract: `AppFooter`, `AppHeader`,
+  `AppLogo`, and `HazoUiIconPicker`.
+- `HazoThemeProvider` / `useTheme` / `ThemeScript` / `ThemeToggle` / `ThemeSetPicker` are now
+  re-exported from `hazo_theme/client`.
+- `HazoUiDialog` header bar consumes hazo_theme's `--dialog-header-bar-*` tokens (no more hardcoded
+  colours).
+
 ## v5.1.0 (2026-07-10)
 
 ### New

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;