refactor: Replace Rollup with Vite (#2656)

This is a high risk change: every byte the card ships is emitted by a different bundler, minified by a different minifier, and every stylesheet is compiled by a different sass. The intent is that the card's behaviour is unchanged. **Significant development win**: Build time drops from 24s to 1.1s 🎉 Also adds a test suite ('dist') that runs against the built bundle.
2026-08-04 15:00:13 -07:00
parent 06bcfd58ba
commit 80ec92e3b2
105 changed files with 1273 additions and 1719 deletions
@@ -0,0 +1,57 @@
+/**
+ * Emits the files a dashboard resource can name, each a re-export of the hashed
+ * chunk holding the actual card.
+ *
+ * HACS registers the card as a dashboard resource with a `hacstag` query
+ * parameter on the URL, and the browser treats a different URL as a different
+ * file. Were a chunk to import the untagged name, the card would be fetched and
+ * run a second time, and defining its elements twice will throw an error.
+ * Keeping the card itself in a hashed chunk that nothing outside can name is
+ * what prevents that, and the check below is what keeps it true.
+ *
+ * @type {(options: { publicFileNames: string[] }) => import('vite').Plugin}
+ */
+export const facadeEntry = ({ publicFileNames }) => ({
+  name: 'facade-entry',
+
+  generateBundle(_options, bundle) {
+    const entries = Object.values(bundle).filter(
+      (item) => item.type === 'chunk' && item.isEntry,
+    );
+    if (entries.length !== 1) {
+      throw new Error(`Expected exactly one entry chunk, found ${entries.length}`);
+    }
+    const [entry] = entries;
+
+    // A public name already in the bundle means the card was emitted under it
+    // rather than into a hashed chunk, which is the arrangement this plugin
+    // exists to prevent.
+    const alreadyEmitted = publicFileNames.filter((name) => name in bundle);
+    if (alreadyEmitted.length) {
+      throw new Error(
+        `The build should have emitted these under hashed names: ${alreadyEmitted.join(', ')}`,
+      );
+    }
+
+    const offenders = Object.values(bundle).flatMap((item) =>
+      item.type === 'chunk'
+        ? [...item.imports, ...item.dynamicImports]
+            .filter((imported) => publicFileNames.includes(imported))
+            .map((imported) => `${item.fileName} -> ${imported}`)
+        : [],
+    );
+    if (offenders.length) {
+      throw new Error(
+        `Chunks should not import a public entry point: ${offenders.join(', ')}`,
+      );
+    }
+
+    for (const fileName of publicFileNames) {
+      this.emitFile({
+        type: 'asset',
+        fileName,
+        source: `export * from './${entry.fileName}';\n`,
+      });
+    }
+  },
+});