@fieldia/core 0.23.0 → 0.24.0

package/README.md

@@ -28,7 +28,7 @@ list of records — that your app implements;
 The page format is also a JSON Schema, for editors and other languages:
 `@fieldia/core/page.schema.json`.
 
-A page says which format it is written in (`"fieldia": "0.2"`, `FORMAT_VERSION`; a page in 0.1 is read as it is).
+A page says which format it is written in (`"fieldia": "0.3"`, `FORMAT_VERSION`; a page in 0.1 or 0.2 is read as it is).
 One in an older format is brought up to date as it is read — by `checkPage`,
 `validatePage` and `createForm`, so by the viewer and the designer too — and
 `upgradePage` does it for the pages your app keeps. One newer than this Fieldia
@@ -63,6 +63,43 @@ settings each kind has are `PART_LOOKS`:
 }
 ```
 
+## A public form's bot check
+
+A page of responses anyone may send — a sign-up, a contact form — can check that
+a person sent it (`botCheck`): a box no person sees or reaches, which a bot
+filling every box fills (`honeypot`, on unless `false`); the fewest seconds a
+person takes from the page shown to its send (`minSeconds`, 3 unless said; 0
+tells none); and the slot the app draws its own captcha in (`captcha`: a slot's
+name — Turnstile, reCAPTCHA, hCaptcha):
+
+```json
+"layout": { "type": "sections", "id": "signup", "children": [
+  …,
+  { "type": "slot", "id": "s-captcha", "name": "captcha" }
+] },
+"botCheck": { "minSeconds": 3, "captcha": "captcha" }
+```
+
+Nothing is refused for it on the page: each send tells the app what it saw,
+beside the answers (`submit({ pageId, values, bot })`, and the `send` event), and
+the app decides — keep the response aside, check the token with its service, or
+refuse it:
+
+```ts
+async submit({ pageId, values, bot }) {
+  // bot: { honeypot: false, tooFast: false, seconds: 41.2, captcha: '0.Zx…' }
+  if (bot?.honeypot || bot?.tooFast) return keepAside(pageId, values);
+  if (bot && !(await verifyTurnstile(bot.captcha))) throw saveRefused({ kind: 'rule', message: 'Tick “I am human” first' });
+  return store(pageId, values);
+}
+```
+
+The app's captcha widget hands its token to the form, `form.botCheck({ captcha: token })`
+(null once it expires); a token goes once it is sent, as a captcha's is spent. The
+viewer draws the hidden box and tells the form when it is filled
+(`form.botCheck({ honeypot: true })`). A page without `botCheck` sends what it
+always did.
+
 ## Files stored as they are picked
 
 Give the data source `upload(file, request)` and a file or picture field sends
@@ -96,6 +133,75 @@ your words and offers no Retry; any other error offers Retry. Stop with an
 one. Without `upload`, files travel inside the record as base64, as before.
 See [files stored as they are picked](https://fieldia.dev/data/#upload).
 
+## Lists that add up, and filter by time
+
+A list asks its source's optional `totals({ model, filter, totals, groupBy?,
+interval?, currencies? })` for a column's sum, average, lowest, highest or
+count — over the search, under each group, or the rows ticked (`id in` their
+ids) — and its `groups` for a date by the span it falls in (`interval`: `day`,
+`week`, `month`, `quarter` or `year`, with `weekStart` and `timeZone`), each
+group's value its span's first day. An amount named in `currencies` (by the
+field holding each record's currency) is totalled within one currency only:
+over several, its sum is `null`, and `currencies` in the answer names the one
+it is in. A period a list's filter names ("This month", "Overdue") arrives as
+plain conditions. `spanStart(value, interval, { weekStart, timeZone })` finds
+the span a value falls in as the list counts it, and `dayIn` and `dayStarts`
+a day in a time zone; `createMemoryDataSource` does it all. See
+[lists that add up](https://fieldia.dev/lists/#totals).
+
+## Time zones and booking slots
+
+A page may name the time zone its dates and times are in, by its IANA name —
+a branch's, a clinic's — and a date and time field may name its own:
+
+```json
+{ "timeZone": "Europe/Berlin", "fields": { "flight": { "type": "datetime", "label": "Departs", "timeZone": "Africa/Cairo" } } }
+```
+
+A date and time is still kept as an instant, as before (`2026-10-15T12:30:00.000Z`;
+one written with its offset is read the same). It is shown and typed on the
+zone's clock wherever the person is, with the zone's short name beside it where
+the browser's zone is another ("14:30 CEST"). Today is the zone's day: a date's
+default `"today"`, its earliest and latest counted from today, `today()`, a
+rule's past and future, and `form.today()`. A time the clocks skip, or repeat, on
+a change day is said, never moved. `zonedPage(page)` writes the page's zone into
+each date and time field that names none, as the form and the viewer read it;
+`wallTime`, `instantsAt`, `dayIn` and `clocksSkip` are the clock arithmetic
+they use. `checkPage` and `validatePage` refuse a zone the browser does not know.
+Without `timeZone`, the browser's own zone, as before.
+
+A date and time drawn as booking slots (`"widget": "slots"`) asks the data
+source's `slots(request)` for its free times: the days asked (`from`, `to`, in
+`timeZone`), the schedule its node names (`options.schedule`), the booking's
+`length` and the minutes `between` two as the page says, the record and its
+values. It answers each day's state — `open`, `full`, `closed`, `holiday` with a
+`note` — and the times free, as instants, and may say the booking's `length`.
+`form.findSlots(field, { from, to })` asks it for a widget of your own;
+`form.canFindSlots()` says whether the source can. Without `slots`, the field is
+the plain date and time box. For demos and tests, `scheduleSlots(schedules)`
+answers from booking schedules — hours by the day of the week on a zone's clock,
+a booking's length, the minutes kept free after one, holidays, and the records
+the bookings are:
+
+```ts
+import { createMemoryDataSource, scheduleSlots } from '@fieldia/core';
+
+const weekday: [string, string][] = [['09:00', '13:00'], ['14:00', '18:00']];
+const dataSource = createMemoryDataSource({
+  records,
+  slots: scheduleSlots({
+    showroom: {
+      timeZone: 'Europe/Berlin',
+      hours: { 1: weekday, 2: weekday, 3: weekday, 4: weekday, 5: weekday, 6: [['10:00', '14:00']] },
+      length: 45,
+      between: 15,
+      holidays: { '2026-12-25': 'Christmas Day' },
+      bookings: { model: 'drive.booking', field: 'start', endField: 'stop', same: ['car'] },
+    },
+  }),
+});
+```
+
 ## Two people, one record
 
 A source that keeps versions returns each record with its version, and what this
@@ -141,7 +247,8 @@ values. It asks only about the person's work at risk (`workAtRisk(state)`):
 each change of theirs the last finished save of the record did not send —
 typed while it was on its way, while the run that saved went on, or since
 (`state.unsent`, told against the record as that save left it; a value set by
-a step, a rule, a compute or your app is never theirs) — a file the store holds
+a step, a rule, a compute or your app is never theirs; text they left since
+that does not read, "12a", counts as "12" does) — a file the store holds
 that no save sent, files still on their way, and changes Reload set aside. Then
 it asks "Discard your changes?" through the host's `ask(message, { discard:
 true })`, or `confirm`; Cancel keeps the person where they are, and with
@@ -150,13 +257,38 @@ out behaves as it did in 0.20: a change not saved goes where a step leaves the
 record. `form.leaveNow()` says whether a way out can go at once. Call
 `form.leave()` before your app's own ways out — a route change, an unmount —
 and `unsavedWork(state)` (any change, file or change set aside) for a browser's
-`beforeunload`. What `can` does
+`beforeunload`, or let the viewer keep it (`warnOnLeave`). A save refused for a
+conflict, waiting for Reload or Keep mine, is at risk too: the person asked for
+it to be saved. Discard lets the changes no save took go back to the record as
+the last save left it. Every answer that comes late — an onchange, a step's
+Archive, Duplicate or Delete, Keep mine's read, a name a box looks up — is laid
+only on the record it was asked for: anything of your own that waits and then
+writes on the form asks `form.recordShown()` first (taken as it asks, true
+while that record is still shown, as it was). What `can` does
 not allow is kept to before any source is asked: fields locked or hidden (and
 left out of what a save sends), a save refused with the source's `reason`, the
 gear menu's Archive, Duplicate and Delete and the buttons whose steps would do
 them hidden. `createMemoryDataSource({ versions: { by: 'Sara' }, can })` does
 it all in memory, and `changeElsewhere` changes a record as someone else would.
 
+## Many records at once
+
+A list's "Select all 1,284 that match", its Export and its Edit of many
+records read three optional members. `list({ …, allIds: true })` answers with
+`allIds`, every matching id in the list's order (fewer than `total` means the
+source stopped short, and the list says so). `writeMany({ model, ids, values,
+fields, versions })` writes one value in a field of each record and answers
+`{ failed: [{ id, message, problem? }] }`; without it the list saves each record
+in turn (`save` with `partial: true` and the version it was listed at).
+`exportRecords(request)` writes an export on the server: answer with the file
+(`{ name, data }`, data a Blob, bytes or text, or `{ name, url }`), with
+`{ message }` when it is handed over another way, or with `false` to let the
+browser write it. A page offers Edit with its list's `bulkEdit` (`true`, or the
+fields), and Export with `"export": true` — each off unless asked; `bulkEditFields(page, list)`
+says which fields Edit offers. `createMemoryDataSource` gives `allIds` and
+`writeMany` (each record refused as its save would be), and no `exportRecords`.
+See [many records at once](https://fieldia.dev/data/#many).
+
 ## A saved form placed in another
 
 A block made once — an address, a contact person, a consent — is a page of its

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fieldia/core",
-  "version": "0.23.0",
+  "version": "0.24.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

@@ -6,7 +6,8 @@
       "type": "string",
       "enum": [
         "0.1",
-        "0.2"
+        "0.2",
+        "0.3"
       ]
     },
     "id": {
@@ -349,6 +350,15 @@
     },
     "on": {
       "$ref": "#/$defs/PageEvents"
+    },
+    "botCheck": {
+      "$ref": "#/$defs/BotCheck"
+    },
+    "phone": {
+      "$ref": "#/$defs/PagePhone"
+    },
+    "timeZone": {
+      "$ref": "#/$defs/TimeZone"
     }
   },
   "required": [
@@ -868,6 +878,9 @@
                 "minimum": 1,
                 "maximum": 7
               }
+            },
+            "timeZone": {
+              "$ref": "#/$defs/TimeZone"
             }
           },
           "required": [
@@ -1695,6 +1708,17 @@
       },
       "additionalProperties": false
     },
+    "TimeZone": {
+      "type": "string",
+      "pattern": "^[A-Za-z][\\w+-]*(\\/[\\w+-]+)*$",
+      "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"
+      ]
+    },
     "Option": {
       "type": "object",
       "properties": {
@@ -2327,6 +2351,9 @@
                 "minimum": 1,
                 "maximum": 7
               }
+            },
+            "timeZone": {
+              "$ref": "#/$defs/TimeZone"
             }
           },
           "required": [
@@ -2973,6 +3000,9 @@
                 "minimum": 1,
                 "maximum": 7
               }
+            },
+            "timeZone": {
+              "$ref": "#/$defs/TimeZone"
             }
           },
           "required": [
@@ -4157,6 +4187,9 @@
                 "minimum": 1,
                 "maximum": 7
               }
+            },
+            "timeZone": {
+              "$ref": "#/$defs/TimeZone"
             }
           },
           "required": [
@@ -5770,6 +5803,22 @@
             "$ref": "#/$defs/PlaceholderWhen"
           }
         },
+        "autocomplete": {
+          "type": "string",
+          "pattern": "^(?:on|off|(?:section-\\S*(?: +(?:shipping|billing))?|shipping|billing)|(?:(?:section-\\S*(?: +(?:shipping|billing))?|shipping|billing) +)?(?:name|honorific-prefix|given-name|additional-name|family-name|honorific-suffix|nickname|username|new-password|current-password|one-time-code|organization-title|organization|street-address|address-line1|address-line2|address-line3|address-level4|address-level3|address-level2|address-level1|country|country-name|postal-code|cc-name|cc-given-name|cc-additional-name|cc-family-name|cc-number|cc-exp|cc-exp-month|cc-exp-year|cc-csc|cc-type|transaction-currency|transaction-amount|language|bday|bday-day|bday-month|bday-year|sex|url|photo|(?:(?:home|work|mobile|fax|pager) +)?(?:tel|tel-country-code|tel-national|tel-area-code|tel-local|tel-local-prefix|tel-local-suffix|tel-extension|email|impp))(?: +webauthn)?)$"
+        },
+        "inputmode": {
+          "type": "string",
+          "enum": [
+            "text",
+            "numeric",
+            "decimal",
+            "tel",
+            "email",
+            "url",
+            "search"
+          ]
+        },
         "help": {
           "type": "string"
         },
@@ -8662,14 +8711,28 @@
                 "items": {
                   "$ref": "#/$defs/FilterItem"
                 }
+              },
+              "period": {
+                "$ref": "#/$defs/FilterPeriod"
               }
             },
             "required": [
               "id",
-              "label",
-              "filter"
+              "label"
             ],
-            "additionalProperties": false
+            "additionalProperties": false,
+            "anyOf": [
+              {
+                "required": [
+                  "filter"
+                ]
+              },
+              {
+                "required": [
+                  "period"
+                ]
+              }
+            ]
           }
         },
         "defaultFilters": {
@@ -8845,6 +8908,24 @@
         "parentField": {
           "type": "string",
           "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
+        },
+        "export": {
+          "type": "boolean"
+        },
+        "bulkEdit": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "minItems": 1,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
+              }
+            }
+          ]
         }
       },
       "required": [
@@ -8854,6 +8935,35 @@
       ],
       "additionalProperties": false
     },
+    "FilterPeriod": {
+      "type": "object",
+      "properties": {
+        "field": {
+          "type": "string",
+          "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
+        },
+        "is": {
+          "type": "string",
+          "enum": [
+            "today",
+            "yesterday",
+            "thisWeek",
+            "lastWeek",
+            "thisMonth",
+            "lastMonth",
+            "thisYear",
+            "last7Days",
+            "last30Days",
+            "overdue"
+          ]
+        }
+      },
+      "required": [
+        "field",
+        "is"
+      ],
+      "additionalProperties": false
+    },
     "ListMap": {
       "type": "object",
       "properties": {
@@ -9158,6 +9268,16 @@
             "end"
           ]
         },
+        "total": {
+          "type": "string",
+          "enum": [
+            "sum",
+            "avg",
+            "min",
+            "max",
+            "count"
+          ]
+        },
         "rule": {
           "anyOf": [
             {
@@ -9227,6 +9347,41 @@
         }
       },
       "additionalProperties": false
+    },
+    "BotCheck": {
+      "type": "object",
+      "properties": {
+        "honeypot": {
+          "type": "boolean"
+        },
+        "minSeconds": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 3600
+        },
+        "captcha": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "additionalProperties": false
+    },
+    "PagePhone": {
+      "type": "object",
+      "properties": {
+        "country": {
+          "type": "string",
+          "pattern": "^[A-Z]{2}$"
+        },
+        "shown": {
+          "type": "string",
+          "enum": [
+            "international",
+            "national"
+          ]
+        }
+      },
+      "additionalProperties": false
     }
   }
 }

package/src/index.d.mts

@@ -1,9 +1,13 @@
 export * from './runtime.mjs';
-export { FieldSchema, FieldsSchema, LineFieldSchema, LineKindsSchema, OptionSchema, PropertyDefinitionSchema, FilterConditionSchema, FilterItemSchema, MoneyLookSchema, ShrinkSchema, PERIODS, } from './lib/format/field.mjs';
-export { ModifierSchema, RolesSchema, CellRulesSchema, ToneWhenSchema, LayoutNodeSchema, RootLayoutSchema, ListNodeSchema, ListCellSchema, ListCalendarSchema } from './lib/format/layout.mjs';
+export { scheduleSlots, type MemorySchedule } from './lib/record/memory-schedules.mjs';
+export { FieldSchema, FieldsSchema, LineFieldSchema, LineKindsSchema, OptionSchema, PropertyDefinitionSchema, FilterConditionSchema, FilterItemSchema, MoneyLookSchema, ShrinkSchema, PERIODS, TimeZoneSchema, } from './lib/format/field.mjs';
+export { ModifierSchema, RolesSchema, CellRulesSchema, ToneWhenSchema, LayoutNodeSchema, RootLayoutSchema, ListNodeSchema, ListCellSchema, ListCalendarSchema, FilterPeriodSchema } 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 { PathPickerOptionsSchema, StateDotOptionsSchema } from './lib/format/picker-options.mjs';
+export { PagePhoneSchema, PhoneOptionsSchema } from './lib/format/phone.mjs';
+export { SlotsOptionsSchema } from './lib/format/slots-options.mjs';
 export { pageJsonSchema } from './lib/format/json-schema.mjs';
+export { AUTOFILL, AUTOFILL_CONTACT, AUTOFILL_NAMES, autofillProblem, autofillPurpose } from './lib/format/autofill.mjs';

package/src/index.d.ts

@@ -1,9 +1,13 @@
 export * from './runtime';
-export { FieldSchema, FieldsSchema, LineFieldSchema, LineKindsSchema, OptionSchema, PropertyDefinitionSchema, FilterConditionSchema, FilterItemSchema, MoneyLookSchema, ShrinkSchema, PERIODS, } from './lib/format/field';
-export { ModifierSchema, RolesSchema, CellRulesSchema, ToneWhenSchema, LayoutNodeSchema, RootLayoutSchema, ListNodeSchema, ListCellSchema, ListCalendarSchema } from './lib/format/layout';
+export { scheduleSlots, type MemorySchedule } from './lib/record/memory-schedules';
+export { FieldSchema, FieldsSchema, LineFieldSchema, LineKindsSchema, OptionSchema, PropertyDefinitionSchema, FilterConditionSchema, FilterItemSchema, MoneyLookSchema, ShrinkSchema, PERIODS, TimeZoneSchema, } from './lib/format/field';
+export { ModifierSchema, RolesSchema, CellRulesSchema, ToneWhenSchema, LayoutNodeSchema, RootLayoutSchema, ListNodeSchema, ListCellSchema, ListCalendarSchema, FilterPeriodSchema } 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 { PathPickerOptionsSchema, StateDotOptionsSchema } from './lib/format/picker-options';
+export { PagePhoneSchema, PhoneOptionsSchema } from './lib/format/phone';
+export { SlotsOptionsSchema } from './lib/format/slots-options';
 export { pageJsonSchema } from './lib/format/json-schema';
+export { AUTOFILL, AUTOFILL_CONTACT, AUTOFILL_NAMES, autofillProblem, autofillPurpose } from './lib/format/autofill';

package/src/index.js

@@ -1,8 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.pageJsonSchema = exports.StateDotOptionsSchema = exports.PathPickerOptionsSchema = exports.AddressSearchOptionsSchema = exports.validatePage = exports.PageEventsSchema = exports.ActionStepSchema = exports.PageSchema = exports.ListCalendarSchema = exports.ListCellSchema = exports.ListNodeSchema = exports.RootLayoutSchema = exports.LayoutNodeSchema = exports.ToneWhenSchema = exports.CellRulesSchema = exports.RolesSchema = exports.ModifierSchema = exports.PERIODS = exports.ShrinkSchema = exports.MoneyLookSchema = exports.FilterItemSchema = exports.FilterConditionSchema = exports.PropertyDefinitionSchema = exports.OptionSchema = exports.LineKindsSchema = exports.LineFieldSchema = exports.FieldsSchema = exports.FieldSchema = void 0;
+exports.autofillPurpose = exports.autofillProblem = exports.AUTOFILL_NAMES = exports.AUTOFILL_CONTACT = exports.AUTOFILL = exports.pageJsonSchema = exports.SlotsOptionsSchema = exports.PhoneOptionsSchema = exports.PagePhoneSchema = exports.StateDotOptionsSchema = exports.PathPickerOptionsSchema = exports.AddressSearchOptionsSchema = exports.validatePage = exports.PageEventsSchema = exports.ActionStepSchema = exports.PageSchema = exports.FilterPeriodSchema = exports.ListCalendarSchema = exports.ListCellSchema = exports.ListNodeSchema = exports.RootLayoutSchema = exports.LayoutNodeSchema = exports.ToneWhenSchema = exports.CellRulesSchema = exports.RolesSchema = exports.ModifierSchema = exports.TimeZoneSchema = exports.PERIODS = exports.ShrinkSchema = exports.MoneyLookSchema = exports.FilterItemSchema = exports.FilterConditionSchema = exports.PropertyDefinitionSchema = exports.OptionSchema = exports.LineKindsSchema = exports.LineFieldSchema = exports.FieldsSchema = exports.FieldSchema = exports.scheduleSlots = void 0;
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./runtime"), exports);
+// A memory source's free times from booking schedules: for demos and tests, outside the one-tag script.
+var memory_schedules_1 = require("./lib/record/memory-schedules");
+Object.defineProperty(exports, "scheduleSlots", { enumerable: true, get: function () { return memory_schedules_1.scheduleSlots; } });
 var field_1 = require("./lib/format/field");
 Object.defineProperty(exports, "FieldSchema", { enumerable: true, get: function () { return field_1.FieldSchema; } });
 Object.defineProperty(exports, "FieldsSchema", { enumerable: true, get: function () { return field_1.FieldsSchema; } });
@@ -15,6 +18,7 @@ Object.defineProperty(exports, "FilterItemSchema", { enumerable: true, get: func
 Object.defineProperty(exports, "MoneyLookSchema", { enumerable: true, get: function () { return field_1.MoneyLookSchema; } });
 Object.defineProperty(exports, "ShrinkSchema", { enumerable: true, get: function () { return field_1.ShrinkSchema; } });
 Object.defineProperty(exports, "PERIODS", { enumerable: true, get: function () { return field_1.PERIODS; } });
+Object.defineProperty(exports, "TimeZoneSchema", { enumerable: true, get: function () { return field_1.TimeZoneSchema; } });
 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; } });
@@ -25,6 +29,7 @@ Object.defineProperty(exports, "RootLayoutSchema", { enumerable: true, get: func
 Object.defineProperty(exports, "ListNodeSchema", { enumerable: true, get: function () { return layout_1.ListNodeSchema; } });
 Object.defineProperty(exports, "ListCellSchema", { enumerable: true, get: function () { return layout_1.ListCellSchema; } });
 Object.defineProperty(exports, "ListCalendarSchema", { enumerable: true, get: function () { return layout_1.ListCalendarSchema; } });
+Object.defineProperty(exports, "FilterPeriodSchema", { enumerable: true, get: function () { return layout_1.FilterPeriodSchema; } });
 var page_1 = require("./lib/format/page");
 Object.defineProperty(exports, "PageSchema", { enumerable: true, get: function () { return page_1.PageSchema; } });
 var actions_1 = require("./lib/format/actions");
@@ -37,6 +42,18 @@ Object.defineProperty(exports, "AddressSearchOptionsSchema", { enumerable: true,
 var picker_options_1 = require("./lib/format/picker-options");
 Object.defineProperty(exports, "PathPickerOptionsSchema", { enumerable: true, get: function () { return picker_options_1.PathPickerOptionsSchema; } });
 Object.defineProperty(exports, "StateDotOptionsSchema", { enumerable: true, get: function () { return picker_options_1.StateDotOptionsSchema; } });
+var phone_1 = require("./lib/format/phone");
+Object.defineProperty(exports, "PagePhoneSchema", { enumerable: true, get: function () { return phone_1.PagePhoneSchema; } });
+Object.defineProperty(exports, "PhoneOptionsSchema", { enumerable: true, get: function () { return phone_1.PhoneOptionsSchema; } });
+var slots_options_1 = require("./lib/format/slots-options");
+Object.defineProperty(exports, "SlotsOptionsSchema", { enumerable: true, get: function () { return slots_options_1.SlotsOptionsSchema; } });
 var json_schema_1 = require("./lib/format/json-schema");
 Object.defineProperty(exports, "pageJsonSchema", { enumerable: true, get: function () { return json_schema_1.pageJsonSchema; } });
+// The purposes a browser fills a box in with, from the HTML standard, as the format checks them.
+var autofill_1 = require("./lib/format/autofill");
+Object.defineProperty(exports, "AUTOFILL", { enumerable: true, get: function () { return autofill_1.AUTOFILL; } });
+Object.defineProperty(exports, "AUTOFILL_CONTACT", { enumerable: true, get: function () { return autofill_1.AUTOFILL_CONTACT; } });
+Object.defineProperty(exports, "AUTOFILL_NAMES", { enumerable: true, get: function () { return autofill_1.AUTOFILL_NAMES; } });
+Object.defineProperty(exports, "autofillProblem", { enumerable: true, get: function () { return autofill_1.autofillProblem; } });
+Object.defineProperty(exports, "autofillPurpose", { enumerable: true, get: function () { return autofill_1.autofillPurpose; } });
 //# 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,4CAY4B;AAX1B,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,qGAAA,YAAY,OAAA;AACZ,gGAAA,OAAO,OAAA;AAET,8CAA2L;AAAlL,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;AAAE,wGAAA,cAAc,OAAA;AAAE,4GAAA,kBAAkB,OAAA;AAC7J,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,8DAA6F;AAApF,yHAAA,uBAAuB,OAAA;AAAE,uHAAA,qBAAqB,OAAA;AACvD,wDAA0D;AAAjD,6GAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/core/src/index.ts"],"names":[],"mappings":";;;;AAAA,oDAA0B;AAC1B,wGAAwG;AACxG,kEAAmF;AAA1E,iHAAA,aAAa,OAAA;AACtB,4CAa4B;AAZ1B,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,qGAAA,YAAY,OAAA;AACZ,gGAAA,OAAO,OAAA;AACP,uGAAA,cAAc,OAAA;AAEhB,8CAA+M;AAAtM,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;AAAE,wGAAA,cAAc,OAAA;AAAE,4GAAA,kBAAkB,OAAA;AAAE,4GAAA,kBAAkB,OAAA;AACjL,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,8DAA6F;AAApF,yHAAA,uBAAuB,OAAA;AAAE,uHAAA,qBAAqB,OAAA;AACvD,4CAAyE;AAAhE,wGAAA,eAAe,OAAA;AAAE,2GAAA,kBAAkB,OAAA;AAC5C,4DAAgE;AAAvD,mHAAA,kBAAkB,OAAA;AAC3B,wDAA0D;AAAjD,6GAAA,cAAc,OAAA;AACvB,iGAAiG;AACjG,kDAAqH;AAA5G,oGAAA,QAAQ,OAAA;AAAE,4GAAA,gBAAgB,OAAA;AAAE,0GAAA,cAAc,OAAA;AAAE,2GAAA,eAAe,OAAA;AAAE,2GAAA,eAAe,OAAA"}

package/src/index.mjs

@@ -1,10 +1,16 @@
 export * from './runtime.mjs';
-export { FieldSchema, FieldsSchema, LineFieldSchema, LineKindsSchema, OptionSchema, PropertyDefinitionSchema, FilterConditionSchema, FilterItemSchema, MoneyLookSchema, ShrinkSchema, PERIODS, } from './lib/format/field.mjs';
-export { ModifierSchema, RolesSchema, CellRulesSchema, ToneWhenSchema, LayoutNodeSchema, RootLayoutSchema, ListNodeSchema, ListCellSchema, ListCalendarSchema } from './lib/format/layout.mjs';
+// A memory source's free times from booking schedules: for demos and tests, outside the one-tag script.
+export { scheduleSlots } from './lib/record/memory-schedules.mjs';
+export { FieldSchema, FieldsSchema, LineFieldSchema, LineKindsSchema, OptionSchema, PropertyDefinitionSchema, FilterConditionSchema, FilterItemSchema, MoneyLookSchema, ShrinkSchema, PERIODS, TimeZoneSchema, } from './lib/format/field.mjs';
+export { ModifierSchema, RolesSchema, CellRulesSchema, ToneWhenSchema, LayoutNodeSchema, RootLayoutSchema, ListNodeSchema, ListCellSchema, ListCalendarSchema, FilterPeriodSchema } 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 { PathPickerOptionsSchema, StateDotOptionsSchema } from './lib/format/picker-options.mjs';
+export { PagePhoneSchema, PhoneOptionsSchema } from './lib/format/phone.mjs';
+export { SlotsOptionsSchema } from './lib/format/slots-options.mjs';
 export { pageJsonSchema } from './lib/format/json-schema.mjs';
+// The purposes a browser fills a box in with, from the HTML standard, as the format checks them.
+export { AUTOFILL, AUTOFILL_CONTACT, AUTOFILL_NAMES, autofillProblem, autofillPurpose } from './lib/format/autofill.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,EAChB,eAAe,EACf,YAAY,EACZ,OAAO,GACR,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC3L,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,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAC7F,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,wGAAwG;AACxG,OAAO,EAAE,aAAa,EAAuB,MAAM,+BAA+B,CAAC;AACnF,OAAO,EACL,WAAW,EACX,YAAY,EACZ,eAAe,EACf,eAAe,EACf,YAAY,EACZ,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,OAAO,EACP,cAAc,GACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC/M,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,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAC7F,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,iGAAiG;AACjG,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/src/lib/format/autofill-group.d.mts

@@ -0,0 +1,12 @@
+/**
+ * What the quick check of a page (`checkPage`) keeps of a box's autocomplete purpose (autofill.ts): a box names what
+ * it holds, an address in parts only whose it is. Whether a purpose is one the HTML standard lists is the format's own
+ * check (`validatePage`), as every other shape is: a browser passes over one it does not know.
+ */
+/** The keyboards a phone shows for a box: words, digits alone, digits with a decimal mark, a phone's, an email's, a web address's, a search's. */
+export declare const INPUT_MODES: readonly ["text", "numeric", "decimal", "tel", "email", "url", "search"];
+export type InputMode = (typeof INPUT_MODES)[number];
+/** Whose it is, with no purpose — `shipping`, `section-home billing` — which only an address in parts takes. */
+export declare const AUTOFILL_GROUP: RegExp;
+/** Why a field placed on a page cannot name this purpose — a box with whose it is alone, an address in parts (`parts`) with a purpose — or null. */
+export declare function autofillGroupProblem(value: string, parts: boolean): string | null;

package/src/lib/format/autofill-group.d.ts

@@ -0,0 +1,12 @@
+/**
+ * What the quick check of a page (`checkPage`) keeps of a box's autocomplete purpose (autofill.ts): a box names what
+ * it holds, an address in parts only whose it is. Whether a purpose is one the HTML standard lists is the format's own
+ * check (`validatePage`), as every other shape is: a browser passes over one it does not know.
+ */
+/** The keyboards a phone shows for a box: words, digits alone, digits with a decimal mark, a phone's, an email's, a web address's, a search's. */
+export declare const INPUT_MODES: readonly ["text", "numeric", "decimal", "tel", "email", "url", "search"];
+export type InputMode = (typeof INPUT_MODES)[number];
+/** Whose it is, with no purpose — `shipping`, `section-home billing` — which only an address in parts takes. */
+export declare const AUTOFILL_GROUP: RegExp;
+/** Why a field placed on a page cannot name this purpose — a box with whose it is alone, an address in parts (`parts`) with a purpose — or null. */
+export declare function autofillGroupProblem(value: string, parts: boolean): string | null;

package/src/lib/format/autofill-group.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * What the quick check of a page (`checkPage`) keeps of a box's autocomplete purpose (autofill.ts): a box names what
+ * it holds, an address in parts only whose it is. Whether a purpose is one the HTML standard lists is the format's own
+ * check (`validatePage`), as every other shape is: a browser passes over one it does not know.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AUTOFILL_GROUP = exports.INPUT_MODES = void 0;
+exports.autofillGroupProblem = autofillGroupProblem;
+/** The keyboards a phone shows for a box: words, digits alone, digits with a decimal mark, a phone's, an email's, a web address's, a search's. */
+exports.INPUT_MODES = ['text', 'numeric', 'decimal', 'tel', 'email', 'url', 'search'];
+/** Whose it is, with no purpose — `shipping`, `section-home billing` — which only an address in parts takes. */
+exports.AUTOFILL_GROUP = /^(?:section-\S*(?: +(?:shipping|billing))?|shipping|billing)$/;
+/** Why a field placed on a page cannot name this purpose — a box with whose it is alone, an address in parts (`parts`) with a purpose — or null. */
+function autofillGroupProblem(value, parts) {
+    const group = exports.AUTOFILL_GROUP.test(value);
+    if (parts && !group && value !== 'on' && value !== 'off')
+        return 'an address in parts names each part’s own purpose: give only whose address it is, such as "shipping", or "off"';
+    if (!parts && group)
+        return `"${value}" says whose it is, not what the box holds: add its purpose, such as "${value} postal-code"`;
+    return null;
+}
+//# sourceMappingURL=autofill-group.js.map

package/src/lib/format/autofill-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autofill-group.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/format/autofill-group.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAUH,oDAKC;AAbD,kJAAkJ;AACrI,QAAA,WAAW,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAU,CAAC;AAGpG,gHAAgH;AACnG,QAAA,cAAc,GAAG,+DAA+D,CAAC;AAE9F,oJAAoJ;AACpJ,SAAgB,oBAAoB,CAAC,KAAa,EAAE,KAAc;IAChE,MAAM,KAAK,GAAG,sBAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,KAAK,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,gHAAgH,CAAC;IAClL,IAAI,CAAC,KAAK,IAAI,KAAK;QAAE,OAAO,IAAI,KAAK,yEAAyE,KAAK,eAAe,CAAC;IACnI,OAAO,IAAI,CAAC;AACd,CAAC"}

package/src/lib/format/autofill-group.mjs

@@ -0,0 +1,19 @@
+/**
+ * What the quick check of a page (`checkPage`) keeps of a box's autocomplete purpose (autofill.ts): a box names what
+ * it holds, an address in parts only whose it is. Whether a purpose is one the HTML standard lists is the format's own
+ * check (`validatePage`), as every other shape is: a browser passes over one it does not know.
+ */
+/** The keyboards a phone shows for a box: words, digits alone, digits with a decimal mark, a phone's, an email's, a web address's, a search's. */
+export const INPUT_MODES = ['text', 'numeric', 'decimal', 'tel', 'email', 'url', 'search'];
+/** Whose it is, with no purpose — `shipping`, `section-home billing` — which only an address in parts takes. */
+export const AUTOFILL_GROUP = /^(?:section-\S*(?: +(?:shipping|billing))?|shipping|billing)$/;
+/** Why a field placed on a page cannot name this purpose — a box with whose it is alone, an address in parts (`parts`) with a purpose — or null. */
+export function autofillGroupProblem(value, parts) {
+    const group = AUTOFILL_GROUP.test(value);
+    if (parts && !group && value !== 'on' && value !== 'off')
+        return 'an address in parts names each part’s own purpose: give only whose address it is, such as "shipping", or "off"';
+    if (!parts && group)
+        return `"${value}" says whose it is, not what the box holds: add its purpose, such as "${value} postal-code"`;
+    return null;
+}
+//# sourceMappingURL=autofill-group.mjs.map

package/src/lib/format/autofill-group.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"autofill-group.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/format/autofill-group.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,kJAAkJ;AAClJ,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAU,CAAC;AAGpG,gHAAgH;AAChH,MAAM,CAAC,MAAM,cAAc,GAAG,+DAA+D,CAAC;AAE9F,oJAAoJ;AACpJ,MAAM,UAAU,oBAAoB,CAAC,KAAa,EAAE,KAAc;IAChE,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,KAAK,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,gHAAgH,CAAC;IAClL,IAAI,CAAC,KAAK,IAAI,KAAK;QAAE,OAAO,IAAI,KAAK,yEAAyE,KAAK,eAAe,CAAC;IACnI,OAAO,IAAI,CAAC;AACd,CAAC"}