Initial Implementation

.github/renovate.json5

@@ -0,0 +1,73 @@
+// Docs:
+// https://docs.renovatebot.com/configuration-options/
+{
+  "extends": [
+    "config:base",
+    ":semanticCommits"
+  ],
+  "automerge": true,
+  "masterIssue": true,
+  // bump for apps
+  // update-lockfile for addons/libraries
+  "rangeStrategy": "update-lockfile",
+  // From the docs:
+  // https://docs.renovatebot.com/configuration-options/#packagerules
+  // Important to know: Renovate will evaluate all packageRules and not stop once it gets a first match.
+  // Therefore, you should order your packageRules in order of importance so that later rules can override
+  // settings from earlier rules if necessary.
+  //
+  // (so if something is to be disabled, place that rule last)
+  "packageRules": [
+    ////////////////////////////////////////
+    // Grouping namespaced packages together
+    //
+    // This reduces overall PR count
+    ////////////////////////////////////////
+    {
+      "groupName": "Lint Dependencies",
+      "schedule": ["after 9pm on sunday"],
+      "packageNames": [
+        "eslint",
+        "babel-eslint",
+        "ember-template-lint",
+        "prettier"
+      ],
+      "packagePatterns": [
+        "eslint-plugin-.*",
+        "eslint-config-.*",
+        ".*typescript-eslint.*",
+        "^@commitlint\/*",
+        "^remark-*"
+      ]
+    },
+    {
+      "groupName": "HTML Packages",
+      "schedule": ["after 9pm on sunday"],
+      "packageNames": [
+        "rehype",
+        "unified"
+      ],
+      "packagePatterns": [
+        "rehype-.*",
+        "unist-*"
+      ]
+    },
+    {
+      "groupName": "Testing Dependencies",
+      "schedule": ["after 9pm on sunday"],
+      "packageNames": [
+      ]
+    },
+    {
+      // changing peerDependencies *at all* is a breaking change
+      "matchDepTypes": ["peerDependencies"],
+      "enabled": false
+    },
+    {
+      // changing engines forces other people to need to upgrade their minimum node
+      // therefor engine changes are breaking changes
+      "depTypeList": ["engines"],
+      "enabled": false
+    }
+  ]
+}

.github/workflows/ci.yml

@@ -0,0 +1,87 @@
+name: "CI"
+on:
+  pull_request:
+  push:
+    # filtering branches here prevents duplicate builds from pull_request and push
+    branches:
+      - main
+      - master
+
+env:
+  CI: true
+  CACHE_PATH: '**/node_modules'
+
+jobs:
+  install_dependencies:
+    name: Install Dependencies
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+
+    steps:
+    - uses: actions/checkout@v2
+    - uses: volta-cli/action@v1
+    - uses: actions/cache@v2
+      with:
+        path: ${{ env.CACHE_PATH }}
+        key: ${{ runner.os }}-modules-${{ hashFiles('**/yarn.lock') }}
+        restore-keys: "${{ runner.os }}-modules-"
+    - run: yarn install
+
+  tests:
+    name: "Tests"
+    runs-on: ubuntu-latest
+    needs: [install_dependencies]
+
+    steps:
+      - uses: actions/checkout@v2
+      - uses: volta-cli/action@v1
+      - uses: actions/[email protected]
+        with:
+          path: ${{ env.CACHE_PATH }}
+          key: ${{ runner.os }}-modules-${{ hashFiles('**/yarn.lock') }}
+      - run: |
+          yarn install
+          yarn global add ember-cli
+      - name: Tests
+        run: yarn test
+
+  # tooling:
+  #   name: Tooling
+  #   runs-on: ubuntu-latest
+  #   if: github.ref != 'refs/heads/main'
+  #   timeout-minutes: 2
+  #   needs: [install_dependencies]
+
+  #   steps:
+  #     - uses: actions/checkout@v2
+  #     - uses: volta-cli/action@v1
+  #     - uses: actions/[email protected]
+  #       with:
+  #         path: ${{ env.CACHE_PATH }}
+  #         key: ${{ runner.os }}-modules-${{ hashFiles('**/yarn.lock') }}
+
+  #     - run: yarn install
+  #     - name: Semantic Release
+  #       run: yarn publish:dry-run
+  #       env:
+  #         NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+  #         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  publish:
+    name: Release
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main'
+    needs: [tests]
+
+    steps:
+      - uses: actions/checkout@v2
+        with:
+          persist-credentials: false
+      - uses: volta-cli/action@v1
+      - run: yarn install
+
+      - name: Release
+        run: yarn publish
+        env:
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/quality.yml

@@ -0,0 +1,74 @@
+name: "Quality"
+on:
+  pull_request:
+  push:
+    # filtering branches here prevents duplicate builds from pull_request and push
+    branches:
+      - main
+      - master
+
+env:
+  CI: true
+  CACHE_PATH: '**/node_modules'
+
+jobs:
+  install_dependencies:
+    name: Install Dependencies
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+
+    steps:
+    - uses: actions/checkout@v2
+    - uses: volta-cli/action@v1
+    - uses: actions/cache@v2
+      with:
+        path: ${{ env.CACHE_PATH }}
+        key: ${{ runner.os }}-modules-${{ hashFiles('**/yarn.lock') }}
+        restore-keys: "${{ runner.os }}-modules-"
+    - run: yarn install
+
+  lint_source:
+    name: Lint Source
+    runs-on: ubuntu-latest
+    needs: [install_dependencies]
+
+    steps:
+      - uses: actions/checkout@v2
+      - uses: volta-cli/action@v1
+      - uses: actions/[email protected]
+        with:
+          path: ${{ env.CACHE_PATH }}
+          key: ${{ runner.os }}-modules-${{ hashFiles('**/yarn.lock') }}
+      - run: yarn install
+      - name: Lints
+        run: yarn lint
+
+  commits:
+    name: Commit Messages
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+      with:
+        fetch-depth: 0
+
+    - uses: volta-cli/action@v1
+    - uses: wagoid/[email protected]
+
+  # types:
+  #   name: "Type Correctness"
+  #   runs-on: ubuntu-latest
+  #   timeout-minutes: 2
+  #   needs: [install_dependencies]
+
+  #   steps:
+  #   - uses: actions/checkout@v2
+  #   - uses: volta-cli/action@v1
+  #   - uses: actions/cache@v2
+  #     with:
+  #       path: ${{ env.CACHE_PATH }}
+  #       key: ${{ runner.os }}-modules-${{ hashFiles('**/yarn.lock') }}
+  #   - run: yarn install
+  #   # running with yarn causes tsc to hang
+  #   - run: tsc --build --clean && tsc --build
+  #     continue-on-error: true

.gitignore

@@ -1,2 +1,7 @@
 node_modules/
+declarations/
 yarn-error.log
+.turbo
+/out/
+coverage/
+tsconfig.tsbuildinfo

CONTRIBUTING.md

@@ -0,0 +1,16 @@
+# How To Contribute
+
+## Installation
+
+* `git clone <repository-url>`
+* `cd ember-apply`
+* `yarn install`
+
+## Linting
+
+* `yarn lint`
+
+## Running tests
+
+tbd
+

LICENSE.md

@@ -0,0 +1,9 @@
+The MIT License (MIT)
+
+Copyright (c) 2021
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

README.md

@@ -0,0 +1,96 @@
+# ember-apply
+
+_Automatic integration and configuration from the community._
+
+This is a collection of recommended configurations provided via
+transformation (codemods and other utilities) that work both on
+existing apps as well as new apps to help make setting things
+up a bit easier.
+
+## Usage
+
+```shell
+npx ember-apply <feature-name>
+```
+
+where `<feature-name>` is one of the following:
+
+### `tailwind`
+
+```shell
+npx ember-apply tailwind
+```
+
+_Automates the steps from [Tailwind's installation docs](https://tailwindcss.com/docs/installation)_
+
+Known working capabilities:
+ - JIT
+ - Rebuilding during development
+
+### `ssr`
+
+implementation tbd (pr's welcome!)
+
+```shell
+npx ember-apply ssr
+```
+
+Known working capabilities:
+ - tbd
+
+### any package published as ESM with a default export
+
+when using a package name for the `<feature-name>`, an ESM version of the package
+will attempt to be loaded and used, invoking the default export.
+```shell
+npx ember-apply @scope/feature-name
+```
+
+## Adding a new applyable
+
+- clone this repository
+- create a `applyables/<your-applyable>/index.js` file
+- have a function exported as the default export.
+  within this function, you may import form `ember-apply` to use any of the utility functions.
+  the only argument passed to this function is the working directory `npx ember-apply` was invoked from.
+  how the `<your-applyable>` folder is managed is totally up to whomever implements and maintains that code.
+
+### For Transforming JS
+
+[JSCodeShift](https://github.com/facebook/jscodeshift) is used
+
+### For Transforming Ember Templates
+
+[ember-template-recast](https://github.com/ember-template-lint/ember-template-recast) is used
+
+### For Transforming HTML
+
+[rehype](https://github.com/rehypejs/rehype) is used
+
+## Public API
+
+While these public APIs aren't "needed", and could indeed be used with ember's blueprint system, or some other ecosystem
+
+### `transformScript`
+### `transformTemplate`
+### `transformHTML`
+### `addHTML`
+### `gitIgnore`
+### `addScript`
+### `addScripts`
+### `applyFolder`
+### `copyFileTo`
+
+
+## Related Projects
+
+- [preset](https://github.com/preset/preset)
+    GOAL (tbd): be compatible with `npx apply`
+
+    - `preset` does not provide codemodding tools, but
+      it does provide basic pattern-based transforming
+      utilities, so it's a solid option. It also does
+      not have built-in support for template transforms.
+    - currently, `preset` forces the install of `esbuild` which fails due to having the security feature `ignore-scripts` enabled, so `preset` is a non-option for folks who care
+      about security. (or who don't mind adding an allow-list for `preset`)
+

commitlint.config.js

@@ -0,0 +1,18 @@
+'use strict';
+
+module.exports = {
+  extends: ['@commitlint/config-conventional'],
+  // https://commitlint.js.org/#/reference-rules
+  // Level [0..2]: 0 disables the rule. For 1 it will be considered a warning for 2 an error.
+  // Applicable always|never: never inverts the rule.
+  // Value: value to use for this rule.
+  rules: {
+    // 72, the default, is a little short
+    'header-max-length': [1, 'always', 100],
+    // Let people use caps
+    'header-case': [0],
+    // Let people write  sentences
+    'header-full-stop': [0],
+    'subject-case': [0],
+  },
+};