mosaic-headless 1.26.1 → 1.27.0

package/references/placement.md

@@ -115,3 +115,41 @@ Reach for the measured table when you are deciding what to build with, and this
 when you are deciding what may go inside what. `tools/check_placement_predicts.py`
 re-scores the numbers above after any re-sweep, so the claim stays honest if the
 plugin changes.
+
+## `nested_under`: what a type is looking for above it
+
+`rule` is the `canBeParentFor()` answer — "will the editor let me drop this here".
+Many types also implement `canBeNestedChildFor()`, which walks the parent chain at
+runtime looking for ONE ancestor class, and until now this table only recorded
+that such a rule existed. The `nested_under` column now names it. 54 of 128 types
+have one, and the names usually share no prefix with the type, so there is no way
+to infer it:
+
+| type | needs above it |
+|---|---|
+| `radio-input`, `checkbox-input`, `choice-label` | `choice` |
+| `choice`, | `choice-field` |
+| `label`, `fileupload-input` | `field` |
+| `choice-field`, `fieldset`, `field`, `hidden-input` | `choice-field` \| `field` \| `form` |
+| `loop-item` | `loop-items` |
+| `loop-pagination` | `loop` |
+| `list-item` | `list` \| `list-loop-items` \| `wp-menu` |
+| `accordion-item` | `accordion` \| `accordion-loop-items` |
+
+A node committed without its required ancestor is **accepted and discarded**. The
+commit returns no exception, the page renders, and the element is simply not
+there — which is how a form came back with two fieldsets and no fields.
+`build_page.py` reads this column and now carries the ancestor chain down the walk,
+so a correct placement is allowed and an incorrect one is refused before the write
+rather than silently lost after it.
+
+Two other things the table was short of, both fixed the same way — by reading the
+source the column was derived from rather than the one it was convenient to read:
+
+- **`takes_children`**, from the factory's `getDefaultData($data, $children)`
+  signature. `dropdown-wrapper` answers `none` to `canBeParentFor` and holds the
+  menu's links regardless.
+- **two missing types.** `fieldset-legend` and `fieldset-content` are declared by
+  an `*ElementMResourceFactory.php`; every extractor walked
+  `*ElementTypeFactory.php` only, so they were absent from the catalog and a
+  fieldset appeared to have no inner structure.

package/scripts/check-release.mjs

@@ -101,9 +101,10 @@ const counts = {
   "data/dialog-verification.csv": 19,
   "data/slider-verification.csv": 30,
   "data/token-verification.csv": 15,
-  "data/mobile-audit.csv": 58,
-  "data/component-wall-verification.csv": 11,
-  "data/navigation-verification.csv": 33,
+  "data/mobile-audit.csv": 60,
+  "data/component-wall-verification.csv": 13,
+  "data/form-surface-verification.csv": 8,
+  "data/navigation-verification.csv": 36,
   "data/page-modal-verification.csv": 19,
   "data/interaction-rules-verification.csv": 17,
   "data/dialog-form-verification.csv": 49,

package/sites/_moksa.py

@@ -304,6 +304,8 @@ CONVERTED_COUNT = _count("conversion-batch.csv",
 
 # label, href, one line of what it demonstrates
 CAPABILITIES = [
+    ("表單", "/forms/",
+     "下拉、單選、複選、上傳、必填規則與錯誤訊息"),
     ("元件牆", "/components/",
      "分頁、手風琴、表單、地圖——都能直接操作"),
     ("彈窗與觸發", "/dialogs/",
@@ -3228,6 +3230,10 @@ if __name__ == "__main__":
     # helpers it reads are pure functions - two copies produce identical dicts.
     import _dialogs
     import _sliders
+    import _forms
+    SITE["pages"].append({"slug": "forms", "post_id": 282,
+                          "title": "表單",
+                          "tree": apply_type(_forms.TREE, DISPLAY, CJK, "600")})
     import _components
     SITE["pages"].append({"slug": "components", "post_id": 281,
                           "title": "元件",