@webqit/webflo 0.20.2-next.1 → 0.20.2

package/README.md

@@ -5,8 +5,7 @@
 _A web-native framework for the next generation of apps_
 
 [![npm version][npm-version-src]][npm-version-href]
-[![npm downloads][npm-downloads-src]][npm-downloads-href]
-[![bundle][bundle-src]][bundle-href]
+<!--[![npm downloads][npm-downloads-src]][npm-downloads-href]-->
 [![License][license-src]][license-href]
 
 </div>
@@ -14,7 +13,7 @@ _A web-native framework for the next generation of apps_
 <div align="center">
 
 _Build the full spectrum of modern applications — backends, frontends, offline-first, and realtime apps — on raw platform power._ 🛸<br>
-[Webflo ↗](https://webflo.netlify.app/docs) is a web-native framework that lets you build absurdlly fast — with the whole sophistication and scale of modern apps solved from the foundation up.
+[Webflo ↗](https://webflo.netlify.app/overview) is a web-native framework that lets you build absurdlly fast — with the whole sophistication and scale of modern apps solved from the foundation up.
 
 </div>
 
@@ -34,6 +33,8 @@ For a quick intro, see the docs:
 + [Core Concepts ↗](https://webflo.netlify.app/docs/concepts)
 + [Examples ↗](https://webflo.netlify.app/examples)
 
+---
+
 ## What You Can Build
 
 | Category                   | Examples & Notes                                                                                                 |
@@ -45,6 +46,8 @@ For a quick intro, see the docs:
 | **Realtime & multiplayer** | Chats, presence, dashboards, live docs, notifications — realtime channels and dialogs available out of the box.  |
 | **AI & agents**            | Multi-step AI workflows, background agents, and automation powered by Webflo’s live request lifecycle.           |
 
+---
+
 ## Features
 
 | Feature                               | Description                                                                                         |
@@ -59,6 +62,8 @@ For a quick intro, see the docs:
 | 📦 **Offline & worker features**       | Worker-side routing, caching, background sync, and offline-first behaviors built in.                |
 | 🧩 **Dev mode & HMR**                 | Fast development server with fine-grained rebuilds and hot updates for HTML, JS, and CSS.           |
 
+---
+
 ## Contributing
 
 Webflo is in active development — and contributions are welcome!  
@@ -94,7 +99,5 @@ MIT — see [LICENSE](https://github.com/webqit/webflo/blob/master/LICENSE)
 [npm-version-href]: https://npmjs.com/package/@webqit/webflo
 [npm-downloads-src]: https://img.shields.io/npm/dm/@webqit/webflo?style=flat&colorA=18181B&colorB=F0DB4F
 [npm-downloads-href]: https://npmjs.com/package/@webqit/webflo
-[bundle-src]: https://img.shields.io/bundlephobia/minzip/@webqit/webflo?style=flat&colorA=18181B&colorB=F0DB4F
-[bundle-href]: https://bundlephobia.com/result?p=@webqit/webflo
 [license-src]: https://img.shields.io/github/license/webqit/webflo.svg?style=flat&colorA=18181B&colorB=F0DB4F
 [license-href]: https://github.com/webqit/webflo/blob/master/LICENSE

package/package.json

@@ -12,7 +12,7 @@
     "vanila-javascript"
   ],
   "homepage": "https://webqit.io/tooling/webflo",
-  "version": "0.20.2-next.1",
+  "version": "0.20.2",
   "license": "MIT",
   "repository": {
     "type": "git",

package/site/.vitepress/cache/deps/_metadata.json

@@ -0,0 +1,85 @@
+{
+  "hash": "cab2ac2d",
+  "configHash": "a00e1839",
+  "lockfileHash": "e996cd2d",
+  "browserHash": "07baafca",
+  "optimized": {
+    "vue": {
+      "src": "../../../../node_modules/vue/dist/vue.runtime.esm-bundler.js",
+      "file": "vue.js",
+      "fileHash": "9d1dccd0",
+      "needsInterop": false
+    },
+    "vitepress > @vue/devtools-api": {
+      "src": "../../../../node_modules/@vue/devtools-api/dist/index.js",
+      "file": "vitepress___@vue_devtools-api.js",
+      "fileHash": "e643fe21",
+      "needsInterop": false
+    },
+    "vitepress > @vueuse/core": {
+      "src": "../../../../node_modules/@vueuse/core/index.mjs",
+      "file": "vitepress___@vueuse_core.js",
+      "fileHash": "6b190c4d",
+      "needsInterop": false
+    },
+    "@braintree/sanitize-url": {
+      "src": "../../../../node_modules/@braintree/sanitize-url/dist/index.js",
+      "file": "@braintree_sanitize-url.js",
+      "fileHash": "6c19b9da",
+      "needsInterop": true
+    },
+    "dayjs": {
+      "src": "../../../../node_modules/dayjs/dayjs.min.js",
+      "file": "dayjs.js",
+      "fileHash": "fde7931e",
+      "needsInterop": true
+    },
+    "debug": {
+      "src": "../../../../node_modules/debug/src/browser.js",
+      "file": "debug.js",
+      "fileHash": "4fba4867",
+      "needsInterop": true
+    },
+    "cytoscape-cose-bilkent": {
+      "src": "../../../../node_modules/cytoscape-cose-bilkent/cytoscape-cose-bilkent.js",
+      "file": "cytoscape-cose-bilkent.js",
+      "fileHash": "817be336",
+      "needsInterop": true
+    },
+    "cytoscape": {
+      "src": "../../../../node_modules/cytoscape/dist/cytoscape.esm.mjs",
+      "file": "cytoscape.js",
+      "fileHash": "4497f16b",
+      "needsInterop": false
+    },
+    "vitepress > @vueuse/integrations/useFocusTrap": {
+      "src": "../../../../node_modules/@vueuse/integrations/useFocusTrap.mjs",
+      "file": "vitepress___@vueuse_integrations_useFocusTrap.js",
+      "fileHash": "05a85443",
+      "needsInterop": false
+    },
+    "vitepress > mark.js/src/vanilla.js": {
+      "src": "../../../../node_modules/mark.js/src/vanilla.js",
+      "file": "vitepress___mark__js_src_vanilla__js.js",
+      "fileHash": "706305bb",
+      "needsInterop": false
+    },
+    "vitepress > minisearch": {
+      "src": "../../../../node_modules/minisearch/dist/es/index.js",
+      "file": "vitepress___minisearch.js",
+      "fileHash": "c66551d8",
+      "needsInterop": false
+    }
+  },
+  "chunks": {
+    "chunk-Q2AYPHVK": {
+      "file": "chunk-Q2AYPHVK.js"
+    },
+    "chunk-QAXAIFA7": {
+      "file": "chunk-QAXAIFA7.js"
+    },
+    "chunk-BUSYA2B4": {
+      "file": "chunk-BUSYA2B4.js"
+    }
+  }
+}

package/site/.vitepress/config.ts

@@ -19,17 +19,22 @@ const config = {
             { icon: 'github', link: 'https://github.com/webqit/webflo' },
         ],
         nav: [
-            { text: 'Docs', link: '/docs', activeMatch: '/docs' },
+            { text: 'What is Webflo', link: '/overview', activeMatch: '/overview' },
+            { text: 'Docs', link: '/docs/getting-started', activeMatch: '/docs' },
             { text: 'API', link: '/api', activeMatch: '/api/webflo-routing/handler' },
             { text: 'Guides', link: '/guides', activeMatch: '/guides' },
             { text: 'Examples', link: '/examples', activeMatch: '/examples' },
+            {
+                text: 'Star on GitHub',
+                link: 'https://github.com/webqit/webflo',
+            }
         ],
         sidebar: {
             '/': [
                 {
                     text: 'Getting Started',
                     items: [
-                        { text: 'Welcome', link: '/docs' },
+                        { text: 'What is Webflo', link: '/overview' },
                         { text: 'Quickstart', link: '/docs/getting-started' },
                     ]
                 },

package/site/docs/getting-started.md

@@ -2,6 +2,18 @@
 
 Welcome! This guide will help you build your first Webflo app from scratch and get it running in minutes, even if you’ve never used the framework before. You’ll learn not just the “how,” but the “why”—and see your results live in the browser.
 
+If you're totally new here, you may want to [meet Webflo](/docs/overview).
+
+---
+
+> [!IMPORTANT]
+> 🚀 **Webflo is in active development and evolving daily.** Current status = **beta**.<br>
+> You’re welcome to experiment, but it’s not yet suited for production workloads.
+
+::: warning Work in Progress
+This documentation is a work in progress. Please expect some rough edges, missing information, and incomplete pages.
+:::
+
 ## Prerequisites
 
 - **Node.js** 18+ installed

package/site/docs.md

@@ -1,100 +1,5 @@
-# Webflo <br>— A Web-Native Framework for the Next Gen
+# Welcome to the Webflo Docs
 
-_Build the full spectrum of modern apps — backends, frontends, offline-first, and realtime apps — on raw platform power._
-
-Welcome to the docs.
-
-## What is Webflo
-
-Webflo is a web-native framework that lets you build backends, frontends, offline-first, and realtime apps absurdly fast.
-
-"Web-native." The cheatcode, if you caught it.<br>
-Just programming fundamentals and raw platform power, shipped in a framework.
-Modern apps — their sophistication and scale — solved from the foundation up.
-
-## Why Webflo
-
-Webflo shares the same broad use cases as traditional frameworks, but it is designed on an entirely different premise:
-**walk the traditional framework ladder back to programming fundamentals and sheer platform capabilities** — not merely to align with web standards, **but to put the foundations to work in new ways**. From JavaScript to HTML, to the web's transport layer, we took existing fundamentals and built new ones — to give developers less machinery, more leverage.
-
-**An engineer’s tour…**
-
-### Mutation-Based Reactivity
-
-At the foundation is an all-new reactive model: **mutation-based reactivity**, powered by the [Observer API](/docs/tech-stack#the-observer-api). With this model, Webflo anchors itself on JavaScript’s direct mutation semantics and makes it its own engine of reactivity across the whole stack — server, worker, and client. Reactivity just works as program state changes.
-This means:
-
-* **State is just objects and arrays**. With reactivity solved at the object level, no need for stores, hooks, signals, proxies, reducers, or container types. The object you see _is_ the state.
-* **Mutation becomes the shared language of reactivity across the system** — whether on the server, the service worker, or the UI.
-* **With no layers of indirection, mental model stays simple**. At any given time, you're simply either making mutations or observing mutations — exactly as you would without any framework.
-
-This enables **a new generation of apps that entirely avoid the traditional state scaffolding and the inherent cost of forbidding mutability in a mutable world as JavaScript**.
-
-### Realtime Over HTTP
-
-Webflo extends the HTTP request/response model with realtime capabilities that let request handlers opt into an interactive, realtime channel with the client — exposed as `event.client`. Webflo automatically upgrades the underlying transport and manages the request lifecycle.
-You get a capable transport layer that can be used for many things. Webflo builds on that to enable:
-
-+ **A multi-stage response model via `LiveResponse`**. Send multiple responses at different stages of request processing: `liveResponse.replaceWith()`, `event.respondWith()`, etc. Clients swap state and rerender accordingly.
-+ **Differential, live state over the wire**. Share live state with the client and mutate it in place as you deem fit: `Observer.set(liveResponse.body, name, value)`, `Observer.proxy(liveResponse.body.items).push(item)`, etc. Clients preserve state and reflect diffs. Application state goes fullstack.
-+ **Interactive request handling**. Pause request processing to interact with the user as the need may arise: `event.user.confirm()`, `event.user.prompt()`, etc. Clients initiate the corresponding dialog with the user and reply.
-
-Together with the `event.client` API itself, you get a unified surface for many different realtime apps — collaboration, multi-device presence, multiplayer, streaming progress, and more — with no extra wiring or protocols.
-
-### HTML for the Modern UI
-
-Webflo brings HTML into the application authoring equation as its direct UI language — instead of as compile target. It converges on a design that leaves the UI layer entirely in HTML terms — and upgrades the authoring experience via first-class integration with [Object-Oriented HTML (OOHTML)](/docs/tech-stack#oohtml). OOHTML extends HTML with capabilities like **modularity & reusability**, **reactivity & data binding** — **without a build step**. You get:
-
-* **Modular imports and composable templates** (`<template def>` and `<import ref>`) as first-class primitives.
-* **Scoped styles and scripts, and even scoped subtrees** without Shadow DOM complexity (`<script scoped>`, `<style scoped>`, `<div namespace>`).
-* **Reactive bindings without a compile step** — via HTML attributes and HTML comment (`<!--{ title }-->`, `<?{ title }?>`).
-
-This solves for the sophistication of modern UIs in just HTML, without the complexity of a compile step. With that out of the way, you get **edit-in-browser workflows** where the UI directly reflects live DOM manipulation via the browser inspector.
-
-### The Service Worker as an Embedded Edge Runtime
-
-Webflo brings the service worker into the application model as a full routing runtime — extending it beyond its traditional role as a cache script or network proxy.
-The shift lets you bring your application routes into the service worker, with the same routing architecture and request-handling capabilities as the server and client runtimes. This unlocks:
-
-* **Fullstack routing**. Distribute route handlers across, not two, but three runtimes (server, worker, client) as you deem fit. Same routing architecture, same request-handling capabilities.
-* **More performant client-side routing**. Move compute-intensive routing logic into the service worker runtime from the main thread to keep the UI responsive.
-* **Route-based background tasks**. Sync, periodic events, and push notifications map into routes naturally, not into separate worker-only APIs. One routing architecture for many use cases.
-
-The service worker as a new routing site exposes this underutilized layer of the platform as a _standard application surface to build on_ — like an embedded edge runtime — taking the application closer to the heart of the platform’s capabilities than traditional architectures allow.
-
----
-
-**What this means**: Webflo is an orchestration of programming fundamentals, web platform capabilities, and the web’s communication protocols into an application framework for the next generation of web apps. With just the fundamentals as the entire application stack — _and no extra thing "going on"_ — Webflo achieves a rare level of conceptual and operational simplicity that makes the sophistication of modern apps feel _almost_ trivial.
-
-## What You Can Build
-
-| Category                   | Examples & Notes                                                                                                 |
-| :------------------------- | :--------------------------------------------------------------------------------------------------------------- |
-| **Web apps**               | From classic MPAs to rich SPAs, hybrid SSR/CSR experiences, and full PWAs — all built on one unified framework. |
-| **API backends**           | REST endpoints, serverless-style handlers, and webhooks with streaming, partial responses, and live messaging.   |
-| **Static sites**           | Static-first or fully pre-rendered sites that seamlessly upgrade sections to live or interactive behavior.        |
-| **Mobile experiences**     | Installable, offline-capable PWAs with background sync, worker routing, and native-feeling navigation.            |
-| **Realtime & multiplayer** | Chats, presence, dashboards, live docs, notifications — realtime channels and dialogs available out of the box.  |
-| **AI & agents**            | Multi-step AI workflows, background agents, and automation powered by Webflo’s live request lifecycle.           |
-
-## Features
-
-| Feature                               | Description                                                                                         |
-| :------------------------------------ | :-------------------------------------------------------------------------------------------------- |
-| 📁 **Folder-based routing**           | Filesystem routing across client, worker, and server layers, with seamless interception and flow.   |
-| 🌍 **Full-stack routing & lifecycle** | Every request flows through browser, worker, and server layers using the same handler model.         |
-| 🔗 **Internal API composition**        | Reuse your own routes as local function calls via `next(path)` — no extra networking required.       |
-| 🔐 **Sessions & auth**                | Built-in cookie handling, session utilities, and helpers for gated routes and user-aware flows.     |
-| ⚡ **Realtime capabilities**           | Live responses, incremental updates, dialogs, and background channels — no explicit WebSocket setup. |
-| 🧠 **Mutation-based reactivity**       | State is plain objects and arrays; mutations drive reactivity via the Observer API.                 |
-| 🧱 **OOHTML integration**              | HTML-native templates, imports, and composition without a component DSL or build-heavy toolchain.   |
-| 📦 **Offline & worker features**       | Worker-side routing, caching, background sync, and offline-first behaviors built in.                |
-| 🧩 **Dev mode & HMR**                 | Fast development server with fine-grained rebuilds and hot updates for HTML, JS, and CSS.           |
-
-## Get Started
-
-| Path                                         | Focus                                                             |
-| :------------------------------------------- | :---------------------------------------------------------------- |
-| [Getting Started](./docs/getting-started) | Your first route and page in minutes.                             |
-| [Core Concepts](./docs/concepts)          | The mental models behind routing, request/response, and realtime. |
-| [Examples](./examples)                    | Small, focused examples.                                          |
++ [Getting Started](./docs/getting-started)
++ [Core Concepts](./docs/concepts)
++ [Examples](./examples)

package/site/index.md

@@ -2,7 +2,7 @@
 layout: home
 hero:
   name: Webflo
-  text: Modern Web Application Framework
+  text: A Web-Native Framework for the Next Gen
   tagline: Build scalable, real-time, and reactive web apps with ease.
   image:
     src: /img/brand/logo-670x670.png
@@ -12,6 +12,9 @@ hero:
     - theme: brand
       text: Get Started
       link: /docs/getting-started
+    - theme: brand
+      text: Meet Webflo
+      link: /overview
     - theme: alt
       text: Star on GitHub
       link: https://github.com/webqit/webflo

package/site/overview.md

@@ -0,0 +1,101 @@
+# Webflo <br>— A Web-Native Framework for the Next Gen
+
+_Build the full spectrum of modern apps — backends, frontends, offline-first, and realtime apps — on raw platform power._
+
+Welcome to the docs.
+
+## What is Webflo
+
+Webflo is a web-native framework that lets you build backends, frontends, offline-first, and realtime apps absurdly fast.
+
+"Web-native." The cheatcode, if you caught it.<br>
+Just programming fundamentals and raw platform power, shipped in a framework.
+Modern apps — their sophistication and scale — solved from the foundation up.
+
+## Why Webflo
+
+Webflo shares the same broad use cases as traditional frameworks, but it is designed on an entirely different premise:
+**walk the traditional framework ladder back to programming fundamentals and sheer platform capabilities** — not merely to align with web standards, **but to put the foundations to work in new ways**. From JavaScript to HTML, to the web's transport layer, we took existing fundamentals and built new ones — to give developers less machinery, more leverage.
+
+**An engineer’s tour…**
+
+### Mutation-Based Reactivity
+
+At the foundation is an all-new reactive model: **mutation-based reactivity**, powered by the [Observer API](https://github.com/webqit/observer). With this model, Webflo anchors itself on JavaScript’s direct mutation semantics and makes it its own engine of reactivity across the whole stack — server, worker, and client. Reactivity just works as program state changes.
+This means:
+
+* **State is just objects and arrays**. With reactivity solved at the object level, no need for stores, hooks, signals, proxies, reducers, or container types. The object you see _is_ the state.
+* **Mutation becomes the shared language of reactivity across the system** — whether on the server, the service worker, or the UI.
+* **With no layers of indirection, mental model stays simple**. At any given time, you're simply either making mutations or observing mutations — exactly as you would without any framework.
+
+This enables **a new generation of apps that entirely avoid the traditional state scaffolding and the inherent cost of forbidding mutability in a mutable world as JavaScript**.
+
+### Realtime Over HTTP
+
+Webflo extends the HTTP request/response model with realtime capabilities that let request handlers opt into an interactive, realtime channel with the client — exposed as `event.client`. Webflo automatically upgrades the underlying transport and manages the request lifecycle.
+You get a capable transport layer that can be used for many things. Webflo builds on that to enable:
+
++ **A multi-stage response model via `LiveResponse`**. Send multiple responses at different stages of request processing: `liveResponse.replaceWith()`, `event.respondWith()`, etc. Clients swap state and rerender accordingly.
++ **Differential, live state over the wire**. Share live state with the client and mutate it in place as you deem fit: `Observer.set(liveResponse.body, name, value)`, `Observer.proxy(liveResponse.body.items).push(item)`, etc. Clients preserve state and reflect diffs. Application state goes fullstack.
++ **Interactive request handling**. Pause request processing to interact with the user as the need may arise: `event.user.confirm()`, `event.user.prompt()`, etc. Clients initiate the corresponding dialog with the user and reply.
+
+Together with the `event.client` API itself, you get a unified surface for many different realtime apps — collaboration, multi-device presence, multiplayer, streaming progress, and more — with no extra wiring or protocols.
+
+### HTML for the Modern UI
+
+Webflo brings HTML into the application authoring equation as its direct UI language — instead of as compile target. It converges on a design that leaves the UI layer entirely in HTML terms — and upgrades the authoring experience via first-class integration with [Object-Oriented HTML (OOHTML)](https://github.com/webqit/oohtml). OOHTML extends HTML with capabilities like **modularity & reusability**, **reactivity & data binding** — **without a build step**. You get:
+
+* **Modular imports and composable templates** (`<template def>` and `<import ref>`) as first-class primitives.
+* **Scoped styles and scripts, and even scoped subtrees** without Shadow DOM complexity (`<script scoped>`, `<style scoped>`, `<div namespace>`).
+* **Reactive bindings without a compile step** — via HTML attributes and HTML comments (`<!--{ title }-->`, `<?{ title }?>`).
+
+This solves for the sophistication of modern UIs in just HTML, without the complexity of a compile step. With that out of the way, you get **edit-in-browser workflows** where the UI directly reflects live DOM manipulation via the browser inspector.
+
+### The Service Worker as an Embedded Edge Runtime
+
+Webflo brings the service worker into the application model as a full routing runtime — extending it beyond its traditional role as a cache script or network proxy.
+The shift lets you bring your application routes into the service worker, with the same routing architecture and request-handling capabilities as the server and client runtimes. This unlocks:
+
+* **Fullstack routing**. Distribute route handlers across, not two, but three runtimes (server, worker, client) as you deem fit. Same routing architecture, same request-handling capabilities.
+* **More performant client-side routing**. Move compute-intensive routing logic into the service worker runtime from the main thread to keep the UI responsive.
+* **Route-based background tasks**. Sync, periodic events, and push notifications map into routes naturally, not into separate worker-only APIs. One routing architecture for many use cases.
+
+The service worker as a new routing site exposes this underutilized layer of the platform as a _standard application surface to build on_ — like an embedded edge runtime — taking the application closer to the heart of the platform’s capabilities than traditional architectures allow.
+
+---
+
+**What this means**: Webflo is an orchestration of programming fundamentals, web platform capabilities, and the web’s communication protocols into an application framework. With just the fundamentals as the entire application stack — _and no extra thing "going on"_ — Webflo achieves a rare level of conceptual and operational simplicity that makes really complex modern apps feel _almost_ trivial.
+
+## What You Can Build
+
+| Category                   | Examples & Notes                                                                                                 |
+| :------------------------- | :--------------------------------------------------------------------------------------------------------------- |
+| **Web apps**               | From classic MPAs to rich SPAs, hybrid SSR/CSR experiences, and full PWAs — all built on one unified framework. |
+| **API backends**           | REST endpoints, serverless-style handlers, and webhooks with streaming, partial responses, and live messaging.   |
+| **Static sites**           | Static-first or fully pre-rendered sites that seamlessly upgrade sections to live or interactive behavior.        |
+| **Mobile experiences**     | Installable, offline-capable PWAs with background sync, worker routing, and native-feeling navigation.            |
+| **Realtime & multiplayer** | Chats, presence, dashboards, live docs, notifications — realtime channels and dialogs available out of the box.  |
+| **AI & agents**            | Multi-step AI workflows, background agents, and automation powered by Webflo’s live request lifecycle.           |
+
+## Features
+
+| Feature                               | Description                                                                                         |
+| :------------------------------------ | :-------------------------------------------------------------------------------------------------- |
+| 📁 **Folder-based routing**           | Filesystem routing across client, worker, and server layers, with seamless interception and flow.   |
+| 🌍 **Full-stack routing & lifecycle** | Every request flows through browser, worker, and server layers using the same handler model.         |
+| 🔗 **Internal API composition**        | Reuse your own routes as local function calls via `next(path)` — no extra networking required.       |
+| 🔐 **Sessions & auth**                | Built-in cookie handling, session utilities, and helpers for gated routes and user-aware flows.     |
+| ⚡ **Realtime capabilities**           | Live responses, incremental updates, dialogs, and background channels — no explicit WebSocket setup. |
+| 🧠 **Mutation-based reactivity**       | State is plain objects and arrays; mutations drive reactivity via the Observer API.                 |
+| 🧱 **OOHTML integration**              | HTML-native templates, imports, and composition without a component DSL or build-heavy toolchain.   |
+| 📦 **Offline & worker features**       | Worker-side routing, caching, background sync, and offline-first behaviors built in.                |
+| 🧩 **Dev mode & HMR**                 | Fast development server with fine-grained rebuilds and hot updates for HTML, JS, and CSS.           |
+
+## Get Started
+
+| Path                                         | Focus                                                             |
+| :------------------------------------------- | :---------------------------------------------------------------- |
+| [Getting Started](./docs/getting-started) | Your first route and page in minutes.                             |
+| [Core Concepts](./docs/concepts)          | The mental models behind routing, request/response, and realtime. |
+| [Examples](./examples)                    | Small, focused examples.                                          |
+

package/site/.vitepress/cache/deps_temp_9b107c53/@braintree_sanitize-url.js

@@ -1,93 +0,0 @@
-import {
-  __commonJS
-} from "./chunk-BUSYA2B4.js";
-
-// node_modules/@braintree/sanitize-url/dist/constants.js
-var require_constants = __commonJS({
-  "node_modules/@braintree/sanitize-url/dist/constants.js"(exports) {
-    "use strict";
-    Object.defineProperty(exports, "__esModule", { value: true });
-    exports.BLANK_URL = exports.relativeFirstCharacters = exports.whitespaceEscapeCharsRegex = exports.urlSchemeRegex = exports.ctrlCharactersRegex = exports.htmlCtrlEntityRegex = exports.htmlEntitiesRegex = exports.invalidProtocolRegex = void 0;
-    exports.invalidProtocolRegex = /^([^\w]*)(javascript|data|vbscript)/im;
-    exports.htmlEntitiesRegex = /&#(\w+)(^\w|;)?/g;
-    exports.htmlCtrlEntityRegex = /&(newline|tab);/gi;
-    exports.ctrlCharactersRegex = /[\u0000-\u001F\u007F-\u009F\u2000-\u200D\uFEFF]/gim;
-    exports.urlSchemeRegex = /^.+(:|:)/gim;
-    exports.whitespaceEscapeCharsRegex = /(\\|%5[cC])((%(6[eE]|72|74))|[nrt])/g;
-    exports.relativeFirstCharacters = [".", "/"];
-    exports.BLANK_URL = "about:blank";
-  }
-});
-
-// node_modules/@braintree/sanitize-url/dist/index.js
-var require_dist = __commonJS({
-  "node_modules/@braintree/sanitize-url/dist/index.js"(exports) {
-    Object.defineProperty(exports, "__esModule", { value: true });
-    exports.sanitizeUrl = void 0;
-    var constants_1 = require_constants();
-    function isRelativeUrlWithoutProtocol(url) {
-      return constants_1.relativeFirstCharacters.indexOf(url[0]) > -1;
-    }
-    function decodeHtmlCharacters(str) {
-      var removedNullByte = str.replace(constants_1.ctrlCharactersRegex, "");
-      return removedNullByte.replace(constants_1.htmlEntitiesRegex, function(match, dec) {
-        return String.fromCharCode(dec);
-      });
-    }
-    function isValidUrl(url) {
-      return URL.canParse(url);
-    }
-    function decodeURI(uri) {
-      try {
-        return decodeURIComponent(uri);
-      } catch (e) {
-        return uri;
-      }
-    }
-    function sanitizeUrl(url) {
-      if (!url) {
-        return constants_1.BLANK_URL;
-      }
-      var charsToDecode;
-      var decodedUrl = decodeURI(url.trim());
-      do {
-        decodedUrl = decodeHtmlCharacters(decodedUrl).replace(constants_1.htmlCtrlEntityRegex, "").replace(constants_1.ctrlCharactersRegex, "").replace(constants_1.whitespaceEscapeCharsRegex, "").trim();
-        decodedUrl = decodeURI(decodedUrl);
-        charsToDecode = decodedUrl.match(constants_1.ctrlCharactersRegex) || decodedUrl.match(constants_1.htmlEntitiesRegex) || decodedUrl.match(constants_1.htmlCtrlEntityRegex) || decodedUrl.match(constants_1.whitespaceEscapeCharsRegex);
-      } while (charsToDecode && charsToDecode.length > 0);
-      var sanitizedUrl = decodedUrl;
-      if (!sanitizedUrl) {
-        return constants_1.BLANK_URL;
-      }
-      if (isRelativeUrlWithoutProtocol(sanitizedUrl)) {
-        return sanitizedUrl;
-      }
-      var trimmedUrl = sanitizedUrl.trimStart();
-      var urlSchemeParseResults = trimmedUrl.match(constants_1.urlSchemeRegex);
-      if (!urlSchemeParseResults) {
-        return sanitizedUrl;
-      }
-      var urlScheme = urlSchemeParseResults[0].toLowerCase().trim();
-      if (constants_1.invalidProtocolRegex.test(urlScheme)) {
-        return constants_1.BLANK_URL;
-      }
-      var backSanitized = trimmedUrl.replace(/\\/g, "/");
-      if (urlScheme === "mailto:" || urlScheme.includes("://")) {
-        return backSanitized;
-      }
-      if (urlScheme === "http:" || urlScheme === "https:") {
-        if (!isValidUrl(backSanitized)) {
-          return constants_1.BLANK_URL;
-        }
-        var url_1 = new URL(backSanitized);
-        url_1.protocol = url_1.protocol.toLowerCase();
-        url_1.hostname = url_1.hostname.toLowerCase();
-        return url_1.toString();
-      }
-      return backSanitized;
-    }
-    exports.sanitizeUrl = sanitizeUrl;
-  }
-});
-export default require_dist();
-//# sourceMappingURL=@braintree_sanitize-url.js.map

package/site/.vitepress/cache/deps_temp_9b107c53/@braintree_sanitize-url.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../node_modules/@braintree/sanitize-url/dist/constants.js", "../../../../node_modules/@braintree/sanitize-url/dist/index.js"],
-  "sourcesContent": ["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.BLANK_URL = exports.relativeFirstCharacters = exports.whitespaceEscapeCharsRegex = exports.urlSchemeRegex = exports.ctrlCharactersRegex = exports.htmlCtrlEntityRegex = exports.htmlEntitiesRegex = exports.invalidProtocolRegex = void 0;\nexports.invalidProtocolRegex = /^([^\\w]*)(javascript|data|vbscript)/im;\nexports.htmlEntitiesRegex = /&#(\\w+)(^\\w|;)?/g;\nexports.htmlCtrlEntityRegex = /&(newline|tab);/gi;\nexports.ctrlCharactersRegex = /[\\u0000-\\u001F\\u007F-\\u009F\\u2000-\\u200D\\uFEFF]/gim;\nexports.urlSchemeRegex = /^.+(:|:)/gim;\nexports.whitespaceEscapeCharsRegex = /(\\\\|%5[cC])((%(6[eE]|72|74))|[nrt])/g;\nexports.relativeFirstCharacters = [\".\", \"/\"];\nexports.BLANK_URL = \"about:blank\";\n", "\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.sanitizeUrl = void 0;\nvar constants_1 = require(\"./constants\");\nfunction isRelativeUrlWithoutProtocol(url) {\n    return constants_1.relativeFirstCharacters.indexOf(url[0]) > -1;\n}\nfunction decodeHtmlCharacters(str) {\n    var removedNullByte = str.replace(constants_1.ctrlCharactersRegex, \"\");\n    return removedNullByte.replace(constants_1.htmlEntitiesRegex, function (match, dec) {\n        return String.fromCharCode(dec);\n    });\n}\nfunction isValidUrl(url) {\n    return URL.canParse(url);\n}\nfunction decodeURI(uri) {\n    try {\n        return decodeURIComponent(uri);\n    }\n    catch (e) {\n        // Ignoring error\n        // It is possible that the URI contains a `%` not associated\n        // with URI/URL-encoding.\n        return uri;\n    }\n}\nfunction sanitizeUrl(url) {\n    if (!url) {\n        return constants_1.BLANK_URL;\n    }\n    var charsToDecode;\n    var decodedUrl = decodeURI(url.trim());\n    do {\n        decodedUrl = decodeHtmlCharacters(decodedUrl)\n            .replace(constants_1.htmlCtrlEntityRegex, \"\")\n            .replace(constants_1.ctrlCharactersRegex, \"\")\n            .replace(constants_1.whitespaceEscapeCharsRegex, \"\")\n            .trim();\n        decodedUrl = decodeURI(decodedUrl);\n        charsToDecode =\n            decodedUrl.match(constants_1.ctrlCharactersRegex) ||\n                decodedUrl.match(constants_1.htmlEntitiesRegex) ||\n                decodedUrl.match(constants_1.htmlCtrlEntityRegex) ||\n                decodedUrl.match(constants_1.whitespaceEscapeCharsRegex);\n    } while (charsToDecode && charsToDecode.length > 0);\n    var sanitizedUrl = decodedUrl;\n    if (!sanitizedUrl) {\n        return constants_1.BLANK_URL;\n    }\n    if (isRelativeUrlWithoutProtocol(sanitizedUrl)) {\n        return sanitizedUrl;\n    }\n    // Remove any leading whitespace before checking the URL scheme\n    var trimmedUrl = sanitizedUrl.trimStart();\n    var urlSchemeParseResults = trimmedUrl.match(constants_1.urlSchemeRegex);\n    if (!urlSchemeParseResults) {\n        return sanitizedUrl;\n    }\n    var urlScheme = urlSchemeParseResults[0].toLowerCase().trim();\n    if (constants_1.invalidProtocolRegex.test(urlScheme)) {\n        return constants_1.BLANK_URL;\n    }\n    var backSanitized = trimmedUrl.replace(/\\\\/g, \"/\");\n    // Handle special cases for mailto: and custom deep-link protocols\n    if (urlScheme === \"mailto:\" || urlScheme.includes(\"://\")) {\n        return backSanitized;\n    }\n    // For http and https URLs, perform additional validation\n    if (urlScheme === \"http:\" || urlScheme === \"https:\") {\n        if (!isValidUrl(backSanitized)) {\n            return constants_1.BLANK_URL;\n        }\n        var url_1 = new URL(backSanitized);\n        url_1.protocol = url_1.protocol.toLowerCase();\n        url_1.hostname = url_1.hostname.toLowerCase();\n        return url_1.toString();\n    }\n    return backSanitized;\n}\nexports.sanitizeUrl = sanitizeUrl;\n"],
-  "mappings": ";;;;;AAAA;AAAA;AAAA;AACA,WAAO,eAAe,SAAS,cAAc,EAAE,OAAO,KAAK,CAAC;AAC5D,YAAQ,YAAY,QAAQ,0BAA0B,QAAQ,6BAA6B,QAAQ,iBAAiB,QAAQ,sBAAsB,QAAQ,sBAAsB,QAAQ,oBAAoB,QAAQ,uBAAuB;AAC3O,YAAQ,uBAAuB;AAC/B,YAAQ,oBAAoB;AAC5B,YAAQ,sBAAsB;AAC9B,YAAQ,sBAAsB;AAC9B,YAAQ,iBAAiB;AACzB,YAAQ,6BAA6B;AACrC,YAAQ,0BAA0B,CAAC,KAAK,GAAG;AAC3C,YAAQ,YAAY;AAAA;AAAA;;;ACVpB;AAAA;AACA,WAAO,eAAe,SAAS,cAAc,EAAE,OAAO,KAAK,CAAC;AAC5D,YAAQ,cAAc;AACtB,QAAI,cAAc;AAClB,aAAS,6BAA6B,KAAK;AACvC,aAAO,YAAY,wBAAwB,QAAQ,IAAI,CAAC,CAAC,IAAI;AAAA,IACjE;AACA,aAAS,qBAAqB,KAAK;AAC/B,UAAI,kBAAkB,IAAI,QAAQ,YAAY,qBAAqB,EAAE;AACrE,aAAO,gBAAgB,QAAQ,YAAY,mBAAmB,SAAU,OAAO,KAAK;AAChF,eAAO,OAAO,aAAa,GAAG;AAAA,MAClC,CAAC;AAAA,IACL;AACA,aAAS,WAAW,KAAK;AACrB,aAAO,IAAI,SAAS,GAAG;AAAA,IAC3B;AACA,aAAS,UAAU,KAAK;AACpB,UAAI;AACA,eAAO,mBAAmB,GAAG;AAAA,MACjC,SACO,GAAG;AAIN,eAAO;AAAA,MACX;AAAA,IACJ;AACA,aAAS,YAAY,KAAK;AACtB,UAAI,CAAC,KAAK;AACN,eAAO,YAAY;AAAA,MACvB;AACA,UAAI;AACJ,UAAI,aAAa,UAAU,IAAI,KAAK,CAAC;AACrC,SAAG;AACC,qBAAa,qBAAqB,UAAU,EACvC,QAAQ,YAAY,qBAAqB,EAAE,EAC3C,QAAQ,YAAY,qBAAqB,EAAE,EAC3C,QAAQ,YAAY,4BAA4B,EAAE,EAClD,KAAK;AACV,qBAAa,UAAU,UAAU;AACjC,wBACI,WAAW,MAAM,YAAY,mBAAmB,KAC5C,WAAW,MAAM,YAAY,iBAAiB,KAC9C,WAAW,MAAM,YAAY,mBAAmB,KAChD,WAAW,MAAM,YAAY,0BAA0B;AAAA,MACnE,SAAS,iBAAiB,cAAc,SAAS;AACjD,UAAI,eAAe;AACnB,UAAI,CAAC,cAAc;AACf,eAAO,YAAY;AAAA,MACvB;AACA,UAAI,6BAA6B,YAAY,GAAG;AAC5C,eAAO;AAAA,MACX;AAEA,UAAI,aAAa,aAAa,UAAU;AACxC,UAAI,wBAAwB,WAAW,MAAM,YAAY,cAAc;AACvE,UAAI,CAAC,uBAAuB;AACxB,eAAO;AAAA,MACX;AACA,UAAI,YAAY,sBAAsB,CAAC,EAAE,YAAY,EAAE,KAAK;AAC5D,UAAI,YAAY,qBAAqB,KAAK,SAAS,GAAG;AAClD,eAAO,YAAY;AAAA,MACvB;AACA,UAAI,gBAAgB,WAAW,QAAQ,OAAO,GAAG;AAEjD,UAAI,cAAc,aAAa,UAAU,SAAS,KAAK,GAAG;AACtD,eAAO;AAAA,MACX;AAEA,UAAI,cAAc,WAAW,cAAc,UAAU;AACjD,YAAI,CAAC,WAAW,aAAa,GAAG;AAC5B,iBAAO,YAAY;AAAA,QACvB;AACA,YAAI,QAAQ,IAAI,IAAI,aAAa;AACjC,cAAM,WAAW,MAAM,SAAS,YAAY;AAC5C,cAAM,WAAW,MAAM,SAAS,YAAY;AAC5C,eAAO,MAAM,SAAS;AAAA,MAC1B;AACA,aAAO;AAAA,IACX;AACA,YAAQ,cAAc;AAAA;AAAA;",
-  "names": []
-}

package/site/.vitepress/cache/deps_temp_9b107c53/chunk-BUSYA2B4.js

@@ -1,9 +0,0 @@
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __commonJS = (cb, mod) => function __require() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-};
-
-export {
-  __commonJS
-};
-//# sourceMappingURL=chunk-BUSYA2B4.js.map

package/site/.vitepress/cache/deps_temp_9b107c53/chunk-BUSYA2B4.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": [],
-  "sourcesContent": [],
-  "mappings": "",
-  "names": []
-}