@networkpro/blog 1.2.7 → 1.3.4

package/.browserslistrc

@@ -0,0 +1,12 @@
+# .browserslistrc
+#
+# SPDX-License-Identifier: CC-BY-4.0 OR GPL-3.0-or-later
+# This file is part of Network Pro.
+#
+# Supported browsers
+
+defaults and fully supports es6-module
+maintained node versions
+last 2 node major versions
+last 2 versions
+not dead

package/.editorconfig

@@ -0,0 +1,60 @@
+# .editorconfig
+#
+# SPDX-License-Identifier: CC-BY-4.0 OR GPL-3.0-or-later
+# This file is part of Network Pro.
+#
+# EditorConfig helps developers define and maintain consistent
+# coding styles between different editors and IDEs
+# See http://editorconfig.org/ for full details
+
+; top-most EditorConfig file
+root = true
+
+; define basic and global for any file
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 2
+indent_style = space
+max_line_length = 80
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+; DOS/Windows batch scripts -
+[*.{bat,cmd}]
+end_of_line = crlf
+
+; Cascading Stylesheets -
+[*.css]
+indent_size = 2
+
+; HTML files -
+[*.{html,htm}]
+indent_size = 2
+
+; JavaScript files -
+[*.{mjs,js,ts}]
+curly_bracket_next_line = true
+quote_type = single
+
+; JSON files (normal and commented version) -
+[*.{json,jsonc}]
+indent_size = 2
+quote_type = double
+
+; Make - match it own default syntax
+[Makefile]
+indent_style = tab
+
+; Markdown files - preserve trail spaces that means break line
+[*.{md,markdown}]
+trim_trailing_whitespace = false
+
+; PowerShell - match defaults for New-ModuleManifest and PSScriptAnalyzer Invoke-Formatter
+[*.{ps1,psd1,psm1}]
+charset = utf-8-bom
+end_of_line = crlf
+
+; YML config files - match it own default syntax
+[*.{yaml,yml}]
+indent_size = 2

package/.gitattributes

@@ -0,0 +1,199 @@
+# .gitattributes
+#
+# SPDX-License-Identifier: CC-BY-4.0 OR GPL-3.0-or-later
+# This file is part of Network Pro.
+#
+## GITATTRIBUTES FOR WEB PROJECTS
+#
+# These settings are for any web project.
+#
+# Details per file setting:
+#   text    These files should be normalized (i.e. convert CRLF to LF).
+#   binary  These files are binary and should be left untouched.
+#
+# Note that binary is a macro for -text -diff.
+######################################################################
+
+## AUTO-DETECT
+##   Handle line endings automatically for files detected as
+##   text and leave all files detected as binary untouched.
+##   This will handle all files NOT defined below.
+* text=auto
+
+## SOURCE CODE
+*.bat            text eol=crlf
+*.coffee         text
+*.css            text
+*.htm            text
+*.html           text
+*.inc            text
+*.ini            text
+*.js             text
+*.json           text
+*.jsx            text
+*.less           text
+*.od             text
+*.onlydata       text
+*.php            text
+*.pl             text
+*.py             text
+*.rb             text
+*.sass           text
+*.scm            text
+*.scss           text
+*.sh             text eol=lf
+*.sql            text
+*.styl           text
+*.tag            text
+*.ts             text
+*.tsx            text
+*.xml            text
+*.xhtml          text
+
+## DOCKER
+*.dockerignore   text
+Dockerfile       text
+
+## DOCUMENTATION
+*.markdown       text
+*.md             text
+*.mdwn           text
+*.mdown          text
+*.mkd            text
+*.mkdn           text
+*.mdtxt          text
+*.mdtext         text
+*.txt            text
+AUTHORS          text
+CHANGELOG        text
+CHANGES          text
+CONTRIBUTING     text
+COPYING          text
+copyright        text
+*COPYRIGHT*      text
+INSTALL          text
+license          text
+LICENSE          text
+NEWS             text
+readme           text
+*README*         text
+TODO             text
+
+## TEMPLATES
+*.dot            text
+*.ejs            text
+*.haml           text
+*.handlebars     text
+*.hbs            text
+*.hbt            text
+*.jade           text
+*.latte          text
+*.mustache       text
+*.njk            text
+*.phtml          text
+*.tmpl           text
+*.tpl            text
+*.twig           text
+
+## LINTERS
+.babelrc         text
+.csslintrc       text
+.eslintrc        text
+.htmlhintrc      text
+.jscsrc          text
+.jshintrc        text
+.jshintignore    text
+.prettierrc      text
+.stylelintrc     text
+
+## CONFIGS
+*.bowerrc        text
+*.cnf            text
+*.conf           text
+*.config         text
+.browserslistrc  text
+.editorconfig    text
+.gitattributes   text
+.gitconfig       text
+.gitignore       text
+.htaccess        text
+*.npmignore      text
+*.yaml           text
+*.yml            text
+browserslist     text
+Makefile         text
+makefile         text
+
+## HEROKU
+Procfile         text
+.slugignore      text
+
+## GRAPHICS
+*.ai             binary
+*.bmp            binary
+*.eps            binary
+*.gif            binary
+*.ico            binary
+*.jng            binary
+*.jp2            binary
+*.jpg            binary
+*.jpeg           binary
+*.jpx            binary
+*.jxr            binary
+*.pdf            binary
+*.png            binary
+*.psb            binary
+*.psd            binary
+*.svg            text
+*.svgz           binary
+*.tif            binary
+*.tiff           binary
+*.wbmp           binary
+*.webp           binary
+
+## AUDIO
+*.kar            binary
+*.m4a            binary
+*.mid            binary
+*.midi           binary
+*.mp3            binary
+*.ogg            binary
+*.ra             binary
+
+## VIDEO
+*.3gpp           binary
+*.3gp            binary
+*.as             binary
+*.asf            binary
+*.asx            binary
+*.fla            binary
+*.flv            binary
+*.m4v            binary
+*.mng            binary
+*.mov            binary
+*.mp4            binary
+*.mpeg           binary
+*.mpg            binary
+*.ogv            binary
+*.swc            binary
+*.swf            binary
+*.webm           binary
+
+## ARCHIVES
+*.7z             binary
+*.gz             binary
+*.jar            binary
+*.rar            binary
+*.tar            binary
+*.zip            binary
+
+## FONTS
+*.ttf            binary
+*.eot            binary
+*.otf            binary
+*.woff           binary
+*.woff2          binary
+
+## EXECUTABLES
+*.exe            binary
+*.pyc            binary

package/.github/COMMIT_GUIDE.md

@@ -0,0 +1,34 @@
+# Commit Message Guide
+
+To maintain clarity and consistency, use one of the following commit types when
+writing messages. Keep them short and focused — the `CHANGELOG.md` remains the
+source of truth for full details.
+
+## Commit Types
+
+| Type        | Description                                                  |
+| ----------- | ------------------------------------------------------------ |
+| `feat:`     | A new feature or enhancement                                 |
+| `fix:`      | A bug fix                                                    |
+| `chore:`    | Tooling, build scripts, release prep, or other meta changes  |
+| `docs:`     | Documentation-only changes                                   |
+| `style:`    | Formatting or stylistic changes that don't affect behavior   |
+| `refactor:` | Code changes that restructure without changing functionality |
+| `test:`     | Adding or updating tests                                     |
+
+## Examples
+
+- `feat: add cryptomator entry to FOSS spotlight`
+- `fix: correct author metadata in app.html`
+- `chore: prepare v1.13.8 release`
+- `docs: update changelog for v1.13.8`
+- `style: clean up indentation in layout.svelte`
+- `refactor: split utility functions from helpers.js`
+- `test: add unit tests for buildPath util`
+
+---
+
+Stick to one type per commit when possible. For mixed changes, pick the most
+meaningful one.
+
+Consistency helps, but don’t overthink it — use what makes sense.

package/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,31 @@
+# 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
+
+blank_issues_enabled: true
+contact_links:
+  - name: 🐛 File a Bug Report
+    url: https://github.com/netwk-pro/netwk-pro.github.io/issues/new?template=bug_report.yml
+    about: Please open all bug reports in the main repository.
+
+  - name: ✨ Feature Request
+    url: https://github.com/netwk-pro/netwk-pro.github.io/issues/new?template=feature_request.yml
+    about: Suggest new or updated features in the main repository.
+
+  - name: ⚖️ Legal or Compliance Issue
+    url: https://github.com/netwk-pro/netwk-pro.github.io/issues/new?template=legal_review.yml
+    about: Raise legal or policy-related issues centrally.
+
+  - name: Ask the Community
+    url: https://discuss.neteng.pro
+    about: Join the GitHub Discussions forum to get support from the community.
+
+  - name: Stack Overflow (Internal Team)
+    url: https://stack.neteng.pro
+    about:
+      Search or post questions in our internal Stack Overflow for Teams
+      instance.
+
+  - name: Contact Network Pro
+    url: https://netwk.pro/contact?utm_source=github
+    about: Contact us directly for help or private inquiries.

package/.github/workflows/auto-assign.yml

@@ -0,0 +1,34 @@
+# .github/workflows/auto-assign.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
+#
+# This workflow will auto-assign an issue or PR to a specific user
+# when a new issue or PR is opened.
+
+name: Auto Assign
+
+on:
+  issues:
+    types: [opened]
+  pull_request:
+    types: [opened, edited, synchronize, reopened]
+
+permissions:
+  issues: write
+  contents: read
+  pull-requests: write
+
+jobs:
+  auto-assign:
+    runs-on: ubuntu-24.04
+
+    steps:
+      - name: 'Auto-assign issue or PR'
+        uses: pozil/auto-assign-issue@v2
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+          assignees: SunDevil311
+          numOfAssignee: 1
+          allowSelfAssign: true

package/.github/workflows/backup-branch.yml

@@ -0,0 +1,40 @@
+# .github/workflows/backup-branch.yml
+#
+# Syncs backup/nightly-snapshot branch with master every day at 10:00 UTC.
+# Only triggers on the default branch and not on PRs
+#
+# 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: Nightly Backup Branch Sync
+
+on:
+  schedule:
+    - cron: '0 11 * * *' # Every day at 11:00 AM UTC (4:00 AM MST)
+  workflow_dispatch: # Allow manual triggering too
+
+permissions:
+  contents: write
+
+jobs:
+  sync-backup:
+    name: Sync backup/nightly-snapshot to master
+    runs-on: ubuntu-24.04
+    if: github.ref == 'refs/heads/master' && github.event_name != 'pull_request'
+
+    steps:
+      - name: Checkout master branch
+        uses: actions/checkout@v4
+        with:
+          ref: master
+          fetch-depth: 0 # Required to push to another branch
+
+      - name: Set up Git
+        run: |
+          git config user.name "SunDevil311"
+          git config user.email "github@sl.neteng.cc"
+
+      - name: Force-push to backup/nightly-snapshot
+        run: |
+          git push --force origin HEAD:refs/heads/backup/nightly-snapshot

package/.github/workflows/build-and-deploy.yml

@@ -0,0 +1,85 @@
+# .github/workflows/build-and-deploy.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: Build Site and Deploy to GH Pages
+
+on:
+  release:
+    types: [created]
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  actions: read
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow one concurrent deployment
+concurrency:
+  group: 'pages'
+  cancel-in-progress: true
+
+jobs:
+  check-codeql:
+    uses: ./.github/workflows/check-codeql.yml
+
+  build:
+    needs: check-codeql
+    runs-on: ubuntu-24.04
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: lts/*
+          check-latest: true
+          cache: npm
+          cache-dependency-path: package-lock.json
+
+      - name: Set up Pages
+        uses: actions/configure-pages@v5
+
+      - name: Install Node.js dependencies
+        run: npm ci
+
+      # Begin Material for MkDocs setup
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: Install Python dependencies
+        run: pip install -r requirements.txt
+
+      # Strict mode disabled for mkdocs-material
+      - name: Build MkDocs documentation
+        run: mkdocs build
+
+      - name: Copy package.json to build directory
+        run: cp package.json build/
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./build
+
+  deploy:
+    needs: [check-codeql, build]
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-24.04
+
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

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

@@ -0,0 +1,40 @@
+# .github/workflows/check-codeql.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: 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/.github/workflows/dependency-review.yml

@@ -0,0 +1,21 @@
+# .github/workflows/dependency-review.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: Dependency Review
+on: [pull_request]
+
+permissions:
+  contents: read
+
+jobs:
+  dependency-review:
+    runs-on: ubuntu-24.04
+    steps:
+      - name: 'Checkout Repository'
+        uses: actions/checkout@v4
+
+      - name: 'Dependency Review'
+        uses: actions/dependency-review-action@v4