@sparkerp/plugin-sdk 0.1.0

package/bundle/schemas/menu.schema.json

@@ -0,0 +1,106 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://erp.internal/schema/menu-definition.schema.json",
+  "title": "MenuDefinitionArtifact",
+  "description": "The real on-disk authoring shape for a menu JSON artifact (spk-assembly/metadata/menu/*.json) — confirmed against a live shipped file (crm-foundation-main-menu.json) and grounded in frontend/packages/menu-engine/src/types.ts's MenuDefinition/MenuNode. Top-level wrapper (name/description/definition/metadata/modules) matches every other JsonArtifactAuthoringController-backed artifact's persisted shape; `definition` is MenuDefinition verbatim (a real nested object, unlike workflow's string-encoded *Json columns).",
+  "type": "object",
+  "required": ["name", "definition"],
+  "properties": {
+    "name": { "type": "string" },
+    "description": { "type": "string" },
+    "metadata": { "type": "object" },
+    "modules": { "type": "array", "items": { "type": "string" } },
+    "definition": {
+      "type": "object",
+      "required": ["contractVersion", "name", "nodes"],
+      "properties": {
+        "contractVersion": { "type": "number", "enum": [1] },
+        "name": { "type": "string" },
+        "description": { "type": ["string", "null"] },
+        "tags": { "type": "array", "items": { "type": "string" } },
+        "nodes": { "type": "array", "items": { "$ref": "#/definitions/menuNode" } }
+      }
+    }
+  },
+  "definitions": {
+    "menuNode": {
+      "type": "object",
+      "required": ["id", "name", "displayName", "sequence", "children", "navigation", "visibility"],
+      "properties": {
+        "id": { "type": "string" },
+        "name": { "type": "string" },
+        "displayName": { "type": "string" },
+        "displayNameKey": { "type": ["string", "null"], "description": "i18n key resolved via io.t(...); displayName is the plain-text fallback, never itself passed through io.t." },
+        "description": { "type": ["string", "null"] },
+        "icon": { "type": ["string", "null"] },
+        "color": { "type": ["string", "null"] },
+        "tags": { "type": "array", "items": { "type": "string" } },
+        "sequence": { "type": "number" },
+        "children": { "type": "array", "items": { "$ref": "#/definitions/menuNode" } },
+        "navigation": {
+          "type": "object",
+          "required": ["openMode"],
+          "properties": {
+            "route": { "type": ["string", "null"] },
+            "targetPage": { "type": ["string", "null"] },
+            "openMode": { "type": "string", "enum": ["current-tab", "new-tab", "dialog", "drawer", "external-url"] },
+            "externalUrl": { "type": ["string", "null"], "description": "Only meaningful when openMode is external-url." }
+          }
+        },
+        "visibility": {
+          "type": "object",
+          "required": ["visible", "enabled", "devices"],
+          "properties": {
+            "visible": { "type": "boolean" },
+            "enabled": { "type": "boolean" },
+            "devices": { "type": "array", "items": { "type": "string", "enum": ["desktop", "mobile", "tablet"] }, "description": "Empty = visible on every device type." }
+          }
+        },
+        "security": {
+          "type": "object",
+          "properties": {
+            "roles": { "type": "array", "items": { "type": "string" } },
+            "permissionGroups": { "type": "array", "items": { "type": "string" } },
+            "featureFlags": { "type": "array", "items": { "type": "string" } },
+            "licenseRequirement": { "type": ["string", "null"] },
+            "tenantScope": { "type": ["string", "null"] },
+            "companyIds": { "type": "array", "items": { "type": "string" } },
+            "branchIds": { "type": "array", "items": { "type": "string" } },
+            "countryIds": { "type": "array", "items": { "type": "string" } },
+            "departmentIds": { "type": "array", "items": { "type": "string" } }
+          }
+        },
+        "badge": {
+          "type": "object",
+          "required": ["source"],
+          "properties": {
+            "source": { "type": "string", "enum": ["pending-approvals", "notification-count", "employee-count", "data-service", "custom-expression"] },
+            "expression": { "type": ["string", "null"], "description": "Only meaningful when source is custom-expression." },
+            "dataServiceName": { "type": ["string", "null"], "description": "Only meaningful when source is data-service — a published Data Service artifact's name." },
+            "color": { "type": ["string", "null"] }
+          }
+        },
+        "personalization": {
+          "type": "object",
+          "properties": {
+            "pinnable": { "type": "boolean" },
+            "defaultLanding": { "type": "boolean" },
+            "variants": { "type": "array", "items": { "type": "string" } }
+          }
+        },
+        "advanced": {
+          "type": "object",
+          "properties": {
+            "cache": { "type": "boolean" },
+            "lazyLoading": { "type": "boolean" },
+            "breadcrumb": { "type": "boolean" },
+            "seoName": { "type": ["string", "null"] },
+            "analyticsId": { "type": ["string", "null"] },
+            "cssClass": { "type": ["string", "null"] },
+            "metadataJson": { "type": ["string", "null"], "description": "Raw JSON text, an open escape hatch — not parsed into a typed shape here." }
+          }
+        }
+      }
+    }
+  }
+}

package/bundle/schemas/mobile-nav.schema.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://erp.internal/schema/mobile-nav-definition.schema.json",
+  "title": "MobileNavDefinitionArtifact",
+  "description": "The real on-disk authoring shape for a mobile-nav JSON artifact (spk-assembly/metadata/mobile_nav/*.json), grounded in frontend/packages/mobile-nav-engine/src/types.ts's MobileNavDefinition/MobileNavItem — confirmed against a live shipped file (hcm-mobile-nav.json). Deliberately a DISTINCT, narrower content model from menu-definition.schema.json, not a device filter on it: a FLAT item list (no children/tree, no security/badge/personalization/advanced blocks), because the two real mobile surfaces (a bottom tab row, a slide-out drawer) never nest, per the type file's own doc comment. `mode`/`items[].surfaces` are the mobile-specific fields this schema exists to capture — every menu-definition MenuNode field with no mobile-nav counterpart (children, security, badge, personalization, advanced, displayNameKey) is intentionally absent here, not merged in.",
+  "type": "object",
+  "required": ["name", "definition"],
+  "properties": {
+    "name": { "type": "string" },
+    "description": { "type": "string" },
+    "metadata": { "type": "object" },
+    "modules": { "type": "array", "items": { "type": "string" } },
+    "definition": {
+      "type": "object",
+      "required": ["contractVersion", "name", "mode", "items"],
+      "properties": {
+        "contractVersion": { "type": "number", "enum": [1] },
+        "name": { "type": "string" },
+        "description": { "type": ["string", "null"] },
+        "mode": {
+          "type": "string",
+          "enum": ["bottom-tabs", "drawer", "hybrid"],
+          "description": "\"hybrid\" is not a third render shape: a page authors TWO core.mobile-nav block instances against this same definition, one bottom-tabs one drawer — see mobile-nav-engine's own doc comment."
+        },
+        "items": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["id", "label"],
+            "properties": {
+              "id": { "type": "string" },
+              "label": { "type": "string" },
+              "icon": { "type": ["string", "null"] },
+              "color": { "type": ["string", "null"] },
+              "route": { "type": ["string", "null"] },
+              "badge": { "type": ["string", "null"] },
+              "isFab": { "type": "boolean", "description": "Raised primary action tile — bottom-tabs/hybrid only." },
+              "surfaces": {
+                "type": "array",
+                "items": { "type": "string", "enum": ["bottom-tabs", "drawer"] },
+                "description": "Which rendered surface(s) show this item. Absent/empty = every surface `mode` implies."
+              },
+              "companyIds": { "type": "array", "items": { "type": "string" } },
+              "branchIds": { "type": "array", "items": { "type": "string" } },
+              "countryIds": { "type": "array", "items": { "type": "string" } },
+              "departmentIds": { "type": "array", "items": { "type": "string" } }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/bundle/schemas/page-template.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://erp-platform.dev/schemas/page-template.schema.json",
+  "title": "Page template contract v1",
+  "description": "W1-04 (gap 1) - reusable page chrome with named slot placeholders a page fills. One level of inheritance max: a specialized template's `extends` is checked by PageTemplateRegistry.register against its parent (never itself extended) and its own slot names must be a subset of the parent's - the schema alone cannot express that cross-reference, so it is enforced at registration, not here. `kind: \"wizard\"` (added 2026-07-16, UI-designer audit) declares an ordered multi-step template: `steps` (required, >= 2) each reference a declared slot; the runtime shows one step at a time with beforeSave gating per step and a single deferred commit at the end.",
+  "type": "object",
+  "$defs": {
+    "identifier": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z_][A-Za-z0-9_-]*$" },
+    "i18nKey": { "type": "string", "minLength": 1, "maxLength": 256 },
+    "row": { "type": "object", "description": "Same shape as page-definition.schema.json's #/$defs/row." }
+  },
+  "properties": {
+    "contractVersion": { "const": 1 },
+    "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*(\\.[a-z][a-z0-9-]*)+$" },
+    "version": { "type": "string", "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$" },
+    "publisher": { "type": "string", "minLength": 1 },
+    "extends": { "type": "string" },
+    "kind": { "enum": ["standard", "wizard"] },
+    "steps": {
+      "type": "array",
+      "minItems": 2,
+      "items": {
+        "type": "object",
+        "properties": { "slot": { "$ref": "#/$defs/identifier" }, "titleKey": { "$ref": "#/$defs/i18nKey" } },
+        "required": ["slot", "titleKey"],
+        "additionalProperties": false
+      }
+    },
+    "regions": {
+      "type": "array",
+      "items": {
+        "oneOf": [
+          { "type": "object", "properties": { "region": { "const": "row" }, "row": { "$ref": "#/$defs/row" } }, "required": ["region", "row"], "additionalProperties": false },
+          {
+            "type": "object",
+            "properties": { "region": { "const": "slot" }, "name": { "$ref": "#/$defs/identifier" }, "required": { "type": "boolean" } },
+            "required": ["region", "name"],
+            "additionalProperties": false
+          }
+        ]
+      }
+    }
+  },
+  "required": ["contractVersion", "id", "version", "publisher", "regions"],
+  "additionalProperties": false
+}

package/bundle/schemas/page.schema.json

@@ -0,0 +1,292 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://erp-platform.dev/schemas/page-definition.schema.json",
+  "title": "Page definition contract v1",
+  "description": "The machine-readable contract a page ships (W1-03, ADR 0012): the Page -> Row -> Column -> Item layout taxonomy (an item is a block instance, an embedded form instance, or a link/shortcut - gap 10's dashboard seam), per-node visibility rules, the mobile-first breakpoint shape (still no `xs` key inside breakpointOverrides itself - sm/md/lg/xl only), the route + typed-parameter + menu + breadcrumb contract (gaps 2/3), and variant overrides (gap 4). 2026-07-31: a row/column/item's own `hiddenAtXs` (sibling to `breakpoints`, not part of breakpointOverrides) is now the way desktop-only-shown content is expressed - authored hidden at xs, re-shown via a wider breakpoint's `hidden: false` override. Cross-references (does a blockType/formId actually resolve, does a template/slot exist) are checked by validatePageDefinition/resolveTemplate against the live registries, not by this schema alone - the same division of labor block-definition.schema.json and form-definition.schema.json already draw.",
+  "type": "object",
+  "$defs": {
+    "identifier": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z_][A-Za-z0-9_-]*$"
+    },
+    "i18nKey": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256
+    },
+    "expression": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 2000
+    },
+    "breakpointOverride": {
+      "type": "object",
+      "properties": {
+        "hidden": { "type": "boolean" },
+        "span": { "type": "integer", "minimum": 1, "maximum": 12 }
+      },
+      "additionalProperties": false
+    },
+    "breakpointOverrides": {
+      "description": "Mobile-first: no `xs` key exists here at all - xs's own hidden state is instead the sibling `hiddenAtXs` property on the item/column/row itself (2026-07-31), not a key of this shape.",
+      "type": "object",
+      "properties": {
+        "sm": { "$ref": "#/$defs/breakpointOverride" },
+        "md": { "$ref": "#/$defs/breakpointOverride" },
+        "lg": { "$ref": "#/$defs/breakpointOverride" },
+        "xl": { "$ref": "#/$defs/breakpointOverride" }
+      },
+      "additionalProperties": false
+    },
+    "linkItem": {
+      "type": "object",
+      "properties": {
+        "route": { "type": "string", "minLength": 1 },
+        "params": { "type": "object" },
+        "labelKey": { "$ref": "#/$defs/i18nKey" },
+        "icon": { "type": "string" }
+      },
+      "required": ["route", "labelKey"],
+      "additionalProperties": false
+    },
+    "item": {
+      "type": "object",
+      "properties": {
+        "id": { "$ref": "#/$defs/identifier" },
+        "kind": { "enum": ["block", "form", "link"] },
+        "visibility": { "$ref": "#/$defs/expression" },
+        "block": { "type": "object", "description": "A frozen @erp/block-engine BlockInstanceConfig - validated against the live BlockRegistry at mount time." },
+        "form": { "type": "object", "description": "A frozen @erp/form-engine FormInstanceConfig - validated against the live FormRegistry at mount time." },
+        "link": { "$ref": "#/$defs/linkItem" },
+        "breakpoints": { "$ref": "#/$defs/breakpointOverrides" },
+        "itemRef": { "type": "string", "minLength": 1, "description": "References an existing xs item's id (2026-07-19) - set on a non-xs breakpoint's own arrangement tree for the default 'Shared' rearrangement case; a Detached breakpoint's tree instead holds items with real block/form/link content and no itemRef at all." },
+        "hiddenAtXs": { "type": "boolean", "description": "2026-07-31 - whether this item starts hidden at the mobile-first base breakpoint; absent/false = unchanged default (visible at xs). Lets a wider breakpoint's `breakpoints.{bp}.hidden = false` legitimately re-show it." }
+      },
+      "required": ["id", "kind"],
+      "additionalProperties": false
+    },
+    "column": {
+      "type": "object",
+      "properties": {
+        "id": { "$ref": "#/$defs/identifier" },
+        "name": { "type": "string", "minLength": 1, "maxLength": 128, "description": "Author-facing display name (optional) - never read at runtime, purely for Studio's own labeling." },
+        "items": { "type": "array", "items": { "$ref": "#/$defs/item" } },
+        "visibility": { "$ref": "#/$defs/expression" },
+        "breakpoints": { "$ref": "#/$defs/breakpointOverrides" },
+        "hiddenAtXs": { "type": "boolean", "description": "2026-07-31 - ItemSpec.hiddenAtXs's identical sibling, one level up." },
+        "spanAtXs": { "type": "integer", "minimum": 1, "maximum": 12, "description": "2026-07-31 - a real, independent Bootstrap-style col-{n} for xs, not a mirror of breakpoints.sm.span. Absent = existing mirror-sm default." },
+        "card": {
+          "type": "object",
+          "properties": {
+            "maxWidth": { "type": "number" },
+            "padding": { "type": "number" },
+            "elevation": { "type": "number" }
+          },
+          "additionalProperties": false
+        }
+      },
+      "required": ["id", "items"],
+      "additionalProperties": false
+    },
+    "row": {
+      "type": "object",
+      "properties": {
+        "id": { "$ref": "#/$defs/identifier" },
+        "name": { "type": "string", "minLength": 1, "maxLength": 128, "description": "Author-facing display name (optional) - never read at runtime, purely for Studio's own labeling." },
+        "columns": { "type": "array", "items": { "$ref": "#/$defs/column" } },
+        "visibility": { "$ref": "#/$defs/expression" },
+        "breakpoints": { "$ref": "#/$defs/breakpointOverrides" },
+        "defer": { "type": "boolean", "description": "Deferred/lazy region mounting (gap 6) - items are not mounted until first activation." },
+        "align": { "enum": ["start", "center", "end"], "description": "Horizontal placement of this row's column(s) within the full row width (2026-07-17) - e.g. a login card anchored to one side of a full-bleed background." },
+        "edgeSpacing": { "type": "number", "description": "Pixels of breathing room off the viewport edge a start/end align anchors to (2026-07-17) - authored data, not a fixed adapter constant." },
+        "hiddenAtXs": { "type": "boolean", "description": "2026-07-31 - ItemSpec.hiddenAtXs's identical sibling, one level up." }
+      },
+      "required": ["id", "columns"],
+      "additionalProperties": false
+    },
+    "routeParam": {
+      "type": "object",
+      "properties": {
+        "name": { "$ref": "#/$defs/identifier" },
+        "type": { "enum": ["string", "number", "boolean", "date"] },
+        "required": { "type": "boolean" }
+      },
+      "required": ["name", "type", "required"],
+      "additionalProperties": false
+    },
+    "route": {
+      "type": "object",
+      "properties": {
+        "pattern": { "type": "string", "minLength": 1, "pattern": "^/" },
+        "params": { "type": "array", "items": { "$ref": "#/$defs/routeParam" } }
+      },
+      "required": ["pattern", "params"],
+      "additionalProperties": false
+    },
+    "menuEntry": {
+      "type": "object",
+      "properties": {
+        "area": { "type": "string", "minLength": 1 },
+        "group": { "type": "string", "minLength": 1 },
+        "labelKey": { "$ref": "#/$defs/i18nKey" },
+        "icon": { "type": "string" },
+        "visibility": { "$ref": "#/$defs/expression" },
+        "order": { "type": "number" }
+      },
+      "required": ["area", "group", "labelKey"],
+      "additionalProperties": false
+    },
+    "breadcrumb": {
+      "type": "object",
+      "properties": {
+        "labelExpression": { "$ref": "#/$defs/expression" },
+        "parentRoute": { "type": "string" }
+      },
+      "required": ["labelExpression"],
+      "additionalProperties": false
+    },
+    "overlay": {
+      "description": "Overlay surface (2026-07-16 UI-designer audit): a modal/drawer region hosting composed rows, opened/closed by openDialog/closeDialog intents and rendered through the Phase 5 dialog render-node contract.",
+      "type": "object",
+      "properties": {
+        "id": { "$ref": "#/$defs/identifier" },
+        "kind": { "enum": ["modal", "drawer"] },
+        "titleKey": { "$ref": "#/$defs/i18nKey" },
+        "rows": { "type": "array", "items": { "$ref": "#/$defs/row" } },
+        "dismissible": { "type": "boolean" }
+      },
+      "required": ["id", "kind", "titleKey", "rows"],
+      "additionalProperties": false
+    },
+    "variantRule": {
+      "type": "object",
+      "properties": {
+        "role": { "type": "string" },
+        "deviceClass": {
+          "oneOf": [
+            { "enum": ["mobile", "tablet", "desktop"] },
+            { "type": "array", "items": { "enum": ["mobile", "tablet", "desktop"] }, "minItems": 1 }
+          ]
+        },
+        "paramEquals": { "type": "object", "additionalProperties": { "type": "string" } }
+      },
+      "additionalProperties": false
+    },
+    "variant": {
+      "type": "object",
+      "properties": {
+        "id": { "$ref": "#/$defs/identifier" },
+        "rule": { "$ref": "#/$defs/variantRule" },
+        "template": { "type": "string" },
+        "slotFills": { "type": "object", "additionalProperties": { "type": "array", "items": { "$ref": "#/$defs/row" } } },
+        "rows": { "type": "array", "items": { "$ref": "#/$defs/row" } }
+      },
+      "required": ["id", "rule"],
+      "additionalProperties": false
+    },
+    "canvasPosition": {
+      "description": "Freeform placement envelope (2026-07-24, mirrors @erp/block-engine's own canvas position shape) - authored data, not derived from flow layout.",
+      "type": "object",
+      "properties": {
+        "x": { "type": "number" },
+        "y": { "type": "number" },
+        "width": { "type": "number" },
+        "height": { "type": "number" },
+        "zIndex": { "type": "number" },
+        "hidden": { "type": "boolean" }
+      },
+      "required": ["x", "y", "width", "height"],
+      "additionalProperties": false
+    },
+    "canvasItem": {
+      "description": "One freeform-placed item in a Page's own `canvas` (2026-07-24, the same 'Free canvas' mode @erp/block-engine already has) - `item` reuses the same `item` $def a row's own column places, just positioned absolutely instead of flowed.",
+      "type": "object",
+      "properties": {
+        "id": { "$ref": "#/$defs/identifier" },
+        "item": { "$ref": "#/$defs/item" },
+        "position": { "$ref": "#/$defs/canvasPosition" },
+        "locked": { "type": "boolean" }
+      },
+      "required": ["id", "item", "position"],
+      "additionalProperties": false
+    },
+    "designer": {
+      "type": "object",
+      "properties": {
+        "displayNameKey": { "$ref": "#/$defs/i18nKey" },
+        "descriptionKey": { "$ref": "#/$defs/i18nKey" },
+        "icon": { "type": "string" },
+        "category": { "enum": ["workspace", "detail", "list", "dashboard", "landing"] },
+        "propertyGroups": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": { "id": { "type": "string" }, "titleKey": { "$ref": "#/$defs/i18nKey" } },
+            "required": ["id", "titleKey"],
+            "additionalProperties": false
+          }
+        },
+        "preview": {
+          "type": "object",
+          "properties": { "kind": { "const": "page" }, "sampleKey": { "type": "string" } },
+          "required": ["kind"],
+          "additionalProperties": false
+        }
+      },
+      "required": ["displayNameKey", "descriptionKey", "icon", "category", "propertyGroups", "preview"],
+      "additionalProperties": false
+    },
+    "devicePersistenceRule": {
+      "type": "object",
+      "description": "\"Remember this across a browser restart\" (2026-08-13) — see PageDefinition.devicePersistence's own doc comment (page-engine/src/types.ts). Runtime-host contract only, not read by this package.",
+      "properties": {
+        "valueScope": { "enum": ["page", "form"] },
+        "valueKey": { "type": "string", "minLength": 1 },
+        "valueScopeKey": { "type": "string", "minLength": 1 },
+        "enabledScope": { "enum": ["page", "form"] },
+        "enabledKey": { "type": "string", "minLength": 1 },
+        "enabledScopeKey": { "type": "string", "minLength": 1 },
+        "triggerScope": { "enum": ["session", "page", "form"] },
+        "triggerKey": { "type": "string", "minLength": 1 },
+        "triggerScopeKey": { "type": "string", "minLength": 1 },
+        "storageKey": { "type": "string", "minLength": 1 }
+      },
+      "required": ["valueScope", "valueKey", "triggerScope", "triggerKey", "storageKey"],
+      "additionalProperties": false
+    }
+  },
+  "properties": {
+    "contractVersion": { "const": 1 },
+    "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*(\\.[a-z][a-z0-9-]*)+$" },
+    "version": { "type": "string", "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$" },
+    "publisher": { "type": "string", "minLength": 1 },
+    "title": { "$ref": "#/$defs/i18nKey" },
+    "template": { "type": "string" },
+    "slotFills": { "type": "object", "additionalProperties": { "type": "array", "items": { "$ref": "#/$defs/row" } } },
+    "rows": { "type": "array", "items": { "$ref": "#/$defs/row" } },
+    "canvas": { "type": "array", "items": { "$ref": "#/$defs/canvasItem" } },
+    "overlays": { "type": "array", "items": { "$ref": "#/$defs/overlay" } },
+    "theme": {
+      "type": "object",
+      "properties": { "tokenSetId": { "type": "string" }, "overrides": { "type": "object" } },
+      "required": ["tokenSetId"],
+      "additionalProperties": false
+    },
+    "route": { "$ref": "#/$defs/route" },
+    "menu": { "$ref": "#/$defs/menuEntry" },
+    "breadcrumb": { "$ref": "#/$defs/breadcrumb" },
+    "variants": { "type": "array", "items": { "$ref": "#/$defs/variant" } },
+    "designer": { "$ref": "#/$defs/designer" },
+    "access": { "type": "string", "enum": ["public", "authenticated"] },
+    "backgroundImageUrl": { "type": "string" },
+    "isLoginPage": { "type": "boolean" },
+    "isSessionExpiredPage": { "type": "boolean" },
+    "isAccessDeniedPage": { "type": "boolean" },
+    "devicePersistence": { "type": "array", "items": { "$ref": "#/$defs/devicePersistenceRule" } },
+    "modules": { "type": "array", "items": { "type": "string" }, "description": "App-module ids this page belongs to (e.g. \"hcm-foundation-home\") - TenantPageHost's per-module page listing only surfaces a page if it's present here. Load-bearing in practice for any page reached via the app sidenav/module shell, even on pages authored before this was documented." }
+  },
+  "required": ["contractVersion", "id", "version", "publisher", "title", "rows", "route", "designer"],
+  "additionalProperties": false
+}