@networkpro/web 1.5.1 → 1.5.6

package/src/service-worker.js

@@ -1,6 +1,7 @@
 /* ==========================================================================
 src/service-worker.js
 
+Copyright © 2025 Network Pro Strategies (Network Pro™)
 SPDX-License-Identifier: CC-BY-4.0 OR GPL-3.0-or-later
 This file is part of Network Pro.
 ========================================================================== */
@@ -18,28 +19,28 @@ const CACHE = `cache-${version}`;
 /** @type {string[]} */
 const excludedAssets = [];
 
+const IGNORE_PATHS = new Set([
+  "/img/banner-1280x640.png",
+  "/img/banner-og-1200x630.png",
+  "/img/logo-transparent.png",
+  "/img/logo.png",
+  "/img/svelte.png",
+  "/webfonts/fa-brands-400.ttf",
+  "/webfonts/fa-solid-900.ttf",
+  "/robots.txt",
+  "/screenshots/desktop-foss.png",
+  "/sitemap.xml",
+  "/CNAME",
+]);
+
 /** @type {string[]} */
-const ASSETS = Array.from(
-  new Set(
+const ASSETS = [
+  ...new Set(
     [...build, ...files, "/offline.html"].filter((path) => {
       try {
         const url = new URL(path, location.origin);
         const hostname = url.hostname;
 
-        const IGNORE_PATHS = new Set([
-          "/img/banner-1280x640.png",
-          "/img/banner-og-1200x630.png",
-          "/img/logo-transparent.png",
-          "/img/logo.png",
-          "/img/svelte.png",
-          "/webfonts/fa-brands-400.ttf",
-          "/webfonts/fa-solid-900.ttf",
-          "/robots.txt",
-          "/screenshots/desktop-foss.png",
-          "/sitemap.xml",
-          "/CNAME",
-        ]);
-
         const shouldExclude =
           path.startsWith("http") ||
           disallowedHosts.some(
@@ -56,23 +57,24 @@ const ASSETS = Array.from(
       }
     }),
   ),
-);
+];
 
 const uniqueExcludedAssets = [...new Set(excludedAssets)].sort();
 
 console.log("[SW] Assets to precache:", ASSETS);
 console.log("[SW] Excluded assets:", uniqueExcludedAssets);
 
-/**
- * @param {ExtendableEvent} event
- */
+// 🔹 Install event
 sw.addEventListener("install", (event) => {
+  console.log("[SW] Install event");
   event.waitUntil(
     (async () => {
       const cache = await caches.open(CACHE);
       try {
         await cache.addAll(ASSETS);
+        console.log("[SW] Precaching complete");
         sw.skipWaiting();
+        console.log("[SW] skipWaiting() called");
       } catch (err) {
         console.warn("[SW] Failed to precache some assets:", err);
       }
@@ -80,23 +82,26 @@ sw.addEventListener("install", (event) => {
   );
 });
 
-/**
- * @param {ExtendableEvent} event
- */
+// 🔹 Activate event
 sw.addEventListener("activate", (event) => {
-  /** @type {ExtendableEvent} */ (event).waitUntil(
+  console.log("[SW] Activate event");
+  event.waitUntil(
     (async () => {
       const tasks = [];
 
       if (sw.registration.navigationPreload) {
         tasks.push(sw.registration.navigationPreload.enable());
+        console.log("[SW] Navigation preload enabled");
       }
 
       tasks.push(
         caches.keys().then((keys) =>
           Promise.all(
             keys.map((key) => {
-              if (key !== CACHE) return caches.delete(key);
+              if (key !== CACHE) {
+                console.log("[SW] Deleting old cache:", key);
+                return caches.delete(key);
+              }
             }),
           ),
         ),
@@ -104,29 +109,43 @@ sw.addEventListener("activate", (event) => {
 
       await Promise.all(tasks);
       await sw.clients.claim();
+      console.log("[SW] clients.claim() called");
+      console.log("[SW] Scope:", sw.registration.scope);
     })(),
   );
 });
 
-/**
- * @param {FetchEvent} event
- */
+// 🔹 Fetch event
 sw.addEventListener("fetch", (event) => {
-  /** @type {FetchEvent} */ (event).respondWith(
+  console.log("[SW] Fetch intercepted:", event.request.url);
+  event.respondWith(
     (async () => {
       if (new URL(event.request.url).origin === location.origin) {
         const cached = await caches.match(event.request);
-        if (cached) return cached;
+        if (cached) {
+          console.log("[SW] Serving from cache:", event.request.url);
+          return cached;
+        }
       }
 
       try {
         if (event.request.mode === "navigate") {
           const preloadResponse = await event.preloadResponse;
-          if (preloadResponse) return preloadResponse;
+          if (preloadResponse) {
+            console.log("[SW] Using preload response for:", event.request.url);
+            return preloadResponse;
+          }
         }
 
+        console.log("[SW] Fetching from network:", event.request.url);
         return await fetch(event.request);
-      } catch {
+      } catch (err) {
+        console.warn(
+          "[SW] Fetch failed; offline fallback used:",
+          event.request.url,
+          err,
+        );
+
         if (event.request.mode === "navigate") {
           const offline = await caches.match("/offline.html");
           if (offline) return offline;

package/static/docs/Home.md

@@ -0,0 +1,63 @@
+# 🧠 Network Pro — Developer Wiki
+
+> Internal documentation and contributor onboarding resources for the [Network Pro™ Web Presence](https://github.com/netwk-pro/netwk-pro.github.io) project.  
+> **Note:** Most of the below links are currently non-functional and serve solely as placeholders. Once pages are added, the placeholder links will be removed.
+
+---
+
+## 📌 Overview
+
+This wiki provides documentation, conventions, and internal tooling references to support development, testing, and deployment workflows across the Network Pro stack.
+
+---
+
+## 📁 Sections
+
+### 🛠 Setup & Tooling
+
+- [Environment Requirements](Environment-Requirements.md)  
+  Node, npm, version managers, OS-specific notes.
+- [Editor Configuration](Editor-Configuration.md)  
+  Workspace settings, recommended VS Code/VSCodium extensions.
+- [CLI Scripts Reference](CLI-Scripts.md)  
+  `npm run` scripts explained with tips for usage.
+
+### 🚧 Development
+
+- [Local Development](Local-Development.md)  
+  Running the project, debugging, hot reload, ENV_MODE behavior.
+- [Testing & Audits](Testing-&-Audits.md)  
+  Vitest, Playwright, Lighthouse, CI reports.
+- [Styling & Components](Styling-&-Components.md)  
+  Design system, reusable components, naming conventions.
+
+### 🚀 CI/CD
+
+- [GitHub Actions Workflows](CI-CD-Workflows.md)  
+  How our deploy/audit pipelines are structured.
+- [Versioning & Releases](Versioning-&-Releases.md)  
+  Publishing, changelog generation, NPM tagging conventions.
+
+### 📚 Documentation Maintenance
+
+- [Contributing to the Wiki](Contributing-to-the-Wiki.md)  
+  Format, tone, and content guidelines for internal docs.
+- [MkDocs Subsite Overview](MkDocs-Subsite.md)  
+  How the public documentation repo is built and deployed.
+
+---
+
+## 📎 Related Repositories
+
+- [Main Site (Web)](https://github.com/netwk-pro/netwk-pro.github.io)
+- [Documentation Site](https://github.com/netwk-pro/docs)
+- [Blog Subsite](https://github.com/netwk-pro/blog)
+- [GitHub Wiki](https://github.com/netwk-pro/netwk-pro.github.io/wiki)
+
+---
+
+## 🤝 Contributing
+
+If you're new to the project, start with [Environment Requirements](Environment-Requirements.md) and [Local Development](Local-Development.md). See [Contributing to the Wiki](Contributing-to-the-Wiki.md) for how to add or edit content.
+
+---

package/static/docs/extensions.md

@@ -0,0 +1,58 @@
+# 🧩 Recommended VS Code Extensions
+
+To streamline development and align with project conventions, we recommend the following [VSCodium](https://vscodium.com/) and [Visual Studio Code](https://code.visualstudio.com/) (VS Code) extensions. These tools enhance productivity, enforce code quality, and ensure consistency across the codebase.
+
+> Note: While these extensions are optional, they are thoughtfully curated to complement our development workflow.
+
+<!-- cspell:disable -->
+
+| Extension Name            | Identifier                              | Description                                                                 |
+| ------------------------- | --------------------------------------- | --------------------------------------------------------------------------- |
+| Prettier - Code formatter | `esbenp.prettier-vscode`                | Formats code consistently across various languages.                         |
+| ESLint                    | `dbaeumer.vscode-eslint`                | Integrates ESLint into VS Code for JavaScript and TypeScript linting.       |
+| Stylelint                 | `stylelint.vscode-stylelint`            | Lints CSS/SCSS and enforces consistent styling conventions.                 |
+| Markdownlint              | `DavidAnson.vscode-markdownlint`        | Provides linting and style checking for Markdown files.                     |
+| EditorConfig for VS Code  | `EditorConfig.EditorConfig`             | Maintains consistent coding styles between different editors and IDEs.      |
+| Svelte for VS Code        | `svelte.svelte-vscode`                  | Offers syntax highlighting, code completion, and error checking for Svelte. |
+| Code Spell Checker        | `streetsidesoftware.code-spell-checker` | Inline spell checking (comments, Markdown, etc.)                            |
+
+## 🛠 Installation
+
+To install these extensions, you can use the following command in your terminal:
+
+```bash
+code --install-extension esbenp.prettier-vscode
+code --install-extension dbaeumer.vscode-eslint
+code --install-extension stylelint.vscode-stylelint
+code --install-extension DavidAnson.vscode-markdownlint
+code --install-extension EditorConfig.EditorConfig
+code --install-extension svelte.svelte-vscode
+code --install-extension volta.volta
+code --install-extension eamodio.gitlens
+code --install-extension github.vscode-pull-request-github
+```
+
+<!-- cspell:enable -->
+
+Alternatively, you can search for each extension by name in [Open VSX Registry](https://open-vsx.org/) and/or the [VS Code Extensions Marketplace](https://marketplace.visualstudio.com/vscode) and install them individually.
+
+## 📁 Workspace Recommendations
+
+Our repository includes a `.vscode/extensions.json` file that specifies these recommended extensions. When you open the project in VS Code, you'll be prompted to install any missing recommended extensions. This ensures a consistent development environment across all contributors.
+
+## 🔧 Configuration
+
+The `.vscode/settings.json` file in the repository contains workspace-specific settings that align with our coding standards and practices. These settings include formatter configurations, linting rules, and other preferences to maintain code quality and consistency.
+
+---
+
+<div style="font-size: 12px; text-align: center;">
+
+Copyright &copy; 2025  
+**[Network Pro Strategies](https://netwk.pro) (Network Pro&trade;)**
+
+Network Pro&trade;, the shield logo, and the "Locking Down Networks&trade;" slogan are [trademarks](https://netwk.pro/license#trademark) of Network Pro Strategies.
+
+Licensed under **[CC BY 4.0](https://netwk.pro/license#cc-by)** and the **[GNU GPL](https://netwk.pro/license#gnu-gpl)**, as published by the [Free Software Foundation](https://www.fsf.org), either version 3 of the License, or (at your option) any later version.
+
+</div>

package/static/sitemap.xml

@@ -7,7 +7,7 @@
 
     <loc>https://netwk.pro</loc>
 
-    <lastmod>2025-05-18</lastmod>
+    <lastmod>2025-05-24</lastmod>
 
     <changefreq>weekly</changefreq>
 
@@ -31,7 +31,7 @@
 
     <loc>https://netwk.pro/contact</loc>
 
-    <lastmod>2025-05-18</lastmod>
+    <lastmod>2025-05-24</lastmod>
 
     <changefreq>monthly</changefreq>
 
@@ -43,7 +43,7 @@
 
     <loc>https://netwk.pro/privacy-rights</loc>
 
-    <lastmod>2025-05-18</lastmod>
+    <lastmod>2025-05-24</lastmod>
 
     <changefreq>monthly</changefreq>
 
@@ -55,7 +55,7 @@
 
     <loc>https://netwk.pro/privacy-policy</loc>
 
-    <lastmod>2025-05-18</lastmod>
+    <lastmod>2025-05-23</lastmod>
 
     <changefreq>monthly</changefreq>
 
@@ -67,7 +67,7 @@
 
     <loc>https://netwk.pro/license</loc>
 
-    <lastmod>2025-05-18</lastmod>
+    <lastmod>2025-05-24</lastmod>
 
     <changefreq>monthly</changefreq>
 
@@ -79,7 +79,7 @@
 
     <loc>https://netwk.pro/terms-of-use</loc>
 
-    <lastmod>2025-05-18</lastmod>
+    <lastmod>2025-05-21</lastmod>
 
     <changefreq>monthly</changefreq>
 
@@ -91,7 +91,7 @@
 
     <loc>https://netwk.pro/terms-conditions</loc>
 
-    <lastmod>2025-05-18</lastmod>
+    <lastmod>2025-05-08</lastmod>
 
     <changefreq>monthly</changefreq>
 

package/stylelint.config.js

@@ -1,8 +1,9 @@
 /* =========================================================================
 stylelint.config.js
 
+Copyright © 2025 Network Pro Strategies (Network Pro™)
 SPDX-License-Identifier: CC-BY-4.0 OR GPL-3.0-or-later
-This file is part of Network Pro.
+This file is part of Network Pro
 ========================================================================= */
 
 /** @type {import('stylelint').Config} */

package/svelte.config.js

@@ -1,6 +1,7 @@
 /* =========================================================================
 svelte.config.js
 
+Copyright © 2025 Network Pro Strategies (Network Pro™)
 SPDX-License-Identifier: CC-BY-4.0 OR GPL-3.0-or-later
 This file is part of Network Pro.
 ========================================================================= */

package/tests/e2e/app.spec.js

@@ -1,6 +1,7 @@
 /* ==========================================================================
 tests/e2e/app.spec.js
 
+Copyright © 2025 Network Pro Strategies (Network Pro™)
 SPDX-License-Identifier: CC-BY-4.0 OR GPL-3.0-or-later
 This file is part of Network Pro.
 ========================================================================== */

package/tests/e2e/mobile.spec.js

@@ -1,6 +1,7 @@
 /* ==========================================================================
 tests/e2e/mobile.spec.js
 
+Copyright © 2025 Network Pro Strategies (Network Pro™)
 SPDX-License-Identifier: CC-BY-4.0 OR GPL-3.0-or-later
 This file is part of Network Pro.
 ========================================================================== */

package/tests/unit/auditScripts.test.js

@@ -1,6 +1,7 @@
 /* ==========================================================================
 tests/unit/auditScripts.test.js
 
+Copyright © 2025 Network Pro Strategies (Network Pro™)
 SPDX-License-Identifier: CC-BY-4.0 OR GPL-3.0-or-later
 This file is part of Network Pro.
 ========================================================================== */

package/tests/unit/checkEnv.test.js

@@ -1,6 +1,7 @@
 /* ==========================================================================
 tests/unit/checkEnv.test.js
 
+Copyright © 2025 Network Pro Strategies (Network Pro™)
 SPDX-License-Identifier: CC-BY-4.0 OR GPL-3.0-or-later
 This file is part of Network Pro.
 ========================================================================== */

package/tests/unit/checkVersions.test.js

@@ -1,6 +1,7 @@
 /* ==========================================================================
 tests/unit/checkVersions.test.js
 
+Copyright © 2025 Network Pro Strategies (Network Pro™)
 SPDX-License-Identifier: CC-BY-4.0 OR GPL-3.0-or-later
 This file is part of Network Pro.
 ========================================================================== */

package/tests/unit/demo.test.js

@@ -1,6 +1,7 @@
 /* ==========================================================================
 tests/unit/demo.spec.js
 
+Copyright © 2025 Network Pro Strategies (Network Pro™)
 SPDX-License-Identifier: CC-BY-4.0 OR GPL-3.0-or-later
 This file is part of Network Pro.
 ========================================================================== */

package/tests/unit/routes/page.svelte.test.js

@@ -1,6 +1,7 @@
 /* ==========================================================================
 tests/unit/routes/page.svelte.test.js
 
+Copyright © 2025 Network Pro Strategies (Network Pro™)
 SPDX-License-Identifier: CC-BY-4.0 OR GPL-3.0-or-later
 This file is part of Network Pro.
 ========================================================================== */

package/tests/unit/unregisterServiceWorker.test.js

@@ -1,6 +1,7 @@
 /* ==========================================================================
 tests/unit/unregisterServiceWorker.test.js
 
+Copyright © 2025 Network Pro Strategies (Network Pro™)
 SPDX-License-Identifier: CC-BY-4.0 OR GPL-3.0-or-later
 This file is part of Network Pro.
 ========================================================================== */

package/tests/unit/utm.test.js

@@ -1,6 +1,7 @@
 /* ==========================================================================
 tests/unit/utm.test.js
 
+Copyright © 2025 Network Pro Strategies (Network Pro™)
 SPDX-License-Identifier: CC-BY-4.0 OR GPL-3.0-or-later
 This file is part of Network Pro.
 ========================================================================== */

package/{tsconfig.custom.json → tsconfig.custom.jsonc}

@@ -1,10 +1,11 @@
 /* ==========================================================================
-tsconfig.custom.json
+tsconfig.custom.jsonc
 
 NOTE: This file is for reference only and is not actively used in the build.
 The project uses the SvelteKit-generated .svelte-kit/tsconfig.json extended by
 jsconfig.json for actual TypeScript configuration.
 
+Copyright © 2025 Network Pro Strategies (Network Pro™)
 SPDX-License-Identifier: CC-BY-4.0 OR GPL-3.0-or-later
 This file is part of Network Pro.
 ========================================================================== */

package/vite.config.js

@@ -1,6 +1,7 @@
 /* =========================================================================
 vite.config.js
 
+Copyright © 2025 Network Pro Strategies (Network Pro™)
 SPDX-License-Identifier: CC-BY-4.0 OR GPL-3.0-or-later
 This file is part of Network Pro.
 ========================================================================= */

package/vitest.config.client.js

@@ -1,6 +1,7 @@
 /* =========================================================================
 vitest.config.client.js
 
+Copyright © 2025 Network Pro Strategies (Network Pro™)
 SPDX-License-Identifier: CC-BY-4.0 OR GPL-3.0-or-later
 This file is part of Network Pro.
 ========================================================================= */

package/vitest.config.server.js

@@ -1,6 +1,7 @@
 /* =========================================================================
 vitest.config.server.js
 
+Copyright © 2025 Network Pro Strategies (Network Pro™)
 SPDX-License-Identifier: CC-BY-4.0 OR GPL-3.0-or-later
 This file is part of Network Pro.
 ========================================================================= */