@fieldia/core 0.18.0 → 0.19.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fieldia/core",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "Headless form model for Fieldia: the page format, modifiers, validation and record state. No DOM.",
   "license": "MIT",
   "homepage": "https://fieldia.dev",

package/schema/page.schema.json

@@ -294,6 +294,14 @@
             }
           },
           "additionalProperties": false
+        },
+        "skin": {
+          "type": "string",
+          "enum": [
+            "underline",
+            "outlined",
+            "quiet"
+          ]
         }
       },
       "additionalProperties": false
@@ -666,6 +674,9 @@
               "items": false,
               "minItems": 2,
               "maxItems": 2
+            },
+            "money": {
+              "$ref": "#/$defs/MoneyLook"
             }
           },
           "required": [
@@ -1599,6 +1610,60 @@
         }
       ]
     },
+    "MoneyLook": {
+      "type": "object",
+      "properties": {
+        "currency": {
+          "type": "string",
+          "enum": [
+            "symbol",
+            "code"
+          ]
+        },
+        "at": {
+          "type": "string",
+          "enum": [
+            "before",
+            "after"
+          ]
+        },
+        "short": {
+          "type": "boolean"
+        },
+        "home": {
+          "type": "string",
+          "pattern": "^[A-Z]{3}$"
+        },
+        "per": {
+          "minItems": 1,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "period": {
+                "type": "string",
+                "enum": [
+                  "day",
+                  "night",
+                  "week",
+                  "month",
+                  "year"
+                ]
+              },
+              "when": {
+                "type": "string",
+                "minLength": 1
+              }
+            },
+            "required": [
+              "period"
+            ],
+            "additionalProperties": false
+          }
+        }
+      },
+      "additionalProperties": false
+    },
     "Option": {
       "type": "object",
       "properties": {
@@ -2034,6 +2099,9 @@
               "items": false,
               "minItems": 2,
               "maxItems": 2
+            },
+            "money": {
+              "$ref": "#/$defs/MoneyLook"
             }
           },
           "required": [
@@ -2673,6 +2741,9 @@
               "items": false,
               "minItems": 2,
               "maxItems": 2
+            },
+            "money": {
+              "$ref": "#/$defs/MoneyLook"
             }
           },
           "required": [
@@ -3844,6 +3915,9 @@
               "items": false,
               "minItems": 2,
               "maxItems": 2
+            },
+            "money": {
+              "$ref": "#/$defs/MoneyLook"
             }
           },
           "required": [
@@ -5752,6 +5826,13 @@
         },
         "required": {
           "$ref": "#/$defs/Modifier"
+        },
+        "quiet": {
+          "type": "boolean"
+        },
+        "readonlyReason": {
+          "type": "string",
+          "minLength": 1
         }
       },
       "required": [
@@ -7024,6 +7105,13 @@
           "items": {
             "$ref": "#/$defs/LayoutNode"
           }
+        },
+        "quiet": {
+          "type": "boolean"
+        },
+        "readonlyReason": {
+          "type": "string",
+          "minLength": 1
         }
       },
       "required": [
@@ -7326,6 +7414,9 @@
         "widget": {
           "type": "string",
           "minLength": 1
+        },
+        "money": {
+          "$ref": "#/$defs/MoneyLook"
         }
       },
       "additionalProperties": false
@@ -7345,14 +7436,95 @@
           "minItems": 1,
           "type": "array",
           "items": {
-            "type": "string",
-            "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
+            "anyOf": [
+              {
+                "$ref": "#/$defs/CardPart"
+              },
+              {
+                "minItems": 1,
+                "type": "array",
+                "items": {
+                  "$ref": "#/$defs/CardPart"
+                }
+              }
+            ]
           }
         },
         "open": {
           "type": "boolean"
+        },
+        "labels": {
+          "type": "boolean"
+        },
+        "lead": {
+          "type": "boolean"
+        },
+        "href": {
+          "type": "string",
+          "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
+        },
+        "choose": {
+          "type": "boolean"
+        }
+      },
+      "additionalProperties": false
+    },
+    "CardPart": {
+      "anyOf": [
+        {
+          "type": "string",
+          "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "field": {
+              "type": "string",
+              "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
+            },
+            "unit": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "$ref": "#/$defs/PluralWords"
+                }
+              ]
+            }
+          },
+          "required": [
+            "field"
+          ],
+          "additionalProperties": false
+        }
+      ]
+    },
+    "PluralWords": {
+      "type": "object",
+      "properties": {
+        "zero": {
+          "type": "string"
+        },
+        "one": {
+          "type": "string"
+        },
+        "two": {
+          "type": "string"
+        },
+        "few": {
+          "type": "string"
+        },
+        "many": {
+          "type": "string"
+        },
+        "other": {
+          "type": "string"
         }
       },
+      "required": [
+        "other"
+      ],
       "additionalProperties": false
     },
     "MapRoute": {
@@ -8088,6 +8260,31 @@
               "additionalProperties": false
             }
           ]
+        },
+        "height": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "minimum": 160,
+              "maximum": 2000
+            },
+            {
+              "type": "string",
+              "const": "fill"
+            }
+          ]
+        },
+        "gestures": {
+          "type": "string",
+          "enum": [
+            "shared",
+            "all"
+          ]
+        },
+        "fitZoom": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 22
         }
       },
       "additionalProperties": false

package/src/index.d.mts

@@ -1,7 +1,8 @@
 export * from './runtime.mjs';
-export { FieldSchema, FieldsSchema, LineFieldSchema, LineKindsSchema, OptionSchema, PropertyDefinitionSchema, FilterConditionSchema, FilterItemSchema, } from './lib/format/field.mjs';
+export { FieldSchema, FieldsSchema, LineFieldSchema, LineKindsSchema, OptionSchema, PropertyDefinitionSchema, FilterConditionSchema, FilterItemSchema, MoneyLookSchema, PERIODS, } from './lib/format/field.mjs';
 export { ModifierSchema, RolesSchema, CellRulesSchema, ToneWhenSchema, LayoutNodeSchema, RootLayoutSchema, ListNodeSchema } from './lib/format/layout.mjs';
 export { PageSchema } from './lib/format/page.mjs';
 export { ActionStepSchema, PageEventsSchema } from './lib/format/actions.mjs';
 export { validatePage } from './lib/format/validate.mjs';
+export { AddressSearchOptionsSchema } from './lib/format/address-search.mjs';
 export { pageJsonSchema } from './lib/format/json-schema.mjs';

package/src/index.d.ts

@@ -1,7 +1,8 @@
 export * from './runtime';
-export { FieldSchema, FieldsSchema, LineFieldSchema, LineKindsSchema, OptionSchema, PropertyDefinitionSchema, FilterConditionSchema, FilterItemSchema, } from './lib/format/field';
+export { FieldSchema, FieldsSchema, LineFieldSchema, LineKindsSchema, OptionSchema, PropertyDefinitionSchema, FilterConditionSchema, FilterItemSchema, MoneyLookSchema, PERIODS, } from './lib/format/field';
 export { ModifierSchema, RolesSchema, CellRulesSchema, ToneWhenSchema, LayoutNodeSchema, RootLayoutSchema, ListNodeSchema } from './lib/format/layout';
 export { PageSchema } from './lib/format/page';
 export { ActionStepSchema, PageEventsSchema } from './lib/format/actions';
 export { validatePage } from './lib/format/validate';
+export { AddressSearchOptionsSchema } from './lib/format/address-search';
 export { pageJsonSchema } from './lib/format/json-schema';

package/src/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.pageJsonSchema = exports.validatePage = exports.PageEventsSchema = exports.ActionStepSchema = exports.PageSchema = exports.ListNodeSchema = exports.RootLayoutSchema = exports.LayoutNodeSchema = exports.ToneWhenSchema = exports.CellRulesSchema = exports.RolesSchema = exports.ModifierSchema = exports.FilterItemSchema = exports.FilterConditionSchema = exports.PropertyDefinitionSchema = exports.OptionSchema = exports.LineKindsSchema = exports.LineFieldSchema = exports.FieldsSchema = exports.FieldSchema = void 0;
+exports.pageJsonSchema = exports.AddressSearchOptionsSchema = exports.validatePage = exports.PageEventsSchema = exports.ActionStepSchema = exports.PageSchema = exports.ListNodeSchema = exports.RootLayoutSchema = exports.LayoutNodeSchema = exports.ToneWhenSchema = exports.CellRulesSchema = exports.RolesSchema = exports.ModifierSchema = exports.PERIODS = exports.MoneyLookSchema = exports.FilterItemSchema = exports.FilterConditionSchema = exports.PropertyDefinitionSchema = exports.OptionSchema = exports.LineKindsSchema = exports.LineFieldSchema = exports.FieldsSchema = exports.FieldSchema = void 0;
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./runtime"), exports);
 var field_1 = require("./lib/format/field");
@@ -12,6 +12,8 @@ Object.defineProperty(exports, "OptionSchema", { enumerable: true, get: function
 Object.defineProperty(exports, "PropertyDefinitionSchema", { enumerable: true, get: function () { return field_1.PropertyDefinitionSchema; } });
 Object.defineProperty(exports, "FilterConditionSchema", { enumerable: true, get: function () { return field_1.FilterConditionSchema; } });
 Object.defineProperty(exports, "FilterItemSchema", { enumerable: true, get: function () { return field_1.FilterItemSchema; } });
+Object.defineProperty(exports, "MoneyLookSchema", { enumerable: true, get: function () { return field_1.MoneyLookSchema; } });
+Object.defineProperty(exports, "PERIODS", { enumerable: true, get: function () { return field_1.PERIODS; } });
 var layout_1 = require("./lib/format/layout");
 Object.defineProperty(exports, "ModifierSchema", { enumerable: true, get: function () { return layout_1.ModifierSchema; } });
 Object.defineProperty(exports, "RolesSchema", { enumerable: true, get: function () { return layout_1.RolesSchema; } });
@@ -27,6 +29,8 @@ Object.defineProperty(exports, "ActionStepSchema", { enumerable: true, get: func
 Object.defineProperty(exports, "PageEventsSchema", { enumerable: true, get: function () { return actions_1.PageEventsSchema; } });
 var validate_1 = require("./lib/format/validate");
 Object.defineProperty(exports, "validatePage", { enumerable: true, get: function () { return validate_1.validatePage; } });
+var address_search_1 = require("./lib/format/address-search");
+Object.defineProperty(exports, "AddressSearchOptionsSchema", { enumerable: true, get: function () { return address_search_1.AddressSearchOptionsSchema; } });
 var json_schema_1 = require("./lib/format/json-schema");
 Object.defineProperty(exports, "pageJsonSchema", { enumerable: true, get: function () { return json_schema_1.pageJsonSchema; } });
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/core/src/index.ts"],"names":[],"mappings":";;;;AAAA,oDAA0B;AAC1B,4CAS4B;AAR1B,oGAAA,WAAW,OAAA;AACX,qGAAA,YAAY,OAAA;AACZ,wGAAA,eAAe,OAAA;AACf,wGAAA,eAAe,OAAA;AACf,qGAAA,YAAY,OAAA;AACZ,iHAAA,wBAAwB,OAAA;AACxB,8GAAA,qBAAqB,OAAA;AACrB,yGAAA,gBAAgB,OAAA;AAElB,8CAAuJ;AAA9I,wGAAA,cAAc,OAAA;AAAE,qGAAA,WAAW,OAAA;AAAE,yGAAA,eAAe,OAAA;AAAE,wGAAA,cAAc,OAAA;AAAE,0GAAA,gBAAgB,OAAA;AAAE,0GAAA,gBAAgB,OAAA;AAAE,wGAAA,cAAc,OAAA;AACzH,0CAA+C;AAAtC,kGAAA,UAAU,OAAA;AACnB,gDAA0E;AAAjE,2GAAA,gBAAgB,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAC3C,kDAAqD;AAA5C,wGAAA,YAAY,OAAA;AACrB,wDAA0D;AAAjD,6GAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/core/src/index.ts"],"names":[],"mappings":";;;;AAAA,oDAA0B;AAC1B,4CAW4B;AAV1B,oGAAA,WAAW,OAAA;AACX,qGAAA,YAAY,OAAA;AACZ,wGAAA,eAAe,OAAA;AACf,wGAAA,eAAe,OAAA;AACf,qGAAA,YAAY,OAAA;AACZ,iHAAA,wBAAwB,OAAA;AACxB,8GAAA,qBAAqB,OAAA;AACrB,yGAAA,gBAAgB,OAAA;AAChB,wGAAA,eAAe,OAAA;AACf,gGAAA,OAAO,OAAA;AAET,8CAAuJ;AAA9I,wGAAA,cAAc,OAAA;AAAE,qGAAA,WAAW,OAAA;AAAE,yGAAA,eAAe,OAAA;AAAE,wGAAA,cAAc,OAAA;AAAE,0GAAA,gBAAgB,OAAA;AAAE,0GAAA,gBAAgB,OAAA;AAAE,wGAAA,cAAc,OAAA;AACzH,0CAA+C;AAAtC,kGAAA,UAAU,OAAA;AACnB,gDAA0E;AAAjE,2GAAA,gBAAgB,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAC3C,kDAAqD;AAA5C,wGAAA,YAAY,OAAA;AACrB,8DAAyE;AAAhE,4HAAA,0BAA0B,OAAA;AACnC,wDAA0D;AAAjD,6GAAA,cAAc,OAAA"}

package/src/index.mjs

@@ -1,8 +1,9 @@
 export * from './runtime.mjs';
-export { FieldSchema, FieldsSchema, LineFieldSchema, LineKindsSchema, OptionSchema, PropertyDefinitionSchema, FilterConditionSchema, FilterItemSchema, } from './lib/format/field.mjs';
+export { FieldSchema, FieldsSchema, LineFieldSchema, LineKindsSchema, OptionSchema, PropertyDefinitionSchema, FilterConditionSchema, FilterItemSchema, MoneyLookSchema, PERIODS, } from './lib/format/field.mjs';
 export { ModifierSchema, RolesSchema, CellRulesSchema, ToneWhenSchema, LayoutNodeSchema, RootLayoutSchema, ListNodeSchema } from './lib/format/layout.mjs';
 export { PageSchema } from './lib/format/page.mjs';
 export { ActionStepSchema, PageEventsSchema } from './lib/format/actions.mjs';
 export { validatePage } from './lib/format/validate.mjs';
+export { AddressSearchOptionsSchema } from './lib/format/address-search.mjs';
 export { pageJsonSchema } from './lib/format/json-schema.mjs';
 //# sourceMappingURL=index.mjs.map

package/src/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../../libs/core/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,OAAO,EACL,WAAW,EACX,YAAY,EACZ,eAAe,EACf,eAAe,EACf,YAAY,EACZ,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACvJ,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../../libs/core/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,OAAO,EACL,WAAW,EACX,YAAY,EACZ,eAAe,EACf,eAAe,EACf,YAAY,EACZ,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,OAAO,GACR,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACvJ,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC"}

package/src/lib/format/address-search.d.mts

@@ -0,0 +1,12 @@
+import * as z from 'zod';
+export declare const AddressSearchOptionsSchema: z.ZodObject<{
+    placeField: z.ZodOptional<z.ZodString>;
+    longitudeField: z.ZodOptional<z.ZodString>;
+    partsField: z.ZodOptional<z.ZodString>;
+    countries: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>>;
+    near: z.ZodOptional<z.ZodObject<{
+        lat: z.ZodNumber;
+        lng: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type AddressSearchOptions = z.infer<typeof AddressSearchOptionsSchema>;

package/src/lib/format/address-search.d.ts

@@ -0,0 +1,12 @@
+import * as z from 'zod';
+export declare const AddressSearchOptionsSchema: z.ZodObject<{
+    placeField: z.ZodOptional<z.ZodString>;
+    longitudeField: z.ZodOptional<z.ZodString>;
+    partsField: z.ZodOptional<z.ZodString>;
+    countries: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>>;
+    near: z.ZodOptional<z.ZodObject<{
+        lat: z.ZodNumber;
+        lng: z.ZodNumber;
+    }, z.z.core.$strict>>;
+}, z.z.core.$strict>;
+export type AddressSearchOptions = z.infer<typeof AddressSearchOptionsSchema>;

package/src/lib/format/address-search.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddressSearchOptionsSchema = void 0;
+const z = require("zod");
+const names_1 = require("./names");
+/**
+ * An address typed on one line with the addresses a map's provider suggests
+ * (`"widget": "address-search"` on a char field, drawn by @fieldia/map): its
+ * options. A suggestion picked can fill a place field (`placeField`, a json
+ * field's GeoJSON Point, or a float field's latitude with `longitudeField`
+ * for its longitude) and an address in its parts (`partsField`, a json field
+ * drawn as an address); `countries` keeps the suggestions to some countries,
+ * by their ISO codes, an array or "EG,SA" as the designer writes it; `near`
+ * puts those near a point first. The fields they name are checked with the
+ * page's references, by kind.
+ *
+ *   { "field": "address", "widget": "address-search",
+ *     "options": { "placeField": "deliver_to", "partsField": "address_parts", "countries": ["EG"] } }
+ */
+const fieldName = z.string().regex(names_1.FIELD_NAME);
+const COUNTRY = /^[A-Z]{2}$/;
+const country = z.string().regex(COUNTRY, 'a country is its ISO code in capitals, such as "EG"');
+exports.AddressSearchOptionsSchema = z
+    .strictObject({
+    placeField: fieldName.optional(),
+    longitudeField: fieldName.optional(),
+    partsField: fieldName.optional(),
+    countries: z.union([z.array(country).min(1), z.string().refine((codes) => codes.split(',').every((code) => COUNTRY.test(code.trim())), 'countries are ISO codes in capitals, such as ["EG", "SA"] or "EG,SA"')]).optional(),
+    near: z.strictObject({ lat: z.number().min(-90).max(90), lng: z.number().min(-180).max(180) }).optional(),
+})
+    .meta({ id: 'AddressSearchOptions' });
+//# sourceMappingURL=address-search.js.map

package/src/lib/format/address-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address-search.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/format/address-search.ts"],"names":[],"mappings":";;;AAAA,yBAAyB;AACzB,mCAAqC;AAErC;;;;;;;;;;;;;GAaG;AAEH,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,kBAAU,CAAC,CAAC;AAC/C,MAAM,OAAO,GAAG,YAAY,CAAC;AAC7B,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,qDAAqD,CAAC,CAAC;AAEpF,QAAA,0BAA0B,GAAG,CAAC;KACxC,YAAY,CAAC;IACZ,UAAU,EAAE,SAAS,CAAC,QAAQ,EAAE;IAChC,cAAc,EAAE,SAAS,CAAC,QAAQ,EAAE;IACpC,UAAU,EAAE,SAAS,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,sEAAsE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC3N,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC1G,CAAC;KACD,IAAI,CAAC,EAAE,EAAE,EAAE,sBAAsB,EAAE,CAAC,CAAC"}

package/src/lib/format/address-search.mjs

@@ -0,0 +1,29 @@
+import * as z from 'zod';
+import { FIELD_NAME } from './names.mjs';
+/**
+ * An address typed on one line with the addresses a map's provider suggests
+ * (`"widget": "address-search"` on a char field, drawn by @fieldia/map): its
+ * options. A suggestion picked can fill a place field (`placeField`, a json
+ * field's GeoJSON Point, or a float field's latitude with `longitudeField`
+ * for its longitude) and an address in its parts (`partsField`, a json field
+ * drawn as an address); `countries` keeps the suggestions to some countries,
+ * by their ISO codes, an array or "EG,SA" as the designer writes it; `near`
+ * puts those near a point first. The fields they name are checked with the
+ * page's references, by kind.
+ *
+ *   { "field": "address", "widget": "address-search",
+ *     "options": { "placeField": "deliver_to", "partsField": "address_parts", "countries": ["EG"] } }
+ */
+const fieldName = z.string().regex(FIELD_NAME);
+const COUNTRY = /^[A-Z]{2}$/;
+const country = z.string().regex(COUNTRY, 'a country is its ISO code in capitals, such as "EG"');
+export const AddressSearchOptionsSchema = z
+    .strictObject({
+    placeField: fieldName.optional(),
+    longitudeField: fieldName.optional(),
+    partsField: fieldName.optional(),
+    countries: z.union([z.array(country).min(1), z.string().refine((codes) => codes.split(',').every((code) => COUNTRY.test(code.trim())), 'countries are ISO codes in capitals, such as ["EG", "SA"] or "EG,SA"')]).optional(),
+    near: z.strictObject({ lat: z.number().min(-90).max(90), lng: z.number().min(-180).max(180) }).optional(),
+})
+    .meta({ id: 'AddressSearchOptions' });
+//# sourceMappingURL=address-search.mjs.map

package/src/lib/format/address-search.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"address-search.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/format/address-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC;;;;;;;;;;;;;GAaG;AAEH,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;AAC/C,MAAM,OAAO,GAAG,YAAY,CAAC;AAC7B,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,qDAAqD,CAAC,CAAC;AAEjG,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC;KACxC,YAAY,CAAC;IACZ,UAAU,EAAE,SAAS,CAAC,QAAQ,EAAE;IAChC,cAAc,EAAE,SAAS,CAAC,QAAQ,EAAE;IACpC,UAAU,EAAE,SAAS,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,sEAAsE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC3N,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC1G,CAAC;KACD,IAAI,CAAC,EAAE,EAAE,EAAE,sBAAsB,EAAE,CAAC,CAAC"}

package/src/lib/format/card-lines.d.mts

@@ -0,0 +1,16 @@
+import type { CardPart, MapCard, PluralWords } from './layout.mjs';
+/**
+ * A map card's lines, read: each line's parts, each part its field and the
+ * words after its value. A line is one part ("price") or several on one
+ * line, parted by a dot ("Sheikh Zayed · 4 beds · 280 m²").
+ */
+export interface CardLinePart {
+    field: string;
+    unit?: string | PluralWords;
+}
+/** One part of a line, the same whether written as a name or with its words. */
+export declare function cardPart(part: CardPart): CardLinePart;
+/** A card's lines, each as its parts. */
+export declare function cardLines(card: Pick<MapCard, 'fields'> | undefined): CardLinePart[][];
+/** Every field a card's lines show, once each, in order. */
+export declare function cardLineFields(card: Pick<MapCard, 'fields'> | undefined): string[];

package/src/lib/format/card-lines.d.ts

@@ -0,0 +1,16 @@
+import type { CardPart, MapCard, PluralWords } from './layout';
+/**
+ * A map card's lines, read: each line's parts, each part its field and the
+ * words after its value. A line is one part ("price") or several on one
+ * line, parted by a dot ("Sheikh Zayed · 4 beds · 280 m²").
+ */
+export interface CardLinePart {
+    field: string;
+    unit?: string | PluralWords;
+}
+/** One part of a line, the same whether written as a name or with its words. */
+export declare function cardPart(part: CardPart): CardLinePart;
+/** A card's lines, each as its parts. */
+export declare function cardLines(card: Pick<MapCard, 'fields'> | undefined): CardLinePart[][];
+/** Every field a card's lines show, once each, in order. */
+export declare function cardLineFields(card: Pick<MapCard, 'fields'> | undefined): string[];

package/src/lib/format/card-lines.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cardPart = cardPart;
+exports.cardLines = cardLines;
+exports.cardLineFields = cardLineFields;
+/** One part of a line, the same whether written as a name or with its words. */
+function cardPart(part) {
+    return typeof part === 'string' ? { field: part } : part;
+}
+/** A card's lines, each as its parts. */
+function cardLines(card) {
+    return (card?.fields ?? []).map((line) => (Array.isArray(line) ? line : [line]).map(cardPart));
+}
+/** Every field a card's lines show, once each, in order. */
+function cardLineFields(card) {
+    return [...new Set(cardLines(card).flatMap((parts) => parts.map((part) => part.field)))];
+}
+//# sourceMappingURL=card-lines.js.map

package/src/lib/format/card-lines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"card-lines.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/format/card-lines.ts"],"names":[],"mappings":";;AAcA,4BAEC;AAGD,8BAEC;AAGD,wCAEC;AAbD,gFAAgF;AAChF,SAAgB,QAAQ,CAAC,IAAc;IACrC,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3D,CAAC;AAED,yCAAyC;AACzC,SAAgB,SAAS,CAAC,IAAyC;IACjE,OAAO,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAc,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC3G,CAAC;AAED,4DAA4D;AAC5D,SAAgB,cAAc,CAAC,IAAyC;IACtE,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3F,CAAC"}

package/src/lib/format/card-lines.mjs

@@ -0,0 +1,13 @@
+/** One part of a line, the same whether written as a name or with its words. */
+export function cardPart(part) {
+    return typeof part === 'string' ? { field: part } : part;
+}
+/** A card's lines, each as its parts. */
+export function cardLines(card) {
+    return (card?.fields ?? []).map((line) => (Array.isArray(line) ? line : [line]).map(cardPart));
+}
+/** Every field a card's lines show, once each, in order. */
+export function cardLineFields(card) {
+    return [...new Set(cardLines(card).flatMap((parts) => parts.map((part) => part.field)))];
+}
+//# sourceMappingURL=card-lines.mjs.map

package/src/lib/format/card-lines.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"card-lines.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/format/card-lines.ts"],"names":[],"mappings":"AAaA,gFAAgF;AAChF,MAAM,UAAU,QAAQ,CAAC,IAAc;IACrC,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3D,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,SAAS,CAAC,IAAyC;IACjE,OAAO,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAc,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC3G,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,cAAc,CAAC,IAAyC;IACtE,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3F,CAAC"}