@fieldia/core 0.23.0 → 0.25.0

package/src/lib/format/field.d.ts

@@ -122,16 +122,21 @@ export declare const MoneyLookSchema: z.ZodObject<{
     home: z.ZodOptional<z.ZodString>;
     per: z.ZodOptional<z.ZodArray<z.ZodObject<{
         period: z.ZodEnum<{
+            year: "year";
+            month: "month";
             day: "day";
             night: "night";
             week: "week";
-            month: "month";
-            year: "year";
         }>;
         when: z.ZodOptional<z.ZodString>;
     }, z.z.core.$strict>>>;
 }, z.z.core.$strict>;
 export type MoneyLook = z.infer<typeof MoneyLookSchema>;
+/**
+ * A time zone by its IANA name: "Africa/Cairo", "Europe/Berlin", "UTC". A page's (`timeZone`) is the zone its dates
+ * and times are in; a date and time field may name its own — a flight's departure, in its airport's zone.
+ */
+export declare const TimeZoneSchema: z.ZodString & z.ZodType<string, string, z.z.core.$ZodTypeInternals<string, string>>;
 /**
  * Choices the app gives rather than the page: its list by name, loaded through
  * the data source's `options` when the form shows the field, and again when a
@@ -163,6 +168,242 @@ export declare const ShrinkSchema: z.ZodUnion<readonly [z.ZodLiteral<false>, z.Z
     quality: z.ZodOptional<z.ZodNumber>;
 }, z.z.core.$strict>]>;
 export type Shrink = z.infer<typeof ShrinkSchema>;
+/**
+ * The fields of the records a many2many links to, for a table of them: its
+ * node's `columns` name them, and the data source reads their values. Plain
+ * values only — text, numbers, money, yes or no, dates, choices and links.
+ * A related list's records' fields are the same (`RelatedNode.fields`).
+ */
+export declare const LinkedFieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    size: z.ZodOptional<z.ZodInt>;
+    pattern: z.ZodOptional<z.ZodString>;
+    patternHint: z.ZodOptional<z.ZodString>;
+    label: z.ZodString;
+    help: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    readonly: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodJSONSchema>;
+    defaultFrom: z.ZodOptional<z.ZodString>;
+    compute: z.ZodOptional<z.ZodString>;
+    setWhen: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        when: z.ZodOptional<z.ZodString>;
+        value: z.ZodString;
+        on: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.z.core.$strict>>>;
+    type: z.ZodLiteral<"char">;
+}, z.z.core.$strict>, z.ZodObject<{
+    size: z.ZodOptional<z.ZodInt>;
+    label: z.ZodString;
+    help: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    readonly: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodJSONSchema>;
+    defaultFrom: z.ZodOptional<z.ZodString>;
+    compute: z.ZodOptional<z.ZodString>;
+    setWhen: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        when: z.ZodOptional<z.ZodString>;
+        value: z.ZodString;
+        on: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.z.core.$strict>>>;
+    type: z.ZodLiteral<"text">;
+}, z.z.core.$strict>, z.ZodObject<{
+    min: z.ZodOptional<z.ZodNumber>;
+    max: z.ZodOptional<z.ZodNumber>;
+    label: z.ZodString;
+    help: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    readonly: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodJSONSchema>;
+    defaultFrom: z.ZodOptional<z.ZodString>;
+    compute: z.ZodOptional<z.ZodString>;
+    setWhen: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        when: z.ZodOptional<z.ZodString>;
+        value: z.ZodString;
+        on: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.z.core.$strict>>>;
+    type: z.ZodLiteral<"integer">;
+}, z.z.core.$strict>, z.ZodObject<{
+    min: z.ZodOptional<z.ZodNumber>;
+    max: z.ZodOptional<z.ZodNumber>;
+    digits: z.ZodOptional<z.ZodTuple<[z.ZodInt, z.ZodInt], null>>;
+    label: z.ZodString;
+    help: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    readonly: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodJSONSchema>;
+    defaultFrom: z.ZodOptional<z.ZodString>;
+    compute: z.ZodOptional<z.ZodString>;
+    setWhen: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        when: z.ZodOptional<z.ZodString>;
+        value: z.ZodString;
+        on: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.z.core.$strict>>>;
+    type: z.ZodLiteral<"float">;
+}, z.z.core.$strict>, z.ZodObject<{
+    currencyField: z.ZodOptional<z.ZodString>;
+    currency: z.ZodOptional<z.ZodString>;
+    min: z.ZodOptional<z.ZodNumber>;
+    max: z.ZodOptional<z.ZodNumber>;
+    digits: z.ZodOptional<z.ZodTuple<[z.ZodInt, z.ZodInt], null>>;
+    money: z.ZodOptional<z.ZodObject<{
+        currency: z.ZodOptional<z.ZodEnum<{
+            symbol: "symbol";
+            code: "code";
+        }>>;
+        at: z.ZodOptional<z.ZodEnum<{
+            before: "before";
+            after: "after";
+        }>>;
+        short: z.ZodOptional<z.ZodBoolean>;
+        home: z.ZodOptional<z.ZodString>;
+        per: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            period: z.ZodEnum<{
+                year: "year";
+                month: "month";
+                day: "day";
+                night: "night";
+                week: "week";
+            }>;
+            when: z.ZodOptional<z.ZodString>;
+        }, z.z.core.$strict>>>;
+    }, z.z.core.$strict>>;
+    label: z.ZodString;
+    help: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    readonly: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodJSONSchema>;
+    defaultFrom: z.ZodOptional<z.ZodString>;
+    compute: z.ZodOptional<z.ZodString>;
+    setWhen: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        when: z.ZodOptional<z.ZodString>;
+        value: z.ZodString;
+        on: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.z.core.$strict>>>;
+    type: z.ZodLiteral<"monetary">;
+}, z.z.core.$strict>, z.ZodObject<{
+    label: z.ZodString;
+    help: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    readonly: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodJSONSchema>;
+    defaultFrom: z.ZodOptional<z.ZodString>;
+    compute: z.ZodOptional<z.ZodString>;
+    setWhen: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        when: z.ZodOptional<z.ZodString>;
+        value: z.ZodString;
+        on: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.z.core.$strict>>>;
+    type: z.ZodLiteral<"boolean">;
+}, z.z.core.$strict>, z.ZodObject<{
+    min: z.ZodOptional<z.ZodString>;
+    max: z.ZodOptional<z.ZodString>;
+    days: z.ZodOptional<z.ZodArray<z.ZodInt>>;
+    label: z.ZodString;
+    help: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    readonly: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodJSONSchema>;
+    defaultFrom: z.ZodOptional<z.ZodString>;
+    compute: z.ZodOptional<z.ZodString>;
+    setWhen: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        when: z.ZodOptional<z.ZodString>;
+        value: z.ZodString;
+        on: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.z.core.$strict>>>;
+    type: z.ZodLiteral<"date">;
+}, z.z.core.$strict>, z.ZodObject<{
+    timeZone: z.ZodOptional<z.ZodString & z.ZodType<string, string, z.z.core.$ZodTypeInternals<string, string>>>;
+    min: z.ZodOptional<z.ZodString>;
+    max: z.ZodOptional<z.ZodString>;
+    days: z.ZodOptional<z.ZodArray<z.ZodInt>>;
+    label: z.ZodString;
+    help: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    readonly: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodJSONSchema>;
+    defaultFrom: z.ZodOptional<z.ZodString>;
+    compute: z.ZodOptional<z.ZodString>;
+    setWhen: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        when: z.ZodOptional<z.ZodString>;
+        value: z.ZodString;
+        on: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.z.core.$strict>>>;
+    type: z.ZodLiteral<"datetime">;
+}, z.z.core.$strict>, z.ZodObject<{
+    options: z.ZodArray<z.ZodObject<{
+        value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+        label: z.ZodString;
+        image: z.ZodOptional<z.ZodString>;
+        score: z.ZodOptional<z.ZodNumber>;
+        alt: z.ZodOptional<z.ZodString>;
+        exclusive: z.ZodOptional<z.ZodBoolean>;
+        fixed: z.ZodOptional<z.ZodBoolean>;
+    }, z.z.core.$strict>>;
+    optionsFrom: z.ZodOptional<z.ZodNever>;
+    multiple: z.ZodOptional<z.ZodBoolean>;
+    other: z.ZodOptional<z.ZodBoolean>;
+    ownAnswers: z.ZodOptional<z.ZodBoolean>;
+    label: z.ZodString;
+    help: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    readonly: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodJSONSchema>;
+    defaultFrom: z.ZodOptional<z.ZodString>;
+    compute: z.ZodOptional<z.ZodString>;
+    setWhen: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        when: z.ZodOptional<z.ZodString>;
+        value: z.ZodString;
+        on: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.z.core.$strict>>>;
+    type: z.ZodLiteral<"selection">;
+}, z.z.core.$strict>, z.ZodObject<{
+    relation: z.ZodString;
+    filter: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        field: z.ZodString;
+        op: z.ZodEnum<{
+            set: "set";
+            "=": "=";
+            "!=": "!=";
+            "<": "<";
+            ">": ">";
+            "<=": "<=";
+            ">=": ">=";
+            in: "in";
+            "not in": "not in";
+            like: "like";
+            ilike: "ilike";
+            startswith: "startswith";
+            endswith: "endswith";
+            notset: "notset";
+            between: "between";
+            contains: "contains";
+            "not contains": "not contains";
+            "=?": "=?";
+            within: "within";
+        }>;
+        value: z.ZodOptional<z.ZodJSONSchema>;
+        valueFrom: z.ZodOptional<z.ZodString>;
+    }, z.z.core.$strict>, z.ZodObject<{
+        any: z.ZodArray<typeof FilterItemSchema>;
+    }, z.z.core.$strict>, z.ZodObject<{
+        all: z.ZodArray<typeof FilterItemSchema>;
+    }, z.z.core.$strict>]>>>;
+    createValues: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    label: z.ZodString;
+    help: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    readonly: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodJSONSchema>;
+    defaultFrom: z.ZodOptional<z.ZodString>;
+    compute: z.ZodOptional<z.ZodString>;
+    setWhen: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        when: z.ZodOptional<z.ZodString>;
+        value: z.ZodString;
+        on: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.z.core.$strict>>>;
+    type: z.ZodLiteral<"many2one">;
+}, z.z.core.$strict>], "type">;
+export type LinkedField = z.infer<typeof LinkedFieldSchema>;
 /** One property of a properties field: its own small field, edited with the widget for its type. */
 export declare const PropertyDefinitionSchema: z.ZodObject<{
     name: z.ZodString;
@@ -298,11 +539,11 @@ export declare const LineFieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         home: z.ZodOptional<z.ZodString>;
         per: z.ZodOptional<z.ZodArray<z.ZodObject<{
             period: z.ZodEnum<{
+                year: "year";
+                month: "month";
                 day: "day";
                 night: "night";
                 week: "week";
-                month: "month";
-                year: "year";
             }>;
             when: z.ZodOptional<z.ZodString>;
         }, z.z.core.$strict>>>;
@@ -352,6 +593,7 @@ export declare const LineFieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.z.core.$strict>>>;
     type: z.ZodLiteral<"date">;
 }, z.z.core.$strict>, z.ZodObject<{
+    timeZone: z.ZodOptional<z.ZodString & z.ZodType<string, string, z.z.core.$ZodTypeInternals<string, string>>>;
     min: z.ZodOptional<z.ZodString>;
     max: z.ZodOptional<z.ZodString>;
     days: z.ZodOptional<z.ZodArray<z.ZodInt>>;
@@ -603,11 +845,11 @@ export declare const LineFieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             home: z.ZodOptional<z.ZodString>;
             per: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 period: z.ZodEnum<{
+                    year: "year";
+                    month: "month";
                     day: "day";
                     night: "night";
                     week: "week";
-                    month: "month";
-                    year: "year";
                 }>;
                 when: z.ZodOptional<z.ZodString>;
             }, z.z.core.$strict>>>;
@@ -657,6 +899,7 @@ export declare const LineFieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         }, z.z.core.$strict>>>;
         type: z.ZodLiteral<"date">;
     }, z.z.core.$strict>, z.ZodObject<{
+        timeZone: z.ZodOptional<z.ZodString & z.ZodType<string, string, z.z.core.$ZodTypeInternals<string, string>>>;
         min: z.ZodOptional<z.ZodString>;
         max: z.ZodOptional<z.ZodString>;
         days: z.ZodOptional<z.ZodArray<z.ZodInt>>;
@@ -937,11 +1180,11 @@ export declare const LineFieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             home: z.ZodOptional<z.ZodString>;
             per: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 period: z.ZodEnum<{
+                    year: "year";
+                    month: "month";
                     day: "day";
                     night: "night";
                     week: "week";
-                    month: "month";
-                    year: "year";
                 }>;
                 when: z.ZodOptional<z.ZodString>;
             }, z.z.core.$strict>>>;
@@ -991,6 +1234,7 @@ export declare const LineFieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         }, z.z.core.$strict>>>;
         type: z.ZodLiteral<"date">;
     }, z.z.core.$strict>, z.ZodObject<{
+        timeZone: z.ZodOptional<z.ZodString & z.ZodType<string, string, z.z.core.$ZodTypeInternals<string, string>>>;
         min: z.ZodOptional<z.ZodString>;
         max: z.ZodOptional<z.ZodString>;
         days: z.ZodOptional<z.ZodArray<z.ZodInt>>;
@@ -1242,11 +1486,11 @@ export declare const LineFieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 home: z.ZodOptional<z.ZodString>;
                 per: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     period: z.ZodEnum<{
+                        year: "year";
+                        month: "month";
                         day: "day";
                         night: "night";
                         week: "week";
-                        month: "month";
-                        year: "year";
                     }>;
                     when: z.ZodOptional<z.ZodString>;
                 }, z.z.core.$strict>>>;
@@ -1296,6 +1540,7 @@ export declare const LineFieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             }, z.z.core.$strict>>>;
             type: z.ZodLiteral<"date">;
         }, z.z.core.$strict>, z.ZodObject<{
+            timeZone: z.ZodOptional<z.ZodString & z.ZodType<string, string, z.z.core.$ZodTypeInternals<string, string>>>;
             min: z.ZodOptional<z.ZodString>;
             max: z.ZodOptional<z.ZodString>;
             days: z.ZodOptional<z.ZodArray<z.ZodInt>>;
@@ -1604,11 +1849,11 @@ export declare const FieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         home: z.ZodOptional<z.ZodString>;
         per: z.ZodOptional<z.ZodArray<z.ZodObject<{
             period: z.ZodEnum<{
+                year: "year";
+                month: "month";
                 day: "day";
                 night: "night";
                 week: "week";
-                month: "month";
-                year: "year";
             }>;
             when: z.ZodOptional<z.ZodString>;
         }, z.z.core.$strict>>>;
@@ -1658,6 +1903,7 @@ export declare const FieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.z.core.$strict>>>;
     type: z.ZodLiteral<"date">;
 }, z.z.core.$strict>, z.ZodObject<{
+    timeZone: z.ZodOptional<z.ZodString & z.ZodType<string, string, z.z.core.$ZodTypeInternals<string, string>>>;
     min: z.ZodOptional<z.ZodString>;
     max: z.ZodOptional<z.ZodString>;
     days: z.ZodOptional<z.ZodArray<z.ZodInt>>;
@@ -1912,11 +2158,11 @@ export declare const FieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             home: z.ZodOptional<z.ZodString>;
             per: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 period: z.ZodEnum<{
+                    year: "year";
+                    month: "month";
                     day: "day";
                     night: "night";
                     week: "week";
-                    month: "month";
-                    year: "year";
                 }>;
                 when: z.ZodOptional<z.ZodString>;
             }, z.z.core.$strict>>>;
@@ -1966,6 +2212,7 @@ export declare const FieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         }, z.z.core.$strict>>>;
         type: z.ZodLiteral<"date">;
     }, z.z.core.$strict>, z.ZodObject<{
+        timeZone: z.ZodOptional<z.ZodString & z.ZodType<string, string, z.z.core.$ZodTypeInternals<string, string>>>;
         min: z.ZodOptional<z.ZodString>;
         max: z.ZodOptional<z.ZodString>;
         days: z.ZodOptional<z.ZodArray<z.ZodInt>>;
@@ -2169,11 +2416,11 @@ export declare const FieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             home: z.ZodOptional<z.ZodString>;
             per: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 period: z.ZodEnum<{
+                    year: "year";
+                    month: "month";
                     day: "day";
                     night: "night";
                     week: "week";
-                    month: "month";
-                    year: "year";
                 }>;
                 when: z.ZodOptional<z.ZodString>;
             }, z.z.core.$strict>>>;
@@ -2223,6 +2470,7 @@ export declare const FieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         }, z.z.core.$strict>>>;
         type: z.ZodLiteral<"date">;
     }, z.z.core.$strict>, z.ZodObject<{
+        timeZone: z.ZodOptional<z.ZodString & z.ZodType<string, string, z.z.core.$ZodTypeInternals<string, string>>>;
         min: z.ZodOptional<z.ZodString>;
         max: z.ZodOptional<z.ZodString>;
         days: z.ZodOptional<z.ZodArray<z.ZodInt>>;
@@ -2474,11 +2722,11 @@ export declare const FieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 home: z.ZodOptional<z.ZodString>;
                 per: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     period: z.ZodEnum<{
+                        year: "year";
+                        month: "month";
                         day: "day";
                         night: "night";
                         week: "week";
-                        month: "month";
-                        year: "year";
                     }>;
                     when: z.ZodOptional<z.ZodString>;
                 }, z.z.core.$strict>>>;
@@ -2528,6 +2776,7 @@ export declare const FieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             }, z.z.core.$strict>>>;
             type: z.ZodLiteral<"date">;
         }, z.z.core.$strict>, z.ZodObject<{
+            timeZone: z.ZodOptional<z.ZodString & z.ZodType<string, string, z.z.core.$ZodTypeInternals<string, string>>>;
             min: z.ZodOptional<z.ZodString>;
             max: z.ZodOptional<z.ZodString>;
             days: z.ZodOptional<z.ZodArray<z.ZodInt>>;
@@ -2808,11 +3057,11 @@ export declare const FieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 home: z.ZodOptional<z.ZodString>;
                 per: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     period: z.ZodEnum<{
+                        year: "year";
+                        month: "month";
                         day: "day";
                         night: "night";
                         week: "week";
-                        month: "month";
-                        year: "year";
                     }>;
                     when: z.ZodOptional<z.ZodString>;
                 }, z.z.core.$strict>>>;
@@ -2862,6 +3111,7 @@ export declare const FieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             }, z.z.core.$strict>>>;
             type: z.ZodLiteral<"date">;
         }, z.z.core.$strict>, z.ZodObject<{
+            timeZone: z.ZodOptional<z.ZodString & z.ZodType<string, string, z.z.core.$ZodTypeInternals<string, string>>>;
             min: z.ZodOptional<z.ZodString>;
             max: z.ZodOptional<z.ZodString>;
             days: z.ZodOptional<z.ZodArray<z.ZodInt>>;
@@ -3113,11 +3363,11 @@ export declare const FieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     home: z.ZodOptional<z.ZodString>;
                     per: z.ZodOptional<z.ZodArray<z.ZodObject<{
                         period: z.ZodEnum<{
+                            year: "year";
+                            month: "month";
                             day: "day";
                             night: "night";
                             week: "week";
-                            month: "month";
-                            year: "year";
                         }>;
                         when: z.ZodOptional<z.ZodString>;
                     }, z.z.core.$strict>>>;
@@ -3167,6 +3417,7 @@ export declare const FieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 }, z.z.core.$strict>>>;
                 type: z.ZodLiteral<"date">;
             }, z.z.core.$strict>, z.ZodObject<{
+                timeZone: z.ZodOptional<z.ZodString & z.ZodType<string, string, z.z.core.$ZodTypeInternals<string, string>>>;
                 min: z.ZodOptional<z.ZodString>;
                 max: z.ZodOptional<z.ZodString>;
                 days: z.ZodOptional<z.ZodArray<z.ZodInt>>;
@@ -3596,11 +3847,11 @@ export declare const FieldsSchema: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUn
         home: z.ZodOptional<z.ZodString>;
         per: z.ZodOptional<z.ZodArray<z.ZodObject<{
             period: z.ZodEnum<{
+                year: "year";
+                month: "month";
                 day: "day";
                 night: "night";
                 week: "week";
-                month: "month";
-                year: "year";
             }>;
             when: z.ZodOptional<z.ZodString>;
         }, z.z.core.$strict>>>;
@@ -3650,6 +3901,7 @@ export declare const FieldsSchema: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUn
     }, z.z.core.$strict>>>;
     type: z.ZodLiteral<"date">;
 }, z.z.core.$strict>, z.ZodObject<{
+    timeZone: z.ZodOptional<z.ZodString & z.ZodType<string, string, z.z.core.$ZodTypeInternals<string, string>>>;
     min: z.ZodOptional<z.ZodString>;
     max: z.ZodOptional<z.ZodString>;
     days: z.ZodOptional<z.ZodArray<z.ZodInt>>;
@@ -3904,11 +4156,11 @@ export declare const FieldsSchema: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUn
             home: z.ZodOptional<z.ZodString>;
             per: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 period: z.ZodEnum<{
+                    year: "year";
+                    month: "month";
                     day: "day";
                     night: "night";
                     week: "week";
-                    month: "month";
-                    year: "year";
                 }>;
                 when: z.ZodOptional<z.ZodString>;
             }, z.z.core.$strict>>>;
@@ -3958,6 +4210,7 @@ export declare const FieldsSchema: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUn
         }, z.z.core.$strict>>>;
         type: z.ZodLiteral<"date">;
     }, z.z.core.$strict>, z.ZodObject<{
+        timeZone: z.ZodOptional<z.ZodString & z.ZodType<string, string, z.z.core.$ZodTypeInternals<string, string>>>;
         min: z.ZodOptional<z.ZodString>;
         max: z.ZodOptional<z.ZodString>;
         days: z.ZodOptional<z.ZodArray<z.ZodInt>>;
@@ -4161,11 +4414,11 @@ export declare const FieldsSchema: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUn
             home: z.ZodOptional<z.ZodString>;
             per: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 period: z.ZodEnum<{
+                    year: "year";
+                    month: "month";
                     day: "day";
                     night: "night";
                     week: "week";
-                    month: "month";
-                    year: "year";
                 }>;
                 when: z.ZodOptional<z.ZodString>;
             }, z.z.core.$strict>>>;
@@ -4215,6 +4468,7 @@ export declare const FieldsSchema: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUn
         }, z.z.core.$strict>>>;
         type: z.ZodLiteral<"date">;
     }, z.z.core.$strict>, z.ZodObject<{
+        timeZone: z.ZodOptional<z.ZodString & z.ZodType<string, string, z.z.core.$ZodTypeInternals<string, string>>>;
         min: z.ZodOptional<z.ZodString>;
         max: z.ZodOptional<z.ZodString>;
         days: z.ZodOptional<z.ZodArray<z.ZodInt>>;
@@ -4466,11 +4720,11 @@ export declare const FieldsSchema: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUn
                 home: z.ZodOptional<z.ZodString>;
                 per: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     period: z.ZodEnum<{
+                        year: "year";
+                        month: "month";
                         day: "day";
                         night: "night";
                         week: "week";
-                        month: "month";
-                        year: "year";
                     }>;
                     when: z.ZodOptional<z.ZodString>;
                 }, z.z.core.$strict>>>;
@@ -4520,6 +4774,7 @@ export declare const FieldsSchema: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUn
             }, z.z.core.$strict>>>;
             type: z.ZodLiteral<"date">;
         }, z.z.core.$strict>, z.ZodObject<{
+            timeZone: z.ZodOptional<z.ZodString & z.ZodType<string, string, z.z.core.$ZodTypeInternals<string, string>>>;
             min: z.ZodOptional<z.ZodString>;
             max: z.ZodOptional<z.ZodString>;
             days: z.ZodOptional<z.ZodArray<z.ZodInt>>;
@@ -4800,11 +5055,11 @@ export declare const FieldsSchema: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUn
                 home: z.ZodOptional<z.ZodString>;
                 per: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     period: z.ZodEnum<{
+                        year: "year";
+                        month: "month";
                         day: "day";
                         night: "night";
                         week: "week";
-                        month: "month";
-                        year: "year";
                     }>;
                     when: z.ZodOptional<z.ZodString>;
                 }, z.z.core.$strict>>>;
@@ -4854,6 +5109,7 @@ export declare const FieldsSchema: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUn
             }, z.z.core.$strict>>>;
             type: z.ZodLiteral<"date">;
         }, z.z.core.$strict>, z.ZodObject<{
+            timeZone: z.ZodOptional<z.ZodString & z.ZodType<string, string, z.z.core.$ZodTypeInternals<string, string>>>;
             min: z.ZodOptional<z.ZodString>;
             max: z.ZodOptional<z.ZodString>;
             days: z.ZodOptional<z.ZodArray<z.ZodInt>>;
@@ -5105,11 +5361,11 @@ export declare const FieldsSchema: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUn
                     home: z.ZodOptional<z.ZodString>;
                     per: z.ZodOptional<z.ZodArray<z.ZodObject<{
                         period: z.ZodEnum<{
+                            year: "year";
+                            month: "month";
                             day: "day";
                             night: "night";
                             week: "week";
-                            month: "month";
-                            year: "year";
                         }>;
                         when: z.ZodOptional<z.ZodString>;
                     }, z.z.core.$strict>>>;
@@ -5159,6 +5415,7 @@ export declare const FieldsSchema: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUn
                 }, z.z.core.$strict>>>;
                 type: z.ZodLiteral<"date">;
             }, z.z.core.$strict>, z.ZodObject<{
+                timeZone: z.ZodOptional<z.ZodString & z.ZodType<string, string, z.z.core.$ZodTypeInternals<string, string>>>;
                 min: z.ZodOptional<z.ZodString>;
                 max: z.ZodOptional<z.ZodString>;
                 days: z.ZodOptional<z.ZodArray<z.ZodInt>>;

package/src/lib/format/field.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FieldsSchema = exports.FieldSchema = exports.LineKindsSchema = exports.LineFieldSchema = exports.DefinitionsFromSchema = exports.PropertyDefinitionSchema = exports.ShrinkSchema = exports.OptionsFromSchema = exports.MoneyLookSchema = exports.PERIODS = exports.SetWhenSchema = exports.FilterItemSchema = exports.FilterAllSchema = exports.FilterAnySchema = exports.FilterConditionSchema = exports.OptionSchema = exports.FIELD_TYPES = exports.FIELD_NAME = void 0;
+exports.FieldsSchema = exports.FieldSchema = exports.LineKindsSchema = exports.LineFieldSchema = exports.DefinitionsFromSchema = exports.PropertyDefinitionSchema = exports.LinkedFieldSchema = exports.ShrinkSchema = exports.OptionsFromSchema = exports.TimeZoneSchema = exports.MoneyLookSchema = exports.PERIODS = exports.SetWhenSchema = exports.FilterItemSchema = exports.FilterAllSchema = exports.FilterAnySchema = exports.FilterConditionSchema = exports.OptionSchema = exports.FIELD_TYPES = exports.FIELD_NAME = void 0;
 const z = require("zod");
 const json_1 = require("./json");
+const zones_1 = require("../record/zones");
 /**
  * Field definitions: what a page knows about each value it shows or collects.
  *
@@ -208,7 +209,20 @@ const BooleanField = z.object({ type: z.literal('boolean'), ...common }).strict(
 const dayLimit = z.string().regex(/^(\d{4}-\d{2}-\d{2}|today([+-]\d{1,4})?)$/).optional();
 const days = { min: dayLimit, max: dayLimit, days: z.array(z.int().min(1).max(7)).min(1).optional() };
 const DateField = z.object({ type: z.literal('date'), ...common, ...days }).strict();
-const DateTime = z.object({ type: z.literal('datetime'), ...common, ...days }).strict();
+/**
+ * A time zone by its IANA name: "Africa/Cairo", "Europe/Berlin", "UTC". A page's (`timeZone`) is the zone its dates
+ * and times are in; a date and time field may name its own — a flight's departure, in its airport's zone.
+ */
+exports.TimeZoneSchema = z
+    .string()
+    .regex(/^[A-Za-z][\w+-]*(\/[\w+-]+)*$/, { error: 'a time zone is named as the IANA names it: "Africa/Cairo", "Europe/Berlin", "UTC"', abort: true })
+    .refine(zones_1.isTimeZone, { message: 'not a time zone the IANA names: "Africa/Cairo", "Europe/Berlin", "UTC"' })
+    .meta({ id: 'TimeZone', description: 'A time zone by its IANA name: its dates and times are shown and typed on that zone\'s clock.', examples: ['Africa/Cairo', 'Europe/Berlin', 'America/New_York', 'UTC'] });
+/**
+ * A date and time, kept as an instant. With `timeZone`, it is shown and typed on that zone's clock, and its limits
+ * kept by the day it falls on there; else on the page's zone's (`timeZone`), else on the browser's.
+ */
+const DateTime = z.object({ type: z.literal('datetime'), ...common, ...days, timeZone: exports.TimeZoneSchema.optional() }).strict();
 /**
  * Choices the app gives rather than the page: its list by name, loaded through
  * the data source's `options` when the form shows the field, and again when a
@@ -307,12 +321,13 @@ const Many2one = z.object({ type: z.literal('many2one'), ...common, relation, fi
  * The fields of the records a many2many links to, for a table of them: its
  * node's `columns` name them, and the data source reads their values. Plain
  * values only — text, numbers, money, yes or no, dates, choices and links.
+ * A related list's records' fields are the same (`RelatedNode.fields`).
  */
-const LinkedFieldSchema = z
+exports.LinkedFieldSchema = z
     .discriminatedUnion('type', [Char, Text, Integer, Float, Monetary, BooleanField, DateField, DateTime, LineSelection, Many2one])
     .meta({ id: 'LinkedField' });
 const Many2many = z
-    .object({ type: z.literal('many2many'), ...common, relation, filter, createValues, fields: z.record(z.string().regex(names_1.FIELD_NAME), LinkedFieldSchema).optional() })
+    .object({ type: z.literal('many2many'), ...common, relation, filter, createValues, fields: z.record(z.string().regex(names_1.FIELD_NAME), exports.LinkedFieldSchema).optional() })
     .strict();
 const Reference = z
     .object({ type: z.literal('reference'), ...common, models: z.array(exports.OptionSchema).min(1) })