{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "$id": "https://a2uicatalog.ai/catalogue/a2ui-atoms-v1.json",
 "protocolVersion": "1.0",
 "catalogId": "https://a2uicatalog.ai/catalogue/a2ui-atoms-v1.json",
 "title": "A2UI Atoms Catalog",
 "description": "The A2UI multi-surface atom vocabulary as an A2UI-v1.0 catalog document. Each stable atom is a component; a host resolves createSurface.catalogId (this file's URL) to it.",
 "instructions": "Every key under `components` is a valid `component` value (573 components). Compose layouts with Column/Row containers; each component's fields are its properties. Component envelope keys are `@`-prefixed in A2UI v1.0: `@catalogId` (set it on every component of this catalogue when the surface default is another catalog), `@metadata`, `@accessibility`, `@checks`; only `id` and `component` are unprefixed, and a plain `catalogId`, `metadata`, `accessibility` or `checks` is an ordinary component property. Canonical URI: https://a2uicatalog.ai/catalogue/a2ui-atoms-v1.json — full prose spec (descriptions, surfaces, attribution): https://a2uicatalog.ai/spec.json Per-atom `x-renderers` maps renderer id to a status string (what draws the atom); per-check evidence, dates and notes: https://a2uicatalog.ai/catalogue/renderer-matrix-v1.json (status rules version 5).",
 "components": {
  "intro": {
   "type": "object",
   "description": "Italic series link and/or transparency note shown at the top",
   "properties": {
    "component": {
     "const": "intro"
    },
    "series_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "series_url": {
     "description": "url",
     "type": "string"
    },
    "continuation": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "note": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-chat",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Italic series link and/or transparency note shown at the top A phrase like 'show whether content was recently updated or is no longer supported' usually means badge, changelog_entry, or deprecation_notice, not this -- intro is a fixed series-link note at the top of an article.",
   "x-intent-phrases": [
    "I need to show a gentle reminder about the series being private.",
    "We need to add a little flair to highlight that this content is part of a collection.",
    "Can we add a subtle note that this is a draft and might change?"
   ]
  },
  "body": {
   "type": "object",
   "description": "One or more prose paragraphs",
   "properties": {
    "component": {
     "const": "body"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-chat",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "claude-code",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"},
   "x-routing-text": "One or more prose paragraphs",
   "x-intent-phrases": [
    "I need a way to display a lot of text explaining how my product works.",
    "Users need to read detailed instructions on setting up their account.",
    "I want to show article content on a blog page."
   ]
  },
  "heading": {
   "type": "object",
   "description": "H2 section title",
   "properties": {
    "component": {
     "const": "heading"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-chat",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "claude-code",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"},
   "x-routing-text": "H2 section title",
   "x-intent-phrases": [
    "I need to label this main section of the page.",
    "This part of the page needs a clear, prominent name.",
    "I want to make this a distinct, important heading."
   ]
  },
  "subheading": {
   "type": "object",
   "description": "H3 subsection title",
   "properties": {
    "component": {
     "const": "subheading"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-chat",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "claude-code",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"},
   "x-routing-text": "H3 subsection title",
   "x-intent-phrases": [
    "I need a slightly smaller, but still important, heading for a section of my page.",
    "I want to break up my content with a clear, secondary title.",
    "Can I get a heading that's less prominent than the main page title?"
   ]
  },
  "quote": {
   "type": "object",
   "description": "Pull quote or blockquote",
   "properties": {
    "component": {
     "const": "quote"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "attribution": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"},
   "x-routing-text": "Pull quote or blockquote",
   "x-intent-phrases": [
    "I need to highlight a particularly impactful sentence from an article.",
    "I want to visually separate a spoken statement from the main text.",
    "Can I make a short, important piece of text stand out more?"
   ]
  },
  "code": {
   "type": "object",
   "description": "Fenced code block",
   "properties": {
    "component": {
     "const": "code"
    },
    "language": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "content": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "claude-code",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Fenced code block",
   "x-intent-phrases": [
    "I need to show users how to use a new feature with a step-by-step example.",
    "We need to display a snippet of our API response so developers can understand the data structure.",
    "Please add a way to embed instructions for setting up a configuration file clearly."
   ]
  },
  "pipeline": {
   "type": "object",
   "description": "Inline left-to-right flow (e.g. build pipeline steps)",
   "properties": {
    "component": {
     "const": "pipeline"
    },
    "steps": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list[string]"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Inline left-to-right flow (e.g. build pipeline steps)",
   "x-intent-phrases": [
    "I need to show the steps my code goes through after I push it.",
    "How can I visualize the stages of a user's journey on our site?",
    "I want to display a sequence of actions for setting up a new feature."
   ]
  },
  "bullet_list": {
   "type": "object",
   "description": "Unordered list with optional bold lead-in per item",
   "properties": {
    "component": {
     "const": "bullet_list"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "[{'label': 'string (optional)', 'text': 'string'}]"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-chat",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"},
   "x-routing-text": "Unordered list with optional bold lead-in per item",
   "x-intent-phrases": [
    "I need to show a list of benefits with some words highlighted.",
    "Show me a list of features, and I want to emphasize the first word of each.",
    "I need to display a series of points, and some should start with a strong keyword."
   ]
  },
  "divider": {
   "type": "object",
   "description": "Visual section break",
   "properties": {
    "component": {
     "const": "divider"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"},
   "x-routing-text": "Visual section break",
   "x-intent-phrases": [
    "I need a way to visually separate different content areas on my screen.",
    "My page is getting too long, I need to break up the information into distinct groups.",
    "Can I add a subtle line to distinguish this form field from the next one?"
   ]
  },
  "youtube": {
   "type": "object",
   "description": "Responsive 16:9 embedded YouTube video",
   "properties": {
    "component": {
     "const": "youtube"
    },
    "url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "caption": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"},
   "x-routing-text": "Responsive 16:9 embedded YouTube video",
   "x-intent-phrases": [
    "I need a way to show a training video that fits nicely on any screen.",
    "Our product demo needs to play smoothly on phones and desktops.",
    "Can I embed promotional clips that look good everywhere?"
   ]
  },
  "image": {
   "type": "object",
   "description": "Single image with caption, hosted at a public URL",
   "properties": {
    "component": {
     "const": "image"
    },
    "url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "alt": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "caption": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "width": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn_with_differences", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"},
   "x-routing-text": "Single image with caption, hosted at a public URL",
   "x-intent-phrases": [
    "I need to show a picture of our new product with its name below it.",
    "We want to display a photograph from our company's event, with a brief explanation.",
    "Show me a graphic from an external website, with a title for context."
   ]
  },
  "image_pair": {
   "type": "object",
   "description": "Two images side by side with individual captions",
   "properties": {
    "component": {
     "const": "image_pair"
    },
    "left": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{'url': 'string', 'alt': 'string', 'caption': 'string (optional)'}"
    },
    "right": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{'url': 'string', 'alt': 'string', 'caption': 'string (optional)'}"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Two images side by side with individual captions",
   "x-intent-phrases": [
    "I need to show a before and after of a design.",
    "Can I display two product photos next to each other?",
    "I want to compare two versions of a graphic."
   ]
  },
  "diagram": {
   "type": "object",
   "description": "SVG architecture diagram hosted at a public URL",
   "properties": {
    "component": {
     "const": "diagram"
    },
    "url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "caption": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "SVG architecture diagram hosted at a public URL",
   "x-intent-phrases": [
    "I need to show users the intricate structure of our system.",
    "My team needs a way to visualize complex data flows.",
    "We want to present a clear, interactive blueprint of our application."
   ]
  },
  "github_repo_card": {
   "type": "object",
   "description": "GitHub repo card — fetches live star/fork/language/push data from GitHub API at render time and embeds as self-contained HTML",
   "properties": {
    "component": {
     "const": "github_repo_card"
    },
    "repo": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "description": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "GitHub repo card — fetches live star/fork/language/push data from GitHub API at render time and embeds as self-contained HTML",
   "x-intent-phrases": [
    "I want to show off projects from my team's GitHub directly on our website.",
    "Need to display popular open-source tools our customers use, with their latest activity.",
    "Showcase curated lists of interesting code repositories with their current engagement metrics."
   ]
  },
  "repo_links": {
   "type": "object",
   "description": "Formatted GitHub repo link list at end of article",
   "properties": {
    "component": {
     "const": "repo_links"
    },
    "links": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "[{'label': 'string', 'url': 'string'}]"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Formatted GitHub repo link list at end of article",
   "x-intent-phrases": [
    "I need to easily show where users can find the source code for my project.",
    "My blog post needs a clear way to link to related GitHub repositories.",
    "I want to direct readers to the official codebases mentioned in my documentation."
   ]
  },
  "closing": {
   "type": "object",
   "description": "Final paragraph + optional hashtags",
   "properties": {
    "component": {
     "const": "closing"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "tags": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list[string] (optional)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-chat",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Final paragraph + optional hashtags",
   "x-intent-phrases": [
    "I need a way to end a blog post with a concluding thought and some relevant keywords.",
    "My app needs to display the final summary of a user's action, along with tags for categorization.",
    "Please provide a component to show the end of a message, optionally with descriptive labels."
   ]
  },
  "callout": {
   "type": "object",
   "description": "Highlighted alert box — info, warning, tip, or danger",
   "properties": {
    "component": {
     "const": "callout"
    },
    "kind": {
     "description": "info | warning | tip | danger"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "claude-code",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Highlighted alert box — info, warning, tip, or danger A one-off confirmation that an action just succeeded, or a live warning that needs a response (e.g. 'saved', 'entry recorded', 'someone else is editing this'), is usually toast_notification, inline_feedback_message, inline_alert, or action_required_card instead -- callout is for a persistent note inside the page's own content, not a moment-in-time reaction to what the user just did.",
   "x-intent-phrases": [
    "I need to show users when they've successfully saved their changes.",
    "Let's warn folks if they're about to delete something important.",
    "Can we add a small note explaining a complex setting?",
    "Highlight the refund and rescheduling policy so customers see it before they pay.",
    "Draw attention to an important notice, such as a fee change or a required document, above the form."
   ]
  },
  "steps": {
   "type": "object",
   "description": "Numbered sequential steps with blue circle indicators",
   "properties": {
    "component": {
     "const": "steps"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "[{'label': 'string (optional)', 'text': 'string'}]"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "claude-code",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Numbered sequential steps with blue circle indicators",
   "x-intent-phrases": [
    "I need to guide users through a multi-stage checkout process.",
    "We're building a tutorial to onboard new users to our complex feature.",
    "Show visitors the distinct phases of our project completion."
   ]
  },
  "table": {
   "type": "object",
   "description": "HTML table with styled headers, alternating rows, horizontal scroll",
   "properties": {
    "component": {
     "const": "table"
    },
    "caption": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "headers": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list[string]"
    },
    "rows": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list[list[string]]"
    },
    "col_widths": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list[string] (optional, added 2026-07-24). One CSS width per column (e.g. [\"46%\",\"18%\",\"18%\",\"18%\"]), switches to table-layout:fixed. Without it, a long label in one column can pull free space away from short single-glyph cells in the others."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "claude-code",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "HTML table with styled headers, alternating rows, horizontal scroll",
   "x-intent-phrases": [
    "I need to show a lot of data in columns that users can scroll through horizontally.",
    "We need a way to display a list of items with clear labels for each piece of information.",
    "Can I get a clean way to present a grid of information where rows are easy to distinguish?",
    "Show a record for each booking, order or case with its date, status and owner.",
    "Give me the history of treatments, payments or visits, one row each with the date.",
    "Lay out results in columns so two or more people or items can be compared side by side.",
    "Show which items are due soon with the due date next to each.",
    "Which orders, repairs or claims are still open, and who is handling each?",
    "Set out fees, hours or scores for several people or options in rows and columns."
   ]
  },
  "tabs": {
   "type": "object",
   "description": "CSS-only tabbed panels — ideal for multi-language code examples",
   "properties": {
    "component": {
     "const": "tabs"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "tabs": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "[{'label': 'string', 'language': 'string', 'content': 'string'}]"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"},
   "x-routing-text": "CSS-only tabbed panels — ideal for multi-language code examples",
   "x-intent-phrases": [
    "I need a way to show code snippets in JavaScript, Python, and Ruby clearly on the same page without taking up too much space.",
    "My app supports multiple languages, and I want users to easily switch between viewing content in English, Spanish, and French.",
    "I have a complex setting screen with many options. I'd like to group related settings so users can find what they need faster."
   ]
  },
  "key_value": {
   "type": "object",
   "description": "Key-value table for env vars, config options, API fields",
   "properties": {
    "component": {
     "const": "key_value"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "[{'key': 'string', 'description': 'string', 'required': 'bool (optional)', 'default': 'string (optional)'}]"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Key-value table for env vars, config options, API fields",
   "x-intent-phrases": [
    "I need to display a list of settings with their current values.",
    "Show me all the environment variables and their assigned strings.",
    "I want to present API endpoint parameters and what they expect.",
    "Show the key facts about one thing, such as a policy, a vehicle or a room, as labelled values."
   ]
  },
  "before_after": {
   "type": "object",
   "description": "Side-by-side code comparison — red/green panels showing old vs new",
   "properties": {
    "component": {
     "const": "before_after"
    },
    "language": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "before": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "after": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "before_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "after_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "caption": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Side-by-side code comparison — red/green panels showing old vs new",
   "x-intent-phrases": [
    "I need to show users what changed in the latest update.",
    "Can I visualize the difference between two versions of a text file?",
    "I want to highlight code improvements side-by-side for review."
   ]
  },
  "api_reference": {
   "type": "object",
   "description": "Full API/function reference block — name, description, parameters table, return value, and example.",
   "properties": {
    "component": {
     "const": "api_reference"
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "kind": {
     "description": "function | endpoint | class | method"
    },
    "method": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "description": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "deprecated": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional)"
    },
    "parameters": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "[{'name': 'string', 'type': 'string', 'required': 'bool (optional)', 'description': 'string', 'default': 'string (optional)'}]"
    },
    "returns": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "example": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{'label': 'string (optional)', 'language': 'string', 'code': 'string'}"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Full API/function reference block — name, description, parameters table, return value, and example.",
   "x-intent-phrases": [
    "I need to show users how to use my custom code functions.",
    "Help me document all the different settings my tool offers.",
    "I want a clear way to explain each part of my data processing pipeline."
   ]
  },
  "gallery": {
   "type": "object",
   "description": "Responsive image grid with CSS-only lightbox on click",
   "properties": {
    "component": {
     "const": "gallery"
    },
    "cols": {
     "description": "2 | 3 | 4 (optional, default 3)"
    },
    "caption": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "images": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "[{'url': 'string', 'alt': 'string', 'caption': 'string (optional)'}]"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn_with_differences", "flutter": "native", "compose": "native"},
   "x-routing-text": "Responsive image grid with CSS-only lightbox on click",
   "x-intent-phrases": [
    "I need a way to show lots of photos nicely on any screen size.",
    "Users should be able to tap a picture to see it bigger without leaving the page.",
    "I want a clean layout for a collection of product images that looks good everywhere.",
    "Show a set of photos of a rental flat or hotel room that visitors can browse.",
    "A photo grid of a portfolio or product range with a larger view on click."
   ]
  },
  "video_pair": {
   "type": "object",
   "description": "Two YouTube videos side by side with optional labels",
   "properties": {
    "component": {
     "const": "video_pair"
    },
    "caption": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "left": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{'url': 'string', 'label': 'string (optional)'}"
    },
    "right": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{'url': 'string', 'label': 'string (optional)'}"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "Two YouTube videos side by side with optional labels",
   "x-intent-phrases": [
    "I need to show two different tutorials at the same time for comparison.",
    "Can I display a speaker's main video and their Q&A side-by-side?",
    "I want to put two related video clips next to each other for a quick overview."
   ]
  },
  "carousel": {
   "type": "object",
   "description": "CSS-only sliding carousel with dot indicators and prev/next arrows",
   "properties": {
    "component": {
     "const": "carousel"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "caption": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "slides": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "[{'url': 'string', 'label': 'string (optional)', 'subtitle': 'string (optional)'}]"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "CSS-only sliding carousel with dot indicators and prev/next arrows",
   "x-intent-phrases": [
    "I need a way to show a rotating set of featured images on my homepage.",
    "Can I have a slider for product photos with navigation buttons?",
    "I want to display a series of articles one after another, easily browsable."
   ]
  },
  "timeline": {
   "type": "object",
   "description": "Vertical timeline with dot connectors, date badges, tag pills",
   "properties": {
    "component": {
     "const": "timeline"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "events": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "[{'date': 'string', 'label': 'string', 'text': 'string', 'tag': 'string (optional)'}]"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Vertical timeline with dot connectors, date badges, tag pills",
   "x-intent-phrases": [
    "I need to show the steps of a project in order, with dates and labels for each.",
    "Can I display a series of events chronologically on a page, like a history?",
    "I want a visual way to track progress milestones, highlighting key points in time."
   ]
  },
  "annotated_code": {
   "type": "object",
   "description": "Code block with numbered yellow callout bubbles on specific lines, with an explanation list below.",
   "properties": {
    "component": {
     "const": "annotated_code"
    },
    "language": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "code": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "caption": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "annotations": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "[{'line': 'integer', 'text': 'string'}]"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Code block with numbered yellow callout bubbles on specific lines, with an explanation list below.",
   "x-intent-phrases": [
    "I need to highlight key code snippets in my tutorial with extra explanations.",
    "Show users exactly which lines of code are important for this feature.",
    "Can I attach specific notes to certain code examples to guide developers?"
   ]
  },
  "sortable_list": {
   "type": "object",
   "description": "Drag to reorder a list, emitting the new position as one event.\nA DATA atom, not a domain one: it renders whatever {id, label} pairs it is given and emits a position, so the same atom serves form fields, a shopping run, or any other AUTHORED ordering. There is deliberately no sortable_jobs and no sortable_fields — one named interaction per use case is the drift this vocabulary already has (onFlightClick, onAssign), and it costs a renderer change every time.\nThe reason it fits a declarative binding model at all is containment: the gesture never reaches the state engine. dragstart/dragover/drop are high-frequency and purely visual; only the DROP publishes, once, through the `onReorder` output wire as {id, order}. That is the same shape the atom renders FROM, so position is derived state rather than a second source of truth — what it emits and what it consumes are one field.\n`order` is fractional: a drop takes the midpoint of its two neighbours, so exactly one item changes. Dense re-indexing would rewrite every position on every drag, turning a one-line reviewable diff into a wall of noise, which matters wherever the result is a change someone accepts or reverts.\nUse it only where order is AUTHORED. Where order is COMPUTED — a job list ranked by severity then priority — a dragged position becomes a second, competing ordering, and the derivation boundary rule says that ranking belongs to the server.",
   "properties": {
    "component": {
     "const": "sortable_list"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required). Objects of {id, label, order?, group?, note?}. `id` is what comes back in the event, `label` is what is shown, `order` seeds the fractional position (defaults to the array index), `group` is an opaque bucket id carried back on drop, `note` is optional right-aligned secondary text."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). A small heading above the list."
    },
    "emptyMessage": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Shown instead of the list when items is empty. Default \"Nothing to reorder.\""
    }
   },
   "required": [
    "component",
    "items"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Drag to reorder a list, emitting the new position as one event. A DATA atom, not a domain one: it renders whatever {id, label} pairs it is given and emits a position, so the same atom serves form fiel",
   "x-intent-phrases": [
    "I need to let users rearrange their shopping list items easily.",
    "Users must be able to set the priority of these tasks in any order.",
    "Allow me to define the display order for these selectable options."
   ]
  },
  "photo_grid": {
   "type": "object",
   "description": "A clickable image grid: every tile is both a photo and a row.\nBuilt to close a real gap — data_table has no way to show what a row IS, only what it says about itself, so a photo-driven decision (which wallpaper, which chair) forced a text table plus a separate \"View photo\" link plus a separate select-then-tap-a-button flow before an action could fire. This atom is the shape that removes all three: the thing you look at and the thing you click are the same element.\nReuses data_table's onRowClick contract exactly — same data-row-json attribute, same _a2uiBindRowClicks binder, same array-wire form for \"select AND immediately run an action\" in one tap (shipped 2026-08-04 for onRowClick, inherited here for free rather than rebuilt). A DATA atom, not a domain one, same reasoning sortable_list gives for its own genericness: it renders whatever {id, url, ...} objects it is given and fires whatever the caller wired onRowClick to, so the same atom serves a voting board, a photo picker, or a product chooser without a second named atom per use case.\n`badge` and `active` exist because a click-driven UI still has to show its OWN state back — a starred tile that does not visibly read as starred after the tap is a button that looks like it did nothing. Both are plain strings/booleans the caller derives server-side (a star count, a \"you picked this\" flag); the atom does not compute either.",
   "properties": {
    "component": {
     "const": "photo_grid"
    },
    "images": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required). Objects of {id, url, alt?, caption?, badge?, active?}. `id` is what data-row-json carries back to onRowClick (along with every other field on the object — the WHOLE row, same contract data_table's onRowClick already has). `caption` overlays the bottom of the tile. `badge` is a short string pinned top-right (a count, a status) — omit it for no badge. `active` outlines the tile and tints its badge to mark \"this one is in a selected/chosen state\" from the caller's own point of view."
    },
    "cols": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 3). 2-4 reads best; more than 4 on a phone-width viewport crowds captions into illegibility."
    }
   },
   "required": [
    "component",
    "images"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A clickable image grid: every tile is both a photo and a row. Built to close a real gap — data_table has no way to show what a row IS, only what it says about itself, so a photo-driven decision (which",
   "x-intent-phrases": [
    "I need to see my whole product catalog visually, not just names.",
    "Show me all my customer photos at a glance to pick the right one.",
    "I want to browse through architectural designs, with each image representing a project."
   ]
  },
  "photo_stepper": {
   "type": "object",
   "description": "A full-viewport, one-photo-at-a-time lightbox with prev/next and a vote button per slide — the sibling photo_grid does not cover: reviewing options ONE AT A TIME with full attention, immersively, rather than scanning a grid. Neither replaces the other; pick per use case, or offer both. Renders closed as a compact trigger card (first photo + label); clicking it opens the full takeover.\nThe takeover itself is a pure-CSS checkbox toggle — the SAME `#checkbox:checked ~ .overlay{display:...}` pattern the `css_modal` atom already uses for its own position:fixed;inset:0 overlay, not a new mechanism. Paging within the open overlay is the SAME pure-CSS radio-input trick the existing `carousel` atom already uses (sibling :checked selectors drive the slide transform) — no JS-tracked index to go stale, and critically, nothing for a live data refresh to disturb: `carousel` never had a live-update wire to worry about, but this atom does, and the radio's own browser-owned :checked state surviving a vote untouched is what stops \"vote on photo 12, get silently bounced back to photo 1\" from ever being possible in the first place — not a bug that was fixed, a failure mode the design does not have. Same reasoning protects open/closed state: the checkbox is the browser's own state too, so a live update cannot close the overlay out from under you either.\nThat is also why this atom's live-update path (_a2uiUpdatePhotoStepper) is NOT a rebuild like photo_grid's own _a2uiUpdatePhotoGrid — it patches each slide's badge/vote-button/voter-line IN PLACE, matched by candidate id (not array position), and touches nothing else. Matching by id, specifically, because the typical consumer of this atom (a live vote board) re-sorts its candidate list by vote count on every read while voting is open — so a candidate's position in the incoming array can move the instant ANY vote lands, including the one just cast on the slide currently open; patching by position against a reordered array would silently swap a different candidate's photo/name into the slide the radio's :checked state still has open. A consequence worth knowing before using this atom: because the update path patches EXISTING slide elements rather than creating them, the caller should populate the initial `images` prop with real data at render time (server-side), not rely purely on the `rows` wire to populate an empty first paint — an update arriving before any slide exists to patch has nothing to act on.\nReuses photo_grid's click contract exactly for the vote button (same data-row-json attribute, same generalised [data-row-json] binder in A2UIState.html) — the third consumer of a mechanism built once for data_table's own onRowClick.",
   "properties": {
    "component": {
     "const": "photo_stepper"
    },
    "images": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required). Objects of {id, url, alt?, name?, price_display?, badge?, active?, starred_by_display?, source_url?}. Same shape family as photo_grid (id/url/badge/active carry the identical meaning), plus fields specific to a one-at-a-time review: `name`/`price_display` render as the slide's caption title/subtitle, `starred_by_display` is a plain pre-joined string (e.g. \"Curtis, Marianne\") shown under the caption, `source_url` (optional) renders a plain \"Open source listing\" link in the caption when present — the atom does not aggregate voter names or validate the link itself, the caller derives both server- side, same reasoning photo_grid gives for `badge` and `active` being caller-derived rather than computed by the atom."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex, default #0f766e). Vote-button and active- badge colour."
    },
    "trigger_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, default \"Browse full screen\"). Label shown on the closed trigger card, next to the photo count."
    }
   },
   "required": [
    "component",
    "images"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A full-viewport, one-photo-at-a-time lightbox with prev/next and a vote button per slide — the sibling photo_grid does not cover: reviewing options ONE AT A TIME with full attention, immersively, rath",
   "x-intent-phrases": [
    "I need a way to look at each picture on my screen, one by one, and then pick my favorite.",
    "Show me every image in full, and let me vote on each before moving to the next.",
    "I want to get lost in each photo, with easy ways to go back or forward and a button to show I like it."
   ]
  },
  "preview_frame": {
   "type": "object",
   "description": "An iframe whose `src` is driven by a wire, so picking a value elsewhere on the page re-navigates it CLIENT-SIDE — no server round trip, no paint_result, nothing else on the page repainted.\nA DATA atom, same spirit as sortable_list: it renders whatever src it is given and reacts to whatever is wired into it; it has no opinion on what the iframe shows. Meant to sit next to a picker (menu/select) and a StringTemplate primitive that turns the picked value into a URL — e.g. a \"preview this before you commit it\" panel, where committing is a SEPARATE, ordinary action.\nSame-origin only in practice: nothing here relaxes sandboxing. A cross-origin src is subject to the embedded page's own frame-ancestors / X-Frame-Options exactly as any other iframe.",
   "properties": {
    "component": {
     "const": "preview_frame"
    },
    "src": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Initial iframe URL. Empty renders the placeholder instead of an iframe. Normally left empty and driven entirely by `wire.src`."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). A small heading above the frame."
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Frame height in px. Default 320."
    },
    "emptyMessage": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Shown in the placeholder before a src exists. Default \"Nothing selected yet.\""
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "An iframe whose `src` is driven by a wire, so picking a value elsewhere on the page re-navigates it CLIENT-SIDE — no server round trip, no paint_result, nothing else on the page repainted. A DATA atom",
   "x-intent-phrases": [
    "I need to see how different product configurations look instantly.",
    "Show me live previews of my code changes without reloading the page.",
    "Let me switch between different versions of a document and see them immediately."
   ]
  },
  "actual_vs_estimate": {
   "type": "object",
   "description": "A quantity carrying BOTH what is known and what is projected, each labelled, neither omittable. A data atom rather than a domain one: cost is only the first instance. The same shape holds for effort (hours worked vs hours estimated), for work items (closed vs open) and for anything else an app tracks with an actual alongside a forecast — which is most things worth tracking.\nExists because that distinction is where composed answers go wrong. Asked \"what has this cost\", a model resolves the ambiguity by guessing, and on 2026-08-14 presented a EUR300 estimate for unstarted work under the heading \"COST\". Selection prose can ask it not to; a required-field shape makes it unrepresentable. Both figures are mandatory for exactly that reason.\nThe contract runs in two directions, which is the point. Upward it constrains what a UI can say. Downward it tells the data layer what it must be able to produce: an app that cannot separate incurred from projected cannot fill this atom, and discovering that is the useful part.",
   "properties": {
    "component": {
     "const": "actual_vs_estimate"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). What the quantity IS — \"Cost\", \"Effort\", \"Jobs\"."
    },
    "actual": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (required). The known value, UNFORMATTED. Money spent, hours worked, items closed."
    },
    "estimate": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (required). The projected value. Never fold this into `actual`; that is the error the atom exists to prevent."
    },
    "unit": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Prefixed if it is a currency symbol (\"EUR\", \"$\"), suffixed otherwise (\" hours\", \" jobs\"). The renderer formats; the author supplies numbers."
    },
    "show_total": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional, default true). The renderer DERIVES actual + estimate — the author never supplies it. A one-payload, one-render arithmetic belongs to the renderer under the derivation boundary rule, and an author who supplies a sum can supply a wrong one. Set false where adding the two is nonsense."
    },
    "actual_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Overrides \"Actual\", e.g. \"Spent so far\"."
    },
    "estimate_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Overrides \"Estimated\", e.g. \"Still to come\"."
    },
    "total_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Overrides \"Committed\"."
    },
    "caption": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). One honest sentence, e.g. \"Nothing has been spent yet; EUR340 of work is planned.\""
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Hex colour for the total."
    }
   },
   "required": [
    "component",
    "label",
    "actual",
    "estimate"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A quantity carrying BOTH what is known and what is projected, each labelled, neither omittable. A data atom rather than a domain one: cost is only the first instance. The same shape holds for effort (",
   "x-intent-phrases": [
    "I need to show the planned spending alongside the actual amount spent so far.",
    "Can I display the target completion time and the current projected finish date together?",
    "I want to see both the budgeted hours and the hours already logged for a task."
   ]
  },
  "stat_card": {
   "type": "object",
   "description": "Glowing neon stat card — large value with label and optional delta",
   "properties": {
    "component": {
     "const": "stat_card"
    },
    "value": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "delta": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "is_up": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Glowing neon stat card — large value with label and optional delta",
   "x-intent-phrases": [
    "I need to show a big number that stands out, with what it means and if it's going up or down.",
    "Can I get a stylish way to display key metrics that grabs attention, like a highlight?",
    "Show me a prominent display for a number that also tells me how it changed recently.",
    "How many appointments, tickets or open cases are there right now?",
    "What has the project cost so far?",
    "Show the one number people ask about most, such as total spend or bookings today."
   ]
  },
  "progress_bar": {
   "type": "object",
   "description": "Progress bar with an animated width transition, an optional percentage and an optional caption",
   "properties": {
    "component": {
     "const": "progress_bar"
    },
    "value": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (0-100)"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "show_percent": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional)"
    },
    "caption": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "claude-code",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Horizontal bar showing how much of a task, list or goal is complete, as a filled share of the total (for example 6 of 10 done). Animated fill, optional percentage and caption.",
   "x-intent-phrases": [
    "I need to show users how long their file upload is taking.",
    "Can I get something that visually indicates how much of a process is complete?",
    "I want to give feedback on the loading status of a long operation.",
    "Show how far through a course or a checklist someone is, such as 5 of 12 done."
   ]
  },
  "badge_group": {
   "type": "object",
   "description": "Group of coloured status badges with optional pulse animation — green/cyan/blue/yellow/red/purple/grey",
   "properties": {
    "component": {
     "const": "badge_group"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "badges": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "[{'text': 'string', 'color': 'green|cyan|blue|yellow|red|purple|grey', 'pulse': 'bool (optional)'}]"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Group of coloured status badges with optional pulse animation — green/cyan/blue/yellow/red/purple/grey",
   "x-intent-phrases": [
    "I need to show multiple status indicators for different items, each with a distinct color.",
    "Can I have small, colored dots that flash subtly to draw attention to important updates?",
    "I'm looking for a way to visually categorize items using simple, colored tags."
   ]
  },
  "sparkline": {
   "type": "object",
   "description": "Renders a small, simple line chart without axes or coordinates, showing",
   "properties": {
    "component": {
     "const": "sparkline"
    },
    "data": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of numbers (e.g., [10, 12, 8, 15, 13])"
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (hex or named color, e.g., '#4CAF50' or 'green')"
    },
    "line_width": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (e.g., 2)"
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (CSS height value, e.g., '20px')"
    },
    "width": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (CSS width value, e.g., '80px')"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a small, simple line chart without axes or coordinates, showing",
   "x-intent-phrases": [
    "Show me how this metric changed over the last week on a tiny graph.",
    "I need a quick visual of recent performance trends in this list.",
    "Display a mini-chart next to each item to see its value progression."
   ]
  },
  "heatmap": {
   "type": "object",
   "description": "Renders a graphical representation of data where individual values",
   "properties": {
    "component": {
     "const": "heatmap"
    },
    "data": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of lists of numbers (e.g., [[1, 2, 3], [4, 5, 6]])"
    },
    "labels_x": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of strings (labels for the x-axis, e.g., ['Mon', 'Tue', 'Wed'])"
    },
    "labels_y": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of strings (labels for the y-axis, e.g., ['AM', 'PM'])"
    },
    "color_scale": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of strings (colors for the gradient, e.g., ['#FFFFFF', '#FF0000'] for white to red)"
    },
    "unit": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, unit for the data values, e.g., '°C')"
    },
    "z_min": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, value drawn with the first colour of the scale; default the smallest value)"
    },
    "z_max": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, value drawn with the last colour; default the largest value)"
    },
    "z_mid": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, value drawn with the middle of the scale, for diverging data; the colour range becomes symmetric around it; ignored when z_min and z_max are both given)"
    },
    "scale": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, a Plotly colour scale name - Viridis, Cividis, Blues, Greens, Reds, Greys, YlGnBu, YlOrRd, RdBu, Bluered, Picnic, Rainbow, Portland, Jet, Hot, Blackbody, Earth or Electric; default Viridis, or color_scale when that is given)"
    },
    "show_colorbar": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional, default true, draws the colour bar with the lowest and highest value)"
    },
    "show_values": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional, default false, prints each value inside its cell)"
    },
    "value_format": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, how values print - an optional comma for thousands, optional .N decimals, then f, % or d; for example ',.1f' or '.0%')"
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1; a higher number draws as version 1 with a muted note)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a graphical representation of data where individual values",
   "x-intent-phrases": [
    "I need to see which parts of my website users interact with most.",
    "Show me where my sales are strongest by region and product.",
    "I want a visual way to spot trends in daily customer activity over a month."
   ]
  },
  "punch_card": {
   "type": "object",
   "description": "Renders a Day-of-Week vs. Hour-of-Day bubble grid (punch card) of repository or commit activity, where bubble size is proportional to activity.",
   "properties": {
    "component": {
     "const": "punch_card"
    },
    "data": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of lists of numbers (7 rows representing days of week, each containing 24 numbers representing commit frequency for each hour)"
    },
    "labels_days": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of strings (optional, e.g., ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'])"
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex or named color for active bubbles, e.g., '#00f2ff')"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, title of the repository or chart, e.g., 'Commit Activity')"
    },
    "subtitle": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, subtitle, e.g., 'curtiskrygier/meetstudio')"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a Day-of-Week vs. Hour-of-Day bubble grid (punch card) of repository or commit activity, where bubble size is proportional to activity.",
   "x-intent-phrases": [
    "Show me when users are most active throughout the week.",
    "I need to visualize peak usage times for my service.",
    "How can I see the busiest days and hours for our team's work?"
   ]
  },
  "sankey_flow": {
   "type": "object",
   "description": "Renders a flow diagram (Sankey flow) where nodes sit in columns from left to right and are connected by curved gradient Bezier bands whose width is the flow value. Two or more columns; columns come from each node's optional `column` hint, or from graph distance when it is absent. Layout is d3-sankey's.",
   "properties": {
    "component": {
     "const": "sankey_flow"
    },
    "nodes": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of dictionaries (e.g., [{'id': 'revenue', 'label': 'Revenue', 'column': 0, 'color': '#10b981'}, ...]); `column` is an optional hint, an integer 0..n for the left-to-right column (0 = leftmost, up to 15); without it the column is the node's distance from the sources (a node with no outgoing flow goes to the last column), so a source -> middle -> target chain gets three columns and the chart is wider by 220px per column beyond two. Flows that close a cycle, or would run backwards between columns, are not drawn and are listed in a note under the chart."
    },
    "links": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of dictionaries representing flows (e.g., [{'source': 'revenue', 'target': 'marketing', 'value': 25000, 'color': '#38bdf8'}, ...])"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, title of the chart, e.g., 'Financial Flow Allocation')"
    },
    "keyed": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional, default false). True adds the build contract to the drawing so motion_build and motion_transition can move its parts: each node rectangle carries data-cb \"node\" and each node name data-cb \"label\", both with data-key = the node id, and each flow carries data-cb \"link\" with data-key = \"sourceId>targetId\" (a repeated pair gets \"#2\", \"#3\"). Use ids that another atom also keys (ISO 3166-1 alpha-3 codes against choropleth_map tiles) and a motion_transition joins the two element by element. Absent or false: the markup is unchanged, byte for byte."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a flow diagram (Sankey flow) where nodes sit in columns from left to right and are connected by curved gradient Bezier bands whose width is the flow value.",
   "x-intent-phrases": [
    "I need to visualize where our users are coming from and where they go next on our website.",
    "Show me how money moves between different departments in our company's budget.",
    "Can I see the paths of raw materials through our manufacturing process?"
   ]
  },
  "cohort_retention": {
   "type": "object",
   "description": "Renders a SaaS subscription or customer cohort retention triangular matrix with color-coded continuous gradients.",
   "properties": {
    "component": {
     "const": "cohort_retention"
    },
    "cohorts": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of dictionaries representing cohorts (e.g., [{'cohort_name': 'Jan 2026', 'original_size': 2500, 'retention_rates': [100.0, 93.4]}])"
    },
    "periods": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of strings representing period headers (e.g., ['Month 0', 'Month 1'])"
    },
    "color_scale": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of strings representing the continuous color scale (e.g., ['#1e293b', '#10b981'])"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, chart title, e.g., 'SaaS Retention Cohorts')"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a SaaS subscription or customer cohort retention triangular matrix with color-coded continuous gradients.",
   "x-intent-phrases": [
    "I need to see how many users who signed up last month are still active, and how that changes each week.",
    "Show me how customers acquired in different months are sticking around over time.",
    "I want a visual to track the loyalty of different signup groups month after month."
   ]
  },
  "donut_stat": {
   "type": "object",
   "description": "Renders a single key metric with a surrounding donut chart indicating",
   "properties": {
    "component": {
     "const": "donut_stat"
    },
    "value": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (the current value, e.g., 75)"
    },
    "max_value": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (the maximum possible value, e.g., 100)"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (descriptive label for the metric, e.g., 'Completion')"
    },
    "unit": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, unit for the value, e.g., '%')"
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (hex or named color for the donut segment, e.g., '#2196F3')"
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (CSS size value, e.g., '100px')"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a single key metric with a surrounding donut chart indicating",
   "x-intent-phrases": [
    "I need to show how much of our monthly budget is spent on marketing.",
    "How can I display progress towards our sales goal at a glance?",
    "Show me the current server load percentage with a visual indicator."
   ]
  },
  "metric_delta": {
   "type": "object",
   "description": "Renders a key performance indicator with its current value and a numerical",
   "properties": {
    "component": {
     "const": "metric_delta"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (descriptive label for the metric, e.g., 'Sales')"
    },
    "current_value": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (the current formatted value, e.g., '$12,345')"
    },
    "delta_value": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (the formatted change value, e.g., '+$1,234' or '+10%')"
    },
    "delta_type": {
     "description": "enum (increase, decrease, no_change) - determines icon/color",
     "type": "string"
    },
    "unit": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, unit for the current value, e.g., 'USD')"
    },
    "previous_period_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, e.g., 'vs. last month')"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-chat",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a key performance indicator with its current value and a numerical",
   "x-intent-phrases": [
    "Show me how many new sign-ups we got today compared to yesterday.",
    "I need to see the percentage change in sales revenue from last week.",
    "Display the current number of active users and how it's trending."
   ]
  },
  "task_list": {
   "type": "object",
   "description": "Renders a premium, glassmorphic checklist and action item tracker with status checkboxes, priorities, assignees, and due dates.",
   "properties": {
    "component": {
     "const": "task_list"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, e.g., 'Google Tasks & Action Items')"
    },
    "tasks": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of dictionaries representing tasks, where each dictionary contains: {'id': string, 'text': string, 'completed': boolean, 'priority': string (high|medium|low), 'due_date': string (optional), 'assignee': string (optional, initials e.g. 'CK')}"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a premium, glassmorphic checklist and action item tracker with status checkboxes, priorities, assignees, and due dates.",
   "x-intent-phrases": [
    "I need a way to see all my project tasks and mark them done.",
    "Help me track what's urgent, who's doing what, and when it's due.",
    "Show me my to-do list with cool visual flair and quick updates.",
    "Show what still needs doing for each person, room or shift, with a way to tick things off.",
    "What is still outstanding for a room, a shift or a person?",
    "Show the work left to do, narrowed to one kind of task."
   ]
  },
  "sentiment_summary": {
   "type": "object",
   "description": "Renders an emotional summary and sentiment tracker for a call or meeting, showing positive/negative/neutral mix, sentiment index progress arc, and emotional journey area timeline.",
   "properties": {
    "component": {
     "const": "sentiment_summary"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, e.g., 'Call Sentiment & Mood Analysis')"
    },
    "sentiment_index": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number representing overall positive sentiment percentage (0-100, e.g., 78)"
    },
    "emotional_journey": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of numbers representing call sentiment score over time intervals (values -1.0 to 1.0, e.g., [0.1, -0.2, 0.4, 0.8, 0.6])"
    },
    "themes": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of dictionaries representing key themes with weights or moods: [{'theme': 'Technical Alignment', 'mood': 'Analytical', 'score': 85}, ...]"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders an emotional summary and sentiment tracker for a call or meeting, showing positive/negative/neutral mix, sentiment index progress arc, and emotional journey area timeline.",
   "x-intent-phrases": [
    "Show me how happy or upset people were during our customer calls.",
    "I need to visualize the overall mood trend of our team meetings.",
    "Display a quick overview of the emotional tone of each client interaction."
   ]
  },
  "trend_indicator": {
   "type": "object",
   "description": "Renders a simple visual indicator (e.g., arrow, icon) representing",
   "properties": {
    "component": {
     "const": "trend_indicator"
    },
    "trend_direction": {
     "description": "enum (up, down, stable) - determines the icon or arrow direction",
     "type": "string"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (descriptive text for the trend, e.g., 'Improving', 'Declining', 'Steady')"
    },
    "context": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, additional context, e.g., 'over last 30 days')"
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex or named color for the indicator, e.g., 'green' for 'up', 'red' for 'down')"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-chat",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a simple visual indicator (e.g., arrow, icon) representing",
   "x-intent-phrases": [
    "I need to show if a number is going up or down.",
    "How can I quickly signal if a metric is improving or declining?",
    "I want a little icon to tell users if something is trending positively or negatively."
   ]
  },
  "breadcrumb": {
   "type": "object",
   "description": "A navigation aid indicating the user's current location within a hierarchical",
   "properties": {
    "component": {
     "const": "breadcrumb"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of {label: string, url: string, is_current: boolean}"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A navigation aid indicating the user's current location within a hierarchical",
   "x-intent-phrases": [
    "I need to show users where they are in my multi-step process.",
    "Help me guide people through nested sections of my website.",
    "I want to make it obvious how to get back to previous pages."
   ]
  },
  "pagination": {
   "type": "object",
   "description": "A control for navigating through a series of pages or results.",
   "properties": {
    "component": {
     "const": "pagination"
    },
    "current_page": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer"
    },
    "total_pages": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer"
    },
    "base_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (the URL prefix for all page links)"
    },
    "page_param": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (e.g., 'page', the query parameter name for the page number)"
    },
    "current": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer. The currently active page number. Defaults to 1."
    },
    "total": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer. Total number of pages in the pagination control. Defaults to 1."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A control for navigating through a series of pages or results.",
   "x-intent-phrases": [
    "I need a way to see more items without filling up the screen.",
    "Show me how to jump between different groups of search results.",
    "Users need to easily flip through many product listings."
   ]
  },
  "stepper": {
   "type": "object",
   "description": "Vertical step sequence where completed steps show an animated SVG checkmark draw, the active step pulses with a sonar-style glow ring, and pending steps are muted. State is driven by active_index — a single integer the agent increments as each step completes. No JavaScript required.",
   "properties": {
    "component": {
     "const": "stepper"
    },
    "steps": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of strings or {label, description} objects. Each step in the sequence."
    },
    "active_index": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 0). Index of the currently executing step. Steps before it are completed; steps after are pending."
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Accent colour for completed/active states. Default \"#38bdf8\"."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Heading above the step list."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-side-panel",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Vertical step sequence where completed steps show an animated SVG checkmark draw, the active step pulses with a sonar-style glow ring, and pending steps are muted. State is driven by active_index — a",
   "x-intent-phrases": [
    "I need a clear visual guide for users going through a multi-step process like signing up.",
    "Show me which part of a form I'm currently filling out and make it stand out.",
    "Let me easily see which tasks are done, which one I'm on, and what's coming next."
   ]
  },
  "tab_bar": {
   "type": "object",
   "description": "A horizontal navigation component displaying a set of clickable tabs.",
   "properties": {
    "component": {
     "const": "tab_bar"
    },
    "tabs": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of {label: string, url: string, is_active: boolean, icon: string (optional, e.g., 'home')}"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A horizontal navigation component displaying a set of clickable tabs.",
   "x-intent-phrases": [
    "I need a way to switch between different sections of my settings page easily.",
    "Users should be able to jump between product categories on the shop page.",
    "Let people quickly go between their profile and their messages."
   ]
  },
  "anchor_list": {
   "type": "object",
   "description": "A list of links that navigate to specific sections within the current",
   "properties": {
    "component": {
     "const": "anchor_list"
    },
    "anchors": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of {label: string, url: string, target_id: string (optional, for in-document navigation on web/pdf)}"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of objects. Links shown as a list, each a string or an object with text or label, and url (default '#')."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A list of links that navigate to specific sections within the current",
   "x-intent-phrases": [
    "I need a way for users to quickly jump to different parts of a long article.",
    "My help documentation is extensive; I want an easy way to create a table of contents.",
    "Users need to navigate between various topics on my settings page without endless scrolling."
   ]
  },
  "faq_accordion": {
   "type": "object",
   "description": "Renders a list of questions and answers, where answers are hidden until",
   "properties": {
    "component": {
     "const": "faq_accordion"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of objects, each with 'question' (string) and 'answer' (string)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a list of questions and answers, where answers are hidden until",
   "x-intent-phrases": [
    "I need a way to display a lot of common questions and their explanations clearly, without overwhelming the user.",
    "Show me how to make a section where users can click to reveal more details about a topic.",
    "Help me build a dynamic list where each item expands to show more information when clicked."
   ]
  },
  "glossary_term": {
   "type": "object",
   "description": "Renders a term with its definition, often with an optional link for more details.",
   "properties": {
    "component": {
     "const": "glossary_term"
    },
    "term": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (the term itself)"
    },
    "definition": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (the explanation)"
    },
    "link_text": {
     "description": "optional string (e.g., \"Learn more\")"
    },
    "link_url": {
     "description": "optional string (URL for more details)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-chat",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a term with its definition, often with an optional link for more details.",
   "x-intent-phrases": [
    "I need to show users what a specific word means right on the page.",
    "Can I display a technical term and its explanation where it's used?",
    "We need a way to give more info about a keyword, maybe with a 'learn more' button."
   ]
  },
  "footnote": {
   "type": "object",
   "description": "Renders a numbered footnote reference and its corresponding text, typically",
   "properties": {
    "component": {
     "const": "footnote"
    },
    "number": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (the footnote number)"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (the footnote content)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-chat",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a numbered footnote reference and its corresponding text, typically",
   "x-intent-phrases": [
    "I need to show extra details for a specific point without interrupting the main flow.",
    "Users should be able to see supporting information by clicking on a small indicator.",
    "Can I add supplemental explanations that appear when a user hovers over a term?"
   ]
  },
  "blockquote_with_avatar": {
   "type": "object",
   "description": "Renders a blockquote with an associated avatar and attribution.",
   "properties": {
    "component": {
     "const": "blockquote_with_avatar"
    },
    "quote": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (the quoted text)"
    },
    "author_name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (name of the person quoted)"
    },
    "author_title": {
     "description": "optional string (title or role of the person)"
    },
    "avatar_url": {
     "description": "optional string (URL to the author's avatar image)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a blockquote with an associated avatar and attribution.",
   "x-intent-phrases": [
    "I need to show a customer testimonial with their profile picture and name.",
    "Displaying a quote from an expert with their photo and title is essential.",
    "We want to highlight a featured review, including the reviewer's image and company."
   ]
  },
  "pull_stat": {
   "type": "object",
   "description": "Renders a prominent, large statistic or number, often with a brief",
   "properties": {
    "component": {
     "const": "pull_stat"
    },
    "value": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (the prominent number/statistic, e.g., \"99%\", \"1.2M\")"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (descriptive text for the stat, e.g., \"customer satisfaction\")"
    },
    "unit": {
     "description": "optional string (e.g., \"%\", \"users\", \"USD\")"
    },
    "color": {
     "description": "optional string (hex code or named color for the value)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-chat",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a prominent, large statistic or number, often with a brief",
   "x-intent-phrases": [
    "Show me the total number of sales today.",
    "I need to see the current user count in big numbers.",
    "Display the most recent download count prominently."
   ]
  },
  "accordion_item": {
   "type": "object",
   "description": "Renders a single section of content that can be expanded or collapsed",
   "properties": {
    "component": {
     "const": "accordion_item"
    },
    "header": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string The title or label for the collapsible section."
    },
    "content": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string The main content to be shown or hidden."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a single section of content that can be expanded or collapsed",
   "x-intent-phrases": [
    "I need a way to show a lot of FAQs without overwhelming the user upfront.",
    "My product settings page has many options that can be grouped. I want to hide most of them by default.",
    "I want to display different, collapsible sections of information on a help page."
   ]
  },
  "tooltip": {
   "type": "object",
   "description": "Renders a small, informational popup that appears when a user hovers",
   "properties": {
    "component": {
     "const": "tooltip"
    },
    "trigger_text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string The text or element that, when hovered, reveals the tooltip."
    },
    "tooltip_content": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string The content displayed within the tooltip."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a small, informational popup that appears when a user hovers",
   "x-intent-phrases": [
    "I need a little bubble to explain what this button does when people point at it.",
    "Can I add a quick hint to help users understand this tricky setting?",
    "I want a small message to pop up when someone rests their cursor on this icon."
   ]
  },
  "hover_card": {
   "type": "object",
   "description": "Renders a rich content card that appears when a user hovers over a specified trigger element.",
   "properties": {
    "component": {
     "const": "hover_card"
    },
    "trigger_element": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string The text or element that, when hovered, reveals the card."
    },
    "card_title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string The title of the hover card."
    },
    "card_content": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string The main content of the hover card, can include rich text or simple HTML."
    },
    "card_image_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string, optional An optional image to display within the card."
    },
    "content": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Card body content rendered as inline Markdown inside the hover popup."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a rich content card that appears when a user hovers over a specified trigger element. A phrase like 'show a customer's account details and order history' as a persistent, always-visible panel usually means user_profile_card, order_status_card, or key_value, not this -- hover_card only appears on mouse hover. If the request does not explicitly say the content should appear ONLY on mouseover, it is NOT this -- a persistently visible summary belongs on user_profile_card, order_status_card, key_value, or entity_list instead.",
   "x-intent-phrases": [
    "I need to show product details without taking up screen space until someone is interested.",
    "Users should see extra info about a contact when they point at their name.",
    "I want to preview an article's summary when hovering over its title in a list."
   ]
  },
  "collapsible_panel": {
   "type": "object",
   "description": "Renders a standalone section of content that can be toggled between",
   "properties": {
    "component": {
     "const": "collapsible_panel"
    },
    "toggle_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string The text for the control that expands/collapses the content."
    },
    "initial_state": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string, default \"collapsed\" The initial state of the panel (\"expanded\" or \"collapsed\")."
    },
    "content": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string The main content to be shown or hidden."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Text of the clickable summary line; used when label is not given."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a standalone section of content that can be toggled between",
   "x-intent-phrases": [
    "I need a way to show and hide detailed settings without overwhelming the user.",
    "Let's put a block of extra information that people can reveal if they're interested.",
    "We need a way to keep a long list of FAQs tidy and expandable."
   ]
  },
  "css_modal": {
   "type": "object",
   "description": "Renders a modal dialog that appears on click and can be dismissed, controlled purely by CSS without JavaScript.",
   "properties": {
    "component": {
     "const": "css_modal"
    },
    "trigger_text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string The text or element that, when clicked, opens the modal."
    },
    "modal_title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string The title displayed at the top of the modal."
    },
    "modal_body": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string The main content of the modal dialog."
    },
    "close_button_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string, default \"Close\" The label for the button to close the modal."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a modal dialog that appears on click and can be dismissed, controlled purely by CSS without JavaScript.",
   "x-intent-phrases": [
    "I need to show a pop-up message to confirm deleting something.",
    "Users need to enter extra details in a separate box without leaving the page.",
    "I want to display a quick tutorial that disappears when they're done."
   ]
  },
  "audio_player": {
   "type": "object",
   "description": "Renders an embedded audio player for a given URL.",
   "properties": {
    "component": {
     "const": "audio_player"
    },
    "audio_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "autoplay": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean"
    },
    "loop": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"},
   "x-routing-text": "Renders an embedded audio player for a given URL.",
   "x-intent-phrases": [
    "I need to play a podcast episode directly in my app.",
    "Show a sound clip from a user's profile.",
    "Let users listen to background music while browsing."
   ]
  },
  "audio_link": {
   "type": "object",
   "description": "Renders a clickable link to an audio file, often with an audio icon.",
   "properties": {
    "component": {
     "const": "audio_link"
    },
    "audio_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "icon_type": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-chat",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a clickable link to an audio file, often with an audio icon.",
   "x-intent-phrases": [
    "I need a button to play sound effects from my app.",
    "Show me how to embed audio clips that users can click to hear.",
    "I want to add a way for users to listen to voice messages."
   ]
  },
  "pdf_preview": {
   "type": "object",
   "description": "Renders an image thumbnail of a PDF document with a link to the full",
   "properties": {
    "component": {
     "const": "pdf_preview"
    },
    "pdf_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "thumbnail_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "alt_text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders an image thumbnail of a PDF document with a link to the full",
   "x-intent-phrases": [
    "I need to show a small picture of a document so people can quickly see what it is before clicking.",
    "Users should be able to see a preview of a file, like a report, without opening it fully.",
    "Displaying a thumbnail of a page from a document would be helpful for easy identification."
   ]
  },
  "document_link": {
   "type": "object",
   "description": "Renders a clickable link to a document (e.g., PDF, DOCX), often with a document icon.",
   "properties": {
    "component": {
     "const": "document_link"
    },
    "document_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "icon_type": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-chat",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a clickable link to a document (e.g., PDF, DOCX), often with a document icon.",
   "x-intent-phrases": [
    "I need a way for users to download our terms and conditions.",
    "Show them how to get the user manual for the product.",
    "Let them open the latest company policy document from here."
   ]
  },
  "video_thumbnail": {
   "type": "object",
   "description": "Renders a static image thumbnail for a video, with a play icon overlay",
   "properties": {
    "component": {
     "const": "video_thumbnail"
    },
    "video_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "thumbnail_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "alt_text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a static image thumbnail for a video, with a play icon overlay",
   "x-intent-phrases": [
    "I need to show a preview of a video before someone clicks to watch it.",
    "I want a small picture for each video in my gallery that hints it's playable.",
    "How can I display a clickable image that makes it obvious it starts a video?"
   ]
  },
  "video_card": {
   "type": "object",
   "description": "Renders a card with a video thumbnail, title, and description, linking",
   "properties": {
    "component": {
     "const": "video_card"
    },
    "video_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "thumbnail_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "description": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "alt_text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"},
   "x-routing-text": "Renders a card with a video thumbnail, title, and description, linking",
   "x-intent-phrases": [
    "Show me a preview of interesting clips I can watch.",
    "I need to display a featured video with its main points.",
    "Let me see a collection of short films with summaries."
   ]
  },
  "code_diff": {
   "type": "object",
   "description": "Unified diff view computed server-side via Python difflib. Added lines have a green left border and fade-in background; removed lines have red. Unchanged context lines are neutral. Optional line numbers, language badge, and title. No JavaScript required — diff is computed at render time, not in the browser.",
   "properties": {
    "component": {
     "const": "code_diff"
    },
    "old_code": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The original text (before state)."
    },
    "new_code": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The updated text (after state)."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Title shown in the header bar."
    },
    "language": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Language badge shown in header, e.g. \"python\", \"typescript\"."
    },
    "show_line_numbers": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Show line numbers. Default true."
    },
    "context_lines": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Unchanged lines shown around each change. Default 3."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-side-panel",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Unified diff view computed server-side via Python difflib. Added lines have a green left border and fade-in background; removed lines have red. Unchanged context lines are neutral. Optional line numbe",
   "x-intent-phrases": [
    "I need to see exactly what changed between two versions of my configuration file.",
    "Show me the differences between the current and previous code deployments.",
    "How can I highlight the modifications made to this important document?"
   ]
  },
  "code_snippet_pair": {
   "type": "object",
   "description": "Renders two distinct code snippets side-by-side or stacked, without",
   "properties": {
    "component": {
     "const": "code_snippet_pair"
    },
    "left_code": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "right_code": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "language": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "left_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "right_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "snippets": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of objects. Tabbed code snippet definitions with code, language, and optional tab label."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders two distinct code snippets side-by-side or stacked, without",
   "x-intent-phrases": [
    "I need to show a user the old way and the new way to do something in code.",
    "Let's display example input and the resulting output code next to each other.",
    "I want to compare two different code solutions for the same problem."
   ]
  },
  "framed_screenshot": {
   "type": "object",
   "description": "Renders an image within a decorative frame, simulating a device (e.g., browser, phone).",
   "properties": {
    "component": {
     "const": "framed_screenshot"
    },
    "image_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "alt_text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "device_type": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "caption": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders an image within a decorative frame, simulating a device (e.g., browser, phone).",
   "x-intent-phrases": [
    "I need to show users how our new app feature looks on a phone screen.",
    "Can we display product mockups as if they're on a computer monitor?",
    "I want to showcase app designs within realistic device mockups for a presentation."
   ]
  },
  "image_with_caption": {
   "type": "object",
   "description": "Renders a single image with a descriptive caption below it.",
   "properties": {
    "component": {
     "const": "image_with_caption"
    },
    "image_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "alt_text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "caption": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "link_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-chat",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a single image with a descriptive caption below it.",
   "x-intent-phrases": [
    "I need to show a product photo with its name underneath.",
    "Can I display a diagram and explain what it shows?",
    "I want to feature a photograph with a brief description."
   ]
  },
  "alert_banner": {
   "type": "object",
   "description": "A prominent banner displaying a message, often with an icon and an optional action.",
   "properties": {
    "component": {
     "const": "alert_banner"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The banner message. NOT `message` — every renderer reads `text`, so a banner built with `message` renders empty apart from its icon."
    },
    "variant": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Severity — \"info\", \"success\", \"warning\" or \"critical\". \"error\" is accepted as a synonym for \"critical\": inline_alert knows the first word and this atom the second, and each used to fall back silently to \"info\" on the other. NOT `type`, which is the block discriminator."
    },
    "icon": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string Optional icon name to display next to the message."
    },
    "action_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string Optional text for an action button."
    },
    "action_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string Optional URL for the action button."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A prominent banner displaying a message, often with an icon and an optional action.",
   "x-intent-phrases": [
    "I need a way to tell users their login session expired and they need to re-enter their password.",
    "We need to show a big, unmissable message that the service will be down for maintenance soon.",
    "My users need to see a clear warning that they're about to delete important data."
   ]
  },
  "toast_notification": {
   "type": "object",
   "description": "A fixed-position slide-in notification toast that appears from a corner of the viewport, holds for 3.5 seconds, then slides back out — all via CSS keyframes. Renders a viewport placeholder in the article flow with the toast positioned fixed above it.",
   "properties": {
    "component": {
     "const": "toast_notification"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Bold notification title. Default \"Changes saved\"."
    },
    "message": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Body text. Default \"Your updates have been applied successfully.\""
    },
    "variant": {
     "description": "\"success\" | \"error\" | \"info\" | \"warning\"  (optional, default \"success\")"
    },
    "position": {
     "description": "\"bottom-right\" | \"bottom-left\" | \"top-right\" | \"top-left\"  (optional, default \"bottom-right\")"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-side-panel",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A fixed-position slide-in notification toast that appears from a corner of the viewport, holds for 3.5 seconds, then slides back out — all via CSS keyframes. Renders a viewport placeholder in the arti",
   "x-intent-phrases": [
    "I need to tell users their message was sent successfully.",
    "Let me show a quick confirmation when a setting is saved.",
    "I need to alert users about a new important update available."
   ]
  },
  "loading_skeleton": {
   "type": "object",
   "description": "A placeholder UI that shows the structure of content while it's loading, indicating active data fetching.",
   "properties": {
    "component": {
     "const": "loading_skeleton"
    },
    "shape": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string The general shape of the content being loaded (e.g., \"card\", \"list\", \"text_block\")."
    },
    "lines": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer The number of lines of text to simulate in the skeleton."
    },
    "has_image": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean Indicates if the skeleton should include an image placeholder."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "native", "compose": "native"},
   "x-routing-text": "A placeholder UI that shows the grey outline of content while it's loading.",
   "x-intent-phrases": [
    "Show something while the page data is fetching.",
    "I need a temporary layout before the actual content appears.",
    "Can we display a placeholder while images are being downloaded?"
   ]
  },
  "empty_state": {
   "type": "object",
   "description": "A UI pattern displayed when there is no data to show, often with an image, message, and an optional call to action.",
   "properties": {
    "component": {
     "const": "empty_state"
    },
    "image_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string Optional URL for an illustrative image."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string The main title for the empty state."
    },
    "description": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string A descriptive message explaining why the state is empty."
    },
    "action_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string Optional text for a call to action button."
    },
    "action_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string Optional URL for the call to action button."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A UI pattern displayed when there is no data to show, often with an image, message, and an optional call to action.",
   "x-intent-phrases": [
    "I need a friendly message for when users haven't saved anything yet.",
    "Show something nice when there are no items in their shopping cart.",
    "What appears when a list is completely empty?"
   ]
  },
  "spinner": {
   "type": "object",
   "description": "A simple rotating animation indicating that content is loading or an operation is in progress.",
   "properties": {
    "component": {
     "const": "spinner"
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string The size of the spinner (e.g., \"small\", \"medium\", \"large\")."
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string The color of the spinner (e.g., \"primary\", \"gray\")."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A simple rotating loading animation shown while content loads or a request is being processed.",
   "x-intent-phrases": [
    "I need to show something is happening while the data loads.",
    "Let people know the app is thinking before showing results.",
    "Visually communicate that the page is busy fetching information."
   ]
  },
  "status_pill": {
   "type": "object",
   "description": "A small, colored label or \"pill\" used to display a concise status for an item.",
   "properties": {
    "component": {
     "const": "status_pill"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string The text label for the status."
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string The semantic color of the pill (e.g., \"success\", \"warning\", \"error\", \"info\", \"neutral\")."
    },
    "icon": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string Optional icon to display within the pill."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A small, colored label or \"pill\" used to display a concise status for an item.",
   "x-intent-phrases": [
    "I need a way to quickly show if a task is done or still pending.",
    "Can I get a little colored tag to tell users if their order shipped or not?",
    "Show me a small indicator for active, inactive, or expired subscriptions."
   ]
  },
  "inline_feedback_message": {
   "type": "object",
   "description": "A small, contextual message displayed inline with content, often used",
   "properties": {
    "component": {
     "const": "inline_feedback_message"
    },
    "message": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string The feedback message text."
    },
    "type": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string The type of feedback (e.g., \"success\", \"error\", \"warning\", \"info\")."
    },
    "icon": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string Optional icon to display next to the message."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A small, contextual message displayed inline with content, often used",
   "x-intent-phrases": [
    "I need to show a quick note about a field being optional right next to it.",
    "Can I have a tiny message appear when someone hovers over a word?",
    "We need a way to tell users their input is invalid without a pop-up."
   ]
  },
  "rating_stars": {
   "type": "object",
   "description": "A row of stars showing a rating out of a maximum, optionally marked as interactive.",
   "properties": {
    "component": {
     "const": "rating_stars"
    },
    "rating": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer The current rating value (e.g., 3 for 3 stars)."
    },
    "max_rating": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer The maximum possible rating (e.g., 5 for 5 stars)."
    },
    "is_interactive": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean Indicates if the stars are clickable for user input."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Optional text label displayed above the rating stars."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A row of stars showing a rating out of a maximum, optionally marked as interactive.",
   "x-intent-phrases": [
    "I need a way for people to show how much they liked my product.",
    "Users should be able to give quick feedback on how good this article was.",
    "Let me see how popular this recipe is based on what others thought."
   ]
  },
  "progress_circle": {
   "type": "object",
   "description": "SVG circular progress arc that animates from 0 to the target value on mount using CSS stroke-dashoffset transition. Percentage is displayed in the centre. Replaces the prior placeholder implementation with a proper animated SVG arc. No JavaScript required.",
   "properties": {
    "component": {
     "const": "progress_circle"
    },
    "value": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer. The progress value (0–100)."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Caption text below the circle."
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Arc stroke colour. Default \"#38bdf8\"."
    },
    "size": {
     "description": "\"sm\" | \"md\" | \"lg\"  (optional, default \"md\"). Circle diameter."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-side-panel",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Circular gauge showing how much of a whole is complete, as a filled arc with the percentage in the centre. SVG that animates from zero when it appears.",
   "x-intent-phrases": [
    "I need a visual way to show users how much of a task is complete.",
    "Users need to see how far along they are in a multi-step process.",
    "I want to give instant feedback on file upload progress.",
    "A circular gauge showing how much of a queue of items has been worked through."
   ]
  },
  "action_required_card": {
   "type": "object",
   "description": "A card highlighting an important status or issue that requires immediate user attention or approval before proceeding.",
   "properties": {
    "component": {
     "const": "action_required_card"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string The main title of the card, indicating the required action."
    },
    "description": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string A detailed explanation of the action needed."
    },
    "action_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string The text for the primary action button."
    },
    "action_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string The URL for the primary action button."
    },
    "icon": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string Optional icon to display on the card."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-chat",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A card highlighting an important status or issue that requires immediate user attention or approval before proceeding.",
   "x-intent-phrases": [
    "I need a way to show users they have a pending payment they must approve.",
    "We need a prominent notice for users to complete their profile verification.",
    "Show users a big warning if their subscription is about to expire and needs renewal."
   ]
  },
  "feature_matrix": {
   "type": "object",
   "description": "Renders a table comparing features across multiple products or versions.",
   "properties": {
    "component": {
     "const": "feature_matrix"
    },
    "product_names": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array"
    },
    "features": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a table comparing features across multiple products or versions.",
   "x-intent-phrases": [
    "I need to show how our software plans stack up against each other.",
    "Help me visualize the differences in our service tiers at a glance.",
    "Users need a clear table comparing our subscription benefits."
   ]
  },
  "pricing_tier_card": {
   "type": "object",
   "description": "Renders a single pricing plan with its name, price, key features, and an optional call to action.",
   "properties": {
    "component": {
     "const": "pricing_tier_card"
    },
    "plan_name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "price": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "currency": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "frequency": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "features": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array"
    },
    "call_to_action_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "call_to_action_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "is_highlighted": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-chat",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a single pricing plan with its name, price, key features, and an optional call to action.",
   "x-intent-phrases": [
    "I need to show customers different subscription options clearly.",
    "We need a way to display our service levels and what's included.",
    "How can I present our pricing packages attractively on the website?"
   ]
  },
  "pricing_tier_group": {
   "type": "object",
   "description": "Renders a collection of pricing tier cards, typically for comparing",
   "properties": {
    "component": {
     "const": "pricing_tier_group"
    },
    "tiers": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a collection of pricing tier cards, typically for comparing",
   "x-intent-phrases": [
    "I need to show different subscription levels and what features they include.",
    "Users should easily compare our service plans side-by-side.",
    "We need to present our package options clearly to potential customers."
   ]
  },
  "pros_cons_list": {
   "type": "object",
   "description": "Renders a two-column list itemizing advantages and disadvantages for a single subject.",
   "properties": {
    "component": {
     "const": "pros_cons_list"
    },
    "subject": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "pros": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array"
    },
    "cons": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-chat",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a two-column list itemizing advantages and disadvantages for a single subject.",
   "x-intent-phrases": [
    "I need to show users the good and bad points of a product before they buy.",
    "Can we display the upsides and downsides of a new feature clearly?",
    "Help me present the benefits and drawbacks of a service subscription."
   ]
  },
  "side_by_side_spec": {
   "type": "object",
   "description": "Renders a detailed comparison of two items, displaying their attributes",
   "properties": {
    "component": {
     "const": "side_by_side_spec"
    },
    "item_a_name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "item_b_name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "specs": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a detailed comparison of two items, displaying their attributes",
   "x-intent-phrases": [
    "I need to see exactly how these two product options differ side-by-side.",
    "Show me a clear breakdown of the features for each of these two services.",
    "I need to compare the specs of these two devices in an easy-to-read format."
   ]
  },
  "product_spec_table": {
   "type": "object",
   "description": "Renders a table detailing technical specifications or features for a single product.",
   "properties": {
    "component": {
     "const": "product_spec_table"
    },
    "product_name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "specs": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a table detailing technical specifications or features for a single product.",
   "x-intent-phrases": [
    "I need to show the dimensions and weight of items clearly.",
    "Users should be able to compare key features side-by-side.",
    "Displaying material composition and warranty details is crucial.",
    "List the rent, deposit, size and included utilities of a property in a compact table.",
    "A spec sheet for a product or a hire item: dimensions, weight, capacity and price."
   ]
  },
  "comparison_grid": {
   "type": "object",
   "description": "Renders a grid comparing multiple products or services with features, often using icons or checkmarks to indicate presence.",
   "properties": {
    "component": {
     "const": "comparison_grid"
    },
    "products": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array"
    },
    "features": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a grid comparing multiple products or services with features, often using icons or checkmarks to indicate presence.",
   "x-intent-phrases": [
    "I need to show how our pricing tiers stack up against each other.",
    "Help me easily contrast the benefits of our different subscription plans.",
    "I want to display a clear side-by-side feature breakdown for our offerings."
   ]
  },
  "versus_block": {
   "type": "object",
   "description": "Renders a block explicitly comparing two entities with a prominent",
   "properties": {
    "component": {
     "const": "versus_block"
    },
    "entity_a_name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "entity_a_description": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "entity_a_image_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "entity_b_name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "entity_b_description": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "entity_b_image_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "comparison_points": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a block explicitly comparing two entities with a prominent",
   "x-intent-phrases": [
    "I need to show side-by-side what feature X does versus feature Y.",
    "Can I display a clear, direct comparison of product A against product B?",
    "Help me highlight the differences between two options so users can decide."
   ]
  },
  "rating_comparison": {
   "type": "object",
   "description": "Renders a comparison of multiple items based on star ratings or numerical",
   "properties": {
    "component": {
     "const": "rating_comparison"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-chat",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a comparison of multiple items based on star ratings or numerical",
   "x-intent-phrases": [
    "Show me how these three laptops stack up against each other based on user reviews.",
    "I need to see which of these restaurants has the best customer feedback scores.",
    "Help me decide between these two phone plans by comparing their feature satisfaction."
   ]
  },
  "capability_checklist": {
   "type": "object",
   "description": "Renders a list of capabilities, indicating which items possess each",
   "properties": {
    "component": {
     "const": "capability_checklist"
    },
    "capability_names": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Bold heading shown above the capability table or list."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a list of capabilities, indicating which items possess each",
   "x-intent-phrases": [
    "I need to show users what features are available on each pricing tier.",
    "Let me visually compare the services offered by different plans.",
    "Display which add-ons are compatible with each subscription level."
   ]
  },
  "toggle_switch": {
   "type": "object",
   "description": "Renders a visual on/off switch.",
   "properties": {
    "component": {
     "const": "toggle_switch"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "is_checked": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean"
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a visual on/off switch.",
   "x-intent-phrases": [
    "I need a way for users to quickly turn features on or off.",
    "My app needs a simple control for enabling or disabling notifications.",
    "Users should be able to easily switch between two states, like dark mode and light mode."
   ]
  },
  "expandable_text": {
   "type": "object",
   "description": "Renders a block of text that can be expanded or collapsed to reveal",
   "properties": {
    "component": {
     "const": "expandable_text"
    },
    "summary": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "details": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "initial_state_expanded": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a block of text that can be expanded or collapsed to reveal",
   "x-intent-phrases": [
    "I need a way to show a lot of product details without overwhelming users initially.",
    "Can we have a section for lengthy legal disclaimers that users can choose to see?",
    "I want to hide long comment threads until a user clicks to view them."
   ]
  },
  "flip_card": {
   "type": "object",
   "description": "Renders a card with a front and back side that flips on interaction.",
   "properties": {
    "component": {
     "const": "flip_card"
    },
    "front_content": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "back_content": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "trigger_on_hover": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a card with a front and back side that flips on interaction.",
   "x-intent-phrases": [
    "I need a way to show a product image and then its price when clicked.",
    "How can I reveal extra details about a feature only when the user wants to see them?",
    "I want to display a person's photo and then their job title on hover."
   ]
  },
  "image_hotspots": {
   "type": "object",
   "description": "Renders an image with interactive points that reveal information when clicked.",
   "properties": {
    "component": {
     "const": "image_hotspots"
    },
    "image_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "alt_text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "hotspots": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of objects with label, x_position, y_position, content"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders an image with interactive points that reveal information when clicked.",
   "x-intent-phrases": [
    "I need to show people where to find specific features on a product screenshot.",
    "Can I let users click on parts of a diagram to get more details?",
    "We want to highlight key areas of a map for an interactive tour."
   ]
  },
  "css_dropdown_menu": {
   "type": "object",
   "description": "Renders a menu that appears when a trigger element is hovered or focused.",
   "properties": {
    "component": {
     "const": "css_dropdown_menu"
    },
    "trigger_text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "menu_items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of objects with label, url"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a menu that appears when a trigger element is hovered or focused.",
   "x-intent-phrases": [
    "I need a way for users to see more options when they point at something.",
    "Can we show extra actions when a button gets attention?",
    "How can I reveal a list of choices when someone clicks or highlights an item?"
   ]
  },
  "star_rating_input": {
   "type": "object",
   "description": "Renders an interactive star rating component for user input.",
   "properties": {
    "component": {
     "const": "star_rating_input"
    },
    "max_stars": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer"
    },
    "initial_rating": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer"
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Optional label text displayed above the star rating input."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders an interactive star rating component for user input.",
   "x-intent-phrases": [
    "I need a way for users to quickly tell me how much they liked this item.",
    "Customers need to rate their experience on a scale of one to five stars.",
    "Let users give feedback visually using a simple star system."
   ]
  },
  "segmented_control": {
   "type": "object",
   "description": "Renders a group of mutually exclusive buttons for selection, styled",
   "properties": {
    "component": {
     "const": "segmented_control"
    },
    "options": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of objects with label, value"
    },
    "selected_value": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a group of mutually exclusive buttons for selection, styled",
   "x-intent-phrases": [
    "I need a way to switch between viewing data by day, week, or month.",
    "Let me pick one option from a short, fixed list of choices.",
    "I want a toggle to easily select between two main settings."
   ]
  },
  "zoomable_image": {
   "type": "object",
   "description": "Renders an image that magnifies when hovered over.",
   "properties": {
    "component": {
     "const": "zoomable_image"
    },
    "image_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "alt_text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "zoom_factor": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "float"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders an image that magnifies when hovered over.",
   "x-intent-phrases": [
    "I need to show close-ups of product details without leaving the page.",
    "Users should be able to inspect intricate artwork on my site.",
    "I want visitors to get a better look at maps and diagrams."
   ]
  },
  "custom_checkbox_group": {
   "type": "object",
   "description": "Renders a group of custom-styled checkboxes allowing multiple selections.",
   "properties": {
    "component": {
     "const": "custom_checkbox_group"
    },
    "group_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "options": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of objects with label, value, is_checked"
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a group of custom-styled checkboxes allowing multiple selections.",
   "x-intent-phrases": [
    "I need a way for users to pick several options from a list for their profile settings.",
    "Our form needs a section where people can select multiple interests to subscribe to.",
    "We need to let users choose any combination of services they want to add to their order."
   ]
  },
  "css_slide_panel": {
   "type": "object",
   "description": "Renders a panel that slides into view from the side of the screen on activation.",
   "properties": {
    "component": {
     "const": "css_slide_panel"
    },
    "trigger_text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "panel_content": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "slide_from_side": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a panel that slides into view from the side of the screen on activation.",
   "x-intent-phrases": [
    "I need a place for settings that pops out without taking over the whole screen.",
    "When a user clicks an item, I want a detail view to appear from the edge.",
    "Let's add a quick access menu that hides until needed, appearing from the side."
   ]
  },
  "testimonial_card": {
   "type": "object",
   "description": "Renders a single customer testimonial with text, author details, and an optional avatar.",
   "properties": {
    "component": {
     "const": "testimonial_card"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "author_name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "author_title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "author_avatar_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "rating": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a single customer testimonial with text, author details, and an optional avatar.",
   "x-intent-phrases": [
    "Show me what happy customers are saying about our service.",
    "I need a way to highlight positive feedback on our product page.",
    "Let's display quotes from satisfied users to build trust."
   ]
  },
  "star_rating_display": {
   "type": "object",
   "description": "Renders a visual representation of a star rating, optionally with a total review count.",
   "properties": {
    "component": {
     "const": "star_rating_display"
    },
    "rating": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number"
    },
    "max_rating": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer"
    },
    "review_count": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a visual representation of a star rating, optionally with a total review count.",
   "x-intent-phrases": [
    "I need to show how good a product is with little stars.",
    "How would I display the average customer score for this item?",
    "Can I visually represent a score out of five using icons?"
   ]
  },
  "avatar_group": {
   "type": "object",
   "description": "Renders a stack or row of small user avatars, often indicating a group",
   "properties": {
    "component": {
     "const": "avatar_group"
    },
    "avatars": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list"
    },
    "total_count": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a stack or row of small user avatars, often indicating a group",
   "x-intent-phrases": [
    "Show who's in this project team.",
    "Display multiple people assigned to this task.",
    "Let users see who else is viewing this document."
   ]
  },
  "contributor_list": {
   "type": "object",
   "description": "Renders a list of individuals who have contributed to a project or community, with their avatars and roles.",
   "properties": {
    "component": {
     "const": "contributor_list"
    },
    "contributors": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a list of individuals who have contributed to a project or community, with their avatars and roles.",
   "x-intent-phrases": [
    "I need to show everyone who worked on this feature.",
    "How can I credit all the people who helped build this section?",
    "I want to display a roster of our project team members."
   ]
  },
  "customer_logo_grid": {
   "type": "object",
   "description": "Renders a grid or row of logos from featured customers or partners.",
   "properties": {
    "component": {
     "const": "customer_logo_grid"
    },
    "logos": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a grid or row of logos from featured customers or partners.",
   "x-intent-phrases": [
    "I need to show off the companies that trust our service.",
    "Can I display our most important business allies prominently on the homepage?",
    "We want to visually prove our credibility by listing our clients."
   ]
  },
  "social_proof_banner": {
   "type": "object",
   "description": "Renders a prominent banner highlighting a key social proof metric or achievement.",
   "properties": {
    "component": {
     "const": "social_proof_banner"
    },
    "metric_value": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "metric_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "icon_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "link_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a prominent banner highlighting a key social proof metric or achievement.",
   "x-intent-phrases": [
    "Show users how many people are already using this feature.",
    "Let visitors know how popular this product is with others.",
    "Display the number of satisfied customers to build trust."
   ]
  },
  "media_mention_card": {
   "type": "object",
   "description": "Renders a card showcasing a mention or feature in a media publication.",
   "properties": {
    "component": {
     "const": "media_mention_card"
    },
    "publication_name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "publication_logo_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "headline": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "article_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "date": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a card showcasing a mention or feature in a media publication.",
   "x-intent-phrases": [
    "Show me where our product was recently talked about online.",
    "Can we highlight press coverage about our company?",
    "I need a way to display featured articles about our work."
   ]
  },
  "expert_endorsement": {
   "type": "object",
   "description": "Renders an endorsement from an industry expert, including their quote, photo, name, and credentials.",
   "properties": {
    "component": {
     "const": "expert_endorsement"
    },
    "quote": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "expert_name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "expert_title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "expert_organization": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "expert_avatar_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders an endorsement from an industry expert, including their quote, photo, name, and credentials.",
   "x-intent-phrases": [
    "Show me what a respected leader in my field thinks about this.",
    "I need to display a strong testimonial from a recognized professional.",
    "How can I feature a credible opinion from an industry influencer?"
   ]
  },
  "review_callout": {
   "type": "object",
   "description": "Renders a short, impactful quote from a customer review, often accompanied",
   "properties": {
    "component": {
     "const": "review_callout"
    },
    "review_text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "author_name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "rating": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number"
    },
    "max_rating": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer"
    },
    "product_name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a short, impactful quote from a customer review, often accompanied",
   "x-intent-phrases": [
    "Need to show off what happy users are saying about our product.",
    "Want to highlight a great customer testimonial on the homepage.",
    "Need a quick way to display a strong positive endorsement."
   ]
  },
  "social_feed_embed": {
   "type": "object",
   "description": "Renders an embedded snippet of a social media post, such as a tweet",
   "properties": {
    "component": {
     "const": "social_feed_embed"
    },
    "embed_code": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "platform": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "post_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders an embedded snippet of a social media post, such as a tweet",
   "x-intent-phrases": [
    "I need to show a user's latest Instagram picture directly in my app.",
    "Can I embed a TikTok video so people can watch it without leaving my site?",
    "How can I display a specific LinkedIn post to highlight a company update?"
   ]
  },
  "terminal_block": {
   "type": "object",
   "description": "Renders a static or interactive command-line interface terminal window showing input commands and output logs.",
   "properties": {
    "component": {
     "const": "terminal_block"
    },
    "command": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The execution command displayed at the prompt."
    },
    "output": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The stdout or stderr text block response from the command."
    },
    "shell": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string: bash | zsh | powershell | cmd. The console design theme."
    },
    "lines": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of objects. Terminal lines, each a string or an object with type (command or output) and content; command lines get a '$ ' prefix."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a static or interactive command-line interface terminal window showing input commands and output logs.",
   "x-intent-phrases": [
    "I need to show users how to run a specific tool from their own command line.",
    "My users need to try out code snippets directly in the browser.",
    "I want to let users see the execution flow of a script in real-time."
   ]
  },
  "file_tree": {
   "type": "object",
   "description": "Renders a hierarchical layout displaying directory structures, folders, and individual files for software projects.",
   "properties": {
    "component": {
     "const": "file_tree"
    },
    "nodes": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. Highly structured list of folder and file objects with nesting indicators."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a hierarchical layout displaying directory structures, folders, and individual files for software projects.",
   "x-intent-phrases": [
    "I need to show users all the code files and folders in their project.",
    "My app needs to let people browse and select files from a complex project structure.",
    "Users should be able to see how their project's assets are organized visually."
   ]
  },
  "tabbed_code": {
   "type": "object",
   "description": "Renders multiple code snippets organized inside an interactive, multi-tab container component.",
   "properties": {
    "component": {
     "const": "tabbed_code"
    },
    "tabs": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. Collection of objects containing the language identifier, tab label, and code string."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders multiple code snippets organized inside an interactive, multi-tab container component.",
   "x-intent-phrases": [
    "I need a way to show different code examples for the same thing.",
    "My users need to switch between language versions of the same code block easily.",
    "Can I display multiple configuration files for a single feature in a clean way?"
   ]
  },
  "http_request_block": {
   "type": "object",
   "description": "Renders a formatted API request block displaying the HTTP method badge, URL endpoint, headers, and body.",
   "properties": {
    "component": {
     "const": "http_request_block"
    },
    "method": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string: GET | POST | PUT | DELETE | PATCH. The HTTP verb."
    },
    "url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The fully qualified or relative API endpoint route."
    },
    "headers": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object. Key-value pairs detailing required HTTP headers."
    },
    "body": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Optional request payload, typically stringified JSON."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a formatted API request block displaying the HTTP method badge, URL endpoint, headers, and body.",
   "x-intent-phrases": [
    "I need to show users exactly what data is being sent when they save their profile.",
    "Can we display the details of a failed API call so developers can debug it easily?",
    "It would be great to visualize the exact request made when fetching user comments."
   ]
  },
  "env_var_list": {
   "type": "object",
   "description": "Renders a clear configuration list detailing system environment variable keys, descriptions, and default values.",
   "properties": {
    "component": {
     "const": "env_var_list"
    },
    "variables": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. List of objects including key name, description, requirement status, and default."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a clear configuration list detailing system environment variable keys, descriptions, and default values.",
   "x-intent-phrases": [
    "I need to show users how to set up their server with all the necessary settings.",
    "Help me display all the options a user can tweak for the system's behavior.",
    "I want to provide a reference for all the custom properties our application uses."
   ]
  },
  "prerequisite_checklist": {
   "type": "object",
   "description": "Renders a callout box highlighting required tools, knowledge, or setups needed before starting a guide.",
   "properties": {
    "component": {
     "const": "prerequisite_checklist"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Custom header text for the prerequisite warning block."
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. Strings containing descriptions of individual setup requirements."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a callout box highlighting required tools, knowledge, or setups needed before starting a guide.",
   "x-intent-phrases": [
    "I need a way to show users what they'll need before they begin this setup.",
    "Can we add a box that lists the essential software for this tutorial?",
    "How can I make sure users have the right permissions before they click start?"
   ]
  },
  "keyboard_shortcut": {
   "type": "object",
   "description": "Renders inline text visual tags mimicking keyboard keys to highlight shortcuts or hotkey combinations.",
   "properties": {
    "component": {
     "const": "keyboard_shortcut"
    },
    "keys": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. Individual key characters like Ctrl, Shift, or C to join."
    },
    "action": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The function or command triggered by the keystroke combination."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders inline text visual tags mimicking keyboard keys to highlight shortcuts or hotkey combinations.",
   "x-intent-phrases": [
    "I need to show users how to save their work quickly.",
    "Help me visually indicate the command to open the search bar.",
    "I want to make it clear how to trigger the undo action."
   ]
  },
  "api_param_table": {
   "type": "object",
   "description": "Renders a structured documentation table outlining parameter fields, data types, requirements, and fallback options.",
   "properties": {
    "component": {
     "const": "api_param_table"
    },
    "parameters": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. Objects defining name, type, required flag, default value, and description."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a structured documentation table outlining parameter fields, data types, requirements, and fallback options.",
   "x-intent-phrases": [
    "I need a clear way to show all the possible inputs for my new feature.",
    "How can I list the exact data formats our users must provide?",
    "I want to document what happens if a user skips an optional field."
   ]
  },
  "version_badge": {
   "type": "object",
   "description": "Displays a small visual tag showing software release or dependency version numbers.",
   "properties": {
    "component": {
     "const": "version_badge"
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The semantic version number or release label to display."
    },
    "status": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string: stable | beta | alpha | rc. The lifecycle stage."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Displays a small visual tag showing software release or dependency version numbers.",
   "x-intent-phrases": [
    "I need to show users the exact version of the app they're currently using.",
    "How can I indicate which version of a specific plugin is installed?",
    "Can I display the release number of a new feature clearly on its card?"
   ]
  },
  "deprecation_notice": {
   "type": "object",
   "description": "Displays a prominent warning banner indicating a feature or API is no longer supported.",
   "properties": {
    "component": {
     "const": "deprecation_notice"
    },
    "alternative": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Recommended migration path or replacement feature."
    },
    "removal_version": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Optional version when the feature will be removed."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Displays a prominent warning banner indicating a feature or API is no longer supported.",
   "x-intent-phrases": [
    "Need to tell users a button they use is going away soon.",
    "How do I show a big alert that something is outdated?",
    "I need a way to flag an old setting that will stop working."
   ]
  },
  "experimental_banner": {
   "type": "object",
   "description": "Renders a callout box identifying a feature or code path as experimental or unstable.",
   "properties": {
    "component": {
     "const": "experimental_banner"
    },
    "message": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Context or feedback links for the unstable feature."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a callout box identifying a feature or code path as experimental or unstable.",
   "x-intent-phrases": [
    "I need to show users that this new feature might break.",
    "How can I warn people this part of the app is still being tested?",
    "We're rolling out a draft feature, how do we flag it as risky?"
   ]
  },
  "cli_command": {
   "type": "object",
   "description": "Displays a copyable single-line command-line prompt for terminal execution.",
   "properties": {
    "component": {
     "const": "cli_command"
    },
    "command": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The exact shell command to be copied and executed."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Displays a copyable single-line command-line prompt for terminal execution.",
   "x-intent-phrases": [
    "I need a way to show users exactly what to type in their terminal to set up the project.",
    "We want to give developers a quick, copy-pasteable instruction for running our script.",
    "Users need to see and easily copy the command to get started with our tool."
   ]
  },
  "copy_code_button": {
   "type": "object",
   "description": "Renders a discrete interactive button that copies associated text or code to the clipboard.",
   "properties": {
    "component": {
     "const": "copy_code_button"
    },
    "text_to_copy": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The raw string content sent to clipboard when clicked."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a discrete interactive button that copies associated text or code to the clipboard.",
   "x-intent-phrases": [
    "I need a quick way for users to grab code snippets from my docs.",
    "My users need to easily share configuration text with others.",
    "I want a simple button to let people copy example commands."
   ]
  },
  "log_output": {
   "type": "object",
   "description": "Displays a scrollable monospace block containing raw system or compilation log strings.",
   "properties": {
    "component": {
     "const": "log_output"
    },
    "logs": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The raw console log output text block."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Displays a scrollable monospace block containing raw system or compilation log strings.",
   "x-intent-phrases": [
    "I need to see the exact error messages from my build process.",
    "Show me the raw output from the server logs as they happen.",
    "Display the full, unformatted text from the command-line tool."
   ]
  },
  "json_tree_viewer": {
   "type": "object",
   "description": "Displays a nested, expandable visual explorer for structural JSON data objects.",
   "properties": {
    "component": {
     "const": "json_tree_viewer"
    },
    "data": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The raw valid JSON string to parse and render."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Displays a nested, expandable visual explorer for structural JSON data objects.",
   "x-intent-phrases": [
    "I need to see all the data from an API response in a readable way.",
    "Help me explore the details inside a complex configuration file easily.",
    "I want to visualize the structure of my saved user settings without digging through code."
   ]
  },
  "key_takeaways": {
   "type": "object",
   "description": "Displays a highlighted summary box containing critical bullet points from an article.",
   "properties": {
    "component": {
     "const": "key_takeaways"
    },
    "points": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. Core sentences highlighting the key learnings."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "claude-code",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Displays a highlighted summary box containing critical bullet points from an article.",
   "x-intent-phrases": [
    "I need to quickly show the most important facts from a long report.",
    "Users should see the main points of an article at a glance.",
    "Can we have a box that highlights the essential information from a document?"
   ]
  },
  "summary_box": {
   "type": "object",
   "description": "Renders a condensed overview panel summarising article content at a glance.",
   "properties": {
    "component": {
     "const": "summary_box"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The summary narrative block."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Header text displayed at the top of the summary box, defaults to 'Summary'."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a condensed overview panel summarising article content at a glance.",
   "x-intent-phrases": [
    "I need a small box to show the main points of a long article.",
    "Display a quick blurb for each news item in a list.",
    "Show a short preview of a document's key takeaways."
   ]
  },
  "learning_objectives": {
   "type": "object",
   "description": "Displays a checklist-style panel outlining competencies a reader will gain from the content.",
   "properties": {
    "component": {
     "const": "learning_objectives"
    },
    "objectives": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. Statements describing individual knowledge achievements."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Displays a checklist-style panel outlining competencies a reader will gain from the content.",
   "x-intent-phrases": [
    "I need to show users what skills they'll pick up from this guide.",
    "Users should see a clear list of what they'll be able to do after reading.",
    "I want to highlight the key takeaways and abilities gained from this material."
   ]
  },
  "changelog_entry": {
   "type": "object",
   "description": "Renders a single timeline entry documenting additions, fixes, or modifications in a software release.",
   "properties": {
    "component": {
     "const": "changelog_entry"
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The release tag or identifier."
    },
    "date": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The publication date of the changes."
    },
    "changes": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. Objects outlining specific features modified, categorised by type."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a single timeline entry documenting additions, fixes, or modifications in a software release.",
   "x-intent-phrases": [
    "Show users what's new in the latest update.",
    "Keep track of bug fixes and improvements over time.",
    "Announce new features released to users."
   ]
  },
  "release_notes": {
   "type": "object",
   "description": "Displays a grouped publication document containing categorised changes for a version launch.",
   "properties": {
    "component": {
     "const": "release_notes"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Header name for the release notice."
    },
    "added": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. Optional new features added in this release."
    },
    "fixed": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. Optional bugs resolved in this release."
    },
    "changed": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. Optional modifications to existing behaviour."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Displays a grouped publication document containing categorised changes for a version launch.",
   "x-intent-phrases": [
    "I need a way to show users all the new features and fixes in the latest app update.",
    "How can I present what's changed in our software clearly for each new version release?",
    "We need to organize and display the updates for our product so customers can easily see what's different."
   ]
  },
  "further_reading": {
   "type": "object",
   "description": "Displays a curated list of links and references for extending understanding beyond the article.",
   "properties": {
    "component": {
     "const": "further_reading"
    },
    "links": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. Objects containing resource titles, URLs, and brief annotations."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Displays a curated list of links and references for extending understanding beyond the article.",
   "x-intent-phrases": [
    "I need a way to show users related articles and resources after they finish reading.",
    "Can I add a section at the end of my content to suggest more in-depth material?",
    "I want to provide extra learning opportunities for people who want to dive deeper."
   ]
  },
  "resources_list": {
   "type": "object",
   "description": "Renders a clean inventory list of downloadable assets or reference files with metadata.",
   "properties": {
    "component": {
     "const": "resources_list"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. Download assets containing title, size, type, and url."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a clean inventory list of downloadable assets or reference files with metadata.",
   "x-intent-phrases": [
    "I need a way to show users all the documents they can download from our system.",
    "We need to display a catalog of training videos with descriptions and file sizes.",
    "Show users a list of all available project templates with their latest versions."
   ]
  },
  "sidebar_note": {
   "type": "object",
   "description": "Displays an off-axis callout block containing peripheral thoughts, caveats, or fun facts.",
   "properties": {
    "component": {
     "const": "sidebar_note"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The headline for the side note."
    },
    "content": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The note content."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Displays an off-axis callout block containing peripheral thoughts, caveats, or fun facts.",
   "x-intent-phrases": [
    "I need a way to show extra tips without cluttering the main content.",
    "Can I add little pop-up boxes for related info that doesn't interrupt the flow?",
    "I want a place for users to see optional details that aren't critical to the task."
   ]
  },
  "difficulty_badge": {
   "type": "object",
   "description": "Displays a small visual marker representing the technical complexity level of an article.",
   "properties": {
    "component": {
     "const": "difficulty_badge"
    },
    "level": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string: beginner | intermediate | advanced. The target audience expertise tier."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Displays a small visual marker representing the technical complexity level of an article.",
   "x-intent-phrases": [
    "I need a way to quickly show how hard a tutorial is to follow.",
    "Can I get a little indicator to signal if an article is for beginners or experts?",
    "I'm looking for a small tag to give users an idea of the skill needed for this content."
   ]
  },
  "caution_block": {
   "type": "object",
   "description": "Renders a high-visibility callout box warning readers about potential pitfalls or destructive actions.",
   "properties": {
    "component": {
     "const": "caution_block"
    },
    "message": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The warning content."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a high-visibility callout box warning readers about potential pitfalls or destructive actions.",
   "x-intent-phrases": [
    "I need a way to make sure users see this important message before they click delete.",
    "How can I highlight a warning about losing all their data if they proceed?",
    "I want a prominent box for critical security alerts on this page."
   ]
  },
  "checklist_interactive": {
   "type": "object",
   "description": "Renders a list of items with actionable checkboxes for readers to track task progress.",
   "properties": {
    "component": {
     "const": "checklist_interactive"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. Individual checkpoint task strings."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a list of items with actionable checkboxes for readers to track task progress.",
   "x-intent-phrases": [
    "I need a way for users to mark steps as complete as they go through a process.",
    "Users should be able to select multiple options from a predefined list of choices.",
    "I want to show a list of things users need to do and let them check them off."
   ]
  },
  "glossary_inline": {
   "type": "object",
   "description": "Renders a specialised inline element displaying technical term definitions on hover.",
   "properties": {
    "component": {
     "const": "glossary_inline"
    },
    "term": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The technical phrase needing definition."
    },
    "definition": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Explanation displayed when term is activated."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a specialised inline element displaying technical term definitions on hover.",
   "x-intent-phrases": [
    "I need tooltips for jargon so users don't get lost.",
    "Show explanations when people hover over specific words.",
    "We need a way to quickly define technical terms without leaving the page."
   ]
  },
  "time_estimate": {
   "type": "object",
   "description": "Displays the estimated duration required to fully read or complete an article.",
   "properties": {
    "component": {
     "const": "time_estimate"
    },
    "minutes": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer. The estimated reading time in minutes."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Displays the estimated duration required to fully read or complete an article.",
   "x-intent-phrases": [
    "Show me how long this article will take to read.",
    "I need to know if I have time for this before my meeting.",
    "Let me quickly gauge the commitment for this content."
   ]
  },
  "progress_checkpoint": {
   "type": "object",
   "description": "Displays an indicator showing the reader's current location within a multi-step sequence.",
   "properties": {
    "component": {
     "const": "progress_checkpoint"
    },
    "current_step": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer. The current active step index."
    },
    "total_steps": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer. Total steps in the sequence."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Displays an indicator showing the reader's current location within a multi-step sequence.",
   "x-intent-phrases": [
    "I need to show users which step in my signup form they're on.",
    "How can I visually indicate where the user is in a long process?",
    "Display a clear marker for their current position in our multi-page guide."
   ]
  },
  "social_share_bar": {
   "type": "object",
   "description": "Displays a row of quick-action buttons enabling readers to share the post to external networks.",
   "properties": {
    "component": {
     "const": "social_share_bar"
    },
    "platforms": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. Permitted networks: twitter | linkedin | facebook | reddit."
    },
    "url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Optional URL override, defaults to current page."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Displays a row of quick-action buttons enabling readers to share the post to external networks.",
   "x-intent-phrases": [
    "I need buttons to help people send my articles to their friends on Facebook and Twitter.",
    "Can I get icons so readers can easily post my content to LinkedIn and email it?",
    "I want a way for users to share my blog posts on various popular platforms quickly."
   ]
  },
  "newsletter_cta": {
   "type": "object",
   "description": "Displays an input block encouraging readers to subscribe to an email update list.",
   "properties": {
    "component": {
     "const": "newsletter_cta"
    },
    "headline": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Header message prompting subscription."
    },
    "button_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Optional submit button text, defaults to Subscribe."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Displays an input block encouraging readers to subscribe to an email update list.",
   "x-intent-phrases": [
    "I need a way for visitors to give me their email to get my latest articles.",
    "Let's add a simple form to capture reader addresses for our mailing list.",
    "How can users sign up for notifications about new content on my site?"
   ]
  },
  "author_bio_card": {
   "type": "object",
   "description": "Renders a profile section containing the creator's avatar, bio, and links.",
   "properties": {
    "component": {
     "const": "author_bio_card"
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Full name of the content creator."
    },
    "avatar_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. URL to the profile image."
    },
    "bio": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Short narrative profiling the writer."
    },
    "links": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object. Optional key-value pairs of platform names and URLs."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a profile section containing the creator's avatar, bio, and links.",
   "x-intent-phrases": [
    "I need a way to showcase the person behind the content.",
    "How can I display a brief intro and contact for each contributor?",
    "Please provide a clean box for author details and social links."
   ]
  },
  "related_posts_grid": {
   "type": "object",
   "description": "Displays a curated grid of preview cards for complementary reading material.",
   "properties": {
    "component": {
     "const": "related_posts_grid"
    },
    "posts": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. Objects containing title, url, and optional topic."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Displays a curated grid of preview cards for complementary reading material.",
   "x-intent-phrases": [
    "Show me other articles my readers might find interesting after this one.",
    "I need a way to link to similar content on my site without cluttering the main page.",
    "Display a selection of related blog posts to keep users engaged longer."
   ]
  },
  "series_overview_card": {
   "type": "object",
   "description": "Renders a navigation box indexing all parts within a multi-part article series.",
   "properties": {
    "component": {
     "const": "series_overview_card"
    },
    "series_name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Name of the series."
    },
    "parts": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. Objects with title, url, and optional current boolean."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a navigation box indexing all parts within a multi-part article series.",
   "x-intent-phrases": [
    "I need a way to show readers all the chapters of my book on one page.",
    "My users need to quickly jump to different sections of a long tutorial.",
    "Can I have a simple list that links to all the articles in my series?"
   ]
  },
  "reaction_group": {
   "type": "object",
   "description": "Displays an interactive set of emoji elements collecting emotional sentiment feedback from readers.",
   "properties": {
    "component": {
     "const": "reaction_group"
    },
    "enabled_emojis": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. Tracked emojis: thumbs_up | heart | rocket | mind_blown."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Displays an interactive set of emoji elements collecting emotional sentiment feedback from readers.",
   "x-intent-phrases": [
    "I need a way for users to quickly show how they feel about a post.",
    "Let readers tap an icon to express their immediate reaction to content.",
    "Add a simple feedback mechanism so people can indicate their emotions."
   ]
  },
  "linkedin_post_image": {
   "type": "object",
   "description": "Renders a styled LinkedIn post image preview (conviction card, stat card, or carousel slide). Screenshot at 1.91:1 ratio for social sharing.",
   "properties": {
    "component": {
     "const": "linkedin_post_image"
    },
    "mode": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, \"conviction_card\"|\"stat_card\"|\"carousel_slide\", default \"conviction_card\")"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex, default \"#7c3aed\")"
    },
    "quote": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (conviction_card — main quote text)"
    },
    "attribution": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (conviction_card — author/source)"
    },
    "value": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (stat_card — big number)"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (stat_card — metric label)"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (carousel_slide — slide title)"
    },
    "body": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (carousel_slide — slide body)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a styled LinkedIn post image preview (conviction card, stat card, or carousel slide). Screenshot at 1.91:1 ratio for social sharing.",
   "x-intent-phrases": [
    "I need to show a visually appealing summary of my latest article for sharing.",
    "Can I get a way to preview how my business stats will look when shared on social media?",
    "I'd like to generate thumbnail images for my slide deck presentations to easily share snippets."
   ]
  },
  "weighted_words": {
   "type": "object",
   "description": "Agentic typesetting: the agent decides how much each WORD weighs. A headline where every word carries an emphasis 1-5 that sets its size, weight and opacity, with the heaviest words in the accent colour; words land in sequence, heavier ones from higher up. The reader sees the shape of the argument before reading it. Give it \"words\" as [{text, weight}] to typeset deliberately, or plain \"text\" for an even setting. Screenshot-ready, light or dark. Capped at 40 words of 24 characters; weights clamp to 1-5.",
   "properties": {
    "component": {
     "const": "weighted_words"
    },
    "words": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {text, weight} (optional). weight is an integer 1-5; 5 is set in the accent colour. Strings are accepted as weight 2."
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Fallback when words is absent; every word set at weight 2."
    },
    "voice": {
     "description": "\"display\" | \"serif\" | \"mono\"  (optional, default \"display\"). System font stacks."
    },
    "theme": {
     "description": "\"dark\" | \"light\"  (optional, default \"dark\")"
    },
    "accent": {
     "description": "\"#rrggbb\" (optional). Default \"#38bdf8\"."
    },
    "align": {
     "description": "\"left\" | \"center\"  (optional, default \"left\")"
    },
    "animate": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Words land in sequence on load. Default true."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "pdf",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Agentic typesetting: the agent decides how much each WORD weighs. A headline where every word carries an emphasis 1-5 that sets its size, weight and opacity, with the heaviest words in the accent colo",
   "x-intent-phrases": [
    "I need my main announcement to really pop with key terms standing out.",
    "Can I make the most important words in my marketing slogan visually more impactful?",
    "I want to draw attention to specific keywords in this user-facing message, making them bolder and brighter."
   ]
  },
  "stance": {
   "type": "object",
   "description": "A claim whose typography IS its calibration. The agent states a claim and a confidence 0-1; the type sets itself from it -- weight from 300 (a hunch) to 900 (a conviction), size from 1.4rem to 3rem, tracking tightening and opacity rising with confidence -- under a thin confidence rail. Optional \"because\" (the reason) and \"unless\" (what would change the agent's mind, the line most opinion cards forget). A small slider lets the reader drag the confidence and watch the claim reset, which makes the mapping legible and honest. Same integer arithmetic on the server and in the slider script.",
   "properties": {
    "component": {
     "const": "stance"
    },
    "claim": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). The claim, up to 200 characters."
    },
    "confidence": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). 0-1 (values above 1 are read as percent). Default 0.5."
    },
    "because": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). The reason, one or two sentences."
    },
    "unless": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). What would change the agent''s mind; rendered as \"I would change my mind if ...\"."
    },
    "voice": {
     "description": "\"display\" | \"serif\" | \"mono\"  (optional, default \"display\"). System font stacks."
    },
    "theme": {
     "description": "\"dark\" | \"light\"  (optional, default \"dark\")"
    },
    "accent": {
     "description": "\"#rrggbb\" (optional). Default \"#38bdf8\"."
    },
    "interactive": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Show the try-it slider. Default true."
    }
   },
   "required": [
    "component",
    "claim"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "pdf",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A claim whose typography IS its calibration. The agent states a claim and a confidence 0-1; the type sets itself from it -- weight from 300 (a hunch) to 900 (a conviction), size from 1.4rem to 3rem, t",
   "x-intent-phrases": [
    "I need to show how sure I am about my suggestions, visually.",
    "Users should see how strongly I believe in the information I'm providing.",
    "Make the emphasis of my statements clear based on how certain I am."
   ]
  },
  "receipt": {
   "type": "object",
   "description": "Show your receipts: a claim printed at the top of a till receipt, then the evidence as numbered receipt lines with a source per line (linked when a URL is given), a dashed tear line, a CONFIDENCE total, a barcode derived deterministically from the claim, and a perforated bottom edge. Built for the \"no unsourced stats\" rule and for AG-UI-style runs where evidence arrives one tool result at a time: resend the FULL items list on every update and only the LAST line prints in (same stateless rule as agent_sketchpad). Always paper-white, so it reads as an object on any ground. Capped at 24 items.",
   "properties": {
    "component": {
     "const": "receipt"
    },
    "claim": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). Printed in display type at the top."
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {text, source?, url?} (optional). Evidence lines in order; source is a short label, url must be http(s). Strings are accepted."
    },
    "total": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Confidence 0-1 shown as the receipt total; when absent the item count is shown."
    },
    "total_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Default \"CONFIDENCE\"."
    },
    "merchant": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Top label. Default \"EVIDENCE RECEIPT\"."
    },
    "issued": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Date or context line under the merchant."
    },
    "footer": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Default \"Sources listed. No unsourced stats.\""
    },
    "accent": {
     "description": "\"#rrggbb\" (optional). Links and total colour. Default \"#4338ca\"."
    },
    "print_last": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Animate the last line printing in. Default true."
    }
   },
   "required": [
    "component",
    "claim"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "pdf",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Show your receipts: a claim printed at the top of a till receipt, then the evidence as numbered receipt lines with a source per line (linked when a URL is given), a dashed tear line, a CONFIDENCE tota",
   "x-intent-phrases": [
    "I need to display transaction details, including the customer's claim and itemized purchases.",
    "Show me a summary of my purchases, like a printed slip with costs and where I bought them.",
    "I want to see a breakdown of what I've paid for, with a total confidence score."
   ]
  },
  "changed_mind": {
   "type": "object",
   "description": "A belief change as a typographic object: \"I used to think\" in muted serif italic, struck through by a line that draws itself, then \"Now I think\" in heavy display type landing beneath it, and an optional \"since\" line naming what changed it. The most honest opinion format there is, and the most shared. For an agent it records a revision after new evidence rather than pretending it always knew. Light or dark.",
   "properties": {
    "component": {
     "const": "changed_mind"
    },
    "before": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). The old belief."
    },
    "after": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). The new belief."
    },
    "since": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). What changed it, e.g. \"since running it against a real host\"."
    },
    "voice": {
     "description": "\"display\" | \"serif\" | \"mono\"  (optional, default \"display\"). System font stacks."
    },
    "theme": {
     "description": "\"dark\" | \"light\"  (optional, default \"dark\")"
    },
    "accent": {
     "description": "\"#rrggbb\" (optional). Default \"#38bdf8\"."
    },
    "animate": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Strike and land on load. Default true."
    }
   },
   "required": [
    "component",
    "before",
    "after"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "pdf",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A belief change as a typographic object: \"I used to think\" in muted serif italic, struck through by a line that draws itself, then \"Now I think\" in heavy display type landing beneath it, and an option",
   "x-intent-phrases": [
    "Show me how someone changed their opinion about a product feature.",
    "I need to visualize a shift in a user's stated preference.",
    "Display a clear indication of a previous stance versus a new one."
   ]
  },
  "type_scale": {
   "type": "object",
   "description": "A modular type scale, computed and shown as a specimen sheet. Declare a base size and a musical ratio (minor second through golden ratio) and the atom calculates every step -- px and rem to the hundredth, computed with the same integer-safe arithmetic on every renderer -- and sets the sample line at each size with a proportion bar, plus a ready-to-paste block of CSS custom properties. Calcs baked in, the way wall_elevation bakes in wall maths: an agent declares intent (base, ratio, steps), the atom does the typography. Light or dark, no JavaScript.",
   "properties": {
    "component": {
     "const": "type_scale"
    },
    "base": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Base size in px, clamped 10-32. Default 16."
    },
    "ratio": {
     "description": "\"minor_second\" | \"major_second\" | \"minor_third\" | \"major_third\" | \"perfect_fourth\" | \"augmented_fourth\" | \"perfect_fifth\" | \"golden\"  (optional, default \"major_third\")"
    },
    "steps_up": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Steps above the base, clamped 1-8. Default 6."
    },
    "steps_down": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Steps below the base, clamped 0-3. Default 2."
    },
    "sample": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Sample line set at each size. Default \"The quick brown fox\"."
    },
    "voice": {
     "description": "\"display\" | \"serif\" | \"mono\"  (optional, default \"display\")"
    },
    "theme": {
     "description": "\"dark\" | \"light\"  (optional, default \"light\")"
    },
    "accent": {
     "description": "\"#rrggbb\" (optional). Default \"#0e7bb8\"."
    },
    "show_code": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Append the CSS custom properties block. Default true."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "pdf",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A modular type scale, computed and shown as a specimen sheet. Declare a base size and a musical ratio (minor second through golden ratio) and the atom calculates every step -- px and rem to the hundre",
   "x-intent-phrases": [
    "I need a consistent way to size all my text for headings and paragraphs.",
    "Help me create a visual hierarchy for my app's content with pleasing proportions.",
    "I want to define a set of text sizes that work well together harmonically."
   ]
  },
  "readability_card": {
   "type": "object",
   "description": "Prose metrics as a typographic card: the Flesch reading-ease score set huge, its plain-language grade, and a stat row -- words, sentences, minutes to read at a declared words-per-minute, words per sentence, syllables per word, longest sentence -- all computed by the renderer from the text with identical arithmetic on every renderer (syllables by a vowel-group heuristic, sentences on . ! ? followed by space). The excerpt is shown underneath with the longest sentence highlighted, which is usually the one to cut. Built for the writing workflow; give it a draft and it tells you what a reader will feel.",
   "properties": {
    "component": {
     "const": "readability_card"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). The prose to measure, up to 5000 characters."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Label above the score. Default \"readability\"."
    },
    "wpm": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Reading speed for the time estimate, clamped 100-500. Default 230."
    },
    "highlight_longest": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Mark the longest sentence in the excerpt. Default true."
    },
    "theme": {
     "description": "\"dark\" | \"light\"  (optional, default \"light\")"
    },
    "accent": {
     "description": "\"#rrggbb\" (optional). Default \"#0e7bb8\"."
    }
   },
   "required": [
    "component",
    "text"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "pdf",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Prose metrics as a typographic card: the Flesch reading-ease score set huge, its plain-language grade, and a stat row -- words, sentences, minutes to read at a declared words-per-minute, words per sen",
   "x-intent-phrases": [
    "I need a clear way to show how easy my content is to understand, including the reading level and how long it takes to read.",
    "Users need to see a summary of their text's complexity, like how many words are in each sentence and the overall difficulty.",
    "I want to display the estimated reading time and a simple score for how easy my text is to digest at a glance."
   ]
  },
  "drop_cap": {
   "type": "object",
   "description": "An editorial paragraph with an initial letter set four ways: dropped (the classic, sunk across 2-4 lines), raised (standing on the baseline), boxed (reversed out of an accent block), or ornament (italic, with a hairline rule). Leading quotation marks and brackets are skipped so the real first letter is the cap. Light or dark, no JavaScript. The smallest atom in the family and the one every long read wants.",
   "properties": {
    "component": {
     "const": "drop_cap"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). The paragraph, up to 2000 characters."
    },
    "style": {
     "description": "\"dropped\" | \"raised\" | \"boxed\" | \"ornament\"  (optional, default \"dropped\")"
    },
    "lines": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Lines the dropped cap spans, clamped 2-4. Default 3."
    },
    "voice": {
     "description": "\"display\" | \"serif\" | \"mono\"  (optional, default \"serif\"). Face of the initial."
    },
    "theme": {
     "description": "\"dark\" | \"light\"  (optional, default \"light\")"
    },
    "accent": {
     "description": "\"#rrggbb\" (optional). Colour of the initial. Default \"#0e7bb8\"."
    }
   },
   "required": [
    "component",
    "text"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "pdf",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "An editorial paragraph with an initial letter set four ways: dropped (the classic, sunk across 2-4 lines), raised (standing on the baseline), boxed (reversed out of an accent block), or ornament (ital",
   "x-intent-phrases": [
    "I need the first letter of my article to be big and sink down a few lines.",
    "Can the first letter of my story stand out by sitting above the text?",
    "I want the first letter of my content to be white inside a colored square."
   ]
  },
  "contrast_audit": {
   "type": "object",
   "description": "WCAG 2.1 contrast audit with the maths baked in: for each foreground/background pair the renderer computes the relative luminance and contrast ratio, shows a live sample swatch, and badges AA (4.5:1), AA large (3:1) and AAA (7:1) as pass or fail. Failing pairs get the nearest passing colour, found by mixing the foreground toward black or white in 5% steps until it clears AA. A summary line counts the passes. For an agent composing a surface this is the difference between \"looks fine\" and \"is readable\". No JavaScript; light or dark.",
   "properties": {
    "component": {
     "const": "contrast_audit"
    },
    "pairs": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {fg, bg, label?} (optional). Up to 12 pairs of \"#rrggbb\" colours; invalid pairs are dropped."
    },
    "fg": {
     "description": "\"#rrggbb\" (optional). Single-pair shorthand when pairs is absent."
    },
    "bg": {
     "description": "\"#rrggbb\" (optional). Single-pair shorthand when pairs is absent."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Label for the single-pair shorthand."
    },
    "show_fix": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Suggest the nearest passing foreground for failures. Default true."
    },
    "theme": {
     "description": "\"dark\" | \"light\"  (optional, default \"light\")"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "pdf",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "WCAG 2.1 contrast audit with the maths baked in: for each foreground/background pair the renderer computes the relative luminance and contrast ratio, shows a live sample swatch, and badges AA (4.5:1),",
   "x-intent-phrases": [
    "I need to see if my text is readable against different colors.",
    "Help me check if my button colors meet accessibility standards.",
    "I want to confirm my chosen color combinations are easy on the eyes."
   ]
  },
  "share_quote": {
   "type": "object",
   "description": "Displays a visually distinct callout showcasing a key phrase designed for social clipping.",
   "properties": {
    "component": {
     "const": "share_quote"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The impactful quote statement."
    },
    "author": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Optional attribution source."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Displays a visually distinct callout showcasing a key phrase designed for social clipping.",
   "x-intent-phrases": [
    "I need a way to highlight important quotes on my articles so readers can easily share them.",
    "My app has inspiring messages that users want to grab and post on their social media.",
    "Help me make impactful snippets of text stand out so people can copy and spread them."
   ]
  },
  "follow_cta": {
   "type": "object",
   "description": "Renders a banner encouraging readers to connect with official social channels.",
   "properties": {
    "component": {
     "const": "follow_cta"
    },
    "message": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Promotional copy driving user interactions."
    },
    "platform_links": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object. Platform name keys mapped to target URLs."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a banner encouraging readers to connect with official social channels.",
   "x-intent-phrases": [
    "I want to make sure people can easily find and subscribe to our brand's news on other platforms.",
    "We need a prominent spot to invite users to join our community on Twitter and Instagram.",
    "How can I get readers to follow our updates on our official Facebook page?"
   ]
  },
  "follow_button": {
   "type": "object",
   "description": "Displays a single button allowing a user to subscribe directly to a profile.",
   "properties": {
    "component": {
     "const": "follow_button"
    },
    "target_handle": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Handle identifier of target profile."
    },
    "platform": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string: twitter | github | linkedin. The platform."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Displays a single button allowing a user to subscribe directly to a profile.",
   "x-intent-phrases": [
    "I need a way for my users to easily subscribe to other users' content.",
    "Let me add a quick button for people to follow creators they like.",
    "Users should be able to instantly join a profile's updates with one click."
   ]
  },
  "reading_progress_bar": {
   "type": "object",
   "description": "Renders a horizontal visual bar tracking the reader's scroll completion depth within the article.",
   "properties": {
    "component": {
     "const": "reading_progress_bar"
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Hexadecimal or design utility color token for the bar."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a horizontal visual bar tracking the reader's scroll completion depth within the article.",
   "x-intent-phrases": [
    "I need to show users how far they've scrolled down this long page.",
    "Can I get a little bar at the top that fills up as they read?",
    "I want to give readers a visual cue of their progress through the content."
   ]
  },
  "table_of_contents": {
   "type": "object",
   "description": "Renders an active list directory of navigation links targeting main content sections.",
   "properties": {
    "component": {
     "const": "table_of_contents"
    },
    "headings": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. Structured items detailing section names and anchor tags."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders an active list directory of navigation links targeting main content sections.",
   "x-intent-phrases": [
    "I need a way for users to jump directly to different chapters in my long article.",
    "My app has many sections, and I want users to easily find the part they're looking for.",
    "Help me create a quick navigation sidebar for the different topics on this page."
   ]
  },
  "article_hero": {
   "type": "object",
   "description": "Renders a prominent visual header displaying title, metadata, and background cover imagery.",
   "properties": {
    "component": {
     "const": "article_hero"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Main showcase headline text."
    },
    "subtitle": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Optional accompanying summary text."
    },
    "image_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. URL to header background media."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a prominent visual header displaying title, metadata, and background cover imagery.",
   "x-intent-phrases": [
    "I need a big banner for my blog post with its title and a nice picture.",
    "Can I get a striking top section for my news story, showing the headline and date?",
    "We need a bold introduction for this feature article, including its name and a background image."
   ]
  },
  "scroll_to_top": {
   "type": "object",
   "description": "Renders an interactive button providing smooth automated viewport reset to page top.",
   "properties": {
    "component": {
     "const": "scroll_to_top"
    },
    "behavior": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string: smooth | auto. Scroll animation profile."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders an interactive button providing smooth automated viewport reset to page top.",
   "x-intent-phrases": [
    "I need a way for users to quickly get back to the start of long articles.",
    "Users are struggling to find the menu after scrolling down a lot.",
    "Make it easy for people to jump back to the top of the page after reading comments."
   ]
  },
  "article_series_nav": {
   "type": "object",
   "description": "Renders an organized multi-part sequence navigation panel mapping serial publication installments.",
   "properties": {
    "component": {
     "const": "article_series_nav"
    },
    "series_id": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Unique identifier of the series cluster."
    },
    "current_part": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer. Ordered index within series limits."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders an organized multi-part sequence navigation panel mapping serial publication installments.",
   "x-intent-phrases": [
    "I need a way to show users which part of a story they're reading and let them jump to others.",
    "Users need to easily see all the chapters in a series and navigate between them.",
    "I need to display a list of articles in order and highlight the current one."
   ]
  },
  "embed_codepen": {
   "type": "object",
   "description": "Renders an embedded interactive CodePen sandbox workspace within the document.",
   "properties": {
    "component": {
     "const": "embed_codepen"
    },
    "pen_id": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Alphanumeric identity of the target snippet."
    },
    "user_handle": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Profile handle owning the snippet."
    },
    "url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. CodePen pen URL; '/embed/result' is appended to form the iframe source."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "Renders an embedded interactive CodePen sandbox workspace within the document.",
   "x-intent-phrases": [
    "I need to showcase a live coding example that users can play with.",
    "We want to let our users see and modify real-time demos of our features.",
    "Show them how a specific design pattern looks and works right here."
   ]
  },
  "embed_stackblitz": {
   "type": "object",
   "description": "Renders an integrated live development engine frame executing StackBlitz workspace code.",
   "properties": {
    "component": {
     "const": "embed_stackblitz"
    },
    "project_id": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Folder identity indicator for active workspace."
    },
    "url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Direct URL to the StackBlitz project, displayed inside an iframe."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "Renders an integrated live development engine frame executing StackBlitz workspace code.",
   "x-intent-phrases": [
    "I need to show a working example of our new feature directly on the page.",
    "We want users to be able to experiment with our code snippets instantly.",
    "Let's embed an interactive coding sandbox for our documentation."
   ]
  },
  "embed_gist": {
   "type": "object",
   "description": "Displays an inline styled snippet view of remote code from GitHub Gists.",
   "properties": {
    "component": {
     "const": "embed_gist"
    },
    "gist_id": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Hexadecimal identifier for target file fragments."
    },
    "url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Gist URL; '.js' is appended for the embed script, and the plain URL is the no-script fallback link."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "Displays an inline styled snippet view of remote code from GitHub Gists.",
   "x-intent-phrases": [
    "I need to show a specific piece of code from GitHub so users can see it directly on my page.",
    "My app needs to embed a code example from a shared snippet without leaving the current site.",
    "Can I display a working code demo hosted on GitHub right within my application's interface?"
   ]
  },
  "embed_tweet": {
   "type": "object",
   "description": "Displays a fully rendered standalone publication card containing Twitter status data.",
   "properties": {
    "component": {
     "const": "embed_tweet"
    },
    "tweet_id": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Unique snowflake identifier for the post."
    },
    "url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Destination link URL rendered on the author handle."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Displays a fully rendered standalone publication card containing Twitter status data.",
   "x-intent-phrases": [
    "I need to show a specific conversation from Twitter on my site.",
    "My users need to see and interact with a particular public post.",
    "I want to embed a news update that originally appeared on Twitter."
   ]
  },
  "embed_google_slides": {
   "type": "object",
   "description": "Renders an interactive presentation iframe viewer loading Google Slides resources.",
   "properties": {
    "component": {
     "const": "embed_google_slides"
    },
    "presentation_id": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Asset identifier for the slide file."
    },
    "url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Google Slides URL shown in an iframe; a '/pub?' link is rewritten to '/embed?'."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "Renders an interactive presentation iframe viewer loading Google Slides resources.",
   "x-intent-phrases": [
    "I need to show product demos directly in my app without users leaving.",
    "We need a way to embed training materials that update easily.",
    "Our users should be able to view sales decks from within their account."
   ]
  },
  "lottie_animation": {
   "type": "object",
   "description": "Renders an active vector illustration display controlled via Lottie runtime rules.",
   "properties": {
    "component": {
     "const": "lottie_animation"
    },
    "src_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Direct reference path to remote asset configuration."
    },
    "loop": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean. Whether playback recreates endlessly."
    },
    "url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. URL of the Lottie animation JSON asset to display."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "Renders an active vector illustration display controlled via Lottie runtime rules.",
   "x-intent-phrases": [
    "I need a smooth, engaging loading spinner that looks like a bouncing ball.",
    "Can I show a playful animated character reacting to user input?",
    "I want a dynamic, looping graphic to guide users through a complex process."
   ]
  },
  "figma_embed": {
   "type": "object",
   "description": "Renders a real-time collaborative preview referencing explicit Figma design canvas artboards.",
   "properties": {
    "component": {
     "const": "figma_embed"
    },
    "embed_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Absolute sharing path generated by Figma."
    },
    "url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Figma file or prototype URL, encoded into the embed iframe source."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "Renders a real-time collaborative preview referencing explicit Figma design canvas artboards.",
   "x-intent-phrases": [
    "Show my users the latest version of the UI designs directly in the app.",
    "Let designers see their work integrated live within the product.",
    "Embed interactive mockups from our design tool for quick review."
   ]
  },
  "color_swatch_grid": {
   "type": "object",
   "description": "Displays a grid of color swatches with labels and hex values for design system palettes.",
   "properties": {
    "component": {
     "const": "color_swatch_grid"
    },
    "colors": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {name, hex}. Color entries to display."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Displays a grid of color swatches with labels and hex values for design system palettes.",
   "x-intent-phrases": [
    "I need a way to show off all the approved colors for our brand.",
    "We have a list of color codes, and I want to display them visually for easy selection.",
    "Show me a neat way to present our UI's color options with their names."
   ]
  },
  "live_demo_embed": {
   "type": "object",
   "description": "Embeds a live interactive demo or sandbox within the article.",
   "properties": {
    "component": {
     "const": "live_demo_embed"
    },
    "url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. URL of the live demo."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Display title."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "Embeds a live interactive demo or sandbox within the article.",
   "x-intent-phrases": [
    "I need to show users how to use my new feature right here in the docs.",
    "Can I put a working example of my code snippet directly on the page?",
    "I want to let readers try out this design concept without leaving the article."
   ]
  },
  "benchmark_comparison": {
   "type": "object",
   "description": "Side-by-side performance benchmark visualization comparing multiple implementations.",
   "properties": {
    "component": {
     "const": "benchmark_comparison"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {label, value}. Benchmark entries."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Side-by-side performance benchmark visualization comparing multiple implementations.",
   "x-intent-phrases": [
    "I need to show how fast my new feature is compared to the old one.",
    "Help me visualize which of these coding approaches runs the quickest.",
    "I want to present the speed test results for different versions of our service."
   ]
  },
  "chartjs_bar": {
   "type": "object",
   "description": "Draws a static, accessible bar chart as HTML (no script, no chart library) from labels and datasets, in grouped, stacked, relative or overlaid bars, vertical or horizontal, negative values, a linear or log value axis, d3 number formats, optional value labels and a legend. Series differ by fill pattern as well as colour, and a hidden table holds every value.",
   "properties": {
    "component": {
     "const": "chartjs_bar"
    },
    "labels": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of strings. Category labels (up to 40 drawn; the hidden table lists all)."
    },
    "datasets": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {label, data, color}. One series each (up to 8 drawn); data is numbers, anything else is skipped with a note; color is an optional"
    },
    "mode": {
     "description": "group (default) | stack | relative | overlay. stack adds the signed values; relative stacks positives up and negatives down separately; overlay draws every series on the baseline."
    },
    "orientation": {
     "description": "v (default) | h."
    },
    "show_values": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean. Value labels on the bars; they hide when the chart is too narrow to fit them (the table keeps every value)."
    },
    "value_format": {
     "description": "d3-format string for the value labels, for example ',.0f' or '.1%'. Types b c o p r x X are not supported."
    },
    "y_format": {
     "description": "d3-format string for the axis labels (and the value labels when value_format is absent)."
    },
    "y_scale": {
     "description": "linear (default) | log. A log axis ticks at powers of ten, leaves out numbers that are not above zero (with a note) and cannot stack."
    },
    "y_range": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of two numbers, min then max. Fixes the value axis; bars past it are cut at the axis with a note."
    },
    "y_ticks": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer 2 to 12 (default 5). Target tick count."
    },
    "y_reverse": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean. Reverse the value axis."
    },
    "gap": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number 0 to 0.8 (default 0.3). Share of each category slot left empty."
    },
    "legend_position": {
     "description": "top | bottom | right | none. Default top with more than one series, none otherwise."
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1). Only version 1 exists; a higher whole number is drawn as version 1 with a note."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Draws a static bar chart (no interactivity, no Chart.js) from labels and datasets. A phrase like 'how much you could save', describing one comparison figure rather than a full dataset, usually means actual_vs_estimate, metric_comparison_card, or stat_card, not this -- chartjs_bar is for a chart with several data points. If the request describes a single number or one comparison rather than a visual chart with axes and multiple data points, it is NOT this -- chartjs_bar needs an explicit request for a bar chart or graph.",
   "x-intent-phrases": [
    "I need to show sales figures over time with distinct categories.",
    "How can I visualize user engagement by feature in our app?",
    "We want to compare performance metrics across different marketing campaigns.",
    "Break a total down by team, month or category so the biggest part stands out.",
    "Compare spend or counts across several groups."
   ]
  },
  "chartjs_line": {
   "type": "object",
   "description": "Renders an interactive line chart using Chart.js for time-series or trend data.",
   "properties": {
    "component": {
     "const": "chartjs_line"
    },
    "labels": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of strings. X-axis labels."
    },
    "datasets": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {label, data}. Chart datasets."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Heading of the chart. With series it is drawn above the plot; the labels/datasets drawing in the web preview does not show it (the Apps Script renderer does)."
    },
    "series": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "(optional, preview) array of up to 8 series {label, x, y, mode, color, dash, shape, size, symbol, fill, text}. x is numbers or ISO 8601 date strings (UTC; a missing x is the index 0, 1, 2...), y numbers. mode lines|markers|lines+markers|text or any + combination (default lines+markers up to 20 points, else lines). color a #hex or colour word, else the theme palette. dash solid|dash|dot|dashdot|longdash|longdashdot, symbol circle|square|diamond|triangle-up|cross|x (both cycle per series when unset, so series differ by more than colour). shape linear|spline|hv|vh|hvh|vhv. size a diameter number or an array per point (bubble). fill tozeroy|tonexty. text an array of point labels. Present and non-empty, this replaces the labels/datasets (or data_points) drawing; absent, nothing changes."
    },
    "x_type": {
     "description": "(optional, with series) linear or date. Default: date when the first x is a date string, else linear."
    },
    "x_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, with series). Axis title under the plot. scatter_trend also reads label_x."
    },
    "y_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, with series). Axis title above the plot. scatter_trend also reads label_y."
    },
    "max_points": {
     "description": "(optional, with series) integer 50 to 2000, default 2000. A series with more usable points is thinned to evenly spaced points (first and last kept) and a visible note says so; the hidden table lists the drawn points. This is the scattergl case: many points, a cap, never a silent drop."
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1). A whole number above 1 draws as version 1 with a note."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders an interactive line chart using Chart.js for time-series or trend data.",
   "x-intent-phrases": [
    "I need to show how my user's activity levels change over the past month.",
    "Can I visualize the sales performance for our products over several quarters?",
    "I want a graph that tracks a key metric's progress and fluctuations day-by-day."
   ]
  },
  "data_table_sortable": {
   "type": "object",
   "description": "Renders a data table with client-side column sorting and optional pagination.",
   "properties": {
    "component": {
     "const": "data_table_sortable"
    },
    "headers": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of strings. Column headers."
    },
    "rows": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of arrays. Table rows."
    },
    "select_state": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "(wired dialect only) ValueStore id holding the array of selected row ids. Combine with a column whose key is _select to get a per-row checkbox; each row needs a real id field to be selectable."
    },
    "select_count_state": {
     "description": "(wired dialect only) companion ValueStore id holding the selected array's length — wire a NumericThreshold to it to show/hide a bulk action bar."
    },
    "delete_action_id": {
     "description": "(wired dialect only) action id to run for row deletion. A column whose key is _delete renders a per-row delete button that sets select_state to just that row's id and runs this action directly; the same action id can be targeted by an external Delete-N-selected button via the standard collect wiring, ids from select_state's value."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-aliases": [
    "data_table"
   ],
   "x-routing-text": "Renders a data table with client-side column sorting and optional pagination.",
   "x-intent-phrases": [
    "I need a way to quickly reorder rows by clicking column headers.",
    "Users must be able to flip through pages of results without reloading.",
    "I want to show a lot of information in a table that's easy to scan and filter.",
    "Let people sort accounts, cases or invoices by date, amount or priority.",
    "Show open work with a deadline column so the earliest can be seen first.",
    "A sortable set of records with several fields per row, such as customers or vehicles."
   ]
  },
  "metric_comparison_card": {
   "type": "object",
   "description": "Card comparing a current metric value against a previous period with delta indicator.",
   "properties": {
    "component": {
     "const": "metric_comparison_card"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Metric name."
    },
    "value": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number. Current value."
    },
    "previous": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number. Previous period value."
    },
    "lower_is_better": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional, default true). Which direction is GOOD, which decides whether the delta is green or red. Defaults to true because this card was written for response times; set false for traffic, revenue or any metric where a rise is the good outcome."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Card comparing a current metric value against a previous period with delta indicator.",
   "x-intent-phrases": [
    "I need to show users how their sales this month are doing compared to last month.",
    "Can I display website traffic changes from last week to this week?",
    "I want to track how many new sign-ups we got this quarter versus the last one."
   ]
  },
  "mini_sparkline_set": {
   "type": "object",
   "description": "Compact grid of multiple labeled sparklines for at-a-glance multi-metric comparison.",
   "properties": {
    "component": {
     "const": "mini_sparkline_set"
    },
    "series": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {label, data}. Sparkline series."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Compact grid of multiple labeled sparklines for at-a-glance multi-metric comparison.",
   "x-intent-phrases": [
    "I need to see how a few key numbers are trending over time for each of my customers, all on one screen.",
    "Show me mini graphs for our top sales metrics side-by-side for quick review.",
    "I want a small, visual summary of recent performance for each project I'm tracking."
   ]
  },
  "status_dashboard": {
   "type": "object",
   "description": "Compact grid showing live operational status of multiple services with color indicators.",
   "properties": {
    "component": {
     "const": "status_dashboard"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Heading shown in the overall-status banner."
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {name, status, description?}. status is one of operational | degraded | outage | maintenance; the banner rolls up to the worst status."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Compact grid showing live operational status of multiple services with color indicators.",
   "x-intent-phrases": [
    "I need to see at a glance if all our critical systems are up and running.",
    "Show me a quick overview of every service's health status on one screen.",
    "I want a simple way to check the current state of our infrastructure without digging deep."
   ]
  },
  "uptime_timeline": {
   "type": "object",
   "description": "Visual timeline of service uptime over a rolling window with per-day status blocks.",
   "properties": {
    "component": {
     "const": "uptime_timeline"
    },
    "uptime": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number. Uptime percentage (0–100)."
    },
    "days": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {status, date?}. Daily entries drawn as one coloured block each (last 240 shown). Status 1 or true is green, 0.5 or more amber, below that red; date is the hover label. Plain status values are accepted."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Visual timeline of service uptime over a rolling window with per-day status blocks.",
   "x-intent-phrases": [
    "I need to see how reliable our service has been each day this week.",
    "Show me a visual overview of our system's availability for the past month.",
    "Can we get a daily breakdown of our application's uptime for the last 10 days?"
   ]
  },
  "command_palette": {
   "type": "object",
   "description": "Keyboard-driven command palette overlay for quick navigation and action execution.",
   "properties": {
    "component": {
     "const": "command_palette"
    },
    "commands": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {text, shortcut}. Available commands."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Keyboard-driven command palette overlay for quick navigation and action execution. Not for simple navigation to another page or view (use nav_link, cta_button, or pagination) - for a searchable list of commands or actions.",
   "x-intent-phrases": [
    "I need a way to quickly find and jump to any section or perform actions without using the mouse.",
    "Users should be able to access all app functions using just their keyboard for faster workflows.",
    "I want a searchable list of available commands that appears when a specific key combination is pressed."
   ]
  },
  "search_result_card": {
   "type": "object",
   "description": "Styled card displaying a single search result with title, snippet, and URL.",
   "properties": {
    "component": {
     "const": "search_result_card"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Result title."
    },
    "description": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Snippet text."
    },
    "url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Result URL."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Styled card displaying a single search result with title, snippet, and URL.",
   "x-intent-phrases": [
    "I need a box to show a found webpage's title, a bit of its text, and its web address.",
    "Show me how to display one item from my search list, including its name, a preview, and where it lives online.",
    "I want to put a single search hit on the screen, with its heading, a summary, and its link."
   ]
  },
  "post_metadata_bar": {
   "type": "object",
   "description": "Displays article metadata — author, publish date, read time, and optional tags — in a compact bar.",
   "properties": {
    "component": {
     "const": "post_metadata_bar"
    },
    "author": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Author display name."
    },
    "date": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Publish date (YYYY-MM-DD)."
    },
    "readTime": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer. Estimated read time in minutes."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Displays article metadata — author, publish date, read time, and optional tags — in a compact bar.",
   "x-intent-phrases": [
    "I need a spot to show who wrote this and when it came out, nice and small.",
    "Can I get a place for the estimated reading time and any relevant keywords?",
    "Need a compact area to display article details like author and publication date."
   ]
  },
  "footnote_group": {
   "type": "object",
   "description": "Renders a numbered list of footnotes at the bottom of an article or section.",
   "properties": {
    "component": {
     "const": "footnote_group"
    },
    "footnotes": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {id, text}. Footnote entries."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "email",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a numbered list of footnotes at the bottom of an article or section.",
   "x-intent-phrases": [
    "I need to add definitions for terms used in my article that appear at the end.",
    "My readers need quick access to the sources I cited for claims made in the text.",
    "I want to provide extra explanations for specific points without cluttering the main content."
   ]
  },
  "notification_badge": {
   "type": "object",
   "description": "Small badge overlaid on an icon or element to indicate unread count or alert state.",
   "properties": {
    "component": {
     "const": "notification_badge"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Badge label or count."
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Background colour (hex)."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Small badge overlaid on an icon or element to indicate unread count or alert state. A phrase like 'how many are left in a queue or sequence' usually means progress_bar, progress_circle, or step_progress, not this -- notification_badge is an unread-count marker overlaid on an icon.",
   "x-intent-phrases": [
    "I need to show users how many new messages they have.",
    "Can I put a little red dot next to an item to show it's important?",
    "How do I signal that there are updates waiting for them?"
   ]
  },
  "expandable_list": {
   "type": "object",
   "description": "Nested tree list where parent items expand to reveal children on click.",
   "properties": {
    "component": {
     "const": "expandable_list"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {text, children}. Tree nodes."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Nested tree list where parent items expand to reveal children on click.",
   "x-intent-phrases": [
    "I need a way to show a lot of related settings without overwhelming the user initially.",
    "How can I organize my product categories so users can drill down to specific items easily?",
    "I want to display a hierarchical structure of tasks, letting users see sub-tasks as they need them."
   ]
  },
  "poll_block": {
   "type": "object",
   "description": "Interactive poll with a question and vote-count bar for each option.",
   "properties": {
    "component": {
     "const": "poll_block"
    },
    "question": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Poll question."
    },
    "options": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {text, votes}. Poll choices."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Interactive poll with a question and vote-count bar for each option.",
   "x-intent-phrases": [
    "I need a way for users to quickly choose between a few options and see how popular each is.",
    "My users need to express their preferences and see the results of others' choices in real-time.",
    "I want to present a simple question with multiple answers and visually track which answer is winning."
   ]
  },
  "abbr_tooltip": {
   "type": "object",
   "description": "Inline abbreviation with a tooltip revealing the full expanded form on hover.",
   "properties": {
    "component": {
     "const": "abbr_tooltip"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The abbreviation to display."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The expanded full form."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Inline abbreviation with a tooltip revealing the full expanded form on hover.",
   "x-intent-phrases": [
    "I need a way to show the full meaning of acronyms without taking up too much space.",
    "Users need to see what short codes mean when they hover over them.",
    "How can I make technical jargon easier to understand on my site?"
   ]
  },
  "copy_to_clipboard": {
   "type": "object",
   "description": "Inline code or text element with a one-click copy button that provides feedback on success.",
   "properties": {
    "component": {
     "const": "copy_to_clipboard"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Display label."
    },
    "value": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Value copied to clipboard."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Inline code or text element with a one-click copy button that provides feedback on success.",
   "x-intent-phrases": [
    "I need users to be able to quickly grab this long URL.",
    "Make it easy for people to grab this code snippet.",
    "Help users copy this product ID without errors.",
    "Give the guest an entry code or booking reference they can copy with one tap.",
    "Show a discount code or account number with a button to copy it."
   ]
  },
  "conversion_funnel": {
   "type": "object",
   "description": "Renders a premium pipeline conversion funnel with tapered glowing step bars, percentage conversion rates, and leakage drop-off markers.",
   "properties": {
    "component": {
     "const": "conversion_funnel"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, e.g., 'Acquisition Funnel')"
    },
    "steps": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of dictionaries representing funnel stages: [{'stage': 'Visits', 'value': 10000}, {'stage': 'Signups', 'value': 4500}, ...]"
    },
    "shape": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, \"area\"): draws centred stacked bands whose area is proportional to each stage value (Plotly funnelarea) with a numbered legend and a hidden table; anything else keeps the tapered bars. Up to 12 stages."
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1). A whole number above 1 draws as version 1 with a muted note (area shape only)."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a premium pipeline conversion funnel with tapered glowing step bars, percentage conversion rates, and leakage drop-off markers.",
   "x-intent-phrases": [
    "Show me how many users move from seeing an ad to making a purchase.",
    "I need to visualize user progress through our signup flow.",
    "Display the drop-off points in our checkout process."
   ]
  },
  "gauge_sla": {
   "type": "object",
   "description": "Renders a semi-circular radial gauge track with high contrast status quadrants, a glowing needle tick, and a prominent central KPI readout.",
   "properties": {
    "component": {
     "const": "gauge_sla"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, e.g., 'API Response SLA')"
    },
    "value": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number representing current value (e.g., 99.4)"
    },
    "max_value": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number representing maximum gauge scale (e.g., 100)"
    },
    "unit": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, e.g., '%')"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, e.g., 'SLA Met')"
    },
    "min": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, default 0). Setting min or steps switches to the scale mode (Plotly indicator gauge) with bands, a threshold tick, a needle, a legend and a hidden table."
    },
    "steps": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list (optional) of {from, to, color} bands on the scale (up to 8); color is a hex or var(--token), default theme colours; each band is also listed in text."
    },
    "threshold": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Draws a tick and states whether the value is at or above it (scale mode only)."
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1). A whole number above 1 draws as version 1 with a muted note (scale mode only)."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a semi-circular radial gauge track with high contrast status quadrants, a glowing needle tick, and a prominent central KPI readout.",
   "x-intent-phrases": [
    "Show me how close we are to hitting our support response time goal.",
    "I need to see if our system uptime is meeting the target right now.",
    "Display our current customer satisfaction score against the benchmark."
   ]
  },
  "masonry_elevation": {
   "type": "object",
   "description": "Coursed block/brick wall elevation — draws courses bottom-up from wall-shape inputs (dimensions, per-block dimensions, course/per-course counts, bond pattern), with a running-bond half-unit stagger on alternate courses or none for stack bond. Draws the geometry itself from the given shape rather than taking a pre-computed rectangle list, so a caller only needs to hand it the same numbers a wall-calculation tool already produced.",
   "properties": {
    "component": {
     "const": "masonry_elevation"
    },
    "width_mm": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number. Actual built width in mm — the ROUNDED-to-whole-courses value (e.g. a calc tool's actual_w_mm), not the raw requested width, or the last partial course/column silently clips."
    },
    "height_mm": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number. Actual built height in mm, same rounding caveat as width_mm."
    },
    "unit_l_mm": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number. Per-block coordinating length in mm (block face length plus one mortar joint)."
    },
    "course_h_mm": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number. Per-course coordinating height in mm (block face height plus one mortar joint)."
    },
    "courses": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer. Number of courses (rows), bottom to top."
    },
    "per_course": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, echoed/validated only — width_mm/unit_l_mm already bound the draw loop)."
    },
    "pattern": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string, \"running\" (half-unit stagger on alternate courses) or \"stack\" (no stagger, default \"running\")."
    },
    "colour": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional hex, default"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional heading caption above the elevation)."
    },
    "stats_line": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional caption below the elevation, e.g. dimensions/ unit-count/weight summary — compose it from your calc result rather than having this atom re-derive display text)."
    },
    "render_style": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional), \"flat\" (solid fill, default), \"textured\" (alternating per-block shade for a material-variation look), or \"blueprint\" (dark ground, outline-only strokes, technical-drawing register)."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Coursed block/brick wall elevation — draws courses bottom-up from wall-shape inputs (dimensions, per-block dimensions, course/per-course counts, bond pattern), with a running-bond half-unit stagger on",
   "x-intent-phrases": [
    "I need to visualize custom brickwork patterns for my architectural designs.",
    "Show me how different block sizes and arrangements look on a wall.",
    "Can I see a realistic rendering of the brick courses from the ground up?"
   ]
  },
  "stacked_area": {
   "type": "object",
   "description": "A stacked area chart: one coloured layer per series, stacked on a zero baseline over an ordered x axis (time, stages, categories), so the top edge is the total and each layer's thickness is that series' value. Drawn as SVG with a zero-based value axis, a legend and a hidden data table. The optional offset turns it into a 100% share chart (expand), a centred chart (silhouette) or a streamgraph (wiggle). Before 2026-10-21 the default was a list of horizontal bars; layout 'bars' still draws that.",
   "properties": {
    "component": {
     "const": "stacked_area"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, e.g., 'SaaS Cumulative Workloads')"
    },
    "labels": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of strings representing X-axis ticks (e.g., ['Q1', 'Q2', 'Q3', 'Q4'])"
    },
    "series": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of dictionaries representing stacked layers: [{'label': 'Enterprise', 'data': [10, 25, 45, 60], 'color': '#00f2ff'}, ...]"
    },
    "layout": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, default 'area'): 'area' draws the stacked area chart (SVG, zero baseline, value axis). 'bars' draws a list of horizontal stacked bars, one row per label; that was the only drawing before 2026-10-21 and 'bars' keeps it unchanged. Absent, null or any other value means 'area'. The bar list ignores offset (a note says so when one is given)."
    },
    "offset": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, area layout only): how the layers sit on the baseline. Absent, 'none' or anything else is the plain zero baseline. 'expand' scales every point to 100% (a 0-100% axis), 'silhouette' centres the layers on a middle line, 'wiggle' is a streamgraph (d3's wiggle baseline, layers ordered inside-out). silhouette and wiggle have no value axis (the baseline means nothing); the hidden table lists the raw values. Up to 12 series and 60 labels; negative or non-numeric cells draw as 0 and are counted in a note."
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1). The stacked_area contract the payload was written for. Only version 1 exists; a higher whole number draws as version 1 with a note."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A stacked area chart: how several series add up to a total over time or across ordered stages, with each series as a coloured layer. Use offset 'expand' for shares of the whole and 'wiggle' for a streamgraph. Not for a single line (use a line or sparkline atom), not for unordered categories (use a bar chart) and not for a table of values.",
   "x-intent-phrases": [
    "I need to see how different user engagement metrics add up over time.",
    "Show me the total impact of each marketing channel on our sales funnel stages.",
    "Visualize the contribution of various income sources to our overall revenue growth."
   ]
  },
  "calibration_plot": {
   "type": "object",
   "description": "A reliability diagram plotting predicted probability against observed accuracy for one or more series, with a dashed diagonal reference line for perfect calibration and optional confidence-interval bars per point. Point radius can grow with sample size (`n`). Answers whether a model's own confidence scores are trustworthy, not just whether its answers are right.",
   "properties": {
    "component": {
     "const": "calibration_plot"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, e.g., 'Jev confidence calibration')"
    },
    "x_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, default 'Predicted probability')"
    },
    "y_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, default 'Observed accuracy')"
    },
    "series": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of {label: string, color: string (optional hex, auto-assigned otherwise), points: list of {predicted: number 0-1, observed: number 0-1, n: integer (optional sample size, grows point radius), ci_low: number (optional), ci_high: number (optional)}}"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"}
  },
  "scatter_trend": {
   "type": "object",
   "description": "Renders a coordinate scatter grid representing discrete data points intersected by a prominent glowing linear regression line.",
   "properties": {
    "component": {
     "const": "scatter_trend"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, e.g., 'CSAT vs. Support Response Time')"
    },
    "data_points": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of [x, y] coordinates: [[1.2, 95], [2.5, 88], [3.1, 75]]"
    },
    "label_x": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, e.g., 'Response Time (Hours)')"
    },
    "label_y": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, e.g., 'CSAT Score')"
    },
    "series": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "(optional, preview) array of up to 8 series {label, x, y, mode, color, dash, shape, size, symbol, fill, text}. x is numbers or ISO 8601 date strings (UTC; a missing x is the index 0, 1, 2...), y numbers. mode lines|markers|lines+markers|text or any + combination (default lines+markers up to 20 points, else lines). color a #hex or colour word, else the theme palette. dash solid|dash|dot|dashdot|longdash|longdashdot, symbol circle|square|diamond|triangle-up|cross|x (both cycle per series when unset, so series differ by more than colour). shape linear|spline|hv|vh|hvh|vhv. size a diameter number or an array per point (bubble). fill tozeroy|tonexty. text an array of point labels. Present and non-empty, this replaces the labels/datasets (or data_points) drawing; absent, nothing changes."
    },
    "x_type": {
     "description": "(optional, with series) linear or date. Default: date when the first x is a date string, else linear."
    },
    "x_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, with series). Axis title under the plot. scatter_trend also reads label_x."
    },
    "y_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, with series). Axis title above the plot. scatter_trend also reads label_y."
    },
    "max_points": {
     "description": "(optional, with series) integer 50 to 2000, default 2000. A series with more usable points is thinned to evenly spaced points (first and last kept) and a visible note says so; the hidden table lists the drawn points. This is the scattergl case: many points, a cap, never a silent drop."
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1). A whole number above 1 draws as version 1 with a note."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a coordinate scatter grid representing discrete data points intersected by a prominent glowing linear regression line.",
   "x-intent-phrases": [
    "Show me how my sales performance tracks over time, with a clear best-fit trend.",
    "I need to visualize the relationship between two measurements and see the general direction.",
    "Display these survey results as dots and highlight the overall pattern."
   ]
  },
  "call_mood_board": {
   "type": "object",
   "description": "Renders a premium, aesthetic call emotion summary and theme board showing detected sentiments, dominant moods with color codings, active themes, and word weightings.",
   "properties": {
    "component": {
     "const": "call_mood_board"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, e.g., 'Call Mood & Themes Summary')"
    },
    "moods": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of dictionaries representing call emotions: [{'mood': 'Collaborative', 'intensity': 85, 'color': '#10b981'}, ...]"
    },
    "themes": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of dictionaries representing keywords/themes: [{'term': 'Pricing', 'weight': 90, 'sentiment': 'neutral'}, ...]"
    },
    "summary": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional summary paragraph)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a premium, aesthetic call emotion summary and theme board showing detected sentiments, dominant moods with color codings, active themes, and word weightings.",
   "x-intent-phrases": [
    "I need to see the emotional tone of our customer feedback at a glance.",
    "Show me the main feelings and topics our users are talking about, visually.",
    "Help me understand the overall vibe of conversations and what's important to them."
   ]
  },
  "github_activity_grid": {
   "type": "object",
   "description": "Renders a high-fidelity SVG representation of a GitHub-style contribution activity calendar with colored commitment density blocks, total contributions, and streak statistics.",
   "properties": {
    "component": {
     "const": "github_activity_grid"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, e.g., 'GitHub Repository Activity')"
    },
    "username": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, e.g., 'curtiskrygier')"
    },
    "total_contributions": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, e.g., 342)"
    },
    "streak_days": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, e.g., 18)"
    },
    "activity": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of integers (0-4) or dictionary of weeks/days for rendering grid squares"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a high-fidelity SVG representation of a GitHub-style contribution activity calendar with colored commitment density blocks, total contributions, and streak statistics.",
   "x-intent-phrases": [
    "I need to show users their past coding engagement visually.",
    "Can I display a user's coding history like on GitHub?",
    "I want a calendar view of how often users commit code."
   ]
  },
  "form": {
   "type": "object",
   "description": "Form container with labelled field controls and explicit submit/cancel buttons. Fields are expressed as a list of {label, type, name, placeholder, options, rules} entries.",
   "properties": {
    "component": {
     "const": "form"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Form heading shown above fields."
    },
    "submit_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, default 'Submit'). Label for the primary submit button."
    },
    "cancel_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). If set, renders a secondary cancel button."
    },
    "fields": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{'type': 'array', 'items': {'label': 'string. Visible field label.', 'name': 'string. Field identifier used in form submission.', 'type': 'string. One of: text, email, password, number, url, textarea, select, radio, checkbox, switch, slider, date. Default: text.', 'placeholder': 'string (optional).', 'options': 'array of {value, label} (required for select, radio, checkbox types).', 'default_value': 'string | boolean | number (optional).', 'rules': \"array of strings (optional). Validation rules e.g. ['required', 'email', 'minLength:2'].\"}}"
    }
   },
   "required": [
    "component",
    "fields"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "degraded", "compose": "native"},
   "x-routing-text": "Form container with labelled field controls and explicit submit/cancel buttons. Fields are expressed as a list of {label, type, name, placeholder, options, rules} entries.",
   "x-intent-phrases": [
    "I need a way to collect user contact details with validation.",
    "We're building a settings page and need fields for preferences.",
    "I want to create a simple feedback submission area for users.",
    "Collect a few details from a customer, such as their name, a date and a preference, and submit them.",
    "Let someone request an appointment, a quote or a booking by filling in some fields.",
    "Capture a short set of inputs, like servings, quantity or budget, and act on them.",
    "Let a member sign up, change their details or make a request.",
    "Ask a few questions and record the answers."
   ]
  },
  "form_input": {
   "type": "object",
   "description": "Standalone labelled text input field — text, email, password, number, or url. Use inside a form atom or as a standalone search/filter control.",
   "properties": {
    "component": {
     "const": "form_input"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Visible label above the input."
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Field identifier."
    },
    "type": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). One of: text, email, password, number, url. Default: text."
    },
    "placeholder": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)."
    },
    "rules": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of strings (optional). e.g. ['required', 'email', 'minLength:2']."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-aliases": [
    "text_input"
   ],
   "x-routing-text": "Standalone labelled text input field — text, email, password, number, or url. Use inside a form atom or as a standalone search/filter control.",
   "x-intent-phrases": [
    "I need a place for users to type their email address to log in.",
    "I want a box where people can enter their search query.",
    "Let me add a field for users to input their phone number."
   ]
  },
  "form_select": {
   "type": "object",
   "description": "Labelled dropdown select with a list of value/label options. Supports required validation and an optional placeholder prompt.",
   "properties": {
    "component": {
     "const": "form_select"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Visible label."
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Field identifier."
    },
    "placeholder": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). e.g. 'Select an option…'"
    },
    "options": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{'type': 'array', 'description': 'List of {value, label} pairs.'}"
    },
    "rules": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of strings (optional). e.g. ['required']."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Labelled dropdown select with a list of value/label options. Supports required validation and an optional placeholder prompt.",
   "x-intent-phrases": [
    "I need a way for users to pick one option from a predefined list.",
    "We need a way to force users to choose something before they can proceed.",
    "Users should see a helpful hint about what to select before they click."
   ]
  },
  "form_radio_group": {
   "type": "object",
   "description": "Labelled group of radio buttons for single-option selection. Each option has a value, visible label, and optional description.",
   "properties": {
    "component": {
     "const": "form_radio_group"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Group label."
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Field identifier."
    },
    "options": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{'type': 'array', 'description': 'List of {value, label, description?} entries.'}"
    },
    "default_value": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Pre-selected option value. `selected_value` is accepted as a synonym — the renderer read only that spelling while this file documented only this one, so the documented prop pre-selected nothing until 2026-08-14."
    },
    "rules": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of strings (optional). e.g. ['required']."
    },
    "wired": {
     "description": "Carries `onChange` in the wired dialect, emitting the CHECKED option's value, and accepts a `value` wire that checks the matching option. The binding DELEGATES over the group rather than reading the first input, so N elements behave as one control. This is the single-select alternative to combobox for the case a dropdown gets wrong: few options, on a phone, where a dropdown costs two taps and a modal to answer a three-way question."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Labelled group of radio buttons for single-option selection. Each option has a value, visible label, and optional description.",
   "x-intent-phrases": [
    "I need a way for users to pick just one shipping speed from several choices.",
    "Users must select their preferred notification setting from a list of options.",
    "Let people pick their favorite color from a set of options on the signup form."
   ]
  },
  "form_checkbox_group": {
   "type": "object",
   "description": "Labelled group of checkboxes for multi-option selection. Each checkbox has a name, visible label, optional description, and optional default checked state.",
   "properties": {
    "component": {
     "const": "form_checkbox_group"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Group label."
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Aggregate field identifier for form submission."
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{'type': 'array', 'description': 'List of {name, label, description?, default_checked?} entries.'}"
    },
    "rules": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of strings (optional)."
    },
    "options": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of objects. Checkbox option objects containing name, label, optional description, and default_checked."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Labelled group of checkboxes for multi-option selection. Each checkbox has a name, visible label, optional description, and optional default checked state.",
   "x-intent-phrases": [
    "I need to let users pick multiple toppings for their pizza.",
    "Users should be able to select all the services they want to subscribe to.",
    "I want to offer a list of hobbies and let users pick several they enjoy."
   ]
  },
  "form_switch_group": {
   "type": "object",
   "description": "Group of named toggle switches — on/off controls with optional labels and descriptions. Suitable for settings panels, notification preferences, and feature flags.",
   "properties": {
    "component": {
     "const": "form_switch_group"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Section label above the switches."
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Aggregate field identifier."
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{'type': 'array', 'description': 'List of {name, label?, description?, default_checked?} entries.'}"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Group of named toggle switches — on/off controls with optional labels and descriptions. Suitable for settings panels, notification preferences, and feature flags.",
   "x-intent-phrases": [
    "I need a way for users to easily turn features on or off in their profile settings.",
    "Let people control which alerts they want to receive, with clear labels.",
    "We need a set of toggles for users to enable or disable specific app functionalities."
   ]
  },
  "form_slider": {
   "type": "object",
   "description": "Numeric range slider with a min, max, and optional step. Supports continuous (smooth) and discrete (stepped) variants. Renders a labelled track with a draggable thumb.",
   "properties": {
    "component": {
     "const": "form_slider"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Visible label above the slider."
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Field identifier."
    },
    "min": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number. Minimum value."
    },
    "max": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number. Maximum value."
    },
    "step": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Increment size. Omit for continuous."
    },
    "default_value": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Initial thumb position."
    },
    "variant": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). One of: continuous, discrete. Default: continuous."
    },
    "rules": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of strings (optional)."
    },
    "value": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer. Initial slider position, also shown as text with the unit; defaults to min."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Numeric range slider with a min, max, and optional step. Supports continuous (smooth) and discrete (stepped) variants. Renders a labelled track with a draggable thumb.",
   "x-intent-phrases": [
    "I need a way for users to pick a price between $50 and $500, with $25 increments.",
    "Let users set the volume from 0 to 100, but they can only select whole numbers.",
    "I want users to adjust the brightness of an image, smoothly from very dim to very bright."
   ]
  },
  "form_date_picker": {
   "type": "object",
   "description": "Date picker input supporting single-date selection or a date-range (start + end). Renders a calendar popover. Use inside a form or standalone.",
   "properties": {
    "component": {
     "const": "form_date_picker"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Visible label."
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Field identifier."
    },
    "mode": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). One of: single, range. Default: single."
    },
    "placeholder": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). e.g. 'Pick a date'."
    },
    "rules": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of strings (optional). e.g. ['required']."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Date picker input supporting single-date selection or a date-range (start + end). Renders a calendar popover. Use inside a form or standalone.",
   "x-intent-phrases": [
    "I need to let users pick a specific appointment day.",
    "My users must select a start and end date for their booking.",
    "I need a way to input dates for a report."
   ]
  },
  "modal": {
   "type": "object",
   "description": "Modal dialog overlay with a title, configurable size, and arbitrary content children. Opened programmatically or via a trigger button. Closes on X, Escape, or backdrop click.",
   "properties": {
    "component": {
     "const": "modal"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Modal heading."
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). One of: sm, md, lg. Default: md."
    },
    "children": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{'type': 'array', 'description': 'Content atoms to render inside the modal body.'}"
    },
    "trigger_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). If set, renders a button that opens the modal."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"},
   "x-routing-text": "Modal dialog overlay with a title, configurable size, and arbitrary content children. Opened programmatically or via a trigger button. Closes on X, Escape, or backdrop click.",
   "x-intent-phrases": [
    "I need a pop-up to confirm a user's important action.",
    "Show a detailed form for editing user preferences without leaving the page.",
    "Display a quick summary of search results in a separate window."
   ]
  },
  "follow_up_chips": {
   "type": "object",
   "description": "A row of tappable suggestion chips placed at the end of a response or slide, prompting the user with pre-written follow-up questions or actions. Each chip fires its text as a new user message when clicked.",
   "properties": {
    "component": {
     "const": "follow_up_chips"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{'type': 'array', 'description': \"List of suggestion strings. e.g. ['What's the ROI?', 'Show me by region', 'Compare to last year'].\"}"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Small heading above the chips. e.g. 'You might also ask:'"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A row of tappable suggestion chips placed at the end of a response or slide, prompting the user with pre-written follow-up questions or actions. Each chip fires its text as a new user message when cli",
   "x-intent-phrases": [
    "I need a quick way for users to ask the next logical question.",
    "Let users easily pick a suggested next step after getting information.",
    "How can I offer common replies so users don't have to type them?"
   ]
  },
  "choicebox_group": {
   "type": "object",
   "description": "Card-style option selector where each option renders as a full card with icon, title, and description. The entire card is the click target — richer than radio buttons. Inspired by Vercel Geist Choicebox. Ideal for plan selection, framework choice, and AI-generated setup wizards.",
   "properties": {
    "component": {
     "const": "choicebox_group"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Group heading above the cards."
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Form field name for the selected value(s)."
    },
    "multiple": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional, default false). If true allows multiple selections."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, default"
    },
    "submit_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). If set, renders a submit button below the cards."
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{'type': 'array', 'description': 'List of {value, title, description?, icon?, disabled?} entries.'}"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Card-style option selector where each option renders as a full card with icon, title, and description. The entire card is the click target — richer than radio buttons. Inspired by Vercel Geist Choiceb",
   "x-intent-phrases": [
    "I need a way for users to pick their preferred plan from a few distinct options, with visuals for each.",
    "Show users different service tiers with clear descriptions and let them tap anywhere on the card to select.",
    "My onboarding needs a visually appealing way for users to choose their primary role, with icons and text."
   ]
  },
  "feedback_prompt": {
   "type": "object",
   "description": "In-context feedback collection widget for rating content or AI response quality. Supports thumbs up/down or 1–5 star ratings with optional follow-up text. Inspired by Vercel Geist Feedback pattern.",
   "properties": {
    "component": {
     "const": "feedback_prompt"
    },
    "question": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Label text above the widget. e.g. \"Was this helpful?\""
    },
    "style": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). One of: thumbs | stars. Default: thumbs."
    },
    "placeholder": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Follow-up textarea placeholder shown after the rating buttons."
    },
    "action_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Endpoint for form POST on submit."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "In-context feedback collection widget for rating content or AI response quality. Supports thumbs up/down or 1–5 star ratings with optional follow-up text. Inspired by Vercel Geist Feedback pattern.",
   "x-intent-phrases": [
    "I need a quick way for users to tell me if an answer was helpful.",
    "How can I get users to rate how good the AI's suggestions are?",
    "I want a simple way to see if people like the content I'm showing them."
   ]
  },
  "entity_list": {
   "type": "object",
   "description": "List of named resources — each row shows an avatar or icon, a title, a subtitle, a status badge, and optional trailing metadata. Covers project lists, deployment rosters, and team member panels. Inspired by Vercel Geist Entity component.",
   "properties": {
    "component": {
     "const": "entity_list"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{'type': 'array', 'description': 'List of {name, subtitle?, icon?, status?, meta?} entries.'}"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-chat",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "List of named resources — each row shows an avatar or icon, a title, a subtitle, a status badge, and optional trailing metadata. Covers project lists, deployment rosters, and team member panels. Inspi",
   "x-intent-phrases": [
    "I need to show all my team's current projects, with who's assigned and their progress.",
    "Display all available servers, their health, and who's managing them, in a clear list.",
    "Show a list of all users on my platform, their roles, and their last login time.",
    "Show the clients, patients, cases or members someone looks after, one line each with a short detail and a status.",
    "List the books, orders, episodes or products with a small state or badge beside each.",
    "Show people or items with a name, a subtitle and where they stand."
   ]
  },
  "prompt_template": {
   "type": "object",
   "description": "Displays an LLM prompt with interpolation slots highlighted in a distinct colour. Includes an optional copy-to-clipboard button. Ideal for AI documentation, tutorials, and prompt engineering articles.",
   "properties": {
    "component": {
     "const": "prompt_template"
    },
    "template": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The prompt text containing {slot} placeholders."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, default"
    },
    "copyable": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional, default true). Show copy button."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Small label shown above the template block."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Displays an LLM prompt with interpolation slots highlighted in a distinct colour. Includes an optional copy-to-clipboard button. Ideal for AI documentation, tutorials, and prompt engineering articles.",
   "x-intent-phrases": [
    "I need to show users example AI instructions with parts they can change. Make those changeable parts stand out.",
    "Help users easily grab example AI commands to try out in their own projects.  They should be able to click a button to copy it.",
    "Let's display AI chatbot conversations where the user's input placeholders are visually different from the rest of the text."
   ]
  },
  "model_card": {
   "type": "object",
   "description": "AI model specification card showing model name, provider, context window, pricing tier, and a row of capability badges. First-class atom for AI-native content and agent documentation.",
   "properties": {
    "component": {
     "const": "model_card"
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Model display name, e.g. \"Claude Sonnet 4.6\"."
    },
    "provider": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Provider name, e.g. \"Anthropic\"."
    },
    "context_window": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). e.g. \"200 k tokens\"."
    },
    "pricing": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). e.g. \"$3 / M tokens in\"."
    },
    "capabilities": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{'type': 'array', 'description': 'List of short capability badge strings, e.g. [\"tool use\", \"vision\", \"streaming\"].'}"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, default #7c3aed). Accent colour for provider label and badges."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-chat",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "AI model specification card showing model name, provider, context window, pricing tier, and a row of capability badges. First-class atom for AI-native content and agent documentation.",
   "x-intent-phrases": [
    "I need to display information about different AI tools we integrate with, including who made them and how much they cost.",
    "Show me a clean way to present the specs of various AI services, like their input limits and pricing categories.",
    "I want a visual summary for each AI model we use, highlighting its features and provider details."
   ]
  },
  "conversation_snippet": {
   "type": "object",
   "description": "Renders a prompt-response pair as two chat bubbles — a user bubble on the right and an AI response bubble on the left. Ideal for showing LLM examples, chatbot flows, and agent interaction patterns in documentation.",
   "properties": {
    "component": {
     "const": "conversation_snippet"
    },
    "user_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, default \"You\"). Label above the user bubble."
    },
    "user": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The user prompt text."
    },
    "ai_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, default \"Assistant\"). Label above the AI bubble."
    },
    "response": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The AI response text."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, default"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-chat",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a prompt-response pair as two chat bubbles — a user bubble on the right and an AI response bubble on the left. Ideal for showing LLM examples, chatbot flows, and agent interaction patterns in",
   "x-intent-phrases": [
    "I need to show how our AI answers questions.",
    "Can we display sample chat dialogues clearly?",
    "Help me illustrate user and bot messages side-by-side."
   ]
  },
  "shortcut_legend": {
   "type": "object",
   "description": "Keyboard shortcut cheat-sheet grid. Multiple shortcuts displayed in a compact two-column layout, each showing the key combination and its action label. Distinct from keyboard_shortcut which shows a single combination inline.",
   "properties": {
    "component": {
     "const": "shortcut_legend"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Heading above the grid."
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{'type': 'array', 'description': 'List of {keys, action} entries. keys is an array of key strings e.g. [\"⌘\", \"K\"]. action is the human-readable description.'}"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-chat",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "native", "compose": "native"},
   "x-routing-text": "Keyboard shortcut cheat-sheet grid. Multiple shortcuts displayed in a compact two-column layout, each showing the key combination and its action label. Distinct from keyboard_shortcut which shows a si",
   "x-intent-phrases": [
    "I need a quick reference for all the commands so I don't forget them.",
    "Users need to see all the available hotkeys without scrolling too much.",
    "Show me a handy list of every keyboard trick I can use right now."
   ]
  },
  "rating_summary_bar": {
   "type": "object",
   "description": "Aggregate star-rating histogram showing the percentage breakdown per star level (5★ through 1★). Distinct from rating_stars which shows a single score — this shows the full distribution with bar lengths proportional to vote share.",
   "properties": {
    "component": {
     "const": "rating_summary_bar"
    },
    "average": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number. Overall average rating (e.g. 4.3)."
    },
    "total": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number. Total number of ratings."
    },
    "breakdown": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{'type': 'array', 'description': 'List of {stars, count} from 5 down to 1.'}"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, default"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-chat",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Aggregate star-rating histogram showing the percentage breakdown per star level (5★ through 1★). Distinct from rating_stars which shows a single score — this shows the full distribution with bar lengt",
   "x-intent-phrases": [
    "I need to see how many people gave 5 stars versus how many gave 1 star.",
    "Show me the complete picture of how users feel about this product, not just an average.",
    "I want to visualize the spread of all the ratings people have left."
   ]
  },
  "roadmap_card": {
   "type": "object",
   "description": "Quarter-based product roadmap showing milestones across Q1–Q4 or custom periods. Each period contains a list of items with a status indicator (done, in-progress, planned). Useful for product announcements and release planning slides.",
   "properties": {
    "component": {
     "const": "roadmap_card"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Heading above the roadmap."
    },
    "periods": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{'type': 'array', 'description': 'List of {label, items} where each item is {text, status}. status is one of done | in-progress | planned.'}"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-chat",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Quarter-based product roadmap showing milestones across Q1–Q4 or custom periods. Each period contains a list of items with a status indicator (done, in-progress, planned). Useful for product announcem",
   "x-intent-phrases": [
    "I need to show our team's progress on key features for the next year.",
    "We want to give stakeholders a clear view of upcoming development phases.",
    "Can we display what we're working on and what's coming up next, by quarter?"
   ]
  },
  "notification_stack": {
   "type": "object",
   "description": "Persistent notification inbox showing a list of notification items, each with an icon or emoji, a title, a body snippet, a timestamp, and an optional unread indicator dot. Distinct from toast_notification which is a transient single pop-up — the stack is a persistent grouped list.",
   "properties": {
    "component": {
     "const": "notification_stack"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Heading above the list, e.g. \"Notifications\"."
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{'type': 'array', 'description': 'List of {icon?, title, body?, time?, unread?} entries. unread is boolean, default false.'}"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-chat",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Persistent notification inbox showing a list of notification items, each with an icon or emoji, a title, a body snippet, a timestamp, and an optional unread indicator dot. Distinct from toast_notifica",
   "x-intent-phrases": [
    "I want a place to see all the alerts I've missed, not just the ones that pop up briefly.",
    "My users need a central hub to review important messages and updates from the app.",
    "Let's add a dedicated area where users can catch up on past system messages and announcements."
   ]
  },
  "inline_alert": {
   "type": "object",
   "description": "Compact inline-level alert embedded within content flow — an icon and short message that appears beside labels, form fields, or within paragraphs without disrupting layout. Distinct from alert_banner (full-width strip) and toast_notification (transient overlay).",
   "properties": {
    "component": {
     "const": "inline_alert"
    },
    "variant": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Severity — \"info\", \"success\", \"warning\" or \"error\". \"critical\" is accepted as a synonym for \"error\" (see alert_banner). NOT `type`, which is the block discriminator — a severity put there is ignored or replaces the atom name. Renderers read `variant`."
    },
    "message": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The alert text."
    },
    "detail": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). A secondary line of smaller detail text."
    },
    "icon": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Override the default icon for the severity type."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Compact inline-level alert embedded within content flow — an icon and short message that appears beside labels, form fields, or within paragraphs without disrupting layout. Distinct from alert_banner",
   "x-intent-phrases": [
    "I need to show a tiny warning next to an input field if it's filled incorrectly.",
    "Can I put a little note right after a heading to explain something briefly?",
    "I want to add a quick tip next to a button that explains what it does."
   ]
  },
  "tag_block": {
   "type": "object",
   "description": "Horizontal wrapping block of plain content tags — feature labels, category chips, or keyword pills. Neutral styling. Distinct from badge_group which carries semantic status colour. Adapted from the TagBlock pattern in OpenUI OUI benchmark samples.",
   "properties": {
    "component": {
     "const": "tag_block"
    },
    "tags": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of strings. The tag labels."
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Override chip accent — hex or CSS colour. Default is neutral gray."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Horizontal wrapping block of plain content tags — feature labels, category chips, or keyword pills. Neutral styling. Distinct from badge_group which carries semantic status colour. Adapted from the Ta",
   "x-intent-phrases": [
    "I need a way to show lots of related topics next to each other.",
    "How can I display multiple keywords for an article so they don't all get on one line?",
    "I want to list several categories for a product without them taking up too much vertical space."
   ]
  },
  "variant_selector": {
   "type": "object",
   "description": "CSS-only variant picker — each option is a selectable card with a label and optional description, rendered as hidden radio inputs with label:has(input:checked) styling. Used for product size, colour, or plan variant selection. Adapted from the RadioGroup/RadioItem pattern in OpenUI OUI benchmark samples.",
   "properties": {
    "component": {
     "const": "variant_selector"
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Form field name used in radio input group."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Group label shown above the options."
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{'type': 'array', 'description': 'List of {value, title, description?} option objects.'}"
    },
    "default_value": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Pre-selected option value."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "CSS-only variant picker — each option is a selectable card with a label and optional description, rendered as hidden radio inputs with label:has(input:checked) styling. Used for product size, colour,",
   "x-intent-phrases": [
    "I need a way for users to pick their shirt size from a row of clearly visible buttons.",
    "We need a visually appealing way for customers to choose product colors before adding to cart.",
    "My users need to easily select between different subscription plans with descriptive text for each."
   ]
  },
  "markdown_block": {
   "type": "object",
   "description": "Renders a Markdown string as formatted inline HTML - bold, italic, inline code and links (http, https, mailto, tel or relative). Block syntax (headings, lists, tables, fenced code) is not rendered. Adapted from the MarkDownRenderer pattern in OpenUI OUI benchmark samples.",
   "properties": {
    "component": {
     "const": "markdown_block"
    },
    "content": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The Markdown source string to render."
    },
    "variant": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). \"default\" (standard margins) or \"compact\" (tight spacing for dense layouts). Default is \"default\"."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"},
   "x-routing-text": "Renders a Markdown string as formatted inline HTML - bold, italic, inline code and links. Block syntax (headings, lists, tables, fenced code) is not rendered; use separate atoms for those.",
   "x-intent-phrases": [
    "I need to display user-submitted tips and tricks formatted nicely.",
    "Show me instructions with bullet points and bolding from an external source.",
    "Display forum posts with code snippets and links clearly."
   ]
  },
  "chartjs_pie": {
   "type": "object",
   "description": "Multi-slice pie or donut chart rendered as inline SVG — category proportions with a colour-coded legend. Distinct from donut_stat which shows a single metric as a CSS ring. Adapted from the PieChart/Slice pattern in OpenUI OUI benchmark samples.",
   "properties": {
    "component": {
     "const": "chartjs_pie"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Chart heading."
    },
    "variant": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). \"pie\" or \"donut\". Default \"donut\"."
    },
    "data": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{'type': 'array', 'description': 'List of {label, value} slice objects.'}"
    },
    "colors": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of strings (optional). Hex colours per slice; auto-assigned if omitted."
    },
    "show_legend": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional). Show colour-keyed legend below chart. Default true."
    },
    "show_labels": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional). Show percentage labels on slices. Default true."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Multi-slice pie or donut chart rendered as inline SVG — category proportions with a colour-coded legend. Distinct from donut_stat which shows a single metric as a CSS ring. Adapted from the PieChart/S",
   "x-intent-phrases": [
    "Show me how my budget is split across different spending categories.",
    "I need to visualize the market share for our top competitors.",
    "Display the breakdown of survey responses by answer choice."
   ]
  },
  "text_callout": {
   "type": "object",
   "description": "Compact tinted note or tip block used inline within cards, forms, or panels. Lighter than callout — no left-border accent, no icon; just a soft colour-tinted background with a small bold title above body text. Adapted from the TextCallout pattern in OpenUI OUI benchmark samples.",
   "properties": {
    "component": {
     "const": "text_callout"
    },
    "variant": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Display variant — \"info\", \"success\", \"warning\", \"neutral\"."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Short bold label (e.g. \"Tip\", \"Note\", \"Good to know\")."
    },
    "description": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Body text."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-chat",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Compact tinted note or tip block used inline within cards, forms, or panels. Lighter than callout — no left-border accent, no icon; just a soft colour-tinted background with a small bold title above b",
   "x-intent-phrases": [
    "I need a small, subtle hint to guide users on how to fill out this specific field.",
    "Can we add a brief explanation of why this option is recommended, right next to it?",
    "I want to highlight a quick tip about this section without being too intrusive."
   ]
  },
  "source_citation": {
   "type": "object",
   "description": "Inline-numbered RAG source reference card — shows a citation number, source title, optional excerpt, and optional URL. Designed to accompany AI-generated content that cites retrieved documents. Pairs with in-body superscript references [1], [2] etc. Original a2ui-catalogue atom.",
   "properties": {
    "component": {
     "const": "source_citation"
    },
    "sources": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{'type': 'array', 'description': 'List of {number, title, url?, excerpt?, author?, date?} citation objects.'}"
    },
    "heading": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Section heading above the list, e.g. \"Sources\"."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Inline-numbered RAG source reference card — shows a citation number, source title, optional excerpt, and optional URL. Designed to accompany AI-generated content that cites retrieved documents. Pairs",
   "x-intent-phrases": [
    "I need to show where my AI got its facts from, like footnotes.",
    "Can I add clickable links to the documents my AI used?",
    "How do I display little pop-up boxes with summaries of sources?"
   ]
  },
  "llm_comparison_table": {
   "type": "object",
   "description": "Side-by-side comparison of outputs from multiple language models for the same prompt — model name, output text, and optional latency/cost/token metadata per column. Designed for model evaluation, A/B testing, and capability demonstrations. Original a2ui-catalogue atom.",
   "properties": {
    "component": {
     "const": "llm_comparison_table"
    },
    "prompt": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). The shared input prompt shown above the comparison."
    },
    "models": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{'type': 'array', 'description': 'List of {name, output, latency_ms?, cost_usd?, tokens?} model result objects.'}"
    },
    "show_meta": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional). Show latency/cost/token row below each output. Default true if any model provides meta fields."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Side-by-side comparison of outputs from multiple language models for the same prompt — model name, output text, and optional latency/cost/token metadata per column. Designed for model evaluation, A/B",
   "x-intent-phrases": [
    "I need to see how different AI writing assistants perform on the same creative text prompt.",
    "Help me visually check which chatbot is faster and cheaper for customer service responses.",
    "Show me the actual text generated by several AI models for my app's content generation feature."
   ]
  },
  "confidence_bar": {
   "type": "object",
   "description": "Horizontal confidence or probability bar — shows a percentage value with a label and colour-coded fill indicating certainty level. Used for classification confidence, sentiment strength, retrieval relevance scores, or any normalised probability output. Original a2ui-catalogue atom.",
   "properties": {
    "component": {
     "const": "confidence_bar"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. What is being measured, e.g. Positive Sentiment or Retrieval Relevance."
    },
    "value": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number. Confidence percentage 0-100; a value in (0, 1] is read as a fraction (0.87 = 87%)."
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional). List of {label, value} for multi-row display instead of single bar."
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Override bar fill colour. Auto-assigned green/amber/red by value band if omitted."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Horizontal confidence or probability bar — shows a percentage value with a label and colour-coded fill indicating certainty level. Used for classification confidence, sentiment strength, retrieval rel",
   "x-intent-phrases": [
    "Show how sure the AI is about its answer.",
    "Visually represent the strength of a user's expressed feeling.",
    "Display how likely a search result is to be relevant."
   ]
  },
  "token_budget_meter": {
   "type": "object",
   "description": "Visual context-window usage meter — shows tokens consumed versus the model's total context limit, with a colour-coded fill that shifts amber then red as capacity is approached. Designed for AI agent dashboards, session monitoring, and prompt-engineering tooling. Original a2ui-catalogue atom.",
   "properties": {
    "component": {
     "const": "token_budget_meter"
    },
    "used": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer. Tokens consumed so far."
    },
    "total": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer. Model context window size, e.g. 200000."
    },
    "model": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Model name shown as subtitle, e.g. \"claude-sonnet-4-6\"."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Override the default \"Context window\" heading."
    },
    "warn_at": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Percentage threshold to shift to amber. Default 70."
    },
    "critical_at": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Percentage threshold to shift to red. Default 90."
    },
    "animate": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional). Count up from 0 to `used` using CSS @property animation. Bar grows in sync. Uses dark styling suited to Meet stage. Default false (static)."
    },
    "duration": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Animation duration in seconds when animate is true. Default 2.0."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Visual context-window usage meter — shows tokens consumed versus the model's total context limit, with a colour-coded fill that shifts amber then red as capacity is approached. Designed for AI agent d",
   "x-intent-phrases": [
    "I need to see how much memory the AI is using so I don't go over the limit.",
    "Show me a clear indicator of how close I am to the AI's maximum input size.",
    "I want a visual warning when the AI's conversation history gets too long."
   ]
  },
  "product_thumbnail": {
   "type": "object",
   "description": "Shopify Polaris-style product card showing optional image, title, vendor, SKU, price with optional compare-at strike-through, status badge, and tag chips. Adapted from Polaris ResourceItem + Thumbnail patterns.",
   "properties": {
    "component": {
     "const": "product_thumbnail"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Product display name."
    },
    "vendor": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Brand or supplier name."
    },
    "sku": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Stock-keeping unit code."
    },
    "price": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Formatted price, e.g. \"$49.00\"."
    },
    "compare_at_price": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Strike-through original price."
    },
    "status": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). One of active | draft | archived. Default active."
    },
    "image_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Product image URL."
    },
    "tags": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of strings (optional). Flat tag list rendered as chips."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Shopify Polaris-style product card showing optional image, title, vendor, SKU, price with optional compare-at strike-through, status badge, and tag chips. Adapted from Polaris ResourceItem + Thumbnail",
   "x-intent-phrases": [
    "I need a card to show off my new items with their price and a picture.",
    "Can I get a quick way to display products with their stock status and category tags?",
    "I want a visually appealing way to list my inventory, including discounts and brand info."
   ]
  },
  "order_status_card": {
   "type": "object",
   "description": "Shopify Polaris-style order summary card showing order number, date, fulfilment status badge, customer name, line item list, and total. Status is colour-coded — fulfilled (green), unfulfilled (amber), partial (blue), cancelled (red), refunded (grey). Adapted from Polaris Card + Badge patterns.",
   "properties": {
    "component": {
     "const": "order_status_card"
    },
    "order_number": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Order identifier, e.g. \"#1042\"."
    },
    "date": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Order date displayed next to the order number."
    },
    "status": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. One of fulfilled | unfulfilled | partial | cancelled | refunded."
    },
    "customer": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Customer display name."
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional). List of {title, qty, price} line items."
    },
    "total": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Formatted grand total, e.g. \"$124.00\"."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Shopify Polaris-style order summary card showing order number, date, fulfilment status badge, customer name, line item list, and total. Status is colour-coded — fulfilled (green), unfulfilled (amber),",
   "x-intent-phrases": [
    "I need to see a quick summary of recent customer orders.",
    "Show me what's still waiting to be shipped today.",
    "Display the important details for each purchase at a glance."
   ]
  },
  "inventory_table": {
   "type": "object",
   "description": "Shopify Polaris-style inventory management table showing SKU, product name, available quantity, committed quantity, and warehouse location per row. Rows with available stock below the optional threshold are highlighted amber as a low-stock warning. Adapted from Polaris DataTable patterns.",
   "properties": {
    "component": {
     "const": "inventory_table"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Table heading."
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. List of {sku?, product, available, committed?, location?, threshold?}. threshold triggers amber low-stock highlight when available < threshold."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Shopify Polaris-style inventory management table showing SKU, product name, available quantity, committed quantity, and warehouse location per row. Rows with available stock below the optional thresho",
   "x-intent-phrases": [
    "I need to see all my product stock levels at a glance, with warnings for low items.",
    "Show me a list of what's in stock, what's reserved, and where it's stored.",
    "Help me track my inventory and flag items that are running out quickly."
   ]
  },
  "jira_ticket": {
   "type": "object",
   "description": "Atlassian Design System Jira issue card showing issue key, type icon (bug/story/task/epic/subtask), one-line summary, status lozenge, priority indicator, assignee, optional description, and label chips. Adapted from Atlassian Design System Card + Lozenge patterns.",
   "properties": {
    "component": {
     "const": "jira_ticket"
    },
    "key": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Issue key, e.g. \"PROJ-123\"."
    },
    "issue_type": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). One of bug | story | task | epic | subtask. Default task."
    },
    "summary": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Issue title or one-line description."
    },
    "status": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Column name e.g. \"To Do\", \"In Progress\", \"Done\"."
    },
    "priority": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). One of highest | high | medium | low | lowest."
    },
    "assignee": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Assignee display name."
    },
    "description": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Short description or acceptance criteria."
    },
    "labels": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of strings (optional). Label chips shown below the description."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Atlassian Design System Jira issue card showing issue key, type icon (bug/story/task/epic/subtask), one-line summary, status lozenge, priority indicator, assignee, optional description, and label chip",
   "x-intent-phrases": [
    "I need to see a quick overview of all open bugs for my project.",
    "Show me what tasks are assigned to me with their current progress.",
    "Let's track the status of this big feature and its smaller parts."
   ]
  },
  "sprint_board": {
   "type": "object",
   "description": "Atlassian Design System Jira-style sprint board rendered as kanban columns. Each column has a name, ticket-count badge, and compact issue cards (key, summary, type icon, priority dot). Distinct from prerequisite_checklist which is a linear checklist. Adapted from Atlassian Design System Board patterns.",
   "properties": {
    "component": {
     "const": "sprint_board"
    },
    "sprint_name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Sprint label shown above the board."
    },
    "columns": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. List of {name, items[]} where each item is {key, summary, type?, priority?}."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Atlassian Design System Jira-style sprint board rendered as kanban columns. Each column has a name, ticket-count badge, and compact issue cards (key, summary, type icon, priority dot). Distinct from p",
   "x-intent-phrases": [
    "I need to see all my project tasks organized by their current status.",
    "Show me how many items are in each stage of our workflow.",
    "I want a clear overview of our team's progress on different tasks."
   ]
  },
  "lozenge": {
   "type": "object",
   "description": "Atlassian Design System semantic status pill with six strictly defined appearance variants — default (grey), success (green), removed (red), inprogress (blue), moved (yellow), new (teal). Uppercase rounded-rectangle label. Distinct from badge_group which uses arbitrary colours; lozenge maps to Jira/Confluence status semantics. Adapted from Atlassian Design System Lozenge component.",
   "properties": {
    "component": {
     "const": "lozenge"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The lozenge label (single lozenge mode)."
    },
    "appearance": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). One of default | success | removed | inprogress | moved | new. Default default."
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional). List of {text, appearance} for a row of multiple lozenges. Overrides single text/appearance fields."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Atlassian Design System semantic status pill with six strictly defined appearance variants — default (grey), success (green), removed (red), inprogress (blue), moved (yellow), new (teal). Uppercase ro",
   "x-intent-phrases": [
    "I need a way to visually flag urgent tasks in my project dashboard.",
    "Show me which items have been recently added so I can prioritize them.",
    "Highlight the completed actions clearly so everyone knows what's done."
   ]
  },
  "data_grid": {
   "type": "object",
   "description": "IBM Carbon Design System enterprise data grid with typed columns (string/number/status/tag), optional row-selection checkboxes, sortable column indicators, zebra-stripe rows, and optional pagination footer. More capable than table and data_table_sortable for enterprise data-dense layouts. Adapted from IBM Carbon DataTable patterns.",
   "properties": {
    "component": {
     "const": "data_grid"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Dark header bar above the grid."
    },
    "columns": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. List of {header, key, type?, sortable?}. type is one of string | number | status | tag."
    },
    "rows": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. List of row objects where each key matches a column key."
    },
    "selectable": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional). Show row-selection checkboxes. Default false."
    },
    "pagination": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (optional). '{per_page} splits rows into CSS-tab pages; clicking a page number label switches pages without JavaScript. Omit for single-page display.'"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "IBM Carbon Design System enterprise data grid with typed columns (string/number/status/tag), optional row-selection checkboxes, sortable column indicators, zebra-stripe rows, and optional pagination f",
   "x-intent-phrases": [
    "I need to show a long list of products with their prices and availability.",
    "My users need to pick multiple items from a table to perform an action.",
    "I want to let users easily reorder data by clicking on column headers.",
    "Show many records with several fields each in a compact grid, such as stock, staff or bookings.",
    "A dense overview of items with a handful of values per item.",
    "Show inventory, rosters or schedules as a large set of rows with several values each.",
    "A big collection of records the reader will scan and compare, such as stock levels by branch.",
    "Show every participant, match or lot with a few key values beside it."
   ]
  },
  "tree_view": {
   "type": "object",
   "description": "IBM Carbon Design System hierarchical tree for displaying recursive data structures — organisational charts, category hierarchies, nested permission models, BOM trees. More semantically general than file_tree which is file-system specific. Expanded/collapsed state set per node. Adapted from IBM Carbon TreeView component.",
   "properties": {
    "component": {
     "const": "tree_view"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Label above the tree panel."
    },
    "nodes": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. Recursive list of {label, icon?, expanded?, meta?, children?[]} node objects."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "IBM Carbon Design System hierarchical tree for displaying recursive data structures — organisational charts, category hierarchies, nested permission models, BOM trees. More semantically general than f A phrase like 'switch between separate facilities or locations' usually means combobox, tab_group, segmented_control, or form_select, not this -- tree_view is for a nested hierarchical structure like an org chart, not a flat set of options to switch between."
  },
  "heatmap_calendar": {
   "type": "object",
   "description": "IBM Carbon-inspired calendar heatmap showing activity density by date across one or more calendar months. Data is a list of date-value pairs; cells are coloured by intensity across a configurable colour scale. Distinct from heatmap (arbitrary x/y grid) and github_activity_grid (year-spanning GitHub-specific format). Adapted from IBM Carbon AI Applications data visualisation patterns.",
   "properties": {
    "component": {
     "const": "heatmap_calendar"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Heading above the calendar grid."
    },
    "data": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. List of {date, count} objects where date is \"YYYY-MM-DD\"."
    },
    "months": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Number of calendar months to render. Default 3."
    },
    "color_scale": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of strings (optional). CSS colours from empty to maximum density. Default IBM Carbon blue scale."
    },
    "unit": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Unit label appended to count in tooltips, e.g. \"commits\"."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "IBM Carbon-inspired calendar heatmap showing activity density by date across one or more calendar months. Data is a list of date-value pairs; cells are coloured by intensity across a configurable colo",
   "x-intent-phrases": [
    "I need to see how often users engage with the app each day over the past month.",
    "Show me my team's contribution levels throughout the year, with darker colors for busier days.",
    "I want to visualize my writing output over a six-month period to spot trends."
   ]
  },
  "combobox": {
   "type": "object",
   "description": "Searchable filterable dropdown that narrows its option list as the user types. Renders with a search icon, chevron, and an open option list for article preview. Native <datalist> enables browser-level autocomplete.",
   "properties": {
    "component": {
     "const": "combobox"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Visible label above the field."
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Field identifier."
    },
    "placeholder": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Input placeholder text."
    },
    "options": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {value, label} pairs."
    },
    "selected": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Pre-selected option value."
    },
    "rules": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of strings (optional). e.g. ['required']."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Searchable filterable dropdown that narrows its option list as the user types. Renders with a search icon, chevron, and an open option list for article preview. Native <datalist> enables browser-level",
   "x-intent-phrases": [
    "I need a way to quickly find and select from a very long list of items, like magazine titles.",
    "Help me type a few letters and see only the matching choices appear in a pop-up.",
    "I want to suggest possible article names as the user types them into a field."
   ]
  },
  "feature_grid": {
   "type": "object",
   "description": "A responsive CSS grid of feature tiles, each with an icon, title, and description paragraph. Supports 2 or 3 columns and optional per-tile badges. The canonical Tailwind UI marketing feature section pattern.",
   "properties": {
    "component": {
     "const": "feature_grid"
    },
    "heading": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Section heading above the grid."
    },
    "description": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Section sub-heading or intro paragraph."
    },
    "columns": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). 2 or 3. Default 3."
    },
    "features": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of objects with fields — icon (emoji or text), title, description, badge (optional short label), color (optional hex accent)."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A responsive CSS grid of feature tiles, each with an icon, title, and description paragraph. Supports 2 or 3 columns and optional per-tile badges. The canonical Tailwind UI marketing feature section p",
   "x-intent-phrases": [
    "I need a clean way to showcase our app's main benefits with icons and short text.",
    "Can we display our services in a visually appealing, organized grid that looks good on any device?",
    "Showcase our key features with distinct icons and brief explanations that users can quickly scan."
   ]
  },
  "navigation_menu": {
   "type": "object",
   "description": "Multi-level horizontal navigation bar with a brand/logo slot, top-level nav items, optional dropdown submenus, and a right-aligned CTA button. First item with children renders its submenu panel open for preview. Radix NavigationMenu pattern.",
   "properties": {
    "component": {
     "const": "navigation_menu"
    },
    "brand": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Brand name shown on the left."
    },
    "brand_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). URL for the brand link."
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of objects with — label, url, children (optional array of {label, url, description})."
    },
    "cta": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (optional). {label, url} for a right-aligned call-to-action button."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Multi-level horizontal navigation bar with a brand/logo slot, top-level nav items, optional dropdown submenus, and a right-aligned CTA button. First item with children renders its submenu panel open f A phrase like 'take the user directly to one specific button or section' usually means cta_button, link_button, or anchor_list, not this -- navigation_menu is a full site-wide bar with menus.",
   "x-intent-phrases": [
    "I need a way to show my company's logo and have links for the main sections of my site, with some links having extra options that appear when you hover over them.",
    "Our app needs a persistent header that displays our brand and a prominent 'Sign Up' button, with primary navigation links that expand to reveal more choices.",
    "I want a clean header for our dashboard with our logo, key features, and a quick action button on the right side, where some features have sub-options."
   ]
  },
  "multi_select_input": {
   "type": "object",
   "description": "Tag/chip style multi-value selector. Displays selected values as removable chips above a filtered option list. Shadcn multi-select pattern.",
   "properties": {
    "component": {
     "const": "multi_select_input"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Visible label above the field."
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Field identifier."
    },
    "placeholder": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Input placeholder when no chips are selected."
    },
    "options": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {value, label} pairs."
    },
    "selected": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of value strings. Pre-selected values shown as chips."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Tag/chip style multi-value selector. Displays selected values as removable chips above a filtered option list. Shadcn multi-select pattern.",
   "x-intent-phrases": [
    "I need to easily pick several options from a long list and see what I've chosen clearly.",
    "Help me select multiple tags for an item, with a way to remove them if I change my mind.",
    "I want to choose many categories for a product, and see them as little buttons that I can click to delete."
   ]
  },
  "otp_input": {
   "type": "object",
   "description": "One-time password entry field. Renders N individual digit boxes (default 6) with filled/unfilled visual state. Shadcn InputOTP pattern.",
   "properties": {
    "component": {
     "const": "otp_input"
    },
    "length": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Number of digit boxes. Default 6."
    },
    "value": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Pre-filled digits."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Visible label above the boxes."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "One-time password entry field. Renders N individual digit boxes (default 6) with filled/unfilled visual state. Shadcn InputOTP pattern.",
   "x-intent-phrases": [
    "I need a secure way for users to type in a code I send them.",
    "Let users enter verification numbers with a clean, focused interface.",
    "Make it easy for people to input their temporary access codes."
   ]
  },
  "skill_bars": {
   "type": "object",
   "description": "List of labeled horizontal progress bars — each with a fill percentage, optional sublabel, and per-bar color. Use for competency profiles, CV pages, feature comparison.",
   "properties": {
    "component": {
     "const": "skill_bars"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, default hex for all bars)"
    },
    "style": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, \"rounded\"|\"square\", default \"rounded\")"
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, bar height in px, default 10)"
    },
    "show_percent": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional, default true)"
    },
    "skills": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required, alias items). Each: {label, value (0–100, alias percent), color?, sublabel?}"
    }
   },
   "required": [
    "component",
    "skills"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "pdf",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "List of labeled horizontal progress bars — each with a fill percentage, optional sublabel, and per-bar color. Use for competency profiles, CV pages, feature comparison.",
   "x-intent-phrases": [
    "Show my coding languages and how proficient I am in each.",
    "Display how strong each of our product's features is compared to competitors.",
    "Visualize a job candidate's expertise level across different technical areas."
   ]
  },
  "icon_stat_row": {
   "type": "object",
   "description": "Horizontal strip of stats each with a large emoji icon above the number and a label below. More visual than metric_row — use when icons reinforce meaning.",
   "properties": {
    "component": {
     "const": "icon_stat_row"
    },
    "cols": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 4)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, default hex)"
    },
    "stats": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required, alias items). Each: {icon (emoji), value, label, prefix?, suffix?, sub?, accent?}"
    }
   },
   "required": [
    "component",
    "stats"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "pdf",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Horizontal strip of stats each with a large emoji icon above the number and a label below. More visual than metric_row — use when icons reinforce meaning.",
   "x-intent-phrases": [
    "Show me my current progress with big, fun symbols.",
    "I need to see my key stats at a glance, very visually.",
    "Display my achievements with clear icons and their numbers."
   ]
  },
  "color_section": {
   "type": "object",
   "description": "Renders child atom blocks inside a colored background container. Use to visually group content with tint, solid, or dark style.",
   "properties": {
    "component": {
     "const": "color_section"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex, default \"#4f46e5\")"
    },
    "style": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, \"tint\"|\"solid\"|\"dark\"|\"light\", default \"tint\")"
    },
    "padding": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, css, default \"24px\")"
    },
    "grid": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional, default false, added 2026-07-24). Layers a faint 32px graph-paper grid (tinted by accent) on top of the base colour — for technical/blueprint-style sections."
    },
    "max_width": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, css length/%, added 2026-07-24). Caps and centres the section (e.g. \"90%\") so a wide section doesn't run the full column width; omitted → full width."
    },
    "blocks": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required, atom blocks rendered inside)"
    }
   },
   "required": [
    "component",
    "blocks"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"},
   "x-routing-text": "Renders child atom blocks inside a colored background container. Use to visually group content with tint, solid, or dark style.",
   "x-intent-phrases": [
    "I need to visually separate the contact information from the main product details.",
    "Can we put a subtle background behind the user profile summary to make it stand out?",
    "I want to group the payment options with a darker shade so they are clearly distinct."
   ]
  },
  "tag_cloud": {
   "type": "object",
   "description": "Visual cloud of tags with variable font size based on weight. Heavier tags appear larger. Use for skill tags, topic clouds, keyword displays.",
   "properties": {
    "component": {
     "const": "tag_cloud"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, default hex)"
    },
    "min_size": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, minimum font size px, default 12)"
    },
    "max_size": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, maximum font size px, default 22)"
    },
    "tags": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required, alias items). Each: {label, weight? (default 1), color?} or plain string"
    }
   },
   "required": [
    "component",
    "tags"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "pdf",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Visual cloud of tags with variable font size based on weight. Heavier tags appear larger. Use for skill tags, topic clouds, keyword displays.",
   "x-intent-phrases": [
    "I need to show a bunch of skills, with the most important ones being more prominent.",
    "Help me visualize the trending topics on my site, making popular ones stand out.",
    "I want to display keywords from articles, with frequent terms appearing bigger."
   ]
  },
  "step_progress": {
   "type": "object",
   "description": "Horizontal step progress indicator with numbered circles and connecting lines. Completed steps show a tick. Use at the top of wizard or onboarding flows.",
   "properties": {
    "component": {
     "const": "step_progress"
    },
    "current": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (required, 1-based index of active step)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex, default \"#4f46e5\")"
    },
    "steps": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required). Array of {label or title}"
    }
   },
   "required": [
    "component",
    "current",
    "steps"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "pdf",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Horizontal row of numbered steps showing how far someone has got through a sequence, with a tick on each completed step. Suits a wizard, onboarding, or a fixed set of items worked through in order.",
   "x-intent-phrases": [
    "I need to show users how many stages are left in my signup process.",
    "How can I visually guide users through a multi-step setup for their account?",
    "Users need to see their progress through the application's tutorial steps.",
    "Show which step of a multi-step booking or onboarding flow the user is currently on."
   ]
  },
  "split_pane": {
   "type": "object",
   "description": "Two-panel split layout with distinct background colors per pane. Each pane renders atom blocks independently. Unlike columns, each side has its own background.",
   "properties": {
    "component": {
     "const": "split_pane"
    },
    "left": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object — {bg (css color, default \"#f8fafc\"), blocks (atom blocks)}"
    },
    "right": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object — {bg (css color, default \"#fff\"), blocks (atom blocks)}"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"},
   "x-routing-text": "Two-panel split layout with distinct background colors per pane. Each pane renders atom blocks independently. Unlike columns, each side has its own background.",
   "x-intent-phrases": [
    "I need to show code on one side and its output on the other, with clear visual separation.",
    "Users should see a list of items on the left and their details on the right, each with a different look.",
    "I want to display an image and its description side-by-side, with distinct styling for each part."
   ]
  },
  "gradient_hero": {
   "type": "object",
   "description": "Full-width light/pastel gradient hero with badge, large title, subtitle, and optional CTA. Pure CSS — no images. Works on all surfaces. Use when dark_hero is too heavy.",
   "properties": {
    "component": {
     "const": "gradient_hero"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required, alias heading)"
    },
    "subtitle": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, alias subtext)"
    },
    "badge": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, label above title)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex, default \"#4f46e5\")"
    },
    "accent2": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, second gradient hex, default \"#8b5cf6\")"
    },
    "gradient": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, css gradient override)"
    },
    "align": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, \"left\"|\"center\", default \"left\")"
    },
    "cta_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "cta_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    }
   },
   "required": [
    "component",
    "title"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "pdf",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Full-width light/pastel gradient hero with badge, large title, subtitle, and optional CTA. Pure CSS — no images. Works on all surfaces. Use when dark_hero is too heavy.",
   "x-intent-phrases": [
    "I need a bright, eye-catching banner at the top of my landing page.",
    "Can I get a soft, colorful section to introduce our new feature?",
    "I want a clean, inviting header for the sign-up flow, but not too dark."
   ]
  },
  "icon_list": {
   "type": "object",
   "description": "List of items each with a colored icon circle, label, and text. More visual than bullet_list. Use for feature lists, how-it-works, benefits.",
   "properties": {
    "component": {
     "const": "icon_list"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, default hex for all items)"
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, \"sm\"|\"md\"|\"lg\", default \"md\")"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required). Array of {icon (emoji), label (optional), text (optional), color (optional hex)}"
    }
   },
   "required": [
    "component",
    "items"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "pdf",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "List of items each with a colored icon circle, label, and text. More visual than bullet_list. Use for feature lists, how-it-works, benefits.",
   "x-intent-phrases": [
    "Show off the cool things my app does in a way that's more engaging than plain text.",
    "Explain the steps to use my service with clear, visual markers for each stage.",
    "Highlight the advantages of my product with eye-catching symbols for each point."
   ]
  },
  "highlight_box": {
   "type": "object",
   "description": "A visually rich highlighted box with gradient, solid, or outline style. Richer than callout — no severity system, pure design focus.",
   "properties": {
    "component": {
     "const": "highlight_box"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, markdown — renderer degrades to empty; provide title and/or text)"
    },
    "icon": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, emoji)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex, default \"#4f46e5\")"
    },
    "style": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, \"gradient\"|\"solid\"|\"outline\", default \"gradient\")"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "pdf",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A visually rich highlighted box with gradient, solid, or outline style. Richer than callout — no severity system, pure design focus.",
   "x-intent-phrases": [
    "I need a way to draw attention to important tips that don't fit a standard warning.",
    "Showcase featured content with a stylish, attention-grabbing background effect.",
    "Visually separate and emphasize key information blocks without using color codes."
   ]
  },
  "two_tone_card": {
   "type": "object",
   "description": "Card with a solid colored header section (title, subtitle, icon) and a white body that renders atom blocks. Clean, elegant container for any content.",
   "properties": {
    "component": {
     "const": "two_tone_card"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required)"
    },
    "subtitle": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "icon": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, emoji)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex, default \"#4f46e5\")"
    },
    "header_theme": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, \"light\"|\"dark\", default \"light\")"
    },
    "blocks": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional, atom blocks rendered in white body)"
    }
   },
   "required": [
    "component",
    "title"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Card with a solid colored header section (title, subtitle, icon) and a white body that renders atom blocks. Clean, elegant container for any content.",
   "x-intent-phrases": [
    "I need a way to highlight key information with a distinct header.",
    "Show me a clean section for presenting different pieces of data.",
    "I want a visually separated area for my important messages."
   ]
  },
  "metric_row": {
   "type": "object",
   "description": "Horizontal strip of static metrics — value, label, optional prefix/suffix and trend indicator. Cleaner than animated_counter for non-animated use.",
   "properties": {
    "component": {
     "const": "metric_row"
    },
    "cols": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 4)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, default hex for all metrics)"
    },
    "metrics": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required, alias items). Each item: {value, label, prefix?, suffix?, sub?, accent?, trend? (\"up\"|\"down\")}"
    }
   },
   "required": [
    "component",
    "metrics"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "pdf",
    "mcp-apps",
    "claude-code",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Horizontal strip of static metrics — value, label, optional prefix/suffix and trend indicator. Cleaner than animated_counter for non-animated use.",
   "x-intent-phrases": [
    "I need to show a list of key numbers with their names and whether they're going up or down.",
    "Displaying performance data like sales or user counts needs to be clear and concise, with optional units.",
    "Show important stats with their context and a quick visual cue for recent changes without animation.",
    "Give the headline figures for a shop, a clinic or a team at a glance: how many, how much, how long."
   ]
  },
  "numbered_list": {
   "type": "object",
   "description": "Numbered list with large decorative number backgrounds (\"large\" style), circular number badges (\"badge\" style), or bordered cards with a ghost-number, title, tag pills and body text (\"cards\" style, added 2026-07-24 for stage-by-stage architecture breakdowns). More visual than steps.",
   "properties": {
    "component": {
     "const": "numbered_list"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Ignored by the \"cards\" style."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex, default \"#4f46e5\")"
    },
    "theme": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, \"light\"|\"dark\", default \"light\"). \"cards\" style only."
    },
    "style": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, \"large\"|\"badge\"|\"cards\", default \"large\")"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required). For \"large\"/\"badge\" style, each item is {label (optional), text (optional)}. For \"cards\" style, each item is {number (optional, defaults to position), title, tags (optional, array of string), text}."
    }
   },
   "required": [
    "component",
    "items"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "pdf",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"},
   "x-routing-text": "Numbered list with large decorative number backgrounds (\"large\" style), circular number badges (\"badge\" style), or bordered cards with a ghost-number, title, tag pills and body text (\"cards\" style, ad",
   "x-intent-phrases": [
    "I need to show step-by-step instructions clearly on a website, with a big visual for each step.",
    "I'd like to highlight key takeaways in a blog post with distinct, numbered points.",
    "We need to present a series of features with their own descriptions and labels in a clean, organized way."
   ]
  },
  "page_header": {
   "type": "object",
   "description": "Full-width app-style page header with title, subtitle, icon, accent color, and optional tag badge. Sets the visual tone of a pop-up app or brief. Use as the first block of any page.",
   "properties": {
    "component": {
     "const": "page_header"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required, markdown)"
    },
    "subtitle": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, markdown)"
    },
    "icon": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, emoji or short text)"
    },
    "tag": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, badge label shown in accent pill)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex, default \"#4f46e5\")"
    },
    "theme": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, \"light\"|\"dark\", default \"light\")"
    },
    "background": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, css background override — now honoured in dark theme too, added 2026-07-24; previously silently discarded in favour of the dark default)"
    },
    "meta": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional, added 2026-07-24). Array of {label, value} shown as a small monospace stat row under the header — e.g. a title-block summary line for a reference/spec page."
    }
   },
   "required": [
    "component",
    "title"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "pdf",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Full-width app-style page header with title, subtitle, icon, accent color, and optional tag badge. Sets the visual tone of a pop-up app or brief. Use as the first block of any page.",
   "x-intent-phrases": [
    "I need a prominent bar at the top of my new screen to say what it's about, maybe with a little picture.",
    "Can I get a special colored stripe at the very top of my pop-up window with the main heading and a small identifier?",
    "I want to clearly label the start of each section in my app, with a title and a small visual cue."
   ]
  },
  "back_button": {
   "type": "object",
   "description": "Styled back navigation button. Links to a URL, a named page slug, or browser history. Three visual styles.",
   "properties": {
    "component": {
     "const": "back_button"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, default \"← Back\")"
    },
    "url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, href)"
    },
    "nav_slug": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, resolves to ?nav=<slug>)"
    },
    "style": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, \"ghost\"|\"outline\"|\"text\", default \"ghost\")"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex, default \"#4f46e5\")"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Styled back navigation button. Links to a URL, a named page slug, or browser history. Three visual styles.",
   "x-intent-phrases": [
    "I need a way to go back to the previous screen easily.",
    "Customers need to return to the main menu after viewing details.",
    "Provide a button to navigate to the settings page."
   ]
  },
  "section_break": {
   "type": "object",
   "description": "Labeled or plain section divider. Supports solid, dashed, or dotted line styles. With a label, renders text centered in the line (Notion-style).",
   "properties": {
    "component": {
     "const": "section_break"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, centered in divider line)"
    },
    "style": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, \"line\"|\"dashed\"|\"dots\", default \"line\")"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex line color, default \"#e5e7eb\")"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "pdf",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Labeled or plain section divider. Supports solid, dashed, or dotted line styles. With a label, renders text centered in the line (Notion-style).",
   "x-intent-phrases": [
    "I need a way to visually separate the 'About Us' and 'Contact' sections on my website's footer.",
    "Can I have a subtle horizontal line to break up the text in my long blog posts?",
    "I want to add a heading for the 'Featured Products' area that stands out with a border."
   ]
  },
  "chip_group": {
   "type": "object",
   "description": "Row of filter/tag chips, optionally scrollable. Chips can link to URLs and have active state.",
   "properties": {
    "component": {
     "const": "chip_group"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, group heading)"
    },
    "layout": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, \"wrap\"|\"scroll\", default \"wrap\")"
    },
    "same_tab": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional, default false). Chip links open in a new tab by default, which is right for OUTBOUND links from an embedded surface. Set this when the chips are navigation WITHIN one app — otherwise every tap leaves a tab behind, and four pages on a phone means four tabs."
    },
    "chips": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required). Array of {label, color? (hex), url? (href), active? (bool)}"
    }
   },
   "required": [
    "component",
    "chips"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Row of filter/tag chips, optionally scrollable. Chips can link to URLs and have active state.",
   "x-intent-phrases": [
    "I need a way to show a list of categories a user can tap to filter results.",
    "Let me display a set of selectable tags for product attributes, with scrolling if there are many.",
    "Show me a row of clickable items that highlight when selected, for navigating content sections."
   ]
  },
  "filterable_list": {
   "type": "object",
   "description": "A list of items, each with a title, an optional detail line and a status or category, above a row of chips (All plus one per status, with counts) that actually filter it. Tapping a chip shows only the matching rows and updates the \"Showing X of Y\" count. Self-contained, so it works without any other atom; on a static surface it degrades to the full list.",
   "properties": {
    "component": {
     "const": "filterable_list"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, heading above the list)"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required). Array of {title (or name), detail? (or subtitle), status? (or whichever field filter_field names), meta? (right-aligned small text), icon? (an emoji)}. Items with no value for the filter field show only under All."
    },
    "filter_field": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, default \"status\"). Which item field the chips filter on, e.g. \"category\" or \"assignee\"."
    },
    "filters": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional). Chips to show, as plain strings or {value, label?, color? (hex)}. Default: one chip per distinct value, in first-seen order."
    },
    "colors": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (optional). Map from a status or category value to a hex colour for its chip and row badge. Default: a distinct colour per chip."
    },
    "show_counts": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional, default true). Show how many rows each chip matches."
    },
    "empty_text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, shown when a filter matches nothing)"
    }
   },
   "required": [
    "component",
    "items"
   ],
   "x-surfaces": [
    "web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A list of items, each with a title, an optional detail line and a status or category, above a row of chips (All plus one per status, with counts) that actually filter it. Tapping a chip shows only the matching rows and updates the count. Self-contained, so it works without any other atom.",
   "x-intent-phrases": [
    "Show a list of support tickets that the reader can filter by open, pending or resolved.",
    "I need a task list with a chip for each status so the team can see only what is in progress.",
    "Let visitors browse our rental properties and narrow them to only the ones marked available."
   ]
  },
  "columns": {
   "type": "object",
   "description": "Generic multi-column layout container. Each column holds an array of atom blocks rendered inline. 2–6 columns; collapses to single column on mobile.",
   "properties": {
    "component": {
     "const": "columns"
    },
    "cols": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, 2–6, default 2)"
    },
    "gap": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, css gap value, default \"1.5rem\")"
    },
    "align": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, \"top\"|\"center\"|\"stretch\", default \"top\")"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required). Each item is {blocks: [atom blocks]} — one entry per column."
    }
   },
   "required": [
    "component",
    "items"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "pdf",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"},
   "x-routing-text": "Generic multi-column layout container. Each column holds an array of atom blocks rendered inline. 2–6 columns; collapses to single column on mobile.",
   "x-intent-phrases": [
    "I need to show featured products in three neat rows on desktop.",
    "Can I arrange my team's bios side-by-side on larger screens?",
    "How do I display key stats and their descriptions in a clean layout?"
   ]
  },
  "person_card": {
   "type": "object",
   "description": "Individual person card with name, role, optional photo, bio, tags, and contact links. Use inside a columns atom to build team rosters.",
   "properties": {
    "component": {
     "const": "person_card"
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required)"
    },
    "role": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "photo_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, URL)"
    },
    "bio": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, markdown)"
    },
    "email": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "linkedin": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, URL)"
    },
    "tags": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string[] (optional)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex, default \"#4f46e5\")"
    }
   },
   "required": [
    "component",
    "name"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "pdf",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Individual person card with name, role, optional photo, bio, tags, and contact links. Use inside a columns atom to build team rosters.",
   "x-intent-phrases": [
    "I need to display a list of our team members with their pictures and job titles.",
    "Showcase each project contributor with their expertise and how to reach them.",
    "Create a section for our company leaders, including their backgrounds and areas of focus."
   ]
  },
  "agenda_block": {
   "type": "object",
   "description": "Time-slotted schedule view for a day or event. Each slot has a time, title, optional speaker, location, type badge, and description.",
   "properties": {
    "component": {
     "const": "agenda_block"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "date": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex, default \"#4f46e5\")"
    },
    "slots": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required). Array of {time, title, speaker?, location?, type? (\"break\"|\"keynote\"|\"workshop\"|\"panel\"|\"social\"), description?}"
    }
   },
   "required": [
    "component",
    "slots"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Time-slotted schedule view for a day or event. Each slot has a time, title, optional speaker, location, type badge, and description.",
   "x-intent-phrases": [
    "I need to show people what's happening at our conference, hour by hour.",
    "How can I display my team's daily tasks with who's assigned and where they're located?",
    "I want a way to list out my event's program, including when each session starts and who's presenting."
   ]
  },
  "risk_flag": {
   "type": "object",
   "description": "Structured risk callout list with severity levels, description, and mitigation. For meeting prep, project status, incident reports.",
   "properties": {
    "component": {
     "const": "risk_flag"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "risks": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required). Array of {level (\"critical\"|\"high\"|\"medium\"|\"low\"), title, description?, mitigation?}"
    }
   },
   "required": [
    "component",
    "risks"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "pdf",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Structured risk callout list with severity levels, description, and mitigation. For meeting prep, project status, incident reports.",
   "x-intent-phrases": [
    "I need to show users critical issues and how to fix them.",
    "We need a clear way to highlight urgent project roadblocks.",
    "Help me display potential problems and their solutions for my team."
   ]
  },
  "action_items": {
   "type": "object",
   "description": "Action items table with owner, due date, and status. For retros, meeting notes, sprint planning, incident reports.",
   "properties": {
    "component": {
     "const": "action_items"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required). Array of {action, owner?, due?, status? (\"open\"|\"in_progress\"|\"done\")}"
    }
   },
   "required": [
    "component",
    "items"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "pdf",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Action items table with owner, due date, and status. For retros, meeting notes, sprint planning, incident reports.",
   "x-intent-phrases": [
    "I need a way to track tasks for our team meetings and assign who's responsible.",
    "Show me all outstanding work items for our next project kick-off, with deadlines.",
    "Let's list the key takeaways from our last incident and who needs to follow up.",
    "What should I do next? The most urgent things to deal with first.",
    "Anything that needs someone's attention this week."
   ]
  },
  "bento_grid": {
   "type": "object",
   "description": "Asymmetric CSS grid of feature tiles. First tile typically spans multiple columns for visual emphasis. Supports per-tile icons, titles, descriptions, and accent colors. MagicUI/shadcn bento pattern.",
   "properties": {
    "component": {
     "const": "bento_grid"
    },
    "heading": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Section heading above the grid."
    },
    "columns": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Number of grid columns. Default 3."
    },
    "tiles": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of objects with — title, subtitle, icon (emoji), span (integer, default 1; span 2 fills two columns), color (optional hex), background (optional hex)."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Asymmetric CSS grid of feature tiles. First tile typically spans multiple columns for visual emphasis. Supports per-tile icons, titles, descriptions, and accent colors. MagicUI/shadcn bento pattern.",
   "x-intent-phrases": [
    "I need a way to showcase my top 3 services prominently at the top of my landing page.",
    "How can I create a visually appealing dashboard section that highlights key metrics with little icons?",
    "I want a clean, modern look for my features section, with the first item standing out more."
   ]
  },
  "cta_section": {
   "type": "object",
   "description": "Full-width call-to-action banner with headline, body text, a primary button, and an optional secondary ghost button. Renders on a solid color background. Tailwind UI CTA section pattern.",
   "properties": {
    "component": {
     "const": "cta_section"
    },
    "heading": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Main headline."
    },
    "body": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Descriptive paragraph."
    },
    "primary_cta": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object. {label, url} for the primary action button."
    },
    "secondary_cta": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (optional). {label, url} for a ghost secondary button."
    },
    "background": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). CSS color for the banner background. Default"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Full-width call-to-action banner with headline, body text, a primary button, and an optional secondary ghost button. Renders on a solid color background. Tailwind UI CTA section pattern. A phrase like 'let the user save progress and continue to the next step' usually means cta_button, form, or link_button, not this -- cta_section is a full promotional banner block, not an inline in-flow action.",
   "x-intent-phrases": [
    "I need a big, bold banner to get people to sign up for our new feature.",
    "We want to highlight a limited-time offer and encourage immediate purchases.",
    "Let's add a prominent space to guide users to our main service page."
   ]
  },
  "animated_counter": {
   "type": "object",
   "description": "CSS @property counter animation that counts up from zero to target values without JavaScript. Uses @keyframes with CSS custom properties typed as integers. Each counter has a value, label, optional prefix/suffix, and color.",
   "properties": {
    "component": {
     "const": "animated_counter"
    },
    "counters": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of objects with — value (integer), label, prefix (optional), suffix (optional), color (optional hex)."
    },
    "duration": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Animation duration in seconds. Default 2."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "CSS @property counter animation that counts up from zero to target values without JavaScript. Uses @keyframes with CSS custom properties typed as integers. Each counter has a value, label, optional pr Not for a plain data summary (use stat_card or metric_row, which are cleaner for non-animated totals) - for a celebratory or attention-grabbing count-up moment.",
   "x-intent-phrases": [
    "I need a way to show a number smoothly increasing when a section scrolls into view.",
    "Can we have a visual indicator that shows how many users are currently online, animating up?",
    "I want to display progress on a task, with the count visibly growing to the final number."
   ]
  },
  "media_stream_card": {
   "type": "object",
   "description": "Auto-detecting media embed that accepts a raw URL and builds the correct iframe for YouTube, Loom, Google Slides, or Vimeo. Displays a labelled card shell with a skeleton shimmer while loading. Designed for stage-first delivery where the URL is the only payload.",
   "properties": {
    "component": {
     "const": "media_stream_card"
    },
    "url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). Raw URL — YouTube, Loom, Google Slides, Vimeo, or any embeddable URL. Platform is auto-detected."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Card label shown above the iframe. Defaults to detected platform name."
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). CSS height for the iframe container. Default 360px."
    }
   },
   "required": [
    "component",
    "url"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "Auto-detecting media embed that accepts a raw URL and builds the correct iframe for YouTube, Loom, Google Slides, or Vimeo. Displays a labelled card shell with a skeleton shimmer while loading. Design",
   "x-intent-phrases": [
    "I need to show videos from various platforms on a profile page.",
    "Can I embed presentations and tutorials easily into my help articles?",
    "We want a nice way to display shared videos in our team's dashboard."
   ]
  },
  "live_aggregator": {
   "type": "object",
   "description": "Comparative progress-bar display for real-time vote/response data. Accepts an items array of label+value pairs and renders normalised horizontal bars with optional value labels. Designed for stage-first delivery where items update incrementally via fiber.",
   "properties": {
    "component": {
     "const": "live_aggregator"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of objects — label (string), value (number), color (optional hex)."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Section heading above the bars."
    },
    "max_value": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Denominator for bar widths; auto-computed from max item value if omitted."
    },
    "show_values": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional). Show numeric value next to each bar. Default true."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Comparative progress-bar display for real-time vote/response data. Accepts an items array of label+value pairs and renders normalised horizontal bars with optional value labels. Designed for stage-fir",
   "x-intent-phrases": [
    "Show me how much of the audience agrees with each statement as we go.",
    "I need to see which answer is winning in real-time during the show.",
    "Can we visualize the percentage of people choosing each option live on screen?"
   ]
  },
  "vote_button_group": {
   "type": "object",
   "description": "Styled multi-option vote selector with three visual variants — pill (rounded filled), neon (dark with cyan glow), and default (flat bordered). Encodes the Cyberpunk Maverick voting pattern as a schema atom. CSS-only interactivity using checkbox/radio inputs.",
   "properties": {
    "component": {
     "const": "vote_button_group"
    },
    "options": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of objects — label (string), value (string), selected (boolean optional)."
    },
    "style": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). One of pill, neon, default. Default pill."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Section heading above the buttons."
    },
    "allow_multi": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional). Allow multiple selections. Default false."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Styled multi-option vote selector with three visual variants — pill (rounded filled), neon (dark with cyan glow), and default (flat bordered). Encodes the Cyberpunk Maverick voting pattern as a schema",
   "x-intent-phrases": [
    "I need a way for users to pick one of several options, with a cool glowing effect.",
    "We need a rounded button group for selecting a single preference on our signup form.",
    "Help me create a set of selectable buttons with a clean, outlined look for a survey."
   ]
  },
  "effect_overlay": {
   "type": "object",
   "description": "CSS-animated celebration overlay triggered by a named effect type. confetti fires falling coloured rectangles via keyframe animation. trophy bounces a large emoji with a scale-in animation. pulse radiates a glowing circle. fireworks scatters particles radially. Designed as a schema atom wrapper around the canvas particle blast used in Cyberpunk Maverick demos.",
   "properties": {
    "component": {
     "const": "effect_overlay"
    },
    "trigger": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). One of confetti, trophy, pulse, fireworks."
    },
    "status": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Small label shown above the effect (e.g. resolved, done)."
    },
    "message": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Text shown below the icon."
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Primary accent color for pulse effect. Default"
    }
   },
   "required": [
    "component",
    "trigger"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "CSS-animated celebration overlay triggered by a named effect type. confetti fires falling coloured rectangles via keyframe animation. trophy bounces a large emoji with a scale-in animation. pulse radi",
   "x-intent-phrases": [
    "I need a fun visual when a user completes a task.",
    "Can we add a celebratory sparkle for achieving a goal?",
    "I want a dynamic animation to highlight achievements."
   ]
  },
  "skeleton_stage_card": {
   "type": "object",
   "description": "Dark-themed shimmer skeleton loader for stage use while a playbook is processing. Four variants — card (avatar + text lines), list (avatar rows), media (image header + caption), chat (alternating message bubbles). All use a CSS linear-gradient shimmer animation with no JavaScript.",
   "properties": {
    "component": {
     "const": "skeleton_stage_card"
    },
    "variant": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). One of card, list, media, chat. Default card."
    },
    "lines": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Number of text lines or list rows to show. Default 3."
    },
    "count": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Number of skeleton cards to stack. Default 1."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "native", "compose": "native"},
   "x-routing-text": "Dark-themed shimmer skeleton loader for stage use while a playbook is processing. Four variants — card (avatar + text lines), list (avatar rows), media (image header + caption), chat (alternating mess",
   "x-intent-phrases": [
    "I need to show something while user data loads on their profile.",
    "My feed needs to look ready before the posts appear.",
    "Before the video plays, I want to hint at the video's layout."
   ]
  },
  "marquee_strip": {
   "type": "object",
   "description": "Infinite horizontally-scrolling strip of text labels or logo+text items, driven by a CSS @keyframes animation with no JavaScript. Ideal for customer logo rows, tech-stack badges, testimonial tickers, and social proof strips. Pause-on-hover is CSS-only.",
   "properties": {
    "component": {
     "const": "marquee_strip"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. Each item is a string or {text, image_url} object."
    },
    "speed": {
     "description": "\"slow\" | \"normal\" | \"fast\"  (optional, default \"normal\")"
    },
    "direction": {
     "description": "\"left\" | \"right\"  (optional, default \"left\")"
    },
    "pause_on_hover": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional, default true). Pause scroll on hover."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Small header label above the strip."
    },
    "gap": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). CSS gap between items. Default \"40px\"."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Infinite horizontally-scrolling strip of text labels or logo+text items, driven by a CSS @keyframes animation with no JavaScript. Ideal for customer logo rows, tech-stack badges, testimonial tickers,",
   "x-intent-phrases": [
    "I need a way to continuously show many client logos moving across the screen.",
    "We need a dynamic banner for our partner logos that scrolls endlessly.",
    "Showcase our supported technologies in a smooth, repeating horizontal display."
   ]
  },
  "typewriter_text": {
   "type": "object",
   "description": "Text that animates itself character by character using a CSS steps() width animation on a monospace element. A blinking cursor is included by default. Useful for hero hooks, slide reveals, and LLM demo showcases. No JavaScript required.",
   "properties": {
    "component": {
     "const": "typewriter_text"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The text to type out."
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Font size e.g. \"32px\". Default \"28px\"."
    },
    "weight": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Font weight e.g. \"700\". Default \"700\"."
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Text colour. Default \"#1a1a1a\"."
    },
    "speed": {
     "description": "\"slow\" | \"normal\" | \"fast\"  (optional, default \"normal\")"
    },
    "cursor": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Show blinking cursor. Default true."
    },
    "delay": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). CSS delay before typing starts. Default \"0s\"."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-side-panel",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Text that animates itself character by character using a CSS steps() width animation on a monospace element. A blinking cursor is included by default. Useful for hero hooks, slide reveals, and LLM dem",
   "x-intent-phrases": [
    "I need to make a welcome message appear word by word on my landing page.",
    "Show me how to reveal a chatbot's responses as if it's typing them out.",
    "I want a slogan to fade in, letter by letter, like an old-school movie intro."
   ]
  },
  "animated_border_card": {
   "type": "object",
   "description": "Card with a continuously rotating gradient border, created by a spinning conic-gradient pseudo-element — no JavaScript. Two accent colours blend through the border. Inner content area has a solid background. Ideal for highlighting key facts, announcements, or featured atoms in a catalogue.",
   "properties": {
    "component": {
     "const": "animated_border_card"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Card heading."
    },
    "body": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Card body content (markdown inline formatting supported)."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Primary border gradient colour. Default \"#38bdf8\"."
    },
    "accent2": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Secondary border gradient colour. Default \"#818cf8\"."
    },
    "background": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Inner card background colour. Default \"#ffffff\"."
    },
    "speed": {
     "description": "\"slow\" | \"normal\" | \"fast\"  (optional, default \"normal\")"
    },
    "border_width": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Border thickness in px. Default 2."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Card with a continuously rotating gradient border, created by a spinning conic-gradient pseudo-element — no JavaScript. Two accent colours blend through the border. Inner content area has a solid back",
   "x-intent-phrases": [
    "I need a section that draws the eye for new feature announcements.",
    "Can I have a visually engaging container for user profile highlights?",
    "I want a dynamic frame to showcase important achievements or awards."
   ]
  },
  "aurora_background": {
   "type": "object",
   "description": "Dark panel with three independently-animating radial gradient blobs that drift and scale using CSS @keyframes — creating an aurora borealis effect with no JavaScript. Supports optional title and body text overlaid on the effect. Ideal for hero sections, cover slides, and atmospheric backgrounds on google-meet-stage.",
   "properties": {
    "component": {
     "const": "aurora_background"
    },
    "colors": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of up to 3 hex colour strings (optional). Default [\"#38bdf8\",\"#818cf8\",\"#34d399\"]."
    },
    "speed": {
     "description": "\"slow\" | \"normal\" | \"fast\"  (optional, default \"slow\")"
    },
    "opacity": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "float 0–1 (optional, default 0.5). Blob layer opacity."
    },
    "background": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Panel background colour. Default \"#0a0f1d\"."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Text heading overlaid on the aurora."
    },
    "body": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Body text overlaid on the aurora (markdown inline supported)."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Dark panel with three independently-animating radial gradient blobs that drift and scale using CSS @keyframes — creating an aurora borealis effect with no JavaScript. Supports optional title and body",
   "x-intent-phrases": [
    "I need a visually interesting, calming background for my login screen that feels dynamic but doesn't distract.",
    "We need a subtle, animated backdrop for our onboarding flow to make it feel more engaging and modern.",
    "My app's landing page needs a sophisticated, dark visual element that draws users in without being overwhelming."
   ]
  },
  "flow_field": {
   "type": "object",
   "description": "Full-bleed animated hero background: hundreds of luminous streams ride a slowly evolving noise vector field on a dark canvas, leave additive long-exposure light trails, and converge on a soft glowing focus point. The pointer bends the field around it. Optional eyebrow/title/body copy sits on the opposite side behind a readability veil -- the try.cloudflare.com hero layout (copy left, light right) as one atom. Honours prefers-reduced-motion (renders one pre-simulated long-exposure frame, no loop), pauses when scrolled offscreen, and is DPR-aware. Pure canvas + requestAnimationFrame, zero dependencies. Every option is an enum or a clamped integer and colours must be #rrggbb: the config is baked into inline script, so nothing free-form ever reaches it (bad values fall back to defaults). Dark backgrounds only -- trails are drawn additively and vanish on white.",
   "properties": {
    "component": {
     "const": "flow_field"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Headline overlaid on the field."
    },
    "eyebrow": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Small uppercase label above the title, tinted with the first palette colour."
    },
    "body": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Supporting copy under the title (markdown inline supported)."
    },
    "align": {
     "description": "\"left\" | \"center\" | \"right\"  (optional, default \"left\"). Where the overlaid copy sits; the veil that keeps it readable follows it."
    },
    "focus": {
     "description": "\"right\" | \"center\" | \"left\" | \"none\"  (optional, default \"right\"). Where the glowing sink is that every stream converges on. Put it opposite the copy."
    },
    "colors": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of 1-4 \"#rrggbb\" strings (optional). Default [\"#38bdf8\",\"#818cf8\",\"#f472b6\"]. Streams take a colour by region so the field reads as coloured ribbons; the first colour also tints the focus glow. Invalid entries are dropped."
    },
    "background": {
     "description": "\"#rrggbb\" (optional). Default \"#070a12\". Keep it dark."
    },
    "density": {
     "description": "\"low\" | \"normal\" | \"high\"  (optional, default \"normal\"). Stream count, scaled to the panel area."
    },
    "speed": {
     "description": "\"slow\" | \"normal\" | \"fast\"  (optional, default \"normal\")"
    },
    "trail": {
     "description": "\"short\" | \"normal\" | \"long\"  (optional, default \"normal\"). How long each stream's light trail lingers."
    },
    "scale": {
     "description": "\"fine\" | \"normal\" | \"broad\"  (optional, default \"normal\"). Size of the swirls."
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Panel height in px, clamped 200-900. Default 360."
    },
    "interactive": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Pointer bends the field. Default true."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Full-bleed animated hero background: hundreds of luminous streams ride a slowly evolving noise vector field on a dark canvas, leave additive long-exposure light trails, and converge on a soft glowing",
   "x-intent-phrases": [
    "I need a captivating, dark background for my tech demo site that feels alive.",
    "My app's landing page needs an impressive visual to immediately grab attention.",
    "We want a dynamic, artistic background for our music streaming service's homepage."
   ]
  },
  "particle_type": {
   "type": "object",
   "description": "Agentic typeface: the words an agent supplies assemble out of thousands of coloured particles that fly in from random positions and settle into the letterforms; the pointer scatters them and they reform. Text is rasterised on an offscreen canvas and sampled into particle targets, so any string works, at any panel size, in a system font. Honours prefers-reduced-motion (renders the settled word), pauses offscreen, DPR-aware. The words are also emitted as visually-hidden text so they stay readable and selectable. Sibling of light_type (words as flowing light) and living_type (letters that breathe). Every option is an enum or a clamped int; text is JSON-encoded into the script with \"<\" escaped, so it can never break out.",
   "properties": {
    "component": {
     "const": "particle_type"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). The words to set, up to 3 lines separated by \"\\n\", each trimmed to 40 characters. Short and bold reads best. Default \"A2UI\"."
    },
    "font": {
     "description": "\"sans\" | \"serif\" | \"mono\" | \"display\"  (optional, default \"sans\"). System font stacks; no webfont is loaded."
    },
    "weight": {
     "description": "\"regular\" | \"bold\" | \"black\"  (optional, default \"black\")"
    },
    "colors": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of 1-4 \"#rrggbb\" strings (optional). Default [\"#38bdf8\",\"#818cf8\",\"#f472b6\"], applied left to right across the words. Invalid entries are dropped."
    },
    "background": {
     "description": "\"#rrggbb\" (optional). Default \"#070a12\"."
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Panel height in px, clamped 160-900."
    },
    "interactive": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Pointer affects the letters. Default true."
    },
    "density": {
     "description": "\"low\" | \"normal\" | \"high\"  (optional, default \"normal\"). Particle count cap 1200 / 2400 / 4200."
    },
    "dot": {
     "description": "\"fine\" | \"normal\" | \"bold\"  (optional, default \"normal\"). Particle radius."
    }
   },
   "required": [
    "component",
    "text"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Agentic typeface: the words an agent supplies assemble out of thousands of coloured particles that fly in from random positions and settle into the letterforms; the pointer scatters them and they refo",
   "x-intent-phrases": [
    "I need text to appear like it's being drawn in the air by magic.",
    "Can the words on my screen explode outwards and then reform when I hover over them?",
    "I want my app's intro text to look like it's made of shimmering dust."
   ]
  },
  "light_type": {
   "type": "object",
   "description": "Agentic typeface: the words an agent supplies are rendered as flowing light -- luminous streams ride a noise field inside the letterforms only (particles spawn on the glyph mask and respawn when they leave it), drawn with additive long-exposure trails and composited through the text as a mask, with a soft glow halo behind. Reads as a headline made of moving liquid light. Pointer swirls the flow. Honours prefers-reduced-motion (one pre-simulated frame), pauses offscreen, DPR-aware; the words are also emitted as visually-hidden text. Dark backgrounds only -- trails are additive. Sibling of particle_type and living_type. Every option is an enum or a clamped int; text is JSON-encoded into the script with \"<\" escaped.",
   "properties": {
    "component": {
     "const": "light_type"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). The words to set, up to 3 lines separated by \"\\n\", each trimmed to 40 characters. Short and bold reads best. Default \"A2UI\"."
    },
    "font": {
     "description": "\"sans\" | \"serif\" | \"mono\" | \"display\"  (optional, default \"sans\"). System font stacks; no webfont is loaded."
    },
    "weight": {
     "description": "\"regular\" | \"bold\" | \"black\"  (optional, default \"black\")"
    },
    "colors": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of 1-4 \"#rrggbb\" strings (optional). Default [\"#38bdf8\",\"#818cf8\",\"#f472b6\"], applied left to right across the words. Invalid entries are dropped."
    },
    "background": {
     "description": "\"#rrggbb\" (optional). Default \"#070a12\"."
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Panel height in px, clamped 160-900."
    },
    "interactive": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Pointer affects the letters. Default true."
    },
    "density": {
     "description": "\"low\" | \"normal\" | \"high\"  (optional, default \"normal\"). Streams per glyph area."
    },
    "speed": {
     "description": "\"slow\" | \"normal\" | \"fast\"  (optional, default \"normal\")"
    },
    "trail": {
     "description": "\"short\" | \"normal\" | \"long\"  (optional, default \"normal\")"
    },
    "scale": {
     "description": "\"fine\" | \"normal\" | \"broad\"  (optional, default \"normal\"). Swirl size inside the letters."
    },
    "glow": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Soft halo behind the letters in the first colour. Default true."
    }
   },
   "required": [
    "component",
    "text"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Agentic typeface: the words an agent supplies are rendered as flowing light -- luminous streams ride a noise field inside the letterforms only (particles spawn on the glyph mask and respawn when they",
   "x-intent-phrases": [
    "I need a way to make my chatbot's responses feel more magical and ethereal.",
    "Our game needs a unique visual style for in-game text that feels alive and dynamic.",
    "I'm building a storytelling app and want the narration to have a glowing, otherworldly quality."
   ]
  },
  "living_type": {
   "type": "object",
   "description": "Agentic typeface: the words an agent supplies are set glyph by glyph on canvas and every letter breathes on its own noise track -- drifting, tilting and scaling a little, so the headline feels alive rather than animated. Letters lean toward the pointer and swell as it passes. Works on light or dark backgrounds (set background and colors). Honours prefers-reduced-motion (renders one static frame), pauses offscreen, DPR-aware; the words are also emitted as visually-hidden text. Sibling of particle_type and light_type. Every option is an enum or a clamped int; text is JSON-encoded into the script with \"<\" escaped.",
   "properties": {
    "component": {
     "const": "living_type"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). The words to set, up to 3 lines separated by \"\\n\", each trimmed to 40 characters. Short and bold reads best. Default \"A2UI\"."
    },
    "font": {
     "description": "\"sans\" | \"serif\" | \"mono\" | \"display\"  (optional, default \"sans\"). System font stacks; no webfont is loaded."
    },
    "weight": {
     "description": "\"regular\" | \"bold\" | \"black\"  (optional, default \"black\")"
    },
    "colors": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of 1-4 \"#rrggbb\" strings (optional). Default [\"#38bdf8\",\"#818cf8\",\"#f472b6\"], applied left to right across the words. Invalid entries are dropped."
    },
    "background": {
     "description": "\"#rrggbb\" (optional). Default \"#070a12\"."
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Panel height in px, clamped 160-900."
    },
    "interactive": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Pointer affects the letters. Default true."
    },
    "motion": {
     "description": "\"subtle\" | \"normal\" | \"wild\"  (optional, default \"normal\"). Drift amplitude."
    },
    "speed": {
     "description": "\"slow\" | \"normal\" | \"fast\"  (optional, default \"normal\")"
    }
   },
   "required": [
    "component",
    "text"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Agentic typeface: the words an agent supplies are set glyph by glyph on canvas and every letter breathes on its own noise track -- drifting, tilting and scaling a little, so the headline feels alive r",
   "x-intent-phrases": [
    "I need my app's headlines to feel energetic and unique, not static.",
    "Can I make the text in my app's intro feel more dynamic and engaging?",
    "My branding needs titles that pop and have a subtle, organic movement."
   ]
  },
  "orbit_mark": {
   "type": "object",
   "description": "The catalogue's own orbit mark, alive: the header logo (three orbit ellipses, nucleus, electron) drawn on canvas with a flow field around it -- hundreds of luminous streams ride a noise field and, when they pass near an orbit, get captured into it and circle the nucleus like electrons before drifting off again; the nucleus glows as a sink and a real electron runs the first orbit. Optional eyebrow/title/body copy sits beside the mark behind a readability veil, so it works as a brand hero or a cover slide. Pointer bends the field. Honours prefers-reduced-motion (one pre-simulated frame), pauses offscreen, DPR-aware. Dark backgrounds only. Same kit and hardening as flow_field: every option is an enum or a clamped int, colours must be #rrggbb.",
   "properties": {
    "component": {
     "const": "orbit_mark"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Headline beside the mark."
    },
    "eyebrow": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Small uppercase label above the title, tinted with the first colour."
    },
    "body": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Supporting copy under the title (markdown inline supported)."
    },
    "align": {
     "description": "\"left\" | \"center\" | \"right\"  (optional, default \"left\"). Where the copy sits."
    },
    "mark_position": {
     "description": "\"center\" | \"right\" | \"left\"  (optional, default \"center\"). Where the mark sits; put it opposite the copy."
    },
    "size": {
     "description": "\"small\" | \"normal\" | \"large\"  (optional, default \"normal\"). Mark diameter relative to the panel."
    },
    "colors": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of 1-4 \"#rrggbb\" strings (optional). Default [\"#4f46e5\",\"#a855f7\",\"#22d3ee\"]. First colour is the orbits and nucleus, second the electron, all of them the streams."
    },
    "background": {
     "description": "\"#rrggbb\" (optional). Default \"#070a12\". Keep it dark."
    },
    "density": {
     "description": "\"low\" | \"normal\" | \"high\"  (optional, default \"normal\")"
    },
    "speed": {
     "description": "\"slow\" | \"normal\" | \"fast\"  (optional, default \"normal\")"
    },
    "trail": {
     "description": "\"short\" | \"normal\" | \"long\"  (optional, default \"normal\")"
    },
    "electron": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Animate an electron along the first orbit. Default true."
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Panel height in px, clamped 200-900. Default 360."
    },
    "interactive": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Pointer bends the field. Default true."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "The catalogue's own orbit mark, alive: the header logo (three orbit ellipses, nucleus, electron) drawn on canvas with a flow field around it -- hundreds of luminous streams ride a noise field and, whe",
   "x-intent-phrases": [
    "I need a dynamic, eye-catching visual for the top of my app to represent our brand's forward motion.",
    "Show me a cool, animated graphic for my header that feels energetic and modern.",
    "I want a unique, flowing animation for my app's identity that draws users in."
   ]
  },
  "halftone_wave": {
   "type": "object",
   "description": "The canvas hero that works on a white page. A grid of dots whose size follows a travelling wave -- organic noise, a ripple spreading from a focus point, or a diagonal sweep -- like print halftone brought to life; wave peaks tint to the accent colour, and the pointer swells the dots around it. Ink on paper by default, so it sits inside a light document; flip ink and paper for a dark version. Optional eyebrow/title/body copy behind a veil. Honours prefers-reduced-motion (one static frame), pauses offscreen, DPR-aware. Same kit and hardening as flow_field: every option is an enum or a clamped int; colours must be #rrggbb.",
   "properties": {
    "component": {
     "const": "halftone_wave"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Headline overlaid on the grid."
    },
    "eyebrow": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Small uppercase label above the title."
    },
    "body": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Copy under the title (markdown inline supported)."
    },
    "align": {
     "description": "\"left\" | \"center\" | \"right\"  (optional, default \"left\")"
    },
    "wave": {
     "description": "\"noise\" | \"ripple\" | \"sweep\"  (optional, default \"noise\"). Organic field, concentric ripple from the focus, or a diagonal front."
    },
    "focus": {
     "description": "\"center\" | \"left\" | \"right\"  (optional, default \"center\"). Ripple origin."
    },
    "ink": {
     "description": "\"#rrggbb\" (optional). Dot colour. Default \"#0f172a\"."
    },
    "paper": {
     "description": "\"#rrggbb\" (optional). Ground colour. Default \"#f7f7f5\"."
    },
    "accent": {
     "description": "\"#rrggbb\" (optional). Colour of the wave peaks; when absent, peaks stay in ink."
    },
    "spacing": {
     "description": "\"fine\" | \"normal\" | \"coarse\"  (optional, default \"normal\"). Dot pitch 10 / 14 / 20 px."
    },
    "speed": {
     "description": "\"slow\" | \"normal\" | \"fast\"  (optional, default \"normal\")"
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Panel height in px, clamped 160-900. Default 320."
    },
    "interactive": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Pointer swells nearby dots. Default true."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "The canvas hero that works on a white page. A grid of dots whose size follows a travelling wave -- organic noise, a ripple spreading from a focus point, or a diagonal sweep -- like print halftone brou",
   "x-intent-phrases": [
    "I need a background that looks like a subtle, moving pattern of dots to add visual interest.",
    "Can I get a dynamic, organic texture for my banner image that feels alive?",
    "I'm looking for a cool, retro-style effect for my website's main header."
   ]
  },
  "message_lanes": {
   "type": "object",
   "description": "The A2UI pitch, drawn: small packets stream from an agent node on the left down curved lanes into a surface node on the right, leaving light trails; every arrival makes the surface flash and unfolds a small card outline inside it, the newest on top, older ones fading. Labels for both nodes are agent-supplied (up to 24 characters each). Optional eyebrow/title/body copy. Honours prefers-reduced-motion (one pre-simulated frame with packets mid-flight), pauses offscreen, DPR-aware. Dark backgrounds only. Every option is an enum or a clamped int; colours must be #rrggbb.",
   "properties": {
    "component": {
     "const": "message_lanes"
    },
    "from_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Label under the left node. Default \"agent\"."
    },
    "to_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Label under the right node. Default \"surface\"."
    },
    "lanes": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Number of lanes, clamped 1-6. Default 4."
    },
    "rate": {
     "description": "\"slow\" | \"normal\" | \"fast\"  (optional, default \"normal\"). Packet speed."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Headline overlaid on the scene."
    },
    "eyebrow": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Small uppercase label above the title."
    },
    "body": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Copy under the title (markdown inline supported)."
    },
    "align": {
     "description": "\"left\" | \"center\" | \"right\"  (optional, default \"center\")"
    },
    "colors": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of 1-4 \"#rrggbb\" strings (optional). Default sky/violet/pink; the first colours the agent node, the second the surface."
    },
    "background": {
     "description": "\"#rrggbb\" (optional). Default \"#070a12\". Keep it dark."
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Panel height in px, clamped 200-900. Default 320."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "The A2UI pitch, drawn: small packets stream from an agent node on the left down curved lanes into a surface node on the right, leaving light trails; every arrival makes the surface flash and unfolds a",
   "x-intent-phrases": [
    "I need to show data flowing into a central hub visually.",
    "Can I see incoming messages as they arrive, with a little animation?",
    "I want a dynamic way to represent a system receiving constant updates."
   ]
  },
  "signal_tunnel": {
   "type": "object",
   "description": "Full-bleed animated hero background: light streaks travel along fixed radial lanes through a vanishing point (right, centre or left), converging into it by default (signals arriving) or, in \"out\" mode, radiating away from it (signals broadcasting). Each streak accelerates as it nears the vanishing point and is coloured by its lane angle, so the tunnel reads as many distinct signals rather than one; an additive glow marks the vanishing point itself. Optional eyebrow/title/body copy sits opposite the tunnel behind a readability veil, the same flow_field/try.cloudflare.com hero layout (copy on one side, motion on the other). Honours prefers-reduced-motion (renders one pre-simulated frame, no loop), pauses when scrolled offscreen, and is DPR-aware. Pure canvas + requestAnimationFrame, zero dependencies, on the same shared kit as flow_field/orbit_mark. Every option is an enum or a clamped integer and colours must be #rrggbb: the config is baked into inline script, so nothing free-form ever reaches it. Dark backgrounds only -- streaks are additive and vanish on white.",
   "properties": {
    "component": {
     "const": "signal_tunnel"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Headline overlaid opposite the tunnel."
    },
    "eyebrow": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Small uppercase label above the title, tinted with the first palette colour."
    },
    "body": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Supporting copy under the title (markdown inline supported)."
    },
    "align": {
     "description": "\"left\" | \"center\" | \"right\"  (optional, default \"left\"). Where the overlaid copy sits; the veil that keeps it readable follows it."
    },
    "direction": {
     "description": "\"in\" | \"out\"  (optional, default \"in\"). \"in\" -- streaks converge on the vanishing point. \"out\" -- streaks radiate away from it."
    },
    "position": {
     "description": "\"right\" | \"center\" | \"left\"  (optional, default \"right\"). Where the vanishing point sits; put it opposite the copy."
    },
    "colors": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of 1-4 \"#rrggbb\" strings (optional). Default [\"#38bdf8\",\"#818cf8\",\"#f472b6\"]. Streaks take a colour by lane angle so the tunnel reads as coloured bands; the first colour also tints the vanishing-point glow. Invalid entries are dropped."
    },
    "background": {
     "description": "\"#rrggbb\" (optional). Default \"#070a12\". Keep it dark."
    },
    "density": {
     "description": "\"low\" | \"normal\" | \"high\"  (optional, default \"normal\"). Streak count, scaled to the panel area."
    },
    "speed": {
     "description": "\"slow\" | \"normal\" | \"fast\"  (optional, default \"normal\")"
    },
    "trail": {
     "description": "\"short\" | \"normal\" | \"long\"  (optional, default \"normal\"). How long each streak's light trail lingers."
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Panel height in px, clamped 200-900. Default 360."
    },
    "interactive": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Pointer nudges nearby streaks. Default true."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Full-bleed animated hero background: light streaks travel along fixed radial lanes through a vanishing point (right, centre or left), converging into it by default (signals arriving) or, in \"out\" mode",
   "x-intent-phrases": [
    "I need a dynamic backdrop for my app's welcome screen that feels futuristic and inviting.",
    "Show users a visual flow of information coming into the system on the main page.",
    "I want to create a sense of urgency or movement on a loading screen, directing attention to the center."
   ]
  },
  "gradient_mesh_live": {
   "type": "object",
   "description": "Full-bleed animated hero background: a handful of soft colour blobs, laid out over the panel with an even (Vogel-disk) spread, drift and breathe forever on the same value-noise field that drives flow_field -- never looping on a fixed timeline the way a CSS @keyframes mesh gradient must. The nearest blob leans toward the pointer. This is the animated, canvas-driven sibling of the static mesh_gradient atom and the CSS-keyframe aurora_background: pick this one when the motion itself, not just the colour, needs to feel alive. Optional eyebrow/title/body copy sits opposite a readability veil. Honours prefers-reduced-motion (one pre-simulated frame, no loop), pauses when scrolled offscreen, DPR-aware. Pure canvas + requestAnimationFrame, zero dependencies, on the same shared kit as flow_field/signal_tunnel. Every option is an enum or a clamped integer and colours must be #rrggbb: the config is baked into inline script, so nothing free-form ever reaches it. Dark backgrounds only -- blobs blend additively and vanish on white.",
   "properties": {
    "component": {
     "const": "gradient_mesh_live"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Headline overlaid opposite the blobs."
    },
    "eyebrow": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Small uppercase label above the title, tinted with the first palette colour."
    },
    "body": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Supporting copy under the title (markdown inline supported)."
    },
    "align": {
     "description": "\"left\" | \"center\" | \"right\"  (optional, default \"left\"). Where the overlaid copy sits; the veil that keeps it readable follows it."
    },
    "colors": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of 1-4 \"#rrggbb\" strings (optional). Default [\"#38bdf8\",\"#818cf8\",\"#f472b6\"]. Blobs cycle through these colours. Invalid entries are dropped."
    },
    "background": {
     "description": "\"#rrggbb\" (optional). Default \"#070a12\". Keep it dark."
    },
    "density": {
     "description": "\"low\" | \"normal\" | \"high\"  (optional, default \"normal\"). Blob count: 3 / 4 / 6."
    },
    "motion": {
     "description": "\"subtle\" | \"normal\" | \"wild\"  (optional, default \"normal\"). Drift amplitude."
    },
    "speed": {
     "description": "\"slow\" | \"normal\" | \"fast\"  (optional, default \"normal\")"
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Panel height in px, clamped 200-900. Default 360."
    },
    "interactive": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Nearest blob leans toward the pointer. Default true."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Full-bleed animated hero background: a handful of soft colour blobs, laid out over the panel with an even (Vogel-disk) spread, drift and breathe forever on the same value-noise field that drives flow_",
   "x-intent-phrases": [
    "I need a dynamic, eye-catching background that feels alive for my landing page.",
    "My app needs a subtle, flowing visual element to fill the header space and draw attention.",
    "Can I get a sophisticated, animated backdrop for my product demo that's not distracting?"
   ]
  },
  "wave_terrain": {
   "type": "object",
   "description": "Full-bleed animated hero background: a live terrain flyover drawn as receding ridgelines. Rows of noise-shaped hills scroll toward the viewer while their heights keep evolving on the same value-noise field that drives flow_field, so the landscape never repeats; each row is filled with the background so nearer ridges occlude farther ones, and colour shifts along the palette from the horizon to the foreground. A calm valley runs down the middle with relief rising toward the edges. The pointer steers the camera sideways with a gentle parallax. The live sibling of the static, drag-to-rotate isometric_mesh. Optional eyebrow/title/body copy sits behind a readability veil. Honours prefers-reduced-motion (one still frame, no loop), pauses when scrolled offscreen, DPR-aware. Pure canvas + requestAnimationFrame, zero dependencies, on the same shared kit as flow_field. Every option is an enum or a clamped integer and colours must be #rrggbb: the config is baked into inline script, so nothing free-form ever reaches it. Dark backgrounds only.",
   "properties": {
    "component": {
     "const": "wave_terrain"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Headline overlaid on the scene."
    },
    "eyebrow": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Small uppercase label above the title, tinted with the first palette colour."
    },
    "body": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Supporting copy under the title (markdown inline supported)."
    },
    "align": {
     "description": "\"left\" | \"center\" | \"right\"  (optional, default \"left\"). Where the overlaid copy sits; the veil that keeps it readable follows it."
    },
    "colors": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of 1-4 \"#rrggbb\" strings (optional). Default [\"#38bdf8\",\"#818cf8\",\"#f472b6\"]. Ridgelines blend from the first colour at the horizon to the last in the foreground; the first also tints the horizon glow. Invalid entries are dropped."
    },
    "background": {
     "description": "\"#rrggbb\" (optional). Default \"#070a12\". Keep it dark."
    },
    "density": {
     "description": "\"low\" | \"normal\" | \"high\"  (optional, default \"normal\"). Number of ridgeline rows: 22 / 34 / 48."
    },
    "relief": {
     "description": "\"low\" | \"normal\" | \"high\"  (optional, default \"normal\"). How tall the hills are."
    },
    "scale": {
     "description": "\"fine\" | \"normal\" | \"broad\"  (optional, default \"normal\"). Width of the hills across the terrain."
    },
    "speed": {
     "description": "\"slow\" | \"normal\" | \"fast\"  (optional, default \"normal\"). Flyover speed."
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Panel height in px, clamped 200-900. Default 380."
    },
    "interactive": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Pointer steers the camera sideways. Default true."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Full-bleed animated hero background: a live terrain flyover drawn as receding ridgelines. Rows of noise-shaped hills scroll toward the viewer while their heights keep evolving on the same value-noise",
   "x-intent-phrases": [
    "I need a dynamic, engaging background for my nature exploration app.",
    "Can I get a moving, abstract landscape for my website's intro?",
    "We want a mesmerizing, ever-changing visual for the top of our travel site."
   ]
  },
  "orbit_rings": {
   "type": "object",
   "description": "A system map that moves: up to three tilted orbit rings around a centre node, where each ring is a TIER of agent-supplied labelled items (for example tools / data / surfaces) and every item is a satellite with a light trail and its own label. Inner rings turn faster than outer ones, satellites are larger and brighter on the near side of their ring and dimmer behind the centre, and each ring carries its tier name, so the rings encode structure rather than decoration. The pointer tilts and turns the whole view. This is the hero-class sibling of the single-ring orbit_diagram; orbit_mark remains the fixed brand logo. Optional eyebrow/title/body copy sits behind a readability veil. Honours prefers-reduced-motion (one still frame, no loop), pauses when scrolled offscreen, DPR-aware. Pure canvas + requestAnimationFrame, zero dependencies, on the same shared kit as flow_field. Every option is an enum or a clamped integer and colours must be #rrggbb; agent-supplied labels are trimmed, length-capped and JSON-encoded with \"<\" escaped, so they can never break out of the script. Dark backgrounds only.",
   "properties": {
    "component": {
     "const": "orbit_rings"
    },
    "center": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Label under the centre node, trimmed to 24 characters. Default \"agent\"."
    },
    "rings": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of 1-3 {label, items} objects (optional). Each ring is a tier: label is the tier name (up to 24 characters), items is an array of 1-6 strings (up to 24 characters each) orbiting on that ring. Entries that are not objects, and items that are not strings, are dropped. Default three rings: tools, data, surfaces."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Headline overlaid opposite the rings."
    },
    "eyebrow": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Small uppercase label above the title, tinted with the first palette colour."
    },
    "body": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Supporting copy under the title (markdown inline supported)."
    },
    "align": {
     "description": "\"left\" | \"center\" | \"right\"  (optional, default \"left\"). Where the overlaid copy sits; the veil that keeps it readable follows it."
    },
    "position": {
     "description": "\"right\" | \"center\" | \"left\"  (optional, default \"right\"). Where the rings sit; put them opposite the copy."
    },
    "colors": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of 1-4 \"#rrggbb\" strings (optional). Default [\"#38bdf8\",\"#818cf8\",\"#f472b6\"]. Ring i takes colour i (cycling); the first colour also tints the centre node. Invalid entries are dropped."
    },
    "background": {
     "description": "\"#rrggbb\" (optional). Default \"#070a12\". Keep it dark."
    },
    "speed": {
     "description": "\"slow\" | \"normal\" | \"fast\"  (optional, default \"normal\")"
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Panel height in px, clamped 240-900. Default 420."
    },
    "interactive": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Pointer tilts and turns the view. Default true."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A system map that moves: up to three tilted orbit rings around a centre node, where each ring is a TIER of agent-supplied labelled items (for example tools / data / surfaces) and every item is a satel",
   "x-intent-phrases": [
    "I need a way to visually connect related tools and data sources to a central project idea.",
    "Show me how different teams' responsibilities relate to a core platform feature.",
    "I want to display the layers of information and actions available for a specific user role."
   ]
  },
  "motion_timeline": {
   "type": "object",
   "description": "A stage of child atoms choreographed on ONE clock, the way a product or launch video is: everything on screen is a pure function of time (seek(t)), so it plays, loops, scrubs, and can be frozen on any frame (open the page with #t=3.2). Children are any atoms, placed in percent of a fixed-size stage (so the composition is identical at every width) and addressed by id; tracks animate them by opacity, x/y, scale, rotate, 3D tilt, blur, wipe, and two custom properties the demo kit listens to (p = progress, step = which caption/nav item); a camera track pans, zooms and tilts the world while layer:\"hud\" children (captions) stay put. Each key is a DESTINATION: {t, x, ease} means arrive at x at time t using ease, like GSAP .to(); before a property's first key it holds that first value, so an element can be hidden until its first key. Ease is a token name from motion_tokens (expo-out, standard, quart-in-out, overshoot, hold...) or four cubic-bezier numbers; with bpm set, keys take beat instead of t so the piece sits on a grid. Style that reads as designed rather than generated: one orchestrated moment per scene, entrances 600 ms or less on expo-out, on-screen moves on standard, the camera on quart-in-out, a shared motion vector between scenes, restraint over noise by default (no particle bursts, neon glows or bouncy easing on UI; the opt-in expressive options, glow, shine, trails and ripples, are for a film that wants them). Honours prefers-reduced-motion (holds the poster frame; controls still work).",
   "properties": {
    "component": {
     "const": "motion_timeline"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 80). Accessible name of the stage. Default \"Motion sequence\"."
    },
    "aspect": {
     "description": "\"16:9\" | \"4:3\" | \"1:1\" | \"9:16\" (optional, default \"16:9\"). The stage is laid out at 1280x720, 1200x900, 1000x1000 or 720x1280 logical px and scaled to the container."
    },
    "duration": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Seconds, clamped 2-120. Default 12."
    },
    "bpm": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). 0-240. When set, keys may use `beat` (t = beat * 60 / bpm) instead of `t`."
    },
    "ease": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string | [x1,y1,x2,y2] (optional). Default ease for keys that do not name one. A token from motion_tokens (not \"hold\"). Default \"standard\"."
    },
    "loop": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Default true."
    },
    "autoplay": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Plays when scrolled into view, pauses when it leaves. Default true. Off, or under prefers-reduced-motion, it shows the poster frame."
    },
    "drive": {
     "description": "\"time\" | \"scroll\" (optional, default \"time\"). \"scroll\" turns the film into a scroll-driven piece: the stage is pinned (position:sticky) inside a tall runway and the film clock is the page's scroll progress through that runway (seeked on requestAnimationFrame from a passive scroll listener), so scrolling plays the film and scrolling back rewinds it. No autoplay and no play/pause button: the scrubber stays as a progress indicator and a keyboard control (moving it scrolls the page to that point), and the page's own keys scroll as usual. Under prefers-reduced-motion there is no runway: the poster frame is shown in the normal flow. The export buttons are not offered. Absent or any other value: unchanged."
    },
    "scroll_length": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). With drive \"scroll\": the runway height in percent of the viewport height, clamped 150-1000, default 300 (the film plays over the runway minus one viewport of travel)."
    },
    "controls": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Play/pause button, scrubber and clock. Default true."
    },
    "poster": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Seconds; the frame shown when not autoplaying. Default 60% of duration."
    },
    "transcript": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Default false (nothing is added). True adds, under the stage, a \"Transcript\" disclosure (a details element, works without script) holding a table of every text and value the film shows, in reading order: time on screen (from the same keyframes as the player, the cue timing of film_to_vtt), scene (the scene layer it sits in), and the text. Covers motion_text, demo_caption lines, motion_counter, motion_pill, motion_checklist, demo_kpis, demo_chart (title, labels and values), demo_progress and demo_toggle_grid, nested or not. Up to 200 rows."
    },
    "theme": {
     "description": "\"dark\" | \"light\"  (optional, default \"dark\"). Stage background and control colours."
    },
    "accent": {
     "description": "\"#rrggbb\" (optional). Glow and control accent. Default \"#38bdf8\"."
    },
    "background": {
     "description": "\"#rrggbb\" (optional). Stage background override."
    },
    "backdrop": {
     "description": "\"glow\" | \"grid\" | \"flat\" (optional, default \"glow\")"
    },
    "blocks": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (max 24) of any atom blocks. Each may also carry id (^[a-z][a-z0-9_-]{0,31}$, makes it addressable by a track), place {x, y, w, h, z, origin} (x/y/w/h in percent of the stage; z 0-99; origin \"c\"|\"tl\"|\"t\"|\"b\"|\"l\"|\"r\" is the transform origin), and layer \"world\" (default, moves with the camera) or \"hud\" (stays on screen)."
    },
    "tracks": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (max 40) of {target: id, keys: [...]} (max 48 keys each). A key is {t | beat, ease?, x?, y?, opacity?, scale?, rotate?, rx?, ry?, blur?, clip?, p?, step?, a?}. x,y are the element's top-left in percent of the stage (for an element nested in another, an offset from its natural place); opacity 0-1; scale 0-6; rotate, rx, ry in degrees (tilt -80..80); blur 0-40 px; the filter keys hue (degrees, -360..360), saturation, brightness, contrast (multipliers 0-4, 1 = unchanged) and invert (0-1) are composed with blur into one CSS filter on the element, clamped to those ranges, and the settled frame is the value at the last key (a brightness or invert track that swings quickly is checked as a possible flash by scripts/motion_lint.py); clip 0-1 is a left-to-right wipe; p 0-1 drives a demo atom's progress (chart draw, bar growth, toggles, fills, click ripple, orb level) and recounts its numbers; step is a float that crossfades captions and selects the active nav item. ease on a key is the ease of the segment ARRIVING at that key: a token name, \"hold\" (jump at the key), or four numbers. PATH FOLLOWING: a track may also carry path (path data in stage PERCENT, 0-100 on both axes: the motion_path grammar, M L H V C S Q T A Z, 700 characters), and keys with a (0-1, how far along it): the element's top-left rides the path, like x and y, and a track with a keys ignores its x and y. orient: true also turns the element to the path's direction (rotate keys on the same track are then ignored). trail: {n 1-6, lag 0.02-0.5 s} adds n fading copies of a top-level block (it needs a numeric place.w) that follow the same path a little later, each fainter and blurrier than the one before. SPRING: a key ease (which governs the segment arriving at that key) may also be {spring: {stiffness 1-1000 (default 170), damping 0-100 (default 26), mass 0.1-10 (default 1)}} or {spring: true} for the defaults: a damped spring, computed when the page is built (semi-implicit Euler, 1 ms step, time in seconds), so the player needs no extra script. The spring replaces the segment arriving at the key that carries it (previous key value to this one), written as 24 linear steps; the key is always exact and every other segment keeps its own ease. Pick values that settle within the segment, otherwise it snaps at this key. Under-damped springs overshoot (clamped to the property range). A first key with no previous key, or any other ease object, keeps the normal ease."
    },
    "scenes": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (max 12) of {layer: id, t | beat, transition?}, optional. STITCHES scenes together: each layer (usually a motion_layer) is hidden until its start and hands over to the next scene instead of cutting. Within `overlap` seconds of the next scene's start the old one leaves while the new one arrives. transition is one of cut, dissolve, push, zoom-through, blur, rise, whip, wipe, iris, clock, slice, flip, spin, portal (with `portal: {x, y, w}`), ribbon, fade-through, shared-x, shared-y, shared-z, collapse and applies to the scene it names (the hand-over INTO it); without one the timeline's `stitch` is used. Your own tracks on the same layer are applied after these and win, so a scene can still do its own entrance."
    },
    "morphs": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (max 6) of {from, to, t | beat, dur?, ease?} (optional). Match cut: a copy of the `from` child flies from its box to the `to` child's box (resizing on the way) starting at t, over dur seconds (0.1-4, default 0.8), with ease (a motion token, default quart-in-out). from hides when the flight starts and to appears when it lands, so the morph owns their opacity: do not also give them opacity tracks. Both must have a numeric place.w and sit at the top level or directly inside a motion_layer; others are dropped and reported."
    },
    "stitch": {
     "description": "\"cut\" | \"dissolve\" | \"push\" | \"zoom-through\" | \"blur\" | \"rise\" | \"whip\" | \"wipe\" | \"iris\" | \"clock\" | \"slice\" | \"flip\" | \"spin\" | \"portal\" | \"ribbon\" | \"fade-through\" | \"shared-x\" | \"shared-y\" | \"shared-z\" | \"collapse\" (optional, default \"dissolve\"). The four Material patterns fade the old scene out in the first 30% of the overlap and the new one in after it, so the two are never both half visible: fade-through brings the new scene up from 92% size, shared-x and shared-y slide it in along the axis (8% and 6% of the stage), shared-z scales it from 80% while the old one grows to 110%; set overlap to about 0.3 for the 300 ms Material uses. whip is a fast push with heavy motion blur; wipe reveals the new scene left to right over the old one; iris opens a circle from the centre; clock sweeps round like a clock hand; slice reveals through vertical bars; flip turns the old scene edge-on and the new one in; spin rotates and scales through; portal dives into a box in the old scene (give that scene entry `portal: {x, y, w}` in stage percent, the box keeps the stage shape) and the box becomes the new scene; without a box it falls back to dissolve; ribbon sweeps a slanted band in the accent colour across the frame and reveals the new scene behind it. The hand-over used by scenes that do not name one. collapse squeezes the OLD scene sideways to a thin vertical band that narrows to nothing (content clipped with it, over the overlap), and the new scene appears when that is done: a closing move, best before a blank beat or a lone object. Pick one per film: a shared motion vector between scenes is what reads as designed."
    },
    "overlap": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Seconds a hand-over takes, 0-3. Default 0.6. Ignored by cut."
    },
    "camera": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{keys: [{t | beat, ease?, x?, y?, zoom?, rx?, ry?, rz?, z?}]} (max 48 keys), optional. z (-1500 to 1500 px) dollies the camera through depth: top-level blocks with place.depth (0-1) sit further back and, with a compensating scale, look unchanged at z 0, so moving z gives real parallax. x,y are the focus point in percent of the stage (default 50,50); zoom 0.25-6 (default 1); rx, ry, rz tilt in degrees. Moves only layer:\"world\" children."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A stage of child atoms choreographed on one clock like a product or launch video: tracks animate children by id (opacity, position, scale, tilt, blur, wipe, progress, caption step), a camera pans zooms and tilts, easing is a named token or four cubic-bezier numbers, keys can sit on a BPM beat grid. Scrubbable, loopable, frame-exact.",
   "x-intent-phrases": [
    "Recreate a product demo video as an interactive page, with a cursor, charts that draw themselves and captions.",
    "Choreograph a motion-design sequence where elements enter on easing curves and the camera pushes in.",
    "Make a launch film for our app that I can scrub through and loop."
   ]
  },
  "motion_group": {
   "type": "object",
   "description": "Blocks that enter one after another: a stagger, set once. Every child gets the same entrance (effect, ease, duration) offset by stagger milliseconds, on load or when scrolled into view. The general-purpose alternative to hand-setting a delay on each block; for a single block use the `enter` prop that any atom accepts.",
   "properties": {
    "component": {
     "const": "motion_group"
    },
    "blocks": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (max 40) of any atom blocks."
    },
    "effect": {
     "description": "\"fade\" | \"rise\" | \"drop\" | \"slide-left\" | \"slide-right\" | \"scale\" | \"blur\" | \"wipe\" | \"pop\" (optional, default \"rise\")"
    },
    "ease": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string | [x1,y1,x2,y2] (optional). A token from motion_tokens, or four numbers. Default depends on the effect (expo-out for most)."
    },
    "duration": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer | \"instant\" | \"quick\" | \"base\" | \"slow\" | \"cinematic\" (optional). Milliseconds 0-8000 or a duration token. Default 560."
    },
    "delay": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Milliseconds before the first child, 0-20000. Default 0."
    },
    "stagger": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Milliseconds between children, 0-1000. Default 80."
    },
    "on": {
     "description": "\"load\" | \"view\" (optional, default \"load\"). \"view\" waits until the group is scrolled into view; without JavaScript it simply shows."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"},
   "x-routing-text": "Blocks that enter one after another with a set stagger: the same entrance effect, ease and duration for every child, offset per child, on load or when scrolled into view.",
   "x-intent-phrases": [
    "Have these cards appear one after another with a short stagger.",
    "Fade and slide my list items in on load, expo-out, 80ms apart.",
    "Reveal this section's blocks as the reader scrolls to them."
   ]
  },
  "motion_tokens": {
   "type": "object",
   "description": "The catalogue's motion vocabulary, drawn: every named easing curve with a dot riding it, the cubic-bezier it stands for and what it is for, the five duration tokens, and the nine entrance effects. The same names are accepted by the `enter` prop on any atom, by motion_group, by reveal, and by every ease field in motion_timeline, so an agent learns the vocabulary once. Honours prefers-reduced-motion (dots stay still).",
   "properties": {
    "component": {
     "const": "motion_tokens"
    },
    "show": {
     "description": "\"ease\" | \"duration\" | \"both\" (optional, default \"both\")"
    },
    "theme": {
     "description": "\"dark\" | \"light\"  (optional, default \"dark\")"
    },
    "accent": {
     "description": "\"#rrggbb\" (optional). Default \"#38bdf8\"."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Reference card for the catalogue's motion vocabulary: named easing curves (expo-out, standard, emphasized, quart-in-out, overshoot...) each drawn as a dot riding the curve with its cubic-bezier and its use, duration tokens, and entrance effects.",
   "x-intent-phrases": [
    "Show me the easing curves I can use for UI animation and what each is for.",
    "What motion tokens does this catalogue offer?",
    "Give me a motion style guide for our design system."
   ]
  },
  "motion_layer": {
   "type": "object",
   "description": "A scene. Children are any atoms, placed in percent of THIS layer (place {x, y, w, h, z, origin}, id, exactly as inside a motion_timeline), and the whole layer moves as one: give the layer an id and fade, slide, scale or blur it with opacity, x, y, scale and blur tracks to cut between scenes. Use it inside a motion_timeline; a layer with no place fills the stage. Layers are what make a piece with several scenes cheap to author: one id per scene instead of one track per element.",
   "properties": {
    "component": {
     "const": "motion_layer"
    },
    "blocks": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (max 24) of any atom blocks. Each may carry id (^[a-z][a-z0-9_-]{0,31}$), place {x, y, w, h, z, origin}. Ids must be unique across the whole timeline."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"}
  },
  "motion_text": {
   "type": "object",
   "description": "Kinetic type. The text reveals unit by unit as p goes 0 to 1: per line, word or character (or all at once), with reveal \"mask\" (each unit slides up out of a clipped line, the signature designed look), \"rise\", \"drop\", \"fade\" or \"blur\". Sized in px on the stage, so the composition is identical at any width, and coloured from the stage theme unless a colour is given. Screen readers get the plain text. Standalone it renders fully revealed. Plain HTML and CSS, no script: it moves with the --p custom property that a motion_timeline p track sets, and standalone it renders its final state.",
   "properties": {
    "component": {
     "const": "motion_text"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (max 4 lines of 60 characters, 160 total; lines split on \\n). Default \"Text\". A word between asterisks (*plan*) takes the accent colour, whichever way the text reveals; two asterisks in a row are a literal one."
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Font size px, 10-400. Default 64."
    },
    "font": {
     "description": "\"sans\" | \"serif\" | \"mono\" | \"display\" (optional, default \"sans\"). display is a heavy grotesque."
    },
    "weight": {
     "description": "\"regular\" | \"bold\" | \"black\" (optional, default \"bold\")"
    },
    "mode": {
     "description": "\"lines\" | \"words\" | \"chars\" | \"block\" (optional, default \"lines\"). What reveals in turn. lines never wraps; more than 120 units falls back to block."
    },
    "reveal": {
     "description": "\"mask\" | \"rise\" | \"drop\" | \"fade\" | \"blur\" | \"bar\" | \"flap\" | \"reel\" | \"pop\" | \"decode\" | \"bloom\" (optional, default \"rise\"). bloom condenses each unit in place out of a bright, glowing blur: it starts about 60% brighter with a soft halo and a 0.4em blur at 90% size, and halo, brightness and blur fall away as it sharpens (no slide; blur only defocuses, decode swaps glyphs, bloom adds the glow). Pair with a long overlap (4-8) and mode words or lines so the glow runs through the whole line. pop scales each unit up past full size and settles (an overshoot). decode shows seeded random characters that resolve into each unit (the real text is always in the page; the noise is aria-hidden). bar wipes a coloured highlight bar in behind each unit, then the text appears on it. flap is a slot-reel flip: three decoy glyphs scroll past in each unit before the real one lands (best with mode chars). reel stacks the lines on one row and the second dial (--s) moves the focus down the list: the focused line is sharp, the others dim, shrink and blur with their distance (a scrolling text reel); at --s 1 the last line is in focus."
    },
    "overlap": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). How many units are mid-reveal at once, 1-8. Higher is softer. Default 3."
    },
    "tracking": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Letter spacing in em, -0.1 to 0.5. Default -0.02."
    },
    "line_height": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). 0.8-2. Default 1.05."
    },
    "color": {
     "description": "\"#rrggbb\" (optional). Default the stage ink."
    },
    "align": {
     "description": "\"start\" | \"middle\" | \"end\" (optional, default \"start\")"
    },
    "uppercase": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Default false."
    },
    "accent": {
     "description": "\"#rrggbb\" (optional). Colour of words wrapped in asterisks. Default the stage accent."
    },
    "accent_gradient": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "[\"#rrggbb\", \"#rrggbb\"] (optional). Two colours that run across the accent words (the ones in asterisks) instead of the flat accent colour."
    },
    "glow": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). A soft glow behind the type, 0-40 px. Default 0 (off)."
    },
    "glow_color": {
     "description": "\"#rrggbb\" (optional). Colour of the glow. Default the accent."
    },
    "shine": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). A band of light that sweeps across the letters as the second dial (--s) goes 0 to 1. Default false."
    },
    "cycle": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (2-6) of strings, max 40 characters each (optional). Words that swap in place with a blur crossfade as the second dial (--s) goes 0 to 1, after the text (or on their own when text is empty): on your phone / the web / the terminal. Take the accent colour."
    },
    "bar": {
     "description": "\"#rrggbb\" (optional). Colour of the highlight bar for reveal \"bar\". Default the stage accent."
    },
    "extrude": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Depth in px of a solid 3D extrusion behind the type, 0-30. Default 0."
    },
    "extrude_color": {
     "description": "\"#rrggbb\" (optional). Extrusion colour. Default \"#0b0b14\"."
    },
    "extrude_dir": {
     "description": "\"diagonal\" | \"down\" (optional, default \"diagonal\"). Which way the extrusion falls."
    },
    "decor": {
     "description": "\"strike\" | \"underline\" | \"highlight\" (optional). A line that sweeps across each unit (line, word or character) in turn as the second dial (--s) goes 0 to 1: a strike-through (the text dims), an underline, or a marker highlight behind it. With no step track it shows finished."
    },
    "decor_color": {
     "description": "\"#rrggbb\" (optional). The sweep. Default the accent."
    },
    "karaoke": {
     "description": "\"pill\" | \"color\" (optional). Lights each unit (use mode words) in turn as --s goes 0 to 1, as a pill behind it or a colour change: the animated caption. Nothing is lit at 0 or 1."
    },
    "split": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Red and cyan copies pull apart by this many px at the peak of --s and sit together at 0: the chromatic glitch. 0-60. Default 0 (off)."
    },
    "split_a": {
     "description": "\"#rrggbb\" (optional). Left copy. Default a hot pink."
    },
    "split_b": {
     "description": "\"#rrggbb\" (optional). Right copy. Default cyan."
    },
    "prism": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (2-4) of words, max 14 characters each (optional). A turning 3D prism after the text that cycles the words as the second dial (--s) goes 0 to 1 (one full turn): Build / Ship / Scale. Two words repeat to fill four faces. Needs at least two words, else ignored."
    },
    "order": {
     "description": "\"forward\" | \"reverse\" | \"centre\" | \"random\" (optional, default \"forward\"). The order units reveal in: reading order, last first, from the middle outwards, or a fixed random order (see order_seed). The step-dial effects (karaoke, decor, wave) keep reading order."
    },
    "order_seed": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). 0-999. Seeds order random and the noise of reveal decode. Default 3."
    },
    "accent_font": {
     "description": "\"sans\" | \"serif\" | \"mono\" | \"display\" (optional). A typeface for the words wrapped in asterisks, so one word can be set in serif inside sans text. Default none (the line face)."
    },
    "accent_style": {
     "description": "\"italic\" (optional). Sets the asterisk words in italic. Default none."
    },
    "wave": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Letters ride a travelling vertical wave of this many px as the second dial (--s) goes 0 to 1, flat at both ends. 0-40. Default 0 (off). Best with mode chars."
    },
    "start_scale": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). 1-12. The whole line starts this many times its size, cropped by the box, and shrinks to its size as p goes 0 to 1: the oversize zoom-down. Default 1 (off). The box hides what falls outside it."
    },
    "caret": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). A caret follows the unit being revealed and stays on the last one. Use with mode words or chars; lines and block have no caret. Default false."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"}
  },
  "motion_shape": {
   "type": "object",
   "description": "A form that draws or grows with p: a bar or rule (grow-x, grow-y), a disc (scale), a ring that sweeps round like a progress dial (sweep), or a fade; solid or a two-colour gradient at an angle, with rounded corners, and an optional heavy blur that makes it a soft glow behind everything. Fills its placed box, or w/h px. Plain HTML and CSS, no script: it moves with the --p custom property that a motion_timeline p track sets, and standalone it renders its final state.",
   "properties": {
    "component": {
     "const": "motion_shape"
    },
    "shape": {
     "description": "\"rect\" | \"circle\" | \"ring\" | \"line\" (optional, default \"rect\")"
    },
    "fill": {
     "description": "\"#rrggbb\" (optional). Default the stage accent."
    },
    "fill2": {
     "description": "\"#rrggbb\" (optional). Second colour; makes a gradient (for a ring, the sweep colour)."
    },
    "angle": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Gradient angle in degrees, 0-360. Default 90."
    },
    "thickness": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Ring and line thickness px, 1-200. Default 6."
    },
    "radius": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Rect corner radius px, 0-500. Default 0."
    },
    "draw": {
     "description": "\"grow-x\" | \"grow-y\" | \"scale\" | \"sweep\" | \"fade\" | \"none\" (optional). Default grow-x for rect and line, scale for circle, sweep for ring. sweep is ring only. pulse (ring and circle only) is a ripple: the second dial (--s) goes 0 to 1 and the form swells and fades out, invisible at both ends."
    },
    "lag": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). With draw pulse, delays the ripple, 0-0.9 of the dial. Several rings with growing lag make concentric ripples. Default 0."
    },
    "blur": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Blur px, 0-200. A big blur on a gradient disc is an ambient glow. Default 0."
    },
    "w": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Width px, 1-3000. Default 100% of the placed box."
    },
    "h": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Height px, 1-3000. Default 100% of the placed box. A line is thickness tall."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "native", "compose": "native"}
  },
  "motion_counter": {
   "type": "object",
   "description": "A big number that counts from `from` to `to` as p goes 0 to 1, with thousands separators, prefix, suffix, fixed decimals and an optional small-caps caption under it. The generic form of a stat for any topic: nights, artists, kilometres, followers. Plain HTML and CSS, no script: it moves with the --p custom property that a motion_timeline p track sets, and standalone it renders its final state.",
   "properties": {
    "component": {
     "const": "motion_counter"
    },
    "to": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Value at p = 1. Default 100."
    },
    "from": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Value at p = 0. Default 0."
    },
    "decimals": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). 0-3. Default 0."
    },
    "prefix": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 4)."
    },
    "suffix": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 8)."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 40). Caption."
    },
    "label_size": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Caption px, 8-80. Default a fifth of size."
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Number size px, 10-400. Default 96."
    },
    "font": {
     "description": "\"sans\" | \"serif\" | \"mono\" | \"display\" (optional, default \"display\")"
    },
    "weight": {
     "description": "\"regular\" | \"bold\" | \"black\" (optional, default \"black\")"
    },
    "color": {
     "description": "\"#rrggbb\" (optional). Default the stage ink."
    },
    "align": {
     "description": "\"start\" | \"middle\" | \"end\" (optional, default \"start\")"
    },
    "roll": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Odometer: every digit is a 0-9 strip that scrolls to its value, left to right, as p goes 0 to 1. Counts from zero (from is ignored). Default false."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"}
  },
  "motion_pill": {
   "type": "object",
   "description": "A rounded call-to-action chip: \"Comment *Motion* under this post\". The words between asterisks take the accent colour (two asterisks in a row are a literal one), with an optional leading glyph. It fades and rises with p, and put in a layer with layer:\"hud\" it stays on screen across every scene and camera move, the way social films keep their ask visible. Plain HTML and CSS, no script: it moves with the --p custom property a motion_timeline p track sets, and standalone it renders its final state.",
   "properties": {
    "component": {
     "const": "motion_pill"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (max 60). Default \"Label\". *word* takes the accent colour; ** is a literal asterisk."
    },
    "icon": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 2). A glyph before the text, in the accent colour."
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Font size px, 10-120. Default 28."
    },
    "accent": {
     "description": "\"#rrggbb\" (optional). Default the stage accent."
    },
    "color": {
     "description": "\"#rrggbb\" (optional). Text colour. Default the stage ink."
    },
    "fill": {
     "description": "\"#rrggbb\" (optional). Chip fill. Default a faint tint of the stage ink."
    },
    "border_gradient": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "[\"#rrggbb\", \"#rrggbb\"] (optional). A two-colour gradient outline instead of the faint line."
    },
    "glow": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). A soft glow around the chip, 0-40 px, in the gradient colours or the accent. Default 0 (off)."
    },
    "href": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Makes the pill a real link: https, mailto or a relative path; anything else is dropped. Default none."
    },
    "align": {
     "description": "\"start\" | \"middle\" | \"end\" (optional, default \"start\")"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"}
  },
  "motion_checklist": {
   "type": "object",
   "description": "A card of items that tick off one after another as p goes 0 to 1: each row brightens and slides in while its check pops, with optional empty placeholder rows under the real ones (the \"recipe\" card: your knowledge, your process, your automations). Plain HTML and CSS, no script: it moves with the --p custom property a motion_timeline p track sets, and standalone it renders every item ticked.",
   "properties": {
    "component": {
     "const": "motion_checklist"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 40)."
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (max 6) of string or {text, icon?} (text max 40, icon max 2 characters). Default one item \"Item\"."
    },
    "skeleton": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Empty placeholder rows under the items, 0-4. Default 0."
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Font size px, 10-80. Default 26."
    },
    "accent": {
     "description": "\"#rrggbb\" (optional). Colour of the ticks. Default the stage accent."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"}
  },
  "motion_orbit": {
   "type": "object",
   "description": "Tiles that fly out from the centre onto an ellipse as p goes 0 to 1, then swing round it as step goes 0 to 1: the ring of app icons around a product shot. Tiles are text (a letter, a glyph or a short label), never brand logos, so there is nothing to license. Place it over the same box as the thing it surrounds. Uses CSS cos() and sin(), so it needs a current browser. Plain HTML and CSS, no script; standalone it renders the tiles in place.",
   "properties": {
    "component": {
     "const": "motion_orbit"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (max 12) of string or {text}; text max 8 characters (one or two reads as a glyph, longer as a small label), or max 24 with shape pill."
    },
    "shape": {
     "description": "\"pill\" (optional). Rectangular pill tiles that size to their label (text up to 24 characters, one line, no wrapping) instead of square tiles. Anything else keeps the square tile and the 8-character limit. Tile height is 55% of size, so size sets the pill height; allow room around the ring for long labels."
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Tile px, 24-160. Default 64."
    },
    "rx": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Horizontal radius, percent of the placed box, 5-60. Default 40."
    },
    "ry": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Vertical radius, percent of the placed box, 5-60. Default 36."
    },
    "start": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Angle of the first tile in degrees, -360 to 360. Default -90 (top)."
    },
    "spin": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Degrees the ring turns as step goes 0 to 1, -360 to 360. Default 40."
    },
    "fill": {
     "description": "\"#rrggbb\" (optional). Tile colour. Default \"#ffffff\"."
    },
    "ink": {
     "description": "\"#rrggbb\" (optional). Tile text colour. Default \"#111827\"."
    },
    "ring": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). A faint dashed ellipse behind the tiles. Default true."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"}
  },
  "motion_code": {
   "type": "object",
   "description": "A code window that types itself in as p goes 0 to 1: monospace lines revealed left to right in order with a caret on the line being typed, keywords in the accent colour and // comments dimmed. No script and no per-letter markup, because a line's width is its character count in ch. For show, not for syntax highlighting. Standalone it renders all the code.",
   "properties": {
    "component": {
     "const": "motion_code"
    },
    "lines": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (max 14) of string (max 72 characters each). Blank strings are blank lines."
    },
    "file": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 32). Shown in the window bar."
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Font size px, 8-60. Default 18."
    },
    "accent": {
     "description": "\"#rrggbb\" (optional). Keywords and caret. Default the stage accent."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"}
  },
  "motion_mark": {
   "type": "object",
   "description": "The catalogue's own mark (three tilted ellipses around a nucleus, one electron) that draws itself as p goes 0 to 1 and whose electron circles its orbit as step goes 0 to 1. The opening frame of a film or a brand sting. Geometry is the site logo's; the two colours are fields. Plain SVG and CSS, no script: it moves with the --p and --s custom properties a motion_timeline p and step track set, and standalone it renders the finished mark.",
   "properties": {
    "component": {
     "const": "motion_mark"
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Width and height px, 24-600. Default 120."
    },
    "accent": {
     "description": "\"#rrggbb\" (optional). Two ellipses and the nucleus. Default the stage accent."
    },
    "accent2": {
     "description": "\"#rrggbb\" (optional). The third ellipse and the electron. Default \"#00b7c3\"."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"}
  },
  "motion_browser": {
   "type": "object",
   "description": "The catalogue browser, as a shot: a search box that types its query, filter chips with a count, and a grid of cards that rise in, each holding a LIVE render of a real atom (give the atom block as the card's preview) with its name, description, surface badge and source. One card can be picked: it lifts and takes an accent outline as step goes 0 to 1. p 0 to 0.3 types the query, p 0.3 to 1 brings the cards in. Use it to show a library of components honestly, with real names, real descriptions and real renders, instead of a mock-up. Plain HTML and CSS, no script; standalone it renders the finished screen.",
   "properties": {
    "component": {
     "const": "motion_browser"
    },
    "query": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 16). Typed into the search box as p goes 0 to 0.3."
    },
    "placeholder": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 24). Shown before typing starts. Default \"Search atoms...\"."
    },
    "chips": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (max 6) of string (max 24). The first is drawn active."
    },
    "count": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 16). For example \"51 atoms\"."
    },
    "cards": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (max 6) of {title (max 28), text (max 90), badge? (max 16), source? (max 20), preview? (an atom block, rendered live)}."
    },
    "columns": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). 2-4. Default 3."
    },
    "pick": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Index of the card to lift and outline as step goes 0 to 1, -1 for none. Default -1."
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Base font px, 8-40. Default 16."
    },
    "well": {
     "description": "\"#rrggbb\" (optional). Background of the preview area of each card. Real atoms are drawn for their own surfaces and some hard-code dark text, so on a dark stage give them a light well. Default none."
    },
    "accent": {
     "description": "\"#rrggbb\" (optional). Search border, active chip, picked card. Default the stage accent."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"}
  },
  "motion_sketch": {
   "type": "object",
   "description": "Strokes that draw themselves one after another as p goes 0 to 1, like an agent sketching: each stroke is path data (M, L, H, V, C, S, Q, T, A, Z with numbers; anything else and the stroke is dropped), drawn in a chosen colour and width, optionally with a soft fill that appears as it is drawn. Not raw SVG markup, so nothing but a path can reach the page. Sized by a viewBox (w by h, default 400 by 400) and scaled to its placed box. Plain SVG and CSS, no script: it moves with the --p custom property a motion_timeline p track sets, and standalone it renders the finished drawing.",
   "properties": {
    "component": {
     "const": "motion_sketch"
    },
    "strokes": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (max 24) of {d, color?, width?, fill?, fill_opacity?}. d is path data (max 700 characters of path commands, numbers and separators). color and fill are \"#rrggbb\"; width 1-24 px (default 6); fill_opacity 0-1 (default 0.2). Strokes draw in order."
    },
    "w": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). ViewBox width, 50-2000. Default 400."
    },
    "h": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). ViewBox height, 50-2000. Default 400."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 60). Accessible name of the drawing. Default \"Sketch\"."
    },
    "trim": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (optional) {start, end, offset}, like After Effects trim paths. start and end are 0-1 of each stroke's length (defaults 0 and 1) and bound the part that is drawn; offset -1 to 1 shifts the window along the stroke (a window pushed past the end wraps round to the start). The window draws on as p goes 0 to 1 (from start to end). end at or below start draws no stroke. Absent, empty or all defaults: the full stroke, unchanged."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"}
  },
  "motion_leader": {
   "type": "object",
   "description": "A callout line that draws itself from one point to another as p goes 0 to 1: straight or bent, with a start dot, an arrowhead that lands at the end, and a label that fades in beside the tip. The annotation that points at a part of a diagram, a map or a product shot. Points are in viewBox units (w by h, default 400 by 300) and the whole thing scales to its placed box. Plain SVG and CSS, no script: it moves with the --p custom property a motion_timeline p track sets, and standalone it renders finished.",
   "properties": {
    "component": {
     "const": "motion_leader"
    },
    "from": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "[x, y] (optional). Start point in viewBox units. Default [48, 210] on the default 400 by 300 box."
    },
    "to": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "[x, y] (optional). End point, where the arrowhead lands. Default [352, 90]."
    },
    "curve": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Bend, -100 to 100, as a percentage of the line length at its middle. 0 is straight. Default 0."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 40). Text beside the tip."
    },
    "label_at": {
     "description": "\"end\" | \"start\" (optional, default \"end\")"
    },
    "arrow": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Arrowhead. Default true."
    },
    "dot": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Dot at the start. Default true."
    },
    "color": {
     "description": "\"#rrggbb\" (optional). Line, dot and arrowhead. Default the stage accent."
    },
    "label_color": {
     "description": "\"#rrggbb\" (optional). Default the stage ink."
    },
    "width": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Line px, 1-24. Default 4."
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Label px, 8-80. Default 22."
    },
    "w": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). ViewBox width, 50-2000. Default 400."
    },
    "h": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). ViewBox height, 50-2000. Default 300."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"}
  },
  "motion_mask": {
   "type": "object",
   "description": "Reveals its child blocks through a shape that grows as p goes 0 to 1: a wobbly blob, a circle, a diagonal wipe, a rounded rectangle that opens, venetian bars, a diamond, a halftone dot grid, a conic sweep, or horizontal slats. The scene that opens out of a cloud-shaped hole, or the screenshot that wipes in. The blob and circle are 20-vertex polygons whose coordinates use CSS cos() and sin(), so they need no script and a current browser. At p = 1 the child is fully visible; standalone it renders fully revealed.",
   "properties": {
    "component": {
     "const": "motion_mask"
    },
    "shape": {
     "description": "\"blob\" | \"circle\" | \"diagonal\" | \"rounded\" | \"bars\" | \"diamond\" | \"halftone\" | \"conic\" | \"slats\" | \"path\" (optional, default \"blob\")"
    },
    "d": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 4000 characters; used only when shape is \"path\"). An SVG path of straight and curve commands (M L H V C S Q T Z, absolute or relative; no arcs A, no exponent numbers, numbers up to 1000000). Only the first subpath is used. It is flattened, resampled to 48 points and stretched to fill the box, then scales in from the centre as p goes 0 to 1 (a 48-vertex clip polygon, pure CSS); at p = 1 the child shows through the whole shape. A missing or invalid d, or one that covers less than 1% of the box (a straight line), is ignored with an HTML comment and the blob is used. Absent: unchanged."
    },
    "blocks": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (max 6) of any atom blocks, revealed together. Each may carry an id a timeline track can address."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"}
  },
  "motion_envelope": {
   "type": "object",
   "description": "An envelope that carries a letter. Children are ordinary atoms shown on the letter card. With mode open, the flap flips up and the letter rises out as p goes 0 to 1; with mode seal, the letter drops in, the flap closes and the stamp lands. Optional address line (to) and stamp text. Plain HTML and CSS, no script; standalone it renders the finished state (open: letter out; seal: sealed and stamped). Use inside a motion_timeline to show a message being packed or delivered, e.g. an A2UI payload wrapped as an MCP tool result.",
   "properties": {
    "component": {
     "const": "motion_envelope"
    },
    "mode": {
     "description": "\"open\" | \"seal\" (optional, default \"open\")"
    },
    "width": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Envelope width px, 80-900; height is 5/8 of it. Default 360."
    },
    "blocks": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (max 3) of atom blocks shown on the letter. They render finished (they do not follow the envelope's p)."
    },
    "to": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 60). Address line on the front, e.g. \"ui://jobs/board\"."
    },
    "stamp": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 24). Stamp text, e.g. \"tool result\". In seal mode it lands at the end."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 40). Accessible name. Default \"Envelope\"."
    },
    "fill": {
     "description": "\"#rrggbb\" (optional). Envelope colour. Default a tint of the stage background."
    },
    "accent": {
     "description": "\"#rrggbb\" (optional). Fold edges and stamp. Default the stage accent."
    },
    "color": {
     "description": "\"#rrggbb\" (optional). Address text. Default the stage ink."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"}
  },
  "motion_rays": {
   "type": "object",
   "description": "A sunburst that fans out behind a hero as p goes 0 to 1 (kind burst, --s turns it), or horizontal speed streaks that sweep across the frame (kind speed, --s slides them). Plain CSS gradients, no script; standalone it renders finished.",
   "properties": {
    "component": {
     "const": "motion_rays"
    },
    "kind": {
     "description": "\"burst\" | \"speed\" (optional, default \"burst\")"
    },
    "angle": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Kind speed only: the direction the lines run, in degrees clockwise from horizontal, -180 to 180. Default 0 (horizontal lines streaming left to right as step advances). The lines and their travel turn together inside the same 16:9 frame, clipped to it. Ignored by burst; 0 or a non-number keeps the horizontal look exactly."
    },
    "count": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Rays or lines, 4-64. Default 24."
    },
    "thickness": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Share of each step that is ray, 0.1-0.9. Default 0.5."
    },
    "spin": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Degrees turned at --s = 1 (burst), -360 to 360. Default 45."
    },
    "strength": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Peak opacity, 0.05-1. Default 0.35."
    },
    "accent": {
     "description": "\"#rrggbb\" (optional). Default the stage accent."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "native", "compose": "native"}
  },
  "motion_hud": {
   "type": "object",
   "description": "A heads-up display that fills its placed box: corner brackets, a timecode that counts up from 0 to `seconds` as p goes 0 to 1, a label top right and a progress bar along the bottom. The recording-viewfinder look. Plain HTML and CSS; the timecode is rewritten by the timeline clock like motion_counter.",
   "properties": {
    "component": {
     "const": "motion_hud"
    },
    "seconds": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Where the timecode ends, 1-3600. Default 10."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 30). Top right, e.g. REC."
    },
    "corners": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Corner brackets. Default true."
    },
    "bar": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Progress bar. Default true."
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). px, 8-60. Default 14."
    },
    "color": {
     "description": "\"#rrggbb\" (optional). Default the stage ink."
    },
    "accent": {
     "description": "\"#rrggbb\" (optional). Default the stage accent."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"}
  },
  "motion_lower_third": {
   "type": "object",
   "description": "A lower third: an accent bar draws, the name slides out of it behind a clip, and the role fades in under it as p goes 0 to 1. Plain CSS, no script; standalone it renders finished.",
   "properties": {
    "component": {
     "const": "motion_lower_third"
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (max 40)."
    },
    "role": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 60)."
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Name px, 10-120. Default 36."
    },
    "color": {
     "description": "\"#rrggbb\" (optional). Name. Default the stage ink."
    },
    "accent": {
     "description": "\"#rrggbb\" (optional). Bar and role. Default the stage accent."
    },
    "fill": {
     "description": "\"#rrggbb\" (optional). Panel. Default near-black."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"}
  },
  "motion_finish": {
   "type": "object",
   "description": "A finishing layer for the whole frame, like a colourist: film grain (fixed seeded noise, drifting with --s), a vignette, warm or cool light leaks that drift, and an optional glass sheen that sweeps across with p. Place it last and full size (place 0,0,100,100); it never takes clicks. p fades it in. Plain SVG and CSS, no script.",
   "properties": {
    "component": {
     "const": "motion_finish"
    },
    "grain": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Film grain. Default true."
    },
    "grain_amount": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). 0-0.5. Default 0.12."
    },
    "grain_size": {
     "description": "\"fine\" | \"medium\" | \"coarse\" (optional, default \"medium\")"
    },
    "vignette": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Default true."
    },
    "vignette_amount": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). 0-1. Default 0.55."
    },
    "leak": {
     "description": "\"warm\" | \"cool\" | false (optional, default \"warm\")"
    },
    "leak_amount": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). 0-1. Default 0.35."
    },
    "sheen": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). A diagonal highlight band sweeping across with p. Default false."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "native", "compose": "native"}
  },
  "motion_arch": {
   "type": "object",
   "description": "An architecture diagram that draws itself on the film clock. Nodes (device, app, server, tool, model, store, surface, user) pop in, edges draw box edge to box edge with arrowheads and labels, and messages, the payloads that actually move, ride the edges as chips (back true for the reply). Each element has a window [at, at + dur] of the progress p a motion_timeline track drives; standalone it is the finished diagram. Pure SVG and CSS, no script.",
   "properties": {
    "component": {
     "const": "motion_arch"
    },
    "nodes": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (max 12) of {id, kind?, label, sub?, x, y, w?, h?, at?, dur?}. id ^[a-z][a-z0-9_-]{0,31}$. kind \"device\" | \"app\" | \"server\" | \"tool\" | \"model\" | \"store\" | \"surface\" | \"user\" (default \"server\") sets the glyph and tint. x, y are the centre in percent of the frame; w, h percent (default 20 and 15). at, dur are the appearance window in p (0-1)."
    },
    "edges": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (max 16) of {from, to, label?, label2?, style?, both?, curve?, points?, label_at?, color?, at?, dur?}. from and to are node ids. style \"solid\" (draws on) | \"dashed\" (fades in). both adds a second arrowhead. curve -100 to 100 bends it. points (optional, max 10) is the edge's own route, a list of {x, y} in percent of the frame from the first box's rim to the second's: it is drawn as a polyline with rounded corners (see radius) instead of the curve, the arrowhead follows the last segment, and messages ride the route. label_at (optional) {x, y} in percent is where the centre of the label goes (default: above the middle of the route or curve); a routed edge's label is drawn above the message chips. Numbers only; an invalid points or label_at is ignored. label (max 48) is the text on the edge; label2 (optional, max 48, drawn only when label is set) is a second line under it, so a long label can wrap onto two lines instead of being cut."
    },
    "messages": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (max 12) of {edge, text, back?, color?, at?, dur?}. edge is an index into edges; text (max 40) is the payload chip; back true sends it from the edge's end to its start."
    },
    "groups": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (max 4) of {label, x, y, w, h, at?, dur?}: dashed boundaries in percent of the frame."
    },
    "w": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). ViewBox width, 200-2000. Default 1000."
    },
    "h": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). ViewBox height, 120-2000. Default 560."
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Label px, 8-40. Default 17."
    },
    "radius": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Corner radius px of edges that have points, 0-60. Default 10. Never more than half of a segment."
    },
    "accent": {
     "description": "\"#rrggbb\" (optional). Device, app and surface nodes, and messages. Default the stage accent."
    },
    "accent2": {
     "description": "\"#rrggbb\" (optional). Server and tool nodes, and edges. Default \"#2ac4ce\"."
    },
    "color": {
     "description": "\"#rrggbb\" (optional). Label ink. Default the stage ink."
    },
    "mute": {
     "description": "\"#rrggbb\" (optional). Sub-labels and group frames. Default \"#9ca5b1\"."
    },
    "fill": {
     "description": "\"#rrggbb\" (optional). Node fill. Default \"#2d3642\"."
    },
    "background": {
     "description": "\"#rrggbb\" (optional). Halo behind edge labels; match the stage. Default \"#1e2733\"."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 80). Accessible name. Default \"Architecture diagram\"."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"}
  },
  "motion_video": {
   "type": "object",
   "description": "A muted video on the film clock. Inside a motion_timeline a track drives its progress p from 0 to 1 and the video seeks to from + p * (to - from), so scrubbing and frame export are exact; standalone it plays muted and loops. Made for screen recordings inside motion_device, with the motion design around them. Encode with short keyframe intervals for smooth seeking.",
   "properties": {
    "component": {
     "const": "motion_video"
    },
    "url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. https URL or a /-rooted path to an mp4 or webm (no data URLs). Otherwise a placeholder shows."
    },
    "poster": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). https URL or /-rooted image path shown before the first frame."
    },
    "from": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Seconds into the video at p = 0, 0-3600. Default 0."
    },
    "to": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Seconds at p = 1, 0-3600. Default the end of the video."
    },
    "ratio": {
     "description": "\"16:9\" | \"4:3\" | \"1:1\" | \"3:4\" | \"9:16\" | \"9:19.5\" (optional, default \"16:9\"). 9:19.5 is a modern phone screen."
    },
    "fit": {
     "description": "\"cover\" | \"contain\" (optional, default \"cover\")"
    },
    "radius": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Corner px, 0-60. Default 12."
    },
    "still": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Standalone, hold the first frame instead of playing. Default false."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 80). Accessible name. Default \"Video\"."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "native", "compose": "native"}
  },
  "motion_shader": {
   "type": "object",
   "description": "A WebGL shader background: a domain-warped liquid gradient (kind liquid), soft aurora bands (kind aurora) or folded satin with a moving sheen (kind silk) in three colours. Seekable: shader time follows the film, read from the second dial (--s) every frame, so a step track drives it and seeking shows exactly that frame (span = shader seconds per unit of --s); standalone it runs on its own clock, or holds still with still true or under reduced motion. The shader and its driver are fixed in the renderer and the config is numbers only, so nothing in the payload becomes code. Its own CSS gradient of the same colours is the fallback when WebGL is missing, the shader fails, the page prints or the host strips scripts. p fades it in. Preview: a spike to judge whether WebGL earns a place.",
   "properties": {
    "component": {
     "const": "motion_shader"
    },
    "kind": {
     "description": "\"liquid\" | \"aurora\" | \"silk\" | \"dots\" | \"vortex\" (optional, default \"liquid\"). dots: a halftone wave, a grid of dots whose size swells and fades in waves (color1 the ground, color2 and color3 the dots). vortex: dots arranged in a spiral tunnel that recedes to the centre and turns with time. silk: satin folds lit from their own surface, color1 the shadowed cloth, color2 the lit cloth, color3 the sheen."
    },
    "color1": {
     "description": "\"#rrggbb\" (optional). Deep colour. Default #0b0712."
    },
    "color2": {
     "description": "\"#rrggbb\" (optional). Default #ff3d81."
    },
    "color3": {
     "description": "\"#rrggbb\" (optional). Default #ffb347."
    },
    "scale": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Pattern scale, 0.5-12. Default 2."
    },
    "span": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Shader seconds per unit of --s, 0-600. Default 20."
    },
    "speed": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Standalone speed, 0-5. Default 1."
    },
    "still": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Standalone, hold a still frame. Default false."
    },
    "ratio": {
     "description": "\"16:9\" | \"4:3\" | \"1:1\" | \"3:4\" | \"9:16\" (optional, default \"16:9\")"
    },
    "fill": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Fill the placed box height instead of using ratio. Default false."
    },
    "radius": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Corner px, 0-60. Default 0."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 60). Accessible name."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_verified", "lit": "drawn", "angular": "drawn", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "not_supported", "compose": "not_supported"}
  },
  "motion_bricks": {
   "type": "object",
   "description": "A toy-brick sculpture on the film clock: procedural boxes with real brick proportions, studs, shadows and instruction-style edges (the brick_build_3d engine, here with boxes only; real LDraw parts are brick_build_3d's partsModel), drawn on a transparent stage so it sits inside a film. Bricks drop into place in build order as p goes 0 to 1 (p 1 = every brick settled) and the model turns with the second dial (--s, turns per unit), so a step track spins it and seeking shows exactly that frame. Give text to set a word in bricks (each character of a 5x7 dot font, every row merged into 1x1 to 1x4 bricks, depth studs deep), bricks for an explicit model, or a named shape. The optional motion object sets how the bricks arrive: the order they launch in, where they fly in from, how long each flight lasts, how much they tumble, and a small overshoot and recoil as they seat; all of it is numbers and fixed names that are clamped, and a stud-cell pass keeps a brick from launching before the brick it rests on. Standalone it shows the finished model. The engine is fixed code and the config is numbers, colours and the brick list, so nothing in the payload becomes code; without WebGL the engine draws with a 2D canvas painter instead. Known limit: each brick canvas holds two WebGL contexts and a page allows about 16, so keep to about 7 brick canvases per page. Not affiliated with or endorsed by the LEGO Group. LEGO is a trademark of the LEGO Group.",
   "properties": {
    "component": {
     "const": "motion_bricks"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 12). Builds the word in bricks: A-Z, 0-9 and . , ! ? - : ' (others leave a gap)."
    },
    "bricks": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional). Explicit toy-brick model (procedural boxes, up to 3000), same format as brick_build_3d: {x, y, z, w, d, h, c} or [x, y, z, w, d, c] / [x, y, z, w, d, h, c]. Used when text is absent."
    },
    "shape": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). One of \"heart\", \"sphere\", \"torus\", \"helix\", \"pyramid\", \"house\". Default \"heart\". Used when neither text nor bricks is given."
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). A \"#rrggbb\" colour. One colour for every lettering brick; otherwise letters cycle through palette or the classic brick colours."
    },
    "palette": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of \"#rrggbb\" (optional). Colours for lettering (cycled per letter) and for integer colour indexes in bricks."
    },
    "depth": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Lettering depth in studs, 1-4. Default 2."
    },
    "base": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). \"none\" for floating bricks (no plate, no plate shadow), or a \"#rrggbb\" colour for the baseplate. Default the classic green plate."
    },
    "look": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). One of \"studio\", \"instructions\". Default \"studio\". studio: a product shot (glossy ABS, softbox reflections, edges that catch light, no outlines). instructions: the building-instructions style of brick_build_3d (dark edge lines)."
    },
    "angle": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Starting turn in degrees, -360 to 360. Default 24."
    },
    "elevation": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Camera elevation in degrees, 7-75. Default 26."
    },
    "turns": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Full turns per unit of --s, -8 to 8. Default 1."
    },
    "motion": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (optional). How the bricks arrive; absent = the plain build-up. Every key is optional and clamped, unknown keys are ignored, and a value that is not a number or a known name falls back to its default. order: \"index\" (the brick list order) | \"base-up\" (layer by layer) | \"diagonal\" | \"radial\" (default \"diagonal\"). from: \"above\" | \"outward\" | \"scatter\" (where bricks start; default \"above\"). spinAxis: \"y\" | \"x\" | \"z\" (default \"y\"). window: 0-30, default 2.4, how widely the launch times are spread. flight: 0.1-5, default 0.62, how long one brick is in the air; together they set the pace, since p 0 to 1 covers window + flight. distance: 0-60, default 9, start distance in stud units. tilt: 0-360, default 70, random start tumble in degrees. spin: -8 to 8, default 0.5, extra turns while flying. gravity: 0-1, default 0.5, how strongly lower bricks go first (diagonal and radial orders). jitter: 0-1, default 0.15, random shuffle of the order. support: 0 or 1, default 1, a brick never launches before the brick it rests on. seed: integer 0-2147483646, default 7. overshoot 0-1 (0.12), rotOvershoot 0-0.5 (0.08), recoil 0-1 (0.45), travel 0.2-0.9 (0.58), sharpness 1.5-8 (4): the seat-and-settle curve. direction: [x, y, z], default [1, 0.55, 0.8], the sweep direction for the diagonal order."
    },
    "ratio": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). One of \"16:9\", \"4:3\", \"1:1\", \"3:4\", \"9:16\". Default \"16:9\"."
    },
    "fill": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional). Fill the placed box height instead of using ratio. Default false."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 80). Accessible name."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "not_supported", "compose": "not_supported"}
  },
  "block_robot": {
   "type": "object",
   "description": "A small toy-brick robot: legs, blue body, grey arms, white head, eyes and a red top brick. A finished model of 10 toy bricks in one block: the brick list is fixed, so nothing needs writing out; it is the motion_bricks canvas with that list filled in, and every motion_bricks setting that does not name bricks works here the same way. Bricks drop into place in build order as p goes 0 to 1 and the model turns with the second dial (--s). Standalone it shows the finished model. Known limit, each brick canvas holds two WebGL contexts and a page allows about 16, so keep to about 7 brick canvases per page. Not affiliated with or endorsed by the LEGO Group. LEGO is a trademark of the LEGO Group.",
   "properties": {
    "component": {
     "const": "block_robot"
    },
    "motion": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (optional). How the bricks arrive, same keys and defaults as motion_bricks motion (order, from, window, flight, distance, tilt, spin, spinAxis, gravity, jitter, support, seed, overshoot, rotOvershoot, recoil, travel, sharpness, direction). Absent = the plain build-up."
    },
    "angle": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Starting turn in degrees, -360 to 360. Default 24."
    },
    "elevation": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Camera elevation in degrees, 7-75. Default 26."
    },
    "turns": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Full turns per unit of --s, -8 to 8. Default 1."
    },
    "look": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). One of \"studio\", \"instructions\". Default \"studio\" (a product shot: glossy plastic, no outlines); \"instructions\" is building-instructions style with dark edge lines."
    },
    "base": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). \"none\" for floating bricks (no plate, no plate shadow), or a \"#rrggbb\" colour for the baseplate. Default the classic green plate."
    },
    "ratio": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). One of \"16:9\", \"4:3\", \"1:1\", \"3:4\", \"9:16\". Default \"16:9\"."
    },
    "fill": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional). Fill the placed box height instead of using ratio. Default false."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 80). Accessible name. Default \"Brick robot\"."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_measured", "lit": "not_measured", "angular": "not_measured", "copilotkit": "not_measured", "a2ui-vue": "not_measured", "flutter": "native", "compose": "native"},
   "x-routing-text": "A small toy-brick robot: legs, blue body, grey arms, white head, eyes and a red top brick. A pre-composed 10-brick toy-brick model for a motion timeline: a block you place and time, not bricks you write.",
   "x-intent-phrases": [
    "I want a little robot made of toy bricks that assembles itself in my video.",
    "Drop a finished brick robot into the scene and make its pieces fall into place.",
    "Can I show a brick-built mascot character building up step by step?"
   ]
  },
  "block_rocket": {
   "type": "object",
   "description": "A small toy-brick rocket: two grey nozzle bricks, red fins, a dark band, a white hull, a window and a red nose. A finished model of 9 toy bricks in one block: the brick list is fixed, so nothing needs writing out; it is the motion_bricks canvas with that list filled in, and every motion_bricks setting that does not name bricks works here the same way. Bricks drop into place in build order as p goes 0 to 1 and the model turns with the second dial (--s). Standalone it shows the finished model. Known limit, each brick canvas holds two WebGL contexts and a page allows about 16, so keep to about 7 brick canvases per page. Not affiliated with or endorsed by the LEGO Group. LEGO is a trademark of the LEGO Group.",
   "properties": {
    "component": {
     "const": "block_rocket"
    },
    "motion": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (optional). How the bricks arrive, same keys and defaults as motion_bricks motion (order, from, window, flight, distance, tilt, spin, spinAxis, gravity, jitter, support, seed, overshoot, rotOvershoot, recoil, travel, sharpness, direction). Absent = the plain build-up."
    },
    "angle": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Starting turn in degrees, -360 to 360. Default 24."
    },
    "elevation": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Camera elevation in degrees, 7-75. Default 26."
    },
    "turns": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Full turns per unit of --s, -8 to 8. Default 1."
    },
    "look": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). One of \"studio\", \"instructions\". Default \"studio\" (a product shot: glossy plastic, no outlines); \"instructions\" is building-instructions style with dark edge lines."
    },
    "base": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). \"none\" for floating bricks (no plate, no plate shadow), or a \"#rrggbb\" colour for the baseplate. Default the classic green plate."
    },
    "ratio": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). One of \"16:9\", \"4:3\", \"1:1\", \"3:4\", \"9:16\". Default \"16:9\"."
    },
    "fill": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional). Fill the placed box height instead of using ratio. Default false."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 80). Accessible name. Default \"Brick rocket\"."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_measured", "lit": "not_measured", "angular": "not_measured", "copilotkit": "not_measured", "a2ui-vue": "not_measured", "flutter": "native", "compose": "native"},
   "x-routing-text": "A small toy-brick rocket: two grey nozzle bricks, red fins, a dark band, a white hull, a window and a red nose. A pre-composed 9-brick toy-brick model for a motion timeline: a block you place and time, not bricks you write.",
   "x-intent-phrases": [
    "I want a toy-brick rocket that builds itself in my launch animation.",
    "Show a brick-built spaceship assembling piece by piece.",
    "Can I drop a small rocket made of bricks into a timeline and have it build up?"
   ]
  },
  "dot_grid_background": {
   "type": "object",
   "description": "Panel with a CSS repeating dot, grid, or cross background pattern using background-image with radial-gradient or linear-gradient. No SVG, no JavaScript. Useful as a texture layer behind content in dark or light themes.",
   "properties": {
    "component": {
     "const": "dot_grid_background"
    },
    "variant": {
     "description": "\"dots\" | \"grid\" | \"cross\"  (optional, default \"dots\")"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Text heading overlaid on the pattern."
    },
    "body": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Body text overlaid on the pattern (markdown inline supported)."
    },
    "dot_color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Dot or line colour. Default \"rgba(148,163,184,0.35)\"."
    },
    "background": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Panel background fill. Default \"#0d1525\"."
    },
    "spacing": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Grid cell size in px. Default 24."
    },
    "dot_size": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Dot radius in px (dots variant only). Default 1."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Panel with a CSS repeating dot, grid, or cross background pattern using background-image with radial-gradient or linear-gradient. No SVG, no JavaScript. Useful as a texture layer behind content in dar",
   "x-intent-phrases": [
    "I need a subtle, textured backdrop for my app's dashboard elements.",
    "Can I get a soft, dotted pattern behind my cards without using images?",
    "I want a light grid effect to give my app sections some visual separation."
   ]
  },
  "shimmer_button": {
   "type": "object",
   "description": "Inline button or link with a diagonal shimmer sweep animation driven by CSS background-position keyframes. The shimmer accent colour sweeps across the button on a loop. No JavaScript. Use for primary CTAs on dark backgrounds.",
   "properties": {
    "component": {
     "const": "shimmer_button"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Button text."
    },
    "href": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). If set, renders as an anchor tag."
    },
    "size": {
     "description": "\"sm\" | \"md\" | \"lg\"  (optional, default \"md\")"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Shimmer highlight colour. Default \"#38bdf8\"."
    },
    "background": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Button background colour. Default \"#1e293b\"."
    },
    "speed": {
     "description": "\"slow\" | \"normal\" | \"fast\"  (optional, default \"normal\")"
    },
    "description": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Small text below the button."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Inline button or link with a diagonal shimmer sweep animation driven by CSS background-position keyframes. The shimmer accent colour sweeps across the button on a loop. No JavaScript. Use for primary",
   "x-intent-phrases": [
    "I need a button that grabs attention for my sign-up form.",
    "Make the 'Add to Cart' button visually exciting for users.",
    "We need a prominent call to action for our special offer."
   ]
  },
  "card_stack": {
   "type": "object",
   "description": "Two to four cards stacked with CSS transform rotate and translateY, creating a fanned deck effect. The front card shows full title and body; back cards are progressively rotated and faded. No JavaScript — purely presentational. Useful for showcasing multiple items with a premium layered feel.",
   "properties": {
    "component": {
     "const": "card_stack"
    },
    "cards": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. Each card: {title, body, accent}. Max 4 cards."
    },
    "background": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Card background colour. Default \"#1e293b\"."
    },
    "border_color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Card border colour. Default \"rgba(255,255,255,0.08)\"."
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Card height in px. Default 160."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Two to four cards stacked with CSS transform rotate and translateY, creating a fanned deck effect. The front card shows full title and body; back cards are progressively rotated and faded. No JavaScri",
   "x-intent-phrases": [
    "I need to show a few related articles, but only the first one should be fully visible.",
    "How can I display a preview of upcoming tasks without taking up much screen space?",
    "Can I make a list of recent notifications where only the newest one is clear?"
   ]
  },
  "meteor_shower": {
   "type": "object",
   "description": "Dark panel with CSS-animated diagonal streaks that fall across the surface like a meteor shower. Each meteor is a rotated span with a linear-gradient tail, animated with staggered delays — no JavaScript, no canvas. Optional title and body text render above the effect layer.",
   "properties": {
    "component": {
     "const": "meteor_shower"
    },
    "count": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Number of meteors. Default 20. Max 40."
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Meteor streak colour. Default \"#38bdf8\"."
    },
    "speed": {
     "description": "\"slow\" | \"normal\" | \"fast\"  (optional, default \"normal\")"
    },
    "background": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Panel background colour. Default \"#0a0f1d\"."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Text heading overlaid on the effect."
    },
    "body": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Body text overlaid on the effect (markdown inline supported)."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Dark panel with CSS-animated diagonal streaks that fall across the surface like a meteor shower. Each meteor is a rotated span with a linear-gradient tail, animated with staggered delays — no JavaScri",
   "x-intent-phrases": [
    "I need a cool visual effect for my loading screen, something dynamic and mesmerizing.",
    "Can I get a way to show a brief, attention-grabbing animation when a new message arrives?",
    "I'm looking for a subtle, flowing background element to add depth to a specific section of my app."
   ]
  },
  "blur_fade_in": {
   "type": "object",
   "description": "Container that animates from blurred and transparent to fully visible on mount. Uses CSS @keyframes with filter:blur() and opacity together — no JavaScript. Configurable delay, duration, and direction (up, down, left, right, none).",
   "properties": {
    "component": {
     "const": "blur_fade_in"
    },
    "children": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of atom objects to render inside the container (optional)."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Heading text."
    },
    "body": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Body text (markdown inline supported)."
    },
    "delay": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). CSS delay before animation starts, e.g. \"0.3s\". Default \"0s\"."
    },
    "speed": {
     "description": "\"slow\" | \"normal\" | \"fast\"  (optional, default \"normal\")"
    },
    "direction": {
     "description": "\"up\" | \"down\" | \"left\" | \"right\" | \"none\"  (optional, default \"up\"). Drift direction on reveal."
    },
    "blur": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Starting blur radius, e.g. \"8px\". Default \"8px\"."
    },
    "background": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Panel background. Default transparent."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Container that animates from blurred and transparent to fully visible on mount. Uses CSS @keyframes with filter:blur() and opacity together — no JavaScript. Configurable delay, duration, and direction",
   "x-intent-phrases": [
    "I need content to smoothly appear on the screen when the page loads.",
    "Can I make an element gradually become clear and sharp after a pause?",
    "I want to add a subtle entrance effect to new sections of my page."
   ]
  },
  "glow_button": {
   "type": "object",
   "description": "Button or anchor that uses CSS box-shadow to signal state. Three named states — disabled (grey), ready (brand), fired (success pulse) — each with a distinct glow colour and optional pulse animation. State is set via the state field; no JavaScript required.",
   "properties": {
    "component": {
     "const": "glow_button"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Button text."
    },
    "state": {
     "description": "\"disabled\" | \"ready\" | \"fired\"  (optional, default \"ready\")"
    },
    "href": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). If set renders as an anchor tag."
    },
    "color_ready": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Glow colour in ready state. Default \"#38bdf8\"."
    },
    "color_fired": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Glow colour in fired state. Default \"#34d399\"."
    },
    "size": {
     "description": "\"sm\" | \"md\" | \"lg\"  (optional, default \"md\")"
    },
    "description": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Small caption text below the button."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-side-panel",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Button or anchor that uses CSS box-shadow to signal state. Three named states — disabled (grey), ready (brand), fired (success pulse) — each with a distinct glow colour and optional pulse animation. S",
   "x-intent-phrases": [
    "I need a button that changes color when I can click it, and a different color when it's done.",
    "Can I have a button that flashes briefly when something important happens?",
    "I need buttons that look a bit faded and unclickable until the user is ready."
   ]
  },
  "animated_beam": {
   "type": "object",
   "description": "Inline SVG panel showing two labelled endpoint nodes connected by a path with a pulsing light dot that travels along it, animating via CSS stroke-dashoffset. No JavaScript, no mousemove. Visualises data routing between two named components.",
   "properties": {
    "component": {
     "const": "animated_beam"
    },
    "from_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Left/source node label."
    },
    "to_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Right/target node label."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Small caption above the beam diagram."
    },
    "body": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Description text below the diagram."
    },
    "active": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Whether the beam pulse animates. Default true."
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Beam and node accent colour. Default \"#38bdf8\"."
    },
    "speed": {
     "description": "\"slow\" | \"normal\" | \"fast\"  (optional, default \"normal\")"
    },
    "curved": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Use a curved cubic-bezier path. Default true."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Inline SVG panel showing two labelled endpoint nodes connected by a path with a pulsing light dot that travels along it, animating via CSS stroke-dashoffset. No JavaScript, no mousemove. Visualises da",
   "x-intent-phrases": [
    "I need to show data flow between two points on a diagram.",
    "Can I visualize network connections with a moving indicator?",
    "We need a way to represent active processes moving between server locations."
   ]
  },
  "encrypted_reveal": {
   "type": "object",
   "description": "Text that appears to scramble through random alphanumeric characters before locking into the final readable string. Implemented entirely in CSS using a steps() @keyframes animation cycling through server-side pre-generated scrambled frames — no JavaScript required.",
   "properties": {
    "component": {
     "const": "encrypted_reveal"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The final text to reveal."
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Font size e.g. \"32px\". Default \"28px\"."
    },
    "weight": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Font weight. Default \"700\"."
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Text colour. Default \"#f1f5f9\"."
    },
    "scramble_color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Colour of scramble characters. Default \"#38bdf8\"."
    },
    "speed": {
     "description": "\"slow\" | \"normal\" | \"fast\"  (optional, default \"normal\")"
    },
    "delay": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). CSS delay before reveal starts. Default \"0s\"."
    },
    "frames": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Number of scramble frames before lock. Default 8."
    },
    "background": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Container background. Default transparent."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Text that appears to scramble through random alphanumeric characters before locking into the final readable string. Implemented entirely in CSS using a steps() @keyframes animation cycling through ser",
   "x-intent-phrases": [
    "I need to display sensitive info that briefly flashes before showing.",
    "Show temporary codes that look like they're loading securely.",
    "Make passwords disappear and reappear in a cool, glitchy way."
   ]
  },
  "word_flip": {
   "type": "object",
   "description": "Inline overflow-hidden container that cycles through a list of words using a CSS steps() translateY animation. The agent provides the word array; the component handles all timing and looping. Useful for dynamic hero headlines such as \"Grow your [Retention | Revenue | Signups]\". No JavaScript required.",
   "properties": {
    "component": {
     "const": "word_flip"
    },
    "words": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of strings. The words to cycle through. Minimum 2."
    },
    "prefix": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Static text before the flipping section, e.g. \"Grow your \"."
    },
    "suffix": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Static text after the flipping section."
    },
    "speed": {
     "description": "\"slow\" | \"normal\" | \"fast\"  (optional, default \"normal\"). Per-word hold duration."
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Flipping word colour. Default \"#38bdf8\"."
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Font size, e.g. \"32px\". Default \"inherit\"."
    },
    "weight": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Font weight of flipping words. Default \"700\"."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-side-panel",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Inline overflow-hidden container that cycles through a list of words using a CSS steps() translateY animation. The agent provides the word array; the component handles all timing and looping. Useful f",
   "x-intent-phrases": [
    "I need text to smoothly change between different headlines on my landing page.",
    "Showcase rotating feature titles that appear one after another without jarring jumps.",
    "Can we have a dynamic slogan that animates through a set of phrases?"
   ]
  },
  "sonar_pulse": {
   "type": "object",
   "description": "A visual attention primitive that emits three concentric ring pulses outward from a centre point using staggered CSS @keyframes. Each ring animates independently with a 1-second delay offset, creating a continuous sonar effect. Four named variants map to semantic colours. No JavaScript required.",
   "properties": {
    "component": {
     "const": "sonar_pulse"
    },
    "variant": {
     "description": "\"critical\" | \"success\" | \"info\" | \"warning\"  (optional, default \"critical\")"
    },
    "active": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). If false renders as a static dot. Default true."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Short text label centred in the pulse ring."
    },
    "size": {
     "description": "\"sm\" | \"md\" | \"lg\"  (optional, default \"md\"). Controls ring diameter."
    },
    "body": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Caption text below the pulse ring."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-side-panel",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A visual attention primitive that emits three concentric ring pulses outward from a centre point using staggered CSS @keyframes. Each ring animates independently with a 1-second delay offset, creating",
   "x-intent-phrases": [
    "I need a subtle way to show something is actively happening.",
    "How can I draw attention to a specific area without being jarring?",
    "I want a visual cue that indicates a process is underway."
   ]
  },
  "typewriter": {
   "type": "object",
   "description": "Text that reveals itself character-by-character using a CSS steps() width animation on an overflow-hidden monospace container, with an optional blinking cursor. No JavaScript required.",
   "properties": {
    "component": {
     "const": "typewriter"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The text to type out."
    },
    "speed": {
     "description": "\"slow\" | \"normal\" | \"fast\"  (optional, default \"normal\")"
    },
    "cursor": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Show blinking cursor after typing. Default true."
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Text colour. Default \"#0f172a\"."
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Font size e.g. \"1.4rem\". Default \"1.4rem\"."
    },
    "weight": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Font weight. Default \"600\"."
    },
    "background": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Container background. Default \"#f8fafc\"."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Text that reveals itself character-by-character using a CSS steps() width animation on an overflow-hidden monospace container, with an optional blinking cursor. No JavaScript required.",
   "x-intent-phrases": [
    "I need text to appear as if someone is typing it out, one letter at a time.",
    "Can I make a piece of text slowly fade in, like a message being revealed?",
    "I want a simulated command-line prompt effect for a section of my page."
   ]
  },
  "number_odometer": {
   "type": "object",
   "description": "Slot-machine style digit-by-digit flip animation where each digit column independently scrolls to its target value using staggered CSS translateY keyframes. Distinct from animated_counter which counts up sequentially — this flips each digit column independently.",
   "properties": {
    "component": {
     "const": "number_odometer"
    },
    "value": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The target number to display e.g. \"1337\" or \"42.5k\"."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Caption below the number."
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Digit colour. Default \"#0f172a\"."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Accent colour. Default \"#4f46e5\"."
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Font size. Default \"3rem\"."
    },
    "duration": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Animation duration in seconds. Default 1.2."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Slot-machine style digit-by-digit flip animation where each digit column independently scrolls to its target value using staggered CSS translateY keyframes. Distinct from animated_counter which counts",
   "x-intent-phrases": [
    "I need a way to show a changing, large number that feels dynamic, like a score ticking up.",
    "We need to display real-time stock prices that update smoothly, digit by digit.",
    "Can we show a countdown timer that visually rolls down through the numbers?"
   ]
  },
  "typing_indicator": {
   "type": "object",
   "description": "Three bouncing dots inside a chat bubble that signals an agent or user is composing a response. Each dot animates with a staggered delay using CSS @keyframes translateY, creating a continuous wave effect.",
   "properties": {
    "component": {
     "const": "typing_indicator"
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Agent or user name shown above the bubble. Default \"Agent\"."
    },
    "variant": {
     "description": "\"dark\" | \"light\"  (optional, default \"dark\"). Bubble colour scheme."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-side-panel",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Three bouncing dots inside a chat bubble that signals an agent or user is composing a response. Each dot animates with a staggered delay using CSS @keyframes translateY, creating a continuous wave eff",
   "x-intent-phrases": [
    "Show me when the other person is typing so I don't have to wait wondering.",
    "I need to know if someone is about to send me a message.",
    "Let me see that the other person is actively writing back."
   ]
  },
  "countdown_timer": {
   "type": "object",
   "description": "Flip-clock style countdown display showing hours, minutes, and seconds in individual digit tiles. Renders a static snapshot of the target time — pair with a dataModelUpdate SSE stream to tick the values.",
   "properties": {
    "component": {
     "const": "countdown_timer"
    },
    "hours": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Hours component. Default 0."
    },
    "minutes": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Minutes component. Default 4."
    },
    "seconds": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Seconds component. Default 59."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Caption below the timer."
    },
    "variant": {
     "description": "\"dark\" | \"light\"  (optional, default \"dark\")."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Separator and accent colour. Default \"#00f2ff\"."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Flip-clock style countdown display showing hours, minutes, and seconds in individual digit tiles. Renders a static snapshot of the target time — pair with a dataModelUpdate SSE stream to tick the valu",
   "x-intent-phrases": [
    "I need to show users how much time is left until a sale ends.",
    "Can I display a ticking clock for an upcoming event's start?",
    "My app needs to track time remaining for a limited-time offer."
   ]
  },
  "gradient_text": {
   "type": "object",
   "description": "Heading text rendered with an animated shifting gradient fill using CSS background-clip:text and a background-position keyframe. The gradient flows continuously between the from/to colours, creating a shimmer effect on titles and hero text.",
   "properties": {
    "component": {
     "const": "gradient_text"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The heading text to display."
    },
    "from": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Gradient start colour. Default \"#4f46e5\"."
    },
    "to": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Gradient end colour. Default \"#06b6d4\"."
    },
    "via": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Optional midpoint colour."
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Font size. Default \"2rem\"."
    },
    "weight": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Font weight. Default \"800\"."
    },
    "duration": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Cycle duration in seconds. Default 4."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Heading text rendered with an animated shifting gradient fill using CSS background-clip:text and a background-position keyframe. The gradient flows continuously between the from/to colours, creating a",
   "x-intent-phrases": [
    "Make my headline really pop and feel alive.",
    "I need the title of this section to be visually exciting.",
    "Can we have the main heading shimmer a bit as people scroll?"
   ]
  },
  "reveal_on_scroll": {
   "type": "object",
   "description": "Content block that starts invisible and fades + slides into view when scrolled into the viewport, using an IntersectionObserver with a CSS class toggle. Requires a small inline script — degrades gracefully to visible static content where JS is unavailable.",
   "properties": {
    "component": {
     "const": "reveal_on_scroll"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Bold heading inside the block."
    },
    "body": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Body text inside the block."
    },
    "direction": {
     "description": "\"up\" | \"down\" | \"left\" | \"right\"  (optional, default \"up\"). Drift direction before reveal."
    },
    "duration": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Transition duration in seconds. Default 0.7."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Left border accent colour. Default \"#4f46e5\"."
    },
    "background": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Block background. Default \"#f8fafc\"."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Content block that starts invisible and fades + slides into view when scrolled into the viewport, using an IntersectionObserver with a CSS class toggle. Requires a small inline script — degrades grace",
   "x-intent-phrases": [
    "I need content to appear smoothly as users scroll down the page.",
    "Make these sections animate in when they're visible on screen.",
    "Show these images and text when the user scrolls to them, not all at once."
   ]
  },
  "word_scramble": {
   "type": "object",
   "description": "Text that begins as a stream of random alphanumeric characters and progressively resolves left-to-right into the final string using CSS @keyframes content with steps(). Pure CSS — no JavaScript. Each frame pre-generates a partially-revealed scramble via Python at render time.",
   "properties": {
    "component": {
     "const": "word_scramble"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The final text to reveal."
    },
    "duration": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Total animation duration in seconds. Default 2.0."
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Final text colour. Default \"#0f172a\"."
    },
    "scramble_color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Scramble character colour. Default \"#4f46e5\"."
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Font size. Default \"2.5rem\"."
    },
    "weight": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Font weight. Default \"800\"."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Text that begins as a stream of random alphanumeric characters and progressively resolves left-to-right into the final string using CSS @keyframes content with steps(). Pure CSS — no JavaScript. Each",
   "x-intent-phrases": [
    "I need a loading indicator that shows text appearing character by character.",
    "Can we have a title that animates in like it's being typed out?",
    "Show a message that gradually reveals its content for a cool effect."
   ]
  },
  "svg_path_draw": {
   "type": "object",
   "description": "An SVG path that animates drawing itself from start to end using the stroke-dasharray / stroke-dashoffset CSS technique. The agent selects a named shape (arrow, check, circle, zigzag, infinity) or supplies a custom SVG path string.",
   "properties": {
    "component": {
     "const": "svg_path_draw"
    },
    "shape": {
     "description": "\"arrow\" | \"check\" | \"circle\" | \"zigzag\" | \"infinity\"  (optional, default \"arrow\")"
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Stroke colour. Default \"#4f46e5\"."
    },
    "width": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Stroke width in px. Default 3."
    },
    "duration": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Draw duration in seconds. Default 1.5."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Caption below the SVG."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "An SVG path that animates drawing itself from start to end using the stroke-dasharray / stroke-dashoffset CSS technique. The agent selects a named shape (arrow, check, circle, zigzag, infinity) or sup",
   "x-intent-phrases": [
    "I need a visual cue to show a task is complete.",
    "Can I get a smooth animation for a loading indicator?",
    "Show me a graphic that illustrates progress on a complex process."
   ]
  },
  "agent_sketchpad": {
   "type": "object",
   "description": "A single composite SVG canvas built from an ORDERED list of validated SVG elements, for an agent to progressively draw one coherent picture across multiple real updates (e.g. one A2A message per shape) rather than svg_path_draw's one-shot single shape. Every re-render draws all elements except the last as already-complete (no animation); only the LAST element in the list gets the real stroke-dasharray/stroke-dashoffset draw-in animation -- a stateless rule that works under this catalogue's full-rerender model without any incremental DOM patching. Redesigned 2026-08-24 from a path-only shape to a general SVG-primitive one (with fill), to match what a real freeform tool-calling loop actually produces (see streaming-testbench's demos/sketch/sketch_agent.py, the origin of this atom's validation approach) -- works anywhere svg_path_draw does.",
   "properties": {
    "component": {
     "const": "agent_sketchpad"
    },
    "strokes": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {element, label?} (required). ORDERED -- element is RAW SVG MARKUP for exactly ONE element (real creative freedom within a fixed safety allowlist, not a raw pass-through): one of circle, ellipse, rect, line, polyline, polygon, path, g (g may nest further allowed elements). Allowed attributes: cx, cy, r, rx, ry, x, y, width, height, x1, y1, x2, y2, points, d, fill, stroke, stroke-width, opacity, fill-opacity, stroke-opacity, stroke-linecap, stroke-linejoin, transform -- attribute values are restricted to a safe alphanumeric/punctuation character class (blocks javascript:, event handlers, anything script-shaped). The renderer parses and re-validates every element server-side before embedding it (never trusts the string as-is) -- an element that fails validation (disallowed tag/attribute, unsafe value, malformed markup, more than one top-level element) is skipped with a console warning, not a crash. label is an optional short phrase describing that one element (e.g. \"the lighthouse tower\"), not rendered, useful for an agent-facing tool-call log. Resend the FULL, growing array on every update (A2UI messages carry full values, not deltas) -- only the LAST item in the array animates; everything before it renders as already-drawn. Capped defensively at 250 elements and 4096 raw markup characters per element by the renderer (over-cap elements are skipped with a console warning, not a crash)."
    },
    "viewBox": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). SVG viewBox, e.g. \"0 0 400 200\". Default \"0 0 400 200\" -- pick a canvas shape that fits what's being drawn, unlike svg_path_draw's fixed 400x80 box."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Caption below the canvas."
    }
   },
   "required": [
    "component",
    "strokes"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "A single composite SVG canvas built from an ORDERED list of validated SVG elements, for an agent to progressively draw one coherent picture across multiple real updates (e.g. one A2A message per shape",
   "x-intent-phrases": [
    "I need to draw a timeline with events appearing one by one.",
    "Let me add shapes to a diagram as I get new data.",
    "Help me build an interactive flowchart that grows over time."
   ]
  },
  "parallax_card": {
   "type": "object",
   "description": "A card with CSS perspective and a mousemove JavaScript handler that rotates the card along both axes in response to cursor position, creating a 3D parallax tilt effect. Text layers use translateZ to create depth separation. Requires a minimal inline script.",
   "properties": {
    "component": {
     "const": "parallax_card"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Card heading."
    },
    "body": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Card body text."
    },
    "badge": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Small pill badge above the title."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Badge background colour. Default \"#4f46e5\"."
    },
    "background": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Card background. Default \"#0f172a\"."
    },
    "depth": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Maximum tilt angle in degrees. Default 15."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-side-panel",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A card with CSS perspective and a mousemove JavaScript handler that rotates the card along both axes in response to cursor position, creating a 3D parallax tilt effect. Text layers use translateZ to c",
   "x-intent-phrases": [
    "I need a way to make my product cards pop out and feel more interactive.",
    "My app's main screen needs a dynamic, eye-catching visual element.",
    "Users should feel like they can 'touch' the information on this section."
   ]
  },
  "quiz_question": {
   "type": "object",
   "description": "Multiple-choice or true/false question card with CSS checkbox trick for answer reveal. Correct option is highlighted green on selection, wrong options dim. No JavaScript required — pure CSS :checked selectors drive the feedback state. Optionally shows an explanation block after any answer is chosen.",
   "properties": {
    "component": {
     "const": "quiz_question"
    },
    "question": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The question text."
    },
    "options": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list[string]. Answer options — 2 to 6 items."
    },
    "correct": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer. Zero-based index of the correct option."
    },
    "explanation": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Shown after any option is selected."
    },
    "style": {
     "description": "\"default\" | \"dark\" | \"minimal\"  (optional, default \"default\")"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Multiple-choice or true/false question card with CSS checkbox trick for answer reveal. Correct option is highlighted green on selection, wrong options dim. No JavaScript required — pure CSS :checked s",
   "x-intent-phrases": [
    "I need a way to present simple yes/no or multiple-choice questions that show the right answer immediately after someone picks one, without any page reloads.",
    "My app needs interactive trivia cards where users select an answer, and the correct choice turns green while others fade out, all with just styling.",
    "I'm looking for a way to build a flashcard-like experience for learning where selecting an answer reveals if it's right or wrong visually, using only CSS."
   ]
  },
  "fill_in_blank": {
   "type": "object",
   "description": "Cloze-test exercise where one or more blanks in a sentence or paragraph are replaced by inline input fields. On submission a minimal inline script compares trimmed lowercase input against accepted answers and highlights each blank green (correct) or red (wrong). A retry button resets all inputs.",
   "properties": {
    "component": {
     "const": "fill_in_blank"
    },
    "template": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Sentence with {blank} placeholders marking each gap."
    },
    "answers": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list[string | list[string]]. Accepted answer(s) per blank in order. A list entry may itself be a list of acceptable alternatives."
    },
    "hint": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Shown below the exercise as a nudge."
    },
    "case_sensitive": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional, default false)."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Cloze-test exercise where one or more blanks in a sentence or paragraph are replaced by inline input fields. On submission a minimal inline script compares trimmed lowercase input against accepted ans",
   "x-intent-phrases": [
    "I need a way for users to complete sentences with their own words.",
    "How can I let learners fill in missing vocabulary in practice texts?",
    "I want to create quick quizzes where users type in the correct word."
   ]
  },
  "match_exercise": {
   "type": "object",
   "description": "Click-to-pair matching exercise. Two columns of items are shown — left (terms) and right (definitions). Learner clicks a term then a definition to form a pair. Matched pairs lock and highlight green; a mismatch briefly flashes red then resets. A score chip shows pairs matched / total. Driven by a minimal inline script.",
   "properties": {
    "component": {
     "const": "match_exercise"
    },
    "pairs": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list[{term: string, definition: string}]. 3 to 8 pairs recommended."
    },
    "shuffle": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional, default true). Randomise right-column order on render."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Click-to-pair matching exercise. Two columns of items are shown — left (terms) and right (definitions). Learner clicks a term then a definition to form a pair. Matched pairs lock and highlight green;",
   "x-intent-phrases": [
    "I need a way for users to connect related words and their explanations.",
    "My app requires an activity where learners link concepts to their meanings.",
    "Users should be able to drag and drop connections between two lists of items."
   ]
  },
  "hint_reveal": {
   "type": "object",
   "description": "A \"Show hint\" disclosure button that expands to reveal help text. Built on the HTML details/summary element — no JavaScript required. The summary label toggles between \"Show hint\" and \"Hide hint\". Styled with a subtle left-border accent and muted background to visually separate it from body content.",
   "properties": {
    "component": {
     "const": "hint_reveal"
    },
    "hint": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The hint text revealed on expand."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Button label. Default \"Show hint\"."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Left-border and icon colour. Default \"#4f46e5\"."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A \"Show hint\" disclosure button that expands to reveal help text. Built on the HTML details/summary element — no JavaScript required. The summary label toggles between \"Show hint\" and \"Hide hint\". Sty",
   "x-intent-phrases": [
    "I need a way to hide longer explanations until a user actively seeks them.",
    "Can I create a collapsible section for extra tips without complex code?",
    "Users need to see extra info on demand, but not clutter the main view."
   ]
  },
  "achievement_badge": {
   "type": "object",
   "description": "Unlockable achievement or completion badge displayed as a circular icon with a title, description, and optional unlock date. Locked state shows a greyscale padlock overlay. Suitable for course completion, streak milestones, and skill certifications. Renders as a centred card or inline pill depending on size variant.",
   "properties": {
    "component": {
     "const": "achievement_badge"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Achievement name."
    },
    "description": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Short achievement description."
    },
    "icon": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Emoji or single character used as the badge icon. Default \"🏆\"."
    },
    "locked": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional, default false). Shows greyscale padlock overlay when true."
    },
    "unlocked_at": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). ISO date string shown beneath the badge when unlocked."
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Badge accent colour. Default \"#f59e0b\"."
    },
    "size": {
     "description": "\"card\" | \"pill\"  (optional, default \"card\")"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "email",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Unlockable achievement or completion badge displayed as a circular icon with a title, description, and optional unlock date. Locked state shows a greyscale padlock overlay. Suitable for course complet",
   "x-intent-phrases": [
    "Show users when they've earned a new badge for finishing a lesson.",
    "Display a placeholder for badges they haven't unlocked yet.",
    "Let users see the name and purpose of each accomplishment."
   ]
  },
  "score_summary": {
   "type": "object",
   "description": "End-of-exercise or end-of-module score card showing correct answers, total questions, percentage, and optional time taken. Animates the score fraction on render using a CSS counter. Includes a contextual pass/fail or grade label and an optional retry/continue CTA row.",
   "properties": {
    "component": {
     "const": "score_summary"
    },
    "correct": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer. Number of correct answers."
    },
    "total": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer. Total number of questions."
    },
    "time_taken": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Human-readable time string e.g. \"2m 14s\"."
    },
    "pass_threshold": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Percentage (0–100) required to pass. Drives pass/fail label colour."
    },
    "retry_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Label for the retry button. Omit to hide retry CTA."
    },
    "continue_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Label for the continue button. Omit to hide continue CTA."
    },
    "continue_url": {
     "description": "url (optional). Destination for the continue button.",
     "type": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "End-of-exercise or end-of-module score card showing correct answers, total questions, percentage, and optional time taken. Animates the score fraction on render using a CSS counter. Includes a context",
   "x-intent-phrases": [
    "Show me how well I did on that last lesson, including how many I got right.",
    "I need to see my score after finishing the quiz, with the total questions and my accuracy.",
    "Display my performance from the practice session, highlighting correct answers and the time it took."
   ]
  },
  "xp_bar": {
   "type": "object",
   "description": "Experience points or gamification progress bar showing current XP, level label, and XP needed to reach the next level. The fill animates from the previous value to the current value on render via CSS transition. A level-up flash overlay triggers when xp_current equals or exceeds xp_next.",
   "properties": {
    "component": {
     "const": "xp_bar"
    },
    "level_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Current level name e.g. \"Level 3 — Intermediate\"."
    },
    "xp_current": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer. Current XP within the current level."
    },
    "xp_next": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer. XP required to reach the next level."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Bar fill colour. Default \"#4f46e5\"."
    },
    "show_flash": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional, default true). Trigger level-up flash when xp_current >= xp_next."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Experience points or gamification progress bar showing current XP, level label, and XP needed to reach the next level. The fill animates from the previous value to the current value on render via CSS",
   "x-intent-phrases": [
    "I want to see how much progress I've made towards the next achievement.",
    "Show me my current standing and how close I am to leveling up.",
    "I need a visual indicator of my growth and what's next."
   ]
  },
  "lesson_nav": {
   "type": "object",
   "description": "Previous/next lesson navigation bar with the current lesson title centred and module context shown above. Each side shows the adjacent lesson title and a directional arrow. Optionally shows a completion checkbox for the current lesson that persists via localStorage.",
   "properties": {
    "component": {
     "const": "lesson_nav"
    },
    "module_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Module or section name shown above the nav bar."
    },
    "current_title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Title of the current lesson."
    },
    "prev_title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Title of the previous lesson. Omit to hide prev arrow."
    },
    "prev_url": {
     "description": "url (optional). Link for the previous lesson.",
     "type": "string"
    },
    "next_title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Title of the next lesson. Omit to hide next arrow."
    },
    "next_url": {
     "description": "url (optional). Link for the next lesson.",
     "type": "string"
    },
    "show_completion": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional, default false). Show a \"Mark as complete\" checkbox persisted in localStorage."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Previous/next lesson navigation bar with the current lesson title centred and module context shown above. Each side shows the adjacent lesson title and a directional arrow. Optionally shows a completi",
   "x-intent-phrases": [
    "I need a way for my users to easily jump between articles in a series without getting lost.",
    "My learners need a clear path through our courses, showing them where they are and what's next.",
    "Users exploring documentation should be able to navigate chapters sequentially with context about the overall book."
   ]
  },
  "course_progress_card": {
   "type": "object",
   "description": "Overall course completion card showing a list of modules with individual progress bars and a top-level aggregate progress ring. Each module row shows its title, lesson count, and percentage complete. Suitable for a course sidebar or dashboard widget.",
   "properties": {
    "component": {
     "const": "course_progress_card"
    },
    "course_title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Course name shown at the top of the card."
    },
    "modules": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list[{title: string, lessons_total: integer, lessons_done: integer}]."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Progress fill colour. Default \"#4f46e5\"."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Overall course completion card showing a list of modules with individual progress bars and a top-level aggregate progress ring. Each module row shows its title, lesson count, and percentage complete.",
   "x-intent-phrases": [
    "Show me how far I've gotten in the whole class and each section.",
    "I need a clear view of my learning journey, module by module.",
    "Display my progress on all the learning units at a glance."
   ]
  },
  "highlighted_text": {
   "type": "object",
   "description": "Inline passage of text with a coloured highlight background and an optional margin annotation note. The annotation appears as a side-note pill on hover (CSS :hover) or as a visible aside on smaller viewports. Useful for reading comprehension exercises, exam technique callouts, and annotated source analysis.",
   "properties": {
    "component": {
     "const": "highlighted_text"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The passage to highlight."
    },
    "annotation": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Margin note revealed on hover."
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Highlight background colour. Default \"#fef08a\" (yellow)."
    },
    "annotation_color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Annotation pill background. Default \"#fbbf24\"."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "pdf",
    "google-apps-script-web",
    "mcp-apps",
    "android",
    "slides",
    "pptx"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Inline passage of text with a coloured highlight background and an optional margin annotation note. The annotation appears as a side-note pill on hover (CSS :hover) or as a visible aside on smaller vi",
   "x-intent-phrases": [
    "I need to draw attention to important phrases in my user guides.",
    "Can I add tiny pop-up notes next to key terms for extra context?",
    "We need a way to visually flag specific parts of an article without disrupting the flow."
   ]
  },
  "drive_file_list": {
   "type": "object",
   "description": "Live list of files in a Google Drive folder rendered with icons and download links. Works on Google Apps Script only.",
   "properties": {
    "component": {
     "const": "drive_file_list"
    },
    "folder_id": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The Google Drive folder ID to list files from."
    },
    "max_results": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Maximum number of files to return. Default is 10."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Live list of files in a Google Drive folder rendered with icons and download links. Works on Google Apps Script only.",
   "x-intent-phrases": [
    "I need to show users all the documents in a shared project folder so they can grab them.",
    "Show clients a live view of all the invoices uploaded to their specific folder for easy access.",
    "I want to display a list of student submissions with download buttons from a designated folder."
   ]
  },
  "sheet_preview": {
   "type": "object",
   "description": "Live read-only preview of a specified range in a Google Sheet. Renders as an HTML table. Works on Google Apps Script only.",
   "properties": {
    "component": {
     "const": "sheet_preview"
    },
    "spreadsheet_id": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The Google Sheets ID."
    },
    "sheet_name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The name of the sheet tab."
    },
    "range": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The A1 notation range (e.g. A1:D10)."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Live read-only preview of a specified range in a Google Sheet. Renders as an HTML table. Works on Google Apps Script only.",
   "x-intent-phrases": [
    "I need to show users a snapshot of their data from a spreadsheet without letting them edit it.",
    "My app needs to display a specific section of a Google Sheet right in the interface.",
    "We have a reporting feature that needs to pull and present a small table from a user's Google Sheet."
   ]
  },
  "gmail_summary": {
   "type": "object",
   "description": "Summary list of recent emails in the user's Gmail matching a search query. Works on Google Apps Script only.",
   "properties": {
    "component": {
     "const": "gmail_summary"
    },
    "query": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The search query (e.g. \"is:unread label:work\")."
    },
    "max_results": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Maximum number of emails to display. Default is 5."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Summary list of recent emails in the user's Gmail matching a search query. Works on Google Apps Script only.",
   "x-intent-phrases": [
    "I need a way to see the latest emails about my projects without opening Gmail.",
    "Show me a quick overview of all customer support tickets that came in today.",
    "I want a list of all invoices from the last week, right on my dashboard."
   ]
  },
  "calendar_upcoming": {
   "type": "object",
   "description": "List of upcoming events from the user's primary calendar. Works on Google Apps Script only.",
   "properties": {
    "component": {
     "const": "calendar_upcoming"
    },
    "max_results": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Maximum number of upcoming events to show. Default is 5."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "List of upcoming events from the user's primary calendar. Works on Google Apps Script only.",
   "x-intent-phrases": [
    "Show me what's next on my schedule today.",
    "I need to see my appointments for the next week.",
    "Display my upcoming meetings right away."
   ]
  },
  "user_greeting": {
   "type": "object",
   "description": "Personalised greeting showing the active user's Google account email. Works on Google Apps Script only.",
   "properties": {
    "component": {
     "const": "user_greeting"
    },
    "prefix": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). The greeting prefix. Default is \"Hello\"."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Personalised greeting showing the active user's Google account email. Works on Google Apps Script only.",
   "x-intent-phrases": [
    "I need to display the logged-in person's email address on my dashboard.",
    "Show the current user's Google login email at the top of the page.",
    "We need to put the active user's Gmail address in the header."
   ]
  },
  "script_run_button": {
   "type": "object",
   "description": "Interactive button that executes a custom Google Apps Script server function when clicked, showing a loading spinner and returning/displaying the function result. Works on Google Apps Script only.",
   "properties": {
    "component": {
     "const": "script_run_button"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The button text."
    },
    "function_name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The name of the server-side V8 JavaScript function to call."
    },
    "argument": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Optional string argument to pass to the function."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Interactive button that executes a custom Google Apps Script server function when clicked, showing a loading spinner and returning/displaying the function result. Works on Google Apps Script only.",
   "x-intent-phrases": [
    "I need a button that runs a script to update my spreadsheet data when pressed.",
    "I want to click a button and have it send an email using my script.",
    "Can I have a way to trigger a backend process with a click, showing progress?"
   ]
  },
  "calendar_today": {
   "type": "object",
   "description": "Today's events from the user's default Google Calendar, displayed as a compact timeline with time and location. Automatically shows today's date in the header.",
   "properties": {
    "component": {
     "const": "calendar_today"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Card heading. Default is \"Today's Schedule\"."
    },
    "max_results": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Maximum events to show. Default 8."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Today's events from the user's default Google Calendar, displayed as a compact timeline with time and location. Automatically shows today's date in the header.",
   "x-intent-phrases": [
    "Show me what I'm doing today, right now.",
    "I need to see my schedule for the current day at a glance.",
    "Display my appointments for today, including times and places."
   ]
  },
  "sheet_stats": {
   "type": "object",
   "description": "Aggregate statistics (sum, average, count, min, max) computed from a Google Sheet range and displayed as a row of stat badges. Ideal for dashboards.",
   "properties": {
    "component": {
     "const": "sheet_stats"
    },
    "spreadsheet_id": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The Google Sheets ID."
    },
    "sheet_name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Sheet tab name."
    },
    "range": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. A1 notation range (e.g. B2:B50)."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Card heading. Default is \"Sheet Stats\"."
    },
    "show": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional). Which stats to show — any of sum, average, count, min, max. Default [\"sum\",\"average\",\"count\"]."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Accent colour for stat values."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Aggregate statistics (sum, average, count, min, max) computed from a Google Sheet range and displayed as a row of stat badges. Ideal for dashboards.",
   "x-intent-phrases": [
    "I need to see the total sales for the month at a glance.",
    "Show me the average customer rating for all our products quickly.",
    "Display the highest and lowest stock prices from the spreadsheet."
   ]
  },
  "gmail_unread_count": {
   "type": "object",
   "description": "Unread message count badges for one or more Gmail labels, shown as a pill row. Zero counts are displayed in grey; non-zero in the accent colour.",
   "properties": {
    "component": {
     "const": "gmail_unread_count"
    },
    "labels": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional). Gmail label names to count. Default [\"INBOX\"]."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Card heading. Default is \"Gmail\"."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Badge colour for non-zero counts. Default red."
    },
    "counts": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (static connector). Label→count map for non-GAS surfaces."
    },
    "auth_token": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (api connector). OAuth2 bearer token for REST API."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Unread message count badges for one or more Gmail labels, shown as a pill row. Zero counts are displayed in grey; non-zero in the accent colour.",
   "x-intent-phrases": [
    "I need to see how many new emails I have for my 'Urgent' folder at a glance.",
    "Can I get a quick way to know which project folders have new activity?",
    "I want a visual indicator for my 'Important' inbox messages so I don't miss them."
   ]
  },
  "user_profile_card": {
   "type": "object",
   "description": "Personalised profile card showing the active user's avatar initial, display name (derived from email), email address, and Workspace domain. On GAS uses Session.getActiveUser(); on other surfaces renders from name/email fields.",
   "properties": {
    "component": {
     "const": "user_profile_card"
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (static connector). Display name for non-GAS surfaces."
    },
    "email": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (static connector). Email address for non-GAS surfaces."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Avatar background colour."
    },
    "subtitle": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Role or team label shown below the email."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Personalised profile card showing the active user's avatar initial, display name (derived from email), email address, and Workspace domain. On GAS uses Session.getActiveUser(); on other surfaces rende",
   "x-intent-phrases": [
    "I need to show who's currently logged in with their name and picture.",
    "Can I display the user's email and company affiliation easily?",
    "I want a quick way to see basic user info on the dashboard."
   ]
  },
  "drive_storage_usage": {
   "type": "object",
   "description": "Google Drive storage quota displayed as a labelled progress bar — used GB, total GB, and percentage. Bar colour shifts to amber above 70% and red above 90%. On GAS uses DriveApp; elsewhere pass used_gb and total_gb fields.",
   "properties": {
    "component": {
     "const": "drive_storage_usage"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Card heading. Default is \"Drive Storage\"."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Bar colour below 70% usage."
    },
    "used_gb": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (static connector). GB used — for non-GAS surfaces."
    },
    "total_gb": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (static connector). Total quota GB — for non-GAS surfaces."
    },
    "auth_token": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (api connector). OAuth2 bearer token for REST API."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Google Drive storage quota displayed as a labelled progress bar — used GB, total GB, and percentage. Bar colour shifts to amber above 70% and red above 90%. On GAS uses DriveApp; elsewhere pass used_g",
   "x-intent-phrases": [
    "I need to see how much space I have left in my Google Drive.",
    "Show me how close I am to hitting my storage limit for all my files.",
    "I want a visual indicator of my data usage so I don't run out of room."
   ]
  },
  "sheet_form_submit": {
   "type": "object",
   "description": "Inline form that appends a timestamped row to a Google Sheet on submit. Calls google.script.run.a2uiSheetAppend server-side. Each field renders as a labelled input or textarea.",
   "properties": {
    "component": {
     "const": "sheet_form_submit"
    },
    "spreadsheet_id": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Target Google Sheets ID."
    },
    "sheet_name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Sheet tab name. Default is \"Sheet1\"."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Form heading."
    },
    "fields": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. Array of {label, name, type, placeholder} objects. type is text, email, number, or textarea."
    },
    "submit_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Submit button text. Default is \"Submit\"."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Submit button colour."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Inline form that appends a timestamped row to a Google Sheet on submit. Calls google.script.run.a2uiSheetAppend server-side. Each field renders as a labelled input or textarea.",
   "x-intent-phrases": [
    "I need a quick way to log customer feedback as it comes in, with a date for each entry.",
    "We need a simple form to capture daily progress updates, automatically noting when each update was entered.",
    "I want to gather event attendee details, each submission timestamped for tracking attendance timing."
   ]
  },
  "tasks_today": {
   "type": "object",
   "description": "Incomplete tasks displayed as an interactive checkbox list. On GAS uses the Tasks API for live data; on other surfaces renders from an items[] array or the Google Tasks REST API.",
   "properties": {
    "component": {
     "const": "tasks_today"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Card heading. Default is \"Today's Tasks\"."
    },
    "max_results": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Maximum tasks to show. Default 10."
    },
    "list_name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, gas-native). Name of the task list."
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (static connector). Array of {title, due, completed} for non-GAS surfaces."
    },
    "auth_token": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (api connector). OAuth2 bearer token for REST API."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Incomplete tasks displayed as an interactive checkbox list. On GAS uses the Tasks API for live data; on other surfaces renders from an items[] array or the Google Tasks REST API.",
   "x-intent-phrases": [
    "I need to see and manage my daily to-dos in one place.",
    "Show me what I need to get done today, and let me mark things off.",
    "I want a quick way to track my immediate responsibilities and cross them off."
   ]
  },
  "cursor_glow": {
   "type": "object",
   "description": "Ambient radial gradient orb that smoothly lerp-follows the cursor across the page using requestAnimationFrame. Uses CSS mix-blend-mode:screen for a light-leak feel. Page-scoped and double-init guarded.",
   "properties": {
    "component": {
     "const": "cursor_glow"
    },
    "colour": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Orb colour. Default"
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Orb diameter in px. Default 380."
    },
    "opacity": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Orb opacity 0–1. Default 0.18."
    },
    "speed": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Lerp factor 0–1 — lower = more lag. Default 0.1."
    },
    "blend": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). CSS mix-blend-mode. Default screen."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "Ambient radial gradient orb that smoothly lerp-follows the cursor across the page using requestAnimationFrame. Uses CSS mix-blend-mode:screen for a light-leak feel. Page-scoped and double-init guarded",
   "x-intent-phrases": [
    "I want a subtle, magical light that follows my mouse everywhere.",
    "Can I get a soft, glowing effect that highlights where I'm pointing?",
    "I need a visual indicator that feels alive and reacts to my movements."
   ]
  },
  "cursor_trail": {
   "type": "object",
   "description": "A chain of fading dots that follow the cursor using worm-chain physics — each dot lerps toward the one ahead of it, creating a fluid trailing effect.",
   "properties": {
    "component": {
     "const": "cursor_trail"
    },
    "colour": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Dot colour. Default"
    },
    "length": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Number of chain dots. Default 16."
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Lead dot diameter px. Default 10."
    },
    "speed": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Lerp factor per dot. Default 0.35."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "A chain of fading dots that follow the cursor using worm-chain physics — each dot lerps toward the one ahead of it, creating a fluid trailing effect.",
   "x-intent-phrases": [
    "I need a subtle visual flair that makes interactions feel more alive.",
    "How can I add a beautiful, dynamic effect that highlights user movement?",
    "Can I get a smooth animation that shows where the user's pointer has been?"
   ]
  },
  "particle_burst": {
   "type": "object",
   "description": "On every click anywhere on the page, coloured particles burst outward from the click point with random velocities and simulated gravity, then fade out.",
   "properties": {
    "component": {
     "const": "particle_burst"
    },
    "count": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Particles per click. Default 14."
    },
    "colours": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional). Array of hex colour strings."
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Particle diameter px. Default 8."
    },
    "duration": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Animation duration ms. Default 700."
    },
    "gravity": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Downward pull factor. Default 1.2."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "On every click anywhere on the page, coloured particles burst outward from the click point with random velocities and simulated gravity, then fade out.",
   "x-intent-phrases": [
    "I need some visual flair when users interact with my app's buttons.",
    "Can we add a little something extra to make the experience more engaging?",
    "I want a subtle animation to show when a user taps anywhere on the screen."
   ]
  },
  "spotlight_cursor": {
   "type": "object",
   "description": "A dark overlay with a soft-edged circular cutout that follows the cursor — torch or spotlight effect. Best used as a standalone page effect or dramatic opening slide.",
   "properties": {
    "component": {
     "const": "spotlight_cursor"
    },
    "radius": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Spotlight radius px. Default 180."
    },
    "darkness": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Overlay opacity 0–1. Default 0.82."
    },
    "colour": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Overlay colour. Default"
    },
    "soft_edge": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Feather distance px beyond radius. Default 60."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "A dark overlay with a soft-edged circular cutout that follows the cursor — torch or spotlight effect. Best used as a standalone page effect or dramatic opening slide.",
   "x-intent-phrases": [
    "I want the user's focus drawn to interactive elements as they move their mouse.",
    "Can we make the current section of the page feel highlighted and important?",
    "How do I create a dramatic, theatrical reveal for our main landing page content?"
   ]
  },
  "magnetic_element": {
   "type": "object",
   "description": "Wraps content that drifts toward the cursor when it enters the activation radius, then springs back with a cubic-bezier overshoot when the cursor leaves.",
   "properties": {
    "component": {
     "const": "magnetic_element"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Text label for the default pill style."
    },
    "content": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Raw HTML to use instead of the default pill."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Pill background colour. Default"
    },
    "radius": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Activation distance px. Default 120."
    },
    "strength": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Pull factor 0–1. Default 0.4."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "Wraps content that drifts toward the cursor when it enters the activation radius, then springs back with a cubic-bezier overshoot when the cursor leaves.",
   "x-intent-phrases": [
    "I want buttons to subtly move towards the user's mouse for a more engaging feel.",
    "Can we make the interactive elements gently pull in when hovered over?",
    "I need clickable areas to have a playful, responsive effect when the mouse is near."
   ]
  },
  "tilt_card": {
   "type": "object",
   "description": "A card that tilts in 3D perspective as the cursor moves across it, with a radial glare highlight that tracks cursor position. Uses CSS preserve-3d and dynamic box-shadow.",
   "properties": {
    "component": {
     "const": "tilt_card"
    },
    "content": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Inner HTML rendered inside the card."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Card heading rendered above content."
    },
    "max_tilt": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Maximum rotation degrees. Default 14."
    },
    "glare": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional). Show glare highlight. Default true."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Glare colour. Default rgba(255,255,255,0.15)."
    },
    "padding": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Inner padding. Default 28px."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A card that tilts in 3D perspective as the cursor moves across it, with a radial glare highlight that tracks cursor position. Uses CSS preserve-3d and dynamic box-shadow.",
   "x-intent-phrases": [
    "I need interactive cards that pop out when you hover over them.",
    "Can we have product previews that feel more dynamic and engaging?",
    "Looking for a way to make featured items on my dashboard more eye-catching."
   ]
  },
  "doc_ai_summary": {
   "type": "object",
   "description": "Opens a Google Doc by ID, sends its text to Vertex AI Gemini, and renders the response as a structured summary card with word count and a link to the original doc. Requires VERTEX_PROJECT_ID in Script Properties.",
   "properties": {
    "component": {
     "const": "doc_ai_summary"
    },
    "doc_id": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Google Doc ID to summarise."
    },
    "prompt": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Instruction sent to Gemini before the doc text."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Override card title. Defaults to the doc name."
    },
    "model": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Gemini model override. Defaults to VERTEX_MODEL property."
    },
    "max_chars": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Max doc characters sent to Gemini. Default 12000."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Accent colour."
    },
    "show_meta": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional). Show word count and doc link. Default true."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Opens a Google Doc by ID, sends its text to Vertex AI Gemini, and renders the response as a structured summary card with word count and a link to the original doc. Requires VERTEX_PROJECT_ID in Script",
   "x-intent-phrases": [
    "I need to quickly get the main points from long research papers stored in Google Docs.",
    "Can I see the key takeaways from our team's meeting notes without reading the whole document?",
    "Help me summarize customer feedback documents to identify common themes."
   ]
  },
  "multi_doc_ai_brief": {
   "type": "object",
   "description": "Takes an array of Google Doc IDs and renders one Vertex AI Gemini summary card per doc — a compact briefing pack for meetings. Each doc can have its own prompt override.",
   "properties": {
    "component": {
     "const": "multi_doc_ai_brief"
    },
    "docs": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array. Array of {doc_id, title?, prompt?} objects."
    },
    "default_prompt": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Fallback prompt for docs without their own."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Accent colour for doc links."
    },
    "model": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Gemini model override."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Takes an array of Google Doc IDs and renders one Vertex AI Gemini summary card per doc — a compact briefing pack for meetings. Each doc can have its own prompt override.",
   "x-intent-phrases": [
    "I need to see key takeaways from several research papers quickly before our team discussion.",
    "Show me the important points from these legal filings so I can prepare for court.",
    "Summarize these project status updates for my daily executive review."
   ]
  },
  "gradient_heading": {
   "type": "object",
   "description": "Gradient-fill standalone heading using CSS background-clip text. Simpler than dark_hero — just the text, no padding or CTA. Use inside content flow between other atoms.",
   "properties": {
    "component": {
     "const": "gradient_heading"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Heading text."
    },
    "gradient": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). CSS gradient value. Default indigo→violet→pink."
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Font-size. Default clamp(1.8rem,4vw,3rem)."
    },
    "weight": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Font-weight. Default 900."
    },
    "align": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). text-align. Default left."
    },
    "margin": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). CSS margin. Default 16px 0 6px."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Gradient-fill standalone heading using CSS background-clip text. Simpler than dark_hero — just the text, no padding or CTA. Use inside content flow between other atoms.",
   "x-intent-phrases": [
    "I need a title that pops, like a colorful ribbon, right in the middle of my article.",
    "My section headers should look premium and modern, with a smooth color transition.",
    "Can I get a prominent heading that uses a rainbow effect to grab attention on this page?"
   ]
  },
  "display_quote": {
   "type": "object",
   "description": "Large typographic quote with a decorative quotation mark at 5rem, quote body in italic, and optional attribution line. Dark-native, great for Meet Stage title slides.",
   "properties": {
    "component": {
     "const": "display_quote"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Quote body text."
    },
    "attribution": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Name or source shown below quote."
    },
    "colour": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Accent colour for mark and attribution. Default"
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Font-size for quote text. Default clamp(1.4rem,3vw,2.2rem)."
    },
    "align": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). center or left. Default center."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Large typographic quote with a decorative quotation mark at 5rem, quote body in italic, and optional attribution line. Dark-native, great for Meet Stage title slides.",
   "x-intent-phrases": [
    "I need a big, striking way to show my presentation's main message.",
    "How can I make the speaker's name and their famous saying stand out?",
    "I want a stylish header for each slide that introduces the topic."
   ]
  },
  "split_stat": {
   "type": "object",
   "description": "Two-column layout — a large glowing stat number on the left (with neon text-shadow) and heading + body text on the right. Classic keynote layout, great for Meet Stage.",
   "properties": {
    "component": {
     "const": "split_stat"
    },
    "value": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. The stat number or short value."
    },
    "prefix": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Text before value (e.g. \"$\", \"~\")."
    },
    "suffix": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Text after value (e.g. \"%\", \"k\", \"+\")."
    },
    "heading": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Right-side heading."
    },
    "body": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Right-side paragraph text."
    },
    "colour": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Stat glow colour. Default"
    },
    "flip": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional). Put stat on right side. Default false."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Two-column layout — a large glowing stat number on the left (with neon text-shadow) and heading + body text on the right. Classic keynote layout, great for Meet Stage.",
   "x-intent-phrases": [
    "I need a big, flashy number for our key metric, with supporting details next to it.",
    "Showcase our most important number prominently, with explanatory text to its side.",
    "Let's highlight a critical data point in a bold way, with context on the right."
   ]
  },
  "word_reveal": {
   "type": "object",
   "description": "Words appear one by one with a fade-up animation that auto-plays on page load — no user interaction required. Great for Meet Stage title slides and reveal moments.",
   "properties": {
    "component": {
     "const": "word_reveal"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Text to reveal word by word."
    },
    "colour": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Text colour. Default rgba(255,255,255,0.92)."
    },
    "gradient": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). CSS gradient applied to whole line (overrides colour)."
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Font-size. Default clamp(2rem,5vw,3.5rem)."
    },
    "weight": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Font-weight. Default 800."
    },
    "delay": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Seconds between each word. Default 0.12."
    },
    "align": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). text-align. Default center."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Words appear one by one with a fade-up animation that auto-plays on page load — no user interaction required. Great for Meet Stage title slides and reveal moments.",
   "x-intent-phrases": [
    "I need titles to show up word by word as the page loads.",
    "Can text appear slowly, one word at a time, when someone visits?",
    "We want a dramatic entrance for key phrases on our opening screen."
   ]
  },
  "section_label": {
   "type": "object",
   "description": "Uppercase section marker with a short glowing accent line — use between content sections on dark pages to create visual rhythm.",
   "properties": {
    "component": {
     "const": "section_label"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Label text (uppercased automatically)."
    },
    "colour": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Accent colour. Default"
    },
    "margin": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Vertical margin. Default 24px 0 12px."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Uppercase section marker with a short glowing accent line — use between content sections on dark pages to create visual rhythm.",
   "x-intent-phrases": [
    "I need a way to visually break up long articles on my dark-themed website.",
    "How can I add a subtle, glowing separator between different parts of my app's interface?",
    "I want to make it clearer where one topic ends and another begins in my dark mode content."
   ]
  },
  "count_up_stat": {
   "type": "object",
   "description": "A stat number that counts up from zero to the target value using a cubic ease function on page load. Auto-plays — no user interaction required.",
   "properties": {
    "component": {
     "const": "count_up_stat"
    },
    "value": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer. Target number to count to."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Descriptor shown below the number."
    },
    "prefix": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Text before the number (e.g. \"$\")."
    },
    "suffix": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Text after the number (e.g. \"%\", \"k\")."
    },
    "colour": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Glow colour. Default"
    },
    "duration": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Count-up duration ms. Default 1800."
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Font-size. Default 4rem."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A stat number that counts up from zero to the target value using a cubic ease function on page load. Auto-plays — no user interaction required.",
   "x-intent-phrases": [
    "Show how many people have signed up this week.",
    "Display the current number of active users.",
    "Animate the total sales figures for the quarter."
   ]
  },
  "text_highlight": {
   "type": "object",
   "description": "Inline prose sentence where specific words are highlighted in an accent colour. Mark words with **double asterisks** in the text field — highlighted words are wrapped in a styled span.",
   "properties": {
    "component": {
     "const": "text_highlight"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Body text with **highlighted** words wrapped in double asterisks."
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Font-size. Default 1.2rem."
    },
    "colour": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Highlight colour. Default"
    },
    "weight": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Base font weight. Default 600."
    },
    "align": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). text-align. Default left."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Inline prose sentence where specific words are highlighted in an accent colour. Mark words with **double asterisks** in the text field — highlighted words are wrapped in a styled span.",
   "x-intent-phrases": [
    "I need to make important terms in my user guide stand out.",
    "Help me draw attention to keywords in my product descriptions.",
    "I want to emphasize specific actions or data points in my reports."
   ]
  },
  "reveal_line": {
   "type": "object",
   "description": "A single line of text that sweeps in from left using a clip-path animation — dramatic and instant. Auto-plays on load, no click required. Great for Meet Stage opening slides.",
   "properties": {
    "component": {
     "const": "reveal_line"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Text content."
    },
    "gradient": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). CSS gradient applied to text. Default indigo→pink."
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Font-size. Default clamp(2.5rem,6vw,4rem)."
    },
    "weight": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Font-weight. Default 900."
    },
    "duration": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Animation duration ms. Default 800."
    },
    "delay": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Start delay ms. Default 200."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A single line of text that sweeps in from left using a clip-path animation — dramatic and instant. Auto-plays on load, no click required. Great for Meet Stage opening slides.",
   "x-intent-phrases": [
    "I need a way to make my page titles pop when the user lands on the page.",
    "How can I draw attention to important introductory text without making the user click anything?",
    "I want the first thing a visitor sees to have a strong visual impact, like text sliding in."
   ]
  },
  "canvas_plexus": {
   "type": "object",
   "description": "Full-viewport animated particle network — dots connected by proximity lines that fade with distance. Mouse/pointer repulses particles. Zero external dependencies, pure requestAnimationFrame loop.",
   "properties": {
    "component": {
     "const": "canvas_plexus"
    },
    "count": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Number of particles. Default 65."
    },
    "colour": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Hex colour for particles and lines. Default"
    },
    "speed": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Particle speed multiplier. Default 1.0."
    },
    "max_dist": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Max distance px for edge connections. Default 120."
    },
    "bg": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Background colour. Default"
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Canvas height px. Default 400."
    },
    "repulse_radius": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Mouse repulsion radius px. Default 90."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_verified", "lit": "drawn", "angular": "drawn", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "Full-viewport animated particle network — dots connected by proximity lines that fade with distance. Mouse/pointer repulses particles. Zero external dependencies, pure requestAnimationFrame loop.",
   "x-intent-phrases": [
    "I need a visually engaging background for my landing page that reacts to user interaction.",
    "Can I get a dynamic, attention-grabbing loading animation that feels alive?",
    "I want a subtle, ambient effect for my dashboard that changes when the mouse hovers over it."
   ]
  },
  "brick_build_3d": {
   "type": "object",
   "description": "Equation-driven toy-brick 3D model that assembles itself stud by stud, drawn in real brick proportions (8 mm pitch, 9.6 mm brick) with dependency-free WebGL — key-light shadows cast between parts, glossy plastic shading and an outline on every part edge, like an instruction-booklet render — and a canvas-2D fallback where WebGL is unavailable. Two kinds of model. Toy bricks (bricks or shape) are procedural boxes with studs, from a named shape (heart, sphere, torus, helix, pyramid, house) or an explicit bricks array. Real parts (partsModel) are baked geometry from the LDraw.org Parts Library, under CC BY. Every design is checked by deterministic geometry — collisions, every brick anchored through stud connections (real parts also through pins, hinges, axles and clips), connection count, centre of mass over the footprint — and the verdicts show beside the model. An instructions mode steps through the build layer by layer, and a parts list groups bricks by size and colour with an indicative cost. Known limit, each brick canvas holds two WebGL contexts and a page allows about 16, so keep to about 7 brick canvases per page. Not affiliated with or endorsed by the LEGO Group. LEGO is a trademark of the LEGO Group.",
   "properties": {
    "component": {
     "const": "brick_build_3d"
    },
    "shape": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). One of \"heart\", \"sphere\", \"torus\", \"helix\", \"pyramid\", \"house\". Default \"heart\". Ignored when bricks is set."
    },
    "bricks": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional). Explicit model — objects {x, y, z, w, d, h, c}. x and z are stud positions, y is the layer (0 sits on the baseplate), w and d the footprint in studs, h the height in bricks (default 1), c a '#rrggbb' colour or a palette index. A brick may also be a compact array [x, y, z, w, d, c] or [x, y, z, w, d, h, c], about a third of the size. Up to 3000 bricks. A data-model binding such as {path '/bricks'} arrives resolved."
    },
    "palette": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of \"#rrggbb\" (optional). Up to 256 colours. A brick's c may be an integer index into it, which keeps large models small."
    },
    "mode": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). One of \"animate\", \"steps\". Default \"animate\"."
    },
    "step": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Initial instruction step when mode is steps. Default 1."
    },
    "speed": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Animation speed multiplier. Default 1."
    },
    "orbit": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional). Slow auto-orbit; dragging always orbits. Default true."
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Canvas height px, 160 to 900. Default 380."
    },
    "bg": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Canvas background colour. Transparent on the studio gradient by default."
    },
    "scrubber": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional). Show the animate/instructions toggle and step slider. Default true."
    },
    "checks": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional). Show the build-check verdicts. Default true."
    },
    "parts": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional). Show the parts list with an indicative cost. Default false."
    },
    "models": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional). Named models for the picker dropdown — up to 8 objects {name, bricks, palette}, each bricks array as above (up to 3000 bricks each; palette optional, else the top-level one). Entries with no usable bricks are skipped; a missing name becomes Model N. The dropdown lists the six built-in shapes followed by these."
    },
    "model": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Name of the entry in models to show first. Ignored when bricks is set."
    },
    "picker": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional). Show the model dropdown. Default true when models is given, otherwise false; set true to get a dropdown of the six built-in shapes alone."
    },
    "partsModel": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional). Real parts from the LDraw.org Parts Library (CC BY) instead of procedural boxes, as [partId, x, y, z, rotation, colour] tuples (a real LDraw part id, x y z in LDraw units (20 per stud, 24 per brick height), a 0-23 rotation index, an LDraw colour code), or objects {p, x, y, z, r, c}. Takes precedence over bricks/shape when present, same \"explicit wins\" rule as bricks vs. shape. Up to 3000 parts."
    },
    "look": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). One of \"studio\", \"instructions\". Default \"instructions\". instructions: the original building-instructions style (glossy plastic, dark outline on every part edge). studio: a product-shot style — no outlines, edges catch light instead (same visual treatment as the sibling motion_bricks atom, default there)."
    },
    "base": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). \"none\" for floating bricks (no plate, no plate shadow), or a \"#rrggbb\" colour for the baseplate. Default the classic green plate."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "not_supported", "compose": "not_supported"}
  },
  "spring_nodes": {
   "type": "object",
   "description": "Mass-spring graph: nodes repel each other (Coulomb) and are held by Hooke springs on defined edges. By default a settled, static layout computed server-side, so it works everywhere, including print and assistive tech. Drag-to-pin with live springs is opt-in with interactive: true.",
   "properties": {
    "component": {
     "const": "spring_nodes"
    },
    "nodes": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional). Array of {id, label} objects. Defaults to 6 labelled nodes."
    },
    "edges": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional). Array of {a, b} index pairs for spring connections."
    },
    "colour": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Node and edge accent colour. Default"
    },
    "bg": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Background colour. Default"
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Canvas height px. Default 420."
    },
    "rest_length": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Spring rest length px. Default 110."
    },
    "interactive": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional). Default false: a settled, static layout that works everywhere and for assistive tech. Set true when the atom is shown in a live browser or app view and the viewer should be able to play with the graph: drag nodes to pin them, watch the springs react. Ignored under reduced motion and on static surfaces (print, slides, email, chat, and any surface that strips scripts)."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "Mass-spring graph: nodes repel each other (Coulomb) and are held by Hooke springs on defined edges. By default a settled, static layout computed server-side, so it works everywhere, including print an",
   "x-intent-phrases": [
    "I need to visualize a network where items push apart but are connected by elastic bands.",
    "Can I see how my data points would arrange themselves if they naturally pushed away but had fixed links?",
    "I want an interactive way to show relationships where entities have repulsion and attraction."
   ]
  },
  "isometric_mesh": {
   "type": "object",
   "description": "Rotating 3D isometric height-field mesh. Default surface is a 16×16 Gaussian hill pre-computed server-side. Drag to rotate manually; auto-rotates until first touch. Height colour interpolates from deep indigo (low) to bright violet (high).",
   "properties": {
    "component": {
     "const": "isometric_mesh"
    },
    "grid": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Grid dimension N (N×N). Default 16."
    },
    "height_scale": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Vertical exaggeration multiplier. Default 1.0."
    },
    "colour_low": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Hex colour at minimum height. Default"
    },
    "colour_high": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Hex colour at maximum height. Default"
    },
    "bg": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Background colour. Default"
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Canvas height px. Default 460."
    },
    "auto_rotate": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional). Auto-rotate until user drags. Default true."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_verified", "lit": "drawn", "angular": "drawn", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "Rotating 3D isometric height-field mesh. Default surface is a 16×16 Gaussian hill pre-computed server-side. Drag to rotate manually; auto-rotates until first touch. Height colour interpolates from dee",
   "x-intent-phrases": [
    "I need to show a topographical map that users can spin around.",
    "Can I display a 3D model of a terrain that moves on its own until I grab it?",
    "I want a visual representation of data that looks like a rolling landscape, adjustable by touch."
   ]
  },
  "geo_iso_takeoff": {
   "type": "object",
   "description": "Full-viewport isometric 3D canvas animation of an A321neo (or other narrowbody) departing from Toulouse Blagnac (LFBO). Shows rolling takeoff run, rotation, gear retraction, and climb-out against a night-sky grid. HUD overlay shows airline code, aircraft type, and runway. Accent colour auto-selected from airline ICAO (AIB=Airbus blue, EZY=orange, AFR=Air France blue, BAW=British Airways red, DLH=Lufthansa navy, RYR=Ryanair blue). Includes a LIVE RADAR button that opens the airspace_command_deck for LFBO.",
   "properties": {
    "component": {
     "const": "geo_iso_takeoff"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). HUD title line. Default \"LFBO RWY 32L — A321neo DEPARTURE\"."
    },
    "airline": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). ICAO airline code for accent colour — AIB, EZY, AFR, BAW, DLH, RYR. Default AIB."
    },
    "aircraft_type": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). ICAO aircraft type code — A21N (A321neo), A320, B738. Default A21N."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "Full-viewport isometric 3D canvas animation of an A321neo (or other narrowbody) departing from Toulouse Blagnac (LFBO). Shows rolling takeoff run, rotation, gear retraction, and climb-out against a ni",
   "x-intent-phrases": [
    "I need a cool way to show a plane taking off from a specific airport.",
    "Can I get an animated visual of a jet leaving the ground at Toulouse?",
    "I want to display a realistic plane departure scene for my aviation app."
   ]
  },
  "geo_iso_rocket_launch": {
   "type": "object",
   "description": "Full-viewport isometric 3D canvas animation of an Ariane 6 rocket launch from Kourou ELA-4. Shows pad, ignition, liftoff, and ascent trajectory. HUD overlay with mission data.",
   "properties": {
    "component": {
     "const": "geo_iso_rocket_launch"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). HUD title. Default \"KOUROU ELA-4 — HEAVY LIFT INJECTION PROFILE\"."
    },
    "vehicle": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). ARIANE_6 or ARIANE_5. Default ARIANE_6."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "Full-viewport isometric 3D canvas animation of an Ariane 6 rocket launch from Kourou ELA-4. Shows pad, ignition, liftoff, and ascent trajectory. HUD overlay with mission data.",
   "x-intent-phrases": [
    "I need a dynamic visualization of space missions.",
    "Show me a realistic rocket launch sequence in my app.",
    "I want to track a specific launch with a detailed animation."
   ]
  },
  "geo_iso_heli_hover": {
   "type": "object",
   "description": "Full-viewport isometric 3D canvas animation of an H160 helicopter hovering over a helipad. Rotor blur, downwash ripple, and HUD overlay with livery accent colour.",
   "properties": {
    "component": {
     "const": "geo_iso_heli_hover"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). HUD title. Default \"LFBO HELIPAD 2 — AIRBUS H160 HOVER PROFILE\"."
    },
    "livery": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). ICAO airline code for accent colour — AIB, EZY, AFR, etc. Default AIB."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "Full-viewport isometric 3D canvas animation of an H160 helicopter hovering over a helipad. Rotor blur, downwash ripple, and HUD overlay with livery accent colour.",
   "x-intent-phrases": [
    "I need a cool way to show off our helicopter fleet in 3D.",
    "Our app needs a visually stunning intro for flight simulation.",
    "Show a helicopter landing sequence with realistic effects."
   ]
  },
  "geo_iso_fleet": {
   "type": "object",
   "description": "Full-viewport tabbed showcase of all three isometric aviation animations — A321neo takeoff, Ariane 6 launch, and H160 hover — in a single atom with tab switcher. Use this for a full aviation/aerospace demo page. tab field sets which scene opens by default.",
   "properties": {
    "component": {
     "const": "geo_iso_fleet"
    },
    "airline": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Airline ICAO for A321neo accent — AIB, EZY, AFR, BAW, DLH, RYR. Default AIB."
    },
    "rocket": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). ESA or CNES. Default ESA."
    },
    "livery": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Airline ICAO for H160 livery. Default AIB."
    },
    "tab": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Starting tab — \"ac\" (A321neo), \"rk\" (Ariane 6), \"hh\" (H160). Default ac."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "Full-viewport tabbed showcase of all three isometric aviation animations — A321neo takeoff, Ariane 6 launch, and H160 hover — in a single atom with tab switcher. Use this for a full aviation/aerospace",
   "x-intent-phrases": [
    "I need a big, flashy display to show off our company's amazing flight simulations.",
    "Can I have a single screen that lets users easily switch between different aircraft and rocket animations?",
    "We need a dynamic, immersive way to present our aerospace technology to customers."
   ]
  },
  "airspace_command_deck": {
   "type": "object",
   "description": "Full-viewport Toulouse TMA airspace radar display — canvas radar with animated simulated flights, rotating sweep, VOR beacons, and approach paths. HTML/CSS overlay for crisp chyron title, weather panel, flight list HUD, and scrolling ticker. Driven by the toulouse_airspace.yaml playbook via the ?slide= URL parameter. For the Toulouse demo, prefer routing through Code.js _renderAirspaceSlide() which handles live METAR interpolation.",
   "properties": {
    "component": {
     "const": "airspace_command_deck"
    },
    "chyron_title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Top-left headline overlay."
    },
    "chyron_subtitle": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Top-left subtitle — supports interpolated METAR tags."
    },
    "ticker_text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Scrolling bottom bar text."
    },
    "ticker_speed": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Ticker scroll speed px/s. Default 45."
    },
    "panel_type": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). supervisor | target | (empty). Controls HUD flight list panel."
    },
    "panel_title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). HUD panel heading."
    },
    "lockedCallsign": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Highlight and add targeting reticle to this callsign."
    },
    "zoom": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). TMA radius shown in nm. Default 35."
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Canvas height px. Default 520."
    },
    "show_slate": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional). Render calibration boot slate instead of radar."
    },
    "slate_title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Slate heading."
    },
    "slate_description": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Slate body text."
    },
    "poll_question": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). If set, renders a vote overlay with bar chart."
    },
    "poll_options": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional). Array of option strings for the poll."
    },
    "poll_values": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional). Array of integer vote counts for each option."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Full-viewport Toulouse TMA airspace radar display — canvas radar with animated simulated flights, rotating sweep, VOR beacons, and approach paths. HTML/CSS overlay for crisp chyron title, weather pane",
   "x-intent-phrases": [
    "I need to see all planes flying near Toulouse on a map, with their paths and info.",
    "Show me live air traffic for the Toulouse region, including weather and flight details.",
    "I need a visual representation of approaching aircraft and navigational aids for Toulouse airspace."
   ]
  },
  "data_source": {
   "type": "object",
   "description": "Generic HTTP GET data feed. Fetches on server-side render (GAS surface via UrlFetchApp) then refreshes client-side via google.script.run.fetchDataSource(). Publishes to window.A2UI_DATA[name] and calls window.A2UI_CALLBACKS[name]. Other surfaces would use fetch() or requests instead.",
   "properties": {
    "component": {
     "const": "data_source"
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Feed identifier — other atoms subscribe to this name (required)."
    },
    "url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. HTTP GET endpoint."
    },
    "format": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). json | text. Default json."
    },
    "path": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Dot-notation path into parsed response (e.g. data.items)."
    },
    "refresh": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Client refresh interval seconds. 0 = initial load only. Default 0."
    },
    "cache": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Server-side CacheService TTL seconds. Default 15."
    }
   },
   "required": [
    "component",
    "name"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Generic HTTP GET data feed. Fetches on server-side render (GAS surface via UrlFetchApp) then refreshes client-side via google.script.run.fetchDataSource(). Publishes to window.A2UI_DATA[name] and call",
   "x-intent-phrases": [
    "I need to display live stock prices on my dashboard, updating every minute.",
    "My app needs to show weather forecasts for a user's selected location, fetched from an external API.",
    "I want to populate a dropdown with a list of product categories from our company's internal catalog."
   ]
  },
  "adsb_feed": {
   "type": "object",
   "description": "OpenSky Network ADS-B live traffic feed for a geographic bounding box. Fetches server-side on render (cached), refreshes client-side every refresh seconds. Publishes normalised flight objects {callsign, lat, lon, alt_ft, spd_kt, hdg, on_ground, squawk} to the named feed. Unauthenticated OpenSky limit is 400 req/day — keep cache TTL >= 15s.",
   "properties": {
    "component": {
     "const": "adsb_feed"
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Feed name other atoms subscribe to. Default adsb."
    },
    "lat_min": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Bounding box south edge degrees. Default 43.1 (LFBO TMA)."
    },
    "lat_max": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Bounding box north edge degrees. Default 44.2."
    },
    "lon_min": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Bounding box west edge degrees. Default 0.7."
    },
    "lon_max": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Bounding box east edge degrees. Default 2.0."
    },
    "refresh": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Client refresh interval seconds. Default 15."
    },
    "filter_ground": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional). Exclude on-ground traffic. Default true."
    },
    "cache": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Server-side cache TTL seconds. Default 15."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "native", "compose": "native"},
   "x-routing-text": "OpenSky Network ADS-B live traffic feed for a geographic bounding box. Fetches server-side on render (cached), refreshes client-side every refresh seconds. Publishes normalised flight objects {callsig",
   "x-intent-phrases": [
    "I need to see all planes in my current airspace, updated live.",
    "Show me all the aircraft flying over my city right now.",
    "I want a real-time map of every plane I can track in this region."
   ]
  },
  "metar_feed": {
   "type": "object",
   "description": "METAR weather for an ICAO station via aviationweather.gov. Fetches server-side on render (cached), refreshes client-side every refresh seconds. Publishes {wind, temp, qnh, raw} to the named feed. Visual atoms bind to it by name and receive updates without a page reload.",
   "properties": {
    "component": {
     "const": "metar_feed"
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Feed name other atoms subscribe to. Default metar."
    },
    "station": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). ICAO station code. Default LFBO."
    },
    "refresh": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Client refresh interval seconds. Default 60."
    },
    "cache": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Server-side cache TTL seconds. Default 30."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "native", "compose": "native"},
   "x-routing-text": "METAR weather for an ICAO station via aviationweather.gov. Fetches server-side on render (cached), refreshes client-side every refresh seconds. Publishes {wind, temp, qnh, raw} to the named feed. Visu",
   "x-intent-phrases": [
    "I need to see current weather conditions for my flight destination.",
    "Show me the latest airport weather report for takeoff.",
    "I need live wind and temperature data for aviation planning."
   ]
  },
  "firestore_read": {
   "type": "object",
   "description": "Data connector: reads a single Firestore document (noun: document at project/collection/doc_id) on server-side render (verb: read) and publishes the deserialized result to window.A2UI_DATA[name]. Visual atoms subscribe via window.A2UI_CALLBACKS[name] — the named connector wires data to presentation without direct coupling. GAS surface fetches via Firestore REST API using ScriptApp.getOAuthToken(); requires the datastore OAuth scope in appsscript.json. Optional client-side refresh calls google.script.run.fetchFirestoreDoc() so the page stays live without a reload. Data shape is surface-agnostic — any visual atom can bind to the named feed.",
   "properties": {
    "component": {
     "const": "firestore_read"
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Connector name — visual atoms subscribe via window.A2UI_CALLBACKS[name] (required)."
    },
    "project": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. GCP project ID that owns the Firestore database (required)."
    },
    "collection": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Firestore collection name (required)."
    },
    "doc_id": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Document ID within the collection (required)."
    },
    "refresh": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Client-side refresh interval seconds. 0 = initial load only. Default 0."
    }
   },
   "required": [
    "component",
    "name",
    "project",
    "collection",
    "doc_id"
   ],
   "x-surfaces": [
    "google-apps-script-web"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Data connector: reads a single Firestore document (noun: document at project/collection/doc_id) on server-side render (verb: read) and publishes the deserialized result to window.A2UI_DATA[name]. Visu",
   "x-intent-phrases": [
    "I need to show the current user's profile details on page load.",
    "Display the latest product description for a specific item immediately.",
    "Fetch and show the content of a specific article when the page loads."
   ]
  },
  "paragraph": {
   "type": "object",
   "description": "Prose paragraph block (alias for body, google-apps-script-web only)",
   "properties": {
    "component": {
     "const": "paragraph"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"},
   "x-routing-text": "Prose paragraph block (alias for body, google-apps-script-web only)",
   "x-intent-phrases": [
    "I need to display a block of explanatory text on my setup screen.",
    "Show some detailed instructions for the user on this page.",
    "I need a space to put the terms and conditions."
   ]
  },
  "text_block": {
   "type": "object",
   "description": "Plain text block rendered as a paragraph",
   "properties": {
    "component": {
     "const": "text_block"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"},
   "x-routing-text": "Plain text block rendered as a paragraph",
   "x-intent-phrases": [
    "I need to display a short explanation of how a feature works.",
    "I want to show some background information about a product.",
    "Please add a few sentences describing the terms of service."
   ]
  },
  "blockquote": {
   "type": "object",
   "description": "Styled pull-quote with optional attribution line",
   "properties": {
    "component": {
     "const": "blockquote"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "attribution": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Styled pull-quote with optional attribution line",
   "x-intent-phrases": [
    "I need to highlight a customer testimonial on my website.",
    "Show me how to make a significant quote stand out on a blog post.",
    "I want to display an expert's opinion prominently on a landing page."
   ]
  },
  "spacer": {
   "type": "object",
   "description": "Vertical whitespace gap between atoms",
   "properties": {
    "component": {
     "const": "spacer"
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string or number (optional, CSS height e.g. 24 or \"2rem\")"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "native", "compose": "native"},
   "x-routing-text": "Vertical whitespace gap between atoms",
   "x-intent-phrases": [
    "I need some breathing room above my button to make it stand out.",
    "There's not enough space between this text block and the image below it.",
    "I want to push this section down a bit to create a visual separation."
   ]
  },
  "tag_chip": {
   "type": "object",
   "description": "Small inline tag/label chip",
   "properties": {
    "component": {
     "const": "tag_chip"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex colour)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Small inline tag/label chip",
   "x-intent-phrases": [
    "I need to show keywords for an article.",
    "Can I display product categories that are clickable?",
    "How can I add small labels to user profiles?"
   ]
  },
  "badge": {
   "type": "object",
   "description": "Inline badge pill with accent colour",
   "properties": {
    "component": {
     "const": "badge"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex colour)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "claude-code",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Inline badge pill with accent colour",
   "x-intent-phrases": [
    "I need a small, colored tag to show the status of an item.",
    "Can I get a little label to highlight important information next to text?",
    "I want a round, colored marker to indicate a count or category."
   ]
  },
  "inline_code": {
   "type": "object",
   "description": "Monospace inline code span",
   "properties": {
    "component": {
     "const": "inline_code"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Monospace inline code span",
   "x-intent-phrases": [
    "I need to show a short piece of computer command.",
    "Please highlight a specific keyboard shortcut.",
    "I want to display a variable name clearly."
   ]
  },
  "code_block": {
   "type": "object",
   "description": "Syntax-highlighted code block",
   "properties": {
    "component": {
     "const": "code_block"
    },
    "language": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, e.g. python, js, yaml)"
    },
    "content": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Syntax-highlighted code block",
   "x-intent-phrases": [
    "I need a way to show users how to use my API with clear examples.",
    "My documentation needs to present code snippets that are easy to read and understand.",
    "I want to display configuration files in my app so they are visually distinct and organized."
   ]
  },
  "link_button": {
   "type": "object",
   "description": "Text hyperlink styled as a button",
   "properties": {
    "component": {
     "const": "link_button"
    },
    "url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "same_tab": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional). Default false (opens in a NEW tab) — right for the common case, an outbound link to somewhere that is not this app. Same opt-in chip_group already has: set true for an in-app \"go to this page\" link, which should behave like ordinary navigation rather than leaving a tab behind. Flipped from always-same-tab to this default 2026-08-15 after an outbound product-vendor link replaced the whole app instead of opening alongside it."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"},
   "x-routing-text": "Text hyperlink styled as a button",
   "x-intent-phrases": [
    "I need a way for users to click and go to another page without looking like a plain link.",
    "Make this text look like a clickable button to take them somewhere else.",
    "I want to offer a prominent option for users to navigate to a different section."
   ]
  },
  "cta_button": {
   "type": "object",
   "description": "Full-width call-to-action button linking to a URL",
   "properties": {
    "component": {
     "const": "cta_button"
    },
    "url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex)"
    },
    "same_tab": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional). Default false (opens in a NEW tab) — see link_button's same_tab for the full reasoning; same field, same default, same atom family."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"},
   "x-routing-text": "Full-width call-to-action button linking to a URL",
   "x-intent-phrases": [
    "I need a big, unmissable button on my homepage to send people to our sign-up page.",
    "Can I get a prominent link at the bottom of every article to take readers to a related product?",
    "We need a way to encourage users to visit a specific landing page from anywhere in the app."
   ]
  },
  "nav_link": {
   "type": "object",
   "description": "Single CTA button or link that navigates to a named A2UI page. Automatically appends &from=<current_slug> so the destination page's back button returns here. Style variants — primary (filled indigo), ghost (border), or text (minimal).",
   "properties": {
    "component": {
     "const": "nav_link"
    },
    "nav_slug": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). Slug of the destination named page."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Button label. Default \"Continue →\"."
    },
    "icon": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Emoji or icon prefix."
    },
    "style": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). \"primary\" (default), \"ghost\", or \"text\"."
    },
    "align": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). \"left\" (default), \"center\", or \"right\"."
    }
   },
   "required": [
    "component",
    "nav_slug"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Single CTA button or link that navigates to a named A2UI page. Automatically appends &from=<current_slug> so the destination page's back button returns here. Style variants — primary (filled indigo),",
   "x-intent-phrases": [
    "I need a button to take users to our account settings.",
    "Let's add a link to the pricing page from the homepage.",
    "We need a way for users to go to the 'New Item' form."
   ]
  },
  "info_card": {
   "type": "object",
   "description": "Simple card with title and body text",
   "properties": {
    "component": {
     "const": "info_card"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"},
   "x-routing-text": "Simple card with title and body text",
   "x-intent-phrases": [
    "I need a way to display a brief summary of a user's profile.",
    "Show me key details about a product without being overwhelming.",
    "How can I present important notifications clearly?",
    "Show a clinic's opening hours, address and what to bring before the patient confirms their appointment.",
    "Give guests the key details of their stay: check-in time, house rules and the host's contact."
   ]
  },
  "ai_build_trace": {
   "type": "object",
   "description": "Token usage and model trace card — shows Gemini call stats inline on a page",
   "properties": {
    "component": {
     "const": "ai_build_trace"
    },
    "model": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, e.g. gemini-2.5-flash)"
    },
    "prompt_tokens": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional)"
    },
    "thinking_tokens": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional)"
    },
    "output_tokens": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional)"
    },
    "total_tokens": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "native", "compose": "native"},
   "x-routing-text": "Token usage and model trace card — shows Gemini call stats inline on a page",
   "x-intent-phrases": [
    "I need to see how much the AI is costing me per interaction.",
    "Show me the details of the AI's thinking process for each result.",
    "I want to track the performance of different AI models I'm testing."
   ]
  },
  "gemini_prompt": {
   "type": "object",
   "description": "Inline Gemini prompt input that calls the GAS callGemini() function from within a rendered page",
   "properties": {
    "component": {
     "const": "gemini_prompt"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "placeholder": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex colour)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "native", "compose": "native"},
   "x-routing-text": "Inline Gemini prompt input that calls the GAS callGemini() function from within a rendered page",
   "x-intent-phrases": [
    "I need a quick way for users to ask questions about their data.",
    "Let me build a feature where users can generate text based on simple instructions.",
    "We need an easy way to integrate AI-powered chat into our existing web pages."
   ]
  },
  "dark_hero": {
   "type": "object",
   "description": "Full-width dark hero banner with gradient background, badge, headline, and CTA button",
   "properties": {
    "component": {
     "const": "dark_hero"
    },
    "heading": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "subtext": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "badge": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, small label above heading)"
    },
    "gradient": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, CSS gradient e.g. linear-gradient(135deg,#1e1b4b,#312e81))"
    },
    "cta_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "cta_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "align": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, left|center)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Full-width dark hero banner with gradient background, badge, headline, and CTA button",
   "x-intent-phrases": [
    "I need a big, eye-catching banner at the top of my landing page to grab attention.",
    "Can I get a visually striking header to introduce our new product launch?",
    "We need a bold section to highlight a key announcement or offer."
   ]
  },
  "glowing_stat": {
   "type": "object",
   "description": "Single large stat with neon glow effect on dark background",
   "properties": {
    "component": {
     "const": "glowing_stat"
    },
    "value": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string or number"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "colour": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex, default #22d3ee)"
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, CSS font-size)"
    },
    "prefix": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "suffix": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "glow": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Single large stat with neon glow effect on dark background",
   "x-intent-phrases": [
    "I need a way to highlight the most important number on my dashboard.",
    "Show me the big win, the key metric, with a cool, eye-catching style.",
    "Make the current user count really pop against the dark theme."
   ]
  },
  "glass_card": {
   "type": "object",
   "description": "Frosted-glass card with backdrop-filter blur. Use for dark-theme highlight boxes, callouts, or content wrappers. Content is raw HTML string.",
   "properties": {
    "component": {
     "const": "glass_card"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Card heading text."
    },
    "content": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Inner HTML content of the card."
    },
    "blur": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Backdrop blur in px. Default 18."
    },
    "bg": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Background colour (rgba). Default rgba(255,255,255,0.05)."
    },
    "border": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Border colour (rgba). Default rgba(255,255,255,0.1)."
    },
    "padding": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). CSS padding. Default 28px."
    },
    "radius": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Border radius. Default 16px."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"},
   "x-routing-text": "Frosted-glass card with backdrop-filter blur. Use for dark-theme highlight boxes, callouts, or content wrappers. Content is raw HTML string.",
   "x-intent-phrases": [
    "I need a way to make important notes stand out on my dark background.",
    "Can I get a translucent box to show off user-generated content subtly?",
    "I want a visual element that hints at depth without being opaque."
   ]
  },
  "gradient_border_card": {
   "type": "object",
   "description": "Card with an animated gradient border stroke on dark background",
   "properties": {
    "component": {
     "const": "gradient_border_card"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "content": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "colours": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of hex strings (optional, gradient stops)"
    },
    "bg": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, card background)"
    },
    "angle": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, gradient angle degrees)"
    },
    "padding": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "radius": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Card with an animated gradient border stroke on dark background",
   "x-intent-phrases": [
    "I need to highlight a featured item with a dynamic, eye-catching outline.",
    "Can I have a card that draws attention to new content with a flowing color effect?",
    "Showcase key information with a subtle, moving edge that feels premium."
   ]
  },
  "floating_orbs": {
   "type": "object",
   "description": "Decorative blurred colour orbs that float in a dark background area",
   "properties": {
    "component": {
     "const": "floating_orbs"
    },
    "orbs": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {colour, size, x, y} (optional)"
    },
    "blur": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, blur px)"
    },
    "opacity": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, 0–1)"
    },
    "animate": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "native", "compose": "native"},
   "x-routing-text": "Decorative blurred colour orbs that float in a dark background area",
   "x-intent-phrases": [
    "I need some gentle, colourful background elements to make my app feel more dynamic and less sterile.",
    "Can I get some soft, diffused lights that drift around to add a bit of mood to my dark screen?",
    "I want to add a subtle visual flourish that makes my app's ambient sections feel more engaging and less empty."
   ]
  },
  "neon_text": {
   "type": "object",
   "description": "Neon-coloured glowing text, ideal for dark technical pages",
   "properties": {
    "component": {
     "const": "neon_text"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "colour": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex, default #22d3ee)"
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, CSS font-size)"
    },
    "weight": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string or number (optional)"
    },
    "align": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, left|center|right)"
    },
    "flicker": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Neon-coloured glowing text, ideal for dark technical pages",
   "x-intent-phrases": [
    "I need to highlight important status updates with a vibrant, eye-catching effect.",
    "My app's dashboard needs some visually striking elements for key metrics.",
    "We want to add a futuristic feel to our command-line interface simulation."
   ]
  },
  "dark_feature_grid": {
   "type": "object",
   "description": "Responsive feature grid on dark background — icon, title, description per cell",
   "properties": {
    "component": {
     "const": "dark_feature_grid"
    },
    "features": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {icon, title, description, colour}"
    },
    "columns": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 3)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Responsive feature grid on dark background — icon, title, description per cell",
   "x-intent-phrases": [
    "I need a section to showcase benefits with icons and short explanations.",
    "We're launching a new service and want to highlight its key selling points attractively.",
    "Showcase partner logos and what they offer in a visually appealing, organized way."
   ]
  },
  "dark_divider": {
   "type": "object",
   "description": "Thin horizontal rule for dark theme pages",
   "properties": {
    "component": {
     "const": "dark_divider"
    },
    "colour": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex)"
    },
    "margin": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, CSS margin)"
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, CSS height)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "native", "compose": "native"},
   "x-routing-text": "Thin horizontal rule for dark theme pages",
   "x-intent-phrases": [
    "I need a subtle way to separate sections on my dark background settings page.",
    "Can I get a faint line to break up content blocks on my dark mode dashboard?",
    "I'm looking for a discreet separator for my dark-themed product listing."
   ]
  },
  "ambient_gradient": {
   "type": "object",
   "description": "Full-screen animated aurora background — alias for aurora_background",
   "properties": {
    "component": {
     "const": "ambient_gradient"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Full-screen animated aurora background — alias for aurora_background",
   "x-intent-phrases": [
    "I need a captivating, ever-changing backdrop for my app's loading screen.",
    "My meditation app could really use a calming, visual element that feels alive.",
    "I want a dynamic, ethereal visual to set the mood on my app's welcome page."
   ]
  },
  "depth_stack": {
   "type": "object",
   "description": "Stacked layered cards with parallax depth — alias for card_stack",
   "properties": {
    "component": {
     "const": "depth_stack"
    },
    "cards": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {title, text} (alias: items)"
    },
    "count": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, max cards to show)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Stacked layered cards with parallax depth — alias for card_stack",
   "x-intent-phrases": [
    "I need a way to visually organize information into distinct, visually separated sections that feel like they're layered.",
    "Can I get a card-like arrangement where elements appear to have different distances from the viewer?",
    "I want to create a sense of depth and hierarchy with cards that move slightly independently."
   ]
  },
  "scramble_reveal": {
   "type": "object",
   "description": "Text that decrypts/un-scrambles character-by-character on scroll — alias for encrypted_reveal",
   "properties": {
    "component": {
     "const": "scramble_reveal"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (alias: content, label)"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Text that decrypts/un-scrambles character-by-character on scroll — alias for encrypted_reveal",
   "x-intent-phrases": [
    "I need text to appear gradually as the user scrolls down the page.",
    "Can I make important information fade in slowly instead of just popping up?",
    "My users should see a secret message unhide itself as they read."
   ]
  },
  "scroll_trigger": {
   "type": "object",
   "description": "Content that animates in from a direction when scrolled into view — alias for reveal_on_scroll",
   "properties": {
    "component": {
     "const": "scroll_trigger"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (alias: content)"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "delay": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, seconds)"
    },
    "direction": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, up|down|left|right)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "Content that animates in from a direction when scrolled into view — alias for reveal_on_scroll",
   "x-intent-phrases": [
    "I want images to slide in from the side as I scroll down the page.",
    "Make sections of text fade into view as they become visible.",
    "I need cards to pop up when the user scrolls to them."
   ]
  },
  "flow_connector": {
   "type": "object",
   "description": "Animated dashed beam connecting two labelled nodes — alias for animated_beam. Two shapes — a single from/to/label pair (original), or a multi-node nodes/connectors chain (added 2026-07-24, e.g. an identity/ permission chain of more than 2 hops) where each node can be a bare string (simple pill) or a {role, name, detail} object (richer boxed card).",
   "properties": {
    "component": {
     "const": "flow_connector"
    },
    "from": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string or {role, name, detail} object (ignored if nodes is set)"
    },
    "to": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string or {role, name, detail} object (ignored if nodes is set)"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, ignored if nodes is set)"
    },
    "nodes": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional). Array of string or {role, name, detail} — 2+ nodes in a single chain, rendered left to right."
    },
    "connectors": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of string (optional). Labels between each consecutive pair in `nodes` — length should be len(nodes)-1."
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex)"
    },
    "theme": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, \"light\"|\"dark\", default \"light\")"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Animated dashed beam connecting two labelled nodes — alias for animated_beam. Two shapes — a single from/to/label pair (original), or a multi-node nodes/connectors chain (added 2026-07-24, e.g. an ide",
   "x-intent-phrases": [
    "I need to show the path a user takes through my app, from start to finish.",
    "I want to visualize a sequence of actions, with clear steps and connections.",
    "Help me draw out the flow of data between different parts of my system."
   ]
  },
  "live_metric": {
   "type": "object",
   "description": "Animated counter that counts up from start to a target value — alias for animated_counter",
   "properties": {
    "component": {
     "const": "live_metric"
    },
    "value": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (alias: end)"
    },
    "start": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional)"
    },
    "duration": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, seconds)"
    },
    "prefix": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "suffix": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "decimals": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Animated counter that counts up from start to a target value — alias for animated_counter",
   "x-intent-phrases": [
    "I need a way to show users how many sales we've made today that updates automatically.",
    "Can I have a number that smoothly increases as new users sign up?",
    "I want to display a growing total of completed tasks in real-time for my dashboard."
   ]
  },
  "deadline_ticker": {
   "type": "object",
   "description": "Countdown timer showing days/hours/minutes/seconds to a target date — alias for countdown_timer",
   "properties": {
    "component": {
     "const": "deadline_ticker"
    },
    "target_date": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (ISO date, alias: target)"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, alias: title)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Countdown timer showing days/hours/minutes/seconds to a target date — alias for countdown_timer",
   "x-intent-phrases": [
    "I need to show customers how much time they have left to claim a limited-time offer.",
    "We want to create urgency for a flash sale ending soon.",
    "Users need to see the exact time remaining before their free trial expires."
   ]
  },
  "pattern_background": {
   "type": "object",
   "description": "Dot-grid repeating pattern background — alias for dot_grid_background",
   "properties": {
    "component": {
     "const": "pattern_background"
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, dot colour hex)"
    },
    "bg": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, background colour)"
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, dot spacing px)"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Dot-grid repeating pattern background — alias for dot_grid_background",
   "x-intent-phrases": [
    "I need a subtle background for my dashboard that doesn't distract from the data.",
    "My website needs a visual element that suggests organization and structure without being too busy.",
    "I want a clean, minimal look for my app's login screen, with a hint of texture."
   ]
  },
  "glitch_text": {
   "type": "object",
   "description": "Cyan glitch-effect headline — periodic RGB-split animation",
   "properties": {
    "component": {
     "const": "glitch_text"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (alias: title, label)"
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, CSS font-size, default 2rem)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Cyan glitch-effect headline — periodic RGB-split animation",
   "x-intent-phrases": [
    "I need a way to make my main title pop with a cool, retro digital look.",
    "My app's intro needs a dynamic, eye-catching headline that feels energetic.",
    "We want a dramatic, vibrant effect for our announcement banner."
   ]
  },
  "neon_glow": {
   "type": "object",
   "description": "Pulsing neon-glow text on a near-black background",
   "properties": {
    "component": {
     "const": "neon_glow"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (alias: title, label)"
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex, default #22d3ee)"
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, CSS font-size)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Pulsing neon-glow text on a near-black background",
   "x-intent-phrases": [
    "I need text that really pops, like a futuristic sign, for my login button.",
    "How can I make my app's title feel energetic and attention-grabbing, almost like it's alive?",
    "I want a special effect for a key status message that draws the eye immediately."
   ]
  },
  "magnetic_button": {
   "type": "object",
   "description": "Button that follows the cursor magnetically on hover",
   "properties": {
    "component": {
     "const": "magnetic_button"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (alias: label, title)"
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex background)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Button that follows the cursor magnetically on hover",
   "x-intent-phrases": [
    "I need buttons that feel more interactive and engaging on my product pages.",
    "My users should feel a playful connection to the call-to-action buttons.",
    "I want my navigation links to subtly guide the user's eye as they move their mouse."
   ]
  },
  "confetti_trigger": {
   "type": "object",
   "description": "Button that triggers confetti explosion when clicked",
   "properties": {
    "component": {
     "const": "confetti_trigger"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (message shown after click, alias: text)"
    },
    "trigger": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (button label, alias: button)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Button that triggers confetti explosion when clicked",
   "x-intent-phrases": [
    "I need a way to celebrate when someone finishes a task successfully.",
    "Can I add a fun animation to acknowledge a major achievement?",
    "I want a visual reward to make key actions feel more exciting."
   ]
  },
  "floating_particles": {
   "type": "object",
   "description": "Soft bokeh particle field on canvas: dozens of luminous, depth-sized orbs drift upward, swaying on a slow noise field, drawn additively so they glow where they overlap; the pointer nudges them aside. Optional eyebrow/title/body copy centred over the field behind a readability veil. Honours prefers-reduced-motion (one static frame), pauses offscreen, DPR-aware. Was a \"canvas fallback placeholder\" until 2026-09-19 (a grey box on GAS and MCP Apps); now a real atom on the same kit as flow_field, identical on every renderer. Every option is an enum or a clamped int; colours must be #rrggbb.",
   "properties": {
    "component": {
     "const": "floating_particles"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, alias: label, text). Heading centred over the field."
    },
    "eyebrow": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Small uppercase label above the title."
    },
    "body": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Copy under the title (markdown inline supported)."
    },
    "colors": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of 1-4 \"#rrggbb\" strings (optional). Default indigo/violet/pink/cyan."
    },
    "background": {
     "description": "\"#rrggbb\" (optional). Default \"#0f172a\". Keep it dark."
    },
    "density": {
     "description": "\"low\" | \"normal\" | \"high\"  (optional, default \"normal\")"
    },
    "speed": {
     "description": "\"slow\" | \"normal\" | \"fast\"  (optional, default \"normal\")"
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Panel height in px, clamped 120-900. Default 240."
    },
    "interactive": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Pointer nudges the particles. Default true."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Soft bokeh particle field on canvas: dozens of luminous, depth-sized orbs drift upward, swaying on a slow noise field, drawn additively so they glow where they overlap; the pointer nudges them aside.",
   "x-intent-phrases": [
    "I need a gentle, ambient visual for my app's loading screen.",
    "Can I get a subtle background effect that reacts to user interaction?",
    "We're looking for a dreamy, ethereal glow for our meditation app."
   ]
  },
  "parallax_section": {
   "type": "object",
   "description": "Depth-layered background on canvas: three layers of soft colour orbs, large and faint at the back, small and sharp at the front, each layer shifting with the pointer by an amount proportional to its depth, plus a slow ambient drift when the pointer is away. Optional eyebrow/title/body copy centred on top. Pointer-driven rather than scroll-driven on purpose: MCP Apps hosts size the iframe to its content, so there is often no scroll to drive. Honours prefers-reduced-motion (one static frame), pauses offscreen, DPR-aware. Was a \"canvas fallback placeholder\" until 2026-09-19; now a real atom on the flow_field kit, identical on every renderer.",
   "properties": {
    "component": {
     "const": "parallax_section"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, alias: label, text). Heading centred over the layers."
    },
    "eyebrow": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Small uppercase label above the title."
    },
    "body": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Copy under the title (markdown inline supported)."
    },
    "colors": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of 1-4 \"#rrggbb\" strings (optional). Default indigo/pink/cyan."
    },
    "background": {
     "description": "\"#rrggbb\" (optional). Default \"#0f172a\". Keep it dark."
    },
    "depth": {
     "description": "\"subtle\" | \"normal\" | \"deep\"  (optional, default \"normal\"). How far the layers shift with the pointer."
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Panel height in px, clamped 160-900. Default 300."
    },
    "interactive": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional). Pointer drives the parallax. Default true."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Depth-layered background on canvas: three layers of soft colour orbs, large and faint at the back, small and sharp at the front, each layer shifting with the pointer by an amount proportional to its d",
   "x-intent-phrases": [
    "I need a way to make my landing page feel more dynamic and immersive, with elements that subtly react to where the user is looking.",
    "Can I get some gentle, shifting visual effects for my hero section to draw users in and convey a sense of depth?",
    "I want a subtle background that adds polish and a bit of magic to my app's intro screens, making them feel less static."
   ]
  },
  "scroll_progress": {
   "type": "object",
   "description": "Thin fixed progress bar at the top of the viewport showing scroll position",
   "properties": {
    "component": {
     "const": "scroll_progress"
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex, default #4f46e5)"
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, px, default 3)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "native", "compose": "native"},
   "x-routing-text": "Thin fixed progress bar at the top of the viewport showing scroll position",
   "x-intent-phrases": [
    "I want users to see how far they've scrolled down a long page.",
    "Help readers know when they're approaching the end of an article.",
    "Show users their progress as they move through a multi-step form."
   ]
  },
  "live_clock": {
   "type": "object",
   "description": "Live ticking clock on a dark card, updates every second",
   "properties": {
    "component": {
     "const": "live_clock"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, alias: title)"
    },
    "format": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, 12h|24h, default 24h)"
    },
    "timezone": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, IANA tz label for display only)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Live ticking clock on a dark card, updates every second",
   "x-intent-phrases": [
    "I need to show the current time prominently on my dashboard.",
    "My app requires a constant visual indicator of when events happened.",
    "We want a dynamic element to display the exact moment of data refresh."
   ]
  },
  "decision_tree": {
   "type": "object",
   "description": "Interactive collapsible decision tree with nested branches",
   "properties": {
    "component": {
     "const": "decision_tree"
    },
    "nodes": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {text, children: [{text, children}]} — nested tree nodes"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "layout": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Absent, 'outline' or anything else keeps the collapsible outline. 'tree' draws the nested form as a static top-down tidy tree (the same d3 tree layout and boxes as org_chart; the nested lists stay in the page for screen readers, but there is nothing to expand or collapse). It draws at most 31 nodes, 6 levels and labels of up to 32 characters; beyond that, or for the id/next graph form, the outline is shown with a note. Branch text stays inside each node's text (there is no separate edge label field)."
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1). The decision_tree contract the payload was written for. Only version 1 exists; a higher whole number is drawn as version 1 with a note."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Interactive collapsible decision tree with nested branches",
   "x-intent-phrases": [
    "I need a way to visualize complex rules and show how they lead to different outcomes.",
    "Help me display a hierarchy of choices where users can expand or collapse sections to see details.",
    "I want to build an interactive flow chart that guides users through a series of questions."
   ]
  },
  "step_reveal_sequence": {
   "type": "object",
   "description": "Tab-style step-by-step content with radio-button navigation",
   "properties": {
    "component": {
     "const": "step_reveal_sequence"
    },
    "steps": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {title, text} — each step shown in its own tab panel"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Tab-style step-by-step content with radio-button navigation",
   "x-intent-phrases": [
    "I need to guide users through a multi-stage process, showing one part at a time.",
    "How can I create a clear, organized way for users to explore different options sequentially?",
    "I want users to click through distinct sections of information without scrolling."
   ]
  },
  "sequence_diagram": {
   "type": "object",
   "description": "Multi-actor message sequence diagram — participant boxes with dashed lifelines, per-message arrow rows in order, note bands, and labelled alt/opt/loop/par frames. Feature-parity with the mermaid sequenceDiagram / Google-A2A convention (solid arrow = call, dashed = return/async; optional autonumber) but fully declarative for an LLM (it describes actors + messages structurally, never mermaid syntax) and self-contained (pure HTML/CSS, no client-side JS — renders on every surface, not just web). General-purpose protocol/architecture diagram; not limited to 2-role chat threads the way chat_sequence is.",
   "properties": {
    "component": {
     "const": "sequence_diagram"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex, default \"#4f46e5\")"
    },
    "theme": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, \"light\"|\"dark\"|\"site\", default \"light\"). \"site\" follows the host page's light/dark theme (its CSS custom properties) instead of baking a fixed one — for embedding in a themed site."
    },
    "autonumber": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional, default false) — prefix each message with a sequential number badge (mermaid's autonumber)."
    },
    "actors": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "required array of participants, left→right. Each is a plain string (used as both id and label) OR an object {id, label} for a mermaid-style alias (messages/notes may reference the short id while the box shows the friendly label)."
    },
    "messages": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array; each item is one of — MESSAGE {from, to, text, kind?} where from/to are actor ids or labels; kind=\"return\" (aliases reply=true / dashed=true) renders a DASHED arrow (a return or async/stream) vs the default solid arrow (a call/request), the mermaid -->> / ->> distinction; NOTE {note=true, text, over?} where over (an actor, or [a,b] pair) anchors the note box over that lifeline / across that span (mermaid's Note over X / Note over X,Y); omit over for a full-width band; FRAME {frame=\"alt\"|\"opt\"|\"loop\"|\"par\"|\"group\", label, messages=[...], else?=[{label, messages}]} a labelled bordered box grouping nested messages (mermaid's alt/opt/loop/par control-flow frame; alt/par use the optional else branches for alternatives; frames nest)."
    }
   },
   "required": [
    "component",
    "actors"
   ],
   "x-surfaces": [
    "web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Multi-actor message sequence diagram — participant boxes with dashed lifelines, per-message arrow rows in order, note bands, and labelled alt/opt/loop/par frames. Feature-parity with the mermaid seque",
   "x-intent-phrases": [
    "I need to show how user actions trigger different system responses.",
    "Help me visualize the flow of data between our microservices.",
    "I want to illustrate the order of operations in a complex workflow."
   ]
  },
  "chat_sequence": {
   "type": "object",
   "description": "Animated conversation thread with user/assistant bubbles",
   "properties": {
    "component": {
     "const": "chat_sequence"
    },
    "messages": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {role (user|assistant), name (optional), text}"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Animated conversation thread with user/assistant bubbles",
   "x-intent-phrases": [
    "I need a way to show back-and-forth messages between a customer and our support team, with each person's replies clearly marked.",
    "My app needs a dynamic display for a dialogue between our AI assistant and the user, showing each turn as it happens.",
    "We want to visualize a step-by-step interaction flow where one party asks questions and the other provides answers sequentially."
   ]
  },
  "tooltip_glossary": {
   "type": "object",
   "description": "Glossary list where hovering a term shows its definition as a tooltip",
   "properties": {
    "component": {
     "const": "tooltip_glossary"
    },
    "terms": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {term, definition}"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, introductory prose, alias: intro)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Glossary list where hovering a term shows its definition as a tooltip",
   "x-intent-phrases": [
    "I need a way to explain jargon when people hover over it.",
    "Show users definitions for technical terms right there on the page.",
    "Can we add pop-up explanations for the specialized vocabulary?"
   ]
  },
  "focus_lens": {
   "type": "object",
   "description": "Blurred background with a clear focused panel in the centre — spotlight effect",
   "properties": {
    "component": {
     "const": "focus_lens"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, alias: content)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Blurred background with a clear focused panel in the centre — spotlight effect",
   "x-intent-phrases": [
    "I need to highlight a specific form to make sure users fill it out correctly.",
    "Can I dim everything else so users only see the important message?",
    "I want to draw attention to a single button without distraction."
   ]
  },
  "terminal_boot": {
   "type": "object",
   "description": "Dark terminal window that types out boot/log lines one by one",
   "properties": {
    "component": {
     "const": "terminal_boot"
    },
    "lines": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of strings — lines typed out in sequence"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, shown as terminal header)"
    },
    "speed": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, ms between lines, default 380)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Dark terminal window that types out boot/log lines one by one",
   "x-intent-phrases": [
    "I need a way to show users the progress of a long background process, like data syncing.",
    "Can we display system status messages that appear as if they're being typed out?",
    "I want to simulate a command-line interface to give users feedback on actions."
   ]
  },
  "stagger_list": {
   "type": "object",
   "description": "List of items that animate in with a staggered delay — supports icons and descriptions",
   "properties": {
    "component": {
     "const": "stagger_list"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of strings or {icon, text, sub} objects"
    },
    "direction": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, up|down|left|right)"
    },
    "stagger": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, delay between items in seconds, default 0.1)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "List of items that animate in with a staggered delay — supports icons and descriptions",
   "x-intent-phrases": [
    "I need my user's onboarding steps to appear one after another to guide them.",
    "Can I make my featured products fade in sequentially when the page loads?",
    "I want to show a list of notification messages that pop up with a slight delay."
   ]
  },
  "liquid_button": {
   "type": "object",
   "description": "Button that morphs between circular and rounded-rectangle on hover",
   "properties": {
    "component": {
     "const": "liquid_button"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (alias: label, title)"
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex background)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Button that morphs between circular and rounded-rectangle on hover",
   "x-intent-phrases": [
    "I need a button that draws attention when the mouse is over it, changing its shape smoothly.",
    "Can I get a button that has a dynamic look, becoming more prominent when someone interacts with it?",
    "I want buttons that feel alive and respond visually to user presence, shifting their form subtly."
   ]
  },
  "highlight_sweep": {
   "type": "object",
   "description": "Text with an animated highlight sweep underline that plays on load",
   "properties": {
    "component": {
     "const": "highlight_sweep"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (alias: content)"
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, highlight colour hex, default #fef08a yellow)"
    },
    "delay": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, seconds before sweep starts)"
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, CSS font-size)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Text with an animated highlight sweep underline that plays on load",
   "x-intent-phrases": [
    "I need to draw attention to key phrases as they appear on the screen.",
    "We want to emphasize important words when a user first sees a section.",
    "Make this critical information pop out briefly when the page loads."
   ]
  },
  "progress_reveal": {
   "type": "object",
   "description": "Animated progress bar that counts from 0 to a value when scrolled into view",
   "properties": {
    "component": {
     "const": "progress_reveal"
    },
    "value": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (0–100, alias: percent)"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, alias: title)"
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex)"
    },
    "suffix": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, default %)"
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, bar height px)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Animated progress bar that counts from 0 to a value when scrolled into view",
   "x-intent-phrases": [
    "Show users how much of their setup is complete.",
    "Visualize the download percentage as it happens.",
    "Display the loading status of a large data import."
   ]
  },
  "big_reveal": {
   "type": "object",
   "description": "Large centred number or word that pops in with a spring scale animation",
   "properties": {
    "component": {
     "const": "big_reveal"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (the big value, alias: value, label)"
    },
    "sub": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional subtitle below, alias: subtitle)"
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex)"
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, CSS font-size, default 5rem)"
    },
    "delay": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, seconds)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Large centred number or word that pops in with a spring scale animation A phrase like 'confirm an entry was just saved' usually means inline_feedback_message or toast_notification, not this -- big_reveal is a large decorative number or word popping in, not a confirmation message."
  },
  "kinetic_headline": {
   "type": "object",
   "description": "Headline where each word flies in with a staggered animation",
   "properties": {
    "component": {
     "const": "kinetic_headline"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (alias: title)"
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, CSS font-size)"
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex)"
    },
    "stagger": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, seconds between words)"
    },
    "style": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, up|down|scale|fade)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Headline where each word flies in with a staggered animation",
   "x-intent-phrases": [
    "I need a big, attention-grabbing title that appears word by word.",
    "Can I have a title that animates in sequentially to build anticipation?",
    "I want the main heading to feel dynamic as it presents itself."
   ]
  },
  "text_reveal_mask": {
   "type": "object",
   "description": "Headline that sweeps in from left using clip-path mask animation",
   "properties": {
    "component": {
     "const": "text_reveal_mask"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (alias: title)"
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, CSS font-size)"
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex)"
    },
    "delay": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, seconds)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Headline that sweeps in from left using clip-path mask animation",
   "x-intent-phrases": [
    "I want titles to dramatically appear as the user scrolls down the page.",
    "Make my product names pop with a cool entrance effect when they load.",
    "Can we have the main headings slide in smoothly to grab attention?"
   ]
  },
  "split_reveal": {
   "type": "object",
   "description": "Content hidden behind two coloured panels that slide apart to reveal it",
   "properties": {
    "component": {
     "const": "split_reveal"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, alias: content)"
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, panel colour hex)"
    },
    "delay": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, seconds)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Content hidden behind two coloured panels that slide apart to reveal it",
   "x-intent-phrases": [
    "I want to hide a surprise until the user interacts by pulling two sides away.",
    "How can I make a big reveal where two sections move to uncover something important?",
    "I need a way to show a before-and-after effect by separating parts of the screen."
   ]
  },
  "mesh_gradient": {
   "type": "object",
   "description": "Dark card with radial mesh/blob gradient background — vivid multi-colour",
   "properties": {
    "component": {
     "const": "mesh_gradient"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, alias: content)"
    },
    "bg": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, base background colour)"
    },
    "colors": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of hex strings (optional, gradient blob colours)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Dark card with radial mesh/blob gradient background — vivid multi-colour",
   "x-intent-phrases": [
    "I need a background that feels modern and energetic for my feature cards.",
    "Can I get a visually striking element to highlight important content on my dashboard?",
    "I want a dynamic, colorful backdrop for my product showcase that grabs attention."
   ]
  },
  "stripe_background": {
   "type": "object",
   "description": "Card with animated diagonal stripe background pattern",
   "properties": {
    "component": {
     "const": "stripe_background"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, alias: content)"
    },
    "color1": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex, first stripe colour)"
    },
    "color2": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex, second stripe colour)"
    },
    "speed": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, animation seconds)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Card with animated diagonal stripe background pattern",
   "x-intent-phrases": [
    "I need a card that looks dynamic and modern, with a subtle movement.",
    "We want a visually interesting way to present featured content, not just a flat box.",
    "Can we have a card that feels premium and has some visual flair to it?"
   ]
  },
  "status_timeline": {
   "type": "object",
   "description": "Vertical timeline with status dots (done/active/pending/error/warning)",
   "properties": {
    "component": {
     "const": "status_timeline"
    },
    "events": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {title, date (optional), text (optional), status (done|active|pending|error|warning)}"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Vertical timeline with status dots (done/active/pending/error/warning)",
   "x-intent-phrases": [
    "Show me the step-by-step progress of a user's order.",
    "I need to visualize the stages of a support ticket resolution.",
    "Display the lifecycle of a document approval process visually."
   ]
  },
  "counter_group": {
   "type": "object",
   "description": "Row of animated counting stats separated by dividers",
   "properties": {
    "component": {
     "const": "counter_group"
    },
    "stats": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {value, label, color (optional), prefix (optional), suffix (optional), decimals (optional)} (alias: items)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Row of animated counting stats separated by dividers A phrase like 'how many items remain in a queue' or 'items left to review' usually means progress_bar, progress_circle, or step_progress, not this -- counter_group is a row of SEPARATE animated totals side by side, not a single remaining-count indicator."
  },
  "orbit_diagram": {
   "type": "object",
   "description": "Animated orbiting node diagram — central node with satellite labels on a dashed orbit ring",
   "properties": {
    "component": {
     "const": "orbit_diagram"
    },
    "center": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (label for the central node)"
    },
    "nodes": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of strings or {label, color} objects"
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex accent)"
    },
    "speed": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, animation speed)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Animated orbiting node diagram — central node with satellite labels on a dashed orbit ring",
   "x-intent-phrases": [
    "I need to visualize relationships between a main idea and related concepts, showing how they move around it.",
    "Can I get a graphic that shows a core item with smaller items circling it on a path?",
    "I want to display a central element and several connected points that are dynamically shown moving around it."
   ]
  },
  "noise_card": {
   "type": "object",
   "description": "Dark card with subtle SVG film-grain noise texture overlay",
   "properties": {
    "component": {
     "const": "noise_card"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, alias: content)"
    },
    "bg": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, background colour)"
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, text colour)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Dark card with subtle SVG film-grain noise texture overlay",
   "x-intent-phrases": [
    "I need a stylish way to present user-uploaded photos that feels a bit retro and artistic.",
    "My app needs visually interesting containers for news articles that aren't just plain blocks.",
    "Showcasing creative work requires cards with a subtle, textured background to add depth and personality."
   ]
  },
  "comparison_morph": {
   "type": "object",
   "description": "Draggable before/after slider revealing two text panels side by side",
   "properties": {
    "component": {
     "const": "comparison_morph"
    },
    "before": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{label (optional), text}"
    },
    "after": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{label (optional), text}"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Draggable before/after slider revealing two text panels side by side",
   "x-intent-phrases": [
    "I need to show how much a paragraph has changed from its original version.",
    "Users should be able to see the difference between two versions of a document easily.",
    "Let me compare two versions of user feedback side-by-side to spot improvements."
   ]
  },
  "word_cloud": {
   "type": "object",
   "description": "Interactive word cloud — static words or live Google Sheets feed with submit input",
   "properties": {
    "component": {
     "const": "word_cloud"
    },
    "words": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {text, weight} (optional static words)"
    },
    "palette": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of hex strings (optional, word colours)"
    },
    "placeholder": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, input placeholder)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex accent for input bar)"
    },
    "sheet_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, Google Sheet CSV URL for live words)"
    },
    "write_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, GAS doGet URL to write submissions)"
    },
    "poll": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, poll interval seconds)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Interactive word cloud — static words or live Google Sheets feed with submit input",
   "x-intent-phrases": [
    "I need to see the most popular topics being discussed by my users right now.",
    "Show me a dynamic display of keywords from our customer feedback to spot trends.",
    "I want a visual summary of frequently used terms from a shared spreadsheet."
   ]
  },
  "quiz_set": {
   "type": "object",
   "description": "Multi-question quiz with multiple-choice options, per-question explanations, pass score, and result screen",
   "properties": {
    "component": {
     "const": "quiz_set"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "questions": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {question, options: [string], correct: integer (0-based index), explanation (optional)}"
    },
    "pass_score": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, % to pass, default 70)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex)"
    },
    "on_pass": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (optional, atom block shown on pass)"
    },
    "on_fail": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (optional, atom block shown on fail)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Multi-question quiz with multiple-choice options, per-question explanations, pass score, and result screen",
   "x-intent-phrases": [
    "I need a way for users to test their knowledge on a topic and see why they got answers wrong.",
    "We want to create a fun interactive experience where people can check how much they've learned.",
    "Users should be able to complete a series of questions and get a summary of their performance."
   ]
  },
  "globe_3d": {
   "type": "object",
   "description": "Spinning interactive 3-D wireframe or earth globe rendered on HTML5 canvas — draggable with inertia",
   "properties": {
    "component": {
     "const": "globe_3d"
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, diameter px, default 300)"
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex accent, default #4f46e5)"
    },
    "speed": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, auto-spin speed, default 0.006)"
    },
    "lines": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, latitude line count, default 10)"
    },
    "theme": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, wire|earth, default wire)"
    },
    "dots": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {lat, lon, label (optional), color (optional)} (optional, pins on globe)"
    },
    "arcs": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {from: [lat,lon], to: [lat,lon], color (optional)} (optional, great-circle arcs)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "Spinning interactive 3-D wireframe or earth globe rendered on HTML5 canvas — draggable with inertia",
   "x-intent-phrases": [
    "I need a map that lets users spin it around and zoom in to see details.",
    "My app needs an interactive world graphic for users to explore.",
    "Show me a 3D globe that users can freely move and explore visually."
   ]
  },
  "geo_mercator_radar": {
   "type": "object",
   "description": "Interactive Mercator projection map with draggable pan, node pins, and animated link vectors — dark radar aesthetic",
   "properties": {
    "component": {
     "const": "geo_mercator_radar"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex accent, default #00f2ff)"
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, px, default 450)"
    },
    "nodes": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {id, name, lat, lon, value (optional)}"
    },
    "links": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {from: id, to: id} (optional)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "Interactive Mercator projection map with draggable pan, node pins, and animated link vectors — dark radar aesthetic",
   "x-intent-phrases": [
    "I need to show where our users are around the world and how they connect.",
    "My app needs a map that feels like a tactical display, with points of interest that move.",
    "We want to visualize real-time data flow between different global locations on a dark, techy map."
   ]
  },
  "geo_contour_waves": {
   "type": "object",
   "description": "Animated isobaric atmospheric contour wave field — fluid procedural sine/cosine curves on dark background",
   "properties": {
    "component": {
     "const": "geo_contour_waves"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "color": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex, default #a78bfa)"
    },
    "intensity": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, wave band count, default 4, max 8)"
    },
    "height": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, px, default 350)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "Animated isobaric atmospheric contour wave field — fluid procedural sine/cosine curves on dark background",
   "x-intent-phrases": [
    "I need a visual to show how air pressure is changing across a map.",
    "Can I get a cool animation of weather patterns forming?",
    "I want to display wind currents in a dynamic way on a dark interface."
   ]
  },
  "multi_surface": {
   "type": "object",
   "description": "One data pool rendered simultaneously across three surface engines: spatial map (desktop), phone frame card list (mobile), circular focus face (IoT/watch)",
   "properties": {
    "component": {
     "const": "multi_surface"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "nodes": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {id, type, label, temp (optional), value (optional), intensity (0–100, optional), coords: {x, y}}"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "One data pool rendered simultaneously across three surface engines: spatial map (desktop), phone frame card list (mobile), circular focus face (IoT/watch)",
   "x-intent-phrases": [
    "I need to show a list of items that adapts to different screen sizes and devices.",
    "Users should see a primary item highlighted, with related content subtly available on various devices.",
    "We need a consistent way to present information that works well on a large monitor and a small watch face."
   ]
  },
  "geo_europe_airspace": {
   "type": "object",
   "description": "Interactive SVG European airspace map — country outlines, airport pins, simulated flight tracks, click-to-open TMA playbook",
   "properties": {
    "component": {
     "const": "geo_europe_airspace"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "focus": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, country name to highlight, alias: country)"
    },
    "sim_flights": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {callsign, from: [lat,lon], to: [lat,lon]} (optional simulated flight tracks)"
    },
    "airports": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional, show airport pins, default true)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "Interactive SVG European airspace map — country outlines, airport pins, simulated flight tracks, click-to-open TMA playbook",
   "x-intent-phrases": [
    "I need to show users where all the major airports are across Europe and let them click to see details about each region's air traffic control.",
    "We're building a flight tracking app and need a map that displays current flight paths over European countries.",
    "My users need to visualize European air routes and quickly access information about restricted zones or special air traffic areas."
   ]
  },
  "feed_status": {
   "type": "object",
   "description": "Live-feed status pill — shows LIVE (n) or SIM based on data published to a named feed",
   "properties": {
    "component": {
     "const": "feed_status"
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (feed name to subscribe to)"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, text prefix in pill)"
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, CSS font-size, default 0.6rem)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Live-feed status pill — shows LIVE (n) or SIM based on data published to a named feed",
   "x-intent-phrases": [
    "I need to see if the data stream is currently active and how many people are watching.",
    "Show me if the information coming in is real-time or from a simulation.",
    "I want a visual indicator of the connection status for this incoming data."
   ]
  },
  "playbook": {
   "type": "object",
   "description": "Full-screen multi-slide presentation deck — each slide is its own atom block array, with shared data feeds and slide navigation",
   "properties": {
    "component": {
     "const": "playbook"
    },
    "slides": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {id (optional), blocks: [atom block objects]} — each slide is a full block list"
    },
    "shared_blocks": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of atom block objects with role:data_source (optional). Rendered once before slides. Use for adsb_feed, metar_feed, firestore_read etc. — atoms that publish to window.A2UI_CALLBACKS[name] and have no visual output. Visual atoms in slides bind by name via data_source / weather_source / connector fields."
    },
    "transition": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, fade|slide, default fade)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "not_measured", "compose": "native"},
   "x-routing-text": "Full-screen multi-slide presentation deck — each slide is its own atom block array, with shared data feeds and slide navigation",
   "x-intent-phrases": [
    "I need to show a series of step-by-step instructions that users can click through.",
    "We need a way to present product features visually, one by one, with clear buttons to move forward and back.",
    "I want to create a guided tour for new users, where each screen highlights a different aspect of the app."
   ]
  },
  "surface_unlocked": {
   "type": "object",
   "description": "Game-style \"NEW SURFACE UNLOCKED\" achievement notification card",
   "properties": {
    "component": {
     "const": "surface_unlocked"
    },
    "icon": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, emoji, default ⚡)"
    },
    "surface": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (surface/feature name displayed large)"
    },
    "sub": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, subtitle, default NEW SURFACE UNLOCKED)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Game-style \"NEW SURFACE UNLOCKED\" achievement notification card",
   "x-intent-phrases": [
    "I need a way to celebrate when players discover new areas.",
    "Show players a cool pop-up when they reach a milestone.",
    "Announce a player's progress with a flashy graphic."
   ]
  },
  "schema_reveal": {
   "type": "object",
   "description": "Decodes the current page ?p= URL and displays the JSON schema that built this page",
   "properties": {
    "component": {
     "const": "schema_reveal"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Decodes the current page ?p= URL and displays the JSON schema that built this page",
   "x-intent-phrases": [
    "I need to see how the data is structured on this page to debug an issue.",
    "Show me the blueprint for this content so I can understand its components.",
    "I want to inspect the underlying code defining this view to verify its integrity."
   ]
  },
  "url_anatomy": {
   "type": "object",
   "description": "Visually annotates the current renderer URL, highlighting the GAS endpoint, ?p= parameter, and encoded payload",
   "properties": {
    "component": {
     "const": "url_anatomy"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Visually annotates the current renderer URL, highlighting the GAS endpoint, ?p= parameter, and encoded payload",
   "x-intent-phrases": [
    "I need to see exactly what data is being sent to our backend when a user clicks this button.",
    "How can I inspect the full request being made when this form is submitted?",
    "Let me easily verify the specific filters and search terms applied to this page's data."
   ]
  },
  "schema_qr": {
   "type": "object",
   "description": "Self-contained QR code for a given URL (or the current page URL on JS-capable surfaces) — computed via the vendored QR-Code-generator library (Project Nayuki, MIT) and rendered as inline SVG, zero network calls. Optionally interactive — set is_interactive to add a text input that live-regenerates the QR client-side as the visitor types.",
   "properties": {
    "component": {
     "const": "schema_qr"
    },
    "url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, fixed URL — defaults to the current page URL on JS-capable surfaces; static surfaces render nothing if omitted)"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "sub": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, sub-label below QR)"
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, px, default 220)"
    },
    "is_interactive": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional, default false). Adds a text input that live-regenerates the QR client-side. Only meaningful on web, google-apps-script-web, and mcp-apps — see degraded_on."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "email",
    "pdf",
    "google-apps-script-web",
    "google-apps-script-side-panel",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Self-contained QR code for a given URL (or the current page URL on JS-capable surfaces) — computed via the vendored QR-Code-generator library (Project Nayuki, MIT) and rendered as inline SVG, zero net",
   "x-intent-phrases": [
    "I need a quick way for users to share a link to this specific product page.",
    "How can I make it easy for people to scan and get to the checkout with their phone?",
    "I want to give visitors a simple way to save this article's address for later."
   ]
  },
  "take_away_card": {
   "type": "object",
   "description": "Bold single-insight pull-quote card designed to be screenshotted",
   "properties": {
    "component": {
     "const": "take_away_card"
    },
    "headline": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (alias: text, quote, insight)"
    },
    "sub": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, attribution/source, alias: author, source)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex)"
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, CSS font-size)"
    },
    "gradient": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of 2 hex strings (optional, background gradient colours)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Bold single-insight pull-quote card designed to be screenshotted",
   "x-intent-phrases": [
    "I need a way to highlight a key statistic on my dashboard.",
    "Showcase our most compelling customer testimonial prominently.",
    "Make our app's core benefit really stand out visually."
   ]
  },
  "next_step_strip": {
   "type": "object",
   "description": "Horizontal strip of numbered next steps with optional links",
   "properties": {
    "component": {
     "const": "next_step_strip"
    },
    "steps": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {number (optional), label, detail (optional, alias: action), url (optional)}"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Horizontal strip of numbered next steps with optional links",
   "x-intent-phrases": [
    "I need a way to show users where they are in a multi-part signup process.",
    "Our onboarding flow has several stages, and we want users to see what's coming next.",
    "Show me the progress for completing my profile with clear markers for each section."
   ]
  },
  "copy_prompt": {
   "type": "object",
   "description": "Monospace copyable text block — ideal for sharing Gemini prompts or code",
   "properties": {
    "component": {
     "const": "copy_prompt"
    },
    "prompt": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (text to display and copy, alias: text, content)"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, header label)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Monospace copyable text block — ideal for sharing Gemini prompts or code",
   "x-intent-phrases": [
    "I need a clear way for users to grab sample text for testing.",
    "Let's make it easy for people to copy example commands.",
    "We need a simple way to share snippets that users can quickly select."
   ]
  },
  "atom_anatomy": {
   "type": "object",
   "description": "Side-by-side panel showing a rendered atom alongside its raw JSON schema",
   "properties": {
    "component": {
     "const": "atom_anatomy"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, panel header)"
    },
    "schema": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (atom block JSON to render and display)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Side-by-side panel showing a rendered atom alongside its raw JSON schema",
   "x-intent-phrases": [
    "I need to see how my data visually appears versus its underlying structure.",
    "Show me the real-time effect of changing the code on the displayed item.",
    "I want to easily compare the final output with its configuration details."
   ]
  },
  "renderer_stats": {
   "type": "object",
   "description": "Simple stat grid showing custom key/value pairs — used to show renderer capabilities",
   "properties": {
    "component": {
     "const": "renderer_stats"
    },
    "stats": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {value, label}"
    },
    "sub": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, footer note)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Simple stat grid showing custom key/value pairs — used to show renderer capabilities",
   "x-intent-phrases": [
    "I need to show users what graphics settings their device supports.",
    "How can I display the specific features our rendering engine has enabled?",
    "We need a way to list out the performance tuning options available."
   ]
  },
  "prompt_to_schema": {
   "type": "object",
   "description": "Three-panel flow diagram: natural language prompt → generated JSON schema → rendered page",
   "properties": {
    "component": {
     "const": "prompt_to_schema"
    },
    "prompt": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (the input prompt text)"
    },
    "schema": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object or string (the generated JSON schema)"
    },
    "output": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (description of the rendered output)"
    },
    "labels": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of 3 strings (optional, panel headers)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Three-panel flow diagram: natural language prompt → generated JSON schema → rendered page",
   "x-intent-phrases": [
    "I need a quick way to create forms from simple instructions.",
    "Help me build dynamic web pages based on plain text descriptions.",
    "I want to translate user ideas into structured data for my app."
   ]
  },
  "before_after_stack": {
   "type": "object",
   "description": "Animated comparison: old approach items cross out one by one, then new approach slides in",
   "properties": {
    "component": {
     "const": "before_after_stack"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of strings (old approach items to cross out, alias: before_items)"
    },
    "before_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "after_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "result": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (the new approach shown after animation, alias: after_text)"
    },
    "delay": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, seconds between strikes)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Animated comparison: old approach items cross out one by one, then new approach slides in",
   "x-intent-phrases": [
    "I need to show how my app improves upon existing features step-by-step.",
    "Can I visually demonstrate the transition from our old workflow to the new one?",
    "I want to highlight the benefits of our updated system by showing what's being replaced."
   ]
  },
  "live_vote": {
   "type": "object",
   "description": "Live audience voting: buttons to vote, bar chart results, optional Google Sheets backend",
   "properties": {
    "component": {
     "const": "live_vote"
    },
    "question": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string"
    },
    "options": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of strings (vote choices)"
    },
    "sheet_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, Google Sheet CSV for live tallies)"
    },
    "write_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, GAS doGet URL to record votes)"
    },
    "poll": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, poll interval ms, default 5000)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Live audience voting: buttons to vote, bar chart results, optional Google Sheets backend",
   "x-intent-phrases": [
    "I need a way for my webinar attendees to quickly show their opinion during a presentation.",
    "My users need to see how popular different options are in real-time during a live event.",
    "I want to let my audience contribute and visualize their collective choices as we go."
   ]
  },
  "reaction_shower": {
   "type": "object",
   "description": "Emoji reaction buttons — tapping rains the emoji down the screen, with optional Sheet-backed totals",
   "properties": {
    "component": {
     "const": "reaction_shower"
    },
    "reactions": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of emoji strings (optional, default 🔥💡🤯👏)"
    },
    "write_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, GAS doGet URL to record reactions)"
    },
    "sheet_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, Google Sheet CSV for live counts)"
    },
    "poll": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, poll interval ms)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Emoji reaction buttons — tapping rains the emoji down the screen, with optional Sheet-backed totals",
   "x-intent-phrases": [
    "I want to let users show quick appreciation for posts with animated icons.",
    "How can I show the total number of likes for an item in a neat pop-up?",
    "Users need a fun way to react to comments without typing."
   ]
  },
  "raise_hand": {
   "type": "object",
   "description": "Audience raise-hand button with live count — optional Google Sheets backend",
   "properties": {
    "component": {
     "const": "raise_hand"
    },
    "question": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, prompt text above button)"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, button label, default ✋ Raise hand)"
    },
    "write_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, GAS doGet URL to record hands)"
    },
    "sheet_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, Google Sheet CSV for live count)"
    },
    "poll": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, poll interval ms)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Audience raise-hand button with live count — optional Google Sheets backend",
   "x-intent-phrases": [
    "I need a way for my users to signal they want to speak in a virtual meeting.",
    "Show attendees how many people are eager to participate next.",
    "Let me track who's ready to ask a question in a webinar."
   ]
  },
  "surface_map": {
   "type": "object",
   "description": "Visual diagram showing the A2UI surfaces — schema feeds into each render target",
   "properties": {
    "component": {
     "const": "surface_map"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "surfaces": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {name, icon, desc, color} (optional, defaults to GAS/Meet/Sites/Chat)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Visual diagram showing the A2UI surfaces — schema feeds into each render target",
   "x-intent-phrases": [
    "I need to see how our data flows from its source to the display.",
    "Show me the connections between where data comes from and what gets drawn on screen.",
    "I want a visual overview of how information is processed and presented to the user."
   ]
  },
  "speed_counter": {
   "type": "object",
   "description": "Stopwatch that starts ticking on load and freezes when the page finishes loading — shows real page load time",
   "properties": {
    "component": {
     "const": "speed_counter"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, e.g. \"Page loaded in\")"
    },
    "sub": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, sub-label)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Stopwatch that starts ticking on load and freezes when the page finishes loading — shows real page load time",
   "x-intent-phrases": [
    "I need to know how fast my site is actually responding to users.",
    "Show me the exact time it takes for everything on my page to appear.",
    "I want to measure and display how long the initial content takes to load."
   ]
  },
  "live_edit": {
   "type": "object",
   "description": "Embedded mini schema editor with a textarea for typing a single atom JSON block and a live rendered preview below",
   "properties": {
    "component": {
     "const": "live_edit"
    },
    "placeholder": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, example atom JSON)"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex)"
    },
    "renderer_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, renderer base URL for linking)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Embedded mini schema editor with a textarea for typing a single atom JSON block and a live rendered preview below",
   "x-intent-phrases": [
    "I need a way for users to quickly write custom data structures for their settings.",
    "How can I let people define simple rules or configurations directly in the app?",
    "I want to give my users a place to input and see the results of small data snippets."
   ]
  },
  "gmail_inbox": {
   "type": "object",
   "description": "Horizontal swipeable carousel of Gmail inbox threads. Each card shows a coloured sender avatar, name, subject (bold if unread), snippet and timestamp. Clicking opens the thread in Gmail. On GAS uses GmailApp for live data; on other surfaces renders from items[] array or Gmail REST API.",
   "properties": {
    "component": {
     "const": "gmail_inbox"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Section label above carousel. Default \"Inbox\"."
    },
    "count": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Number of threads, max 20. Default 10."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Accent colour for unread indicator and nav dot. Default"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (static connector). Email objects for non-GAS surfaces."
    },
    "auth_token": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (api connector). OAuth2 bearer token for REST API."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Horizontal swipeable carousel of Gmail inbox threads. Each card shows a coloured sender avatar, name, subject (bold if unread), snippet and timestamp. Clicking opens the thread in Gmail. On GAS uses G",
   "x-intent-phrases": [
    "I need to see my latest emails quickly, one after another, with a simple flick.",
    "Show me my important messages in a scrolling list where I can tap to read them.",
    "I want a clean way to browse through recent conversations without opening each one fully."
   ]
  },
  "drive_recent_files": {
   "type": "object",
   "description": "Horizontal swipeable carousel of recently modified Drive files. Each card shows a coloured file-type badge (DOC/XLS/PPT/PDF), name, relative modified time, and owner. On GAS searches files modified in last 30 days via DriveApp; on other surfaces renders from items[] array or Drive REST API.",
   "properties": {
    "component": {
     "const": "drive_recent_files"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Section label above carousel. Default \"Recent Files\"."
    },
    "count": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Number of files to show, max 20. Default 10."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Accent colour for active nav dot. Default"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (static connector). File objects for non-GAS surfaces."
    },
    "auth_token": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (api connector). OAuth2 bearer token for REST API."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Horizontal swipeable carousel of recently modified Drive files. Each card shows a coloured file-type badge (DOC/XLS/PPT/PDF), name, relative modified time, and owner. On GAS searches files modified in",
   "x-intent-phrases": [
    "I need to quickly see the documents I've been working on lately.",
    "Show me the spreadsheets I last edited so I can pick up where I left off.",
    "I want an easy way to access my most recent presentations and PDFs."
   ]
  },
  "drive_folder_contents": {
   "type": "object",
   "description": "Responsive grid of files and subfolders inside a Drive folder. Subfolders appear first, each item shows a coloured file-type badge and name, clicking opens in Drive. On GAS uses DriveApp with folder_id; on other surfaces renders from items[] array or Drive REST API with folder_id + auth_token.",
   "properties": {
    "component": {
     "const": "drive_folder_contents"
    },
    "folder_id": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (gas-native/api). The Google Drive folder ID to browse."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Override for the folder name shown as header."
    },
    "count": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Max items to show. Default 12."
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (static connector). File objects for non-GAS surfaces."
    },
    "auth_token": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (api connector). OAuth2 bearer token for REST API."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Responsive grid of files and subfolders inside a Drive folder. Subfolders appear first, each item shows a coloured file-type badge and name, clicking opens in Drive. On GAS uses DriveApp with folder_i",
   "x-intent-phrases": [
    "I need to see all the documents and folders in my project folder so I can quickly find what I'm looking for.",
    "Show me the contents of this client's folder, with folders listed before files, so I can organize our shared documents.",
    "I want to browse the files in my shared Drive space and click on them to open them in Google Drive."
   ]
  },
  "drive_file_card": {
   "type": "object",
   "description": "Single Drive file card — coloured file-type badge (DOC/XLS/PPT/PDF), file name, optional description, and an \"Open →\" button. Works on any surface using static name/mime/url fields. On GAS, file_id triggers live lookup via DriveApp to populate name and mime automatically.",
   "properties": {
    "component": {
     "const": "drive_file_card"
    },
    "file_id": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (gas-native). Drive file ID for live name/type lookup on GAS."
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. File display name — required on non-GAS surfaces."
    },
    "mime": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. MIME type for badge colour (e.g. application/vnd.google-apps.spreadsheet)."
    },
    "url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. URL to open — required on non-GAS surfaces."
    },
    "description": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Short description shown below the file name."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Single Drive file card — coloured file-type badge (DOC/XLS/PPT/PDF), file name, optional description, and an \"Open →\" button. Works on any surface using static name/mime/url fields. On GAS, file_id tr",
   "x-intent-phrases": [
    "I need to show a list of my recent documents so I can quickly grab and edit them.",
    "Can I see a preview of files I've shared with others before opening them?",
    "I want a clear way to display project documents with their names and a short summary."
   ]
  },
  "progress_store": {
   "type": "object",
   "description": "Invisible state connector atom — no visual output. Initialises window._A2UI_STORE and dispatches \"a2ui:store\" CustomEvent. On GAS reads initial state from a Google Sheet at render time and writes back async via google.script.run. On web reads/writes localStorage keyed by course_id. All other LMS atoms read from and write to this shared store. Must appear before any stateful atom on the page.",
   "properties": {
    "component": {
     "const": "progress_store"
    },
    "course_id": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). Unique course identifier — scopes the Sheet and localStorage key."
    }
   },
   "required": [
    "component",
    "course_id"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "Invisible state connector atom — no visual output. Initialises window._A2UI_STORE and dispatches \"a2ui:store\" CustomEvent. On GAS reads initial state from a Google Sheet at render time and writes back",
   "x-intent-phrases": [
    "I need to track the progress of a bulk data import without showing a distracting bar.",
    "My app needs to sync settings with a Google Sheet automatically in the background.",
    "I want to update a shared status across multiple parts of my application based on external data."
   ]
  },
  "module_map": {
   "type": "object",
   "description": "Visual curriculum grid showing all modules in a course. Each card displays module icon, title, description, duration, and a live status badge (locked/Start/Done) driven by progress_store. Locked modules are greyed out. Completed modules turn green. Cards navigate to module url on click.",
   "properties": {
    "component": {
     "const": "module_map"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Section heading. Default \"Course Modules\"."
    },
    "columns": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Grid columns, max 4. Default 3."
    },
    "modules": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required). Array of module objects. Each module supports: id (string, required), title, description, icon, duration, lessons, required[] (array of module ids that must be complete to unlock), and either: page (array of atom blocks, PREFERRED — auto-encoded into a self-contained URL at render time, no separate save needed) or url (string — only for external URLs or pre-saved nav pages). Always use page for inline module content."
    }
   },
   "required": [
    "component",
    "modules"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "not_measured", "compose": "native"},
   "x-routing-text": "Visual curriculum grid showing all modules in a course. Each card displays module icon, title, description, duration, and a live status badge (locked/Start/Done) driven by progress_store. Locked modul",
   "x-intent-phrases": [
    "I need to see all the lessons in my training course, what's next, and what I've finished.",
    "Show me my learning path, with progress indicators for each section.",
    "Display the entire course structure so I can track my progress and see upcoming topics."
   ]
  },
  "knowledge_check": {
   "type": "object",
   "description": "Lightweight inline comprehension pulse — a single multiple-choice question with instant feedback and no score impact. Correct answer turns green with explanation; wrong answer turns red with explanation. All options lock after selection. No retry gate — learner simply continues reading.",
   "properties": {
    "component": {
     "const": "knowledge_check"
    },
    "question": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). The comprehension question."
    },
    "options": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required). Array of answer strings."
    },
    "correct": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (required). Zero-based index of the correct answer."
    },
    "explanation": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Explanation shown after any selection."
    }
   },
   "required": [
    "component",
    "question",
    "options",
    "correct"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Lightweight inline comprehension pulse — a single multiple-choice question with instant feedback and no score impact. Correct answer turns green with explanation; wrong answer turns red with explanati",
   "x-intent-phrases": [
    "I need a quick way to test if users understand a specific point as they read.",
    "Can I add little pop quizzes to my articles to reinforce learning without making it feel like a test?",
    "How can I give users immediate confirmation that they've grasped a concept I just explained?"
   ]
  },
  "quiz_result_summary": {
   "type": "object",
   "description": "End-of-quiz result screen showing score percentage, pass/fail badge, time taken, per-question dot breakdown (green tick / red cross), and navigation buttons. Automatically writes the score to progress_store keyed by quiz_id. Pass mark is configurable.",
   "properties": {
    "component": {
     "const": "quiz_result_summary"
    },
    "score": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (required). Number of correct answers."
    },
    "total": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (required). Total number of questions."
    },
    "quiz_id": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). ID used to write score to progress_store."
    },
    "pass_mark": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Percentage required to pass. Default 70."
    },
    "time_secs": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Time taken in seconds for display."
    },
    "questions": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional). Array of {label, correct} for per-question breakdown dots."
    },
    "next_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). URL for Continue button (shown when passed)."
    },
    "retry_url": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). URL for Retry button."
    }
   },
   "required": [
    "component",
    "score",
    "total",
    "quiz_id"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "End-of-quiz result screen showing score percentage, pass/fail badge, time taken, per-question dot breakdown (green tick / red cross), and navigation buttons. Automatically writes the score to progress",
   "x-intent-phrases": [
    "I need to show users how they did on the test and if they passed.",
    "After the quiz, I want them to see their accuracy for each question and how long it took.",
    "Please display their final score and let them go back to the start or next section."
   ]
  },
  "scenario_branch": {
   "type": "object",
   "description": "Narrative branching learning atom. Presents a real-world situation with 2-4 labelled choices. Each choice reveals a consequence with good/neutral/bad outcome styling (green/amber/red). Includes a \"try again\" reset on non-linked consequences. Ideal for compliance, leadership, and soft-skills training.",
   "properties": {
    "component": {
     "const": "scenario_branch"
    },
    "scenario": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). The situation or challenge presented to the learner."
    },
    "context": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Background context shown in italics above the scenario."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Accent colour for choice buttons. Default"
    },
    "choices": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required). Array of {label, consequence, outcome, next_url?} objects. outcome is \"good\", \"neutral\", or \"bad\"."
    }
   },
   "required": [
    "component",
    "scenario",
    "choices"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Narrative branching learning atom. Presents a real-world situation with 2-4 labelled choices. Each choice reveals a consequence with good/neutral/bad outcome styling (green/amber/red). Includes a \"try",
   "x-intent-phrases": [
    "I need to show users how their decisions impact a situation.",
    "Users should see what happens after they pick an option.",
    "Let me present a problem and let users choose the best solution."
   ]
  },
  "completion_gate": {
   "type": "object",
   "description": "Renders a locked placeholder card until the specified module id is marked complete in progress_store. Once complete, the gate disappears to reveal content below it. Use to sequence content and prevent skipping.",
   "properties": {
    "component": {
     "const": "completion_gate"
    },
    "requires": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). Module id that must be complete in progress_store to unlock."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Lock card heading. Default \"Locked\"."
    },
    "message": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Message shown on the lock card."
    }
   },
   "required": [
    "component",
    "requires"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Renders a locked placeholder card until the specified module id is marked complete in progress_store. Once complete, the gate disappears to reveal content below it. Use to sequence content and prevent",
   "x-intent-phrases": [
    "I want to make sure users finish the intro before seeing the main features.",
    "Users should only unlock the next lesson after completing the current one.",
    "I need to hide the payment options until the user signs up for the trial."
   ]
  },
  "certification_card": {
   "type": "object",
   "description": "Completion certificate card — earner name, course title, issuer, and date with a gradient border and trophy icon. Locked behind a requires check against progress_store; becomes visible when the course is marked complete. On GAS, earner name is derived from active session if not supplied.",
   "properties": {
    "component": {
     "const": "certification_card"
    },
    "course": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). Course name on the certificate."
    },
    "issuer": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Issuing organisation name. Default \"A2UI Learning\"."
    },
    "requires": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Module/course id that must be complete to reveal the certificate."
    },
    "earner": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Earner display name — auto-derived from GAS session if not set."
    },
    "date": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Completion date string. Defaults to today."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Gradient accent colour. Default"
    }
   },
   "required": [
    "component",
    "course"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Completion certificate card — earner name, course title, issuer, and date with a gradient border and trophy icon. Locked behind a requires check against progress_store; becomes visible when the course",
   "x-intent-phrases": [
    "Show me my certificate after I finish the course.",
    "I want to display proof of completing this training.",
    "Let me see my badge once all lessons are done."
   ]
  },
  "skill_radar": {
   "type": "object",
   "description": "SVG spider/radar chart plotting learner competency levels across multiple skill dimensions. Optional before values render as a dashed polygon overlay for before/after growth comparison. Values are 0-100 per skill.",
   "properties": {
    "component": {
     "const": "skill_radar"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Chart heading. Default \"Skill Profile\"."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Fill/stroke colour for current polygon. Default"
    },
    "skills": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required). Array of {label, value (0-100), before? (0-100)} objects."
    }
   },
   "required": [
    "component",
    "skills"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "SVG spider/radar chart plotting learner competency levels across multiple skill dimensions. Optional before values render as a dashed polygon overlay for before/after growth comparison. Values are 0-1",
   "x-intent-phrases": [
    "Show me how much better I've gotten at coding.",
    "Visualize my progress in learning guitar over time.",
    "Display my strengths and weaknesses in different subject areas."
   ]
  },
  "badge_showcase": {
   "type": "object",
   "description": "Achievement badge wall — all course badges displayed in a grid. Earned badges glow with indigo highlight and full colour emoji; locked badges are greyed and dimmed. Each badge checks its required_id against progress_store to determine earned status.",
   "properties": {
    "component": {
     "const": "badge_showcase"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Section heading. Default \"Achievements\"."
    },
    "columns": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Grid columns, max 6. Default 4."
    },
    "badges": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required). Array of {id, label, icon, description, required_id} objects. required_id is the progress_store key to check for completion."
    }
   },
   "required": [
    "component",
    "badges"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Achievement badge wall — all course badges displayed in a grid. Earned badges glow with indigo highlight and full colour emoji; locked badges are greyed and dimmed. Each badge checks its required_id a",
   "x-intent-phrases": [
    "I need to show users all the cool rewards they can earn on their learning journey.",
    "Can I display a user's progress with visual indicators for completed achievements?",
    "We need a way to visually represent unlockable milestones in our app's gamification system."
   ]
  },
  "learning_path_selector": {
   "type": "object",
   "description": "Path chooser presented at course entry. Shows 2-4 role or level path cards (icon, title, description, duration). Learner clicks to select — selection is stored in progress_store via setPath() and optionally navigates to a path-specific url. Selected path can drive personalised module_map content.",
   "properties": {
    "component": {
     "const": "learning_path_selector"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Chooser heading. Default \"Choose Your Path\"."
    },
    "intro": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Introductory text below the heading."
    },
    "paths": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required). Array of {id, label, description, icon, accent, duration, url?} objects."
    }
   },
   "required": [
    "component",
    "paths"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Path chooser presented at course entry. Shows 2-4 role or level path cards (icon, title, description, duration). Learner clicks to select — selection is stored in progress_store via setPath() and opti",
   "x-intent-phrases": [
    "I need a way to show users their different learning options when they start a new course.",
    "Can I display a few curated learning tracks for them to pick from at the beginning?",
    "We need to let users choose a specific learning journey before they begin the material."
   ]
  },
  "video_checkpoint": {
   "type": "object",
   "description": "YouTube video with interactive quiz questions injected at specified timestamps. Video pauses at each checkpoint and the learner must answer before playback resumes. Correct/wrong feedback shown with explanation. Checkpoint state tracked per-session; completed checkpoints are skipped on replay.",
   "properties": {
    "component": {
     "const": "video_checkpoint"
    },
    "youtube_id": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). YouTube video ID."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Section heading above the player."
    },
    "checkpoints": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required). Array of {at_seconds, question, options[], correct (0-based index), explanation} objects."
    }
   },
   "required": [
    "component",
    "youtube_id",
    "checkpoints"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "YouTube video with interactive quiz questions injected at specified timestamps. Video pauses at each checkpoint and the learner must answer before playback resumes. Correct/wrong feedback shown with e",
   "x-intent-phrases": [
    "I need to make sure people watch my whole training video and understand it.",
    "How can I test viewers' comprehension during a long instructional video?",
    "Can I embed questions directly into a video to check learning as it plays?"
   ]
  },
  "cohort_progress_board": {
   "type": "object",
   "description": "Instructor-facing table showing all enrolled learners with per-module completion ticks and average quiz scores. On GAS reads live from the course progress Sheet via a2uiCohortRead. On web renders from static items[] array. Shows enrolled and active learner counts at top.",
   "properties": {
    "component": {
     "const": "cohort_progress_board"
    },
    "course_id": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). Matches the progress_store course_id."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Board heading. Default \"Cohort Progress\"."
    },
    "modules": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional). Array of {id, label} for column headers. Drives per-module completion dots."
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional, web/static). Array of {email, progress{}, updated_at} learner objects."
    }
   },
   "required": [
    "component",
    "course_id"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Instructor-facing table showing all enrolled learners with per-module completion ticks and average quiz scores. On GAS reads live from the course progress Sheet via a2uiCohortRead. On web renders from",
   "x-intent-phrases": [
    "I need to see how all my students are doing on each part of the course.",
    "Show me a list of everyone in my class and how far they've gotten, plus their quiz averages.",
    "I want a dashboard that tracks each student's progress through the lessons and their test scores."
   ]
  },
  "reflection_prompt": {
   "type": "object",
   "description": "Structured free-text reflection textarea with a submit button. Saves the response to progress_store under the key \"reflect:<prompt_id>\". On GAS this persists to the learner's progress Sheet. Restores previously saved text on revisit.",
   "properties": {
    "component": {
     "const": "reflection_prompt"
    },
    "prompt": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). The reflection question shown above the textarea."
    },
    "prompt_id": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Key suffix for progress_store. Default \"reflection\"."
    },
    "placeholder": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Textarea placeholder text."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Accent colour. Default"
    }
   },
   "required": [
    "component",
    "prompt"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Structured free-text reflection textarea with a submit button. Saves the response to progress_store under the key \"reflect:<prompt_id>\". On GAS this persists to the learner's progress Sheet. Restores",
   "x-intent-phrases": [
    "I need a way for users to jot down their thoughts after a lesson.",
    "We want to collect student feedback on specific learning activities.",
    "Provide a space for users to write down what they learned today."
   ]
  },
  "annotation_highlight": {
   "type": "object",
   "description": "Rich body text passage with clickable highlighted terms that reveal inline explanations in a panel below. No state required. Ideal for glossary enrichment, technical definitions, or legal clause annotation within learning content.",
   "properties": {
    "component": {
     "const": "annotation_highlight"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). Body text passage. Annotated terms are replaced server-side."
    },
    "notes": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required). Array of {term, explanation, color?} objects. First match in text is highlighted."
    }
   },
   "required": [
    "component",
    "text",
    "notes"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Rich body text passage with clickable highlighted terms that reveal inline explanations in a panel below. No state required. Ideal for glossary enrichment, technical definitions, or legal clause annot",
   "x-intent-phrases": [
    "I need to show definitions for terms in my article.",
    "Users should get quick info on jargon without leaving the page.",
    "Can I link words in a document to explanations?"
   ]
  },
  "onboarding_stepper": {
   "type": "object",
   "description": "Guided step-by-step onboarding flow for first-time learners. Each step has a label, description, optional action URL (navigated to on completion), and a \"Mark complete\" button. Completed steps persist in progress_store and are restored on revisit. Progress count shown at top.",
   "properties": {
    "component": {
     "const": "onboarding_stepper"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Stepper heading. Default \"Get Started\"."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Active step indicator colour. Default"
    },
    "steps": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required). Array of {id, icon, label, description, action_label, action_url?} objects."
    }
   },
   "required": [
    "component",
    "steps"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Guided step-by-step onboarding flow for first-time learners. Each step has a label, description, optional action URL (navigated to on completion), and a \"Mark complete\" button. Completed steps persist",
   "x-intent-phrases": [
    "Help new users understand how to use my app with a clear path.",
    "Show people the essential features they need to know first.",
    "Guide users through setting up their profile step by step."
   ]
  },
  "case_study_card": {
   "type": "object",
   "description": "Structured enterprise case study card. Sections for situation narrative, key data points (label/value/note), numbered analysis questions, and an optional model answer reveal. No state required. The model answer is hidden behind a toggle button.",
   "properties": {
    "component": {
     "const": "case_study_card"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). Case study title."
    },
    "situation": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). The scenario narrative."
    },
    "data_points": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional). Array of {label, value, note?} metric blocks."
    },
    "questions": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional). Array of question strings for analysis."
    },
    "model_answer": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Model answer text shown on toggle. Hidden by default."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Accent colour for data point values. Default"
    }
   },
   "required": [
    "component",
    "title",
    "situation"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Structured enterprise case study card. Sections for situation narrative, key data points (label/value/note), numbered analysis questions, and an optional model answer reveal. No state required. The mo",
   "x-intent-phrases": [
    "Show me a client success story with their problem and our solution.",
    "I need to display performance metrics for a project with context.",
    "Let's present a learning challenge and its expert resolution."
   ]
  },
  "study_timer": {
   "type": "object",
   "description": "Pomodoro-style focus/break countdown timer. Configurable focus and break durations. Animated SVG progress ring. Counts completed sessions. Session-scoped only — no persistence to progress_store.",
   "properties": {
    "component": {
     "const": "study_timer"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Timer heading. Default \"Study Timer\"."
    },
    "focus_mins": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Focus period in minutes. Default 25."
    },
    "break_mins": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Break period in minutes. Default 5."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Ring and mode label colour. Default"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Pomodoro-style focus/break countdown timer. Configurable focus and break durations. Animated SVG progress ring. Counts completed sessions. Session-scoped only — no persistence to progress_store.",
   "x-intent-phrases": [
    "I need a way to visually track how long I'm focusing on a task before taking a break.",
    "My app needs a built-in timer to help users manage their work sprints and rest periods.",
    "Can I have a circular countdown that shows progress during focused work sessions?"
   ]
  },
  "rubric_card": {
   "type": "object",
   "description": "Assessment rubric table. Rows are assessment criteria, columns are performance levels (e.g. Beginning/Developing/Proficient/Exemplary). Descriptor text in each cell describes that level for that criterion. Static display — no state required.",
   "properties": {
    "component": {
     "const": "rubric_card"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Table heading. Default \"Assessment Rubric\"."
    },
    "levels": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional). Performance level column headers. Default [Beginning, Developing, Proficient, Exemplary]."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Highest-level column colour. Default"
    },
    "criteria": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required). Array of {criterion, descriptors[]} objects. descriptors[] maps to levels[] by index."
    }
   },
   "required": [
    "component",
    "criteria"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Assessment rubric table. Rows are assessment criteria, columns are performance levels (e.g. Beginning/Developing/Proficient/Exemplary). Descriptor text in each cell describes that level for that crite",
   "x-intent-phrases": [
    "I need to show how well students are doing on different skills.",
    "We need a way to grade student work against clear standards.",
    "How can I present achievement expectations for each assignment part?"
   ]
  },
  "spaced_repetition_card": {
   "type": "object",
   "description": "Single flashcard with front/back flip animation and a post-flip confidence rating (1-5 with emoji). Writes {rating, next_days, rated_at} to progress_store under \"srs:<card_id>\". Next-review hint computed via simplified SM-2 (1→1d, 2→2d, 3→4d, 4→7d, 5→14d).",
   "properties": {
    "component": {
     "const": "spaced_repetition_card"
    },
    "front": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). Front face — term or question."
    },
    "back": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). Back face — answer or definition."
    },
    "card_id": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Key for progress_store SRS data. Auto-generated if omitted."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Front card highlight colour. Default"
    }
   },
   "required": [
    "component",
    "front",
    "back"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Single flashcard with front/back flip animation and a post-flip confidence rating (1-5 with emoji). Writes {rating, next_days, rated_at} to progress_store under \"srs:<card_id>\". Next-review hint compu",
   "x-intent-phrases": [
    "I need to practice my vocabulary and see how well I remember each word after I guess.",
    "Help me review my notes for an exam, showing me the answer and letting me rate my understanding.",
    "I want to learn new facts and track how easily I recall them over time."
   ]
  },
  "leaderboard_card": {
   "type": "object",
   "description": "Ranked learner leaderboard by score. On GAS reads live from the course progress Sheet via a2uiCohortRead, extracts scores for score_key, and ranks descending. On web renders from static items[]. Top 3 entries get gold/silver/bronze medal indicators. Per-row score bar visualises relative performance.",
   "properties": {
    "component": {
     "const": "leaderboard_card"
    },
    "course_id": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). Matches progress_store course_id."
    },
    "score_key": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Which quiz score to rank on. Default \"quiz1\"."
    },
    "limit": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Max entries shown. Default 10."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Card heading. Default \"Leaderboard\"."
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional, web/static). Array of {name, score} objects for static rendering."
    }
   },
   "required": [
    "component",
    "course_id"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Ranked learner leaderboard by score. On GAS reads live from the course progress Sheet via a2uiCohortRead, extracts scores for score_key, and ranks descending. On web renders from static items[]. Top 3",
   "x-intent-phrases": [
    "Show me the top performers in this course right now.",
    "I need to see who's leading the class based on their progress.",
    "Display a quick view of the highest-scoring students."
   ]
  },
  "nav_bar": {
   "type": "object",
   "description": "Horizontal or vertical navigation bar linking to other named A2UI pages. Generates correct ?nav=<slug>&from=<current_slug> URLs at runtime using window._A2UI_NAV — no deployment URL needs to be hard-coded. Optionally sticky below the system nav header. Active page is highlighted automatically by comparing slugs.",
   "properties": {
    "component": {
     "const": "nav_bar"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Small uppercase label above the bar."
    },
    "layout": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). \"horizontal\" (default) or \"vertical\"."
    },
    "sticky": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional). Whether to stick below the system nav header. Default true."
    },
    "top_offset": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). Top offset in px when sticky. Default 52."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Active link accent colour. Default"
    },
    "links": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required). Array of {nav_slug, label, icon?, active?} objects. nav_slug is the saved page slug; the correct URL is generated at runtime."
    }
   },
   "required": [
    "component",
    "links"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Horizontal or vertical navigation bar linking to other named A2UI pages. Generates correct ?nav=<slug>&from=<current_slug> URLs at runtime using window._A2UI_NAV — no deployment URL needs to be hard-c",
   "x-intent-phrases": [
    "I need a way for users to jump between different sections of my app easily.",
    "Users need quick access to related content without losing their current place.",
    "I want to build a navigation system that dynamically links pages together."
   ]
  },
  "palette": {
   "type": "object",
   "description": "Sets page-level CSS custom properties (accent colours, block gap) for consistent theming across all atoms. Use as the first block in any payload.",
   "properties": {
    "component": {
     "const": "palette"
    },
    "accent": {
     "description": "hex colour string. Sets --a2ui-accent CSS var used by all atoms as default accent.",
     "type": "string"
    },
    "accent2": {
     "description": "hex colour string (optional). Secondary accent.",
     "type": "string"
    },
    "block_gap": {
     "description": "CSS length (default 1.25rem). Vertical gap between atom blocks.",
     "type": "string"
    },
    "text_color": {
     "description": "hex (optional). Overrides --text CSS var.",
     "type": "string"
    },
    "bg_color": {
     "description": "hex (optional). Overrides --bg CSS var.",
     "type": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "google-apps-script-side-panel",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "native", "compose": "native"},
   "x-routing-text": "Sets page-level CSS custom properties (accent colours, block gap) for consistent theming across all atoms. Use as the first block in any payload.",
   "x-intent-phrases": [
    "I need a way to make all my buttons and links use the same bright blue color, everywhere.",
    "I want all sections of my page to have a consistent, comfortable space between them.",
    "How can I easily change the primary color of my entire application to a nice green?"
   ]
  },
  "print_button": {
   "type": "object",
   "description": "A button that triggers window.print() to print or save the current page as PDF.",
   "properties": {
    "component": {
     "const": "print_button"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (default \"Print this page\")"
    },
    "align": {
     "description": "left, center, or right"
    },
    "size": {
     "description": "sm, md, or lg"
    },
    "accent": {
     "description": "hex colour for button background",
     "type": "string"
    },
    "icon": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (default true) — show printer emoji prefix"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "google-apps-script-side-panel",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A button that triggers window.print() to print or save the current page as PDF.",
   "x-intent-phrases": [
    "I need a way for my users to easily get a hard copy of their order details.",
    "Users want to download a PDF of their report for offline viewing.",
    "We need a quick option for people to print their invoice before leaving."
   ]
  },
  "drive_image": {
   "type": "object",
   "description": "Embeds a Google Drive image by file ID or share URL, converting it to the correct export URL that works inside GAS iframes.",
   "properties": {
    "component": {
     "const": "drive_image"
    },
    "url": {
     "description": "Drive share URL OR file ID"
    },
    "alt": {
     "description": "alt text for accessibility"
    },
    "caption": {
     "description": "caption text shown below image"
    },
    "rounded": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (default true) — rounded corners"
    },
    "width": {
     "description": "CSS width string (default \"max-width:100%\")",
     "type": "string"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "google-apps-script-side-panel",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Embeds a Google Drive image by file ID or share URL, converting it to the correct export URL that works inside GAS iframes.",
   "x-intent-phrases": [
    "I need to show a company logo stored on Google Drive in my app.",
    "Users must be able to upload and then see their profile pictures from Drive.",
    "I want to display product images hosted in Google Drive within my application."
   ]
  },
  "maps_embed": {
   "type": "object",
   "description": "Embeds a Google Maps location search in an iframe. Suitable for event location, office address, field ops context.",
   "properties": {
    "component": {
     "const": "maps_embed"
    },
    "q": {
     "description": "address or place name to search (required)"
    },
    "height": {
     "description": "iframe height in px (default 360)"
    },
    "zoom": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "map zoom level 1-20 (default 14)"
    },
    "caption": {
     "description": "optional caption below the map"
    }
   },
   "required": [
    "component",
    "q"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "google-apps-script-side-panel",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "Embeds a Google Maps location search in an iframe. Suitable for event location, office address, field ops context.",
   "x-intent-phrases": [
    "I need a way for users to easily find our office on a map.",
    "Show customers where our event venue is located.",
    "Let field staff see nearby job sites on a map.",
    "Show where a venue is on a map, with the street address and directions from the station.",
    "Let visitors see the location of the nearest branch and how to get there."
   ]
  },
  "sheet_form": {
   "type": "object",
   "description": "A form that submits data to a named Google Sheet tab via google.script.run. Requires the GAS project to be bound to a Spreadsheet.",
   "properties": {
    "component": {
     "const": "sheet_form"
    },
    "title": {
     "description": "optional form heading"
    },
    "sheet": {
     "description": "sheet tab name to write to (required). Created automatically if it doesn't exist."
    },
    "submit_label": {
     "description": "button label (default \"Submit\")"
    },
    "accent": {
     "description": "hex colour for submit button",
     "type": "string"
    },
    "fields": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required). Each item has label, name (optional), type (text/email/textarea/select), placeholder, required, hint, options (for select), rows (for textarea)"
    }
   },
   "required": [
    "component",
    "sheet",
    "fields"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "google-apps-script-side-panel",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A form that submits data to a named Google Sheet tab via google.script.run. Requires the GAS project to be bound to a Spreadsheet.",
   "x-intent-phrases": [
    "I need a simple way for people to submit feedback that I can see in a spreadsheet.",
    "My users need to provide details about their requests, and I want them organized in a table.",
    "This tool should let anyone enter their information directly into my data log."
   ]
  },
  "reveal": {
   "type": "object",
   "description": "Wraps child blocks with entrance animations triggered on load. animation choices: fade_up, fade_in, slide_left, slide_right, scale_in, stagger.",
   "properties": {
    "component": {
     "const": "reveal"
    },
    "animation": {
     "description": "fade_up (default), fade_in, slide_left, slide_right, scale_in, stagger"
    },
    "duration": {
     "description": "animation duration in ms (default 500)"
    },
    "delay": {
     "description": "initial delay in ms before first block animates (default 0)"
    },
    "stagger_delay": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "ms between each block when animation is stagger (default 120)"
    },
    "blocks": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of child atoms to wrap"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "google-apps-script-side-panel",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Wraps child blocks with entrance animations triggered on load. animation choices: fade_up, fade_in, slide_left, slide_right, scale_in, stagger.",
   "x-intent-phrases": [
    "I want my text to gently appear as someone scrolls down the page.",
    "Can the images on my landing page animate in one after another as the page loads?",
    "Make the buttons on my signup form pop into view when they become visible."
   ]
  },
  "skeleton": {
   "type": "object",
   "description": "CSS shimmer loading placeholder. skeleton_type choices: text, card, avatar_row, image, list, table.",
   "properties": {
    "component": {
     "const": "skeleton"
    },
    "skeleton_type": {
     "description": "text (default), card, avatar_row, image, list, table",
     "type": "string"
    },
    "rows": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number of placeholder rows (default 3)"
    },
    "cols": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number of columns for table type (default 3)"
    },
    "height": {
     "description": "height for image type (default 200px)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "google-apps-script-side-panel",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "native", "compose": "native"},
   "x-routing-text": "CSS shimmer loading placeholder. skeleton_type choices: text, card, avatar_row, image, list, table.",
   "x-intent-phrases": [
    "I need something to show while the user's profile picture and details load.",
    "Can we display a placeholder for the article content while it's being fetched?",
    "I want to show a visual cue for where the product grid will appear before it loads."
   ]
  },
  "marquee": {
   "type": "object",
   "description": "Infinite horizontal scrolling ticker. Items can be text strings, logos (image_url), or icon+label chips.",
   "properties": {
    "component": {
     "const": "marquee"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {text?, label?, icon?, image_url?, url?}"
    },
    "title": {
     "description": "optional label above the marquee strip"
    },
    "speed": {
     "description": "seconds for one full cycle (default 30)"
    },
    "gap": {
     "description": "px spacing between items (default 48)"
    },
    "direction": {
     "description": "normal (left scroll, default) or right"
    },
    "separator": {
     "description": "optional separator character between items"
    },
    "pause_on_hover": {
     "description": "pause animation on hover (default true)"
    },
    "bg": {
     "description": "background colour (default var(--surface))"
    },
    "rounded": {
     "description": "rounded corners (default true)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "google-apps-script-side-panel",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Infinite horizontal scrolling ticker. Items can be text strings, logos (image_url), or icon+label chips.",
   "x-intent-phrases": [
    "I need a way to show a lot of important announcements scrolling by so users don't miss them.",
    "Can I get a banner that cycles through our partner logos continuously?",
    "We need to display a stream of real-time stock tickers horizontally."
   ]
  },
  "pulse_dot": {
   "type": "object",
   "description": "Pulsing status or attention indicator dot. Inline or block display.",
   "properties": {
    "component": {
     "const": "pulse_dot"
    },
    "color": {
     "description": "dot colour (default"
    },
    "size": {
     "description": "sm, md (default), lg"
    },
    "label": {
     "description": "optional text beside the dot"
    },
    "speed": {
     "description": "animation cycle in seconds (default 1.8)"
    },
    "inline": {
     "description": "render inline (default true)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "google-apps-script-side-panel",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Pulsing status or attention indicator dot. Inline or block display.",
   "x-intent-phrases": [
    "I need a little blinking light to show when something is happening in real-time.",
    "Can I have a small, animated circle to grab attention for new notifications?",
    "I want a subtle visual cue to indicate an active connection."
   ]
  },
  "loading_dots": {
   "type": "object",
   "description": "Three-dot pulsing loader. Use during async content load or as a status indicator.",
   "properties": {
    "component": {
     "const": "loading_dots"
    },
    "color": {
     "description": "dot colour (default var(--a2ui-accent))"
    },
    "size": {
     "description": "sm, md (default), lg"
    },
    "label": {
     "description": "optional text beside the dots"
    },
    "align": {
     "description": "flex-start (default) or center"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "google-apps-script-side-panel",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Three-dot pulsing loader. Use during async content load or as a status indicator.",
   "x-intent-phrases": [
    "Show something's happening while the page loads.",
    "I need to let users know the data is being fetched.",
    "Make it clear that the system is processing their request."
   ]
  },
  "progress_ring": {
   "type": "object",
   "description": "Animated SVG circular progress gauge. Animates from 0 to value on load.",
   "properties": {
    "component": {
     "const": "progress_ring"
    },
    "value": {
     "description": "numeric value 0-100 (required)"
    },
    "size": {
     "description": "ring diameter in px (default 100)"
    },
    "stroke_width": {
     "description": "ring stroke thickness (default 8)"
    },
    "color": {
     "description": "ring fill colour (default var(--a2ui-accent))"
    },
    "track_color": {
     "description": "background ring colour (default var(--border))"
    },
    "label": {
     "description": "optional caption below the ring"
    },
    "show_value": {
     "description": "show numeric value inside ring (default true)"
    },
    "unit": {
     "description": "unit string (default %)"
    }
   },
   "required": [
    "component",
    "value"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "google-apps-script-side-panel",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Circular progress ring showing how much of a whole is complete, as a filled SVG arc that animates from zero to the value on load.",
   "x-intent-phrases": [
    "I need to show users how much of their profile is complete.",
    "Can I visualize the download progress of a large file?",
    "I want to display how far along a user is in a multi-step process.",
    "A small ring showing the share of a daily goal that is completed."
   ]
  },
  "confetti_burst": {
   "type": "object",
   "description": "JS confetti celebration effect. trigger load fires immediately, trigger button shows a clickable button.",
   "properties": {
    "component": {
     "const": "confetti_burst"
    },
    "trigger": {
     "description": "button (default) or load"
    },
    "label": {
     "description": "button label (default Celebrate!)"
    },
    "count": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number of confetti pieces (default 80)"
    },
    "colors": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of hex colours"
    },
    "duration": {
     "description": "total animation duration in ms (default 2000)"
    },
    "accent": {
     "description": "button colour"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "google-apps-script-side-panel",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "JS confetti celebration effect. trigger load fires immediately, trigger button shows a clickable button.",
   "x-intent-phrases": [
    "I want a celebratory animation when the user successfully completes a task.",
    "Show a fun visual when they achieve a milestone in the app.",
    "Can we have a little party effect when they sign up for the first time?"
   ]
  },
  "ripple_button": {
   "type": "object",
   "description": "CTA button with a CSS ripple click effect. Optionally links to a URL.",
   "properties": {
    "component": {
     "const": "ripple_button"
    },
    "label": {
     "description": "button text (required)"
    },
    "url": {
     "description": "optional link target"
    },
    "icon": {
     "description": "optional emoji or icon prefix"
    },
    "accent": {
     "description": "button background colour"
    },
    "size": {
     "description": "sm, md (default), lg"
    },
    "full_width": {
     "description": "stretch to container width (default false)"
    },
    "align": {
     "description": "flex-start (default), center, right"
    }
   },
   "required": [
    "component",
    "label"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "google-apps-script-side-panel",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "CTA button with a CSS ripple click effect. Optionally links to a URL.",
   "x-intent-phrases": [
    "I need a button that visually reacts when pressed to show it's working.",
    "Can I have a button that takes users to a different page when clicked?",
    "I want a button for a main action that looks modern and engaging."
   ]
  },
  "wave_divider": {
   "type": "object",
   "description": "Animated SVG wave as a decorative section separator.",
   "properties": {
    "component": {
     "const": "wave_divider"
    },
    "color": {
     "description": "wave fill colour (default var(--a2ui-accent))"
    },
    "height": {
     "description": "wave height in px (default 60)"
    },
    "speed": {
     "description": "animation cycle in seconds (default 8)"
    },
    "opacity": {
     "description": "fill opacity (default 0.15)"
    },
    "flip": {
     "description": "reverse wave direction (default false)"
    },
    "animate": {
     "description": "animate the wave (default true)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "google-apps-script-side-panel",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Animated SVG wave as a decorative section separator.",
   "x-intent-phrases": [
    "I need a smooth, flowing line to break up content visually between sections.",
    "How can I add a subtle, animated transition between different parts of my page?",
    "I want a unique, artistic element to separate my hero image from the rest of the page."
   ]
  },
  "floating_badge": {
   "type": "object",
   "description": "An emoji or icon that bobs up and down continuously. Great for CTAs and achievement moments.",
   "properties": {
    "component": {
     "const": "floating_badge"
    },
    "icon": {
     "description": "emoji or character to float (required)"
    },
    "label": {
     "description": "optional caption below"
    },
    "size": {
     "description": "sm, md (default), lg"
    },
    "speed": {
     "description": "bob cycle in seconds (default 3)"
    },
    "shadow": {
     "description": "drop shadow that deepens on rise (default true)"
    },
    "align": {
     "description": "center (default), left, right"
    }
   },
   "required": [
    "component",
    "icon"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "google-apps-script-side-panel",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "An emoji or icon that bobs up and down continuously. Great for CTAs and achievement moments.",
   "x-intent-phrases": [
    "I need something to draw attention to new messages arriving.",
    "Let's make the 'claim your reward' button feel more exciting.",
    "We want a little animated sparkle when a user completes a task."
   ]
  },
  "shimmer_text": {
   "type": "object",
   "description": "Headline text with an animated shimmer/gloss sweep across a gradient. Use for hero taglines.",
   "properties": {
    "component": {
     "const": "shimmer_text"
    },
    "text": {
     "description": "the text to render (required)"
    },
    "size": {
     "description": "font-size CSS value (default 2rem)"
    },
    "from": {
     "description": "gradient start colour (default"
    },
    "to": {
     "description": "gradient end colour (default"
    },
    "via": {
     "description": "mid shimmer colour (default"
    },
    "speed": {
     "description": "animation cycle in seconds (default 2.5)"
    },
    "weight": {
     "description": "font-weight (default 800)"
    },
    "align": {
     "description": "left (default), center, right"
    }
   },
   "required": [
    "component",
    "text"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "google-apps-script-side-panel",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Headline text with an animated shimmer/gloss sweep across a gradient. Use for hero taglines.",
   "x-intent-phrases": [
    "I need my main app title to really pop and grab attention.",
    "Make my featured product's name stand out with a cool, moving effect.",
    "I want the biggest, boldest message on the screen to feel dynamic."
   ]
  },
  "number_flip": {
   "type": "object",
   "description": "Slot-machine style digit reveal. Each digit flips in from above on load.",
   "properties": {
    "component": {
     "const": "number_flip"
    },
    "value": {
     "description": "the number or string to display (required)"
    },
    "prefix": {
     "description": "text before the number",
     "type": "string"
    },
    "suffix": {
     "description": "text after the number",
     "type": "string"
    },
    "label": {
     "description": "caption below"
    },
    "size": {
     "description": "font-size CSS value (default 3rem)"
    },
    "color": {
     "description": "digit colour (default var(--a2ui-accent))"
    },
    "duration": {
     "description": "total animation window in ms (default 1200)"
    },
    "align": {
     "description": "center (default), left"
    }
   },
   "required": [
    "component",
    "value"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "google-apps-script-side-panel",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Slot-machine style digit reveal. Each digit flips in from above on load. A phrase like 'confirm an action just succeeded' usually means inline_feedback_message or toast_notification, not this -- number_flip is a decorative animated digit reveal, not a confirmation message.",
   "x-intent-phrases": [
    "I need a way to show a large, changing count that animates in a cool way.",
    "How can I make a progress indicator feel more dynamic and engaging?",
    "I want to display a score that visually updates with a dramatic effect."
   ]
  },
  "spotlight_card": {
   "type": "object",
   "description": "A content card where a radial gradient spotlight follows the cursor. Child blocks or content field.",
   "properties": {
    "component": {
     "const": "spotlight_card"
    },
    "blocks": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of child atoms inside the card"
    },
    "content": {
     "description": "markdown string (if no blocks)",
     "type": "string"
    },
    "accent": {
     "description": "spotlight tint colour (default var(--a2ui-accent))"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "google-apps-script-side-panel",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A content card where a radial gradient spotlight follows the cursor. Child blocks or content field.",
   "x-intent-phrases": [
    "I need a way to highlight specific product features in a visually engaging way on our landing page.",
    "My team wants an interactive card for user profiles that draws attention to the main info.",
    "We're building a dashboard and need cards that feel dynamic and modern for key metrics."
   ]
  },
  "animated_border": {
   "type": "object",
   "description": "Card or section with a rotating conic gradient border. Child blocks or content inside.",
   "properties": {
    "component": {
     "const": "animated_border"
    },
    "blocks": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of child atoms inside"
    },
    "content": {
     "description": "markdown string (if no blocks)",
     "type": "string"
    },
    "from": {
     "description": "gradient start colour (default"
    },
    "to": {
     "description": "gradient end colour (default"
    },
    "via": {
     "description": "gradient mid colour (default"
    },
    "speed": {
     "description": "rotation speed in seconds (default 3)"
    },
    "padding": {
     "description": "inner padding (default 20px)"
    },
    "radius": {
     "description": "border radius (default 12px)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "google-apps-script-side-panel",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Card or section with a rotating conic gradient border. Child blocks or content inside.",
   "x-intent-phrases": [
    "I need a visually engaging highlight for premium features.",
    "My product needs a dynamic frame for featured user content.",
    "Can I get a cool, moving outline for important announcements?"
   ]
  },
  "countdown_ring": {
   "type": "object",
   "description": "Circular SVG countdown that depletes as seconds tick down.",
   "properties": {
    "component": {
     "const": "countdown_ring"
    },
    "duration_sec": {
     "description": "total countdown in seconds (required, default 60)"
    },
    "size": {
     "description": "ring diameter in px (default 80)"
    },
    "color": {
     "description": "ring colour (default var(--a2ui-accent))"
    },
    "label": {
     "description": "caption below"
    }
   },
   "required": [
    "component",
    "duration_sec"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "google-apps-script-side-panel",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Circular SVG countdown that depletes as seconds tick down.",
   "x-intent-phrases": [
    "I need a visual timer for a limited-time offer.",
    "Show users how much time is left in a quiz.",
    "Visually represent the remaining duration of a game round."
   ]
  },
  "google_icon": {
   "type": "object",
   "description": "A single Material Symbol icon from Google Fonts CDN. Browse 2500+ icon names at fonts.google.com/icons.",
   "properties": {
    "component": {
     "const": "google_icon"
    },
    "name": {
     "description": "icon ligature name (required, e.g. \"home\", \"check_circle\", \"rocket_launch\")",
     "type": "string"
    },
    "size": {
     "description": "font-size CSS value (default 24px)"
    },
    "color": {
     "description": "icon colour (default currentColor)",
     "type": "string"
    },
    "filled": {
     "description": "render the filled variant (default false — outlined)"
    },
    "weight": {
     "description": "font weight 100-700 (default 400)"
    },
    "style": {
     "description": "outlined (default) or rounded"
    },
    "label": {
     "description": "optional text beside the icon"
    },
    "inline": {
     "description": "render inline-flex (default true)"
    }
   },
   "required": [
    "component",
    "name"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-side-panel",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"},
   "x-routing-text": "A single Material Symbol icon from Google Fonts CDN. Browse 2500+ icon names at fonts.google.com/icons.",
   "x-intent-phrases": [
    "I need a small graphic to show users how to go back.",
    "We need a symbol for saving changes.",
    "Show a little house icon for the home page link."
   ]
  },
  "icon_badge": {
   "type": "object",
   "description": "Material Symbol icon inside a coloured circular badge. Good for stat rows and feature lists.",
   "properties": {
    "component": {
     "const": "icon_badge"
    },
    "name": {
     "description": "icon ligature name (required)",
     "type": "string"
    },
    "icon_size": {
     "description": "icon size in px (default 24)",
     "type": "string"
    },
    "bg": {
     "description": "badge background colour (default var(--a2ui-accent))"
    },
    "color": {
     "description": "icon colour (default",
     "type": "string"
    },
    "padding": {
     "description": "badge padding (default 12px)"
    },
    "radius": {
     "description": "badge border radius (default 50%)"
    },
    "filled": {
     "description": "filled icon variant (default false)"
    },
    "label": {
     "description": "optional caption below"
    }
   },
   "required": [
    "component",
    "name"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-side-panel",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn_with_differences", "angular": "drawn_with_differences", "copilotkit": "drawn", "a2ui-vue": "drawn_with_differences", "flutter": "native", "compose": "native"},
   "x-routing-text": "Material Symbol icon inside a coloured circular badge. Good for stat rows and feature lists.",
   "x-intent-phrases": [
    "I need to show a little warning symbol next to each item in my list.",
    "Can I add a colored circle with a checkmark to highlight completed tasks?",
    "I want to visually group related settings with a small, distinct graphic for each group."
   ]
  },
  "icon_row": {
   "type": "object",
   "description": "Horizontal strip of Material Symbol icon + label pairs. Good for feature/capability lists.",
   "properties": {
    "component": {
     "const": "icon_row"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {name or icon, label or text, color?}"
    },
    "icon_size": {
     "description": "px (default 20)"
    },
    "color": {
     "description": "default icon colour (default var(--a2ui-accent))"
    },
    "filled": {
     "description": "filled icon variant (default false)"
    },
    "style": {
     "description": "outlined (default) or rounded"
    },
    "gap": {
     "description": "gap between items (default 12px)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-side-panel",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn_with_differences", "angular": "drawn_with_differences", "copilotkit": "drawn", "a2ui-vue": "drawn_with_differences", "flutter": "native", "compose": "native"},
   "x-routing-text": "Horizontal strip of Material Symbol icon + label pairs. Good for feature/capability lists.",
   "x-intent-phrases": [
    "I need to show a list of what my app can do, with a small picture next to each item.",
    "How can I display several features clearly, each with its own little graphic and text?",
    "I want to present my service's benefits in a clean, visual way, one per line."
   ]
  },
  "workspace_logo": {
   "type": "object",
   "description": "A single Google Workspace product logo from Google's official CDN (fonts.gstatic.com). Falls back to coloured letter badge for unknown apps.",
   "properties": {
    "component": {
     "const": "workspace_logo"
    },
    "app": {
     "description": "app name (required) — gmail, drive, docs, sheets, slides, calendar, meet, forms, chat, classroom, keep, sites, vault, groups, tasks, contacts, jamboard, admin, appsheet, currents"
    },
    "size": {
     "description": "display size in px (default 48 — SVG scales to any size)"
    },
    "label": {
     "description": "caption below logo (default capitalised app name; set to empty string to hide)"
    },
    "inline": {
     "description": "render inline (default true)"
    }
   },
   "required": [
    "component",
    "app"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "google-apps-script-side-panel",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A single Google Workspace product logo from Google's official CDN (fonts.gstatic.com). Falls back to coloured letter badge for unknown apps.",
   "x-intent-phrases": [
    "I need a way to show our company's logo next to the app name.",
    "Can we display recognizable icons for our integrated services?",
    "We need a placeholder for app icons that aren't standard."
   ]
  },
  "workspace_logo_strip": {
   "type": "object",
   "description": "Horizontal strip of Google Workspace product logos. Greyscale by default, restores colour on hover.",
   "properties": {
    "component": {
     "const": "workspace_logo_strip"
    },
    "apps": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of app names (default gmail, drive, docs, sheets, slides, meet)"
    },
    "title": {
     "description": "optional label above the strip"
    },
    "size": {
     "description": "logo size in px (default 40)"
    },
    "gap": {
     "description": "gap between logos (default 24px)"
    },
    "greyscale": {
     "description": "render greyscale until hover (default true)"
    },
    "bg": {
     "description": "strip background colour (default transparent)"
    },
    "align": {
     "description": "flex-start (default), center, flex-end"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "google-apps-script-side-panel",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Horizontal strip of Google Workspace product logos. Greyscale by default, restores colour on hover.",
   "x-intent-phrases": [
    "I need a way to visually show which Google tools my app integrates with, subtly at first, then clearly when they look.",
    "How can I display a row of common Google app icons that are muted until the user interacts with them?",
    "I want to add a branded element showcasing Google product links that become vibrant when the mouse is over them."
   ]
  },
  "workspace_logo_grid": {
   "type": "object",
   "description": "Grid of Google Workspace product logos with labels. Good for \"Integrations\" or \"Works with\" sections.",
   "properties": {
    "component": {
     "const": "workspace_logo_grid"
    },
    "apps": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of app names (default all 20 known apps)"
    },
    "title": {
     "description": "optional section heading"
    },
    "size": {
     "description": "logo size in px (default 48)"
    },
    "cols": {
     "description": "grid columns (default 5)"
    },
    "greyscale": {
     "description": "render greyscale (default false)"
    },
    "show_labels": {
     "description": "show app name labels (default true)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "google-apps-script-side-panel",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Grid of Google Workspace product logos with labels. Good for \"Integrations\" or \"Works with\" sections.",
   "x-intent-phrases": [
    "Show all the apps our tool connects with.",
    "We need to display our partners' product icons.",
    "How can we showcase the services we support?"
   ]
  },
  "icon_feature_grid": {
   "type": "object",
   "description": "Feature grid using Material Symbol icons — better than emoji for Workspace UI contexts.",
   "properties": {
    "component": {
     "const": "icon_feature_grid"
    },
    "title": {
     "description": "optional section heading"
    },
    "cols": {
     "description": "grid columns (default 3)"
    },
    "icon_size": {
     "description": "icon size in px (default 28)",
     "type": "string"
    },
    "filled": {
     "description": "filled icon variant (default false)"
    },
    "accent": {
     "description": "default icon colour"
    },
    "style": {
     "description": "outlined (default) or rounded"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {icon (ligature name), title, text, color?}"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-side-panel",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Feature grid using Material Symbol icons — better than emoji for Workspace UI contexts.",
   "x-intent-phrases": [
    "I need a way to visually showcase different product benefits with clear, recognizable symbols.",
    "Help me display a list of features with distinct icons that fit a professional look.",
    "I'm looking for small graphics to represent specific actions or categories in my app's dashboard."
   ]
  },
  "icon_checklist": {
   "type": "object",
   "description": "Checklist where each item has a Material Symbol icon (not just a check mark). Good for capability or requirements lists.",
   "properties": {
    "component": {
     "const": "icon_checklist"
    },
    "title": {
     "description": "optional heading"
    },
    "default_icon": {
     "description": "fallback icon for items without one (default check_circle)"
    },
    "icon_size": {
     "description": "px (default 20)"
    },
    "filled": {
     "description": "filled icon variant (default true)"
    },
    "accent": {
     "description": "default icon colour"
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of strings or {text, icon?, sublabel?, color?}"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-side-panel",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Checklist where each item has a Material Symbol icon (not just a check mark). Good for capability or requirements lists.",
   "x-intent-phrases": [
    "Show users what features are available in our premium plan.",
    "Display the steps required to complete a complex setup process.",
    "List the benefits of signing up for our newsletter clearly."
   ]
  },
  "hub": {
   "type": "object",
   "description": "Full-screen deck navigation container: subjects as a coloured nav rail, each holding slides of atom blocks. The envelope for hub/deck payloads.",
   "properties": {
    "component": {
     "const": "hub"
    },
    "subjects": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required) of {id, label, color (hex), slides: [{id, label, blocks: [atom blocks]}]}"
    },
    "background": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, page hex, default \"#0f172a\")"
    },
    "nav_background": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, nav rail hex, defaults to background)"
    },
    "header": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (optional) — {url (required), author? (string), published? (string)}. A persistent bar pinned above the subject tabs, always on screen regardless of which subject/slide is active. Used by article_playbook (spec/article-playbook-v0.1.md, a2ui-private) to keep the source link visible outside any one lens tab; absent for callers that don't pass it."
    }
   },
   "required": [
    "component",
    "subjects"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "degraded", "compose": "native"},
   "x-routing-text": "Full-screen deck navigation container: subjects as a coloured nav rail, each holding slides of atom blocks. The envelope for hub/deck payloads. A phrase like 'switch between options within one view' usually means tab_group or segmented_control, and 'review something already completed' usually means status_timeline, not this -- hub is full-screen navigation between entirely separate subject decks.",
   "x-intent-phrases": [
    "I need a way to present a series of distinct topics, each with its own set of content screens, that users can easily switch between.",
    "We're building a training module and need a clear, visual way for users to navigate through different sections and their individual learning steps.",
    "My app has a project overview section. I need a layout that separates different project phases, with each phase containing multiple detail screens."
   ]
  },
  "jump_nav": {
   "type": "object",
   "description": "Horizontal strip of pill buttons that smooth-scroll to other blocks on the page by id.",
   "properties": {
    "component": {
     "const": "jump_nav"
    },
    "links": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required) of {label, target (block id to scroll to)}"
    }
   },
   "required": [
    "component",
    "links"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Horizontal strip of pill buttons that smooth-scroll to other blocks on the page by id. Not for switching between separate views, pages or date ranges (use pagination, tab_bar, or nav_link) - only for scrolling to a section already on this same page. A phrase like 'jump to my workout' or 'jump to the next task' is usually a simple link to a DIFFERENT place, not this: pick cta_button, link_button, or nav_link unless the destination is a section further down THIS SAME page.",
   "x-intent-phrases": [
    "I need a way for users to quickly jump between sections on a long article.",
    "My users need to easily navigate the different parts of a detailed report.",
    "Can I add buttons that let people skip to specific areas of the product page?"
   ]
  },
  "command_step": {
   "type": "object",
   "description": "Terminal-styled command with copy button and a done-checkbox. Wire done/setDone to a ValueStore to track completion (used by training runbooks for progress).",
   "properties": {
    "component": {
     "const": "command_step"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, step title above the command)"
    },
    "command": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required, the shell command; empty for manual steps)"
    },
    "hint": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, small helper line under the checkbox)"
    }
   },
   "required": [
    "component",
    "command"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Terminal-styled command with copy button and a done-checkbox. Wire done/setDone to a ValueStore to track completion (used by training runbooks for progress).",
   "x-intent-phrases": [
    "I need to see the steps my process is taking and mark them as finished.",
    "How can I show users the code they need to run and confirm it's been executed?",
    "I want a visual way to track the progress of a multi-stage setup process."
   ]
  },
  "form_textarea": {
   "type": "object",
   "description": "Multi-line text input. Wire onChange to a ValueStore setValue to capture typed content.",
   "properties": {
    "component": {
     "const": "form_textarea"
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "placeholder": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Greyed-out hint text, NOT a real value — never submitted if the reader doesn't type. Use `value` instead for a real, editable, submittable pre-fill."
    },
    "value": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Real pre-filled, editable content — rendered as actual text inside the box, submitted as-is if the reader doesn't change it. If you also declare a ValueStore for this field's onChange, keep its initialValue equal to this same string, or a reader who never touches the box will submit an empty value despite seeing real text."
    },
    "rows": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 4)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Multi-line text input. Wire onChange to a ValueStore setValue to capture typed content.",
   "x-intent-phrases": [
    "I need a place for users to write detailed feedback.",
    "Users should be able to add comments to their orders.",
    "Let people type out their full product descriptions."
   ]
  },
  "flashcard_deck": {
   "type": "object",
   "description": "Tap-to-flip study cards cycling through question/answer pairs.",
   "properties": {
    "component": {
     "const": "flashcard_deck"
    },
    "cards": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required) of {front, back}"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex, default \"#4f46e5\")"
    },
    "label_front": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, default \"QUESTION\")"
    },
    "label_back": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, default \"ANSWER\")"
    }
   },
   "required": [
    "component",
    "cards"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Tap-to-flip study cards cycling through question/answer pairs.",
   "x-intent-phrases": [
    "I need a way to present facts for memorization that only reveal the answer when I'm ready to check it.",
    "Help me build a tool for practicing new vocabulary where the word shows first, then the definition appears on demand.",
    "I want to create a quick quiz where I can see a prompt and then flip it over to see the correct response."
   ]
  },
  "brevet_timeline": {
   "type": "object",
   "description": "Vertical dated timeline of events for study/revision pages.",
   "properties": {
    "component": {
     "const": "brevet_timeline"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional)"
    },
    "events": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required) of {date, title, desc}"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex, default \"#3b82f6\")"
    }
   },
   "required": [
    "component",
    "events"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Vertical dated timeline of events for study/revision pages.",
   "x-intent-phrases": [
    "I need to show a student when they've completed key learning steps.",
    "Can I display a history of important project milestones chronologically?",
    "I want to visualize a patient's treatment progress over time."
   ]
  },
  "me": {
   "type": "object",
   "description": "Chip showing the accessing user's identity (avatar/initial, optional name).",
   "properties": {
    "component": {
     "const": "me"
    },
    "position": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, inline|top-right, default \"inline\")"
    },
    "show_name": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "bool (optional)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "Chip showing the accessing user's identity (avatar/initial, optional name).",
   "x-intent-phrases": [
    "I need to display who is currently logged in next to their actions.",
    "Show the person using the app right here, maybe with their photo.",
    "I want a small spot to remind users who they are in the system."
   ]
  },
  "theme_toggle": {
   "type": "object",
   "description": "Floating light/dark theme switch persisted per visitor.",
   "properties": {
    "component": {
     "const": "theme_toggle"
    },
    "initial": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). \"dark\" or \"light\" — which state the toggle (and its label/chrome) paints as on first load. Not itself persistence — a surface that repaints itself (e.g. via paint_result) must pass the reader's LAST choice back in here, or every repaint resets to whatever this says."
    },
    "position": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, default \"bottom-right\")"
    },
    "dark_bg": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, hex, default \"#0f172a\")"
    },
    "label_dark": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, default \"🌙\")"
    },
    "label_light": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, default \"☀️\")"
    },
    "persist_to": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). A ValueStore primitive's id — when set together with persist_action, a click ALSO calls the engine directly (bypassing the standard wire-prop system, which has no event carrying \"which theme it became\") to set this ValueStore to \"dark\"/\"light\" and run persist_action. Omit either and the toggle is purely visual, as before."
    },
    "persist_action": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). An action id to run right after persist_to is set — typically one that saves it server-side. See persist_to."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Floating light/dark theme switch persisted per visitor.",
   "x-intent-phrases": [
    "I want to let people choose if they see my site in bright or dim colors.",
    "Users should be able to pick a display mode that's easy on their eyes.",
    "My app needs a way for visitors to switch between a light and a dark look."
   ]
  },
  "tool_tile": {
   "type": "object",
   "description": "Large icon+title tile, the WHOLE tile clickable — for a small set of primary choices (an app/tool selector), not a data-dense card. Bigger visual weight than a plain button. The wired dialect has no nested-children container atom, so lay several of these out as a grid by wrapping them in row_open/row_close with style \"display:grid; grid-template-columns:repeat(N,1fr)\" (row_open's own default display:flex is overridden by a later declaration in the same style string — normal CSS cascade, not a special case this atom needs to know about).",
   "properties": {
    "component": {
     "const": "tool_tile"
    },
    "icon": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). An ICON TOKEN (not an emoji or a font ligature), shown as an inline SVG line-icon in a small circular badge — \"user\", \"book\", \"folder\" today, extend the lookup table in atoms_nav.gs as more are needed. Inline, deliberately not a web font — Material Symbols (icon_feature_grid) loads from an external CDN the MCP Apps bundle's CSP-clean-by-design principle is very likely to block. A token this atom does not recognise renders as literal text instead of nothing, so passing an emoji directly still degrades visibly rather than silently."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). The tile's title."
    },
    "count": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Shown muted, in parentheses, right after label."
    },
    "badge": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Small pill in the top-right corner, e.g. \"POC\"."
    },
    "variant": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, default \"indigo\"). \"indigo\" (bold indigo/violet gradient) or \"violet_magenta\" (violet-to-magenta gradient) — two fixed color treatments, not an arbitrary color prop, so a grid of tiles reads as one deliberate palette rather than a random assortment."
    }
   },
   "required": [
    "component",
    "label"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Large icon+title tile, the WHOLE tile clickable — for a small set of primary choices (an app/tool selector), not a data-dense card. Bigger visual weight than a plain button. The wired dialect has no n",
   "x-intent-phrases": [
    "I need a big, tappable square for users to pick their main app section.",
    "Show me large, friendly buttons for the top-level navigation options.",
    "We need clickable areas with prominent images to guide users to key features."
   ]
  },
  "lens_grid": {
   "type": "object",
   "description": "Grid of selectable cards for a config question with a small fixed set of options, each worth a short explanation — unlike a dropdown, which hides the explanation until opened. Not driven by the standard onClick wire (there is no event carrying \"which card\"); pass target (a ValueStore id) and the card's own click updates it directly, mirroring theme_toggle's persist_to pattern.",
   "properties": {
    "component": {
     "const": "lens_grid"
    },
    "target": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). A ValueStore primitive's id, set to a card's value on click."
    },
    "options": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {value, label, caption?, selected?} (required)."
    },
    "columns": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, default 2)."
    },
    "gap": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, px, default 10)."
    },
    "selected": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Current value, for which card renders highlighted on first paint — a repaint must pass the reader's last choice back in here or it resets, same rule as theme_toggle's initial."
    }
   },
   "required": [
    "component",
    "target",
    "options"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "Grid of selectable cards for a config question with a small fixed set of options, each worth a short explanation — unlike a dropdown, which hides the explanation until opened. Not driven by the standa",
   "x-intent-phrases": [
    "I need a way for users to pick one option from a few choices, showing what each means right away.",
    "Users should easily see all available settings and understand their impact before picking one.",
    "Display a list of choices clearly with their descriptions so users can make an informed selection."
   ]
  },
  "domain_picker": {
   "type": "object",
   "description": "One filled pill (\"use my saved default\") beside a free-text field, for a config question that almost always wants the same answer but sometimes needs a one-off override. The pill and the field write the SAME target ValueStore — whichever the reader touched last wins, so there is no separate \"which mode\" flag anywhere to fall out of sync.",
   "properties": {
    "component": {
     "const": "domain_picker"
    },
    "target": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). A ValueStore primitive's id."
    },
    "default_option": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object {label} (optional). The pill's label, e.g. \"From my profile\"."
    },
    "default_domains": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). What the pill resets target to."
    },
    "free_entry": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object {placeholder} (optional). Placeholder for the text field."
    }
   },
   "required": [
    "component",
    "target"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "One filled pill (\"use my saved default\") beside a free-text field, for a config question that almost always wants the same answer but sometimes needs a one-off override. The pill and the field write t",
   "x-intent-phrases": [
    "I need to set a default email address for notifications, but let me type a different one sometimes.",
    "Can I have a quick way to pick my usual server, with an option to manually enter another?",
    "I want to pre-fill a common project name, but allow users to type a unique one when needed."
   ]
  },
  "tab_group": {
   "type": "object",
   "description": "Pill tabs that switch which ONE of several sibling atoms is visible, e.g. \"how will you give me the source — a URL, a file, or pasted text\" — rather than showing every input area stacked and unlabelled at once. panels maps a tab's value to ANOTHER layout element's id and toggles that element's own wrapper directly; safe regardless of layout order, since the whole surface's markup exists before any atom's script runs. Same direct-engine pattern as lens_grid/domain_picker.",
   "properties": {
    "component": {
     "const": "tab_group"
    },
    "target": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). A ValueStore primitive's id, set to the selected tab's value on click."
    },
    "options": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of {value, label, selected?} (required)."
    },
    "panels": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object mapping a tab value to another layout element's id (required) — that element's wrapper is shown when its tab is selected, hidden otherwise."
    }
   },
   "required": [
    "component",
    "options",
    "panels"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Pill tabs that switch which ONE of several sibling atoms is visible, e.g. \"how will you give me the source — a URL, a file, or pasted text\" — rather than showing every input area stacked and unlabelle",
   "x-intent-phrases": [
    "I need a way for users to select one option from a few choices without taking up too much screen space.",
    "How can I let users pick between different methods to upload something, but only show the relevant form at a time?",
    "I want to present a single input method at a time to guide users through selecting how they'll provide information."
   ]
  },
  "quiet_link": {
   "type": "object",
   "description": "A secondary action with no button chrome — centered, small, muted, underlined text — so a screen's ONE primary action (a full-chrome button) stays visually singular. Still a real button underneath, so the standard onClick wire every other clickable atom uses works unchanged.",
   "properties": {
    "component": {
     "const": "quiet_link"
    },
    "text": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required)."
    }
   },
   "required": [
    "component",
    "text"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A secondary action with no button chrome — centered, small, muted, underlined text — so a screen's ONE primary action (a full-chrome button) stays visually singular. Still a real button underneath, so",
   "x-intent-phrases": [
    "I need a way to add a less important action that doesn't distract from the main button.",
    "How can I include an alternative choice without making it look like a primary option?",
    "I want a subtle link for a secondary task that still functions as a clickable option."
   ]
  },
  "gdm_rocket_panel": {
   "type": "object",
   "description": "Fixed-position canvas launch animation -- an isometric rocket climbing through exhaust trail and sparks to a HUD telemetry readout. Overlays one half of the viewport (position:fixed, non-interactive). Ported from the Google Meet Stage add-on's gdm-rocket-panel component (used in the \"Apps Script is now a Workspace Core Service\" playbook); graduated from stage:preview after serving as the mcp-apps page's off-catalog demo content -- the catalog's intake pipeline working as designed.",
   "properties": {
    "component": {
     "const": "gdm_rocket_panel"
    },
    "side": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, right|left, default right -- which viewport half the overlay claims)"
    },
    "layer": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, back|front, default back -- back is z-index 50, front 150, matching the original component's layer variants)"
    },
    "loop": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional, default false -- false launches once and holds at apex; true restores the original's ambient relaunch loop)"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_verified", "lit": "drawn", "angular": "drawn", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "native", "compose": "native"},
   "x-routing-text": "Fixed-position canvas launch animation -- an isometric rocket climbing through exhaust trail and sparks to a HUD telemetry readout. Overlays one half of the viewport (position:fixed, non-interactive).",
   "x-intent-phrases": [
    "I need a cool visual effect that stays on screen while users navigate.",
    "Show a rocket launch animation that doesn't block clicking on other things.",
    "Display live flight data in a persistent, eye-catching graphic."
   ]
  },
  "content_tabs": {
   "type": "object",
   "description": "Tabbed panels where each pane holds real nested atom blocks — the generic multi-section single-page container (\"several distinct views of one payload\") without needing named-page infrastructure. Unlike `tabs` (code-oriented, single content string per pane), each pane runs the shared block renderer over its own blocks array, like color_section/columns do for their children.",
   "properties": {
    "component": {
     "const": "content_tabs"
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Active-tab underline colour."
    },
    "default_index": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 0). Which tab is open on load."
    },
    "tabs": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "[{'label': 'string', 'blocks': 'array of atom blocks', 'max_width': 'string (optional, e.g. \"90%\" or \"800px\"). Caps and centres this tab\\'s own panel content, independent of any color_section a tab\\'s blocks may also use — set uniformly across tabs for a consistent inset regardless of each tab\\'s internal wrapping.'}]"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-meet-stage",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn_with_differences", "a2ui-vue": "drawn_with_differences", "flutter": "not_supported", "compose": "not_supported"},
   "x-routing-text": "Tabbed panels where each pane holds real nested atom blocks — the generic multi-section single-page container (\"several distinct views of one payload\") without needing named-page infrastructure. Unlik Not for a photo gallery or a spec/detail listing on one page (use gallery, info_card, or product_spec_table) - for splitting genuinely separate sections of content.",
   "x-intent-phrases": [
    "I need to show different details about a product on one screen without making it too long.",
    "Users should be able to switch between viewing user profiles, their posts, and their activity easily.",
    "I want to present pricing tiers and their features side-by-side for comparison."
   ]
  },
  "math_block": {
   "type": "object",
   "description": "Native MathML equation typeset with the CSS `math` generic font family (STIX / Latin Modern Math) — no JavaScript, no external library. The agent emits standard MathML; the surface draws it. Great for maths and science content — fractions, roots, integrals, matrices — rendered with correct spacing and alignment.",
   "properties": {
    "component": {
     "const": "math_block"
    },
    "mathml": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. MathML markup — inner content or a full <math> element. Active content (script, annotation-xml, on* handlers, javascript:) is stripped before the markup is rendered."
    },
    "caption": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Caption shown below the equation."
    },
    "number": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Equation number, right-aligned (e.g. \"(1)\")."
    },
    "align": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). 'center' (default) or 'left'."
    },
    "size": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Equation font-size. Default clamp(1.1rem,2.5vw,1.6rem)."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "google-meet-stage",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Native MathML equation typeset with the CSS `math` generic font family (STIX / Latin Modern Math) — no JavaScript, no external library. The agent emits standard MathML; the surface draws it. Great for",
   "x-intent-phrases": [
    "I need to display complex scientific formulas on my website that look good on any device without slowing it down.",
    "My educational app requires a way to show mathematical expressions clearly and accurately, without relying on plugins.",
    "We're building a research portal and need to render academic equations beautifully and efficiently, purely with web standards."
   ]
  },
  "service_status_board": {
   "type": "object",
   "description": "Verdict-first service status board — a lead line naming the single most important thing (all-clear, or the one active disruption), followed by a two-column grid of every tracked service with its state encoded as shape + label + color (never color alone). Designed for any status feed (Google Workspace, an internal fleet, ServiceNow) reduced to name + state.",
   "properties": {
    "component": {
     "const": "service_status_board"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, e.g., 'GOOGLE WORKSPACE — SERVICE STATUS')"
    },
    "stamp": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, e.g., '19 JUL 2026 · 17:45 CET'). Right-aligned timestamp."
    },
    "verdict": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "dict: {level: one of ok|warn|crit, text: string headline, detail: string (optional) supporting line}"
    },
    "services": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of dicts: [{name: string, state: one of operational|disruption|information|critical}, ...]"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-chat-chromium-render"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "native", "compose": "native"},
   "x-routing-text": "Verdict-first service status board — a lead line naming the single most important thing (all-clear, or the one active disruption), followed by a two-column grid of every tracked service with its state",
   "x-intent-phrases": [
    "I need to quickly see if everything is okay or if something is broken.",
    "Show me the status of all our systems in one easy-to-scan view.",
    "I want a clear summary of any current problems impacting users."
   ]
  },
  "incident_log": {
   "type": "object",
   "description": "Recent-history companion to service_status_board — a 7-cell week strip (count + severity tint per day) above a short list of incident rows (service, one-line summary, severity stripe, duration, ongoing state).",
   "properties": {
    "component": {
     "const": "incident_log"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, e.g., 'LAST 7 DAYS — INCIDENT LOG')"
    },
    "stamp": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, e.g., '13 – 19 Jul')"
    },
    "week": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of exactly 7 dicts, oldest to newest: [{label: string (e.g. \"Mon\"), count: integer, severity: one of none|low|medium}, ...]"
    },
    "incidents": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of up to 4 dicts, most recent first: [{service: string, summary: string, severity: one of low|medium|high, duration: string (e.g. \"3h 10m\"), when: string (e.g. \"Sun 19\"), ongoing: boolean}, ...]"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-chat-chromium-render"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "native", "compose": "native"},
   "x-routing-text": "Recent-history companion to service_status_board — a 7-cell week strip (count + severity tint per day) above a short list of incident rows (service, one-line summary, severity stripe, duration, ongoin",
   "x-intent-phrases": [
    "I need to see how often each service had issues this week at a glance.",
    "Show me a quick summary of the most pressing problems impacting our services right now.",
    "I want to quickly check if any services have been down for a long time recently."
   ]
  },
  "stat_pulse": {
   "type": "object",
   "description": "Three hero stat tiles (value, label, delta with tone) above a small trend bar chart with rounded tops and one emphasized \"current\" bar. A closing figure for any status or activity digest.",
   "properties": {
    "component": {
     "const": "stat_pulse"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, e.g., '30-DAY PULSE')"
    },
    "stamp": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, e.g., '20 Jun – 19 Jul')"
    },
    "stats": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of exactly 3 dicts: [{value: string, label: string, delta: string, tone: one of good|bad|flat}, ...]"
    },
    "trend": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "dict: {bars: list of numbers (max 6), labels: list of strings matching bars length, hot_index: integer index of the bar to emphasize}"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-chat-chromium-render"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "native", "compose": "native"},
   "x-routing-text": "Three hero stat tiles (value, label, delta with tone) above a small trend bar chart with rounded tops and one emphasized \"current\" bar. A closing figure for any status or activity digest.",
   "x-intent-phrases": [
    "Show me key numbers and how they're changing today, with a quick peek at the recent trend.",
    "I need a summary of performance metrics that highlights the latest update and shows recent history.",
    "Display critical data points with their direction and a mini-graph of recent activity to track progress."
   ]
  },
  "weather_now": {
   "type": "object",
   "description": "Current-conditions weather card — a hero temperature reading beside a drawn CSS weather glyph (sun/cloud/storm, not an emoji or external icon font), condition text, hi/lo, and 4 supporting stat tiles (precip, wind, UV, humidity).",
   "properties": {
    "component": {
     "const": "weather_now"
    },
    "city_line": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (e.g., 'TOULOUSE — LA VILLE ROSE'). Eyebrow line naming the location."
    },
    "stamp": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, e.g., 'Sat 19 Jul · 17:45')"
    },
    "temp": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer. The hero reading."
    },
    "condition": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. Display text in any language, e.g. 'Ensoleillé'."
    },
    "code": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string, one of sun|partly|cloud|rain|storm. Selects the drawn glyph."
    },
    "hi": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer"
    },
    "lo": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer"
    },
    "stats": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of exactly 4 dicts: [{value: string, label: string}, ...]"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-chat-chromium-render"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "native", "compose": "native"},
   "x-routing-text": "Current-conditions weather card — a hero temperature reading beside a drawn CSS weather glyph (sun/cloud/storm, not an emoji or external icon font), condition text, hi/lo, and 4 supporting stat tiles",
   "x-intent-phrases": [
    "I need to show the current temperature prominently with a matching weather illustration.",
    "Show the current weather, a quick summary, and the day's expected high and low.",
    "Display the immediate weather forecast along with four key data points."
   ]
  },
  "weather_outlook": {
   "type": "object",
   "description": "Multi-day forecast as horizontal range bars on one shared temperature axis with gridlines — lo anchored at the bar's cool end, hi at its warm end, a small drawn weather glyph per row, and a precipitation chip that highlights when precip crosses a wet threshold. The shared axis is what makes a cold/wet day visually collapse relative to its neighbours.",
   "properties": {
    "component": {
     "const": "weather_outlook"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, e.g., 'NEXT 3 DAYS — OUTLOOK')"
    },
    "city": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, e.g., 'Toulouse')"
    },
    "scale": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "dict: {min: integer, max: integer}. Shared axis bounds in the display unit; gridlines drawn at 5-degree steps."
    },
    "days": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "list of dicts, chronological: [{label: string (e.g. \"SUN\"), date: string (e.g. \"20 Jul\"), code: one of sun|partly|cloud|rain|storm, hi: integer, lo: integer, precip: integer 0-100}, ...]"
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "google-chat-chromium-render"
   ],
   "x-renderers": {"react": "not_verified", "lit": "not_verified", "angular": "not_verified", "copilotkit": "not_verified", "a2ui-vue": "not_verified", "flutter": "native", "compose": "native"},
   "x-routing-text": "Multi-day forecast as horizontal range bars on one shared temperature axis with gridlines — lo anchored at the bar's cool end, hi at its warm end, a small drawn weather glyph per row, and a precipitat",
   "x-intent-phrases": [
    "Show me the upcoming week's high and low temperatures visually, with weather icons for each day.",
    "I need to see how hot and cold it will get over the next few days at a glance.",
    "Display the rain or snow forecast alongside temperature ranges for the next 5 days."
   ]
  },
  "concept_ladder": {
   "type": "object",
   "description": "A layered-depth concept explainer — an opening hook line, a hero \"mental model\" card carrying the one-line analogy, then depth rungs down a connected rail, each rung one level deeper into the concept, terminating in a worked-example rung. Uses article_journey's palette token system (paper/ink/accent/mono-* etc. via the palette field) with the a2uicatalog brand as its default, and design tokens for type (the fonts field), so a host can match its own design system. renderers/web_article.py is the reference implementation; apps-script-surface/gas-wired-renderer/atoms_concept.gs is the port that carries it to every other surface (GAS ?p= URLs, the MCP Apps bundle and the Worker's /api/render all compile from the .gs sources), verified at parity against the reference.",
   "properties": {
    "component": {
     "const": "concept_ladder"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Main heading."
    },
    "eyebrow": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Small uppercase label above the title."
    },
    "dek": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Italic one-line subtitle under the title."
    },
    "source": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (optional) — {title, url, author?, publication?, published?, read_minutes?, label? (default \"Analysis of\"), steered_by?}. Set this whenever the ladder explains SOMEONE ELSE'S work: it renders an attribution bar ABOVE the eyebrow and headline, with the source title as a real link, so the artifact reads at first glance as a piece ABOUT that piece rather than a standalone article that could be mistaken for — or stand in for — the original. Provenance is structural here, not a phrasing convention: a derivative reading that hides its source is the copyright-and-honesty failure this field exists to make impossible. Omit for original work. `steered_by` (string or array of strings, optional) records what the reader asked this reading to look for, rendered under a READING STEERED BY rule inside the same bar — a steered reading is a different object from a neutral one, and which one you are looking at should never have to be inferred. Backtick spans render as inline code."
    },
    "hook": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). The opening grabber — rendered as a large accent-barred paragraph before the model card. Backtick spans render as inline code."
    },
    "model": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). The one-line mental-model analogy (\"think of it as...\") — rendered as a hero card labelled THE MODEL. Backtick spans render as inline code."
    },
    "model_note": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). One short elaboration line under the analogy inside the model card."
    },
    "rungs": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required). Each item is a concept_rung atom object (see that type) — also independently addressable by ComponentId when emitted in the A2UI v1.0 ChildList wire format, so a live agent can deepen or patch one level without resending the whole surface."
    },
    "closing_note": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Italic closing line under the rungs. Backtick spans render as inline code."
    },
    "theme": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). 'light' (default) or 'dark' — selects the base palette (the a2uicatalog brand, light or dark) before any per-token overrides."
    },
    "fonts": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (optional). Type tokens, one per role: body (prose), heading (title and rung titles) and label (eyebrow, chips, badges, metadata). Each is \"sans\", \"serif\" or \"mono\"; anything else keeps the default. Default {body: \"sans\", heading: \"sans\", label: \"mono\"}. Code and verbatim-quote blocks stay monospace whatever is set."
    },
    "palette": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (optional). Same token set as article_journey: paper, paper_raised, ink, ink_soft, line, accent, accent_soft, blocked, blocked_soft, cleared, cleared_soft, mono_bg, mono_fg, mono_accent — each a CSS colour string. Unset tokens keep the theme default."
    },
    "use_plex_fonts": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional, default true). Loads IBM Plex Mono and IBM Plex Serif via same-origin @font-face when a fonts role uses serif or mono — see THIRD-PARTY-NOTICES.md. Set false for system font stacks only."
    }
   },
   "required": [
    "component",
    "rungs"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A layered-depth concept explainer — an opening hook line, a hero \"mental model\" card carrying the one-line analogy, then depth rungs down a connected rail, each rung one level deeper into the concept,",
   "x-intent-phrases": [
    "I need a way to explain complex ideas simply, starting broad and getting more detailed.",
    "Show users the core idea visually first, then let them explore deeper explanations.",
    "How can I guide users through a topic, revealing information step-by-step?"
   ]
  },
  "concept_rung": {
   "type": "object",
   "description": "One depth level of a concept_ladder — a kind chip (DEPTH N or WORKED EXAMPLE), title, body copy, an optional terminal-styled code block with caption, and an optional terminal-styled takeaway line. Reads its colour tokens from the CSS custom properties an enclosing concept_ladder sets; renders with sane fallback colours standalone. Rarely authored outside concept_ladder.rungs, but is its own atom type so it can be independently addressed by ComponentId in the A2UI v1.0 ChildList wire format.",
   "properties": {
    "component": {
     "const": "concept_rung"
    },
    "badge": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Rail-node label, e.g. the depth number or \"EX\". Defaults to 1-based position when rendered inside concept_ladder."
    },
    "kind": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). 'depth' (default) or 'example' — example rungs get the mono/terminal chip and node styling."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Chip text override; defaults to \"DEPTH <badge>\" or \"WORKED EXAMPLE\" by kind."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Rung heading. Backtick spans render as inline code."
    },
    "body": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Rung body copy — blank-line-separated paragraphs render as separate <p>s. Backtick spans render as inline code."
    },
    "code": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Verbatim code block, terminal-styled (escaped, never interpreted)."
    },
    "code_caption": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Italic caption line under the code block."
    },
    "takeaway": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Terminal-styled takeaway / pull-quote line."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "One depth level of a concept_ladder — a kind chip (DEPTH N or WORKED EXAMPLE), title, body copy, an optional terminal-styled code block with caption, and an optional terminal-styled takeaway line. Rea",
   "x-intent-phrases": [
    "I need to show a quick tip for a feature with an explanation and maybe a code snippet.",
    "Can I display a single step in a tutorial, with a title, description, and a helpful hint?",
    "I want a way to present a concept with its details and an example, plus a concluding thought."
   ]
  },
  "layer_stack": {
   "type": "object",
   "description": "Declarative labelled layers for a layered architecture — a protocol stack, a request path, any \"what lives at which level\" picture. Each layer is a band carrying a mono technical fact (`field`) beside a plain-language gloss (`note`) — primitive_plate's labelling pairing, without its image substrate: a primitive_plate pin annotates a REAL capture and must never annotate a hand-drawn illustration, and an abstract stack has no capture to pin. Two things concept_ladder cannot do: declare `columns` and each layer renders its `cells` side by side, so ONE stack carries a per-layer comparison of two systems; and set a layer or cell to `status: absent` and it renders a visibly hollow, dashed band, so a level a system does NOT define reads as a stated absence rather than an omission from the diagram. Shares article_journey / concept_ladder's palette token system and IBM Plex fonts so the explainer atoms read as one design system. renderers/web_article.py is the reference implementation; apps-script-surface/gas-wired-renderer/atoms_layers.gs is the port that carries it to every other surface (GAS ?p= URLs, the MCP Apps bundle and the Worker's /api/render all compile from the .gs sources).",
   "properties": {
    "component": {
     "const": "layer_stack"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Main heading."
    },
    "eyebrow": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Small uppercase label above the title."
    },
    "dek": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Italic one-line subtitle under the title."
    },
    "caption": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). One prose line under the header, before the stack. Backtick spans render as inline code."
    },
    "source": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (optional) — same attribution bar as concept_ladder {title, url, author?, publication?, published?, read_minutes?, label?, steered_by?}. Set it whenever the stack describes SOMEONE ELSE'S system, so the artifact reads as a piece ABOUT that system rather than one that could stand in for its documentation."
    },
    "order": {
     "description": "string (optional). 'bottom_up' (default) or 'top_down'. Which end of the picture the FIRST declared layer lands at. bottom_up puts it at the bottom — the wire/transport end — so the array reads the way a stack is spoken aloud, from the bottom up. Badge numbering always follows the declared order, not the visual one.",
     "type": "string"
    },
    "base_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Axis caption printed under the stack, e.g. \"bytes on the wire\"."
    },
    "top_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Axis caption printed above the stack, e.g. \"meaning\"."
    },
    "columns": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional). Each item {label, accent?} — a column header. When present, every layer's `cells` render side by side beneath these headers, which is how one stack carries a per-layer comparison of two systems. Omit (or give one column) for a plain single stack. `accent` is a CSS colour string for that column's header and rule. Each label ALSO repeats quietly inside every cell of its column: the header row is a long way up by the time you reach the bottom band, colour cannot carry column identity because the cell fill already encodes `status`, and a band stays self-describing when rendered alone by ComponentId. The repeat is suppressed on a band that spans all columns, and on single-column stacks."
    },
    "layers": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required). Each item is a stack_layer atom object (see that type) — also independently addressable by ComponentId when emitted in the A2UI v1.0 ChildList wire format, so a live agent can patch one layer without resending the whole surface."
    },
    "theme": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). 'light' (default) or 'dark' — selects the base palette before any per-token overrides."
    },
    "palette": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (optional). Same token set as article_journey and concept_ladder: paper, paper_raised, ink, ink_soft, line, accent, accent_soft, blocked, blocked_soft, cleared, cleared_soft, mono_bg, mono_fg, mono_accent — each a CSS colour string. Unset tokens keep the theme default. `status` maps onto these: present -> cleared, absent -> blocked, partial -> accent."
    },
    "use_plex_fonts": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional, default true). Loads IBM Plex Mono and IBM Plex Serif via same-origin @font-face — see THIRD-PARTY-NOTICES.md. Set false for system font stacks only."
    }
   },
   "required": [
    "component",
    "layers"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Declarative labelled layers for a layered architecture — a protocol stack, a request path, any \"what lives at which level\" picture. Each layer is a band carrying a mono technical fact (`field`) beside",
   "x-intent-phrases": [
    "Show me the sequence of steps our data processing pipeline takes.",
    "I need to visualize how requests flow through our different services.",
    "Help me understand the different security checks applied at each stage of a transaction."
   ]
  },
  "stack_layer": {
   "type": "object",
   "description": "One band of a layer_stack — a badge, the layer name, and either a single field/note pane or one pane per column via `cells`. Reads its colour tokens from the CSS custom properties an enclosing layer_stack sets and renders with sane fallback colours standalone. Rarely authored outside layer_stack.layers, but is its own atom type so it can be independently addressed by ComponentId in the A2UI v1.0 ChildList wire format.",
   "properties": {
    "component": {
     "const": "stack_layer"
    },
    "name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). The layer name, e.g. \"Transport\"."
    },
    "badge": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Small label above the name — defaults to the 1-based position in layer_stack.layers as declared."
    },
    "field": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). The technical/schema fact, rendered monospace. Used when the layer has no `cells`."
    },
    "note": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). The plain-language gloss. Used when the layer has no `cells`. Backtick spans render as inline code."
    },
    "examples": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of strings (optional). Concrete instances at this layer, rendered as a wrapping chip row across the foot of the band, e.g. \"stdio\", \"Streamable HTTP\"."
    },
    "status": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). 'present' (default), 'absent' or 'partial'. absent renders the pane hollow with a dashed border — the point is that a layer a system does not define stays VISIBLE and reads as a stated absence. Maps onto the palette's cleared / blocked / accent tokens."
    },
    "cells": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional). One entry per layer_stack column, index-aligned with it. Each item {field?, note?, status?} — the same three fields, per column. Given cells, the layer's own field/note/status are ignored."
    }
   },
   "required": [
    "component",
    "name"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "One band of a layer_stack — a badge, the layer name, and either a single field/note pane or one pane per column via `cells`. Reads its colour tokens from the CSS custom properties an enclosing layer_s",
   "x-intent-phrases": [
    "I need a clear way to show the different categories of items on my screen, each with a distinct color.",
    "My users need to see the name of each data section alongside its important identifier.",
    "I want to display detailed information for each section, either in one block or spread across columns."
   ]
  },
  "tool_call_card": {
   "type": "object",
   "description": "A structured card displaying an AI agent tool invocation — in-flight, completed, or failed. Shows the tool name, execution status badge (running, success, error, pending), elapsed latency, formatted input arguments, and returned result or error message. Essential for agentic run narration, live tool traces, and human inspection of autonomous actions.",
   "properties": {
    "component": {
     "const": "tool_call_card"
    },
    "tool_name": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required). The name of the invoked tool, e.g. \"search_database\" or \"execute_code\"."
    },
    "status": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, default \"running\"). Status of the tool execution (\"running\", \"success\", \"error\", or \"pending\")."
    },
    "args": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). The input arguments passed to the tool, formatted as JSON string or key-value summary."
    },
    "result": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). The output data or response returned by the tool."
    },
    "latency_ms": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Execution duration in milliseconds."
    },
    "error": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Error details or exception message if status is \"error\"."
    }
   },
   "required": [
    "component",
    "tool_name"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "A structured card displaying an AI agent tool invocation — in-flight, completed, or failed. Shows the tool name, execution status badge (running, success, error, pending), elapsed latency, formatted i",
   "x-intent-phrases": [
    "I need to show users when their AI assistant is actively searching for information.",
    "How can I visually confirm if the AI's request to an external service worked correctly?",
    "I want to clearly display when an AI action couldn't be completed and why."
   ]
  },
  "scene_stage": {
   "type": "object",
   "description": "An animated, looping pan/zoom SVG scene composed from a provenance-verified prop kit (original MIT artwork, each asset pinned by sha256 and restricted to an allowlist of SVG elements). Give a preset and the layout, backdrop, props and motion come from it; or write the layout in full. Props are referenced by id and never as SVG, so the agent cannot introduce script or external references. For a one-off shape use agent_sketchpad; for a diagram use a chart or d2 atom.",
   "properties": {
    "component": {
     "const": "scene_stage"
    },
    "preset": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). A ready-made place; supplies backdrop, ground, stage, camera, scenery and actors. PREFER a preset when one fits (it is a tested layout), and extend it with scenery_add / actors_add instead of rewriting it. One of: airfield, arctic-station, bedroom, boardroom-meeting, bus-stop, cafe, call-centre, ci-cd-factory, city-skyline, construction-site, container-port, corner-shop, data-centre, desert-oasis, drone-delivery, factory-assembly-line, farm-harvest, fire-station-response, forest-campfire, highway-interchange, home-kitchen, hospital-helipad, hospital-ward, hydro-dam, kanban-war-room, keynote-stage, laboratory-bench, library-archive, lighthouse-coast, living-room, message-post-office, metro-station, mine-quarry, mission-control, museum-gallery, observatory-night, offshore-platform, open-office, railway-station, restaurant-kitchen, river-ferry, school-classroom, school-yard, ski-resort, solar-farm, space-station-orbit, street-market, substation-grid, trading-floor, vertical-farm, warehouse-logistics, water-treatment, wind-farm."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 80 chars). Accessible name and caption. Default is the preset id."
    },
    "seed": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, 0..4294967295). Varies cloud and star placement. Default derives from the preset."
    },
    "theme": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{time: \"dawn\"|\"day\"|\"dusk\"|\"night\", weather: \"clear\"|\"cloudy\"|\"overcast\", setting: \"countryside\"|\"coast\"} (optional). Default day, clear, countryside. time: dawn = early morning, day = midday and afternoon, dusk = evening, night. Interiors dim with the time of day."
    },
    "motion": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{duration: number 6..40} (optional, seconds per loop). Default 20."
    },
    "camera": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{mode: \"static\"|\"pan\"|\"push-in\"} (optional). The preset has a default; without a preset the default is static."
    },
    "accent": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, #rrggbb). Tints props that take an accent colour."
    },
    "backdrop": {
     "description": "\"sky-city\"|\"sky-hills\"|\"sky-sea\"|\"sky-mountains\"|\"sky-desert\"|\"sky-arctic\"|\"sky-flat\"|\"space\"|\"interior-office\"|\"interior-industrial\"|\"interior-lab\"|\"interior-civic\"|\"interior-home\"|\"interior-dark\" (required when there is no preset)."
    },
    "ground": {
     "description": "\"grass\"|\"road\"|\"sand\"|\"snow\"|\"concrete\"|\"wood\"|\"water\"|\"none\" (required when there is no preset)."
    },
    "stage": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "{width: 600..4000, zoom: 500..3200, focus_y: -800..200} (required when there is no preset). Scene units: x runs left to right from 0 to stage.width; the ground line is y=0, up is negative and positive y is toward the viewer."
    },
    "scenery": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional, default empty; max 80) of {prop, x, y?, scale? 0.2..5, flip?, variant?, anim?}, or of {sketch, x, y?, scale?, flip?, anim?} when no prop fits, or of {label, x, y?, scale?, size?, colour?, align?, bold?} for real text (see LABEL below). THE ESCAPE HATCH: give `sketch` instead of `prop`, an array of 1..40 SVG element strings (one element per string, origin at the ground point, up negative), e.g. [\"<rect x=\\\"-30\\\" y=\\\"-24\\\" width=\\\"60\\\" height=\\\"24\\\" fill=\\\"#a9784a\\\"/>\"]. Same rules as agent_sketchpad: tags rect, circle, ellipse, line, polyline, polygon, path, g; attributes cx, cy, r, rx, ry, x, y, width, height, x1, y1, x2, y2, points, d, fill, stroke, stroke-width, opacity, fill-opacity, stroke-opacity, stroke-linecap, stroke-linejoin, transform; values only letters, digits and # . , - ( ) %; no text, style or id; at most 8 sketches per scene; an invalid element refuses the scene with an error. Prefer a listed prop when one fits. A hand-written animate or animateTransform is NEVER its own sketch array entry (it has nothing to animate alone): nest it as a CHILD inside the same <g> as the shape(s) it moves, in the SAME string, e.g. '<g><animateTransform attributeName=\"transform\" type=\"translate\" values=\"0 0;0 -20;0 0\" dur=\"1s\" repeatCount=\"indefinite\"/><circle cx=\"0\" cy=\"0\" r=\"10\" fill=\"@red\"/></g>'; see the bouncing-ball example under conventions.sketch_style in the asset index for a full squash-and-stretch built this way. REUSE: a sketch element may instead be '<use href=\"#a-<id>\"/>' (or '--<variant>'), href ONLY, to place and hand-animate a REAL, already-verified kit prop -- only ids/variants that really exist are accepted; see the \"hand-choreographed\" example under conventions.sketch_style. LABEL: give `label` (a plain string, 1..4 lines split on '\\n', 1..40 characters each, 160 total) instead of `prop`/`sketch` for REAL text, drawn by trusted code, never agent-authored markup, so it needs no allowlist at all. `size` 8..80 (default 26), `colour` #rrggbb or @name (default @dark), `align` start|middle|end (default middle), `bold` true/false; y is the text's own baseline (multiple lines stack upward). A label may also carry `anim` (see ANIMATION below) to blink/bob/etc, same generated SMIL as a prop or sketch, never hand-authored markup. See conventions.labels in the asset index for worked examples. HOUSE STYLE: dark rounded outlines are applied for you; colour with palette names written @name (dark, light, livery, glass, wood, brown, cream, skin, red, yellow ... listed with worked examples under conventions.sketch_style in the asset index) so the sketch matches the props and follows day and night; props are 40 to 150 units wide, so draw at that size. ANIMATION: give the item anim {kind: sway|bob|spin|pulse|blink|drift, period 0.3..30, amount, cx, cy} for a quick idle motion with no hand-authored SVG at all -- this works on a plain prop or label item directly, not only a sketch -- or put animateTransform / animate (numbers only; targets transform, opacity, stroke-width, cx, cy, r and similar, never href or fill; at most 12 per element) inside a group to move a part. Props by id from the asset index (https://a2uicatalog.ai/catalogue/assets-index-v1.json); the strict JSON Schema of this block is https://a2uicatalog.ai/catalogue/scene-spec.schema.json. A ground prop needs no y (it stands on y=0); wall items need a negative y and interior ceiling lights use y=-620. Each prop's mount, scale, moves and size are in the asset index (\"conventions\" explains x, y and lanes)."
    },
    "actors": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional, default empty; max 30) of {prop, motion: \"walk\"|\"ride\"|\"drive\"|\"fly\"|\"hover\"|\"orbit\"|\"takeoff\"|\"land\", x0, x1, y, period 3..120, phase 0..1, scale?, variant?, ry?, anim?, size?, colour?, align?, bold?}. Movers that loop; y is a lane, 40..120 passes in front of props standing on the ground. takeoff rolls a plane along the ground, rotates and climbs away (ry = climb height, default 260); land descends, flares and rolls out. anim (see scenery's ANIMATION docs) layers an idle motion on top of the actor's own engine motion. A sketch (see scenery's field docs, including REUSE) or a label (see scenery's field docs) can be an actor too, moving on the same motion, instead of prop. A prop's suitable motions are its \"moves\" in the asset index."
    },
    "scenery_add": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional, max 80 in total with the preset) of the same items as scenery. Appended to the preset's scenery instead of replacing it, e.g. add a cow and a chicken to farm-harvest."
    },
    "actors_add": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional, max 30 in total with the preset) of the same items as actors. Appended to the preset's actors instead of replacing them."
    }
   },
   "required": [
    "component",
    "backdrop",
    "ground",
    "stage"
   ],
   "x-surfaces": [
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "An animated, looping pan/zoom SVG scene composed from a provenance-verified prop kit (original MIT artwork, each asset pinned by sha256 and restricted to an allowlist of SVG elements). Give a preset a",
   "x-intent-phrases": [
    "I need a visually engaging map that smoothly moves and zooms on its own, showing off my data points.",
    "My app requires a dynamic, animated background that cycles through different views of a secure, curated graphic.",
    "Showcase my product's features with an animated presentation that smoothly transitions between different product perspectives."
   ]
  },
  "clipart": {
   "type": "object",
   "description": "One piece of verified vector clipart from the scene kit, by id, drawn at its own size with an optional variant (for example a person in a hard hat), scale and flip. Themeable colours, original MIT artwork, no external references. Use it as an illustration inside an article, card or slide; use scene_stage when several props should be composed into a moving picture.",
   "properties": {
    "component": {
     "const": "clipart"
    },
    "asset": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string. A prop id from the asset index (https://a2uicatalog.ai/catalogue/assets-index-v1.json); every prop in the kit is listed. Ask for any of them: the server attaches what the view needs."
    },
    "variant": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). A variant of that prop, for example scrubs, hard-hat or doctor on person-standing."
    },
    "scale": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, 0.2..5). Default 1."
    },
    "flip": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional). Mirror horizontally."
    },
    "time": {
     "description": "\"dawn\"|\"day\"|\"dusk\"|\"night\" (optional). Palette the artwork is drawn in. Default day."
    },
    "label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Caption under the image."
    },
    "alt": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional). Accessible name. Default is the prop name."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "One piece of verified vector clipart from the scene kit, by id, drawn at its own size with an optional variant (for example a person in a hard hat), scale and flip. Themeable colours, original MIT art",
   "x-intent-phrases": [
    "I need a professional-looking icon for a 'safety first' feature.",
    "Show me a simple graphic of a construction worker for our team page.",
    "We need a standardized graphic for our project management tool."
   ]
  },
  "treemap": {
   "type": "object",
   "description": "Part-to-whole as nested rectangles whose areas show share of the total, laid out by the squarified treemap algorithm (d3-hierarchy treemapSquarify). By default up to four categories: each category is one block and its items are rectangles inside it, with the category name and total in a pill. With an optional per-item path (1 to 3 group names, top down) the chart nests by that path instead, up to three levels of group boxes with a header showing the group name and total, so a folder tree or a cost breakdown reads like a disk-usage map. Each rectangle carries its name and value where the drawn width and height can hold them; in a narrower container or a thin cell the label is hidden (the hover title and the hidden table keep it). A hidden table gives item, category (or path), value and share. Motion-ready: every moving value reads --p (build progress 0 to 1, default 1) through a per-item --k, so a motion_timeline track on p builds it item by item and the standalone render is the finished picture; reduced motion shows the end state.",
   "properties": {
    "component": {
     "const": "treemap"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 80)."
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required, 4 to 12) of {category (max 20), name (max 24), value (number above 0), path? (array of 1 to 3 strings, max 20 each, the item's ancestor groups from the top down)}. Without any path at most four categories are drawn; items with a value of 0 or less are dropped. When any item has a usable path the chart nests by path and category is ignored for items that have one; an item without a path goes into a group named by its category, or Other. The item cap is 12 unless max_items is given."
    },
    "max_items": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, 12 to 60, default 12). Lifts the item cap; items beyond it are not drawn and a note says how many. Any other value keeps 12."
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1). The treemap contract the payload was written for. Only version 1 exists; a higher whole number is drawn as version 1 with a note."
    }
   },
   "required": [
    "component",
    "items"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "drawn", "lit": "drawn", "angular": "drawn", "copilotkit": "drawn", "a2ui-vue": "drawn", "flutter": "native", "compose": "native"},
   "x-routing-text": "Rectangles sized by value, grouped into up to four categories, or nested up to three levels deep by a path per item (a folder tree, a spend breakdown). Good for a quick sense of share; exact numbers are in a table. Not for precise comparison, and not for more than 12 items.",
   "x-intent-phrases": [
    "Show where cloud spend goes by category.",
    "I need a treemap of storage by team.",
    "Visualise the share of each item within its group.",
    "Show what is using my disk space, folder by folder."
   ]
  },
  "histogram": {
   "type": "object",
   "description": "The distribution of a list of numbers: bars of counts per bin on a counted y axis, with the bin edges on the x axis. The bins and the rounded axis come from d3-array bin() with the Sturges rule, computed on the server, so there is no script. A hidden table gives each bin from, to and count. Motion-ready: every moving value reads --p (build progress 0 to 1, default 1) through a per-item --k, so a motion_timeline track on p grows the bars one after another and the standalone render is the finished picture; reduced motion shows the end state.",
   "properties": {
    "component": {
     "const": "histogram"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 80)."
    },
    "values": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required, 5 to 2000) of numbers. Entries that are not finite numbers (text, null, true or false, NaN, Infinity) or whose size is above 1e12 are skipped and counted in a note; with fewer than 5 numbers left a note replaces the chart. Only the first 2000 entries are read."
    },
    "bins": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, 3 to 40). The number of bins to aim for. Default is the Sturges rule, ceil(log2(n)) + 1. d3 rounds the bin edges to 1, 2 or 5 times a power of ten, so the number drawn can differ a little from the number asked for."
    },
    "x_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 40). Names the values on the x axis."
    },
    "unit": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 12). Appended to the x label and to the edge values in the hidden table."
    },
    "bin_size": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, above 0). Explicit bins of this width instead of the Sturges rule; at most 200 bins are drawn, with a note. The last bin ends at bin_end, so it can be narrower than the rest. Draws one series (no overlay or stack as in Plotly). Bins are start + k * size, include their lower edge and exclude the upper, except the last. Values outside the bins are not counted and a note says how many. Not understood values are ignored with a note."
    },
    "bin_start": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). The first bin edge; default the smallest value rounded down to a multiple of the bin size."
    },
    "bin_end": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, above bin_start). The last bin edge; default one bin past the largest value."
    },
    "norm": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, \"percent\", \"probability\", \"density\" or \"probability density\"). Normalises count or sum. Percent and probability of the total, density per unit of width, probability density per unit of width of the total. Default counts."
    },
    "cumulative": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional, default false). Only true switches it on; draws the running total over the bins (count or sum only)."
    },
    "func": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, \"count\", \"sum\", \"avg\", \"min\" or \"max\", default \"count\"). What a bin shows; all but count need `weights` (without them it counts, with a note). An empty bin shows nothing for avg, min and max."
    },
    "weights": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional, same order as values) of numbers, one per value; a value or weight that is not a finite number skips the pair."
    },
    "layout": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, \"bars\" or \"ridge\", default \"bars\"). \"ridge\" draws one ridge per entry of `series` on shared bins, to compare distributions; `values` is then not read. Any other value draws bars."
    },
    "series": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional, read only when layout is \"ridge\", 1 to 8) of {label (string, max 30, default \"Series n\"), values (array, 5 to 2000, of numbers, filtered like `values`)}. The shared bins come from d3 bin() of all the series pooled (`bins` applies); each ridge's height is its share of that series' values per bin, so series of different sizes compare. A series with fewer than 5 usable numbers is left out with a note; series beyond the first 8 are noted and not drawn."
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1). The histogram contract the payload was written for. Only version 1 exists; a higher whole number is drawn as version 1 with a note."
    }
   },
   "required": [
    "component",
    "values"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_measured", "lit": "not_measured", "angular": "not_measured", "copilotkit": "not_measured", "a2ui-vue": "not_measured", "flutter": "native", "compose": "native"},
   "x-routing-text": "Shows how a list of raw numbers is spread out, such as response times, order values or scores. Give the numbers, not the counts; the bins are computed. Not for comparing categories (use a bar chart) or for showing a trend over time.",
   "x-intent-phrases": [
    "Show the distribution of these response times.",
    "I need a histogram of order values.",
    "How are these exam scores spread out?",
    "Compare the distributions of wait times before, during and after the change."
   ]
  },
  "box_plot": {
   "type": "object",
   "description": "Compares groups of numbers as box plots on one shared horizontal axis: per group a box from the lower to the upper quartile, a line at the median, whiskers to the furthest numbers within 1.5 times the box length, and dots for the outliers beyond. The quartiles come from d3-array quantileSorted and the axis from d3 nice() and ticks(), computed on the server, so there is no script. A hidden table gives each group's count, minimum, quartiles, median, maximum and outlier count. Motion-ready: each group fades in through --k from --p (build progress 0 to 1, default 1); the standalone render is the finished picture and reduced motion shows the end state.",
   "properties": {
    "component": {
     "const": "box_plot"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 80)."
    },
    "groups": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required, 1 to 12) of {label (string, max 30, default \"Group n\"), values (array, 5 to 2000, of numbers), stats? (object {q1, median, q3, lo?, hi?, min?, max?, mean?, n?}, a precomputed summary drawn instead of values; q1 <= median <= q3)}. Entries that are not finite numbers or whose size is above 1e12 are skipped and counted in a note; a group with fewer than 5 usable numbers, or an entry that is not a group, is left out with a note. Groups beyond the first 12 are noted and not drawn."
    },
    "x_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 40). Names the values on the axis."
    },
    "unit": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 12). Appended to the axis caption and to every value in the label and hidden table."
    },
    "quartile_method": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, \"linear\", \"exclusive\" or \"inclusive\", default \"linear\" = R-7). Exclusive and inclusive take the median of the lower and upper half (an odd sample's middle value left out, or kept in both). Any option below switches to a static box plot without show_points dots; a note says so if show_points is also given."
    },
    "show_mean": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional, default false). Only true marks each group's mean with a diamond and adds a Mean column to the table. The mean only; Plotly's boxmean \"sd\" (mean plus standard deviation) is not drawn."
    },
    "orientation": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, \"h\" or \"v\", default \"h\"). \"v\" draws vertical boxes on a vertical axis; in a narrow container the group names are replaced by numbers with a key underneath."
    },
    "notches": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional, default false). Only true draws the median notch, median +/- 1.57 * IQR / sqrt(n), cut at the quartiles. The notch interval is also listed in the table (Notch from, Notch to). (with a note); needs n (the values, or stats.n)."
    },
    "shape": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, \"box\" or \"violin\", default \"box\"). \"violin\" draws a Gaussian kernel density outline (every violin scaled to the same width) with a narrow box inside; it needs values, not stats."
    },
    "bandwidth": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, above 0). The violin kernel bandwidth; default 0.9 * min(sd, IQR / 1.34) * n^-0.2. This is a Silverman-style rule, not the one Plotly uses, so a violin differs slightly from Plotly's. A bandwidth below 1e-6 of the data range is raised to that, with a note."
    },
    "show_points": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional, default false). Only true switches it on. Draws every usable number of each group as a small dot along its row, at exactly its place on the axis, stacked vertically only as far as needed so no two dots touch (a deterministic dodge beeswarm, no script), behind the box, whiskers and median. Rows are taller. At most 300 dots per chart, shared across the groups in proportion to their sizes and evenly spaced through each group's sorted numbers; a note says so, and the table counts them all. A dot that cannot be placed without touching another stays on the edge of its row; a note counts these."
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1). The box_plot contract the payload was written for. Only version 1 exists; a higher whole number is drawn as version 1 with a note."
    }
   },
   "required": [
    "component",
    "groups"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_measured", "lit": "not_measured", "angular": "not_measured", "copilotkit": "not_measured", "a2ui-vue": "not_measured", "flutter": "native", "compose": "native"},
   "x-routing-text": "Compares how several groups of raw numbers are spread out, such as response times per region, scores per class or prices per supplier, showing medians, the middle half and outliers side by side. Give the numbers, not the summary statistics. For one distribution's shape use a histogram; for totals per category use a bar chart.",
   "x-intent-phrases": [
    "Compare response times across regions with a box plot.",
    "Show the spread of scores for each class.",
    "Which supplier's prices vary the most?"
   ]
  },
  "waterfall": {
   "type": "object",
   "description": "A running total built step by step, as horizontal bars on one shared axis: each change runs from where the previous step ended (green up, red down) and a total runs from 0 to the running total; dashed connectors join the steps and the signed change is printed at the end of each row, so the direction never rests on colour alone. The axis comes from d3 nice() and ticks(), computed on the server, so there is no script. A hidden table gives each change and the running total. Motion-ready: each step fades in through --k from --p (build progress 0 to 1, default 1); the standalone render is the finished picture and reduced motion shows the end state.",
   "properties": {
    "component": {
     "const": "waterfall"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 80)."
    },
    "steps": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required, 1 to 24) of {label (string, max 30, default \"Step n\"), value (number), kind (optional, \"total\" or \"delta\", default \"delta\")}. A delta step needs a finite value up to 1e12 in size; a total step without a value shows the running total, and with a value sets the running total to it (a note says when that differs from the steps before it). Other entries are left out with a note; steps beyond the first 24 are noted and not drawn. Any kind other than \"total\" is a delta."
    },
    "x_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 40). Names the values on the axis."
    },
    "unit": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 12). Appended to the axis caption, the label and every value in the hidden table."
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1). The waterfall contract the payload was written for. Only version 1 exists; a higher whole number is drawn as version 1 with a note."
    }
   },
   "required": [
    "component",
    "steps"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_measured", "lit": "not_measured", "angular": "not_measured", "copilotkit": "not_measured", "a2ui-vue": "not_measured", "flutter": "native", "compose": "native"},
   "x-routing-text": "Shows how a starting amount is moved up and down by a sequence of changes to an end amount, such as a revenue or budget bridge, a headcount change or a cash flow. Give each change as a signed number and mark totals. For parts of one whole use a treemap or donut; for one value per category use a bar chart.",
   "x-intent-phrases": [
    "Build a revenue bridge from last year to this year.",
    "Show what drove the budget from plan to actual as a waterfall.",
    "How did headcount change through hires and leavers?"
   ]
  },
  "sunburst": {
   "type": "object",
   "description": "Part-to-whole as nested rings: each item is an arc whose angle shows its share of the total, the top-level groups sit in the innermost ring and each level of the optional per-item path (1 to 3 group names, top down) is one ring further out, so a budget, a disk-usage breakdown or a folder tree reads from the inside out. Laid out by d3-hierarchy partition() and drawn with d3-shape arc() paths on the server, so there is no script. With the optional layout \"icicle\" the same hierarchy is drawn as horizontal bars instead, the top-level groups in the left column and each level one column further right. A group's hue follows its top-level group and each ring out is a lighter shade of it; every arc or bar carries its name, path, value and share in a hover title and in the hidden table (item, path, value, share of total), and the aria label gives the total, the number of groups and the largest group. Labels are drawn only where they fit and are rotated to read outward, never upside down; the centre of the ring shows the total. Motion-ready: every moving value reads --p (build progress 0 to 1, default 1) through a per-ring --k, so a motion_timeline track on p builds it ring by ring from the inside out and the standalone render is the finished picture; reduced motion shows the end state.",
   "properties": {
    "component": {
     "const": "sunburst"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 80)."
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required, 2 to 40) of {path (optional, array of 0 to 3 strings, max 20 each: the item's ancestor groups from the top down; same shape as the treemap's nested mode), name (max 24, default \"Item n\"), value (number above 0)}. An item without a usable path is its own arc in the innermost ring. Items with a value of 0 or less, a value that is not a finite number, or that are not an item are dropped and counted in a note; items beyond the first 40 are noted and not drawn. With fewer than 2 usable items a note replaces the chart."
    },
    "layout": {
     "description": "\"radial\" or \"icicle\" (optional, default \"radial\"). radial draws concentric rings (a sunburst); icicle draws horizontal bars with the top-level groups on the left. Any other value is drawn as radial."
    },
    "unit": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 12). Appended to every value in the title, the centre, the aria label and the hidden table."
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1). The sunburst contract the payload was written for. Only version 1 exists; a higher whole number is drawn as version 1 with a note."
    }
   },
   "required": [
    "component",
    "items"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_measured", "lit": "not_measured", "angular": "not_measured", "copilotkit": "not_measured", "a2ui-vue": "not_measured", "flutter": "native", "compose": "native"},
   "x-routing-text": "Share of a total broken down through up to three levels of groups, as concentric rings (or a horizontal icicle), such as a budget by department and line, disk usage by folder or revenue by region and product. Reads the hierarchy from the inside out. For exact areas side by side use a treemap instead; it is not for a flat list of values, for which use a bar chart.",
   "x-intent-phrases": [
    "Show the budget by department and line as a sunburst.",
    "What is using my disk space, folder by folder, as nested rings?",
    "Break revenue down by region, then product, as concentric rings."
   ]
  },
  "chord_diagram": {
   "type": "object",
   "description": "Flows between a few entities in both directions as a circle: each group is an arc on the ring (its length is the flow that leaves it) and each ribbon joins two groups, its width at each end showing the flow from that group to the other, so migration between regions, traffic between services or trade between countries reads at a glance. Laid out by d3-chord chord() with sorted subgroups and drawn with d3-shape arc() and d3-chord ribbon() paths on the server, so there is no script. With the optional directed true the same matrix is laid out by chordDirected() and every flow is an arrow (ribbonArrow()) from the sending group to the receiving one, so direction is drawn instead of read from two widths. Each group has its own hue and a ribbon takes the colour of its source group at reduced opacity; every ribbon carries \"A to B: value (B to A: value)\" (one direction when directed) in a hover title, and the hidden tables list every non-zero flow (from, to, value) and each group's total out and in; the aria label gives the number of groups, the total flow and the largest flow. Group names sit outside the ring, rotated to read outward and never upside down, shortened with an ellipsis where they do not fit and left out where a neighbour is too close (a visible legend always names every group). Motion-ready: every moving value reads --p (build progress 0 to 1, default 1) through a per-group --k, so a motion_timeline track on p builds it group by group and the standalone render is the finished picture; reduced motion shows the end state.",
   "properties": {
    "component": {
     "const": "chord_diagram"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 80)."
    },
    "groups": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required, 2 to 12) of strings (max 20 each) naming the entities. A name that is not a string or a number is shown as \"Group n\". Groups beyond the 12th are noted and not drawn, and their rows and columns are dropped. With fewer than 2 groups a note replaces the chart."
    },
    "matrix": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array of rows (required): square, one row and one column per group, numbers 0 or more; the cell at row i and column j is the flow from group i to group j (the diagonal is a flow from a group to itself, drawn as a loop). A matrix that is not a list, not square, or whose size does not match groups is replaced by the note \"A chord diagram needs a square matrix with one row per group.\" and what was wrong. A cell that is negative or not a finite number counts as 0 and is counted in a note. If every flow is 0 a note replaces the chart."
    },
    "unit": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 12). Appended to every value in the titles, the aria label and the hidden tables."
    },
    "directed": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional, default false). false draws chord(): one ribbon joins each pair of groups and its width at each end is the flow from that group (the larger direction is the ribbon's source). true draws chordDirected() with ribbonArrow(): one arrow per non-zero flow, pointing at the receiving group, and a group's arc covers what it sends and what it receives. Any value other than the boolean true is drawn as false."
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1). The chord_diagram contract the payload was written for. Only version 1 exists; a higher whole number is drawn as version 1 with a note."
    }
   },
   "required": [
    "component",
    "groups",
    "matrix"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_measured", "lit": "not_measured", "angular": "not_measured", "copilotkit": "not_measured", "a2ui-vue": "not_measured", "flutter": "native", "compose": "native"},
   "x-routing-text": "Flows between a few entities (2 to 12) in both directions, as a ring with a ribbon per pair, such as migration between regions, traffic between services, trade between countries or transfers between teams; set directed to draw each flow as an arrow. For one-way staged flows from sources through stages to outcomes use sankey_flow instead; it is not for more than 12 entities, for a hierarchy (use sunburst or treemap) or for a single list of values (use a bar chart).",
   "x-intent-phrases": [
    "Show migration between five regions as a chord diagram.",
    "Which of our services talk to which, and how much traffic goes each way?",
    "Draw the flows between these teams as ribbons around a circle, with arrows for direction."
   ]
  },
  "circle_pack": {
   "type": "object",
   "description": "Part-to-whole as packed circles: each item is a circle whose area shows its value, and the optional per-item path (1 to 3 group names, top down) nests the circles inside outlined group circles, so a budget, a skills inventory or a folder tree reads as clusters. Laid out by d3-hierarchy pack() (circle packing: the front-chain placement of packSiblings and the smallest enclosing circle of packEnclose, padding 3) on the server, so there is no script. A group's hue follows its top-level group and a deeper circle is a lighter shade of it; group circles are outlined, leaf circles are filled. Every circle carries its name, path, value and share in a hover title and in the hidden table (item, path, value, share of total), and the aria label gives the total, the number of groups and the largest item. A leaf name (and its value, in a wider container) is drawn inside the circle where it fits, and a group name at the top of its circle where it fits; both are 12 px text gated on the container width. Motion-ready: every moving value reads --p (build progress 0 to 1, default 1) through a per-depth --k, so a motion_timeline track on p builds it level by level from the groups inward and the standalone render is the finished picture; reduced motion shows the end state.",
   "properties": {
    "component": {
     "const": "circle_pack"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 80)."
    },
    "items": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required, 2 to 60) of {path (optional, array of 0 to 3 strings, max 20 each: the item's ancestor groups from the top down; same shape as the treemap's nested mode and the sunburst), name (max 24, default \"Item n\"), value (number above 0)}. An item without a usable path is a circle of its own at the top level. Items with a value of 0 or less, a value that is not a finite number, or that are not an item are dropped and counted in a note; items beyond the first 60 are noted and not drawn. With fewer than 2 usable items a note replaces the chart."
    },
    "unit": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 12). Appended to every value in the title, the aria label, the labels and the hidden table."
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1). The circle_pack contract the payload was written for. Only version 1 exists; a higher whole number is drawn as version 1 with a note."
    }
   },
   "required": [
    "component",
    "items"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_measured", "lit": "not_measured", "angular": "not_measured", "copilotkit": "not_measured", "a2ui-vue": "not_measured", "flutter": "native", "compose": "native"},
   "x-routing-text": "For a sense of grouping and rough size; items as circles packed inside their groups, such as skills by team, files by folder or spend by department and line. For comparing sizes use a treemap or bar chart (circle area is hard to compare); it is not for a flat ranked list, for which use a bar chart, or for share of a total through levels as rings, for which use a sunburst.",
   "x-intent-phrases": [
    "Show our team's skills grouped by area as packed circles.",
    "Which folders are taking the space, as a circle packing?",
    "Give me a bubble-cluster view of spend by department and line."
   ]
  },
  "arc_diagram": {
   "type": "object",
   "description": "Connections between named things as arcs: the nodes sit on one horizontal line and each link is a semicircle above it joining its two nodes (the d3 gallery \"arc diagram\"), so a co-authorship list, a module-dependency graph or a who-talks-to-whom table reads as clusters of short arcs and a few long ones. Node positions are even steps along the line (d3-scale scalePoint with padding 0.5) and the arcs are static SVG, so there is no script. Arc thickness shows the link value (1 to 6 px; all links at 2 px when every value is equal). The optional node group sets the dot and the arc colour (an arc takes its source node's) and a legend names every group, but colour is never the only cue: every dot and arc carries its name, group, link count or value in a hover title, and the hidden tables list every node with its group and link count and every link with its two ends and value. The aria label gives the node and link counts and the most connected node. Node names hang below the line rotated 90 degrees; in a narrow container only every second, fourth or eighth name is drawn (the first always) so that none overlaps. Motion-ready: every moving value reads --p (build progress 0 to 1, default 1) through a --k, so a motion_timeline track on p draws the arcs and then the nodes and the standalone render is the finished picture; reduced motion shows the end state.",
   "properties": {
    "component": {
     "const": "arc_diagram"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 80)."
    },
    "nodes": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required, 2 to 40) of {id (string, max 40: what links refer to), label (string, max 24, default the id), group (optional string, max 20)}. An entry that is not a node, has no id or repeats an earlier id is left out and counted in a note; entries beyond the first 40 are noted and not drawn. With fewer than 2 usable nodes a note replaces the chart."
    },
    "links": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional, 0 to 120) of {source (a node id), target (a node id), value (optional number above 0, default 1)}. A link that is not an object, joins a node to itself, names an id that is not a node or has a value that is not a finite number above 0 is dropped and counted in a note; links beyond the first 120 are noted and not drawn. Links are undirected: the arc is always drawn above the line between its two nodes. Parallel links are drawn on top of one another."
    },
    "order": {
     "description": "\"input\" (default), \"group\" or \"degree\". input keeps the order of nodes; group sorts by group name and then label (a node without a group first; plain code-unit comparison, ties keep the input order); degree puts the most connected node first (ties keep the input order). Any other value is input."
    },
    "unit": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 12). Appended to every link value in the titles and the hidden table."
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1). The arc_diagram contract the payload was written for. Only version 1 exists; a higher whole number is drawn as version 1 with a note."
    }
   },
   "required": [
    "component",
    "nodes"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_measured", "lit": "not_measured", "angular": "not_measured", "copilotkit": "not_measured", "a2ui-vue": "not_measured", "flutter": "native", "compose": "native"},
   "x-routing-text": "Connections between a few dozen named things as arcs over one line, such as who co-wrote with whom, which module imports which or which teams talk to each other; the node order (input, by group or by most connected first) is the story. For flows with amounts use a sankey_flow; for connections between a handful of groups use a chord_diagram; it is not for hierarchies (use a treemap or sunburst) and not for more than 40 nodes.",
   "x-intent-phrases": [
    "Show who co-authored with whom as an arc diagram.",
    "Draw which modules import which, as arcs over a line.",
    "Put the nodes on a line and join the connected ones with arcs."
   ]
  },
  "contour_plot": {
   "type": "object",
   "description": "Filled contour bands drawn from data: either a grid of values (a temperature, elevation or pressure field) or a cloud of points (the density of delivery locations, incidents or customers). Both use d3-contour: for a grid, marching squares at evenly spaced levels (d3's default count of levels, or the thresholds field); for points, a kernel density estimate (d3 contourDensity: the points are smoothed with the given bandwidth and contoured at up to 20 levels). Bands run from light to dark as the value or density rises, every band is named in a legend as a range of numbers (never colour alone), and a thin outline marks each level. A grid is drawn with column and row numbers on its axes; points use their own x and y with nice axis ticks and are also drawn as faint dots. Static SVG, no script, scaled to its container. The hidden tables give every level with its colour name and, for a grid, the share of cells at or above it, for points the share of points in cells at or above it, then the points themselves (first 200). The aria label gives the mode, the size, the value range and the number of levels. Motion-ready: each band reads --p through a --k so a motion_timeline track on p draws the bands from the lowest level up; the standalone render is the finished picture.",
   "properties": {
    "component": {
     "const": "contour_plot"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 80)."
    },
    "grid": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (one of grid or points is required): {width (whole number, 2 to 100), height (whole number, 2 to 100), values (array of width times height numbers, row-major: the first row is the top)}. A value that is not a finite number (or beyond 1e12) is left empty, counted in a note and treated as below every level, as d3 does. A grid whose size is not right gets a note instead of the chart. If points is also given, the grid is drawn and a note says so."
    },
    "points": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (one of grid or points is required, 3 to 2000) of {x, y} numbers. An entry that is not an object with finite numeric x and y is skipped and counted in a note; points beyond the first 2000 are noted and not used; fewer than 3 usable points gets a note instead of the chart. The axes are the data range niced by d3 (a flat range is widened by 1 each side), y up."
    },
    "thresholds": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, 3 to 20; another number is clamped, a fraction is rounded down). How many levels d3 aims for: ticks at 1, 2 or 5 times a power of ten, so the drawn count can differ. Default: for a grid d3's Sturges count from the number of cells (thresholdSturges); for points 20."
    },
    "bandwidth": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, 5 to 60, default 20; clamped). Points mode only: the smoothing radius of the kernel density, in pixels of the 600 by 400 drawing (it scales with the chart). Larger merges clusters."
    },
    "x_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 30). Under the plot. A grid defaults to \"Column\"."
    },
    "y_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 30). Above the plot. A grid defaults to \"Row\"."
    },
    "value_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 30). Grid mode only, names the values in the legend (default \"Value\"). Points mode names the density itself."
    },
    "unit": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 12). Grid mode only, appended to the values in the legend, the tables and the aria label."
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1). The contour_plot contract the payload was written for. Only version 1 exists; a higher whole number is drawn as version 1 with a note."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_measured", "lit": "not_measured", "angular": "not_measured", "copilotkit": "not_measured", "a2ui-vue": "not_measured", "flutter": "native", "compose": "native"},
   "x-routing-text": "A 2D field of values (temperature, elevation, pressure on a grid) or a dense cloud of points (hundreds of delivery locations, incidents, readings) shown as filled contour bands with a range legend. For a few dozen points use a scatter plot; it is not a map (no coordinates, projection or base map, use a geo atom), not a heatmap of categories (a heatmap colours each cell, this draws smoothed regions) and not for more than 100 by 100 grid cells or 2000 points.",
   "x-intent-phrases": [
    "Draw contour lines of this temperature grid.",
    "Show where my delivery locations are densest as density contours.",
    "I have a grid of elevation values and want filled contour bands with a legend."
   ]
  },
  "voronoi": {
   "type": "object",
   "description": "Nearest-site regions of a set of points: the plot is split into one region per site, each region being every spot that is closer to its site than to any other site (a catchment or service area: which store, depot, sensor or office is nearest). Regions come from a Delaunay triangulation and its Voronoi cells (d3-delaunay, with delaunator and robust-predicates), clipped to the sites' extent plus a margin, with nice axis ticks in the data's own units. Each region is filled with a light colour by group (a legend names every group, never colour alone) or with one light fill and a visible outline when there are no groups; the site is a dot, and its label sits under the dot when the region is wide enough for it (otherwise the label is hidden; the full label is in the region's tooltip and in the table). Static SVG, no script, scaled to its container. The hidden table lists every site with x, y, group, value and its share of the area. The aria label gives the number of sites, the number of groups and the site with the largest region. Motion-ready: each region reads --p through a --k so a motion_timeline track on p fades the regions in one after another; the standalone render is the finished picture.",
   "properties": {
    "component": {
     "const": "voronoi"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 80)."
    },
    "sites": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required, 3 to 200) of {x, y (numbers, required), label (optional, max 24), group (optional, max 20), value (optional number)}. A site whose position equals an earlier site's is merged into the first, with a note. An entry that is not an object with finite numeric x and y (or beyond 1e12) is left out and counted in a note; entries beyond the first 200 are noted and not used; fewer than 3 sites at different positions gets a note instead of the chart. A label or group that is a number is shown as that number; a list, object or boolean is no text (the site is called \"Site 1\", \"Site 2\" ... by its place in the list, and has no group). value is shown in the table and in the region's tooltip only, never drawn."
    },
    "x_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 30). Under the plot."
    },
    "y_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 30). Above the plot."
    },
    "unit": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 12). Appended to the values in the table and the tooltips."
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1). The voronoi contract the payload was written for. Only version 1 exists; a higher whole number is drawn as version 1 with a note."
    }
   },
   "required": [
    "component",
    "sites"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_measured", "lit": "not_measured", "angular": "not_measured", "copilotkit": "not_measured", "a2ui-vue": "not_measured", "flutter": "native", "compose": "native"},
   "x-routing-text": "The nearest-site region of each of a set of points: which store, depot, sensor or office is closest to every spot of an area (catchments, service areas, coverage). It is not a map of real borders or regions (no coordinates, projection or base map; use a choropleth), not for finding clusters or the density of points (use a contour plot or a scatter plot), and distances are straight lines in the x and y units, not travel time along roads. 3 to 200 sites.",
   "x-intent-phrases": [
    "Show which of my depots is the nearest to each part of the city.",
    "Draw the service area of each store as nearest-site regions.",
    "Split this area into catchments, one per sensor, by closest distance."
   ]
  },
  "candlestick_chart": {
   "type": "object",
   "description": "Price movement as open-high-low-close bars on a date axis, drawn on the server as static HTML with no script. With the default style \"candle\" each bar is a wick from low to high and a body from open to close; with style \"ohlc\" it is a stem with a tick to the left for the open and a tick to the right for the close. Direction never rests on colour alone: a bar that closes at or above its open is hollow (candle) or a thin bar (ohlc) in the --positive colour, one that closes lower is filled (candle) or a thick bar (ohlc) in the --negative colour, a legend says so in words, and the hidden table has a Direction column. Bars sit at their real dates (weekend gaps show as gaps), the date axis ticks and labels follow d3-scale scaleUtc and d3-time-format, and the price axis follows d3 nice() and ticks(). An optional volume panel under the price panel repeats the hollow or filled cue. A hidden table gives every value. Motion-ready: each bar fades in through --k from --p (build progress 0 to 1, default 1); the standalone render is the finished picture and reduced motion shows the end state.",
   "properties": {
    "component": {
     "const": "candlestick_chart"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 80)."
    },
    "dates": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required, up to 10000 read) of ISO date strings, read as UTC: \"2024-03-05\", or with a time \"2024-03-05T09:30\", \"2024-03-05 09:30:15\" or \"2024-03-05T09:30:15.250Z\". Years 1000 to 9000. Any other string, a time zone offset or a non-string leaves that bar out with a note. The bars are drawn in date order."
    },
    "open": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required) of numbers, one per date, each finite and up to 1e12 in size."
    },
    "high": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required) of numbers, one per date. Must be at least the open, close and low."
    },
    "low": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required) of numbers, one per date. Must be at most the open, close and high."
    },
    "close": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required) of numbers, one per date."
    },
    "volume": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional) of numbers of 0 or more, one per date. Adds a volume panel; a bar without a usable volume has no volume bar and a note counts them."
    },
    "style": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, \"candle\" or \"ohlc\", default \"candle\"). Any other value draws candles."
    },
    "unit": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 12). Appended to the price values in the aria label and the hidden table."
    },
    "y_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 40). Names the price axis above the chart."
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1). The candlestick_chart contract the payload was written for. Only version 1 exists; a higher whole number is drawn as version 1 with a note."
    }
   },
   "required": [
    "component",
    "dates",
    "open",
    "high",
    "low",
    "close"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_measured", "lit": "not_measured", "angular": "not_measured", "copilotkit": "not_measured", "a2ui-vue": "not_measured", "flutter": "native", "compose": "native"},
   "x-routing-text": "Open, high, low and close values per date, such as a share, fund, currency or commodity price, or any measure with a daily range and an opening and closing value. Give the dates and the four number lists. For one value per date use a line or area chart; for a distribution of values use a box plot; for a running total use a waterfall.",
   "x-intent-phrases": [
    "Chart this stock price history as candlesticks.",
    "Show the daily open, high, low and close for the last month with volume.",
    "Draw an OHLC bar chart of the currency rate for each trading day."
   ]
  },
  "parallel_coords": {
   "type": "object",
   "description": "Rows of numbers compared across 2 to 8 measures at once: each measure is a vertical axis with its own scale, and each row is one line that crosses every axis at its value, so clusters, trade-offs and outliers across many measures show as bundles of lines. Optionally the lines are coloured by one measure (a light-to-dark ramp from the theme accent, with a legend giving the range). Axis scales come from d3 scaleLinear nice() and ticks() and the lines from d3 line(), computed on the server, so there is no script. The picture is static: the interactive brushing of a Plotly parallel-coordinates chart (dragging on an axis to filter rows) is not available. A hidden table gives every value of every row.",
   "properties": {
    "component": {
     "const": "parallel_coords"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 80)."
    },
    "dimensions": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required, 2 to 8) of {label (string, max 24, default \"Dimension n\"), values (array of numbers), min (number, optional), max (number, optional), reverse (boolean, optional)}. Row i takes values[i] of every dimension, so every dimension lists the rows in the same order. Without min and max the axis runs over the d3 nice() of the values; with both (min below max) the axis is exactly that range and a value outside it is drawn on the edge, with a note (the table keeps the real number). reverse true puts the highest value at the bottom and says so under the label. A row with a missing or non-numeric value (finite, up to 1e12 in size) in any dimension is left out with a note; rows beyond the first 200 and dimensions beyond the first 8 are noted and not drawn. Entries that are not a dimension are left out with a note."
    },
    "row_labels": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional) of strings (max 30). Names the rows in the hidden table; default \"Row n\"."
    },
    "color_by": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string or integer (optional). The label of a dimension, or its number counting from 0, to colour the lines by. A name that matches no dimension is noted and the lines stay one colour."
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1). The parallel_coords contract the payload was written for. Only version 1 exists; a higher whole number is drawn as version 1 with a note."
    }
   },
   "required": [
    "component",
    "dimensions"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_measured", "lit": "not_measured", "angular": "not_measured", "copilotkit": "not_measured", "a2ui-vue": "not_measured", "flutter": "native", "compose": "native"},
   "x-routing-text": "Compares rows (cars, models, patients, experiments) across several numeric measures at once as lines over parallel axes, for finding clusters, trade-offs and outliers. Not for two measures (use a scatter plot), not for one measure over time (use a line chart), not for categories with counts (use a bar chart or sankey_flow), and not for more than 200 rows or 8 measures.",
   "x-intent-phrases": [
    "Compare these models across accuracy, latency, cost and size at once.",
    "Show how each product ranks on all the measures in a parallel coordinates plot.",
    "Which experiments are good on every metric and which trade one off against another?"
   ]
  },
  "ternary_plot": {
   "type": "object",
   "description": "Shows what share each of three parts makes up of a whole, one dot per observation, on an equilateral triangle: a point's distance from a corner is how little of that part it has, and the corners are pure A, pure B and pure C. Values are normalised to shares that sum to 100%, gridlines run every 20% on all three axes with their percentages printed on the edges, and an optional dashed line joins the points in the order given. The axis ticks come from d3-scale's linear ticks and the placing is plain trigonometry, computed on the server, so there is no script. A hidden table gives every point's three shares. Static, settled picture; each point fades in through --k from --p (build progress 0 to 1, default 1).",
   "properties": {
    "component": {
     "const": "ternary_plot"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 80)."
    },
    "a_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 20, default \"A\"). Names the part at the top corner."
    },
    "b_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 20, default \"B\"). Names the part at the bottom left corner."
    },
    "c_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 20, default \"C\"). Names the part at the bottom right corner."
    },
    "points": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required, 1 to 200) of {label (string or number, max 30, default \"Point n\"), a, b, c (non-negative numbers up to 1e12 in size, not all zero)}. A point whose a, b or c is missing, not a finite number, negative or too large, or that sums to 0, and an entry that is not a point, is left out and counted in a note. Points beyond the first 200 are noted and not drawn."
    },
    "connect": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional, default false). Only true switches it on. Draws a dashed line through the points in the given order."
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1). The ternary_plot contract the payload was written for. Only version 1 exists; a higher whole number is drawn as version 1 with a note."
    }
   },
   "required": [
    "component",
    "points"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_measured", "lit": "not_measured", "angular": "not_measured", "copilotkit": "not_measured", "a2ui-vue": "not_measured", "flutter": "native", "compose": "native"},
   "x-routing-text": "Plots observations that are each a mix of exactly three parts, such as soil sand, silt and clay, a vote split between three parties or a budget split three ways. Give three non-negative numbers per point; they are turned into shares. For one share of a whole use a donut or progress bar; for two numbers per point use scatter_trend; for more than three parts use stacked bars or a treemap.",
   "x-intent-phrases": [
    "Plot these soil samples by sand, silt and clay on a ternary diagram.",
    "Show how the vote split between three parties moved over the years.",
    "Where does each product sit between price, quality and speed?"
   ]
  },
  "quiver": {
   "type": "object",
   "description": "A field of arrows on linear axes: each arrow sits on its x, y point and points the way its u (across) and v (up) numbers say, with a length in proportion to the size of the vector. Use it for wind, flow, forces or any vector field. The axes come from d3 nice() and ticks() (d3-scale's linear scale), computed on the server, so there is no script. Arrows are centred on their point, drawn at a fixed size scale so the longest is a set length, and an arrow of length 0 is a dot. A hidden table gives every arrow's x, y, across, up and length. Static, settled picture; each arrow fades in through --k from --p (build progress 0 to 1, default 1).",
   "properties": {
    "component": {
     "const": "quiver"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 80)."
    },
    "x_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 40, default \"x\"). Names the horizontal axis."
    },
    "y_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 40, default \"y\"). Names the vertical axis."
    },
    "unit": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 12). The unit of u, v and the length; appended to those values in the table and the label."
    },
    "arrows": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required, 1 to 200) of {x, y, u, v (finite numbers up to 1e12 in size), label (string or number, max 30, default \"Arrow n\")}. An entry with a missing or unusable number, or that is not an arrow, is left out and counted in a note. Arrows beyond the first 200 are noted and not drawn."
    },
    "arrow_scale": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, 0.1 to 1, default 1). Shrinks every arrow by this factor; the longest is 120 units of a 1000 unit wide drawing at scale 1. A value that is not a number is ignored."
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1). The quiver contract the payload was written for. Only version 1 exists; a higher whole number is drawn as version 1 with a note."
    }
   },
   "required": [
    "component",
    "arrows"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_measured", "lit": "not_measured", "angular": "not_measured", "copilotkit": "not_measured", "a2ui-vue": "not_measured", "flutter": "native", "compose": "native"},
   "x-routing-text": "Draws a vector field, one arrow per point, such as wind speed and direction across a map grid, water flow or the force on each node. Give x, y and the arrow's across (u) and up (v) numbers. It is not for flows between categories (use sankey_flow), for change over time (use a line chart) or for plain points (use scatter_trend). The arrow direction ignores the axis scales (it is the picture angle of (u, v), not scaled by x or y), and arrows are centred on their point, not tail-anchored.",
   "x-intent-phrases": [
    "Draw the wind field over this grid as arrows.",
    "Show the direction and strength of the current at each station.",
    "Plot the force vectors on these points."
   ]
  },
  "choropleth_map": {
   "type": "object",
   "description": "A map of regions shaded by one number each: world countries, US states or European countries. Give a region_set and a list of {id, value}; the server shades every region in one of 3 to 9 equal-interval classes (steps, default 5), draws a legend of the class ranges and hatches the regions that have no value, so a gap never reads as a low number. Colours come from the theme tokens (sequential accent ramp, or a diverging accent2-to-accent ramp through a neutral middle); Viridis, Turbo and other fixed colour maps are not offered. The outlines are bundled with the catalogue (Natural Earth 1:110m for countries, US Census 1:10m for states): there is no custom GeoJSON, so a region that is not in the set cannot be added. A hidden table lists each region with its code, value and class, largest first, and the regions with no value are listed in a details element. A payload that breaks the rules shows a short note instead of a map.",
   "properties": {
    "component": {
     "const": "choropleth_map"
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1). Payload contract version."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 80). Shown above the map and used as its name."
    },
    "region_set": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (required): world-countries (176 countries, Antarctica left out), us-states (the 50 states and DC) or europe-countries (the European subset of world-countries, Russia and Turkey included, framed on the area west of 45 degrees east). Use it to choose which outlines are drawn; the set also decides which ids are valid."
    },
    "projection": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional): equal-earth, mercator or albers-usa. Equal Earth keeps areas comparable, so it is the default for world-countries and europe-countries; Mercator suits a close view of Europe but inflates high latitudes; albers-usa (the d3 composite that moves Alaska and Hawaii under the lower 48) is only valid with us-states and is its default. Any other combination, or any other name, shows a note. Use this to change the look, not the data."
    },
    "values": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required, 1 to 250) of {id (string), value (number)}. id is an ISO 3166-1 alpha-3 code for the country sets (for example FRA; Kosovo is XKX) or a 2-letter USPS code for us-states (for example TX; DC is included); case is ignored. value is a finite number of at most 1e15 in size. Entries beyond the 250th are ignored, an unknown id is skipped and named in a note, a repeated id keeps its first value, and an entry without a usable id and number is counted in a note; if nothing matches a region the map is not drawn."
    },
    "scale": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (optional) {kind, scheme?}, the scale contract of chart_legend without the domain (the domain is the data). kind is sequential (default: low to high, one direction) or diverging (a neutral middle, two directions, for values that rise and fall around a centre such as change or difference). scheme is a theme-token ramp name: accent (default) or accent2 for sequential, accent_pair for diverging; any other name falls back to the default. For diverging the centre is 0 when the values cross zero, otherwise the middle of the range. Use diverging only when the centre means something."
    },
    "unit": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 12). Appended to the legend ranges and the table values (for example % or USD), with no space before a percent sign."
    },
    "legend_title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 60). A heading for the legend (for example Unemployment rate, %); the map title says what the map is, the legend title says what the colours measure."
    },
    "steps": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, 3 to 9, default 5). The number of classes. Fewer classes read faster and hide detail; more show detail but neighbouring shades get hard to tell apart. A number outside 3 to 9 is moved to the nearest and named in a note."
    },
    "frame": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (optional) {lon_min, lon_max, lat_min, lat_max}, four finite numbers in degrees: frame the map on a zone (for example a trip) instead of the whole region_set. Longitude is clamped to -180..180 and latitude to -85..85, lat_min must be below lat_max after that, and a span under 1 degree is widened to 1. lon_min above lon_max is a frame across the antimeridian (160 to -150 is a Pacific trip: Fiji, Samoa, Hawaii): the map is drawn with its central meridian at the frame's centre, so outlines, points and routes run on across 180 as one piece; a frame that reaches -180 or 180 is centred the same way, so the land past the seam is drawn. lon_min equal to lon_max is not a frame. A motion_transition between two frames on either side of the seam pans and zooms each keyed region's box (a region drawn in two pieces across the seam travels as one box). A frame that contains no outline of the set is named in a note. A framed map has a sea tint (a mix of theme tokens; left out when the frame reaches past the region set's window, where the set has no land) and rounded corners. The frame is fitted into a fixed 960 x 540 canvas and centred, so two states of one film with different frames have the same box and a motion_transition between them pans and zooms: regions keep their data-key. Outlines outside the frame are drawn and cropped by the viewBox, not dropped. Not used with albers-usa (a fixed composite). A frame that cannot be used is named in a note and the whole map is drawn. Absent: unchanged."
    },
    "categories": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional, 1 to 6 names, text up to 40) of category names: switches the map to category mode. Each value is then a category name instead of a number ({id, value: \"visited\"}); the scale, steps and unit are not used. Each category gets a colour AND a pattern (dots, horizontal stripes, vertical stripes, cross-hatch, backslash stripes, large dots, in list order), so colour is never the only cue; regions with no category are hatched on the surface colour (forward slash) and listed in a details element. The legend lists the categories (data-key class-1 to class-n) and the hidden table lists region, code and category. An entry that names a category not in the list is skipped and counted in a note."
    },
    "category_colors": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (optional) mapping a category name to a theme token name: accent, accent2, text or muted (nothing else, so the map follows the theme in light and dark). A category without an entry, or with another name, takes the default palette by position (accent, accent2, then lighter mixes of them, text and muted) and is named in a note when the name was not a token. Only used with categories."
    }
   },
   "required": [
    "component",
    "region_set",
    "values"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_measured", "lit": "not_measured", "angular": "not_measured", "copilotkit": "not_measured", "a2ui-vue": "not_measured", "flutter": "not_measured", "compose": "not_measured"},
   "x-routing-text": "Shade countries (world or Europe) or US states by one number each, with a quantized legend and a text table. Not for points, routes or city-level maps, and not for a map you draw yourself from GeoJSON. For a ranked list of the same numbers use bar_chart.",
   "x-intent-phrases": [
    "Show unemployment rate by US state on a map.",
    "Colour the countries of the world by GDP per person.",
    "Map our customer count across Europe."
   ]
  },
  "geo_map": {
   "type": "object",
   "description": "Points and lines on a map: dots at latitude and longitude, optionally sized by a number and grouped, and great-circle lines between places, drawn over the same bundled outlines and projections as choropleth_map (world countries, US states or European countries; Equal Earth, Mercator or the US composite). Each group gets its own marker shape as well as its own colour, each line its own dash, so colour is never the only cue. A hidden table lists every point (including any that fall outside the frame, which are noted) and every line. A payload that breaks the rules shows a short note instead of a map.",
   "properties": {
    "component": {
     "const": "geo_map"
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1). Payload contract version."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 80). Shown above the map and used as its name."
    },
    "region_set": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, default world-countries): world-countries, us-states or europe-countries. Chooses the outlines drawn behind the data and the area the map is framed on; there is no custom GeoJSON and no map tiles."
    },
    "projection": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional): equal-earth, mercator or albers-usa. Defaults as in choropleth_map (equal-earth, or albers-usa for us-states); albers-usa is only valid with us-states and moves Alaska and Hawaii under the lower 48. Any other value shows a note."
    },
    "points": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional, up to 500) of {lat, lon, id?, label?, value?, group?}. id is text (max 60), the stable key of the point for a build (data-key): without it the key is the label, then the position in the list (p0, p1, ...); a repeated key gets ~2, ~3. lat is -90 to 90 and lon -180 to 180, both finite numbers. label is text (max 40) for the tooltip and the table. value is a finite number that sets the marker size (radius grows with the square root of its place between the smallest and largest value, about 2 to 8 px on a 650 px wide map; a point without a value is the smallest). group is text (max 40); each group gets a marker shape (circle, square, diamond, triangle) and a theme colour in order of first appearance, six groups at most, later groups are shown as Other; the shape and colour pairs of all six groups differ, and points without a group get their own pair and a legend entry Ungrouped (when other points have a group). A point outside the frame (for example Tokyo on a Europe map) is not drawn and is noted. Entries past the 500th are ignored with a note."
    },
    "lines": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional, up to 40) of {id?, label?, path: [{lat, lon}, ...]} with 2 to 20 points per path. id is the stable key of the line (as for a point, then the label, then l0, l1, ...). Consecutive points are joined by the great-circle arc between them (d3-geo geoInterpolate, drawn with up to 64 segments each), broken where it crosses the antimeridian so it never streaks across the map. Each line has its own dash (solid, long dash, dotted) and a theme colour."
    },
    "unit": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 12). Appended to the values in the legend, tooltips and table."
    },
    "legend_title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 60). A heading for the legend (what the marker size measures)."
    },
    "frame": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (optional) {lon_min, lon_max, lat_min, lat_max}: frame the map on a zone (a trip) instead of the whole region_set; the same rules as the frame of choropleth_map (clamped to -180..180 and -85..85, lon_min above lon_max crosses the antimeridian, a span under 1 degree widened, a fixed 960 x 540 canvas, not used with albers-usa, a bad frame is named in a note and the whole map drawn). With a frame every outline carries data-cb \"tile\" and its region code as data-key, so a motion_transition between two frames moves the whole map as a pan and zoom; points and routes keep their keys and travel with it. Outlines outside the frame are cropped, not dropped; a point outside it is not drawn and is noted. Absent: unchanged."
    },
    "regions": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional, up to 250) of {id, category}: shade regions by category (visited, planned, not yet). id is an ISO 3166-1 alpha-3 code (or a USPS code for us-states), category text up to 40. Shaded regions keep their data-key (the code), so they travel in a transition and a region that changes category changes colour. Each category has a colour and a pattern (see categories), listed in the legend, and the hidden table lists region, code and category."
    },
    "categories": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional, 1 to 6 names) fixing the category order of regions (so the colours stay the same from one state of a film to the next); without it the categories are the names of regions in first-seen order. Only used with regions."
    },
    "category_colors": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (optional) mapping a category name to accent, accent2, text or muted (theme tokens only); the default palette by position otherwise. Only used with regions."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_measured", "lit": "not_measured", "angular": "not_measured", "copilotkit": "not_measured", "a2ui-vue": "not_measured", "flutter": "not_measured", "compose": "not_measured"},
   "x-routing-text": "Place sites, cities, offices or events on a map from latitude and longitude, optionally with routes between them. Not for shading whole countries or states by a number (use choropleth_map), not for a tile map with streets (no map tiles are fetched), and not for a spinning globe (use globe_3d).",
   "x-intent-phrases": [
    "Plot our office locations on a world map.",
    "Show shipping routes between these ports.",
    "Mark the cities where we have customers, bigger for more customers."
   ]
  },
  "polar_chart": {
   "type": "object",
   "description": "Points and lines placed by angle and distance from a centre: each series gives a radius r and an angle theta for every point, so a compass or wind bearing, a cyclic pattern (hour of day, month) or a radar of scores per category reads as a circular chart. Angles are degrees, or categories (any text) spread evenly around the circle, which draws a radar chart. Up to 6 series are drawn as lines, markers or both, each with its own dash and marker shape so no series depends on colour alone; the optional fill \"toself\" shades the closed shape of a series. The radial axis starts at 0 (or the lowest negative value) and ends at a round number d3 nice() picks, with circular gridlines at d3 ticks(); an explicit r_range sets it, and a point outside the range is not drawn and is counted in a note. Angles are turned to positions by d3-shape lineRadial() maths and scaled by a d3-scale linear scale, on the server, so there is no script. A large series is thinned to evenly spaced points (the first and last of the points read are kept) with a visible note, the same cap that stands in for Plotly's WebGL scatterpolargl; a series is read up to 5000 points and a longer one says so in a note, so no point is dropped without being counted. The hidden table lists every point with a Status column (drawn, or outside the radial range and not drawn), and the aria label gives the radial range of the drawn points, the categories and each series' extent. Motion-ready: each series fades in through --k from --p (build progress 0 to 1, default 1); the standalone render is the finished picture and reduced motion shows the end state.",
   "properties": {
    "component": {
     "const": "polar_chart"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 80)."
    },
    "series": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required, 1 to 6) of {label (string, max 30, default \"Series n\"), r (array of numbers, radius of each point), theta (array of numbers in degrees, or strings for categories; same length as r), mode (optional, \"lines\", \"markers\" or \"lines+markers\"; default \"lines+markers\" up to 20 points, otherwise \"lines\"), fill (optional, \"toself\" shades the shape closed from the last point to the first)}. A point needs a finite radius and angle up to 1e12 in size; an entry without a partner or number is skipped and counted in a note; series beyond the first 6 are noted and not drawn. Each series draws at most 2000 divided by the number of series points: a longer one is thinned to evenly spaced points with a note. If any theta is a string, all angles are categories."
    },
    "categories": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional, up to 12 strings, max 30 each). Fixes the order of the categories around the circle; categories met in the series after these are added in order of appearance, up to 12 in all (points in later ones are noted and not drawn)."
    },
    "r_range": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional) of two numbers [low, high], low below high. Sets the radial axis; points outside it are not drawn and are counted in a note. Absent, the axis runs from 0 (or the lowest negative radius) to a round number above the highest."
    },
    "r_ticks": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, 2 to 8, default 4). About how many circular gridlines the radial axis aims for."
    },
    "theta_step": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, 30 to 180, default 30). Degrees between the labelled angle spokes of a numeric chart."
    },
    "direction": {
     "description": "\"clockwise\" or \"counterclockwise\" (optional). Default counterclockwise for numeric angles (as Plotly draws them) and clockwise for categories."
    },
    "rotation": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional, -360 to 360). Where angle 0 sits, in degrees counterclockwise from three o'clock. The default follows Plotly: 90 (due north, like a compass) when the direction is clockwise, 0 (due east) when it is counterclockwise; so an explicit \"clockwise\" starts at the top, which suits wind bearings."
    },
    "unit": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 12). Appended to the radial values in the aria label and the hidden table."
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1). The polar_chart contract the payload was written for. Only version 1 exists; a higher whole number is drawn as version 1 with a note."
    }
   },
   "required": [
    "component",
    "series"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_measured", "lit": "not_measured", "angular": "not_measured", "copilotkit": "not_measured", "a2ui-vue": "not_measured", "flutter": "native", "compose": "native"},
   "x-routing-text": "Values placed by an angle and a distance from a centre, such as wind direction against speed, activity by hour of day, a cyclic signal, or scores on several categories compared as a radar. Give each series r and theta (degrees or category names). For a single series of 0 to 100 skill scores use skill_radar; it is not for bars around a circle (radial bars are not offered), for values on straight x and y axes (use scatter_trend) or for part-to-whole (use a pie or sunburst).",
   "x-intent-phrases": [
    "Plot wind speed by compass direction on a polar chart.",
    "Compare two products on six criteria as a radar chart.",
    "Show how load varies over the 24 hours of the day around a circle."
   ]
  },
  "histogram2d": {
   "type": "object",
   "description": "Counts of x,y points in a grid of 2-D bins (the Plotly histogram2d trace), drawn as a heatmap: d3 bin() is run once on x and once on y, the cell count is the number of points that fall in both bins, and the grid is handed to the heatmap atom, so it has the heatmap colour bar, the cell counts printed inside the cells and a hidden data table. The highest y bin is the top row. Use nbinsx and nbinsy for the number of bins (the real count is the nearest round step, as in d3), or leave them out for the Sturges default. At most 20,000 points are used and at most 40 bins per axis, each with a note.",
   "properties": {
    "component": {
     "const": "histogram2d"
    },
    "x": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required, numbers, at least 2 usable pairs with y; up to 20,000 used)."
    },
    "y": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required, numbers, same length as x)."
    },
    "nbinsx": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, 3 to 40, the bin count asked of d3 for x; default Sturges)."
    },
    "nbinsy": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, 3 to 40, the bin count asked of d3 for y; default Sturges)."
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 80)."
    },
    "x_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 40, named in the note under the grid)."
    },
    "y_label": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 40, named in the note under the grid)."
    },
    "scale": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, a heatmap colour scale name such as Blues, Viridis or YlOrRd; default YlGnBu, light for few points and dark for many)."
    },
    "show_values": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional, default true, prints each count in its cell)."
    },
    "show_colorbar": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional, default true)."
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1; a higher number draws as version 1 with a muted note)."
    }
   },
   "required": [
    "component",
    "x",
    "y"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_measured", "lit": "not_measured", "angular": "not_measured", "copilotkit": "not_measured", "a2ui-vue": "not_measured", "flutter": "native", "compose": "native"},
   "x-routing-text": "Two numeric columns whose joint spread you want to see as counts per cell (density of points, a correlation blob). Not for a grid you already have (use heatmap), not for categories (use heatmap with labels), not for a few points (use scatter_trend), and not for sums or averages of a third value (counts only).",
   "x-intent-phrases": [
    "Show where the points are densest as a grid of counts.",
    "I need a 2D histogram of height against weight.",
    "Bin these x and y values into a heatmap of how many fall in each cell."
   ]
  },
  "scatter_matrix": {
   "type": "object",
   "description": "A scatter plot matrix (Plotly splom): 2 to 6 numeric dimensions on one grid, every dimension on a shared axis across its row and column, so each cell plots one dimension against another and a pattern between any two shows at a glance. Below the diagonal each cell is a small scatter plot of every complete row (the upper half too with show_upper); the diagonal names the dimension; wide pages also show each dimension's range on the outer edges. Each axis comes from d3 nice() and ticks() on the server, so there is no script. A legend lists every dimension with its range and a hidden table gives every value of every row. Static: no hover or brushing. Motion-ready: each cell fades in through --k from --p (default 1).",
   "properties": {
    "component": {
     "const": "scatter_matrix"
    },
    "title": {
     "$ref": "common_types.json#/$defs/DynamicString",
     "description": "string (optional, max 80)."
    },
    "dimensions": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (required, 2 to 6) of {label (string, max 24, default \"Dimension n\"), values (array of numbers)}. Row r is the r-th value of every dimension. A row where any dimension has no finite number up to 1e12 in size is left out and counted in a note; an entry that is not a dimension with a list of values is left out with a note; dimensions beyond the first 6 are noted and not drawn. At most 200 complete rows are read; later rows are noted and not drawn. With fewer than 2 dimensions or 2 complete rows a note replaces the chart."
    },
    "show_upper": {
     "$ref": "common_types.json#/$defs/DynamicBoolean",
     "description": "boolean (optional, default false). Only true also draws the upper half (the same plots with the axes swapped)."
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1). The scatter_matrix contract the payload was written for. Only version 1 exists; a higher whole number is drawn as version 1 with a note."
    }
   },
   "required": [
    "component",
    "dimensions"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_measured", "lit": "not_measured", "angular": "not_measured", "copilotkit": "not_measured", "a2ui-vue": "not_measured", "flutter": "native", "compose": "native"},
   "x-routing-text": "Shows how several numeric measures relate to each other at once, such as sepal and petal sizes, or price, area and age of homes, as a grid of small scatter plots. For two measures only use a scatter or trend chart; for many rows on one measure use a histogram; for lines over categories use parallel_coords. It is not for category counts (use parallel_categories).",
   "x-intent-phrases": [
    "Plot every measure against every other as a scatter plot matrix.",
    "Show how price, area and age relate to each other in a grid of scatter plots.",
    "Make a splom of these four numeric columns."
   ]
  },
  "motion_transition": {
   "type": "object",
   "description": "Morphs one atom into another on the film's progress dial p, joining their elements by data key: two views of the same data (a treemap and a sunburst, a table and an org chart) hand over element by element instead of cross-fading. Each element of the second block that shares a key with the first starts on its partner's box and travels to its own place; with path keys a total starts on the union of its parts (Cloud collects Cloud/VMs and Cloud/Storage) and a part starts on its total; elements only in one block fade. Labels only fade. With reduced motion, on static surfaces or when no timeline sets p, the page shows the second block exactly as it renders alone.",
   "properties": {
    "component": {
     "const": "motion_transition"
    },
    "from": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (optional). The block shown at p = 0 (any atom). Its elements that carry the build contract (data-cb with data-key) are the start positions; it fades out over the first part of p. Missing: every element of to enters."
    },
    "to": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (required unless patch is given). The block shown at p = 1 (any atom): the page is exactly this block when p is 1, with reduced motion, and on surfaces without script."
    },
    "patch": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional) of RFC 6902 JSON Patch operations (add, remove, replace, move, copy, test) applied to a copy of from to make the p = 1 block, in place of to. Use it when the change is a few edits to the same atom (add a person to an org chart, move a card between columns): a copied item grows out of its source, a replaced id continues from the old element, a moved item keeps its key. Needs from; if to is also given, to wins. Up to 500 operations are applied. A patch that fails (bad path, failed test op) shows the from block, with an HTML comment naming the error."
    },
    "match": {
     "description": "\"path\" | \"exact\" (optional, default path). exact joins identical keys only. path also joins along category paths: a key that is the prefix of others (Cloud, of Cloud/VMs) starts on the union of their boxes, and a key under another (Cloud/VMs, under Cloud) starts on its parent's box."
    },
    "key_map": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (optional, up to 200 pairs). Renames keys of from before the join, from-key to to-key, for two atoms that name the same things differently (a team table keyed by employee id to an org chart keyed by name)."
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1). Contract version."
    }
   },
   "required": [
    "component",
    "to"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_measured", "lit": "not_measured", "angular": "not_measured", "copilotkit": "not_measured", "a2ui-vue": "not_measured", "flutter": "native", "compose": "native"},
   "x-routing-text": "Animate a hand-over from one chart or list to another showing the same data (treemap to sunburst, table to org chart), elements moving by their data key, driven by a motion_timeline p track.",
   "x-intent-phrases": [
    "Morph the treemap into a sunburst of the same budget.",
    "Collapse the breakdown into its totals as the film plays."
   ]
  },
  "motion_map3d": {
   "type": "object",
   "description": "A tilted 3D city map built from CSS alone (perspective and a rotated plane: no WebGL, no map tiles, no fetch). Blocks stand on a ground plane as three-faced boxes, either a seeded generated city, explicit blocks, or generated district clusters (cities). Outlines of real-world countries or states can be drawn directly on the ground plane under the blocks and route. As p runs 0 to 1 the camera descends and tilts in (p 0 to 0.3), then one or more legs draw on from station to station (p 0.3 to 0.92, optionally bending in arcs and pausing at stations with dwell times) with each station going from idle to active as a leg reaches it and then to its own state (idle, active, done, warn or error), payload chips can travel along the legs, and an optional clock chip counts in clock time, seconds or milliseconds. Station pins and labels sit on their own layer above the city, so blocks never cover them. Made for journeys through a system as much as through a city: a request trace, an agent's tool call and its reply, a deploy pipeline, an incident. At p = 1 every leg is fully drawn, the stations are in their final states and the clock shows its end value.",
   "properties": {
    "component": {
     "const": "motion_map3d"
    },
    "seed": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional). 0 to 9999, default 7. Seeds the generated city when no blocks are given: the same seed always makes the same city. Generated blocks leave the streets under the route and the stations clear, and are lower close to them, so the route is never hidden."
    },
    "blocks": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional, up to 200) of {x, y, w, h, height}: x, y, w, h in percent of the map (0 to 100, w and h at least 1) and height the box height (0 to 40, default 6). When given and non-empty they replace the generated city and are drawn exactly as written, so keep your own blocks off the route. More than 200 draw the first 200 with a visible note."
    },
    "ground": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (optional) {set, window, highlight, fill, accent}. Real map outlines drawn directly on the city plane under blocks and routes. set: \"world-countries\", \"europe-countries\", or \"us-states\". window: [lon0, lon1, lat0, lat1] bounding box in degrees (lon -180..180, lat -85..85 with lon0 < lon1 and lat0 < lat1). highlight: array (up to 24) of region id strings. fill and accent: \"#rrggbb\" colours (defaults #2a3342 and #3a4a63). Example: ground: {set: \"europe-countries\", window: [-10, 30, 35, 60], highlight: [\"FRA\", \"DEU\"]}. Maximum 400 regions and 6000 points; when ground is valid without blocks or cities, the full-plane generated city is omitted."
    },
    "cities": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional, up to 8) of {x, y, w, h, count, seed, height}. Clusters of small buildings generated inside rectangular districts (0 to 100 percent map coords). count: 1 to 24 (default 4); height: 1 to 40 (default 8); seed: optional integer (defaults to atom seed + city index). Example: cities: [{x: 20, y: 30, w: 25, h: 25, count: 9}]. Omits the full-plane random city."
    },
    "arc": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number 0 to 0.6 or boolean (optional, true = 0.25). Bends route leg segments into quadratic bezier curves bulging outward to the left of travel direction (back legs bend opposite). Example: arc: 0.2 curves all legs gently."
    },
    "stations": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional, up to 24) of {id, x, y, lon, lat, label, state, dwell}: id letters, digits and underscore, starting with a letter, max 24 (else s1, s2 by position; a repeated id is left out with a note), x and y in percent of the map (0 to 100, default 50). When a valid ground is active, lon and lat (numbers) can be given instead of x/y and are projected via Web Mercator. dwell: 0 to 0.3, portion of the p dial the route holds at this station before resuming. label max 24 characters (default the id) and state idle, active, done, warn or error (default idle). The state is the settled one: a station on a leg is idle until a leg arrives, active while it is there, then its own state. warn draws an amber pin with \"!\" and error a red pin with \"×\", so colour is never the only cue; the text alternative names every state. A station off every leg simply shows its state. Without stations the map shows a note."
    },
    "route": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional, up to 32) of station ids in order. Each pair draws one straight or arched segment on the ground. An id that is not a station is skipped with a note, and an id repeated straight after itself is ignored. Ignored when legs has at least one valid leg."
    },
    "clock": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (optional) {from, to, unit}. unit \"hhmm\" (default; anything else unknown also means hhmm): from and to as HH:MM, 24-hour, a to earlier than from runs through midnight. unit \"s\" or \"ms\": from and to are whole non-negative numbers (fractions are floored; s up to 86400, ms up to 3600000) and to must not be below from; the chip reads like 480 ms or 1560 s. The chip at the top left counts over p 0.3 to 0.92. Both values must be valid or no chip is drawn."
    },
    "tilt": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "number (optional). Final camera tilt in degrees, 0 (straight down) to 75, default 55. The camera starts straight down and tilts in over p 0 to 0.3."
    },
    "camera": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "object (optional) {from, to, keys, follow, track}. from and to: zoom of the map at p 0 and at the end of the descent, 0.3 to 3, defaults 0.55 and 1. keys: array (up to 8) of {at, turn, tilt, zoom}, poses the camera passes through over the whole film instead of the default descent: at is p (0 to 1, each later than the one before), turn the rotation of the map in degrees (-180 to 180, default 22), tilt 0 to 75, zoom 0.3 to 3; a missing value keeps the previous key's; held before the first key and after the last; bad keys are left out with a note. follow: integer 1 to 6 (used only without keys): after the descent the camera turns to a new angle each time the route arrives at every follow-th station, and swings round and closes in on the last destination (a little closer at each stop). track: 0 to 1, how firmly the camera pans to keep the head of the route (where it is drawing now) at the centre, so the view rides along the journey; default 0.6 with follow, otherwise 0 (no pan). Station pins and labels keep their size and keep facing the viewer at every angle."
    },
    "color": {
     "description": "\"#rrggbb\" (optional). Route and active-station colour. Default the stage accent."
    },
    "legs": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional, up to 4) of {route, color, back}: several legs drawn one after another, replacing route when at least one is valid. route is station ids as in route (a leg needs two known stations, else it is left out with a note); color \"#rrggbb\" (default the atom colour); back true reverses the leg, for a reply going back along the path, and draws it in its own lane beside the outbound leg. The drawing window is shared by all legs in proportion to their length. Segment keys run over all legs (from-to, a repeat gets -2, -3)."
    },
    "messages": {
     "$ref": "common_types.json#/$defs/DynamicValue",
     "description": "array (optional, up to 12) of {leg, text, at, back}: a payload chip that travels along a leg while it is drawn. leg is an index into the drawn legs (default 0); text max 24 characters; at the p (0 to 1) when it sets off (default the leg's own start); back true sends it from the leg's end to its start. A chip is visible only while it travels, so the settled frame shows none; the text alternative lists every message with its start and end station. Bad entries are left out with a note."
    },
    "version": {
     "$ref": "common_types.json#/$defs/DynamicNumber",
     "description": "integer (optional, default 1). 1 and 2 draw the same; a whole number above 2 draws as version 2 with a muted note."
    }
   },
   "required": [
    "component"
   ],
   "x-surfaces": [
    "web",
    "google-apps-script-web",
    "mcp-apps",
    "android"
   ],
   "x-renderers": {"react": "not_measured", "lit": "not_measured", "angular": "not_measured", "copilotkit": "not_measured", "a2ui-vue": "not_measured", "flutter": "not_measured", "compose": "not_measured"},
   "x-routing-text": "A tilted three-dimensional city map scene: camera dropping in over blocks or real map outlines, route legs drawing from stop to stop with the stations lighting up as they arrive, payload chips travelling along the legs, stations ending done, warn or error, and a clock chip counting clock time, seconds or milliseconds. Use it for a journey through a system told spatially: a request trace through gateway, services and database with latency, an AI agent calling an MCP tool and the reply coming back, a CI/CD pipeline with a failed or warning gate, an incident timeline, a data pipeline, failover between regions, as well as a delivery or transit tracker. Not a flat schematic of lines (use motion_path, motion_arch or a flow diagram), not map tiles or a real map provider, not a WebGL scene (use motion_shader), not a chart.",
   "x-intent-phrases": [
    "A tilted 3D city map where the camera drops in and a delivery route draws from stop to stop.",
    "Show a courier route across city blocks with stations turning active then done and a clock counting up.",
    "Animate a transit route on a 3D map with a time chip.",
    "Animate a request moving through the API gateway, auth service and database with a millisecond latency clock, the database hop failing.",
    "Show an AI agent calling an MCP tool on a 3D map: the request leg goes out, the reply comes back in its own lane, payload chips travel along.",
    "A deploy pipeline as a 3D city route from commit to production with the security scan gate flagged as a warning and a seconds clock.",
    "Replay last night's incident as a route through the services that were hit, ending in error and done states.",
    "Animate an international flight path curving across European countries on a 3D map."
   ]
  }
 },
 "functions": {},
 "$defs": {
  "anyComponent": {
   "oneOf": [
    {
     "$ref": "#/components/intro"
    },
    {
     "$ref": "#/components/body"
    },
    {
     "$ref": "#/components/heading"
    },
    {
     "$ref": "#/components/subheading"
    },
    {
     "$ref": "#/components/quote"
    },
    {
     "$ref": "#/components/code"
    },
    {
     "$ref": "#/components/pipeline"
    },
    {
     "$ref": "#/components/bullet_list"
    },
    {
     "$ref": "#/components/divider"
    },
    {
     "$ref": "#/components/youtube"
    },
    {
     "$ref": "#/components/image"
    },
    {
     "$ref": "#/components/image_pair"
    },
    {
     "$ref": "#/components/diagram"
    },
    {
     "$ref": "#/components/github_repo_card"
    },
    {
     "$ref": "#/components/repo_links"
    },
    {
     "$ref": "#/components/closing"
    },
    {
     "$ref": "#/components/callout"
    },
    {
     "$ref": "#/components/steps"
    },
    {
     "$ref": "#/components/table"
    },
    {
     "$ref": "#/components/tabs"
    },
    {
     "$ref": "#/components/key_value"
    },
    {
     "$ref": "#/components/before_after"
    },
    {
     "$ref": "#/components/api_reference"
    },
    {
     "$ref": "#/components/gallery"
    },
    {
     "$ref": "#/components/video_pair"
    },
    {
     "$ref": "#/components/carousel"
    },
    {
     "$ref": "#/components/timeline"
    },
    {
     "$ref": "#/components/annotated_code"
    },
    {
     "$ref": "#/components/sortable_list"
    },
    {
     "$ref": "#/components/photo_grid"
    },
    {
     "$ref": "#/components/photo_stepper"
    },
    {
     "$ref": "#/components/preview_frame"
    },
    {
     "$ref": "#/components/actual_vs_estimate"
    },
    {
     "$ref": "#/components/stat_card"
    },
    {
     "$ref": "#/components/progress_bar"
    },
    {
     "$ref": "#/components/badge_group"
    },
    {
     "$ref": "#/components/sparkline"
    },
    {
     "$ref": "#/components/heatmap"
    },
    {
     "$ref": "#/components/punch_card"
    },
    {
     "$ref": "#/components/sankey_flow"
    },
    {
     "$ref": "#/components/cohort_retention"
    },
    {
     "$ref": "#/components/donut_stat"
    },
    {
     "$ref": "#/components/metric_delta"
    },
    {
     "$ref": "#/components/task_list"
    },
    {
     "$ref": "#/components/sentiment_summary"
    },
    {
     "$ref": "#/components/trend_indicator"
    },
    {
     "$ref": "#/components/breadcrumb"
    },
    {
     "$ref": "#/components/pagination"
    },
    {
     "$ref": "#/components/stepper"
    },
    {
     "$ref": "#/components/tab_bar"
    },
    {
     "$ref": "#/components/anchor_list"
    },
    {
     "$ref": "#/components/faq_accordion"
    },
    {
     "$ref": "#/components/glossary_term"
    },
    {
     "$ref": "#/components/footnote"
    },
    {
     "$ref": "#/components/blockquote_with_avatar"
    },
    {
     "$ref": "#/components/pull_stat"
    },
    {
     "$ref": "#/components/accordion_item"
    },
    {
     "$ref": "#/components/tooltip"
    },
    {
     "$ref": "#/components/hover_card"
    },
    {
     "$ref": "#/components/collapsible_panel"
    },
    {
     "$ref": "#/components/css_modal"
    },
    {
     "$ref": "#/components/audio_player"
    },
    {
     "$ref": "#/components/audio_link"
    },
    {
     "$ref": "#/components/pdf_preview"
    },
    {
     "$ref": "#/components/document_link"
    },
    {
     "$ref": "#/components/video_thumbnail"
    },
    {
     "$ref": "#/components/video_card"
    },
    {
     "$ref": "#/components/code_diff"
    },
    {
     "$ref": "#/components/code_snippet_pair"
    },
    {
     "$ref": "#/components/framed_screenshot"
    },
    {
     "$ref": "#/components/image_with_caption"
    },
    {
     "$ref": "#/components/alert_banner"
    },
    {
     "$ref": "#/components/toast_notification"
    },
    {
     "$ref": "#/components/loading_skeleton"
    },
    {
     "$ref": "#/components/empty_state"
    },
    {
     "$ref": "#/components/spinner"
    },
    {
     "$ref": "#/components/status_pill"
    },
    {
     "$ref": "#/components/inline_feedback_message"
    },
    {
     "$ref": "#/components/rating_stars"
    },
    {
     "$ref": "#/components/progress_circle"
    },
    {
     "$ref": "#/components/action_required_card"
    },
    {
     "$ref": "#/components/feature_matrix"
    },
    {
     "$ref": "#/components/pricing_tier_card"
    },
    {
     "$ref": "#/components/pricing_tier_group"
    },
    {
     "$ref": "#/components/pros_cons_list"
    },
    {
     "$ref": "#/components/side_by_side_spec"
    },
    {
     "$ref": "#/components/product_spec_table"
    },
    {
     "$ref": "#/components/comparison_grid"
    },
    {
     "$ref": "#/components/versus_block"
    },
    {
     "$ref": "#/components/rating_comparison"
    },
    {
     "$ref": "#/components/capability_checklist"
    },
    {
     "$ref": "#/components/toggle_switch"
    },
    {
     "$ref": "#/components/expandable_text"
    },
    {
     "$ref": "#/components/flip_card"
    },
    {
     "$ref": "#/components/image_hotspots"
    },
    {
     "$ref": "#/components/css_dropdown_menu"
    },
    {
     "$ref": "#/components/star_rating_input"
    },
    {
     "$ref": "#/components/segmented_control"
    },
    {
     "$ref": "#/components/zoomable_image"
    },
    {
     "$ref": "#/components/custom_checkbox_group"
    },
    {
     "$ref": "#/components/css_slide_panel"
    },
    {
     "$ref": "#/components/testimonial_card"
    },
    {
     "$ref": "#/components/star_rating_display"
    },
    {
     "$ref": "#/components/avatar_group"
    },
    {
     "$ref": "#/components/contributor_list"
    },
    {
     "$ref": "#/components/customer_logo_grid"
    },
    {
     "$ref": "#/components/social_proof_banner"
    },
    {
     "$ref": "#/components/media_mention_card"
    },
    {
     "$ref": "#/components/expert_endorsement"
    },
    {
     "$ref": "#/components/review_callout"
    },
    {
     "$ref": "#/components/social_feed_embed"
    },
    {
     "$ref": "#/components/terminal_block"
    },
    {
     "$ref": "#/components/file_tree"
    },
    {
     "$ref": "#/components/tabbed_code"
    },
    {
     "$ref": "#/components/http_request_block"
    },
    {
     "$ref": "#/components/env_var_list"
    },
    {
     "$ref": "#/components/prerequisite_checklist"
    },
    {
     "$ref": "#/components/keyboard_shortcut"
    },
    {
     "$ref": "#/components/api_param_table"
    },
    {
     "$ref": "#/components/version_badge"
    },
    {
     "$ref": "#/components/deprecation_notice"
    },
    {
     "$ref": "#/components/experimental_banner"
    },
    {
     "$ref": "#/components/cli_command"
    },
    {
     "$ref": "#/components/copy_code_button"
    },
    {
     "$ref": "#/components/log_output"
    },
    {
     "$ref": "#/components/json_tree_viewer"
    },
    {
     "$ref": "#/components/key_takeaways"
    },
    {
     "$ref": "#/components/summary_box"
    },
    {
     "$ref": "#/components/learning_objectives"
    },
    {
     "$ref": "#/components/changelog_entry"
    },
    {
     "$ref": "#/components/release_notes"
    },
    {
     "$ref": "#/components/further_reading"
    },
    {
     "$ref": "#/components/resources_list"
    },
    {
     "$ref": "#/components/sidebar_note"
    },
    {
     "$ref": "#/components/difficulty_badge"
    },
    {
     "$ref": "#/components/caution_block"
    },
    {
     "$ref": "#/components/checklist_interactive"
    },
    {
     "$ref": "#/components/glossary_inline"
    },
    {
     "$ref": "#/components/time_estimate"
    },
    {
     "$ref": "#/components/progress_checkpoint"
    },
    {
     "$ref": "#/components/social_share_bar"
    },
    {
     "$ref": "#/components/newsletter_cta"
    },
    {
     "$ref": "#/components/author_bio_card"
    },
    {
     "$ref": "#/components/related_posts_grid"
    },
    {
     "$ref": "#/components/series_overview_card"
    },
    {
     "$ref": "#/components/reaction_group"
    },
    {
     "$ref": "#/components/linkedin_post_image"
    },
    {
     "$ref": "#/components/weighted_words"
    },
    {
     "$ref": "#/components/stance"
    },
    {
     "$ref": "#/components/receipt"
    },
    {
     "$ref": "#/components/changed_mind"
    },
    {
     "$ref": "#/components/type_scale"
    },
    {
     "$ref": "#/components/readability_card"
    },
    {
     "$ref": "#/components/drop_cap"
    },
    {
     "$ref": "#/components/contrast_audit"
    },
    {
     "$ref": "#/components/share_quote"
    },
    {
     "$ref": "#/components/follow_cta"
    },
    {
     "$ref": "#/components/follow_button"
    },
    {
     "$ref": "#/components/reading_progress_bar"
    },
    {
     "$ref": "#/components/table_of_contents"
    },
    {
     "$ref": "#/components/article_hero"
    },
    {
     "$ref": "#/components/scroll_to_top"
    },
    {
     "$ref": "#/components/article_series_nav"
    },
    {
     "$ref": "#/components/embed_codepen"
    },
    {
     "$ref": "#/components/embed_stackblitz"
    },
    {
     "$ref": "#/components/embed_gist"
    },
    {
     "$ref": "#/components/embed_tweet"
    },
    {
     "$ref": "#/components/embed_google_slides"
    },
    {
     "$ref": "#/components/lottie_animation"
    },
    {
     "$ref": "#/components/figma_embed"
    },
    {
     "$ref": "#/components/color_swatch_grid"
    },
    {
     "$ref": "#/components/live_demo_embed"
    },
    {
     "$ref": "#/components/benchmark_comparison"
    },
    {
     "$ref": "#/components/chartjs_bar"
    },
    {
     "$ref": "#/components/chartjs_line"
    },
    {
     "$ref": "#/components/data_table_sortable"
    },
    {
     "$ref": "#/components/metric_comparison_card"
    },
    {
     "$ref": "#/components/mini_sparkline_set"
    },
    {
     "$ref": "#/components/status_dashboard"
    },
    {
     "$ref": "#/components/uptime_timeline"
    },
    {
     "$ref": "#/components/command_palette"
    },
    {
     "$ref": "#/components/search_result_card"
    },
    {
     "$ref": "#/components/post_metadata_bar"
    },
    {
     "$ref": "#/components/footnote_group"
    },
    {
     "$ref": "#/components/notification_badge"
    },
    {
     "$ref": "#/components/expandable_list"
    },
    {
     "$ref": "#/components/poll_block"
    },
    {
     "$ref": "#/components/abbr_tooltip"
    },
    {
     "$ref": "#/components/copy_to_clipboard"
    },
    {
     "$ref": "#/components/conversion_funnel"
    },
    {
     "$ref": "#/components/gauge_sla"
    },
    {
     "$ref": "#/components/masonry_elevation"
    },
    {
     "$ref": "#/components/stacked_area"
    },
    {
     "$ref": "#/components/calibration_plot"
    },
    {
     "$ref": "#/components/scatter_trend"
    },
    {
     "$ref": "#/components/call_mood_board"
    },
    {
     "$ref": "#/components/github_activity_grid"
    },
    {
     "$ref": "#/components/form"
    },
    {
     "$ref": "#/components/form_input"
    },
    {
     "$ref": "#/components/form_select"
    },
    {
     "$ref": "#/components/form_radio_group"
    },
    {
     "$ref": "#/components/form_checkbox_group"
    },
    {
     "$ref": "#/components/form_switch_group"
    },
    {
     "$ref": "#/components/form_slider"
    },
    {
     "$ref": "#/components/form_date_picker"
    },
    {
     "$ref": "#/components/modal"
    },
    {
     "$ref": "#/components/follow_up_chips"
    },
    {
     "$ref": "#/components/choicebox_group"
    },
    {
     "$ref": "#/components/feedback_prompt"
    },
    {
     "$ref": "#/components/entity_list"
    },
    {
     "$ref": "#/components/prompt_template"
    },
    {
     "$ref": "#/components/model_card"
    },
    {
     "$ref": "#/components/conversation_snippet"
    },
    {
     "$ref": "#/components/shortcut_legend"
    },
    {
     "$ref": "#/components/rating_summary_bar"
    },
    {
     "$ref": "#/components/roadmap_card"
    },
    {
     "$ref": "#/components/notification_stack"
    },
    {
     "$ref": "#/components/inline_alert"
    },
    {
     "$ref": "#/components/tag_block"
    },
    {
     "$ref": "#/components/variant_selector"
    },
    {
     "$ref": "#/components/markdown_block"
    },
    {
     "$ref": "#/components/chartjs_pie"
    },
    {
     "$ref": "#/components/text_callout"
    },
    {
     "$ref": "#/components/source_citation"
    },
    {
     "$ref": "#/components/llm_comparison_table"
    },
    {
     "$ref": "#/components/confidence_bar"
    },
    {
     "$ref": "#/components/token_budget_meter"
    },
    {
     "$ref": "#/components/product_thumbnail"
    },
    {
     "$ref": "#/components/order_status_card"
    },
    {
     "$ref": "#/components/inventory_table"
    },
    {
     "$ref": "#/components/jira_ticket"
    },
    {
     "$ref": "#/components/sprint_board"
    },
    {
     "$ref": "#/components/lozenge"
    },
    {
     "$ref": "#/components/data_grid"
    },
    {
     "$ref": "#/components/tree_view"
    },
    {
     "$ref": "#/components/heatmap_calendar"
    },
    {
     "$ref": "#/components/combobox"
    },
    {
     "$ref": "#/components/feature_grid"
    },
    {
     "$ref": "#/components/navigation_menu"
    },
    {
     "$ref": "#/components/multi_select_input"
    },
    {
     "$ref": "#/components/otp_input"
    },
    {
     "$ref": "#/components/skill_bars"
    },
    {
     "$ref": "#/components/icon_stat_row"
    },
    {
     "$ref": "#/components/color_section"
    },
    {
     "$ref": "#/components/tag_cloud"
    },
    {
     "$ref": "#/components/step_progress"
    },
    {
     "$ref": "#/components/split_pane"
    },
    {
     "$ref": "#/components/gradient_hero"
    },
    {
     "$ref": "#/components/icon_list"
    },
    {
     "$ref": "#/components/highlight_box"
    },
    {
     "$ref": "#/components/two_tone_card"
    },
    {
     "$ref": "#/components/metric_row"
    },
    {
     "$ref": "#/components/numbered_list"
    },
    {
     "$ref": "#/components/page_header"
    },
    {
     "$ref": "#/components/back_button"
    },
    {
     "$ref": "#/components/section_break"
    },
    {
     "$ref": "#/components/chip_group"
    },
    {
     "$ref": "#/components/filterable_list"
    },
    {
     "$ref": "#/components/columns"
    },
    {
     "$ref": "#/components/person_card"
    },
    {
     "$ref": "#/components/agenda_block"
    },
    {
     "$ref": "#/components/risk_flag"
    },
    {
     "$ref": "#/components/action_items"
    },
    {
     "$ref": "#/components/bento_grid"
    },
    {
     "$ref": "#/components/cta_section"
    },
    {
     "$ref": "#/components/animated_counter"
    },
    {
     "$ref": "#/components/media_stream_card"
    },
    {
     "$ref": "#/components/live_aggregator"
    },
    {
     "$ref": "#/components/vote_button_group"
    },
    {
     "$ref": "#/components/effect_overlay"
    },
    {
     "$ref": "#/components/skeleton_stage_card"
    },
    {
     "$ref": "#/components/marquee_strip"
    },
    {
     "$ref": "#/components/typewriter_text"
    },
    {
     "$ref": "#/components/animated_border_card"
    },
    {
     "$ref": "#/components/aurora_background"
    },
    {
     "$ref": "#/components/flow_field"
    },
    {
     "$ref": "#/components/particle_type"
    },
    {
     "$ref": "#/components/light_type"
    },
    {
     "$ref": "#/components/living_type"
    },
    {
     "$ref": "#/components/orbit_mark"
    },
    {
     "$ref": "#/components/halftone_wave"
    },
    {
     "$ref": "#/components/message_lanes"
    },
    {
     "$ref": "#/components/signal_tunnel"
    },
    {
     "$ref": "#/components/gradient_mesh_live"
    },
    {
     "$ref": "#/components/wave_terrain"
    },
    {
     "$ref": "#/components/orbit_rings"
    },
    {
     "$ref": "#/components/motion_timeline"
    },
    {
     "$ref": "#/components/motion_group"
    },
    {
     "$ref": "#/components/motion_tokens"
    },
    {
     "$ref": "#/components/motion_layer"
    },
    {
     "$ref": "#/components/motion_text"
    },
    {
     "$ref": "#/components/motion_shape"
    },
    {
     "$ref": "#/components/motion_counter"
    },
    {
     "$ref": "#/components/motion_pill"
    },
    {
     "$ref": "#/components/motion_checklist"
    },
    {
     "$ref": "#/components/motion_orbit"
    },
    {
     "$ref": "#/components/motion_code"
    },
    {
     "$ref": "#/components/motion_mark"
    },
    {
     "$ref": "#/components/motion_browser"
    },
    {
     "$ref": "#/components/motion_sketch"
    },
    {
     "$ref": "#/components/motion_leader"
    },
    {
     "$ref": "#/components/motion_mask"
    },
    {
     "$ref": "#/components/motion_envelope"
    },
    {
     "$ref": "#/components/motion_rays"
    },
    {
     "$ref": "#/components/motion_hud"
    },
    {
     "$ref": "#/components/motion_lower_third"
    },
    {
     "$ref": "#/components/motion_finish"
    },
    {
     "$ref": "#/components/motion_arch"
    },
    {
     "$ref": "#/components/motion_video"
    },
    {
     "$ref": "#/components/motion_shader"
    },
    {
     "$ref": "#/components/motion_bricks"
    },
    {
     "$ref": "#/components/block_robot"
    },
    {
     "$ref": "#/components/block_rocket"
    },
    {
     "$ref": "#/components/dot_grid_background"
    },
    {
     "$ref": "#/components/shimmer_button"
    },
    {
     "$ref": "#/components/card_stack"
    },
    {
     "$ref": "#/components/meteor_shower"
    },
    {
     "$ref": "#/components/blur_fade_in"
    },
    {
     "$ref": "#/components/glow_button"
    },
    {
     "$ref": "#/components/animated_beam"
    },
    {
     "$ref": "#/components/encrypted_reveal"
    },
    {
     "$ref": "#/components/word_flip"
    },
    {
     "$ref": "#/components/sonar_pulse"
    },
    {
     "$ref": "#/components/typewriter"
    },
    {
     "$ref": "#/components/number_odometer"
    },
    {
     "$ref": "#/components/typing_indicator"
    },
    {
     "$ref": "#/components/countdown_timer"
    },
    {
     "$ref": "#/components/gradient_text"
    },
    {
     "$ref": "#/components/reveal_on_scroll"
    },
    {
     "$ref": "#/components/word_scramble"
    },
    {
     "$ref": "#/components/svg_path_draw"
    },
    {
     "$ref": "#/components/agent_sketchpad"
    },
    {
     "$ref": "#/components/parallax_card"
    },
    {
     "$ref": "#/components/quiz_question"
    },
    {
     "$ref": "#/components/fill_in_blank"
    },
    {
     "$ref": "#/components/match_exercise"
    },
    {
     "$ref": "#/components/hint_reveal"
    },
    {
     "$ref": "#/components/achievement_badge"
    },
    {
     "$ref": "#/components/score_summary"
    },
    {
     "$ref": "#/components/xp_bar"
    },
    {
     "$ref": "#/components/lesson_nav"
    },
    {
     "$ref": "#/components/course_progress_card"
    },
    {
     "$ref": "#/components/highlighted_text"
    },
    {
     "$ref": "#/components/drive_file_list"
    },
    {
     "$ref": "#/components/sheet_preview"
    },
    {
     "$ref": "#/components/gmail_summary"
    },
    {
     "$ref": "#/components/calendar_upcoming"
    },
    {
     "$ref": "#/components/user_greeting"
    },
    {
     "$ref": "#/components/script_run_button"
    },
    {
     "$ref": "#/components/calendar_today"
    },
    {
     "$ref": "#/components/sheet_stats"
    },
    {
     "$ref": "#/components/gmail_unread_count"
    },
    {
     "$ref": "#/components/user_profile_card"
    },
    {
     "$ref": "#/components/drive_storage_usage"
    },
    {
     "$ref": "#/components/sheet_form_submit"
    },
    {
     "$ref": "#/components/tasks_today"
    },
    {
     "$ref": "#/components/cursor_glow"
    },
    {
     "$ref": "#/components/cursor_trail"
    },
    {
     "$ref": "#/components/particle_burst"
    },
    {
     "$ref": "#/components/spotlight_cursor"
    },
    {
     "$ref": "#/components/magnetic_element"
    },
    {
     "$ref": "#/components/tilt_card"
    },
    {
     "$ref": "#/components/doc_ai_summary"
    },
    {
     "$ref": "#/components/multi_doc_ai_brief"
    },
    {
     "$ref": "#/components/gradient_heading"
    },
    {
     "$ref": "#/components/display_quote"
    },
    {
     "$ref": "#/components/split_stat"
    },
    {
     "$ref": "#/components/word_reveal"
    },
    {
     "$ref": "#/components/section_label"
    },
    {
     "$ref": "#/components/count_up_stat"
    },
    {
     "$ref": "#/components/text_highlight"
    },
    {
     "$ref": "#/components/reveal_line"
    },
    {
     "$ref": "#/components/canvas_plexus"
    },
    {
     "$ref": "#/components/brick_build_3d"
    },
    {
     "$ref": "#/components/spring_nodes"
    },
    {
     "$ref": "#/components/isometric_mesh"
    },
    {
     "$ref": "#/components/geo_iso_takeoff"
    },
    {
     "$ref": "#/components/geo_iso_rocket_launch"
    },
    {
     "$ref": "#/components/geo_iso_heli_hover"
    },
    {
     "$ref": "#/components/geo_iso_fleet"
    },
    {
     "$ref": "#/components/airspace_command_deck"
    },
    {
     "$ref": "#/components/data_source"
    },
    {
     "$ref": "#/components/adsb_feed"
    },
    {
     "$ref": "#/components/metar_feed"
    },
    {
     "$ref": "#/components/firestore_read"
    },
    {
     "$ref": "#/components/paragraph"
    },
    {
     "$ref": "#/components/text_block"
    },
    {
     "$ref": "#/components/blockquote"
    },
    {
     "$ref": "#/components/spacer"
    },
    {
     "$ref": "#/components/tag_chip"
    },
    {
     "$ref": "#/components/badge"
    },
    {
     "$ref": "#/components/inline_code"
    },
    {
     "$ref": "#/components/code_block"
    },
    {
     "$ref": "#/components/link_button"
    },
    {
     "$ref": "#/components/cta_button"
    },
    {
     "$ref": "#/components/nav_link"
    },
    {
     "$ref": "#/components/info_card"
    },
    {
     "$ref": "#/components/ai_build_trace"
    },
    {
     "$ref": "#/components/gemini_prompt"
    },
    {
     "$ref": "#/components/dark_hero"
    },
    {
     "$ref": "#/components/glowing_stat"
    },
    {
     "$ref": "#/components/glass_card"
    },
    {
     "$ref": "#/components/gradient_border_card"
    },
    {
     "$ref": "#/components/floating_orbs"
    },
    {
     "$ref": "#/components/neon_text"
    },
    {
     "$ref": "#/components/dark_feature_grid"
    },
    {
     "$ref": "#/components/dark_divider"
    },
    {
     "$ref": "#/components/ambient_gradient"
    },
    {
     "$ref": "#/components/depth_stack"
    },
    {
     "$ref": "#/components/scramble_reveal"
    },
    {
     "$ref": "#/components/scroll_trigger"
    },
    {
     "$ref": "#/components/flow_connector"
    },
    {
     "$ref": "#/components/live_metric"
    },
    {
     "$ref": "#/components/deadline_ticker"
    },
    {
     "$ref": "#/components/pattern_background"
    },
    {
     "$ref": "#/components/glitch_text"
    },
    {
     "$ref": "#/components/neon_glow"
    },
    {
     "$ref": "#/components/magnetic_button"
    },
    {
     "$ref": "#/components/confetti_trigger"
    },
    {
     "$ref": "#/components/floating_particles"
    },
    {
     "$ref": "#/components/parallax_section"
    },
    {
     "$ref": "#/components/scroll_progress"
    },
    {
     "$ref": "#/components/live_clock"
    },
    {
     "$ref": "#/components/decision_tree"
    },
    {
     "$ref": "#/components/step_reveal_sequence"
    },
    {
     "$ref": "#/components/sequence_diagram"
    },
    {
     "$ref": "#/components/chat_sequence"
    },
    {
     "$ref": "#/components/tooltip_glossary"
    },
    {
     "$ref": "#/components/focus_lens"
    },
    {
     "$ref": "#/components/terminal_boot"
    },
    {
     "$ref": "#/components/stagger_list"
    },
    {
     "$ref": "#/components/liquid_button"
    },
    {
     "$ref": "#/components/highlight_sweep"
    },
    {
     "$ref": "#/components/progress_reveal"
    },
    {
     "$ref": "#/components/big_reveal"
    },
    {
     "$ref": "#/components/kinetic_headline"
    },
    {
     "$ref": "#/components/text_reveal_mask"
    },
    {
     "$ref": "#/components/split_reveal"
    },
    {
     "$ref": "#/components/mesh_gradient"
    },
    {
     "$ref": "#/components/stripe_background"
    },
    {
     "$ref": "#/components/status_timeline"
    },
    {
     "$ref": "#/components/counter_group"
    },
    {
     "$ref": "#/components/orbit_diagram"
    },
    {
     "$ref": "#/components/noise_card"
    },
    {
     "$ref": "#/components/comparison_morph"
    },
    {
     "$ref": "#/components/word_cloud"
    },
    {
     "$ref": "#/components/quiz_set"
    },
    {
     "$ref": "#/components/globe_3d"
    },
    {
     "$ref": "#/components/geo_mercator_radar"
    },
    {
     "$ref": "#/components/geo_contour_waves"
    },
    {
     "$ref": "#/components/multi_surface"
    },
    {
     "$ref": "#/components/geo_europe_airspace"
    },
    {
     "$ref": "#/components/feed_status"
    },
    {
     "$ref": "#/components/playbook"
    },
    {
     "$ref": "#/components/surface_unlocked"
    },
    {
     "$ref": "#/components/schema_reveal"
    },
    {
     "$ref": "#/components/url_anatomy"
    },
    {
     "$ref": "#/components/schema_qr"
    },
    {
     "$ref": "#/components/take_away_card"
    },
    {
     "$ref": "#/components/next_step_strip"
    },
    {
     "$ref": "#/components/copy_prompt"
    },
    {
     "$ref": "#/components/atom_anatomy"
    },
    {
     "$ref": "#/components/renderer_stats"
    },
    {
     "$ref": "#/components/prompt_to_schema"
    },
    {
     "$ref": "#/components/before_after_stack"
    },
    {
     "$ref": "#/components/live_vote"
    },
    {
     "$ref": "#/components/reaction_shower"
    },
    {
     "$ref": "#/components/raise_hand"
    },
    {
     "$ref": "#/components/surface_map"
    },
    {
     "$ref": "#/components/speed_counter"
    },
    {
     "$ref": "#/components/live_edit"
    },
    {
     "$ref": "#/components/gmail_inbox"
    },
    {
     "$ref": "#/components/drive_recent_files"
    },
    {
     "$ref": "#/components/drive_folder_contents"
    },
    {
     "$ref": "#/components/drive_file_card"
    },
    {
     "$ref": "#/components/progress_store"
    },
    {
     "$ref": "#/components/module_map"
    },
    {
     "$ref": "#/components/knowledge_check"
    },
    {
     "$ref": "#/components/quiz_result_summary"
    },
    {
     "$ref": "#/components/scenario_branch"
    },
    {
     "$ref": "#/components/completion_gate"
    },
    {
     "$ref": "#/components/certification_card"
    },
    {
     "$ref": "#/components/skill_radar"
    },
    {
     "$ref": "#/components/badge_showcase"
    },
    {
     "$ref": "#/components/learning_path_selector"
    },
    {
     "$ref": "#/components/video_checkpoint"
    },
    {
     "$ref": "#/components/cohort_progress_board"
    },
    {
     "$ref": "#/components/reflection_prompt"
    },
    {
     "$ref": "#/components/annotation_highlight"
    },
    {
     "$ref": "#/components/onboarding_stepper"
    },
    {
     "$ref": "#/components/case_study_card"
    },
    {
     "$ref": "#/components/study_timer"
    },
    {
     "$ref": "#/components/rubric_card"
    },
    {
     "$ref": "#/components/spaced_repetition_card"
    },
    {
     "$ref": "#/components/leaderboard_card"
    },
    {
     "$ref": "#/components/nav_bar"
    },
    {
     "$ref": "#/components/palette"
    },
    {
     "$ref": "#/components/print_button"
    },
    {
     "$ref": "#/components/drive_image"
    },
    {
     "$ref": "#/components/maps_embed"
    },
    {
     "$ref": "#/components/sheet_form"
    },
    {
     "$ref": "#/components/reveal"
    },
    {
     "$ref": "#/components/skeleton"
    },
    {
     "$ref": "#/components/marquee"
    },
    {
     "$ref": "#/components/pulse_dot"
    },
    {
     "$ref": "#/components/loading_dots"
    },
    {
     "$ref": "#/components/progress_ring"
    },
    {
     "$ref": "#/components/confetti_burst"
    },
    {
     "$ref": "#/components/ripple_button"
    },
    {
     "$ref": "#/components/wave_divider"
    },
    {
     "$ref": "#/components/floating_badge"
    },
    {
     "$ref": "#/components/shimmer_text"
    },
    {
     "$ref": "#/components/number_flip"
    },
    {
     "$ref": "#/components/spotlight_card"
    },
    {
     "$ref": "#/components/animated_border"
    },
    {
     "$ref": "#/components/countdown_ring"
    },
    {
     "$ref": "#/components/google_icon"
    },
    {
     "$ref": "#/components/icon_badge"
    },
    {
     "$ref": "#/components/icon_row"
    },
    {
     "$ref": "#/components/workspace_logo"
    },
    {
     "$ref": "#/components/workspace_logo_strip"
    },
    {
     "$ref": "#/components/workspace_logo_grid"
    },
    {
     "$ref": "#/components/icon_feature_grid"
    },
    {
     "$ref": "#/components/icon_checklist"
    },
    {
     "$ref": "#/components/hub"
    },
    {
     "$ref": "#/components/jump_nav"
    },
    {
     "$ref": "#/components/command_step"
    },
    {
     "$ref": "#/components/form_textarea"
    },
    {
     "$ref": "#/components/flashcard_deck"
    },
    {
     "$ref": "#/components/brevet_timeline"
    },
    {
     "$ref": "#/components/me"
    },
    {
     "$ref": "#/components/theme_toggle"
    },
    {
     "$ref": "#/components/tool_tile"
    },
    {
     "$ref": "#/components/lens_grid"
    },
    {
     "$ref": "#/components/domain_picker"
    },
    {
     "$ref": "#/components/tab_group"
    },
    {
     "$ref": "#/components/quiet_link"
    },
    {
     "$ref": "#/components/gdm_rocket_panel"
    },
    {
     "$ref": "#/components/content_tabs"
    },
    {
     "$ref": "#/components/math_block"
    },
    {
     "$ref": "#/components/service_status_board"
    },
    {
     "$ref": "#/components/incident_log"
    },
    {
     "$ref": "#/components/stat_pulse"
    },
    {
     "$ref": "#/components/weather_now"
    },
    {
     "$ref": "#/components/weather_outlook"
    },
    {
     "$ref": "#/components/concept_ladder"
    },
    {
     "$ref": "#/components/concept_rung"
    },
    {
     "$ref": "#/components/layer_stack"
    },
    {
     "$ref": "#/components/stack_layer"
    },
    {
     "$ref": "#/components/tool_call_card"
    },
    {
     "$ref": "#/components/scene_stage"
    },
    {
     "$ref": "#/components/clipart"
    },
    {
     "$ref": "#/components/treemap"
    },
    {
     "$ref": "#/components/histogram"
    },
    {
     "$ref": "#/components/box_plot"
    },
    {
     "$ref": "#/components/waterfall"
    },
    {
     "$ref": "#/components/sunburst"
    },
    {
     "$ref": "#/components/chord_diagram"
    },
    {
     "$ref": "#/components/circle_pack"
    },
    {
     "$ref": "#/components/arc_diagram"
    },
    {
     "$ref": "#/components/contour_plot"
    },
    {
     "$ref": "#/components/voronoi"
    },
    {
     "$ref": "#/components/candlestick_chart"
    },
    {
     "$ref": "#/components/parallel_coords"
    },
    {
     "$ref": "#/components/ternary_plot"
    },
    {
     "$ref": "#/components/quiver"
    },
    {
     "$ref": "#/components/choropleth_map"
    },
    {
     "$ref": "#/components/geo_map"
    },
    {
     "$ref": "#/components/polar_chart"
    },
    {
     "$ref": "#/components/histogram2d"
    },
    {
     "$ref": "#/components/scatter_matrix"
    },
    {
     "$ref": "#/components/motion_transition"
    },
    {
     "$ref": "#/components/motion_map3d"
    }
   ],
   "discriminator": {
    "propertyName": "component"
   }
  },
  "anyFunction": {
   "not": {}
  }
 }
}
