Merge pull request #3 from sergeyshmakov/2026-05-13-package-api-amd-repo-polish

2026 05 13 package api and repo polish

Author: sergeyshmakov

.github/CODE_OF_CONDUCT.md

@@ -0,0 +1,17 @@
+# Code of Conduct
+
+This project adopts the [Contributor Covenant 2.1](https://www.contributor-covenant.org/version/2/1/code_of_conduct/) code of conduct.
+
+In brief:
+
+- Be respectful and constructive.
+- No harassment, personal attacks, or exclusionary behavior.
+- Assume good intent; ask questions before drawing conclusions.
+
+## Reporting
+
+Report violations to [shmakov@konturnomad.am](mailto:shmakov@konturnomad.am). Reports are reviewed within 7 days and treated with discretion.
+
+## Enforcement
+
+Violations may result in comment removal, temporary restriction, or permanent ban from the project, depending on severity and context.

.github/ISSUE_TEMPLATE/bug.yml

@@ -0,0 +1,41 @@
+name: Bug report
+description: Report a defect or unexpected behavior
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Before submitting, check [existing issues](https://github.com/sergeyshmakov/data-path/issues) to avoid duplicates.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: What happened, and what did you expect?
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Minimal reproduction
+      description: A self-contained TypeScript snippet that demonstrates the issue.
+      render: ts
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: Package version
+      placeholder: "1.0.0"
+    validations:
+      required: true
+
+  - type: input
+    id: ts-version
+    attributes:
+      label: TypeScript version
+      placeholder: "5.5.0"
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Documentation
+    url: https://sergeyshmakov.github.io/data-path/
+    about: Browse the full documentation site first — your question may already be answered.
+  - name: Discussions
+    url: https://github.com/sergeyshmakov/data-path/discussions
+    about: Usage questions, ideas, and general conversation.

.github/ISSUE_TEMPLATE/feature.yml

@@ -0,0 +1,30 @@
+name: Feature request
+description: Propose a new capability or API change
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Please open an issue before writing code for large features — this avoids wasted effort if the design needs adjusting.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem statement
+      description: What is missing or painful today?
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed solution
+      description: What would you like to see? A code sketch is welcome.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Other approaches you considered, and why you ruled them out.

.github/dependabot.yml

@@ -5,13 +5,13 @@ updates:
     directory: "/"
     schedule:
       interval: "monthly"
-      day: "monday"
       time: "06:00"
       timezone: "UTC"
+    allow:
+      - dependency-type: "direct"
     open-pull-requests-limit: 5
     labels:
       - "dependencies"
-    dependency-type: "direct"
     groups:
       npm-production:
         dependency-type: "production"
@@ -20,3 +20,40 @@ updates:
     ignore:
       - dependency-name: "@types/node*"
         versions: [ ">=24" ]
+      - dependency-name: "lint-staged"
+        versions: [ ">=17" ]
+      - dependency-name: "typescript"
+        versions: [ ">=6" ]
+
+  - package-ecosystem: "npm"
+    directory: "/docs"
+    schedule:
+      interval: "monthly"
+      time: "06:00"
+      timezone: "UTC"
+    allow:
+      - dependency-type: "direct"
+    open-pull-requests-limit: 1
+    labels:
+      - "dependencies"
+    groups:
+      docs-dependencies:
+        patterns: ["*"]
+    ignore:
+      - dependency-name: "lint-staged"
+        versions: [ ">=17" ]
+      - dependency-name: "typescript"
+        versions: [ ">=6" ]
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "monthly"
+      time: "06:00"
+      timezone: "UTC"
+    open-pull-requests-limit: 1
+    labels:
+      - "dependencies"
+    groups:
+      github-actions:
+        patterns: ["*"]

.github/pull_request_template.md

@@ -0,0 +1,13 @@
+## What does this PR do?
+
+<!-- A concise description. Link any related issue with "Closes #123" or "Fixes #123". -->
+
+## How to test
+
+<!-- Steps to reproduce or verify the change. -->
+
+## Checklist
+
+- [ ] Tests added or updated
+- [ ] Docs updated (if public API changed)
+- [ ] Commit messages follow [Conventional Commits](https://www.conventionalcommits.org/)

.github/workflows/deploy-docs.yml

@@ -0,0 +1,49 @@
+name: Deploy Docs
+
+on:
+  push:
+    branches: [main]
+    paths: ["docs/**"]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          # Full history so Starlight's `lastUpdated` (git log per file) is accurate.
+          fetch-depth: 0
+      - uses: actions/setup-node@v4
+        with:
+          node-version: lts/*
+      - name: Install dependencies
+        working-directory: docs
+        run: npm ci
+      - name: Build docs
+        working-directory: docs
+        run: npm run build
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/dist
+
+  deploy:
+    name: Deploy
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/publish.yml

@@ -13,11 +13,11 @@ jobs:
       pull-requests: write 
       id-token: write
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
           fetch-tags: true
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           node-version: 'lts/*'
 

.husky/pre-commit

@@ -1,2 +1,2 @@
+npx lint-staged
 npm test
-npx @biomejs/biome check --write --staged --no-errors-on-unmatched

.lintstagedrc

@@ -0,0 +1,3 @@
+{
+	"*.{js,jsx,ts,tsx,json,jsonc,md,mdx,css,yml,yaml}": "biome check --write --no-errors-on-unmatched"
+}