Merge branch 'next' into scroller-fix

Fix SVG fill in <wa-icon> (#1784 )
* fix svg fill; closes #1733 * remove fill
2026-01-13 04:29:14 +00:00 · 2025-11-19 07:34:14 -05:00 · 2025-11-19 07:33:56 -05:00 · 2025-11-18 15:31:51 -05:00 · 2025-11-18 15:29:57 -05:00 · 2025-11-18 14:07:53 -05:00
85 changed files with 2188 additions and 468 deletions
--- a/.github/ISSUE_TEMPLATE/config.yml
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -1,7 +1,7 @@
 contact_links:
  - name: Feature Requests
-    url: https://github.com/shoelace-style/shoelace/discussions/categories/ideas
+    url: https://github.com/shoelace-style/webawesome/discussions/categories/ideas-suggestions
    about: All requests for new features should go here.
  - name: Help & Support
-    url: https://github.com/shoelace-style/shoelace/discussions/categories/help
+    url: https://github.com/shoelace-style/webawesome/discussions/categories/ask-for-help
    about: Please don't create issues for personal help requests. Instead, ask your question on the discussion forum.
--- a/VERSIONS.txt
+++ b/VERSIONS.txt
@@ -1,6 +1 @@
-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
+3.0.0
--- a/package-lock.json
+++ b/package-lock.json
@@ -1595,6 +1595,22 @@
        "node": ">=18"
      }
    },
+    "node_modules/@esbuild/netbsd-arm64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.25.11.tgz",
+      "integrity": "sha512-hr9Oxj1Fa4r04dNpWr3P8QKVVsjQhqrMSUzZzf+LZcYjZNqhA3IAfPQdEh1FLVUJSiu6sgAwp3OmwBfbFgG2Xg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
    "node_modules/@esbuild/netbsd-x64": {
      "version": "0.23.1",
      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.23.1.tgz",
@@ -1643,6 +1659,22 @@
        "node": ">=18"
      }
    },
+    "node_modules/@esbuild/openharmony-arm64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.25.11.tgz",
+      "integrity": "sha512-rOREuNIQgaiR+9QuNkbkxubbp8MSO9rONmwP5nKncnWJ9v5jQ4JxFnLu4zDSRPf3x4u+2VN4pM4RdyIzDty/wQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "openharmony"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
    "node_modules/@esbuild/sunos-x64": {
      "version": "0.23.1",
      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.23.1.tgz",
@@ -13981,7 +14013,7 @@
    },
    "packages/webawesome": {
      "name": "@awesome.me/webawesome",
-      "version": "3.0.0-beta.6",
+      "version": "3.0.0",
      "license": "MIT",
      "dependencies": {
        "@ctrl/tinycolor": "4.1.0",
@@ -13996,7 +14028,8 @@
      },
      "devDependencies": {
        "@wc-toolkit/jsx-types": "^1.3.0",
-        "eleventy-plugin-git-commit-date": "^0.1.3"
+        "eleventy-plugin-git-commit-date": "^0.1.3",
+        "esbuild": "^0.25.11"
      },
      "engines": {
        "node": ">=14.17.0"
@@ -14017,12 +14050,464 @@
        "qr-creator": "^1.0.0"
      },
      "devDependencies": {
-        "@wc-toolkit/jsx-types": "^1.3.0"
+        "@wc-toolkit/jsx-types": "^1.3.0",
+        "eleventy-plugin-git-commit-date": "^0.1.3",
+        "esbuild": "^0.25.11"
      },
      "engines": {
        "node": ">=14.17.0"
      }
    },
+    "packages/webawesome-pro/node_modules/@esbuild/aix-ppc64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.25.11.tgz",
+      "integrity": "sha512-Xt1dOL13m8u0WE8iplx9Ibbm+hFAO0GsU2P34UNoDGvZYkY8ifSiy6Zuc1lYxfG7svWE2fzqCUmFp5HCn51gJg==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "aix"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome-pro/node_modules/@esbuild/android-arm": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.25.11.tgz",
+      "integrity": "sha512-uoa7dU+Dt3HYsethkJ1k6Z9YdcHjTrSb5NUy66ZfZaSV8hEYGD5ZHbEMXnqLFlbBflLsl89Zke7CAdDJ4JI+Gg==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome-pro/node_modules/@esbuild/android-arm64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.25.11.tgz",
+      "integrity": "sha512-9slpyFBc4FPPz48+f6jyiXOx/Y4v34TUeDDXJpZqAWQn/08lKGeD8aDp9TMn9jDz2CiEuHwfhRmGBvpnd/PWIQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome-pro/node_modules/@esbuild/android-x64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.25.11.tgz",
+      "integrity": "sha512-Sgiab4xBjPU1QoPEIqS3Xx+R2lezu0LKIEcYe6pftr56PqPygbB7+szVnzoShbx64MUupqoE0KyRlN7gezbl8g==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome-pro/node_modules/@esbuild/darwin-arm64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.25.11.tgz",
+      "integrity": "sha512-VekY0PBCukppoQrycFxUqkCojnTQhdec0vevUL/EDOCnXd9LKWqD/bHwMPzigIJXPhC59Vd1WFIL57SKs2mg4w==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome-pro/node_modules/@esbuild/darwin-x64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.25.11.tgz",
+      "integrity": "sha512-+hfp3yfBalNEpTGp9loYgbknjR695HkqtY3d3/JjSRUyPg/xd6q+mQqIb5qdywnDxRZykIHs3axEqU6l1+oWEQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome-pro/node_modules/@esbuild/freebsd-arm64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.25.11.tgz",
+      "integrity": "sha512-CmKjrnayyTJF2eVuO//uSjl/K3KsMIeYeyN7FyDBjsR3lnSJHaXlVoAK8DZa7lXWChbuOk7NjAc7ygAwrnPBhA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome-pro/node_modules/@esbuild/freebsd-x64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.25.11.tgz",
+      "integrity": "sha512-Dyq+5oscTJvMaYPvW3x3FLpi2+gSZTCE/1ffdwuM6G1ARang/mb3jvjxs0mw6n3Lsw84ocfo9CrNMqc5lTfGOw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome-pro/node_modules/@esbuild/linux-arm": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.25.11.tgz",
+      "integrity": "sha512-TBMv6B4kCfrGJ8cUPo7vd6NECZH/8hPpBHHlYI3qzoYFvWu2AdTvZNuU/7hsbKWqu/COU7NIK12dHAAqBLLXgw==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome-pro/node_modules/@esbuild/linux-arm64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.25.11.tgz",
+      "integrity": "sha512-Qr8AzcplUhGvdyUF08A1kHU3Vr2O88xxP0Tm8GcdVOUm25XYcMPp2YqSVHbLuXzYQMf9Bh/iKx7YPqECs6ffLA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome-pro/node_modules/@esbuild/linux-ia32": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.25.11.tgz",
+      "integrity": "sha512-TmnJg8BMGPehs5JKrCLqyWTVAvielc615jbkOirATQvWWB1NMXY77oLMzsUjRLa0+ngecEmDGqt5jiDC6bfvOw==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome-pro/node_modules/@esbuild/linux-loong64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.25.11.tgz",
+      "integrity": "sha512-DIGXL2+gvDaXlaq8xruNXUJdT5tF+SBbJQKbWy/0J7OhU8gOHOzKmGIlfTTl6nHaCOoipxQbuJi7O++ldrxgMw==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome-pro/node_modules/@esbuild/linux-mips64el": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.25.11.tgz",
+      "integrity": "sha512-Osx1nALUJu4pU43o9OyjSCXokFkFbyzjXb6VhGIJZQ5JZi8ylCQ9/LFagolPsHtgw6himDSyb5ETSfmp4rpiKQ==",
+      "cpu": [
+        "mips64el"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome-pro/node_modules/@esbuild/linux-ppc64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.25.11.tgz",
+      "integrity": "sha512-nbLFgsQQEsBa8XSgSTSlrnBSrpoWh7ioFDUmwo158gIm5NNP+17IYmNWzaIzWmgCxq56vfr34xGkOcZ7jX6CPw==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome-pro/node_modules/@esbuild/linux-riscv64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.25.11.tgz",
+      "integrity": "sha512-HfyAmqZi9uBAbgKYP1yGuI7tSREXwIb438q0nqvlpxAOs3XnZ8RsisRfmVsgV486NdjD7Mw2UrFSw51lzUk1ww==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome-pro/node_modules/@esbuild/linux-s390x": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.25.11.tgz",
+      "integrity": "sha512-HjLqVgSSYnVXRisyfmzsH6mXqyvj0SA7pG5g+9W7ESgwA70AXYNpfKBqh1KbTxmQVaYxpzA/SvlB9oclGPbApw==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome-pro/node_modules/@esbuild/linux-x64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.25.11.tgz",
+      "integrity": "sha512-HSFAT4+WYjIhrHxKBwGmOOSpphjYkcswF449j6EjsjbinTZbp8PJtjsVK1XFJStdzXdy/jaddAep2FGY+wyFAQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome-pro/node_modules/@esbuild/netbsd-x64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.25.11.tgz",
+      "integrity": "sha512-u7tKA+qbzBydyj0vgpu+5h5AeudxOAGncb8N6C9Kh1N4n7wU1Xw1JDApsRjpShRpXRQlJLb9wY28ELpwdPcZ7A==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome-pro/node_modules/@esbuild/openbsd-arm64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.25.11.tgz",
+      "integrity": "sha512-Qq6YHhayieor3DxFOoYM1q0q1uMFYb7cSpLD2qzDSvK1NAvqFi8Xgivv0cFC6J+hWVw2teCYltyy9/m/14ryHg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome-pro/node_modules/@esbuild/openbsd-x64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.25.11.tgz",
+      "integrity": "sha512-CN+7c++kkbrckTOz5hrehxWN7uIhFFlmS/hqziSFVWpAzpWrQoAG4chH+nN3Be+Kzv/uuo7zhX716x3Sn2Jduw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome-pro/node_modules/@esbuild/sunos-x64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.25.11.tgz",
+      "integrity": "sha512-nq2xdYaWxyg9DcIyXkZhcYulC6pQ2FuCgem3LI92IwMgIZ69KHeY8T4Y88pcwoLIjbed8n36CyKoYRDygNSGhA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "sunos"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome-pro/node_modules/@esbuild/win32-arm64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.25.11.tgz",
+      "integrity": "sha512-3XxECOWJq1qMZ3MN8srCJ/QfoLpL+VaxD/WfNRm1O3B4+AZ/BnLVgFbUV3eiRYDMXetciH16dwPbbHqwe1uU0Q==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome-pro/node_modules/@esbuild/win32-ia32": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.25.11.tgz",
+      "integrity": "sha512-3ukss6gb9XZ8TlRyJlgLn17ecsK4NSQTmdIXRASVsiS2sQ6zPPZklNJT5GR5tE/MUarymmy8kCEf5xPCNCqVOA==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome-pro/node_modules/@esbuild/win32-x64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.25.11.tgz",
+      "integrity": "sha512-D7Hpz6A2L4hzsRpPaCYkQnGOotdUpDzSGRIv9I+1ITdHROSFUWW95ZPZWQmGka1Fg7W3zFJowyn9WGwMJ0+KPA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome-pro/node_modules/esbuild": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.25.11.tgz",
+      "integrity": "sha512-KohQwyzrKTQmhXDW1PjCv3Tyspn9n5GcY2RTDqeORIdIJY8yKIF7sTSopFmn/wpMPW4rdPXI0UE5LJLuq3bx0Q==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "bin": {
+        "esbuild": "bin/esbuild"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "optionalDependencies": {
+        "@esbuild/aix-ppc64": "0.25.11",
+        "@esbuild/android-arm": "0.25.11",
+        "@esbuild/android-arm64": "0.25.11",
+        "@esbuild/android-x64": "0.25.11",
+        "@esbuild/darwin-arm64": "0.25.11",
+        "@esbuild/darwin-x64": "0.25.11",
+        "@esbuild/freebsd-arm64": "0.25.11",
+        "@esbuild/freebsd-x64": "0.25.11",
+        "@esbuild/linux-arm": "0.25.11",
+        "@esbuild/linux-arm64": "0.25.11",
+        "@esbuild/linux-ia32": "0.25.11",
+        "@esbuild/linux-loong64": "0.25.11",
+        "@esbuild/linux-mips64el": "0.25.11",
+        "@esbuild/linux-ppc64": "0.25.11",
+        "@esbuild/linux-riscv64": "0.25.11",
+        "@esbuild/linux-s390x": "0.25.11",
+        "@esbuild/linux-x64": "0.25.11",
+        "@esbuild/netbsd-arm64": "0.25.11",
+        "@esbuild/netbsd-x64": "0.25.11",
+        "@esbuild/openbsd-arm64": "0.25.11",
+        "@esbuild/openbsd-x64": "0.25.11",
+        "@esbuild/openharmony-arm64": "0.25.11",
+        "@esbuild/sunos-x64": "0.25.11",
+        "@esbuild/win32-arm64": "0.25.11",
+        "@esbuild/win32-ia32": "0.25.11",
+        "@esbuild/win32-x64": "0.25.11"
+      }
+    },
    "packages/webawesome-pro/node_modules/nanoid": {
      "version": "5.1.5",
      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-5.1.5.tgz",
@@ -14040,6 +14525,431 @@
        "node": "^18 || >=20"
      }
    },
+    "packages/webawesome/node_modules/@esbuild/aix-ppc64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.25.11.tgz",
+      "integrity": "sha512-Xt1dOL13m8u0WE8iplx9Ibbm+hFAO0GsU2P34UNoDGvZYkY8ifSiy6Zuc1lYxfG7svWE2fzqCUmFp5HCn51gJg==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "aix"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome/node_modules/@esbuild/android-arm": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.25.11.tgz",
+      "integrity": "sha512-uoa7dU+Dt3HYsethkJ1k6Z9YdcHjTrSb5NUy66ZfZaSV8hEYGD5ZHbEMXnqLFlbBflLsl89Zke7CAdDJ4JI+Gg==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome/node_modules/@esbuild/android-arm64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.25.11.tgz",
+      "integrity": "sha512-9slpyFBc4FPPz48+f6jyiXOx/Y4v34TUeDDXJpZqAWQn/08lKGeD8aDp9TMn9jDz2CiEuHwfhRmGBvpnd/PWIQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome/node_modules/@esbuild/android-x64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.25.11.tgz",
+      "integrity": "sha512-Sgiab4xBjPU1QoPEIqS3Xx+R2lezu0LKIEcYe6pftr56PqPygbB7+szVnzoShbx64MUupqoE0KyRlN7gezbl8g==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome/node_modules/@esbuild/darwin-arm64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.25.11.tgz",
+      "integrity": "sha512-VekY0PBCukppoQrycFxUqkCojnTQhdec0vevUL/EDOCnXd9LKWqD/bHwMPzigIJXPhC59Vd1WFIL57SKs2mg4w==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome/node_modules/@esbuild/darwin-x64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.25.11.tgz",
+      "integrity": "sha512-+hfp3yfBalNEpTGp9loYgbknjR695HkqtY3d3/JjSRUyPg/xd6q+mQqIb5qdywnDxRZykIHs3axEqU6l1+oWEQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome/node_modules/@esbuild/freebsd-arm64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.25.11.tgz",
+      "integrity": "sha512-CmKjrnayyTJF2eVuO//uSjl/K3KsMIeYeyN7FyDBjsR3lnSJHaXlVoAK8DZa7lXWChbuOk7NjAc7ygAwrnPBhA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome/node_modules/@esbuild/freebsd-x64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.25.11.tgz",
+      "integrity": "sha512-Dyq+5oscTJvMaYPvW3x3FLpi2+gSZTCE/1ffdwuM6G1ARang/mb3jvjxs0mw6n3Lsw84ocfo9CrNMqc5lTfGOw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome/node_modules/@esbuild/linux-arm": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.25.11.tgz",
+      "integrity": "sha512-TBMv6B4kCfrGJ8cUPo7vd6NECZH/8hPpBHHlYI3qzoYFvWu2AdTvZNuU/7hsbKWqu/COU7NIK12dHAAqBLLXgw==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome/node_modules/@esbuild/linux-arm64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.25.11.tgz",
+      "integrity": "sha512-Qr8AzcplUhGvdyUF08A1kHU3Vr2O88xxP0Tm8GcdVOUm25XYcMPp2YqSVHbLuXzYQMf9Bh/iKx7YPqECs6ffLA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome/node_modules/@esbuild/linux-ia32": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.25.11.tgz",
+      "integrity": "sha512-TmnJg8BMGPehs5JKrCLqyWTVAvielc615jbkOirATQvWWB1NMXY77oLMzsUjRLa0+ngecEmDGqt5jiDC6bfvOw==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome/node_modules/@esbuild/linux-loong64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.25.11.tgz",
+      "integrity": "sha512-DIGXL2+gvDaXlaq8xruNXUJdT5tF+SBbJQKbWy/0J7OhU8gOHOzKmGIlfTTl6nHaCOoipxQbuJi7O++ldrxgMw==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome/node_modules/@esbuild/linux-mips64el": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.25.11.tgz",
+      "integrity": "sha512-Osx1nALUJu4pU43o9OyjSCXokFkFbyzjXb6VhGIJZQ5JZi8ylCQ9/LFagolPsHtgw6himDSyb5ETSfmp4rpiKQ==",
+      "cpu": [
+        "mips64el"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome/node_modules/@esbuild/linux-ppc64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.25.11.tgz",
+      "integrity": "sha512-nbLFgsQQEsBa8XSgSTSlrnBSrpoWh7ioFDUmwo158gIm5NNP+17IYmNWzaIzWmgCxq56vfr34xGkOcZ7jX6CPw==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome/node_modules/@esbuild/linux-riscv64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.25.11.tgz",
+      "integrity": "sha512-HfyAmqZi9uBAbgKYP1yGuI7tSREXwIb438q0nqvlpxAOs3XnZ8RsisRfmVsgV486NdjD7Mw2UrFSw51lzUk1ww==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome/node_modules/@esbuild/linux-s390x": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.25.11.tgz",
+      "integrity": "sha512-HjLqVgSSYnVXRisyfmzsH6mXqyvj0SA7pG5g+9W7ESgwA70AXYNpfKBqh1KbTxmQVaYxpzA/SvlB9oclGPbApw==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome/node_modules/@esbuild/linux-x64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.25.11.tgz",
+      "integrity": "sha512-HSFAT4+WYjIhrHxKBwGmOOSpphjYkcswF449j6EjsjbinTZbp8PJtjsVK1XFJStdzXdy/jaddAep2FGY+wyFAQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome/node_modules/@esbuild/netbsd-x64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.25.11.tgz",
+      "integrity": "sha512-u7tKA+qbzBydyj0vgpu+5h5AeudxOAGncb8N6C9Kh1N4n7wU1Xw1JDApsRjpShRpXRQlJLb9wY28ELpwdPcZ7A==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome/node_modules/@esbuild/openbsd-arm64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.25.11.tgz",
+      "integrity": "sha512-Qq6YHhayieor3DxFOoYM1q0q1uMFYb7cSpLD2qzDSvK1NAvqFi8Xgivv0cFC6J+hWVw2teCYltyy9/m/14ryHg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome/node_modules/@esbuild/openbsd-x64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.25.11.tgz",
+      "integrity": "sha512-CN+7c++kkbrckTOz5hrehxWN7uIhFFlmS/hqziSFVWpAzpWrQoAG4chH+nN3Be+Kzv/uuo7zhX716x3Sn2Jduw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome/node_modules/@esbuild/sunos-x64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.25.11.tgz",
+      "integrity": "sha512-nq2xdYaWxyg9DcIyXkZhcYulC6pQ2FuCgem3LI92IwMgIZ69KHeY8T4Y88pcwoLIjbed8n36CyKoYRDygNSGhA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "sunos"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome/node_modules/@esbuild/win32-arm64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.25.11.tgz",
+      "integrity": "sha512-3XxECOWJq1qMZ3MN8srCJ/QfoLpL+VaxD/WfNRm1O3B4+AZ/BnLVgFbUV3eiRYDMXetciH16dwPbbHqwe1uU0Q==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome/node_modules/@esbuild/win32-ia32": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.25.11.tgz",
+      "integrity": "sha512-3ukss6gb9XZ8TlRyJlgLn17ecsK4NSQTmdIXRASVsiS2sQ6zPPZklNJT5GR5tE/MUarymmy8kCEf5xPCNCqVOA==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome/node_modules/@esbuild/win32-x64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.25.11.tgz",
+      "integrity": "sha512-D7Hpz6A2L4hzsRpPaCYkQnGOotdUpDzSGRIv9I+1ITdHROSFUWW95ZPZWQmGka1Fg7W3zFJowyn9WGwMJ0+KPA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "packages/webawesome/node_modules/esbuild": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.25.11.tgz",
+      "integrity": "sha512-KohQwyzrKTQmhXDW1PjCv3Tyspn9n5GcY2RTDqeORIdIJY8yKIF7sTSopFmn/wpMPW4rdPXI0UE5LJLuq3bx0Q==",
+      "dev": true,
+      "hasInstallScript": true,
+      "bin": {
+        "esbuild": "bin/esbuild"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "optionalDependencies": {
+        "@esbuild/aix-ppc64": "0.25.11",
+        "@esbuild/android-arm": "0.25.11",
+        "@esbuild/android-arm64": "0.25.11",
+        "@esbuild/android-x64": "0.25.11",
+        "@esbuild/darwin-arm64": "0.25.11",
+        "@esbuild/darwin-x64": "0.25.11",
+        "@esbuild/freebsd-arm64": "0.25.11",
+        "@esbuild/freebsd-x64": "0.25.11",
+        "@esbuild/linux-arm": "0.25.11",
+        "@esbuild/linux-arm64": "0.25.11",
+        "@esbuild/linux-ia32": "0.25.11",
+        "@esbuild/linux-loong64": "0.25.11",
+        "@esbuild/linux-mips64el": "0.25.11",
+        "@esbuild/linux-ppc64": "0.25.11",
+        "@esbuild/linux-riscv64": "0.25.11",
+        "@esbuild/linux-s390x": "0.25.11",
+        "@esbuild/linux-x64": "0.25.11",
+        "@esbuild/netbsd-arm64": "0.25.11",
+        "@esbuild/netbsd-x64": "0.25.11",
+        "@esbuild/openbsd-arm64": "0.25.11",
+        "@esbuild/openbsd-x64": "0.25.11",
+        "@esbuild/openharmony-arm64": "0.25.11",
+        "@esbuild/sunos-x64": "0.25.11",
+        "@esbuild/win32-arm64": "0.25.11",
+        "@esbuild/win32-ia32": "0.25.11",
+        "@esbuild/win32-x64": "0.25.11"
+      }
+    },
    "packages/webawesome/node_modules/nanoid": {
      "version": "5.1.5",
      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-5.1.5.tgz",
--- a/packages/webawesome/docs/.eleventy.js
+++ b/packages/webawesome/docs/.eleventy.js
@@ -1,6 +1,5 @@
 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';
@@ -21,7 +20,6 @@ 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() {
@@ -60,15 +58,6 @@ 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);
-        }
-      }
-    }
  });

  /**
@@ -94,85 +83,63 @@ 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

-  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),
+    // 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',
  });
+
  // 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 => {
@@ -227,7 +194,11 @@ export default async function (eleventyConfig) {

  // Shortcodes - {% shortCode arg1, arg2 %}
  eleventyConfig.addShortcode('cdnUrl', location => {
-    return `https://early.webawesome.com/webawesome@${packageData.version}/dist/` + (location || '').replace(/^\//, '');
+    // 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(/^\//, '')
+    );
  });

  // Turns `{% server "foo" %} into `{{ server.foo | safe }}` when the WEBAWESOME_SERVER variable is set to "true"
@@ -322,6 +293,11 @@ 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 ?? '',
    }),
  );
@@ -337,9 +313,13 @@ export default async function (eleventyConfig) {

  // This needs to happen in "eleventy.after" otherwise incremental builds never update.
  eleventyConfig.on('eleventy.after', function () {
-    let assetsDir = path.join(process.env.BASE_DIR || 'docs', 'assets');
+    const baseDir = process.env.BASE_DIR || 'docs';
+    let assetsDir = path.join(baseDir, '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) {
--- a/packages/webawesome/docs/_includes/_banner-wa-launch.njk
+++ b/packages/webawesome/docs/_includes/_banner-wa-launch.njk
@@ -0,0 +1,19 @@
+{% 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 %}
--- a/packages/webawesome/docs/_includes/_dialog-wa-launch.njk
+++ b/packages/webawesome/docs/_includes/_dialog-wa-launch.njk
@@ -0,0 +1,95 @@
+{% 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" class="plausible-event-name=launch_dialog:close_button_click">Maybe Later</wa-button>
+          <wa-button variant="neutral" appearance="accent" href="/purchase" class="brand-font plausible-event-name=launch_dialog:pro_purchase_button_click">
+            <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;
+        }
+
+        // Helper function to safely track Plausible events
+        const trackEvent = (eventName) => {
+          if (typeof plausible !== 'undefined') {
+            plausible(eventName);
+          }
+        };
+
+        // Initialize dialog functionality
+        let initCalled = false;
+        const initDialog = () => {
+          // Prevent double initialization
+          if (initCalled) {
+            return;
+          }
+          initCalled = true;
+
+          // Track when dialog is shown
+          dialog.addEventListener('wa-show', () => {
+            trackEvent('launch_dialog:view');
+          }, { once: true });
+
+          // Track when dialog is dismissed
+          dialog.addEventListener('wa-hide', (event) => {
+            // Track overlay click or Escape key dismissal
+            // Button clicks are tracked via CSS classes, so we only track non-button dismissals
+            if (event.detail?.source === dialog) {
+              trackEvent('launch_dialog:overlay_click');
+            }
+
+            // 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 %}
--- a/packages/webawesome/docs/_includes/base.njk
+++ b/packages/webawesome/docs/_includes/base.njk
@@ -1,5 +1,9 @@
 <!DOCTYPE html>
-<html lang="en" data-fa-kit-code="38c11e3f20" data-cdn-url="{% cdnUrl %}" class="wa-cloak">
+{% 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 %}>
  <head>
    {% include 'head.njk' %}
    <meta name="theme-color" content="#f36944">
@@ -27,7 +31,8 @@
    </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 } %}
+
+    {% set defaultWaPageAttributes = defaultWaPageAttributes or { view: 'desktop', 'disable-navigation-toggle': true, 'mobile-breakpoint': 1180, 'disable-sticky': 'banner' } %}
    {% set waPageAttributes = waPageAttributes or {} %}
    {% set mergedWaPageAttributes = defaultWaPageAttributes | merge(waPageAttributes) %}
    <wa-page
@@ -37,6 +42,13 @@
        {% endif %}
      {% endfor %}
    >
+        {% block pageBanner %}
+          {% if hasBanner %}
+            {#- WA Launch Banner -#}
+            {% include "_banner-wa-launch.njk" ignore missing %}
+          {% endif %}
+        {% endblock %}
+
        {% block pageHeader %}
          <header slot="header" class="wa-split">
            {# Nav toggle #}
@@ -109,7 +121,9 @@
        <div id="flashes">{% server "flashes" %}</div>

        {% block header %}
-          <h1 class="title">{{ title }}</h1>
+          {% if hasGeneratedTitle %}
+            <h1 class="title">{{ title }}</h1>
+          {% endif %}
        {% endblock %}

        {% block beforeContent %}{% endblock %}
@@ -123,6 +137,11 @@

      {% include 'search.njk' %}

+      {#- Site-Wide Dialog -#}
+      {% if hasSiteDialog %}
+        {% include "_dialog-wa-launch.njk" ignore missing %}
+      {% endif %}
+
      {# Footer #}
      {% block pageFooter %}{% endblock %}
    </wa-page>
--- a/packages/webawesome/docs/_includes/free-badge.njk
+++ b/packages/webawesome/docs/_includes/free-badge.njk
@@ -0,0 +1,7 @@
+{% 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 %}
+
--- a/packages/webawesome/docs/_includes/head.njk
+++ b/packages/webawesome/docs/_includes/head.njk
@@ -3,7 +3,17 @@
 <meta name="description" content="{{ description }}">
 {% if noindex or unlisted %}<meta name="robots" content="noindex">{% endif %}

-<title>{{ title }}</title>
+<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 %}

 {# Dark mode #}
 <script>
@@ -15,8 +25,11 @@
 	document.documentElement.classList.toggle('wa-dark', isDark);
 </script>

-<link rel="icon" href="/assets/images/webawesome-logo.svg" />
-<link rel="apple-touch-icon" href="/assets/images/app-icon.png">
+<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="preconnect" href="https://cdn.jsdelivr.net">
 <script type="module" src="/dist/webawesome.loader.js"></script>

@@ -25,12 +38,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-layout")) {
-      import("{% cdnUrl 'components/page/page.js' %}")
+    if (!customElements.get('wa-page')) {
+      import('https://early.webawesome.com/webawesome@3.0.0-beta.6/dist/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.
        })
    }
  }
--- a/packages/webawesome/docs/_includes/pro-badge.njk
+++ b/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 }}">Pro</wa-badge>
+  <wa-badge appearance="accent" pill class="pro" id="{{ badgeId }}" data-pro-badge>Pro</wa-badge>
  <wa-tooltip for="{{ badgeId }}">{{ description }}</wa-tooltip>
 {% endmacro %}
--- a/packages/webawesome/docs/_includes/sidebar.njk
+++ b/packages/webawesome/docs/_includes/sidebar.njk
@@ -16,7 +16,7 @@
 {# Resources #}
 <h2>Resources</h2>
 <ul>
-  <li><a href="https://github.com/shoelace-style/webawesome/discussions" target="_blank">Help &amp; Support</a></li>
+  <li><a href="/docs/resources/support">Help & Support</a></li>
  <li><a href="https://github.com/shoelace-style/webawesome/">Source Code</a></li>
  <li>
    <span class="wa-split">
@@ -24,12 +24,13 @@
      {{ 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>
+
+
 </ul>

 <!-- Components -->
@@ -100,6 +101,7 @@
        <li><a href="/docs/components/dropdown-item">Dropdown Item</a></li>
      </ul>
    </li>
+    <li><span class="is-planned wa-split">File Input <a href="https://github.com/shoelace-style/webawesome/issues/1240" target="_blank">{{ plannedBadge("A Web Awesome Kickstarter stretch goal!") }}</a></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>
@@ -108,6 +110,7 @@
    <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>
@@ -143,9 +146,15 @@
    </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 <a href="https://github.com/shoelace-style/webawesome/issues/105" target="_blank">{{ plannedBadge("A Web Awesome Kickstarter stretch goal!") }}</a></span></li>
    <li><a href="/docs/components/tooltip/">Tooltip</a></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/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 <a href="https://github.com/shoelace-style/webawesome/issues/985" target="_blank">{{ plannedBadge("A Web Awesome Kickstarter stretch goal!") }}</a></span></li>
    <li><a href="/docs/components/zoomable-frame">Zoomable Frame</a></li>
    {# PLOP_NEW_COMPONENT_PLACEHOLDER #}
  </ul>
@@ -364,9 +373,6 @@
        <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>
--- a/packages/webawesome/docs/_layouts/blank.njk
+++ b/packages/webawesome/docs/_layouts/blank.njk
@@ -1,5 +1,5 @@
 <!DOCTYPE html>
-<html lang="en" data-fa-kit-code="38c11e3f20" data-cdn-url="{% cdnUrl %}">
+<html lang="en" data-fa-kit-code="38c11e3f20" data-version="{{ package.version }}">
  <head>
    {% include 'head.njk' %}
    {% block head %}{% endblock %}
--- a/packages/webawesome/docs/_layouts/component.njk
+++ b/packages/webawesome/docs/_layouts/component.njk
@@ -211,7 +211,12 @@
            <tr>
              <td class="table-name"><code>{{ state.name }}</code></td>
              <td class="table-description">{{ state.description | inlineMarkdown | safe }}</td>
-              <td class="table-selector"><code>:state({{ state.name }})</code></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>
            </tr>
          {% endfor %}
        </tbody>
@@ -230,6 +235,7 @@
          <tr>
            <th class="table-name">Name</th>
            <th class="table-description">Description</th>
+            <th class="table-selector">CSS selector</th>
          </tr>
        </thead>
        <tbody>
@@ -237,6 +243,12 @@
            <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>
@@ -261,7 +273,7 @@
  {# 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.
+    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>


@@ -273,10 +285,8 @@
    <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.
+        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>
-
-      <pre><code class="language-js">import '{% cdnUrl componentPath %}';</code></pre>
    </wa-tab-panel>
    <wa-tab-panel name="npm">
      <p>
--- a/packages/webawesome/docs/_transformers/anchor-headings.js
+++ b/packages/webawesome/docs/_transformers/anchor-headings.js
@@ -35,9 +35,23 @@ export function anchorHeadingsTransformer(options = {}) {
      return doc;
    }

-    // Look for headings
-    let selector = `:is(${options.headingSelector}):not([data-no-anchor], [data-no-anchor] *)`;
+    // 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])`;
    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);
@@ -65,7 +79,7 @@ export function anchorHeadingsTransformer(options = {}) {
      const anchor = parse(`
        <a href="#${encodeURIComponent(id)}">
          <span class="wa-visually-hidden"></span>
-          <span aria-hidden="true">#</span>
+          <wa-icon variant="regular" name="hashtag" class="icon-shrink"></wa-icon>
        </a>
      `);
      anchor.querySelector('.wa-visually-hidden').textContent = options.anchorLabel;
--- a/packages/webawesome/docs/assets/images/app-icons/app-icon-192x192.png
+++ b/packages/webawesome/docs/assets/images/app-icons/app-icon-192x192.png
--- a/packages/webawesome/docs/assets/images/app-icons/app-icon-512x512.png
+++ b/packages/webawesome/docs/assets/images/app-icons/app-icon-512x512.png
--- a/packages/webawesome/docs/assets/images/app-icons/app-icon.svg
+++ b/packages/webawesome/docs/assets/images/app-icons/app-icon.svg
@@ -0,0 +1 @@
+<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>
--- a/packages/webawesome/docs/assets/images/app-icons/apple-touch-icon.png
+++ b/packages/webawesome/docs/assets/images/app-icons/apple-touch-icon.png
--- a/packages/webawesome/docs/assets/images/app-icons/favicon.ico
+++ b/packages/webawesome/docs/assets/images/app-icons/favicon.ico
--- a/packages/webawesome/docs/assets/images/app-icons/icon.svg
+++ b/packages/webawesome/docs/assets/images/app-icons/icon.svg
@@ -0,0 +1 @@
+<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>
--- a/packages/webawesome/docs/assets/images/open-graph/default.png
+++ b/packages/webawesome/docs/assets/images/open-graph/default.png
--- a/packages/webawesome/docs/assets/images/web-awesome-mark-black.svg
+++ b/packages/webawesome/docs/assets/images/web-awesome-mark-black.svg
@@ -1,3 +0,0 @@
-<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>
--- a/packages/webawesome/docs/assets/images/webawesome-logo.svg
+++ b/packages/webawesome/docs/assets/images/webawesome-logo.svg
@@ -1,3 +0,0 @@
-<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>
--- a/packages/webawesome/docs/assets/images/webawesome-wordmark.svg
+++ b/packages/webawesome/docs/assets/images/webawesome-wordmark.svg
--- a/packages/webawesome/docs/assets/scripts/code-examples.js
+++ b/packages/webawesome/docs/assets/scripts/code-examples.js
@@ -1,3 +1,6 @@
+const version = document.documentElement.getAttribute('data-version') || '';
+const CDN_URL = `https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@${version}/dist-cdn/`;
+
 //
 // Resizing previews
 //
@@ -54,10 +57,9 @@ 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="${cdnUrl}webawesome.loader.js"></script>\n` +
-      `<link rel="stylesheet" href="${cdnUrl}styles/webawesome.css">\n\n` +
+      `<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` +
      `${code.textContent}`;
    const css = 'html > body {\n  padding: 2rem !important;\n}';
    const js = '';
--- a/packages/webawesome/docs/assets/scripts/search.js
+++ b/packages/webawesome/docs/assets/scripts/search.js
@@ -1,5 +1,6 @@
 // Search data
-const res = await Promise.all([import('https://cdn.jsdelivr.net/npm/lunr/+esm'), fetch('/search.json')]);
+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}`)]);
 const lunr = res[0].default;
 const searchData = await res[1].json();
 const searchIndex = lunr.Index.load(searchData.searchIndex);
--- a/packages/webawesome/docs/assets/styles/docs.css
+++ b/packages/webawesome/docs/assets/styles/docs.css
@@ -27,6 +27,61 @@ 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);
@@ -314,26 +369,6 @@ 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;
@@ -628,6 +663,10 @@ wa-scroller:has(.component-table) {
    min-width: var(--line-length-xs);
  }

+  .table-selector .wa-cluster {
+    flex-wrap: nowrap;
+  }
+
  .table-reflect {
    text-align: center;
  }
--- a/packages/webawesome/docs/assets/styles/search.css
+++ b/packages/webawesome/docs/assets/styles/search.css
@@ -5,7 +5,6 @@
  border-radius: var(--wa-border-radius-l);
  padding: 0;
  margin: 0 auto;
-  overflow: hidden;

  &::part(dialog) {
    margin-block-start: 10vh;
--- a/packages/webawesome/docs/assets/styles/utils.css
+++ b/packages/webawesome/docs/assets/styles/utils.css
@@ -70,9 +70,8 @@
  /* #region shared UI */
  /* pro badge */
  wa-badge.pro {
-    color: white;
+    color: var(--wa-color-brand-on-loud);
    background-color: var(--wa-brand-orange);
-    border-color: var(--wa-brand-orange);

    + wa-tooltip {
      font-size: var(--wa-font-size-xs);
@@ -80,6 +79,14 @@
    }
  }

+  /* 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);
@@ -123,10 +130,54 @@
    }
  }

+  /* 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);
--- a/packages/webawesome/docs/docs/color-palettes.njk
+++ b/packages/webawesome/docs/docs/color-palettes.njk
@@ -66,14 +66,71 @@ 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 %}>
-    <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>
+    <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>
  {% endfor %}
 </div>

@@ -121,6 +178,7 @@ layout: page
      display: flex;
      flex-direction: row;
      flex-wrap: wrap;
+      gap: var(--wa-space-m);
    }

    &::part(form-control-label) {
@@ -133,7 +191,11 @@ layout: page
      overflow: hidden;
      white-space: nowrap;
      padding: 0;
-   }
+    }
+
+    wa-radio {
+      margin-inline: 0;
+    }
  }

  .palette-card {
--- a/packages/webawesome/docs/docs/components/button-group.md
+++ b/packages/webawesome/docs/docs/components/button-group.md
@@ -141,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/components/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/utilities/visually-hidden) label to ensure the dropdown is accessible to users with assistive devices.

 ```html {.example}
 <wa-button-group label="Example Button Group">
--- a/packages/webawesome/docs/docs/components/card.md
+++ b/packages/webawesome/docs/docs/components/card.md
@@ -100,19 +100,20 @@ 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">
-    <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.
+    <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. 
  </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 is a kitten, but not just any kitten. This kitten likes walking along pallets.
+    This card has a video of a dog wearing shades.
  </wa-card>
 </div>

@@ -153,10 +154,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.
-<wa-callout>
-<wa-icon slot="icon" name="circle-info" variant="regular"></wa-icon>
+
+:::info
 The `actions` slot is only available for the horizontal orientation
-</wa-callout>
+:::

 ```html {.example}
 <div class="wa-grid">
@@ -166,7 +167,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 is a kitten, but not just any kitten. This kitten likes walking along pallets.
+    This card has a horizontal orientation with media, body, and actions arranged side-by-side.
    <wa-button slot="actions" variant="neutral" appearance="plain"
      ><wa-icon name="ellipsis" label="actions"></wa-icon
    ></wa-button>
--- a/packages/webawesome/docs/docs/components/comparison.md
+++ b/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 pages](/docs/themes/default/)).
+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)).
 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.)

--- a/packages/webawesome/docs/docs/components/divider.md
+++ b/packages/webawesome/docs/docs/components/divider.md
@@ -53,9 +53,9 @@ The default orientation for dividers is `horizontal`. Set `orientation` attribut
 </div>
 ```

-### Menu Dividers
+### Dropdown Dividers

-Use dividers in [menus](/docs/components/menu) to visually group menu items.
+Use dividers in [dropdowns](/docs/components/dropdown) to visually group dropdown items.

 ```html {.example}
 <wa-dropdown style="max-width: 200px;">
--- a/packages/webawesome/docs/docs/components/include.md
+++ b/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-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-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).

 ```html
 <wa-include src="https://shoelace.style/assets/examples/include.html"></wa-include>
@@ -33,7 +33,7 @@ If the request fails, the `wa-error` event will be emitted. In this case, `event
    }
  });

-  include.addEventListener('wa-error', event => {
+  include.addEventListener('wa-include-error', event => {
    if (event.eventPhase === Event.AT_TARGET) {
      console.log('Error', event.detail.status);
    }
--- a/packages/webawesome/docs/docs/components/radio-group.md
+++ b/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](/docs/components/radio) will be determined by the Radio Group's `size` attribute.
+The size of radios 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](/docs/components/radio) will be determined by the Radio Gro
 ```

 :::info
-[Radios](/docs/components/radio) and [Radio Buttons](/docs/components/radio-button) also have a `size` attribute,
+[Radios](/docs/components/radio) also have a `size` attribute,
 which will override the inherited size when used.
 :::

--- a/packages/webawesome/docs/docs/customizing.md
+++ b/packages/webawesome/docs/docs/customizing.md
@@ -10,27 +10,32 @@ 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.

-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:
+{% 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 %}

-```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:
+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:

 ```css
 :root,
 .wa-light,
 .wa-dark .wa-invert {
-  --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;
+  --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);
 }
 ```

@@ -155,4 +160,4 @@ For example, we can give `<input type="checkbox">` the same custom styles as `<w
    color: lavenderblush;
  }
 </style>
-```
+```
--- a/packages/webawesome/docs/docs/experimental/ssr.md
+++ b/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="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>
+- <script type="module" src="/dist/webawesome.loader.js"></script>
+ <script type="module" src="/dist/webawesome.ssr-loader.js"></script>
 ```

 If you're using a bundler, make sure it comes _before_ any components are imported.
@@ -43,7 +43,10 @@ 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',
+  ],
 });
 ```

@@ -114,4 +117,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.
--- a/packages/webawesome/docs/docs/index.md
+++ b/packages/webawesome/docs/docs/index.md
@@ -12,42 +12,27 @@ Welcome to Web Awesome! [Learn more](https://webawesome.com/) about this project

 ---

-## Quick Start (Autoloading via CDN)
+## 🚀 Using a Project

-To get everything included in Web Awesome, add the following code to the `<head>` of your site:
+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.

-```html
-<link rel="stylesheet" href="{% cdnUrl 'styles/webawesome.css' %}" />
-<script type="module" src="{% cdnUrl 'webawesome.loader.js' %}"></script>
-```
+One line of code from us. The entire Web Awesome library for you.

-This snippet adds:
+To use a project:

- **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!
-:::
+{% 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 %}

 ---

@@ -63,31 +48,9 @@ Not a Font Awesome user yet? [Learn more about premium icon packs](https://fonta
 {% endraw %}
 </div>

-## Advanced Setup
+## 🛠️ Advanced Setup

-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.
-:::
+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.

 ### Installing via npm

@@ -116,11 +79,48 @@ 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 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.
+==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.

 ```html
 <!-- Option 1: the data-webawesome attribute -->
@@ -153,18 +153,26 @@ Most of the magic behind assets is handled internally by Web Awesome, but if you
 </script>
 ```

-### The Difference Between `/dist` & `/dist-cdn`
+### Using Font Awesome Pro and Pro+

-If you have Web Awesome installed locally via npm, you'll notice the following directories in the project's root:
+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.

-```
-dist/
-dist-cdn/
+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>
 ```

-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.
+:::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!
+:::

 ## React Users

--- a/packages/webawesome/docs/docs/layout.njk
+++ b/packages/webawesome/docs/docs/layout.njk
@@ -43,22 +43,56 @@ layout: docs

 <wa-divider style="--spacing: var(--wa-space-3xl);"></wa-divider>

-<div class="max-line-length">
 {% markdown %}
-## Installation
+## Using Layout Utilities

-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).
+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 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:
+<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>

-```html
-<link rel="stylesheet" href="{% cdnUrl 'styles/webawesome.css' %}" />
+  <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, you can choose to import _only_ the utilities:
+Or, if you only want CSS utility classes, import a theme and the utilities individually:

-```html
-<link rel="stylesheet" href="{% cdnUrl 'styles/utilities.css' %}" />
+```js
+import '@awesome.me/webawesome/dist/styles/themes/default.css';
+import '@awesome.me/webawesome/dist/styles/utilities.css';
 ```
 {% endmarkdown %}
-</div>
+  </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:
+
+```html
+<link rel="stylesheet" href="/dist/styles/webawesome.css" />
+```
+
+Or, if you only want CSS utility classes, include a theme and the utilities individually:
+
+```html
+<link rel="stylesheet" href="/dist/styles/themes/default.css" />
+<link rel="stylesheet" href="/dist/styles/utilities.css" />
+```
+{% endmarkdown %}
+  </wa-tab-panel>
+</wa-tab-group>
--- a/packages/webawesome/docs/docs/localization.md
+++ b/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 '{% cdnUrl "translations/<code>.js" %}';
+import '/dist/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('{% cdnUrl "translations/<code>.js" %}');
+import('/translations/<code>.js');
 ```

 ### Translation Resolution
--- a/packages/webawesome/docs/docs/resources/changelog.md
+++ b/packages/webawesome/docs/docs/resources/changelog.md
@@ -1,10 +1,11 @@
 ---
 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="{{ lastUpdatedISO }}"></wa-format-date></p>
+<p class="wa-caption-s">Last updated: <wa-format-date month="long" day="numeric" year="numeric" date="{{ dateLastUpdated }}"></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.

@@ -12,20 +13,32 @@ Components with the <wa-badge variant="warning">Experimental</wa-badge> badge sh

 ## Next

+- 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]
+- Improved performance of `<wa-icon>` so initial rendering occurs faster, especially with multiple icons on the page [issue:1729]
+
+## 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>`
  - `<wa-tag>`
  - `<wa-textarea>`
+- 🚨 BREAKING: Fixed a bug where `base` and `input` parts were swapped in `<wa-input>` [issue:1646]
 - 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]
@@ -38,8 +51,13 @@ 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]
 - Upgraded `<wa-page>` from _experimental_ to _stable_

@@ -238,7 +256,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 [a theme builder](/docs/themes/edit/) to create your own themes
+- Added Theme Builder 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>`
@@ -255,7 +273,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](/docs/utilities/appearance/) 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 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
@@ -280,7 +298,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/checkbox)
+- Fixed the missing indeterminate icon in [native checkbox styles](/docs/utilities/native/#form-controls)
 - 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
@@ -427,13 +445,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/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).
+  [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).

 ### Style utilities {data-no-outline}

@@ -441,7 +459,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/a11y/#visually-hidden) utility
+- Added [`.wa-visually hidden`](/docs/utilities/visually-hidden) utility
 - Added [`<wa-page>`](/docs/components/page/#styles) native styles and utilities

 ### Components {data-no-outline}
--- a/packages/webawesome/docs/docs/resources/contributing.md
+++ b/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 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).
+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).

 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](/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](/docs/components/icon#customizing-the-system-library):

 ```html
 <wa-icon library="system" name="..." variant="..."></wa-icon>
--- a/packages/webawesome/docs/docs/resources/support.md
+++ b/packages/webawesome/docs/docs/resources/support.md
@@ -0,0 +1,91 @@
+---
+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>
--- a/packages/webawesome/docs/docs/themes.njk
+++ b/packages/webawesome/docs/docs/themes.njk
@@ -4,6 +4,9 @@ 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>
@@ -64,8 +67,9 @@ 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>
-      <wa-badge data-free-badge appearance="outlined" variant="neutral" hidden>FREE</wa-badge>
-      <wa-badge data-pro-badge appearance="accent" hidden>PRO</wa-badge>
+      {{ 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." }) }}
+
    </div>
    <p data-theme-description>Description</p>
  </header>
@@ -86,16 +90,70 @@ 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 %}>
-    <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>
+    <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>
  {% endfor %}
 </div>

@@ -108,8 +166,12 @@ to create a project with any one of these themes.
  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.querySelector('[data-free-badge]');
-  const proBadge = document.querySelector('[data-pro-badge]');
+  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;

  function updateFrames(selectedValue, title, description, isPro, palette, brand) {
    // Update theme classes on both frames
@@ -225,14 +287,13 @@ to create a project with any one of these themes.
  }

  #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) {
@@ -246,6 +307,10 @@ to create a project with any one of these themes.
        white-space: nowrap;
        padding: 0;
      }
+
+      wa-radio {
+        margin-inline: 0;
+      }
    }

    .theme-card {
--- a/packages/webawesome/docs/docs/usage.md
+++ b/packages/webawesome/docs/docs/usage.md
@@ -40,6 +40,7 @@ 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.
@@ -52,7 +53,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'],
 });
 ```

@@ -194,12 +195,11 @@ 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 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.
+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.

 ```json
 {
--- a/packages/webawesome/docs/docs/utilities/cluster.md
+++ b/packages/webawesome/docs/docs/utilities/cluster.md
@@ -84,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/style-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/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`
@@ -119,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/style-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/utilities/gap) classes to an element with `wa-cluster` to specify the gap between items:

 - `wa-gap-0`
 - `wa-gap-3xs`
--- a/packages/webawesome/docs/docs/utilities/flank.md
+++ b/packages/webawesome/docs/docs/utilities/flank.md
@@ -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/style-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/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/style-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/utilities/gap) classes to an element with `wa-flank` to specify the gap between items:

 - `wa-gap-0`
 - `wa-gap-3xs`
--- a/packages/webawesome/docs/docs/utilities/fouce.md
+++ b/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 change 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 chance 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.

--- a/packages/webawesome/docs/docs/utilities/frame.md
+++ b/packages/webawesome/docs/docs/utilities/frame.md
@@ -139,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/style-utilities/border-radius) 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/utilities/rounding) classes to an element with `wa-frame` to specify the border radius:

 - `wa-border-radius-s`
 - `wa-border-radius-m`
--- a/packages/webawesome/docs/docs/utilities/gap.md
+++ b/packages/webawesome/docs/docs/utilities/gap.md
@@ -14,7 +14,7 @@ tags: layoutUtilities
  }
 </style>

-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.
+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/utilities/cluster) and [stack](/docs/utilities/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.
--- a/packages/webawesome/docs/docs/utilities/grid.md
+++ b/packages/webawesome/docs/docs/utilities/grid.md
@@ -169,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/style-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/utilities/gap) classes to an element with `wa-grid` to specify the gap between items:

 - `wa-gap-0`
 - `wa-gap-3xs`
--- a/packages/webawesome/docs/docs/utilities/index.njk
+++ b/packages/webawesome/docs/docs/utilities/index.njk
@@ -45,22 +45,54 @@ layout: docs

 <wa-divider style="--spacing: var(--wa-space-3xl);"></wa-divider>

-<div class="max-line-length">
 {% markdown %}
-## Installation
-
-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="{% cdnUrl 'styles/webawesome.css' %}" />
-```
-
-Or, to _only_ include utilities:
-
-```html
-<link rel="stylesheet" href="{% cdnUrl 'styles/utilities.css' %}" />
-```
-
+## Using {{ title }}
 {% endmarkdown %}

-</div>
+<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:
+
+```html
+<link rel="stylesheet" href="/dist/styles/webawesome.css" />
+```
+
+Or, if you only want CSS utility classes, include a theme and the utilities individually:
+
+```html
+<link rel="stylesheet" href="/dist/styles/themes/default.css" />
+<link rel="stylesheet" href="/dist/styles/utilities.css" />
+```
+{% endmarkdown %}
+  </wa-tab-panel>
+</wa-tab-group>
--- a/packages/webawesome/docs/docs/utilities/native.md
+++ b/packages/webawesome/docs/docs/utilities/native.md
@@ -9,18 +9,53 @@ 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="{% cdnUrl 'styles/webawesome.css' %}" />
+<link rel="stylesheet" href="/dist/styles/webawesome.css" />
 ```

-Or, if you only want styles for native elements, include the default theme and native styles individually:
+Or, if you only want styles for native elements, include a theme and native styles individually:

 ```html
-<link rel="stylesheet" href="{% cdnUrl 'styles/themes/default.css' %}" />
-<link rel="stylesheet" href="{% cdnUrl 'styles/native.css' %}" />
+<link rel="stylesheet" href="/dist/styles/themes/default.css" />
+<link rel="stylesheet" href="/dist/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.

@@ -30,10 +65,18 @@ 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>
@@ -191,8 +234,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"
 />
 ```
@@ -204,7 +247,9 @@ 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>
@@ -347,7 +392,6 @@ 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>
@@ -406,7 +450,8 @@ 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>
@@ -432,6 +477,7 @@ 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" />
@@ -510,7 +556,8 @@ 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>
--- a/packages/webawesome/docs/docs/utilities/rounding.md
+++ b/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/layout/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/utilities/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.

--- a/packages/webawesome/docs/docs/utilities/split.md
+++ b/packages/webawesome/docs/docs/utilities/split.md
@@ -106,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/style-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/utilities/align-items) classes to an element with `wa-split` to specify how items are aligned:

 - `wa-align-items-start`
 - `wa-align-items-end`
@@ -139,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/style-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/utilities/gap) classes to an element with `wa-split` to specify the gap between items:

 - `wa-gap-0`
 - `wa-gap-3xs`
--- a/packages/webawesome/docs/docs/utilities/stack.md
+++ b/packages/webawesome/docs/docs/utilities/stack.md
@@ -62,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/style-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/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`
@@ -92,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/style-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/utilities/gap) classes to an element with `wa-stack` to specify the gap between items:

 - `wa-gap-0`
 - `wa-gap-3xs`
--- a/packages/webawesome/docs/index.md
+++ b/packages/webawesome/docs/index.md
@@ -238,22 +238,14 @@ 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 %}
-          {% 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 %}
+          <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>
        {% endif %}
      {% endraw %}
    </div>
--- a/packages/webawesome/docs/manifest.json
+++ b/packages/webawesome/docs/manifest.json
@@ -0,0 +1,21 @@
+{
+  "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"
+    }
+  ]
+}
--- a/packages/webawesome/package.json
+++ b/packages/webawesome/package.json
@@ -4,7 +4,7 @@
    "access": "public"
  },
  "description": "A forward-thinking library of web components.",
-  "version": "3.0.0-beta.6",
+  "version": "3.0.0",
  "homepage": "https://webawesome.com/",
  "author": "Web Awesome",
  "license": "MIT",
@@ -90,6 +90,7 @@
  },
  "devDependencies": {
    "@wc-toolkit/jsx-types": "^1.3.0",
-    "eleventy-plugin-git-commit-date": "^0.1.3"
+    "eleventy-plugin-git-commit-date": "^0.1.3",
+    "esbuild": "^0.25.11"
  }
 }
--- a/packages/webawesome/src/components/button-group/button-group.ts
+++ b/packages/webawesome/src/components/button-group/button-group.ts
@@ -3,7 +3,6 @@ import { html } from 'lit';
 import { customElement, property, query, state } from 'lit/decorators.js';
 import { classMap } from 'lit/directives/class-map.js';
 import WebAwesomeElement from '../../internal/webawesome-element.js';
-import variantStyles from '../../styles/utilities/variants.css';
 import type WaButton from '../button/button.js';
 import styles from './button-group.css';

@@ -19,7 +18,7 @@ import styles from './button-group.css';
 */
@customElement('wa-button-group')
 export default class WaButtonGroup extends WebAwesomeElement {
-  static css = [variantStyles, styles];
+  static css = [styles];

  @query('slot') defaultSlot: HTMLSlotElement;

@@ -35,9 +34,6 @@ export default class WaButtonGroup extends WebAwesomeElement {
  /** The button group's orientation. */
  @property({ reflect: true }) orientation: 'horizontal' | 'vertical' = 'horizontal';

-  /** The button group's theme variant. Defaults to `neutral` if not within another element with a variant. */
-  @property({ reflect: true }) variant: 'neutral' | 'brand' | 'success' | 'warning' | 'danger' = 'neutral';
-
  updated(changedProperties: PropertyValues<this>) {
    super.updated(changedProperties);

--- a/packages/webawesome/src/components/card/card.css
+++ b/packages/webawesome/src/components/card/card.css
@@ -16,27 +16,28 @@
 }

 /* Appearance modifiers */
-:host([appearance~='plain']) {
+:host([appearance='plain']) {
  background-color: transparent;
  border-color: transparent;
  box-shadow: none;
 }

-:host([appearance~='outlined']) {
+:host([appearance='outlined']) {
  background-color: var(--wa-color-surface-default);
  border-color: var(--wa-color-surface-border);
 }

-:host([appearance~='filled']) {
+:host([appearance='filled']) {
  background-color: var(--wa-color-neutral-fill-quiet);
  border-color: transparent;
 }

-:host([appearance~='filled'][appearance~='outlined']) {
-  border-color: var(--wa-color-neutral-border-quiet);
+:host([appearance='filled-outlined']) {
+  background-color: var(--wa-color-neutral-fill-quiet);
+  border-color: var(--wa-color-surface-border);
 }

-:host([appearance~='accent']) {
+:host([appearance='accent']) {
  color: var(--wa-color-neutral-on-loud);
  background-color: var(--wa-color-neutral-fill-loud);
  border-color: transparent;
@@ -77,9 +78,7 @@
 }

 .header {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
+  display: block;
  border-block-end-style: inherit;
  border-block-end-color: var(--wa-color-surface-border);
  border-block-end-width: var(--wa-panel-border-width);
@@ -92,15 +91,20 @@
 }

 .footer {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
+  display: block;
  border-block-start-style: inherit;
  border-block-start-color: var(--wa-color-surface-border);
  border-block-start-width: var(--wa-panel-border-width);
  padding: var(--spacing);
 }

+/* Push slots to sides when the action slots renders */
+.has-actions {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+}
+
 :host(:not([with-header])) .header,
 :host(:not([with-footer])) .footer,
 :host(:not([with-media])) .media {
@@ -115,7 +119,12 @@
    border-start-start-radius: var(--inner-border-radius);
    border-end-start-radius: var(--inner-border-radius);
    border-start-end-radius: 0;
-    object-fit: cover;
+
+    &::slotted(*) {
+      block-size: 100%;
+      inline-size: 100%;
+      object-fit: cover;
+    }
  }
 }

--- a/packages/webawesome/src/components/card/card.ts
+++ b/packages/webawesome/src/components/card/card.ts
@@ -30,11 +30,19 @@ import styles from './card.css';
 export default class WaCard extends WebAwesomeElement {
  static css = [sizeStyles, styles];

-  private readonly hasSlotController = new HasSlotController(this, 'footer', 'header', 'media');
+  private readonly hasSlotController = new HasSlotController(
+    this,
+    'footer',
+    'header',
+    'media',
+    'header-actions',
+    'footer-actions',
+    'actions',
+  );

  /** The card's visual appearance. */
  @property({ reflect: true })
-  appearance: 'accent' | 'filled' | 'outlined' | 'plain' = 'outlined';
+  appearance: 'accent' | 'filled' | 'outlined' | 'filled-outlined' | 'plain' = 'outlined';

  /** Renders the card with a header. Only needed for SSR, otherwise is automatically added. */
  @property({ attribute: 'with-header', type: Boolean, reflect: true }) withHeader = false;
@@ -69,15 +77,25 @@ export default class WaCard extends WebAwesomeElement {
    // Vertical Orientation
    return html`
      <slot name="media" part="media" class="media"></slot>
-      <header part="header" class="header">
-        <slot name="header"></slot>
-        <slot name="header-actions"></slot>
-      </header>
+
+      ${this.hasSlotController.test('header-actions')
+        ? html` <header part="header" class="header has-actions">
+            <slot name="header"></slot>
+            <slot name="header-actions"></slot>
+          </header>`
+        : html` <header part="header" class="header">
+            <slot name="header"></slot>
+          </header>`}
+
      <slot part="body" class="body"></slot>
-      <footer part="footer" class="footer">
-        <slot name="footer"></slot>
-        <slot name="footer-actions"></slot>
-      </footer>
+      ${this.hasSlotController.test('footer-actions')
+        ? html` <footer part="footer" class="footer has-actions">
+            <slot name="footer"></slot>
+            <slot name="footer-actions"></slot>
+          </footer>`
+        : html` <footer part="footer" class="footer">
+            <slot name="footer"></slot>
+          </footer>`}
    `;
  }
 }
--- a/packages/webawesome/src/components/dropdown/dropdown.test.ts
+++ b/packages/webawesome/src/components/dropdown/dropdown.test.ts
@@ -1,4 +1,6 @@
-import { expect, fixture, html } from '@open-wc/testing';
+import { aTimeout, expect, fixture, html, waitUntil } from '@open-wc/testing';
+import sinon from 'sinon';
+import type WaDropdown from './dropdown.js';

 describe('<wa-dropdown>', () => {
  it('should render a component', async () => {
@@ -6,4 +8,112 @@ describe('<wa-dropdown>', () => {

    expect(el).to.exist;
  });
+
+  it('should respect the open attribute when included', async () => {
+    const el = await fixture<WaDropdown>(html`
+      <wa-dropdown open>
+        <wa-button slot="trigger">Dropdown</wa-button>
+        <wa-dropdown-item>One</wa-dropdown-item>
+      </wa-dropdown>
+    `);
+
+    await el.updateComplete;
+    await aTimeout(200);
+
+    expect(el.open).to.be.true;
+  });
+
+  it('should fire a single show/after-show and hide/after-hide in normal open/close flow', async () => {
+    const el = await fixture<WaDropdown>(html`
+      <wa-dropdown>
+        <wa-button slot="trigger">Dropdown</wa-button>
+        <wa-dropdown-item>One</wa-dropdown-item>
+        <wa-dropdown-item>Two</wa-dropdown-item>
+      </wa-dropdown>
+    `);
+
+    // setup spies to track how often we see different show/hide events
+    const showSpy = sinon.spy();
+    const afterShowSpy = sinon.spy();
+    const hideSpy = sinon.spy();
+    const afterHideSpy = sinon.spy();
+
+    el.addEventListener('wa-show', showSpy);
+    el.addEventListener('wa-after-show', afterShowSpy);
+    el.addEventListener('wa-hide', hideSpy);
+    el.addEventListener('wa-after-hide', afterHideSpy);
+
+    // open the dropdown by triggering a click on the trigger
+    const trigger = el.querySelector<HTMLElement>('[slot="trigger"]')!;
+    trigger.click();
+
+    await waitUntil(() => showSpy.calledOnce);
+    await waitUntil(() => afterShowSpy.calledOnce);
+
+    expect(showSpy.callCount).to.equal(1);
+    expect(afterShowSpy.callCount).to.equal(1);
+
+    expect(el.open).to.be.true;
+
+    // close the dropdown by clicking the trigger again
+    trigger.click();
+
+    await waitUntil(() => hideSpy.calledOnce);
+    await waitUntil(() => afterHideSpy.calledOnce);
+
+    expect(hideSpy.callCount).to.equal(1);
+    expect(afterHideSpy.callCount).to.equal(1);
+
+    expect(el.open).to.be.false;
+  });
+
+  it('should fire a single show/after-show and hide/after-hide when wa-hide event is cancelled', async () => {
+    const el = await fixture<WaDropdown>(html`
+      <wa-dropdown>
+        <wa-button slot="trigger">Dropdown</wa-button>
+        <wa-dropdown-item>One</wa-dropdown-item>
+        <wa-dropdown-item>Two</wa-dropdown-item>
+      </wa-dropdown>
+    `);
+
+    // setup spies to track how often we see different show/hide events
+    const showSpy = sinon.spy();
+    const afterShowSpy = sinon.spy();
+    const hideSpy = sinon.spy();
+    const afterHideSpy = sinon.spy();
+
+    el.addEventListener('wa-show', showSpy);
+    el.addEventListener('wa-after-show', afterShowSpy);
+
+    // Intercept wa-hide and prevent it
+    el.addEventListener('wa-hide', event => {
+      event.preventDefault();
+      hideSpy(event);
+    });
+
+    el.addEventListener('wa-after-hide', afterHideSpy);
+
+    // open the dropdown by triggering a click on the trigger
+    const trigger = el.querySelector<HTMLElement>('[slot="trigger"]')!;
+    trigger.click();
+
+    await waitUntil(() => showSpy.calledOnce);
+    await waitUntil(() => afterShowSpy.calledOnce);
+
+    expect(showSpy.callCount).to.equal(1);
+    expect(afterShowSpy.callCount).to.equal(1);
+
+    expect(el.open).to.be.true;
+
+    // click on the trigger (which should do nothing to the open state)
+    trigger.click();
+
+    await waitUntil(() => hideSpy.calledOnce);
+
+    expect(hideSpy.callCount).to.equal(1);
+    // after-hide should not have been called if hide is cancelled
+    expect(afterHideSpy.callCount).to.equal(0);
+
+    expect(el.open).to.be.true;
+  });
 });
--- a/packages/webawesome/src/components/dropdown/dropdown.ts
+++ b/packages/webawesome/src/components/dropdown/dropdown.ts
@@ -109,6 +109,18 @@ export default class WaDropdown extends WebAwesomeElement {

  async updated(changedProperties: PropertyValues) {
    if (changedProperties.has('open')) {
+      const previousOpen = changedProperties.get('open');
+      // check if the previous value is the same
+      // (if they are, do not trigger menu showing / hiding)
+      if (previousOpen === this.open) {
+        return;
+      }
+      // check if we are changing from undefined to false
+      // (if we are, we can skip menu hiding)
+      if (previousOpen === undefined && this.open === false) {
+        return;
+      }
+
      this.customStates.set('open', this.open);

      if (this.open) {
@@ -227,6 +239,12 @@ export default class WaDropdown extends WebAwesomeElement {
      return;
    }

+    // if this dropdown is already open, do nothing
+    // (this can happen when wa-hide was cancelled)
+    if (this.popup.active) {
+      return;
+    }
+
    openDropdowns.forEach(dropdown => (dropdown.open = false));

    this.popup.active = true; // Use wa-popup's active property instead of showPopover
--- a/packages/webawesome/src/components/icon/icon.css
+++ b/packages/webawesome/src/components/icon/icon.css
@@ -25,7 +25,6 @@

 svg {
  height: 1em;
-  fill: currentColor;
  overflow: visible;

  /* Duotone colors with path-specific opacity fallback */
--- a/packages/webawesome/src/components/icon/icon.ts
+++ b/packages/webawesome/src/components/icon/icon.ts
@@ -187,7 +187,7 @@ export default class WaIcon extends WebAwesomeElement {
    }
  }

-  @watch(['family', 'name', 'library', 'variant', 'src', 'autoWidth', 'swapOpacity'])
+  @watch(['family', 'name', 'library', 'variant', 'src', 'autoWidth', 'swapOpacity'], { waitUntilFirstUpdate: true })
  async setIcon() {
    const { url, fromLibrary } = this.getIconSource();
    const library = fromLibrary ? getIconLibrary(this.library) : undefined;
@@ -249,7 +249,7 @@ export default class WaIcon extends WebAwesomeElement {
      return this.svg;
    }

-    return html`<svg part="svg" fill="currentColor" width="16" height="16"></svg>`;
+    return html`<svg part="svg" width="16" height="16"></svg>`;
  }
 }

--- a/packages/webawesome/src/components/include/include.ts
+++ b/packages/webawesome/src/components/include/include.ts
@@ -14,7 +14,7 @@ import { requestInclude } from './request.js';
 * @since 2.0
 *
 * @event wa-load - Emitted when the included file is loaded.
- * @event {{ status: number }} wa-error - Emitted when the included file fails to load due to an error.
+ * @event {{ status: number }} wa-include-error - Emitted when the included file fails to load due to an error.
 */
@customElement('wa-include')
 export default class WaInclude extends WebAwesomeElement {
--- a/packages/webawesome/src/components/input/input.ts
+++ b/packages/webawesome/src/components/input/input.ts
@@ -40,8 +40,8 @@ import styles from './input.css';
 *
 * @csspart label - The label
 * @csspart hint - The hint's wrapper.
- * @csspart input - The wrapper being rendered as an input
- * @csspart base - The internal `<input>` control.
+ * @csspart base - The wrapper being rendered as an input
+ * @csspart input - The internal `<input>` control.
 * @csspart start - The container that wraps the `start` slot.
 * @csspart clear-button - The clear button.
 * @csspart password-toggle-button - The password toggle button.
@@ -353,11 +353,11 @@ export default class WaInput extends WebAwesomeFormAssociatedElement {
        <slot name="label">${this.label}</slot>
      </label>

-      <div part="input" class="text-field">
+      <div part="base" class="text-field">
        <slot name="start" part="start" class="start"></slot>

        <input
-          part="base"
+          part="input"
          id="input"
          class="control"
          type=${this.type === 'password' && this.passwordVisible ? 'text' : this.type}
--- a/packages/webawesome/src/components/popover/popover.ts
+++ b/packages/webawesome/src/components/popover/popover.ts
@@ -230,7 +230,7 @@ export default class WaPopover extends WebAwesomeElement {
      return;
    }

-    const newAnchor = this.for ? rootNode.querySelector(`#${this.for}`) : null;
+    const newAnchor = this.for ? rootNode.getElementById(this.for) : null;
    const oldAnchor = this.anchor;

    if (newAnchor === oldAnchor) {
--- a/packages/webawesome/src/components/radio/radio.css
+++ b/packages/webawesome/src/components/radio/radio.css
@@ -174,7 +174,7 @@
 }

 :host([appearance='button']:state(checked):focus-visible) {
-  outline: var(--wa-focus-ring-style) var(--wa-focus-ring-width) var(--wa-color-brand-border-loud);
+  outline: var(--wa-focus-ring);
  outline-offset: var(--wa-focus-ring-offset);
 }

--- a/packages/webawesome/src/components/scroller/scroller.css
+++ b/packages/webawesome/src/components/scroller/scroller.css
@@ -53,6 +53,19 @@
  overflow-y: auto;
 }

+#start-shadow,
+#end-shadow {
+  z-index: 2;
+}
+
+#start-shadow {
+  opacity: var(--start-shadow-opacity);
+}
+
+#end-shadow {
+  opacity: var(--end-shadow-opacity);
+}
+
 /* Horizontal shadows */
 :host([orientation='horizontal']) {
  #start-shadow,
@@ -64,14 +77,6 @@
    pointer-events: none;
  }

-  #start-shadow {
-    opacity: var(--start-shadow-opacity);
-  }
-
-  #end-shadow {
-    opacity: var(--end-shadow-opacity);
-  }
-
  #start-shadow {
    &:dir(ltr) {
      left: 0;
@@ -102,21 +107,12 @@
  #start-shadow,
  #end-shadow {
    position: absolute;
-    z-index: 2;
    right: 0;
    left: 0;
    height: var(--shadow-size);
    pointer-events: none;
  }

-  #start-shadow {
-    opacity: var(--start-shadow-opacity);
-  }
-
-  #end-shadow {
-    opacity: var(--end-shadow-opacity);
-  }
-
  #start-shadow {
    top: 0;
    background: linear-gradient(to bottom, var(--shadow-color), transparent 100%);
--- a/packages/webawesome/src/components/select/select.css
+++ b/packages/webawesome/src/components/select/select.css
@@ -74,7 +74,6 @@
  padding: 0 var(--wa-form-control-padding-inline);
  position: relative;
  vertical-align: middle;
-  width: 100%;
  transition:
    background-color var(--wa-transition-normal),
    border var(--wa-transition-normal),
--- a/packages/webawesome/src/components/select/select.ts
+++ b/packages/webawesome/src/components/select/select.ts
@@ -119,7 +119,7 @@ export default class WaSelect extends WebAwesomeFormAssociatedElement {
  @state() optionValues: Set<string | null> | undefined;

  /** The name of the select, submitted as a name/value pair with form data. */
-  @property() name = '';
+  @property({ reflect: true }) name = '';

  private _defaultValue: null | string | string[] = null;

--- a/packages/webawesome/src/components/slider/slider.ts
+++ b/packages/webawesome/src/components/slider/slider.ts
@@ -690,8 +690,8 @@ export default class WaSlider extends WebAwesomeFormAssociatedElement {
    if (!this.withTooltip) return;

    // Show only the active tooltip, hide the other
-    const tooltipMin = this.shadowRoot?.querySelector('#tooltip-thumb-min') as WaTooltip;
-    const tooltipMax = this.shadowRoot?.querySelector('#tooltip-thumb-max') as WaTooltip;
+    const tooltipMin = this.shadowRoot?.getElementById('tooltip-thumb-min') as WaTooltip;
+    const tooltipMax = this.shadowRoot?.getElementById('tooltip-thumb-max') as WaTooltip;

    if (this.activeThumb === 'min') {
      if (tooltipMin) tooltipMin.open = true;
@@ -705,8 +705,8 @@ export default class WaSlider extends WebAwesomeFormAssociatedElement {
  private hideRangeTooltips() {
    if (!this.withTooltip) return;

-    const tooltipMin = this.shadowRoot?.querySelector('#tooltip-thumb-min') as WaTooltip;
-    const tooltipMax = this.shadowRoot?.querySelector('#tooltip-thumb-max') as WaTooltip;
+    const tooltipMin = this.shadowRoot?.getElementById('tooltip-thumb-min') as WaTooltip;
+    const tooltipMax = this.shadowRoot?.getElementById('tooltip-thumb-max') as WaTooltip;

    if (tooltipMin) tooltipMin.open = false;
    if (tooltipMax) tooltipMax.open = false;
--- a/packages/webawesome/src/components/tooltip/tooltip.ts
+++ b/packages/webawesome/src/components/tooltip/tooltip.ts
@@ -137,8 +137,7 @@ export default class WaTooltip extends WebAwesomeElement {
    this.eventController.abort();

    if (this.anchor) {
-      const label = this.anchor.getAttribute('aria-labelledby') || '';
-      this.anchor.setAttribute('aria-labelledby', label.replace(this.id, ''));
+      this.removeFromAriaLabelledBy(this.anchor, this.id);
    }
  }

@@ -202,6 +201,34 @@ export default class WaTooltip extends WebAwesomeElement {
    return triggers.includes(triggerType);
  }

+  /** Adds the tooltip ID to the aria-labelledby attribute */
+  private addToAriaLabelledBy(element: Element, id: string) {
+    const currentLabel = element.getAttribute('aria-labelledby') || '';
+    const labels = currentLabel.split(/\s+/).filter(Boolean);
+
+    // Only add if not already present
+    if (!labels.includes(id)) {
+      labels.push(id);
+      element.setAttribute('aria-labelledby', labels.join(' '));
+    }
+  }
+
+  /** Removes the tooltip ID from the aria-labelledby attribute */
+  private removeFromAriaLabelledBy(element: Element, id: string) {
+    const currentLabel = element.getAttribute('aria-labelledby') || '';
+    const labels = currentLabel.split(/\s+/).filter(Boolean);
+
+    // Remove the ID
+    const filteredLabels = labels.filter(label => label !== id);
+
+    if (filteredLabels.length > 0) {
+      element.setAttribute('aria-labelledby', filteredLabels.join(' '));
+    } else {
+      // Remove the attribute if empty
+      element.removeAttribute('aria-labelledby');
+    }
+  }
+
  @watch('open', { waitUntilFirstUpdate: true })
  async handleOpenChange() {
    if (this.open) {
@@ -252,7 +279,7 @@ export default class WaTooltip extends WebAwesomeElement {
      return;
    }

-    const newAnchor = this.for ? rootNode.querySelector(`#${this.for}`) : null;
+    const newAnchor = this.for ? rootNode.getElementById(this.for) : null;
    const oldAnchor = this.anchor;

    if (newAnchor === oldAnchor) {
@@ -261,9 +288,6 @@ export default class WaTooltip extends WebAwesomeElement {

    const { signal } = this.eventController;

-    // "\\b" is a space boundary, used for making sure we don't add the tooltip to aria-labelledby twice.
-    const labelRegex = new RegExp(`\\b${this.id}\\b`);
-
    if (newAnchor) {
      /**
       * We use `aria-labelledby` because it seems to have the most consistent screen reader experience.
@@ -272,10 +296,7 @@ export default class WaTooltip extends WebAwesomeElement {
       * whereas with `aria-labelledby` it'll still read on first focus. The APG does and WAI-ARIA does recommend aria-describedby
       * so perhaps once we have cross-root aria, we can revisit this decision.
       */
-      const currentLabel = newAnchor.getAttribute('aria-labelledby') || '';
-      if (!currentLabel.match(labelRegex)) {
-        newAnchor.setAttribute('aria-labelledby', currentLabel + ' ' + this.id);
-      }
+      this.addToAriaLabelledBy(newAnchor, this.id);

      newAnchor.addEventListener('blur', this.handleBlur, { capture: true, signal });
      newAnchor.addEventListener('focus', this.handleFocus, { capture: true, signal });
@@ -285,8 +306,7 @@ export default class WaTooltip extends WebAwesomeElement {
    }

    if (oldAnchor) {
-      const label = oldAnchor.getAttribute('aria-labelledby') || '';
-      oldAnchor.setAttribute('aria-labelledby', label.replace(labelRegex, ''));
+      this.removeFromAriaLabelledBy(oldAnchor, this.id);
      oldAnchor.removeEventListener('blur', this.handleBlur, { capture: true });
      oldAnchor.removeEventListener('focus', this.handleFocus, { capture: true });
      oldAnchor.removeEventListener('click', this.handleClick);
--- a/packages/webawesome/src/components/tree-item/tree-item.css
+++ b/packages/webawesome/src/components/tree-item/tree-item.css
@@ -73,12 +73,16 @@ slot:not([name])::slotted(wa-icon) {
  rotate: -90deg;
 }

-.tree-item-expanded slot[name='expand-icon'],
+.tree-item-expanded:not(.tree-item-loading) slot[name='expand-icon'],
 .tree-item:not(.tree-item-expanded) slot[name='collapse-icon'] {
  display: none;
 }

-.tree-item:not(.tree-item-has-expand-button) .expand-icon-slot {
+.tree-item:not(.tree-item-has-expand-button):not(.tree-item-loading) .expand-icon-slot {
+  display: none;
+}
+
+.tree-item-loading .expand-icon-slot wa-icon {
  display: none;
 }

--- a/packages/webawesome/src/components/tree-item/tree-item.ts
+++ b/packages/webawesome/src/components/tree-item/tree-item.ts
@@ -254,6 +254,7 @@ export default class WaTreeItem extends WebAwesomeElement {
          'tree-item-expanded': this.expanded,
          'tree-item-selected': this.selected,
          'tree-item-leaf': this.isLeaf,
+          'tree-item-loading': this.loading,
          'tree-item-has-expand-button': showExpandButton,
        })}"
      >
@@ -272,8 +273,10 @@ export default class WaTreeItem extends WebAwesomeElement {
              ${when(
                this.loading,
                () => html` <wa-spinner part="spinner" exportparts="base:spinner__base"></wa-spinner> `,
+                () => html`
+                  <wa-icon name=${isRtl ? 'chevron-left' : 'chevron-right'} library="system" variant="solid"></wa-icon>
+                `,
              )}
-              <wa-icon name=${isRtl ? 'chevron-left' : 'chevron-right'} library="system" variant="solid"></wa-icon>
            </slot>
            <slot class="expand-icon-slot" name="collapse-icon">
              <wa-icon name=${isRtl ? 'chevron-left' : 'chevron-right'} library="system" variant="solid"></wa-icon>
--- a/packages/webawesome/src/events/events.ts
+++ b/packages/webawesome/src/events/events.ts
@@ -11,6 +11,7 @@ export type { WaExpandEvent } from './expand.js';
 export type { WaFinishEvent } from './finish.js';
 export type { WaHideEvent } from './hide.js';
 export type { WaHoverEvent } from './hover.js';
+export type { WaIncludeErrorEvent } from './include-error.js';
 export type { WaIntersectEvent } from './intersect.js';
 export type { WaInvalidEvent } from './invalid.js';
 export type { WaLazyChangeEvent } from './lazy-change.js';
--- a/packages/webawesome/src/internal/drag.ts
+++ b/packages/webawesome/src/internal/drag.ts
@@ -84,8 +84,8 @@ export class DraggableElement {
  }

  private handleDragStart = (event: PointerEvent | TouchEvent) => {
-    const clientX = supportsTouch && 'touches' in event ? event.touches[0].clientX : (event as PointerEvent).clientX;
-    const clientY = supportsTouch && 'touches' in event ? event.touches[0].clientY : (event as PointerEvent).clientY;
+    const clientX = 'touches' in event ? event.touches[0].clientX : (event as PointerEvent).clientX;
+    const clientY = 'touches' in event ? event.touches[0].clientY : (event as PointerEvent).clientY;

    if (
      this.isDragging ||
@@ -105,8 +105,8 @@ export class DraggableElement {
  };

  private handleDragStop = (event: PointerEvent | TouchEvent) => {
-    const clientX = supportsTouch && 'touches' in event ? event.touches[0].clientX : (event as PointerEvent).clientX;
-    const clientY = supportsTouch && 'touches' in event ? event.touches[0].clientY : (event as PointerEvent).clientY;
+    const clientX = 'touches' in event ? event.touches[0].clientX : (event as PointerEvent).clientX;
+    const clientY = 'touches' in event ? event.touches[0].clientY : (event as PointerEvent).clientY;

    this.isDragging = false;
    document.removeEventListener('pointerup', this.handleDragStop);
@@ -117,8 +117,8 @@ export class DraggableElement {
  };

  private handleDragMove = (event: PointerEvent | TouchEvent) => {
-    const clientX = supportsTouch && 'touches' in event ? event.touches[0].clientX : (event as PointerEvent).clientX;
-    const clientY = supportsTouch && 'touches' in event ? event.touches[0].clientY : (event as PointerEvent).clientY;
+    const clientX = 'touches' in event ? event.touches[0].clientX : (event as PointerEvent).clientX;
+    const clientY = 'touches' in event ? event.touches[0].clientY : (event as PointerEvent).clientY;

    // Prevent text selection while dragging
    window.getSelection()?.removeAllRanges();
--- a/packages/webawesome/src/internal/webawesome-element.ts
+++ b/packages/webawesome/src/internal/webawesome-element.ts
@@ -127,17 +127,30 @@ export default class WebAwesomeElement extends LitElement {
    /** Adds or removes the specified custom state. */
    set: (customState: string, active: boolean) => {
      if (!Boolean(this.internals?.states)) return;
-      if (active) {
-        this.internals.states.add(customState);
-      } else {
-        this.internals.states.delete(customState);
+      try {
+        if (active) {
+          this.internals.states.add(customState);
+        } else {
+          this.internals.states.delete(customState);
+        }
+      } catch (e) {
+        if (String(e).includes("must start with '--'")) {
+          /* eslint-disable-next-line */
+          console.error('Your browser implements an outdated version of CustomStateSet. Consider using a polyfill');
+        } else {
+          throw e;
+        }
      }
    },

    /** Determines whether or not the element currently has the specified state. */
    has: (customState: string) => {
      if (!Boolean(this.internals?.states)) return false;
-      return this.internals.states.has(customState);
+      try {
+        return this.internals.states.has(customState);
+      } catch {
+        return false;
+      }
    },
  };

--- a/packages/webawesome/src/styles/native.css
+++ b/packages/webawesome/src/styles/native.css
@@ -228,6 +228,7 @@

    font-family: var(--wa-font-family-code);
    font-size: var(--wa-font-size-smaller);
+    font-weight: var(--wa-font-weight-code);

    border: solid var(--wa-border-width-s) color-mix(in oklab, currentColor, transparent 50%);
    border-radius: var(--wa-border-radius-s);
@@ -281,6 +282,7 @@

    font-family: var(--wa-font-family-code);
    font-size: var(--wa-font-size-smaller);
+    font-weight: var(--wa-font-weight-code);

    background-color: var(--wa-color-overlay-inline);
    border-radius: var(--wa-border-radius-s);
@@ -291,6 +293,7 @@

    font-family: var(--wa-font-family-code);
    font-size: var(--wa-font-size-smaller);
+    font-weight: var(--wa-font-weight-code);
    white-space: pre;

    background-color: var(--wa-color-overlay-inline);
--- a/packages/webawesome/src/styles/themes/awesome.css
+++ b/packages/webawesome/src/styles/themes/awesome.css
@@ -460,7 +460,7 @@
        wa-textarea
      ):not(:focus):not([appearance='filled']) {
      &:where(:not(wa-input):not(wa-select):not(wa-textarea)),
-      &:where(wa-input)::part(input),
+      &:where(wa-input)::part(base),
      &:where(wa-select)::part(combobox),
      &:where(wa-textarea)::part(base) {
        box-shadow: inset var(--wa-shadow-offset-x-s)
--- a/vercel.json
+++ b/vercel.json
@@ -1,5 +1,5 @@
 {
  "$schema": "https://openapi.vercel.sh/vercel.json",
-  "outputDirectory": "packages/webawesome-pro/_site",
+  "outputDirectory": "packages/webawesome/_site",
  "buildCommand": "bash ./vercel.sh"
 }
--- a/vercel.sh
+++ b/vercel.sh
@@ -2,8 +2,4 @@

 echo "Running the build!"

-if [[ "$CLONE_PRO" != "false" ]]; then
-  git clone "https://konnorrogers:$GITHUB_ACCESS_TOKEN@github.com/shoelace-style/webawesome-pro" packages/webawesome-pro
-fi
-
-cd packages/webawesome-pro && npm run build
+cd packages/webawesome && npm install && npm run build
Author	SHA1	Message	Date
Cory LaViska	2e3cb0869c	Merge branch 'next' into scroller-fix	2025-11-19 07:34:14 -05:00
Cory LaViska	1429095eed	Fix SVG fill in `<wa-icon>` (#1784 ) * fix svg fill; closes #1733 * remove fill	2025-11-19 07:33:56 -05:00
Cory LaViska	9706964511	Fix spinner when `<wa-tree-item>` is lazy loaded (#1786 ) * fix spinner when lazy; closes #1678 * remove redundant entry	2025-11-18 15:31:51 -05:00
Cory LaViska	bb0a961784	remove offending property; fixes #1614 (#1792 )	2025-11-18 15:29:57 -05:00
Jesse Jurman	e2f2a8a0d3	Fix: Allow wa-hide to be cancelled in WaDropdown (#1774 ) * Fix: Allow wa-hide to be cancelled in WaDropdown * add tests around open attribute / property * update changelog	2025-11-18 14:07:53 -05:00
Christian Oliff	86293cc3e1	Remove width property from select component (#1736 ) Deleted the duplicate 'width: 100%' style from the select component (already defined on line 56). Also fixed a typo in a comment in the docs CSS. You should setup Stylelint to prevent these issues :-)	2025-11-18 10:03:29 -05:00
Fred	8fb521d9ef	Adding a `reflect` property option to the `name` property (#1716 )	2025-11-17 22:15:18 +00:00
Cory LaViska	991ea10f60	fix scroller styles; closes #1724	2025-11-17 16:27:11 -05:00
Kelsey Jackson	2491ca45ac	Fix `appearance="filled-outlined"` in `<wa-card>` (#1694 ) * upated filled-outlined attribute for cards * updated selector * updated changelog * updated heading * updated css * remove final `~=` selector (thanks @Copilot) Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Lindsay M <126139086+lindsaym-fa@users.noreply.github.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>	2025-11-17 15:12:23 -05:00
Cory LaViska	411d385d65	improve icon perf; closes #1729 (#1783 )	2025-11-17 14:49:45 -05:00
Dimitri	634828d89a	fix(wa-icon): add waitUntilFirstUpdate: true option to the setIcon() watch decorator (#1738 )	2025-11-17 14:49:32 -05:00
Cory LaViska	17fd3d238c	fix typo; closes #1713	2025-11-17 14:38:40 -05:00
Konnor Rogers	ab0f2a1411	add manifest json file copying (#1780 ) * add manifest json file copying * update comment * prettier	2025-11-17 11:31:26 -05:00
Cory LaViska	4069360242	fix card slot detection (#1779 )	2025-11-17 09:51:11 -05:00
Owarie	8c51c5b933	fix: re-add page metadata (#1776 )	2025-11-17 09:47:14 -05:00
Brian Talbot	5a6ce1c4d3	Gating Launch Sale-Based Banner and Dialog (#1769 ) * gating wa-launch banner and dialog based on coupon state * addressing PR feedback * Update packages/webawesome/docs/_includes/_dialog-wa-launch.njk Co-authored-by: Konnor Rogers <konnor5456@gmail.com> --------- Co-authored-by: Konnor Rogers <konnor5456@gmail.com>	2025-11-13 11:46:55 -05:00
Brian Talbot	e695b54dcd	Revert Custom Last Modified Utility (#1750 ) * reverting custom `getLastModifiedISO` utility * using 11ty's `git Last Modified` on docs/resources/changelog * dumbing down "Last updated" date to be static	2025-11-13 11:25:29 -05:00
Brian Talbot	9a3fc59e6a	forcing brand color on launch sale dialog (#1764 ) * to override any docs-based brand	2025-11-12 15:21:28 -05:00
Brian Talbot	dfaa959951	Add Launch Sale Dialog (#1739 ) * adding site-wide dialog to base.njk * adding logic to control dialog rendering * adding sale-based site-wide dialog * overriding docs brand props for `#dialog-site` * adding plausible event tracking to sale-based site-wide dialog	2025-11-12 14:46:04 -05:00
Brian Talbot	9d6ded49b9	Fix Broken Docs Links (#1740 ) * fixing broken links in docs/resources/contributing.md * removing broken links in docs/resources/changelog.md * fixing broken link in docs/components/button-group.md * fixing broken link in docs/components/comparison.md * fixing broken link in docs/components/divider.md * fixing broken link in docs/components/radio-group.md * fixing broken link in docs/utilities/frame.md * fixing broken link in docs/utilities/gap.md * fixing broken link in docs/utilities/rounding.md * Apply suggestions from code review Co-authored-by: Lindsay M <126139086+lindsaym-fa@users.noreply.github.com> * addressing PR feedback --------- Co-authored-by: Lindsay M <126139086+lindsaym-fa@users.noreply.github.com>	2025-11-07 13:35:09 -05:00
Brian Talbot	3451255454	Docs: Add Free Badge (#1696 ) * adding Free Badge macro * using semantic color value for Pro Badge's `color` * removing unncessary `border-color` from Pro Badge's custom CSS * adding `data-pro-badge` attr to Pro Badge * using freeBadge and proBadge macros in themes.njk	2025-11-06 13:12:57 -05:00
Brian Talbot	20628a98eb	🧼 Anchor Link Clean Up (#1732 ) * using wa-icon in generated anchors * moving anchor-heading styling from docs.css to utils.css * improving anchor-heading styling * adding subtle transition * using --wa-space-3xs custom property for padding	2025-11-06 11:13:54 -05:00
Brian Talbot	3d4b3ada27	Allow Setting `data-no-anchor` at the View-Level (#1718 ) * adding option to set 11ty's `data-no-anchor` at view-level * moving all `base.njk` initializations to before `<html>` * updating anchor-headings.js transformer logic	2025-11-05 14:06:56 -05:00
Lindsay M	0bead172fe	Tweak `<wa-radio appearance="button">` focus styles (#1695 )	2025-11-05 13:31:40 -05:00
Christian Oliff	9ca3e6f39c	Fix typo in 'Github' heading to 'GitHub' (#1720 )	2025-11-05 07:25:13 -05:00
Brian Talbot	e2c7286ccc	Control 11ty-Generated Headings' Display via Front Matter (#1715 ) * controlling 11ty generated headings' display via frontmatter * addressing PR feedback * addressing additional PR feedback	2025-11-04 14:10:59 -05:00
Cory LaViska	46812e08c5	fix slider on touch; fixes #1703 (#1709 )	2025-11-03 09:43:21 -05:00
Brian Talbot	0f601df74a	removing page title suffixes from search results (#1697 ) * Use <title> for search indexing but strip trailing site suffix at build time * centralize title logic with shared composePageTitle() and stripSiteTitleSuffix() helpers * introduce single source of truth for site name and separators * keep client search rendering simple; no post-processing in the browser * preserve existing page/OG title behavior while improving search relevance	2025-10-31 14:03:39 -04:00
Cory LaViska	eb2410ff88	fix links (#1691 )	2025-10-30 11:29:30 -04:00
Cory LaViska	479fff4b61	remove unsupported property; closes #1677 (#1689 )	2025-10-30 11:06:47 -04:00
Brian Talbot	9c7b341889	adding planned stretch goal-based components to sidebar.njk (#1682 )	2025-10-30 10:41:50 -04:00
Kelsey Jackson	d09973b571	updated sidebar (#1687 ) * updated sidebar * Update packages/webawesome/docs/_includes/sidebar.njk Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * fixed pr --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>	2025-10-30 09:22:39 -05:00
Cory LaViska	a03da137e3	nest tree item (#1686 )	2025-10-30 09:37:19 -04:00
Brian Talbot	d8b0447151	Docs: Adding CSS Selector Info to Components (#1679 ) * adding CSS selector info to component docs * adding Copy Button to custom states' CSS selectors in component docs	2025-10-29 17:25:50 -04:00
konnorrogers	6f0bd4e872	update versions.txt	2025-10-28 12:19:06 -04:00
konnorrogers	55973a7eff	update package-lock	2025-10-28 12:15:46 -04:00
konnorrogers	e9aa72cc87	Bump package.json version	2025-10-28 12:14:39 -04:00
konnorrogers	9716ecec41	Bump changelog	2025-10-28 12:13:59 -04:00
Brian Talbot	776b980ce5	🚀 Add Launch Announcement Banner (#1662 ) * adding decorative underline to utils.css * adding banner to base.njk * disabling sticky banner in layouts * adding logic to show/hide pageBanner * add changelog for `<wa-page>` fix in related Pro PR --------- Co-authored-by: lindsaym-fa <dev@lindsaym.design>	2025-10-28 11:07:08 -04:00
Kelsey Jackson	02f58d3c8b	Fix `<wa-card>` header and footer slot alignment (#1435 ) * fixes to the card component * linter fix * updated doc css * style touchup * docs touchup * remove docs.css change * add changelog (and sneak in missing Figma entry) --------- Co-authored-by: lindsaym-fa <dev@lindsaym.design>	2025-10-28 10:42:52 -04:00
Cory LaViska	fba18efad6	fix radio styles (#1669 )	2025-10-27 23:02:41 -04:00
Cory LaViska	4a7f9dfe00	Merge branch 'next' of https://github.com/shoelace-style/webawesome into next	2025-10-27 21:26:19 -04:00
Cory LaViska	1fbde40bab	fix links	2025-10-27 21:26:18 -04:00
Lindsay M	14bd0459df	update usage instructions (#1667 )	2025-10-27 21:19:48 -04:00
Brian Talbot	e4a4d2eb18	fixing page and Open Graph titles for Home view (#1666 ) * fixes the redundant 'Web Awesome \| Web Awesome' titles * moves logic to `.eleventy.js` * gracefully handles no titles/og titles with `Web Awesome`	2025-10-27 20:08:14 -04:00
Brian Talbot	a465f0348f	removing `App.flags.stripeEnabled` logic (#1657 )	2025-10-27 18:42:15 -04:00
Cory LaViska	5e1eba1751	Remove CDN URLs (#1661 ) * add data-version; remove data-cdn-url and its 11ty function * update installation doc with projects * update component importing instructions * update Customizing doc with projects * add project instructions for themes * add project instructions for palettes + make themes consistent --------- Co-authored-by: lindsaym-fa <dev@lindsaym.design>	2025-10-27 18:41:31 -04:00
Cory LaViska	00f79f3749	add missing type export	2025-10-27 18:22:48 -04:00
Cory LaViska	788804774f	fix event name in docs; fixes #1663 (#1665 )	2025-10-27 18:19:43 -04:00
Brian Talbot	986b8c4d99	Add Site + Open Graph Metadata (#1660 ) * adding site data to `.eleventy.js` * adding open graph metadata to `/eleventy.js` * adding Open Graph metadata to head.njk * adding default site Open Graph image * updating formatting for title metadata * addressing PR feedback	2025-10-27 18:17:01 -04:00
konnorrogers	d18d44eaa6	one more time...	2025-10-27 17:17:51 -04:00
konnorrogers	29422d196a	update vercel.sh for real	2025-10-27 17:16:47 -04:00
konnorrogers	d68351b8b0	fix vercel.sh	2025-10-27 17:14:08 -04:00
konnorrogers	0d2b5c7381	fix vercel.sh	2025-10-27 17:00:06 -04:00
Cory LaViska	c221bdd6fc	update esbuild; fix vercel maybe	2025-10-27 16:53:52 -04:00
Brian Talbot	a4b2fc7c13	Update App Icons + Favicon (#1659 ) * adding updated app-icon + favicon assets * adding PWA manifest.json to manage app icons * updating eleventyConfig to pass through manifest.json * updating head.njk to include update app-icon references/assets * removing unused webawesome logo + mark assets	2025-10-27 15:16:16 -04:00
Kelsey Jackson	887797e3b8	Kj/support page (#1532 )	2025-10-27 12:56:46 -05:00
Cory LaViska	246a64ffa5	Merge branch 'medmunds-patch-1' into next	2025-10-27 12:53:57 -04:00
Cory LaViska	ac5ae9e193	prettier	2025-10-27 12:53:44 -04:00
Cory LaViska	2a22696cc9	Merge branch 'patch-1' of https://github.com/medmunds/webawesome into medmunds-patch-1	2025-10-27 12:53:23 -04:00
Cory LaViska	85949f5502	Allow special [valid] characters in IDs (tooltip + popover) (#1649 ) * use getElementByID * allow valid chars in ids; fixes #1648	2025-10-27 12:51:04 -04:00
Cory LaViska	2e0d72ca92	make parts consistent; fixes #1646 (#1650 )	2025-10-27 12:50:43 -04:00
Cory LaViska	4c9aed87a0	Update CodePen CDN (#1658 ) * update path * update cdn to jsdelivr for public pens	2025-10-27 12:50:29 -04:00
Konnor Rogers	eb9bda5e28	update VERSIONS.txt with good versions (#1656 )	2025-10-24 15:00:17 -04:00
Cory LaViska	8d590d2597	use --wa-font-weight-code in native styles (#1653 )	2025-10-24 11:33:00 -04:00
Mike Edmunds	2ae0138d00	Avoid errors on earlier CustomStateSet API Protect WebAwesomeElement.customStates accessors from errors in browsers implementing the earlier revision of the CustomStateSet API. Resolves #1633.	2025-10-23 13:50:23 -07:00
				`@@ -0,0 +1 @@`
				<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>