uhc-portal-components-react 0.1.9 → 0.1.10

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.1.10 - 2026-08-03
+
+- Add the reusable organization workforce administration surface with total,
+  used and free license counters, active/inactive employee lifecycle actions,
+  invitation status history and an optional future device count.
+- Add browser-DOM interaction tests proving controlled inputs, disabled invite
+  behavior, callbacks and the disable-before-purge rule.
+
 ## 0.1.9 - 2026-08-02
 
 - Allow the SOSChain card picker to expose a host-owned card-import action for

package/README.md

@@ -62,6 +62,10 @@ The package deliberately exposes modules instead of a cloned application:
 - `SoschainWorkspace`: subject-card picker and four-area workspace for Places,
   devices/vehicles and read-only emergency communications. The host supplies
   already-authorized cards and capabilities.
+- `OrganizationWorkforceAdministration`: controlled license-capacity,
+  employee lifecycle and invitation-status UI. Invitations remain host-owned
+  application records; the component does not reserve licenses or create GW
+  employees.
 
 Clinical label semantics stay in `gdc-common-utils-ts` / the SDK reader. Hosts
 pass human titles to `ClinicalSectionSummary`: local `CodeableConcept.text`

package/dist/OrganizationWorkforceAdministration.d.ts

@@ -0,0 +1,82 @@
+export type WorkforceLicenseSummary = Readonly<{
+    total: number;
+    used: number;
+    free: number;
+}>;
+export type WorkforceEmployee = Readonly<{
+    id: string;
+    licenseId: string;
+    email: string;
+    role: string;
+    status: 'active' | 'inactive';
+    deviceCount?: number;
+}>;
+export type WorkforceInvitation = Readonly<{
+    id: string;
+    email: string;
+    role: string;
+    status: 'pending' | 'accepted' | 'cancelled';
+    sentAt?: string;
+}>;
+export type WorkforceRoleOption = Readonly<{
+    value: string;
+    label: string;
+}>;
+export type OrganizationWorkforceCopy = Readonly<{
+    title: string;
+    description: string;
+    totalLicenses: string;
+    usedLicenses: string;
+    freeLicenses: string;
+    employeesTitle: string;
+    invitationsTitle: string;
+    inviteTitle: string;
+    emailLabel: string;
+    roleLabel: string;
+    unlockSecretLabel: string;
+    invite: string;
+    inviting: string;
+    noFreeLicenses: string;
+    noEmployees: string;
+    noInvitations: string;
+    licenseColumn: string;
+    employeeColumn: string;
+    roleColumn: string;
+    statusColumn: string;
+    devicesColumn: string;
+    actionsColumn: string;
+    active: string;
+    inactive: string;
+    pending: string;
+    accepted: string;
+    cancelled: string;
+    disable: string;
+    purge: string;
+    devicesLater: string;
+}>;
+export type OrganizationWorkforceAdministrationProps = Readonly<{
+    copy: OrganizationWorkforceCopy;
+    summary: WorkforceLicenseSummary;
+    employees: readonly WorkforceEmployee[];
+    invitations: readonly WorkforceInvitation[];
+    roles: readonly WorkforceRoleOption[];
+    email: string;
+    role: string;
+    unlockSecret: string;
+    busyAction?: string;
+    error?: string;
+    onEmailChange: (value: string) => void;
+    onRoleChange: (value: string) => void;
+    onUnlockSecretChange: (value: string) => void;
+    onInvite: () => void | Promise<void>;
+    onDisable: (employeeId: string) => void | Promise<void>;
+    onPurge: (employeeId: string) => void | Promise<void>;
+}>;
+/**
+ * Controlled organization workforce surface shared by professional portals.
+ *
+ * The component never infers authorization or changes GW state. The host owns
+ * invitation persistence, license reads and employee lifecycle commands.
+ */
+export declare function OrganizationWorkforceAdministration({ copy, summary, employees, invitations, roles, email, role, unlockSecret, busyAction, error, onEmailChange, onRoleChange, onUnlockSecretChange, onInvite, onDisable, onPurge, }: OrganizationWorkforceAdministrationProps): import("react").JSX.Element;
+//# sourceMappingURL=OrganizationWorkforceAdministration.d.ts.map

package/dist/OrganizationWorkforceAdministration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrganizationWorkforceAdministration.d.ts","sourceRoot":"","sources":["../src/OrganizationWorkforceAdministration.tsx"],"names":[],"mappings":"AAEA,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC;IAC7C,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb,CAAC,CAAA;AAEF,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACvC,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAA;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAC,CAAA;AAEF,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAA;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAC,CAAA;AAEF,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAE5E,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAC/C,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE,MAAM,CAAA;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,iBAAiB,EAAE,MAAM,CAAA;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,MAAM,CAAA;CACrB,CAAC,CAAA;AAEF,MAAM,MAAM,wCAAwC,GAAG,QAAQ,CAAC;IAC9D,IAAI,EAAE,yBAAyB,CAAA;IAC/B,OAAO,EAAE,uBAAuB,CAAA;IAChC,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAA;IACvC,WAAW,EAAE,SAAS,mBAAmB,EAAE,CAAA;IAC3C,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAA;IACrC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACrC,oBAAoB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7C,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpC,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvD,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACtD,CAAC,CAAA;AAEF;;;;;GAKG;AACH,wBAAgB,mCAAmC,CAAC,EAClD,IAAI,EACJ,OAAO,EACP,SAAS,EACT,WAAW,EACX,KAAK,EACL,KAAK,EACL,IAAI,EACJ,YAAY,EACZ,UAAU,EACV,KAAK,EACL,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,QAAQ,EACR,SAAS,EACT,OAAO,GACR,EAAE,wCAAwC,+BA4D1C"}

package/dist/OrganizationWorkforceAdministration.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Controlled organization workforce surface shared by professional portals.
+ *
+ * The component never infers authorization or changes GW state. The host owns
+ * invitation persistence, license reads and employee lifecycle commands.
+ */
+export function OrganizationWorkforceAdministration({ copy, summary, employees, invitations, roles, email, role, unlockSecret, busyAction, error, onEmailChange, onRoleChange, onUnlockSecretChange, onInvite, onDisable, onPurge, }) {
+    const noCapacity = summary.free < 1;
+    const inviting = busyAction === 'invite';
+    const canInvite = !noCapacity && !inviting && Boolean(email.trim() && role && unlockSecret);
+    function submitInvitation(event) {
+        event.preventDefault();
+        if (canInvite)
+            void onInvite();
+    }
+    return (_jsxs("section", { className: "uhcp-workforce", "aria-labelledby": "uhcp-workforce-title", children: [_jsxs("header", { children: [_jsxs("div", { children: [_jsx("h1", { id: "uhcp-workforce-title", children: copy.title }), _jsx("p", { children: copy.description })] }), _jsxs("dl", { className: "uhcp-license-summary", children: [_jsxs("div", { children: [_jsx("dt", { children: copy.totalLicenses }), _jsx("dd", { children: summary.total })] }), _jsxs("div", { children: [_jsx("dt", { children: copy.usedLicenses }), _jsx("dd", { children: summary.used })] }), _jsxs("div", { children: [_jsx("dt", { children: copy.freeLicenses }), _jsx("dd", { children: summary.free })] })] })] }), _jsxs("section", { className: "uhcp-workforce-panel", "aria-labelledby": "uhcp-invite-title", children: [_jsx("h2", { id: "uhcp-invite-title", children: copy.inviteTitle }), noCapacity && _jsx("p", { role: "status", className: "uhcp-workforce-warning", children: copy.noFreeLicenses }), _jsxs("form", { onSubmit: submitInvitation, children: [_jsxs("label", { children: [_jsx("span", { children: copy.emailLabel }), _jsx("input", { type: "email", required: true, value: email, onChange: (event) => onEmailChange(event.currentTarget.value) })] }), _jsxs("label", { children: [_jsx("span", { children: copy.roleLabel }), _jsxs("select", { required: true, value: role, onChange: (event) => onRoleChange(event.currentTarget.value), children: [_jsx("option", { value: "" }), roles.map((option) => _jsx("option", { value: option.value, children: option.label }, option.value))] })] }), _jsxs("label", { children: [_jsx("span", { children: copy.unlockSecretLabel }), _jsx("input", { type: "password", required: true, value: unlockSecret, onChange: (event) => onUnlockSecretChange(event.currentTarget.value) })] }), _jsx("button", { type: "submit", disabled: !canInvite, children: inviting ? copy.inviting : copy.invite })] })] }), _jsxs("section", { className: "uhcp-workforce-panel", "aria-labelledby": "uhcp-employees-title", children: [_jsx("h2", { id: "uhcp-employees-title", children: copy.employeesTitle }), employees.length === 0 ? _jsx("p", { children: copy.noEmployees }) : (_jsx("div", { className: "uhcp-table-scroll", children: _jsxs("table", { children: [_jsx("thead", { children: _jsxs("tr", { children: [_jsx("th", { children: copy.licenseColumn }), _jsx("th", { children: copy.employeeColumn }), _jsx("th", { children: copy.roleColumn }), _jsx("th", { children: copy.statusColumn }), _jsx("th", { children: copy.devicesColumn }), _jsx("th", { children: copy.actionsColumn })] }) }), _jsx("tbody", { children: employees.map((employee) => {
+                                        const rowBusy = busyAction === employee.id;
+                                        return _jsxs("tr", { children: [_jsx("td", { children: _jsx("code", { children: employee.licenseId }) }), _jsx("td", { children: employee.email }), _jsx("td", { children: employee.role }), _jsx("td", { children: _jsx("span", { className: `uhcp-status uhcp-status-${employee.status}`, children: employee.status === 'active' ? copy.active : copy.inactive }) }), _jsx("td", { children: employee.deviceCount === undefined ? copy.devicesLater : employee.deviceCount }), _jsxs("td", { className: "uhcp-row-actions", children: [_jsx("button", { type: "button", disabled: rowBusy || employee.status !== 'active', onClick: () => void onDisable(employee.id), children: copy.disable }), _jsx("button", { type: "button", className: "uhcp-danger", disabled: rowBusy || employee.status !== 'inactive', onClick: () => void onPurge(employee.id), children: copy.purge })] })] }, employee.id);
+                                    }) })] }) }))] }), _jsxs("section", { className: "uhcp-workforce-panel", "aria-labelledby": "uhcp-invitations-title", children: [_jsx("h2", { id: "uhcp-invitations-title", children: copy.invitationsTitle }), invitations.length === 0 ? _jsx("p", { children: copy.noInvitations }) : _jsx("ul", { className: "uhcp-invitation-list", children: invitations.map((invitation) => _jsxs("li", { children: [_jsxs("span", { children: [_jsx("strong", { children: invitation.email }), _jsx("small", { children: invitation.role })] }), _jsx("span", { className: `uhcp-status uhcp-status-${invitation.status}`, children: copy[invitation.status] })] }, invitation.id)) })] }), error && _jsx("p", { role: "alert", className: "uhcp-error", children: error })] }));
+}

package/dist/index.d.ts

@@ -10,4 +10,5 @@ export * from './IpsBundleSummary.js';
 export * from './InvitationAcceptancePanel.js';
 export * from './SubjectAccessRequestPanel.js';
 export * from './SoschainWorkspace.js';
+export * from './OrganizationWorkforceAdministration.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,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,yBAAyB,CAAA;AACvC,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,uBAAuB,CAAA;AACrC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,wBAAwB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,yBAAyB,CAAA;AACvC,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,uBAAuB,CAAA;AACrC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,wBAAwB,CAAA;AACtC,cAAc,0CAA0C,CAAA"}

package/dist/index.js

@@ -10,3 +10,4 @@ export * from './IpsBundleSummary.js';
 export * from './InvitationAcceptancePanel.js';
 export * from './SubjectAccessRequestPanel.js';
 export * from './SoschainWorkspace.js';
+export * from './OrganizationWorkforceAdministration.js';

package/dist/styles.css

@@ -211,6 +211,36 @@ html[data-theme='dark'] .uhcp-brand-artwork-dark { display: block !important; }
 }
 .uhcp-access-panel button:disabled { cursor: not-allowed; opacity: .55; }
 .uhcp-access-panel [role="alert"] { color: #c64747; font-weight: 700; }
+.uhcp-workforce { color: var(--uhcp-text); display: grid; gap: 1.25rem; }
+.uhcp-workforce > header { align-items: end; display: flex; gap: 2rem; justify-content: space-between; }
+.uhcp-workforce h1, .uhcp-workforce h2, .uhcp-workforce p { margin: 0; }
+.uhcp-workforce > header p, .uhcp-workforce-panel > p { color: var(--uhcp-muted); margin-top: .45rem; }
+.uhcp-license-summary { display: grid; gap: .65rem; grid-template-columns: repeat(3, minmax(6rem, 1fr)); margin: 0; }
+.uhcp-license-summary div { background: var(--uhcp-panel); border: 1px solid var(--uhcp-border); border-radius: 1rem; padding: .8rem 1rem; }
+.uhcp-license-summary dt { color: var(--uhcp-muted); font-size: .72rem; font-weight: 800; text-transform: uppercase; }
+.uhcp-license-summary dd { font-size: 1.65rem; font-weight: 900; margin: .2rem 0 0; }
+.uhcp-workforce-panel { background: var(--uhcp-panel); border: 1px solid var(--uhcp-border); border-radius: 1.5rem; padding: 1.25rem; }
+.uhcp-workforce-panel form { align-items: end; display: grid; gap: .8rem; grid-template-columns: 2fr 1.3fr 1.2fr auto; margin-top: 1rem; }
+.uhcp-workforce-panel label { display: grid; font-weight: 700; gap: .35rem; }
+.uhcp-workforce-panel input, .uhcp-workforce-panel select { background: var(--uhcp-panel); border: 1px solid var(--uhcp-border); border-radius: .75rem; color: var(--uhcp-text); font: inherit; min-width: 0; padding: .75rem; }
+.uhcp-workforce button { background: linear-gradient(135deg, var(--uhcp-action-start), var(--uhcp-action-end)); border: 0; border-radius: .75rem; color: #fff; cursor: pointer; font: inherit; font-weight: 800; padding: .75rem 1rem; }
+.uhcp-workforce button:disabled { cursor: not-allowed; opacity: .45; }
+.uhcp-workforce button.uhcp-danger { background: #9e3535; }
+.uhcp-workforce-warning { color: var(--uhcp-attention) !important; font-weight: 800; }
+.uhcp-table-scroll { overflow-x: auto; }
+.uhcp-workforce table { border-collapse: collapse; margin-top: 1rem; width: 100%; }
+.uhcp-workforce th, .uhcp-workforce td { border-bottom: 1px solid var(--uhcp-border); padding: .75rem .5rem; text-align: left; }
+.uhcp-workforce th { color: var(--uhcp-muted); font-size: .75rem; text-transform: uppercase; }
+.uhcp-row-actions { display: flex; gap: .5rem; }
+.uhcp-status { border-radius: 999px; display: inline-flex; font-size: .75rem; font-weight: 800; padding: .3rem .6rem; }
+.uhcp-status-active, .uhcp-status-accepted { background: color-mix(in srgb, var(--uhcp-emerald) 18%, transparent); color: var(--uhcp-emerald); }
+.uhcp-status-inactive, .uhcp-status-cancelled { background: var(--uhcp-panel-muted); color: var(--uhcp-muted); }
+.uhcp-status-pending { background: color-mix(in srgb, var(--uhcp-attention) 18%, transparent); color: var(--uhcp-attention); }
+.uhcp-invitation-list { display: grid; gap: .6rem; list-style: none; margin: 1rem 0 0; padding: 0; }
+.uhcp-invitation-list li { align-items: center; border-bottom: 1px solid var(--uhcp-border); display: flex; justify-content: space-between; padding: .65rem 0; }
+.uhcp-invitation-list li > span:first-child { display: grid; gap: .2rem; }
+.uhcp-invitation-list small { color: var(--uhcp-muted); }
+@media (max-width: 820px) { .uhcp-workforce > header { align-items: stretch; flex-direction: column; } .uhcp-workforce-panel form { grid-template-columns: 1fr; } }
 .uhcp-entry-hero {
   align-items: center;
   background:

package/package.json

@@ -1,10 +1,14 @@
 {
   "name": "uhc-portal-components-react",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "Brand-neutral React portal shell, account preferences and protected-profile UI for UHC and VetChain portals.",
   "license": "Apache-2.0",
   "type": "module",
-  "files": ["dist", "README.md", "CHANGELOG.md"],
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -30,8 +34,11 @@
     "gdc-common-utils-ts": "^2.3.12"
   },
   "devDependencies": {
+    "@testing-library/react": "^16.3.2",
+    "@testing-library/user-event": "^14.6.1",
     "@types/react": "19.2.17",
     "@types/react-dom": "19.2.3",
+    "jsdom": "^26.1.0",
     "react": "19.2.8",
     "react-dom": "19.2.8",
     "typescript": "^5.5.4",