@ziyarago/ui 0.8.0 → 0.9.0

package/dist/manifest.json

@@ -1,6 +1,6 @@
 {
  "name": "@ziyarago/ui",
- "version": "0.8.0",
+ "version": "0.9.0",
  "homepage": "https://ziyara.vip",
  "imports": {
   "vue": "import { UiButton } from '@ziyarago/ui/vue'",
@@ -282,6 +282,13 @@
     "PageTeam",
     "PageIntegrations",
     "PageSearch",
+    "PageArticle",
+    "PageChangelog",
+    "PageHelp",
+    "PageStates",
+    "PageLegal",
+    "PageLocations",
+    "PageBookingFlow",
     "PageNotifications",
     "PageInbox",
     "PageCheckout",
@@ -4071,6 +4078,827 @@
       "use": "<UiEmptyState icon=\"search-x\" title=\"No results\" />"
      }
     ]
+   },
+   {
+    "id": "article",
+    "label": "Article",
+    "component": "UiPageArticle",
+    "description": "Blog article: cover, title and author, body with a table of contents, share row and related posts.",
+    "shell": true,
+    "slots": [
+     {
+      "id": "header",
+      "title": "Page heading",
+      "desc": "Breadcrumbs, heading, caption and action buttons on the right.",
+      "accepts": [
+       "PageHeader",
+       "Breadcrumbs",
+       "Button",
+       "SegmentedControl"
+      ],
+      "props": [
+       {
+        "name": "title",
+        "type": "string",
+        "desc": "H1, up to 60 characters"
+       },
+       {
+        "name": "subtitle",
+        "type": "string?",
+        "desc": "Gray caption below the heading"
+       },
+       {
+        "name": "crumbs",
+        "type": "{label,href?}[]",
+        "desc": "Breadcrumbs"
+       },
+       {
+        "name": "actions",
+        "type": "VNode",
+        "desc": "Buttons on the right; wrap below on a narrow screen"
+       }
+      ],
+      "use": "<UiPageHeader title=\"Dashboard\" :crumbs=\"crumbs\">\n  <template #actions><UiButton variant=\"primary\">Export</UiButton></template>\n</UiPageHeader>"
+     },
+     {
+      "id": "cover",
+      "title": "Cover",
+      "desc": "Cover with category, title, author and reading time.",
+      "accepts": [
+       "Card",
+       "Chip",
+       "Avatar",
+       "LazyImage"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiCard>…</UiCard>"
+     },
+     {
+      "id": "body",
+      "title": "Article body",
+      "desc": "Headings, paragraphs, quote and code.",
+      "accepts": [
+       "Heading",
+       "Text",
+       "Code",
+       "Alert"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiHeading level=\"2\">…</UiHeading>"
+     },
+     {
+      "id": "toc",
+      "title": "Table of contents",
+      "desc": "Sticky list of section links.",
+      "accepts": [
+       "Card",
+       "Link"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiCard title=\"On this page\">…</UiCard>"
+     },
+     {
+      "id": "share",
+      "title": "Share",
+      "desc": "Share buttons and copy link.",
+      "accepts": [
+       "Button",
+       "IconButton",
+       "CopyButton"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiCopyButton :value=\"url\" />"
+     },
+     {
+      "id": "related",
+      "title": "Related posts",
+      "desc": "Cards with other posts.",
+      "accepts": [
+       "Card",
+       "Chip"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiCard>…</UiCard>"
+     }
+    ]
+   },
+   {
+    "id": "changelog",
+    "label": "Changelog",
+    "component": "UiPageChangelog",
+    "description": "Changelog: release timeline grouped by version with new, fix and improved tags, a filter and subscribe.",
+    "shell": true,
+    "slots": [
+     {
+      "id": "header",
+      "title": "Page heading",
+      "desc": "Breadcrumbs, heading, caption and action buttons on the right.",
+      "accepts": [
+       "PageHeader",
+       "Breadcrumbs",
+       "Button",
+       "SegmentedControl"
+      ],
+      "props": [
+       {
+        "name": "title",
+        "type": "string",
+        "desc": "H1, up to 60 characters"
+       },
+       {
+        "name": "subtitle",
+        "type": "string?",
+        "desc": "Gray caption below the heading"
+       },
+       {
+        "name": "crumbs",
+        "type": "{label,href?}[]",
+        "desc": "Breadcrumbs"
+       },
+       {
+        "name": "actions",
+        "type": "VNode",
+        "desc": "Buttons on the right; wrap below on a narrow screen"
+       }
+      ],
+      "use": "<UiPageHeader title=\"Dashboard\" :crumbs=\"crumbs\">\n  <template #actions><UiButton variant=\"primary\">Export</UiButton></template>\n</UiPageHeader>"
+     },
+     {
+      "id": "filters",
+      "title": "Filters",
+      "desc": "Tag filter and search.",
+      "accepts": [
+       "FilterChips",
+       "SearchInput"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiFilterChips v-model=\"tag\" :items=\"tags\" />"
+     },
+     {
+      "id": "timeline",
+      "title": "Release timeline",
+      "desc": "Versions with date and tagged changes.",
+      "accepts": [
+       "Card",
+       "Chip",
+       "Divider"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiCard>…</UiCard>"
+     },
+     {
+      "id": "subscribe",
+      "title": "Subscribe",
+      "desc": "Email field to get release notes.",
+      "accepts": [
+       "Card",
+       "TextField",
+       "Button"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiCard title=\"Get updates\">…</UiCard>"
+     }
+    ]
+   },
+   {
+    "id": "help",
+    "label": "Help center",
+    "component": "UiPageHelp",
+    "description": "Help center home: search, category tiles, popular articles and contact.",
+    "shell": true,
+    "slots": [
+     {
+      "id": "header",
+      "title": "Page heading",
+      "desc": "Breadcrumbs, heading, caption and action buttons on the right.",
+      "accepts": [
+       "PageHeader",
+       "Breadcrumbs",
+       "Button",
+       "SegmentedControl"
+      ],
+      "props": [
+       {
+        "name": "title",
+        "type": "string",
+        "desc": "H1, up to 60 characters"
+       },
+       {
+        "name": "subtitle",
+        "type": "string?",
+        "desc": "Gray caption below the heading"
+       },
+       {
+        "name": "crumbs",
+        "type": "{label,href?}[]",
+        "desc": "Breadcrumbs"
+       },
+       {
+        "name": "actions",
+        "type": "VNode",
+        "desc": "Buttons on the right; wrap below on a narrow screen"
+       }
+      ],
+      "use": "<UiPageHeader title=\"Dashboard\" :crumbs=\"crumbs\">\n  <template #actions><UiButton variant=\"primary\">Export</UiButton></template>\n</UiPageHeader>"
+     },
+     {
+      "id": "search",
+      "title": "Search",
+      "desc": "Large search field.",
+      "accepts": [
+       "SearchInput"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiSearchInput size=\"lg\" />"
+     },
+     {
+      "id": "categories",
+      "title": "Categories",
+      "desc": "Grid of category tiles.",
+      "accepts": [
+       "Card",
+       "IconTile"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiCard>…</UiCard>"
+     },
+     {
+      "id": "popular",
+      "title": "Popular articles",
+      "desc": "List of top articles.",
+      "accepts": [
+       "Card",
+       "Link",
+       "Chip"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiCard title=\"Popular\">…</UiCard>"
+     },
+     {
+      "id": "contact",
+      "title": "Contact",
+      "desc": "Ways to reach support.",
+      "accepts": [
+       "Card",
+       "Button",
+       "IconTile"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiCard title=\"Still need help?\">…</UiCard>"
+     }
+    ]
+   },
+   {
+    "id": "states",
+    "label": "States",
+    "component": "UiPageStates",
+    "description": "State gallery: empty, no results, no permission, offline, error with retry, loading and success.",
+    "shell": true,
+    "slots": [
+     {
+      "id": "header",
+      "title": "Page heading",
+      "desc": "Breadcrumbs, heading, caption and action buttons on the right.",
+      "accepts": [
+       "PageHeader",
+       "Breadcrumbs",
+       "Button",
+       "SegmentedControl"
+      ],
+      "props": [
+       {
+        "name": "title",
+        "type": "string",
+        "desc": "H1, up to 60 characters"
+       },
+       {
+        "name": "subtitle",
+        "type": "string?",
+        "desc": "Gray caption below the heading"
+       },
+       {
+        "name": "crumbs",
+        "type": "{label,href?}[]",
+        "desc": "Breadcrumbs"
+       },
+       {
+        "name": "actions",
+        "type": "VNode",
+        "desc": "Buttons on the right; wrap below on a narrow screen"
+       }
+      ],
+      "use": "<UiPageHeader title=\"Dashboard\" :crumbs=\"crumbs\">\n  <template #actions><UiButton variant=\"primary\">Export</UiButton></template>\n</UiPageHeader>"
+     },
+     {
+      "id": "empty",
+      "title": "Empty list",
+      "desc": "First-use empty state with an action.",
+      "accepts": [
+       "EmptyState",
+       "Button"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiEmptyState icon=\"inbox\" title=\"Nothing here yet\" />"
+     },
+     {
+      "id": "noresults",
+      "title": "No results",
+      "desc": "Search found nothing.",
+      "accepts": [
+       "EmptyState",
+       "Button"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiEmptyState icon=\"search-x\" title=\"No results\" />"
+     },
+     {
+      "id": "forbidden",
+      "title": "No permission",
+      "desc": "Access denied.",
+      "accepts": [
+       "EmptyState",
+       "Button"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiEmptyState icon=\"lock\" title=\"No access\" />"
+     },
+     {
+      "id": "offline",
+      "title": "Offline",
+      "desc": "No connection.",
+      "accepts": [
+       "DataState"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiDataState state=\"offline\" />"
+     },
+     {
+      "id": "error",
+      "title": "Error",
+      "desc": "Failure with a retry button.",
+      "accepts": [
+       "DataState",
+       "Alert"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiDataState state=\"error\" />"
+     },
+     {
+      "id": "loading",
+      "title": "Loading",
+      "desc": "Skeleton placeholders.",
+      "accepts": [
+       "Skeleton",
+       "DataState"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiSkeleton />"
+     },
+     {
+      "id": "success",
+      "title": "Success",
+      "desc": "Confirmation after an action.",
+      "accepts": [
+       "Alert",
+       "EmptyState"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiAlert tone=\"success\" title=\"Saved\" />"
+     }
+    ]
+   },
+   {
+    "id": "legal",
+    "label": "Legal",
+    "component": "UiPageLegal",
+    "description": "Legal document: last updated, sticky table of contents, sections, print and download.",
+    "shell": true,
+    "slots": [
+     {
+      "id": "header",
+      "title": "Page heading",
+      "desc": "Breadcrumbs, heading, caption and action buttons on the right.",
+      "accepts": [
+       "PageHeader",
+       "Breadcrumbs",
+       "Button",
+       "SegmentedControl"
+      ],
+      "props": [
+       {
+        "name": "title",
+        "type": "string",
+        "desc": "H1, up to 60 characters"
+       },
+       {
+        "name": "subtitle",
+        "type": "string?",
+        "desc": "Gray caption below the heading"
+       },
+       {
+        "name": "crumbs",
+        "type": "{label,href?}[]",
+        "desc": "Breadcrumbs"
+       },
+       {
+        "name": "actions",
+        "type": "VNode",
+        "desc": "Buttons on the right; wrap below on a narrow screen"
+       }
+      ],
+      "use": "<UiPageHeader title=\"Dashboard\" :crumbs=\"crumbs\">\n  <template #actions><UiButton variant=\"primary\">Export</UiButton></template>\n</UiPageHeader>"
+     },
+     {
+      "id": "meta",
+      "title": "Meta",
+      "desc": "Version, last updated and document actions.",
+      "accepts": [
+       "Chip",
+       "Button"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiChip>Last updated 12 Mar 2026</UiChip>"
+     },
+     {
+      "id": "toc",
+      "title": "Table of contents",
+      "desc": "Sticky list of section links.",
+      "accepts": [
+       "Card",
+       "Link"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiCard title=\"Contents\">…</UiCard>"
+     },
+     {
+      "id": "document",
+      "title": "Document",
+      "desc": "Numbered sections of text.",
+      "accepts": [
+       "Card",
+       "Heading",
+       "Text"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiCard>…</UiCard>"
+     },
+     {
+      "id": "contact",
+      "title": "Contact",
+      "desc": "Questions about this document.",
+      "accepts": [
+       "Card",
+       "Button"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiCard title=\"Questions?\">…</UiCard>"
+     }
+    ]
+   },
+   {
+    "id": "locations",
+    "label": "Locations",
+    "component": "UiPageLocations",
+    "description": "Locations: filters, a list of places and a sticky map panel.",
+    "shell": true,
+    "slots": [
+     {
+      "id": "header",
+      "title": "Page heading",
+      "desc": "Breadcrumbs, heading, caption and action buttons on the right.",
+      "accepts": [
+       "PageHeader",
+       "Breadcrumbs",
+       "Button",
+       "SegmentedControl"
+      ],
+      "props": [
+       {
+        "name": "title",
+        "type": "string",
+        "desc": "H1, up to 60 characters"
+       },
+       {
+        "name": "subtitle",
+        "type": "string?",
+        "desc": "Gray caption below the heading"
+       },
+       {
+        "name": "crumbs",
+        "type": "{label,href?}[]",
+        "desc": "Breadcrumbs"
+       },
+       {
+        "name": "actions",
+        "type": "VNode",
+        "desc": "Buttons on the right; wrap below on a narrow screen"
+       }
+      ],
+      "use": "<UiPageHeader title=\"Dashboard\" :crumbs=\"crumbs\">\n  <template #actions><UiButton variant=\"primary\">Export</UiButton></template>\n</UiPageHeader>"
+     },
+     {
+      "id": "filters",
+      "title": "Filters",
+      "desc": "Search and category chips.",
+      "accepts": [
+       "SearchInput",
+       "FilterChips"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiSearchInput v-model=\"q\" />"
+     },
+     {
+      "id": "list",
+      "title": "Places",
+      "desc": "Cards with name, distance and rating.",
+      "accepts": [
+       "Card",
+       "Chip",
+       "Rating"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiCard padding=\"none\">…</UiCard>"
+     },
+     {
+      "id": "map",
+      "title": "Map",
+      "desc": "Map with markers.",
+      "accepts": [
+       "Map",
+       "Card"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiMap :markers=\"pins\" />"
+     }
+    ]
+   },
+   {
+    "id": "booking-flow",
+    "label": "Booking flow",
+    "component": "UiPageBookingFlow",
+    "description": "Booking flow: stepper from search to confirmation with a sticky summary card.",
+    "shell": true,
+    "slots": [
+     {
+      "id": "header",
+      "title": "Page heading",
+      "desc": "Breadcrumbs, heading, caption and action buttons on the right.",
+      "accepts": [
+       "PageHeader",
+       "Breadcrumbs",
+       "Button",
+       "SegmentedControl"
+      ],
+      "props": [
+       {
+        "name": "title",
+        "type": "string",
+        "desc": "H1, up to 60 characters"
+       },
+       {
+        "name": "subtitle",
+        "type": "string?",
+        "desc": "Gray caption below the heading"
+       },
+       {
+        "name": "crumbs",
+        "type": "{label,href?}[]",
+        "desc": "Breadcrumbs"
+       },
+       {
+        "name": "actions",
+        "type": "VNode",
+        "desc": "Buttons on the right; wrap below on a narrow screen"
+       }
+      ],
+      "use": "<UiPageHeader title=\"Dashboard\" :crumbs=\"crumbs\">\n  <template #actions><UiButton variant=\"primary\">Export</UiButton></template>\n</UiPageHeader>"
+     },
+     {
+      "id": "steps",
+      "title": "Steps",
+      "desc": "Progress through the flow.",
+      "accepts": [
+       "Stepper"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiStepper :steps=\"steps\" :current=\"1\" />"
+     },
+     {
+      "id": "content",
+      "title": "Active step",
+      "desc": "Search, pick, guests or confirm.",
+      "accepts": [
+       "Card",
+       "DatePicker",
+       "OptionCards",
+       "NumberInput"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiCard title=\"Guests\">…</UiCard>"
+     },
+     {
+      "id": "nav",
+      "title": "Navigation",
+      "desc": "Back and continue buttons.",
+      "accepts": [
+       "Button"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiButton variant=\"primary\">Continue</UiButton>"
+     },
+     {
+      "id": "summary",
+      "title": "Summary",
+      "desc": "Price and details of the booking.",
+      "accepts": [
+       "Card",
+       "Descriptions",
+       "Button"
+      ],
+      "props": [
+       {
+        "name": "content",
+        "type": "VNode",
+        "desc": ""
+       }
+      ],
+      "use": "<UiCard title=\"Summary\">…</UiCard>"
+     }
+    ]
    }
   ]
  },
@@ -12337,6 +13165,253 @@
     "Filters sit left of the results and stack above them under 860 px. Fill empty only when there are no results."
    ]
   },
+  {
+   "name": "PageArticle",
+   "tag": "UiPageArticle",
+   "group": "pages",
+   "description": "Article template: cover, post body, sticky table of contents, share row and related posts.",
+   "props": {
+    "title": {
+     "forwarded": true,
+     "type": "string",
+     "description": "Page heading. The built-in header renders only when title is set and the header slot is empty."
+    },
+    "subtitle": {
+     "forwarded": true,
+     "type": "string",
+     "description": "Caption under the heading."
+    },
+    "crumbs": {
+     "forwarded": true,
+     "type": "{ label: string; href?: string }[]",
+     "description": "Breadcrumb trail above the title."
+    }
+   },
+   "slots": {
+    "header": "Custom page header; replaces the built-in title/subtitle/crumbs header.",
+    "actions": "Buttons on the right of the built-in header. With a title they sit beside it; without a title they render alone, right-aligned (unless the header slot is filled).",
+    "cover": "Cover image area with title and author line; a gradient Card or LazyImage.",
+    "body": "Article text; Heading, Text, Code, Alert.",
+    "toc": "Sticky table of contents; Card with a list of anchor links.",
+    "share": "Share and reaction row; Button, IconButton, CopyButton.",
+    "related": "Related posts; Card grid."
+   },
+   "notes": [
+    "Place inside AppShell; fill only the slots you need.",
+    "Body, share and related share the main column; the table of contents stays visible on the right while the body scrolls and drops under the body below 860 px."
+   ]
+  },
+  {
+   "name": "PageChangelog",
+   "tag": "UiPageChangelog",
+   "group": "pages",
+   "description": "Changelog template: release timeline grouped by version with new, fix and improved tags, a filter and a subscribe card.",
+   "props": {
+    "title": {
+     "forwarded": true,
+     "type": "string",
+     "description": "Page heading. The built-in header renders only when title is set and the header slot is empty."
+    },
+    "subtitle": {
+     "forwarded": true,
+     "type": "string",
+     "description": "Caption under the heading."
+    },
+    "crumbs": {
+     "forwarded": true,
+     "type": "{ label: string; href?: string }[]",
+     "description": "Breadcrumb trail above the title."
+    }
+   },
+   "slots": {
+    "header": "Custom page header; replaces the built-in title/subtitle/crumbs header.",
+    "actions": "Buttons on the right of the built-in header. With a title they sit beside it; without a title they render alone, right-aligned (unless the header slot is filled).",
+    "filters": "Tag filter; FilterChips, SearchInput.",
+    "timeline": "Releases grouped by version; Card, Chip, Divider.",
+    "subscribe": "Sticky subscribe card; Card, TextField, Button."
+   },
+   "notes": [
+    "Place inside AppShell; fill only the slots you need.",
+    "Filters and timeline share the main column; the subscribe card is a sticky side column."
+   ]
+  },
+  {
+   "name": "PageHelp",
+   "tag": "UiPageHelp",
+   "group": "pages",
+   "description": "Help center home: search, category grid, popular articles and a contact card.",
+   "props": {
+    "title": {
+     "forwarded": true,
+     "type": "string",
+     "description": "Page heading. The built-in header renders only when title is set and the header slot is empty."
+    },
+    "subtitle": {
+     "forwarded": true,
+     "type": "string",
+     "description": "Caption under the heading."
+    },
+    "crumbs": {
+     "forwarded": true,
+     "type": "{ label: string; href?: string }[]",
+     "description": "Breadcrumb trail above the title."
+    }
+   },
+   "slots": {
+    "header": "Custom page header; replaces the built-in title/subtitle/crumbs header.",
+    "actions": "Buttons on the right of the built-in header. With a title they sit beside it; without a title they render alone, right-aligned (unless the header slot is filled).",
+    "search": "Large search field; SearchInput.",
+    "categories": "Category tiles; Card with IconTile.",
+    "popular": "Popular articles list; Card.",
+    "contact": "Contact options; Card, Button."
+   },
+   "notes": [
+    "Place inside AppShell; fill only the slots you need.",
+    "Popular articles and contact share a row and wrap on narrow screens. For a single question list use PageFaq."
+   ]
+  },
+  {
+   "name": "PageStates",
+   "tag": "UiPageStates",
+   "group": "pages",
+   "description": "State gallery: empty list, no results, no permission, offline, error with retry, loading and success on one page.",
+   "props": {
+    "title": {
+     "forwarded": true,
+     "type": "string",
+     "description": "Page heading. The built-in header renders only when title is set and the header slot is empty."
+    },
+    "subtitle": {
+     "forwarded": true,
+     "type": "string",
+     "description": "Caption under the heading."
+    },
+    "crumbs": {
+     "forwarded": true,
+     "type": "{ label: string; href?: string }[]",
+     "description": "Breadcrumb trail above the title."
+    }
+   },
+   "slots": {
+    "header": "Custom page header; replaces the built-in title/subtitle/crumbs header.",
+    "actions": "Buttons on the right of the built-in header. With a title they sit beside it; without a title they render alone, right-aligned (unless the header slot is filled).",
+    "empty": "Empty list; EmptyState with a primary action.",
+    "noresults": "No search results; EmptyState with a reset action.",
+    "forbidden": "No permission; EmptyState with a request-access action.",
+    "offline": "Offline; DataState state=\"offline\".",
+    "error": "Error with retry; DataState state=\"error\".",
+    "loading": "Loading; Skeleton or DataState state=\"loading\".",
+    "success": "Success confirmation; Alert tone=\"success\" or EmptyState."
+   },
+   "notes": [
+    "Place inside AppShell; fill only the slots you need.",
+    "The first six slots sit in two rows of auto-fit cards; success spans the full width."
+   ]
+  },
+  {
+   "name": "PageLegal",
+   "tag": "UiPageLegal",
+   "group": "pages",
+   "description": "Legal document template: last-updated line, sticky table of contents, numbered sections and a contact card.",
+   "props": {
+    "title": {
+     "forwarded": true,
+     "type": "string",
+     "description": "Page heading. The built-in header renders only when title is set and the header slot is empty."
+    },
+    "subtitle": {
+     "forwarded": true,
+     "type": "string",
+     "description": "Caption under the heading."
+    },
+    "crumbs": {
+     "forwarded": true,
+     "type": "{ label: string; href?: string }[]",
+     "description": "Breadcrumb trail above the title."
+    }
+   },
+   "slots": {
+    "header": "Custom page header; replaces the built-in title/subtitle/crumbs header.",
+    "actions": "Buttons on the right of the built-in header. With a title they sit beside it; without a title they render alone, right-aligned (unless the header slot is filled).",
+    "meta": "Version, last-updated date and print or download buttons; Chip, Button.",
+    "toc": "Sticky table of contents; Card with anchor links.",
+    "document": "Document sections; Card, Heading, Text.",
+    "contact": "Questions card; Card, Button."
+   },
+   "notes": [
+    "Place inside AppShell; fill only the slots you need.",
+    "The table of contents sits left of the document and stacks above it under 860 px."
+   ]
+  },
+  {
+   "name": "PageLocations",
+   "tag": "UiPageLocations",
+   "group": "pages",
+   "description": "Locations template: filters, a scrollable list of places and a sticky map panel.",
+   "props": {
+    "title": {
+     "forwarded": true,
+     "type": "string",
+     "description": "Page heading. The built-in header renders only when title is set and the header slot is empty."
+    },
+    "subtitle": {
+     "forwarded": true,
+     "type": "string",
+     "description": "Caption under the heading."
+    },
+    "crumbs": {
+     "forwarded": true,
+     "type": "{ label: string; href?: string }[]",
+     "description": "Breadcrumb trail above the title."
+    }
+   },
+   "slots": {
+    "header": "Custom page header; replaces the built-in title/subtitle/crumbs header.",
+    "actions": "Buttons on the right of the built-in header. With a title they sit beside it; without a title they render alone, right-aligned (unless the header slot is filled).",
+    "filters": "Search and category filters; SearchInput, FilterChips.",
+    "list": "Places list; Card rows.",
+    "map": "Map panel; Map, or a gradient placeholder."
+   },
+   "notes": [
+    "Place inside AppShell; fill only the slots you need.",
+    "The list is a fixed-width column left of the map; under 860 px the map goes below the list."
+   ]
+  },
+  {
+   "name": "PageBookingFlow",
+   "tag": "UiPageBookingFlow",
+   "group": "pages",
+   "description": "Booking flow template: stepper, the active step content, back and continue buttons and a sticky summary card.",
+   "props": {
+    "title": {
+     "forwarded": true,
+     "type": "string",
+     "description": "Page heading. The built-in header renders only when title is set and the header slot is empty."
+    },
+    "subtitle": {
+     "forwarded": true,
+     "type": "string",
+     "description": "Caption under the heading."
+    },
+    "crumbs": {
+     "forwarded": true,
+     "type": "{ label: string; href?: string }[]",
+     "description": "Breadcrumb trail above the title."
+    }
+   },
+   "slots": {
+    "header": "Custom page header; replaces the built-in title/subtitle/crumbs header.",
+    "actions": "Buttons on the right of the built-in header. With a title they sit beside it; without a title they render alone, right-aligned (unless the header slot is filled).",
+    "steps": "Progress; Stepper.",
+    "content": "Content of the active step (search, pick, guests, confirm); Card, DatePicker, OptionCards, NumberInput.",
+    "nav": "Back and Continue buttons.",
+    "summary": "Booking summary; Card, Descriptions."
+   },
+   "notes": [
+    "Place inside AppShell; fill only the slots you need.",
+    "Render only the active step in content. The summary stays visible on the right and goes below the step under 860 px."
+   ]
+  },
   {
    "name": "PageNotifications",
    "tag": "UiPageNotifications",