sos-portal-components-react 0.3.1 → 0.3.2

package/CHANGELOG.md

@@ -1,6 +1,11 @@
 # Changelog
 
-## Unreleased
+## 0.3.2 - 2026-11-10
+
+- Add controlled `SubjectCardLocatorFields` for card-number or DID/QR entry.
+  Number entry distinguishes person/animal and animal taxonomy, including
+  species beyond the supplied presets. Hosts provide labels/options and own
+  resolution and authorization; the fields select no mode, storage or provider.
 
 ## 0.3.1 - 2026-11-09
 
@@ -50,11 +55,11 @@
 
 - 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.
+  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
+- 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

package/README.md

@@ -21,6 +21,15 @@ release closure still requires every affected boundary.
 
 ## Runtime parity
 
+`SubjectCardLocatorFields` is a controlled web input, exported separately at
+`sos-portal-components-react/subject-card-locator-fields`. It distinguishes
+card number from DID/QR entry. For numbers, the user chooses person or animal;
+animals also choose a supplied species or enter another NCBI taxonomy ID.
+The host verifies those hints against the registered card. DID/QR lookup uses
+the registered identity without asking the user to reinterpret its species.
+The same renderer works in Demo and Network; it provides no authorization or
+persistence and requires a native renderer before use in Expo.
+
 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

package/dist/SubjectCardLocatorFields.d.ts

@@ -0,0 +1,32 @@
+export type SubjectCardLocatorValue = Readonly<{
+    method: 'card-number' | 'did-qr';
+    subjectKind: '' | 'person' | 'animal';
+    taxonomyId: string;
+    locator: string;
+}>;
+export type SubjectCardLocatorCopy = Readonly<{
+    method: string;
+    number: string;
+    didQr: string;
+    subjectKind: string;
+    choose: string;
+    person: string;
+    animal: string;
+    species: string;
+    taxonomy: string;
+    otherSpecies: string;
+    value: string;
+}>;
+export type SubjectCardLocatorFieldsProps = Readonly<{
+    copy: SubjectCardLocatorCopy;
+    value: SubjectCardLocatorValue;
+    speciesOptions: readonly Readonly<{
+        taxonomyId: string;
+        label: string;
+    }>[];
+    disabled?: boolean;
+    onChange(value: SubjectCardLocatorValue): void;
+}>;
+/** Controlled identification fields shared by portal modes; the host resolves and authorizes. */
+export declare function SubjectCardLocatorFields({ copy, value, speciesOptions, disabled, onChange }: SubjectCardLocatorFieldsProps): import("react").JSX.Element;
+//# sourceMappingURL=SubjectCardLocatorFields.d.ts.map

package/dist/SubjectCardLocatorFields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubjectCardLocatorFields.d.ts","sourceRoot":"","sources":["../src/SubjectCardLocatorFields.tsx"],"names":[],"mappings":"AAEA,MAAM,MAAM,uBAAuB,GAAC,QAAQ,CAAC;IAC3C,MAAM,EAAC,aAAa,GAAC,QAAQ,CAAA;IAC7B,WAAW,EAAC,EAAE,GAAC,QAAQ,GAAC,QAAQ,CAAA;IAChC,UAAU,EAAC,MAAM,CAAA;IACjB,OAAO,EAAC,MAAM,CAAA;CACf,CAAC,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAC,QAAQ,CAAC;IAC1C,MAAM,EAAC,MAAM,CAAC;IAAA,MAAM,EAAC,MAAM,CAAC;IAAA,KAAK,EAAC,MAAM,CAAC;IAAA,WAAW,EAAC,MAAM,CAAC;IAAA,MAAM,EAAC,MAAM,CAAA;IACzE,MAAM,EAAC,MAAM,CAAC;IAAA,MAAM,EAAC,MAAM,CAAC;IAAA,OAAO,EAAC,MAAM,CAAC;IAAA,QAAQ,EAAC,MAAM,CAAC;IAAA,YAAY,EAAC,MAAM,CAAC;IAAA,KAAK,EAAC,MAAM,CAAA;CAC5F,CAAC,CAAA;AACF,MAAM,MAAM,6BAA6B,GAAC,QAAQ,CAAC;IACjD,IAAI,EAAC,sBAAsB,CAAA;IAC3B,KAAK,EAAC,uBAAuB,CAAA;IAC7B,cAAc,EAAC,SAAS,QAAQ,CAAC;QAAC,UAAU,EAAC,MAAM,CAAC;QAAA,KAAK,EAAC,MAAM,CAAA;KAAC,CAAC,EAAE,CAAA;IACpE,QAAQ,CAAC,EAAC,OAAO,CAAA;IACjB,QAAQ,CAAC,KAAK,EAAC,uBAAuB,GAAE,IAAI,CAAA;CAC7C,CAAC,CAAA;AAEF,iGAAiG;AACjG,wBAAgB,wBAAwB,CAAC,EAAC,IAAI,EAAC,KAAK,EAAC,cAAc,EAAC,QAAQ,EAAC,QAAQ,EAAC,EAAC,6BAA6B,+BAoBnH"}

package/dist/SubjectCardLocatorFields.js

@@ -0,0 +1,9 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/** Controlled identification fields shared by portal modes; the host resolves and authorizes. */
+export function SubjectCardLocatorFields({ copy, value, speciesOptions, disabled, onChange }) {
+    const animalNumber = value.method === 'card-number' && value.subjectKind === 'animal';
+    const otherSpecies = Boolean(value.taxonomyId) && !speciesOptions.some(option => option.taxonomyId === value.taxonomyId);
+    return _jsxs("div", { className: "subject-card-locator-fields", children: [_jsxs("label", { children: [copy.method, _jsxs("select", { disabled: disabled, value: value.method, onChange: event => onChange({ ...value, method: event.currentTarget.value, subjectKind: '', taxonomyId: '' }), children: [_jsx("option", { value: "card-number", children: copy.number }), _jsx("option", { value: "did-qr", children: copy.didQr })] })] }), value.method === 'card-number' ? _jsxs("label", { children: [copy.subjectKind, _jsxs("select", { disabled: disabled, value: value.subjectKind, onChange: event => onChange({ ...value, subjectKind: event.currentTarget.value, taxonomyId: '' }), children: [_jsx("option", { value: "", children: copy.choose }), _jsx("option", { value: "person", children: copy.person }), _jsx("option", { value: "animal", children: copy.animal })] })] }) : null, animalNumber ? _jsxs(_Fragment, { children: [_jsxs("label", { children: [copy.species, _jsxs("select", { disabled: disabled, value: otherSpecies ? 'other' : value.taxonomyId, onChange: event => onChange({ ...value, taxonomyId: event.currentTarget.value }), children: [_jsx("option", { value: "", children: copy.choose }), speciesOptions.map(option => _jsx("option", { value: option.taxonomyId, children: option.label }, option.taxonomyId)), _jsx("option", { value: "other", children: copy.otherSpecies })] })] }), otherSpecies ? _jsxs("label", { children: [copy.taxonomy, _jsx("input", { disabled: disabled, inputMode: "numeric", value: value.taxonomyId === 'other' ? '' : value.taxonomyId, onChange: event => onChange({ ...value, taxonomyId: event.currentTarget.value || 'other' }) })] }) : null] }) : null, _jsxs("label", { children: [copy.value, _jsx("input", { disabled: disabled, autoComplete: "off", inputMode: value.method === 'card-number' ? 'numeric' : 'text', value: value.locator, onChange: event => onChange({ ...value, locator: event.currentTarget.value }) })] })] });
+}
+//# sourceMappingURL=SubjectCardLocatorFields.js.map

package/dist/SubjectCardLocatorFields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubjectCardLocatorFields.js","sourceRoot":"","sources":["../src/SubjectCardLocatorFields.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAoBZ,iGAAiG;AACjG,MAAM,UAAU,wBAAwB,CAAC,EAAC,IAAI,EAAC,KAAK,EAAC,cAAc,EAAC,QAAQ,EAAC,QAAQ,EAA+B;IAClH,MAAM,YAAY,GAAC,KAAK,CAAC,MAAM,KAAG,aAAa,IAAE,KAAK,CAAC,WAAW,KAAG,QAAQ,CAAA;IAC7E,MAAM,YAAY,GAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,IAAE,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAA,EAAE,CAAA,MAAM,CAAC,UAAU,KAAG,KAAK,CAAC,UAAU,CAAC,CAAA;IAChH,OAAO,eAAK,SAAS,EAAC,6BAA6B,aACjD,4BAAQ,IAAI,CAAC,MAAM,EAAC,kBAAQ,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAA,EAAE,CAAA,QAAQ,CAAC,EAAC,GAAG,KAAK,EAAC,MAAM,EAAC,KAAK,CAAC,aAAa,CAAC,KAA0C,EAAC,WAAW,EAAC,EAAE,EAAC,UAAU,EAAC,EAAE,EAAC,CAAC,aAC3M,iBAAQ,KAAK,EAAC,aAAa,YAAE,IAAI,CAAC,MAAM,GAAU,EAAA,iBAAQ,KAAK,EAAC,QAAQ,YAAE,IAAI,CAAC,KAAK,GAAU,IACvF,IAAQ,EAChB,KAAK,CAAC,MAAM,KAAG,aAAa,CAAA,CAAC,CAAA,4BAAQ,IAAI,CAAC,WAAW,EAAC,kBAAQ,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,QAAQ,EAAE,KAAK,CAAA,EAAE,CAAA,QAAQ,CAAC,EAAC,GAAG,KAAK,EAAC,WAAW,EAAC,KAAK,CAAC,aAAa,CAAC,KAA+C,EAAC,UAAU,EAAC,EAAE,EAAC,CAAC,aAC9O,iBAAQ,KAAK,EAAC,EAAE,YAAE,IAAI,CAAC,MAAM,GAAU,EAAA,iBAAQ,KAAK,EAAC,QAAQ,YAAE,IAAI,CAAC,MAAM,GAAU,EAAA,iBAAQ,KAAK,EAAC,QAAQ,YAAE,IAAI,CAAC,MAAM,GAAU,IAC1H,IAAQ,CAAA,CAAC,CAAA,IAAI,EACrB,YAAY,CAAA,CAAC,CAAA,8BACZ,4BAAQ,IAAI,CAAC,OAAO,EAAC,kBAAQ,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAA,CAAC,CAAA,OAAO,CAAA,CAAC,CAAA,KAAK,CAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAA,EAAE,CAAA,QAAQ,CAAC,EAAC,GAAG,KAAK,EAAC,UAAU,EAAC,KAAK,CAAC,aAAa,CAAC,KAAK,EAAC,CAAC,aACvK,iBAAQ,KAAK,EAAC,EAAE,YAAE,IAAI,CAAC,MAAM,GAAU,EACtC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAA,EAAE,CAAA,iBAAgC,KAAK,EAAE,MAAM,CAAC,UAAU,YAAG,MAAM,CAAC,KAAK,IAA1D,MAAM,CAAC,UAAU,CAAmD,CAAC,EAC9G,iBAAQ,KAAK,EAAC,OAAO,YAAE,IAAI,CAAC,YAAY,GAAU,IAC3C,IAAQ,EAChB,YAAY,CAAA,CAAC,CAAA,4BAAQ,IAAI,CAAC,QAAQ,EAAC,gBAAO,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAC,SAAS,EAAC,KAAK,EAAE,KAAK,CAAC,UAAU,KAAG,OAAO,CAAA,CAAC,CAAA,EAAE,CAAA,CAAC,CAAA,KAAK,CAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAA,EAAE,CAAA,QAAQ,CAAC,EAAC,GAAG,KAAK,EAAC,UAAU,EAAC,KAAK,CAAC,aAAa,CAAC,KAAK,IAAE,OAAO,EAAC,CAAC,GAAG,IAAQ,CAAA,CAAC,CAAA,IAAI,IAC5O,CAAA,CAAC,CAAA,IAAI,EACR,4BAAQ,IAAI,CAAC,KAAK,EAAC,gBAAO,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAC,KAAK,EAAC,SAAS,EAAE,KAAK,CAAC,MAAM,KAAG,aAAa,CAAA,CAAC,CAAA,SAAS,CAAA,CAAC,CAAA,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAA,EAAE,CAAA,QAAQ,CAAC,EAAC,GAAG,KAAK,EAAC,OAAO,EAAC,KAAK,CAAC,aAAa,CAAC,KAAK,EAAC,CAAC,GAAG,IAAQ,IAC/N,CAAA;AACR,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from './SubjectConversationChat.js';
 export * from './DeviceAssistancePreferences.js';
+export * from './SubjectCardLocatorFields.js';
 export * from './LiveKitRealtimeCallClient.js';
 export * from './EmergencyContactCardDirectory.js';
 export * from './PushNotificationRegistration.js';

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,kCAAkC,CAAA;AAChD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,oCAAoC,CAAA;AAClD,cAAc,mCAAmC,CAAA;AACjD,cAAc,sCAAsC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA;AAC5C,cAAc,kCAAkC,CAAA;AAChD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,oCAAoC,CAAA;AAClD,cAAc,mCAAmC,CAAA;AACjD,cAAc,sCAAsC,CAAA"}

package/dist/index.js

@@ -1,5 +1,6 @@
 export * from './SubjectConversationChat.js';
 export * from './DeviceAssistancePreferences.js';
+export * from './SubjectCardLocatorFields.js';
 export * from './LiveKitRealtimeCallClient.js';
 export * from './EmergencyContactCardDirectory.js';
 export * from './PushNotificationRegistration.js';

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,kCAAkC,CAAA;AAChD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,oCAAoC,CAAA;AAClD,cAAc,mCAAmC,CAAA;AACjD,cAAc,sCAAsC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA;AAC5C,cAAc,kCAAkC,CAAA;AAChD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,oCAAoC,CAAA;AAClD,cAAc,mCAAmC,CAAA;AACjD,cAAc,sCAAsC,CAAA"}

package/package.json

@@ -1,12 +1,16 @@
 {
   "name": "sos-portal-components-react",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Shared portal UI for base components",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
+    "./subject-card-locator-fields": {
+      "types": "./dist/SubjectCardLocatorFields.d.ts",
+      "default": "./dist/SubjectCardLocatorFields.js"
+    },
     "./device-assistance-preferences": {
       "types": "./dist/DeviceAssistancePreferences.d.ts",
       "default": "./dist/DeviceAssistancePreferences.js"