@networkpro/blog 1.2.7 → 1.3.4

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": []
+}