create-xmlui-app 0.12.28 → 0.12.29

package/dist/blog/ts/.github/workflows/check.yml

@@ -0,0 +1,24 @@
+name: XMLUI Check
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run xmlui static analyzer
+        run: npm run check

package/dist/blog/ts/content/blog/building-a-docs-site-with-xmlui.md

@@ -0,0 +1,44 @@
+---
+title: "Building a Docs Site with XMLUI"
+slug: "building-a-docs-site-with-xmlui"
+description: "A step-by-step walkthrough of the docs template — navigation, TOC, and Markdown rendering."
+author: "Jane Smith"
+date: "2025-03-10"
+tags: ["tutorial", "xmlui"]
+---
+
+## The Docs Template
+
+The `create-xmlui-app` tool ships with a docs template that gives you a complete
+documentation site in minutes:
+
+```bash
+npx create-xmlui-app my-docs --template docs
+cd my-docs && npm start
+```
+
+## What You Get
+
+The template includes:
+
+- A **sidebar** built with `NavPanel` and collapsible `NavGroup` sections
+- A **Table of Contents** sidebar that auto-generates from page headings
+- **Full-text search** across all Markdown content
+- **Previous / next** navigation between pages
+- A **dark / light mode** toggle
+
+## How the Layout Works
+
+The `vertical-sticky` app layout puts the `NavPanel` on the left and the content area on
+the right. Inside each content page, the `DocumentPage` component (from
+`xmlui-docs-blocks`) renders the Markdown next to a `TableOfContents` and a prev/next
+links section.
+
+## Adding a New Page
+
+1. Drop a new `.md` file into `content/docs/`.
+2. Add a `NavLink` in the `NavPanel` section of `Main.xmlui`.
+3. Add a matching `Page` element inside `Pages` that loads the Markdown via
+   `appGlobals.docsContent['<filename>']`.
+
+That is all it takes.

package/dist/blog/ts/content/blog/theming-in-xmlui.md

@@ -0,0 +1,47 @@
+---
+title: "Theming in XMLUI"
+slug: "theming-in-xmlui"
+description: "How to customise colours, typography, and spacing with XMLUI theme variables."
+author: "Alex Johnson"
+date: "2025-03-20"
+tags: ["theming", "xmlui", "css"]
+---
+
+## The Theme System
+
+XMLUI uses a token-based theming system. Every component exposes a set of CSS-variable-like
+theme variables that you can override at any level of the tree.
+
+## Changing the Primary Color
+
+Wrap any subtree in a `Theme` component and set the token you want to override. The
+`color-primary-500` token cascades to buttons, links, and active navigation items
+automatically.
+
+```xml
+<Theme color-primary-500="#6366f1">
+  <App>
+    ...
+  </App>
+</Theme>
+```
+
+## Typography
+
+Use `fontFamily-base`, `fontSize-base`, and `lineHeight-base` theme variables to set the
+global typography for your app.
+
+## Dark Mode
+
+Add `autoDetectTone="true"` on the `App` component to follow the system preference. Or
+let users switch manually with the `ToneChangerButton` component in the `AppHeader`.
+
+## Scoped Themes
+
+Themes are scoped — they only affect descendants. This lets you apply a different look to
+a single section without touching the rest of the app.
+
+## Finding Token Names
+
+Every component's documentation lists its supported theme variables. You can also inspect
+the rendered HTML and look for CSS custom properties prefixed with `--xmlui-`.

package/dist/blog/ts/content/blog/welcome-to-my-blog.md

@@ -0,0 +1,36 @@
+---
+title: "Welcome to My Blog"
+slug: "welcome-to-my-blog"
+description: "The first post on this blog — what to expect and how it was built."
+author: "Jane Smith"
+date: "2025-03-01"
+tags: ["news", "meta"]
+---
+
+## Why I Started This Blog
+
+Every developer needs a place to share ideas, document experiments, and connect with others. This blog is mine.
+
+I built it with [XMLUI](https://xmlui.org) — a declarative UI framework that lets me write apps in markup without wrestling with component boilerplate.
+
+## What to Expect
+
+I plan to write about:
+
+- **XMLUI tips and tricks** — patterns I find useful day to day
+- **Project walkthroughs** — building real apps from scratch
+- **Tooling** — the CLI tools, editors, and workflows that make me productive
+
+## How This Site Works
+
+The blog is a single XMLUI app with a post listing page and individual post pages. All
+posts live in `content/blog/` as Markdown files with a frontmatter header. To add a new
+post, drop a new `.md` file into that folder — title, slug, date, author, and tags all
+come from the frontmatter.
+
+For a larger blog you would swap the local Markdown for an API call — the `PostList` and
+`PostPage` components stay exactly the same.
+
+## Get in Touch
+
+Have a question or idea? Open an issue on the repo or reach out directly.

package/dist/blog/ts/gitignore

@@ -0,0 +1,31 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+/test-results/
+/playwright-report/
+/playwright/.cache/
+
+.env.local
+.env.production
+

package/dist/blog/ts/index.html

@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <link rel="icon" type="image/svg+xml" href="/resources/favicon.ico" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <script>window.__PUBLIC_PATH = '/'</script>
+  <base href="/">
+</head>
+<body>
+<div id="root"></div>
+<script type="module" src="/index.ts"></script>
+</body>
+</html>

package/dist/blog/ts/index.ts

@@ -0,0 +1,13 @@
+import { startApp } from "xmlui";
+import search from "xmlui-search";
+import docsBlocks from "xmlui-docs-blocks";
+
+export const runtime = import.meta.glob(`/src/**`, { eager: true });
+const usedExtensions = [search, docsBlocks];
+startApp(runtime, usedExtensions);
+
+if (import.meta.hot) {
+    import.meta.hot.accept((newModule) => {
+        startApp(newModule?.runtime ?? runtime, usedExtensions);
+    });
+}

package/dist/blog/ts/public/resources/xmlui-logo-dark.svg

@@ -0,0 +1,9 @@
+<svg width="312" height="122" viewBox="0 0 312 122" fill="none"
+    xmlns="http://www.w3.org/2000/svg">
+    <path d="M229.875 98.0763C225.499 98.0763 221.696 97.1076 218.467 95.1703C215.31 93.1613 212.87 90.363 211.148 86.7755C209.426 83.1162 208.565 78.8111 208.565 73.8603V43.6173C208.565 42.8998 208.817 42.2899 209.319 41.7877C209.821 41.2854 210.431 41.0343 211.148 41.0343H220.62C221.409 41.0343 222.019 41.2854 222.449 41.7877C222.951 42.2899 223.203 42.8998 223.203 43.6173V73.2146C223.203 82.1117 227.113 86.5602 234.934 86.5602C238.665 86.5602 241.607 85.3763 243.759 83.0086C245.984 80.6408 247.096 77.3761 247.096 73.2146V43.6173C247.096 42.8998 247.347 42.2899 247.849 41.7877C248.351 41.2854 248.961 41.0343 249.679 41.0343H259.15C259.867 41.0343 260.477 41.2854 260.979 41.7877C261.482 42.2899 261.733 42.8998 261.733 43.6173V94.417C261.733 95.1345 261.482 95.7443 260.979 96.2466C260.477 96.7489 259.867 97 259.15 97H250.432C249.643 97 248.997 96.7489 248.495 96.2466C248.064 95.7443 247.849 95.1345 247.849 94.417V90.0043C245.912 92.5156 243.508 94.4887 240.638 95.9237C237.768 97.3587 234.18 98.0763 229.875 98.0763Z" fill="#3367CC"/>
+    <path d="M278.533 97C277.815 97 277.205 96.7489 276.703 96.2466C276.201 95.7443 275.95 95.1345 275.95 94.417V43.6173C275.95 42.8998 276.201 42.2899 276.703 41.7877C277.205 41.2854 277.815 41.0343 278.533 41.0343H287.466C288.255 41.0343 288.865 41.2854 289.295 41.7877C289.798 42.2899 290.049 42.8998 290.049 43.6173V94.417C290.049 95.1345 289.798 95.7443 289.295 96.2466C288.865 96.7489 288.255 97 287.466 97H278.533ZM278.102 31.7784C277.313 31.7784 276.667 31.5632 276.165 31.1327C275.734 30.6304 275.519 29.9847 275.519 29.1954V21.4463C275.519 20.7288 275.734 20.1189 276.165 19.6167C276.667 19.1144 277.313 18.8633 278.102 18.8633H287.896C288.685 18.8633 289.331 19.1144 289.833 19.6167C290.336 20.1189 290.587 20.7288 290.587 21.4463V29.1954C290.587 29.9847 290.336 30.6304 289.833 31.1327C289.331 31.5632 288.685 31.7784 287.896 31.7784H278.102Z" fill="#3367CC"/>
+    <path d="M3.73546 97.0006C3.0897 97.0006 2.51569 96.7854 2.01343 96.3549C1.58293 95.8526 1.36768 95.2786 1.36768 94.6329C1.36768 94.4176 1.40355 94.1665 1.4753 93.8795C1.6188 93.5925 1.83406 93.2337 2.12106 92.8032L20.4175 68.2644L3.41258 45.2324C3.19732 44.8736 3.01795 44.5507 2.87444 44.2637C2.80269 43.9767 2.76682 43.6897 2.76682 43.4027C2.76682 42.757 2.98207 42.2188 3.41258 41.7883C3.91483 41.2861 4.48884 41.0349 5.1346 41.0349H14.4981C15.3591 41.0349 16.0049 41.2502 16.4354 41.6807C16.8659 42.1112 17.1887 42.5058 17.404 42.8646L29.5658 59.0085L41.7275 42.8646C42.0146 42.5058 42.3374 42.1112 42.6962 41.6807C43.1267 41.2502 43.7724 41.0349 44.6335 41.0349H53.5664C54.2122 41.0349 54.7503 41.2861 55.1808 41.7883C55.6831 42.2188 55.9342 42.7211 55.9342 43.2951C55.9342 43.6538 55.8625 43.9767 55.719 44.2637C55.6472 44.5507 55.5037 44.8736 55.2885 45.2324L38.0683 68.4797L56.4724 92.8032C56.7594 93.2337 56.9387 93.5925 57.0105 93.8795C57.154 94.1665 57.2257 94.4176 57.2257 94.6329C57.2257 95.2786 56.9746 95.8526 56.4724 96.3549C56.0418 96.7854 55.5037 97.0006 54.858 97.0006H45.064C44.2747 97.0006 43.6648 96.8212 43.2343 96.4625C42.8038 96.032 42.4451 95.6374 42.1581 95.2786L29.2429 78.166L16.1125 95.2786C15.8255 95.6374 15.4667 96.032 15.0362 96.4625C14.6775 96.8212 14.0676 97.0006 13.2066 97.0006H3.73546Z" fill="white"/>
+    <path d="M69.4363 97.0006C68.7188 97.0006 68.1089 96.7495 67.6066 96.2472C67.1044 95.745 66.8532 95.1351 66.8532 94.4176V43.618C66.8532 42.9005 67.1044 42.2906 67.6066 41.7883C68.1089 41.2861 68.7188 41.0349 69.4363 41.0349H77.8311C78.5486 41.0349 79.1585 41.2861 79.6608 41.7883C80.163 42.2906 80.4142 42.9005 80.4142 43.618V47.2773C81.9209 45.2682 83.93 43.5821 86.4412 42.2188C89.0243 40.7838 92.0737 40.0304 95.5895 39.9587C103.769 39.8152 109.473 43.0081 112.702 49.5374C114.352 46.6674 116.72 44.3714 119.805 42.6493C122.962 40.8556 126.442 39.9587 130.245 39.9587C133.976 39.9587 137.348 40.8197 140.362 42.5417C143.447 44.2637 145.851 46.8826 147.573 50.3984C149.367 53.8425 150.264 58.2193 150.264 63.5288V94.4176C150.264 95.1351 150.013 95.745 149.51 96.2472C149.008 96.7495 148.398 97.0006 147.681 97.0006H138.855C138.138 97.0006 137.528 96.7495 137.026 96.2472C136.523 95.745 136.272 95.1351 136.272 94.4176V64.3899C136.272 61.1611 135.806 58.6139 134.873 56.7484C133.94 54.8111 132.685 53.4478 131.106 52.6586C129.528 51.8693 127.77 51.4747 125.832 51.4747C124.254 51.4747 122.675 51.8693 121.097 52.6586C119.518 53.4478 118.227 54.8111 117.222 56.7484C116.218 58.6139 115.716 61.1611 115.716 64.3899V94.4176C115.716 95.1351 115.464 95.745 114.962 96.2472C114.46 96.7495 113.85 97.0006 113.133 97.0006H104.307C103.518 97.0006 102.872 96.7495 102.37 96.2472C101.939 95.745 101.724 95.1351 101.724 94.4176V64.3899C101.724 61.1611 101.222 58.6139 100.217 56.7484C99.2129 54.8111 97.9214 53.4478 96.3429 52.6586C94.7643 51.8693 93.0782 51.4747 91.2844 51.4747C89.6342 51.4747 88.0198 51.9052 86.4412 52.7662C84.8627 53.5555 83.5712 54.8829 82.5667 56.7484C81.5622 58.6139 81.0599 61.1611 81.0599 64.3899V94.4176C81.0599 95.1351 80.8088 95.745 80.3065 96.2472C79.8043 96.7495 79.1944 97.0006 78.4769 97.0006H69.4363Z" fill="white"/>
+    <path d="M166.66 97.0006C165.942 97.0006 165.332 96.7495 164.83 96.2472C164.328 95.745 164.077 95.1351 164.077 94.4176V23.169C164.077 22.4515 164.328 21.8416 164.83 21.3393C165.332 20.8371 165.942 20.5859 166.66 20.5859H175.593C176.31 20.5859 176.92 20.8371 177.422 21.3393C177.925 21.8416 178.176 22.4515 178.176 23.169V94.4176C178.176 95.1351 177.925 95.745 177.422 96.2472C176.92 96.7495 176.31 97.0006 175.593 97.0006H166.66Z" fill="white"/>
+    <path fill-rule="evenodd" clip-rule="evenodd" d="M309 3H193V119H309V3ZM191 1V121H311V1H191Z" fill="#3367CC"/>
+</svg>

package/dist/blog/ts/public/resources/xmlui-logo.svg

@@ -0,0 +1,8 @@
+<svg width="312" height="122" viewBox="0 0 312 122" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M229.875 98.0763C225.499 98.0763 221.696 97.1076 218.467 95.1703C215.31 93.1613 212.87 90.363 211.148 86.7755C209.426 83.1162 208.565 78.8111 208.565 73.8603V43.6173C208.565 42.8998 208.817 42.2899 209.319 41.7877C209.821 41.2854 210.431 41.0343 211.148 41.0343H220.62C221.409 41.0343 222.019 41.2854 222.449 41.7877C222.951 42.2899 223.203 42.8998 223.203 43.6173V73.2146C223.203 82.1117 227.113 86.5602 234.934 86.5602C238.665 86.5602 241.607 85.3763 243.759 83.0086C245.984 80.6408 247.096 77.3761 247.096 73.2146V43.6173C247.096 42.8998 247.347 42.2899 247.849 41.7877C248.351 41.2854 248.961 41.0343 249.679 41.0343H259.15C259.867 41.0343 260.477 41.2854 260.979 41.7877C261.482 42.2899 261.733 42.8998 261.733 43.6173V94.417C261.733 95.1345 261.482 95.7443 260.979 96.2466C260.477 96.7489 259.867 97 259.15 97H250.432C249.643 97 248.997 96.7489 248.495 96.2466C248.064 95.7443 247.849 95.1345 247.849 94.417V90.0043C245.912 92.5156 243.508 94.4887 240.638 95.9237C237.768 97.3587 234.18 98.0763 229.875 98.0763Z" fill="#3367CC"/>
+<path d="M278.533 97C277.815 97 277.205 96.7489 276.703 96.2466C276.201 95.7443 275.95 95.1345 275.95 94.417V43.6173C275.95 42.8998 276.201 42.2899 276.703 41.7877C277.205 41.2854 277.815 41.0343 278.533 41.0343H287.466C288.255 41.0343 288.865 41.2854 289.295 41.7877C289.798 42.2899 290.049 42.8998 290.049 43.6173V94.417C290.049 95.1345 289.798 95.7443 289.295 96.2466C288.865 96.7489 288.255 97 287.466 97H278.533ZM278.102 31.7784C277.313 31.7784 276.667 31.5632 276.165 31.1327C275.734 30.6304 275.519 29.9847 275.519 29.1954V21.4463C275.519 20.7288 275.734 20.1189 276.165 19.6167C276.667 19.1144 277.313 18.8633 278.102 18.8633H287.896C288.685 18.8633 289.331 19.1144 289.833 19.6167C290.336 20.1189 290.587 20.7288 290.587 21.4463V29.1954C290.587 29.9847 290.336 30.6304 289.833 31.1327C289.331 31.5632 288.685 31.7784 287.896 31.7784H278.102Z" fill="#3367CC"/>
+<path d="M3.73546 97.0006C3.0897 97.0006 2.51569 96.7854 2.01343 96.3549C1.58293 95.8526 1.36768 95.2786 1.36768 94.6329C1.36768 94.4176 1.40355 94.1665 1.4753 93.8795C1.6188 93.5925 1.83406 93.2337 2.12106 92.8032L20.4175 68.2644L3.41258 45.2324C3.19732 44.8736 3.01795 44.5507 2.87444 44.2637C2.80269 43.9767 2.76682 43.6897 2.76682 43.4027C2.76682 42.757 2.98207 42.2188 3.41258 41.7883C3.91483 41.2861 4.48884 41.0349 5.1346 41.0349H14.4981C15.3591 41.0349 16.0049 41.2502 16.4354 41.6807C16.8659 42.1112 17.1887 42.5058 17.404 42.8646L29.5658 59.0085L41.7275 42.8646C42.0146 42.5058 42.3374 42.1112 42.6962 41.6807C43.1267 41.2502 43.7724 41.0349 44.6335 41.0349H53.5664C54.2122 41.0349 54.7503 41.2861 55.1808 41.7883C55.6831 42.2188 55.9342 42.7211 55.9342 43.2951C55.9342 43.6538 55.8625 43.9767 55.719 44.2637C55.6472 44.5507 55.5037 44.8736 55.2885 45.2324L38.0683 68.4797L56.4724 92.8032C56.7594 93.2337 56.9387 93.5925 57.0105 93.8795C57.154 94.1665 57.2257 94.4176 57.2257 94.6329C57.2257 95.2786 56.9746 95.8526 56.4724 96.3549C56.0418 96.7854 55.5037 97.0006 54.858 97.0006H45.064C44.2747 97.0006 43.6648 96.8212 43.2343 96.4625C42.8038 96.032 42.4451 95.6374 42.1581 95.2786L29.2429 78.166L16.1125 95.2786C15.8255 95.6374 15.4667 96.032 15.0362 96.4625C14.6775 96.8212 14.0676 97.0006 13.2066 97.0006H3.73546Z" fill="#333366"/>
+<path d="M69.4363 97.0006C68.7188 97.0006 68.1089 96.7495 67.6066 96.2472C67.1044 95.745 66.8532 95.1351 66.8532 94.4176V43.618C66.8532 42.9005 67.1044 42.2906 67.6066 41.7883C68.1089 41.2861 68.7188 41.0349 69.4363 41.0349H77.8311C78.5486 41.0349 79.1585 41.2861 79.6608 41.7883C80.163 42.2906 80.4142 42.9005 80.4142 43.618V47.2773C81.9209 45.2682 83.93 43.5821 86.4412 42.2188C89.0243 40.7838 92.0737 40.0304 95.5895 39.9587C103.769 39.8152 109.473 43.0081 112.702 49.5374C114.352 46.6674 116.72 44.3714 119.805 42.6493C122.962 40.8556 126.442 39.9587 130.245 39.9587C133.976 39.9587 137.348 40.8197 140.362 42.5417C143.447 44.2637 145.851 46.8826 147.573 50.3984C149.367 53.8425 150.264 58.2193 150.264 63.5288V94.4176C150.264 95.1351 150.013 95.745 149.51 96.2472C149.008 96.7495 148.398 97.0006 147.681 97.0006H138.855C138.138 97.0006 137.528 96.7495 137.026 96.2472C136.523 95.745 136.272 95.1351 136.272 94.4176V64.3899C136.272 61.1611 135.806 58.6139 134.873 56.7484C133.94 54.8111 132.685 53.4478 131.106 52.6586C129.528 51.8693 127.77 51.4747 125.832 51.4747C124.254 51.4747 122.675 51.8693 121.097 52.6586C119.518 53.4478 118.227 54.8111 117.222 56.7484C116.218 58.6139 115.716 61.1611 115.716 64.3899V94.4176C115.716 95.1351 115.464 95.745 114.962 96.2472C114.46 96.7495 113.85 97.0006 113.133 97.0006H104.307C103.518 97.0006 102.872 96.7495 102.37 96.2472C101.939 95.745 101.724 95.1351 101.724 94.4176V64.3899C101.724 61.1611 101.222 58.6139 100.217 56.7484C99.2129 54.8111 97.9214 53.4478 96.3429 52.6586C94.7643 51.8693 93.0782 51.4747 91.2844 51.4747C89.6342 51.4747 88.0198 51.9052 86.4412 52.7662C84.8627 53.5555 83.5712 54.8829 82.5667 56.7484C81.5622 58.6139 81.0599 61.1611 81.0599 64.3899V94.4176C81.0599 95.1351 80.8088 95.745 80.3065 96.2472C79.8043 96.7495 79.1944 97.0006 78.4769 97.0006H69.4363Z" fill="#333366"/>
+<path d="M166.66 97.0006C165.942 97.0006 165.332 96.7495 164.83 96.2472C164.328 95.745 164.077 95.1351 164.077 94.4176V23.169C164.077 22.4515 164.328 21.8416 164.83 21.3393C165.332 20.8371 165.942 20.5859 166.66 20.5859H175.593C176.31 20.5859 176.92 20.8371 177.422 21.3393C177.925 21.8416 178.176 22.4515 178.176 23.169V94.4176C178.176 95.1351 177.925 95.745 177.422 96.2472C176.92 96.7495 176.31 97.0006 175.593 97.0006H166.66Z" fill="#333366"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M309 3H193V119H309V3ZM191 1V121H311V1H191Z" fill="#3367CC"/>
+</svg>

package/dist/blog/ts/public/serve.json

@@ -0,0 +1,8 @@
+{
+  "rewrites": [
+    {
+      "source": "**",
+      "destination": "/index.html"
+    }
+  ]
+}

package/dist/blog/ts/src/Main.xmlui

@@ -0,0 +1,31 @@
+<App layout="vertical-full-header">
+  <AppHeader>
+    <property name="logoTemplate">
+      <Link to="/" height="100%">
+        <Logo height="$space-8" />
+      </Link>
+    </property>
+    <SpaceFiller />
+    <Search
+      data="{appGlobals.staticSearchData}"
+      placeholder="Search posts..."
+      noResultsMessage="No posts match your search."
+      pageSize="8"
+      enableSpellCorrection="true"
+      mode="inline"
+      collapsible="true"
+    />
+    <ToneChangerButton />
+  </AppHeader>
+  <Pages fallbackPath="/">
+    <Page url="/">
+      <PostList posts="{appGlobals.posts}" />
+    </Page>
+    <Page url="/post/:slug">
+      <PostPage posts="{appGlobals.posts}" />
+    </Page>
+  </Pages>
+  <Footer>
+    Powered by XMLUI
+  </Footer>
+</App>

package/dist/blog/ts/src/components/PostCard.xmlui

@@ -0,0 +1,19 @@
+<Component name="PostCard">
+  <Card>
+    <VStack gap="0.75rem">
+      <Link to="{'/post/' + $props.post.slug}" noIndicator>
+        <H3>{$props.post.title}</H3>
+      </Link>
+      <Text color="$color-surface-500" fontSize="$fontSize-sm">
+        {$props.post.author} · {$props.post.date}
+      </Text>
+      <Text>{$props.post.description}</Text>
+      <HStack gap="0.5rem" when="{$props.post.tags && $props.post.tags.length > 0}">
+        <Items data="{$props.post.tags}">
+          <PostTag>{$item}</PostTag>
+        </Items>
+      </HStack>
+      <Link to="{'/post/' + $props.post.slug}" label="Read more →" />
+    </VStack>
+  </Card>
+</Component>

package/dist/blog/ts/src/components/PostList.xmlui

@@ -0,0 +1,7 @@
+<Component name="PostList">
+  <VStack maxWidth="720px" marginHorizontal="auto" padding="2rem" gap="2rem">
+    <Items data="{$props.posts || []}">
+      <PostCard post="{$item}" />
+    </Items>
+  </VStack>
+</Component>

package/dist/blog/ts/src/components/PostPage.xmlui

@@ -0,0 +1,44 @@
+<Component name="PostPage">
+  <script>
+    var post = ($props.posts || []).find(function(p) { return p.slug === $routeParams.slug; });
+    function markdownContent() {
+      return post ? appGlobals.prefetchedContent['/post/' + post.slug] : '';
+    }
+  </script>
+
+  <VStack when="{!post}" padding="2rem" gap="1rem" horizontalAlignment="center">
+    <H2>Post not found</H2>
+    <Text>The post you are looking for does not exist.</Text>
+    <Link to="/" label="← Back to all posts" />
+  </VStack>
+
+  <VStack when="{!!post}" maxWidth="720px" marginHorizontal="auto" padding="2rem" gap="1.5rem">
+    <Link to="/" noIndicator>← All posts</Link>
+
+    <VStack gap="0.5rem">
+      <H1 showAnchor="false">{post && post.title}</H1>
+      <Text color="$color-surface-500" fontSize="$fontSize-lg">
+        {post && post.description}
+      </Text>
+    </VStack>
+
+    <HStack gap="1rem" verticalAlignment="center">
+      <Text color="$color-surface-500" fontSize="$fontSize-sm">
+        {post && post.author} · {post && post.date}
+      </Text>
+    </HStack>
+
+    <HStack gap="0.5rem" when="{post && post.tags && post.tags.length > 0}">
+      <Items data="{post ? post.tags : []}">
+        <PostTag>{$item}</PostTag>
+      </Items>
+    </HStack>
+
+    <ContentSeparator />
+
+    <Markdown content="{markdownContent()}" showHeadingAnchors />
+
+    <ContentSeparator />
+    <Link to="/" label="← Back to all posts" />
+  </VStack>
+</Component>

package/dist/blog/ts/src/components/PostTag.xmlui

@@ -0,0 +1,12 @@
+<Component name="PostTag">
+  <Text
+    backgroundColor="$color-surface-100"
+    color="$color-surface-500"
+    borderRadius="$space-8"
+    paddingHorizontal="$space-3"
+    paddingVertical="$space-0_5"
+    fontSize="$fontSize-sm"
+  >
+    <Slot />
+  </Text>
+</Component>

package/dist/blog/ts/src/config.ts

@@ -0,0 +1,20 @@
+import type { StandaloneAppDescription } from "xmlui";
+import { allPosts, prefetchedContent, staticSearchData } from "./content";
+
+const App: StandaloneAppDescription = {
+  name: "My Blog",
+  version: "0.1.0",
+  defaultTheme: "xmlui-web",
+  resources: {
+    logo: "/resources/xmlui-logo.svg",
+    "logo-dark": "/resources/xmlui-logo-dark.svg",
+    favicon: "/resources/favicon.ico",
+  },
+  appGlobals: {
+    posts: allPosts,
+    prefetchedContent,
+    staticSearchData,
+  },
+};
+
+export default App;

package/dist/blog/ts/src/content.ts

@@ -0,0 +1,66 @@
+import { buildContentFromRuntime } from "xmlui-docs-blocks";
+import { type SearchItemData, SEARCH_CATEGORIES } from "xmlui";
+
+const rawBlogContent: Record<string, { default: string }> = import.meta.glob(
+  `/content/blog/*.md`,
+  {
+    eager: true,
+    query: "?raw",
+  },
+);
+
+const {
+  content: blogContent,
+  plainTextContent: plainTextBlogContent,
+  frontmatter: blogFrontmatter,
+} = buildContentFromRuntime(
+  rawBlogContent,
+  { contentPrefix: "/content/blog/" },
+  { urlPrefix: "/post/" },
+) as unknown as {
+  content: Record<string, string>;
+  plainTextContent: Record<string, string>;
+  frontmatter: Record<string, Record<string, unknown>>;
+};
+
+// Build the post list (excluding drafts) sorted by date descending.
+const allPosts = Object.entries(blogFrontmatter)
+  .map(([key, fm]) => ({
+    title: fm.title,
+    slug: fm.slug ?? key.replace("/post/", ""),
+    description: fm.description,
+    author: fm.author,
+    date: fm.date,
+    image: fm.image,
+    tags: fm.tags,
+    draft: !!fm.draft,
+  }))
+  .filter((p) => !p.draft)
+  .sort((a, b) => Date.parse(String(b.date)) - Date.parse(String(a.date)));
+
+// Markdown content keyed by `/post/<slug>` for prefetched lookup from PostPage.
+const prefetchedContent: Record<string, string> = {};
+Object.keys(blogContent).forEach((fileName) => {
+  prefetchedContent[`/post/${fileName}`] = blogContent[fileName];
+});
+
+const staticSearchData: SearchItemData[] = Object.entries(plainTextBlogContent).map(
+  ([key, value]) => {
+    const fmKey = key;
+    const fm = blogFrontmatter[fmKey] || {};
+    const fallbackTitle = key
+      .replace("/post/", "")
+      .split("-")
+      .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+      .join(" ");
+    const title = fm.title ? String(fm.title) : fallbackTitle;
+    return {
+      path: key,
+      title,
+      content: value,
+      category: SEARCH_CATEGORIES[1], // "blog"
+    };
+  },
+);
+
+export { allPosts, prefetchedContent, staticSearchData };

package/dist/blog/ts/xmlui.config.json

@@ -0,0 +1,16 @@
+{
+  "analyze": "warn",
+  "rules": {
+    "id-unknown-component": "warn",
+    "id-unknown-prop": "warn",
+    "id-unknown-event": "warn",
+    "id-unknown-slot": "warn",
+    "expr-unbound-identifier": "warn",
+    "expr-unused-var": "info",
+    "expr-dead-conditional": "info",
+    "expr-handler-no-value": "warn",
+    "id-undefined-component-ref": "warn",
+    "id-undefined-form-ref": "warn",
+    "theming-missing-prefix": "warn"
+  }
+}

package/dist/default/ts/.github/workflows/check.yml

@@ -0,0 +1,24 @@
+name: XMLUI Check
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run xmlui static analyzer
+        run: npm run check

package/dist/default/ts/gitignore

@@ -0,0 +1,31 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+/test-results/
+/playwright-report/
+/playwright/.cache/
+
+.env.local
+.env.production
+

package/dist/default/ts/index.html

@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <link rel="icon" type="image/svg+xml" href="/resources/favicon.ico" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <script>window.__PUBLIC_PATH = '/'</script>
+  <base href="/">
+</head>
+<body>
+<div id="root"></div>
+<script type="module" src="/index.ts"></script>
+</body>
+</html>

package/dist/default/ts/index.ts

@@ -0,0 +1,9 @@
+import { startApp } from "xmlui";
+export const runtime = import.meta.glob(`/src/**`, { eager: true });
+startApp(runtime);
+
+if (import.meta.hot) {
+    import.meta.hot.accept((newModule) => {
+        startApp(newModule?.runtime);
+    });
+}