@aakashwije/lanka-nic 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,34 @@
+## 1.0.0 (2026-06-16)
+
+### Features
+
+* initial lanka nic package ([ac97912](https://github.com/Aakashwije/lanka-nic/commit/ac97912bc0acdcfe446f9c6401a8a058c81d6485))
+
+### Bug Fixes
+
+* add conventional commits preset for semantic-release ([ddce03e](https://github.com/Aakashwije/lanka-nic/commit/ddce03ea188f470bb3156798f684dc17ddb7fd62))
+* correct repository metadata for semantic-release ([985235d](https://github.com/Aakashwije/lanka-nic/commit/985235dac9174a81db13de5c32318933f2285445))
+* disable npm publishing in semantic-release to fix CI release job ([23f93b4](https://github.com/Aakashwije/lanka-nic/commit/23f93b419a56ef419f31b01c36d91c1f845805e8))
+* harden release workflow token handling ([1e348b8](https://github.com/Aakashwije/lanka-nic/commit/1e348b8cea175a003ba837f839191cb2fc6186f7))
+* harden semantic-release repo and token env ([af164c9](https://github.com/Aakashwije/lanka-nic/commit/af164c94686d4e1f028cbe8fd097677bc05c9f00))
+
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.1.0] - 2026-06-16
+
+### Added
+
+- Validation, parsing, normalization, masking, and old→new conversion for Sri Lankan NIC numbers.
+- `safeParse` returning a discriminated `{ success, data | error }` result with typed error codes.
+- `parseNICOrThrow` variant that throws `NICError` with `.code` and `.input`.
+- Type guards: `isValidNIC`, `isOldNIC`, `isNewNIC`.
+- Age helpers: `getAge`, `getAgeOn`.
+- `equalsNIC` for cross-format equality.
+- `validateBatch`, `parseBatch` for array workflows.
+- `generateNIC` test fixture helper (round-trippable through `parseNIC`).
+- `lanka-nic` CLI binary with `validate`, `parse`, `mask`, `age` subcommands.
+- Dual ESM + CJS distribution with TypeScript declarations.
+- npm provenance attestation on release.
+- 100% coverage gate in CI.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aakash Wijesekara
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,616 @@
+<div align="center">
+
+# `@aakashwije/lanka-nic`
+
+**Production-grade Sri Lankan NIC validation, parsing, and generation**
+
+[![npm](https://img.shields.io/npm/v/@aakashwije/lanka-nic?color=%230060c7&label=npm&logo=npm&style=flat-square)](https://www.npmjs.com/package/@aakashwije/lanka-nic)
+[![CI](https://img.shields.io/github/actions/workflow/status/aakashlk/lanka-nic/ci.yml?branch=main&logo=github-actions&logoColor=white&style=flat-square&label=CI)](https://github.com/aakashlk/lanka-nic/actions)
+[![Coverage](https://img.shields.io/badge/coverage-100%25-brightgreen?logo=vitest&style=flat-square)](#)
+[![License: MIT](https://img.shields.io/badge/license-MIT-22c55e?style=flat-square)](LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6?logo=typescript&logoColor=white&style=flat-square)](https://www.typescriptlang.org/)
+[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18-339933?logo=node.js&logoColor=white&style=flat-square)](https://nodejs.org/)
+[![ESM + CJS](https://img.shields.io/badge/module-ESM%20%2B%20CJS-f97316?style=flat-square)](#)
+[![Zero deps](https://img.shields.io/badge/dependencies-0-brightgreen?style=flat-square)](#)
+
+---
+
+*Engineered for correctness and developer ergonomics. UTC-safe date math, leap-year aware, typed error codes, and a first-class CLI — all with zero runtime dependencies.*
+
+</div>
+
+---
+
+## Table of Contents
+
+- [Overview](#overview)
+- [Technology Stack](#technology-stack)
+- [NIC Format Specification](#nic-format-specification)
+- [Architecture](#architecture)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [API Reference](#api-reference)
+- [CLI](#cli)
+- [Contributing](#contributing)
+- [License](#license)
+
+---
+
+## Overview
+
+`@aakashwije/lanka-nic` is a zero-dependency, fully-typed TypeScript library for working with Sri Lankan **National Identity Card (NIC)** numbers. It handles both the legacy 9-digit format (`YYXXXSSSSV`) and the modern 12-digit format (`YYYYXXXSSSSS`), covering:
+
+- **Parsing** — extract birth year, birth date, day-of-year, gender
+- **Validation** — format and semantic correctness including leap-year safety
+- **Normalization** — whitespace trimming, suffix casing
+- **Masking** — safe display in logs and UIs
+- **Age derivation** — UTC-correct age calculation at any reference date
+- **Format conversion** — old → new best-effort conversion
+- **Equality** — compare NICs across formats
+- **Batch operations** — validate or parse arrays efficiently
+- **Test data generation** — generate syntactically valid NICs for seeding
+
+---
+
+## Technology Stack
+
+| Layer | Technology | Purpose |
+|---|---|---|
+| Language | ![TypeScript](https://img.shields.io/badge/-TypeScript_5.x-3178C6?logo=typescript&logoColor=white&style=flat-square) | Type-safe implementation |
+| Runtime | ![Node.js](https://img.shields.io/badge/-Node.js_%E2%89%A518-339933?logo=node.js&logoColor=white&style=flat-square) | Server-side execution |
+| Build | ![tsup](https://img.shields.io/badge/-tsup-f97316?style=flat-square) | Dual ESM + CJS output |
+| Test | ![Vitest](https://img.shields.io/badge/-Vitest-6E9F18?logo=vitest&logoColor=white&style=flat-square) | Unit tests + coverage |
+| Lint | ![ESLint](https://img.shields.io/badge/-ESLint_9.x-4B32C3?logo=eslint&logoColor=white&style=flat-square) | Code quality |
+| Format | ![Prettier](https://img.shields.io/badge/-Prettier-F7B93E?logo=prettier&logoColor=black&style=flat-square) | Consistent style |
+| Release | ![semantic-release](https://img.shields.io/badge/-semantic--release-e10079?logo=semantic-release&logoColor=white&style=flat-square) | Automated versioning |
+| CI/CD | ![GitHub Actions](https://img.shields.io/badge/-GitHub_Actions-2088FF?logo=github-actions&logoColor=white&style=flat-square) | Continuous integration |
+
+---
+
+## NIC Format Specification
+
+Sri Lanka uses two NIC formats, both encoding birth year, day-of-year, gender, and serial number in a compact string.
+
+### Old Format — `YYXXXSSSSV`
+
+```
+┌─ 2 ─┬──── 3 ────┬──── 4 ────┬─ 1 ─┐
+│  YY  │    DDD    │   SSSS    │  V   │
+└──────┴───────────┴───────────┴──────┘
+  Year   Day code    Serial   Check letter
+ (1900+)  (001–866)  (0000–9999)  (V or X)
+
+Examples:
+  950012345V  →  born 1995, day 001, male, serial 2345
+  956512345V  →  born 1995, day 001, female (001 + 500 = 501... see gender encoding)
+```
+
+### New Format — `YYYYXXXSSSSSSS`
+
+```
+┌──── 4 ────┬──── 3 ────┬─────── 5 ───────┐
+│   YYYY    │    DDD    │     SSSSS        │
+└───────────┴───────────┴──────────────────┘
+  Birth year  Day code     Serial
+  (4 digits)  (001–866)   (00000–99999)
+
+Examples:
+  199500123456  →  born 1995, day 001, male, serial 23456
+```
+
+### Gender Encoding
+
+The day-of-year is encoded directly for males. For females, **500 is added** to the raw day value:
+
+| Gender | Day code range | Resolved day-of-year |
+|--------|---------------|---------------------|
+| Male   | `001` – `366` | value as-is         |
+| Female | `501` – `866` | value − 500         |
+| Invalid | `000`, `367`–`500`, `867`+ | rejected |
+
+---
+
+## Architecture
+
+### Module Dependency Graph
+
+```mermaid
+graph TD
+    subgraph Utilities["⚙️ Utilities"]
+        constants["constants\nregex patterns · day offsets"]
+        date["date utils\nleap year · day→date · format"]
+    end
+
+    subgraph Parsing["🔍 Parsing & Normalization"]
+        normalize["normalizeNIC\ntrim · compact · uppercase suffix"]
+        parse["safeParse · parseNIC\nparseNICOrThrow\ngetNICType · getBirthDate · getGender"]
+    end
+
+    subgraph Derived["📦 Derived Operations"]
+        validate["validateNIC"]
+        mask["maskNIC"]
+        age["getAge · getAgeOn"]
+        equals["equalsNIC"]
+        convert["convertOldToNew"]
+        guards["isValidNIC · isOldNIC · isNewNIC"]
+        batch["validateBatch · parseBatch"]
+        generate["generateNIC"]
+    end
+
+    subgraph CLI["💻 CLI"]
+        cli_core["runCommand\n(testable core)"]
+        cli_bin["lanka-nic binary"]
+    end
+
+    constants --> normalize & parse & generate
+    date --> parse & generate
+    normalize --> parse & mask & convert
+
+    parse --> validate & mask & age & equals & guards & batch
+    validate --> guards & batch & mask
+
+    validate & parse & mask & age --> cli_core
+    cli_core --> cli_bin
+```
+
+### Parse Pipeline
+
+```mermaid
+flowchart LR
+    A([raw input]) --> B{is string?}
+    B -- ❌ no --> E1([NON_STRING])
+    B -- ✅ yes --> C[normalizeNIC\ntrim · compact\nuppercase suffix]
+    C --> D{empty\nafter trim?}
+    D -- ❌ yes --> E2([EMPTY])
+    D -- ✅ no --> F{matches\nold or new regex?}
+    F -- ❌ neither --> E3([INVALID_FORMAT])
+    F -- old\n9d+V/X --> G[extract yy · dayCode]
+    F -- new\n12d --> H[extract yyyy · dayCode]
+    G & H --> I{birthYear\n≤ today UTC?}
+    I -- ❌ no --> E4([FUTURE_YEAR])
+    I -- ✅ yes --> J{dayCode in\n1–366 or 501–866?}
+    J -- ❌ no --> E5([INVALID_DAY_CODE])
+    J -- ✅ yes --> K{day exists\nin that year?}
+    K -- ❌ no\ne.g. day 366\nnon-leap --> E6([INVALID_DAY_FOR_YEAR])
+    K -- ✅ yes --> L([✅ ParsedNIC])
+```
+
+### CLI Interaction Flow
+
+```mermaid
+sequenceDiagram
+    actor User
+    participant CLI as lanka-nic
+    participant Core as runCommand
+    participant Lib as @aakashwije/lanka-nic
+
+    User->>CLI: lanka-nic parse 950012345V
+
+    alt NIC passed as argument
+        CLI->>Core: argv=['parse','950012345V'], stdin=null
+    else NIC from stdin
+        User->>CLI: echo 950012345V | lanka-nic parse
+        CLI->>CLI: readStdin()
+        CLI->>Core: argv=['parse'], stdin='950012345V'
+    end
+
+    Core->>Lib: safeParse('950012345V')
+    Lib-->>Core: { success: true, data: ParsedNIC }
+    Core-->>CLI: { code: 0, stdout: JSON }
+    CLI-->>User: prints JSON · exits 0
+
+    Note over CLI,Lib: On invalid NIC → exits 1 with error JSON on stderr
+    Note over CLI,Lib: On bad command → exits 2 with usage text on stderr
+```
+
+---
+
+## Installation
+
+```bash
+# npm
+npm install @aakashwije/lanka-nic
+
+# pnpm
+pnpm add @aakashwije/lanka-nic
+
+# yarn
+yarn add @aakashwije/lanka-nic
+```
+
+Requires **Node.js ≥ 18**. Zero runtime dependencies. Dual ESM + CommonJS output.
+
+---
+
+## Quick Start
+
+```ts
+import { parseNIC, validateNIC, getAge, maskNIC } from '@aakashwije/lanka-nic';
+
+const nic = '950012345V';
+
+validateNIC(nic);   // true
+getAge(nic);        // 30  (computed against today UTC)
+maskNIC(nic);       // '95001****V'
+
+const parsed = parseNIC(nic);
+// {
+//   input:      '950012345V',
+//   normalized: '950012345V',
+//   type:       'old',
+//   valid:      true,
+//   birthYear:  1995,
+//   dayOfYear:  1,
+//   birthDate:  '1995-01-01',
+//   gender:     'male'
+// }
+```
+
+---
+
+## API Reference
+
+### Parsing
+
+#### `safeParse(nic: unknown): SafeParseResult<ParsedNIC>`
+
+The primary entry point. Returns a discriminated union — **never throws**. Accepts `unknown` so it is safe to call directly on unvalidated external input.
+
+```ts
+import { safeParse } from '@aakashwije/lanka-nic';
+
+const result = safeParse(req.body.nic);
+
+if (result.success) {
+  const { birthDate, gender, birthYear } = result.data;
+} else {
+  // result.error is a NICError with .code and .message
+  console.error(result.error.code);  // 'INVALID_FORMAT'
+}
+```
+
+#### `parseNIC(nic: string): ParsedNIC | null`
+
+Returns the parsed result or `null` for any invalid input. Useful with optional chaining.
+
+```ts
+const age = parseNIC(nic)?.birthDate ?? 'unknown';
+```
+
+#### `parseNICOrThrow(nic: string): ParsedNIC`
+
+Throws a `NICError` on invalid input. Use when you control the input and want to fail fast.
+
+#### `getNICType(nic: string): 'old' | 'new' | 'invalid'`
+
+Detects the format without full semantic validation. Useful for routing logic before parsing.
+
+#### `getBirthDate(nic: string): string | null`
+
+Returns the birth date as `YYYY-MM-DD` (UTC) or `null`.
+
+#### `getGender(nic: string): 'male' | 'female' | null`
+
+Resolves gender from the NIC day code.
+
+---
+
+### Validation
+
+#### `validateNIC(nic: string): boolean`
+
+Returns `true` only for fully valid NICs — format, day code range, and date integrity all checked.
+
+---
+
+### Normalization
+
+#### `normalizeNIC(nic: string): string`
+
+Strips surrounding whitespace, collapses internal whitespace, uppercases the check letter for old-format NICs.
+
+```ts
+normalizeNIC('  950012345v  ');  // '950012345V'
+normalizeNIC('1995 001 23456');  // '199500123456'
+```
+
+---
+
+### Masking
+
+#### `maskNIC(nic: string): string`
+
+Masks serial digits for safe logging and display. Returns the (normalized) input as-is for invalid NICs.
+
+```ts
+maskNIC('950012345V');    // '95001****V'     (masks 4 serial digits)
+maskNIC('199500123456');  // '1995001*****'   (masks 5 serial digits)
+```
+
+---
+
+### Age Calculation
+
+#### `getAge(nic: string, opts?: { now?: Date }): number | null`
+
+Calculates the person's age as of today (UTC). Pass `opts.now` to fix the reference date — useful in tests and audits.
+
+#### `getAgeOn(nic: string, date: Date): number | null`
+
+Calculates age as of a specific reference date. Returns `null` if the date precedes the birth date.
+
+```ts
+import { getAge, getAgeOn } from '@aakashwije/lanka-nic';
+
+getAge('950012345V');
+// → current age as of today UTC
+
+getAgeOn('950012345V', new Date('2025-06-01'));
+// → 30
+
+getAge('950012345V', { now: new Date('2030-01-01') });
+// → 35
+```
+
+---
+
+### Format Conversion
+
+#### `convertOldToNew(nic: string): string | null`
+
+Converts a valid old-format NIC to an 11-character new-format representation. Returns `null` for non-old-format input.
+
+```ts
+convertOldToNew('950012345V');  // '19950012345'
+```
+
+> The official 12th check digit cannot be derived from old NIC data. The output is a best-effort 11-digit form; do not treat it as an authoritative new NIC.
+
+---
+
+### Equality
+
+#### `equalsNIC(a: string, b: string): boolean`
+
+Returns `true` when two NICs (old or new format, any casing) refer to the same person and serial — matching on birth year, day-of-year, gender, and serial digits.
+
+```ts
+equalsNIC('950012345V', '950012345v');  // true  (case normalized)
+equalsNIC('950012345V', '950012346V');  // false (different serial)
+```
+
+---
+
+### Type Guards
+
+```ts
+import { isValidNIC, isOldNIC, isNewNIC } from '@aakashwije/lanka-nic';
+
+isValidNIC('950012345V');    // true  — any valid NIC (narrows to string)
+isOldNIC('950012345V');      // true  — valid old-format NIC
+isNewNIC('199500123456');    // true  — valid new-format NIC
+
+// TypeScript narrowing
+function process(value: unknown) {
+  if (isValidNIC(value)) {
+    // value: string
+    parseNIC(value);
+  }
+}
+```
+
+---
+
+### Batch Operations
+
+```ts
+import { validateBatch, parseBatch } from '@aakashwije/lanka-nic';
+
+validateBatch(['950012345V', 'invalid', '199500123456']);
+// [true, false, true]
+
+parseBatch(['950012345V', 'bad']);
+// [ParsedNIC, null]
+```
+
+---
+
+### Test Data Generation
+
+#### `generateNIC(opts: NICGenerateOptions): string`
+
+Generates a syntactically valid NIC for a given birth year, day, gender, and format. Designed for seeding test fixtures.
+
+```ts
+import { generateNIC } from '@aakashwije/lanka-nic';
+
+generateNIC({ year: 1995, dayOfYear: 1, gender: 'male',   format: 'old' });
+// '950011234V'
+
+generateNIC({ year: 1995, dayOfYear: 1, gender: 'female', format: 'new' });
+// '199550100001'  (dayCode = 1 + 500 = 501)
+
+generateNIC({ year: 1995, dayOfYear: 1, gender: 'male', format: 'old', serial: 7 });
+// '950010007V'
+```
+
+| Option | Type | Required | Default | Description |
+|--------|------|----------|---------|-------------|
+| `year` | `number` | ✓ | — | Birth year ≥ 1900. Old format requires 1900–1999. |
+| `dayOfYear` | `number` | ✓ | — | Day of year (1–365/366). |
+| `gender` | `'male' \| 'female'` | ✓ | — | Determines day-code offset (+500 for female). |
+| `format` | `'old' \| 'new'` | ✓ | — | Output format. |
+| `serial` | `number` | — | `1234` | Serial digits. Must be ≥ 0. |
+
+---
+
+### Error Handling
+
+`NICError` extends `Error` with a structured `code` for programmatic branching:
+
+```ts
+import { NICError, parseNICOrThrow } from '@aakashwije/lanka-nic';
+
+try {
+  parseNICOrThrow('not-a-nic');
+} catch (e) {
+  if (e instanceof NICError) {
+    e.code;     // 'INVALID_FORMAT'
+    e.input;    // 'not-a-nic'
+    e.message;  // 'NIC does not match old or new format'
+  }
+}
+```
+
+| Code | Trigger |
+|------|---------|
+| `NON_STRING` | Input is not a string |
+| `EMPTY` | Input is empty or whitespace-only |
+| `INVALID_FORMAT` | Does not match old (`\d{9}[VvXx]`) or new (`\d{12}`) pattern |
+| `INVALID_DAY_CODE` | Day code outside `001–366` and `501–866` |
+| `INVALID_DAY_FOR_YEAR` | Day code maps to a day that does not exist in the year (e.g. day 366 on a non-leap year) |
+| `FUTURE_YEAR` | Birth year is after the current UTC year |
+
+---
+
+### Type Reference
+
+```ts
+type ParsedNIC = {
+  input:      string;             // original input as provided
+  normalized: string;             // whitespace-stripped, suffix uppercased
+  type:       'old' | 'new';
+  valid:      true;
+  birthYear:  number;
+  dayOfYear:  number;             // 1–366, always male-normalised
+  birthDate:  string;             // ISO 8601, UTC e.g. '1995-01-01'
+  gender:     'male' | 'female';
+};
+
+type SafeParseResult<T> =
+  | { success: true;  data:  T        }
+  | { success: false; error: NICError };
+
+type NICErrorCode =
+  | 'EMPTY'
+  | 'NON_STRING'
+  | 'INVALID_FORMAT'
+  | 'INVALID_DAY_CODE'
+  | 'INVALID_DAY_FOR_YEAR'
+  | 'FUTURE_YEAR';
+```
+
+---
+
+## CLI
+
+The `lanka-nic` CLI is bundled with the package.
+
+```bash
+npm install -g @aakashwije/lanka-nic
+# or one-off
+npx @aakashwije/lanka-nic <command> <nic>
+```
+
+### Commands
+
+```
+Usage:
+  lanka-nic validate <nic>
+  lanka-nic parse    <nic>
+  lanka-nic mask     <nic>
+  lanka-nic age      <nic>
+
+If <nic> is omitted, the value is read from stdin.
+```
+
+### Examples
+
+```bash
+# Validate
+$ lanka-nic validate 950012345V
+true
+# exit 0
+
+$ lanka-nic validate bad-input
+false
+# exit 1
+
+# Parse
+$ lanka-nic parse 950012345V
+{
+  "input": "950012345V",
+  "normalized": "950012345V",
+  "type": "old",
+  "valid": true,
+  "birthYear": 1995,
+  "dayOfYear": 1,
+  "birthDate": "1995-01-01",
+  "gender": "male"
+}
+
+# Parse failure → JSON on stderr, exit 1
+$ lanka-nic parse not-a-nic
+{"error":"INVALID_FORMAT","message":"NIC does not match old or new format"}
+
+# Mask
+$ lanka-nic mask 950012345V
+95001****V
+
+# Age
+$ lanka-nic age 950012345V
+30
+
+# Stdin pipeline
+$ echo 950012345V | lanka-nic parse
+$ cat nics.txt | xargs -I{} lanka-nic validate {}
+```
+
+**Exit codes:** `0` success · `1` invalid NIC · `2` usage error
+
+---
+
+## Edge Cases
+
+| Input | Behaviour |
+|-------|-----------|
+| Empty / whitespace-only | Invalid — `EMPTY` |
+| Non-string | Invalid — `NON_STRING` |
+| Day code `000` | Invalid — `INVALID_DAY_CODE` |
+| Day code `367–500` | Invalid — `INVALID_DAY_CODE` |
+| Day code `> 866` | Invalid — `INVALID_DAY_CODE` |
+| Day `366` on a non-leap year | Invalid — `INVALID_DAY_FOR_YEAR` |
+| Future birth year | Invalid — `FUTURE_YEAR` |
+| Lowercase suffix `v` / `x` | Normalized to uppercase |
+| Internal whitespace `93 123 4567 V` | Collapsed and parsed correctly |
+
+---
+
+## Contributing
+
+```bash
+git clone https://github.com/aakashlk/lanka-nic.git
+cd lanka-nic
+npm install
+
+npm test            # run all tests
+npm run coverage    # generate V8 coverage report
+npm run typecheck   # TypeScript type-check only (no emit)
+npm run lint        # ESLint
+npm run format      # Prettier
+npm run build       # tsup dual ESM+CJS build
+```
+
+Commits must follow **Conventional Commits** (`feat:`, `fix:`, `chore:`, `docs:` …). Versioning and changelog are fully automated via `semantic-release`.
+
+---
+
+## License
+
+[MIT](LICENSE) © 2024 Contributors
+
+---
+
+<div align="center">
+<sub>Built with precision. Maintained with intent.</sub>
+</div>