@molecule/app-settings-panel-react 1.0.5 → 1.0.7

package/README.md

@@ -3,15 +3,11 @@ AUTO-GENERATED — DO NOT EDIT THIS FILE.
 Generated by `mlcl sync-docs` from the package's src/index.ts JSDoc + mlcl/registry.json.
 Edits here are overwritten on the next commit (molecule's pre-commit hook regenerates).
 To change this document, edit the module-level JSDoc in src/index.ts.
-Generated: 2026-08-04T01:52:38.141Z
+Generated: 2026-10-24T04:27:27.710Z
 -->
 
 # @molecule/app-settings-panel-react
 
-> **Auto-generated, AI-first package reference** for the [molecule.dev](https://molecule.dev) ecosystem.
-> It is written to be read by coding agents as much as by people, and is generated from this
-> package's source — edit `src/index.ts` JSDoc, not this file.
-
 `@molecule/app-settings-panel-react` — composable, batteries-included
 settings panel.
 
@@ -36,6 +32,10 @@ through hooks:
   Apps compose via JSX children — pick sections, order them, and interleave
   custom sections.
 
+> **Auto-generated, AI-first package reference** for the [molecule.dev](https://molecule.dev) ecosystem.
+> It is written to be read by coding agents as much as by people, and is generated from this
+> package's source — edit `src/index.ts` JSDoc, not this file.
+
 ## Quick Start
 
 ```tsx
@@ -97,15 +97,17 @@ interface Device {
 }
 ```
 
-#### `PushToggleDevice`
+#### `SettingsPanelContextValue`
 
-Device row slice returned by `GET /api/devices`.
+Context published by `<SettingsContainer>` to its children.
+
+The container owns the dismiss-the-panel handler; sub-components
+that need to close after an action (logout, delete account, email
+error) read it from context rather than threading the prop down.
 
 ```typescript
-interface PushToggleDevice {
-  id: string
-  isCurrent?: boolean
-  hasPushSubscription?: boolean
+interface SettingsPanelContextValue {
+  onClose: () => void
 }
 ```
 
@@ -120,28 +122,26 @@ interface PushToggleHttp {
 }
 ```
 
-#### `PushToggleToken`
+#### `PushToggleDevice`
 
-Push token slice returned by `@molecule/app-push` `register()`.
+Device row slice returned by `GET /api/devices`.
 
 ```typescript
-interface PushToggleToken {
-  value: string
-  platform: 'web' | 'ios' | 'android'
+interface PushToggleDevice {
+  id: string
+  isCurrent?: boolean
+  hasPushSubscription?: boolean
 }
 ```
 
-#### `SettingsPanelContextValue`
-
-Context published by `<SettingsContainer>` to its children.
+#### `PushToggleToken`
 
-The container owns the dismiss-the-panel handler; sub-components
-that need to close after an action (logout, delete account, email
-error) read it from context rather than threading the prop down.
+Push token slice returned by `@molecule/app-push` `register()`.
 
 ```typescript
-interface SettingsPanelContextValue {
-  onClose: () => void
+interface PushToggleToken {
+  value: string
+  platform: 'web' | 'ios' | 'android'
 }
 ```
 
@@ -267,62 +267,6 @@ function DevicesSection({
 }): JSX.Element
 ```
 
-#### `disablePushOnCurrentDevice(deps)`
-
-Disables push: unsubscribes the browser (best-effort — a dev build without
-a service worker has nothing to unsubscribe) and ALWAYS clears the server
-state so no further pushes target this device.
-
-```typescript
-function disablePushOnCurrentDevice(deps: {
-  http: PushToggleHttp
-  unregister: () => Promise<void>
-}): Promise<PushToggleResult>
-```
-
-- `deps` — The http client + push action from `usePush()`.
-- `deps.http` — Authenticated http client (`useHttpClient()`).
-- `deps.unregister` — `usePush().unregister`.
-
-**Returns:** `{ ok: true }` or a typed failure (server state not cleared).
-
-#### `enablePushOnCurrentDevice(deps)`
-
-Runs the full enable chain: browser permission → runtime VAPID public key
-(`GET /api/devices/push/public-key`) → `register({ vapidPublicKey })` →
-persist the subscription on the current device row.
-
-Every failure is returned as a typed reason (never thrown) so the UI can
-show an honest, specific message instead of hanging or silently reverting.
-
-```typescript
-function enablePushOnCurrentDevice(deps: {
-  http: PushToggleHttp
-  requestPermission: () => Promise<string>
-  register: (options?: { vapidPublicKey?: string }) => Promise<PushToggleToken>
-}): Promise<PushToggleResult>
-```
-
-- `deps` — The http client + push actions from `usePush()`.
-- `deps.http` — Authenticated http client (`useHttpClient()`).
-- `deps.requestPermission` — `usePush().requestPermission`.
-- `deps.register` — `usePush().register`.
-
-**Returns:** `{ ok: true }` or a typed failure.
-
-#### `findCurrentDevice(devices)`
-
-Picks the caller's own device row: the api flags the session device
-`isCurrent`; fall back to the first row for sessions predating the flag.
-
-```typescript
-function findCurrentDevice(devices: PushToggleDevice[] | undefined): PushToggleDevice | undefined
-```
-
-- `devices` — Rows from `GET /api/devices`.
-
-**Returns:** The current device row, or `undefined` when the user has none.
-
 #### `LogOutDeleteSection()`
 
 Bottom actions section — Log out + Delete account.
@@ -354,19 +298,6 @@ hanging the switch.
 function NotificationsSection(): JSX.Element
 ```
 
-#### `readCurrentDevicePushEnabled(http)`
-
-Reads whether push is currently enabled for THIS device (server truth:
-the current device row's `hasPushSubscription`).
-
-```typescript
-function readCurrentDevicePushEnabled(http: PushToggleHttp): Promise<boolean>
-```
-
-- `http` — Authenticated http client (`useHttpClient()`).
-
-**Returns:** `true` when the current device has a stored subscription.
-
 #### `SettingsContainer(props)`
 
 Outer settings-panel layout: padded vertical stack that hosts the
@@ -384,20 +315,6 @@ function SettingsContainer({
 }): ReactElement<unknown, string | JSXElementConstructor<any>>
 ```
 
-#### `subscriptionFromToken(token)`
-
-Converts an `@molecule/app-push` token into the device resource's
-`pushSubscription` shape (web PushSubscription JSON, FCM registration for
-Android, APNs registration for iOS).
-
-```typescript
-function subscriptionFromToken(token: PushToggleToken): unknown
-```
-
-- `token` — The push token returned by `register()`.
-
-**Returns:** The `pushSubscription` value to PATCH onto the device row.
-
 #### `ThisDeviceSection()`
 
 "This device" detail strip — OS, browser, online/offline.
@@ -435,6 +352,89 @@ Throws if used outside the container so component misuse is loud.
 function useSettingsPanelContext(): SettingsPanelContextValue
 ```
 
+#### `findCurrentDevice(devices)`
+
+Picks the caller's own device row: the api flags the session device
+`isCurrent`; fall back to the first row for sessions predating the flag.
+
+```typescript
+function findCurrentDevice(devices: PushToggleDevice[] | undefined): PushToggleDevice | undefined
+```
+
+- `devices` — Rows from `GET /api/devices`.
+
+**Returns:** The current device row, or `undefined` when the user has none.
+
+#### `subscriptionFromToken(token)`
+
+Converts an `@molecule/app-push` token into the device resource's
+`pushSubscription` shape (web PushSubscription JSON, FCM registration for
+Android, APNs registration for iOS).
+
+```typescript
+function subscriptionFromToken(token: PushToggleToken): unknown
+```
+
+- `token` — The push token returned by `register()`.
+
+**Returns:** The `pushSubscription` value to PATCH onto the device row.
+
+#### `enablePushOnCurrentDevice(deps)`
+
+Runs the full enable chain: browser permission → runtime VAPID public key
+(`GET /api/devices/push/public-key`) → `register({ vapidPublicKey })` →
+persist the subscription on the current device row.
+
+Every failure is returned as a typed reason (never thrown) so the UI can
+show an honest, specific message instead of hanging or silently reverting.
+
+```typescript
+function enablePushOnCurrentDevice(deps: {
+  http: PushToggleHttp
+  requestPermission: () => Promise<string>
+  register: (options?: { vapidPublicKey?: string }) => Promise<PushToggleToken>
+}): Promise<PushToggleResult>
+```
+
+- `deps` — The http client + push actions from `usePush()`.
+- `deps.http` — Authenticated http client (`useHttpClient()`).
+- `deps.requestPermission` — `usePush().requestPermission`.
+- `deps.register` — `usePush().register`.
+
+**Returns:** `{ ok: true }` or a typed failure.
+
+#### `disablePushOnCurrentDevice(deps)`
+
+Disables push: unsubscribes the browser (best-effort — a dev build without
+a service worker has nothing to unsubscribe) and ALWAYS clears the server
+state so no further pushes target this device.
+
+```typescript
+function disablePushOnCurrentDevice(deps: {
+  http: PushToggleHttp
+  unregister: () => Promise<void>
+}): Promise<PushToggleResult>
+```
+
+- `deps` — The http client + push action from `usePush()`.
+- `deps.http` — Authenticated http client (`useHttpClient()`).
+- `deps.unregister` — `usePush().unregister`.
+
+**Returns:** `{ ok: true }` or a typed failure (server state not cleared).
+
+#### `readCurrentDevicePushEnabled(http)`
+
+Reads whether push is currently enabled for THIS device (server truth:
+the current device row's `hasPushSubscription`).
+
+```typescript
+function readCurrentDevicePushEnabled(http: PushToggleHttp): Promise<boolean>
+```
+
+- `http` — Authenticated http client (`useHttpClient()`).
+
+**Returns:** `true` when the current device has a stored subscription.
+
 ### Constants
 
 #### `SettingsPanelContext`
@@ -451,7 +451,7 @@ const SettingsPanelContext: Context<SettingsPanelContextValue | null>
 
 Peer dependencies:
 
-- `@molecule/app-auth` ^1.0.1
+- `@molecule/app-auth` ^1.0.1 || ^2.0.0
 - `@molecule/app-react` ^1.0.1
 - `@molecule/app-ui` ^1.0.1
 - `@molecule/app-ui-react` ^1.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@molecule/app-settings-panel-react",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "Composable settings panel — a SettingsContainer + family of section sub-components (Account, Auth, Notifications, Billing, Devices, ThisDevice, LogOutDelete). Apps compose via JSX children, picking which sections to include and what order.",
   "homepage": "https://www.molecule.dev/packages/app-settings-panel-react",
   "type": "module",
@@ -34,19 +34,19 @@
     "directory": "packages/app/features/settings-panel-react"
   },
   "devDependencies": {
-    "@types/node": "26.1.2",
+    "@types/node": "26.6.5",
     "typescript": "6.0.3",
-    "vitest": "4.1.11",
-    "@molecule/app-auth": "1.1.2",
-    "@molecule/app-react": "1.6.0",
-    "@molecule/app-ui": "1.3.4",
-    "@molecule/app-ui-react": "1.3.0",
-    "@types/react": "19.2.17",
-    "react": "19.2.8",
-    "react-router": "8.3.0"
+    "vitest": "4.1.12",
+    "@molecule/app-auth": "2.0.0",
+    "@molecule/app-react": "1.10.2",
+    "@molecule/app-ui": "1.3.8",
+    "@molecule/app-ui-react": "1.3.6",
+    "@types/react": "19.3.0",
+    "react": "19.3.1",
+    "react-router": "8.5.0"
   },
   "peerDependencies": {
-    "@molecule/app-auth": "^1.0.1",
+    "@molecule/app-auth": "^1.0.1 || ^2.0.0",
     "@molecule/app-react": "^1.0.1",
     "@molecule/app-ui": "^1.0.1",
     "@molecule/app-ui-react": "^1.0.1",