@poppinss/string/build/string_builder.js

A collection of helpers to perform operations on/related to a string value

import {
  index_default
} from "./chunk-LJJE2S3U.js";

// string_builder.ts
import { extname } from "path";
var StringBuilder = class {
  #value;
  constructor(value) {
    this.#value = typeof value === "string" ? value : value.toString();
  }
  /**
   * Applies dash case transformation
   */
  dashCase() {
    this.#value = index_default.dashCase(this.#value);
    return this;
  }
  /**
   * Applies dot case transformation
   */
  dotCase() {
    this.#value = index_default.dotCase(this.#value);
    return this;
  }
  /**
   * Applies snake case transformation
   */
  snakeCase() {
    this.#value = index_default.snakeCase(this.#value);
    return this;
  }
  /**
   * Applies pascal case transformation
   */
  pascalCase() {
    this.#value = index_default.pascalCase(this.#value);
    return this;
  }
  /**
   * Applies camelcase case transformation
   */
  camelCase() {
    this.#value = index_default.camelCase(this.#value);
    return this;
  }
  /**
   * Applies capital case transformation
   */
  capitalCase() {
    this.#value = index_default.capitalCase(this.#value);
    return this;
  }
  /**
   * Applies title case transformation
   */
  titleCase() {
    this.#value = index_default.titleCase(this.#value);
    return this;
  }
  /**
   * Applies sentence case transformation
   */
  sentenceCase() {
    this.#value = index_default.sentenceCase(this.#value);
    return this;
  }
  /**
   * Removes all sorts of casing from the string
   */
  noCase() {
    this.#value = index_default.noCase(this.#value);
    return this;
  }
  /**
   * Converts value to its plural form
   */
  plural() {
    this.#value = index_default.pluralize(this.#value);
    return this;
  }
  /**
   * Converts value to its singular form
   */
  singular() {
    this.#value = index_default.singular(this.#value);
    return this;
  }
  /**
   * Converts value to a URL friendly slug
   */
  slugify() {
    this.#value = index_default.slug(this.#value);
    return this;
  }
  /**
   * Removes a given suffix from the string
   */
  removeSuffix(suffix, options) {
    if (options?.similarWords && options.similarWords.some((word) => new RegExp(`[-_]?${word}$`, "i").test(this.#value))) {
      return this;
    }
    this.#value = this.#value.replace(new RegExp(`[-_]?${suffix}$`, "i"), "");
    return this;
  }
  /**
   * Adds suffix to the string
   */
  suffix(suffix, options) {
    this.removeSuffix(suffix, options);
    this.#value = `${this.#value}${suffix}`;
    return this;
  }
  /**
   * Removes a given prefix from the string
   */
  removePrefix(prefix, options) {
    if (options?.similarWords && options.similarWords.some((word) => new RegExp(`^${word}[-_]?`, "i").test(this.#value))) {
      return this;
    }
    this.#value = this.#value.replace(new RegExp(`^${prefix}[-_]?`, "i"), "");
    return this;
  }
  /**
   * Adds prefix to the string
   */
  prefix(prefix) {
    this.removePrefix(prefix);
    this.#value = `${prefix}${this.#value}`;
    return this;
  }
  /**
   * Removes extension from the value
   */
  removeExtension() {
    this.#value = this.#value.replace(new RegExp(`${extname(this.#value)}$`), "");
    return this;
  }
  /**
   * Adds extension to the value
   */
  ext(extension) {
    this.removeExtension();
    this.#value = `${this.#value}.${extension.replace(/^\./, "")}`;
    return this;
  }
  /**
   * Convert slashes to unix slash
   */
  toUnixSlash() {
    this.#value = index_default.toUnixSlash(this.#value);
    return this;
  }
  toString() {
    return this.#value;
  }
};
export {
  StringBuilder as default
};