try with manual writing

* reduce replacer time from 9 seconds to 3 seconds

* prettier

* prettier

.github/ISSUE_TEMPLATE/config.yml

@@ -1,4 +1,7 @@
 contact_links:
+  - name: Feature Requests
+    url: https://github.com/shoelace-style/shoelace/discussions/categories/ideas
+    about: All requests for new features should go here.
   - name: Help & Support
     url: https://github.com/shoelace-style/shoelace/discussions/categories/help
     about: Please don't create issues for personal help requests. Instead, ask your question on the discussion forum.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,15 +0,0 @@
----
-name: Feature Request
-about: Suggest an idea for this project.
-title: ''
-labels: feature
----
-
-### What issue are you having?
-Provide a clear and concise description of the problem you're facing.
-
-### Describe the solution you'd like
-How would you like to see the library solve it?
-
-### Describe alternatives you've considered
-In what ways have you tried to solve this with the current version?

.github/SECURITY.md

@@ -1,7 +1,7 @@
 # Reporting Security Issues
 
-We take security issues in Shoelace very seriously and appreciate your efforts to disclose your findings responsibly.
+We take security issues in Web Awesome very seriously and appreciate your efforts to disclose your findings responsibly.
 
-To report a security issue, email [cory@abeautifulsite.net](mailto:cory@abeautifulsite.net) and include "SHOELACE SECURITY" in the subject line.
+To report a security issue, email [cory@fontawesome.com](mailto:cory@abeautifulsite.net) and include "WEB AWESOME SECURITY" in the subject line.
 
 We'll respond as soon as possible and keep you updated throughout the process.

.gitignore

@@ -1,9 +1,10 @@
 _site
 .cache
 .DS_Store
+package.json
+package-lock.json
 dist
 docs/assets/images/sprite.svg
 node_modules
 src/react
 cdn
-web-types.json

.vscode/settings.json

@@ -3,5 +3,6 @@
   "editor.defaultFormatter": "esbenp.prettier-vscode",
   "editor.codeActionsOnSave": {
     "source.fixAll.eslint": true
-  }
+  },
+  "debug.enableStatusBarColor": false
 }

CONTRIBUTING.md

@@ -1,4 +1,4 @@
-# Contributing to Shoelace
+# Contributing to Web Awesome
 
 Before contributing, please review the contributions guidelines at:
 

LICENSE.md

@@ -1,4 +1,4 @@
-Copyright (c) 2020 A Beautiful Site, LLC
+Copyright (c) 2023 Fonticons, Inc.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

README.md

@@ -1,4 +1,4 @@
-# Shoelace
+# Web Awesome
 
 A forward-thinking library of web components.
 
@@ -9,7 +9,7 @@ A forward-thinking library of web components.
 - Built with accessibility in mind ♿️
 - Open source 😸
 
-Designed in New Hampshire by [Cory LaViska](https://twitter.com/claviska).
+Built by the folks behind [Font Awesome](https://fontawesome.com/).
 
 ---
 
@@ -21,15 +21,15 @@ Twitter: [@shoelace_style](https://twitter.com/shoelace_style)
 
 ---
 
-## Shoemakers 🥾
+## Developers ✨
 
-Shoemakers, or "Shoelace developers," can use this documentation to learn how to build Shoelace from source. You will need Node >= 14.17 to build and run the project locally.
+Developers can use this documentation to learn how to build Web Awesome from source. You will need Node >= 14.17 to build and run the project locally.
 
-**You don't need to do any of this to use Shoelace!** This page is for people who want to contribute to the project, tinker with the source, or create a custom build of Shoelace.
+**You don't need to do any of this to use Web Awesome!** This page is for people who want to contribute to the project, tinker with the source, or create a custom build of Web Awesome.
 
 If that's not what you're trying to do, the [documentation website](https://shoelace.style) is where you want to be.
 
-### What are you using to build Shoelace?
+### What are you using to build Web Awesome?
 
 Components are built with [LitElement](https://lit-element.polymer-project.org/), a custom elements base class that provides an intuitive API and reactive data binding. The build is a custom script with bundling powered by [esbuild](https://esbuild.github.io/).
 
@@ -38,8 +38,8 @@ Components are built with [LitElement](https://lit-element.polymer-project.org/)
 Start by [forking the repo](https://github.com/shoelace-style/shoelace/fork) on GitHub, then clone it locally and install dependencies.
 
 ```bash
-git clone https://github.com/YOUR_GITHUB_USERNAME/shoelace
-cd shoelace
+git clone https://github.com/YOUR_GITHUB_USERNAME/webawesome
+cd webawesome
 npm install
 ```
 
@@ -63,30 +63,18 @@ npm run build
 
 ### Creating New Components
 
-To scaffold a new component, run the following command, replacing `sl-tag-name` with the desired tag name.
+To scaffold a new component, run the following command, replacing `wa-tag-name` with the desired tag name.
 
 ```bash
-npm run create sl-tag-name
+npm run create wa-tag-name
 ```
 
 This will generate a source file, a stylesheet, and a docs page for you. When you start the dev server, you'll find the new component in the "Components" section of the sidebar.
 
 ### Contributing
 
-Shoelace is an open source project and contributions are encouraged! If you're interesting in contributing, please review the [contribution guidelines](CONTRIBUTING.md) first.
+Web Awesome is an open source project and contributions are encouraged! If you're interesting in contributing, please review the [contribution guidelines](CONTRIBUTING.md) first.
 
 ## License
 
-Shoelace is designed in New Hampshire by [Cory LaViska](https://twitter.com/claviska). It’s available under the terms of the MIT license.
-
-Designing, developing, and supporting this library requires a lot of time, effort, and skill. I’d like to keep it open source so everyone can use it, but that doesn’t provide me with any income.
-
-**Therefore, if you’re using my software to make a profit,** I respectfully ask that you help [fund its development](https://github.com/sponsors/claviska) by becoming a sponsor. There are multiple tiers to choose from with benefits at every level, including prioritized support, bug fixes, feature requests, and advertising.
-
-👇 Your support is very much appreciated! 👇
-
-- [Become a sponsor](https://github.com/sponsors/claviska)
-- [Star on GitHub](https://github.com/shoelace-style/shoelace/stargazers)
-- [Follow on Twitter](https://twitter.com/shoelace_style)
-
-Whether you're building Shoelace or building something _with_ Shoelace — have fun creating! 🥾
+Web Awesome is available under the terms of the MIT license.

cspell.json

@@ -29,6 +29,7 @@
     "colour",
     "combobox",
     "Commonmark",
+    "compat",
     "Composability",
     "Consolas",
     "contenteditable",
@@ -89,6 +90,7 @@
     "listbox",
     "listitem",
     "litelement",
+    "longform",
     "lowercasing",
     "Lucide",
     "maxlength",
@@ -109,10 +111,13 @@
     "novalidate",
     "npmdir",
     "Numberish",
+    "oklab",
+    "oklch",
     "outdir",
     "ParamagicDev",
     "peta",
     "petabit",
+    "Preact",
     "prismjs",
     "progressbar",
     "radiogroup",
@@ -165,9 +170,10 @@
     "valpha",
     "valuenow",
     "valuetext",
+    "WCAG",
+    "webawesome",
     "WEBP",
-    "Webpacker",
-    "wordmark"
+    "Webpacker"
   ],
   "ignorePaths": [
     "package.json",

custom-elements-manifest.config.js

@@ -33,14 +33,14 @@ export default {
   plugins: [
     // Append package data
     {
-      name: 'shoelace-package-data',
+      name: 'wa-package-data',
       packageLinkPhase({ customElementsManifest }) {
         customElementsManifest.package = { name, description, version, author, homepage, license };
       }
     },
     // Infer tag names because we no longer use @customElement decorators.
     {
-      name: 'shoelace-infer-tag-names',
+      name: 'wa-infer-tag-names',
       analyzePhase({ ts, node, moduleDoc }) {
         switch (node.kind) {
           case ts.SyntaxKind.ClassDeclaration: {
@@ -55,7 +55,7 @@ export default {
             }
 
             const tagNameWithoutPrefix = path.basename(importPath, '.component.ts');
-            const tagName = 'sl-' + tagNameWithoutPrefix;
+            const tagName = 'wa-' + tagNameWithoutPrefix;
 
             classDoc.tagNameWithoutPrefix = tagNameWithoutPrefix;
             classDoc.tagName = tagName;
@@ -68,7 +68,7 @@ export default {
     },
     // Parse custom jsDoc tags
     {
-      name: 'shoelace-custom-tags',
+      name: 'wa-custom-tags',
       analyzePhase({ ts, node, moduleDoc }) {
         switch (node.kind) {
           case ts.SyntaxKind.ClassDeclaration: {
@@ -138,7 +138,7 @@ export default {
       }
     },
     {
-      name: 'shoelace-react-event-names',
+      name: 'wa-react-event-names',
       analyzePhase({ ts, node, moduleDoc }) {
         switch (node.kind) {
           case ts.SyntaxKind.ClassDeclaration: {
@@ -156,7 +156,7 @@ export default {
       }
     },
     {
-      name: 'shoelace-translate-module-paths',
+      name: 'wa-translate-module-paths',
       packageLinkPhase({ customElementsManifest }) {
         customElementsManifest?.modules?.forEach(mod => {
           //
@@ -198,16 +198,17 @@ export default {
       referencesTemplate: (_, tag) => [
         {
           name: 'Documentation',
-          url: `https://shoelace.style/components/${tag.replace('sl-', '')}`
+          url: `https://shoelace.style/components/${tag.replace('wa-', '')}`
         }
       ]
     }),
     customElementJetBrainsPlugin({
+      outdir: './dist',
       excludeCss: true,
       referencesTemplate: (_, tag) => {
         return {
           name: 'Documentation',
-          url: `https://shoelace.style/components/${tag.replace('sl-', '')}`
+          url: `https://shoelace.style/components/${tag.replace('wa-', '')}`
         };
       }
     })

docs/_includes/component.njk

@@ -1,12 +1,12 @@
 {% extends "default.njk" %}
 
 {# Find the component based on the `tag` front matter #}
-{% set component = getComponent('sl-' + page.fileSlug) %}
+{% set component = getComponent('wa-' + page.fileSlug) %}
 
 {% block content %}
   {# Determine the badge variant #}
   {% if component.status == 'stable' %}
-    {% set badgeVariant = 'primary' %}
+    {% set badgeVariant = 'brand' %}
   {% elseif component.status == 'experimental' %}
     {% set badgeVariant = 'warning' %}
   {% elseif component.status == 'planned' %}
@@ -26,12 +26,12 @@
     </div>
 
     <div class="component-header__info">
-      <sl-badge variant="neutral" pill>
+      <wa-badge variant="neutral" pill>
         Since {{component.since or '?' }}
-      </sl-badge>
-      <sl-badge variant="{{ badgeVariant }}" pill style="text-transform: capitalize;">
+      </wa-badge>
+      <wa-badge variant="{{ badgeVariant }}" pill style="text-transform: capitalize;">
         {{ component.status }}
-      </sl-badge>
+      </wa-badge>
     </div>
   </header>
 
@@ -51,42 +51,42 @@
     any of the following snippets to <a href="/getting-started/installation#cherry-picking">cherry pick</a> this component.
   </p>
 
-  <sl-tab-group>
-    <sl-tab slot="nav" panel="script">Script</sl-tab>
-    <sl-tab slot="nav" panel="import">Import</sl-tab>
-    <sl-tab slot="nav" panel="bundler">Bundler</sl-tab>
-    <sl-tab slot="nav" panel="react">React</sl-tab>
+  <wa-tab-group>
+    <wa-tab slot="nav" panel="script">Script</wa-tab>
+    <wa-tab slot="nav" panel="import">Import</wa-tab>
+    <wa-tab slot="nav" panel="bundler">Bundler</wa-tab>
+    <wa-tab slot="nav" panel="react">React</wa-tab>
 
-    <sl-tab-panel name="script">
+    <wa-tab-panel name="script">
       <p>
         To import this component from <a href="https://www.jsdelivr.com/package/npm/@shoelace-style/shoelace">the CDN</a>
         using a script tag:
       </p>
       <pre><code class="language-html">&lt;script type=&quot;module&quot; src=&quot;https://cdn.jsdelivr.net/npm/@shoelace-style/shoelace@{{ meta.version }}/{{ meta.cdndir }}/{{ component.path }}&quot;&gt;&lt;/script&gt;</code></pre>
-    </sl-tab-panel>
+    </wa-tab-panel>
 
-    <sl-tab-panel name="import">
+    <wa-tab-panel name="import">
       <p>
         To import this component from <a href="https://www.jsdelivr.com/package/npm/@shoelace-style/shoelace">the CDN</a>
         using a JavaScript import:
       </p>
       <pre><code class="language-js">import 'https://cdn.jsdelivr.net/npm/@shoelace-style/shoelace@{{ meta.version }}/{{ meta.cdndir }}/{{ component.path }}';</code></pre>
-    </sl-tab-panel>
+    </wa-tab-panel>
 
-    <sl-tab-panel name="bundler">
+    <wa-tab-panel name="bundler">
       <p>
         To import this component using <a href="{{ rootUrl('/getting-started/installation#bundling') }}">a bundler</a>:
       </p>
       <pre><code class="language-js">import '@shoelace-style/shoelace/{{ meta.npmdir }}/{{ component.path }}';</code></pre>
-    </sl-tab-panel>
+    </wa-tab-panel>
 
-    <sl-tab-panel name="react">
+    <wa-tab-panel name="react">
       <p>
         To import this component as a <a href="/frameworks/react">React component</a>:
       </p>
       <pre><code class="language-js">import {{ component.name }} from '@shoelace-style/shoelace/{{ meta.npmdir }}/react/{{ component.tagNameWithoutPrefix }}';</code></pre>
-    </sl-tab-panel>
-  </sl-tab-group>
+    </wa-tab-panel>
+  </wa-tab-group>
 
   {# Slots #}
   {% if component.slots.length %}
@@ -140,13 +140,13 @@
               {% if prop.attribute | length > 0 %}
                 {% if prop.attribute != prop.name %}
                   <br>
-                  <sl-tooltip content="This attribute is different from its property">
+                  <wa-tooltip content="This attribute is different from its property">
                     <small>
                       <code class="nowrap">
                         {{ prop.attribute }}
                       </code>
                     </small>
-                  </sl-tooltip>
+                  </wa-tooltip>
                 {% endif %}
               {% endif %}
             </td>
@@ -155,7 +155,7 @@
             </td>
             <td style="text-align: center;">
               {% if prop.reflects %}
-                <sl-icon label="yes" name="check-lg"></sl-icon>
+                <wa-icon label="yes" name="check-lg"></wa-icon>
               {% endif %}
             </td>
             <td>

docs/_includes/default.njk

@@ -2,7 +2,7 @@
 <html
   lang="en"
   data-layout="{{ layout }}"
-  data-shoelace-version="{{ meta.version }}"
+  data-wa-version="{{ meta.version }}"
 >
   <head>
     {# Metadata #}
@@ -20,7 +20,7 @@
     <link rel="stylesheet" href="{{ assetUrl('styles/search.css') }}" />
 
     {# Favicons #}
-    <link rel="icon" href="{{ assetUrl('images/logo.svg') }}" type="image/x-icon" />
+    <link rel="icon" href="{{ assetUrl('images/favicon.svg') }}" type="image/x-icon" />
 
     {# Twitter Cards #}
     <meta name="twitter:card" content="summary" />
@@ -33,20 +33,26 @@
     <meta property="og:description" content="{{ meta.description }}" />
     <meta property="og:image" content="{{ assetUrl(meta.image, true) }}" />
 
-    {# Shoelace #}
-    <link rel="stylesheet" href="/dist/themes/light.css" />
-    <link rel="stylesheet" href="/dist/themes/dark.css" />
-    <script type="module" src="/dist/shoelace-autoloader.js"></script>
+    {# Web Awesome #}
+    <link rel="stylesheet" href="/dist/themes/applied.css" />
+    <link rel="stylesheet" href="/dist/themes/forms.css" />
+    <link id="theme-stylesheet" rel="stylesheet" href="/dist/themes/default.css" />
+    <script type="module" src="/dist/autoloader.js"></script>
 
     {# Set the initial theme and menu states here to prevent flashing #}
     <script>
       (() => {
         const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
         const theme = localStorage.getItem('theme') || 'auto';
-        document.documentElement.classList.toggle('sl-theme-dark', theme === 'dark' || (theme === 'auto' && prefersDark));
+        document.documentElement.classList.toggle('wa-theme-default-dark', theme === 'dark' || (theme === 'auto' && prefersDark));
       })();
     </script>
 
+    {# Web Fonts #}
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?family=Lora:ital,wght@0,400;0,500;0,600;1,400;1,500;1,600&family=Noto+Sans+Mono&display=swap" rel="stylesheet">
+
     {# Turbo + Scroll positioning #}
     <script src="{{ assetUrl('scripts/turbo.js') }}" type="module"></script>
     <script src="{{ assetUrl('scripts/docs.js') }}" defer></script>
@@ -55,7 +61,7 @@
     <script src="{{ assetUrl('scripts/search.js') }}" defer></script>
   </head>
   <body>
-    <a id="skip-to-main" class="visually-hidden" href="#main-content" data-smooth-link="false">
+    <a id="skip-to-main" class="wa-visually-hidden" href="#main-content" data-smooth-link="false">
       Skip to main content
     </a>
 
@@ -68,37 +74,10 @@
       </svg>
     </button>
 
-    {# Icon toolbar #}
-    <div id="icon-toolbar">
-      {# GitHub #}
-      <a href="https://github.com/shoelace-style/shoelace" title="View Shoelace on GitHub">
-        <sl-icon name="github"></sl-icon>
-      </a>
-
-      {# Twitter #}
-      <a href="https://twitter.com/shoelace_style" title="Follow Shoelace on Twitter">
-        <sl-icon name="twitter"></sl-icon>
-      </a>
-
-      {# Theme selector #}
-      <sl-dropdown id="theme-selector" placement="bottom-end" distance="3">
-        <sl-button slot="trigger" size="small" variant="text" caret title="Press \ to toggle">
-          <sl-icon class="only-light" name="sun-fill"></sl-icon>
-          <sl-icon class="only-dark" name="moon-fill"></sl-icon>
-        </sl-button>
-        <sl-menu>
-          <sl-menu-item type="checkbox" value="light">Light</sl-menu-item>
-          <sl-menu-item type="checkbox" value="dark">Dark</sl-menu-item>
-          <sl-divider></sl-divider>
-          <sl-menu-item type="checkbox" value="auto">System</sl-menu-item>
-        </sl-menu>
-      </sl-dropdown>
-    </div>
-
     <aside id="sidebar" data-preserve-scroll>
       <header>
         <a href="/">
-          <img src="{{ assetUrl('images/wordmark.svg') }}" alt="Shoelace" />
+          {% include 'logo.njk' %}
         </a>
         <div class="sidebar-version">
           {{ meta.version }}
@@ -106,19 +85,19 @@
       </header>
 
       <div class="sidebar-buttons">
-        <sl-button size="small" class="repo-button repo-button--github" href="https://github.com/shoelace-style/shoelace" target="_blank">
-          <sl-icon slot="prefix" name="github"></sl-icon> Code
-        </sl-button>
-        <sl-button size="small" class="repo-button repo-button--star" href="https://github.com/shoelace-style/shoelace/stargazers" target="_blank">
-          <sl-icon slot="prefix" name="star-fill"></sl-icon> Star
-        </sl-button>
-        <sl-button size="small" class="repo-button repo-button--twitter" href="https://twitter.com/shoelace_style" target="_blank">
-          <sl-icon slot="prefix" name="twitter"></sl-icon> Follow
-        </sl-button>
+        <wa-button size="small" class="repo-button repo-button--github" href="https://github.com/shoelace-style/shoelace" target="_blank">
+          <wa-icon slot="prefix" name="github"></wa-icon> Code
+        </wa-button>
+        <wa-button size="small" class="repo-button repo-button--star" href="https://github.com/shoelace-style/shoelace/stargazers" target="_blank">
+          <wa-icon slot="prefix" name="star-fill"></wa-icon> Star
+        </wa-button>
+        <wa-button size="small" class="repo-button repo-button--twitter" href="https://twitter.com/shoelace_style" target="_blank">
+          <wa-icon slot="prefix" name="twitter"></wa-icon> Follow
+        </wa-button>
       </div>
 
       <button class="search-box" type="button" title="Press / to search" aria-label="Search" data-plugin="search">
-        <sl-icon name="search"></sl-icon>
+        <wa-icon name="search"></wa-icon>
         <span>Search</span>
       </button>
 

docs/_includes/layout-example.njk

@@ -0,0 +1,105 @@
+<!DOCTYPE html>
+<html
+  lang="en"
+  data-layout="{{ layout }}"
+  data-shoelace-version="{{ meta.version }}"
+>
+  <head>
+  <!--
+    JSPM Generator Import Map
+    Edit URL: https://generator.jspm.io/#jcs9DoMwDIbhDF16kW4kpFO7cYkeIASTGBmDEvNz+zaduhSJwdInvY9vF6Wub/ViQSHoVMQQqZzoITfW6qeuDWFr/JTgMJLjsLgA2ficT6jBrS77hLOcwPtIilCau37o+rdMhwm84FpIgr68/28LZ9dDFWWkQ7NF4G/coK38NM4TA0vVQY8MRdfa2g8tjhfiKAE
+  -->
+   <script type="importmap">
+  {
+    "imports": {
+      "highlight.js/lib/core": "https://ga.jspm.io/npm:highlight.js@11.9.0/es/core.js",
+      "highlight.js/lib/languages/css": "https://ga.jspm.io/npm:highlight.js@11.9.0/es/languages/css.js",
+      "highlight.js/lib/languages/javascript": "https://ga.jspm.io/npm:highlight.js@11.9.0/es/languages/javascript.js",
+      "highlight.js/lib/languages/xml": "https://ga.jspm.io/npm:highlight.js@11.9.0/es/languages/xml.js",
+      "lit": "https://ga.jspm.io/npm:lit@2.8.0/index.js",
+      "lit/directives/ref.js": "https://ga.jspm.io/npm:lit@2.8.0/directives/ref.js",
+      "lit/directives/unsafe-html.js": "https://ga.jspm.io/npm:lit@2.8.0/directives/unsafe-html.js",
+      "lit/directives/when.js": "https://ga.jspm.io/npm:lit@2.8.0/directives/when.js",
+      "web-component-define": "https://ga.jspm.io/npm:web-component-define@2.0.11/src/index.js"
+    },
+    "scopes": {
+      "https://ga.jspm.io/": {
+        "@lit/reactive-element": "https://ga.jspm.io/npm:@lit/reactive-element@1.6.3/reactive-element.js",
+        "@open-wc/dedupe-mixin": "https://ga.jspm.io/npm:@open-wc/dedupe-mixin@1.4.0/index.js",
+        "lit-element/lit-element.js": "https://ga.jspm.io/npm:lit-element@3.3.3/lit-element.js",
+        "lit-html": "https://ga.jspm.io/npm:lit-html@2.8.0/lit-html.js",
+        "lit-html/": "https://ga.jspm.io/npm:lit-html@2.8.0/"
+      }
+    }
+  }
+  </script>
+
+  <script async src="https://ga.jspm.io/npm:es-module-shims@1.8.0/dist/es-module-shims.js" crossorigin="anonymous"></script>
+    {# Metadata #}
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="description" content="{{ meta.description }}" />
+    <title>{{ meta.title }}</title>
+
+    {# Opt out of Turbo caching #}
+    <meta name="turbo-cache-control" content="no-cache">
+    <meta name="turbo-cache-control" content="no-preview">
+
+    {# Favicons #}
+    <link rel="icon" href="{{ assetUrl('images/favicon.svg') }}" type="image/x-icon" />
+
+    {# Twitter Cards #}
+    <meta name="twitter:card" content="summary" />
+    <meta name="twitter:creator" content="shoelace_style" />
+    <meta name="twitter:image" content="{{ assetUrl(meta.image, true) }}" />
+
+    {# OpenGraph #}
+    <meta property="og:url" content="{{ rootUrl(page.url, true) }}" />
+    <meta property="og:title" content="{{ meta.title }}" />
+    <meta property="og:description" content="{{ meta.description }}" />
+    <meta property="og:image" content="{{ assetUrl(meta.image, true) }}" />
+
+    {# WebAwesome #}
+    <link rel="stylesheet" href="/dist/themes/default.css" />
+    <link rel="stylesheet" href="/dist/themes/applied.css" />
+    <script type="module" src="/dist/webawesome.js"></script>
+
+    {# Set the initial theme and menu states here to prevent flashing #}
+    <script>
+      (() => {
+        const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
+        const theme = localStorage.getItem('theme') || 'auto';
+        document.documentElement.classList.toggle('wa-theme-dark', theme === 'dark' || (theme === 'auto' && prefersDark));
+
+        if (window.Turbo) {
+          window.Turbo.session.drive = false
+        }
+      })();
+    </script>
+
+    <style>
+      *, *:before, *:after {
+        box-sizing: border-box;
+      }
+
+      html, body {
+        height: 100%;
+        min-height: 100%;
+      }
+
+      body {
+        margin: 0;
+      }
+
+      [hidden] {
+        display: none !important;
+      }
+    </style>
+
+  </head>
+  <body>
+    {% block content %}
+      {{ content | safe }}
+    {% endblock %}
+  </body>
+</html>

docs/_includes/layout-templates/advanced-example.css

@@ -0,0 +1,72 @@
+html {
+  min-height: 100%;
+  height: auto;
+}
+
+body {
+  padding: 0;
+  height: auto;
+}
+
+.grid {
+  font-size: 1.35rem;
+  text-align: center;
+  display: grid;
+  place-content: center;
+  padding: 1rem;
+}
+
+header {
+  background-color: var(--wa-color-blue-90);
+}
+
+aside {
+  min-width: 250px;
+  max-width: 250px;
+  height: 100%;
+}
+
+main {
+  background-color: var(--wa-color-green-90);
+  height: 100%;
+}
+
+footer {
+  background-color: var(--wa-color-blue-80);
+}
+
+.banner {
+  background-color: var(--wa-color-yellow-90);
+}
+
+.header {
+  background-color: var(--wa-color-blue-90);
+}
+
+.banner, .header {
+  min-width: 100%;
+  height: 100%;
+}
+
+[slot=header] {
+  display: grid;
+  grid-template-columns: 1fr;
+  grid-template-rows: 1fr;
+}
+
+[slot=aside] {
+  background-color: var(--wa-color-yellow-90);
+}
+
+[slot=menu] {
+  background-color: var(--wa-color-red-80);
+}
+
+[slot=main-header] {
+  background-color: var(--wa-color-red-90);
+  padding: 1rem;
+}
+
+[slot=main-footer] {
+  background-color: var(--wa-color-red-70);
+}

docs/_includes/layout-templates/advanced-example.html

@@ -0,0 +1,22 @@
+<wa-layout main-id="main-content" class="wa-theme-light">
+  <header slot="banner" class="grid banner">
+    Banner
+  </header>
+
+  <header slot="header" class="grid header">Header</header>
+
+  <aside class="grid" slot="menu">Menu</aside>
+
+  <header class="grid" slot="main-header">Inline header</header>
+
+  <main class="grid" id="main-content">
+    <div style="width: 20ch; margin: 0 auto; background-color: white;">Main</div>
+  </main>
+
+  <footer class="grid" slot="main-footer">Inline footer</footer>
+
+  <aside class="grid" slot="aside">Aside</aside>
+  <footer class="grid" slot="footer">Footer</footer>
+</wa-layout>
+
+{% include "layout-widget.njk" %}

docs/_includes/layout-templates/app.css

@@ -0,0 +1,217 @@
+html {
+  min-height: 100%;
+  height: auto;
+}
+
+body {
+  padding: 0;
+  height: auto;
+}
+
+main {
+  min-height: 100%;
+  padding: 1rem 2rem;
+}
+
+/* Layout */
+wa-layout {
+  background-color: var(--wa-color-neutral-95);
+  color: var(--wa-color-neutral-20);
+}
+
+wa-card :is(p, h3) {
+  margin: 0;
+}
+
+wa-layout::part(header) {
+  /** Because headers are sticky, this keeps text from leaking through. */
+  background-color: var(--wa-color-white);
+}
+
+wa-layout::part(drawer__panel) {
+  height: 100%;
+}
+
+wa-layout[view="mobile"] {
+  background-color: var(--wa-color-white);
+  --menu-width: 0px;
+}
+
+wa-layout[view="mobile"]::part(header) {
+  padding: 0.25rem;
+  border-bottom: 1px solid var(--wa-color-neutral-70);
+}
+
+wa-layout[view="mobile"]::part(navigation) {
+  display: none;
+}
+
+wa-layout[view="desktop"]::part(main) {
+  padding-top: 1rem;
+}
+
+wa-layout[view="desktop"] {
+  --menu-width: 250px;
+}
+
+
+wa-layout[view="desktop"]::part(navigation) {
+  padding-top: 1.9rem;
+}
+
+wa-layout[view="desktop"] > [slot="header"] {
+  display: none;
+}
+
+wa-layout[view="desktop"]::part(header) {
+  display: none;
+}
+
+wa-layout[view="desktop"] main {
+  background-color: var(--wa-color-white);
+  box-shadow: 0px 0px 3px 1px rgba(0,0,0,0.05);
+  border: 1px solid var(--wa-color-neutral-80);
+  border-top-left-radius: 8px;
+}
+
+/* Navigation / Lists */
+
+/* Highlights */
+.highlight {
+  font-size: 0.85em;
+  padding: 0.4em 0.6em;
+  border-radius: 6px;
+  display: inline-block;
+}
+
+.highlight--success {
+  background-color: var(--wa-color-success-fill-muted);
+  color: var(--wa-color-success-text-on-muted);
+}
+
+.highlight--danger {
+  background-color: var(--wa-color-red-90);
+  color: var(--wa-color-red-30);
+}
+
+/* Text */
+.text--light {
+  color: var(--wa-color-neutral-40);
+}
+
+/* Cards */
+.wa-card--muted::part(base) {
+  --border-color: transparent;
+  background-color: transparent;
+  display: grid;
+  height: 100%;
+  box-shadow: none;
+}
+
+.wa-card--muted::part(body) {
+  display: grid;
+  align-content: flex-end;
+  gap: var(--padding);
+}
+
+/* Buttons */
+.wa-button--card {
+  --border-radius: 8px;
+  --padding: 1rem 0px;
+}
+
+.wa-button--card.wa-button--muted {
+  --background-color: var(--wa-color-neutral-95);
+}
+
+.wa-button--card::part(base) {
+  height: 100%;
+  border-radius: var(--border-radius);
+  padding: var(--padding);
+}
+
+.wa-button--card::part(label) {
+  width: 100%;
+}
+
+.wa-button--muted {
+  --text-color: var(--wa-color-neutral-30);
+  --text-color-active: var(--wa-color-neutral-30);
+  --background-color: transparent;
+  --background-color-active: var(--wa-color-neutral-90);
+  --border-color: transparent;
+  --border-color-active: var(--wa-color-neutral-80);
+}
+
+.wa-button--muted::part(base) {
+  background-color: var(--background-color);
+  color: var(--text-color);
+  border-color: var(--border-color);
+}
+
+.wa-button--muted:is(:focus-within)::part(base) {
+  background-color: var(--background-color);
+  color: var(--text-color-active);
+  border-color: var(--border-color-active);
+}
+
+.wa-button--muted:is(:hover)::part(base) {
+  background-color: var(--background-color-active);
+  color: var(--text-color-active);
+  border-color: var(--border-color-active);
+}
+
+.wa-button--logo::part(base) {
+  font-size: 1.5rem;
+  color: var(--wa-color-neutral-30);
+}
+
+.wa-button--square::part(base) {
+  border-radius: 0px;
+}
+
+.wa-button--stretch {
+  width: 100%;
+}
+
+.wa-button--stretch::part(label) {
+  flex: 1 1 auto;
+}
+
+.wa-button--nav-footer {
+  --border-color: var(--wa-color-neutral-70);
+  --wa-spacing-large: 8px;
+}
+
+wa-layout[view="desktop"] .wa-button--nav-footer::part(base) {
+  --border-color: transparent;
+  border-top-color: var(--wa-color-neutral-70);
+}
+
+/* Tables */
+table {
+  max-width: 100%;
+  border: none;
+  border-collapse: collapse;
+  color: inherit;
+}
+
+table tr {
+  border-bottom: 1px solid var(--wa-color-neutral-70);
+}
+
+table th {
+  font-weight: var(--wa-font-weight-semibold);
+  text-align: left;
+  padding: 0.75rem 1rem;
+}
+
+table td {
+  line-height: var(--wa-line-height-normal);
+  padding: 1rem;
+}
+
+* > table {
+  max-width: 100%;
+  overflow-x: auto;
+}

docs/_includes/layout-templates/app.html

@@ -0,0 +1,438 @@
+<wa-layout main-id="main-content" class="wa-theme-light">
+  <header slot="header">
+    <wa-icon-button name="list" style="font-size: 1.5rem" data-toggle-nav></wa-icon>
+  </header>
+  <wa-button href="#" variant="text" style="padding: 0 0.4rem" class="wa-button--logo wa-button--stretch wa-button--muted" size="large" slot="navigation-header">
+    <wa-icon name="music-note" slot="prefix" style="font-size: 2rem;"></wa-icon>
+    Musicify
+  </wa-button>
+
+  <nav style="padding: 1rem;" slot="navigation">
+    <wa-nav-group style="height: 100%;">
+      <wa-nav-item href="#">
+        <wa-icon name="search" slot="prefix"></wa-icon>
+        Search
+      </wa-nav-item>
+
+      <wa-nav-item href="#">
+        <wa-icon name="bell" slot="prefix"></wa-icon>
+        Notifications
+      </wa-nav-item>
+
+      <wa-divider></wa-divider>
+
+      <wa-nav-item href="#" current="page">
+        <wa-icon name="house-door" slot="prefix"></wa-icon>
+        Home
+      </wa-nav-item>
+
+      <wa-nav-item href="#">
+        <wa-icon name="music-note-list" slot="prefix"></wa-icon>
+        Playlists
+      </wa-nav-item>
+
+      <wa-nav-item href="#">
+        <wa-icon name="file-earmark-music" slot="prefix"></wa-icon>
+        Tracks
+      </wa-nav-item>
+
+      <wa-nav-item href="#">
+        <wa-icon name="gear" slot="prefix"></wa-icon>
+        Settings
+      </wa-nav-item>
+
+      <wa-nav-item href="#" style="margin-top: auto;">
+        <wa-icon name="question-circle" slot="prefix"></wa-icon>
+        Help
+      </wa-nav-item>
+    </wa-nav-group>
+  </nav>
+
+  <!-- Hacky override to make padding 8px -->
+  <wa-button slot="navigation-footer" outline class="wa-button--square wa-button--stretch wa-button--muted wa-button--nav-footer" size="large" href="#">
+    <div style="display: grid; align-items: center; max-width: 100%; gap: 8px; grid-template-columns: minmax(0, auto) minmax(0, 1fr) minmax(0, auto);">
+      <wa-avatar shape="rounded" style="--size: 36px;"></wa-avatar>
+      <div style="text-overflow: ellipsis; max-width: 100%; overflow: hidden; text-align: start; font-size: 1rem;">Really really really long name</div>
+      <wa-icon name="chevron-right"></wa-icon>
+    </div>
+  </wa-button>
+
+
+  <main id="main-content" class="main">
+    <h1 style="margin: 0.5rem 0 2rem 0;">Good Evening, Konnor Rogers</h1>
+
+    <section>
+      <div style="display: flex; justify-content: space-between; flex-wrap: wrap; align-items: flex-end; gap: 8px;">
+        <h2 style="">Overview</h2>
+
+        <wa-select value="monthly">
+          <wa-option value="daily">Daily</wa-option>
+          <wa-option value="weekly">Weekly</wa-option>
+          <wa-option value="monthly">Monthly</wa-option>
+          <wa-option value="yearly">Yearly</wa-option>
+        </wa-select>
+      </div>
+
+    <wa-divider></wa-divider>
+
+
+      <div style="margin-top: 1rem; display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); grid-auto-rows: 1fr; gap: var(--wa-spacing-large); text-align: center;">
+        <wa-card class="wa-card--muted" style="--padding: 8px;">
+          <h3 slot="header">Total listening time</h3>
+
+          <p>
+            <strong><wa-format-number value="35000"></wa-format-number></strong> minutes
+          </p>
+          <p>
+            <mark class="highlight highlight--success">
+              +16%
+            </mark>
+
+            <small class="text--light">from last month</small>
+          </p>
+        </wa-card>
+
+        <wa-card class="wa-card--muted" style="--padding: 8px;">
+          <h3 slot="header">Total songs played</h3>
+
+          <p>
+            <strong><wa-format-number value="302"></wa-format-number></strong> songs
+          </p>
+
+          <p>
+            <mark class="highlight highlight--danger">
+              -0.3%
+            </mark>
+
+            <small class="text--light">from last month</small>
+          </p>
+        </wa-card>
+
+        <wa-card class="wa-card--muted" style="--padding: 8px;">
+          <h3 slot="header">Average listening session</h3>
+
+          <p>
+            <strong><wa-format-number value="36"></wa-format-number></strong> minutes
+          </p>
+
+          <p>
+            <mark class="highlight highlight--success">
+              +11.4%
+            </mark>
+
+            <small class="text--light">from last month</small>
+          </p>
+        </wa-card>
+
+        <wa-card class="wa-card--muted" style="--padding: 8px;">
+          <h3 slot="header">Average track listening time</h3>
+
+          <p>
+            <strong><wa-format-number value="2"></wa-format-number></strong> minutes,
+            <strong><wa-format-number value="42"></wa-format-number></strong> seconds
+          </p>
+          <p>
+            <mark class="highlight highlight--success">
+              -6.2%
+            </mark>
+
+            <small class="text--light">from last month</small>
+          </p>
+        </wa-card>
+      </div>
+    </section>
+
+    <section style="margin-top: 3rem;">
+      <h2>Recent playlists</h2>
+
+      <div style="margin-top: 1rem; --card-width: clamp(200px, 100%, 350px); display: grid; grid-template-columns: repeat(auto-fit, minmax(var(--card-width), 1fr)); gap: 16px;">
+
+        <wa-button variant="neutral" class="wa-button--card wa-button--muted" href="#">
+          <div style="display: flex; gap: 1rem;">
+            <img src="https://via.placeholder.com/100x100" height="100" width="100" style="align-self: center; border-radius: 8px; display: inline-block; max-width: 100%; flex: 0 1 auto;">
+
+            <article style="display: grid; align-content: center; color: var(--wa-color-neutral-700); grid-template-columns: minmax(0, 1fr); max-width: 100%; overflow: hidden; width: 100%;">
+              <h2 style="max-width: 100%; text-overflow: ellipsis; overflow: hidden;">
+                Punk Rock Anthems
+              </h2>
+
+              <p style="max-width: 100%; text-overflow: ellipsis; overflow: hidden;">
+                For when you just wanna rock out, have a good time, and feel angsty.
+              </p>
+
+              <wa-icon name="chevron-right" style="justify-self: flex-end;"></wa-icon>
+            </article>
+          </div>
+        </wa-button>
+
+
+        <wa-button variant="neutral" class="wa-button--card wa-button--muted" href="#">
+          <div style="display: flex; gap: 1rem;">
+            <img src="https://via.placeholder.com/100x100" height="100" width="100" style="align-self: center; border-radius: 8px; display: inline-block; max-width: 100%;">
+
+            <article style="display: grid; align-content: center; color: var(--wa-color-neutral-700); grid-template-columns: minmax(0, 1fr); max-width: 100%; overflow: hidden; width: 100%;">
+              <h2 style="max-width: 100%; text-overflow: ellipsis; overflow: hidden;">
+                Random
+              </h2>
+
+              <p style="max-width: 100%; text-overflow: ellipsis; overflow: hidden;">
+                Throw it on shuffle, and embrace the chaos.
+              </p>
+
+              <wa-icon name="chevron-right" style="justify-self: flex-end;"></wa-icon>
+            </article>
+          </div>
+        </wa-button>
+
+        <wa-button variant="neutral" class="wa-button--card wa-button--muted" href="#">
+          <div style="display: flex; gap: 1rem;">
+            <img src="https://via.placeholder.com/100x100" height="100" width="100" style="align-self: center; border-radius: 8px; display: inline-block;">
+
+            <article style="display: grid; align-content: center; color: var(--wa-color-neutral-700); grid-template-columns: minmax(0, 1fr); max-width: 100%; overflow: hidden; width: 100%;">
+              <h2 style="max-width: 100%; text-overflow: ellipsis; overflow: hidden;">
+                Classics
+              </h2>
+
+              <p style="max-width: 100%; text-overflow: ellipsis; overflow: hidden;">
+                Timeless songs that you love to relive.
+              </p>
+
+              <wa-icon name="chevron-right" style="justify-self: flex-end;"></wa-icon>
+            </article>
+          </div>
+        </wa-button>
+      </div>
+    </section>
+
+    <section style="margin-top: 3rem;">
+      <h2>Recent tracks</h2>
+
+      <div style="margin-top: 1rem; max-width: 100%; overflow: auto;">
+        <table style="width: 100%; min-width: 500px; border-spacing: 2px;">
+          <thead>
+            <tr>
+              <th>
+                Release Date
+              </th>
+
+              <th>
+                Name
+              </th>
+
+              <th>
+                Album
+              </th>
+
+              <th>
+                Artist
+              </th>
+            </tr>
+          </thead>
+
+          <tbody>
+            <tr>
+              <td>
+                <wa-format-date date="2020-07-15T09:17:00-04:00"></wa-format-date>
+              </td>
+
+              <td>
+                No Strangers to Love
+              </td>
+
+              <td>
+                You Know the Rules
+              </td>
+
+              <td>
+                Rick Barry
+              </td>
+            </tr>
+
+            <tr>
+              <td>
+                <wa-format-date date="2020-07-15T09:17:00-04:00"></wa-format-date>
+              </td>
+
+              <td>
+                No Strangers to Love
+              </td>
+
+              <td>
+                You Know the Rules
+              </td>
+
+              <td>
+                Rick Barry
+              </td>
+            </tr>
+
+            <tr>
+              <td>
+                <wa-format-date date="2020-07-15T09:17:00-04:00"></wa-format-date>
+              </td>
+
+              <td>
+                No Strangers to Love
+              </td>
+
+              <td>
+                You Know the Rules
+              </td>
+
+              <td>
+                Rick Barry
+              </td>
+            </tr>
+
+            <tr>
+              <td>
+                <wa-format-date date="2020-07-15T09:17:00-04:00"></wa-format-date>
+              </td>
+
+              <td>
+                No Strangers to Love
+              </td>
+
+              <td>
+                You Know the Rules
+              </td>
+
+              <td>
+                Rick Barry
+              </td>
+            </tr>
+
+            <tr>
+              <td>
+                <wa-format-date date="2020-07-15T09:17:00-04:00"></wa-format-date>
+              </td>
+
+              <td>
+                No Strangers to Love
+              </td>
+
+              <td>
+                You Know the Rules
+              </td>
+
+              <td>
+                Rick Barry
+              </td>
+            </tr>
+
+            <tr>
+              <td>
+                <wa-format-date date="2020-07-15T09:17:00-04:00"></wa-format-date>
+              </td>
+
+              <td>
+                No Strangers to Love
+              </td>
+
+              <td>
+                You Know the Rules
+              </td>
+
+              <td>
+                Rick Barry
+              </td>
+            </tr>
+
+            <tr>
+              <td>
+                <wa-format-date date="2020-07-15T09:17:00-04:00"></wa-format-date>
+              </td>
+
+              <td>
+                No Strangers to Love
+              </td>
+
+              <td>
+                You Know the Rules
+              </td>
+
+              <td>
+                Rick Barry
+              </td>
+            </tr>
+
+            <tr>
+              <td>
+                <wa-format-date date="2020-07-15T09:17:00-04:00"></wa-format-date>
+              </td>
+
+              <td>
+                No Strangers to Love
+              </td>
+
+              <td>
+                You Know the Rules
+              </td>
+
+              <td>
+                Rick Barry
+              </td>
+            </tr>
+
+            <tr>
+              <td>
+                <wa-format-date date="2020-07-15T09:17:00-04:00"></wa-format-date>
+              </td>
+
+              <td>
+                No Strangers to Love
+              </td>
+
+              <td>
+                You Know the Rules
+              </td>
+
+              <td>
+                Rick Barry
+              </td>
+            </tr>
+
+            <tr>
+              <td>
+                <wa-format-date date="2020-07-15T09:17:00-04:00"></wa-format-date>
+              </td>
+
+              <td>
+                No Strangers to Love
+              </td>
+
+              <td>
+                You Know the Rules
+              </td>
+
+              <td>
+                Rick Barry
+              </td>
+            </tr>
+
+            <tr>
+              <td>
+                <wa-format-date date="2020-07-15T09:17:00-04:00"></wa-format-date>
+              </td>
+
+              <td>
+                No Strangers to Love
+              </td>
+
+              <td>
+                You Know the Rules
+              </td>
+
+              <td>
+                Rick Barry
+              </td>
+            </tr>
+
+          </tbody>
+        </table>
+      </div>
+    </section>
+
+  </main>
+
+</wa-layout>

docs/_includes/layout-templates/example.css

@@ -0,0 +1,74 @@
+html {
+  min-height: 100%;
+  height: auto;
+}
+
+body {
+  padding: 0;
+  height: auto;
+}
+
+.grid {
+  font-size: 1.35rem;
+  text-align: center;
+  display: grid;
+  place-content: center;
+  padding: 1rem;
+}
+
+header {
+  background-color: var(--wa-color-blue-90);
+}
+
+aside {
+  min-width: 250px;
+  max-width: 250px;
+}
+
+main {
+  background-color: var(--wa-color-green-90);
+  height: 100%;
+}
+
+footer {
+  background-color: var(--wa-color-blue-80);
+}
+
+.banner {
+  background-color: var(--wa-color-yellow-90);
+}
+
+.header {
+  background-color: var(--wa-color-blue-90);
+}
+
+.banner, .header {
+  min-width: 100%;
+  height: 100%;
+}
+
+[slot=header] {
+  display: grid;
+  grid-template-columns: 1fr;
+  grid-template-rows: 1fr;
+}
+
+[slot=aside] {
+  height: 100%;
+  background-color: var(--wa-color-yellow-90);
+}
+
+[slot=menu] {
+  height: 100%;
+  background-color: var(--wa-color-red-90);
+}
+
+[slot=main-header] {
+  background-color: var(--wa-color-red-80);
+  padding: 1rem;
+}
+
+[slot=main-footer] {
+  background-color: var(--wa-color-green-80);
+}
+

docs/_includes/layout-templates/example.html

@@ -0,0 +1,11 @@
+<wa-layout main-id="main-content" class="wa-theme-light">
+  <header class="grid" slot="header">Header</header>
+  <aside class="grid" slot="menu">Menu</aside>
+  <main class="grid" id="main-content">
+    Main
+  </main>
+  <aside class="grid" slot="aside">Aside</aside>
+  <footer class="grid" slot="footer">Footer</footer>
+</wa-layout>
+
+{% include "layout-widget.njk" %}

docs/_includes/layout-templates/hero.css

@@ -0,0 +1,10 @@
+html {
+  min-height: 100%;
+  height: auto;
+}
+
+body {
+  padding: 0;
+  height: auto;
+}
+

docs/_includes/layout-templates/hero.html

@@ -0,0 +1,2 @@
+<wa-layout main-id="main-content" class="wa-theme-light">
+</wa-layout>

docs/_includes/layout-templates/sport-awesome.css

@@ -0,0 +1,181 @@
+html {
+  min-height: 100%;
+  height: auto;
+}
+
+body {
+  padding: 0;
+  height: auto;
+  --wa-color-brand-fill-vivid: var(--wa-color-blue-20);
+  margin: 0 auto;
+}
+
+/** https://andy-bell.co.uk/my-favourite-3-lines-of-css/ */
+.flow > * + * {
+  margin-block-start: var(--wa-flow-spacing);
+}
+
+
+img {
+  display: inline-block;
+  max-width: 100%;
+  height: auto;
+}
+
+.navigation--desktop::part(nav-items) {
+  gap: 2rem;
+}
+
+.navigation--top::part(nav-items) {
+  flex-direction: row;
+}
+
+.navigation--top wa-nav-item {
+  font-size: 1.4rem;
+  font-weight: bold;
+}
+
+.navigation--top wa-nav-item::part(content) {
+  text-align: center;
+  justify-content: center;
+}
+
+.navigation--top wa-nav-item {
+  --text-color: var(--wa-color-brand-text-on-vivid);
+  --text-color-hover: var(--wa-color-text-normal);
+  --background-color: transparent;
+  --background-color-hover: var(--wa-color-neutral-fill-muted-alt);
+}
+
+.header {
+  display: flex;
+  border-bottom: 1px solid var(--wa-color-brand-fill-vivid);
+  background-color: var(--wa-color-white);
+}
+
+.header > * {
+  padding-top: var(--wa-space-base);
+  padding-bottom: var(--wa-space-base);
+}
+
+.header__navigation {
+  display: flex;
+  clip-path: polygon(2rem 0,100% 0,100% 100%,0 100%);
+  padding-inline-start: 2.5rem;
+  padding-inline-end: var(--wa-space-base);
+  background-color: var(--wa-color-brand-fill-vivid);
+  width: 100%;
+}
+
+.header > .logo {
+  padding-inline-start: var(--wa-space-base);
+  /** Responsive font size for the top header to make it flow nicer */
+  font-size: clamp(1rem, 4vw, 1.4rem);
+}
+
+a.logo {
+  flex-shrink: 0;
+  font-size: 1.4rem;
+  font-weight: bold;
+  color: var(--wa-color-text-normal);
+  text-decoration: none;
+  margin: auto;
+
+}
+
+a.logo:is(:hover, :focus) {
+  text-decoration: underline;
+}
+
+.logo__accent {
+  color: var(--wa-color-yellow-70);
+}
+
+.navigation--desktop {
+  display: flex;
+  align-items: center;
+  width: 100%;
+}
+
+.navigation--desktop wa-nav-item[current="page"] {
+  text-decoration: underline;
+  text-underline-offset: 8px;
+  text-decoration-thickness: 4px;
+  text-decoration-color: var(--wa-color-red-50);
+}
+
+.navigation--extra {
+  display: flex;
+  align-items: center;
+  justify-content: flex-end;
+  gap: 8px;
+  margin-inline-start: auto;
+}
+
+wa-layout[view="desktop"] [data-toggle-nav],
+wa-layout[view="desktop"]::part(navigation) {
+  display: none;
+}
+
+wa-layout[view="mobile"] .navigation--desktop {
+  display: none;
+}
+
+.layout-banner {
+  padding: var(--wa-space-base);
+  text-align: center;
+  background-color: var(--wa-color-yellow-80);
+}
+
+.stats-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(clamp(175px, 100%, 400px), 1fr));
+  gap: var(--wa-space-base);
+  grid-template-rows: 1fr;
+  align-items: start;
+  max-width: 100%;
+}
+
+.stats-grid table {
+  border-collapse: separate;
+  border-spacing: 0;
+  border-radius: 8px;
+  border: 1px solid var(--wa-color-surface-outline);
+}
+
+
+.table-scroll {
+  max-width: 100%;
+  overflow-x: auto;
+}
+
+.stats-grid table * {
+  font-variant-numeric: tabular-nums;
+}
+
+.stats-grid table th {
+  font-weight: bold;
+  text-align: center;
+}
+
+.stats-grid table td:nth-child(2) {
+  text-align: end;
+}
+
+.navigation--top.navigation--social::part(nav-items) {
+  justify-content: flex-end;
+}
+
+.navigation--social {
+  flex-grow: 1;
+}
+
+.navigation--top .social-link {
+  display: none;
+}
+
+@media screen and (min-width: 415px) {
+  .navigation--top .social-link {
+    display: flex;
+  }
+}

docs/_includes/layout-templates/sport-awesome.html

@@ -0,0 +1,292 @@
+<wa-layout main-id="main-content" class="wa-theme-light" mobile-breakpoint="925" disable-sticky="banner">
+  <header class="layout-banner" slot="banner">
+    Reminder! Get your insurance paperwork in by Oct 12!
+  </header>
+
+  <header class="header" slot="header">
+    <a href="#" class="logo">
+      <span>Sport</span> <span class="logo__accent">Awesome</span>
+    </a>
+
+    <div class="header__navigation">
+      <wa-nav-group class="navigation navigation--top navigation--desktop">
+        <wa-nav-item href="#" current="page">Home</wa-nav-item>
+        <wa-nav-item href="#">Schedule</wa-nav-item>
+        <wa-nav-item href="#">Roster</wa-nav-item>
+        <wa-nav-item href="#">Stats</wa-nav-item>
+        <wa-nav-item href="#">Videos</wa-nav-item>
+
+      </wa-nav-group>
+
+      <wa-nav-group class="navigation navigation--top navigation--social">
+        <wa-nav-item class="social-link" href="#"><wa-icon name="instagram"></wa-icon></wa-nav-item>
+        <wa-nav-item class="social-link" href="#"><wa-icon name="facebook"></wa-icon></wa-nav-item>
+        <wa-nav-item data-toggle-nav href="#"><wa-icon name="list"></wa-icon></wa-nav-item>
+      </wa-nav-group>
+    </div>
+  </header>
+
+  <a href="#" class="logo" slot="navigation-header">
+    Sport <span class="logo__accent">Awesome</span>
+  </a>
+
+  <wa-nav-group slot="navigation">
+    <wa-nav-item href="#" current="page">
+      <wa-icon name="house-door" slot="prefix"></wa-icon>
+      Home
+    </wa-nav-item>
+    <wa-nav-item href="#">
+      <wa-icon name="calendar" slot="prefix"></wa-icon>
+      Schedule
+    </wa-nav-item>
+    <wa-nav-item href="#">
+      <wa-icon name="people" slot="prefix"></wa-icon>
+      Roster
+    </wa-nav-item>
+    <wa-nav-item href="#">
+      <wa-icon name="graph-up-arrow" slot="prefix"></wa-icon>
+      Stats
+    </wa-nav-item>
+    <wa-nav-item href="#">
+      <wa-icon name="camera-video" slot="prefix"></wa-icon>
+      Videos
+    </wa-nav-item>
+
+    <wa-divider></wa-divider>
+
+    <wa-nav-group>
+      <wa-nav-item href="#">
+        <wa-icon name="instagram" slot="prefix"></wa-icon>
+        Instagram
+      </wa-nav-item>
+      <wa-nav-item href="#">
+        <wa-icon name="facebook" slot="prefix"></wa-icon>
+        Facebook
+      </wa-nav-item>
+    </wa-nav-group>
+  </wa-nav-group>
+
+  <main id="main-content" class="flow" style="padding: var(--wa-space-base);">
+    <div style="display: flex; flex-wrap: wrap; gap: 16px;">
+      <img src="https://via.placeholder.com/1600x900" height="512" width="300" style="aspect-ratio: 16/9; min-width: 75%; flex-grow: 1;">
+      <aside style="display: flex; flex-direction: column; border-radius: var(--wa-corners-1x); flex-grow: 1; flex-shrink: 1;">
+        <header style="font-size: 1.4rem; font-weight: bold; color: var(--wa-color-brand-text-on-vivid); background-color: var(--wa-color-brand-fill-vivid); padding: var(--wa-space-base); text-align: center; border-top-left-radius: inherit; border-top-right-radius: inherit;">
+          Upcoming
+        </header>
+
+        <div style="color: var(--wa-color-brand-text-on-vivid); background-color: var(--wa-color-red-40); padding: 0.5rem; text-align: center; font-weight: bold;">
+          Tryouts!
+        </div>
+
+        <div style="background-color: var(--wa-color-neutral-90); padding: var(--wa-space-base); border-bottom-left-radius: inherit; border-bottom-right-radius: inherit; text-align: center;">
+          <span style="font-weight: bold; font-size: 1.2rem;">Barclay's Center</span>
+
+          <br>
+
+          <time>Sat, Jul 3rd • 11:30am</time>
+        </div>
+      </aside>
+    </div>
+
+    <section>
+      <h1>Welcome to Sport <span class="logo__accent">Awesome</span></h1>
+
+      <p>
+        Dolor quam voluptate nostrum neque eius. Quo nemo corporis repellat quia sunt molestiae! Dolorem labore laudantium nobis numquam reprehenderit? Voluptatibus odio animi nemo maiores accusamus eaque Assumenda perferendis omnis quae.
+        Adipisicing beatae lorem nisi aliquid similique Voluptas doloremque pariatur tempore omnis maiores explicabo. Provident iste vel explicabo corporis quaerat! Necessitatibus minus quas iusto ducimus consequatur illo Cum eos adipisci ut!
+      </p>
+    </section>
+
+    <section>
+      <h2 style="text-align: center; font-weight: bold; font-size: 1.5em;">Stats</h2>
+      <div class="stats-grid">
+        <div class="table-scroll">
+          <table>
+            <thead>
+              <tr>
+                <th colspan="2">
+                  Serve
+                </th>
+              </tr>
+            </thead>
+
+            <tbody>
+              <tr>
+                <td>Attempts</td>
+                <td>2936</td>
+              </tr>
+              <tr>
+                <td>Serve %</td>
+                <td>93.6%</td>
+              </tr>
+              <tr>
+                <td>Aces</td>
+                <td>268</td>
+              </tr>
+              <tr>
+                <td>Errors</td>
+                <td>189</td>
+              </tr>
+            </tbody>
+          </table>
+        </div>
+
+        <div class="table-scroll">
+          <table>
+            <thead>
+              <tr>
+                <th colspan="2">
+                  Serve Receive
+                </th>
+              </tr>
+            </thead>
+
+            <tbody>
+              <tr>
+                <td>Attempts</td>
+                <td>2428</td>
+              </tr>
+              <tr>
+                <td>Pass Rating</td>
+                <td>1.72</td>
+              </tr>
+              <tr>
+                <td>Pass Error %</td>
+                <td>13.3%</td>
+              </tr>
+              <tr>
+                <td>3-pass %</td>
+                <td>28.5%</td>
+              </tr>
+            </tbody>
+          </table>
+        </div>
+
+        <div class="table-scroll">
+          <table>
+            <thead>
+              <tr>
+                <th colspan="2">
+                  Attack
+                </th>
+              </tr>
+            </thead>
+
+            <tbody>
+              <tr>
+                <td>Attempts</td>
+                <td>3624</td>
+              </tr>
+              <tr>
+                <td>Kills</td>
+                <td>1431</td>
+              </tr>
+              <tr>
+                <td>Errors</td>
+                <td>268</td>
+              </tr>
+              <tr>
+                <td>Hitting Efficiency</td>
+                <td>0.254</td>
+              </tr>
+
+              <tr>
+                <td>Kill %</td>
+                <td>39.5%</td>
+              </tr>
+            </tbody>
+          </table>
+        </div>
+
+        <div class="table-scroll">
+          <table>
+            <thead>
+              <tr>
+                <th colspan="2">
+                  Dig
+                </th>
+              </tr>
+            <tbody>
+              <tr>
+                <td>Attempts</td>
+                <td>3124</td>
+              </tr>
+
+              <tr>
+                <td>Digs</td>
+                <td>2235</td>
+              </tr>
+
+              <tr>
+                <td>Errors</td>
+                <td>889</td>
+              </tr>
+
+              <tr>
+                <td>Dig %</td>
+                <td>71.5%</td>
+              </tr>
+            </tbody>
+          </table>
+        </div>
+
+        <div class="table-scroll">
+          <table>
+            <thead>
+              <tr>
+                <th colspan="2">
+                  Block
+                </th>
+              </tr>
+            <tbody>
+              <tr>
+                <td>Blocks</td>
+                <td>348</td>
+              </tr>
+
+              <tr>
+                <td>Errors</td>
+                <td>414</td>
+              </tr>
+
+              <tr>
+                <td>Block %</td>
+                <td>31.6%</td>
+              </tr>
+
+              <tr>
+                <td>Error %</td>
+                <td>24.6%</td>
+              </tr>
+            </tbody>
+          </table>
+        </div>
+
+        <div class="table-scroll">
+          <table>
+            <thead>
+              <tr>
+                <th colspan="2">
+                  Set
+                </th>
+              </tr>
+            <tbody>
+              <tr>
+                <td>Assists</td>
+                <td>1364</td>
+              </tr>
+
+              <tr>
+                <td>Errors</td>
+                <td>81</td>
+              </tr>
+            </tbody>
+         </table>
+      </div>
+    </section>
+  </main>
+
+  <footer slot="main-footer" style="background-color: var(--wa-color-brand-fill-vivid); color: var(--wa-color-text-inverse); padding: var(--wa-space-base); text-align: center;">
+    © 2023 - Sport Awesome
+  </footer>
+</wa-layout>

docs/_includes/layout-widget.njk

@@ -0,0 +1,92 @@
+<!-- playground-hide -->
+<style>
+  .layout-widget {
+    position: fixed;
+    z-index: 9999;
+    background-color: white;
+    bottom: 4rem;
+    left: 4rem;
+  }
+
+  .layout-widget:not(:defined) {
+    display: none;
+  }
+</style>
+
+<wa-dropdown id="js-layout-widget" class="layout-widget" stay-open-on-select>
+  <wa-button slot="trigger" caret>Dropdown</wa-button>
+  <wa-menu></wa-menu>
+</wa-dropdown>
+
+<script type="module">
+  const layoutWidget = document.querySelector("#js-layout-widget")
+  const docFrag = new DocumentFragment()
+
+  function makeMenuItem (type, slot) {
+    const menuItem = Object.assign(document.createElement("wa-menu-item"), {
+      type: "checkbox",
+      textContent: `${type} ${slot}`
+    })
+
+    menuItem.setAttribute("value", `${type}-${slot}`)
+    return menuItem
+  }
+
+  document.querySelectorAll("wa-layout > [slot]").forEach((el) => {
+    const slot = el.getAttribute("slot");
+    docFrag.append(makeMenuItem("toggle", slot), makeMenuItem("overflow", slot), document.createElement("wa-divider"))
+  })
+
+  docFrag.append(makeMenuItem("toggle", "main"), makeMenuItem("overflow", "main"))
+  layoutWidget.querySelector("wa-menu").append(docFrag)
+
+  function capitalize(string) {
+    return string.split(/\s+/).map((str) => str[0].toUppercase() + str.slice(1)).join(" ")
+  }
+
+  function handleSelect (e) {
+    const item = e.detail.item
+    const val = item.getAttribute("value")
+
+    if (val === "footer-0") {
+
+    }
+
+    const slot = val.split("-").slice(1).join("-")
+
+    let el
+
+    if (slot === "main") {
+      el = document.querySelector(`main`)
+    } else {
+      el = document.querySelector(`wa-layout > [slot='${slot}']`)
+    }
+
+    if (val.startsWith("overflow")) {
+      if (item.checked) {
+        el.textContent = "lorem ".repeat(1_000)
+        return
+      }
+
+      el.textContent = slot
+      return
+    }
+
+    if (val.startsWith("toggle")) {
+      if (item.checked) {
+        el.setAttribute("hidden", "")
+        return
+      }
+
+      el.removeAttribute("hidden")
+      return
+    }
+  }
+
+  layoutWidget.addEventListener("wa-select", handleSelect);
+{% if in_playground %}
+  &lt;/script>
+{% else %}
+  </script>
+{% endif %}
+<!-- playground-hide-end -->

docs/_includes/playground.njk

@@ -0,0 +1,31 @@
+<script type="module" src="/assets/scripts/light-pen/exports/index.js">
+</script>
+
+<light-pen style="height: 100%; padding: 8px;" resize-position="30" sandbox-settings="
+    allow-downloads
+    allow-forms
+    allow-modals
+    allow-orientation-lock
+    allow-pointer-lock
+    allow-popups
+    allow-presentation
+    allow-same-origin
+    allow-scripts
+">
+  <script type="text/plain" slot="html">
+{% include html_file %}
+  </script>
+
+  <script type="text/plain" slot="css">
+@import "/dist/themes/default.css";
+@import "/dist/themes/applied.css";
+
+{% include css_file %}
+  </script>
+
+  <script type="text/plain" slot="js">
+import { setBasePath } from "/dist/utilities/base-path.js";
+setBasePath("/dist");
+import("/dist/autoloader.js");
+  </script>
+</light-pen>

docs/_includes/sidebar.njk

@@ -1,4 +1,23 @@
 <ul>
+  <li>
+    <h2>Experimental</h2>
+    <ul>
+      <li><a href="/experimental/themer">Themer</a></li>
+      <li><a href="/experimental/style-guide">Style Guide</a></li>
+      <li><a href="/experimental/form-validation">Form Validation Styles</a></li>
+      <li style="margin-top: .5rem;"><wa-switch id="theme-toggle">Dark mode</wa-switch></li>
+      <script type="module">
+        // Temporary dark toggle
+        const toggle = document.getElementById('theme-toggle');
+        toggle.checked = document.documentElement.classList.contains('wa-theme-default-dark');
+
+        toggle.addEventListener('wa-change', () => {
+          document.documentElement.classList.toggle('wa-theme-default-dark');
+          localStorage.setItem('theme', toggle.checked ? 'dark' : 'light');
+        });
+      </script>
+    </ul>
+  </li>
   <li>
     <h2>Getting Started</h2>
     <ul>
@@ -34,7 +53,7 @@
     <ul>
       {% for component in meta.components %}
         <li>
-          <a href="/components/{{ component.tagName | removeSlPrefix }}">
+          <a href="/components/{{ component.tagName | removeWaPrefix }}">
             {{ component.name | classNameToComponentName }}
           </a>
         </li>
@@ -47,8 +66,8 @@
       <li><a href="/tokens/typography">Typography</a></li>
       <li><a href="/tokens/color">Color</a></li>
       <li><a href="/tokens/spacing">Spacing</a></li>
-      <li><a href="/tokens/elevation">Elevation</a></li>
-      <li><a href="/tokens/border-radius">Border Radius</a></li>
+      <li><a href="/tokens/borders">Borders</a></li>
+      <li><a href="/tokens/shadows">Shadows</a></li>
       <li><a href="/tokens/transition">Transition</a></li>
       <li><a href="/tokens/z-index">Z-index</a></li>
       <li><a href="/tokens/more">More Tokens</a></li>

docs/_utilities/code-previews.cjs

@@ -68,7 +68,7 @@ module.exports = function (doc, options) {
         <div class="code-preview__preview">
           ${code.textContent}
           <div class="code-preview__resizer">
-            <sl-icon name="grip-vertical"></sl-icon>
+            <wa-icon name="grip-vertical"></wa-icon>
           </div>
         </div>
 

docs/_utilities/copy-code-buttons.cjs

@@ -7,7 +7,7 @@ let codeBlockId = 0;
 module.exports = function (doc) {
   doc.querySelectorAll('pre > code').forEach(code => {
     const pre = code.closest('pre');
-    const button = doc.createElement('sl-copy-button');
+    const button = doc.createElement('wa-copy-button');
 
     if (!code.id) {
       code.id = `code-block-${++codeBlockId}`;

docs/_utilities/markdown.cjs

@@ -23,12 +23,20 @@ markdown.use(markdownItReplaceIt);
 
 // Callouts
 ['tip', 'warning', 'danger'].forEach(type => {
+  const variant = type === 'tip' ? 'brand' : type;
+  let icon = 'info-circle';
+  if (type === 'warning') icon = 'exclamation-circle';
+  if (type === 'danger') icon = 'exclamation-triangle';
+
   markdown.use(markdownItContainer, type, {
     render: function (tokens, idx) {
       if (tokens[idx].nesting === 1) {
-        return `<div role="alert" class="callout callout--${type}">`;
+        return `
+          <wa-alert class="callout" variant="${variant}" open>
+            <wa-icon slot="icon" name="${icon}"></wa-icon>
+        `;
       }
-      return '</div>\n';
+      return '</wa-alert>\n';
     }
   });
 });

docs/_utilities/replacer.cjs

@@ -13,7 +13,12 @@
  * @param {Replacements} replacements
  */
 module.exports = function (content, replacements) {
+  /** This seems trivial, but by assigning to a string first, THEN using innerHTML after iterating over every replacement, we reduce the calculations of JSDOM. At the time of writing benchmarks show a reduction from 9seconds to 3 seconds by doing so. */
+  let html = content.body.innerHTML;
+
   replacements.forEach(replacement => {
-    content.body.innerHTML = content.body.innerHTML.replaceAll(replacement.pattern, replacement.replacement);
+    html = html.replaceAll(replacement.pattern, replacement.replacement);
   });
+
+  content.body.innerHTML = html;
 };

docs/_utilities/scrolling-tables.cjs

@@ -1,8 +1,13 @@
 /**
- * Turns headings into clickable, deep linkable anchors. The provided doc should be a document object provided by JSDOM.
+ * Turns tables into scrollable tables
  * The same document will be returned with the appropriate DOM manipulations.
  */
 module.exports = function (doc, options) {
+  // We don't want to run this on layouts.
+  if (doc.querySelector("[data-layout='layout-example.njk']")) {
+    return;
+  }
+
   const tables = [...doc.querySelectorAll('table')];
 
   options = {

docs/assets/images/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="186" height="186" viewBox="0 0 186 186"><g fill="none" fill-rule="evenodd"><rect width="186" height="186" fill="#103257" opacity="0"/><path fill="#F6894C" d="M106.95,13.9672306 C106.95,19.1752428 104.10296,23.7175103 99.8823543,26.1190227 L130.2,48.8851296 L159.91784,39.4892184 C158.760743,37.4541707 158.1,35.0993755 158.1,32.5902046 C158.1,24.8763205 164.345703,18.6229741 172.05,18.6229741 C179.754297,18.6229741 186,24.8763205 186,32.5902046 C186,40.3040179 179.754297,46.5574352 172.05,46.5574352 C171.315566,46.5574352 170.594594,46.5006795 169.890983,46.39107 L137.151086,130.163238 C134.361086,137.302399 127.486526,142 119.830057,142 L66.1699429,142 C58.5134743,142 51.6389143,137.302399 48.8489143,130.163238 L16.1089463,46.39107 C15.4052994,46.5006795 14.6842926,46.5574352 13.95,46.5574352 C6.245632,46.5574352 0,40.3040179 0,32.5902046 C0,24.8763205 6.245632,18.6229741 13.95,18.6229741 C21.654368,18.6229741 27.9,24.8763205 27.9,32.5902046 C27.9,35.0993755 27.2391509,37.4541707 26.0822663,39.4892184 L55.8,48.8851296 L86.1176457,26.1190227 C81.89704,23.7175103 79.05,19.1752428 79.05,13.9672306 C79.05,6.25334639 85.2957029,0 93,0 C100.704297,0 106.95,6.25334639 106.95,13.9672306 Z" transform="translate(0 22)"/></g></svg>

docs/assets/scripts/code-previews.js

@@ -1,7 +1,7 @@
 (() => {
   function convertModuleLinks(html) {
     html = html
-      .replace(/@shoelace-style\/shoelace/g, `https://esm.sh/@shoelace-style/shoelace@${shoelaceVersion}`)
+      .replace(/@shoelace-style\/shoelace/g, `https://esm.sh/@shoelace-style/shoelace@${waVersion}`)
       .replace(/from 'react'/g, `from 'https://esm.sh/react@${reactVersion}'`)
       .replace(/from "react"/g, `from "https://esm.sh/react@${reactVersion}"`);
 
@@ -64,7 +64,7 @@
     });
   }
 
-  const shoelaceVersion = document.documentElement.getAttribute('data-shoelace-version');
+  const waVersion = document.documentElement.getAttribute('data-wa-version');
   const reactVersion = '18.2.0';
   const cdndir = 'cdn';
   const npmdir = 'dist';
@@ -72,8 +72,8 @@
   let count = 1;
 
   // We need the version to open
-  if (!shoelaceVersion) {
-    throw new Error('The data-shoelace-version attribute is missing from <html>.');
+  if (!waVersion) {
+    throw new Error('The data-wa-version attribute is missing from <html>.');
   }
 
   // Sync flavor UI on page load
@@ -166,9 +166,6 @@
       const htmlExample = codeBlock.querySelector('.code-preview__source--html > pre > code')?.textContent;
       const reactExample = codeBlock.querySelector('.code-preview__source--react > pre > code')?.textContent;
       const isReact = flavor === 'react' && typeof reactExample === 'string';
-      const theme = document.documentElement.classList.contains('sl-theme-dark') ? 'dark' : 'light';
-      const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
-      const isDark = theme === 'dark' || (theme === 'auto' && prefersDark);
       const editors = isReact ? '0010' : '1000';
       let htmlTemplate = '';
       let jsTemplate = '';
@@ -182,7 +179,7 @@
       // HTML templates
       if (!isReact) {
         htmlTemplate =
-          `<script type="module" src="https://cdn.jsdelivr.net/npm/@shoelace-style/shoelace@${shoelaceVersion}/${cdndir}/shoelace.js"></script>\n` +
+          `<script type="module" src="https://cdn.jsdelivr.net/npm/@shoelace-style/shoelace@${waVersion}/${cdndir}/autoloader.js"></script>\n` +
           `\n${htmlExample}`;
         jsTemplate = '';
       }
@@ -193,10 +190,10 @@
         jsTemplate =
           `import React from 'https://esm.sh/react@${reactVersion}';\n` +
           `import ReactDOM from 'https://esm.sh/react-dom@${reactVersion}';\n` +
-          `import { setBasePath } from 'https://esm.sh/@shoelace-style/shoelace@${shoelaceVersion}/${cdndir}/utilities/base-path';\n` +
+          `import { setBasePath } from 'https://esm.sh/@shoelace-style/shoelace@${waVersion}/${cdndir}/utilities/base-path';\n` +
           `\n` +
-          `// Set the base path for Shoelace assets\n` +
-          `setBasePath('https://esm.sh/@shoelace-style/shoelace@${shoelaceVersion}/${npmdir}/')\n` +
+          `// Set the base path for Web Awesome assets\n` +
+          `setBasePath('https://esm.sh/@shoelace-style/shoelace@${waVersion}/${npmdir}/')\n` +
           `\n${convertModuleLinks(reactExample)}\n` +
           `\n` +
           `ReactDOM.render(<App />, document.getElementById('root'));`;
@@ -204,25 +201,22 @@
 
       // CSS templates
       cssTemplate =
-        `@import 'https://cdn.jsdelivr.net/npm/@shoelace-style/shoelace@${shoelaceVersion}/${cdndir}/themes/${
-          isDark ? 'dark' : 'light'
-        }.css';\n` +
+        `@import 'https://cdn.jsdelivr.net/npm/@shoelace-style/shoelace@${waVersion}/${cdndir}/themes/default.css';\n` +
         '\n' +
         'body {\n' +
-        '  font: 16px sans-serif;\n' +
-        '  background-color: var(--sl-color-neutral-0);\n' +
-        '  color: var(--sl-color-neutral-900);\n' +
-        '  padding: 1rem;\n' +
+        '  font: var(--wa-font-size-root) sans-serif;\n' +
+        '  background-color: var(--wa-color-surface-default);\n' +
+        '  color: var(--wa-color-text-normal);\n' +
+        '  padding: var(--wa-space-m);\n' +
         '}';
 
       // Docs: https://blog.codepen.io/documentation/prefill/
       const data = {
         title: '',
         description: '',
-        tags: ['shoelace', 'web components'],
+        tags: ['web awesome', 'web components'],
         editors,
         head: `<meta name="viewport" content="width=device-width">`,
-        html_classes: `sl-theme-${isDark ? 'dark' : 'light'}`,
         css_external: ``,
         js_external: ``,
         js_module: true,

docs/assets/scripts/docs.js

@@ -15,7 +15,7 @@
   }
 
   function isSidebarVisible() {
-    return getSidebar().getBoundingClientRect().x >= 0;
+    return getSidebar()?.getBoundingClientRect().x >= 0;
   }
 
   function toggleSidebar(force) {
@@ -24,7 +24,11 @@
   }
 
   function updateInert() {
-    getSidebar().inert = !isSidebarVisible();
+    const sidebar = getSidebar();
+
+    if (sidebar) {
+      sidebar.inert = !isSidebarVisible();
+    }
   }
 
   // Toggle the menu
@@ -73,72 +77,6 @@
   updateInert();
 })();
 
-//
-// Theme selector
-//
-(() => {
-  function getTheme() {
-    return localStorage.getItem('theme') || 'auto';
-  }
-
-  function isDark() {
-    if (theme === 'auto') {
-      return window.matchMedia('(prefers-color-scheme: dark)').matches;
-    }
-    return theme === 'dark';
-  }
-
-  function setTheme(newTheme) {
-    theme = newTheme;
-    localStorage.setItem('theme', theme);
-
-    // Update the UI
-    updateSelection();
-
-    // Toggle the dark mode class
-    document.documentElement.classList.toggle('sl-theme-dark', isDark());
-  }
-
-  function updateSelection() {
-    const menu = document.querySelector('#theme-selector sl-menu');
-    if (!menu) return;
-    [...menu.querySelectorAll('sl-menu-item')].map(item => (item.checked = item.getAttribute('value') === theme));
-  }
-
-  let theme = getTheme();
-
-  // Selection is not preserved when changing page, so update when opening dropdown
-  document.addEventListener('sl-show', event => {
-    const themeSelector = event.target.closest('#theme-selector');
-    if (!themeSelector) return;
-    updateSelection();
-  });
-
-  // Listen for selections
-  document.addEventListener('sl-select', event => {
-    const menu = event.target.closest('#theme-selector sl-menu');
-    if (!menu) return;
-    setTheme(event.detail.item.value);
-  });
-
-  // Update the theme when the preference changes
-  window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', () => setTheme(theme));
-
-  // Toggle with backslash
-  document.addEventListener('keydown', event => {
-    if (
-      event.key === '\\' &&
-      !event.composedPath().some(el => ['input', 'textarea'].includes(el?.tagName?.toLowerCase()))
-    ) {
-      event.preventDefault();
-      setTheme(isDark() ? 'light' : 'dark');
-    }
-  });
-
-  // Set the initial theme and sync the UI
-  setTheme(theme);
-})();
-
 //
 // Open details when printing
 //

docs/assets/scripts/light-pen/CHANGELOG.md

@@ -0,0 +1,11 @@
+## 1.1.0
+
+- A number of fixes including allowing `<template>` elements to be slotted into `<light-pen>` and `<light-preview>`
+
+## 1.0.2
+
+- fix: issues with `&gt;` and `&lt;`
+
+## 1.0.1
+
+- fix: allow any HTML Element for templating

docs/assets/scripts/light-pen/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Konnor Rogers
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

docs/assets/scripts/light-pen/README.md

@@ -0,0 +1,96 @@
+# Light(weight) Code(pen)
+
+## Demo
+
+<https://konnorrogers.github.io/light-pen>
+
+## Purpose
+
+A small lightweight editor using `<pre><code></code></pre>` and a `<textarea>`
+
+Inspired by Chris Ferdinandi
+
+## Install
+
+```
+npm install light-pen
+```
+
+## Getting started
+
+```js
+// Auto-register <light-pen>
+import "light-pen"
+
+// Registry yourself
+import LightPen "light-pen/exports/light-pen.js"
+
+LightPen.define() // Registers `<light-pen>`
+
+// Register under another name
+import LightPen "light-pen/exports/light-pen.js"
+LightPen.define("other-name")
+```
+
+## Usage
+
+```html
+<light-pen></light-pen>
+```
+
+That's it!
+
+
+### Slotting in HTML / CSS / JS
+
+```html
+<light-pen>
+  <script type="text/plain" slot="html">
+    <div style="color: red;">
+      <div>Hi there friends</div>
+    </div>
+
+    <p>
+      Sup dude
+    </p>
+  </script>
+
+  <script type="text/plain" slot="css">
+    p {
+      color: green;
+    }
+  </script>
+
+  <script type="text/plain" slot="js">
+    console.log("Hi")
+  </script>
+</light-pen>
+```
+
+### Changing the title
+
+```html
+<light-pen>
+  <div slot="title">My Awesome Editor</div>
+</light-pen>
+```
+
+### Opening languages by default
+
+`<light-pen>` Takes a string of comma separated languages to open on initial render.
+
+```
+<light-pen open-languages="html,css,js">
+</light-pen>
+```
+
+More to come for more docs coming on how to change things!
+
+## Roadmap
+
+- [ ] - Implement an extendable `LightPenBase` which includes a pluggable syntax highlighter and theme.
+- [ ] - Implement `<textarea>` rendering hooks to add CodeMirror for more robuste setups.
+- [ ] - Add vertical resizing of `<textarea>`
+- [ ] - More documentation around customization.
+- [ ] - Add a console logger
+>>>>>>> 7b592c8f5f05ed82d439d7950450eec06dc3ab66

docs/assets/scripts/light-pen/custom-elements-manifest.config.js

@@ -0,0 +1,44 @@
+// @ts-check
+// import { expandTypesPlugin } from './expand-types.js'
+
+const globs = ['exports/**/*.{d.ts,js}', 'internal/**/*.{d.ts,js}', 'types/**/*.d.ts']
+
+export default {
+  /** Globs to analyze */
+  globs,
+  /** Globs to exclude */
+  exclude: ['node_modules', 'docs'],
+  /** Directory to output CEM to */
+  outdir: '.',
+  /** Run in dev mode, provides extra logging */
+  dev: process.argv.includes("--verbose"),
+  /** Run in watch mode, runs on file changes */
+  watch: process.argv.includes("--watch"),
+  /** Include third party custom elements manifests */
+  dependencies: true,
+  /** Output CEM path to `package.json`, defaults to true */
+  packagejson: true,
+  /** Enable special handling for litelement */
+  litelement: true,
+  /** Enable special handling for catalyst */
+  catalyst: false,
+  /** Enable special handling for fast */
+  fast: false,
+  /** Enable special handling for stencil */
+  stencil: false,
+  // overrideModuleCreation: ({ts, globs}) => {
+  //   const program = ts.createProgram(globs, {target: ts.ScriptTarget.ESNext, module: ts.ModuleKind.ESNext, allowJs: true, checkJs: true});
+  //
+  //   // If we dont do this, everything blows up.
+  //   program.getTypeChecker()
+  //
+  //   return program.getSourceFiles().filter(sf => globs.find(glob => {
+  //     return sf.fileName.includes(glob)
+  //   }))
+  // },
+  // /** Provide custom plugins */
+  // plugins: [
+  //   /** You can now pass the typeChecker to your plugins */
+  //   expandTypesPlugin({ globs })
+  // ],
+}

docs/assets/scripts/light-pen/docs/.gitignore

@@ -0,0 +1,38 @@
+# Bridgetown
+output
+.bridgetown-cache
+.bridgetown-metadata
+.bridgetown-webpack
+
+# Dependency folders
+node_modules
+bower_components
+vendor
+
+# Caches
+.sass-cache
+.npm
+.node_repl_history
+
+# Ignore bundler config.
+/.bundle
+
+# Ignore Byebug command history file.
+.byebug_history
+
+# dotenv environment variables file
+.env
+
+# Mac files
+.DS_Store
+
+# Yarn
+yarn-error.log
+yarn-debug.log*
+.pnp/
+.pnp.js
+# Yarn Integrity file
+.yarn-integrity
+
+src/bridgetown
+src/meta.json

docs/assets/scripts/light-pen/docs/.ruby-version

@@ -0,0 +1 @@
+ruby-3.0.4

docs/assets/scripts/light-pen/docs/Gemfile

@@ -0,0 +1,49 @@
+source "https://rubygems.org"
+git_source(:github) { |repo| "https://github.com/#{repo}.git" }
+
+####
+# Welcome to your project's Gemfile, used by Rubygems & Bundler.
+#
+# To install a plugin, run:
+#
+#   bundle add new-plugin-name -g bridgetown_plugins
+#
+# This will ensure the plugin is added to the correct Bundler group.
+#
+# When you run Bridgetown commands, we recommend using a binstub like so:
+#
+#   bin/bridgetown start (or console, etc.)
+#
+# This will help ensure the proper Bridgetown version is running.
+####
+
+# If you need to upgrade/switch Bridgetown versions, change the line below
+# and then run `bundle update bridgetown`
+gem "bridgetown", "~> 1.3"
+
+# Uncomment to add file-based dynamic routing to your project:
+# gem "bridgetown-routes", "~> 1.3"
+
+# Uncomment to use the Inspectors API to manipulate the output
+# of your HTML or XML resources:
+gem "nokogiri", "~> 1.13"
+
+# Puma is a Rack-compatible server used by Bridgetown
+# (you can optionally limit this to the "development" group)
+gem "puma", "~> 5.6"
+
+gem "bridgetown-quick-search", "~> 2.0"
+
+# gem "asset_mapper", "~> 1.0"
+gem "asset_mapper", "~> 1.0"
+
+# gem "rack-cors", "~> 2.0"
+
+gem "rack-cors", "~> 2.0"
+
+gem "custom_elements_manifest_parser", "~> 0.2.4"
+
+gem "ruby-lsp", "~> 0.11.1", :group => :development, require: false
+gem "yard", "~> 0.9.34", :group => :development
+gem "solargraph", "~> 0.49.0", :group => :development
+gem "debug", "~> 1.8", :group => :development

docs/assets/scripts/light-pen/docs/Gemfile.lock

@@ -0,0 +1,241 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activemodel (7.0.8)
+      activesupport (= 7.0.8)
+    activesupport (7.0.8)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 1.6, < 2)
+      minitest (>= 5.1)
+      tzinfo (~> 2.0)
+    addressable (2.8.5)
+      public_suffix (>= 2.0.2, < 6.0)
+    amazing_print (1.5.0)
+    asset_mapper (1.0.1)
+      dry-configurable (~> 1.0)
+      dry-files (~> 1.0)
+      dry-initializer (~> 3.0)
+      dry-types (~> 1.5)
+      rake (>= 10)
+      zeitwerk (~> 2.5)
+    ast (2.4.2)
+    backport (1.2.0)
+    base64 (0.1.1)
+    benchmark (0.2.1)
+    bridgetown (1.3.1)
+      bridgetown-builder (= 1.3.1)
+      bridgetown-core (= 1.3.1)
+      bridgetown-paginate (= 1.3.1)
+    bridgetown-builder (1.3.1)
+      bridgetown-core (= 1.3.1)
+    bridgetown-core (1.3.1)
+      activemodel (>= 6.0, < 8.0)
+      activesupport (>= 6.0, < 8.0)
+      addressable (~> 2.4)
+      amazing_print (~> 1.2)
+      colorator (~> 1.0)
+      erubi (~> 1.9)
+      faraday (~> 2.0)
+      faraday-follow_redirects (~> 0.3)
+      hash_with_dot_access (~> 1.2)
+      i18n (~> 1.0)
+      kramdown (~> 2.1)
+      kramdown-parser-gfm (~> 1.0)
+      liquid (~> 5.0)
+      listen (~> 3.0)
+      rake (>= 13.0)
+      roda (~> 3.46)
+      rouge (~> 3.0)
+      serbea (~> 1.0)
+      thor (~> 1.1)
+      tilt (~> 2.0)
+      zeitwerk (~> 2.5)
+    bridgetown-paginate (1.3.1)
+      bridgetown-core (= 1.3.1)
+    bridgetown-quick-search (2.0.0)
+      bridgetown (>= 1.2.0.beta2, < 2.0)
+    colorator (1.1.0)
+    concurrent-ruby (1.2.2)
+    custom_elements_manifest_parser (0.2.4)
+      dry-struct (~> 1.0)
+      dry-types (~> 1.0)
+      dry-validation (~> 1.0)
+    debug (1.8.0)
+      irb (>= 1.5.0)
+      reline (>= 0.3.1)
+    diff-lcs (1.5.0)
+    dry-configurable (1.1.0)
+      dry-core (~> 1.0, < 2)
+      zeitwerk (~> 2.6)
+    dry-core (1.0.1)
+      concurrent-ruby (~> 1.0)
+      zeitwerk (~> 2.6)
+    dry-files (1.0.1)
+    dry-inflector (1.0.0)
+    dry-initializer (3.1.1)
+    dry-logic (1.5.0)
+      concurrent-ruby (~> 1.0)
+      dry-core (~> 1.0, < 2)
+      zeitwerk (~> 2.6)
+    dry-schema (1.13.3)
+      concurrent-ruby (~> 1.0)
+      dry-configurable (~> 1.0, >= 1.0.1)
+      dry-core (~> 1.0, < 2)
+      dry-initializer (~> 3.0)
+      dry-logic (>= 1.4, < 2)
+      dry-types (>= 1.7, < 2)
+      zeitwerk (~> 2.6)
+    dry-struct (1.6.0)
+      dry-core (~> 1.0, < 2)
+      dry-types (>= 1.7, < 2)
+      ice_nine (~> 0.11)
+      zeitwerk (~> 2.6)
+    dry-types (1.7.1)
+      concurrent-ruby (~> 1.0)
+      dry-core (~> 1.0)
+      dry-inflector (~> 1.0)
+      dry-logic (~> 1.4)
+      zeitwerk (~> 2.6)
+    dry-validation (1.10.0)
+      concurrent-ruby (~> 1.0)
+      dry-core (~> 1.0, < 2)
+      dry-initializer (~> 3.0)
+      dry-schema (>= 1.12, < 2)
+      zeitwerk (~> 2.6)
+    e2mmap (0.1.0)
+    erubi (1.12.0)
+    faraday (2.7.11)
+      base64
+      faraday-net_http (>= 2.0, < 3.1)
+      ruby2_keywords (>= 0.0.4)
+    faraday-follow_redirects (0.3.0)
+      faraday (>= 1, < 3)
+    faraday-net_http (3.0.2)
+    ffi (1.15.5)
+    hash_with_dot_access (1.2.0)
+      activesupport (>= 5.0.0, < 8.0)
+    i18n (1.14.1)
+      concurrent-ruby (~> 1.0)
+    ice_nine (0.11.2)
+    io-console (0.6.0)
+    irb (1.8.1)
+      rdoc
+      reline (>= 0.3.8)
+    jaro_winkler (1.5.6)
+    json (2.6.3)
+    kramdown (2.4.0)
+      rexml
+    kramdown-parser-gfm (1.1.0)
+      kramdown (~> 2.0)
+    language_server-protocol (3.17.0.3)
+    liquid (5.4.0)
+    listen (3.8.0)
+      rb-fsevent (~> 0.10, >= 0.10.3)
+      rb-inotify (~> 0.9, >= 0.9.10)
+    minitest (5.20.0)
+    nio4r (2.5.8)
+    nokogiri (1.13.9-arm64-darwin)
+      racc (~> 1.4)
+    nokogiri (1.13.9-x86_64-linux)
+      racc (~> 1.4)
+    parallel (1.23.0)
+    parser (3.2.2.4)
+      ast (~> 2.4.1)
+      racc
+    psych (5.1.0)
+      stringio
+    public_suffix (5.0.3)
+    puma (5.6.5)
+      nio4r (~> 2.0)
+    racc (1.6.0)
+    rack (3.0.8)
+    rack-cors (2.0.1)
+      rack (>= 2.0.0)
+    rainbow (3.1.1)
+    rake (13.0.6)
+    rb-fsevent (0.11.2)
+    rb-inotify (0.10.1)
+      ffi (~> 1.0)
+    rbs (2.8.4)
+    rdoc (6.5.0)
+      psych (>= 4.0.0)
+    regexp_parser (2.8.1)
+    reline (0.3.9)
+      io-console (~> 0.5)
+    reverse_markdown (2.1.1)
+      nokogiri
+    rexml (3.2.6)
+    roda (3.72.0)
+      rack
+    rouge (3.30.0)
+    rubocop (1.56.4)
+      base64 (~> 0.1.1)
+      json (~> 2.3)
+      language_server-protocol (>= 3.17.0)
+      parallel (~> 1.10)
+      parser (>= 3.2.2.3)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml (>= 3.2.5, < 4.0)
+      rubocop-ast (>= 1.28.1, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 3.0)
+    rubocop-ast (1.29.0)
+      parser (>= 3.2.1.0)
+    ruby-lsp (0.11.1)
+      language_server-protocol (~> 3.17.0)
+      sorbet-runtime (>= 0.5.5685)
+      yarp (>= 0.12, < 0.13)
+    ruby-progressbar (1.13.0)
+    ruby2_keywords (0.0.5)
+    serbea (1.0.1)
+      activesupport (>= 6.0)
+      erubi (>= 1.10)
+      tilt (~> 2.0)
+    solargraph (0.49.0)
+      backport (~> 1.2)
+      benchmark
+      bundler (~> 2.0)
+      diff-lcs (~> 1.4)
+      e2mmap
+      jaro_winkler (~> 1.5)
+      kramdown (~> 2.3)
+      kramdown-parser-gfm (~> 1.1)
+      parser (~> 3.0)
+      rbs (~> 2.0)
+      reverse_markdown (~> 2.0)
+      rubocop (~> 1.38)
+      thor (~> 1.0)
+      tilt (~> 2.0)
+      yard (~> 0.9, >= 0.9.24)
+    sorbet-runtime (0.5.11064)
+    stringio (3.0.8)
+    thor (1.2.2)
+    tilt (2.3.0)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    unicode-display_width (2.5.0)
+    yard (0.9.34)
+    yarp (0.12.0)
+    zeitwerk (2.6.12)
+
+PLATFORMS
+  arm64-darwin-21
+  arm64-darwin-22
+  x86_64-linux
+
+DEPENDENCIES
+  asset_mapper (~> 1.0)
+  bridgetown (~> 1.3)
+  bridgetown-quick-search (~> 2.0)
+  custom_elements_manifest_parser (~> 0.2.4)
+  debug (~> 1.8)
+  nokogiri (~> 1.13)
+  puma (~> 5.6)
+  rack-cors (~> 2.0)
+  ruby-lsp (~> 0.11.1)
+  solargraph (~> 0.49.0)
+  yard (~> 0.9.34)
+
+BUNDLED WITH
+   2.3.5

docs/assets/scripts/light-pen/docs/Procfile.dev

@@ -0,0 +1,2 @@
+bridgetown: bin/bridgetown start --skip-frontend
+esbuild: pnpm run esbuild-dev

docs/assets/scripts/light-pen/docs/README.md

@@ -0,0 +1,70 @@
+# Bridgetown Website README
+
+Welcome to your new Bridgetown website! You can update this README file to provide additional context and setup information for yourself or other contributors.
+
+## Table of Contents
+
+- [Prerequisites](#prerequisites)
+- [Install](#install)
+- [Development](#development)
+- [Commands](#commands)
+- [Deployment](#deployment)
+- [Contributing](#contributing)
+
+## Prerequisites
+
+- [GCC](https://gcc.gnu.org/install/)
+- [Make](https://www.gnu.org/software/make/)
+- [Ruby](https://www.ruby-lang.org/en/downloads/)
+  - `>= 2.7`
+- [Bridgetown Gem](https://rubygems.org/gems/bridgetown)
+  - `gem install bridgetown -N`
+- [Node](https://nodejs.org)
+  - `>= 12`
+- [Yarn](https://yarnpkg.com)
+
+## Install
+
+```sh
+cd bridgetown-site-folder
+bundle install && yarn install
+```
+> Learn more: [Bridgetown Getting Started Documentation](https://www.bridgetownrb.com/docs/).
+
+## Development
+
+To start your site in development mode, run `bin/bridgetown start` and navigate to [localhost:4000](https://localhost:4000/)!
+
+Use a [theme](https://github.com/topics/bridgetown-theme) or add some [plugins](https://www.bridgetownrb.com/plugins/) to get started quickly.
+
+### Commands
+
+```sh
+# running locally
+bin/bridgetown start
+
+# build & deploy to production
+bin/bridgetown deploy
+
+# load the site up within a Ruby console (IRB)
+bin/bridgetown console
+```
+
+> Learn more: [Bridgetown CLI Documentation](https://www.bridgetownrb.com/docs/command-line-usage)
+
+## Deployment
+
+You can deploy Bridgetown sites on hosts like Render or Vercel as well as traditional web servers by simply building and copying the output folder to your HTML root.
+
+> Read the [Bridgetown Deployment Documentation](https://www.bridgetownrb.com/docs/deployment) for more information.
+
+## Contributing
+
+If repo is on GitHub:
+
+1. Fork it
+2. Clone the fork using `git clone` to your local development machine.
+3. Create your feature branch (`git checkout -b my-new-feature`)
+4. Commit your changes (`git commit -am 'Add some feature'`)
+5. Push to the branch (`git push origin my-new-feature`)
+6. Create a new Pull Request

docs/assets/scripts/light-pen/docs/Rakefile

@@ -0,0 +1,49 @@
+require "bridgetown"
+
+Bridgetown.load_tasks
+
+# Run rake without specifying any command to execute a deploy build by default.
+task default: :deploy
+
+#
+# Standard set of tasks, which you can customize if you wish:
+#
+desc "Build the Bridgetown site for deployment"
+task :deploy => [:clean, "frontend:build"] do
+  Bridgetown::Commands::Build.start
+end
+
+desc "Build the site in a test environment"
+task :test do
+  ENV["BRIDGETOWN_ENV"] = "test"
+  Bridgetown::Commands::Build.start
+end
+
+desc "Runs the clean command"
+task :clean do
+  Bridgetown::Commands::Clean.start
+end
+
+namespace :frontend do
+  desc "Build the frontend with esbuild for deployment"
+  task :build do
+    sh "yarn run esbuild"
+  end
+
+  desc "Watch the frontend with esbuild during development"
+  task :dev do
+    sh "yarn run esbuild-dev"
+  rescue Interrupt
+  end
+end
+
+#
+# Add your own Rake tasks here! You can use `environment` as a prerequisite
+# in order to write automations or other commands requiring a loaded site.
+#
+# task :my_task => :environment do
+#   puts site.root_dir
+#   automation do
+#     say_status :rake, "I'm a Rake tast =) #{site.config.url}"
+#   end
+# end

docs/assets/scripts/light-pen/docs/bin/bridgetown

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'bridgetown' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("bridgetown-core", "bridgetown")

docs/assets/scripts/light-pen/docs/bin/bt

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'bridgetown' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("bridgetown-core", "bridgetown")

docs/assets/scripts/light-pen/docs/bridgetown.config.yml

@@ -0,0 +1,48 @@
+baseurl: "" # OPTIONAL: the subpath of your site, e.g. /blog
+url: "" # the base hostname & protocol for your site, e.g. https://example.com
+destination: output
+
+development:
+  url: "localhost:4000"
+# production:
+#   url: "https://konnorrogers.github.io"
+#   base_path: "/light-pen"
+
+template_engine: erb
+permalink: pretty
+
+collections:
+  documentation:
+    output: true
+
+defaults:
+  - scope:
+      path: "images"
+    values:
+      image: true
+
+  - scope:
+      path: "_documentation"
+    values:
+      layout: doc
+      permalink: /:categories/:slug
+      category_order: 0
+      doc_order: 0
+
+  - scope:
+      path: "_documentation/guides"
+    values:
+      category: guides
+      category_order: 10
+
+  - scope:
+      path: "_documentation/components"
+    values:
+      category: components
+      category_order: 20
+
+  - scope:
+      path: "_documentation/references"
+    values:
+      category: references
+      category_order: 30

docs/assets/scripts/light-pen/docs/config.ru

@@ -0,0 +1,16 @@
+# This file is used by Rack-based servers during the Bridgetown boot process.
+
+require "bridgetown-core/rack/boot"
+
+Bridgetown::Rack.boot
+
+require "rack/cors"
+
+use Rack::Cors do
+  allow do
+    origins '*'
+    resource '/*', headers: :any, methods: :get
+  end
+end
+
+run RodaApp.freeze.app # see server/roda_app.rb

docs/assets/scripts/light-pen/docs/config/esbuild.defaults.js

@@ -0,0 +1,310 @@
+// This file is created and managed by Bridgetown.
+// Instead of editing this file, add your overrides to `esbuild.config.js`
+//
+// To update this file to the latest version provided by Bridgetown,
+// run `bridgetown esbuild update`. Any changes to this file will be overwritten
+// when an update is applied hence we strongly recommend adding overrides to
+// `esbuild.config.js` instead of editing this file.
+//
+// Shipped with Bridgetown v1.1.0
+
+const path = require("path")
+const fsLib = require("fs")
+const fs = fsLib.promises
+const { pathToFileURL, fileURLToPath } = require("url")
+const glob = require("glob")
+const postcss = require("postcss")
+const postCssImport = require("postcss-import")
+const readCache = require("read-cache")
+
+// Detect if an NPM package is available
+const moduleAvailable = name => {
+  try {
+    require.resolve(name)
+    return true
+  } catch (e) { }
+  return false
+}
+
+// Generate a Source Map URL (used by the Sass plugin)
+const generateSourceMappingURL = sourceMap => {
+  const data = Buffer.from(JSON.stringify(sourceMap), "utf-8").toString("base64")
+  return `/*# sourceMappingURL=data:application/json;charset=utf-8;base64,${data} */`
+}
+
+// Import Sass if available
+let sass
+if (moduleAvailable("sass")) {
+  sass = require("sass")
+}
+
+// Glob plugin derived from:
+// https://github.com/thomaschaaf/esbuild-plugin-import-glob
+// https://github.com/xiaohui-zhangxh/jsbundling-rails/commit/b15025dcc20f664b2b0eb238915991afdbc7cb58
+const importGlobPlugin = () => ({
+  name: "import-glob",
+  setup: (build) => {
+    build.onResolve({ filter: /\*/ }, async (args) => {
+      if (args.resolveDir === "") {
+        return; // Ignore unresolvable paths
+      }
+
+      const adjustedPath = args.path.replace(/^bridgetownComponents\//, "../../src/_components/")
+
+      return {
+        path: adjustedPath,
+        namespace: "import-glob",
+        pluginData: {
+          path: adjustedPath,
+          resolveDir: args.resolveDir,
+        },
+      }
+    })
+
+    build.onLoad({ filter: /.*/, namespace: "import-glob" }, async (args) => {
+      const files = glob.sync(args.pluginData.path, {
+        cwd: args.pluginData.resolveDir,
+      }).sort()
+
+      const importerCode = `
+        ${files
+          .map((module, index) => `import * as module${index} from '${module}'`)
+          .join(';')}
+        const modules = {${files
+          .map((module, index) => `
+            "${module.replace("../../src/_components/", "")}": module${index},`)
+          .join("")}
+        };
+        export default modules;
+      `
+
+      return { contents: importerCode, resolveDir: args.pluginData.resolveDir }
+    })
+  },
+})
+
+// Plugin for PostCSS
+const postCssPlugin = (options, configuration) => ({
+  name: "postcss",
+  async setup(build) {
+    // Process .css files with PostCSS
+    build.onLoad({ filter: (configuration.filter || /\.css$/) }, async (args) => {
+      const additionalFilePaths = []
+      const css = await fs.readFile(args.path, "utf8")
+
+      // Configure import plugin so PostCSS can properly resolve `@import`ed CSS files
+      const importPlugin = postCssImport({
+        filter: itemPath => !itemPath.startsWith("/"), // ensure it doesn't try to import source-relative paths
+        load: async filename => {
+          let contents = await readCache(filename, "utf-8")
+          const filedir = path.dirname(filename)
+          // We'll want to track any imports later when in watch mode:
+          additionalFilePaths.push(filename)
+
+          // We need to transform `url(...)` in imported CSS so the filepaths are properly
+          // relative to the entrypoint. Seems icky to have to hack this! C'est la vie...
+          contents = contents.replace(/url\(['"]?\.\/(.*?)['"]?\)/g, (_match, p1) => {
+            const relpath = path.relative(args.path, path.resolve(filedir, p1)).replace(/^\.\.\//, "")
+            return `url("${relpath}")`
+          })
+          return contents
+        }
+      })
+
+      // Process the file through PostCSS
+      const result = await postcss([importPlugin, ...options.plugins]).process(css, {
+        map: true,
+        ...options.options,
+        from: args.path,
+      });
+
+      return {
+        contents: result.css,
+        loader: "css",
+        watchFiles: [args.path, ...additionalFilePaths],
+      }
+    })
+  },
+})
+
+// Plugin for Sass
+const sassPlugin = (options) => ({
+  name: "sass",
+  async setup(build) {
+    // Process .scss and .sass files with Sass
+    build.onLoad({ filter: /\.(sass|scss)$/ }, async (args) => {
+      if (!sass) {
+        console.error("error: Sass is not installed. Try running `yarn add sass` and then building again.")
+        return
+      }
+
+      const modulesFolder = pathToFileURL("node_modules/")
+
+      const localOptions = {
+        importers: [{
+          // An importer that redirects relative URLs starting with "~" to
+          // `node_modules`.
+          findFileUrl(url) {
+            if (!url.startsWith('~')) return null
+            return new URL(url.substring(1), modulesFolder)
+          }
+        }],
+        sourceMap: true,
+        ...options
+      }
+      const result = sass.compile(args.path, localOptions)
+
+      const watchPaths = result.loadedUrls
+        .filter((x) => x.protocol === "file:" && !x.pathname.startsWith(modulesFolder.pathname))
+        .map((x) => x.pathname)
+
+      let cssOutput = result.css.toString()
+
+      if (result.sourceMap) {
+        const basedir = process.cwd()
+        const sourceMap = result.sourceMap
+
+        const promises = sourceMap.sources.map(async source => {
+          const sourceFile = await fs.readFile(fileURLToPath(source), "utf8")
+          return sourceFile
+        })
+        sourceMap.sourcesContent = await Promise.all(promises)
+
+        sourceMap.sources = sourceMap.sources.map(source => {
+          return path.relative(basedir, fileURLToPath(source))
+        })
+
+        cssOutput += '\n' + generateSourceMappingURL(sourceMap)
+      }
+
+      return {
+        contents: cssOutput,
+        loader: "css",
+        watchFiles: [args.path, ...watchPaths],
+      }
+    })
+  },
+})
+
+// Set up defaults and generate frontend bundling manifest file
+const bridgetownPreset = (outputFolder) => ({
+  name: "bridgetownPreset",
+  async setup(build) {
+    // Ensure any imports anywhere starting with `/` are left verbatim
+    // so they can be used in-browser for actual `src` repo files
+    build.onResolve({ filter: /^\// }, args => {
+      return { path: args.path, external: true }
+    })
+
+    build.onStart(() => {
+      console.log("esbuild: frontend bundling started...")
+    })
+
+    // Generate the final output manifest
+    build.onEnd(async (result) => {
+      if (!result.metafile) {
+        console.warn("esbuild: build process error, cannot write manifest")
+        return
+      }
+      await fs.writeFile(path.join(outputFolder, 'meta.json'), JSON.stringify(result.metafile), { encoding: "utf8" })
+
+      const manifest = {}
+      const entrypoints = []
+
+      // We don't need `frontend/` cluttering up everything
+      // const stripPrefix = (str) => str.replace(/^frontend\//, "")
+
+      // For calculating the file size of bundle output
+      const fileSize = (path) => {
+        const { size } = fsLib.statSync(path)
+        const i = Math.floor(Math.log(size) / Math.log(1024))
+        return (size / Math.pow(1024, i)).toFixed(2) * 1 + ['B', 'KB', 'MB', 'GB', 'TB'][i]
+      }
+
+      // Let's loop through all the various outputs
+      // for (const key in result.metafile.outputs) {
+        // const value = result.metafile.outputs[key]
+        // const inputs = Object.keys(value.inputs)
+        // const pathShortener = new RegExp(`^${outputFolder}\\/_bridgetown\\/static\\/`, "g")
+        // const outputPath = key.replace(pathShortener, "")
+
+        // if (value.entryPoint) {
+        //   // We have an entrypoint!
+        //   manifest[stripPrefix(value.entryPoint)] = outputPath
+        //   entrypoints.push([outputPath, fileSize(key)])
+        // } else if (key.match(/index(\.js)?\.[^-.]*\.css/) && inputs.find(item => item.match(/\.(s?css|sass)$/))) {
+        //   // Special treatment for index.css
+        //   manifest[stripPrefix(inputs.find(item => item.match(/\.(s?css|sass)$/)))] = outputPath
+        //   entrypoints.push([outputPath, fileSize(key)])
+        // } else if (inputs.length > 0) {
+        //   // Naive implementation, we'll just grab the first input and hope it's accurate
+        //   manifest[stripPrefix(inputs[0])] = outputPath
+        // }
+      // }
+
+      // const manifestFolder = path.join(process.cwd(), ".bridgetown-cache", "frontend-bundling")
+      // await fs.mkdir(manifestFolder, { recursive: true })
+      // await fs.writeFile(path.join(manifestFolder, "manifest.json"), JSON.stringify(manifest))
+
+      console.log("esbuild: frontend bundling complete!")
+      console.log("esbuild: entrypoints processed:")
+      entrypoints.forEach(entrypoint => {
+        const [entrypointName, entrypointSize] = entrypoint
+        console.log(`         - ${entrypointName}: ${entrypointSize}`)
+      })
+    })
+  }
+})
+
+// Load the PostCSS config from postcss.config.js or whatever else is a supported location/format
+const postcssrc = require("postcss-load-config")
+const postCssConfig = postcssrc.sync()
+
+module.exports = async (outputFolder, esbuildOptions) => {
+  esbuildOptions.plugins = esbuildOptions.plugins || []
+  // Add the PostCSS & glob plugins to the top of the plugin stack
+  esbuildOptions.plugins.unshift(postCssPlugin(postCssConfig, esbuildOptions.postCssPluginConfig || {}))
+  if (esbuildOptions.postCssPluginConfig) delete esbuildOptions.postCssPluginConfig
+  esbuildOptions.plugins.unshift(importGlobPlugin())
+  // Add the Sass plugin
+  esbuildOptions.plugins.push(sassPlugin(esbuildOptions.sassOptions || {}))
+  // Add the Bridgetown preset
+  esbuildOptions.plugins.push(bridgetownPreset(outputFolder))
+
+  // esbuild, take it away!
+  const esbuild = require("esbuild")
+
+  const watch = process.argv.includes("--watch")
+
+  const config = {
+    bundle: true,
+    loader: {
+      ".jpg": "file",
+      ".png": "file",
+      ".gif": "file",
+      ".svg": "file",
+      ".woff": "file",
+      ".woff2": "file",
+      ".ttf": "file",
+      ".eot": "file",
+    },
+    resolveExtensions: [".tsx", ".ts", ".jsx", ".js", ".css", ".scss", ".sass", ".json", ".js.rb"],
+    nodePaths: ["frontend/javascript", "frontend/styles"],
+    minify: process.argv.includes("--minify"),
+    sourcemap: true,
+    target: "es2016",
+    entryPoints: ["frontend/javascript/index.js"],
+    entryNames: "[dir]/[name].[hash]",
+    outdir: path.join(process.cwd(), `${outputFolder}/bridgetown/static`),
+    publicPath: "/bridgetown/static",
+    metafile: true,
+    ...esbuildOptions,
+  }
+
+  if (watch) {
+    const context = await esbuild.context(config).catch(() => process.exit(1))
+    await context.watch().catch(() => process.exit(1))
+  } else {
+    await esbuild.build(config).catch(() => process.exit(1))
+  }
+}

docs/assets/scripts/light-pen/docs/config/initializers.rb

@@ -0,0 +1,20 @@
+Bridgetown.configure do |config|
+  config.url = ENV.fetch("URL", "https://konnorrogers.github.io")
+  config.base_path = ENV.fetch("BASE_PATH", "/light-pen")
+  config.base_url = config.url + config.base_path
+  init :"bridgetown-quick-search"
+
+  # init :ssr
+  # init :"bridgetown-routes"
+  # only :server do
+  #   roda do |app|
+  #     app.plugin :default_headers,
+  #       'Content-Type'=>'text/html',
+  #       'Strict-Transport-Security'=>'max-age=16070400;',
+  #       'X-Content-Type-Options'=>'nosniff',
+  #       'X-Frame-Options'=>'deny',
+  #       'X-XSS-Protection'=>'1; mode=block',
+  #       'Access-Control-Allow-Origin'=>'*'
+  #   end
+  # end
+end

docs/assets/scripts/light-pen/docs/config/puma.rb

@@ -0,0 +1,27 @@
+# Puma is a fast, concurrent web server for Ruby & Rack
+#
+# Learn more at: https://puma.io
+#
+port ENV.fetch("BRIDGETOWN_PORT") { 4000 }
+
+# You can adjust the number of workers (separate processes) and threads
+# (per process) based on your production system
+#
+if ENV["BRIDGETOWN_ENV"] == "production"
+  workers ENV.fetch("BRIDGETOWN_CONCURRENCY") { 4 }
+end
+
+max_threads_count = ENV.fetch("BRIDGETOWN_MAX_THREADS") { 5 }
+min_threads_count = ENV.fetch("BRIDGETOWN_MIN_THREADS") { max_threads_count }
+threads min_threads_count, max_threads_count
+
+# Preload the application for maximum performance
+#
+preload_app!
+
+# Use the Bridgetown logger format
+#
+require "bridgetown-core/rack/logger"
+log_formatter do |msg|
+  Bridgetown::Rack::Logger.message_with_prefix msg
+end

docs/assets/scripts/light-pen/docs/esbuild.config.js

@@ -0,0 +1,57 @@
+// @ts-check
+const { spawn } = require("child_process");
+
+// const glob = require("glob")
+const build = require("./config/esbuild.defaults.js")
+
+const AssetMapper = require("asset-mapper-esbuild").default
+// Update this if you need to configure a destination folder other than `output`
+const outputFolder = "src"
+
+// You can customize this as you wish, perhaps to add new esbuild plugins.
+//
+// ```
+const path = require("path")
+const esbuildCopy = require('esbuild-plugin-copy').default
+// const esbuildOptions = {
+// }
+// ```
+//
+// You can also support custom base_path deployments via changing `publicPath`.
+//
+// ```
+// const esbuildOptions = { publicPath: "/my_subfolder/_bridgetown/static" }
+// ```
+const watch = process.argv.includes("--watch")
+
+const esbuildOptions = {
+  target: "es2020",
+  entryPoints: {
+    "javascript/index": "frontend/javascript/index.js",
+    "javascript/defer": "frontend/javascript/defer.js",
+    "light-pen/exports/light-pen": "../exports/light-pen.js",
+    "light-pen/exports/light-preview": "../exports/light-preview.js",
+  },
+  define: {
+    "process.env.BASE_PATH": `"${process.env.BASE_PATH}"`
+  },
+  publicPath: path.join(process.env.BASE_PATH, "bridgetown", "static"),
+  outdir: path.join(process.cwd(), outputFolder, "bridgetown", "static"),
+  splitting: true,
+  format: "esm",
+  plugins: [
+    esbuildCopy({
+      assets: {
+        from: [path.resolve(__dirname, 'node_modules/@shoelace-style/shoelace/dist/assets/icons/**/*.svg')],
+        to: [path.resolve(__dirname, 'src/shoelace-assets/assets/icons')],
+      },
+      verbose: false
+    }),
+    AssetMapper({
+      manifestFile: path.join(process.cwd(), ".bridgetown-cache", "asset-mapper-manifest.json"),
+      // outputRoot: path.join(process.cwd(), process.env.BASE_PATH)
+    }),
+  ]
+}
+
+build(outputFolder, esbuildOptions)

docs/assets/scripts/light-pen/docs/frontend/javascript/controllers/clipboard_controller.js

@@ -0,0 +1,21 @@
+// @ts-check
+import { Controller } from "@hotwired/stimulus"
+
+export default class ClipboardController extends Controller {
+  connect () {
+    this.element.addEventListener("clipboard-copy", this.showSuccess)
+  }
+
+  showSuccess = () => {
+    this.element.classList.add("clipboard--success")
+    this.element.classList.remove("clipboard--idle")
+    if (this.timeout) {
+      clearTimeout(this.timeout)
+    }
+
+    this.timeout = setTimeout(() => {
+      this.element.classList.remove("clipboard--success")
+      this.element.classList.add("clipboard--idle")
+    }, 2_000)
+  }
+}

docs/assets/scripts/light-pen/docs/frontend/javascript/controllers/example_controller.js

@@ -0,0 +1,6 @@
+import { Controller } from "@hotwired/stimulus"
+export default class extends Controller {
+  connect() {
+    // console.log("Hello, Stimulus!", this.element)
+  }
+}

docs/assets/scripts/light-pen/docs/frontend/javascript/controllers/scroll_spy_controller.js

@@ -0,0 +1,72 @@
+import { Controller } from "@hotwired/stimulus"
+
+export default class ScrollSpyController extends Controller {
+  connect () {
+    this.observer = new IntersectionObserver(this.handleIntersect, { rootMargin: '0px 0px' });
+
+    this.linkMap = new WeakMap();
+    this.visibleSet = new WeakSet();
+
+    this.observeLinks()
+    this.updateActiveLinks()
+
+    this.selector = ["1","2","3","4","5","6"].map((str) => "h" + str + "[id]").join(",")
+    document.querySelectorAll(this.selector).forEach((header) => {
+      this.observer.observe(header);
+    });
+
+    document.addEventListener("turbo:load", this.observeLinks)
+    document.addEventListener("turbo:load", this.updateActiveLinks)
+
+    this.observeLinks()
+    this.updateActiveLinks()
+  }
+
+  disconnect () {
+    this.observer.disconnect()
+  }
+
+  get links () {
+    return [...document.querySelectorAll('#table-of-contents li a')];
+  }
+
+  handleIntersect = (entries) => {
+    entries.forEach(entry => {
+      // Remember which targets are visible
+      if (entry.isIntersecting) {
+        this.visibleSet.add(entry.target);
+      } else {
+        this.visibleSet.delete(entry.target);
+      }
+    });
+
+    this.updateActiveLinks();
+  }
+
+  updateActiveLinks = () => {
+    const links = this.links;
+    // Find the first visible target and activate the respective link
+    links.find(link => {
+      const target = this.linkMap.get(link);
+
+      if (target && this.visibleSet.has(target)) {
+        links.forEach(el => el.parentElement.classList.toggle('is-active', el === link));
+        return true;
+      }
+
+      return false;
+    });
+  }
+
+  observeLinks = () => {
+    this.links.forEach(link => {
+      const hash = link.hash.slice(1);
+      const target = hash ? document.querySelector(`main #${hash}`) : null;
+
+      if (target) {
+        this.linkMap.set(link, target);
+        this.observer.observe(target);
+      }
+    });
+  }
+}

docs/assets/scripts/light-pen/docs/frontend/javascript/controllers/search_controller.js

@@ -0,0 +1,6 @@
+import { Controller } from "@hotwired/stimulus"
+export default class SearchController extends Controller {
+  show () {
+    document.querySelector("bridgetown-ninja-keys").open()
+  }
+}

docs/assets/scripts/light-pen/docs/frontend/javascript/controllers/side_nav_controller.js

@@ -0,0 +1,39 @@
+import { Controller } from "@hotwired/stimulus"
+
+export default class SideNavController extends Controller {
+  async open() {
+    document.addEventListener("sl-hide", this.reset)
+    this.drawer.removeAttribute("hidden")
+
+    this.scrollTop = window.scrollY;
+    document.body.classList.add('fixed-body');
+    // Scroll the wrapper, rather than setting an offset
+    // via `top` or `transform`.
+    document.body.scroll(0, this.scrollTop);
+    await this.drawer.show()
+  }
+
+  reset = () => {
+    window.scrollTo(0, this.scrollTop);
+    document.body.classList.remove('fixed-body');
+  }
+
+  async close () {
+    document.removeEventListener("sl-hide", this.reset)
+    this.reset()
+    await this.drawer.hide()
+  }
+
+  async toggle() {
+    if (this.drawer.open) {
+      await this.open()
+    } else {
+      await this.close()
+    }
+  }
+
+  get drawer() {
+    return document.querySelector("#side-nav-drawer")
+  }
+}
+

docs/assets/scripts/light-pen/docs/frontend/javascript/controllers/theme_switcher_controller.js

@@ -0,0 +1,58 @@
+import { Controller } from "@hotwired/stimulus"
+
+
+export default class ThemeSwitcher extends Controller {
+  constructor (...args) {
+    super(...args)
+
+    this.handleSelect = (e) => {
+      window.applyTheme(e.detail.item.value)
+    }
+
+    this.handleShortcut = (event) => {
+      if (
+        event.key === '\\' &&
+        !event.composedPath().some(el => {
+          return (
+            ['input', 'textarea'].includes(el?.tagName?.toLowerCase()) ||
+            el.hasAttribute?.("contenteditable") ||
+            el.getAttribute?.("role") === "textbox"
+          )
+        })
+      ) {
+        event.preventDefault();
+
+        window.applyTheme(window.themeIsDark() ? 'light' : 'dark');
+      }
+    }
+
+    this.setLight = () => {
+      window.applyTheme("light")
+    }
+
+    this.setDark = () => {
+      window.applyTheme("dark")
+    }
+
+    // Set the initial theme and sync the UI
+    window.applyTheme(window.getTheme());
+  }
+
+  connect () {
+    this.element.addEventListener("sl-select", this.handleSelect)
+    document.addEventListener("keydown", this.handleShortcut)
+
+    // Update the theme when the preference changes
+    window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', this.setDark);
+    window.matchMedia('(prefers-color-scheme: light)').addEventListener('change', this.setLight);
+
+    // Set the initial theme and sync the UI
+    window.applyTheme(window.getTheme());
+  }
+
+  disconnect () {
+    this.element.removeEventListener("sl-select", this.handleSelect)
+    document.removeEventListener("keydown", this.handleShortcut)
+  }
+
+}

docs/assets/scripts/light-pen/docs/frontend/javascript/defer.js

@@ -0,0 +1,87 @@
+import "../styles/defer.css"
+import { BridgetownNinjaKeys } from "@konnorr/bridgetown-quick-search/ninja-keys.js"
+
+;(window.requestIdleCallback || window.setTimeout)(async () => {
+  // const { BridgetownNinjaKeys } = await import("@konnorr/bridgetown-quick-search/ninja-keys.js")
+
+  /** @type {import("konnors-ninja-keys").INinjaAction[]} */
+  const staticData = [
+    {
+      id: "theme-light",
+      icon: "<sl-icon name='sun'></sl-icon>",
+      title: "Light Mode",
+      section: "Theme",
+      keywords: "theme",
+      handler () {
+        window.applyTheme("light");
+        return {keepOpen: true}
+      }
+    },
+    {
+      id: "theme-dark",
+      icon: "<sl-icon name='moon'></sl-icon>",
+      title: "Dark Mode",
+      section: "Theme",
+      keywords: "theme",
+      handler () {
+        window.applyTheme("dark");
+        return {keepOpen: true}
+      }
+    },
+    {
+      id: "theme-system",
+      icon: "<sl-icon name='display'></sl-icon>",
+      title: "System",
+      section: "Theme",
+      keywords: "theme",
+      handler () {
+        window.applyTheme("system");
+        return {keepOpen: true}
+      }
+    },
+  ]
+
+  ;(class extends BridgetownNinjaKeys {
+    constructor (...args) {
+      super(...args)
+      this.staticData = staticData
+    }
+
+    createData() {
+      this.results = this.showResultsForQuery(this._search || "*").reverse()
+
+      this.results.forEach((result) => {
+        result.icon = `<sl-icon name="link-45deg"></sl-icon>`
+      })
+
+      return [
+        ...this.staticData,
+        ...this.results,
+      ]
+    }
+
+    open () {
+      this.scrollTop = window.scrollY;
+      document.body.classList.add('fixed-body');
+      // Scroll the wrapper, rather than setting an offset
+      // via `top` or `transform`.
+      document.body.scroll(0, this.scrollTop);
+
+      this.nonModals.forEach((el) => {
+        el.setAttribute("inert", "")
+      })
+      super.open()
+    }
+
+    close () {
+      document.body.classList.remove('fixed-body');
+      window.scrollTo(0, this.scrollTop);
+      super.close()
+      this.nonModals.forEach((el) => el.removeAttribute("inert"))
+    }
+
+    get nonModals () {
+      return [...document.body.children].filter((el) => el.localName !== "bridgetown-ninja-keys")
+    }
+  }).define("bridgetown-ninja-keys")
+})

docs/assets/scripts/light-pen/docs/frontend/javascript/index.js

@@ -0,0 +1,61 @@
+import "../styles/index.css"
+import { Application } from "@hotwired/stimulus"
+
+// Shoelace
+import { setBasePath } from "@shoelace-style/shoelace/dist/utilities/base-path.js";
+
+import LazyLoader from "./src/lazy-loader.js"
+
+import * as Turbo from "@hotwired/turbo"
+window.Turbo = Turbo
+import "./src/layout.js"
+//
+LazyLoader()
+//
+setBasePath(process.env.BASE_PATH + "/shoelace-assets")
+
+// Import all JavaScript & CSS files from src/_components
+import components from "bridgetownComponents/**/*.{js,jsx,js.rb,css}"
+
+window.Stimulus = Application.start()
+
+import controllers from "./controllers/**/*.{js,js.rb}"
+Object.entries(controllers).forEach(([filename, controller]) => {
+  if (filename.includes("_controller.") || filename.includes("-controller.")) {
+    const identifier = filename.replace("./controllers/", "")
+      .replace(/[_-]controller..*$/, "")
+      .replace("_", "-")
+      .replace("/", "--")
+
+    Stimulus.register(identifier, controller.default)
+  }
+})
+
+;(() => {
+  if (!window.scrollPositions) {
+    window.scrollPositions = {};
+  }
+
+  function preserveScroll() {
+    document.querySelectorAll('[data-preserve-scroll').forEach(element => {
+      scrollPositions[element.id] = element.scrollTop;
+    });
+  }
+
+  function restoreScroll(event) {
+    if (event.detail && event.detail.newBody) {
+      event.detail.newBody.querySelectorAll('[data-preserve-scroll]').forEach(element => {
+        element.scrollTop = scrollPositions[element.id];
+      });
+    }
+
+    document.querySelectorAll('[data-preserve-scroll').forEach(element => {
+      element.scrollTop = scrollPositions[element.id];
+    });
+
+  }
+
+  window.addEventListener('turbo:before-cache', preserveScroll);
+  window.addEventListener('turbo:before-render', restoreScroll);
+  window.addEventListener('turbo:render', restoreScroll);
+})();

docs/assets/scripts/light-pen/docs/frontend/javascript/src/external-icon.js

@@ -0,0 +1,10 @@
+class ExternalIcon extends HTMLElement {
+  connectedCallback () {
+    this.attachShadow({ mode: "open" })
+    this.shadowRoot.innerHTML = `<sl-icon name="box-arrow-up-right"></sl-icon><sl-visually-hidden>Opens in new window</sl-visually-hidden>`
+  }
+}
+
+if (!window.customElements.get("external-icon")) {
+  window.customElements.define("external-icon", ExternalIcon)
+}

docs/assets/scripts/light-pen/docs/frontend/javascript/src/layout.js

@@ -0,0 +1,211 @@
+import {LitElement, html, css} from "lit"
+
+class KrLayout extends LitElement {
+  static styles = css`
+    :host {
+      display: block;
+      box-sizing: border-box;
+      min-height: var(--height);
+      --height: 100vh;
+      --height: 100dvh;
+
+      --menu-width: auto;
+      --main-width: 1fr;
+      --aside-width: auto;
+
+      /** This is a best guess. We'll attempt to calculate this with a resize observer. **/
+      --header-height: 68.33px;
+    }
+
+    :host([variant="documentation"]) {
+      --menu-width: 250px;
+      --main-width: 105ch;
+      --aside-width: auto;
+    }
+
+    :host([variant="documentation"])::part(body) {
+      justify-content: center;
+    }
+
+    *, *:after, *:before {
+      box-sizing: border-box;;
+    }
+
+    [part~="base"] {
+      display: grid;
+      /** Header, Main, Footer **/
+      grid-template-rows: minmax(0, auto) minmax(0, 1fr) minmax(0, auto);
+      min-height: var(--height);
+    }
+
+    [part~="header"] {
+      max-width: 100%;
+      position: sticky;
+      background: white;
+      z-index: 2;
+    }
+
+    :is(.header, .aside, .menu, .footer) ::slotted(*) {
+      height: 100%;
+    }
+
+    :is(.aside, .menu) ::slotted(*) {
+      min-width: 100%;
+      width: 100%;
+      max-width: 100%;
+    }
+
+    [part~="header"] {
+      top: 0px;
+    }
+
+    [part~="body"] {
+      display: grid;
+      /** Menu, Main, Aside **/
+      grid-template-columns: minmax(0, var(--menu-width)) minmax(0, var(--main-width)) minmax(0, var(--aside-width));
+      grid-template-rows: minmax(0, 1fr);
+    }
+
+    [part~="aside"],
+    [part~="menu"] {
+      display: grid;
+      grid-template-columns: minmax(0, 1fr);
+      max-height: calc(var(--height) - var(--header-height));
+      overflow: auto;
+      position: sticky;
+      top: var(--header-height);
+      overscroll-behavior: contain;
+    }
+
+    [part~="main"] {
+      position: relative;
+      display: grid;
+      grid-template-columns: minmax(0, 1fr);
+      /* main-header, main, main-footer */
+      grid-template-rows: minmax(0, auto) minmax(0, 1fr) minmax(0, auto);
+    }
+
+    [part~="footer"] {}
+
+    sl-visually-hidden:not(:focus-within) {
+      position: absolute !important;
+      width: 1px !important;
+      height: 1px !important;
+      clip: rect(0 0 0 0) !important;
+      clip-path: inset(50%) !important;
+      border: none !important;
+      overflow: hidden !important;
+      white-space: nowrap !important;
+      padding: 0 !important;
+    }
+
+    .skip-links {
+      position: absolute;
+      top: 0;
+      left: 0;
+      height: calc(var(--header-height, 48px) - 2px);
+      width: 100vw;
+      z-index: 4;
+      background-color: inherit;
+      display: grid;
+      grid-template-columns: minmax(0, 1fr);
+      place-items: center;
+      text-align: center;
+    }
+  `
+
+  static properties = {
+    main_id: { attribute: "main-id", reflect: true }
+  }
+
+  constructor () {
+    super()
+    this.main_id = "main"
+  }
+
+  createResizeObserver (slot) {
+    return new ResizeObserver((entries) => {
+      for (const entry of entries) {
+        if (entry.contentBoxSize) {
+          const contentBoxSize = entry.borderBoxSize[0];
+          this.style.setProperty(`--${slot}-height`, `${contentBoxSize.blockSize}px`)
+        }
+      }
+    })
+  }
+
+  connectedCallback () {
+    super.connectedCallback?.()
+
+    this.headerResizeObserver = this.createResizeObserver("header");
+    this.footerResizeObserver = this.createResizeObserver("footer");
+
+    setTimeout(() => {
+      this.header = this.shadowRoot.querySelector("[part~='header']")
+      this.headerResizeObserver.observe(this.header)
+
+      // this.footer = this.shadowRoot.querySelector("[part~='main-footer']")
+      // this.footerResizeObserver.observe(this.footer)
+    })
+  }
+
+  disconnectedCallback () {
+    super.disconnectedCallback?.()
+    this.headerResizeObserver.unobserve(this.header)
+    // this.footerResizeObserver.unobserve(this.footer)
+  }
+
+  render () {
+    return html`
+      <sl-visually-hidden class="skip-links" part="skip-links">
+        <slot name="skip-links">
+          <a href=${`#${this.main_id}`} part="skip-link">
+            ${this.skipToMain || "Skip to main"}
+          </a>
+        </slot>
+      </sl-visually-hidden>
+
+      <div class="base" part="base">
+        <div class="header" part="header">
+          <slot name="header"></slot>
+        </div>
+
+        <div class="body" part="body">
+          <div class="menu" part="menu">
+            <slot name="menu"></slot>
+          </div>
+
+          <div class="main" part="main">
+            <div class="main-header" part="main-header">
+              <slot name="main-header"></slot>
+            </div>
+
+            <div class="main-content" part="main-content"><slot></slot></div>
+
+            <div class="main-footer" part="main-footer">
+              <slot name="main-footer"></slot>
+            </div>
+          </div>
+
+          <div class="aside" part="aside">
+            <slot name="aside"></slot>
+          </div>
+        </div>
+
+        <div class="footer" part="footer">
+          <slot name="footer"></slot>
+        </div>
+      </div>
+
+      <div part="dialog" class="dialog">
+        <slot name="dialog"></slot>
+      </div>
+    `
+  }
+}
+
+if (!window.customElements.get("kr-layout")) {
+window.customElements.define("kr-layout", KrLayout)
+}
+
+

docs/assets/scripts/light-pen/docs/frontend/javascript/src/lazy-loader.js

@@ -0,0 +1,101 @@
+import LazyLoader from "web-component-lazy-loader";
+
+export default function lazyLoader() {
+  return new LazyLoader({
+    components: {
+      "light-pen": {
+        register () {
+          import("light-pen/exports/light-pen-register.js")
+        }
+      },
+      "light-preview": {
+        register () {
+          import("light-pen/exports/light-preview-register.js")
+        }
+      },
+      "clipboard-copy": {
+        register() {
+          import("@github/clipboard-copy-element");
+        },
+      },
+      "external-icon": {
+        register() {
+          import("./external-icon.js");
+        },
+      },
+
+      // Shoelace
+      "sl-alert": {
+        register() {
+          import("@shoelace-style/shoelace/dist/components/alert/alert.js");
+        },
+      },
+      // "sl-breadcrumb": {
+      // register () { import("@shoelace-style/shoelace/dist/components/breadcrumb/breadcrumb.js"); }
+      // },
+      // "sl-breadcrumb-item": {
+      // register () { import("@shoelace-style/shoelace/dist/components/breadcrumb-item/breadcrumb-item.js"); }
+      // },
+      "sl-button": {
+        register() {
+          import("@shoelace-style/shoelace/dist/components/button/button.js");
+        },
+      },
+      "sl-divider": {
+        register() {
+          import("@shoelace-style/shoelace/dist/components/divider/divider.js");
+        },
+      },
+      "sl-drawer": {
+        register() {
+          import("@shoelace-style/shoelace/dist/components/drawer/drawer.js");
+        },
+      },
+      "sl-dropdown": {
+        register() {
+          import(
+            "@shoelace-style/shoelace/dist/components/dropdown/dropdown.js"
+          );
+        },
+      },
+      "sl-icon": {
+        register() {
+          import("@shoelace-style/shoelace/dist/components/icon/icon.js");
+        },
+      },
+      "sl-icon-button": {
+        register() {
+          import(
+            "@shoelace-style/shoelace/dist/components/icon-button/icon-button.js"
+          );
+        },
+      },
+      "sl-menu": {
+        register() {
+          import("@shoelace-style/shoelace/dist/components/menu/menu.js");
+        },
+      },
+      "sl-menu-item": {
+        register() {
+          import(
+            "@shoelace-style/shoelace/dist/components/menu-item/menu-item.js"
+          );
+        },
+      },
+      "sl-menu-label": {
+        register() {
+          import(
+            "@shoelace-style/shoelace/dist/components/menu-label/menu-label.js"
+          );
+        },
+      },
+      "sl-visually-hidden": {
+        register() {
+          import(
+            "@shoelace-style/shoelace/dist/components/visually-hidden/visually-hidden.js"
+          );
+        },
+      },
+    },
+  }).start();
+}

docs/assets/scripts/light-pen/docs/frontend/styles/_components.css

@@ -0,0 +1,24 @@
+@import "./components/_alert.css";
+@import "./components/_aspect_ratio.css";
+@import "./components/_blog.css";
+@import "./components/_button.css";
+@import "./components/_call_to_action.css";
+@import "./components/_clipboard.css";
+@import "./components/_contact.css";
+@import "./components/_footer.css";
+@import "./components/_header.css";
+@import "./components/_hero.css";
+@import "./components/_input.css";
+@import "./components/_layout.css";
+@import "./components/_list.css";
+@import "./components/_link.css";
+@import "./components/_logo.css";
+@import "./components/_main_list.css";
+@import "./components/_pagination.css";
+@import "./components/_side_nav.css";
+@import "./components/_syntax_block.css";
+@import "./components/_table_of_contents.css";
+@import "./components/_text.css";
+@import "./components/_theme_switcher.css";
+@import "./components/_top_nav.css";
+@import "./components/_tables.css";

docs/assets/scripts/light-pen/docs/frontend/styles/_content.css

@@ -0,0 +1,42 @@
+/** For for prose sections, blogging concerns, Markdown, etc. */
+
+/** Pretty syntax blocks */
+pre.highlight {
+  padding: 0.85rem 1rem;
+  margin: 0;
+  overflow-x: auto;
+}
+
+code
+.highlighter-rouge,
+.highlight {
+  border-radius: 8px;
+  font-size: 0.85rem;
+  line-height: 1.4;
+  font-family: var(--sl-font-mono);
+}
+
+code,
+.highlight,
+.highlighter-rouge {
+  position: relative;
+}
+
+/* Inline code blocks */
+code,
+code.highlight,
+code.highlighter-rouge {
+  /** Layout */
+  display: inline-block;
+  font-size: 0.85em;
+  padding: 0.1em 0.4em;
+  margin: 4px 0;
+  border-radius: 6px;
+  white-space: break-spaces;
+  vertical-align: middle;
+
+  /* Decoration */
+  background-color: var(--code-background-color);
+  color: var(--code-color);
+}
+

docs/assets/scripts/light-pen/docs/frontend/styles/_normalize.css

@@ -0,0 +1,195 @@
+html {
+  box-sizing: border-box;
+  height: 100%;
+}
+
+*, *:before, *:after {
+  box-sizing: border-box;
+}
+
+body {
+  max-width: 100%;
+  line-height: 1.5;
+  -webkit-font-smoothing: antialiased;
+  text-rendering: optimizeSpeed;
+  scrollbar-gutter: stable;
+  font-family: var(--sl-font-sans);
+	background-color: var(--body-color);
+	color: var(--text-color);
+	display: grid;
+	grid-template-rows: minmax(0, 1fr);
+  min-height: 100%;
+  margin: 0;
+  padding: 0;
+}
+
+[hidden] {
+  display: none !important;
+}
+
+img, picture, video, canvas, svg {
+  display: block;
+  max-width: 100%;
+}
+
+input, button, textarea, select {
+  font: inherit;
+}
+
+p, h1, h2, h3, h4, h5, h6 {
+  overflow-wrap: break-word;
+}
+
+body {
+  font-family: var(--sl-font-sans);
+  min-height: 100%;
+}
+
+button {
+  appearance: none;
+  border: none;
+  background: none;
+}
+
+button:hover {
+  cursor: pointer;
+}
+
+h1,h2,h3,h4,h5,h6 {
+  scroll-margin-top: calc(80px + 2em);
+  margin: 0;
+  padding: 0;
+  margin-top: var(--sl-spacing-large);
+  margin-bottom: var(--sl-spacing-small);
+}
+
+main p {
+  font-size: 1rem;
+}
+
+h1 {
+  font-size: 1.25rem;
+  margin: 0;
+  margin-top: 1rem;
+  margin-bottom: 1rem;
+}
+
+h2 {
+  font-size: 1.15rem;
+}
+
+h3, h4 {
+  font-size: 1.1rem;
+}
+
+h5, h6 {
+  font-size: 1.05rem;
+}
+
+p {
+  margin-top: 0.5em;
+  margin-bottom: 0.5em;
+  padding: 0;
+  font-size: 1rem;
+}
+
+p, li {
+  line-height: 1.5;
+}
+
+li {
+  font-size: 1rem;
+}
+
+ul {
+  line-height: 1.8;
+  list-style: disc outside;
+}
+
+ul ul {
+  list-style: circle outside;
+}
+
+ul ul ul {
+  list-style: square outside;
+}
+
+ul ul ul ul {
+  list-style: disc outside;
+}
+
+[tabindex="-1"] {
+  outline: transparent;
+}
+
+a,
+kr-layout::part(skip-link) {
+  word-wrap: anywhere;
+  /* outline: transparent; */
+  /* Unable to distinguish identifier, this makes links obvious */
+  text-decoration-line: underline;
+  text-decoration-style: solid;
+  text-decoration-color: var(--link-color);
+  text-underline-offset: 0.25em;
+  color: var(--link-color);
+  border-radius: 2px;
+  display: inline;
+  padding: 0.25em;
+  margin: -0.25em;
+  line-height: 1.2;
+  transition: all 0.2s;
+}
+
+kr-layout::part(skip-link):is(:hover),
+a:is(:hover) {
+  color: var(--link-color-focus);
+}
+
+
+kr-layout::part(skip-link):is(:focus-visible),
+a:is(:focus-visible) {
+  box-shadow: 0px 0px 3px 3px var(--sl-color-primary-600);
+  outline: transparent;
+  /* for when Safari supports border-radius */
+  /* outline: 3px solid var(--sl-color-primary-600); */
+  /* outline-offset: 4px; */
+}
+
+@supports not selector(:focus-visible) {
+  kr-layout::part(skip-link):is(:focus),
+  a:is(:focus) {
+    box-shadow: 0px 0px 3px 3px var(--sl-color-primary-600);
+    outline: transparent;
+    /* for when Safari supports border-radius */
+    /* outline: 3px solid var(--sl-color-primary-600); */
+    /* outline-offset: 4px; */
+  }
+}
+
+code > span {
+  line-height: var(--sl-line-height-dense);
+}
+
+kbd {
+  font-family: var(--sl-font-mono);
+  font-size: 87.5%;
+  background-color: var(--sl-color-neutral-50);
+  border-radius: 4px;
+  border: solid 1px var(--sl-color-neutral-200);
+  box-shadow: inset 0 1px 0 var(--sl-color-neutral-0);
+  padding: 2px 5px;
+  line-height: 1;
+}
+
+a external-icon {
+  padding-top: 0.25em;
+  font-size: 0.75em;
+  margin-inline-start: -0.15em;
+}
+
+blockquote {
+  border-inline-start: 4px solid var(--divider-color);
+  margin-inline-start: 0.5rem;
+  padding: 0.75rem;
+  background-color: var(--sl-color-neutral-50);
+}

docs/assets/scripts/light-pen/docs/frontend/styles/_overrides.css

@@ -0,0 +1,2 @@
+@import "./overrides/bridgetown-ninja-keys.css";
+@import "./overrides/shoelace.css";

docs/assets/scripts/light-pen/docs/frontend/styles/components/_alert.css

@@ -0,0 +1,13 @@
+sl-alert {
+  margin: 1rem 0;
+}
+
+sl-alert p {
+  margin: 0;
+  padding: 0;
+}
+
+sl-alert::part(base) {
+  box-shadow: 3px 3px 6px 1px var(--sl-color-neutral-100);
+}
+

docs/assets/scripts/light-pen/docs/frontend/styles/components/_aspect_ratio.css

@@ -0,0 +1,22 @@
+[style*="--aspect-ratio"] > :first-child {
+  width: 100%;
+}
+[style*="--aspect-ratio"] > img {
+  height: auto;
+}
+
+[style*="--aspect-ratio"] {
+  position: relative;
+}
+[style*="--aspect-ratio"]::before {
+  content: "";
+  display: block;
+  padding-bottom: calc(100% / (var(--aspect-ratio)));
+}
+[style*="--aspect-ratio"] > :first-child {
+  position: absolute;
+  top: 0;
+  left: 0;
+  height: 100%;
+}
+

docs/assets/scripts/light-pen/docs/frontend/styles/components/_blog.css

@@ -0,0 +1,31 @@
+.blog-link:focus {
+  box-shadow: none;
+}
+
+.blog-link:focus .blog-link__card::part(base) {
+  box-shadow: 0px 0px 4px 1px var(--sl-color-primary-700);
+}
+
+.blog-link__card::part(base) {
+  transform: translateY(0px);
+  transition: transform 0.5s ease-in-out;
+}
+
+.blog-link:is(:focus, :hover) .blog-link__card::part(base) {
+  transform: translateY(-3px);
+}
+
+.blog-link,
+.blog-link:focus {
+  color: var(--sl-color-neutral-700);
+}
+
+.blog-link:is(:hover) {
+  color: var(--sl-color-primary-900);
+}
+
+.blog-link:is(:hover) .blog-link__card::part(base) {
+  border: 1px solid var(--sl-color-primary-700);
+  background-color: var(--sl-color-primary-50);
+}
+

docs/assets/scripts/light-pen/docs/frontend/styles/components/_button.css

@@ -0,0 +1,52 @@
+/** Button */
+.button {
+  padding: 0.4em 0.6em;
+  display: block;
+  position: relative;
+  width: auto;
+  cursor: pointer;
+
+  display: inline-flex;
+  align-items: stretch;
+  justify-content: center;
+  border-style: solid;
+  border-width: var(--sl-input-border-width);
+  font-family: var(--sl-input-font-family);
+  font-weight: var(--sl-font-weight-semibold);
+  user-select: none;
+  white-space: nowrap;
+  transition: var(--sl-transition-x-fast) background-color, var(--sl-transition-x-fast) color,
+    var(--sl-transition-x-fast) border, var(--sl-transition-x-fast) box-shadow;
+  background-color: var(--sl-color-neutral-0);
+  border-color: var(--sl-color-neutral-300);
+  color: var(--sl-color-neutral-700);
+  font-size: var(--sl-button-font-size-medium);
+  border-radius: var(--sl-input-border-radius-medium);
+}
+
+.button::-moz-focus-inner {
+  border: 0;
+}
+
+.button:focus {
+  outline: transparent;
+}
+
+.button:focus-visible {
+  outline: var(--sl-focus-ring);
+  outline-offset: var(--sl-focus-ring-offset);
+
+}
+
+.button:hover {
+  background-color: var(--sl-color-primary-50);
+  border-color: var(--sl-color-primary-300);
+  color: var(--sl-color-primary-700);
+}
+
+.button:active {
+  background-color: var(--sl-color-primary-100);
+  border-color: var(--sl-color-primary-400);
+  color: var(--sl-color-primary-700);
+}
+

docs/assets/scripts/light-pen/docs/frontend/styles/components/_call_to_action.css

@@ -0,0 +1,24 @@
+.call-to-action__items {
+  margin-top: 1.75rem;
+  margin-bottom: 3rem;
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: center;
+  gap: 0.5rem;
+  padding: 0;
+}
+
+.reason__grid {
+  display: grid;
+  gap: 1rem;
+}
+
+.reason__grid > * {
+  height: 100%;
+}
+
+@media screen and (min-width: 1024px) {
+  .reason__grid {
+    grid-template-columns: repeat(3, 1fr);
+  }
+}

docs/assets/scripts/light-pen/docs/frontend/styles/components/_clipboard.css

@@ -0,0 +1,33 @@
+/** Clipboard **/
+.clipboard.clipboard--success:is(:hover, :focus, :active),
+.clipboard.clipboard--success {
+  background-color: var(--sl-color-success-100);
+  border-color: var(--sl-color-success-600);
+  color: var(--sl-color-success-800);
+}
+
+.clipboard {
+  align-items: center;
+}
+
+.clipboard sl-icon {
+  font-size: 1rem;
+}
+
+.clipboard__icon--success, .clipboard__icon--idle {
+  transition: transform .2s ease-in-out;
+}
+
+.clipboard .clipboard__icon--idle,
+.clipboard.clipboard--success .clipboard__icon--success {
+  transform: scale(1);
+}
+
+.clipboard.clipboard--success .clipboard__icon--idle,
+.clipboard.clipboard--idle .clipboard__icon--success {
+  height: 0;
+  width: 0;
+  visibility: hidden;
+  transform: scale(0);
+}
+

docs/assets/scripts/light-pen/docs/frontend/styles/components/_contact.css

@@ -0,0 +1,6 @@
+.contact__title {
+  line-height: 1.3;
+  font-size: 1.25rem;
+  margin-bottom: 0;
+}
+

docs/assets/scripts/light-pen/docs/frontend/styles/components/_footer.css

@@ -0,0 +1,7 @@
+.footer {
+  width: 100%;
+  margin-top: auto;
+  padding: var(--sl-spacing-large) var(--sl-spacing-2x-small);
+  text-align: center;
+  background-color: var(--sl-color-neutral-50);
+}

docs/assets/scripts/light-pen/docs/frontend/styles/components/_header.css

@@ -0,0 +1,11 @@
+.nav-header {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr);
+  padding: 0.5rem;
+  padding-inline-end: 1.5rem;
+  font-size: 1.05em;
+  justify-items: space-between;
+  border-bottom: 1px solid var(--sl-color-neutral-200);
+	background-color: var(--body-color);
+  min-height: var(--header-height);
+}

docs/assets/scripts/light-pen/docs/frontend/styles/components/_hero.css

@@ -0,0 +1,30 @@
+.hero {
+  margin: 0 auto;
+  padding: 16px;
+  max-width: 600px;
+}
+
+.hero--mobile {
+  display: flex;
+  margin-top: 1rem;
+  margin-bottom: 1rem;
+}
+
+.hero--mobile a {
+  display: flex;
+  justify-content: center;
+  margin: 0 auto;
+  width: auto;
+  flex: 0 0 auto;
+}
+
+.hero--mobile .logo__text{
+  font-size: 2.5rem;
+}
+
+.hero__caption {
+  font-size: 0.85em;
+  margin-top: 6px;
+  border-inline-start: 4px solid var(--divider-color);
+  padding-inline-start: 8px;
+}

docs/assets/scripts/light-pen/docs/frontend/styles/components/_input.css

@@ -0,0 +1,28 @@
+.input {
+  font-size: var(--input-font-size);
+  font-family: inherit;
+  padding: var(--input-padding);
+  background-color: var(--input-bg-color);
+  border: var(--input-border-width) var(--input-border-style) var(--input-border-color);
+  border-radius: var(--input-border-radius);
+  height: var(--sl-spacing-2x-large);
+  color: var(--sl-color-neutral-700);
+}
+
+.input {
+  transition: 150ms box-shadow ease-in-out;
+}
+
+.input:focus,
+.input:hover {
+  border-color: var(--sl-color-primary-500);
+}
+
+.input:focus {
+  box-shadow: 0 0 0 var(--input-focus-ring-width)
+    hsla(198.6 88.7% 48.4% / 0.4);
+
+  /* for users who may have shadows and other colors turned off */
+  outline: var(--input-focus-ring-width) solid transparent;
+}
+

docs/assets/scripts/light-pen/docs/frontend/styles/components/_layout.css

@@ -0,0 +1,103 @@
+:is(.index, .doc, .page, .post) kr-layout {
+  background-color: var(--sl-color-neutral-50);
+}
+
+/* .documentation-content {} */
+
+body:is(.index, .doc, .page, .post) kr-layout::part(main-content) {
+	background: var(--body-color);
+}
+
+kr-layout > [slot='aside'] {
+  display: none;
+}
+
+/* Janky hack for iOS mobile */
+.fixed-body {
+  position: fixed;
+  height: var(--viewport-height, 100%);
+  width: 100%;
+  /* Allow the main content to be scrolled,
+  so we can adjust the scroll position with JS. */
+  overflow: auto;
+}
+
+body:is(.default, .home) kr-layout {
+  --menu-width: 0px;
+  --main-width: 1fr;
+  --aside-width: 0px;
+}
+
+kr-layout {
+  --menu-width: auto;
+  --main-width: 105ch;
+  --aside-width: auto;
+}
+
+kr-layout,
+kr-layout::part(skip-links) {
+  background-color: var(--body-color);
+}
+
+kr-layout::part(body) {
+  max-width: 100%;
+  justify-content: center;
+  margin: 0 auto;
+}
+
+kr-layout::part(main) {
+  background-color: var(--body-color);
+}
+
+main {
+	max-width: 100%;
+	padding: 0 var(--main-padding-x) 2rem;
+	width: 100%;
+	margin: 0 auto;
+	background-color: var(--body-color);
+	color: var(--text-color);
+}
+
+:is(.default, .home) main {
+  max-width: var(--main-width);
+}
+
+:is(.default, .home) .footer {
+  width: 100vw;
+}
+
+:is(.doc, .index, .page, .post) main {
+	background-color: var(--body-color);
+}
+
+
+@media screen and (min-width: 1360px) {
+  kr-layout > [slot='aside'] {
+    display: block;
+  }
+}
+
+@media screen and (min-width: 1024px) {
+  body:is(.index, .doc, .page, .post) kr-layout::part(main),
+  body:is(.index, .doc, .page, .post) kr-layout::part(menu),
+  body:is(.index, .doc, .page, .post) kr-layout::part(aside) {
+    padding-top: 2rem;
+  }
+
+  .documentation-content {
+    border-radius: 32px;
+  }
+
+	body:is(.index, .doc, .page, .post) kr-layout::part(main) {
+	  background-color: transparent;
+	  margin-inline-end: 16px;
+	  margin-inline-start: 16px;
+
+	}
+
+	body:is(.index, .doc, .page, .post) kr-layout::part(main-content) {
+		box-shadow: 0 0 5px 0 rgb(0 0 0 / 10%);
+		background: var(--body-color);
+		border-radius: 32px;
+	}
+}

docs/assets/scripts/light-pen/docs/frontend/styles/components/_link.css

@@ -0,0 +1,47 @@
+.logo__link {
+  display: flex;
+  flex: 1 0 auto;
+  width: auto;
+  align-items: center;
+}
+
+.logo__link:is(:focus, :hover) {
+  text-decoration-line: underline;
+  text-decoration-style: solid;
+  text-decoration-color: var(--link-color);
+  color: var(--link-color-focus);
+}
+
+.logo__link:is(:focus, :hover) * {
+  color: var(--link-color-focus);
+}
+
+.blog-link__header,
+.contact__link,
+.main-list__link,
+.side-nav__link,
+.nav-link {
+  font-weight: bold;
+  color: var(--sl-color-neutral-800);
+  text-decoration-line: underline;
+  text-decoration-style: solid;
+  text-decoration-color: var(--sl-color-primary-500);
+  text-underline-offset: 0.3em;
+}
+
+.link__flex {
+  display: inline-flex;
+  gap: 0.25em;
+  align-items: center;
+  cursor: pointer;
+  max-width: max-content;
+}
+
+.link--small {
+  font-size: 0.85em;
+}
+
+.link--large {
+  font-size: 1em;
+}
+

docs/assets/scripts/light-pen/docs/frontend/styles/components/_list.css

@@ -0,0 +1,3 @@
+ul.list li {
+  line-height: 2.5;
+}

docs/assets/scripts/light-pen/docs/frontend/styles/components/_main_list.css

@@ -0,0 +1,21 @@
+.main-list {
+  padding: 0;
+  list-style: none;
+  display: grid;
+  gap: 8px;
+}
+
+.main-list__item {
+  padding: 8px;
+  max-width: 100%;
+  line-height: 1.3;
+  font-size: 1.25rem;
+  text-align: center;
+}
+
+@media screen and (min-width: 400px) {
+  .main-list {
+    grid-auto-flow: column;
+  }
+}
+

docs/assets/scripts/light-pen/docs/frontend/styles/components/_pagination.css

@@ -0,0 +1,44 @@
+/** Pagination */
+sl-button:is(.previous-page, .next-page) {
+  transition: transform 0.15s;
+}
+
+sl-button:is(.previous-page, .next-page)::part(label) {
+  max-width: calc(100% - 24px);
+  width: 100%;
+  overflow: hidden;
+}
+
+sl-button:is(.next-page)::part(base) {
+  justify-content: start;
+  justify-content: flex-start;
+}
+
+sl-button:is(.previous-page)::part(base) {
+  justify-content: end;
+  justify-content: flex-end;
+}
+
+sl-button:is(.next-page, .previous-page):is(:hover, :focus) {
+  box-shadow: var(--sl-color-neutral-50) 0px 12px 13px;
+  transform: translateY(-2px);
+}
+
+.pagination-footer {
+  padding-top: 2rem;
+  margin-top: auto;
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(210px, 1fr));
+  justify-content: space-between;
+  gap: 1rem;
+}
+
+pagination-title {
+  display: block;
+  max-width: 100%;
+  overflow: hidden;
+  font-size: 1.15rem;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+

docs/assets/scripts/light-pen/docs/frontend/styles/components/_side_nav.css

@@ -0,0 +1,95 @@
+.side-nav ul {
+  list-style-type: " ";
+}
+
+.side-nav__menu {
+  margin: 0;
+  padding-inline-start: 0;
+  min-width: 250px;
+  max-width: 100%;
+}
+
+ul.side-nav__menu li::marker {
+  content: ""
+}
+
+.side-nav__item {
+  padding: 8px;
+  max-width: 100%;
+  line-height: 1.3;
+  font-size: 1rem;
+  font-weight: normal;
+}
+
+.side-nav__link {
+  font-weight: normal;
+  text-decoration: none;
+  color: var(--sl-color-neutral-700);
+}
+
+.side-nav__link:is(:hover, :focus) {
+  color: var(--link-color);
+  text-decoration: underline;
+}
+
+.side-nav--desktop {
+  display: none;
+  flex-direction: column;
+  align-items: flex-end;
+  max-width: 275px;
+  max-height: 100%;
+  padding-bottom: 1rem;
+  overflow: auto;
+}
+
+.side-nav__menu {
+  list-style: none;
+  padding: 0;
+  padding-top: 1rem;
+}
+
+.side-nav__drawer__header {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  border-bottom: 1px solid var(--sl-color-neutral-200);
+  padding-bottom: 1rem;
+}
+
+.side-nav__item.is-active {
+  font-weight: normal;
+  border-inline-start: 4px solid var(--sl-color-primary-600);
+  background-color: var(--sl-color-primary-100);
+}
+
+.side-nav__item.is-active,
+.side-nav__item.is-active a {
+  color: var(--sl-color-primary-700);
+}
+
+.side-nav__category-header {
+  font-size: 1.25rem;
+  margin-bottom: 0.5rem;
+}
+
+.side-nav__category-menu:not(:first-child) {
+  margin-top: 1.25rem;
+}
+
+@media screen and (min-width: 1024px) {
+  .side-nav--desktop {
+    display: flex;
+  }
+
+  .side-nav__category-menu {
+    padding-inline-start: 40px;
+  }
+
+  .side-nav__category-menu:first-of-type {
+    padding-top: 0;
+  }
+
+  .side-nav__drawer {
+    display: none;
+  }
+}

docs/assets/scripts/light-pen/docs/frontend/styles/components/_syntax_block.css

@@ -0,0 +1,38 @@
+.syntax-block {
+  position: relative;
+  margin-block-end: 1rem;
+  margin-block-start: 1rem;
+}
+
+.syntax-block {
+  border: 1px solid var(--divider-color);
+  border-radius: var(--sl-border-radius-large);
+}
+
+.syntax-block pre {
+  margin: 0;
+}
+
+.syntax-block__actions {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 4px 8px;
+}
+
+.syntax-block .highlight {
+  border-top-right-radius: 0px;
+  border-top-left-radius: 0px;
+}
+
+.syntax-block__badge {
+  font-size: 0.85em;
+  color: var(--sl-color-neutral-700);
+}
+
+:is(.language-bash, .language-shell, .language-zsh, .language-sh).highlighter-rouge pre.highlight::before {
+  content: "$";
+  user-select: none;
+  padding-inline-end: 0.45em;
+  color: gray;
+}

docs/assets/scripts/light-pen/docs/frontend/styles/components/_table_of_contents.css

@@ -0,0 +1,39 @@
+.table-of-contents {
+  margin-inline-start: 1rem;
+  min-width: 275px;
+  max-width: 275px;
+}
+
+.table-of-contents * {
+  max-width: 100%;
+}
+
+.table-of-contents__header {
+  margin: 0;
+  padding: 0;
+  padding-top: 1rem;
+  font-weight: normal;
+  color: var(--sl-color-neutral-800);
+  font-size: 1.05rem;
+}
+
+.table-of-contents__list {
+  padding: 0;
+  margin: 0;
+  margin-top: 1rem;
+  list-style: none;
+}
+
+.table-of-contents__list a {
+  text-decoration: none;
+}
+
+.table-of-contents__list li {
+  border-inline-start: 4px solid var(--sl-color-neutral-400);
+  padding-inline-start: 1rem;
+}
+
+.table-of-contents__list li {
+  padding: 0.5rem;
+}
+

docs/assets/scripts/light-pen/docs/frontend/styles/components/_tables.css

@@ -0,0 +1,33 @@
+.table-container {
+  max-width: 100%;
+  overflow-x: auto;
+}
+
+table {
+  border-collapse: collapse;
+  min-width: 100%;
+  height: auto;
+}
+
+th {
+  text-align: start;
+  font-weight: 500;
+  font-size: 1.1em;
+}
+
+th,
+td {
+  padding: 1rem;
+}
+
+tr {
+  border-bottom: 1px solid var(--divider-color);
+}
+
+tbody > tr:nth-of-type(2n) {
+  background-color: rgba(0,0,0,0.02);
+}
+
+tbody > tr code {
+  border: 1px solid rgba(0,0,0,0.2);
+}

docs/assets/scripts/light-pen/docs/frontend/styles/components/_text.css

@@ -0,0 +1,21 @@
+.logo__text {
+  color: var(--text-color-primary);
+  font-size: var(--sl-font-size-x-large);
+  padding-bottom: var(--sl-spacing-x-small);
+  margin-bottom: calc(var(--sl-spacing-x-small) - (var(--sl-spacing-x-small) * 2));
+  margin-inline-start: var(--sl-spacing-2x-small);
+}
+
+.site-title,
+.slogan {
+  text-align: center;
+}
+
+.slogan {
+  max-width: max(75%, 600px);
+  margin: 0 auto;
+}
+
+.site-title {
+  margin-top: 0;
+}

docs/assets/scripts/light-pen/docs/frontend/styles/components/_theme_switcher.css

@@ -0,0 +1,26 @@
+/* Themes */
+.theme-item {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  width: 100%;
+}
+
+[data-controller~='theme-switcher'],
+[data-controller~='theme-switcher']:not(:defined) {
+  height: 0;
+  width: 0;
+  opacity: 0;
+  visibility: hidden;
+}
+
+[data-controller~='theme-switcher']:defined {
+  height: unset;
+  width: unset;
+  visibility: visible;
+  opacity: 1;
+  animation: fadeInAnimation ease 500ms;
+  animation-iteration-count: 1;
+  animation-fill-mode: forwards;
+}
+

docs/assets/scripts/light-pen/docs/frontend/styles/components/_top_nav.css

@@ -0,0 +1,106 @@
+.top-nav {
+  display: flex;
+  max-width: var(--top-nav-max-width);
+  justify-content: center;
+  margin: 0 auto;
+  background-color: var(--body-color);
+  width: 100%;
+}
+
+.top-nav__search,
+.top-nav__go-home,
+.top-nav__categories {
+  display: flex;
+  align-items: center;
+}
+
+.top-nav__go-home {
+  min-width: 100px;
+}
+
+.top-nav__hamburger__button {
+  font-size: 1.75em;
+}
+
+.top-nav__hamburger__button::part(base),
+.top-nav__search__button::part(base) {
+  color: var(--sl-color-gray-600);
+  font-size: var(--sl-font-size-x-large);
+}
+
+.top-nav__hamburger__button::part(base):is(:hover, :focus),
+.top-nav__search__button::part(base):is(:hover, :focus) {
+  color: var(--link-color-focus);
+}
+
+.top-nav__hamburger__button::part(base):focus,
+.top-nav__search__button::part(base):focus {
+  border-color: var(--link-color-focus);
+  box-shadow: 0 0 6px var(--link-color-focus);
+}
+
+.top-nav__search {
+  margin: 0;
+  margin-inline-start: auto;
+}
+
+.top-nav__github sl-icon {
+  font-size: 2rem;
+}
+
+.top-nav__github {
+  height: auto;
+}
+
+.top-nav__links {
+  display: flex;
+  align-items: center;
+  justify-content: flex-end;
+  flex: 0 1 auto;
+}
+
+.top-nav__categories {
+  display: none;
+  font-family: var(--sl-font-sans);
+  font-weight: bold;
+  min-width: fit-content;
+  gap: 1rem;
+}
+
+.top-nav__categories > * {
+  margin: 0;
+}
+
+.top-nav__github {
+  padding-top: var(--sl-spacing-2x-small);
+  margin-inline-start: var(--sl-spacing-medium);
+  margin-inline-end: 2px;
+}
+
+.top-nav__go-home,
+.top-nav__command-palette-button {
+  display: none;
+}
+
+@media screen and (min-width: 1024px) {
+  /* .hero--mobile, */
+  .top-nav__hamburger__button,
+  .top-nav__search__button {
+    display: none;
+  }
+
+  .top-nav__go-home,
+  .top-nav__command-palette-button {
+    display: flex;
+  }
+
+  .top-nav__search {
+    margin: 0 auto 0 auto;
+    order: unset;
+  }
+
+  .top-nav__categories {
+    display: flex;
+  }
+}
+

docs/assets/scripts/light-pen/docs/frontend/styles/defer.css

@@ -0,0 +1,10 @@
+/*
+ * Anything that can be deferred and not cause layout shift.
+ * IE: colors, fonts, syntax highlighting, etc.
+ */
+
+@import "@shoelace-style/shoelace/dist/themes/light.css";
+@import "@shoelace-style/shoelace/dist/themes/dark.css";
+@import "./tokens/_colors.css";
+@import "./defer/_syntax.css";
+@import "./defer/_fonts.css";

docs/assets/scripts/light-pen/docs/frontend/styles/defer/_animations.css

@@ -0,0 +1,17 @@
+@keyframes fadeInAnimation {
+  0% {
+      opacity: 0;
+  }
+  100% {
+      opacity: 1;
+    }
+}
+
+@keyframes fadeOutAnimation {
+  0% {
+      opacity: 1;
+  }
+  100% {
+      opacity: 0;
+    }
+}

docs/assets/scripts/light-pen/docs/frontend/styles/defer/_fonts.css

@@ -0,0 +1,10 @@
+/** Nothing here...yet */
+/* @font-face { */
+/*   font-family: 'VT323'; */
+/*   src: */
+/*     url('/assets/fonts/VT323.ttf') format('truetype'); */
+/*   font-display: swap; */
+/*   font-weight: 400; */
+/*   font-style: normal; */
+/*   font-stretch: 100; */
+/* } */