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

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

@@ -0,0 +1,220 @@
+/**
+ * One record's sharing with the organization's relationships (#2736), for the administrator of the granting organization.
+ *
+ * #2722 separated records between an organization's relationships: a record created through one relationship is that
+ * relationship's, and the organization's own records reach a representative only as its relationship kind allows. The
+ * organization's administrators widen that record by record with `shareRecord` / `unshareRecord` on the relationship.
+ *
+ * Everything the screen says comes from one administrator-only read, `readRecordSharing`, which answers whose the record
+ * is, who it is shared with, and for every live relationship (and any other the record names) what its people reach of
+ * the record: whether it confers now, whether its roles reach this record (its role and lent capabilities, and its units
+ * for a relationship limited to units), whether it reads the record without a share, and whether a share would let it.
+ * The backend decides each with the request path's own predicates and the authorizer's own answer, so the screen never
+ * offers a share that changes nothing (a record no relationship can read, a relationship that already reads it, a dormant
+ * relationship) and never claims a reach the engine would not grant (#2736 review N1, N2, M1). The
+ * provenance and shares are stripped from the record's own response: a representative reading a shared record never
+ * learns which other relationships it reaches.
+ *
+ * A resource the backend will not share at all (a system of record's rows, which have no table to hold a share) answers
+ * `RELATIONSHIP_RECORD_NOT_SHAREABLE`: the screen then has nothing to offer and says nothing
+ * ({@link RecordSharingReadState.NOT_SHAREABLE}). Any other failure is a read that did not complete and is shown as one.
+ * Presentation only: the backend authorizes every call.
+ */
+import { useCallback, useContext, useEffect, useRef, useState } from 'react';
+import { CoreResourceType, OrganizationRelationshipErrorCode, OrganizationRelationships_Operations, RelationshipRecordSharingSchema, ResourceOperationVariantType, ResourcesConfig_OperationPathUtils, isWildoBackendError, } from '@wildo-ai/saas-models';
+import { ResourceRegistryContext } from '../../core/resources/ResourceRegistryContext.js';
+import { ScopeUtilsService } from '../../core/scope/scope.utils.frontend.service.js';
+import { FrontendResourceUtils, frontendResourceUtils } from '../../core/resources/frontend-resource.utils.js';
+import { LoggerFrontendService } from '../../core/monitoring/logger.frontend.service.js';
+const logger = LoggerFrontendService.getLogger();
+/** Where the screen's read stands. */
+export var RecordSharingReadState;
+(function (RecordSharingReadState) {
+    /** Nothing is asked: the screen is not offered here. */
+    RecordSharingReadState["IDLE"] = "idle";
+    /** Asked; the answer has not arrived. The screen shows nothing yet, so nothing is offered first and withdrawn after. */
+    RecordSharingReadState["LOADING"] = "loading";
+    /** The read answered, for the record now on screen. */
+    RecordSharingReadState["READY"] = "ready";
+    /** The backend does not share records of this resource. The screen shows nothing. */
+    RecordSharingReadState["NOT_SHAREABLE"] = "not_shareable";
+    /** A read failed. The screen says so and offers nothing. */
+    RecordSharingReadState["FAILED"] = "failed";
+})(RecordSharingReadState || (RecordSharingReadState = {}));
+/**
+ * The relationships resource's default API operation `identifier`, as this frontend registers it; `undefined` when it is
+ * not registered, which leaves the screen with nothing to offer rather than a guessed URL.
+ */
+export function findRelationshipOperation(registry, identifier) {
+    const operations = registry?.resourceConfigurations[CoreResourceType.ORGANIZATION_RELATIONSHIPS]?.operations;
+    return operations?.find((operation) => String(operation.operationIdentifier) === identifier
+        && operation.isOperationDefault === true
+        && operation.isBulkOperation !== true
+        && operation.variantType === ResourceOperationVariantType.API_CALL);
+}
+/**
+ * The parameters one relationships call carries: the organization it acts in, and the relationship row for a verb on
+ * one. Built by the same scope utility every resource surface of the organization uses.
+ */
+function relationshipCallOf(registry, operation, organizationId, relationshipId) {
+    const resourceType = CoreResourceType.ORGANIZATION_RELATIONSHIPS;
+    const contextResourceIdentifiers = {
+        ...ScopeUtilsService.buildResourceOperationContextIdentifiers({
+            currentOrganizationId: organizationId,
+            primaryScope: registry.resourceConfigurations[resourceType]?.resourcePrimaryScope,
+            explicitContextResourceIdentifiers: {},
+        }),
+        ...(relationshipId ? { [resourceType]: relationshipId } : {}),
+    };
+    return {
+        operationPathKey: ResourcesConfig_OperationPathUtils.buildOperationPathKeyFromOperation(operation),
+        contextualParameters: FrontendResourceUtils.buildContextualParameters(contextResourceIdentifiers, registry),
+        parentResourcesRequirements: frontendResourceUtils.buildParentResourcesRequirements(resourceType, contextResourceIdentifiers, registry),
+    };
+}
+/** Whether a rejected read is the backend saying it does not share this resource's records. */
+export function isRecordNotShareableRefusal(error) {
+    const errorLike = error;
+    const code = errorLike?.response?.data?.error?.details?.code ?? errorLike?.context?.code;
+    return code === OrganizationRelationshipErrorCode.RELATIONSHIP_RECORD_NOT_SHAREABLE;
+}
+const NOTHING_SHARED = {
+    relationships: [],
+    viaRelationshipId: null,
+    sharedWithRelationshipIds: [],
+    commonToEveryRelationship: false,
+};
+/**
+ * See the module comment. `enabled` is the screen's gate (the resource carries provenance, the viewer administers the
+ * granting organization the record belongs to); nothing is asked while it is false.
+ */
+export function useRecordSharing(input) {
+    // The context itself, so a host rendered outside the registry provider reads "nothing offered" rather than failing.
+    const registryContext = useContext(ResourceRegistryContext);
+    const registry = registryContext?.registry;
+    // The scoped `doOperation` changes identity with every scope change; read the latest through a ref so a settling scope
+    // does not cancel and resend the read (the reason `useCurrentOrganizationHoldsUnrevokedScimToken` gives).
+    const doOperationRef = useRef(registryContext?.doOperation);
+    doOperationRef.current = registryContext?.doOperation;
+    const [generation, setGeneration] = useState(0);
+    const [readState, setReadState] = useState(RecordSharingReadState.IDLE);
+    const [refreshing, setRefreshing] = useState(false);
+    const [answer, setAnswer] = useState(NOTHING_SHARED);
+    const { enabled, organizationId, resourceType, recordId } = input;
+    // The record the answer (or the failure) on hand belongs to. Read during render, so the frame in which the page has
+    // moved to another record, before the effect below runs, never shows the previous record's sharing (#2736 review I4).
+    const [answeredSubject, setAnsweredSubject] = useState(undefined);
+    const currentSubject = enabled && organizationId && recordId ? `${organizationId}|${resourceType}|${recordId}` : undefined;
+    // The record whose answer is on screen. A read for the SAME record after a change refreshes it in place; a read for
+    // another record starts from nothing; with the render-time check on `answeredSubject`, one record's sharing is never
+    // shown as another's, not even for the frame before this effect runs.
+    const settledSubjectRef = useRef(undefined);
+    useEffect(() => {
+        const doOperation = doOperationRef.current;
+        const readOperation = findRelationshipOperation(registry, OrganizationRelationships_Operations.READ_RECORD_SHARING);
+        if (!enabled || !registry || !doOperation || !organizationId || !recordId || !readOperation) {
+            settledSubjectRef.current = undefined;
+            setAnsweredSubject(undefined);
+            setReadState(RecordSharingReadState.IDLE);
+            setRefreshing(false);
+            setAnswer(NOTHING_SHARED);
+            return undefined;
+        }
+        let cancelled = false;
+        const subject = `${organizationId}|${resourceType}|${recordId}`;
+        if (settledSubjectRef.current === subject) {
+            setRefreshing(true);
+        }
+        else {
+            settledSubjectRef.current = undefined;
+            setRefreshing(false);
+            setAnswer(NOTHING_SHARED);
+            setReadState(RecordSharingReadState.LOADING);
+        }
+        void (async () => {
+            try {
+                const sharingCall = relationshipCallOf(registry, readOperation, organizationId);
+                // Silent: a refusal here is answered by the screen itself (hidden, or "could not be read").
+                const sharing = RelationshipRecordSharingSchema.parse(await doOperation(sharingCall.operationPathKey, { contextualParameters: sharingCall.contextualParameters, parentResourcesRequirements: sharingCall.parentResourcesRequirements, requestData: { resourceType, recordId } }, { silent: true }));
+                if (cancelled)
+                    return;
+                setAnswer({
+                    relationships: sharing.relationships.map(({ representingOrganizationName, ...relationship }) => ({
+                        ...relationship,
+                        ...(representingOrganizationName ? { name: representingOrganizationName } : {}),
+                    })),
+                    viaRelationshipId: sharing.viaRelationshipId,
+                    sharedWithRelationshipIds: sharing.sharedWithRelationshipIds,
+                    commonToEveryRelationship: sharing.commonToEveryRelationship,
+                });
+                settledSubjectRef.current = subject;
+                setAnsweredSubject(subject);
+                setReadState(RecordSharingReadState.READY);
+                setRefreshing(false);
+            }
+            catch (error) {
+                if (cancelled)
+                    return;
+                settledSubjectRef.current = undefined;
+                setAnsweredSubject(subject);
+                setRefreshing(false);
+                setAnswer(NOTHING_SHARED);
+                if (isRecordNotShareableRefusal(error)) {
+                    setReadState(RecordSharingReadState.NOT_SHAREABLE);
+                    return;
+                }
+                logger.warn('[RecordSharing] The record\'s sharing could not be read', { resourceType, backendError: isWildoBackendError(error) });
+                setReadState(RecordSharingReadState.FAILED);
+            }
+        })();
+        return () => { cancelled = true; };
+    }, [enabled, registry, organizationId, resourceType, recordId, generation]);
+    const change = useCallback(async (identifier, relationshipId) => {
+        const doOperation = doOperationRef.current;
+        const operation = findRelationshipOperation(registry, identifier);
+        if (!registry || !doOperation || !operation || !organizationId || !recordId) {
+            throw new Error(`The ${identifier} operation of organization relationships is not available in this frontend.`);
+        }
+        const call = relationshipCallOf(registry, operation, organizationId, relationshipId);
+        // Disabled from the click, not from the next render: the re-read below starts on the following commit, and the
+        // controls must not re-enable over the answer the change is about to replace (#2736 review N5).
+        setRefreshing(true);
+        try {
+            // Not silent: a refusal (a relationship no longer active, a record gone) is reported by the request's own handling.
+            await doOperation(call.operationPathKey, {
+                contextualParameters: call.contextualParameters,
+                parentResourcesRequirements: call.parentResourcesRequirements,
+                requestData: { resourceType, recordId },
+            });
+        }
+        finally {
+            setGeneration((value) => value + 1);
+        }
+    }, [registry, organizationId, resourceType, recordId]);
+    const share = useCallback((relationshipId) => change(OrganizationRelationships_Operations.SHARE_RECORD, relationshipId), [change]);
+    const unshare = useCallback((relationshipId) => change(OrganizationRelationships_Operations.UNSHARE_RECORD, relationshipId), [change]);
+    // An answer about another record than the one asked now is not shown: the read for this one is on its way.
+    if (readState !== RecordSharingReadState.IDLE && readState !== RecordSharingReadState.LOADING && answeredSubject !== currentSubject) {
+        return {
+            readState: RecordSharingReadState.LOADING,
+            refreshing: false,
+            relationships: NOTHING_SHARED.relationships,
+            viaRelationshipId: NOTHING_SHARED.viaRelationshipId,
+            sharedWithRelationshipIds: NOTHING_SHARED.sharedWithRelationshipIds,
+            commonToEveryRelationship: NOTHING_SHARED.commonToEveryRelationship,
+            share,
+            unshare,
+        };
+    }
+    return {
+        readState,
+        refreshing,
+        relationships: answer.relationships,
+        viaRelationshipId: answer.viaRelationshipId,
+        sharedWithRelationshipIds: answer.sharedWithRelationshipIds,
+        commonToEveryRelationship: answer.commonToEveryRelationship,
+        share,
+        unshare,
+    };
+}
+//# sourceMappingURL=useRecordSharing.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useRecordSharing.js","sourceRoot":"","sources":["../../../../../src/core/resources/useRecordSharing.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * One record's sharing with the organization's relationships (#2736), for the administrator of the granting organization.\n *\n * #2722 separated records between an organization's relationships: a record created through one relationship is that\n * relationship's, and the organization's own records reach a representative only as its relationship kind allows. The\n * organization's administrators widen that record by record with `shareRecord` / `unshareRecord` on the relationship.\n *\n * Everything the screen says comes from one administrator-only read, `readRecordSharing`, which answers whose the record\n * is, who it is shared with, and for every live relationship (and any other the record names) what its people reach of\n * the record: whether it confers now, whether its roles reach this record (its role and lent capabilities, and its units\n * for a relationship limited to units), whether it reads the record without a share, and whether a share would let it.\n * The backend decides each with the request path's own predicates and the authorizer's own answer, so the screen never\n * offers a share that changes nothing (a record no relationship can read, a relationship that already reads it, a dormant\n * relationship) and never claims a reach the engine would not grant (#2736 review N1, N2, M1). The\n * provenance and shares are stripped from the record's own response: a representative reading a shared record never\n * learns which other relationships it reaches.\n *\n * A resource the backend will not share at all (a system of record's rows, which have no table to hold a share) answers\n * `RELATIONSHIP_RECORD_NOT_SHAREABLE`: the screen then has nothing to offer and says nothing\n * ({@link RecordSharingReadState.NOT_SHAREABLE}). Any other failure is a read that did not complete and is shown as one.\n * Presentation only: the backend authorizes every call.\n */\nimport { useCallback, useContext, useEffect, useRef, useState } from 'react';\nimport {\n  CoreResourceType,\n  OrganizationRelationshipErrorCode,\n  OrganizationRelationships_Operations,\n  RelationshipRecordSharingSchema,\n  ResourceOperationVariantType,\n  ResourcesConfig_OperationPathUtils,\n  isWildoBackendError,\n  type RelationshipRecordReach,\n} from '@wildo-ai/saas-models';\nimport { ResourceRegistryContext } from '~wildo-frontend-lib/core/resources/ResourceRegistryContext';\nimport type { FrontendResourceConfiguration_Operation, FrontendResourcesRegistry } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { ScopeUtilsService } from '~wildo-frontend-lib/core/scope/scope.utils.frontend.service';\nimport { FrontendResourceUtils, frontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\nconst logger: LoggerFrontendService = LoggerFrontendService.getLogger();\n\n/** Where the screen's read stands. */\nexport enum RecordSharingReadState {\n  /** Nothing is asked: the screen is not offered here. */\n  IDLE = 'idle',\n  /** Asked; the answer has not arrived. The screen shows nothing yet, so nothing is offered first and withdrawn after. */\n  LOADING = 'loading',\n  /** The read answered, for the record now on screen. */\n  READY = 'ready',\n  /** The backend does not share records of this resource. The screen shows nothing. */\n  NOT_SHAREABLE = 'not_shareable',\n  /** A read failed. The screen says so and offers nothing. */\n  FAILED = 'failed',\n}\n\n/** One of the granting organization's relationships, as the read describes it: who it is, and what its people reach of the record. */\nexport interface RecordSharingRelationship extends RelationshipRecordReach {\n  readonly relationshipId: string;\n  /** The representing organization's name, when the relationship carries it. */\n  readonly name?: string;\n}\n\nexport interface RecordSharing {\n  readonly readState: RecordSharingReadState;\n  /**\n   * A change was made and the answer is being read again. The last answer stays shown meanwhile (READY), so the section\n   * does not vanish under the person who just acted (#2736 review F2); the screen disables its controls instead.\n   */\n  readonly refreshing: boolean;\n  readonly relationships: readonly RecordSharingRelationship[];\n  /** The relationship the record was created through, or `null` when it is the organization's own. */\n  readonly viaRelationshipId: string | null;\n  /** The relationships the organization shared the record with. */\n  readonly sharedWithRelationshipIds: readonly string[];\n  /** Every relationship reads every record of this resource by the application's declaration: a share changes nothing. */\n  readonly commonToEveryRelationship: boolean;\n  /** Share the record with one relationship, then read again. Rejects when the backend refused; it has reported why. */\n  readonly share: (relationshipId: string) => Promise<void>;\n  /** Withdraw a share, then read again. Rejects when the backend refused; it has reported why. */\n  readonly unshare: (relationshipId: string) => Promise<void>;\n}\n\n/**\n * The relationships resource's default API operation `identifier`, as this frontend registers it; `undefined` when it is\n * not registered, which leaves the screen with nothing to offer rather than a guessed URL.\n */\nexport function findRelationshipOperation(\n  registry: FrontendResourcesRegistry | undefined,\n  identifier: string,\n): FrontendResourceConfiguration_Operation | undefined {\n  const operations = registry?.resourceConfigurations[CoreResourceType.ORGANIZATION_RELATIONSHIPS]?.operations as\n    | readonly FrontendResourceConfiguration_Operation[]\n    | undefined;\n  return operations?.find((operation) =>\n    String(operation.operationIdentifier) === identifier\n    && operation.isOperationDefault === true\n    && operation.isBulkOperation !== true\n    && operation.variantType === ResourceOperationVariantType.API_CALL);\n}\n\n/**\n * The parameters one relationships call carries: the organization it acts in, and the relationship row for a verb on\n * one. Built by the same scope utility every resource surface of the organization uses.\n */\nfunction relationshipCallOf(\n  registry: FrontendResourcesRegistry,\n  operation: FrontendResourceConfiguration_Operation,\n  organizationId: string,\n  relationshipId?: string,\n): { operationPathKey: string; contextualParameters: Record<string, string | number>; parentResourcesRequirements: ReturnType<typeof frontendResourceUtils.buildParentResourcesRequirements> } {\n  const resourceType = CoreResourceType.ORGANIZATION_RELATIONSHIPS;\n  const contextResourceIdentifiers = {\n    ...ScopeUtilsService.buildResourceOperationContextIdentifiers({\n      currentOrganizationId: organizationId,\n      primaryScope: registry.resourceConfigurations[resourceType]?.resourcePrimaryScope,\n      explicitContextResourceIdentifiers: {},\n    }),\n    ...(relationshipId ? { [resourceType]: relationshipId } : {}),\n  };\n  return {\n    operationPathKey: ResourcesConfig_OperationPathUtils.buildOperationPathKeyFromOperation(operation),\n    contextualParameters: FrontendResourceUtils.buildContextualParameters(contextResourceIdentifiers, registry),\n    parentResourcesRequirements: frontendResourceUtils.buildParentResourcesRequirements(resourceType, contextResourceIdentifiers, registry),\n  };\n}\n\n/** Whether a rejected read is the backend saying it does not share this resource's records. */\nexport function isRecordNotShareableRefusal(error: unknown): boolean {\n  const errorLike = error as { response?: { data?: { error?: { details?: { code?: unknown } } } }; context?: { code?: unknown } } | null | undefined;\n  const code = errorLike?.response?.data?.error?.details?.code ?? errorLike?.context?.code;\n  return code === OrganizationRelationshipErrorCode.RELATIONSHIP_RECORD_NOT_SHAREABLE;\n}\n\ninterface SharingAnswer {\n  readonly relationships: readonly RecordSharingRelationship[];\n  readonly viaRelationshipId: string | null;\n  readonly sharedWithRelationshipIds: readonly string[];\n  readonly commonToEveryRelationship: boolean;\n}\n\nconst NOTHING_SHARED: SharingAnswer = {\n  relationships: [],\n  viaRelationshipId: null,\n  sharedWithRelationshipIds: [],\n  commonToEveryRelationship: false,\n};\n\n/**\n * See the module comment. `enabled` is the screen's gate (the resource carries provenance, the viewer administers the\n * granting organization the record belongs to); nothing is asked while it is false.\n */\nexport function useRecordSharing(input: {\n  readonly enabled: boolean;\n  readonly organizationId: string | undefined;\n  readonly resourceType: string;\n  readonly recordId: string | undefined;\n}): RecordSharing {\n  // The context itself, so a host rendered outside the registry provider reads \"nothing offered\" rather than failing.\n  const registryContext = useContext(ResourceRegistryContext);\n  const registry = registryContext?.registry;\n  // The scoped `doOperation` changes identity with every scope change; read the latest through a ref so a settling scope\n  // does not cancel and resend the read (the reason `useCurrentOrganizationHoldsUnrevokedScimToken` gives).\n  const doOperationRef = useRef(registryContext?.doOperation);\n  doOperationRef.current = registryContext?.doOperation;\n\n  const [generation, setGeneration] = useState(0);\n  const [readState, setReadState] = useState<RecordSharingReadState>(RecordSharingReadState.IDLE);\n  const [refreshing, setRefreshing] = useState(false);\n  const [answer, setAnswer] = useState<SharingAnswer>(NOTHING_SHARED);\n  const { enabled, organizationId, resourceType, recordId } = input;\n  // The record the answer (or the failure) on hand belongs to. Read during render, so the frame in which the page has\n  // moved to another record, before the effect below runs, never shows the previous record's sharing (#2736 review I4).\n  const [answeredSubject, setAnsweredSubject] = useState<string | undefined>(undefined);\n  const currentSubject = enabled && organizationId && recordId ? `${organizationId}|${resourceType}|${recordId}` : undefined;\n  // The record whose answer is on screen. A read for the SAME record after a change refreshes it in place; a read for\n  // another record starts from nothing; with the render-time check on `answeredSubject`, one record's sharing is never\n  // shown as another's, not even for the frame before this effect runs.\n  const settledSubjectRef = useRef<string | undefined>(undefined);\n\n  useEffect(() => {\n    const doOperation = doOperationRef.current;\n    const readOperation = findRelationshipOperation(registry, OrganizationRelationships_Operations.READ_RECORD_SHARING);\n    if (!enabled || !registry || !doOperation || !organizationId || !recordId || !readOperation) {\n      settledSubjectRef.current = undefined;\n      setAnsweredSubject(undefined);\n      setReadState(RecordSharingReadState.IDLE);\n      setRefreshing(false);\n      setAnswer(NOTHING_SHARED);\n      return undefined;\n    }\n    let cancelled = false;\n    const subject = `${organizationId}|${resourceType}|${recordId}`;\n    if (settledSubjectRef.current === subject) {\n      setRefreshing(true);\n    } else {\n      settledSubjectRef.current = undefined;\n      setRefreshing(false);\n      setAnswer(NOTHING_SHARED);\n      setReadState(RecordSharingReadState.LOADING);\n    }\n    void (async () => {\n      try {\n        const sharingCall = relationshipCallOf(registry, readOperation, organizationId);\n        // Silent: a refusal here is answered by the screen itself (hidden, or \"could not be read\").\n        const sharing = RelationshipRecordSharingSchema.parse(await doOperation(\n          sharingCall.operationPathKey,\n          { contextualParameters: sharingCall.contextualParameters, parentResourcesRequirements: sharingCall.parentResourcesRequirements, requestData: { resourceType, recordId } },\n          { silent: true },\n        ));\n        if (cancelled) return;\n        setAnswer({\n          relationships: sharing.relationships.map(({ representingOrganizationName, ...relationship }) => ({\n            ...relationship,\n            ...(representingOrganizationName ? { name: representingOrganizationName } : {}),\n          })),\n          viaRelationshipId: sharing.viaRelationshipId,\n          sharedWithRelationshipIds: sharing.sharedWithRelationshipIds,\n          commonToEveryRelationship: sharing.commonToEveryRelationship,\n        });\n        settledSubjectRef.current = subject;\n        setAnsweredSubject(subject);\n        setReadState(RecordSharingReadState.READY);\n        setRefreshing(false);\n      } catch (error: unknown) {\n        if (cancelled) return;\n        settledSubjectRef.current = undefined;\n        setAnsweredSubject(subject);\n        setRefreshing(false);\n        setAnswer(NOTHING_SHARED);\n        if (isRecordNotShareableRefusal(error)) {\n          setReadState(RecordSharingReadState.NOT_SHAREABLE);\n          return;\n        }\n        logger.warn('[RecordSharing] The record\\'s sharing could not be read', { resourceType, backendError: isWildoBackendError(error) });\n        setReadState(RecordSharingReadState.FAILED);\n      }\n    })();\n    return () => { cancelled = true; };\n  }, [enabled, registry, organizationId, resourceType, recordId, generation]);\n\n  const change = useCallback(async (identifier: string, relationshipId: string) => {\n    const doOperation = doOperationRef.current;\n    const operation = findRelationshipOperation(registry, identifier);\n    if (!registry || !doOperation || !operation || !organizationId || !recordId) {\n      throw new Error(`The ${identifier} operation of organization relationships is not available in this frontend.`);\n    }\n    const call = relationshipCallOf(registry, operation, organizationId, relationshipId);\n    // Disabled from the click, not from the next render: the re-read below starts on the following commit, and the\n    // controls must not re-enable over the answer the change is about to replace (#2736 review N5).\n    setRefreshing(true);\n    try {\n      // Not silent: a refusal (a relationship no longer active, a record gone) is reported by the request's own handling.\n      await doOperation(call.operationPathKey, {\n        contextualParameters: call.contextualParameters,\n        parentResourcesRequirements: call.parentResourcesRequirements,\n        requestData: { resourceType, recordId },\n      });\n    } finally {\n      setGeneration((value) => value + 1);\n    }\n  }, [registry, organizationId, resourceType, recordId]);\n\n  const share = useCallback((relationshipId: string) => change(OrganizationRelationships_Operations.SHARE_RECORD, relationshipId), [change]);\n  const unshare = useCallback((relationshipId: string) => change(OrganizationRelationships_Operations.UNSHARE_RECORD, relationshipId), [change]);\n\n  // An answer about another record than the one asked now is not shown: the read for this one is on its way.\n  if (readState !== RecordSharingReadState.IDLE && readState !== RecordSharingReadState.LOADING && answeredSubject !== currentSubject) {\n    return {\n      readState: RecordSharingReadState.LOADING,\n      refreshing: false,\n      relationships: NOTHING_SHARED.relationships,\n      viaRelationshipId: NOTHING_SHARED.viaRelationshipId,\n      sharedWithRelationshipIds: NOTHING_SHARED.sharedWithRelationshipIds,\n      commonToEveryRelationship: NOTHING_SHARED.commonToEveryRelationship,\n      share,\n      unshare,\n    };\n  }\n  return {\n    readState,\n    refreshing,\n    relationships: answer.relationships,\n    viaRelationshipId: answer.viaRelationshipId,\n    sharedWithRelationshipIds: answer.sharedWithRelationshipIds,\n    commonToEveryRelationship: answer.commonToEveryRelationship,\n    share,\n    unshare,\n  };\n}\n"]}

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

@@ -51,7 +51,10 @@ export interface UseResourceLabelsOptions {
      * which is what `display-text-comes-from-i18n.md` asks for.
      */
     fieldPathPrefix?: string;
-    /** Explicit i18n-key overrides — these take priority over ref-derived defaults */
+    /**
+     * Overrides that win over the i18n tree. `fields`, `descriptions` and `enums` are TEXT as written. A section or
+     * wizard-step entry carries either a key (`titleKey` / `descriptionKey`) or text (`title` / `description`); text wins.
+     */
     overrides?: {
         fields?: Record<string, string>;
         /** Explicit description overrides per field name */

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 */
@@ -66,6 +76,14 @@ export interface UseResourceOperationActionsParams {
         /** 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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"}