npm - @wildo-ai/saas-frontend-lib - Versions diffs - 1.1.3 → 1.1.5 - Mend

@wildo-ai/saas-frontend-lib 1.1.3 → 1.1.5

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 (2521) hide show

package/dist/esm/core/resources/resources.frontend.schemas.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"resources.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/resources/resources.frontend.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { RESPONSIVE_MAX_WIDTH_VALUES } from '@wildo-ai/presets-components-models';\nimport type React from 'react';\nimport { z } from \"zod\";\nimport type { EnumLikeType, IconLike, AutosaveFieldParams, ValidationMode, ResponsiveAware, EditChromeMode, DisplayChromeMode, DraftableConfigParams } from '@wildo-ai/zod-decorators';\nimport { getZodObjectShape } from '@wildo-ai/zod-decorators';\nimport type { ButtonVariants_Variant } from '~wildo-frontend-lib/components/actions/button';\nimport type { QuickSwitcherScopeField } from '~wildo-frontend-lib/core/config/app-configuration-frontend.schemas';\nimport {\n ResourceParentResourceRequirement,\n ResourcePrimaryScope,\n ResourceRelationship,\n ResourceTranspositionPolicy,\n CoreResourceOperation,\n ResourceOperationDisplayMode,\n ResourceOperationFrontendSurface,\n ResourceFieldIdentifier,\n ResourceType,\n ResourceTypeSchema,\n ResourceConfiguration_Operation_ApiCall,\n ResourceConfiguration_Operation_ApiCallWithCallback,\n ResourceConfiguration_ResourceRelationships,\n ResourceConfiguration_InheritanceSchemaDefinition,\n TourStepPlacement,\n NavigationZoneName,\n OverlayAppearance,\n SplitAppearance,\n TransitionConfigSchema,\n ZoneEmptyBehavior,\n viewportDiscriminatedSchema,\n computePolymorphicVariantSchemas,\n} from '@wildo-ai/saas-models';\nimport type {\n ResourceConfiguration,\n ResourceConfiguration_InitializationFactory,\n ValidOperationKeys,\n RelationshipDisplayInParentNavigation,\n RelationshipDisplayInChildView,\n} from '@wildo-ai/saas-models';\nimport type { InsertedChartDeclaration } from '~wildo-frontend-lib/core/config/chart-view.frontend.schemas';\nimport type {\n InsertedExecutionDeclaration,\n ResourceExecutionViewsConfig,\n} from '~wildo-frontend-lib/core/config/execution-view.schemas';\nimport type {\n OnboardingElementType,\n GuidanceRenderMode,\n GuidanceFlowScope,\n GuidanceAudience,\n NotificationBadgeDefinition,\n UserNotificationDefinition,\n SubtreeMap,\n ManyToManyScopeJunctionMap,\n} from '@wildo-ai/saas-models';\nimport { ViewportBreakpoint, DisplayDirection } from '@wildo-ai/zod-decorators';\nimport type {\n CorePresetNames,\n ActionLabelDisplayMode,\n} from '@wildo-ai/presets-components-models';\nimport {\n VerticalPlacement,\n HorizontalPlacement,\n} from '@wildo-ai/presets-components-models';\nimport type {\n CompositeViewComponentProps,\n InsertedCompositeDeclaration,\n ResourceCompositeViewAuthoringConfig,\n} from '../config/composite-view.schemas';\n\n\n\n// ================================================================================================\n// Types transferred from saas-models/config/frontend/navigation.shared.schemas.ts\n// NavigationOperationOverrideSchema only — the rest of navigation stays in saas-models.\n// ================================================================================================\n\n/*\n @wildo_source:part:start saas.frontend.navigation.operation-override facet:layer:frontend facet:family:navigation-config\n \n Per-operation navigation chrome: transition, overlay/split appearance, source zone.\n \n How to use: attach fragments of this shape under\n * `ResourceOperationFrontendConfig.navigationOverrides` in `resourceUIBehavior()`.\n * Each override applies when navigating from the configured zone/viewport into\n * this operation. Prefer mirroring a sibling resource that already matches the\n * product’s overlay vs split behavior.\n /\nexport const NavigationOperationOverrideSchema = z.object({\n transition: TransitionConfigSchema,\n appearance: viewportDiscriminatedSchema(z.union([\n z.enum(OverlayAppearance),\n z.enum(SplitAppearance),\n ])).optional(),\n fromZone: z.union([z.enum(NavigationZoneName), z.literal('appLevel')]).optional(),\n viewport: z.enum(ViewportBreakpoint).optional(),\n /\n Behaviour of the OVERLAY this override resolves to — whether the page behind stays interactive,\n * whether touching it dismisses, whether it is dimmed. Ignored for non-overlay transitions.\n \n These three were already declared on `OverlayContainerConfig` with documented defaults and read by\n * nothing; they are honoured now, and this is the channel that lets a NAVIGATION-driven overlay set\n * them. Declared per operation because it describes the CONTENT: an application legitimately has a\n * create dialog that blocks everything and a detail sheet beside a live canvas that blocks nothing.\n /\n overlayBehavior: z.object({\n modal: z.boolean().optional(),\n closeOnOutsideClick: z.boolean().optional(),\n showBackdrop: z.boolean().optional(),\n }).optional(),\n});\nexport type NavigationOperationOverride = z.infer<typeof NavigationOperationOverrideSchema>;\n/* @wildo_source:part:end saas.frontend.navigation.operation-override /\n\n\n// ================================================================================================\n// Types transferred from saas-models/resources/resource-frontend.shared.schemas.ts\n// Strictly identical signatures — canonical home is now saas-frontend-lib.\n// ================================================================================================\n\n// --------------------------------\n// App Scope Field Types\n// --------------------------------\n\n/\n Runtime-resolved scope field definition.\n \n Extends the config-declared `QuickSwitcherScopeField` (from top-level\n * `appScope.fields`) with properties resolved at initialization time from the\n * resource registry.\n \n Created by AppScopeContext from the `appScope.fields` configuration.\n /\nexport interface AppScopeFieldDefinition extends QuickSwitcherScopeField {\n /* Resolved from the resource configuration at initialization /\n resourcePrimaryScope: ResourcePrimaryScope;\n}\n\n\n// --------------------------------\n// Frontend Resource Path Schemas\n// Defined in resource-path.frontend.schemas.ts (import here only — no re-export).\n// --------------------------------\n\nimport { FrontendResourceOperationPathSchema } from './resource-path.frontend.schemas';\nimport type { FrontendResourceOperationPath, FrontendResource_ParentResourceRequirement } from './resource-path.frontend.schemas';\n\n\n// --------------------------------\n// Frontend-Specific Operation Types\n// --------------------------------\n\n/\n Resolved operation row the frontend registry stores: same structural operation\n * config as `@wildo-ai/saas-models` (API_CALL / callback variants) plus optional\n * `operationFrontendConfig` from the app preset.\n \n How to use: app authors normally do not construct this type by hand —\n * `buildFrontendResourceConfigurations()` merges backend `ResourceConfiguration`\n * with `ResourceUIBehavior`. Use it when typing hooks/components that receive the\n * merged registry (e.g. operation context, launcher resolution).\n /\ntype FrontendResourceOperation_Base = {\n /\n Frontend UI behavior config for this operation, carrying its `surface`\n * ({@link ResourceOperationFrontendSurface}). After `buildFrontendResourceConfigurations`\n * runs, EVERY operation has a resolved config: preset-surfaced operations get\n * their authored config; everything else resolves to `{ surface: API_ONLY }`\n * (headless) from the operation's `defaultFrontendPosture` or the default.\n * The field stays optional only for the pre-resolution / partial-mock case —\n * read the surface via `isOperationAddressable()` / `isOperationHeadless()`,\n * never by testing presence.\n /\n operationFrontendConfig?: ResourceOperationFrontendConfig;\n}\n\nexport type FrontendResourceConfiguration_Operation<\n TCustomOperationEnum extends EnumLikeType \| undefined = any,\n TCoreOperationEnum extends Partial<CoreResourceOperation> \| undefined = any,\n TMainSchema extends z.ZodTypeAny = z.ZodAny,\n> = (\n \| ResourceConfiguration_Operation_ApiCall<TCustomOperationEnum, TCoreOperationEnum, TMainSchema>\n \| ResourceConfiguration_Operation_ApiCallWithCallback<TCustomOperationEnum, TCoreOperationEnum, TMainSchema>\n) & FrontendResourceOperation_Base;\n\n/\n Full merged resource row in the frontend registry: backend fields (scope, schema,\n * relationships, operations) plus optional `frontendConfiguration` (labels, layout,\n * views map, guidance, …) derived from the app’s `ResourceUIBehavior` preset.\n \n How to use: read-only shape at runtime and in typed frontend services. Authoring\n * happens in `.resources-config.ts` + `.ui-behavior.tsx`, not by filling this object\n * manually.\n /\nexport type FrontendResourceConfiguration<\n TCustomOperationEnum extends EnumLikeType \| undefined = any,\n TCoreOperationEnum extends Partial<CoreResourceOperation> \| undefined = any,\n TMainSchema extends z.ZodTypeAny = z.ZodAny,\n> = {\n isDisabled: boolean;\n resourcePrimaryScope: ResourcePrimaryScope;\n resourceIdentifier: ResourceType;\n resourceFieldIdentifier: ResourceFieldIdentifier;\n coreOperations: TCoreOperationEnum[];\n customOperation?: TCustomOperationEnum;\n mainSchema: TMainSchema;\n resourceRelationships: ResourceConfiguration_ResourceRelationships;\n inheritenceSchemaDefinition?: ResourceConfiguration_InheritanceSchemaDefinition<EnumLikeType, TMainSchema>;\n frontendConfiguration?: ResourceUIBehaviorResourceLevelConfig<TCustomOperationEnum, TCoreOperationEnum, TMainSchema>;\n isSystemResource: boolean;\n /\n Mirrors `ResourceConfiguration.primaryKeyIdentifiesInitiator` from `@wildo-ai/saas-models`.\n * `buildFrontendResourceConfigurations` spreads the backend config onto every frontend\n * registry entry, so this is always populated at runtime; it must stay declared here too\n * so shared `saas-models` utils typed against `AnyResourceConfiguration` (e.g.\n * `ResourcesConfigOperationsUrlsBuilderUtils`) accept a frontend registry entry.\n /\n primaryKeyIdentifiesInitiator: boolean;\n isAnonymizable: boolean;\n transpositionPolicy: ResourceTranspositionPolicy;\n operations: FrontendResourceConfiguration_Operation<TCustomOperationEnum, TCoreOperationEnum, TMainSchema>[];\n}\n\nexport type AnyFrontendResourceConfiguration = FrontendResourceConfiguration<any, any, any>;\n\n/\n Application frontend resource registry built at startup (field-id maps, relationships,\n * notification defs, subtree map, and per-resource `FrontendResourceConfiguration`).\n \n How to use: consume via React context / services (`ResourcesRepository`, routing,\n * layout hosts). Authors extend it indirectly by registering presets and module wiring —\n * not by mutating this object ad hoc.\n /\nexport type FrontendResourcesRegistry = {\n allResourceFieldIdentifiers: Record<string, string>;\n fieldIdentifierToResourceType: Record<string, ResourceType>;\n /\n Scope-required reference-search junctions, keyed by `${target}\|${scope}`.\n * Drives the inference-based people-picker: a FK targeting `T` from a resource\n * scoped by `S`, where `T ↔ S` is an M:N via junction `J`, searches `T` scoped\n * to the caller's current `S` through `J`. Mirrors the backend registry.\n \n OPTIONAL: the real registry builder always populates it, but partial test\n * registries omit it — consumers (e.g. `useResourceSearch`) treat an absent map\n * as \"no junction scoping\" (plain target search).\n /\n manyToManyScopeJunctions?: ManyToManyScopeJunctionMap;\n notificationBadgeDefinitions: NotificationBadgeDefinition[];\n additionalUserNotificationDefinitions: UserNotificationDefinition[];\n resourceRelationships: ResourceRelationship[];\n resourceConfigurations: {\n [key: ResourceType]: AnyFrontendResourceConfiguration;\n };\n subtreeMap: SubtreeMap;\n}\n\n\n// ================================================================================================\n// Original resources.frontend.schemas.ts content\n// ================================================================================================\n\n/\n Everything the framework knows about the current resource operation while rendering\n * a layout host (read/update/list/custom view, nested child, etc.).\n \n How to use: custom templates and views receive compatible props via framework\n * hooks; use `contextResourceIdentifiers` for parent/child route params and FK scope.\n * `operation` is the merged backend operation + `operationFrontendConfig` — prefer it\n * over guessing URLs or variant keys. `parentResourcesRequirements` repeats path\n * requirements from routing for hosts that must validate scope before fetch.\n /\nexport interface FrontendResourceOperationContext extends FrontendResourceOperationPath {\n /* Current operation being executed /\n resourceType: string;\n\n /* The operation configuration - properly typed /\n operation: FrontendResourceConfiguration_Operation;\n\n /* Resource context map: ResourceType -> resourceId \| {fieldIdentifier, resourceId} /\n contextResourceIdentifiers: Record<string,\n \| string\n \| { fieldIdentifier: string; resourceId: string; }\n >;\n\n /* Additional context data that can be passed /\n additionalContext?: Record<string, unknown>;\n\n /* Parent resource requirements - explicitly included from FrontendResourceOperationPath /\n parentResourcesRequirements: FrontendResource_ParentResourceRequirement[];\n}\n\n/* ──────────────────────────────────────────────────────────────\n * Internal Schemas (concrete, for method access)\n * ────────────────────────────────────────────────────────────── /\n\nexport const FrontendResourceOperationContextSchema = FrontendResourceOperationPathSchema.extend({\n // operation is typed as z.any() in schema — the FrontendResourceOperationContext interface\n // provides proper typing (FrontendResourceConfiguration_Operation) for compile-time consumers\n operation: z.any(),\n contextResourceIdentifiers: z.record(z.string(), z.union([\n z.string(),\n z.object({\n fieldIdentifier: z.string(),\n resourceId: z.string()\n })\n ])),\n additionalContext: z.record(z.string(), z.unknown()).optional(),\n});\n\n\n/\n Frontend-native resource configuration types.\n \n Defines the complete frontend configuration for resources and their operations,\n * independent of app type. This replaces the legacy per-app discriminated\n * `ResourceOperationFrontendConfig`.\n \n The resource-level fields (labels, sections, views, empty state, guidance) are\n * written to `FrontendResourceConfiguration.frontendConfiguration` during registry\n * build. The `views` sub-field provides per-operation frontend config — giving\n * a single, self-contained definition of how each resource appears and behaves in\n * a given frontend application.\n \n How to use (authoring): in app code, build a `ResourceUIBehavior` map with\n * `resourceUIBehavior(factory, schema, callback)` and merge presets; the framework\n * compiles that into `FrontendResourceConfiguration` entries. The types below\n * (`ResourceUIBehavior_EmptyState`, `ResourceLayoutConfig`, …) are the pieces you\n * pass inside that callback’s return value.\n /\n\n\n\n// ── Resource frontend config sub-types ──────────────────────────────\n\n/* Secondary action type for empty state (link to URL vs guidance flow). /\nexport enum ResourceFrontend_EmptyStateSecondaryActionType {\n LINK = 'link',\n GUIDANCE = 'guidance',\n}\n\n/* Trigger type for resource-level guidance flows. /\nexport enum ResourceFrontend_GuidanceFlowTriggerType {\n FIRST_VISIT = 'FIRST_VISIT',\n MANUAL = 'MANUAL',\n DELAYED = 'DELAYED',\n EVENT = 'EVENT',\n}\n\n/\n Empty state configuration for list/table views when no items exist.\n * Labels (title, description, primaryActionLabel) come from i18n.\n \n @example\n * ```\n * emptyState: {\n * icon: 'inbox',\n * primaryAction: CoreResourceOperation.CREATE,\n * secondaryAction: { type: ResourceFrontend_EmptyStateSecondaryActionType.LINK, target: 'https://docs.example.com/projects' },\n * }\n * ```\n /\nexport interface ResourceUIBehavior_EmptyState {\n /* Icon ref from the icon registry. If not provided, uses a default empty-state icon. /\n icon?: string;\n /\n Operation ref for the primary CTA (e.g., `CoreResourceOperation.CREATE`).\n * If not provided, auto-detects CREATE from available operations.\n * Set to `false` to explicitly disable the primary action button.\n /\n primaryAction?: string \| false;\n /* Secondary action — link to docs, guidance flow, or external URL. /\n secondaryAction?: {\n type: ResourceFrontend_EmptyStateSecondaryActionType;\n target: string;\n };\n}\n/\n Single guidance element within a resource-level guidance flow.\n * Maps to an OnboardingElement during compilation.\n /\nexport interface ResourceFrontend_GuidanceElement {\n type: OnboardingElementType;\n ref: string;\n targetField?: string;\n targetSelector?: string;\n placement?: TourStepPlacement;\n actionRef?: string;\n steps?: Array<{ ref: string; targetField?: string; targetSelector?: string; placement?: TourStepPlacement }>;\n questions?: Array<{ id: string; type: string; required?: boolean; options?: Array<{ ref: string; value?: string }> }>;\n}\n\n/\n Resource-level guidance flow declaration.\n * Compiled into a standard `GuidanceFlowDefinition` by the guidance-resource-compiler.\n /\nexport interface ResourceUIBehavior_GuidanceFlow {\n ref: string;\n bindToOperation: string;\n renderMode: GuidanceRenderMode;\n trigger: {\n type: ResourceFrontend_GuidanceFlowTriggerType;\n delayMs?: number;\n eventName?: string;\n };\n scope?: GuidanceFlowScope;\n audience?: GuidanceAudience;\n priority?: number;\n elements: ResourceFrontend_GuidanceElement[];\n}\n\n// ── Operation key ───────────────────────────────────────────────────\n\n/\n @wildo_source:part:start saas.frontend.operation-key-and-resource-config-like facet:layer:frontend facet:family:resource-ui\n \n Key identifying a resource operation in the frontend preset.\n \n - `string` — default operation (e.g., `CoreResourceOperation.READ`)\n * - `readonly [string, string]` — non-default variant: `[operationIdentifier, variantKey]`\n * (e.g., `[CoreResourceOperation.READ, 'admin']`)\n \n The same extracted span also includes `FRONTEND_SCHEMA_KEY`, `ObjectShape`,\n * `ResourceConfigLike`, and `TypedOperationKey` — the schema bridge and typed\n * operation keys used by `resourceUIBehavior()` inference.\n /\nexport type OperationKey = string \| readonly [string, string];\n\n\n// ── Schema bridge key ───────────────────────────────────────────────\n\n/\n Symbol key used internally by `resourceUIBehavior()` to attach the schema\n * reference to the config object, and by `buildFrontendResourceConfigurations()`\n * to extract it. Using a Symbol prevents collision with user-defined properties\n * and is invisible in Object.keys()/JSON serialization.\n /\nexport const FRONTEND_SCHEMA_KEY: unique symbol = Symbol('frontendSchema');\n\n\n// ── Typed helper types ──────────────────────────────────────────────\n\n/* Extracts the typed shape from a ZodObject, falls back to Record for non-objects. /\nexport type ObjectShape<T extends z.ZodTypeAny> =\n T extends z.ZodObject<infer S> ? S : Record<string, z.ZodTypeAny>;\n\n/\n Accepts both factory functions and configuration instances for type inference.\n * Used by `resourceUIBehavior()` to infer generics from either form.\n /\nexport type ResourceConfigLike<\n TCustomOp extends EnumLikeType \| undefined,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined,\n TSchema extends z.ZodTypeAny,\n> = ResourceConfiguration<TCustomOp, TCoreOp, TSchema>\n \| ResourceConfiguration_InitializationFactory<TCustomOp, TCoreOp, TSchema>;\n\n/\n Typed operation key — extends `ValidOperationKeys` with variant tuple support.\n * When both generics default to `any`, collapses to `any` — backward compatible\n * with untyped `OperationKey` usage.\n /\nexport type TypedOperationKey<\n TCustomOp extends EnumLikeType \| undefined = any,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined = any,\n> = ValidOperationKeys<TCustomOp, TCoreOp> \| readonly [ValidOperationKeys<TCustomOp, TCoreOp>, string];\n/* @wildo_source:part:end saas.frontend.operation-key-and-resource-config-like /\n\n// ── Operation-level frontend config ─────────────────────────────────\n\n/\n @wildo_source:part:start saas.frontend.resource-operation-frontend-config facet:layer:frontend facet:family:resource-ui\n \n How a resource collection renders its items (cards vs table). A FRONTEND\n * presentation vocabulary — authored on a LIST/SEARCH operation's\n * `collectionDisplayConfig` (below) in the resource UI behavior, NEVER on the\n * shared resources-config operation: the backend has no notion of cards-vs-table.\n * The string values are the persisted view-mode keys, so a stored user choice\n * reads straight across.\n \n @example\n * // resource UI behavior `views` entry:\n * [Op.LIST, { collectionDisplayConfig: { displayMode: CollectionDisplayMode.TABLE, userSwitchableDisplayMode: true } }]\n /\nexport enum CollectionDisplayMode {\n /* Stacked cards — one row per item via `ResourceListItemRenderer`. /\n CARDS = 'cards',\n /* Dense table — one column per summary field via the table body. /\n TABLE = 'table',\n}\n\n/\n How CARDS-mode items are arranged. Orthogonal to {@link CollectionDisplayMode}\n * (this only shapes the CARDS body; TABLE ignores it). LIST and GRID are kept as\n * DISTINCT layouts, not a `columns: 1` collapse — a list is bordered rows sharing\n * one container (`divide-y`), a grid is separated card cells in N responsive\n * columns.\n /\nexport enum CardLayoutStyle {\n /* Bordered rows in a single shared container (the classic stacked list). /\n LIST = 'list',\n /* Separated card cells laid out in an N-column responsive grid. /\n GRID = 'grid',\n}\n/* @wildo_source:part:end saas.frontend.resource-operation-frontend-config /\n\n/\n @wildo_source:part:start saas.frontend.resource-operation-frontend-config facet:layer:frontend facet:family:resource-ui\n \n Frontend configuration for a single resource operation.\n \n Controls how the operation is surfaced in the frontend:\n * - `surface` — the operation's frontend surface: `ADDRESSABLE` (routable page),\n * `EMBEDDED` (non-addressable view rendered within a host: overlay, composite, or\n * nested), or `API_ONLY` (headless — no interface, callable as an API). See\n * `ResourceOperationFrontendSurface`.\n * - `customView` — direct UIBehavior-owned React component override for authored custom operation views.\n * Use the exported operation-family component types (`ResourceReadCustomViewComponent`,\n * `ResourceListCustomViewComponent`, etc.) plus the matching\n * `useReadOperationSurface()` / `useListOperationSurface()` helpers when you\n * want a strongly truthful custom host for a specific layout family.\n * - `displayPresetOverride` — layout preset override for the operation's UI\n * - `navigationOverrides` — per-operation navigation transition overrides\n * - `displayPriority` — visual ordering in ActionBar/operation lists (lower = higher priority)\n * - `iconOverride` — per-operation icon ref (overrides resource-level icon in navigation items)\n * - `collectionDisplayConfig` — for LIST/SEARCH collection operations: the default\n * cards-vs-table body (`displayMode`) and whether the user may toggle it\n * (`userSwitchableDisplayMode`, persisted per resource type); the CARDS\n * arrangement (`cardLayout` — LIST vs N-column GRID); where each card's action\n * buttons sit (`cardActionPlacement` — 2-axis anchor + orientation); and\n * whether items are selectable for bulk actions (`selectable`). Pure frontend\n * presentation; the backend never reads it.\n \n Resource-owned inserted views are NOT configured here. Composite, chart,\n * and execution views declared on the resource UI behavior surface themselves\n * into their targeted operation host directly, via their own canonical fields:\n * `compositeViews[].operationLike` / `chartViews[].operationLike` (single)\n * and `executionViews[].surfaceInOperations` (list). The layout consumer\n (`ResourceLayout_InsertedViews`) reads those declarations and filters them\n * by the current operation at render time — there is no operation-level\n * view-ref list to author or compile.\n \n Historical note (search hit): earlier versions of this schema exposed an\n * `additionalViews: ResourceViewRef[]` (and before that `additionalViewLinks:\n * string[]`) operation-level field that authored which resource-owned views\n * surfaced in this operation. That field was removed in the\n * `resource-owned-view-surfacing-contract.md` workstream because it duplicated\n * the per-view declaration sites (`compositeViews`, `chartViews`,\n * `executionViews`) and could silently disagree with them. If you are looking\n * for `additionalViews` because a doc, comment, prompt, or downstream code\n * still references it, the answer is: declare the surface on the view itself\n * (use `operationLike` for composite/chart, `surfaceInOperations` for\n * execution), do not re-introduce an operation-level seam.\n /\n/\n How an operation's ACTION (its action-bar button) is surfaced in this application.\n \n A per-app, display-only axis — backend authorization is unaffected, roles\n * remain the only security authority, so this never makes an operation reachable\n * that wasn't already; it only governs the button.\n /\nexport enum ActionVisibility {\n /* Always shown; rendered DISABLED when its `enabledCondition` is unmet. The default. /\n ALWAYS = 'always',\n /\n Never shown — this app declares the operation's action off for this surface.\n \n Invariant: do NOT pair with a visible (addressable) view for the same operation.\n * The action is the entry point to the view, so a visible view whose action is\n * hidden is contradictory — there is no way to reach it. Hiding the action removes\n * the operation, and the path to any view it has, from this app's UI.\n /\n HIDDEN = 'hidden',\n /\n Shown ONLY when its `enabledCondition` is met; HIDDEN (not disabled) otherwise.\n \n For state-conditional operations whose disabled state is just noise — e.g.\n * organization `ACTIVATE` appears on a suspended org but vanishes on an active one,\n * rather than sitting there greyed out.\n /\n WHEN_AVAILABLE = 'when_available',\n}\n\n/\n Where an operation's ACTION sits in the action bar for this application.\n \n A per-app, display-only layout axis, orthogonal to authorization. When\n * omitted, placement is DERIVED from the operation's `riskLevel`: HIGH/CRITICAL\n * operations default to `DANGER_ZONE`, everything else to `PRIMARY`. Set it\n * explicitly to override that default — e.g. tuck a non-risky-but-rare action\n * into the danger zone, or keep a CRITICAL action inline in a dedicated admin\n * tool. The same axis drives the bulk action bar, since both are built from the\n * same operation pipeline.\n /\nexport enum ActionPlacement {\n /* Inline in the main action group. The default for low/medium-risk operations. /\n PRIMARY = 'primary',\n /\n Segregated into a trailing \"danger zone\" group, fenced off by a separator,\n * after every PRIMARY action. The default for HIGH/CRITICAL-risk operations\n * (destructive deletes, lifecycle suspends).\n /\n DANGER_ZONE = 'danger_zone',\n}\n\n/\n HOW an operation's action collects its input and shows its result — the chrome the user meets\n * when they click the button.\n \n ## Why this axis exists\n \n Until this axis, one rule decided the answer for every custom operation:\n * has a `requestDto` ⇒ navigate. So an action asking for a single reason string got the same\n * full-page treatment as a multi-step wizard, and the only way out was to author\n * `navigationOverrides` — per operation, in terms of a zone, a transition verb and an appearance.\n * Three concepts to answer one question.\n \n This is that one question. It is a display-only axis: backend authorization is untouched and\n * `roles` remain the only security authority, exactly like its siblings {@link ActionVisibility},\n * {@link ActionPlacement} and {@link ResourceOperationActionScope}.\n \n ## It is an ALIAS, not a parallel mechanism\n \n `MODAL` and `PAGE` do not render anything themselves — they resolve to the navigation transitions\n * that already exist (`OVERLAY`, and the ordinary chain), so there is one runtime mechanism and one\n * set of zone/appearance/URL semantics. `DIRECT`, `POPOVER` and `INLINE` never enter navigation at\n * all, because none of them is a destination: nothing is pushed, no zone changes, and there is\n * nothing for a back button to pop. `INLINE` is hosted by the collection the element belongs to —\n * see `InPlaceOperationContext` for why that is not the navigation layer's job.\n \n Consequently an explicit `navigationOverrides` entry still WINS over a presentation authored here\n * (it is the more specific instrument, and it is checked first in the resolution chain). Author this\n * axis to say what KIND of chrome the action wants; author `navigationOverrides` when you need to\n * name the zone, the appearance or the viewport yourself.\n \n ## When omitted\n \n It is DERIVED from the operation — see `resolveResourceOperationActionPresentation()`. An\n * operation that asks for nothing executes directly; a small field set opens a modal; input the\n * framework cannot fit in an overlay (files, nested writes, a large field set) keeps the page it\n * has always had. An operation whose `surface` is `ADDRESSABLE` always keeps its page: the author\n * has already said it is a deep-linkable destination.\n /\nexport enum ResourceOperationActionPresentation {\n /\n Execute on click, with no form at all — the confirmation dialog for a risky operation is the\n * only thing between the click and the request.\n \n Only meaningful for an operation that needs no caller input. Declaring it on an operation that\n * DOES have required request fields would send an empty body, so the resolver refuses to derive it\n * there and an author who declares it anyway gets the operation's fields dropped — check\n * `requestDto` before reaching for this.\n /\n DIRECT = 'direct',\n /\n A small form anchored to the button that opened it, dismissed by clicking away.\n \n The single-input idiom (\"assign to…\", \"snooze until…\"). Transient by construction: no URL, no\n * history entry, nothing to deep-link. Use it when the surrounding context is the point — the user\n * is reading the row they are acting on and must not lose sight of it.\n /\n POPOVER = 'popover',\n /\n The element being acted on transforms in place to collect the input, leaving its neighbours\n * visible — the row becomes the form rather than being covered by one.\n \n Use it when the surrounding rows are the point: the user is comparing, and an overlay would hide\n * the very thing that made them act on this row.\n \n Transient, like {@link POPOVER}, and for the same reason. Nothing is pushed, no URL changes,\n * and a reload returns the list to rest. An inline row-edit is a momentary state of a listing, not\n * a place — which is also why no admin framework deep-links one, and why anything that SHOULD be\n * linkable, reloadable or reachable by a back button wants {@link PAGE}.\n \n It requires a collection. The host is provided by the list the element belongs to\n * (`InPlaceOperationProvider`); the same action rendered on a detail page, in a danger zone or in a\n * picker has no row to transform and degrades to an overlay rather than becoming a dead button.\n \n Note it does NOT resolve to `NavigationTransition.INPLACE`. Element-level hosting uses none of\n * what the navigation layer offers — no zone, no stack entry, no appearance — and routing it there\n * is exactly why that transition has never done what its own docstring promises. See\n * `InPlaceOperationContext`.\n /\n INLINE = 'inline',\n /\n An overlay above the layout — the workhorse for \"a handful of fields\", and the default the\n * derivation reaches for.\n \n Resolves to {@link NavigationTransition.OVERLAY}. The concrete appearance (dialog / sheet /\n * drawer / panel) stays the app's decision, resolved from its navigation layout exactly as any\n * other overlay: this axis says \"an overlay\", not \"a dialog specifically\". Author\n * `navigationOverrides` when you need to name one.\n /\n MODAL = 'modal',\n /\n A routable page, resolved through the ordinary navigation chain (zone transitions, viewport\n * overrides, the framework `PUSH` fallback) — i.e. exactly the behaviour every parameterised\n * action had before this axis existed.\n \n The right answer for complex or multi-step input, and for anything a user should be able to\n * link to, reload, or reach with a back button.\n /\n PAGE = 'page',\n}\n\n/\n Does an operation's action target a SINGLE resource instance, or the WHOLE\n * collection in the current scope?\n \n A per-app surfacing axis, orthogonal to authorization. Most actions are\n * `ITEM` (edit / delete / retry one row) and render in the per-row and detail\n * action bars. A `COLLECTION` action operates on every row in scope at once\n * (e.g. \"retry all failed deliveries\", \"purge the queue\"): it renders ONCE in\n * the list's collection-action surface (the toolbar), never per row, and\n * confirms + executes in place rather than opening a per-row form.\n \n For a `COLLECTION` action to have a callable route, its operation must borrow\n * a COLLECTION verb via `resourceOperationLike` (`UPDATE_MANY` / `DELETE_MANY` /\n * `CREATE_MANY`) — an entity verb (`UPDATE` / `DELETE`) generates a route with a\n * `:id` segment the scope-level surface has no single row to fill.\n /\nexport enum ResourceOperationActionScope {\n /* Targets one resource instance — the per-row / detail action bars. The default when omitted. /\n ITEM = 'item',\n /* Targets the whole collection in scope — rendered once in the list's collection-action surface. /\n COLLECTION = 'collection',\n}\n\n/\n What happens to an operation's action when its `enabledCondition` is currently\n * unmet — the per-view default for actions that don't declare an explicit\n * `actionVisibility`. An explicit per-operation `actionVisibility` always wins\n * over this policy; feature-gated unavailability keeps its own\n * `FeatureUnavailabilityBehavior` (upgrade/prompt) and is never hidden by this.\n \n - `HIDE` — drop the action entirely while unavailable (as if it declared\n * `ActionVisibility.WHEN_AVAILABLE`). The framework default for BOTH views: a\n * greyed, non-actionable button is noise wherever it sits, and hiding it also\n * collapses mutually-exclusive state pairs (e.g. \"Set as recurring\" / \"Set as\n * one time\") down to the one that currently applies.\n * - `SHOW_DISABLED` — render the action greyed/disabled (the classic behavior).\n * Opt in per view when the disabled action + its reason tooltip is genuinely\n * informative and you want it always present.\n /\nexport enum DisabledActionHandling {\n SHOW_DISABLED = 'show_disabled',\n HIDE = 'hide',\n}\n\n/\n Per-view action-surfacing (disclosure) policy — how many actions stay visible\n * and how unavailable ones are treated, for ONE {@link ResourceOperationDisplayMode}.\n /\nexport interface ResourceActionDisclosureConfig {\n /\n How many PRIMARY actions render as direct buttons before the remainder\n * collapse into the `…` overflow menu. Omitted inherits the framework default\n * for the view ({@link DEFAULT_ACTION_DISCLOSURE}): 3 for SUMMARY, unlimited\n * for DETAIL. `0` pushes every action into the menu.\n /\n maxPrimaryActions?: number;\n /\n Default handling for actions disabled by an unmet `enabledCondition` — see\n * {@link DisabledActionHandling}. Omitted inherits the framework default,\n * which is `HIDE` for both views (set `SHOW_DISABLED` here to keep disabled\n * actions greyed-but-present for a view).\n /\n disabledActionHandling?: DisabledActionHandling;\n}\n\n/* Fully-resolved disclosure policy (no optional fields) for one view. /\nexport interface ResolvedActionDisclosure {\n /* `undefined` = unlimited (no overflow cap). /\n maxPrimaryActions: number \| undefined;\n disabledActionHandling: DisabledActionHandling;\n}\n\n/\n Framework defaults per view. Both views HIDE actions disabled by an unmet\n * `enabledCondition` — an inapplicable, greyed button is noise everywhere, so\n * the bar only ever shows actions the user can actually take right now. They\n * differ on the overflow cap: SUMMARY (dense list/table rows) shows at most 3\n * direct actions before the `…` menu; DETAIL (roomy read view) is uncapped.\n * A resource that WANTS the informative greyed-with-reason affordance opts into\n * `SHOW_DISABLED` per view via `layout.actionDisclosure`.\n /\nexport const DEFAULT_ACTION_DISCLOSURE: Record<ResourceOperationDisplayMode, ResolvedActionDisclosure> = {\n [ResourceOperationDisplayMode.SUMMARY]: {\n maxPrimaryActions: 3,\n disabledActionHandling: DisabledActionHandling.HIDE,\n },\n [ResourceOperationDisplayMode.DETAIL]: {\n maxPrimaryActions: undefined,\n disabledActionHandling: DisabledActionHandling.HIDE,\n },\n};\n\n/\n Resolve the effective disclosure policy for a view: per-resource override\n * (`layout.actionDisclosure[view]`) layered over the framework default. Used by\n * both the action-building hook (disabled handling) and the operations-items\n * host (overflow cap).\n /\nexport function resolveActionDisclosure(\n displayMode: ResourceOperationDisplayMode,\n disclosure: Partial<Record<ResourceOperationDisplayMode, ResourceActionDisclosureConfig>> \| undefined,\n): ResolvedActionDisclosure {\n const base = DEFAULT_ACTION_DISCLOSURE[displayMode] ?? DEFAULT_ACTION_DISCLOSURE[ResourceOperationDisplayMode.DETAIL];\n const override = disclosure?.[displayMode];\n return {\n maxPrimaryActions: override?.maxPrimaryActions ?? base.maxPrimaryActions,\n disabledActionHandling: override?.disabledActionHandling ?? base.disabledActionHandling,\n };\n}\n\n/\n 2-axis card action-button placement. Single source of truth for the config\n * field AND the `card-action-placement.utils` resolver (which imports the\n * `CardActionPlacement` type inferred from this schema, so the two can never\n * drift). `MIDDLE × MIDDLE` is rejected — dead-center overlaps the card content.\n /\nexport const CardActionPlacementSchema = z.object({\n vertical: z.enum(VerticalPlacement),\n horizontal: z.enum(HorizontalPlacement),\n orientation: z.enum(DisplayDirection).optional(),\n}).refine(\n (p) => !(p.vertical === VerticalPlacement.MIDDLE && p.horizontal === HorizontalPlacement.MIDDLE),\n { message: 'cardActionPlacement cannot be MIDDLE × MIDDLE (dead-center overlaps card content); choose an edge or corner.' },\n);\n\n/* Authored 2-axis card action placement — inferred from {@link CardActionPlacementSchema}. /\nexport type CardActionPlacement = z.infer<typeof CardActionPlacementSchema>;\n\n/\n Who paints the identity GLYPH on this operation's page header.\n \n The header band renders the resource's registry icon beside the identity line by default. A\n * `layout.header` template that composes its own record-linked glyph (a per-row kind icon, a\n * per-family symbol) would otherwise sit BESIDE the resource icon — two glyphs naming one thing.\n \n Declared at the OPERATION layer rather than detected from the template, deliberately: the\n * resource icon renders before the template mounts, so detection could only suppress it after the\n * fact — a glyph that flashes and vanishes on every load. Mirrors\n * `SummaryTitlePlacement.TEMPLATE_OWNED`, the same contract one surface over: ceding a\n * framework-owned element to the template is a declaration, not an inference.\n /\nexport enum HeaderIconPlacement {\n /* The framework renders the resource's registry icon (default). /\n AUTO = 'auto',\n /* The header template owns the glyph; the framework renders none. /\n TEMPLATE_OWNED = 'template_owned',\n}\n\nexport const ResourceOperationFrontendConfigSchema = z.object({\n /\n The operation's frontend surface — see {@link ResourceOperationFrontendSurface}.\n * `ADDRESSABLE` (routable page) and `EMBEDDED` (non-addressable view rendered within\n * a host — overlay/composite/nested) both have a view + action button; `API_ONLY` is\n * headless (no view, no button). The view fields below (`actionVisibility`,\n * `customView`, `iconOverride`, layout, …) apply only to `ADDRESSABLE`/`EMBEDDED`; a\n * build-time check rejects them on `API_ONLY`.\n * Replaces the former `isAddressable` boolean — read via `isOperationAddressable()`.\n /\n surface: z.enum(ResourceOperationFrontendSurface),\n /* Who paints the page header's identity glyph — see {@link HeaderIconPlacement}. Omitted = AUTO. /\n headerIconPlacement: z.enum(HeaderIconPlacement).optional(),\n /\n How this operation's action is surfaced — see {@link ActionVisibility}. Omitted\n * (the common case) behaves as `ALWAYS`.\n /\n actionVisibility: z.enum(ActionVisibility).optional(),\n /\n Where this operation's action sits in the bar — see {@link ActionPlacement}.\n * Omitted derives from `riskLevel` (HIGH/CRITICAL → danger zone, else primary).\n /\n actionPlacement: z.enum(ActionPlacement).optional(),\n /\n Visual button variant (colour) for this operation's action — a\n * `ButtonVariants_Variant` (e.g. `DESTRUCTIVE`, `GHOST`, `ACCENT`). Omitted\n * derives from `riskLevel` (HIGH/CRITICAL → destructive/red, else ghost). Typed\n * on the interface below; the Zod field stays `z.any()` because the enum lives\n * in a component module a schema must not pull at runtime (same as `iconOverride`).\n /\n actionVariant: z.any().optional(),\n /\n Does this action target one row or the whole collection — see\n * {@link ResourceOperationActionScope}. Omitted behaves as `ITEM`. A\n * `COLLECTION` action renders once in the list's collection-action surface\n * (never per row) and confirms + executes in place; pair it with a COLLECTION\n * `resourceOperationLike` (`_MANY`) so its generated route carries no `:id`.\n /\n actionScope: z.enum(ResourceOperationActionScope).optional(),\n /*\n For an `ITEM` action whose backend addresses the target row by a field in\n * the REQUEST BODY (not the URL id), the request-DTO field name to fill with\n * the clicked row's id. When set, clicking the action executes IN PLACE —\n * sending `{ [rowTargetRequestField]: <rowId> }` — instead of opening a form:\n * e.g. a per-row \"Retry\" whose handler reads `{ entryId }` from the body. (The\n * row id still rides the URL path too, which the handler may ignore.)\n /\n rowTargetRequestField: z.string().optional(),\n /\n HOW this action collects its input — see {@link ResourceOperationActionPresentation}.\n * Omitted derives from the operation (`resolveResourceOperationActionPresentation`): no input\n * executes directly, a small field set opens a modal, complex input keeps its page.\n \n Display-only. An explicit `navigationOverrides` entry is the more specific instrument and wins\n * over whatever this resolves to.\n /\n actionPresentation: z.enum(ResourceOperationActionPresentation).optional(),\n customView: z.any().optional(),\n displayPresetOverride: z.object({\n resourceLayoutPresetKey: z.string().optional(),\n }).optional(),\n navigationOverrides: z.array(NavigationOperationOverrideSchema).optional(),\n displayPriority: z.number().optional(),\n iconOverride: z.any().optional(),\n collectionDisplayConfig: z.object({\n displayMode: z.enum(CollectionDisplayMode).optional(),\n userSwitchableDisplayMode: z.boolean().optional(),\n /\n Promote ONE enum filter field to a prominent quick-filter tab strip\n * rendered above the collection toolbar (\"All · <value> · <value> …\" —\n * the Stripe/Ignisign webhook-dashboard idiom, e.g. All/Delivered/Failed).\n \n The named field MUST be an enum member of the operation's backend\n * `filterFields` — the tabs write into the SAME filter state as the\n * filters panel (selecting a tab filters server-side), and the field is\n * removed from the panel/chips so there is never a second competing\n * control for it. Unknown / non-enum field names degrade gracefully\n * (no tab strip, field stays in the panel). Tab labels reuse the enum\n * value i18n (`tResourceFieldEnumValue`).\n /\n quickFilterField: z.string().optional(),\n /\n Group CARDS-mode rows into day buckets by this date field, rendering a\n * date heading between groups (activity-feed idiom for log-like\n * collections, e.g. webhook deliveries by day). Purely presentational:\n * grouping applies to the fetched page in its server order — pair it\n * with a default sort on the same field so buckets are contiguous.\n * Ignored in TABLE mode (column sorting owns the ordering there). Rows\n * whose field value is missing/unparsable render in a trailing bucket\n * without a date heading rather than being dropped.\n /\n temporalGroupField: z.string().optional(),\n /\n Group CARDS-mode rows into buckets by this ENUM field, rendering the\n * enum value's own label as a heading between groups.\n \n Sibling of {@link temporalGroupField}, and deliberately NOT the same\n * algorithm. Temporal grouping ADJACENT-MERGES in server order, because\n * dates are open-ended and a page can legitimately revisit one. An enum is\n * a CLOSED, ORDERED vocabulary, so its buckets are emitted in the enum's\n * DECLARATION ORDER regardless of the order rows arrived in — the\n * declaration is the authority for \"which concern comes first\", and a\n * server sort cannot express it without a second, drifting copy of that\n * order. Rows are therefore collected across the whole fetched page rather\n * than merged adjacently, and no sort needs pairing with it.\n \n Headings resolve through `tResourceFieldEnumValue` — the SAME source the\n * filters panel and the promoted quick-filter tabs use, so a bucket\n * heading and its tab can never disagree.\n \n Ignored in TABLE mode (column sorting owns the ordering there). Rows\n * whose value is absent, or outside the vocabulary, render in a trailing\n * bucket with no heading rather than being dropped — the same fail-open\n * the temporal grouping makes.\n /\n enumGroupField: z.string().optional(),\n /\n CARDS-mode arrangement — a single-column bordered LIST (default) or an\n * N-column responsive GRID. See {@link CardLayoutStyle}. `columns` (1–6) is\n * the TARGET maximum; the grid steps DOWN to fewer columns as the grid's own\n * available WIDTH narrows (an intrinsic `auto-fill minmax` track spec — so a\n * grid embedded in a narrow pane collapses even on a wide viewport, with no\n * media breakpoint). Authors give one N; the framework handles the rest.\n * Ignored in TABLE mode.\n \n @example\n * cardLayout: { style: CardLayoutStyle.GRID, columns: 3 }\n /\n cardLayout: z.discriminatedUnion('style', [\n z.object({ style: z.literal(CardLayoutStyle.LIST) }),\n z.object({\n style: z.literal(CardLayoutStyle.GRID),\n columns: z.number().int().min(1).max(6),\n }),\n ]).optional(),\n /\n Where each card's per-item action buttons sit, as a 2-axis anchor:\n * `vertical` ({@link VerticalPlacement} TOP/MIDDLE/BOTTOM) × `horizontal`\n * ({@link HorizontalPlacement} START/MIDDLE/END, RTL-aware). `orientation`\n * ({@link DisplayDirection}) lays the button set out as a row (HORIZONTAL,\n * default) or a vertical stack (VERTICAL). Omitted → the classic\n * MIDDLE × END horizontal row.\n \n `MIDDLE × MIDDLE` is rejected (dead-center overlaps the card content and\n * has no sensible meaning).\n \n @example\n * cardActionPlacement: { vertical: VerticalPlacement.TOP, horizontal: HorizontalPlacement.END }\n /\n cardActionPlacement: CardActionPlacementSchema.optional(),\n /\n Enable per-item SELECTION (checkboxes on cards / a select column in the\n * table) and the resulting BULK ACTION bar. Explicit opt-in per view. The\n * bar surfaces only operations declared `isBulkOperation` — a `selectable`\n * view with no bulk operations shows checkboxes that drive an empty bar, so\n * pair it with at least one bulk operation. Selection state is shared across\n * the cards↔table toggle (it does not reset when switching modes).\n /\n selectable: z.boolean().optional(),\n }).optional(),\n /\n Opt this operation into a generated per-operation description label\n * (`resources.{res}.operations.{op}.description`, read via `tResourceOperation`).\n * Default off — most operations need no description (making it mandatory for\n * every operation is far too verbose). Surfaces that show one (e.g. the danger\n * zone) fall back to risk-based copy when this is unset. Mirrors how fields opt\n * into a description via the `.describe()` decorator.\n /\n hasDescription: z.boolean().optional(),\n /\n What happens to an ADJACENT zone (secondary / companion) this operation\n * splits into, once that zone's last content is dismissed — overriding the\n * zone's own `onEmpty` while this operation occupies primary.\n \n The zone-level `ZoneConfig.onEmpty` is one value for every destination that\n * splits into that zone, and destinations legitimately disagree: a LIST wants\n * the detail pane to stay put (`EMPTY_STATE`) so the layout does not reflow\n * while a reviewer steps through rows, while a CANVAS wants its width back\n * (`COLLAPSE`) the moment nothing is selected. Both share one secondary zone,\n * so without this override one of them is always wrong.\n \n Declared on the SOURCE operation — the one occupying primary — not on the\n * operation that lands in the pane: it answers \"what should MY layout do when\n * the detail closes\", which is a property of the surface being returned to.\n \n Omitted (the common case) defers to the zone, which itself defaults to\n * `ZoneEmptyBehavior.COLLAPSE`. Resolution order is destination → zone →\n * COLLAPSE; see `resolveZoneEmptyBehavior`.\n /\n adjacentZoneOnEmpty: z.enum(ZoneEmptyBehavior).optional(),\n /\n How wide this destination's content may grow in the zone, in the framework's shared width\n * vocabulary — the SAME `ResponsiveMaxWidth` a Surface, a `DisplayLayout` and a `FormLayout` use.\n \n Omitted (the common case) is `'content'`: capped and centred at `var(--content-max-width, 80rem)`,\n * right for a form, a list or a detail page and wrong only for content whose value IS the space it\n * occupies — a board, a wide table, a canvas — which declare `'none'`.\n /\n zoneContentMaxWidth: z.enum(RESPONSIVE_MAX_WIDTH_VALUES).optional(),\n /\n Whether this destination's content fills the zone's HEIGHT as well.\n \n `true` makes the zone's content boundary a definite-height flex column, so this view's root may use\n * `flex-1 min-h-0` and resolve against something real. Without it a canvas has no intrinsic height\n * and collapses to zero — which is why one had to hand-roll `h-[70vh]`, sizing against the WINDOW\n * rather than the container it sits in. PRIMARY only: an adjacent zone scrolls, so a filling child\n * and a scrolling parent contradict each other.\n \n Separate from the width above ON PURPOSE — see `zone-content-geometry.ts` for why the enum that\n * fused them could not express a capped width with a definite height.\n /\n zoneContentFillsHeight: z.boolean().optional(),\n});\n\n/\n TypeScript interface for `ResourceOperationFrontendConfigSchema`.\n * `iconOverride`, `customView`, and `actionVariant` are typed with their real\n * React/enum values even though the Zod schema uses `z.any()` — Zod cannot\n * validate function types, and `actionVariant`'s enum lives in a component\n * module the schema must not import at runtime.\n /\nexport type ResourceOperationFrontendConfig = Omit<z.infer<typeof ResourceOperationFrontendConfigSchema>, 'iconOverride' \| 'customView' \| 'actionVariant'> & {\n iconOverride?: IconLike;\n customView?: React.ComponentType;\n actionVariant?: ButtonVariants_Variant;\n};\n/* @wildo_source:part:end saas.frontend.resource-operation-frontend-config /\n\n/\n Is this operation's frontend surface URL-addressable (a routable page)?\n \n The canonical replacement for the former `isAddressable` boolean field — read\n * `surface` rather than storing addressability, so the three surfaces stay a\n * single source of truth. Safe on `undefined` (an operation whose frontend\n * config has not been resolved yet is treated as not addressable).\n /\nexport function isOperationAddressable(\n config?: Pick<ResourceOperationFrontendConfig, 'surface'>,\n): boolean {\n return config?.surface === ResourceOperationFrontendSurface.ADDRESSABLE;\n}\n\n/\n Is this operation headless — callable as an API with no rendered interface\n * (no page, no overlay, no action button)? See {@link ResourceOperationFrontendSurface.API_ONLY}.\n /\nexport function isOperationHeadless(\n config?: Pick<ResourceOperationFrontendConfig, 'surface'>,\n): boolean {\n return config?.surface === ResourceOperationFrontendSurface.API_ONLY;\n}\n\n/\n Does this operation's action target the whole collection in scope, rather than\n * a single row? See {@link ResourceOperationActionScope}. Safe on `undefined`\n * (treated as `ITEM`). Collection-scoped actions render ONLY in the list's\n * collection-action surface (the toolbar) and are excluded from the per-row,\n * detail, danger-zone, and bulk bars.\n /\nexport function isCollectionScopedOperation(\n config?: Pick<ResourceOperationFrontendConfig, 'actionScope'>,\n): boolean {\n return config?.actionScope === ResourceOperationActionScope.COLLECTION;\n}\n\n/\n Resource-owned composite templates keyed by view ref (authoring form).\n \n How to use: set `compositeViews` on `ResourceUIBehaviorConfig` to\n * `ResourceCompositeViewAuthoringConfig` objects. Each composite renders\n * inside exactly one resource operation host, declared via\n * {@link ResourceCompositeViewAuthoringConfig.operationLike} (defaulting to\n * `CoreResourceOperation.READ`). Prefer `executionViews` / `chartViews` for\n * those families instead of overloading composites.\n \n Note: this type is distinct from `AppCompositeViewsConfig`. Only\n * resource composites carry `operationLike`, because app-level composites have\n * no resource operation host to surface into.\n /\nexport type ResourceCompositeViewsConfig = Record<string, ResourceCompositeViewAuthoringConfig>;\n\n\n// ── Resource-level label function params ────────────────────────────\n\n/\n Parameters passed to `getFrontendResourceLabel` functions.\n \n Generic `TMainSchema` defaults to `z.ZodAny` — presets and records use the\n * default (giving `currentObject: any`), while app-level configs can narrow it\n * to a concrete schema for type-safe field access.\n /\nexport type ResourceUIBehaviorLabelParams<TMainSchema extends z.ZodTypeAny = z.ZodAny> = {\n currentObject: z.infer<TMainSchema>;\n objectContext: any;\n initiatorUserContext?: any;\n t: (toTranslate: string, params?: Record<string, any>) => string;\n};\n\n// ── Layout system types (Phase 5) ───────────────────────────────────\n\n/* @wildo_source:part:start saas.frontend.resource-layout-templates facet:layer:frontend facet:family:resource-ui /\n/\n Static manifest of structural refs used in JSX templates.\n * Readable by the companion without JSX/AST parsing.\n \n Produces i18n keys:\n * - `resources.{type}.sections.{ref}.title`\n * - `resources.{type}.sections.{ref}.description`\n * - `resources.{type}.wizardSteps.{ref}.title`\n * - `resources.{type}.wizardSteps.{ref}.description`\n * - `resources.{type}.groups.{ref}.title`\n /\nexport interface LayoutRefManifest {\n /* Section names used in `<Section name=\"...\">` components. /\n sections?: string[];\n /* Wizard step names used in `<WizardStep name=\"...\">` components. /\n wizardSteps?: string[];\n /* Group names used in `<Group name=\"...\">` components. /\n groups?: string[];\n}\n\n/\n Layout template — a React component rendered inside the appropriate provider stack.\n \n - Edit context: rendered inside `<Form>` providers. Use `useFormTemplateContext()` for\n * labels/schema/operation and `useWatch()` for field-reactive branching.\n * - Display context: rendered inside `<DisplayTemplateProvider>` by `AutomaticDisplayer`.\n * Use `useDisplayTemplateContext()` for `data`, `isLoading`, `schema`, labels, and breakpoint.\n * - Summary context: same as display, rendered by `ResourceSummaryDisplayer` with\n * `disableInlineEdit={true}` and compact chrome (INLINE default).\n /\nexport type LayoutTemplate = React.ComponentType;\n\n/\n Resource layout configuration — template-based layout for forms and displays.\n \n Templates use skeleton components (`<FormField>`, `<Section>`,\n * `<WizardLayout>`, `<DisplayField>`, etc.) with Tailwind CSS for positioning.\n * Conditional visibility is handled with `useWatch()` and standard React conditionals.\n \n When no template is provided for a context, the framework generates a\n * default flat template at runtime from the schema.\n \n How to use: set `layout: { refs, edit, display, summary }` on the object returned\n * from `resourceUIBehavior()`. Every `<Section name=\"…\">`, `<WizardStep name=\"…\">`, and\n * `<Group name=\"…\">` in those templates should appear under `refs` for i18n and\n * companion validation. Omit `edit` / `display` / `summary` individually to keep the\n * auto-generated default for that context only.\n /\nexport interface ResourceLayoutConfig {\n\n /\n Companion-readable manifest of all structural names used in templates.\n * Required for i18n label generation.\n * Dev-time validation cross-checks manifest names against template `name` props.\n /\n refs?: LayoutRefManifest;\n\n /\n Default chrome mode for fields in each context.\n * Used when a field's `{primitive}UI.{context}.chromeMode` is not set.\n * Renderers read: `{primitive}UI.{context}.chromeMode ?? layout.defaultChromeMode.{context} ?? system-default`\n /\n defaultChromeMode?: {\n /* Default chrome for display context. /\n display?: ResponsiveAware<DisplayChromeMode>;\n /* Default chrome for summary context. /\n summary?: ResponsiveAware<DisplayChromeMode>;\n /* Default chrome for edit context. /\n edit?: ResponsiveAware<EditChromeMode>;\n };\n\n /\n Per-view override for how this resource's action buttons render their\n * label, keyed by {@link ResourceOperationDisplayMode} (`SUMMARY` = list/table\n * rows & cards, `DETAIL` = full read view). Overrides the app-wide theme\n * default (`ComponentStyleTheme.actionLabelDisplayMode`). Omit a key to\n * inherit the app default for that view.\n \n Precedence: `layout.actionLabelDisplayMode[view]` → app theme default → `TOOLTIP`.\n \n @example\n * // Dense list rows stay icon-only; the full detail view spells actions out.\n * actionLabelDisplayMode: {\n * [ResourceOperationDisplayMode.SUMMARY]: ActionLabelDisplayMode.TOOLTIP,\n * [ResourceOperationDisplayMode.DETAIL]: ActionLabelDisplayMode.INLINE,\n * }\n /\n actionLabelDisplayMode?: Partial<Record<ResourceOperationDisplayMode, ActionLabelDisplayMode>>;\n\n /\n Per-view action-surfacing (disclosure) policy — see {@link ResourceActionDisclosureConfig}.\n * Controls how many actions stay visible before overflow (`maxPrimaryActions`)\n * and whether actions disabled by an unmet `enabledCondition` are hidden or\n * greyed (`disabledActionHandling`), keyed by {@link ResourceOperationDisplayMode}.\n * Omit a view (or a field) to inherit the framework default\n * ({@link DEFAULT_ACTION_DISCLOSURE}): SUMMARY = { max 3, hide-disabled },\n * DETAIL = { unlimited, hide-disabled }.\n \n @example\n * // A busy list keeps just one action inline; the detail view spells them all out.\n * actionDisclosure: {\n * [ResourceOperationDisplayMode.SUMMARY]: { maxPrimaryActions: 1 },\n * }\n /\n actionDisclosure?: Partial<Record<ResourceOperationDisplayMode, ResourceActionDisclosureConfig>>;\n\n /\n Edit layout template — a `React.ComponentType` rendered inside `<Form>` providers.\n * The component is instantiated as `<EditTemplate />` and has access to\n * `useFormTemplateContext()` for labels/schema/operation and `useWatch()` for reactivity.\n * For operation-specific branching, read `operationType` from `FormTemplateContext`.\n * Standard `<FormField name=\"...\">` slots automatically honor upstream\n * generated replacements (for example relationship-backed fields reshaped by\n * `ResourceAutomatedForm`). When a generated override exists, that replacement\n * node owns its own chrome and ignores extra `FormField`-style props passed at\n * the template slot.\n /\n edit?: LayoutTemplate;\n\n /\n Display layout template — rendered for read-only detail views.\n * The component is instantiated inside `<DisplayTemplateProvider>` and has access to\n * `useDisplayTemplateContext()` for `data`, `isLoading`, `variant`, labels, and breakpoint.\n /\n display?: LayoutTemplate;\n\n /\n Header layout template — the record's IDENTITY LINE in the READ page header.\n \n The header band is framework-owned chrome (back button, breadcrumb, resource\n * icon, action cluster) wrapped around one middle region: the record's name.\n * Authoring this template cedes that middle region to the resource, so state\n * that belongs ON the identity line — a status badge, a visibility marker, an\n * accent swatch — sits beside the name instead of in a labelled strip below it.\n \n Rendered inside a display-template provider over the loaded record, so\n * `<DisplayField name=\"…\">` and `useDisplayTemplateContext()` work exactly as\n * they do in `display` / `summary`. Inline editing is off (the header shows\n * state, it does not edit it) and chrome defaults to `INLINE` so fields render\n * bare, without their labels.\n \n Place `<ResourceHeaderTitle />` yourself. The header stops rendering its\n * own title once this template exists, so a template that omits the element\n * produces a page with no record name (a dev warning names the resource).\n \n Distinct from `summary` on purpose: a card/FK-popover summary answers \"how\n * does this record identify itself in a LIST\", and commonly carries fields a\n * page header should not repeat. Both surfaces compose the same way; neither\n * inherits the other's body.\n \n @example\n * // Accent dot before the name, status badge after it, \"Public\" only when true:\n * header: () => {\n * const { data, fieldLabels } = useDisplayTemplateContext();\n * return (\n * <>\n * {Boolean(data?.color) && <ColorDot value={String(data.color)} />}\n * <ResourceHeaderTitle />\n * <DisplayField name=\"status\" hideLabel className=\"w-auto\" />\n * {Boolean(data?.isPublic) && <Badge>{fieldLabels.isPublic}</Badge>}\n * </>\n * );\n * }\n /\n header?: LayoutTemplate;\n\n /\n Summary layout template — rendered for cards, list items, FK references.\n * Typically a compact single-line or small card layout.\n * The component is instantiated inside `<DisplayTemplateProvider>` by `ResourceSummaryDisplayer`,\n * with `disableInlineEdit={true}` and chrome defaulting to `DisplayChromeMode.INLINE`.\n * Use `useDisplayTemplateContext()` for reactive data access.\n \n The title is part of the template flow. Wrap the body in `<SummaryLayout>`;\n * by default (`titlePlacement={AUTO}`) it renders the resource's primary label\n * (`<SummaryTitle />`) at the top, then your fields below — the classic\n * title-above-body card. To put something on the title's line (a status badge),\n * switch to `titlePlacement={TEMPLATE_OWNED}` and place `<SummaryTitle />`\n * yourself, typically inside a `<SummaryHeader>`:\n \n @example\n * // Title above a couple of fields (title rendered automatically):\n * summary: () => (\n * <SummaryLayout>\n * <DisplayField name=\"createdAt\" />\n * </SummaryLayout>\n * )\n \n @example\n * // Status badge inline with the title:\n * summary: () => (\n * <SummaryLayout titlePlacement={SummaryTitlePlacement.TEMPLATE_OWNED}>\n * <SummaryHeader>\n * <SummaryTitle />\n * <DisplayField name=\"status\" hideLabel />\n * </SummaryHeader>\n * <DisplayField name=\"createdAt\" />\n * </SummaryLayout>\n * )\n /\n summary?: LayoutTemplate;\n\n}\n/* @wildo_source:part:end saas.frontend.resource-layout-templates /\n\n\n// ── Relationship display overrides ──────────────────────────────────\n\n/\n Per-relationship display override declared on the owning resource's preset.\n \n Each entry targets a specific relationship by `target` resource type (and\n * optionally `foreignKeyField` for disambiguation when multiple relationships\n * exist to the same type). The `inParentNavigation` /\n * `inChildView` sub-objects are shallow-merged onto the relationship's shared\n * `display` config during registry build — frontend values win over shared defaults.\n \n Ownership principle: each resource configures its own view:\n * - `inParentNavigation` → \"how does navigation from my view to this child behave?\"\n * - `inChildView` → \"how does the parent reference appear in my view when I'm the child?\"\n \n @example\n * ```ts\n * relationshipOverrides: [\n * // I'm parent of TASKS — make Tasks appear as accordion in MY view\n * { target: ResourceType.TASKS,\n * // I'm child of USERS (FK: assignedToUserId) — show user as badge in MY view\n * { target: ResourceType.USERS, foreignKeyField: 'assignedToUserId',\n * inChildView: { parentDisplay: ParentDisplay.BADGE } },\n * ]\n * ```\n /\nexport interface RelationshipDisplayOverride {\n /* Related resource type to match against. /\n target: string;\n /\n FK field name for disambiguation when multiple relationships exist to the\n * same `target` type. Matches against both explicit `rel.foreignKeyField` and\n * implied FK from `allResourceFieldIdentifiers`.\n /\n foreignKeyField?: string;\n /* Override for how children appear in THIS resource's view (when I'm parent). /\n /* Override for how navigation from THIS resource's view to the child behaves. /\n inParentNavigation?: Partial<RelationshipDisplayInParentNavigation>;\n /* Override for how parent reference appears in THIS resource's view (when I'm child). /\n inChildView?: Partial<RelationshipDisplayInChildView>;\n}\n\n\n// ── Resource-level frontend config ──────────────────────────────────\n\n/\n @wildo_source:part:start saas.frontend.resource-ui-behavior-config facet:layer:frontend facet:family:resource-ui\n \n Complete frontend configuration for a single resource within an application.\n \n Canonical frontend resource configuration type. Contains resource-level settings\n * (labels, sections, views, empty state, guidance) plus per-operation frontend config.\n \n Generic `TMainSchema` defaults to `z.ZodAny`. Presets and `ResourceUIBehavior`\n * records use the default; app-level configs can narrow it to a concrete schema\n * for type-safe `getFrontendResourceLabel` callbacks.\n \n This is the canonical frontend type — it is self-contained and does not\n * reference or depend on backend resource configuration factories.\n \n UI views use a `Map` keyed by `OperationKey`:\n * - `string` key for default operations\n * - `[operationId, variantKey]` tuple for non-default variants\n \n @example\n * ```\n * const orgConfig: ResourceUIBehaviorConfig<any, any, typeof OrgSchema> = {\n * getFrontendResourceLabel: ({ currentObject }) => currentObject.name, // type-safe\n * views: new Map([\n * [CoreResourceOperation.CREATE, notAddressable()],\n * [CoreResourceOperation.LIST, addressable()],\n * ]),\n * };\n \n // Input form (via resourceUIBehavior callback) uses array-of-tuples:\n * // views: [\n * // [CoreResourceOperation.CREATE, notAddressable()],\n * // [CoreResourceOperation.LIST, addressable()],\n * // ],\n * ```\n /\nexport type ResourceUIBehaviorConfig<\n TCustomOp extends EnumLikeType \| undefined = any,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined = any,\n TMainSchema extends z.ZodTypeAny = z.ZodAny,\n> = {\n\n // ── Resource Icon ──────────────────────────────────────────────\n\n /\n Resource-level icon — React component (e.g., Lucide) or string\n * (StandardIconReference). Registered into `IconRegistry.resources`\n * during `buildFrontendResourceConfigurations()`.\n /\n icon?: IconLike;\n\n\n // ── Field Addons ───────────────────────────────────────────────\n\n /\n Per-field decorator overrides for the resource's `mainSchema`.\n \n Keys are field names of `TMainSchema`; values are decorated Zod schemas\n * from the same shape (e.g., `shape.status.enumUI({ ... })`).\n \n The merge happens at module evaluation time — calling `.enumUI()`\n * on a shape field mutates its metadata in place via `applySingleDecorator`\n * merge semantics. Schema-level decorators are preserved, addon decorators\n * overlay. No explicit runtime consumption is needed; the `fields`\n * field exists primarily for type safety (`keyof z.infer<TMainSchema>`)\n * and as a declaration container.\n \n @example\n * ```ts\n * fields: {\n * status: shape.status.enumUI({\n * values: { pending: { color: 'secondary' }, completed: { color: 'success' } },\n * }),\n * }\n * ```\n /\n fields?: {\n [K in keyof ObjectShape<TMainSchema>]?: ObjectShape<TMainSchema>[K];\n };\n\n\n // ── Form Defaults ──────────────────────────────────────────────\n\n /\n Resource-level default validation mode for form fields.\n * Individual fields can override via `{primitive}UI({ edit: { validationMode } })`.\n * Falls back to framework default (`ON_BLUR`) when not set.\n /\n defaultValidationMode?: ValidationMode;\n\n /\n Resource-level default autosave config for form fields.\n * Individual fields can override via `{primitive}UI({ edit: { autosave } })`.\n * When not set, autosave is disabled unless explicitly configured per-field.\n /\n defaultAutosave?: AutosaveFieldParams \| true;\n\n\n // ── Draft Mode ─────────────────────────────────────────────────\n\n /\n Resource-level draft mode configuration.\n * Defines how draft/publish discrimination works — which field acts as\n * discriminator, what values mean \"draft\" vs \"published\", and whether\n * publishing requires confirmation.\n \n Consumed by `ResourceAutomatedForm` to enable Save-as-Draft / Publish\n * buttons and relaxed validation for draft saves.\n /\n draftableConfig?: DraftableConfigParams;\n\n\n // ── Layout ──────────────────────────────────────────────────────\n\n /\n Template-based layout configuration. Resources needing sections, wizard steps,\n * or custom layouts provide explicit JSX templates using skeleton components\n * (`<Section>`, `<FormField>`, `<WizardLayout>`, etc.).\n \n @see ResourceLayoutConfig\n /\n layout?: ResourceLayoutConfig;\n\n\n // ── Label ──────────────────────────────────────────────────────\n\n /\n Label generation for resource instances in the frontend.\n \n Can be either:\n * - `string[]` — array of field paths to concatenate (each entry is a field\n * name on the summary record, including any server-resolved virtual field\n * such as a `forwardedLabel`, e.g. `['instanceLabel']`).\n * - `(params: ResourceUIBehaviorLabelParams) => string` — a function\n \n Used by `ResourceListItemRenderer` (rows) and `ResourceLayout_Header` (titles).\n /\n getFrontendResourceLabel?: string[] \| ((params: ResourceUIBehaviorLabelParams<TMainSchema>) => string);\n\n\n // ── Views ──────────────────────────────────────────────────────\n\n /* Resource-owned composite templates declared inline on the resource UI behavior. /\n compositeViews?: ResourceCompositeViewsConfig;\n\n /* Resource-owned execution surfaces declared inline on the resource UI behavior. /\n executionViews?: ResourceExecutionViewsConfig;\n\n /* Resource-owned inserted chart declarations for this resource. /\n chartViews?: InsertedChartDeclaration[];\n\n\n // ── Empty State ────────────────────────────────────────────────\n\n /\n Empty state configuration for list/table views when no items exist.\n * Labels (title, description, primaryActionLabel) come from i18n.\n /\n emptyState?: ResourceUIBehavior_EmptyState;\n\n\n // ── Guidance ───────────────────────────────────────────────────\n\n /\n Resource-level guidance flow declarations.\n * Compiled into standard `GuidanceFlowDefinition` objects by the guidance compiler.\n /\n guidance?: ResourceUIBehavior_GuidanceFlow[];\n\n\n // ── Relationship Display Overrides ───────────────────────────────\n\n /\n Per-relationship display overrides for this resource.\n \n Allows the frontend preset to override how relationships are displayed\n * without modifying the shared `display` config on the relationship itself.\n * Consumed at build time by `resolveRelationshipDisplayOverrides()` and\n * stripped from `frontendConfiguration` before storage.\n \n @see RelationshipDisplayOverride\n /\n relationshipOverrides?: RelationshipDisplayOverride[];\n\n\n // ── UI Views ───────────────────────────────────────────────────\n\n /\n Per-operation frontend configuration — which operations have a UI view\n * and how they appear (addressability, launchers, overrides).\n \n Keyed by `TypedOperationKey`:\n * - `string` — default operation (e.g., `CoreResourceOperation.READ`)\n * - `[operationId, variantKey]` — non-default variant\n \n When typed via `resourceUIBehavior()`, operation keys are validated\n * at compile time against the resource's valid operations.\n /\n views: Map<TypedOperationKey<TCustomOp, TCoreOp>, ResourceOperationFrontendConfig>;\n};\n/* @wildo_source:part:end saas.frontend.resource-ui-behavior-config /\n\n/\n Resource-level UI behavior configuration — the subset of `ResourceUIBehaviorConfig`\n * that describes the resource itself (labels, sections, views, empty state, guidance),\n * excluding `views` (lives on individual operation entries),\n * `relationshipOverrides` (consumed at build time, not stored at runtime).\n \n Resource-owned composite/execution authoring maps are compiled into inserted\n * runtime declarations before storage.\n \n This is what gets written to `FrontendResourceConfiguration.frontendConfiguration`\n * during preset-driven registry build.\n /\nexport type ResourceUIBehaviorResourceLevelConfig<\n TCustomOp extends EnumLikeType \| undefined = any,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined = any,\n TMainSchema extends z.ZodTypeAny = z.ZodAny,\n> = Omit<ResourceUIBehaviorConfig<TCustomOp, TCoreOp, TMainSchema>, 'views' \| 'relationshipOverrides' \| 'compositeViews' \| 'executionViews'> & {\n compositeViews?: InsertedCompositeDeclaration[];\n executionViews?: InsertedExecutionDeclaration[];\n};\n\n// ── Preset type ─────────────────────────────────────────────────────\n\n/\n @wildo_source:part:start saas.frontend.resource-ui-behavior-preset-map facet:layer:frontend facet:family:resource-ui\n \n Complete frontend resource configuration preset for an application.\n \n Maps resource types to their full frontend configuration — including\n * resource-level settings (labels, sections, views, empty state, guidance)\n * and operation-level settings (addressability, launchers, overrides).\n \n Each application provides its own preset defining exactly which resources\n * and operations it exposes and how they appear in the UI.\n \n When authoring presets, use `resourceUIBehavior()` which accepts views\n * as an array of tuples (for contextual typing) and converts to Map internally.\n \n @example\n * ```\n * const preset: ResourceUIBehavior = {\n * [CoreResourceType.ORGANIZATIONS]: resourceUIBehavior(factory, Schema, ({ schema, schemaShape, opsVariantResolver }) => ({\n * getFrontendResourceLabel: ({ currentObject }) => currentObject.name,\n * views: [\n * [CoreResourceOperation.CREATE, notAddressable()],\n * [CoreResourceOperation.READ, notAddressable()],\n * ],\n * })),\n * };\n * ```\n /\nexport type ResourceUIBehavior = Record<string, ResourceUIBehaviorConfig>;\n/* @wildo_source:part:end saas.frontend.resource-ui-behavior-preset-map /\n\n// ── Polymorphic frontend declaration ────────────────────────────────\n\n/\n A single variant within a polymorphic frontend declaration.\n * Maps a parent resource type (the discriminator) to the concrete resource type it produces.\n \n Mirrors the backend's `PolymorphicResolvedVariant` — stripped of schema-level\n * concerns, keeping only the routing information the frontend needs.\n /\nexport interface PolymorphicFrontendVariant {\n /* Parent resource type — the polymorphic discriminator (e.g., `CoreResourceType.ORGANIZATIONS`) /\n parentResourceType: string;\n /* Concrete resource type for this variant (e.g., `CoreResourceType.ORGANIZATION_BILLING_ACCOUNTS`) /\n resourceType: string;\n}\n\n/\n Frontend polymorphic declaration — lightweight equivalent of the backend's\n * `PolymorphicSchemaDeclaration`.\n \n Contains the variant mapping (discriminator → concrete resource type) without\n * any Zod schema coupling. Used by `createPolymorphicFrontendPreset()` to generate\n * per-variant preset entries.\n \n Declarations are typically defined per resource family (billing accounts,\n * subscriptions, SSO config, etc.) and mirror the backend's\n * `BILLING_SCOPE_VARIANTS` / `AUTH_SCOPE_VARIANTS` grouping.\n \n @example\n * ```ts\n * const BILLING_ACCOUNTS: PolymorphicFrontendDeclaration = {\n * variants: [\n * { parentResourceType: CoreResourceType.ORGANIZATIONS, resourceType: CoreResourceType.ORGANIZATION_BILLING_ACCOUNTS },\n * { parentResourceType: CoreResourceType.USERS, resourceType: CoreResourceType.USER_BILLING_ACCOUNTS },\n * ],\n * };\n * ```\n /\nexport interface PolymorphicFrontendDeclaration {\n variants: PolymorphicFrontendVariant[];\n}\n\n\n// ── Polymorphic preset config ───────────────────────────────────────\n\n/\n Resource frontend config with optional per-variant overrides.\n \n Mirrors the backend's `PolymorphicResourceConfig` + `polymorphicRole` pattern:\n * - Shared fields apply to all scope variants as the default\n * - `variantOverrides` keyed by `parentResourceType` (the discriminator)\n * allow per-variant differentiation — just like `polymorphicRole` resolves\n * different roles per parent resource type\n \n Override resolution (same as backend `polymorphicRole`):\n * - If a variant's `parentResourceType` is in `variantOverrides`, the override\n * replaces the corresponding shared fields (not merged)\n * - If not present, the shared config is used as-is (fallback)\n * - `views` in an override fully replaces the shared views Map\n * (use an empty `new Map()` to make a variant invisible in the preset)\n /\nexport type PolymorphicResourceUIBehaviorConfig<\n TCustomOp extends EnumLikeType \| undefined = any,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined = any,\n TMainSchema extends z.ZodTypeAny = z.ZodAny,\n> = Omit<ResourceUIBehaviorConfig<TCustomOp, TCoreOp, TMainSchema>, 'views'> & {\n /\n Per-operation frontend config — array-of-tuples form (converted to Map internally).\n * Same semantics as `ResourceUIBehaviorConfig.views` but using arrays for\n * TypeScript contextual typing compatibility.\n /\n views: OperationEntries<TCustomOp, TCoreOp>;\n /\n Per-variant overrides, keyed by `parentResourceType` (the polymorphic discriminator).\n \n Like backend `polymorphicRole`, provides variant-specific configuration.\n * Each override replaces the corresponding shared field — `views`\n * is a full replacement, not a merge. If `views` is omitted in the\n * override, the shared views apply.\n \n Pass an empty array `[]` for `views` to exclude a variant from\n * surfacing in the preset (variant still exists in the declaration, but\n * has no frontend operations).\n /\n variantOverrides?: Record<string, Partial<Omit<ResourceUIBehaviorConfig<TCustomOp, TCoreOp, TMainSchema>, 'views'>> & { views?: OperationEntries<TCustomOp, TCoreOp> }>;\n };\n\n/\n Return type of the `polymorphicResourceUIBehavior()` callback overload.\n * Same structure as `PolymorphicResourceUIBehaviorConfig` — the callback form\n * provides `{ schema, schemaShape, opsVariantResolver }` for the same typed control as `resourceUIBehavior()`:\n * operation keys in `views` and `variantOverrides` are validated at compile time.\n /\nexport type PolymorphicResourceUIBehaviorConfigResult<\n TCustomOp extends EnumLikeType \| undefined = any,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined = any,\n TMainSchema extends z.ZodTypeAny = z.ZodAny,\n> = PolymorphicResourceUIBehaviorConfig<TCustomOp, TCoreOp, TMainSchema>;\n\n// ── Polymorphic preset factory ──────────────────────────────────────\n\n/\n Creates frontend preset entries for all scope variants of a polymorphic resource.\n \n Mirrors the backend `createPolymorphicResourceConfigurations` pattern:\n * takes a polymorphic declaration (discriminator → concrete resource types) and\n * a shared config with optional per-variant overrides, producing a\n * `ResourceUIBehavior` partial that can be spread into the main preset.\n \n Resolution per variant (same semantics as backend `polymorphicRole` → `roles`):\n * 1. If `variantOverrides[parentResourceType]` exists → override fields replace\n * corresponding shared fields (views is a full replacement, not merge)\n * 2. If no override → shared config used as-is (fallback)\n \n The declaration must always contain ALL variants of the polymorphic resource.\n * Use `variantOverrides` with an empty `views: []` to exclude a variant\n * from a specific preset (the variant is declared but has no frontend presence).\n \n @param declaration - Polymorphic frontend declaration with ALL variant mappings\n * @param config - Shared config (default) with optional `variantOverrides` per discriminator\n * @returns Partial `ResourceUIBehavior` with one entry per variant\n \n @example\n * ```ts\n * // Main app: org scope gets full ops, app scope excluded\n * ...createPolymorphicFrontendPreset({\n * variants: [\n * { parentResourceType: R.ORGANIZATIONS, resourceType: R.ORGANIZATION_SSO_CONFIG },\n * { parentResourceType: R.APPLICATION, resourceType: R.APPLICATION_SSO_CONFIG },\n * ],\n * }, {\n * views: [\n * [Op.READ, addressable()],\n * [CustomOperations.RUN_DIAGNOSTIC, notAddressable()],\n * ],\n * variantOverrides: {\n * [R.APPLICATION]: { views: [] },\n * },\n * }),\n \n // Admin app: app scope gets full ops, org scope read-only\n * ...createPolymorphicFrontendPreset({\n * variants: [\n * { parentResourceType: R.ORGANIZATIONS, resourceType: R.ORGANIZATION_SSO_CONFIG },\n * { parentResourceType: R.APPLICATION, resourceType: R.APPLICATION_SSO_CONFIG },\n * ],\n * }, {\n * views: [\n * [Op.READ, addressable()],\n * [CustomOperations.RUN_DIAGNOSTIC, notAddressable()],\n * ],\n * variantOverrides: {\n * [R.ORGANIZATIONS]: {\n * views: [\n * [Op.READ, notAddressable()],\n * [Op.LIST, notAddressable()],\n * ],\n * },\n * },\n * }),\n * ```\n /\nexport function createPolymorphicFrontendPreset(\n declaration: PolymorphicFrontendDeclaration,\n config: PolymorphicResourceUIBehaviorConfig,\n): ResourceUIBehavior {\n const schema = (config as any)[FRONTEND_SCHEMA_KEY];\n const { variantOverrides, views: sharedViewsEntries, ...sharedRest } = config;\n const sharedViews = new Map(sharedViewsEntries);\n const sharedConfig = { ...sharedRest, views: sharedViews } as ResourceUIBehaviorConfig;\n\n // Compute per-variant FK-renamed schemas. The author passes ONE base\n // schema to `polymorphicResourceUIBehavior(decl, factory, baseSchema, ...)`,\n // but the runtime polymorphic factory renames `polymorphicVariants`-marked\n // FK fields per variant (e.g. `billingAccountId` →\n // `organizationBillingAccountId` for the ORGANIZATIONS variant). If we\n // attach the un-renamed base schema as `FRONTEND_SCHEMA_KEY` on every\n // variant, `buildFrontendResourceConfigurations` later replaces the\n // renamed `mainSchema` with the un-renamed base — and the FK→parent\n // resolution check throws because the base's `billingAccountId` doesn't\n // resolve to a unique parent. Mirror the factory's rename at this seam\n // so per-variant `FRONTEND_SCHEMA_KEY` matches the per-variant\n // `mainSchema` keys.\n const variantSchemas =\n schema !== undefined && (schema as z.ZodTypeAny)?._zod?.def?.type === 'object'\n ? computePolymorphicVariantSchemas(\n schema as z.ZodObject<z.ZodRawShape>,\n declaration.variants,\n )\n : null;\n\n if (schema !== undefined) {\n (sharedConfig as any)[FRONTEND_SCHEMA_KEY] = schema;\n }\n const result: ResourceUIBehavior = {};\n\n for (const variant of declaration.variants) {\n const override = variantOverrides?.[variant.parentResourceType];\n // Use the per-variant renamed schema when available; fall back to the\n // shared base schema for declarations whose fields have no\n // `polymorphicVariants` metadata (rename map is empty → identity).\n const variantSchema =\n variantSchemas?.get(variant.parentResourceType) ?? schema;\n\n if (override) {\n const { views: overrideViewsEntries, ...overrideRest } = override;\n const concreteConfig = {\n ...sharedConfig,\n ...overrideRest,\n views: overrideViewsEntries ? new Map(overrideViewsEntries) : sharedViews,\n };\n if (variantSchema !== undefined) {\n (concreteConfig as any)[FRONTEND_SCHEMA_KEY] = variantSchema;\n }\n result[variant.resourceType] = concreteConfig;\n } else if (variantSchemas && variantSchema !== schema) {\n // Distinct per-variant schema: clone sharedConfig so each variant\n // keeps its own FRONTEND_SCHEMA_KEY rather than sharing the base.\n const concreteConfig = { ...sharedConfig, views: sharedViews } as ResourceUIBehaviorConfig;\n (concreteConfig as any)[FRONTEND_SCHEMA_KEY] = variantSchema;\n result[variant.resourceType] = concreteConfig;\n } else {\n result[variant.resourceType] = sharedConfig;\n }\n }\n\n return result;\n}\n\n\n// ── Utility types for extracting generics from ResourceConfiguration ────────\n\n/\n Infers the custom operation enum from a resource factory or config type.\n \n How to use: in generic helpers that wrap `resourceUIBehavior(yourFactory, …)`\n * so `TypedOperationKey` and `views` tuples stay aligned without repeating type params.\n /\nexport type ExtractCustomOp<T> =\n T extends ResourceConfiguration<infer C, any, any> ? C :\n T extends ResourceConfiguration_InitializationFactory<infer C, any, any> ? C :\n never;\n\n/* Same as {@link ExtractCustomOp} for the core operations subset on the resource. /\nexport type ExtractCoreOp<T> =\n T extends ResourceConfiguration<any, infer O, any> ? O :\n T extends ResourceConfiguration_InitializationFactory<any, infer O, any> ? O :\n never;\n\n/* Same as {@link ExtractCustomOp} for the resource main Zod schema type. /\nexport type ExtractSchema<T> =\n T extends ResourceConfiguration<any, any, infer S> ? S :\n T extends ResourceConfiguration_InitializationFactory<any, any, infer S> ? S :\n never;\n\n\n// ── Standalone variant helper ───────────────────────────────────────────────\n\n/\n Creates a typed operation variant tuple `[operationKey, variantKey]`.\n * Preserves the literal operation key for `TypedOperationKey` assignability.\n \n How to use: in `views: [ … ]` when the operation key must stay a narrow literal\n * (custom enum member or core op). Equivalent to `opsVariantResolver(op, key)` but\n * useful in static arrays outside the callback.\n /\nexport function variant<TOp extends string>(\n op: TOp, variantKey: string,\n): readonly [TOp, string] {\n return [op, variantKey] as const;\n}\n\n\n// ── Operation entries (input form) ───────────────────────────────────────────\n\n/\n Array-of-tuples form for specifying operations in input contexts\n * (`resourceUIBehavior` callback, `polymorphicResourceUIBehavior` config).\n \n TypeScript's `new Map([...])` doesn't pick up contextual typing for\n * heterogeneous key types, so input types use arrays — the factory functions\n * convert to `Map` at the boundary. Each entry's key is individually checked\n * against `TypedOperationKey<TCustomOp, TCoreOp>` via contextual typing.\n /\nexport type OperationEntries<\n TCustomOp extends EnumLikeType \| undefined = any,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined = any,\n> = [TypedOperationKey<TCustomOp, TCoreOp>, ResourceOperationFrontendConfig][];\n\n\n// ── Callback parameter type for resourceUIBehavior / polymorphicResourceUIBehavior ─\n\n/\n Callback argument bag for `resourceUIBehavior()` / `polymorphicResourceUIBehavior()`.\n \n How to use: prefer `schemaShape.fieldName` for per-field `.enumUI()` / `.stringUI()`\n * overrides; use `schema` when applying decorators on the root object; use\n * `opsVariantResolver(CoreResourceOperation.READ, 'summary')` (or `variant()`) so\n * non-default variant keys type-check against valid operations.\n /\nexport type ResourceUIBehaviorCallbackParams<\n TCustomOp extends EnumLikeType \| undefined,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined,\n TSchema extends z.ZodTypeAny,\n> = {\n schema: TSchema;\n schemaShape: ObjectShape<TSchema>;\n opsVariantResolver: <TOp extends ValidOperationKeys<TCustomOp, TCoreOp>>(\n op: TOp, variantKey: string,\n ) => readonly [TOp, string];\n};\n\n\n// ── Callback return type for resourceUIBehavior ─────────────────────────────\n\n/\n Return type of the `resourceUIBehavior()` callback — overrides `views`\n * to accept an array of tuples (instead of Map) for ergonomic authoring.\n * The `resourceUIBehavior()` function converts the array to a Map.\n \n `schemaOverride` is applied during callback execution as a side effect and\n * stripped from the returned config. Must appear BEFORE `fields` in the\n * object literal to ensure schema-level defaults are set before field-level overrides.\n /\nexport type ResourceUIBehaviorConfigResult<\n TCustomOp extends EnumLikeType \| undefined,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined,\n TSchema extends z.ZodTypeAny,\n> = Omit<ResourceUIBehaviorConfig<TCustomOp, TCoreOp, TSchema>, 'views'> & {\n views: OperationEntries<TCustomOp, TCoreOp>;\n schemaOverride?: TSchema;\n};\n\n\n// ── Typed resource UI behavior factory ──────────────────────────────────────\n\n/\n Creates a typed `ResourceUIBehaviorConfig` entry for a given resource.\n \n All generics are inferred from the `_factory` argument — no explicit type\n * parameters needed. The callback receives `{ schema, schemaShape, opsVariantResolver }`:\n * - `schema` — the Zod schema (for schema-level mutations like `.stringUI()`, `.enumUI()`, etc.)\n * - `schemaShape` — the typed shape object (for per-field decorator overrides with autocomplete)\n * - `opsVariantResolver` — typed variant tuple helper constrained to valid operation keys\n \n The `_factory` parameter is for type inference only and is never called at runtime.\n \n @example\n * ```ts\n * [R.TODOS]: resourceUIBehavior(\n * todos_ResourceConfiguration_InitializationFactory,\n * Todos_Schema,\n * ({ schema, schemaShape, opsVariantResolver }) => ({\n * icon: CheckSquare,\n * fields: {\n * status: schemaShape.status.enumUI({\n * values: { completed: { color: 'success', icon: CheckCircle } },\n * }),\n * },\n * views: [\n * [CoreResourceOperation.LIST, addressable()],\n * [opsVariantResolver(CoreResourceOperation.CREATE, 'quick-add'), notAddressable()],\n * ],\n * }),\n * ),\n * ```\n /\nexport function resourceUIBehavior<\n TCustomOp extends EnumLikeType \| undefined,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined,\n TSchema extends z.ZodTypeAny,\n>(\n _factory: ResourceConfigLike<TCustomOp, TCoreOp, TSchema>,\n schema: TSchema,\n configFactory: (\n params: ResourceUIBehaviorCallbackParams<TCustomOp, TCoreOp, TSchema>,\n ) => ResourceUIBehaviorConfigResult<TCustomOp, TCoreOp, TSchema>,\n): ResourceUIBehaviorConfig {\n const schemaShape = (\n schema && 'shape' in schema\n ? (schema as unknown as z.ZodObject<any>).shape\n : getZodObjectShape(schema)\n ) as ObjectShape<TSchema>;\n\n const opsVariantResolver = <TOp extends string>(op: TOp, variantKey: string) =>\n [op, variantKey] as readonly [TOp, string];\n\n const { schemaOverride: _, views: viewsEntries, ...config } =\n configFactory({ schema, schemaShape, opsVariantResolver: opsVariantResolver as any });\n\n (config as any)[FRONTEND_SCHEMA_KEY] = schema;\n\n return {\n ...config,\n views: new Map(viewsEntries),\n } as unknown as ResourceUIBehaviorConfig;\n}\n\n\n// ── Derived resource UI behavior factory ────────────────────────────────────\n\n/\n Callback parameter type for `resourceUIBehaviorFrom()`.\n * Extends the standard callback params with a `base` reference to the resolved base config.\n /\nexport type ResourceUIBehaviorFromCallbackParams<\n TCustomOp extends EnumLikeType \| undefined,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined,\n TSchema extends z.ZodTypeAny,\n> = ResourceUIBehaviorCallbackParams<TCustomOp, TCoreOp, TSchema> & {\n /* The resolved base config — use to reference existing values when composing overrides. /\n base: ResourceUIBehaviorConfig<TCustomOp, TCoreOp, TSchema>;\n};\n\n/\n Return type of the `resourceUIBehaviorFrom()` callback — everything is optional.\n \n Merge semantics applied by `resourceUIBehaviorFrom`:\n * - `views` — replaced (the primary differentiator between main/admin)\n * - `layout` — shallow-merged (`{ ...base.layout, ...override.layout }`)\n * - `fields` — shallow-merged (base fields preserved, overrides overlay per-key)\n * - `compositeViews` — shallow-merged by ref (`{ ...base.compositeViews, ...override.compositeViews }`)\n * - `executionViews` — shallow-merged by ref (`{ ...base.executionViews, ...override.executionViews }`)\n * - Scalars (`icon`, `emptyState`, `getFrontendResourceLabel`, etc.) — replaced if provided\n /\nexport type ResourceUIBehaviorFromResult<\n TCustomOp extends EnumLikeType \| undefined,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined,\n TSchema extends z.ZodTypeAny,\n> = Partial<Omit<ResourceUIBehaviorConfig<TCustomOp, TCoreOp, TSchema>, 'views'>> & {\n views?: OperationEntries<TCustomOp, TCoreOp>;\n};\n\n/\n Derives a new `ResourceUIBehaviorConfig` from an existing base, overriding only\n * the specified properties. Eliminates duplication between main and admin presets\n * where the majority of the config (icon, fields, layout, labels) is identical\n * and only `views` (and occasionally `variantOverrides`) differ.\n \n The `_factory` parameter is for type inference only — same as `resourceUIBehavior()`.\n * The schema is extracted from the base config via `FRONTEND_SCHEMA_KEY`, so it does not\n * need to be passed again.\n \n For resources that are completely identical between main and admin, skip this function\n * entirely and forward the config directly: `[R.PRODUCTS]: main[R.PRODUCTS]!`\n \n @param _factory - Any factory from the resource — for type inference only (never called)\n * @param base - The resolved base `ResourceUIBehaviorConfig` (from main presets)\n * @param overrideFn - Callback returning only the properties to override\n \n @example\n * ```ts\n * // Admin promotions — same icon/fields/layout, different views\n * [R.PROMOTIONS]: resourceUIBehaviorFrom(\n * promotionsFactory,\n * main[R.PROMOTIONS]!,\n * ({ opsVariantResolver }) => ({\n * views: [\n * [Promotion_Operations.DEACTIVATE, notAddressable()],\n * ],\n * })\n * ),\n * ```\n /\nexport function resourceUIBehaviorFrom<\n TCustomOp extends EnumLikeType \| undefined,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined,\n TSchema extends z.ZodTypeAny,\n>(\n _factory: ResourceConfigLike<TCustomOp, TCoreOp, TSchema>,\n base: ResourceUIBehaviorConfig,\n overrideFn: (\n params: ResourceUIBehaviorFromCallbackParams<TCustomOp, TCoreOp, TSchema>,\n ) => ResourceUIBehaviorFromResult<TCustomOp, TCoreOp, TSchema>,\n): ResourceUIBehaviorConfig {\n const schema = (base as any)[FRONTEND_SCHEMA_KEY] as TSchema;\n const schemaShape = (\n schema && 'shape' in schema\n ? (schema as unknown as z.ZodObject<any>).shape\n : getZodObjectShape(schema)\n ) as ObjectShape<TSchema>;\n const opsVariantResolver = <TOp extends string>(op: TOp, variantKey: string) =>\n [op, variantKey] as readonly [TOp, string];\n\n const {\n views: overrideViews,\n layout: overrideLayout,\n fields: overrideFields,\n compositeViews: overrideCompositeViews,\n executionViews: overrideExecutionViews,\n ...overrideRest\n } =\n overrideFn({\n schema,\n schemaShape,\n opsVariantResolver: opsVariantResolver as any,\n base: base as unknown as ResourceUIBehaviorConfig<TCustomOp, TCoreOp, TSchema>,\n });\n\n return {\n ...base,\n ...overrideRest,\n ...(overrideLayout !== undefined && {\n layout: { ...base.layout, ...overrideLayout },\n }),\n ...(overrideFields !== undefined && {\n fields: { ...base.fields, ...overrideFields },\n }),\n ...(overrideCompositeViews !== undefined && {\n compositeViews: { ...base.compositeViews, ...overrideCompositeViews },\n }),\n ...(overrideExecutionViews !== undefined && {\n executionViews: { ...base.executionViews, ...overrideExecutionViews },\n }),\n views: overrideViews ? new Map(overrideViews) : base.views,\n } as unknown as ResourceUIBehaviorConfig;\n}\n\n\n// ── Derived polymorphic resource UI behavior factory ─────────────────────────\n\n/\n Return type of the `polymorphicResourceUIBehaviorFrom()` callback — everything is optional.\n * Same merge semantics as `resourceUIBehaviorFrom()`, plus `variantOverrides` is shallow-merged\n * per parent key (inner overrides replace, not merge).\n /\nexport type PolymorphicResourceUIBehaviorFromResult<\n TCustomOp extends EnumLikeType \| undefined,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined,\n TSchema extends z.ZodTypeAny,\n> = Partial<Omit<PolymorphicResourceUIBehaviorConfig<TCustomOp, TCoreOp, TSchema>, 'views'>> & {\n views?: OperationEntries<TCustomOp, TCoreOp>;\n};\n\n/\n Derives a polymorphic preset from an existing base, overriding only the specified\n * properties. Works like `resourceUIBehaviorFrom()` but for polymorphic resources\n * produced by `polymorphicResourceUIBehavior()`.\n \n The base entries are the already-spread `Partial<ResourceUIBehavior>` from the main\n * preset. Internally, the first variant's config is used as the shared base — the\n * callback receives it as `base` and returns only what changes.\n \n @param declaration - Same polymorphic declaration used in the main preset\n * @param _factory - Any single factory from the polymorphic map — for type inference only\n * @param baseEntries - The spread result from the main preset (keyed by concrete resource type)\n * @param overrideFn - Callback returning only the properties to override\n \n @example\n * ```ts\n * // Admin SIEM — same icon/layout/fields, different variantOverrides\n * ...polymorphicResourceUIBehaviorFrom(\n * SIEM_EXPORT_DECLARATION,\n * siemFactory,\n * main,\n * ({ opsVariantResolver }) => ({\n * variantOverrides: {\n * [R.ORGANIZATIONS]: {\n * views: [[Op.READ, notAddressable()]],\n * },\n * },\n * })\n * ),\n * ```\n /\nexport function polymorphicResourceUIBehaviorFrom<\n TCustomOp extends EnumLikeType \| undefined,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined,\n TSchema extends z.ZodTypeAny,\n>(\n declaration: PolymorphicFrontendDeclaration,\n _factory: ResourceConfigLike<TCustomOp, TCoreOp, TSchema>,\n baseEntries: Partial<ResourceUIBehavior>,\n overrideFn: (\n params: ResourceUIBehaviorFromCallbackParams<TCustomOp, TCoreOp, TSchema>,\n ) => PolymorphicResourceUIBehaviorFromResult<TCustomOp, TCoreOp, TSchema>,\n): ResourceUIBehavior {\n const firstVariantType = declaration.variants[0]?.resourceType;\n const baseConfig = firstVariantType ? baseEntries[firstVariantType] : undefined;\n if (!baseConfig) {\n throw new Error(\n `polymorphicResourceUIBehaviorFrom: no base config found for first variant \"${firstVariantType}\"`,\n );\n }\n\n const schema = (baseConfig as any)[FRONTEND_SCHEMA_KEY] as TSchema;\n const schemaShape = (\n schema && 'shape' in schema\n ? (schema as unknown as z.ZodObject<any>).shape\n : getZodObjectShape(schema)\n ) as ObjectShape<TSchema>;\n const opsVariantResolver = <TOp extends string>(op: TOp, variantKey: string) =>\n [op, variantKey] as readonly [TOp, string];\n\n const {\n views: overrideViews,\n layout: overrideLayout,\n fields: overrideFields,\n compositeViews: overrideCompositeViews,\n executionViews: overrideExecutionViews,\n variantOverrides: overrideVariantOverrides,\n ...overrideRest\n } = overrideFn({\n schema,\n schemaShape,\n opsVariantResolver: opsVariantResolver as any,\n base: baseConfig as unknown as ResourceUIBehaviorConfig<TCustomOp, TCoreOp, TSchema>,\n });\n\n const mergedPolyConfig: PolymorphicResourceUIBehaviorConfig = {\n ...baseConfig,\n ...overrideRest,\n ...(overrideLayout !== undefined && {\n layout: { ...baseConfig.layout, ...overrideLayout },\n }),\n ...(overrideFields !== undefined && {\n fields: { ...baseConfig.fields, ...overrideFields },\n }),\n ...(overrideCompositeViews !== undefined && {\n compositeViews: { ...baseConfig.compositeViews, ...overrideCompositeViews },\n }),\n ...(overrideExecutionViews !== undefined && {\n executionViews: { ...baseConfig.executionViews, ...overrideExecutionViews },\n }),\n views: overrideViews ?? [...baseConfig.views.entries()],\n ...(overrideVariantOverrides !== undefined && {\n variantOverrides: overrideVariantOverrides,\n }),\n } as unknown as PolymorphicResourceUIBehaviorConfig;\n\n return createPolymorphicFrontendPreset(declaration, mergedPolyConfig);\n}\n\n\n// ── Typed polymorphic UI behavior factory ───────────────────────────────────\n\n/\n Creates a typed polymorphic UI behavior preset — wraps `createPolymorphicFrontendPreset()`\n * with type inference from a factory or configuration.\n \n For resources built with `createFamilySchema` (discriminated unions), the factory\n * provides the generic context for `fields` typing and operation key validation.\n \n Two overloads — use the callback form for the same typed control as `resourceUIBehavior()`:\n * - Callback: `(declaration, factory, schema, ({ schema, schemaShape, opsVariantResolver }) => config)` — operation keys\n * in `views` and `variantOverrides` are validated at compile time via the `opsVariantResolver` helper.\n * - Object: `(declaration, factory, config)` — config object; typing may be weaker for array literals.\n \n @param declaration - Polymorphic frontend declaration with variant mappings\n * @param _factory - Any single factory from the polymorphic map — for type inference only\n * @param schemaOrConfig - Base schema (for callback form) or config object (for object form)\n * @param configFactory - Callback form only: receives { schema, schemaShape, opsVariantResolver } like resourceUIBehavior\n */\nexport function polymorphicResourceUIBehavior<\n TCustomOp extends EnumLikeType \| undefined,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined,\n TSchema extends z.ZodTypeAny,\n>(\n declaration: PolymorphicFrontendDeclaration,\n _factory: ResourceConfigLike<TCustomOp, TCoreOp, TSchema>,\n schema: TSchema,\n configFactory: (\n params: ResourceUIBehaviorCallbackParams<TCustomOp, TCoreOp, TSchema>,\n ) => PolymorphicResourceUIBehaviorConfigResult<TCustomOp, TCoreOp, TSchema>,\n): ResourceUIBehavior;\n\n\nexport function polymorphicResourceUIBehavior<\n TCustomOp extends EnumLikeType \| undefined,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined,\n TSchema extends z.ZodTypeAny,\n>(\n declaration: PolymorphicFrontendDeclaration,\n _factory: ResourceConfigLike<TCustomOp, TCoreOp, TSchema>,\n config: PolymorphicResourceUIBehaviorConfig<TCustomOp, TCoreOp, TSchema>,\n): ResourceUIBehavior;\n\n\nexport function polymorphicResourceUIBehavior<\n TCustomOp extends EnumLikeType \| undefined,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined,\n TSchema extends z.ZodTypeAny,\n>(\n declaration: PolymorphicFrontendDeclaration,\n _factory: ResourceConfigLike<TCustomOp, TCoreOp, TSchema>,\n schemaOrConfig: TSchema \| PolymorphicResourceUIBehaviorConfig<TCustomOp, TCoreOp, TSchema>,\n configFactory?: (\n params: ResourceUIBehaviorCallbackParams<TCustomOp, TCoreOp, TSchema>,\n ) => PolymorphicResourceUIBehaviorConfigResult<TCustomOp, TCoreOp, TSchema>,\n): ResourceUIBehavior {\n const config = configFactory\n ? (() => {\n const schema = schemaOrConfig as TSchema;\n const schemaShape = (\n schema && 'shape' in schema\n ? (schema as unknown as z.ZodObject<any>).shape\n : getZodObjectShape(schema)\n ) as ObjectShape<TSchema>;\n const opsVariantResolver = <TOp extends string>(op: TOp, variantKey: string) =>\n [op, variantKey] as readonly [TOp, string];\n const config = configFactory({ schema, schemaShape, opsVariantResolver: opsVariantResolver as any });\n (config as any)[FRONTEND_SCHEMA_KEY] = schema;\n return config;\n })()\n : (schemaOrConfig as PolymorphicResourceUIBehaviorConfig);\n\n return createPolymorphicFrontendPreset(declaration, config as PolymorphicResourceUIBehaviorConfig);\n}\n"]}
1	+ {"version":3,"file":"resources.frontend.schemas.js","sourceRoot":"","sources":["../../../../../src/core/resources/resources.frontend.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { RESPONSIVE_MAX_WIDTH_VALUES } from '@wildo-ai/presets-components-models';\nimport type { AutoEmptyValue } from '@wildo-ai/presets-components-models';\nimport type React from 'react';\nimport { z } from \"zod\";\nimport type { EnumLikeType, IconLike, AutosaveFieldParams, ValidationMode, ResponsiveAware, EditChromeMode, DisplayChromeMode, DraftableConfigParams, ContainerSectionMode } from '@wildo-ai/zod-decorators';\nimport { getZodObjectShape } from '@wildo-ai/zod-decorators';\nimport type { ButtonVariants_Variant } from '~wildo-frontend-lib/components/actions/button';\nimport type { QuickSwitcherScopeField } from '~wildo-frontend-lib/core/config/app-configuration-frontend.schemas';\nimport {\n ResourceParentResourceRequirement,\n ResourcePrimaryScope,\n ResourceRelationship,\n ResourceTranspositionPolicy,\n CoreResourceOperation,\n ResourceOperationDisplayMode,\n ResourceOperationFrontendSurface,\n ResourceFieldIdentifier,\n ResourceType,\n ResourceTypeSchema,\n ResourceConfiguration_Operation_ApiCall,\n ResourceConfiguration_Operation_ApiCallWithCallback,\n ResourceConfiguration_ResourceRelationships,\n ResourceConfiguration_InheritanceSchemaDefinition,\n TourStepPlacement,\n NavigationZoneName,\n OverlayAppearance,\n SplitAppearance,\n TransitionConfigSchema,\n ZoneEmptyBehavior,\n viewportDiscriminatedSchema,\n computePolymorphicVariantSchemas,\n} from '@wildo-ai/saas-models';\nimport type {\n ResourceConfiguration,\n ResourceConfiguration_InitializationFactory,\n ValidOperationKeys,\n RelationshipDisplayInParentNavigation,\n RelationshipDisplayInChildView,\n} from '@wildo-ai/saas-models';\nimport type { InsertedChartDeclaration } from '~wildo-frontend-lib/core/config/chart-view.frontend.schemas';\nimport type {\n InsertedExecutionDeclaration,\n ResourceExecutionViewsConfig,\n} from '~wildo-frontend-lib/core/config/execution-view.schemas';\nimport type {\n OnboardingElementType,\n GuidanceRenderMode,\n GuidanceFlowScope,\n GuidanceAudience,\n NotificationBadgeDefinition,\n UserNotificationDefinition,\n SubtreeMap,\n ManyToManyScopeJunctionMap,\n} from '@wildo-ai/saas-models';\nimport { ViewportBreakpoint, DisplayDirection } from '@wildo-ai/zod-decorators';\nimport type {\n CorePresetNames,\n ActionLabelDisplayMode,\n} from '@wildo-ai/presets-components-models';\nimport {\n VerticalPlacement,\n HorizontalPlacement,\n} from '@wildo-ai/presets-components-models';\nimport type {\n CompositeViewComponentProps,\n InsertedCompositeDeclaration,\n ResourceCompositeViewAuthoringConfig,\n} from '../config/composite-view.schemas';\n\n\n\n// ================================================================================================\n// Types transferred from saas-models/config/frontend/navigation.shared.schemas.ts\n// NavigationOperationOverrideSchema only — the rest of navigation stays in saas-models.\n// ================================================================================================\n\n/*\n @wildo_source:part:start saas.frontend.navigation.operation-override facet:layer:frontend facet:family:navigation-config\n \n Per-operation navigation chrome: transition, overlay/split appearance, source zone.\n \n How to use: attach fragments of this shape under\n * `ResourceOperationFrontendConfig.navigationOverrides` in `resourceUIBehavior()`.\n * Each override applies when navigating from the configured zone/viewport into\n * this operation. Prefer mirroring a sibling resource that already matches the\n * product’s overlay vs split behavior.\n /\nexport const NavigationOperationOverrideSchema = z.object({\n transition: TransitionConfigSchema,\n appearance: viewportDiscriminatedSchema(z.union([\n z.enum(OverlayAppearance),\n z.enum(SplitAppearance),\n ])).optional(),\n fromZone: z.union([z.enum(NavigationZoneName), z.literal('appLevel')]).optional(),\n viewport: z.enum(ViewportBreakpoint).optional(),\n /\n Behaviour of the OVERLAY this override resolves to — whether the page behind stays interactive,\n * whether touching it dismisses, whether it is dimmed. Ignored for non-overlay transitions.\n \n These three were already declared on `OverlayContainerConfig` with documented defaults and read by\n * nothing; they are honoured now, and this is the channel that lets a NAVIGATION-driven overlay set\n * them. Declared per operation because it describes the CONTENT: an application legitimately has a\n * create dialog that blocks everything and a detail sheet beside a live canvas that blocks nothing.\n /\n overlayBehavior: z.object({\n modal: z.boolean().optional(),\n closeOnOutsideClick: z.boolean().optional(),\n showBackdrop: z.boolean().optional(),\n }).optional(),\n});\nexport type NavigationOperationOverride = z.infer<typeof NavigationOperationOverrideSchema>;\n/* @wildo_source:part:end saas.frontend.navigation.operation-override /\n\n\n// ================================================================================================\n// Types transferred from saas-models/resources/resource-frontend.shared.schemas.ts\n// Strictly identical signatures — canonical home is now saas-frontend-lib.\n// ================================================================================================\n\n// --------------------------------\n// App Scope Field Types\n// --------------------------------\n\n/\n Runtime-resolved scope field definition.\n \n Extends the config-declared `QuickSwitcherScopeField` (from top-level\n * `appScope.fields`) with properties resolved at initialization time from the\n * resource registry.\n \n Created by AppScopeContext from the `appScope.fields` configuration.\n /\nexport interface AppScopeFieldDefinition extends QuickSwitcherScopeField {\n /* Resolved from the resource configuration at initialization /\n resourcePrimaryScope: ResourcePrimaryScope;\n}\n\n\n// --------------------------------\n// Frontend Resource Path Schemas\n// Defined in resource-path.frontend.schemas.ts (import here only — no re-export).\n// --------------------------------\n\nimport { FrontendResourceOperationPathSchema } from './resource-path.frontend.schemas';\nimport type { FrontendResourceOperationPath, FrontendResource_ParentResourceRequirement } from './resource-path.frontend.schemas';\n\n\n// --------------------------------\n// Frontend-Specific Operation Types\n// --------------------------------\n\n/\n Resolved operation row the frontend registry stores: same structural operation\n * config as `@wildo-ai/saas-models` (API_CALL / callback variants) plus optional\n * `operationFrontendConfig` from the app preset.\n \n How to use: app authors normally do not construct this type by hand —\n * `buildFrontendResourceConfigurations()` merges backend `ResourceConfiguration`\n * with `ResourceUIBehavior`. Use it when typing hooks/components that receive the\n * merged registry (e.g. operation context, launcher resolution).\n /\ntype FrontendResourceOperation_Base = {\n /\n Frontend UI behavior config for this operation, carrying its `surface`\n * ({@link ResourceOperationFrontendSurface}). After `buildFrontendResourceConfigurations`\n * runs, EVERY operation has a resolved config: preset-surfaced operations get\n * their authored config; everything else resolves to `{ surface: API_ONLY }`\n * (headless) from the operation's `defaultFrontendPosture` or the default.\n * The field stays optional only for the pre-resolution / partial-mock case —\n * read the surface via `isOperationAddressable()` / `isOperationHeadless()`,\n * never by testing presence.\n /\n operationFrontendConfig?: ResourceOperationFrontendConfig;\n}\n\nexport type FrontendResourceConfiguration_Operation<\n TCustomOperationEnum extends EnumLikeType \| undefined = any,\n TCoreOperationEnum extends Partial<CoreResourceOperation> \| undefined = any,\n TMainSchema extends z.ZodTypeAny = z.ZodAny,\n> = (\n \| ResourceConfiguration_Operation_ApiCall<TCustomOperationEnum, TCoreOperationEnum, TMainSchema>\n \| ResourceConfiguration_Operation_ApiCallWithCallback<TCustomOperationEnum, TCoreOperationEnum, TMainSchema>\n) & FrontendResourceOperation_Base;\n\n/\n Full merged resource row in the frontend registry: backend fields (scope, schema,\n * relationships, operations) plus optional `frontendConfiguration` (labels, layout,\n * views map, guidance, …) derived from the app’s `ResourceUIBehavior` preset.\n \n How to use: read-only shape at runtime and in typed frontend services. Authoring\n * happens in `.resources-config.ts` + `.ui-behavior.tsx`, not by filling this object\n * manually.\n /\nexport type FrontendResourceConfiguration<\n TCustomOperationEnum extends EnumLikeType \| undefined = any,\n TCoreOperationEnum extends Partial<CoreResourceOperation> \| undefined = any,\n TMainSchema extends z.ZodTypeAny = z.ZodAny,\n> = {\n isDisabled: boolean;\n resourcePrimaryScope: ResourcePrimaryScope;\n resourceIdentifier: ResourceType;\n resourceFieldIdentifier: ResourceFieldIdentifier;\n coreOperations: TCoreOperationEnum[];\n customOperation?: TCustomOperationEnum;\n mainSchema: TMainSchema;\n resourceRelationships: ResourceConfiguration_ResourceRelationships;\n inheritenceSchemaDefinition?: ResourceConfiguration_InheritanceSchemaDefinition<EnumLikeType, TMainSchema>;\n frontendConfiguration?: ResourceUIBehaviorResourceLevelConfig<TCustomOperationEnum, TCoreOperationEnum, TMainSchema>;\n isSystemResource: boolean;\n /\n Mirrors `ResourceConfiguration.primaryKeyIdentifiesInitiator` from `@wildo-ai/saas-models`.\n * `buildFrontendResourceConfigurations` spreads the backend config onto every frontend\n * registry entry, so this is always populated at runtime; it must stay declared here too\n * so shared `saas-models` utils typed against `AnyResourceConfiguration` (e.g.\n * `ResourcesConfigOperationsUrlsBuilderUtils`) accept a frontend registry entry.\n /\n primaryKeyIdentifiesInitiator: boolean;\n isAnonymizable: boolean;\n transpositionPolicy: ResourceTranspositionPolicy;\n operations: FrontendResourceConfiguration_Operation<TCustomOperationEnum, TCoreOperationEnum, TMainSchema>[];\n}\n\nexport type AnyFrontendResourceConfiguration = FrontendResourceConfiguration<any, any, any>;\n\n/\n Application frontend resource registry built at startup (field-id maps, relationships,\n * notification defs, subtree map, and per-resource `FrontendResourceConfiguration`).\n \n How to use: consume via React context / services (`ResourcesRepository`, routing,\n * layout hosts). Authors extend it indirectly by registering presets and module wiring —\n * not by mutating this object ad hoc.\n /\nexport type FrontendResourcesRegistry = {\n allResourceFieldIdentifiers: Record<string, string>;\n fieldIdentifierToResourceType: Record<string, ResourceType>;\n /\n Scope-required reference-search junctions, keyed by `${target}\|${scope}`.\n * Drives the inference-based people-picker: a FK targeting `T` from a resource\n * scoped by `S`, where `T ↔ S` is an M:N via junction `J`, searches `T` scoped\n * to the caller's current `S` through `J`. Mirrors the backend registry.\n \n OPTIONAL: the real registry builder always populates it, but partial test\n * registries omit it — consumers (e.g. `useResourceSearch`) treat an absent map\n * as \"no junction scoping\" (plain target search).\n /\n manyToManyScopeJunctions?: ManyToManyScopeJunctionMap;\n notificationBadgeDefinitions: NotificationBadgeDefinition[];\n additionalUserNotificationDefinitions: UserNotificationDefinition[];\n resourceRelationships: ResourceRelationship[];\n resourceConfigurations: {\n [key: ResourceType]: AnyFrontendResourceConfiguration;\n };\n subtreeMap: SubtreeMap;\n}\n\n\n// ================================================================================================\n// Original resources.frontend.schemas.ts content\n// ================================================================================================\n\n/\n Everything the framework knows about the current resource operation while rendering\n * a layout host (read/update/list/custom view, nested child, etc.).\n \n How to use: custom templates and views receive compatible props via framework\n * hooks; use `contextResourceIdentifiers` for parent/child route params and FK scope.\n * `operation` is the merged backend operation + `operationFrontendConfig` — prefer it\n * over guessing URLs or variant keys. `parentResourcesRequirements` repeats path\n * requirements from routing for hosts that must validate scope before fetch.\n /\nexport interface FrontendResourceOperationContext extends FrontendResourceOperationPath {\n /* Current operation being executed /\n resourceType: string;\n\n /* The operation configuration - properly typed /\n operation: FrontendResourceConfiguration_Operation;\n\n /* Resource context map: ResourceType -> resourceId \| {fieldIdentifier, resourceId} /\n contextResourceIdentifiers: Record<string,\n \| string\n \| { fieldIdentifier: string; resourceId: string; }\n >;\n\n /* Additional context data that can be passed /\n additionalContext?: Record<string, unknown>;\n\n /* Parent resource requirements - explicitly included from FrontendResourceOperationPath /\n parentResourcesRequirements: FrontendResource_ParentResourceRequirement[];\n}\n\n/* ──────────────────────────────────────────────────────────────\n * Internal Schemas (concrete, for method access)\n * ────────────────────────────────────────────────────────────── /\n\nexport const FrontendResourceOperationContextSchema = FrontendResourceOperationPathSchema.extend({\n // operation is typed as z.any() in schema — the FrontendResourceOperationContext interface\n // provides proper typing (FrontendResourceConfiguration_Operation) for compile-time consumers\n operation: z.any(),\n contextResourceIdentifiers: z.record(z.string(), z.union([\n z.string(),\n z.object({\n fieldIdentifier: z.string(),\n resourceId: z.string()\n })\n ])),\n additionalContext: z.record(z.string(), z.unknown()).optional(),\n});\n\n\n/\n Frontend-native resource configuration types.\n \n Defines the complete frontend configuration for resources and their operations,\n * independent of app type. This replaces the legacy per-app discriminated\n * `ResourceOperationFrontendConfig`.\n \n The resource-level fields (labels, sections, views, empty state, guidance) are\n * written to `FrontendResourceConfiguration.frontendConfiguration` during registry\n * build. The `views` sub-field provides per-operation frontend config — giving\n * a single, self-contained definition of how each resource appears and behaves in\n * a given frontend application.\n \n How to use (authoring): in app code, build a `ResourceUIBehavior` map with\n * `resourceUIBehavior(factory, schema, callback)` and merge presets; the framework\n * compiles that into `FrontendResourceConfiguration` entries. The types below\n * (`ResourceUIBehavior_EmptyState`, `ResourceLayoutConfig`, …) are the pieces you\n * pass inside that callback’s return value.\n /\n\n\n\n// ── Resource frontend config sub-types ──────────────────────────────\n\n/* Secondary action type for empty state (link to URL vs guidance flow). /\nexport enum ResourceFrontend_EmptyStateSecondaryActionType {\n LINK = 'link',\n GUIDANCE = 'guidance',\n}\n\n/* Trigger type for resource-level guidance flows. /\nexport enum ResourceFrontend_GuidanceFlowTriggerType {\n FIRST_VISIT = 'FIRST_VISIT',\n MANUAL = 'MANUAL',\n DELAYED = 'DELAYED',\n EVENT = 'EVENT',\n}\n\n/\n Empty state configuration for list/table views when no items exist.\n * Labels (title, description, primaryActionLabel) come from i18n.\n \n @example\n * ```\n * emptyState: {\n * icon: 'inbox',\n * primaryAction: CoreResourceOperation.CREATE,\n * secondaryAction: { type: ResourceFrontend_EmptyStateSecondaryActionType.LINK, target: 'https://docs.example.com/projects' },\n * }\n * ```\n /\nexport interface ResourceUIBehavior_EmptyState {\n /* Icon ref from the icon registry. If not provided, uses a default empty-state icon. /\n icon?: string;\n /\n Operation ref for the primary CTA (e.g., `CoreResourceOperation.CREATE`).\n * If not provided, auto-detects CREATE from available operations.\n * Set to `false` to explicitly disable the primary action button.\n /\n primaryAction?: string \| false;\n /* Secondary action — link to docs, guidance flow, or external URL. /\n secondaryAction?: {\n type: ResourceFrontend_EmptyStateSecondaryActionType;\n target: string;\n };\n}\n/\n Single guidance element within a resource-level guidance flow.\n * Maps to an OnboardingElement during compilation.\n /\nexport interface ResourceFrontend_GuidanceElement {\n type: OnboardingElementType;\n ref: string;\n targetField?: string;\n targetSelector?: string;\n placement?: TourStepPlacement;\n actionRef?: string;\n steps?: Array<{ ref: string; targetField?: string; targetSelector?: string; placement?: TourStepPlacement }>;\n questions?: Array<{ id: string; type: string; required?: boolean; options?: Array<{ ref: string; value?: string }> }>;\n}\n\n/\n Resource-level guidance flow declaration.\n * Compiled into a standard `GuidanceFlowDefinition` by the guidance-resource-compiler.\n /\nexport interface ResourceUIBehavior_GuidanceFlow {\n ref: string;\n bindToOperation: string;\n renderMode: GuidanceRenderMode;\n trigger: {\n type: ResourceFrontend_GuidanceFlowTriggerType;\n delayMs?: number;\n eventName?: string;\n };\n scope?: GuidanceFlowScope;\n audience?: GuidanceAudience;\n priority?: number;\n elements: ResourceFrontend_GuidanceElement[];\n}\n\n// ── Operation key ───────────────────────────────────────────────────\n\n/\n @wildo_source:part:start saas.frontend.operation-key-and-resource-config-like facet:layer:frontend facet:family:resource-ui\n \n Key identifying a resource operation in the frontend preset.\n \n - `string` — default operation (e.g., `CoreResourceOperation.READ`)\n * - `readonly [string, string]` — non-default variant: `[operationIdentifier, variantKey]`\n * (e.g., `[CoreResourceOperation.READ, 'admin']`)\n \n The same extracted span also includes `FRONTEND_SCHEMA_KEY`, `ObjectShape`,\n * `ResourceConfigLike`, and `TypedOperationKey` — the schema bridge and typed\n * operation keys used by `resourceUIBehavior()` inference.\n /\nexport type OperationKey = string \| readonly [string, string];\n\n\n// ── Schema bridge key ───────────────────────────────────────────────\n\n/\n Symbol key used internally by `resourceUIBehavior()` to attach the schema\n * reference to the config object, and by `buildFrontendResourceConfigurations()`\n * to extract it. Using a Symbol prevents collision with user-defined properties\n * and is invisible in Object.keys()/JSON serialization.\n /\nexport const FRONTEND_SCHEMA_KEY: unique symbol = Symbol('frontendSchema');\n\n\n// ── Typed helper types ──────────────────────────────────────────────\n\n/* Extracts the typed shape from a ZodObject, falls back to Record for non-objects. /\nexport type ObjectShape<T extends z.ZodTypeAny> =\n T extends z.ZodObject<infer S> ? S : Record<string, z.ZodTypeAny>;\n\n/\n Accepts both factory functions and configuration instances for type inference.\n * Used by `resourceUIBehavior()` to infer generics from either form.\n /\nexport type ResourceConfigLike<\n TCustomOp extends EnumLikeType \| undefined,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined,\n TSchema extends z.ZodTypeAny,\n> = ResourceConfiguration<TCustomOp, TCoreOp, TSchema>\n \| ResourceConfiguration_InitializationFactory<TCustomOp, TCoreOp, TSchema>;\n\n/\n Typed operation key — extends `ValidOperationKeys` with variant tuple support.\n * When both generics default to `any`, collapses to `any` — backward compatible\n * with untyped `OperationKey` usage.\n /\nexport type TypedOperationKey<\n TCustomOp extends EnumLikeType \| undefined = any,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined = any,\n> = ValidOperationKeys<TCustomOp, TCoreOp> \| readonly [ValidOperationKeys<TCustomOp, TCoreOp>, string];\n/* @wildo_source:part:end saas.frontend.operation-key-and-resource-config-like /\n\n// ── Operation-level frontend config ─────────────────────────────────\n\n/\n @wildo_source:part:start saas.frontend.resource-operation-frontend-config facet:layer:frontend facet:family:resource-ui\n \n How a resource collection renders its items (cards vs table). A FRONTEND\n * presentation vocabulary — authored on a LIST/SEARCH operation's\n * `collectionDisplayConfig` (below) in the resource UI behavior, NEVER on the\n * shared resources-config operation: the backend has no notion of cards-vs-table.\n * The string values are the persisted view-mode keys, so a stored user choice\n * reads straight across.\n \n @example\n * // resource UI behavior `views` entry:\n * [Op.LIST, { collectionDisplayConfig: { displayMode: CollectionDisplayMode.TABLE, userSwitchableDisplayMode: true } }]\n /\nexport enum CollectionDisplayMode {\n /* Stacked cards — one row per item via `ResourceListItemRenderer`. /\n CARDS = 'cards',\n /* Dense table — one column per summary field via the table body. /\n TABLE = 'table',\n}\n\n/\n A DATE WINDOW named relative to NOW, for a preset filter that must mean the same thing tomorrow.\n \n A preset is authored once and clicked forever, so \"created today\" cannot be an authored pair of\n * instants — it has to be RESOLVED at the moment it is applied. The vocabulary is closed and small\n * on purpose: each member is a window a person actually asks for, and each resolves to the\n * `{ startDate, endDate }` pair the framework's date-range filter already carries end to end, so a\n * preset needs no filter grammar of its own and no backend change.\n \n Resolution is in the VIEWER's timezone, which is the only one that makes \"today\" true for the\n * person reading the screen. The backend compares instants, so the boundaries travel as absolute\n * times and nothing downstream has to know a timezone was involved.\n /\nexport enum CollectionFilterPresetRelativeRange {\n /* Midnight this morning until midnight tonight, local. /\n TODAY = 'today',\n /* The same window, one day back. /\n YESTERDAY = 'yesterday',\n /* The last seven days INCLUDING today — the rolling week, not the last seven whole days. /\n LAST_7_DAYS = 'last_7_days',\n /* The last thirty days including today. /\n LAST_30_DAYS = 'last_30_days',\n /* The first of this calendar month until now. /\n THIS_MONTH = 'this_month',\n /* The first of this calendar year until now. /\n THIS_YEAR = 'this_year',\n}\n\n/\n What a preset ASSIGNS to one filter field.\n \n Two members, and the split is between a value that is FIXED at authoring time and one that can\n * only be known when the pill is clicked. A literal covers every enum value, id, number and flag —\n * which is the whole of \"filter to HIGH priority\". A relative range covers the temporal case, whose\n * defining property is that an authored answer would be wrong by tomorrow.\n \n A NUMERIC BOUND is the third, and it is the one that needed the rest of the stack before it could\n * mean anything: the framework's collection filters carried a date range and scalars and no numeric\n * range, so a preset could have declared \"cost below 500\" and nothing between here and the database\n * would have honoured it. It is expressible now because `Resources_Filter_NumberRangeSchema`, the\n * controller's fail-closed value guard and the cross-adapter normalizer all learned the `{ min, max }`\n * vocabulary — a preset assigning one is writing the same value the filter panel's own two inputs do.\n \n Both bounds optional, for the same reason the schema has them optional: \"under 500\" is a range\n * with no floor, and that is the commonest threshold anyone asks for.\n /\nexport const CollectionFilterPresetValueSchema = z.union([\n z.string(),\n z.number(),\n z.boolean(),\n z.object({ relativeRange: z.enum(CollectionFilterPresetRelativeRange) }),\n z.object({ min: z.number().optional(), max: z.number().optional() }),\n]);\nexport type CollectionFilterPresetValue = z.infer<typeof CollectionFilterPresetValueSchema>;\n\n/\n ONE named, one-click narrowing of a collection, rendered as a toggleable pill above the list.\n \n ## Why this is not `quickFilterField`\n \n They answer different questions and both are worth having. A quick-filter field promotes ONE enum\n * and spends every one of its values on a TAB STRIP: the tabs are mutually exclusive and they read\n * as \"which slice of this collection am I looking at\". A preset is ADDITIVE and crosses fields —\n * \"high priority\", \"created today\", \"unassigned\" — and several can be on at once. Collapsing them\n * would cost one of the two meanings.\n \n ## No state of its own\n \n A preset is a WRITE into the collection's existing filter values, and its ON/OFF is DERIVED by\n * reading them back: it is active exactly when every key it assigns currently holds its value. So\n * clearing a chip, editing the panel, or applying a second preset that touches the same field all\n * update the pills for free, and there is no second copy of the filter state to keep in step.\n /\nexport const CollectionFilterPresetSchema = z.object({\n /\n Stable identity — the i18n key segment and the pill's DOM hook. Author-owned and never shown:\n * the words come from `resources.<type>.filterPresets.<ref>.label`.\n /\n ref: z.string().min(1),\n /\n The fields this preset assigns, and to what. Every key must be a filter field of the operation;\n * a key that is not simply never matches, so the pill would read as permanently off.\n /\n filters: z.record(z.string(), CollectionFilterPresetValueSchema),\n});\nexport type CollectionFilterPreset = z.infer<typeof CollectionFilterPresetSchema>;\n\n/\n How CARDS-mode items are arranged. Orthogonal to {@link CollectionDisplayMode}\n * (this only shapes the CARDS body; TABLE ignores it). LIST and GRID are kept as\n * DISTINCT layouts, not a `columns: 1` collapse — a list is bordered rows sharing\n * one container (`divide-y`), a grid is separated card cells in N responsive\n * columns.\n /\nexport enum CardLayoutStyle {\n /* Bordered rows in a single shared container (the classic stacked list). /\n LIST = 'list',\n /* Separated card cells laid out in an N-column responsive grid. /\n GRID = 'grid',\n}\n/* @wildo_source:part:end saas.frontend.resource-operation-frontend-config /\n\n/\n @wildo_source:part:start saas.frontend.resource-operation-frontend-config facet:layer:frontend facet:family:resource-ui\n \n Frontend configuration for a single resource operation.\n \n Controls how the operation is surfaced in the frontend:\n * - `surface` — the operation's frontend surface: `ADDRESSABLE` (routable page),\n * `EMBEDDED` (non-addressable view rendered within a host: overlay, composite, or\n * nested), or `API_ONLY` (headless — no interface, callable as an API). See\n * `ResourceOperationFrontendSurface`.\n * - `customView` — direct UIBehavior-owned React component override for authored custom operation views.\n * Use the exported operation-family component types (`ResourceReadCustomViewComponent`,\n * `ResourceListCustomViewComponent`, etc.) plus the matching\n * `useReadOperationSurface()` / `useListOperationSurface()` helpers when you\n * want a strongly truthful custom host for a specific layout family.\n * - `displayPresetOverride` — layout preset override for the operation's UI\n * - `navigationOverrides` — per-operation navigation transition overrides\n * - `displayPriority` — visual ordering in ActionBar/operation lists (lower = higher priority)\n * - `iconOverride` — per-operation icon ref (overrides resource-level icon in navigation items)\n * - `collectionDisplayConfig` — for LIST/SEARCH collection operations: the default\n * cards-vs-table body (`displayMode`) and whether the user may toggle it\n * (`userSwitchableDisplayMode`, persisted per resource type); the CARDS\n * arrangement (`cardLayout` — LIST vs N-column GRID); where each card's action\n * buttons sit (`cardActionPlacement` — 2-axis anchor + orientation); and\n * whether items are selectable for bulk actions (`selectable`). Pure frontend\n * presentation; the backend never reads it.\n \n Resource-owned inserted views are NOT configured here. Composite, chart,\n * and execution views declared on the resource UI behavior surface themselves\n * into their targeted operation host directly, via their own canonical fields:\n * `compositeViews[].operationLike` / `chartViews[].operationLike` (single)\n * and `executionViews[].surfaceInOperations` (list). The layout consumer\n (`ResourceLayout_InsertedViews`) reads those declarations and filters them\n * by the current operation at render time — there is no operation-level\n * view-ref list to author or compile.\n \n Historical note (search hit): earlier versions of this schema exposed an\n * `additionalViews: ResourceViewRef[]` (and before that `additionalViewLinks:\n * string[]`) operation-level field that authored which resource-owned views\n * surfaced in this operation. That field was removed in the\n * `resource-owned-view-surfacing-contract.md` workstream because it duplicated\n * the per-view declaration sites (`compositeViews`, `chartViews`,\n * `executionViews`) and could silently disagree with them. If you are looking\n * for `additionalViews` because a doc, comment, prompt, or downstream code\n * still references it, the answer is: declare the surface on the view itself\n * (use `operationLike` for composite/chart, `surfaceInOperations` for\n * execution), do not re-introduce an operation-level seam.\n /\n/\n How an operation's ACTION (its action-bar button) is surfaced in this application.\n \n A per-app, display-only axis — backend authorization is unaffected, roles\n * remain the only security authority, so this never makes an operation reachable\n * that wasn't already; it only governs the button.\n /\nexport enum ActionVisibility {\n /* Always shown; rendered DISABLED when its `enabledCondition` is unmet. The default. /\n ALWAYS = 'always',\n /\n Never shown — this app declares the operation's action off for this surface.\n \n Invariant: do NOT pair with a visible (addressable) view for the same operation.\n * The action is the entry point to the view, so a visible view whose action is\n * hidden is contradictory — there is no way to reach it. Hiding the action removes\n * the operation, and the path to any view it has, from this app's UI.\n /\n HIDDEN = 'hidden',\n /\n Shown ONLY when its `enabledCondition` is met; HIDDEN (not disabled) otherwise.\n \n For state-conditional operations whose disabled state is just noise — e.g.\n * organization `ACTIVATE` appears on a suspended org but vanishes on an active one,\n * rather than sitting there greyed out.\n /\n WHEN_AVAILABLE = 'when_available',\n}\n\n/\n Where an operation's ACTION sits in the action bar for this application.\n \n A per-app, display-only layout axis, orthogonal to authorization. When\n * omitted, placement is DERIVED from the operation's `riskLevel`: HIGH/CRITICAL\n * operations default to `DANGER_ZONE`, everything else to `PRIMARY`. Set it\n * explicitly to override that default — e.g. tuck a non-risky-but-rare action\n * into the danger zone, or keep a CRITICAL action inline in a dedicated admin\n * tool. The same axis drives the bulk action bar, since both are built from the\n * same operation pipeline.\n /\nexport enum ActionPlacement {\n /* Inline in the main action group. The default for low/medium-risk operations. /\n PRIMARY = 'primary',\n /\n Segregated into a trailing \"danger zone\" group, fenced off by a separator,\n * after every PRIMARY action. The default for HIGH/CRITICAL-risk operations\n * (destructive deletes, lifecycle suspends).\n /\n DANGER_ZONE = 'danger_zone',\n}\n\n/\n HOW an operation's action collects its input and shows its result — the chrome the user meets\n * when they click the button.\n \n ## Why this axis exists\n \n Until this axis, one rule decided the answer for every custom operation:\n * has a `requestDto` ⇒ navigate. So an action asking for a single reason string got the same\n * full-page treatment as a multi-step wizard, and the only way out was to author\n * `navigationOverrides` — per operation, in terms of a zone, a transition verb and an appearance.\n * Three concepts to answer one question.\n \n This is that one question. It is a display-only axis: backend authorization is untouched and\n * `roles` remain the only security authority, exactly like its siblings {@link ActionVisibility},\n * {@link ActionPlacement} and {@link ResourceOperationActionScope}.\n \n ## It is an ALIAS, not a parallel mechanism\n \n `MODAL` and `PAGE` do not render anything themselves — they resolve to the navigation transitions\n * that already exist (`OVERLAY`, and the ordinary chain), so there is one runtime mechanism and one\n * set of zone/appearance/URL semantics. `DIRECT`, `POPOVER` and `INLINE` never enter navigation at\n * all, because none of them is a destination: nothing is pushed, no zone changes, and there is\n * nothing for a back button to pop. `INLINE` is hosted by the collection the element belongs to —\n * see `InPlaceOperationContext` for why that is not the navigation layer's job.\n \n Consequently an explicit `navigationOverrides` entry still WINS over a presentation authored here\n * (it is the more specific instrument, and it is checked first in the resolution chain). Author this\n * axis to say what KIND of chrome the action wants; author `navigationOverrides` when you need to\n * name the zone, the appearance or the viewport yourself.\n \n ## When omitted\n \n It is DERIVED from the operation — see `resolveResourceOperationActionPresentation()`. An\n * operation that asks for nothing executes directly; a small field set opens a modal; input the\n * framework cannot fit in an overlay (files, nested writes, a large field set) keeps the page it\n * has always had. An operation whose `surface` is `ADDRESSABLE` always keeps its page: the author\n * has already said it is a deep-linkable destination.\n /\nexport enum ResourceOperationActionPresentation {\n /\n Execute on click, with no form at all — the confirmation dialog for a risky operation is the\n * only thing between the click and the request.\n \n Only meaningful for an operation that needs no caller input. Declaring it on an operation that\n * DOES have required request fields would send an empty body, so the resolver refuses to derive it\n * there and an author who declares it anyway gets the operation's fields dropped — check\n * `requestDto` before reaching for this.\n /\n DIRECT = 'direct',\n /\n A small form anchored to the button that opened it, dismissed by clicking away.\n \n The single-input idiom (\"assign to…\", \"snooze until…\"). Transient by construction: no URL, no\n * history entry, nothing to deep-link. Use it when the surrounding context is the point — the user\n * is reading the row they are acting on and must not lose sight of it.\n /\n POPOVER = 'popover',\n /\n The element being acted on transforms in place to collect the input, leaving its neighbours\n * visible — the row becomes the form rather than being covered by one.\n \n Use it when the surrounding rows are the point: the user is comparing, and an overlay would hide\n * the very thing that made them act on this row.\n \n Transient, like {@link POPOVER}, and for the same reason. Nothing is pushed, no URL changes,\n * and a reload returns the list to rest. An inline row-edit is a momentary state of a listing, not\n * a place — which is also why no admin framework deep-links one, and why anything that SHOULD be\n * linkable, reloadable or reachable by a back button wants {@link PAGE}.\n \n It requires a collection. The host is provided by the list the element belongs to\n * (`InPlaceOperationProvider`); the same action rendered on a detail page, in a danger zone or in a\n * picker has no row to transform and degrades to an overlay rather than becoming a dead button.\n \n Note it does NOT resolve to `NavigationTransition.INPLACE`. Element-level hosting uses none of\n * what the navigation layer offers — no zone, no stack entry, no appearance — and routing it there\n * is exactly why that transition has never done what its own docstring promises. See\n * `InPlaceOperationContext`.\n /\n INLINE = 'inline',\n /\n An overlay above the layout — the workhorse for \"a handful of fields\", and the default the\n * derivation reaches for.\n \n Resolves to {@link NavigationTransition.OVERLAY}. The concrete appearance (dialog / sheet /\n * drawer / panel) stays the app's decision, resolved from its navigation layout exactly as any\n * other overlay: this axis says \"an overlay\", not \"a dialog specifically\". Author\n * `navigationOverrides` when you need to name one.\n /\n MODAL = 'modal',\n /\n A routable page, resolved through the ordinary navigation chain (zone transitions, viewport\n * overrides, the framework `PUSH` fallback) — i.e. exactly the behaviour every parameterised\n * action had before this axis existed.\n \n The right answer for complex or multi-step input, and for anything a user should be able to\n * link to, reload, or reach with a back button.\n /\n PAGE = 'page',\n}\n\n/\n Does an operation's action target a SINGLE resource instance, or the WHOLE\n * collection in the current scope?\n \n A per-app surfacing axis, orthogonal to authorization. Most actions are\n * `ITEM` (edit / delete / retry one row) and render in the per-row and detail\n * action bars. A `COLLECTION` action operates on every row in scope at once\n * (e.g. \"retry all failed deliveries\", \"purge the queue\"): it renders ONCE in\n * the list's collection-action surface (the toolbar), never per row, and\n * confirms + executes in place rather than opening a per-row form.\n \n For a `COLLECTION` action to have a callable route, its operation must borrow\n * a COLLECTION verb via `resourceOperationLike` (`UPDATE_MANY` / `DELETE_MANY` /\n * `CREATE_MANY`) — an entity verb (`UPDATE` / `DELETE`) generates a route with a\n * `:id` segment the scope-level surface has no single row to fill.\n /\nexport enum ResourceOperationActionScope {\n /* Targets one resource instance — the per-row / detail action bars. The default when omitted. /\n ITEM = 'item',\n /* Targets the whole collection in scope — rendered once in the list's collection-action surface. /\n COLLECTION = 'collection',\n}\n\n/\n What happens to an operation's action when its `enabledCondition` is currently\n * unmet — the per-view default for actions that don't declare an explicit\n * `actionVisibility`. An explicit per-operation `actionVisibility` always wins\n * over this policy; feature-gated unavailability keeps its own\n * `FeatureUnavailabilityBehavior` (upgrade/prompt) and is never hidden by this.\n \n - `HIDE` — drop the action entirely while unavailable (as if it declared\n * `ActionVisibility.WHEN_AVAILABLE`). The framework default for BOTH views: a\n * greyed, non-actionable button is noise wherever it sits, and hiding it also\n * collapses mutually-exclusive state pairs (e.g. \"Set as recurring\" / \"Set as\n * one time\") down to the one that currently applies.\n * - `SHOW_DISABLED` — render the action greyed/disabled (the classic behavior).\n * Opt in per view when the disabled action + its reason tooltip is genuinely\n * informative and you want it always present.\n /\nexport enum DisabledActionHandling {\n SHOW_DISABLED = 'show_disabled',\n HIDE = 'hide',\n}\n\n/\n Per-view action-surfacing (disclosure) policy — how many actions stay visible\n * and how unavailable ones are treated, for ONE {@link ResourceOperationDisplayMode}.\n /\nexport interface ResourceActionDisclosureConfig {\n /\n How many PRIMARY actions render as direct buttons before the remainder\n * collapse into the `…` overflow menu. Omitted inherits the framework default\n * for the view ({@link DEFAULT_ACTION_DISCLOSURE}): 3 for SUMMARY, unlimited\n * for DETAIL. `0` pushes every action into the menu.\n /\n maxPrimaryActions?: number;\n /\n Default handling for actions disabled by an unmet `enabledCondition` — see\n * {@link DisabledActionHandling}. Omitted inherits the framework default:\n * `HIDE` on SUMMARY rows, `SHOW_DISABLED` on DETAIL (where each unavailable\n * action explains why it cannot run).\n /\n disabledActionHandling?: DisabledActionHandling;\n}\n\n/* Fully-resolved disclosure policy (no optional fields) for one view. /\nexport interface ResolvedActionDisclosure {\n /* `undefined` = unlimited (no overflow cap). /\n maxPrimaryActions: number \| undefined;\n disabledActionHandling: DisabledActionHandling;\n}\n\n/\n Framework defaults per view.\n \n - SUMMARY (dense list/table rows) HIDES actions an unmet `enabledCondition`\n * disables and caps direct actions at 3 before the `…` menu: on a row, a greyed\n * button is noise repeated N times.\n * - DETAIL (the read view and the bulk bar) SHOWS them, uncapped. Both views used\n * to hide, on the reasoning that \"an inapplicable, greyed button is noise\" — true\n * of a greyed button that explained nothing. An unavailable action now opens its\n * reason (and, for a bulk selection, offers to keep only the eligible rows), so on\n * the surface where someone is deciding what to do, hiding it would hide the\n * answer to \"why can't I?\".\n \n A resource overrides either view via `layout.actionDisclosure`.\n /\nexport const DEFAULT_ACTION_DISCLOSURE: Record<ResourceOperationDisplayMode, ResolvedActionDisclosure> = {\n [ResourceOperationDisplayMode.SUMMARY]: {\n maxPrimaryActions: 3,\n disabledActionHandling: DisabledActionHandling.HIDE,\n },\n /\n * A roomy surface SHOWS what cannot run, because an unavailable action now explains itself (its\n * reason opens on activation — `ActionBarUnavailability`). Hide what is irrelevant, disable and\n * explain what is temporarily unavailable: hiding it here would also hide the answer to \"why can't\n * I?\". This was HIDE from the day it was written, while the hook's own comment and Wonder Todos'\n * override both said DETAIL shows the unavailable — the default contradicted the stated design. The\n * bulk bar renders in DETAIL, so a bulk action a selection does not qualify for is now visible and\n * says which rows are the problem.\n /\n [ResourceOperationDisplayMode.DETAIL]: {\n maxPrimaryActions: undefined,\n disabledActionHandling: DisabledActionHandling.SHOW_DISABLED,\n },\n};\n\n/\n Resolve the effective disclosure policy for a view: per-resource override\n * (`layout.actionDisclosure[view]`) layered over the framework default. Used by\n * both the action-building hook (disabled handling) and the operations-items\n * host (overflow cap).\n /\nexport function resolveActionDisclosure(\n displayMode: ResourceOperationDisplayMode,\n disclosure: Partial<Record<ResourceOperationDisplayMode, ResourceActionDisclosureConfig>> \| undefined,\n): ResolvedActionDisclosure {\n const base = DEFAULT_ACTION_DISCLOSURE[displayMode] ?? DEFAULT_ACTION_DISCLOSURE[ResourceOperationDisplayMode.DETAIL];\n const override = disclosure?.[displayMode];\n return {\n maxPrimaryActions: override?.maxPrimaryActions ?? base.maxPrimaryActions,\n disabledActionHandling: override?.disabledActionHandling ?? base.disabledActionHandling,\n };\n}\n\n/\n 2-axis card action-button placement. Single source of truth for the config\n * field AND the `card-action-placement.utils` resolver (which imports the\n * `CardActionPlacement` type inferred from this schema, so the two can never\n * drift). `MIDDLE × MIDDLE` is rejected — dead-center overlaps the card content.\n /\nexport const CardActionPlacementSchema = z.object({\n vertical: z.enum(VerticalPlacement),\n horizontal: z.enum(HorizontalPlacement),\n orientation: z.enum(DisplayDirection).optional(),\n}).refine(\n (p) => !(p.vertical === VerticalPlacement.MIDDLE && p.horizontal === HorizontalPlacement.MIDDLE),\n { message: 'cardActionPlacement cannot be MIDDLE × MIDDLE (dead-center overlaps card content); choose an edge or corner.' },\n);\n\n/* Authored 2-axis card action placement — inferred from {@link CardActionPlacementSchema}. /\nexport type CardActionPlacement = z.infer<typeof CardActionPlacementSchema>;\n\n/\n Who paints the identity GLYPH on this operation's page header.\n \n The header band renders the resource's registry icon beside the identity line by default. A\n * `layout.header` template that composes its own record-linked glyph (a per-row kind icon, a\n * per-family symbol) would otherwise sit BESIDE the resource icon — two glyphs naming one thing.\n \n Declared at the OPERATION layer rather than detected from the template, deliberately: the\n * resource icon renders before the template mounts, so detection could only suppress it after the\n * fact — a glyph that flashes and vanishes on every load. Mirrors\n * `SummaryTitlePlacement.TEMPLATE_OWNED`, the same contract one surface over: ceding a\n * framework-owned element to the template is a declaration, not an inference.\n /\nexport enum HeaderIconPlacement {\n /* The framework renders the resource's registry icon (default). /\n AUTO = 'auto',\n /* The header template owns the glyph; the framework renders none. /\n TEMPLATE_OWNED = 'template_owned',\n}\n\nexport const ResourceOperationFrontendConfigSchema = z.object({\n /\n The operation's frontend surface — see {@link ResourceOperationFrontendSurface}.\n * `ADDRESSABLE` (routable page) and `EMBEDDED` (non-addressable view rendered within\n * a host — overlay/composite/nested) both have a view + action button; `API_ONLY` is\n * headless (no view, no button). The view fields below (`actionVisibility`,\n * `customView`, `iconOverride`, layout, …) apply only to `ADDRESSABLE`/`EMBEDDED`; a\n * build-time check rejects them on `API_ONLY`.\n * Replaces the former `isAddressable` boolean — read via `isOperationAddressable()`.\n /\n surface: z.enum(ResourceOperationFrontendSurface),\n /* Who paints the page header's identity glyph — see {@link HeaderIconPlacement}. Omitted = AUTO. /\n headerIconPlacement: z.enum(HeaderIconPlacement).optional(),\n /\n How this operation's action is surfaced — see {@link ActionVisibility}. Omitted\n * (the common case) behaves as `ALWAYS`.\n /\n actionVisibility: z.enum(ActionVisibility).optional(),\n /\n Where this operation's action sits in the bar — see {@link ActionPlacement}.\n * Omitted derives from `riskLevel` (HIGH/CRITICAL → danger zone, else primary).\n /\n actionPlacement: z.enum(ActionPlacement).optional(),\n /\n Visual button variant (colour) for this operation's action — a\n * `ButtonVariants_Variant` (e.g. `DESTRUCTIVE`, `GHOST`, `ACCENT`). Omitted\n * derives from `riskLevel` (HIGH/CRITICAL → destructive/red, else ghost). Typed\n * on the interface below; the Zod field stays `z.any()` because the enum lives\n * in a component module a schema must not pull at runtime (same as `iconOverride`).\n /\n actionVariant: z.any().optional(),\n /\n Does this action target one row or the whole collection — see\n * {@link ResourceOperationActionScope}. Omitted behaves as `ITEM`. A\n * `COLLECTION` action renders once in the list's collection-action surface\n * (never per row) and confirms + executes in place; pair it with a COLLECTION\n * `resourceOperationLike` (`_MANY`) so its generated route carries no `:id`.\n /\n actionScope: z.enum(ResourceOperationActionScope).optional(),\n /*\n For an `ITEM` action whose backend addresses the target row by a field in\n * the REQUEST BODY (not the URL id), the request-DTO field name to fill with\n * the clicked row's id. When set, clicking the action executes IN PLACE —\n * sending `{ [rowTargetRequestField]: <rowId> }` — instead of opening a form:\n * e.g. a per-row \"Retry\" whose handler reads `{ entryId }` from the body. (The\n * row id still rides the URL path too, which the handler may ignore.)\n /\n rowTargetRequestField: z.string().optional(),\n /\n HOW this action collects its input — see {@link ResourceOperationActionPresentation}.\n * Omitted derives from the operation (`resolveResourceOperationActionPresentation`): no input\n * executes directly, a small field set opens a modal, complex input keeps its page.\n \n Display-only. An explicit `navigationOverrides` entry is the more specific instrument and wins\n * over whatever this resolves to.\n /\n actionPresentation: z.enum(ResourceOperationActionPresentation).optional(),\n customView: z.any().optional(),\n displayPresetOverride: z.object({\n resourceLayoutPresetKey: z.string().optional(),\n }).optional(),\n navigationOverrides: z.array(NavigationOperationOverrideSchema).optional(),\n displayPriority: z.number().optional(),\n iconOverride: z.any().optional(),\n collectionDisplayConfig: z.object({\n displayMode: z.enum(CollectionDisplayMode).optional(),\n userSwitchableDisplayMode: z.boolean().optional(),\n /\n Promote ONE enum filter field to a prominent quick-filter tab strip\n * rendered above the collection toolbar (\"All · <value> · <value> …\" —\n * the Stripe/Ignisign webhook-dashboard idiom, e.g. All/Delivered/Failed).\n \n The named field MUST be an enum member of the operation's backend\n * `filterFields` — the tabs write into the SAME filter state as the\n * filters panel (selecting a tab filters server-side), and the field is\n * removed from the panel/chips so there is never a second competing\n * control for it. Unknown / non-enum field names degrade gracefully\n * (no tab strip, field stays in the panel). Tab labels reuse the enum\n * value i18n (`tResourceFieldEnumValue`).\n /\n quickFilterField: z.string().optional(),\n /\n Named one-click narrowings, rendered as a row of toggleable pills between the quick-filter\n * tabs and the toolbar. See {@link CollectionFilterPresetSchema} for the semantics and for why\n * this is not the same mechanism as `quickFilterField`.\n \n Each preset's words come from `resources.<resourceType>.filterPresets.<ref>.label`; a preset\n * whose label is not authored renders its raw `ref`, so a missing label LOOKS missing instead\n * of being invented from the identifier.\n \n @example\n * presetFilters: [\n * { ref: 'urgent', filters: { priority: 'high' } },\n * { ref: 'created-today', filters: { createdAt: { relativeRange: CollectionFilterPresetRelativeRange.TODAY } } },\n * ]\n /\n presetFilters: z.array(CollectionFilterPresetSchema).optional(),\n /\n Group CARDS-mode rows into day buckets by this date field, rendering a\n * date heading between groups (activity-feed idiom for log-like\n * collections, e.g. webhook deliveries by day). Purely presentational:\n * grouping applies to the fetched page in its server order — pair it\n * with a default sort on the same field so buckets are contiguous.\n * Ignored in TABLE mode (column sorting owns the ordering there). Rows\n * whose field value is missing/unparsable render in a trailing bucket\n * without a date heading rather than being dropped.\n /\n temporalGroupField: z.string().optional(),\n /\n Group CARDS-mode rows into buckets by this ENUM field, rendering the\n * enum value's own label as a heading between groups.\n \n Sibling of {@link temporalGroupField}, and deliberately NOT the same\n * algorithm. Temporal grouping ADJACENT-MERGES in server order, because\n * dates are open-ended and a page can legitimately revisit one. An enum is\n * a CLOSED, ORDERED vocabulary, so its buckets are emitted in the enum's\n * DECLARATION ORDER regardless of the order rows arrived in — the\n * declaration is the authority for \"which concern comes first\", and a\n * server sort cannot express it without a second, drifting copy of that\n * order. Rows are therefore collected across the whole fetched page rather\n * than merged adjacently, and no sort needs pairing with it.\n \n Headings resolve through `tResourceFieldEnumValue` — the SAME source the\n * filters panel and the promoted quick-filter tabs use, so a bucket\n * heading and its tab can never disagree.\n \n Ignored in TABLE mode (column sorting owns the ordering there). Rows\n * whose value is absent, or outside the vocabulary, render in a trailing\n * bucket with no heading rather than being dropped — the same fail-open\n * the temporal grouping makes.\n /\n enumGroupField: z.string().optional(),\n /\n CARDS-mode arrangement — a single-column bordered LIST (default) or an\n * N-column responsive GRID. See {@link CardLayoutStyle}. `columns` (1–6) is\n * the TARGET maximum; the grid steps DOWN to fewer columns as the grid's own\n * available WIDTH narrows (an intrinsic `auto-fill minmax` track spec — so a\n * grid embedded in a narrow pane collapses even on a wide viewport, with no\n * media breakpoint). Authors give one N; the framework handles the rest.\n * Ignored in TABLE mode.\n \n @example\n * cardLayout: { style: CardLayoutStyle.GRID, columns: 3 }\n /\n cardLayout: z.discriminatedUnion('style', [\n z.object({ style: z.literal(CardLayoutStyle.LIST) }),\n z.object({\n style: z.literal(CardLayoutStyle.GRID),\n columns: z.number().int().min(1).max(6),\n }),\n ]).optional(),\n /\n Where each card's per-item action buttons sit, as a 2-axis anchor:\n * `vertical` ({@link VerticalPlacement} TOP/MIDDLE/BOTTOM) × `horizontal`\n * ({@link HorizontalPlacement} START/MIDDLE/END, RTL-aware). `orientation`\n * ({@link DisplayDirection}) lays the button set out as a row (HORIZONTAL,\n * default) or a vertical stack (VERTICAL). Omitted → the classic\n * MIDDLE × END horizontal row.\n \n `MIDDLE × MIDDLE` is rejected (dead-center overlaps the card content and\n * has no sensible meaning).\n \n @example\n * cardActionPlacement: { vertical: VerticalPlacement.TOP, horizontal: HorizontalPlacement.END }\n /\n cardActionPlacement: CardActionPlacementSchema.optional(),\n /\n Enable per-item SELECTION (checkboxes on cards / a select column in the\n * table) and the resulting BULK ACTION bar. Explicit opt-in per view. The\n * bar surfaces only operations declared `isBulkOperation` — a `selectable`\n * view with no bulk operations shows checkboxes that drive an empty bar, so\n * pair it with at least one bulk operation. Selection state is shared across\n * the cards↔table toggle (it does not reset when switching modes).\n /\n selectable: z.boolean().optional(),\n }).optional(),\n /\n Opt this operation into a generated per-operation description label\n * (`resources.{res}.operations.{op}.description`, read via `tResourceOperation`).\n * Default off — most operations need no description (making it mandatory for\n * every operation is far too verbose). Surfaces that show one (e.g. the danger\n * zone) fall back to risk-based copy when this is unset. Mirrors how fields opt\n * into a description via the `.describe()` decorator.\n /\n hasDescription: z.boolean().optional(),\n /\n What happens to an ADJACENT zone (secondary / companion) this operation\n * splits into, once that zone's last content is dismissed — overriding the\n * zone's own `onEmpty` while this operation occupies primary.\n \n The zone-level `ZoneConfig.onEmpty` is one value for every destination that\n * splits into that zone, and destinations legitimately disagree: a LIST wants\n * the detail pane to stay put (`EMPTY_STATE`) so the layout does not reflow\n * while a reviewer steps through rows, while a CANVAS wants its width back\n * (`COLLAPSE`) the moment nothing is selected. Both share one secondary zone,\n * so without this override one of them is always wrong.\n \n Declared on the SOURCE operation — the one occupying primary — not on the\n * operation that lands in the pane: it answers \"what should MY layout do when\n * the detail closes\", which is a property of the surface being returned to.\n \n Omitted (the common case) defers to the zone, which itself defaults to\n * `ZoneEmptyBehavior.COLLAPSE`. Resolution order is destination → zone →\n * COLLAPSE; see `resolveZoneEmptyBehavior`.\n /\n adjacentZoneOnEmpty: z.enum(ZoneEmptyBehavior).optional(),\n /\n How wide this destination's content may grow in the zone, in the framework's shared width\n * vocabulary — the SAME `ResponsiveMaxWidth` a Surface, a `DisplayLayout` and a `FormLayout` use.\n \n Omitted (the common case) is `'content'`: capped and centred at `var(--content-max-width, 80rem)`,\n * right for a form, a list or a detail page and wrong only for content whose value IS the space it\n * occupies — a board, a wide table, a canvas — which declare `'none'`.\n /\n zoneContentMaxWidth: z.enum(RESPONSIVE_MAX_WIDTH_VALUES).optional(),\n /\n Whether this destination's content fills the zone's HEIGHT as well.\n \n `true` makes the zone's content boundary a definite-height flex column, so this view's root may use\n * `flex-1 min-h-0` and resolve against something real. Without it a canvas has no intrinsic height\n * and collapses to zero — which is why one had to hand-roll `h-[70vh]`, sizing against the WINDOW\n * rather than the container it sits in. PRIMARY only: an adjacent zone scrolls, so a filling child\n * and a scrolling parent contradict each other.\n \n Separate from the width above ON PURPOSE — see `zone-content-geometry.ts` for why the enum that\n * fused them could not express a capped width with a definite height.\n /\n zoneContentFillsHeight: z.boolean().optional(),\n});\n\n/\n TypeScript interface for `ResourceOperationFrontendConfigSchema`.\n * `iconOverride`, `customView`, and `actionVariant` are typed with their real\n * React/enum values even though the Zod schema uses `z.any()` — Zod cannot\n * validate function types, and `actionVariant`'s enum lives in a component\n * module the schema must not import at runtime.\n /\nexport type ResourceOperationFrontendConfig = Omit<z.infer<typeof ResourceOperationFrontendConfigSchema>, 'iconOverride' \| 'customView' \| 'actionVariant'> & {\n iconOverride?: IconLike;\n customView?: React.ComponentType;\n actionVariant?: ButtonVariants_Variant;\n};\n/* @wildo_source:part:end saas.frontend.resource-operation-frontend-config /\n\n/\n Is this operation's frontend surface URL-addressable (a routable page)?\n \n The canonical replacement for the former `isAddressable` boolean field — read\n * `surface` rather than storing addressability, so the three surfaces stay a\n * single source of truth. Safe on `undefined` (an operation whose frontend\n * config has not been resolved yet is treated as not addressable).\n /\nexport function isOperationAddressable(\n config?: Pick<ResourceOperationFrontendConfig, 'surface'>,\n): boolean {\n return config?.surface === ResourceOperationFrontendSurface.ADDRESSABLE;\n}\n\n/\n Is this operation headless — callable as an API with no rendered interface\n * (no page, no overlay, no action button)? See {@link ResourceOperationFrontendSurface.API_ONLY}.\n /\nexport function isOperationHeadless(\n config?: Pick<ResourceOperationFrontendConfig, 'surface'>,\n): boolean {\n return config?.surface === ResourceOperationFrontendSurface.API_ONLY;\n}\n\n/\n Does this operation's action target the whole collection in scope, rather than\n * a single row? See {@link ResourceOperationActionScope}. Safe on `undefined`\n * (treated as `ITEM`). Collection-scoped actions render ONLY in the list's\n * collection-action surface (the toolbar) and are excluded from the per-row,\n * detail, danger-zone, and bulk bars.\n /\nexport function isCollectionScopedOperation(\n config?: Pick<ResourceOperationFrontendConfig, 'actionScope'>,\n): boolean {\n return config?.actionScope === ResourceOperationActionScope.COLLECTION;\n}\n\n/\n Resource-owned composite templates keyed by view ref (authoring form).\n \n How to use: set `compositeViews` on `ResourceUIBehaviorConfig` to\n * `ResourceCompositeViewAuthoringConfig` objects. Each composite renders\n * inside exactly one resource operation host, declared via\n * {@link ResourceCompositeViewAuthoringConfig.operationLike} (defaulting to\n * `CoreResourceOperation.READ`). Prefer `executionViews` / `chartViews` for\n * those families instead of overloading composites.\n \n Note: this type is distinct from `AppCompositeViewsConfig`. Only\n * resource composites carry `operationLike`, because app-level composites have\n * no resource operation host to surface into.\n /\nexport type ResourceCompositeViewsConfig = Record<string, ResourceCompositeViewAuthoringConfig>;\n\n\n// ── Resource-level label function params ────────────────────────────\n\n/\n Parameters passed to `getFrontendResourceLabel` functions.\n \n Generic `TMainSchema` defaults to `z.ZodAny` — presets and records use the\n * default (giving `currentObject: any`), while app-level configs can narrow it\n * to a concrete schema for type-safe field access.\n /\nexport type ResourceUIBehaviorLabelParams<TMainSchema extends z.ZodTypeAny = z.ZodAny> = {\n currentObject: z.infer<TMainSchema>;\n objectContext: any;\n initiatorUserContext?: any;\n t: (toTranslate: string, params?: Record<string, any>) => string;\n};\n\n// ── Layout system types (Phase 5) ───────────────────────────────────\n\n/* @wildo_source:part:start saas.frontend.resource-layout-templates facet:layer:frontend facet:family:resource-ui /\n/\n Static manifest of structural refs used in JSX templates.\n * Readable by the companion without JSX/AST parsing.\n \n Produces i18n keys:\n * - `resources.{type}.sections.{ref}.title`\n * - `resources.{type}.sections.{ref}.description`\n * - `resources.{type}.wizardSteps.{ref}.title`\n * - `resources.{type}.wizardSteps.{ref}.description`\n * - `resources.{type}.groups.{ref}.title`\n /\nexport interface LayoutRefManifest {\n /* Section names used in `<Section name=\"...\">` components. /\n sections?: string[];\n /* Wizard step names used in `<WizardStep name=\"...\">` components. /\n wizardSteps?: string[];\n /* Group names used in `<Group name=\"...\">` components. /\n groups?: string[];\n}\n\n/\n Layout template — a React component rendered inside the appropriate provider stack.\n \n - Edit context: rendered inside `<Form>` providers. Use `useFormTemplateContext()` for\n * labels/schema/operation and `useWatch()` for field-reactive branching.\n * - Display context: rendered inside `<DisplayTemplateProvider>` by `AutomaticDisplayer`.\n * Use `useDisplayTemplateContext()` for `data`, `isLoading`, `schema`, labels, and breakpoint.\n * - Summary context: same as display, rendered by `ResourceSummaryDisplayer` with\n * `disableInlineEdit={true}` and compact chrome (INLINE default).\n /\nexport type LayoutTemplate = React.ComponentType;\n\n/\n Resource layout configuration — template-based layout for forms and displays.\n \n Templates use skeleton components (`<FormField>`, `<Section>`,\n * `<WizardLayout>`, `<DisplayField>`, etc.) with Tailwind CSS for positioning.\n * Conditional visibility is handled with `useWatch()` and standard React conditionals.\n \n When no template is provided for a context, the framework generates a\n * default flat template at runtime from the schema.\n \n How to use: set `layout: { refs, edit, display, summary }` on the object returned\n * from `resourceUIBehavior()`. Every `<Section name=\"…\">`, `<WizardStep name=\"…\">`, and\n * `<Group name=\"…\">` in those templates should appear under `refs` for i18n and\n * companion validation. Omit `edit` / `display` / `summary` individually to keep the\n * auto-generated default for that context only.\n /\n/\n How a layout decides which of its fields may be edited IN PLACE on the READ surface.\n \n ## Why this is a layout decision and not only a per-field one\n \n Inline edit was per-field only: a field became editable in place by declaring\n * `{primitive}UI.display.inlineEditable`. That is right for an ordinary resource, where editing a\n * row is an occasional act and a READ page is mostly for reading.\n \n It is the wrong default for a SETTINGS layout, and the Settings hub measured the cost. A settings\n * pane is a list of DECISIONS an operator came to take, so a read-only rendering of a policy is not\n * a conservative choice — it is a pane that cannot do its job. Measured 2026-09-19 on the running\n * dogfood application: `organizationSsoConfig` declares 24 fields across seven sections, including\n * `enforcement.requireSSO` and `enforcement.allowPasswordFallback`, and NOT ONE declared\n * `inlineEditable`. Every boolean therefore rendered through `BooleanDisplayMode.CHECKMARK` — a\n * read-only ✓ or ✕ glyph, where ✕ is also indistinguishable from a remove affordance — and the only\n * way to change a policy was a pencil that flipped the entire pane into a form.\n \n The per-field remedy is to write `.inlineEditable()` on all 24, and on every field added to any\n * settings schema afterwards. That is a hand-kept list of somebody else's population: correct on the\n * day it is written and silently incomplete forever after, because nothing goes red when the\n * twenty-fifth field is added without it.\n \n So the layout — which already knows it is a settings surface, because it sets\n * `defaultChromeMode: { display: SETTINGS_ROW }` — declares it once, and the set is DERIVED over\n * the layout's fields rather than enumerated.\n /\nexport enum ResourceLayoutInlineEditDefault {\n /\n No default. Only a field carrying `{primitive}UI.display.inlineEditable` is editable in place.\n * This is the system default and the correct choice for an ordinary resource READ page.\n /\n NONE = 'none',\n\n /\n Every WRITABLE field in this layout is editable in place, unless it declines.\n \n Eligibility is `isEligibleForLayoutDefaultInlineEdit` in `@wildo-ai/zod-decorators` — not the\n * primary key, not `.excludeFromUpdate()`, not `.isHidden()`, and not an explicit\n * `inlineEditable: false`. A field declaring `inlineEditable` with PARAMS still wins: the default\n * decides WHETHER, the decorator decides HOW.\n /\n WRITABLE_FIELDS = 'writable-fields',\n}\n\nexport interface ResourceLayoutConfig {\n\n /\n Companion-readable manifest of all structural names used in templates.\n * Required for i18n label generation.\n * Dev-time validation cross-checks manifest names against template `name` props.\n /\n refs?: LayoutRefManifest;\n\n /\n Whether this layout's READ surface offers its writable fields for in-place editing without\n * each one declaring `inlineEditable` for itself. See {@link ResourceLayoutInlineEditDefault}.\n \n Renderers read:\n * `{primitive}UI.display.inlineEditable ?? (layout.defaultInlineEdit === WRITABLE_FIELDS && eligible)`\n \n Defaults to {@link ResourceLayoutInlineEditDefault.NONE}, so no existing resource changes\n * behaviour by this field being added. Turning it on is the settings-surface opt-in, and it pairs\n * with `defaultChromeMode.display: SETTINGS_ROW` — the row geometry that gives the control\n * somewhere to sit.\n \n This does not bypass authorization. `canInlineEdit` on the display context still requires a\n * usable UPDATE path (an RMM, an `onInlineEdit`, or a real UPDATE operation the caller may\n * perform), so a layout that turns this on for a reader who cannot write still renders read-only.\n /\n defaultInlineEdit?: ResourceLayoutInlineEditDefault;\n\n /\n How an EMPTY field renders on this layout's read surface, overriding the surface policy.\n \n ## Why a layout may outrank the surface here\n \n `AutoEmptyValue` is declared per SURFACE VARIANT — BASE, RAISED, OVERLAY and INSET all default\n * to `em-dash`. That is a sensible default for a surface, which knows nothing about the fields it\n * happens to contain: in a dense table or a summary card a dash is exactly right, because the\n * reader is scanning and the row's meaning comes from its neighbours.\n \n A settings pane is the opposite case. Its rows ARE the content, an operator reads one at a time\n * to decide something, and an em dash there is an answer that refuses to say which of four things\n * it means — a field awaiting their input, a list with no members, or a computed value nothing has\n * produced yet (see `DisplayEmptyReason`). `placeholder` renders the reason's own words instead:\n * \"No value\", \"None yet\", \"Not available\".\n \n Declared on the LAYOUT because that is the thing that knows it is a settings surface — it is\n * already saying so with `defaultChromeMode.display: SETTINGS_ROW` and `defaultInlineEdit` — and\n * because a per-field declaration would be a hand-kept list that goes silently incomplete the\n * first time a field is added without it.\n \n ## What it costs, stated plainly\n \n It outranks the resolved surface policy, and this seam cannot distinguish a variant's DEFAULT\n * from a deliberate per-surface `policyOverride` — both arrive as the same resolved value. So a\n * layout that sets this wins over both. That is what a settings layout wants and it is why the\n * field exists; a layout with no opinion omits it and every surface keeps its own policy exactly\n * as before.\n /\n defaultEmptyValue?: AutoEmptyValue;\n\n /\n The container mode this layout's DISPLAY sections adopt when they declare none of their own.\n \n ## What it is for\n \n A section's `appearance` is a per-section prop, and the container modes — `VERTICAL_TABS`,\n * `TABS`, `ACCORDION`, `GRID` — are not really per-section decisions at all. Grouping keys on\n * `(mode, its mode-specific props)` over CONSECUTIVE siblings, so a set of sections becomes one\n * container only when every member declares the same mode with the same props and nothing\n * separates them. Declared per section that is an agreement N authors must keep; one that slips\n * does not fail, it silently renders TWO rails, or one rail and a stray bare section.\n \n So the declaration belongs where the decision does: the layout knows it is a settings pane with\n * seven groups of fields, and says it once. A section that declares its own `appearance` still\n * wins — this is the fallback, not an override.\n \n ## Why DISPLAY only, in the name\n \n `defaultChromeMode` carries display / summary / edit keys, and a bare `defaultSectionAppearance`\n * would read as covering the same three while covering one. An edit form's section grouping is a\n * different question — a wizard's steps, a form's save boundaries — and nothing asks for it yet.\n * The name says which surface it governs so the answer is not assumed.\n \n ## It also decides how much ROOM the pane is given\n \n A navigation container mode puts a second vertical rail inside the pane, and the Settings Hub\n * reads this to widen its frame accordingly — see `settingsSectionNeedsWideFrame`. That is the\n * reason this is a layout DECLARATION rather than seven JSX props: a prop inside a template is\n * invisible to anything that has to size the surface around it.\n /\n defaultDisplaySectionAppearance?: ContainerSectionMode;\n\n /\n Default chrome mode for fields in each context.\n * Used when a field's `{primitive}UI.{context}.chromeMode` is not set.\n * Renderers read: `{primitive}UI.{context}.chromeMode ?? layout.defaultChromeMode.{context} ?? system-default`\n /\n defaultChromeMode?: {\n /* Default chrome for display context. /\n display?: ResponsiveAware<DisplayChromeMode>;\n /* Default chrome for summary context. /\n summary?: ResponsiveAware<DisplayChromeMode>;\n /* Default chrome for edit context. /\n edit?: ResponsiveAware<EditChromeMode>;\n };\n\n /\n Per-view override for how this resource's action buttons render their\n * label, keyed by {@link ResourceOperationDisplayMode} (`SUMMARY` = list/table\n * rows & cards, `DETAIL` = full read view). Overrides the app-wide theme\n * default (`ComponentStyleTheme.actionLabelDisplayMode`). Omit a key to\n * inherit the app default for that view.\n \n Precedence: `layout.actionLabelDisplayMode[view]` → app theme default → `TOOLTIP`.\n \n @example\n * // Dense list rows stay icon-only; the full detail view spells actions out.\n * actionLabelDisplayMode: {\n * [ResourceOperationDisplayMode.SUMMARY]: ActionLabelDisplayMode.TOOLTIP,\n * [ResourceOperationDisplayMode.DETAIL]: ActionLabelDisplayMode.INLINE,\n * }\n /\n actionLabelDisplayMode?: Partial<Record<ResourceOperationDisplayMode, ActionLabelDisplayMode>>;\n\n /\n Per-view action-surfacing (disclosure) policy — see {@link ResourceActionDisclosureConfig}.\n * Controls how many actions stay visible before overflow (`maxPrimaryActions`)\n * and whether actions disabled by an unmet `enabledCondition` are hidden or\n * greyed (`disabledActionHandling`), keyed by {@link ResourceOperationDisplayMode}.\n * Omit a view (or a field) to inherit the framework default\n * ({@link DEFAULT_ACTION_DISCLOSURE}): SUMMARY = { max 3, hide-disabled },\n * DETAIL = { unlimited, show-disabled — each explains why it cannot run }.\n \n @example\n * // A busy list keeps just one action inline; the detail view spells them all out.\n * actionDisclosure: {\n * [ResourceOperationDisplayMode.SUMMARY]: { maxPrimaryActions: 1 },\n * }\n /\n actionDisclosure?: Partial<Record<ResourceOperationDisplayMode, ResourceActionDisclosureConfig>>;\n\n /\n Edit layout template — a `React.ComponentType` rendered inside `<Form>` providers.\n * The component is instantiated as `<EditTemplate />` and has access to\n * `useFormTemplateContext()` for labels/schema/operation and `useWatch()` for reactivity.\n * For operation-specific branching, read `operationType` from `FormTemplateContext`.\n * Standard `<FormField name=\"...\">` slots automatically honor upstream\n * generated replacements (for example relationship-backed fields reshaped by\n * `ResourceAutomatedForm`). When a generated override exists, that replacement\n * node owns its own chrome and ignores extra `FormField`-style props passed at\n * the template slot.\n /\n edit?: LayoutTemplate;\n\n /\n Display layout template — rendered for read-only detail views.\n * The component is instantiated inside `<DisplayTemplateProvider>` and has access to\n * `useDisplayTemplateContext()` for `data`, `isLoading`, `variant`, labels, and breakpoint.\n /\n display?: LayoutTemplate;\n\n /\n Header layout template — the record's IDENTITY LINE in the READ page header.\n \n The header band is framework-owned chrome (back button, breadcrumb, resource\n * icon, action cluster) wrapped around one middle region: the record's name.\n * Authoring this template cedes that middle region to the resource, so state\n * that belongs ON the identity line — a status badge, a visibility marker, an\n * accent swatch — sits beside the name instead of in a labelled strip below it.\n \n Rendered inside a display-template provider over the loaded record, so\n * `<DisplayField name=\"…\">` and `useDisplayTemplateContext()` work exactly as\n * they do in `display` / `summary`. Inline editing is off (the header shows\n * state, it does not edit it) and chrome defaults to `INLINE` so fields render\n * bare, without their labels.\n \n Place `<ResourceHeaderTitle />` yourself. The header stops rendering its\n * own title once this template exists, so a template that omits the element\n * produces a page with no record name (a dev warning names the resource).\n \n Distinct from `summary` on purpose: a card/FK-popover summary answers \"how\n * does this record identify itself in a LIST\", and commonly carries fields a\n * page header should not repeat. Both surfaces compose the same way; neither\n * inherits the other's body.\n \n @example\n * // Accent dot before the name, status badge after it, \"Public\" only when true:\n * header: () => {\n * const { data, fieldLabels } = useDisplayTemplateContext();\n * return (\n * <>\n * {Boolean(data?.color) && <ColorDot value={String(data.color)} />}\n * <ResourceHeaderTitle />\n * <DisplayField name=\"status\" hideLabel className=\"w-auto\" />\n * {Boolean(data?.isPublic) && <Badge>{fieldLabels.isPublic}</Badge>}\n * </>\n * );\n * }\n /\n header?: LayoutTemplate;\n\n /\n Summary layout template — rendered for cards, list items, FK references.\n * Typically a compact single-line or small card layout.\n * The component is instantiated inside `<DisplayTemplateProvider>` by `ResourceSummaryDisplayer`,\n * with `disableInlineEdit={true}` and chrome defaulting to `DisplayChromeMode.INLINE`.\n * Use `useDisplayTemplateContext()` for reactive data access.\n \n The title is part of the template flow. Wrap the body in `<SummaryLayout>`;\n * by default (`titlePlacement={AUTO}`) it renders the resource's primary label\n * (`<SummaryTitle />`) at the top, then your fields below — the classic\n * title-above-body card. To put something on the title's line (a status badge),\n * switch to `titlePlacement={TEMPLATE_OWNED}` and place `<SummaryTitle />`\n * yourself, typically inside a `<SummaryHeader>`:\n \n @example\n * // Title above a couple of fields (title rendered automatically):\n * summary: () => (\n * <SummaryLayout>\n * <DisplayField name=\"createdAt\" />\n * </SummaryLayout>\n * )\n \n @example\n * // Status badge inline with the title:\n * summary: () => (\n * <SummaryLayout titlePlacement={SummaryTitlePlacement.TEMPLATE_OWNED}>\n * <SummaryHeader>\n * <SummaryTitle />\n * <DisplayField name=\"status\" hideLabel />\n * </SummaryHeader>\n * <DisplayField name=\"createdAt\" />\n * </SummaryLayout>\n * )\n /\n summary?: LayoutTemplate;\n\n}\n/* @wildo_source:part:end saas.frontend.resource-layout-templates /\n\n\n// ── Relationship display overrides ──────────────────────────────────\n\n/\n Per-relationship display override declared on the owning resource's preset.\n \n Each entry targets a specific relationship by `target` resource type (and\n * optionally `foreignKeyField` for disambiguation when multiple relationships\n * exist to the same type). The `inParentNavigation` /\n * `inChildView` sub-objects are shallow-merged onto the relationship's shared\n * `display` config during registry build — frontend values win over shared defaults.\n \n Ownership principle: each resource configures its own view:\n * - `inParentNavigation` → \"how does navigation from my view to this child behave?\"\n * - `inChildView` → \"how does the parent reference appear in my view when I'm the child?\"\n \n @example\n * ```ts\n * relationshipOverrides: [\n * // I'm parent of TASKS — make Tasks appear as accordion in MY view\n * { target: ResourceType.TASKS,\n * // I'm child of USERS (FK: assignedToUserId) — show user as badge in MY view\n * { target: ResourceType.USERS, foreignKeyField: 'assignedToUserId',\n * inChildView: { parentDisplay: ParentDisplay.BADGE } },\n * ]\n * ```\n /\nexport interface RelationshipDisplayOverride {\n /* Related resource type to match against. /\n target: string;\n /\n FK field name for disambiguation when multiple relationships exist to the\n * same `target` type. Matches against both explicit `rel.foreignKeyField` and\n * implied FK from `allResourceFieldIdentifiers`.\n /\n foreignKeyField?: string;\n /* Override for how children appear in THIS resource's view (when I'm parent). /\n /* Override for how navigation from THIS resource's view to the child behaves. /\n inParentNavigation?: Partial<RelationshipDisplayInParentNavigation>;\n /* Override for how parent reference appears in THIS resource's view (when I'm child). /\n inChildView?: Partial<RelationshipDisplayInChildView>;\n}\n\n\n// ── Resource-level frontend config ──────────────────────────────────\n\n/\n @wildo_source:part:start saas.frontend.resource-ui-behavior-config facet:layer:frontend facet:family:resource-ui\n \n Complete frontend configuration for a single resource within an application.\n \n Canonical frontend resource configuration type. Contains resource-level settings\n * (labels, sections, views, empty state, guidance) plus per-operation frontend config.\n \n Generic `TMainSchema` defaults to `z.ZodAny`. Presets and `ResourceUIBehavior`\n * records use the default; app-level configs can narrow it to a concrete schema\n * for type-safe `getFrontendResourceLabel` callbacks.\n \n This is the canonical frontend type — it is self-contained and does not\n * reference or depend on backend resource configuration factories.\n \n UI views use a `Map` keyed by `OperationKey`:\n * - `string` key for default operations\n * - `[operationId, variantKey]` tuple for non-default variants\n \n @example\n * ```\n * const orgConfig: ResourceUIBehaviorConfig<any, any, typeof OrgSchema> = {\n * getFrontendResourceLabel: ({ currentObject }) => currentObject.name, // type-safe\n * views: new Map([\n * [CoreResourceOperation.CREATE, notAddressable()],\n * [CoreResourceOperation.LIST, addressable()],\n * ]),\n * };\n \n // Input form (via resourceUIBehavior callback) uses array-of-tuples:\n * // views: [\n * // [CoreResourceOperation.CREATE, notAddressable()],\n * // [CoreResourceOperation.LIST, addressable()],\n * // ],\n * ```\n /\nexport type ResourceUIBehaviorConfig<\n TCustomOp extends EnumLikeType \| undefined = any,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined = any,\n TMainSchema extends z.ZodTypeAny = z.ZodAny,\n> = {\n\n // ── Resource Icon ──────────────────────────────────────────────\n\n /\n Resource-level icon — React component (e.g., Lucide) or string\n * (StandardIconReference). Registered into `IconRegistry.resources`\n * during `buildFrontendResourceConfigurations()`.\n /\n icon?: IconLike;\n\n\n // ── Field Addons ───────────────────────────────────────────────\n\n /\n Per-field decorator overrides for the resource's `mainSchema`.\n \n Keys are field names of `TMainSchema`; values are decorated Zod schemas\n * from the same shape (e.g., `shape.status.enumUI({ ... })`).\n \n The merge happens at module evaluation time — calling `.enumUI()`\n * on a shape field mutates its metadata in place via `applySingleDecorator`\n * merge semantics. Schema-level decorators are preserved, addon decorators\n * overlay. No explicit runtime consumption is needed; the `fields`\n * field exists primarily for type safety (`keyof z.infer<TMainSchema>`)\n * and as a declaration container.\n \n @example\n * ```ts\n * fields: {\n * status: shape.status.enumUI({\n * values: { pending: { color: 'secondary' }, completed: { color: 'success' } },\n * }),\n * }\n * ```\n /\n fields?: {\n [K in keyof ObjectShape<TMainSchema>]?: ObjectShape<TMainSchema>[K];\n };\n\n\n // ── Form Defaults ──────────────────────────────────────────────\n\n /\n Resource-level default validation mode for form fields.\n * Individual fields can override via `{primitive}UI({ edit: { validationMode } })`.\n * Falls back to framework default (`ON_BLUR`) when not set.\n /\n defaultValidationMode?: ValidationMode;\n\n /\n Resource-level default autosave config for form fields.\n * Individual fields can override via `{primitive}UI({ edit: { autosave } })`.\n * When not set, autosave is disabled unless explicitly configured per-field.\n /\n defaultAutosave?: AutosaveFieldParams \| true;\n\n\n // ── Draft Mode ─────────────────────────────────────────────────\n\n /\n Resource-level draft mode configuration.\n * Defines how draft/publish discrimination works — which field acts as\n * discriminator, what values mean \"draft\" vs \"published\", and whether\n * publishing requires confirmation.\n \n Consumed by `ResourceAutomatedForm` to enable Save-as-Draft / Publish\n * buttons and relaxed validation for draft saves.\n /\n draftableConfig?: DraftableConfigParams;\n\n\n // ── Layout ──────────────────────────────────────────────────────\n\n /\n Template-based layout configuration. Resources needing sections, wizard steps,\n * or custom layouts provide explicit JSX templates using skeleton components\n * (`<Section>`, `<FormField>`, `<WizardLayout>`, etc.).\n \n @see ResourceLayoutConfig\n /\n layout?: ResourceLayoutConfig;\n\n\n // ── Label ──────────────────────────────────────────────────────\n\n /\n Label generation for resource instances in the frontend.\n \n Can be either:\n * - `string[]` — array of field paths to concatenate (each entry is a field\n * name on the summary record, including any server-resolved virtual field\n * such as a `forwardedLabel`, e.g. `['instanceLabel']`).\n * - `(params: ResourceUIBehaviorLabelParams) => string` — a function\n \n Used by `ResourceListItemRenderer` (rows) and `ResourceLayout_Header` (titles).\n /\n getFrontendResourceLabel?: string[] \| ((params: ResourceUIBehaviorLabelParams<TMainSchema>) => string);\n\n\n // ── Views ──────────────────────────────────────────────────────\n\n /* Resource-owned composite templates declared inline on the resource UI behavior. /\n compositeViews?: ResourceCompositeViewsConfig;\n\n /* Resource-owned execution surfaces declared inline on the resource UI behavior. /\n executionViews?: ResourceExecutionViewsConfig;\n\n /* Resource-owned inserted chart declarations for this resource. /\n chartViews?: InsertedChartDeclaration[];\n\n\n // ── Empty State ────────────────────────────────────────────────\n\n /\n Empty state configuration for list/table views when no items exist.\n * Labels (title, description, primaryActionLabel) come from i18n.\n /\n emptyState?: ResourceUIBehavior_EmptyState;\n\n\n // ── Guidance ───────────────────────────────────────────────────\n\n /\n Resource-level guidance flow declarations.\n * Compiled into standard `GuidanceFlowDefinition` objects by the guidance compiler.\n /\n guidance?: ResourceUIBehavior_GuidanceFlow[];\n\n\n // ── Relationship Display Overrides ───────────────────────────────\n\n /\n Per-relationship display overrides for this resource.\n \n Allows the frontend preset to override how relationships are displayed\n * without modifying the shared `display` config on the relationship itself.\n * Consumed at build time by `resolveRelationshipDisplayOverrides()` and\n * stripped from `frontendConfiguration` before storage.\n \n @see RelationshipDisplayOverride\n /\n relationshipOverrides?: RelationshipDisplayOverride[];\n\n\n // ── UI Views ───────────────────────────────────────────────────\n\n /\n Per-operation frontend configuration — which operations have a UI view\n * and how they appear (addressability, launchers, overrides).\n \n Keyed by `TypedOperationKey`:\n * - `string` — default operation (e.g., `CoreResourceOperation.READ`)\n * - `[operationId, variantKey]` — non-default variant\n \n When typed via `resourceUIBehavior()`, operation keys are validated\n * at compile time against the resource's valid operations.\n /\n views: Map<TypedOperationKey<TCustomOp, TCoreOp>, ResourceOperationFrontendConfig>;\n};\n/* @wildo_source:part:end saas.frontend.resource-ui-behavior-config /\n\n/\n Resource-level UI behavior configuration — the subset of `ResourceUIBehaviorConfig`\n * that describes the resource itself (labels, sections, views, empty state, guidance),\n * excluding `views` (lives on individual operation entries),\n * `relationshipOverrides` (consumed at build time, not stored at runtime).\n \n Resource-owned composite/execution authoring maps are compiled into inserted\n * runtime declarations before storage.\n \n This is what gets written to `FrontendResourceConfiguration.frontendConfiguration`\n * during preset-driven registry build.\n /\nexport type ResourceUIBehaviorResourceLevelConfig<\n TCustomOp extends EnumLikeType \| undefined = any,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined = any,\n TMainSchema extends z.ZodTypeAny = z.ZodAny,\n> = Omit<ResourceUIBehaviorConfig<TCustomOp, TCoreOp, TMainSchema>, 'views' \| 'relationshipOverrides' \| 'compositeViews' \| 'executionViews'> & {\n compositeViews?: InsertedCompositeDeclaration[];\n executionViews?: InsertedExecutionDeclaration[];\n};\n\n// ── Preset type ─────────────────────────────────────────────────────\n\n/\n @wildo_source:part:start saas.frontend.resource-ui-behavior-preset-map facet:layer:frontend facet:family:resource-ui\n \n Complete frontend resource configuration preset for an application.\n \n Maps resource types to their full frontend configuration — including\n * resource-level settings (labels, sections, views, empty state, guidance)\n * and operation-level settings (addressability, launchers, overrides).\n \n Each application provides its own preset defining exactly which resources\n * and operations it exposes and how they appear in the UI.\n \n When authoring presets, use `resourceUIBehavior()` which accepts views\n * as an array of tuples (for contextual typing) and converts to Map internally.\n \n @example\n * ```\n * const preset: ResourceUIBehavior = {\n * [CoreResourceType.ORGANIZATIONS]: resourceUIBehavior(factory, Schema, ({ schema, schemaShape, opsVariantResolver }) => ({\n * getFrontendResourceLabel: ({ currentObject }) => currentObject.name,\n * views: [\n * [CoreResourceOperation.CREATE, notAddressable()],\n * [CoreResourceOperation.READ, notAddressable()],\n * ],\n * })),\n * };\n * ```\n /\nexport type ResourceUIBehavior = Record<string, ResourceUIBehaviorConfig>;\n/* @wildo_source:part:end saas.frontend.resource-ui-behavior-preset-map /\n\n// ── Polymorphic frontend declaration ────────────────────────────────\n\n/\n A single variant within a polymorphic frontend declaration.\n * Maps a parent resource type (the discriminator) to the concrete resource type it produces.\n \n Mirrors the backend's `PolymorphicResolvedVariant` — stripped of schema-level\n * concerns, keeping only the routing information the frontend needs.\n /\nexport interface PolymorphicFrontendVariant {\n /* Parent resource type — the polymorphic discriminator (e.g., `CoreResourceType.ORGANIZATIONS`) /\n parentResourceType: string;\n /* Concrete resource type for this variant (e.g., `CoreResourceType.ORGANIZATION_BILLING_ACCOUNTS`) /\n resourceType: string;\n}\n\n/\n Frontend polymorphic declaration — lightweight equivalent of the backend's\n * `PolymorphicSchemaDeclaration`.\n \n Contains the variant mapping (discriminator → concrete resource type) without\n * any Zod schema coupling. Used by `createPolymorphicFrontendPreset()` to generate\n * per-variant preset entries.\n \n Declarations are typically defined per resource family (billing accounts,\n * subscriptions, SSO config, etc.) and mirror the backend's\n * `BILLING_SCOPE_VARIANTS` / `AUTH_SCOPE_VARIANTS` grouping.\n \n @example\n * ```ts\n * const BILLING_ACCOUNTS: PolymorphicFrontendDeclaration = {\n * variants: [\n * { parentResourceType: CoreResourceType.ORGANIZATIONS, resourceType: CoreResourceType.ORGANIZATION_BILLING_ACCOUNTS },\n * { parentResourceType: CoreResourceType.USERS, resourceType: CoreResourceType.USER_BILLING_ACCOUNTS },\n * ],\n * };\n * ```\n /\nexport interface PolymorphicFrontendDeclaration {\n variants: PolymorphicFrontendVariant[];\n}\n\n\n// ── Polymorphic preset config ───────────────────────────────────────\n\n/\n Resource frontend config with optional per-variant overrides.\n \n Mirrors the backend's `PolymorphicResourceConfig` + `polymorphicRole` pattern:\n * - Shared fields apply to all scope variants as the default\n * - `variantOverrides` keyed by `parentResourceType` (the discriminator)\n * allow per-variant differentiation — just like `polymorphicRole` resolves\n * different roles per parent resource type\n \n Override resolution (same as backend `polymorphicRole`):\n * - If a variant's `parentResourceType` is in `variantOverrides`, the override\n * replaces the corresponding shared fields (not merged)\n * - If not present, the shared config is used as-is (fallback)\n * - `views` in an override fully replaces the shared views Map\n * (use an empty `new Map()` to make a variant invisible in the preset)\n /\nexport type PolymorphicResourceUIBehaviorConfig<\n TCustomOp extends EnumLikeType \| undefined = any,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined = any,\n TMainSchema extends z.ZodTypeAny = z.ZodAny,\n> = Omit<ResourceUIBehaviorConfig<TCustomOp, TCoreOp, TMainSchema>, 'views'> & {\n /\n Per-operation frontend config — array-of-tuples form (converted to Map internally).\n * Same semantics as `ResourceUIBehaviorConfig.views` but using arrays for\n * TypeScript contextual typing compatibility.\n /\n views: OperationEntries<TCustomOp, TCoreOp>;\n /\n Per-variant overrides, keyed by `parentResourceType` (the polymorphic discriminator).\n \n Like backend `polymorphicRole`, provides variant-specific configuration.\n * Each override replaces the corresponding shared field — `views`\n * is a full replacement, not a merge. If `views` is omitted in the\n * override, the shared views apply.\n \n Pass an empty array `[]` for `views` to exclude a variant from\n * surfacing in the preset (variant still exists in the declaration, but\n * has no frontend operations).\n /\n variantOverrides?: Record<string, Partial<Omit<ResourceUIBehaviorConfig<TCustomOp, TCoreOp, TMainSchema>, 'views'>> & { views?: OperationEntries<TCustomOp, TCoreOp> }>;\n };\n\n/\n Return type of the `polymorphicResourceUIBehavior()` callback overload.\n * Same structure as `PolymorphicResourceUIBehaviorConfig` — the callback form\n * provides `{ schema, schemaShape, opsVariantResolver }` for the same typed control as `resourceUIBehavior()`:\n * operation keys in `views` and `variantOverrides` are validated at compile time.\n /\nexport type PolymorphicResourceUIBehaviorConfigResult<\n TCustomOp extends EnumLikeType \| undefined = any,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined = any,\n TMainSchema extends z.ZodTypeAny = z.ZodAny,\n> = PolymorphicResourceUIBehaviorConfig<TCustomOp, TCoreOp, TMainSchema>;\n\n// ── Polymorphic preset factory ──────────────────────────────────────\n\n/\n Creates frontend preset entries for all scope variants of a polymorphic resource.\n \n Mirrors the backend `createPolymorphicResourceConfigurations` pattern:\n * takes a polymorphic declaration (discriminator → concrete resource types) and\n * a shared config with optional per-variant overrides, producing a\n * `ResourceUIBehavior` partial that can be spread into the main preset.\n \n Resolution per variant (same semantics as backend `polymorphicRole` → `roles`):\n * 1. If `variantOverrides[parentResourceType]` exists → override fields replace\n * corresponding shared fields (views is a full replacement, not merge)\n * 2. If no override → shared config used as-is (fallback)\n \n The declaration must always contain ALL variants of the polymorphic resource.\n * Use `variantOverrides` with an empty `views: []` to exclude a variant\n * from a specific preset (the variant is declared but has no frontend presence).\n \n @param declaration - Polymorphic frontend declaration with ALL variant mappings\n * @param config - Shared config (default) with optional `variantOverrides` per discriminator\n * @returns Partial `ResourceUIBehavior` with one entry per variant\n \n @example\n * ```ts\n * // Main app: org scope gets full ops, app scope excluded\n * ...createPolymorphicFrontendPreset({\n * variants: [\n * { parentResourceType: R.ORGANIZATIONS, resourceType: R.ORGANIZATION_SSO_CONFIG },\n * { parentResourceType: R.APPLICATION, resourceType: R.APPLICATION_SSO_CONFIG },\n * ],\n * }, {\n * views: [\n * [Op.READ, addressable()],\n * [CustomOperations.RUN_DIAGNOSTIC, notAddressable()],\n * ],\n * variantOverrides: {\n * [R.APPLICATION]: { views: [] },\n * },\n * }),\n \n // Admin app: app scope gets full ops, org scope read-only\n * ...createPolymorphicFrontendPreset({\n * variants: [\n * { parentResourceType: R.ORGANIZATIONS, resourceType: R.ORGANIZATION_SSO_CONFIG },\n * { parentResourceType: R.APPLICATION, resourceType: R.APPLICATION_SSO_CONFIG },\n * ],\n * }, {\n * views: [\n * [Op.READ, addressable()],\n * [CustomOperations.RUN_DIAGNOSTIC, notAddressable()],\n * ],\n * variantOverrides: {\n * [R.ORGANIZATIONS]: {\n * views: [\n * [Op.READ, notAddressable()],\n * [Op.LIST, notAddressable()],\n * ],\n * },\n * },\n * }),\n * ```\n /\nexport function createPolymorphicFrontendPreset(\n declaration: PolymorphicFrontendDeclaration,\n config: PolymorphicResourceUIBehaviorConfig,\n): ResourceUIBehavior {\n const schema = (config as any)[FRONTEND_SCHEMA_KEY];\n const { variantOverrides, views: sharedViewsEntries, ...sharedRest } = config;\n const sharedViews = new Map(sharedViewsEntries);\n const sharedConfig = { ...sharedRest, views: sharedViews } as ResourceUIBehaviorConfig;\n\n // Compute per-variant FK-renamed schemas. The author passes ONE base\n // schema to `polymorphicResourceUIBehavior(decl, factory, baseSchema, ...)`,\n // but the runtime polymorphic factory renames `polymorphicVariants`-marked\n // FK fields per variant (e.g. `billingAccountId` →\n // `organizationBillingAccountId` for the ORGANIZATIONS variant). If we\n // attach the un-renamed base schema as `FRONTEND_SCHEMA_KEY` on every\n // variant, `buildFrontendResourceConfigurations` later replaces the\n // renamed `mainSchema` with the un-renamed base — and the FK→parent\n // resolution check throws because the base's `billingAccountId` doesn't\n // resolve to a unique parent. Mirror the factory's rename at this seam\n // so per-variant `FRONTEND_SCHEMA_KEY` matches the per-variant\n // `mainSchema` keys.\n const variantSchemas =\n schema !== undefined && (schema as z.ZodTypeAny)?._zod?.def?.type === 'object'\n ? computePolymorphicVariantSchemas(\n schema as z.ZodObject<z.ZodRawShape>,\n declaration.variants,\n )\n : null;\n\n if (schema !== undefined) {\n (sharedConfig as any)[FRONTEND_SCHEMA_KEY] = schema;\n }\n const result: ResourceUIBehavior = {};\n\n for (const variant of declaration.variants) {\n const override = variantOverrides?.[variant.parentResourceType];\n // Use the per-variant renamed schema when available; fall back to the\n // shared base schema for declarations whose fields have no\n // `polymorphicVariants` metadata (rename map is empty → identity).\n const variantSchema =\n variantSchemas?.get(variant.parentResourceType) ?? schema;\n\n if (override) {\n const { views: overrideViewsEntries, ...overrideRest } = override;\n const concreteConfig = {\n ...sharedConfig,\n ...overrideRest,\n views: overrideViewsEntries ? new Map(overrideViewsEntries) : sharedViews,\n };\n if (variantSchema !== undefined) {\n (concreteConfig as any)[FRONTEND_SCHEMA_KEY] = variantSchema;\n }\n result[variant.resourceType] = concreteConfig;\n } else if (variantSchemas && variantSchema !== schema) {\n // Distinct per-variant schema: clone sharedConfig so each variant\n // keeps its own FRONTEND_SCHEMA_KEY rather than sharing the base.\n const concreteConfig = { ...sharedConfig, views: sharedViews } as ResourceUIBehaviorConfig;\n (concreteConfig as any)[FRONTEND_SCHEMA_KEY] = variantSchema;\n result[variant.resourceType] = concreteConfig;\n } else {\n result[variant.resourceType] = sharedConfig;\n }\n }\n\n return result;\n}\n\n\n// ── Utility types for extracting generics from ResourceConfiguration ────────\n\n/\n Infers the custom operation enum from a resource factory or config type.\n \n How to use: in generic helpers that wrap `resourceUIBehavior(yourFactory, …)`\n * so `TypedOperationKey` and `views` tuples stay aligned without repeating type params.\n /\nexport type ExtractCustomOp<T> =\n T extends ResourceConfiguration<infer C, any, any> ? C :\n T extends ResourceConfiguration_InitializationFactory<infer C, any, any> ? C :\n never;\n\n/* Same as {@link ExtractCustomOp} for the core operations subset on the resource. /\nexport type ExtractCoreOp<T> =\n T extends ResourceConfiguration<any, infer O, any> ? O :\n T extends ResourceConfiguration_InitializationFactory<any, infer O, any> ? O :\n never;\n\n/* Same as {@link ExtractCustomOp} for the resource main Zod schema type. /\nexport type ExtractSchema<T> =\n T extends ResourceConfiguration<any, any, infer S> ? S :\n T extends ResourceConfiguration_InitializationFactory<any, any, infer S> ? S :\n never;\n\n\n// ── Standalone variant helper ───────────────────────────────────────────────\n\n/\n Creates a typed operation variant tuple `[operationKey, variantKey]`.\n * Preserves the literal operation key for `TypedOperationKey` assignability.\n \n How to use: in `views: [ … ]` when the operation key must stay a narrow literal\n * (custom enum member or core op). Equivalent to `opsVariantResolver(op, key)` but\n * useful in static arrays outside the callback.\n /\nexport function variant<TOp extends string>(\n op: TOp, variantKey: string,\n): readonly [TOp, string] {\n return [op, variantKey] as const;\n}\n\n\n// ── Operation entries (input form) ───────────────────────────────────────────\n\n/\n Array-of-tuples form for specifying operations in input contexts\n * (`resourceUIBehavior` callback, `polymorphicResourceUIBehavior` config).\n \n TypeScript's `new Map([...])` doesn't pick up contextual typing for\n * heterogeneous key types, so input types use arrays — the factory functions\n * convert to `Map` at the boundary. Each entry's key is individually checked\n * against `TypedOperationKey<TCustomOp, TCoreOp>` via contextual typing.\n /\nexport type OperationEntries<\n TCustomOp extends EnumLikeType \| undefined = any,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined = any,\n> = [TypedOperationKey<TCustomOp, TCoreOp>, ResourceOperationFrontendConfig][];\n\n\n// ── Callback parameter type for resourceUIBehavior / polymorphicResourceUIBehavior ─\n\n/\n Callback argument bag for `resourceUIBehavior()` / `polymorphicResourceUIBehavior()`.\n \n How to use: prefer `schemaShape.fieldName` for per-field `.enumUI()` / `.stringUI()`\n * overrides; use `schema` when applying decorators on the root object; use\n * `opsVariantResolver(CoreResourceOperation.READ, 'summary')` (or `variant()`) so\n * non-default variant keys type-check against valid operations.\n /\nexport type ResourceUIBehaviorCallbackParams<\n TCustomOp extends EnumLikeType \| undefined,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined,\n TSchema extends z.ZodTypeAny,\n> = {\n schema: TSchema;\n schemaShape: ObjectShape<TSchema>;\n opsVariantResolver: <TOp extends ValidOperationKeys<TCustomOp, TCoreOp>>(\n op: TOp, variantKey: string,\n ) => readonly [TOp, string];\n};\n\n\n// ── Callback return type for resourceUIBehavior ─────────────────────────────\n\n/\n Return type of the `resourceUIBehavior()` callback — overrides `views`\n * to accept an array of tuples (instead of Map) for ergonomic authoring.\n * The `resourceUIBehavior()` function converts the array to a Map.\n \n `schemaOverride` is applied during callback execution as a side effect and\n * stripped from the returned config. Must appear BEFORE `fields` in the\n * object literal to ensure schema-level defaults are set before field-level overrides.\n /\nexport type ResourceUIBehaviorConfigResult<\n TCustomOp extends EnumLikeType \| undefined,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined,\n TSchema extends z.ZodTypeAny,\n> = Omit<ResourceUIBehaviorConfig<TCustomOp, TCoreOp, TSchema>, 'views'> & {\n views: OperationEntries<TCustomOp, TCoreOp>;\n schemaOverride?: TSchema;\n};\n\n\n// ── Typed resource UI behavior factory ──────────────────────────────────────\n\n/\n Creates a typed `ResourceUIBehaviorConfig` entry for a given resource.\n \n All generics are inferred from the `_factory` argument — no explicit type\n * parameters needed. The callback receives `{ schema, schemaShape, opsVariantResolver }`:\n * - `schema` — the Zod schema (for schema-level mutations like `.stringUI()`, `.enumUI()`, etc.)\n * - `schemaShape` — the typed shape object (for per-field decorator overrides with autocomplete)\n * - `opsVariantResolver` — typed variant tuple helper constrained to valid operation keys\n \n The `_factory` parameter is for type inference only and is never called at runtime.\n \n @example\n * ```ts\n * [R.TODOS]: resourceUIBehavior(\n * todos_ResourceConfiguration_InitializationFactory,\n * Todos_Schema,\n * ({ schema, schemaShape, opsVariantResolver }) => ({\n * icon: CheckSquare,\n * fields: {\n * status: schemaShape.status.enumUI({\n * values: { completed: { color: 'success', icon: CheckCircle } },\n * }),\n * },\n * views: [\n * [CoreResourceOperation.LIST, addressable()],\n * [opsVariantResolver(CoreResourceOperation.CREATE, 'quick-add'), notAddressable()],\n * ],\n * }),\n * ),\n * ```\n /\nexport function resourceUIBehavior<\n TCustomOp extends EnumLikeType \| undefined,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined,\n TSchema extends z.ZodTypeAny,\n>(\n _factory: ResourceConfigLike<TCustomOp, TCoreOp, TSchema>,\n schema: TSchema,\n configFactory: (\n params: ResourceUIBehaviorCallbackParams<TCustomOp, TCoreOp, TSchema>,\n ) => ResourceUIBehaviorConfigResult<TCustomOp, TCoreOp, TSchema>,\n): ResourceUIBehaviorConfig {\n const schemaShape = (\n schema && 'shape' in schema\n ? (schema as unknown as z.ZodObject<any>).shape\n : getZodObjectShape(schema)\n ) as ObjectShape<TSchema>;\n\n const opsVariantResolver = <TOp extends string>(op: TOp, variantKey: string) =>\n [op, variantKey] as readonly [TOp, string];\n\n const { schemaOverride: _, views: viewsEntries, ...config } =\n configFactory({ schema, schemaShape, opsVariantResolver: opsVariantResolver as any });\n\n (config as any)[FRONTEND_SCHEMA_KEY] = schema;\n\n return {\n ...config,\n views: new Map(viewsEntries),\n } as unknown as ResourceUIBehaviorConfig;\n}\n\n\n// ── Derived resource UI behavior factory ────────────────────────────────────\n\n/\n Callback parameter type for `resourceUIBehaviorFrom()`.\n * Extends the standard callback params with a `base` reference to the resolved base config.\n /\nexport type ResourceUIBehaviorFromCallbackParams<\n TCustomOp extends EnumLikeType \| undefined,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined,\n TSchema extends z.ZodTypeAny,\n> = ResourceUIBehaviorCallbackParams<TCustomOp, TCoreOp, TSchema> & {\n /* The resolved base config — use to reference existing values when composing overrides. /\n base: ResourceUIBehaviorConfig<TCustomOp, TCoreOp, TSchema>;\n};\n\n/\n Return type of the `resourceUIBehaviorFrom()` callback — everything is optional.\n \n Merge semantics applied by `resourceUIBehaviorFrom`:\n * - `views` — replaced (the primary differentiator between main/admin)\n * - `layout` — shallow-merged (`{ ...base.layout, ...override.layout }`)\n * - `fields` — shallow-merged (base fields preserved, overrides overlay per-key)\n * - `compositeViews` — shallow-merged by ref (`{ ...base.compositeViews, ...override.compositeViews }`)\n * - `executionViews` — shallow-merged by ref (`{ ...base.executionViews, ...override.executionViews }`)\n * - Scalars (`icon`, `emptyState`, `getFrontendResourceLabel`, etc.) — replaced if provided\n /\nexport type ResourceUIBehaviorFromResult<\n TCustomOp extends EnumLikeType \| undefined,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined,\n TSchema extends z.ZodTypeAny,\n> = Partial<Omit<ResourceUIBehaviorConfig<TCustomOp, TCoreOp, TSchema>, 'views'>> & {\n views?: OperationEntries<TCustomOp, TCoreOp>;\n};\n\n/\n Derives a new `ResourceUIBehaviorConfig` from an existing base, overriding only\n * the specified properties. Eliminates duplication between main and admin presets\n * where the majority of the config (icon, fields, layout, labels) is identical\n * and only `views` (and occasionally `variantOverrides`) differ.\n \n The `_factory` parameter is for type inference only — same as `resourceUIBehavior()`.\n * The schema is extracted from the base config via `FRONTEND_SCHEMA_KEY`, so it does not\n * need to be passed again.\n \n For resources that are completely identical between main and admin, skip this function\n * entirely and forward the config directly: `[R.PRODUCTS]: main[R.PRODUCTS]!`\n \n @param _factory - Any factory from the resource — for type inference only (never called)\n * @param base - The resolved base `ResourceUIBehaviorConfig` (from main presets)\n * @param overrideFn - Callback returning only the properties to override\n \n @example\n * ```ts\n * // Admin promotions — same icon/fields/layout, different views\n * [R.PROMOTIONS]: resourceUIBehaviorFrom(\n * promotionsFactory,\n * main[R.PROMOTIONS]!,\n * ({ opsVariantResolver }) => ({\n * views: [\n * [Promotion_Operations.DEACTIVATE, notAddressable()],\n * ],\n * })\n * ),\n * ```\n /\nexport function resourceUIBehaviorFrom<\n TCustomOp extends EnumLikeType \| undefined,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined,\n TSchema extends z.ZodTypeAny,\n>(\n _factory: ResourceConfigLike<TCustomOp, TCoreOp, TSchema>,\n base: ResourceUIBehaviorConfig,\n overrideFn: (\n params: ResourceUIBehaviorFromCallbackParams<TCustomOp, TCoreOp, TSchema>,\n ) => ResourceUIBehaviorFromResult<TCustomOp, TCoreOp, TSchema>,\n): ResourceUIBehaviorConfig {\n const schema = (base as any)[FRONTEND_SCHEMA_KEY] as TSchema;\n const schemaShape = (\n schema && 'shape' in schema\n ? (schema as unknown as z.ZodObject<any>).shape\n : getZodObjectShape(schema)\n ) as ObjectShape<TSchema>;\n const opsVariantResolver = <TOp extends string>(op: TOp, variantKey: string) =>\n [op, variantKey] as readonly [TOp, string];\n\n const {\n views: overrideViews,\n layout: overrideLayout,\n fields: overrideFields,\n compositeViews: overrideCompositeViews,\n executionViews: overrideExecutionViews,\n ...overrideRest\n } =\n overrideFn({\n schema,\n schemaShape,\n opsVariantResolver: opsVariantResolver as any,\n base: base as unknown as ResourceUIBehaviorConfig<TCustomOp, TCoreOp, TSchema>,\n });\n\n return {\n ...base,\n ...overrideRest,\n ...(overrideLayout !== undefined && {\n layout: { ...base.layout, ...overrideLayout },\n }),\n ...(overrideFields !== undefined && {\n fields: { ...base.fields, ...overrideFields },\n }),\n ...(overrideCompositeViews !== undefined && {\n compositeViews: { ...base.compositeViews, ...overrideCompositeViews },\n }),\n ...(overrideExecutionViews !== undefined && {\n executionViews: { ...base.executionViews, ...overrideExecutionViews },\n }),\n views: overrideViews ? new Map(overrideViews) : base.views,\n } as unknown as ResourceUIBehaviorConfig;\n}\n\n\n// ── Derived polymorphic resource UI behavior factory ─────────────────────────\n\n/\n Return type of the `polymorphicResourceUIBehaviorFrom()` callback — everything is optional.\n * Same merge semantics as `resourceUIBehaviorFrom()`, plus `variantOverrides` is shallow-merged\n * per parent key (inner overrides replace, not merge).\n /\nexport type PolymorphicResourceUIBehaviorFromResult<\n TCustomOp extends EnumLikeType \| undefined,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined,\n TSchema extends z.ZodTypeAny,\n> = Partial<Omit<PolymorphicResourceUIBehaviorConfig<TCustomOp, TCoreOp, TSchema>, 'views'>> & {\n views?: OperationEntries<TCustomOp, TCoreOp>;\n};\n\n/\n Derives a polymorphic preset from an existing base, overriding only the specified\n * properties. Works like `resourceUIBehaviorFrom()` but for polymorphic resources\n * produced by `polymorphicResourceUIBehavior()`.\n \n The base entries are the already-spread `Partial<ResourceUIBehavior>` from the main\n * preset. Internally, the first variant's config is used as the shared base — the\n * callback receives it as `base` and returns only what changes.\n \n @param declaration - Same polymorphic declaration used in the main preset\n * @param _factory - Any single factory from the polymorphic map — for type inference only\n * @param baseEntries - The spread result from the main preset (keyed by concrete resource type)\n * @param overrideFn - Callback returning only the properties to override\n \n @example\n * ```ts\n * // Admin SIEM — same icon/layout/fields, different variantOverrides\n * ...polymorphicResourceUIBehaviorFrom(\n * SIEM_EXPORT_DECLARATION,\n * siemFactory,\n * main,\n * ({ opsVariantResolver }) => ({\n * variantOverrides: {\n * [R.ORGANIZATIONS]: {\n * views: [[Op.READ, notAddressable()]],\n * },\n * },\n * })\n * ),\n * ```\n /\nexport function polymorphicResourceUIBehaviorFrom<\n TCustomOp extends EnumLikeType \| undefined,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined,\n TSchema extends z.ZodTypeAny,\n>(\n declaration: PolymorphicFrontendDeclaration,\n _factory: ResourceConfigLike<TCustomOp, TCoreOp, TSchema>,\n baseEntries: Partial<ResourceUIBehavior>,\n overrideFn: (\n params: ResourceUIBehaviorFromCallbackParams<TCustomOp, TCoreOp, TSchema>,\n ) => PolymorphicResourceUIBehaviorFromResult<TCustomOp, TCoreOp, TSchema>,\n): ResourceUIBehavior {\n const firstVariantType = declaration.variants[0]?.resourceType;\n const baseConfig = firstVariantType ? baseEntries[firstVariantType] : undefined;\n if (!baseConfig) {\n throw new Error(\n `polymorphicResourceUIBehaviorFrom: no base config found for first variant \"${firstVariantType}\"`,\n );\n }\n\n const schema = (baseConfig as any)[FRONTEND_SCHEMA_KEY] as TSchema;\n const schemaShape = (\n schema && 'shape' in schema\n ? (schema as unknown as z.ZodObject<any>).shape\n : getZodObjectShape(schema)\n ) as ObjectShape<TSchema>;\n const opsVariantResolver = <TOp extends string>(op: TOp, variantKey: string) =>\n [op, variantKey] as readonly [TOp, string];\n\n const {\n views: overrideViews,\n layout: overrideLayout,\n fields: overrideFields,\n compositeViews: overrideCompositeViews,\n executionViews: overrideExecutionViews,\n variantOverrides: overrideVariantOverrides,\n ...overrideRest\n } = overrideFn({\n schema,\n schemaShape,\n opsVariantResolver: opsVariantResolver as any,\n base: baseConfig as unknown as ResourceUIBehaviorConfig<TCustomOp, TCoreOp, TSchema>,\n });\n\n const mergedPolyConfig: PolymorphicResourceUIBehaviorConfig = {\n ...baseConfig,\n ...overrideRest,\n ...(overrideLayout !== undefined && {\n layout: { ...baseConfig.layout, ...overrideLayout },\n }),\n ...(overrideFields !== undefined && {\n fields: { ...baseConfig.fields, ...overrideFields },\n }),\n ...(overrideCompositeViews !== undefined && {\n compositeViews: { ...baseConfig.compositeViews, ...overrideCompositeViews },\n }),\n ...(overrideExecutionViews !== undefined && {\n executionViews: { ...baseConfig.executionViews, ...overrideExecutionViews },\n }),\n views: overrideViews ?? [...baseConfig.views.entries()],\n ...(overrideVariantOverrides !== undefined && {\n variantOverrides: overrideVariantOverrides,\n }),\n } as unknown as PolymorphicResourceUIBehaviorConfig;\n\n return createPolymorphicFrontendPreset(declaration, mergedPolyConfig);\n}\n\n\n// ── Typed polymorphic UI behavior factory ───────────────────────────────────\n\n/\n Creates a typed polymorphic UI behavior preset — wraps `createPolymorphicFrontendPreset()`\n * with type inference from a factory or configuration.\n \n For resources built with `createFamilySchema` (discriminated unions), the factory\n * provides the generic context for `fields` typing and operation key validation.\n \n Two overloads — use the callback form for the same typed control as `resourceUIBehavior()`:\n * - Callback: `(declaration, factory, schema, ({ schema, schemaShape, opsVariantResolver }) => config)` — operation keys\n * in `views` and `variantOverrides` are validated at compile time via the `opsVariantResolver` helper.\n * - Object: `(declaration, factory, config)` — config object; typing may be weaker for array literals.\n \n @param declaration - Polymorphic frontend declaration with variant mappings\n * @param _factory - Any single factory from the polymorphic map — for type inference only\n * @param schemaOrConfig - Base schema (for callback form) or config object (for object form)\n * @param configFactory - Callback form only: receives { schema, schemaShape, opsVariantResolver } like resourceUIBehavior\n */\nexport function polymorphicResourceUIBehavior<\n TCustomOp extends EnumLikeType \| undefined,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined,\n TSchema extends z.ZodTypeAny,\n>(\n declaration: PolymorphicFrontendDeclaration,\n _factory: ResourceConfigLike<TCustomOp, TCoreOp, TSchema>,\n schema: TSchema,\n configFactory: (\n params: ResourceUIBehaviorCallbackParams<TCustomOp, TCoreOp, TSchema>,\n ) => PolymorphicResourceUIBehaviorConfigResult<TCustomOp, TCoreOp, TSchema>,\n): ResourceUIBehavior;\n\n\nexport function polymorphicResourceUIBehavior<\n TCustomOp extends EnumLikeType \| undefined,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined,\n TSchema extends z.ZodTypeAny,\n>(\n declaration: PolymorphicFrontendDeclaration,\n _factory: ResourceConfigLike<TCustomOp, TCoreOp, TSchema>,\n config: PolymorphicResourceUIBehaviorConfig<TCustomOp, TCoreOp, TSchema>,\n): ResourceUIBehavior;\n\n\nexport function polymorphicResourceUIBehavior<\n TCustomOp extends EnumLikeType \| undefined,\n TCoreOp extends Partial<CoreResourceOperation> \| undefined,\n TSchema extends z.ZodTypeAny,\n>(\n declaration: PolymorphicFrontendDeclaration,\n _factory: ResourceConfigLike<TCustomOp, TCoreOp, TSchema>,\n schemaOrConfig: TSchema \| PolymorphicResourceUIBehaviorConfig<TCustomOp, TCoreOp, TSchema>,\n configFactory?: (\n params: ResourceUIBehaviorCallbackParams<TCustomOp, TCoreOp, TSchema>,\n ) => PolymorphicResourceUIBehaviorConfigResult<TCustomOp, TCoreOp, TSchema>,\n): ResourceUIBehavior {\n const config = configFactory\n ? (() => {\n const schema = schemaOrConfig as TSchema;\n const schemaShape = (\n schema && 'shape' in schema\n ? (schema as unknown as z.ZodObject<any>).shape\n : getZodObjectShape(schema)\n ) as ObjectShape<TSchema>;\n const opsVariantResolver = <TOp extends string>(op: TOp, variantKey: string) =>\n [op, variantKey] as readonly [TOp, string];\n const config = configFactory({ schema, schemaShape, opsVariantResolver: opsVariantResolver as any });\n (config as any)[FRONTEND_SCHEMA_KEY] = schema;\n return config;\n })()\n : (schemaOrConfig as PolymorphicResourceUIBehaviorConfig);\n\n return createPolymorphicFrontendPreset(declaration, config as PolymorphicResourceUIBehaviorConfig);\n}\n"]}