Register of APB 2.1.0 incompatibilities, by-design constraints, and workarounds verified on the demo.
APB-DOCS-LIMITS
Every row below was verified on APB 2.1.0 / Drupal 11.4.x. “Product bug” means the fix belongs in an aero/* module repo, not in a site override. “By design” means the architecture will not change without an explicit product decision.
Register
| Symptom | Cause | Status | Workaround |
|---|---|---|---|
| Parents cannot nest | Host field is a flat ERR list | By design | Siblings, or placement into a region item |
| Sidebar placement hides forever | Theme prints locators only if sidebar_first has a block | Theme contract | Place a block, or do not request sidebar placement |
| Internal Placement 2 stays hidden | One-pass JS; region later in the field | By design of placement JS | Put the region parent earlier |
| Draft overlay JSON is public | Paragraph::load() + paragraph.view does not follow host moderation | Product bug | Do not put overlays on moderated nodes until fixed; 403 unpublished hosts in component JSON |
| Forward-draft overlay shows rewrite copy on the live URL | JSON has no revision parameter | Product bug | Same as above |
| Language-prefixed overlay JSON poisons the unprefixed URL | Cache omits languages:language_content | Product bug | Rebuild caches; do not share overlay pages across languages until fixed |
| A new English parent appears on Spanish | Symmetric host field | By design | Translate copy; or a future visibility field |
Links/Feature box to /form/… or Contact 500s | isTranslatable() on config entities | Product bug | Node alias, webform_node, iframe, or raw HTML anchor |
Underscore /form/{id} 404s | Webform hyphenates its own aliases | Webform behavior | Use the hyphenated alias |
| Invalid container JSON is emitted | CSS generator skips the widget validator | Product gap | Always write lengths with units; opacity 0–1 |
| Kitchen-sink edit form is ~1 MB / 2 s | Legacy widget, edit mode open | By design of the editor | Split dense briefs across URLs |
| SVG logos rejected | Infinite logos image field | Component constraint | Rasterize to PNG |
| WOW does not animate relocated parents | Orchestrator inits WOW before placement | Runtime order | Do not rely on fade-in for Top region / main-content moves |