chore(release): release v1.0.0

.editorconfig

@@ -0,0 +1,21 @@
+root = true
+
+[*]
+
+charset = utf-8
+end_of_line = lf
+indent_size = 2
+indent_style = space
+insert_final_newline = true
+
+[*.{cjs,js,json,json5,jsonc,jsonl,mjs,ts,yml}]
+
+trim_trailing_whitespace = true
+
+[.*rc]
+
+trim_trailing_whitespace = true
+
+[*.md]
+
+trim_trailing_whitespace = false

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,66 @@
+name: Bug Report
+description: Report a bug or unexpected behavior.
+labels:
+  - bug
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: A clear and concise description of the bug.
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to Reproduce
+      description: Provide a minimal code example or steps to reproduce the issue.
+      placeholder: |
+        import { capitalize } from "@rcpthongta/string-utils";
+
+        capitalize("hello"); // expected "Hello", got ""
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What did you expect to happen?
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+      description: What actually happened?
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: Package Version
+      description: Which version of `@rcpthongta/string-utils` are you using?
+      placeholder: 1.0.0
+    validations:
+      required: true
+
+  - type: input
+    id: node-version
+    attributes:
+      label: Node.js Version
+      description: Output of `node --version`.
+      placeholder: v22.0.0
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Any other relevant information, logs, or screenshots.
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,48 @@
+name: Feature Request
+description: Suggest a new utility or enhancement.
+labels:
+  - enhancement
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: A clear and concise description of the feature you would like.
+    validations:
+      required: true
+
+  - type: textarea
+    id: use-case
+    attributes:
+      label: Use Case
+      description: Describe the problem or use case this feature would address.
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposed-api
+    attributes:
+      label: Proposed API
+      description: If applicable, show how you envision the API would look.
+      placeholder: |
+        import { truncate } from "@rcpthongta/string-utils";
+
+        truncate("Hello, World!", 5); // "Hello..."
+    validations:
+      required: false
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Any alternative solutions or workarounds you have considered.
+    validations:
+      required: false
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Any other relevant information or references.
+    validations:
+      required: false

.github/workflows/ci.yml

@@ -0,0 +1,17 @@
+name: Continuous Integration
+on:
+  push:
+    branches:
+      - develop
+      - main
+  pull_request:
+    branches:
+      - main
+permissions:
+  contents: read
+jobs:
+  lint:
+    uses: ./.github/workflows/linter.yml
+  test:
+    needs: lint
+    uses: ./.github/workflows/test.yml

.github/workflows/linter.yml

@@ -0,0 +1,21 @@
+name: Linter
+on:
+  workflow_call: {}
+permissions:
+  contents: read
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+      - name: Install dependencies
+        run: npm ci
+      - name: Run script command
+        run: npm run lint

.github/workflows/release.yml

@@ -0,0 +1,29 @@
+name: Release
+on:
+  push:
+    tags:
+      - "v*"
+permissions:
+  contents: read
+  id-token: write
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+          registry-url: https://registry.npmjs.org
+      - name: Install dependencies
+        run: npm ci
+      - name: Build package
+        run: npm run build
+      - name: Publish to npm
+        run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.github/workflows/test.yml

@@ -0,0 +1,21 @@
+name: Test
+on:
+  workflow_call: {}
+permissions:
+  contents: read
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+      - name: Install dependencies
+        run: npm ci
+      - name: Run script command
+        run: npm run test:coverage

.gitignore

@@ -0,0 +1,19 @@
+# Dependencies directory
+
+node_modules/*
+
+# Compiled output directory
+
+dist/*
+
+# Test directory
+
+coverage/*
+
+# Text editor directory and files • Visual Studio Code
+
+.vscode/*
+!.vscode/extensions.json
+!.vscode/launch.json
+!.vscode/settings.json
+!.vscode/tasks.json

.husky/commit-msg

@@ -0,0 +1 @@
+npx --no -- commitlint --edit "$1"

.husky/pre-commit

@@ -0,0 +1 @@
+npm run precommit

.husky/pre-push

@@ -0,0 +1 @@
+npm run prepush

.npmrc

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

.vscode/extensions.json

@@ -0,0 +1,8 @@
+{
+  "recommendations": [
+    "dbaeumer.vscode-eslint",
+    "editorconfig.editorconfig",
+    "streetsidesoftware.code-spell-checker",
+    "yoavbls.pretty-ts-errors"
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,28 @@
+{
+  "[javascript][json][json5][jsonc][jsonl][markdown][typescript][yaml]": {
+    "editor.defaultFormatter": "dbaeumer.vscode-eslint"
+  },
+  "cSpell.allowCompoundWords": true,
+  "cSpell.ignoreRegExpList": ["/[\\u0E00-\\u0E7F]/g"],
+  "cSpell.language": "en,en-US",
+  "cSpell.words": [
+    "rcpthongta",
+    "uncapitalize"
+  ],
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "explicit"
+  },
+  "editor.formatOnSave": true,
+  "eslint.format.enable": true,
+  "eslint.validate": [
+    "javascript",
+    "json",
+    "json5",
+    "jsonc",
+    "jsonl",
+    "markdown",
+    "typescript",
+    "yaml"
+  ],
+  "typescript.tsdk": "node_modules\\typescript\\lib"
+}

CHANGELOG.md

@@ -0,0 +1,49 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/)
+and this project adheres to [Semantic Versioning](https://semver.org/).
+
+## [1.0.0] - 2026-09-23
+
+### Added
+
+- **String Inspection**
+  - `hasText` — check if a string contains non-whitespace characters
+  - `hasLength` — check if a string contains one or more characters
+  - `defaultIfBlank` — return a fallback when a string is blank
+  - `defaultIfEmpty` — return a fallback when a string is empty
+
+- **Case Conversion**
+  - `capitalize` — uppercase the first character
+  - `uncapitalize` — lowercase the first character
+  - `camelCase` — convert a string to camelCase
+  - `pascalCase` — convert a string to PascalCase
+  - `kebabCase` — convert a string to kebab-case
+  - `snakeCase` — convert a string to snake_case
+  - `constantCase` — convert a string to CONSTANT_CASE
+
+- **String Transformation**
+  - `collapseWhitespace` — normalize consecutive whitespace to single spaces
+  - `slugify` — convert a string to a URL-friendly slug
+  - `format` — format strings using templates and placeholders
+  - `mask` — mask portions of a string using a pattern
+  - `redact` — redact sensitive string content
+
+- **Constants & Patterns**
+  - Reusable string constants such as `EMPTY`, `SPACE`, `HYPHEN`, `UNDERSCORE`, `DOT`, `ASTERISK`, and `HASH`
+  - Unicode-aware regular expression patterns for words, digits, letters, and diacritics
+
+- **Package Distribution**
+  - ESM, CJS, and IIFE builds powered by tsup
+  - TypeScript type declarations
+  - Dual `import` / `require` package exports
+
+- **Development & CI**
+  - Vitest for unit tests, benchmarks, and coverage
+  - ESLint and Prettier for code quality and formatting
+  - Husky, lint-staged, and commitlint for Git hooks and commit validation
+  - GitHub Actions workflows for linting and test coverage
+
+[1.0.0]: https://github.com/rcpthongta/string-utils/releases/tag/v1.0.0