| 1 |
--- |
| 2 |
module: gutenberg |
| 3 |
--- |
| 4 |
|
| 5 |
# gutenberg |
| 6 |
|
| 7 |
## Responsibility |
| 8 |
|
| 9 |
Owns the Gutenberg/block-editor surface for CartFlows step post types: registers four `wcfb/*` blocks (next-step-button, checkout-form, optin-form, order-detail-form), builds their editor bundle, generates per-block frontend CSS and Google-font links from saved block attributes, and serves the editor's live shortcode previews over admin-ajax. |
| 10 |
|
| 11 |
Ownership stops at the shortcodes themselves — every preview and every frontend render is `do_shortcode( '[cartflows_*]' )`. |
| 12 |
|
| 13 |
## Why it is this way |
| 14 |
|
| 15 |
Three contracts here are invisible from any single file. The attribute schema is split across JS, PHP registration and PHP config, with a different consequence for each omission. The editor preview is an AJAX round-trip whose refresh depends on a hand-maintained diff list and an `isHtml` flag doubling as a loop guard, because the `withSelect` mapper that triggers it is supposed to be pure. And the frontend CSS/font pipeline has a strict `wp` → `wp_head:80` → `wp_head:120` → `wp_footer:1000` ordering over four static mutable globals, with the fonts collected as a side effect of CSS generation. |
| 16 |
|
| 17 |
Much of `src/components/` and `src/controls/` is verbatim Spectra code, which is why the editor bundle depends on a Spectra-owned JS global. |
| 18 |
|
