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

package/dist/esm/core/resources/useAuthedFileObjectUrl.frontend.hook.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAuthedFileObjectUrl.frontend.hook.js","sourceRoot":"","sources":["../../../../src/core/resources/useAuthedFileObjectUrl.frontend.hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AAEjF,MAAM,UAAU,sBAAsB,CAAC,QAAmC;IACxE,MAAM,EAAE,UAAU,EAAE,GAAG,cAAc,EAAE,CAAC;IACxC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAEhE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,YAAY,CAAC,IAAI,CAAC,CAAC;YACnB,OAAO;QACT,CAAC;QACD,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,OAAO,GAAkB,IAAI,CAAC;QAClC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,UAAU;aACP,aAAa,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;aACtD,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;YACb,IAAI,SAAS;gBAAE,OAAO;YACtB,OAAO,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACpC,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE;YACV,IAAI,CAAC,SAAS;gBAAE,YAAY,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QACL,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;YACjB,UAAU,CAAC,KAAK,EAAE,CAAC;YACnB,IAAI,OAAO;gBAAE,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAC5C,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;IAE3B,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["/**\n * Fetch a protected file's bytes over the AUTHENTICATED client and expose them as an\n * object URL suitable for an `<img>` / `<embed>` `src`.\n *\n * An `<img>` cannot attach the bearer token, so a protected serve URL can't be loaded\n * directly. This hook fetches the bytes (`WildoBackendHttpClient.fetchFileBlob` — the\n * backend serve route authorizes via the linked resource's READ) and wraps the Blob in\n * `URL.createObjectURL`, revoking it and aborting the request on unmount / url change.\n *\n * Returns `null` while loading, when `serveUrl` is absent, or on failure — so callers\n * degrade to their own placeholder (e.g. initials). Use in any saas-frontend-lib surface\n * that renders a file preview outside the resource displayer (e.g. the nav user-menu\n * avatar). Inside the presets file components, prefer the injected `httpOperations.getBlob`\n * (keeps presets off the HTTP client).\n */\nimport { useEffect, useState } from 'react';\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\n\nexport function useAuthedFileObjectUrl(serveUrl: string | null | undefined): string | null {\n  const { httpClient } = useApplication();\n  const [objectUrl, setObjectUrl] = useState<string | null>(null);\n\n  useEffect(() => {\n    if (!serveUrl) {\n      setObjectUrl(null);\n      return;\n    }\n    let cancelled = false;\n    let created: string | null = null;\n    const controller = new AbortController();\n    httpClient\n      .fetchFileBlob(serveUrl, { signal: controller.signal })\n      .then((blob) => {\n        if (cancelled) return;\n        created = URL.createObjectURL(blob);\n        setObjectUrl(created);\n      })\n      .catch(() => {\n        if (!cancelled) setObjectUrl(null);\n      });\n    return () => {\n      cancelled = true;\n      controller.abort();\n      if (created) URL.revokeObjectURL(created);\n    };\n  }, [serveUrl, httpClient]);\n\n  return objectUrl;\n}\n"]}
+{"version":3,"file":"useAuthedFileObjectUrl.frontend.hook.js","sourceRoot":"","sources":["../../../../../src/core/resources/useAuthedFileObjectUrl.frontend.hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AAEjF,MAAM,UAAU,sBAAsB,CAAC,QAAmC;IACxE,MAAM,EAAE,UAAU,EAAE,GAAG,cAAc,EAAE,CAAC;IACxC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAEhE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,YAAY,CAAC,IAAI,CAAC,CAAC;YACnB,OAAO;QACT,CAAC;QACD,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,OAAO,GAAkB,IAAI,CAAC;QAClC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,UAAU;aACP,aAAa,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;aACtD,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;YACb,IAAI,SAAS;gBAAE,OAAO;YACtB,OAAO,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACpC,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE;YACV,IAAI,CAAC,SAAS;gBAAE,YAAY,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QACL,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;YACjB,UAAU,CAAC,KAAK,EAAE,CAAC;YACnB,IAAI,OAAO;gBAAE,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAC5C,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;IAE3B,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["/**\n * Fetch a protected file's bytes over the AUTHENTICATED client and expose them as an\n * object URL suitable for an `<img>` / `<embed>` `src`.\n *\n * An `<img>` cannot attach the bearer token, so a protected serve URL can't be loaded\n * directly. This hook fetches the bytes (`WildoBackendHttpClient.fetchFileBlob` — the\n * backend serve route authorizes via the linked resource's READ) and wraps the Blob in\n * `URL.createObjectURL`, revoking it and aborting the request on unmount / url change.\n *\n * Returns `null` while loading, when `serveUrl` is absent, or on failure — so callers\n * degrade to their own placeholder (e.g. initials). Use in any saas-frontend-lib surface\n * that renders a file preview outside the resource displayer (e.g. the nav user-menu\n * avatar). Inside the presets file components, prefer the injected `httpOperations.getBlob`\n * (keeps presets off the HTTP client).\n */\nimport { useEffect, useState } from 'react';\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\n\nexport function useAuthedFileObjectUrl(serveUrl: string | null | undefined): string | null {\n  const { httpClient } = useApplication();\n  const [objectUrl, setObjectUrl] = useState<string | null>(null);\n\n  useEffect(() => {\n    if (!serveUrl) {\n      setObjectUrl(null);\n      return;\n    }\n    let cancelled = false;\n    let created: string | null = null;\n    const controller = new AbortController();\n    httpClient\n      .fetchFileBlob(serveUrl, { signal: controller.signal })\n      .then((blob) => {\n        if (cancelled) return;\n        created = URL.createObjectURL(blob);\n        setObjectUrl(created);\n      })\n      .catch(() => {\n        if (!cancelled) setObjectUrl(null);\n      });\n    return () => {\n      cancelled = true;\n      controller.abort();\n      if (created) URL.revokeObjectURL(created);\n    };\n  }, [serveUrl, httpClient]);\n\n  return objectUrl;\n}\n"]}

package/dist/esm/core/resources/useBulkJobProgress.d.ts

@@ -0,0 +1,22 @@
+export interface BulkJobFailure {
+    resourceId: string;
+    customMessageReference?: string;
+    errorType?: string;
+}
+export interface BulkJobProgress {
+    jobId: string;
+    attemptedCount: number;
+    processedCount: number;
+    failedCount: number;
+    finished: boolean;
+    /**
+     * WHICH rows were refused. Arrives with the final event, and is a SAMPLE when the run refused
+     * more than the wire cap — `failedCount` stays exact, and the complete list is in the job result.
+     */
+    failures: BulkJobFailure[];
+}
+export declare function useBulkJobProgress(run: {
+    jobId: string;
+    attemptedCount: number;
+} | null): BulkJobProgress | null;
+//# sourceMappingURL=useBulkJobProgress.d.ts.map

package/dist/esm/core/resources/useBulkJobProgress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBulkJobProgress.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/useBulkJobProgress.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,eAAe,GAAG,IAAI,CAqChH"}

package/dist/esm/core/resources/useBulkJobProgress.js

@@ -0,0 +1,51 @@
+/**
+ * Follow a background BULK run started by this surface (#1461).
+ *
+ * The run's rows change one at a time and each broadcasts its own sync event, so the listing
+ * updates itself while the job works. What this adds is HOW MUCH IS LEFT: the server addresses
+ * progress to the person who started the run, the websocket bridge puts it on the event bus like
+ * every other socket-borne fact, and this reads the ones carrying our own `jobId`.
+ *
+ * Progress counts rows the run has FINISHED with, refusals included — `processed / attempted` is
+ * how far it has got, not how well it is going. `finished` comes from the server rather than from
+ * comparing the counts: a run that ends early would otherwise leave a bar just short of full with
+ * nothing to say it had stopped.
+ */
+import { useEffect, useState } from 'react';
+import { useEventBus } from '../../core/events/useEventBus.js';
+import { FrontendEvents } from '../../core/events/events.frontend.schemas.js';
+export function useBulkJobProgress(run) {
+    const { on } = useEventBus();
+    const [progress, setProgress] = useState(null);
+    // The effect keys on the PRIMITIVES, never on the object. A caller that builds `{ jobId,
+    // attemptedCount }` inline hands a fresh reference every render, and an effect depending on the
+    // object would re-subscribe, set state, re-render, and loop — measured, as an out-of-memory
+    // worker the first time this hook was pinned.
+    const jobId = run?.jobId ?? null;
+    const attemptedCount = run?.attemptedCount ?? 0;
+    useEffect(() => {
+        if (!jobId) {
+            setProgress(null);
+            return;
+        }
+        // Seeded from what the bar ASKED for, so the surface can draw an honest empty bar in the window
+        // between the acceptance and the first progress event — which is exactly the window a person
+        // spends wondering whether anything happened.
+        setProgress({ jobId, attemptedCount, processedCount: 0, failedCount: 0, finished: false, failures: [] });
+        return on(FrontendEvents.BULK_JOB_PROGRESS, (payload) => {
+            // One person may start several runs; only ours is ours.
+            if (payload.jobId !== jobId)
+                return;
+            setProgress({
+                jobId: payload.jobId,
+                attemptedCount: payload.attemptedCount,
+                processedCount: payload.processedCount,
+                failedCount: payload.failedCount,
+                finished: payload.finished,
+                failures: payload.failures ?? [],
+            });
+        });
+    }, [on, jobId, attemptedCount]);
+    return progress;
+}
+//# sourceMappingURL=useBulkJobProgress.js.map

package/dist/esm/core/resources/useBulkJobProgress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBulkJobProgress.js","sourceRoot":"","sources":["../../../../../src/core/resources/useBulkJobProgress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAqC,MAAM,yDAAyD,CAAC;AAqB5H,MAAM,UAAU,kBAAkB,CAAC,GAAqD;IACtF,MAAM,EAAE,EAAE,EAAE,GAAG,WAAW,EAAE,CAAC;IAC7B,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAyB,IAAI,CAAC,CAAC;IAEvE,yFAAyF;IACzF,gGAAgG;IAChG,4FAA4F;IAC5F,8CAA8C;IAC9C,MAAM,KAAK,GAAG,GAAG,EAAE,KAAK,IAAI,IAAI,CAAC;IACjC,MAAM,cAAc,GAAG,GAAG,EAAE,cAAc,IAAI,CAAC,CAAC;IAEhD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,WAAW,CAAC,IAAI,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QAED,gGAAgG;QAChG,6FAA6F;QAC7F,8CAA8C;QAC9C,WAAW,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QAEzG,OAAO,EAAE,CAAC,cAAc,CAAC,iBAAiB,EAAE,CAAC,OAAqC,EAAE,EAAE;YACpF,wDAAwD;YACxD,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK;gBAAE,OAAO;YACpC,WAAW,CAAC;gBACV,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,cAAc,EAAE,OAAO,CAAC,cAAc;gBACtC,cAAc,EAAE,OAAO,CAAC,cAAc;gBACtC,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;aACjC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC;IAEhC,OAAO,QAAQ,CAAC;AAClB,CAAC","sourcesContent":["/**\n * Follow a background BULK run started by this surface (#1461).\n *\n * The run's rows change one at a time and each broadcasts its own sync event, so the listing\n * updates itself while the job works. What this adds is HOW MUCH IS LEFT: the server addresses\n * progress to the person who started the run, the websocket bridge puts it on the event bus like\n * every other socket-borne fact, and this reads the ones carrying our own `jobId`.\n *\n * Progress counts rows the run has FINISHED with, refusals included — `processed / attempted` is\n * how far it has got, not how well it is going. `finished` comes from the server rather than from\n * comparing the counts: a run that ends early would otherwise leave a bar just short of full with\n * nothing to say it had stopped.\n */\nimport { useEffect, useState } from 'react';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { FrontendEvents, type FrontendEventBulkJobProgress } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\n\nexport interface BulkJobFailure {\n  resourceId: string;\n  customMessageReference?: string;\n  errorType?: string;\n}\n\nexport interface BulkJobProgress {\n  jobId: string;\n  attemptedCount: number;\n  processedCount: number;\n  failedCount: number;\n  finished: boolean;\n  /**\n   * WHICH rows were refused. Arrives with the final event, and is a SAMPLE when the run refused\n   * more than the wire cap — `failedCount` stays exact, and the complete list is in the job result.\n   */\n  failures: BulkJobFailure[];\n}\n\nexport function useBulkJobProgress(run: { jobId: string; attemptedCount: number } | null): BulkJobProgress | null {\n  const { on } = useEventBus();\n  const [progress, setProgress] = useState<BulkJobProgress | null>(null);\n\n  // The effect keys on the PRIMITIVES, never on the object. A caller that builds `{ jobId,\n  // attemptedCount }` inline hands a fresh reference every render, and an effect depending on the\n  // object would re-subscribe, set state, re-render, and loop — measured, as an out-of-memory\n  // worker the first time this hook was pinned.\n  const jobId = run?.jobId ?? null;\n  const attemptedCount = run?.attemptedCount ?? 0;\n\n  useEffect(() => {\n    if (!jobId) {\n      setProgress(null);\n      return;\n    }\n\n    // Seeded from what the bar ASKED for, so the surface can draw an honest empty bar in the window\n    // between the acceptance and the first progress event — which is exactly the window a person\n    // spends wondering whether anything happened.\n    setProgress({ jobId, attemptedCount, processedCount: 0, failedCount: 0, finished: false, failures: [] });\n\n    return on(FrontendEvents.BULK_JOB_PROGRESS, (payload: FrontendEventBulkJobProgress) => {\n      // One person may start several runs; only ours is ours.\n      if (payload.jobId !== jobId) return;\n      setProgress({\n        jobId: payload.jobId,\n        attemptedCount: payload.attemptedCount,\n        processedCount: payload.processedCount,\n        failedCount: payload.failedCount,\n        finished: payload.finished,\n        failures: payload.failures ?? [],\n      });\n    });\n  }, [on, jobId, attemptedCount]);\n\n  return progress;\n}\n"]}

package/dist/esm/core/resources/useHostlessResourceNavigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useHostlessResourceNavigation.d.ts","sourceRoot":"","sources":["../../../../src/core/resources/useHostlessResourceNavigation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAQH,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,8BAA8B,CAAC;AAErF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wDAAwD,CAAC;AAEzG,MAAM,WAAW,oCAAoC;IACnD,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,0BAA0B,CAAC,EAAE,gCAAgC,CAAC,4BAA4B,CAAC,CAAC;IAC5F;;;;OAIG;IACH,UAAU,CAAC,EAAE,0BAA0B,CAAC,YAAY,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,0BAA0B;IACzC;;;;;;;;OAQG;IACH,sBAAsB,EAAE,CAAC,MAAM,EAAE,oCAAoC,KAAK,OAAO,CAAC;CACnF;AAED,wBAAgB,6BAA6B,IAAI,0BAA0B,CAwD1E"}
+{"version":3,"file":"useHostlessResourceNavigation.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/useHostlessResourceNavigation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAQH,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,8BAA8B,CAAC;AAErF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wDAAwD,CAAC;AAEzG,MAAM,WAAW,oCAAoC;IACnD,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,0BAA0B,CAAC,EAAE,gCAAgC,CAAC,4BAA4B,CAAC,CAAC;IAC5F;;;;OAIG;IACH,UAAU,CAAC,EAAE,0BAA0B,CAAC,YAAY,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,0BAA0B;IACzC;;;;;;;;OAQG;IACH,sBAAsB,EAAE,CAAC,MAAM,EAAE,oCAAoC,KAAK,OAAO,CAAC;CACnF;AAED,wBAAgB,6BAA6B,IAAI,0BAA0B,CAwD1E"}

package/dist/esm/core/resources/useHostlessResourceNavigation.js.map

@@ -1 +1 @@
-{"version":3,"file":"useHostlessResourceNavigation.js","sourceRoot":"","sources":["../../../../src/core/resources/useHostlessResourceNavigation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAElF,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,EAAE,mDAAmD,EAAE,MAAM,0CAA0C,CAAC;AAE/G,OAAO,EAAE,uBAAuB,EAAE,MAAM,6DAA6D,CAAC;AAmCtG,MAAM,UAAU,6BAA6B;IAC3C,MAAM,EAAE,QAAQ,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAC3C,MAAM,EAAE,kBAAkB,EAAE,GAAG,uBAAuB,EAAE,CAAC;IAEzD,MAAM,sBAAsB,GAAG,WAAW,CAAC,CAAC,MAA4C,EAAW,EAAE;QACnG,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,0BAA0B,GAAG,EAAE,EAAE,UAAU,GAAG,kBAAkB,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC;QACtH,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,cAAc,GAAG,QAAQ,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC;QACrE,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,gCAAgC,GAAG;YACvC,GAAG,0BAA0B;YAC7B,CAAC,YAAY,CAAC,EAAE,UAAU;SAC3B,CAAC;QAEF;;;;;;WAMG;QACH,MAAM,aAAa,GAAG,mDAAmD,CAAC;YACxE,cAAc;YACd,UAAU,EAAE,cAAc,CAAC,UAAU,IAAI,EAAE;YAC3C,aAAa,EAAE,qBAAqB,CAAC,IAAI;YACzC,QAAQ;YACR,aAAa,EAAE,IAAI;YACnB,0BAA0B,EAAE,IAAI;YAChC,0BAA0B,EAAE,gCAAgC;YAC5D,oBAAoB,EAAE,qBAAqB,CAAC,yBAAyB,CACnE,gCAAgC,EAChC,QAAQ,CACT;SACF,CAAC,CAAC;QACH,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,kBAAkB,CAChB,qBAAqB,CAAC,mDAAmD,CAAC;YACxE,YAAY;YACZ,SAAS,EAAE,aAAa;YACxB,0BAA0B,EAAE,gCAAgC;SAC7D,CAAC,EACF,EAAE,UAAU,EAAE,eAAe,EAAE,qBAAqB,CAAC,IAAI,EAAE,CAC5D,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAEnC,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,sBAAsB,EAAE,CAAC,EAAE,CAAC,sBAAsB,CAAC,CAAC,CAAC;AAC/E,CAAC","sourcesContent":["/**\n * Navigate to a resource operation from a host that is NOT a resource surface.\n *\n * ## Why this exists\n *\n * Every existing path into a resource READ starts from a resource: `useResourceOperationSurface`\n * takes a `resourceContext`, and a list row already has one to derive the target from. A COMPOSITE\n * VIEW has none — it is `APPLICATION`-scoped by definition — so a canvas, board or dashboard that\n * wants a click to open a record had no framework path at all.\n *\n * The consequence was not that such views did without. It was that they re-implemented the detail\n * pane locally: the application-creation workbench's domain-model graph held its selection in React\n * state and rendered an inline `<aside>`, which meant no URL, no back navigation, no zone semantics\n * and no responsive collapse — a hand-rolled copy of `split` + `SECONDARY` + `onEmpty` at one call\n * site, with none of their behavior (issue #174).\n *\n * So this is deliberately a NAMED SEAM rather than a widening of the barrel. The alternative was to\n * export `frontend-resource.utils` publicly, which would expose a large internal module as API to\n * solve one caller's problem — repository organization as contract, which\n * `package-public-entrypoints.md` forbids.\n *\n * ## What it does NOT do\n *\n * It does not decide WHERE the record opens. That is the navigation layout's job: the transition\n * declared for `READ` in the source zone resolves to push, split or overlay, and a composite view\n * gets the same answer a list would from the same zone. A caller wanting a detail pane declares\n * `READ → SPLIT` in its layout; a caller wanting a full page declares `PUSH`. Nothing here overrides\n * that, which is the entire point — the previous hand-rolled pane WAS the override.\n */\n\nimport { useCallback, useMemo } from 'react';\nimport { CoreResourceOperation, NavigationZoneName } from '@wildo-ai/saas-models';\n\nimport { useResourceRegistry } from './useResourceRegistry';\nimport { frontendResourceUtils, FrontendResourceUtils } from './frontend-resource.utils';\nimport { pickPreferredOperationForCoreSemanticAddressability } from './resource-addressability.frontend.utils';\nimport type { FrontendResourceOperationContext } from './resources.frontend.schemas';\nimport { useNavigationController } from '~wildo-frontend-lib/core/navigation/useNavigationController';\nimport type { NavigationInitiatorContext } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\n\nexport interface HostlessResourceReadNavigationParams {\n  /** The resource whose record should open. */\n  resourceType: string;\n  /** The record's id, as the resource's own identifier field carries it. */\n  resourceId: string;\n  /**\n   * Additional context identifiers to carry (parent scope, filters). Defaults to none — an\n   * `APPLICATION`-scoped host has no ambient resource context to inherit, which is exactly what makes\n   * it hostless.\n   */\n  contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];\n  /**\n   * Which zone the click came from. Defaults to PRIMARY, because a composite view is primary-zone\n   * content — and it is the SOURCE zone that decides the transition, so getting this wrong sends the\n   * record somewhere the layout did not intend.\n   */\n  sourceZone?: NavigationInitiatorContext['sourceZone'];\n}\n\nexport interface HostlessResourceNavigation {\n  /**\n   * Open a resource's preferred ADDRESSABLE read.\n   *\n   * Returns `false` — without navigating — when the resource is not registered, declares no\n   * addressable READ, or the id is empty. Fails closed on purpose: navigating to\n   * `/<resource>/undefined` produces an unrenderable detail surface that re-renders in a\n   * CPU-pegging loop, which is the failure the equivalent guard in `ResourceLayout_List` exists to\n   * prevent. A no-op click is recoverable; that is not.\n   */\n  navigateToResourceRead: (params: HostlessResourceReadNavigationParams) => boolean;\n}\n\nexport function useHostlessResourceNavigation(): HostlessResourceNavigation {\n  const { registry } = useResourceRegistry();\n  const { navigateToResource } = useNavigationController();\n\n  const navigateToResourceRead = useCallback((params: HostlessResourceReadNavigationParams): boolean => {\n    const { resourceType, resourceId, contextResourceIdentifiers = {}, sourceZone = NavigationZoneName.PRIMARY } = params;\n    if (!resourceId) {\n      return false;\n    }\n\n    const resourceConfig = registry.resourceConfigurations[resourceType];\n    if (!resourceConfig) {\n      return false;\n    }\n\n    const targetContextResourceIdentifiers = {\n      ...contextResourceIdentifiers,\n      [resourceType]: resourceId,\n    };\n\n    /*\n     * `requireFrontendAddressable: true` with no EMBEDDED fallback, unlike `ResourceLayout_List`.\n     * That list can fall back because it HAS a host to render an embedded read inside; a composite\n     * view does not, so an EMBEDDED read reached from here would have nowhere to go — and answering\n     * `false` is a visible no-op the author can debug, where navigating to a surface that cannot\n     * render is not.\n     */\n    const readOperation = pickPreferredOperationForCoreSemanticAddressability({\n      resourceConfig,\n      operations: resourceConfig.operations ?? [],\n      coreOperation: CoreResourceOperation.READ,\n      registry,\n      hasResourceId: true,\n      requireFrontendAddressable: true,\n      contextResourceIdentifiers: targetContextResourceIdentifiers,\n      contextualParameters: FrontendResourceUtils.buildContextualParameters(\n        targetContextResourceIdentifiers,\n        registry,\n      ),\n    });\n    if (!readOperation) {\n      return false;\n    }\n\n    navigateToResource(\n      frontendResourceUtils.createFrontendResourceOperationContextFromOperation({\n        resourceType,\n        operation: readOperation,\n        contextResourceIdentifiers: targetContextResourceIdentifiers,\n      }),\n      { sourceZone, sourceOperation: CoreResourceOperation.READ },\n    );\n    return true;\n  }, [registry, navigateToResource]);\n\n  return useMemo(() => ({ navigateToResourceRead }), [navigateToResourceRead]);\n}\n"]}
+{"version":3,"file":"useHostlessResourceNavigation.js","sourceRoot":"","sources":["../../../../../src/core/resources/useHostlessResourceNavigation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAElF,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,EAAE,mDAAmD,EAAE,MAAM,0CAA0C,CAAC;AAE/G,OAAO,EAAE,uBAAuB,EAAE,MAAM,6DAA6D,CAAC;AAmCtG,MAAM,UAAU,6BAA6B;IAC3C,MAAM,EAAE,QAAQ,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAC3C,MAAM,EAAE,kBAAkB,EAAE,GAAG,uBAAuB,EAAE,CAAC;IAEzD,MAAM,sBAAsB,GAAG,WAAW,CAAC,CAAC,MAA4C,EAAW,EAAE;QACnG,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,0BAA0B,GAAG,EAAE,EAAE,UAAU,GAAG,kBAAkB,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC;QACtH,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,cAAc,GAAG,QAAQ,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC;QACrE,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,gCAAgC,GAAG;YACvC,GAAG,0BAA0B;YAC7B,CAAC,YAAY,CAAC,EAAE,UAAU;SAC3B,CAAC;QAEF;;;;;;WAMG;QACH,MAAM,aAAa,GAAG,mDAAmD,CAAC;YACxE,cAAc;YACd,UAAU,EAAE,cAAc,CAAC,UAAU,IAAI,EAAE;YAC3C,aAAa,EAAE,qBAAqB,CAAC,IAAI;YACzC,QAAQ;YACR,aAAa,EAAE,IAAI;YACnB,0BAA0B,EAAE,IAAI;YAChC,0BAA0B,EAAE,gCAAgC;YAC5D,oBAAoB,EAAE,qBAAqB,CAAC,yBAAyB,CACnE,gCAAgC,EAChC,QAAQ,CACT;SACF,CAAC,CAAC;QACH,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,kBAAkB,CAChB,qBAAqB,CAAC,mDAAmD,CAAC;YACxE,YAAY;YACZ,SAAS,EAAE,aAAa;YACxB,0BAA0B,EAAE,gCAAgC;SAC7D,CAAC,EACF,EAAE,UAAU,EAAE,eAAe,EAAE,qBAAqB,CAAC,IAAI,EAAE,CAC5D,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAEnC,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,sBAAsB,EAAE,CAAC,EAAE,CAAC,sBAAsB,CAAC,CAAC,CAAC;AAC/E,CAAC","sourcesContent":["/**\n * Navigate to a resource operation from a host that is NOT a resource surface.\n *\n * ## Why this exists\n *\n * Every existing path into a resource READ starts from a resource: `useResourceOperationSurface`\n * takes a `resourceContext`, and a list row already has one to derive the target from. A COMPOSITE\n * VIEW has none — it is `APPLICATION`-scoped by definition — so a canvas, board or dashboard that\n * wants a click to open a record had no framework path at all.\n *\n * The consequence was not that such views did without. It was that they re-implemented the detail\n * pane locally: the application-creation workbench's domain-model graph held its selection in React\n * state and rendered an inline `<aside>`, which meant no URL, no back navigation, no zone semantics\n * and no responsive collapse — a hand-rolled copy of `split` + `SECONDARY` + `onEmpty` at one call\n * site, with none of their behavior (issue #174).\n *\n * So this is deliberately a NAMED SEAM rather than a widening of the barrel. The alternative was to\n * export `frontend-resource.utils` publicly, which would expose a large internal module as API to\n * solve one caller's problem — repository organization as contract, which\n * `package-public-entrypoints.md` forbids.\n *\n * ## What it does NOT do\n *\n * It does not decide WHERE the record opens. That is the navigation layout's job: the transition\n * declared for `READ` in the source zone resolves to push, split or overlay, and a composite view\n * gets the same answer a list would from the same zone. A caller wanting a detail pane declares\n * `READ → SPLIT` in its layout; a caller wanting a full page declares `PUSH`. Nothing here overrides\n * that, which is the entire point — the previous hand-rolled pane WAS the override.\n */\n\nimport { useCallback, useMemo } from 'react';\nimport { CoreResourceOperation, NavigationZoneName } from '@wildo-ai/saas-models';\n\nimport { useResourceRegistry } from './useResourceRegistry';\nimport { frontendResourceUtils, FrontendResourceUtils } from './frontend-resource.utils';\nimport { pickPreferredOperationForCoreSemanticAddressability } from './resource-addressability.frontend.utils';\nimport type { FrontendResourceOperationContext } from './resources.frontend.schemas';\nimport { useNavigationController } from '~wildo-frontend-lib/core/navigation/useNavigationController';\nimport type { NavigationInitiatorContext } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\n\nexport interface HostlessResourceReadNavigationParams {\n  /** The resource whose record should open. */\n  resourceType: string;\n  /** The record's id, as the resource's own identifier field carries it. */\n  resourceId: string;\n  /**\n   * Additional context identifiers to carry (parent scope, filters). Defaults to none — an\n   * `APPLICATION`-scoped host has no ambient resource context to inherit, which is exactly what makes\n   * it hostless.\n   */\n  contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];\n  /**\n   * Which zone the click came from. Defaults to PRIMARY, because a composite view is primary-zone\n   * content — and it is the SOURCE zone that decides the transition, so getting this wrong sends the\n   * record somewhere the layout did not intend.\n   */\n  sourceZone?: NavigationInitiatorContext['sourceZone'];\n}\n\nexport interface HostlessResourceNavigation {\n  /**\n   * Open a resource's preferred ADDRESSABLE read.\n   *\n   * Returns `false` — without navigating — when the resource is not registered, declares no\n   * addressable READ, or the id is empty. Fails closed on purpose: navigating to\n   * `/<resource>/undefined` produces an unrenderable detail surface that re-renders in a\n   * CPU-pegging loop, which is the failure the equivalent guard in `ResourceLayout_List` exists to\n   * prevent. A no-op click is recoverable; that is not.\n   */\n  navigateToResourceRead: (params: HostlessResourceReadNavigationParams) => boolean;\n}\n\nexport function useHostlessResourceNavigation(): HostlessResourceNavigation {\n  const { registry } = useResourceRegistry();\n  const { navigateToResource } = useNavigationController();\n\n  const navigateToResourceRead = useCallback((params: HostlessResourceReadNavigationParams): boolean => {\n    const { resourceType, resourceId, contextResourceIdentifiers = {}, sourceZone = NavigationZoneName.PRIMARY } = params;\n    if (!resourceId) {\n      return false;\n    }\n\n    const resourceConfig = registry.resourceConfigurations[resourceType];\n    if (!resourceConfig) {\n      return false;\n    }\n\n    const targetContextResourceIdentifiers = {\n      ...contextResourceIdentifiers,\n      [resourceType]: resourceId,\n    };\n\n    /*\n     * `requireFrontendAddressable: true` with no EMBEDDED fallback, unlike `ResourceLayout_List`.\n     * That list can fall back because it HAS a host to render an embedded read inside; a composite\n     * view does not, so an EMBEDDED read reached from here would have nowhere to go — and answering\n     * `false` is a visible no-op the author can debug, where navigating to a surface that cannot\n     * render is not.\n     */\n    const readOperation = pickPreferredOperationForCoreSemanticAddressability({\n      resourceConfig,\n      operations: resourceConfig.operations ?? [],\n      coreOperation: CoreResourceOperation.READ,\n      registry,\n      hasResourceId: true,\n      requireFrontendAddressable: true,\n      contextResourceIdentifiers: targetContextResourceIdentifiers,\n      contextualParameters: FrontendResourceUtils.buildContextualParameters(\n        targetContextResourceIdentifiers,\n        registry,\n      ),\n    });\n    if (!readOperation) {\n      return false;\n    }\n\n    navigateToResource(\n      frontendResourceUtils.createFrontendResourceOperationContextFromOperation({\n        resourceType,\n        operation: readOperation,\n        contextResourceIdentifiers: targetContextResourceIdentifiers,\n      }),\n      { sourceZone, sourceOperation: CoreResourceOperation.READ },\n    );\n    return true;\n  }, [registry, navigateToResource]);\n\n  return useMemo(() => ({ navigateToResourceRead }), [navigateToResourceRead]);\n}\n"]}

package/dist/esm/core/resources/useOperationEnabled.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useOperationEnabled.d.ts","sourceRoot":"","sources":["../../../../src/core/resources/useOperationEnabled.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GACzB,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"useOperationEnabled.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/useOperationEnabled.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GACzB,MAAM,6BAA6B,CAAC"}

package/dist/esm/core/resources/useOperationEnabled.js.map

@@ -1 +1 @@
-{"version":3,"file":"useOperationEnabled.js","sourceRoot":"","sources":["../../../../src/core/resources/useOperationEnabled.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GAKrB,MAAM,6BAA6B,CAAC","sourcesContent":["/**\n * Re-export from the canonical implementation in hooks/useOperationEnabled.\n * \n * The canonical implementation lives in ./hooks/useOperationEnabled.ts.\n * This file exists as a public re-export point (used by index.ts barrel).\n */\nexport {\n  useOperationEnabled,\n  useOperationsEnabled,\n  type UseOperationEnabledParams,\n  type UseOperationEnabledResult,\n  type OperationEnabledEntry,\n  type FeatureAvailability,\n} from './hooks/useOperationEnabled';\n"]}
+{"version":3,"file":"useOperationEnabled.js","sourceRoot":"","sources":["../../../../../src/core/resources/useOperationEnabled.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GAKrB,MAAM,6BAA6B,CAAC","sourcesContent":["/**\n * Re-export from the canonical implementation in hooks/useOperationEnabled.\n * \n * The canonical implementation lives in ./hooks/useOperationEnabled.ts.\n * This file exists as a public re-export point (used by index.ts barrel).\n */\nexport {\n  useOperationEnabled,\n  useOperationsEnabled,\n  type UseOperationEnabledParams,\n  type UseOperationEnabledResult,\n  type OperationEnabledEntry,\n  type FeatureAvailability,\n} from './hooks/useOperationEnabled';\n"]}

package/dist/esm/core/resources/useResourceLabels.d.ts

@@ -1,13 +1,13 @@
 /**
  * useResourceLabels — Shared hook for resolving field labels, descriptions,
- * enum labels, and section labels from i18n with fallback to camelCase formatting.
+ * enum labels, and section labels from i18n. An unresolved label renders as its raw key (#420).
  *
  * Used by both AutomaticDisplayer (display mode) and AutomatedForm (edit mode).
  *
  * Resolution chain for labels:
  * 1. Explicit override from labels prop wins
  * 2. i18n resolution via tResourceFieldDisplay/tResourceFieldEdit
- *    (fallback is handled internally by I18nContext — consumers always get a usable string)
+ *    (fallback is handled internally by I18nContext — an unresolved label is the key itself, never invented words)
  *
  * Resolution chain for descriptions:
  * 1. Explicit override from labels prop wins
@@ -20,7 +20,7 @@
  *
  * Supports parameterized labels via {{param}} interpolation using current object data.
  */
-import { z } from 'zod';
+import type { z } from 'zod';
 import type { DisplayOrFormSectionLabel } from '@wildo-ai/presets-components-models';
 import type { LayoutRefManifest } from '../../core/resources/resources.frontend.schemas';
 export interface ResourceLabelContext {
@@ -33,6 +33,24 @@ export interface UseResourceLabelsOptions {
      * section names and wizard step names for i18n resolution.
      */
     layoutRefs?: LayoutRefManifest;
+    /**
+     * 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 somewhere else in the owning
+     * resource. The resolved map stays keyed by the LOCAL path the surface renders (`objective`), while
+     * the i18n lookup uses the owning path (`tasks.objective`) — so one authoring serves both surfaces
+     * and neither can drift from the other.
+     *
+     * Added for the workbench's aspect popup (#638), which renders one entry of a family document as
+     * its own root. Every field in it read as its raw schema key — `objective`, `skillRefs`,
+     * `target.moduleRef` — beside a document one click away that labels the same fields correctly,
+     * because the document authors them under `tasks.` and the popup asked for them bare.
+     *
+     * Deliberately NOT a second place to author words: it changes which key is asked for, never what
+     * happens when the key is missing. An unauthored field still renders as its key, on both surfaces,
+     * which is what `display-text-comes-from-i18n.md` asks for.
+     */
+    fieldPathPrefix?: string;
     /** Explicit i18n-key overrides — these take priority over ref-derived defaults */
     overrides?: {
         fields?: Record<string, string>;
@@ -60,10 +78,10 @@ export interface UseResourceLabelsResult {
     groupLabels: Record<string, string>;
     /**
      * Whether the underlying resource-label i18n bundle has finished loading.
-     * The maps above always return usable strings (formatted field-name fallbacks)
-     * even while `false`, so this is NOT required for correctness — it lets callers
-     * hold a skeleton until the *real* labels land instead of flashing the
-     * humanized field-name fallback, then swapping (see `AutomatedForm`).
+     * The maps above always return a string (the raw key when unresolved) even while
+     * `false`, so this is NOT required for correctness — it lets callers hold a
+     * skeleton until the *real* labels land instead of flashing raw keys, then
+     * swapping (see `AutomatedForm`).
      */
     isReady: boolean;
 }
@@ -72,8 +90,8 @@ export interface UseResourceLabelsResult {
  * from i18n. Works for both display and edit modes.
  *
  * Fallback logic is handled by I18nContext functions themselves —
- * they never return raw keys, always a usable string (formatted field name,
- * raw enum value, or empty string).
+ * an unresolved field label is its raw key (leaf-shortened for nested paths),
+ * an unresolved enum value is the raw value, and an unresolved description is empty.
  *
  * @param schema - The Zod schema for the resource (used to extract field names and enum values)
  * @param resourceContext - Resource type and operation ID for i18n key construction

package/dist/esm/core/resources/useResourceLabels.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useResourceLabels.d.ts","sourceRoot":"","sources":["../../../../src/core/resources/useResourceLabels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+DAA+D,CAAC;AASvG,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,kFAAkF;IAClF,SAAS,CAAC,EAAE;QACV,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,oDAAoD;QACpD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;QACrD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;KACzD,CAAC;CACH;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC;kGAC8F;IAC9F,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C;sGACkG;IAClG,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,+GAA+G;IAC/G,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC;;;;;;OAMG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AA2JD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,CAAC,CAAC,UAAU,EACpB,eAAe,CAAC,EAAE,oBAAoB,EACtC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,IAAI,GAAE,SAAS,GAAG,MAAkB,EACpC,OAAO,GAAE,wBAA6B,GACrC,uBAAuB,CAkUzB"}
+{"version":3,"file":"useResourceLabels.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/useResourceLabels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+DAA+D,CAAC;AAcvG,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B;;;;;;;;;;;;;;;;OAgBG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,SAAS,CAAC,EAAE;QACV,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,oDAAoD;QACpD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;QACrD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;KACzD,CAAC;CACH;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC;kGAC8F;IAC9F,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C;sGACkG;IAClG,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,+GAA+G;IAC/G,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC;;;;;;OAMG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAqDD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,CAAC,CAAC,UAAU,EACpB,eAAe,CAAC,EAAE,oBAAoB,EACtC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,IAAI,GAAE,SAAS,GAAG,MAAkB,EACpC,OAAO,GAAE,wBAA6B,GACrC,uBAAuB,CAiUzB"}

package/dist/esm/core/resources/useResourceLabels.js

@@ -1,13 +1,13 @@
 /**
  * useResourceLabels — Shared hook for resolving field labels, descriptions,
- * enum labels, and section labels from i18n with fallback to camelCase formatting.
+ * enum labels, and section labels from i18n. An unresolved label renders as its raw key (#420).
  *
  * Used by both AutomaticDisplayer (display mode) and AutomatedForm (edit mode).
  *
  * Resolution chain for labels:
  * 1. Explicit override from labels prop wins
  * 2. i18n resolution via tResourceFieldDisplay/tResourceFieldEdit
- *    (fallback is handled internally by I18nContext — consumers always get a usable string)
+ *    (fallback is handled internally by I18nContext — an unresolved label is the key itself, never invented words)
  *
  * Resolution chain for descriptions:
  * 1. Explicit override from labels prop wins
@@ -20,11 +20,11 @@
  *
  * Supports parameterized labels via {{param}} interpolation using current object data.
  */
-import { useMemo } from 'react';
-import { z } from 'zod';
-import { FieldSchemaType, getArrayItemSchema, getEnumValues, getSchemaType, getFieldUIDisplayConfig, getFieldUIEditConfig, getZodObjectShape, unwrapSchema } from '@wildo-ai/zod-decorators';
+import { useCallback, useMemo } from 'react';
+import { getEnumValues, getFieldUIDisplayConfig, getFieldUIEditConfig } from '@wildo-ai/zod-decorators';
 import { useI18n } from '../../core/i18n/useI18n.js';
 import { AutomatedLayoutFrontendUtils } from '../../core/automated-layout/automated-layout.frontend.utils.js';
+import { collectResourceLabelFieldEntries, resolveResourceLabelEnumSchema, } from '../../core/resources/resource-label-field-paths.frontend.utils.js';
 // =============================================================================
 // HELPERS
 // =============================================================================
@@ -46,93 +46,6 @@ function dataToParams(data) {
     }
     return Object.keys(params).length > 0 ? params : undefined;
 }
-/** Max object-nesting depth walked when collecting label/enum entries (guards against
- *  pathological / self-referential schemas while covering real nested settings objects
- *  like `privacy.dataProcessingConsent` and `regional.dateFormat`). */
-const MAX_NESTED_FIELD_DEPTH = 4;
-/**
- * Flatten a resource schema into every label-bearing field path, recursing into nested
- * OBJECT fields so that fields rendered inside an `<ObjectScope name="privacy">` (which look
- * their labels/enum-labels up by the dotted `privacy.dataProcessingConsent` key) resolve the
- * same way top-level fields do. Without this, nested object fields fell back to no label /
- * raw enum values. Arrays are recorded as leaves (their element enum, if any, is handled by
- * the enum-labels pass) but not descended into — per-index paths are dynamic.
- */
-function collectFieldEntries(schema, prefix, depth, acc) {
-    let shape;
-    try {
-        // Resolve the field shape the SAME way the form/display RENDER path does
-        // (`extractSchemaFieldList` / `formFieldShape` → `getObjectLikeFieldShape`).
-        // Polymorphic resources (e.g. todos) feed the form a `z.discriminatedUnion`
-        // request DTO; the object-only `getObjectShape` returns `null` for a union, so
-        // labels silently fell back to raw camelCase while the renderer happily showed
-        // every field (functional-but-unlabelled). `getObjectLikeFieldShape` treats a
-        // discriminated-union-of-objects as a single object-like field set; `commonOnly:
-        // false` MERGES keys across every variant so variant-only fields (rendered under
-        // a `<DiscriminatorSwitch>`, e.g. `recurrence`/`startDate`) also resolve labels.
-        shape = AutomatedLayoutFrontendUtils.getObjectLikeFieldShape(schema, { commonOnly: false });
-    }
-    catch {
-        return;
-    }
-    if (!shape)
-        return;
-    /*
-     * A DISCRIMINATED UNION's discriminator must collect its values across EVERY variant.
-     *
-     * The merged shape above keeps the FIRST variant's schema per key, which is right for the
-     * variant-only fields (each has one owner) and silently wrong for the one key every variant
-     * declares: the discriminator, a per-variant `z.literal`. Collected as the first variant's
-     * literal, its label map knew exactly one value — measured on the workbench build plan, where
-     * `target.kind` is a five-variant union: the authored `enum` labels served fine for `MODULE`
-     * and every other task printed the raw wire constant (`RESOURCE_STAGE`, fifty-odd times down
-     * the page), while its SIBLING `stage` resolved perfectly because only one variant declares it.
-     *
-     * So: where several variants declare the same key as distinct string literals, the collected
-     * schema becomes their union as a `z.enum`, and `getEnumValues` below sees the full vocabulary.
-     * The render path needs no change — it resolves the ACTUAL variant and looks its value up in
-     * this map.
-     */
-    const unionOptions = AutomatedLayoutFrontendUtils.getDiscriminatedUnionObjectOptions(unwrapSchema(schema));
-    const discriminatorEnums = {};
-    if (unionOptions.length > 1) {
-        const literalValuesByKey = {};
-        for (const option of unionOptions) {
-            for (const [name, fieldSchema] of Object.entries(getZodObjectShape(option))) {
-                const values = getEnumValues(fieldSchema);
-                if (values.length !== 1)
-                    continue;
-                (literalValuesByKey[name] ??= []).push(values[0]);
-            }
-        }
-        for (const [name, values] of Object.entries(literalValuesByKey)) {
-            if (values.length > 1)
-                discriminatorEnums[name] = z.enum(values);
-        }
-    }
-    for (const [name, fieldSchema] of Object.entries(shape)) {
-        const path = prefix ? `${prefix}.${name}` : name;
-        acc.push({ path, leaf: name, schema: discriminatorEnums[name] ?? fieldSchema });
-        if (depth < MAX_NESTED_FIELD_DEPTH && getSchemaType(fieldSchema) === FieldSchemaType.OBJECT) {
-            collectFieldEntries(fieldSchema, path, depth + 1, acc);
-        }
-        /*
-         * Descend into ARRAY-OF-OBJECT items too, under the item's INDEX-FREE path
-         * (`successCriteria.horizon`, never `successCriteria[0].horizon`): every item of one array
-         * shares one schema, so labels are per-FIELD, not per-row. Without this, a labelled enum
-         * inside an entry collection — a criterion's `horizon`, a constraint's `kind` — had no entry
-         * in `enumLabels`/`fieldLabels` at all and rendered its raw wire value, while the identical
-         * enum ONE level up resolved fine. The render path strips indices before its lookup
-         * (`DisplayField`), so the two sides meet on the same key.
-         */
-        if (depth < MAX_NESTED_FIELD_DEPTH && getSchemaType(fieldSchema) === FieldSchemaType.ARRAY) {
-            const itemSchema = getArrayItemSchema(fieldSchema);
-            if (itemSchema && getSchemaType(itemSchema) === FieldSchemaType.OBJECT) {
-                collectFieldEntries(itemSchema, path, depth + 1, acc);
-            }
-        }
-    }
-}
 /**
  * Resolve a single field label, substituting the LEAF segment when i18n resolved nothing.
  *
@@ -161,8 +74,8 @@ function resolveFieldLabel(path, leaf, resolved) {
  * from i18n. Works for both display and edit modes.
  *
  * Fallback logic is handled by I18nContext functions themselves —
- * they never return raw keys, always a usable string (formatted field name,
- * raw enum value, or empty string).
+ * an unresolved field label is its raw key (leaf-shortened for nested paths),
+ * an unresolved enum value is the raw value, and an unresolved description is empty.
  *
  * @param schema - The Zod schema for the resource (used to extract field names and enum values)
  * @param resourceContext - Resource type and operation ID for i18n key construction
@@ -174,7 +87,14 @@ export function useResourceLabels(schema, resourceContext, data, mode = 'display
     const { t, tResourceFieldDisplay, tResourceFieldEdit, tResourceFieldEnumValue, tResourceSection, tResourceWizardStep, isReady } = useI18n({
         resource: resourceContext?.resourceType,
     });
-    const { layoutRefs, overrides } = options;
+    const { layoutRefs, overrides, fieldPathPrefix } = options;
+    /**
+     * The i18n key a local path is looked up under — prefixed when this surface renders a nested item
+     * shape, identical otherwise. One helper so the field, description, tooltip and ENUM resolutions
+     * cannot disagree about it: an enum whose values resolved bare while its label resolved prefixed
+     * would show an authored heading over raw wire constants, which reads worse than either alone.
+     */
+    const resolveI18nPath = useCallback((path) => (fieldPathPrefix ? `${fieldPathPrefix}.${path}` : path), [fieldPathPrefix]);
     // -------------------------------------------------------------------------
     // FIELD LABELS
     // -------------------------------------------------------------------------
@@ -183,9 +103,9 @@ export function useResourceLabels(schema, resourceContext, data, mode = 'display
         const params = dataToParams(data);
         // Collect top-level AND nested (ObjectScope) field paths so a field rendered inside
         // `<ObjectScope name="privacy">` resolves its label by the dotted `privacy.x` key.
-        const entries = [];
+        let entries;
         try {
-            collectFieldEntries(schema, '', 0, entries);
+            entries = collectResourceLabelFieldEntries(schema);
         }
         catch {
             // Schema might not be an object (e.g., during loading)
@@ -200,17 +120,18 @@ export function useResourceLabels(schema, resourceContext, data, mode = 'display
                 continue;
             }
             // 2. i18n resolution (fallback handled internally; leaf-substituted for nested paths)
+            const i18nPath = resolveI18nPath(path);
             if (resourceContext) {
                 const tFn = mode === 'edit' ? tResourceFieldEdit : tResourceFieldDisplay;
-                result[path] = resolveFieldLabel(path, leaf, tFn(resourceContext.resourceType, path, 'label', params));
+                result[path] = resolveFieldLabel(i18nPath, leaf, tFn(resourceContext.resourceType, i18nPath, 'label', params));
             }
             else {
-                // No resource context — use the i18n function which will fallback to formatted name
-                result[path] = resolveFieldLabel(path, leaf, tResourceFieldDisplay('', path, 'label', params));
+                // No resource context — the i18n function still answers, with the raw key when unresolved
+                result[path] = resolveFieldLabel(i18nPath, leaf, tResourceFieldDisplay('', i18nPath, 'label', params));
             }
         }
         return result;
-    }, [schema, resourceContext, data, mode, overrides?.fields, tResourceFieldDisplay, tResourceFieldEdit]);
+    }, [schema, resourceContext, data, mode, overrides?.fields, resolveI18nPath, tResourceFieldDisplay, tResourceFieldEdit]);
     // -------------------------------------------------------------------------
     // FIELD DESCRIPTIONS
     // -------------------------------------------------------------------------
@@ -222,9 +143,9 @@ export function useResourceLabels(schema, resourceContext, data, mode = 'display
         const params = dataToParams(data);
         // Collect top-level AND nested field paths (mirrors fieldLabels) so ObjectScope-nested
         // fields can resolve descriptions by their dotted path.
-        const entries = [];
+        let entries;
         try {
-            collectFieldEntries(schema, '', 0, entries);
+            entries = collectResourceLabelFieldEntries(schema);
         }
         catch {
             return overrides?.descriptions ?? {};
@@ -238,14 +159,14 @@ export function useResourceLabels(schema, resourceContext, data, mode = 'display
             // 2. i18n resolution (only source for descriptions — Zod .describe() is NOT used for UI)
             if (resourceContext) {
                 const tFn = mode === 'edit' ? tResourceFieldEdit : tResourceFieldDisplay;
-                const resolved = tFn(resourceContext.resourceType, path, 'description', params);
+                const resolved = tFn(resourceContext.resourceType, resolveI18nPath(path), 'description', params);
                 if (resolved) {
                     result[path] = resolved;
                 }
             }
         }
         return result;
-    }, [schema, resourceContext, data, mode, overrides?.descriptions, tResourceFieldDisplay, tResourceFieldEdit]);
+    }, [schema, resourceContext, data, mode, overrides?.descriptions, resolveI18nPath, tResourceFieldDisplay, tResourceFieldEdit]);
     // -------------------------------------------------------------------------
     // FIELD TOOLTIPS
     // -------------------------------------------------------------------------
@@ -254,7 +175,7 @@ export function useResourceLabels(schema, resourceContext, data, mode = 'display
         const result = {};
         let shape;
         try {
-            // Mirror `collectFieldEntries`: object-LIKE resolution so a discriminated-union
+            // Mirror `collectResourceLabelFieldEntries`: object-LIKE resolution so a discriminated-union
             // request DTO (polymorphic resource) yields its merged field shape instead of
             // `undefined`, and tooltips resolve for variant-only fields too.
             shape = AutomatedLayoutFrontendUtils.getObjectLikeFieldShape(schema, { commonOnly: false });
@@ -277,24 +198,24 @@ export function useResourceLabels(schema, resourceContext, data, mode = 'display
                 continue;
             if (resourceContext) {
                 const tFn = mode === 'edit' ? tResourceFieldEdit : tResourceFieldDisplay;
-                const resolved = tFn(resourceContext.resourceType, fieldName, 'tooltip');
+                const resolved = tFn(resourceContext.resourceType, resolveI18nPath(fieldName), 'tooltip');
                 if (resolved) {
                     result[fieldName] = resolved;
                 }
             }
         }
         return result;
-    }, [schema, resourceContext, mode, tResourceFieldDisplay, tResourceFieldEdit]);
+    }, [schema, resourceContext, mode, resolveI18nPath, tResourceFieldDisplay, tResourceFieldEdit]);
     // -------------------------------------------------------------------------
     // ENUM LABELS
     // -------------------------------------------------------------------------
     const enumLabels = useMemo(() => {
         const result = {};
         // Collect top-level AND nested field paths (mirrors fieldLabels) so nested enum fields
-        // (`ui.theme`, `regional.dateFormat`, `privacy.dataProcessingConsent`) get enum labels.
-        const entries = [];
+        // (`ui.theme`, `regional.dateFormat`, `privacy.consentedPurposes`) get enum labels.
+        let entries;
         try {
-            collectFieldEntries(schema, '', 0, entries);
+            entries = collectResourceLabelFieldEntries(schema);
         }
         catch {
             return overrides?.enums ?? {};
@@ -304,17 +225,7 @@ export function useResourceLabels(schema, resourceContext, data, mode = 'display
             // (e.g. `roles: z.array(z.union([z.enum(CORE_ORG_ROLES), z.string()]))`, whose union
             // element still yields enum values via getEnumValues). Without the array branch,
             // array-of-enum fields rendered their members raw (e.g. `ORG_ADMIN`).
-            const schemaType = getSchemaType(fieldSchema);
-            let enumSchema;
-            if (schemaType === FieldSchemaType.ENUM) {
-                enumSchema = fieldSchema;
-            }
-            else if (schemaType === FieldSchemaType.ARRAY) {
-                const itemSchema = getArrayItemSchema(fieldSchema);
-                if (itemSchema && getSchemaType(itemSchema) === FieldSchemaType.ENUM) {
-                    enumSchema = itemSchema;
-                }
-            }
+            const enumSchema = resolveResourceLabelEnumSchema(fieldSchema);
             if (!enumSchema)
                 continue;
             // 1. Explicit override wins
@@ -322,20 +233,22 @@ export function useResourceLabels(schema, resourceContext, data, mode = 'display
                 result[path] = overrides.enums[path];
                 continue;
             }
-            // 2. i18n resolution (tResourceFieldEnumValue auto-cascades to system enum labels)
+            // 2. i18n resolution — the per-field word, else the words of the enum THIS field declares (read off
+            //    `fieldSchema`, which for a union discriminator is the collected enum carrying its variants'
+            //    declared vocabulary), else the raw value (#966)
             if (resourceContext) {
                 const values = getEnumValues(enumSchema);
                 if (values.length > 0) {
                     const enumMap = {};
                     for (const value of values) {
-                        enumMap[value] = tResourceFieldEnumValue(resourceContext.resourceType, path, value);
+                        enumMap[value] = tResourceFieldEnumValue(resourceContext.resourceType, resolveI18nPath(path), value, fieldSchema);
                     }
                     result[path] = enumMap;
                 }
             }
         }
         return result;
-    }, [schema, resourceContext, overrides?.enums, tResourceFieldEnumValue]);
+    }, [schema, resourceContext, overrides?.enums, resolveI18nPath, tResourceFieldEnumValue]);
     // -------------------------------------------------------------------------
     // SECTION LABELS
     // -------------------------------------------------------------------------
@@ -362,15 +275,11 @@ export function useResourceLabels(schema, resourceContext, data, mode = 'display
             const { resourceType } = resourceContext;
             for (const ref of layoutRefs.sections) {
                 if (!labels[ref]) {
-                    const resolvedLabel = tResourceSection(resourceType, ref, 'title');
-                    // Fall back to the section REF when no i18n title has been generated yet — the same
-                    // unresolved rendering field labels use, and for the same reason: it is visibly a key,
-                    // so it gets authored. Without any fallback a section renders TITLE-LESS (an invisible
-                    // group), so a multi-section settings page reads as one undifferentiated list — the
-                    // headings simply never appear, which is a worse failure than a visible raw ref. A real
-                    // generated or authored title still wins; this only keeps a declared section a visible,
-                    // named group.
-                    labels[ref] = resolvedLabel || AutomatedLayoutFrontendUtils.unresolvedFieldLabel(ref);
+                    // A section with no generated title shows `resources.<type>.sections.<ref>.title` — the
+                    // resolver's own answer for a missing primary label (#1450). It used to answer '' and this
+                    // site patched the gap with the bare ref; a TITLE-LESS section is an invisible group, so a
+                    // multi-section settings page read as one undifferentiated list.
+                    labels[ref] = tResourceSection(resourceType, ref, 'title');
                 }
                 if (!descriptions[ref]) {
                     // Descriptions are prose — there is no sensible humanized fallback, so an
@@ -413,10 +322,8 @@ export function useResourceLabels(schema, resourceContext, data, mode = 'display
             const { resourceType } = resourceContext;
             for (const ref of layoutRefs.wizardSteps) {
                 if (!labels[ref]) {
-                    const resolvedLabel = tResourceWizardStep(resourceType, ref, 'title');
-                    if (resolvedLabel) {
-                        labels[ref] = resolvedLabel;
-                    }
+                    // Never empty: an ungenerated step title is its key path (#1450), so a step is never unnamed.
+                    labels[ref] = tResourceWizardStep(resourceType, ref, 'title');
                 }
                 if (!descriptions[ref]) {
                     const resolvedDescription = tResourceWizardStep(resourceType, ref, 'description');