@djangocfg/layouts 2.1.581 → 2.1.582

package/README.md

@@ -201,16 +201,39 @@ send analytics directly from a layout.
 
 ---
 
+## Snippets
+
+Small surfaces a host mounts once, exported from `@djangocfg/layouts` and `@djangocfg/layouts/snippets`:
+
+| Export | What |
+|---|---|
+| `AuthDialog`, `useAuthDialog` | The global sign-in dialog. `BaseApp` mounts it with `auth` enabled; anything can open it, including a widget that only has `dialogStore`. |
+| `TwoFactorSetup` | Enrol flow for a settings page: QR, confirmation code, backup codes. |
+| `TwoFactorChallengeDialog` | The code prompt that opens over the page when a sign-in step needs 2FA. `AuthLayout` mounts it. |
+| Analytics | Re-exported from `@djangocfg/analytics` for older imports; new code imports that package (see Analytics above). |
+| `Breadcrumbs` | Breadcrumbs from `items`, or from the current path when none are given. |
+
+## Stories and tests
+
+`@djangocfg/layouts/testing` is for Storybook and tests only: `MockAuthProvider` and `buildMockUser` give `useAuth()` a fixed session, `MockAuthFormProvider` and the step components mount a sign-in step without the full `AuthLayout`. Do not import it from production code.
+
+---
+
 ## Package exports
 
 | Path | Contents |
 |---|---|
 | `@djangocfg/layouts` | Barrel. |
 | `@djangocfg/layouts/layouts` | Layout components. |
+| `@djangocfg/layouts/snippets` | `AuthDialog`, the 2FA surfaces, `Breadcrumbs`, `Devtools`, the analytics re-export. |
 | `@djangocfg/layouts/components` | Misc + `ErrorLayout`, `RedirectPage`. |
-| `@djangocfg/layouts/pages/legal` | Legal page templates. |
-| `@djangocfg/layouts/configurator` | JSON Schemas for `<JsonSchemaForm>`-driven configurator UIs (PrivateLayout for now). Pair with `@djangocfg/widget-forms`. |
+| `@djangocfg/layouts/utils` | Path matching and sidebar-navigation helpers, logger. |
+| `@djangocfg/layouts/pages` | Page templates (`legal`). |
+| `@djangocfg/layouts/configurator` | JSON Schemas for `<JsonSchemaForm>`-driven configurator UIs. Pair with `@djangocfg/widget-forms`. |
+| `@djangocfg/layouts/configurator/private` | The `PrivateLayout` configurator schema on its own. |
+| `@djangocfg/layouts/testing` | Storybook and test helpers; not for production code. |
 | `@djangocfg/layouts/styles` | Base CSS. |
+| `@djangocfg/layouts/styles/dashboard` | Dashboard shell CSS. |
 
 Extensions: `@djangocfg/ext-newsletter`, `ext-knowbase`, `ext-leads`, `ext-payments`, `ext-support`, …
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/layouts",
-  "version": "2.1.581",
+  "version": "2.1.582",
   "description": "Simple, straightforward layout components for Next.js - import and use with props",
   "keywords": [
     "layouts",
@@ -90,11 +90,11 @@
     "check": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@djangocfg/analytics": "^2.1.581",
-    "@djangocfg/api": "^2.1.581",
-    "@djangocfg/devtools": "^2.1.581",
-    "@djangocfg/i18n": "^2.1.581",
-    "@djangocfg/ui-core": "^2.1.581",
+    "@djangocfg/analytics": "^2.1.582",
+    "@djangocfg/api": "^2.1.582",
+    "@djangocfg/devtools": "^2.1.582",
+    "@djangocfg/i18n": "^2.1.582",
+    "@djangocfg/ui-core": "^2.1.582",
     "@hookform/resolvers": "^5.2.2",
     "consola": "^3.4.2",
     "lucide-react": "^0.545.0",
@@ -124,12 +124,12 @@
     "uuid": "^11.1.1"
   },
   "devDependencies": {
-    "@djangocfg/analytics": "^2.1.581",
-    "@djangocfg/api": "^2.1.581",
-    "@djangocfg/devtools": "^2.1.581",
-    "@djangocfg/i18n": "^2.1.581",
-    "@djangocfg/typescript-config": "^2.1.581",
-    "@djangocfg/ui-core": "^2.1.581",
+    "@djangocfg/analytics": "^2.1.582",
+    "@djangocfg/api": "^2.1.582",
+    "@djangocfg/devtools": "^2.1.582",
+    "@djangocfg/i18n": "^2.1.582",
+    "@djangocfg/typescript-config": "^2.1.582",
+    "@djangocfg/ui-core": "^2.1.582",
     "@storybook/react-vite": "^10.5.0",
     "@types/node": "^25.9.5",
     "@types/react": "19.2.15",