@wildo-ai/saas-models 1.0.1 → 1.1.0

package/dist/esm/resources/resources.shared.schemas.d.ts

@@ -4,16 +4,63 @@
  * Reusable operation schemas for bulk actions and common operations
  */
 import { z } from 'zod';
-import { CoreResourceOperation } from './resources.shared.core.definitions.js';
-import { ChildLifecycleMode, type ChildOperationsConfig_Parsed } from './child-operations.shared.schemas.js';
-import { SchemaInfer } from './utils/schema-type-inference.utils.js';
-export type { ResourceType } from './resources.shared.core.definitions.js';
+import type { DecoratedPrimitiveZodType } from '@wildo-ai/zod-decorators';
+import { CoreResourceOperation, ResourceType } from './resources.shared.core.definitions';
+import { ChildLifecycleMode, ChildLifecycleStrategy, type ChildOperationsConfig_Parsed } from './child-operations.shared.schemas';
+import { SchemaInfer } from './utils/schema-type-inference.utils';
+export type { ResourceType } from './resources.shared.core.definitions';
+/**
+ * @wildo_source:part:start saas.models.resource-operation-display-risk facet:layer:shared facet:family:resource-config
+ *
+ * Operation bar risk level and UI density (summary vs detail).
+ */
 export declare enum ResourceOperationRiskLevel {
     LOW = "low",
     MEDIUM = "medium",
     HIGH = "high",
     CRITICAL = "critical"
 }
+/**
+ * The **frontend surface** of a resource operation — whether (and how) the
+ * operation is presented in the UI. This is a per-app, per-operation DISPLAY
+ * axis, orthogonal to authorization (roles remain the only security authority).
+ *
+ * Three mutually-exclusive surfaces:
+ *
+ * - `ADDRESSABLE` — the operation has a **URL-routable** view (a deep-linkable
+ *   page that lives in the navigation area; row-click resolves a route). Has an
+ *   action button.
+ * - `EMBEDDED` — the operation has a view that is **not URL-addressable**: it has
+ *   no route of its own and is rendered **within a host**, however that host
+ *   surfaces it — as an overlay/drill-in when invoked standalone, or inline when
+ *   embedded in a composite view or a nested relationship view. Has an action
+ *   button. (This is what `notAddressable()` produces.) Named for the host
+ *   relationship, NOT one presentation: do not assume it always renders as an overlay.
+ * - `API_ONLY` — the operation is **headless**: callable from frontend code as a
+ *   typed API, but has NO rendered interface at all (no page, no embedded view, no
+ *   action button). For operations driven by the system / a workflow / signup rather
+ *   than a user form (e.g. auto-created profiles, engine-authored state).
+ *
+ * `ADDRESSABLE` vs `EMBEDDED` is the URL-routability axis (both have a real view);
+ * `API_ONLY` is the has-no-interface axis. The button-visibility axis
+ * (`ActionVisibility`) is a further orthogonal refinement that only applies to the
+ * two view surfaces.
+ *
+ * Authored on the frontend preset per operation via `addressable()` /
+ * `notAddressable()` / `apiOnly()`; an operation may also declare a
+ * `defaultFrontendPosture` so the framework defaults its surface when no app
+ * preset surfaces it.
+ *
+ * Imported from `@wildo-ai/saas-models`.
+ */
+export declare enum ResourceOperationFrontendSurface {
+    /** URL-routable view (deep-linkable page in the navigation area). */
+    ADDRESSABLE = "addressable",
+    /** Non-addressable view rendered within a host — overlay/drill-in when standalone, inline when embedded in a composite or nested relationship view. */
+    EMBEDDED = "embedded",
+    /** Headless — callable from code as an API, with no rendered interface at all. */
+    API_ONLY = "api_only"
+}
 /**
  * Display mode for resource operation action bars — controls operation bar density.
  * SUMMARY = compact row actions (icon-only, in list/table rows).
@@ -27,6 +74,12 @@ export declare enum ResourceOperationDisplayMode {
     /** In a full read/detail view — can show inline labels */
     DETAIL = "detail"
 }
+/** @wildo_source:part:end saas.models.resource-operation-display-risk */
+/**
+ * @wildo_source:part:start saas.models.resource-primary-scope facet:layer:shared facet:family:resource-config
+ *
+ * Primary execution scope (org, user self, app, anonymous) + anonymous transposition policy.
+ */
 export declare enum ResourcePrimaryScope {
     USER_SELF = "user_self",
     ORGANIZATIONS = "organizations",
@@ -47,7 +100,8 @@ export declare enum ResourceTranspositionPolicy {
     /** Skip transposition entirely — anonymous records are not carried over. */
     DISCARD = "DISCARD"
 }
-import { CoreResourceType } from './resources.shared.core.definitions.js';
+/** @wildo_source:part:end saas.models.resource-primary-scope */
+import { CoreResourceType } from './resources.shared.core.definitions';
 /**
  * Map from ResourcePrimaryScope to the CoreResourceType it represents.
  * This is the foundation - other mappings derive from this.
@@ -67,6 +121,26 @@ export declare const PRIMARY_SCOPE_TO_FIELD_IDENTIFIER: Record<ResourcePrimarySc
  */
 export declare const PRIMARY_SCOPE_FIELD_IDENTIFIERS: readonly string[];
 export type PrimaryScopeFieldIdentifier = (typeof PRIMARY_SCOPE_FIELD_IDENTIFIERS)[number];
+/**
+ * Field identifiers the framework AUTO-POPULATES on a write and therefore omits
+ * from every client-shaped CREATE/UPDATE request DTO — the primary-scope FKs
+ * (`organizationId` / `applicationId` / `userId` / `anonymousUserId`, injected
+ * from the execution context) PLUS the audit FK `createdByUserId` (stamped by
+ * the repository from the initiator). A client is never allowed to author these;
+ * the auto-derivation strips them by NAME (see
+ * `resources-config-operations.dtos-builder.utils.ts` — `applyCreate/UpdateOmissionsToSchema`).
+ *
+ * Single source of truth: the DTO builder consumes this for its omit list, and
+ * `deriveTrustedSystemWritePreservedFields` consumes it to know which
+ * name-stripped fields a TRUSTED in-process system write (via
+ * `SystemAccessBackendService.createAsSystem` / `updateAsSystem`) must re-attach.
+ * Keeping both consumers on one const prevents the two lists from drifting.
+ *
+ * NOTE: intentionally EXCLUDES `_id` / `createdAt` / `updatedAt` / `deletedAt` —
+ * those are timestamp/PK fields handled by `createOrUpdateMandatoryDiscardFields`
+ * (force-removed before validation), never re-attached by a trusted write.
+ */
+export declare const CONTEXT_AUTO_POPULATED_FIELD_IDENTIFIERS: readonly string[];
 /**
  * Map from field identifier to ResourcePrimaryScope.
  * Built by inverting PRIMARY_SCOPE_TO_FIELD_IDENTIFIER.
@@ -103,6 +177,11 @@ export declare function getPrimaryScopeFromFieldIdentifier(fieldIdentifier: stri
  * Check if a field identifier is a primary scope field.
  */
 export declare function isPrimaryScopeFieldIdentifier(fieldIdentifier: string): fieldIdentifier is PrimaryScopeFieldIdentifier;
+/**
+ * @wildo_source:part:start saas.models.resource-relationship-cardinality facet:layer:shared facet:family:resource-config
+ *
+ * Cardinality literals plus helpers (`isOneToOneCardinality`, `isArrayCardinality`).
+ */
 export declare enum ResourceRelationshipCardinality {
     ONE = "one",
     ZERO_OR_ONE = "zero_or_one",
@@ -137,6 +216,12 @@ export declare function isOneToOneCardinality(cardinality: ResourceRelationshipC
  * - URL path: collection path
  */
 export declare function isArrayCardinality(cardinality: ResourceRelationshipCardinality): boolean;
+/** @wildo_source:part:end saas.models.resource-relationship-cardinality */
+/**
+ * @wildo_source:part:start saas.models.resource-operation-variant-runtime facet:layer:shared facet:family:resource-config
+ *
+ * How an operation variant is invoked and executed (API, cron, repository-only, …).
+ */
 export declare enum ResourceOperationVariantType {
     API_CALL = "api_call",
     API_CALL_WITH_CALLBACK = "api_call_with_callback",
@@ -175,12 +260,21 @@ export declare enum ResourceOperation_OutputPolicy {
     SUMMARY = "summary",
     CONTEXT = "context"
 }
+/** @wildo_source:part:end saas.models.resource-operation-variant-runtime */
+/**
+ * @wildo_source:part:start saas.models.resource-relationship-access-scope facet:layer:shared facet:family:resource-config
+ *
+ * Route/service access strategy for a relationship (nested vs standalone URLs).
+ */
 export declare enum ResourceRelationshipAccessScopeStrategy {
     REQUIRES_CONTEXT = "requires_context",
     OPTIONAL_CONTEXT = "optional_context",
     STANDALONE = "standalone"
 }
+/** @wildo_source:part:end saas.models.resource-relationship-access-scope */
 /**
+ * @wildo_source:part:start saas.models.relationship-nature-and-models facet:layer:shared facet:family:resource-config
+ *
  * High-level semantic kind of relationship.
  *
  * This is the primary shared meaning. Resolver/runtime layers may later derive
@@ -276,7 +370,10 @@ export declare enum RelationshipReadModel {
     REFERENCE_ONLY = "reference_only",
     ASSOCIATION_EMBEDDED = "association_embedded"
 }
+/** @wildo_source:part:end saas.models.relationship-nature-and-models */
 /**
+ * @wildo_source:part:start saas.models.relationship-handling-settings facet:layer:shared facet:family:resource-config
+ *
  * Explicit semantic read contract for a relationship.
  *
  * This answers the semantic question "how should this relationship read?" and
@@ -286,7 +383,7 @@ export declare enum RelationshipReadModel {
  */
 export declare const RelationshipHandlingReadSettingsSchema: z.ZodObject<{
     model: z.ZodEnum<typeof RelationshipReadModel>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type RelationshipHandlingReadSettings = z.infer<typeof RelationshipHandlingReadSettingsSchema>;
 /**
  * Narrow mutation refinements under the semantic handling contract.
@@ -299,7 +396,7 @@ export declare const RelationshipHandlingMutationSettingsSchema: z.ZodObject<{
     allowParentUpdate: z.ZodOptional<z.ZodBoolean>;
     allowParentDelete: z.ZodOptional<z.ZodBoolean>;
     maxDepth: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type RelationshipHandlingMutationSettings = z.infer<typeof RelationshipHandlingMutationSettingsSchema>;
 /**
  * Narrow lifecycle refinements under the semantic handling contract.
@@ -307,17 +404,20 @@ export type RelationshipHandlingMutationSettings = z.infer<typeof RelationshipHa
 export declare const RelationshipHandlingLifecycleOnParentDeleteSettingsSchema: z.ZodObject<{
     enabled: z.ZodOptional<z.ZodBoolean>;
     mode: z.ZodOptional<z.ZodEnum<typeof ChildLifecycleMode>>;
+    strategy: z.ZodOptional<z.ZodEnum<typeof ChildLifecycleStrategy>>;
     maxDepth: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type RelationshipHandlingLifecycleOnParentDeleteSettings = z.infer<typeof RelationshipHandlingLifecycleOnParentDeleteSettingsSchema>;
 export declare const RelationshipHandlingLifecycleSettingsSchema: z.ZodObject<{
     onParentDelete: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodOptional<z.ZodBoolean>;
         mode: z.ZodOptional<z.ZodEnum<typeof ChildLifecycleMode>>;
+        strategy: z.ZodOptional<z.ZodEnum<typeof ChildLifecycleStrategy>>;
         maxDepth: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 export type RelationshipHandlingLifecycleSettings = z.infer<typeof RelationshipHandlingLifecycleSettingsSchema>;
+/** @wildo_source:part:end saas.models.relationship-handling-settings */
 /**
  * Explicit multi-target relationship actions.
  *
@@ -349,61 +449,61 @@ export declare const ResourceRelationshipBulkSetActionRequestSchema: z.ZodObject
     relationshipField: z.ZodString;
     action: z.ZodLiteral<ResourceRelationshipBulkAction.SET>;
     targetId: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type ResourceRelationshipBulkSetActionRequest = z.infer<typeof ResourceRelationshipBulkSetActionRequestSchema>;
 export declare const ResourceRelationshipBulkClearActionRequestSchema: z.ZodObject<{
     relationshipField: z.ZodString;
     action: z.ZodLiteral<ResourceRelationshipBulkAction.CLEAR>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type ResourceRelationshipBulkClearActionRequest = z.infer<typeof ResourceRelationshipBulkClearActionRequestSchema>;
 export declare const ResourceRelationshipBulkCreateActionRequestSchema: z.ZodObject<{
     relationshipField: z.ZodString;
     action: z.ZodLiteral<ResourceRelationshipBulkAction.CREATE>;
     data: z.ZodRecord<z.ZodString, z.ZodAny>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type ResourceRelationshipBulkCreateActionRequest = z.infer<typeof ResourceRelationshipBulkCreateActionRequestSchema>;
 export declare const ResourceRelationshipBulkLinkActionRequestSchema: z.ZodObject<{
     relationshipField: z.ZodString;
     action: z.ZodLiteral<ResourceRelationshipBulkAction.LINK>;
     peerIds: z.ZodArray<z.ZodString>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type ResourceRelationshipBulkLinkActionRequest = z.infer<typeof ResourceRelationshipBulkLinkActionRequestSchema>;
 export declare const ResourceRelationshipBulkUnlinkActionRequestSchema: z.ZodObject<{
     relationshipField: z.ZodString;
     action: z.ZodLiteral<ResourceRelationshipBulkAction.UNLINK>;
     peerIds: z.ZodArray<z.ZodString>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type ResourceRelationshipBulkUnlinkActionRequest = z.infer<typeof ResourceRelationshipBulkUnlinkActionRequestSchema>;
 export declare const ResourceRelationshipBulkReplaceActionRequestSchema: z.ZodObject<{
     relationshipField: z.ZodString;
     action: z.ZodLiteral<ResourceRelationshipBulkAction.REPLACE>;
     peerIds: z.ZodArray<z.ZodString>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type ResourceRelationshipBulkReplaceActionRequest = z.infer<typeof ResourceRelationshipBulkReplaceActionRequestSchema>;
 export declare const ResourceRelationshipBulkActionRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     relationshipField: z.ZodString;
     action: z.ZodLiteral<ResourceRelationshipBulkAction.SET>;
     targetId: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     relationshipField: z.ZodString;
     action: z.ZodLiteral<ResourceRelationshipBulkAction.CLEAR>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     relationshipField: z.ZodString;
     action: z.ZodLiteral<ResourceRelationshipBulkAction.CREATE>;
     data: z.ZodRecord<z.ZodString, z.ZodAny>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     relationshipField: z.ZodString;
     action: z.ZodLiteral<ResourceRelationshipBulkAction.LINK>;
     peerIds: z.ZodArray<z.ZodString>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     relationshipField: z.ZodString;
     action: z.ZodLiteral<ResourceRelationshipBulkAction.UNLINK>;
     peerIds: z.ZodArray<z.ZodString>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     relationshipField: z.ZodString;
     action: z.ZodLiteral<ResourceRelationshipBulkAction.REPLACE>;
     peerIds: z.ZodArray<z.ZodString>;
-}, z.core.$strip, core.$ZodObjectExtra>], "action">;
+}, z.core.$strip>], "action">;
 export type ResourceRelationshipBulkActionRequest = z.infer<typeof ResourceRelationshipBulkActionRequestSchema>;
 /**
  * Public request selector for explicit bulk relationship operations.
@@ -417,68 +517,68 @@ export type ResourceRelationshipBulkActionRequest = z.infer<typeof ResourceRelat
 export declare const ResourceRelationshipBulkOperationSelectorSchema: z.ZodUnion<readonly [z.ZodObject<{
     _ids: z.ZodArray<z.ZodString>;
     filter: z.ZodOptional<z.ZodUndefined>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     filter: z.ZodRecord<z.ZodString, z.ZodAny>;
     _ids: z.ZodOptional<z.ZodUndefined>;
-}, z.core.$strip, core.$ZodObjectExtra>]>;
+}, z.core.$strip>]>;
 export type ResourceRelationshipBulkOperationSelector = z.infer<typeof ResourceRelationshipBulkOperationSelectorSchema>;
 export declare const ResourceRelationshipBulkSetOperationRequestSchema: z.ZodIntersection<z.ZodUnion<readonly [z.ZodObject<{
     _ids: z.ZodArray<z.ZodString>;
     filter: z.ZodOptional<z.ZodUndefined>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     filter: z.ZodRecord<z.ZodString, z.ZodAny>;
     _ids: z.ZodOptional<z.ZodUndefined>;
-}, z.core.$strip, core.$ZodObjectExtra>]>, z.ZodObject<{
+}, z.core.$strip>]>, z.ZodObject<{
     targetId: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>>;
+}, z.core.$strip>>;
 export type ResourceRelationshipBulkSetOperationRequest = z.infer<typeof ResourceRelationshipBulkSetOperationRequestSchema>;
 export declare const ResourceRelationshipBulkClearOperationRequestSchema: z.ZodUnion<readonly [z.ZodObject<{
     _ids: z.ZodArray<z.ZodString>;
     filter: z.ZodOptional<z.ZodUndefined>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     filter: z.ZodRecord<z.ZodString, z.ZodAny>;
     _ids: z.ZodOptional<z.ZodUndefined>;
-}, z.core.$strip, core.$ZodObjectExtra>]>;
+}, z.core.$strip>]>;
 export type ResourceRelationshipBulkClearOperationRequest = z.infer<typeof ResourceRelationshipBulkClearOperationRequestSchema>;
 export declare const ResourceRelationshipBulkCreateOperationRequestSchema: z.ZodIntersection<z.ZodUnion<readonly [z.ZodObject<{
     _ids: z.ZodArray<z.ZodString>;
     filter: z.ZodOptional<z.ZodUndefined>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     filter: z.ZodRecord<z.ZodString, z.ZodAny>;
     _ids: z.ZodOptional<z.ZodUndefined>;
-}, z.core.$strip, core.$ZodObjectExtra>]>, z.ZodObject<{
+}, z.core.$strip>]>, z.ZodObject<{
     data: z.ZodRecord<z.ZodString, z.ZodAny>;
-}, z.core.$strip, core.$ZodObjectExtra>>;
+}, z.core.$strip>>;
 export type ResourceRelationshipBulkCreateOperationRequest = z.infer<typeof ResourceRelationshipBulkCreateOperationRequestSchema>;
 export declare const ResourceRelationshipBulkLinkOperationRequestSchema: z.ZodIntersection<z.ZodUnion<readonly [z.ZodObject<{
     _ids: z.ZodArray<z.ZodString>;
     filter: z.ZodOptional<z.ZodUndefined>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     filter: z.ZodRecord<z.ZodString, z.ZodAny>;
     _ids: z.ZodOptional<z.ZodUndefined>;
-}, z.core.$strip, core.$ZodObjectExtra>]>, z.ZodObject<{
+}, z.core.$strip>]>, z.ZodObject<{
     peerIds: z.ZodArray<z.ZodString>;
-}, z.core.$strip, core.$ZodObjectExtra>>;
+}, z.core.$strip>>;
 export type ResourceRelationshipBulkLinkOperationRequest = z.infer<typeof ResourceRelationshipBulkLinkOperationRequestSchema>;
 export declare const ResourceRelationshipBulkUnlinkOperationRequestSchema: z.ZodIntersection<z.ZodUnion<readonly [z.ZodObject<{
     _ids: z.ZodArray<z.ZodString>;
     filter: z.ZodOptional<z.ZodUndefined>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     filter: z.ZodRecord<z.ZodString, z.ZodAny>;
     _ids: z.ZodOptional<z.ZodUndefined>;
-}, z.core.$strip, core.$ZodObjectExtra>]>, z.ZodObject<{
+}, z.core.$strip>]>, z.ZodObject<{
     peerIds: z.ZodArray<z.ZodString>;
-}, z.core.$strip, core.$ZodObjectExtra>>;
+}, z.core.$strip>>;
 export type ResourceRelationshipBulkUnlinkOperationRequest = z.infer<typeof ResourceRelationshipBulkUnlinkOperationRequestSchema>;
 export declare const ResourceRelationshipBulkReplaceOperationRequestSchema: z.ZodIntersection<z.ZodUnion<readonly [z.ZodObject<{
     _ids: z.ZodArray<z.ZodString>;
     filter: z.ZodOptional<z.ZodUndefined>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     filter: z.ZodRecord<z.ZodString, z.ZodAny>;
     _ids: z.ZodOptional<z.ZodUndefined>;
-}, z.core.$strip, core.$ZodObjectExtra>]>, z.ZodObject<{
+}, z.core.$strip>]>, z.ZodObject<{
     peerIds: z.ZodArray<z.ZodString>;
-}, z.core.$strip, core.$ZodObjectExtra>>;
+}, z.core.$strip>>;
 export type ResourceRelationshipBulkReplaceOperationRequest = z.infer<typeof ResourceRelationshipBulkReplaceOperationRequestSchema>;
 export declare const ResourceRelationshipBulkActionResultSchema: z.ZodObject<{
     relationshipField: z.ZodString;
@@ -486,9 +586,11 @@ export declare const ResourceRelationshipBulkActionResultSchema: z.ZodObject<{
     matchedTargetIds: z.ZodArray<z.ZodString>;
     affectedCount: z.ZodNumber;
     results: z.ZodArray<z.ZodAny>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type ResourceRelationshipBulkActionResult = z.infer<typeof ResourceRelationshipBulkActionResultSchema>;
 /**
+ * @wildo_source:part:start saas.models.relationship-handling-contract facet:layer:shared facet:family:resource-config
+ *
  * Fully resolved relationship handling contract.
  *
  * This describes the engine-facing semantic handling after `nature` has been
@@ -503,27 +605,152 @@ export declare const RelationshipHandlingContractSchema: z.ZodObject<{
     readModelMode: z.ZodEnum<typeof RelationshipReadModel>;
     read: z.ZodObject<{
         model: z.ZodEnum<typeof RelationshipReadModel>;
-    }, z.core.$strip, core.$ZodObjectExtra>;
+    }, z.core.$strip>;
     mutation: z.ZodOptional<z.ZodObject<{
         allowParentCreate: z.ZodOptional<z.ZodBoolean>;
         allowParentUpdate: z.ZodOptional<z.ZodBoolean>;
         allowParentDelete: z.ZodOptional<z.ZodBoolean>;
         maxDepth: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip>>;
     lifecycle: z.ZodOptional<z.ZodObject<{
         onParentDelete: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
             mode: z.ZodOptional<z.ZodEnum<typeof ChildLifecycleMode>>;
+            strategy: z.ZodOptional<z.ZodEnum<typeof ChildLifecycleStrategy>>;
             maxDepth: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip, core.$ZodObjectExtra>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 export type RelationshipHandlingContract = z.infer<typeof RelationshipHandlingContractSchema>;
+/** @wildo_source:part:end saas.models.relationship-handling-contract */
+export declare const RelationshipPersistenceForeignKeyContractSchema: z.ZodObject<{
+    fieldIdentifier: z.ZodString;
+    holderResourceType: z.ZodUnion<readonly [z.ZodEnum<typeof CoreResourceType>, z.ZodString]>;
+    isArray: z.ZodBoolean;
+    materializeField: z.ZodBoolean;
+    required: z.ZodBoolean;
+    unique: z.ZodBoolean;
+}, z.core.$strip>;
+export type RelationshipPersistenceForeignKeyContract = z.infer<typeof RelationshipPersistenceForeignKeyContractSchema>;
+export declare const RelationshipPersistenceContractSchema: z.ZodObject<{
+    foreignKey: z.ZodOptional<z.ZodObject<{
+        fieldIdentifier: z.ZodString;
+        holderResourceType: z.ZodUnion<readonly [z.ZodEnum<typeof CoreResourceType>, z.ZodString]>;
+        isArray: z.ZodBoolean;
+        materializeField: z.ZodBoolean;
+        required: z.ZodBoolean;
+        unique: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type RelationshipPersistenceContract = z.infer<typeof RelationshipPersistenceContractSchema>;
 export declare const ResourceRelationshipBaseSchema: z.ZodObject<{
     resourceType1: z.ZodUnion<readonly [z.ZodEnum<typeof CoreResourceType>, z.ZodString]>;
     resourceType2: z.ZodUnion<readonly [z.ZodEnum<typeof CoreResourceType>, z.ZodString]>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type ResourceRelationshipBase = z.infer<typeof ResourceRelationshipBaseSchema>;
+/**
+ * @wildo_source:part:start saas.models.scope-membership facet:layer:shared facet:family:resource-config
+ *
+ * Write-time scope confinement of a REFERENCE foreign key — the STRUCTURE half.
+ *
+ * A lateral `REFERENCE` FK to a target that is NOT itself tenant-scoped — a `users` id on an
+ * org-scoped row, another `organizations` id — carries no `organizationId` column to compare, so the
+ * ordinary write-integrity tenant check can only confirm the target EXISTS, never that it belongs to
+ * the writer's tenant. That admits a cross-tenant reference (assign a todo to a user from another org).
+ * Declaring `scopeMembership` closes it: the referenced target must have a row in a junction linking it
+ * to the writing row's scope — enforced on CREATE and UPDATE, refused with `404` (identical to the
+ * existing cross-tenant refusal, so nothing leaks).
+ *
+ * **This type carries STRUCTURE ONLY — which junction, and which columns.** It is a fact about the data
+ * shape, uniform across every write. The POLICY half (status / role / field tightening, or disabling)
+ * varies per operation VARIANT and therefore lives on the operation config as `referenceConstraints`
+ * (see {@link ReferenceScopeConstraintSchema}) — beside the caller-side `roles`, where authorization
+ * already lives. Keeping them apart is what stops a relationship from growing its own per-variant
+ * authorization table duplicating the operation/variant structure.
+ *
+ * Fully OPT-IN: a relationship without `scopeMembership` keeps its existing existence-only behavior.
+ */
+export declare const ScopeMembershipStructureSchema: z.ZodObject<{
+    scopeField: z.ZodOptional<z.ZodString>;
+    junction: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof CoreResourceType>, z.ZodString]>>;
+    junctionScopeField: z.ZodOptional<z.ZodString>;
+    junctionTargetField: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ScopeMembershipStructure = z.infer<typeof ScopeMembershipStructureSchema>;
+/**
+ * Relationship `scopeMembership` value: `true` for the simple case (junction auto-resolved from the
+ * registry's M:N scope-junction map), or a {@link ScopeMembershipStructureSchema} when the junction or
+ * its columns must be named (self-referential junctions, non-primary scope fields).
+ *
+ * Policy — status, roles, junction-field and target-row constraints, or disabling — is NOT here; it is
+ * per-variant and lives on the operation config's `referenceConstraints`.
+ */
+export declare const ScopeMembershipSchema: z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodObject<{
+    scopeField: z.ZodOptional<z.ZodString>;
+    junction: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof CoreResourceType>, z.ZodString]>>;
+    junctionScopeField: z.ZodOptional<z.ZodString>;
+    junctionTargetField: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>;
+export type ScopeMembership = z.infer<typeof ScopeMembershipSchema>;
+/**
+ * Write-time scope confinement of a REFERENCE foreign key — the POLICY half, declared PER OPERATION
+ * VARIANT on the operation config (`referenceConstraints`), keyed by foreign-key field.
+ *
+ * The relationship's {@link ScopeMembershipSchema} already guarantees the baseline: the referenced
+ * target must be linked to the writing row's scope through the junction. This type TIGHTENS that
+ * baseline for one variant — the ordinary "assign" accepts any member while a "make reviewer" variant
+ * requires an `ORG_ADMIN`; a plain "share" accepts any partnership while "share with write access"
+ * requires a typed one. It sits beside the operation's own `roles`, which gate the CALLER; these gate
+ * the TARGET.
+ *
+ * Absent for a foreign key ⇒ the relationship's baseline membership applies unchanged. `false` ⇒
+ * enforcement is DISABLED for that foreign key on that variant.
+ *
+ * Note on rigor: the baseline membership check is TENANT ISOLATION and is enforced strictly. The
+ * refinements below are ACCESS MANAGEMENT — `requiredRoles` reuses the shared hierarchy matcher
+ * (`userRolesSatisfyRequiredRoles`), which is deliberately permissive about app-custom roles it cannot
+ * expand rather than fail-closed on them.
+ */
+export declare const ReferenceScopeConstraintSchema: z.ZodObject<{
+    qualifyingStatuses: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    requiredRoles: z.ZodOptional<z.ZodObject<{
+        scope: z.ZodEnum<typeof ResourcePrimaryScope>;
+        roles: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    qualifyingFields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    targetConstraints: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type ReferenceScopeConstraint = z.infer<typeof ReferenceScopeConstraintSchema>;
+/**
+ * An operation variant's per-foreign-key reference policy: `foreignKeyField → constraint | false`.
+ *
+ * `false` WAIVES the scope-membership requirement for that foreign key on this variant (a break-glass
+ * verb that must write a not-yet-member reference). It waives that and nothing else: the target must
+ * still EXIST, and an ORG-SCOPED target must still share the write's tenant.
+ *
+ * ⚠️ **On an ORG-LESS target the junction IS the tenant signal.** `users` and `organizations` carry no
+ * tenant column to fall back on, so waiving membership there reduces the check to existence and a
+ * cross-tenant id becomes admissible. That is occasionally the intent (an incident override), but it is
+ * never incidental — reach for a narrower policy first (a wider `qualifyingStatuses`, or a second
+ * junction that models the exception) and use `false` only when the variant genuinely means
+ * "any existing row, tenant notwithstanding".
+ */
+export declare const ReferenceConstraintsSchema: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodObject<{
+    qualifyingStatuses: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    requiredRoles: z.ZodOptional<z.ZodObject<{
+        scope: z.ZodEnum<typeof ResourcePrimaryScope>;
+        roles: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    qualifyingFields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    targetConstraints: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>]>>;
+export type ReferenceConstraints = z.infer<typeof ReferenceConstraintsSchema>;
+/** @wildo_source:part:end saas.models.scope-membership */
+/**
+ * @wildo_source:part:start saas.models.resource-relationship-schema facet:layer:shared facet:family:resource-config
+ *
+ * Serializable relationship declaration fields validated at registry build.
+ */
 export declare const ResourceRelationshipSchema: z.ZodObject<{
     cardinality1: z.ZodEnum<typeof ResourceRelationshipCardinality>;
     cardinality2: z.ZodEnum<typeof ResourceRelationshipCardinality>;
@@ -539,598 +766,102 @@ export declare const ResourceRelationshipSchema: z.ZodObject<{
     contextPolicy: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodOptional<z.ZodBoolean>;
         depth: z.ZodOptional<z.ZodNumber>;
-        objectMode: z.ZodOptional<z.ZodEnum<typeof import("./context-policy.shared.schemas.js").ContextPolicy_ObjectMode>>;
-        accessRightsMode: z.ZodOptional<z.ZodEnum<typeof import("./context-policy.shared.schemas.js").ContextPolicy_AccessRightsMode>>;
+        objectMode: z.ZodOptional<z.ZodEnum<typeof import("./context-policy.shared.schemas").ContextPolicy_ObjectMode>>;
+        accessRightsMode: z.ZodOptional<z.ZodEnum<typeof import("./context-policy.shared.schemas").ContextPolicy_AccessRightsMode>>;
         operationOverrides: z.ZodOptional<z.ZodRecord<z.ZodEnum<typeof CoreResourceOperation> & z.core.$partial, z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
             depth: z.ZodOptional<z.ZodNumber>;
-            objectMode: z.ZodOptional<z.ZodEnum<typeof import("./context-policy.shared.schemas.js").ContextPolicy_ObjectMode>>;
-            accessRightsMode: z.ZodOptional<z.ZodEnum<typeof import("./context-policy.shared.schemas.js").ContextPolicy_AccessRightsMode>>;
-        }, z.core.$strip, core.$ZodObjectExtra>>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
+            objectMode: z.ZodOptional<z.ZodEnum<typeof import("./context-policy.shared.schemas").ContextPolicy_ObjectMode>>;
+            accessRightsMode: z.ZodOptional<z.ZodEnum<typeof import("./context-policy.shared.schemas").ContextPolicy_AccessRightsMode>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
     nature: z.ZodEnum<typeof RelationshipNature>;
     read: z.ZodOptional<z.ZodObject<{
         model: z.ZodEnum<typeof RelationshipReadModel>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip>>;
     childOperations: z.ZodOptional<z.ZodObject<{
         lifecycle: z.ZodOptional<z.ZodObject<{
             onParentDelete: z.ZodOptional<z.ZodObject<{
                 enabled: z.ZodDefault<z.ZodBoolean>;
                 mode: z.ZodDefault<z.ZodEnum<typeof ChildLifecycleMode>>;
+                strategy: z.ZodDefault<z.ZodEnum<typeof ChildLifecycleStrategy>>;
                 maxDepth: z.ZodDefault<z.ZodNumber>;
-            }, z.core.$strip, core.$ZodObjectExtra>>;
-        }, z.core.$strip, core.$ZodObjectExtra>>;
+            }, z.core.$strip>>;
+            onParentCreate: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                mode: z.ZodDefault<z.ZodEnum<typeof import("./child-operations.shared.schemas").CompositionSeedMode>>;
+                maxDepth: z.ZodDefault<z.ZodNumber>;
+                initialData: z.ZodOptional<z.ZodObject<{
+                    override: z.ZodOptional<z.ZodCustom<(ctx: import("./child-operations.shared.schemas").CompositionCreateContext) => Record<string, unknown> | undefined, (ctx: import("./child-operations.shared.schemas").CompositionCreateContext) => Record<string, unknown> | undefined>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
         nested: z.ZodOptional<z.ZodObject<{
             onRead: z.ZodOptional<z.ZodObject<{
-                dataMode: z.ZodEnum<typeof import("./resources-config.shared.schemas.js").DataMode>;
+                dataMode: z.ZodEnum<typeof import("./resources-config.shared.schemas").DataMode>;
                 enabledOnList: z.ZodDefault<z.ZodBoolean>;
-                listDataMode: z.ZodDefault<z.ZodEnum<typeof import("./resources-config.shared.schemas.js").DataMode>>;
+                listDataMode: z.ZodDefault<z.ZodEnum<typeof import("./resources-config.shared.schemas").DataMode>>;
                 maxItems: z.ZodOptional<z.ZodNumber>;
                 sortBy: z.ZodOptional<z.ZodString>;
                 maxDepth: z.ZodDefault<z.ZodNumber>;
-            }, z.core.$strip, core.$ZodObjectExtra>>;
+            }, z.core.$strip>>;
             onUpdate: z.ZodOptional<z.ZodObject<{
                 allowCreate: z.ZodDefault<z.ZodBoolean>;
                 allowUpdate: z.ZodDefault<z.ZodBoolean>;
                 allowDelete: z.ZodDefault<z.ZodBoolean>;
                 maxDepth: z.ZodDefault<z.ZodNumber>;
-            }, z.core.$strip, core.$ZodObjectExtra>>;
+            }, z.core.$strip>>;
             onCreate: z.ZodOptional<z.ZodObject<{
                 allowCreate: z.ZodDefault<z.ZodBoolean>;
                 allowUpdate: z.ZodDefault<z.ZodBoolean>;
                 allowDelete: z.ZodDefault<z.ZodBoolean>;
                 maxDepth: z.ZodDefault<z.ZodNumber>;
-            }, z.core.$strip, core.$ZodObjectExtra>>;
-        }, z.core.$strip, core.$ZodObjectExtra>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
     discriminator: z.ZodOptional<z.ZodObject<{
         discriminatorField: z.ZodString;
         values: z.ZodArray<z.ZodString>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip>>;
     display: z.ZodOptional<z.ZodObject<{
-        inParentView: z.ZodOptional<z.ZodObject<{
-            orderIndex: z.ZodOptional<z.ZodNumber>;
-            inlineLimit: z.ZodOptional<z.ZodNumber>;
-            showViewAllLink: z.ZodOptional<z.ZodBoolean>;
-            contentSectionConfig: z.ZodOptional<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
-                showSingleSectionNav: z.ZodOptional<z.ZodBoolean>;
-                hideWhenEmpty: z.ZodOptional<z.ZodBoolean>;
-                fallbackMode: z.ZodOptional<z.ZodEnum<{
-                    collapsible: import("@wildo-ai/zod-decorators").SectionMode.COLLAPSIBLE;
-                    inline: import("@wildo-ai/zod-decorators").SectionMode.INLINE;
-                    grid: import("@wildo-ai/zod-decorators").SectionMode.GRID;
-                    columns: import("@wildo-ai/zod-decorators").SectionMode.COLUMNS;
-                    tabs: import("@wildo-ai/zod-decorators").SectionMode.TABS;
-                    vertical_tabs: import("@wildo-ai/zod-decorators").SectionMode.VERTICAL_TABS;
-                    pills: import("@wildo-ai/zod-decorators").SectionMode.PILLS;
-                    accordion: import("@wildo-ai/zod-decorators").SectionMode.ACCORDION;
-                    expandable: import("@wildo-ai/zod-decorators").SectionMode.EXPANDABLE;
-                    stepper: import("@wildo-ai/zod-decorators").SectionMode.STEPPER;
-                    timeline: import("@wildo-ai/zod-decorators").SectionMode.TIMELINE;
-                }>>;
-                emptyStateMessage: z.ZodOptional<z.ZodString>;
-                ariaLabel: z.ZodOptional<z.ZodString>;
-                ariaLabelledBy: z.ZodOptional<z.ZodString>;
-                mode: z.ZodLiteral<import("@wildo-ai/zod-decorators").SectionMode.COLLAPSIBLE>;
-                triggerLabel: z.ZodOptional<z.ZodObject<{
-                    open: z.ZodString;
-                    closed: z.ZodString;
-                }, z.core.$strip, core.$ZodObjectExtra>>;
-            }, z.core.$strict, core.$ZodObjectExtra>, z.ZodObject<{
-                showSingleSectionNav: z.ZodOptional<z.ZodBoolean>;
-                hideWhenEmpty: z.ZodOptional<z.ZodBoolean>;
-                fallbackMode: z.ZodOptional<z.ZodEnum<{
-                    collapsible: import("@wildo-ai/zod-decorators").SectionMode.COLLAPSIBLE;
-                    inline: import("@wildo-ai/zod-decorators").SectionMode.INLINE;
-                    grid: import("@wildo-ai/zod-decorators").SectionMode.GRID;
-                    columns: import("@wildo-ai/zod-decorators").SectionMode.COLUMNS;
-                    tabs: import("@wildo-ai/zod-decorators").SectionMode.TABS;
-                    vertical_tabs: import("@wildo-ai/zod-decorators").SectionMode.VERTICAL_TABS;
-                    pills: import("@wildo-ai/zod-decorators").SectionMode.PILLS;
-                    accordion: import("@wildo-ai/zod-decorators").SectionMode.ACCORDION;
-                    expandable: import("@wildo-ai/zod-decorators").SectionMode.EXPANDABLE;
-                    stepper: import("@wildo-ai/zod-decorators").SectionMode.STEPPER;
-                    timeline: import("@wildo-ai/zod-decorators").SectionMode.TIMELINE;
-                }>>;
-                emptyStateMessage: z.ZodOptional<z.ZodString>;
-                ariaLabel: z.ZodOptional<z.ZodString>;
-                ariaLabelledBy: z.ZodOptional<z.ZodString>;
-                mode: z.ZodLiteral<import("@wildo-ai/zod-decorators").SectionMode.INLINE>;
-                gap: z.ZodOptional<z.ZodEnum<{
-                    sm: "sm";
-                    md: "md";
-                    lg: "lg";
-                }>>;
-            }, z.core.$strict, core.$ZodObjectExtra>, z.ZodObject<{
-                showSingleSectionNav: z.ZodOptional<z.ZodBoolean>;
-                hideWhenEmpty: z.ZodOptional<z.ZodBoolean>;
-                fallbackMode: z.ZodOptional<z.ZodEnum<{
-                    collapsible: import("@wildo-ai/zod-decorators").SectionMode.COLLAPSIBLE;
-                    inline: import("@wildo-ai/zod-decorators").SectionMode.INLINE;
-                    grid: import("@wildo-ai/zod-decorators").SectionMode.GRID;
-                    columns: import("@wildo-ai/zod-decorators").SectionMode.COLUMNS;
-                    tabs: import("@wildo-ai/zod-decorators").SectionMode.TABS;
-                    vertical_tabs: import("@wildo-ai/zod-decorators").SectionMode.VERTICAL_TABS;
-                    pills: import("@wildo-ai/zod-decorators").SectionMode.PILLS;
-                    accordion: import("@wildo-ai/zod-decorators").SectionMode.ACCORDION;
-                    expandable: import("@wildo-ai/zod-decorators").SectionMode.EXPANDABLE;
-                    stepper: import("@wildo-ai/zod-decorators").SectionMode.STEPPER;
-                    timeline: import("@wildo-ai/zod-decorators").SectionMode.TIMELINE;
-                }>>;
-                emptyStateMessage: z.ZodOptional<z.ZodString>;
-                ariaLabel: z.ZodOptional<z.ZodString>;
-                ariaLabelledBy: z.ZodOptional<z.ZodString>;
-                mode: z.ZodLiteral<import("@wildo-ai/zod-decorators").SectionMode.GRID>;
-                columnCount: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"auto">]>>;
-                gap: z.ZodOptional<z.ZodEnum<{
-                    sm: "sm";
-                    md: "md";
-                    lg: "lg";
-                }>>;
-                minColumnWidth: z.ZodOptional<z.ZodString>;
-            }, z.core.$strict, core.$ZodObjectExtra>, z.ZodObject<{
-                showSingleSectionNav: z.ZodOptional<z.ZodBoolean>;
-                hideWhenEmpty: z.ZodOptional<z.ZodBoolean>;
-                fallbackMode: z.ZodOptional<z.ZodEnum<{
-                    collapsible: import("@wildo-ai/zod-decorators").SectionMode.COLLAPSIBLE;
-                    inline: import("@wildo-ai/zod-decorators").SectionMode.INLINE;
-                    grid: import("@wildo-ai/zod-decorators").SectionMode.GRID;
-                    columns: import("@wildo-ai/zod-decorators").SectionMode.COLUMNS;
-                    tabs: import("@wildo-ai/zod-decorators").SectionMode.TABS;
-                    vertical_tabs: import("@wildo-ai/zod-decorators").SectionMode.VERTICAL_TABS;
-                    pills: import("@wildo-ai/zod-decorators").SectionMode.PILLS;
-                    accordion: import("@wildo-ai/zod-decorators").SectionMode.ACCORDION;
-                    expandable: import("@wildo-ai/zod-decorators").SectionMode.EXPANDABLE;
-                    stepper: import("@wildo-ai/zod-decorators").SectionMode.STEPPER;
-                    timeline: import("@wildo-ai/zod-decorators").SectionMode.TIMELINE;
-                }>>;
-                emptyStateMessage: z.ZodOptional<z.ZodString>;
-                ariaLabel: z.ZodOptional<z.ZodString>;
-                ariaLabelledBy: z.ZodOptional<z.ZodString>;
-                mode: z.ZodLiteral<import("@wildo-ai/zod-decorators").SectionMode.COLUMNS>;
-                columnCount: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"auto">]>>;
-                gap: z.ZodOptional<z.ZodEnum<{
-                    sm: "sm";
-                    md: "md";
-                    lg: "lg";
-                }>>;
-            }, z.core.$strict, core.$ZodObjectExtra>, z.ZodObject<{
-                showSingleSectionNav: z.ZodOptional<z.ZodBoolean>;
-                hideWhenEmpty: z.ZodOptional<z.ZodBoolean>;
-                fallbackMode: z.ZodOptional<z.ZodEnum<{
-                    collapsible: import("@wildo-ai/zod-decorators").SectionMode.COLLAPSIBLE;
-                    inline: import("@wildo-ai/zod-decorators").SectionMode.INLINE;
-                    grid: import("@wildo-ai/zod-decorators").SectionMode.GRID;
-                    columns: import("@wildo-ai/zod-decorators").SectionMode.COLUMNS;
-                    tabs: import("@wildo-ai/zod-decorators").SectionMode.TABS;
-                    vertical_tabs: import("@wildo-ai/zod-decorators").SectionMode.VERTICAL_TABS;
-                    pills: import("@wildo-ai/zod-decorators").SectionMode.PILLS;
-                    accordion: import("@wildo-ai/zod-decorators").SectionMode.ACCORDION;
-                    expandable: import("@wildo-ai/zod-decorators").SectionMode.EXPANDABLE;
-                    stepper: import("@wildo-ai/zod-decorators").SectionMode.STEPPER;
-                    timeline: import("@wildo-ai/zod-decorators").SectionMode.TIMELINE;
-                }>>;
-                emptyStateMessage: z.ZodOptional<z.ZodString>;
-                ariaLabel: z.ZodOptional<z.ZodString>;
-                ariaLabelledBy: z.ZodOptional<z.ZodString>;
-                mode: z.ZodLiteral<import("@wildo-ai/zod-decorators").SectionMode.TABS>;
-                allowNone: z.ZodOptional<z.ZodBoolean>;
-            }, z.core.$strict, core.$ZodObjectExtra>, z.ZodObject<{
-                showSingleSectionNav: z.ZodOptional<z.ZodBoolean>;
-                hideWhenEmpty: z.ZodOptional<z.ZodBoolean>;
-                fallbackMode: z.ZodOptional<z.ZodEnum<{
-                    collapsible: import("@wildo-ai/zod-decorators").SectionMode.COLLAPSIBLE;
-                    inline: import("@wildo-ai/zod-decorators").SectionMode.INLINE;
-                    grid: import("@wildo-ai/zod-decorators").SectionMode.GRID;
-                    columns: import("@wildo-ai/zod-decorators").SectionMode.COLUMNS;
-                    tabs: import("@wildo-ai/zod-decorators").SectionMode.TABS;
-                    vertical_tabs: import("@wildo-ai/zod-decorators").SectionMode.VERTICAL_TABS;
-                    pills: import("@wildo-ai/zod-decorators").SectionMode.PILLS;
-                    accordion: import("@wildo-ai/zod-decorators").SectionMode.ACCORDION;
-                    expandable: import("@wildo-ai/zod-decorators").SectionMode.EXPANDABLE;
-                    stepper: import("@wildo-ai/zod-decorators").SectionMode.STEPPER;
-                    timeline: import("@wildo-ai/zod-decorators").SectionMode.TIMELINE;
-                }>>;
-                emptyStateMessage: z.ZodOptional<z.ZodString>;
-                ariaLabel: z.ZodOptional<z.ZodString>;
-                ariaLabelledBy: z.ZodOptional<z.ZodString>;
-                mode: z.ZodLiteral<import("@wildo-ai/zod-decorators").SectionMode.VERTICAL_TABS>;
-                allowNone: z.ZodOptional<z.ZodBoolean>;
-                navWidth: z.ZodOptional<z.ZodString>;
-            }, z.core.$strict, core.$ZodObjectExtra>, z.ZodObject<{
-                showSingleSectionNav: z.ZodOptional<z.ZodBoolean>;
-                hideWhenEmpty: z.ZodOptional<z.ZodBoolean>;
-                fallbackMode: z.ZodOptional<z.ZodEnum<{
-                    collapsible: import("@wildo-ai/zod-decorators").SectionMode.COLLAPSIBLE;
-                    inline: import("@wildo-ai/zod-decorators").SectionMode.INLINE;
-                    grid: import("@wildo-ai/zod-decorators").SectionMode.GRID;
-                    columns: import("@wildo-ai/zod-decorators").SectionMode.COLUMNS;
-                    tabs: import("@wildo-ai/zod-decorators").SectionMode.TABS;
-                    vertical_tabs: import("@wildo-ai/zod-decorators").SectionMode.VERTICAL_TABS;
-                    pills: import("@wildo-ai/zod-decorators").SectionMode.PILLS;
-                    accordion: import("@wildo-ai/zod-decorators").SectionMode.ACCORDION;
-                    expandable: import("@wildo-ai/zod-decorators").SectionMode.EXPANDABLE;
-                    stepper: import("@wildo-ai/zod-decorators").SectionMode.STEPPER;
-                    timeline: import("@wildo-ai/zod-decorators").SectionMode.TIMELINE;
-                }>>;
-                emptyStateMessage: z.ZodOptional<z.ZodString>;
-                ariaLabel: z.ZodOptional<z.ZodString>;
-                ariaLabelledBy: z.ZodOptional<z.ZodString>;
-                mode: z.ZodLiteral<import("@wildo-ai/zod-decorators").SectionMode.PILLS>;
-                allowNone: z.ZodOptional<z.ZodBoolean>;
-            }, z.core.$strict, core.$ZodObjectExtra>, z.ZodObject<{
-                showSingleSectionNav: z.ZodOptional<z.ZodBoolean>;
-                hideWhenEmpty: z.ZodOptional<z.ZodBoolean>;
-                fallbackMode: z.ZodOptional<z.ZodEnum<{
-                    collapsible: import("@wildo-ai/zod-decorators").SectionMode.COLLAPSIBLE;
-                    inline: import("@wildo-ai/zod-decorators").SectionMode.INLINE;
-                    grid: import("@wildo-ai/zod-decorators").SectionMode.GRID;
-                    columns: import("@wildo-ai/zod-decorators").SectionMode.COLUMNS;
-                    tabs: import("@wildo-ai/zod-decorators").SectionMode.TABS;
-                    vertical_tabs: import("@wildo-ai/zod-decorators").SectionMode.VERTICAL_TABS;
-                    pills: import("@wildo-ai/zod-decorators").SectionMode.PILLS;
-                    accordion: import("@wildo-ai/zod-decorators").SectionMode.ACCORDION;
-                    expandable: import("@wildo-ai/zod-decorators").SectionMode.EXPANDABLE;
-                    stepper: import("@wildo-ai/zod-decorators").SectionMode.STEPPER;
-                    timeline: import("@wildo-ai/zod-decorators").SectionMode.TIMELINE;
-                }>>;
-                emptyStateMessage: z.ZodOptional<z.ZodString>;
-                ariaLabel: z.ZodOptional<z.ZodString>;
-                ariaLabelledBy: z.ZodOptional<z.ZodString>;
-                mode: z.ZodLiteral<import("@wildo-ai/zod-decorators").SectionMode.ACCORDION>;
-                allowMultiple: z.ZodOptional<z.ZodBoolean>;
-            }, z.core.$strict, core.$ZodObjectExtra>, z.ZodObject<{
-                showSingleSectionNav: z.ZodOptional<z.ZodBoolean>;
-                hideWhenEmpty: z.ZodOptional<z.ZodBoolean>;
-                fallbackMode: z.ZodOptional<z.ZodEnum<{
-                    collapsible: import("@wildo-ai/zod-decorators").SectionMode.COLLAPSIBLE;
-                    inline: import("@wildo-ai/zod-decorators").SectionMode.INLINE;
-                    grid: import("@wildo-ai/zod-decorators").SectionMode.GRID;
-                    columns: import("@wildo-ai/zod-decorators").SectionMode.COLUMNS;
-                    tabs: import("@wildo-ai/zod-decorators").SectionMode.TABS;
-                    vertical_tabs: import("@wildo-ai/zod-decorators").SectionMode.VERTICAL_TABS;
-                    pills: import("@wildo-ai/zod-decorators").SectionMode.PILLS;
-                    accordion: import("@wildo-ai/zod-decorators").SectionMode.ACCORDION;
-                    expandable: import("@wildo-ai/zod-decorators").SectionMode.EXPANDABLE;
-                    stepper: import("@wildo-ai/zod-decorators").SectionMode.STEPPER;
-                    timeline: import("@wildo-ai/zod-decorators").SectionMode.TIMELINE;
-                }>>;
-                emptyStateMessage: z.ZodOptional<z.ZodString>;
-                ariaLabel: z.ZodOptional<z.ZodString>;
-                ariaLabelledBy: z.ZodOptional<z.ZodString>;
-                mode: z.ZodLiteral<import("@wildo-ai/zod-decorators").SectionMode.EXPANDABLE>;
-                initialVisibleCount: z.ZodOptional<z.ZodNumber>;
-                showMoreLabel: z.ZodOptional<z.ZodString>;
-                showLessLabel: z.ZodOptional<z.ZodString>;
-            }, z.core.$strict, core.$ZodObjectExtra>, z.ZodObject<{
-                showSingleSectionNav: z.ZodOptional<z.ZodBoolean>;
-                hideWhenEmpty: z.ZodOptional<z.ZodBoolean>;
-                fallbackMode: z.ZodOptional<z.ZodEnum<{
-                    collapsible: import("@wildo-ai/zod-decorators").SectionMode.COLLAPSIBLE;
-                    inline: import("@wildo-ai/zod-decorators").SectionMode.INLINE;
-                    grid: import("@wildo-ai/zod-decorators").SectionMode.GRID;
-                    columns: import("@wildo-ai/zod-decorators").SectionMode.COLUMNS;
-                    tabs: import("@wildo-ai/zod-decorators").SectionMode.TABS;
-                    vertical_tabs: import("@wildo-ai/zod-decorators").SectionMode.VERTICAL_TABS;
-                    pills: import("@wildo-ai/zod-decorators").SectionMode.PILLS;
-                    accordion: import("@wildo-ai/zod-decorators").SectionMode.ACCORDION;
-                    expandable: import("@wildo-ai/zod-decorators").SectionMode.EXPANDABLE;
-                    stepper: import("@wildo-ai/zod-decorators").SectionMode.STEPPER;
-                    timeline: import("@wildo-ai/zod-decorators").SectionMode.TIMELINE;
-                }>>;
-                emptyStateMessage: z.ZodOptional<z.ZodString>;
-                ariaLabel: z.ZodOptional<z.ZodString>;
-                ariaLabelledBy: z.ZodOptional<z.ZodString>;
-                mode: z.ZodLiteral<import("@wildo-ai/zod-decorators").SectionMode.STEPPER>;
-                allowSkip: z.ZodOptional<z.ZodBoolean>;
-                showProgress: z.ZodOptional<z.ZodBoolean>;
-                orientation: z.ZodOptional<z.ZodEnum<typeof import("@wildo-ai/zod-decorators").DisplayDirection>>;
-                nextLabel: z.ZodOptional<z.ZodString>;
-                previousLabel: z.ZodOptional<z.ZodString>;
-                completeLabel: z.ZodOptional<z.ZodString>;
-            }, z.core.$strict, core.$ZodObjectExtra>, z.ZodObject<{
-                showSingleSectionNav: z.ZodOptional<z.ZodBoolean>;
-                hideWhenEmpty: z.ZodOptional<z.ZodBoolean>;
-                fallbackMode: z.ZodOptional<z.ZodEnum<{
-                    collapsible: import("@wildo-ai/zod-decorators").SectionMode.COLLAPSIBLE;
-                    inline: import("@wildo-ai/zod-decorators").SectionMode.INLINE;
-                    grid: import("@wildo-ai/zod-decorators").SectionMode.GRID;
-                    columns: import("@wildo-ai/zod-decorators").SectionMode.COLUMNS;
-                    tabs: import("@wildo-ai/zod-decorators").SectionMode.TABS;
-                    vertical_tabs: import("@wildo-ai/zod-decorators").SectionMode.VERTICAL_TABS;
-                    pills: import("@wildo-ai/zod-decorators").SectionMode.PILLS;
-                    accordion: import("@wildo-ai/zod-decorators").SectionMode.ACCORDION;
-                    expandable: import("@wildo-ai/zod-decorators").SectionMode.EXPANDABLE;
-                    stepper: import("@wildo-ai/zod-decorators").SectionMode.STEPPER;
-                    timeline: import("@wildo-ai/zod-decorators").SectionMode.TIMELINE;
-                }>>;
-                emptyStateMessage: z.ZodOptional<z.ZodString>;
-                ariaLabel: z.ZodOptional<z.ZodString>;
-                ariaLabelledBy: z.ZodOptional<z.ZodString>;
-                mode: z.ZodLiteral<import("@wildo-ai/zod-decorators").SectionMode.TIMELINE>;
-            }, z.core.$strict, core.$ZodObjectExtra>], "mode">, z.ZodRecord<z.ZodEnum<typeof import("@wildo-ai/zod-decorators").ViewportBreakpoint> & z.core.$partial, z.ZodDiscriminatedUnion<[z.ZodObject<{
-                showSingleSectionNav: z.ZodOptional<z.ZodBoolean>;
-                hideWhenEmpty: z.ZodOptional<z.ZodBoolean>;
-                fallbackMode: z.ZodOptional<z.ZodEnum<{
-                    collapsible: import("@wildo-ai/zod-decorators").SectionMode.COLLAPSIBLE;
-                    inline: import("@wildo-ai/zod-decorators").SectionMode.INLINE;
-                    grid: import("@wildo-ai/zod-decorators").SectionMode.GRID;
-                    columns: import("@wildo-ai/zod-decorators").SectionMode.COLUMNS;
-                    tabs: import("@wildo-ai/zod-decorators").SectionMode.TABS;
-                    vertical_tabs: import("@wildo-ai/zod-decorators").SectionMode.VERTICAL_TABS;
-                    pills: import("@wildo-ai/zod-decorators").SectionMode.PILLS;
-                    accordion: import("@wildo-ai/zod-decorators").SectionMode.ACCORDION;
-                    expandable: import("@wildo-ai/zod-decorators").SectionMode.EXPANDABLE;
-                    stepper: import("@wildo-ai/zod-decorators").SectionMode.STEPPER;
-                    timeline: import("@wildo-ai/zod-decorators").SectionMode.TIMELINE;
-                }>>;
-                emptyStateMessage: z.ZodOptional<z.ZodString>;
-                ariaLabel: z.ZodOptional<z.ZodString>;
-                ariaLabelledBy: z.ZodOptional<z.ZodString>;
-                mode: z.ZodLiteral<import("@wildo-ai/zod-decorators").SectionMode.COLLAPSIBLE>;
-                triggerLabel: z.ZodOptional<z.ZodObject<{
-                    open: z.ZodString;
-                    closed: z.ZodString;
-                }, z.core.$strip, core.$ZodObjectExtra>>;
-            }, z.core.$strict, core.$ZodObjectExtra>, z.ZodObject<{
-                showSingleSectionNav: z.ZodOptional<z.ZodBoolean>;
-                hideWhenEmpty: z.ZodOptional<z.ZodBoolean>;
-                fallbackMode: z.ZodOptional<z.ZodEnum<{
-                    collapsible: import("@wildo-ai/zod-decorators").SectionMode.COLLAPSIBLE;
-                    inline: import("@wildo-ai/zod-decorators").SectionMode.INLINE;
-                    grid: import("@wildo-ai/zod-decorators").SectionMode.GRID;
-                    columns: import("@wildo-ai/zod-decorators").SectionMode.COLUMNS;
-                    tabs: import("@wildo-ai/zod-decorators").SectionMode.TABS;
-                    vertical_tabs: import("@wildo-ai/zod-decorators").SectionMode.VERTICAL_TABS;
-                    pills: import("@wildo-ai/zod-decorators").SectionMode.PILLS;
-                    accordion: import("@wildo-ai/zod-decorators").SectionMode.ACCORDION;
-                    expandable: import("@wildo-ai/zod-decorators").SectionMode.EXPANDABLE;
-                    stepper: import("@wildo-ai/zod-decorators").SectionMode.STEPPER;
-                    timeline: import("@wildo-ai/zod-decorators").SectionMode.TIMELINE;
-                }>>;
-                emptyStateMessage: z.ZodOptional<z.ZodString>;
-                ariaLabel: z.ZodOptional<z.ZodString>;
-                ariaLabelledBy: z.ZodOptional<z.ZodString>;
-                mode: z.ZodLiteral<import("@wildo-ai/zod-decorators").SectionMode.INLINE>;
-                gap: z.ZodOptional<z.ZodEnum<{
-                    sm: "sm";
-                    md: "md";
-                    lg: "lg";
-                }>>;
-            }, z.core.$strict, core.$ZodObjectExtra>, z.ZodObject<{
-                showSingleSectionNav: z.ZodOptional<z.ZodBoolean>;
-                hideWhenEmpty: z.ZodOptional<z.ZodBoolean>;
-                fallbackMode: z.ZodOptional<z.ZodEnum<{
-                    collapsible: import("@wildo-ai/zod-decorators").SectionMode.COLLAPSIBLE;
-                    inline: import("@wildo-ai/zod-decorators").SectionMode.INLINE;
-                    grid: import("@wildo-ai/zod-decorators").SectionMode.GRID;
-                    columns: import("@wildo-ai/zod-decorators").SectionMode.COLUMNS;
-                    tabs: import("@wildo-ai/zod-decorators").SectionMode.TABS;
-                    vertical_tabs: import("@wildo-ai/zod-decorators").SectionMode.VERTICAL_TABS;
-                    pills: import("@wildo-ai/zod-decorators").SectionMode.PILLS;
-                    accordion: import("@wildo-ai/zod-decorators").SectionMode.ACCORDION;
-                    expandable: import("@wildo-ai/zod-decorators").SectionMode.EXPANDABLE;
-                    stepper: import("@wildo-ai/zod-decorators").SectionMode.STEPPER;
-                    timeline: import("@wildo-ai/zod-decorators").SectionMode.TIMELINE;
-                }>>;
-                emptyStateMessage: z.ZodOptional<z.ZodString>;
-                ariaLabel: z.ZodOptional<z.ZodString>;
-                ariaLabelledBy: z.ZodOptional<z.ZodString>;
-                mode: z.ZodLiteral<import("@wildo-ai/zod-decorators").SectionMode.GRID>;
-                columnCount: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"auto">]>>;
-                gap: z.ZodOptional<z.ZodEnum<{
-                    sm: "sm";
-                    md: "md";
-                    lg: "lg";
-                }>>;
-                minColumnWidth: z.ZodOptional<z.ZodString>;
-            }, z.core.$strict, core.$ZodObjectExtra>, z.ZodObject<{
-                showSingleSectionNav: z.ZodOptional<z.ZodBoolean>;
-                hideWhenEmpty: z.ZodOptional<z.ZodBoolean>;
-                fallbackMode: z.ZodOptional<z.ZodEnum<{
-                    collapsible: import("@wildo-ai/zod-decorators").SectionMode.COLLAPSIBLE;
-                    inline: import("@wildo-ai/zod-decorators").SectionMode.INLINE;
-                    grid: import("@wildo-ai/zod-decorators").SectionMode.GRID;
-                    columns: import("@wildo-ai/zod-decorators").SectionMode.COLUMNS;
-                    tabs: import("@wildo-ai/zod-decorators").SectionMode.TABS;
-                    vertical_tabs: import("@wildo-ai/zod-decorators").SectionMode.VERTICAL_TABS;
-                    pills: import("@wildo-ai/zod-decorators").SectionMode.PILLS;
-                    accordion: import("@wildo-ai/zod-decorators").SectionMode.ACCORDION;
-                    expandable: import("@wildo-ai/zod-decorators").SectionMode.EXPANDABLE;
-                    stepper: import("@wildo-ai/zod-decorators").SectionMode.STEPPER;
-                    timeline: import("@wildo-ai/zod-decorators").SectionMode.TIMELINE;
-                }>>;
-                emptyStateMessage: z.ZodOptional<z.ZodString>;
-                ariaLabel: z.ZodOptional<z.ZodString>;
-                ariaLabelledBy: z.ZodOptional<z.ZodString>;
-                mode: z.ZodLiteral<import("@wildo-ai/zod-decorators").SectionMode.COLUMNS>;
-                columnCount: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"auto">]>>;
-                gap: z.ZodOptional<z.ZodEnum<{
-                    sm: "sm";
-                    md: "md";
-                    lg: "lg";
-                }>>;
-            }, z.core.$strict, core.$ZodObjectExtra>, z.ZodObject<{
-                showSingleSectionNav: z.ZodOptional<z.ZodBoolean>;
-                hideWhenEmpty: z.ZodOptional<z.ZodBoolean>;
-                fallbackMode: z.ZodOptional<z.ZodEnum<{
-                    collapsible: import("@wildo-ai/zod-decorators").SectionMode.COLLAPSIBLE;
-                    inline: import("@wildo-ai/zod-decorators").SectionMode.INLINE;
-                    grid: import("@wildo-ai/zod-decorators").SectionMode.GRID;
-                    columns: import("@wildo-ai/zod-decorators").SectionMode.COLUMNS;
-                    tabs: import("@wildo-ai/zod-decorators").SectionMode.TABS;
-                    vertical_tabs: import("@wildo-ai/zod-decorators").SectionMode.VERTICAL_TABS;
-                    pills: import("@wildo-ai/zod-decorators").SectionMode.PILLS;
-                    accordion: import("@wildo-ai/zod-decorators").SectionMode.ACCORDION;
-                    expandable: import("@wildo-ai/zod-decorators").SectionMode.EXPANDABLE;
-                    stepper: import("@wildo-ai/zod-decorators").SectionMode.STEPPER;
-                    timeline: import("@wildo-ai/zod-decorators").SectionMode.TIMELINE;
-                }>>;
-                emptyStateMessage: z.ZodOptional<z.ZodString>;
-                ariaLabel: z.ZodOptional<z.ZodString>;
-                ariaLabelledBy: z.ZodOptional<z.ZodString>;
-                mode: z.ZodLiteral<import("@wildo-ai/zod-decorators").SectionMode.TABS>;
-                allowNone: z.ZodOptional<z.ZodBoolean>;
-            }, z.core.$strict, core.$ZodObjectExtra>, z.ZodObject<{
-                showSingleSectionNav: z.ZodOptional<z.ZodBoolean>;
-                hideWhenEmpty: z.ZodOptional<z.ZodBoolean>;
-                fallbackMode: z.ZodOptional<z.ZodEnum<{
-                    collapsible: import("@wildo-ai/zod-decorators").SectionMode.COLLAPSIBLE;
-                    inline: import("@wildo-ai/zod-decorators").SectionMode.INLINE;
-                    grid: import("@wildo-ai/zod-decorators").SectionMode.GRID;
-                    columns: import("@wildo-ai/zod-decorators").SectionMode.COLUMNS;
-                    tabs: import("@wildo-ai/zod-decorators").SectionMode.TABS;
-                    vertical_tabs: import("@wildo-ai/zod-decorators").SectionMode.VERTICAL_TABS;
-                    pills: import("@wildo-ai/zod-decorators").SectionMode.PILLS;
-                    accordion: import("@wildo-ai/zod-decorators").SectionMode.ACCORDION;
-                    expandable: import("@wildo-ai/zod-decorators").SectionMode.EXPANDABLE;
-                    stepper: import("@wildo-ai/zod-decorators").SectionMode.STEPPER;
-                    timeline: import("@wildo-ai/zod-decorators").SectionMode.TIMELINE;
-                }>>;
-                emptyStateMessage: z.ZodOptional<z.ZodString>;
-                ariaLabel: z.ZodOptional<z.ZodString>;
-                ariaLabelledBy: z.ZodOptional<z.ZodString>;
-                mode: z.ZodLiteral<import("@wildo-ai/zod-decorators").SectionMode.VERTICAL_TABS>;
-                allowNone: z.ZodOptional<z.ZodBoolean>;
-                navWidth: z.ZodOptional<z.ZodString>;
-            }, z.core.$strict, core.$ZodObjectExtra>, z.ZodObject<{
-                showSingleSectionNav: z.ZodOptional<z.ZodBoolean>;
-                hideWhenEmpty: z.ZodOptional<z.ZodBoolean>;
-                fallbackMode: z.ZodOptional<z.ZodEnum<{
-                    collapsible: import("@wildo-ai/zod-decorators").SectionMode.COLLAPSIBLE;
-                    inline: import("@wildo-ai/zod-decorators").SectionMode.INLINE;
-                    grid: import("@wildo-ai/zod-decorators").SectionMode.GRID;
-                    columns: import("@wildo-ai/zod-decorators").SectionMode.COLUMNS;
-                    tabs: import("@wildo-ai/zod-decorators").SectionMode.TABS;
-                    vertical_tabs: import("@wildo-ai/zod-decorators").SectionMode.VERTICAL_TABS;
-                    pills: import("@wildo-ai/zod-decorators").SectionMode.PILLS;
-                    accordion: import("@wildo-ai/zod-decorators").SectionMode.ACCORDION;
-                    expandable: import("@wildo-ai/zod-decorators").SectionMode.EXPANDABLE;
-                    stepper: import("@wildo-ai/zod-decorators").SectionMode.STEPPER;
-                    timeline: import("@wildo-ai/zod-decorators").SectionMode.TIMELINE;
-                }>>;
-                emptyStateMessage: z.ZodOptional<z.ZodString>;
-                ariaLabel: z.ZodOptional<z.ZodString>;
-                ariaLabelledBy: z.ZodOptional<z.ZodString>;
-                mode: z.ZodLiteral<import("@wildo-ai/zod-decorators").SectionMode.PILLS>;
-                allowNone: z.ZodOptional<z.ZodBoolean>;
-            }, z.core.$strict, core.$ZodObjectExtra>, z.ZodObject<{
-                showSingleSectionNav: z.ZodOptional<z.ZodBoolean>;
-                hideWhenEmpty: z.ZodOptional<z.ZodBoolean>;
-                fallbackMode: z.ZodOptional<z.ZodEnum<{
-                    collapsible: import("@wildo-ai/zod-decorators").SectionMode.COLLAPSIBLE;
-                    inline: import("@wildo-ai/zod-decorators").SectionMode.INLINE;
-                    grid: import("@wildo-ai/zod-decorators").SectionMode.GRID;
-                    columns: import("@wildo-ai/zod-decorators").SectionMode.COLUMNS;
-                    tabs: import("@wildo-ai/zod-decorators").SectionMode.TABS;
-                    vertical_tabs: import("@wildo-ai/zod-decorators").SectionMode.VERTICAL_TABS;
-                    pills: import("@wildo-ai/zod-decorators").SectionMode.PILLS;
-                    accordion: import("@wildo-ai/zod-decorators").SectionMode.ACCORDION;
-                    expandable: import("@wildo-ai/zod-decorators").SectionMode.EXPANDABLE;
-                    stepper: import("@wildo-ai/zod-decorators").SectionMode.STEPPER;
-                    timeline: import("@wildo-ai/zod-decorators").SectionMode.TIMELINE;
-                }>>;
-                emptyStateMessage: z.ZodOptional<z.ZodString>;
-                ariaLabel: z.ZodOptional<z.ZodString>;
-                ariaLabelledBy: z.ZodOptional<z.ZodString>;
-                mode: z.ZodLiteral<import("@wildo-ai/zod-decorators").SectionMode.ACCORDION>;
-                allowMultiple: z.ZodOptional<z.ZodBoolean>;
-            }, z.core.$strict, core.$ZodObjectExtra>, z.ZodObject<{
-                showSingleSectionNav: z.ZodOptional<z.ZodBoolean>;
-                hideWhenEmpty: z.ZodOptional<z.ZodBoolean>;
-                fallbackMode: z.ZodOptional<z.ZodEnum<{
-                    collapsible: import("@wildo-ai/zod-decorators").SectionMode.COLLAPSIBLE;
-                    inline: import("@wildo-ai/zod-decorators").SectionMode.INLINE;
-                    grid: import("@wildo-ai/zod-decorators").SectionMode.GRID;
-                    columns: import("@wildo-ai/zod-decorators").SectionMode.COLUMNS;
-                    tabs: import("@wildo-ai/zod-decorators").SectionMode.TABS;
-                    vertical_tabs: import("@wildo-ai/zod-decorators").SectionMode.VERTICAL_TABS;
-                    pills: import("@wildo-ai/zod-decorators").SectionMode.PILLS;
-                    accordion: import("@wildo-ai/zod-decorators").SectionMode.ACCORDION;
-                    expandable: import("@wildo-ai/zod-decorators").SectionMode.EXPANDABLE;
-                    stepper: import("@wildo-ai/zod-decorators").SectionMode.STEPPER;
-                    timeline: import("@wildo-ai/zod-decorators").SectionMode.TIMELINE;
-                }>>;
-                emptyStateMessage: z.ZodOptional<z.ZodString>;
-                ariaLabel: z.ZodOptional<z.ZodString>;
-                ariaLabelledBy: z.ZodOptional<z.ZodString>;
-                mode: z.ZodLiteral<import("@wildo-ai/zod-decorators").SectionMode.EXPANDABLE>;
-                initialVisibleCount: z.ZodOptional<z.ZodNumber>;
-                showMoreLabel: z.ZodOptional<z.ZodString>;
-                showLessLabel: z.ZodOptional<z.ZodString>;
-            }, z.core.$strict, core.$ZodObjectExtra>, z.ZodObject<{
-                showSingleSectionNav: z.ZodOptional<z.ZodBoolean>;
-                hideWhenEmpty: z.ZodOptional<z.ZodBoolean>;
-                fallbackMode: z.ZodOptional<z.ZodEnum<{
-                    collapsible: import("@wildo-ai/zod-decorators").SectionMode.COLLAPSIBLE;
-                    inline: import("@wildo-ai/zod-decorators").SectionMode.INLINE;
-                    grid: import("@wildo-ai/zod-decorators").SectionMode.GRID;
-                    columns: import("@wildo-ai/zod-decorators").SectionMode.COLUMNS;
-                    tabs: import("@wildo-ai/zod-decorators").SectionMode.TABS;
-                    vertical_tabs: import("@wildo-ai/zod-decorators").SectionMode.VERTICAL_TABS;
-                    pills: import("@wildo-ai/zod-decorators").SectionMode.PILLS;
-                    accordion: import("@wildo-ai/zod-decorators").SectionMode.ACCORDION;
-                    expandable: import("@wildo-ai/zod-decorators").SectionMode.EXPANDABLE;
-                    stepper: import("@wildo-ai/zod-decorators").SectionMode.STEPPER;
-                    timeline: import("@wildo-ai/zod-decorators").SectionMode.TIMELINE;
-                }>>;
-                emptyStateMessage: z.ZodOptional<z.ZodString>;
-                ariaLabel: z.ZodOptional<z.ZodString>;
-                ariaLabelledBy: z.ZodOptional<z.ZodString>;
-                mode: z.ZodLiteral<import("@wildo-ai/zod-decorators").SectionMode.STEPPER>;
-                allowSkip: z.ZodOptional<z.ZodBoolean>;
-                showProgress: z.ZodOptional<z.ZodBoolean>;
-                orientation: z.ZodOptional<z.ZodEnum<typeof import("@wildo-ai/zod-decorators").DisplayDirection>>;
-                nextLabel: z.ZodOptional<z.ZodString>;
-                previousLabel: z.ZodOptional<z.ZodString>;
-                completeLabel: z.ZodOptional<z.ZodString>;
-            }, z.core.$strict, core.$ZodObjectExtra>, z.ZodObject<{
-                showSingleSectionNav: z.ZodOptional<z.ZodBoolean>;
-                hideWhenEmpty: z.ZodOptional<z.ZodBoolean>;
-                fallbackMode: z.ZodOptional<z.ZodEnum<{
-                    collapsible: import("@wildo-ai/zod-decorators").SectionMode.COLLAPSIBLE;
-                    inline: import("@wildo-ai/zod-decorators").SectionMode.INLINE;
-                    grid: import("@wildo-ai/zod-decorators").SectionMode.GRID;
-                    columns: import("@wildo-ai/zod-decorators").SectionMode.COLUMNS;
-                    tabs: import("@wildo-ai/zod-decorators").SectionMode.TABS;
-                    vertical_tabs: import("@wildo-ai/zod-decorators").SectionMode.VERTICAL_TABS;
-                    pills: import("@wildo-ai/zod-decorators").SectionMode.PILLS;
-                    accordion: import("@wildo-ai/zod-decorators").SectionMode.ACCORDION;
-                    expandable: import("@wildo-ai/zod-decorators").SectionMode.EXPANDABLE;
-                    stepper: import("@wildo-ai/zod-decorators").SectionMode.STEPPER;
-                    timeline: import("@wildo-ai/zod-decorators").SectionMode.TIMELINE;
-                }>>;
-                emptyStateMessage: z.ZodOptional<z.ZodString>;
-                ariaLabel: z.ZodOptional<z.ZodString>;
-                ariaLabelledBy: z.ZodOptional<z.ZodString>;
-                mode: z.ZodLiteral<import("@wildo-ai/zod-decorators").SectionMode.TIMELINE>;
-            }, z.core.$strict, core.$ZodObjectExtra>], "mode">>]>>;
-            hidden: z.ZodOptional<z.ZodBoolean>;
-        }, z.core.$strict, core.$ZodObjectExtra>>;
         inParentNavigation: z.ZodOptional<z.ZodObject<{
-            transition: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodEnum<typeof import("../index.js").NavigationTransition>, z.ZodObject<{
-                transition: z.ZodEnum<typeof import("../index.js").NavigationTransition>;
+            transition: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodEnum<typeof import("..").NavigationTransition>, z.ZodObject<{
+                transition: z.ZodEnum<typeof import("..").NavigationTransition>;
                 persistent: z.ZodOptional<z.ZodBoolean>;
                 ephemeral: z.ZodOptional<z.ZodBoolean>;
-            }, z.core.$strip, core.$ZodObjectExtra>]>, z.ZodRecord<z.ZodEnum<typeof import("@wildo-ai/zod-decorators").ViewportBreakpoint> & z.core.$partial, z.ZodUnion<readonly [z.ZodEnum<typeof import("../index.js").NavigationTransition>, z.ZodObject<{
-                transition: z.ZodEnum<typeof import("../index.js").NavigationTransition>;
+            }, z.core.$strip>]>, z.ZodRecord<z.ZodEnum<typeof import("@wildo-ai/zod-decorators").ViewportBreakpoint> & z.core.$partial, z.ZodUnion<readonly [z.ZodEnum<typeof import("..").NavigationTransition>, z.ZodObject<{
+                transition: z.ZodEnum<typeof import("..").NavigationTransition>;
                 persistent: z.ZodOptional<z.ZodBoolean>;
                 ephemeral: z.ZodOptional<z.ZodBoolean>;
-            }, z.core.$strip, core.$ZodObjectExtra>]>>]>>;
+            }, z.core.$strip>]>>]>>;
             maxDepth: z.ZodOptional<z.ZodNumber>;
-            direction: z.ZodOptional<z.ZodEnum<typeof import("./resources.shared.core.definitions.js").CascadeDirection>>;
+            direction: z.ZodOptional<z.ZodEnum<typeof import("./resources.shared.core.definitions").CascadeDirection>>;
             ancestorOperation: z.ZodOptional<z.ZodEnum<typeof CoreResourceOperation>>;
-        }, z.core.$strict, core.$ZodObjectExtra>>;
+        }, z.core.$strict>>;
         inChildView: z.ZodOptional<z.ZodObject<{
             showParentLink: z.ZodOptional<z.ZodBoolean>;
-            parentDisplay: z.ZodOptional<z.ZodEnum<typeof import("./relationship-display.shared.schemas.js").ParentDisplay>>;
-        }, z.core.$strict, core.$ZodObjectExtra>>;
+            parentDisplay: z.ZodOptional<z.ZodEnum<typeof import("./relationship-display.shared.schemas").ParentDisplay>>;
+        }, z.core.$strict>>;
         interaction: z.ZodOptional<z.ZodObject<{
             allowQuickCreate: z.ZodOptional<z.ZodBoolean>;
-        }, z.core.$strict, core.$ZodObjectExtra>>;
-    }, z.core.$strict, core.$ZodObjectExtra>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
     foreignKeyField: z.ZodOptional<z.ZodString>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+    scopeViaJunction: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof CoreResourceType>, z.ZodString]>>;
+    scopeMembership: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodObject<{
+        scopeField: z.ZodOptional<z.ZodString>;
+        junction: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof CoreResourceType>, z.ZodString]>>;
+        junctionScopeField: z.ZodOptional<z.ZodString>;
+        junctionTargetField: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>;
+    urlOperationScope: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof CoreResourceOperation>>>;
+}, z.core.$strip>;
+/** @wildo_source:part:end saas.models.resource-relationship-schema */
+/**
+ * @wildo_source:part:start saas.models.resource-relationship-resolved-semantics facet:layer:shared facet:family:resource-config
+ *
+ * Condition function, resolved semantics contract (factory output shape).
+ */
 /**
  * Function-based condition for conditional relationships.
  * Evaluated at runtime with the PARENT resource data.
@@ -1168,9 +899,13 @@ export interface ResolvedRelationshipSemantics {
      */
     readCalculationMode: ResolvedRelationshipReadCalculationMode;
     handling: RelationshipHandlingContract;
+    persistence: RelationshipPersistenceContract;
     childOperations?: ChildOperationsConfig_Parsed;
 }
+/** @wildo_source:part:end saas.models.resource-relationship-resolved-semantics */
 /**
+ * @wildo_source:part:start saas.models.resource-relationship-declaration facet:layer:shared facet:family:resource-config
+ *
  * Developer-authored relationship declaration.
  *
  * The `condition` function cannot be represented in a Zod schema (functions aren't
@@ -1210,6 +945,8 @@ export interface ResolvedRelationshipSemantics {
  * The key design insight is that conditions are a RUNTIME concern. At startup
  * (factory/DTO/URL), all relationships are processed unconditionally — conditions
  * are evaluated only when actual parent data is available.
+ *
+ * Runtime registry rows also carry `resolvedSemantics` (see `ResourceRelationship`).
  */
 export type ResourceRelationshipDeclaration = z.infer<typeof ResourceRelationshipSchema> & {
     condition?: ResourceRelationshipConditionFn;
@@ -1224,29 +961,30 @@ export type ResourceRelationshipDeclaration = z.infer<typeof ResourceRelationshi
 export type ResourceRelationship = ResourceRelationshipDeclaration & {
     resolvedSemantics: ResolvedRelationshipSemantics;
 };
+/** @wildo_source:part:end saas.models.resource-relationship-declaration */
 /**
  * Default response patterns for resource operations based on best practices
  */
 export declare const DefaultDeleteResponseSchema: z.ZodObject<{
     id: z.ZodString;
     deletedAt: z.ZodOptional<z.ZodDate>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type DefaultDeleteResponse = z.infer<typeof DefaultDeleteResponseSchema>;
 export declare const DefaultBulkDeleteResponseSchema: z.ZodObject<{
     deletedIds: z.ZodArray<z.ZodString>;
     deletedCount: z.ZodNumber;
     deletedAt: z.ZodOptional<z.ZodDate>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type DefaultBulkDeleteResponse = z.infer<typeof DefaultBulkDeleteResponseSchema>;
 export declare const DefaultUpdateManyResponseSchema: z.ZodObject<{
     updatedCount: z.ZodNumber;
     updatedIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
     updatedAt: z.ZodOptional<z.ZodDate>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type DefaultUpdateManyResponse = z.infer<typeof DefaultUpdateManyResponseSchema>;
 export declare const DefaultCountResponseSchema: z.ZodObject<{
     count: z.ZodNumber;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type DefaultCountResponse = z.infer<typeof DefaultCountResponseSchema>;
 export interface DefaultCreateManyResponse<T> {
     items: T[];
@@ -1266,7 +1004,7 @@ export declare const DefaultActionResponseSchema: z.ZodObject<{
     message: z.ZodOptional<z.ZodString>;
     executedAt: z.ZodDate;
     result: z.ZodOptional<z.ZodAny>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type DefaultActionResponse = z.infer<typeof DefaultActionResponseSchema>;
 /**
  * Fields that are always discarded from create/update payloads at runtime.
@@ -1277,6 +1015,73 @@ export type DefaultActionResponse = z.infer<typeof DefaultActionResponseSchema>;
  */
 export declare const createOrUpdateMandatoryDiscardFields: readonly string[];
 export declare function getDefaultResponseSchemaForOperation<T extends z.ZodTypeAny>(operation: string, mainSchema: T): z.ZodTypeAny;
+/**
+ * Core operations whose service-layer OUTPUT is validated against their declared RESPONSE
+ * envelope (a framework `Default*ResponseSchema`), NOT against the resource object. For these,
+ * the DTO builder sets `internalDto` to the response envelope (`responseDtoInternal`) instead of
+ * `enhancedMainSchema` — otherwise output validation parses the envelope value against the resource
+ * schema and throws `service_resource_transformation_failed` (HTTP 500).
+ *
+ * ⚠️ KEY ON THE OPERATION'S OWN `operationIdentifier`, NOT `resourceOperationLike` /
+ * `effectiveOperation`. `resourceOperationLike` is a ROUTING / HTTP-verb / authorization hint — a
+ * CUSTOM operation may borrow `DELETE`/`COUNT` semantics for its URL and permissions while returning
+ * its own object shape (via `REPLACE_CORE_OPERATIONS` or a `customResponseDto`, e.g. SIEM
+ * `PURGE_ALL` → `{ purgedCount, … }`). Only
+ * the genuine core operation carries `operationIdentifier === CoreResourceOperation.DELETE` etc.;
+ * custom ops carry a custom identifier. Keying on `operationIdentifier` is what stops the composer
+ * wrapping a custom op's object as `{ id: <object> }`.
+ *
+ * Membership rationale:
+ *  - `DELETE` / `DELETE_MANY` — the service+repository layer returns the deleted id(s) as a bare
+ *    scalar; {@link composeDefaultOperationResponse} lifts that into the envelope.
+ *  - `COUNT` — the service already returns `{ count }`, so no composition is needed, but its
+ *    `internalDto` must still be the `{ count }` envelope rather than the resource object.
+ *
+ * Deliberately EXCLUDED: bulk mutations (`CREATE_MANY` / `UPDATE_MANY`). At runtime they return an
+ * ARRAY of resource items that the transform/serializer validate PER-ITEM against the resource
+ * schema (see the `isBulkOperation` branch in `getDefaultResponseSchemaForOperation` /
+ * `buildEnhancedResponseDto`) — they are object-shaped per item, not a count envelope, so they
+ * must keep `enhancedMainSchema`.
+ *
+ * Keep this set, {@link composeDefaultOperationResponse}, and the `internalDto` routing in the DTO
+ * builder in lockstep.
+ */
+export declare const OUTPUT_ENVELOPE_OPERATIONS: readonly string[];
+/** True when this is a genuine core envelope operation (see {@link OUTPUT_ENVELOPE_OPERATIONS}).
+ * Pass the operation's OWN `operationIdentifier`, never `resourceOperationLike`/`effectiveOperation`
+ * (a custom op borrowing the verb has a custom identifier and returns its own shape). */
+export declare function isOutputEnvelopeOperation(operationIdentifier: string): boolean;
+/**
+ * Value-level twin of {@link getDefaultResponseSchemaForOperation}: composes an operation's
+ * DECLARED default response value from the raw service/repository output, so the value that flows
+ * into output validation (`transformOutput`) and response serialization matches the declared
+ * schema. This is the single, GENERAL seam for "the runtime returns a lower-level value than the
+ * declared response envelope" — callers invoke it uniformly instead of special-casing operations.
+ *
+ * ⚠️ Pass the operation's OWN `operationIdentifier`, NOT `resourceOperationLike`/`effectiveOperation`
+ * (see {@link OUTPUT_ENVELOPE_OPERATIONS}). And callers MUST skip composition when the operation
+ * declares its own `customResponseDto` (`hasCustomResponseDto`) — that op returns its custom shape
+ * directly, exactly as `buildEnhancedResponseDto` lets a custom `responseDto` win over the default.
+ * Both guards together keep this a true identity for every operation that already returns its final
+ * shape, so ONLY genuine core `DELETE`/`DELETE_MANY` are ever transformed.
+ *
+ * Identity for every operation whose service output already IS its declared shape: `READ` /
+ * `CREATE` / `UPDATE` (resource object), `CREATE_MANY` / `UPDATE_MANY` (array of items, validated
+ * per-item), `COUNT` (`{ count }`), `LIST` / `SEARCH` (`{ data, pagination }`), and every custom
+ * operation (its own DTO value). The only non-identity cases are the core deletes, whose repository
+ * layer returns the deleted id(s) as a bare scalar (`delete(): Promise<string>` — the `_id`, or
+ * `''` when nothing matched; `deleteMany(): Promise<string[]>`):
+ *  - `DELETE`      → `{ id }`                        (`DefaultDeleteResponseSchema`)
+ *  - `DELETE_MANY` → `{ deletedIds, deletedCount }`  (`DefaultBulkDeleteResponseSchema`)
+ *
+ * `DELETE` always wraps as `{ id }`. If a singular `DELETE` is invoked with a filter it delegates to
+ * `deleteMany` and returns a `string[]` (a misuse that should target `DELETE_MANY`); that becomes
+ * `{ id: string[] }` and downstream `internalDto` validation surfaces the anomaly rather than
+ * silently coercing it. Likewise a non-array `DELETE_MANY` output passes through to fail validation.
+ * Keep this switch in lockstep with {@link getDefaultResponseSchemaForOperation} and
+ * {@link OUTPUT_ENVELOPE_OPERATIONS}.
+ */
+export declare function composeDefaultOperationResponse(operationIdentifier: string, serviceOutput: unknown): unknown;
 export declare function operationShouldHaveRequestDto(operation: string): boolean;
 /**
  * Database-agnostic Resource ID utilities
@@ -1297,6 +1102,181 @@ export declare enum ResourceIdFormat {
     /** MongoDB ObjectId - 24 character hexadecimal string */
     OBJECT_ID = "OBJECT_ID",
     /** PostgreSQL UUID - 36 character UUID with dashes */
-    UUID = "UUID"
+    UUID = "UUID",
+    /**
+     * The synthesized id of an `HTTP_API`-backed resource: encoded (or charset-safe verbatim) remote
+     * key components, produced ONLY by the codec authority in
+     * `http-api-binding/http-api-binding-id.shared.utils.ts` — never minted. Lexical shape: the
+     * charset law `^[A-Za-z0-9._~-]+$`. Deliberately NOT added to `detectIdFormat` /
+     * `isValidResourceId` (the strict two-format world stays strict for platform-backed rows —
+     * paper A: never loosen a shared validator silently); it participates only where the RESOURCE
+     * is known to be HTTP_API-backed (`ResourceIdBackendService.getFormatForResource`).
+     */
+    HTTP_API_SYNTHESIZED = "HTTP_API_SYNTHESIZED",
+    /**
+     * The synthesized id of an `INTROSPECTION`-backed resource: the key of a row DERIVED from the
+     * application's own structure, never minted and never stored.
+     *
+     * A distinct member from {@link HTTP_API_SYNTHESIZED} even though both admit the same charset,
+     * because they answer different questions and will diverge: an HTTP-API id encodes a REMOTE
+     * entity's key through a codec that can round-trip it, while an introspected id is whatever the
+     * companion behavior's projection already calls the row — a module name, a composed structural
+     * key. Merging them would put one name on two origins, and the next reader could not tell which
+     * validator's rules a given id was admitted under.
+     *
+     * Like its sibling it is deliberately absent from `detectIdFormat` / `isValidResourceId`: the
+     * strict two-format world stays strict for platform-backed rows, and this widening applies only
+     * where the RESOURCE is known to be INTROSPECTION-backed.
+     */
+    INTROSPECTION_SYNTHESIZED = "INTROSPECTION_SYNTHESIZED"
 }
+/**
+ * Descriptor for a **scope-required reference search** through an M:N junction.
+ *
+ * When a foreign key targets resource `T` and the holder resource's primary
+ * scope is `S`, and `T ↔ S` is a MANY-to-MANY relationship via junction `J`,
+ * a reference people-picker for that FK must search `T` **scoped to the caller's
+ * current `S`** through `J` (rather than enumerating every `T` globally) — see
+ * `.claude/plans/fk-filter-reference-search.md`. This descriptor names the
+ * junction and the two foreign-key columns the junction carries to each peer.
+ *
+ * The junction's FK columns are resolved by convention as each peer's
+ * `resourceFieldIdentifier` (e.g. `organizationMembers` carries `userId` for the
+ * USERS peer and `organizationId` for the ORGANIZATIONS peer).
+ */
+export interface ManyToManyScopeJunction {
+    /** The junction resource that joins the two peers (e.g. `organizationMembers`). */
+    junctionResourceType: string;
+    /** The junction's FK column referencing the search TARGET `T` (e.g. `userId`). */
+    targetFkField: string;
+    /** The junction's FK column referencing the SCOPE `S` (e.g. `organizationId`). */
+    scopeFkField: string;
+}
+/**
+ * Lookup keyed by `${targetResourceType}|${scopeResourceType}` →
+ * {@link ManyToManyScopeJunction}. Both orderings of every M:N are recorded, so
+ * either peer can be the search target with the other as the scope. Built once
+ * at registry init via `Resources_SharedUtils.buildManyToManyScopeJunctionMap`.
+ */
+export type ManyToManyScopeJunctionMap = ReadonlyMap<string, ManyToManyScopeJunction>;
+/**
+ * @wildo_source:part:start saas.models.resource-config.forwarded-label facet:layer:shared facet:family:resource-config
+ *
+ * A **label-forwarding descriptor** — declares how a junction (or any) resource
+ * row labels itself using fields from a RELATED resource, resolved SERVER-SIDE
+ * and projected onto the response DTO via {@link forwardedLabel}.
+ *
+ * Reuses the join vocabulary of `SearchableRelationDescriptor` (from
+ * `@wildo-ai/saas-models`), resolved in the read direction. WHY a
+ * descriptor and not denormalization: the human-meaningful label lives on a
+ * RELATED resource and is MUTABLE there (a user's first/last name on
+ * `USER_PROFILES`); copying it onto the junction would go stale and demand a sync
+ * hook on every mutation path. Resolving the related resource's own fields at read
+ * time is single-source-of-truth, never stale, and reaches a resource DIFFERENT
+ * from the foreign key's declared target (the name lives on `USER_PROFILES`, not
+ * on `users`, the FK target — joined on the shared `userId`).
+ *
+ * TENANT SAFETY (by construction): the descriptor only resolves related rows for
+ * `localField` values that appear on rows the caller can ALREADY see (its own
+ * already-scoped page), so the related read is a bounded SYSTEM read that can
+ * never widen visibility — the same contract `SearchableRelationDescriptor`
+ * relies on, mirrored for reads. The viewer therefore needs no read access to the
+ * related row itself (e.g. another member's `user_profile`).
+ *
+ * @remarks Resolution requires the related resource to be MongoDB-backed. If the
+ * related resource is PostgreSQL-backed the read is skipped and the label degrades
+ * to `fallback` — parity is a future enhancement, mirroring the same adapter gap
+ * on `SearchableRelationDescriptor`. Import from `@wildo-ai/saas-models`.
+ *
+ * @example
+ * // organizationMembers labels itself by the linked user's name. firstName/
+ * // lastName live on USER_PROFILES (mutable, deliberately NOT denormalized);
+ * // both members and profiles carry the same `userId`, so join on it.
+ * instanceLabel: forwardedLabel({
+ *   localField: 'userId',
+ *   relatedResource: CoreResourceType.USER_PROFILES,
+ *   relatedJoinField: 'userId',
+ *   fields: ['firstName', 'lastName'],
+ *   fallbackField: 'userEmail', // shown when the profile/name is unavailable
+ * })
+ */
+export type LabelRelationDescriptor = {
+    /** Field on THIS resource holding the join value (e.g. `userId`). */
+    localField: string;
+    /** The related resource whose fields are rendered into the label (e.g. `USER_PROFILES`). */
+    relatedResource: ResourceType;
+    /**
+     * Field on the related resource matched against {@link localField}'s value.
+     * Defaults to the related primary key (`_id`) — set it explicitly when joining
+     * on a shared key other than the primary key (e.g. members and profiles both
+     * carry `userId`).
+     */
+    relatedJoinField?: string;
+    /**
+     * Related fields to render, in order. Required: unlike search (which can default
+     * to the related resource's own `searchableFields`), a label must declare what
+     * to show. Resolving the related resource's OWN label as a default is a possible
+     * future enhancement (it needs server-side label resolution that does not exist
+     * in this path today).
+     */
+    fields: string[];
+    /** Join separator between rendered field values. Default `' '` (single space). */
+    separator?: string;
+    /**
+     * OWN-field on THIS resource used as the fallback label when the related row is
+     * missing or every rendered field is empty — preferred over the static
+     * {@link fallback}. Use an immutable own identifier (e.g. a denormalized
+     * `userEmail`) so a row without a resolvable related label still shows a human
+     * value instead of degrading to a raw id. Must be on the summary row (a summary
+     * field) to be available to the resolver.
+     */
+    fallbackField?: string;
+    /**
+     * Static label of last resort, when the related row is missing/empty AND
+     * {@link fallbackField} is unset or also empty. Default `''` (empty).
+     */
+    fallback?: string;
+};
+/**
+ * Pure renderer for a {@link LabelRelationDescriptor}: join the descriptor's
+ * `fields` (in declared order, skipping empty values) from a resolved related
+ * row, using `separator`, falling back to `fallback` when the row is absent or
+ * the result is empty. Exported so it is unit-testable independently of the
+ * virtual-field runtime.
+ */
+export declare function renderForwardedLabel(relatedRow: Record<string, unknown> | undefined | null, descriptor: LabelRelationDescriptor, options?: {
+    locale?: string;
+}): string;
+/**
+ * Build a VIRTUAL summary field that labels a row from a related resource per a
+ * {@link LabelRelationDescriptor}. Drop it into a resource's main schema; the
+ * frontend then references the field name in `getFrontendResourceLabel` (a plain,
+ * synchronous field ref — no async resolver).
+ *
+ * The returned field is `isVirtual` (computed, never persisted; excluded from
+ * request DTOs), `isSummaryField` (included in the SUMMARY DTO, so it is present
+ * in LIST/collection rows, not only on READ), and `isHidden({ display: true })`
+ * (it IS the row/title label, so it must never ALSO auto-render as a standalone
+ * card field or table column — `detectSummaryFields` skips display-hidden fields;
+ * the value still reaches the frontend label, which reads the field by name). At
+ * read time the framework's
+ * `VirtualFieldsBackendService` invokes the `calculate` below with the backend
+ * `utils`. `calculate`:
+ *   1. reads the join value from `currentObject[localField]`;
+ *   2. resolves the related row via the related repository's system read
+ *      `findFieldValuesByJoinField` (the read-direction sibling of the search
+ *      join's `findSearchMatchTargetIds`), deduped per request (see
+ *      {@link resolveRelatedRowDeduped});
+ *   3. renders the label via {@link renderForwardedLabel}.
+ * Failure modes (missing value, unavailable repo, absent/empty related row) degrade
+ * to the fallback chain — `descriptor.fallbackField`'s own-field value first, else
+ * `descriptor.fallback`; `calculate` never throws.
+ *
+ * @remarks `dependencies: [localField]` is consumed by the repository DTO builder
+ * (`repository-dto-builder.utils.ts`), which adds the dependency to the read
+ * projection — so `calculate` receives the join value even when `localField` is
+ * not itself a summary field. (On `organizationMembers`, `userId` is independently
+ * a summary field too.)
+ */
+export declare function forwardedLabel(descriptor: LabelRelationDescriptor): DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>;
 //# sourceMappingURL=resources.shared.schemas.d.ts.map