@wildo-ai/saas-frontend-lib 1.1.4 → 1.1.6

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,

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

@@ -1 +1 @@
-{"version":3,"file":"AutomaticDisplayer.js","sourceRoot":"","sources":["../../../../src/components/data-display/AutomaticDisplayer.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * AutomaticDisplayer Component\n *\n * Renders a display template inside a provider stack:\n *   ResourceDisplayContext → DisplayChromeContext → DisplayTemplateContext → template\n *\n * The template is a `React.ComponentType` instantiated inside `<DisplayTemplateProvider>`,\n * so it can call `useDisplayTemplateContext()` for `data`, `isLoading`, labels, etc.\n * The template is structurally stable (created from schema) and data-reactive\n * (context data changes trigger re-renders).\n *\n * Inline editing is wired through ResourceDisplayContext.\n */\n\nimport React, { useMemo, useCallback, useContext } from 'react';\nimport { z } from 'zod';\n\nimport type { FileActivationOperationDispatcher } from '~wildo-frontend-lib/components/data-display/useFileActivation';\nimport type { LayoutRefManifest } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport type { FrontendResource_ParentResourceRequirement } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\nimport { CoreResourceOperation, ResourceOperationVariantType } from '@wildo-ai/saas-models';\nimport { ViewportBreakpoint, isDiscriminatorField, getObjectLikeFieldSchema, normalizeClearedMainSchemaValue } from '@wildo-ai/zod-decorators';\nimport type { DisplayChromeMode, ResponsiveAware, FileFieldEndpoints } from '@wildo-ai/zod-decorators';\nimport { AutomatedLayoutFrontendUtils } from '~wildo-frontend-lib/core/automated-layout/automated-layout.frontend.utils';\n\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { frontendResourceUtils, FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { ResourcesConfig_OperationPathUtils } from '@wildo-ai/saas-models';\nimport type { ResourceMutationManager } from '~wildo-frontend-lib/core/resources/rmm/ResourceMutationManager';\nimport { MutationType, MutationPriority, MutationSourceType } from '~wildo-frontend-lib/core/resources/rmm/types';\nimport {\n  allowsDirectOperationFallback,\n  MissingRMMRuntimeError,\n  UpdateLikeMutationFallbackMode,\n} from '~wildo-frontend-lib/core/resources/rmm/update-like-mutation-fallback.frontend';\nimport { UIContext } from '~wildo-frontend-lib/core/ui/UIContext';\nimport { useResourceLabels } from '~wildo-frontend-lib/core/resources/useResourceLabels';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport type { NavigationZone } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport type { FrontendResourceConfiguration_Operation } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { pickPreferredOperationForCoreSemanticAddressability } from '~wildo-frontend-lib/core/resources/resource-addressability.frontend.utils';\n\nimport {\n  ResourceDisplayContext,\n  InlineEditMutationError,\n  type ResourceDisplayContextValue,\n  type ParentReferenceConfig,\n} from './automatic-displayer.utils';\nimport { buildNestedObjectFromPath } from './display-field-resolution.utils';\n\nimport { DisplayChromeProvider } from './chromes/DisplayChromeContext';\nimport { DisplayTemplateProvider, type DisplayTemplateContextValue } from './DisplayTemplateContext';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('AutomaticDisplayer');\nlogger.setDebugTypeLogging('AutomaticDisplayer', false);\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\nexport interface AutomaticDisplayerLabels {\n  resourceContext?: { resourceType: string; operationId: string };\n  fields?: Record<string, string>;\n  enums?: Record<string, Record<string, string>>;\n  sections?: Record<string, { titleKey?: string; descriptionKey?: string }>;\n}\n\nexport interface AutomaticDisplayerProps<TSchema extends z.ZodTypeAny> {\n  schema: TSchema;\n  data: z.infer<TSchema>;\n  className?: string;\n  labels?: AutomaticDisplayerLabels;\n\n  /** Layout ref manifest for i18n label resolution of sections/groups. */\n  layoutRefs?: LayoutRefManifest;\n\n  resourceType?: string;\n  resourceId?: string;\n  contextualParameters?: Record<string, string | number>;\n  contextResourceIdentifiers?: Record<string, string | { fieldIdentifier: string; resourceId: string }>;\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n  navigationZone?: NavigationZone;\n  inlineEditOperation?: FrontendResourceConfiguration_Operation | null;\n  parentReferenceConfig?: ParentReferenceConfig;\n  /**\n   * Caller-owned weaker-guarantee override for inline edit.\n   *\n   * Providing this hook bypasses the default RMM-backed engine path. The caller\n   * becomes responsible for any queueing, conflict handling, canonical read-back,\n   * and broader coherence guarantees they still want to preserve.\n   */\n  onInlineEdit?: (fieldName: string, value: unknown) => Promise<void>;\n  disableInlineEdit?: boolean;\n  fileUploadContext?: Record<string, FileFieldEndpoints>;\n  onInlineEditSuccess?: (fieldName: string, value: unknown) => void;\n  rmm?: ResourceMutationManager | null;\n  /**\n   * Controls whether inline edit may downgrade to a direct UPDATE operation when\n   * RMM is unavailable. Defaults to `RMM_REQUIRED` so generic engine inline edit\n   * does not silently pretend to be RMM-backed.\n   *\n   * The richer conflict-reset UX is only guaranteed on the single-resource\n   * RMM-backed lane where the backend supplies authoritative nested\n   * `versionConflict` details. Explicit direct fallback remains a weaker-\n   * guarantee path.\n   */\n  updateLikeMutationFallbackMode?: UpdateLikeMutationFallbackMode;\n\n  /**\n   * The display template to render — a `React.ComponentType` instantiated inside\n   * `<DisplayTemplateProvider>`. The component can call `useDisplayTemplateContext()`\n   * to access `data`, `isLoading`, labels, and breakpoint.\n   */\n  layoutTemplate: React.ComponentType | null;\n\n  /**\n   * Whether data is still loading. When true, DisplayField renders skeletons (DD-9).\n   * @default false\n   */\n  isLoading?: boolean;\n\n  /**\n   * Default chrome mode for display fields from `ResourceLayoutConfig.defaultChromeMode.display`.\n   * Propagated to `DisplayChromeProvider.displayChromeMode`.\n   */\n  defaultDisplayChromeMode?: ResponsiveAware<DisplayChromeMode>;\n\n  /**\n   * Opaque upstream shaping input for automatic READ templates.\n   * Resource-aware wrappers can hide duplicate relationship-backed fields\n   * without teaching generic display components relationship semantics.\n   */\n  hiddenFieldNames?: string[];\n\n  /**\n   * Opaque upstream shaping input for automatic READ templates.\n   * Keeps generic inline edit fail-closed for relationship object/array slots.\n   */\n  inlineEditDisabledFieldNames?: string[];\n  /**\n   * Dispatcher for `FileActivationPolicy.CUSTOM` file activations — supplied by the\n   * resource-aware host, forwarded opaquely into `DisplayTemplateContext` for the\n   * generic file displayer. Absent under a non-resource host.\n   */\n  onFileActivationOperation?: FileActivationOperationDispatcher;\n\n}\n\n// =============================================================================\n// COMPONENT\n// =============================================================================\n\nfunction AutomaticDisplayerComponent<TSchema extends z.ZodTypeAny>({\n  schema,\n  data,\n  className,\n  labels,\n  layoutRefs,\n  resourceType,\n  resourceId,\n  contextualParameters,\n  contextResourceIdentifiers,\n  parentResourcesRequirements,\n  navigationZone,\n  inlineEditOperation,\n  parentReferenceConfig,\n  onInlineEdit,\n  disableInlineEdit = false,\n  fileUploadContext,\n  onInlineEditSuccess,\n  rmm,\n  updateLikeMutationFallbackMode = UpdateLikeMutationFallbackMode.RMM_REQUIRED,\n  layoutTemplate,\n  isLoading = false,\n  defaultDisplayChromeMode,\n  hiddenFieldNames,\n  inlineEditDisabledFieldNames,\n  onFileActivationOperation,\n}: AutomaticDisplayerProps<TSchema>): React.JSX.Element {\n  const { doOperation, registry } = useResourceRegistry();\n\n  // ── Breakpoint resolution ──\n  const uiContext = useContext(UIContext);\n  const viewportBreakpoint: ViewportBreakpoint = uiContext?.UIConfig?.currentBreakpoint ?? ViewportBreakpoint.DESKTOP;\n\n  // ── Labels from i18n ──\n  const {\n    fieldLabels,\n    fieldDescriptions,\n    fieldTooltips,\n    enumLabels,\n    sectionLabels,\n    sectionDescriptions,\n    groupLabels,\n  } = useResourceLabels(\n    schema,\n    labels?.resourceContext,\n    data as Record<string, unknown>,\n    'display',\n    {\n      layoutRefs,\n      overrides: {\n        fields: labels?.fields,\n        enums: labels?.enums,\n        sections: labels?.sections,\n      },\n    },\n  );\n\n  // ── Inline editing ──\n\n  const resolveInlineUpdateOperation = useCallback((): FrontendResourceConfiguration_Operation | null => {\n    if (inlineEditOperation === null) {\n      return null;\n    }\n    if (inlineEditOperation !== undefined) {\n      const isUrlBearingOperation = inlineEditOperation.variantType === ResourceOperationVariantType.API_CALL\n        || inlineEditOperation.variantType === ResourceOperationVariantType.API_CALL_WITH_CALLBACK;\n      const effectiveOperation = inlineEditOperation.resourceOperationLike ?? inlineEditOperation.operationIdentifier;\n      if (!isUrlBearingOperation || inlineEditOperation.isBulkOperation === true || effectiveOperation !== CoreResourceOperation.UPDATE) {\n        logDebug('Rejected invalid inlineEditOperation', {\n          operationIdentifier: String(inlineEditOperation.operationIdentifier),\n          variantType: inlineEditOperation.variantType,\n          variantKey: inlineEditOperation.variantKey,\n          isBulkOperation: inlineEditOperation.isBulkOperation,\n          effectiveOperation: String(effectiveOperation),\n        });\n        throw new InlineEditMutationError(\n          'inlineEditOperation must be a non-bulk URL-bearing UPDATE operation',\n        );\n      }\n      return inlineEditOperation;\n    }\n    if (!resourceType || !resourceId) {\n      return null;\n    }\n\n    const resourceConfig = registry.resourceConfigurations[resourceType];\n    if (!resourceConfig) {\n      return null;\n    }\n\n    const fieldIdentifier = FrontendResourceUtils.getResourceFieldIdentifierForType(resourceType, registry);\n    const updateContextResourceIdentifiers = {\n      ...(contextResourceIdentifiers ?? {}),\n      [resourceType]: resourceId,\n    };\n    const updateContextualParameters = {\n      ...(contextualParameters ?? {}),\n      [fieldIdentifier]: resourceId,\n    };\n\n    return pickPreferredOperationForCoreSemanticAddressability({\n      resourceConfig,\n      operations: resourceConfig.operations ?? [],\n      coreOperation: CoreResourceOperation.UPDATE,\n      registry,\n      hasResourceId: frontendResourceUtils.getResourceId(updateContextResourceIdentifiers[resourceType]).length > 0,\n      requireFrontendAddressable: true,\n      contextResourceIdentifiers: updateContextResourceIdentifiers,\n      contextualParameters: updateContextualParameters,\n    }) ?? null;\n  }, [contextResourceIdentifiers, contextualParameters, inlineEditOperation, registry, resourceId, resourceType]);\n\n  const hasUpdateOperation = useMemo(() => {\n    return resolveInlineUpdateOperation() !== null;\n  }, [resolveInlineUpdateOperation]);\n\n  // Discriminator field name(s) for this resource. A discriminated-union (polymorphic)\n  // resource keeps its discriminator REQUIRED on the UPDATE requestDto (it selects the\n  // variant the body is validated against), so every PARTIAL inline update must carry it —\n  // otherwise the backend rejects the update with `<discriminator>: Invalid input`. Resolved\n  // from the display schema's COMMON shape (the discriminator is shared across all variants).\n  const discriminatorFieldNames = useMemo<string[]>(() => {\n    try {\n      const commonShape = AutomatedLayoutFrontendUtils.getObjectLikeFieldShape(schema, { commonOnly: true }) ?? {};\n      return Object.entries(commonShape)\n        .filter(([, fieldSchema]) => isDiscriminatorField(fieldSchema as z.ZodTypeAny))\n        .map(([discriminatorField]) => discriminatorField);\n    } catch {\n      return [];\n    }\n  }, [schema]);\n\n  const doInlineUpdate = useCallback(async (fieldName: string, rawValue: unknown): Promise<void> => {\n    // FIELD-CLEARING CONTRACT — inline edit builds its payload outside the form entirely, so it\n    // does not pass through `FormField`'s change handler and has to apply the same normalisation\n    // itself. Without it, emptying a field inline sends `''` (persisting an empty string, or\n    // failing validation on a refined field) instead of the clear the user asked for.\n    // This surface holds the resource's MAIN schema, so it uses the main-schema entry point: on a\n    // main schema an `.optional()` field does not accept null, and asking the request-DTO question\n    // here would report every ordinary optional field un-clearable.\n    const fieldSchema = schema ? getObjectLikeFieldSchema(schema, fieldName) : undefined;\n    const value = fieldSchema ? normalizeClearedMainSchemaValue(fieldSchema, rawValue) : rawValue;\n\n    logDebug('doInlineUpdate', {\n      fieldName,\n      path: onInlineEdit ? 'custom' : rmm ? 'rmm' : 'fallback',\n    });\n\n    if (onInlineEdit) {\n      await onInlineEdit(fieldName, value);\n      onInlineEditSuccess?.(fieldName, value);\n      return;\n    }\n\n    if (rmm) {\n      const transportOverride = inlineEditOperation\n        ? {\n            operationPathKey: ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(inlineEditOperation),\n          }\n        : undefined;\n      // Carry the current discriminator value(s) from `data` alongside the edited field so a\n      // discriminated-union resource's partial UPDATE selects the right variant (see\n      // `discriminatorFieldNames`). No-op for non-polymorphic resources.\n      const inlineRequest: Record<string, unknown> = { [fieldName]: value };\n      for (const discriminatorField of discriminatorFieldNames) {\n        if (\n          discriminatorField !== fieldName\n          && data != null\n          && (data as Record<string, unknown>)[discriminatorField] !== undefined\n        ) {\n          inlineRequest[discriminatorField] = (data as Record<string, unknown>)[discriminatorField];\n        }\n      }\n      const result = await rmm.queueMutation(\n        inlineRequest,\n        {\n          type: MutationType.INLINE,\n          priority: MutationPriority.LOW,\n          source: { type: MutationSourceType.DISPLAY, subscriberId: 'display-inline' },\n          transportOverride,\n        },\n      );\n      if (!result.success) {\n        throw new InlineEditMutationError(\n          result.error?.message ?? 'Inline edit failed',\n          result.error,\n        );\n      }\n      onInlineEditSuccess?.(fieldName, value);\n      return;\n    }\n\n    if (\n      allowsDirectOperationFallback(updateLikeMutationFallbackMode)\n      && resourceType\n      && resourceId\n    ) {\n      const updateOperation = resolveInlineUpdateOperation();\n      if (!updateOperation) {\n        throw new Error(\n          `No UPDATE operation configured for resource \"${resourceType}\". ` +\n          `Inline editing requires an UPDATE.default operation.`\n        );\n      }\n      const operationPathKey = ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(updateOperation);\n      const fieldIdentifier = FrontendResourceUtils.getResourceFieldIdentifierForType(resourceType, registry);\n      const mergedContextualParameters: Record<string, string | number> = {\n        ...contextualParameters,\n        [fieldIdentifier]: resourceId,\n      };\n      await doOperation(operationPathKey, {\n        contextualParameters: mergedContextualParameters,\n        parentResourcesRequirements,\n        requestData: buildNestedObjectFromPath(fieldName, value),\n      });\n      onInlineEditSuccess?.(fieldName, value);\n      return;\n    }\n\n    throw new MissingRMMRuntimeError({\n      surfaceName: 'AutomaticDisplayer inline edit',\n      resourceType: resourceType ?? 'unknown',\n      operationIdentifier: inlineEditOperation?.operationIdentifier ?? CoreResourceOperation.UPDATE,\n    });\n  }, [\n    onInlineEdit,\n    rmm,\n    resourceType,\n    resourceId,\n    contextualParameters,\n    parentResourcesRequirements,\n    doOperation,\n    registry,\n    onInlineEditSuccess,\n    resolveInlineUpdateOperation,\n    updateLikeMutationFallbackMode,\n    inlineEditOperation,\n    discriminatorFieldNames,\n    data,\n    schema,\n  ]);\n\n  const canInlineEdit = !disableInlineEdit && (\n    !!onInlineEdit\n    || !!rmm\n    || (\n      allowsDirectOperationFallback(updateLikeMutationFallbackMode)\n      && !!resourceType\n      && !!resourceId\n      && hasUpdateOperation\n    )\n  );\n\n  // ── Context values ──\n\n  const resourceDisplayContextValue = useMemo<ResourceDisplayContextValue>(() => ({\n    resourceType,\n    resourceId,\n    doInlineUpdate,\n    canInlineEdit,\n    fileUploadContext,\n    contextualParameters,\n    contextResourceIdentifiers,\n    navigationZone,\n    parentReferenceConfig,\n    rmm,\n  }), [resourceType, resourceId, doInlineUpdate, canInlineEdit, fileUploadContext, contextualParameters, contextResourceIdentifiers, navigationZone, parentReferenceConfig, rmm]);\n\n  const displayTemplateContextValue = useMemo<DisplayTemplateContextValue>(() => ({\n    schema,\n    data: isLoading ? undefined : (data as Record<string, unknown>),\n    isLoading,\n    fieldLabels,\n    fieldDescriptions,\n    fieldTooltips,\n    enumLabels,\n    sectionLabels,\n    sectionDescriptions,\n    groupLabels,\n    breakpoint: viewportBreakpoint,\n    hiddenFieldNames,\n    inlineEditDisabledFieldNames,\n    onFileActivationOperation,\n  }), [\n    schema,\n    data,\n    isLoading,\n    fieldLabels,\n    fieldDescriptions,\n    fieldTooltips,\n    enumLabels,\n    sectionLabels,\n    sectionDescriptions,\n    groupLabels,\n    viewportBreakpoint,\n    hiddenFieldNames,\n    inlineEditDisabledFieldNames,\n    onFileActivationOperation,\n  ]);\n\n  // ── Provider stack → template ──\n\n  return (\n    <ResourceDisplayContext.Provider value={resourceDisplayContextValue}>\n      <DisplayChromeProvider displayChromeMode={defaultDisplayChromeMode}>\n        <DisplayTemplateProvider value={displayTemplateContextValue}>\n          <div className={cn('space-y-section', className)}>\n            {layoutTemplate ? React.createElement(layoutTemplate) : null}\n          </div>\n        </DisplayTemplateProvider>\n      </DisplayChromeProvider>\n    </ResourceDisplayContext.Provider>\n  );\n}\n\nAutomaticDisplayerComponent.displayName = 'AutomaticDisplayer';\n\nexport const AutomaticDisplayer: typeof AutomaticDisplayerComponent & { displayName: string } = AutomaticDisplayerComponent;\n"]}
+{"version":3,"file":"AutomaticDisplayer.js","sourceRoot":"","sources":["../../../../../src/components/data-display/AutomaticDisplayer.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAMhE,OAAO,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,+BAA+B,EAAE,MAAM,0BAA0B,CAAC;AAG/I,OAAO,EAAE,4BAA4B,EAAE,MAAM,2EAA2E,CAAC;AAEzH,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAC7F,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,4DAA4D,CAAC;AAC1H,OAAO,EAAE,kCAAkC,EAAE,MAAM,uBAAuB,CAAC;AAE3E,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAClH,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,EACtB,8BAA8B,GAC/B,MAAM,+EAA+E,CAAC;AACvF,OAAO,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sDAAsD,CAAC;AACzF,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AAGpG,OAAO,EAAE,6BAA6B,EAAE,MAAM,2EAA2E,CAAC;AAE1H,OAAO,EACL,sBAAsB,EACtB,uBAAuB,GAGxB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAC;AAEhF,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAoC,MAAM,0BAA0B,CAAC;AAGrG,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,EAAE,CAAC;AACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC;AAC1D,MAAM,CAAC,mBAAmB,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;AAwHxD,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,SAAS,2BAA2B,CAA+B,EACjE,MAAM,EACN,IAAI,EACJ,SAAS,EACT,MAAM,EACN,UAAU,EACV,YAAY,EACZ,UAAU,EACV,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC3B,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,GAAG,KAAK,EACzB,iBAAiB,EACjB,mBAAmB,EACnB,GAAG,EACH,8BAA8B,GAAG,8BAA8B,CAAC,YAAY,EAC5E,cAAc,EACd,SAAS,GAAG,KAAK,EACjB,wBAAwB,EACxB,iBAAiB,EACnB,iBAAiB,EACf,wBAAwB,EACxB,gBAAgB,EAChB,4BAA4B,EAC5B,yBAAyB,GACQ;IACjC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAExD,8BAA8B;IAC9B,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,kBAAkB,GAAuB,SAAS,EAAE,QAAQ,EAAE,iBAAiB,IAAI,kBAAkB,CAAC,OAAO,CAAC;IAEpH,yBAAyB;IACzB,MAAM,EACJ,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,WAAW,GACZ,GAAG,iBAAiB,CACnB,MAAM,EACN,MAAM,EAAE,eAAe,EACvB,IAA+B,EAC/B,SAAS,EACT;QACE,UAAU;QACV,eAAe,EAAE,MAAM,EAAE,eAAe;QACxC,SAAS,EAAE;YACT,MAAM,EAAE,MAAM,EAAE,MAAM;YACtB,KAAK,EAAE,MAAM,EAAE,KAAK;YACpB,QAAQ,EAAE,MAAM,EAAE,QAAQ;SAC3B;KACF,CACF,CAAC;IAEF,uBAAuB;IAEvB,MAAM,4BAA4B,GAAG,WAAW,CAAC,GAAmD,EAAE;QACpG,IAAI,mBAAmB,KAAK,IAAI,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,mBAAmB,KAAK,SAAS,EAAE,CAAC;YACtC,MAAM,qBAAqB,GAAG,mBAAmB,CAAC,WAAW,KAAK,4BAA4B,CAAC,QAAQ;mBAClG,mBAAmB,CAAC,WAAW,KAAK,4BAA4B,CAAC,sBAAsB,CAAC;YAC7F,MAAM,kBAAkB,GAAG,mBAAmB,CAAC,qBAAqB,IAAI,mBAAmB,CAAC,mBAAmB,CAAC;YAChH,gGAAgG;YAChG,kGAAkG;YAClG,gGAAgG;YAChG,gGAAgG;YAChG,MAAM,wBAAwB,GAAG,mBAAmB,CAAC,mBAAmB,KAAK,qBAAqB,CAAC,MAAM,CAAC;YAC1G,IAAI,CAAC,qBAAqB,IAAI,CAAC,wBAAwB,IAAI,mBAAmB,CAAC,eAAe,KAAK,IAAI,IAAI,kBAAkB,KAAK,qBAAqB,CAAC,MAAM,EAAE,CAAC;gBAC/J,QAAQ,CAAC,sCAAsC,EAAE;oBAC/C,mBAAmB,EAAE,MAAM,CAAC,mBAAmB,CAAC,mBAAmB,CAAC;oBACpE,WAAW,EAAE,mBAAmB,CAAC,WAAW;oBAC5C,UAAU,EAAE,mBAAmB,CAAC,UAAU;oBAC1C,eAAe,EAAE,mBAAmB,CAAC,eAAe;oBACpD,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,CAAC;iBAC/C,CAAC,CAAC;gBACH,MAAM,IAAI,uBAAuB,CAC/B,6HAA6H,CAC9H,CAAC;YACJ,CAAC;YACD,OAAO,mBAAmB,CAAC;QAC7B,CAAC;QACD,IAAI,CAAC,YAAY,IAAI,CAAC,UAAU,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,cAAc,GAAG,QAAQ,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC;QACrE,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,eAAe,GAAG,qBAAqB,CAAC,iCAAiC,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QACxG,MAAM,gCAAgC,GAAG;YACvC,GAAG,CAAC,0BAA0B,IAAI,EAAE,CAAC;YACrC,CAAC,YAAY,CAAC,EAAE,UAAU;SAC3B,CAAC;QACF,MAAM,0BAA0B,GAAG;YACjC,GAAG,CAAC,oBAAoB,IAAI,EAAE,CAAC;YAC/B,CAAC,eAAe,CAAC,EAAE,UAAU;SAC9B,CAAC;QAEF,OAAO,6BAA6B,CAAC;YACnC,cAAc;YACd,UAAU,EAAE,cAAc,CAAC,UAAU,IAAI,EAAE;YAC3C,QAAQ;YACR,aAAa,EAAE,qBAAqB,CAAC,aAAa,CAAC,gCAAgC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC;YAC7G,0BAA0B,EAAE,IAAI;YAChC,0BAA0B,EAAE,gCAAgC;YAC5D,oBAAoB,EAAE,0BAA0B;SACjD,CAAC,IAAI,IAAI,CAAC;IACb,CAAC,EAAE,CAAC,0BAA0B,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;IAEhH,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,EAAE;QACtC,OAAO,4BAA4B,EAAE,KAAK,IAAI,CAAC;IACjD,CAAC,EAAE,CAAC,4BAA4B,CAAC,CAAC,CAAC;IAEnC,qFAAqF;IACrF,qFAAqF;IACrF,yFAAyF;IACzF,2FAA2F;IAC3F,4FAA4F;IAC5F,MAAM,uBAAuB,GAAG,OAAO,CAAW,GAAG,EAAE;QACrD,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,4BAA4B,CAAC,uBAAuB,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;YAC7G,OAAO,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;iBAC/B,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,WAA2B,CAAC,CAAC;iBAC9E,GAAG,CAAC,CAAC,CAAC,kBAAkB,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,MAAM,cAAc,GAAG,WAAW,CAAC,KAAK,EAAE,SAAiB,EAAE,QAAiB,EAAiB,EAAE;QAC/F,4FAA4F;QAC5F,6FAA6F;QAC7F,yFAAyF;QACzF,kFAAkF;QAClF,8FAA8F;QAC9F,+FAA+F;QAC/F,gEAAgE;QAChE,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,wBAAwB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACrF,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,+BAA+B,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAE9F,QAAQ,CAAC,gBAAgB,EAAE;YACzB,SAAS;YACT,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU;SACzD,CAAC,CAAC;QAEH,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YACrC,mBAAmB,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YACxC,OAAO;QACT,CAAC;QAED,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,iBAAiB,GAAG,mBAAmB;gBAC3C,CAAC,CAAC;oBACE,gBAAgB,EAAE,kCAAkC,CAAC,mCAAmC,CAAC,mBAAmB,CAAC;iBAC9G;gBACH,CAAC,CAAC,SAAS,CAAC;YACd,uFAAuF;YACvF,+EAA+E;YAC/E,mEAAmE;YACnE,MAAM,aAAa,GAA4B,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC;YACtE,KAAK,MAAM,kBAAkB,IAAI,uBAAuB,EAAE,CAAC;gBACzD,IACE,kBAAkB,KAAK,SAAS;uBAC7B,IAAI,IAAI,IAAI;uBACX,IAAgC,CAAC,kBAAkB,CAAC,KAAK,SAAS,EACtE,CAAC;oBACD,aAAa,CAAC,kBAAkB,CAAC,GAAI,IAAgC,CAAC,kBAAkB,CAAC,CAAC;gBAC5F,CAAC;YACH,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,aAAa,CACpC,aAAa,EACb;gBACE,IAAI,EAAE,YAAY,CAAC,MAAM;gBACzB,QAAQ,EAAE,gBAAgB,CAAC,GAAG;gBAC9B,MAAM,EAAE,EAAE,IAAI,EAAE,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE;gBAC5E,iBAAiB;aAClB,CACF,CAAC;YACF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,IAAI,uBAAuB,CAC/B,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,oBAAoB,EAC7C,MAAM,CAAC,KAAK,CACb,CAAC;YACJ,CAAC;YACD,mBAAmB,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YACxC,OAAO;QACT,CAAC;QAED,IACE,6BAA6B,CAAC,8BAA8B,CAAC;eAC1D,YAAY;eACZ,UAAU,EACb,CAAC;YACD,MAAM,eAAe,GAAG,4BAA4B,EAAE,CAAC;YACvD,IAAI,CAAC,eAAe,EAAE,CAAC;gBACrB,MAAM,IAAI,KAAK,CACb,gDAAgD,YAAY,KAAK;oBACjE,sDAAsD,CACvD,CAAC;YACJ,CAAC;YACD,MAAM,gBAAgB,GAAG,kCAAkC,CAAC,mCAAmC,CAAC,eAAe,CAAC,CAAC;YACjH,MAAM,eAAe,GAAG,qBAAqB,CAAC,iCAAiC,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;YACxG,MAAM,0BAA0B,GAAoC;gBAClE,GAAG,oBAAoB;gBACvB,CAAC,eAAe,CAAC,EAAE,UAAU;aAC9B,CAAC;YACF,MAAM,WAAW,CAAC,gBAAgB,EAAE;gBAClC,oBAAoB,EAAE,0BAA0B;gBAChD,2BAA2B;gBAC3B,WAAW,EAAE,4BAA4B,CAAC,IAAkD,EAAE,SAAS,EAAE,KAAK,CAAC;aAChH,CAAC,CAAC;YACH,mBAAmB,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YACxC,OAAO;QACT,CAAC;QAED,MAAM,IAAI,sBAAsB,CAAC;YAC/B,WAAW,EAAE,gCAAgC;YAC7C,YAAY,EAAE,YAAY,IAAI,SAAS;YACvC,mBAAmB,EAAE,mBAAmB,EAAE,mBAAmB,IAAI,qBAAqB,CAAC,MAAM;SAC9F,CAAC,CAAC;IACL,CAAC,EAAE;QACD,YAAY;QACZ,GAAG;QACH,YAAY;QACZ,UAAU;QACV,oBAAoB;QACpB,2BAA2B;QAC3B,WAAW;QACX,QAAQ;QACR,mBAAmB;QACnB,4BAA4B;QAC5B,8BAA8B;QAC9B,mBAAmB;QACnB,uBAAuB;QACvB,IAAI;QACJ,MAAM;KACP,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,CAAC,iBAAiB,IAAI,CAC1C,CAAC,CAAC,YAAY;WACX,CAAC,CAAC,GAAG;WACL,CACD,6BAA6B,CAAC,8BAA8B,CAAC;eAC1D,CAAC,CAAC,YAAY;eACd,CAAC,CAAC,UAAU;eACZ,kBAAkB,CACtB,CACF,CAAC;IAEF,uBAAuB;IAEvB,MAAM,2BAA2B,GAAG,OAAO,CAA8B,GAAG,EAAE,CAAC,CAAC;QAC9E,YAAY;QACZ,UAAU;QACV,cAAc;QACd,aAAa;QACb,iBAAiB;QACjB,iBAAiB;QACjB,iBAAiB;QACjB,oBAAoB;QACpB,0BAA0B;QAC1B,cAAc;QACd,qBAAqB;QACrB,GAAG;KACJ,CAAC,EAAE,CAAC,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,cAAc,EAAE,qBAAqB,EAAE,GAAG,CAAC,CAAC,CAAC;IAEtN,MAAM,2BAA2B,GAAG,OAAO,CAA8B,GAAG,EAAE,CAAC,CAAC;QAC9E,MAAM;QACN,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,IAAgC;QAC/D,SAAS;QACT,WAAW;QACX,iBAAiB;QACjB,aAAa;QACb,UAAU;QACV,aAAa;QACb,mBAAmB;QACnB,WAAW;QACX,wBAAwB;QACxB,UAAU,EAAE,kBAAkB;QAC9B,gBAAgB;QAChB,4BAA4B;QAC5B,yBAAyB;KAC1B,CAAC,EAAE;QACF,MAAM;QACN,IAAI;QACJ,SAAS;QACT,WAAW;QACX,iBAAiB;QACjB,aAAa;QACb,UAAU;QACV,aAAa;QACb,mBAAmB;QACnB,WAAW;QACX,wBAAwB;QACxB,kBAAkB;QAClB,gBAAgB;QAChB,4BAA4B;QAC5B,yBAAyB;KAC1B,CAAC,CAAC;IAEH,kCAAkC;IAElC,OAAO,CACL,KAAC,sBAAsB,CAAC,QAAQ,IAAC,KAAK,EAAE,2BAA2B,YACjE,KAAC,qBAAqB,IAAC,iBAAiB,EAAE,wBAAwB,YAChE,KAAC,uBAAuB,IAAC,KAAK,EAAE,2BAA2B,YACzD,cAAK,SAAS,EAAE,EAAE,CAAC,iBAAiB,EAAE,SAAS,CAAC,YAC7C,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,GACxD,GACkB,GACJ,GACQ,CACnC,CAAC;AACJ,CAAC;AAED,2BAA2B,CAAC,WAAW,GAAG,oBAAoB,CAAC;AAE/D,MAAM,CAAC,MAAM,kBAAkB,GAAiE,2BAA2B,CAAC","sourcesContent":["/**\n * AutomaticDisplayer Component\n *\n * Renders a display template inside a provider stack:\n *   ResourceDisplayContext → DisplayChromeContext → DisplayTemplateContext → template\n *\n * The template is a `React.ComponentType` instantiated inside `<DisplayTemplateProvider>`,\n * so it can call `useDisplayTemplateContext()` for `data`, `isLoading`, labels, etc.\n * The template is structurally stable (created from schema) and data-reactive\n * (context data changes trigger re-renders).\n *\n * Inline editing is wired through ResourceDisplayContext.\n */\n\nimport React, { useMemo, useCallback, useContext } from 'react';\nimport { z } from 'zod';\n\nimport type { FileActivationOperationDispatcher } from '~wildo-frontend-lib/components/data-display/useFileActivation';\nimport type { LayoutRefManifest, ResourceLayoutInlineEditDefault } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport type { FrontendResource_ParentResourceRequirement } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\nimport { CoreResourceOperation, ResourceOperationVariantType } from '@wildo-ai/saas-models';\nimport { ViewportBreakpoint, isDiscriminatorField, getObjectLikeFieldSchema, normalizeClearedMainSchemaValue } from '@wildo-ai/zod-decorators';\nimport type { DisplayChromeMode, ResponsiveAware, FileFieldEndpoints } from '@wildo-ai/zod-decorators';\nimport type { AutoEmptyValue } from '@wildo-ai/presets-components-models';\nimport { AutomatedLayoutFrontendUtils } from '~wildo-frontend-lib/core/automated-layout/automated-layout.frontend.utils';\n\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { frontendResourceUtils, FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { ResourcesConfig_OperationPathUtils } from '@wildo-ai/saas-models';\nimport type { ResourceMutationManager } from '~wildo-frontend-lib/core/resources/rmm/ResourceMutationManager';\nimport { MutationType, MutationPriority, MutationSourceType } from '~wildo-frontend-lib/core/resources/rmm/types';\nimport {\n  allowsDirectOperationFallback,\n  MissingRMMRuntimeError,\n  UpdateLikeMutationFallbackMode,\n} from '~wildo-frontend-lib/core/resources/rmm/update-like-mutation-fallback.frontend';\nimport { UIContext } from '~wildo-frontend-lib/core/ui/UIContext';\nimport { useResourceLabels } from '~wildo-frontend-lib/core/resources/useResourceLabels';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport type { NavigationZone } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport type { FrontendResourceConfiguration_Operation } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { pickInlineFieldWriteOperation } from '~wildo-frontend-lib/core/resources/resource-addressability.frontend.utils';\n\nimport {\n  ResourceDisplayContext,\n  InlineEditMutationError,\n  type ResourceDisplayContextValue,\n  type ParentReferenceConfig,\n} from './automatic-displayer.utils';\nimport { buildInlineUpdateRequestData } from './display-field-resolution.utils';\n\nimport { DisplayChromeProvider } from './chromes/DisplayChromeContext';\nimport { DisplayTemplateProvider, type DisplayTemplateContextValue } from './DisplayTemplateContext';\nimport type { ContainerSectionMode } from '@wildo-ai/zod-decorators';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('AutomaticDisplayer');\nlogger.setDebugTypeLogging('AutomaticDisplayer', false);\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\nexport interface AutomaticDisplayerLabels {\n  resourceContext?: { resourceType: string; operationId: string };\n  /**\n   * Resolve this schema's labels as if its fields sat at `<fieldPathPrefix>.<path>` in the resource.\n   *\n   * For a surface rendering the ITEM SHAPE of a collection that lives elsewhere in the owning\n   * resource — see `UseResourceLabelsOptions.fieldPathPrefix` for the full reasoning (#638).\n   */\n  fieldPathPrefix?: string;\n  fields?: Record<string, string>;\n  enums?: Record<string, Record<string, string>>;\n  sections?: Record<string, { titleKey?: string; descriptionKey?: string }>;\n}\n\nexport interface AutomaticDisplayerProps<TSchema extends z.ZodTypeAny> {\n  schema: TSchema;\n  data: z.infer<TSchema>;\n  className?: string;\n  labels?: AutomaticDisplayerLabels;\n\n  /** Layout ref manifest for i18n label resolution of sections/groups. */\n  layoutRefs?: LayoutRefManifest;\n\n  resourceType?: string;\n  resourceId?: string;\n  contextualParameters?: Record<string, string | number>;\n  contextResourceIdentifiers?: Record<string, string | { fieldIdentifier: string; resourceId: string }>;\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n  navigationZone?: NavigationZone;\n  inlineEditOperation?: FrontendResourceConfiguration_Operation | null;\n  parentReferenceConfig?: ParentReferenceConfig;\n  /**\n   * Caller-owned weaker-guarantee override for inline edit.\n   *\n   * Providing this hook bypasses the default RMM-backed engine path. The caller\n   * becomes responsible for any queueing, conflict handling, canonical read-back,\n   * and broader coherence guarantees they still want to preserve.\n   */\n  onInlineEdit?: (fieldName: string, value: unknown) => Promise<void>;\n  disableInlineEdit?: boolean;\n  fileUploadContext?: Record<string, FileFieldEndpoints>;\n  onInlineEditSuccess?: (fieldName: string, value: unknown) => void;\n  rmm?: ResourceMutationManager | null;\n  /**\n   * Controls whether inline edit may downgrade to a direct UPDATE operation when\n   * RMM is unavailable. Defaults to `RMM_REQUIRED` so generic engine inline edit\n   * does not silently pretend to be RMM-backed.\n   *\n   * The richer conflict-reset UX is only guaranteed on the single-resource\n   * RMM-backed lane where the backend supplies authoritative nested\n   * `versionConflict` details. Explicit direct fallback remains a weaker-\n   * guarantee path.\n   */\n  updateLikeMutationFallbackMode?: UpdateLikeMutationFallbackMode;\n\n  /**\n   * The display template to render — a `React.ComponentType` instantiated inside\n   * `<DisplayTemplateProvider>`. The component can call `useDisplayTemplateContext()`\n   * to access `data`, `isLoading`, labels, and breakpoint.\n   */\n  layoutTemplate: React.ComponentType | null;\n\n  /**\n   * Whether data is still loading. When true, DisplayField renders skeletons (DD-9).\n   * @default false\n   */\n  isLoading?: boolean;\n\n  /**\n   * Default chrome mode for display fields from `ResourceLayoutConfig.defaultChromeMode.display`.\n   * Propagated to `DisplayChromeProvider.displayChromeMode`.\n   */\n  defaultDisplayChromeMode?: ResponsiveAware<DisplayChromeMode>;\n\n  /**\n   * The layout's inline-edit default, from `ResourceLayoutConfig.defaultInlineEdit`.\n   * Forwarded opaquely into `ResourceDisplayContext` for `DisplayField` to consult — this component\n   * is resource-unaware and never reads the resource config itself.\n   */\n  defaultInlineEdit?: ResourceLayoutInlineEditDefault;\n\n  /**\n   * The layout's empty-value strategy, from `ResourceLayoutConfig.defaultEmptyValue`.\n   * Forwarded opaquely into `ResourceDisplayContext`; this component reads no resource config.\n   */\n  defaultEmptyValue?: AutoEmptyValue;\n  /**\n   * The layout's DISPLAY section container mode, from\n   * `ResourceLayoutConfig.defaultDisplaySectionAppearance`. Adopted by a `<Section>` that declares\n   * no `appearance` of its own; a section that declares one still wins.\n   */\n  defaultSectionAppearance?: ContainerSectionMode;\n\n  /**\n   * Opaque upstream shaping input for automatic READ templates.\n   * Resource-aware wrappers can hide duplicate relationship-backed fields\n   * without teaching generic display components relationship semantics.\n   */\n  hiddenFieldNames?: string[];\n\n  /**\n   * Opaque upstream shaping input for automatic READ templates.\n   * Keeps generic inline edit fail-closed for relationship object/array slots.\n   */\n  inlineEditDisabledFieldNames?: string[];\n  /**\n   * Dispatcher for `FileActivationPolicy.CUSTOM` file activations — supplied by the\n   * resource-aware host, forwarded opaquely into `DisplayTemplateContext` for the\n   * generic file displayer. Absent under a non-resource host.\n   */\n  onFileActivationOperation?: FileActivationOperationDispatcher;\n\n}\n\n// =============================================================================\n// COMPONENT\n// =============================================================================\n\nfunction AutomaticDisplayerComponent<TSchema extends z.ZodTypeAny>({\n  schema,\n  data,\n  className,\n  labels,\n  layoutRefs,\n  resourceType,\n  resourceId,\n  contextualParameters,\n  contextResourceIdentifiers,\n  parentResourcesRequirements,\n  navigationZone,\n  inlineEditOperation,\n  parentReferenceConfig,\n  onInlineEdit,\n  disableInlineEdit = false,\n  fileUploadContext,\n  onInlineEditSuccess,\n  rmm,\n  updateLikeMutationFallbackMode = UpdateLikeMutationFallbackMode.RMM_REQUIRED,\n  layoutTemplate,\n  isLoading = false,\n  defaultDisplayChromeMode,\n  defaultInlineEdit,\ndefaultEmptyValue,\n  defaultSectionAppearance,\n  hiddenFieldNames,\n  inlineEditDisabledFieldNames,\n  onFileActivationOperation,\n}: AutomaticDisplayerProps<TSchema>): React.JSX.Element {\n  const { doOperation, registry } = useResourceRegistry();\n\n  // ── Breakpoint resolution ──\n  const uiContext = useContext(UIContext);\n  const viewportBreakpoint: ViewportBreakpoint = uiContext?.UIConfig?.currentBreakpoint ?? ViewportBreakpoint.DESKTOP;\n\n  // ── Labels from i18n ──\n  const {\n    fieldLabels,\n    fieldDescriptions,\n    fieldTooltips,\n    enumLabels,\n    sectionLabels,\n    sectionDescriptions,\n    groupLabels,\n  } = useResourceLabels(\n    schema,\n    labels?.resourceContext,\n    data as Record<string, unknown>,\n    'display',\n    {\n      layoutRefs,\n      fieldPathPrefix: labels?.fieldPathPrefix,\n      overrides: {\n        fields: labels?.fields,\n        enums: labels?.enums,\n        sections: labels?.sections,\n      },\n    },\n  );\n\n  // ── Inline editing ──\n\n  const resolveInlineUpdateOperation = useCallback((): FrontendResourceConfiguration_Operation | null => {\n    if (inlineEditOperation === null) {\n      return null;\n    }\n    if (inlineEditOperation !== undefined) {\n      const isUrlBearingOperation = inlineEditOperation.variantType === ResourceOperationVariantType.API_CALL\n        || inlineEditOperation.variantType === ResourceOperationVariantType.API_CALL_WITH_CALLBACK;\n      const effectiveOperation = inlineEditOperation.resourceOperationLike ?? inlineEditOperation.operationIdentifier;\n      // The LITERAL `update`, never a custom verb that borrows UPDATE semantics. `effectiveOperation`\n      // alone admits `claimDomain`, `moveUnit`, `archive` — each a real, non-bulk, URL-bearing PUT that\n      // satisfies every other clause here, and each with its OWN request contract. A field value sent\n      // to one of them is a malformed call to a different action, not a partial update of the record.\n      const isLiteralUpdateOperation = inlineEditOperation.operationIdentifier === CoreResourceOperation.UPDATE;\n      if (!isUrlBearingOperation || !isLiteralUpdateOperation || inlineEditOperation.isBulkOperation === true || effectiveOperation !== CoreResourceOperation.UPDATE) {\n        logDebug('Rejected invalid inlineEditOperation', {\n          operationIdentifier: String(inlineEditOperation.operationIdentifier),\n          variantType: inlineEditOperation.variantType,\n          variantKey: inlineEditOperation.variantKey,\n          isBulkOperation: inlineEditOperation.isBulkOperation,\n          effectiveOperation: String(effectiveOperation),\n        });\n        throw new InlineEditMutationError(\n          'inlineEditOperation must be the non-bulk URL-bearing literal UPDATE operation, not a custom verb borrowing UPDATE semantics',\n        );\n      }\n      return inlineEditOperation;\n    }\n    if (!resourceType || !resourceId) {\n      return null;\n    }\n\n    const resourceConfig = registry.resourceConfigurations[resourceType];\n    if (!resourceConfig) {\n      return null;\n    }\n\n    const fieldIdentifier = FrontendResourceUtils.getResourceFieldIdentifierForType(resourceType, registry);\n    const updateContextResourceIdentifiers = {\n      ...(contextResourceIdentifiers ?? {}),\n      [resourceType]: resourceId,\n    };\n    const updateContextualParameters = {\n      ...(contextualParameters ?? {}),\n      [fieldIdentifier]: resourceId,\n    };\n\n    return pickInlineFieldWriteOperation({\n      resourceConfig,\n      operations: resourceConfig.operations ?? [],\n      registry,\n      hasResourceId: frontendResourceUtils.getResourceId(updateContextResourceIdentifiers[resourceType]).length > 0,\n      requireFrontendAddressable: true,\n      contextResourceIdentifiers: updateContextResourceIdentifiers,\n      contextualParameters: updateContextualParameters,\n    }) ?? null;\n  }, [contextResourceIdentifiers, contextualParameters, inlineEditOperation, registry, resourceId, resourceType]);\n\n  const hasUpdateOperation = useMemo(() => {\n    return resolveInlineUpdateOperation() !== null;\n  }, [resolveInlineUpdateOperation]);\n\n  // Discriminator field name(s) for this resource. A discriminated-union (polymorphic)\n  // resource keeps its discriminator REQUIRED on the UPDATE requestDto (it selects the\n  // variant the body is validated against), so every PARTIAL inline update must carry it —\n  // otherwise the backend rejects the update with `<discriminator>: Invalid input`. Resolved\n  // from the display schema's COMMON shape (the discriminator is shared across all variants).\n  const discriminatorFieldNames = useMemo<string[]>(() => {\n    try {\n      const commonShape = AutomatedLayoutFrontendUtils.getObjectLikeFieldShape(schema, { commonOnly: true }) ?? {};\n      return Object.entries(commonShape)\n        .filter(([, fieldSchema]) => isDiscriminatorField(fieldSchema as z.ZodTypeAny))\n        .map(([discriminatorField]) => discriminatorField);\n    } catch {\n      return [];\n    }\n  }, [schema]);\n\n  const doInlineUpdate = useCallback(async (fieldName: string, rawValue: unknown): Promise<void> => {\n    // FIELD-CLEARING CONTRACT — inline edit builds its payload outside the form entirely, so it\n    // does not pass through `FormField`'s change handler and has to apply the same normalisation\n    // itself. Without it, emptying a field inline sends `''` (persisting an empty string, or\n    // failing validation on a refined field) instead of the clear the user asked for.\n    // This surface holds the resource's MAIN schema, so it uses the main-schema entry point: on a\n    // main schema an `.optional()` field does not accept null, and asking the request-DTO question\n    // here would report every ordinary optional field un-clearable.\n    const fieldSchema = schema ? getObjectLikeFieldSchema(schema, fieldName) : undefined;\n    const value = fieldSchema ? normalizeClearedMainSchemaValue(fieldSchema, rawValue) : rawValue;\n\n    logDebug('doInlineUpdate', {\n      fieldName,\n      path: onInlineEdit ? 'custom' : rmm ? 'rmm' : 'fallback',\n    });\n\n    if (onInlineEdit) {\n      await onInlineEdit(fieldName, value);\n      onInlineEditSuccess?.(fieldName, value);\n      return;\n    }\n\n    if (rmm) {\n      const transportOverride = inlineEditOperation\n        ? {\n            operationPathKey: ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(inlineEditOperation),\n          }\n        : undefined;\n      // Carry the current discriminator value(s) from `data` alongside the edited field so a\n      // discriminated-union resource's partial UPDATE selects the right variant (see\n      // `discriminatorFieldNames`). No-op for non-polymorphic resources.\n      const inlineRequest: Record<string, unknown> = { [fieldName]: value };\n      for (const discriminatorField of discriminatorFieldNames) {\n        if (\n          discriminatorField !== fieldName\n          && data != null\n          && (data as Record<string, unknown>)[discriminatorField] !== undefined\n        ) {\n          inlineRequest[discriminatorField] = (data as Record<string, unknown>)[discriminatorField];\n        }\n      }\n      const result = await rmm.queueMutation(\n        inlineRequest,\n        {\n          type: MutationType.INLINE,\n          priority: MutationPriority.LOW,\n          source: { type: MutationSourceType.DISPLAY, subscriberId: 'display-inline' },\n          transportOverride,\n        },\n      );\n      if (!result.success) {\n        throw new InlineEditMutationError(\n          result.error?.message ?? 'Inline edit failed',\n          result.error,\n        );\n      }\n      onInlineEditSuccess?.(fieldName, value);\n      return;\n    }\n\n    if (\n      allowsDirectOperationFallback(updateLikeMutationFallbackMode)\n      && resourceType\n      && resourceId\n    ) {\n      const updateOperation = resolveInlineUpdateOperation();\n      if (!updateOperation) {\n        throw new Error(\n          `No UPDATE operation configured for resource \"${resourceType}\". ` +\n          `Inline editing requires an UPDATE.default operation.`\n        );\n      }\n      const operationPathKey = ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(updateOperation);\n      const fieldIdentifier = FrontendResourceUtils.getResourceFieldIdentifierForType(resourceType, registry);\n      const mergedContextualParameters: Record<string, string | number> = {\n        ...contextualParameters,\n        [fieldIdentifier]: resourceId,\n      };\n      await doOperation(operationPathKey, {\n        contextualParameters: mergedContextualParameters,\n        parentResourcesRequirements,\n        requestData: buildInlineUpdateRequestData(data as Record<string, unknown> | null | undefined, fieldName, value),\n      });\n      onInlineEditSuccess?.(fieldName, value);\n      return;\n    }\n\n    throw new MissingRMMRuntimeError({\n      surfaceName: 'AutomaticDisplayer inline edit',\n      resourceType: resourceType ?? 'unknown',\n      operationIdentifier: inlineEditOperation?.operationIdentifier ?? CoreResourceOperation.UPDATE,\n    });\n  }, [\n    onInlineEdit,\n    rmm,\n    resourceType,\n    resourceId,\n    contextualParameters,\n    parentResourcesRequirements,\n    doOperation,\n    registry,\n    onInlineEditSuccess,\n    resolveInlineUpdateOperation,\n    updateLikeMutationFallbackMode,\n    inlineEditOperation,\n    discriminatorFieldNames,\n    data,\n    schema,\n  ]);\n\n  const canInlineEdit = !disableInlineEdit && (\n    !!onInlineEdit\n    || !!rmm\n    || (\n      allowsDirectOperationFallback(updateLikeMutationFallbackMode)\n      && !!resourceType\n      && !!resourceId\n      && hasUpdateOperation\n    )\n  );\n\n  // ── Context values ──\n\n  const resourceDisplayContextValue = useMemo<ResourceDisplayContextValue>(() => ({\n    resourceType,\n    resourceId,\n    doInlineUpdate,\n    canInlineEdit,\n    defaultInlineEdit,\n    defaultEmptyValue,\n    fileUploadContext,\n    contextualParameters,\n    contextResourceIdentifiers,\n    navigationZone,\n    parentReferenceConfig,\n    rmm,\n  }), [resourceType, resourceId, doInlineUpdate, canInlineEdit, defaultInlineEdit, defaultEmptyValue, fileUploadContext, contextualParameters, contextResourceIdentifiers, navigationZone, parentReferenceConfig, rmm]);\n\n  const displayTemplateContextValue = useMemo<DisplayTemplateContextValue>(() => ({\n    schema,\n    data: isLoading ? undefined : (data as Record<string, unknown>),\n    isLoading,\n    fieldLabels,\n    fieldDescriptions,\n    fieldTooltips,\n    enumLabels,\n    sectionLabels,\n    sectionDescriptions,\n    groupLabels,\n    defaultSectionAppearance,\n    breakpoint: viewportBreakpoint,\n    hiddenFieldNames,\n    inlineEditDisabledFieldNames,\n    onFileActivationOperation,\n  }), [\n    schema,\n    data,\n    isLoading,\n    fieldLabels,\n    fieldDescriptions,\n    fieldTooltips,\n    enumLabels,\n    sectionLabels,\n    sectionDescriptions,\n    groupLabels,\n    defaultSectionAppearance,\n    viewportBreakpoint,\n    hiddenFieldNames,\n    inlineEditDisabledFieldNames,\n    onFileActivationOperation,\n  ]);\n\n  // ── Provider stack → template ──\n\n  return (\n    <ResourceDisplayContext.Provider value={resourceDisplayContextValue}>\n      <DisplayChromeProvider displayChromeMode={defaultDisplayChromeMode}>\n        <DisplayTemplateProvider value={displayTemplateContextValue}>\n          <div className={cn('space-y-section', className)}>\n            {layoutTemplate ? React.createElement(layoutTemplate) : null}\n          </div>\n        </DisplayTemplateProvider>\n      </DisplayChromeProvider>\n    </ResourceDisplayContext.Provider>\n  );\n}\n\nAutomaticDisplayerComponent.displayName = 'AutomaticDisplayer';\n\nexport const AutomaticDisplayer: typeof AutomaticDisplayerComponent & { displayName: string } = AutomaticDisplayerComponent;\n"]}