@usefillo/core 0.11.0 → 0.12.0

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;
@@ -1753,8 +1772,10 @@ interface FilloFieldStrings {
     alreadyAnswered: string;
     /** Retry control on a failed upload row. */
     uploadRetry: string;
-    /** Dropzone copy when uploads can't run (no client / preview). */
+    /** 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. */
@@ -2037,4 +2058,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, 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;
@@ -710,7 +712,8 @@ var DEFAULT_FIELD_STRINGS = {
   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",
+  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",
@@ -959,7 +962,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.0" : "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 +1349,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 +1643,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 +1675,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 +1701,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);
   }
@@ -3366,9 +3380,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();
@@ -4252,6 +4283,7 @@ export {
   isPossiblePhone,
   isTerminalPage,
   isValidPartialNumberText,
+  localeForNotation,
   needsExplicitSubmit,
   normalizeFormSchema,
   normalizeFormTheme,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usefillo/core",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "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"
   },