npm - @wildo-ai/saas-frontend-lib - Versions diffs - 1.1.2 → 1.1.3 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1917) hide show

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

@@ -134,17 +134,23 @@ function collectFieldEntries(schema, prefix, depth, acc) {
     }
 }
 /**
- * Resolve a single field label, substituting the formatted LEAF segment when i18n is absent.
- * `tResourceField*` falls back to `formatFieldLabelFallback(path)` (the full dotted path) when
- * no key exists, which reads as an ugly "Parent.child" for nested fields — so when we detect
- * that dotted fallback on a nested path, swap in the clean leaf-only label instead.
+ * Resolve a single field label, substituting the LEAF segment when i18n resolved nothing.
+ *
+ * `tResourceField*` returns `unresolvedFieldLabel(path)` — the full dotted path — when no key
+ * exists, which reads as `address.streetName` on a nested field. Detecting that exact fallback and
+ * swapping in the leaf keeps the unresolved rendering short (`streetName`) without inventing words
+ * for it, which is the whole point of #420: the key is shown BECAUSE it is a key.
+ *
+ * The detection is an identity comparison against the same helper, so it cannot drift from what the
+ * resolver actually returns — a hand-written `resolved === path` would have had to be re-derived
+ * every time that fallback changed.
  */
 function resolveFieldLabel(path, leaf, resolved) {
     if (path === leaf)
         return resolved; // top-level — unchanged behavior
-    const dottedFallback = AutomatedLayoutFrontendUtils.formatFieldLabelFallback(path);
+    const dottedFallback = AutomatedLayoutFrontendUtils.unresolvedFieldLabel(path);
     return resolved === dottedFallback
-        ? AutomatedLayoutFrontendUtils.formatFieldLabelFallback(leaf)
+        ? AutomatedLayoutFrontendUtils.unresolvedFieldLabel(leaf)
         : resolved;
 }
 // =============================================================================
@@ -357,14 +363,14 @@ export function useResourceLabels(schema, resourceContext, data, mode = 'display
             for (const ref of layoutRefs.sections) {
                 if (!labels[ref]) {
                     const resolvedLabel = tResourceSection(resourceType, ref, 'title');
-                    // Humanize-fallback the section NAME when no i18n title has been generated
-                    // yet — mirrors field labels, which always fall back to
-                    // `formatFieldLabelFallback`. Without this a section whose label hasn't
-                    // been generated renders TITLE-LESS (an invisible group), so a multi-section
-                    // settings/display page reads as one undifferentiated list (the headings
-                    // simply never appear). A real generated/authored title still wins; this only
-                    // fills the gap so a declared section is always a visible, named group.
-                    labels[ref] = resolvedLabel || AutomatedLayoutFrontendUtils.formatFieldLabelFallback(ref);
+                    // 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);
                 }
                 if (!descriptions[ref]) {
                     // Descriptions are prose — there is no sensible humanized fallback, so an

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

	@@ -1 +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 with fallback to camelCase formatting.\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 — consumers always get a usable string)\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 { useMemo } from 'react';\nimport { z } from 'zod';\nimport { FieldSchemaType, getArrayItemSchema, getEnumValues, getSchemaType, getFieldUIDisplayConfig, getFieldUIEditConfig, getZodObjectShape, unwrapSchema } 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';\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 /* 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 usable strings (formatted field-name fallbacks)\n * even while `false`, so this is NOT required for correctness — it lets callers\n * hold a skeleton until the real labels land instead of flashing the\n * humanized field-name fallback, then 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/* Max object-nesting depth walked when collecting label/enum entries (guards against\n * pathological / self-referential schemas while covering real nested settings objects\n * like `privacy.dataProcessingConsent` and `regional.dateFormat`). /\nconst MAX_NESTED_FIELD_DEPTH = 4;\n\n/* A field reachable from the resource schema, identified by its dotted runtime path. /\ninterface CollectedFieldEntry {\n /* Dotted path as seen by `DisplayField`/`FormField` inside an `ObjectScope` (e.g. `privacy.dataProcessingConsent`). /\n path: string;\n /* Final path segment, used for the human-readable fallback label. /\n leaf: string;\n /* The field's Zod schema (decorators intact). /\n schema: z.ZodTypeAny;\n}\n\n/\n Flatten a resource schema into every label-bearing field path, recursing into nested\n * OBJECT fields so that fields rendered inside an `<ObjectScope name=\"privacy\">` (which look\n * their labels/enum-labels up by the dotted `privacy.dataProcessingConsent` key) resolve the\n * same way top-level fields do. Without this, nested object fields fell back to no label /\n * raw enum values. Arrays are recorded as leaves (their element enum, if any, is handled by\n * the enum-labels pass) but not descended into — per-index paths are dynamic.\n /\nfunction collectFieldEntries(\n schema: z.ZodTypeAny,\n prefix: string,\n depth: number,\n acc: CollectedFieldEntry[],\n): void {\n let shape: Record<string, z.ZodTypeAny> \| undefined;\n try {\n // Resolve the field shape the SAME way the form/display RENDER path does\n // (`extractSchemaFieldList` / `formFieldShape` → `getObjectLikeFieldShape`).\n // Polymorphic resources (e.g. todos) feed the form a `z.discriminatedUnion`\n // request DTO; the object-only `getObjectShape` returns `null` for a union, so\n // labels silently fell back to raw camelCase while the renderer happily showed\n // every field (functional-but-unlabelled). `getObjectLikeFieldShape` treats a\n // discriminated-union-of-objects as a single object-like field set; `commonOnly:\n // false` MERGES keys across every variant so variant-only fields (rendered under\n // a `<DiscriminatorSwitch>`, e.g. `recurrence`/`startDate`) also resolve labels.\n shape = AutomatedLayoutFrontendUtils.getObjectLikeFieldShape(schema, { commonOnly: false });\n } catch {\n return;\n }\n if (!shape) return;\n\n /\n * A DISCRIMINATED UNION's discriminator must collect its values across EVERY variant.\n \n The merged shape above keeps the FIRST variant's schema per key, which is right for the\n * variant-only fields (each has one owner) and silently wrong for the one key every variant\n * declares: the discriminator, a per-variant `z.literal`. Collected as the first variant's\n * literal, its label map knew exactly one value — measured on the workbench build plan, where\n * `target.kind` is a five-variant union: the authored `enum` labels served fine for `MODULE`\n * and every other task printed the raw wire constant (`RESOURCE_STAGE`, fifty-odd times down\n * the page), while its SIBLING `stage` resolved perfectly because only one variant declares it.\n \n So: where several variants declare the same key as distinct string literals, the collected\n * schema becomes their union as a `z.enum`, and `getEnumValues` below sees the full vocabulary.\n * The render path needs no change — it resolves the ACTUAL variant and looks its value up in\n * this map.\n /\n const unionOptions = AutomatedLayoutFrontendUtils.getDiscriminatedUnionObjectOptions(unwrapSchema(schema));\n const discriminatorEnums: Record<string, z.ZodTypeAny> = {};\n if (unionOptions.length > 1) {\n const literalValuesByKey: Record<string, string[]> = {};\n for (const option of unionOptions) {\n for (const [name, fieldSchema] of Object.entries(getZodObjectShape(option))) {\n const values = getEnumValues(fieldSchema as z.ZodTypeAny);\n if (values.length !== 1) continue;\n (literalValuesByKey[name] ??= []).push(values[0]);\n }\n }\n for (const [name, values] of Object.entries(literalValuesByKey)) {\n if (values.length > 1) discriminatorEnums[name] = z.enum(values as [string, ...string[]]);\n }\n }\n\n for (const [name, fieldSchema] of Object.entries(shape)) {\n const path = prefix ? `${prefix}.${name}` : name;\n acc.push({ path, leaf: name, schema: discriminatorEnums[name] ?? fieldSchema });\n if (depth < MAX_NESTED_FIELD_DEPTH && getSchemaType(fieldSchema) === FieldSchemaType.OBJECT) {\n collectFieldEntries(fieldSchema, path, depth + 1, acc);\n }\n /\n * Descend into ARRAY-OF-OBJECT items too, under the item's INDEX-FREE path\n * (`successCriteria.horizon`, never `successCriteria[0].horizon`): every item of one array\n * shares one schema, so labels are per-FIELD, not per-row. Without this, a labelled enum\n * inside an entry collection — a criterion's `horizon`, a constraint's `kind` — had no entry\n * in `enumLabels`/`fieldLabels` at all and rendered its raw wire value, while the identical\n * enum ONE level up resolved fine. The render path strips indices before its lookup\n * (`DisplayField`), so the two sides meet on the same key.\n /\n if (depth < MAX_NESTED_FIELD_DEPTH && getSchemaType(fieldSchema) === FieldSchemaType.ARRAY) {\n const itemSchema = getArrayItemSchema(fieldSchema);\n if (itemSchema && getSchemaType(itemSchema) === FieldSchemaType.OBJECT) {\n collectFieldEntries(itemSchema, path, depth + 1, acc);\n }\n }\n }\n}\n\n/\n Resolve a single field label, substituting the formatted LEAF segment when i18n is absent.\n * `tResourceField` falls back to `formatFieldLabelFallback(path)` (the full dotted path) when\n no key exists, which reads as an ugly \"Parent.child\" for nested fields — so when we detect\n * that dotted fallback on a nested path, swap in the clean leaf-only label instead.\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.formatFieldLabelFallback(path);\n return resolved === dottedFallback\n ? AutomatedLayoutFrontendUtils.formatFieldLabelFallback(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 * they never return raw keys, always a usable string (formatted field name,\n * raw enum value, or empty string).\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 } = options;\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 const entries: CollectedFieldEntry[] = [];\n try {\n collectFieldEntries(schema, '', 0, entries);\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 if (resourceContext) {\n const tFn = mode === 'edit' ? tResourceFieldEdit : tResourceFieldDisplay;\n result[path] = resolveFieldLabel(path, leaf, tFn(resourceContext.resourceType, path, 'label', params));\n } else {\n // No resource context — use the i18n function which will fallback to formatted name\n result[path] = resolveFieldLabel(path, leaf, tResourceFieldDisplay('', path, 'label', params));\n }\n }\n\n return result;\n }, [schema, resourceContext, data, mode, overrides?.fields, 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 const entries: CollectedFieldEntry[] = [];\n try {\n collectFieldEntries(schema, '', 0, entries);\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, path, 'description', params);\n if (resolved) {\n result[path] = resolved;\n }\n }\n }\n\n return result;\n }, [schema, resourceContext, data, mode, overrides?.descriptions, 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 `collectFieldEntries`: 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, fieldName, 'tooltip');\n if (resolved) {\n result[fieldName] = resolved;\n }\n }\n }\n\n return result;\n }, [schema, resourceContext, mode, 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.dataProcessingConsent`) get enum labels.\n const entries: CollectedFieldEntry[] = [];\n try {\n collectFieldEntries(schema, '', 0, entries);\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 schemaType = getSchemaType(fieldSchema);\n let enumSchema: z.ZodTypeAny \| undefined;\n if (schemaType === FieldSchemaType.ENUM) {\n enumSchema = fieldSchema;\n } else if (schemaType === FieldSchemaType.ARRAY) {\n const itemSchema = getArrayItemSchema(fieldSchema);\n if (itemSchema && getSchemaType(itemSchema) === FieldSchemaType.ENUM) {\n enumSchema = itemSchema;\n }\n }\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 (tResourceFieldEnumValue auto-cascades to system enum labels)\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, path, value);\n }\n result[path] = enumMap;\n }\n }\n }\n\n return result;\n }, [schema, resourceContext, overrides?.enums, 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 const resolvedLabel = tResourceSection(resourceType, ref, 'title');\n // Humanize-fallback the section NAME when no i18n title has been generated\n // yet — mirrors field labels, which always fall back to\n // `formatFieldLabelFallback`. Without this a section whose label hasn't\n // been generated renders TITLE-LESS (an invisible group), so a multi-section\n // settings/display page reads as one undifferentiated list (the headings\n // simply never appear). A real generated/authored title still wins; this only\n // fills the gap so a declared section is always a visible, named group.\n labels[ref] = resolvedLabel \|\| AutomatedLayoutFrontendUtils.formatFieldLabelFallback(ref);\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 const resolvedLabel = tResourceWizardStep(resourceType, ref, 'title');\n if (resolvedLabel) {\n labels[ref] = resolvedLabel;\n }\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"]}
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 with fallback to camelCase formatting.\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 — consumers always get a usable string)\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 { useMemo } from 'react';\nimport { z } from 'zod';\nimport { FieldSchemaType, getArrayItemSchema, getEnumValues, getSchemaType, getFieldUIDisplayConfig, getFieldUIEditConfig, getZodObjectShape, unwrapSchema } 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';\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 /* 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 usable strings (formatted field-name fallbacks)\n * even while `false`, so this is NOT required for correctness — it lets callers\n * hold a skeleton until the real labels land instead of flashing the\n * humanized field-name fallback, then 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/* Max object-nesting depth walked when collecting label/enum entries (guards against\n * pathological / self-referential schemas while covering real nested settings objects\n * like `privacy.dataProcessingConsent` and `regional.dateFormat`). /\nconst MAX_NESTED_FIELD_DEPTH = 4;\n\n/* A field reachable from the resource schema, identified by its dotted runtime path. /\ninterface CollectedFieldEntry {\n /* Dotted path as seen by `DisplayField`/`FormField` inside an `ObjectScope` (e.g. `privacy.dataProcessingConsent`). /\n path: string;\n /* Final path segment, used for the human-readable fallback label. /\n leaf: string;\n /* The field's Zod schema (decorators intact). /\n schema: z.ZodTypeAny;\n}\n\n/\n Flatten a resource schema into every label-bearing field path, recursing into nested\n * OBJECT fields so that fields rendered inside an `<ObjectScope name=\"privacy\">` (which look\n * their labels/enum-labels up by the dotted `privacy.dataProcessingConsent` key) resolve the\n * same way top-level fields do. Without this, nested object fields fell back to no label /\n * raw enum values. Arrays are recorded as leaves (their element enum, if any, is handled by\n * the enum-labels pass) but not descended into — per-index paths are dynamic.\n /\nfunction collectFieldEntries(\n schema: z.ZodTypeAny,\n prefix: string,\n depth: number,\n acc: CollectedFieldEntry[],\n): void {\n let shape: Record<string, z.ZodTypeAny> \| undefined;\n try {\n // Resolve the field shape the SAME way the form/display RENDER path does\n // (`extractSchemaFieldList` / `formFieldShape` → `getObjectLikeFieldShape`).\n // Polymorphic resources (e.g. todos) feed the form a `z.discriminatedUnion`\n // request DTO; the object-only `getObjectShape` returns `null` for a union, so\n // labels silently fell back to raw camelCase while the renderer happily showed\n // every field (functional-but-unlabelled). `getObjectLikeFieldShape` treats a\n // discriminated-union-of-objects as a single object-like field set; `commonOnly:\n // false` MERGES keys across every variant so variant-only fields (rendered under\n // a `<DiscriminatorSwitch>`, e.g. `recurrence`/`startDate`) also resolve labels.\n shape = AutomatedLayoutFrontendUtils.getObjectLikeFieldShape(schema, { commonOnly: false });\n } catch {\n return;\n }\n if (!shape) return;\n\n /\n * A DISCRIMINATED UNION's discriminator must collect its values across EVERY variant.\n \n The merged shape above keeps the FIRST variant's schema per key, which is right for the\n * variant-only fields (each has one owner) and silently wrong for the one key every variant\n * declares: the discriminator, a per-variant `z.literal`. Collected as the first variant's\n * literal, its label map knew exactly one value — measured on the workbench build plan, where\n * `target.kind` is a five-variant union: the authored `enum` labels served fine for `MODULE`\n * and every other task printed the raw wire constant (`RESOURCE_STAGE`, fifty-odd times down\n * the page), while its SIBLING `stage` resolved perfectly because only one variant declares it.\n \n So: where several variants declare the same key as distinct string literals, the collected\n * schema becomes their union as a `z.enum`, and `getEnumValues` below sees the full vocabulary.\n * The render path needs no change — it resolves the ACTUAL variant and looks its value up in\n * this map.\n /\n const unionOptions = AutomatedLayoutFrontendUtils.getDiscriminatedUnionObjectOptions(unwrapSchema(schema));\n const discriminatorEnums: Record<string, z.ZodTypeAny> = {};\n if (unionOptions.length > 1) {\n const literalValuesByKey: Record<string, string[]> = {};\n for (const option of unionOptions) {\n for (const [name, fieldSchema] of Object.entries(getZodObjectShape(option))) {\n const values = getEnumValues(fieldSchema as z.ZodTypeAny);\n if (values.length !== 1) continue;\n (literalValuesByKey[name] ??= []).push(values[0]);\n }\n }\n for (const [name, values] of Object.entries(literalValuesByKey)) {\n if (values.length > 1) discriminatorEnums[name] = z.enum(values as [string, ...string[]]);\n }\n }\n\n for (const [name, fieldSchema] of Object.entries(shape)) {\n const path = prefix ? `${prefix}.${name}` : name;\n acc.push({ path, leaf: name, schema: discriminatorEnums[name] ?? fieldSchema });\n if (depth < MAX_NESTED_FIELD_DEPTH && getSchemaType(fieldSchema) === FieldSchemaType.OBJECT) {\n collectFieldEntries(fieldSchema, path, depth + 1, acc);\n }\n /\n * Descend into ARRAY-OF-OBJECT items too, under the item's INDEX-FREE path\n * (`successCriteria.horizon`, never `successCriteria[0].horizon`): every item of one array\n * shares one schema, so labels are per-FIELD, not per-row. Without this, a labelled enum\n * inside an entry collection — a criterion's `horizon`, a constraint's `kind` — had no entry\n * in `enumLabels`/`fieldLabels` at all and rendered its raw wire value, while the identical\n * enum ONE level up resolved fine. The render path strips indices before its lookup\n * (`DisplayField`), so the two sides meet on the same key.\n /\n if (depth < MAX_NESTED_FIELD_DEPTH && getSchemaType(fieldSchema) === FieldSchemaType.ARRAY) {\n const itemSchema = getArrayItemSchema(fieldSchema);\n if (itemSchema && getSchemaType(itemSchema) === FieldSchemaType.OBJECT) {\n collectFieldEntries(itemSchema, path, depth + 1, acc);\n }\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 * they never return raw keys, always a usable string (formatted field name,\n * raw enum value, or empty string).\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 } = options;\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 const entries: CollectedFieldEntry[] = [];\n try {\n collectFieldEntries(schema, '', 0, entries);\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 if (resourceContext) {\n const tFn = mode === 'edit' ? tResourceFieldEdit : tResourceFieldDisplay;\n result[path] = resolveFieldLabel(path, leaf, tFn(resourceContext.resourceType, path, 'label', params));\n } else {\n // No resource context — use the i18n function which will fallback to formatted name\n result[path] = resolveFieldLabel(path, leaf, tResourceFieldDisplay('', path, 'label', params));\n }\n }\n\n return result;\n }, [schema, resourceContext, data, mode, overrides?.fields, 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 const entries: CollectedFieldEntry[] = [];\n try {\n collectFieldEntries(schema, '', 0, entries);\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, path, 'description', params);\n if (resolved) {\n result[path] = resolved;\n }\n }\n }\n\n return result;\n }, [schema, resourceContext, data, mode, overrides?.descriptions, 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 `collectFieldEntries`: 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, fieldName, 'tooltip');\n if (resolved) {\n result[fieldName] = resolved;\n }\n }\n }\n\n return result;\n }, [schema, resourceContext, mode, 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.dataProcessingConsent`) get enum labels.\n const entries: CollectedFieldEntry[] = [];\n try {\n collectFieldEntries(schema, '', 0, entries);\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 schemaType = getSchemaType(fieldSchema);\n let enumSchema: z.ZodTypeAny \| undefined;\n if (schemaType === FieldSchemaType.ENUM) {\n enumSchema = fieldSchema;\n } else if (schemaType === FieldSchemaType.ARRAY) {\n const itemSchema = getArrayItemSchema(fieldSchema);\n if (itemSchema && getSchemaType(itemSchema) === FieldSchemaType.ENUM) {\n enumSchema = itemSchema;\n }\n }\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 (tResourceFieldEnumValue auto-cascades to system enum labels)\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, path, value);\n }\n result[path] = enumMap;\n }\n }\n }\n\n return result;\n }, [schema, resourceContext, overrides?.enums, 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 const resolvedLabel = tResourceSection(resourceType, ref, 'title');\n // Fall back to the section REF when no i18n title has been generated yet — the same\n // unresolved rendering field labels use, and for the same reason: it is visibly a key,\n // so it gets authored. Without any fallback a section renders TITLE-LESS (an invisible\n // group), so a multi-section settings page reads as one undifferentiated list — the\n // headings simply never appear, which is a worse failure than a visible raw ref. A real\n // generated or authored title still wins; this only keeps a declared section a visible,\n // named group.\n labels[ref] = resolvedLabel \|\| AutomatedLayoutFrontendUtils.unresolvedFieldLabel(ref);\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 const resolvedLabel = tResourceWizardStep(resourceType, ref, 'title');\n if (resolvedLabel) {\n labels[ref] = resolvedLabel;\n }\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.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useResourceOperationActions.d.ts","sourceRoot":"","sources":["~~../../../../../~~src/core/resources/useResourceOperationActions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA8BH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wDAAwD,CAAC;AAE7F,OAAO,EAA0B,KAAK,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC3F,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,mEAAmE,CAAC;AACpI,OAAO,KAAK,EAAE,uCAAuC,EAAiC,MAAM,+DAA+D,CAAC;AAC5J,OAAO,EAAoB,eAAe,EAA0I,MAAM,+DAA+D,CAAC;AAC1P,OAAO,KAAK,EAAE,aAAa,EAA8D,MAAM,mDAAmD,CAAC;AA8BnJ,OAAO,EAGL,4BAA4B,EAa5B,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAgD/B,MAAM,WAAW,iCAAiC;IAChD,+BAA+B;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,yEAAyE;IACzE,WAAW,EAAE,4BAA4B,CAAC;IAC1C,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpC,sDAAsD;IACtD,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrG,mCAAmC;IACnC,2BAA2B,CAAC,EAAE,0CAA0C,EAAE,CAAC;IAC3E,8CAA8C;IAC9C,cAAc,EAAE,cAAc,CAAC;IAC/B,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,gCAAgC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;;OAOG;IACH,qBAAqB,CAAC,EAAE;QACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;QACpD,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC;IACF;;wEAEoE;IACpE,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,uFAAuF;IACvF,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,0EAA0E;IAC1E,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;sEACkE;IAClE,mBAAmB,CAAC,EAAE,CAAC,SAAS,EAAE,uCAAuC,KAAK,IAAI,CAAC;CACpF;AAED,MAAM,WAAW,iCAAiC;IAChD,wDAAwD;IACxD,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,sDAAsD;IACtD,mBAAmB,EAAE,OAAO,CAAC;IAC7B,wCAAwC;IACxC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uFAAuF;IACvF,gCAAgC,EAAE,OAAO,CAAC;IAC1C,gGAAgG;IAChG,yBAAyB,EAAE,MAAM,CAAC;IAClC,oDAAoD;IACpD,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,mDAAmD;IACnD,WAAW,EAAE,OAAO,CAAC;IACrB,gFAAgF;IAChF,eAAe,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC;IAC7C,+DAA+D;IAC/D,sBAAsB,EAAE,MAAM,IAAI,CAAC;CACpC;AAiID,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,iCAAiC,GACxC,iCAAiC,CAw8CnC"}
1	+ {"version":3,"file":"useResourceOperationActions.d.ts","sourceRoot":"","sources":["../../../../src/core/resources/useResourceOperationActions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA8BH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wDAAwD,CAAC;AAE7F,OAAO,EAA0B,KAAK,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC3F,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,mEAAmE,CAAC;AACpI,OAAO,KAAK,EAAE,uCAAuC,EAAiC,MAAM,+DAA+D,CAAC;AAC5J,OAAO,EAAoB,eAAe,EAA0I,MAAM,+DAA+D,CAAC;AAC1P,OAAO,KAAK,EAAE,aAAa,EAA8D,MAAM,mDAAmD,CAAC;AA8BnJ,OAAO,EAGL,4BAA4B,EAa5B,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAgD/B,MAAM,WAAW,iCAAiC;IAChD,+BAA+B;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,yEAAyE;IACzE,WAAW,EAAE,4BAA4B,CAAC;IAC1C,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpC,sDAAsD;IACtD,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrG,mCAAmC;IACnC,2BAA2B,CAAC,EAAE,0CAA0C,EAAE,CAAC;IAC3E,8CAA8C;IAC9C,cAAc,EAAE,cAAc,CAAC;IAC/B,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,gCAAgC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;;OAOG;IACH,qBAAqB,CAAC,EAAE;QACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;QACpD,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC;IACF;;wEAEoE;IACpE,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,uFAAuF;IACvF,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,0EAA0E;IAC1E,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;sEACkE;IAClE,mBAAmB,CAAC,EAAE,CAAC,SAAS,EAAE,uCAAuC,KAAK,IAAI,CAAC;CACpF;AAED,MAAM,WAAW,iCAAiC;IAChD,wDAAwD;IACxD,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,sDAAsD;IACtD,mBAAmB,EAAE,OAAO,CAAC;IAC7B,wCAAwC;IACxC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uFAAuF;IACvF,gCAAgC,EAAE,OAAO,CAAC;IAC1C,gGAAgG;IAChG,yBAAyB,EAAE,MAAM,CAAC;IAClC,oDAAoD;IACpD,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,mDAAmD;IACnD,WAAW,EAAE,OAAO,CAAC;IACrB,gFAAgF;IAChF,eAAe,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC;IAC7C,+DAA+D;IAC/D,sBAAsB,EAAE,MAAM,IAAI,CAAC;CACpC;AAiID,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,iCAAiC,GACxC,iCAAiC,CAw8CnC"}