npm - @freqhole/playlistz - Versions diffs - 0.0.1 - Mend

@freqhole/playlistz 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (180) hide show

package/.changeset/config.json +11 -0
package/.changeset/nice-wolves-thank.md +5 -0
package/.freqhole-versions.json +4 -0
package/.github/copilot-instructions.md +201 -0
package/.github/workflows/changesets.yml +50 -0
package/.github/workflows/npm-publish.yml +124 -0
package/.github/workflows/pr-checks.yml +103 -0
package/README.md +30 -0
package/build-component.js +141 -0
package/build-zip-bundle-lib.js +44 -0
package/config/playwright.config.ts +47 -0
package/config/vite.config.ts +44 -0
package/config/vitest.config.ts +39 -0
package/dist/assets/automerge_wasm_bg-Cik4BF9l.wasm +0 -0
package/dist/assets/index-CbOXzGiA.js +216 -0
package/dist/assets/index-CbOXzGiA.js.map +1 -0
package/dist/assets/index-TvJ6RFpy.css +1 -0
package/dist/assets/midden-DceCrT_L.js +2 -0
package/dist/assets/midden-DceCrT_L.js.map +1 -0
package/dist/assets/midden_bg-BLhfGIU-.wasm +0 -0
package/dist/index.html +55 -0
package/dist/sw.js +134 -0
package/docs/AUTOMERGE_P2P_PLAN.md +233 -0
package/docs/COLLABORATIVE_SHARING_PLAN.md +188 -0
package/docs/E2E_TESTID_PLAN.md +234 -0
package/docs/IROH_P2P_PLAN.md +302 -0
package/docs/ROADMAP.md +695 -0
package/docs/TODO.md +167 -0
package/docs/bundle-embedding-plan.md +134 -0
package/docs/standalone-refactor.md +184 -0
package/e2e/all-playlists.spec.ts +220 -0
package/e2e/audio-player.spec.ts +226 -0
package/e2e/collaborative-features.spec.ts +229 -0
package/e2e/contexts.ts +238 -0
package/e2e/edit-panel.spec.ts +87 -0
package/e2e/fixtures/bare-glitch-1s.m4a +0 -0
package/e2e/fixtures/bare-glitch-1s.mp3 +0 -0
package/e2e/fixtures/bare-glitch-1s.ogg +0 -0
package/e2e/fixtures/chord-stack-3s.wav +0 -0
package/e2e/fixtures/cover-anim.gif +0 -0
package/e2e/fixtures/cover-blue.png +0 -0
package/e2e/fixtures/cover-checkers.png +0 -0
package/e2e/fixtures/cover-gradient.jpg +0 -0
package/e2e/fixtures/cover-mono.gif +0 -0
package/e2e/fixtures/cover-noise.png +0 -0
package/e2e/fixtures/cover-plasma.webp +0 -0
package/e2e/fixtures/cover-portrait.jpg +0 -0
package/e2e/fixtures/cover-red.png +0 -0
package/e2e/fixtures/cover-thumb.jpg +0 -0
package/e2e/fixtures/cover-wide.webp +0 -0
package/e2e/fixtures/generate.mjs +257 -0
package/e2e/fixtures/long-drone-90s.mp3 +0 -0
package/e2e/fixtures/noisy-binaural-8s.mp3 +0 -0
package/e2e/fixtures/tagged-a3-4s.m4a +0 -0
package/e2e/fixtures/tagged-a3-4s.mp3 +0 -0
package/e2e/fixtures/tagged-a3-4s.ogg +0 -0
package/e2e/fixtures/tagged-c5-3s.m4a +0 -0
package/e2e/fixtures/tagged-c5-3s.mp3 +0 -0
package/e2e/fixtures/tagged-c5-3s.ogg +0 -0
package/e2e/fixtures/tagged-f4-6s.m4a +0 -0
package/e2e/fixtures/tagged-f4-6s.mp3 +0 -0
package/e2e/fixtures/tagged-f4-6s.ogg +0 -0
package/e2e/fixtures/tone-220hz-10s.wav +0 -0
package/e2e/fixtures/tone-440hz-2s.wav +0 -0
package/e2e/fixtures/tone-880hz-5s.wav +0 -0
package/e2e/fixtures/tone-stereo-3s.wav +0 -0
package/e2e/fixtures/user-provided/README.md +1 -0
package/e2e/helpers/app.ts +143 -0
package/e2e/helpers/hooks.ts +133 -0
package/e2e/helpers/index.ts +12 -0
package/e2e/helpers/media.ts +125 -0
package/e2e/helpers.ts +10 -0
package/e2e/p2p-collaboration.spec.ts +356 -0
package/e2e/p2p-multi-peer.spec.ts +723 -0
package/e2e/p2p-states.spec.ts +302 -0
package/e2e/playback.spec.ts +56 -0
package/e2e/playlist-crud.spec.ts +126 -0
package/e2e/share-link-autoplay.spec.ts +129 -0
package/e2e/sharing-access.spec.ts +205 -0
package/e2e/sharing.spec.ts +195 -0
package/e2e/song-cache-state.spec.ts +202 -0
package/e2e/zip-bundle.spec.ts +855 -0
package/eslint.config.js +114 -0
package/index.html +54 -0
package/package.json +119 -0
package/public/sw.js +134 -0
package/scripts/use-local.mjs +37 -0
package/scripts/use-published.mjs +37 -0
package/src/App.tsx +9 -0
package/src/cli/check.ts +164 -0
package/src/cli/generate.ts +184 -0
package/src/cli/http.ts +88 -0
package/src/cli/index.ts +65 -0
package/src/cli/init.ts +18 -0
package/src/components/AllPlaylistsPanel.tsx +713 -0
package/src/components/AudioPlayer.tsx +122 -0
package/src/components/MarqueeText.tsx +101 -0
package/src/components/PlaylistCoverModal.tsx +519 -0
package/src/components/PlaylistEditPanel.tsx +803 -0
package/src/components/PlaylistSharePanel.tsx +1020 -0
package/src/components/ShareLinkKnockPanel.tsx +144 -0
package/src/components/SharePanel.tsx +584 -0
package/src/components/SongEditModal.tsx +453 -0
package/src/components/SongEditPanel.tsx +578 -0
package/src/components/SongRow.tsx +689 -0
package/src/components/index.tsx +494 -0
package/src/components/playlist/index.tsx +1203 -0
package/src/context/PlaylistzContext.tsx +74 -0
package/src/dev-hooks.ts +35 -0
package/src/hooks/createDocIndexQuery.ts +53 -0
package/src/hooks/createDocStore.test.ts +303 -0
package/src/hooks/createDocStore.ts +90 -0
package/src/hooks/useDragAndDrop.test.ts +474 -0
package/src/hooks/useDragAndDrop.ts +400 -0
package/src/hooks/useImageModal.test.ts +174 -0
package/src/hooks/useImageModal.ts +201 -0
package/src/hooks/usePlaylistManager.test.ts +453 -0
package/src/hooks/usePlaylistManager.ts +685 -0
package/src/hooks/usePlaylistsQuery.test.tsx +120 -0
package/src/hooks/usePlaylistsQuery.ts +44 -0
package/src/hooks/useSongState.test.ts +236 -0
package/src/hooks/useSongState.ts +114 -0
package/src/hooks/useUIState.ts +71 -0
package/src/index.tsx +18 -0
package/src/services/audioService.dev.ts +22 -0
package/src/services/audioService.test.ts +1226 -0
package/src/services/audioService.ts +1395 -0
package/src/services/automergeRepo.test.ts +269 -0
package/src/services/automergeRepo.ts +226 -0
package/src/services/blobTransferService.dev.ts +119 -0
package/src/services/blobTransferService.test.ts +441 -0
package/src/services/blobTransferService.ts +702 -0
package/src/services/docIndexService.test.ts +179 -0
package/src/services/docIndexService.ts +118 -0
package/src/services/fileProcessingService.test.ts +554 -0
package/src/services/fileProcessingService.ts +239 -0
package/src/services/imageService.test.ts +701 -0
package/src/services/imageService.ts +365 -0
package/src/services/indexedDBService.integration.test.ts +104 -0
package/src/services/indexedDBService.test.ts +202 -0
package/src/services/indexedDBService.ts +436 -0
package/src/services/offlineService.test.ts +661 -0
package/src/services/offlineService.ts +382 -0
package/src/services/p2pService.test.ts +305 -0
package/src/services/p2pService.ts +344 -0
package/src/services/playlistDocService.test.ts +448 -0
package/src/services/playlistDocService.ts +707 -0
package/src/services/playlistDownloadService.test.ts +674 -0
package/src/services/playlistDownloadService.ts +389 -0
package/src/services/sharingService.test.ts +812 -0
package/src/services/sharingService.ts +1073 -0
package/src/services/sharingState.ts +161 -0
package/src/services/songReactivity.test.ts +620 -0
package/src/services/songReactivity.ts +145 -0
package/src/services/standaloneService.test.ts +1025 -0
package/src/services/standaloneService.ts +588 -0
package/src/services/streamingAudioService.test.ts +275 -0
package/src/services/streamingAudioService.ts +166 -0
package/src/styles.css +428 -0
package/src/test-setup.ts +547 -0
package/src/types/global.d.ts +40 -0
package/src/types/playlist.ts +99 -0
package/src/utils/hashUtils.ts +41 -0
package/src/utils/log.ts +97 -0
package/src/utils/m3u.test.ts +172 -0
package/src/utils/m3u.ts +136 -0
package/src/utils/mockData.ts +166 -0
package/src/utils/standaloneTemplates.test.ts +175 -0
package/src/utils/standaloneTemplates.ts +83 -0
package/src/utils/swTemplate.ts +84 -0
package/src/utils/timeUtils.ts +166 -0
package/src/utils/typeGuards.ts +171 -0
package/src/web-component.tsx +98 -0
package/src/zip-bundle/index.ts +7 -0
package/src/zip-bundle/m3u.ts +45 -0
package/src/zip-bundle/types.ts +50 -0
package/src/zip-bundle/utils.ts +33 -0
package/src/zip-bundle/zipBuilder.ts +309 -0
package/tailwind.config.js +55 -0
package/tsconfig.json +43 -0

package/eslint.config.js ADDED Viewed

@@ -0,0 +1,114 @@
+import js from "@eslint/js";
+import tseslint from "@typescript-eslint/eslint-plugin";
+import tsparser from "@typescript-eslint/parser";
+import prettier from "eslint-plugin-prettier";
+import prettierConfig from "eslint-config-prettier";
+import solidPlugin from "eslint-plugin-solid";
+import globals from "globals";
+const baseConfig = {
+  languageOptions: {
+    parser: tsparser,
+    ecmaVersion: 2020,
+    sourceType: "module",
+  },
+  plugins: {
+    "@typescript-eslint": tseslint,
+    prettier: prettier,
+  },
+  rules: {
+    ...tseslint.configs.recommended.rules,
+    ...prettierConfig.rules,
+    "prettier/prettier": "error",
+    "@typescript-eslint/no-unused-vars": [
+      "error",
+      {
+        argsIgnorePattern: "^_",
+        varsIgnorePattern: "^_",
+        caughtErrorsIgnorePattern: "^_",
+      },
+    ],
+    "@typescript-eslint/explicit-function-return-type": "off",
+    "@typescript-eslint/no-explicit-any": "error",
+    "no-undef": "off",
+    "no-empty": ["error", { allowEmptyCatch: true }],
+  },
+};
+export default [
+  js.configs.recommended,
+  // TypeScript files
+  {
+    files: ["src/**/*.ts"],
+    ...baseConfig,
+    languageOptions: {
+      ...baseConfig.languageOptions,
+      globals: {
+        ...globals.browser,
+        ...globals.node,
+        vi: "readonly",
+      },
+    },
+  },
+  // TypeScript + JSX files
+  {
+    files: ["src/**/*.tsx"],
+    ...baseConfig,
+    languageOptions: {
+      ...baseConfig.languageOptions,
+      parserOptions: {
+        ecmaFeatures: { jsx: true },
+      },
+      globals: {
+        ...globals.browser,
+        vi: "readonly",
+      },
+    },
+    plugins: {
+      ...baseConfig.plugins,
+      solid: solidPlugin,
+    },
+    rules: {
+      ...baseConfig.rules,
+      ...solidPlugin.configs.recommended.rules,
+    },
+  },
+  // Test files
+  {
+    files: ["src/**/*.test.{ts,tsx}", "src/test-setup.ts"],
+    ...baseConfig,
+    languageOptions: {
+      ...baseConfig.languageOptions,
+      globals: {
+        ...globals.browser,
+        ...globals.node,
+        describe: "readonly",
+        it: "readonly",
+        expect: "readonly",
+        beforeAll: "readonly",
+        beforeEach: "readonly",
+        afterAll: "readonly",
+        afterEach: "readonly",
+        vi: "readonly",
+        global: "writable",
+      },
+    },
+    rules: {
+      ...baseConfig.rules,
+      "@typescript-eslint/no-explicit-any": "off", // Allow any in tests
+    },
+  },
+  // Build/config files
+  {
+    files: ["config/**/*.ts", "build-component.js"],
+    ...baseConfig,
+    languageOptions: {
+      ...baseConfig.languageOptions,
+      globals: globals.node,
+    },
+  },
+];

package/index.html ADDED Viewed

@@ -0,0 +1,54 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="apple-mobile-web-app-capable" content="yes" />
+    <meta
+      name="apple-mobile-web-app-status-bar-style"
+      content="black-translucent"
+    />
+    <meta name="mobile-web-app-capable" content="yes" />
+    <meta name="theme-color" content="#000000" />
+    <title>playlistz</title>
+    <style>
+      * {
+        box-sizing: border-box;
+      }
+      body {
+        font-family:
+          system-ui,
+          -apple-system,
+          sans-serif;
+        font-size: 16px;
+        margin: 0;
+        padding: 0;
+        background-color: black;
+        color: white;
+      }
+      /* ensure proper text wrapping */
+      .break-words {
+        word-wrap: break-word;
+        word-break: break-word;
+        overflow-wrap: break-word;
+        hyphens: auto;
+      }
+      /* loading style */
+      .loading {
+        display: flex;
+        justify-content: center;
+        align-items: center;
+        height: 100vh;
+        font-size: 18px;
+        color: #d946ef;
+      }
+    </style>
+  </head>
+  <body>
+    <div id="root">
+      <div class="loading">loading playlistz...</div>
+    </div>
+    <script type="module" src="/src/index.tsx"></script>
+  </body>
+</html>

package/package.json ADDED Viewed

@@ -0,0 +1,119 @@
+{
+  "name": "@freqhole/playlistz",
+  "version": "0.0.1",
+  "description": "make some music playlistz in yr browser!",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/freqhole/playlistz"
+  },
+  "exports": {
+    ".": "./src/web-component.tsx",
+    "./zip-bundle": "./src/zip-bundle/index.ts",
+    "./templates": "./src/utils/standaloneTemplates.ts"
+  },
+  "typesVersions": {
+    "*": {
+      "zip-bundle": [
+        "./src/zip-bundle/index.ts"
+      ],
+      "templates": [
+        "./src/utils/standaloneTemplates.ts"
+      ]
+    }
+  },
+  "keywords": [
+    "music-player",
+    "playlist",
+    "solid-js",
+    "web-component",
+    "indexeddb",
+    "pwa"
+  ],
+  "author": "3dwardsharp",
+  "license": "MIT",
+  "bin": {
+    "freqhole-playlistz": "./dist/freqhole-playlistz.cli.mjs"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "start": "vite --config config/vite.config.ts",
+    "dev": "npm start",
+    "build": "npm run build:app && npm run build:standalone -- --no-clear && npm run build:zip-bundle-lib",
+    "build:standalone": "node build-component.js",
+    "build:app": "vite build --config config/vite.config.ts",
+    "build:zip-bundle-lib": "node build-zip-bundle-lib.js",
+    "preview": "vite preview --config config/vite.config.ts",
+    "test": "vitest --run --config config/vitest.config.ts",
+    "test:watch": "vitest --config config/vitest.config.ts",
+    "test:coverage": "vitest --coverage --run --config config/vitest.config.ts",
+    "test:e2e": "playwright test --config config/playwright.config.ts",
+    "test:e2e:mock": "playwright test --config config/playwright.config.ts --grep @mock",
+    "test:e2e:real": "playwright test --config config/playwright.config.ts --grep-invert \"@mock|@p2p\"",
+    "test:e2e:p2p": "playwright test --config config/playwright.config.ts --grep @p2p",
+    "lint": "eslint",
+    "lint:fix": "eslint 'src/**/*.{ts,tsx}' --fix",
+    "format": "prettier --write 'src/**/*.{ts,tsx}'",
+    "type-check": "tsc --noEmit",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist coverage",
+    "changes": "changeset",
+    "changeset": "changeset",
+    "changeset:status": "changeset status",
+    "version": "changeset version",
+    "use-local": "node scripts/use-local.mjs",
+    "use-published": "node scripts/use-published.mjs"
+  },
+  "dependencies": {
+    "@automerge/automerge-repo": "^2.5.5",
+    "@automerge/automerge-repo-network-broadcastchannel": "^2.5.5",
+    "@automerge/automerge-repo-storage-indexeddb": "^2.5.5",
+    "@freqhole/api-client": "0.1.31",
+    "@freqhole/midden": "0.1.31",
+    "fflate": "^0.8.3",
+    "idb": "^8.0.3",
+    "jszip": "^3.10.1",
+    "solid-js": "^1.8.5",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.27.10",
+    "@eslint/js": "^9.34.0",
+    "@playwright/test": "^1.60.0",
+    "@solidjs/testing-library": "^0.8.10",
+    "@tailwindcss/vite": "^4.1.11",
+    "@types/jsdom": "^21.1.7",
+    "@types/jszip": "^3.4.0",
+    "@types/node": "^20.9.0",
+    "@typescript-eslint/eslint-plugin": "^8.41.0",
+    "@typescript-eslint/parser": "^8.41.0",
+    "@vitest/coverage-v8": "^1.6.1",
+    "eslint": "^9.29.0",
+    "eslint-config-prettier": "^9.1.2",
+    "eslint-plugin-prettier": "^5.5.4",
+    "eslint-plugin-solid": "^0.14.5",
+    "fake-indexeddb": "^6.0.1",
+    "globals": "^16.3.0",
+    "jsdom": "^26.1.0",
+    "prettier": "^3.1.0",
+    "solid-element": "^1.9.1",
+    "tailwindcss": "^4.1.11",
+    "typescript": "^5.3.2",
+    "vite": "^6.3.5",
+    "vite-plugin-solid": "^2.11.6",
+    "vite-plugin-top-level-await": "^1.6.0",
+    "vite-plugin-wasm": "^3.5.0",
+    "vitest": "^1.6.1",
+    "vitest-dom": "^0.1.1"
+  },
+  "prettier": {
+    "semi": true,
+    "trailingComma": "es5",
+    "singleQuote": false,
+    "printWidth": 80,
+    "tabWidth": 2,
+    "jsxSingleQuote": false
+  }
+}

package/public/sw.js ADDED Viewed

@@ -0,0 +1,134 @@
+// playlistz service worker
+//
+// caches the app shell files (freqhole-playlistz.js, playlistz.js, index.html, sw.js).
+// audio and image files in data/ are NOT pre-cached; the app ui handles that separately.
+//
+// bumping CACHE_VERSION forces all clients to receive fresh app files on next load.
+const CACHE_VERSION = "v2";
+const CACHE_NAME = `playlistz-${CACHE_VERSION}`;
+// app shell files to cache on install
+const APP_SHELL = [
+  "freqhole-playlistz.js",
+  "playlistz.js",
+  "index.html",
+  "sw.js",
+];
+// install: cache app shell and skip waiting so this sw activates immediately
+self.addEventListener("install", (event) => {
+  event.waitUntil(
+    caches.open(CACHE_NAME).then((cache) =>
+      cache.addAll(APP_SHELL).catch((err) => {
+        // some files may not exist (e.g. playlistz.js before first generate run)
+        console.warn("playlistz sw: pre-cache partial failure:", err);
+      }),
+    ).then(() => self.skipWaiting()),
+  );
+});
+// activate: delete old caches, claim all clients immediately
+self.addEventListener("activate", (event) => {
+  event.waitUntil(
+    caches.keys()
+      .then((names) =>
+        Promise.all(
+          names
+            .filter((n) => n.startsWith("playlistz-") && n !== CACHE_NAME)
+            .map((n) => caches.delete(n)),
+        ),
+      )
+      .then(() => self.clients.claim()),
+  );
+});
+// fetch: cache-first for app shell files, network-pass-through for everything else
+self.addEventListener("fetch", (event) => {
+  const url = new URL(event.request.url);
+  const filename = url.pathname.split("/").pop() ?? "";
+  const isAppShell = APP_SHELL.includes(filename) || url.pathname === "/" || url.pathname === "";
+  if (!isAppShell) {
+    return; // let browser handle data/ assets (audio, images)
+  }
+  event.respondWith(
+    caches.match(event.request).then((cached) => {
+      if (cached) return cached;
+      return fetch(event.request).then((response) => {
+        if (response.ok) {
+          caches.open(CACHE_NAME).then((cache) => cache.put(event.request, response.clone()));
+        }
+        return response;
+      });
+    }).catch(() => caches.match("index.html")),
+  );
+});
+// message: handle reset/clear from the page via window.__playlistzReset()
+self.addEventListener("message", (event) => {
+  if (event.data?.type === "PLAYLISTZ_RESET") {
+    event.waitUntil(
+      caches.keys()
+        .then((names) => Promise.all(names.map((n) => caches.delete(n))))
+        .then(() => self.clients.matchAll())
+        .then((clients) => clients.forEach((c) => c.postMessage({ type: "PLAYLISTZ_RESET_DONE" }))),
+    );
+  }
+});
+self.addEventListener("install", (event) => {
+  console.log("playlistz service worker: installing...");
+  event.waitUntil(
+    caches
+      .open(CACHE_NAME)
+      .then((cache) => {
+        console.log("playlistz service worker: caching app shell");
+        return cache.addAll(urlsToCache);
+      })
+      .catch((error) => {
+        console.error(
+          "playlistz service worker: failed to cache app shell:",
+          error
+        );
+      })
+  );
+});
+self.addEventListener("fetch", (event) => {
+  event.respondWith(
+    caches
+      .match(event.request)
+      .then((response) => {
+        // return cached version or fetch from network
+        if (response) {
+          return response;
+        }
+        return fetch(event.request);
+      })
+      .catch((error) => {
+        console.error("playlistz service worker: fetch failed:", error);
+        throw error;
+      })
+  );
+});
+self.addEventListener("activate", (event) => {
+  console.log("playlistz service worker: activating...");
+  event.waitUntil(
+    caches.keys().then((cacheNames) => {
+      return Promise.all(
+        cacheNames.map((cacheName) => {
+          if (cacheName !== CACHE_NAME) {
+            console.log(
+              "playlistz service worker: deleting old cache:",
+              cacheName
+            );
+            return caches.delete(cacheName);
+          }
+        })
+      );
+    })
+  );
+});

package/scripts/use-local.mjs ADDED Viewed

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+// switch @freqhole/* deps to local file: paths for development.
+// run: npm run use-local && npm install
+import { readFileSync, writeFileSync } from "fs";
+import { resolve, dirname } from "path";
+import { fileURLToPath } from "url";
+import { execSync } from "child_process";
+const root = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+const pkgPath = resolve(root, "package.json");
+const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+// paths are relative to the playlistz/ directory (adjust if your monorepo layout differs)
+const LOCAL = {
+    "@freqhole/api-client": "file:../tomb/client-codegen/freqhole-api-client",
+    "@freqhole/midden": "file:../tomb/client/midden/pkg",
+};
+let changed = false;
+for (const [name, localPath] of Object.entries(LOCAL)) {
+    for (const section of ["dependencies", "devDependencies", "peerDependencies"]) {
+        if (pkg[section]?.[name] !== undefined && pkg[section][name] !== localPath) {
+            console.log(`  ${name}: ${pkg[section][name]} -> ${localPath}`);
+            pkg[section][name] = localPath;
+            changed = true;
+        }
+    }
+}
+if (!changed) {
+    console.log("already using local paths - nothing to change");
+    process.exit(0);
+}
+writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+console.log("\nwritten. running npm install...");
+execSync("npm install", { cwd: root, stdio: "inherit" });

package/scripts/use-published.mjs ADDED Viewed

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+// switch @freqhole/* deps back to published npm versions.
+// run: npm run use-published && npm install
+//
+// the published versions are read from .freqhole-versions.json (git-tracked).
+// update that file when you publish a new version.
+import { readFileSync, writeFileSync } from "fs";
+import { resolve, dirname } from "path";
+import { fileURLToPath } from "url";
+import { execSync } from "child_process";
+const root = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+const pkgPath = resolve(root, "package.json");
+const versionsPath = resolve(root, ".freqhole-versions.json");
+const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+const versions = JSON.parse(readFileSync(versionsPath, "utf-8"));
+let changed = false;
+for (const [name, version] of Object.entries(versions)) {
+    for (const section of ["dependencies", "devDependencies", "peerDependencies"]) {
+        if (pkg[section]?.[name] !== undefined && pkg[section][name] !== version) {
+            console.log(`  ${name}: ${pkg[section][name]} -> ${version}`);
+            pkg[section][name] = version;
+            changed = true;
+        }
+    }
+}
+if (!changed) {
+    console.log("already using published versions - nothing to change");
+    process.exit(0);
+}
+writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+console.log("\nwritten. running npm install...");
+execSync("npm install", { cwd: root, stdio: "inherit" });

package/src/App.tsx ADDED Viewed

@@ -0,0 +1,9 @@
+import { Component } from "solid-js";
+import { Playlistz } from "./components";
+import "./styles.css";
+const App: Component = () => {
+  return <Playlistz />;
+};
+export default App;

package/src/cli/check.ts ADDED Viewed

@@ -0,0 +1,164 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+function validateField(
+  obj: Record<string, unknown>,
+  field: string,
+  type: string,
+  required: boolean,
+  context: string,
+  errors: string[],
+  warnings: string[]
+): void {
+  const val = obj[field];
+  if (val === undefined || val === null) {
+    if (required) errors.push(`${context}: missing required field "${field}"`);
+    return;
+  }
+  if (typeof val !== type) {
+    (required ? errors : warnings).push(
+      `${context}: "${field}" should be ${type}, got ${typeof val}`
+    );
+  }
+}
+function checkData(
+  data: unknown,
+  baseDir: string
+): { errors: string[]; warnings: string[] } {
+  const errors: string[] = [];
+  const warnings: string[] = [];
+  if (!Array.isArray(data)) {
+    errors.push(`playlist data must be an array, got ${typeof data}`);
+    return { errors, warnings };
+  }
+  if (data.length === 0) {
+    warnings.push("playlist data is empty (no playlists)");
+    return { errors, warnings };
+  }
+  for (let i = 0; i < data.length; i++) {
+    const entry = data[i];
+    const ctx = `playlist[${i}]`;
+    if (typeof entry !== "object" || entry === null) {
+      errors.push(`${ctx}: must be an object`);
+      continue;
+    }
+    const e = entry as Record<string, unknown>;
+    // validate playlist header
+    if (typeof e["playlist"] !== "object" || e["playlist"] === null) {
+      errors.push(`${ctx}: missing "playlist" object`);
+    } else {
+      const p = e["playlist"] as Record<string, unknown>;
+      const pc = `${ctx}.playlist`;
+      validateField(p, "id",          "string", true,  pc, errors, warnings);
+      validateField(p, "title",       "string", true,  pc, errors, warnings);
+      validateField(p, "rev",         "number", false, pc, errors, warnings);
+      validateField(p, "description", "string", false, pc, errors, warnings);
+      // check playlist cover image
+      if (p["imageExtension"]) {
+        const imgPath = path.join(baseDir, "data", `playlist-cover${p["imageExtension"]}`);
+        if (!fs.existsSync(imgPath)) {
+          warnings.push(`${pc}: cover image not found: data/playlist-cover${p["imageExtension"]}`);
+        }
+      }
+    }
+    // validate songs
+    if (!Array.isArray(e["songs"])) {
+      errors.push(`${ctx}: "songs" must be an array`);
+      continue;
+    }
+    if (e["songs"].length === 0) {
+      warnings.push(`${ctx}: no songs`);
+    }
+    for (let j = 0; j < e["songs"].length; j++) {
+      const song = e["songs"][j];
+      const sc = `${ctx}.songs[${j}]`;
+      if (typeof song !== "object" || song === null) {
+        errors.push(`${sc}: must be an object`);
+        continue;
+      }
+      const s = song as Record<string, unknown>;
+      validateField(s, "id",               "string", true,  sc, errors, warnings);
+      validateField(s, "title",            "string", true,  sc, errors, warnings);
+      validateField(s, "artist",           "string", true,  sc, errors, warnings);
+      validateField(s, "album",            "string", true,  sc, errors, warnings);
+      validateField(s, "duration",         "number", true,  sc, errors, warnings);
+      validateField(s, "originalFilename", "string", true,  sc, errors, warnings);
+      validateField(s, "fileSize",         "number", true,  sc, errors, warnings);
+      validateField(s, "sha",              "string", false, sc, errors, warnings);
+      // check audio file (skip http/https)
+      const filename = (s["safeFilename"] ?? s["originalFilename"]) as string | undefined;
+      if (filename && !filename.startsWith("http://") && !filename.startsWith("https://")) {
+        const audioPath = path.join(baseDir, "data", filename);
+        if (!fs.existsSync(audioPath)) {
+          errors.push(`${sc}: audio file not found: data/${filename}`);
+        }
+      }
+      // check song cover image
+      if (s["imageExtension"] && typeof s["safeFilename"] === "string") {
+        const baseName = s["safeFilename"].replace(/\.[^.]+$/, "");
+        const imgFile = `${baseName}-cover${s["imageExtension"]}`;
+        if (!fs.existsSync(path.join(baseDir, "data", imgFile))) {
+          warnings.push(`${sc}: cover image not found: data/${imgFile}`);
+        }
+      }
+    }
+  }
+  return { errors, warnings };
+}
+export function checkFile(filePath: string): void {
+  const resolved = path.resolve(filePath);
+  const baseDir = path.dirname(resolved);
+  if (!fs.existsSync(resolved)) {
+    console.error(`file not found: ${resolved}`);
+    process.exit(1);
+  }
+  let data: unknown;
+  try {
+    const src = fs.readFileSync(resolved, "utf-8");
+    const attrMatch = src.match(/setAttribute\s*\(\s*'data-playlistz'\s*,\s*("(?:[^"\\]|\\.)*")\s*\)/);
+    if (!attrMatch) {
+      console.error(`${filePath} does not set the data-playlistz attribute`);
+      process.exit(1);
+    }
+    data = JSON.parse(JSON.parse(attrMatch[1]!));
+  } catch (err) {
+    console.error(`failed to parse ${filePath}:`);
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+  }
+  if (data === undefined) {
+    console.error(`${filePath} does not contain playlist data`);
+    process.exit(1);
+  }
+  const { errors, warnings } = checkData(data, baseDir);
+  if (warnings.length > 0) {
+    warnings.forEach((w) => console.warn(`  warn  ${w}`));
+  }
+  if (errors.length > 0) {
+    errors.forEach((e) => console.error(`  error ${e}`));
+    console.error(`\n${errors.length} error(s) - ${filePath} is invalid`);
+    process.exit(1);
+  }
+  const playlists = data as Array<{ songs: unknown[] }>;
+  const totalSongs = playlists.reduce((n, p) => n + p.songs.length, 0);
+  console.log(`ok  ${playlists.length} playlist(s), ${totalSongs} song(s)${warnings.length > 0 ? ` (${warnings.length} warning(s))` : ""}`);
+}