@easygov/react-components 0.10.0 → 0.11.0

package/README.md

@@ -76,8 +76,8 @@ that runs it.
 
 ### Reading the header context
 
-The header resolves the signed-in user, the selected customer account, the running process and
-its ancestor chain (if the URL addresses a sub-process) from core-backend and publishes them to
+The header resolves the signed-in user, the selected customer account, and the running process
+or the parent process a sub-process is being created under, from core-backend and publishes them to
 consumers:
 
 ```tsx
@@ -86,7 +86,7 @@ import { useEasygovHeaderContext } from '@easygov/react-components';
 function ContactForm() {
   const { claims } = useEasygovHeaderContext();
   const account = claims?.customerAccount;
-  const parentProcess = claims?.parentProcesses?.[0];
+  const parentProcess = claims?.parentProcess;
 
   return (
     <form>
@@ -99,14 +99,13 @@ function ContactForm() {
 }
 ```
 
-`claims.parentProcesses` lists the ancestors of the addressed Behördengang, nearest first — index
-0 is the direct parent, ascending toward the root — and is absent (not `[]`) when there is none.
-If it is present while `claims.process` is absent, a sub-process is about to be created under
-`parentProcesses[0]`, which is then the addressed Process itself and not a selected Behördengang.
-Each `SelectedProcess` (in `claims.process` and `claims.parentProcesses`) also carries its own
-`parentProcessId` — the global identifier of its parent, absent for a top-level Behördengang —
-so a consumer can identify ancestry per node after flattening `parentProcesses` into a map,
-without relying solely on the array's ordering.
+`claims.process` and `claims.parentProcess` are mutually exclusive. `process` is the Behördengang
+the URL selects (`/process/{id}`). `parentProcess` is the Behördengang a sub-process is about to be
+created under (`/parentprocess/{id}`) — not a selected Behördengang. Neither is present when the
+URL addresses no process. Each `SelectedProcess` carries its own `parentProcessId`, the global
+identifier of its parent, absent for a top-level Behördengang. That reference is the only
+representation of a selected process's parent: the context carries no ancestor chain, because it
+is forwarded as an HTTP header where 4/8 KB size limits apply.
 
 `claims` is `null` until the first response lands and again after logout — render a fallback,
 don't assume it is present on first paint. The hook reflects the last context an `EasygovHeader`

package/dist/easygov.d.mts

@@ -390,9 +390,9 @@ interface SelectedProcess {
         individualServicePermissionModel: boolean;
     };
     /**
-     * Global identifier of this process's own parent. Absent for a top-level Behördengang.
-     * Lets a client identify ancestry per node — e.g. after flattening `parentProcesses` into a
-     * map — without relying solely on that array's documented ordering.
+     * Global identifier of this process's own parent. Absent for a top-level Behördengang. This
+     * reference is the only representation of a selected process's parent: the context carries no
+     * ancestor chain.
      */
     parentProcessId?: string;
 }
@@ -419,16 +419,16 @@ interface UserProfile {
 interface HeaderContextClaims {
     currentUser: UserProfile;
     customerAccount?: SelectedCustomerAccount;
+    /**
+     * The Behördengang the URL selects (`/process/{id}`). Mutually exclusive with `parentProcess`.
+     */
     process?: SelectedProcess;
     /**
-     * Ancestors of the addressed Behördengang, nearest first: index 0 is the direct parent,
-     * ascending toward the root. Absent — not an empty array — when there is none.
-     *
-     * Present while `process` is absent means a sub-process is about to be created under
-     * `parentProcesses[0]`, which is then the addressed Process itself and NOT a selected
-     * Behördengang. That is the `/parentprocess/{id}` URL form.
+     * The Behördengang a sub-process is about to be created under (`/parentprocess/{id}`).
+     * Mutually exclusive with `process`, and NOT a selected Behördengang. A selected process's own
+     * parent is never included as an object — only as `process.parentProcessId`.
      */
-    parentProcesses?: SelectedProcess[];
+    parentProcess?: SelectedProcess;
 }
 
 interface EasygovHeaderContext {