@wildo-ai/zod-decorators 1.0.1 → 1.1.0

package/dist/esm/zod-decorators.types.js

@@ -1,5 +1,15 @@
-// Symbol for storing metadata on Zod schemas. Uses Symbol.for() to ensure the same symbol is used across packages.
+/**
+ * @wildo_source:part:start zod.decorators.schema-metadata
+ *
+ * Internal metadata key used by Wildo's schema decorators.
+ *
+ * Application schemas obtain this metadata by using the supported decorators
+ * and schema factories from `@wildo-ai/zod-decorators`; application code must
+ * not write this symbol directly. `Symbol.for()` keeps independently loaded
+ * package copies interoperable while the framework reads the schema contract.
+ */
 export const SCHEMA_METADATA = Symbol.for('schema_metadata');
+/** @wildo_source:part:end zod.decorators.schema-metadata */
 // Schema type categories for component selection.
 // Represents the underlying Zod schema type detected from introspection.
 export var FieldSchemaType;
@@ -62,6 +72,86 @@ export var FormFieldComponent;
     FormFieldComponent["PHONE"] = "phone";
 })(FormFieldComponent || (FormFieldComponent = {}));
 // ================================
+// HTML AUTOCOMPLETE TOKENS
+// ================================
+/**
+ * Official HTML autocomplete field identifiers.
+ * Excludes `section-*`, `on`, and `off` because the decorator contract here is
+ * focused on typed semantic field tokens rather than raw form-level switches.
+ */
+export var AutocompleteFieldIdentifier;
+(function (AutocompleteFieldIdentifier) {
+    AutocompleteFieldIdentifier["NAME"] = "name";
+    AutocompleteFieldIdentifier["HONORIFIC_PREFIX"] = "honorific-prefix";
+    AutocompleteFieldIdentifier["GIVEN_NAME"] = "given-name";
+    AutocompleteFieldIdentifier["ADDITIONAL_NAME"] = "additional-name";
+    AutocompleteFieldIdentifier["FAMILY_NAME"] = "family-name";
+    AutocompleteFieldIdentifier["HONORIFIC_SUFFIX"] = "honorific-suffix";
+    AutocompleteFieldIdentifier["NICKNAME"] = "nickname";
+    AutocompleteFieldIdentifier["USERNAME"] = "username";
+    AutocompleteFieldIdentifier["NEW_PASSWORD"] = "new-password";
+    AutocompleteFieldIdentifier["CURRENT_PASSWORD"] = "current-password";
+    AutocompleteFieldIdentifier["ONE_TIME_CODE"] = "one-time-code";
+    AutocompleteFieldIdentifier["ORGANIZATION_TITLE"] = "organization-title";
+    AutocompleteFieldIdentifier["ORGANIZATION"] = "organization";
+    AutocompleteFieldIdentifier["STREET_ADDRESS"] = "street-address";
+    AutocompleteFieldIdentifier["ADDRESS_LINE_1"] = "address-line1";
+    AutocompleteFieldIdentifier["ADDRESS_LINE_2"] = "address-line2";
+    AutocompleteFieldIdentifier["ADDRESS_LINE_3"] = "address-line3";
+    AutocompleteFieldIdentifier["ADDRESS_LEVEL_4"] = "address-level4";
+    AutocompleteFieldIdentifier["ADDRESS_LEVEL_3"] = "address-level3";
+    AutocompleteFieldIdentifier["ADDRESS_LEVEL_2"] = "address-level2";
+    AutocompleteFieldIdentifier["ADDRESS_LEVEL_1"] = "address-level1";
+    AutocompleteFieldIdentifier["COUNTRY"] = "country";
+    AutocompleteFieldIdentifier["COUNTRY_NAME"] = "country-name";
+    AutocompleteFieldIdentifier["POSTAL_CODE"] = "postal-code";
+    AutocompleteFieldIdentifier["CC_NAME"] = "cc-name";
+    AutocompleteFieldIdentifier["CC_GIVEN_NAME"] = "cc-given-name";
+    AutocompleteFieldIdentifier["CC_ADDITIONAL_NAME"] = "cc-additional-name";
+    AutocompleteFieldIdentifier["CC_FAMILY_NAME"] = "cc-family-name";
+    AutocompleteFieldIdentifier["CC_NUMBER"] = "cc-number";
+    AutocompleteFieldIdentifier["CC_EXP"] = "cc-exp";
+    AutocompleteFieldIdentifier["CC_EXP_MONTH"] = "cc-exp-month";
+    AutocompleteFieldIdentifier["CC_EXP_YEAR"] = "cc-exp-year";
+    AutocompleteFieldIdentifier["CC_CSC"] = "cc-csc";
+    AutocompleteFieldIdentifier["CC_TYPE"] = "cc-type";
+    AutocompleteFieldIdentifier["TRANSACTION_CURRENCY"] = "transaction-currency";
+    AutocompleteFieldIdentifier["TRANSACTION_AMOUNT"] = "transaction-amount";
+    AutocompleteFieldIdentifier["LANGUAGE"] = "language";
+    AutocompleteFieldIdentifier["BDAY"] = "bday";
+    AutocompleteFieldIdentifier["BDAY_DAY"] = "bday-day";
+    AutocompleteFieldIdentifier["BDAY_MONTH"] = "bday-month";
+    AutocompleteFieldIdentifier["BDAY_YEAR"] = "bday-year";
+    AutocompleteFieldIdentifier["SEX"] = "sex";
+    AutocompleteFieldIdentifier["URL"] = "url";
+    AutocompleteFieldIdentifier["PHOTO"] = "photo";
+    AutocompleteFieldIdentifier["TEL"] = "tel";
+    AutocompleteFieldIdentifier["TEL_COUNTRY_CODE"] = "tel-country-code";
+    AutocompleteFieldIdentifier["TEL_NATIONAL"] = "tel-national";
+    AutocompleteFieldIdentifier["TEL_AREA_CODE"] = "tel-area-code";
+    AutocompleteFieldIdentifier["TEL_LOCAL"] = "tel-local";
+    AutocompleteFieldIdentifier["TEL_LOCAL_PREFIX"] = "tel-local-prefix";
+    AutocompleteFieldIdentifier["TEL_LOCAL_SUFFIX"] = "tel-local-suffix";
+    AutocompleteFieldIdentifier["TEL_EXTENSION"] = "tel-extension";
+    AutocompleteFieldIdentifier["EMAIL"] = "email";
+    AutocompleteFieldIdentifier["IMPP"] = "impp";
+})(AutocompleteFieldIdentifier || (AutocompleteFieldIdentifier = {}));
+/**
+ * Official non-`section-*` HTML autocomplete modifiers.
+ * Rendering code is responsible for placing them in spec order.
+ */
+export var AutocompleteModifier;
+(function (AutocompleteModifier) {
+    AutocompleteModifier["SHIPPING"] = "shipping";
+    AutocompleteModifier["BILLING"] = "billing";
+    AutocompleteModifier["HOME"] = "home";
+    AutocompleteModifier["WORK"] = "work";
+    AutocompleteModifier["MOBILE"] = "mobile";
+    AutocompleteModifier["FAX"] = "fax";
+    AutocompleteModifier["PAGER"] = "pager";
+    AutocompleteModifier["WEBAUTHN"] = "webauthn";
+})(AutocompleteModifier || (AutocompleteModifier = {}));
+// ================================
 // FORM FIELD CHROME MODES
 // ================================
 //------------------------------------------------------------------------------------------------
@@ -74,6 +164,13 @@ export var FormFieldComponent;
 export const DisplayChromeMode = {
     /** Label above, value below, description below value (default). */
     STACKED: 'stacked',
+    /**
+     * Label + description inline-start, value inline-end (settings page style).
+     * The read-mode counterpart of `EditChromeMode.SETTINGS_ROW` — pairing the two
+     * keeps a view→edit drill (e.g. inside the Settings Hub) visually coherent: the
+     * value sits where its control will appear.
+     */
+    SETTINGS_ROW: 'settings_row',
     /** Label and value on the same line. */
     INLINE: 'inline',
     /** No label/description, just value (dense mode). */
@@ -84,8 +181,6 @@ export const DisplayChromeMode = {
 /**
  * Chrome layout mode for edit context (forms).
  * Superset of DisplayChromeMode with form-specific modes (SETTINGS_ROW, RELAXED).
- *
- * Also exported as `FormFieldChromeMode` for backward compatibility.
  */
 export const EditChromeMode = {
     /** Label above, control below, description + error below control (default). */
@@ -101,8 +196,6 @@ export const EditChromeMode = {
     /** No chrome at all — bare control output. */
     HIDDEN: 'hidden',
 };
-/** @deprecated Use `EditChromeMode` directly. Kept as alias for backward compatibility. */
-export const FormFieldChromeMode = EditChromeMode;
 ///=======================================================================================================================
 /// DISPLAY FIELD COMPONENT TYPES
 ///=======================================================================================================================
@@ -253,6 +346,22 @@ export var HorizontalAlign;
     HorizontalAlign["END"] = "end";
 })(HorizontalAlign || (HorizontalAlign = {}));
 //------------------------------------------------------------------------------------------------
+/**
+ * @wildo_source:part:start zod.decorators.display-edit-modes facet:layer:frontend facet:family:ui facet:surface:form facet:surface:display
+ *
+ * Frontend UI vocabulary for choosing how a field renders and edits.
+ *
+ * These values are not the persisted resource semantics themselves. They are
+ * consumed by the frontend resource UI behavior layer, typically in
+ * files like `frontend/src/modules/<module>/resources/<resource>/<resource>.ui-behavior.tsx`, where the AI
+ * calls decorators like `.stringUI()`, `.enumUI()`, `.booleanUI()`, etc. on the
+ * schema shape exposed to `resourceUIBehavior(...)`.
+ *
+ * Keep these mode enums in the framework source as the canonical list of
+ * supported display/edit behaviors. Authoring skills and generated knowledge
+ * should reference these definitions instead of copying literal mode tables
+ * into markdown by hand.
+ */
 // BOOLEAN DISPLAY POLICY
 //------------------------------------------------------------------------------------------------
 /**
@@ -292,6 +401,16 @@ export const StringDisplayMode = {
     TEXT: 'text',
     TRUNCATE: 'truncate',
     MULTILINE: 'multiline',
+    /**
+     * Render the value as rich markdown (GFM: headings, lists, tables, links,
+     * task lists, fenced code). For long-form authored content — descriptions,
+     * notes, documentation fields. Headings are demoted for embedded context
+     * (a `#` inside a field body never competes with the page title) and every
+     * element is styled through the active theme's typography recipes. Pair
+     * with `edit.editMode: MARKDOWN` (syntax-tinted source editor) — or plain
+     * `TEXTAREA` — the edit side stays markdown SOURCE either way.
+     */
+    MARKDOWN: 'markdown',
     COLOR: 'color',
     LINK: 'link',
     EMAIL: 'email',
@@ -308,6 +427,14 @@ export const StringEditMode = {
     COLOR: 'color',
     PASSWORD: 'password',
     OTP: 'otp',
+    /**
+     * Markdown SOURCE editor (CodeMirror-backed, syntax-tinted, theme-token
+     * styled). The stored value stays plain markdown source — display-side
+     * rendering remains owned by `StringDisplayMode.MARKDOWN` (Streamdown).
+     * This is deliberately NOT a WYSIWYG mode; a rich visual editor is a
+     * separate future edit mode/component.
+     */
+    MARKDOWN: 'markdown',
 };
 //------------------------------------------------------------------------------------------------
 // NUMBER DISPLAY POLICY
@@ -359,10 +486,13 @@ export const BigDecimalDisplayMode = {
 export const BigDecimalEditMode = {
     INPUT: 'input',
 };
+/** @wildo_source:part:end zod.decorators.display-edit-modes */
 //------------------------------------------------------------------------------------------------
 // ENUM DISPLAY POLICY
 //------------------------------------------------------------------------------------------------
 /**
+ * @wildo_source:part:start zod.decorators.enums.frontend-handling facet:layer:frontend facet:layer:shared facet:family:enum facet:family:ui facet:surface:form facet:surface:display
+ *
  * Enum display modes for rendering enum values
  */
 export const EnumDisplayMode = {
@@ -408,19 +538,75 @@ export const BadgeSemanticVariant = {
 // FOREIGN KEY DISPLAY PARAMS
 //------------------------------------------------------------------------------------------------
 /**
- * Foreign key display mode options
- * - ID: Show raw FK ID value
- * - LABEL: Show resolved label via getFrontendResourceLabel
- * - SUMMARY: Show the referenced resource's summary view (compact card) (default)
+ * @wildo_source:part:start zod.decorators.foreign-key-display-mode facet:layer:frontend facet:family:ui facet:surface:display facet:surface:picker
  *
- * Note: "summary" here is about *FK rendering*, not API data shape (see DataMode.SUMMARY)
- * or operation bar density (see ResourceOperationDisplayMode.SUMMARY).
+ * Foreign-key reference display vocabulary — how a foreign-key field renders, both
+ * as a stored VALUE in read views and as each ROW in the reference picker's
+ * dropdown (the picker is shared by forms and collection filters). Authored via
+ * `.foreignKeyUI(...)` from `@wildo-ai/zod-decorators` on the FK field:
+ * - `display.mode` — how the saved FK value renders in a read view.
+ * - `edit.optionDisplayMode` — how each picker dropdown ROW renders while selecting.
+ *
+ * Modes:
+ * - `ID`: the raw FK id string. As a picker row this is treated as `LABEL`.
+ * - `LABEL`: a one-line resolved label via `getFrontendResourceLabel`. The default on
+ *   BOTH surfaces — see {@link DEFAULT_FOREIGN_KEY_DISPLAY_MODE} and
+ *   {@link DEFAULT_FOREIGN_KEY_OPTION_DISPLAY_MODE}.
+ * - `SUMMARY`: the referenced resource's summary view — its summary fields with NO
+ *   action bar (a compact card). Always an opt-in, on both surfaces.
+ *
+ * "summary" here is about FK RENDERING, not API data shape (`DataMode.SUMMARY`) or
+ * operation-bar density (`ResourceOperationDisplayMode.SUMMARY`).
+ *
+ * @example
+ * // Make the picker dropdown rows show the referenced resource's summary card:
+ * assigneeUserId: z.string().isForeignKey().foreignKeyUI({
+ *   edit: { optionDisplayMode: ForeignKeyDisplayMode.SUMMARY },
+ * })
  */
 export const ForeignKeyDisplayMode = {
     ID: 'id',
     LABEL: 'label',
     SUMMARY: 'summary',
 };
+/**
+ * The mode an FK's stored VALUE renders in when the field authors no
+ * `.foreignKeyUI({ display: { mode } })`.
+ *
+ * **This is the single source for that default.** Every site that has to supply a
+ * fallback display mode derives from this constant rather than restating a member of
+ * {@link ForeignKeyDisplayMode}. It exists because the default was previously declared
+ * twice and the two declarations DISAGREED — the metadata reader said `LABEL`, the
+ * display preset said `SUMMARY` — so the answer an app author got depended on which
+ * resolution path happened to run, and the prose above this enum documented the losing
+ * one.
+ *
+ * `LABEL` is the default because it is the cheap, composable rendering: one resolved
+ * line that fits a table cell, a detail row and a dense list alike. `SUMMARY` renders a
+ * card of the referenced record's summary fields — appropriate when the parent's
+ * details matter AT the point of reference, which is a per-field authoring judgement,
+ * not something a framework can assume for every FK in an application.
+ *
+ * @example
+ * // Opt a single field into the card rendering:
+ * todoListId: z.string().isForeignKey().foreignKeyUI({
+ *   display: { mode: ForeignKeyDisplayMode.SUMMARY },
+ * })
+ */
+export const DEFAULT_FOREIGN_KEY_DISPLAY_MODE = ForeignKeyDisplayMode.LABEL;
+/**
+ * The mode each ROW of the reference picker's dropdown renders in when the field
+ * authors no `.foreignKeyUI({ edit: { optionDisplayMode } })`.
+ *
+ * **This is the single source for that default**, and it is deliberately a SEPARATE
+ * constant from {@link DEFAULT_FOREIGN_KEY_DISPLAY_MODE}. The two answer different
+ * questions — "how does a stored reference read?" versus "how does a candidate read
+ * while I am choosing one?" — and a framework that collapsed them would make one
+ * surface's default un-tunable without moving the other. They currently coincide on
+ * `LABEL`; that agreement is a fact about today's values, not a shared identity.
+ */
+export const DEFAULT_FOREIGN_KEY_OPTION_DISPLAY_MODE = ForeignKeyDisplayMode.LABEL;
+/** @wildo_source:part:end zod.decorators.shared-structural-params */
 //------------------------------------------------------------------------------------------------
 // RANGE SCHEMA TYPES
 //------------------------------------------------------------------------------------------------
@@ -568,6 +754,80 @@ export var FileDisplayNature;
     FileDisplayNature["DOCUMENT"] = "document";
     FileDisplayNature["GENERIC"] = "generic";
 })(FileDisplayNature || (FileDisplayNature = {}));
+/**
+ * Frame shape for an inline media (image) preview — see `FileUIDisplayParams.preview`.
+ * - `ROUNDED` (default): rounded-corner rectangle, aspect preserved (`object-contain`).
+ * - `SQUARE`: sharp-corner rectangle, aspect preserved.
+ * - `CIRCLE`: circular frame; the image is cropped to fill (`object-cover`). Typical
+ *   for avatars / profile pictures.
+ */
+export var FileMediaShape;
+(function (FileMediaShape) {
+    FileMediaShape["ROUNDED"] = "rounded";
+    FileMediaShape["SQUARE"] = "square";
+    FileMediaShape["CIRCLE"] = "circle";
+})(FileMediaShape || (FileMediaShape = {}));
+/**
+ * Rendered size tier for an inline media (image) preview — see
+ * `FileUIDisplayParams.preview`. `XS`–`XL` are fixed dimensions (a `CIRCLE` uses the
+ * value as its diameter; a rectangle uses it as the max width). `FULL` fills the
+ * available column width (the default, container-responsive) — best for cover images,
+ * not avatars.
+ */
+export var FileMediaSize;
+(function (FileMediaSize) {
+    FileMediaSize["XS"] = "xs";
+    FileMediaSize["SM"] = "sm";
+    FileMediaSize["MD"] = "md";
+    FileMediaSize["LG"] = "lg";
+    FileMediaSize["XL"] = "xl";
+    FileMediaSize["FULL"] = "full";
+})(FileMediaSize || (FileMediaSize = {}));
+/**
+ * How a file field renders AT REST, before any interaction — one of the two
+ * orthogonal axes of the file display policy (the other is
+ * {@link FileActivationPolicy}, what a click does).
+ *
+ * - `CARD` (default): the neutral file card — icon + filename + size. Compact and
+ *   nature-agnostic, so a detail view holding several documents stays scannable.
+ * - `THUMBNAIL`: a small rendered preview of the media beside the title (an image
+ *   thumbnail, a PDF's rasterised first page). Informative but still compact.
+ * - `FULL`: the media rendered inline at full width — an image, a video player, a
+ *   paginated PDF viewer. The heaviest option: for documents it downloads and mounts
+ *   the viewer on first paint, so prefer `CARD` + an `OVERLAY` activation unless the
+ *   document IS the page.
+ *
+ * `THUMBNAIL` and `FULL` require a displayer for the file's resolved nature; a
+ * request the nature cannot satisfy is refused at registry build (narrow declared
+ * nature) or degraded to `CARD` at runtime (open nature) — never a broken render.
+ */
+export var FileDisplayPresentation;
+(function (FileDisplayPresentation) {
+    FileDisplayPresentation["CARD"] = "card";
+    FileDisplayPresentation["THUMBNAIL"] = "thumbnail";
+    FileDisplayPresentation["FULL"] = "full";
+})(FileDisplayPresentation || (FileDisplayPresentation = {}));
+/**
+ * What activating (clicking / Enter) a displayed file does — the second axis of the
+ * file display policy. Applies to EVERY file nature, not just images.
+ *
+ * - `NONE`: inert. No cursor affordance, no handler, not focusable as a control.
+ * - `OVERLAY`: open the nature's displayer in an overlay (the generalisation of the
+ *   old image-only lightbox). Requires a displayer for the resolved nature.
+ * - `DOWNLOAD`: fetch the bytes over the authenticated serve route and save them.
+ * - `NEW_TAB`: open the authenticated serve URL in a new tab (the browser's own
+ *   viewer, with its native print/save affordances).
+ * - `CUSTOM`: run an operation declared on the resource that OWNS this file field —
+ *   see {@link FileActivationConfig}.
+ */
+export var FileActivationPolicy;
+(function (FileActivationPolicy) {
+    FileActivationPolicy["NONE"] = "none";
+    FileActivationPolicy["OVERLAY"] = "overlay";
+    FileActivationPolicy["DOWNLOAD"] = "download";
+    FileActivationPolicy["NEW_TAB"] = "new_tab";
+    FileActivationPolicy["CUSTOM"] = "custom";
+})(FileActivationPolicy || (FileActivationPolicy = {}));
 /**
  * Storage providers accepted for file uploads.
  */
@@ -583,8 +843,13 @@ export var FileUploaderEntityType;
 (function (FileUploaderEntityType) {
     FileUploaderEntityType["USER"] = "user";
     FileUploaderEntityType["ANONYMOUS_USER"] = "anonymous_user";
-    FileUploaderEntityType["ORGANIZATION_API_KEY"] = "organization_api_key";
-    FileUploaderEntityType["APPLICATION_API_KEY"] = "application_api_key";
+    // Machine (non-human) uploaders. The value is the PRINCIPAL kind (org/app machine), NOT the
+    // credential kind — an api-key AND an OAuth client both authenticate the same machine principal,
+    // and the specific credential (api-key vs OAuth client) + its id are recorded on
+    // `initiatorIds.machineCredential` (authMethod + credentialId). Keeping this enum principal-keyed
+    // (matching USER / ANONYMOUS_USER) avoids mislabelling an OAuth-client upload as an "api key".
+    FileUploaderEntityType["ORGANIZATION_MACHINE"] = "organization_machine";
+    FileUploaderEntityType["APPLICATION_MACHINE"] = "application_machine";
 })(FileUploaderEntityType || (FileUploaderEntityType = {}));
 /**
  * Image format options for file validation.
@@ -614,14 +879,53 @@ export const AudioFormat = {
     AAC: 'aac',
 };
 /**
- * RAG chunking strategy options for file content indexing.
+ * @wildo_source:part:start zod.decorators.rag-source facet:layer:shared facet:family:decorator facet:family:param-surface facet:kind:api facet:audience:app-developer
+ *
+ * How a RAG-source field's text is split into retrieval chunks.
+ *
+ * Import from `@wildo-ai/zod-decorators`. Every member is a chunking STRATEGY — pick the one that
+ * matches the field's real content shape, because chunk boundaries decide what a retrieval hit can
+ * quote: a heading-aware split over markdown returns a coherent section, while a fixed-size split
+ * over the same text returns whatever fell inside the window.
+ *
+ * **This is the single named home for the chunking vocabulary** (semantic-string-literals rule).
+ * It lives in `zod-decorators` — not `saas-models` — because the dependency arrow points the other
+ * way: `saas-models` depends on this package, while the `.ragSource()` decorator params below could
+ * never import a `saas-models` enum. Chunking is authored ON THE FIELD, through `.ragSource()`;
+ * there is no separate agent-level chunking configuration to keep in step with it.
+ *
+ * - `FIXED_SIZE` — split every `chunkSize` characters/tokens regardless of structure.
+ * - `RECURSIVE` — split on a separator hierarchy (paragraph → sentence → word) down to `chunkSize`.
+ * - `SEMANTIC` — split at embedding-detected topic boundaries.
+ * - `MARKDOWN` — split on markdown structure (headings, lists, code fences).
+ * - `CODE` — split on source-code structure (functions, classes, blocks). Unified in (2026-08-26)
+ *   from a second copy of this vocabulary that `saas-models` then carried: the member sets differed
+ *   only by this entry, and shrinking the vocabulary to fit the field decorator would have silently
+ *   invalidated configurations authored against the wider one — so the union won. That second copy,
+ *   and the agent-level RAG configuration schemas around it, were retired on 2026-08-27 as a
+ *   pre-capability design the shipped capability superseded; this object is now the only home.
  */
 export const RAGChunkingStrategy = {
     FIXED_SIZE: 'fixed_size',
     RECURSIVE: 'recursive',
     SEMANTIC: 'semantic',
     MARKDOWN: 'markdown',
+    CODE: 'code',
 };
+/** @wildo_source:part:end zod.decorators.rag-source */
+/**
+ * @wildo_source:part:start zod.decorators.file-generation facet:layer:schema facet:family:pdf-templates
+ *
+ * Generation sources supported by `z_file()`.
+ *
+ * Keep this enum in `zod-decorators` instead of `saas-models` so shared schemas
+ * can mark generated files without creating a dependency cycle back into the
+ * resource/model packages that already consume decorators.
+ */
+export var FileGenerationSource;
+(function (FileGenerationSource) {
+    FileGenerationSource["PDF_TEMPLATE"] = "pdfTemplate";
+})(FileGenerationSource || (FileGenerationSource = {}));
 /**
  * File behavior when parent resource is deleted.
  * - CASCADE: Mark the file deleted as part of parent removal; physical storage cleanup is deferred to the cleanup batch
@@ -651,10 +955,13 @@ export const InlineEditSaveOn = {
     /** Save only on explicit button click */
     EXPLICIT: 'explicit',
 };
+/** @wildo_source:part:end zod.decorators.shared-structural-params */
 //------------------------------------------------------------------------------------------------
 // UNIQUE FIELD PARAMS
 //------------------------------------------------------------------------------------------------
 /**
+ * @wildo_source:part:start zod.decorators.shared-structural-params facet:layer:shared facet:family:decorator facet:family:param-surface
+ *
  * Scope for unique constraint enforcement.
  * - 'global': Unique across the entire collection (default)
  * - 'organization': Unique within an organization (compound index with organizationId)
@@ -665,6 +972,7 @@ export const UniqueScope = {
     ORGANIZATION: 'organization',
     USER: 'user',
 };
+/** @wildo_source:part:end zod.decorators.shared-structural-params */
 //------------------------------------------------------------------------------------------------
 // FORM VALIDATION DECORATOR PARAMS
 //------------------------------------------------------------------------------------------------
@@ -695,10 +1003,13 @@ export var AutosaveTrigger;
     AutosaveTrigger["BLUR"] = "blur";
     AutosaveTrigger["NONE"] = "none";
 })(AutosaveTrigger || (AutosaveTrigger = {}));
+/** @wildo_source:part:end zod.decorators.structural-lifecycle-params */
 // ==========================================================================================================================================================
 // SHOW WHEN TYPES (FIX-P5-H1)
 // ==========================================================================================================================================================
 /**
+ * @wildo_source:part:start zod.decorators.conditional-visibility facet:layer:frontend facet:family:form facet:surface:conditional
+ *
  * FIX-P5-H1: Operator for showWhen condition comparison.
  * - EQUALS: Field value equals the specified value
  * - NOT_EQUALS: Field value does not equal the specified value
@@ -716,9 +1027,171 @@ export var ShowWhenOperator;
     ShowWhenOperator["EXISTS"] = "exists";
     ShowWhenOperator["NOT_EXISTS"] = "notExists";
 })(ShowWhenOperator || (ShowWhenOperator = {}));
+/**
+ * How NEW items are added to an array field in an edit / inline-edit surface.
+ *
+ * When unset, the renderer resolves a default by item shape: a SIMPLE item
+ * (a primitive, or an object with a single prominent authored field — e.g. a
+ * checklist `{ label, done }`) defaults to {@link ArrayAddMode.QUICK_ADD}; a
+ * MULTI-field object defaults to {@link ArrayAddMode.APPEND_INLINE}.
+ *
+ * The key distinction is WHEN the new item is validated:
+ * - `APPEND_INLINE` validates AFTER append (a freshly-added required field shows
+ *   its error until filled);
+ * - `QUICK_ADD` / `DIALOG` validate BEFORE append (the list never holds a blank
+ *   or invalid item).
+ */
+export var ArrayAddMode;
+(function (ArrayAddMode) {
+    /**
+     * "+ Add" appends a blank, in-place editable item card/row; validated AFTER
+     * it is added. Best for rich objects the author edits in place.
+     */
+    ArrayAddMode["APPEND_INLINE"] = "append-inline";
+    /**
+     * A single inline add-row (the item's primary field + Enter / "+"). The item
+     * is built from the row and validated BEFORE it is appended, so the list never
+     * holds a blank/invalid item. Best for simple items — checklists.
+     */
+    ArrayAddMode["QUICK_ADD"] = "quick-add";
+    /**
+     * "+ Add" opens a dialog with the item's form; the item is validated on submit
+     * and then appended. Best for complex, multi-field items.
+     */
+    ArrayAddMode["DIALOG"] = "dialog";
+})(ArrayAddMode || (ArrayAddMode = {}));
+/**
+ * How each item of an OBJECT array (`z.array(z.object({...}))`) is framed in
+ * BOTH display and edit surfaces.
+ *
+ * - `CARD` (default) — each item is a framed card (border + padding) with a
+ *   floating summary chip and a stacked column of its sub-fields. Best for
+ *   rich, multi-field items the author edits in place.
+ * - `ROW` — each item is a compact single-row: its sub-fields render inline
+ *   (boolean fields lead as compact toggles — the "☐" of a checklist — then
+ *   the primary field fills the row), reorder/remove controls inline, NO card
+ *   frame or floating chip. Best for lists of small objects — checklists,
+ *   tag/value pairs, key-value rows.
+ *
+ * Applies to object-array items only; primitive arrays already render as rows.
+ */
+export var ArrayObjectItemLayout;
+(function (ArrayObjectItemLayout) {
+    ArrayObjectItemLayout["CARD"] = "card";
+    ArrayObjectItemLayout["ROW"] = "row";
+})(ArrayObjectItemLayout || (ArrayObjectItemLayout = {}));
+/** @wildo_source:part:end zod.decorators.per-primitive-ui */
+//================================================================================================
+// FIELD SPEC — Per-primitive business semantics decorators (companion-only at runtime)
+//================================================================================================
+/**
+ * @wildo_source:part:start zod.decorators.field-spec-params facet:layer:specification facet:family:companion facet:family:semantics
+ *
+ * Semantic specification parameter types for companion/specification overlays.
+ *
+ * These types are intentionally separate from both:
+ * - shared schema structural decorators (`*.schemas.ts`)
+ * - frontend UI decorators (`*.ui-behavior.tsx`)
+ *
+ * `{primitive}Spec()` calls belong in specification-side files such as
+ * `specifications/src/modules/<module>/resources/<resource>.resource.specification.ts`.
+ * They enrich schema fields with business meaning, importance, enum value
+ * semantics, relationship context, and import-oriented symbol references used by
+ * companion-time reasoning and code generation.
+ *
+ * These params should carry meaning that cannot be deterministically inferred
+ * from the Zod type, requiredness, or structural decorators alone.
+ */
+/**
+ * Relative weight of a semantic entry inside its owning resource.
+ *
+ * Not about technical optionality — tells the AI how central a field is
+ * to understanding the resource:
+ * - PRIMARY: core to understanding or using the resource correctly.
+ *   The AI should prioritize these in summaries, forms, and behavior generation.
+ * - CONTEXTUAL: provides useful context but is not central.
+ *   The AI can include or omit based on available space/attention.
+ *
+ * Default is CONTEXTUAL — only genuinely important fields should be explicitly
+ * flagged as PRIMARY.
+ */
+export var FieldSemanticImportance;
+(function (FieldSemanticImportance) {
+    FieldSemanticImportance["PRIMARY"] = "primary";
+    FieldSemanticImportance["CONTEXTUAL"] = "contextual";
+})(FieldSemanticImportance || (FieldSemanticImportance = {}));
+/**
+ * Base field specification parameters shared by all `{primitive}Spec()` decorators.
+ *
+ * Carries the semantic delta that the Zod schema definition alone cannot convey:
+ * domain meaning, business relevance, and guidance for the AI companion.
+ *
+ * These values are **never rendered in the frontend UI** — they exist on the
+ * schema metadata for companion-time extraction only. The `{primitive}Spec()` calls
+ * happen in the specification overlay (which the frontend never imports), so
+ * the prose is attached to schema instances only in companion/test contexts.
+ *
+ * Do not duplicate information already expressed by the schema type, requiredness,
+ * enum values, or structural decorators. This is for meaning that is not derivable.
+ */
+export var CodeSymbolKind;
+(function (CodeSymbolKind) {
+    CodeSymbolKind["SCHEMA"] = "schema";
+    CodeSymbolKind["ENUM"] = "enum";
+    CodeSymbolKind["FACTORY"] = "factory";
+    CodeSymbolKind["FUNCTION"] = "function";
+    CodeSymbolKind["CONFIG"] = "config";
+    CodeSymbolKind["TYPE"] = "type";
+    CodeSymbolKind["COMPONENT"] = "component";
+    CodeSymbolKind["UI_BEHAVIOR"] = "uiBehavior";
+})(CodeSymbolKind || (CodeSymbolKind = {}));
+export var CodeDeclarationKind;
+(function (CodeDeclarationKind) {
+    CodeDeclarationKind["TYPESCRIPT_ENUM"] = "typescriptEnum";
+    CodeDeclarationKind["CONST_OBJECT"] = "constObject";
+    CodeDeclarationKind["ZOD_ENUM"] = "zodEnum";
+    CodeDeclarationKind["LITERAL_UNION"] = "literalUnion";
+    CodeDeclarationKind["ZOD_SCHEMA"] = "zodSchema";
+    CodeDeclarationKind["FUNCTION"] = "function";
+    CodeDeclarationKind["INTERFACE"] = "interface";
+    CodeDeclarationKind["TYPE_ALIAS"] = "typeAlias";
+    CodeDeclarationKind["UNKNOWN"] = "unknown";
+})(CodeDeclarationKind || (CodeDeclarationKind = {}));
+export var CollectionElementKind;
+(function (CollectionElementKind) {
+    CollectionElementKind["PRIMITIVE"] = "primitive";
+    CollectionElementKind["ENUM"] = "enum";
+    CollectionElementKind["FOREIGN_KEY"] = "foreignKey";
+    CollectionElementKind["OBJECT"] = "object";
+    CollectionElementKind["SCHEMA_REF"] = "schemaRef";
+    CollectionElementKind["UNION"] = "union";
+    CollectionElementKind["UNKNOWN"] = "unknown";
+})(CollectionElementKind || (CollectionElementKind = {}));
+export var CodePrimitiveKind;
+(function (CodePrimitiveKind) {
+    CodePrimitiveKind["STRING"] = "string";
+    CodePrimitiveKind["NUMBER"] = "number";
+    CodePrimitiveKind["BOOLEAN"] = "boolean";
+    CodePrimitiveKind["DATE"] = "date";
+    CodePrimitiveKind["DATETIME"] = "datetime";
+    CodePrimitiveKind["TIME"] = "time";
+    CodePrimitiveKind["MONEY"] = "money";
+    CodePrimitiveKind["CODE"] = "code";
+    CodePrimitiveKind["FILE"] = "file";
+    CodePrimitiveKind["DURATION"] = "duration";
+    CodePrimitiveKind["PHONE"] = "phone";
+    CodePrimitiveKind["BIGDECIMAL"] = "bigdecimal";
+    CodePrimitiveKind["UNKNOWN"] = "unknown";
+})(CodePrimitiveKind || (CodePrimitiveKind = {}));
+/** @wildo_source:part:end zod.decorators.field-spec-params */
 // ==========================================================================================================================================================
 // ZOD DECORATOR TYPES
 // ==========================================================================================================================================================
+/**
+ * @wildo_source:part:start zod.decorators.decorator-vocabulary
+ *
+ * Canonical string identifiers for framework Zod field decorators (`ZodDecorator` enum).
+ */
 export var ZodDecorator;
 (function (ZodDecorator) {
     ZodDecorator["IS_DB_INDEXED"] = "isDBIndexed";
@@ -728,6 +1201,136 @@ export var ZodDecorator;
     // New decorators for resource derived objects rationalization
     ZodDecorator["IS_SUMMARY_FIELD"] = "isSummaryField";
     ZodDecorator["IS_BACKEND_ONLY"] = "isBackendOnly";
+    ZodDecorator["IS_WRITE_ONLY_SECRET"] = "isWriteOnlySecret";
+    /**
+     * Impersonalization: per-field erasure-scrub treatment — a `RedactionType` value (string),
+     * read by the saas-models impersonalize writer. NOT the anonymous-user concept.
+     *
+     * Authored fluently: `z.string().nullish().impersonalizeWith(RedactionType.REMOVE)`. The
+     * treatment is REQUIRED and must be a non-empty string — a blank/missing value throws at
+     * decoration time rather than silently leaving the field untreated (an unscrubbed personal
+     * field). `addImpersonalizeWith(schema, treatment)` is the equivalent programmatic escape hatch;
+     * read the treatment back with `getImpersonalizeTreatment(schema)`.
+     *
+     * A `MASK` treatment may carry a field-specific mask value —
+     * `addImpersonalizeWith(schema, RedactionType.MASK, { maskValue: 'erased@erased.invalid' })` —
+     * for a CONSTRAINED string the default mask constant cannot satisfy; read it back with
+     * `getImpersonalizeMaskValue(schema)`. Both authoring doors normalize to
+     * {@link ImpersonalizeFieldParams}, which is what this decorator stores.
+     */
+    ZodDecorator["IMPERSONALIZE_WITH"] = "impersonalizeWith";
+    /**
+     * Portability: where this field's value CAME FROM — a `DataPortabilityProvenance` value (string),
+     * read by the subject-export orchestrator to decide GDPR Art. 20 scope.
+     *
+     * Authored fluently: `z.string().portabilityProvenance(DataPortabilityProvenance.SUBJECT_PROVIDED)`.
+     * The value is REQUIRED and must be a non-empty string — a blank/missing value throws at
+     * decoration time rather than storing an undeclared provenance, which an Art. 20 export treats as
+     * a REFUSAL rather than guessing. `addPortabilityProvenance(schema, provenance)` is the equivalent
+     * programmatic escape hatch; read it back with `getPortabilityProvenance(schema)`.
+     *
+     * A field that carries no declaration inherits its resource's `portabilityPolicy.defaultProvenance`;
+     * only fields differing from that default need this decorator.
+     *
+     * ⚠️ NOT a redaction or scrub concept, and NOT the anonymous-user concept. This says where a value
+     * ORIGINATED, for a DISCLOSURE decision. What happens to a value on ERASURE is
+     * {@link ZodDecorator.IMPERSONALIZE_WITH}, an orthogonal axis — a field is commonly both
+     * `SUBJECT_PROVIDED` and masked on erasure.
+     */
+    ZodDecorator["PORTABILITY_PROVENANCE"] = "portabilityProvenance";
+    /**
+     * Data categories: WHICH KINDS of personal data this field holds — one or more
+     * `PersonalDataCategory` values (strings), read by the compliance fact producer to answer the
+     * privacy-notice question "which categories of personal data do you process".
+     *
+     * Authored fluently: `email: z.email().dataCategories(PersonalDataCategory.CONTACT_DETAILS)`, or
+     * with an array when a field genuinely spans two —
+     * `.dataCategories([PersonalDataCategory.USER_CONTENT, PersonalDataCategory.SPECIAL_CATEGORY_HEALTH])`.
+     * The chokepoint normalizes either form to a deduped array, so every reader sees one shape.
+     * At least one category is REQUIRED and each must be a non-empty string: a blank declaration
+     * would read back as declared-but-meaningless, which is worse than absent, because absence is
+     * what the gap report is looking for. `addDataCategories(schema, categories)` is the equivalent
+     * programmatic escape hatch; read them back with `getDataCategories(schema)`.
+     *
+     * WHETHER each value is a real `PersonalDataCategory` member is checked by the resource factory's
+     * boot guard, which owns the enum — this layer knows only that non-empty strings were declared.
+     *
+     * ⚠️ Four adjacent axes, none of them this one. {@link ZodDecorator.IMPERSONALIZE_WITH} says what
+     * happens to the value on ERASURE; {@link ZodDecorator.PORTABILITY_PROVENANCE} says where it CAME
+     * FROM; `Compliance_DataClassification` is a SENSITIVITY ladder for flows-actors config; a
+     * retention class says HOW LONG it is kept. A single field is routinely all five at once, and
+     * none of the other four can answer "what kind of personal data is this".
+     *
+     * ⚠️ Do NOT declare a category on a field merely because its NAME suggests one. The decorator
+     * exists precisely so categories are never derived from identifiers: `email`, `phone` and
+     * `dateOfBirth` are suggestive while `notes` is not, and an inventory assembled by
+     * pattern-matching names is a guess whose misses are silently undisclosed. `CREDENTIALS` is the
+     * one category the producer derives, and it derives it from `.isPassword()` / `.isOtp()` /
+     * `.isWriteOnlySecret()` — markers the author wrote, not names it read.
+     *
+     * assurance-control: WILDO.PRIVACY.PERSONAL_DATA_INVENTORY — the application declares which
+     * categories of personal data each field holds
+     */
+    ZodDecorator["DATA_CATEGORIES"] = "dataCategories";
+    /**
+     * Audit evidence: this field's BEFORE/AFTER VALUES are recorded when a resource operation
+     * mutates it, on the `resource_operation_performed` audit event.
+     *
+     * Authored fluently: `appRoles: z.array(z.string()).isAuditEvidence()`. A pure marker — no
+     * parameters, no implied decorators. `addAuditEvidence(schema)` is the equivalent programmatic
+     * escape hatch; read it back with `isAuditEvidenceField(schema)`.
+     *
+     * **Mark the fields whose VALUES are the evidence, and only those.** The audit event always
+     * records the NAMES of every changed field (a field name is not personal data). This marker adds
+     * the values, and values are the part that must be justified: audit rows replicate to the per-org
+     * SIEM and to the immutable ledger, and the ledger cannot be scrubbed — so marking a personal-data
+     * field manufactures an unerasable copy of it, defeating the impersonalization/retention
+     * capability. Mark authority (`appRoles`, `roles`), lifecycle state (`status`), and scope-bearing
+     * fields; do NOT mark names, contact details, addresses, free text, or anything a data subject
+     * could ask to have erased.
+     *
+     * ⚠️ This is a WRITE-side claim — "when this field CHANGES, the change itself is evidence" — and
+     * is independent of the READ-side disclosure trail. The only disclosure trigger the framework has
+     * is `isBackendOnly({ isReturnedAtCreation: true })`, which fires one `FIELD_ACCESS` event when a
+     * server-minted secret is first exposed. A field can carry either, both, or neither. There is no
+     * general "audit every read of this field" marker — do not go looking for one.
+     *
+     * assurance-control: WILDO.SECRETS.DISCLOSURE_AUDIT
+     */
+    ZodDecorator["IS_AUDIT_EVIDENCE"] = "isAuditEvidence";
+    /**
+     * RAG source: this field's TEXT is a retrieval-corpus source. The framework chunks the value
+     * (extracting text first for file fields), stores the chunks in the application's OWN datastore
+     * (pgvector on PostgreSQL, `$vectorSearch` on MongoDB — never a third store), and erases them
+     * with the row: chunks are a derived-data tier keyed `(resourceType, resourceId, fieldName)`,
+     * so row deletion, field impersonalization, and subject erasure all reach them.
+     *
+     * Authored fluently: `z.string().ragSource()` or `z.string().ragSource({ chunkingStrategy:
+     * RAGChunkingStrategy.MARKDOWN, chunkSize: 1200, chunkOverlap: 150 })`. All params are optional
+     * and there is NO `enabled` flag — presence of the decorator IS the declaration (see
+     * {@link RagSourceConfiguration}). `addRagSource(schema, config?)` is the equivalent programmatic
+     * escape hatch; read the config back with `getRagSourceConfig(schema)`.
+     *
+     * **File fields are one text provider, not a separate mechanism.** `z_file({ ragSource: {...} })`
+     * registers THIS decorator on the schema it returns, so detection is uniform across plain-text
+     * and file-backed sources; file-only extraction knobs (OCR) live file-side in
+     * `FileSchemaOptions.textExtraction`, never here.
+     *
+     * **Refused companions, enforced in BOTH application orders at the decorator chokepoint:**
+     * - {@link ZodDecorator.IS_PASSWORD}, {@link ZodDecorator.IS_OTP},
+     *   {@link ZodDecorator.IS_WRITE_ONLY_SECRET}, {@link ZodDecorator.IS_EPHEMERAL} — a secret or
+     *   ephemeral value must never enter a retrieval corpus.
+     * - {@link ZodDecorator.TTL} — MongoDB honours `.ttl()` natively: rows vanish with NO application
+     *   code running, so derived chunks of a TTL row could never be erased with their parent (plan
+     *   `resource-rag-capability` DL3). The refusal lifts when a sweep-cascade reconciles chunk rows
+     *   against vanished parents.
+     *
+     * {@link ZodDecorator.IS_BACKEND_ONLY} composes: a backend-only field can be a corpus source —
+     * retrieval access is governed by the resource's own access binding, not by field visibility.
+     * {@link ZodDecorator.IMPERSONALIZE_WITH} composes too: an impersonalize decision deletes the
+     * field's chunks in the same decision.
+     */
+    ZodDecorator["RAG_SOURCE"] = "ragSource";
     ZodDecorator["IS_VIRTUAL"] = "isVirtual";
     ZodDecorator["IS_DISCRIMINATOR"] = "isDiscriminator";
     ZodDecorator["EXCLUDE_FROM_CREATE"] = "excludeFromCreate";
@@ -735,6 +1338,32 @@ export var ZodDecorator;
     // Database constraint decorators
     ZodDecorator["IS_UNIQUE"] = "isUnique";
     ZodDecorator["IS_PRIMARY_KEY"] = "isPrimaryKey";
+    /**
+     * Marks a field as a stable, declaration-side **business key** —
+     * an identity independent from the random `_id` (`isPrimaryKey`).
+     *
+     * Used by data seeding to safely upsert, upgrade and synchronize seeded rows.
+     * Unlike `isPrimaryKey`,
+     * a business key is mutable by users (renames are handled by a per-seed
+     * `renames: [{ from, to }]` migrator), and it carries no implicit
+     * decorators (`isPrimaryKey` is composite — `isBusinessKey` is purely
+     * a marker so it can co-exist with whatever editing semantics the field
+     * already has).
+     *
+     * Composite scope-aware identity uses the object-level
+     * `OBJECT_BUSINESS_KEY_SET` decorator on the schema root.
+     */
+    ZodDecorator["IS_BUSINESS_KEY"] = "isBusinessKey";
+    /**
+     * Object-level decorator declaring a **composite business key** for the
+     * schema (e.g. `(organizationId, templateKey)`). Schema-level analog of
+     * `IS_BUSINESS_KEY`. Used by the data-seeding subsystem.
+     *
+     * Field-level `IS_BUSINESS_KEY` and object-level `OBJECT_BUSINESS_KEY_SET`
+     * are **mutually exclusive** on the same schema — pick one identity model
+     * (single field vs composite). Mixing is rejected at decoration time.
+     */
+    ZodDecorator["OBJECT_BUSINESS_KEY_SET"] = "businessKeySet";
     ZodDecorator["TTL"] = "ttl";
     // String edit mode convenience decorators (shorthand for STRING_UI with specific editMode)
     ZodDecorator["IS_PASSWORD"] = "isPassword";
@@ -748,7 +1377,7 @@ export var ZodDecorator;
     ZodDecorator["SYSTEM_ENUM"] = "systemEnum";
     // Ephemeral field decorator - marks a field as transient response-only data (shown once, then gone)
     ZodDecorator["IS_EPHEMERAL"] = "isEphemeral";
-    // CRDT field decorator - marks a field for future field-level LWW merge (Phase 3C)
+    // CRDT field decorator — marks a field for future field-level LWW merge.
     ZodDecorator["IS_CRDT"] = "isCRDT";
     // Unified {primitive}UI decorators — new API replacing display policy + formField decomposition
     ZodDecorator["BOOLEAN_UI"] = "booleanUI";
@@ -767,5 +1396,22 @@ export var ZodDecorator;
     ZodDecorator["FOREIGN_KEY_UI"] = "foreignKeyUI";
     ZodDecorator["ARRAY_UI"] = "arrayUI";
     ZodDecorator["OBJECT_UI"] = "objectUI";
+    // Per-primitive field specification decorators — business semantics (companion-only)
+    ZodDecorator["STRING_SPEC"] = "stringSpec";
+    ZodDecorator["NUMBER_SPEC"] = "numberSpec";
+    ZodDecorator["BOOLEAN_SPEC"] = "booleanSpec";
+    ZodDecorator["DATE_SPEC"] = "dateSpec";
+    ZodDecorator["DATETIME_SPEC"] = "dateTimeSpec";
+    ZodDecorator["TIME_SPEC"] = "timeSpec";
+    ZodDecorator["ENUM_SPEC"] = "enumSpec";
+    ZodDecorator["MONEY_SPEC"] = "moneySpec";
+    ZodDecorator["CODE_SPEC"] = "codeSpec";
+    ZodDecorator["FILE_SPEC"] = "fileSpec";
+    ZodDecorator["DURATION_SPEC"] = "durationSpec";
+    ZodDecorator["PHONE_SPEC"] = "phoneSpec";
+    ZodDecorator["BIGDECIMAL_SPEC"] = "bigDecimalSpec";
+    ZodDecorator["FOREIGN_KEY_SPEC"] = "foreignKeySpec";
+    ZodDecorator["ARRAY_SPEC"] = "arraySpec";
+    ZodDecorator["OBJECT_SPEC"] = "objectSpec";
 })(ZodDecorator || (ZodDecorator = {}));
-//# sourceMappingURL=zod-decorators.types.js.map
+//# sourceMappingURL=zod-decorators.types.js.map