feat: initial release

Author: MikeSpa

.github/workflows/ci.yml

@@ -0,0 +1,34 @@
+name: CI
+
+on:
+  push:
+    branches: ['**']
+  pull_request:
+    branches: ['**']
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [20.x, 22.x]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Typecheck
+        run: npm run typecheck
+
+      - name: Test
+        run: npm test
+
+      - name: Build
+        run: npm run build

.github/workflows/publish.yml

@@ -0,0 +1,31 @@
+name: Publish
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20.x
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Test
+        run: npm test
+
+      - name: Publish to npm
+        run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -0,0 +1,7 @@
+node_modules/
+dist/
+*.log
+.DS_Store
+
+
+.ignore/

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mikespa
+
+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.

README.md

@@ -0,0 +1,104 @@
+# @mikespa/kit
+
+A small, framework-agnostic personal toolkit. Built to stop copy-pasting the
+same `formatCHF` / `slugify` / `clamp` functions between Next.js projects.
+
+No runtime dependencies. Tree-shakeable via subpath exports.
+
+## Install
+
+```bash
+npm install @mikespa/kit
+```
+
+## Usage
+
+Import only what you need via subpaths — this keeps bundles small and is
+self-documenting at the call site.
+
+```ts
+import { formatDate, formatCHF, formatSecs, formatHours } from '@mikespa/kit/format';
+import { slugify, truncate } from '@mikespa/kit/string';
+import { clamp, calcTimeHours } from '@mikespa/kit/math';
+
+formatDate('2026-06-19');         // "19.06.2026"
+formatCHF(1234.5);                // "1'234.50 CHF"
+formatSecs(9000);                 // "2h30"
+formatHours(2.5);                 // "2h30"
+slugify('Hello, World!');         // "hello-world"
+clamp(15, 0, 10);                 // 10
+calcTimeHours('08:00', '10:30'); // 2.5
+```
+
+Or import everything from the root if you don't care about tree-shaking:
+
+```ts
+import { formatCHF, slugify, clamp } from '@mikespa/kit';
+```
+
+## Modules
+
+### `./format`
+
+| Function | Description | Default output |
+| --- | --- | --- |
+| `formatDate(input)` | Date as DD.MM.YYYY | "19.06.2026" |
+| `formatTime(input)` | Time (24h) | "15:30" |
+| `formatDateTime(input)` | Date + time | "19 juin 2026, 15:30" |
+| `formatRelative(input)` | Relative to now | "il y a 3 heures" |
+| `formatNumber(value)` | Locale-aware thousands | "1 234 567" |
+| `formatCHF(amount)` | Swiss CHF, apostrophe sep. | "1'234.50 CHF" |
+| `formatCurrency(value)` | Intl currency (CHF default) | "1 234.50 CHF" |
+| `formatCompact(value)` | Compact notation | "1,2 k" |
+| `formatPercent(value)` | Percentage | "45,6%" |
+| `formatBytes(bytes)` | Human-readable file size | "1.5 KB" |
+| `formatSecs(seconds)` | Duration from seconds | "2h30" / "45min" |
+| `formatHours(hours)` | Duration from decimal hours | "2h30" / "45min" |
+
+All `format*` functions that wrap `Intl` accept an optional `locale` parameter
+(defaults to `'fr-CH'`) so consuming projects can override per-call.
+
+### `./string`
+
+| Function | Description |
+| --- | --- |
+| `slugify(input)` | URL-friendly slug |
+| `truncate(input, maxLength)` | Truncate with suffix |
+| `capitalize(input)` | First letter uppercase |
+| `pluralize(count, singular)` | Simple pluralizer |
+
+### `./math`
+
+| Function | Description |
+| --- | --- |
+| `clamp(value, min, max)` | Clamp to range |
+| `lerp(start, end, t)` | Linear interpolate |
+| `round(value, decimals)` | Round to N decimals |
+| `calcTimeHours(start, end)` | Hours between "HH:MM" strings |
+
+## Development
+
+```bash
+npm install
+npm run dev          # build in watch mode
+npm run build        # build once (output -> dist/)
+npm test             # run tests
+npm run test:watch
+npm run typecheck
+```
+
+## Publishing
+
+```bash
+npm version patch    # or minor / major
+git push --follow-tags
+```
+
+The `publish` workflow runs automatically on any `v*.*.*` tag push.
+`prepublishOnly` runs the build, so `dist/` is always fresh.
+
+You need an `NPM_TOKEN` secret set in the GitHub repo settings.
+
+## License
+
+MIT