feat: add install-grade PWA icons

Author: SysAdminDoc

CHANGELOG.md

@@ -26,6 +26,7 @@ All notable changes to ScriptHunt will be documented in this file.
 - Added exact-URL applicability simulation for userscript scheme, host, port, path, include globs, and exclusion rules while retaining domain-only host hints.
 - Versioned offline search records now preserve source route, status, partiality, failures, and scan evidence; legacy IndexedDB/localStorage copies migrate and deduplicate by newest valid record, with visible schema and eviction diagnostics.
 - Added a local accessibility matrix across four themes and 320/375/768/1280px viewports, including text contrast, focus visibility, reduced motion, native/fallback popovers, keyboard result actions, comparison focus, and overflow checks.
+- Added verified 192×192 and 512×512 PWA icons to the manifest and offline shell.
 
 ## [v0.5.1]
 

README.md

@@ -82,7 +82,7 @@ npm run qa
 | **Content Security Policy** | Static parser-safe CSP limits network requests to HTTPS while URL validation and source/proxy contracts constrain destinations |
 | **View Transitions** | GPU-accelerated smooth transitions between search states |
 | **Themes** | Dark, Light, OLED black, and Auto (follows OS preference) |
-| **PWA** | Installable Progressive Web App with update prompts, offline shell fallback notices, and recent-search cache |
+| **PWA** | Installable Progressive Web App with 192px/512px icons, update prompts, offline shell fallback notices, and recent-search cache |
 | **Responsive Design** | Full mobile/tablet/desktop support with CSS container queries |
 | **Runtime Zero Dependencies** | Single HTML file, no app runtime dependencies; npm is used only for local tests via `npm run qa` |
 

icon-192.png

@@ -1,13 +1,14 @@
-{
-  "name": "ScriptHunt",
-  "short_name": "ScriptHunt",
-  "description": "Unified search across every userscript source",
-  "start_url": "./",
-  "scope": "./",
-  "display": "standalone",
-  "background_color": "#060810",
+{
+  "name": "ScriptHunt",
+  "short_name": "ScriptHunt",
+  "description": "Unified search across every userscript source",
+  "start_url": "./",
+  "scope": "./",
+  "display": "standalone",
+  "background_color": "#060810",
   "theme_color": "#0b0e16",
   "icons": [
-    { "src": "icon.png", "sizes": "256x256", "type": "image/png" }
+    { "src": "icon-192.png", "sizes": "192x192", "type": "image/png", "purpose": "any" },
+    { "src": "icon-512.png", "sizes": "512x512", "type": "image/png", "purpose": "any" }
   ]
 }

icon-512.png

@@ -3,6 +3,8 @@ var SHELL_ASSETS = [
   './',
   './index.html',
   './icon.png',
+  './icon-192.png',
+  './icon-512.png',
   './manifest.json',
   './fonts/jetbrains-mono-latin.woff2',
   './fonts/jetbrains-mono-latin-ext.woff2',

manifest.json

@@ -80,3 +80,25 @@ test('package release metadata identifies the public application', () => {
   assert.equal(pkg.homepage, 'https://sysadmindoc.github.io/UserScriptHunt/');
   assert.match(pkg.description, /seven built-in catalogs/);
 });
+
+test('PWA manifest declares install-grade PNG icons with matching dimensions', () => {
+  const manifest = JSON.parse(readFile('manifest.json'));
+  const expected = new Map([[192, 'icon-192.png'], [512, 'icon-512.png']]);
+  const icons = Array.isArray(manifest.icons) ? manifest.icons : [];
+
+  for (const [size, filename] of expected) {
+    const icon = icons.find((entry) => entry.src === filename);
+    assert.ok(icon, `manifest should declare ${filename}`);
+    assert.equal(icon.sizes, `${size}x${size}`);
+    assert.equal(icon.type, 'image/png');
+    const png = fs.readFileSync(path.join(root, filename));
+    assert.equal(png.toString('hex', 0, 8), '89504e470d0a1a0a', `${filename} should be a PNG`);
+    assert.equal(png.readUInt32BE(16), size, `${filename} width should match manifest`);
+    assert.equal(png.readUInt32BE(20), size, `${filename} height should match manifest`);
+  }
+
+  const serviceWorker = readFile('sw.js');
+  for (const filename of expected.values()) {
+    assert.ok(serviceWorker.includes(`'./${filename}'`), `${filename} should be in the offline shell`);
+  }
+});