@hardlydifficult/text 1.0.0 → 1.0.2

package/README.md

@@ -75,3 +75,27 @@ for (const chunk of chunks) {
   await channel.send(chunk);
 }
 ```
+
+### `slugify(input: string, maxLength?: number): string`
+
+Convert a string to a URL/filename-safe slug. Lowercases, replaces non-alphanumeric runs with hyphens, truncates at word boundaries.
+
+```typescript
+import { slugify } from "@hardlydifficult/text";
+
+slugify("My Feature Name!"); // "my-feature-name"
+slugify("My Feature Name!", 10); // "my-feature"
+```
+
+### `formatDuration(ms: number): string`
+
+Format milliseconds as a short human-readable duration. Shows at most two units, skipping trailing zeros.
+
+```typescript
+import { formatDuration } from "@hardlydifficult/text";
+
+formatDuration(125_000);   // "2m 5s"
+formatDuration(3_600_000); // "1h"
+formatDuration(500);       // "<1s"
+formatDuration(90_000_000); // "1d 1h"
+```

package/dist/formatDuration.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Format a duration in milliseconds as a short human-readable string.
+ *
+ * Shows at most two units (biggest first), skipping trailing zeros.
+ *
+ * @example
+ * ```typescript
+ * formatDuration(125_000)   // "2m 5s"
+ * formatDuration(3_600_000) // "1h"
+ * formatDuration(500)       // "<1s"
+ * ```
+ */
+export declare function formatDuration(ms: number): string;
+//# sourceMappingURL=formatDuration.d.ts.map

package/dist/formatDuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatDuration.d.ts","sourceRoot":"","sources":["../src/formatDuration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CA6BjD"}

package/dist/formatDuration.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDuration = formatDuration;
+/**
+ * Format a duration in milliseconds as a short human-readable string.
+ *
+ * Shows at most two units (biggest first), skipping trailing zeros.
+ *
+ * @example
+ * ```typescript
+ * formatDuration(125_000)   // "2m 5s"
+ * formatDuration(3_600_000) // "1h"
+ * formatDuration(500)       // "<1s"
+ * ```
+ */
+function formatDuration(ms) {
+    if (ms < 1000) {
+        return "<1s";
+    }
+    const totalSeconds = Math.floor(ms / 1000);
+    const seconds = totalSeconds % 60;
+    const totalMinutes = Math.floor(totalSeconds / 60);
+    const minutes = totalMinutes % 60;
+    const totalHours = Math.floor(totalMinutes / 60);
+    const hours = totalHours % 24;
+    const days = Math.floor(totalHours / 24);
+    if (days > 0) {
+        return hours > 0
+            ? `${String(days)}d ${String(hours)}h`
+            : `${String(days)}d`;
+    }
+    if (totalHours > 0) {
+        return minutes > 0
+            ? `${String(hours)}h ${String(minutes)}m`
+            : `${String(hours)}h`;
+    }
+    if (totalMinutes > 0) {
+        return seconds > 0
+            ? `${String(minutes)}m ${String(seconds)}s`
+            : `${String(minutes)}m`;
+    }
+    return `${String(seconds)}s`;
+}
+//# sourceMappingURL=formatDuration.js.map

package/dist/formatDuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatDuration.js","sourceRoot":"","sources":["../src/formatDuration.ts"],"names":[],"mappings":";;AAYA,wCA6BC;AAzCD;;;;;;;;;;;GAWG;AACH,SAAgB,cAAc,CAAC,EAAU;IACvC,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;QACd,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,YAAY,GAAG,EAAE,CAAC;IAClC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,YAAY,GAAG,EAAE,CAAC;IAClC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,UAAU,GAAG,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;IAEzC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACb,OAAO,KAAK,GAAG,CAAC;YACd,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,GAAG;YACtC,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;IACzB,CAAC;IACD,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACnB,OAAO,OAAO,GAAG,CAAC;YAChB,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,OAAO,CAAC,GAAG;YACzC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;IAC1B,CAAC;IACD,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,OAAO,GAAG,CAAC;YAChB,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,MAAM,CAAC,OAAO,CAAC,GAAG;YAC3C,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;IAC5B,CAAC;IACD,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;AAC/B,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export { getErrorMessage, formatError, formatErrorForLog } from "./errors.js";
 export { replaceTemplate, extractPlaceholders } from "./template.js";
 export { chunkText } from "./chunkText.js";
+export { slugify } from "./slugify.js";
+export { formatDuration } from "./formatDuration.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.chunkText = exports.extractPlaceholders = exports.replaceTemplate = exports.formatErrorForLog = exports.formatError = exports.getErrorMessage = void 0;
+exports.formatDuration = exports.slugify = exports.chunkText = exports.extractPlaceholders = exports.replaceTemplate = exports.formatErrorForLog = exports.formatError = exports.getErrorMessage = void 0;
 var errors_js_1 = require("./errors.js");
 Object.defineProperty(exports, "getErrorMessage", { enumerable: true, get: function () { return errors_js_1.getErrorMessage; } });
 Object.defineProperty(exports, "formatError", { enumerable: true, get: function () { return errors_js_1.formatError; } });
@@ -10,4 +10,8 @@ Object.defineProperty(exports, "replaceTemplate", { enumerable: true, get: funct
 Object.defineProperty(exports, "extractPlaceholders", { enumerable: true, get: function () { return template_js_1.extractPlaceholders; } });
 var chunkText_js_1 = require("./chunkText.js");
 Object.defineProperty(exports, "chunkText", { enumerable: true, get: function () { return chunkText_js_1.chunkText; } });
+var slugify_js_1 = require("./slugify.js");
+Object.defineProperty(exports, "slugify", { enumerable: true, get: function () { return slugify_js_1.slugify; } });
+var formatDuration_js_1 = require("./formatDuration.js");
+Object.defineProperty(exports, "formatDuration", { enumerable: true, get: function () { return formatDuration_js_1.formatDuration; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,yCAA8E;AAArE,4GAAA,eAAe,OAAA;AAAE,wGAAA,WAAW,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AACxD,6CAAqE;AAA5D,8GAAA,eAAe,OAAA;AAAE,kHAAA,mBAAmB,OAAA;AAC7C,+CAA2C;AAAlC,yGAAA,SAAS,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,yCAA8E;AAArE,4GAAA,eAAe,OAAA;AAAE,wGAAA,WAAW,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AACxD,6CAAqE;AAA5D,8GAAA,eAAe,OAAA;AAAE,kHAAA,mBAAmB,OAAA;AAC7C,+CAA2C;AAAlC,yGAAA,SAAS,OAAA;AAClB,2CAAuC;AAA9B,qGAAA,OAAO,OAAA;AAChB,yDAAqD;AAA5C,mHAAA,cAAc,OAAA"}

package/dist/slugify.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Convert a string to a URL/filename-safe slug.
+ *
+ * Lowercases, replaces non-alphanumeric runs with single hyphens,
+ * and trims leading/trailing hyphens. When `maxLength` is provided,
+ * truncates at a hyphen boundary to avoid cutting mid-word.
+ *
+ * @example
+ * ```typescript
+ * slugify("My Feature Name!") // "my-feature-name"
+ * slugify("My Feature Name!", 10) // "my-feature"
+ * ```
+ */
+export declare function slugify(input: string, maxLength?: number): string;
+//# sourceMappingURL=slugify.d.ts.map

package/dist/slugify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.d.ts","sourceRoot":"","sources":["../src/slugify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAqBjE"}

package/dist/slugify.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.slugify = slugify;
+/**
+ * Convert a string to a URL/filename-safe slug.
+ *
+ * Lowercases, replaces non-alphanumeric runs with single hyphens,
+ * and trims leading/trailing hyphens. When `maxLength` is provided,
+ * truncates at a hyphen boundary to avoid cutting mid-word.
+ *
+ * @example
+ * ```typescript
+ * slugify("My Feature Name!") // "my-feature-name"
+ * slugify("My Feature Name!", 10) // "my-feature"
+ * ```
+ */
+function slugify(input, maxLength) {
+    let slug = input
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    if (maxLength !== undefined && slug.length > maxLength) {
+        const cutAtBoundary = slug[maxLength] === "-";
+        slug = slug.slice(0, maxLength);
+        if (!cutAtBoundary) {
+            const lastHyphen = slug.lastIndexOf("-");
+            if (lastHyphen > 0) {
+                slug = slug.slice(0, lastHyphen);
+            }
+        }
+        slug = slug.replace(/-+$/, "");
+    }
+    return slug;
+}
+//# sourceMappingURL=slugify.js.map

package/dist/slugify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.js","sourceRoot":"","sources":["../src/slugify.ts"],"names":[],"mappings":";;AAaA,0BAqBC;AAlCD;;;;;;;;;;;;GAYG;AACH,SAAgB,OAAO,CAAC,KAAa,EAAE,SAAkB;IACvD,IAAI,IAAI,GAAG,KAAK;SACb,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAE3B,IAAI,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;QACvD,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC;QAC9C,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QAEhC,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YACzC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;gBACnB,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAED,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardlydifficult/text",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [