aberlaas-init 2.10.0

package/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) Tim Carry (tim@pixelastic.com)
+
+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.

package/lib/helper.js

@@ -0,0 +1,193 @@
+import path from 'path';
+import Gilmore from 'gilmore';
+import {
+  absolute,
+  copy,
+  error as firostError,
+  isFile,
+  move,
+  read,
+  write,
+} from 'firost';
+import { _ } from 'golgoth';
+import helper from 'aberlaas-helper';
+import { nodeVersion, yarnVersion } from 'aberlaas-versions';
+
+/**
+ * This hold functions shared for both the monorepo and simple init scenarios
+ */
+export default {
+  /**
+   * Return name of the current project, as the name of the current directory
+   * @returns {string} Name of the project
+   */
+  getProjectName() {
+    return path.basename(helper.hostRoot());
+  },
+
+  /**
+   * Return the name of the current author based on the GitHub project owner
+   * @returns {string} Name of the author, or __placeholder__ if undefined
+   */
+  async getProjectAuthor() {
+    const repo = this.__getRepo();
+    return (await repo.githubRepoOwner()) || '__placeholder__';
+  },
+
+  /**
+   * Copy a config template to the host
+   * @param {string} source Path to source file, relative to ./templates folder
+   * @param {string} destination Path to destination file, relative to the host
+   * @returns {boolean} False if can't copy file, true otherwise
+   */
+  async copyTemplateToHost(source, destination) {
+    const absoluteSource = absolute('../templates/', source);
+    const absoluteDestination = helper.hostPath(destination);
+
+    // Source file does not exist
+    if (!(await isFile(absoluteSource))) {
+      throw firostError(
+        'ERROR_INIT_COPY_FILE',
+        `Unable to locate ${absoluteSource} file`,
+      );
+    }
+    // Destination file already exist
+    if (await isFile(absoluteDestination)) {
+      // Do nothing if content is already the same
+      const sourceContent = await read(absoluteSource);
+      const destinationContent = await read(absoluteDestination);
+      if (sourceContent === destinationContent) {
+        return true;
+      }
+
+      // Otherwise create a backup
+      const backupDestination = `${absoluteDestination}.backup`;
+      await move(absoluteDestination, backupDestination);
+    }
+
+    await copy(absoluteSource, absoluteDestination);
+
+    return true;
+  },
+
+  /**
+   * Add MIT license file
+   * @param {string} hostFilepath Path to the LICENSE file, relative to the host
+   */
+  async addLicenseFile(hostFilepath) {
+    // Start by adding a template
+    await this.copyTemplateToHost('LICENSE', hostFilepath);
+
+    // Replace placeholder with real value
+    const licensePath = helper.hostPath(hostFilepath);
+    const author = await this.getProjectAuthor();
+    const templateContent = await read(licensePath);
+    const actualContent = _.replace(templateContent, '{author}', author);
+
+    // Write it again
+    await write(actualContent, licensePath);
+  },
+
+  /**
+   * Add CircleCI Config file
+   */
+  async addCircleCIConfigFile() {
+    const configFilepath = helper.hostPath('./.circleci/config.yml');
+
+    // Start by adding a template
+    await this.copyTemplateToHost('_circleci/config.yml', configFilepath);
+
+    // Replace placeholder with real value
+    const templateContent = await read(configFilepath);
+    const actualContent = _.chain(templateContent)
+      .replace('{nodeVersion}', nodeVersion)
+      .replace('{yarnVersion}', yarnVersion)
+      .value();
+
+    // Write it again
+    await write(actualContent, configFilepath);
+  },
+
+  /**
+   * Add default script files
+   */
+  async addScripts() {
+    // Common
+    await this.copyTemplateToHost('scripts/ci', 'scripts/ci');
+    await this.copyTemplateToHost('scripts/compress', 'scripts/compress');
+    await this.copyTemplateToHost('scripts/lint', 'scripts/lint');
+    await this.copyTemplateToHost('scripts/lint-fix', 'scripts/lint-fix');
+
+    // Hooks
+    await this.copyTemplateToHost(
+      './scripts/hooks/pre-commit',
+      './scripts/hooks/pre-commit',
+    );
+
+    // Lib
+    await this.copyTemplateToHost('scripts/lib/release', 'scripts/lib/release');
+    await this.copyTemplateToHost('scripts/lib/test', 'scripts/lib/test');
+    await this.copyTemplateToHost(
+      'scripts/lib/test-watch',
+      'scripts/lib/test-watch',
+    );
+  },
+
+  /**
+   * Add config files to the host. Each config files reference the default
+   * aberlaas config for its tool. This pattern allow end-users to use aberlaas
+   * default rules and overwrite them as they see fit
+   */
+  async addConfigFiles() {
+    // Git
+    await this.copyTemplateToHost('./_gitignore', './.gitignore');
+    await this.copyTemplateToHost('./_gitattributes', './.gitattributes');
+
+    // Yarn
+    await this.copyTemplateToHost('_yarnrc.yml', '.yarnrc.yml');
+
+    // ESLint
+    await this.copyTemplateToHost('eslint.config.js', 'eslint.config.js');
+
+    // Lint-staged
+    await this.copyTemplateToHost(
+      'lintstaged.config.js',
+      'lintstaged.config.js',
+    );
+
+    // Vite
+    await this.copyTemplateToHost('vite.config.js', 'vite.config.js');
+
+    // Prettier
+    await this.copyTemplateToHost('prettier.config.js', 'prettier.config.js');
+
+    // Stylelint
+    await this.copyTemplateToHost('stylelint.config.js', 'stylelint.config.js');
+
+    // Renovate
+    await this.copyTemplateToHost(
+      '_github/renovate.json',
+      '.github/renovate.json',
+    );
+
+    // CircleCI
+    await this.copyTemplateToHost(
+      '_circleci/config.yml',
+      '.circleci/config.yml',
+    );
+  },
+
+  /**
+   * Add default files required to have the minimum lib module
+   */
+  async addLibFiles() {
+    await this.copyTemplateToHost('lib/main.js', 'lib/main.js');
+    await this.copyTemplateToHost(
+      'lib/__tests__/main.js',
+      'lib/__tests__/main.js',
+    );
+  },
+  __getRepo() {
+    return new Gilmore(helper.hostRoot());
+  },
+};

package/lib/main.js

@@ -0,0 +1,59 @@
+import { consoleInfo, run, spinner, write } from 'firost';
+
+import Gilmore from 'gilmore';
+import helper from 'aberlaas-helper';
+import { nodeVersion } from 'aberlaas-versions';
+import initMonorepo from './monorepo.js';
+import initModule from './module.js';
+
+export default {
+  /**
+   * Configure git hooks to use scripts/hooks instead of .git/hooks
+   */
+  async configureGit() {
+    const repo = new Gilmore(helper.hostRoot());
+    await repo.setConfig('core.hooksPath', 'scripts/hooks');
+  },
+  /**
+   * Pin the node version through nvm
+   */
+  async configureNode() {
+    const nvmrcPath = helper.hostPath('.nvmrc');
+    await write(nodeVersion, nvmrcPath);
+  },
+  /**
+   * Run yarn install to install all deps
+   */
+  async yarnInstall() {
+    await run('yarn install');
+  },
+  /**
+   * Copy all config files and configure the scripts
+   * @param {object} args Argument object, as passed by minimist
+   */
+  async run(args = {}) {
+    const isMonorepo = args.monorepo;
+
+    const progress = this.__spinner();
+
+    progress.tick('Configuring Git & Node');
+    await this.configureGit();
+    await this.configureNode();
+
+    progress.tick('Adding default files ');
+
+    // Create a different scaffolding based on if creating a monorepo or not
+    isMonorepo ? await initMonorepo.run() : await initModule.run();
+
+    progress.success('aberlaas project initialized');
+
+    this.__consoleInfo('Synchronizing dependencies');
+    await this.yarnInstall();
+
+    this.__consoleInfo(
+      "Don't forget to run aberlaas setup after pushing your repository",
+    );
+  },
+  __consoleInfo: consoleInfo,
+  __spinner: spinner,
+};

package/lib/module.js

@@ -0,0 +1,105 @@
+import { writeJson } from 'firost';
+
+import { aberlaasVersion, nodeVersion, yarnVersion } from 'aberlaas-versions';
+import helper from 'aberlaas-helper';
+import initHelper from './helper.js';
+
+export default {
+  /**
+   * Create the top-level package.json
+   */
+  async createPackageJson() {
+    const name = await this.__getProjectName();
+    const version = '0.0.1';
+
+    const author = await this.__getProjectAuthor();
+    const description = '';
+    const keywords = [];
+    const repository = `${author}/${name}`;
+    const homepage = `https://projects.pixelastic.com/${name}`;
+
+    const type = 'module';
+    const license = 'MIT';
+    const engines = {
+      node: `>=${nodeVersion}`,
+    };
+    const packageManager = `yarn@${yarnVersion}`;
+
+    const files = ['*.js'];
+    const exports = {
+      '.': './main.js',
+    };
+    const main = './main.js';
+
+    const dependencies = {};
+    const devDependencies = {
+      aberlaas: aberlaasVersion,
+    };
+
+    const scripts = {
+      // Docs
+      build: './scripts/docs/build',
+      'build:prod': './scripts/docs/build-prod',
+      cms: './scripts/docs/cms',
+      serve: './scripts/docs/serve',
+      // Lib
+      release: './scripts/lib/release',
+      test: './scripts/lib/test',
+      'test:watch': './scripts/lib/test-watch',
+      // Common
+      ci: './scripts/ci',
+      compress: './scripts/compress',
+      lint: './scripts/lint',
+      'lint:fix': './scripts/lint-fix',
+    };
+
+    const packageContent = {
+      // Name and version
+      name,
+      version,
+
+      // Metadata
+      author,
+      description,
+      keywords,
+      repository,
+      homepage,
+
+      // Compatibility
+      type,
+      license,
+      engines,
+      packageManager,
+
+      // Exports
+      files,
+      exports,
+      main,
+
+      // Dependencies
+      dependencies,
+      devDependencies,
+
+      // Scripts
+      scripts,
+    };
+
+    await writeJson(packageContent, helper.hostPath('./package.json'), {
+      sort: false,
+    });
+  },
+
+  /**
+   * Scaffold a repo for use in a simple module contexte
+   */
+  async run() {
+    await this.createPackageJson();
+
+    await initHelper.addLicenseFile('LICENSE');
+    await initHelper.addConfigFiles();
+    await initHelper.addScripts();
+    await initHelper.addLibFiles();
+  },
+  __getProjectName: initHelper.getProjectName.bind(initHelper),
+  __getProjectAuthor: initHelper.getProjectAuthor.bind(initHelper),
+};

package/lib/monorepo.js

@@ -0,0 +1,264 @@
+import { writeJson } from 'firost';
+
+import helper from 'aberlaas-helper';
+import {
+  aberlaasVersion,
+  lernaVersion,
+  nodeVersion,
+  norskaThemeDocsVersion,
+  norskaVersion,
+  yarnVersion,
+} from 'aberlaas-versions';
+import initHelper from './helper.js';
+
+export default {
+  /**
+   * Create the top-level monorepo root workspace
+   */
+  async createRootWorkspace() {
+    const sharedProjectData = await this.getSharedProjectData();
+
+    const packageContent = {
+      // Visibility
+      private: true,
+      workspaces: ['docs', 'lib'],
+
+      // Name and version
+      name: `${sharedProjectData.name}-monorepo`,
+      version: '0.0.1',
+
+      // Metadata
+      author: sharedProjectData.author,
+      description: `${sharedProjectData.name} monorepo`,
+      repository: sharedProjectData.repository,
+      homepage: sharedProjectData.homepage,
+
+      // Compatibility
+      type: 'module',
+      license: sharedProjectData.license,
+      packageManager: `yarn@${yarnVersion}`,
+
+      // Exports
+
+      // Dependencies
+      dependencies: {},
+      devDependencies: {
+        aberlaas: aberlaasVersion,
+        lerna: lernaVersion,
+      },
+
+      // Scripts
+      scripts: {
+        // ==> Docs-specific
+        build: './scripts/docs/build',
+        'build:prod': './scripts/docs/build-prod',
+        cms: './scripts/docs/cms',
+        serve: './scripts/docs/serve',
+        // ==> Lib-specific
+        release: './scripts/lib/release',
+        test: './scripts/lib/test',
+        'test:watch': './scripts/lib/test-watch',
+        // Common
+        ci: './scripts/ci',
+        compress: './scripts/compress',
+        lint: './scripts/lint',
+        'lint:fix': './scripts/lint-fix',
+
+        // Global (called as aliases from any workspace)
+        // ==> Docs-specific
+        'g:build': './scripts/docs/build',
+        'g:build:prod': './scripts/docs/build-prod',
+        'g:cms': './scripts/docs/cms',
+        'g:serve': './scripts/docs/serve',
+        // ==> Lib-specific
+        'g:release': './scripts/lib/release',
+        'g:test': './scripts/lib/test',
+        'g:test:watch': './scripts/lib/test-watch',
+        // Common
+        'g:compress': './scripts/compress',
+        'g:lint': './scripts/lint',
+        'g:lint:fix': './scripts/lint-fix',
+      },
+    };
+    await writeJson(packageContent, helper.hostPath('./package.json'), {
+      sort: false,
+    });
+  },
+  /**
+   * Create the docs workspace
+   */
+  async createDocsWorkspace() {
+    const sharedProjectData = await this.getSharedProjectData();
+
+    const packageContent = {
+      // Visibility
+      private: true,
+
+      // Name & Version
+      name: `${sharedProjectData.name}-docs`,
+      version: '0.0.1',
+
+      // Metadata
+      author: sharedProjectData.author,
+      description: `${sharedProjectData.name} docs`,
+      repository: sharedProjectData.repository,
+      homepage: sharedProjectData.homepage,
+
+      // Compatibility
+      license: sharedProjectData.license,
+
+      // Exports
+
+      // Dependencies
+      dependencies: {
+        norska: norskaVersion,
+        'norska-theme-docs': norskaThemeDocsVersion,
+      },
+      devDependencies: {},
+
+      // Scripts
+      scripts: sharedProjectData.scripts,
+    };
+    await writeJson(packageContent, helper.hostPath('./docs/package.json'), {
+      sort: false,
+    });
+  },
+  /**
+   * Create the lib workspace
+   */
+  async createLibWorkspace() {
+    const sharedProjectData = await this.getSharedProjectData();
+    const engines = {
+      node: `>=${nodeVersion}`,
+    };
+
+    const packageContent = {
+      // Visibility
+      private: false,
+
+      // Name and version
+      name: sharedProjectData.name,
+      version: '0.0.1',
+
+      // Metadata
+      author: sharedProjectData.author,
+      description: '',
+      keywords: [],
+      repository: sharedProjectData.repository,
+      homepage: sharedProjectData.homepage,
+
+      // Compatibility
+      type: 'module',
+      license: sharedProjectData.license,
+      engines,
+
+      // Exports
+      files: ['*.js'],
+      exports: {
+        '.': './main.js',
+      },
+      main: './main.js',
+
+      // Dependencies
+      dependencies: {},
+      devDependencies: {},
+
+      // Scripts
+      scripts: sharedProjectData.scripts,
+    };
+    await writeJson(packageContent, helper.hostPath('./lib/package.json'), {
+      sort: false,
+    });
+  },
+  /**
+   * Add MIT license files to the repository
+   */
+  async addLicenseFiles() {
+    // One at the repo root, for GitHub
+    await initHelper.addLicenseFile('LICENSE');
+    // One in ./lib to be released with the module
+    await initHelper.addLicenseFile('lib/LICENSE');
+  },
+  /**
+   * Add config files
+   */
+  async addConfigFiles() {
+    await initHelper.addConfigFiles();
+
+    // Lerna
+    await initHelper.copyTemplateToHost('lerna.json', 'lerna.json');
+  },
+  /**
+   * Add scripts to the repo
+   */
+  async addScripts() {
+    // Common scripts
+    await initHelper.addScripts('LICENSE');
+
+    // Docs scripts
+    await initHelper.copyTemplateToHost(
+      'scripts/docs/build',
+      'scripts/docs/build',
+    );
+    await initHelper.copyTemplateToHost(
+      'scripts/docs/build-prod',
+      'scripts/docs/build-prod',
+    );
+    await initHelper.copyTemplateToHost('scripts/docs/cms', 'scripts/docs/cms');
+    await initHelper.copyTemplateToHost(
+      'scripts/docs/serve',
+      'scripts/docs/serve',
+    );
+  },
+  /**
+   * Returns shared project data, like name, author, scripts, etc
+   * @returns {object} Object of common keys
+   */
+  async getSharedProjectData() {
+    const name = await this.__getProjectName();
+    const author = await this.__getProjectAuthor();
+    const homepage = `https://projects.pixelastic.com/${name}`;
+    const repository = `${author}/${name}`;
+    const license = 'MIT';
+    const scripts = {
+      // Docs
+      build: 'ABERLAAS_CWD=$INIT_CWD yarn g:build',
+      'build:prod': 'ABERLAAS_CWD=$INIT_CWD yarn g:build:prod',
+      cms: 'ABERLAAS_CWD=$INIT_CWD yarn g:cms',
+      serve: 'ABERLAAS_CWD=$INIT_CWD yarn g:serve',
+
+      // Lib
+      release: 'ABERLAAS_CWD=$INIT_CWD yarn g:release',
+      test: 'ABERLAAS_CWD=$INIT_CWD yarn g:test',
+      'test:watch': 'ABERLAAS_CWD=$INIT_CWD yarn g:test:watch',
+
+      // Common
+      compress: 'ABERLAAS_CWD=$INIT_CWD yarn g:compress',
+      lint: 'ABERLAAS_CWD=$INIT_CWD yarn g:lint',
+      'lint:fix': 'ABERLAAS_CWD=$INIT_CWD yarn g:lint:fix',
+    };
+    return {
+      author,
+      homepage,
+      license,
+      name,
+      repository,
+      scripts,
+    };
+  },
+  /**
+   * Scaffold a repo for use in a monorepo module contexte
+   */
+  async run() {
+    await this.createRootWorkspace();
+    await this.createDocsWorkspace();
+    await this.createLibWorkspace();
+
+    await this.addLicenseFiles();
+    await this.addScripts();
+    await this.addConfigFiles();
+    await initHelper.addLibFiles();
+  },
+  __getProjectName: initHelper.getProjectName,
+  __getProjectAuthor: initHelper.getProjectAuthor.bind(initHelper),
+};

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "aberlaas-init",
+  "type": "module",
+  "description": "aberlaas init command: Setup the repository with all needed config",
+  "version": "2.10.0",
+  "repository": "pixelastic/aberlaas",
+  "homepage": "https://projects.pixelastic.com/aberlaas/",
+  "author": "Tim Carry (@pixelastic)",
+  "license": "MIT",
+  "files": [
+    "lib/*.js",
+    "templates/"
+  ],
+  "exports": {
+    ".": "./lib/main.js"
+  },
+  "main": "./lib/main.js",
+  "engines": {
+    "node": ">=18.18.0"
+  },
+  "scripts": {
+    "build": "../../scripts/local/build",
+    "build:prod": "../../scripts/local/build-prod",
+    "cms": "../../scripts/local/cms",
+    "serve": "../../scripts/local/serve",
+    "ci": "../../scripts/local/ci",
+    "release": "../../scripts/local/release",
+    "update": "node ../../scripts/meta/update.js",
+    "test:meta": "../../scripts/local/test-meta",
+    "test": "../../scripts/local/test",
+    "test:watch": "../../scripts/local/test-watch",
+    "compress": "../../scripts/local/compress",
+    "lint": "../../scripts/local/lint",
+    "lint:fix": "../../scripts/local/lint-fix"
+  },
+  "dependencies": {
+    "aberlaas-helper": "^2.10.0",
+    "aberlaas-versions": "^2.10.0",
+    "firost": "4.3.0",
+    "gilmore": "1.0.0"
+  },
+  "gitHead": "bcdaf87c198a588e02b5539c222f611e356d3079"
+}

package/templates/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) {author}
+
+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.

package/templates/_circleci/config.yml

@@ -0,0 +1,42 @@
+version: 2.1
+
+aliases:
+  - &defaults
+    docker:
+      - image: cimg/node:{nodeVersion}
+  - &restore_cache
+    restore_cache:
+      key: yarn-cache-{{ checksum "yarn.lock" }}
+  - &install_yarn
+    run:
+      name: 'Installing correct yarn version'
+      command: |
+        corepack enable --install-directory="/home/circleci/bin"
+        yarn set version {yarnVersion}
+  - &install_dependencies
+    run:
+      name: 'Installing dependencies'
+      command: 'yarn install'
+  - &save_cache
+    save_cache:
+      key: yarn-cache-{{ checksum "yarn.lock" }}
+      paths:
+        - ~/.cache/yarn
+
+jobs:
+  ci:
+    <<: *defaults
+    steps:
+      - checkout
+      - *restore_cache
+      - *install_yarn
+      - *install_dependencies
+      - *save_cache
+      - run: 'yarn run ci'
+
+workflows:
+  version: 2
+  # On every commit
+  commit:
+    jobs:
+      - ci

package/templates/_gitattributes

@@ -0,0 +1,4 @@
+/.yarn/**            linguist-vendored
+/.yarn/releases/*    binary
+/.yarn/plugins/**/*  binary
+/.pnp.*              binary linguist-generated

package/templates/_github/renovate.json

@@ -0,0 +1,3 @@
+{
+  "extends": ["config:js-lib", "aberlaas"]
+}

package/templates/_gitignore

@@ -0,0 +1,29 @@
+# Hidden files
+.DS_Store
+.envrc
+
+# Directories
+build/
+dist/
+node_modules/
+tmp/
+
+# Files
+Thumbs.db
+lerna-debug.log
+npm-debug.log
+yarn-error.log
+*~
+
+# Yarn
+# https://yarnpkg.com/getting-started/qa#which-files-should-be-gitignored
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/sdks
+!.yarn/versions
+
+
+# Netlify
+.netlify

package/templates/_yarnrc.yml

@@ -0,0 +1,15 @@
+compressionLevel: 0
+
+defaultSemverRangePrefix: ''
+
+enableGlobalCache: true
+
+# Keep old-school saving of dependencies in node_modules
+# This makes debugging imported modules so much easier
+nodeLinker: node-modules
+
+# Use hardlinks to a global cache
+nmMode: hardlinks-local
+
+# Make sure each workspace has its own local node_modules
+nmHoistingLimits: workspaces

package/templates/eslint.config.js

@@ -0,0 +1,3 @@
+import config from 'aberlaas/configs/eslint';
+
+export default [...config];

package/templates/lerna.json

@@ -0,0 +1,6 @@
+{
+  "version": "0.0.1",
+  "useWorkspaces": true,
+  "packages": ["lib", "docs"],
+  "npmClient": "yarn"
+}

package/templates/lib/__tests__/main.js

@@ -0,0 +1,13 @@
+import current from '../main.js';
+
+describe('main', () => {
+  describe('run', () => {
+    it('should pass', async () => {
+      const input = 'something';
+
+      const actual = current.run(input);
+
+      expect(actual).toBe('something');
+    });
+  });
+});

package/templates/lib/main.js

@@ -0,0 +1,5 @@
+export default {
+  run(input) {
+    return input;
+  },
+};

package/templates/lintstaged.config.js

@@ -0,0 +1,5 @@
+import config from 'aberlaas/configs/lintstaged';
+
+export default {
+  ...config,
+};

package/templates/prettier.config.js

@@ -0,0 +1,5 @@
+import config from 'aberlaas/configs/prettier';
+
+export default {
+  ...config,
+};

package/templates/scripts/ci

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -e
+
+echo "node $(node --version), yarn $(yarn --version)"
+
+aberlaas ci "$@"

package/templates/scripts/compress

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -e
+
+aberlaas compress "${@:-$INIT_CWD}"

package/templates/scripts/docs/build

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -e
+
+echo "TODO: Set a default script"

package/templates/scripts/docs/build-prod

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -e
+
+echo "TODO: Set a default script"

package/templates/scripts/docs/cms

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -e
+
+echo "TODO: Set a default script"

package/templates/scripts/docs/serve

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -e
+
+echo "TODO: Set a default script"

package/templates/scripts/hooks/pre-commit

@@ -0,0 +1,11 @@
+#!/usr/bin/env sh
+# This script *should be* automatically triggered before each git commit.
+#
+# If it doesn't work, make sure your local git repo is configured to use
+# ./scripts/hooks as the base directory for git hooks.
+#
+# If not, run:
+# $ git config core.hooksPath scripts/hooks
+set -e
+
+yarn run aberlaas precommit

package/templates/scripts/lib/release

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+set -e
+
+yarn run test
+lerna publish --yes "$@"

package/templates/scripts/lib/test

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+set -e
+
+cd ./lib
+aberlaas test "$@"

package/templates/scripts/lib/test-watch

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+set -e
+
+cd ./lib
+aberlaas test --watch "$@"

package/templates/scripts/lint

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -e
+
+aberlaas lint "${@:-$INIT_CWD}"

package/templates/scripts/lint-fix

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -e
+
+aberlaas lint --fix "${@:-$INIT_CWD}"

package/templates/stylelint.config.js

@@ -0,0 +1,5 @@
+import config from 'aberlaas/configs/stylelint';
+
+export default {
+  ...config,
+};

package/templates/vite.config.js

@@ -0,0 +1,5 @@
+import config from 'aberlaas/configs/vite';
+
+export default {
+  ...config,
+};