@rooted-adapters/azure-static-webapp 1.0.0-alpha.0

package/LICENSE

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

package/dist/index.d.mts

@@ -0,0 +1,41 @@
+import { AdapterRoutes } from "@rooted/adapter";
+import { Plugin } from "vite";
+
+//#region src/index.d.mts
+/**
+ * Options for {@link azureStaticWebappAdapter}.
+ */
+type AzureStaticWebappAdapterOptions = {
+  /**
+   * Manual route list for projects that don't use `generateRouteManifest`.
+   * See {@link AdapterRoutes}.
+   */
+  routes?: AdapterRoutes;
+};
+/**
+ * Adapter for Azure Static Web Apps.
+ *
+ * Writes `staticwebapp.config.json` to the output directory with routing rules
+ * built from the route manifest and/or manual `routes` option:
+ * - Pre-rendered routes get explicit `200` entries so Azure serves their HTML directly.
+ * - Parameterized routes get wildcard rewrite entries (`:param` becomes `*`).
+ * - Everything else falls through to `navigationFallback` pointing at `404.html`.
+ *
+ * @example `vite.config.ts`
+ * ```ts
+ * import { rootedManifest } from '@rooted/application'
+ * import { generateRouteManifest } from '@rooted/router/manifest'
+ * import { azureStaticWebappAdapter } from '@rooted-adapters/azure-static-webapp'
+ *
+ * export default rootedManifest({
+ *   plugins: [
+ *     generateRouteManifest({ glob: './src/**\/_routes.mts', root: './src/_routes.g.mts' }),
+ *     azureStaticWebappAdapter(),
+ *   ],
+ * })
+ * ```
+ */
+declare function azureStaticWebappAdapter(options?: AzureStaticWebappAdapterOptions): Plugin;
+//#endregion
+export { AzureStaticWebappAdapterOptions, azureStaticWebappAdapter };
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC5tdHMiLCJuYW1lcyI6W10sInNvdXJjZXMiOlsiLi4vc3JjL2luZGV4Lm10cyJdLCJtYXBwaW5ncyI6Ijs7Ozs7O0FBV0E7S0FBWSwrQkFBQTs7OztBQStCWjtFQTFCQyxNQUFBLEdBQVMsYUFBQTtBQUFBOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7aUJBMEJNLHdCQUFBLENBQXlCLE9BQUEsR0FBVSwrQkFBQSxHQUFrQyxNQUFBIn0=

package/dist/index.mjs

@@ -0,0 +1,59 @@
+import { writeFile } from "node:fs/promises";
+import path from "node:path";
+import { staticAdapter } from "@rooted/adapter";
+//#region src/index.mts
+/**
+* Adapter for Azure Static Web Apps.
+*
+* Writes `staticwebapp.config.json` to the output directory with routing rules
+* built from the route manifest and/or manual `routes` option:
+* - Pre-rendered routes get explicit `200` entries so Azure serves their HTML directly.
+* - Parameterized routes get wildcard rewrite entries (`:param` becomes `*`).
+* - Everything else falls through to `navigationFallback` pointing at `404.html`.
+*
+* @example `vite.config.ts`
+* ```ts
+* import { rootedManifest } from '@rooted/application'
+* import { generateRouteManifest } from '@rooted/router/manifest'
+* import { azureStaticWebappAdapter } from '@rooted-adapters/azure-static-webapp'
+*
+* export default rootedManifest({
+*   plugins: [
+*     generateRouteManifest({ glob: './src/**\/_routes.mts', root: './src/_routes.g.mts' }),
+*     azureStaticWebappAdapter(),
+*   ],
+* })
+* ```
+*/
+function azureStaticWebappAdapter(options) {
+	return staticAdapter({
+		name: "rooted:azure-static-webapp",
+		routes: options?.routes,
+		async setup({ outputDirectory, resolvedRoutes }) {
+			const staticRoutes = resolvedRoutes.staticPaths.filter((p) => p.split("/").filter(Boolean).length > 0).map((p) => ({
+				route: p,
+				serve: `/${p.split("/").filter(Boolean).join("/")}/index.html`,
+				statusCode: 200
+			}));
+			const dynamicRoutes = resolvedRoutes.dynamicPatterns.map((p) => ({
+				route: toWildcard(p).replace(/\/$/, "") + "/*",
+				rewrite: "/404.html"
+			}));
+			const config = {
+				routes: [...staticRoutes, ...dynamicRoutes],
+				navigationFallback: {
+					rewrite: "/404.html",
+					exclude: ["/assets/*", "/*.{js,css,png,jpg,svg,ico,woff2,webmanifest}"]
+				}
+			};
+			await writeFile(path.join(outputDirectory, "staticwebapp.config.json"), JSON.stringify(config, void 0, 2), "utf8");
+		}
+	});
+}
+function toWildcard(pattern) {
+	return pattern.replace(/:[\w]+/g, "*");
+}
+//#endregion
+export { azureStaticWebappAdapter };
+
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXgubWpzIiwibmFtZXMiOltdLCJzb3VyY2VzIjpbIi4uL3NyYy9pbmRleC5tdHMiXSwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgd3JpdGVGaWxlIH0gZnJvbSAnbm9kZTpmcy9wcm9taXNlcydcbmltcG9ydCBwYXRoIGZyb20gJ25vZGU6cGF0aCdcblxuaW1wb3J0IHsgc3RhdGljQWRhcHRlciB9IGZyb20gJ0Byb290ZWQvYWRhcHRlcidcblxuaW1wb3J0IHR5cGUgeyBBZGFwdGVyUm91dGVzIH0gZnJvbSAnQHJvb3RlZC9hZGFwdGVyJ1xuaW1wb3J0IHR5cGUgeyBQbHVnaW4gfSBmcm9tICd2aXRlJ1xuXG4vKipcbiAqIE9wdGlvbnMgZm9yIHtAbGluayBhenVyZVN0YXRpY1dlYmFwcEFkYXB0ZXJ9LlxuICovXG5leHBvcnQgdHlwZSBBenVyZVN0YXRpY1dlYmFwcEFkYXB0ZXJPcHRpb25zID0ge1xuXHQvKipcblx0ICogTWFudWFsIHJvdXRlIGxpc3QgZm9yIHByb2plY3RzIHRoYXQgZG9uJ3QgdXNlIGBnZW5lcmF0ZVJvdXRlTWFuaWZlc3RgLlxuXHQgKiBTZWUge0BsaW5rIEFkYXB0ZXJSb3V0ZXN9LlxuXHQgKi9cblx0cm91dGVzPzogQWRhcHRlclJvdXRlc1xufVxuXG4vKipcbiAqIEFkYXB0ZXIgZm9yIEF6dXJlIFN0YXRpYyBXZWIgQXBwcy5cbiAqXG4gKiBXcml0ZXMgYHN0YXRpY3dlYmFwcC5jb25maWcuanNvbmAgdG8gdGhlIG91dHB1dCBkaXJlY3Rvcnkgd2l0aCByb3V0aW5nIHJ1bGVzXG4gKiBidWlsdCBmcm9tIHRoZSByb3V0ZSBtYW5pZmVzdCBhbmQvb3IgbWFudWFsIGByb3V0ZXNgIG9wdGlvbjpcbiAqIC0gUHJlLXJlbmRlcmVkIHJvdXRlcyBnZXQgZXhwbGljaXQgYDIwMGAgZW50cmllcyBzbyBBenVyZSBzZXJ2ZXMgdGhlaXIgSFRNTCBkaXJlY3RseS5cbiAqIC0gUGFyYW1ldGVyaXplZCByb3V0ZXMgZ2V0IHdpbGRjYXJkIHJld3JpdGUgZW50cmllcyAoYDpwYXJhbWAgYmVjb21lcyBgKmApLlxuICogLSBFdmVyeXRoaW5nIGVsc2UgZmFsbHMgdGhyb3VnaCB0byBgbmF2aWdhdGlvbkZhbGxiYWNrYCBwb2ludGluZyBhdCBgNDA0Lmh0bWxgLlxuICpcbiAqIEBleGFtcGxlIGB2aXRlLmNvbmZpZy50c2BcbiAqIGBgYHRzXG4gKiBpbXBvcnQgeyByb290ZWRNYW5pZmVzdCB9IGZyb20gJ0Byb290ZWQvYXBwbGljYXRpb24nXG4gKiBpbXBvcnQgeyBnZW5lcmF0ZVJvdXRlTWFuaWZlc3QgfSBmcm9tICdAcm9vdGVkL3JvdXRlci9tYW5pZmVzdCdcbiAqIGltcG9ydCB7IGF6dXJlU3RhdGljV2ViYXBwQWRhcHRlciB9IGZyb20gJ0Byb290ZWQtYWRhcHRlcnMvYXp1cmUtc3RhdGljLXdlYmFwcCdcbiAqXG4gKiBleHBvcnQgZGVmYXVsdCByb290ZWRNYW5pZmVzdCh7XG4gKiAgIHBsdWdpbnM6IFtcbiAqICAgICBnZW5lcmF0ZVJvdXRlTWFuaWZlc3QoeyBnbG9iOiAnLi9zcmMvKipcXC9fcm91dGVzLm10cycsIHJvb3Q6ICcuL3NyYy9fcm91dGVzLmcubXRzJyB9KSxcbiAqICAgICBhenVyZVN0YXRpY1dlYmFwcEFkYXB0ZXIoKSxcbiAqICAgXSxcbiAqIH0pXG4gKiBgYGBcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGF6dXJlU3RhdGljV2ViYXBwQWRhcHRlcihvcHRpb25zPzogQXp1cmVTdGF0aWNXZWJhcHBBZGFwdGVyT3B0aW9ucyk6IFBsdWdpbiB7XG5cdHJldHVybiBzdGF0aWNBZGFwdGVyKHtcblx0XHRuYW1lOiAncm9vdGVkOmF6dXJlLXN0YXRpYy13ZWJhcHAnLFxuXHRcdHJvdXRlczogb3B0aW9ucz8ucm91dGVzLFxuXHRcdGFzeW5jIHNldHVwKHsgb3V0cHV0RGlyZWN0b3J5LCByZXNvbHZlZFJvdXRlcyB9KSB7XG5cdFx0XHRjb25zdCBzdGF0aWNSb3V0ZXM6IEF6dXJlUm91dGVbXSA9IHJlc29sdmVkUm91dGVzLnN0YXRpY1BhdGhzXG5cdFx0XHRcdC5maWx0ZXIocCA9PiBwLnNwbGl0KCcvJykuZmlsdGVyKEJvb2xlYW4pLmxlbmd0aCA+IDApXG5cdFx0XHRcdC5tYXAocCA9PiAoe1xuXHRcdFx0XHRcdHJvdXRlOiBwLFxuXHRcdFx0XHRcdHNlcnZlOiBgLyR7cC5zcGxpdCgnLycpLmZpbHRlcihCb29sZWFuKS5qb2luKCcvJyl9L2luZGV4Lmh0bWxgLFxuXHRcdFx0XHRcdHN0YXR1c0NvZGU6IDIwMCBhcyBjb25zdCxcblx0XHRcdFx0fSkpXG5cblx0XHRcdGNvbnN0IGR5bmFtaWNSb3V0ZXM6IEF6dXJlUm91dGVbXSA9IHJlc29sdmVkUm91dGVzLmR5bmFtaWNQYXR0ZXJuc1xuXHRcdFx0XHQubWFwKHAgPT4gKHsgcm91dGU6IHRvV2lsZGNhcmQocCkucmVwbGFjZSgvXFwvJC8sICcnKSArICcvKicsIHJld3JpdGU6ICcvNDA0Lmh0bWwnIH0pKVxuXG5cdFx0XHRjb25zdCBjb25maWc6IEF6dXJlU3RhdGljV2ViQXBwQ29uZmlnID0ge1xuXHRcdFx0XHRyb3V0ZXM6IFsuLi5zdGF0aWNSb3V0ZXMsIC4uLmR5bmFtaWNSb3V0ZXNdLFxuXHRcdFx0XHRuYXZpZ2F0aW9uRmFsbGJhY2s6IHtcblx0XHRcdFx0XHRyZXdyaXRlOiAnLzQwNC5odG1sJyxcblx0XHRcdFx0XHRleGNsdWRlOiBbJy9hc3NldHMvKicsICcvKi57anMsY3NzLHBuZyxqcGcsc3ZnLGljbyx3b2ZmMix3ZWJtYW5pZmVzdH0nXSxcblx0XHRcdFx0fSxcblx0XHRcdH1cblxuXHRcdFx0YXdhaXQgd3JpdGVGaWxlKFxuXHRcdFx0XHRwYXRoLmpvaW4ob3V0cHV0RGlyZWN0b3J5LCAnc3RhdGljd2ViYXBwLmNvbmZpZy5qc29uJyksXG5cdFx0XHRcdEpTT04uc3RyaW5naWZ5KGNvbmZpZywgdW5kZWZpbmVkLCAyKSxcblx0XHRcdFx0J3V0ZjgnLFxuXHRcdFx0KVxuXHRcdH0sXG5cdH0pXG59XG5cbnR5cGUgQXp1cmVSb3V0ZSA9XG5cdHwgeyByb3V0ZTogc3RyaW5nOyBzZXJ2ZTogc3RyaW5nOyBzdGF0dXNDb2RlOiAyMDAgfVxuXHR8IHsgcm91dGU6IHN0cmluZzsgcmV3cml0ZTogc3RyaW5nIH1cblxudHlwZSBBenVyZVN0YXRpY1dlYkFwcENvbmZpZyA9IHtcblx0cm91dGVzOiBBenVyZVJvdXRlW11cblx0bmF2aWdhdGlvbkZhbGxiYWNrOiB7IHJld3JpdGU6IHN0cmluZzsgZXhjbHVkZTogc3RyaW5nW10gfVxufVxuXG4vLyBDb252ZXJ0cyA6cGFyYW0gdG9rZW5zIHRvIEF6dXJlIHdpbGRjYXJkICgqKSBzZWdtZW50cy5cbmZ1bmN0aW9uIHRvV2lsZGNhcmQocGF0dGVybjogc3RyaW5nKTogc3RyaW5nIHtcblx0cmV0dXJuIHBhdHRlcm4ucmVwbGFjZSgvOltcXHddKy9nLCAnKicpXG59XG4iXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQTBDQSxTQUFnQix5QkFBeUIsU0FBbUQ7Q0FDM0YsT0FBTyxjQUFjO0VBQ3BCLE1BQU07RUFDTixRQUFRLFNBQVM7RUFDakIsTUFBTSxNQUFNLEVBQUUsaUJBQWlCLGtCQUFrQjtHQUNoRCxNQUFNLGVBQTZCLGVBQWUsWUFDaEQsUUFBTyxNQUFLLEVBQUUsTUFBTSxJQUFJLENBQUMsT0FBTyxRQUFRLENBQUMsU0FBUyxFQUFFLENBQ3BELEtBQUksT0FBTTtJQUNWLE9BQU87SUFDUCxPQUFPLElBQUksRUFBRSxNQUFNLElBQUksQ0FBQyxPQUFPLFFBQVEsQ0FBQyxLQUFLLElBQUksQ0FBQztJQUNsRCxZQUFZO0lBQ1osRUFBRTtHQUVKLE1BQU0sZ0JBQThCLGVBQWUsZ0JBQ2pELEtBQUksT0FBTTtJQUFFLE9BQU8sV0FBVyxFQUFFLENBQUMsUUFBUSxPQUFPLEdBQUcsR0FBRztJQUFNLFNBQVM7SUFBYSxFQUFFO0dBRXRGLE1BQU0sU0FBa0M7SUFDdkMsUUFBUSxDQUFDLEdBQUcsY0FBYyxHQUFHLGNBQWM7SUFDM0Msb0JBQW9CO0tBQ25CLFNBQVM7S0FDVCxTQUFTLENBQUMsYUFBYSxnREFBZ0Q7S0FDdkU7SUFDRDtHQUVELE1BQU0sVUFDTCxLQUFLLEtBQUssaUJBQWlCLDJCQUEyQixFQUN0RCxLQUFLLFVBQVUsUUFBUSxLQUFBLEdBQVcsRUFBRSxFQUNwQyxPQUNBOztFQUVGLENBQUM7O0FBYUgsU0FBUyxXQUFXLFNBQXlCO0NBQzVDLE9BQU8sUUFBUSxRQUFRLFdBQVcsSUFBSSJ9

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@rooted-adapters/azure-static-webapp",
+  "version": "1.0.0-alpha.0",
+  "description": "Adapter for Azure Static Web Apps",
+  "keywords": [
+    "web-components",
+    "typescript",
+    "rooted"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Marvin-Brouwer/rooted.git",
+    "directory": "packages/adapters/azure-static-webapp"
+  },
+  "homepage": "https://github.com/Marvin-Brouwer/rooted#readme",
+  "bugs": "https://github.com/Marvin-Brouwer/rooted/issues",
+  "sideEffects": false,
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public",
+    "provenance": true
+  },
+  "files": [
+    "dist",
+    "readme.md"
+  ],
+  "engines": {
+    "node": ">=22.0.0",
+    "pnpm": ">=10.0.0"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.mts"
+    }
+  },
+  "peerDependencies": {
+    "vite": ">= 8.0.1",
+    "@rooted/adapter": "^1.0.0-alpha.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.2",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.3",
+    "vite": "^8.0.12",
+    "@rooted/tsdown": "^0.1.0",
+    "@rooted/adapter": "^1.0.0-alpha.0",
+    "@rooted/development": "0.1.0"
+  },
+  "scripts": {
+    "build": "pnpm build:ci",
+    "build:dev": "pnpm build:ci",
+    "build:ci": "tsdown",
+    "watch": "tsdown --watch --no-clean",
+    "clean": "rm -rf dist"
+  }
+}

package/readme.md

@@ -0,0 +1,28 @@
+# [`@rooted-adapters/azure-static-webapp`](https://www.npmjs.com/package/@rooted-adapters/azure-static-webapp)
+
+Deployment adapter for Azure Static Web Apps. Part of the [`@rooted/*`](https://github.com/Marvin-Brouwer/rooted#rooted) framework.
+
+Writes `staticwebapp.config.json` to the output directory with explicit route rules for pre-rendered paths and parameterized routes.
+
+> [!IMPORTANT]
+> This package is still in alpha.
+
+```sh
+pnpm add -D @rooted-adapters/azure-static-webapp
+```
+
+```ts
+// vite.config.mts
+import { rootedManifest } from '@rooted/application'
+import { generateRouteManifest } from '@rooted/router/manifest'
+import { azureStaticWebappAdapter } from '@rooted-adapters/azure-static-webapp'
+
+export default rootedManifest({
+  plugins: [
+    generateRouteManifest({ glob: './src/**/_routes.mts', routeManifestPath: './src/_routes.g.mts' }),
+    azureStaticWebappAdapter(),
+  ],
+})
+```
+
+More in the [adapters guide](https://github.com/Marvin-Brouwer/rooted/blob/main/docs/guide/adapters.md).