feat: initialize project with npm package configuration and setup files

Author: atldays

.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches:
+      - develop
+      - main
+
+permissions:
+  contents: read
+
+jobs:
+  verify:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10.30.3
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Verify
+        run: pnpm run verify
+

.github/workflows/release.yml

@@ -0,0 +1,54 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+  pull-requests: write
+  id-token: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Release Please
+        id: release
+        uses: googleapis/release-please-action@v4
+        with:
+          release-type: node
+          package-name: srcset-kit
+
+      - name: Checkout
+        if: ${{ steps.release.outputs.release_created }}
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        if: ${{ steps.release.outputs.release_created }}
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10.30.3
+
+      - name: Setup Node.js
+        if: ${{ steps.release.outputs.release_created }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: pnpm
+          registry-url: https://registry.npmjs.org/
+
+      - name: Install dependencies
+        if: ${{ steps.release.outputs.release_created }}
+        run: pnpm install --frozen-lockfile
+
+      - name: Verify
+        if: ${{ steps.release.outputs.release_created }}
+        run: pnpm run verify
+
+      - name: Publish to npm
+        if: ${{ steps.release.outputs.release_created }}
+        run: pnpm publish --provenance --access public
+

.gitignore

@@ -0,0 +1,16 @@
+.DS_Store
+.idea/
+
+node_modules/
+dist/
+coverage/
+.rslib/
+.rstest/
+.rsbuild/
+
+*.log
+npm-debug.log*
+pnpm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+

.husky/commit-msg

@@ -0,0 +1,2 @@
+pnpm exec commitlint --edit "$1"
+

.husky/pre-commit

@@ -0,0 +1,2 @@
+pnpm exec lint-staged
+

.husky/pre-push

@@ -0,0 +1,2 @@
+pnpm run test && pnpm run build
+

.npmrc

@@ -0,0 +1,3 @@
+engine-strict=false
+fund=false
+

.nvmrc

@@ -0,0 +1,2 @@
+22
+

CHANGELOG.md

@@ -0,0 +1,6 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+This project uses Conventional Commits and Release Please to generate releases.
+

CONTRIBUTING.md

@@ -0,0 +1,60 @@
+# Contributing
+
+## Requirements
+
+- Node.js 22 or newer for local development.
+- pnpm 10 or newer.
+
+## Local checks
+
+```sh
+pnpm install
+pnpm run verify
+```
+
+Use focused commands while developing:
+
+```sh
+pnpm run test
+pnpm run build
+pnpm run typecheck
+pnpm run format
+```
+
+## Commits
+
+This repository uses Conventional Commits. Examples:
+
+```text
+feat: add srcset parser
+fix: keep descriptor whitespace valid
+chore(release): merge main back into develop
+```
+
+Husky runs `commitlint` for commit messages.
+
+## Branch flow
+
+The repository follows a GitFlow-like process without requiring the GitFlow CLI:
+
+- feature and fix pull requests target `develop`;
+- release pull requests merge `develop` into `main`;
+- Release Please creates a release pull request in `main`;
+- after the release pull request is merged, GitHub Release and npm publishing run automatically;
+- merge `main` back into `develop` after every release so `develop` receives the version, changelog, and lockfile updates.
+
+When a merge commit is created manually, keep the merge message conventional, for example:
+
+```text
+chore(release): merge main back into develop
+feat: merge feature/parser
+```
+
+## Hooks
+
+Husky hooks are installed by `pnpm install`.
+
+- `pre-commit` formats staged files with Biome through lint-staged and keeps the formatted result in the current commit.
+- `commit-msg` validates Conventional Commits.
+- `pre-push` runs tests and the build.
+