@wildo-ai/saas-frontend-lib 1.1.9 → 1.1.11

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,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"}
+{"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;;;OAGG;IACH,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;AAmFD;;;;;;;;;;;;;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,CAmSzB"}

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

@@ -46,6 +46,35 @@ function dataToParams(data) {
     }
     return Object.keys(params).length > 0 ? params : undefined;
 }
+/**
+ * Apply section or wizard-step overrides: literal text first, then a key that resolves (#2720).
+ *
+ * One function for both because the precedence is one rule; written twice, a change lands at one of the two (the
+ * shape `invariant-call-site-enumeration.md` records). A key that resolves to itself is a missing label and is left
+ * out, so the ref-derived default below it can still answer.
+ */
+function applySectionLabelOverrides(entries, t, labels, descriptions) {
+    if (!entries)
+        return;
+    for (const [ref, value] of Object.entries(entries)) {
+        if (value.title) {
+            labels[ref] = value.title;
+        }
+        else if (value.titleKey) {
+            const resolvedTitle = t(value.titleKey);
+            if (resolvedTitle !== value.titleKey)
+                labels[ref] = resolvedTitle;
+        }
+        if (value.description) {
+            descriptions[ref] = value.description;
+        }
+        else if (value.descriptionKey) {
+            const resolvedDescription = t(value.descriptionKey);
+            if (resolvedDescription !== value.descriptionKey)
+                descriptions[ref] = resolvedDescription;
+        }
+    }
+}
 /**
  * Resolve a single field label, substituting the LEAF segment when i18n resolved nothing.
  *
@@ -255,22 +284,7 @@ export function useResourceLabels(schema, resourceContext, data, mode = 'display
     const sectionText = useMemo(() => {
         const labels = {};
         const descriptions = {};
-        if (overrides?.sections) {
-            for (const [ref, value] of Object.entries(overrides.sections)) {
-                if (value.titleKey) {
-                    const resolvedTitle = t(value.titleKey);
-                    if (resolvedTitle !== value.titleKey) {
-                        labels[ref] = resolvedTitle;
-                    }
-                }
-                if (value.descriptionKey) {
-                    const resolvedDescription = t(value.descriptionKey);
-                    if (resolvedDescription !== value.descriptionKey) {
-                        descriptions[ref] = resolvedDescription;
-                    }
-                }
-            }
-        }
+        applySectionLabelOverrides(overrides?.sections, t, labels, descriptions);
         if (resourceContext && layoutRefs?.sections) {
             const { resourceType } = resourceContext;
             for (const ref of layoutRefs.sections) {
@@ -302,22 +316,7 @@ export function useResourceLabels(schema, resourceContext, data, mode = 'display
     const wizardStepText = useMemo(() => {
         const labels = {};
         const descriptions = {};
-        if (overrides?.wizardSteps) {
-            for (const [ref, value] of Object.entries(overrides.wizardSteps)) {
-                if (value.titleKey) {
-                    const resolvedTitle = t(value.titleKey);
-                    if (resolvedTitle !== value.titleKey) {
-                        labels[ref] = resolvedTitle;
-                    }
-                }
-                if (value.descriptionKey) {
-                    const resolvedDescription = t(value.descriptionKey);
-                    if (resolvedDescription !== value.descriptionKey) {
-                        descriptions[ref] = resolvedDescription;
-                    }
-                }
-            }
-        }
+        applySectionLabelOverrides(overrides?.wizardSteps, t, labels, descriptions);
         if (resourceContext && layoutRefs?.wizardSteps) {
             const { resourceType } = resourceContext;
             for (const ref of layoutRefs.wizardSteps) {

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

@@ -1 +1 @@
-{"version":3,"file":"useResourceLabels.js","sourceRoot":"","sources":["../../../../../src/core/resources/useResourceLabels.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * useResourceLabels — Shared hook for resolving field labels, descriptions,\n * enum labels, and section labels from i18n. An unresolved label renders as its raw key (#420).\n * \n * Used by both AutomaticDisplayer (display mode) and AutomatedForm (edit mode).\n * \n * Resolution chain for labels:\n * 1. Explicit override from labels prop wins\n * 2. i18n resolution via tResourceFieldDisplay/tResourceFieldEdit\n *    (fallback is handled internally by I18nContext — an unresolved label is the key itself, never invented words)\n * \n * Resolution chain for descriptions:\n * 1. Explicit override from labels prop wins\n * 2. i18n resolution via tResourceFieldDisplay/tResourceFieldEdit with key 'description'\n * 3. Empty string (not included in result)\n * \n * NOTE: Zod `.describe()` is NOT used for UI descriptions. It serves a different purpose\n * (developer documentation, AI prompting, API docs). UI descriptions are purely\n * decorator-driven (`.displayField({ showDescription: true })`) + i18n-resolved.\n * \n * Supports parameterized labels via {{param}} interpolation using current object data.\n */\n\nimport { useCallback, useMemo } from 'react';\nimport type { z } from 'zod';\nimport { getEnumValues, getFieldUIDisplayConfig, getFieldUIEditConfig } from '@wildo-ai/zod-decorators';\nimport type { DisplayOrFormSectionLabel } from '@wildo-ai/presets-components-models';\nimport type { LayoutRefManifest } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { AutomatedLayoutFrontendUtils } from '~wildo-frontend-lib/core/automated-layout/automated-layout.frontend.utils';\nimport {\n  collectResourceLabelFieldEntries,\n  resolveResourceLabelEnumSchema,\n  type ResourceLabelFieldEntry,\n} from '~wildo-frontend-lib/core/resources/resource-label-field-paths.frontend.utils';\n\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\nexport interface ResourceLabelContext {\n  resourceType: string;\n  operationId: string;\n}\n\nexport interface UseResourceLabelsOptions {\n  /**\n   * Structural ref manifest from `layout.refs`. Provides the list of\n   * section names and wizard step names for i18n resolution.\n   */\n  layoutRefs?: LayoutRefManifest;\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 somewhere else in the owning\n   * resource. The resolved map stays keyed by the LOCAL path the surface renders (`objective`), while\n   * the i18n lookup uses the owning path (`tasks.objective`) — so one authoring serves both surfaces\n   * and neither can drift from the other.\n   *\n   * Added for the workbench's aspect popup (#638), which renders one entry of a family document as\n   * its own root. Every field in it read as its raw schema key — `objective`, `skillRefs`,\n   * `target.moduleRef` — beside a document one click away that labels the same fields correctly,\n   * because the document authors them under `tasks.` and the popup asked for them bare.\n   *\n   * Deliberately NOT a second place to author words: it changes which key is asked for, never what\n   * happens when the key is missing. An unauthored field still renders as its key, on both surfaces,\n   * which is what `display-text-comes-from-i18n.md` asks for.\n   */\n  fieldPathPrefix?: string;\n  /** Explicit i18n-key overrides — these take priority over ref-derived defaults */\n  overrides?: {\n    fields?: Record<string, string>;\n    /** Explicit description overrides per field name */\n    descriptions?: Record<string, string>;\n    enums?: Record<string, Record<string, string>>;\n    sections?: Record<string, DisplayOrFormSectionLabel>;\n    wizardSteps?: Record<string, DisplayOrFormSectionLabel>;\n  };\n}\n\nexport interface UseResourceLabelsResult {\n  fieldLabels: Record<string, string>;\n  /** Resolved field descriptions. Only contains entries for fields that have a non-empty description\n   * (from i18n, explicit override, or Zod `.describe()` fallback). Empty fields are omitted. */\n  fieldDescriptions: Record<string, string>;\n  /** Resolved field tooltips. Only contains entries for fields with `{primitive}UI({ display: { tooltip: true } })`\n   * or `{primitive}UI({ edit: { tooltip: true } })` depending on the mode. Text comes from i18n. */\n  fieldTooltips: Record<string, string>;\n  enumLabels: Record<string, Record<string, string>>;\n  sectionLabels: Record<string, string>;\n  sectionDescriptions: Record<string, string>;\n  wizardStepLabels: Record<string, string>;\n  wizardStepDescriptions: Record<string, string>;\n  /** Resolved group labels (keyed by group ref). Resolved via i18n key `resources.{type}.groups.{ref}.title`. */\n  groupLabels: Record<string, string>;\n  /**\n   * Whether the underlying resource-label i18n bundle has finished loading.\n   * The maps above always return a string (the raw key when unresolved) even while\n   * `false`, so this is NOT required for correctness — it lets callers hold a\n   * skeleton until the *real* labels land instead of flashing raw keys, then\n   * swapping (see `AutomatedForm`).\n   */\n  isReady: boolean;\n}\n\n\n// =============================================================================\n// HELPERS\n// =============================================================================\n\n/**\n * Convert data values to a params object suitable for i18n interpolation.\n * Only keeps string and number values; other types are stringified.\n */\nfunction dataToParams(data?: Record<string, unknown>): Record<string, string | number> | undefined {\n  if (!data) return undefined;\n  const params: Record<string, string | number> = {};\n  for (const [key, value] of Object.entries(data)) {\n    if (typeof value === 'string' || typeof value === 'number') {\n      params[key] = value;\n    } else if (value !== null && value !== undefined && typeof value !== 'object') {\n      params[key] = String(value);\n    }\n  }\n  return Object.keys(params).length > 0 ? params : undefined;\n}\n\n/**\n * Resolve a single field label, substituting the LEAF segment when i18n resolved nothing.\n *\n * `tResourceField*` returns `unresolvedFieldLabel(path)` — the full dotted path — when no key\n * exists, which reads as `address.streetName` on a nested field. Detecting that exact fallback and\n * swapping in the leaf keeps the unresolved rendering short (`streetName`) without inventing words\n * for it, which is the whole point of #420: the key is shown BECAUSE it is a key.\n *\n * The detection is an identity comparison against the same helper, so it cannot drift from what the\n * resolver actually returns — a hand-written `resolved === path` would have had to be re-derived\n * every time that fallback changed.\n */\nfunction resolveFieldLabel(\n  path: string,\n  leaf: string,\n  resolved: string,\n): string {\n  if (path === leaf) return resolved; // top-level — unchanged behavior\n  const dottedFallback = AutomatedLayoutFrontendUtils.unresolvedFieldLabel(path);\n  return resolved === dottedFallback\n    ? AutomatedLayoutFrontendUtils.unresolvedFieldLabel(leaf)\n    : resolved;\n}\n\n\n// =============================================================================\n// HOOK\n// =============================================================================\n\n/**\n * Resolve field labels, enum labels, section labels, and wizard step labels\n * from i18n. Works for both display and edit modes.\n * \n * Fallback logic is handled by I18nContext functions themselves —\n * an unresolved field label is its raw key (leaf-shortened for nested paths),\n * an unresolved enum value is the raw value, and an unresolved description is empty.\n * \n * @param schema - The Zod schema for the resource (used to extract field names and enum values)\n * @param resourceContext - Resource type and operation ID for i18n key construction\n * @param data - Current object data for {{param}} interpolation in parameterized labels\n * @param mode - 'display' or 'edit' — determines which i18n helper to call\n * @param options - Layout refs (for ref-derived section/wizard-step i18n) and explicit key overrides\n */\nexport function useResourceLabels(\n  schema: z.ZodTypeAny,\n  resourceContext?: ResourceLabelContext,\n  data?: Record<string, unknown>,\n  mode: 'display' | 'edit' = 'display',\n  options: UseResourceLabelsOptions = {},\n): UseResourceLabelsResult {\n\n  const { t, tResourceFieldDisplay, tResourceFieldEdit, tResourceFieldEnumValue, tResourceSection, tResourceWizardStep, isReady } = useI18n({\n    resource: resourceContext?.resourceType,\n  });\n  const { layoutRefs, overrides, fieldPathPrefix } = options;\n\n  /**\n   * The i18n key a local path is looked up under — prefixed when this surface renders a nested item\n   * shape, identical otherwise. One helper so the field, description, tooltip and ENUM resolutions\n   * cannot disagree about it: an enum whose values resolved bare while its label resolved prefixed\n   * would show an authored heading over raw wire constants, which reads worse than either alone.\n   */\n  const resolveI18nPath = useCallback(\n    (path: string): string => (fieldPathPrefix ? `${fieldPathPrefix}.${path}` : path),\n    [fieldPathPrefix],\n  );\n\n  // -------------------------------------------------------------------------\n  // FIELD LABELS\n  // -------------------------------------------------------------------------\n  const fieldLabels = useMemo<Record<string, string>>(() => {\n    const result: Record<string, string> = {};\n    const params = dataToParams(data);\n\n    // Collect top-level AND nested (ObjectScope) field paths so a field rendered inside\n    // `<ObjectScope name=\"privacy\">` resolves its label by the dotted `privacy.x` key.\n    let entries: ResourceLabelFieldEntry[];\n    try {\n      entries = collectResourceLabelFieldEntries(schema);\n    } catch {\n      // Schema might not be an object (e.g., during loading)\n      return overrides?.fields ?? {};\n    }\n    if (entries.length === 0) return overrides?.fields ?? {};\n\n    for (const { path, leaf } of entries) {\n      // 1. Explicit override wins\n      if (overrides?.fields?.[path]) {\n        result[path] = overrides.fields[path];\n        continue;\n      }\n\n      // 2. i18n resolution (fallback handled internally; leaf-substituted for nested paths)\n      const i18nPath = resolveI18nPath(path);\n      if (resourceContext) {\n        const tFn = mode === 'edit' ? tResourceFieldEdit : tResourceFieldDisplay;\n        result[path] = resolveFieldLabel(i18nPath, leaf, tFn(resourceContext.resourceType, i18nPath, 'label', params));\n      } else {\n        // No resource context — the i18n function still answers, with the raw key when unresolved\n        result[path] = resolveFieldLabel(i18nPath, leaf, tResourceFieldDisplay('', i18nPath, 'label', params));\n      }\n    }\n\n    return result;\n  }, [schema, resourceContext, data, mode, overrides?.fields, resolveI18nPath, tResourceFieldDisplay, tResourceFieldEdit]);\n\n\n  // -------------------------------------------------------------------------\n  // FIELD DESCRIPTIONS\n  // -------------------------------------------------------------------------\n  // Resolution chain: explicit override → i18n → omit\n  // Only non-empty descriptions are included in the result.\n  // NOTE: Zod .describe() is NOT used here — it serves developer/AI/API doc purposes only.\n  const fieldDescriptions = useMemo<Record<string, string>>(() => {\n    const result: Record<string, string> = {};\n    const params = dataToParams(data);\n\n    // Collect top-level AND nested field paths (mirrors fieldLabels) so ObjectScope-nested\n    // fields can resolve descriptions by their dotted path.\n    let entries: ResourceLabelFieldEntry[];\n    try {\n      entries = collectResourceLabelFieldEntries(schema);\n    } catch {\n      return overrides?.descriptions ?? {};\n    }\n\n    for (const { path } of entries) {\n      // 1. Explicit override wins\n      if (overrides?.descriptions?.[path]) {\n        result[path] = overrides.descriptions[path];\n        continue;\n      }\n\n      // 2. i18n resolution (only source for descriptions — Zod .describe() is NOT used for UI)\n      if (resourceContext) {\n        const tFn = mode === 'edit' ? tResourceFieldEdit : tResourceFieldDisplay;\n        const resolved = tFn(resourceContext.resourceType, resolveI18nPath(path), 'description', params);\n        if (resolved) {\n          result[path] = resolved;\n        }\n      }\n    }\n\n    return result;\n  }, [schema, resourceContext, data, mode, overrides?.descriptions, resolveI18nPath, tResourceFieldDisplay, tResourceFieldEdit]);\n\n\n  // -------------------------------------------------------------------------\n  // FIELD TOOLTIPS\n  // -------------------------------------------------------------------------\n  // Resolution: check {primitive}UI.display.tooltip / edit.tooltip flags, then i18n\n  const fieldTooltips = useMemo<Record<string, string>>(() => {\n    const result: Record<string, string> = {};\n\n    let shape: Record<string, z.ZodTypeAny> | undefined;\n    try {\n      // Mirror `collectResourceLabelFieldEntries`: object-LIKE resolution so a discriminated-union\n      // request DTO (polymorphic resource) yields its merged field shape instead of\n      // `undefined`, and tooltips resolve for variant-only fields too.\n      shape = AutomatedLayoutFrontendUtils.getObjectLikeFieldShape(schema, { commonOnly: false });\n    } catch {\n      return {};\n    }\n    // `getObjectLikeFieldShape` RETURNS undefined (does not throw) for a non-object /\n    // not-yet-resolved schema — e.g. a transient first mount where `schema` is briefly\n    // undefined. Guard it like the sibling resolver above (~L137); without this\n    // `Object.entries(undefined)` throws and crashes the whole form via\n    // `AutomatedForm` (observed on the todos create form, 2026-06-26).\n    if (!shape) return {};\n\n    for (const [fieldName, fieldSchema] of Object.entries(shape)) {\n      const isEnabled = mode === 'display'\n        ? getFieldUIDisplayConfig(fieldSchema)?.tooltip === true\n        : getFieldUIEditConfig(fieldSchema)?.tooltip === true;\n\n      if (!isEnabled) continue;\n\n      if (resourceContext) {\n        const tFn = mode === 'edit' ? tResourceFieldEdit : tResourceFieldDisplay;\n        const resolved = tFn(resourceContext.resourceType, resolveI18nPath(fieldName), 'tooltip');\n        if (resolved) {\n          result[fieldName] = resolved;\n        }\n      }\n    }\n\n    return result;\n  }, [schema, resourceContext, mode, resolveI18nPath, tResourceFieldDisplay, tResourceFieldEdit]);\n\n\n  // -------------------------------------------------------------------------\n  // ENUM LABELS\n  // -------------------------------------------------------------------------\n  const enumLabels = useMemo<Record<string, Record<string, string>>>(() => {\n    const result: Record<string, Record<string, string>> = {};\n\n    // Collect top-level AND nested field paths (mirrors fieldLabels) so nested enum fields\n    // (`ui.theme`, `regional.dateFormat`, `privacy.consentedPurposes`) get enum labels.\n    let entries: ResourceLabelFieldEntry[];\n    try {\n      entries = collectResourceLabelFieldEntries(schema);\n    } catch {\n      return overrides?.enums ?? {};\n    }\n\n    for (const { path, schema: fieldSchema } of entries) {\n      // Resolve the enum-bearing schema: a direct enum, or the ELEMENT of an enum array\n      // (e.g. `roles: z.array(z.union([z.enum(CORE_ORG_ROLES), z.string()]))`, whose union\n      // element still yields enum values via getEnumValues). Without the array branch,\n      // array-of-enum fields rendered their members raw (e.g. `ORG_ADMIN`).\n      const enumSchema = resolveResourceLabelEnumSchema(fieldSchema);\n      if (!enumSchema) continue;\n\n      // 1. Explicit override wins\n      if (overrides?.enums?.[path]) {\n        result[path] = overrides.enums[path];\n        continue;\n      }\n\n      // 2. i18n resolution — the per-field word, else the words of the enum THIS field declares (read off\n      //    `fieldSchema`, which for a union discriminator is the collected enum carrying its variants'\n      //    declared vocabulary), else the raw value (#966)\n      if (resourceContext) {\n        const values = getEnumValues(enumSchema);\n        if (values.length > 0) {\n          const enumMap: Record<string, string> = {};\n          for (const value of values) {\n            enumMap[value] = tResourceFieldEnumValue(resourceContext.resourceType, resolveI18nPath(path), value, fieldSchema);\n          }\n          result[path] = enumMap;\n        }\n      }\n    }\n\n    return result;\n  }, [schema, resourceContext, overrides?.enums, resolveI18nPath, tResourceFieldEnumValue]);\n\n\n  // -------------------------------------------------------------------------\n  // SECTION LABELS\n  // -------------------------------------------------------------------------\n  const sectionText = useMemo(() => {\n    const labels: Record<string, string> = {};\n    const descriptions: Record<string, string> = {};\n\n    if (overrides?.sections) {\n      for (const [ref, value] of Object.entries(overrides.sections)) {\n        if (value.titleKey) {\n          const resolvedTitle = t(value.titleKey);\n          if (resolvedTitle !== value.titleKey) {\n            labels[ref] = resolvedTitle;\n          }\n        }\n        if (value.descriptionKey) {\n          const resolvedDescription = t(value.descriptionKey);\n          if (resolvedDescription !== value.descriptionKey) {\n            descriptions[ref] = resolvedDescription;\n          }\n        }\n      }\n    }\n\n    if (resourceContext && layoutRefs?.sections) {\n      const { resourceType } = resourceContext;\n      for (const ref of layoutRefs.sections) {\n        if (!labels[ref]) {\n          // A section with no generated title shows `resources.<type>.sections.<ref>.title` — the\n          // resolver's own answer for a missing primary label (#1450). It used to answer '' and this\n          // site patched the gap with the bare ref; a TITLE-LESS section is an invisible group, so a\n          // multi-section settings page read as one undifferentiated list.\n          labels[ref] = tResourceSection(resourceType, ref, 'title');\n        }\n        if (!descriptions[ref]) {\n          // Descriptions are prose — there is no sensible humanized fallback, so an\n          // absent description stays absent (the section simply renders without a\n          // sub-heading) rather than echoing the section name.\n          const resolvedDescription = tResourceSection(resourceType, ref, 'description');\n          if (resolvedDescription) {\n            descriptions[ref] = resolvedDescription;\n          }\n        }\n      }\n    }\n\n    return { labels, descriptions };\n  }, [resourceContext, layoutRefs?.sections, overrides?.sections, t, tResourceSection]);\n  const sectionLabels = sectionText.labels;\n  const sectionDescriptions = sectionText.descriptions;\n\n\n  // -------------------------------------------------------------------------\n  // WIZARD STEP LABELS (form mode only)\n  // -------------------------------------------------------------------------\n  const wizardStepText = useMemo(() => {\n    const labels: Record<string, string> = {};\n    const descriptions: Record<string, string> = {};\n\n    if (overrides?.wizardSteps) {\n      for (const [ref, value] of Object.entries(overrides.wizardSteps)) {\n        if (value.titleKey) {\n          const resolvedTitle = t(value.titleKey);\n          if (resolvedTitle !== value.titleKey) {\n            labels[ref] = resolvedTitle;\n          }\n        }\n        if (value.descriptionKey) {\n          const resolvedDescription = t(value.descriptionKey);\n          if (resolvedDescription !== value.descriptionKey) {\n            descriptions[ref] = resolvedDescription;\n          }\n        }\n      }\n    }\n\n    if (resourceContext && layoutRefs?.wizardSteps) {\n      const { resourceType } = resourceContext;\n      for (const ref of layoutRefs.wizardSteps) {\n        if (!labels[ref]) {\n          // Never empty: an ungenerated step title is its key path (#1450), so a step is never unnamed.\n          labels[ref] = tResourceWizardStep(resourceType, ref, 'title');\n        }\n        if (!descriptions[ref]) {\n          const resolvedDescription = tResourceWizardStep(resourceType, ref, 'description');\n          if (resolvedDescription) {\n            descriptions[ref] = resolvedDescription;\n          }\n        }\n      }\n    }\n\n    return { labels, descriptions };\n  }, [resourceContext, layoutRefs?.wizardSteps, overrides?.wizardSteps, t, tResourceWizardStep]);\n  const wizardStepLabels = wizardStepText.labels;\n  const wizardStepDescriptions = wizardStepText.descriptions;\n\n\n  // -------------------------------------------------------------------------\n  // GROUP LABELS\n  // -------------------------------------------------------------------------\n  // i18n key: `resources.{type}.groups.{ref}.title`\n  const groupLabels = useMemo<Record<string, string>>(() => {\n    const result: Record<string, string> = {};\n\n    if (resourceContext && layoutRefs?.groups) {\n      const { resourceType } = resourceContext;\n      for (const ref of layoutRefs.groups) {\n        const key = `resources.${resourceType}.groups.${ref}.title`;\n        const resolved = t(key);\n        if (resolved && resolved !== key) {\n          result[ref] = resolved;\n        }\n      }\n    }\n\n    return result;\n  }, [resourceContext, layoutRefs?.groups, t]);\n\n\n  return {\n    fieldLabels,\n    fieldDescriptions,\n    fieldTooltips,\n    enumLabels,\n    sectionLabels,\n    sectionDescriptions,\n    wizardStepLabels,\n    wizardStepDescriptions,\n    groupLabels,\n    isReady,\n  };\n}\n"]}
+{"version":3,"file":"useResourceLabels.js","sourceRoot":"","sources":["../../../../../src/core/resources/useResourceLabels.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * useResourceLabels — Shared hook for resolving field labels, descriptions,\n * enum labels, and section labels from i18n. An unresolved label renders as its raw key (#420).\n * \n * Used by both AutomaticDisplayer (display mode) and AutomatedForm (edit mode).\n * \n * Resolution chain for labels:\n * 1. Explicit override from labels prop wins\n * 2. i18n resolution via tResourceFieldDisplay/tResourceFieldEdit\n *    (fallback is handled internally by I18nContext — an unresolved label is the key itself, never invented words)\n * \n * Resolution chain for descriptions:\n * 1. Explicit override from labels prop wins\n * 2. i18n resolution via tResourceFieldDisplay/tResourceFieldEdit with key 'description'\n * 3. Empty string (not included in result)\n * \n * NOTE: Zod `.describe()` is NOT used for UI descriptions. It serves a different purpose\n * (developer documentation, AI prompting, API docs). UI descriptions are purely\n * decorator-driven (`.displayField({ showDescription: true })`) + i18n-resolved.\n * \n * Supports parameterized labels via {{param}} interpolation using current object data.\n */\n\nimport { useCallback, useMemo } from 'react';\nimport type { z } from 'zod';\nimport { getEnumValues, getFieldUIDisplayConfig, getFieldUIEditConfig } from '@wildo-ai/zod-decorators';\nimport type { DisplayOrFormSectionLabel } from '@wildo-ai/presets-components-models';\nimport type { LayoutRefManifest } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { AutomatedLayoutFrontendUtils } from '~wildo-frontend-lib/core/automated-layout/automated-layout.frontend.utils';\nimport {\n  collectResourceLabelFieldEntries,\n  resolveResourceLabelEnumSchema,\n  type ResourceLabelFieldEntry,\n} from '~wildo-frontend-lib/core/resources/resource-label-field-paths.frontend.utils';\n\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\nexport interface ResourceLabelContext {\n  resourceType: string;\n  operationId: string;\n}\n\nexport interface UseResourceLabelsOptions {\n  /**\n   * Structural ref manifest from `layout.refs`. Provides the list of\n   * section names and wizard step names for i18n resolution.\n   */\n  layoutRefs?: LayoutRefManifest;\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 somewhere else in the owning\n   * resource. The resolved map stays keyed by the LOCAL path the surface renders (`objective`), while\n   * the i18n lookup uses the owning path (`tasks.objective`) — so one authoring serves both surfaces\n   * and neither can drift from the other.\n   *\n   * Added for the workbench's aspect popup (#638), which renders one entry of a family document as\n   * its own root. Every field in it read as its raw schema key — `objective`, `skillRefs`,\n   * `target.moduleRef` — beside a document one click away that labels the same fields correctly,\n   * because the document authors them under `tasks.` and the popup asked for them bare.\n   *\n   * Deliberately NOT a second place to author words: it changes which key is asked for, never what\n   * happens when the key is missing. An unauthored field still renders as its key, on both surfaces,\n   * which is what `display-text-comes-from-i18n.md` asks for.\n   */\n  fieldPathPrefix?: string;\n  /**\n   * Overrides that win over the i18n tree. `fields`, `descriptions` and `enums` are TEXT as written. A section or\n   * wizard-step entry carries either a key (`titleKey` / `descriptionKey`) or text (`title` / `description`); text wins.\n   */\n  overrides?: {\n    fields?: Record<string, string>;\n    /** Explicit description overrides per field name */\n    descriptions?: Record<string, string>;\n    enums?: Record<string, Record<string, string>>;\n    sections?: Record<string, DisplayOrFormSectionLabel>;\n    wizardSteps?: Record<string, DisplayOrFormSectionLabel>;\n  };\n}\n\nexport interface UseResourceLabelsResult {\n  fieldLabels: Record<string, string>;\n  /** Resolved field descriptions. Only contains entries for fields that have a non-empty description\n   * (from i18n, explicit override, or Zod `.describe()` fallback). Empty fields are omitted. */\n  fieldDescriptions: Record<string, string>;\n  /** Resolved field tooltips. Only contains entries for fields with `{primitive}UI({ display: { tooltip: true } })`\n   * or `{primitive}UI({ edit: { tooltip: true } })` depending on the mode. Text comes from i18n. */\n  fieldTooltips: Record<string, string>;\n  enumLabels: Record<string, Record<string, string>>;\n  sectionLabels: Record<string, string>;\n  sectionDescriptions: Record<string, string>;\n  wizardStepLabels: Record<string, string>;\n  wizardStepDescriptions: Record<string, string>;\n  /** Resolved group labels (keyed by group ref). Resolved via i18n key `resources.{type}.groups.{ref}.title`. */\n  groupLabels: Record<string, string>;\n  /**\n   * Whether the underlying resource-label i18n bundle has finished loading.\n   * The maps above always return a string (the raw key when unresolved) even while\n   * `false`, so this is NOT required for correctness — it lets callers hold a\n   * skeleton until the *real* labels land instead of flashing raw keys, then\n   * swapping (see `AutomatedForm`).\n   */\n  isReady: boolean;\n}\n\n\n// =============================================================================\n// HELPERS\n// =============================================================================\n\n/**\n * Convert data values to a params object suitable for i18n interpolation.\n * Only keeps string and number values; other types are stringified.\n */\nfunction dataToParams(data?: Record<string, unknown>): Record<string, string | number> | undefined {\n  if (!data) return undefined;\n  const params: Record<string, string | number> = {};\n  for (const [key, value] of Object.entries(data)) {\n    if (typeof value === 'string' || typeof value === 'number') {\n      params[key] = value;\n    } else if (value !== null && value !== undefined && typeof value !== 'object') {\n      params[key] = String(value);\n    }\n  }\n  return Object.keys(params).length > 0 ? params : undefined;\n}\n\n/**\n * Apply section or wizard-step overrides: literal text first, then a key that resolves (#2720).\n *\n * One function for both because the precedence is one rule; written twice, a change lands at one of the two (the\n * shape `invariant-call-site-enumeration.md` records). A key that resolves to itself is a missing label and is left\n * out, so the ref-derived default below it can still answer.\n */\nfunction applySectionLabelOverrides(\n  entries: Record<string, DisplayOrFormSectionLabel> | undefined,\n  t: (key: string) => string,\n  labels: Record<string, string>,\n  descriptions: Record<string, string>,\n): void {\n  if (!entries) return;\n  for (const [ref, value] of Object.entries(entries)) {\n    if (value.title) {\n      labels[ref] = value.title;\n    } else if (value.titleKey) {\n      const resolvedTitle = t(value.titleKey);\n      if (resolvedTitle !== value.titleKey) labels[ref] = resolvedTitle;\n    }\n    if (value.description) {\n      descriptions[ref] = value.description;\n    } else if (value.descriptionKey) {\n      const resolvedDescription = t(value.descriptionKey);\n      if (resolvedDescription !== value.descriptionKey) descriptions[ref] = resolvedDescription;\n    }\n  }\n}\n\n/**\n * Resolve a single field label, substituting the LEAF segment when i18n resolved nothing.\n *\n * `tResourceField*` returns `unresolvedFieldLabel(path)` — the full dotted path — when no key\n * exists, which reads as `address.streetName` on a nested field. Detecting that exact fallback and\n * swapping in the leaf keeps the unresolved rendering short (`streetName`) without inventing words\n * for it, which is the whole point of #420: the key is shown BECAUSE it is a key.\n *\n * The detection is an identity comparison against the same helper, so it cannot drift from what the\n * resolver actually returns — a hand-written `resolved === path` would have had to be re-derived\n * every time that fallback changed.\n */\nfunction resolveFieldLabel(\n  path: string,\n  leaf: string,\n  resolved: string,\n): string {\n  if (path === leaf) return resolved; // top-level — unchanged behavior\n  const dottedFallback = AutomatedLayoutFrontendUtils.unresolvedFieldLabel(path);\n  return resolved === dottedFallback\n    ? AutomatedLayoutFrontendUtils.unresolvedFieldLabel(leaf)\n    : resolved;\n}\n\n\n// =============================================================================\n// HOOK\n// =============================================================================\n\n/**\n * Resolve field labels, enum labels, section labels, and wizard step labels\n * from i18n. Works for both display and edit modes.\n * \n * Fallback logic is handled by I18nContext functions themselves —\n * an unresolved field label is its raw key (leaf-shortened for nested paths),\n * an unresolved enum value is the raw value, and an unresolved description is empty.\n * \n * @param schema - The Zod schema for the resource (used to extract field names and enum values)\n * @param resourceContext - Resource type and operation ID for i18n key construction\n * @param data - Current object data for {{param}} interpolation in parameterized labels\n * @param mode - 'display' or 'edit' — determines which i18n helper to call\n * @param options - Layout refs (for ref-derived section/wizard-step i18n) and explicit key overrides\n */\nexport function useResourceLabels(\n  schema: z.ZodTypeAny,\n  resourceContext?: ResourceLabelContext,\n  data?: Record<string, unknown>,\n  mode: 'display' | 'edit' = 'display',\n  options: UseResourceLabelsOptions = {},\n): UseResourceLabelsResult {\n\n  const { t, tResourceFieldDisplay, tResourceFieldEdit, tResourceFieldEnumValue, tResourceSection, tResourceWizardStep, isReady } = useI18n({\n    resource: resourceContext?.resourceType,\n  });\n  const { layoutRefs, overrides, fieldPathPrefix } = options;\n\n  /**\n   * The i18n key a local path is looked up under — prefixed when this surface renders a nested item\n   * shape, identical otherwise. One helper so the field, description, tooltip and ENUM resolutions\n   * cannot disagree about it: an enum whose values resolved bare while its label resolved prefixed\n   * would show an authored heading over raw wire constants, which reads worse than either alone.\n   */\n  const resolveI18nPath = useCallback(\n    (path: string): string => (fieldPathPrefix ? `${fieldPathPrefix}.${path}` : path),\n    [fieldPathPrefix],\n  );\n\n  // -------------------------------------------------------------------------\n  // FIELD LABELS\n  // -------------------------------------------------------------------------\n  const fieldLabels = useMemo<Record<string, string>>(() => {\n    const result: Record<string, string> = {};\n    const params = dataToParams(data);\n\n    // Collect top-level AND nested (ObjectScope) field paths so a field rendered inside\n    // `<ObjectScope name=\"privacy\">` resolves its label by the dotted `privacy.x` key.\n    let entries: ResourceLabelFieldEntry[];\n    try {\n      entries = collectResourceLabelFieldEntries(schema);\n    } catch {\n      // Schema might not be an object (e.g., during loading)\n      return overrides?.fields ?? {};\n    }\n    if (entries.length === 0) return overrides?.fields ?? {};\n\n    for (const { path, leaf } of entries) {\n      // 1. Explicit override wins\n      if (overrides?.fields?.[path]) {\n        result[path] = overrides.fields[path];\n        continue;\n      }\n\n      // 2. i18n resolution (fallback handled internally; leaf-substituted for nested paths)\n      const i18nPath = resolveI18nPath(path);\n      if (resourceContext) {\n        const tFn = mode === 'edit' ? tResourceFieldEdit : tResourceFieldDisplay;\n        result[path] = resolveFieldLabel(i18nPath, leaf, tFn(resourceContext.resourceType, i18nPath, 'label', params));\n      } else {\n        // No resource context — the i18n function still answers, with the raw key when unresolved\n        result[path] = resolveFieldLabel(i18nPath, leaf, tResourceFieldDisplay('', i18nPath, 'label', params));\n      }\n    }\n\n    return result;\n  }, [schema, resourceContext, data, mode, overrides?.fields, resolveI18nPath, tResourceFieldDisplay, tResourceFieldEdit]);\n\n\n  // -------------------------------------------------------------------------\n  // FIELD DESCRIPTIONS\n  // -------------------------------------------------------------------------\n  // Resolution chain: explicit override → i18n → omit\n  // Only non-empty descriptions are included in the result.\n  // NOTE: Zod .describe() is NOT used here — it serves developer/AI/API doc purposes only.\n  const fieldDescriptions = useMemo<Record<string, string>>(() => {\n    const result: Record<string, string> = {};\n    const params = dataToParams(data);\n\n    // Collect top-level AND nested field paths (mirrors fieldLabels) so ObjectScope-nested\n    // fields can resolve descriptions by their dotted path.\n    let entries: ResourceLabelFieldEntry[];\n    try {\n      entries = collectResourceLabelFieldEntries(schema);\n    } catch {\n      return overrides?.descriptions ?? {};\n    }\n\n    for (const { path } of entries) {\n      // 1. Explicit override wins\n      if (overrides?.descriptions?.[path]) {\n        result[path] = overrides.descriptions[path];\n        continue;\n      }\n\n      // 2. i18n resolution (only source for descriptions — Zod .describe() is NOT used for UI)\n      if (resourceContext) {\n        const tFn = mode === 'edit' ? tResourceFieldEdit : tResourceFieldDisplay;\n        const resolved = tFn(resourceContext.resourceType, resolveI18nPath(path), 'description', params);\n        if (resolved) {\n          result[path] = resolved;\n        }\n      }\n    }\n\n    return result;\n  }, [schema, resourceContext, data, mode, overrides?.descriptions, resolveI18nPath, tResourceFieldDisplay, tResourceFieldEdit]);\n\n\n  // -------------------------------------------------------------------------\n  // FIELD TOOLTIPS\n  // -------------------------------------------------------------------------\n  // Resolution: check {primitive}UI.display.tooltip / edit.tooltip flags, then i18n\n  const fieldTooltips = useMemo<Record<string, string>>(() => {\n    const result: Record<string, string> = {};\n\n    let shape: Record<string, z.ZodTypeAny> | undefined;\n    try {\n      // Mirror `collectResourceLabelFieldEntries`: object-LIKE resolution so a discriminated-union\n      // request DTO (polymorphic resource) yields its merged field shape instead of\n      // `undefined`, and tooltips resolve for variant-only fields too.\n      shape = AutomatedLayoutFrontendUtils.getObjectLikeFieldShape(schema, { commonOnly: false });\n    } catch {\n      return {};\n    }\n    // `getObjectLikeFieldShape` RETURNS undefined (does not throw) for a non-object /\n    // not-yet-resolved schema — e.g. a transient first mount where `schema` is briefly\n    // undefined. Guard it like the sibling resolver above (~L137); without this\n    // `Object.entries(undefined)` throws and crashes the whole form via\n    // `AutomatedForm` (observed on the todos create form, 2026-06-26).\n    if (!shape) return {};\n\n    for (const [fieldName, fieldSchema] of Object.entries(shape)) {\n      const isEnabled = mode === 'display'\n        ? getFieldUIDisplayConfig(fieldSchema)?.tooltip === true\n        : getFieldUIEditConfig(fieldSchema)?.tooltip === true;\n\n      if (!isEnabled) continue;\n\n      if (resourceContext) {\n        const tFn = mode === 'edit' ? tResourceFieldEdit : tResourceFieldDisplay;\n        const resolved = tFn(resourceContext.resourceType, resolveI18nPath(fieldName), 'tooltip');\n        if (resolved) {\n          result[fieldName] = resolved;\n        }\n      }\n    }\n\n    return result;\n  }, [schema, resourceContext, mode, resolveI18nPath, tResourceFieldDisplay, tResourceFieldEdit]);\n\n\n  // -------------------------------------------------------------------------\n  // ENUM LABELS\n  // -------------------------------------------------------------------------\n  const enumLabels = useMemo<Record<string, Record<string, string>>>(() => {\n    const result: Record<string, Record<string, string>> = {};\n\n    // Collect top-level AND nested field paths (mirrors fieldLabels) so nested enum fields\n    // (`ui.theme`, `regional.dateFormat`, `privacy.consentedPurposes`) get enum labels.\n    let entries: ResourceLabelFieldEntry[];\n    try {\n      entries = collectResourceLabelFieldEntries(schema);\n    } catch {\n      return overrides?.enums ?? {};\n    }\n\n    for (const { path, schema: fieldSchema } of entries) {\n      // Resolve the enum-bearing schema: a direct enum, or the ELEMENT of an enum array\n      // (e.g. `roles: z.array(z.union([z.enum(CORE_ORG_ROLES), z.string()]))`, whose union\n      // element still yields enum values via getEnumValues). Without the array branch,\n      // array-of-enum fields rendered their members raw (e.g. `ORG_ADMIN`).\n      const enumSchema = resolveResourceLabelEnumSchema(fieldSchema);\n      if (!enumSchema) continue;\n\n      // 1. Explicit override wins\n      if (overrides?.enums?.[path]) {\n        result[path] = overrides.enums[path];\n        continue;\n      }\n\n      // 2. i18n resolution — the per-field word, else the words of the enum THIS field declares (read off\n      //    `fieldSchema`, which for a union discriminator is the collected enum carrying its variants'\n      //    declared vocabulary), else the raw value (#966)\n      if (resourceContext) {\n        const values = getEnumValues(enumSchema);\n        if (values.length > 0) {\n          const enumMap: Record<string, string> = {};\n          for (const value of values) {\n            enumMap[value] = tResourceFieldEnumValue(resourceContext.resourceType, resolveI18nPath(path), value, fieldSchema);\n          }\n          result[path] = enumMap;\n        }\n      }\n    }\n\n    return result;\n  }, [schema, resourceContext, overrides?.enums, resolveI18nPath, tResourceFieldEnumValue]);\n\n\n  // -------------------------------------------------------------------------\n  // SECTION LABELS\n  // -------------------------------------------------------------------------\n  const sectionText = useMemo(() => {\n    const labels: Record<string, string> = {};\n    const descriptions: Record<string, string> = {};\n\n    applySectionLabelOverrides(overrides?.sections, t, labels, descriptions);\n\n    if (resourceContext && layoutRefs?.sections) {\n      const { resourceType } = resourceContext;\n      for (const ref of layoutRefs.sections) {\n        if (!labels[ref]) {\n          // A section with no generated title shows `resources.<type>.sections.<ref>.title` — the\n          // resolver's own answer for a missing primary label (#1450). It used to answer '' and this\n          // site patched the gap with the bare ref; a TITLE-LESS section is an invisible group, so a\n          // multi-section settings page read as one undifferentiated list.\n          labels[ref] = tResourceSection(resourceType, ref, 'title');\n        }\n        if (!descriptions[ref]) {\n          // Descriptions are prose — there is no sensible humanized fallback, so an\n          // absent description stays absent (the section simply renders without a\n          // sub-heading) rather than echoing the section name.\n          const resolvedDescription = tResourceSection(resourceType, ref, 'description');\n          if (resolvedDescription) {\n            descriptions[ref] = resolvedDescription;\n          }\n        }\n      }\n    }\n\n    return { labels, descriptions };\n  }, [resourceContext, layoutRefs?.sections, overrides?.sections, t, tResourceSection]);\n  const sectionLabels = sectionText.labels;\n  const sectionDescriptions = sectionText.descriptions;\n\n\n  // -------------------------------------------------------------------------\n  // WIZARD STEP LABELS (form mode only)\n  // -------------------------------------------------------------------------\n  const wizardStepText = useMemo(() => {\n    const labels: Record<string, string> = {};\n    const descriptions: Record<string, string> = {};\n\n    applySectionLabelOverrides(overrides?.wizardSteps, t, labels, descriptions);\n\n    if (resourceContext && layoutRefs?.wizardSteps) {\n      const { resourceType } = resourceContext;\n      for (const ref of layoutRefs.wizardSteps) {\n        if (!labels[ref]) {\n          // Never empty: an ungenerated step title is its key path (#1450), so a step is never unnamed.\n          labels[ref] = tResourceWizardStep(resourceType, ref, 'title');\n        }\n        if (!descriptions[ref]) {\n          const resolvedDescription = tResourceWizardStep(resourceType, ref, 'description');\n          if (resolvedDescription) {\n            descriptions[ref] = resolvedDescription;\n          }\n        }\n      }\n    }\n\n    return { labels, descriptions };\n  }, [resourceContext, layoutRefs?.wizardSteps, overrides?.wizardSteps, t, tResourceWizardStep]);\n  const wizardStepLabels = wizardStepText.labels;\n  const wizardStepDescriptions = wizardStepText.descriptions;\n\n\n  // -------------------------------------------------------------------------\n  // GROUP LABELS\n  // -------------------------------------------------------------------------\n  // i18n key: `resources.{type}.groups.{ref}.title`\n  const groupLabels = useMemo<Record<string, string>>(() => {\n    const result: Record<string, string> = {};\n\n    if (resourceContext && layoutRefs?.groups) {\n      const { resourceType } = resourceContext;\n      for (const ref of layoutRefs.groups) {\n        const key = `resources.${resourceType}.groups.${ref}.title`;\n        const resolved = t(key);\n        if (resolved && resolved !== key) {\n          result[ref] = resolved;\n        }\n      }\n    }\n\n    return result;\n  }, [resourceContext, layoutRefs?.groups, t]);\n\n\n  return {\n    fieldLabels,\n    fieldDescriptions,\n    fieldTooltips,\n    enumLabels,\n    sectionLabels,\n    sectionDescriptions,\n    wizardStepLabels,\n    wizardStepDescriptions,\n    groupLabels,\n    isReady,\n  };\n}\n"]}

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

@@ -13,7 +13,8 @@ import type { FrontendResource_ParentResourceRequirement } from '../../core/reso
 import type { FrontendResourceConfiguration_Operation } from '../../core/resources/resources.frontend.schemas';
 import { ActionPlacement } from '../../core/resources/resources.frontend.schemas';
 import { type ActionBarItem } from '../../components/actions/action-bar';
-import { ResourceOperationDisplayMode, type ResourceType } from '@wildo-ai/saas-models';
+import { type ResourceOperationSemanticsLike } from './operation-semantics.frontend.utils';
+import { ResourceOperationDisplayMode, type ResourceType, type DataMode } from '@wildo-ai/saas-models';
 export interface UseResourceOperationActionsParams {
     /** Resource type identifier */
     resourceType: ResourceType;
@@ -21,6 +22,11 @@ export interface UseResourceOperationActionsParams {
     displayMode: ResourceOperationDisplayMode;
     /** Current item data (for enabledCondition evaluation and operation execution) */
     currentObject?: Record<string, any>;
+    /**
+     * The data mode `currentObject` and `selectionObjects` were fetched in, when known (a list passes its LIST data
+     * mode). Lets a development build name an `enabledCondition` that reads a field a SUMMARY row cannot carry (#2467).
+     */
+    currentObjectDataMode?: DataMode;
     /** Context resource identifiers (parent IDs, etc.) */
     contextResourceIdentifiers: Record<string, string | {
         fieldIdentifier: string;
@@ -30,8 +36,12 @@ export interface UseResourceOperationActionsParams {
     parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];
     /** Navigation zone this component lives in */
     navigationZone: NavigationZone;
-    /** Operation ID for navigation initiator context */
-    operationId?: string;
+    /**
+     * The operation of the surface hosting these actions, recorded in the navigation initiator as the core operation it
+     * behaves like (see `NavigationUtils.createOperationInitiator`). The OPERATION rather than its identifier, because an
+     * application's own operation is recorded through its `resourceOperationLike`.
+     */
+    sourceOperation?: ResourceOperationSemanticsLike;
     /** Operations to exclude from display */
     excludeOperations?: string[];
     /** Only show bulk operations */
@@ -63,8 +73,17 @@ export interface UseResourceOperationActionsParams {
      * unsearched set would be a wrong answer delivered as a successful download.
      */
     collectionExportQuery?: {
-        params: Record<string, string | number | undefined>;
+        /** Sort, pagination and filters; a filter value may be structured (a date window, a number range). */
+        params: Record<string, unknown>;
         isSearchActive: boolean;
+        /**
+         * The VARIANT the listing shows per verb (a key, `null` for unkeyed): an export is offered only where it re-runs
+         * that variant (`collectionExportReRunsListingVariant`, #2705).
+         */
+        listingVariantKeys?: {
+            list?: string | null;
+            search?: string | null;
+        };
     };
     /** Restrict returned items to a single action placement — `PRIMARY` for the main
      *  action bar, `DANGER_ZONE` for the danger-zone section. Omitted returns all

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

@@ -1 +1 @@
-{"version":3,"file":"useResourceOperationActions.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/useResourceOperationActions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useResourceOperationActions.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/useResourceOperationActions.ts"],"names":[],"mappings":"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"}