@parag.more.withsurface.com/forms-sdk 0.1.5 → 0.1.7

package/README.md

@@ -4,10 +4,10 @@ Build Surface forms as **your own pages**. The form record on Surface stays the
 data model — steps, questions, validation, enrichment, tracking settings — while
 your HTML/CSS/JS owns every pixel and every navigation decision. The SDK binds
 the two: a headless, dependency-free engine over Surface's public runtime
-endpoints, a `data-*` DOM binding layer, a React adapter, an unstyled booking
-widget for Surface schedulers, and settings-driven tag/conversion tracking
-(GTM/GA4/Meta/HubSpot + ad conversions). ~18 kB gzipped, zero runtime
-dependencies.
+endpoints, a `data-*` DOM binding layer, a React adapter, embedded schedulers
+(Surface's own + every provider native forms support) with automatic booking
+tracking, and settings-driven tag/conversion tracking (GTM/GA4/Meta/HubSpot +
+ad conversions). ~22 kB gzipped, zero runtime dependencies.
 
 > **Working with an AI agent?** This package ships agent-ready docs:
 > [`llms.txt`](llms.txt) is the binding contract and boot guide,
@@ -44,6 +44,11 @@ Highlights beyond binding:
 
 - **Headless + React** — drive everything with `setAnswer`/`submit`/`state`,
   or `useSurfaceForm` from `<package>/react`.
+- **Embedded schedulers** — `mountScheduler({ form, container })` renders the
+  record's scheduler (Surface, Calendly, Cal.com, SavvyCal, Chili Piper,
+  HubSpot, RevenueHero, Zoom, Reclaim.ai, Clari), tracks the booking lifecycle
+  on `form.on("scheduler")`, and persists the booking automatically; an
+  unstyled widget remains for fully custom booking UIs.
 - **Resume** — persist the `saved` event's `{ responseId, resumeToken }` and
   pass `resume:` to continue a response later.
 - **Email validation** — `form.validateEmail()` on demand, or
@@ -52,8 +57,9 @@ Highlights beyond binding:
   provider; check `form.capabilities.enrichment`.
 - **Preview mode** — `preview: true` (+ `previewToken` for unpublished drafts)
   renders and navigates with zero network writes.
-- **Reliable finish** — the terminal write is awaited; `await form.flush()`
-  before programmatic teardown.
+- **Reliable finish, instant steps** — the terminal write is awaited; partial
+  saves land behind the step change so `next()` never waits on the network;
+  `await form.flush()` before programmatic teardown.
 
 ## Authoring loop (with the Surface MCP tools)