{
  "version": "1.0.0",
  "kind": "olonjs-page-contract",
  "slug": "design-system",
  "title": "Olon Design System - Token reference, color system, components and brand identity",
  "description": "Token reference, color system, typography, components and brand identity for the OlonJS design language.",
  "manifestHref": "/mcp-manifests/design-system.json",
  "systemPrompt": "You are operating the \"Olon Design System - Token reference, color system, components and brand identity\" page in OlonJS Studio. Use only the declared tools and keep mutations valid against the section schema.",
  "sectionTypes": [
    "header",
    "footer",
    "design-system-foundation"
  ],
  "sectionInstances": [
    {
      "id": "global-header",
      "type": "header",
      "scope": "global",
      "label": "header"
    },
    {
      "id": "global-footer",
      "type": "footer",
      "scope": "global",
      "label": "footer"
    },
    {
      "id": "design-system-foundation",
      "type": "design-system-foundation",
      "scope": "local",
      "label": "Olon Foundation"
    }
  ],
  "sectionSchemas": {
    "header": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "anchorId": {
          "type": "string",
          "description": "ui:text"
        },
        "logoText": {
          "type": "string",
          "description": "ui:text"
        },
        "menu": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "label": {
                "type": "string",
                "description": "ui:text"
              },
              "href": {
                "type": "string",
                "description": "ui:text"
              },
              "external": {
                "type": "boolean",
                "description": "ui:checkbox"
              },
              "isCta": {
                "type": "boolean",
                "description": "ui:checkbox"
              },
              "description": {
                "type": "string",
                "description": "ui:textarea"
              },
              "icon": {
                "type": "string",
                "description": "ui:icon-picker"
              },
              "children": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "label": {
                      "type": "string",
                      "description": "ui:text"
                    },
                    "href": {
                      "type": "string",
                      "description": "ui:text"
                    },
                    "external": {
                      "type": "boolean",
                      "description": "ui:checkbox"
                    },
                    "isCta": {
                      "type": "boolean",
                      "description": "ui:checkbox"
                    },
                    "description": {
                      "type": "string",
                      "description": "ui:textarea"
                    },
                    "icon": {
                      "type": "string",
                      "description": "ui:icon-picker"
                    }
                  },
                  "additionalProperties": false,
                  "required": [
                    "label",
                    "href"
                  ]
                },
                "description": "ui:list"
              }
            },
            "additionalProperties": false,
            "required": [
              "label",
              "href"
            ]
          },
          "description": "ui:list"
        },
        "actionsMenu": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "label": {
                "type": "string",
                "description": "ui:text"
              },
              "href": {
                "type": "string",
                "description": "ui:text"
              },
              "external": {
                "type": "boolean",
                "description": "ui:checkbox"
              },
              "isCta": {
                "type": "boolean",
                "description": "ui:checkbox"
              },
              "description": {
                "type": "string",
                "description": "ui:textarea"
              },
              "icon": {
                "type": "string",
                "description": "ui:icon-picker"
              },
              "children": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "label": {
                      "type": "string",
                      "description": "ui:text"
                    },
                    "href": {
                      "type": "string",
                      "description": "ui:text"
                    },
                    "external": {
                      "type": "boolean",
                      "description": "ui:checkbox"
                    },
                    "isCta": {
                      "type": "boolean",
                      "description": "ui:checkbox"
                    },
                    "description": {
                      "type": "string",
                      "description": "ui:textarea"
                    },
                    "icon": {
                      "type": "string",
                      "description": "ui:icon-picker"
                    }
                  },
                  "additionalProperties": false,
                  "required": [
                    "label",
                    "href"
                  ]
                },
                "description": "ui:list"
              }
            },
            "additionalProperties": false,
            "required": [
              "label",
              "href"
            ]
          },
          "description": "ui:list"
        }
      },
      "additionalProperties": false,
      "required": [
        "logoText"
      ]
    },
    "footer": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "anchorId": {
          "type": "string",
          "description": "ui:text"
        },
        "brandText": {
          "type": "string",
          "description": "ui:text"
        },
        "tagline": {
          "type": "string",
          "description": "ui:textarea"
        },
        "versionText": {
          "type": "string",
          "description": "ui:text"
        },
        "columns": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "title": {
                "type": "string",
                "description": "ui:text"
              },
              "menu": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "label": {
                      "type": "string",
                      "description": "ui:text"
                    },
                    "href": {
                      "type": "string",
                      "description": "ui:text"
                    },
                    "external": {
                      "type": "boolean",
                      "description": "ui:checkbox"
                    }
                  },
                  "additionalProperties": false,
                  "required": [
                    "label",
                    "href"
                  ]
                },
                "description": "ui:list"
              }
            },
            "additionalProperties": false,
            "required": [
              "title"
            ]
          },
          "description": "ui:list"
        },
        "bottomLinks": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "label": {
                "type": "string",
                "description": "ui:text"
              },
              "href": {
                "type": "string",
                "description": "ui:text"
              },
              "external": {
                "type": "boolean",
                "description": "ui:checkbox"
              }
            },
            "additionalProperties": false,
            "required": [
              "label",
              "href"
            ]
          },
          "description": "ui:list"
        },
        "copyright": {
          "type": "string",
          "description": "ui:text"
        }
      },
      "additionalProperties": false,
      "required": [
        "brandText",
        "copyright"
      ]
    },
    "design-system-foundation": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "anchorId": {
          "type": "string",
          "description": "ui:text"
        },
        "eyebrow": {
          "type": "string",
          "description": "ui:text"
        },
        "title": {
          "type": "string",
          "description": "ui:text"
        },
        "description": {
          "type": "string",
          "description": "ui:textarea"
        },
        "colorTitle": {
          "type": "string",
          "description": "ui:text"
        },
        "colorDescription": {
          "type": "string",
          "description": "ui:textarea"
        },
        "colorTokens": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "name": {
                "type": "string",
                "description": "ui:text"
              },
              "value": {
                "type": "string",
                "description": "ui:text"
              },
              "label": {
                "type": "string",
                "description": "ui:text"
              },
              "role": {
                "type": "string",
                "description": "ui:text"
              }
            },
            "additionalProperties": false,
            "required": [
              "name",
              "value",
              "label",
              "role"
            ]
          },
          "description": "ui:list"
        },
        "typographyTitle": {
          "type": "string",
          "description": "ui:text"
        },
        "typographyDescription": {
          "type": "string",
          "description": "ui:textarea"
        },
        "typeShowcase": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "label": {
                "type": "string",
                "description": "ui:text"
              },
              "sample": {
                "type": "string",
                "description": "ui:textarea"
              },
              "variant": {
                "type": "string",
                "enum": [
                  "h1",
                  "h2",
                  "body",
                  "caption",
                  "mono"
                ],
                "description": "ui:select"
              }
            },
            "additionalProperties": false,
            "required": [
              "label",
              "sample",
              "variant"
            ]
          },
          "description": "ui:list"
        },
        "typeScale": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "role": {
                "type": "string",
                "description": "ui:text"
              },
              "size": {
                "type": "string",
                "description": "ui:text"
              },
              "weight": {
                "type": "string",
                "description": "ui:text"
              },
              "tracking": {
                "type": "string",
                "description": "ui:text"
              },
              "font": {
                "type": "string",
                "description": "ui:text"
              }
            },
            "additionalProperties": false,
            "required": [
              "role",
              "size",
              "weight",
              "tracking",
              "font"
            ]
          },
          "description": "ui:list"
        },
        "spacingTitle": {
          "type": "string",
          "description": "ui:text"
        },
        "spacingDescription": {
          "type": "string",
          "description": "ui:textarea"
        },
        "spacingTokens": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "label": {
                "type": "string",
                "description": "ui:text"
              },
              "widthPx": {
                "type": "integer",
                "description": "ui:number"
              }
            },
            "additionalProperties": false,
            "required": [
              "label",
              "widthPx"
            ]
          },
          "description": "ui:list"
        },
        "radiusTitle": {
          "type": "string",
          "description": "ui:text"
        },
        "radiusTokens": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "name": {
                "type": "string",
                "description": "ui:text"
              },
              "value": {
                "type": "string",
                "description": "ui:text"
              },
              "usage": {
                "type": "string",
                "description": "ui:text"
              }
            },
            "additionalProperties": false,
            "required": [
              "name",
              "value",
              "usage"
            ]
          },
          "description": "ui:list"
        },
        "componentsTitle": {
          "type": "string",
          "description": "ui:text"
        },
        "buttonTitle": {
          "type": "string",
          "description": "ui:text"
        },
        "buttons": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "label": {
                "type": "string",
                "description": "ui:text"
              },
              "variant": {
                "type": "string",
                "enum": [
                  "primary",
                  "ghost",
                  "secondary"
                ],
                "description": "ui:select"
              },
              "disabled": {
                "type": "boolean"
              }
            },
            "additionalProperties": false,
            "required": [
              "label",
              "variant"
            ]
          },
          "description": "ui:list"
        },
        "badgesTitle": {
          "type": "string",
          "description": "ui:text"
        },
        "badges": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "label": {
                "type": "string",
                "description": "ui:text"
              },
              "variant": {
                "type": "string",
                "enum": [
                  "default",
                  "success",
                  "warning",
                  "error",
                  "info"
                ],
                "description": "ui:select"
              }
            },
            "additionalProperties": false,
            "required": [
              "label",
              "variant"
            ]
          },
          "description": "ui:list"
        },
        "inputTitle": {
          "type": "string",
          "description": "ui:text"
        },
        "inputPlaceholder": {
          "type": "string",
          "description": "ui:text"
        },
        "cardTitle": {
          "type": "string",
          "description": "ui:text"
        },
        "cardHeading": {
          "type": "string",
          "description": "ui:text"
        },
        "cardBody": {
          "type": "string",
          "description": "ui:textarea"
        },
        "shadowsTitle": {
          "type": "string",
          "description": "ui:text"
        },
        "shadows": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "label": {
                "type": "string",
                "description": "ui:text"
              },
              "boxShadow": {
                "type": "string",
                "description": "ui:text"
              }
            },
            "additionalProperties": false,
            "required": [
              "label",
              "boxShadow"
            ]
          },
          "description": "ui:list"
        },
        "brandTitle": {
          "type": "string",
          "description": "ui:text"
        },
        "brandDarkNote": {
          "type": "string",
          "description": "ui:text"
        },
        "brandLightNote": {
          "type": "string",
          "description": "ui:text"
        }
      },
      "additionalProperties": false,
      "required": [
        "eyebrow",
        "title",
        "description",
        "colorTitle",
        "colorDescription",
        "colorTokens",
        "typographyTitle",
        "typographyDescription",
        "typeShowcase",
        "typeScale",
        "spacingTitle",
        "spacingDescription",
        "spacingTokens",
        "radiusTitle",
        "radiusTokens",
        "componentsTitle",
        "buttonTitle",
        "buttons",
        "badgesTitle",
        "badges",
        "inputTitle",
        "inputPlaceholder",
        "cardTitle",
        "cardHeading",
        "cardBody",
        "shadowsTitle",
        "shadows",
        "brandTitle",
        "brandDarkNote",
        "brandLightNote"
      ]
    }
  },
  "tools": [
    {
      "name": "update-section",
      "description": "Update a section field in the Studio draft. Does not persist — call save when all updates are complete. Use sectionType to select the matching schema from sectionSchemas.",
      "inputSchema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "slug": {
            "type": "string",
            "description": "Canonical page slug currently open in Studio."
          },
          "sectionId": {
            "type": "string",
            "description": "Concrete section instance id inside the current draft."
          },
          "sectionType": {
            "type": "string",
            "description": "Section type being updated (for example \"hero\" or \"header\"). Used to select the correct validation schema."
          },
          "scope": {
            "type": "string",
            "enum": [
              "local",
              "global"
            ],
            "default": "local"
          },
          "data": {
            "type": "object",
            "description": "Full replacement payload validated against the schema declared for sectionType."
          },
          "itemPath": {
            "type": "array",
            "description": "Optional root-to-leaf selection path for targeted field mutation.",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "fieldKey": {
                  "type": "string"
                },
                "itemId": {
                  "type": "string"
                }
              },
              "required": [
                "fieldKey"
              ]
            }
          },
          "value": {
            "description": "Value written to the final field targeted by itemPath."
          },
          "fieldKey": {
            "type": "string",
            "description": "Shorthand for a top-level scalar field update when itemPath is omitted."
          }
        },
        "required": [
          "sectionId"
        ],
        "oneOf": [
          {
            "required": [
              "data"
            ]
          },
          {
            "required": [
              "itemPath",
              "value"
            ]
          },
          {
            "required": [
              "fieldKey",
              "value"
            ]
          }
        ]
      }
    },
    {
      "name": "save",
      "description": "Persist all pending draft changes using the active save mode (local file, hot save, or save2repo). Call once after all update-section calls are complete.",
      "inputSchema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {}
      }
    }
  ]
}