@jxsuite/starters 1.2.2 → 1.6.1

package/sites/blog/document.schema.json

@@ -16,7 +16,9 @@
               "type": "array"
             }
           },
-          "required": ["values"],
+          "required": [
+            "values"
+          ],
           "type": "object"
         },
         {
@@ -36,7 +38,9 @@
               "type": "string"
             }
           },
-          "required": ["$ref"],
+          "required": [
+            "$ref"
+          ],
           "type": "object"
         },
         {
@@ -115,16 +119,24 @@
               "not": {
                 "anyOf": [
                   {
-                    "required": ["$prototype"]
+                    "required": [
+                      "$prototype"
+                    ]
                   },
                   {
-                    "required": ["default"]
+                    "required": [
+                      "default"
+                    ]
                   },
                   {
-                    "required": ["type"]
+                    "required": [
+                      "type"
+                    ]
                   },
                   {
-                    "required": ["$expression"]
+                    "required": [
+                      "$expression"
+                    ]
                   }
                 ]
               },
@@ -135,7 +147,9 @@
         "TypedStateDef": {
           "description": "A typed reactive state variable with explicit type and default value. The type property is a JSON Schema or $ref to a $defs type definition. The default property is the initial runtime value.",
           "not": {
-            "required": ["$prototype"]
+            "required": [
+              "$prototype"
+            ]
           },
           "properties": {
             "$ref": {
@@ -182,7 +196,9 @@
               ]
             }
           },
-          "required": ["default"],
+          "required": [
+            "default"
+          ],
           "type": "object"
         },
         "PureTypeDef": {
@@ -190,10 +206,14 @@
           "not": {
             "anyOf": [
               {
-                "required": ["default"]
+                "required": [
+                  "default"
+                ]
               },
               {
-                "required": ["$prototype"]
+                "required": [
+                  "$prototype"
+                ]
               }
             ]
           },
@@ -238,7 +258,9 @@
               "$ref": "#/$defs/v1/$defs/JsonSchemaType"
             }
           },
-          "required": ["type"],
+          "required": [
+            "type"
+          ],
           "type": "object"
         },
         "FunctionDef": {
@@ -255,12 +277,20 @@
             },
             "$src": {
               "description": "External module specifier. Mutually exclusive with body.",
-              "examples": ["./counter.js", "npm:@myorg/validators"],
+              "examples": [
+                "./counter.js",
+                "npm:@myorg/validators"
+              ],
               "type": "string"
             },
             "arguments": {
               "description": "Legacy alias for parameters: bare string parameter names (state may be listed explicitly as the first name). Superseded by parameters.",
-              "examples": [["state", "event"]],
+              "examples": [
+                [
+                  "state",
+                  "event"
+                ]
+              ],
               "items": {
                 "type": "string"
               },
@@ -314,7 +344,9 @@
             "parameters": {
               "description": "Function parameters (after the implicit state parameter). Accepts CEM-compatible parameter objects or bare string names for backward compatibility.",
               "examples": [
-                ["event"],
+                [
+                  "event"
+                ],
                 [
                   {
                     "name": "event",
@@ -349,7 +381,9 @@
               "description": "Return type for tooling (JSON Schema or CEM { text } format)."
             }
           },
-          "required": ["$prototype"],
+          "required": [
+            "$prototype"
+          ],
           "type": "object"
         },
         "ClassDef": {
@@ -428,7 +462,9 @@
                       "type": "string"
                     }
                   },
-                  "required": ["$ref"],
+                  "required": [
+                    "$ref"
+                  ],
                   "type": "object"
                 }
               ]
@@ -447,7 +483,10 @@
               "type": "string"
             }
           },
-          "required": ["$prototype", "title"],
+          "required": [
+            "$prototype",
+            "title"
+          ],
           "type": "object"
         },
         "ClassParameterDef": {
@@ -469,7 +508,9 @@
             },
             "type": {}
           },
-          "required": ["identifier"],
+          "required": [
+            "identifier"
+          ],
           "type": "object"
         },
         "ClassFieldDef": {
@@ -480,7 +521,11 @@
               "type": "string"
             },
             "access": {
-              "enum": ["public", "private", "protected"],
+              "enum": [
+                "public",
+                "private",
+                "protected"
+              ],
               "type": "string"
             },
             "default": {},
@@ -499,7 +544,10 @@
               "type": "string"
             },
             "scope": {
-              "enum": ["instance", "static"],
+              "enum": [
+                "instance",
+                "static"
+              ],
               "type": "string"
             },
             "type": {}
@@ -539,7 +587,9 @@
                         "type": "string"
                       }
                     },
-                    "required": ["$ref"],
+                    "required": [
+                      "$ref"
+                    ],
                     "type": "object"
                   },
                   {
@@ -575,7 +625,11 @@
               "type": "string"
             },
             "access": {
-              "enum": ["public", "private", "protected"],
+              "enum": [
+                "public",
+                "private",
+                "protected"
+              ],
               "type": "string"
             },
             "body": {
@@ -615,7 +669,9 @@
                         "type": "string"
                       }
                     },
-                    "required": ["$ref"],
+                    "required": [
+                      "$ref"
+                    ],
                     "type": "object"
                   },
                   {
@@ -638,6 +694,7 @@
                 "resolvePaths",
                 "lower",
                 "emit",
+                "head",
                 "assets",
                 "mount",
                 "dialect",
@@ -648,7 +705,10 @@
               "type": "string"
             },
             "scope": {
-              "enum": ["instance", "static"],
+              "enum": [
+                "instance",
+                "static"
+              ],
               "type": "string"
             },
             "setter": {
@@ -665,7 +725,11 @@
             "timing": {
               "description": "Execution environments allowed to call this capability directly. Hosts outside the list round-trip through the dev server.",
               "items": {
-                "enum": ["compiler", "server", "client"],
+                "enum": [
+                  "compiler",
+                  "server",
+                  "client"
+                ],
                 "type": "string"
               },
               "type": "array"
@@ -679,7 +743,11 @@
             "documentKinds": {
               "description": "\"page\"/\"component\" allow the extension in pages/components discovery; \"content\" allows it as a content-type source.",
               "items": {
-                "enum": ["page", "component", "content"],
+                "enum": [
+                  "page",
+                  "component",
+                  "content"
+                ],
                 "type": "string"
               },
               "type": "array"
@@ -706,7 +774,9 @@
               "type": "boolean"
             }
           },
-          "required": ["extensions"],
+          "required": [
+            "extensions"
+          ],
           "type": "object"
         },
         "ProjectBlockDef": {
@@ -728,7 +798,9 @@
               "type": "string"
             }
           },
-          "required": ["key"],
+          "required": [
+            "key"
+          ],
           "type": "object"
         },
         "ServerBlockDef": {
@@ -737,7 +809,10 @@
           "properties": {
             "basePath": {
               "description": "Route subtree this class mounts — must be under /_jx/ (exclusive per project).",
-              "examples": ["/_jx/data", "/_jx/auth"],
+              "examples": [
+                "/_jx/data",
+                "/_jx/auth"
+              ],
               "type": "string"
             },
             "module": {
@@ -749,7 +824,9 @@
               "type": "number"
             }
           },
-          "required": ["basePath"],
+          "required": [
+            "basePath"
+          ],
           "type": "object"
         },
         "ConnectorBlockDef": {
@@ -757,7 +834,10 @@
           "properties": {
             "kind": {
               "description": "SQL dialect family the provider speaks.",
-              "enum": ["sqlite", "postgres"],
+              "enum": [
+                "sqlite",
+                "postgres"
+              ],
               "type": "string"
             },
             "local": {
@@ -777,7 +857,10 @@
               "type": "string"
             }
           },
-          "required": ["provider", "kind"],
+          "required": [
+            "provider",
+            "kind"
+          ],
           "type": "object"
         },
         "StudioHints": {
@@ -798,7 +881,10 @@
                   "type": "object"
                 },
                 "default": {
-                  "enum": ["content", "component"],
+                  "enum": [
+                    "content",
+                    "component"
+                  ],
                   "type": "string"
                 }
               },
@@ -907,7 +993,11 @@
             },
             "$src": {
               "description": "External module specifier. Required when $prototype is not a built-in.",
-              "examples": ["@jxsuite/md", "./lib/my-parser.js", "npm:@myorg/data"],
+              "examples": [
+                "@jxsuite/md",
+                "./lib/my-parser.js",
+                "npm:@myorg/data"
+              ],
               "type": "string"
             },
             "autoIncrement": {
@@ -928,11 +1018,24 @@
             "domain": {
               "type": "string"
             },
-            "expires": {
-              "type": "string"
-            },
             "filter": {
-              "$ref": "#/$defs/v1/$defs/RefObject"
+              "anyOf": [
+                {
+                  "$ref": "#/$defs/v1/$defs/RefObject"
+                },
+                {
+                  "description": "A single filter object, e.g. an equality shorthand.",
+                  "type": "object"
+                },
+                {
+                  "description": "Ordered filter rules, e.g. [{ field: \"Slug\", op: \"not empty\" }].",
+                  "items": {
+                    "type": "object"
+                  },
+                  "type": "array"
+                }
+              ],
+              "description": "Filter configuration: a reactive $ref binding, a single filter object, or an ordered array of rules."
             },
             "headers": {
               "additionalProperties": {
@@ -963,7 +1066,10 @@
                     "type": "boolean"
                   }
                 },
-                "required": ["name", "keyPath"],
+                "required": [
+                  "name",
+                  "keyPath"
+                ],
                 "type": "object"
               },
               "type": "array"
@@ -985,7 +1091,15 @@
               "type": "integer"
             },
             "method": {
-              "enum": ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"],
+              "enum": [
+                "GET",
+                "POST",
+                "PUT",
+                "PATCH",
+                "DELETE",
+                "HEAD",
+                "OPTIONS"
+              ],
               "type": "string"
             },
             "name": {
@@ -995,11 +1109,22 @@
               "type": "string"
             },
             "responseType": {
-              "enum": ["json", "text", "blob", "arraybuffer", "document", ""],
+              "enum": [
+                "json",
+                "text",
+                "blob",
+                "arraybuffer",
+                "document",
+                ""
+              ],
               "type": "string"
             },
             "sameSite": {
-              "enum": ["strict", "lax", "none"],
+              "enum": [
+                "strict",
+                "lax",
+                "none"
+              ],
               "type": "string"
             },
             "secure": {
@@ -1032,7 +1157,11 @@
               "type": "string"
             },
             "timing": {
-              "enum": ["compiler", "server", "client"],
+              "enum": [
+                "compiler",
+                "server",
+                "client"
+              ],
               "type": "string"
             },
             "url": {
@@ -1043,7 +1172,9 @@
               "type": "integer"
             }
           },
-          "required": ["$prototype"],
+          "required": [
+            "$prototype"
+          ],
           "type": "object"
         },
         "ExpressionPointer": {
@@ -1055,7 +1186,9 @@
               "type": "string"
             }
           },
-          "required": ["$ref"],
+          "required": [
+            "$ref"
+          ],
           "type": "object"
         },
         "ExpressionLiteral": {
@@ -1086,10 +1219,14 @@
               "not": {
                 "anyOf": [
                   {
-                    "required": ["$ref"]
+                    "required": [
+                      "$ref"
+                    ]
                   },
                   {
-                    "required": ["operator"]
+                    "required": [
+                      "operator"
+                    ]
                   }
                 ]
               },
@@ -1113,10 +1250,28 @@
           "description": "Anything that may appear in target or value: a pointer, a literal, or a nested expression node."
         },
         "UnaryOperator": {
-          "enum": ["!", "-"]
+          "enum": [
+            "!",
+            "-"
+          ]
         },
         "BinaryOperator": {
-          "enum": ["+", "-", "*", "/", "%", "===", "!==", "<", "<=", ">", ">=", "&&", "||", "??"]
+          "enum": [
+            "+",
+            "-",
+            "*",
+            "/",
+            "%",
+            "===",
+            "!==",
+            "<",
+            "<=",
+            ">",
+            ">=",
+            "&&",
+            "||",
+            "??"
+          ]
         },
         "ConditionalOperator": {
           "const": "?:"
@@ -1164,13 +1319,25 @@
           ]
         },
         "AssignmentOperator": {
-          "enum": ["=", "+=", "-=", "*=", "/="]
+          "enum": [
+            "=",
+            "+=",
+            "-=",
+            "*=",
+            "/="
+          ]
         },
         "NoArgMethod": {
-          "enum": ["pop", "shift"]
+          "enum": [
+            "pop",
+            "shift"
+          ]
         },
         "OneArgMethod": {
-          "enum": ["push", "unshift"]
+          "enum": [
+            "push",
+            "unshift"
+          ]
         },
         "SpliceMethod": {
           "const": "splice"
@@ -1179,7 +1346,10 @@
           "const": "reduce"
         },
         "MapFilterMethod": {
-          "enum": ["map", "filter"]
+          "enum": [
+            "map",
+            "filter"
+          ]
         },
         "ExpressionNode": {
           "additionalProperties": false,
@@ -1189,10 +1359,14 @@
               "not": {
                 "anyOf": [
                   {
-                    "required": ["value"]
+                    "required": [
+                      "value"
+                    ]
                   },
                   {
-                    "required": ["initial"]
+                    "required": [
+                      "initial"
+                    ]
                   }
                 ]
               },
@@ -1201,24 +1375,33 @@
                   "$ref": "#/$defs/v1/$defs/UnaryOperator"
                 }
               },
-              "required": ["operator"],
+              "required": [
+                "operator"
+              ],
               "title": "Unary — target only, no value"
             },
             {
               "not": {
-                "required": ["initial"]
+                "required": [
+                  "initial"
+                ]
               },
               "properties": {
                 "operator": {
                   "$ref": "#/$defs/v1/$defs/BinaryOperator"
                 }
               },
-              "required": ["operator", "value"],
+              "required": [
+                "operator",
+                "value"
+              ],
               "title": "Binary — left in target, right in value"
             },
             {
               "not": {
-                "required": ["initial"]
+                "required": [
+                  "initial"
+                ]
               },
               "properties": {
                 "operator": {
@@ -1228,17 +1411,24 @@
                   "$ref": "#/$defs/v1/$defs/ExpressionPointer"
                 }
               },
-              "required": ["operator", "value"],
+              "required": [
+                "operator",
+                "value"
+              ],
               "title": "Assignment — writable target, value required"
             },
             {
               "not": {
                 "anyOf": [
                   {
-                    "required": ["value"]
+                    "required": [
+                      "value"
+                    ]
                   },
                   {
-                    "required": ["initial"]
+                    "required": [
+                      "initial"
+                    ]
                   }
                 ]
               },
@@ -1250,12 +1440,16 @@
                   "$ref": "#/$defs/v1/$defs/ExpressionPointer"
                 }
               },
-              "required": ["operator"],
+              "required": [
+                "operator"
+              ],
               "title": "pop / shift — array receiver, no value"
             },
             {
               "not": {
-                "required": ["initial"]
+                "required": [
+                  "initial"
+                ]
               },
               "properties": {
                 "operator": {
@@ -1265,12 +1459,17 @@
                   "$ref": "#/$defs/v1/$defs/ExpressionPointer"
                 }
               },
-              "required": ["operator", "value"],
+              "required": [
+                "operator",
+                "value"
+              ],
               "title": "push / unshift — array receiver, single value argument"
             },
             {
               "not": {
-                "required": ["initial"]
+                "required": [
+                  "initial"
+                ]
               },
               "properties": {
                 "operator": {
@@ -1287,7 +1486,10 @@
                   "type": "array"
                 }
               },
-              "required": ["operator", "value"],
+              "required": [
+                "operator",
+                "value"
+              ],
               "title": "splice — array receiver, [start, deleteCount, ...items]"
             },
             {
@@ -1309,12 +1511,18 @@
                   "$ref": "#/$defs/v1/$defs/ExpressionNode"
                 }
               },
-              "required": ["operator", "value", "initial"],
+              "required": [
+                "operator",
+                "value",
+                "initial"
+              ],
               "title": "reduce — pure fold over a pointer or derived array; seed in initial"
             },
             {
               "not": {
-                "required": ["initial"]
+                "required": [
+                  "initial"
+                ]
               },
               "properties": {
                 "operator": {
@@ -1334,7 +1542,10 @@
                   "$ref": "#/$defs/v1/$defs/ExpressionNode"
                 }
               },
-              "required": ["operator", "value"],
+              "required": [
+                "operator",
+                "value"
+              ],
               "title": "map / filter — pure over a pointer or derived array; per-item expression in value"
             },
             {
@@ -1344,7 +1555,11 @@
                   "$ref": "#/$defs/v1/$defs/ConditionalOperator"
                 }
               },
-              "required": ["operator", "value", "initial"],
+              "required": [
+                "operator",
+                "value",
+                "initial"
+              ],
               "title": "?: — pure conditional; test in target, consequent in value, alternate in initial"
             },
             {
@@ -1352,10 +1567,14 @@
               "not": {
                 "anyOf": [
                   {
-                    "required": ["value"]
+                    "required": [
+                      "value"
+                    ]
                   },
                   {
-                    "required": ["initial"]
+                    "required": [
+                      "initial"
+                    ]
                   }
                 ]
               },
@@ -1373,26 +1592,35 @@
                   "$ref": "#/$defs/v1/$defs/SwitchOperator"
                 }
               },
-              "required": ["operator", "cases"],
+              "required": [
+                "operator",
+                "cases"
+              ],
               "title": "switch — pure value-keyed selection; discriminant in target, results in cases/default"
             },
             {
               "description": "A pure standard-library method call: target is the receiver (any operand — never mutated; change-by-copy names replace the mutating originals), value the optional argument (bare scalar) or argument list (array). A missing receiver or method yields undefined, matching null-safe path reads.",
               "not": {
-                "required": ["initial"]
+                "required": [
+                  "initial"
+                ]
               },
               "properties": {
                 "operator": {
                   "$ref": "#/$defs/v1/$defs/PureMethod"
                 }
               },
-              "required": ["operator"],
+              "required": [
+                "operator"
+              ],
               "title": "Pure method — genuine prototype methods; receiver in target, args in value"
             },
             {
-              "description": "Invoke a callable, pure in formula position: target is the callee pointer — a named formula entry (#/state/…) or a blessed pure global via window#/ (Math.*, JSON.*, Object.keys/values/entries, and the Intl helpers Intl/formatNumber, Intl/formatDate, Intl/formatRelativeTime) — and value is the positional argument list (the splice args-in-value precedent). Argument order follows the callee's declared parameters.",
+              "description": "Invoke a callable, pure in formula position: target is the callee pointer — a named formula entry (#/state/…) or a blessed pure global via window#/ (Math.*, JSON.*, Object.keys/values/entries, and the Intl helpers Intl/formatNumber, Intl/formatDate, Intl/formatRelativeTime, Intl/formatList, Intl/plural, Intl/compare, Intl/displayName, Intl/segment) — and value is the positional argument list (the splice args-in-value precedent). Argument order follows the callee's declared parameters.",
               "not": {
-                "required": ["initial"]
+                "required": [
+                  "initial"
+                ]
               },
               "properties": {
                 "operator": {
@@ -1408,7 +1636,9 @@
                   "type": "array"
                 }
               },
-              "required": ["operator"],
+              "required": [
+                "operator"
+              ],
               "title": "call — invoke a named formula or blessed global; callee in target, args in value"
             }
           ],
@@ -1437,7 +1667,10 @@
               "$ref": "#/$defs/v1/$defs/ExpressionOperand"
             }
           },
-          "required": ["operator", "target"],
+          "required": [
+            "operator",
+            "target"
+          ],
           "type": "object"
         },
         "ExpressionEntry": {
@@ -1468,7 +1701,9 @@
               "type": "array"
             }
           },
-          "required": ["$expression"],
+          "required": [
+            "$expression"
+          ],
           "type": "object"
         },
         "Statement": {
@@ -1496,7 +1731,10 @@
                   "type": "array"
                 }
               },
-              "required": ["if", "then"],
+              "required": [
+                "if",
+                "then"
+              ],
               "title": "if / then / else — conditional branch (JSON Schema keyword triple)",
               "type": "object"
             },
@@ -1522,7 +1760,10 @@
                   "type": "array"
                 }
               },
-              "required": ["$switch", "cases"],
+              "required": [
+                "$switch",
+                "cases"
+              ],
               "title": "$switch / cases — multiway branch (element-level convention, ECMA switch semantics)",
               "type": "object"
             },
@@ -1543,7 +1784,9 @@
                   "type": "string"
                 }
               },
-              "required": ["dispatchEvent"],
+              "required": [
+                "dispatchEvent"
+              ],
               "title": "dispatchEvent — emit a CustomEvent (WHATWG naming, CustomEventInit members)",
               "type": "object"
             }
@@ -1607,7 +1850,11 @@
               "$ref": "#/$defs/v1/$defs/StringOrRef"
             },
             "dir": {
-              "enum": ["ltr", "rtl", "auto"],
+              "enum": [
+                "ltr",
+                "rtl",
+                "auto"
+              ],
               "type": "string"
             },
             "disabled": {
@@ -1650,7 +1897,7 @@
               "$ref": "#/$defs/v1/$defs/NumberOrRef"
             },
             "tagName": {
-              "$ref": "#/$defs/v1/$defs/TagName"
+              "$ref": "#/$defs/v1/$defs/ElementTagName"
             },
             "textContent": {
               "$ref": "#/$defs/v1/$defs/StringOrRef"
@@ -5837,7 +6084,9 @@
               ]
             }
           },
-          "required": ["tagName"],
+          "required": [
+            "tagName"
+          ],
           "type": "object"
         },
         "ChildrenValue": {
@@ -5845,10 +6094,13 @@
           "oneOf": [
             {
               "items": {
-                "oneOf": [
+                "anyOf": [
                   {
                     "$ref": "#/$defs/v1/$defs/ElementDef"
                   },
+                  {
+                    "$ref": "#/$defs/v1/$defs/SwitchNode"
+                  },
                   {
                     "$ref": "#/$defs/v1/$defs/ArrayNamespace"
                   },
@@ -5900,7 +6152,11 @@
               "$ref": "#/$defs/v1/$defs/RefObject"
             }
           },
-          "required": ["$prototype", "items", "map"],
+          "required": [
+            "$prototype",
+            "items",
+            "map"
+          ],
           "type": "object"
         },
         "SwitchDef": {
@@ -5911,7 +6167,9 @@
               "$ref": "#/$defs/v1/$defs/StateRef"
             }
           },
-          "required": ["$ref"],
+          "required": [
+            "$ref"
+          ],
           "type": "object"
         },
         "SwitchNode": {
@@ -5936,7 +6194,10 @@
               "$ref": "#/$defs/v1/$defs/TagName"
             }
           },
-          "required": ["$switch", "cases"],
+          "required": [
+            "$switch",
+            "cases"
+          ],
           "type": "object"
         },
         "StyleObject": {
@@ -7535,6 +7796,26 @@
                 }
               ]
             },
+            "animation-delay-end": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "number"
+                }
+              ]
+            },
+            "animation-delay-start": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "number"
+                }
+              ]
+            },
             "animation-direction": {
               "oneOf": [
                 {
@@ -7685,6 +7966,26 @@
                 }
               ]
             },
+            "animationDelayEnd": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "number"
+                }
+              ]
+            },
+            "animationDelayStart": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "number"
+                }
+              ]
+            },
             "animationDirection": {
               "oneOf": [
                 {
@@ -18025,6 +18326,16 @@
                 }
               ]
             },
+            "scroll-axis-lock": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "number"
+                }
+              ]
+            },
             "scroll-behavior": {
               "oneOf": [
                 {
@@ -18345,6 +18656,16 @@
                 }
               ]
             },
+            "scrollAxisLock": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "number"
+                }
+              ]
+            },
             "scrollBehavior": {
               "oneOf": [
                 {
@@ -22282,7 +22603,9 @@
               "$ref": "#/$defs/v1/$defs/AnyRef"
             }
           },
-          "required": ["$ref"],
+          "required": [
+            "$ref"
+          ],
           "type": "object"
         },
         "AnyRef": {
@@ -22310,19 +22633,30 @@
         },
         "InternalRef": {
           "description": "Reference to a $defs type definition in the current component.",
-          "examples": ["#/$defs/Count", "#/$defs/TodoItem", "#/$defs/Status"],
+          "examples": [
+            "#/$defs/Count",
+            "#/$defs/TodoItem",
+            "#/$defs/Status"
+          ],
           "pattern": "^#/\\$defs/",
           "type": "string"
         },
         "StateRef": {
           "description": "Reference to a state entry (runtime variable) in the current component.",
-          "examples": ["#/state/count", "#/state/addTask", "#/state/items"],
+          "examples": [
+            "#/state/count",
+            "#/state/addTask",
+            "#/state/items"
+          ],
           "pattern": "^#/state/",
           "type": "string"
         },
         "ExternalRef": {
           "description": "Reference to an external Jx component file.",
-          "examples": ["./card.json", "https://cdn.example.com/button.json"],
+          "examples": [
+            "./card.json",
+            "https://cdn.example.com/button.json"
+          ],
           "pattern": "^(\\./|\\.\\./).*\\.json$|^https?://",
           "type": "string"
         },
@@ -22335,24 +22669,37 @@
               "$ref": "#/$defs/v1/$defs/ExternalRef"
             }
           },
-          "required": ["$ref"],
+          "required": [
+            "$ref"
+          ],
           "type": "object"
         },
         "GlobalRef": {
           "description": "Reference to a window or document global.",
-          "examples": ["window#/currentUser", "document#/appConfig"],
+          "examples": [
+            "window#/currentUser",
+            "document#/appConfig"
+          ],
           "pattern": "^(window|document)#/",
           "type": "string"
         },
         "ParentRef": {
           "description": "Reference to a named state entry passed via $props from a parent component.",
-          "examples": ["parent#/sharedState", "parent#/theme"],
+          "examples": [
+            "parent#/sharedState",
+            "parent#/theme"
+          ],
           "pattern": "^parent#/",
           "type": "string"
         },
         "MapRef": {
           "description": "Reference to the current Array map iteration context.",
-          "examples": ["$map/item", "$map/index", "$map/item/text", "$map/item/done"],
+          "examples": [
+            "$map/item",
+            "$map/index",
+            "$map/item/text",
+            "$map/item/done"
+          ],
           "pattern": "^\\$map/(item|index)(/.*)?$",
           "type": "string"
         },
@@ -22427,7 +22774,9 @@
               "description": "Parameter type (JSON Schema or CEM { text } format)."
             }
           },
-          "required": ["name"],
+          "required": [
+            "name"
+          ],
           "type": "object"
         },
         "CemEvent": {
@@ -22456,12 +22805,15 @@
               "description": "Event type (e.g. { text: 'CustomEvent' })."
             }
           },
-          "required": ["name"],
+          "required": [
+            "name"
+          ],
           "type": "object"
         },
         "TagName": {
-          "description": "HTML element tag name or custom element name (must contain a hyphen per Web Components spec).",
+          "description": "HTML element tag name or custom element name (must contain a hyphen per Web Components spec). A NAME, never an expression: no `${…}` position in the pipeline evaluates a tagName. Use `$switch`/`cases` to vary the element.",
           "minLength": 1,
+          "pattern": "^[a-zA-Z][a-zA-Z0-9._-]*$",
           "type": "string",
           "examples": [
             "a",
@@ -22677,8 +23029,95 @@
             "user-card"
           ]
         },
+        "TagExpression": {
+          "anyOf": [
+            {
+              "additionalProperties": false,
+              "description": "Two-way: `target` is the test, `value` the tag when it is truthy, `initial` the tag when it is not.",
+              "properties": {
+                "initial": {
+                  "$ref": "#/$defs/v1/$defs/TagName"
+                },
+                "operator": {
+                  "const": "?:",
+                  "type": "string"
+                },
+                "target": {
+                  "$ref": "#/$defs/v1/$defs/ExpressionOperand"
+                },
+                "value": {
+                  "$ref": "#/$defs/v1/$defs/TagName"
+                }
+              },
+              "required": [
+                "operator",
+                "target",
+                "value",
+                "initial"
+              ],
+              "title": "?: — the tag when the test holds, and the tag when it does not"
+            },
+            {
+              "additionalProperties": false,
+              "description": "Multiway: `target` is the discriminant, matched against case keys by its string form. `default` is required — an element with no tag cannot exist.",
+              "properties": {
+                "cases": {
+                  "additionalProperties": {
+                    "$ref": "#/$defs/v1/$defs/TagName"
+                  },
+                  "type": "object"
+                },
+                "default": {
+                  "$ref": "#/$defs/v1/$defs/TagName"
+                },
+                "operator": {
+                  "const": "switch",
+                  "type": "string"
+                },
+                "target": {
+                  "$ref": "#/$defs/v1/$defs/ExpressionOperand"
+                }
+              },
+              "required": [
+                "operator",
+                "target",
+                "cases",
+                "default"
+              ],
+              "title": "switch — one tag per discriminant value, with a required fallback"
+            }
+          ],
+          "description": "A tag name chosen at element creation. Every branch resolves to a `TagName`, so the candidate set is enumerable without evaluating anything."
+        },
+        "ElementTagName": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/v1/$defs/TagName"
+            },
+            {
+              "additionalProperties": false,
+              "properties": {
+                "$expression": {
+                  "$ref": "#/$defs/v1/$defs/TagExpression"
+                }
+              },
+              "required": [
+                "$expression"
+              ],
+              "type": "object"
+            }
+          ]
+        },
         "JsonSchemaType": {
-          "enum": ["string", "number", "integer", "boolean", "array", "object", "null"],
+          "enum": [
+            "string",
+            "number",
+            "integer",
+            "boolean",
+            "array",
+            "object",
+            "null"
+          ],
           "type": "string"
         },
         "HeadEntry": {
@@ -22708,10 +23147,20 @@
               "type": "string"
             },
             "textContent": {
-              "type": "string"
+              "description": "Element content. An object is serialized to JSON inside the tag — that is how a JSON-LD block (`<script type=\"application/ld+json\">`) is authored.",
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "object"
+                }
+              ]
             }
           },
-          "required": ["tagName"],
+          "required": [
+            "tagName"
+          ],
           "type": "object"
         },
         "ImageConfig": {
@@ -22729,6 +23178,10 @@
             "optimize": {
               "type": "boolean"
             },
+            "picture": {
+              "description": "Wrap a multi-format image in a <picture> with one <source> per format (default true). With it off the <img> carries a srcset in the preferred format alone, which browsers that cannot decode that format will still select from.",
+              "type": "boolean"
+            },
             "quality": {
               "properties": {
                 "avif": {
@@ -22755,7 +23208,10 @@
             },
             "service": {
               "description": "How images are optimized: \"build\" runs Sharp at build time; \"cloudflare\" emits /cdn-cgi/image transform URLs served by Cloudflare Image Transformations (requires the feature to be enabled on the serving zone).",
-              "enum": ["build", "cloudflare"],
+              "enum": [
+                "build",
+                "cloudflare"
+              ],
               "type": "string"
             },
             "sizes": {
@@ -22785,7 +23241,9 @@
                   "type": "array"
                 }
               },
-              "required": ["values"],
+              "required": [
+                "values"
+              ],
               "type": "object"
             },
             {
@@ -22805,7 +23263,9 @@
                   "type": "string"
                 }
               },
-              "required": ["$ref"],
+              "required": [
+                "$ref"
+              ],
               "type": "object"
             },
             {
@@ -22848,7 +23308,9 @@
                     "type": "string"
                   }
                 },
-                "required": ["$ref"],
+                "required": [
+                  "$ref"
+                ],
                 "type": "object"
               },
               {
@@ -22860,22 +23322,70 @@
           "type": "array"
         },
         "$head": {
-          "description": "Page-level <head> entries. Array of element definitions for meta tags, link tags, script tags, etc. Merged with layout and site-level $head entries.",
+          "description": "Page-level <head> entries. Array of head entries for meta tags, link tags, script tags, etc. Merged with layout and site-level $head entries.",
           "items": {
-            "$ref": "#/$defs/v1/$defs/ElementDef"
+            "$ref": "#/$defs/v1/$defs/HeadEntry"
           },
           "type": "array"
         },
         "$id": {
           "description": "Component identifier string. Used by tooling and the builder.",
-          "examples": ["Counter", "TodoApp", "UserCard"],
+          "examples": [
+            "Counter",
+            "TodoApp",
+            "UserCard"
+          ],
+          "type": "string"
+        },
+        "$dir": {
+          "description": "Base direction for this page's <html> element, overriding `defaults.dir`. Right-to-left content renders left-to-right without it.",
+          "enum": [
+            "ltr",
+            "rtl",
+            "auto"
+          ],
+          "type": "string"
+        },
+        "$lang": {
+          "description": "Language tag for this page's <html> element, overriding `defaults.lang` (site-architecture.md §8.4).",
+          "examples": [
+            "en",
+            "fr",
+            "ar-EG"
+          ],
+          "type": "string"
+        },
+        "$translationKey": {
+          "description": "This page's identity across languages, overriding the one its path implies (site-architecture.md §13.5). Two routes are translations when their keys match; the default key is the path with the locale prefix removed, which is right whenever the paths are parallel and wrong for a localized slug — /fr-ca/a-propos/ shares nothing with /about/ until one of them says so.",
+          "examples": [
+            "about",
+            "blog/hello-world"
+          ],
           "type": "string"
         },
         "$layout": {
           "description": "Layout reference for pages. String path to a layout JSON file, or false to opt out of the default layout.",
-          "examples": ["./layouts/base.json"],
+          "examples": [
+            "./layouts/base.json"
+          ],
+          "oneOf": [
+            {
+              "type": "string"
+            },
+            {
+              "const": false,
+              "type": "boolean"
+            }
+          ]
+        },
+        "$shadow": {
+          "description": "Render this component into a shadow root instead of the light DOM (spec.md §16.6). Off unless set: a shadow root isolates the component's styles from the page and replaces the <slot> emulation with real slot distribution, so it changes how the component composes. Overrides `defaults.shadow` in both directions — `false` opts one component out of a project that opted in.",
           "oneOf": [
             {
+              "enum": [
+                "open",
+                "closed"
+              ],
               "type": "string"
             },
             {
@@ -22884,6 +23394,10 @@
             }
           ]
         },
+        "$sitemap": {
+          "description": "Set false to exclude this page from sitemap.xml (site-architecture.md §8.4.1). Every other page with a URL is included.",
+          "type": "boolean"
+        },
         "$media": {
           "additionalProperties": {
             "type": "string"
@@ -22904,7 +23418,9 @@
         },
         "$schema": {
           "description": "URI identifying the Jx dialect version. Enables schema-aware IDE tooling.",
-          "examples": ["https://jxsuite.com/schema/v1"],
+          "examples": [
+            "https://jxsuite.com/schema/v1"
+          ],
           "type": "string"
         },
         "attributes": {
@@ -22981,7 +23497,9 @@
               "type": "string"
             }
           },
-          "required": ["contentType"]
+          "required": [
+            "contentType"
+          ]
         }
       }
     }