@lacspace/humanize 1.0.0

package/LICENSE

@@ -0,0 +1,51 @@
+Lacspace Free Licence
+Version 1.0, August 2026
+
+Copyright (c) 2026 Lacspace
+
+PREAMBLE
+
+This software is published by Lacspace under the Lacspace Free Licence — a free,
+permissive licence that lets you use this software for any purpose, including in
+commercial products and services, at no cost. It grants the same freedoms as
+common permissive open-source licences; the only condition is that this notice
+travels with the software. The canonical, always-current text of this licence is
+maintained at https://lacspace.com/licenses/lacspace-free-1.0
+
+GRANT OF RIGHTS
+
+Permission is hereby granted, free of charge, to any person or organisation
+obtaining a copy of this software and its associated documentation and data 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 conditions below. These rights are
+granted for any purpose, personal or commercial, and are perpetual, worldwide,
+non-exclusive, and royalty-free.
+
+CONDITIONS
+
+The above copyright notice, this permission notice, and the name of this licence
+("Lacspace Free Licence") shall be included in all copies or substantial portions
+of the Software.
+
+TRADEMARKS
+
+This licence does not grant permission to use the trade names, trademarks, service
+marks, logos, or product names of Lacspace, except as required to reproduce the
+notice above or to describe the origin of the Software in a truthful manner.
+
+DISCLAIMER OF WARRANTY AND LIMITATION OF LIABILITY
+
+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.
+
+---
+
+The Lacspace Free Licence is a source-available, permissive licence and is not (as
+of this version) an OSI-approved licence. In substance it grants the same freedoms
+as the MIT Licence. Learn more at https://lacspace.com/licenses

package/README.md

@@ -0,0 +1,69 @@
+<div align="center">
+
+# @lacspace/humanize
+
+**Turn machine values into human-readable text — bytes, durations, relative time, ordinals, plurals, compact numbers & lists.**
+
+[![npm version](https://img.shields.io/npm/v/@lacspace/humanize?color=%2316a34a&label=npm)](https://www.npmjs.com/package/@lacspace/humanize)
+[![minzipped](https://img.shields.io/bundlephobia/minzip/@lacspace/humanize?label=minzip)](https://bundlephobia.com/package/@lacspace/humanize)
+[![types](https://img.shields.io/badge/types-included-blue)](https://www.npmjs.com/package/@lacspace/humanize)
+[![license](https://img.shields.io/npm/l/@lacspace/humanize?color=green)](https://github.com/lacspace/npm-packages/blob/main/LICENSE)
+
+</div>
+
+> All the little "make it readable" helpers you reach for on every UI — instead of installing `pretty-bytes` + `ms` + `humanize-duration` + a pluralize lib, get them as one tiny, typed, dependency-free package.
+
+- 💾 `bytes` / `parseBytes` — `1536 → "1.5 KB"` (and IEC KiB)
+- ⏱️ `duration` — `90061000 → "1d 1h"` (or long form)
+- 🕒 `relativeTime` — `"3 hours ago"` / `"in 2 days"`
+- 🔢 `ordinal`, `compact` (`1.2M`), `number` (grouping)
+- ✍️ `pluralize`, `list` (`"a, b and c"`), `truncate`, `titleCase`
+
+## Install
+
+```bash
+npm install @lacspace/humanize      # or pnpm add / yarn add / bun add
+```
+
+## Use
+
+```ts
+import { bytes, duration, relativeTime, compact, ordinal, pluralize, list } from "@lacspace/humanize";
+
+bytes(1536);                       // "1.5 KB"
+duration(90061000);                // "1d 1h"
+relativeTime(Date.now() - 3.6e6);  // "1 hour ago"
+compact(1234567);                  // "1.2M"
+ordinal(21);                       // "21st"
+pluralize(3, "city");              // "3 cities"
+list(["red", "green", "blue"]);    // "red, green and blue"
+```
+
+## API
+
+| Group | Functions |
+| --- | --- |
+| Size | `bytes`, `parseBytes` |
+| Time | `duration`, `relativeTime` |
+| Numbers | `ordinal`, `compact`, `number` |
+| Words | `pluralize`, `plural`, `list`, `truncate`, `titleCase` |
+
+Options let you switch to IEC units, long durations, more precision, Oxford commas and custom separators.
+
+## Licensing
+
+This package is **free** under the **[Lacspace Free Licence](https://lacspace.com/licenses/lacspace-free-1.0)** — MIT-equivalent freedoms. Use it in personal and commercial projects at no cost; just keep the notice.
+
+Not every Lacspace package is free. We also offer **Commercial**, **Client-specific** and **Private** packages under separate terms — see the **[Lacspace Licence Centre](https://lacspace.com/licenses)**.
+
+---
+
+<div align="center">
+
+**Part of the Lacspace ecosystem — zero-dependency, isomorphic TypeScript packages.**
+
+[All packages ↗](https://lacspace.com/packages) · [npm org ↗](https://www.npmjs.com/org/lacspace) · [Licence Centre ↗](https://lacspace.com/licenses) · [GitHub ↗](https://github.com/lacspace/npm-packages)
+
+</div>
+
+<div align="center"><sub>Built with care by <a href="https://lacspace.com">Lacspace</a> · Lacspace Free Licence · <a href="https://github.com/lacspace/npm-packages">source</a></sub></div>

package/dist/index.cjs

@@ -0,0 +1,144 @@
+'use strict';
+
+// src/index.ts
+var BYTE_UNITS = ["B", "KB", "MB", "GB", "TB", "PB", "EB"];
+var BYTE_UNITS_IEC = ["B", "KiB", "MiB", "GiB", "TiB", "PiB", "EiB"];
+function bytes(n, opts = {}) {
+  const base = opts.binary ? 1024 : 1e3;
+  const units = opts.binary ? BYTE_UNITS_IEC : BYTE_UNITS;
+  const neg = n < 0 ? "-" : "";
+  let v = Math.abs(n);
+  if (v < base) return `${neg}${v} B`;
+  let i = 0;
+  while (v >= base && i < units.length - 1) {
+    v /= base;
+    i++;
+  }
+  const dp = opts.decimals ?? 1;
+  return `${neg}${v.toFixed(dp)} ${units[i]}`;
+}
+function parseBytes(input) {
+  const m = /^\s*(-?[\d.]+)\s*([a-z]+)?\s*$/i.exec(input);
+  if (!m) return NaN;
+  const value = parseFloat(m[1]);
+  const unit = (m[2] ?? "B").toUpperCase();
+  const binary = unit.includes("I");
+  const idx = (binary ? BYTE_UNITS_IEC : BYTE_UNITS).findIndex((u) => u.toUpperCase() === unit);
+  if (idx === -1) return unit === "B" ? value : NaN;
+  return value * (binary ? 1024 : 1e3) ** idx;
+}
+var DUR = [
+  { u: "y", ms: 31536e6, long: "year" },
+  { u: "mo", ms: 2592e6, long: "month" },
+  { u: "d", ms: 864e5, long: "day" },
+  { u: "h", ms: 36e5, long: "hour" },
+  { u: "m", ms: 6e4, long: "minute" },
+  { u: "s", ms: 1e3, long: "second" },
+  { u: "ms", ms: 1, long: "millisecond" }
+];
+function duration(ms, opts = {}) {
+  const max = opts.units ?? 2;
+  let rem = Math.abs(Math.round(ms));
+  if (rem === 0) return opts.long ? "0 seconds" : "0s";
+  const parts = [];
+  for (const d of DUR) {
+    if (rem < d.ms) continue;
+    const count = Math.floor(rem / d.ms);
+    rem -= count * d.ms;
+    parts.push(opts.long ? `${count} ${plural(d.long, count)}` : `${count}${d.u}`);
+    if (parts.length >= max) break;
+  }
+  return (ms < 0 ? "-" : "") + parts.join(opts.long ? " " : " ");
+}
+var RT = [
+  [31536e3, "year"],
+  [2592e3, "month"],
+  [604800, "week"],
+  [86400, "day"],
+  [3600, "hour"],
+  [60, "minute"],
+  [1, "second"]
+];
+function relativeTime(date, base = Date.now()) {
+  const t = date instanceof Date ? date.getTime() : typeof date === "string" ? new Date(date).getTime() : date;
+  const b = base instanceof Date ? base.getTime() : base;
+  const diff = Math.round((b - t) / 1e3);
+  const abs = Math.abs(diff);
+  if (abs < 5) return "just now";
+  for (const [secs, unit] of RT) {
+    if (abs >= secs) {
+      const count = Math.floor(abs / secs);
+      const label = `${count} ${plural(unit, count)}`;
+      return diff >= 0 ? `${label} ago` : `in ${label}`;
+    }
+  }
+  return "just now";
+}
+function ordinal(n) {
+  const abs = Math.abs(n) % 100;
+  const last = abs % 10;
+  const suffix = abs >= 11 && abs <= 13 ? "th" : last === 1 ? "st" : last === 2 ? "nd" : last === 3 ? "rd" : "th";
+  return `${n}${suffix}`;
+}
+function compact(n, decimals = 1) {
+  const neg = n < 0 ? "-" : "";
+  const v = Math.abs(n);
+  const units = [[1e12, "T"], [1e9, "B"], [1e6, "M"], [1e3, "K"]];
+  for (const [threshold, u] of units) {
+    if (v >= threshold) {
+      const num = v / threshold;
+      return `${neg}${num % 1 === 0 ? num.toFixed(0) : num.toFixed(decimals)}${u}`;
+    }
+  }
+  return `${neg}${v}`;
+}
+function number(n, opts = {}) {
+  const sep = opts.separator ?? ",";
+  const dec = opts.decimal ?? ".";
+  const [int, frac] = String(n).split(".");
+  const sign = int.startsWith("-") ? "-" : "";
+  const digits = int.replace("-", "").replace(/\B(?=(\d{3})+(?!\d))/g, sep);
+  return sign + digits + (frac ? dec + frac : "");
+}
+function plural(word, count, pluralForm) {
+  if (count === 1) return word;
+  if (pluralForm) return pluralForm;
+  if (/(s|x|z|ch|sh)$/i.test(word)) return `${word}es`;
+  if (/[^aeiou]y$/i.test(word)) return `${word.slice(0, -1)}ies`;
+  return `${word}s`;
+}
+function pluralize(count, word, pluralForm) {
+  return `${count} ${plural(word, count, pluralForm)}`;
+}
+function list(items, opts = {}) {
+  const conj = opts.conjunction ?? "and";
+  if (items.length === 0) return "";
+  if (items.length === 1) return items[0];
+  if (items.length === 2) return `${items[0]} ${conj} ${items[1]}`;
+  const head = items.slice(0, -1).join(", ");
+  return `${head}${opts.oxford ? "," : ""} ${conj} ${items[items.length - 1]}`;
+}
+function truncate(text, maxLength, ellipsis = "\u2026") {
+  if (text.length <= maxLength) return text;
+  const cut = text.slice(0, maxLength - ellipsis.length);
+  const lastSpace = cut.lastIndexOf(" ");
+  return (lastSpace > maxLength * 0.6 ? cut.slice(0, lastSpace) : cut).replace(/[\s.,;:!?-]+$/, "") + ellipsis;
+}
+function titleCase(text) {
+  return text.toLowerCase().replace(/\b\w/g, (c) => c.toUpperCase());
+}
+
+exports.bytes = bytes;
+exports.compact = compact;
+exports.duration = duration;
+exports.list = list;
+exports.number = number;
+exports.ordinal = ordinal;
+exports.parseBytes = parseBytes;
+exports.plural = plural;
+exports.pluralize = pluralize;
+exports.relativeTime = relativeTime;
+exports.titleCase = titleCase;
+exports.truncate = truncate;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * @lacspace/humanize\n *\n * Turn machine values into human-readable text — bytes, durations, relative\n * time, ordinals, plurals, compact numbers and grammatical lists.\n * Zero dependencies, isomorphic.\n */\n\n/* ------------------------------ bytes ------------------------------ */\n\nconst BYTE_UNITS = [\"B\", \"KB\", \"MB\", \"GB\", \"TB\", \"PB\", \"EB\"];\nconst BYTE_UNITS_IEC = [\"B\", \"KiB\", \"MiB\", \"GiB\", \"TiB\", \"PiB\", \"EiB\"];\n\nexport interface BytesOptions {\n  /** Use 1024-based IEC units (KiB, MiB…). Default false (1000-based). */\n  binary?: boolean;\n  /** Decimal places. Default 1 (0 for bytes). */\n  decimals?: number;\n}\n\n/** Human-readable file size. `bytes(1536)` → \"1.5 KB\". */\nexport function bytes(n: number, opts: BytesOptions = {}): string {\n  const base = opts.binary ? 1024 : 1000;\n  const units = opts.binary ? BYTE_UNITS_IEC : BYTE_UNITS;\n  const neg = n < 0 ? \"-\" : \"\";\n  let v = Math.abs(n);\n  if (v < base) return `${neg}${v} B`;\n  let i = 0;\n  while (v >= base && i < units.length - 1) { v /= base; i++; }\n  const dp = opts.decimals ?? 1;\n  return `${neg}${v.toFixed(dp)} ${units[i]}`;\n}\n\n/** Parse a size string back to bytes. `parseBytes(\"1.5 KB\")` → 1500. */\nexport function parseBytes(input: string): number {\n  const m = /^\\s*(-?[\\d.]+)\\s*([a-z]+)?\\s*$/i.exec(input);\n  if (!m) return NaN;\n  const value = parseFloat(m[1]!);\n  const unit = (m[2] ?? \"B\").toUpperCase();\n  const binary = unit.includes(\"I\");\n  const idx = (binary ? BYTE_UNITS_IEC : BYTE_UNITS).findIndex((u) => u.toUpperCase() === unit);\n  if (idx === -1) return unit === \"B\" ? value : NaN;\n  return value * (binary ? 1024 : 1000) ** idx;\n}\n\n/* ------------------------------ duration ------------------------------ */\n\nconst DUR = [\n  { u: \"y\", ms: 31536000000, long: \"year\" },\n  { u: \"mo\", ms: 2592000000, long: \"month\" },\n  { u: \"d\", ms: 86400000, long: \"day\" },\n  { u: \"h\", ms: 3600000, long: \"hour\" },\n  { u: \"m\", ms: 60000, long: \"minute\" },\n  { u: \"s\", ms: 1000, long: \"second\" },\n  { u: \"ms\", ms: 1, long: \"millisecond\" },\n];\n\nexport interface DurationOptions {\n  /** Max number of units to show. Default 2. */\n  units?: number;\n  /** Use full words (\"2 hours 3 minutes\"). Default false (\"2h 3m\"). */\n  long?: boolean;\n}\n\n/** Human-readable duration. `duration(90061000)` → \"1d 1h\". */\nexport function duration(ms: number, opts: DurationOptions = {}): string {\n  const max = opts.units ?? 2;\n  let rem = Math.abs(Math.round(ms));\n  if (rem === 0) return opts.long ? \"0 seconds\" : \"0s\";\n  const parts: string[] = [];\n  for (const d of DUR) {\n    if (rem < d.ms) continue;\n    const count = Math.floor(rem / d.ms);\n    rem -= count * d.ms;\n    parts.push(opts.long ? `${count} ${plural(d.long, count)}` : `${count}${d.u}`);\n    if (parts.length >= max) break;\n  }\n  return (ms < 0 ? \"-\" : \"\") + parts.join(opts.long ? \" \" : \" \");\n}\n\n/* ------------------------------ relative time ------------------------------ */\n\nconst RT: [number, string][] = [\n  [31536000, \"year\"], [2592000, \"month\"], [604800, \"week\"],\n  [86400, \"day\"], [3600, \"hour\"], [60, \"minute\"], [1, \"second\"],\n];\n\n/** Relative time. `relativeTime(Date.now() - 3600e3)` → \"1 hour ago\". */\nexport function relativeTime(date: Date | number | string, base: Date | number = Date.now()): string {\n  const t = date instanceof Date ? date.getTime() : typeof date === \"string\" ? new Date(date).getTime() : date;\n  const b = base instanceof Date ? base.getTime() : base;\n  const diff = Math.round((b - t) / 1000);\n  const abs = Math.abs(diff);\n  if (abs < 5) return \"just now\";\n  for (const [secs, unit] of RT) {\n    if (abs >= secs) {\n      const count = Math.floor(abs / secs);\n      const label = `${count} ${plural(unit, count)}`;\n      return diff >= 0 ? `${label} ago` : `in ${label}`;\n    }\n  }\n  return \"just now\";\n}\n\n/* ------------------------------ numbers ------------------------------ */\n\n/** Ordinal suffix. `ordinal(21)` → \"21st\". */\nexport function ordinal(n: number): string {\n  const abs = Math.abs(n) % 100;\n  const last = abs % 10;\n  const suffix = abs >= 11 && abs <= 13 ? \"th\" : last === 1 ? \"st\" : last === 2 ? \"nd\" : last === 3 ? \"rd\" : \"th\";\n  return `${n}${suffix}`;\n}\n\n/** Compact number. `compact(1234567)` → \"1.2M\". */\nexport function compact(n: number, decimals = 1): string {\n  const neg = n < 0 ? \"-\" : \"\";\n  const v = Math.abs(n);\n  const units: [number, string][] = [[1e12, \"T\"], [1e9, \"B\"], [1e6, \"M\"], [1e3, \"K\"]];\n  for (const [threshold, u] of units) {\n    if (v >= threshold) {\n      const num = v / threshold;\n      return `${neg}${(num % 1 === 0 ? num.toFixed(0) : num.toFixed(decimals))}${u}`;\n    }\n  }\n  return `${neg}${v}`;\n}\n\n/** Group digits with separators. `number(1234567.5)` → \"1,234,567.5\". */\nexport function number(n: number, opts: { separator?: string; decimal?: string } = {}): string {\n  const sep = opts.separator ?? \",\";\n  const dec = opts.decimal ?? \".\";\n  const [int, frac] = String(n).split(\".\");\n  const sign = int!.startsWith(\"-\") ? \"-\" : \"\";\n  const digits = int!.replace(\"-\", \"\").replace(/\\B(?=(\\d{3})+(?!\\d))/g, sep);\n  return sign + digits + (frac ? dec + frac : \"\");\n}\n\n/* ------------------------------ words ------------------------------ */\n\n/** Pluralize a word for a count (naive English + irregulars). */\nexport function plural(word: string, count: number, pluralForm?: string): string {\n  if (count === 1) return word;\n  if (pluralForm) return pluralForm;\n  if (/(s|x|z|ch|sh)$/i.test(word)) return `${word}es`;\n  if (/[^aeiou]y$/i.test(word)) return `${word.slice(0, -1)}ies`;\n  return `${word}s`;\n}\n\n/** \"5 items\" / \"1 item\". */\nexport function pluralize(count: number, word: string, pluralForm?: string): string {\n  return `${count} ${plural(word, count, pluralForm)}`;\n}\n\n/** Grammatical list. `list([\"a\",\"b\",\"c\"])` → \"a, b and c\". */\nexport function list(items: string[], opts: { conjunction?: string; oxford?: boolean } = {}): string {\n  const conj = opts.conjunction ?? \"and\";\n  if (items.length === 0) return \"\";\n  if (items.length === 1) return items[0]!;\n  if (items.length === 2) return `${items[0]} ${conj} ${items[1]}`;\n  const head = items.slice(0, -1).join(\", \");\n  return `${head}${opts.oxford ? \",\" : \"\"} ${conj} ${items[items.length - 1]}`;\n}\n\n/** Truncate to a max length with an ellipsis on a word boundary. */\nexport function truncate(text: string, maxLength: number, ellipsis = \"…\"): string {\n  if (text.length <= maxLength) return text;\n  const cut = text.slice(0, maxLength - ellipsis.length);\n  const lastSpace = cut.lastIndexOf(\" \");\n  return (lastSpace > maxLength * 0.6 ? cut.slice(0, lastSpace) : cut).replace(/[\\s.,;:!?-]+$/, \"\") + ellipsis;\n}\n\n/** Title Case a string. */\nexport function titleCase(text: string): string {\n  return text.toLowerCase().replace(/\\b\\w/g, (c) => c.toUpperCase());\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,51 @@
+/**
+ * @lacspace/humanize
+ *
+ * Turn machine values into human-readable text — bytes, durations, relative
+ * time, ordinals, plurals, compact numbers and grammatical lists.
+ * Zero dependencies, isomorphic.
+ */
+interface BytesOptions {
+    /** Use 1024-based IEC units (KiB, MiB…). Default false (1000-based). */
+    binary?: boolean;
+    /** Decimal places. Default 1 (0 for bytes). */
+    decimals?: number;
+}
+/** Human-readable file size. `bytes(1536)` → "1.5 KB". */
+declare function bytes(n: number, opts?: BytesOptions): string;
+/** Parse a size string back to bytes. `parseBytes("1.5 KB")` → 1500. */
+declare function parseBytes(input: string): number;
+interface DurationOptions {
+    /** Max number of units to show. Default 2. */
+    units?: number;
+    /** Use full words ("2 hours 3 minutes"). Default false ("2h 3m"). */
+    long?: boolean;
+}
+/** Human-readable duration. `duration(90061000)` → "1d 1h". */
+declare function duration(ms: number, opts?: DurationOptions): string;
+/** Relative time. `relativeTime(Date.now() - 3600e3)` → "1 hour ago". */
+declare function relativeTime(date: Date | number | string, base?: Date | number): string;
+/** Ordinal suffix. `ordinal(21)` → "21st". */
+declare function ordinal(n: number): string;
+/** Compact number. `compact(1234567)` → "1.2M". */
+declare function compact(n: number, decimals?: number): string;
+/** Group digits with separators. `number(1234567.5)` → "1,234,567.5". */
+declare function number(n: number, opts?: {
+    separator?: string;
+    decimal?: string;
+}): string;
+/** Pluralize a word for a count (naive English + irregulars). */
+declare function plural(word: string, count: number, pluralForm?: string): string;
+/** "5 items" / "1 item". */
+declare function pluralize(count: number, word: string, pluralForm?: string): string;
+/** Grammatical list. `list(["a","b","c"])` → "a, b and c". */
+declare function list(items: string[], opts?: {
+    conjunction?: string;
+    oxford?: boolean;
+}): string;
+/** Truncate to a max length with an ellipsis on a word boundary. */
+declare function truncate(text: string, maxLength: number, ellipsis?: string): string;
+/** Title Case a string. */
+declare function titleCase(text: string): string;
+
+export { type BytesOptions, type DurationOptions, bytes, compact, duration, list, number, ordinal, parseBytes, plural, pluralize, relativeTime, titleCase, truncate };

package/dist/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @lacspace/humanize
+ *
+ * Turn machine values into human-readable text — bytes, durations, relative
+ * time, ordinals, plurals, compact numbers and grammatical lists.
+ * Zero dependencies, isomorphic.
+ */
+interface BytesOptions {
+    /** Use 1024-based IEC units (KiB, MiB…). Default false (1000-based). */
+    binary?: boolean;
+    /** Decimal places. Default 1 (0 for bytes). */
+    decimals?: number;
+}
+/** Human-readable file size. `bytes(1536)` → "1.5 KB". */
+declare function bytes(n: number, opts?: BytesOptions): string;
+/** Parse a size string back to bytes. `parseBytes("1.5 KB")` → 1500. */
+declare function parseBytes(input: string): number;
+interface DurationOptions {
+    /** Max number of units to show. Default 2. */
+    units?: number;
+    /** Use full words ("2 hours 3 minutes"). Default false ("2h 3m"). */
+    long?: boolean;
+}
+/** Human-readable duration. `duration(90061000)` → "1d 1h". */
+declare function duration(ms: number, opts?: DurationOptions): string;
+/** Relative time. `relativeTime(Date.now() - 3600e3)` → "1 hour ago". */
+declare function relativeTime(date: Date | number | string, base?: Date | number): string;
+/** Ordinal suffix. `ordinal(21)` → "21st". */
+declare function ordinal(n: number): string;
+/** Compact number. `compact(1234567)` → "1.2M". */
+declare function compact(n: number, decimals?: number): string;
+/** Group digits with separators. `number(1234567.5)` → "1,234,567.5". */
+declare function number(n: number, opts?: {
+    separator?: string;
+    decimal?: string;
+}): string;
+/** Pluralize a word for a count (naive English + irregulars). */
+declare function plural(word: string, count: number, pluralForm?: string): string;
+/** "5 items" / "1 item". */
+declare function pluralize(count: number, word: string, pluralForm?: string): string;
+/** Grammatical list. `list(["a","b","c"])` → "a, b and c". */
+declare function list(items: string[], opts?: {
+    conjunction?: string;
+    oxford?: boolean;
+}): string;
+/** Truncate to a max length with an ellipsis on a word boundary. */
+declare function truncate(text: string, maxLength: number, ellipsis?: string): string;
+/** Title Case a string. */
+declare function titleCase(text: string): string;
+
+export { type BytesOptions, type DurationOptions, bytes, compact, duration, list, number, ordinal, parseBytes, plural, pluralize, relativeTime, titleCase, truncate };

package/dist/index.js

@@ -0,0 +1,131 @@
+// src/index.ts
+var BYTE_UNITS = ["B", "KB", "MB", "GB", "TB", "PB", "EB"];
+var BYTE_UNITS_IEC = ["B", "KiB", "MiB", "GiB", "TiB", "PiB", "EiB"];
+function bytes(n, opts = {}) {
+  const base = opts.binary ? 1024 : 1e3;
+  const units = opts.binary ? BYTE_UNITS_IEC : BYTE_UNITS;
+  const neg = n < 0 ? "-" : "";
+  let v = Math.abs(n);
+  if (v < base) return `${neg}${v} B`;
+  let i = 0;
+  while (v >= base && i < units.length - 1) {
+    v /= base;
+    i++;
+  }
+  const dp = opts.decimals ?? 1;
+  return `${neg}${v.toFixed(dp)} ${units[i]}`;
+}
+function parseBytes(input) {
+  const m = /^\s*(-?[\d.]+)\s*([a-z]+)?\s*$/i.exec(input);
+  if (!m) return NaN;
+  const value = parseFloat(m[1]);
+  const unit = (m[2] ?? "B").toUpperCase();
+  const binary = unit.includes("I");
+  const idx = (binary ? BYTE_UNITS_IEC : BYTE_UNITS).findIndex((u) => u.toUpperCase() === unit);
+  if (idx === -1) return unit === "B" ? value : NaN;
+  return value * (binary ? 1024 : 1e3) ** idx;
+}
+var DUR = [
+  { u: "y", ms: 31536e6, long: "year" },
+  { u: "mo", ms: 2592e6, long: "month" },
+  { u: "d", ms: 864e5, long: "day" },
+  { u: "h", ms: 36e5, long: "hour" },
+  { u: "m", ms: 6e4, long: "minute" },
+  { u: "s", ms: 1e3, long: "second" },
+  { u: "ms", ms: 1, long: "millisecond" }
+];
+function duration(ms, opts = {}) {
+  const max = opts.units ?? 2;
+  let rem = Math.abs(Math.round(ms));
+  if (rem === 0) return opts.long ? "0 seconds" : "0s";
+  const parts = [];
+  for (const d of DUR) {
+    if (rem < d.ms) continue;
+    const count = Math.floor(rem / d.ms);
+    rem -= count * d.ms;
+    parts.push(opts.long ? `${count} ${plural(d.long, count)}` : `${count}${d.u}`);
+    if (parts.length >= max) break;
+  }
+  return (ms < 0 ? "-" : "") + parts.join(opts.long ? " " : " ");
+}
+var RT = [
+  [31536e3, "year"],
+  [2592e3, "month"],
+  [604800, "week"],
+  [86400, "day"],
+  [3600, "hour"],
+  [60, "minute"],
+  [1, "second"]
+];
+function relativeTime(date, base = Date.now()) {
+  const t = date instanceof Date ? date.getTime() : typeof date === "string" ? new Date(date).getTime() : date;
+  const b = base instanceof Date ? base.getTime() : base;
+  const diff = Math.round((b - t) / 1e3);
+  const abs = Math.abs(diff);
+  if (abs < 5) return "just now";
+  for (const [secs, unit] of RT) {
+    if (abs >= secs) {
+      const count = Math.floor(abs / secs);
+      const label = `${count} ${plural(unit, count)}`;
+      return diff >= 0 ? `${label} ago` : `in ${label}`;
+    }
+  }
+  return "just now";
+}
+function ordinal(n) {
+  const abs = Math.abs(n) % 100;
+  const last = abs % 10;
+  const suffix = abs >= 11 && abs <= 13 ? "th" : last === 1 ? "st" : last === 2 ? "nd" : last === 3 ? "rd" : "th";
+  return `${n}${suffix}`;
+}
+function compact(n, decimals = 1) {
+  const neg = n < 0 ? "-" : "";
+  const v = Math.abs(n);
+  const units = [[1e12, "T"], [1e9, "B"], [1e6, "M"], [1e3, "K"]];
+  for (const [threshold, u] of units) {
+    if (v >= threshold) {
+      const num = v / threshold;
+      return `${neg}${num % 1 === 0 ? num.toFixed(0) : num.toFixed(decimals)}${u}`;
+    }
+  }
+  return `${neg}${v}`;
+}
+function number(n, opts = {}) {
+  const sep = opts.separator ?? ",";
+  const dec = opts.decimal ?? ".";
+  const [int, frac] = String(n).split(".");
+  const sign = int.startsWith("-") ? "-" : "";
+  const digits = int.replace("-", "").replace(/\B(?=(\d{3})+(?!\d))/g, sep);
+  return sign + digits + (frac ? dec + frac : "");
+}
+function plural(word, count, pluralForm) {
+  if (count === 1) return word;
+  if (pluralForm) return pluralForm;
+  if (/(s|x|z|ch|sh)$/i.test(word)) return `${word}es`;
+  if (/[^aeiou]y$/i.test(word)) return `${word.slice(0, -1)}ies`;
+  return `${word}s`;
+}
+function pluralize(count, word, pluralForm) {
+  return `${count} ${plural(word, count, pluralForm)}`;
+}
+function list(items, opts = {}) {
+  const conj = opts.conjunction ?? "and";
+  if (items.length === 0) return "";
+  if (items.length === 1) return items[0];
+  if (items.length === 2) return `${items[0]} ${conj} ${items[1]}`;
+  const head = items.slice(0, -1).join(", ");
+  return `${head}${opts.oxford ? "," : ""} ${conj} ${items[items.length - 1]}`;
+}
+function truncate(text, maxLength, ellipsis = "\u2026") {
+  if (text.length <= maxLength) return text;
+  const cut = text.slice(0, maxLength - ellipsis.length);
+  const lastSpace = cut.lastIndexOf(" ");
+  return (lastSpace > maxLength * 0.6 ? cut.slice(0, lastSpace) : cut).replace(/[\s.,;:!?-]+$/, "") + ellipsis;
+}
+function titleCase(text) {
+  return text.toLowerCase().replace(/\b\w/g, (c) => c.toUpperCase());
+}
+
+export { bytes, compact, duration, list, number, ordinal, parseBytes, plural, pluralize, relativeTime, titleCase, truncate };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @lacspace/humanize\n *\n * Turn machine values into human-readable text — bytes, durations, relative\n * time, ordinals, plurals, compact numbers and grammatical lists.\n * Zero dependencies, isomorphic.\n */\n\n/* ------------------------------ bytes ------------------------------ */\n\nconst BYTE_UNITS = [\"B\", \"KB\", \"MB\", \"GB\", \"TB\", \"PB\", \"EB\"];\nconst BYTE_UNITS_IEC = [\"B\", \"KiB\", \"MiB\", \"GiB\", \"TiB\", \"PiB\", \"EiB\"];\n\nexport interface BytesOptions {\n  /** Use 1024-based IEC units (KiB, MiB…). Default false (1000-based). */\n  binary?: boolean;\n  /** Decimal places. Default 1 (0 for bytes). */\n  decimals?: number;\n}\n\n/** Human-readable file size. `bytes(1536)` → \"1.5 KB\". */\nexport function bytes(n: number, opts: BytesOptions = {}): string {\n  const base = opts.binary ? 1024 : 1000;\n  const units = opts.binary ? BYTE_UNITS_IEC : BYTE_UNITS;\n  const neg = n < 0 ? \"-\" : \"\";\n  let v = Math.abs(n);\n  if (v < base) return `${neg}${v} B`;\n  let i = 0;\n  while (v >= base && i < units.length - 1) { v /= base; i++; }\n  const dp = opts.decimals ?? 1;\n  return `${neg}${v.toFixed(dp)} ${units[i]}`;\n}\n\n/** Parse a size string back to bytes. `parseBytes(\"1.5 KB\")` → 1500. */\nexport function parseBytes(input: string): number {\n  const m = /^\\s*(-?[\\d.]+)\\s*([a-z]+)?\\s*$/i.exec(input);\n  if (!m) return NaN;\n  const value = parseFloat(m[1]!);\n  const unit = (m[2] ?? \"B\").toUpperCase();\n  const binary = unit.includes(\"I\");\n  const idx = (binary ? BYTE_UNITS_IEC : BYTE_UNITS).findIndex((u) => u.toUpperCase() === unit);\n  if (idx === -1) return unit === \"B\" ? value : NaN;\n  return value * (binary ? 1024 : 1000) ** idx;\n}\n\n/* ------------------------------ duration ------------------------------ */\n\nconst DUR = [\n  { u: \"y\", ms: 31536000000, long: \"year\" },\n  { u: \"mo\", ms: 2592000000, long: \"month\" },\n  { u: \"d\", ms: 86400000, long: \"day\" },\n  { u: \"h\", ms: 3600000, long: \"hour\" },\n  { u: \"m\", ms: 60000, long: \"minute\" },\n  { u: \"s\", ms: 1000, long: \"second\" },\n  { u: \"ms\", ms: 1, long: \"millisecond\" },\n];\n\nexport interface DurationOptions {\n  /** Max number of units to show. Default 2. */\n  units?: number;\n  /** Use full words (\"2 hours 3 minutes\"). Default false (\"2h 3m\"). */\n  long?: boolean;\n}\n\n/** Human-readable duration. `duration(90061000)` → \"1d 1h\". */\nexport function duration(ms: number, opts: DurationOptions = {}): string {\n  const max = opts.units ?? 2;\n  let rem = Math.abs(Math.round(ms));\n  if (rem === 0) return opts.long ? \"0 seconds\" : \"0s\";\n  const parts: string[] = [];\n  for (const d of DUR) {\n    if (rem < d.ms) continue;\n    const count = Math.floor(rem / d.ms);\n    rem -= count * d.ms;\n    parts.push(opts.long ? `${count} ${plural(d.long, count)}` : `${count}${d.u}`);\n    if (parts.length >= max) break;\n  }\n  return (ms < 0 ? \"-\" : \"\") + parts.join(opts.long ? \" \" : \" \");\n}\n\n/* ------------------------------ relative time ------------------------------ */\n\nconst RT: [number, string][] = [\n  [31536000, \"year\"], [2592000, \"month\"], [604800, \"week\"],\n  [86400, \"day\"], [3600, \"hour\"], [60, \"minute\"], [1, \"second\"],\n];\n\n/** Relative time. `relativeTime(Date.now() - 3600e3)` → \"1 hour ago\". */\nexport function relativeTime(date: Date | number | string, base: Date | number = Date.now()): string {\n  const t = date instanceof Date ? date.getTime() : typeof date === \"string\" ? new Date(date).getTime() : date;\n  const b = base instanceof Date ? base.getTime() : base;\n  const diff = Math.round((b - t) / 1000);\n  const abs = Math.abs(diff);\n  if (abs < 5) return \"just now\";\n  for (const [secs, unit] of RT) {\n    if (abs >= secs) {\n      const count = Math.floor(abs / secs);\n      const label = `${count} ${plural(unit, count)}`;\n      return diff >= 0 ? `${label} ago` : `in ${label}`;\n    }\n  }\n  return \"just now\";\n}\n\n/* ------------------------------ numbers ------------------------------ */\n\n/** Ordinal suffix. `ordinal(21)` → \"21st\". */\nexport function ordinal(n: number): string {\n  const abs = Math.abs(n) % 100;\n  const last = abs % 10;\n  const suffix = abs >= 11 && abs <= 13 ? \"th\" : last === 1 ? \"st\" : last === 2 ? \"nd\" : last === 3 ? \"rd\" : \"th\";\n  return `${n}${suffix}`;\n}\n\n/** Compact number. `compact(1234567)` → \"1.2M\". */\nexport function compact(n: number, decimals = 1): string {\n  const neg = n < 0 ? \"-\" : \"\";\n  const v = Math.abs(n);\n  const units: [number, string][] = [[1e12, \"T\"], [1e9, \"B\"], [1e6, \"M\"], [1e3, \"K\"]];\n  for (const [threshold, u] of units) {\n    if (v >= threshold) {\n      const num = v / threshold;\n      return `${neg}${(num % 1 === 0 ? num.toFixed(0) : num.toFixed(decimals))}${u}`;\n    }\n  }\n  return `${neg}${v}`;\n}\n\n/** Group digits with separators. `number(1234567.5)` → \"1,234,567.5\". */\nexport function number(n: number, opts: { separator?: string; decimal?: string } = {}): string {\n  const sep = opts.separator ?? \",\";\n  const dec = opts.decimal ?? \".\";\n  const [int, frac] = String(n).split(\".\");\n  const sign = int!.startsWith(\"-\") ? \"-\" : \"\";\n  const digits = int!.replace(\"-\", \"\").replace(/\\B(?=(\\d{3})+(?!\\d))/g, sep);\n  return sign + digits + (frac ? dec + frac : \"\");\n}\n\n/* ------------------------------ words ------------------------------ */\n\n/** Pluralize a word for a count (naive English + irregulars). */\nexport function plural(word: string, count: number, pluralForm?: string): string {\n  if (count === 1) return word;\n  if (pluralForm) return pluralForm;\n  if (/(s|x|z|ch|sh)$/i.test(word)) return `${word}es`;\n  if (/[^aeiou]y$/i.test(word)) return `${word.slice(0, -1)}ies`;\n  return `${word}s`;\n}\n\n/** \"5 items\" / \"1 item\". */\nexport function pluralize(count: number, word: string, pluralForm?: string): string {\n  return `${count} ${plural(word, count, pluralForm)}`;\n}\n\n/** Grammatical list. `list([\"a\",\"b\",\"c\"])` → \"a, b and c\". */\nexport function list(items: string[], opts: { conjunction?: string; oxford?: boolean } = {}): string {\n  const conj = opts.conjunction ?? \"and\";\n  if (items.length === 0) return \"\";\n  if (items.length === 1) return items[0]!;\n  if (items.length === 2) return `${items[0]} ${conj} ${items[1]}`;\n  const head = items.slice(0, -1).join(\", \");\n  return `${head}${opts.oxford ? \",\" : \"\"} ${conj} ${items[items.length - 1]}`;\n}\n\n/** Truncate to a max length with an ellipsis on a word boundary. */\nexport function truncate(text: string, maxLength: number, ellipsis = \"…\"): string {\n  if (text.length <= maxLength) return text;\n  const cut = text.slice(0, maxLength - ellipsis.length);\n  const lastSpace = cut.lastIndexOf(\" \");\n  return (lastSpace > maxLength * 0.6 ? cut.slice(0, lastSpace) : cut).replace(/[\\s.,;:!?-]+$/, \"\") + ellipsis;\n}\n\n/** Title Case a string. */\nexport function titleCase(text: string): string {\n  return text.toLowerCase().replace(/\\b\\w/g, (c) => c.toUpperCase());\n}\n"]}

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@lacspace/humanize",
+  "version": "1.0.0",
+  "description": "Turn machine values into human-readable text — bytes, durations, relative time, ordinals, plurals, compact numbers and grammatical lists. Zero-dependency, isomorphic.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": { ".": { "import": { "types": "./dist/index.d.ts", "default": "./dist/index.js" }, "require": { "types": "./dist/index.d.cts", "default": "./dist/index.cjs" } } },
+  "files": ["dist"],
+  "sideEffects": false,
+  "scripts": { "build": "tsup", "prepublishOnly": "npm run build" },
+  "keywords": ["humanize", "pretty-bytes", "format-bytes", "duration", "relative-time", "time-ago", "ordinal", "pluralize", "compact-number", "format-number", "zero-dependency", "isomorphic", "typescript"],
+  "author": "Lacspace <contact@lacspace.com>",
+  "license": "SEE LICENSE IN LICENSE",
+  "homepage": "https://lacspace.com/packages",
+  "repository": { "type": "git", "url": "git+https://github.com/lacspace/npm-packages.git", "directory": "humanize" },
+  "bugs": { "url": "https://github.com/lacspace/npm-packages/issues" },
+  "engines": { "node": ">=18" },
+  "publishConfig": { "access": "public" }
+}