Scaffold

.editorconfig

@@ -0,0 +1,11 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false

.github/ISSUE_TEMPLATE/bug_report.yaml

@@ -0,0 +1,52 @@
+name: Bug Report
+description: File a bug report
+title: "[Bug]: "
+labels:
+  - bug
+  - triage
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this bug report!
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened?
+      description: Please tell us, what did you expect to happen?
+      placeholder: Tell us what you see!
+      value: A bug happened!
+    validations:
+      required: true
+  - type: textarea
+    id: version
+    attributes:
+      label: Version
+      description: What version of the library are you running?
+      placeholder: 0.0.0
+    validations:
+      required: true
+  - type: dropdown
+    id: platform
+    attributes:
+      label: On which platform(s) do you have the issue ?
+      multiple: true
+      options:
+        - Any
+        - Node.js
+        - Typescript node
+        - Firefox
+        - Chrome
+        - Safari
+        - Microsoft Edge
+        - Linux
+        - Windows
+        - MacOs
+        - Other
+  - type: textarea
+    id: logs
+    attributes:
+      label: Relevant log output
+      description: Please copy and paste any relevant log output. This will be
+        automatically formatted into code, so no need for back ticks.
+      render: shell

.github/ISSUE_TEMPLATE/feature_request.yaml

@@ -0,0 +1,56 @@
+name: Feature request
+description: Suggest an idea for this project
+title: "[Feature]: "
+labels:
+  - feature
+  - triage
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this feature request!
+  - type: textarea
+    id: problem
+    attributes:
+      label: Describe the problem
+      description: Is your feature request related to a problem? Please describe.
+      placeholder: Describe the problem you would like to solve
+      value: My problem
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Describe the solution
+      description: A clear and concise description of what you want to happen.
+      placeholder: Tell us what you would like to see!
+      value: My solution
+    validations:
+      required: true
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional context
+      description: Add any other context or screenshots about the feature request here.
+      placeholder: A context
+      value: The context
+    validations:
+      required: true
+  - type: checkboxes
+    id: suitability
+    attributes:
+      label: Is this new feature a good fit ?
+      description: Should this new feature really be part of this project
+      options:
+        - label: "__Needed__: an existing user is going to need this in the short term"
+          required: true
+        - label: "__Specific__: the problem is clearly understood and defined"
+          required: true
+        - label: "__Small change__: This new feature represents a reasonably small change"
+          required: true
+        - label: "__Same scope__: this new feature does not change significantly the scope
+            of this project"
+          required: true
+        - label: "__Long term maintenance__: moving this to a new project would make long
+            term maintenance harder"
+          required: true

.github/pull_request_template.md

@@ -0,0 +1,36 @@
+# Summary of the change
+
+Fixes: # (issue)
+
+## Code check
+
+-   [x] `npx baldrick-broth@latest release ready` does not show any
+    concerning issues
+
+## Type of change
+
+-   [ ] Bug fix (non-breaking change which fixes an issue)
+
+-   [ ] Safe refactoring (non-breaking change which improves the code or
+    documentation)
+
+-   [ ] New feature (non-breaking change which adds functionality)
+
+-   [ ] Breaking change (fix or feature that would cause existing
+    functionality to not work as expected)
+
+## Motivation and context
+
+-   [ ] improve user experience
+-   [ ] improve consistency
+-   [ ] improve security
+-   [ ] improve documentation
+-   [ ] improve code
+-   [ ] reduce risk for unfamiliar tasks
+-   [ ] automate repetitive tasks
+
+## How Has This Been Tested
+
+-   [x] Unit tests
+-   [ ] Automated browser tests
+-   [ ] Manual tests

.github/workflows/main.yml

@@ -0,0 +1,48 @@
+name: CI
+on:
+  - push
+jobs:
+  build:
+    name: Build, lint, and test on Node ${{ matrix.node }} and ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        node:
+          - 18.x
+        os:
+          - macOS-latest
+          - ubuntu-latest
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v3
+      - name: Use Node ${{ matrix.node }}
+        uses: actions/setup-node@v3
+        with:
+          node-version: ${{ matrix.node }}
+      - name: Installation
+        run: yarn install
+      - name: Create temp folder
+        run: mkdir temp
+      - name: Run zest unit tests
+        run: |
+          if [ -d "spec" ]; then
+            npx npx baldrick-broth@latest test spec
+          else
+            echo "No zest files. Skipping"
+          fi
+      - name: Run pest integration tests
+        run: |
+          if [ -d "pest-spec" ]; then
+            npx npx baldrick-broth@latest test pest
+          else
+            echo "No pest files. Skipping"
+          fi
+      - name: Build
+        run: yarn build
+      - name: Test Report
+        uses: dorny/test-reporter@v1
+        if: success() || failure()
+        with:
+          name: Pest
+          path: report/*.pest.mocha.json
+          reporter: mocha-json

.gitignore

@@ -0,0 +1,8 @@
+*.log
+.DS_Store
+node_modules/
+dist/
+report/
+temp/
+.message
+.todo.yaml

.prettierrc.json

@@ -0,0 +1,6 @@
+{
+  "printWidth": 80,
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "es5"
+}

.remarkrc.yml

@@ -0,0 +1,6 @@
+settings:
+  bullet: "*"
+plugins:
+  - remark-preset-lint-consistent
+  - remark-preset-lint-recommended
+  - remark-preset-lint-markdown-style-guide

.vscode/baldrick.code-snippets

@@ -0,0 +1,106 @@
+{
+  "filter-no-null": {
+    "scope": "javascript,typescript",
+    "prefix": "filter-no-null",
+    "body": "const removeNulls = <S>(value: S | undefined): value is S => value != null;",
+    "description": "Filter out undefined values"
+  },
+  "eslint-disable-line": {
+    "scope": "javascript,typescript",
+    "prefix": "eslint-disable-line",
+    "body": "// eslint-disable-line $0",
+    "description": "Disable linting a specific Line"
+  },
+  "eslint-disable-next-line": {
+    "scope": "javascript,typescript",
+    "prefix": "eslint-disable-next-line",
+    "body": "// eslint-disable-next-line $0",
+    "description": "Disable linting for next line"
+  },
+  "jest-regression-inline": {
+    "scope": "javascript,typescript",
+    "prefix": "jest-regression-inline",
+    "body": [
+      "import { $1 } from '../src/${TM_FILENAME_BASE/.test//}';",
+      "",
+      "describe('${TM_FILENAME_BASE/.test//}', () => {",
+      "  it('should provide', () => {",
+      "    const opts = {};",
+      "    const actual = $1(opts);",
+      "    expect(actual).toMatchInlineSnapshot();",
+      "  });",
+      "});",
+      ""
+    ],
+    "description": "Unit test to provide regression with a snapshot"
+  },
+  "mock-console": {
+    "scope": "javascript,typescript",
+    "prefix": "mock-console",
+    "body": "jest.spyOn(global.console, \"${1|log,info,warn,error|}\").mockImplementation(() => {});",
+    "description": "Mock console in unit tests"
+  },
+  "stringify": {
+    "scope": "javascript,typescript",
+    "prefix": "stringify",
+    "body": [
+      "const toJsonString = (value: object): string =>",
+      "  JSON.stringify(value, null, 2);"
+    ],
+    "description": "stringify an object"
+  },
+  "error-message-id": {
+    "scope": "javascript,typescript",
+    "prefix": "error-message-id",
+    "body": [
+      "($RANDOM)"
+    ],
+    "description": "Generate an error message id"
+  },
+  "add decision": {
+    "scope": "markdown,md",
+    "prefix": "add decision",
+    "body": [
+      "## Title Fixme",
+      "",
+      "* MUST-HAVE.",
+      "* Created: ${CURRENT_MONTH_NAME} ${CURRENT_YEAR}",
+      "",
+      "### Context and Problem Statement",
+      "",
+      "> Fixme",
+      "",
+      "### Decision Drivers",
+      "",
+      "* Fixme",
+      "",
+      "### Considered Options",
+      "",
+      "* Fixme",
+      "",
+      "### Decision Outcome",
+      "",
+      "Chosen option: Fixme",
+      "",
+      "#### Positive Consequences",
+      "",
+      "* Fixme",
+      "",
+      "#### Negative Consequences",
+      "",
+      "* Fixme",
+      "",
+      "### Pros and Cons of the Options",
+      "",
+      "#### Option title fixme",
+      "",
+      "Description fixme",
+      "",
+      "* Pros: ",
+      "    * Fixme",
+      "* Cons:",
+      "    * Fixme"
+    ],
+    "description": "Adds architecture decision record"
+  }
+}

.vscode/settings.json

@@ -0,0 +1,6 @@
+{
+  "makefile.extensionOutputFolder": "./.vscode",
+  "yaml.schemas": {
+    "./script/schema/project.schema.json": "script/data/project.yaml"
+  }
+}

.xo-config.json

@@ -0,0 +1,19 @@
+{
+  "prettier": true,
+  "nodeVersion": 18,
+  "envs": [
+    "es2022",
+    "node"
+  ],
+  "rules": {
+    "unicorn/prevent-abbreviations": "off",
+    "unicorn/no-array-callback-reference": "off",
+    "unicorn/prefer-json-parse-buffer": "off",
+    "unicorn/no-array-reduce": "off",
+    "@typescript-eslint/no-unsafe-call": "off",
+    "@typescript-eslint/no-unsafe-assignment": "off",
+    "@typescript-eslint/no-unsafe-argument": "off",
+    "@typescript-eslint/no-floating-promises": "off",
+    "@typescript-eslint/no-unsafe-return": "off"
+  }
+}