@stryke/string-format 0.13.6 → 0.14.1

package/CHANGELOG.md

@@ -2,6 +2,31 @@
 
 # Changelog for Stryke - String Format
 
+## [0.14.0](https://github.com/storm-software/stryke/releases/tag/string-format%400.14.0) (02/09/2026)
+
+### Features
+
+- **string-format:** Added the `toOrdinal` helper utility ([eb7aea68](https://github.com/storm-software/stryke/commit/eb7aea68))
+
+### Updated Dependencies
+
+- Updated **helpers** to **v0.9.41**
+- Updated **types** to **v0.10.38**
+
+## [0.13.7](https://github.com/storm-software/stryke/releases/tag/string-format%400.13.7) (01/29/2026)
+
+### Updated Dependencies
+
+- Updated **helpers** to **v0.9.40**
+- Updated **types** to **v0.10.37**
+
+## [0.13.6](https://github.com/storm-software/stryke/releases/tag/string-format%400.13.6) (01/26/2026)
+
+### Updated Dependencies
+
+- Updated **helpers** to **v0.9.39**
+- Updated **types** to **v0.10.36**
+
 ## [0.13.5](https://github.com/storm-software/stryke/releases/tag/string-format%400.13.5) (01/25/2026)
 
 ### Updated Dependencies

package/dist/index.cjs

@@ -16,6 +16,7 @@ const require_format_special_cases = require('./format-special-cases.cjs');
 const require_kebab_case = require('./kebab-case.cjs');
 const require_lower_case_first = require('./lower-case-first.cjs');
 const require_normalize_email = require('./normalize-email.cjs');
+const require_ordinals = require('./ordinals.cjs');
 const require_package = require('./package.cjs');
 const require_pad = require('./pad.cjs');
 const require_pascal_case = require('./pascal-case.cjs');
@@ -71,5 +72,6 @@ exports.startCase = require_start_case.startCase;
 exports.stripIndents = require_strip_indents.stripIndents;
 exports.titleCase = require_title_case.titleCase;
 exports.toLocaleString = require_pretty_bytes.toLocaleString;
+exports.toOrdinal = require_ordinals.toOrdinal;
 exports.unescape = require_unescape.unescape;
 exports.upperCaseFirst = require_upper_case_first.upperCaseFirst;

package/dist/index.d.cts

@@ -12,6 +12,7 @@ import { CASE_SPLIT_PATTERN, GetWordsOptions, RELAXED_SPLIT_PATTERN, getWords }
 import { isKebabCase, kebabCase } from "./kebab-case.cjs";
 import { lowerCaseFirst } from "./lower-case-first.cjs";
 import { normalizeEmail } from "./normalize-email.cjs";
+import { toOrdinal } from "./ordinals.cjs";
 import { getPackageName, getPackageVersion, hasPackageVersion, removePackageVersion } from "./package.cjs";
 import { pad } from "./pad.cjs";
 import { isPascalCase, pascalCase } from "./pascal-case.cjs";
@@ -26,4 +27,4 @@ import { titleCase } from "./title-case.cjs";
 import { unescape } from "./unescape.cjs";
 import { upperCaseFirst } from "./upper-case-first.cjs";
 import { getIndefiniteArticle, isVowel } from "./vowels.cjs";
-export { ACRONYMS, ACRONYM_DESCRIPTION, ACRONYM_DISPLAY, ACRONYM_LIST, ARTICLES, CASE_SPLIT_PATTERN, CONJUNCTIONS, FormatSpecialCasesOptions, GetWordsOptions, Options, PREPOSITIONS, RELAXED_SPLIT_PATTERN, SPECIAL_CASES, SnakeCaseOptions, camelCase, combine, constantCase, deburr, decamelize, escapeHtml, escapeRegExp, formatSpecialCases, getIndefiniteArticle, getPackageName, getPackageVersion, getWords, hasPackageVersion, isCamelCase, isConstantCase, isKebabCase, isPascalCase, isPeriodSplit, isSnakeCase, isStartCase, isVowel, kebabCase, lowerCaseFirst, normalizeEmail, pad, pascalCase, periodSplit, prettyBytes, removePackageVersion, snakeCase, startCase, stripIndents, titleCase, toLocaleString, unescape, upperCaseFirst };
+export { ACRONYMS, ACRONYM_DESCRIPTION, ACRONYM_DISPLAY, ACRONYM_LIST, ARTICLES, CASE_SPLIT_PATTERN, CONJUNCTIONS, FormatSpecialCasesOptions, GetWordsOptions, Options, PREPOSITIONS, RELAXED_SPLIT_PATTERN, SPECIAL_CASES, SnakeCaseOptions, camelCase, combine, constantCase, deburr, decamelize, escapeHtml, escapeRegExp, formatSpecialCases, getIndefiniteArticle, getPackageName, getPackageVersion, getWords, hasPackageVersion, isCamelCase, isConstantCase, isKebabCase, isPascalCase, isPeriodSplit, isSnakeCase, isStartCase, isVowel, kebabCase, lowerCaseFirst, normalizeEmail, pad, pascalCase, periodSplit, prettyBytes, removePackageVersion, snakeCase, startCase, stripIndents, titleCase, toLocaleString, toOrdinal, unescape, upperCaseFirst };

package/dist/index.d.mts

@@ -12,6 +12,7 @@ import { CASE_SPLIT_PATTERN, GetWordsOptions, RELAXED_SPLIT_PATTERN, getWords }
 import { isKebabCase, kebabCase } from "./kebab-case.mjs";
 import { lowerCaseFirst } from "./lower-case-first.mjs";
 import { normalizeEmail } from "./normalize-email.mjs";
+import { toOrdinal } from "./ordinals.mjs";
 import { getPackageName, getPackageVersion, hasPackageVersion, removePackageVersion } from "./package.mjs";
 import { pad } from "./pad.mjs";
 import { isPascalCase, pascalCase } from "./pascal-case.mjs";
@@ -26,4 +27,4 @@ import { titleCase } from "./title-case.mjs";
 import { unescape } from "./unescape.mjs";
 import { upperCaseFirst } from "./upper-case-first.mjs";
 import { getIndefiniteArticle, isVowel } from "./vowels.mjs";
-export { ACRONYMS, ACRONYM_DESCRIPTION, ACRONYM_DISPLAY, ACRONYM_LIST, ARTICLES, CASE_SPLIT_PATTERN, CONJUNCTIONS, FormatSpecialCasesOptions, GetWordsOptions, Options, PREPOSITIONS, RELAXED_SPLIT_PATTERN, SPECIAL_CASES, SnakeCaseOptions, camelCase, combine, constantCase, deburr, decamelize, escapeHtml, escapeRegExp, formatSpecialCases, getIndefiniteArticle, getPackageName, getPackageVersion, getWords, hasPackageVersion, isCamelCase, isConstantCase, isKebabCase, isPascalCase, isPeriodSplit, isSnakeCase, isStartCase, isVowel, kebabCase, lowerCaseFirst, normalizeEmail, pad, pascalCase, periodSplit, prettyBytes, removePackageVersion, snakeCase, startCase, stripIndents, titleCase, toLocaleString, unescape, upperCaseFirst };
+export { ACRONYMS, ACRONYM_DESCRIPTION, ACRONYM_DISPLAY, ACRONYM_LIST, ARTICLES, CASE_SPLIT_PATTERN, CONJUNCTIONS, FormatSpecialCasesOptions, GetWordsOptions, Options, PREPOSITIONS, RELAXED_SPLIT_PATTERN, SPECIAL_CASES, SnakeCaseOptions, camelCase, combine, constantCase, deburr, decamelize, escapeHtml, escapeRegExp, formatSpecialCases, getIndefiniteArticle, getPackageName, getPackageVersion, getWords, hasPackageVersion, isCamelCase, isConstantCase, isKebabCase, isPascalCase, isPeriodSplit, isSnakeCase, isStartCase, isVowel, kebabCase, lowerCaseFirst, normalizeEmail, pad, pascalCase, periodSplit, prettyBytes, removePackageVersion, snakeCase, startCase, stripIndents, titleCase, toLocaleString, toOrdinal, unescape, upperCaseFirst };

package/dist/index.mjs

@@ -16,6 +16,7 @@ import { formatSpecialCases } from "./format-special-cases.mjs";
 import { isKebabCase, kebabCase } from "./kebab-case.mjs";
 import { lowerCaseFirst } from "./lower-case-first.mjs";
 import { normalizeEmail } from "./normalize-email.mjs";
+import { toOrdinal } from "./ordinals.mjs";
 import { getPackageName, getPackageVersion, hasPackageVersion, removePackageVersion } from "./package.mjs";
 import { pad } from "./pad.mjs";
 import { isPascalCase, pascalCase } from "./pascal-case.mjs";
@@ -27,4 +28,4 @@ import { titleCase } from "./title-case.mjs";
 import { unescape } from "./unescape.mjs";
 import { getIndefiniteArticle, isVowel } from "./vowels.mjs";
 
-export { ACRONYMS, ACRONYM_DESCRIPTION, ACRONYM_DISPLAY, ACRONYM_LIST, ARTICLES, CASE_SPLIT_PATTERN, CONJUNCTIONS, PREPOSITIONS, RELAXED_SPLIT_PATTERN, SPECIAL_CASES, camelCase, combine, constantCase, deburr, decamelize, escapeHtml, escapeRegExp, formatSpecialCases, getIndefiniteArticle, getPackageName, getPackageVersion, getWords, hasPackageVersion, isCamelCase, isConstantCase, isKebabCase, isPascalCase, isPeriodSplit, isSnakeCase, isStartCase, isVowel, kebabCase, lowerCaseFirst, normalizeEmail, pad, pascalCase, periodSplit, prettyBytes, removePackageVersion, snakeCase, startCase, stripIndents, titleCase, toLocaleString, unescape, upperCaseFirst };
+export { ACRONYMS, ACRONYM_DESCRIPTION, ACRONYM_DISPLAY, ACRONYM_LIST, ARTICLES, CASE_SPLIT_PATTERN, CONJUNCTIONS, PREPOSITIONS, RELAXED_SPLIT_PATTERN, SPECIAL_CASES, camelCase, combine, constantCase, deburr, decamelize, escapeHtml, escapeRegExp, formatSpecialCases, getIndefiniteArticle, getPackageName, getPackageVersion, getWords, hasPackageVersion, isCamelCase, isConstantCase, isKebabCase, isPascalCase, isPeriodSplit, isSnakeCase, isStartCase, isVowel, kebabCase, lowerCaseFirst, normalizeEmail, pad, pascalCase, periodSplit, prettyBytes, removePackageVersion, snakeCase, startCase, stripIndents, titleCase, toLocaleString, toOrdinal, unescape, upperCaseFirst };

package/dist/ordinals.cjs

@@ -0,0 +1,31 @@
+
+//#region src/ordinals.ts
+/**
+* Converts a number to its ordinal representation (e.g., 1st, 2nd, 3rd, etc.).
+*
+* @example
+* ```typescript
+* toOrdinal(1); // "1st"
+* toOrdinal(2); // "2nd"
+* toOrdinal(3); // "3rd"
+* toOrdinal(4); // "4th"
+* toOrdinal(11); // "11th"
+* toOrdinal(12); // "12th"
+* toOrdinal(13); // "13th"
+* toOrdinal(21); // "21st"
+* ```
+*
+* @param int - The number to convert to an ordinal string.
+* @returns The ordinal representation of the number as a string.
+*/
+function toOrdinal(int) {
+	const j = int % 10;
+	const k = int % 100;
+	if (j === 1 && k !== 11) return `${int}st`;
+	if (j === 2 && k !== 12) return `${int}nd`;
+	if (j === 3 && k !== 13) return `${int}rd`;
+	return `${int}th`;
+}
+
+//#endregion
+exports.toOrdinal = toOrdinal;

package/dist/ordinals.d.cts

@@ -0,0 +1,23 @@
+//#region src/ordinals.d.ts
+/**
+ * Converts a number to its ordinal representation (e.g., 1st, 2nd, 3rd, etc.).
+ *
+ * @example
+ * ```typescript
+ * toOrdinal(1); // "1st"
+ * toOrdinal(2); // "2nd"
+ * toOrdinal(3); // "3rd"
+ * toOrdinal(4); // "4th"
+ * toOrdinal(11); // "11th"
+ * toOrdinal(12); // "12th"
+ * toOrdinal(13); // "13th"
+ * toOrdinal(21); // "21st"
+ * ```
+ *
+ * @param int - The number to convert to an ordinal string.
+ * @returns The ordinal representation of the number as a string.
+ */
+declare function toOrdinal(int: number): string;
+//#endregion
+export { toOrdinal };
+//# sourceMappingURL=ordinals.d.cts.map

package/dist/ordinals.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ordinals.d.cts","names":[],"sources":["../src/ordinals.ts"],"sourcesContent":[],"mappings":";;AAoCA;;;;;;;;;;;;;;;;;iBAAgB,SAAA"}

package/dist/ordinals.d.mts

@@ -0,0 +1,23 @@
+//#region src/ordinals.d.ts
+/**
+ * Converts a number to its ordinal representation (e.g., 1st, 2nd, 3rd, etc.).
+ *
+ * @example
+ * ```typescript
+ * toOrdinal(1); // "1st"
+ * toOrdinal(2); // "2nd"
+ * toOrdinal(3); // "3rd"
+ * toOrdinal(4); // "4th"
+ * toOrdinal(11); // "11th"
+ * toOrdinal(12); // "12th"
+ * toOrdinal(13); // "13th"
+ * toOrdinal(21); // "21st"
+ * ```
+ *
+ * @param int - The number to convert to an ordinal string.
+ * @returns The ordinal representation of the number as a string.
+ */
+declare function toOrdinal(int: number): string;
+//#endregion
+export { toOrdinal };
+//# sourceMappingURL=ordinals.d.mts.map

package/dist/ordinals.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ordinals.d.mts","names":[],"sources":["../src/ordinals.ts"],"sourcesContent":[],"mappings":";;AAoCA;;;;;;;;;;;;;;;;;iBAAgB,SAAA"}

package/dist/ordinals.mjs

@@ -0,0 +1,31 @@
+//#region src/ordinals.ts
+/**
+* Converts a number to its ordinal representation (e.g., 1st, 2nd, 3rd, etc.).
+*
+* @example
+* ```typescript
+* toOrdinal(1); // "1st"
+* toOrdinal(2); // "2nd"
+* toOrdinal(3); // "3rd"
+* toOrdinal(4); // "4th"
+* toOrdinal(11); // "11th"
+* toOrdinal(12); // "12th"
+* toOrdinal(13); // "13th"
+* toOrdinal(21); // "21st"
+* ```
+*
+* @param int - The number to convert to an ordinal string.
+* @returns The ordinal representation of the number as a string.
+*/
+function toOrdinal(int) {
+	const j = int % 10;
+	const k = int % 100;
+	if (j === 1 && k !== 11) return `${int}st`;
+	if (j === 2 && k !== 12) return `${int}nd`;
+	if (j === 3 && k !== 13) return `${int}rd`;
+	return `${int}th`;
+}
+
+//#endregion
+export { toOrdinal };
+//# sourceMappingURL=ordinals.mjs.map

package/dist/ordinals.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ordinals.mjs","names":[],"sources":["../src/ordinals.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\n/**\n * Converts a number to its ordinal representation (e.g., 1st, 2nd, 3rd, etc.).\n *\n * @example\n * ```typescript\n * toOrdinal(1); // \"1st\"\n * toOrdinal(2); // \"2nd\"\n * toOrdinal(3); // \"3rd\"\n * toOrdinal(4); // \"4th\"\n * toOrdinal(11); // \"11th\"\n * toOrdinal(12); // \"12th\"\n * toOrdinal(13); // \"13th\"\n * toOrdinal(21); // \"21st\"\n * ```\n *\n * @param int - The number to convert to an ordinal string.\n * @returns The ordinal representation of the number as a string.\n */\nexport function toOrdinal(int: number): string {\n  const j = int % 10;\n  const k = int % 100;\n  if (j === 1 && k !== 11) {\n    return `${int}st`;\n  }\n  if (j === 2 && k !== 12) {\n    return `${int}nd`;\n  }\n  if (j === 3 && k !== 13) {\n    return `${int}rd`;\n  }\n  return `${int}th`;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAoCA,SAAgB,UAAU,KAAqB;CAC7C,MAAM,IAAI,MAAM;CAChB,MAAM,IAAI,MAAM;AAChB,KAAI,MAAM,KAAK,MAAM,GACnB,QAAO,GAAG,IAAI;AAEhB,KAAI,MAAM,KAAK,MAAM,GACnB,QAAO,GAAG,IAAI;AAEhB,KAAI,MAAM,KAAK,MAAM,GACnB,QAAO,GAAG,IAAI;AAEhB,QAAO,GAAG,IAAI"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stryke/string-format",
-  "version": "0.13.6",
+  "version": "0.14.1",
   "type": "module",
   "description": "A package containing utility functions to transform strings into various formats.",
   "repository": {
@@ -69,6 +69,10 @@
       "require": "./dist/normalize-email.cjs",
       "import": "./dist/normalize-email.mjs"
     },
+    "./ordinals": {
+      "require": "./dist/ordinals.cjs",
+      "import": "./dist/ordinals.mjs"
+    },
     "./package": {
       "require": "./dist/package.cjs",
       "import": "./dist/package.mjs"
@@ -127,5 +131,5 @@
   "types": "./dist/index.d.cts",
   "devDependencies": { "tsdown": "^0.17.2" },
   "publishConfig": { "access": "public" },
-  "gitHead": "e6880b328f3e8390a4ffd440c1bfc335de4e76c4"
+  "gitHead": "6dde4aa98913fd92c253aff3b574cdd5e048b9dc"
 }