@wildo-ai/zod-decorators 1.1.11 → 1.1.13

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

@@ -293,8 +293,13 @@ export var DisplayFieldComponent;
  *   with no button: to hide one section until asked, use COLLAPSIBLE (#2197)
  *
  * @category Guided (sequential, with indicators)
- * - STEPPER: Step-by-step with step indicators
+ * - STEPPER: Step-by-step with step indicators — a WIZARD: the reader moves through the steps
  * - TIMELINE: Chronological progression (vertical timeline)
+ * - STAGES: the stages of ONE record's lifecycle, read-only. The stage the record is at comes from a
+ *   field of the record (`stageBinding` on the group's first section), so a read page shows where the
+ *   record stands: earlier stages reached, its own stage current, later ones not reached, each with its
+ *   description, and no navigation buttons. Hosted by `DisplayLayout`, the host that holds a record
+ *   (#1786). STEPPER is the wrong mode for this: its position is the READER's, not the record's.
  *
  * NOTE: Wizard is NOT included — it's a higher-level layout pattern
  * that contains sections, not a section rendering mode.
@@ -320,6 +325,7 @@ export var SectionMode;
     // Guided (sequential, with indicators)
     SectionMode["STEPPER"] = "stepper";
     SectionMode["TIMELINE"] = "timeline";
+    SectionMode["STAGES"] = "stages";
 })(SectionMode || (SectionMode = {}));
 // =============================================================================
 // OVERLAY CONTAINER MODE - UI Abstraction for Overlay Rendering
@@ -511,6 +517,12 @@ export const StringDisplayMode = {
      * `edit.editMode: StringEditMode.ORGANIZATION_ROLE` so the field is picked the way it is read.
      */
     ORGANIZATION_ROLE: 'organization_role',
+    /**
+     * The value is a calendar month, `YYYY-MM` — render it as the month and the year in the reader's locale
+     * ("October 2026", "octobre 2026"), never the raw string. A value that is not a year-month shows as typed. Declared
+     * by `z_yearMonth()`, which pairs it with `edit.editMode: StringEditMode.YEAR_MONTH`.
+     */
+    YEAR_MONTH: 'year_month',
 };
 /**
  * String edit modes for form components
@@ -540,6 +552,11 @@ export const StringEditMode = {
      * the operation's offer alone. The server remains the control: it decides what holding the role grants.
      */
     ORGANIZATION_ROLE: 'organization_role',
+    /**
+     * A MONTH-AND-YEAR picker: a list of the twelve months, named in the reader's locale, and a year. It writes the value
+     * as `YYYY-MM` and nothing else, so the user never types the format. Declared by `z_yearMonth()`.
+     */
+    YEAR_MONTH: 'year_month',
 };
 /**
  * WHOSE role table an `ORGANIZATION_ROLE` picker reads (#2778).
@@ -1053,6 +1070,10 @@ export var FileUploaderEntityType;
     // (matching USER / ANONYMOUS_USER) avoids mislabelling an OAuth-client upload as an "api key".
     FileUploaderEntityType["ORGANIZATION_MACHINE"] = "organization_machine";
     FileUploaderEntityType["APPLICATION_MACHINE"] = "application_machine";
+    // A file an inbound delivery put here: `ctx.attachments.adopt`'s copy, or a provider document a handler stored.
+    // `uploadedBy` is the delivery's id. Nobody authenticated, so this is a provenance and never a sign-in: it exists so
+    // a delivery can link what it produced and nothing else (#3330).
+    FileUploaderEntityType["INBOUND_DELIVERY"] = "inbound_delivery";
 })(FileUploaderEntityType || (FileUploaderEntityType = {}));
 /**
  * Image format options for file validation.
@@ -1688,6 +1709,19 @@ export var ZodDecorator;
      * not marked. No check runs over an application's resources yet: there the marker documents the field.
      */
     ZodDecorator["IS_DECIDER"] = "isDecider";
+    /**
+     * Role grant: this field's values are roles the WRITER grants (a membership's `roles`, a machine credential's
+     * `roles`, a unit assignment's `role`, an account's `appRoles`). A pure marker, read back with
+     * `isRoleGrantField(schema)`.
+     *
+     * What it changes: a form offers only the roles the person filling it may grant (#3248), decided by the rule the
+     * server's role-ceiling gate applies (`resolveRoleGrantCeiling` in `@wildo-ai/saas-models`), plus any role the
+     * record already holds, so a stored role is never dropped from view. It grants nothing and refuses nothing: the
+     * server gate on the write is the control, and the marker only keeps the form from offering what that gate refuses.
+     * Mark a field that a form offers roles in, where a write of it is checked against the writer's ceiling. A role
+     * grant typed as free text (an SSO connection's `roleMapping`) offers no roles, so marking it would narrow nothing.
+     */
+    ZodDecorator["IS_ROLE_GRANT"] = "isRoleGrant";
     /**
      * 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
@@ -1759,6 +1793,11 @@ export var ZodDecorator;
      * (single field vs composite). Mixing is rejected at decoration time.
      */
     ZodDecorator["OBJECT_BUSINESS_KEY_SET"] = "businessKeySet";
+    /**
+     * Object-level: one NON-unique index over several fields, for reads that filter on the leading fields and sort on
+     * the last (#3142). Accumulates: each call declares one more index. See {@link CompoundIndexParams}.
+     */
+    ZodDecorator["OBJECT_COMPOUND_INDEX"] = "compoundIndex";
     /**
      * Object-level: the object (`{ resourceType, resourceId }`) names one row of a resource whose type is chosen at
      * run time from a published target set. See {@link ResourceReferenceParams}.