hazo_auth 10.5.0 → 10.6.0

package/README.md

@@ -1620,11 +1620,11 @@ The component automatically shows/hides tabs based on the user's permissions, so
 
 ### Choose the UI Shell (Test Sidebar vs Standalone)
 
-By default, the pages render inside the "test workspace" sidebar so you can quickly preview every flow. When you reuse the routes inside another project you'll usually want a clean, standalone wrapper instead. Set this in `hazo_auth_config.ini`:
+By default, pages render with a clean, standalone wrapper that inherits your own app shell, layout, and theme tokens. The "test workspace" sidebar (`test_sidebar`) is opt-in and intended only for this package's own demo/dev app (Storybook screenshots, quickly previewing every flow). Set this in `hazo_auth_config.ini`:
 
 ```ini
 [hazo_auth__ui_shell]
-# Options: test_sidebar | standalone
+# Options: standalone (default) | test_sidebar
 layout_mode = standalone
 vertical_center = auto  # 'auto' enables vertical centering when navbar is present
 # Optional tweaks for the standalone header wrapper/classes:
@@ -1634,11 +1634,13 @@ vertical_center = auto  # 'auto' enables vertical centering when navbar is prese
 # standalone_content_class = mx-auto w-full max-w-4xl rounded-2xl border bg-card
 ```
 
-- `test_sidebar`: keeps the developer sidebar (perfect for the demo workspace or Storybook screenshots).
-- `standalone`: renders the page body directly so it inherits your own app shell, layout, and theme tokens.
+- `standalone` (default): renders the page body directly so it inherits your own app shell, layout, and theme tokens.
+- `test_sidebar`: keeps the developer sidebar. Opt-in only, meant for this package's own demo/dev app — do not set this in consuming apps.
 - `vertical_center`: controls vertical centering of auth content (`auto` enables centering when navbar is present)
 - The wrapper and content class overrides let you align spacing/borders with your design system without editing package code.
 
+**`pages/*` vs `components/layouts/*`:** The `hazo_auth/pages/*` exports (e.g. `hazo_auth/pages/login`, `/register`, etc.) are full-screen pages meant to be rendered at page root by consumers — they should not be wrapped in a fixed-width card/container. If you need an embedded/card-style form (e.g. inside a modal or a section of an existing page), use the bare `components/layouts/login` component with `layout="form_only"` instead.
+
 ### Authentication Page Navbar
 
 **The navbar now works automatically** - zero-config server page components include the navbar based on configuration without manual wrapping.

package/cli-src/lib/ui_shell_config.server.ts

@@ -27,11 +27,15 @@ export type UiShellConfig = {
 /**
  * Reads ui shell configuration controlling whether pages use the sidebar test shell
  * or a clean standalone wrapper that inherits consumer project styling.
+ *
+ * `standalone` is the default so consuming apps get a clean wrapper out of the box.
+ * `test_sidebar` must be explicitly opted into via config and is intended for use
+ * by this package's own demo/dev app only.
  */
 export function get_ui_shell_config(): UiShellConfig {
   const section = "hazo_auth__ui_shell";
 
-  const layoutModeValue = get_config_value(section, "layout_mode", "test_sidebar").toLowerCase();
+  const layoutModeValue = get_config_value(section, "layout_mode", "standalone").toLowerCase();
   const layout_mode: UiShellLayoutMode =
     layoutModeValue === "standalone" ? "standalone" : "test_sidebar";
 

package/dist/lib/ui_shell_config.server.d.ts

@@ -17,6 +17,10 @@ export type UiShellConfig = {
 /**
  * Reads ui shell configuration controlling whether pages use the sidebar test shell
  * or a clean standalone wrapper that inherits consumer project styling.
+ *
+ * `standalone` is the default so consuming apps get a clean wrapper out of the box.
+ * `test_sidebar` must be explicitly opted into via config and is intended for use
+ * by this package's own demo/dev app only.
  */
 export declare function get_ui_shell_config(): UiShellConfig;
 //# sourceMappingURL=ui_shell_config.server.d.ts.map

package/dist/lib/ui_shell_config.server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui_shell_config.server.d.ts","sourceRoot":"","sources":["../../src/lib/ui_shell_config.server.ts"],"names":[],"mappings":"AAEA,OAAO,aAAa,CAAC;AAIrB,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG9E,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,YAAY,CAAC;AAE9D,MAAM,MAAM,aAAa,GAAG;IAC1B,WAAW,EAAE,iBAAiB,CAAC;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,wBAAwB,EAAE,MAAM,CAAC;IACjC,wBAAwB,EAAE,MAAM,CAAC;IACjC,uBAAuB,EAAE,OAAO,CAAC;IACjC,2BAA2B,EAAE,OAAO,CAAC;IACrC,+CAA+C;IAC/C,MAAM,EAAE,YAAY,CAAC;IACrB,mDAAmD;IACnD,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC;AAGF;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CA6DnD"}
+{"version":3,"file":"ui_shell_config.server.d.ts","sourceRoot":"","sources":["../../src/lib/ui_shell_config.server.ts"],"names":[],"mappings":"AAEA,OAAO,aAAa,CAAC;AAIrB,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG9E,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,YAAY,CAAC;AAE9D,MAAM,MAAM,aAAa,GAAG;IAC1B,WAAW,EAAE,iBAAiB,CAAC;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,wBAAwB,EAAE,MAAM,CAAC;IACjC,wBAAwB,EAAE,MAAM,CAAC;IACjC,uBAAuB,EAAE,OAAO,CAAC;IACjC,2BAA2B,EAAE,OAAO,CAAC;IACrC,+CAA+C;IAC/C,MAAM,EAAE,YAAY,CAAC;IACrB,mDAAmD;IACnD,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC;AAGF;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CA6DnD"}

package/dist/lib/ui_shell_config.server.js

@@ -8,10 +8,14 @@ import { get_navbar_config } from "./navbar_config.server.js";
 /**
  * Reads ui shell configuration controlling whether pages use the sidebar test shell
  * or a clean standalone wrapper that inherits consumer project styling.
+ *
+ * `standalone` is the default so consuming apps get a clean wrapper out of the box.
+ * `test_sidebar` must be explicitly opted into via config and is intended for use
+ * by this package's own demo/dev app only.
  */
 export function get_ui_shell_config() {
     const section = "hazo_auth__ui_shell";
-    const layoutModeValue = get_config_value(section, "layout_mode", "test_sidebar").toLowerCase();
+    const layoutModeValue = get_config_value(section, "layout_mode", "standalone").toLowerCase();
     const layout_mode = layoutModeValue === "standalone" ? "standalone" : "test_sidebar";
     const standalone_heading = get_config_value(section, "standalone_heading", "Welcome to hazo auth");
     const standalone_description = get_config_value(section, "standalone_description", "Reuse the packaged authentication flows while inheriting your existing app shell styles.");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hazo_auth",
-  "version": "10.5.0",
+  "version": "10.6.0",
   "description": "Zero-config authentication UI components for Next.js with RBAC, OAuth, scope-based multi-tenancy, and invitations",
   "keywords": [
     "authentication",
@@ -262,14 +262,14 @@
     "@radix-ui/react-switch": "^1.2.0",
     "@radix-ui/react-tabs": "^1.1.0",
     "@radix-ui/react-tooltip": "^1.2.0",
-    "hazo_api": "^2.4.0",
+    "hazo_api": "^2.5.1",
     "hazo_config": "^2.4.1",
     "hazo_connect": "^3.9.0",
-    "hazo_core": "^1.2.0",
+    "hazo_core": "^1.2.1",
     "hazo_logs": "^2.1.1",
     "hazo_notify": "^6.1.4",
-    "hazo_secure": "^1.1.0",
-    "hazo_ui": "^4.6.2",
+    "hazo_secure": "^1.3.0",
+    "hazo_ui": "^4.9.0",
     "input-otp": "^1.4.0",
     "lucide-react": "^0.553.0",
     "next": "^14.0.0",
@@ -408,7 +408,7 @@
     "hazo_core": "^1.2.1",
     "hazo_logs": "^2.1.1",
     "hazo_notify": "^6.1.4",
-    "hazo_ui": "^4.7.0",
+    "hazo_ui": "^4.9.0",
     "input-otp": "^1.4.0",
     "jest": "^30.2.0",
     "jest-environment-jsdom": "^30.0.0",