v3.0

Author: manuel-lohmus

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,57 @@
+name: Bug report
+description: Report a reproducible problem
+title: "[Bug]: "
+labels: ["bug"]
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for filing a bug! Please provide as much detail as possible.
+  - type: input
+    id: version
+    attributes:
+      label: Package version
+      description: Which version of config-sets are you using?
+      placeholder: e.g. 3.0.0
+    validations:
+      required: true
+  - type: input
+    id: node
+    attributes:
+      label: Node.js version
+      placeholder: e.g. v18.20.3
+  - type: input
+    id: os
+    attributes:
+      label: OS
+      placeholder: e.g. Windows 11, macOS 14, Ubuntu 22.04
+  - type: textarea
+    id: repro
+    attributes:
+      label: Reproduction steps
+      description: Clear steps to reproduce the issue
+      placeholder: 1) ..., 2) ..., 3) ...
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual behavior
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs / stack traces
+      render: shell
+  - type: textarea
+    id: extra
+    attributes:
+      label: Additional context

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Q&A and Discussions
+    url: https://github.com/manuel-lohmus/config-sets/discussions
+    about: Please ask and answer questions here.

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,33 @@
+name: Feature request
+description: Suggest an idea to improve config-sets
+title: "[Feature]: "
+labels: ["enhancement"]
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for the suggestion! Help us understand your use case.
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem statement
+      description: What problem does this feature solve?
+      placeholder: I'm trying to do X, but Y makes it difficult...
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      placeholder: Describe the API/behavior you'd like to see
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+  - type: textarea
+    id: extra
+    attributes:
+      label: Additional context

.github/ISSUE_TEMPLATE/question.yml

@@ -0,0 +1,23 @@
+name: Question
+description: Ask a question or request clarification
+title: "[Question]: "
+labels: ["question"]
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Please search existing issues and discussions first.
+  - type: textarea
+    id: question
+    attributes:
+      label: Your question
+      placeholder: Be as specific as possible
+    validations:
+      required: true
+  - type: textarea
+    id: context
+    attributes:
+      label: Context
+      description: Code snippet, config sample, or reproduction details (optional)
+      render: bash

.github/workflows/node.js.yml

@@ -25,4 +25,7 @@ jobs:
         cache: 'npm'
     - run: npm ci
     - run: npm run build --if-present
-    - run: npm test
+    - run: npm test
+    permissions:
+      contents: read
+      pull-requests: write

CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
+
+## [3.0.0] - 2025-10-17
+### Added
+- TypeScript declarations (`index.d.ts`) covering:
+  - Callable default export with overloads (module name or defaults object).
+  - Static members: `assign`, `arg_options`, `print_help`, `isProduction`, `production`, `development`, `enableFileReadWrite`.
+  - Minimal event typings (`on`, `resetChanges`) compatible with `data-context`.
+- GitHub Issue templates: bug report, feature request, question, and config.
+
+### Changed
+- Package metadata:
+  - Bumped version to `3.0.0`.
+  - Updated `scripts.test` to `node index.test.js`.
+  - Ensured `browser.js` is included in published files (kept `exports` mapping for CJS/ESM/browser).
+
+### Notes
+- Public API remains functionally compatible with the 3.x beta line.
+- When using ESM, import the default export:
+  - `import configSets from 'config-sets'`
+- When using CommonJS:
+  - `const configSets = require('config-sets')`
+
+[3.0.0]: https://github.com/manuel-lohmus/config-sets/releases/tag/v3.0.0