@usefillo/core 0.6.0 → 0.6.2

package/README.md

@@ -38,3 +38,10 @@ Key exports: `createClient` / `FilloClient`, `defineForm`, `validateResponse`, `
 - **Website:** [fillo.so](https://fillo.so)
 
 MIT licensed.
+
+## 0.6.0 surface
+
+Framework-neutral pieces the renderers share: `defineForm` / `schemaFromJsx`
+(the JSX compiler), `when()` condition builder, the `FilloAppearance` styling
+contract (slots + data-attribute names), `FilloStrings` localization defaults,
+and `createClient({ baseUrl })` for staging/self-hosted targets.

package/dist/index.d.ts

@@ -300,7 +300,8 @@ interface ValidationResult {
 declare function validateResponse(form: FormSchema, data: ResponseData): ValidationResult;
 
 declare const FILLO_SCHEMA_VERSION: 1;
-declare const FILLO_SDK_VERSION = "0.5.0";
+/** Injected from package.json at build time (tsup define) — never hand-edited. */
+declare const FILLO_SDK_VERSION: string;
 interface SchemaValidationResult {
     ok: boolean;
     /** Present when ok — a normalized, structurally-valid schema. */
@@ -491,7 +492,7 @@ interface SubmitMeta {
     hp?: string;
     /** Time from first render to submit. */
     elapsedMs?: number;
-    /** Embedding surface; "headless" submissions require a paid plan (server-enforced). */
+    /** Embedding surface, recorded per response for measurement — never gated. */
     surface?: "default" | "headless";
     /**
      * Browser-scoped de-duplication key sent when a form opts into
@@ -572,7 +573,7 @@ declare class FilloClient {
      * is sent twice or skipped.
      *
      * Depending on the form's storage settings the server picks a transport:
-     * Fillo's own chunk protocol, or direct-to-Google-Drive resumable
+     * direct-to-Google-Drive resumable
      * sessions — in which case the bytes go straight from this browser to the
      * form owner's Drive and never touch the Fillo server.
      */
@@ -764,6 +765,8 @@ declare const FILLO_DATA_ATTRS: {
     readonly field: "data-field";
     readonly invalid: "data-invalid";
     readonly required: "data-required";
+    /** Option id, on each choice row (pre-existing selector hook). */
+    readonly option: "data-option";
     /** Selected option row / active scale step / active star. */
     readonly selected: "data-selected";
     /** Checkbox / toggle checked state. */
@@ -806,6 +809,35 @@ interface FilloAppearance {
 declare function resolveSlotClass(appearance: FilloAppearance | undefined, state: SlotState): string;
 /** Append resolved consumer classes to a base fillo-* class string. */
 declare function slotClass(base: string, appearance: FilloAppearance | undefined, state: SlotState): string;
+/** The CSS custom properties the default theme runs on. `themeProp` names the
+ * FormTheme key that sets a token (inline, synced to the hosted page); tokens
+ * without one are stylesheet-only and overridable from consumer CSS. */
+declare const FILLO_THEME_VARS: readonly [{
+    readonly var: "--fillo-primary";
+    readonly themeProp: "primary";
+}, {
+    readonly var: "--fillo-bg";
+    readonly themeProp: "background";
+}, {
+    readonly var: "--fillo-text";
+    readonly themeProp: "text";
+}, {
+    readonly var: "--fillo-radius";
+    readonly themeProp: "radius";
+}, {
+    readonly var: "--fillo-font";
+    readonly themeProp: "fontFamily";
+}, {
+    readonly var: "--fillo-muted";
+}, {
+    readonly var: "--fillo-border";
+}, {
+    readonly var: "--fillo-control-bg";
+}, {
+    readonly var: "--fillo-error";
+}, {
+    readonly var: "--fillo-primary-contrast";
+}];
 
 /**
  * Every visitor-facing string the default renderers emit, overridable as a
@@ -1004,4 +1036,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 CheckboxField, type ChoiceField, type CodeForm, type Condition, type ConditionOp, type ContentBlock, type ContentKind, type CustomField, DEFAULT_STRINGS, DRAFT_KINDS, type DateField, type DividerBlock, FILLO_DATA_ATTRS, FILLO_SCHEMA_VERSION, FILLO_SDK_VERSION, FILLO_SLOTS, type Field, type FieldKind, type FieldSpec, type FieldValue, type FileUploadField, type FileValue, type FilloAppearance, FilloClient, type FilloClientOptions, FilloError, FilloJsxError, 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 LinearScaleField, type MatrixField, type NumberField, PHONE_COUNTRIES, type ParagraphBlock, type ParsedPhone, type PhoneCountry, type PhoneField, type ProvisionWorkspaceResult, type PublishedForm, type RankingField, type RatingField, type ResponseData, type SchemaValidationResult, type SelectOption, Sha1, type SignatureField, type SlotClass, type SlotState, type SubmitMeta, type SubmitResult, type SyncFormResult, type SyncedForm, type TextField, type UploadFileOptions, type UploadProgress, type UploadSession, type UploadStatus, type UploadTransport, type ValidationResult, type WhenBuilder, allFields, assembleForm, codeFormFromJsx, contentHash, countryByDialCode, countryByIso, countryByTimeZone, createBlock, createClient, createEmptyForm, createFormController, createId, defineForm, digitsOnly, flagEmoji, formatAnswer, formatNational, isAutoSubmitBlock, isBlockVisible, isCodeForm, isField, isFilloError, isPossiblePhone, needsExplicitSubmit, normalizeFormSchema, normalizeFormTheme, parsePhone, pipeBlock, prefillFromParams, provisionWorkspace, resolveSlotClass, resolveStrings, resolveText, schemaFromJsx, sha1Base64, shouldAutoSubmit, slotClass, syncCodeForm, toE164, validateField, validateFormSchema, validateResponse, visibleBlocks, visibleFields, when };
+export { type AutoSubmitContext, BLOCK_KIND_META, type BaseField, type Block, type BlockKind, CONTENT_KINDS, type CheckboxField, type ChoiceField, type CodeForm, type Condition, type ConditionOp, type ContentBlock, type ContentKind, type CustomField, DEFAULT_STRINGS, DRAFT_KINDS, type DateField, type DividerBlock, FILLO_DATA_ATTRS, 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, FilloJsxError, 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 LinearScaleField, type MatrixField, type NumberField, PHONE_COUNTRIES, type ParagraphBlock, type ParsedPhone, type PhoneCountry, type PhoneField, type ProvisionWorkspaceResult, type PublishedForm, type RankingField, type RatingField, type ResponseData, type SchemaValidationResult, type SelectOption, Sha1, type SignatureField, type SlotClass, type SlotState, type SubmitMeta, type SubmitResult, type SyncFormResult, type SyncedForm, type TextField, type UploadFileOptions, type UploadProgress, type UploadSession, type UploadStatus, type UploadTransport, type ValidationResult, type WhenBuilder, allFields, assembleForm, codeFormFromJsx, contentHash, countryByDialCode, countryByIso, countryByTimeZone, createBlock, createClient, createEmptyForm, createFormController, createId, defineForm, digitsOnly, flagEmoji, formatAnswer, formatNational, isAutoSubmitBlock, isBlockVisible, isCodeForm, isField, isFilloError, isPossiblePhone, needsExplicitSubmit, normalizeFormSchema, normalizeFormTheme, parsePhone, pipeBlock, prefillFromParams, provisionWorkspace, resolveSlotClass, resolveStrings, resolveText, schemaFromJsx, sha1Base64, shouldAutoSubmit, slotClass, syncCodeForm, toE164, validateField, validateFormSchema, validateResponse, visibleBlocks, visibleFields, when };

package/dist/index.js

@@ -594,7 +594,7 @@ var schemaShape = z2.object({
 });
 var MAX_SCHEMA_VERSION = 1;
 var FILLO_SCHEMA_VERSION = 1;
-var FILLO_SDK_VERSION = "0.5.0";
+var FILLO_SDK_VERSION = true ? "0.6.2" : "0.0.0-dev";
 function str(value, max, fallback = "") {
   return typeof value === "string" ? value.trim().slice(0, max) : fallback;
 }
@@ -1463,7 +1463,7 @@ var FilloClient = class {
    * is sent twice or skipped.
    *
    * Depending on the form's storage settings the server picks a transport:
-   * Fillo's own chunk protocol, or direct-to-Google-Drive resumable
+   * direct-to-Google-Drive resumable
    * sessions — in which case the bytes go straight from this browser to the
    * form owner's Drive and never touch the Fillo server.
    */
@@ -1806,6 +1806,14 @@ function prefillFromParams(form, params) {
 // src/controller.ts
 var EMPTY_PAGE = { id: "empty", blocks: [] };
 var warnedNoClient = false;
+var warnedNoFormId = false;
+function warnNoFormId() {
+  if (warnedNoFormId) return;
+  warnedNoFormId = true;
+  console.warn(
+    "[fillo] This form has a client but no submission target \u2014 a bare schema can't sync. Wrap it in defineForm({ id, pages }) (or author it with <Fillo.Form id=\u2026>) so it gets a workspace handle, or pass formId for a dashboard-built form: https://fillo.so/docs"
+  );
+}
 function warnNoClient() {
   if (warnedNoClient) return;
   warnedNoClient = true;
@@ -2057,7 +2065,8 @@ function createFormController(options2) {
       emitSubmitted(void 0, result.data);
       return;
     }
-    warnNoClient();
+    if (client && !formId) warnNoFormId();
+    else warnNoClient();
     status = "error";
     notify();
   }
@@ -2157,6 +2166,8 @@ var FILLO_DATA_ATTRS = {
   field: "data-field",
   invalid: "data-invalid",
   required: "data-required",
+  /** Option id, on each choice row (pre-existing selector hook). */
+  option: "data-option",
   /** Selected option row / active scale step / active star. */
   selected: "data-selected",
   /** Checkbox / toggle checked state. */
@@ -2180,6 +2191,18 @@ function slotClass(base, appearance, state) {
   const extra = resolveSlotClass(appearance, state);
   return extra ? `${base} ${extra}` : base;
 }
+var FILLO_THEME_VARS = [
+  { var: "--fillo-primary", themeProp: "primary" },
+  { var: "--fillo-bg", themeProp: "background" },
+  { var: "--fillo-text", themeProp: "text" },
+  { var: "--fillo-radius", themeProp: "radius" },
+  { var: "--fillo-font", themeProp: "fontFamily" },
+  { var: "--fillo-muted" },
+  { var: "--fillo-border" },
+  { var: "--fillo-control-bg" },
+  { var: "--fillo-error" },
+  { var: "--fillo-primary-contrast" }
+];
 
 // src/strings.ts
 var DEFAULT_STRINGS = {
@@ -2634,6 +2657,7 @@ export {
   FILLO_SCHEMA_VERSION,
   FILLO_SDK_VERSION,
   FILLO_SLOTS,
+  FILLO_THEME_VARS,
   FilloClient,
   FilloError,
   FilloJsxError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usefillo/core",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Form schema, validation, logic engine and JS client for Fillo. Framework-agnostic.",
   "license": "MIT",
   "keywords": [
@@ -36,7 +36,7 @@
     "typescript": "^5.8.3"
   },
   "scripts": {
-    "build": "tsup src/index.ts --format esm --dts --clean",
+    "build": "tsup",
     "dev": "tsup src/index.ts --format esm --dts --watch",
     "typecheck": "tsc --noEmit",
     "test": "node --test test/*.test.mjs"