@opencrvs/toolkit 2.0.0-rc.fe94e41 → 2.0.0-rc.fedb8b0

package/dist/events/index.js

@@ -75,6 +75,7 @@ __export(events_exports, {
   CheckboxFieldValue: () => CheckboxFieldValue,
   Clause: () => Clause,
   ClientSpecificAction: () => ClientSpecificAction,
+  ComputedDefaultValue: () => ComputedDefaultValue,
   Conditional: () => Conditional,
   ConditionalType: () => ConditionalType,
   ConfirmableActions: () => ConfirmableActions,
@@ -200,6 +201,7 @@ __export(events_exports, {
   SelectDateRangeValue: () => SelectDateRangeValue,
   SelectOption: () => SelectOption,
   ShowConditional: () => ShowConditional,
+  SignatureFieldValue: () => SignatureFieldValue,
   StaticDataEntry: () => StaticDataEntry,
   StreetLevelDetailsUpdateValue: () => StreetLevelDetailsUpdateValue,
   SummaryConfig: () => SummaryConfig,
@@ -246,10 +248,12 @@ __export(events_exports, {
   applyDraftToEventIndex: () => applyDraftToEventIndex,
   areCertificateConditionsMet: () => areCertificateConditionsMet,
   areConditionsMet: () => areConditionsMet,
+  buildClientFunctionContext: () => buildClientFunctionContext,
   buildFormState: () => buildFormState,
   canAccessEventWithScope: () => canAccessEventWithScope,
   canAccessOtherUserWithScopes: () => canAccessOtherUserWithScopes,
   canAccessUserWithScope: () => canAccessUserWithScope,
+  compileClientFunction: () => compileClientFunction,
   compositeFieldTypes: () => compositeFieldTypes,
   createEmptyDraft: () => createEmptyDraft,
   createFieldConditionals: () => createFieldConditionals,
@@ -270,6 +274,7 @@ __export(events_exports, {
   defineWorkqueuesColumns: () => defineWorkqueuesColumns,
   deserializeQuery: () => deserializeQuery,
   errorMessages: () => errorMessages,
+  evaluate: () => evaluate,
   event: () => event,
   eventMetadataLabelMap: () => eventMetadataLabelMap,
   eventPayloadGenerator: () => eventPayloadGenerator,
@@ -348,6 +353,7 @@ __export(events_exports, {
   isBulletListFieldType: () => isBulletListFieldType,
   isButtonFieldType: () => isButtonFieldType,
   isCheckboxFieldType: () => isCheckboxFieldType,
+  isCodeToEvaluate: () => isCodeToEvaluate,
   isConditionMet: () => isConditionMet,
   isCountryFieldType: () => isCountryFieldType,
   isCustomFieldType: () => isCustomFieldType,
@@ -424,11 +430,13 @@ __export(events_exports, {
   resolveDateOfEvent: () => resolveDateOfEvent,
   resolveEventCustomFlags: () => resolveEventCustomFlags,
   resolvePlaceOfEvent: () => resolvePlaceOfEvent,
+  runClientFunction: () => runClientFunction,
   runFieldValidations: () => runFieldValidations,
   runStructuralValidations: () => runStructuralValidations,
   safeUnion: () => safeUnion,
   status: () => status,
   timePeriodToDateRange: () => timePeriodToDateRange,
+  todayISO: () => todayISO,
   user: () => user,
   userCanAccessEventWithScopes: () => userCanAccessEventWithScopes,
   validate: () => validate,
@@ -703,14 +711,20 @@ var unflattenScope = (input) => {
   return { type, options };
 };
 var EncodedScope = z2.string().brand("EncodedScope");
-var decodeScope = (query) => {
-  const scope = qs.parse(query, {
+var decodedScopeCache = /* @__PURE__ */ new Map();
+var decodeScope = (encodedScope) => {
+  if (decodedScopeCache.has(encodedScope)) {
+    return decodedScopeCache.get(encodedScope);
+  }
+  const scope = qs.parse(encodedScope, {
     ignoreQueryPrefix: true,
     comma: true,
     allowDots: true
   });
   const unflattenedScope = unflattenScope(scope);
-  return Scope.safeParse(unflattenedScope)?.data;
+  const result = Scope.safeParse(unflattenedScope)?.data;
+  decodedScopeCache.set(encodedScope, result);
+  return result;
 };
 var DEFAULT_SCOPE_OPTIONS = {
   placeOfEvent: JurisdictionFilter.enum.all,
@@ -1331,7 +1345,7 @@ function plainDateToLocalDate(date) {
 // ../commons/src/events/FieldValue.ts
 var TextValue = z12.string();
 var HiddenFieldValue = z12.string();
-var NonEmptyTextValue = TextValue.min(1);
+var NonEmptyTextValue = z12.string().trim().min(1);
 var DateValue = z12.iso.date().describe("Date in the format YYYY-MM-DD");
 var AgeValue = z12.object({
   age: z12.number(),
@@ -1360,6 +1374,7 @@ var DateRangeFieldValue = z12.object({
 var EmailValue = z12.email();
 var CheckboxFieldValue = z12.boolean();
 var NumberFieldValue = z12.number();
+var SignatureFieldValue = FileFieldValue;
 var ButtonFieldValue = z12.number();
 var VerificationStatusValue = z12.enum([
   "verified",
@@ -2191,8 +2206,21 @@ var FieldReference = import_v43.default.object({
   $$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."
+);
+function isCodeToEvaluate(v) {
+  return !!v && typeof v === "object" && "$$code" in v;
+}
+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.describe(
     "Conditional expression that must hold for the field value to be considered valid."
@@ -2233,7 +2261,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."
@@ -2247,7 +2275,7 @@ var Divider = BaseField.extend({
 });
 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(),
@@ -2260,7 +2288,7 @@ var TextField = BaseField.extend({
 });
 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"),
@@ -2273,7 +2301,7 @@ var NumberField = BaseField.extend({
 });
 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"),
@@ -2307,7 +2335,7 @@ 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")
@@ -2323,14 +2351,14 @@ var EmailField = BaseField.extend({
   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"
@@ -2342,7 +2370,7 @@ var DateField = BaseField.extend({
 });
 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(),
@@ -2354,7 +2382,7 @@ var AgeField = BaseField.extend({
 });
 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(
@@ -2367,7 +2395,7 @@ var TimeField = BaseField.extend({
 });
 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"
@@ -2446,7 +2474,7 @@ var PageHeader = BaseField.extend({
 });
 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"),
@@ -2473,7 +2501,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"),
@@ -2488,7 +2516,7 @@ var NumberWithUnitField = BaseField.extend({
 });
 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({
@@ -2513,7 +2541,7 @@ var BulletList = BaseField.extend({
 });
 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(
     `
@@ -2535,7 +2563,7 @@ var SelectDateRangeOption = import_v43.default.object({
 });
 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")
 }).meta({
   description: "A date range selection field",
@@ -2552,7 +2580,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 },
@@ -2576,14 +2604,14 @@ var NameField = BaseField.extend({
   id: "NameField"
 });
 var PhoneField = BaseField.extend({
-  defaultValue: NonEmptyTextValue.optional(),
+  defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
   type: import_v43.default.literal(FieldType.PHONE)
 }).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)
 }).meta({
   description: "A field for entering an ID",
@@ -2591,14 +2619,14 @@ var IdField = BaseField.extend({
 });
 var Checkbox = BaseField.extend({
   type: import_v43.default.literal(FieldType.CHECKBOX),
-  defaultValue: CheckboxFieldValue.default(false)
+  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."
   )
@@ -2616,7 +2644,7 @@ var AdministrativeAreas = import_v43.default.enum([
 ]);
 var AdministrativeAreaField = BaseField.extend({
   type: import_v43.default.literal(FieldType.ADMINISTRATIVE_AREA),
-  defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
+  defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
   configuration: import_v43.default.object({
     partOf: FieldReference.optional().describe("Parent location"),
     type: AdministrativeAreas,
@@ -2628,7 +2656,7 @@ var AdministrativeAreaField = BaseField.extend({
 });
 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
@@ -2640,7 +2668,7 @@ var LocationInput = BaseField.extend({
 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({
@@ -2656,12 +2684,12 @@ var FileUploadWithOptions = BaseField.extend({
 });
 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({
@@ -2697,7 +2725,7 @@ var Address = BaseField.extend({
     ).optional(),
     allowedLocations: AllowedLocations
   }).optional(),
-  defaultValue: DefaultAddressFieldValue.optional()
+  defaultValue: DefaultAddressFieldValue.or(ComputedDefaultValue).optional()
 }).meta({
   description: "Address input field \u2013 a combination of location and text fields",
   id: "Address"
@@ -2744,7 +2772,7 @@ 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
 }).meta({
   description: "A generic button that can be used to trigger an action",
@@ -2772,7 +2800,7 @@ var AlphaPrintButton = BaseField.extend({
 });
 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."
@@ -2858,7 +2886,7 @@ var LinkButtonField = BaseField.extend({
 });
 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(
@@ -2880,7 +2908,7 @@ var QueryParamReaderField = BaseField.extend({
 });
 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.",
@@ -2893,7 +2921,7 @@ var QrReaderField = BaseField.extend({
 });
 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")
   )
@@ -3452,6 +3480,9 @@ var BaseField3 = z28.object({
   ),
   validations: z28.array(ValidationConfig).optional().describe(
     `Option for overriding the field validations specifically for advanced search form.`
+  ),
+  allowedLocations: JurisdictionReference.optional().describe(
+    `Override the allowedLocations for a location field in advanced search. Use this when the declaration form's allowedLocations references a scope (e.g. record.create) that search-only users don't have \u2014 specify record.search scope instead.`
   )
 });
 var SearchQueryParams = z28.object({
@@ -3526,9 +3557,11 @@ var z30 = __toESM(require("zod/v4"));
 var z29 = __toESM(require("zod/v4"));
 function getDynamicNameValue(field3) {
   const nameConfiguration = field3.configuration?.name;
+  const firstnameRequired = nameConfiguration?.firstname?.required ?? field3.required;
+  const surnameRequired = nameConfiguration?.surname?.required ?? field3.required;
   return z29.object({
-    firstname: nameConfiguration?.firstname?.required ? NonEmptyTextValue : TextValue,
-    surname: nameConfiguration?.surname?.required ? NonEmptyTextValue : TextValue,
+    firstname: firstnameRequired ? NonEmptyTextValue : TextValue,
+    surname: surnameRequired ? NonEmptyTextValue : TextValue,
     middlename: nameConfiguration?.middlename?.required ? NonEmptyTextValue : TextValue.optional()
   });
 }
@@ -3911,7 +3944,37 @@ function resolveDataPath(rootData, dataPath, instancePath) {
   }
   return current;
 }
+function todayISO() {
+  return (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" });
+}
+var compiledFunctionCache = /* @__PURE__ */ new Map();
+function compileClientFunction(code) {
+  let fn = compiledFunctionCache.get(code);
+  if (!fn) {
+    fn = new Function(`return (${code})`)();
+    compiledFunctionCache.set(code, fn);
+  }
+  return fn;
+}
 (0, import_ajv_formats.default)(ajv);
+function buildClientFunctionContext(input) {
+  return {
+    $form: input.form,
+    $now: todayISO(),
+    // eslint-disable-next-line @typescript-eslint/no-use-before-define
+    $online: isOnline(),
+    $user: input.validatorContext?.user,
+    $event: input.validatorContext?.event,
+    $leafAdminStructureLocationIds: input.validatorContext?.leafAdminStructureLocationIds ?? [],
+    user: input.systemVariables?.user,
+    $window: input.systemVariables?.$window,
+    locations: input.locations,
+    adminLevelIds: input.adminLevelIds
+  };
+}
+function runClientFunction(code, data, context) {
+  return compileClientFunction(code)(data, context);
+}
 ajv.addKeyword({
   keyword: "daysFromDate",
   type: "string",
@@ -3956,7 +4019,7 @@ ajv.addKeyword({
   $data: true,
   errors: true,
   // @ts-ignore -- Force type. We will move this away from AJV next. Parsing the array will take seconds and is only called by core.
-  validate(schema, data, _2, dataContext) {
+  validate(_schema, data, _2, dataContext) {
     const locationIdInput = data;
     const locations = dataContext?.rootData.$leafAdminStructureLocationIds ?? [];
     return locations.some((location) => location.id === locationIdInput);
@@ -3987,6 +4050,23 @@ function isAgeValue(value) {
 function mergeWithBaseFormState(values, context) {
   return { ...context.baseFormState, ...values };
 }
+ajv.addKeyword({
+  keyword: "customClientValidator",
+  schemaType: "object",
+  errors: true,
+  // @ts-expect-error -- AJV's public types don't expose `rootData`. All
+  // `validate()` callers build root data via `buildClientFunctionContext`,
+  // so the cast holds.
+  validate(schema, data, _2, dataContext) {
+    return Boolean(
+      runClientFunction(
+        schema.code,
+        data,
+        dataContext?.rootData ?? buildClientFunctionContext({ form: {} })
+      )
+    );
+  }
+});
 function validate(schema, data) {
   const validator = ajv.getSchema(schema.$id) || ajv.compile(schema);
   if ("$form" in data) {
@@ -4023,17 +4103,14 @@ function isOnline() {
   }
   return true;
 }
-function isConditionMet(conditional, values, context, eventIndex) {
-  return validate(conditional, {
-    $form: mergeWithBaseFormState(values, context),
-    $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
-    $online: isOnline(),
-    $user: context.user,
-    $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
-    $flags: eventIndex?.flags ?? [],
-    $status: eventIndex?.status,
-    $event: context.event
-  });
+function isConditionMet(conditional, values, context) {
+  return validate(
+    conditional,
+    buildClientFunctionContext({
+      form: mergeWithBaseFormState(values, context),
+      validatorContext: context
+    })
+  );
 }
 function getConditionalActionsForField(field3, values) {
   if (!field3.conditionals) {
@@ -4041,9 +4118,9 @@ function getConditionalActionsForField(field3, values) {
   }
   return field3.conditionals.filter((conditional) => validate(conditional.conditional, values)).map((conditional) => conditional.type);
 }
-function areConditionsMet(conditions, values, context, event2) {
+function areConditionsMet(conditions, values, context, _event) {
   return conditions.every(
-    (condition) => isConditionMet(condition.conditional, values, context, event2)
+    (condition) => isConditionMet(condition.conditional, values, context)
   );
 }
 function isFieldConditionMet(field3, form, conditionalType, context) {
@@ -4053,14 +4130,13 @@ function isFieldConditionMet(field3, form, conditionalType, context) {
   if (!hasRule) {
     return true;
   }
-  const validConditionals = getConditionalActionsForField(field3, {
-    $form: mergeWithBaseFormState(form, context),
-    $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
-    $online: isOnline(),
-    $user: context.user,
-    $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
-    $event: context.event
-  });
+  const validConditionals = getConditionalActionsForField(
+    field3,
+    buildClientFunctionContext({
+      form: mergeWithBaseFormState(form, context),
+      validatorContext: context
+    })
+  );
   return validConditionals.includes(conditionalType);
 }
 function isFieldVisible(field3, form, context) {
@@ -4086,7 +4162,14 @@ function isActionConditionMet(actionConfig, event2, context, conditionalType) {
   if (!rule) {
     return true;
   }
-  return isConditionMet(rule.conditional, event2.declaration, context, event2);
+  return validate(rule.conditional, {
+    ...buildClientFunctionContext({
+      form: mergeWithBaseFormState(event2.declaration, context),
+      validatorContext: context
+    }),
+    $flags: event2.flags,
+    $status: event2.status
+  });
 }
 function isActionEnabled(actionConfig, event2, context) {
   return isActionConditionMet(
@@ -4245,19 +4328,10 @@ function runFieldValidations({
   if (!isFieldVisible(field3.config, form, context)) {
     return [];
   }
-  const conditionalParameters = {
-    $form: mergeWithBaseFormState(form, context),
-    $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
-    /**
-     * In real use cases, there can be hundreds of thousands of locations.
-     * Make sure that the context contains only the locations that are needed for validation.
-     * E.g. if the user is a leaf admin, only the leaf locations under their admin structure are needed.
-     * Loading few megabytes of locations to memory just for validation is not efficient and will choke the application.
-     */
-    $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
-    $online: isOnline(),
-    $user: context.user
-  };
+  const conditionalParameters = buildClientFunctionContext({
+    form: mergeWithBaseFormState(form, context),
+    validatorContext: context
+  });
   if (isFieldGroupFieldType(field3)) {
     const subfieldErrors = buildFormState(
       field3.config.fields,
@@ -4741,19 +4815,16 @@ function getPendingAction(actions) {
   }
   return pendingActions[0];
 }
-function getCompleteActionAnnotation(annotation, event2, action) {
+function getCompleteActionAnnotation(event2, action) {
   if (action.originalActionId) {
     const originalAction = event2.actions.find(
       ({ id }) => id === action.originalActionId
     );
     if (originalAction?.status === ActionStatus.Requested) {
-      return deepMerge(
-        deepMerge(annotation, originalAction.annotation ?? {}),
-        action.annotation ?? {}
-      );
+      return deepMerge(originalAction.annotation ?? {}, action.annotation ?? {});
     }
   }
-  return deepMerge(annotation, action.annotation ?? {});
+  return action.annotation ?? {};
 }
 function getCompleteActionContent(event2, action) {
   const currentContent = "content" in action ? action.content : void 0;
@@ -4789,7 +4860,7 @@ function getAcceptedActions(event2) {
   return event2.actions.filter(isAcceptedAction).map((action) => ({
     ...action,
     declaration: getCompleteActionDeclaration({}, event2, action),
-    annotation: getCompleteActionAnnotation({}, event2, action)
+    annotation: getCompleteActionAnnotation(event2, action)
   }));
 }
 var EXCLUDED_ACTIONS = [
@@ -5427,7 +5498,54 @@ function createFieldConditionals(fieldId) {
         }
       },
       required: [fieldId]
-    })
+    }),
+    /**
+     * Custom client-side validator. The provided function is serialised and executed
+     * just-in-time on the client only. External references (e.g. lodash) are not
+     * available inside the function body — all logic must be self-contained.
+     *
+     * @example
+     * field('nid').customClientValidator((value) => {
+     *   // LUHN check — all logic must be inline
+     *   const digits = String(value).split('').map(Number)
+     *   // ...
+     *   return isValid
+     * })
+     */
+    customClientValidator(validationFn) {
+      const code = validationFn.toString();
+      return defineFormConditional({
+        type: "object",
+        properties: wrapToPath(
+          { [fieldId]: { customClientValidator: { code } } },
+          this.$$subfield
+        ),
+        required: [fieldId]
+      });
+    },
+    /**
+     * Custom client-side evaluation. Returns a {@link FieldReference} descriptor
+     * that can be used as the `value` property or a DATA component entry.
+     * The function receives the referenced field's value as the first argument and
+     * the full form context as the second; its return value replaces the field reference.
+     * The function is serialised and executed just-in-time on the client only.
+     * External references (e.g. lodash) are not available inside the function body.
+     *
+     * For computing a default value without referencing a specific field, use
+     * `evaluate(fn)` in the `defaultValue` property instead.
+     *
+     * @example
+     * field('a').customClientEvaluation((aValue, ctx) =>
+     *   Number(aValue) + Number(ctx.$form.b)
+     * )
+     */
+    customClientEvaluation(computationFn) {
+      return {
+        $$code: computationFn.toString(),
+        $$field: fieldId,
+        $$subfield: this.$$subfield
+      };
+    }
   };
 }
 
@@ -6381,7 +6499,7 @@ function getActionUpdateMetadata(actions) {
     "createdAtLocation",
     "createdByRole"
   ];
-  return actions.filter(({ type }) => updateActions.safeParse(type).success).filter(({ status: status2 }) => status2 === ActionStatus.Accepted).reduce(
+  return actions.filter(({ type }) => updateActions.safeParse(type).success).reduce(
     (_2, action) => {
       if (action.originalActionId) {
         const originalAction = actions.find(({ id }) => id === action.originalActionId) ?? action;
@@ -6786,7 +6904,7 @@ function getActionAnnotation({
   const action = (0, import_lodash4.findLast)(activeActions, (a) => a.type === actionType);
   const actionWithCompleteAnnotation = action && {
     ...action,
-    annotation: getCompleteActionAnnotation({}, event2, action)
+    annotation: getCompleteActionAnnotation(event2, action)
   };
   const matchingDraft = draft?.action.type === actionType ? draft : void 0;
   const sortedActions = (0, import_lodash4.orderBy)(
@@ -6858,6 +6976,9 @@ function createFieldConfig(fieldId, options) {
 }
 
 // ../commons/src/events/field.ts
+function evaluate(computationFn) {
+  return { $$code: computationFn.toString() };
+}
 function field(fieldId, options = {}) {
   return {
     ...createFieldConditionals(fieldId),