@ozura/elements 1.3.1-next.78 → 1.3.1-next.79

package/README.md

@@ -810,7 +810,7 @@ import { OzBankAccountNumber, OzBankRoutingNumber } from '@ozura/elements/react'
 ### useOzElements()
 
 ```ts
-const { createToken, createBankToken, reset, ready, initError, tokenizeCount } = useOzElements();
+const { createToken, createBankToken, reset, ready, initError, tokenizeCount, isComplete, isBankComplete, isTokenizing } = useOzElements();
 ```
 
 Must be called from inside an `<OzElements>` provider tree.
@@ -823,6 +823,9 @@ Must be called from inside an `<OzElements>` provider tree.
 | `ready` | `boolean` | `true` when the tokenizer **and** all mounted element iframes are ready. Gate your submit button on this. See note below. |
 | `initError` | `Error \| null` | Non-null if `OzVault.create()` failed (e.g. session endpoint unreachable). Render a fallback UI. |
 | `tokenizeCount` | `number` | Number of successful tokenizations in the current session. Resets on session refresh or provider re-init. Useful for tracking calls against `sessionLimit`. |
+| `isComplete` | `boolean` | `true` when every mounted **card** field reports complete and valid. Gate the pay button on it without wiring per-field `onChange`. Reactive — updates as the customer types. |
+| `isBankComplete` | `boolean` | Same as `isComplete`, but for mounted **bank** fields (`OzBankCard` / bank elements). Card and bank completion are tracked independently. |
+| `isTokenizing` | `boolean` | `true` while `createToken()` / `createBankToken()` is in progress (including the transparent wax-key refresh). Keep the pay button disabled to prevent double-submission. |
 
 > **`ready` vs `vault.isReady`:** `ready` from `useOzElements()` is a composite — it combines `vault.isReady` (tokenizer loaded) with element readiness (all mounted input iframes loaded). `vault.isReady` alone is insufficient for gating a submit button. Always use `ready` from `useOzElements()` in React.
 
@@ -937,6 +940,9 @@ Keys exist only for fields you have created (card and bank combined), so access
 | `initError` | `Ref<Error \| null>` | Non-null if `OzVault.create()` failed. Render a fallback UI. |
 | `tokenizeCount` | `Ref<number>` | Successful tokenizations in the current session. Resets on session refresh. |
 | `reset` | `() => void` | Clear all fields without destroying the vault. Call after a declined payment. |
+| `isComplete` | `ComputedRef<boolean>` | `true` when every mounted **card** field reports complete and valid. Gate the pay button on it. |
+| `isBankComplete` | `ComputedRef<boolean>` | Same as `isComplete`, but for mounted **bank** fields. Tracked independently. |
+| `isTokenizing` | `ComputedRef<boolean>` | `true` while `createToken()` / `createBankToken()` is in progress (incl. wax-key refresh). Keep the pay button disabled. |
 
 ### useFieldStates()
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ozura/elements",
-  "version": "1.3.1-next.78",
+  "version": "1.3.1-next.79",
   "description": "PCI-compliant card tokenization SDK for the Ozura Vault — collect card data in iframe-isolated fields and tokenize without PCI scope",
   "main": "dist/oz-elements.umd.js",
   "module": "dist/oz-elements.esm.js",