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

package/dist/esm/core/config/execution-view.schemas.js

@@ -1,7 +1,9 @@
 import { z } from 'zod';
-import { CoreResourceOperation, ResourcePrimaryScope, RequiredFeaturesConfigSchema, } from '@wildo-ai/saas-models';
-import { FrontendView_DefinitionSchema, FrontendView_ScopeMode, } from './views-frontend.schemas.js';
+import { InsertedViewLauncherConfigSchema, } from '../../core/config/inserted-view-launcher.schemas.js';
+import { ResourcePrimaryScope, ResourceTypeSchema, RequiredFeaturesConfigSchema, } from '@wildo-ai/saas-models';
+import { FrontendView_ScopeMode, } from './views-frontend.schemas.js';
 import { FrontendInsertedViewHostKind, FrontendInsertedViewKind, createFrontendInsertedViewIdentity, parseFrontendInsertedViewRef, } from './inserted-view.frontend.schemas.js';
+import { FrontendResource_ParentResourceRequirementSchema, } from '../../core/resources/resource-path.frontend.schemas.js';
 //===============================================================
 //  ExecutionView
 // --------
@@ -9,6 +11,11 @@ import { FrontendInsertedViewHostKind, FrontendInsertedViewKind, createFrontendI
 // Phase A1 intentionally keeps this contract thin: it only declares
 // the routed/configurable host-family shape, not the richer runtime DSL.
 //===============================================================
+/**
+ * @wildo_source:part:start saas.frontend.execution-view.participation-and-anchor facet:layer:frontend facet:family:execution-view
+ *
+ * Execution view anchors, participation sources, and navigation policy enums/schemas.
+ */
 export var ExecutionViewAnchorBindingSource;
 (function (ExecutionViewAnchorBindingSource) {
     ExecutionViewAnchorBindingSource["PARENT_RESOURCE_REQUIREMENT"] = "parent-resource-requirement";
@@ -24,14 +31,127 @@ export const ExecutionViewAnchorDefinitionSchema = z.object({
     bindingKey: z.string().min(1),
     source: z.enum(ExecutionViewAnchorBindingSource),
 });
-export const ExecutionViewDefinitionSchema = z.intersection(FrontendView_DefinitionSchema, z.object({
-    /** Unique view reference (used in URL: /execution/:viewRef once routing is wired) */
+export var ExecutionParticipationSource;
+(function (ExecutionParticipationSource) {
+    ExecutionParticipationSource["ANCHOR"] = "anchor";
+    ExecutionParticipationSource["PARENT_RESOURCE_REQUIREMENT"] = "parent-resource-requirement";
+    ExecutionParticipationSource["ADDITIONAL_RESOURCE_REQUIREMENT"] = "additional-resource-requirement";
+    ExecutionParticipationSource["RELATIONSHIP_PROJECTION"] = "relationship-projection";
+})(ExecutionParticipationSource || (ExecutionParticipationSource = {}));
+const ExecutionParticipationAnchorDefinitionSchema = z.object({
+    source: z.literal(ExecutionParticipationSource.ANCHOR),
+});
+const ExecutionParticipationParentRequirementDefinitionSchema = z.object({
+    source: z.literal(ExecutionParticipationSource.PARENT_RESOURCE_REQUIREMENT),
+    bindingKey: z.string().min(1),
+});
+const ExecutionParticipationAdditionalRequirementDefinitionSchema = z.object({
+    source: z.literal(ExecutionParticipationSource.ADDITIONAL_RESOURCE_REQUIREMENT),
+    bindingKey: z.string().min(1),
+});
+const ExecutionParticipationRelationshipProjectionDefinitionSchema = z.object({
+    source: z.literal(ExecutionParticipationSource.RELATIONSHIP_PROJECTION),
+    fromParticipationRef: z.string().min(1),
+    targetResourceType: ResourceTypeSchema,
+    foreignKeyField: z.string().min(1).optional(),
+});
+/**
+ * Authored execution participation contracts stay intentionally small.
+ *
+ * They identify one framework-native resolution source, but they do not
+ * duplicate derived relationship semantics, cardinality, or transport field
+ * mapping. Those details are resolved later from the existing registry and
+ * shared relationship helpers.
+ */
+export const ExecutionParticipationDefinitionSchema = z.discriminatedUnion('source', [
+    ExecutionParticipationAnchorDefinitionSchema,
+    ExecutionParticipationParentRequirementDefinitionSchema,
+    ExecutionParticipationAdditionalRequirementDefinitionSchema,
+    ExecutionParticipationRelationshipProjectionDefinitionSchema,
+]);
+/**
+ * @wildo_source:part:start saas.frontend.execution-view.navigation-handling-and-embedding facet:layer:frontend facet:family:execution-view
+ *
+ * Execution navigation handling & embedding principle.
+ *
+ * An execution view has exactly two ways to move the user toward a downstream
+ * resource operation surface:
+ *
+ * 1. **`EMBED_LOCALLY`** — the execution shell mounts the resulting surface
+ *    *inside itself* as locally embedded content. A single embedded-content
+ *    slot is owned by the execution runtime; opening a new embed replaces the
+ *    current one.
+ * 2. **`DELEGATE_TO_ROUTER`** — the execution view yields control to the app
+ *    router (the "parent" navigation stack). The surface is rendered by the
+ *    router's navigation zones, not by the execution shell.
+ *
+ * Invariants that make this a principle, not a convenience:
+ *
+ * - **Provenance is preserved either way.** Whether delegated or embedded, the
+ *   target surface receives the same `NavigationInitiatorContext`
+ *   (`sourceZone`, `launcher`, `sourceOperation`, `sourceRelationship`). An
+ *   embedded read surface of a parent todo must behave indistinguishably from
+ *   a routed read surface of that same todo.
+ * - **Transport is untouched.** Embedding only changes *where* the resulting
+ *   surface mounts. `doOperation()` remains the read/orchestration transport;
+ *   the Resource Mutation Manager remains the mutation runtime.
+ * - **Resource-exclusive.** Only `NavigationContent.RESOURCE_OPERATION` is
+ *   embeddable today — not arbitrary React content. See
+ *   `ExecutionEmbeddableContent`.
+ * - **Authored default, per-call override.** `ExecutionNavigationPolicyDefinition`
+ *   on the view authors the default handling mode; action verbs on
+ *   `execution.actions.operation(...)` can override per call (`embed()`,
+ *   `navigate()`, `navigateToRead()`).
+ * - **One owner of the shell.** The `ExecutionView` component owns rendering
+ *   of the embedded-content slot (including the close affordance). Consumers
+ *   do not reinvent the shell.
+ */
+export var ExecutionNavigationHandlingMode;
+(function (ExecutionNavigationHandlingMode) {
+    /** The execution shell mounts the resulting surface inside itself. */
+    ExecutionNavigationHandlingMode["EMBED_LOCALLY"] = "embed-locally";
+    /** The execution view yields to the app router ("parent" navigation stack). */
+    ExecutionNavigationHandlingMode["DELEGATE_TO_ROUTER"] = "delegate-to-router";
+})(ExecutionNavigationHandlingMode || (ExecutionNavigationHandlingMode = {}));
+export const ExecutionConcreteOperationIdentitySchema = z.union([
+    z.string().min(1),
+    z.tuple([z.string().min(1), z.string().min(1)]),
+]);
+export const ExecutionNavigationPolicyExceptionRuleSchema = z.object({
+    resourceType: ResourceTypeSchema,
+    operation: ExecutionConcreteOperationIdentitySchema,
+    handlingMode: z.enum(ExecutionNavigationHandlingMode),
+});
+export const ExecutionNavigationPolicyDefinitionSchema = z.object({
+    defaultHandlingMode: z.enum(ExecutionNavigationHandlingMode)
+        .default(ExecutionNavigationHandlingMode.DELEGATE_TO_ROUTER),
+    operationHandlingExceptions: ExecutionNavigationPolicyExceptionRuleSchema.array().optional(),
+});
+/** @wildo_source:part:end saas.frontend.execution-view.navigation-handling-and-embedding */
+/**
+ * @wildo_source:part:start saas.frontend.execution-view.definition facet:layer:frontend facet:family:execution-view
+ *
+ * Resource-owned execution view: `surfaceInOperations` keys, Zod + TS `ExecutionViewDefinition`,
+ * authoring config, and `resourceExecutionView()` helper.
+ */
+export const ExecutionSurfaceInOperationSchema = ExecutionConcreteOperationIdentitySchema;
+export const ExecutionViewDefinitionSchema = z.object({
+    /**
+     * Execution views are resource-owned inserted surfaces.
+     *
+     * There is no app-level execution-view authoring contract. Keeping the
+     * literal here makes the semantic boundary explicit at schema level instead
+     * of relying on downstream consumer checks to reject application-scoped
+     * declarations.
+     */
+    scope: z.literal(FrontendView_ScopeMode.RESOURCE),
+    parentResourcesRequirements: FrontendResource_ParentResourceRequirementSchema.array().optional(),
+    additionalResourceRequirements: FrontendResource_ParentResourceRequirementSchema.array().optional(),
+    /** Unique view reference inside the owning resource's executionViews map. */
     ref: z.string().min(1),
-    /** Whether this view can be accessed via URL */
+    /** Whether this resource-owned execution surface can be addressed via URL. */
     isAddressable: z.boolean().default(false),
-    /** Operation-like behavior for navigation purposes */
-    operationLike: z.enum(CoreResourceOperation).default(CoreResourceOperation.READ),
-    /** Primary scope for context injection */
+    /** Primary scope for context injection. */
     primaryScope: z.enum(ResourcePrimaryScope).default(ResourcePrimaryScope.ORGANIZATIONS),
     /**
      * Optional declarative anchor contract.
@@ -41,15 +161,44 @@ export const ExecutionViewDefinitionSchema = z.intersection(FrontendView_Definit
      * context bindings.
      */
     anchor: ExecutionViewAnchorDefinitionSchema.optional(),
+    navigationPolicy: ExecutionNavigationPolicyDefinitionSchema.optional(),
     /**
-     * Direct authored execution view component.
+     * Direct authored execution renderer component.
      *
-     * App-authored execution views link directly to the React component.
+     * Execution remains custom-renderer-first, but the owning declaration is
+     * resource-bound rather than app-global.
      */
+    surfaceInOperations: z.array(ExecutionSurfaceInOperationSchema).optional(),
+    participations: z.record(z.string(), ExecutionParticipationDefinitionSchema).optional(),
     viewComponent: z.any(),
-    /** Required features for this view — gates navigation + route access via feature availability policy */
+    /**
+     * How and where this view's launcher is presented on the host record page.
+     * Omitted → framework default (a labelled button in the record's action
+     * cluster). See {@link InsertedViewLauncherConfig}.
+     */
+    launcher: InsertedViewLauncherConfigSchema.optional(),
+    /**
+     * Optional view-local i18n label declarations (label refs + interpolation
+     * params) for a CUSTOM execution renderer. The labelling pipeline generates
+     * `views.execution.resources.<resourceType>.<ref>.<labelRef>` from these so the
+     * renderer resolves its own captions via `tView(...)` — beyond the framework's
+     * baseline title/description. Item shape is `LabellingMessageDef`; kept
+     * permissive here (like `viewComponent`) since it is authored, not user input.
+     */
+    labels: z.array(z.any()).optional(),
+    /** Required features for this view — gates navigation + route access via feature availability policy. */
     requiredFeatures: RequiredFeaturesConfigSchema.optional(),
-}));
+    /**
+     * View icon — lucide component reference (not `<JSX />`) or a
+     * StandardIconReference string. Surfaces on the embedded launcher button
+     * inside the host operation view (and any launcher targeting this view);
+     * without it those buttons render the generic fallback icon. Registered by
+     * the `IconRegistryBridge` under the `view-execution-{ref}` custom-icon key.
+     * Declared in the schema AND the interface — schema-unknown keys are
+     * stripped wherever the definition is Zod-parsed.
+     */
+    icon: z.custom().optional(),
+});
 export const EXECUTION_ROUTE_CONTEXT_QUERY_PARAM_PREFIX = 'execution_ctx_';
 /**
  * Small authoring helper for resource-owned execution views.
@@ -64,10 +213,71 @@ export function resourceExecutionView(viewComponent, config = {}) {
         viewComponent,
     };
 }
-export function isStandaloneRoutableExecutionView(executionView) {
-    return executionView?.isAddressable === true;
+/** @wildo_source:part:end saas.frontend.execution-view.definition */
+export function serializeSurfaceOperation(operation) {
+    if (typeof operation === 'string') {
+        return operation;
+    }
+    return `${operation[0]}::${operation[1]}`;
+}
+/**
+ * Derive compiled operation-linked refs from execution view declarations.
+ *
+ * Returns a map whose keys are serialized operation keys (`"READ"` or
+ * `"customOp::variant"`) and whose values are the execution-view refs that
+ * surface into that operation. Callers merge this map with the equivalents
+ * for composite and chart views (see {@link collectOperationLikeViewRefs})
+ * to build the per-operation linked view refs map exposed by the
+ * specification layer. There is no runtime compiled `additionalViews` —
+ * `ResourceLayout_InsertedViews` filters execution views directly at render time.
+ */
+export function collectExecutionViewSurfaceRefsByOperation(views) {
+    const result = new Map();
+    if (!views) {
+        return result;
+    }
+    const viewEntries = Array.isArray(views)
+        ? views.map((view) => [view.ref ?? '', view])
+        : Object.entries(views);
+    for (const [ref, view] of viewEntries) {
+        if (!ref) {
+            continue;
+        }
+        for (const operation of view.surfaceInOperations ?? []) {
+            const key = serializeSurfaceOperation(operation);
+            const existingRefs = result.get(key) ?? [];
+            result.set(key, [...existingRefs, ref]);
+        }
+    }
+    return result;
 }
-export function isStandaloneRoutableInsertedExecutionView(executionView) {
+/**
+ * Collect view refs grouped by serialized operation key from view families
+ * that declare a **single** `operationLike` (composite + chart views).
+ *
+ * `fallbackOperation` is used when the view does not declare `operationLike`
+ * explicitly — composite and chart views default to `READ` at compile time,
+ * but the fallback is passed by the caller so this helper stays family-agnostic.
+ */
+export function collectOperationLikeViewRefs(views, fallbackOperation) {
+    const result = new Map();
+    if (!views) {
+        return result;
+    }
+    const viewEntries = Array.isArray(views)
+        ? views.map((view) => [view.ref ?? '', view])
+        : Object.entries(views);
+    for (const [ref, view] of viewEntries) {
+        if (!ref) {
+            continue;
+        }
+        const key = serializeSurfaceOperation(view.operationLike ?? fallbackOperation);
+        const existingRefs = result.get(key) ?? [];
+        result.set(key, [...existingRefs, ref]);
+    }
+    return result;
+}
+export function isStandaloneRoutableExecutionView(executionView) {
     return (executionView?.isAddressable === true
         && executionView.scope === FrontendView_ScopeMode.RESOURCE);
 }
@@ -95,6 +305,42 @@ export function resolveExecutionViewDefinition(params) {
         ?.executionViews
         ?.find((candidate) => candidate.ref === insertedIdentity.localRef);
 }
+export function buildExecutionConcreteOperationIdentity(operation) {
+    const operationIdentifier = String(operation.operationIdentifier);
+    return operation.variantKey && operation.isOperationDefault !== true
+        ? [operationIdentifier, operation.variantKey]
+        : operationIdentifier;
+}
+export function matchesExecutionConcreteOperationIdentity(expected, actual) {
+    if (Array.isArray(expected) && Array.isArray(actual)) {
+        return expected[0] === actual[0] && expected[1] === actual[1];
+    }
+    return !Array.isArray(expected) && !Array.isArray(actual) && expected === actual;
+}
+/**
+ * @wildo_source:part:start saas.frontend.execution-view.navigation-handling-and-embedding.resolution facet:layer:frontend facet:family:execution-view
+ *
+ * Resolve the navigation handling mode for a single operation on an execution
+ * view. Applies the authored default first, then overrides with a matching
+ * `operationHandlingExceptions` entry if one is declared. This is the
+ * canonical decision point used by `execution.actions.operation(...).navigate()`
+ * to pick between embedding and router delegation.
+ *
+ * Companion span to the principle anchor
+ * `saas.frontend.execution-view.navigation-handling-and-embedding` (above
+ * — the policy enum + schema). Split into a dedicated `.resolution` anchor
+ * so the principle and its runtime resolver can be referenced
+ * independently in documentation.
+ */
+export function resolveExecutionNavigationHandlingMode(params) {
+    const defaultHandlingMode = params.viewDefinition.navigationPolicy?.defaultHandlingMode
+        ?? ExecutionNavigationHandlingMode.DELEGATE_TO_ROUTER;
+    const operationIdentity = buildExecutionConcreteOperationIdentity(params.operation);
+    const exception = params.viewDefinition.navigationPolicy?.operationHandlingExceptions?.find((candidate) => (candidate.resourceType === params.resourceType
+        && matchesExecutionConcreteOperationIdentity(candidate.operation, operationIdentity)));
+    return exception?.handlingMode ?? defaultHandlingMode;
+}
+/** @wildo_source:part:end saas.frontend.execution-view.navigation-handling-and-embedding.resolution */
 export function buildExecutionRouteUrlPath(viewRef, contextResourceIdentifiers) {
     const params = new URLSearchParams();
     for (const [key, value] of Object.entries(contextResourceIdentifiers ?? {})) {
@@ -116,4 +362,4 @@ export function extractExecutionRouteContextResourceIdentifiers(searchParams) {
     }
     return Object.keys(contextResourceIdentifiers).length > 0 ? contextResourceIdentifiers : undefined;
 }
-//# sourceMappingURL=execution-view.schemas.js.map
+//# sourceMappingURL=execution-view.schemas.js.map

package/dist/esm/core/config/execution-view.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"execution-view.schemas.js","sourceRoot":"","sources":["../../../../src/core/config/execution-view.schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"execution-view.schemas.js","sourceRoot":"","sources":["../../../../../src/core/config/execution-view.schemas.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,gCAAgC,GAEjC,MAAM,gEAAgE,CAAC;AAExE,OAAO,EAEL,oBAAoB,EACpB,kBAAkB,EAClB,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EACL,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,kCAAkC,EAClC,4BAA4B,GAE7B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,gDAAgD,GACjD,MAAM,mEAAmE,CAAC;AAQ3E,iEAAiE;AACjE,iBAAiB;AACjB,WAAW;AACX,kEAAkE;AAClE,oEAAoE;AACpE,yEAAyE;AACzE,iEAAiE;AAEjE;;;;GAIG;AACH,MAAM,CAAN,IAAY,gCAGX;AAHD,WAAY,gCAAgC;IAC1C,+FAA2D,CAAA;IAC3D,uGAAmE,CAAA;AACrE,CAAC,EAHW,gCAAgC,KAAhC,gCAAgC,QAG3C;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,gCAAgC,CAAC;CACjD,CAAC,CAAC;AAOH,MAAM,CAAN,IAAY,4BAKX;AALD,WAAY,4BAA4B;IACtC,iDAAiB,CAAA;IACjB,2FAA2D,CAAA;IAC3D,mGAAmE,CAAA;IACnE,mFAAmD,CAAA;AACrD,CAAC,EALW,4BAA4B,KAA5B,4BAA4B,QAKvC;AAED,MAAM,4CAA4C,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5D,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,4BAA4B,CAAC,MAAM,CAAC;CACvD,CAAC,CAAC;AAEH,MAAM,uDAAuD,GAAG,CAAC,CAAC,MAAM,CAAC;IACvE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,4BAA4B,CAAC,2BAA2B,CAAC;IAC3E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC9B,CAAC,CAAC;AAEH,MAAM,2DAA2D,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3E,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,4BAA4B,CAAC,+BAA+B,CAAC;IAC/E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC9B,CAAC,CAAC;AAEH,MAAM,4DAA4D,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5E,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,4BAA4B,CAAC,uBAAuB,CAAC;IACvE,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvC,kBAAkB,EAAE,kBAAkB;IACtC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC9C,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAC,CAAC,kBAAkB,CAAC,QAAQ,EAAE;IACnF,4CAA4C;IAC5C,uDAAuD;IACvD,2DAA2D;IAC3D,4DAA4D;CAC7D,CAAC,CAAC;AAWH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,CAAN,IAAY,+BAKX;AALD,WAAY,+BAA+B;IACzC,sEAAsE;IACtE,kEAA+B,CAAA;IAC/B,+EAA+E;IAC/E,4EAAyC,CAAA;AAC3C,CAAC,EALW,+BAA+B,KAA/B,+BAA+B,QAK1C;AAED,MAAM,CAAC,MAAM,wCAAwC,GAAG,CAAC,CAAC,KAAK,CAAC;IAC9D,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;CAChD,CAAC,CAAC;AAeH,MAAM,CAAC,MAAM,4CAA4C,GAAG,CAAC,CAAC,MAAM,CAAC;IACnE,YAAY,EAAE,kBAAkB;IAChC,SAAS,EAAE,wCAAwC;IACnD,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,+BAA+B,CAAC;CACtD,CAAC,CAAC;AAeH,MAAM,CAAC,MAAM,yCAAyC,GAAG,CAAC,CAAC,MAAM,CAAC;IAChE,mBAAmB,EAAE,CAAC,CAAC,IAAI,CAAC,+BAA+B,CAAC;SACzD,OAAO,CAAC,+BAA+B,CAAC,kBAAkB,CAAC;IAC9D,2BAA2B,EAAE,4CAA4C,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;CAC7F,CAAC,CAAC;AACH,4FAA4F;AAE5F;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,wCAAwC,CAAC;AAG1F,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD;;;;;;;OAOG;IACH,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC,QAAQ,CAAC;IACjD,2BAA2B,EAAE,gDAAgD,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;IAChG,8BAA8B,EAAE,gDAAgD,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;IAEnG,6EAA6E;IAC7E,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAEtB,8EAA8E;IAC9E,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAEzC,2CAA2C;IAC3C,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC,aAAa,CAAC;IAEtF;;;;;;OAMG;IACH,MAAM,EAAE,mCAAmC,CAAC,QAAQ,EAAE;IACtD,gBAAgB,EAAE,yCAAyC,CAAC,QAAQ,EAAE;IAEtE;;;;;OAKG;IACH,mBAAmB,EAAE,CAAC,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC,QAAQ,EAAE;IAC1E,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,sCAAsC,CAAC,CAAC,QAAQ,EAAE;IACvF,aAAa,EAAE,CAAC,CAAC,GAAG,EAAE;IAEtB;;;;OAIG;IACH,QAAQ,EAAE,gCAAgC,CAAC,QAAQ,EAAE;IAErD;;;;;;;OAOG;IACH,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;IAEnC,yGAAyG;IACzG,gBAAgB,EAAE,4BAA4B,CAAC,QAAQ,EAAE;IAEzD;;;;;;;;OAQG;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAY,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC;AAyCH,MAAM,CAAC,MAAM,0CAA0C,GAAG,gBAAgB,CAAC;AAwB3E;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,aAA+D,EAC/D,SAAsE,EAAE;IAExE,OAAO;QACL,GAAG,MAAM;QACT,aAAa;KACd,CAAC;AACJ,CAAC;AACD,qEAAqE;AAErE,MAAM,UAAU,yBAAyB,CACvC,SAAsC;IAEtC,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5C,CAAC;AAcD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,0CAA0C,CAGxD,KAAkD;IAElD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC3C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACtC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,EAAE,IAAI,CAAU,CAAC;QACtD,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAE1B,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,WAAW,EAAE,CAAC;QACtC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,SAAS;QACX,CAAC;QAED,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,mBAAmB,IAAI,EAAE,EAAE,CAAC;YACvD,MAAM,GAAG,GAAG,yBAAyB,CAAC,SAAS,CAAC,CAAC;YACjD,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YAC3C,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,YAAY,EAAE,GAAG,CAAC,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAYD;;;;;;;GAOG;AACH,MAAM,UAAU,4BAA4B,CAC1C,KAAkD,EAClD,iBAAwC;IAExC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC3C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACtC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,EAAE,IAAI,CAAU,CAAC;QACtD,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAE1B,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,WAAW,EAAE,CAAC;QACtC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,SAAS;QACX,CAAC;QAED,MAAM,GAAG,GAAG,yBAAyB,CAAC,IAAI,CAAC,aAAa,IAAI,iBAAiB,CAAC,CAAC;QAC/E,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,YAAY,EAAE,GAAG,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,aAAkD;IAElD,OAAO,CACL,aAAa,EAAE,aAAa,KAAK,IAAI;WAClC,aAAa,CAAC,KAAK,KAAK,sBAAsB,CAAC,QAAQ,CAC3D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sCAAsC,CACpD,YAAoB,EACpB,aAAmD;IAEnD,OAAO,kCAAkC,CAAC;QACxC,QAAQ,EAAE,4BAA4B,CAAC,QAAQ;QAC/C,OAAO,EAAE,YAAY;QACrB,QAAQ,EAAE,wBAAwB,CAAC,cAAc;QACjD,QAAQ,EAAE,aAAa,CAAC,GAAG;KAC5B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,MAG9C;IACC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IACrC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,gBAAgB,GAAG,4BAA4B,CAAC,OAAO,CAAC,CAAC;IAC/D,IACE,CAAC,gBAAgB;WACd,gBAAgB,CAAC,QAAQ,KAAK,4BAA4B,CAAC,QAAQ;WACnE,gBAAgB,CAAC,QAAQ,KAAK,wBAAwB,CAAC,cAAc,EACxE,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,QAAQ,EAAE,sBAAsB,CAAC,gBAAgB,CAAC,OAAO,CAAC;QAC/D,EAAE,qBAAqB;QACvB,EAAE,cAAc;QAChB,EAAE,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,KAAK,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,uCAAuC,CACrD,SAGC;IAED,MAAM,mBAAmB,GAAG,MAAM,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;IAElE,OAAO,SAAS,CAAC,UAAU,IAAI,SAAS,CAAC,kBAAkB,KAAK,IAAI;QAClE,CAAC,CAAC,CAAC,mBAAmB,EAAE,SAAS,CAAC,UAAU,CAAC;QAC7C,CAAC,CAAC,mBAAmB,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,yCAAyC,CACvD,QAAsB,EACtB,MAAoB;IAEpB,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACrD,OAAO,QAAQ,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,QAAQ,KAAK,MAAM,CAAC;AACnF,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,sCAAsC,CAAC,MAOtD;IACC,MAAM,mBAAmB,GAAG,MAAM,CAAC,cAAc,CAAC,gBAAgB,EAAE,mBAAmB;WAClF,+BAA+B,CAAC,kBAAkB,CAAC;IACxD,MAAM,iBAAiB,GAAG,uCAAuC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpF,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,gBAAgB,EAAE,2BAA2B,EAAE,IAAI,CACzF,CAAC,SAAS,EAAE,EAAE,CAAC,CACb,SAAS,CAAC,YAAY,KAAK,MAAM,CAAC,YAAY;WAC3C,yCAAyC,CAAC,SAAS,CAAC,SAAS,EAAE,iBAAiB,CAAC,CACrF,CACF,CAAC;IAEF,OAAO,SAAS,EAAE,YAAY,IAAI,mBAAmB,CAAC;AACxD,CAAC;AACD,uGAAuG;AAEvG,MAAM,UAAU,0BAA0B,CACxC,OAAe,EACf,0BAAmD;IAEnD,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,0BAA0B,IAAI,EAAE,CAAC,EAAE,CAAC;QAC5E,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,SAAS;QACX,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,GAAG,0CAA0C,GAAG,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IACjC,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,OAAO,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,cAAc,OAAO,EAAE,CAAC;AACzF,CAAC;AAED,MAAM,UAAU,+CAA+C,CAC7D,YAA6B;IAE7B,MAAM,0BAA0B,GAA2B,EAAE,CAAC;IAE9D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC;QAClD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,0CAA0C,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAC1E,SAAS;QACX,CAAC;QACD,0BAA0B,CAAC,GAAG,CAAC,KAAK,CAAC,0CAA0C,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC;IACnG,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,SAAS,CAAC;AACrG,CAAC","sourcesContent":["import type React from 'react';\nimport { z } from 'zod';\nimport {\n  InsertedViewLauncherConfigSchema,\n  type InsertedViewLauncherConfig,\n} from '~wildo-frontend-lib/core/config/inserted-view-launcher.schemas';\n\nimport {\n  CoreResourceOperation,\n  ResourcePrimaryScope,\n  ResourceTypeSchema,\n  RequiredFeaturesConfigSchema,\n} from '@wildo-ai/saas-models';\nimport type { RequiredFeaturesConfig } from '@wildo-ai/saas-models';\nimport type { LabellingMessageDef } from '@wildo-ai/presets-components-models';\nimport type { IconLike } from '@wildo-ai/zod-decorators';\nimport {\n  FrontendView_ScopeMode,\n} from './views-frontend.schemas';\nimport {\n  FrontendInsertedViewHostKind,\n  FrontendInsertedViewKind,\n  createFrontendInsertedViewIdentity,\n  parseFrontendInsertedViewRef,\n  type FrontendInsertedViewIdentity,\n} from './inserted-view.frontend.schemas';\nimport {\n  FrontendResource_ParentResourceRequirementSchema,\n} from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\nimport type { FrontendResource_ParentResourceRequirement } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\nimport type {\n  FrontendResourceConfiguration_Operation,\n  FrontendResourcesRegistry,\n  OperationKey,\n} from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\n\n//===============================================================\n//  ExecutionView\n// --------\n// A first-class frontend view family for rich execution surfaces.\n// Phase A1 intentionally keeps this contract thin: it only declares\n// the routed/configurable host-family shape, not the richer runtime DSL.\n//===============================================================\n\n/**\n * @wildo_source:part:start saas.frontend.execution-view.participation-and-anchor facet:layer:frontend facet:family:execution-view\n *\n * Execution view anchors, participation sources, and navigation policy enums/schemas.\n */\nexport enum ExecutionViewAnchorBindingSource {\n  PARENT_RESOURCE_REQUIREMENT = 'parent-resource-requirement',\n  ADDITIONAL_RESOURCE_REQUIREMENT = 'additional-resource-requirement',\n}\n\n/**\n * Declarative anchor contract for execution views.\n *\n * The anchor must point to one stable declared binding key instead of relying on\n * requirement-array ordering or \"first matching requirement\" inference.\n */\nexport const ExecutionViewAnchorDefinitionSchema = z.object({\n  bindingKey: z.string().min(1),\n  source: z.enum(ExecutionViewAnchorBindingSource),\n});\n\nexport interface ExecutionViewAnchorDefinition {\n  bindingKey: string;\n  source: ExecutionViewAnchorBindingSource;\n}\n\nexport enum ExecutionParticipationSource {\n  ANCHOR = 'anchor',\n  PARENT_RESOURCE_REQUIREMENT = 'parent-resource-requirement',\n  ADDITIONAL_RESOURCE_REQUIREMENT = 'additional-resource-requirement',\n  RELATIONSHIP_PROJECTION = 'relationship-projection',\n}\n\nconst ExecutionParticipationAnchorDefinitionSchema = z.object({\n  source: z.literal(ExecutionParticipationSource.ANCHOR),\n});\n\nconst ExecutionParticipationParentRequirementDefinitionSchema = z.object({\n  source: z.literal(ExecutionParticipationSource.PARENT_RESOURCE_REQUIREMENT),\n  bindingKey: z.string().min(1),\n});\n\nconst ExecutionParticipationAdditionalRequirementDefinitionSchema = z.object({\n  source: z.literal(ExecutionParticipationSource.ADDITIONAL_RESOURCE_REQUIREMENT),\n  bindingKey: z.string().min(1),\n});\n\nconst ExecutionParticipationRelationshipProjectionDefinitionSchema = z.object({\n  source: z.literal(ExecutionParticipationSource.RELATIONSHIP_PROJECTION),\n  fromParticipationRef: z.string().min(1),\n  targetResourceType: ResourceTypeSchema,\n  foreignKeyField: z.string().min(1).optional(),\n});\n\n/**\n * Authored execution participation contracts stay intentionally small.\n *\n * They identify one framework-native resolution source, but they do not\n * duplicate derived relationship semantics, cardinality, or transport field\n * mapping. Those details are resolved later from the existing registry and\n * shared relationship helpers.\n */\nexport const ExecutionParticipationDefinitionSchema = z.discriminatedUnion('source', [\n  ExecutionParticipationAnchorDefinitionSchema,\n  ExecutionParticipationParentRequirementDefinitionSchema,\n  ExecutionParticipationAdditionalRequirementDefinitionSchema,\n  ExecutionParticipationRelationshipProjectionDefinitionSchema,\n]);\n\nexport type ExecutionParticipationDefinition = z.infer<typeof ExecutionParticipationDefinitionSchema>;\n/** @wildo_source:part:end saas.frontend.execution-view.participation-and-anchor */\n\nexport interface ExecutionViewComponentProps {\n  viewRef: string;\n  viewDefinition: ExecutionViewDefinition;\n  contextResourceIdentifiers: Record<string, string>;\n}\n\n/**\n * @wildo_source:part:start saas.frontend.execution-view.navigation-handling-and-embedding facet:layer:frontend facet:family:execution-view\n *\n * Execution navigation handling & embedding principle.\n *\n * An execution view has exactly two ways to move the user toward a downstream\n * resource operation surface:\n *\n * 1. **`EMBED_LOCALLY`** — the execution shell mounts the resulting surface\n *    *inside itself* as locally embedded content. A single embedded-content\n *    slot is owned by the execution runtime; opening a new embed replaces the\n *    current one.\n * 2. **`DELEGATE_TO_ROUTER`** — the execution view yields control to the app\n *    router (the \"parent\" navigation stack). The surface is rendered by the\n *    router's navigation zones, not by the execution shell.\n *\n * Invariants that make this a principle, not a convenience:\n *\n * - **Provenance is preserved either way.** Whether delegated or embedded, the\n *   target surface receives the same `NavigationInitiatorContext`\n *   (`sourceZone`, `launcher`, `sourceOperation`, `sourceRelationship`). An\n *   embedded read surface of a parent todo must behave indistinguishably from\n *   a routed read surface of that same todo.\n * - **Transport is untouched.** Embedding only changes *where* the resulting\n *   surface mounts. `doOperation()` remains the read/orchestration transport;\n *   the Resource Mutation Manager remains the mutation runtime.\n * - **Resource-exclusive.** Only `NavigationContent.RESOURCE_OPERATION` is\n *   embeddable today — not arbitrary React content. See\n *   `ExecutionEmbeddableContent`.\n * - **Authored default, per-call override.** `ExecutionNavigationPolicyDefinition`\n *   on the view authors the default handling mode; action verbs on\n *   `execution.actions.operation(...)` can override per call (`embed()`,\n *   `navigate()`, `navigateToRead()`).\n * - **One owner of the shell.** The `ExecutionView` component owns rendering\n *   of the embedded-content slot (including the close affordance). Consumers\n *   do not reinvent the shell.\n */\nexport enum ExecutionNavigationHandlingMode {\n  /** The execution shell mounts the resulting surface inside itself. */\n  EMBED_LOCALLY = 'embed-locally',\n  /** The execution view yields to the app router (\"parent\" navigation stack). */\n  DELEGATE_TO_ROUTER = 'delegate-to-router',\n}\n\nexport const ExecutionConcreteOperationIdentitySchema = z.union([\n  z.string().min(1),\n  z.tuple([z.string().min(1), z.string().min(1)]),\n]);\n\n/**\n * Per-operation override of the default navigation handling mode.\n *\n * Matches against a concrete resource operation (resource type + operation\n * key, including variants) and replaces the policy's default handling mode\n * for that single operation.\n */\nexport interface ExecutionNavigationPolicyExceptionRule {\n  resourceType: string;\n  operation: OperationKey;\n  handlingMode: ExecutionNavigationHandlingMode;\n}\n\nexport const ExecutionNavigationPolicyExceptionRuleSchema = z.object({\n  resourceType: ResourceTypeSchema,\n  operation: ExecutionConcreteOperationIdentitySchema,\n  handlingMode: z.enum(ExecutionNavigationHandlingMode),\n});\n\n/**\n * Declarative navigation handling policy attached to an execution view.\n *\n * `defaultHandlingMode` governs every operation the view reaches via its\n * action verbs unless an `operationHandlingExceptions` entry matches. A view\n * that does not declare a policy delegates to the router by default, which\n * preserves the pre-embedding behavior.\n */\nexport interface ExecutionNavigationPolicyDefinition {\n  defaultHandlingMode: ExecutionNavigationHandlingMode;\n  operationHandlingExceptions?: ExecutionNavigationPolicyExceptionRule[];\n}\n\nexport const ExecutionNavigationPolicyDefinitionSchema = z.object({\n  defaultHandlingMode: z.enum(ExecutionNavigationHandlingMode)\n    .default(ExecutionNavigationHandlingMode.DELEGATE_TO_ROUTER),\n  operationHandlingExceptions: ExecutionNavigationPolicyExceptionRuleSchema.array().optional(),\n});\n/** @wildo_source:part:end saas.frontend.execution-view.navigation-handling-and-embedding */\n\n/**\n * @wildo_source:part:start saas.frontend.execution-view.definition facet:layer:frontend facet:family:execution-view\n *\n * Resource-owned execution view: `surfaceInOperations` keys, Zod + TS `ExecutionViewDefinition`,\n * authoring config, and `resourceExecutionView()` helper.\n */\nexport const ExecutionSurfaceInOperationSchema = ExecutionConcreteOperationIdentitySchema;\nexport type ExecutionSurfaceInOperation = OperationKey;\n\nexport const ExecutionViewDefinitionSchema = z.object({\n  /**\n   * Execution views are resource-owned inserted surfaces.\n   *\n   * There is no app-level execution-view authoring contract. Keeping the\n   * literal here makes the semantic boundary explicit at schema level instead\n   * of relying on downstream consumer checks to reject application-scoped\n   * declarations.\n   */\n  scope: z.literal(FrontendView_ScopeMode.RESOURCE),\n  parentResourcesRequirements: FrontendResource_ParentResourceRequirementSchema.array().optional(),\n  additionalResourceRequirements: FrontendResource_ParentResourceRequirementSchema.array().optional(),\n\n  /** Unique view reference inside the owning resource's executionViews map. */\n  ref: z.string().min(1),\n\n  /** Whether this resource-owned execution surface can be addressed via URL. */\n  isAddressable: z.boolean().default(false),\n\n  /** Primary scope for context injection. */\n  primaryScope: z.enum(ResourcePrimaryScope).default(ResourcePrimaryScope.ORGANIZATIONS),\n\n  /**\n   * Optional declarative anchor contract.\n   *\n   * When present, the runtime resolves the execution subject only from the\n   * explicitly declared binding key and only from explicit navigation-time\n   * context bindings.\n   */\n  anchor: ExecutionViewAnchorDefinitionSchema.optional(),\n  navigationPolicy: ExecutionNavigationPolicyDefinitionSchema.optional(),\n\n  /**\n   * Direct authored execution renderer component.\n   *\n   * Execution remains custom-renderer-first, but the owning declaration is\n   * resource-bound rather than app-global.\n   */\n  surfaceInOperations: z.array(ExecutionSurfaceInOperationSchema).optional(),\n  participations: z.record(z.string(), ExecutionParticipationDefinitionSchema).optional(),\n  viewComponent: z.any(),\n\n  /**\n   * How and where this view's launcher is presented on the host record page.\n   * Omitted → framework default (a labelled button in the record's action\n   * cluster). See {@link InsertedViewLauncherConfig}.\n   */\n  launcher: InsertedViewLauncherConfigSchema.optional(),\n\n  /**\n   * Optional view-local i18n label declarations (label refs + interpolation\n   * params) for a CUSTOM execution renderer. The labelling pipeline generates\n   * `views.execution.resources.<resourceType>.<ref>.<labelRef>` from these so the\n   * renderer resolves its own captions via `tView(...)` — beyond the framework's\n   * baseline title/description. Item shape is `LabellingMessageDef`; kept\n   * permissive here (like `viewComponent`) since it is authored, not user input.\n   */\n  labels: z.array(z.any()).optional(),\n\n  /** Required features for this view — gates navigation + route access via feature availability policy. */\n  requiredFeatures: RequiredFeaturesConfigSchema.optional(),\n\n  /**\n   * View icon — lucide component reference (not `<JSX />`) or a\n   * StandardIconReference string. Surfaces on the embedded launcher button\n   * inside the host operation view (and any launcher targeting this view);\n   * without it those buttons render the generic fallback icon. Registered by\n   * the `IconRegistryBridge` under the `view-execution-{ref}` custom-icon key.\n   * Declared in the schema AND the interface — schema-unknown keys are\n   * stripped wherever the definition is Zod-parsed.\n   */\n  icon: z.custom<IconLike>().optional(),\n});\n\n/**\n * Explicit interface keeps the resource-exclusive execution contract obvious\n * in TS.\n *\n * Execution views surface exclusively through `surfaceInOperations` (a list,\n * because a single execution surface can legitimately host into multiple\n * operations). They do not carry an `operationLike` field — that field\n * belongs to composite and chart views, which surface into a single\n * operation host. The render-time filter in `ResourceLayout_InsertedViews`\n * uses `surfaceInOperations` for execution views and `operationLike` for the\n * other two families (see `collectExecutionViewSurfaceRefsByOperation` vs\n * `collectOperationLikeViewRefs`).\n */\nexport interface ExecutionViewDefinition {\n  scope: FrontendView_ScopeMode.RESOURCE;\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n  additionalResourceRequirements?: FrontendResource_ParentResourceRequirement[];\n  ref: string;\n  isAddressable: boolean;\n  primaryScope: ResourcePrimaryScope;\n  anchor?: ExecutionViewAnchorDefinition;\n  navigationPolicy?: ExecutionNavigationPolicyDefinition;\n  surfaceInOperations?: ExecutionSurfaceInOperation[];\n  participations?: Record<string, ExecutionParticipationDefinition>;\n  viewComponent: React.ComponentType<ExecutionViewComponentProps>;\n  /** How and where this view's launcher is presented on the host record page. */\n  launcher?: InsertedViewLauncherConfig;\n  /**\n   * View-local i18n label declarations (refs + params) for custom renderers.\n   * Drives generation of `views.execution.resources.<type>.<ref>.<labelRef>`,\n   * resolved at render time via `tView(...)`.\n   */\n  labels?: LabellingMessageDef[];\n  /** Required features for this view — gates navigation + route access */\n  requiredFeatures?: RequiredFeaturesConfig;\n  /** View icon (lucide component reference or StandardIconReference string) for launcher surfaces. */\n  icon?: IconLike;\n}\n\nexport const EXECUTION_ROUTE_CONTEXT_QUERY_PARAM_PREFIX = 'execution_ctx_';\n\nexport interface ResourceExecutionViewAuthoringConfig {\n  isAddressable?: boolean;\n  primaryScope?: ResourcePrimaryScope;\n  anchor?: ExecutionViewAnchorDefinition;\n  navigationPolicy?: ExecutionNavigationPolicyDefinition;\n  surfaceInOperations?: ExecutionSurfaceInOperation[];\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n  additionalResourceRequirements?: FrontendResource_ParentResourceRequirement[];\n  participations?: Record<string, ExecutionParticipationDefinition>;\n  viewComponent: React.ComponentType<ExecutionViewComponentProps>;\n  /** How and where this view's launcher is presented on the host record page. */\n  launcher?: InsertedViewLauncherConfig;\n  /** View-local i18n label declarations (refs + params) for custom renderers. */\n  labels?: LabellingMessageDef[];\n  requiredFeatures?: RequiredFeaturesConfig;\n  /** View icon (lucide component reference or StandardIconReference string) for launcher surfaces. */\n  icon?: IconLike;\n}\n\nexport type ResourceExecutionViewsConfig = Record<string, ResourceExecutionViewAuthoringConfig>;\nexport type InsertedExecutionDeclaration = ExecutionViewDefinition;\n\n/**\n * Small authoring helper for resource-owned execution views.\n *\n * Keeps execution declarations terse at the resource UIBehavior level while\n * preserving execution-specific semantics such as anchors and explicit resource\n * requirements.\n */\nexport function resourceExecutionView(\n  viewComponent: React.ComponentType<ExecutionViewComponentProps>,\n  config: Omit<ResourceExecutionViewAuthoringConfig, 'viewComponent'> = {},\n): ResourceExecutionViewAuthoringConfig {\n  return {\n    ...config,\n    viewComponent,\n  };\n}\n/** @wildo_source:part:end saas.frontend.execution-view.definition */\n\nexport function serializeSurfaceOperation(\n  operation: ExecutionSurfaceInOperation,\n): string {\n  if (typeof operation === 'string') {\n    return operation;\n  }\n\n  return `${operation[0]}::${operation[1]}`;\n}\n\n/**\n * Carrier shape for execution views — the **only** view family that declares\n * surfacing via a list (`surfaceInOperations`), because one execution surface\n * can legitimately be rendered inside several operation hosts (e.g. READ +\n * UPDATE). Composite and chart views declare surfacing via a single\n * `operationLike` instead (see `collectOperationLikeViewRefs`).\n */\nexport interface ExecutionViewSurfaceCarrier {\n  ref?: string;\n  surfaceInOperations?: ExecutionSurfaceInOperation[];\n}\n\n/**\n * Derive compiled operation-linked refs from execution view declarations.\n *\n * Returns a map whose keys are serialized operation keys (`\"READ\"` or\n * `\"customOp::variant\"`) and whose values are the execution-view refs that\n * surface into that operation. Callers merge this map with the equivalents\n * for composite and chart views (see {@link collectOperationLikeViewRefs})\n * to build the per-operation linked view refs map exposed by the\n * specification layer. There is no runtime compiled `additionalViews` —\n * `ResourceLayout_InsertedViews` filters execution views directly at render time.\n */\nexport function collectExecutionViewSurfaceRefsByOperation<\n  TView extends ExecutionViewSurfaceCarrier,\n>(\n  views: TView[] | Record<string, TView> | undefined,\n): Map<string, string[]> {\n  const result = new Map<string, string[]>();\n  if (!views) {\n    return result;\n  }\n\n  const viewEntries = Array.isArray(views)\n    ? views.map((view) => [view.ref ?? '', view] as const)\n    : Object.entries(views);\n\n  for (const [ref, view] of viewEntries) {\n    if (!ref) {\n      continue;\n    }\n\n    for (const operation of view.surfaceInOperations ?? []) {\n      const key = serializeSurfaceOperation(operation);\n      const existingRefs = result.get(key) ?? [];\n      result.set(key, [...existingRefs, ref]);\n    }\n  }\n\n  return result;\n}\n\n/**\n * Carrier shape for view families that surface in a **single** operation via\n * their `operationLike` field (composite + chart views). Declared here so the\n * operation-binding logic can be shared without cross-family imports.\n */\nexport interface OperationLikeViewCarrier {\n  ref?: string;\n  operationLike?: CoreResourceOperation;\n}\n\n/**\n * Collect view refs grouped by serialized operation key from view families\n * that declare a **single** `operationLike` (composite + chart views).\n *\n * `fallbackOperation` is used when the view does not declare `operationLike`\n * explicitly — composite and chart views default to `READ` at compile time,\n * but the fallback is passed by the caller so this helper stays family-agnostic.\n */\nexport function collectOperationLikeViewRefs<TView extends OperationLikeViewCarrier>(\n  views: TView[] | Record<string, TView> | undefined,\n  fallbackOperation: CoreResourceOperation,\n): Map<string, string[]> {\n  const result = new Map<string, string[]>();\n  if (!views) {\n    return result;\n  }\n\n  const viewEntries = Array.isArray(views)\n    ? views.map((view) => [view.ref ?? '', view] as const)\n    : Object.entries(views);\n\n  for (const [ref, view] of viewEntries) {\n    if (!ref) {\n      continue;\n    }\n\n    const key = serializeSurfaceOperation(view.operationLike ?? fallbackOperation);\n    const existingRefs = result.get(key) ?? [];\n    result.set(key, [...existingRefs, ref]);\n  }\n\n  return result;\n}\n\nexport function isStandaloneRoutableExecutionView(\n  executionView: ExecutionViewDefinition | undefined,\n): boolean {\n  return (\n    executionView?.isAddressable === true\n    && executionView.scope === FrontendView_ScopeMode.RESOURCE\n  );\n}\n\nexport function buildResourceInsertedExecutionIdentity(\n  resourceType: string,\n  executionView: Pick<ExecutionViewDefinition, 'ref'>,\n): FrontendInsertedViewIdentity {\n  return createFrontendInsertedViewIdentity({\n    hostKind: FrontendInsertedViewHostKind.RESOURCE,\n    hostRef: resourceType,\n    viewKind: FrontendInsertedViewKind.EXECUTION_VIEW,\n    localRef: executionView.ref,\n  });\n}\n\nexport function resolveExecutionViewDefinition(params: {\n  viewRef: string | undefined;\n  registry?: FrontendResourcesRegistry;\n}): ExecutionViewDefinition | undefined {\n  const { viewRef, registry } = params;\n  if (!viewRef) {\n    return undefined;\n  }\n\n  const insertedIdentity = parseFrontendInsertedViewRef(viewRef);\n  if (\n    !insertedIdentity\n    || insertedIdentity.hostKind !== FrontendInsertedViewHostKind.RESOURCE\n    || insertedIdentity.viewKind !== FrontendInsertedViewKind.EXECUTION_VIEW\n  ) {\n    return undefined;\n  }\n\n  return registry?.resourceConfigurations[insertedIdentity.hostRef]\n    ?.frontendConfiguration\n    ?.executionViews\n    ?.find((candidate) => candidate.ref === insertedIdentity.localRef);\n}\n\nexport function buildExecutionConcreteOperationIdentity(\n  operation: Pick<\n    FrontendResourceConfiguration_Operation,\n    'operationIdentifier' | 'variantKey' | 'isOperationDefault'\n  >,\n): OperationKey {\n  const operationIdentifier = String(operation.operationIdentifier);\n\n  return operation.variantKey && operation.isOperationDefault !== true\n    ? [operationIdentifier, operation.variantKey]\n    : operationIdentifier;\n}\n\nexport function matchesExecutionConcreteOperationIdentity(\n  expected: OperationKey,\n  actual: OperationKey,\n): boolean {\n  if (Array.isArray(expected) && Array.isArray(actual)) {\n    return expected[0] === actual[0] && expected[1] === actual[1];\n  }\n\n  return !Array.isArray(expected) && !Array.isArray(actual) && expected === actual;\n}\n\n/**\n * @wildo_source:part:start saas.frontend.execution-view.navigation-handling-and-embedding.resolution facet:layer:frontend facet:family:execution-view\n *\n * Resolve the navigation handling mode for a single operation on an execution\n * view. Applies the authored default first, then overrides with a matching\n * `operationHandlingExceptions` entry if one is declared. This is the\n * canonical decision point used by `execution.actions.operation(...).navigate()`\n * to pick between embedding and router delegation.\n *\n * Companion span to the principle anchor\n * `saas.frontend.execution-view.navigation-handling-and-embedding` (above\n * — the policy enum + schema). Split into a dedicated `.resolution` anchor\n * so the principle and its runtime resolver can be referenced\n * independently in documentation.\n */\nexport function resolveExecutionNavigationHandlingMode(params: {\n  viewDefinition: Pick<ExecutionViewDefinition, 'navigationPolicy'>;\n  resourceType: string;\n  operation: Pick<\n    FrontendResourceConfiguration_Operation,\n    'operationIdentifier' | 'variantKey' | 'isOperationDefault'\n  >;\n}): ExecutionNavigationHandlingMode {\n  const defaultHandlingMode = params.viewDefinition.navigationPolicy?.defaultHandlingMode\n    ?? ExecutionNavigationHandlingMode.DELEGATE_TO_ROUTER;\n  const operationIdentity = buildExecutionConcreteOperationIdentity(params.operation);\n  const exception = params.viewDefinition.navigationPolicy?.operationHandlingExceptions?.find(\n    (candidate) => (\n      candidate.resourceType === params.resourceType\n      && matchesExecutionConcreteOperationIdentity(candidate.operation, operationIdentity)\n    ),\n  );\n\n  return exception?.handlingMode ?? defaultHandlingMode;\n}\n/** @wildo_source:part:end saas.frontend.execution-view.navigation-handling-and-embedding.resolution */\n\nexport function buildExecutionRouteUrlPath(\n  viewRef: string,\n  contextResourceIdentifiers?: Record<string, string>,\n): string {\n  const params = new URLSearchParams();\n  for (const [key, value] of Object.entries(contextResourceIdentifiers ?? {})) {\n    if (!value) {\n      continue;\n    }\n    params.set(`${EXECUTION_ROUTE_CONTEXT_QUERY_PARAM_PREFIX}${key}`, value);\n  }\n\n  const search = params.toString();\n  return search.length > 0 ? `/execution/${viewRef}?${search}` : `/execution/${viewRef}`;\n}\n\nexport function extractExecutionRouteContextResourceIdentifiers(\n  searchParams: URLSearchParams,\n): Record<string, string> | undefined {\n  const contextResourceIdentifiers: Record<string, string> = {};\n\n  for (const [key, value] of searchParams.entries()) {\n    if (!key.startsWith(EXECUTION_ROUTE_CONTEXT_QUERY_PARAM_PREFIX) || !value) {\n      continue;\n    }\n    contextResourceIdentifiers[key.slice(EXECUTION_ROUTE_CONTEXT_QUERY_PARAM_PREFIX.length)] = value;\n  }\n\n  return Object.keys(contextResourceIdentifiers).length > 0 ? contextResourceIdentifiers : undefined;\n}\n"]}

package/dist/esm/core/config/flows-actors-view.schemas.d.ts

@@ -1,11 +1,11 @@
 import { z } from 'zod';
 import { CoreResourceOperation, ResourcePrimaryScope } from '@wildo-ai/saas-models';
 import type { RequiredFeaturesConfig } from '@wildo-ai/saas-models';
-import { FrontendView_ScopeMode } from './views-frontend.schemas.js';
-import type { FrontendResource_ParentResourceRequirement } from '../../core/resources/resource-path.frontend.schemas.js';
+import { FrontendView_ScopeMode } from './views-frontend.schemas';
+import type { FrontendResource_ParentResourceRequirement } from '../../core/resources/resource-path.frontend.schemas';
 export declare const FlowsActorsViewDefinitionSchema: z.ZodIntersection<z.ZodDiscriminatedUnion<[z.ZodObject<{
     scope: z.ZodLiteral<FrontendView_ScopeMode.APPLICATION>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     scope: z.ZodLiteral<FrontendView_ScopeMode.RESOURCE>;
     parentResourcesRequirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
         resourceType: z.ZodUnion<readonly [z.ZodEnum<typeof import("@wildo-ai/saas-models").CoreResourceType>, z.ZodString]>;
@@ -15,7 +15,7 @@ export declare const FlowsActorsViewDefinitionSchema: z.ZodIntersection<z.ZodDis
         requirement: z.ZodEnum<typeof import("@wildo-ai/saas-models").ResourceParentResourceRequirement>;
         isPrimaryScope: z.ZodBoolean;
         primaryScope: z.ZodOptional<z.ZodEnum<typeof ResourcePrimaryScope>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>>;
+    }, z.core.$strip>>>;
     additionalResourceRequirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
         resourceType: z.ZodUnion<readonly [z.ZodEnum<typeof import("@wildo-ai/saas-models").CoreResourceType>, z.ZodString]>;
         foreignKeyField: z.ZodOptional<z.ZodString>;
@@ -24,8 +24,8 @@ export declare const FlowsActorsViewDefinitionSchema: z.ZodIntersection<z.ZodDis
         requirement: z.ZodEnum<typeof import("@wildo-ai/saas-models").ResourceParentResourceRequirement>;
         isPrimaryScope: z.ZodBoolean;
         primaryScope: z.ZodOptional<z.ZodEnum<typeof ResourcePrimaryScope>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>>;
-}, z.core.$strip, core.$ZodObjectExtra>], "scope">, z.ZodObject<{
+    }, z.core.$strip>>>;
+}, z.core.$strip>], "scope">, z.ZodObject<{
     ref: z.ZodString;
     isAddressable: z.ZodDefault<z.ZodBoolean>;
     operationLike: z.ZodDefault<z.ZodEnum<typeof CoreResourceOperation>>;
@@ -47,11 +47,28 @@ export declare const FlowsActorsViewDefinitionSchema: z.ZodIntersection<z.ZodDis
                 aggregate: z.ZodOptional<z.ZodObject<{
                     field: z.ZodString;
                     operation: z.ZodEnum<typeof import("@wildo-ai/saas-models").AggregationOperation>;
-                }, z.core.$strip, core.$ZodObjectExtra>>;
-            }, z.core.$strip, core.$ZodObjectExtra>>;
-        }, z.core.$strip, core.$ZodObjectExtra>>>;
-    }, z.core.$strip, core.$ZodObjectExtra>]>>;
-}, z.core.$strip, core.$ZodObjectExtra>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>]>>;
+}, z.core.$strip>>;
+/**
+ * @wildo_source:part:start saas.frontend.flows-actors-view facet:layer:frontend facet:family:view
+ *
+ * Authoring shape for a standalone flows-actors view. Add entries to a frontend
+ * module's `flowsActorsViews` (an app-level-views contribution); an addressable
+ * one routes at `/flows-actors/:ref` and is surfaced by a launcher item
+ * (`LauncherItemTargetKind.VIEW`, `viewRef: <ref>`). The engine `FlowsActorsView`
+ * host renders each referenced system's actor/flow graph beside a streaming chat.
+ *
+ * Import type from `@wildo-ai/saas-frontend-lib/companion`.
+ *
+ * @property ref           unique view id (used in the `/flows-actors/:ref` URL).
+ * @property systemRefs    one or more registered flow/actor system refs to expose (min 1).
+ * @property layoutPreset  layout arrangement — `'graph-primary'` | `'chat-primary'` | `'Default'`.
+ * @property isAddressable set `true` to give the view its own URL/route.
+ * @property primaryScope  scope whose context is injected for access/navigation.
+ */
 export interface FlowsActorsViewDefinition {
     scope: FrontendView_ScopeMode;
     parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];
@@ -65,4 +82,5 @@ export interface FlowsActorsViewDefinition {
     /** Required features for this view — gates navigation + route access */
     requiredFeatures?: RequiredFeaturesConfig;
 }
+/** @wildo_source:part:end saas.frontend.flows-actors-view */
 //# sourceMappingURL=flows-actors-view.schemas.d.ts.map

package/dist/esm/core/config/flows-actors-view.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flows-actors-view.schemas.d.ts","sourceRoot":"","sources":["../../../../src/core/config/flows-actors-view.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAgC,MAAM,uBAAuB,CAAC;AAClH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAiC,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACjG,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,mEAAmE,CAAC;AAUpI,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kCAwC+tL,IAAK,CAAC,eAAe;8BAA6B,IAAK,CAAC,eAAe;0BAAyB,IAAK,CAAC,eAAe;;wCAhB/3L,CAAC;AAGF,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,2BAA2B,CAAC,EAAE,0CAA0C,EAAE,CAAC;IAC3E,8BAA8B,CAAC,EAAE,0CAA0C,EAAE,CAAC;IAC9E,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,qBAAqB,CAAC;IACrC,YAAY,EAAE,oBAAoB,CAAC;IACnC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;CAC3C"}
+{"version":3,"file":"flows-actors-view.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/core/config/flows-actors-view.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAgC,MAAM,uBAAuB,CAAC;AAClH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAiC,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACjG,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,mEAAmE,CAAC;AAUpI,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAwB3C,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,2BAA2B,CAAC,EAAE,0CAA0C,EAAE,CAAC;IAC3E,8BAA8B,CAAC,EAAE,0CAA0C,EAAE,CAAC;IAC9E,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,qBAAqB,CAAC;IACrC,YAAY,EAAE,oBAAoB,CAAC;IACnC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;CAC3C;AACD,6DAA6D"}

package/dist/esm/core/config/flows-actors-view.schemas.js

@@ -24,4 +24,5 @@ export const FlowsActorsViewDefinitionSchema = z.intersection(FrontendView_Defin
     /** Required features for this view — gates navigation + route access via feature availability policy */
     requiredFeatures: RequiredFeaturesConfigSchema.optional(),
 }));
-//# sourceMappingURL=flows-actors-view.schemas.js.map
+/** @wildo_source:part:end saas.frontend.flows-actors-view */
+//# sourceMappingURL=flows-actors-view.schemas.js.map

package/dist/esm/core/config/flows-actors-view.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"flows-actors-view.schemas.js","sourceRoot":"","sources":["../../../../src/core/config/flows-actors-view.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAElH,OAAO,EAAE,6BAA6B,EAA0B,MAAM,0BAA0B,CAAC;AAGjG,iEAAiE;AACjE,mBAAmB;AACnB,WAAW;AACX,gEAAgE;AAChE,oEAAoE;AACpE,8BAA8B;AAC9B,iEAAiE;AAEjE,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,YAAY,CAC3D,6BAA6B,EAC7B,CAAC,CAAC,MAAM,CAAC;IACP,kEAAkE;IAClE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAEtB,gDAAgD;IAChD,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAEzC,sDAAsD;IACtD,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,IAAI,CAAC;IAEhF,0CAA0C;IAC1C,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC,aAAa,CAAC;IAEtF,wDAAwD;IACxD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAE7C,qEAAqE;IACrE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;IAE3C,wGAAwG;IACxG,gBAAgB,EAAE,4BAA4B,CAAC,QAAQ,EAAE;CAC1D,CAAC,CACH,CAAC"}
+{"version":3,"file":"flows-actors-view.schemas.js","sourceRoot":"","sources":["../../../../../src/core/config/flows-actors-view.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAElH,OAAO,EAAE,6BAA6B,EAA0B,MAAM,0BAA0B,CAAC;AAGjG,iEAAiE;AACjE,mBAAmB;AACnB,WAAW;AACX,gEAAgE;AAChE,oEAAoE;AACpE,8BAA8B;AAC9B,iEAAiE;AAEjE,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,YAAY,CAC3D,6BAA6B,EAC7B,CAAC,CAAC,MAAM,CAAC;IACP,kEAAkE;IAClE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAEtB,gDAAgD;IAChD,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAEzC,sDAAsD;IACtD,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,IAAI,CAAC;IAEhF,0CAA0C;IAC1C,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC,aAAa,CAAC;IAEtF,wDAAwD;IACxD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAE7C,qEAAqE;IACrE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;IAE3C,wGAAwG;IACxG,gBAAgB,EAAE,4BAA4B,CAAC,QAAQ,EAAE;CAC1D,CAAC,CACH,CAAC;AAgCF,6DAA6D","sourcesContent":["import { z } from 'zod';\n\nimport { CoreResourceOperation, ResourcePrimaryScope, RequiredFeaturesConfigSchema } from '@wildo-ai/saas-models';\nimport type { RequiredFeaturesConfig } from '@wildo-ai/saas-models';\nimport { FrontendView_DefinitionSchema, FrontendView_ScopeMode } from './views-frontend.schemas';\nimport type { FrontendResource_ParentResourceRequirement } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\n\n//===============================================================\n//  FlowsActorsView\n// --------\n// A view that exposes one or more FlowActorSystems to the user.\n// Used for conversation interfaces, human-in-the-loop interactions,\n// and workflow orchestration.\n//===============================================================\n\nexport const FlowsActorsViewDefinitionSchema = z.intersection(\n  FrontendView_DefinitionSchema,\n  z.object({\n    /** Unique view reference (used in URL: /flows-actors/:viewRef) */\n    ref: z.string().min(1),\n\n    /** Whether this view can be accessed via URL */\n    isAddressable: z.boolean().default(false),\n\n    /** Operation-like behavior for navigation purposes */\n    operationLike: z.enum(CoreResourceOperation).default(CoreResourceOperation.READ),\n\n    /** Primary scope for context injection */\n    primaryScope: z.enum(ResourcePrimaryScope).default(ResourcePrimaryScope.ORGANIZATIONS),\n\n    /** FlowActorSystem references to expose in this view */\n    systemRefs: z.array(z.string().min(1)).min(1),\n\n    /** Layout preset from component registry (Default, Compact, etc.) */\n    layoutPreset: z.string().default('Default'),\n\n    /** Required features for this view — gates navigation + route access via feature availability policy */\n    requiredFeatures: RequiredFeaturesConfigSchema.optional(),\n  })\n);\n\n/**\n * @wildo_source:part:start saas.frontend.flows-actors-view facet:layer:frontend facet:family:view\n *\n * Authoring shape for a standalone flows-actors view. Add entries to a frontend\n * module's `flowsActorsViews` (an app-level-views contribution); an addressable\n * one routes at `/flows-actors/:ref` and is surfaced by a launcher item\n * (`LauncherItemTargetKind.VIEW`, `viewRef: <ref>`). The engine `FlowsActorsView`\n * host renders each referenced system's actor/flow graph beside a streaming chat.\n *\n * Import type from `@wildo-ai/saas-frontend-lib/companion`.\n *\n * @property ref           unique view id (used in the `/flows-actors/:ref` URL).\n * @property systemRefs    one or more registered flow/actor system refs to expose (min 1).\n * @property layoutPreset  layout arrangement — `'graph-primary'` | `'chat-primary'` | `'Default'`.\n * @property isAddressable set `true` to give the view its own URL/route.\n * @property primaryScope  scope whose context is injected for access/navigation.\n */\nexport interface FlowsActorsViewDefinition {\n  scope: FrontendView_ScopeMode;\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n  additionalResourceRequirements?: FrontendResource_ParentResourceRequirement[];\n  ref: string;\n  isAddressable: boolean;\n  operationLike: CoreResourceOperation;\n  primaryScope: ResourcePrimaryScope;\n  systemRefs: string[];\n  layoutPreset: string;\n  /** Required features for this view — gates navigation + route access */\n  requiredFeatures?: RequiredFeaturesConfig;\n}\n/** @wildo_source:part:end saas.frontend.flows-actors-view */\n"]}

package/dist/esm/core/config/full-custom-view.schemas.d.ts

@@ -1,11 +1,18 @@
 import { z } from 'zod';
 import { CoreResourceOperation, ResourcePrimaryScope } from '@wildo-ai/saas-models';
 import type { RequiredFeaturesConfig } from '@wildo-ai/saas-models';
-import { FrontendView_ScopeMode } from './views-frontend.schemas.js';
-import type { FrontendResource_ParentResourceRequirement } from '../../core/resources/resource-path.frontend.schemas.js';
+import type { IconLike } from '@wildo-ai/zod-decorators';
+import { FrontendView_ScopeMode } from './views-frontend.schemas';
+import type { FrontendResource_ParentResourceRequirement } from '../../core/resources/resource-path.frontend.schemas';
+/**
+ * @wildo_source:part:start saas.frontend.full-custom-view.definition facet:layer:frontend facet:family:full-custom-view
+ *
+ * App- or module-level full custom view: addressable ref, component registry key,
+ * operation-like navigation, primary scope, optional feature gating.
+ */
 export declare const FullCustomViewDefinitionSchema: z.ZodIntersection<z.ZodDiscriminatedUnion<[z.ZodObject<{
     scope: z.ZodLiteral<FrontendView_ScopeMode.APPLICATION>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     scope: z.ZodLiteral<FrontendView_ScopeMode.RESOURCE>;
     parentResourcesRequirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
         resourceType: z.ZodUnion<readonly [z.ZodEnum<typeof import("@wildo-ai/saas-models").CoreResourceType>, z.ZodString]>;
@@ -15,7 +22,7 @@ export declare const FullCustomViewDefinitionSchema: z.ZodIntersection<z.ZodDisc
         requirement: z.ZodEnum<typeof import("@wildo-ai/saas-models").ResourceParentResourceRequirement>;
         isPrimaryScope: z.ZodBoolean;
         primaryScope: z.ZodOptional<z.ZodEnum<typeof ResourcePrimaryScope>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>>;
+    }, z.core.$strip>>>;
     additionalResourceRequirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
         resourceType: z.ZodUnion<readonly [z.ZodEnum<typeof import("@wildo-ai/saas-models").CoreResourceType>, z.ZodString]>;
         foreignKeyField: z.ZodOptional<z.ZodString>;
@@ -24,8 +31,8 @@ export declare const FullCustomViewDefinitionSchema: z.ZodIntersection<z.ZodDisc
         requirement: z.ZodEnum<typeof import("@wildo-ai/saas-models").ResourceParentResourceRequirement>;
         isPrimaryScope: z.ZodBoolean;
         primaryScope: z.ZodOptional<z.ZodEnum<typeof ResourcePrimaryScope>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>>;
-}, z.core.$strip, core.$ZodObjectExtra>], "scope">, z.ZodObject<{
+    }, z.core.$strip>>>;
+}, z.core.$strip>], "scope">, z.ZodObject<{
     ref: z.ZodString;
     isAddressable: z.ZodDefault<z.ZodBoolean>;
     operationLike: z.ZodDefault<z.ZodEnum<typeof CoreResourceOperation>>;
@@ -46,11 +53,12 @@ export declare const FullCustomViewDefinitionSchema: z.ZodIntersection<z.ZodDisc
                 aggregate: z.ZodOptional<z.ZodObject<{
                     field: z.ZodString;
                     operation: z.ZodEnum<typeof import("@wildo-ai/saas-models").AggregationOperation>;
-                }, z.core.$strip, core.$ZodObjectExtra>>;
-            }, z.core.$strip, core.$ZodObjectExtra>>;
-        }, z.core.$strip, core.$ZodObjectExtra>>>;
-    }, z.core.$strip, core.$ZodObjectExtra>]>>;
-}, z.core.$strip, core.$ZodObjectExtra>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>]>>;
+    icon: z.ZodOptional<z.ZodCustom<IconLike, IconLike>>;
+}, z.core.$strip>>;
 export interface FullCustomViewDefinition {
     scope: FrontendView_ScopeMode;
     parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];
@@ -62,5 +70,8 @@ export interface FullCustomViewDefinition {
     componentRef: string;
     /** Required features for this view — gates navigation + route access */
     requiredFeatures?: RequiredFeaturesConfig;
+    /** View icon (lucide component reference or StandardIconReference string) for launcher surfaces. */
+    icon?: IconLike;
 }
+/** @wildo_source:part:end saas.frontend.full-custom-view.definition */
 //# sourceMappingURL=full-custom-view.schemas.d.ts.map

package/dist/esm/core/config/full-custom-view.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"full-custom-view.schemas.d.ts","sourceRoot":"","sources":["../../../../src/core/config/full-custom-view.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAgC,MAAM,uBAAuB,CAAC;AAClH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAiC,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACjG,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,mEAAmE,CAAC;AASpI,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kCAoCu4L,IAAK,CAAC,eAAe;8BAA6B,IAAK,CAAC,eAAe;0BAAyB,IAAK,CAAC,eAAe;;wCAftiM,CAAC;AAGF,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,2BAA2B,CAAC,EAAE,0CAA0C,EAAE,CAAC;IAC3E,8BAA8B,CAAC,EAAE,0CAA0C,EAAE,CAAC;IAC9E,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,qBAAqB,CAAC;IACrC,YAAY,EAAE,oBAAoB,CAAC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;CAC3C"}
+{"version":3,"file":"full-custom-view.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/core/config/full-custom-view.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAgC,MAAM,uBAAuB,CAAC;AAClH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAiC,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACjG,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,mEAAmE,CAAC;AASpI;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA+B1C,CAAC;AAGF,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,2BAA2B,CAAC,EAAE,0CAA0C,EAAE,CAAC;IAC3E,8BAA8B,CAAC,EAAE,0CAA0C,EAAE,CAAC;IAC9E,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,qBAAqB,CAAC;IACrC,YAAY,EAAE,oBAAoB,CAAC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,oGAAoG;IACpG,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AACD,uEAAuE"}

package/dist/esm/core/config/full-custom-view.schemas.js

@@ -7,6 +7,12 @@ import { FrontendView_DefinitionSchema } from './views-frontend.schemas.js';
 // A fully custom view where all interaction is managed by the component.
 // The component receives context identifiers but handles all data fetching itself.
 //===============================================================
+/**
+ * @wildo_source:part:start saas.frontend.full-custom-view.definition facet:layer:frontend facet:family:full-custom-view
+ *
+ * App- or module-level full custom view: addressable ref, component registry key,
+ * operation-like navigation, primary scope, optional feature gating.
+ */
 export const FullCustomViewDefinitionSchema = z.intersection(FrontendView_DefinitionSchema, z.object({
     /** Unique view reference (used in URL: /custom/:viewRef) */
     ref: z.string().min(1),
@@ -20,5 +26,15 @@ export const FullCustomViewDefinitionSchema = z.intersection(FrontendView_Defini
     componentRef: z.string().min(1),
     /** Required features for this view — gates navigation + route access via feature availability policy */
     requiredFeatures: RequiredFeaturesConfigSchema.optional(),
+    /**
+     * View icon — lucide component reference (not `<JSX />`) or a
+     * StandardIconReference string. Surfaces on launchers (sidebar, command
+     * menu) that target this view; without it those items render the generic
+     * fallback icon. Registered by the `IconRegistryBridge` under the
+     * `view-custom-{ref}` custom-icon key. Declared in BOTH the schema and the
+     * interface below — the startup config parse strips schema-unknown keys.
+     */
+    icon: z.custom().optional(),
 }));
-//# sourceMappingURL=full-custom-view.schemas.js.map
+/** @wildo_source:part:end saas.frontend.full-custom-view.definition */
+//# sourceMappingURL=full-custom-view.schemas.js.map