@freqhole/playlistz 0.0.1

package/build-zip-bundle-lib.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+// builds the ./zip-bundle export as a pure ESM library.
+// uses esbuild (already a dep via vite) - no extra tooling needed.
+// output: dist/zip-bundle/index.js + dist/zip-bundle/index.d.ts (via tsc)
+
+/* global console, process */
+import { build } from "esbuild";
+import { execSync } from "child_process";
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const outDir = path.resolve(__dirname, "dist/zip-bundle");
+if (fs.existsSync(outDir)) {
+    fs.rmSync(outDir, { recursive: true, force: true });
+}
+fs.mkdirSync(outDir, { recursive: true });
+
+console.log("building dist/zip-bundle/index.js...");
+
+await build({
+    entryPoints: [path.resolve(__dirname, "src/zip-bundle/index.ts")],
+    bundle: true,
+    format: "esm",
+    platform: "neutral",
+    outfile: path.resolve(outDir, "index.js"),
+    external: ["jszip", "zod"],
+    sourcemap: true,
+    minify: false,
+});
+
+console.log("generating dist/zip-bundle type declarations...");
+
+execSync(
+    "npx tsc --declaration --emitDeclarationOnly --noEmit false " +
+    "--moduleResolution bundler --module esnext " +
+    "--outDir dist/zip-bundle " +
+    "src/zip-bundle/index.ts",
+    { cwd: __dirname, stdio: "inherit" },
+);
+
+console.log("done: dist/zip-bundle/");

package/config/playwright.config.ts

@@ -0,0 +1,47 @@
+import { defineConfig, devices } from "@playwright/test";
+import { fileURLToPath } from "node:url";
+
+// e2e tests for playlistz. run with `npm run test:e2e`.
+// the dev server is started automatically on a dedicated port.
+export default defineConfig({
+  testDir: "../e2e",
+  fullyParallel: false,
+  forbidOnly: !!process.env.CI,
+  retries: process.env.CI ? 2 : 0,
+  // single worker: tests share the dev server origin's indexeddb state,
+  // and each test resets storage in beforeEach
+  workers: 1,
+  reporter: [["list"]],
+  // default per-test timeout: 30s for normal tests.
+  // tests that need more (two-browser p2p, standalone build) use test.setTimeout()
+  timeout: 30_000,
+  expect: { timeout: 5000 },
+  use: {
+    baseURL: "http://localhost:5917",
+    trace: "on-first-retry",
+    viewport: { width: 1400, height: 900 },
+    // action timeout: how long to wait for a single locator action (click, fill, etc.)
+    actionTimeout: 10_000,
+    // navigation timeout: how long page.goto / page.waitForURL waits
+    navigationTimeout: 15_000,
+  },
+  projects: [
+    {
+      name: "chromium",
+      use: {
+        ...devices["Desktop Chrome"],
+        launchOptions: {
+          // allow audio playback without a user gesture in headless runs
+          args: ["--autoplay-policy=no-user-gesture-required"],
+        },
+      },
+    },
+  ],
+  webServer: {
+    command: "npx vite --config config/vite.config.ts --port 5917",
+    // cwd defaults to the config file's directory; run from the repo root
+    cwd: fileURLToPath(new URL("..", import.meta.url)),
+    port: 5917,
+    reuseExistingServer: !process.env.CI,
+  },
+});

package/config/vite.config.ts

@@ -0,0 +1,44 @@
+import { defineConfig } from "vite";
+import solid from "vite-plugin-solid";
+import tailwindcss from "@tailwindcss/vite";
+import wasm from "vite-plugin-wasm";
+import topLevelAwait from "vite-plugin-top-level-await";
+import fs from "node:fs";
+import path from "node:path";
+
+// serve built dist/ assets (e.g. freqhole-playlistz.js) during dev
+function serveDistAssets() {
+  return {
+    name: "serve-dist-assets",
+    configureServer(server: import("vite").ViteDevServer) {
+      server.middlewares.use((req, res, next) => {
+        const url = req.url?.split("?")[0] ?? "/";
+        const distPath = path.resolve(__dirname, "../dist", url.replace(/^\//, ""));
+        if (fs.existsSync(distPath) && fs.statSync(distPath).isFile()) {
+          const ext = path.extname(distPath);
+          const mime = ext === ".js" || ext === ".mjs" ? "application/javascript"
+            : ext === ".map" ? "application/json"
+            : "application/octet-stream";
+          res.setHeader("Content-Type", mime);
+          fs.createReadStream(distPath).pipe(res);
+          return;
+        }
+        next();
+      });
+    },
+  };
+}
+
+export default defineConfig({
+  plugins: [wasm(), topLevelAwait(), solid(), tailwindcss(), serveDistAssets()],
+  server: {
+    port: 3000,
+    host: true,
+    open: true,
+  },
+  build: {
+    target: "esnext",
+    minify: true,
+    sourcemap: true,
+  },
+});

package/config/vitest.config.ts

@@ -0,0 +1,39 @@
+import { defineConfig } from "vitest/config";
+import solid from "vite-plugin-solid";
+import wasm from "vite-plugin-wasm";
+import topLevelAwait from "vite-plugin-top-level-await";
+
+export default defineConfig({
+  plugins: [wasm(), topLevelAwait(), solid()],
+  resolve: {
+    // use browser build of solid-js in tests so reactive signals/memos work correctly
+    conditions: ["browser", "solid", "development"],
+  },
+  test: {
+    globals: true,
+    environment: "jsdom",
+    include: ["src/**/*.test.ts", "src/**/*.test.tsx", "src/**/*.spec.ts"],
+    setupFiles: ["src/test-setup.ts"],
+    // silence app log output during tests - only errors surface
+    env: {
+      VITE_LOG_LEVEL: "error",
+    },
+    coverage: {
+      provider: "v8",
+      reporter: ["text", "lcov", "html"],
+      include: ["src/**/*.ts", "src/**/*.tsx"],
+      exclude: [
+        "src/**/*.test.ts",
+        "src/**/*.test.tsx",
+        "src/**/*.spec.ts",
+        "src/test-setup.ts",
+      ],
+      thresholds: {
+        branches: 70,
+        functions: 70,
+        lines: 70,
+        statements: 70,
+      },
+    },
+  },
+});