bundle.yml

#/
# @license Apache-2.0
#
# Copyright (c) 2022 The Stdlib Authors.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#    http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#/

# Workflow name:
name: bundle

# Workflow triggers:
on:
  # Allow workflow to be manually run:
  workflow_dispatch:

  # Run workflow upon completion of `productionize` workflow:
  workflow_run:
    workflows: ["productionize"]
    types: [completed]

# Workflow jobs:
jobs:

  # Define job to create a bundle for use in Deno...
  deno:

    # Define display name:
    name: 'Create Deno bundle'

    # Define the type of virtual host machine on which to run the job:
    runs-on: ubuntu-latest

    # Define the sequence of job steps...
    steps:
      # Checkout the repository:
      - name: 'Checkout repository'
        uses: actions/checkout@v3

      # Checkout production branch:
      - name: 'Checkout production branch'
        run: |
          git fetch --all
          git checkout -b production origin/production

      # Copy files to deno directory:
      - name: 'Copy files to deno directory'
        run: |
          mkdir -p deno
          cp README.md LICENSE CONTRIBUTORS NOTICE ./deno

          # Copy TypeScript definitions to deno directory:
          if [ -d index.d.ts ]; then
            cp index.d.ts ./deno/index.d.ts
          fi
          if [ -e ./docs/types/index.d.ts ]; then
            cp ./docs/types/index.d.ts ./deno/mod.d.ts
          fi

      # Install Node.js:
      - name: 'Install Node.js'
        uses: actions/setup-node@v2
        with:
          node-version: 16
        timeout-minutes: 5

      # Install dependencies:
      - name: Install production and development dependencies
        id: install
        run: |
          npm install || npm install || npm install
        timeout-minutes: 15

      # Bundle package for use in Deno:
      - name: 'Bundle package for Deno'
        id: deno-bundle
        uses: stdlib-js/bundle-action@main
        with:
          target: 'deno'

      # Rewrite file contents:
      - name: 'Rewrite file contents'
        run: |
          # Replace links to other packages with links to the deno branch:
          find ./deno -type f -name '*.md' -print0 | xargs -0 sed -Ei "/\/tree\/main/b; /^\[@stdlib[^:]+: https:\/\/github.com\/stdlib-js\// s/(.*)/\\1\/tree\/deno/";

          # Replace reference to `@stdlib/types` with CDN link:
          find ./deno -type f -name '*.ts' -print0 | xargs -0 sed -Ei "s/\/\/\/ <reference types=\"@stdlib\/types\"\/>/\/\/\/ <reference types=\"https:\/\/cdn.jsdelivr.net\/gh\/stdlib-js\/types@main\/index.d.ts\"\/>/g"

          # Change wording of project description to avoid reference to JavaScript and Node.js:
          find ./deno -type f -name '*.md' -print0 | xargs -0 sed -Ei "s/a standard library for JavaScript and Node.js, /a standard library /g"

          # Rewrite all `require()`s to use jsDelivr links:
          find ./deno -type f -name '*.md' -print0 | xargs -0 sed -Ei "/require\( '@stdlib\// {
              s/(var|let|const)\s+([a-z0-9_]+)\s+=\s*require\( '([^']+)' \);/import \2 from \'\3\';/i
              s/@stdlib/https:\/\/cdn.jsdelivr.net\/gh\/stdlib-js/
              s/';/@deno\/mod.js';/
          }"

          # Remove `installation`, `cli`, and `c` sections:
          find ./deno -type f -name '*.md' -print0 | xargs -0 perl -0777 -i -pe "s/<section class=\"installation\">[^<]+<\/section>//g;"
          find ./deno -type f -name '*.md' -print0 | xargs -0 perl -0777 -i -pe "s/(\* \* \*\n+)?<section class=\"cli\">[\s\S]+<\!\-\- \/.cli \-\->//g"
          find ./deno -type f -name '*.md' -print0 | xargs -0 perl -0777 -i -pe "s/(\* \* \*\n+)?<section class=\"c\">[\s\S]+<\!\-\- \/.c \-\->//g"

          # Create package.json file for deno branch:
          jq --indent 2 '{"name": .name, "version": .version, "description": .description, "license": .license, "type": "module", "main": "./mod.js", "homepage": .homepage, "repository": .repository, "bugs": .bugs, "keywords": .keywords, "funding": .funding}' package.json > ./deno/package.json

      # Configure git:
      - name: 'Configure git'
        run: |
          git config --local user.email "noreply@stdlib.io"
          git config --local user.name "stdlib-bot"

      # Check if remote `deno` branch exists:
      - name: 'Check if remote branch exists'
        id: deno-branch-exists
        continue-on-error: true
        run: |
          git ls-remote --exit-code --heads origin deno
          if [ $? -eq 0 ]; then
            echo "::set-output name=remote-exists::true"
          else
            echo "::set-output name=remote-exists::false"
          fi

      # If `deno` exists, checkout branch and rebase on `main`:
      - name: 'If `deno` exists, checkout branch and rebase on `main`'
        if: steps.deno-branch-exists.outputs.remote-exists
        continue-on-error: true
        run: |
          git checkout -b deno origin/deno
          git rebase main -s recursive -X ours
          while [ $? -ne 0 ]; do
            git rebase --skip
          done

      # If `deno` does not exist, checkout `main` and create `deno` branch:
      - name: 'If `deno` does not exist, checkout `main` and create `deno` branch'
        if: ${{ steps.deno-branch-exists.outputs.remote-exists == false }}
        run: |
          git checkout main
          git checkout -b deno

      # Delete everything in current directory aside from deno folder:
      - name: 'Delete everything in current directory aside from deno folder'
        run: |
          find . -type 'f' | grep -v -e "deno" -e ".git/" | xargs rm
          find . -mindepth 1 -type 'd' | grep -v -e "deno" -e ".git" | xargs rm -rf

      # Move deno directory to root:
      - name: 'Move deno directory to root'
        run: |
          mv ./deno/* .
          rmdir ./deno

      # Commit changes:
      - name: 'Commit changes'
        run: |
          git add -A
          git commit -m "Auto-generated commit"

      # Push changes:
      - name: 'Push changes'
        run: |
          SLUG=${{ github.repository }}
          echo "Pushing changes to $SLUG..."
          git push "https://$GITHUB_ACTOR:$GITHUB_TOKEN@github.com/$SLUG.git" deno --force

      # Send status to Slack channel if job fails:
      - name: 'Send status to Slack channel in case of failure'
        uses: act10ns/slack@v1
        with:
          status: ${{ job.status }}
          steps: ${{ toJson(steps) }}
          channel: '#npm-ci'
        if: failure()

  # Define job to create a UMD bundle...
  umd:

    # Define display name:
    name: 'Create UMD bundle'

    # Define the type of virtual host machine on which to run the job:
    runs-on: ubuntu-latest

    # Define the sequence of job steps...
    steps:
      # Checkout the repository:
      - name: 'Checkout repository'
        uses: actions/checkout@v3

      # Checkout production branch:
      - name: 'Checkout production branch'
        run: |
          git fetch --all
          git checkout -b production origin/production

      # Copy files to umd directory:
      - name: 'Copy files to umd directory'
        run: |
          mkdir -p umd
          cp README.md LICENSE CONTRIBUTORS NOTICE ./umd

      # Install Node.js
      - name: 'Install Node.js'
        uses: actions/setup-node@v2
        with:
          node-version: 16
        timeout-minutes: 5

      # Install dependencies:
      - name: 'Install production and development dependencies'
        id: install
        run: |
          npm install || npm install || npm install
        timeout-minutes: 15

      # Extract alias:
      - name: 'Extract alias'
        id: extract-alias
        run: |
          alias=$(grep -E 'require\(' README.md | head -n 1 |  sed -E 's/^var ([a-zA-Z0-9_]+) = .+/\1/')
          echo "::set-output name=alias::${alias}"

      # Create Universal Module Definition (UMD) bundle:
      - name: 'Create Universal Module Definition (UMD) bundle'
        id: umd-bundle
        uses: stdlib-js/bundle-action@main
        with:
          target: 'umd'
          alias: ${{ steps.extract-alias.outputs.alias }}

      # Rewrite file contents:
      - name: 'Rewrite file contents'
        run: |

          # Replace links to other packages with links to the umd branch:
          find ./umd -type f -name '*.md' -print0 | xargs -0 sed -Ei "/\/tree\/main/b; /^\[@stdlib[^:]+: https:\/\/github.com\/stdlib-js\// s/(.*)/\\1\/tree\/umd/";

          # Remove `installation`, `cli`, and `c` sections:
          find ./umd -type f -name '*.md' -print0 | xargs -0 perl -0777 -i -pe "s/<section class=\"installation\">[^<]+<\/section>//g;"
          find ./umd -type f -name '*.md' -print0 | xargs -0 perl -0777 -i -pe "s/(\* \* \*\n+)?<section class=\"cli\">[\s\S]+<\!\-\- \/.cli \-\->//g"
          find ./umd -type f -name '*.md' -print0 | xargs -0 perl -0777 -i -pe "s/(\* \* \*\n+)?<section class=\"c\">[\s\S]+<\!\-\- \/.c \-\->//g"

          # Rewrite first `require()` to show consumption of the UMD bundle in Observable and via a `script` tag:
          find ./umd -type f -name '*.md' -print0 | xargs -0 perl -0777 -i -pe "s/\`\`\`javascript\n(var|let|const)\s+([a-zA-Z0-9_]+)\s+=\s*require\( '\@stdlib\/([^']+)' \);\n\`\`\`/To use in Observable,\n\n\`\`\`javascript\n\2 = require\( 'https:\/\/cdn.jsdelivr.net\/gh\/stdlib-js\/\3\@umd\/bundle.js' \)\n\`\`\`\n\nTo include the bundle in a webpage,\n\n\`\`\`html\n<script type=\"text\/javascript\" src=\"https:\/\/cdn.jsdelivr.net\/gh\/stdlib-js\/\3\@umd\/bundle.js\"><\/script>\n\`\`\`\n\nIf no recognized module system is present, access bundle contents via the global scope:\n\n\`\`\`html\n<script type=\"text\/javascript\">\n    window.\2;\n<\/script>\n\`\`\`/"

          # Rewrite examples section to be a HTML file:
          find ./umd -type f -name '*.md' -print0 | xargs -0 perl -0777 -i -pe "s/\#\# Examples([\s\S]*)\`\`\`javascript([\s\S]+?)\`\`\`/\#\# Examples\1\`\`\`html\n<\!DOCTYPE html>\n<html lang=\"en\">\n<body>\n<script type=\"text\/javascript\">\2\n<\/script>\n<\/body>\n<\/html>\n\`\`\`/"

          # Rewrite all `require()`s in the examples section as `script` tags loading the respective UMD bundle:
          find ./umd -type f -name '*.md' -print0 | xargs -0 perl -0777 -i -pe "1 while s/<script type=\"text\/javascript\">\n(var|let|const)\s+([a-zA-Z0-9_]+)\s+=\s*require\( '\@stdlib\/([^']+)' \);?/<script type=\"text\/javascript\" src=\"https:\/\/cdn.jsdelivr.net\/gh\/stdlib-js\/\3\@umd\/bundle.js\"><\/script>\n<script type=\"text\/javascript\">/g"

          # Wrap contents of `<script type="text/javascript">` tag contents in an IIFE:
          find ./umd -type f -name '*.md' -print0 | xargs -0 perl -0777 -i -pe "s/<script type=\"text\/javascript\">([\s\S]+?)<\/script>/<script type=\"text\/javascript\">\n\(function \(\) {\1}\)\(\);\n<\/script>/g"

          # Create package.json file for umd branch:
          jq --indent 2 '{"name": .name, "version": .version, "description": .description, "license": .license, "main": "./bundle.js", "homepage": .homepage, "repository": .repository, "bugs": .bugs, "keywords": .keywords, "funding": .funding}' package.json > ./umd/package.json

      # Configure git:
      - name: 'Configure git'
        run: |
          git config --local user.email "noreply@stdlib.io"
          git config --local user.name "stdlib-bot"

      # Check if remote `umd` branch exists:
      - name: 'Check if remote `umd` branch exists'
        id: umd-branch-exists
        continue-on-error: true
        run: |
          git ls-remote --exit-code --heads origin umd
          if [ $? -eq 0 ]; then
            echo "::set-output name=remote-exists::true"
          else
            echo "::set-output name=remote-exists::false"
          fi

      # If `umd` exists, checkout branch and rebase on `main`:
      - name: 'If `umd` exists, checkout branch and rebase on `main`'
        if: steps.umd-branch-exists.outputs.remote-exists
        continue-on-error: true
        run: |
          git checkout -b umd origin/umd
          git rebase main -s recursive -X ours
          while [ $? -ne 0 ]; do
            git rebase --skip
          done

      # If `umd` does not exist, checkout `main` and create `umd` branch:
      - name: 'If `umd` does not exist, checkout `main` and create `umd` branch'
        if: ${{ steps.umd-branch-exists.outputs.remote-exists == false }}
        run: |
          git checkout main
          git checkout -b umd

      # Delete everything in current directory aside from umd folder:
      - name: 'Delete everything in current directory aside from umd folder'
        run: |
          find . -type 'f' | grep -v -e "umd" -e ".git/" | xargs rm
          find . -mindepth 1 -type 'd' | grep -v -e "umd" -e ".git" | xargs rm -rf

      # Move umd directory to root:
      - name: 'Move umd directory to root'
        run: |
          mv ./umd/* .
          rmdir ./umd

      # Commit changes:
      - name: 'Commit changes'
        run: |
          git add -A
          git commit -m "Auto-generated commit"

      # Push changes:
      - name: 'Push changes'
        run: |
          SLUG=${{ github.repository }}
          echo "Pushing changes to $SLUG..."
          git push "https://$GITHUB_ACTOR:$GITHUB_TOKEN@github.com/$SLUG.git" umd --force

      # Send status to Slack channel if job fails:
      - name: 'Send status to Slack channel in case of failure'
        uses: act10ns/slack@v1
        with:
          status: ${{ job.status }}
          steps: ${{ toJson(steps) }}
          channel: '#npm-ci'
        if: failure()

  # Define job to create ES module build...
  esm:

    # Define display name:
    name: 'Create ES module build'

    # Define the type of virtual host machine on which to run the job:
    runs-on: ubuntu-latest

    # Define the sequence of job steps...
    steps:
      # Checkout the repository:
      - name: 'Checkout repository'
        uses: actions/checkout@v3

      # Checkout production branch:
      - name: 'Checkout production branch'
        run: |
          git fetch --all
          git checkout -b production origin/production

      # Copy files to umd directory:
      - name: 'Copy files to umd directory'
        run: |
          mkdir -p esm
          cp README.md LICENSE CONTRIBUTORS NOTICE ./esm

          # Copy TypeScript definitions to esm directory:
          if [ -e ./docs/types/index.d.ts ]; then
            cp ./docs/types/index.d.ts ./esm/index.d.ts
          fi
          if [ -d index.d.ts ]; then
            cp index.d.ts ./esm/index.d.ts
          fi

      # Install Node.js:
      - name: 'Install Node.js'
        uses: actions/setup-node@v2
        with:
          node-version: 16
        timeout-minutes: 5

      # Install dependencies:
      - name: 'Install production and development dependencies'
        id: install
        run: |
          npm install || npm install || npm install
        timeout-minutes: 15

      # Create ES Module (ESM) bundle:
      - name: 'Create ES Module (ESM) bundle'
        id: esm-bundle
        uses: stdlib-js/bundle-action@main
        with:
          target: 'esm'

      # Rewrite file contents:
      - name: 'Rewrite file contents'
        run: |

          # Replace links to other packages with links to the esm branch:
          find ./esm -type f -name '*.md' -print0 | xargs -0 sed -Ei "/\/tree\/main/b; /^\[@stdlib[^:]+: https:\/\/github.com\/stdlib-js\// s/(.*)/\\1\/tree\/esm/";

          # Replace reference to `@stdlib/types` with esm link:
          find ./esm -type f -name '*.ts' -print0 | xargs -0 sed -Ei "s/\/\/\/ <reference types=\"@stdlib\/types\"\/>/\/\/\/ <reference types=\"https:\/\/cdn.jsdelivr.net\/gh\/stdlib-js\/types@esm\/index.d.ts\"\/>/g"

          # Change wording of project description to avoid reference to JavaScript and Node.js:
          find ./esm -type f -name '*.md' -print0 | xargs -0 sed -Ei "s/a standard library for JavaScript and Node.js, /a standard library /g"

          # Rewrite all `require()`s to use jsDelivr links:
          find ./esm -type f -name '*.md' -print0 | xargs -0 sed -Ei "/require\( '@stdlib\// {
              s/(var|let|const)\s+([a-z0-9_]+)\s+=\s*require\( '([^']+)' \);/import \2 from \'\3\';/i
              s/@stdlib/https:\/\/cdn.jsdelivr.net\/gh\/stdlib-js/
              s/';/@esm\/index.mjs';/
          }"

          # Remove `installation`, `cli`, and `c` sections:
          find ./esm -type f -name '*.md' -print0 | xargs -0 perl -0777 -i -pe "s/<section class=\"installation\">[^<]+<\/section>//g;"
          find ./esm -type f -name '*.md' -print0 | xargs -0 perl -0777 -i -pe "s/(\* \* \*\n+)?<section class=\"cli\">[\s\S]+<\!\-\- \/.cli \-\->//g"
          find ./esm -type f -name '*.md' -print0 | xargs -0 perl -0777 -i -pe "s/(\* \* \*\n+)?<section class=\"c\">[\s\S]+<\!\-\- \/.c \-\->//g"

          # Rewrite examples section to be a HTML file:
          find ./esm -type f -name '*.md' -print0 | xargs -0 perl -0777 -i -pe "s/\#\# Examples([\s\S]*)\`\`\`javascript([\s\S]+?)\`\`\`/\#\# Examples\1\`\`\`html\n<\!DOCTYPE html>\n<html lang=\"en\">\n<body>\n<script type=\"module\">\n\2\n<\/script>\n<\/body>\n<\/html>\n\`\`\`/g"

          # Create package.json file for esm branch:
          jq --indent 2 '{"name": .name, "version": .version, "description": .description, "license": .license, "type": "module", "main": "./index.mjs", "homepage": .homepage, "repository": .repository, "bugs": .bugs, "keywords": .keywords, "funding": .funding}' package.json > ./esm/package.json

      # Configure git:
      - name: 'Configure git'
        run: |
          git config --local user.email "noreply@stdlib.io"
          git config --local user.name "stdlib-bot"

      # Check if remote `esm` branch exists:
      - name: 'Check if remote `esm` branch exists'
        id: esm-branch-exists
        continue-on-error: true
        run: |
          git ls-remote --exit-code --heads origin esm
          if [ $? -eq 0 ]; then
            echo "::set-output name=remote-exists::true"
          else
            echo "::set-output name=remote-exists::false"
          fi

      # If `esm` exists, checkout branch and rebase on `main`:
      - name: 'If `esm` exists, checkout branch and rebase on `main`'
        if: steps.esm-branch-exists.outputs.remote-exists
        continue-on-error: true
        run: |
          git checkout -b esm origin/esm
          git rebase main -s recursive -X ours
          while [ $? -ne 0 ]; do
            git rebase --skip
          done

      # If `esm` does not exist, checkout `main` and create `esm` branch:
      - name: 'If `esm` does not exist, checkout `main` and create `esm` branch'
        if: ${{ steps.esm-branch-exists.outputs.remote-exists == false }}
        run: |
          git checkout main
          git checkout -b esm

      # Delete everything in current directory aside from esm folder:
      - name: 'Delete everything in current directory aside from esm folder'
        run: |
          find . -type 'f' | grep -v -e "esm" -e ".git/" | xargs rm
          find . -mindepth 1 -type 'd' | grep -v -e "esm" -e ".git" | xargs rm -rf

      # Move esm directory to root:
      - name: 'Move esm directory to root'
        run: |
          mv ./esm/* .
          rmdir ./esm

      # Commit changes:
      - name: 'Commit changes'
        run: |
          git add -A
          git commit -m "Auto-generated commit"

      # Push changes to `esm` branch:
      - name: 'Push changes'
        run: |
          SLUG=${{ github.repository }}
          echo "Pushing changes to $SLUG..."
          git push "https://$GITHUB_ACTOR:$GITHUB_TOKEN@github.com/$SLUG.git" esm --force

      # Send status to Slack channel if job fails:
      - name: 'Send status to Slack channel in case of failure'
        uses: act10ns/slack@v1
        with:
          status: ${{ job.status }}
          steps: ${{ toJson(steps) }}
          channel: '#npm-ci'
        if: failure()