@httptoolkit/util 0.1.6 → 0.1.7

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 export * from './promises';
 export * from './errors';
+export * from './text';

package/dist/index.js

@@ -16,4 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./promises"), exports);
 __exportStar(require("./errors"), exports);
+__exportStar(require("./text"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,2CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,2CAAyB;AACzB,yCAAuB"}

package/dist/text.d.ts

@@ -0,0 +1,7 @@
+export declare function truncateWithEllipsis(str: string, length: number): string;
+export declare function joinAnd(val: string[], options?: {
+    separator?: string;
+    finalSeparator?: string;
+    oxfordComma?: boolean;
+}): string;
+export declare function aOrAn(value: string): "a" | "an";

package/dist/text.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.aOrAn = exports.joinAnd = exports.truncateWithEllipsis = void 0;
+function truncateWithEllipsis(str, length) {
+    if (str.length <= length) {
+        return str;
+    }
+    else {
+        return str.slice(0, length - 3) + "...";
+    }
+}
+exports.truncateWithEllipsis = truncateWithEllipsis;
+function joinAnd(val, options = {}) {
+    if (val.length === 1)
+        return val[0];
+    const separator = options.separator ?? ', ';
+    const finalSeparator = options.finalSeparator ?? 'and ';
+    const oxfordComma = options.oxfordComma ?? false;
+    return val.slice(0, -1).join(separator) +
+        (oxfordComma ? separator : ' ') +
+        finalSeparator +
+        val[val.length - 1];
+}
+exports.joinAnd = joinAnd;
+const VOWEL_ISH = ['a', 'e', 'i', 'o', 'u', 'y'];
+function aOrAn(value) {
+    if (VOWEL_ISH.includes(value[0].toLowerCase()))
+        return 'an';
+    else
+        return 'a';
+}
+exports.aOrAn = aOrAn;
+//# sourceMappingURL=text.js.map

package/dist/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../src/text.ts"],"names":[],"mappings":";;;AAAA,SAAgB,oBAAoB,CAAC,GAAW,EAAE,MAAc;IAC5D,IAAI,GAAG,CAAC,MAAM,IAAI,MAAM,EAAE;QACtB,OAAO,GAAG,CAAC;KACd;SAAM;QACH,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;KAC3C;AACL,CAAC;AAND,oDAMC;AAED,SAAgB,OAAO,CAAC,GAAa,EAAE,UAOnC,EAAE;IACF,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;IAEpC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC;IAC5C,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,MAAM,CAAC;IACxD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,KAAK,CAAC;IAEjD,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;QACnC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;QAC/B,cAAc;QACd,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC5B,CAAC;AAlBD,0BAkBC;AAED,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AACjD,SAAgB,KAAK,CAAC,KAAa;IAC/B,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;;QACvD,OAAO,GAAG,CAAC;AACpB,CAAC;AAHD,sBAGC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@httptoolkit/util",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "A tiny utility package, sharing JS code widely used across HTTP Toolkit projects",
   "main": "dist/index.js",
   "files": [

package/src/index.ts

@@ -1,2 +1,3 @@
 export * from './promises';
-export * from './errors';
+export * from './errors';
+export * from './text';

package/src/text.ts

@@ -0,0 +1,33 @@
+export function truncateWithEllipsis(str: string, length: number) {
+    if (str.length <= length) {
+        return str;
+    } else {
+        return str.slice(0, length - 3) + "...";
+    }
+}
+
+export function joinAnd(val: string[], options: {
+    // Separator between all but the last value
+    separator?: string,
+    // Separator before last value (preceeded with space or `separator` if oxfordComma is true)
+    finalSeparator?: string,
+    // Should there be a separator between the penultimate value & finalSeparator?
+    oxfordComma?: boolean
+} = {}) {
+    if (val.length === 1) return val[0];
+
+    const separator = options.separator ?? ', ';
+    const finalSeparator = options.finalSeparator ?? 'and ';
+    const oxfordComma = options.oxfordComma ?? false;
+
+    return val.slice(0, -1).join(separator) +
+        (oxfordComma ? separator : ' ') +
+        finalSeparator +
+        val[val.length - 1];
+}
+
+const VOWEL_ISH = ['a', 'e', 'i', 'o', 'u', 'y'];
+export function aOrAn(value: string) {
+    if (VOWEL_ISH.includes(value[0].toLowerCase())) return 'an';
+    else return 'a';
+}