@inkandswitch/patchwork 0.0.1

package/src/vite/patchwork-plugin.ts

@@ -0,0 +1,67 @@
+import type { Plugin, ServerOptions, PreviewOptions, BuildOptions } from "vite";
+
+import { importmap } from "./importmap-plugin.js";
+import { serviceworker } from "./service-worker-plugin.js";
+import { configPlugin, wasm } from "./config-plugin.js";
+import { iconsPlugin } from "./icons.js";
+import { htmlPlugin } from "./html-plugin.js";
+import { manifestPlugin } from "./manifest-plugin.js";
+import { netlifyPlugin } from "./netlify-plugin.js";
+import type { PatchworkSiteOptions } from "../site-kit/options.js";
+
+/**
+ * The patchwork vite plugin. A site's vite.config.ts can shrink down to
+ * `plugins: [patchwork({...})]` plus a single source icon file — this plugin
+ * owns the wasm plugin, the importmap/service-worker emission, the generated
+ * index.html/manifest.webmanifest/Netlify _headers+_redirects, the site's
+ * icon set, and vite's server/preview/worker/build/define config.
+ *
+ * Each generated piece is switched off individually by passing `false` for
+ * its option (`html: false`, `manifest: false`, `netlify: false`,
+ * `icons: false`, `server: false`, `preview: false`, `worker: false`).
+ *
+ * `server`/`preview`/`worker`/`build`/`define` are owned by this plugin's
+ * `config()` hook and driven entirely by these options — don't also set them
+ * in the site's own `defineConfig({...})` alongside `patchwork()`, since
+ * Vite's plugin-config merge order doesn't guarantee which one wins.
+ *
+ * Most of what this plugin does — icon rendering, and building the
+ * index.html/manifest.webmanifest/Netlify _headers content — has no vite
+ * dependency at all; see `../site-kit/index.ts` for those pieces reused by
+ * a different bundler adapter.
+ */
+export default function patchwork(options?: PatchworkVitePluginOptions) {
+  return [
+    wasm(),
+    configPlugin(options),
+    iconsPlugin(options),
+    htmlPlugin(options),
+    manifestPlugin(options),
+    netlifyPlugin(options),
+    importmap(options),
+    serviceworker(),
+  ].filter((plugin): plugin is Plugin => plugin != null);
+}
+
+type Imports = { [name: string]: string };
+export type ImportMap = {
+  imports: Imports;
+  scopes?: { [scope: string]: Imports };
+};
+
+export type {
+  PatchworkSiteOptions,
+  PatchworkIconsOptions,
+  PatchworkHtmlOptions,
+  PatchworkNetlifyOptions,
+  PatchworkSyncServersOptions,
+} from "../site-kit/options.js";
+
+export interface PatchworkVitePluginOptions extends PatchworkSiteOptions {
+  importmap?: ImportMap;
+
+  server?: false | ServerOptions;
+  preview?: false | PreviewOptions;
+  worker?: false | { format?: "es" | "iife" };
+  build?: BuildOptions;
+}

package/src/vite/service-worker-plugin.ts

@@ -0,0 +1,54 @@
+import type { Plugin } from "vite";
+import { fileURLToPath } from "node:url";
+import { builtins } from "./importmap-plugin.js";
+
+// Anchor resolution at this file (inside @inkandswitch/patchwork's own
+// installed directory) rather than the site root — these worker specifiers
+// are @inkandswitch/patchwork-bootloader's own exports, a transitive
+// dependency of the site under strict pnpm, not resolvable from the site's
+// own node_modules by bare specifier.
+const self = fileURLToPath(import.meta.url);
+
+// The service worker and the automerge shared worker are emitted as their
+// own chunks. Their heavy imports are marked external and resolved to
+// /packages/... URLs (both workers are created with type:"module", so the
+// browser fetches those as regular network requests).
+const workers = [
+  {
+    specifier: "@inkandswitch/patchwork-bootloader/service-worker",
+    fileName: "service-worker.js",
+  },
+  {
+    specifier: "@inkandswitch/patchwork-bootloader/automerge-worker",
+    fileName: "automerge-worker.js",
+  },
+  {
+    specifier: "@inkandswitch/patchwork-bootloader/module-loader-worker",
+    fileName: "module-loader-worker.js",
+  },
+];
+
+export function serviceworker(): Plugin {
+  const entryIds = new Set<string>();
+
+  return {
+    name: "@patchwork/service-worker",
+    enforce: "pre",
+    async buildStart() {
+      for (const { specifier, fileName } of workers) {
+        const resolved = await this.resolve(specifier, self);
+        entryIds.add(resolved!.id);
+        this.emitFile({
+          type: "chunk",
+          id: resolved!.id,
+          fileName,
+        });
+      }
+    },
+    resolveId(source, importer) {
+      if (importer && entryIds.has(importer) && source in builtins) {
+        return { id: builtins[source], external: true };
+      }
+    },
+  };
+}

package/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "esnext",
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "outDir": "dist",
+    "declaration": true,
+    "lib": ["esnext", "dom"],
+    "strict": true,
+    "skipLibCheck": true,
+    "isolatedModules": true
+  },
+  "include": ["src"]
+}