@usefillo/core 0.11.0 → 0.12.1

package/dist/index.d.ts

@@ -66,9 +66,12 @@ interface NumberField extends BaseField {
     decimals?: number;
     prefix?: string;
     suffix?: string;
-    /** Locale-aware thousand separators in the SDK input. Display-only;
-     *  never reaches the wire, the server, or exports. */
-    notation?: "grouped";
+    /** Thousand separators in the SDK input. Display-only; never reaches the
+     *  wire, the server, or exports. Named by the GROUP separator:
+     *  - `"grouped"`: detect from the respondent's browser locale;
+     *  - `"grouped-comma"`: fixed comma groups, dot decimal — `1,234.56`;
+     *  - `"grouped-dot"`: fixed dot groups, comma decimal — `1.234,56`. */
+    notation?: "grouped" | "grouped-comma" | "grouped-dot";
 }
 interface ChoiceField extends BaseField {
     kind: "select" | "multi_select" | "dropdown";
@@ -660,14 +663,26 @@ declare function normalizeFormTheme(input: unknown): FormTheme | null;
 declare function formatAnswer(field: Field, value: FieldValue): string;
 
 /**
- * Grouped-number display + parsing for the Number field's `notation:
- * "grouped"` input (design contract: docs/decisions/number-formatting.md).
- * Both helpers are pure, side-effect-free, and DOM-free, so the same code
- * runs in @usefillo/react, @usefillo/dom, and Node. Both are strictly
- * display-only — grouping never touches validation, canonical storage, or
- * the wire (contract decision 2) — and both degrade to canonical text
- * instead of throwing when `Intl` is unavailable.
+ * Grouped-number display + parsing for the Number field's `notation` input
+ * — browser-locale detection (`"grouped"`) or an author-fixed style
+ * (`"grouped-comma"` = `1,234.56`, `"grouped-dot"` = `1.234,56`); design
+ * contract: docs/decisions/number-formatting.md. All helpers are pure,
+ * side-effect-free, and DOM-free, so the same code runs in @usefillo/react,
+ * @usefillo/dom, and Node. All are strictly display-only — grouping never
+ * touches validation, canonical storage, or the wire (contract decision 2)
+ * — and all degrade to canonical text instead of throwing when `Intl` is
+ * unavailable.
  */
+/**
+ * The `Intl` locale a `notation` value pins the separators to — the single
+ * source of the notation→locale map, consumed by BOTH renderers (never
+ * duplicate it). Notation values are named by the GROUP separator:
+ * - `"grouped"` (and unset): `undefined` — detect from the respondent's
+ *   browser locale, exactly the pre-fixed-style behavior;
+ * - `"grouped-comma"`: `"en-US"` — comma groups, dot decimal, `1,234.56`;
+ * - `"grouped-dot"`: `"de-DE"` — dot groups, comma decimal, `1.234,56`.
+ */
+declare function localeForNotation(notation?: "grouped" | "grouped-comma" | "grouped-dot"): string | undefined;
 /**
  * Locale-grouped display text for a finite number — the blurred value of a
  * `notation: "grouped"` number input. `maximumFractionDigits` is set
@@ -697,8 +712,10 @@ declare function formatGroupedNumber(value: number, opts?: {
  *   accepted as a group separator whenever the locale's own is whitespace;
  * - maps the locale decimal mark to ".";
  * - ALWAYS also accepts "." as a decimal mark regardless of locale — see
- *   {@link resolveDotGroup} for the one locale family where that collides
- *   with "." also being the group separator;
+ *   {@link resolveAmbiguousGrouping} for the locale families where a "." or
+ *   "," group separator collides with a decimal reading (a "," group run
+ *   that isn't exact 3-digit chunking reads as a decimal, so "12,5" under a
+ *   comma-grouping locale is 12.5, never a silently-stripped 125);
  * - preserves a leading minus;
  * - preserves partial typing states ("1234." stays "1234." — `Number()` can
  *   still parse it, and rewriting mid-keystroke fights the respondent).
@@ -1362,7 +1379,9 @@ interface FormControllerOptions {
     getHoneypot?: () => string;
     /**
      * @internal Let preview page navigation move forward without validating the
-     * current page. Submission still validates, and renderers must not use this
+     * current page. Submission still validates every answerable field; a
+     * transportless preview ignores required file-upload fields because its
+     * disabled picker cannot possibly satisfy them. Renderers must not use this
      * option to change visitor-facing behavior such as branding.
      */
     skipValidation?: boolean;
@@ -1677,8 +1696,8 @@ declare function resolveThemeAppearance(theme: FormTheme | null): FormTheme | nu
 /**
  * The default English validation message for a required field left empty.
  * `validateField` returns this exact sentinel (core has no strings context),
- * and the React render layer swaps it for `strings.required` so a localized
- * site can translate it. Keep it identical to `DEFAULT_FIELD_STRINGS.required`.
+ * and renderer layers swap it for field-aware/localized copy. Keep it
+ * identical to `DEFAULT_FIELD_STRINGS.required`.
  */
 declare const REQUIRED_FIELD_MESSAGE = "This field is required";
 /**
@@ -1744,8 +1763,12 @@ declare const DEFAULT_STRINGS: FilloStrings;
  * an exhaustively-enumerated, closed set.
  */
 interface FilloFieldStrings {
-    /** Validation: a required field was left empty. Mirrors REQUIRED_FIELD_MESSAGE. */
+    /** Generic/legacy validation copy for a required field left empty. Mirrors
+     *  REQUIRED_FIELD_MESSAGE and remains the fallback for custom/hidden fields. */
     required: string;
+    /** Optional field-aware required copy. Existing `required` overrides keep
+     *  their legacy generic behavior unless this function is also supplied. */
+    requiredForField?: (field: Field) => string;
     /** Notice when a spent/expired resume link couldn't restore progress. */
     resumeLinkExpired: string;
     /** Success-screen message when a verified identity re-submits and the form
@@ -1753,8 +1776,18 @@ interface FilloFieldStrings {
     alreadyAnswered: string;
     /** Retry control on a failed upload row. */
     uploadRetry: string;
-    /** Dropzone copy when uploads can't run (no client / preview). */
+    /** Accessible action names for upload rows. The filename is appended by the renderer. */
+    uploadCancel: string;
+    uploadRemove: string;
+    uploadDismiss: string;
+    /** Visible secondary status for an upload in progress. */
+    uploadingFile: (percent: number, size: string) => string;
+    /** Visible secondary status for a completed upload. */
+    uploadedFile: (size: string) => string;
+    /** Dropzone copy when uploads can't run because the form isn't connected. */
     uploadsDisabled: string;
+    /** Dropzone copy for an explicit render-only preview, which never has transport. */
+    uploadsRenderOnly: string;
     /** Dropzone copy when the server temporarily refuses new file sessions. */
     uploadsUnavailable: string;
     /** An upload request reached the server, but storage could not accept it. */
@@ -1776,8 +1809,8 @@ interface FilloFieldStrings {
     /** Live-region announcement while a submit is in flight — for auto-submit
      *  forms, which have no footer/button to show `submitting` on. */
     submittingAnnouncement: string;
-    /** Heading on the failed-submit error summary (one `role="alert"` summary
-     *  linking to fields, GOV.UK pattern — replaces N competing per-field alerts). */
+    /** @deprecated Retained for localization compatibility. Default renderers
+     *  now focus the first invalid control and show field-aware inline guidance. */
     errorSummaryTitle: string;
     /** Live-region announcement after a ranking move: "«label», position n of m". */
     rankingPosition: (label: string, position: number, count: number) => string;
@@ -1795,8 +1828,12 @@ interface FilloFieldStrings {
 declare const DEFAULT_FIELD_STRINGS: FilloFieldStrings;
 /** Everything the default renderers can localize — chrome + field/validation. */
 type FilloRendererStrings = FilloStrings & FilloFieldStrings;
+/** Resolve the renderer copy for core's stable required-field sentinel. */
+declare function requiredFieldMessage(field: Field, strings: Pick<FilloFieldStrings, "required" | "requiredForField">): string;
 /** Merge overrides over the built-in chrome + field defaults. Accepts a partial
- *  of the full renderer surface so the `strings` prop can override either set. */
+ *  of the full renderer surface so the `strings` prop can override either set.
+ *  A legacy generic `required` override disables the new field-aware default
+ *  unless the caller explicitly supplies `requiredForField` too. */
 declare function resolveStrings(overrides?: Partial<FilloRendererStrings>): FilloRendererStrings;
 
 /** Result of syncing a code-defined form: its canonical id, slug, and branding. */
@@ -2037,4 +2074,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 CheckboxField, type ChoiceField, type CodeForm, type Condition, type ConditionOp, type ContentBlock, type ContentKind, type CreatedDraft, type CustomField, DEFAULT_FIELD_STRINGS, DEFAULT_STRINGS, DRAFT_KINDS, type DateField, type DividerBlock, FILLO_CALC_MIN_SDK_VERSION, FILLO_CHALLENGE_MIN_SDK_VERSION, FILLO_DATA_ATTRS, 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 HeadingBlock, type HiddenField, JSX_BLOCK_COMPONENTS, JSX_BLOCK_SPECS, type JsonValue, type JsxFormMeta, type JumpRule, type LinearScaleField, 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 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 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, needsExplicitSubmit, normalizeFormSchema, normalizeFormTheme, normalizeSettings, parseGroupedNumber, parsePhone, pipeBlock, positionPhonePopover, prefillFromParams, provisionWorkspace, radioGroupStep, reachableFieldIds, reachableFields, reachablePageIds, reachablePageSequence, resolveNextPage, resolveSlotClass, resolveStrings, resolveText, resolveThemeAppearance, responseScopeValue, schemaFromJsx, sha1Base64, shouldAutoSubmit, slotClass, syncCodeForm, toE164, validateField, validateFormSchema, validateResponse, visibleBlocks, visibleFields, visiblePageBlocks, when };
+export { type AutoSubmitContext, BLOCK_KIND_META, type BaseField, type Block, type BlockKind, CONTENT_KINDS, type CalcExpr, type CalculatedField, type ChallengeConfig, type CheckboxField, type ChoiceField, type CodeForm, type Condition, type ConditionOp, type ContentBlock, type ContentKind, type CreatedDraft, type CustomField, DEFAULT_FIELD_STRINGS, DEFAULT_STRINGS, DRAFT_KINDS, type DateField, type DividerBlock, FILLO_CALC_MIN_SDK_VERSION, FILLO_CHALLENGE_MIN_SDK_VERSION, FILLO_DATA_ATTRS, 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 HeadingBlock, type HiddenField, JSX_BLOCK_COMPONENTS, JSX_BLOCK_SPECS, type JsonValue, type JsxFormMeta, type JumpRule, type LinearScaleField, 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 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 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, responseScopeValue, schemaFromJsx, sha1Base64, shouldAutoSubmit, slotClass, syncCodeForm, toE164, validateField, validateFormSchema, validateResponse, visibleBlocks, visibleFields, visiblePageBlocks, when };

package/dist/index.js

@@ -666,10 +666,12 @@ function positionPhonePopover(anchor, popover) {
   popover.style.setProperty("--fillo-phone-popover-max-width", `${Math.floor(maxWidth)}px`);
   popover.style.setProperty("--fillo-phone-popover-offset-x", "0px");
   const width = Math.min(popover.offsetWidth, maxWidth);
+  const rtl = getComputedStyle(anchor).direction === "rtl";
+  const unshiftedLeft = rtl ? anchorRect.right - width : anchorRect.left;
   let offsetX = 0;
-  const rightOverflow = anchorRect.left + width - (viewportWidth - gap);
+  const rightOverflow = unshiftedLeft + width - (viewportWidth - gap);
   if (rightOverflow > 0) offsetX -= rightOverflow;
-  const leftOverflow = gap - (anchorRect.left + offsetX);
+  const leftOverflow = gap - (unshiftedLeft + offsetX);
   if (leftOverflow > 0) offsetX += leftOverflow;
   popover.style.setProperty("--fillo-phone-popover-offset-x", `${Math.round(offsetX)}px`);
   return placement;
@@ -705,12 +707,41 @@ var DEFAULT_STRINGS = {
   resumeStartOver: "Start over",
   challengeUnavailable: "The verification check couldn't load. Refresh the page, or check that challenges.cloudflare.com isn't blocked."
 };
+var REQUIRED_BY_KIND = {
+  short_text: "Enter your answer",
+  long_text: "Enter your answer",
+  email: "Enter an email address",
+  url: "Enter a URL",
+  phone: "Enter a phone number",
+  number: "Enter a number",
+  select: "Choose an option",
+  dropdown: "Choose an option",
+  multi_select: "Select at least one option",
+  checkbox: "Select this checkbox",
+  rating: "Choose a rating",
+  linear_scale: "Choose a value",
+  ranking: "Rank every option",
+  matrix: "Answer every row",
+  signature: "Add your signature",
+  date: "Enter a date",
+  file_upload: "Add a file"
+};
+function defaultRequiredForField(field2) {
+  return REQUIRED_BY_KIND[field2.kind] ?? REQUIRED_FIELD_MESSAGE;
+}
 var DEFAULT_FIELD_STRINGS = {
   required: REQUIRED_FIELD_MESSAGE,
+  requiredForField: defaultRequiredForField,
   resumeLinkExpired: "That saved-progress link expired or was already used \u2014 start again below.",
   alreadyAnswered: "You've already answered this form.",
   uploadRetry: "Retry",
-  uploadsDisabled: "Uploads are disabled in preview",
+  uploadCancel: "Cancel",
+  uploadRemove: "Remove",
+  uploadDismiss: "Dismiss",
+  uploadingFile: (percent, size) => `Uploading \xB7 ${percent}% \xB7 ${size}`,
+  uploadedFile: (size) => `Uploaded \xB7 ${size}`,
+  uploadsDisabled: "Connect this form to Fillo to enable uploads",
+  uploadsRenderOnly: "Uploads are unavailable in this render-only preview",
   uploadsUnavailable: "Uploads are temporarily unavailable",
   uploadUnavailable: "We couldn't upload this file right now. Try again in a moment.",
   uploadFailed: "Upload failed \u2014 try again",
@@ -721,15 +752,22 @@ var DEFAULT_FIELD_STRINGS = {
   uploadsFailed: (count) => `${count} ${count === 1 ? "upload" : "uploads"} failed.`,
   filesUploaded: (count) => `${count} ${count === 1 ? "file" : "files"} uploaded.`,
   submittingAnnouncement: "Submitting your response\u2026",
-  errorSummaryTitle: "Please fix the following:",
+  errorSummaryTitle: "Check these fields",
   rankingPosition: (label, position, count) => `${label}, position ${position} of ${count}`,
   phoneCountrySelected: (name) => `${name} selected`,
   phoneResultsCount: (count) => `${count} ${count === 1 ? "result" : "results"}`,
   signatureEmpty: "No signature yet",
   signatureSigned: "Signature saved"
 };
+function requiredFieldMessage(field2, strings) {
+  return strings.requiredForField?.(field2) ?? strings.required;
+}
 function resolveStrings(overrides) {
-  return overrides ? { ...DEFAULT_STRINGS, ...DEFAULT_FIELD_STRINGS, ...overrides } : { ...DEFAULT_STRINGS, ...DEFAULT_FIELD_STRINGS };
+  const resolved = overrides ? { ...DEFAULT_STRINGS, ...DEFAULT_FIELD_STRINGS, ...overrides } : { ...DEFAULT_STRINGS, ...DEFAULT_FIELD_STRINGS };
+  if (overrides && Object.prototype.hasOwnProperty.call(overrides, "required") && !Object.prototype.hasOwnProperty.call(overrides, "requiredForField")) {
+    delete resolved.requiredForField;
+  }
+  return resolved;
 }
 
 // src/validation.ts
@@ -959,7 +997,7 @@ var schemaShape = z2.object({
 });
 var MAX_SCHEMA_VERSION = 1;
 var FILLO_SCHEMA_VERSION = 1;
-var FILLO_SDK_VERSION = true ? "0.11.0" : "0.0.0-dev";
+var FILLO_SDK_VERSION = true ? "0.12.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";
@@ -1346,9 +1384,9 @@ function normalizeBlock(input) {
         decimals: finite(rec.decimals) === void 0 ? void 0 : int(rec.decimals, 0, 6, 0),
         prefix: optionalAffix(rec.prefix, 100),
         suffix: optionalAffix(rec.suffix, 100),
-        // The only supported value; anything else drops silently rather than
+        // The only supported values; anything else drops silently rather than
         // erroring (an old/garbage value is just "no grouping").
-        notation: rec.notation === "grouped" ? "grouped" : void 0
+        notation: rec.notation === "grouped" ? "grouped" : rec.notation === "grouped-comma" ? "grouped-comma" : rec.notation === "grouped-dot" ? "grouped-dot" : void 0
       });
     case "select":
     case "multi_select":
@@ -1640,6 +1678,17 @@ function formatAnswer(field2, value) {
 function clampDecimals2(decimals) {
   return Math.max(0, Math.min(6, Math.round(decimals)));
 }
+function localeForNotation(notation) {
+  switch (notation) {
+    case "grouped-comma":
+      return "en-US";
+    case "grouped-dot":
+      return "de-DE";
+    case "grouped":
+    case void 0:
+      return void 0;
+  }
+}
 function formatGroupedNumber(value, opts) {
   if (!Number.isFinite(value)) return String(value);
   const decimals = opts?.decimals === void 0 ? void 0 : clampDecimals2(opts.decimals);
@@ -1661,17 +1710,17 @@ function stripAll(text, separator) {
 function toCanonicalDecimal(text, decimal) {
   return decimal === "." ? text : text.split(decimal).join(".");
 }
-function resolveDotGroup(body, decimal) {
-  if (decimal !== "." && body.includes(decimal)) {
+function resolveAmbiguousGrouping(body, group, decimal) {
+  if (decimal !== group && body.includes(decimal)) {
     const i = body.lastIndexOf(decimal);
-    const intPart = stripAll(body.slice(0, i), ".");
+    const intPart = stripAll(body.slice(0, i), group);
     const fracPart = body.slice(i + decimal.length);
     return `${intPart}.${fracPart}`;
   }
-  const segments = body.split(".");
+  const segments = body.split(group);
   if (segments.length === 1) return body;
   const isPureGrouping = segments.every(
-    (seg, i) => i === 0 ? /^\d{1,3}$/.test(seg) : /^\d{3}$/.test(seg)
+    (seg, i) => i === 0 ? /^[1-9]\d{0,2}$/.test(seg) : /^\d{3}$/.test(seg)
   );
   if (isPureGrouping) return segments.join("");
   return `${segments.slice(0, -1).join("")}.${segments.at(-1) ?? ""}`;
@@ -1687,8 +1736,8 @@ function parseGroupedNumber(text, locale) {
   if (negative) body = body.slice(1);
   if (/^\s$/.test(group)) {
     body = toCanonicalDecimal(body.replace(/\s/g, ""), decimal);
-  } else if (group === ".") {
-    body = resolveDotGroup(body, decimal);
+  } else if (group === "." || group === ",") {
+    body = resolveAmbiguousGrouping(body, group, decimal);
   } else {
     body = toCanonicalDecimal(stripAll(body, group), decimal);
   }
@@ -3305,8 +3354,14 @@ function createFormController(options2) {
     scheduleDraftSave();
   }
   function setUploading(fieldId, busy) {
-    if (busy) uploadingFields.add(fieldId);
-    else uploadingFields.delete(fieldId);
+    if (busy) {
+      uploadingFields.add(fieldId);
+      if (fieldId in errors) {
+        errors = Object.fromEntries(Object.entries(errors).filter(([k]) => k !== fieldId));
+      }
+    } else {
+      uploadingFields.delete(fieldId);
+    }
     notify();
   }
   function currentSeqPosition(seq) {
@@ -3366,9 +3421,26 @@ function createFormController(options2) {
     if (status === "submitting" || status === "submitted") return;
     const result = validateResponse(form, data);
     if (!result.ok) {
-      errors = result.errors;
+      const transportlessPreview = options2.skipValidation && !(client && formId);
+      const previewErrors = transportlessPreview ? Object.fromEntries(
+        Object.entries(result.errors).filter(
+          ([fieldId]) => form.pages.every(
+            (page) => page.blocks.every(
+              (block) => !(isField(block) && block.id === fieldId && block.kind === "file_upload")
+            )
+          )
+        )
+      ) : result.errors;
+      if (transportlessPreview && Object.keys(previewErrors).length === 0) {
+        errors = {};
+        status = "submitted";
+        notify();
+        emitSubmitted(void 0, data);
+        return;
+      }
+      errors = previewErrors;
       const firstBad = form.pages.findIndex(
-        (p) => visiblePageBlocks(form, p, data).some((b) => b.id in result.errors)
+        (p) => visiblePageBlocks(form, p, data).some((b) => b.id in previewErrors)
       );
       if (firstBad >= 0) pageIndex = firstBad;
       notify();
@@ -3789,12 +3861,16 @@ function syncCodeForm(client, form, opts) {
   const content2 = JSON.stringify(form.schema) + JSON.stringify(form.theme ?? null);
   const hash = contentHash(content2);
   const key = `${client.baseUrl}:${client.key}:${form.id}:${hash}`;
+  const revalidateUploadState = allFields(form.schema).some(
+    (field2) => field2.kind === "file_upload"
+  );
   const cached = syncCache.get(key);
   if (cached && !opts?.bypassCache) {
-    if (cached.expiresAt === null || cached.expiresAt > Date.now()) return cached.promise;
+    if (cached.expiresAt === null || !revalidateUploadState && cached.expiresAt > Date.now())
+      return cached.promise;
     syncCache.delete(key);
   }
-  if (!opts?.bypassCache) {
+  if (!opts?.bypassCache && !revalidateUploadState) {
     const stored = readStoredSync(client, form.id, hash);
     if (stored) {
       const promise2 = Promise.resolve({
@@ -3816,7 +3892,7 @@ function syncCodeForm(client, form, opts) {
   promise.then(
     (result) => {
       if (syncCache.get(key) !== entry) return;
-      if (isVolatileSync(result)) {
+      if (revalidateUploadState || isVolatileSync(result)) {
         syncCache.delete(key);
         return;
       }
@@ -4252,6 +4328,7 @@ export {
   isPossiblePhone,
   isTerminalPage,
   isValidPartialNumberText,
+  localeForNotation,
   needsExplicitSubmit,
   normalizeFormSchema,
   normalizeFormTheme,
@@ -4267,6 +4344,7 @@ export {
   reachableFields,
   reachablePageIds,
   reachablePageSequence,
+  requiredFieldMessage,
   resolveNextPage,
   resolveSlotClass,
   resolveStrings,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usefillo/core",
-  "version": "0.11.0",
+  "version": "0.12.1",
   "description": "Form schema, validation, logic engine and JS client for Fillo. Framework-agnostic.",
   "license": "MIT",
   "keywords": [
@@ -32,6 +32,7 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
+    "jsdom": "^25.0.1",
     "tsup": "^8.4.0",
     "typescript": "^5.8.3"
   },