mosaic-headless 1.21.1 → 1.21.2

package/SKILL.md

@@ -4,7 +4,7 @@ description: |
   Build and modify Mosaic Pro (Nextend) sites by writing the underlying data model directly - no visual editor, no DOM. Query the real surface with `mo.py`, which joins every source table to the live sweeps so a lookup leads with the measured verdict rather than the declaration (126 node types, 191 properties, 98 style properties with 20 structured value shapes pinned down, 53 style states, 156 variants, 74 dynamic variables, 15 interaction triggers, 115 REST routes, 23 tables) instead of guessing, with every node type placed on a live site one at a time and asserted against the delivered HTML, the design-token and element-class layers verified against compiled CSS, the @VAR() dynamic language verified against rendered output, nine designed pages built through the tables themselves, and the delivered pages re-read in Chromium at three viewports so a rule that is present, correct and still wrong cannot pass. Drives Mosaic's own theme export/import and its plugin data upgrade from outside the editor and holds the copy against the source tree for tree. Measured on Mosaic Pro 1.0.9: the modal (`<dialog>`), OpenStreetMap, the exit-intent and scroll-depth triggers, run rules and the memory actions all built on a live page and read back, and the 1.0.7 -> 1.0.8 -> 1.0.9 migrations driven from outside wp-admin.
 license: "MIT"
 author: "moksa (https://moksaweb.com)"
-version: "1.21.1"
+version: "1.21.2"
 ---
 
 # Headless Mosaic
@@ -700,6 +700,12 @@ post — `build_all.py` resets first for that reason.
   rows and `theme_zip_compare.php` reports a tree that does not match - delete
   nodes with a missing parent REPEATEDLY until none are left, because each pass
   orphans the next level down.
+- **`width` / `height` and their min/max take the keyword `stretch` since 1.0.9**,
+  and Mosaic emits `-webkit-fill-available` before it so an older engine still gets
+  something. They are still token-referencable - `CSSSizePropertyFactory` extends
+  the collection-variable one, which is why `data/style-properties.csv` resolves a
+  factory's ancestry rather than testing its name. 39 properties take a token, not
+  the 34 counted before that fix.
 - **A width copied out of Elementor needs `maxWidth: "100%"` beside it.**
   Elementor caps every widget with `max-width:100%`, so a px width there is a
   desktop intent its own CSS already constrains; carried across bare it keeps the

package/assets/templates/platforms/claude-ai.json

@@ -20,7 +20,7 @@
     "description": "Build and modify Mosaic Pro (Nextend) sites by writing the underlying data model directly - no visual editor, no DOM. Query the real surface (122 node types, 181 node properties, 98 style properties, 53 style states, 151 element classes, 74 dynamic variables, 114 REST routes, 23 tables) instead of guessing, with every node type placed on a live site one at a time and asserted against the delivered HTML, every style and node property swept against the compiled CSS and markup, and 569 responsive declarations checked against the stylesheet the site actually served.",
     "license": "MIT",
     "author": "moksa (https://moksaweb.com)",
-    "version": "1.21.1"
+    "version": "1.21.2"
   },
   "loaderBehaviour": "Upload via Settings -> Skills -> Upload. Claude.ai parses SKILL.md frontmatter and surfaces the skill in your library. The extraction tool (extract-block-schema.php) needs a live WP-CLI connection and won't run in the sandbox; use it from a local terminal against your own site instead.",
   "uploadSteps": [

package/assets/templates/platforms/claude-code.json

@@ -20,7 +20,7 @@
     "description": "Build and modify Mosaic Pro (Nextend) sites by writing the underlying data model directly - no visual editor, no DOM. Query the real surface (122 node types, 181 node properties, 98 style properties, 53 style states, 151 element classes, 74 dynamic variables, 114 REST routes, 23 tables) instead of guessing, with every node type placed on a live site one at a time and asserted against the delivered HTML, every style and node property swept against the compiled CSS and markup, and 569 responsive declarations checked against the stylesheet the site actually served.",
     "license": "MIT",
     "author": "moksa (https://moksaweb.com)",
-    "version": "1.21.1"
+    "version": "1.21.2"
   },
   "loaderBehaviour": "Auto-loads on session start when SKILL.md frontmatter parses successfully.",
   "verified": true,

package/assets/templates/platforms/codex-cli.json

@@ -20,7 +20,7 @@
     "description": "Build and modify Mosaic Pro (Nextend) sites by writing the underlying data model directly - no visual editor, no DOM. Query the real surface (122 node types, 181 node properties, 98 style properties, 53 style states, 151 element classes, 74 dynamic variables, 114 REST routes, 23 tables) instead of guessing, with every node type placed on a live site one at a time and asserted against the delivered HTML, every style and node property swept against the compiled CSS and markup, and 569 responsive declarations checked against the stylesheet the site actually served.",
     "license": "MIT",
     "author": "moksa (https://moksaweb.com)",
-    "version": "1.21.1"
+    "version": "1.21.2"
   },
   "loaderBehaviour": "Confirmed (2026-07-11): Codex CLI natively supports the SKILL.md spec. Place SKILL.md under .codex/skills/<name>/ (project) or ~/.codex/skills/<name>/ (personal) and Codex loads the name+description at session start, then the full body on demand. A parallel, broader convention .agents/skills/ (searched from cwd up to repo root, then ~/.agents/skills/) also exists across multiple tools - if your Codex CLI version prioritizes that path instead, mirror the same SKILL.md there.",
   "verified": true,

package/assets/templates/platforms/copilot.json

@@ -20,7 +20,7 @@
     "description": "Build and modify Mosaic Pro (Nextend) sites by writing the underlying data model directly - no visual editor, no DOM. Query the real surface (122 node types, 181 node properties, 98 style properties, 53 style states, 151 element classes, 74 dynamic variables, 114 REST routes, 23 tables) instead of guessing, with every node type placed on a live site one at a time and asserted against the delivered HTML, every style and node property swept against the compiled CSS and markup, and 569 responsive declarations checked against the stylesheet the site actually served.",
     "license": "MIT",
     "author": "moksa (https://moksaweb.com)",
-    "version": "1.21.1"
+    "version": "1.21.2"
   },
   "loaderBehaviour": "CHANGED as of 2026-07-11: GitHub Copilot added a proper '.github/skills/' Agent Skills directory (December 2025), alongside the older single-file .github/copilot-instructions.md convention. This config targets the new skills-directory form. If your Copilot version predates this (pre Dec 2025), use the instructions-append fallback instead (see fallback below).",
   "fallback": {

package/assets/templates/platforms/gemini-cli.json

@@ -20,7 +20,7 @@
     "description": "Build and modify Mosaic Pro (Nextend) sites by writing the underlying data model directly - no visual editor, no DOM. Query the real surface (122 node types, 181 node properties, 98 style properties, 53 style states, 151 element classes, 74 dynamic variables, 114 REST routes, 23 tables) instead of guessing, with every node type placed on a live site one at a time and asserted against the delivered HTML, every style and node property swept against the compiled CSS and markup, and 569 responsive declarations checked against the stylesheet the site actually served.",
     "license": "MIT",
     "author": "moksa (https://moksaweb.com)",
-    "version": "1.21.1"
+    "version": "1.21.2"
   },
   "loaderBehaviour": "CHANGED as of 2026-07-11: Gemini CLI now natively supports the same SKILL.md standard as Claude Code and Codex CLI - the same directory-based skill works unmodified. Gemini CLI discovers skills in this precedence order: built-in, extension skills, ~/.gemini/skills/ (personal), .gemini/skills/ (project, shared via version control). At session start Gemini injects each discovered skill's name+description into the system prompt and calls activate_skill when a task matches.",
   "verified": true,

package/data/style-properties.csv

@@ -38,12 +38,12 @@ wordSpacing,,CSSCollectionVariablePropertyFactory,,,yes
 whiteSpace,,CSSPropertyFactory,,normal|pre-wrap|nowrap|pre,
 textTransform,,CSSPropertyFactory,,none|lowercase|uppercase|capitalize,
 textShadow,,CSSTextShadowStylePropertyFactory,,,
-width,,CSSSizePropertyFactory,,,
-minWidth,,CSSSizePropertyFactory,,,
-maxWidth,,CSSSizePropertyFactory,,,
-height,,CSSSizePropertyFactory,,,
-minHeight,,CSSSizePropertyFactory,,,
-maxHeight,,CSSSizePropertyFactory,,,
+width,,CSSSizePropertyFactory,,,yes
+minWidth,,CSSSizePropertyFactory,,,yes
+maxWidth,,CSSSizePropertyFactory,,,yes
+height,,CSSSizePropertyFactory,,,yes
+minHeight,,CSSSizePropertyFactory,,,yes
+maxHeight,,CSSSizePropertyFactory,,,yes
 position,,CSSPropertyFactory,,static|relative|absolute|fixed|sticky,
 zIndex,,CSSPropertyFactory,,,
 top,,CSSCollectionVariablePropertyFactory,,,yes
@@ -61,19 +61,19 @@ paddingLeft,,CSSCollectionVariablePropertyFactory,,,yes
 borderRadius,,CSSBorderRadiusPropertyFactory,,,
 borderTopWidth,borderStyle,CSSGrouppedPropertyFactory,CSSCollectionVariableProperty,,yes
 borderTopStyle,borderStyle,CSSGrouppedPropertyFactory,,,
-borderTopColor,borderStyle,CSSGrouppedPropertyFactory,CSSColorProperty,,
+borderTopColor,borderStyle,CSSGrouppedPropertyFactory,CSSColorProperty,,yes
 borderRightWidth,borderStyle,CSSGrouppedPropertyFactory,CSSCollectionVariableProperty,,yes
 borderRightStyle,borderStyle,CSSGrouppedPropertyFactory,,,
-borderRightColor,borderStyle,CSSGrouppedPropertyFactory,CSSColorProperty,,
+borderRightColor,borderStyle,CSSGrouppedPropertyFactory,CSSColorProperty,,yes
 borderBottomWidth,borderStyle,CSSGrouppedPropertyFactory,CSSCollectionVariableProperty,,yes
 borderBottomStyle,borderStyle,CSSGrouppedPropertyFactory,,,
-borderBottomColor,borderStyle,CSSGrouppedPropertyFactory,CSSColorProperty,,
+borderBottomColor,borderStyle,CSSGrouppedPropertyFactory,CSSColorProperty,,yes
 borderLeftWidth,borderStyle,CSSGrouppedPropertyFactory,CSSCollectionVariableProperty,,yes
 borderLeftStyle,borderStyle,CSSGrouppedPropertyFactory,,,
-borderLeftColor,borderStyle,CSSGrouppedPropertyFactory,CSSColorProperty,,
+borderLeftColor,borderStyle,CSSGrouppedPropertyFactory,CSSColorProperty,,yes
 outlineWidth,outlineStyle,CSSGrouppedPropertyFactory,CSSCollectionVariableProperty,,yes
 outlineStyle,outlineStyle,CSSGrouppedPropertyFactory,,,
-outlineColor,outlineStyle,CSSGrouppedPropertyFactory,CSSColorProperty,,
+outlineColor,outlineStyle,CSSGrouppedPropertyFactory,CSSColorProperty,,yes
 outlineOffset,outlineStyle,CSSGrouppedPropertyFactory,CSSCollectionVariableProperty,,yes
 boxShadow,,CSSBoxShadowStylePropertyFactory,,,
 opacity,,CSSPropertyFactory,,,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mosaic-headless",
-  "version": "1.21.1",
+  "version": "1.21.2",
   "description": "AI-agent skill: build Mosaic Pro (Nextend) WordPress sites by writing the underlying data model directly - 23 custom tables, no visual editor, no DOM. Every node type, style property and node property swept against a live install and asserted on the delivered HTML and compiled CSS. Installs into Claude Code, Cursor, Codex CLI, Gemini CLI, Copilot, Continue, Windsurf and Claude.ai.",
   "keywords": [
     "wordpress",

package/references/dialog-and-triggers.md

@@ -198,6 +198,33 @@ anywhere. That is the skill's existing rule (`ValidatorDynamicCode` = bare strin
 `ValidatorDynamicCodeObject` = `{"v": …}`) applying to a new element, and it is also
 why those three can hold `@VAR('post/meta_lat')` and a custom field can drive the map.
 
+## The rest of 1.0.9, briefly
+
+Not everything in the release is a node you place. Four things that change how the
+plugin behaves rather than what you can build:
+
+- **`stretch` on the size properties.** `width`, `height` and their min/max moved to
+  `CSSSizePropertyFactory`, which accepts the keyword and emits
+  `width:-webkit-fill-available` **then** `width:stretch` — the modern value last so
+  a current engine lands on it and an older one keeps the alias. Measured on all
+  three of width / height / max-width; the author's casing is preserved as typed.
+- **`ElementClassPruner`.** The generated `_<token>` class is now a placeholder while
+  the tree renders, and one pass over the finished HTML keeps it only where a
+  selector actually claimed it. The marker is random per render, so the pass can
+  never touch a class that arrived from post content or a shortcode. This is the
+  mechanism behind "an element whose styles compile to nothing has no generated
+  class" — it is a deliberate feature, not an accident.
+- **Author and term page instances.** `PageInstance/PageTypes/Author` and `Term` let
+  the editor put a specific author or taxonomy term in front of an archive template;
+  a term has no assign of its own, because a term archive is only ever rendered by
+  its path.
+- **`POST /template/createAutoTemplate`** (`resourceQuery`, `masterID`) creates the
+  automatic template a post type is missing — a template on the post type's PATH,
+  with nothing recorded against the resource that prompted it. Deliberately not the
+  assign endpoint: a post type whose resources cannot carry an assign still needs a
+  way to be designed, and conflating the two would make this look like an assign.
+  115 routes now, up from 114.
+
 ## What else moved in the delivered page
 
 **The three per-breakpoint stylesheets became one.** Through 1.0.8 a page carried

package/references/styling.md

@@ -109,12 +109,13 @@ The `factory` column in `data/style-properties.csv` tells you the value shape:
 | factory | write |
 |---|---|
 | `CSSPropertyFactory` (29) | a plain CSS value string — `"flex"`, `"center"`, `"700"` |
-| `CSSCollectionVariablePropertyFactory` (26) | a length string, or a reference to a collection variable |
+| `CSSCollectionVariablePropertyFactory` (20) | a length string, or a reference to a collection variable |
+| `CSSSizePropertyFactory` (6) | `width`, `height` and their min/max. A collection-variable length like the row above - it is a subclass - plus the keyword **`stretch`**, which Mosaic emits as `-webkit-fill-available` FIRST and `stretch` second, so a current engine takes the standard value and an older one the alias. New in 1.0.9; measured. |
 | `CSSColorPropertyFactory` (2) | `color`, `backgroundColor` — a colour string or variable reference |
 | `CSSGrouppedPropertyFactory` (20) | one leg of `borderStyle`, `outlineStyle` or `gridChildPosition`; the data is keyed under the group |
 | the other 21 | purpose-built shapes — shadow, transform, gradient, filter, mask. Read the factory named in the CSV. |
 
-Plain strings were accepted verbatim for the properties probed above. The 34
+Plain strings were accepted verbatim for the properties probed above. The 39
 token-referencable properties are the interface to the collection/variable layer,
 which is how a design system is meant to be expressed rather than hard-coding values
 on every node.
@@ -127,7 +128,11 @@ lowest layer and it opts that node out of both reuse mechanisms:
 1. **Variants** (`data/variants.csv`, 152 built in - Mosaic's element classes) carry
    the shared look; a node points at one through `style.variant`.
 2. **Collections → modes/skins → variables** are the token layer, the thing the
-   34 token-referencable properties reference.
+   39 token-referencable properties reference. (34 until this was last counted:
+   `data/style-properties.csv` resolves a factory's ANCESTRY now rather than
+   testing its name, which 1.0.9 made necessary - `CSSSizePropertyFactory` extends
+   the collection-variable one - and which also recovered the five grouped colour
+   legs whose value class was always `CSSColorProperty`.)
 
 Per-node `style` is for the exception, not the rule. Build a design by putting values
 in the class and token layers and letting nodes inherit; reach for per-node style when

package/tools/extract_style_properties.py

@@ -110,6 +110,44 @@ def style_enums(plugin_root):
     return out
 
 
+def factory_parents(plugin_root):
+    """class -> its parent, for every property factory under Builder/Style.
+
+    Read because a factory's NAME stopped being enough in 1.0.9:
+    `CSSSizePropertyFactory extends CSSCollectionVariablePropertyFactory` and drives
+    width / height and their min and max, which still take a collection variable -
+    but a name test for "CollectionVariable" misses it and the table then says six
+    length properties cannot reference a design token, which is false.
+    """
+    parents = {}
+    base = os.path.join(plugin_root, "Mosaic", "Builder", "Style")
+    for root, _dirs, files in os.walk(base):
+        for name in files:
+            if not name.endswith(".php"):
+                continue
+            with open(os.path.join(root, name), encoding="utf-8", errors="replace") as fh:
+                src = fh.read()
+            # `extends Foo` and `extends \Name\Space\Foo` both; only the last
+            # segment is kept, which is what the factory column shows.
+            bs = chr(92)
+            for m in re.finditer("class" + r"\s+(\w+)\s+extends\s+([" + bs * 2
+                                 + r"\w]+)", src):
+                parents[m.group(1)] = m.group(2).split(bs)[-1]
+    return parents
+
+
+def is_tokenable(factory, value_class, parents):
+    """Does this factory, or anything it inherits from, accept a collection variable?"""
+    for name in (factory, value_class):
+        seen = set()
+        while name and name not in seen:
+            if "CollectionVariable" in name or "Color" in name:
+                return True
+            seen.add(name)
+            name = parents.get(name)
+    return False
+
+
 def extract(plugin_root, out_dir):
     enums = style_enums(plugin_root)
     path = os.path.join(plugin_root, "Mosaic", "Builder", "Style", "SupportedStyleProperties.php")
@@ -118,6 +156,7 @@ def extract(plugin_root, out_dir):
     with open(path, encoding="utf-8", errors="replace") as fh:
         src = fh.read()
 
+    parents = factory_parents(plugin_root)
     rows = []
     for factory, first, member, value_class in RE_ADD.findall(src):
         grouped = factory == "CSSGrouppedPropertyFactory"
@@ -128,10 +167,9 @@ def extract(plugin_root, out_dir):
                 "factory": factory,
                 "value_class": value_class.split("\\")[-1] if value_class else "",
                 "accepted_values": "|".join(enums.get(member if grouped else first, [])),
-                "tokenable": "yes" if (
-                    "CollectionVariable" in factory or "Color" in factory
-                    or "CollectionVariable" in (value_class or "")
-                ) else "",
+                "tokenable": "yes" if is_tokenable(
+                    factory, value_class.split("\\")[-1] if value_class else "",
+                    parents) else "",
             }
         )