@visulima/string 1.0.0

package/dist/test/vitest.mjs

@@ -0,0 +1,7 @@
+import { expectAnsiStrings } from './utils.mjs';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const toEqualAnsi = /* @__PURE__ */ __name((actual, expected) => expectAnsiStrings(actual, expected), "toEqualAnsi");
+
+export { toEqualAnsi };

package/dist/truncate.cjs

@@ -0,0 +1,90 @@
+'use strict';
+
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
+
+const getStringTruncatedWidth = require('./get-string-truncated-width.cjs');
+const slice = require('./slice.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const DEFAULT_ELLIPSIS = "…";
+const MAX_SPACE_SEARCH_DISTANCE = 3;
+const findNearestSpace = /* @__PURE__ */ __name((string_, startIndex, searchRight = false) => {
+  if (string_.charAt(startIndex) === " ") {
+    return startIndex;
+  }
+  const direction = searchRight ? 1 : -1;
+  const limit = Math.min(MAX_SPACE_SEARCH_DISTANCE, searchRight ? string_.length - startIndex : startIndex);
+  for (let offset = 1; offset <= limit; offset++) {
+    const index = startIndex + offset * direction;
+    if (string_.charAt(index) === " ") {
+      return index;
+    }
+  }
+  return startIndex;
+}, "findNearestSpace");
+const truncate = /* @__PURE__ */ __name((input, limit, options = {}) => {
+  if (typeof input !== "string") {
+    throw new TypeError(`Expected \`input\` to be a string, got ${typeof input}`);
+  }
+  if (typeof limit !== "number") {
+    throw new TypeError(`Expected \`limit\` to be a number, got ${typeof limit}`);
+  }
+  if (input === "" || limit <= 0) {
+    return "";
+  }
+  const { ellipsis = DEFAULT_ELLIPSIS, position = "end", preferTruncationOnSpace = false } = options;
+  let ellipsisWidth = options.ellipsisWidth ?? ellipsis === DEFAULT_ELLIPSIS ? 2 : void 0;
+  if (ellipsisWidth === void 0) {
+    ellipsisWidth = getStringTruncatedWidth.getStringTruncatedWidth(ellipsis, {
+      ...options.width,
+      ellipsis: "",
+      ellipsisWidth: 0,
+      limit: Number.POSITIVE_INFINITY
+    }).width;
+  }
+  if (limit === 1 && ellipsisWidth === 1) {
+    return ellipsis;
+  }
+  if (limit === 1) {
+    return "";
+  }
+  const { width } = getStringTruncatedWidth.getStringTruncatedWidth(input, {
+    ...options.width,
+    ellipsis,
+    ellipsisWidth
+  });
+  if (width <= limit) {
+    return input;
+  }
+  switch (position) {
+    case "start": {
+      if (preferTruncationOnSpace) {
+        const nearestSpace = findNearestSpace(input, width - limit + 1, true);
+        return ellipsis + slice.slice(input, nearestSpace, width).trim();
+      }
+      return ellipsis + slice.slice(input, width - limit + ellipsisWidth, width);
+    }
+    case "middle": {
+      const half = Math.floor(limit / 2);
+      if (preferTruncationOnSpace) {
+        const firstBreak = findNearestSpace(input, half);
+        const secondBreak = findNearestSpace(input, width - (limit - half) + 1, true);
+        return slice.slice(input, 0, firstBreak) + ellipsis + slice.slice(input, secondBreak, width).trim();
+      }
+      return slice.slice(input, 0, half) + ellipsis + slice.slice(input, width - (limit - half) + ellipsisWidth, width);
+    }
+    case "end": {
+      if (preferTruncationOnSpace) {
+        const nearestSpace = findNearestSpace(input, limit - 1);
+        return slice.slice(input, 0, nearestSpace) + ellipsis;
+      }
+      return slice.slice(input, 0, limit - ellipsisWidth) + ellipsis;
+    }
+    default: {
+      throw new Error(`Invalid position: expected 'start', 'middle' or 'end', got '${position}'`);
+    }
+  }
+}, "truncate");
+
+exports.truncate = truncate;

package/dist/truncate.d.cts

@@ -0,0 +1,12 @@
+import { StringTruncatedWidthOptions } from './get-string-truncated-width.cjs';
+
+type TruncateOptions = {
+    ellipsis?: string;
+    ellipsisWidth?: number;
+    position?: "end" | "middle" | "start";
+    preferTruncationOnSpace?: boolean;
+    width?: Omit<StringTruncatedWidthOptions, "ellipsis" | "ellipsisWidth" | "limit">;
+};
+declare const truncate: (input: string, limit: number, options?: TruncateOptions) => string;
+
+export { type TruncateOptions, truncate };

package/dist/truncate.d.mts

@@ -0,0 +1,12 @@
+import { StringTruncatedWidthOptions } from './get-string-truncated-width.mjs';
+
+type TruncateOptions = {
+    ellipsis?: string;
+    ellipsisWidth?: number;
+    position?: "end" | "middle" | "start";
+    preferTruncationOnSpace?: boolean;
+    width?: Omit<StringTruncatedWidthOptions, "ellipsis" | "ellipsisWidth" | "limit">;
+};
+declare const truncate: (input: string, limit: number, options?: TruncateOptions) => string;
+
+export { type TruncateOptions, truncate };

package/dist/truncate.d.ts

@@ -0,0 +1,12 @@
+import { StringTruncatedWidthOptions } from './get-string-truncated-width.js';
+
+type TruncateOptions = {
+    ellipsis?: string;
+    ellipsisWidth?: number;
+    position?: "end" | "middle" | "start";
+    preferTruncationOnSpace?: boolean;
+    width?: Omit<StringTruncatedWidthOptions, "ellipsis" | "ellipsisWidth" | "limit">;
+};
+declare const truncate: (input: string, limit: number, options?: TruncateOptions) => string;
+
+export { type TruncateOptions, truncate };

package/dist/truncate.mjs

@@ -0,0 +1,86 @@
+import { getStringTruncatedWidth } from './get-string-truncated-width.mjs';
+import { slice } from './slice.mjs';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const DEFAULT_ELLIPSIS = "…";
+const MAX_SPACE_SEARCH_DISTANCE = 3;
+const findNearestSpace = /* @__PURE__ */ __name((string_, startIndex, searchRight = false) => {
+  if (string_.charAt(startIndex) === " ") {
+    return startIndex;
+  }
+  const direction = searchRight ? 1 : -1;
+  const limit = Math.min(MAX_SPACE_SEARCH_DISTANCE, searchRight ? string_.length - startIndex : startIndex);
+  for (let offset = 1; offset <= limit; offset++) {
+    const index = startIndex + offset * direction;
+    if (string_.charAt(index) === " ") {
+      return index;
+    }
+  }
+  return startIndex;
+}, "findNearestSpace");
+const truncate = /* @__PURE__ */ __name((input, limit, options = {}) => {
+  if (typeof input !== "string") {
+    throw new TypeError(`Expected \`input\` to be a string, got ${typeof input}`);
+  }
+  if (typeof limit !== "number") {
+    throw new TypeError(`Expected \`limit\` to be a number, got ${typeof limit}`);
+  }
+  if (input === "" || limit <= 0) {
+    return "";
+  }
+  const { ellipsis = DEFAULT_ELLIPSIS, position = "end", preferTruncationOnSpace = false } = options;
+  let ellipsisWidth = options.ellipsisWidth ?? ellipsis === DEFAULT_ELLIPSIS ? 2 : void 0;
+  if (ellipsisWidth === void 0) {
+    ellipsisWidth = getStringTruncatedWidth(ellipsis, {
+      ...options.width,
+      ellipsis: "",
+      ellipsisWidth: 0,
+      limit: Number.POSITIVE_INFINITY
+    }).width;
+  }
+  if (limit === 1 && ellipsisWidth === 1) {
+    return ellipsis;
+  }
+  if (limit === 1) {
+    return "";
+  }
+  const { width } = getStringTruncatedWidth(input, {
+    ...options.width,
+    ellipsis,
+    ellipsisWidth
+  });
+  if (width <= limit) {
+    return input;
+  }
+  switch (position) {
+    case "start": {
+      if (preferTruncationOnSpace) {
+        const nearestSpace = findNearestSpace(input, width - limit + 1, true);
+        return ellipsis + slice(input, nearestSpace, width).trim();
+      }
+      return ellipsis + slice(input, width - limit + ellipsisWidth, width);
+    }
+    case "middle": {
+      const half = Math.floor(limit / 2);
+      if (preferTruncationOnSpace) {
+        const firstBreak = findNearestSpace(input, half);
+        const secondBreak = findNearestSpace(input, width - (limit - half) + 1, true);
+        return slice(input, 0, firstBreak) + ellipsis + slice(input, secondBreak, width).trim();
+      }
+      return slice(input, 0, half) + ellipsis + slice(input, width - (limit - half) + ellipsisWidth, width);
+    }
+    case "end": {
+      if (preferTruncationOnSpace) {
+        const nearestSpace = findNearestSpace(input, limit - 1);
+        return slice(input, 0, nearestSpace) + ellipsis;
+      }
+      return slice(input, 0, limit - ellipsisWidth) + ellipsis;
+    }
+    default: {
+      throw new Error(`Invalid position: expected 'start', 'middle' or 'end', got '${position}'`);
+    }
+  }
+}, "truncate");
+
+export { truncate };

package/dist/utils.cjs

@@ -0,0 +1,9 @@
+'use strict';
+
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
+
+const LRUCache = require('./packem_shared/LRUCache-Crb-m7cw.cjs');
+
+
+
+exports.LRUCache = LRUCache;

package/dist/utils.d.cts

@@ -0,0 +1,14 @@
+declare class LRUCache<K, V> {
+    private readonly capacity;
+    private readonly cache;
+    private keyOrder;
+    constructor(capacity: number);
+    get(key: K): V | undefined;
+    has(key: K): boolean;
+    set(key: K, value: V): void;
+    delete(key: K): void;
+    clear(): void;
+    size(): number;
+}
+
+export { LRUCache };

package/dist/utils.d.mts

@@ -0,0 +1,14 @@
+declare class LRUCache<K, V> {
+    private readonly capacity;
+    private readonly cache;
+    private keyOrder;
+    constructor(capacity: number);
+    get(key: K): V | undefined;
+    has(key: K): boolean;
+    set(key: K, value: V): void;
+    delete(key: K): void;
+    clear(): void;
+    size(): number;
+}
+
+export { LRUCache };

package/dist/utils.d.ts

@@ -0,0 +1,14 @@
+declare class LRUCache<K, V> {
+    private readonly capacity;
+    private readonly cache;
+    private keyOrder;
+    constructor(capacity: number);
+    get(key: K): V | undefined;
+    has(key: K): boolean;
+    set(key: K, value: V): void;
+    delete(key: K): void;
+    clear(): void;
+    size(): number;
+}
+
+export { LRUCache };

package/dist/utils.mjs

@@ -0,0 +1 @@
+export { default as LRUCache } from './packem_shared/LRUCache-udNErhWw.mjs';