String Utilities

/**
 * Converts camelCase to underscore_case
 * @param str - String to decamelize
 * @returns Decamelized string
 */
function decamelize(str: string): string;

/**
 * Replaces underscores, spaces, or camelCase with dashes
 * @param str - String to dasherize
 * @returns Dasherized string
 */
function dasherize(str: string): string;

/**
 * Returns the UpperCamelCase form of a string
 * @param str - String to classify
 * @returns Classified string
 */
function classify(str: string): string;

/**
 * Returns the lower_case_and_underscored form of a string
 * @param str - String to underscore
 * @returns Underscored string
 */
function underscore(str: string): string;

import { dasherize, classify, underscore, decamelize } from "ember-resolver/string";

// Decamelize: camelCase to underscore_case
console.log(decamelize('innerHTML')); // 'inner_html'
console.log(decamelize('actionName')); // 'action_name'
console.log(decamelize('css-class-name')); // 'css-class-name' (unchanged)

// Dasherize: various formats to dash-case
console.log(dasherize('innerHTML')); // 'inner-html'
console.log(dasherize('action_name')); // 'action-name'
console.log(dasherize('css-class-name')); // 'css-class-name' (unchanged)
console.log(dasherize('my favorite items')); // 'my-favorite-items'
console.log(dasherize('privateDocs/ownerInvoice')); // 'private-docs/owner-invoice'

// Classify: various formats to UpperCamelCase
console.log(classify('innerHTML')); // 'InnerHTML'
console.log(classify('action_name')); // 'ActionName'
console.log(classify('css-class-name')); // 'CssClassName'
console.log(classify('my favorite items')); // 'MyFavoriteItems'
console.log(classify('private-docs/owner-invoice')); // 'PrivateDocs/OwnerInvoice'

// Underscore: various formats to lower_case_with_underscores
console.log(underscore('innerHTML')); // 'inner_html'
console.log(underscore('action_name')); // 'action_name' (unchanged)
console.log(underscore('css-class-name')); // 'css_class_name'
console.log(underscore('my favorite items')); // 'my_favorite_items'
console.log(underscore('privateDocs/ownerInvoice')); // 'private_docs/owner_invoice'

/**
 * Sets string configuration object
 * @param strings - Configuration object for string utilities
 */
function setStrings(strings: object): void;

/**
 * Gets current string configuration
 * @returns Current string configuration object
 */
function getStrings(): object;

/**
 * Gets specific string from configuration
 * @param name - Name of string to retrieve
 * @returns String value from configuration
 */
function getString(name: string): any;

import { setStrings, getStrings, getString } from "ember-resolver/string";

// Set custom string configuration
setStrings({
  customPrefix: "my-app",
  defaultSuffix: "-component",
  specialNames: {
    user: "person",
    admin: "administrator"
  }
});

// Get all string configuration
const config = getStrings();
console.log(config.customPrefix); // "my-app"

// Get specific string
const prefix = getString("customPrefix"); // "my-app"