@wildo-ai/saas-frontend-lib 1.1.3 → 1.1.5

package/dist/esm/components/compliance/GovernedDocumentAcceptanceControl.d.ts

@@ -0,0 +1,74 @@
+/**
+ * The governed-document ACCEPTANCE CONTROL — one control for every surface that asks a person to agree
+ * to the documents an application requires (#1258).
+ *
+ * ## Why it is shared, and was lifted out of registration
+ *
+ * It began inside `Auth_Register`, where it was right while sign-up was the only surface that asked.
+ * Re-acceptance is a second one: a release that changes the terms materially must be accepted again,
+ * by a person who is already signed in (`AppLayout_DocumentAcceptanceGate`). Two copies of this control
+ * would be two copies of every rule it now carries — the three acceptance modes, the reading gate and
+ * its evidence lifetime (#1387), the parameterised document links (#1386), the accessibility of a
+ * withheld box (#1381), the draft and not-yet-established marks — and they would drift the first time
+ * one was fixed. So the control owns the rules and the host owns the STATE, which it passes in.
+ *
+ * ## The labels are the acceptance words, whatever namespace they live in
+ *
+ * They are the `PUBLIC_LAYOUTS_USER_REGISTER` `TERMS_*` keys, because that is where they were authored
+ * and every application's label packs already carry them. A host passes the resolvers; nothing here
+ * opens a second i18n subscription. Moving the keys would owe a label regeneration in every
+ * application for no change a reader could see.
+ */
+import React from 'react';
+import { FrontendComponentType } from '@wildo-ai/presets-components-models';
+import { GovernedDocumentAcceptanceMode, type GovernedDocumentInteractionSurface, type GovernedDocumentPublicDocument } from '@wildo-ai/saas-models';
+/**
+ * A pane's identity in the read set.
+ *
+ * The INDEX is part of it deliberately: two required documents can carry the same title — a locale
+ * variant, or an operator who named both "Terms" — and keying on the title alone would let scrolling
+ * one of them mark both as read, satisfying a gate over text nobody saw.
+ */
+export declare const documentReadKey: (document: GovernedDocumentPublicDocument, index: number) => string;
+/** One required release and the public document it publishes, if the application serves one. */
+export interface RequiredDocumentPresentation {
+    readonly release: GovernedDocumentInteractionSurface;
+    readonly document: GovernedDocumentPublicDocument | undefined;
+}
+/**
+ * What the control reads, owned by the host screen.
+ *
+ * Held ABOVE the control so a remount cannot reset the act without its evidence, or the reverse —
+ * the #1387 lesson: the box rendered pre-ticked after a sign-up method switch because the two had
+ * different lifetimes.
+ */
+export interface GovernedDocumentAcceptanceState {
+    /** The in-force releases this person must accept here. Empty renders nothing. */
+    readonly requiredReleases: readonly GovernedDocumentInteractionSurface[];
+    /** How this application asks. */
+    readonly acceptanceMode: GovernedDocumentAcceptanceMode;
+    /** Each required release paired with the public document it publishes, or `undefined` when none is served. */
+    readonly requiredDocuments: readonly RequiredDocumentPresentation[];
+    /** Every public document the application SERVES — linked, never paned, gated or ticked. */
+    readonly servedDocuments: readonly GovernedDocumentPublicDocument[];
+    readonly accepted: boolean;
+    readonly setAccepted: (accepted: boolean) => void;
+    /** Which panes the reader has reached the end of — the EVIDENCE the reading gate is derived from. */
+    readonly documentsRead: readonly string[];
+    readonly markDocumentRead: (paneKey: string) => void;
+}
+/**
+ * How this application asks the registrant to accept its governed documents — the three declared
+ * shapes of {@link GovernedDocumentAcceptanceMode} (#1258).
+ *
+ * Renders nothing at all when the application requires no acceptance, which is what an application
+ * with no governed documents has always seen.
+ */
+export declare const GovernedDocumentAcceptanceControl: React.FC<{
+    /** The acceptance state, owned by the screen that hosts the control — registration, or the re-acceptance gate. */
+    readonly state: GovernedDocumentAcceptanceState;
+    readonly t: (key: string) => string;
+    /** The parameterised resolver, for the one label that takes a value (the document link). */
+    readonly tComponent: (component: FrontendComponentType, key: string, params?: Record<string, string | number>) => string;
+}>;
+//# sourceMappingURL=GovernedDocumentAcceptanceControl.d.ts.map

package/dist/esm/components/compliance/GovernedDocumentAcceptanceControl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GovernedDocumentAcceptanceControl.d.ts","sourceRoot":"","sources":["../../../../../src/components/compliance/GovernedDocumentAcceptanceControl.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAgD,MAAM,OAAO,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAqB,MAAM,qCAAqC,CAAC;AAC/F,OAAO,EACL,8BAA8B,EAM9B,KAAK,kCAAkC,EACvC,KAAK,8BAA8B,EACpC,MAAM,uBAAuB,CAAC;AAM/B;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,8BAA8B,EAAE,OAAO,MAAM,KAAG,MAC5C,CAAC;AAE/C,gGAAgG;AAChG,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,OAAO,EAAE,kCAAkC,CAAC;IACrD,QAAQ,CAAC,QAAQ,EAAE,8BAA8B,GAAG,SAAS,CAAC;CAC/D;AAED;;;;;;GAMG;AACH,MAAM,WAAW,+BAA+B;IAC9C,iFAAiF;IACjF,QAAQ,CAAC,gBAAgB,EAAE,SAAS,kCAAkC,EAAE,CAAC;IACzE,iCAAiC;IACjC,QAAQ,CAAC,cAAc,EAAE,8BAA8B,CAAC;IACxD,8GAA8G;IAC9G,QAAQ,CAAC,iBAAiB,EAAE,SAAS,4BAA4B,EAAE,CAAC;IACpE,2FAA2F;IAC3F,QAAQ,CAAC,eAAe,EAAE,SAAS,8BAA8B,EAAE,CAAC;IACpE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IAClD,qGAAqG;IACrG,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACtD;AAmHD;;;;;;GAMG;AACH,eAAO,MAAM,iCAAiC,EAAE,KAAK,CAAC,EAAE,CAAC;IACvD,kHAAkH;IAClH,QAAQ,CAAC,KAAK,EAAE,+BAA+B,CAAC;IAChD,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,4FAA4F;IAC5F,QAAQ,CAAC,UAAU,EAAE,CAAC,SAAS,EAAE,qBAAqB,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,MAAM,CAAC;CAC1H,CAiMA,CAAC"}

package/dist/esm/components/compliance/GovernedDocumentAcceptanceControl.js

@@ -0,0 +1,197 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * The governed-document ACCEPTANCE CONTROL — one control for every surface that asks a person to agree
+ * to the documents an application requires (#1258).
+ *
+ * ## Why it is shared, and was lifted out of registration
+ *
+ * It began inside `Auth_Register`, where it was right while sign-up was the only surface that asked.
+ * Re-acceptance is a second one: a release that changes the terms materially must be accepted again,
+ * by a person who is already signed in (`AppLayout_DocumentAcceptanceGate`). Two copies of this control
+ * would be two copies of every rule it now carries — the three acceptance modes, the reading gate and
+ * its evidence lifetime (#1387), the parameterised document links (#1386), the accessibility of a
+ * withheld box (#1381), the draft and not-yet-established marks — and they would drift the first time
+ * one was fixed. So the control owns the rules and the host owns the STATE, which it passes in.
+ *
+ * ## The labels are the acceptance words, whatever namespace they live in
+ *
+ * They are the `PUBLIC_LAYOUTS_USER_REGISTER` `TERMS_*` keys, because that is where they were authored
+ * and every application's label packs already carry them. A host passes the resolvers; nothing here
+ * opens a second i18n subscription. Moving the keys would owe a label regeneration in every
+ * application for no change a reader could see.
+ */
+import { useCallback, useEffect, useId, useRef } from 'react';
+import { FrontendComponentType, UserRegisterLabel } from '@wildo-ai/presets-components-models';
+import { GovernedDocumentPublicClauseStanding, GovernedDocumentPublicDocumentKind, governedDocumentAcceptanceRequiresExplicitAct, governedDocumentAcceptanceRequiresReading, resolvePublicGovernedDocumentRoutePath, } from '@wildo-ai/saas-models';
+import { CheckboxRoot } from '../../components/form/controls/boolean/checkbox.js';
+import { Link } from '../../components/typography/link.js';
+import { Text } from '../../components/typography/text.js';
+import { cn } from '../../core/ui/cn.js';
+/**
+ * A pane's identity in the read set.
+ *
+ * The INDEX is part of it deliberately: two required documents can carry the same title — a locale
+ * variant, or an operator who named both "Terms" — and keying on the title alone would let scrolling
+ * one of them mark both as read, satisfying a gate over text nobody saw.
+ */
+export const documentReadKey = (document, index) => `${String(index)}:${document.content.title}`;
+/**
+ * One document, in a box the reader must scroll to the end of — the `EXPLICIT_AFTER_READING` pane.
+ *
+ * ## What "reached the end" means, and the case that breaks every naive version
+ *
+ * A pane whose content is SHORTER than its box never scrolls, so a listener alone leaves the reader
+ * permanently unable to accept a document they can see in its entirety. An effect settles that on
+ * mount by measuring: no overflow means there was nothing to scroll past, which is reaching the end.
+ * The same measurement re-runs when the content changes.
+ *
+ * A plain `useEffect`, not `useLayoutEffect`. It only ENABLES a control, so running it after paint
+ * costs a frame nobody can act within; `useLayoutEffect` would buy that frame at the price of
+ * blocking paint on a measurement, which is the wrong trade for a form.
+ *
+ * The 2px tolerance is not slop — sub-pixel layout means `scrollTop + clientHeight` lands
+ * fractionally short of `scrollHeight` on real devices, and an exact comparison makes the last line
+ * unreachable.
+ *
+ * ## Why the text is not rendered as markdown here
+ *
+ * `saas-frontend-lib` imports nothing from `presets-components`, which is where the theme-mapped
+ * markdown renderer lives — and that renderer lazily loads a ~210 kB pipeline, which has no business
+ * on a registration form. The clause is already the document's structural unit, so sections and
+ * clauses carry the structure and each clause's body is shown as authored. The full typeset document
+ * is one link away, on the page that exists to render it.
+ */
+const GovernedDocumentReadingPane = ({ document, t, paneKey, onReachedEnd }) => {
+    const boxRef = useRef(null);
+    /*
+     * The callback takes the pane's key rather than closing over it, so the parent can pass ONE stable
+     * function instead of a fresh arrow per render. With an inline arrow this effect re-ran on every
+     * render of the form — harmless, because the read set bails out on an unchanged reference, but
+     * harmless-by-luck is not a property to rely on in a gate.
+     */
+    const settleIfEndReached = useCallback(() => {
+        const box = boxRef.current;
+        if (!box)
+            return;
+        if (box.scrollTop + box.clientHeight >= box.scrollHeight - 2)
+            onReachedEnd(paneKey);
+    }, [onReachedEnd, paneKey]);
+    useEffect(settleIfEndReached, [settleIfEndReached, document]);
+    return (_jsxs("div", { ref: boxRef, onScroll: settleIfEndReached, tabIndex: 0, 
+        /*
+         * `lang` is the DOCUMENT's locale, not the reader's — the same reason the public page sets it.
+         * `tabIndex` because a scrollable region that cannot be focused cannot be scrolled from the
+         * keyboard, which would make the gate unpassable without a mouse.
+         */
+        lang: document.content.locale, role: "region", "aria-label": document.content.title, className: "focus-ring-offset max-h-64 overflow-y-auto rounded-md border border-border bg-muted/30 p-element text-sm", children: [_jsx("h2", { className: "font-medium", children: document.content.title }), document.kind === GovernedDocumentPublicDocumentKind.UNRELEASED_DRAFT && (_jsx(Text, { role: "note", className: "mt-element-sm text-xs font-medium", children: t(UserRegisterLabel.TERMS_DRAFT_NOTICE) })), document.content.sections.map((section) => (_jsxs("div", { className: "mt-element flex flex-col gap-element-sm", children: [_jsx("h3", { className: "font-medium", children: section.title }), section.clauses.map((clause) => (_jsxs("div", { className: "flex flex-col gap-element-sm", children: [_jsx(Text, { className: "whitespace-pre-line text-muted-foreground", children: clause.bodyMarkdown }), clause.standing === GovernedDocumentPublicClauseStanding.NOT_YET_ESTABLISHED && (_jsx(Text, { role: "note", className: "text-xs", children: `${t(UserRegisterLabel.TERMS_CLAUSE_NOT_ESTABLISHED)} ${clause.missingInformation ?? ''}`.trim() }))] }, clause.clauseRef)))] }, section.sectionRef)))] }));
+};
+/**
+ * How this application asks the registrant to accept its governed documents — the three declared
+ * shapes of {@link GovernedDocumentAcceptanceMode} (#1258).
+ *
+ * Renders nothing at all when the application requires no acceptance, which is what an application
+ * with no governed documents has always seen.
+ */
+export const GovernedDocumentAcceptanceControl = ({ state, t, tComponent }) => {
+    const { requiredReleases, acceptanceMode, requiredDocuments, servedDocuments, accepted, setAccepted, documentsRead, markDocumentRead } = state;
+    const documentsToRead = requiredDocuments
+        .map((entry) => entry.document)
+        .filter((document) => document !== undefined);
+    /*
+     * Each document that HAS a public page, linked and NAMED. One served elsewhere contributes no link.
+     * The name comes from the document when the application publishes one, and falls back to the page's
+     * own PATH when it does not — never to a bare "read in full", which would give N documents one
+     * indistinguishable link, and never to the document REF, which is an identifier a reader has no use
+     * for (`document:public.service-terms — Read in full`).
+     *
+     * ## The set linked is wider than the set ACCEPTED
+     *
+     * `requiredDocuments` holds only releases permitting `CONTRACT_ACCEPTED`, which is right: a privacy
+     * notice permits delivery and acknowledgement and is not a contract, so it must never be paned,
+     * gated or ticked. But the acceptance sentence beside these links names it — "I agree to the terms
+     * of service and privacy policy" is what applications write — and a screen that says a person is
+     * agreeing to a notice while showing them no way to reach it tells them something and then withholds
+     * it. So every public governed document the application SERVES is linked, whether or not it is being
+     * accepted. Linking is not accepting, and a person is entitled to be told where the notice is at the
+     * moment they are told they agree to it.
+     */
+    const documentLinks = requiredDocuments
+        .map((entry) => ({
+        release: entry.release,
+        path: resolvePublicGovernedDocumentRoutePath(entry.release.identity.document.documentRef),
+        title: entry.document?.content.title ?? resolvePublicGovernedDocumentRoutePath(entry.release.identity.document.documentRef) ?? '',
+        /* The DOCUMENT's language, not the reader's — what `lang` on the link announces. */
+        locale: entry.document?.content.locale ?? entry.release.locale,
+    }))
+        .filter((entry) => entry.path !== undefined);
+    /*
+     * …and the public documents the application serves that are NOT being accepted — the privacy notice
+     * being the case every application has. Keyed by path so a document already linked above (a served
+     * document that IS accepted) is not listed twice.
+     */
+    const linkedPaths = new Set(documentLinks.map((entry) => entry.path));
+    const additionalDocumentLinks = servedDocuments
+        .map((document) => ({
+        document,
+        path: resolvePublicGovernedDocumentRoutePath(document.kind === GovernedDocumentPublicDocumentKind.RELEASED ? document.release.identity.document.documentRef : document.documentRef),
+    }))
+        .filter((entry) => entry.path !== undefined && !linkedPaths.has(entry.path));
+    /*
+     * DERIVED from the evidence against the documents CURRENTLY offered — every one of them, not merely
+     * the last. Scrolling one box to its end says nothing about the box beneath it, and the gate's whole
+     * claim is that all of the text was presented.
+     *
+     * Derived rather than latched, which is what stops a satisfied gate outliving what satisfied it: a
+     * document set that grew would otherwise leave the box open over text nobody saw. Whether the gate
+     * APPLIES is `readingGated` below; this only says when one that applies is met.
+     */
+    const readingComplete = documentsToRead.length > 0
+        && documentsToRead.every((document, index) => documentsRead.includes(documentReadKey(document, index)));
+    if (requiredReleases.length === 0)
+        return null;
+    const links = documentLinks.length > 0 && (_jsxs("span", { className: "flex flex-wrap gap-element-sm", children: [additionalDocumentLinks.map(({ document, path }) => (_jsx(Link, { href: path, external: true, target: "_blank", rel: "noreferrer", className: "text-sm", lang: document.content.locale, children: tComponent(FrontendComponentType.PUBLIC_LAYOUTS_USER_REGISTER, UserRegisterLabel.TERMS_OPEN_DOCUMENT, { documentTitle: document.content.title }) }, path))), documentLinks.map(({ release, path, title, locale }) => (_jsx(Link, { href: path, external: true, target: "_blank", rel: "noreferrer", className: "text-sm", lang: locale, children: tComponent(FrontendComponentType.PUBLIC_LAYOUTS_USER_REGISTER, UserRegisterLabel.TERMS_OPEN_DOCUMENT, { documentTitle: title }) }, release.identity.releaseId)))] }));
+    /*
+     * SIGN-IN-WRAP. No control and nothing withheld: submitting IS the act, so the notice states what
+     * the submission will mean. It is rendered immediately above the button rather than in a footer,
+     * because conspicuousness is the whole of what separates this from the shape that does not hold.
+     */
+    if (!governedDocumentAcceptanceRequiresExplicitAct(acceptanceMode)) {
+        return (_jsxs("div", { className: "flex flex-col gap-element-sm", children: [_jsx(Text, { role: "note", className: "text-sm text-muted-foreground", children: t(UserRegisterLabel.TERMS_ACCEPTANCE_IMPLIED) }), links] }));
+    }
+    /*
+     * The reading gate applies only when EVERY required release has text to present. The mode alone is
+     * not enough, and neither is SOME of the text.
+     *
+     * ## Why not the mode alone
+     *
+     * An application can declare `EXPLICIT_AFTER_READING` and serve no public document for a release it
+     * requires — the two are separate declarations, and `wildo config document-releases` writes the
+     * second only for documents the application publishes. Gated on the mode alone there would then be
+     * nothing to scroll, nothing could ever mark the reading complete, the box would stay disabled and
+     * NOBODY COULD REGISTER. That is the shape `application-creation-directive.md` tests for: if this
+     * refuses, what does the operator do next? "Publish the document" is not something the person in
+     * front of the form can do.
+     *
+     * ## Why not a PARTIAL set either
+     *
+     * Two required releases with one document served would put one pane on screen, and scrolling it
+     * would satisfy a gate whose whole claim is that the text was presented IN FULL. That claim would
+     * be false about the document nobody saw — and a false claim is worse than a weaker one, because
+     * the record says the person was shown something they were not.
+     *
+     * ## What happens instead
+     *
+     * The mode degrades to `EXPLICIT_CHECKBOX`. The affirmative act survives and only the presentation
+     * CLAIM is dropped, which is the honest direction: with text missing, "they were shown the text" is
+     * not a claim this form may make. It is the mode's own JSDoc — the gate asserts presentation, never
+     * reading — one step further along. An application that wants the gate publishes its documents.
+     */
+    const everyRequiredDocumentIsServed = requiredDocuments.every((entry) => entry.document !== undefined) && requiredDocuments.length > 0;
+    const readingGated = governedDocumentAcceptanceRequiresReading(acceptanceMode) && everyRequiredDocumentIsServed;
+    /** The act is owed and not yet made — the one predicate the label, the control and its state share. */
+    const withheld = readingGated && !readingComplete;
+    const readingPromptId = useId();
+    return (_jsxs("div", { className: "flex flex-col gap-element", children: [readingGated && (_jsxs(_Fragment, { children: [_jsx(Text, { id: readingPromptId, className: "text-sm text-muted-foreground", children: t(UserRegisterLabel.TERMS_READ_PROMPT) }), documentsToRead.map((document, index) => (_jsx(GovernedDocumentReadingPane, { document: document, t: t, paneKey: documentReadKey(document, index), onReachedEnd: markDocumentRead }, documentReadKey(document, index))))] })), _jsxs("label", { className: cn('flex items-start gap-element', withheld ? 'cursor-not-allowed opacity-60' : 'cursor-pointer'), children: [_jsx(CheckboxRoot, { checked: accepted, "aria-disabled": withheld || undefined, "aria-describedby": readingGated ? readingPromptId : undefined, onCheckedChange: (checked) => { if (!withheld)
+                            setAccepted(checked === true); } }), _jsx(Text, { className: "text-sm", children: t(UserRegisterLabel.TERMS_ACCEPTANCE) })] }), _jsx(Text, { "aria-live": "polite", className: "sr-only", children: readingGated && readingComplete ? t(UserRegisterLabel.TERMS_READ_COMPLETE) : '' }), links] }));
+};
+//# sourceMappingURL=GovernedDocumentAcceptanceControl.js.map

package/dist/esm/components/compliance/GovernedDocumentAcceptanceControl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GovernedDocumentAcceptanceControl.js","sourceRoot":"","sources":["../../../../../src/components/compliance/GovernedDocumentAcceptanceControl.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * The governed-document ACCEPTANCE CONTROL — one control for every surface that asks a person to agree\n * to the documents an application requires (#1258).\n *\n * ## Why it is shared, and was lifted out of registration\n *\n * It began inside `Auth_Register`, where it was right while sign-up was the only surface that asked.\n * Re-acceptance is a second one: a release that changes the terms materially must be accepted again,\n * by a person who is already signed in (`AppLayout_DocumentAcceptanceGate`). Two copies of this control\n * would be two copies of every rule it now carries — the three acceptance modes, the reading gate and\n * its evidence lifetime (#1387), the parameterised document links (#1386), the accessibility of a\n * withheld box (#1381), the draft and not-yet-established marks — and they would drift the first time\n * one was fixed. So the control owns the rules and the host owns the STATE, which it passes in.\n *\n * ## The labels are the acceptance words, whatever namespace they live in\n *\n * They are the `PUBLIC_LAYOUTS_USER_REGISTER` `TERMS_*` keys, because that is where they were authored\n * and every application's label packs already carry them. A host passes the resolvers; nothing here\n * opens a second i18n subscription. Moving the keys would owe a label regeneration in every\n * application for no change a reader could see.\n */\nimport React, { useCallback, useEffect, useId, useRef } from 'react';\nimport { FrontendComponentType, UserRegisterLabel } from '@wildo-ai/presets-components-models';\nimport {\n  GovernedDocumentAcceptanceMode,\n  GovernedDocumentPublicClauseStanding,\n  GovernedDocumentPublicDocumentKind,\n  governedDocumentAcceptanceRequiresExplicitAct,\n  governedDocumentAcceptanceRequiresReading,\n  resolvePublicGovernedDocumentRoutePath,\n  type GovernedDocumentInteractionSurface,\n  type GovernedDocumentPublicDocument,\n} from '@wildo-ai/saas-models';\nimport { CheckboxRoot } from '~wildo-frontend-lib/components/form/controls/boolean/checkbox';\nimport { Link } from '~wildo-frontend-lib/components/typography/link';\nimport { Text } from '~wildo-frontend-lib/components/typography/text';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\n\n/**\n * A pane's identity in the read set.\n *\n * The INDEX is part of it deliberately: two required documents can carry the same title — a locale\n * variant, or an operator who named both \"Terms\" — and keying on the title alone would let scrolling\n * one of them mark both as read, satisfying a gate over text nobody saw.\n */\nexport const documentReadKey = (document: GovernedDocumentPublicDocument, index: number): string =>\n  `${String(index)}:${document.content.title}`;\n\n/** One required release and the public document it publishes, if the application serves one. */\nexport interface RequiredDocumentPresentation {\n  readonly release: GovernedDocumentInteractionSurface;\n  readonly document: GovernedDocumentPublicDocument | undefined;\n}\n\n/**\n * What the control reads, owned by the host screen.\n *\n * Held ABOVE the control so a remount cannot reset the act without its evidence, or the reverse —\n * the #1387 lesson: the box rendered pre-ticked after a sign-up method switch because the two had\n * different lifetimes.\n */\nexport interface GovernedDocumentAcceptanceState {\n  /** The in-force releases this person must accept here. Empty renders nothing. */\n  readonly requiredReleases: readonly GovernedDocumentInteractionSurface[];\n  /** How this application asks. */\n  readonly acceptanceMode: GovernedDocumentAcceptanceMode;\n  /** Each required release paired with the public document it publishes, or `undefined` when none is served. */\n  readonly requiredDocuments: readonly RequiredDocumentPresentation[];\n  /** Every public document the application SERVES — linked, never paned, gated or ticked. */\n  readonly servedDocuments: readonly GovernedDocumentPublicDocument[];\n  readonly accepted: boolean;\n  readonly setAccepted: (accepted: boolean) => void;\n  /** Which panes the reader has reached the end of — the EVIDENCE the reading gate is derived from. */\n  readonly documentsRead: readonly string[];\n  readonly markDocumentRead: (paneKey: string) => void;\n}\n\n/**\n * One document, in a box the reader must scroll to the end of — the `EXPLICIT_AFTER_READING` pane.\n *\n * ## What \"reached the end\" means, and the case that breaks every naive version\n *\n * A pane whose content is SHORTER than its box never scrolls, so a listener alone leaves the reader\n * permanently unable to accept a document they can see in its entirety. An effect settles that on\n * mount by measuring: no overflow means there was nothing to scroll past, which is reaching the end.\n * The same measurement re-runs when the content changes.\n *\n * A plain `useEffect`, not `useLayoutEffect`. It only ENABLES a control, so running it after paint\n * costs a frame nobody can act within; `useLayoutEffect` would buy that frame at the price of\n * blocking paint on a measurement, which is the wrong trade for a form.\n *\n * The 2px tolerance is not slop — sub-pixel layout means `scrollTop + clientHeight` lands\n * fractionally short of `scrollHeight` on real devices, and an exact comparison makes the last line\n * unreachable.\n *\n * ## Why the text is not rendered as markdown here\n *\n * `saas-frontend-lib` imports nothing from `presets-components`, which is where the theme-mapped\n * markdown renderer lives — and that renderer lazily loads a ~210 kB pipeline, which has no business\n * on a registration form. The clause is already the document's structural unit, so sections and\n * clauses carry the structure and each clause's body is shown as authored. The full typeset document\n * is one link away, on the page that exists to render it.\n */\nconst GovernedDocumentReadingPane: React.FC<{\n  readonly document: GovernedDocumentPublicDocument;\n  /** The component's label resolver, passed down so the pane does not open a second i18n subscription. */\n  readonly t: (key: string) => string;\n  /** This pane's identity in the read set — passed to `onReachedEnd` so the callback can stay stable. */\n  readonly paneKey: string;\n  readonly onReachedEnd: (paneKey: string) => void;\n}> = ({ document, t, paneKey, onReachedEnd }) => {\n  const boxRef = useRef<HTMLDivElement | null>(null);\n\n  /*\n   * The callback takes the pane's key rather than closing over it, so the parent can pass ONE stable\n   * function instead of a fresh arrow per render. With an inline arrow this effect re-ran on every\n   * render of the form — harmless, because the read set bails out on an unchanged reference, but\n   * harmless-by-luck is not a property to rely on in a gate.\n   */\n  const settleIfEndReached = useCallback(() => {\n    const box = boxRef.current;\n    if (!box) return;\n    if (box.scrollTop + box.clientHeight >= box.scrollHeight - 2) onReachedEnd(paneKey);\n  }, [onReachedEnd, paneKey]);\n\n  useEffect(settleIfEndReached, [settleIfEndReached, document]);\n\n  return (\n    <div\n      ref={boxRef}\n      onScroll={settleIfEndReached}\n      tabIndex={0}\n      /*\n       * `lang` is the DOCUMENT's locale, not the reader's — the same reason the public page sets it.\n       * `tabIndex` because a scrollable region that cannot be focused cannot be scrolled from the\n       * keyboard, which would make the gate unpassable without a mouse.\n       */\n      lang={document.content.locale}\n      role=\"region\"\n      aria-label={document.content.title}\n      className=\"focus-ring-offset max-h-64 overflow-y-auto rounded-md border border-border bg-muted/30 p-element text-sm\"\n    >\n      {/*\n        * HEADINGS, not styled paragraphs. A long legal document is navigated by heading in a screen\n        * reader, and `Text` renders a `<p>` — so a document whose title and every section title were\n        * paragraphs could only be read top to bottom. The public page uses h1/h2 for the same reason;\n        * here they start at h2 because the registration screen's own heading — an h1 — is above them.\n        *\n        * This said h3 until the first live accessibility run (#1385) reported `heading-order`: the\n        * reasoning \"one level below the screen's heading\" was right and the arithmetic was not, since\n        * one level below an h1 is an h2. A skipped level is what makes a screen reader's heading list\n        * look as though a section is missing.\n        */}\n      <h2 className=\"font-medium\">{document.content.title}</h2>\n      {/*\n        * The document's STANDING, shown before its text.\n        *\n        * The public page marks an unreleased draft and every clause the drafter could not establish;\n        * this pane rendered neither, so text an application itself wrote down as unsettled was shown\n        * bare, scroll-gated, and then accepted as contract. Wonder Todos is exactly that case today:\n        * an UNAPPROVED release whose terms carry thirteen not-yet-established clauses.\n        *\n        * The page's own note says showing a marked clause bare \"would state as settled what the\n        * application itself wrote down as unsettled\" — which is worse here than there, because here\n        * the reader is being asked to be BOUND by it. Marking rather than withholding, for the\n        * reason the whole lane marks rather than refuses: withholding the text would withhold\n        * registration, and the person cannot publish a release.\n        */}\n      {document.kind === GovernedDocumentPublicDocumentKind.UNRELEASED_DRAFT && (\n        <Text role=\"note\" className=\"mt-element-sm text-xs font-medium\">{t(UserRegisterLabel.TERMS_DRAFT_NOTICE)}</Text>\n      )}\n      {document.content.sections.map((section) => (\n        <div key={section.sectionRef} className=\"mt-element flex flex-col gap-element-sm\">\n          <h3 className=\"font-medium\">{section.title}</h3>\n          {section.clauses.map((clause) => (\n            <div key={clause.clauseRef} className=\"flex flex-col gap-element-sm\">\n              <Text className=\"whitespace-pre-line text-muted-foreground\">{clause.bodyMarkdown}</Text>\n              {clause.standing === GovernedDocumentPublicClauseStanding.NOT_YET_ESTABLISHED && (\n                <Text role=\"note\" className=\"text-xs\">\n                  {`${t(UserRegisterLabel.TERMS_CLAUSE_NOT_ESTABLISHED)} ${clause.missingInformation ?? ''}`.trim()}\n                </Text>\n              )}\n            </div>\n          ))}\n        </div>\n      ))}\n    </div>\n  );\n};\n\n/**\n * How this application asks the registrant to accept its governed documents — the three declared\n * shapes of {@link GovernedDocumentAcceptanceMode} (#1258).\n *\n * Renders nothing at all when the application requires no acceptance, which is what an application\n * with no governed documents has always seen.\n */\nexport const GovernedDocumentAcceptanceControl: React.FC<{\n  /** The acceptance state, owned by the screen that hosts the control — registration, or the re-acceptance gate. */\n  readonly state: GovernedDocumentAcceptanceState;\n  readonly t: (key: string) => string;\n  /** The parameterised resolver, for the one label that takes a value (the document link). */\n  readonly tComponent: (component: FrontendComponentType, key: string, params?: Record<string, string | number>) => string;\n}> = ({ state, t, tComponent }) => {\n  const { requiredReleases, acceptanceMode, requiredDocuments, servedDocuments, accepted, setAccepted, documentsRead, markDocumentRead } = state;\n\n  const documentsToRead = requiredDocuments\n    .map((entry) => entry.document)\n    .filter((document): document is GovernedDocumentPublicDocument => document !== undefined);\n\n  /*\n   * Each document that HAS a public page, linked and NAMED. One served elsewhere contributes no link.\n   * The name comes from the document when the application publishes one, and falls back to the page's\n   * own PATH when it does not — never to a bare \"read in full\", which would give N documents one\n   * indistinguishable link, and never to the document REF, which is an identifier a reader has no use\n   * for (`document:public.service-terms — Read in full`).\n   *\n   * ## The set linked is wider than the set ACCEPTED\n   *\n   * `requiredDocuments` holds only releases permitting `CONTRACT_ACCEPTED`, which is right: a privacy\n   * notice permits delivery and acknowledgement and is not a contract, so it must never be paned,\n   * gated or ticked. But the acceptance sentence beside these links names it — \"I agree to the terms\n   * of service and privacy policy\" is what applications write — and a screen that says a person is\n   * agreeing to a notice while showing them no way to reach it tells them something and then withholds\n   * it. So every public governed document the application SERVES is linked, whether or not it is being\n   * accepted. Linking is not accepting, and a person is entitled to be told where the notice is at the\n   * moment they are told they agree to it.\n   */\n  const documentLinks = requiredDocuments\n    .map((entry) => ({\n      release: entry.release,\n      path: resolvePublicGovernedDocumentRoutePath(entry.release.identity.document.documentRef),\n      title: entry.document?.content.title ?? resolvePublicGovernedDocumentRoutePath(entry.release.identity.document.documentRef) ?? '',\n      /* The DOCUMENT's language, not the reader's — what `lang` on the link announces. */\n      locale: entry.document?.content.locale ?? entry.release.locale,\n    }))\n    .filter((entry): entry is { release: GovernedDocumentInteractionSurface; path: string; title: string; locale: string } => entry.path !== undefined);\n\n  /*\n   * …and the public documents the application serves that are NOT being accepted — the privacy notice\n   * being the case every application has. Keyed by path so a document already linked above (a served\n   * document that IS accepted) is not listed twice.\n   */\n  const linkedPaths = new Set(documentLinks.map((entry) => entry.path));\n  const additionalDocumentLinks = servedDocuments\n    .map((document) => ({\n      document,\n      path: resolvePublicGovernedDocumentRoutePath(\n        document.kind === GovernedDocumentPublicDocumentKind.RELEASED ? document.release.identity.document.documentRef : document.documentRef,\n      ),\n    }))\n    .filter((entry): entry is { document: GovernedDocumentPublicDocument; path: string } => entry.path !== undefined && !linkedPaths.has(entry.path));\n\n  /*\n   * DERIVED from the evidence against the documents CURRENTLY offered — every one of them, not merely\n   * the last. Scrolling one box to its end says nothing about the box beneath it, and the gate's whole\n   * claim is that all of the text was presented.\n   *\n   * Derived rather than latched, which is what stops a satisfied gate outliving what satisfied it: a\n   * document set that grew would otherwise leave the box open over text nobody saw. Whether the gate\n   * APPLIES is `readingGated` below; this only says when one that applies is met.\n   */\n  const readingComplete = documentsToRead.length > 0\n    && documentsToRead.every((document, index) => documentsRead.includes(documentReadKey(document, index)));\n\n  if (requiredReleases.length === 0) return null;\n\n  const links = documentLinks.length > 0 && (\n    <span className=\"flex flex-wrap gap-element-sm\">\n      {/*\n        * Each link names its OWN document. Rendering the bare label gave every required document the\n        * same words — \"Read in full\", N times, pointing at N different pages — which tells a reader\n        * nothing about which is which and gives a screen reader N identical links to choose between.\n        * The label's authored purpose already says the title is supplied separately; this is what\n        * supplies it.\n        */}\n      {additionalDocumentLinks.map(({ document, path }) => (\n        <Link key={path} href={path} external target=\"_blank\" rel=\"noreferrer\" className=\"text-sm\" lang={document.content.locale}>\n          {tComponent(FrontendComponentType.PUBLIC_LAYOUTS_USER_REGISTER, UserRegisterLabel.TERMS_OPEN_DOCUMENT, { documentTitle: document.content.title })}\n        </Link>\n      ))}\n      {documentLinks.map(({ release, path, title, locale }) => (\n        <Link key={release.identity.releaseId} href={path} external target=\"_blank\" rel=\"noreferrer\" className=\"text-sm\" lang={locale}>\n          {/*\n            * The locale owns the WHOLE string. This was assembled here as `${title} — ${label}`, so no\n            * language could reorder the two, change the separator, or drop it — and the title, which\n            * is in the DOCUMENT's language, carried no `lang`, so a screen reader pronounced a French\n            * notice's title as English. `lang` on the link is the same correction the public page and\n            * the reading pane already make.\n            */}\n          {tComponent(FrontendComponentType.PUBLIC_LAYOUTS_USER_REGISTER, UserRegisterLabel.TERMS_OPEN_DOCUMENT, { documentTitle: title })}\n        </Link>\n      ))}\n    </span>\n  );\n\n  /*\n   * SIGN-IN-WRAP. No control and nothing withheld: submitting IS the act, so the notice states what\n   * the submission will mean. It is rendered immediately above the button rather than in a footer,\n   * because conspicuousness is the whole of what separates this from the shape that does not hold.\n   */\n  if (!governedDocumentAcceptanceRequiresExplicitAct(acceptanceMode)) {\n    return (\n      <div className=\"flex flex-col gap-element-sm\">\n        <Text role=\"note\" className=\"text-sm text-muted-foreground\">{t(UserRegisterLabel.TERMS_ACCEPTANCE_IMPLIED)}</Text>\n        {links}\n      </div>\n    );\n  }\n\n  /*\n   * The reading gate applies only when EVERY required release has text to present. The mode alone is\n   * not enough, and neither is SOME of the text.\n   *\n   * ## Why not the mode alone\n   *\n   * An application can declare `EXPLICIT_AFTER_READING` and serve no public document for a release it\n   * requires — the two are separate declarations, and `wildo config document-releases` writes the\n   * second only for documents the application publishes. Gated on the mode alone there would then be\n   * nothing to scroll, nothing could ever mark the reading complete, the box would stay disabled and\n   * NOBODY COULD REGISTER. That is the shape `application-creation-directive.md` tests for: if this\n   * refuses, what does the operator do next? \"Publish the document\" is not something the person in\n   * front of the form can do.\n   *\n   * ## Why not a PARTIAL set either\n   *\n   * Two required releases with one document served would put one pane on screen, and scrolling it\n   * would satisfy a gate whose whole claim is that the text was presented IN FULL. That claim would\n   * be false about the document nobody saw — and a false claim is worse than a weaker one, because\n   * the record says the person was shown something they were not.\n   *\n   * ## What happens instead\n   *\n   * The mode degrades to `EXPLICIT_CHECKBOX`. The affirmative act survives and only the presentation\n   * CLAIM is dropped, which is the honest direction: with text missing, \"they were shown the text\" is\n   * not a claim this form may make. It is the mode's own JSDoc — the gate asserts presentation, never\n   * reading — one step further along. An application that wants the gate publishes its documents.\n   */\n  const everyRequiredDocumentIsServed = requiredDocuments.every((entry) => entry.document !== undefined) && requiredDocuments.length > 0;\n  const readingGated = governedDocumentAcceptanceRequiresReading(acceptanceMode) && everyRequiredDocumentIsServed;\n  /** The act is owed and not yet made — the one predicate the label, the control and its state share. */\n  const withheld = readingGated && !readingComplete;\n  const readingPromptId = useId();\n\n  return (\n    <div className=\"flex flex-col gap-element\">\n      {readingGated && (\n        <>\n          <Text id={readingPromptId} className=\"text-sm text-muted-foreground\">{t(UserRegisterLabel.TERMS_READ_PROMPT)}</Text>\n          {documentsToRead.map((document, index) => (\n            <GovernedDocumentReadingPane\n              key={documentReadKey(document, index)}\n              document={document}\n              t={t}\n              paneKey={documentReadKey(document, index)}\n              onReachedEnd={markDocumentRead}\n            />\n          ))}\n        </>\n      )}\n      {/*\n        * Never pre-ticked, in any mode. A pre-ticked box is not an affirmative act, so it removes the\n        * one property clickwrap exists to provide.\n        *\n        * Under the reading gate the box is DISABLED rather than hidden: a control that appears once\n        * the reader reaches the end is a surprise, while one visibly waiting tells them what the\n        * scrolling is for.\n        */}\n      <label className={cn('flex items-start gap-element', withheld ? 'cursor-not-allowed opacity-60' : 'cursor-pointer')}>\n        {/*\n          * `aria-disabled`, not `disabled` — and `aria-describedby` pointing at the instruction.\n          *\n          * `disabled` removes a control from the tab order, so a keyboard user met neither this box\n          * nor the submit: the two controls that explain the state of the screen were the two they\n          * could not reach. `aria-disabled` keeps it focusable and announced while still refusing the\n          * act, and the description is what turns \"unavailable\" into a reason — without it a screen\n          * reader says only that a checkbox is unavailable, never why or what would change that.\n          */}\n        <CheckboxRoot\n          checked={accepted}\n          aria-disabled={withheld || undefined}\n          aria-describedby={readingGated ? readingPromptId : undefined}\n          onCheckedChange={(checked) => { if (!withheld) setAccepted(checked === true); }}\n        />\n        <Text className=\"text-sm\">{t(UserRegisterLabel.TERMS_ACCEPTANCE)}</Text>\n      </label>\n      {/*\n        * The moment the gate OPENS is otherwise only visible. A polite live region announces it, so a\n        * person who cannot see the box become available learns that their scrolling finished.\n        */}\n      <Text aria-live=\"polite\" className=\"sr-only\">\n        {readingGated && readingComplete ? t(UserRegisterLabel.TERMS_READ_COMPLETE) : ''}\n      </Text>\n      {links}\n    </div>\n  );\n};\n"]}

package/dist/esm/components/data-display/AutomaticDisplayer.d.ts

@@ -14,19 +14,28 @@
 import React from 'react';
 import { z } from 'zod';
 import type { FileActivationOperationDispatcher } from '../../components/data-display/useFileActivation';
-import type { LayoutRefManifest } from '../../core/resources/resources.frontend.schemas';
+import type { LayoutRefManifest, ResourceLayoutInlineEditDefault } from '../../core/resources/resources.frontend.schemas';
 import type { FrontendResource_ParentResourceRequirement } from '../../core/resources/resource-path.frontend.schemas';
 import type { DisplayChromeMode, ResponsiveAware, FileFieldEndpoints } from '@wildo-ai/zod-decorators';
+import type { AutoEmptyValue } from '@wildo-ai/presets-components-models';
 import type { ResourceMutationManager } from '../../core/resources/rmm/ResourceMutationManager';
 import { UpdateLikeMutationFallbackMode } from '../../core/resources/rmm/update-like-mutation-fallback.frontend';
 import type { NavigationZone } from '../../core/navigation/navigation.schemas';
 import type { FrontendResourceConfiguration_Operation } from '../../core/resources/resources.frontend.schemas';
 import { type ParentReferenceConfig } from './automatic-displayer.utils';
+import type { ContainerSectionMode } from '@wildo-ai/zod-decorators';
 export interface AutomaticDisplayerLabels {
     resourceContext?: {
         resourceType: string;
         operationId: string;
     };
+    /**
+     * Resolve this schema's labels as if its fields sat at `<fieldPathPrefix>.<path>` in the resource.
+     *
+     * For a surface rendering the ITEM SHAPE of a collection that lives elsewhere in the owning
+     * resource — see `UseResourceLabelsOptions.fieldPathPrefix` for the full reasoning (#638).
+     */
+    fieldPathPrefix?: string;
     fields?: Record<string, string>;
     enums?: Record<string, Record<string, string>>;
     sections?: Record<string, {
@@ -91,6 +100,23 @@ export interface AutomaticDisplayerProps<TSchema extends z.ZodTypeAny> {
      * Propagated to `DisplayChromeProvider.displayChromeMode`.
      */
     defaultDisplayChromeMode?: ResponsiveAware<DisplayChromeMode>;
+    /**
+     * The layout's inline-edit default, from `ResourceLayoutConfig.defaultInlineEdit`.
+     * Forwarded opaquely into `ResourceDisplayContext` for `DisplayField` to consult — this component
+     * is resource-unaware and never reads the resource config itself.
+     */
+    defaultInlineEdit?: ResourceLayoutInlineEditDefault;
+    /**
+     * The layout's empty-value strategy, from `ResourceLayoutConfig.defaultEmptyValue`.
+     * Forwarded opaquely into `ResourceDisplayContext`; this component reads no resource config.
+     */
+    defaultEmptyValue?: AutoEmptyValue;
+    /**
+     * The layout's DISPLAY section container mode, from
+     * `ResourceLayoutConfig.defaultDisplaySectionAppearance`. Adopted by a `<Section>` that declares
+     * no `appearance` of its own; a section that declares one still wins.
+     */
+    defaultSectionAppearance?: ContainerSectionMode;
     /**
      * Opaque upstream shaping input for automatic READ templates.
      * Resource-aware wrappers can hide duplicate relationship-backed fields
@@ -109,7 +135,7 @@ export interface AutomaticDisplayerProps<TSchema extends z.ZodTypeAny> {
      */
     onFileActivationOperation?: FileActivationOperationDispatcher;
 }
-declare function AutomaticDisplayerComponent<TSchema extends z.ZodTypeAny>({ schema, data, className, labels, layoutRefs, resourceType, resourceId, contextualParameters, contextResourceIdentifiers, parentResourcesRequirements, navigationZone, inlineEditOperation, parentReferenceConfig, onInlineEdit, disableInlineEdit, fileUploadContext, onInlineEditSuccess, rmm, updateLikeMutationFallbackMode, layoutTemplate, isLoading, defaultDisplayChromeMode, hiddenFieldNames, inlineEditDisabledFieldNames, onFileActivationOperation, }: AutomaticDisplayerProps<TSchema>): React.JSX.Element;
+declare function AutomaticDisplayerComponent<TSchema extends z.ZodTypeAny>({ schema, data, className, labels, layoutRefs, resourceType, resourceId, contextualParameters, contextResourceIdentifiers, parentResourcesRequirements, navigationZone, inlineEditOperation, parentReferenceConfig, onInlineEdit, disableInlineEdit, fileUploadContext, onInlineEditSuccess, rmm, updateLikeMutationFallbackMode, layoutTemplate, isLoading, defaultDisplayChromeMode, defaultInlineEdit, defaultEmptyValue, defaultSectionAppearance, hiddenFieldNames, inlineEditDisabledFieldNames, onFileActivationOperation, }: AutomaticDisplayerProps<TSchema>): React.JSX.Element;
 declare namespace AutomaticDisplayerComponent {
     var displayName: string;
 }

package/dist/esm/components/data-display/AutomaticDisplayer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AutomaticDisplayer.d.ts","sourceRoot":"","sources":["../../../../src/components/data-display/AutomaticDisplayer.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"AutomaticDisplayer.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/AutomaticDisplayer.tsx"],"names":[],"mappings":"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"}

package/dist/esm/components/data-display/AutomaticDisplayer.js

@@ -25,9 +25,9 @@ import { allowsDirectOperationFallback, MissingRMMRuntimeError, UpdateLikeMutati
 import { UIContext } from '../../core/ui/UIContext.js';
 import { useResourceLabels } from '../../core/resources/useResourceLabels.js';
 import { LoggerFrontendService } from '../../core/monitoring/logger.frontend.service.js';
-import { pickPreferredOperationForCoreSemanticAddressability } from '../../core/resources/resource-addressability.frontend.utils.js';
+import { pickInlineFieldWriteOperation } from '../../core/resources/resource-addressability.frontend.utils.js';
 import { ResourceDisplayContext, InlineEditMutationError, } from './automatic-displayer.utils.js';
-import { buildNestedObjectFromPath } from './display-field-resolution.utils.js';
+import { buildInlineUpdateRequestData } from './display-field-resolution.utils.js';
 import { DisplayChromeProvider } from './chromes/DisplayChromeContext.js';
 import { DisplayTemplateProvider } from './DisplayTemplateContext.js';
 const logger = LoggerFrontendService.getLogger();
@@ -36,7 +36,7 @@ logger.setDebugTypeLogging('AutomaticDisplayer', false);
 // =============================================================================
 // COMPONENT
 // =============================================================================
-function AutomaticDisplayerComponent({ schema, data, className, labels, layoutRefs, resourceType, resourceId, contextualParameters, contextResourceIdentifiers, parentResourcesRequirements, navigationZone, inlineEditOperation, parentReferenceConfig, onInlineEdit, disableInlineEdit = false, fileUploadContext, onInlineEditSuccess, rmm, updateLikeMutationFallbackMode = UpdateLikeMutationFallbackMode.RMM_REQUIRED, layoutTemplate, isLoading = false, defaultDisplayChromeMode, hiddenFieldNames, inlineEditDisabledFieldNames, onFileActivationOperation, }) {
+function AutomaticDisplayerComponent({ schema, data, className, labels, layoutRefs, resourceType, resourceId, contextualParameters, contextResourceIdentifiers, parentResourcesRequirements, navigationZone, inlineEditOperation, parentReferenceConfig, onInlineEdit, disableInlineEdit = false, fileUploadContext, onInlineEditSuccess, rmm, updateLikeMutationFallbackMode = UpdateLikeMutationFallbackMode.RMM_REQUIRED, layoutTemplate, isLoading = false, defaultDisplayChromeMode, defaultInlineEdit, defaultEmptyValue, defaultSectionAppearance, hiddenFieldNames, inlineEditDisabledFieldNames, onFileActivationOperation, }) {
     const { doOperation, registry } = useResourceRegistry();
     // ── Breakpoint resolution ──
     const uiContext = useContext(UIContext);
@@ -44,6 +44,7 @@ function AutomaticDisplayerComponent({ schema, data, className, labels, layoutRe
     // ── Labels from i18n ──
     const { fieldLabels, fieldDescriptions, fieldTooltips, enumLabels, sectionLabels, sectionDescriptions, groupLabels, } = useResourceLabels(schema, labels?.resourceContext, data, 'display', {
         layoutRefs,
+        fieldPathPrefix: labels?.fieldPathPrefix,
         overrides: {
             fields: labels?.fields,
             enums: labels?.enums,
@@ -59,7 +60,12 @@ function AutomaticDisplayerComponent({ schema, data, className, labels, layoutRe
             const isUrlBearingOperation = inlineEditOperation.variantType === ResourceOperationVariantType.API_CALL
                 || inlineEditOperation.variantType === ResourceOperationVariantType.API_CALL_WITH_CALLBACK;
             const effectiveOperation = inlineEditOperation.resourceOperationLike ?? inlineEditOperation.operationIdentifier;
-            if (!isUrlBearingOperation || inlineEditOperation.isBulkOperation === true || effectiveOperation !== CoreResourceOperation.UPDATE) {
+            // The LITERAL `update`, never a custom verb that borrows UPDATE semantics. `effectiveOperation`
+            // alone admits `claimDomain`, `moveUnit`, `archive` — each a real, non-bulk, URL-bearing PUT that
+            // satisfies every other clause here, and each with its OWN request contract. A field value sent
+            // to one of them is a malformed call to a different action, not a partial update of the record.
+            const isLiteralUpdateOperation = inlineEditOperation.operationIdentifier === CoreResourceOperation.UPDATE;
+            if (!isUrlBearingOperation || !isLiteralUpdateOperation || inlineEditOperation.isBulkOperation === true || effectiveOperation !== CoreResourceOperation.UPDATE) {
                 logDebug('Rejected invalid inlineEditOperation', {
                     operationIdentifier: String(inlineEditOperation.operationIdentifier),
                     variantType: inlineEditOperation.variantType,
@@ -67,7 +73,7 @@ function AutomaticDisplayerComponent({ schema, data, className, labels, layoutRe
                     isBulkOperation: inlineEditOperation.isBulkOperation,
                     effectiveOperation: String(effectiveOperation),
                 });
-                throw new InlineEditMutationError('inlineEditOperation must be a non-bulk URL-bearing UPDATE operation');
+                throw new InlineEditMutationError('inlineEditOperation must be the non-bulk URL-bearing literal UPDATE operation, not a custom verb borrowing UPDATE semantics');
             }
             return inlineEditOperation;
         }
@@ -87,10 +93,9 @@ function AutomaticDisplayerComponent({ schema, data, className, labels, layoutRe
             ...(contextualParameters ?? {}),
             [fieldIdentifier]: resourceId,
         };
-        return pickPreferredOperationForCoreSemanticAddressability({
+        return pickInlineFieldWriteOperation({
             resourceConfig,
             operations: resourceConfig.operations ?? [],
-            coreOperation: CoreResourceOperation.UPDATE,
             registry,
             hasResourceId: frontendResourceUtils.getResourceId(updateContextResourceIdentifiers[resourceType]).length > 0,
             requireFrontendAddressable: true,
@@ -182,7 +187,7 @@ function AutomaticDisplayerComponent({ schema, data, className, labels, layoutRe
             await doOperation(operationPathKey, {
                 contextualParameters: mergedContextualParameters,
                 parentResourcesRequirements,
-                requestData: buildNestedObjectFromPath(fieldName, value),
+                requestData: buildInlineUpdateRequestData(data, fieldName, value),
             });
             onInlineEditSuccess?.(fieldName, value);
             return;
@@ -221,13 +226,15 @@ function AutomaticDisplayerComponent({ schema, data, className, labels, layoutRe
         resourceId,
         doInlineUpdate,
         canInlineEdit,
+        defaultInlineEdit,
+        defaultEmptyValue,
         fileUploadContext,
         contextualParameters,
         contextResourceIdentifiers,
         navigationZone,
         parentReferenceConfig,
         rmm,
-    }), [resourceType, resourceId, doInlineUpdate, canInlineEdit, fileUploadContext, contextualParameters, contextResourceIdentifiers, navigationZone, parentReferenceConfig, rmm]);
+    }), [resourceType, resourceId, doInlineUpdate, canInlineEdit, defaultInlineEdit, defaultEmptyValue, fileUploadContext, contextualParameters, contextResourceIdentifiers, navigationZone, parentReferenceConfig, rmm]);
     const displayTemplateContextValue = useMemo(() => ({
         schema,
         data: isLoading ? undefined : data,
@@ -239,6 +246,7 @@ function AutomaticDisplayerComponent({ schema, data, className, labels, layoutRe
         sectionLabels,
         sectionDescriptions,
         groupLabels,
+        defaultSectionAppearance,
         breakpoint: viewportBreakpoint,
         hiddenFieldNames,
         inlineEditDisabledFieldNames,
@@ -254,6 +262,7 @@ function AutomaticDisplayerComponent({ schema, data, className, labels, layoutRe
         sectionLabels,
         sectionDescriptions,
         groupLabels,
+        defaultSectionAppearance,
         viewportBreakpoint,
         hiddenFieldNames,
         inlineEditDisabledFieldNames,