@usgb/forms 1.0.3 → 1.0.4

package/README.md

@@ -35,7 +35,7 @@ Use `listFormDefinitions()` (or the manifest) when a CMS needs a picker of avail
 | --------------------------- | ------------ | --------------------------------------------------------- | --------------------------------------------------------------- | ------------------------------------------------------------ |
 | `magento-fik`               | `lead`       | First name, last name, email (required); phone (optional) | Optional TCPA (v1), marketing SMS, and terms/privacy checkboxes | `dense`, `large`, or `sidebar`; optional two-column name row |
 | `magento-ira-kick-article`  | `lead`       | First name, last name, email, phone (all required)        | Optional TCPA checkbox (v2, links terms and privacy)            | `dense`, `large`, or `sidebar`; optional two-column name row |
-| `magento-fik-blog-rail`     | `lead`       | First name, last name, email, phone (all required)        | Optional TCPA checkbox (v2, links terms and privacy)            | `dense`, `large`, or `sidebar`; optional two-column name row |
+| `magento-fik-blog-rail`     | `lead`       | First name, last name, email, phone (all required)        | Required TCPA checkbox (v3, links terms and privacy)            | `dense`, `large`, or `sidebar`; optional two-column name row |
 | `main-investors-kit-notice` | `lead`       | Same as `magento-fik`                                     | Clickwrap notice only (`lead-clickwrap` v2)                     | `dense`, `large`, or `sidebar`; optional two-column name row |
 | `newsletter`                | `newsletter` | Email only                                                | None                                                            | None — omit `variant` and `twoColumn` / `two-column`         |
 
@@ -95,7 +95,7 @@ Peer dependency: `react` and `react-dom` `^18` or `^19`.
 Load the built script for a release (styles inject themselves):
 
 ```html
-<script src="https://forms.usgoldbureau.com/usgb-forms.1.0.3.js"></script>
+<script src="https://forms.usgoldbureau.com/usgb-forms.1.0.4.js"></script>
 ```
 
 Pin the script and the catalog together: `usgb-forms.<version>.js` and `forms-manifest.<version>.json` on `https://forms.usgoldbureau.com/`. Gutenberg should load that matching manifest when listing `formId`s.
@@ -160,7 +160,7 @@ Newsletter (no consent or lead layout options):
 Load one script. Styles are injected automatically.
 
 ```html
-<script src="https://forms.usgoldbureau.com/usgb-forms.1.0.3.js"></script>
+<script src="https://forms.usgoldbureau.com/usgb-forms.1.0.4.js"></script>
 <usgb-form
     form-id="magento-fik"
     appearance="on-dark"
@@ -269,7 +269,8 @@ Successful submits send `formId`, `definitionVersion`, `submissionContractVersio
 Consent policies are versioned and package-owned (checkboxes and/or clickwrap notices). Forms list zero or more pins (`definitionId` + `definitionVersion` + optional `required` for checkboxes). Hosts only supply document **hrefs**.
 
 -   `magento-fik` pins `lead-tcpa`, `lead-sms`, and `lead-tospp` (all v1, optional checkboxes). Required URLs: `userAgreement`, `privacyPolicy` (`user-agreement-url`, `privacy-policy-url`).
--   `magento-ira-kick-article` and `magento-fik-blog-rail` pin `lead-tcpa` v2 only (optional checkbox). Unlike v1, v2 links the terms and privacy policy, so required URLs: `userAgreement`, `privacyPolicy`.
+-   `magento-ira-kick-article` pins `lead-tcpa` v2 only (optional checkbox). Unlike v1, v2 links the terms and privacy policy, so required URLs: `userAgreement`, `privacyPolicy`.
+-   `magento-fik-blog-rail` pins `lead-tcpa` v3 only (required checkbox: automated text-message consent; “Terms of Service” links `userAgreement`, “Privacy Policy” links `privacyPolicy`). It shares the v1 payload keys. Required URLs: `userAgreement`, `privacyPolicy`.
 -   `main-investors-kit-notice` pins `lead-clickwrap` v2 (notice only: Privacy Policy, Terms & Conditions, and text/call consent). Required URLs: `privacyPolicy`, `userAgreement`. It shares the v1 payload key `clickwrap_consent_language`. `lead-clickwrap` v1 (five document links) stays in the catalog and is not pinned.
 -   `newsletter` has no consents and needs no legal URLs.
 -   `LEGAL_URL_ATTRS` lists every host-owned slot, including `clientAgreement` / `client-agreement-url`. No current catalog consent requires `clientAgreement`; it is still valid on `legalUrls` / the attribute (PWA Magento ships it in `PWA_LEGAL_URLS`).
@@ -326,6 +327,8 @@ Prefer **custom properties** on `.usgb-form` for color, type, and spacing:
 
 Use class selectors when a token does not exist (`.usgb-form .usgb-btn { border-radius: 0; }`).
 
+**Fonts.** Body copy, fields, and the button inherit the host page's `font-family`, so WordPress (`'Montserrat', sans-serif` on `body`) and the PWA (`next/font`'s hashed `__Montserrat_…` family) both render in Montserrat with no extra setup. Set `--usgb-font-primary` on `.usgb-form` only to force a different stack. The heading uses `--usgb-font-secondary`, which reads the host variable `--font-kameron` first and falls back to the `Kameron` family name; a `next/font` host should expose `Kameron({ variable: '--font-kameron' })` on `<html>`, or override `--usgb-font-secondary` directly.
+
 Stable hooks: `.usgb-form` (`data-appearance`, `data-variant`, `data-kind`), `.usgb-form-heading`, `.usgb-form-subheading`, `.usgb-form-grid`, `.usgb-form-inline`, `.usgb-field-control`, `.usgb-field-error`, `.usgb-consent-*`, `.usgb-btn`, `.usgb-form-status-*`.
 
 Semantic tokens (`--usgb-field-*`, `--usgb-button-*`, `--usgb-newsletter-underline`, …) are the first place to retheme. Palette vars (`--usgb-blue-1`, …) are a PWA snapshot. Error and checkbox glyphs are inline SVGs that use `currentColor` — override `--usgb-alert-danger` or `--usgb-checkbox-mark` to recolor them.

package/dist/{forms-manifest.1.0.3.json → forms-manifest.1.0.4.json}

@@ -342,13 +342,13 @@
             "consents": [
                 {
                     "definitionId": "lead-tcpa",
-                    "definitionVersion": "2",
-                    "required": false
+                    "definitionVersion": "3",
+                    "required": true
                 }
             ],
             "editor": {
                 "label": "Magento FIK Blog Rail",
-                "description": "First name, last name, email, and phone required. Optional telephone and SMS consent checkbox with linked terms and privacy (lead-tcpa v2).",
+                "description": "First name, last name, email, and phone required. Required automated text-message consent checkbox with linked terms of service and privacy policy (lead-tcpa v3).",
                 "whenToUse": "TBD",
                 "whenNotToUse": "TBD",
                 "options": [

package/dist/forms-manifest.json

@@ -342,13 +342,13 @@
             "consents": [
                 {
                     "definitionId": "lead-tcpa",
-                    "definitionVersion": "2",
-                    "required": false
+                    "definitionVersion": "3",
+                    "required": true
                 }
             ],
             "editor": {
                 "label": "Magento FIK Blog Rail",
-                "description": "First name, last name, email, and phone required. Optional telephone and SMS consent checkbox with linked terms and privacy (lead-tcpa v2).",
+                "description": "First name, last name, email, and phone required. Required automated text-message consent checkbox with linked terms of service and privacy policy (lead-tcpa v3).",
                 "whenToUse": "TBD",
                 "whenNotToUse": "TBD",
                 "options": [