npm - @wildo-ai/saas-frontend-lib - Versions diffs - 1.1.9 → 1.1.11 - Mend

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

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

Files changed (1566) hide show

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

	@@ -1 +1 @@
1	- {"version":3,"file":"execution-view.schemas.js","sourceRoot":"","sources":["../../../../../src/core/config/execution-view.schemas.ts"],"names":[],"mappings":"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","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 { DeclaredViewLabel } from './view-label-declaration.schemas';\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 `DeclaredViewLabel`; 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?: DeclaredViewLabel[];\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?: DeclaredViewLabel[];\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"]}
1	+ {"version":3,"file":"execution-view.schemas.js","sourceRoot":"","sources":["../../../../../src/core/config/execution-view.schemas.ts"],"names":[],"mappings":"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","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 { DeclaredViewLabel } from './view-label-declaration.schemas';\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 `DeclaredViewLabel`; 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?: DeclaredViewLabel[];\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?: DeclaredViewLabel[];\n requiredFeatures?: RequiredFeaturesConfig;\n /\n View icon — a lucide component reference (not `<JSX />`) or a `StandardIconReference` string.\n * Required.\n \n An execution view is opened from launcher buttons: the record navigation strip, the host\n * operation's action cluster, sidebar and command-menu entries. A launcher can be icon-only, and\n * an execution view has no default glyph, so without an icon every launcher shows the framework's\n * alert-circle placeholder, which reads as a warning. That is why omitting it does not compile.\n * (The view's own page header shows no icon at all when none is declared; there it only\n * decorates the title.)\n \n @example\n * import { ListChecks } from 'lucide-react';\n * resourceExecutionView(MyFlowView, { icon: ListChecks, surfaceInOperations: [Op.READ] });\n /\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 CHANGED Viewed

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { CoreResourceOperation, ResourcePrimaryScope } from '@wildo-ai/saas-models';
 import type { RequiredFeaturesConfig } from '@wildo-ai/saas-models';
+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';
 export declare const FlowsActorsViewDefinitionSchema: z.ZodIntersection<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -51,6 +52,7 @@ export declare const FlowsActorsViewDefinitionSchema: z.ZodIntersection<z.ZodDis
             }, z.core.$strip>>;
         }, z.core.$strip>>>;
     }, z.core.$strip>]>>;
+    icon: z.ZodOptional<z.ZodCustom<IconLike, IconLike>>;
 }, z.core.$strip>>;
 /**
  * @wildo_source:part:start saas.frontend.flows-actors-view facet:layer:frontend facet:family:view
@@ -67,10 +69,16 @@ export declare const FlowsActorsViewDefinitionSchema: z.ZodIntersection<z.ZodDis
  * @property systemRef     the registered flow/actor system ref to expose. ONE per view: a view
  *                        hosting several assistants would need a switcher, and hosting several
  *                        means declaring several views.
- * @property layoutPreset  configured preset name; use 'Default' for the standard chat-first host.
- *                        This field does not itself compose a graph beside the chat.
+ * @property layoutPreset  the conversation surface preset (`AI_ConversationThread`) that draws the view;
+ *                        'Default' is the framework's. An unregistered name does not fall back to
+ *                        'Default': every part draws the not-injected placeholder (visible in
+ *                        development, empty in production) and the console warns.
  * @property isAddressable set `true` to give the view its own URL/route.
  * @property primaryScope  scope whose context is injected for access/navigation.
+ * @property icon          the glyph every launcher for this view shows (sidebar, command menu). Optional
+ *                        because the view can be embed-only (hosted inline by the utility panel, whose
+ *                        item carries its own icon); declare it whenever a launcher targets the view,
+ *                        or that launcher shows the alert-circle placeholder.
  */
 export interface FlowsActorsViewDefinition {
     scope: FrontendView_ScopeMode;
@@ -84,6 +92,8 @@ export interface FlowsActorsViewDefinition {
     layoutPreset: 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.flows-actors-view */
 //# sourceMappingURL=flows-actors-view.schemas.d.ts.map

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

	@@ -1 +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~~;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAwB3C~~,CAAC;AAEF~~;;;;;;;;;;;;;;;;;;;GAmBG~~;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,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;~~CAC3C~~;AACD,6DAA6D"}
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,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAiC,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACjG,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,mEAAmE,CAAC;AAUpI,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAqC3C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;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,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,oGAAoG;IACpG,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AACD,6DAA6D"}

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

@@ -19,10 +19,22 @@ export const FlowsActorsViewDefinitionSchema = z.intersection(FrontendView_Defin
     primaryScope: z.enum(ResourcePrimaryScope).default(ResourcePrimaryScope.ORGANIZATIONS),
     /** The FlowActorSystem this view exposes. */
     systemRef: z.string().min(1),
-    /** Layout preset from component registry (Default, Compact, etc.) */
+    /**
+     * The preset of the conversation surface (`AI_ConversationThread`, `LOW_LEVEL_AI_CONVERSATION_THREAD`) that draws this
+     * view: `'Default'` is the framework's, and an application registers its own under any name (#2525).
+     */
     layoutPreset: z.string().default('Default'),
     /** 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 every launcher that targets this view (sidebar, command menu); without it those
+     * entries render the icon registry's alert-circle placeholder, which reads as a warning (#2281).
+     * Registered by the `IconRegistryBridge` under the `view-flows-{ref}` custom-icon key, the key
+     * `resolveConcreteApplicationViewTarget` asks for. Declared in BOTH the schema and the interface
+     * below — the startup config parse strips schema-unknown keys.
+     */
+    icon: z.custom().optional(),
 }));
 /** @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 CHANGED Viewed

	@@ -1 +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,uDAAuD;AACvD,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,6CAA6C;IAC7C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAE5B~~,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;~~AAmCF~~,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 FlowActorSystem 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 /* The FlowActorSystem this view exposes. /\n systemRef: z.string().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 streaming chat with execution and approval controls for the referenced system.\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 systemRef the registered flow/actor system ref to expose. ONE per view: a view\n * hosting several assistants would need a switcher, and hosting several\n * means declaring several views.\n * @property layoutPreset ~~configured~~ preset ~~name;~~ ~~use~~ 'Default' ~~for~~ the ~~standard~~ ~~chat-first~~ ~~host.\~~n * ~~This~~ ~~field~~ ~~does~~ not ~~itself~~ ~~compose~~ a ~~graph~~ ~~beside~~ the ~~chat~~.\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 systemRef: 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"]}
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;AAGlH,OAAO,EAAE,6BAA6B,EAA0B,MAAM,0BAA0B,CAAC;AAGjG,iEAAiE;AACjE,mBAAmB;AACnB,WAAW;AACX,uDAAuD;AACvD,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,6CAA6C;IAC7C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAE5B;;;OAGG;IACH,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;IAE3C,wGAAwG;IACxG,gBAAgB,EAAE,4BAA4B,CAAC,QAAQ,EAAE;IAEzD;;;;;;;OAOG;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAY,CAAC,QAAQ,EAAE;CACtC,CAAC,CACH,CAAC;AA2CF,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 type { IconLike } from '@wildo-ai/zod-decorators';\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 FlowActorSystem 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 /* The FlowActorSystem this view exposes. /\n systemRef: z.string().min(1),\n\n /\n The preset of the conversation surface (`AI_ConversationThread`, `LOW_LEVEL_AI_CONVERSATION_THREAD`) that draws this\n * view: `'Default'` is the framework's, and an application registers its own under any name (#2525).\n /\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 View icon — lucide component reference (not `<JSX />`) or a StandardIconReference string.\n * Surfaces on every launcher that targets this view (sidebar, command menu); without it those\n * entries render the icon registry's alert-circle placeholder, which reads as a warning (#2281).\n * Registered by the `IconRegistryBridge` under the `view-flows-{ref}` custom-icon key, the key\n * `resolveConcreteApplicationViewTarget` asks for. Declared in BOTH the schema and the interface\n * below — the startup config parse strips schema-unknown keys.\n /\n icon: z.custom<IconLike>().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 streaming chat with execution and approval controls for the referenced system.\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 systemRef the registered flow/actor system ref to expose. ONE per view: a view\n * hosting several assistants would need a switcher, and hosting several\n * means declaring several views.\n * @property layoutPreset the conversation surface preset (`AI_ConversationThread`) that draws the view;\n * 'Default' is the framework's. An unregistered name does not fall back to\n * 'Default': every part draws the not-injected placeholder (visible in\n * development, empty in production) and the console warns.\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 * @property icon the glyph every launcher for this view shows (sidebar, command menu). Optional\n * because the view can be embed-only (hosted inline by the utility panel, whose\n * item carries its own icon); declare it whenever a launcher targets the view,\n * or that launcher shows the alert-circle placeholder.\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 systemRef: string;\n layoutPreset: string;\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/* @wildo_source:part:end saas.frontend.flows-actors-view */\n"]}

package/dist/esm/core/config/inserted-view-launcher.schemas.d.ts CHANGED Viewed

@@ -10,22 +10,23 @@ import { z } from 'zod';
  */
 export declare enum InsertedViewLauncherPlacement {
     /**
-     * **Default.** A button in the record's action cluster, beside the record's
-     * own operations (edit / archive / delete), carrying its label.
+     * A button in the record's action cluster, beside the record's own operations
+     * (edit / archive / delete).
      *
-     * This is where a reader looks for "things I can do with this record", and an
-     * alternate view of the record is one of those things. Pair with
-     * `emphasized` when the view is a primary way of working with the record
-     * rather than an occasional detour.
+     * Choose it for a view that IS one of the things a reader does with the record
+     * — a runner, a wizard — rather than another page of it. Pair with `emphasized`
+     * when that view is a primary way of working with the record.
      */
     ACTION_BAR = "action_bar",
     /**
-     * A quiet ruled strip directly under the record header — record-level
-     * secondary navigation, the position mature record UIs use for sibling views
-     * of one entity.
+     * **Default.** A quiet ruled strip directly under the record header —
+     * record-level secondary navigation, the position mature record UIs use for
+     * sibling views of one entity.
      *
-     * Prefer this over {@link ACTION_BAR} when there are SEVERAL such views and
-     * they read as peers of the record's main page rather than as actions.
+     * The default since 2026-10-01: a composite workspace or a list view of the
+     * record is another PAGE of it, and in the action cluster such launchers sat as
+     * labelled, outlined buttons among the record's bare-icon verbs, navigation
+     * mixed into actions.
      */
     RECORD_NAVIGATION = "record_navigation",
     /**

package/dist/esm/core/config/inserted-view-launcher.schemas.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"inserted-view-launcher.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/core/config/inserted-view-launcher.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AACH,oBAAY,6BAA6B;IACvC~~;;;;;;;;OAQG~~;IACH,UAAU,eAAe;IAEzB~~;;;;;;;OAOG~~;IACH,iBAAiB,sBAAsB;IAEvC;;;;;OAKG;IACH,YAAY,iBAAiB;CAC9B;AAED;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC;;;;iBAc3C,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F,yEAAyE;AACzE,eAAO,MAAM,8BAA8B,EAAE,QAAQ,CAAC,0BAA0B,CAI/E,CAAC;AAEF,mFAAmF;AACnF,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,0BAA0B,GAAG,SAAS,GAC/C,QAAQ,CAAC,0BAA0B,CAAC,CAMtC"}
1	+ {"version":3,"file":"inserted-view-launcher.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/core/config/inserted-view-launcher.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AACH,oBAAY,6BAA6B;IACvC;;;;;;;OAOG;IACH,UAAU,eAAe;IAEzB;;;;;;;;;OASG;IACH,iBAAiB,sBAAsB;IAEvC;;;;;OAKG;IACH,YAAY,iBAAiB;CAC9B;AAED;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC;;;;iBAc3C,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F,yEAAyE;AACzE,eAAO,MAAM,8BAA8B,EAAE,QAAQ,CAAC,0BAA0B,CAI/E,CAAC;AAEF,mFAAmF;AACnF,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,0BAA0B,GAAG,SAAS,GAC/C,QAAQ,CAAC,0BAA0B,CAAC,CAMtC"}

package/dist/esm/core/config/inserted-view-launcher.schemas.js CHANGED Viewed

@@ -11,22 +11,23 @@ import { z } from 'zod';
 export var InsertedViewLauncherPlacement;
 (function (InsertedViewLauncherPlacement) {
     /**
-     * **Default.** A button in the record's action cluster, beside the record's
-     * own operations (edit / archive / delete), carrying its label.
+     * A button in the record's action cluster, beside the record's own operations
+     * (edit / archive / delete).
      *
-     * This is where a reader looks for "things I can do with this record", and an
-     * alternate view of the record is one of those things. Pair with
-     * `emphasized` when the view is a primary way of working with the record
-     * rather than an occasional detour.
+     * Choose it for a view that IS one of the things a reader does with the record
+     * — a runner, a wizard — rather than another page of it. Pair with `emphasized`
+     * when that view is a primary way of working with the record.
      */
     InsertedViewLauncherPlacement["ACTION_BAR"] = "action_bar";
     /**
-     * A quiet ruled strip directly under the record header — record-level
-     * secondary navigation, the position mature record UIs use for sibling views
-     * of one entity.
+     * **Default.** A quiet ruled strip directly under the record header —
+     * record-level secondary navigation, the position mature record UIs use for
+     * sibling views of one entity.
      *
-     * Prefer this over {@link ACTION_BAR} when there are SEVERAL such views and
-     * they read as peers of the record's main page rather than as actions.
+     * The default since 2026-10-01: a composite workspace or a list view of the
+     * record is another PAGE of it, and in the action cluster such launchers sat as
+     * labelled, outlined buttons among the record's bare-icon verbs, navigation
+     * mixed into actions.
      */
     InsertedViewLauncherPlacement["RECORD_NAVIGATION"] = "record_navigation";
     /**
@@ -44,7 +45,7 @@ export var InsertedViewLauncherPlacement;
  * the host page only knows where each placement renders.
  */
 export const InsertedViewLauncherConfigSchema = z.object({
-    /** Where the launcher sits. Defaults to {@link InsertedViewLauncherPlacement.ACTION_BAR}. */
+    /** Where the launcher sits. Defaults to {@link InsertedViewLauncherPlacement.RECORD_NAVIGATION}. */
     placement: z.enum(InsertedViewLauncherPlacement).optional(),
     /**
      * Promote the launcher visually (a filled button) instead of the quiet
@@ -60,7 +61,7 @@ export const InsertedViewLauncherConfigSchema = z.object({
 });
 /** Framework defaults applied when a view authors no launcher config. */
 export const DEFAULT_INSERTED_VIEW_LAUNCHER = {
-    placement: InsertedViewLauncherPlacement.ACTION_BAR,
+    placement: InsertedViewLauncherPlacement.RECORD_NAVIGATION,
     emphasized: false,
     showLabel: true,
 };

package/dist/esm/core/config/inserted-view-launcher.schemas.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"inserted-view-launcher.schemas.js","sourceRoot":"","sources":["../../../../../src/core/config/inserted-view-launcher.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AACH,MAAM,CAAN,IAAY,~~6BA6BX~~;~~AA7BD~~,WAAY,6BAA6B;IACvC~~;;;;;;;;OAQG~~;IACH,0DAAyB,CAAA;IAEzB~~;;;;;;;OAOG~~;IACH,wEAAuC,CAAA;IAEvC;;;;;OAKG;IACH,8DAA6B,CAAA;AAC/B,CAAC,~~EA7BW~~,6BAA6B,KAA7B,6BAA6B,~~QA6BxC~~;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,~~6FAA6F~~;~~IAC7F~~,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC,QAAQ,EAAE;IAC3D;;;OAGG;IACH,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAClC;;;;OAIG;IACH,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAIH,yEAAyE;AACzE,MAAM,CAAC,MAAM,8BAA8B,GAAyC;IAClF,SAAS,EAAE,6BAA6B,CAAC,~~UAAU~~;~~IACnD~~,UAAU,EAAE,KAAK;IACjB,SAAS,EAAE,IAAI;CAChB,CAAC;AAEF,mFAAmF;AACnF,MAAM,UAAU,iCAAiC,CAC/C,QAAgD;IAEhD,OAAO;QACL,SAAS,EAAE,QAAQ,EAAE,SAAS,IAAI,8BAA8B,CAAC,SAAS;QAC1E,UAAU,EAAE,QAAQ,EAAE,UAAU,IAAI,8BAA8B,CAAC,UAAU;QAC7E,SAAS,EAAE,QAAQ,EAAE,SAAS,IAAI,8BAA8B,CAAC,SAAS;KAC3E,CAAC;AACJ,CAAC","sourcesContent":["import { z } from 'zod';\n\n/*\n WHERE a resource-owned view's launcher sits on the record page.\n \n A composite workspace or execution runner is another VIEW of the record the\n * reader is already on, so its entry point is a navigation affordance — and a\n * record page has three honest places to put one. The right choice depends on\n * how central the view is to working with that record, which only the resource\n * author knows, so it is authored rather than fixed by the framework.\n /\nexport enum InsertedViewLauncherPlacement {\n /\n ~~Default.~~ A button in the record's action cluster, beside the record's\n * ~~own operations~~ (edit / archive / delete)~~, carrying its label~~.\n \n ~~This~~ is ~~where~~ a ~~reader~~ ~~looks~~ ~~for~~ \"things I ~~can~~ do with ~~this~~ record\~~", and an\~~n * ~~alternate~~ ~~view~~ of ~~the~~ ~~record~~ is ~~one~~ of ~~those things~~. Pair with\n * ~~`emphasized`~~ when ~~the~~ view is a primary way of working with the record~~\n * rather than an occasional detour~~.\n /\n ACTION_BAR = 'action_bar',\n\n /\n A quiet ruled strip directly under the record header — record-level\n * secondary navigation, the position mature record UIs use for ~~sibling views~~\n * of one entity.\n \n ~~Prefer~~ ~~this~~ ~~over~~ ~~{@link~~ ~~ACTION_BAR}~~ ~~when~~ ~~there~~ ~~are~~ ~~SEVERAL~~ ~~such~~ ~~views~~ ~~and~~\n * ~~they~~ ~~read~~ as ~~peers~~ of the record's ~~main~~ ~~page~~ ~~rather~~ ~~than~~ as actions.\n /\n RECORD_NAVIGATION = 'record_navigation',\n\n /\n A standalone card in the content flow, after the record's fields.\n \n For a view that is genuinely secondary — worth offering, not worth spending\n * header space on.\n /\n CONTENT_CARD = 'content_card',\n}\n\n/\n How a resource-owned view's launcher is presented.\n \n Authored on the view declaration because the view knows its own importance;\n * the host page only knows where each placement renders.\n /\nexport const InsertedViewLauncherConfigSchema = z.object({\n /* Where the launcher sits. Defaults to {@link InsertedViewLauncherPlacement.~~ACTION_BAR~~}. /\n placement: z.enum(InsertedViewLauncherPlacement).optional(),\n /\n Promote the launcher visually (a filled button) instead of the quiet\n * default. Use for a view that is a primary way of working with the record.\n /\n emphasized: z.boolean().optional(),\n /\n Render the view's label beside its icon. Default `true` — an icon-only\n * launcher for a view with no conventional glyph is a guessing game, and\n * these views are rare enough that the words are affordable.\n /\n showLabel: z.boolean().optional(),\n});\n\nexport type InsertedViewLauncherConfig = z.infer<typeof InsertedViewLauncherConfigSchema>;\n\n/* Framework defaults applied when a view authors no launcher config. /\nexport const DEFAULT_INSERTED_VIEW_LAUNCHER: Required<InsertedViewLauncherConfig> = {\n placement: InsertedViewLauncherPlacement.~~ACTION_BAR~~,\n emphasized: false,\n showLabel: true,\n};\n\n/* Resolve an authored (possibly partial) launcher config against the defaults. */\nexport function resolveInsertedViewLauncherConfig(\n authored: InsertedViewLauncherConfig \| undefined,\n): Required<InsertedViewLauncherConfig> {\n return {\n placement: authored?.placement ?? DEFAULT_INSERTED_VIEW_LAUNCHER.placement,\n emphasized: authored?.emphasized ?? DEFAULT_INSERTED_VIEW_LAUNCHER.emphasized,\n showLabel: authored?.showLabel ?? DEFAULT_INSERTED_VIEW_LAUNCHER.showLabel,\n };\n}\n"]}
1	+ {"version":3,"file":"inserted-view-launcher.schemas.js","sourceRoot":"","sources":["../../../../../src/core/config/inserted-view-launcher.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AACH,MAAM,CAAN,IAAY,6BA8BX;AA9BD,WAAY,6BAA6B;IACvC;;;;;;;OAOG;IACH,0DAAyB,CAAA;IAEzB;;;;;;;;;OASG;IACH,wEAAuC,CAAA;IAEvC;;;;;OAKG;IACH,8DAA6B,CAAA;AAC/B,CAAC,EA9BW,6BAA6B,KAA7B,6BAA6B,QA8BxC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,oGAAoG;IACpG,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC,QAAQ,EAAE;IAC3D;;;OAGG;IACH,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAClC;;;;OAIG;IACH,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAIH,yEAAyE;AACzE,MAAM,CAAC,MAAM,8BAA8B,GAAyC;IAClF,SAAS,EAAE,6BAA6B,CAAC,iBAAiB;IAC1D,UAAU,EAAE,KAAK;IACjB,SAAS,EAAE,IAAI;CAChB,CAAC;AAEF,mFAAmF;AACnF,MAAM,UAAU,iCAAiC,CAC/C,QAAgD;IAEhD,OAAO;QACL,SAAS,EAAE,QAAQ,EAAE,SAAS,IAAI,8BAA8B,CAAC,SAAS;QAC1E,UAAU,EAAE,QAAQ,EAAE,UAAU,IAAI,8BAA8B,CAAC,UAAU;QAC7E,SAAS,EAAE,QAAQ,EAAE,SAAS,IAAI,8BAA8B,CAAC,SAAS;KAC3E,CAAC;AACJ,CAAC","sourcesContent":["import { z } from 'zod';\n\n/*\n WHERE a resource-owned view's launcher sits on the record page.\n \n A composite workspace or execution runner is another VIEW of the record the\n * reader is already on, so its entry point is a navigation affordance — and a\n * record page has three honest places to put one. The right choice depends on\n * how central the view is to working with that record, which only the resource\n * author knows, so it is authored rather than fixed by the framework.\n /\nexport enum InsertedViewLauncherPlacement {\n /\n A button in the record's action cluster, beside the record's own operations\n * (edit / archive / delete).\n \n Choose it for a view that IS one of the things a reader does with the record\n * — a runner, a wizard — rather than another page of it. Pair with `emphasized`\n * when that view is a primary way of working with the record.\n /\n ACTION_BAR = 'action_bar',\n\n /\n Default. A quiet ruled strip directly under the record header —\n * record-level secondary navigation, the position mature record UIs use for\n * sibling views of one entity.\n \n The default since 2026-10-01: a composite workspace or a list view of the\n * record is another PAGE of it, and in the action cluster such launchers sat as\n * labelled, outlined buttons among the record's bare-icon verbs, navigation\n * mixed into actions.\n /\n RECORD_NAVIGATION = 'record_navigation',\n\n /\n A standalone card in the content flow, after the record's fields.\n \n For a view that is genuinely secondary — worth offering, not worth spending\n * header space on.\n /\n CONTENT_CARD = 'content_card',\n}\n\n/\n How a resource-owned view's launcher is presented.\n \n Authored on the view declaration because the view knows its own importance;\n * the host page only knows where each placement renders.\n /\nexport const InsertedViewLauncherConfigSchema = z.object({\n /* Where the launcher sits. Defaults to {@link InsertedViewLauncherPlacement.RECORD_NAVIGATION}. /\n placement: z.enum(InsertedViewLauncherPlacement).optional(),\n /\n Promote the launcher visually (a filled button) instead of the quiet\n * default. Use for a view that is a primary way of working with the record.\n /\n emphasized: z.boolean().optional(),\n /\n Render the view's label beside its icon. Default `true` — an icon-only\n * launcher for a view with no conventional glyph is a guessing game, and\n * these views are rare enough that the words are affordable.\n /\n showLabel: z.boolean().optional(),\n});\n\nexport type InsertedViewLauncherConfig = z.infer<typeof InsertedViewLauncherConfigSchema>;\n\n/* Framework defaults applied when a view authors no launcher config. /\nexport const DEFAULT_INSERTED_VIEW_LAUNCHER: Required<InsertedViewLauncherConfig> = {\n placement: InsertedViewLauncherPlacement.RECORD_NAVIGATION,\n emphasized: false,\n showLabel: true,\n};\n\n/* Resolve an authored (possibly partial) launcher config against the defaults. */\nexport function resolveInsertedViewLauncherConfig(\n authored: InsertedViewLauncherConfig \| undefined,\n): Required<InsertedViewLauncherConfig> {\n return {\n placement: authored?.placement ?? DEFAULT_INSERTED_VIEW_LAUNCHER.placement,\n emphasized: authored?.emphasized ?? DEFAULT_INSERTED_VIEW_LAUNCHER.emphasized,\n showLabel: authored?.showLabel ?? DEFAULT_INSERTED_VIEW_LAUNCHER.showLabel,\n };\n}\n"]}