sos-portal-components-react 0.2.3 → 0.3.0

package/CHANGELOG.md

@@ -2,6 +2,42 @@
 
 ## Unreleased
 
+## 0.3.0 - 2026-11-08
+
+- Export shared device-assistance preferences through an independent SOS entry,
+  delegating its controlled web renderer to Antifraud 0.3.0. Keep runtime,
+  capability detection, storage and authorization in the owning application.
+  Native preferences rendering is not implemented by this release.
+- Typecheck, build and the independent export smoke pass. Cross-application
+  phone-authenticated browser checks belong to the CH acceptance evidence.
+- List the three implemented runtime exports separately from the acceptance
+  catalogue. Base shell/profile/card extraction from the existing domain
+  package remains pending; controller administration has a separate owner.
+
+- Specify shared subject-control placement, semantic option/action colours,
+  account-menu versus subject-device grants, appearance namespace parity and
+  separate model enablement/availability/preparation states in the existing
+  Tuskr cases. These are acceptance requirements, not new runtime readiness.
+
+- Correct the shared acceptance guides to use the selected simulated-phone
+  tests without mailbox access. Treat current email-only Organization/employee
+  contracts as an implementation gap; preserve official-source verification,
+  independent profile authority and existing GW/DID behavior.
+
+- Replace the dated developer handoff with numbered, README-linked guides for
+  generic portal modes/authentication and detailed cross-portal Tuskr cases.
+  Preserve the existing `SOS-PORTAL-001`–`029` and specialist research IDs.
+- Distinguish public Demo real-email account login from fixed Firebase test
+  phone fixtures, BFF-owned Demo persistence from Test Network authority/GW
+  lifecycle, and dedicated RTC media from Communication history and assistants.
+- Document positive/negative Personal ↔ Professional journeys, both-side
+  readback, profile/relationship revocation, sector variants and evidence
+  boundaries without claiming unexecuted gates have passed.
+- Specify dependency-by-case progression: BFF/memory Demo first, independent
+  terminology-cache and RTC additions, and memory-GW -> local Fabric ->
+  online Test Network acceptance for network cases. Retain green evidence and
+  rerun only failed/affected gates while closing the cumulative release set.
+
 ## 0.2.3 - 2026-11-07
 
 - Render caller-cancelled Communications as `Cancelled`/`Cancelada` rather

package/README.md

@@ -1,9 +1,30 @@
 # SOS Portal Components React
 
+## Numbered engineering guides
+
+1. [00 — Documentation index](docs/00-INDEX.md)
+2. [01 — Portal modes, authentication and authority](docs/01-PORTAL_MODES_AND_AUTH.md)
+3. [02 — Cross-portal Tuskr cases](docs/02-CROSS_PORTAL_TUSKR_CASES.md)
+
+Read these with the owning CH application's README for runnable commands and
+flavour configuration. The cases below retain their stable IDs; the numbered
+guides supply cross-portal steps, expected results and negative checks.
+
+Start dependencies by use case: local Demo UI/BFF uses the memory vault and
+no GW; clinical coding/cache cases add Terminology through its SDK, and call
+cases add LiveKit independently. Network cases progress from GW memory/test
+to local Fabric, then the chosen online `dev:staging` Test Network flavours.
+Demo stays BFF-only throughout. See the
+[dependency table](docs/01-PORTAL_MODES_AND_AUTH.md#11-start-dependencies-for-the-case-being-tested).
+Rerun the smallest failed/affected gate while retaining valid green evidence;
+release closure still requires every affected boundary.
+
 ## Runtime parity
 
-These components render the same use-case state in Demo, Test Network, web and
-Expo. They never select storage. Owning applications inject memory for
+Components share use-case state between Demo and Test Network. Native support
+is export-specific: conversation uses the React Native/Web adapter; the device
+preferences renderer currently uses web DOM. A native preferences renderer
+remains future work. Components never select storage. Applications inject memory for
 all-local, Expo SQLite for native, or an explicit durable adapter. Firestore
 must not create a Demo-only component or data model.
 
@@ -18,8 +39,11 @@ health, animal care, public safety, emergency response and other configured
 sectors. The package exists to prevent each sector flavour from reimplementing
 the same shell, access journey, card navigation and governed subject workflows.
 
-The current repository and Demo-boundary handoff is summarized in
-[`docs/DEVELOPER_UPDATE_2026-11-06.md`](docs/DEVELOPER_UPDATE_2026-11-06.md).
+Public Demo authenticates a real email account and uses BFF-validated synthetic
+profiles. Fixed Firebase test-phone codes belong only to tests in ignored
+configuration, never public Demo access. Demo business state stays behind the
+BFF Confidential Storage boundary; Test Network separately proves the complete
+organization/employee/subject lifecycle through its real authority and GW.
 
 The first implementation of a workflow may be proven in the animal-care
 portals. That does not make every future human-health consumer depend
@@ -50,6 +74,32 @@ revalidated by the BFF/Gateway.
 
 ## Implemented exports
 
+This is the current runtime inventory, not completion of the whole catalogue:
+
+| Export | Owner / responsibility |
+| --- | --- |
+| `SubjectConversationChat` | SOS projection of authorized subject Communications into the neutral Antifraud conversation renderer. |
+| `createLiveKitRealtimeCallClient` | Host-configured RTC client adapter; the BFF retains authorization, credentials and Communication persistence. |
+| `DeviceAssistancePreferences` | Reexport of Antifraud's controlled web preferences renderer. |
+
+The complete base-UI extraction is still pending. `PortalHeader`,
+`PortalSettingsPanel`, profile protection, subject/card navigation and several
+contact, permission and clinical controls remain in
+`uhc-portal-components-react`; application composition also remains in the
+owning portals. Research stays there pending its future owner. The catalogue
+below is acceptance scope and must not be read as an implemented export list.
+Controller administration is owned separately by
+`antifraud-hosting-components-react`.
+
+- `sos-portal-components-react/device-assistance-preferences` reexports the
+  controlled `DeviceAssistancePreferences` owned by the neutral Antifraud
+  package. Import `antifraud-portal-components-react/device-assistance-preferences.css`
+  once in the application shell. It separates consent, runtime availability
+  and explicit preparation; hosts supply localized labels, storage and runtime
+  adapters. Rendering/toggling does not prepare a model or grant subject access.
+  Use this independent entry on account pages to avoid loading conversation
+  and RTC modules. Do not fork another device preferences panel per flavour.
+
 - `sos-portal-components-react/subject-conversation-chat` provides the
   canonical React Native/Web adapter for an already-authorized subject
   conversation. It projects the stable SOS entry model into the neutral
@@ -68,6 +118,11 @@ executed for every applicable flavour, actor, viewport and environment. Demo
 uses synthetic state and must say so; Test Network and Production must use
 their real authorized BFF path.
 
+Use [02 — Cross-portal Tuskr cases](docs/02-CROSS_PORTAL_TUSKR_CASES.md)
+for Personal ↔ Professional prerequisites, numbered actions, both-side
+readback, rejected access, reset/revocation and execution evidence. A documented
+case is an acceptance target, not an end-to-end pass claim.
+
 | ID | Area | Governed journey and acceptance target |
 |---|---|---|
 | SOS-PORTAL-001 | Shell | Render the shared top bar, brand slot, account/profile menu, current subject and responsive navigation without flavour-specific forks. |
@@ -95,7 +150,7 @@ their real authorized BFF path.
 | SOS-PORTAL-023 | Provider directory | Select authorized card/index, clinical, appointment or emergency providers from host-supplied directories without hard-coded flavour endpoints. |
 | SOS-PORTAL-024 | Accessibility | Complete every shared journey by keyboard and screen reader with visible focus, labelled controls, status announcements and responsive layouts. |
 | SOS-PORTAL-025 | Expo reuse | Render platform-neutral contracts in Expo Android/iOS adapters and web adapters while retaining one message/card/action model and host-owned native capabilities. |
-| SOS-PORTAL-026 | Preferences | Apply light/dark/system appearance, text size, locale and accessibility preferences before and after sign-in without changing authorization. |
+| SOS-PORTAL-026 | Preferences | Reuse one device/account Preferences surface across modes: appearance, text size, locale, accessibility and actual speech/language-model enablement/availability/preparation, with explicit disabled states and no implied subject authorization. |
 | SOS-PORTAL-027 | Failure safety | Fail closed on missing capabilities, expired sessions, invalid attachments, unavailable providers or rejected persistence and preserve an actionable, non-sensitive error. |
 | SOS-PORTAL-028 | Controller embedding | In CH Management, embed the published Antifraud controller components for groups, departments, workforce and memberships until controller access is removed from branded professional portals. |
 | SOS-PORTAL-029 | Conversation threads | Open the individual card's root channel and authorized child threads for members, related entities or emergency contacts; each thread keeps stable subject/relationship/participant identifiers, and contact status alone grants no message access. |

package/dist/DeviceAssistancePreferences.d.ts

@@ -0,0 +1,2 @@
+export { DeviceAssistancePreferences, type DeviceAssistanceFeature, type DeviceAssistancePreferencesProps } from 'antifraud-portal-components-react/device-assistance-preferences';
+//# sourceMappingURL=DeviceAssistancePreferences.d.ts.map

package/dist/DeviceAssistancePreferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceAssistancePreferences.d.ts","sourceRoot":"","sources":["../src/DeviceAssistancePreferences.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,2BAA2B,EAAE,KAAK,uBAAuB,EAAE,KAAK,gCAAgC,EAAC,MAAM,iEAAiE,CAAA"}

package/dist/DeviceAssistancePreferences.js

@@ -0,0 +1,2 @@
+export { DeviceAssistancePreferences } from 'antifraud-portal-components-react/device-assistance-preferences';
+//# sourceMappingURL=DeviceAssistancePreferences.js.map

package/dist/DeviceAssistancePreferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceAssistancePreferences.js","sourceRoot":"","sources":["../src/DeviceAssistancePreferences.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,2BAA2B,EAAsE,MAAM,iEAAiE,CAAA"}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export * from './SubjectConversationChat.js';
+export * from './DeviceAssistancePreferences.js';
 export * from './LiveKitRealtimeCallClient.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA;AAC5C,cAAc,gCAAgC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA;AAC5C,cAAc,kCAAkC,CAAA;AAChD,cAAc,gCAAgC,CAAA"}

package/dist/index.js

@@ -1,3 +1,4 @@
 export * from './SubjectConversationChat.js';
+export * from './DeviceAssistancePreferences.js';
 export * from './LiveKitRealtimeCallClient.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA;AAC5C,cAAc,gCAAgC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA;AAC5C,cAAc,kCAAkC,CAAA;AAChD,cAAc,gCAAgC,CAAA"}

package/package.json

@@ -1,12 +1,16 @@
 {
   "name": "sos-portal-components-react",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "description": "Shared portal UI for base components",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
+    "./device-assistance-preferences": {
+      "types": "./dist/DeviceAssistancePreferences.d.ts",
+      "default": "./dist/DeviceAssistancePreferences.js"
+    },
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
@@ -67,7 +71,7 @@
     }
   },
   "dependencies": {
-    "antifraud-portal-components-react": "0.2.2",
+    "antifraud-portal-components-react": "0.3.0",
     "sos-data-utils-ts": "0.6.29"
   },
   "devDependencies": {