@opencrvs/toolkit 2.0.0-rc.fef9d21 → 2.0.0-rc.ff1424b

package/dist/application-config/index.js

@@ -75,7 +75,10 @@ var ActionConditional = z.discriminatedUnion("type", [
   ShowConditional,
   // Action can be shown to the user in the list but as disabled
   EnableConditional
-]);
+]).meta({
+  id: "ActionConditional",
+  description: "Conditional gating whether an action is shown (SHOW) or enabled (ENABLE). When omitted from an action, the action is shown and enabled for everyone."
+});
 var DisplayOnReviewConditional = z.object({
   type: z.literal(ConditionalType.DISPLAY_ON_REVIEW),
   conditional: Conditional
@@ -90,8 +93,8 @@ var FieldConditional = z.discriminatedUnion("type", [
   // Field output can be shown / hidden on the review page
   DisplayOnReviewConditional
 ]).meta({
-  description: "Field conditional configuration",
-  id: "FieldConditional"
+  id: "FieldConditional",
+  description: "Conditional gating whether a form field is shown (SHOW), enabled (ENABLE), or displayed on the review page (DISPLAY_ON_REVIEW). When omitted, the field is shown and enabled for everyone, and is displayed on review whenever it has a value."
 });
 
 // ../commons/src/events/TranslationConfig.ts
@@ -203,6 +206,11 @@ var FieldTypesToHideInReview = [
   FieldType.ALPHA_PRINT_BUTTON,
   FieldType.ALPHA_HIDDEN
 ];
+var HiddenFieldTypes = [
+  FieldType.HTTP,
+  FieldType.QUERY_PARAM_READER,
+  FieldType.ALPHA_HIDDEN
+];
 
 // ../commons/src/events/FieldValue.ts
 var z7 = __toESM(require("zod/v4"));
@@ -321,7 +329,7 @@ var PlainDate = import_zod.z.string().date().brand("PlainDate").describe("Date i
 // ../commons/src/events/FieldValue.ts
 var TextValue = z7.string();
 var HiddenFieldValue = z7.string();
-var NonEmptyTextValue = TextValue.min(1);
+var NonEmptyTextValue = z7.string().trim().min(1);
 var DateValue = z7.iso.date().describe("Date in the format YYYY-MM-DD");
 var AgeValue = z7.object({
   age: z7.number(),
@@ -350,6 +358,7 @@ var DateRangeFieldValue = z7.object({
 var EmailValue = z7.email();
 var CheckboxFieldValue = z7.boolean();
 var NumberFieldValue = z7.number();
+var SignatureFieldValue = FileFieldValue;
 var ButtonFieldValue = z7.number();
 var VerificationStatusValue = z7.enum([
   "verified",
@@ -418,28 +427,20 @@ function schemaPriority(schema) {
   return idx === -1 ? 9999 : idx;
 }
 function safeUnion(schemas) {
+  const sortedSchemas = [...schemas].sort(
+    (a, b) => schemaPriority(a) - schemaPriority(b)
+  );
   return z7.any().superRefine((val, ctx) => {
-    const successful = schemas.filter((s) => s.safeParse(val).success);
-    if (successful.length === 1) {
-      return;
-    }
-    if (successful.length === 0) {
-      ctx.addIssue({
-        code: "invalid_type",
-        expected: "custom",
-        message: "Value does not match any schema"
-      });
-      return;
-    }
-    successful.sort((a, b) => schemaPriority(a) - schemaPriority(b));
-    const best = successful[0];
-    if (!best.safeParse(val).success) {
-      ctx.addIssue({
-        expected: "custom",
-        code: "invalid_type",
-        message: "Value did not match the best schema"
-      });
+    for (const schema of sortedSchemas) {
+      if (schema.safeParse(val).success) {
+        return;
+      }
     }
+    ctx.addIssue({
+      code: "invalid_type",
+      expected: "custom",
+      message: "Value does not match any schema"
+    });
   }).meta({
     description: "Value that matches exactly one of the possible schema types (TextValue, DateValue, DateRangeFieldValue). The best matching schema is chosen by priority."
   });
@@ -656,6 +657,10 @@ var scopeByEvent = z11.preprocess(
   (val) => val === void 0 ? void 0 : [val].flat(),
   z11.array(z11.string()).optional()
 ).describe("Event type, e.g. birth, death");
+var userRole = z11.preprocess(
+  (val) => val === void 0 ? void 0 : [val].flat(),
+  z11.array(z11.string()).optional()
+).describe("User role, e.g. admin, field agent");
 var scopeOptionsPlaceEvent = z11.object({
   event: scopeByEvent,
   placeOfEvent: JurisdictionFilter.optional()
@@ -679,6 +684,9 @@ var CustomActionScopeOptions = AllRecordScopeOptions.extend({
 var AccessLevelOptions = z11.object({
   accessLevel: JurisdictionFilter.optional()
 });
+var AllUserScopeOptions = AccessLevelOptions.extend({
+  role: userRole.optional()
+});
 var WorkqueueOrDashboardOptions = z11.object({
   ids: z11.preprocess(
     (val) => val === void 0 ? void 0 : [val].flat(),
@@ -688,6 +696,7 @@ var WorkqueueOrDashboardOptions = z11.object({
 var AllScopeOptions = z11.object({
   ...AllRecordScopeOptions.shape,
   ...AccessLevelOptions.shape,
+  ...AllUserScopeOptions.shape,
   ...WorkqueueOrDashboardOptions.shape
 });
 var ScopeOptionKey = AllScopeOptions.keyof();
@@ -760,6 +769,30 @@ var RecordScopeV2 = z11.discriminatedUnion("type", [
 ]).describe(
   "Scopes used to check user's permission to perform actions on a record."
 );
+var SystemScopeType = z11.enum([
+  "organisation.read-locations",
+  "user.read",
+  "user.create",
+  "user.edit",
+  "user.search"
+]);
+var UserScopeType = SystemScopeType.extract([
+  "user.read",
+  "user.create",
+  "user.edit",
+  "user.search"
+]);
+var ScopesWithRoleOption = UserScopeType.extract(["user.edit", "user.create"]);
+var UserScopeV2 = z11.discriminatedUnion("type", [
+  z11.object({
+    type: ScopesWithRoleOption,
+    options: AllUserScopeOptions.optional()
+  }),
+  z11.object({
+    type: UserScopeType.extract(["user.read", "user.search"]),
+    options: AccessLevelOptions.optional()
+  })
+]);
 var ResolvedRecordScopeV2 = z11.discriminatedUnion("type", [
   z11.object({
     type: ScopesWithPlaceEventOptions,
@@ -780,16 +813,14 @@ var ResolvedRecordScopeV2 = z11.discriminatedUnion("type", [
     }).optional()
   })
 ]).describe("Resolved scope with location/user IDs instead of filters.");
-var SystemScopeType = z11.enum([
-  "organisation.read-locations",
-  "user.read",
-  "user.create",
-  "user.edit"
-]);
 var Scope = z11.discriminatedUnion("type", [
   z11.object({ type: PlainScopeType }),
   ...RecordScopeV2.options,
-  z11.object({ type: SystemScopeType, options: AccessLevelOptions.optional() }),
+  ...UserScopeV2.options,
+  z11.object({
+    type: z11.literal("organisation.read-locations"),
+    options: AccessLevelOptions.optional()
+  }),
   z11.object({
     type: z11.literal("workqueue"),
     options: WorkqueueOrDashboardOptions
@@ -809,7 +840,9 @@ var ScopeType = z11.enum([
 var EncodedScope = z11.string().brand("EncodedScope");
 var DEFAULT_SCOPE_OPTIONS = {
   placeOfEvent: JurisdictionFilter.enum.all,
-  accessLevel: JurisdictionFilter.enum.all
+  accessLevel: JurisdictionFilter.enum.all,
+  registeredIn: JurisdictionFilter.enum.all,
+  declaredIn: JurisdictionFilter.enum.all
 };
 
 // ../commons/src/authentication.ts
@@ -962,8 +995,9 @@ var RequestedCorrectionAction = ActionBase.extend(
 var ApprovedCorrectionAction = ActionBase.extend(
   z13.object({
     type: z13.literal(ActionType.APPROVE_CORRECTION),
-    requestId: z13.string()
+    requestId: z13.string(),
     // TODO move into 'content' property
+    content: z13.object({ immediateCorrection: z13.boolean().optional() }).optional()
   }).shape
 );
 var RejectedCorrectionAction = ActionBase.extend(
@@ -1055,6 +1089,9 @@ var FlagConfig = z14.object({
     "Indicates if this flag expects an action to be performed to be cleared."
   ),
   label: TranslationConfig.describe("Human readable label of the flag.")
+}).meta({
+  id: "FlagConfig",
+  description: "Configuration for a custom flag that can be added to or removed from records by event actions."
 });
 var ActionFlagConfig = z14.object({
   id: Flag,
@@ -1062,6 +1099,9 @@ var ActionFlagConfig = z14.object({
   conditional: Conditional.optional().describe(
     "When conditional is met, the operation is performed on the flag. If not provided, the operation is performed unconditionally."
   )
+}).meta({
+  id: "ActionFlagConfig",
+  description: "Add or remove operation applied to a flag when the parent action is accepted. Optionally gated by a conditional."
 });
 
 // ../commons/src/events/EventMetadata.ts
@@ -1083,8 +1123,7 @@ var ActionCreationMetadata = z15.object({
   ),
   createdByUserType: z15.enum(["user", "system"]).nullish().describe("Whether the user is a normal user or a system."),
   acceptedAt: z15.iso.datetime().describe("Timestamp when the action request was accepted."),
-  createdByRole: z15.string().optional().describe("Role of the user at the time of action request creation."),
-  createdBySignature: z15.string().nullish().describe("Signature of the user who created the action request.")
+  createdByRole: z15.string().optional().describe("Role of the user at the time of action request creation.")
 });
 var RegistrationCreationMetadata = ActionCreationMetadata.extend({
   registrationNumber: z15.string().describe(
@@ -1112,9 +1151,6 @@ var EventMetadata = z15.object({
   createdAtLocation: UUID.nullish().describe(
     "Location of the user who created the event."
   ),
-  createdBySignature: DocumentPath.nullish().describe(
-    "Signature of the user who created the event."
-  ),
   updatedAtLocation: UUID.nullish().describe(
     "Location of the user who last changed the status."
   ),
@@ -1378,14 +1414,31 @@ var FieldId = import_v43.default.string().superRefine((val, ctx) => {
   }
 }).describe("Unique identifier for the field");
 var FieldReference = import_v43.default.object({
-  $$field: FieldId,
+  $$field: FieldId.describe("Id of the field to reference"),
   $$subfield: import_v43.default.array(import_v43.default.string()).optional().default([]).describe(
     'If the FieldValue is an object, subfield can be used to refer to e.g. `["foo", "bar"]` in `{ foo: { bar: 3 } }`'
+  ),
+  $$code: import_v43.default.string().optional().describe(
+    "Serialised client-side function body. When present the expression is evaluated rather than dereferenced."
   )
-}).describe("Reference to a field by its ID");
+}).describe(
+  "Reference to a field value, with an optional client-side computation applied."
+);
+var ComputedDefaultValue = import_v43.default.object({
+  $$code: import_v43.default.string().describe(
+    "Serialised client-side function body. Receives (undefined, context) where context includes $now, $online, and system variables."
+  )
+}).describe("A context-only computation used as a field default value.");
 var ValidationConfig = import_v43.default.object({
-  validator: Conditional,
-  message: TranslationConfig
+  validator: Conditional.describe(
+    "Conditional expression that must hold for the field value to be considered valid."
+  ),
+  message: TranslationConfig.describe(
+    "Error message displayed when the validator does not hold."
+  )
+}).meta({
+  id: "ValidationConfig",
+  description: "Validation rule applied to a form field. The validator is a conditional expression that must hold for the field value to be considered valid."
 });
 var requiredSchema = import_v43.default.union([
   import_v43.default.boolean(),
@@ -1416,7 +1469,7 @@ var BaseField = import_v43.default.object({
     "Indicates whether the field can be modified during record correction."
   ),
   value: FieldReference.or(import_v43.default.array(FieldReference)).optional().describe(
-    "Reference to the source field or fields. When a value is defined, it is copied from the parent field when changed. If multiple references are provided, the first truthy value is used."
+    "Reference to the source field or fields. When a value is defined, it is copied from the parent field when changed. If multiple references are provided, the first truthy value is used. A FieldReference with $$code computes the value via a custom client-side function."
   ),
   analytics: import_v43.default.boolean().default(false).optional().describe(
     "Indicates whether the field is included in analytics. When enabled, its value becomes available in the analytics dashboard."
@@ -1424,30 +1477,40 @@ var BaseField = import_v43.default.object({
 }).describe("Common properties shared across all field types.");
 var Divider = BaseField.extend({
   type: import_v43.default.literal(FieldType.DIVIDER)
+}).meta({
+  description: "A horizontal line divider",
+  id: "Divider"
 });
 var TextField = BaseField.extend({
   type: import_v43.default.literal(FieldType.TEXT),
-  defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
+  defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
   configuration: import_v43.default.object({
     maxLength: import_v43.default.number().optional().describe("Maximum length of the text"),
     type: import_v43.default.enum(["text", "password"]).optional(),
     prefix: TranslationConfig.optional(),
     postfix: TranslationConfig.optional()
   }).default({ type: "text" }).optional()
-}).describe("Text input");
+}).meta({
+  description: "A text input field",
+  id: "TextField"
+});
 var NumberField = BaseField.extend({
   type: import_v43.default.literal(FieldType.NUMBER),
-  defaultValue: NumberFieldValue.optional(),
+  defaultValue: NumberFieldValue.or(ComputedDefaultValue).optional(),
   configuration: import_v43.default.object({
     min: import_v43.default.number().optional().describe("Minimum value"),
     max: import_v43.default.number().optional().describe("Maximum value"),
+    integer: import_v43.default.boolean().optional().describe("When true, only whole numbers are allowed"),
     prefix: TranslationConfig.optional(),
     postfix: TranslationConfig.optional()
   }).optional()
-}).describe("Number input");
+}).meta({
+  description: "A number input field",
+  id: "NumberField"
+});
 var TextAreaField = BaseField.extend({
   type: import_v43.default.literal(FieldType.TEXTAREA),
-  defaultValue: NonEmptyTextValue.optional(),
+  defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
   configuration: import_v43.default.object({
     maxLength: import_v43.default.number().optional().describe("Maximum length of the text"),
     rows: import_v43.default.number().optional().describe("Number of visible text lines"),
@@ -1455,7 +1518,10 @@ var TextAreaField = BaseField.extend({
     prefix: TranslationConfig.optional(),
     postfix: TranslationConfig.optional()
   }).default({ rows: 4 }).optional()
-}).describe("Multiline text input");
+}).meta({
+  description: "A multiline text input",
+  id: "TextAreaField"
+});
 var ImageMimeType = import_v43.default.enum([
   "image/png",
   "image/jpg",
@@ -1478,58 +1544,76 @@ var SignatureField = BaseField.extend({
   signaturePromptLabel: TranslationConfig.describe(
     "Title of the signature modal"
   ),
-  defaultValue: FieldValue.optional(),
+  defaultValue: SignatureFieldValue.or(ComputedDefaultValue).optional(),
   configuration: import_v43.default.object({
     maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
     acceptedFileTypes: MimeType.array().optional().describe("List of allowed file formats for the signature")
   }).default({
     maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
   })
-}).describe("Signature input field");
+}).meta({
+  description: "A signature input field",
+  id: "SignatureField"
+});
 var EmailField = BaseField.extend({
   type: import_v43.default.literal(FieldType.EMAIL),
   configuration: import_v43.default.object({
     maxLength: import_v43.default.number().optional().describe("Maximum length of the text")
   }).default({ maxLength: 255 }).optional(),
-  defaultValue: NonEmptyTextValue.optional()
+  defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional()
+}).meta({
+  description: "An email input field",
+  id: "EmailField"
 });
 var DateField = BaseField.extend({
   type: import_v43.default.literal(FieldType.DATE),
-  defaultValue: SerializedNowDateTime.or(PlainDate).optional().describe("Default date value(yyyy-MM-dd)"),
+  defaultValue: SerializedNowDateTime.or(PlainDate).or(ComputedDefaultValue).optional().describe("Default date value(yyyy-MM-dd)"),
   configuration: import_v43.default.object({
     notice: TranslationConfig.describe(
       "Text to display above the date input"
     ).optional()
   }).optional()
-}).describe("A single date input (yyyy-MM-dd)");
+}).meta({
+  description: "A date input (yyyy-MM-dd)",
+  id: "DateField"
+});
 var AgeField = BaseField.extend({
   type: import_v43.default.literal(FieldType.AGE),
-  defaultValue: NumberFieldValue.optional(),
+  defaultValue: NumberFieldValue.or(ComputedDefaultValue).optional(),
   configuration: import_v43.default.object({
     asOfDate: FieldReference,
     prefix: TranslationConfig.optional(),
     postfix: TranslationConfig.optional()
   })
-}).describe("An age input field which uses the current date as the asOfDate");
+}).meta({
+  description: "An age input field which uses the current date as the asOfDate",
+  id: "AgeField"
+});
 var TimeField = BaseField.extend({
   type: import_v43.default.literal(FieldType.TIME),
-  defaultValue: SerializedNowDateTime.or(TimeValue).optional().describe("Default time value (HH-mm)"),
+  defaultValue: SerializedNowDateTime.or(TimeValue).or(ComputedDefaultValue).optional().describe("Default time value (HH-mm)"),
   configuration: import_v43.default.object({
     use12HourFormat: import_v43.default.boolean().optional().describe("Whether to use 12-hour format"),
     notice: TranslationConfig.describe(
       "Text to display above the time input"
     ).optional()
   }).optional()
-}).describe("A single date input (HH-mm)");
+}).meta({
+  description: "A single time input (HH-mm)",
+  id: "TimeField"
+});
 var DateRangeField = BaseField.extend({
   type: import_v43.default.literal(FieldType.DATE_RANGE),
-  defaultValue: DateRangeFieldValue.optional(),
+  defaultValue: DateRangeFieldValue.or(ComputedDefaultValue).optional(),
   configuration: import_v43.default.object({
     notice: TranslationConfig.describe(
       "Text to display above the date input"
     ).optional()
   }).optional()
-}).describe("A date range input ({ start: yyyy-MM-dd, end: yyyy-MM-dd })");
+}).meta({
+  description: "A date range input ({ start: yyyy-MM-dd, end: yyyy-MM-dd })",
+  id: "DateRangeField"
+});
 var HtmlFontVariant = import_v43.default.enum([
   "reg12",
   "reg14",
@@ -1573,21 +1657,33 @@ var ImageViewField = BaseField.extend({
   type: import_v43.default.literal(FieldType.IMAGE_VIEW),
   defaultValue: NonEmptyTextValue.optional(),
   configuration: ImageConfiguration
-}).describe("A read-only image component for form pages");
+}).meta({
+  description: "A read-only image component for form pages",
+  id: "ImageViewField"
+});
 var Paragraph = BaseField.extend({
   type: import_v43.default.literal(FieldType.PARAGRAPH),
   configuration: ParagraphConfiguration
-}).describe("A read-only HTML <p> paragraph");
+}).meta({
+  description: "A read-only HTML <p> paragraph",
+  id: "Paragraph"
+});
 var Heading = BaseField.extend({
   type: import_v43.default.literal(FieldType.HEADING),
   configuration: HeadingConfiguration
-}).describe("A read-only heading component for form pages");
+}).meta({
+  description: "A read-only heading component for form pages",
+  id: "Heading"
+});
 var PageHeader = BaseField.extend({
   type: import_v43.default.literal(FieldType.PAGE_HEADER)
-}).describe("A read-only header component for form pages");
+}).meta({
+  description: "A read-only header component for form pages",
+  id: "PageHeader"
+});
 var File = BaseField.extend({
   type: import_v43.default.literal(FieldType.FILE),
-  defaultValue: FileFieldValue.optional(),
+  defaultValue: FileFieldValue.or(ComputedDefaultValue).optional(),
   configuration: import_v43.default.object({
     maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
     acceptedFileTypes: MimeType.array().optional().describe("List of allowed file formats for the signature"),
@@ -1603,7 +1699,10 @@ var File = BaseField.extend({
   }).default({
     maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
   })
-}).describe("File upload");
+}).meta({
+  description: "A file upload field",
+  id: "File"
+});
 var SelectOption = import_v43.default.object({
   value: import_v43.default.string().describe("The value of the option"),
   label: import_v43.default.union([import_v43.default.string(), TranslationConfig]).describe("The label of the option"),
@@ -1611,7 +1710,7 @@ var SelectOption = import_v43.default.object({
 });
 var NumberWithUnitField = BaseField.extend({
   type: import_v43.default.literal(FieldType.NUMBER_WITH_UNIT),
-  defaultValue: NumberWithUnitFieldValue.optional(),
+  defaultValue: NumberWithUnitFieldValue.or(ComputedDefaultValue).optional(),
   options: import_v43.default.array(SelectOption).describe("A list of options for the unit select"),
   configuration: import_v43.default.object({
     min: import_v43.default.number().optional().describe("Minimum value of the number field"),
@@ -1620,17 +1719,23 @@ var NumberWithUnitField = BaseField.extend({
       "Placeholder for the number field"
     )
   }).optional()
-}).describe("Number with unit input");
+}).meta({
+  description: "A number with unit input field",
+  id: "NumberWithUnitField"
+});
 var RadioGroup = BaseField.extend({
   type: import_v43.default.literal(FieldType.RADIO_GROUP),
-  defaultValue: TextValue.optional(),
+  defaultValue: TextValue.or(ComputedDefaultValue).optional(),
   options: import_v43.default.array(SelectOption).describe("A list of options"),
   configuration: import_v43.default.object({
     styles: import_v43.default.object({
       size: import_v43.default.enum(["NORMAL", "LARGE"]).optional()
     }).optional()
   }).optional()
-}).describe("Grouped radio options");
+}).meta({
+  description: "A grouped radio button field",
+  id: "RadioGroup"
+});
 var BulletList = BaseField.extend({
   type: import_v43.default.literal(FieldType.BULLET_LIST),
   items: import_v43.default.array(TranslationConfig).describe("A list of items"),
@@ -1639,10 +1744,13 @@ var BulletList = BaseField.extend({
       fontVariant: HtmlFontVariant.optional()
     }).optional()
   }).default({})
-}).describe("A list of bullet points");
+}).meta({
+  description: "A list of bullet points",
+  id: "BulletList"
+});
 var Select = BaseField.extend({
   type: import_v43.default.literal(FieldType.SELECT),
-  defaultValue: TextValue.optional(),
+  defaultValue: TextValue.or(ComputedDefaultValue).optional(),
   options: import_v43.default.array(SelectOption).describe("A list of options"),
   noOptionsMessage: TranslationConfig.optional().describe(
     `
@@ -1654,16 +1762,22 @@ var Select = BaseField.extend({
     { ..., defaultMessage: "'{input}' is not listed among the health facilities." }
   `
   )
-}).describe("Select input");
+}).meta({
+  description: "A select input field",
+  id: "Select"
+});
 var SelectDateRangeOption = import_v43.default.object({
   value: SelectDateRangeValue.describe("The value of the option"),
   label: TranslationConfig.describe("The label of the option")
 });
 var SelectDateRangeField = BaseField.extend({
   type: import_v43.default.literal(FieldType.SELECT_DATE_RANGE),
-  defaultValue: SelectDateRangeValue.optional(),
+  defaultValue: SelectDateRangeValue.or(ComputedDefaultValue).optional(),
   options: import_v43.default.array(SelectDateRangeOption).describe("A list of options")
-}).describe("Select input with date range options");
+}).meta({
+  description: "A date range selection field",
+  id: "SelectDateRangeField"
+});
 var NameConfig = import_v43.default.object({
   firstname: import_v43.default.object({ required: requiredSchema, label: TranslationConfig.optional() }).optional(),
   middlename: import_v43.default.object({ required: requiredSchema, label: TranslationConfig.optional() }).optional(),
@@ -1675,7 +1789,7 @@ var NameField = BaseField.extend({
     firstname: SerializedUserField.or(NonEmptyTextValue).optional(),
     middlename: SerializedUserField.or(NonEmptyTextValue).optional(),
     surname: SerializedUserField.or(NonEmptyTextValue).optional()
-  }).optional(),
+  }).or(ComputedDefaultValue).optional(),
   configuration: import_v43.default.object({
     name: NameConfig.default({
       firstname: { required: true },
@@ -1694,26 +1808,41 @@ var NameField = BaseField.extend({
       surname: { required: true }
     }
   }).optional()
-}).describe("Name input field");
+}).meta({
+  description: "A field for entering a persons name",
+  id: "NameField"
+});
 var PhoneField = BaseField.extend({
-  defaultValue: NonEmptyTextValue.optional(),
+  defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
   type: import_v43.default.literal(FieldType.PHONE)
-}).describe("Phone input field");
+}).meta({
+  description: "A field for entering a phone number",
+  id: "PhoneField"
+});
 var IdField = BaseField.extend({
-  defaultValue: NonEmptyTextValue.optional(),
+  defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
   type: import_v43.default.literal(FieldType.ID)
-}).describe("ID input field");
+}).meta({
+  description: "A field for entering an ID",
+  id: "IdField"
+});
 var Checkbox = BaseField.extend({
   type: import_v43.default.literal(FieldType.CHECKBOX),
-  defaultValue: CheckboxFieldValue.default(false)
-}).describe("Boolean checkbox field");
+  defaultValue: CheckboxFieldValue.or(ComputedDefaultValue).default(false)
+}).meta({
+  description: "A boolean checkbox field",
+  id: "Checkbox"
+});
 var Country = BaseField.extend({
   type: import_v43.default.literal(FieldType.COUNTRY),
-  defaultValue: NonEmptyTextValue.optional(),
+  defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
   optionOverrides: import_v43.default.array(SelectOption.omit({ label: true })).optional().describe(
     "Conditionals for specific countries. Countries not listed are always shown and enabled."
   )
-}).describe("Country select field");
+}).meta({
+  description: "A field for selecting a country",
+  id: "Country"
+});
 var AllowedLocations = JurisdictionReference.optional().describe(
   "Limits which location options are selectable depending on user jurisdiction and location."
 );
@@ -1722,28 +1851,33 @@ var AdministrativeAreas = import_v43.default.enum([
   "HEALTH_FACILITY",
   "CRVS_OFFICE"
 ]);
-var AdministrativeAreaConfiguration = import_v43.default.object({
-  partOf: FieldReference.optional().describe("Parent location"),
-  type: AdministrativeAreas,
-  allowedLocations: AllowedLocations
-}).describe("Administrative area options");
 var AdministrativeAreaField = BaseField.extend({
   type: import_v43.default.literal(FieldType.ADMINISTRATIVE_AREA),
-  defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
-  configuration: AdministrativeAreaConfiguration
-}).describe("Administrative area input field e.g. facility, office");
+  defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
+  configuration: import_v43.default.object({
+    partOf: FieldReference.optional().describe("Parent location"),
+    type: AdministrativeAreas,
+    allowedLocations: AllowedLocations
+  }).describe("Administrative area options")
+}).meta({
+  description: "Administrative area input field",
+  id: "AdministrativeAreaField"
+});
 var LocationInput = BaseField.extend({
   type: import_v43.default.literal(FieldType.LOCATION),
-  defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
+  defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
   configuration: import_v43.default.object({
     locationTypes: import_v43.default.array(import_v43.default.string()).optional().describe("Types of the locations that are available for selection."),
     allowedLocations: AllowedLocations
   }).optional()
-}).describe("Input field for a location");
+}).meta({
+  description: "A field for selecting a location",
+  id: "LocationInput"
+});
 var FileUploadWithOptions = BaseField.extend({
   type: import_v43.default.literal(FieldType.FILE_WITH_OPTIONS),
   options: import_v43.default.array(SelectOption).describe("A list of options"),
-  defaultValue: FileFieldWithOptionValue.optional(),
+  defaultValue: FileFieldWithOptionValue.or(ComputedDefaultValue).optional(),
   configuration: import_v43.default.object({
     maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
     maxImageSize: import_v43.default.object({
@@ -1753,15 +1887,18 @@ var FileUploadWithOptions = BaseField.extend({
   }).default({
     maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
   })
+}).meta({
+  description: "A field for uploading files with file type options",
+  id: "FileUploadWithOptions"
 });
 var Facility = BaseField.extend({
   type: import_v43.default.literal(FieldType.FACILITY),
-  defaultValue: NonEmptyTextValue.optional(),
+  defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
   configuration: import_v43.default.object({ allowedLocations: AllowedLocations }).optional()
 }).describe("Input field for a facility");
 var Office = BaseField.extend({
   type: import_v43.default.literal(FieldType.OFFICE),
-  defaultValue: NonEmptyTextValue.optional(),
+  defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
   configuration: import_v43.default.object({ allowedLocations: AllowedLocations }).optional()
 }).describe("Input field for an office");
 var DefaultAddressFieldValue = DomesticAddressFieldValue.extend({
@@ -1797,8 +1934,11 @@ var Address = BaseField.extend({
     ).optional(),
     allowedLocations: AllowedLocations
   }).optional(),
-  defaultValue: DefaultAddressFieldValue.optional()
-}).describe("Address input field \u2013 a combination of location and text fields");
+  defaultValue: DefaultAddressFieldValue.or(ComputedDefaultValue).optional()
+}).meta({
+  description: "Address input field \u2013 a combination of location and text fields",
+  id: "Address"
+});
 var StaticDataEntry = import_v43.default.object({
   id: import_v43.default.string().describe("ID for the data entry."),
   label: TranslationConfig,
@@ -1813,7 +1953,10 @@ var DataField = BaseField.extend({
     subtitle: TranslationConfig.optional(),
     data: import_v43.default.array(DataEntry)
   })
-}).describe("Data field for displaying read-only data");
+}).meta({
+  description: "A field for displaying a table of read-only data",
+  id: "DataField"
+});
 var ButtonSize = import_v43.default.enum(["small", "medium", "large"]);
 var ButtonType = import_v43.default.enum([
   "primary",
@@ -1838,13 +1981,19 @@ var ButtonConfiguration = import_v43.default.object({
 });
 var ButtonField = BaseField.extend({
   type: import_v43.default.literal(FieldType.BUTTON),
-  defaultValue: ButtonFieldValue.optional(),
+  defaultValue: ButtonFieldValue.or(ComputedDefaultValue).optional(),
   configuration: ButtonConfiguration
-}).describe("Generic button without any built-in functionality");
+}).meta({
+  description: "A generic button that can be used to trigger an action",
+  id: "ButtonField"
+});
 var FieldGroup = BaseField.extend({
   type: import_v43.default.literal(FieldType.FIELD_GROUP),
   // eslint-disable-next-line @typescript-eslint/no-use-before-define
   fields: import_v43.default.lazy(() => import_v43.default.array(FieldConfig))
+}).meta({
+  description: "A group of fields that are displayed together",
+  id: "FieldGroup"
 });
 var AlphaPrintButton = BaseField.extend({
   type: import_v43.default.literal(FieldType.ALPHA_PRINT_BUTTON),
@@ -1854,10 +2003,13 @@ var AlphaPrintButton = BaseField.extend({
       "Label for the print button"
     )
   })
-}).describe("Print button field for printing certificates");
+}).meta({
+  description: "An experimental print button field for printing certificates during the declaration process",
+  id: "AlphaPrintButton"
+});
 var HttpField = BaseField.extend({
   type: import_v43.default.literal(FieldType.HTTP),
-  defaultValue: HttpFieldValue.optional(),
+  defaultValue: HttpFieldValue.or(ComputedDefaultValue).optional(),
   configuration: import_v43.default.object({
     trigger: FieldReference.optional().describe(
       "Reference to the field that triggers the HTTP request when its value changes. If not provided, the HTTP request is triggered once on component mount."
@@ -1870,20 +2022,30 @@ var HttpField = BaseField.extend({
     params: import_v43.default.record(import_v43.default.string(), import_v43.default.union([import_v43.default.string(), FieldReference])).optional(),
     timeout: import_v43.default.number().default(15e3).describe("Request timeout in milliseconds")
   })
-}).describe("HTTP request function triggered by a button click or other event");
+}).meta({
+  description: "Makes a background HTTP request to an external service and stores the response so other fields can use it. Has no visible UI \u2014 pair with LOADER to show request status.",
+  id: "HttpField"
+});
 var AutocompleteField = BaseField.extend({
   type: import_v43.default.literal(FieldType.AUTOCOMPLETE),
   configuration: import_v43.default.object({
-    url: import_v43.default.string().describe("URL to fetch autocomplete suggestions from").optional(),
+    url: import_v43.default.string().describe(
+      "URL to fetch autocomplete suggestions from. This should be a country config server endpoint."
+    ).optional(),
     method: import_v43.default.enum(["GET", "POST"]).default("GET").optional(),
     defaultOptions: import_v43.default.array(
       import_v43.default.object({
         label: import_v43.default.string(),
         value: import_v43.default.string()
       })
-    ).optional()
+    ).optional().describe(
+      "Manual entry is supported through configuration, allowing users to provide values not currently represented in the dataset."
+    )
   })
-}).describe("Autocomplete input field");
+}).meta({
+  description: "Generic autocomplete component designed for use with large dictionary-based datasets. The component supports dynamic retrieval of options from configurable data sources and is intended for datasets that may contain tens or hundreds of thousands of records.",
+  id: "AutocompleteField"
+});
 var SearchField = HttpField.extend({
   type: import_v43.default.literal(FieldType.SEARCH),
   configuration: SearchQuery.pick({
@@ -1916,6 +2078,9 @@ var SearchField = HttpField.extend({
       ok: TranslationConfig.optional()
     }).optional()
   })
+}).meta({
+  description: "A search input field",
+  id: "SearchField"
 });
 var LinkButtonField = BaseField.extend({
   type: import_v43.default.literal(FieldType.LINK_BUTTON),
@@ -1924,28 +2089,35 @@ var LinkButtonField = BaseField.extend({
     text: TranslationConfig.describe("Text to display on the button"),
     icon: import_v43.default.string().optional().describe("Icon for the button. You can find icons from OpenCRVS UI-Kit.")
   })
-}).describe("Button that opens a link");
+}).meta({
+  description: "A button that opens a URL link",
+  id: "LinkButtonField"
+});
 var VerificationStatus = BaseField.extend({
   type: import_v43.default.literal(FieldType.VERIFICATION_STATUS),
-  defaultValue: VerificationStatusValue.optional(),
+  defaultValue: VerificationStatusValue.or(ComputedDefaultValue).optional(),
   configuration: import_v43.default.object({
     status: TranslationConfig.describe("Text to display on the status pill."),
     description: TranslationConfig.describe(
       "Explaining text on the banner in form."
     )
   })
+}).meta({
+  description: "Displays a verification state (e.g. ID verified / pending). Often paired with ID_READER \u2014 it can read its value off an ID_READER rather than holding its own.",
+  id: "VerificationStatus"
 });
 var QueryParamReaderField = BaseField.extend({
   type: import_v43.default.literal(FieldType.QUERY_PARAM_READER),
   configuration: import_v43.default.object({
     pickParams: import_v43.default.array(import_v43.default.string()).describe("List of query parameters to read from the URL")
   })
-}).describe(
-  "A field that maps URL query params into form values and clears them afterward"
-);
+}).meta({
+  description: "A field that maps URL query params into form values and clears them afterward",
+  id: "QueryParamReaderField"
+});
 var QrReaderField = BaseField.extend({
   type: import_v43.default.literal(FieldType.QR_READER),
-  defaultValue: QrReaderFieldValue.optional(),
+  defaultValue: QrReaderFieldValue.or(ComputedDefaultValue).optional(),
   configuration: import_v43.default.object({
     validator: import_v43.default.any().meta({
       description: "JSON Schema to validate the scanned QR code data against before populating the form fields.",
@@ -1953,21 +2125,27 @@ var QrReaderField = BaseField.extend({
     })
   }).optional()
 }).meta({
-  description: "Configuration for QR code reader field, including optional JSON Schema validator.",
+  description: "QR code reader field, including optional JSON Schema validator.",
   id: "QrReaderField"
 });
 var IdReaderField = BaseField.extend({
   type: import_v43.default.literal(FieldType.ID_READER),
-  defaultValue: IdReaderFieldValue.optional(),
+  defaultValue: IdReaderFieldValue.or(ComputedDefaultValue).optional(),
   methods: import_v43.default.array(
     import_v43.default.union([QrReaderField, LinkButtonField]).describe("Methods for reading an ID")
   )
+}).meta({
+  description: "A wrapper around nested form fields, specifically QR_READER and LINK_BUTTON. It can hold the QR_READERs value.",
+  id: "IdReaderField"
 });
 var CustomField = BaseField.extend({
   type: import_v43.default.literal(FieldType._EXPERIMENTAL_CUSTOM),
   defaultValue: CustomFieldValue.optional(),
   src: import_v43.default.string().describe("Module source path for the custom field component"),
   configuration: import_v43.default.unknown().optional()
+}).meta({
+  description: "An expiremental custom field that is defined by a module source path",
+  id: "CustomField"
 });
 var FieldStyleVariant = import_v43.default.enum(["default", "highlighted"]);
 var LoaderField = BaseField.extend({
@@ -1977,22 +2155,25 @@ var LoaderField = BaseField.extend({
   configuration: import_v43.default.object({
     text: TranslationConfig.describe("Display text above the loading spinner")
   })
-}).describe(
-  "A non-interactive field that indicates an in progress operation in form"
-);
+}).meta({
+  description: "A non-interactive field that indicates an in progress operation in form",
+  id: "LoaderField"
+});
 var HiddenField = BaseField.extend({
   type: import_v43.default.literal(FieldType.ALPHA_HIDDEN),
   required: import_v43.default.boolean().default(false).optional(),
   defaultValue: TextValue.optional()
-}).describe(
-  "A non-interactive, hidden field that only hold a value in the form"
-);
+}).meta({
+  description: "A non-interactive, hidden field that only hold a value in the form",
+  id: "HiddenField"
+});
 var UserRoleField = BaseField.extend({
   type: import_v43.default.literal(FieldType.USER_ROLE),
   defaultValue: TextValue.optional()
-}).describe(
-  "A select dropdown that is automatically populated with available user roles"
-);
+}).meta({
+  description: "A select dropdown that is automatically populated with available user roles",
+  id: "UserRoleField"
+});
 var FieldConfig = import_v43.default.discriminatedUnion("type", [
   FieldGroup,
   Address,
@@ -2078,8 +2259,8 @@ var ApplicationConfig = z20.object({
     })
   ),
   PHONE_NUMBER_PATTERN: z20.string().or(z20.instanceof(RegExp)),
-  USER_NOTIFICATION_DELIVERY_METHOD: z20.string(),
-  INFORMANT_NOTIFICATION_DELIVERY_METHOD: z20.string(),
+  USER_NOTIFICATION_DELIVERY_METHOD: z20.enum(["email", "sms"]),
+  INFORMANT_NOTIFICATION_DELIVERY_METHOD: z20.enum(["email", "sms"]),
   SEARCH_DEFAULT_CRITERIA: SearchCriteria.optional().default("TRACKING_ID"),
   ADDITIONAL_USER_FIELDS: z20.array(FieldConfig).optional().default([])
 });
@@ -2097,8 +2278,8 @@ var BackgroundConfig = z20.object({
 var LoginConfig = z20.object({
   COUNTRY: z20.string(),
   LANGUAGES: z20.array(z20.string()),
-  USER_NOTIFICATION_DELIVERY_METHOD: z20.string(),
-  INFORMANT_NOTIFICATION_DELIVERY_METHOD: z20.string(),
+  USER_NOTIFICATION_DELIVERY_METHOD: z20.enum(["email", "sms"]),
+  INFORMANT_NOTIFICATION_DELIVERY_METHOD: z20.enum(["email", "sms"]),
   PHONE_NUMBER_PATTERN: z20.string().or(z20.instanceof(RegExp)),
   LOGIN_BACKGROUND: BackgroundConfig,
   SENTRY: z20.string().optional()
@@ -2110,6 +2291,7 @@ var ClientConfig = z20.object({
   COUNTRY: z20.string(),
   LANGUAGES: z20.array(z20.string()),
   SENTRY: z20.string().optional(),
+  LOGIN_URL: z20.string().optional(),
   REGISTER_BACKGROUND: BackgroundConfig,
   DASHBOARDS: z20.array(
     z20.object({