formtress-js 0.2.1 → 0.2.2

package/README.md

@@ -19,7 +19,7 @@
 Add the following script to your Webflow project settings before the closing `</body>` tag (change `latest` to the version you want to use):
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/formtress-js@0.2.0/dist/js/webflow.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/formtress-js@latest/dist/js/webflow.js"></script>
 ```
 
 > Note: It's recommended to pin to a specific version in production for stability. Check the version badge above for the current release.

package/dist/types/core.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Core Formtress module.
+ * Use this when you want to manually call the submit function from your own code.
+ *
+ * Set the form `action` to your Formtress endpoint for progressive enhancement
+ * (works without JS), then intercept the submit to enhance the UX:
+ *
+ * @example
+ * ```html
+ * <form id="my-form" action="https://app.formtress.com/api/f/your-form-id" method="POST">
+ * ```
+ * ```js
+ * import { submitForm } from 'formtress-js'
+ *
+ * const form = document.querySelector('#my-form')
+ * form.addEventListener('submit', async (e) => {
+ *   e.preventDefault()
+ *   const result = await submitForm({
+ *     url: form.action,
+ *     data: new FormData(form),
+ *   })
+ *   if (result.ok) {
+ *     // show success state
+ *   } else {
+ *     // show error state: result.message, result.status
+ *   }
+ * })
+ * ```
+ */
+export { submitForm, type SubmitOptions, type SubmitResult } from './shared/submit';

package/dist/types/shared/submit.d.ts

@@ -0,0 +1,21 @@
+export interface SubmitOptions {
+    /** The full Formtress endpoint URL (e.g. https://app.formtress.com/api/f/your-form-id) */
+    url: string;
+    /** The form data to send */
+    data: FormData;
+    /** HTTP method (defaults to POST) */
+    method?: string;
+    /** Additional headers to include */
+    headers?: Record<string, string>;
+}
+export interface SubmitResult {
+    ok: boolean;
+    status: number;
+    message: string;
+    /** Optional redirect URL returned by the API */
+    redirect?: string;
+}
+/**
+ * Submit form data to Formtress.
+ */
+export declare function submitForm(options: SubmitOptions): Promise<SubmitResult>;

package/dist/types/webflow.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Webflow integration for Formtress — v0.2.0
+ * Progressive enhancement — no imports — works as a standalone CDN script.
+ *
+ * Set your Webflow form's `action` attribute to your Formtress endpoint:
+ *   https://app.formtress.com/api/f/{your-form-id}
+ *
+ * Without JavaScript: the form submits natively to the Formtress endpoint.
+ * With JavaScript: submission is intercepted and Webflow's UX flow is applied
+ *   (loading state, success/fail panels) without a page reload.
+ *
+ * Relies on Webflow's native .w-form, .w-form-done, and .w-form-fail classes.
+ *
+ * Submit button detection (in order):
+ *   1. input.w-button (native Webflow input)
+ *   2. button:not([type="button"]), input[type="submit"] (custom buttons)
+ *
+ * Loading text: add `data-ft-loading-text="Loading..."` to any text element inside
+ *   the form. Its textContent is swapped to the attribute value during submission.
+ *   Falls back to `data-wait` (on the element or submit button), then "Please wait...".
+ * Native .w-button: uses `data-wait` as Webflow does.
+ */
+export {};

package/package.json

@@ -3,23 +3,28 @@
   "description": "A tiny library for managing Formtress forms",
   "private": false,
   "license": "MIT",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "type": "module",
   "main": "dist/js/core.js",
   "module": "dist/js/core.js",
+  "types": "dist/types/core.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/types/core.d.ts",
       "import": "./dist/js/core.js"
     },
     "./core": {
+      "types": "./dist/types/core.d.ts",
       "import": "./dist/js/core.js"
     },
     "./webflow": {
+      "types": "./dist/types/webflow.d.ts",
       "import": "./dist/js/webflow.js"
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "dist/types"
   ],
   "homepage": "https://formtress.com",
   "author": "Christos Soulaki",