uhc-portal-components-react 0.1.3 → 0.1.5

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.1.5 - 2026-07-29
+
+- Allow advanced hosts to reuse the shared clinical card body while retaining
+  their own expandable section heading, filters and editors.
+
+## 0.1.4 - 2026-07-29
+
+- Add `IpsBundleSummary`, which accepts a complete IPS document Bundle and
+  renders every Composition section and its Common Utils card projections.
+- Test the official 16-section IPS fixture, every declared IPS resource type
+  and locale/terminology propagation.
+- State explicitly that browser components render in-memory data and never call
+  backend ingestion operations.
+
 ## 0.1.3
 
 - Add the brand-neutral `ClinicalSectionSummary` renderer for resolved IPS

package/README.md

@@ -48,7 +48,11 @@ The package deliberately exposes modules instead of a cloned application:
 - `PortalAccessChooser`: real-page navigation for professional access paths.
 - `ProfileProtectionGate`: fail-closed PIN unlock presentation.
 - `ClinicalSectionSummary`: brand-neutral rendering of already-resolved IPS
-  cards for personal and professional portals.
+  cards for personal and professional portals. Advanced viewers can set
+  `showHeader={false}` when they retain their own expandable heading.
+- `IpsBundleSummary`: receives one in-memory IPS document Bundle, obtains all
+  `Composition.section` entries through Common Utils and renders every
+  section's cards. It performs no ingestion or GW call.
 
 Clinical label semantics stay in `gdc-common-utils-ts` / the SDK reader. Hosts
 pass human titles to `ClinicalSectionSummary`: local `CodeableConcept.text`
@@ -56,6 +60,19 @@ when the UI matches the resource language, English `Coding.display` for
 English, or a terminology translation keyed by `system|code` for another
 locale. The terminology token is never a visible or editable title.
 
+```tsx
+<IpsBundleSummary
+  bundle={bundleInMemory}
+  locale={currentLocale}
+  translateCode={terminology.translate}
+  emptyLabel={t('emptySection')}
+/>
+```
+
+The browser may render an optimistic in-memory Bundle while its authenticated
+BFF persists the command. Only backend code calls
+`ingestCommunicationAndUpdateIndex(...)`; the component never does.
+
 UHC Personal and VetChain Personal must compose the same personal route
 modules. UHC Professional and VetChain Professional must compose the same
 professional route modules. A brand adapter may change only tokens, logo,

package/dist/ClinicalSectionSummary.d.ts

@@ -12,6 +12,8 @@ export type ClinicalSectionSummaryProps = Readonly<{
     emptyLabel: string;
     resourceTypeLabel?: (resourceType: string) => string;
     actions?: ReactNode;
+    /** Hide only the heading when a host already owns the expandable section header. */
+    showHeader?: boolean;
 }>;
 /**
  * Brand-neutral renderer for one already-resolved IPS section.
@@ -21,5 +23,5 @@ export type ClinicalSectionSummaryProps = Readonly<{
  * terminology identity/translation key and must never be supplied as a
  * replacement for manually authored text.
  */
-export declare function ClinicalSectionSummary({ code, title, resources, emptyLabel, resourceTypeLabel, actions, }: ClinicalSectionSummaryProps): import("react").JSX.Element;
+export declare function ClinicalSectionSummary({ code, title, resources, emptyLabel, resourceTypeLabel, actions, showHeader, }: ClinicalSectionSummaryProps): import("react").JSX.Element;
 //# sourceMappingURL=ClinicalSectionSummary.d.ts.map

package/dist/ClinicalSectionSummary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClinicalSectionSummary.d.ts","sourceRoot":"","sources":["../src/ClinicalSectionSummary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAC,CAAA;AAEF,MAAM,MAAM,2BAA2B,GAAG,QAAQ,CAAC;IACjD,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAA;IACzC,UAAU,EAAE,MAAM,CAAA;IAClB,iBAAiB,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,CAAA;IACpD,OAAO,CAAC,EAAE,SAAS,CAAA;CACpB,CAAC,CAAA;AAEF;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,IAAI,EACJ,KAAK,EACL,SAAS,EACT,UAAU,EACV,iBAAkD,EAClD,OAAO,GACR,EAAE,2BAA2B,+BAsB7B"}
+{"version":3,"file":"ClinicalSectionSummary.d.ts","sourceRoot":"","sources":["../src/ClinicalSectionSummary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAC,CAAA;AAEF,MAAM,MAAM,2BAA2B,GAAG,QAAQ,CAAC;IACjD,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAA;IACzC,UAAU,EAAE,MAAM,CAAA;IAClB,iBAAiB,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,CAAA;IACpD,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,oFAAoF;IACpF,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,CAAC,CAAA;AAEF;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,IAAI,EACJ,KAAK,EACL,SAAS,EACT,UAAU,EACV,iBAAkD,EAClD,OAAO,EACP,UAAiB,GAClB,EAAE,2BAA2B,+BA4B7B"}

package/dist/ClinicalSectionSummary.js

@@ -7,8 +7,8 @@ import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
  * terminology identity/translation key and must never be supplied as a
  * replacement for manually authored text.
  */
-export function ClinicalSectionSummary({ code, title, resources, emptyLabel, resourceTypeLabel = (resourceType) => resourceType, actions, }) {
-    return (_jsxs("section", { className: "uhcp-clinical-section", "data-ips-section": code, "aria-labelledby": `uhcp-section-${code}`, children: [_jsxs("header", { children: [_jsxs("h3", { id: `uhcp-section-${code}`, children: [title, " ", _jsxs("span", { children: ["(", resources.length, ")"] })] }), actions] }), resources.length === 0
+export function ClinicalSectionSummary({ code, title, resources, emptyLabel, resourceTypeLabel = (resourceType) => resourceType, actions, showHeader = true, }) {
+    return (_jsxs("section", { className: "uhcp-clinical-section", "data-ips-section": code, ...(showHeader ? { 'aria-labelledby': `uhcp-section-${code}` } : { 'aria-label': title }), children: [showHeader && (_jsxs("header", { children: [_jsxs("h3", { id: `uhcp-section-${code}`, children: [title, " ", _jsxs("span", { children: ["(", resources.length, ")"] })] }), actions] })), resources.length === 0
                 ? _jsx("p", { className: "uhcp-clinical-empty", children: emptyLabel })
                 : (_jsx("div", { className: "uhcp-clinical-grid", children: resources.map((resource) => (_jsxs("article", { className: "uhcp-clinical-card", "data-resource-type": resource.resourceType, children: [_jsx("p", { className: "uhcp-clinical-title", dir: "auto", children: _jsx("bdi", { children: resource.title }) }), _jsx("p", { className: "uhcp-clinical-type", children: resourceTypeLabel(resource.resourceType) }), resource.date && _jsx("p", { className: "uhcp-clinical-date", children: resource.date })] }, resource.key))) }))] }));
 }

package/dist/IpsBundleSummary.d.ts

@@ -0,0 +1,23 @@
+import type { ReactNode } from 'react';
+import { type ClinicalResourceBundleLike, type ClinicalSectionView, type ClinicalTerminologyTranslationInput } from 'gdc-common-utils-ts/utils/clinical-resource-view';
+export type IpsBundleSummaryProps = Readonly<{
+    bundle: ClinicalResourceBundleLike;
+    locale?: string;
+    translateCode?: (input: ClinicalTerminologyTranslationInput) => string | undefined;
+    emptyLabel: string;
+    noSectionsLabel?: string;
+    sectionTitle?: (section: ClinicalSectionView) => string;
+    resourceTypeLabel?: (resourceType: string) => string;
+    sectionActions?: (section: ClinicalSectionView) => ReactNode;
+}>;
+/**
+ * Renders every section declared by an IPS Composition and the cards referenced
+ * by each section.
+ *
+ * The shared clinical reader owns Bundle traversal, section placement and card
+ * projection. `Composition.section.entry` is authoritative for placement;
+ * native FHIR fields or canonical `resource.meta.claims` provide card content.
+ * This component performs no ingestion, persistence or GW call.
+ */
+export declare function IpsBundleSummary({ bundle, locale, translateCode, emptyLabel, noSectionsLabel, sectionTitle, resourceTypeLabel, sectionActions, }: IpsBundleSummaryProps): import("react").JSX.Element;
+//# sourceMappingURL=IpsBundleSummary.d.ts.map

package/dist/IpsBundleSummary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IpsBundleSummary.d.ts","sourceRoot":"","sources":["../src/IpsBundleSummary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,EAEL,KAAK,0BAA0B,EAC/B,KAAK,mBAAmB,EACxB,KAAK,mCAAmC,EACzC,MAAM,kDAAkD,CAAA;AAGzD,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC3C,MAAM,EAAE,0BAA0B,CAAA;IAClC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,mCAAmC,KAAK,MAAM,GAAG,SAAS,CAAA;IAClF,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,MAAM,CAAA;IACvD,iBAAiB,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,CAAA;IACpD,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,SAAS,CAAA;CAC7D,CAAC,CAAA;AAEF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,MAAM,EACN,aAAa,EACb,UAAU,EACV,eAA4B,EAC5B,YAAyC,EACzC,iBAAiB,EACjB,cAAc,GACf,EAAE,qBAAqB,+BA2BvB"}

package/dist/IpsBundleSummary.js

@@ -0,0 +1,24 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { toClinicalSectionViews, } from 'gdc-common-utils-ts/utils/clinical-resource-view';
+import { ClinicalSectionSummary } from './ClinicalSectionSummary.js';
+/**
+ * Renders every section declared by an IPS Composition and the cards referenced
+ * by each section.
+ *
+ * The shared clinical reader owns Bundle traversal, section placement and card
+ * projection. `Composition.section.entry` is authoritative for placement;
+ * native FHIR fields or canonical `resource.meta.claims` provide card content.
+ * This component performs no ingestion, persistence or GW call.
+ */
+export function IpsBundleSummary({ bundle, locale, translateCode, emptyLabel, noSectionsLabel = emptyLabel, sectionTitle = (section) => section.title, resourceTypeLabel, sectionActions, }) {
+    const sections = toClinicalSectionViews(bundle, { locale, translateCode });
+    if (sections.length === 0) {
+        return _jsx("p", { className: "uhcp-clinical-empty", "data-ips-summary-empty": true, children: noSectionsLabel });
+    }
+    return (_jsx("div", { className: "uhcp-clinical-summary", "data-ips-summary": true, children: sections.map((section, sectionIndex) => (_jsx(ClinicalSectionSummary, { code: section.code ?? '', title: sectionTitle(section), resources: section.resources.map((resource, resourceIndex) => ({
+                key: resource.fullUrl ?? `${resource.resourceType}:${resourceIndex}:${resource.title}`,
+                title: resource.title,
+                resourceType: resource.resourceType,
+                date: resource.date,
+            })), emptyLabel: emptyLabel, resourceTypeLabel: resourceTypeLabel, actions: sectionActions?.(section) }, section.code ?? `${section.title}:${sectionIndex}`))) }));
+}

package/dist/index.d.ts

@@ -6,4 +6,5 @@ export * from './PortalShell.js';
 export * from './PortalEntry.js';
 export * from './ProfileProtectionGate.js';
 export * from './ClinicalSectionSummary.js';
+export * from './IpsBundleSummary.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"}
+{"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"}

package/dist/index.js

@@ -6,3 +6,4 @@ export * from './PortalShell.js';
 export * from './PortalEntry.js';
 export * from './ProfileProtectionGate.js';
 export * from './ClinicalSectionSummary.js';
+export * from './IpsBundleSummary.js';

package/dist/styles.css

@@ -171,6 +171,11 @@ html[data-theme='dark'] .uhcp-brand-artwork-dark { display: block !important; }
   color: var(--uhcp-text);
   padding: 1.25rem;
 }
+
+.uhcp-clinical-summary {
+  display: grid;
+  gap: 1rem;
+}
 .uhcp-clinical-section > header { align-items: center; display: flex; gap: 1rem; justify-content: space-between; }
 .uhcp-clinical-section h3 { font-size: 1.125rem; margin: 0; }
 .uhcp-clinical-section h3 span { color: var(--uhcp-muted); }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uhc-portal-components-react",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Brand-neutral React portal shell, account preferences and protected-profile UI for UHC and VetChain portals.",
   "license": "Apache-2.0",
   "type": "module",
@@ -26,6 +26,9 @@
     "react": ">=18.3.0",
     "react-dom": ">=18.3.0"
   },
+  "dependencies": {
+    "gdc-common-utils-ts": "^2.3.10"
+  },
   "devDependencies": {
     "@types/react": "19.2.17",
     "@types/react-dom": "19.2.3",