@mikespa/kit 0.1.1

package/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.

package/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

package/dist/format/index.d.ts

@@ -0,0 +1,34 @@
+/** Format a number with locale-aware thousand separators. e.g. 1234567 -> "1 234 567" (fr-CH) */
+declare function formatNumber(value: number, locale?: string, options?: Intl.NumberFormatOptions): string;
+/** Format a number in compact/abbreviated notation. e.g. 1200 -> "1,2 k" (fr-CH) */
+declare function formatCompact(value: number, locale?: string): string;
+/** Format a number as currency. e.g. (1234.5) -> "1 234.50 CHF" (fr-CH) */
+declare function formatCurrency(value: number, currency?: string, locale?: string): string;
+/** Format an amount in CHF with apostrophe thousands separator. e.g. 1234.5 -> "1'234.50 CHF" */
+declare function formatCHF(amount: number): string;
+/** Format a number as a percentage. e.g. 0.456 -> "45,6%" (fr-CH) */
+declare function formatPercent(value: number, locale?: string, fractionDigits?: number): string;
+/** Format a byte count into a human-readable file size. e.g. 1536 -> "1.5 KB" */
+declare function formatBytes(bytes: number, decimals?: number): string;
+
+/**
+ * Thin, opinionated wrappers around `Intl.DateTimeFormat` and `Intl.RelativeTimeFormat`.
+ */
+type DateInput = Date | string | number;
+/** Format a date as DD.MM.YYYY. e.g. "19.06.2026" */
+declare function formatDate(input: DateInput, locale?: string, options?: Intl.DateTimeFormatOptions): string;
+/** Format just the time portion. e.g. "15:30" (24h in fr-CH) */
+declare function formatTime(input: DateInput, locale?: string, options?: Intl.DateTimeFormatOptions): string;
+/** Format date and time together. e.g. "19 juin 2026, 15:30" */
+declare function formatDateTime(input: DateInput, locale?: string, options?: Intl.DateTimeFormatOptions): string;
+/** Format a date relative to now. e.g. "3 hours ago", "in 2 days" */
+declare function formatRelative(input: DateInput, locale?: string, now?: DateInput): string;
+
+/** Formats a duration in seconds: "2h30" or "45min" */
+declare function formatSecs(seconds: number): string;
+/** Formats a duration in seconds: "2h30" or "45min" */
+declare function formatMinutes(minutes: number): string;
+/** Formats a decimal number of hours: "2h30" or "45min" */
+declare function formatHours(hours: number): string;
+
+export { formatBytes, formatCHF, formatCompact, formatCurrency, formatDate, formatDateTime, formatHours, formatMinutes, formatNumber, formatPercent, formatRelative, formatSecs, formatTime };

package/dist/format/index.js

@@ -0,0 +1,108 @@
+// src/format/number.ts
+var DEFAULT_LOCALE = "fr-CH";
+function formatNumber(value, locale = DEFAULT_LOCALE, options) {
+  return new Intl.NumberFormat(locale, options).format(value);
+}
+function formatCompact(value, locale = DEFAULT_LOCALE) {
+  return new Intl.NumberFormat(locale, { notation: "compact" }).format(value);
+}
+function formatCurrency(value, currency = "CHF", locale = DEFAULT_LOCALE) {
+  return new Intl.NumberFormat(locale, { style: "currency", currency }).format(value);
+}
+function formatCHF(amount) {
+  const [int, dec] = amount.toFixed(2).split(".");
+  const intFormatted = int.replace(/\B(?=(\d{3})+(?!\d))/g, "'");
+  return `${intFormatted}.${dec} CHF`;
+}
+function formatPercent(value, locale = DEFAULT_LOCALE, fractionDigits = 1) {
+  return new Intl.NumberFormat(locale, {
+    style: "percent",
+    minimumFractionDigits: 0,
+    maximumFractionDigits: fractionDigits
+  }).format(value);
+}
+function formatBytes(bytes, decimals = 1) {
+  if (bytes === 0) return "0 B";
+  const k = 1024;
+  const sizes = ["B", "KB", "MB", "GB", "TB", "PB"];
+  const i = Math.floor(Math.log(Math.abs(bytes)) / Math.log(k));
+  const value = bytes / Math.pow(k, i);
+  return `${value.toFixed(decimals)} ${sizes[i]}`;
+}
+
+// src/format/date.ts
+var DEFAULT_LOCALE2 = "fr-CH";
+function toDate(input) {
+  return input instanceof Date ? input : new Date(input);
+}
+function formatDate(input, locale = DEFAULT_LOCALE2, options = {}) {
+  return new Intl.DateTimeFormat(locale, options).format(toDate(input));
+}
+function formatTime(input, locale = DEFAULT_LOCALE2, options = { timeStyle: "short" }) {
+  return new Intl.DateTimeFormat(locale, options).format(toDate(input));
+}
+function formatDateTime(input, locale = DEFAULT_LOCALE2, options = { dateStyle: "medium", timeStyle: "short" }) {
+  return new Intl.DateTimeFormat(locale, options).format(toDate(input));
+}
+function formatRelative(input, locale = DEFAULT_LOCALE2, now = /* @__PURE__ */ new Date()) {
+  const diffSeconds = (toDate(input).getTime() - toDate(now).getTime()) / 1e3;
+  const rtf = new Intl.RelativeTimeFormat(locale, { numeric: "auto" });
+  const units = [
+    ["year", 31536e3],
+    ["month", 2592e3],
+    ["week", 604800],
+    ["day", 86400],
+    ["hour", 3600],
+    ["minute", 60],
+    ["second", 1]
+  ];
+  for (const [unit, secondsInUnit] of units) {
+    const delta = diffSeconds / secondsInUnit;
+    if (Math.abs(delta) >= 1 || unit === "second") {
+      return rtf.format(Math.round(delta), unit);
+    }
+  }
+  return rtf.format(0, "second");
+}
+
+// src/format/duration.ts
+function formatSecs(seconds) {
+  const h = Math.floor(seconds / 3600);
+  const m = Math.floor(seconds % 3600 / 60);
+  if (h === 0) return `${m}min`;
+  if (m === 0) return `${h}h`;
+  return `${h}h${String(m).padStart(2, "0")}`;
+}
+function formatMinutes(minutes) {
+  if (minutes === 0) return "0min";
+  else if (minutes < 1) return "<1min";
+  else {
+    const h = Math.floor(minutes / 60);
+    const m = minutes % 60;
+    if (h === 0) return `${m}min`;
+    return `${h}h${String(m).padStart(2, "0")}`;
+  }
+}
+function formatHours(hours) {
+  const h = Math.floor(hours);
+  const m = Math.round((hours - h) * 60);
+  if (h === 0) return `${m}min`;
+  if (m === 0) return `${h}h`;
+  return `${h}h${String(m).padStart(2, "0")}`;
+}
+export {
+  formatBytes,
+  formatCHF,
+  formatCompact,
+  formatCurrency,
+  formatDate,
+  formatDateTime,
+  formatHours,
+  formatMinutes,
+  formatNumber,
+  formatPercent,
+  formatRelative,
+  formatSecs,
+  formatTime
+};
+//# sourceMappingURL=index.js.map

package/dist/format/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/format/number.ts","../../src/format/date.ts","../../src/format/duration.ts"],"sourcesContent":["const DEFAULT_LOCALE = 'fr-CH';\n\n/** Format a number with locale-aware thousand separators. e.g. 1234567 -> \"1 234 567\" (fr-CH) */\nexport function formatNumber(\n  value: number,\n  locale: string = DEFAULT_LOCALE,\n  options?: Intl.NumberFormatOptions\n): string {\n  return new Intl.NumberFormat(locale, options).format(value);\n}\n\n/** Format a number in compact/abbreviated notation. e.g. 1200 -> \"1,2 k\" (fr-CH) */\nexport function formatCompact(\n  value: number,\n  locale: string = DEFAULT_LOCALE\n): string {\n  return new Intl.NumberFormat(locale, { notation: 'compact' }).format(value);\n}\n\n/** Format a number as currency. e.g. (1234.5) -> \"1 234.50 CHF\" (fr-CH) */\nexport function formatCurrency(\n  value: number,\n  currency: string = 'CHF',\n  locale: string = DEFAULT_LOCALE\n): string {\n  return new Intl.NumberFormat(locale, { style: 'currency', currency }).format(value);\n}\n\n/** Format an amount in CHF with apostrophe thousands separator. e.g. 1234.5 -> \"1'234.50 CHF\" */\nexport function formatCHF(amount: number): string {\n  const [int, dec] = amount.toFixed(2).split('.') as [string, string];\n  const intFormatted = int.replace(/\\B(?=(\\d{3})+(?!\\d))/g, \"'\");\n  return `${intFormatted}.${dec} CHF`;\n}\n\n/** Format a number as a percentage. e.g. 0.456 -> \"45,6%\" (fr-CH) */\nexport function formatPercent(\n  value: number,\n  locale: string = DEFAULT_LOCALE,\n  fractionDigits = 1\n): string {\n  return new Intl.NumberFormat(locale, {\n    style: 'percent',\n    minimumFractionDigits: 0,\n    maximumFractionDigits: fractionDigits,\n  }).format(value);\n}\n\n/** Format a byte count into a human-readable file size. e.g. 1536 -> \"1.5 KB\" */\nexport function formatBytes(bytes: number, decimals = 1): string {\n  if (bytes === 0) return '0 B';\n  const k = 1024;\n  const sizes = ['B', 'KB', 'MB', 'GB', 'TB', 'PB'];\n  const i = Math.floor(Math.log(Math.abs(bytes)) / Math.log(k));\n  const value = bytes / Math.pow(k, i);\n  return `${value.toFixed(decimals)} ${sizes[i]!}`;\n}\n","/**\n * Thin, opinionated wrappers around `Intl.DateTimeFormat` and `Intl.RelativeTimeFormat`.\n */\n\nconst DEFAULT_LOCALE = 'fr-CH';\n\ntype DateInput = Date | string | number;\n\nfunction toDate(input: DateInput): Date {\n  return input instanceof Date ? input : new Date(input);\n}\n\n/** Format a date as DD.MM.YYYY. e.g. \"19.06.2026\" */\nexport function formatDate(\n  input: DateInput,\n  locale: string = DEFAULT_LOCALE,\n  options: Intl.DateTimeFormatOptions = {}\n): string {\n  return new Intl.DateTimeFormat(locale, options).format(toDate(input));\n}\n\n/** Format just the time portion. e.g. \"15:30\" (24h in fr-CH) */\nexport function formatTime(\n  input: DateInput,\n  locale: string = DEFAULT_LOCALE,\n  options: Intl.DateTimeFormatOptions = { timeStyle: 'short' }\n): string {\n  return new Intl.DateTimeFormat(locale, options).format(toDate(input));\n}\n\n/** Format date and time together. e.g. \"19 juin 2026, 15:30\" */\nexport function formatDateTime(\n  input: DateInput,\n  locale: string = DEFAULT_LOCALE,\n  options: Intl.DateTimeFormatOptions = { dateStyle: 'medium', timeStyle: 'short' }\n): string {\n  return new Intl.DateTimeFormat(locale, options).format(toDate(input));\n}\n\n/** Format a date relative to now. e.g. \"3 hours ago\", \"in 2 days\" */\nexport function formatRelative(\n  input: DateInput,\n  locale: string = DEFAULT_LOCALE,\n  now: DateInput = new Date()\n): string {\n  const diffSeconds = (toDate(input).getTime() - toDate(now).getTime()) / 1000;\n  const rtf = new Intl.RelativeTimeFormat(locale, { numeric: 'auto' });\n\n  const units: [Intl.RelativeTimeFormatUnit, number][] = [\n    ['year', 31536000],\n    ['month', 2592000],\n    ['week', 604800],\n    ['day', 86400],\n    ['hour', 3600],\n    ['minute', 60],\n    ['second', 1],\n  ];\n\n  for (const [unit, secondsInUnit] of units) {\n    const delta = diffSeconds / secondsInUnit;\n    if (Math.abs(delta) >= 1 || unit === 'second') {\n      return rtf.format(Math.round(delta), unit);\n    }\n  }\n\n  return rtf.format(0, 'second');\n}\n","/** Formats a duration in seconds: \"2h30\" or \"45min\" */\nexport function formatSecs(seconds: number): string {\n  const h = Math.floor(seconds / 3600);\n  const m = Math.floor((seconds % 3600) / 60);\n  if (h === 0) return `${m}min`;\n  if (m === 0) return `${h}h`;\n  return `${h}h${String(m).padStart(2, '0')}`;\n}\n\n/** Formats a duration in seconds: \"2h30\" or \"45min\" */\nexport function formatMinutes(minutes: number): string {\n  if (minutes === 0) return '0min';\n  else if (minutes < 1) return '<1min';\n  else {\n    const h = Math.floor(minutes / 60);\n    const m = minutes % 60;\n    if (h === 0) return `${m}min`;\n    return `${h}h${String(m).padStart(2, '0')}`;\n  }\n}\n\n/** Formats a decimal number of hours: \"2h30\" or \"45min\" */\nexport function formatHours(hours: number): string {\n  const h = Math.floor(hours);\n  const m = Math.round((hours - h) * 60);\n  if (h === 0) return `${m}min`;\n  if (m === 0) return `${h}h`;\n  return `${h}h${String(m).padStart(2, '0')}`;\n}\n"],"mappings":"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","names":["DEFAULT_LOCALE"]}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { formatBytes, formatCHF, formatCompact, formatCurrency, formatDate, formatDateTime, formatHours, formatMinutes, formatNumber, formatPercent, formatRelative, formatSecs, formatTime } from './format/index.js';
+export { capitalize, pluralize, slugify, truncate } from './string/index.js';
+export { calcTimeHours, clamp, lerp, round } from './math/index.js';

package/dist/index.js

@@ -0,0 +1,150 @@
+// src/format/number.ts
+var DEFAULT_LOCALE = "fr-CH";
+function formatNumber(value, locale = DEFAULT_LOCALE, options) {
+  return new Intl.NumberFormat(locale, options).format(value);
+}
+function formatCompact(value, locale = DEFAULT_LOCALE) {
+  return new Intl.NumberFormat(locale, { notation: "compact" }).format(value);
+}
+function formatCurrency(value, currency = "CHF", locale = DEFAULT_LOCALE) {
+  return new Intl.NumberFormat(locale, { style: "currency", currency }).format(value);
+}
+function formatCHF(amount) {
+  const [int, dec] = amount.toFixed(2).split(".");
+  const intFormatted = int.replace(/\B(?=(\d{3})+(?!\d))/g, "'");
+  return `${intFormatted}.${dec} CHF`;
+}
+function formatPercent(value, locale = DEFAULT_LOCALE, fractionDigits = 1) {
+  return new Intl.NumberFormat(locale, {
+    style: "percent",
+    minimumFractionDigits: 0,
+    maximumFractionDigits: fractionDigits
+  }).format(value);
+}
+function formatBytes(bytes, decimals = 1) {
+  if (bytes === 0) return "0 B";
+  const k = 1024;
+  const sizes = ["B", "KB", "MB", "GB", "TB", "PB"];
+  const i = Math.floor(Math.log(Math.abs(bytes)) / Math.log(k));
+  const value = bytes / Math.pow(k, i);
+  return `${value.toFixed(decimals)} ${sizes[i]}`;
+}
+
+// src/format/date.ts
+var DEFAULT_LOCALE2 = "fr-CH";
+function toDate(input) {
+  return input instanceof Date ? input : new Date(input);
+}
+function formatDate(input, locale = DEFAULT_LOCALE2, options = {}) {
+  return new Intl.DateTimeFormat(locale, options).format(toDate(input));
+}
+function formatTime(input, locale = DEFAULT_LOCALE2, options = { timeStyle: "short" }) {
+  return new Intl.DateTimeFormat(locale, options).format(toDate(input));
+}
+function formatDateTime(input, locale = DEFAULT_LOCALE2, options = { dateStyle: "medium", timeStyle: "short" }) {
+  return new Intl.DateTimeFormat(locale, options).format(toDate(input));
+}
+function formatRelative(input, locale = DEFAULT_LOCALE2, now = /* @__PURE__ */ new Date()) {
+  const diffSeconds = (toDate(input).getTime() - toDate(now).getTime()) / 1e3;
+  const rtf = new Intl.RelativeTimeFormat(locale, { numeric: "auto" });
+  const units = [
+    ["year", 31536e3],
+    ["month", 2592e3],
+    ["week", 604800],
+    ["day", 86400],
+    ["hour", 3600],
+    ["minute", 60],
+    ["second", 1]
+  ];
+  for (const [unit, secondsInUnit] of units) {
+    const delta = diffSeconds / secondsInUnit;
+    if (Math.abs(delta) >= 1 || unit === "second") {
+      return rtf.format(Math.round(delta), unit);
+    }
+  }
+  return rtf.format(0, "second");
+}
+
+// src/format/duration.ts
+function formatSecs(seconds) {
+  const h = Math.floor(seconds / 3600);
+  const m = Math.floor(seconds % 3600 / 60);
+  if (h === 0) return `${m}min`;
+  if (m === 0) return `${h}h`;
+  return `${h}h${String(m).padStart(2, "0")}`;
+}
+function formatMinutes(minutes) {
+  if (minutes === 0) return "0min";
+  else if (minutes < 1) return "<1min";
+  else {
+    const h = Math.floor(minutes / 60);
+    const m = minutes % 60;
+    if (h === 0) return `${m}min`;
+    return `${h}h${String(m).padStart(2, "0")}`;
+  }
+}
+function formatHours(hours) {
+  const h = Math.floor(hours);
+  const m = Math.round((hours - h) * 60);
+  if (h === 0) return `${m}min`;
+  if (m === 0) return `${h}h`;
+  return `${h}h${String(m).padStart(2, "0")}`;
+}
+
+// src/string/index.ts
+function slugify(input) {
+  return input.normalize("NFKD").replace(/[\u0300-\u036f]/g, "").toLowerCase().trim().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function truncate(input, maxLength, suffix = "\u2026") {
+  if (input.length <= maxLength) return input;
+  return input.slice(0, Math.max(0, maxLength - suffix.length)) + suffix;
+}
+function capitalize(input) {
+  if (!input) return input;
+  return input[0].toUpperCase() + input.slice(1);
+}
+function pluralize(count, singular, plural) {
+  const word = count === 1 ? singular : plural ?? `${singular}s`;
+  return `${count} ${word}`;
+}
+
+// src/math/index.ts
+function clamp(value, min, max) {
+  return Math.min(Math.max(value, min), max);
+}
+function lerp(start, end, t) {
+  return start + (end - start) * t;
+}
+function round(value, decimals = 0) {
+  const factor = 10 ** decimals;
+  return Math.round(value * factor) / factor;
+}
+function calcTimeHours(start, end) {
+  const [sh, sm] = start.split(":").map(Number);
+  const [eh, em] = end.split(":").map(Number);
+  return Math.max(0, (eh * 60 + em - (sh * 60 + sm)) / 60);
+}
+export {
+  calcTimeHours,
+  capitalize,
+  clamp,
+  formatBytes,
+  formatCHF,
+  formatCompact,
+  formatCurrency,
+  formatDate,
+  formatDateTime,
+  formatHours,
+  formatMinutes,
+  formatNumber,
+  formatPercent,
+  formatRelative,
+  formatSecs,
+  formatTime,
+  lerp,
+  pluralize,
+  round,
+  slugify,
+  truncate
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/format/number.ts","../src/format/date.ts","../src/format/duration.ts","../src/string/index.ts","../src/math/index.ts"],"sourcesContent":["const DEFAULT_LOCALE = 'fr-CH';\n\n/** Format a number with locale-aware thousand separators. e.g. 1234567 -> \"1 234 567\" (fr-CH) */\nexport function formatNumber(\n  value: number,\n  locale: string = DEFAULT_LOCALE,\n  options?: Intl.NumberFormatOptions\n): string {\n  return new Intl.NumberFormat(locale, options).format(value);\n}\n\n/** Format a number in compact/abbreviated notation. e.g. 1200 -> \"1,2 k\" (fr-CH) */\nexport function formatCompact(\n  value: number,\n  locale: string = DEFAULT_LOCALE\n): string {\n  return new Intl.NumberFormat(locale, { notation: 'compact' }).format(value);\n}\n\n/** Format a number as currency. e.g. (1234.5) -> \"1 234.50 CHF\" (fr-CH) */\nexport function formatCurrency(\n  value: number,\n  currency: string = 'CHF',\n  locale: string = DEFAULT_LOCALE\n): string {\n  return new Intl.NumberFormat(locale, { style: 'currency', currency }).format(value);\n}\n\n/** Format an amount in CHF with apostrophe thousands separator. e.g. 1234.5 -> \"1'234.50 CHF\" */\nexport function formatCHF(amount: number): string {\n  const [int, dec] = amount.toFixed(2).split('.') as [string, string];\n  const intFormatted = int.replace(/\\B(?=(\\d{3})+(?!\\d))/g, \"'\");\n  return `${intFormatted}.${dec} CHF`;\n}\n\n/** Format a number as a percentage. e.g. 0.456 -> \"45,6%\" (fr-CH) */\nexport function formatPercent(\n  value: number,\n  locale: string = DEFAULT_LOCALE,\n  fractionDigits = 1\n): string {\n  return new Intl.NumberFormat(locale, {\n    style: 'percent',\n    minimumFractionDigits: 0,\n    maximumFractionDigits: fractionDigits,\n  }).format(value);\n}\n\n/** Format a byte count into a human-readable file size. e.g. 1536 -> \"1.5 KB\" */\nexport function formatBytes(bytes: number, decimals = 1): string {\n  if (bytes === 0) return '0 B';\n  const k = 1024;\n  const sizes = ['B', 'KB', 'MB', 'GB', 'TB', 'PB'];\n  const i = Math.floor(Math.log(Math.abs(bytes)) / Math.log(k));\n  const value = bytes / Math.pow(k, i);\n  return `${value.toFixed(decimals)} ${sizes[i]!}`;\n}\n","/**\n * Thin, opinionated wrappers around `Intl.DateTimeFormat` and `Intl.RelativeTimeFormat`.\n */\n\nconst DEFAULT_LOCALE = 'fr-CH';\n\ntype DateInput = Date | string | number;\n\nfunction toDate(input: DateInput): Date {\n  return input instanceof Date ? input : new Date(input);\n}\n\n/** Format a date as DD.MM.YYYY. e.g. \"19.06.2026\" */\nexport function formatDate(\n  input: DateInput,\n  locale: string = DEFAULT_LOCALE,\n  options: Intl.DateTimeFormatOptions = {}\n): string {\n  return new Intl.DateTimeFormat(locale, options).format(toDate(input));\n}\n\n/** Format just the time portion. e.g. \"15:30\" (24h in fr-CH) */\nexport function formatTime(\n  input: DateInput,\n  locale: string = DEFAULT_LOCALE,\n  options: Intl.DateTimeFormatOptions = { timeStyle: 'short' }\n): string {\n  return new Intl.DateTimeFormat(locale, options).format(toDate(input));\n}\n\n/** Format date and time together. e.g. \"19 juin 2026, 15:30\" */\nexport function formatDateTime(\n  input: DateInput,\n  locale: string = DEFAULT_LOCALE,\n  options: Intl.DateTimeFormatOptions = { dateStyle: 'medium', timeStyle: 'short' }\n): string {\n  return new Intl.DateTimeFormat(locale, options).format(toDate(input));\n}\n\n/** Format a date relative to now. e.g. \"3 hours ago\", \"in 2 days\" */\nexport function formatRelative(\n  input: DateInput,\n  locale: string = DEFAULT_LOCALE,\n  now: DateInput = new Date()\n): string {\n  const diffSeconds = (toDate(input).getTime() - toDate(now).getTime()) / 1000;\n  const rtf = new Intl.RelativeTimeFormat(locale, { numeric: 'auto' });\n\n  const units: [Intl.RelativeTimeFormatUnit, number][] = [\n    ['year', 31536000],\n    ['month', 2592000],\n    ['week', 604800],\n    ['day', 86400],\n    ['hour', 3600],\n    ['minute', 60],\n    ['second', 1],\n  ];\n\n  for (const [unit, secondsInUnit] of units) {\n    const delta = diffSeconds / secondsInUnit;\n    if (Math.abs(delta) >= 1 || unit === 'second') {\n      return rtf.format(Math.round(delta), unit);\n    }\n  }\n\n  return rtf.format(0, 'second');\n}\n","/** Formats a duration in seconds: \"2h30\" or \"45min\" */\nexport function formatSecs(seconds: number): string {\n  const h = Math.floor(seconds / 3600);\n  const m = Math.floor((seconds % 3600) / 60);\n  if (h === 0) return `${m}min`;\n  if (m === 0) return `${h}h`;\n  return `${h}h${String(m).padStart(2, '0')}`;\n}\n\n/** Formats a duration in seconds: \"2h30\" or \"45min\" */\nexport function formatMinutes(minutes: number): string {\n  if (minutes === 0) return '0min';\n  else if (minutes < 1) return '<1min';\n  else {\n    const h = Math.floor(minutes / 60);\n    const m = minutes % 60;\n    if (h === 0) return `${m}min`;\n    return `${h}h${String(m).padStart(2, '0')}`;\n  }\n}\n\n/** Formats a decimal number of hours: \"2h30\" or \"45min\" */\nexport function formatHours(hours: number): string {\n  const h = Math.floor(hours);\n  const m = Math.round((hours - h) * 60);\n  if (h === 0) return `${m}min`;\n  if (m === 0) return `${h}h`;\n  return `${h}h${String(m).padStart(2, '0')}`;\n}\n","/** Convert a string into a URL-friendly slug. e.g. \"Hello, World!\" -> \"hello-world\" */\nexport function slugify(input: string): string {\n  return input\n    .normalize('NFKD')\n    .replace(/[\\u0300-\\u036f]/g, '') // strip accents\n    .toLowerCase()\n    .trim()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '');\n}\n\n/** Truncate a string to a max length, appending a suffix if it was cut. */\nexport function truncate(input: string, maxLength: number, suffix = '…'): string {\n  if (input.length <= maxLength) return input;\n  return input.slice(0, Math.max(0, maxLength - suffix.length)) + suffix;\n}\n\n/** Capitalize the first letter of a string. */\nexport function capitalize(input: string): string {\n  if (!input) return input;\n  return input[0]!.toUpperCase() + input.slice(1);\n}\n\n/**\n * Naive English pluralizer for simple cases. For anything locale-sensitive,\n * prefer `Intl.PluralRules` directly.\n * e.g. pluralize(1, 'item') -> \"1 item\", pluralize(2, 'item') -> \"2 items\"\n */\nexport function pluralize(count: number, singular: string, plural?: string): string {\n  const word = count === 1 ? singular : plural ?? `${singular}s`;\n  return `${count} ${word}`;\n}\n","/** Clamp a number between a min and max (inclusive). */\nexport function clamp(value: number, min: number, max: number): number {\n  return Math.min(Math.max(value, min), max);\n}\n\n/** Linearly interpolate between two numbers by t (0-1). */\nexport function lerp(start: number, end: number, t: number): number {\n  return start + (end - start) * t;\n}\n\n/** Round a number to a given number of decimal places. */\nexport function round(value: number, decimals = 0): number {\n  const factor = 10 ** decimals;\n  return Math.round(value * factor) / factor;\n}\n\n/** Returns the hours between two \"HH:MM\" time strings (0 if end <= start). */\nexport function calcTimeHours(start: string, end: string): number {\n  const [sh, sm] = start.split(':').map(Number) as [number, number];\n  const [eh, em] = end.split(':').map(Number) as [number, number];\n  return Math.max(0, (eh * 60 + em - (sh * 60 + sm)) / 60);\n}\n"],"mappings":"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","names":["DEFAULT_LOCALE"]}

package/dist/math/index.d.ts

@@ -0,0 +1,10 @@
+/** Clamp a number between a min and max (inclusive). */
+declare function clamp(value: number, min: number, max: number): number;
+/** Linearly interpolate between two numbers by t (0-1). */
+declare function lerp(start: number, end: number, t: number): number;
+/** Round a number to a given number of decimal places. */
+declare function round(value: number, decimals?: number): number;
+/** Returns the hours between two "HH:MM" time strings (0 if end <= start). */
+declare function calcTimeHours(start: string, end: string): number;
+
+export { calcTimeHours, clamp, lerp, round };

package/dist/math/index.js

@@ -0,0 +1,23 @@
+// src/math/index.ts
+function clamp(value, min, max) {
+  return Math.min(Math.max(value, min), max);
+}
+function lerp(start, end, t) {
+  return start + (end - start) * t;
+}
+function round(value, decimals = 0) {
+  const factor = 10 ** decimals;
+  return Math.round(value * factor) / factor;
+}
+function calcTimeHours(start, end) {
+  const [sh, sm] = start.split(":").map(Number);
+  const [eh, em] = end.split(":").map(Number);
+  return Math.max(0, (eh * 60 + em - (sh * 60 + sm)) / 60);
+}
+export {
+  calcTimeHours,
+  clamp,
+  lerp,
+  round
+};
+//# sourceMappingURL=index.js.map

package/dist/math/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/math/index.ts"],"sourcesContent":["/** Clamp a number between a min and max (inclusive). */\nexport function clamp(value: number, min: number, max: number): number {\n  return Math.min(Math.max(value, min), max);\n}\n\n/** Linearly interpolate between two numbers by t (0-1). */\nexport function lerp(start: number, end: number, t: number): number {\n  return start + (end - start) * t;\n}\n\n/** Round a number to a given number of decimal places. */\nexport function round(value: number, decimals = 0): number {\n  const factor = 10 ** decimals;\n  return Math.round(value * factor) / factor;\n}\n\n/** Returns the hours between two \"HH:MM\" time strings (0 if end <= start). */\nexport function calcTimeHours(start: string, end: string): number {\n  const [sh, sm] = start.split(':').map(Number) as [number, number];\n  const [eh, em] = end.split(':').map(Number) as [number, number];\n  return Math.max(0, (eh * 60 + em - (sh * 60 + sm)) / 60);\n}\n"],"mappings":";AACO,SAAS,MAAM,OAAe,KAAa,KAAqB;AACrE,SAAO,KAAK,IAAI,KAAK,IAAI,OAAO,GAAG,GAAG,GAAG;AAC3C;AAGO,SAAS,KAAK,OAAe,KAAa,GAAmB;AAClE,SAAO,SAAS,MAAM,SAAS;AACjC;AAGO,SAAS,MAAM,OAAe,WAAW,GAAW;AACzD,QAAM,SAAS,MAAM;AACrB,SAAO,KAAK,MAAM,QAAQ,MAAM,IAAI;AACtC;AAGO,SAAS,cAAc,OAAe,KAAqB;AAChE,QAAM,CAAC,IAAI,EAAE,IAAI,MAAM,MAAM,GAAG,EAAE,IAAI,MAAM;AAC5C,QAAM,CAAC,IAAI,EAAE,IAAI,IAAI,MAAM,GAAG,EAAE,IAAI,MAAM;AAC1C,SAAO,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM,KAAK,KAAK,OAAO,EAAE;AACzD;","names":[]}

package/dist/string/index.d.ts

@@ -0,0 +1,14 @@
+/** Convert a string into a URL-friendly slug. e.g. "Hello, World!" -> "hello-world" */
+declare function slugify(input: string): string;
+/** Truncate a string to a max length, appending a suffix if it was cut. */
+declare function truncate(input: string, maxLength: number, suffix?: string): string;
+/** Capitalize the first letter of a string. */
+declare function capitalize(input: string): string;
+/**
+ * Naive English pluralizer for simple cases. For anything locale-sensitive,
+ * prefer `Intl.PluralRules` directly.
+ * e.g. pluralize(1, 'item') -> "1 item", pluralize(2, 'item') -> "2 items"
+ */
+declare function pluralize(count: number, singular: string, plural?: string): string;
+
+export { capitalize, pluralize, slugify, truncate };

package/dist/string/index.js

@@ -0,0 +1,23 @@
+// src/string/index.ts
+function slugify(input) {
+  return input.normalize("NFKD").replace(/[\u0300-\u036f]/g, "").toLowerCase().trim().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function truncate(input, maxLength, suffix = "\u2026") {
+  if (input.length <= maxLength) return input;
+  return input.slice(0, Math.max(0, maxLength - suffix.length)) + suffix;
+}
+function capitalize(input) {
+  if (!input) return input;
+  return input[0].toUpperCase() + input.slice(1);
+}
+function pluralize(count, singular, plural) {
+  const word = count === 1 ? singular : plural ?? `${singular}s`;
+  return `${count} ${word}`;
+}
+export {
+  capitalize,
+  pluralize,
+  slugify,
+  truncate
+};
+//# sourceMappingURL=index.js.map

package/dist/string/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/string/index.ts"],"sourcesContent":["/** Convert a string into a URL-friendly slug. e.g. \"Hello, World!\" -> \"hello-world\" */\nexport function slugify(input: string): string {\n  return input\n    .normalize('NFKD')\n    .replace(/[\\u0300-\\u036f]/g, '') // strip accents\n    .toLowerCase()\n    .trim()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '');\n}\n\n/** Truncate a string to a max length, appending a suffix if it was cut. */\nexport function truncate(input: string, maxLength: number, suffix = '…'): string {\n  if (input.length <= maxLength) return input;\n  return input.slice(0, Math.max(0, maxLength - suffix.length)) + suffix;\n}\n\n/** Capitalize the first letter of a string. */\nexport function capitalize(input: string): string {\n  if (!input) return input;\n  return input[0]!.toUpperCase() + input.slice(1);\n}\n\n/**\n * Naive English pluralizer for simple cases. For anything locale-sensitive,\n * prefer `Intl.PluralRules` directly.\n * e.g. pluralize(1, 'item') -> \"1 item\", pluralize(2, 'item') -> \"2 items\"\n */\nexport function pluralize(count: number, singular: string, plural?: string): string {\n  const word = count === 1 ? singular : plural ?? `${singular}s`;\n  return `${count} ${word}`;\n}\n"],"mappings":";AACO,SAAS,QAAQ,OAAuB;AAC7C,SAAO,MACJ,UAAU,MAAM,EAChB,QAAQ,oBAAoB,EAAE,EAC9B,YAAY,EACZ,KAAK,EACL,QAAQ,eAAe,GAAG,EAC1B,QAAQ,YAAY,EAAE;AAC3B;AAGO,SAAS,SAAS,OAAe,WAAmB,SAAS,UAAa;AAC/E,MAAI,MAAM,UAAU,UAAW,QAAO;AACtC,SAAO,MAAM,MAAM,GAAG,KAAK,IAAI,GAAG,YAAY,OAAO,MAAM,CAAC,IAAI;AAClE;AAGO,SAAS,WAAW,OAAuB;AAChD,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO,MAAM,CAAC,EAAG,YAAY,IAAI,MAAM,MAAM,CAAC;AAChD;AAOO,SAAS,UAAU,OAAe,UAAkB,QAAyB;AAClF,QAAM,OAAO,UAAU,IAAI,WAAW,UAAU,GAAG,QAAQ;AAC3D,SAAO,GAAG,KAAK,IAAI,IAAI;AACzB;","names":[]}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@mikespa/kit",
+  "version": "0.1.1",
+  "description": "Personal toolkit of small, framework-agnostic utilities (formatting, strings, math).",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./format": {
+      "types": "./dist/format/index.d.ts",
+      "import": "./dist/format/index.js"
+    },
+    "./string": {
+      "types": "./dist/string/index.d.ts",
+      "import": "./dist/string/index.js"
+    },
+    "./math": {
+      "types": "./dist/math/index.d.ts",
+      "import": "./dist/math/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  }
+}