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

package/dist/esm/components/views/composite-view/CompositeView.js

@@ -8,6 +8,7 @@ import { NavigationZone } from '../../../core/navigation/navigation.schemas.js';
 import { FrontendInsertedViewHostKind, FrontendInsertedViewKind, parseFrontendInsertedViewRef, } from '../../../core/config/inserted-view.frontend.schemas.js';
 import { FrontendView_ScopeMode } from '../../../core/config/views-frontend.schemas.js';
 import { useResourceRegistry } from '../../../core/resources/useResourceRegistry.js';
+import { FrontendResourceUtils } from '../../../core/resources/frontend-resource.utils.js';
 import { ScopeUtilsService } from '../../../core/scope/scope.utils.frontend.service.js';
 import { useAppScopeSafe } from '../../../core/scope/useAppScope.js';
 import { CompositeViewProvider, useOptionalCompositeViewContext } from './CompositeViewContext.js';
@@ -30,13 +31,12 @@ export const CompositeView = ({ viewRef, document: documentProp, hostResourceTyp
         ?? parentCompositeContext?.hostResourceType;
     const resolvedContextResourceIdentifiers = contextResourceIdentifiers
         ?? parentCompositeContext?.contextResourceIdentifiers;
-    // Resolve document: use provided prop, or resolve from inserted resource host, or resolve from app UIContext
-    const document = documentProp
-        ?? resolveCompositeViewDefinition({
-            viewRef,
-            compositeViews,
-            registry,
-        });
+    // Resolve document: use provided prop, or resolve from inserted resource host, or resolve from app UIContext.
+    // Memoized so the resolved definition keeps a stable identity across renders — it
+    // is a field of the CompositeViewProvider value and a dep of several memos below;
+    // a fresh object each render would defeat that provider's identity stability and
+    // re-render every embedded surface.
+    const document = useMemo(() => documentProp ?? resolveCompositeViewDefinition({ viewRef, compositeViews, registry }), [documentProp, viewRef, compositeViews, registry]);
     useEffect(() => {
         if (process.env.NODE_ENV === 'production'
             || document
@@ -51,7 +51,7 @@ export const CompositeView = ({ viewRef, document: documentProp, hostResourceTyp
             explicitContextResourceIdentifiers: resolvedContextResourceIdentifiers,
         });
     }, [document, resolvedContextResourceIdentifiers, viewRef]);
-    const mergedContextResourceIdentifiers = useMemo(() => {
+    const computedMergedContextResourceIdentifiers = useMemo(() => {
         const primaryScopeInitiatorIds = ScopeUtilsService.buildInitiatorIds({
             userId: appScope?.currentUserId,
             organizationId: appScope?.currentOrganizationId,
@@ -74,18 +74,31 @@ export const CompositeView = ({ viewRef, document: documentProp, hostResourceTyp
                     isPrimaryScope: false,
                 }]
             : [];
+        const mergedAdditionalResourceRequirements = [
+            ...(document.additionalResourceRequirements ?? []),
+            ...hostResourceRequirement,
+        ];
+        // Drop inherited ancestor keys the composite never scopes by — e.g. a todo
+        // opened via `/todo-lists/{list}/todos/{todo}` hands its workspace
+        // `todoLists`, but the workspace's contract is {primaryScope, host todo}.
+        // The host resource IS in the contract (added via hostResourceRequirement),
+        // so the embedded host READ keeps the id it needs; only the dead ancestor is
+        // dropped. This keeps the context forwarded to every embedded surface honest
+        // and silences the dev "context bindings outside its declared contract" warning.
+        const allowedBindingKeys = ScopeUtilsService.getAllowedViewBindingKeys({
+            primaryScope: document.primaryScope,
+            parentResourcesRequirements: document.parentResourcesRequirements,
+            additionalResourceRequirements: mergedAdditionalResourceRequirements,
+        });
         return ScopeUtilsService.resolveViewContextResourceIdentifiers({
             surfaceName: 'CompositeView',
             surfaceRef: document.ref,
             primaryScope: document.primaryScope,
             parentResourcesRequirements: document.parentResourcesRequirements,
-            additionalResourceRequirements: [
-                ...(document.additionalResourceRequirements ?? []),
-                ...hostResourceRequirement,
-            ],
+            additionalResourceRequirements: mergedAdditionalResourceRequirements,
             primaryScopeContext,
             customScopeContext,
-            explicitContextResourceIdentifiers: resolvedContextResourceIdentifiers,
+            explicitContextResourceIdentifiers: ScopeUtilsService.scopeContextToBindingContract(resolvedContextResourceIdentifiers, allowedBindingKeys),
         });
     }, [
         appScope,
@@ -97,15 +110,30 @@ export const CompositeView = ({ viewRef, document: documentProp, hostResourceTyp
         resolvedHostResourceType,
         resolvedContextResourceIdentifiers,
     ]);
+    /**
+     * IDENTITY-STABLE scoped identifiers. The memo above depends on the live
+     * `appScope` object, whose identity churns on every AppScope provider render —
+     * so it recomputes to a fresh `Record` constantly even when the actual scoped
+     * ids are unchanged. That fresh object is the root of the composite re-render
+     * loop: it flows into `CompositeViewProvider` and every embedded surface,
+     * rebuilding resource-operation contexts (and cloning configs) each render.
+     * Keying a passthrough memo on the value-derived identifiers key collapses the
+     * identity back to a single reference per distinct value — recomputing only
+     * when the scoped ids genuinely change, so no context goes stale.
+     */
+    const mergedContextResourceIdentifiersKey = FrontendResourceUtils.buildContextResourceIdentifiersKey(computedMergedContextResourceIdentifiers);
+    const mergedContextResourceIdentifiers = useMemo(() => computedMergedContextResourceIdentifiers, 
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- intentionally keyed by value (key), not by the recomputed-every-render object identity
+    [mergedContextResourceIdentifiersKey]);
     const resolvedNavigationZone = navigationZone
         ?? parentCompositeContext?.navigationZone
         ?? NavigationZone.PRIMARY;
     const resolvedNavigationInitiator = navigationInitiator ?? parentCompositeContext?.navigationInitiator;
     if (!document) {
-        return _jsx(ViewNotFound, { viewType: "Composite view", viewRef: viewRef });
+        return _jsx(ViewNotFound, { viewKind: "composite", viewRef: viewRef });
     }
     const CompositeComponent = document.viewComponent;
     return (_jsx(CompositeViewProvider, { viewDefinition: document, breakpoint: currentBreakpoint, navigationZone: resolvedNavigationZone, navigationInitiator: resolvedNavigationInitiator, hostResourceType: resolvedHostResourceType, contextResourceIdentifiers: mergedContextResourceIdentifiers, children: _jsx(CompositeComponent, { viewRef: document.ref, viewDefinition: document }) }));
 };
 export default CompositeView;
-//# sourceMappingURL=CompositeView.js.map
+//# sourceMappingURL=CompositeView.js.map

package/dist/esm/components/views/composite-view/CompositeView.js.map

@@ -1 +1 @@
-{"version":3,"file":"CompositeView.js","sourceRoot":"","sources":["../../../../../src/components/views/composite-view/CompositeView.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"CompositeView.js","sourceRoot":"","sources":["../../../../../../src/components/views/composite-view/CompositeView.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAClD,OAAO,EAAE,iCAAiC,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAGL,8BAA8B,GAC/B,MAAM,wDAAwD,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,mDAAmD,CAAC;AACjF,OAAO,EAAE,cAAc,EAAmC,MAAM,wDAAwD,CAAC;AACzH,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,gEAAgE,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wDAAwD,CAAC;AAChG,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAC7F,OAAO,EAAE,qBAAqB,EAAE,MAAM,4DAA4D,CAAC;AACnG,OAAO,EAAE,iBAAiB,EAAE,MAAM,6DAA6D,CAAC;AAChG,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AAiBhG;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAiC,CAAC,EAC1D,OAAO,EACP,QAAQ,EAAE,YAAY,EACtB,gBAAgB,EAChB,0BAA0B,EAC1B,cAAc,EACd,mBAAmB,GACpB,EAAE,EAAE;IACH,MAAM,sBAAsB,GAAG,+BAA+B,EAAE,CAAC;IACjE,MAAM,EAAE,QAAQ,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAC3C,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;IAEnC,sEAAsE;IACtE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,KAAK,EAAE,CAAC;IAC7C,MAAM,iBAAiB,GAAG,QAAQ,EAAE,iBAAiB,CAAC;IAEtD,MAAM,gBAAgB,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,4BAA4B,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAE/F,MAAM,wBAAwB,GAAG,gBAAgB;WAC5C,CACD,gBAAgB,EAAE,QAAQ,KAAK,4BAA4B,CAAC,QAAQ;eACjE,gBAAgB,CAAC,QAAQ,KAAK,wBAAwB,CAAC,cAAc;YACtE,CAAC,CAAC,gBAAgB,CAAC,OAAO;YAC1B,CAAC,CAAC,SAAS,CACd;WACE,sBAAsB,EAAE,gBAAgB,CAAC;IAE9C,MAAM,kCAAkC,GAAG,0BAA0B;WAChE,sBAAsB,EAAE,0BAA0B,CAAC;IAExD,8GAA8G;IAC9G,kFAAkF;IAClF,kFAAkF;IAClF,iFAAiF;IACjF,oCAAoC;IACpC,MAAM,QAAQ,GAAG,OAAO,CACtB,GAAG,EAAE,CAAC,YAAY,IAAI,8BAA8B,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC,EAC3F,CAAC,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,CAAC,CAClD,CAAC;IACF,SAAS,CAAC,GAAG,EAAE;QACb,IACE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;eAClC,QAAQ;eACR,CAAC,OAAO;eACR,CAAC,kCAAkC;eACnC,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC,MAAM,KAAK,CAAC,EAC/D,CAAC;YACD,OAAO;QACT,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,kHAAkH,EAAE;YAC/H,WAAW,EAAE,eAAe;YAC5B,UAAU,EAAE,OAAO;YACnB,kCAAkC,EAAE,kCAAkC;SACvE,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,QAAQ,EAAE,kCAAkC,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5D,MAAM,wCAAwC,GAAG,OAAO,CAAC,GAAG,EAAE;QAC5D,MAAM,wBAAwB,GAAG,iBAAiB,CAAC,iBAAiB,CAAC;YACnE,MAAM,EAAE,QAAQ,EAAE,aAAa;YAC/B,cAAc,EAAE,QAAQ,EAAE,qBAAqB;YAC/C,aAAa,EAAE,QAAQ,EAAE,oBAAoB;YAC7C,eAAe,EAAE,QAAQ,EAAE,sBAAsB;SAClD,CAAC,CAAC;QACH,MAAM,mBAAmB,GACvB,QAAQ,EAAE,YAAY;YACpB,CAAC,CAAC,iBAAiB,CAAC,gCAAgC,CAChD,wBAAwB,EACxB,QAAQ,CAAC,YAAY,CACtB;YACH,CAAC,CAAC,EAAE,CAAC;QACT,MAAM,mBAAmB,GAAG,QAAQ,EAAE,+BAA+B,EAAE,IAAI,EAAE,CAAC;QAC9E,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,2CAA2C,CAAC,mBAAmB,CAAC,CAAC;QAE9G,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,iBAAiB,CAAC,+BAA+B,CACtD,mBAAmB,EACnB,kBAAkB,EAClB,kCAAkC,CACnC,CAAC;QACJ,CAAC;QAED,MAAM,uBAAuB,GAAG,CAC9B,QAAQ,CAAC,KAAK,KAAK,sBAAsB,CAAC,QAAQ;eAC/C,wBAAwB,CAC5B;YACC,CAAC,CAAC,CAAC;oBACC,YAAY,EAAE,wBAAwB;oBACtC,WAAW,EAAE,iCAAiC,CAAC,QAAQ;oBACvD,cAAc,EAAE,KAAK;iBACtB,CAAC;YACJ,CAAC,CAAC,EAAE,CAAC;QAEP,MAAM,oCAAoC,GAAG;YAC3C,GAAG,CAAC,QAAQ,CAAC,8BAA8B,IAAI,EAAE,CAAC;YAClD,GAAG,uBAAuB;SAC3B,CAAC;QACF,2EAA2E;QAC3E,mEAAmE;QACnE,0EAA0E;QAC1E,4EAA4E;QAC5E,6EAA6E;QAC7E,6EAA6E;QAC7E,iFAAiF;QACjF,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,yBAAyB,CAAC;YACrE,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,2BAA2B,EAAE,QAAQ,CAAC,2BAA2B;YACjE,8BAA8B,EAAE,oCAAoC;SACrE,CAAC,CAAC;QACH,OAAO,iBAAiB,CAAC,qCAAqC,CAAC;YAC7D,WAAW,EAAE,eAAe;YAC5B,UAAU,EAAE,QAAQ,CAAC,GAAG;YACxB,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,2BAA2B,EAAE,QAAQ,CAAC,2BAA2B;YACjE,8BAA8B,EAAE,oCAAoC;YACpE,mBAAmB;YACnB,kBAAkB;YAClB,kCAAkC,EAAE,iBAAiB,CAAC,6BAA6B,CACjF,kCAAkC,EAClC,kBAAkB,CACnB;SACF,CAAC,CAAC;IACL,CAAC,EAAE;QACD,QAAQ;QACR,QAAQ,EAAE,sBAAsB;QAChC,QAAQ,EAAE,oBAAoB;QAC9B,QAAQ,EAAE,qBAAqB;QAC/B,QAAQ,EAAE,aAAa;QACvB,QAAQ;QACR,wBAAwB;QACxB,kCAAkC;KACnC,CAAC,CAAC;IACH;;;;;;;;;;OAUG;IACH,MAAM,mCAAmC,GAAG,qBAAqB,CAAC,kCAAkC,CAClG,wCAAwC,CACzC,CAAC;IACF,MAAM,gCAAgC,GAAG,OAAO,CAC9C,GAAG,EAAE,CAAC,wCAAwC;IAC9C,iJAAiJ;IACjJ,CAAC,mCAAmC,CAAC,CACtC,CAAC;IACF,MAAM,sBAAsB,GAAG,cAAc;WACxC,sBAAsB,EAAE,cAAc;WACtC,cAAc,CAAC,OAAO,CAAC;IAC5B,MAAM,2BAA2B,GAAG,mBAAmB,IAAI,sBAAsB,EAAE,mBAAmB,CAAC;IAEvG,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,KAAC,YAAY,IAAC,QAAQ,EAAC,WAAW,EAAC,OAAO,EAAE,OAAO,GAAI,CAAC;IACjE,CAAC;IAED,MAAM,kBAAkB,GAAqD,QAAQ,CAAC,aAAa,CAAC;IAEpG,OAAO,CACL,KAAC,qBAAqB,IACpB,cAAc,EAAE,QAAQ,EACxB,UAAU,EAAE,iBAAiB,EAC7B,cAAc,EAAE,sBAAsB,EACtC,mBAAmB,EAAE,2BAA2B,EAChD,gBAAgB,EAAE,wBAAwB,EAC1C,0BAA0B,EAAE,gCAAgC,YAE5D,KAAC,kBAAkB,IAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,GAAI,GACjD,CACzB,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,aAAa,CAAC","sourcesContent":["import React, { useEffect, useMemo } from 'react';\nimport { ResourceParentResourceRequirement } from '@wildo-ai/saas-models';\nimport {\n  type CompositeViewComponentProps,\n  type CompositeViewDefinition,\n  resolveCompositeViewDefinition,\n} from '~wildo-frontend-lib/core/config/composite-view.schemas';\nimport { useUI } from \"~wildo-frontend-lib/core/ui/useUI\";\nimport { ViewNotFound } from '~wildo-frontend-lib/components/views/ViewNotFound';\nimport { NavigationZone, type NavigationInitiatorContext } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport {\n  FrontendInsertedViewHostKind,\n  FrontendInsertedViewKind,\n  parseFrontendInsertedViewRef,\n} from '~wildo-frontend-lib/core/config/inserted-view.frontend.schemas';\nimport { FrontendView_ScopeMode } from '~wildo-frontend-lib/core/config/views-frontend.schemas';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { ScopeUtilsService } from '~wildo-frontend-lib/core/scope/scope.utils.frontend.service';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\nimport { CompositeViewProvider, useOptionalCompositeViewContext } from './CompositeViewContext';\n\nexport interface CompositeViewProps {\n  /** View reference — resolved from UIContext internally. Mutually exclusive with `document`. */\n  viewRef?: string;\n  /** Pre-resolved document to load. When provided, viewRef is ignored. */\n  document?: CompositeViewDefinition;\n  /** Explicit resource host type for resource-scoped composite runtimes. */\n  hostResourceType?: string;\n  /** Explicit scoped resource identifiers for resource-scoped composite runtimes. */\n  contextResourceIdentifiers?: Record<string, string>;\n  /** Framework-owned transient runtime zone. */\n  navigationZone?: NavigationZone;\n  /** Framework-owned transient navigation initiator. */\n  navigationInitiator?: NavigationInitiatorContext;\n}\n\n/**\n * CompositeView - top-level host for authored composite surfaces.\n */\nexport const CompositeView: React.FC<CompositeViewProps> = ({\n  viewRef,\n  document: documentProp,\n  hostResourceType,\n  contextResourceIdentifiers,\n  navigationZone,\n  navigationInitiator,\n}) => {\n  const parentCompositeContext = useOptionalCompositeViewContext();\n  const { registry } = useResourceRegistry();\n  const appScope = useAppScopeSafe();\n\n  // Get current viewport breakpoint and composite views from UI context\n  const { UIConfig, compositeViews } = useUI();\n  const currentBreakpoint = UIConfig?.currentBreakpoint;\n\n  const insertedIdentity = React.useMemo(() => parseFrontendInsertedViewRef(viewRef), [viewRef]);\n\n  const resolvedHostResourceType = hostResourceType\n    ?? (\n      insertedIdentity?.hostKind === FrontendInsertedViewHostKind.RESOURCE\n      && insertedIdentity.viewKind === FrontendInsertedViewKind.COMPOSITE_VIEW\n        ? insertedIdentity.hostRef\n        : undefined\n    )\n    ?? parentCompositeContext?.hostResourceType;\n\n  const resolvedContextResourceIdentifiers = contextResourceIdentifiers\n    ?? parentCompositeContext?.contextResourceIdentifiers;\n\n  // Resolve document: use provided prop, or resolve from inserted resource host, or resolve from app UIContext.\n  // Memoized so the resolved definition keeps a stable identity across renders — it\n  // is a field of the CompositeViewProvider value and a dep of several memos below;\n  // a fresh object each render would defeat that provider's identity stability and\n  // re-render every embedded surface.\n  const document = useMemo(\n    () => documentProp ?? resolveCompositeViewDefinition({ viewRef, compositeViews, registry }),\n    [documentProp, viewRef, compositeViews, registry],\n  );\n  useEffect(() => {\n    if (\n      process.env.NODE_ENV === 'production'\n      || document\n      || !viewRef\n      || !resolvedContextResourceIdentifiers\n      || Object.keys(resolvedContextResourceIdentifiers).length === 0\n    ) {\n      return;\n    }\n\n    console.warn('[CompositeView] Cannot validate explicit view context bindings because the view definition could not be resolved', {\n      surfaceName: 'CompositeView',\n      surfaceRef: viewRef,\n      explicitContextResourceIdentifiers: resolvedContextResourceIdentifiers,\n    });\n  }, [document, resolvedContextResourceIdentifiers, viewRef]);\n  const computedMergedContextResourceIdentifiers = useMemo(() => {\n    const primaryScopeInitiatorIds = ScopeUtilsService.buildInitiatorIds({\n      userId: appScope?.currentUserId,\n      organizationId: appScope?.currentOrganizationId,\n      applicationId: appScope?.currentApplicationId,\n      anonymousUserId: appScope?.currentAnonymousUserId,\n    });\n    const primaryScopeContext =\n      document?.primaryScope\n        ? ScopeUtilsService.primaryScopeToContextIdentifiers(\n            primaryScopeInitiatorIds,\n            document.primaryScope,\n          )\n        : {};\n    const liveAppScopeContext = appScope?.buildContextResourceIdentifiers() ?? {};\n    const customScopeContext = ScopeUtilsService.filterCustomScopeContextResourceIdentifiers(liveAppScopeContext);\n\n    if (!document) {\n      return ScopeUtilsService.mergeContextResourceIdentifiers(\n        primaryScopeContext,\n        customScopeContext,\n        resolvedContextResourceIdentifiers,\n      );\n    }\n\n    const hostResourceRequirement = (\n      document.scope === FrontendView_ScopeMode.RESOURCE\n      && resolvedHostResourceType\n    )\n      ? [{\n          resourceType: resolvedHostResourceType,\n          requirement: ResourceParentResourceRequirement.OPTIONAL,\n          isPrimaryScope: false,\n        }]\n      : [];\n\n    const mergedAdditionalResourceRequirements = [\n      ...(document.additionalResourceRequirements ?? []),\n      ...hostResourceRequirement,\n    ];\n    // Drop inherited ancestor keys the composite never scopes by — e.g. a todo\n    // opened via `/todo-lists/{list}/todos/{todo}` hands its workspace\n    // `todoLists`, but the workspace's contract is {primaryScope, host todo}.\n    // The host resource IS in the contract (added via hostResourceRequirement),\n    // so the embedded host READ keeps the id it needs; only the dead ancestor is\n    // dropped. This keeps the context forwarded to every embedded surface honest\n    // and silences the dev \"context bindings outside its declared contract\" warning.\n    const allowedBindingKeys = ScopeUtilsService.getAllowedViewBindingKeys({\n      primaryScope: document.primaryScope,\n      parentResourcesRequirements: document.parentResourcesRequirements,\n      additionalResourceRequirements: mergedAdditionalResourceRequirements,\n    });\n    return ScopeUtilsService.resolveViewContextResourceIdentifiers({\n      surfaceName: 'CompositeView',\n      surfaceRef: document.ref,\n      primaryScope: document.primaryScope,\n      parentResourcesRequirements: document.parentResourcesRequirements,\n      additionalResourceRequirements: mergedAdditionalResourceRequirements,\n      primaryScopeContext,\n      customScopeContext,\n      explicitContextResourceIdentifiers: ScopeUtilsService.scopeContextToBindingContract(\n        resolvedContextResourceIdentifiers,\n        allowedBindingKeys,\n      ),\n    });\n  }, [\n    appScope,\n    appScope?.currentAnonymousUserId,\n    appScope?.currentApplicationId,\n    appScope?.currentOrganizationId,\n    appScope?.currentUserId,\n    document,\n    resolvedHostResourceType,\n    resolvedContextResourceIdentifiers,\n  ]);\n  /**\n   * IDENTITY-STABLE scoped identifiers. The memo above depends on the live\n   * `appScope` object, whose identity churns on every AppScope provider render —\n   * so it recomputes to a fresh `Record` constantly even when the actual scoped\n   * ids are unchanged. That fresh object is the root of the composite re-render\n   * loop: it flows into `CompositeViewProvider` and every embedded surface,\n   * rebuilding resource-operation contexts (and cloning configs) each render.\n   * Keying a passthrough memo on the value-derived identifiers key collapses the\n   * identity back to a single reference per distinct value — recomputing only\n   * when the scoped ids genuinely change, so no context goes stale.\n   */\n  const mergedContextResourceIdentifiersKey = FrontendResourceUtils.buildContextResourceIdentifiersKey(\n    computedMergedContextResourceIdentifiers,\n  );\n  const mergedContextResourceIdentifiers = useMemo(\n    () => computedMergedContextResourceIdentifiers,\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- intentionally keyed by value (key), not by the recomputed-every-render object identity\n    [mergedContextResourceIdentifiersKey],\n  );\n  const resolvedNavigationZone = navigationZone\n    ?? parentCompositeContext?.navigationZone\n    ?? NavigationZone.PRIMARY;\n  const resolvedNavigationInitiator = navigationInitiator ?? parentCompositeContext?.navigationInitiator;\n\n  if (!document) {\n    return <ViewNotFound viewKind=\"composite\" viewRef={viewRef} />;\n  }\n\n  const CompositeComponent: React.ComponentType<CompositeViewComponentProps> = document.viewComponent;\n\n  return (\n    <CompositeViewProvider\n      viewDefinition={document}\n      breakpoint={currentBreakpoint}\n      navigationZone={resolvedNavigationZone}\n      navigationInitiator={resolvedNavigationInitiator}\n      hostResourceType={resolvedHostResourceType}\n      contextResourceIdentifiers={mergedContextResourceIdentifiers}\n    >\n      <CompositeComponent viewRef={document.ref} viewDefinition={document} />\n    </CompositeViewProvider>\n  );\n};\n\nexport default CompositeView;\n\n"]}

package/dist/esm/components/views/composite-view/CompositeViewContext.d.ts

@@ -1,7 +1,20 @@
 import React from 'react';
 import { ViewportBreakpoint } from '@wildo-ai/zod-decorators';
-import type { CompositeViewDefinition } from '../../../core/config/composite-view.schemas.js';
-import type { NavigationInitiatorContext, NavigationZone } from '../../../core/navigation/navigation.schemas.js';
+import type { CompositeViewDefinition } from '../../../core/config/composite-view.schemas';
+import type { NavigationInitiatorContext, NavigationZone } from '../../../core/navigation/navigation.schemas';
+/**
+ * Composite-view context.
+ *
+ * `viewDefinition` and `breakpoint` are the genuinely composite-specific half.
+ * The remaining fields describe the HOST RECORD and the navigation an embedded
+ * surface inherits — they are not composite concerns at all, and are ALSO
+ * published through {@link EmbeddedResourceHostProvider} by the provider below,
+ * so the embed family can serve a resource layout that has no composite view.
+ *
+ * They stay declared here as well because composite-only consumers
+ * (`CompositeView`, `CompositeLayout`, the operation-context builder) read them
+ * from this context and there is no benefit in making those go through two.
+ */
 export interface CompositeViewContextValue {
     viewDefinition: CompositeViewDefinition;
     breakpoint?: ViewportBreakpoint;

package/dist/esm/components/views/composite-view/CompositeViewContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CompositeViewContext.d.ts","sourceRoot":"","sources":["../../../../../src/components/views/composite-view/CompositeViewContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoC,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wDAAwD,CAAC;AACtG,OAAO,KAAK,EAAE,0BAA0B,EAAE,cAAc,EAAE,MAAM,wDAAwD,CAAC;AAEzH,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,uBAAuB,CAAC;IACxC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,cAAc,EAAE,cAAc,CAAC;IAC/B,mBAAmB,CAAC,EAAE,0BAA0B,CAAC;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0BAA0B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrD;AAID,MAAM,WAAW,0BAA2B,SAAQ,yBAAyB;IAC3E,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,wBAAgB,qBAAqB,CAAC,EACpC,cAAc,EACd,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,0BAA0B,EAC1B,QAAQ,GACT,EAAE,0BAA0B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAehD;AAED,wBAAgB,uBAAuB,IAAI,yBAAyB,CAMnE;AAED,wBAAgB,+BAA+B,IAAI,yBAAyB,GAAG,IAAI,CAElF"}
+{"version":3,"file":"CompositeViewContext.d.ts","sourceRoot":"","sources":["../../../../../../src/components/views/composite-view/CompositeViewContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wDAAwD,CAAC;AACtG,OAAO,KAAK,EAAE,0BAA0B,EAAE,cAAc,EAAE,MAAM,wDAAwD,CAAC;AAGzH;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,uBAAuB,CAAC;IACxC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,cAAc,EAAE,cAAc,CAAC;IAC/B,mBAAmB,CAAC,EAAE,0BAA0B,CAAC;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0BAA0B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrD;AAID,MAAM,WAAW,0BAA2B,SAAQ,yBAAyB;IAC3E,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,wBAAgB,qBAAqB,CAAC,EACpC,cAAc,EACd,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,0BAA0B,EAC1B,QAAQ,GACT,EAAE,0BAA0B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA+ChD;AAED,wBAAgB,uBAAuB,IAAI,yBAAyB,CAMnE;AAED,wBAAgB,+BAA+B,IAAI,yBAAyB,GAAG,IAAI,CAElF"}

package/dist/esm/components/views/composite-view/CompositeViewContext.js

@@ -1,15 +1,39 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { createContext, useContext } from 'react';
+import { createContext, useContext, useMemo } from 'react';
+import { EmbeddedResourceHostProvider } from '../../../components/resources/embeds/EmbeddedResourceHostContext.js';
 const CompositeViewContext = createContext(null);
 export function CompositeViewProvider({ viewDefinition, breakpoint, navigationZone, navigationInitiator, hostResourceType, contextResourceIdentifiers, children, }) {
-    return (_jsx(CompositeViewContext.Provider, { value: {
-            viewDefinition,
-            breakpoint,
-            navigationZone,
-            navigationInitiator,
-            hostResourceType,
-            contextResourceIdentifiers,
-        }, children: children }));
+    /**
+     * IDENTITY-STABLE context value. Without this memo the provider hands every
+     * composite consumer (each `Embed*` surface) a brand-new value object on every
+     * render. The embeds rebuild their `resourceContext` from that value in render
+     * (cloning resource configs each time — see the 603-config heap churn), and any
+     * downstream effect keyed on the resulting identity re-fires every commit. With
+     * stable field references upstream (`viewDefinition`/`contextResourceIdentifiers`
+     * memoized in `CompositeView`) this value only changes when something genuinely
+     * changes, breaking the composite re-render loop.
+     */
+    const value = useMemo(() => ({
+        viewDefinition,
+        breakpoint,
+        navigationZone,
+        navigationInitiator,
+        hostResourceType,
+        contextResourceIdentifiers,
+    }), [
+        viewDefinition,
+        breakpoint,
+        navigationZone,
+        navigationInitiator,
+        hostResourceType,
+        contextResourceIdentifiers,
+    ]);
+    // A composite view IS an embedded-resource host — so it publishes the neutral
+    // context as well as its own. This is what keeps ONE embed family serving both
+    // planes: the embeds read the neutral context and never learn which kind of
+    // host they are under. Nesting order is deliberate — the neutral provider sits
+    // OUTSIDE, so a nested composite overrides both consistently.
+    return (_jsx(EmbeddedResourceHostProvider, { hostResourceType: hostResourceType, contextResourceIdentifiers: contextResourceIdentifiers, navigationZone: navigationZone, navigationInitiator: navigationInitiator, children: _jsx(CompositeViewContext.Provider, { value: value, children: children }) }));
 }
 export function useCompositeViewContext() {
     const context = useContext(CompositeViewContext);
@@ -21,4 +45,4 @@ export function useCompositeViewContext() {
 export function useOptionalCompositeViewContext() {
     return useContext(CompositeViewContext);
 }
-//# sourceMappingURL=CompositeViewContext.js.map
+//# sourceMappingURL=CompositeViewContext.js.map

package/dist/esm/components/views/composite-view/CompositeViewContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"CompositeViewContext.js","sourceRoot":"","sources":["../../../../../src/components/views/composite-view/CompositeViewContext.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAezD,MAAM,oBAAoB,GAAG,aAAa,CAAmC,IAAI,CAAC,CAAC;AAMnF,MAAM,UAAU,qBAAqB,CAAC,EACpC,cAAc,EACd,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,0BAA0B,EAC1B,QAAQ,GACmB;IAC3B,OAAO,CACL,KAAC,oBAAoB,CAAC,QAAQ,IAC5B,KAAK,EAAE;YACL,cAAc;YACd,UAAU;YACV,cAAc;YACd,mBAAmB;YACnB,gBAAgB;YAChB,0BAA0B;SAC3B,YAEA,QAAQ,GACqB,CACjC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,MAAM,OAAO,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,+BAA+B;IAC7C,OAAO,UAAU,CAAC,oBAAoB,CAAC,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"CompositeViewContext.js","sourceRoot":"","sources":["../../../../../../src/components/views/composite-view/CompositeViewContext.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAKlE,OAAO,EAAE,4BAA4B,EAAE,MAAM,6EAA6E,CAAC;AAwB3H,MAAM,oBAAoB,GAAG,aAAa,CAAmC,IAAI,CAAC,CAAC;AAMnF,MAAM,UAAU,qBAAqB,CAAC,EACpC,cAAc,EACd,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,0BAA0B,EAC1B,QAAQ,GACmB;IAC3B;;;;;;;;;OASG;IACH,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC;QACL,cAAc;QACd,UAAU;QACV,cAAc;QACd,mBAAmB;QACnB,gBAAgB;QAChB,0BAA0B;KAC3B,CAAC,EACF;QACE,cAAc;QACd,UAAU;QACV,cAAc;QACd,mBAAmB;QACnB,gBAAgB;QAChB,0BAA0B;KAC3B,CACF,CAAC;IAEF,8EAA8E;IAC9E,+EAA+E;IAC/E,4EAA4E;IAC5E,+EAA+E;IAC/E,8DAA8D;IAC9D,OAAO,CACL,KAAC,4BAA4B,IAC3B,gBAAgB,EAAE,gBAAgB,EAClC,0BAA0B,EAAE,0BAA0B,EACtD,cAAc,EAAE,cAAc,EAC9B,mBAAmB,EAAE,mBAAmB,YAExC,KAAC,oBAAoB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACxC,QAAQ,GACqB,GACH,CAChC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,MAAM,OAAO,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,+BAA+B;IAC7C,OAAO,UAAU,CAAC,oBAAoB,CAAC,CAAC;AAC1C,CAAC","sourcesContent":["import React, { createContext, useContext, useMemo } from 'react';\nimport { ViewportBreakpoint } from '@wildo-ai/zod-decorators';\n\nimport type { CompositeViewDefinition } from '~wildo-frontend-lib/core/config/composite-view.schemas';\nimport type { NavigationInitiatorContext, NavigationZone } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport { EmbeddedResourceHostProvider } from '~wildo-frontend-lib/components/resources/embeds/EmbeddedResourceHostContext';\n\n/**\n * Composite-view context.\n *\n * `viewDefinition` and `breakpoint` are the genuinely composite-specific half.\n * The remaining fields describe the HOST RECORD and the navigation an embedded\n * surface inherits — they are not composite concerns at all, and are ALSO\n * published through {@link EmbeddedResourceHostProvider} by the provider below,\n * so the embed family can serve a resource layout that has no composite view.\n *\n * They stay declared here as well because composite-only consumers\n * (`CompositeView`, `CompositeLayout`, the operation-context builder) read them\n * from this context and there is no benefit in making those go through two.\n */\nexport interface CompositeViewContextValue {\n  viewDefinition: CompositeViewDefinition;\n  breakpoint?: ViewportBreakpoint;\n  navigationZone: NavigationZone;\n  navigationInitiator?: NavigationInitiatorContext;\n  hostResourceType?: string;\n  contextResourceIdentifiers?: Record<string, string>;\n}\n\nconst CompositeViewContext = createContext<CompositeViewContextValue | null>(null);\n\nexport interface CompositeViewProviderProps extends CompositeViewContextValue {\n  children: React.ReactNode;\n}\n\nexport function CompositeViewProvider({\n  viewDefinition,\n  breakpoint,\n  navigationZone,\n  navigationInitiator,\n  hostResourceType,\n  contextResourceIdentifiers,\n  children,\n}: CompositeViewProviderProps): React.JSX.Element {\n  /**\n   * IDENTITY-STABLE context value. Without this memo the provider hands every\n   * composite consumer (each `Embed*` surface) a brand-new value object on every\n   * render. The embeds rebuild their `resourceContext` from that value in render\n   * (cloning resource configs each time — see the 603-config heap churn), and any\n   * downstream effect keyed on the resulting identity re-fires every commit. With\n   * stable field references upstream (`viewDefinition`/`contextResourceIdentifiers`\n   * memoized in `CompositeView`) this value only changes when something genuinely\n   * changes, breaking the composite re-render loop.\n   */\n  const value = useMemo<CompositeViewContextValue>(\n    () => ({\n      viewDefinition,\n      breakpoint,\n      navigationZone,\n      navigationInitiator,\n      hostResourceType,\n      contextResourceIdentifiers,\n    }),\n    [\n      viewDefinition,\n      breakpoint,\n      navigationZone,\n      navigationInitiator,\n      hostResourceType,\n      contextResourceIdentifiers,\n    ],\n  );\n\n  // A composite view IS an embedded-resource host — so it publishes the neutral\n  // context as well as its own. This is what keeps ONE embed family serving both\n  // planes: the embeds read the neutral context and never learn which kind of\n  // host they are under. Nesting order is deliberate — the neutral provider sits\n  // OUTSIDE, so a nested composite overrides both consistently.\n  return (\n    <EmbeddedResourceHostProvider\n      hostResourceType={hostResourceType}\n      contextResourceIdentifiers={contextResourceIdentifiers}\n      navigationZone={navigationZone}\n      navigationInitiator={navigationInitiator}\n    >\n      <CompositeViewContext.Provider value={value}>\n        {children}\n      </CompositeViewContext.Provider>\n    </EmbeddedResourceHostProvider>\n  );\n}\n\nexport function useCompositeViewContext(): CompositeViewContextValue {\n  const context = useContext(CompositeViewContext);\n  if (!context) {\n    throw new Error('useCompositeViewContext must be used within a CompositeViewProvider');\n  }\n  return context;\n}\n\nexport function useOptionalCompositeViewContext(): CompositeViewContextValue | null {\n  return useContext(CompositeViewContext);\n}\n"]}

package/dist/esm/components/views/composite-view/useCompositeResourceOperationContextBuilder.d.ts

@@ -1,8 +1,8 @@
-import { type CompositeResourceOperationTarget, type CompositeResourceOperationTargetSelector } from './useCompositeResourceContext.js';
-import type { FrontendResourceOperationContext } from '../../../core/resources/resources.frontend.schemas.js';
-export type CompositeExplicitResourceOperationTarget = CompositeResourceOperationTarget & CompositeResourceOperationTargetSelector & {
+import { type EmbeddedResourceOperationTarget, type EmbeddedResourceOperationTargetSelector } from '../../../components/resources/embeds/useEmbeddedResourceContext';
+import type { FrontendResourceOperationContext } from '../../../core/resources/resources.frontend.schemas';
+export type CompositeExplicitResourceOperationTarget = EmbeddedResourceOperationTarget & EmbeddedResourceOperationTargetSelector & {
     resourceType: string;
-    contextResourceIdentifiers?: Record<string, string>;
+    contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];
 };
 export interface CompositeResourceOperationContextBuilderValue {
     buildResourceOperationContext: (target: CompositeExplicitResourceOperationTarget) => FrontendResourceOperationContext;

package/dist/esm/components/views/composite-view/useCompositeResourceOperationContextBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCompositeResourceOperationContextBuilder.d.ts","sourceRoot":"","sources":["../../../../../src/components/views/composite-view/useCompositeResourceOperationContextBuilder.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,gCAAgC,EACrC,KAAK,wCAAwC,EAC9C,MAAM,+BAA+B,CAAC;AAQvC,OAAO,KAAK,EAGV,gCAAgC,EACjC,MAAM,+DAA+D,CAAC;AAGvE,MAAM,MAAM,wCAAwC,GAAG,gCAAgC,GACnF,wCAAwC,GACxC;IACA,YAAY,EAAE,MAAM,CAAC;IACrB,0BAA0B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrD,CAAC;AAEJ,MAAM,WAAW,6CAA6C;IAC5D,6BAA6B,EAAE,CAC7B,MAAM,EAAE,wCAAwC,KAC7C,gCAAgC,CAAC;CACvC;AA4ED,wBAAgB,2CAA2C,IAAI,6CAA6C,CAiD3G"}
+{"version":3,"file":"useCompositeResourceOperationContextBuilder.d.ts","sourceRoot":"","sources":["../../../../../../src/components/views/composite-view/useCompositeResourceOperationContextBuilder.ts"],"names":[],"mappings":"AASA,OAAO,EACL,KAAK,+BAA+B,EACpC,KAAK,uCAAuC,EAC7C,MAAM,4EAA4E,CAAC;AAepF,OAAO,KAAK,EAGV,gCAAgC,EACjC,MAAM,+DAA+D,CAAC;AAGvE,MAAM,MAAM,wCAAwC,GAAG,+BAA+B,GAClF,uCAAuC,GACvC;IACA,YAAY,EAAE,MAAM,CAAC;IACrB,0BAA0B,CAAC,EAAE,gCAAgC,CAAC,4BAA4B,CAAC,CAAC;CAC7F,CAAC;AAEJ,MAAM,WAAW,6CAA6C;IAC5D,6BAA6B,EAAE,CAC7B,MAAM,EAAE,wCAAwC,KAC7C,gCAAgC,CAAC;CACvC;AA0LD,wBAAgB,2CAA2C,IAAI,6CAA6C,CAuD3G"}

package/dist/esm/components/views/composite-view/useCompositeResourceOperationContextBuilder.js

@@ -1,8 +1,9 @@
 import { useCallback } from 'react';
-import { ErrorCustomMessageReference, } from '@wildo-ai/saas-models';
+import { ErrorCustomMessageReference, CoreResourceOperation, } from '@wildo-ai/saas-models';
 import { useOptionalCompositeViewContext } from './CompositeViewContext.js';
 import { frontendResourceUtils, FrontendResourceUtils, } from '../../../core/resources/frontend-resource.utils.js';
-import { pickPreferredOperationForCoreSemantic } from '../../../core/resources/operation-semantics.frontend.utils.js';
+import { pickPreferredOperationForCoreSemantic, } from '../../../core/resources/operation-semantics.frontend.utils.js';
+import { isFrontendOperationAddressableForCurrentContext, pickPreferredOperationForCoreSemanticAddressability, shouldRequireCurrentContextAddressabilityForOperation, } from '../../../core/resources/resource-addressability.frontend.utils.js';
 import { ScopeUtilsService } from '../../../core/scope/scope.utils.frontend.service.js';
 import { useAppScopeSafe } from '../../../core/scope/useAppScope.js';
 import { useResourceRegistry } from '../../../core/resources/useResourceRegistry.js';
@@ -16,24 +17,101 @@ function buildCompositeResourceOperationBuilderError(message, context) {
 function hasOperationIdentifier(target) {
     return 'operationIdentifier' in target;
 }
-function resolveOperationForTarget(resourceConfig, resourceType, target) {
+function resolveExplicitOperationForTarget(resourceConfig, resourceType, target) {
+    const matchingOperations = (resourceConfig.operations ?? []).filter((candidate) => {
+        if (String(candidate.operationIdentifier) !== target.operationIdentifier) {
+            return false;
+        }
+        if (target.variantType !== undefined && candidate.variantType !== target.variantType) {
+            return false;
+        }
+        if (target.variantKey !== undefined && candidate.variantKey !== target.variantKey) {
+            return false;
+        }
+        if (target.isOperationDefault !== undefined && candidate.isOperationDefault !== target.isOperationDefault) {
+            return false;
+        }
+        if (target.isBulkOperation !== undefined && candidate.isBulkOperation !== target.isBulkOperation) {
+            return false;
+        }
+        return true;
+    });
+    if (matchingOperations.length === 1) {
+        return matchingOperations[0];
+    }
+    const defaultNonBulkOperations = matchingOperations.filter((candidate) => candidate.isOperationDefault === true && candidate.isBulkOperation !== true);
+    if (target.variantKey === undefined
+        && target.variantType === undefined
+        && target.isOperationDefault === undefined
+        && target.isBulkOperation === undefined
+        && defaultNonBulkOperations.length === 1) {
+        return defaultNonBulkOperations[0];
+    }
+    throw buildCompositeResourceOperationBuilderError(matchingOperations.length === 0
+        ? `Composite resource-operation builder cannot resolve operation "${target.operationIdentifier}" on resource "${resourceType}".`
+        : `Composite resource-operation builder found ambiguous operation "${target.operationIdentifier}" on resource "${resourceType}".`, {
+        resourceType,
+        operationIdentifier: target.operationIdentifier,
+        variantType: target.variantType,
+        variantKey: target.variantKey,
+        isOperationDefault: target.isOperationDefault,
+        isBulkOperation: target.isBulkOperation,
+        candidates: matchingOperations.map((candidate) => ({
+            variantType: candidate.variantType,
+            variantKey: candidate.variantKey,
+            isOperationDefault: candidate.isOperationDefault,
+            isBulkOperation: candidate.isBulkOperation,
+        })),
+    });
+}
+function resolveOperationForTarget(resourceConfig, resourceType, target, registry, contextResourceIdentifiers) {
     if (!resourceConfig) {
         throw buildCompositeResourceOperationBuilderError(`Composite resource-operation builder cannot resolve resource "${resourceType}" from the registry.`, { resourceType });
     }
     if (hasOperationIdentifier(target)) {
-        const operation = resourceConfig.operations?.find((candidate) => String(candidate.operationIdentifier) === target.operationIdentifier);
-        if (!operation) {
-            throw buildCompositeResourceOperationBuilderError(`Composite resource-operation builder cannot resolve operation "${target.operationIdentifier}" on resource "${resourceType}".`, {
+        const operation = resolveExplicitOperationForTarget(resourceConfig, resourceType, target);
+        const requiresRuntimeAddressability = shouldRequireCurrentContextAddressabilityForOperation({
+            operation,
+            resourceType,
+            resourceConfig,
+        });
+        if (requiresRuntimeAddressability
+            && operation.isBulkOperation !== true
+            && !isFrontendOperationAddressableForCurrentContext({
+                resourceConfig,
+                operation,
+                registry,
+                hasResourceId: frontendResourceUtils.getResourceId(contextResourceIdentifiers[resourceType]).length > 0,
+                contextResourceIdentifiers,
+                contextualParameters: FrontendResourceUtils.buildContextualParameters(contextResourceIdentifiers, registry),
+            })) {
+            throw buildCompositeResourceOperationBuilderError(`Composite resource-operation builder resolved operation "${target.operationIdentifier}" on resource "${resourceType}", but it is not addressable in the current context.`, {
                 resourceType,
                 operationIdentifier: target.operationIdentifier,
             });
         }
         return operation;
     }
-    const semanticOperation = pickPreferredOperationForCoreSemantic(resourceConfig.operations ?? [], target.operationLike, {
-        requireAddressable: target.requireAddressable,
-        allowBulk: target.allowBulk,
-    });
+    const coreOperation = target.operationLike;
+    const requiresRuntimeAddressability = coreOperation === CoreResourceOperation.READ
+        || coreOperation === CoreResourceOperation.UPDATE
+        || coreOperation === CoreResourceOperation.DELETE;
+    const semanticOperation = target.requireAddressable || requiresRuntimeAddressability
+        ? pickPreferredOperationForCoreSemanticAddressability({
+            resourceConfig,
+            operations: resourceConfig.operations ?? [],
+            coreOperation,
+            registry,
+            hasResourceId: frontendResourceUtils.getResourceId(contextResourceIdentifiers[resourceType]).length > 0,
+            allowBulk: target.allowBulk,
+            requireFrontendAddressable: true,
+            contextResourceIdentifiers,
+            contextualParameters: FrontendResourceUtils.buildContextualParameters(contextResourceIdentifiers, registry),
+        })
+        : pickPreferredOperationForCoreSemantic(resourceConfig.operations ?? [], coreOperation, {
+            requireAddressable: target.requireAddressable,
+            allowBulk: target.allowBulk,
+        });
     if (!semanticOperation) {
         throw buildCompositeResourceOperationBuilderError(`Composite resource-operation builder cannot resolve a preferred ${String(target.operationLike)}-like operation on resource "${resourceType}".`, {
             resourceType,
@@ -50,14 +128,19 @@ export function useCompositeResourceOperationContextBuilder() {
     const appScope = useAppScopeSafe();
     const buildResourceOperationContext = useCallback((target) => {
         const resourceConfig = registry.resourceConfigurations[target.resourceType];
-        const operation = resolveOperationForTarget(resourceConfig, target.resourceType, target);
-        const ambientContextResourceIdentifiers = ScopeUtilsService.mergeContextResourceIdentifiers(undefined, appScope?.buildContextResourceIdentifiers() ?? {}, target.contextResourceIdentifiers ?? compositeContext?.contextResourceIdentifiers) ?? {};
+        const explicitContextResourceIdentifiers = target.contextResourceIdentifiers
+            ?? compositeContext?.contextResourceIdentifiers;
+        const flattenedExplicitContextResourceIdentifiers = explicitContextResourceIdentifiers
+            ? FrontendResourceUtils.flattenContextIdentifiers(explicitContextResourceIdentifiers)
+            : undefined;
+        const ambientContextResourceIdentifiers = ScopeUtilsService.mergeContextResourceIdentifiers(undefined, appScope?.buildContextResourceIdentifiers() ?? {}, flattenedExplicitContextResourceIdentifiers) ?? {};
         const contextResourceIdentifiers = target.resourceId
             ? {
                 ...ambientContextResourceIdentifiers,
                 [target.resourceType]: target.resourceId,
             }
             : ambientContextResourceIdentifiers;
+        const operation = resolveOperationForTarget(resourceConfig, target.resourceType, target, registry, contextResourceIdentifiers);
         const parentResourcesRequirements = frontendResourceUtils.buildParentResourcesRequirements(target.resourceType, contextResourceIdentifiers, registry, target.relationshipFieldOverrides);
         return frontendResourceUtils.createFrontendResourceOperationContextFromOperation({
             resourceType: target.resourceType,
@@ -75,4 +158,4 @@ export function useCompositeResourceOperationContextBuilder() {
         buildResourceOperationContext,
     };
 }
-//# sourceMappingURL=useCompositeResourceOperationContextBuilder.js.map
+//# sourceMappingURL=useCompositeResourceOperationContextBuilder.js.map

package/dist/esm/components/views/composite-view/useCompositeResourceOperationContextBuilder.js.map

@@ -1 +1 @@
-{"version":3,"file":"useCompositeResourceOperationContextBuilder.js","sourceRoot":"","sources":["../../../../../src/components/views/composite-view/useCompositeResourceOperationContextBuilder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useCompositeResourceOperationContextBuilder.js","sourceRoot":"","sources":["../../../../../../src/components/views/composite-view/useCompositeResourceOperationContextBuilder.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback } from 'react';\n\nimport {\n  ErrorCustomMessageReference,\n  CoreResourceOperation,\n  ResourceOperationVariantType,\n} from '@wildo-ai/saas-models';\n\nimport { useOptionalCompositeViewContext } from './CompositeViewContext';\nimport {\n  type EmbeddedResourceOperationTarget,\n  type EmbeddedResourceOperationTargetSelector,\n} from '~wildo-frontend-lib/components/resources/embeds/useEmbeddedResourceContext';\nimport {\n  frontendResourceUtils,\n  FrontendResourceUtils,\n} from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport {\n  pickPreferredOperationForCoreSemantic,\n} from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport {\n  isFrontendOperationAddressableForCurrentContext,\n  pickPreferredOperationForCoreSemanticAddressability,\n  shouldRequireCurrentContextAddressabilityForOperation,\n} from '~wildo-frontend-lib/core/resources/resource-addressability.frontend.utils';\nimport { ScopeUtilsService } from '~wildo-frontend-lib/core/scope/scope.utils.frontend.service';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\nimport type {\n  AnyFrontendResourceConfiguration,\n  FrontendResourceConfiguration_Operation,\n  FrontendResourceOperationContext,\n} from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\n\nexport type CompositeExplicitResourceOperationTarget = EmbeddedResourceOperationTarget\n  & EmbeddedResourceOperationTargetSelector\n  & {\n    resourceType: string;\n    contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];\n  };\n\nexport interface CompositeResourceOperationContextBuilderValue {\n  buildResourceOperationContext: (\n    target: CompositeExplicitResourceOperationTarget,\n  ) => FrontendResourceOperationContext;\n}\n\nfunction buildCompositeResourceOperationBuilderError(\n  message: string,\n  context?: Record<string, unknown>,\n): Error {\n  return FrontendResourceUtils.buildConfigurationError(\n    ErrorCustomMessageReference.CONFIGURATION,\n    {\n      message,\n      component: 'useCompositeResourceOperationContextBuilder',\n      ...context,\n    },\n  );\n}\n\nfunction hasOperationIdentifier(\n  target: EmbeddedResourceOperationTargetSelector,\n): target is Extract<EmbeddedResourceOperationTargetSelector, { operationIdentifier: string }> & {\n  variantType?: ResourceOperationVariantType;\n  variantKey?: string;\n  isOperationDefault?: boolean;\n  isBulkOperation?: boolean;\n} {\n  return 'operationIdentifier' in target;\n}\n\nfunction resolveExplicitOperationForTarget(\n  resourceConfig: AnyFrontendResourceConfiguration,\n  resourceType: string,\n  target: Extract<EmbeddedResourceOperationTargetSelector, { operationIdentifier: string }> & {\n    variantType?: ResourceOperationVariantType;\n    variantKey?: string;\n    isOperationDefault?: boolean;\n    isBulkOperation?: boolean;\n  },\n): FrontendResourceConfiguration_Operation {\n  const matchingOperations = (resourceConfig.operations ?? []).filter((candidate) => {\n    if (String(candidate.operationIdentifier) !== target.operationIdentifier) {\n      return false;\n    }\n    if (target.variantType !== undefined && candidate.variantType !== target.variantType) {\n      return false;\n    }\n    if (target.variantKey !== undefined && candidate.variantKey !== target.variantKey) {\n      return false;\n    }\n    if (target.isOperationDefault !== undefined && candidate.isOperationDefault !== target.isOperationDefault) {\n      return false;\n    }\n    if (target.isBulkOperation !== undefined && candidate.isBulkOperation !== target.isBulkOperation) {\n      return false;\n    }\n    return true;\n  });\n\n  if (matchingOperations.length === 1) {\n    return matchingOperations[0]!;\n  }\n\n  const defaultNonBulkOperations = matchingOperations.filter(\n    (candidate) => candidate.isOperationDefault === true && candidate.isBulkOperation !== true,\n  );\n  if (\n    target.variantKey === undefined\n    && target.variantType === undefined\n    && target.isOperationDefault === undefined\n    && target.isBulkOperation === undefined\n    && defaultNonBulkOperations.length === 1\n  ) {\n    return defaultNonBulkOperations[0]!;\n  }\n\n  throw buildCompositeResourceOperationBuilderError(\n    matchingOperations.length === 0\n      ? `Composite resource-operation builder cannot resolve operation \"${target.operationIdentifier}\" on resource \"${resourceType}\".`\n      : `Composite resource-operation builder found ambiguous operation \"${target.operationIdentifier}\" on resource \"${resourceType}\".`,\n    {\n      resourceType,\n      operationIdentifier: target.operationIdentifier,\n      variantType: target.variantType,\n      variantKey: target.variantKey,\n      isOperationDefault: target.isOperationDefault,\n      isBulkOperation: target.isBulkOperation,\n      candidates: matchingOperations.map((candidate) => ({\n        variantType: candidate.variantType,\n        variantKey: candidate.variantKey,\n        isOperationDefault: candidate.isOperationDefault,\n        isBulkOperation: candidate.isBulkOperation,\n      })),\n    },\n  );\n}\n\nfunction resolveOperationForTarget(\n  resourceConfig: AnyFrontendResourceConfiguration | undefined,\n  resourceType: string,\n  target: EmbeddedResourceOperationTargetSelector,\n  registry: ReturnType<typeof useResourceRegistry>['registry'],\n  contextResourceIdentifiers: FrontendResourceOperationContext['contextResourceIdentifiers'],\n): FrontendResourceConfiguration_Operation {\n  if (!resourceConfig) {\n    throw buildCompositeResourceOperationBuilderError(\n      `Composite resource-operation builder cannot resolve resource \"${resourceType}\" from the registry.`,\n      { resourceType },\n    );\n  }\n\n  if (hasOperationIdentifier(target)) {\n    const operation = resolveExplicitOperationForTarget(resourceConfig, resourceType, target);\n\n    const requiresRuntimeAddressability = shouldRequireCurrentContextAddressabilityForOperation({\n      operation,\n      resourceType,\n      resourceConfig,\n    });\n    if (\n      requiresRuntimeAddressability\n      && operation.isBulkOperation !== true\n      && !isFrontendOperationAddressableForCurrentContext({\n        resourceConfig,\n        operation,\n        registry,\n        hasResourceId: frontendResourceUtils.getResourceId(contextResourceIdentifiers[resourceType]).length > 0,\n        contextResourceIdentifiers,\n        contextualParameters: FrontendResourceUtils.buildContextualParameters(\n          contextResourceIdentifiers,\n          registry,\n        ),\n      })\n    ) {\n      throw buildCompositeResourceOperationBuilderError(\n        `Composite resource-operation builder resolved operation \"${target.operationIdentifier}\" on resource \"${resourceType}\", but it is not addressable in the current context.`,\n        {\n          resourceType,\n          operationIdentifier: target.operationIdentifier,\n        },\n      );\n    }\n\n    return operation;\n  }\n\n  const coreOperation = target.operationLike as CoreResourceOperation;\n  const requiresRuntimeAddressability = coreOperation === CoreResourceOperation.READ\n    || coreOperation === CoreResourceOperation.UPDATE\n    || coreOperation === CoreResourceOperation.DELETE;\n  const semanticOperation = target.requireAddressable || requiresRuntimeAddressability\n    ? pickPreferredOperationForCoreSemanticAddressability({\n      resourceConfig,\n      operations: resourceConfig.operations ?? [],\n      coreOperation,\n      registry,\n      hasResourceId: frontendResourceUtils.getResourceId(contextResourceIdentifiers[resourceType]).length > 0,\n      allowBulk: target.allowBulk,\n      requireFrontendAddressable: true,\n      contextResourceIdentifiers,\n      contextualParameters: FrontendResourceUtils.buildContextualParameters(\n        contextResourceIdentifiers,\n        registry,\n      ),\n    })\n    : pickPreferredOperationForCoreSemantic(\n      resourceConfig.operations ?? [],\n      coreOperation,\n      {\n        requireAddressable: target.requireAddressable,\n        allowBulk: target.allowBulk,\n      },\n    );\n\n  if (!semanticOperation) {\n    throw buildCompositeResourceOperationBuilderError(\n      `Composite resource-operation builder cannot resolve a preferred ${String(target.operationLike)}-like operation on resource \"${resourceType}\".`,\n      {\n        resourceType,\n        operationLike: target.operationLike,\n        requireAddressable: target.requireAddressable,\n        allowBulk: target.allowBulk,\n      },\n    );\n  }\n\n  return semanticOperation;\n}\n\nexport function useCompositeResourceOperationContextBuilder(): CompositeResourceOperationContextBuilderValue {\n  const { registry } = useResourceRegistry();\n  const compositeContext = useOptionalCompositeViewContext();\n  const appScope = useAppScopeSafe();\n\n  const buildResourceOperationContext = useCallback<CompositeResourceOperationContextBuilderValue['buildResourceOperationContext']>((target) => {\n    const resourceConfig = registry.resourceConfigurations[target.resourceType];\n    const explicitContextResourceIdentifiers = target.contextResourceIdentifiers\n      ?? compositeContext?.contextResourceIdentifiers;\n    const flattenedExplicitContextResourceIdentifiers = explicitContextResourceIdentifiers\n      ? FrontendResourceUtils.flattenContextIdentifiers(explicitContextResourceIdentifiers)\n      : undefined;\n    const ambientContextResourceIdentifiers = ScopeUtilsService.mergeContextResourceIdentifiers(\n      undefined,\n      appScope?.buildContextResourceIdentifiers() ?? {},\n      flattenedExplicitContextResourceIdentifiers,\n    ) ?? {};\n\n    const contextResourceIdentifiers = target.resourceId\n      ? {\n          ...ambientContextResourceIdentifiers,\n          [target.resourceType]: target.resourceId,\n        }\n      : ambientContextResourceIdentifiers;\n    const operation = resolveOperationForTarget(\n      resourceConfig,\n      target.resourceType,\n      target,\n      registry,\n      contextResourceIdentifiers,\n    );\n\n    const parentResourcesRequirements = frontendResourceUtils.buildParentResourcesRequirements(\n      target.resourceType,\n      contextResourceIdentifiers,\n      registry,\n      target.relationshipFieldOverrides,\n    );\n\n    return frontendResourceUtils.createFrontendResourceOperationContextFromOperation({\n      resourceType: target.resourceType,\n      operation,\n      contextResourceIdentifiers,\n      additionalContext: target.additionalContext,\n      parentResourcesRequirements,\n    });\n  }, [\n    appScope,\n    compositeContext?.contextResourceIdentifiers,\n    registry,\n  ]);\n\n  return {\n    buildResourceOperationContext,\n  };\n}\n"]}

package/dist/esm/components/views/composite-view/useHostRecordDerivedParentContext.d.ts

@@ -0,0 +1,44 @@
+import type { EmbeddedResourceContextValue } from '../../../components/resources/embeds/useEmbeddedResourceContext';
+/** A parent edge whose id is missing from the URL context: which parent + the FK to read. */
+export interface MissingParentEdge {
+    resourceType: string;
+    foreignKeyField: string;
+}
+/**
+ * Pure core of the derivation: read each missing parent's foreign key off the
+ * host record and emit `{ <parentType>: <fk> }` for every non-empty string FK.
+ * Absent / non-string / empty FKs are skipped (derive-miss → not emitted). Kept
+ * pure + exported so the FK-read semantics are unit-testable without React.
+ */
+export declare function deriveParentIdentifiersFromRecord(record: Record<string, unknown>, missingParentEdges: readonly MissingParentEdge[]): Record<string, string>;
+/**
+ * D2 — parent-context DERIVATION for host-scoped composite embeds.
+ *
+ * A composite is scoped to a HOST record (e.g. a `tasks` workspace). Some embedded
+ * surfaces target a view that requires the host's PARENT (e.g. a `todo-task-status`
+ * chart whose `parentResourcesRequirements` mandate `todos`, or a `task-workspace`
+ * execution anchored on `todoId`). The URL context carries only what the composite
+ * declares (`organizations`, `tasks`, `users`) — NOT the derivable parent (`todos`).
+ * Without the parent id those embeds fail (chart 403 / "No anchor resolved").
+ *
+ * This hook resolves the host record ONCE (its addressable READ) and reads the
+ * host's PARENT foreign keys off it — the parent chain + FK field per parent is the
+ * composite context's own `parentResourcesRequirements` (`{ resourceType,
+ * foreignKeyField }`). For every parent that is (a) NOT already in the URL context
+ * and (b) present as a non-empty FK on the record, it emits `{ <parentType>: <fk> }`.
+ * Callers merge this UNDER the URL context (URL ids always win).
+ *
+ * Derive-miss is graceful: no host id, no missing parents, an unresolved READ, a
+ * record without the FK, or a failed fetch all yield the stable empty map — the
+ * embed then degrades locally (F2) instead of the whole composite breaking.
+ *
+ * Returns the empty map until the record resolves; the embed re-resolves reactively
+ * once the derived parent arrives (same pattern as `onDataLoaded` parentData).
+ */
+export declare function useHostRecordDerivedParentContext(compositeResourceContext: EmbeddedResourceContextValue): Record<string, string>;
+/**
+ * Merge derived parent ids UNDER the flattened URL context — URL-supplied ids
+ * always win over derived ones. Returns the input untouched when nothing derived.
+ */
+export declare function mergeDerivedParentIdentifiers(flattenedContextIdentifiers: Record<string, string>, derivedParents: Record<string, string>): Record<string, string>;
+//# sourceMappingURL=useHostRecordDerivedParentContext.d.ts.map

package/dist/esm/components/views/composite-view/useHostRecordDerivedParentContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHostRecordDerivedParentContext.d.ts","sourceRoot":"","sources":["../../../../../../src/components/views/composite-view/useHostRecordDerivedParentContext.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,4EAA4E,CAAC;AAQ/H,6FAA6F;AAC7F,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,kBAAkB,EAAE,SAAS,iBAAiB,EAAE,GAC/C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASxB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,iCAAiC,CAC/C,wBAAwB,EAAE,4BAA4B,GACrD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgGxB;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGxB"}