make parts consistent; fixes #1646

.github/ISSUE_TEMPLATE/config.yml

@@ -1,7 +1,7 @@
 contact_links:
   - name: Feature Requests
-    url: https://github.com/shoelace-style/webawesome/discussions/categories/ideas-suggestions
+    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/webawesome/discussions/categories/ask-for-help
+    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.

.gitignore

@@ -10,4 +10,3 @@ yarn.lock
 _bundle_
 /packages/webawesome-pro
 /packages/webawesome-app
-custom-elements.json

.prettierignore

@@ -20,5 +20,4 @@ packages/**/*/src/react/index.ts
 node_modules
 
 packages/**/*/_site
-packages/**/*/_bundle_
 packages/webawesome/docs/assets/scripts/prism-downloaded.js

VERSIONS.txt

@@ -1,2 +1,6 @@
-3.0.0
-3.1.0
+3.0.0-beta.1
+3.0.0-beta.2
+3.0.0-beta.3
+3.0.0-beta.4
+3.0.0-beta.5
+3.0.0-beta.6

cspell.json

@@ -70,7 +70,6 @@
     "exportparts",
     "fetchpriority",
     "fieldsets",
-    "flexbox",
     "focusin",
     "focusout",
     "fontawesome",
@@ -106,7 +105,6 @@
     "keydown",
     "keyframes",
     "keymaker",
-    "Kickstarter",
     "Konnor",
     "Kool",
     "labelledby",
@@ -115,14 +113,10 @@
     "listbox",
     "listitem",
     "litelement",
-    "llm",
-    "llms",
-    "llmstxt",
     "longform",
     "lowercasing",
     "Lucide",
     "maxlength",
-    "mdash",
     "Menlo",
     "menuitemcheckbox",
     "menuitemradio",
@@ -136,7 +130,6 @@
     "mouseout",
     "mouseup",
     "multiselectable",
-    "nbsp",
     "nextjs",
     "nocheck",
     "noindex",
@@ -155,7 +148,6 @@
     "ParamagicDev",
     "peta",
     "petabit",
-    "pointercancel",
     "Preact",
     "preconnect",
     "prerendered",
@@ -187,7 +179,6 @@
     "shadowrootmode",
     "Shortcode",
     "Shortcodes",
-    "signup",
     "sitedir",
     "slotchange",
     "smartquotes",
@@ -209,8 +200,6 @@
     "thead",
     "Themer",
     "tinycolor",
-    "touchcancel",
-    "touchend",
     "transitionend",
     "treeitem",
     "treeshaking",
@@ -244,6 +233,8 @@
     "src/translations/!(en).ts",
     "**/*.min.js"
   ],
-  "ignoreRegExpList": ["(^|[^a-z])sl[a-z]*(^|[^a-z])"],
+  "ignoreRegExpList": [
+    "(^|[^a-z])sl[a-z]*(^|[^a-z])"
+  ],
   "useGitignore": true
 }

package.json

@@ -2,7 +2,7 @@
   "name": "@webawesome/monorepo",
   "private": true,
   "description": "A forward-thinking library of web components.",
-  "version": "3.1.0",
+  "version": "3.0.0-alpha.13",
   "homepage": "https://webawesome.com/",
   "author": "Web Awesome",
   "license": "MIT",
@@ -13,24 +13,20 @@
   "scripts": {
     "check-updates": "npx npm-check-updates --interactive --format group",
     "start": "cd packages/webawesome && npm run start",
-    "build": "cd packages/webawesome && npm run build",
-    "start:pro": "cd packages/webawesome-pro && npm run start",
-    "build:pro": "cd packages/webawesome-pro && npm run build"
+    "start:pro": "cd packages/webawesome-pro && npm run start"
   },
   "engines": {
     "node": ">=14.17.0"
   },
   "devDependencies": {
     "@11ty/eleventy": "3.0.0",
-    "@custom-elements-manifest/analyzer": "^0.11.0",
+    "@custom-elements-manifest/analyzer": "^0.10.4",
     "@lit-labs/eleventy-plugin-lit": "^1.0.3",
     "@lit-labs/testing": "^0.2.5",
     "@lit/react": "^1.0.8",
     "@open-wc/testing": "^3.2.0",
     "@types/mocha": "^10.0.10",
     "@types/react": "^18.2.28",
-    "@wc-toolkit/cem-inheritance": "^1.2.2",
-    "@wc-toolkit/type-parser": "^1.2.0",
     "@web/dev-server-esbuild": "^0.3.6",
     "@web/test-runner": "^0.19.0",
     "@web/test-runner-commands": "^0.9.0",
@@ -43,10 +39,9 @@
     "command-line-args": "^5.2.1",
     "comment-parser": "^1.4.1",
     "cspell": "^6.18.1",
-    "custom-element-jet-brains-integration": "^1.7.0",
-    "custom-element-svelte-integration": "^1.2.0",
-    "custom-element-vs-code-integration": "^1.5.0",
-    "custom-element-vuejs-integration": "^1.4.0",
+    "custom-element-jet-brains-integration": "^1.6.2",
+    "custom-element-vs-code-integration": "^1.4.1",
+    "custom-element-vuejs-integration": "^1.3.3",
     "del": "^7.1.0",
     "download": "^8.0.0",
     "esbuild": "0.23.1",

packages/webawesome/custom-elements-manifest.js

@@ -1,17 +1,12 @@
-import { cemInheritancePlugin } from '@wc-toolkit/cem-inheritance';
-import { cemValidatorPlugin } from '@wc-toolkit/cem-validator';
 import { jsxTypesPlugin } from '@wc-toolkit/jsx-types';
-import { getTsProgram, typeParserPlugin } from '@wc-toolkit/type-parser';
-import { parse } from 'comment-parser';
 import { customElementJetBrainsPlugin } from 'custom-element-jet-brains-integration';
-import { customElementSveltePlugin } from 'custom-element-svelte-integration';
 import { customElementVsCodePlugin } from 'custom-element-vs-code-integration';
-import { customElementVuejsPlugin } from 'custom-element-vuejs-integration';
+// import { customElementVuejsPlugin } from 'custom-element-vuejs-integration';
+import { parse } from 'comment-parser';
 import fs from 'fs';
 import * as path from 'node:path';
 import { pascalCase } from 'pascal-case';
 import * as url from 'url';
-import { llmsTxtPlugin } from './scripts/llms.js';
 const __dirname = url.fileURLToPath(new URL('.', import.meta.url));
 
 const packageData = JSON.parse(fs.readFileSync(path.join(__dirname, 'package.json'), 'utf8'));
@@ -27,20 +22,11 @@ function replace(string, terms) {
 }
 
 export default {
-  // `src/components/**/*.ts` will ignore src/internal breaking inheritance chains.
-  globs: ['src/**/*.ts'],
+  globs: ['src/components/**/*.ts'],
   exclude: ['**/*.styles.ts', '**/*.test.ts'],
   litelement: true,
-  dependencies: true,
   outdir,
-  // Give the plugin access to the TypeScript type checker
-  overrideModuleCreation({ ts, globs }) {
-    const program = getTsProgram(ts, globs, 'tsconfig.json');
-    return program.getSourceFiles().filter(sf => globs.find(glob => sf.fileName.includes(glob)));
-  },
-
   plugins: [
-    typeParserPlugin(),
     // Append package data
     {
       name: 'wa-package-data',
@@ -49,11 +35,6 @@ export default {
       },
     },
 
-    cemInheritancePlugin({
-      fileName: 'custom-elements.json',
-      outdir,
-    }),
-
     // Parse custom jsDoc tags
     {
       name: 'wa-custom-tags',
@@ -134,6 +115,7 @@ export default {
         }
       },
     },
+
     {
       name: 'wa-translate-module-paths',
       packageLinkPhase({ customElementsManifest }) {
@@ -170,6 +152,7 @@ export default {
         });
       },
     },
+
     // Generate custom VS Code data
     customElementVsCodePlugin({
       outdir,
@@ -184,7 +167,7 @@ export default {
 
     // Generate custom JetBrains data
     customElementJetBrainsPlugin({
-      outdir,
+      outdir: './dist-cdn',
       excludeCss: true,
       packageJson: false,
       referencesTemplate: (_, tag) => {
@@ -205,27 +188,13 @@ export default {
       },
     }),
 
-    // Generate llms.txt
-    llmsTxtPlugin({
-      outdir,
-      docsDir: path.join(__dirname, 'docs'),
-      baseUrl: 'https://webawesome.com',
-    }),
-
     //
     // TODO - figure out why this broke when events were updated
     //
-    customElementVuejsPlugin({
-      outdir: './dist-cdn/types/vue',
-      fileName: 'index.d.ts',
-      componentTypePath: (_, tag) => `../../components/${tag.replace('wa-', '')}/${tag.replace('wa-', '')}.js`,
-    }),
-    customElementSveltePlugin({
-      outdir: './dist-cdn/types/svelte',
-      fileName: 'index.d.ts',
-    }),
-    // cemValidatorPlugin({
-    //   cemFileName: "./dist-cdn/custom-elements.json"
-    // }),
+    // customElementVuejsPlugin({
+    //   outdir: './dist/types/vue',
+    //   fileName: 'index.d.ts',
+    //   componentTypePath: (_, tag) => `../../components/${tag.replace('wa-', '')}/${tag.replace('wa-', '')}.js`
+    // })
   ],
 };

packages/webawesome/docs/.eleventy.js

@@ -1,5 +1,6 @@
 import { nanoid } from 'nanoid';
 import { parse as HTMLParse } from 'node-html-parser';
+import { execFileSync } from 'node:child_process';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import { anchorHeadingsTransformer } from './_transformers/anchor-headings.js';
@@ -20,6 +21,7 @@ import { replaceTextPlugin } from './_plugins/replace-text.js';
 import { searchPlugin } from './_plugins/search.js';
 const __dirname = url.fileURLToPath(new URL('.', import.meta.url));
 const isDev = process.argv.includes('--develop');
+const ignoreGit = process.env.ELEVENTY_IGNORE_GIT === 'true';
 const passThroughExtensions = ['js', 'css', 'png', 'svg', 'jpg', 'mp4'];
 
 async function getPackageData() {
@@ -58,6 +60,15 @@ export default async function (eleventyConfig) {
     if (updateComponentData) {
       allComponents = getComponents();
     }
+
+    // Invalidate last-modified cache for changed content files during watch
+    if (Array.isArray(changedFiles)) {
+      for (const file of changedFiles) {
+        if (/\.(md|njk|html)$/i.test(file)) {
+          lastModCache.delete(file);
+        }
+      }
+    }
   });
 
   /**
@@ -83,63 +94,85 @@ export default async function (eleventyConfig) {
     flashes: '',
   });
 
-  // Site metadata for social sharing (Open Graph, canonical URLs, etc.)
-  const siteMetadata = {
-    url: 'https://webawesome.com',
-    name: 'Web Awesome',
-    description: 'Build better with Web Awesome, the open source library of web components from Font Awesome.',
-    image: 'https://webawesome.com/assets/images/open-graph/default.png',
-  };
-
-  // Title composition/stripping config - single source of truth
-  const SITE_NAME = siteMetadata.name;
-  const SITE_TITLE_SEPARATORS = ['|'];
-
-  // Helper to escape user-provided strings for safe use inside RegExp sources
-  const escapeRegExp = string => (string + '').replace(/[.*+?^${}()|[\\]\\]/g, '\\$&');
-
-  // Precompute a reusable regex to strip a trailing site name suffix from titles, e.g. " | Web Awesome"
-  // Supports configured separators and flexible whitespace. This keeps search titles clean and improves Lunr scoring
-  const siteNameEscapedForRegex = escapeRegExp(SITE_NAME);
-  const separatorsEscaped = SITE_TITLE_SEPARATORS.map(s => escapeRegExp(s)).join('');
-  const siteTitleSuffixPattern = new RegExp(`\\s*[${separatorsEscaped}]\\s*${siteNameEscapedForRegex}$`);
-
-  // Helper to remove the site suffix from a page title. Keep this in sync with how page titles
-  // are composed (see eleventyComputed.pageTitle) so search indexing stays consistent
-  const stripSiteTitleSuffix = title => (title || '').replace(siteTitleSuffixPattern, '');
-
-  // Helper to compose a full page title with site suffix when appropriate
-  // Uses the same separator set as the stripping logic for consistency
-  const composePageTitle = baseTitle => {
-    const title = baseTitle || SITE_NAME;
-    const preferredSeparator = SITE_TITLE_SEPARATORS[0] || '|';
-    return title !== SITE_NAME ? `${title} ${preferredSeparator} ${SITE_NAME}` : title;
-  };
-
-  eleventyConfig.addGlobalData('siteMetadata', siteMetadata);
-
   // Template filters - {{ content | filter }}
   eleventyConfig.addFilter('inlineMarkdown', content => markdown.renderInline(content || ''));
   eleventyConfig.addFilter('markdown', content => markdown.render(content || ''));
   eleventyConfig.addFilter('stripExtension', string => path.parse(string + '').name);
   eleventyConfig.addFilter('stripPrefix', content => content.replace(/^wa-/, ''));
   eleventyConfig.addFilter('uniqueId', (_value, length = 8) => nanoid(length));
+  // Returns last modified date as ISO 8601 (UTC, Z-suffixed)
+  // Fallback order: front matter override -> Git last commit date -> filesystem mtime -> now
+  // Caching: in-memory per inputPath during one build/dev session
+  // Override: pass a Date or string: {{ page.inputPath | gitLastModifiedISO(lastUpdated) }}
+  const lastModCache = new Map();
+  let repoRoot = null; // lazily resolved; null => not resolved, undefined => failed
 
-  eleventyConfig.addGlobalData('eleventyComputed', {
-    // Page title with smart + default site name formatting
-    pageTitle: data => composePageTitle(data.title),
-    // Open Graph title with smart + default site name formatting
-    ogTitle: data => composePageTitle(data.ogTitle || data.title),
-    ogDescription: data => data.ogDescription || data.description,
-    ogImage: data => data.ogImage || siteMetadata.image,
-    ogUrl: data => {
-      if (data.ogUrl) return data.ogUrl;
-      const url = data.page?.url || '';
-      return url ? `${siteMetadata.url}${url}` : siteMetadata.url;
-    },
-    ogType: data => data.ogType || 'website',
+  function getLastModifiedISO(inputPath, overrideDate) {
+    if (overrideDate instanceof Date) {
+      return overrideDate.toISOString();
+    }
+    if (typeof overrideDate === 'string' && overrideDate) {
+      const parsed = new Date(overrideDate);
+      if (!isNaN(parsed.getTime())) return parsed.toISOString();
+    }
+    if (!inputPath) return new Date().toISOString();
+    if (lastModCache.has(inputPath)) return lastModCache.get(inputPath);
+
+    // Try Git (ISO via %cI). Use a repo-root-relative path for portability.
+    if (!ignoreGit) {
+      try {
+        if (repoRoot === null) {
+          try {
+            repoRoot = execFileSync('git', ['rev-parse', '--show-toplevel'], {
+              stdio: ['ignore', 'pipe', 'ignore'],
+              cwd: __dirname,
+            })
+              .toString()
+              .trim();
+          } catch (_) {
+            repoRoot = undefined;
+          }
+        }
+
+        const gitPath = repoRoot ? path.relative(repoRoot, inputPath) : inputPath;
+        const args = ['log', '-1', '--format=%cI', '--follow', '--', gitPath];
+        const result = execFileSync('git', args, {
+          stdio: ['ignore', 'pipe', 'ignore'],
+          cwd: repoRoot || path.dirname(inputPath),
+        })
+          .toString()
+          .trim();
+        if (result) {
+          const iso = new Date(result).toISOString();
+          lastModCache.set(inputPath, iso);
+          return iso;
+        }
+      } catch (_) {
+        // continue to fs fallback
+      }
+    }
+
+    // Fallback to filesystem mtime
+    try {
+      const stats = fs.statSync(inputPath);
+      const iso = new Date(stats.mtime).toISOString();
+      lastModCache.set(inputPath, iso);
+      return iso;
+    } catch (_) {
+      const now = new Date().toISOString();
+      lastModCache.set(inputPath, now);
+      return now;
+    }
+  }
+
+  eleventyConfig.addFilter('gitLastModifiedISO', function (inputPath, overrideDate) {
+    return getLastModifiedISO(inputPath, overrideDate);
   });
 
+  // Attach lastUpdatedISO to page data so templates can use {{ lastUpdatedISO }} directly
+  eleventyConfig.addGlobalData('eleventyComputed', {
+    lastUpdatedISO: data => getLastModifiedISO(data.page?.inputPath, data.lastUpdated),
+  });
   // Trims whitespace and pipes from the start and end of a string. Useful for CEM types, which can be pipe-delimited.
   // With Prettier 3, this means a leading pipe will exist be present when the line wraps.
   eleventyConfig.addFilter('trimPipes', content => {
@@ -194,11 +227,7 @@ export default async function (eleventyConfig) {
 
   // Shortcodes - {% shortCode arg1, arg2 %}
   eleventyConfig.addShortcode('cdnUrl', location => {
-    // We use WA (free) via the public CDN for CodePen examples
-    return (
-      `https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@${packageData.version}/dist-cdn/` +
-      (location || '').replace(/^\//, '')
-    );
+    return `https://early.webawesome.com/webawesome@${packageData.version}/dist/` + (location || '').replace(/^\//, '');
   });
 
   // Turns `{% server "foo" %} into `{{ server.foo | safe }}` when the WEBAWESOME_SERVER variable is set to "true"
@@ -293,11 +322,6 @@ export default async function (eleventyConfig) {
     searchPlugin({
       filename: '',
       selectorsToIgnore: ['code.example'],
-      // Use <title> but strip a trailing site name suffix for cleaner search results
-      getTitle: doc => {
-        const raw = doc.querySelector('title')?.textContent ?? '';
-        return stripSiteTitleSuffix(raw);
-      },
       getContent: doc => doc.querySelector('#content')?.textContent ?? '',
     }),
   );
@@ -313,13 +337,9 @@ export default async function (eleventyConfig) {
 
   // This needs to happen in "eleventy.after" otherwise incremental builds never update.
   eleventyConfig.on('eleventy.after', function () {
-    const baseDir = process.env.BASE_DIR || 'docs';
-    let assetsDir = path.join(baseDir, 'assets');
+    let assetsDir = path.join(process.env.BASE_DIR || 'docs', 'assets');
     const siteAssetsDir = path.join(eleventyConfig.directories.output, 'assets');
     fs.cpSync(assetsDir, siteAssetsDir, { recursive: true });
-
-    // Passthrough copy for manifest.json (PWA manifest file)
-    fs.cpSync(path.join(baseDir, 'manifest.json'), path.join(eleventyConfig.directories.output, 'manifest.json'));
   });
 
   for (let glob of passThrough) {

packages/webawesome/docs/_data/themer.js

@@ -12,22 +12,22 @@ export const themes = [
     isPro: false,
     fonts: {
       body: {
-        name: 'OS Default (sans-serif)',
+        name: 'OS Default',
         css: 'ui-sans-serif, system-ui, sans-serif',
         href: null,
       },
       heading: {
-        name: 'OS Default (sans-serif)',
+        name: 'OS Default',
         css: 'ui-sans-serif, system-ui, sans-serif',
         href: null,
       },
       code: {
-        name: 'OS Default (monospace)',
+        name: 'OS Default',
         css: 'ui-monospace, monospace',
         href: null,
       },
       longform: {
-        name: 'OS Default (serif)',
+        name: 'OS Default',
         css: 'ui-serif, serif',
         href: null,
       },
@@ -82,7 +82,7 @@ export const themes = [
         href: 'https://fonts.bunny.net/css2?family=Quicksand:wght@300..700&display=swap',
       },
       code: {
-        name: 'OS Default (monospace)',
+        name: 'OS Default',
         css: 'ui-monospace, monospace',
         href: null,
       },
@@ -132,22 +132,22 @@ export const themes = [
     isPro: false,
     fonts: {
       body: {
-        name: 'OS Default (sans-serif)',
+        name: 'OS Default',
         css: 'ui-sans-serif, system-ui, sans-serif',
         href: null,
       },
       heading: {
-        name: 'OS Default (sans-serif)',
+        name: 'OS Default',
         css: 'ui-sans-serif, system-ui, sans-serif',
         href: null,
       },
       code: {
-        name: 'OS Default (monospace)',
+        name: 'OS Default',
         css: 'ui-monospace, monospace',
         href: null,
       },
       longform: {
-        name: 'OS Default (serif)',
+        name: 'OS Default',
         css: 'ui-serif, serif',
         href: null,
       },
@@ -442,7 +442,7 @@ export const themes = [
         href: 'https://fonts.bunny.net/css2?family=Lora:ital,wght@0,400..700;1,400..700&display=swap',
       },
       code: {
-        name: 'OS Default (monospace)',
+        name: 'OS Default',
         css: 'ui-monospace, monospace',
         href: null,
       },
@@ -562,7 +562,7 @@ export const themes = [
         href: 'https://fonts.bunny.net/css2?family=Playfair+Display:ital,wght@0,400..900;1,400..900&display=swap',
       },
       code: {
-        name: 'OS Default (monospace)',
+        name: 'OS Default',
         css: 'ui-monospace, monospace',
         href: null,
       },
@@ -622,12 +622,12 @@ export const themes = [
         href: 'https://fonts.bunny.net/css2?family=Inter:ital,wght@0,100..900;1,100..900&display=swap',
       },
       code: {
-        name: 'OS Default (monospace)',
+        name: 'OS Default',
         css: 'ui-monospace, monospace',
         href: null,
       },
       longform: {
-        name: 'OS Default (serif)',
+        name: 'OS Default',
         css: 'ui-serif, serif',
         href: null,
       },

packages/webawesome/docs/_includes/_banner-wa-launch.njk

@@ -1,19 +0,0 @@
-{% raw %}
-  {%- if req.stripe.discount.active and not currentUser.hasPro -%}
-  <div slot="banner" class="banner-wa-launch wa-dark">
-    <div class="banner-content wa-split">
-      <div class="wa-cluster wa-gap-s">
-        <wa-icon name="badge-percent" class="banner-icon"></wa-icon>
-        <p class="wa-body-s">
-          <strong style="margin-inline-end: var(--wa-space-2xs)">Web Awesome is here!</strong>
-          Celebrate with <span class="appearance-underlined variant-drawn">20% off</span> on a Web Awesome Pro plan&hellip; <span class="appearance-underlined variant-drawn">for life</span>!
-        </p>
-      </div>
-      <wa-button appearance="outlined" variant="brand" size="small" href="/purchase" class="brand-font">
-        <wa-icon slot="start" variant="regular" name="rocket-launch"></wa-icon>
-        Get Pro + Save 20%
-      </wa-button>
-    </div>
-  </div>
-  {%- endif -%}
-{% endraw %}

packages/webawesome/docs/_includes/_dialog-wa-launch.njk

@@ -1,77 +0,0 @@
-{% raw %}
-  {%- if req.stripe.discount.active and not currentUser.hasPro -%}
-    <wa-dialog id="dialog-site" light-dismiss without-header>
-
-      <div class="background-wa-pattern" style="justify-content: center; margin-inline: calc(var(--spacing) * -1); margin-block-start: calc(var(--spacing) * -1); margin-block-end: var(--spacing); background: linear-gradient(to bottom, var(--wa-color-brand), var(--wa-color-brand-50)); color: var(--wa-color-brand-on-loud); padding: var(--wa-space-3xl) var(--spacing); --background-pattern-opacity: 0.2; --background-pattern-image: url('/assets/images/bg-wa-pattern.svg');">
-
-        <div class="wa-stack wa-align-items-center" style="text-align: center;">
-          <wa-icon name="party-horn" family="duotone" variant="solid" style="font-size: var(--wa-font-size-3xl); --secondary-color: var(--wa-color-brand-40); --secondary-opacity: 1.0;"></wa-icon>
-          <h2 class="wa-heading-2xl brand-font">Get a lifetime discount on Web Awesome Pro!</h2>
-        </div>
-      </div>
-
-      <div class="wa-stack wa-gap-l">
-        <p>Celebrate our official launch with a 20% discount on a Web Awesome Pro plan&hellip;<span class="appearance-underlined variant-drawn" style="--underline-color: var(--wa-color-brand);">for life</span>! But hurry, this lifetime discount is only available for a limited time.</p>
-
-        <div class="wa-split">
-          <wa-button type="button" appearance="plain" data-dialog="close">Maybe Later</wa-button>
-          <wa-button variant="neutral" appearance="accent" href="/purchase" class="brand-font">
-            <wa-icon slot="start" variant="regular" name="rocket-launch"></wa-icon>
-            Get Pro + Save 20%
-          </wa-button>
-        </div>
-      </div>
-    </wa-dialog>
-
-    <script type="module">
-      (function() {
-        const SITE_DIALOG_DISMISSED_KEY = 'dialog-wa-launch-sale-dismissed';
-
-        // Early exit if user has dismissed the dialog
-        try {
-          if (localStorage.getItem(SITE_DIALOG_DISMISSED_KEY) === 'true') {
-            return;
-          }
-        } catch (e) {
-          // localStorage may be disabled or unavailable
-          return;
-        }
-
-        // Wait for DOM and dialog element
-        const dialog = document.getElementById('dialog-site');
-        if (!dialog) {
-          return;
-        }
-
-        // Initialize dialog functionality
-        let initCalled = false;
-        const initDialog = () => {
-          // Prevent double initialization
-          if (initCalled) {
-            return;
-          }
-          initCalled = true;
-
-          // Save dismissal state when dialog is hidden
-          dialog.addEventListener('wa-hide', (event) => {
-            // Save dismissal state to localStorage
-            try {
-              localStorage.setItem(SITE_DIALOG_DISMISSED_KEY, 'true');
-            } catch (e) {
-              // localStorage may be disabled or unavailable
-            }
-          }, { once: true });
-
-          // Show dialog after a short delay to ensure page is loaded
-          setTimeout(() => {
-            dialog.open = true;
-          }, 500);
-        };
-
-      customElements.whenDefined("wa-dialog").then(() => {
-        initDialog()
-      })
-      })();
-    </script>
-  {%- endif -%}
-{% endraw %}

packages/webawesome/docs/_includes/base.njk

@@ -1,9 +1,5 @@
 <!DOCTYPE html>
-{% if hasAnchors == undefined %}{% set hasAnchors = true %}{% endif %}
-{% if hasBanner == undefined %}{% set hasBanner = true %}{% endif %}
-{% if hasSiteDialog == undefined %}{% set hasSiteDialog = true %}{% endif %}
-{% if hasGeneratedTitle == undefined %}{% set hasGeneratedTitle = true %}{% endif %}
-<html lang="en" data-fa-kit-code="38c11e3f20" data-version="{{ package.version }}" class="wa-cloak"{% if hasAnchors == false %} data-no-anchor{% endif %}>
+<html lang="en" data-fa-kit-code="38c11e3f20" data-cdn-url="{% cdnUrl %}" class="wa-cloak">
   <head>
     {% include 'head.njk' %}
     <meta name="theme-color" content="#f36944">
@@ -17,6 +13,7 @@
     <script type="module" src="/assets/scripts/color-scheme.js"></script>
     <script type="module" src="/assets/scripts/theme.js"></script>
     {% if hasSidebar %}<script type="module" src="/assets/scripts/sidebar.js"></script>{% endif %}
+    <script defer data-domain="webawesome.com" src="https://plausible.io/js/script.js"></script>
 
     {% block head %}
       <link rel="stylesheet" href="/assets/styles/docs.css" />
@@ -30,8 +27,7 @@
     </script>
   </head>
   <body class="layout-{{ layout | stripExtension }} page-{{ pageClass or page.fileSlug or 'home' }}{{ ' page-wide' if wide }}">
-
-    {% set defaultWaPageAttributes = defaultWaPageAttributes or { view: 'desktop', 'disable-navigation-toggle': true, 'mobile-breakpoint': 1180, 'disable-sticky': 'banner' } %}
+    {% set defaultWaPageAttributes = defaultWaPageAttributes or { view: 'desktop', 'disable-navigation-toggle': true, 'mobile-breakpoint': 1180 } %}
     {% set waPageAttributes = waPageAttributes or {} %}
     {% set mergedWaPageAttributes = defaultWaPageAttributes | merge(waPageAttributes) %}
     <wa-page
@@ -41,82 +37,65 @@
         {% endif %}
       {% endfor %}
     >
-      {# wa-page-based Skip to Content #}
-      {% block pageSkipToContent %}{% endblock %}
+        {% block pageHeader %}
+          <header slot="header" class="wa-split">
+            {# Nav toggle #}
+              <wa-button appearance="plain" size="small" data-toggle-nav>
+                <wa-icon name="bars" label="Toggle navigation" class="icon-default icon-embiggen"></wa-icon>
+                <wa-icon name="burger" aria-hidden="true" class="icon-hover icon-embiggen"></wa-icon>
+              </wa-button>
 
-      {# wa-page-based Banner #}
-      {% block pageBanner %}
-        {% if hasBanner %}
-          {#- WA Launch Banner -#}
-          {% include "_banner-wa-launch.njk" ignore missing %}
-        {% endif %}
-      {% endblock %}
+              {# Logo - Desktop #}
+              <a class="brand-logo wa-desktop-only" href="/" aria-label="Web Awesome">
+                {% include "logo.njk" %}
+              </a>
 
-      {# wa-page-based Subheader #}
-      {% block pageSubheader %}{% endblock %}
+            {#- Logo - mobile branding -#}
+            <a href="/" class="brand-logo wa-mobile-only" aria-label="Web Awesome">
+              {# Logo - Mobile #}
+              {% include "logo-simple.njk" %}
+            </a>
 
-      {# wa-page-based Header #}
-      {% block pageHeader %}
-        <header slot="header" class="wa-split">
-          {# Nav toggle #}
-          <wa-button appearance="plain" size="small" data-toggle-nav>
-            <wa-icon name="bars" label="Toggle navigation" class="icon-default icon-embiggen"></wa-icon>
-            <wa-icon name="burger" aria-hidden="true" class="icon-hover icon-embiggen"></wa-icon>
-          </wa-button>
-
-          {# Logo - Desktop #}
-          <a href="/" class="brand-logo wa-desktop-only" aria-label="Web Awesome">{% include "logo.njk" %}</a>
-
-          {# Logo - Mobile #}
-          <a href="/" class="brand-logo wa-mobile-only" aria-label="Web Awesome">{% include "logo-simple.njk" %}</a>
-
-          <div id="docs-toolbar" class="wa-cluster gap-s">
-            <div class="wa-desktop-only wa-cluster wa-gap-2xs">
-              {% include "theme-selector.njk" %}
-              {% include "color-scheme-selector.njk" %}
-              {% include "github-icon-buttons.njk" %}
-            </div>
-
-            {#- Login -#}
-            {% include "login-or-avatar.njk" ignore missing %}
-          </div>
-        </header>
-      {% endblock %}
-
-      {# wa-page-based Navigation Header #}
-      {% block pageNavigationHeader %}
-        {# Sidebar - Mobile Selectors #}
-        {% if hasSidebar %}
-          <div class="wa-mobile-only" slot="navigation-header">
-            <div class="wa-cluster wa-gap-s">
-              <a class="brand-logo" href="/" aria-label="Web Awesome">{% include "logo-simple.njk" %}</a>
-              <div class="wa-cluster wa-gap-2xs" style="flex-wrap: nowrap;">
+            <div id="docs-toolbar" class="wa-cluster gap-s">
+              <div class="wa-desktop-only wa-cluster wa-gap-2xs">
                 {% include "theme-selector.njk" %}
                 {% include "color-scheme-selector.njk" %}
                 {% include "github-icon-buttons.njk" %}
               </div>
+              {#- Login -#}
+              {% include "login-or-avatar.njk" ignore missing %}
+            </div>
+          </header>
+        {% endblock %}
+
+      {# Sidebar #}
+      {% if hasSidebar %}
+        {# Mobile selectors #}
+        <div class="wa-mobile-only" slot="navigation-header">
+          <div class="wa-cluster wa-gap-s">
+            <a class="brand-logo" href="/" aria-label="Web Awesome">{% include "logo-simple.njk" %}</a>
+            <div class="wa-cluster wa-gap-2xs" style="flex-wrap: nowrap;">
+              {% include "theme-selector.njk" %}
+              {% include "color-scheme-selector.njk" %}
+              {% include "github-icon-buttons.njk" %}
             </div>
           </div>
-        {% endif %}
-      {% endblock %}
+        </div>
+        <div slot="navigation" id="sidebar" class="docs-aside" data-remember-scroll>
+          {% include "sidebar.njk" %}
+        </div>
+      {% endif %}
 
-      {# wa-page-based Navigation #}
-      {% block pageNavigation %}
-        {# Sidebar - Navigation #}
-        {% if hasSidebar %}
-          <div slot="navigation" id="sidebar" class="docs-aside" data-remember-scroll>
-            {% include "sidebar.njk" %}
-          </div>
-        {% endif %}
-      {% endblock %}
+      {# Outline #}
+      {% if hasOutline %}
+        <aside slot="aside" id="outline" class="docs-aside">
+          <nav id="outline-standard" class="outline-links">
+            <h2><a href="#content">{{ title }}</a></h2>
+          </nav>
+        </aside>
+      {% endif %}
 
-      {# wa-page-based Navigation Footer #}
-      {% block pageNavigationFooter %}{% endblock %}
-
-      {# wa-page-based Main Header #}
-      {% block pageMainHeader %}{% endblock %}
-
-      {# wa-page-based Main Content (default) #}
+      {# Main #}
       <main id="content">
         {# Expandable outline #}
         {% if hasOutline %}
@@ -127,15 +106,10 @@
         </nav>
         {% endif %}
 
-        {# Flashes #}
-        {% block flashes %}
-          <div id="flashes">{% server "flashes" %}</div>
-        {% endblock %}
+        <div id="flashes">{% server "flashes" %}</div>
 
         {% block header %}
-          {% if hasGeneratedTitle %}
-            <h1 class="title">{{ title }}</h1>
-          {% endif %}
+          <h1 class="title">{{ title }}</h1>
         {% endblock %}
 
         {% block beforeContent %}{% endblock %}
@@ -147,33 +121,10 @@
         {% block afterContent %}{% endblock %}
       </main>
 
-      {# wa-page-based Main Footer #}
-      {% block pageMainFooter %}{% endblock %}
-
-      {# wa-page-based Aside #}
-      {% block pageAside %}
-        {# Outline #}
-        {% if hasOutline %}
-          <aside slot="aside" id="outline" class="docs-aside">
-            <nav id="outline-standard" class="outline-links">
-              <h2><a href="#content">{{ title }}</a></h2>
-            </nav>
-          </aside>
-        {% endif %}
-      {% endblock %}
-
-      {# wa-page-based Footer #}
-      {% block pageFooter %}{% endblock %}
-
       {% include 'search.njk' %}
 
-      {#- Site-Wide Dialog -#}
-      {% if hasSiteDialog %}
-        {% include "_dialog-wa-launch.njk" ignore missing %}
-      {% endif %}
-
-      {#- Cookie Consent Dialog -#}
-      {% include "cookie-consent.njk" ignore missing %}
+      {# Footer #}
+      {% block pageFooter %}{% endblock %}
     </wa-page>
 
   </body>

packages/webawesome/docs/_includes/free-badge.njk

@@ -1,7 +0,0 @@
-{% macro freeBadge(params) %}
-  {% set description = params.description or "This feature is available in the free version of Web Awesome" %}
-  {% set badgeId = params.id or ("free-badge-" + ("" | uniqueId(8))) %}
-  <wa-badge appearance="filled" variant="neutral" pill class="free" id="{{ badgeId }}" data-free-badge>Free</wa-badge>
-  <wa-tooltip for="{{ badgeId }}">{{ description }}</wa-tooltip>
-{% endmacro %}
-

packages/webawesome/docs/_includes/head.njk

@@ -3,17 +3,7 @@
 <meta name="description" content="{{ description }}">
 {% if noindex or unlisted %}<meta name="robots" content="noindex">{% endif %}
 
-<title>{{ pageTitle }}</title>
-
-{# Skip OG tags for unlisted/noindex pages to prevent social sharing #}
-{% if not (noindex or unlisted) %}
-  <meta property="og:type" content="{{ ogType }}" />
-  <meta property="og:url" content="{{ ogUrl }}" />
-  <meta property="og:title" content="{{ ogTitle }}" />
-  <meta property="og:description" content="{{ ogDescription }}" />
-  <meta property="og:image" content="{{ ogImage }}" />
-  <meta property="og:site_name" content="{{ siteMetadata.name }}" />
-{% endif %}
+<title>{{ title }}</title>
 
 {# Dark mode #}
 <script>
@@ -25,11 +15,8 @@
 	document.documentElement.classList.toggle('wa-dark', isDark);
 </script>
 
-<link rel="manifest" href="/manifest.json" />
-<link rel="icon" href="/assets/images/app-icons/favicon.ico" sizes="any">
-<link rel="icon" href="/assets/images/app-icons/icon.svg" type="image/svg+xml">
-<link rel="apple-touch-icon" href="/assets/images/app-icons/apple-touch-icon.png">
-
+<link rel="icon" href="/assets/images/webawesome-logo.svg" />
+<link rel="apple-touch-icon" href="/assets/images/app-icon.png">
 <link rel="preconnect" href="https://cdn.jsdelivr.net">
 <script type="module" src="/dist/webawesome.loader.js"></script>
 
@@ -38,12 +25,12 @@
 <link rel="stylesheet" href="/dist/styles/webawesome.css" />
 
 <script type="module">
-  document.addEventListener('wa-discovery-complete', loadLayout)
+  document.addEventListener("wa-discovery-complete", loadLayout)
   function loadLayout () {
-    if (!customElements.get('wa-page')) {
-      import('https://early.webawesome.com/webawesome@3.0.0-beta.6/dist/components/page/page.js')
+    if (!customElements.get("wa-layout")) {
+      import("{% cdnUrl 'components/page/page.js' %}")
         .catch((e) => {
-          // known errors with dual registration. This is only a thing in the free repo.
+        // known errors with dual registration. This is only a thing in the free repo.
         })
     }
   }

packages/webawesome/docs/_includes/pro-badge.njk

@@ -1,6 +1,6 @@
 {% macro proBadge(params) %}
   {% set description = params.description or "This requires access to Web Awesome Pro" %}
   {% set badgeId = params.id or ("pro-badge-" + ("" | uniqueId(8))) %}
-  <wa-badge appearance="accent" pill class="pro" id="{{ badgeId }}" data-pro-badge>Pro</wa-badge>
+  <wa-badge appearance="accent" pill class="pro" id="{{ badgeId }}">Pro</wa-badge>
   <wa-tooltip for="{{ badgeId }}">{{ description }}</wa-tooltip>
 {% endmacro %}

packages/webawesome/docs/_includes/sidebar.njk

@@ -16,7 +16,7 @@
 {# Resources #}
 <h2>Resources</h2>
 <ul>
-  <li><a href="/docs/resources/support">Help & Support</a></li>
+  <li><a href="https://github.com/shoelace-style/webawesome/discussions" target="_blank">Help &amp; Support</a></li>
   <li><a href="https://github.com/shoelace-style/webawesome/">Source Code</a></li>
   <li>
     <span class="wa-split">
@@ -24,17 +24,12 @@
       {{ proBadge() }}
     </span>
   </li>
+  <li><a href="/docs/resources/community">Community</a></li>
   <li><a href="/docs/resources/accessibility">Accessibility</a></li>
   <li><a href="/docs/resources/browser-support">Browser Support</a></li>
   <li><a href="/docs/resources/contributing">Contributing</a></li>
   <li><a href="/docs/resources/changelog">Changelog</a></li>
   <li><a href="/docs/resources/visual-tests">Visual Tests</a></li>
-  <li>
-    <a class="wa-cluster wa-gap-xs" href="/docs/resources/llms">
-      LLMs
-      <wa-icon name="flask" aria-hidden="true" class="icon-shrink"></wa-icon>
-    </a>
-  </li>
 </ul>
 
 <!-- Components -->
@@ -82,18 +77,10 @@
         </li>
       </ul>
     </li>
-    <li><span class="is-planned wa-split">Charts <span><a href="https://github.com/shoelace-style/webawesome/issues/1073" target="_blank">{{ plannedBadge("A Web Awesome Kickstarter stretch goal!") }}</a>{{ proBadge({ description: "This will require access to Web Awesome Pro" }) }}</span></span></li>
+    <li><span class="is-planned wa-split">Charts <a href="https://github.com/shoelace-style/webawesome/issues/1073" target="_blank">{{ plannedBadge("A Web Awesome Kickstarter stretch goal!") }}</a></span></li>
     <li><a href="/docs/components/checkbox/">Checkbox</a></li>
     <li><a href="/docs/components/color-picker/">Color Picker</a></li>
-    <li>
-      <span class="wa-split">
-        <span>
-          <a href="/docs/components/combobox">Combobox</a>
-          <wa-icon name="flask" aria-hidden="true" class="icon-shrink"></wa-icon>
-        </span>
-        {{ proBadge() }}
-      </span>
-    </li>
+    <li><span class="is-planned wa-split">Combobox <a href="https://github.com/shoelace-style/webawesome/issues/1074" target="_blank">{{ plannedBadge("A Web Awesome Kickstarter stretch goal!") }}</a></span></li>
     <li><a href="/docs/components/comparison/">Comparison</a></li>
     <li>
       <a class="wa-cluster wa-gap-xs" href="/docs/components/copy-button/">
@@ -101,8 +88,8 @@
         <wa-icon name="flask" aria-hidden="true" class="icon-shrink"></wa-icon>
       </a>
     </li>
-    <li><span class="is-planned wa-split">Data Grid <span><a href="https://github.com/shoelace-style/webawesome/issues/1072" target="_blank">{{ plannedBadge("A Web Awesome Kickstarter stretch goal!") }}</a>{{ proBadge({ description: "This will require access to Web Awesome Pro" }) }}</span></span></li>
-    <li><span class="is-planned wa-split">Date Picker <span><a href="https://github.com/shoelace-style/webawesome/issues/1075" target="_blank">{{ plannedBadge("A Web Awesome Kickstarter stretch goal!") }}</a>{{ proBadge({ description: "This will require access to Web Awesome Pro" }) }}</span></span></li>
+    <li><span class="is-planned wa-split">Data Grid <a href="https://github.com/shoelace-style/webawesome/issues/1072" target="_blank">{{ plannedBadge("A Web Awesome Kickstarter stretch goal!") }}</a></span></li>
+    <li><span class="is-planned wa-split">Datepicker <a href="https://github.com/shoelace-style/webawesome/issues/1075" target="_blank">{{ plannedBadge("A Web Awesome Kickstarter stretch goal!") }}</a></span></li>
     <li><a href="/docs/components/details/">Details</a></li>
     <li><a href="/docs/components/dialog/">Dialog</a></li>
     <li><a href="/docs/components/divider/">Divider</a></li>
@@ -113,7 +100,6 @@
         <li><a href="/docs/components/dropdown-item">Dropdown Item</a></li>
       </ul>
     </li>
-    <li><span class="is-planned wa-split">File Input <span><a href="https://github.com/shoelace-style/webawesome/issues/1240" target="_blank">{{ plannedBadge("A Web Awesome Kickstarter stretch goal!") }}</a>{{ proBadge({ description: "This will require access to Web Awesome Pro" }) }}</span></span></li>
     <li><a href="/docs/components/format-bytes/">Format Bytes</a></li>
     <li><a href="/docs/components/format-date/">Format Date</a></li>
     <li><a href="/docs/components/format-number/">Format Number</a></li>
@@ -122,7 +108,6 @@
     <li><a href="/docs/components/input/">Input</a></li>
     <li><a href="/docs/components/intersection-observer">Intersection Observer</a></li>
     <li><a href="/docs/components/mutation-observer/">Mutation Observer</a></li>
-    <li><span class="is-planned wa-split">Number Input <a href="https://github.com/shoelace-style/webawesome/issues/1688" target="_blank">{{ plannedBadge("A Web Awesome Kickstarter stretch goal!") }}</a></span></li>
     <li><a href="/docs/components/popover/">Popover</a></li>
     <li><a href="/docs/components/popup/">Popup</a></li>
     <li><a href="/docs/components/progress-bar/">Progress Bar</a></li>
@@ -158,15 +143,9 @@
     </li>
     <li><a href="/docs/components/tag/">Tag</a></li>
     <li><a href="/docs/components/textarea/">Textarea</a></li>
-    <li><span class="is-planned wa-split">Toast <span><a href="https://github.com/shoelace-style/webawesome/issues/105" target="_blank">{{ plannedBadge("A Web Awesome Kickstarter stretch goal!") }}</a>{{ proBadge( { description: "This will require access to Web Awesome Pro" }) }}</span></span></li>
     <li><a href="/docs/components/tooltip/">Tooltip</a></li>
-    <li>
-      <a href="/docs/components/tree/">Tree</a>
-      <ul>
-        <li><a href="/docs/components/tree-item/">Tree Item</a></li>
-      </ul>
-    </li>
-    <li><span class="is-planned wa-split">Video <span><a href="https://github.com/shoelace-style/webawesome/issues/985" target="_blank">{{ plannedBadge("A Web Awesome Kickstarter stretch goal!") }}</a>{{ proBadge( { description: "This will require access to Web Awesome Pro" }) }}</span></span></li>
+    <li><a href="/docs/components/tree/">Tree</a></li>
+    <li><a href="/docs/components/tree-item/">Tree Item</a></li>
     <li><a href="/docs/components/zoomable-frame">Zoomable Frame</a></li>
     {# PLOP_NEW_COMPONENT_PLACEHOLDER #}
   </ul>
@@ -200,8 +179,6 @@
   </h2>
   <ul>
     <li><a href="/docs/utilities/align-items/">Align Items</a></li>
-    <!-- Pending 3.2.0 release -->
-    <!-- <li><a href="/docs/utilities/justify-content/">Justify Content</a></li> -->
     <li><a href="/docs/utilities/gap/">Gap</a></li>
     <li><a href="/docs/utilities/cluster/">Cluster</a></li>
     <li><a href="/docs/utilities/flank/">Flank</a></li>
@@ -387,6 +364,9 @@
         <li>
           <a href="/docs/patterns/layouts/ecommerce/">Ecommerce</a>
         </li>
+        <li>
+          <a href="/docs/patterns/layouts/app/">App</a>
+        </li>
         <li>
           <a href="/docs/patterns/layouts/blog/">Blog</a>
         </li>

packages/webawesome/docs/_layouts/blank.njk

@@ -1,5 +1,5 @@
 <!DOCTYPE html>
-<html lang="en" data-fa-kit-code="38c11e3f20" data-version="{{ package.version }}">
+<html lang="en" data-fa-kit-code="38c11e3f20" data-cdn-url="{% cdnUrl %}">
   <head>
     {% include 'head.njk' %}
     {% block head %}{% endblock %}

packages/webawesome/docs/_layouts/component.njk

@@ -8,13 +8,10 @@
     <wa-badge variant="neutral">Since {{ component.since }}</wa-badge>
     <wa-badge
       {% if component.status == 'stable' %}variant="brand"{% endif %}
-      {% if component.status == 'experimental' %}variant="warning" appearance="filled"{% endif %}
+      {% if component.status == 'experimental' %}variant="warning"{% endif %}
     >
       {{ component.status }}
     </wa-badge>
-    {% if isProComponent %}
-      <wa-badge class="pro">Pro</wa-badge>
-    {% endif %}
   </div>
   <p class="component-summary">
     {{ component.summary | inlineMarkdown | safe }}
@@ -23,37 +20,6 @@
 
 {# Component API #}
 {% block afterContent %}
-  {# Importing #}
-  <h2>Importing</h2>
-  <p>
-    Autoloading components via <a href="/docs/#using-a-project">projects</a> is the recommended way to import components. If you prefer to do it manually, use one of the following code snippets.
-  </p>
-
-  {% set componentName = component.tagName | stripPrefix %}
-  {% set componentPath = ["components/", componentName, "/", componentName, ".js"] | join("") %}
-  <wa-tab-group label="How would you like to import this component?">
-    <wa-tab panel="cdn">CDN</wa-tab>
-    <wa-tab panel="npm">npm</wa-tab>
-    <wa-tab panel="react">React</wa-tab>
-    <wa-tab-panel name="cdn">
-      <p>
-        Let your project code do the work! <a href="/signup">Sign up for free</a> to use a project with your very own CDN &mdash; it's the fastest and easiest way to use Web Awesome.
-      </p>
-    </wa-tab-panel>
-    <wa-tab-panel name="npm">
-      <p>
-        To manually import this component from NPM, use the following code.
-      </p>
-      <pre><code class="language-js">import '@awesome.me/webawesome/dist/{{ componentPath }}';</code></pre>
-    </wa-tab-panel>
-    <wa-tab-panel name="react">
-      <p>
-        To manually import this component from React, use the following code.
-      </p>
-      <pre><code class="language-js">import {{ component.name }} from '@awesome.me/webawesome/dist/react/{{ componentName }}';</code></pre>
-    </wa-tab-panel>
-  </wa-tab-group>
-
   {# Slots #}
   {% if component.slots.length %}
     <h2>Slots</h2>
@@ -245,12 +211,7 @@
             <tr>
               <td class="table-name"><code>{{ state.name }}</code></td>
               <td class="table-description">{{ state.description | inlineMarkdown | safe }}</td>
-              <td class="table-selector">
-                <span class="wa-cluster wa-gap-3xs">
-                  <code>:state({{ state.name }})</code>
-                  <wa-copy-button value=":state({{ state.name }})"></wa-copy-button>
-                </span>
-              </td>
+              <td class="table-selector"><code>:state({{ state.name }})</code></td>
             </tr>
           {% endfor %}
         </tbody>
@@ -269,7 +230,6 @@
           <tr>
             <th class="table-name">Name</th>
             <th class="table-description">Description</th>
-            <th class="table-selector">CSS selector</th>
           </tr>
         </thead>
         <tbody>
@@ -277,12 +237,6 @@
             <tr>
               <td class="table-name"><code>{{ cssPart.name }}</code></td>
               <td class="table-description">{{ cssPart.description | inlineMarkdown | safe }}</td>
-              <td class="table-selector">
-                <span class="wa-cluster wa-gap-3xs">
-                  <code>::part({{ cssPart.name }})</code>
-                  <wa-copy-button value="::part({{ cssPart.name }})"></wa-copy-button>
-                </span>
-              </td>
             </tr>
           {% endfor %}
         </tbody>
@@ -304,6 +258,40 @@
     </ul>
   {% endif %}
 
+  {# Importing #}
+  <h2>Importing</h2>
+  <p>
+    The <a href="/docs/#quick-start-autoloading-via-cdn">autoloader</a> is the recommended way to import components. If you prefer to do it manually, use one of the following code snippets.
+  </p>
+
+
+  {% set componentName = component.tagName | stripPrefix %}
+  {% set componentPath = ["components/", componentName, "/", componentName, ".js"] | join("") %}
+  <wa-tab-group label="How would you like to import this component?">
+    <wa-tab panel="cdn">CDN</wa-tab>
+    <wa-tab panel="npm">npm</wa-tab>
+    <wa-tab panel="react">React</wa-tab>
+    <wa-tab-panel name="cdn">
+      <p>
+        To manually import this component from the CDN, use the following code.
+      </p>
+
+      <pre><code class="language-js">import '{% cdnUrl componentPath %}';</code></pre>
+    </wa-tab-panel>
+    <wa-tab-panel name="npm">
+      <p>
+        To manually import this component from NPM, use the following code.
+      </p>
+      <pre><code class="language-js">import '@awesome.me/webawesome/dist/{{ componentPath }}';</code></pre>
+    </wa-tab-panel>
+    <wa-tab-panel name="react">
+      <p>
+        To manually import this component from React, use the following code.
+      </p>
+      <pre><code class="language-js">import {{ component.name }} from '@awesome.me/webawesome/dist/react/{{ componentName }}';</code></pre>
+    </wa-tab-panel>
+  </wa-tab-group>
+
   <wa-divider></wa-divider>
 
   <div class="component-help">

packages/webawesome/docs/_transformers/anchor-headings.js

@@ -35,23 +35,9 @@ export function anchorHeadingsTransformer(options = {}) {
       return doc;
     }
 
-    // Check if the document or container has data-no-anchor (view-level)
-    const hasNoAnchorOnDocument = doc.querySelector('html')?.hasAttribute('data-no-anchor') || false;
-    const hasNoAnchorOnContainer = container.closest('[data-no-anchor]') !== null;
-
-    // If view-level data-no-anchor is set, skip processing all headings
-    if (hasNoAnchorOnDocument || hasNoAnchorOnContainer) {
-      return doc;
-    }
-
-    // Look for headings (selector excludes headings with data-no-anchor attribute)
-    let selector = `:is(${options.headingSelector}):not([data-no-anchor])`;
+    // Look for headings
+    let selector = `:is(${options.headingSelector}):not([data-no-anchor], [data-no-anchor] *)`;
     container.querySelectorAll(selector).forEach(heading => {
-      // Skip if heading is a descendant of an element with data-no-anchor
-      // (selector already excludes headings with the attribute directly)
-      if (heading.closest('[data-no-anchor]') !== null) {
-        return;
-      }
       const hasAnchor = heading.querySelector('a');
       const existingId = heading.getAttribute('id');
       const clone = parse(heading.outerHTML);
@@ -79,7 +65,7 @@ export function anchorHeadingsTransformer(options = {}) {
       const anchor = parse(`
         <a href="#${encodeURIComponent(id)}">
           <span class="wa-visually-hidden"></span>
-          <wa-icon variant="regular" name="hashtag" class="icon-shrink"></wa-icon>
+          <span aria-hidden="true">#</span>
         </a>
       `);
       anchor.querySelector('.wa-visually-hidden').textContent = options.anchorLabel;

packages/webawesome/docs/_utils/manifest.js

@@ -11,7 +11,6 @@ export function getComponents() {
   const manifest = JSON.parse(readFileSync(join(distDir, 'custom-elements.json'), 'utf-8'));
   const components = [];
 
-  const sortByName = (a, b) => (a.name || '').localeCompare(b.name || '');
   manifest.modules?.forEach(module => {
     module.declarations?.forEach(declaration => {
       if (declaration.customElement) {
@@ -19,16 +18,7 @@ export function getComponents() {
         declaration.path = module.path.replace(/^src\//, 'dist/').replace(/\.ts$/, '.js');
 
         // Remove private members and those that lack a description
-        const slots = declaration.slots?.sort(sortByName);
-        const events = declaration.events?.sort(sortByName);
-        const cssProperties = declaration.cssProperties?.sort(sortByName);
-        const cssParts = declaration.cssParts?.sort(sortByName);
-        const cssStates = declaration.cssStates?.sort(sortByName);
-        const dependencies = declaration.dependencies?.sort((a, b) => a.localeCompare(b));
-
-        const members = declaration.members
-          ?.filter(member => member.description && member.privacy !== 'private')
-          ?.sort(sortByName);
+        const members = declaration.members?.filter(member => member.description && member.privacy !== 'private');
         const methods = members?.filter(prop => prop.kind === 'method' && prop.privacy !== 'private');
         const properties = members?.filter(prop => {
           // Look for a corresponding attribute
@@ -41,12 +31,6 @@ export function getComponents() {
         });
         components.push({
           ...declaration,
-          slots,
-          events,
-          cssProperties,
-          cssStates,
-          cssParts,
-          dependencies,
           methods,
           properties,
         });

packages/webawesome/docs/_utils/simulate-webawesome-app.js

@@ -1,20 +1,10 @@
-import * as path from 'node:path';
 import nunjucks from 'nunjucks';
 
-const baseDir = process.env.BASE_DIR || 'docs';
-
-const views = [path.join(baseDir), path.join(baseDir, '_layouts'), path.join(baseDir, '_includes')];
-
-const nunjucksEnv = new nunjucks.Environment(new nunjucks.FileSystemLoader(views), {
-  autoescape: true,
-  noCache: process.env.NODE_ENV === 'development' || process.env.NODE_ENV === 'test',
-});
-
 /**
  * This function simulates what a server would do running "on top" of eleventy.
  */
 export function SimulateWebAwesomeApp(str) {
-  return nunjucksEnv.renderString(str, {
+  return nunjucks.renderString(str, {
     // Stub the server EJS shortcodes.
     currentUser: {
       hasPro: false,

packages/webawesome/docs/assets/images/app-icons/app-icon.svg

@@ -1 +0,0 @@
-<svg fill="none" height="32" viewBox="0 0 32 32" width="32" xmlns="http://www.w3.org/2000/svg"><path clip-rule="evenodd" d="m18.608 5.8c0 1.04658-.6184 1.94874-1.5097 2.36103l5.3017 4.63897 5.2196-1.0439c-.2647-.3858-.4196-.8529-.4196-1.3561 0-1.32548 1.0745-2.4 2.4-2.4s2.4 1.07452 2.4 2.4c0 1.3085-1.0471 2.3724-2.3491 2.3995l-5.7878 12.3578c-.5267 1.1245-1.6562 1.8427-2.8979 1.8427h-9.9303c-1.2417 0-2.37129-.7182-2.89794-1.8427l-5.78784-12.3578c-1.30199-.0271-2.34912-1.091-2.34912-2.3995 0-1.32548 1.07452-2.4 2.4-2.4s2.4 1.07452 2.4 2.4c0 .5032-.15488.9703-.41957 1.3561l5.21957 1.0439 5.3072-4.64383c-.8857-.4145-1.4992-1.31368-1.4992-2.35617 0-1.43594 1.1641-2.6 2.6-2.6s2.6 1.16406 2.6 2.6z" fill="#f36944" fill-rule="evenodd"/></svg>

packages/webawesome/docs/assets/images/app-icons/icon.svg

@@ -1 +0,0 @@
-<svg fill="none" height="32" viewBox="0 0 32 32" width="32" xmlns="http://www.w3.org/2000/svg"><path clip-rule="evenodd" d="m18.608 5.8c0 1.04658-.6184 1.94874-1.5097 2.36103l5.3017 4.63897 5.2196-1.0439c-.2647-.3858-.4196-.8529-.4196-1.3561 0-1.32548 1.0745-2.4 2.4-2.4s2.4 1.07452 2.4 2.4c0 1.3085-1.0471 2.3724-2.3491 2.3995l-5.7878 12.3578c-.5267 1.1245-1.6562 1.8427-2.8979 1.8427h-9.9303c-1.2417 0-2.37129-.7182-2.89794-1.8427l-5.78784-12.3578c-1.30199-.0271-2.34912-1.091-2.34912-2.3995 0-1.32548 1.07452-2.4 2.4-2.4s2.4 1.07452 2.4 2.4c0 .5032-.15488.9703-.41957 1.3561l5.21957 1.0439 5.3072-4.64383c-.8857-.4145-1.4992-1.31368-1.4992-2.35617 0-1.43594 1.1641-2.6 2.6-2.6s2.6 1.16406 2.6 2.6z" fill="#f36944" fill-rule="evenodd"/></svg>

packages/webawesome/docs/assets/images/web-awesome-mark-black.svg

@@ -0,0 +1,3 @@
+<svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M11.63 3.625C11.63 4.27911 11.2435 4.84296 10.6865 5.10064L14 8L17.2622 7.34755C17.0968 7.10642 17 6.81452 17 6.5C17 5.67157 17.6716 5 18.5 5C19.3284 5 20 5.67157 20 6.5C20 7.31157 19.3555 7.9726 18.5504 7.99917L15.0307 15.8207C14.7077 16.5384 13.9939 17 13.2068 17H6.79317C6.00615 17 5.29229 16.5384 4.96933 15.8207L1.44963 7.99917C0.64452 7.9726 0 7.31157 0 6.5C0 5.67157 0.671573 5 1.5 5C2.32843 5 3 5.67157 3 6.5C3 6.81452 2.9032 7.10642 2.73777 7.34755L6 8L9.31702 5.09761C8.76346 4.83855 8.38 4.27656 8.38 3.625C8.38 2.72754 9.10754 2 10.005 2C10.9025 2 11.63 2.72754 11.63 3.625Z" fill="currentColor"/>
+</svg>

packages/webawesome/docs/assets/images/webawesome-logo.svg

@@ -0,0 +1,3 @@
+<svg width="20" height="15" viewBox="0 0 20 15" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M11.63 1.625C11.63 2.27911 11.2435 2.84296 10.6865 3.10064L14 6L17.2622 5.34755C17.0968 5.10642 17 4.81452 17 4.5C17 3.67157 17.6716 3 18.5 3C19.3284 3 20 3.67157 20 4.5C20 5.31157 19.3555 5.9726 18.5504 5.99917L15.0307 13.8207C14.7077 14.5384 13.9939 15 13.2068 15H6.79317C6.00615 15 5.29229 14.5384 4.96933 13.8207L1.44963 5.99917C0.64452 5.9726 0 5.31157 0 4.5C0 3.67157 0.671573 3 1.5 3C2.32843 3 3 3.67157 3 4.5C3 4.81452 2.9032 5.10642 2.73777 5.34755L6 6L9.31702 3.09761C8.76346 2.83855 8.38 2.27656 8.38 1.625C8.38 0.727537 9.10754 0 10.005 0C10.9025 0 11.63 0.727537 11.63 1.625Z" fill="var(--wa-brand-orange, #f36944)"/>
+</svg>

packages/webawesome/docs/assets/scripts/code-examples.js

@@ -1,6 +1,3 @@
-const version = document.documentElement.getAttribute('data-version') || '';
-const CDN_URL = `https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@${version}/dist-cdn/`;
-
 //
 // Resizing previews
 //
@@ -57,9 +54,10 @@ document.addEventListener('click', event => {
   if (pen) {
     const codeExample = pen.closest('.code-example');
     const code = codeExample.querySelector('code');
+    const cdnUrl = document.documentElement.dataset.cdnUrl;
     const html =
-      `<script data-fa-kit-code="38c11e3f20" type="module" src="${CDN_URL}webawesome.loader.js"></script>\n` +
-      `<link rel="stylesheet" href="${CDN_URL}styles/webawesome.css">\n\n` +
+      `<script data-fa-kit-code="38c11e3f20" type="module" src="${cdnUrl}webawesome.loader.js"></script>\n` +
+      `<link rel="stylesheet" href="${cdnUrl}styles/webawesome.css">\n\n` +
       `${code.textContent}`;
     const css = 'html > body {\n  padding: 2rem !important;\n}';
     const js = '';

packages/webawesome/docs/assets/scripts/search.js

@@ -1,24 +1,11 @@
 // Search data
-const version = document.documentElement.getAttribute('data-version') || '';
-const res = await Promise.all([
-  import('https://cdn.jsdelivr.net/npm/lunr/+esm'),
-  fetch(`/search.json?v=${version}`),
-  import('/assets/scripts/track.js').catch(() => null),
-]);
+const res = await Promise.all([import('https://cdn.jsdelivr.net/npm/lunr/+esm'), fetch('/search.json')]);
 const lunr = res[0].default;
 const searchData = await res[1].json();
 const searchIndex = lunr.Index.load(searchData.searchIndex);
 const map = searchData.map;
 const searchDebounce = 200;
-const queryTrackDelay = 1000;
 let searchTimeout;
-let queryTrackTimeout;
-let lastTrackedQuery = '';
-let resultSelected = false;
-
-// Optional event tracking - works standalone if track.js isn't available
-const trackModule = res[2];
-const trackEvent = trackModule?.trackEvent || window.trackEvent || (() => {});
 
 // We're using Turbo, so references to these elements aren't guaranteed to remain intact
 function getElements() {
@@ -29,24 +16,6 @@ function getElements() {
   };
 }
 
-function trackQuerySubmit(query, resultSelectedValue) {
-  if (!query || query.length === 0) return;
-
-  const { results } = getElements();
-  if (!results) return;
-
-  const matches = results.querySelectorAll('li').length;
-  const truncatedQuery = query.length > 500 ? query.substring(0, 500) : query;
-
-  trackEvent('navigation:search_query_submit', {
-    query: truncatedQuery,
-    query_length: query.length,
-    result_count: matches,
-    has_results: matches > 0,
-    result_selected: resultSelectedValue,
-  });
-}
-
 // Show the search dialog when slash (or CMD+K) is pressed and focus is not inside a form element
 document.addEventListener('keydown', event => {
   if (
@@ -72,98 +41,40 @@ document.addEventListener('click', event => {
 
 function show() {
   const { dialog, input, results } = getElements();
-  if (!dialog || !input || !results) return;
 
-  const wasAlreadyOpen = dialog.open;
-
-  // Remove existing listeners before adding to prevent duplicates
-  input.removeEventListener('input', handleInput);
-  results.removeEventListener('click', handleSelection);
-  dialog.removeEventListener('keydown', handleKeyDown);
-  dialog.removeEventListener('wa-hide', handleClose);
-  resultSelected = false;
-  lastTrackedQuery = '';
   input.addEventListener('input', handleInput);
   results.addEventListener('click', handleSelection);
   dialog.addEventListener('keydown', handleKeyDown);
   dialog.addEventListener('wa-hide', handleClose);
   dialog.open = true;
-  if (!wasAlreadyOpen) {
-    trackEvent('navigation:search_dialog_open');
-  }
 }
 
-function cleanup() {
+function hide() {
   const { dialog, input, results } = getElements();
-  if (!dialog || !input || !results) return;
-  clearTimeout(searchTimeout);
-  clearTimeout(queryTrackTimeout);
+
   input.removeEventListener('input', handleInput);
   results.removeEventListener('click', handleSelection);
   dialog.removeEventListener('keydown', handleKeyDown);
   dialog.removeEventListener('wa-hide', handleClose);
-
-  // Reset state to prevent leakage between dialog sessions
-  resultSelected = false;
-  lastTrackedQuery = '';
+  dialog.open = false;
 }
 
-async function handleClose() {
-  const { dialog, input } = getElements();
-  if (!dialog || !input) return;
-  clearTimeout(queryTrackTimeout);
-  queryTrackTimeout = null;
-  dialog.removeEventListener('wa-hide', handleClose);
-  if (!resultSelected) {
-    const query = input.value.trim();
-    if (query.length > 0 && query !== lastTrackedQuery) {
-      trackQuerySubmit(query, false);
-      lastTrackedQuery = query;
-    }
-  }
+function handleClose() {
+  const { input } = getElements();
 
   input.value = '';
-  try {
-    await updateResults();
-  } catch (error) {
-    // Silently handle errors - UI cleanup should continue
-  }
-  cleanup();
-  trackEvent('navigation:search_dialog_close');
+  updateResults();
 }
 
 function handleInput() {
   const { input } = getElements();
-  if (!input) return;
+
   clearTimeout(searchTimeout);
-  clearTimeout(queryTrackTimeout);
-
-  const query = input.value.trim();
-
-  if (query.length === 0) {
-    lastTrackedQuery = '';
-  }
-
-  searchTimeout = setTimeout(async () => {
-    await updateResults(query);
-    if (query.length > 0 && query !== lastTrackedQuery) {
-      queryTrackTimeout = setTimeout(() => {
-        const { input: currentInput, results } = getElements();
-        if (!currentInput || resultSelected) return;
-
-        const currentQuery = currentInput.value.trim();
-        if (currentQuery === query && currentQuery !== lastTrackedQuery) {
-          trackQuerySubmit(currentQuery, false);
-          lastTrackedQuery = currentQuery;
-        }
-      }, queryTrackDelay);
-    }
-  }, searchDebounce);
+  searchTimeout = setTimeout(() => updateResults(input.value), searchDebounce);
 }
 
 function handleKeyDown(event) {
   const { input, results } = getElements();
-  if (!input || !results) return;
 
   // Handle keyboard selections
   if (['ArrowDown', 'ArrowUp', 'Home', 'End', 'Enter'].includes(event.key)) {
@@ -192,12 +103,7 @@ function handleKeyDown(event) {
         nextEl = items[items.length - 1];
         break;
       case 'Enter':
-        if (currentEl) {
-          const link = currentEl.querySelector('a');
-          if (link) {
-            selectResult(link, 'keyboard_enter');
-          }
-        }
+        currentEl?.querySelector('a')?.click();
         break;
     }
 
@@ -214,62 +120,27 @@ function handleKeyDown(event) {
   }
 }
 
-function selectResult(link, selectionMethod) {
-  const { input, results } = getElements();
-  if (!input || !link) return;
-
-  // Clear pending query tracking timeout to prevent duplicate events
-  clearTimeout(queryTrackTimeout);
-  queryTrackTimeout = null;
-  resultSelected = true; // Set immediately so timeout callback (if executing) sees it
-
-  const query = input.value.trim();
-  if (!link.dataset.searchResultIndex) return;
-  const resultIndex = parseInt(link.dataset.searchResultIndex, 10);
-  if (isNaN(resultIndex) || resultIndex < 1) return;
-
-  const resultUrl = link.dataset.searchResultUrl || link.getAttribute('href');
-  if (!resultUrl) return;
-  lastTrackedQuery = query;
-  trackQuerySubmit(query, true);
-  trackEvent('navigation:search_result_click', {
-    query,
-    result_index: resultIndex,
-    result_url: resultUrl,
-    selection_method: selectionMethod,
-  });
-
-  const { dialog } = getElements();
-  if (dialog) {
-    dialog.removeEventListener('wa-hide', handleClose);
-    cleanup();
-    trackEvent('navigation:search_dialog_close');
-    dialog.open = false;
-  }
-
-  if (window.Turbo) {
-    Turbo.visit(resultUrl);
-  } else {
-    location.href = resultUrl;
-  }
-}
-
 function handleSelection(event) {
   const link = event.target.closest('a');
 
   if (link) {
     event.preventDefault();
-    selectResult(link, 'mouse_click');
+    hide();
+
+    if (window.Turbo) {
+      Turbo.visit(link.href);
+    } else {
+      location.href = link.href;
+    }
   }
 }
 
 // Queries the search index and updates the results
 async function updateResults(query = '') {
   const { dialog, input, results } = getElements();
-  if (!dialog || !input || !results) return;
+
   try {
-    const trimmedQuery = query.trim();
-    const hasQuery = trimmedQuery.length > 0;
+    const hasQuery = query.length > 0;
     let matches = [];
 
     if (hasQuery) {
@@ -277,13 +148,13 @@ async function updateResults(query = '') {
       const seenRefs = new Set();
 
       // Start with a standard search to get the best "exact match" result
-      searchIndex.search(`${trimmedQuery}`).forEach(match => {
+      searchIndex.search(`${query}`).forEach(match => {
         matches.push(match);
         seenRefs.add(match.ref);
       });
 
       // Add wildcard matches if not already included
-      searchIndex.search(`${trimmedQuery}*`).forEach(match => {
+      searchIndex.search(`${query}*`).forEach(match => {
         if (!seenRefs.has(match.ref)) {
           matches.push(match);
           seenRefs.add(match.ref);
@@ -291,10 +162,11 @@ async function updateResults(query = '') {
       });
 
       // Add fuzzy search matches last
-      const fuzzyTokens = trimmedQuery
+      const fuzzyTokens = query
         .split(' ')
         .map(term => `${term}~1`)
         .join(' ');
+
       searchIndex.search(fuzzyTokens).forEach(match => {
         if (!seenRefs.has(match.ref)) {
           matches.push(match);
@@ -307,12 +179,12 @@ async function updateResults(query = '') {
 
     dialog.classList.toggle('has-results', hasQuery && hasResults);
     dialog.classList.toggle('no-results', hasQuery && !hasResults);
+
     input.setAttribute('aria-activedescendant', '');
     results.innerHTML = '';
+
     matches.forEach((match, index) => {
       const page = map[match.ref];
-      if (!page || !page.url) return;
-
       const li = document.createElement('li');
       const a = document.createElement('a');
       const displayTitle = page.title ?? '';
@@ -324,10 +196,12 @@ async function updateResults(query = '') {
       li.setAttribute('role', 'option');
       li.setAttribute('id', `search-result-item-${match.ref}`);
       li.setAttribute('data-selected', index === 0 ? 'true' : 'false');
+
       if (page.url === '/') icon = 'home';
       if (page.url.startsWith('/docs/utilities/native')) icon = 'code';
       if (page.url.startsWith('/docs/components')) icon = 'puzzle-piece';
       if (page.url.startsWith('/docs/theme') || page.url.startsWith('/docs/restyle')) icon = 'palette';
+
       a.href = page.url;
       a.innerHTML = `
         <div class="site-search-result-icon" aria-hidden="true">
@@ -343,9 +217,6 @@ async function updateResults(query = '') {
       a.querySelector('.site-search-result-description').textContent = displayDescription;
       a.querySelector('.site-search-result-url').textContent = displayUrl;
 
-      // Use 1-based indexing for analytics
-      a.dataset.searchResultIndex = (index + 1).toString();
-      a.dataset.searchResultUrl = page.url;
       li.appendChild(a);
       results.appendChild(li);
     });

packages/webawesome/docs/assets/styles/code-highlighter.css

@@ -2,25 +2,22 @@
 pre[id*='code-block-'] {
   color-scheme: dark;
   color: white;
-  background-color: var(--code-background, var(--wa-color-neutral-20));
+  background-color: var(--wa-color-neutral-20);
 
   /* Ensures a discernible background color in dark mode
    * Useful for themes that use gray-20 as --wa-color-surface-default  */
   .wa-dark & {
-    background-color: var(--code-background-dark, var(--wa-color-surface-lowered));
+    background-color: var(--wa-color-surface-lowered);
   }
 }
 
 .code-comment,
 .code-prolog,
 .code-doctype,
-.code-cdata {
-  color: var(--code-comment, var(--wa-color-gray-70));
-}
-
+.code-cdata,
 .code-operator,
 .code-punctuation {
-  color: var(--code-operator, var(--wa-color-gray-70));
+  color: var(--wa-color-gray-70);
 }
 
 .code-namespace {
@@ -31,27 +28,24 @@ pre[id*='code-block-'] {
 .code-keyword,
 .code-tag,
 .code-url {
-  color: var(--code-keyword, var(--wa-color-indigo-70));
+  color: var(--wa-color-indigo-70);
 }
 
 .code-symbol,
 .code-deleted,
 .code-important {
-  color: var(--code-error, var(--wa-color-red-70));
-}
-
-.code-string,
-.code-char,
-.code-constant {
-  color: var(--code-string, var(--wa-color-green-70));
+  color: var(--wa-color-red-70);
 }
 
 .code-boolean,
+.code-constant,
 .code-selector,
 .code-attr-name,
+.code-string,
+.code-char,
 .code-builtin,
 .code-inserted {
-  color: var(--code-literal, var(--wa-color-green-70));
+  color: var(--wa-color-green-70);
 }
 
 .code-atrule,
@@ -61,7 +55,7 @@ pre[id*='code-block-'] {
 .code-function,
 .code-class-name,
 .code-regex {
-  color: var(--code-value, var(--wa-color-blue-70));
+  color: var(--wa-color-blue-70);
 }
 
 .code-important,

packages/webawesome/docs/assets/styles/docs.css

@@ -10,13 +10,6 @@
 :root {
   --wa-brand-orange: #f36944;
   --wa-brand-grey: #30323b;
-
-  /* layout-based example style aspects */
-  --layout-example-border: var(--wa-border-width-s) dashed var(--wa-color-neutral-border-normal);
-  --layout-example-border-radius: var(--wa-border-radius-l);
-  --layout-example-padding: var(--wa-space-s);
-  --layout-example-element-background: var(--wa-color-indigo-60);
-  --layout-example-element-border-radius: var(--wa-border-radius-m);
 }
 
 .wa-dark .only-light,
@@ -34,61 +27,6 @@ body.theme-transitioning {
   transition: opacity 200ms ease-out;
 }
 
-/* banner */
-wa-page > [slot='banner'] {
-  padding: var(--wa-space-0);
-
-  .banner-content {
-    /* match docs header padding-inline by default */
-    padding-inline: var(--wa-space-xl);
-    padding-block: var(--wa-space-m);
-  }
-
-  &.banner-wa-launch {
-    /* custom brand colors carried over from theme-site for the banner */
-    --wa-color-brand-95: #fef0ec;
-    --wa-color-brand-90: #fce0d8;
-    --wa-color-brand-80: #f8bcac;
-    --wa-color-brand-70: #fa9378;
-    --wa-color-brand-60: #f46a45;
-    --wa-color-brand-50: #cb4b27;
-    --wa-color-brand-40: #9d371a;
-    --wa-color-brand-30: #7c2a13;
-    --wa-color-brand-20: #5d1d0b;
-    --wa-color-brand-10: #3b0f05;
-    --wa-color-brand-05: #270802;
-    --wa-color-brand: var(--wa-color-brand-60);
-    --wa-color-brand-on: var(--wa-color-brand-10);
-
-    .banner-icon {
-      color: var(--wa-color-brand-fill-loud);
-      font-size: var(--wa-font-size-xl);
-    }
-
-    .appearance-underlined.variant-drawn {
-      --underline-color: var(--wa-color-brand);
-    }
-  }
-}
-
-/* Site-Wide Dialog */
-#dialog-site {
-  /* custom brand colors carrried over from theme-site for the banner */
-  --wa-color-brand-95: #fef0ec;
-  --wa-color-brand-90: #fce0d8;
-  --wa-color-brand-80: #f8bcac;
-  --wa-color-brand-70: #fa9378;
-  --wa-color-brand-60: #f46a45;
-  --wa-color-brand-50: #cb4b27;
-  --wa-color-brand-40: #9d371a;
-  --wa-color-brand-30: #7c2a13;
-  --wa-color-brand-20: #5d1d0b;
-  --wa-color-brand-10: #3b0f05;
-  --wa-color-brand-05: #270802;
-  --wa-color-brand: var(--wa-color-brand-60);
-  --wa-color-brand-on: var(--wa-color-brand-10);
-}
-
 /* Header */
 wa-page::part(header) {
   background-color: var(--wa-color-surface-default);
@@ -376,6 +314,26 @@ h1.title {
   }
 }
 
+/* Anchor headings */
+.anchor-heading a {
+  visibility: hidden;
+  text-decoration: none;
+}
+
+@media (hover: hover) {
+  .anchor-heading:hover a {
+    visibility: visible;
+    padding: 0 0.125em;
+  }
+}
+
+@media print {
+  /* Show URLs for printed links */
+  a:not(.anchor-heading)[href]::after {
+    content: ' (' attr(href) ')';
+  }
+}
+
 /* Callouts */
 .callout {
   display: flex;
@@ -670,10 +628,6 @@ wa-scroller:has(.component-table) {
     min-width: var(--line-length-xs);
   }
 
-  .table-selector .wa-cluster {
-    flex-wrap: nowrap;
-  }
-
   .table-reflect {
     text-align: center;
   }

packages/webawesome/docs/assets/styles/search.css

@@ -5,6 +5,7 @@
   border-radius: var(--wa-border-radius-l);
   padding: 0;
   margin: 0 auto;
+  overflow: hidden;
 
   &::part(dialog) {
     margin-block-start: 10vh;

packages/webawesome/docs/assets/styles/utils.css

@@ -70,8 +70,9 @@
   /* #region shared UI */
   /* pro badge */
   wa-badge.pro {
-    color: var(--wa-color-brand-on-loud);
+    color: white;
     background-color: var(--wa-brand-orange);
+    border-color: var(--wa-brand-orange);
 
     + wa-tooltip {
       font-size: var(--wa-font-size-xs);
@@ -79,14 +80,6 @@
     }
   }
 
-  /* free badge */
-  wa-badge.free {
-    + wa-tooltip {
-      font-size: var(--wa-font-size-xs);
-      --max-width: unset;
-    }
-  }
-
   /* planned badge */
   wa-badge.planned {
     background-color: var(--wa-color-neutral-fill-quiet);
@@ -130,61 +123,10 @@
     }
   }
 
-  /* dialogs */
-  wa-dialog:has([slot='footer']) [slot='footer'] {
-    border-block-start: var(--wa-border-width-s) solid var(--wa-color-surface-border);
-    flex-grow: 1; /* make footer contents span entire width of dialog */
-    padding-block-start: var(--wa-space-l);
-  }
-
-  /* anchor headings  */
-  .anchor-heading a {
-    opacity: 0;
-    visibility: hidden;
-    text-decoration: none;
-    transition: opacity var(--wa-transition-normal) var(--wa-transition-easing);
-  }
-
-  @media (hover: hover) {
-    .anchor-heading:hover a {
-      opacity: 1;
-      visibility: visible;
-      padding: var(--wa-space-3xs);
-    }
-  }
-
-  @media print {
-    /* show URLs for printed links */
-    a:not(.anchor-heading)[href]::after {
-      content: ' (' attr(href) ')';
-    }
-  }
   /* #endregion */
 
   /* #region funsies + cosmetics */
 
-  /* decorative underline emphasis */
-  .appearance-underlined.variant-drawn {
-    --underline-color: currentColor;
-    position: relative;
-    text-decoration: none;
-    padding-bottom: 0.4em;
-
-    &::after {
-      content: '';
-      position: absolute;
-      left: 0;
-      bottom: 0;
-      width: 100%;
-      height: 0.4em;
-      mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 20'%3E%3Cpath d='M0,12 Q50,8 100,12' stroke='black' stroke-width='4' fill='none'/%3E%3C/svg%3E");
-      mask-repeat: no-repeat;
-      mask-size: 100% auto;
-      mask-position: 0 100%;
-      background-color: var(--underline-color);
-    }
-  }
-
   /* grid background */
   .background-grid {
     --grid-spacing: var(--wa-space-2xl);
@@ -257,6 +199,7 @@
       z-index: 0;
     }
   }
+  /* #endregion */
 
   /* buttons with icon toggle on hover */
   wa-button .icon-hover {
@@ -268,13 +211,6 @@
   wa-button:hover .icon-hover {
     display: inline-flex;
   }
-
-  /* buttons that are "shushed" (visually muted) by default, but have their full presentation otherwise  */
-  wa-button.shush {
-    &:not(:hover):not(active)::part(base) {
-      color: var(--wa-color-text-quiet);
-    }
-  }
   /* #endregion */
 
   /* #region resets */

packages/webawesome/docs/docs/color-palettes.njk

@@ -66,71 +66,14 @@ layout: page
 </div>
 
 <h2>Using This Palette</h2>
-
 <div id="import-code">
   {% for palette in themer.palettes %}
-    <div class="palette-instructions" data-palette="{{ palette.name | lower }}" {% if not loop.first %}hidden{% endif %}>
-      <wa-tab-group>
-        <wa-tab panel="cdn"><wa-icon name="rocket-launch" variant="regular"></wa-icon> CDN</wa-tab>
-        <wa-tab panel="npm"><wa-icon name="box-open" variant="regular"></wa-icon> npm</wa-tab>
-        <wa-tab panel="self-hosted"><wa-icon name="arrow-down-to-line" variant="regular"></wa-icon> Self-Hosted</wa-tab>
-
-        <wa-tab-panel name="cdn">
-{% markdown %}
-{% if palette.isPro %}
-<wa-callout variant="neutral" size="small">
-  <wa-icon name="info-circle" variant="regular"></wa-icon>
-  This palette can only be used on teams with a Pro subscription.
-</wa-callout>
-<br />
-{% else %}
-**For projects on Free teams:**
-1. Head over to your project's <wa-icon name="gear" variant="regular"></wa-icon> **Settings**.
-2. Find **Color Palette**. Select <wa-icon name="swatchbook" variant="regular"></wa-icon> **{{ palette.name | capitalize }}**.
-3. Save your theme to immediately update anywhere you're using your project.
-{% endif %}
-
-**For projects on Pro teams:**
-1. Head over to your project's <wa-icon name="gear" variant="regular"></wa-icon> **Settings**.
-2. Press <wa-icon name="paintbrush" variant="regular"></wa-icon> **Edit Your Theme** to open the Theme Builder.
-3. Open **Colors** and select **{{ palette.name | capitalize }}**.
-4. Save your theme to immediately update anywhere you're using your project.
-{% endmarkdown %}
-        </wa-tab-panel>
-
-        <wa-tab-panel name="npm">
-{% markdown %}
-To use this theme, import the theme's stylesheet:
-
-```js
-import '@awesome.me/webawesome/dist/styles/themes/{{ palette.filename }}';
-```
-
-Then apply the following class to the `<html>` element:
-
-```html
-<html class="wa-palette-{{ palette.name | lower }}">
-```
-{% endmarkdown %}
-        </wa-tab-panel>
-
-        <wa-tab-panel name="self-hosted">
-{% markdown %}
-To use this theme, include the theme's stylesheet:
-
-```html
-<link rel="stylesheet" href="/dist/styles/themes/{{ palette.filename }}" />
-```
-
-Then apply the following class to the `<html>` element:
-
-```html
-<html class="wa-palette-{{ palette.name | lower }}">
-```
-{% endmarkdown %}
-        </wa-tab-panel>
-      </wa-tab-group>
-    </div>
+  <div class="palette-instructions" data-palette="{{ palette.name | lower }}" {% if not loop.first %}hidden{% endif %}>
+    <p>
+      To import this palette, set <code>&lt;html class=&quot;wa-palette-{{ palette.name | lower }}&quot;&gt;</code> and import the following stylesheet:
+    </p>
+    <pre><code class="language-html">&lt;link rel=&quot;stylesheet&quot; href=&quot;{% cdnUrl %}styles/color/palettes/{{ palette.filename }}&quot; /&gt;</code></pre>
+  </div>
   {% endfor %}
 </div>
 
@@ -178,7 +121,6 @@ Then apply the following class to the `<html>` element:
       display: flex;
       flex-direction: row;
       flex-wrap: wrap;
-      gap: var(--wa-space-m);
     }
 
     &::part(form-control-label) {
@@ -191,11 +133,7 @@ Then apply the following class to the `<html>` element:
       overflow: hidden;
       white-space: nowrap;
       padding: 0;
-    }
-
-    wa-radio {
-      margin-inline: 0;
-    }
+   }
   }
 
   .palette-card {

packages/webawesome/docs/docs/components/button-group.md

@@ -40,6 +40,60 @@ Set the `orientation` attribute to `vertical` to make a vertical button group.
 </wa-button-group>
 ```
 
+### Theme Buttons
+
+Theme buttons are supported through the button group's `variant` attribute.
+
+```html {.example}
+<wa-button-group label="Alignment" variant="brand">
+  <wa-button>Left</wa-button>
+  <wa-button>Center</wa-button>
+  <wa-button>Right</wa-button>
+</wa-button-group>
+
+<br /><br />
+
+<wa-button-group label="Alignment" variant="success">
+  <wa-button>Left</wa-button>
+  <wa-button>Center</wa-button>
+  <wa-button>Right</wa-button>
+</wa-button-group>
+
+<br /><br />
+
+<wa-button-group label="Alignment">
+  <wa-button>Left</wa-button>
+  <wa-button>Center</wa-button>
+  <wa-button>Right</wa-button>
+</wa-button-group>
+
+<br /><br />
+
+<wa-button-group label="Alignment" variant="warning">
+  <wa-button>Left</wa-button>
+  <wa-button>Center</wa-button>
+  <wa-button>Right</wa-button>
+</wa-button-group>
+
+<br /><br />
+
+<wa-button-group label="Alignment" variant="danger">
+  <wa-button>Left</wa-button>
+  <wa-button>Center</wa-button>
+  <wa-button>Right</wa-button>
+</wa-button-group>
+```
+
+You can still use the buttons’ own `variant` attribute to override the inherited variant.
+
+```html {.example}
+<wa-button-group label="Alignment" variant="brand">
+  <wa-button>Left</wa-button>
+  <wa-button>Center</wa-button>
+  <wa-button variant="neutral">Right</wa-button>
+</wa-button-group>
+```
+
 ### Pill Buttons
 
 Pill buttons are supported through the button's `pill` attribute.
@@ -87,7 +141,7 @@ Dropdowns can be placed into button groups.
 
 ### Split Buttons
 
-Create a split button using a button and a dropdown. Use a [visually hidden](/docs/utilities/visually-hidden) label to ensure the dropdown is accessible to users with assistive devices.
+Create a split button using a button and a dropdown. Use a [visually hidden](/docs/components/visually-hidden) label to ensure the dropdown is accessible to users with assistive devices.
 
 ```html {.example}
 <wa-button-group label="Example Button Group">

packages/webawesome/docs/docs/components/card.md

@@ -100,20 +100,19 @@ If using SSR, you need to also use the `with-media` attribute to add a media sec
 ```html {.example}
 <div class="wa-grid">
   <wa-card class="card-media">
-    <div slot="media" class="wa-frame:landscape">
-      <img
-        src="https://images.unsplash.com/photo-1547191783-94d5f8f6d8b1?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=400&q=80"
-        alt="A kitten walks towards camera on top of pallet."
-      />
-    </div>
-    This card has an image of a kitten walking along a pallet. 
+    <img
+      slot="media"
+      src="https://images.unsplash.com/photo-1547191783-94d5f8f6d8b1?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=400&q=80"
+      alt="A kitten walks towards camera on top of pallet."
+    />
+    This is a kitten, but not just any kitten. This kitten likes walking along pallets.
   </wa-card>
   <wa-card class="card-media">
     <video slot="media" controls>
       <source src="https://uploads.webawesome.com/dog-with-glasses.mp4" />
       <p>Your browser doesn't support HTML video</p>
     </video>
-    This card has a video of a dog wearing shades.
+    This is a kitten, but not just any kitten. This kitten likes walking along pallets.
   </wa-card>
 </div>
 
@@ -154,10 +153,10 @@ Use the `appearance` attribute to change the card's visual appearance.
 ### Orientation
 
 Set the `orientation` attribute to `horizontal` to create a card with a horizontal, side-by-side layout. Make sure to set a width or maximum width for the media slot. Horizontal cards do not currently contain the header and footer slots.
-
-:::info
+<wa-callout>
+<wa-icon slot="icon" name="circle-info" variant="regular"></wa-icon>
 The `actions` slot is only available for the horizontal orientation
-:::
+</wa-callout>
 
 ```html {.example}
 <div class="wa-grid">
@@ -167,7 +166,7 @@ The `actions` slot is only available for the horizontal orientation
       src="https://images.unsplash.com/photo-1559209172-0ff8f6d49ff7?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=500&q=80"
       alt="A kitten sits patiently between a terracotta pot and decorative grasses."
     />
-    This card has a horizontal orientation with media, body, and actions arranged side-by-side.
+    This is a kitten, but not just any kitten. This kitten likes walking along pallets.
     <wa-button slot="actions" variant="neutral" appearance="plain"
       ><wa-icon name="ellipsis" label="actions"></wa-icon
     ></wa-button>

packages/webawesome/docs/docs/components/comparison.md

@@ -5,7 +5,7 @@ layout: component
 category: Imagery
 ---
 
-This is especially useful for comparing images, but can be used for comparing any type of content (for an example of using it to compare entire UIs, check out our [theme page](/docs/themes)).
+This is especially useful for comparing images, but can be used for comparing any type of content (for an example of using it to compare entire UIs, check out our [theme pages](/docs/themes/default/)).
 For best results, use content that shares the same dimensions.
 The slider can be controlled by dragging or pressing the left and right arrow keys. (Tip: press shift + arrows to move the slider in larger intervals, or home + end to jump to the beginning or end.)
 

packages/webawesome/docs/docs/components/dialog.md

@@ -178,11 +178,11 @@ If you want the dialog to close when the user clicks on the overlay, add the `li
 
 ### Preventing the Dialog from Closing
 
-By default, dialogs will close when the user clicks the close button or presses the [[Escape]] key. In most cases, the default behavior is the best behavior in terms of UX. However, there are situations where this may be undesirable, such as when data loss will occur.
+By default, dialogs will close when the user clicks the close button, clicks the overlay, or presses the [[Escape]] key. In most cases, the default behavior is the best behavior in terms of UX. However, there are situations where this may be undesirable, such as when data loss will occur.
 
 To keep the dialog open in such cases, you can cancel the `wa-hide` event. When canceled, the dialog will remain open and pulse briefly to draw the user's attention to it.
 
-You can use `event.detail.source` to determine which element triggered the request to close. This example prevents the dialog from closing unless a specific button is clicked.
+You can use `event.detail.source` to determine which element triggered the request to close. This example prevents the dialog from closing when the overlay is clicked, but allows the close button or [[Escape]] to dismiss it.
 
 ```html {.example}
 <wa-dialog label="Dialog" class="dialog-deny-close">

packages/webawesome/docs/docs/components/divider.md

@@ -41,7 +41,7 @@ Use the `--spacing` custom property to change the amount of space between the di
 
 ### Orientation
 
-The default orientation for dividers is `horizontal`. Set `orientation` attribute to `vertical` to draw a vertical divider. The divider will span the full height of its [Flexbox](https://developer.mozilla.org/en-US/docs/Learn_web_development/Core/CSS_layout/Flexbox) or [CSS Grid](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/grid) container.
+The default orientation for dividers is `horizontal`. Set `orientation` attribute to `vertical` to draw a vertical divider. The divider will span the full height of its container.
 
 ```html {.example}
 <div style="display: flex; align-items: center;">
@@ -53,13 +53,9 @@ The default orientation for dividers is `horizontal`. Set `orientation` attribut
 </div>
 ```
 
-:::info
-If your container isn't Flexbox or CSS Grid, you may need to set an explicit height for the divider.
-:::
+### Menu Dividers
 
-### Dropdown Dividers
-
-Use dividers in [dropdowns](/docs/components/dropdown) to visually group dropdown items.
+Use dividers in [menus](/docs/components/menu) to visually group menu items.
 
 ```html {.example}
 <wa-dropdown style="max-width: 200px;">

packages/webawesome/docs/docs/components/include.md

@@ -19,7 +19,7 @@ The included content will be inserted into the `<wa-include>` element's default
 
 When an include file loads successfully, the `wa-load` event will be emitted. You can listen for this event to add custom loading logic to your includes.
 
-If the request fails, the `wa-include-error` event will be emitted. In this case, `event.detail.status` will contain the resulting HTTP status code of the request, e.g. 404 (not found).
+If the request fails, the `wa-error` event will be emitted. In this case, `event.detail.status` will contain the resulting HTTP status code of the request, e.g. 404 (not found).
 
 ```html
 <wa-include src="https://shoelace.style/assets/examples/include.html"></wa-include>
@@ -33,7 +33,7 @@ If the request fails, the `wa-include-error` event will be emitted. In this case
     }
   });
 
-  include.addEventListener('wa-include-error', event => {
+  include.addEventListener('wa-error', event => {
     if (event.eventPhase === Event.AT_TARGET) {
       console.log('Error', event.detail.status);
     }

packages/webawesome/docs/docs/components/intersection-observer.md

@@ -2,7 +2,6 @@
 title: Intersection Observer
 description: Tracks immediate child elements and fires events as they move in and out of view.
 layout: component
-category: Utilities
 ---
 
 This component leverages the [IntersectionObserver API](https://developer.mozilla.org/en-US/docs/Web/API/IntersectionObserver) to track when its direct children enter or leave a designated root element. The `wa-intersect` event fires whenever elements cross the visibility threshold.

packages/webawesome/docs/docs/components/radio-group.md

@@ -102,7 +102,7 @@ The default orientation for radio items is `vertical`. Set the `orientation` to
 
 ### Sizing Options
 
-The size of radios will be determined by the Radio Group's `size` attribute.
+The size of [Radios](/docs/components/radio) will be determined by the Radio Group's `size` attribute.
 
 ```html {.example}
 <wa-radio-group label="Select an option" size="medium" value="medium" onchange="this.size = this.value">
@@ -113,7 +113,7 @@ The size of radios will be determined by the Radio Group's `size` attribute.
 ```
 
 :::info
-[Radios](/docs/components/radio) also have a `size` attribute,
+[Radios](/docs/components/radio) and [Radio Buttons](/docs/components/radio-button) also have a `size` attribute,
 which will override the inherited size when used.
 :::
 

packages/webawesome/docs/docs/components/select.md

@@ -285,10 +285,9 @@ Remember that custom tags are rendered in a shadow root. To style them, you can
     const name = option.querySelector('wa-icon[slot="start"]').name;
 
     // You can return a string, a Lit Template, or an HTMLElement here
-    // Important: include data-value so the tag can be removed properly!
     return `
-      <wa-tag with-remove data-value="${option.value}">
-        <wa-icon name="${name}"></wa-icon>
+      <wa-tag with-remove>
+        <wa-icon name="${name}" style="padding-inline-end: .5rem;"></wa-icon>
         ${option.label}
       </wa-tag>
     `;
@@ -300,10 +299,6 @@ Remember that custom tags are rendered in a shadow root. To style them, you can
 Be sure you trust the content you are outputting! Passing unsanitized user input to `getTag()` can result in XSS vulnerabilities.
 :::
 
-:::info
-When using custom tags with `with-remove`, you must include the `data-value` attribute set to the option's value. This allows the select to identify which option to deselect when the tag's remove button is clicked.
-:::
-
 ### Lazy loading options
 
 Lazy loading options works similarly to native `<select>` elements. The select component handles various scenarios intelligently:

packages/webawesome/docs/docs/customizing.md

@@ -10,32 +10,27 @@ You can customize the look and feel of Web Awesome at a high level with themes.
 
 Web Awesome uses [themes](/docs/themes) to apply a cohesive look and feel across the entire library. Themes are built with a collection of predefined CSS custom properties, which we call [design tokens](/docs/tokens), and there are many premade themes you can choose from.
 
-{% raw %}
-  <p>
-    To use a pre-built theme {%- if currentUser.hasPro -%}&nbsp;or build your own{%- endif -%},&nbsp;
-    {%- if not session.isLoggedIn -%}
-      <a href="/signup">sign up</a> or <a href="/login">log in</a> to create a project.&nbsp;
-    {%- else -%}
-      head over to <a href="/teams">your teams</a> and open up the project you'd like to use.&nbsp;
-    {%- endif -%}
-    In your project's <wa-icon name="gear" variant="regular"></wa-icon> <strong>Settings</strong>,&nbsp;
-    {%- if not currentUser.hasPro -%}
-      select a <wa-icon name="paintbrush" variant="regular"></wa-icon> <strong>Theme</strong> and a <wa-icon name="swatchbook" variant="regular"></wa-icon> <strong>Color Palette</strong> to use, save your changes, and bask in the glory of your new theme.
-    {%- else -%}
-      <wa-icon name="paintbrush" variant="regular"></wa-icon> <strong>Edit Your Theme</strong> to open the Theme Builder and select a pre-built theme or customize your colors, fonts, icons, and more.
-    {%- endif -%}
-  </p>
-{% endraw %}
+To use a theme, simply add a link to the theme's stylesheet to the `<head>` of your page. For example, you can add this snippet alongside th [installation code](/docs/#quick-start-autoloading-via-cdn) to use the _Awesome_ theme:
 
-For even more customizations, you can off-road and override any theme just with CSS — no preprocessor required. All design tokens are prefixed with `--wa-` to avoid collisions with other libraries and your own custom properties. Simply style any design token in your own stylesheet by scoping your styles to `:root` and the class for the relevant color scheme (if needed). Here's an example that uses tinted surface colors in light mode:
+```html
+<link rel="stylesheet" href="{% cdnUrl 'styles/themes/awesome.css' %}" />
+```
+
+You can customize any theme just with CSS — no preprocessor required. All design tokens are prefixed with `--wa-` to avoid collisions with other libraries and your own custom properties. Simply override any design token in your own stylesheet by scoping your styles to `:root`, the class for the specific theme you want to override (if needed), and the class for the relevant color scheme (if needed). Here's an example that changes the default brand color to purple in light mode:
 
 ```css
 :root,
 .wa-light,
 .wa-dark .wa-invert {
-  --wa-color-surface-raised: var(--wa-color-neutral-95);
-  --wa-color-surface-default: var(--wa-color-neutral-90);
-  --wa-color-surface-lowered: var(--wa-color-neutral-80);
+  --wa-color-brand-fill-quiet: var(--wa-color-purple-95);
+  --wa-color-brand-fill-normal: var(--wa-color-purple-90);
+  --wa-color-brand-fill-loud: var(--wa-color-purple-50);
+  --wa-color-brand-border-quiet: var(--wa-color-purple-90);
+  --wa-color-brand-border-normal: var(--wa-color-purple-80);
+  --wa-color-brand-border-loud: var(--wa-color-purple-60);
+  --wa-color-brand-on-quiet: var(--wa-color-purple-40);
+  --wa-color-brand-on-normal: var(--wa-color-purple-30);
+  --wa-color-brand-on-loud: white;
 }
 ```
 
@@ -160,4 +155,4 @@ For example, we can give `<input type="checkbox">` the same custom styles as `<w
     color: lavenderblush;
   }
 </style>
-```
+```

packages/webawesome/docs/docs/experimental/ssr.md

@@ -16,8 +16,8 @@ SSR in Web Awesome is experimental! There are some known bugs and timing issues.
 If you're using the `webawesome.loader.js` file which automatically loads, make sure to change it to `webawesome.ssr-loader.js`.
 
 ```diff
-- <script type="module" src="/dist/webawesome.loader.js"></script>
-+ <script type="module" src="/dist/webawesome.ssr-loader.js"></script>
+- <script type="module" src="https://early.webawesome.com/webawesome@3.0.0-alpha.2/dist/webawesome.loader.js"></script>
++ <script type="module" src="https://early.webawesome.com/webawesome@3.0.0-alpha.2/dist/webawesome.ssr-loader.js"></script>
 ```
 
 If you're using a bundler, make sure it comes _before_ any components are imported.
@@ -43,10 +43,7 @@ import litPlugin from '@lit-labs/eleventy-plugin-lit';
 
 eleventyConfig.addPlugin(litPlugin, {
   mode: 'worker',
-  componentModules: [
-    '@awesome.me/webawesome/dist/components/button/button.js',
-    '@awesome.me/webawesome/dist/components/input/input.js',
-  ],
+  componentModules: ['@awesome.me/webawesome/dist/components/button/button.js', '@awesome.me/webawesome/dist/components/input/input.js'],
 });
 ```
 
@@ -117,4 +114,4 @@ Here are some known issues and things we're still working on.
 - `@shoelace-style/localize` (our localization library) has no way to set a language currently so it always falls back to `en`.
 - `<wa-icon>` has no fallback if there's no JS besides a blank `<svg>`. There's perhaps some backend mechanisms we can use to fetch. But requires altering APIs. Should also have a way to set height / widths, but we don't want to increase pain for SSR users.
 - `<wa-qr-code>` QR Code will not error on the backend and will render a blank canvas at the appropriate size, but will not render the canvas until the client component connects.
-- `setBasePath` and `kit codes` may need reconfiguring to work with SSR.
+- `setBasePath` and `kit codes` may need reconfiguring to work with SSR.

packages/webawesome/docs/docs/frameworks/angular.md

@@ -1,101 +0,0 @@
----
-title: Angular
-description: Tips for using Web Awesome in your Angular app.
-layout: page-outline
----
-
-# Angular
-
-Angular [plays nice](https://custom-elements-everywhere.com/#angular) with custom elements, so you can use Web Awesome in your Angular apps with ease.
-
-## Installation
-
-### Download the npm package
-
-To add Web Awesome to your Angular app, install the package from npm.
-
-```bash
-npm install @awesome.me/webawesome
-```
-
-### Update the Angular Configuration
-
-Next, [include a theme](/getting-started/themes). In this example, we'll import the light theme.
-
-Its also important to load the components by using a `<script>` tag into the index.html file. However, the Angular way to do it is by adding a script configurations into your angular.json file as follows:
-
-```json
-"architect": {
-  "build": {
-    ...
-    "options": {
-      ...
-      "styles": [
-        "src/styles.scss",
-        "@awesome.me/webawesome/dist/styles/webawesome.css"
-       ]
-      ...
-    }
-  }
-}
-```
-
-## Configuration
-
-Then make sure to apply the custom elements schema as shown below.
-
-```js
-import { BrowserModule } from '@angular/platform-browser';
-import { NgModule, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
-
-import { AppComponent } from './app.component';
-
-@NgModule({
-  declarations: [AppComponent],
-  imports: [BrowserModule],
-  providers: [],
-  bootstrap: [AppComponent],
-  schemas: [CUSTOM_ELEMENTS_SCHEMA]
-})
-export class AppModule {}
-```
-
-## Reference Web Awesome components in your Angular component code
-
-```js
-// need to have both or Angular will tree shake the component out.
-import type { WaDrawer } from '@awesome.me/webawesome/dist/components/drawer/drawer.js';
-import "@awesome.me/webawesome/dist/components/drawer/drawer.js";
-
-@Component({
-  selector: 'app-drawer-example',
-  template: '<div id="page"><button (click)="showDrawer()">Show drawer</button><wa-drawer #drawer label="Drawer" class="drawer-focus" style="--size: 50vw"><p>Drawer content</p></wa-drawer></div>'
-})
-export class DrawerExampleComponent implements OnInit {
-
-  // use @ViewChild to get a reference to the #drawer element within component template
-  @ViewChild('drawer')
-  drawer?: ElementRef<WaDrawer>;
-
-  ...
-
-  constructor(...) {
-  }
-
-  ngOnInit() {
-  }
-
-  ...
-
-  showDrawer() {
-    // use nativeElement to access Web Awesome components
-    this.drawer?.nativeElement.show();
-  }
-}
-```
-
-Now you can start using Web Awesome components in your app!
-
-:::tip
-Are you using Web Awesome with Angular? [Help us improve this page!](https://github.com/shoelace-style/webawesome/blob/next/docs/frameworks/angular.md)
-:::

packages/webawesome/docs/docs/frameworks/react.md

@@ -1,193 +0,0 @@
----
-title: React
-description: Tips for using Web Awesome in your React app.
-layout: page-outline
----
-
-# React
-
-Web Awesome offers a React version of every component to provide an idiomatic experience for React users. You can easily toggle between HTML and React examples throughout the documentation.
-
-## Installation
-
-To add Web Awesome to your React app, install the package from npm.
-
-```bash
-npm install @awesome.me/webawesome
-```
-
-Next, import the Web Awesome stylesheet, import the components you need, and then start using Web Awesome!
-
-```jsx
-// App.jsx (React 19, using native custom elements)
-import '@awesome.me/webawesome/dist/styles/webawesome.css';
-import '@awesome.me/webawesome/dist/components/button/button.js';
-
-export default function App () {
-  return <wa-button>I'm a button!</wa-button>
-}
-```
-
-Now you can start using components!
-
-### Preact
-
-Preact users facing type errors using components may benefit from setting "paths" in their tsconfig.json so that react types will instead resolve to preact/compat as described in [Preact's typescript documentation](https://preactjs.com/guide/v10/typescript/#typescript-preactcompat-configuration).
-
-## Usage
-
-### Importing Components
-
-Every Web Awesome component is available to import as a React component. Note that we're importing the `<WaButton>` _React component_ instead of the `<wa-button>` _custom element_ in the example below.
-
-```jsx
-import WaButton from '@awesome.me/webawesome/react/button/index.js';
-
-const MyComponent = () => <WaButton variant="primary">Click me</WaButton>;
-
-export default MyComponent;
-```
-
-#### Notes about tree shaking
-
-Previously, it was recommended to import from a single entrypoint like so:
-
-```jsx
-import { WaButton } from '@awesome.me/webawesome/dist/react';
-```
-
-However, tree-shaking extra Web Awesome components proved to be a challenge. As a result, we now recommend cherry-picking components you want to use, rather than importing from a single entrypoint.
-
-```diff
-- import { WaButton } from '@awesome.me/webawesome/dist/react';
-+ import WaButton from '@awesome.me/webawesome/dist/react/button/index.js';
-```
-
-You can find a copy + paste import for each component in the "importing" section of its documentation.
-
-### Event Handling
-
-Many Web Awesome components emit [native events](https://developer.mozilla.org/en-US/docs/Web/API/Event). For example, the [input component](/components/input) emits the `input` event when it receives input. In React, you can listen for the event using `onInput`.
-
-Here's how you can bind the input's value to a state variable.
-
-```jsx
-import { useState } from 'react';
-import WaInput from '@awesome.me/webawesome/dist/react/input/index.js';
-
-function MyComponent() {
-  const [value, setValue] = useState('');
-
-  return <>
-    <WaInput value={value} onInput={event => setValue(event.target.value)} />;
-    <WaInput defaultValue={"Foo"} /> {/* This is an "uncontrolled input" */}
-  </>
-}
-
-export default MyComponent;
-```
-
-If you're using TypeScript, it's important to note that `event.target` will be a reference to the underlying custom element. You can use `(event.target as any).value` as a quick fix, or you can strongly type the event target as shown below.
-
-```tsx
-import { useState } from 'react';
-import WaInput from '@awesome.me/webawesome/dist/react/input/index.js';
-import type WaInputElement from '@awesome.me/webawesome/dist/components/input/input.js';
-
-function MyComponent() {
-  const [value, setValue] = useState('');
-
-  return <WaInput value={value} onInput={event => setValue((event.target as WaInputElement).value)} />;
-}
-
-export default MyComponent;
-```
-
-You can also import the event type for use in your callbacks, shown below.
-
-```tsx
-import { useCallback, useState } from 'react';
-import WaInput, { type WaInputEvent } from '@awesome.me/webawesome/dist/react/input/index.js';
-import type WaInputElement from '@awesome.me/webawesome/dist/components/input/input.js';
-
-function MyComponent() {
-  const [value, setValue] = useState('');
-  const onInput = useCallback((event: WaInputEvent) => {
-    setValue(event.detail);
-  }, []);
-
-  return <WaInput value={value} onInput={event => setValue((event.target as WaInputElement).value)} />;
-}
-
-export default MyComponent;
-```
-
-## Testing with Jest
-
-Testing with web components can be challenging if your test environment runs in a Node environment (i.e. it doesn't run in a real browser). Fortunately, [Jest](https://jestjs.io/) has made a number of strides to support web components and provide additional browser APIs. However, it's still not a complete replication of a browser environment.
-
-Here are some tips that will help smooth things over if you're having trouble with Jest + Web Awesome.
-
-:::tip
-If you're looking for a fast, modern testing alternative, consider [Web Test Runner](https://modern-web.dev/docs/test-runner/overview/).
-:::
-
-### Upgrade Jest
-
-Jest underwent a major revamp and received support for web components in [version 26.5.0](https://github.com/facebook/jest/blob/main/CHANGELOG.md#2650) when it introduced [JSDOM 16.2.0](https://github.com/jsdom/jsdom/blob/master/Changelog.md#1620). This release also included a number of mocks for built-in browser functions such as `MutationObserver`, `document.createRange`, and others.
-
-If you're using [Create React App](https://reactjs.org/docs/create-a-new-react-app.html#create-react-app), you can update `react-scripts` which will also update Jest.
-
-```
-npm install react-scripts@latest
-```
-
-### Mock Missing APIs
-
-Some components use `window.matchMedia`, but this function isn't supported by JSDOM so you'll need to mock it yourself.
-
-In `src/setupTests.js`, add the following.
-
-```js
-Object.defineProperty(window, 'matchMedia', {
-  writable: true,
-  value: jest.fn().mockImplementation(query => ({
-    matches: false,
-    media: query,
-    onchange: null,
-    addListener: jest.fn(), // deprecated
-    removeListener: jest.fn(), // deprecated
-    addEventListener: jest.fn(),
-    removeEventListener: jest.fn(),
-    dispatchEvent: jest.fn()
-  }))
-});
-```
-
-For more details, refer to Jest's [manual mocking](https://jestjs.io/docs/manual-mocks#mocking-methods-which-are-not-implemented-in-jsdom) documentation.
-
-### Transform ES Modules
-
-ES Modules are a [well-supported browser standard](https://hacks.mozilla.org/2018/03/es-modules-a-cartoon-deep-dive/). This is how Web Awesome is distributed, but most React apps expect CommonJS. As a result, you'll probably run into the following error.
-
-```
-Error: Unable to import outside of a module
-```
-
-To fix this, add the following to your `package.json` which tells the transpiler to process Web Awesome modules.
-
-```js
-{
-  "jest": {
-    "transformIgnorePatterns": ["node_modules/(?!(@awesome.me|lit|@lit-labs))"]
-  }
-}
-```
-
-These instructions are for apps created via Create React App. If you're using Jest directly, you can add `transformIgnorePatterns` directly into `jest.config.js`.
-
-For more details, refer to Jest's [`transformIgnorePatterns` customization](https://jestjs.io/docs/tutorial-react-native#transformignorepatterns-customization) documentation.
-
-:::tip
-Are you using Web Awesome with React? [Help us improve this page!](https://github.com/shoelace-style/webawesome/blob/next/docs/frameworks/react.md)
-:::

packages/webawesome/docs/docs/frameworks/svelte.md

@@ -1,90 +0,0 @@
----
-title: Svelte
-description: Tips for using Web Awesome in your Svelte app.
-layout: page-outline
----
-
-# Svelte
-
-Svelte [plays nice](https://custom-elements-everywhere.com/#svelte) with custom elements, so you can use Web Awesome in your Svelte apps with ease.
-
-## Installation
-
-To add Web Awesome to your Svelte app, install the package from npm.
-
-```bash
-npm install @awesome.me/webawesome
-```
-
-Next, import the Web Awesome stylesheet, import the components you need, and then start using Web Awesome!
-
-```jsx
-// main.js or main.ts
-import '@awesome.me/webawesome/dist/styles/webawesome.css';
-import '@awesome.me/webawesome/dist/components/button/button.js';
-```
-
-## Usage
-
-### QR code generator example
-
-```jsx
-<h1>Live editing</h1>
-
-<wa-input label="Message" value={message} oninput={event => message = event.target.value}></wa-input>
-
-<wa-alert open>
-  <wa-icon slot="icon" name="info-circle"></wa-icon>
-  {message}
-</wa-alert>
-
-<script>
-  import '@awesome.me/webawesome/dist/components/alert/alert.js'
-  import '@awesome.me/webawesome/dist/components/input/input.js';
-
-  let message = $state('')
-</script>
-```
-
-### Two-way Binding
-
-One caveat is there's currently Svelte only supports `bind:value` directive in `<input>`, `<textarea>` and `<select>`, but you can still achieve two-way binding manually.
-
-```jsx
-// ❌ These do not work
-<wa-input bind:value="name"></wa-input>
-
-<wa-select bind:value="job">
-  <wa-option value="designer">Designer</wa-option>
-  <wa-option value="developer">Developer</wa-option>
-</wa-select>
-
-// ✅ These are a bit longer, but work
-<wa-input value={name} oninput={event => name = event.target.value}></wa-input>
-
-<wa-select value={job} oninput={event => job = event.target.value}>
-  <wa-option value="designer">Designer</wa-option>
-  <wa-option value="developer">Developer</wa-option>
-</wa-select>
-```
-
-:::tip
-Are you using Web Awesome with Svelte? [Help us improve this page!](https://github.com/shoelace-style/webawesome/blob/next/docs/frameworks/svelte.md)
-:::
-
-### Slots
-
-Slots in Web Awesome/web components are functionally the same as basic slots in Svelte. Slots can be assigned to elements using the `slot` attribute followed by the name of the slot it is being assigned to.
-
-Here is an example:
-
-```jsx
-<wa-drawer label="Drawer" placement="start" class="drawer-placement-start" bind:open={drawerIsOpen}>
-  This drawer slides in from the start.
-  <div slot="footer">
-    <wa-button variant="primary" onclick={() => (drawerIsOpen = false)}>
-      Close
-    </wa-button>
-  </div>
-</wa-drawer>
-```

packages/webawesome/docs/docs/frameworks/vue-2.md

@@ -1,102 +0,0 @@
----
-title: Vue (version 2)
-description: Tips for using Web Awesome in your Vue 2 app.
-layout: page-outline
----
-
-# Vue (version 2)
-
-Vue [plays nice](https://custom-elements-everywhere.com/#vue) with custom elements, so you can use Web Awesome in your Vue apps with ease.
-
-:::tip
-These instructions are for Vue 2. If you're using Vue 3 or above, please see the [Vue 3 instructions](/frameworks/vue).
-:::
-
-## Installation
-
-To add Web Awesome to your Vue app, install the package from npm.
-
-```bash
-npm install @awesome.me/webawesome
-```
-
-Next, import the Web Awesome stylesheet, import the components you need, and then start using Web Awesome!
-
-```jsx
-// main.js or main.ts
-import '@awesome.me/webawesome/dist/styles/webawesome.css';
-import '@awesome.me/webawesome/dist/components/button/button.js';
-```
-
-## Configuration
-
-You'll need to tell Vue to ignore Web Awesome components. This is pretty easy because they all start with `wa-`.
-
-```js
-import Vue from 'vue';
-import App from './App.vue';
-
-Vue.config.ignoredElements = [/wa-/];
-
-const app = new Vue({
-  render: h => h(App)
-});
-
-app.$mount('#app');
-```
-
-Now you can start using Web Awesome components in your app!
-
-## Usage
-
-### Binding Complex Data
-
-When binding complex data such as objects and arrays, use the `.prop` modifier to make Vue bind them as a property instead of an attribute.
-
-```html
-<wa-color-picker :swatches.prop="mySwatches" />
-```
-
-### Two-way Binding
-
-One caveat is there's currently [no support for v-model on custom elements](https://github.com/vuejs/vue/issues/7830), but you can still achieve two-way binding manually.
-
-```html
-<!-- ❌ This doesn't work -->
-<wa-input v-model="name"></wa-input>
-<!-- ✅ This works, but it's a bit longer -->
-<wa-input :value="name" @input="name = $event.target.value"></wa-input>
-```
-
-If that's too verbose for your liking, you can use a custom directive instead. [This utility](https://www.npmjs.com/package/@shoelace-style/vue-sl-model) adds a custom directive that will work just like `v-model` but for Web Awesome components. To install it, use this command.
-
-```bash
-npm install @shoelace-style/vue-sl-model@1
-```
-
-Next, import the directive and enable it like this.
-
-```js
-import Vue from 'vue';
-import Web AwesomeModelDirective from '@shoelace-style/vue-sl-model';
-import App from './App.vue';
-
-Vue.use(Web AwesomeModelDirective);
-Vue.config.ignoredElements = [/wa-/];
-
-const app = new Vue({
-  render: h => h(App)
-});
-
-app.$mount('#app');
-```
-
-Now you can use the `v-sl-model` directive to keep your data in sync!
-
-```html
-<wa-input v-sl-model="name"></wa-input>
-```
-
-:::tip
-Are you using Web Awesome with Vue 2? [Help us improve this page!](https://github.com/shoelace-style/shoelace/blob/next/docs/frameworks/vue-2.md)
-:::

packages/webawesome/docs/docs/frameworks/vue.md

@@ -1,119 +0,0 @@
----
-title: Vue
-description: Tips for using Web Awesome in your Vue 3 app.
-layout: page-outline
----
-
-# Vue
-
-Vue [plays nice](https://custom-elements-everywhere.com/#vue) with custom elements, so you can use Web Awesome in your Vue apps with ease.
-
-:::tip
-These instructions are for Vue 3 and above. If you're using Vue 2, please see the [Vue 2 instructions](/frameworks/vue-2).
-:::
-
-## Installation
-
-To add Web Awesome to your Vue app, install the package from npm.
-
-```bash
-npm install @awesome.me/webawesome
-```
-
-Next, import the Web Awesome stylesheet, import the components you need, and then start using Web Awesome!
-
-```jsx
-// main.js or main.ts
-import '@awesome.me/webawesome/dist/styles/webawesome.css';
-import '@awesome.me/webawesome/dist/components/button/button.js';
-```
-
-## Configuration
-
-If you haven't configured your Vue.js project to work with custom elements/web components, follow [the instructions here](https://vuejs.org/guide/extras/web-components.html#using-custom-elements-in-vue) based on your project type to ensure your project will not throw an error when it encounters a custom element.
-
-Now you can start using Web Awesome components in your app!
-
-## Types
-
-Once you have configured your application for custom elements, you should be able to use Shoelace in your application without it causing any errors. Unfortunately, this doesn't register the custom elements to behave like components built using Vue. To provide autocomplete information and type safety for your components, you can import the Shoelace Vue types into your `tsconfig.json` to get better integration in your standard Vue and JSX templates.
-
-```json
-{
-  "compilerOptions": {
-    "types": ["@awesome.me/webawesome/dist/types/vue/index.d.ts"]
-  }
-}
-```
-
-## Usage
-
-### QR code generator example
-
-```html
-<template>
-  <div class="container">
-    <h1>QR code generator</h1>
-
-    <wa-input maxlength="255" clearable label="Value" v-model="qrCode"></wa-input>
-
-    <wa-qr-code :value="qrCode"></wa-qr-code>
-  </div>
-</template>
-
-<script setup>
-  import { ref } from 'vue';
-  import '@awesome.me/webawesome/dist/components/qr-code/qr-code.js';
-  import '@awesome.me/webawesome/dist/components/input/input.js';
-
-  const qrCode = ref();
-</script>
-
-<style>
-  .container {
-    max-width: 400px;
-    margin: 0 auto;
-  }
-</style>
-```
-
-### Binding Complex Data
-
-When binding complex data such as objects and arrays, use the `.prop` modifier to make Vue bind them as a property instead of an attribute.
-
-```html
-<wa-color-picker :swatches.prop="mySwatches" />
-```
-
-### Two-way Binding
-
-One caveat is there's currently [varying levels of support for v-model on custom elements](https://github.com/vuejs/vue/issues/7830), but you can still achieve two-way binding manually.
-
-```html
-<!-- ❌ This doesn't work -->
-<wa-input v-model="name"></wa-input>
-<!-- ✅ This works, but it's a bit longer -->
-<wa-input :value="name" @input="name = $event.target.value"></wa-input>
-```
-
-<!-- Remove this until we can test it works, and if there is interest. Vue3 kinda clobbered it all up
-If that's too verbose for your liking, you can use a custom directive instead. [This utility](https://www.npmjs.com/package/@shoelace-style/vue-wa-model) adds a custom directive that will work just like `v-model` but for Web Awesome components. -->
-
-### Slots
-
-Slots in Web Awesome / web components are functionally the same as basic slots in Vue. Slots can be assigned to elements using the `slot` attribute followed by the name of the slot it is being assigned to.
-
-Here is an example:
-
-```html
-<wa-drawer label="Drawer" placement="start" class="drawer-placement-start" :open="drawerIsOpen">
-  This drawer slides in from the start.
-  <div slot="footer">
-    <wa-button variant="primary" @click=" drawerIsOpen = false">Close</wa-button>
-  </div>
-</wa-drawer>
-```
-
-:::tip
-Are you using Web Awesome with Vue? [Help us improve this page!](https://github.com/shoelace-style/webawesome/blob/next/docs/frameworks/vue.md)
-:::

packages/webawesome/docs/docs/index.md

@@ -12,27 +12,42 @@ Welcome to Web Awesome! [Learn more](https://webawesome.com/) about this project
 
 ---
 
-## 🚀 Using a Project
+## Quick Start (Autoloading via CDN)
 
-A project gives you your own, personal CDN to use Web Awesome on your site. Each project uses a single line of code to install your preferred version, theme, Font Awesome kit...the works! And, when you update your project's settings, your project code pulls in all of the right stuff automatically — no need to update your own code or redeploy your site.
+To get everything included in Web Awesome, add the following code to the `<head>` of your site:
 
-One line of code from us. The entire Web Awesome library for you.
+```html
+<link rel="stylesheet" href="{% cdnUrl 'styles/webawesome.css' %}" />
+<script type="module" src="{% cdnUrl 'webawesome.loader.js' %}"></script>
+```
 
-To use a project:
+This snippet adds:
 
-{% raw %}
-<ol>
-  <li>
-    {% if not session.isLoggedIn %}
-      <a href="/signup">Sign up</a> or <a href="/login">log in</a> to create a project.
-    {% else %}
-      Head over to <a href="/teams">your favorite team</a> and open up the project you'd like to use.
-    {% endif %}
-  </li>
-  <li>Copy and paste your unique project code into the <code>&lt;head&gt;</code> of each page on your site.</li>
-  <li><a href="/docs/usage">Start using Web Awesome!</a></li>
-</ol>
-{% endraw %}
+- **Web Awesome styles**, a collection of stylesheets including essential default theme styles, optional [styles for native elements](/docs/utilities/native) and optional [utility classes](/docs/utilities)
+- **The autoloader**, a lightweight script watches the DOM for unregistered Web Awesome elements and lazy loads them for you — even if they're added dynamically
+
+Now you can [start using Web Awesome!](/docs/usage)
+
+---
+
+## Using Font Awesome Kit Codes
+
+Font Awesome users can provide their kit code to unlock premium icon packs. You can provide yours by adding the `data-fa-kit-code` attribute to any element on the page, or by calling the `setKitCode()` method.
+
+```html
+<!-- Option 1: the data-fa-kit-code attribute -->
+<script src="bundle.js" data-fa-kit-code="abc123"></script>
+
+<!-- Option 2: the setKitCode() method -->
+<script type="module">
+  import { setKitCode } from '{% cdnUrl 'webawesome.loader.js' %}';
+  setKitCode('YOUR_KIT_CODE_HERE');
+</script>
+```
+
+:::info
+Not a Font Awesome user yet? [Learn more about premium icon packs](https://fontawesome.com/) and sign up for an account to unlock them!
+:::
 
 ---
 
@@ -48,9 +63,31 @@ To use a project:
 {% endraw %}
 </div>
 
-## 🛠️ Advanced Setup
+## Advanced Setup
 
-Projects are our favorite way to use Web Awesome, but different environments (or your own preferences!) may require different installation methods. If you're self-hosting Web Awesome or using npm, refer to the instructions in this section.
+The autoloader is the easiest way to use Web Awesome, but different projects (or your own preferences!) may require different installation methods.
+
+### Cherry Picking from CDN
+
+Cherry picking will only load the components you need up front, while limiting the number of files the browser has to download. The disadvantage is that you need to import each individual component on each page it's used. Additionally, you must include the default theme (`styles/themes/default.css`) to style any imported components. To use a different theme, include your preferred theme _in addition to_ the default theme.
+
+Here's an example that loads only the button component.
+
+```html
+<link rel="stylesheet" href="{% cdnUrl 'styles/themes/default.css' %}" />
+
+<script type="module">
+  import '{% cdnUrl 'components/button/button.js' %}';
+
+  // <wa-button> is ready to use!
+</script>
+```
+
+You can copy and paste the code to import a component from the "Importing" section of the component's documentation. Note that some components have dependencies that are automatically imported when you cherry pick. If a component has dependencies, they will be listed in the "Dependencies" section of its docs.
+
+:::warning
+You will see files named `chunk.[hash].js` in the `chunks` directory. Never import these files directly, as they are generated and change from version to version.
+:::
 
 ### Installing via npm
 
@@ -79,48 +116,11 @@ import '@awesome.me/webawesome/dist/components/input/input.js';
 
 Once they've been imported, you can use them in your HTML normally. Component imports are located in the "Importing" section of each component's documentation.
 
-
-### The Difference Between `/dist` & `/dist-cdn`
-
-If you have Web Awesome installed locally via npm, you'll notice the following directories in the project's root:
-
-```
-dist/
-dist-cdn/
-```
-
-The `dist-cdn` files come with everything bundled together, so you can use them directly without a build tool. The dist files keep dependencies separate, which lets your bundler optimize and share code more efficiently.
-
-Use `dist-cdn` if you're loading directly in the browser or from a CDN. Use `dist` if you're using a bundler like Webpack or Vite.
-
-### Referencing Necessary Styles
-
-If you're self-hosting Web Awesome, you'll need to set up your pages to reference any necessary styles. You can do so by referencing `webawesome.css`, or you can pick and choose specific stylesheets you'd like to use.
-
-```html
-<!-- Option 1: use all Web Awesome styles -->
-<link rel="stylesheet" href="/dist/styles/webawesome.css" />
-
-
-<!-- Option 2: pick and choose styles -->
-
-<!-- theme (required) -->
-<link rel="stylesheet" href="/dist/styles/themes/default.css" />
-
-<!-- native styles (optional) -->
-<link rel="stylesheet" href="/dist/styles/native.css" />
-
-<!-- CSS utilities (optional) -->
-<link rel="stylesheet" href="/dist/styles/utilities.css" />
-```
-
-If you choose to use a theme other than the default theme, be sure to add the corresponding class (e.g. `.wa-theme-awesome`) to your `<html>` element so that the class is applied.
-
 ### Setting the Base Path
 
 Some components rely on assets (icons, images, etc.) and Web Awesome needs to know where they're located. For convenience, Web Awesome will try to auto-detect the correct location based on the script you've loaded it from. This assumes assets are colocated with `webawesome.loader.js` and will "just work" for most users.
 
-==If you're using a Web Awesome project, you can skip this section.== However, if you're [cherry picking](#cherry-picking-from-cdn) or bundling Web Awesome, you'll need to set the base path. You can do this one of two ways.
+==If you're using the CDN, you can skip this section.== However, if you're [cherry picking](#cherry-picking-from-cdn) or bundling Web Awesome, you'll need to set the base path. You can do this one of two ways.
 
 ```html
 <!-- Option 1: the data-webawesome attribute -->
@@ -153,26 +153,18 @@ Most of the magic behind assets is handled internally by Web Awesome, but if you
 </script>
 ```
 
-### Using Font Awesome Pro and Pro+
+### The Difference Between `/dist` & `/dist-cdn`
 
-Font Awesome users can provide their kit code to unlock Pro and Pro+ icon packs. If you're using a project, simply add your Font Awesome Kit Code in your project's settings, and boom! Done.
+If you have Web Awesome installed locally via npm, you'll notice the following directories in the project's root:
 
-If you're using Web Awesome through other methods like npm, you can provide yours by adding the `data-fa-kit-code` attribute to any element on the page, or by calling the `setKitCode()` method.
-
-```html
-<!-- Option 1: the data-fa-kit-code attribute -->
-<script src="bundle.js" data-fa-kit-code="abc123"></script>
-
-<!-- Option 2: the setKitCode() method -->
-<script type="module">
-  import { setKitCode } from '{% cdnUrl 'webawesome.loader.js' %}';
-  setKitCode('YOUR_KIT_CODE_HERE');
-</script>
+```
+dist/
+dist-cdn/
 ```
 
-:::info
-Not a Font Awesome user yet? [Learn more about Font Awesome icon packs](https://fontawesome.com/) and sign up for an account to unlock them!
-:::
+The `dist-cdn` files come with everything bundled together, so you can use them directly without a build tool. The dist files keep dependencies separate, which lets your bundler optimize and share code more efficiently.
+
+Use `dist-cdn` if you're loading directly in the browser or from a CDN. Use `dist` if you're using a bundler like Webpack or Vite.
 
 ## React Users
 

packages/webawesome/docs/docs/layout.njk

@@ -43,56 +43,22 @@ layout: docs
 
 <wa-divider style="--spacing: var(--wa-space-3xl);"></wa-divider>
 
+<div class="max-line-length">
 {% markdown %}
-## Using Layout Utilities
+## Installation
 
-Layout utility classes are bundled with Web Awesome's [style utilities](/docs/utilities). By including style utilities in your project, you'll have access to layout utilities like `.wa-grid` and `.wa-stack`. 
-{% endmarkdown %}
+Layout components are included in Web Awesome's [autoloader](/docs/#quick-start-autoloading-via-cdn). You can also import them individually via [cherry picking](/docs/#cherry-picking).
 
-<wa-tab-group>
-  <wa-tab panel="cdn"><wa-icon name="rocket-launch" variant="regular"></wa-icon> CDN</wa-tab>
-  <wa-tab panel="npm"><wa-icon name="box-open" variant="regular"></wa-icon> npm</wa-tab>
-  <wa-tab panel="self-hosted"><wa-icon name="arrow-down-to-line" variant="regular"></wa-icon> Self-Hosted</wa-tab>
-
-  <wa-tab-panel name="cdn">
-{% markdown %}
-1. Head over to your project's <wa-icon name="gear" variant="regular"></wa-icon> **Settings**.
-2. Next to **Features**, select the **CSS utilities** checkbox.
-3. **Save Changes** to immediately update anywhere you're using your project.
-{% endmarkdown %}
-  </wa-tab-panel>
-
-  <wa-tab-panel name="npm">
-{% markdown %}
-To use all Web Awesome styles (including [native styles](/docs/utilities/native/)), import the following stylesheet in your project:
-
-```js
-import '@awesome.me/webawesome/dist/styles/webawesome.css';
-```
-
-Or, if you only want CSS utility classes, import a theme and the utilities individually:
-
-```js
-import '@awesome.me/webawesome/dist/styles/themes/default.css';
-import '@awesome.me/webawesome/dist/styles/utilities.css';
-```
-{% endmarkdown %}
-  </wa-tab-panel>
-
-  <wa-tab-panel name="self-hosted">
-{% markdown %}
-To use all Web Awesome styles (including [native styles](/docs/utilities/native/)), include the following stylesheet in your project:
+Layout utilities are bundled with all [style utilities](/docs/utilities). You can import all Web Awesome page styles (including [native styles](/docs/utilities/native/)) by including the following stylesheet in your project:
 
 ```html
-<link rel="stylesheet" href="/dist/styles/webawesome.css" />
+<link rel="stylesheet" href="{% cdnUrl 'styles/webawesome.css' %}" />
 ```
 
-Or, if you only want CSS utility classes, include a theme and the utilities individually:
+Or, you can choose to import _only_ the utilities:
 
 ```html
-<link rel="stylesheet" href="/dist/styles/themes/default.css" />
-<link rel="stylesheet" href="/dist/styles/utilities.css" />
+<link rel="stylesheet" href="{% cdnUrl 'styles/utilities.css' %}" />
 ```
 {% endmarkdown %}
-  </wa-tab-panel>
-</wa-tab-group>
+</div>

packages/webawesome/docs/docs/localization.md

@@ -27,7 +27,7 @@ Web Awesome ships with [a number of translations](https://github.com/shoelace-st
 You can import translations using the following syntax, where `<code>` is replaced with any language code shown above.
 
 ```js
-import '/dist/translations/<code>.js';
+import '{% cdnUrl "translations/<code>.js" %}';
 ```
 
 You do not need to load translations up front. You can import them dynamically even after updating the `lang` attribute. Once a translation is registered, localized components will update automatically.
@@ -37,7 +37,7 @@ You do not need to load translations up front. You can import them dynamically e
 document.documentElement.lang = 'de';
 
 // Import the translation
-import('/translations/<code>.js');
+import('{% cdnUrl "translations/<code>.js" %}');
 ```
 
 ### Translation Resolution

packages/webawesome/docs/docs/resources/changelog.md

@@ -1,11 +1,10 @@
 ---
 title: Changelog
-dateLastUpdated: 2025-11-07
 description: Changes to each version of the project are documented here.
 layout: page-outline
 ---
 
-<p class="wa-caption-s">Last updated: <wa-format-date month="long" day="numeric" year="numeric" date="{{ dateLastUpdated }}"></wa-format-date></p>
+<p class="wa-caption-s">Last updated: <wa-format-date month="long" day="numeric" year="numeric" date="{{ lastUpdatedISO }}"></wa-format-date></p>
 
 Web Awesome follows [Semantic Versioning](https://semver.org/). Breaking changes in components with the <wa-badge variant="brand">Stable</wa-badge> badge will not be accepted until the next major version. As such, all contributions must consider the project's roadmap and take this into consideration. Features that are deemed no longer necessary will be deprecated but not removed.
 
@@ -13,60 +12,10 @@ Components with the <wa-badge variant="warning">Experimental</wa-badge> badge sh
 
 ## Next
 
-- Added types for Vue and Svelte generated by CEM [pr:]
-- Added llms.txt to assist AI agents with using Web Awesome [discuss:1100]
-- Added `justify-content` CSS utilities [pr:1930]
-- Added missing `.wa-gap-4xl` utility class [pr:1931]
-- Added `pointercancel` and `touchcancel` event handling to draggable elements to prevent drags from getting stuck
-- Added `wa-justify-content-*` utility classes [pr:1930]
-- Added missing `wa-gap-4xl` utility class [pr:1931]
-- Added `track` and `indicator` CSS parts to `<wa-progress-ring>` [pr:1863]
-- [Docs]: component APIs like slots, state, methods, etc, are now alphabetized [pr:1895]
-- [Docs]: component APIs now properly check their inheritance chain [pr:1895]
-- [Docs]: Included framework specific documentation for Svelte, Vue, and Angular. [pr:1895]
-- Fixed a bug in `<wa-dropdown>` where submenu detection would not work in shadow dom. [pr:]
-- Fixed a bug in `<wa-combobox>` that prevented the listbox from opening when options were preselected [issue:1883]
-- Fixed a bug in `<wa-combobox>` that prevented the listbox from opening when options were preselected [issue:1883]
-- Fixed a bug in `<wa-popup>` and `<wa-dropdown-item>` that caused an error when removing a popup while it was opening [issue:1910]
-- Fixed a bug in `<wa-popup>` and `<wa-dropdown>` that caused errors when shadow DOM queries returned null [issue:1911]
-- Fixed a bug in `<wa-combobox>` that prevented the listbox from opening when options were preselected [issue:1883]
-- Fixed a bug in draggable elements that caused a TypeError on `touchend` events when `event.touches` was empty
-- Fixed a bug in `<wa-tree-item>` that caused the cursor to show a pointer when no expand icon was present [pr:1936]
-- Fixed a bug in `<wa-tree-item>` that caused the chevron to render the wrong direction in RTL [pr:1798]
-- Improved the Persian translation [#1923]
-- Modified `wa-align-items-*` utility classes to apply `display: flex` by default [pr:1943]
-
-## 3.1.0
-
-- Added `<wa-combobox>` as an experimental pro component [issue:1074]
-- Added version 2.0.0 of the [official Web Awesome Figma Design Kit](/docs/resources/figma)
-- Added npm support for Web Awesome Pro
-- Added `layers.css` to define cascade layer order and updated palettes, themes, native styles, and utilities to import the new rule for more fail-safe modularity [pr:1793]
-- [PRO]: Fixed a few sizing bugs in `<wa-page>` and `slot="footer"` no longer will always "overflow" the container.
-- Fixed a bug in `<wa-slider>` that caused some touch devices to end up with the incorrect value [issue:1703]
-- Fixed a bug in `<wa-card>` that prevented some slots from being detected correctly [discuss:1450]
-- Fixed a z-index bug in `<wa-scroller>` styles [issue:1724]
-- Fixed a bug in `<wa-icon>` that caused some icon libraries to render with the incorrect SVG fill [issue:1733]
-- Fixed a bug in `<wa-tree-item>` that caused the spinner to not show when lazy loading [issue:1678]
-- Fixed a bug in `<wa-dropdown>` that caused the browser to hang when cancelling the `wa-hide` event [issue:1483]
-- Fixed a bug in `<wa-tab-group>` that ensures the active indicator always shows [issue:1206]
-- Fixed a bug in `<wa-dropdown-item>` that prevented the icon dependency from being imported [issue:1825]
-- Fixed a bug in `<wa-select>` that prevented clicks on the tag's remove button from removing options in multiple mode
-- Fixed a bug in `<wa-select>` that caused tags to appear in alphabetical order instead of selection order when using `multiple`
-- Fixed a bug in Web Awesome form controls that caused `<wa-input form="foo">` to set the form property to equal `"foo"` instead of returning an `HTMLFormElement` breaking platform expectations. [pr:1815]
-- Fixed a bug in `<wa-button>` causing it to not copy over attributes for form submissions. [pr:1815]
-- Fixed a bug where the build script was not building `/dist/(utilities|events).js` [pr:1816]
-- Improved performance of `<wa-icon>` so initial rendering occurs faster, especially with multiple icons on the page [issue:1729]
-- Improved `<wa-slider>` to not throw an error when string values are passed to the `min`, `max`, and `step` properties [issue:1823]
-- Improved performance of all components by fixing how CSS is imported and reused [issue:1812]
-- Modified the default `transition` styles of `<wa-dropdown-item>` to use design tokens [pr:1693]
-
-## 3.0.0
-
 - 🚨 BREAKING: Changed `appearance="filled outlined"` to `appearance="filled-outlined"` in the following elements [issue:1127]
+  - `<wa-badge>`
   - `<wa-button>`
   - `<wa-callout>`
-  - `<wa-card>`
   - `<wa-details>`
   - `<wa-input>`
   - `<wa-select>`
@@ -76,9 +25,6 @@ Components with the <wa-badge variant="warning">Experimental</wa-badge> badge sh
 - Added the Kazakh translation [pr:1496]
 - Added docs for code completion for VS Code and JetBrains [pr:1550]
 - Added back the missing `form-control-label` part to `<wa-textarea>` for consistency with other form controls [pr:1533]
-- Added focus delegation to `<wa-button>` to ensure tabbing works properly when using `tabindex` [issue:1622]
-- Added [text utilities](/docs/utilities/text/) for longform text, form control text, font sizes, font weights, text color, and truncation [pr:1602]
-- Added version 1.0.0 of the [official Web Awesome Figma Design Kit](/docs/resources/figma)
 - Fixed a bug in `<wa-button>` where slotted badges weren't properly positioned in buttons with an `href` [issue:1377]
 - Fixed focus outline styles in `<wa-details>` and native `<details>` [issue:1456]
 - Fixed focus outline styles in `<wa-scroller>`, `<wa-dialog>`, and `<wa-drawer>` [issue:1484]
@@ -91,14 +37,10 @@ Components with the <wa-badge variant="warning">Experimental</wa-badge> badge sh
 - Fixed a bug in `<wa-tooltip>` that prevented tooltips from showing when disconnecting and then reconnecting to the DOM [issue:1595]
 - Fixed a bug that caused the required `*` in form labels to have incorrect spacing in `<wa-checkbox>` and `<wa-switch>` [issue:1472]
 - Fixed a bug in `<wa-dialog>` and `<wa-drawer>` that caused the component to prematurely hide when certain child elements are used [pr:1636]
-- Fixed a bug in `<wa-popover>` and `<wa-tooltip>` that prevented dots and other valid ID characters from being used [issue:1648]
-- [Pro] Fixed a bug in `<wa-page>` that caused menu and aside content to reserve space for slots with `disable-sticky`
-- Fixed incorrect docs for the `wa-include-error` event which is dispatched by `<wa-include>` [issue:1663]
-- Fixed a bug in `<wa-card>` where slotted header and footer content wasn't properly aligned [pr:1435]
 - Improved autofill styles in `<wa-input>` so they span the entire width of the visual input [issue:1439]
-- Improved [text utilities](/docs/utilities/text/) so that each size modifier always exactly matches the applied font size [pr:1602]
-- Improved Native Styles to use the `--wa-font-weight-code` design token
 - Modified `<wa-slider>` to only show the tooltip on the handle being dragged when in range mode [issue:1320]
+- Improved [text utilities](/docs/utilities/text/) so that each size modifier always exactly matches the applied font size [pr:1602]
+- Added [text utilities](/docs/utilities/text/) for longform text, form control text, font sizes, font weights, text color, and truncation [pr:1602]
 - Upgraded `<wa-page>` from _experimental_ to _stable_
 
 ## 3.0.0-beta.6
@@ -296,7 +238,7 @@ Many of these changes and improvements were the direct result of feedback from u
 - 🚨 BREAKING: Renamed `<image-comparer>` to `<wa-comparison>` and improved compatibility for non-image content
 - 🚨 BREAKING: Added slot detection to `<wa-dialog>` and `<wa-drawer>` so you don't need to specify `with-header` and `with-footer`; headers are on by default now, but you can use the `without-header` attribute to turn them off
 - 🚨 BREAKING: Renamed the `image` slot to `media` for a more appropriate naming convention
-- Added Theme Builder to create your own themes
+- Added [a theme builder](/docs/themes/edit/) to create your own themes
 - Added a new Blog & News pattern category
 - Added a new free component: `<wa-scroller>` (#1 of 14 per stretch goals)
 - Added support for Duotone Thin, Light, and Regular styles and the Sharp Duotone family of styles to `<wa-icon>`
@@ -313,7 +255,7 @@ Many of these changes and improvements were the direct result of feedback from u
 
 ### Enhancements {data-no-outline}
 
-- Added `appearance` to [`<wa-details>`](/docs/components/details) and [`<wa-card>`](/docs/components/card) and support for the appearance utilities in the [`<details>` native styles](/docs/utilities/native/#details).
+- Added `appearance` to [`<wa-details>`](/docs/components/details) and [`<wa-card>`](/docs/components/card) and support for the [appearance utilities](/docs/utilities/appearance/) in the [`<details>` native styles](/docs/utilities/native/details).
 - Added an `orange` scale to all color palettes
 - Added the [`.wa-cloak` utility](/docs/utilities/fouce) to prevent FOUCE
 - Added the [`allDefined()` utility](/docs/usage/#all-defined) for awaiting component registration
@@ -338,7 +280,7 @@ Many of these changes and improvements were the direct result of feedback from u
 - Revert `<wa-dialog>` structure and CSS to fix clipped content in dialogs (WA-A #123) and light dismiss in iOS Safari (WA-A #201)
 - Fixed a bug in `<wa-color-picker>` that prevented light dismiss from working when clicking immediately above the color picker dropdown
 - Fixed a bug in `<wa-progress>` that prevented Safari from animation progress changes
-- Fixed the missing indeterminate icon in [native checkbox styles](/docs/utilities/native/#form-controls)
+- Fixed the missing indeterminate icon in [native checkbox styles](/docs/utilities/native/checkbox)
 - Fixed a bug in `<wa-radio>` where elements would stack instead of display inline
 - Docs fixes:
   - Fixed the search dialog's styles so it doesn't jump around as you search
@@ -485,13 +427,13 @@ Many of these changes and improvements were the direct result of feedback from u
 ### Native styles {data-no-outline}
 
 - Added native styles for
-  [buttons](/docs/utilities/native/#buttons),
-  [input fields](/docs/utilities/native/#form-controls),
-  [dialogs](/docs/utilities/native/#dialog),
-  [details](/docs/utilities/native/#details),
-  [tables](/docs/utilities/native/#tables),
-  [lists](/docs/utilities/native/#lists),
-  and most [content elements](/docs/utilities/native/#typography).
+  [buttons](/docs/utilities/native/button),
+  [input fields](/docs/utilities/native/input),
+  [dialogs](/docs/utilities/native/dialog),
+  [details](/docs/utilities/native/details),
+  [tables](/docs/utilities/native/table),
+  [lists](/docs/utilities/native/lists),
+  and most [content elements](/docs/utilities/native/content).
 
 ### Style utilities {data-no-outline}
 
@@ -499,7 +441,7 @@ Many of these changes and improvements were the direct result of feedback from u
 - Added [appearance utilities](/docs/utilities/appearance/)
 - Added [size utilities](/docs/utilities/size/)
 - Added [layout utilities](/docs/layout/#utilities)
-- Added [`.wa-visually hidden`](/docs/utilities/visually-hidden) utility
+- Added [`.wa-visually hidden`](/docs/utilities/a11y/#visually-hidden) utility
 - Added [`<wa-page>`](/docs/components/page/#styles) native styles and utilities
 
 ### Components {data-no-outline}
@@ -543,4 +485,4 @@ Many of these changes and improvements were the direct result of feedback from u
 
 </details>
 
-Did we miss something? [Let us know!](https://github.com/shoelace-style/webawesome/discussions)
+Did we miss something? [Let us know!](https://github.com/shoelace-style/webawesome/discussions)

packages/webawesome/docs/docs/resources/contributing.md

@@ -164,7 +164,7 @@ This section can be a lot to digest in one sitting, so don't feel like you need
 
 Web Awesome is built with accessibility in mind. Creating generic components that are fully accessible to users with varying capabilities across a multitude of circumstances is a daunting challenge. Oftentimes, the solution to an a11y problem is not written in black and white and, therefore, we may not get it right the first time around. There are, however, guidelines we can follow in our effort to make Web Awesome an accessible foundation from which applications and websites can be built.
 
-We take this commitment seriously, so please ensure your contributions have this goal in mind. If you need help with anything a11y-related, please reach out on the [community chat](https://discord.gg/mg8f26C) for assistance. If you discover an accessibility concern within the library, please file a bug on the [issue tracker](https://github.com/shoelace-style/webawesome/issues).
+We take this commitment seriously, so please ensure your contributions have this goal in mind. If you need help with anything a11y-related, please [reach out to the community](/resources/community) for assistance. If you discover an accessibility concern within the library, please file a bug on the [issue tracker](https://github.com/shoelace-style/webawesome/issues).
 
 It's important to remember that, although accessibility starts with foundational components, it doesn't end with them. It everyone's responsibility to encourage best practices and ensure we're providing an optimal experience for all of our users.
 
@@ -364,7 +364,7 @@ Form controls should support submission and validation through the following con
 
 ### System Icons
 
-Avoid inlining SVG icons inside of templates. If a component requires an icon, make sure `<wa-icon>` is a dependency of the component and use the [system library](/docs/components/icon#customizing-the-system-library):
+Avoid inlining SVG icons inside of templates. If a component requires an icon, make sure `<wa-icon>` is a dependency of the component and use the [system library](/components/icon#customizing-the-system-library):
 
 ```html
 <wa-icon library="system" name="..." variant="..."></wa-icon>

packages/webawesome/docs/docs/resources/llms.md

@@ -1,86 +0,0 @@
----
-title: LLMs
-description: Web Awesome provides an llms.txt file to help AI assistants understand and work with our components.
-layout: page-outline
----
-
-The [llms.txt specification](https://llmstxt.org/) is a proposed standard for providing information to large language models (LLMs) in a format they can easily consume. It's like a robots.txt, but instead of telling search engines how to crawl your site, it helps AI assistants understand your project.
-
-Web Awesome publishes an `llms.txt` file that provides AI tools with structured information about our components, including their APIs, properties, events, methods, slots, and CSS custom properties.
-
-:::warning
-This feature is experimental! The llms.txt format and its contents may change as we refine the output based on feedback and evolving AI capabilities.
-:::
-
-## Why Use It?
-
-When working with AI coding assistants like Claude, ChatGPT, Copilot, or Cursor, you can reference the llms.txt file to give the AI context about Web Awesome components. This can lead to more accurate code suggestions and fewer hallucinations when the AI generates Web Awesome code.
-
-## Accessing the File
-
-The llms.txt file is available in every Web Awesome build at:
-
-```
-/dist/llms.txt
-/dist-cdn/llms.txt
-```
-
-You can also find it in your `node_modules` directory if you've installed Web Awesome via npm:
-
-```
-node_modules/@awesome.me/webawesome/dist/llms.txt
-```
-
-## How to Use It
-
-How you reference the file depends on which AI tool you're using.
-
-### Claude Projects
-
-If you're using [Claude Projects](https://www.anthropic.com/news/projects), you can add the llms.txt URL to your project knowledge. Claude will use this context when helping you write Web Awesome code.
-
-### Cursor
-
-In [Cursor](https://cursor.sh/), you can add the file to your project's documentation sources via **Cursor Settings > Features > Docs**. You can also reference the file directly in chat using `@Docs` after adding it, or paste the content into the chat context.
-
-### VS Code + Copilot
-
-GitHub Copilot in VS Code doesn't have a built-in way to reference external documentation files, but you can:
-
-1. Copy the llms.txt file into your project's root directory
-2. Open it in a VS Code tab (Copilot considers open files as context)
-3. Use `#file` in Copilot Chat to explicitly reference it (e.g., `#file:llms.txt how do I create a dialog?`)
-
-### VS Code + Claude Code
-
-If you're using the [Claude Code extension](https://marketplace.visualstudio.com/items?itemName=anthropics.claude-code), you can reference the file directly by path:
-
-```
-@node_modules/@awesome.me/webawesome/dist/llms.txt
-```
-
-Or simply ask Claude to read it — Claude Code can access files in your project directly.
-
-### Other AI Tools
-
-Most AI coding assistants allow you to provide context through URLs, file uploads, or direct pasting. Check your tool's documentation for the best way to include external references.
-
-## What's Included
-
-The llms.txt file contains:
-
-- An overview of Web Awesome and its capabilities
-- Links to documentation sections
-- A complete list of all components with descriptions
-- Detailed API reference for each component including:
-  - Slots
-  - Properties and their types
-  - Methods and their signatures
-  - Events
-  - CSS custom properties
-  - CSS parts
-  - CSS states
-
-## Feedback
-
-Since this is experimental, we'd love to hear how it works for you! If you find issues with the generated content or have suggestions for improvement, please [open an issue on GitHub](https://github.com/shoelace-style/webawesome/issues).

packages/webawesome/docs/docs/resources/support.md

@@ -1,91 +0,0 @@
----
-title: Community & Support
-description: Web Awesome has a growing community of designers and developers that are building amazing things with web components.
-layout: page
----
-
-  <p>We know people have their own way of reaching out, so our team makes sure you can find us wherever you need — whether it’s filing an issue on GitHub, chatting with the community on Discord, or getting private help via email. If you’re just getting started, don’t miss our <a href="/docs/">Instillation Guide</a>.</p>
-
-<wa-divider></wa-divider>
-
-<div class="wa-stack wa-gap-xl">
-<div class="wa-stack wa-align-items-start">
-  <div class="wa-stack wa-gap-s">
-    <h2 class="anchor-heading wa-cluster wa-gap-xs" data-no-anchor><wa-icon name="github" family="brands" style="font-size: 2ch;"></wa-icon>GitHub</h2>
-    <span class="wa-heading-m">Feature requests & bugs</span>
-    <p class="wa-caption-l">Notice a bug or have an idea? Open an issue on GitHub so we can triage, track, and ship fixes.</p>
-  </div>
-  <ul>
-    <li>Report reproducible bugs with clear steps.</li>
-    <li>Suggest features that improve developer workflow</li>
-    <li>Vote on issues others have filed to help us prioritize.</li>
-  </ul>
-  <div class="wa-cluster wa-gap-s">
-    <wa-button href="https://github.com/shoelace-style/webawesome/discussions/categories/ideas-suggestions" appearance="filled">
-      Request a Feature
-    </wa-button>
-    <wa-button href="https://github.com/shoelace-style/webawesome/issues" appearance="outlined">
-      Report a Bug
-    </wa-button>
-  </div>  
-</div>
-<wa-divider></wa-divider>
-<div class="wa-stack wa-align-items-start">
-  <div class="wa-stack wa-gap-s">
-    <h2 class="anchor-heading wa-cluster wa-gap-xs" data-no-anchor><wa-icon name="discord" family="brands" style="font-size: 2ch;"></wa-icon>Discord</h2>
-    <span class="wa-heading-m">Community & Discussion</span>
-    <p class="wa-caption-l">Ask questions, share tips, and connect with other developers in real time.</p>
-  </div>
-  <ul>
-    <li>Ask for help</li>
-    <li>Share ideas and get feedback</li>
-    <li>Show the community what you're working on</li>
-    <li>Chat live with other designers, developers, and Web Awesome supporters.</li>
-  </ul>
-  <wa-button href="https://discord.com/invite/mg8f26C" appearance="filled">
-    Join Discord
-  </wa-button>
-</div>
-<wa-divider></wa-divider>
-<div class="wa-stack wa-align-items-start">
-  <div class="wa-stack wa-gap-s">
-    <h2 class="anchor-heading wa-cluster wa-gap-xs" data-no-anchor><wa-icon name="envelope" style="font-size: 2ch;"></wa-icon>Email</h2>
-    <span class="wa-heading-m">Anything Else</span>
-    <p class="wa-caption-l">Billing questions, account access, or sensitive issues—reach our support team directly.</p>
-  </div>
-  <ul>
-    <li>Account access & login issues.</li>
-    <li>Billing or subscription questions.</li>
-    <li>Private matters you don’t want to post publicly.</li>
-  </ul>
-  <wa-button href="mailto:help@webawesome.com" appearance="filled">
-    Get Help via Email
-  </wa-button>
-</div>
-<wa-divider></wa-divider>
-</div>
-<div class="wa-stack" style="margin-block-start: var(--wa-space-xl);">
-  <div class="wa-stack wa-gap-s">
-    <h2 data-no-anchor>Socials</h2>
-    <p>We’re everywhere you are — follow us on your favorite social media platforms for the latest news and updates.</p>
-  </div>
-<div class="wa-cluster wa-caption-2xl">
-    <h2 class="wa-visually-hidden">Web Awesome Elsewhere</h2>
-    <a href="https://github.com/shoelace-style/webawesome" rel="noopener noreferrer" target="_blank" class="appearance-plain">
-      <wa-icon family="brands" name="github" label="GitHub" role="img" aria-label="GitHub" library="default"></wa-icon>
-    </a>
-    <a href="https://bsky.app/profile/webawesome.com" rel="noopener noreferrer" target="_blank" class="appearance-plain">
-      <wa-icon family="brands" name="bluesky" label="Bluesky" role="img" aria-label="Bluesky" library="default"></wa-icon>
-    </a>
-    <a href="https://mastodon.social/@webawesome" rel="noopener noreferrer" target="_blank" class="appearance-plain">
-      <wa-icon family="brands" name="mastodon" label="Mastodon" role="img" aria-label="Mastodon" library="default"></wa-icon>
-    </a>
-    <a href="https://x.com/webawesomer" rel="noopener noreferrer" target="_blank" class="appearance-plain">
-      <wa-icon family="brands" name="x-twitter" label="Twitter (X)" role="img" aria-label="Twitter (X)" library="default"></wa-icon>
-    </a>
-    <a href="https://www.threads.com/@web.awesome" rel="noopener noreferrer" target="_blank" class="appearance-plain">
-      <wa-icon family="brands" name="threads" label="Threads" role="img" aria-label="Threads" library="default"></wa-icon>
-    </a>
-  </div>
-
-</div>

packages/webawesome/docs/docs/themes.njk

@@ -4,9 +4,6 @@ description: Style (and restyle) your website at will with any of Web Awesome's
 layout: page
 ---
 
-{% from "pro-badge.njk" import proBadge %}
-{% from "free-badge.njk" import freeBadge %}
-
 <h1>{{ title }}</h1>
 
 <p>Themes are collections of <a href="/docs/tokens">design tokens</a> that give a cohesive look and feel to the entire Web Awesome library. Style and restyle your website at will by loading any pre-built theme.</p>
@@ -67,9 +64,8 @@ to create a project with any one of these themes.
   <header class="wa-stack">
     <div class="wa-cluster">
       <h2 data-theme-name="name">Theme</h2>
-      {{ freeBadge({ id: "free-badge", description: "This theme is available in the free version of Web Awesome." }) }}
-      {{ proBadge({ id: "pro-badge", description: "This theme requires access to Web Awesome Pro." }) }}
-
+      <wa-badge data-free-badge appearance="outlined" variant="neutral" hidden>FREE</wa-badge>
+      <wa-badge data-pro-badge appearance="accent" hidden>PRO</wa-badge>
     </div>
     <p data-theme-description>Description</p>
   </header>
@@ -90,70 +86,16 @@ to create a project with any one of these themes.
 </div>
 
 <h2>Using This Theme</h2>
-
 <div id="import-code">
   {% for theme in themer.themes %}
-    <div class="theme-instructions" data-theme="{{ theme.filename | stripExtension }}" {% if not loop.first %}hidden{% endif %}>
-      <wa-tab-group>
-        <wa-tab panel="cdn"><wa-icon name="rocket-launch" variant="regular"></wa-icon> CDN</wa-tab>
-        <wa-tab panel="npm"><wa-icon name="box-open" variant="regular"></wa-icon> npm</wa-tab>
-        <wa-tab panel="self-hosted"><wa-icon name="arrow-down-to-line" variant="regular"></wa-icon> Self-Hosted</wa-tab>
-
-        <wa-tab-panel name="cdn">
-{% markdown %}
-{% if theme.isPro %}
-<wa-callout variant="neutral" size="small">
-  <wa-icon name="info-circle" variant="regular"></wa-icon>
-  This theme can only be used on teams with a Pro subscription.
-</wa-callout>
-<br />
-{% else %}
-**For projects on Free teams:**
-1. Head over to your project's <wa-icon name="gear" variant="regular"></wa-icon> **Settings**.
-2. For your **Theme**, select <wa-icon name="paintbrush" variant="regular"></wa-icon> **{{ theme.filename | stripExtension | capitalize }}**.
-3. For your **Color Palette**, select <wa-icon name="swatchbook" variant="regular"></wa-icon> **{{ theme.palette.filename | stripExtension | capitalize }}**.
-4. Press **Save Changes** to immediately update anywhere you're using your project.
-{% endif %}
-
-**For projects on Pro teams:**
-1. Head over to your project's <wa-icon name="gear" variant="regular"></wa-icon> **Settings**.
-2. Press <wa-icon name="paintbrush" variant="regular"></wa-icon> **Edit Your Theme** to open the Theme Builder.
-3. Open **Theme** and select **{{ theme.filename | stripExtension | capitalize }}**.
-4. Press **Save Theme** to immediately update anywhere you're using your project.
-{% endmarkdown %}
-        </wa-tab-panel>
-
-        <wa-tab-panel name="npm">
-{% markdown %}
-To use this theme, import the theme's stylesheet:
-```js
-import '@awesome.me/webawesome/dist/styles/themes/{{ theme.filename }}';
-```
-
-Then apply the following classes to the `<html>` element:
-
-```html
-<html class="wa-theme-{{ theme.filename | stripExtension }} wa-palette-{{ theme.palette.filename | stripExtension }} wa-brand-{{ theme.colorBrand.color}}">
-```
-{% endmarkdown %}
-        </wa-tab-panel>
-
-        <wa-tab-panel name="self-hosted">
-{% markdown %}
-To use this theme, include the theme's stylesheet:
-```html
-<link rel="stylesheet" href="/dist/styles/themes/{{ theme.filename }}" />
-```
-
-Then apply the following classes to the `<html>` element:
-
-```html
-<html class="wa-theme-{{ theme.filename | stripExtension }} wa-palette-{{ theme.palette.filename | stripExtension }} wa-brand-{{ theme.colorBrand.color}}">
-```
-{% endmarkdown %}
-        </wa-tab-panel>
-      </wa-tab-group>
-    </div>
+  <div class="theme-instructions" data-theme="{{ theme.filename | stripExtension }}" {% if not loop.first %}hidden{% endif %}>
+    <p>
+      To import this theme, apply the following classes to the <code>&lt;html&gt;</code> element and import the theme's stylesheet.
+    </p>
+<pre><code class="language-html">&lt;html class=&quot;wa-theme-{{ theme.filename | stripExtension }} wa-palette-{{ theme.palette.filename | stripExtension }} wa-brand-{{ theme.colorBrand.color}}&quot;&gt;
+...
+&lt;link rel=&quot;stylesheet&quot; href=&quot;{% cdnUrl %}styles/themes/{{ theme.filename }}&quot; /&gt;</code></pre>
+  </div>
   {% endfor %}
 </div>
 
@@ -166,12 +108,8 @@ Then apply the following classes to the `<html>` element:
   const beforeFrame = document.querySelector('wa-zoomable-frame[slot="before"]');
   const nameElement = document.querySelector('[data-theme-name]');
   const descriptionElement = document.querySelector('[data-theme-description]');
-  const freeBadge = document.getElementById('free-badge');
-  const proBadge = document.getElementById('pro-badge');
-
-  // Hide both badges initially
-  if (freeBadge) freeBadge.hidden = true;
-  if (proBadge) proBadge.hidden = true;
+  const freeBadge = document.querySelector('[data-free-badge]');
+  const proBadge = document.querySelector('[data-pro-badge]');
 
   function updateFrames(selectedValue, title, description, isPro, palette, brand) {
     // Update theme classes on both frames
@@ -287,13 +225,14 @@ Then apply the following classes to the `<html>` element:
   }
 
   #theme-viewer {
+    margin-block-start: 2rem;
+
     #theme-picker {
 
       &::part(form-control-input) {
         display: flex;
         flex-direction: row;
         flex-wrap: wrap;
-        gap: var(--wa-space-m);
       }
 
       &::part(form-control-label) {
@@ -307,10 +246,6 @@ Then apply the following classes to the `<html>` element:
         white-space: nowrap;
         padding: 0;
       }
-
-      wa-radio {
-        margin-inline: 0;
-      }
     }
 
     .theme-card {

packages/webawesome/docs/docs/usage.md

@@ -40,7 +40,6 @@ await allDefined();
 
 By default, `allDefined()` will wait for all `wa-` prefixed custom elements within the current `document` to be registered.
 You can customize this behavior by passing in options:
-
 - `root` allows you to pass in a different element to search within, or a different document entirely (defaults to `document`).
 - `match` allows you to specify a custom function to determine which elements to wait for. This function should return `true` for elements you want to wait for and `false` for those you don't.
 - `additionalElements` allows you to wait for custom elements to be defined that may not be present in the DOM at the time `allDefined()` is called. This can be useful for elements that are loaded dynamically via JS.
@@ -53,7 +52,7 @@ import { allDefined } from '/dist/webawesome.js';
 await allDefined({
   match: tagName => tagName.startsWith('wa-') || tagName === 'my-component',
   root: document.getElementById('sidebar'),
-  additionalElements: ['wa-slider', 'other-slider'],
+  additionalElements: ['wa-slider', 'other-slider']
 });
 ```
 
@@ -195,11 +194,12 @@ Web Awesome ships with a file called `vscode.html-custom-data.json` that can be
 
 If `settings.json` already exists, simply add the above line to the root of the object. Note that you may need to restart VS Code for the changes to take effect.
 
+If you are using WebAwesome through the [CDN](/docs/#quick-start-autoloading-via-cdn) you can manually [download the file]({% cdnUrl 'vscode.html-custom-data.json' %}]({% cdnUrl 'vscode.html-custom-data.json' %}) instead.
+
 ### JetBrains IDEs
+If you are using a [JetBrains IDE](https://www.jetbrains.com/) and you are installing Web Awesome from NPM, the editor will automatically detect the web-types.json file from the package and you should immediately see component information in your editor.
 
-If you are using a [JetBrains IDE](https://www.jetbrains.com/) and you are installing Web Awesome from NPM, the editor will automatically detect the `web-types.json` file from the package and you should immediately see component information in your editor.
-
-Be sure to add a reference to the `web-types.json` file in your `package.json` in order for your editor to properly detect it.
+If you are installing from the CDN, you can [download a local copy]({% cdnUrl 'web-types.json' %}) and add it to the root of your project. Be sure to add a reference to the web-types.json file in your package.json in order for your editor to properly detect it.
 
 ```json
 {

packages/webawesome/docs/docs/utilities/align-items.md

@@ -1,37 +1,35 @@
 ---
 title: Align Items
-description: Align items utilities align items within flex and grid containers on the cross axis.
+description: Align items utilities set the gap property of flex and grid containers, like other Web Awesome layout utilities.
 layout: docs
 tags: layoutUtilities
 ---
 
 <style>
   .preview-wrapper {
-    border: var(--layout-example-border);
+    border: var(--wa-border-width-s) dashed var(--wa-color-neutral-border-normal);
     border-radius: var(--wa-border-radius-m);
     min-block-size: 3em;
-    min-inline-size: 5em;
     padding: var(--wa-space-2xs);
   }
-  
   .preview-block {
     aspect-ratio: 1 / 1;
-    background-color: var(--layout-example-element-background);
+    background-color: var(--wa-color-neutral-fill-loud);
     border-radius: var(--wa-border-radius-s);
     min-block-size: 1em;
   }
 </style>
 
-Web Awesome includes classes to set the `align-items` property of flex and grid containers. Use them alongside other Web Awesome layout utilities, like [cluster](/docs/utilities/cluster) and [stack](/docs/utilities/stack), to align items in a container on the container's [cross axis](#whats-the-cross-axis).
+Web Awesome includes classes to set the `align-items` property of flex and grid containers. They can be used alongside other Web Awesome layout utilities, like [cluster](/docs/utilities/cluster) and [stack](/docs/utilities/stack), to align children in container on the container's cross axis.
 
-| Class Name                | `align-items` Value | Preview                                                                                                                                             |
-| ------------------------- | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `wa-align-items-baseline` | `baseline`          | <div class="wa-cluster wa-gap-2xs wa-align-items-baseline preview-wrapper"><div class="preview-block"></div><div class="preview-block"></div></div> |
-| `wa-align-items-center`   | `center`            | <div class="wa-cluster wa-gap-2xs wa-align-items-center preview-wrapper"><div class="preview-block"></div><div class="preview-block"></div></div>   |
-| `wa-align-items-end`      | `flex-end`          | <div class="wa-cluster wa-gap-2xs wa-align-items-end preview-wrapper"><div class="preview-block"></div><div class="preview-block"></div></div>      |
-| `wa-align-items-start`    | `flex-start`        | <div class="wa-cluster wa-gap-2xs wa-align-items-start preview-wrapper"><div class="preview-block"></div><div class="preview-block"></div></div>    |
-| `wa-align-items-stretch`  | `stretch`           | <div class="wa-cluster wa-gap-2xs wa-align-items-stretch preview-wrapper"><div class="preview-block"></div><div class="preview-block"></div></div>  |
+| Class Name                | `align-items` Value | Preview                                                                                                                                  |
+| ------------------------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| `wa-align-items-baseline` | `baseline`          | <div class="wa-cluster wa-align-items-baseline preview-wrapper"><div class="preview-block"></div><div class="preview-block"></div></div> |
+| `wa-align-items-center`   | `center`            | <div class="wa-cluster wa-align-items-center preview-wrapper"><div class="preview-block"></div><div class="preview-block"></div></div>   |
+| `wa-align-items-end`      | `flex-end`          | <div class="wa-cluster wa-align-items-end preview-wrapper"><div class="preview-block"></div><div class="preview-block"></div></div>      |
+| `wa-align-items-start`    | `flex-start`        | <div class="wa-cluster wa-align-items-start preview-wrapper"><div class="preview-block"></div><div class="preview-block"></div></div>    |
+| `wa-align-items-stretch`  | `stretch`           | <div class="wa-cluster wa-align-items-stretch preview-wrapper"><div class="preview-block"></div><div class="preview-block"></div></div>  |
 
-## What's the Cross Axis?
+## What's a Cross Axis?
 
-The cross axis runs perpendicular to a container's content direction. For containers where `flex-direction` is `row` and content flows in the inline direction, the cross axis runs in the block direction. For containers where `flex-direction` is `column` and content flows in the block direction, the cross axis runs in the inline direction.
+The cross axis runs perpendicular to a flex container's content direction. For containers where `flex-direction` is `row` and content flows in the inline direction, the cross axis runs in the block direction. For containers where `flex-direction` is `column` and content flows in the block direction, the cross axis runs in the inline direction.

packages/webawesome/docs/docs/utilities/cluster.md

@@ -7,21 +7,19 @@ tags: layoutUtilities
 
 <style>
   :is(.wa-flank, .wa-grid, .wa-stack) > [class*='wa-cluster']:has(div:empty) {
-    border: var(--layout-example-border);
-    border-radius: var(--layout-example-border-radius);
-    padding: var(--layout-example-padding);
+    border: var(--wa-border-width-s) dashed var(--wa-color-neutral-border-normal);
+    border-radius: var(--wa-border-radius-l);
+    padding: var(--wa-space-s);
   }
 
   [class*='wa-cluster'] div:empty {
-    background-color: var(--layout-example-element-background);
-    border-radius: var(--layout-example-element-border-radius);
+    background-color: var(--wa-color-indigo-60);
+    border-radius: var(--wa-border-radius-m);
     min-block-size: 4rem;
     min-inline-size: 4rem;
   }
 </style>
 
-{{ description }}
-
 ```html {.example}
 <div class="wa-cluster">
   <div></div>
@@ -86,7 +84,7 @@ Clusters are great for inline lists and aligning items of varying sizes.
 
 ## Align Items
 
-By default, items are centered in the block direction of the `wa-cluster` container. You can add any of the following [`wa-align-items-*`](/docs/utilities/align-items) classes to an element with `wa-cluster` to specify how items are aligned in the block direction:
+By default, items are centered in the block direction of the `wa-cluster` container. You can add any of the following [`wa-align-items-*`](/docs/style-utilities/align-items) classes to an element with `wa-cluster` to specify how items are aligned in the block direction:
 
 - `wa-align-items-start`
 - `wa-align-items-end`
@@ -121,7 +119,7 @@ By default, items are centered in the block direction of the `wa-cluster` contai
 
 ## Gap
 
-By default, the gap between cluster items uses `--wa-space-m` from your theme. You can add any of the following [`wa-gap-*`](/docs/utilities/gap) classes to an element with `wa-cluster` to specify the gap between items:
+By default, the gap between cluster items uses `--wa-space-m` from your theme. You can add any of the following [`wa-gap-*`](/docs/style-utilities/gap) classes to an element with `wa-cluster` to specify the gap between items:
 
 - `wa-gap-0`
 - `wa-gap-3xs`

packages/webawesome/docs/docs/utilities/flank.md

@@ -7,20 +7,20 @@ tags: layoutUtilities
 
 <style>
   :is(.wa-flank, .wa-grid, .wa-stack) > [class*='wa-flank']:has(div:empty) {
-    border: var(--layout-example-border);
-    border-radius: var(--layout-example-border-radius);
-    padding: var(--layout-example-padding);
+    border: var(--wa-border-width-s) dashed var(--wa-color-neutral-border-normal);
+    border-radius: var(--wa-border-radius-l);
+    padding: var(--wa-space-s);
   }
 
   [class*='wa-flank'] div:empty {
-    background-color: var(--layout-example-element-background);
-    border-radius: var(--layout-example-element-border-radius);
+    background-color: var(--wa-color-indigo-60);
+    border-radius: var(--wa-border-radius-m);
     min-block-size: 4rem;
     min-inline-size: 4rem;
   }
 </style>
 
-{{ description }} When space is limited, the items wrap.
+When space is limited, the items wrap.
 
 ```html {.example}
 <div class="wa-flank">
@@ -137,7 +137,7 @@ The main content fills the remaining inline space of the container. By default,
 
 ## Align Items
 
-By default, items are centered in the block direction of the `wa-flank` container. You can add any of the following [`wa-align-items-*`](/docs/utilities/align-items) classes to an element with `wa-flank` to specify how items are aligned in the block direction:
+By default, items are centered in the block direction of the `wa-flank` container. You can add any of the following [`wa-align-items-*`](/docs/style-utilities/align-items) classes to an element with `wa-flank` to specify how items are aligned in the block direction:
 
 - `wa-align-items-start`
 - `wa-align-items-end`
@@ -168,7 +168,7 @@ By default, items are centered in the block direction of the `wa-flank` containe
 
 ## Gap
 
-By default, the gap between flank items uses `--wa-space-m` from your theme. You can add any of the following [`wa-gap-*`](/docs/utilities/gap) classes to an element with `wa-flank` to specify the gap between items:
+By default, the gap between flank items uses `--wa-space-m` from your theme. You can add any of the following [`wa-gap-*`](/docs/style-utilities/gap) classes to an element with `wa-flank` to specify the gap between items:
 
 - `wa-gap-0`
 - `wa-gap-3xs`

packages/webawesome/docs/docs/utilities/fouce.md

@@ -22,7 +22,7 @@ As soon as all elements are registered _or_ after two seconds have elapsed, the
 
 :::details Are you using Turbo in your app?
 
-If you're using [Turbo](https://turbo.hotwired.dev/) to serve a multi-page application (MPA) as a single page application (SPA), you might notice FOUCE when navigating from page to page. This is because Turbo renders the new page's content before the autoloader has a chance to register new components.
+If you're using [Turbo](https://turbo.hotwired.dev/) to serve a multi-page application (MPA) as a single page application (SPA), you might notice FOUCE when navigating from page to page. This is because Turbo renders the new page's content before the autoloader has a change to register new components.
 
 The following function acts as a middleware to ensure components are registered _before_ the page shows, eliminating FOUCE for page-to-page navigation with Turbo.
 

packages/webawesome/docs/docs/utilities/frame.md

@@ -7,20 +7,18 @@ tags: layoutUtilities
 
 <style>
   [class*='wa-frame']:has(div:empty) {
-    border: var(--layout-example-border);
-    padding: var(--layout-example-padding);
+    border: var(--wa-border-width-s) dashed var(--wa-color-neutral-border-normal);
+    padding: var(--wa-space-s);
   }
 
   [class*='wa-frame'] div:empty {
-    background-color: var(--layout-example-element-background);
-    border-radius: var(--layout-example-element-border-radius);
+    background-color: var(--wa-color-indigo-60);
+    border-radius: var(--wa-border-radius-m);
     min-block-size: 4rem;
     min-inline-size: 4rem;
   }
 </style>
 
-{{ description }}
-
 ```html {.example}
 <div class="wa-frame" style="max-inline-size: 20rem;">
   <div></div>
@@ -141,7 +139,7 @@ Frames have a square aspect ratio by default. You can append `:square` (1 / 1),
 
 ## Border Radius
 
-Frames have a square border radius by default. You can add any of the following [`wa-border-radius-*`](/docs/utilities/rounding) classes to an element with `wa-frame` to specify the border radius:
+Frames have a square border radius by default. You can add any of the following [`wa-border-radius-*`](/docs/style-utilities/border-radius) classes to an element with `wa-frame` to specify the border radius:
 
 - `wa-border-radius-s`
 - `wa-border-radius-m`

packages/webawesome/docs/docs/utilities/gap.md

@@ -6,37 +6,28 @@ tags: layoutUtilities
 ---
 
 <style>
-  .preview-wrapper {
-    border: var(--layout-example-border);
-    border-radius: var(--wa-border-radius-m);
-    min-block-size: 3em;
-    min-inline-size: 5em;
-    padding: var(--wa-space-2xs);
-  }
-
   .preview-block {
     aspect-ratio: 1 / 1;
-    background-color: var(--layout-example-element-background);
+    background-color: var(--wa-color-neutral-fill-loud);
     border-radius: var(--wa-border-radius-s);
-    min-block-size: 1em;
+    min-block-size: 1.5em;
   }
 </style>
 
-Web Awesome includes classes to set the `gap` property of flex and grid containers. Use them alone to create a flex container with a gap, or use them alongside other Web Awesome layout utilities, like [cluster](/docs/utilities/cluster) and [stack](/docs/utilities/stack), to change the space between items.
+Web Awesome includes classes to set the `gap` property of flex and grid containers. They can be used alongside other Web Awesome layout utilities, like [cluster](/docs/layout/cluster) and [stack](/docs/layout/stack), to change the space between items.
+Or even by themselves — all gap properties also set `display: flex` with a specificity of 0 so that it can be trivially overridden.
 
 Besides `wa-gap-0`, which sets `gap` to zero, each class corresponds to one of the [`--wa-space-*`](/docs/tokens/space) tokens in your theme.
 
 | Class Name   | `gap` Value      | Preview                                                                                                     |
 | ------------ | ---------------- | ----------------------------------------------------------------------------------------------------------- |
-| `wa-gap-0`   | `0`              | <div class="preview-wrapper wa-cluster wa-gap-0"><div class="preview-block"></div><div class="preview-block"></div></div>   |
-| `wa-gap-3xs` | `--wa-space-3xs` | <div class="preview-wrapper wa-cluster wa-gap-3xs"><div class="preview-block"></div><div class="preview-block"></div></div> |
-| `wa-gap-2xs` | `--wa-space-2xs` | <div class="preview-wrapper wa-cluster wa-gap-2xs"><div class="preview-block"></div><div class="preview-block"></div></div> |
-| `wa-gap-xs`  | `--wa-space-xs`  | <div class="preview-wrapper wa-cluster wa-gap-xs"><div class="preview-block"></div><div class="preview-block"></div></div>  |
-| `wa-gap-s`   | `--wa-space-s`   | <div class="preview-wrapper wa-cluster wa-gap-s"><div class="preview-block"></div><div class="preview-block"></div></div>   |
-| `wa-gap-m`   | `--wa-space-m`   | <div class="preview-wrapper wa-cluster wa-gap-m"><div class="preview-block"></div><div class="preview-block"></div></div>   |
-| `wa-gap-l`   | `--wa-space-l`   | <div class="preview-wrapper wa-cluster wa-gap-l"><div class="preview-block"></div><div class="preview-block"></div></div>   |
-| `wa-gap-xl`  | `--wa-space-xl`  | <div class="preview-wrapper wa-cluster wa-gap-xl"><div class="preview-block"></div><div class="preview-block"></div></div>  |
-| `wa-gap-2xl` | `--wa-space-2xl` | <div class="preview-wrapper wa-cluster wa-gap-2xl"><div class="preview-block"></div><div class="preview-block"></div></div> |
-| `wa-gap-3xl` | `--wa-space-3xl` | <div class="preview-wrapper wa-cluster wa-gap-3xl"><div class="preview-block"></div><div class="preview-block"></div></div> |
-<!-- Pending 3.2.0 release -->
-<!-- | `wa-gap-4xl` | `--wa-space-4xl` | <div class="preview-wrapper wa-cluster wa-gap-4xl"><div class="preview-block"></div><div class="preview-block"></div></div> | -->
+| `wa-gap-0`   | `0`              | <div class="wa-cluster wa-gap-0"><div class="preview-block"></div><div class="preview-block"></div></div>   |
+| `wa-gap-3xs` | `--wa-space-3xs` | <div class="wa-cluster wa-gap-3xs"><div class="preview-block"></div><div class="preview-block"></div></div> |
+| `wa-gap-2xs` | `--wa-space-2xs` | <div class="wa-cluster wa-gap-2xs"><div class="preview-block"></div><div class="preview-block"></div></div> |
+| `wa-gap-xs`  | `--wa-space-xs`  | <div class="wa-cluster wa-gap-xs"><div class="preview-block"></div><div class="preview-block"></div></div>  |
+| `wa-gap-s`   | `--wa-space-s`   | <div class="wa-cluster wa-gap-s"><div class="preview-block"></div><div class="preview-block"></div></div>   |
+| `wa-gap-m`   | `--wa-space-m`   | <div class="wa-cluster wa-gap-m"><div class="preview-block"></div><div class="preview-block"></div></div>   |
+| `wa-gap-l`   | `--wa-space-l`   | <div class="wa-cluster wa-gap-l"><div class="preview-block"></div><div class="preview-block"></div></div>   |
+| `wa-gap-xl`  | `--wa-space-xl`  | <div class="wa-cluster wa-gap-xl"><div class="preview-block"></div><div class="preview-block"></div></div>  |
+| `wa-gap-2xl` | `--wa-space-2xl` | <div class="wa-cluster wa-gap-2xl"><div class="preview-block"></div><div class="preview-block"></div></div> |
+| `wa-gap-3xl` | `--wa-space-3xl` | <div class="wa-cluster wa-gap-3xl"><div class="preview-block"></div><div class="preview-block"></div></div> |

packages/webawesome/docs/docs/utilities/grid.md

@@ -7,21 +7,19 @@ tags: layoutUtilities
 
 <style>
   :is(.wa-flank, .wa-grid, .wa-stack) > [class*='wa-grid']:has(div:empty) {
-    border: var(--layout-example-border);
-    border-radius: var(--layout-example-border-radius);
-    padding: var(--layout-example-padding);
+    border: var(--wa-border-width-s) dashed var(--wa-color-neutral-border-normal);
+    border-radius: var(--wa-border-radius-l);
+    padding: var(--wa-space-s);
   }
 
   [class*='wa-grid'] div:empty {
-    background-color: var(--layout-example-element-background);
-    border-radius: var(--layout-example-element-border-radius);
+    background-color: var(--wa-color-indigo-60);
+    border-radius: var(--wa-border-radius-m);
     min-block-size: 4rem;
     min-inline-size: 4rem;
   }
 </style>
 
-{{ description }}
-
 ```html {.example}
 <div class="wa-grid">
   <div></div>
@@ -171,7 +169,7 @@ By default, grid items will wrap when the grid's column size is less than `20ch`
 
 ## Gap
 
-By default, the gap between grid items uses `--wa-space-m` from your theme. You can add any of the following [`wa-gap-*`](/docs/utilities/gap) classes to an element with `wa-grid` to specify the gap between items:
+By default, the gap between grid items uses `--wa-space-m` from your theme. You can add any of the following [`wa-gap-*`](/docs/style-utilities/gap) classes to an element with `wa-grid` to specify the gap between items:
 
 - `wa-gap-0`
 - `wa-gap-3xs`

packages/webawesome/docs/docs/utilities/index.njk

@@ -45,54 +45,22 @@ layout: docs
 
 <wa-divider style="--spacing: var(--wa-space-3xl);"></wa-divider>
 
+<div class="max-line-length">
 {% markdown %}
-## Using {{ title }}
-{% endmarkdown %}
+## Installation
 
-<wa-tab-group>
-  <wa-tab panel="cdn"><wa-icon name="rocket-launch" variant="regular"></wa-icon> CDN</wa-tab>
-  <wa-tab panel="npm"><wa-icon name="box-open" variant="regular"></wa-icon> npm</wa-tab>
-  <wa-tab panel="self-hosted"><wa-icon name="arrow-down-to-line" variant="regular"></wa-icon> Self-Hosted</wa-tab>
-
-  <wa-tab-panel name="cdn">
-{% markdown %}
-1. Head over to your project's <wa-icon name="gear" variant="regular"></wa-icon> **Settings**.
-2. Next to **Features**, select the **CSS utilities** checkbox.
-3. **Save Changes** to immediately update anywhere you're using your project.
-{% endmarkdown %}
-  </wa-tab-panel>
-
-  <wa-tab-panel name="npm">
-{% markdown %}
-To use all Web Awesome styles (including [native styles](/docs/utilities/native/)), import the following stylesheet in your project:
-
-```js
-import '@awesome.me/webawesome/dist/styles/webawesome.css';
-```
-
-Or, if you only want CSS utility classes, import a theme and the utilities individually:
-
-```js
-import '@awesome.me/webawesome/dist/styles/themes/default.css';
-import '@awesome.me/webawesome/dist/styles/utilities.css';
-```
-{% endmarkdown %}
-  </wa-tab-panel>
-
-  <wa-tab-panel name="self-hosted">
-{% markdown %}
-To use all Web Awesome styles (including [native styles](/docs/utilities/native/)), include the following stylesheet in your project:
+To use all Web Awesome page styles (including [native styles](/docs/utilities/native/)), include the following stylesheet in your project:
 
 ```html
-<link rel="stylesheet" href="/dist/styles/webawesome.css" />
+<link rel="stylesheet" href="{% cdnUrl 'styles/webawesome.css' %}" />
 ```
 
-Or, if you only want CSS utility classes, include a theme and the utilities individually:
+Or, to _only_ include utilities:
 
 ```html
-<link rel="stylesheet" href="/dist/styles/themes/default.css" />
-<link rel="stylesheet" href="/dist/styles/utilities.css" />
+<link rel="stylesheet" href="{% cdnUrl 'styles/utilities.css' %}" />
 ```
+
 {% endmarkdown %}
-  </wa-tab-panel>
-</wa-tab-group>
+
+</div>

packages/webawesome/docs/docs/utilities/justify-content.md

@@ -1,40 +0,0 @@
----
-title: Justify Content
-description: Justify content utilities determine how space is distributed between items in flex and grid containers.
-layout: docs
-tags: layoutUtilities
-unpublished: true
-unlisted: true
----
-
-<style>
-  .preview-wrapper {
-    border: var(--layout-example-border);
-    border-radius: var(--wa-border-radius-m);
-    min-block-size: 3em;
-    min-inline-size: 5em;
-    padding: var(--wa-space-2xs);
-  }
-
-  .preview-block {
-    aspect-ratio: 1 / 1;
-    background-color: var(--layout-example-element-background);
-    border-radius: var(--wa-border-radius-s);
-    min-block-size: 1em;
-  }
-</style>
-
-Web Awesome includes classes to set the `justify-content` property of flex and grid containers. Use them alongside other Web Awesome layout utilities, like [cluster](/docs/utilities/cluster) and [stack](/docs/utilities/stack), to distribute space between items along the container's [main axis](#whats-the-main-axis).
-
-| Class Name                         | `justify-content` Value | Preview                                                                                                                                                      |
-| ---------------------------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `wa-justify-content-start`         | `flex-start`            | <div class="wa-cluster wa-gap-2xs wa-justify-content-start preview-wrapper"><div class="preview-block"></div><div class="preview-block"></div></div>         |
-| `wa-justify-content-end`           | `flex-end`              | <div class="wa-cluster wa-gap-2xs wa-justify-content-end preview-wrapper"><div class="preview-block"></div><div class="preview-block"></div></div>           |
-| `wa-justify-content-center`        | `center`                | <div class="wa-cluster wa-gap-2xs wa-justify-content-center preview-wrapper"><div class="preview-block"></div><div class="preview-block"></div></div>        |
-| `wa-justify-content-space-around`  | `space-around`          | <div class="wa-cluster wa-gap-2xs wa-justify-content-space-around preview-wrapper"><div class="preview-block"></div><div class="preview-block"></div></div>  |
-| `wa-justify-content-space-between` | `space-between`         | <div class="wa-cluster wa-gap-2xs wa-justify-content-space-between preview-wrapper"><div class="preview-block"></div><div class="preview-block"></div></div> |
-| `wa-justify-content-space-evenly`  | `space-evenly`          | <div class="wa-cluster wa-gap-2xs wa-justify-content-space-evenly preview-wrapper"><div class="preview-block"></div><div class="preview-block"></div></div>  |
-
-## What's the Main Axis?
-
-The main axis runs parallel to a container's content direction. For grid containers and flex containers where `flex-direction` is `row`, the main axis runs in the inline direction. For containers where `flex-direction` is `column`, the main axis runs in the block direction.

packages/webawesome/docs/docs/utilities/native.md

@@ -9,53 +9,18 @@ Native styles use design tokens to spruce up native HTML elements so that they m
 
 ## Using native styles
 
-<wa-tab-group>
-  <wa-tab panel="cdn"><wa-icon name="rocket-launch" variant="regular"></wa-icon> CDN</wa-tab>
-  <wa-tab panel="npm"><wa-icon name="box-open" variant="regular"></wa-icon> npm</wa-tab>
-  <wa-tab panel="self-hosted"><wa-icon name="arrow-down-to-line" variant="regular"></wa-icon> Self-Hosted</wa-tab>
-
-  <wa-tab-panel name="cdn">
-{% markdown %}
-1. Head over to your project's <wa-icon name="gear" variant="regular"></wa-icon> **Settings**.
-2. Next to **Features**, select the **Native styles** checkbox.
-3. **Save Changes** to immediately update anywhere you're using your project.
-{% endmarkdown %}
-  </wa-tab-panel>
-
-  <wa-tab-panel name="npm">
-{% markdown %}
-To use all Web Awesome styles (including [utilities](/docs/utilities/)), import the following stylesheet in your project:
-
-```js
-import '@awesome.me/webawesome/dist/styles/webawesome.css';
-```
-
-Or, if you only want styles for native elements, import a theme and native styles individually:
-
-```js
-import '@awesome.me/webawesome/dist/styles/themes/default.css';
-import '@awesome.me/webawesome/dist/styles/native.css';
-```
-{% endmarkdown %}
-  </wa-tab-panel>
-
-  <wa-tab-panel name="self-hosted">
-{% markdown %}
 To use all Web Awesome styles (including [utilities](/docs/utilities/)), include the following stylesheet in your project:
 
 ```html
-<link rel="stylesheet" href="/dist/styles/webawesome.css" />
+<link rel="stylesheet" href="{% cdnUrl 'styles/webawesome.css' %}" />
 ```
 
-Or, if you only want styles for native elements, include a theme and native styles individually:
+Or, if you only want styles for native elements, include the default theme and native styles individually:
 
 ```html
-<link rel="stylesheet" href="/dist/styles/themes/default.css" />
-<link rel="stylesheet" href="/dist/styles/native.css" />
+<link rel="stylesheet" href="{% cdnUrl 'styles/themes/default.css' %}" />
+<link rel="stylesheet" href="{% cdnUrl 'styles/native.css' %}" />
 ```
-{% endmarkdown %}
-  </wa-tab-panel>
-</wa-tab-group>
 
 You can additionally include any pre-made [theme](/docs/themes/) or [color palette](/docs/color-palettes/) to change the look of native elements.
 
@@ -65,18 +30,10 @@ Native styles set default space between many block-level HTML elements using the
 
 ```html {.example}
 <h3>Curabitur odio ligula</h3>
-<p>
-  Fusce mollis quam lorem, et gravida arcu laoreet ut. Pellentesque et malesuada mi. Morbi faucibus nisl nec nulla
-  porta, ac scelerisque elit finibus.
-</p>
-<blockquote>
-  The Road goes ever on and on<br />
-  Out from the door where it began.
-</blockquote>
-<p>
-  Donec varius, ipsum sit amet lobortis tristique, quam arcu pellentesque turpis, non porta lacus arcu non arcu. Morbi
-  luctus at nisl sit amet faucibus.
-</p>
+<p>Fusce mollis quam lorem, et gravida arcu laoreet ut. Pellentesque et malesuada mi. Morbi faucibus nisl nec nulla porta, ac scelerisque elit finibus.</p>
+<blockquote>The Road goes ever on and on<br />
+Out from the door where it began.</blockquote>
+<p>Donec varius, ipsum sit amet lobortis tristique, quam arcu pellentesque turpis, non porta lacus arcu non arcu. Morbi luctus at nisl sit amet faucibus.</p>
 <hr />
 <ul>
   <li>Aenean imperdiet</li>
@@ -234,8 +191,8 @@ Use any inline text element like `<strong>`, `<em>`, `<a>`, `<kbd>`, and others
 Add responsive media with `<img>`, `<svg>`, `<video>`, `<iframe>`, and others. Media takes up 100% width by default and scales according to its container's width.
 
 ```html {.example}
-<img
-  src="https://images.unsplash.com/photo-1620196244888-d31ff5bbf163?q=80&w=1000&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+<img 
+  src="https://images.unsplash.com/photo-1620196244888-d31ff5bbf163?q=80&w=1000&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D" 
   alt="A gray kitten lays next to a toy"
 />
 ```
@@ -247,9 +204,7 @@ Structure tabular data with `<table>` and related elements like `<caption>`, `<t
 ```html {.example}
 <table>
   <caption>
-    This
-    <code>&lt;caption&gt;</code>
-    describes the table
+    This <code>&lt;caption&gt;</code> describes the table
   </caption>
   <thead>
     <tr>
@@ -392,6 +347,7 @@ Create buttons with `<button>` or `<input type="button | submit | reset">`. Butt
 
 Add the `wa-brand`, `wa-neutral`, `wa-success`, `wa-warning`, or `wa-danger` class to specify the button's [color variant](/docs/utilities/color/).
 
+
 ```html {.example}
 <button class="wa-neutral">Neutral</button>
 <button class="wa-brand">Brand</button>
@@ -450,8 +406,7 @@ Create a variety of form controls with `<input type="">`, `<select>`, and `<text
   <label>Color <input type="color" value="#f36944" /></label>
   <label>File <input type="file" multiple /></label>
   <label>Range <input type="range" /></label>
-  <label
-    >Select
+  <label>Select
     <select>
       <option value="option-1">Option 1</option>
       <option value="option-2">Option 2</option>
@@ -477,7 +432,6 @@ Create a variety of form controls with `<input type="">`, `<select>`, and `<text
 ```
 
 Add the `wa-size-s`, `wa-size-m`, or `wa-size-l` class to any form control or its parent `<label>` to specify its size.
-
 ```html {.example}
 <div class="wa-stack">
   <input type="text" placeholder="Small input" class="wa-size-s" />
@@ -556,8 +510,7 @@ Wrap form controls in a flex container to arrange them horizontally or verticall
 
 <form class="wa-stack">
   <label>Number of pancakes <input type="number" value="5" /></label>
-  <label
-    >Syrup flavor
+  <label>Syrup flavor
     <select>
       <option value="maple">Maple</option>
       <option value="strawberry">Strawberry</option>

packages/webawesome/docs/docs/utilities/rounding.md

@@ -12,7 +12,7 @@ tags: styleUtilities
   }
 </style>
 
-Web Awesome includes classes to set an element's `border-radius` property. They can be used alongside Web Awesome layout utilities, like [frame](/docs/utilities/frame), to round all corners of an element.
+Web Awesome includes classes to set an element's `border-radius` property. They can be used alongside Web Awesome layout utilities, like [frame](/docs/layout/frame), to round all corners of an element.
 
 Each class corresponds to one of the [`--wa-border-radius-*`](/docs/tokens/borders/#radius) tokens in your theme.
 

packages/webawesome/docs/docs/utilities/split.md

@@ -7,21 +7,19 @@ tags: layoutUtilities
 
 <style>
   :is(.wa-flank, .wa-grid, .wa-stack) > [class*='wa-split']:has(div:empty) {
-    border: var(--layout-example-border);
-    border-radius: var(--layout-example-border-radius);
-    padding: var(--layout-example-padding);
+    border: var(--wa-border-width-s) dashed var(--wa-color-neutral-border-normal);
+    border-radius: var(--wa-border-radius-l);
+    padding: var(--wa-space-s);
   }
 
   [class*='wa-split'] div:empty {
-    background-color: var(--layout-example-element-background);
-    border-radius: var(--layout-example-element-border-radius);
+    background-color: var(--wa-color-indigo-60);
+    border-radius: var(--wa-border-radius-m);
     min-block-size: 4rem;
     min-inline-size: 4rem;
   }
 </style>
 
-{{ description }}
-
 ```html {.example}
 <div class="wa-split">
   <div></div>
@@ -108,7 +106,7 @@ Items can be split across a row or a column by appending `:row` or `:column` to
 
 ## Align Items
 
-By default, items are centered on the cross axis of the `wa-split` container. You can add any of the following [`wa-align-items-*`](/docs/utilities/align-items) classes to an element with `wa-split` to specify how items are aligned:
+By default, items are centered on the cross axis of the `wa-split` container. You can add any of the following [`wa-align-items-*`](/docs/style-utilities/align-items) classes to an element with `wa-split` to specify how items are aligned:
 
 - `wa-align-items-start`
 - `wa-align-items-end`
@@ -141,7 +139,7 @@ These modifiers specify how items are aligned in the block direction for `wa-spl
 
 ## Gap
 
-A split's gap determines how close items can be before they wrap. By default, the gap between split items uses `--wa-space-m` from your theme. You can add any of the following [`wa-gap-*`](/docs/utilities/gap) classes to an element with `wa-split` to specify the gap between items:
+A split's gap determines how close items can be before they wrap. By default, the gap between split items uses `--wa-space-m` from your theme. You can add any of the following [`wa-gap-*`](/docs/style-utilities/gap) classes to an element with `wa-split` to specify the gap between items:
 
 - `wa-gap-0`
 - `wa-gap-3xs`

packages/webawesome/docs/docs/utilities/stack.md

@@ -7,21 +7,19 @@ tags: layoutUtilities
 
 <style>
   :is(.wa-flank, .wa-grid, .wa-stack) > [class*='wa-stack']:has(div:empty) {
-    border: var(--layout-example-border);
-    border-radius: var(--layout-example-border-radius);
-    padding: var(--layout-example-padding);
+    border: var(--wa-border-width-s) dashed var(--wa-color-neutral-border-normal);
+    border-radius: var(--wa-border-radius-l);
+    padding: var(--wa-space-s);
   }
 
   [class*='wa-stack'] div:empty {
-    background-color: var(--layout-example-element-background);
-    border-radius: var(--layout-example-element-border-radius);
+    background-color: var(--wa-color-indigo-60);
+    border-radius: var(--wa-border-radius-m);
     min-block-size: 4rem;
     min-inline-size: 4rem;
   }
 </style>
 
-{{ description }}
-
 ```html {.example}
 <div class="wa-stack">
   <div></div>
@@ -64,7 +62,7 @@ Stacks are well suited for forms, text, and ensuring consistent spacing between
 
 ## Align Items
 
-By default, items stretch to fill the inline size of the `wa-stack` container. You can add any of the following [`wa-align-items-*`](/docs/utilities/align-items) classes to an element with `wa-stack` to specify how items are aligned in the inline direction:
+By default, items stretch to fill the inline size of the `wa-stack` container. You can add any of the following [`wa-align-items-*`](/docs/style-utilities/align-items) classes to an element with `wa-stack` to specify how items are aligned in the inline direction:
 
 - `wa-align-items-start`
 - `wa-align-items-end`
@@ -94,7 +92,7 @@ By default, items stretch to fill the inline size of the `wa-stack` container. Y
 
 ## Gap
 
-By default, the gap between stack items uses `--wa-space-m` from your theme. You can add any of the following [`wa-gap-*`](/docs/utilities/gap) classes to an element with `wa-stack` to specify the gap between items:
+By default, the gap between stack items uses `--wa-space-m` from your theme. You can add any of the following [`wa-gap-*`](/docs/style-utilities/gap) classes to an element with `wa-stack` to specify the gap between items:
 
 - `wa-gap-0`
 - `wa-gap-3xs`

packages/webawesome/docs/index.md

@@ -238,14 +238,22 @@ layout: page
         {% if currentUser.hasPro %}
           <span class="wa-font-size-l" style="text-align: center; width: 100%;">Thanks for being a Web Awesome Pro subscriber!</span>
         {% else %}
-          <div class="wa-stack wa-gap-xs">
-            <h3 class="wa-heading-m">Get More with Web Awesome Pro!</h3>
-            <p>Unlock Pro-only themes, components, patterns, and great services like the Theme Builder.</p>
-          </div>
-          <wa-button class="wa-dark" size="small" href="/purchase">
-            <wa-icon slot="start" name="rocket-launch"></wa-icon>
-            Purchase Pro
-          </wa-button>
+          {% if App.flags.stripeEnabled %}
+            <div class="wa-stack wa-gap-xs">
+              <h3 class="wa-heading-m">Get More with Web Awesome Pro!</h3>
+              <p>Unlock Pro-only themes, components, patterns, and great services like the Theme Builder.</p>
+            </div>
+            <wa-button class="wa-dark" size="small" href="/purchase">
+              <wa-icon slot="start" name="rocket-launch"></wa-icon>
+              Purchase Pro
+            </wa-button>
+          {% else %}
+            <span><em>Psst!</em> You can pre-order Web Awesome Pro at a low, guaranteed-for-life price &mdash; but not for long. Get in while the gettin’s good.</span>
+            <wa-button class="wa-dark" size="small" href="https://www.kickstarter.com/projects/fontawesome/web-awesome">
+              <wa-icon slot="start" name="person-running"></wa-icon>
+              Pre-order WA Pro
+            </wa-button>
+          {% endif %}
         {% endif %}
       {% endraw %}
     </div>

packages/webawesome/docs/manifest.json

@@ -1,21 +0,0 @@
-{
-  "name": "Web Awesome",
-  "short_name": "Web Awesome",
-  "description": "Build better with Web Awesome, the open source library of web components from Font Awesome.",
-  "start_url": "/",
-  "display": "standalone",
-  "theme_color": "#f36944",
-  "background_color": "#ffffff",
-  "icons": [
-    {
-      "src": "/assets/images/app-icons/app-icon-192x192.png",
-      "sizes": "192x192",
-      "type": "image/png"
-    },
-    {
-      "src": "/assets/images/app-icons/app-icon-512x512.png",
-      "sizes": "512x512",
-      "type": "image/png"
-    }
-  ]
-}

packages/webawesome/package.json

@@ -4,11 +4,11 @@
     "access": "public"
   },
   "description": "A forward-thinking library of web components.",
-  "version": "3.1.0",
+  "version": "3.0.0-beta.6",
   "homepage": "https://webawesome.com/",
   "author": "Web Awesome",
   "license": "MIT",
-  "customElements": "dist-cdn/custom-elements.json",
+  "customElements": "dist/custom-elements.json",
   "web-types": "./dist/web-types.json",
   "type": "module",
   "types": "dist/webawesome.d.ts",
@@ -30,19 +30,12 @@
     "./dist/react/*": "./dist/react/*",
     "./dist/translations": "./dist/translations",
     "./dist/translations/*": "./dist/translations/*",
-    "./dist/utilities": "./dist/utilities",
-    "./dist/utilities/*": "./dist/utilities/*",
-    "./dist/events": "./dist/events",
-    "./dist/events/*": "./dist/events/*",
     "./package.json": "./package.json"
   },
   "files": [
     "README.md",
     "dist",
-    "dist-cdn",
-    "dist/custom-elements.json",
-    "./dist/custom-elements.json",
-    "custom-elements.json"
+    "dist-cdn"
   ],
   "keywords": [
     "web components",
@@ -71,10 +64,10 @@
     "spellcheck": "cspell \"**/*.{js,ts,json,html,css,md}\" --no-progress --config=\"../../cspell.json\"",
     "verify": "npm run prettier && npm run build && npm run test",
     "prepublishOnly": "npm run verify",
-    "check-updates": "npm-check-updates --cooldown 7 --interactive --format group",
+    "check-updates": "npx npm-check-updates --interactive --format group",
     "print-version": "echo $npm_package_version",
     "tag-version": "git tag -a \"v$(npm run print-version | tail -n1)\" -m \"tag v$(npm run print-version | tail -n1)\"",
-    "postversion": "node ./scripts/update-root-version.js"
+    "postversion": "npm run tag-version"
   },
   "engines": {
     "node": ">=14.17.0"
@@ -96,11 +89,7 @@
     ]
   },
   "devDependencies": {
-    "@wc-toolkit/cem-validator": "^1.0.3",
     "@wc-toolkit/jsx-types": "^1.3.0",
-    "eleventy-plugin-git-commit-date": "^0.1.3",
-    "esbuild": "^0.25.11",
-    "gray-matter": "^4.0.3",
-    "npm-check-updates": "^19.1.2"
+    "eleventy-plugin-git-commit-date": "^0.1.3"
   }
 }

packages/webawesome/scripts/build.js

@@ -215,11 +215,6 @@ export async function build(options = {}) {
         ...(await globby(posix.join(rootDir, 'src/components/**/!(*.(style|test)).ts'))),
         // Translations
         ...(await globby(posix.join(rootDir, 'src/translations/**/*.ts'))),
-        // Utilities
-        ...(await globby(posix.join(rootDir, 'src/utilities/**/*.ts'))),
-        // Events
-        ...(await globby(posix.join(rootDir, 'src/events/**/*.ts'))),
-        // TODO: Should `src/internal` be included?
         // React wrappers
         ...(await globby(posix.join(rootDir, 'src/react/**/*.ts'))),
       ],
@@ -235,6 +230,9 @@ export async function build(options = {}) {
         js: `/*! Copyright ${currentYear} Fonticons, Inc. - https://webawesome.com/license */`,
       },
       plugins: [replace({ __WEBAWESOME_VERSION__: await getVersion() })],
+      loader: {
+        '.css': 'text',
+      },
     };
 
     const unbundledConfig = {
@@ -440,7 +438,6 @@ export async function build(options = {}) {
             }
 
             // copy everything to unbundled before we generate bundles.
-            // this may cause watcher events to break. if things are broken with file watching, comment this out.
             await copy(getCdnDir(), getDistDir(), { overwrite: true });
             await regenerateBundle();
 

packages/webawesome/scripts/llms.js

@@ -1,268 +0,0 @@
-import fs from 'fs';
-import matter from 'gray-matter';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import { getAllComponents } from './shared.js';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-/** Removes newlines from text to keep llms.txt formatting clean. */
-function removeNewlines(str) {
-  return str ? str.replace(/\n/g, ' ').trim() : '';
-}
-
-/** Loads front-matter from all component markdown files. */
-function loadAllFrontMatter(components, docsDir) {
-  const cache = new Map();
-
-  for (const component of components) {
-    if (!component.tagName) {
-      continue;
-    }
-
-    const componentName = component.tagName.replace(/^wa-/, '');
-    const mdPath = path.join(docsDir, 'docs/components', `${componentName}.md`);
-
-    if (fs.existsSync(mdPath)) {
-      try {
-        const content = fs.readFileSync(mdPath, 'utf-8');
-        const { data } = matter(content);
-        cache.set(component.tagName, data);
-      } catch {
-        // Skip if parsing fails
-      }
-    }
-  }
-
-  return cache;
-}
-
-/** Generates the API reference section for a single component. */
-function generateComponentApiSection(component, frontMatterCache, baseUrl) {
-  const lines = [];
-
-  if (!component.tagName) {
-    return lines;
-  }
-
-  const frontMatter = frontMatterCache.get(component.tagName);
-  const componentSlug = component.tagName.replace(/^wa-/, '');
-  const description = removeNewlines(frontMatter?.description || component.summary || '');
-
-  lines.push(`#### \`<${component.tagName}>\``);
-  lines.push('');
-  lines.push(`**Description:** ${description || 'No description available.'}`);
-  lines.push('');
-  lines.push(`**Documentation:** ${baseUrl}/docs/components/${componentSlug}`);
-  lines.push('');
-
-  // Slots
-  if (component.slots?.length > 0) {
-    lines.push('**Slots:**');
-    lines.push('');
-    for (const slot of component.slots) {
-      const slotName = slot.name || '(default)';
-      lines.push(`- \`${slotName}\`: ${removeNewlines(slot.description) || 'No description.'}`);
-    }
-    lines.push('');
-  }
-
-  // Properties
-  const properties =
-    component.members?.filter(m => m.kind === 'field' && m.privacy !== 'private' && m.description) || [];
-
-  if (properties.length > 0) {
-    lines.push('**Properties:**');
-    lines.push('');
-    for (const prop of properties) {
-      // Find corresponding attribute if any
-      const attr = component.attributes?.find(a => a.fieldName === prop.name);
-      const attrNote = attr && attr.name !== prop.name ? ` (attribute: \`${attr.name}\`)` : '';
-      const typeStr = prop.type?.text ? `Type: \`${removeNewlines(prop.type.text)}\`` : '';
-      const defaultStr = prop.default ? `Default: \`${prop.default}\`` : '';
-      const meta = [typeStr, defaultStr].filter(Boolean).join(', ');
-
-      lines.push(
-        `- \`${prop.name}\`${attrNote}: ${removeNewlines(prop.description) || 'No description.'}${meta ? ` (${meta})` : ''}`,
-      );
-    }
-    lines.push('');
-  }
-
-  // Methods
-  const methods = component.members?.filter(m => m.kind === 'method' && m.privacy !== 'private' && m.description) || [];
-
-  if (methods.length > 0) {
-    lines.push('**Methods:**');
-    lines.push('');
-    for (const method of methods) {
-      const params = method.parameters?.length
-        ? `(${method.parameters.map(p => `${p.name}: ${removeNewlines(p.type?.text) || 'unknown'}`).join(', ')})`
-        : '()';
-      lines.push(`- \`${method.name}${params}\`: ${removeNewlines(method.description) || 'No description.'}`);
-    }
-    lines.push('');
-  }
-
-  // Events
-  const events = component.events?.filter(e => e.name) || [];
-  if (events.length > 0) {
-    lines.push('**Events:**');
-    lines.push('');
-    for (const event of events) {
-      lines.push(`- \`${event.name}\`: ${removeNewlines(event.description) || 'No description.'}`);
-    }
-    lines.push('');
-  }
-
-  // CSS Custom Properties
-  if (component.cssProperties?.length > 0) {
-    lines.push('**CSS Custom Properties:**');
-    lines.push('');
-    for (const prop of component.cssProperties) {
-      const defaultStr = prop.default ? ` (Default: \`${prop.default}\`)` : '';
-      lines.push(`- \`${prop.name}\`: ${removeNewlines(prop.description) || 'No description.'}${defaultStr}`);
-    }
-    lines.push('');
-  }
-
-  // CSS Parts
-  if (component.cssParts?.length > 0) {
-    lines.push('**CSS Parts:**');
-    lines.push('');
-    for (const part of component.cssParts) {
-      lines.push(`- \`${part.name}\`: ${removeNewlines(part.description) || 'No description.'}`);
-    }
-    lines.push('');
-  }
-
-  // CSS States
-  if (component.cssStates?.length > 0) {
-    lines.push('**CSS States:**');
-    lines.push('');
-    for (const state of component.cssStates) {
-      lines.push(`- \`${state.name}\`: ${removeNewlines(state.description) || 'No description.'}`);
-    }
-    lines.push('');
-  }
-
-  return lines;
-}
-
-/**
- * Generates the complete llms.txt content.
- */
-function generateLlmsTxt({ components, packageData, frontMatterCache, baseUrl }) {
-  // Account for base "abstract elements" that don't have a tagName.
-  components = components.filter(c => c.tagName);
-  const lines = [];
-
-  // H1 Title (required by llmstxt.org spec)
-  lines.push('# Web Awesome');
-  lines.push('');
-
-  // Blockquote summary
-  lines.push(`> ${packageData.description} Version ${packageData.version}.`);
-  lines.push('');
-
-  // Overview section
-  lines.push(
-    `
-Web Awesome provides a comprehensive set of customizable, accessible web components for building modern
-web applications. All components use shadow DOM and are framework-agnostic, working with vanilla JavaScript
-or any framework including React, Vue, Angular, and Svelte.
-
-Form controls are form-associated custom elements that work with native form validation and the
-Constraint Validation API.
-
-Font Awesome is the default icon library, so \`<wa-icon name="...">\` values should reference Font Awesome
-icon names.
-`.trim(),
-  );
-  lines.push('');
-
-  //
-  // Documentation
-  //
-  lines.push('## Documentation');
-  lines.push('');
-  lines.push(`For comprehensive documentation, visit ${baseUrl}/docs/`);
-  lines.push('');
-  lines.push(`- [Getting Started](${baseUrl}/docs/getting-started): Installation and setup guide`);
-  lines.push(`- [Components Overview](${baseUrl}/docs/components): Complete component reference`);
-  lines.push(`- [Theming](${baseUrl}/docs/theming): Customization and design tokens`);
-  lines.push(`- [Form Controls](${baseUrl}/docs/form-controls): Form integration and validation`);
-  lines.push('');
-
-  //
-  // Components
-  //
-  lines.push('## Components');
-  lines.push('');
-
-  const sortedComponentsList = components.filter(c => c.tagName).sort((a, b) => a.tagName.localeCompare(b.tagName));
-
-  for (const component of sortedComponentsList) {
-    const frontMatter = frontMatterCache.get(component.tagName);
-    const description = removeNewlines(frontMatter?.description || component.summary || '');
-    const componentSlug = component.tagName.replace(/^wa-/, '');
-    const title = frontMatter?.title || componentSlug;
-
-    lines.push(
-      `- [${title}](${baseUrl}/docs/components/${componentSlug}): ${description || 'No description available.'}`,
-    );
-  }
-  lines.push('');
-
-  //
-  // Optional
-  //
-  lines.push('## Optional');
-  lines.push('');
-  lines.push(
-    `The following is a quick reference describing every component's API. For comprehensive documentation, refer to the component documentation using the URLs provided above.`,
-  );
-  lines.push('');
-
-  // Sort components alphabetically by tag name for the API reference
-  const sortedComponents = components.filter(c => c.tagName).sort((a, b) => a.tagName.localeCompare(b.tagName));
-
-  for (const component of sortedComponents) {
-    lines.push(...generateComponentApiSection(component, frontMatterCache, baseUrl));
-  }
-
-  return lines.join('\n').trim();
-}
-
-/**
- * A CEM plugin that generates an llms.txt file following the llmstxt.org specification.
- */
-export function llmsTxtPlugin(options = {}) {
-  const {
-    outdir = 'dist-cdn',
-    docsDir = path.resolve(__dirname, '../docs'),
-    baseUrl = 'https://webawesome.com',
-  } = options;
-
-  return {
-    name: 'wa-llms-txt',
-    packageLinkPhase({ customElementsManifest }) {
-      const components = getAllComponents(customElementsManifest);
-      const packageData = customElementsManifest.package || {};
-      const frontMatterCache = loadAllFrontMatter(components, docsDir);
-
-      const llmsTxt = generateLlmsTxt({
-        components,
-        packageData,
-        frontMatterCache,
-        baseUrl,
-      });
-
-      // Write to the output directory
-      const outputPath = path.join(outdir, 'llms.txt');
-      fs.writeFileSync(outputPath, llmsTxt, 'utf-8');
-    },
-  };
-}
-
-export default llmsTxtPlugin;

packages/webawesome/scripts/make-react.js

@@ -22,9 +22,6 @@ const components = getAllComponents(metadata);
 const index = [];
 
 for await (const component of components) {
-  if (!component.tagName) {
-    continue;
-  }
   const tagWithoutPrefix = component.tagName.replace(/^wa-/, '');
   const componentDir = path.join(reactDir, tagWithoutPrefix);
   const componentFile = path.join(componentDir, 'index.ts');

packages/webawesome/scripts/plop/plopfile.js

@@ -37,7 +37,7 @@ export default function (plop) {
       },
       {
         type: 'add',
-        path: '../../src/components/{{ tagWithoutPrefix tag }}/{{ tagWithoutPrefix tag }}.styles.ts',
+        path: '../../src/components/{{ tagWithoutPrefix tag }}/{{ tagWithoutPrefix tag }}.css',
         templateFile: 'templates/component/styles.hbs',
       },
       {

packages/webawesome/scripts/plop/templates/component/component.hbs

@@ -2,7 +2,7 @@ import { html } from 'lit';
 import { customElement, property } from 'lit/decorators.js';
 import { watch } from '../../internal/watch.js';
 import WebAwesomeElement from '../../internal/webawesome-element.js';
-import styles from './{{ tagWithoutPrefix tag }}.styles.js';
+import styles from './{{ tagWithoutPrefix tag }}.css';
 
 /**
  * @summary Short summary of the component's intended use.
@@ -21,7 +21,7 @@ import styles from './{{ tagWithoutPrefix tag }}.styles.js';
  */
  @customElement("{{ tag }}")
 export default class {{ properCase tag }} extends WebAwesomeElement {
-  static css = [styles];
+  static css = styles;
 
   /** An example attribute. */
   @property() attr = 'example';

packages/webawesome/scripts/plop/templates/component/styles.hbs

@@ -1,7 +1,3 @@
-import { css } from "lit";
-
-export default css`
-  :host {
-    display: block;
+:host {
+  display: block;
 }
-`

packages/webawesome/scripts/update-root-version.js

@@ -1,27 +0,0 @@
-#!/usr/bin/env node
-
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import * as url from 'url';
-
-const __dirname = url.fileURLToPath(new URL('.', import.meta.url));
-
-const monorepoRoot = path.resolve(__dirname, '..', '..', '..');
-const rootPackageJSONFile = path.join(monorepoRoot, 'package.json');
-const webawesomePackageJSONFile = path.join(path.resolve(__dirname, '..'), 'package.json');
-
-const rootPackageJSON = JSON.parse(fs.readFileSync(rootPackageJSONFile, { encoding: 'utf8' }));
-const webawesomePackageJSON = JSON.parse(fs.readFileSync(webawesomePackageJSONFile, { encoding: 'utf8' }));
-
-const currentVersion = webawesomePackageJSON.version;
-rootPackageJSON.version = currentVersion;
-
-fs.writeFileSync(rootPackageJSONFile, JSON.stringify(rootPackageJSON, null, 2));
-
-const versionsFile = path.join(monorepoRoot, 'VERSIONS.txt');
-const versions = fs.readFileSync(versionsFile, { encoding: 'utf8' }).split(/\r?\n/);
-
-// TODO: Make this smart and understand semver and "insert" in the correct spot instead of appending.
-if (!versions.includes(currentVersion)) {
-  fs.appendFileSync(versionsFile, webawesomePackageJSON.version);
-}

packages/webawesome/src/components/animated-image/animated-image.css

@@ -0,0 +1,65 @@
+:host {
+  --control-box-size: 3rem;
+  --icon-size: calc(var(--control-box-size) * 0.625);
+
+  display: inline-flex;
+  position: relative;
+  cursor: pointer;
+}
+
+img {
+  display: block;
+  width: 100%;
+  height: 100%;
+}
+
+img[aria-hidden='true'] {
+  display: none;
+}
+
+.control-box {
+  display: flex;
+  position: absolute;
+  align-items: center;
+  justify-content: center;
+  top: calc(50% - var(--control-box-size) / 2);
+  right: calc(50% - var(--control-box-size) / 2);
+  width: var(--control-box-size);
+  height: var(--control-box-size);
+  font-size: calc(var(--icon-size) * 0.75);
+  background: none;
+  border: solid var(--wa-border-width-s) currentColor;
+  background-color: rgb(0 0 0 / 50%);
+  border-radius: var(--wa-border-radius-circle);
+  color: white;
+  pointer-events: none;
+  transition: opacity var(--wa-transition-normal) var(--wa-transition-easing);
+}
+
+@media (hover: hover) {
+  :host([play]:hover) .control-box {
+    opacity: 1;
+  }
+}
+
+:where(:host([play]:not(:hover))) .control-box {
+  opacity: 0;
+}
+
+:host([play]) slot[name='play-icon'],
+:host(:not([play])) slot[name='pause-icon'] {
+  display: none;
+}
+
+/* Show control box on keyboard focus */
+.animated-image {
+  &:focus {
+    outline: none;
+  }
+
+  &:focus-visible .control-box {
+    opacity: 1;
+    outline: var(--wa-focus-ring);
+    outline-offset: var(--wa-focus-ring-offset);
+  }
+}

packages/webawesome/src/components/animated-image/animated-image.styles.ts

@@ -1,69 +0,0 @@
-import { css } from 'lit';
-
-export default css`
-  :host {
-    --control-box-size: 3rem;
-    --icon-size: calc(var(--control-box-size) * 0.625);
-
-    display: inline-flex;
-    position: relative;
-    cursor: pointer;
-  }
-
-  img {
-    display: block;
-    width: 100%;
-    height: 100%;
-  }
-
-  img[aria-hidden='true'] {
-    display: none;
-  }
-
-  .control-box {
-    display: flex;
-    position: absolute;
-    align-items: center;
-    justify-content: center;
-    top: calc(50% - var(--control-box-size) / 2);
-    right: calc(50% - var(--control-box-size) / 2);
-    width: var(--control-box-size);
-    height: var(--control-box-size);
-    font-size: calc(var(--icon-size) * 0.75);
-    background: none;
-    border: solid var(--wa-border-width-s) currentColor;
-    background-color: rgb(0 0 0 / 50%);
-    border-radius: var(--wa-border-radius-circle);
-    color: white;
-    pointer-events: none;
-    transition: opacity var(--wa-transition-normal) var(--wa-transition-easing);
-  }
-
-  @media (hover: hover) {
-    :host([play]:hover) .control-box {
-      opacity: 1;
-    }
-  }
-
-  :where(:host([play]:not(:hover))) .control-box {
-    opacity: 0;
-  }
-
-  :host([play]) slot[name='play-icon'],
-  :host(:not([play])) slot[name='pause-icon'] {
-    display: none;
-  }
-
-  /* Show control box on keyboard focus */
-  .animated-image {
-    &:focus {
-      outline: none;
-    }
-
-    &:focus-visible .control-box {
-      opacity: 1;
-      outline: var(--wa-focus-ring);
-      outline-offset: var(--wa-focus-ring-offset);
-    }
-  }
-`;

packages/webawesome/src/components/animated-image/animated-image.ts

@@ -6,7 +6,7 @@ import { watch } from '../../internal/watch.js';
 import WebAwesomeElement from '../../internal/webawesome-element.js';
 import { LocalizeController } from '../../utilities/localize.js';
 import '../icon/icon.js';
-import styles from './animated-image.styles.js';
+import styles from './animated-image.css';
 
 /**
  * @summary A component for displaying animated GIFs and WEBPs that play and pause on interaction.

packages/webawesome/src/components/animation/animation.css

@@ -0,0 +1,3 @@
+:host {
+  display: contents;
+}

packages/webawesome/src/components/animation/animation.styles.ts

@@ -1,7 +0,0 @@
-import { css } from 'lit';
-
-export default css`
-  :host {
-    display: contents;
-  }
-`;

packages/webawesome/src/components/animation/animation.ts

@@ -5,7 +5,7 @@ import { WaFinishEvent } from '../../events/finish.js';
 import { WaStartEvent } from '../../events/start.js';
 import { watch } from '../../internal/watch.js';
 import WebAwesomeElement from '../../internal/webawesome-element.js';
-import styles from './animation.styles.js';
+import styles from './animation.css';
 import { animations } from './animations.js';
 
 /**

packages/webawesome/src/components/avatar/avatar.css

@@ -0,0 +1,53 @@
+:host {
+  --size: 3rem;
+
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  position: relative;
+  width: var(--size);
+  height: var(--size);
+  color: var(--wa-color-neutral-on-normal);
+  font: inherit;
+  font-size: calc(var(--size) * 0.4);
+  vertical-align: middle;
+  background-color: var(--wa-color-neutral-fill-normal);
+  border-radius: var(--wa-border-radius-circle);
+  user-select: none;
+  -webkit-user-select: none;
+}
+
+:host([shape='square']) {
+  border-radius: 0;
+}
+
+:host([shape='rounded']) {
+  border-radius: var(--wa-border-radius-m);
+}
+
+.icon {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  position: absolute;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+}
+
+.initials {
+  line-height: 1;
+  text-transform: uppercase;
+}
+
+.image {
+  position: absolute;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+  overflow: hidden;
+  border-radius: inherit;
+}

packages/webawesome/src/components/avatar/avatar.styles.ts

@@ -1,57 +0,0 @@
-import { css } from 'lit';
-
-export default css`
-  :host {
-    --size: 3rem;
-
-    display: inline-flex;
-    align-items: center;
-    justify-content: center;
-    position: relative;
-    width: var(--size);
-    height: var(--size);
-    color: var(--wa-color-neutral-on-normal);
-    font: inherit;
-    font-size: calc(var(--size) * 0.4);
-    vertical-align: middle;
-    background-color: var(--wa-color-neutral-fill-normal);
-    border-radius: var(--wa-border-radius-circle);
-    user-select: none;
-    -webkit-user-select: none;
-  }
-
-  :host([shape='square']) {
-    border-radius: 0;
-  }
-
-  :host([shape='rounded']) {
-    border-radius: var(--wa-border-radius-m);
-  }
-
-  .icon {
-    display: flex;
-    align-items: center;
-    justify-content: center;
-    position: absolute;
-    top: 0;
-    left: 0;
-    width: 100%;
-    height: 100%;
-  }
-
-  .initials {
-    line-height: 1;
-    text-transform: uppercase;
-  }
-
-  .image {
-    position: absolute;
-    top: 0;
-    left: 0;
-    width: 100%;
-    height: 100%;
-    object-fit: cover;
-    overflow: hidden;
-    border-radius: inherit;
-  }
-`;

packages/webawesome/src/components/avatar/avatar.ts

@@ -4,7 +4,7 @@ import { WaErrorEvent } from '../../events/error.js';
 import { watch } from '../../internal/watch.js';
 import WebAwesomeElement from '../../internal/webawesome-element.js';
 import '../icon/icon.js';
-import styles from './avatar.styles.js';
+import styles from './avatar.css';
 
 /**
  * @summary Avatars are used to represent a person or object.

packages/webawesome/src/components/badge/badge.css

@@ -0,0 +1,104 @@
+:host {
+  --pulse-color: var(--wa-color-fill-loud, var(--wa-color-brand-fill-loud));
+
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  padding: 0.375em 0.625em;
+  color: var(--wa-color-on-loud, var(--wa-color-brand-on-loud));
+  font-size: max(var(--wa-font-size-2xs), 0.75em);
+  font-weight: var(--wa-font-weight-semibold);
+  line-height: 1;
+  white-space: nowrap;
+  background-color: var(--wa-color-fill-loud, var(--wa-color-brand-fill-loud));
+  border-color: transparent;
+  border-radius: var(--wa-border-radius-s);
+  border-style: var(--wa-border-style);
+  border-width: var(--wa-border-width-s);
+  user-select: none;
+  -webkit-user-select: none;
+  cursor: inherit;
+}
+
+/* Appearance modifiers */
+:host([appearance='outlined']) {
+  --pulse-color: var(--wa-color-border-loud, var(--wa-color-brand-border-loud));
+
+  color: var(--wa-color-on-quiet, var(--wa-color-brand-on-quiet));
+  background-color: transparent;
+  border-color: var(--wa-color-border-loud, var(--wa-color-brand-border-loud));
+}
+
+:host([appearance='filled']) {
+  --pulse-color: var(--wa-color-fill-normal, var(--wa-color-brand-fill-normal));
+
+  color: var(--wa-color-on-normal, var(--wa-color-brand-on-normal));
+  background-color: var(--wa-color-fill-normal, var(--wa-color-brand-fill-normal));
+  border-color: transparent;
+}
+
+:host([appearance='filled-outlined']) {
+  --pulse-color: var(--wa-color-border-normal, var(--wa-color-brand-border-normal));
+
+  color: var(--wa-color-on-normal, var(--wa-color-brand-on-normal));
+  background-color: var(--wa-color-fill-normal, var(--wa-color-brand-fill-normal));
+  border-color: var(--wa-color-border-normal, var(--wa-color-brand-border-normal));
+}
+
+:host([appearance='accent']) {
+  --pulse-color: var(--wa-color-fill-loud, var(--wa-color-brand-fill-loud));
+
+  color: var(--wa-color-on-loud, var(--wa-color-brand-on-loud));
+  background-color: var(--wa-color-fill-loud, var(--wa-color-brand-fill-loud));
+  border-color: transparent;
+}
+
+/* Pill modifier */
+:host([pill]) {
+  border-radius: var(--wa-border-radius-pill);
+}
+
+/* Pulse attention */
+:host([attention='pulse']) {
+  animation: pulse 1.5s infinite;
+}
+
+@keyframes pulse {
+  0% {
+    box-shadow: 0 0 0 0 var(--pulse-color);
+  }
+  70% {
+    box-shadow: 0 0 0 0.5rem transparent;
+  }
+  100% {
+    box-shadow: 0 0 0 0 transparent;
+  }
+}
+
+/* Bounce attention */
+:host([attention='bounce']) {
+  animation: bounce 1s cubic-bezier(0.28, 0.84, 0.42, 1) infinite;
+}
+
+@keyframes bounce {
+  0%,
+  20%,
+  50%,
+  80%,
+  100% {
+    transform: translateY(0);
+  }
+  40% {
+    transform: translateY(-5px);
+  }
+  60% {
+    transform: translateY(-2px);
+  }
+}
+
+::slotted(wa-icon) {
+  margin-inline-end: var(--wa-space-2xs, 0.25em);
+  opacity: 90%;
+  line-height: 1;
+  height: 0.85em;
+}

packages/webawesome/src/components/badge/badge.styles.ts

@@ -1,108 +0,0 @@
-import { css } from 'lit';
-
-export default css`
-  :host {
-    --pulse-color: var(--wa-color-fill-loud, var(--wa-color-brand-fill-loud));
-
-    display: inline-flex;
-    align-items: center;
-    justify-content: center;
-    padding: 0.375em 0.625em;
-    color: var(--wa-color-on-loud, var(--wa-color-brand-on-loud));
-    font-size: max(var(--wa-font-size-2xs), 0.75em);
-    font-weight: var(--wa-font-weight-semibold);
-    line-height: 1;
-    white-space: nowrap;
-    background-color: var(--wa-color-fill-loud, var(--wa-color-brand-fill-loud));
-    border-color: transparent;
-    border-radius: var(--wa-border-radius-s);
-    border-style: var(--wa-border-style);
-    border-width: var(--wa-border-width-s);
-    user-select: none;
-    -webkit-user-select: none;
-    cursor: inherit;
-  }
-
-  /* Appearance modifiers */
-  :host([appearance='outlined']) {
-    --pulse-color: var(--wa-color-border-loud, var(--wa-color-brand-border-loud));
-
-    color: var(--wa-color-on-quiet, var(--wa-color-brand-on-quiet));
-    background-color: transparent;
-    border-color: var(--wa-color-border-loud, var(--wa-color-brand-border-loud));
-  }
-
-  :host([appearance='filled']) {
-    --pulse-color: var(--wa-color-fill-normal, var(--wa-color-brand-fill-normal));
-
-    color: var(--wa-color-on-normal, var(--wa-color-brand-on-normal));
-    background-color: var(--wa-color-fill-normal, var(--wa-color-brand-fill-normal));
-    border-color: transparent;
-  }
-
-  :host([appearance='filled-outlined']) {
-    --pulse-color: var(--wa-color-border-normal, var(--wa-color-brand-border-normal));
-
-    color: var(--wa-color-on-normal, var(--wa-color-brand-on-normal));
-    background-color: var(--wa-color-fill-normal, var(--wa-color-brand-fill-normal));
-    border-color: var(--wa-color-border-normal, var(--wa-color-brand-border-normal));
-  }
-
-  :host([appearance='accent']) {
-    --pulse-color: var(--wa-color-fill-loud, var(--wa-color-brand-fill-loud));
-
-    color: var(--wa-color-on-loud, var(--wa-color-brand-on-loud));
-    background-color: var(--wa-color-fill-loud, var(--wa-color-brand-fill-loud));
-    border-color: transparent;
-  }
-
-  /* Pill modifier */
-  :host([pill]) {
-    border-radius: var(--wa-border-radius-pill);
-  }
-
-  /* Pulse attention */
-  :host([attention='pulse']) {
-    animation: pulse 1.5s infinite;
-  }
-
-  @keyframes pulse {
-    0% {
-      box-shadow: 0 0 0 0 var(--pulse-color);
-    }
-    70% {
-      box-shadow: 0 0 0 0.5rem transparent;
-    }
-    100% {
-      box-shadow: 0 0 0 0 transparent;
-    }
-  }
-
-  /* Bounce attention */
-  :host([attention='bounce']) {
-    animation: bounce 1s cubic-bezier(0.28, 0.84, 0.42, 1) infinite;
-  }
-
-  @keyframes bounce {
-    0%,
-    20%,
-    50%,
-    80%,
-    100% {
-      transform: translateY(0);
-    }
-    40% {
-      transform: translateY(-5px);
-    }
-    60% {
-      transform: translateY(-2px);
-    }
-  }
-
-  ::slotted(wa-icon) {
-    margin-inline-end: var(--wa-space-2xs, 0.25em);
-    opacity: 90%;
-    line-height: 1;
-    height: 0.85em;
-  }
-`;

packages/webawesome/src/components/badge/badge.ts

@@ -1,8 +1,8 @@
 import { html } from 'lit';
 import { customElement, property } from 'lit/decorators.js';
 import WebAwesomeElement from '../../internal/webawesome-element.js';
-import variantStyles from '../../styles/component/variants.styles.js';
-import styles from './badge.styles.js';
+import variantStyles from '../../styles/utilities/variants.css';
+import styles from './badge.css';
 
 /**
  * @summary Badges are used to draw attention and display statuses or counts.

packages/webawesome/src/components/breadcrumb-item/breadcrumb-item.css

@@ -0,0 +1,81 @@
+:host {
+  color: var(--wa-color-text-link);
+  display: inline-flex;
+  align-items: center;
+  font: inherit;
+  font-weight: var(--wa-font-weight-action);
+  line-height: var(--wa-line-height-normal);
+  white-space: nowrap;
+}
+
+:host(:last-of-type) {
+  color: var(--wa-color-text-quiet);
+}
+
+.label {
+  display: inline-block;
+  font: inherit;
+  text-decoration: none;
+  color: currentColor;
+  background: none;
+  border: none;
+  border-radius: var(--wa-border-radius-m);
+  padding: 0;
+  margin: 0;
+  cursor: pointer;
+  transition: color var(--wa-transition-normal) var(--wa-transition-easing);
+}
+
+@media (hover: hover) {
+  :host(:not(:last-of-type)) .label:hover {
+    color: color-mix(in oklab, currentColor, var(--wa-color-mix-hover));
+  }
+}
+
+:host(:not(:last-of-type)) .label:active {
+  color: color-mix(in oklab, currentColor, var(--wa-color-mix-active));
+}
+
+.label:focus {
+  outline: none;
+}
+
+.label:focus-visible {
+  outline: var(--wa-focus-ring);
+  outline-offset: var(--wa-focus-ring-offset);
+}
+
+.start,
+.end {
+  display: none;
+  flex: 0 0 auto;
+  display: flex;
+  align-items: center;
+}
+
+.start,
+.end {
+  display: inline-flex;
+  color: var(--wa-color-text-quiet);
+}
+
+::slotted([slot='start']) {
+  margin-inline-end: var(--wa-space-s);
+}
+
+::slotted([slot='end']) {
+  margin-inline-start: var(--wa-space-s);
+}
+
+:host(:last-of-type) .separator {
+  display: none;
+}
+
+.separator {
+  color: var(--wa-color-text-quiet);
+  display: inline-flex;
+  align-items: center;
+  margin: 0 var(--wa-space-s);
+  user-select: none;
+  -webkit-user-select: none;
+}