#Installation Using Composer (recommended)

If you use Composer to manage dependencies, edit your site's "composer.json"
file as follows.

1. Add the asset-packagist composer repository to "composer.json".
This allows installing packages (like Chart.js) that are published on NPM.

        "asset-packagist": {
            "type": "composer",
            "url": "https://asset-packagist.org"
        },

You may need to add it in your composer.json file like this (second item in
the array):

        "repositories": [
            {
                "type": "composer",
                "url": "https://packages.drupal.org/8"
            },
            {
                "type": "composer",
                "url": "https://asset-packagist.org"
            },
        ],

2. Run the following command to ensure that you have the
"oomphinc/composer-installers-extender" package installed. This package
facilitates the installation of any package into directories other than the
default "/vendor" (e.g. "/libraries") using Composer.

        composer require --prefer-dist oomphinc/composer-installers-extender

3. Configure composer to install the Chart.js dependencies into "/libraries"
by adding the following "installer-types" and "installer-paths" to the "extra"
section of "composer.json". If you are not using the "web" directory, then
remove "web/" from the lines below:

"extra": {
    "installer-types": ["npm-asset"],
    "installer-paths": {
        "web/libraries/chart.js": ["npm-asset/chart.js"],
        "web/libraries/chartjs-adapter-date-fns": [
          "npm-asset/chartjs-adapter-date-fns"
        ],
        "web/libraries/chartjs-plugin-datalabels": [
          "npm-asset/chartjs-plugin-datalabels"
        ],
    },
}

NOTE: If this isn't working, try instead adding:
"extra": {
    "installer-types": ["npm-asset"],
    "installer-paths": {
        ...
        "web/libraries/{$name}": ["type:drupal-library", "vendor:npm-asset"]
    },
}

4. This and the following step is optional but recommended. The reason for
them is that when installing the Chart.js package with Composer,
additional files are added into the library directory. These files are not
necessary and can be potentially harmful to your site, so it's best to remove
them. So: create a new directory in your project root called "scripts".

5. Inside that directory, create a new file called "clean-chartjs.sh" and
   paste the following into it:

        #!/usr/bin/env bash
        set -eu
        declare -a directories=(
          "web/libraries/chart.js/auto"
          "web/libraries/chart.js/helpers"
          "web/libraries/chart.js/types"
          "web/libraries/chart.js/dist/chunks"
          "web/libraries/chart.js/dist/docs"
          "web/libraries/chart.js/dist/controllers"
          "web/libraries/chart.js/dist/core"
          "web/libraries/chart.js/dist/elements"
          "web/libraries/chart.js/dist/helpers"
          "web/libraries/chart.js/dist/platform"
          "web/libraries/chart.js/dist/plugins"
          "web/libraries/chart.js/dist/scales"
          "web/libraries/chart.js/dist/types"
          "web/libraries/chartjs-plugin-datalabels/types"
        )
        counter=0
        echo "Deleting unneeded directories inside web/libraries/chartjs"
        for directory in "${directories[@]}"
          do
            if [ -d $directory ]; then
              echo "Deleting $directory"
              rm -rf $directory
              counter=$((counter+1))
            fi
          done
        echo "$counter folders were deleted"
        declare -a files=(
          "web/libraries/chart.js/README.md"
          "web/libraries/chart.js/LICENSE.md"
          "web/libraries/chart.js/package.json"
          "web/libraries/chart.js/dist/helpers.esm.js"
          "web/libraries/chart.js/dist/helpers.mjs"
          "web/libraries/chart.js/dist/chart.mjs"
          "web/libraries/chart.js/dist/chart.esm.js"
          "web/libraries/chart.js/dist/chart.cjs"
          "web/libraries/chart.js/dist/chart.cjs.map"
          "web/libraries/chart.js/dist/helpers.js"
          "web/libraries/chart.js/dist/helpers.js.map"
          "web/libraries/chart.js/dist/helpers.cjs"
          "web/libraries/chart.js/dist/helpers.cjs.map"
          "web/libraries/chart.js/dist/index.d.ts"
          "web/libraries/chart.js/dist/index.umd.d.ts"
          "web/libraries/chart.js/dist/types.d.ts"
          "web/libraries/chartjs-adapter-date-fns/README.md"
          "web/libraries/chartjs-adapter-date-fns/LICENSE.md"
          "web/libraries/chartjs-adapter-date-fns/package.json"
          "web/libraries/chartjs-adapter-date-fns/dist/chartjs-adapter-date-fns.esm.js"
          "web/libraries/chartjs-plugin-datalabels/README.md"
          "web/libraries/chartjs-plugin-datalabels/LICENSE.md"
          "web/libraries/chartjs-plugin-datalabels/package.json"
          "web/libraries/chartjs-plugin-datalabels/bower.json"
        )
        counter=0
        echo "Deleting unneeded files inside web/libraries/chartjs"
        for file in "${files[@]}"
          do
            if [[ -f $file ]]; then
              echo "Deleting $file"
              rm $file
              counter=$((counter+1))
            fi
          done
        echo "$counter files were deleted"

6. Add a "scripts" entry to your "composer.json" file as shown below. If
   "scripts" already exists, you will need to do a little more to incorporate
   the code below.

  "scripts": {
      "clean-chartjs": "chmod +x scripts/clean-chartjs.sh &&
      ./scripts/clean-chartjs.sh",
      "post-install-cmd": [
        "@clean-chartjs"
      ],
      "post-update-cmd": [
        "@clean-chartjs"
      ]
  }

7. Run the following command; you should find that new directories have been
   created under "/libraries".

    composer require --prefer-dist npm-asset/chart.js:^4.4
    npm-asset/chartjs-adapter-date-fns:^3.0
    npm-asset/chartjs-plugin-datalabels:^2.0
