@networkpro/blog 1.2.8 → 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

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

@@ -0,0 +1,154 @@
+# .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: Publish to Registries
+
+on:
+  workflow_dispatch:
+
+permissions:
+  actions: read
+  contents: read
+
+# Allow one concurrent deployment
+concurrency:
+  group: 'publish'
+  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: 24
+          cache: npm
+          cache-dependency-path: package-lock.json
+
+      - name: Install Node.js dependencies
+        run: npm ci
+
+      # Ensure MkDocs builds successfully
+      - 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
+
+      # Remove build artifacts
+      - name: Clean build directory
+        run: rm -rf 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-npm:
+    needs: build
+    runs-on: ubuntu-24.04
+
+    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
+
+      - name: Check for existence of package-lock.json
+        run: |
+          if [ ! -f package-lock.json ]; then
+            echo "Warning: package-lock.json not found";
+          fi
+
+      - name: Set up Git user
+        run: |
+          git config --global user.email "github@sl.neteng.cc"
+          git config --global user.name "SunDevil311"
+
+      - name: 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
+
+    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
+
+      - name: Check for existence of package-lock.json
+        run: |
+          if [ ! -f package-lock.json ]; then
+            echo "Warning: package-lock.json not found";
+          fi
+
+      - 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\/blog"/' package.json
+
+      - name: Publish package to GPR
+        run: npm publish --dry-run
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NWPRO_GPR }}

package/.github/workflows/publish.yml

@@ -0,0 +1,209 @@
+# .github/workflows/publish.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: Publish to Registries
+
+on:
+  workflow_run:
+    workflows: ['Build Site and Deploy to GH Pages']
+    types:
+      - completed
+
+permissions:
+  actions: read
+  contents: read
+
+# Allow one concurrent deployment
+concurrency:
+  group: 'publish'
+  cancel-in-progress: true
+
+# cspell:ignore userconfig
+
+jobs:
+  build:
+    if: ${{ github.event.workflow_run.conclusion == 'success' }}
+    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: 24
+          cache: npm
+          cache-dependency-path: package-lock.json
+
+      - name: Upgrade npm
+        run: |
+          corepack enable
+          npm install -g npm@11.4.1
+
+      - name: Install Node.js dependencies
+        run: npm ci
+
+      # Ensure MkDocs builds successfully
+      - 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
+
+      # Remove build artifacts
+      #- name: Clean build directory
+      #  run: rm -rf 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-npm:
+    needs: build
+    runs-on: ubuntu-24.04
+
+    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: 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: Print npm config and registry info
+        run: |
+          echo "🔍 NPM registry (from config):"
+          npm config get registry
+
+          echo "🔍 NPM user config location:"
+          echo "$NPM_CONFIG_USERCONFIG"
+
+          echo "🔍 .npmrc contents:"
+          cat "$NPM_CONFIG_USERCONFIG" || echo "❌ No .npmrc found"
+
+          echo "🔐 Token prefix:"
+          echo "${NODE_AUTH_TOKEN:0:4}********"
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_NETPRO }}
+
+      - name: Verify npm authentication
+        run: npm whoami
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_NETPRO }}
+
+      - name: Publish package to npmjs
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_NETPRO }}
+
+  publish-gpr:
+    needs: build
+    runs-on: ubuntu-24.04
+
+    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: 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\/blog"/' package.json
+
+      - name: Print npm config and registry info
+        run: |
+          echo "🔍 NPM registry (from config):"
+          npm config get registry
+
+          echo "🔍 NPM user config location:"
+          echo "$NPM_CONFIG_USERCONFIG"
+
+          echo "🔍 .npmrc contents:"
+          cat "$NPM_CONFIG_USERCONFIG" || echo "❌ No .npmrc found"
+
+          echo "🔐 Token prefix:"
+          echo "${NODE_AUTH_TOKEN:0:4}********"
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NWPRO_GPR }}
+
+      - name: Verify npm authentication
+        run: npm whoami
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NWPRO_GPR }}
+
+      - name: Publish package to GPR
+        run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NWPRO_GPR }}

package/.markdownlint.mjs

@@ -0,0 +1,32 @@
+/* ==========================================================================
+.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
+  MD025: false, // Multiple top level headers in the same document
+
+  // 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/.prettierignore

@@ -0,0 +1,38 @@
+# .prettierignore
+#
+# SPDX-License-Identifier: CC-BY-4.0 OR GPL-3.0-or-later
+# This file is part of Network Pro.
+
+# Custom ignores
+.markdownlint.jsonc
+
+
+# Node.js dependencies
+node_modules
+
+# Build artifacts
+dist
+.vite
+.cache
+coverage
+
+# Temporary files
+*.lock
+*.tmp
+*.swp
+*.bak
+
+# Static assets
+**/*.png
+**/*.jpg
+**/*.jpeg
+**/*.gif
+**/*.svg
+**/*.woff
+**/*.woff2
+**/*.ttf
+**/*.eot
+
+# Configuration files
+package.json
+package-lock.json

package/.prettierrc

@@ -0,0 +1,29 @@
+{
+  "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": "always",
+  "htmlWhitespaceSensitivity": "strict",
+  "endOfLine": "lf",
+  "embeddedLanguageFormatting": "auto",
+  "singleAttributePerLine": false,
+  "overrides": [
+    {
+      "files": "*.jsonc",
+      "options": {
+        "trailingComma": "none"
+      }
+    }
+  ]
+}

package/.stylelintignore

@@ -0,0 +1,34 @@
+# .stylelintignore
+#
+# SPDX-License-Identifier: CC-BY-4.0 OR GPL-3.0-or-later
+# This file is part of Network Pro.
+
+# 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
+
+# Configuration files
+package.json
+package-lock.json

package/.vscode/customData.json

@@ -0,0 +1,69 @@
+{
+  "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-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/settings.json

@@ -0,0 +1,40 @@
+{
+  // Editor settings
+  "editor.defaultFoldingRangeProvider": "esbenp.prettier-vscode",
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+  "[markdown]": {
+    "editor.defaultFoldingRangeProvider": "esbenp.prettier-vscode",
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[json]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[jsonc]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  // ESLint configuration
+  "eslint.workingDirectories": ["D:\\Netwk-Pro\\git\\blog"],
+  "eslint.validate": ["html", "javascript", "javascriptreact", "json", "jsonc"],
+  "eslint.lintTask.enable": true,
+  "eslint.lintTask.options": "--ext .mjs,.js,.json,.jsonc --config eslint.config.mjs .",
+  "eslint.useESLintClass": true,
+  "eslint.useFlatConfig": true,
+  "eslint.codeActionsOnSave.mode": "problems",
+  "eslint.probe": ["javascript", "javascriptreact", "html", "json", "jsonc"],
+  // Stylelint configuration
+  "stylelint.configBasedir": "D:\\Netwk-Pro\\git\\blog",
+  "stylelint.configFile": "stylelint.config.js",
+  "stylelint.customSyntax": "postcss-html",
+  "stylelint.validate": ["css", "postcss", "html"],
+  // Custom CSS data for FontAwesome classes
+  "css.customData": [
+    ".vscode/customData.json" // Path to your custom data file
+  ],
+  // Locations of CSS files for validation
+  "css.styleSheets": ["**/*.css", "src/stylesheets/*.css"],
+  "files.associations": {
+    "/img/*": "html"
+  },
+  "markdown.validate.enabled": false,
+  "markdown.validate.ignoredLinks": []
+}

package/CHANGELOG.md

@@ -16,6 +16,88 @@ formatting may vary.
 
 ---
 
+## [1.3.4] - 2025-06-23
+
+### Changed
+
+- Bumped version to `v1.3.4`.
+
+### Fixed
+
+- Removed legacy `.npmrc` file that was overriding registry authentication and
+  causing `401 Unauthorized` errors during publishing.
+- Restored default registry handling through `setup-node` for reliable
+  token-based authentication to `npmjs.org`.
+
+---
+
+## [1.3.3] - 2025-06-23
+
+### Added
+
+- Diagnostic logging to verify active registry, token configuration, and
+  `.npmrc` state prior to publishing.
+
+### Changed
+
+- Bumped version to `v1.3.3`.
+
+### Fixed
+
+- Resolved persistent authentication failure during publish by reintroducing
+  `npm ci` and upgrading npm in registry workflows.
+- Adjusted step ordering to ensure environment and Git config are fully
+  initialized before registry checks.
+
+---
+
+## [1.3.2] - 2025-06-23
+
+### Added
+
+- Authentication check (`npm whoami`) before publish to confirm registry access.
+
+### Changed
+
+- Bumped version to `v1.3.2`.
+
+### Fixed
+
+- Resolved publishing failure caused by missing lockfile and outdated npm
+  version in registry workflows.
+- Reintroduced `npm ci` and upgraded npm to ensure compatibility with scoped
+  package publishing.
+
+---
+
+## [1.3.1]
+
+### Changes
+
+- Removed `cache-dependency-path` from publish workflows to avoid
+  lockfile-related cache issues.
+- Verified presence of `package-lock.json` in the extracted archive and
+  maintained default npm caching behavior.
+- Bumped version to `v1.3.1`.
+
+---
+
+## [1.3.0]
+
+### Added
+
+- Introduced a test publish workflow (`.github/workflows/publish-test.yml`) to
+  validate the `git archive` packaging method via dry-run publishing.
+
+### Changed
+
+- Bumped version to `v1.3.0`.
+- Reformatted `.github/COMMIT_GUIDE.md` to align with Prettier conventions.
+- Refactored `.github/workflows/publish.yml` to use `git archive` for publishing
+  to registries.
+
+---
+
 ## [1.2.8] - 2025-06-23
 
 ### Added
@@ -62,6 +144,10 @@ formatting may vary.
 
 <!-- Link references -->
 
-[Unreleased]: https://github.com/netwk-pro/blog/compare/v1.2.8...HEAD
+[Unreleased]: https://github.com/netwk-pro/blog/compare/v1.3.3...HEAD
+[1.3.3]: https://github.com/netwk-pro/blog/releases/tag/v1.3.3
+[1.3.2]: https://github.com/netwk-pro/blog/releases/tag/v1.3.2
+[1.3.1]: https://github.com/netwk-pro/blog/releases/tag/v1.3.1
+[1.3.0]: https://github.com/netwk-pro/blog/releases/tag/v1.3.0
 [1.2.8]: https://github.com/netwk-pro/blog/releases/tag/v1.2.8
 [1.2.7]: https://github.com/netwk-pro/blog/releases/tag/v1.2.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@networkpro/blog",
-  "version": "1.2.8",
+  "version": "1.3.4",
   "description": "The official blog of Network Pro Strategies (Network Pro™).",
   "keywords": [
     "advisory",

package/src/.authors.yml

@@ -0,0 +1,11 @@
+authors:
+  team:
+    name: Network Pro
+    description: Creator
+    avatar: https://avatars.githubusercontent.com/u/170266279
+    url: https://netwk.pro/
+  SunDevil311:
+    name: Scott Lopez
+    description: Creator
+    avatar: https://avatars.githubusercontent.com/u/10506001
+    url: https://github.com/SunDevil311

package/src/posts/drafts/.meta.yml

@@ -0,0 +1 @@
+draft: true