@usefillo/core 0.25.0 → 0.26.1

package/dist/index.d.ts

@@ -95,6 +95,11 @@ interface RatingField extends BaseField {
 }
 interface DateField extends BaseField {
     kind: "date";
+    /**
+     * Start on today's date — the respondent's own day, set by their device once
+     * the form loads (the server can't know their time zone). They can change it.
+     */
+    defaultToday?: boolean;
 }
 interface LinearScaleField extends BaseField {
     kind: "linear_scale";
@@ -300,8 +305,12 @@ interface ResponseLimit {
      *   and anonymous embeds can still dedupe.
      * - "identify": the identify() respondent (HMAC-verifiable). The strong
      *   path; only embedded surfaces that call identify() are recognized.
+     * - "email": a verified email address. On the form's Fillo link the person
+     *   confirms their email with a 6-digit code before filling in, and the
+     *   device stays confirmed for 30 days. Embedded forms can't show that
+     *   step — use "identify" there.
      */
-    by: "browser" | "field" | "identify";
+    by: "browser" | "field" | "identify" | "email";
     /** The email/phone field whose answer identifies the person. `by: "field"` only. */
     field?: string;
     /**
@@ -315,7 +324,8 @@ interface ResponseLimit {
      * response (the first answer stands); "update" edits it in place (re-anchored
      * to the current schema, `response.updated` webhook, previous answers
      * prefilled for a verified respondent). "update" applies to `by: "identify"`
-     * only — a self-claim/browser must not overwrite another person's response.
+     * and `by: "email"` only — a self-claim/browser must not overwrite another
+     * person's response.
      */
     onRepeat: "keep" | "update";
 }
@@ -2249,6 +2259,15 @@ declare function isBuildTimeDevEnv(): boolean;
  */
 declare function isLikelyDevEnv(): boolean;
 
+/** A device's local calendar date as YYYY-MM-DD — the value a date field holds. */
+declare function localDateString(now?: Date): string;
+/**
+ * Fill each unanswered date field that starts on today (`defaultToday`). Only
+ * the respondent's device knows their "today" (time zone), so renderers apply
+ * this in the browser after hydration, never on the server. Returns `data`
+ * itself when nothing needed filling.
+ */
+declare function applyDateDefaults(form: FormSchema, data: ResponseData, now?: Date): ResponseData;
 /**
  * Build initial response data from URL query parameters — Tally-style
  * prefilling. Hidden fields read their configured paramName; every other
@@ -2293,4 +2312,4 @@ declare class Sha1 {
 }
 declare const sha1Base64: (bytes: Uint8Array) => string;
 
-export { type AutoSubmitContext, BLOCK_KIND_META, type BaseField, type Block, type BlockKind, CONTENT_KINDS, type CalcExpr, type CalculatedField, type ChallengeConfig, type ChallengeTheme, type CheckboxField, type ChoiceField, type CodeForm, type Condition, type ConditionOp, type ContentBlock, type ContentKind, type CreatedDraft, type CustomField, DEFAULT_FIELD_STRINGS, DEFAULT_RESPONDENT_ERROR_STRINGS, DEFAULT_STRINGS, DRAFT_KINDS, type DateField, type DividerBlock, FILLO_CALC_MIN_SDK_VERSION, FILLO_CHALLENGE_MIN_SDK_VERSION, FILLO_DATA_ATTRS, FILLO_GROUP_MIN_SDK_VERSION, FILLO_MIN_SDK_VERSION, FILLO_SCHEMA_VERSION, FILLO_SDK_VERSION, FILLO_SLOTS, FILLO_THEME_VARS, type Field, type FieldKind, type FieldSpec, type FieldValue, type FileUploadField, type FileValue, type FilloAppearance, FilloClient, type FilloClientOptions, FilloError, type FilloFieldStrings, FilloJsxError, type FilloRendererStrings, type FilloRespondent, type FilloSlot, type FilloStrings, type FormBranding, type FormController, type FormControllerOptions, type FormControllerState, type FormDraftSpec, type FormPage, type FormSchema, type FormSettings, type FormStatus, type FormTheme, type FormThemePalette, type GroupInstanceValue, type HeadingBlock, type HiddenField, JSX_BLOCK_COMPONENTS, JSX_BLOCK_SPECS, type JsonValue, type JsxFormMeta, type JumpRule, type LinearScaleField, MAX_FILES_PER_FIELD, type MatrixField, type NextPage, type NumberField, PHONE_COUNTRIES, PHONE_PICKER_COUNTRIES, PHONE_POPOVER_VIEWPORT_GAP, type ParagraphBlock, type ParsePhoneOptions, type ParsedPhone, type PhoneCountry, type PhoneField, type PhonePopoverPlacement, type ProvisionWorkspaceResult, type PublishedForm, REQUIRED_FIELD_MESSAGE, type RankingField, type RatingField, type RepeatingGroupField, type RespondentErrorOverrides, type RespondentErrorStrings, type ResponseData, type ResponseDraft, type ResponseLimit, type SchemaValidationResult, type SelectOption, Sha1, type SignatureField, type SlotClass, type SlotState, type SubmitMeta, type SubmitResult, type SyncFormResult, type SyncedForm, type TextField, type ThemeDomAttributes, type TrustPolicy, type UploadFileOptions, type UploadProgress, type UploadSession, type UploadStatus, type UploadTransport, type ValidationResult, type WhenBuilder, allFields, assembleForm, codeFormFromJsx, computeCalculated, conditionsMet, contentHash, countryByDialCode, countryByIso, countryByTimeZone, createBlock, createClient, createEmptyForm, createFormController, createId, defineForm, digitsOnly, evaluateCalc, flagEmoji, formSchemasEqual, formatAnswer, formatGroupedNumber, formatNational, isAutoSubmitBlock, isBlockVisible, isBuildTimeDevEnv, isCodeForm, isField, isFilloError, isLikelyDevEnv, isPossiblePhone, isTerminalPage, isValidPartialNumberText, localeForNotation, needsExplicitSubmit, normalizeFormSchema, normalizeFormTheme, normalizeSettings, parseGroupedNumber, parsePhone, pipeBlock, positionPhonePopover, prefillFromParams, provisionWorkspace, radioGroupStep, reachableFieldIds, reachableFields, reachablePageIds, reachablePageSequence, requiredFieldMessage, resolveNextPage, resolveSlotClass, resolveStrings, resolveText, resolveThemeAppearance, resolveThemeDom, respondentErrorStringsFor, responseScopeValue, schemaFromJsx, sha1Base64, shouldAutoSubmit, slotClass, syncCodeForm, themeHasDarkPalette, toE164, validateField, validateFormSchema, validateResponse, visibleBlocks, visibleFields, visibleGroupChildren, visiblePageBlocks, when };
+export { type AutoSubmitContext, BLOCK_KIND_META, type BaseField, type Block, type BlockKind, CONTENT_KINDS, type CalcExpr, type CalculatedField, type ChallengeConfig, type ChallengeTheme, type CheckboxField, type ChoiceField, type CodeForm, type Condition, type ConditionOp, type ContentBlock, type ContentKind, type CreatedDraft, type CustomField, DEFAULT_FIELD_STRINGS, DEFAULT_RESPONDENT_ERROR_STRINGS, DEFAULT_STRINGS, DRAFT_KINDS, type DateField, type DividerBlock, FILLO_CALC_MIN_SDK_VERSION, FILLO_CHALLENGE_MIN_SDK_VERSION, FILLO_DATA_ATTRS, FILLO_GROUP_MIN_SDK_VERSION, FILLO_MIN_SDK_VERSION, FILLO_SCHEMA_VERSION, FILLO_SDK_VERSION, FILLO_SLOTS, FILLO_THEME_VARS, type Field, type FieldKind, type FieldSpec, type FieldValue, type FileUploadField, type FileValue, type FilloAppearance, FilloClient, type FilloClientOptions, FilloError, type FilloFieldStrings, FilloJsxError, type FilloRendererStrings, type FilloRespondent, type FilloSlot, type FilloStrings, type FormBranding, type FormController, type FormControllerOptions, type FormControllerState, type FormDraftSpec, type FormPage, type FormSchema, type FormSettings, type FormStatus, type FormTheme, type FormThemePalette, type GroupInstanceValue, type HeadingBlock, type HiddenField, JSX_BLOCK_COMPONENTS, JSX_BLOCK_SPECS, type JsonValue, type JsxFormMeta, type JumpRule, type LinearScaleField, MAX_FILES_PER_FIELD, type MatrixField, type NextPage, type NumberField, PHONE_COUNTRIES, PHONE_PICKER_COUNTRIES, PHONE_POPOVER_VIEWPORT_GAP, type ParagraphBlock, type ParsePhoneOptions, type ParsedPhone, type PhoneCountry, type PhoneField, type PhonePopoverPlacement, type ProvisionWorkspaceResult, type PublishedForm, REQUIRED_FIELD_MESSAGE, type RankingField, type RatingField, type RepeatingGroupField, type RespondentErrorOverrides, type RespondentErrorStrings, type ResponseData, type ResponseDraft, type ResponseLimit, type SchemaValidationResult, type SelectOption, Sha1, type SignatureField, type SlotClass, type SlotState, type SubmitMeta, type SubmitResult, type SyncFormResult, type SyncedForm, type TextField, type ThemeDomAttributes, type TrustPolicy, type UploadFileOptions, type UploadProgress, type UploadSession, type UploadStatus, type UploadTransport, type ValidationResult, type WhenBuilder, allFields, applyDateDefaults, assembleForm, codeFormFromJsx, computeCalculated, conditionsMet, contentHash, countryByDialCode, countryByIso, countryByTimeZone, createBlock, createClient, createEmptyForm, createFormController, createId, defineForm, digitsOnly, evaluateCalc, flagEmoji, formSchemasEqual, formatAnswer, formatGroupedNumber, formatNational, isAutoSubmitBlock, isBlockVisible, isBuildTimeDevEnv, isCodeForm, isField, isFilloError, isLikelyDevEnv, isPossiblePhone, isTerminalPage, isValidPartialNumberText, localDateString, localeForNotation, needsExplicitSubmit, normalizeFormSchema, normalizeFormTheme, normalizeSettings, parseGroupedNumber, parsePhone, pipeBlock, positionPhonePopover, prefillFromParams, provisionWorkspace, radioGroupStep, reachableFieldIds, reachableFields, reachablePageIds, reachablePageSequence, requiredFieldMessage, resolveNextPage, resolveSlotClass, resolveStrings, resolveText, resolveThemeAppearance, resolveThemeDom, respondentErrorStringsFor, responseScopeValue, schemaFromJsx, sha1Base64, shouldAutoSubmit, slotClass, syncCodeForm, themeHasDarkPalette, toE164, validateField, validateFormSchema, validateResponse, visibleBlocks, visibleFields, visibleGroupChildren, visiblePageBlocks, when };

package/dist/index.js

@@ -1114,7 +1114,7 @@ var schemaShape = z2.object({
 });
 var MAX_SCHEMA_VERSION = 1;
 var FILLO_SCHEMA_VERSION = 1;
-var FILLO_SDK_VERSION = true ? "0.25.0" : "0.0.0-dev";
+var FILLO_SDK_VERSION = true ? "0.26.1" : "0.0.0-dev";
 var FILLO_MIN_SDK_VERSION = "0.4.0";
 var FILLO_CHALLENGE_MIN_SDK_VERSION = "0.9.0";
 var FILLO_CALC_MIN_SDK_VERSION = "0.11.0";
@@ -1560,12 +1560,12 @@ function normalizeUrl(value) {
 function normalizeResponseLimit(value) {
   if (!value || typeof value !== "object") return void 0;
   const rec = value;
-  const by = rec.by === "browser" || rec.by === "field" || rec.by === "identify" ? rec.by : void 0;
+  const by = rec.by === "browser" || rec.by === "field" || rec.by === "identify" || rec.by === "email" ? rec.by : void 0;
   if (!by) return void 0;
   const field2 = by === "field" ? optionalStr(rec.field, 128) : void 0;
   if (by === "field" && !field2) return void 0;
   const scopeField = optionalStr(rec.scopeField, 128);
-  const onRepeat = rec.onRepeat === "update" && by === "identify" ? "update" : "keep";
+  const onRepeat = rec.onRepeat === "update" && (by === "identify" || by === "email") ? "update" : "keep";
   return {
     by,
     ...field2 ? { field: field2 } : {},
@@ -1675,8 +1675,12 @@ function normalizeBlock(input) {
       });
     }
     case "signature":
-    case "date":
       return cleanObject(baseField(rec, kind));
+    case "date":
+      return cleanObject({
+        ...baseField(rec, kind),
+        defaultToday: rec.defaultToday === true ? true : void 0
+      });
     case "rating": {
       const max = int(rec.max, 1, 10, 5);
       return cleanObject({
@@ -3241,6 +3245,20 @@ function parseDecimal(raw) {
   const n = Number(s);
   return Number.isFinite(n) ? n : null;
 }
+function localDateString(now = /* @__PURE__ */ new Date()) {
+  const month = String(now.getMonth() + 1).padStart(2, "0");
+  const day = String(now.getDate()).padStart(2, "0");
+  return `${now.getFullYear()}-${month}-${day}`;
+}
+function applyDateDefaults(form, data, now = /* @__PURE__ */ new Date()) {
+  let next = null;
+  for (const field2 of allFields(form)) {
+    if (field2.kind !== "date" || !field2.defaultToday || data[field2.id] !== void 0) continue;
+    next = next ?? { ...data };
+    next[field2.id] = localDateString(now);
+  }
+  return next ?? data;
+}
 function prefillFromParams(form, params) {
   const data = {};
   for (const field2 of allFields(form)) {
@@ -3518,6 +3536,11 @@ function createFormController(options2) {
         notify();
       }
     }
+    const withDates = applyDateDefaults(form, data);
+    if (withDates !== data && status === "idle") {
+      data = computeCalculated(form, withDates);
+      notify();
+    }
     if (status === "idle" && hasSubmittedOnce(form, formId, data)) {
       status = "submitted";
       restoredSubmission = true;
@@ -4053,6 +4076,7 @@ function createFormController(options2) {
           if (data[key] === void 0) data[key] = value;
         }
       }
+      data = applyDateDefaults(form, data);
       data = computeCalculated(form, data);
       errors = {};
       pageIndex = 0;
@@ -4490,7 +4514,7 @@ var JSX_BLOCK_SPECS = [
   field("Ranking", "ranking", ["options"], { optionChildren: true }),
   field("Matrix", "matrix", ["rows", "columns"]),
   field("Signature", "signature", []),
-  field("Date", "date", []),
+  field("Date", "date", ["defaultToday"]),
   field("FileUpload", "file_upload", ["maxFiles", "maxFileSizeMb", "accept"]),
   field("Hidden", "hidden", ["paramName", "defaultValue"]),
   field("Calculated", "calculated", ["calc", "decimals", "prefix", "suffix"]),
@@ -4883,6 +4907,7 @@ export {
   REQUIRED_FIELD_MESSAGE,
   Sha1,
   allFields,
+  applyDateDefaults,
   assembleForm,
   codeFormFromJsx,
   computeCalculated,
@@ -4914,6 +4939,7 @@ export {
   isPossiblePhone,
   isTerminalPage,
   isValidPartialNumberText,
+  localDateString,
   localeForNotation,
   needsExplicitSubmit,
   normalizeFormSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usefillo/core",
-  "version": "0.25.0",
+  "version": "0.26.1",
   "description": "Form schema, validation, logic engine and JS client for Fillo. Framework-agnostic.",
   "license": "MIT",
   "keywords": [