@wildo-ai/saas-models 1.0.1 → 1.1.0

package/dist/esm/resources/relationship-display.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relationship-display.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/resources/relationship-display.shared.schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"relationship-display.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/resources/relationship-display.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAiC,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAY9F;;;;;;;;;;;;;;;GAeG;AACH,oBAAY,aAAa;IACvB;;;OAGG;IACH,UAAU,eAAe;IACzB;;;;OAIG;IACH,OAAO,YAAY;IACnB;;;OAGG;IACH,KAAK,UAAU;IACf;;;OAGG;IACH,OAAO,YAAY;IACnB,qEAAqE;IACrE,IAAI,SAAS;CACd;AAOD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,2CAA2C;;;;;;;;;;;;;kBAwC7C,CAAC;AACZ,MAAM,MAAM,qCAAqC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2CAA2C,CAAC,CAAC;AAOhH;;;;;;;GAOG;AACH,eAAO,MAAM,oCAAoC;;;kBAoBtC,CAAC;AACZ,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAC;AAOlG;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,oCAAoC;;kBA4BtC,CAAC;AACZ,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAC;AAOlG;;;GAGG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;kBAajC,CAAC;AACZ,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC"}

package/dist/esm/resources/relationship-display.shared.schemas.js

@@ -4,7 +4,7 @@
  * How resource relationships are presented in frontend views.
  *
  * This file intentionally stays on the FRONTEND/UI plane:
- * - read composition (`inParentView`, `inChildView`)
+ * - read composition in the CHILD's view (`inChildView`)
  * - narrow workflow hints for frontend interaction (`interaction`)
  *
  * It is separate from:
@@ -12,8 +12,15 @@
  * - backend/nested handling (`childOperations`)
  * - navigation shell zoning, which lives in config/frontend/navigation.shared.schemas
  *
+ * NOTE (2026-08-20): view COMPOSITION was removed from this file. A parent no
+ * longer configures how its children appear inside its own view — the view
+ * places them (`RelatedResourceSections` / `EmbedRelatedResourceList`), or the
+ * framework composes owned children with no parameters at all. What remains here
+ * is relationship SEMANTICS: navigating an edge, presenting the parent inside the
+ * child, and workflow hints. See
+ * `.claude/plans/children-display-template-owned-composition.md`.
+ *
  * Key concepts:
- * - `inParentView`: How children appear in the parent's view as embedded content
  * - `inParentNavigation`: How parent-owned navigation to those children is orchestrated
  * - `inChildView`: How the parent reference appears in the child's detail view (breadcrumb, badge, etc.)
  *
@@ -23,102 +30,8 @@
  * @see createResourcesRelationship() display option
  */
 import { z } from 'zod';
-import { DisplayDirection, SectionMode } from '@wildo-ai/zod-decorators';
 import { CascadeDirection, CoreResourceOperation } from './resources.shared.core.definitions.js';
 import { TransitionConfigSchema, viewportDiscriminatedSchema, } from '../config/frontend/navigation.shared.schemas.js';
-const RelationshipEmbeddedSectionGapSchema = z.enum(['sm', 'md', 'lg']);
-export const RELATIONSHIP_EMBEDDED_SECTION_MODES = [
-    SectionMode.COLLAPSIBLE,
-    SectionMode.INLINE,
-    SectionMode.GRID,
-    SectionMode.COLUMNS,
-    SectionMode.TABS,
-    SectionMode.VERTICAL_TABS,
-    SectionMode.PILLS,
-    SectionMode.ACCORDION,
-    SectionMode.EXPANDABLE,
-    SectionMode.STEPPER,
-    SectionMode.TIMELINE,
-];
-export const RelationshipEmbeddedSectionModeSchema = z.enum(RELATIONSHIP_EMBEDDED_SECTION_MODES);
-const RelationshipEmbeddedSectionConfigBaseSchema = z.object({
-    showSingleSectionNav: z.boolean().optional(),
-    hideWhenEmpty: z.boolean().optional(),
-    fallbackMode: RelationshipEmbeddedSectionModeSchema.optional(),
-    emptyStateMessage: z.string().optional(),
-    ariaLabel: z.string().optional(),
-    ariaLabelledBy: z.string().optional(),
-});
-const RelationshipEmbeddedSectionConfig_CollapsibleSchema = RelationshipEmbeddedSectionConfigBaseSchema.extend({
-    mode: z.literal(SectionMode.COLLAPSIBLE),
-    triggerLabel: z.object({
-        open: z.string(),
-        closed: z.string(),
-    }).optional(),
-}).strict();
-const RelationshipEmbeddedSectionConfig_InlineSchema = RelationshipEmbeddedSectionConfigBaseSchema.extend({
-    mode: z.literal(SectionMode.INLINE),
-    gap: RelationshipEmbeddedSectionGapSchema.optional(),
-}).strict();
-const RelationshipEmbeddedSectionConfig_GridSchema = RelationshipEmbeddedSectionConfigBaseSchema.extend({
-    mode: z.literal(SectionMode.GRID),
-    columnCount: z.union([z.number(), z.literal('auto')]).optional(),
-    gap: RelationshipEmbeddedSectionGapSchema.optional(),
-    minColumnWidth: z.string().optional(),
-}).strict();
-const RelationshipEmbeddedSectionConfig_ColumnsSchema = RelationshipEmbeddedSectionConfigBaseSchema.extend({
-    mode: z.literal(SectionMode.COLUMNS),
-    columnCount: z.union([z.number(), z.literal('auto')]).optional(),
-    gap: RelationshipEmbeddedSectionGapSchema.optional(),
-}).strict();
-const RelationshipEmbeddedSectionConfig_TabsSchema = RelationshipEmbeddedSectionConfigBaseSchema.extend({
-    mode: z.literal(SectionMode.TABS),
-    allowNone: z.boolean().optional(),
-}).strict();
-const RelationshipEmbeddedSectionConfig_VerticalTabsSchema = RelationshipEmbeddedSectionConfigBaseSchema.extend({
-    mode: z.literal(SectionMode.VERTICAL_TABS),
-    allowNone: z.boolean().optional(),
-    navWidth: z.string().optional(),
-}).strict();
-const RelationshipEmbeddedSectionConfig_PillsSchema = RelationshipEmbeddedSectionConfigBaseSchema.extend({
-    mode: z.literal(SectionMode.PILLS),
-    allowNone: z.boolean().optional(),
-}).strict();
-const RelationshipEmbeddedSectionConfig_AccordionSchema = RelationshipEmbeddedSectionConfigBaseSchema.extend({
-    mode: z.literal(SectionMode.ACCORDION),
-    allowMultiple: z.boolean().optional(),
-}).strict();
-const RelationshipEmbeddedSectionConfig_ExpandableSchema = RelationshipEmbeddedSectionConfigBaseSchema.extend({
-    mode: z.literal(SectionMode.EXPANDABLE),
-    initialVisibleCount: z.number().int().positive().optional(),
-    showMoreLabel: z.string().optional(),
-    showLessLabel: z.string().optional(),
-}).strict();
-const RelationshipEmbeddedSectionConfig_StepperSchema = RelationshipEmbeddedSectionConfigBaseSchema.extend({
-    mode: z.literal(SectionMode.STEPPER),
-    allowSkip: z.boolean().optional(),
-    showProgress: z.boolean().optional(),
-    orientation: z.enum(DisplayDirection).optional(),
-    nextLabel: z.string().optional(),
-    previousLabel: z.string().optional(),
-    completeLabel: z.string().optional(),
-}).strict();
-const RelationshipEmbeddedSectionConfig_TimelineSchema = RelationshipEmbeddedSectionConfigBaseSchema.extend({
-    mode: z.literal(SectionMode.TIMELINE),
-}).strict();
-export const RelationshipEmbeddedSectionConfigSchema = z.discriminatedUnion('mode', [
-    RelationshipEmbeddedSectionConfig_CollapsibleSchema,
-    RelationshipEmbeddedSectionConfig_InlineSchema,
-    RelationshipEmbeddedSectionConfig_GridSchema,
-    RelationshipEmbeddedSectionConfig_ColumnsSchema,
-    RelationshipEmbeddedSectionConfig_TabsSchema,
-    RelationshipEmbeddedSectionConfig_VerticalTabsSchema,
-    RelationshipEmbeddedSectionConfig_PillsSchema,
-    RelationshipEmbeddedSectionConfig_AccordionSchema,
-    RelationshipEmbeddedSectionConfig_ExpandableSchema,
-    RelationshipEmbeddedSectionConfig_StepperSchema,
-    RelationshipEmbeddedSectionConfig_TimelineSchema,
-]);
 // ════════════════════════════════════════════════════════════════
 // ParentDisplay — How parent reference renders in child view
 // ════════════════════════════════════════════════════════════════
@@ -165,66 +78,6 @@ export var ParentDisplay;
     ParentDisplay["NONE"] = "none";
 })(ParentDisplay || (ParentDisplay = {}));
 // ════════════════════════════════════════════════════════════════
-// RelationshipDisplayInParentView
-// ════════════════════════════════════════════════════════════════
-/**
- * How a relationship's children are rendered in the parent's view.
- *
- * This configures EMBEDDING / view composition for a relationship inside the
- * parent's surface.
- *
- * Key behavior:
- * - Navigation now lives in `display.inParentNavigation`.
- * - `contentSectionConfig` controls how embedded relationship sections are arranged.
- * - `hidden: true` → don't render this relationship at all.
- *
- * Old field mapping:
- * - `intent: 'none'` → `hidden: true`
- * - `inlineArrangement: 'tab'` → `contentSectionConfig: { mode: SectionMode.TABS }`
- * - `inlineArrangement: 'section'` → `contentSectionConfig: { mode: SectionMode.INLINE }`
- */
-export const RelationshipDisplayInParentViewSchema = z.object({
-    /**
-     * Ordering index for this relationship's tab/section within the parent view.
-     * Lower values appear first. Multiple relationships are sorted by this value.
-     */
-    orderIndex: z.number().optional(),
-    /**
-     * Maximum number of items to show inline before truncating.
-     * When exceeded, remaining items are hidden behind a "View all (N)" link.
-     */
-    inlineLimit: z.number().optional(),
-    /**
-     * Whether to show a "View all (N)" link when inline items are truncated.
-     * Clicking this link triggers a `list` transition from the source zone.
-     * @default true
-     */
-    showViewAllLink: z.boolean().optional(),
-    /**
-     * How the embedded relationship sections render (tabs, inline, accordion, etc.).
-     * Reuses the same structural section vocabulary as `ContentSectionContainer`,
-     * but only through a serializable relationship-owned subset.
-     *
-     * Framework defaults when omitted (based on relationship cardinality):
-     * - 1:1 / 0:1 → `{ mode: SectionMode.INLINE }`
-     * - 1:N → `{ mode: SectionMode.TABS }`
-     * - N:N → `{ mode: SectionMode.TABS }`
-     *
-     * Viewport-discriminated: e.g.
-     * `{ [ViewportBreakpoint.MOBILE]: { mode: SectionMode.ACCORDION } }`
-     * for accordion on mobile.
-     *
-     * Replaces old `inlineArrangement` field (`tab` → `tabs`, `section` → `inline`).
-     */
-    contentSectionConfig: viewportDiscriminatedSchema(RelationshipEmbeddedSectionConfigSchema).optional(),
-    /**
-     * When `true`, this relationship is not rendered at all in the parent view.
-     * The relationship still exists in the data model but has no UI representation.
-     * Replaces old `intent: 'none'`.
-     */
-    hidden: z.boolean().optional(),
-}).strict();
-// ════════════════════════════════════════════════════════════════
 // RelationshipDisplayInParentNavigation
 // ════════════════════════════════════════════════════════════════
 /**
@@ -237,8 +90,9 @@ export const RelationshipDisplayInParentViewSchema = z.object({
  * - how ancestor zones should be populated while cascading
  * - how deep relationship-owned navigation may grow before escalation
  *
- * Keeping these settings outside `inParentView` preserves the semantic
- * distinction between "show the child inline here" and "navigate from here".
+ * Keeping these settings on the relationship preserves the semantic distinction
+ * between navigating to a child (an edge concern, here) and COMPOSING one into a
+ * view (the view's concern — a template places it; see `RelatedResourceSections`).
  */
 export const RelationshipDisplayInParentNavigationSchema = z.object({
     /**
@@ -365,8 +219,6 @@ export const RelationshipDisplayInteractionSchema = z.object({
  * Passed as the `display` option in `createResourcesRelationship()`.
  */
 export const RelationshipDisplayConfigSchema = z.object({
-    /** How this relationship's children appear in the parent's view as embedded content. */
-    inParentView: RelationshipDisplayInParentViewSchema.optional(),
     /** How parent-owned navigation to those children is orchestrated. */
     inParentNavigation: RelationshipDisplayInParentNavigationSchema.optional(),
     /** How the parent reference appears in the child's detail view. */
@@ -380,4 +232,4 @@ export const RelationshipDisplayConfigSchema = z.object({
      */
     interaction: RelationshipDisplayInteractionSchema.optional(),
 }).strict();
-//# sourceMappingURL=relationship-display.shared.schemas.js.map
+//# sourceMappingURL=relationship-display.shared.schemas.js.map

package/dist/esm/resources/relationship-display.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"relationship-display.shared.schemas.js","sourceRoot":"","sources":["../../../src/resources/relationship-display.shared.schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"relationship-display.shared.schemas.js","sourceRoot":"","sources":["../../../../src/resources/relationship-display.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC9F,OAAO,EACL,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,8CAA8C,CAAC;AAItD,mEAAmE;AACnE,6DAA6D;AAC7D,mEAAmE;AAEnE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAN,IAAY,aAwBX;AAxBD,WAAY,aAAa;IACvB;;;OAGG;IACH,0CAAyB,CAAA;IACzB;;;;OAIG;IACH,oCAAmB,CAAA;IACnB;;;OAGG;IACH,gCAAe,CAAA;IACf;;;OAGG;IACH,oCAAmB,CAAA;IACnB,qEAAqE;IACrE,8BAAa,CAAA;AACf,CAAC,EAxBW,aAAa,KAAb,aAAa,QAwBxB;AAGD,mEAAmE;AACnE,wCAAwC;AACxC,mEAAmE;AAEnE;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,2CAA2C,GAAG,CAAC,CAAC,MAAM,CAAC;IAClE;;;;;;;;;;;;;;;;OAgBG;IACH,UAAU,EAAE,2BAA2B,CAAC,sBAAsB,CAAC,CAAC,QAAQ,EAAE;IAE1E;;;OAGG;IACH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAEhD;;;;;OAKG;IACH,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE;IAE9C;;;;OAIG;IACH,iBAAiB,EAAE,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,QAAQ,EAAE;CAC5D,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,mEAAmE;AACnE,iCAAiC;AACjC,mEAAmE;AAEnE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3D;;;;OAIG;IACH,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAEtC;;;;;;;;;;OAUG;IACH,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,mEAAmE;AACnE,iCAAiC;AACjC,mEAAmE;AAEnE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3D;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACzC,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,mEAAmE;AACnE,uCAAuC;AACvC,mEAAmE;AAEnE;;;GAGG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,qEAAqE;IACrE,kBAAkB,EAAE,2CAA2C,CAAC,QAAQ,EAAE;IAC1E,mEAAmE;IACnE,WAAW,EAAE,oCAAoC,CAAC,QAAQ,EAAE;IAC5D;;;;;;OAMG;IACH,WAAW,EAAE,oCAAoC,CAAC,QAAQ,EAAE;CAC7D,CAAC,CAAC,MAAM,EAAE,CAAC","sourcesContent":["/**\n * Relationship Display Configuration\n *\n * How resource relationships are presented in frontend views.\n *\n * This file intentionally stays on the FRONTEND/UI plane:\n * - read composition in the CHILD's view (`inChildView`)\n * - narrow workflow hints for frontend interaction (`interaction`)\n *\n * It is separate from:\n * - shared semantic meaning (`RelationshipNature`)\n * - backend/nested handling (`childOperations`)\n * - navigation shell zoning, which lives in config/frontend/navigation.shared.schemas\n *\n * NOTE (2026-08-20): view COMPOSITION was removed from this file. A parent no\n * longer configures how its children appear inside its own view — the view\n * places them (`RelatedResourceSections` / `EmbedRelatedResourceList`), or the\n * framework composes owned children with no parameters at all. What remains here\n * is relationship SEMANTICS: navigating an edge, presenting the parent inside the\n * child, and workflow hints. See\n * `.claude/plans/children-display-template-owned-composition.md`.\n *\n * Key concepts:\n * - `inParentNavigation`: How parent-owned navigation to those children is orchestrated\n * - `inChildView`: How the parent reference appears in the child's detail view (breadcrumb, badge, etc.)\n *\n * Uses navigation types (TransitionConfig) as building blocks for relationship-level\n * transition overrides, but the display config itself belongs to the resource domain.\n *\n * @see createResourcesRelationship() display option\n */\n\nimport { z } from 'zod';\nimport { DisplayDirection, SectionMode, ViewportBreakpoint } from '@wildo-ai/zod-decorators';\nimport { CascadeDirection, CoreResourceOperation } from './resources.shared.core.definitions';\nimport {\n  TransitionConfigSchema,\n  viewportDiscriminatedSchema,\n} from '../config/frontend/navigation.shared.schemas';\n\n\n\n// ════════════════════════════════════════════════════════════════\n// ParentDisplay — How parent reference renders in child view\n// ════════════════════════════════════════════════════════════════\n\n/**\n * How the parent reference appears in the child's detail view.\n *\n * Controls the structural element in the child's view that references the parent\n * resource. This is NOT about the FK field rendering (which is handled by\n * `ForeignKeyUIDisplayParams.mode` via `.foreignKeyUI()`).\n *\n * Values align with framework behavior:\n * - `breadcrumb`: Rendered via BreadcrumbCompound as a breadcrumb segment.\n * - `context`: Framework's context bar / header link — parent in the contextual header area.\n * - `summary`: Matches ForeignKeyDisplayMode.SUMMARY — compact card with key parent fields\n *   (same rendering pattern as FK summary view).\n * - `badge`: Compact badge/chip in header area.\n *\n * Replaces the old `RelationshipDisplayMode` enum (link/badge/inline/none).\n */\nexport enum ParentDisplay {\n  /**\n   * Parent as breadcrumb segment. Rendered via BreadcrumbCompound.\n   * Example: \"Projects > Alpha\" with parent as a clickable segment.\n   */\n  BREADCRUMB = 'breadcrumb',\n  /**\n   * Parent in the framework's context bar / header link area.\n   * Matches framework's contextual parent reference (header link, context bar).\n   * Default for most relationships.\n   */\n  CONTEXT = 'context',\n  /**\n   * Compact badge/chip in header area showing parent identity.\n   * Matches framework's badge display. Less prominent than context/breadcrumb.\n   */\n  BADGE = 'badge',\n  /**\n   * Inline summary card. Matches ForeignKeyDisplayMode.SUMMARY — compact card\n   * with key parent fields (same rendering as FK summary view).\n   */\n  SUMMARY = 'summary',\n  /** Don't show any parent reference. The child appears standalone. */\n  NONE = 'none',\n}\n\n\n// ════════════════════════════════════════════════════════════════\n// RelationshipDisplayInParentNavigation\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Parent-owned navigation behavior for a relationship surface.\n *\n * This subtree answers navigation questions that do NOT belong to embedded\n * composition itself:\n * - when a header or \"View all\" action should navigate\n * - which transition should be used\n * - how ancestor zones should be populated while cascading\n * - how deep relationship-owned navigation may grow before escalation\n *\n * Keeping these settings on the relationship preserves the semantic distinction\n * between navigating to a child (an edge concern, here) and COMPOSING one into a\n * view (the view's concern — a template places it; see `RelatedResourceSections`).\n */\nexport const RelationshipDisplayInParentNavigationSchema = z.object({\n  /**\n   * Navigation transition override for this relationship.\n   * When undefined, the relationship stays embed-first and callers decide\n   * whether any separate navigation affordance should exist.\n   *\n   * Old field mapping:\n   * - `intent: 'inline'` → no `transition`\n   * - `intent: 'detail'` → `transition: NavigationTransition.SPLIT`\n   * - `intent: 'drill'` → `transition: NavigationTransition.PUSH`\n   * - `intent: 'companion'` → `transition: { transition: NavigationTransition.SPLIT, persistent: true }`\n   * - `intent: 'inspect'` → `transition: { transition: NavigationTransition.OVERLAY, ephemeral: true }`\n   *\n   * New v3 transitions available at the relationship level:\n   * - `NavigationTransition.INPLACE`: edit/create child inline within the parent view\n   *   (element transforms without zone or stack change)\n   * - `NavigationTransition.PROMOTE`: open child at primary scope, escaping current context\n   */\n  transition: viewportDiscriminatedSchema(TransitionConfigSchema).optional(),\n\n  /**\n   * Override global `maxDepth` for this relationship's navigation chain.\n   * When the push stack reaches this depth, the framework escalates to overlay.\n   */\n  maxDepth: z.number().int().positive().optional(),\n\n  /**\n   * For self-referencing relationships (e.g. Category → Category):\n   * which direction to traverse when fetching data.\n   * - `CascadeDirection.FORWARD`: declaring resource is the ancestor (parent → child)\n   * - `CascadeDirection.BACKWARD`: related resource is the ancestor (child → parent)\n   */\n  direction: z.enum(CascadeDirection).optional(),\n\n  /**\n   * Override which operation to show in the ancestor zone when cascading.\n   * When a child is placed in SECONDARY or COMPANION, ancestor zones are auto-populated.\n   * Defaults: 1:N → LIST, 1:1 → READ, M:N → LIST. Use this to force LIST or READ.\n   */\n  ancestorOperation: z.enum(CoreResourceOperation).optional(),\n}).strict();\nexport type RelationshipDisplayInParentNavigation = z.infer<typeof RelationshipDisplayInParentNavigationSchema>;\n\n\n// ════════════════════════════════════════════════════════════════\n// RelationshipDisplayInChildView\n// ════════════════════════════════════════════════════════════════\n\n/**\n * How the parent reference appears in the child's detail view.\n *\n * Controls a structural element in the child's view header/context area.\n * This is separate from FK field rendering (`ForeignKeyUIDisplayParams`):\n * - FK params control the FK FIELD widget (raw ID, resolved label, summary card)\n * - This controls a dedicated PARENT REFERENCE element (breadcrumb, badge, card)\n */\nexport const RelationshipDisplayInChildViewSchema = z.object({\n  /**\n   * Whether the parent display element is clickable.\n   * When `true` (default for required relationships), clicking the parent reference\n   * triggers a `read` transition to the parent resource from the current zone.\n   */\n  showParentLink: z.boolean().optional(),\n\n  /**\n   * How the parent reference renders structurally in the child's view header.\n   * - `ParentDisplay.BREADCRUMB`: breadcrumb segment (BreadcrumbCompound)\n   * - `ParentDisplay.CONTEXT` (default): framework context bar / header link\n   * - `ParentDisplay.BADGE`: compact chip in header area\n   * - `ParentDisplay.SUMMARY`: compact card (matches ForeignKeyDisplayMode.SUMMARY)\n   * - `ParentDisplay.NONE`: hidden — no parent reference shown\n   *\n   * Replaces old `displayMode` field (renamed to avoid collision with other\n   * `displayMode` fields throughout the codebase, and to clarify the scope).\n   */\n  parentDisplay: z.enum(ParentDisplay).optional(),\n}).strict();\nexport type RelationshipDisplayInChildView = z.infer<typeof RelationshipDisplayInChildViewSchema>;\n\n\n// ════════════════════════════════════════════════════════════════\n// RelationshipDisplayInteraction\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Narrow frontend interaction hints for relationship surfaces.\n *\n * These settings are intentionally NOT part of the shared relationship meaning:\n * - they do not change `RelationshipNature`\n * - they do not change backend mutation/lifecycle semantics\n * - they only influence how the frontend may orchestrate an interaction\n *\n * Important distinction:\n * - `COMPOSITION` already owns aggregate/nested creation semantics\n * - `REFERENCE` may optionally offer \"create related resource, then set reference\"\n * - `ASSOCIATION` may optionally offer \"create peer resource, then link/replace\"\n *\n * So \"quick create\" is a workflow capability layered on top of relationship\n * semantics, not a fourth relationship nature.\n */\nexport const RelationshipDisplayInteractionSchema = z.object({\n  /**\n   * Whether the frontend may offer a \"quick create\" affordance on top of the\n   * relationship surface.\n   *\n   * Semantic meaning by relationship nature:\n   * - `REFERENCE`: create an independent related resource, then complete the\n   *   reference action (`set` / future selector confirmation). The parent does\n   *   not aggregate-manage the child.\n   * - `ASSOCIATION`: create an independent peer resource, then complete the\n   *   association action (`link` / `replace`). The parent manages membership,\n   *   not the peer lifecycle.\n   * - `COMPOSITION`: this hint is generally redundant and should normally be\n   *   ignored, because composition already owns native nested creation through\n   *   aggregate semantics.\n   *\n   * Framework policy:\n   * - Missing value means ENABLED.\n   * - Consumers should treat `undefined` as `true`.\n   * - Disabling this only removes the shortcut affordance; it does not change\n   *   what the relationship means.\n   *\n   * Why default `true`:\n   * - for `REFERENCE`, \"create then set\" is usually a useful workflow shortcut\n   * - for `ASSOCIATION`, \"create then link\" is usually a useful workflow shortcut\n   * - the semantic distinction still stays visible in the follow-up action\n   */\n  allowQuickCreate: z.boolean().optional(),\n}).strict();\nexport type RelationshipDisplayInteraction = z.infer<typeof RelationshipDisplayInteractionSchema>;\n\n\n// ════════════════════════════════════════════════════════════════\n// RelationshipDisplayConfig — Combined\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Combined frontend relationship presentation configuration.\n * Passed as the `display` option in `createResourcesRelationship()`.\n */\nexport const RelationshipDisplayConfigSchema = z.object({\n  /** How parent-owned navigation to those children is orchestrated. */\n  inParentNavigation: RelationshipDisplayInParentNavigationSchema.optional(),\n  /** How the parent reference appears in the child's detail view. */\n  inChildView: RelationshipDisplayInChildViewSchema.optional(),\n  /**\n   * Narrow interaction/workflow hints for frontend relationship surfaces.\n   *\n   * This is where UI capabilities such as `allowQuickCreate` belong. Keep these\n   * hints separate from `RelationshipNature` so frontend shortcuts do not blur\n   * backend/shared semantics.\n   */\n  interaction: RelationshipDisplayInteractionSchema.optional(),\n}).strict();\nexport type RelationshipDisplayConfig = z.infer<typeof RelationshipDisplayConfigSchema>;\n"]}

package/dist/esm/resources/resources-config.shared.factory.d.ts

@@ -3,18 +3,41 @@
  *
  * Reusable operation schemas for bulk actions and common operations
  */
-import { EnumLikeType } from '@wildo-ai/zod-decorators';
+import { EnumLikeType, PrimitiveZodType } from '@wildo-ai/zod-decorators';
 import { z } from 'zod';
-import { type AnyResourceConfiguration, ResourceConfiguration, ResourceConfiguration_BuilderParameters } from './resources-config.shared.schemas.js';
-import { CoreResourceOperation, ResourceType } from './resources.shared.core.definitions.js';
-import { ResourceRelationship } from './resources.shared.schemas.js';
+import { type AnyResourceConfiguration, ResourceConfiguration, ResourceConfiguration_BuilderParameters, ResourceSearchQueryRequestResult } from './resources-config.shared.schemas';
+import { CoreResourceOperation, ResourceType } from './resources.shared.core.definitions';
+import { ResourceRelationship } from './resources.shared.schemas';
 export declare function reconcileGeneratedRelationshipBulkOperations(resourceConfigurations: Record<string, AnyResourceConfiguration>, allResourceRelationships: ResourceRelationship[], allResourceFieldIdentifiers: Partial<Record<ResourceType, string>> | Record<string, string>): void;
+/**
+ * Build a CREATE request DTO from the main schema using decorators.
+ *
+ * Excludes:
+ * - System-managed fields (_id, createdAt, updatedAt, etc.)
+ * - Virtual fields (computed, not stored)
+ * - Fields with excludeFromCreate decorator
+ *
+ * NOTE: Backend-only fields (isBackendOnly) are NOT excluded from CREATE DTOs.
+ * The isBackendOnly decorator controls RESPONSE filtering (what is returned to clients),
+ * not REQUEST filtering (what can be set during creation). Backend operations need to
+ * set fields like passwordHash, apiKey, etc. directly during resource creation.
+ *
+ * @param mainSchema - The main resource schema
+ * @param customExclusions - Additional fields to exclude
+ * @returns A new schema with only creatable fields
+ */
+export declare function buildCreateRequestDto<T extends z.ZodTypeAny>(mainSchema: T, customExclusions?: string[]): z.ZodTypeAny;
 /**
  * Derives the appropriate request DTO based on operation type.
  *
  * - CREATE: Uses buildCreateRequestDto (excludes excludeFromCreate fields)
  * - UPDATE: Uses buildUpdateRequestDto (excludes excludeFromUpdate fields, all partial)
- * - Other operations: Returns mainSchema as-is
+ * - READ/DELETE and custom operations without an explicit DTO: empty object
+ *
+ * This is an early factory placeholder. The final DTO pass in
+ * ResourcesConfigOperationsDtosBuilderUtils applies inherited schemas, the
+ * shared no-body operation policy, and SEARCH query schemas derived from
+ * collection-view metadata.
  *
  * @param operation - The operation identifier
  * @param mainSchema - The main resource schema
@@ -22,6 +45,38 @@ export declare function reconcileGeneratedRelationshipBulkOperations(resourceCon
  * @returns The appropriate request DTO schema
  */
 export declare function deriveRequestDto<T extends z.ZodTypeAny>(operation: string, mainSchema: T, providedDto?: z.ZodTypeAny): z.ZodTypeAny;
+/**
+ * The ONE authority for the `{ pagination, sorting, filters }` argument envelope every
+ * collection-shaped operation accepts.
+ *
+ * Exported rather than factory-private because a second surface needs the identical shape: the MCP
+ * tool adapter advertises this envelope for collection tools whose `requestDto` is empty. A LIST
+ * operation keeps `requestDto: z.object({})` — its filters travel in the QUERY STRING over HTTP, so
+ * giving it a request BODY would misdescribe the REST contract and the generated OpenAPI — yet the
+ * MCP dispatch normalises the very same envelope for it. Advertising had to be fixed without
+ * touching the DTO, and that means this builder is reachable from both places.
+ *
+ * Deriving the shape a second time in the adapter was the rejected alternative: a filter allow-list
+ * that drifts between the surface that ADVERTISES it and the surface that ENFORCES it is precisely
+ * the defect class this envelope already caused once.
+ */
+export declare function createResourceSearchQueryRequestSchema<TFilterFields extends Record<string, PrimitiveZodType> | undefined, TSortFields extends readonly string[] | undefined>(params: {
+    filterFields: TFilterFields;
+    allowedSortFields: TSortFields;
+    pagination: boolean;
+    /**
+     * The operation's declared page ceiling, mirrored onto the REQUEST side.
+     *
+     * Without it the request DTO refuses any `pagination.limit` above a hard-coded 100 while the
+     * repository and the response DTO both honour the declared value — so an operation declaring 200
+     * advertises a limit it answers **400** to. Found 2026-08-12 by an e2e probe asking `users SEARCH`
+     * (declared 200) for 120: `pagination.limit: Too big: expected number to be <=100`.
+     *
+     * Defaults to 100 — the bound this schema has always enforced — so an un-migrated caller keeps
+     * exactly its current contract.
+     */
+    maxPaginatedResultPerPageLimit?: number;
+}): ResourceSearchQueryRequestResult<TFilterFields, TSortFields>;
 /**
  * Creates a resource configuration from builder parameters.
  * NOTE: TDatabaseSchema has been removed. Backend-only fields are now marked with

package/dist/esm/resources/resources-config.shared.factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resources-config.shared.factory.d.ts","sourceRoot":"","sources":["../../../src/resources/resources-config.shared.factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,YAAY,EAYb,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,EAEL,KAAK,wBAAwB,EAQ7B,qBAAqB,EAErB,uCAAuC,EAMxC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAwD,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAChJ,OAAO,EAQL,oBAAoB,EAarB,MAAM,4BAA4B,CAAC;AA6HpC,wBAAgB,4CAA4C,CAC1D,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,EAChE,wBAAwB,EAAE,oBAAoB,EAAE,EAChD,2BAA2B,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1F,IAAI,CA0BN;AAsPD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EACrD,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,CAAC,EACb,WAAW,CAAC,EAAE,CAAC,CAAC,UAAU,GACzB,CAAC,CAAC,UAAU,CAqBd;AA6zBD;;;;GAIG;AACH,wBAAgB,0CAA0C,CACxD,oBAAoB,SAAS,YAAY,GAAG,SAAS,EACrD,kBAAkB,SAAS,OAAO,CAAC,qBAAqB,CAAC,GAAG,SAAS,EACrE,WAAW,SAAS,CAAC,CAAC,UAAU,EAChC,MAAM,EAAE,uCAAuC,CAC/C,oBAAoB,EAAE,kBAAkB,EAAE,WAAW,CACtD,GAAG,qBAAqB,CAAC,oBAAoB,EAAE,kBAAkB,EAAE,WAAW,CAAC,CAsuB/E"}
+{"version":3,"file":"resources-config.shared.factory.d.ts","sourceRoot":"","sources":["../../../../src/resources/resources-config.shared.factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,YAAY,EAEZ,gBAAgB,EAoBjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2CxB,OAAO,EAEL,KAAK,wBAAwB,EAU7B,qBAAqB,EAKrB,uCAAuC,EAKvC,gCAAgC,EAOjC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAwD,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAChJ,OAAO,EAUL,oBAAoB,EAarB,MAAM,4BAA4B,CAAC;AA4OpC,wBAAgB,4CAA4C,CAC1D,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,EAChE,wBAAwB,EAAE,oBAAoB,EAAE,EAChD,2BAA2B,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1F,IAAI,CA0BN;AAkXD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAC1D,UAAU,EAAE,CAAC,EACb,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAC1B,CAAC,CAAC,UAAU,CA4Cd;AA6ED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EACrD,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,CAAC,EACb,WAAW,CAAC,EAAE,CAAC,CAAC,UAAU,GACzB,CAAC,CAAC,UAAU,CAqBd;AA4sBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sCAAsC,CACpD,aAAa,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,SAAS,EAClE,WAAW,SAAS,SAAS,MAAM,EAAE,GAAG,SAAS,EACjD,MAAM,EAAE;IACR,YAAY,EAAE,aAAa,CAAC;IAC5B,iBAAiB,EAAE,WAAW,CAAC;IAC/B,UAAU,EAAE,OAAO,CAAC;IACpB;;;;;;;;;;OAUG;IACH,8BAA8B,CAAC,EAAE,MAAM,CAAC;CACzC,GAAG,gCAAgC,CAAC,aAAa,EAAE,WAAW,CAAC,CAuF/D;AA4GD;;;;GAIG;AACH,wBAAgB,0CAA0C,CACxD,oBAAoB,SAAS,YAAY,GAAG,SAAS,EACrD,kBAAkB,SAAS,OAAO,CAAC,qBAAqB,CAAC,GAAG,SAAS,EACrE,WAAW,SAAS,CAAC,CAAC,UAAU,EAChC,MAAM,EAAE,uCAAuC,CAC/C,oBAAoB,EAAE,kBAAkB,EAAE,WAAW,CACtD,GAAG,qBAAqB,CAAC,oBAAoB,EAAE,kBAAkB,EAAE,WAAW,CAAC,CAo3D/E"}