@wildo-ai/saas-frontend-lib 1.0.1 → 1.1.0

package/dist/esm/core/resources/rmm/useResourceRMM.js

@@ -6,7 +6,10 @@ import { useContext, useEffect, useMemo, useRef, useSyncExternalStore } from 're
 import { CoreResourceOperation, ResourcesConfig_OperationPathUtils, } from '@wildo-ai/saas-models';
 import { FrontendResourceUtils } from '../../../core/resources/frontend-resource.utils.js';
 import { LoggerFrontendService } from '../../../core/monitoring/logger.frontend.service.js';
-import { pickPreferredOperationForCoreSemantic } from '../../../core/resources/operation-semantics.frontend.utils.js';
+import { getOperationsForCoreSemantic } from '../../../core/resources/operation-semantics.frontend.utils.js';
+import { pickPreferredOperationForCoreSemanticAddressability } from '../../../core/resources/resource-addressability.frontend.utils.js';
+import { operationInitiatorParametersSatisfied } from '../../../core/resources/operation-initiator-satisfaction.frontend.utils.js';
+import { normalizeContextResourceIdentifiersForTransport } from '../../../core/resources/context-resource-identifiers.frontend.utils.js';
 import { useResourceRegistry } from '../../../core/resources/useResourceRegistry.js';
 import { UserOrgsContext } from '../../../core/security/UserOrgsContext.js';
 import { HttpTransportAdapter } from './HttpTransportAdapter.js';
@@ -18,15 +21,51 @@ import { useListInvalidation } from './useListInvalidation.js';
 const logger = LoggerFrontendService.getLogger();
 const logDebug = logger.debugByType('useResourceRMM');
 logger.setDebugTypeLogging('useResourceRMM', false);
+/**
+ * Stable default conflict policy. As an inline default-parameter object literal it
+ * would mint a fresh identity on every render; `conflictPolicy` is a dependency of
+ * the routing-sync effect below, so a fresh identity re-fires that effect (and its
+ * `rmmRegistry.notifyInstanceRuntimeChanged()`) on every commit even when nothing
+ * changed. A module constant keeps the default referentially stable.
+ */
+const DEFAULT_CONFLICT_POLICY = { strategy: ConflictStrategy.ACCEPT_REMOTE };
+/**
+ * Why RMM is unattached for the current surface. Every reason fails closed
+ * (`rmm === null`); the reason only drives diagnostics. Two of the reasons
+ * are *expected absences* logged at debug, two are *genuine integration
+ * failures* logged at warn — see the classification memo in
+ * `useResourceRMM` for the precedence rules that keep expected absences out
+ * of the loud lane.
+ */
 export var UseResourceRMMUnavailableReason;
 (function (UseResourceRMMUnavailableReason) {
+    /**
+     * Genuine failure (warn): an enabled update-like surface with a resource
+     * id resolved an operation but no `RMMRegistryProvider` is mounted above it.
+     */
     UseResourceRMMUnavailableReason["PROVIDER_MISSING"] = "PROVIDER_MISSING";
+    /**
+     * Expected absence (debug): the caller explicitly opted out of RMM
+     * attachment (e.g. `enabled: isUpdateLikeOperation && !!resourceId` on a
+     * CREATE form).
+     */
     UseResourceRMMUnavailableReason["DISABLED"] = "DISABLED";
+    /**
+     * Expected absence (debug): no persisted resource id is attached yet
+     * (CREATE flow, parent-context singleton awaiting READ bootstrap). RMM is
+     * keyed by resource id and can never attach without one.
+     */
     UseResourceRMMUnavailableReason["MISSING_RESOURCE_ID"] = "MISSING_RESOURCE_ID";
+    /**
+     * Genuine failure (warn): an enabled update-like surface with a resource
+     * id could not resolve any eligible UPDATE-like operation. Default
+     * update-like surfaces fail closed on this unless they explicitly opt
+     * into a weaker direct-operation fallback.
+     */
     UseResourceRMMUnavailableReason["NO_ELIGIBLE_UPDATE_OPERATION"] = "NO_ELIGIBLE_UPDATE_OPERATION";
 })(UseResourceRMMUnavailableReason || (UseResourceRMMUnavailableReason = {}));
 export function useResourceRMM(config) {
-    const { resourceType, resourceId, doOperationRef, contextualParameters, parentResourcesRequirements, contextResourceIdentifiers, resourceSchema, enabled = true, conflictPolicy = { strategy: ConflictStrategy.ACCEPT_REMOTE }, } = config;
+    const { resourceType, resourceId, doOperationRef, contextualParameters, parentResourcesRequirements, contextResourceIdentifiers, resourceSchema, enabled = true, conflictPolicy = DEFAULT_CONFLICT_POLICY, } = config;
     const rmmRegistry = useContext(RMMRegistryContext);
     const { registry } = useResourceRegistry();
     const userOrgs = useContext(UserOrgsContext);
@@ -41,12 +80,29 @@ export function useResourceRMM(config) {
     const currentUserId = userOrgs?.user?._id ?? scopedUserId ?? lastKnownCurrentUserIdRef.current;
     const resourceConfig = registry.resourceConfigurations[resourceType];
     const contextResourceIdentifiersKey = useMemo(() => FrontendResourceUtils.buildContextResourceIdentifiersKey(contextResourceIdentifiers), [contextResourceIdentifiers]);
+    // Content-stable key for the routing-sync effect dependency below.
+    // `parentResourcesRequirements` arrives as a freshly-allocated array on most
+    // renders (callers build it inline, e.g. `buildParentResourcesRequirements(...)`),
+    // so depending on its *identity* re-fires the sync effect — and its
+    // `rmmRegistry.notifyInstanceRuntimeChanged()` — on every commit even when the
+    // requirements are unchanged, which storms the WebSocket room re-subscription.
+    // Keying by content mirrors `contextResourceIdentifiersKey`.
+    const parentResourcesRequirementsKey = useMemo(() => JSON.stringify(parentResourcesRequirements ?? null), [parentResourcesRequirements]);
+    const resourceIdStr = resourceId ? String(resourceId) : '';
     const transportAdapter = useMemo(() => new HttpTransportAdapter((...args) => doOperationRef.current(...args)), 
     // eslint-disable-next-line react-hooks/exhaustive-deps -- doOperationRef is a stable ref
     []);
     const updateOperation = useMemo(() => {
-        return pickPreferredOperationForCoreSemantic(resourceConfig?.operations ?? [], CoreResourceOperation.UPDATE);
-    }, [resourceConfig?.operations]);
+        return pickPreferredOperationForCoreSemanticAddressability({
+            resourceConfig,
+            operations: resourceConfig?.operations ?? [],
+            coreOperation: CoreResourceOperation.UPDATE,
+            registry,
+            hasResourceId: Boolean(resourceIdStr),
+            contextResourceIdentifiers,
+            contextualParameters,
+        });
+    }, [contextResourceIdentifiersKey, contextualParameters, registry, resourceConfig, resourceIdStr]);
     const rmmOperationPathKey = useMemo(() => {
         if (!updateOperation) {
             return null;
@@ -54,22 +110,56 @@ export function useResourceRMM(config) {
         return ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(updateOperation);
     }, [resourceType, updateOperation]);
     const rmmReadOperationPathKey = useMemo(() => {
-        return resolveCanonicalRMMReadOperationPathKey(resourceType, registry);
-    }, [resourceConfig?.operations, resourceType]);
-    const listOperation = useMemo(() => pickPreferredOperationForCoreSemantic(resourceConfig?.operations ?? [], CoreResourceOperation.LIST) ?? null, [resourceConfig?.operations]);
-    const resourceIdStr = resourceId ? String(resourceId) : '';
+        return resolveCanonicalRMMReadOperationPathKey(resourceType, registry, {
+            hasResourceId: Boolean(resourceIdStr),
+            contextResourceIdentifiers,
+            contextualParameters,
+        });
+    }, [contextResourceIdentifiersKey, contextualParameters, registry, resourceConfig?.operations, resourceIdStr, resourceType]);
+    const listOperations = useMemo(() => {
+        const { [resourceType]: _self, ...parentScopeIdentifiers } = contextResourceIdentifiers ?? {};
+        const parentContextualParameters = FrontendResourceUtils.buildContextualParameters(parentScopeIdentifiers, registry);
+        return getOperationsForCoreSemantic(resourceConfig?.operations ?? [], CoreResourceOperation.LIST).filter((listOperation) => operationInitiatorParametersSatisfied({
+            operation: listOperation,
+            contextResourceIdentifiers: parentScopeIdentifiers,
+            contextualParameters: parentContextualParameters,
+        }));
+    }, [contextResourceIdentifiersKey, registry, resourceConfig?.operations, resourceType]);
+    /**
+     * Classify why RMM is unattached, expected-absence checks first. The
+     * precedence matters because the reason drives log level downstream:
+     * `DISABLED` / `MISSING_RESOURCE_ID` are expected absences (debug),
+     * `NO_ELIGIBLE_UPDATE_OPERATION` / `PROVIDER_MISSING` are genuine
+     * integration failures (warn).
+     *
+     * - `!enabled` always classifies as DISABLED, even when no update
+     *   operation resolves: the caller explicitly opted out (the form /
+     *   displayer / layout callers gate `enabled` on `<update-like> && <has
+     *   id>`; the execution participation bridge gates it on execution-level
+     *   availability), so a CREATE surface must not be reported as an
+     *   operation-eligibility failure.
+     * - The missing-id check runs before operation eligibility: without an id
+     *   RMM can never attach (the registry is keyed by resource id), and
+     *   UPDATE addressability is resolved with `hasResourceId: false`, so an
+     *   unresolved operation on an id-less surface is the expected CREATE /
+     *   pre-bootstrap shape rather than a broken update-like surface.
+     *
+     * Rejected alternative: keeping the old loud-first order and only
+     * downgrading the log level — that would still misreport create-like
+     * surfaces as `NO_ELIGIBLE_UPDATE_OPERATION` to consumers of
+     * `rmmUnavailableReason`. All reasons keep failing closed (rmm === null);
+     * only classification and log level differ.
+     */
     const rmmUnavailableReason = useMemo(() => {
         if (!enabled) {
-            return updateOperation
-                ? UseResourceRMMUnavailableReason.DISABLED
-                : UseResourceRMMUnavailableReason.NO_ELIGIBLE_UPDATE_OPERATION;
-        }
-        if (!updateOperation) {
-            return UseResourceRMMUnavailableReason.NO_ELIGIBLE_UPDATE_OPERATION;
+            return UseResourceRMMUnavailableReason.DISABLED;
         }
         if (!resourceIdStr) {
             return UseResourceRMMUnavailableReason.MISSING_RESOURCE_ID;
         }
+        if (!updateOperation) {
+            return UseResourceRMMUnavailableReason.NO_ELIGIBLE_UPDATE_OPERATION;
+        }
         if (!rmmRegistry) {
             return UseResourceRMMUnavailableReason.PROVIDER_MISSING;
         }
@@ -83,16 +173,16 @@ export function useResourceRMM(config) {
             });
             return null;
         }
-        if (rmmUnavailableReason === UseResourceRMMUnavailableReason.NO_ELIGIBLE_UPDATE_OPERATION) {
-            logger.warn('[useResourceRMM] RMM unavailable because no eligible UPDATE-like operation could be resolved for this surface. Default update-like surfaces should fail closed unless they explicitly opt into a weaker direct-operation fallback.', {
+        if (rmmUnavailableReason === UseResourceRMMUnavailableReason.MISSING_RESOURCE_ID) {
+            logDebug('RMM unavailable because no resource id is attached to the current surface.', {
                 resourceType,
-                resourceId: resourceIdStr,
             });
             return null;
         }
-        if (rmmUnavailableReason === UseResourceRMMUnavailableReason.MISSING_RESOURCE_ID) {
-            logDebug('RMM unavailable because no resource id is attached to the current surface.', {
+        if (rmmUnavailableReason === UseResourceRMMUnavailableReason.NO_ELIGIBLE_UPDATE_OPERATION) {
+            logger.warn('[useResourceRMM] RMM unavailable because no eligible UPDATE-like operation could be resolved for this surface. Default update-like surfaces should fail closed unless they explicitly opt into a weaker direct-operation fallback.', {
                 resourceType,
+                resourceId: resourceIdStr,
             });
             return null;
         }
@@ -111,7 +201,7 @@ export function useResourceRMM(config) {
             readOperationPathKey: rmmReadOperationPathKey,
             conflictPolicy,
             currentUserId,
-            contextResourceIdentifiers: (contextResourceIdentifiers ?? {}),
+            contextResourceIdentifiers: normalizeContextResourceIdentifiersForTransport(contextResourceIdentifiers),
             contextualParameters,
             parentResourcesRequirements,
             resourceSchema,
@@ -124,7 +214,7 @@ export function useResourceRMM(config) {
         rmm.syncRuntimeRoutingConfig({
             transportAdapter,
             currentUserId,
-            contextResourceIdentifiers: (contextResourceIdentifiers ?? {}),
+            contextResourceIdentifiers: normalizeContextResourceIdentifiersForTransport(contextResourceIdentifiers),
             contextualParameters,
             parentResourcesRequirements,
             operationPathKey: rmmOperationPathKey,
@@ -137,11 +227,14 @@ export function useResourceRMM(config) {
         rmm,
         rmmRegistry,
         currentUserId,
-        conflictPolicy,
+        // `ConflictPolicy` is `{ strategy }`; depend on the strategy value, not the
+        // (commonly inline, fresh-identity) object literal callers pass, so the sync
+        // effect does not re-fire — and re-notify — on every commit.
+        conflictPolicy.strategy,
         contextResourceIdentifiersKey,
         rmmOperationPathKey,
         rmmReadOperationPathKey,
-        parentResourcesRequirements,
+        parentResourcesRequirementsKey,
         contextualParameters,
         resourceSchema,
         transportAdapter,
@@ -157,15 +250,16 @@ export function useResourceRMM(config) {
     }, [rmm, rmmRegistry, resourceType, resourceIdStr]);
     const rmmSnapshot = useSyncExternalStore(rmm?.subscribe ?? NOOP_SUBSCRIBE, rmm?.getSnapshot ?? NOOP_GET_SNAPSHOT);
     useListInvalidation(rmm, {
-        contextResourceIdentifiers: (contextResourceIdentifiers ?? {}),
+        contextResourceIdentifiers: normalizeContextResourceIdentifiersForTransport(contextResourceIdentifiers),
         parentResourcesRequirements: parentResourcesRequirements ?? [],
-        listOperation,
+        listOperations,
     });
     return {
         rmm,
         rmmSnapshot,
         rmmRegistry: rmmRegistry ?? null,
         rmmUnavailableReason,
+        canonicalReadOperationPathKey: rmmReadOperationPathKey,
     };
 }
-//# sourceMappingURL=useResourceRMM.js.map
+//# sourceMappingURL=useResourceRMM.js.map

package/dist/esm/core/resources/rmm/useResourceRMM.js.map

@@ -1 +1 @@
-{"version":3,"file":"useResourceRMM.js","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/useResourceRMM.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useResourceRMM.js","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/useResourceRMM.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared RMM lifecycle: registry lookup, transport adapter, getOrCreate, routing sync,\n * cleanup on unmount, snapshot subscription, and list invalidation.\n */\n\nimport { useContext, useEffect, useMemo, useRef, useSyncExternalStore } from 'react';\nimport type { RefObject } from 'react';\nimport {\n  CoreResourceOperation,\n  ResourceOperationVariantType,\n  ResourcesConfig_OperationPathUtils,\n} from '@wildo-ai/saas-models';\nimport type { DoOperationFn } from './HttpTransportAdapter';\nimport type { FrontendResourceOperationContext } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { getOperationsForCoreSemantic } from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport { pickPreferredOperationForCoreSemanticAddressability } from '~wildo-frontend-lib/core/resources/resource-addressability.frontend.utils';\nimport { operationInitiatorParametersSatisfied } from '~wildo-frontend-lib/core/resources/operation-initiator-satisfaction.frontend.utils';\nimport { normalizeContextResourceIdentifiersForTransport } from '~wildo-frontend-lib/core/resources/context-resource-identifiers.frontend.utils';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { UserOrgsContext } from '~wildo-frontend-lib/core/security/UserOrgsContext';\nimport { HttpTransportAdapter } from './HttpTransportAdapter';\nimport { NOOP_GET_SNAPSHOT, NOOP_SUBSCRIBE } from './rmm-noop-snapshot';\nimport { RMMRegistryContext } from './RMMRegistryContext';\nimport type { ResourceMutationManager } from './ResourceMutationManager';\nimport type { RMMRegistry } from './RMMRegistry';\nimport { ConflictStrategy, type ConflictPolicy, type RMMSnapshot } from './types';\nimport { resolveCanonicalRMMReadOperationPathKey } from './canonical-read.frontend.utils';\nimport { useListInvalidation } from './useListInvalidation';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('useResourceRMM');\nlogger.setDebugTypeLogging('useResourceRMM', false);\n\n/**\n * Stable default conflict policy. As an inline default-parameter object literal it\n * would mint a fresh identity on every render; `conflictPolicy` is a dependency of\n * the routing-sync effect below, so a fresh identity re-fires that effect (and its\n * `rmmRegistry.notifyInstanceRuntimeChanged()`) on every commit even when nothing\n * changed. A module constant keeps the default referentially stable.\n */\nconst DEFAULT_CONFLICT_POLICY: ConflictPolicy = { strategy: ConflictStrategy.ACCEPT_REMOTE };\n\nexport interface UseResourceRMMConfig {\n  resourceType: string;\n  /** When falsy, RMM is not attached (e.g. CREATE flow or missing id). */\n  resourceId: string | null | undefined;\n  doOperationRef: RefObject<DoOperationFn | null>;\n  contextualParameters: Record<string, string | number>;\n  parentResourcesRequirements?: unknown[];\n  contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];\n  resourceSchema?: unknown;\n  /** When false, skip RMM entirely (e.g. non–UPDATE-like form or resource without UPDATE). */\n  enabled?: boolean;\n  conflictPolicy?: ConflictPolicy;\n}\n\nexport interface UseResourceRMMResult {\n  rmm: ResourceMutationManager | null;\n  rmmSnapshot: RMMSnapshot;\n  rmmRegistry: RMMRegistry | null;\n  rmmUnavailableReason: UseResourceRMMUnavailableReason | null;\n  canonicalReadOperationPathKey: string | undefined;\n}\n\n/**\n * Why RMM is unattached for the current surface. Every reason fails closed\n * (`rmm === null`); the reason only drives diagnostics. Two of the reasons\n * are *expected absences* logged at debug, two are *genuine integration\n * failures* logged at warn — see the classification memo in\n * `useResourceRMM` for the precedence rules that keep expected absences out\n * of the loud lane.\n */\nexport enum UseResourceRMMUnavailableReason {\n  /**\n   * Genuine failure (warn): an enabled update-like surface with a resource\n   * id resolved an operation but no `RMMRegistryProvider` is mounted above it.\n   */\n  PROVIDER_MISSING = 'PROVIDER_MISSING',\n  /**\n   * Expected absence (debug): the caller explicitly opted out of RMM\n   * attachment (e.g. `enabled: isUpdateLikeOperation && !!resourceId` on a\n   * CREATE form).\n   */\n  DISABLED = 'DISABLED',\n  /**\n   * Expected absence (debug): no persisted resource id is attached yet\n   * (CREATE flow, parent-context singleton awaiting READ bootstrap). RMM is\n   * keyed by resource id and can never attach without one.\n   */\n  MISSING_RESOURCE_ID = 'MISSING_RESOURCE_ID',\n  /**\n   * Genuine failure (warn): an enabled update-like surface with a resource\n   * id could not resolve any eligible UPDATE-like operation. Default\n   * update-like surfaces fail closed on this unless they explicitly opt\n   * into a weaker direct-operation fallback.\n   */\n  NO_ELIGIBLE_UPDATE_OPERATION = 'NO_ELIGIBLE_UPDATE_OPERATION',\n}\n\nexport function useResourceRMM(config: UseResourceRMMConfig): UseResourceRMMResult {\n  const {\n    resourceType,\n    resourceId,\n    doOperationRef,\n    contextualParameters,\n    parentResourcesRequirements,\n    contextResourceIdentifiers,\n    resourceSchema,\n    enabled = true,\n    conflictPolicy = DEFAULT_CONFLICT_POLICY,\n  } = config;\n\n  const rmmRegistry = useContext(RMMRegistryContext);\n  const { registry } = useResourceRegistry();\n  const userOrgs = useContext(UserOrgsContext);\n  const scopedUserId = userOrgs?.primaryScopeInitiatorIds?.userId ?? null;\n  // Preserve the last known authenticated user id across transient auth-context\n  // dropouts so same-user websocket replay does not immediately degrade into the\n  // foreign-remote lane during runtime churn.\n  const lastKnownCurrentUserIdRef = useRef<string>('');\n  if (userOrgs?.user?._id || scopedUserId) {\n    lastKnownCurrentUserIdRef.current = userOrgs?.user?._id ?? scopedUserId!;\n  }\n  const currentUserId = userOrgs?.user?._id ?? scopedUserId ?? lastKnownCurrentUserIdRef.current;\n  const resourceConfig = registry.resourceConfigurations[resourceType];\n\n  const contextResourceIdentifiersKey = useMemo(\n    () => FrontendResourceUtils.buildContextResourceIdentifiersKey(contextResourceIdentifiers),\n    [contextResourceIdentifiers],\n  );\n  // Content-stable key for the routing-sync effect dependency below.\n  // `parentResourcesRequirements` arrives as a freshly-allocated array on most\n  // renders (callers build it inline, e.g. `buildParentResourcesRequirements(...)`),\n  // so depending on its *identity* re-fires the sync effect — and its\n  // `rmmRegistry.notifyInstanceRuntimeChanged()` — on every commit even when the\n  // requirements are unchanged, which storms the WebSocket room re-subscription.\n  // Keying by content mirrors `contextResourceIdentifiersKey`.\n  const parentResourcesRequirementsKey = useMemo(\n    () => JSON.stringify(parentResourcesRequirements ?? null),\n    [parentResourcesRequirements],\n  );\n  const resourceIdStr = resourceId ? String(resourceId) : '';\n\n  const transportAdapter = useMemo(\n    () => new HttpTransportAdapter((...args) => doOperationRef.current!(...args)),\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- doOperationRef is a stable ref\n    [],\n  );\n\n  const updateOperation = useMemo(() => {\n    return pickPreferredOperationForCoreSemanticAddressability({\n      resourceConfig,\n      operations: resourceConfig?.operations ?? [],\n      coreOperation: CoreResourceOperation.UPDATE,\n      registry,\n      hasResourceId: Boolean(resourceIdStr),\n      contextResourceIdentifiers,\n      contextualParameters,\n    });\n  }, [contextResourceIdentifiersKey, contextualParameters, registry, resourceConfig, resourceIdStr]);\n\n  const rmmOperationPathKey = useMemo(() => {\n    if (!updateOperation) {\n      return null;\n    }\n\n    return ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(updateOperation);\n  }, [resourceType, updateOperation]);\n\n  const rmmReadOperationPathKey = useMemo(() => {\n    return resolveCanonicalRMMReadOperationPathKey(resourceType, registry, {\n      hasResourceId: Boolean(resourceIdStr),\n      contextResourceIdentifiers,\n      contextualParameters,\n    });\n  }, [contextResourceIdentifiersKey, contextualParameters, registry, resourceConfig?.operations, resourceIdStr, resourceType]);\n\n  const listOperations = useMemo(\n    () => {\n      const { [resourceType]: _self, ...parentScopeIdentifiers } = contextResourceIdentifiers ?? {};\n      const parentContextualParameters = FrontendResourceUtils.buildContextualParameters(\n        parentScopeIdentifiers,\n        registry,\n      );\n      return getOperationsForCoreSemantic(\n        resourceConfig?.operations ?? [],\n        CoreResourceOperation.LIST,\n      ).filter((listOperation) =>\n        operationInitiatorParametersSatisfied({\n          operation: listOperation,\n          contextResourceIdentifiers: parentScopeIdentifiers,\n          contextualParameters: parentContextualParameters,\n        })\n      );\n    },\n    [contextResourceIdentifiersKey, registry, resourceConfig?.operations, resourceType],\n  );\n\n  /**\n   * Classify why RMM is unattached, expected-absence checks first. The\n   * precedence matters because the reason drives log level downstream:\n   * `DISABLED` / `MISSING_RESOURCE_ID` are expected absences (debug),\n   * `NO_ELIGIBLE_UPDATE_OPERATION` / `PROVIDER_MISSING` are genuine\n   * integration failures (warn).\n   *\n   * - `!enabled` always classifies as DISABLED, even when no update\n   *   operation resolves: the caller explicitly opted out (the form /\n   *   displayer / layout callers gate `enabled` on `<update-like> && <has\n   *   id>`; the execution participation bridge gates it on execution-level\n   *   availability), so a CREATE surface must not be reported as an\n   *   operation-eligibility failure.\n   * - The missing-id check runs before operation eligibility: without an id\n   *   RMM can never attach (the registry is keyed by resource id), and\n   *   UPDATE addressability is resolved with `hasResourceId: false`, so an\n   *   unresolved operation on an id-less surface is the expected CREATE /\n   *   pre-bootstrap shape rather than a broken update-like surface.\n   *\n   * Rejected alternative: keeping the old loud-first order and only\n   * downgrading the log level — that would still misreport create-like\n   * surfaces as `NO_ELIGIBLE_UPDATE_OPERATION` to consumers of\n   * `rmmUnavailableReason`. All reasons keep failing closed (rmm === null);\n   * only classification and log level differ.\n   */\n  const rmmUnavailableReason = useMemo((): UseResourceRMMUnavailableReason | null => {\n    if (!enabled) {\n      return UseResourceRMMUnavailableReason.DISABLED;\n    }\n    if (!resourceIdStr) {\n      return UseResourceRMMUnavailableReason.MISSING_RESOURCE_ID;\n    }\n    if (!updateOperation) {\n      return UseResourceRMMUnavailableReason.NO_ELIGIBLE_UPDATE_OPERATION;\n    }\n    if (!rmmRegistry) {\n      return UseResourceRMMUnavailableReason.PROVIDER_MISSING;\n    }\n\n    return null;\n  }, [enabled, resourceIdStr, rmmRegistry, updateOperation]);\n\n  const rmm = useMemo(() => {\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.DISABLED) {\n      logDebug('RMM unavailable because attachment is disabled for this surface.', {\n        resourceType,\n        resourceId: resourceIdStr,\n      });\n      return null;\n    }\n\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.MISSING_RESOURCE_ID) {\n      logDebug('RMM unavailable because no resource id is attached to the current surface.', {\n        resourceType,\n      });\n      return null;\n    }\n\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.NO_ELIGIBLE_UPDATE_OPERATION) {\n      logger.warn('[useResourceRMM] RMM unavailable because no eligible UPDATE-like operation could be resolved for this surface. Default update-like surfaces should fail closed unless they explicitly opt into a weaker direct-operation fallback.', {\n        resourceType,\n        resourceId: resourceIdStr,\n      });\n      return null;\n    }\n\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.PROVIDER_MISSING) {\n      logger.warn('[useResourceRMM] RMM unavailable because RMMRegistryProvider is not mounted. Default update-like surfaces should fail closed unless they explicitly opt into a weaker direct-operation fallback.', {\n        resourceType,\n        resourceId: resourceIdStr,\n      });\n      return null;\n    }\n    return rmmRegistry.getOrCreate(resourceType, resourceIdStr, {\n      resourceType,\n      resourceId: resourceIdStr,\n      transportAdapter,\n      operationPathKey: rmmOperationPathKey!,\n      readOperationPathKey: rmmReadOperationPathKey,\n      conflictPolicy,\n      currentUserId,\n      contextResourceIdentifiers: normalizeContextResourceIdentifiersForTransport(contextResourceIdentifiers),\n      contextualParameters,\n      parentResourcesRequirements,\n      resourceSchema,\n    });\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- registry identity + sync effect for routing/auth\n  }, [rmmOperationPathKey, rmmReadOperationPathKey, rmmRegistry, resourceType, resourceIdStr, rmmUnavailableReason]);\n\n  useEffect(() => {\n    if (!rmm || !rmmOperationPathKey) return;\n    rmm.syncRuntimeRoutingConfig({\n      transportAdapter,\n      currentUserId,\n      contextResourceIdentifiers: normalizeContextResourceIdentifiersForTransport(contextResourceIdentifiers),\n      contextualParameters,\n      parentResourcesRequirements,\n      operationPathKey: rmmOperationPathKey,\n      readOperationPathKey: rmmReadOperationPathKey,\n      conflictPolicy,\n      resourceSchema,\n    });\n    rmmRegistry?.notifyInstanceRuntimeChanged();\n  }, [\n    rmm,\n    rmmRegistry,\n    currentUserId,\n    // `ConflictPolicy` is `{ strategy }`; depend on the strategy value, not the\n    // (commonly inline, fresh-identity) object literal callers pass, so the sync\n    // effect does not re-fire — and re-notify — on every commit.\n    conflictPolicy.strategy,\n    contextResourceIdentifiersKey,\n    rmmOperationPathKey,\n    rmmReadOperationPathKey,\n    parentResourcesRequirementsKey,\n    contextualParameters,\n    resourceSchema,\n    transportAdapter,\n  ]);\n\n  useEffect(() => {\n    if (!rmm || !rmmRegistry || !resourceIdStr) {\n      return;\n    }\n\n    const key = rmmRegistry.keyFor(resourceType, resourceIdStr);\n    return () => {\n      rmmRegistry.release(key);\n    };\n  }, [rmm, rmmRegistry, resourceType, resourceIdStr]);\n\n  const rmmSnapshot = useSyncExternalStore(\n    rmm?.subscribe ?? NOOP_SUBSCRIBE,\n    rmm?.getSnapshot ?? NOOP_GET_SNAPSHOT,\n  );\n\n  useListInvalidation(rmm, {\n    contextResourceIdentifiers: normalizeContextResourceIdentifiersForTransport(contextResourceIdentifiers),\n    parentResourcesRequirements: parentResourcesRequirements ?? [],\n    listOperations,\n  });\n\n  return {\n    rmm,\n    rmmSnapshot,\n    rmmRegistry: rmmRegistry ?? null,\n    rmmUnavailableReason,\n    canonicalReadOperationPathKey: rmmReadOperationPathKey,\n  };\n}\n"]}

package/dist/esm/core/resources/useAuthedFileObjectUrl.frontend.hook.d.ts

@@ -0,0 +1,2 @@
+export declare function useAuthedFileObjectUrl(serveUrl: string | null | undefined): string | null;
+//# sourceMappingURL=useAuthedFileObjectUrl.frontend.hook.d.ts.map

package/dist/esm/core/resources/useAuthedFileObjectUrl.frontend.hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAuthedFileObjectUrl.frontend.hook.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/useAuthedFileObjectUrl.frontend.hook.ts"],"names":[],"mappings":"AAkBA,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CA8BzF"}

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

@@ -0,0 +1,50 @@
+/**
+ * Fetch a protected file's bytes over the AUTHENTICATED client and expose them as an
+ * object URL suitable for an `<img>` / `<embed>` `src`.
+ *
+ * An `<img>` cannot attach the bearer token, so a protected serve URL can't be loaded
+ * directly. This hook fetches the bytes (`WildoBackendHttpClient.fetchFileBlob` — the
+ * backend serve route authorizes via the linked resource's READ) and wraps the Blob in
+ * `URL.createObjectURL`, revoking it and aborting the request on unmount / url change.
+ *
+ * Returns `null` while loading, when `serveUrl` is absent, or on failure — so callers
+ * degrade to their own placeholder (e.g. initials). Use in any saas-frontend-lib surface
+ * that renders a file preview outside the resource displayer (e.g. the nav user-menu
+ * avatar). Inside the presets file components, prefer the injected `httpOperations.getBlob`
+ * (keeps presets off the HTTP client).
+ */
+import { useEffect, useState } from 'react';
+import { useApplication } from '../../core/runtime/useApplication.js';
+export function useAuthedFileObjectUrl(serveUrl) {
+    const { httpClient } = useApplication();
+    const [objectUrl, setObjectUrl] = useState(null);
+    useEffect(() => {
+        if (!serveUrl) {
+            setObjectUrl(null);
+            return;
+        }
+        let cancelled = false;
+        let created = null;
+        const controller = new AbortController();
+        httpClient
+            .fetchFileBlob(serveUrl, { signal: controller.signal })
+            .then((blob) => {
+            if (cancelled)
+                return;
+            created = URL.createObjectURL(blob);
+            setObjectUrl(created);
+        })
+            .catch(() => {
+            if (!cancelled)
+                setObjectUrl(null);
+        });
+        return () => {
+            cancelled = true;
+            controller.abort();
+            if (created)
+                URL.revokeObjectURL(created);
+        };
+    }, [serveUrl, httpClient]);
+    return objectUrl;
+}
+//# sourceMappingURL=useAuthedFileObjectUrl.frontend.hook.js.map

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

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

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

@@ -4,5 +4,5 @@
  * The canonical implementation lives in ./hooks/useOperationEnabled.ts.
  * This file exists as a public re-export point (used by index.ts barrel).
  */
-export { useOperationEnabled, useOperationsEnabled, type UseOperationEnabledParams, type UseOperationEnabledResult, type OperationEnabledEntry, type FeatureAvailability, } from './hooks/useOperationEnabled.js';
+export { useOperationEnabled, useOperationsEnabled, type UseOperationEnabledParams, type UseOperationEnabledResult, type OperationEnabledEntry, type FeatureAvailability, } from './hooks/useOperationEnabled';
 //# sourceMappingURL=useOperationEnabled.d.ts.map

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

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

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

@@ -5,4 +5,4 @@
  * This file exists as a public re-export point (used by index.ts barrel).
  */
 export { useOperationEnabled, useOperationsEnabled, } from './hooks/useOperationEnabled.js';
-//# sourceMappingURL=useOperationEnabled.js.map
+//# sourceMappingURL=useOperationEnabled.js.map

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

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

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

@@ -22,7 +22,7 @@
  */
 import { z } from 'zod';
 import type { DisplayOrFormSectionLabel } from '@wildo-ai/presets-components-models';
-import type { LayoutRefManifest } from '../../core/resources/resources.frontend.schemas.js';
+import type { LayoutRefManifest } from '../../core/resources/resources.frontend.schemas';
 export interface ResourceLabelContext {
     resourceType: string;
     operationId: string;
@@ -33,14 +33,14 @@ export interface UseResourceLabelsOptions {
      * section names and wizard step names for i18n resolution.
      */
     layoutRefs?: LayoutRefManifest;
-    /** Explicit label overrides — these take priority over i18n */
+    /** Explicit i18n-key overrides — these take priority over ref-derived defaults */
     overrides?: {
         fields?: Record<string, string>;
         /** Explicit description overrides per field name */
         descriptions?: Record<string, string>;
         enums?: Record<string, Record<string, string>>;
-        sections?: Record<string, string | DisplayOrFormSectionLabel>;
-        wizardSteps?: Record<string, string | DisplayOrFormSectionLabel>;
+        sections?: Record<string, DisplayOrFormSectionLabel>;
+        wizardSteps?: Record<string, DisplayOrFormSectionLabel>;
     };
 }
 export interface UseResourceLabelsResult {
@@ -53,9 +53,19 @@ export interface UseResourceLabelsResult {
     fieldTooltips: Record<string, string>;
     enumLabels: Record<string, Record<string, string>>;
     sectionLabels: Record<string, string>;
+    sectionDescriptions: Record<string, string>;
     wizardStepLabels: Record<string, string>;
+    wizardStepDescriptions: Record<string, string>;
     /** Resolved group labels (keyed by group ref). Resolved via i18n key `resources.{type}.groups.{ref}.title`. */
     groupLabels: Record<string, string>;
+    /**
+     * Whether the underlying resource-label i18n bundle has finished loading.
+     * The maps above always return usable strings (formatted field-name fallbacks)
+     * even while `false`, so this is NOT required for correctness — it lets callers
+     * hold a skeleton until the *real* labels land instead of flashing the
+     * humanized field-name fallback, then swapping (see `AutomatedForm`).
+     */
+    isReady: boolean;
 }
 /**
  * Resolve field labels, enum labels, section labels, and wizard step labels
@@ -69,7 +79,7 @@ export interface UseResourceLabelsResult {
  * @param resourceContext - Resource type and operation ID for i18n key construction
  * @param data - Current object data for {{param}} interpolation in parameterized labels
  * @param mode - 'display' or 'edit' — determines which i18n helper to call
- * @param options - Layout refs (for section/wizard step i18n) and explicit overrides
+ * @param options - Layout refs (for ref-derived section/wizard-step i18n) and explicit key overrides
  */
 export declare function useResourceLabels(schema: z.ZodTypeAny, resourceContext?: ResourceLabelContext, data?: Record<string, unknown>, mode?: 'display' | 'edit', options?: UseResourceLabelsOptions): UseResourceLabelsResult;
 //# sourceMappingURL=useResourceLabels.d.ts.map

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

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