Release

.commitlintrc.json

@@ -0,0 +1,5 @@
+{
+ "extends": [
+ "@commitlint/config-conventional"
+ ]
+}

.gitattributes

@@ -0,0 +1,6 @@
+# Enforce LF for all text files
+* text=auto eol=lf
+
+# Keep Windows command scripts with CRLF line endings
+*.bat text eol=crlf
+*.cmd text eol=crlf

.github/workflows/ci.yml

@@ -0,0 +1,83 @@
+name: CI
+
+on:
+ push:
+ branches:
+ - develop
+ - 'feature/**'
+ pull_request:
+ branches:
+ - develop
+ - 'feature/**'
+ workflow_call:
+ inputs:
+ full:
+ description: 'Run full OS x Node matrix'
+ required: false
+ type: boolean
+ default: false
+
+jobs:
+ compute-matrix:
+ name: Compute matrix
+ runs-on: ubuntu-latest
+ outputs:
+ matrix: ${{ steps.set.outputs.matrix }}
+ name_suffix: ${{ steps.set.outputs.name_suffix }}
+ steps:
+ - id: set
+ run: |
+ if [[ "${{ inputs.full }}" == "true" ]]; then
+ echo 'matrix={"os":["ubuntu-latest","windows-latest"],"node":[22,24]}' >> $GITHUB_OUTPUT
+ echo 'name_suffix=(full matrix)' >> $GITHUB_OUTPUT
+ else
+ echo 'matrix={"os":["ubuntu-latest"],"node":[22]}' >> $GITHUB_OUTPUT
+ echo 'name_suffix=' >> $GITHUB_OUTPUT
+ fi
+
+ build-and-test:
+ name: Build, Lint, Test ${{ needs.compute-matrix.outputs.name_suffix }}
+ needs: compute-matrix
+ runs-on: ${{ matrix.os }}
+ permissions:
+ contents: read
+ strategy:
+ fail-fast: false
+ matrix: ${{ fromJSON(needs.compute-matrix.outputs.matrix) }}
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v4
+
+ - name: Configure git EOL (Windows)
+ if: runner.os == 'Windows'
+ run: |
+ git config core.autocrlf false
+ git config core.eol lf
+
+ - name: Use Node.js
+ uses: actions/setup-node@v4
+ with:
+ node-version: ${{ matrix.node }}
+ cache: npm
+
+ - name: Install dependencies
+ run: npm ci
+
+ - name: Lint
+ run: npm run lint
+
+ - name: Typecheck
+ run: npm run typecheck
+
+ - name: Test
+ run: npm run test:ci
+
+ - name: Build
+ run: npm run build:types
+
+ - name: Upload coverage artifact
+ if: always()
+ uses: actions/upload-artifact@v4
+ with:
+ name: coverage-${{ matrix.os }}-node${{ matrix.node }}
+ path: coverage

.github/workflows/release.yml

@@ -0,0 +1,97 @@
+name: Release
+
+on:
+ push:
+ branches:
+ - main
+ workflow_dispatch:
+ inputs:
+ version:
+ description: 'Exact version to release (e.g. 1.2.3). Leave empty to auto-bump.'
+ required: false
+ type: string
+ preid:
+ description: 'Pre-release identifier (e.g. beta, rc). Optional'
+ required: false
+ type: string
+ npm_tag:
+ description: 'npm dist-tag (e.g. latest, beta)'
+ required: false
+ default: 'latest'
+ type: string
+
+permissions:
+ contents: write
+ id-token: write
+
+jobs:
+ ci:
+ name: CI
+ uses: ./.github/workflows/ci.yml
+ with:
+ full: true
+
+ release:
+ name: Release & Publish
+ runs-on: ubuntu-latest
+ needs: ci
+ steps:
+ - name: Checkout repository
+ uses: actions/checkout@v4
+ with:
+ fetch-depth: 0
+ fetch-tags: true
+
+ - name: Use Node.js
+ uses: actions/setup-node@v4
+ with:
+ node-version: 22
+ cache: 'npm'
+ registry-url: 'https://registry.npmjs.org'
+ always-auth: true
+
+ - name: Install dependencies
+ run: npm ci
+
+ - name: Configure Git user
+ run: |
+ git config user.name "github-actions[bot]"
+ git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+ - name: Run release-it
+ env:
+ DEBUG: release-it:*,@release-it/*
+ HUSKY: 0
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+ NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+ NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+ run: |
+ VERSION_ARG=""
+ if [ -n "${{ inputs.version }}" ]; then
+ VERSION_ARG="${{ inputs.version }}"
+ fi
+
+ PREID_ARG=""
+ if [ -n "${{ inputs.preid }}" ]; then
+ PREID_ARG="--preRelease=${{ inputs.preid }}"
+ fi
+
+ if [ -n "${{ inputs.npm_tag }}" ]; then
+ NPM_TAG="${{ inputs.npm_tag }}"
+ else
+ NPM_TAG="latest"
+ fi
+ NPM_TAG_ARG="--npm.tag=${NPM_TAG}"
+
+ npm run release -- --ci $PREID_ARG $NPM_TAG_ARG $VERSION_ARG
+
+ - name: Sync main → develop
+ uses: devmasx/merge-branch@v1.4.0
+ with:
+ type: now
+ from_branch: main
+ target_branch: develop
+ github_token: ${{ secrets.GITHUB_TOKEN }}
+ env:
+ HUSKY: 0
+

.gitignore

@@ -9,10 +9,12 @@ lerna-debug.log*
 
 node_modules
 dist
+dist-types
 addon
 .adnbn
 dist-ssr
 *.local
+coverage
 
 # Editor directories and files
 .vscode/*

.husky/commit-msg

@@ -0,0 +1,5 @@
+#!/usr/bin/env sh
+
+# Husky commit-msg hook: validate commit message with commitlint
+
+npx --no -- commitlint --edit "$1"

.husky/pre-commit

@@ -0,0 +1,7 @@
+#!/usr/bin/env sh
+
+# Husky pre-commit hook: format and run related tests on staged files
+
+npm run lint:fix:aggressive || exit 1;
+npm run test || exit 1;
+npm run format || exit 1;

.husky/pre-push

@@ -0,0 +1,7 @@
+#!/usr/bin/env sh
+
+# Husky pre-push hook: typecheck, run full tests, and build
+
+npm run typecheck || exit 1
+npm run test:ci || exit 1
+npm run build:types || exit 1

.mailmap

@@ -0,0 +1,2 @@
+Addon Stack <191148085+addon-stack@users.noreply.github.com> <addonbonedev@gmail.com>
+Addon Stack <addon-stack@users.noreply.github.com> <addonbonedev@gmail.com>