@jxsuite/schema 1.4.0 → 1.8.0

package/schema.json

@@ -634,6 +634,7 @@
             "resolvePaths",
             "lower",
             "emit",
+            "head",
             "assets",
             "mount",
             "dialect",
@@ -957,11 +958,24 @@
         "domain": {
           "type": "string"
         },
-        "expires": {
-          "type": "string"
-        },
         "filter": {
-          "$ref": "#/$defs/RefObject"
+          "anyOf": [
+            {
+              "$ref": "#/$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": {
@@ -1542,7 +1556,7 @@
           "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"
@@ -1823,7 +1837,7 @@
           "$ref": "#/$defs/NumberOrRef"
         },
         "tagName": {
-          "$ref": "#/$defs/TagName"
+          "$ref": "#/$defs/ElementTagName"
         },
         "textContent": {
           "$ref": "#/$defs/StringOrRef"
@@ -6020,10 +6034,13 @@
       "oneOf": [
         {
           "items": {
-            "oneOf": [
+            "anyOf": [
               {
                 "$ref": "#/$defs/ElementDef"
               },
+              {
+                "$ref": "#/$defs/SwitchNode"
+              },
               {
                 "$ref": "#/$defs/ArrayNamespace"
               },
@@ -7719,6 +7736,26 @@
             }
           ]
         },
+        "animation-delay-end": {
+          "oneOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "number"
+            }
+          ]
+        },
+        "animation-delay-start": {
+          "oneOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "number"
+            }
+          ]
+        },
         "animation-direction": {
           "oneOf": [
             {
@@ -7869,6 +7906,26 @@
             }
           ]
         },
+        "animationDelayEnd": {
+          "oneOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "number"
+            }
+          ]
+        },
+        "animationDelayStart": {
+          "oneOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "number"
+            }
+          ]
+        },
         "animationDirection": {
           "oneOf": [
             {
@@ -18209,6 +18266,16 @@
             }
           ]
         },
+        "scroll-axis-lock": {
+          "oneOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "number"
+            }
+          ]
+        },
         "scroll-behavior": {
           "oneOf": [
             {
@@ -18529,6 +18596,16 @@
             }
           ]
         },
+        "scrollAxisLock": {
+          "oneOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "number"
+            }
+          ]
+        },
         "scrollBehavior": {
           "oneOf": [
             {
@@ -22674,8 +22751,9 @@
       "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",
@@ -22891,6 +22969,85 @@
         "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/TagName"
+            },
+            "operator": {
+              "const": "?:",
+              "type": "string"
+            },
+            "target": {
+              "$ref": "#/$defs/ExpressionOperand"
+            },
+            "value": {
+              "$ref": "#/$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/TagName"
+              },
+              "type": "object"
+            },
+            "default": {
+              "$ref": "#/$defs/TagName"
+            },
+            "operator": {
+              "const": "switch",
+              "type": "string"
+            },
+            "target": {
+              "$ref": "#/$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/TagName"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "$expression": {
+              "$ref": "#/$defs/TagExpression"
+            }
+          },
+          "required": [
+            "$expression"
+          ],
+          "type": "object"
+        }
+      ]
+    },
     "JsonSchemaType": {
       "enum": [
         "string",
@@ -22930,7 +23087,15 @@
           "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": [
@@ -22953,6 +23118,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": {
@@ -22996,6 +23165,67 @@
         }
       },
       "type": "object"
+    },
+    "PathsValue": {
+      "$id": "https://jxsuite.com/schema/document/paths/v2",
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "description": "Explicit value list: generates one page per value, bound to `param` (default \"value\").",
+          "properties": {
+            "param": {
+              "description": "Route parameter to fill (default \"value\").",
+              "type": "string"
+            },
+            "values": {
+              "description": "The values to expand.",
+              "type": "array"
+            }
+          },
+          "required": [
+            "values"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "description": "JSON data-file source: loads a project-relative file that must contain an array, and generates one page per item.",
+          "properties": {
+            "$ref": {
+              "description": "Project-relative path to a .json file containing an array.",
+              "type": "string"
+            },
+            "field": {
+              "description": "Item field providing the parameter value (default \"id\").",
+              "type": "string"
+            },
+            "param": {
+              "description": "Route parameter to fill (default \"id\").",
+              "type": "string"
+            }
+          },
+          "required": [
+            "$ref"
+          ],
+          "type": "object"
+        },
+        {
+          "description": "Legacy explicit form: an array of ready-made parameter objects, used as-is with no expansion. Prefer one of the source shapes above.",
+          "items": {
+            "additionalProperties": {
+              "type": "string"
+            },
+            "type": "object"
+          },
+          "type": "array"
+        },
+        {
+          "description": "A source shape contributed by an extension this schema cannot see. The project's generated document.schema.json validates these exactly; enable the owning extension and regenerate with `jx schema` to get precise checking here.",
+          "minProperties": 1,
+          "type": "object"
+        }
+      ],
+      "description": "Default $paths source union: the core shapes, plus a catch-all for source shapes contributed by extensions this schema cannot see. The project's generated document.schema.json replaces this with the exact set its extensions provide."
     }
   },
   "$id": "https://jxsuite.com/schema/v1",
@@ -23034,9 +23264,9 @@
       "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/ElementDef"
+        "$ref": "#/$defs/HeadEntry"
       },
       "type": "array"
     },
@@ -23049,6 +23279,32 @@
       ],
       "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": [
@@ -23064,6 +23320,26 @@
         }
       ]
     },
+    "$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"
+        },
+        {
+          "const": false,
+          "type": "boolean"
+        }
+      ]
+    },
+    "$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"
@@ -23079,8 +23355,8 @@
       "type": "object"
     },
     "$paths": {
-      "description": "Dynamic route parameters. Maps parameter names to data sources for generating one page per entry at build time.",
-      "type": "object"
+      "$ref": "https://jxsuite.com/schema/document/paths/v2",
+      "description": "Dynamic route source for a page: expands one page per entry at build time. One of the core shapes (explicit `values`, a `$ref` data file, or a bare array of parameter objects) or a source shape contributed by an enabled extension, such as the parser's `contentType`."
     },
     "$schema": {
       "description": "URI identifying the Jx dialect version. Enables schema-aware IDE tooling.",

package/schemas/document.paths.schema.json

@@ -1,6 +1,59 @@
 {
   "$id": "https://jxsuite.com/schema/document/paths/v2",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "description": "Default $paths-value union for documents. Per-project entry documents override this resource with the union of extension-contributed paths shapes.",
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "description": "Explicit value list: generates one page per value, bound to `param` (default \"value\").",
+      "properties": {
+        "param": {
+          "description": "Route parameter to fill (default \"value\").",
+          "type": "string"
+        },
+        "values": {
+          "description": "The values to expand.",
+          "type": "array"
+        }
+      },
+      "required": ["values"],
+      "type": "object"
+    },
+    {
+      "additionalProperties": false,
+      "description": "JSON data-file source: loads a project-relative file that must contain an array, and generates one page per item.",
+      "properties": {
+        "$ref": {
+          "description": "Project-relative path to a .json file containing an array.",
+          "type": "string"
+        },
+        "field": {
+          "description": "Item field providing the parameter value (default \"id\").",
+          "type": "string"
+        },
+        "param": {
+          "description": "Route parameter to fill (default \"id\").",
+          "type": "string"
+        }
+      },
+      "required": ["$ref"],
+      "type": "object"
+    },
+    {
+      "description": "Legacy explicit form: an array of ready-made parameter objects, used as-is with no expansion. Prefer one of the source shapes above.",
+      "items": {
+        "additionalProperties": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    {
+      "description": "A source shape contributed by an extension this schema cannot see. The project's generated document.schema.json validates these exactly; enable the owning extension and regenerate with `jx schema` to get precise checking here.",
+      "minProperties": 1,
+      "type": "object"
+    }
+  ],
+  "description": "Default $paths-value union for documents: the core source shapes. Per-project entry documents override this resource with those members PLUS every extension-contributed paths shape.",
   "title": "Jx Document Paths Union"
 }