@networkpro/web 1.13.7 → 1.14.1

package/.github/workflows/publish-test.yml

@@ -0,0 +1,215 @@
+# .github/workflows/publish-test.yml
+#
+# 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
+
+name: Test Publishing to Registries
+
+on:
+  workflow_dispatch:
+
+# Allow one concurrent deployment
+concurrency:
+  group: 'build-and-publish'
+  cancel-in-progress: true
+
+permissions:
+  actions: read
+  contents: read
+
+jobs:
+  check-codeql:
+    uses: ./.github/workflows/check-codeql.yml
+
+  build:
+    needs: check-codeql
+    runs-on: ubuntu-24.04
+    env:
+      ENV_MODE: ci
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          cache: npm
+          cache-dependency-path: package-lock.json
+
+      - name: Show Node.js and npm versions
+        run: |
+          echo "Node.js version: $(node -v)"
+          echo "npm version: $(npm -v)"
+
+      - name: Upgrade npm
+        run: |
+          corepack enable
+          npm install -g npm@11.4.1
+
+      - name: Install Node.js dependencies
+        run: npm ci
+
+      - name: Install jq
+        run: sudo apt-get install -y jq
+
+      - name: Run JSDoc lint check
+        id: jsdoc_lint
+        continue-on-error: true
+        run: |
+          set -e
+          output=$(npm run lint:jsdoc || true)
+          echo "$output"
+
+          count=$(echo "$output" | wc -l)
+          echo "jsdoc_count=$count" >> "$GITHUB_OUTPUT"
+
+      - name: ✅ Pass
+        if: steps.jsdoc_lint.outputs.jsdoc_count == '0'
+        run: echo "JSDoc lint passed successfully!"
+
+      - name: ⚠️ JSDoc violations detected (non-blocking)
+        if: steps.jsdoc_lint.outputs.jsdoc_count != '0'
+        run: echo "⚠️ JSDoc lint check failed with ${{ steps.jsdoc_lint.outputs.jsdoc_count }} violations (non-blocking)"
+
+      # Test to ensure the package is working
+      - name: Build Node.js project
+        run: npm run build
+
+      # Create Git archive of version-controlled files
+      - name: Create clean source archive
+        run: git archive --format=tar.gz --output=clean-source.tar.gz HEAD
+
+      - name: Upload source archive
+        uses: actions/upload-artifact@v4
+        with:
+          name: clean-source
+          path: clean-source.tar.gz
+
+  publish-npmjs:
+    needs: build
+    runs-on: ubuntu-24.04
+    env:
+      ENV_MODE: ci
+
+    steps:
+      - name: Download clean source archive
+        uses: actions/download-artifact@v4
+        with:
+          name: clean-source
+          path: ./
+
+      - name: Extract source archive
+        run: tar -xzf clean-source.tar.gz
+
+      - name: Remove extracted source archive
+        run: rm clean-source.tar.gz
+
+      - name: Set up Node.js for npmjs
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          registry-url: https://registry.npmjs.org/
+          cache: npm
+          cache-dependency-path: package-lock.json
+
+      - name: Show Node.js and npm versions
+        run: |
+          echo "Node.js version: $(node -v)"
+          echo "npm version: $(npm -v)"
+
+      - name: Upgrade npm
+        run: |
+          corepack enable
+          npm install -g npm@11.4.1
+
+      - name: Install Node.js dependencies
+        run: npm ci
+
+      - name: Set up Git user
+        run: |
+          git config --global user.email "github@sl.neteng.cc"
+          git config --global user.name "SunDevil311"
+
+      - name: Verify version not already published
+        run: |
+          PACKAGE_NAME=$(node -p "require('./package.json').name")
+          PACKAGE_VERSION=$(node -p "require('./package.json').version")
+          echo "Checking if $PACKAGE_NAME@$PACKAGE_VERSION is already published..."
+
+          npm view $PACKAGE_NAME@$PACKAGE_VERSION > /dev/null && {
+            echo "❌ Version $PACKAGE_VERSION already exists on npm. Exiting..."
+            exit 1
+          } || echo "✅ Version is new. Proceeding with publish."
+
+      - name: Simulate publish package to npmjs
+        run: npm publish --dry-run
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_NETPRO }}
+
+  publish-gpr:
+    needs: build
+    runs-on: ubuntu-24.04
+    env:
+      ENV_MODE: ci
+
+    steps:
+      - name: Download clean source archive
+        uses: actions/download-artifact@v4
+        with:
+          name: clean-source
+          path: ./
+
+      - name: Extract source archive
+        run: tar -xzf clean-source.tar.gz
+
+      - name: Remove extracted source archive
+        run: rm clean-source.tar.gz
+
+      - name: Set up Node.js for GPR
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          registry-url: https://npm.pkg.github.com/
+          cache: npm
+          cache-dependency-path: package-lock.json
+
+      - name: Show Node.js and npm versions
+        run: |
+          echo "Node.js version: $(node -v)"
+          echo "npm version: $(npm -v)"
+
+      - name: Upgrade npm
+        run: |
+          corepack enable
+          npm install -g npm@11.4.1
+
+      - name: Install Node.js dependencies
+        run: npm ci
+
+      - name: Set up Git user
+        run: |
+          git config --global user.email "github@sl.neteng.cc"
+          git config --global user.name "SunDevil311"
+
+      - name: Update package name for GPR
+        run: |
+          sed -i 's/"name": ".*"/"name": "@netwk-pro\/web"/' package.json
+
+      - name: Verify version not already published
+        run: |
+          PACKAGE_NAME=$(node -p "require('./package.json').name")
+          PACKAGE_VERSION=$(node -p "require('./package.json').version")
+          echo "Checking if $PACKAGE_NAME@$PACKAGE_VERSION is already published..."
+
+          npm view $PACKAGE_NAME@$PACKAGE_VERSION > /dev/null && {
+            echo "❌ Version $PACKAGE_VERSION already exists on npm. Exiting..."
+            exit 1
+          } || echo "✅ Version is new. Proceeding with publish."
+
+      - name: Simulate publish package to GPR
+        run: npm publish --dry-run
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NWPRO_GPR }}

package/.github/workflows/templates/check-codeql.template.yml

@@ -0,0 +1,47 @@
+# check-codeql.template.yml
+#
+# Reusable GitHub Actions workflow to enforce that the latest CodeQL scan
+# has completed successfully.
+#
+# Version: v1.0.0
+# Maintainer: Scott Lopez <support@neteng.pro>
+# Usage: Copy to `.github/workflows/check-codeql.yml` in your repo or reference directly if shared centrally.
+#
+# 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
+
+name: Reusable CodeQL Status Check
+
+permissions:
+  actions: read
+  contents: read
+
+on:
+  workflow_call:
+
+jobs:
+  check:
+    name: Check CodeQL Status
+    runs-on: ubuntu-24.04
+
+    steps:
+      - name: Check CodeQL Workflow
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          gh --version
+
+          if ! gh run list --repo "${GITHUB_REPOSITORY}" --workflow "CodeQL" --limit 1 --json conclusion --jq '.[0].conclusion' > codeql_status.txt; then
+            echo "::error title=CodeQL Check Failed::Could not retrieve CodeQL run status. Blocking deployment."
+            exit 1
+          fi
+
+          CODEQL_STATUS=$(cat codeql_status.txt)
+          echo "CodeQL status: $CODEQL_STATUS"
+          if [[ "$CODEQL_STATUS" != "success" ]]; then
+            echo "::error title=CodeQL Check Failed::Latest CodeQL run did not succeed. Blocking deployment."
+            exit 1
+          fi
+
+          rm -f codeql_status.txt

package/.lighthouserc.cjs

@@ -0,0 +1,37 @@
+/* ==========================================================================
+.lighthouserc.cjs
+
+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.
+========================================================================== */
+
+module.exports = {
+  ci: {
+    collect: {
+      url: ['https://netwk.pro'],
+      numberOfRuns: 1,
+      settings: {
+        onlyCategories: [
+          'performance',
+          'accessibility',
+          'best-practices',
+          'seo',
+        ],
+        disableFullPageScreenshot: true,
+      },
+    },
+    assert: {
+      preset: 'none',
+      assertions: {
+        // Add budget checks by asserting that "resource-summary" does not exceed budget
+        'resource-summary': ['error', { budgetPath: 'budget.json' }],
+      },
+    },
+    upload: {
+      target: 'filesystem',
+      outputDir: './.lighthouseci',
+      reporter: ['html', 'json'],
+    },
+  },
+};

package/.markdownlint.mjs

@@ -0,0 +1,31 @@
+/* ==========================================================================
+.markdownlint.mjs
+
+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.
+========================================================================== */
+
+import noSmartQuotes from './.md-smart-quotes.js'; // adjust path as needed
+
+export default {
+  // Enable all default rules, then override below
+  default: true,
+
+  // Custom rule: disallow curly (smart) quotes
+  customRules: [noSmartQuotes],
+
+  // Rule exceptions
+  MD041: false, // First line in file should be a top-level header
+  MD033: false, // Allow inline HTML
+  MD013: false, // Ignore line length
+
+  // Additional parser options
+  options: {
+    frontMatter: '^---\\n[\\s\\S]*?\\n---', // YAML front matter regex
+  },
+
+  // Rule-specific configurations
+  MD007: { indent: 2 }, // Set consistent unordered list indentation (e.g., 2 spaces)
+  MD029: { style: 'ordered' }, // Enforce consistent ordered list numbering
+};

package/.md-smart-quotes.js

@@ -0,0 +1,31 @@
+/* ==========================================================================
+.md-smart-quotes.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.
+========================================================================== */
+
+export default {
+  names: ['no-smart-quotes'],
+  description: 'Disallow smart quotes (curly quotes)',
+  information: new URL('https://github.com/DavidAnson/markdownlint'),
+  tags: ['quotes', 'style'],
+  function(params, onError) {
+    const smartQuoteRegex = /[“”‘’]/g;
+
+    params.tokens.forEach((token) => {
+      if (token.type === 'inline' && smartQuoteRegex.test(token.content)) {
+        const matches = [...token.content.matchAll(smartQuoteRegex)];
+        matches.forEach((match) => {
+          const index = match.index;
+          onError({
+            lineNumber: token.lineNumber,
+            detail: `Smart quote (${match[0]}) detected`,
+            range: [index + 1, 1],
+          });
+        });
+      }
+    });
+  },
+};

package/.node-version

@@ -0,0 +1 @@
+24.2.0

package/.nvmrc

@@ -0,0 +1 @@
+24.2.0

package/.prettierignore

@@ -0,0 +1,55 @@
+# .prettierignore
+#
+# 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.
+
+# Custom ignores
+.markdownlint.jsonc
+
+
+# Licenses
+static/bin/license
+
+# Minified CSS
+*.min.css
+
+# SvelteKit
+.svelte-kit/*
+src/lib/styles
+src/lib/*.js
+src/lib/data/*.js
+
+# Node.js dependencies
+node_modules
+
+# Build artifacts
+build
+.vite
+.cache
+coverage
+
+# Temporary files
+*.lock
+*.tmp
+*.swp
+*.bak
+
+# Static assets
+**/*.png
+**/*.jpg
+**/*.jpeg
+**/*.gif
+**/*.svg
+**/*.woff
+**/*.woff2
+**/*.ttf
+**/*.eot
+
+# Generated files
+**/*.d.ts
+**/generated/*
+
+# Configuration files
+package.json
+package-lock.json

package/.prettierrc

@@ -0,0 +1,35 @@
+{
+  "printWidth": 80,
+  "tabWidth": 2,
+  "useTabs": false,
+  "semi": true,
+  "singleQuote": true,
+  "quoteProps": "as-needed",
+  "jsxSingleQuote": true,
+  "trailingComma": "all",
+  "bracketSpacing": true,
+  "objectWrap": "preserve",
+  "bracketSameLine": true,
+  "arrowParens": "always",
+  "requirePragma": false,
+  "insertPragma": false,
+  "proseWrap": "preserve",
+  "htmlWhitespaceSensitivity": "strict",
+  "endOfLine": "lf",
+  "singleAttributePerLine": false,
+  "plugins": ["prettier-plugin-svelte"],
+  "overrides": [
+    {
+      "files": "*.svelte",
+      "options": {
+        "parser": "svelte"
+      }
+    },
+    {
+      "files": "*.jsonc",
+      "options": {
+        "trailingComma": "none"
+      }
+    }
+  ]
+}

package/.stylelintignore

@@ -0,0 +1,43 @@
+# .stylelintignore
+#
+# 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.
+
+# Report files and test results
+playwright-report
+test-results
+
+# Node.js dependencies
+node_modules
+
+# Build artifacts
+build
+.vite
+.cache
+coverage
+
+# Temporary files
+*.lock
+*.tmp
+*.swp
+*.bak
+
+# Static assets
+**/*.png
+**/*.jpg
+**/*.jpeg
+**/*.gif
+**/*.svg
+**/*.woff
+**/*.woff2
+**/*.ttf
+**/*.eot
+
+# Generated files
+**/*.d.ts
+**/generated/*
+
+# Configuration files
+package.json
+package-lock.json

package/.svelte-kit/tsconfig.json

@@ -0,0 +1,49 @@
+{
+	"compilerOptions": {
+		"paths": {
+			"$lib": [
+				"../src/lib"
+			],
+			"$lib/*": [
+				"../src/lib/*"
+			]
+		},
+		"rootDirs": [
+			"..",
+			"./types"
+		],
+		"verbatimModuleSyntax": true,
+		"isolatedModules": true,
+		"lib": [
+			"esnext",
+			"DOM",
+			"DOM.Iterable"
+		],
+		"moduleResolution": "bundler",
+		"module": "esnext",
+		"noEmit": true,
+		"target": "esnext"
+	},
+	"include": [
+		"ambient.d.ts",
+		"non-ambient.d.ts",
+		"./types/**/$types.d.ts",
+		"../vite.config.js",
+		"../vite.config.ts",
+		"../src/**/*.js",
+		"../src/**/*.ts",
+		"../src/**/*.svelte",
+		"../tests/**/*.js",
+		"../tests/**/*.ts",
+		"../tests/**/*.svelte"
+	],
+	"exclude": [
+		"../node_modules/**",
+		"../src/service-worker.js",
+		"../src/service-worker/**/*.js",
+		"../src/service-worker.ts",
+		"../src/service-worker/**/*.ts",
+		"../src/service-worker.d.ts",
+		"../src/service-worker/**/*.d.ts"
+	]
+}

package/.vscode/customData.json

@@ -0,0 +1,73 @@
+{
+  "version": 1,
+  "selectors": [
+    {
+      "name": ".fas",
+      "description": "FontAwesome v6 solid icon class"
+    },
+    {
+      "name": ".fa-solid",
+      "description": "FontAwesome old solid icon class"
+    },
+    {
+      "name": ".fab",
+      "description": "FontAwesome v6 brand icon class"
+    },
+    {
+      "name": ".fa-brands",
+      "description": "FontAwsome old brand icon class"
+    },
+    {
+      "name": ".fa-square-instagram",
+      "description": "FontAwesome brands Instagram icon class"
+    },
+    {
+      "name": ".fa-square-github",
+      "description": "FontAwesome brands GitHub icon class"
+    },
+    {
+      "name": ".fa-linkedin",
+      "description": "FontAwesome brands LinkedIn icon class"
+    },
+    {
+      "name": ".fa-square-facebook",
+      "description": "FontAwesome brands Facebook icon class"
+    },
+    {
+      "name": ".fa-mastodon",
+      "description": "FontAwesome brands Pinterest icon class"
+    },
+    {
+      "name": ".fa-arrow-up-right",
+      "description": "FontAwesome arrow up right icon class"
+    },
+    {
+      "name": ".fa-arrow-up-right-from-square",
+      "description": "FontAwesome arrow up right from square icon class"
+    },
+    {
+      "name": ".fa-file-arrow-down",
+      "description": "FontAwesome download file icon class"
+    },
+    {
+      "name": ".fa-2x",
+      "description": "FontAwesome 2x extra large icon size class"
+    },
+    {
+      "name": ".fa-lg",
+      "description": "FontAwesome large icon size class"
+    },
+    {
+      "name": ".fa-sm",
+      "description": "FontAwesome small icon size class"
+    },
+    {
+      "name": ".fa-xs",
+      "description": "FontAwesome extra small icon size class"
+    },
+    {
+      "name": ".fa-2xs",
+      "description": "FontAwesome 2x extra small icon size class"
+    }
+  ]
+}

package/.vscode/extensions.json

@@ -0,0 +1,13 @@
+{
+  "recommendations": [
+    "svelte.svelte-vscode",
+    "esbenp.prettier-vscode",
+    "dbaeumer.vscode-eslint",
+    "stylelint.vscode-stylelint",
+    "DavidAnson.vscode-markdownlint",
+    "editorconfig.editorconfig",
+    "ms-playwright.playwright",
+    "vitest.explorer",
+    "streetsidesoftware.code-spell-checker"
+  ]
+}

package/.vscode/extensions.jsonc

@@ -0,0 +1,24 @@
+/* ==========================================================================
+extensions.jsonc
+
+NOTE: This file is for reference only and is not actively used by VS Code.
+VS Code uses the extensions.json file without comments for actual 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.
+========================================================================== */
+
+{
+  "recommendations": [
+    "svelte.svelte-vscode", // Svelte language support
+    "esbenp.prettier-vscode", // Prettier formatting
+    "dbaeumer.vscode-eslint", // JavaScript/TypeScript linting
+    "stylelint.vscode-stylelint", // CSS/SASS/Svelte linting
+    "DavidAnson.vscode-markdownlint", // Markdown linting
+    "editorconfig.editorconfig", // Respect .editorconfig rules
+    "ms-playwright.playwright", // E2E testing with Playwright
+    "vitest.explorer", // Vitest test explorer panel
+    "streetsidesoftware.code-spell-checker" // Inline spell checking (comments, Markdown, etc.)
+  ]
+}