element-symbol-format 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Paul Puhnaty
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,99 @@
+# Element Symbol Format
+
+Capitalizes a string so the letters match the chemical element symbols found
+on the [Periodic Table](https://wikipedia.org/wiki/Periodic_table). For example, the string "Case one" will be formatted
+as "CaSe ONe":
+
+- `Ca` > [Calcium](https://wikipedia.org/wiki/Calcium)
+- `Se` > [Selenium](https://wikipedia.org/wiki/Selenium)
+- `O`  > [Oxygen](https://wikipedia.org/wiki/Oxygen)
+- `Ne` > [Neon](https://wikipedia.org/wiki/Neon)
+
+
+## Installation
+
+Install using npm:
+
+`$ npm i element-symbol-format`
+
+## Usage
+
+### Import
+
+Import the `element-symbol-format` package in your code.
+
+```javascript
+// ESM
+import { elementSymbolFormat } from 'element-symbol-format';
+
+// CJS
+const { elementSymbolFormat } = require('element-symbol-format');
+```
+
+### Format Strings
+
+Pass your strings to the `elementSymbolFormat` function.
+
+```javascript
+const result = elementSymbolFormat('I snack on chocolate');
+
+// The result is an array of formatted words.
+
+console.log(result.length) // 4
+
+// You can get the entire result at once...
+
+console.log(result.toString()); // I SnAcK ON CHoCoLaTe
+console.log(result.toSymbols()); // [ 'I', ' ', 'Sn', 'Ac', 'K', ' ', 'O',  'N', ... ]
+
+// ...or access each word individually
+
+console.log(result[3].toString()); // CHoCoLaTe
+console.log(result[3].toSymbols()); // [ 'C', 'Ho', 'Co', 'La', 'Te' ]
+```
+
+### Handling Formatting Failures
+
+Unfortunately, many common words can't be represented completely with element symbols.
+Make sure to check the `isFormatted` field before using the result.
+
+```javascript
+const result = elementSymbolFormat('Learn how to fail intelligently ~ Charles Kettering')
+
+console.log(result.isFormatted) // false
+
+console.log(result[2].isFormatted) // true
+console.log(result[4].isFormatted) // false
+
+console.log(result[4].formatted.toString()) // InTe
+console.log(result[4].unformatted) // lligently
+```
+
+### Options
+
+The behavior of the formatter can be customized by passing an object as
+a parameter to `elementSymbolFormat`.
+
+```javascript
+const defaultOptions = {
+  // The input string will be split on every occurrence of "split".
+  // If "split" is an empty string, the input string will not be split.
+  "split": ' ',
+  
+  // The input string will be split at every non-letter.
+  // If set to true, this overrides "split".
+  "strictSplit": false,
+  
+  // Prefer single-letter element symbols when possible.
+  "preferSingleSymbols": false,
+  
+  // Remove non-letters from the input string.
+  "stripNonLetters": true,
+  
+  // The string used to join the formatted words together into a string.
+  // If not defined, then "split" will be used.
+  "join": undefined,
+}
+
+const result = elementSymbolFormat('Pass options here ->', defaultOptions)
+```

package/dist/index.d.mts

@@ -0,0 +1,28 @@
+interface FormattedCheckable {
+    readonly isFormatted: boolean;
+}
+interface SymbolDecomposable {
+    toString(): string;
+    toSymbols(): string[];
+}
+interface PartiallyFormattable extends SymbolDecomposable, FormattedCheckable {
+    get formatted(): SymbolDecomposable;
+    get unformatted(): string;
+}
+interface FormattedResult extends Array<PartiallyFormattable>, SymbolDecomposable, FormattedCheckable {
+}
+interface FormatOptions {
+    split?: string;
+    strictSplit?: boolean;
+    preferSingleSymbols?: boolean;
+    stripNonLetters?: boolean;
+    join?: string;
+}
+
+declare function elementSymbolFormat(input: string, options?: FormatOptions): FormattedResult;
+
+declare const _default: {
+    elementSymbolFormat(input: string, options?: FormatOptions): FormattedResult;
+};
+
+export { type FormatOptions, type FormattedCheckable, type FormattedResult, type PartiallyFormattable, type SymbolDecomposable, _default as default, elementSymbolFormat };

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+interface FormattedCheckable {
+    readonly isFormatted: boolean;
+}
+interface SymbolDecomposable {
+    toString(): string;
+    toSymbols(): string[];
+}
+interface PartiallyFormattable extends SymbolDecomposable, FormattedCheckable {
+    get formatted(): SymbolDecomposable;
+    get unformatted(): string;
+}
+interface FormattedResult extends Array<PartiallyFormattable>, SymbolDecomposable, FormattedCheckable {
+}
+interface FormatOptions {
+    split?: string;
+    strictSplit?: boolean;
+    preferSingleSymbols?: boolean;
+    stripNonLetters?: boolean;
+    join?: string;
+}
+
+declare function elementSymbolFormat(input: string, options?: FormatOptions): FormattedResult;
+
+declare const _default: {
+    elementSymbolFormat(input: string, options?: FormatOptions): FormattedResult;
+};
+
+export { type FormatOptions, type FormattedCheckable, type FormattedResult, type PartiallyFormattable, type SymbolDecomposable, _default as default, elementSymbolFormat };

package/dist/index.js

@@ -0,0 +1,430 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  default: () => index_default,
+  elementSymbolFormat: () => elementSymbolFormat
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/interfaces.ts
+var interfaces_exports = {};
+
+// src/api.ts
+var api_exports = {};
+__export(api_exports, {
+  elementSymbolFormat: () => elementSymbolFormat
+});
+
+// src/helpers.ts
+function doSplit(input, split) {
+  if (input === "") return [];
+  if (split === "") return [input];
+  return input.split(split);
+}
+function doStrictSplit(input) {
+  const output = [];
+  if (input.length === 0) return output;
+  let iStart = 0;
+  let wasLetter = isLetter(input[iStart]);
+  for (let iEnd = 1; iEnd < input.length; iEnd++) {
+    const nowLetter = isLetter(input[iEnd]);
+    if (nowLetter !== wasLetter) {
+      output.push(input.slice(iStart, iEnd));
+      wasLetter = nowLetter;
+      iStart = iEnd;
+    }
+  }
+  output.push(input.slice(iStart));
+  return output;
+}
+function doStripNonLetters(input) {
+  for (let i = 0; i < input.length; i++) {
+    input[i] = input[i].split("").filter((char) => isLetter(char)).join("");
+  }
+  return input.filter((s) => s.length !== 0);
+}
+function isLetter(ch) {
+  return ch >= "a" && ch <= "z" || ch >= "A" && ch <= "Z";
+}
+function isLowerCase(ch) {
+  return ch >= "a" && ch <= "z";
+}
+function isUpperCase(ch) {
+  return ch >= "A" && ch <= "Z";
+}
+
+// src/types.ts
+var SegmentSymbols = class {
+  value;
+  constructor(value) {
+    this.value = value;
+  }
+  toString() {
+    return this.value;
+  }
+  toSymbols() {
+    const symbols = [];
+    const chars = this.value.split("").filter((char) => isLetter(char));
+    for (let i = 0; i < chars.length; i++) {
+      if (isUpperCase(chars[i])) {
+        const iNext = i + 1;
+        if (iNext < chars.length && isLowerCase(chars[iNext])) {
+          symbols.push(chars[i] + chars[iNext]);
+        } else {
+          symbols.push(chars[i]);
+        }
+      }
+    }
+    return symbols;
+  }
+};
+var ResultSegment = class {
+  isFormatted;
+  value;
+  firstMiss;
+  constructor(value, firstMiss) {
+    this.firstMiss = firstMiss;
+    this.value = value;
+    this.isFormatted = firstMiss >= value.length;
+  }
+  get formatted() {
+    const formattedPart = this.value.slice(0, this.firstMiss);
+    return new SegmentSymbols(formattedPart, true);
+  }
+  get unformatted() {
+    if (this.isFormatted) {
+      return "";
+    } else {
+      return this.value.slice(this.firstMiss);
+    }
+  }
+  toString() {
+    return this.value;
+  }
+  toSymbols() {
+    const symbols = this.formatted.toSymbols();
+    if (!this.isFormatted) {
+      const stripped = this.unformatted.split("").filter((char) => isLetter(char)).join("");
+      symbols.push(stripped);
+    }
+    return symbols;
+  }
+};
+var ResultArray = class extends Array {
+  isFormatted;
+  joinStr;
+  constructor(join, ...segments) {
+    super(...segments);
+    this.isFormatted = true;
+    this.joinStr = join;
+    for (const segment of segments) {
+      if (!segment.isFormatted) {
+        this.isFormatted = false;
+        break;
+      }
+    }
+  }
+  toString() {
+    const segments = [];
+    for (const segment of this) {
+      segments.push(segment.toString());
+    }
+    return segments.join(this.joinStr);
+  }
+  toSymbols() {
+    const symbols = [];
+    this.forEach((segment, index) => {
+      const segmentSymbols = segment.toSymbols();
+      symbols.push(...segmentSymbols);
+      if (index != this.length - 1) {
+        symbols.push(this.joinStr);
+      }
+    }, this);
+    return symbols;
+  }
+};
+
+// src/elements.ts
+var elementSymbols = [
+  "H",
+  "He",
+  "Li",
+  "Be",
+  "B",
+  "C",
+  "N",
+  "O",
+  "F",
+  "Ne",
+  "Na",
+  "Mg",
+  "Al",
+  "Si",
+  "P",
+  "S",
+  "Cl",
+  "Ar",
+  "K",
+  "Ca",
+  "Sc",
+  "Ti",
+  "V",
+  "Cr",
+  "Mn",
+  "Fe",
+  "Co",
+  "Ni",
+  "Cu",
+  "Zn",
+  "Ga",
+  "Ge",
+  "As",
+  "Se",
+  "Br",
+  "Kr",
+  "Rb",
+  "Sr",
+  "Y",
+  "Zr",
+  "Nb",
+  "Mo",
+  "Tc",
+  "Ru",
+  "Rh",
+  "Pd",
+  "Ag",
+  "Cd",
+  "In",
+  "Sn",
+  "Sb",
+  "Te",
+  "I",
+  "Xe",
+  "Cs",
+  "Ba",
+  "La",
+  "Ce",
+  "Pr",
+  "Nd",
+  "Pm",
+  "Sm",
+  "Eu",
+  "Gd",
+  "Tb",
+  "Dy",
+  "Ho",
+  "Er",
+  "Tm",
+  "Yb",
+  "Lu",
+  "Hf",
+  "Ta",
+  "W",
+  "Re",
+  "Os",
+  "Ir",
+  "Pt",
+  "Au",
+  "Hg",
+  "Tl",
+  "Pb",
+  "Bi",
+  "Po",
+  "At",
+  "Rn",
+  "Fr",
+  "Ra",
+  "Ac",
+  "Th",
+  "Pa",
+  "U",
+  "Np",
+  "Pu",
+  "Am",
+  "Cm",
+  "Bk",
+  "Cf",
+  "Es",
+  "Fm",
+  "Md",
+  "No",
+  "Lr",
+  "Rf",
+  "Db",
+  "Sg",
+  "Bh",
+  "Hs",
+  "Mt",
+  "Ds",
+  "Rg",
+  "Cn",
+  "Nh",
+  "Fl",
+  "Mc",
+  "Lv",
+  "Ts",
+  "Og"
+];
+var elementSet = new Set(elementSymbols.map((s) => s.toLowerCase()));
+function elementLookup(input) {
+  return elementSet.has(input.toLowerCase());
+}
+
+// src/formatter.ts
+var SmartIndex = class {
+  _index = 1;
+  get mark() {
+    return this._index;
+  }
+  get char() {
+    return this._index - 1;
+  }
+  set mark(i) {
+    this._index = i;
+  }
+  set char(i) {
+    this._index = i + 1;
+  }
+};
+function format(input, preferSingleSymbols) {
+  input = input.toLowerCase();
+  const markers = findFormatMarkers(input);
+  let firstMiss;
+  for (let i = input.length; i >= 0; i--) {
+    if (markers[i] !== 0 /* Unmarked */) {
+      firstMiss = i;
+      break;
+    }
+  }
+  const output = applyFormatMarkers(input, markers, preferSingleSymbols);
+  return new ResultSegment(output, firstMiss);
+}
+function findFormatMarkers(input) {
+  const markers = new Array(input.length + 1).fill(0 /* Unmarked */);
+  markers[0] = 1 /* Start */;
+  const i = new SmartIndex();
+  for (i.char = 0; i.char < input.length; i.char++) {
+    if (markers[i.mark - 1] === 0 /* Unmarked */) continue;
+    if (markers[i.mark - 1] === 6 /* FirstHalf */) continue;
+    if (!isLetter(input[i.char])) {
+      markers[i.mark] = 5 /* Skip */;
+      continue;
+    }
+    if (elementLookup(input[i.char])) {
+      if (markers[i.mark] === 3 /* TwoLetter */) {
+        markers[i.mark] = 4 /* OneOrTwoLetter */;
+      } else {
+        markers[i.mark] = 2 /* OneLetter */;
+      }
+    }
+    let offset = 1;
+    while (i.char + offset < input.length) {
+      if (!isLetter(input[i.char + offset])) {
+        offset += 1;
+        continue;
+      }
+      const digram = input[i.char] + input[i.char + offset];
+      if (elementLookup(digram)) {
+        markers[i.mark + offset] = 3 /* TwoLetter */;
+        if (markers[i.mark] === 0 /* Unmarked */) {
+          markers[i.mark] = 6 /* FirstHalf */;
+        }
+      }
+      break;
+    }
+  }
+  return markers;
+}
+function applyFormatMarkers(input, markers, preferSingleSymbols) {
+  const array = input.split("");
+  const i = new SmartIndex();
+  i.mark = input.length;
+  while (i.mark > 0) {
+    if (markers[i.mark] === 0 /* Unmarked */ || markers[i.mark] === 5 /* Skip */) {
+      i.mark -= 1;
+      continue;
+    }
+    if (markers[i.mark] === 4 /* OneOrTwoLetter */) {
+      if (preferSingleSymbols) {
+        markers[i.mark] = 2 /* OneLetter */;
+      } else {
+        markers[i.mark] = 3 /* TwoLetter */;
+      }
+    }
+    if (markers[i.mark] === 2 /* OneLetter */) {
+      array[i.char] = array[i.char].toUpperCase();
+    } else if (markers[i.mark] === 3 /* TwoLetter */) {
+      let offset = 1;
+      while (markers[i.mark - offset] === 5 /* Skip */ || markers[i.mark - offset] === 0 /* Unmarked */) {
+        offset += 1;
+      }
+      array[i.char - offset] = array[i.char - offset].toUpperCase();
+      i.mark -= offset;
+    }
+    i.mark -= 1;
+  }
+  return array.join("");
+}
+
+// src/api.ts
+function valueOrDefault(value, defaultValue) {
+  return value !== void 0 ? value : defaultValue;
+}
+function elementSymbolFormat(input, options) {
+  const split = valueOrDefault(options?.split, " ");
+  const strictSplit = valueOrDefault(options?.strictSplit, false);
+  const preferSingleSymbols = valueOrDefault(options?.preferSingleSymbols, false);
+  const stripNonLetters = valueOrDefault(options?.stripNonLetters, true);
+  const join = valueOrDefault(options?.join, split);
+  const splitLetter = split.split("").find((char) => isLetter(char));
+  if (splitLetter !== void 0) {
+    throw new Error(
+      `elementSymbolFormat() will not split on a string with a letter "${splitLetter}"`
+    );
+  }
+  let inputSegments;
+  if (strictSplit) {
+    inputSegments = doStrictSplit(input);
+  } else {
+    inputSegments = doSplit(input, split);
+  }
+  if (stripNonLetters) {
+    inputSegments = doStripNonLetters(inputSegments);
+  }
+  const outputSegments = [];
+  for (const segment of inputSegments) {
+    const result = format(segment, preferSingleSymbols);
+    outputSegments.push(result);
+  }
+  return new ResultArray(join, ...outputSegments);
+}
+
+// src/index.ts
+var index_default = {
+  ...interfaces_exports,
+  ...api_exports
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  elementSymbolFormat
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/interfaces.ts","../src/api.ts","../src/helpers.ts","../src/types.ts","../src/elements.ts","../src/formatter.ts"],"sourcesContent":["// SPDX-License-Identifier: MIT\n// Copyright © 2026 Paul Puhnaty\n\nexport * from \"./interfaces\";\nexport * from \"./api\";\n\nimport * as interfaces from \"./interfaces\";\nimport * as api from \"./api\";\n\nexport default {\n  ...interfaces,\n  ...api,\n};\n","// SPDX-License-Identifier: MIT\n// Copyright © 2026 Paul Puhnaty\n\nexport interface FormattedCheckable {\n  readonly isFormatted: boolean;\n}\n\nexport interface SymbolDecomposable {\n  toString(): string;\n  toSymbols(): string[];\n}\n\nexport interface PartiallyFormattable extends SymbolDecomposable, FormattedCheckable {\n  get formatted(): SymbolDecomposable;\n  get unformatted(): string;\n}\n\nexport interface FormattedResult\n  extends Array<PartiallyFormattable>, SymbolDecomposable, FormattedCheckable {}\n\nexport interface FormatOptions {\n  split?: string;\n  strictSplit?: boolean;\n  preferSingleSymbols?: boolean;\n  stripNonLetters?: boolean;\n  join?: string;\n}\n","// SPDX-License-Identifier: MIT\n// Copyright © 2026 Paul Puhnaty\n\nimport * as interfaces from \"./interfaces\";\nimport * as types from \"./types\";\nimport * as helpers from \"./helpers\";\nimport { format } from \"./formatter\";\n\nfunction valueOrDefault<T>(value: T | undefined, defaultValue: T): T {\n  return value !== undefined ? value : defaultValue;\n}\n\nexport function elementSymbolFormat(\n  input: string,\n  options?: interfaces.FormatOptions,\n): interfaces.FormattedResult {\n  const split = valueOrDefault(options?.split, \" \");\n  const strictSplit = valueOrDefault(options?.strictSplit, false);\n  const preferSingleSymbols = valueOrDefault(options?.preferSingleSymbols, false);\n  const stripNonLetters = valueOrDefault(options?.stripNonLetters, true);\n  const join = valueOrDefault(options?.join, split);\n\n  // Verify \"split\"\n\n  const splitLetter = split.split(\"\").find((char) => helpers.isLetter(char));\n\n  if (splitLetter !== undefined) {\n    throw new Error(\n      `elementSymbolFormat() will not split on a string with a letter \"${splitLetter}\"`,\n    );\n  }\n\n  // Split input\n\n  let inputSegments: string[];\n\n  if (strictSplit) {\n    inputSegments = helpers.doStrictSplit(input);\n  } else {\n    inputSegments = helpers.doSplit(input, split);\n  }\n\n  // Strip input\n\n  if (stripNonLetters) {\n    inputSegments = helpers.doStripNonLetters(inputSegments);\n  }\n\n  // Format input\n\n  const outputSegments: types.ResultSegment[] = [];\n\n  for (const segment of inputSegments) {\n    const result = format(segment, preferSingleSymbols);\n    outputSegments.push(result);\n  }\n\n  // Return results\n\n  return new types.ResultArray(join, ...outputSegments);\n}\n","// SPDX-License-Identifier: MIT\n// Copyright © 2026 Paul Puhnaty\n\nexport function doSplit(input: string, split: string): string[] {\n  if (input === \"\") return [];\n\n  if (split === \"\") return [input];\n\n  return input.split(split);\n}\n\nexport function doStrictSplit(input: string): string[] {\n  const output: string[] = [];\n\n  if (input.length === 0) return output;\n\n  let iStart = 0;\n  let wasLetter: boolean = isLetter(input[iStart]);\n\n  for (let iEnd = 1; iEnd < input.length; iEnd++) {\n    const nowLetter: boolean = isLetter(input[iEnd]);\n\n    if (nowLetter !== wasLetter) {\n      output.push(input.slice(iStart, iEnd));\n\n      wasLetter = nowLetter;\n      iStart = iEnd;\n    }\n  }\n\n  // Add the remaining bit to the output\n  output.push(input.slice(iStart));\n\n  return output;\n}\n\nexport function doStripNonLetters(input: string[]): string[] {\n  for (let i = 0; i < input.length; i++) {\n    input[i] = input[i]\n      .split(\"\")\n      .filter((char) => isLetter(char))\n      .join(\"\");\n  }\n\n  return input.filter((s) => s.length !== 0);\n}\n\nexport function isLetter(ch: string): boolean {\n  return (ch >= \"a\" && ch <= \"z\") || (ch >= \"A\" && ch <= \"Z\");\n}\n\nexport function isLowerCase(ch: string): boolean {\n  return ch >= \"a\" && ch <= \"z\";\n}\n\nexport function isUpperCase(ch: string): boolean {\n  return ch >= \"A\" && ch <= \"Z\";\n}\n","// SPDX-License-Identifier: MIT\n// Copyright © 2026 Paul Puhnaty\n\nimport * as interfaces from \"./interfaces\";\nimport { isLetter, isLowerCase, isUpperCase } from \"./helpers\";\n\nexport class SegmentSymbols implements interfaces.SymbolDecomposable {\n  private value: string;\n\n  constructor(value: string) {\n    this.value = value;\n  }\n\n  toString(): string {\n    return this.value;\n  }\n\n  toSymbols(): string[] {\n    const symbols: string[] = [];\n\n    const chars = this.value.split(\"\").filter((char) => isLetter(char));\n\n    for (let i = 0; i < chars.length; i++) {\n      if (isUpperCase(chars[i])) {\n        const iNext = i + 1;\n\n        if (iNext < chars.length && isLowerCase(chars[iNext])) {\n          symbols.push(chars[i] + chars[iNext]);\n        } else {\n          symbols.push(chars[i]);\n        }\n      }\n    }\n\n    return symbols;\n  }\n}\n\nexport class ResultSegment implements interfaces.PartiallyFormattable {\n  readonly isFormatted: boolean;\n  private value: string;\n  private firstMiss: number;\n\n  constructor(value: string, firstMiss: number) {\n    this.firstMiss = firstMiss;\n    this.value = value;\n\n    this.isFormatted = firstMiss >= value.length;\n  }\n\n  get formatted(): SegmentSymbols {\n    const formattedPart = this.value.slice(0, this.firstMiss);\n\n    return new SegmentSymbols(formattedPart, true);\n  }\n\n  get unformatted(): string {\n    if (this.isFormatted) {\n      return \"\";\n    } else {\n      return this.value.slice(this.firstMiss);\n    }\n  }\n\n  toString(): string {\n    return this.value;\n  }\n\n  toSymbols(): string[] {\n    const symbols = this.formatted.toSymbols();\n\n    if (!this.isFormatted) {\n      const stripped = this.unformatted\n        .split(\"\")\n        .filter((char) => isLetter(char))\n        .join(\"\");\n\n      symbols.push(stripped);\n    }\n\n    return symbols;\n  }\n}\n\nexport class ResultArray extends Array<ResultSegment> implements interfaces.FormattedResult {\n  readonly isFormatted: boolean;\n  private joinStr: string;\n\n  constructor(join: string, ...segments: ResultSegment[]) {\n    super(...segments);\n\n    this.isFormatted = true; // Assume true\n    this.joinStr = join;\n\n    // Check for unformatted segments\n    for (const segment of segments) {\n      if (!segment.isFormatted) {\n        this.isFormatted = false;\n        break;\n      }\n    }\n  }\n\n  toString(): string {\n    const segments: string[] = [];\n\n    for (const segment of this) {\n      segments.push(segment.toString());\n    }\n\n    return segments.join(this.joinStr);\n  }\n\n  toSymbols(): string[] {\n    const symbols: string[] = [];\n\n    this.forEach((segment, index) => {\n      const segmentSymbols = segment.toSymbols();\n\n      symbols.push(...segmentSymbols);\n\n      if (index != this.length - 1) {\n        symbols.push(this.joinStr);\n      }\n    }, this);\n\n    return symbols;\n  }\n}\n","// SPDX-License-Identifier: MIT\n// Copyright © 2026 Paul Puhnaty\n\nconst elementSymbols = [\n  \"H\",\n  \"He\",\n  \"Li\",\n  \"Be\",\n  \"B\",\n  \"C\",\n  \"N\",\n  \"O\",\n  \"F\",\n  \"Ne\",\n  \"Na\",\n  \"Mg\",\n  \"Al\",\n  \"Si\",\n  \"P\",\n  \"S\",\n  \"Cl\",\n  \"Ar\",\n  \"K\",\n  \"Ca\",\n  \"Sc\",\n  \"Ti\",\n  \"V\",\n  \"Cr\",\n  \"Mn\",\n  \"Fe\",\n  \"Co\",\n  \"Ni\",\n  \"Cu\",\n  \"Zn\",\n  \"Ga\",\n  \"Ge\",\n  \"As\",\n  \"Se\",\n  \"Br\",\n  \"Kr\",\n  \"Rb\",\n  \"Sr\",\n  \"Y\",\n  \"Zr\",\n  \"Nb\",\n  \"Mo\",\n  \"Tc\",\n  \"Ru\",\n  \"Rh\",\n  \"Pd\",\n  \"Ag\",\n  \"Cd\",\n  \"In\",\n  \"Sn\",\n  \"Sb\",\n  \"Te\",\n  \"I\",\n  \"Xe\",\n  \"Cs\",\n  \"Ba\",\n  \"La\",\n  \"Ce\",\n  \"Pr\",\n  \"Nd\",\n  \"Pm\",\n  \"Sm\",\n  \"Eu\",\n  \"Gd\",\n  \"Tb\",\n  \"Dy\",\n  \"Ho\",\n  \"Er\",\n  \"Tm\",\n  \"Yb\",\n  \"Lu\",\n  \"Hf\",\n  \"Ta\",\n  \"W\",\n  \"Re\",\n  \"Os\",\n  \"Ir\",\n  \"Pt\",\n  \"Au\",\n  \"Hg\",\n  \"Tl\",\n  \"Pb\",\n  \"Bi\",\n  \"Po\",\n  \"At\",\n  \"Rn\",\n  \"Fr\",\n  \"Ra\",\n  \"Ac\",\n  \"Th\",\n  \"Pa\",\n  \"U\",\n  \"Np\",\n  \"Pu\",\n  \"Am\",\n  \"Cm\",\n  \"Bk\",\n  \"Cf\",\n  \"Es\",\n  \"Fm\",\n  \"Md\",\n  \"No\",\n  \"Lr\",\n  \"Rf\",\n  \"Db\",\n  \"Sg\",\n  \"Bh\",\n  \"Hs\",\n  \"Mt\",\n  \"Ds\",\n  \"Rg\",\n  \"Cn\",\n  \"Nh\",\n  \"Fl\",\n  \"Mc\",\n  \"Lv\",\n  \"Ts\",\n  \"Og\",\n];\n\nconst elementSet = new Set(elementSymbols.map((s) => s.toLowerCase()));\n\nexport function elementLookup(input: string): boolean {\n  return elementSet.has(input.toLowerCase());\n}\n","// SPDX-License-Identifier: MIT\n// Copyright © 2026 Paul Puhnaty\n\nimport * as types from \"./types\";\nimport { isLetter } from \"./helpers\";\nimport { elementLookup } from \"./elements\";\n\nenum FormatMarker {\n  Unmarked,\n  Start,\n  OneLetter,\n  TwoLetter,\n  OneOrTwoLetter,\n  Skip,\n  FirstHalf,\n}\n\n// The marker array and input string are offset by one\n// since the marker array contains a \"start\" symbol in\n// its first index. The SmartIndex will handle the conversion.\nclass SmartIndex {\n  private _index: number = 1;\n\n  get mark(): number {\n    return this._index;\n  }\n\n  get char(): number {\n    return this._index - 1;\n  }\n\n  set mark(i: number) {\n    this._index = i;\n  }\n\n  set char(i: number) {\n    this._index = i + 1;\n  }\n}\n\nexport function format(input: string, preferSingleSymbols: boolean): types.ResultSegment {\n  input = input.toLowerCase();\n\n  // Analyze the input string\n  const markers: FormatMarker[] = findFormatMarkers(input);\n\n  let firstMiss: number;\n\n  // \"firstMiss\" is guaranteed to be set by this next loop\n  // because the first value in \"markers\" is always FormatMarker.Start\n\n  for (let i = input.length; i >= 0; i--) {\n    if (markers[i] !== FormatMarker.Unmarked) {\n      firstMiss = i;\n      break;\n    }\n  }\n\n  // Apply formatting to the input string\n  const output = applyFormatMarkers(input, markers, preferSingleSymbols);\n\n  return new types.ResultSegment(output, firstMiss);\n}\n\nfunction findFormatMarkers(input: string): FormatMarker[] {\n  const markers: FormatMarker[] = new Array(input.length + 1).fill(FormatMarker.Unmarked);\n  markers[0] = FormatMarker.Start;\n\n  const i = new SmartIndex();\n\n  for (i.char = 0; i.char < input.length; i.char++) {\n    // Check the previous marker; skip if this letter is not reachable\n    if (markers[i.mark - 1] === FormatMarker.Unmarked) continue;\n    if (markers[i.mark - 1] === FormatMarker.FirstHalf) continue;\n\n    // Skip non-letters\n    if (!isLetter(input[i.char])) {\n      markers[i.mark] = FormatMarker.Skip;\n      continue;\n    }\n\n    // Check for single letter symbol\n    if (elementLookup(input[i.char])) {\n      if (markers[i.mark] === FormatMarker.TwoLetter) {\n        markers[i.mark] = FormatMarker.OneOrTwoLetter;\n      } else {\n        markers[i.mark] = FormatMarker.OneLetter;\n      }\n    }\n\n    // Check for two letter symbol\n    let offset = 1;\n    while (i.char + offset < input.length) {\n      // Skip if this is not a letter\n      if (!isLetter(input[i.char + offset])) {\n        offset += 1;\n        continue;\n      }\n\n      const digram = input[i.char] + input[i.char + offset];\n\n      if (elementLookup(digram)) {\n        markers[i.mark + offset] = FormatMarker.TwoLetter;\n\n        // Mark the current letter if it isn't marked\n        // already, so it can be found when formatting.\n        if (markers[i.mark] === FormatMarker.Unmarked) {\n          markers[i.mark] = FormatMarker.FirstHalf;\n        }\n      }\n\n      break;\n    }\n  }\n\n  return markers;\n}\n\nfunction applyFormatMarkers(\n  input: string,\n  markers: FormatMarker[],\n  preferSingleSymbols: boolean,\n): string {\n  const array = input.split(\"\");\n\n  const i = new SmartIndex();\n\n  i.mark = input.length;\n\n  while (i.mark > 0) {\n    if (markers[i.mark] === FormatMarker.Unmarked || markers[i.mark] === FormatMarker.Skip) {\n      i.mark -= 1;\n      continue;\n    }\n\n    // Choose between OneLetter or TwoLetter\n    if (markers[i.mark] === FormatMarker.OneOrTwoLetter) {\n      if (preferSingleSymbols) {\n        markers[i.mark] = FormatMarker.OneLetter;\n      } else {\n        markers[i.mark] = FormatMarker.TwoLetter;\n      }\n    }\n\n    // Case OneLetter\n    if (markers[i.mark] === FormatMarker.OneLetter) {\n      array[i.char] = array[i.char].toUpperCase();\n    }\n    // Case TwoLetter\n    else if (markers[i.mark] === FormatMarker.TwoLetter) {\n      let offset = 1;\n      while (\n        markers[i.mark - offset] === FormatMarker.Skip ||\n        markers[i.mark - offset] === FormatMarker.Unmarked\n      ) {\n        offset += 1;\n      }\n      array[i.char - offset] = array[i.char - offset].toUpperCase();\n      i.mark -= offset;\n    }\n\n    i.mark -= 1;\n  }\n\n  return array.join(\"\");\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,409 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/interfaces.ts
+var interfaces_exports = {};
+
+// src/api.ts
+var api_exports = {};
+__export(api_exports, {
+  elementSymbolFormat: () => elementSymbolFormat
+});
+
+// src/helpers.ts
+function doSplit(input, split) {
+  if (input === "") return [];
+  if (split === "") return [input];
+  return input.split(split);
+}
+function doStrictSplit(input) {
+  const output = [];
+  if (input.length === 0) return output;
+  let iStart = 0;
+  let wasLetter = isLetter(input[iStart]);
+  for (let iEnd = 1; iEnd < input.length; iEnd++) {
+    const nowLetter = isLetter(input[iEnd]);
+    if (nowLetter !== wasLetter) {
+      output.push(input.slice(iStart, iEnd));
+      wasLetter = nowLetter;
+      iStart = iEnd;
+    }
+  }
+  output.push(input.slice(iStart));
+  return output;
+}
+function doStripNonLetters(input) {
+  for (let i = 0; i < input.length; i++) {
+    input[i] = input[i].split("").filter((char) => isLetter(char)).join("");
+  }
+  return input.filter((s) => s.length !== 0);
+}
+function isLetter(ch) {
+  return ch >= "a" && ch <= "z" || ch >= "A" && ch <= "Z";
+}
+function isLowerCase(ch) {
+  return ch >= "a" && ch <= "z";
+}
+function isUpperCase(ch) {
+  return ch >= "A" && ch <= "Z";
+}
+
+// src/types.ts
+var SegmentSymbols = class {
+  value;
+  constructor(value) {
+    this.value = value;
+  }
+  toString() {
+    return this.value;
+  }
+  toSymbols() {
+    const symbols = [];
+    const chars = this.value.split("").filter((char) => isLetter(char));
+    for (let i = 0; i < chars.length; i++) {
+      if (isUpperCase(chars[i])) {
+        const iNext = i + 1;
+        if (iNext < chars.length && isLowerCase(chars[iNext])) {
+          symbols.push(chars[i] + chars[iNext]);
+        } else {
+          symbols.push(chars[i]);
+        }
+      }
+    }
+    return symbols;
+  }
+};
+var ResultSegment = class {
+  isFormatted;
+  value;
+  firstMiss;
+  constructor(value, firstMiss) {
+    this.firstMiss = firstMiss;
+    this.value = value;
+    this.isFormatted = firstMiss >= value.length;
+  }
+  get formatted() {
+    const formattedPart = this.value.slice(0, this.firstMiss);
+    return new SegmentSymbols(formattedPart, true);
+  }
+  get unformatted() {
+    if (this.isFormatted) {
+      return "";
+    } else {
+      return this.value.slice(this.firstMiss);
+    }
+  }
+  toString() {
+    return this.value;
+  }
+  toSymbols() {
+    const symbols = this.formatted.toSymbols();
+    if (!this.isFormatted) {
+      const stripped = this.unformatted.split("").filter((char) => isLetter(char)).join("");
+      symbols.push(stripped);
+    }
+    return symbols;
+  }
+};
+var ResultArray = class extends Array {
+  isFormatted;
+  joinStr;
+  constructor(join, ...segments) {
+    super(...segments);
+    this.isFormatted = true;
+    this.joinStr = join;
+    for (const segment of segments) {
+      if (!segment.isFormatted) {
+        this.isFormatted = false;
+        break;
+      }
+    }
+  }
+  toString() {
+    const segments = [];
+    for (const segment of this) {
+      segments.push(segment.toString());
+    }
+    return segments.join(this.joinStr);
+  }
+  toSymbols() {
+    const symbols = [];
+    this.forEach((segment, index) => {
+      const segmentSymbols = segment.toSymbols();
+      symbols.push(...segmentSymbols);
+      if (index != this.length - 1) {
+        symbols.push(this.joinStr);
+      }
+    }, this);
+    return symbols;
+  }
+};
+
+// src/elements.ts
+var elementSymbols = [
+  "H",
+  "He",
+  "Li",
+  "Be",
+  "B",
+  "C",
+  "N",
+  "O",
+  "F",
+  "Ne",
+  "Na",
+  "Mg",
+  "Al",
+  "Si",
+  "P",
+  "S",
+  "Cl",
+  "Ar",
+  "K",
+  "Ca",
+  "Sc",
+  "Ti",
+  "V",
+  "Cr",
+  "Mn",
+  "Fe",
+  "Co",
+  "Ni",
+  "Cu",
+  "Zn",
+  "Ga",
+  "Ge",
+  "As",
+  "Se",
+  "Br",
+  "Kr",
+  "Rb",
+  "Sr",
+  "Y",
+  "Zr",
+  "Nb",
+  "Mo",
+  "Tc",
+  "Ru",
+  "Rh",
+  "Pd",
+  "Ag",
+  "Cd",
+  "In",
+  "Sn",
+  "Sb",
+  "Te",
+  "I",
+  "Xe",
+  "Cs",
+  "Ba",
+  "La",
+  "Ce",
+  "Pr",
+  "Nd",
+  "Pm",
+  "Sm",
+  "Eu",
+  "Gd",
+  "Tb",
+  "Dy",
+  "Ho",
+  "Er",
+  "Tm",
+  "Yb",
+  "Lu",
+  "Hf",
+  "Ta",
+  "W",
+  "Re",
+  "Os",
+  "Ir",
+  "Pt",
+  "Au",
+  "Hg",
+  "Tl",
+  "Pb",
+  "Bi",
+  "Po",
+  "At",
+  "Rn",
+  "Fr",
+  "Ra",
+  "Ac",
+  "Th",
+  "Pa",
+  "U",
+  "Np",
+  "Pu",
+  "Am",
+  "Cm",
+  "Bk",
+  "Cf",
+  "Es",
+  "Fm",
+  "Md",
+  "No",
+  "Lr",
+  "Rf",
+  "Db",
+  "Sg",
+  "Bh",
+  "Hs",
+  "Mt",
+  "Ds",
+  "Rg",
+  "Cn",
+  "Nh",
+  "Fl",
+  "Mc",
+  "Lv",
+  "Ts",
+  "Og"
+];
+var elementSet = new Set(elementSymbols.map((s) => s.toLowerCase()));
+function elementLookup(input) {
+  return elementSet.has(input.toLowerCase());
+}
+
+// src/formatter.ts
+var SmartIndex = class {
+  _index = 1;
+  get mark() {
+    return this._index;
+  }
+  get char() {
+    return this._index - 1;
+  }
+  set mark(i) {
+    this._index = i;
+  }
+  set char(i) {
+    this._index = i + 1;
+  }
+};
+function format(input, preferSingleSymbols) {
+  input = input.toLowerCase();
+  const markers = findFormatMarkers(input);
+  let firstMiss;
+  for (let i = input.length; i >= 0; i--) {
+    if (markers[i] !== 0 /* Unmarked */) {
+      firstMiss = i;
+      break;
+    }
+  }
+  const output = applyFormatMarkers(input, markers, preferSingleSymbols);
+  return new ResultSegment(output, firstMiss);
+}
+function findFormatMarkers(input) {
+  const markers = new Array(input.length + 1).fill(0 /* Unmarked */);
+  markers[0] = 1 /* Start */;
+  const i = new SmartIndex();
+  for (i.char = 0; i.char < input.length; i.char++) {
+    if (markers[i.mark - 1] === 0 /* Unmarked */) continue;
+    if (markers[i.mark - 1] === 6 /* FirstHalf */) continue;
+    if (!isLetter(input[i.char])) {
+      markers[i.mark] = 5 /* Skip */;
+      continue;
+    }
+    if (elementLookup(input[i.char])) {
+      if (markers[i.mark] === 3 /* TwoLetter */) {
+        markers[i.mark] = 4 /* OneOrTwoLetter */;
+      } else {
+        markers[i.mark] = 2 /* OneLetter */;
+      }
+    }
+    let offset = 1;
+    while (i.char + offset < input.length) {
+      if (!isLetter(input[i.char + offset])) {
+        offset += 1;
+        continue;
+      }
+      const digram = input[i.char] + input[i.char + offset];
+      if (elementLookup(digram)) {
+        markers[i.mark + offset] = 3 /* TwoLetter */;
+        if (markers[i.mark] === 0 /* Unmarked */) {
+          markers[i.mark] = 6 /* FirstHalf */;
+        }
+      }
+      break;
+    }
+  }
+  return markers;
+}
+function applyFormatMarkers(input, markers, preferSingleSymbols) {
+  const array = input.split("");
+  const i = new SmartIndex();
+  i.mark = input.length;
+  while (i.mark > 0) {
+    if (markers[i.mark] === 0 /* Unmarked */ || markers[i.mark] === 5 /* Skip */) {
+      i.mark -= 1;
+      continue;
+    }
+    if (markers[i.mark] === 4 /* OneOrTwoLetter */) {
+      if (preferSingleSymbols) {
+        markers[i.mark] = 2 /* OneLetter */;
+      } else {
+        markers[i.mark] = 3 /* TwoLetter */;
+      }
+    }
+    if (markers[i.mark] === 2 /* OneLetter */) {
+      array[i.char] = array[i.char].toUpperCase();
+    } else if (markers[i.mark] === 3 /* TwoLetter */) {
+      let offset = 1;
+      while (markers[i.mark - offset] === 5 /* Skip */ || markers[i.mark - offset] === 0 /* Unmarked */) {
+        offset += 1;
+      }
+      array[i.char - offset] = array[i.char - offset].toUpperCase();
+      i.mark -= offset;
+    }
+    i.mark -= 1;
+  }
+  return array.join("");
+}
+
+// src/api.ts
+function valueOrDefault(value, defaultValue) {
+  return value !== void 0 ? value : defaultValue;
+}
+function elementSymbolFormat(input, options) {
+  const split = valueOrDefault(options?.split, " ");
+  const strictSplit = valueOrDefault(options?.strictSplit, false);
+  const preferSingleSymbols = valueOrDefault(options?.preferSingleSymbols, false);
+  const stripNonLetters = valueOrDefault(options?.stripNonLetters, true);
+  const join = valueOrDefault(options?.join, split);
+  const splitLetter = split.split("").find((char) => isLetter(char));
+  if (splitLetter !== void 0) {
+    throw new Error(
+      `elementSymbolFormat() will not split on a string with a letter "${splitLetter}"`
+    );
+  }
+  let inputSegments;
+  if (strictSplit) {
+    inputSegments = doStrictSplit(input);
+  } else {
+    inputSegments = doSplit(input, split);
+  }
+  if (stripNonLetters) {
+    inputSegments = doStripNonLetters(inputSegments);
+  }
+  const outputSegments = [];
+  for (const segment of inputSegments) {
+    const result = format(segment, preferSingleSymbols);
+    outputSegments.push(result);
+  }
+  return new ResultArray(join, ...outputSegments);
+}
+
+// src/index.ts
+var index_default = {
+  ...interfaces_exports,
+  ...api_exports
+};
+export {
+  index_default as default,
+  elementSymbolFormat
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/interfaces.ts","../src/api.ts","../src/helpers.ts","../src/types.ts","../src/elements.ts","../src/formatter.ts","../src/index.ts"],"sourcesContent":["// SPDX-License-Identifier: MIT\n// Copyright © 2026 Paul Puhnaty\n\nexport interface FormattedCheckable {\n  readonly isFormatted: boolean;\n}\n\nexport interface SymbolDecomposable {\n  toString(): string;\n  toSymbols(): string[];\n}\n\nexport interface PartiallyFormattable extends SymbolDecomposable, FormattedCheckable {\n  get formatted(): SymbolDecomposable;\n  get unformatted(): string;\n}\n\nexport interface FormattedResult\n  extends Array<PartiallyFormattable>, SymbolDecomposable, FormattedCheckable {}\n\nexport interface FormatOptions {\n  split?: string;\n  strictSplit?: boolean;\n  preferSingleSymbols?: boolean;\n  stripNonLetters?: boolean;\n  join?: string;\n}\n","// SPDX-License-Identifier: MIT\n// Copyright © 2026 Paul Puhnaty\n\nimport * as interfaces from \"./interfaces\";\nimport * as types from \"./types\";\nimport * as helpers from \"./helpers\";\nimport { format } from \"./formatter\";\n\nfunction valueOrDefault<T>(value: T | undefined, defaultValue: T): T {\n  return value !== undefined ? value : defaultValue;\n}\n\nexport function elementSymbolFormat(\n  input: string,\n  options?: interfaces.FormatOptions,\n): interfaces.FormattedResult {\n  const split = valueOrDefault(options?.split, \" \");\n  const strictSplit = valueOrDefault(options?.strictSplit, false);\n  const preferSingleSymbols = valueOrDefault(options?.preferSingleSymbols, false);\n  const stripNonLetters = valueOrDefault(options?.stripNonLetters, true);\n  const join = valueOrDefault(options?.join, split);\n\n  // Verify \"split\"\n\n  const splitLetter = split.split(\"\").find((char) => helpers.isLetter(char));\n\n  if (splitLetter !== undefined) {\n    throw new Error(\n      `elementSymbolFormat() will not split on a string with a letter \"${splitLetter}\"`,\n    );\n  }\n\n  // Split input\n\n  let inputSegments: string[];\n\n  if (strictSplit) {\n    inputSegments = helpers.doStrictSplit(input);\n  } else {\n    inputSegments = helpers.doSplit(input, split);\n  }\n\n  // Strip input\n\n  if (stripNonLetters) {\n    inputSegments = helpers.doStripNonLetters(inputSegments);\n  }\n\n  // Format input\n\n  const outputSegments: types.ResultSegment[] = [];\n\n  for (const segment of inputSegments) {\n    const result = format(segment, preferSingleSymbols);\n    outputSegments.push(result);\n  }\n\n  // Return results\n\n  return new types.ResultArray(join, ...outputSegments);\n}\n","// SPDX-License-Identifier: MIT\n// Copyright © 2026 Paul Puhnaty\n\nexport function doSplit(input: string, split: string): string[] {\n  if (input === \"\") return [];\n\n  if (split === \"\") return [input];\n\n  return input.split(split);\n}\n\nexport function doStrictSplit(input: string): string[] {\n  const output: string[] = [];\n\n  if (input.length === 0) return output;\n\n  let iStart = 0;\n  let wasLetter: boolean = isLetter(input[iStart]);\n\n  for (let iEnd = 1; iEnd < input.length; iEnd++) {\n    const nowLetter: boolean = isLetter(input[iEnd]);\n\n    if (nowLetter !== wasLetter) {\n      output.push(input.slice(iStart, iEnd));\n\n      wasLetter = nowLetter;\n      iStart = iEnd;\n    }\n  }\n\n  // Add the remaining bit to the output\n  output.push(input.slice(iStart));\n\n  return output;\n}\n\nexport function doStripNonLetters(input: string[]): string[] {\n  for (let i = 0; i < input.length; i++) {\n    input[i] = input[i]\n      .split(\"\")\n      .filter((char) => isLetter(char))\n      .join(\"\");\n  }\n\n  return input.filter((s) => s.length !== 0);\n}\n\nexport function isLetter(ch: string): boolean {\n  return (ch >= \"a\" && ch <= \"z\") || (ch >= \"A\" && ch <= \"Z\");\n}\n\nexport function isLowerCase(ch: string): boolean {\n  return ch >= \"a\" && ch <= \"z\";\n}\n\nexport function isUpperCase(ch: string): boolean {\n  return ch >= \"A\" && ch <= \"Z\";\n}\n","// SPDX-License-Identifier: MIT\n// Copyright © 2026 Paul Puhnaty\n\nimport * as interfaces from \"./interfaces\";\nimport { isLetter, isLowerCase, isUpperCase } from \"./helpers\";\n\nexport class SegmentSymbols implements interfaces.SymbolDecomposable {\n  private value: string;\n\n  constructor(value: string) {\n    this.value = value;\n  }\n\n  toString(): string {\n    return this.value;\n  }\n\n  toSymbols(): string[] {\n    const symbols: string[] = [];\n\n    const chars = this.value.split(\"\").filter((char) => isLetter(char));\n\n    for (let i = 0; i < chars.length; i++) {\n      if (isUpperCase(chars[i])) {\n        const iNext = i + 1;\n\n        if (iNext < chars.length && isLowerCase(chars[iNext])) {\n          symbols.push(chars[i] + chars[iNext]);\n        } else {\n          symbols.push(chars[i]);\n        }\n      }\n    }\n\n    return symbols;\n  }\n}\n\nexport class ResultSegment implements interfaces.PartiallyFormattable {\n  readonly isFormatted: boolean;\n  private value: string;\n  private firstMiss: number;\n\n  constructor(value: string, firstMiss: number) {\n    this.firstMiss = firstMiss;\n    this.value = value;\n\n    this.isFormatted = firstMiss >= value.length;\n  }\n\n  get formatted(): SegmentSymbols {\n    const formattedPart = this.value.slice(0, this.firstMiss);\n\n    return new SegmentSymbols(formattedPart, true);\n  }\n\n  get unformatted(): string {\n    if (this.isFormatted) {\n      return \"\";\n    } else {\n      return this.value.slice(this.firstMiss);\n    }\n  }\n\n  toString(): string {\n    return this.value;\n  }\n\n  toSymbols(): string[] {\n    const symbols = this.formatted.toSymbols();\n\n    if (!this.isFormatted) {\n      const stripped = this.unformatted\n        .split(\"\")\n        .filter((char) => isLetter(char))\n        .join(\"\");\n\n      symbols.push(stripped);\n    }\n\n    return symbols;\n  }\n}\n\nexport class ResultArray extends Array<ResultSegment> implements interfaces.FormattedResult {\n  readonly isFormatted: boolean;\n  private joinStr: string;\n\n  constructor(join: string, ...segments: ResultSegment[]) {\n    super(...segments);\n\n    this.isFormatted = true; // Assume true\n    this.joinStr = join;\n\n    // Check for unformatted segments\n    for (const segment of segments) {\n      if (!segment.isFormatted) {\n        this.isFormatted = false;\n        break;\n      }\n    }\n  }\n\n  toString(): string {\n    const segments: string[] = [];\n\n    for (const segment of this) {\n      segments.push(segment.toString());\n    }\n\n    return segments.join(this.joinStr);\n  }\n\n  toSymbols(): string[] {\n    const symbols: string[] = [];\n\n    this.forEach((segment, index) => {\n      const segmentSymbols = segment.toSymbols();\n\n      symbols.push(...segmentSymbols);\n\n      if (index != this.length - 1) {\n        symbols.push(this.joinStr);\n      }\n    }, this);\n\n    return symbols;\n  }\n}\n","// SPDX-License-Identifier: MIT\n// Copyright © 2026 Paul Puhnaty\n\nconst elementSymbols = [\n  \"H\",\n  \"He\",\n  \"Li\",\n  \"Be\",\n  \"B\",\n  \"C\",\n  \"N\",\n  \"O\",\n  \"F\",\n  \"Ne\",\n  \"Na\",\n  \"Mg\",\n  \"Al\",\n  \"Si\",\n  \"P\",\n  \"S\",\n  \"Cl\",\n  \"Ar\",\n  \"K\",\n  \"Ca\",\n  \"Sc\",\n  \"Ti\",\n  \"V\",\n  \"Cr\",\n  \"Mn\",\n  \"Fe\",\n  \"Co\",\n  \"Ni\",\n  \"Cu\",\n  \"Zn\",\n  \"Ga\",\n  \"Ge\",\n  \"As\",\n  \"Se\",\n  \"Br\",\n  \"Kr\",\n  \"Rb\",\n  \"Sr\",\n  \"Y\",\n  \"Zr\",\n  \"Nb\",\n  \"Mo\",\n  \"Tc\",\n  \"Ru\",\n  \"Rh\",\n  \"Pd\",\n  \"Ag\",\n  \"Cd\",\n  \"In\",\n  \"Sn\",\n  \"Sb\",\n  \"Te\",\n  \"I\",\n  \"Xe\",\n  \"Cs\",\n  \"Ba\",\n  \"La\",\n  \"Ce\",\n  \"Pr\",\n  \"Nd\",\n  \"Pm\",\n  \"Sm\",\n  \"Eu\",\n  \"Gd\",\n  \"Tb\",\n  \"Dy\",\n  \"Ho\",\n  \"Er\",\n  \"Tm\",\n  \"Yb\",\n  \"Lu\",\n  \"Hf\",\n  \"Ta\",\n  \"W\",\n  \"Re\",\n  \"Os\",\n  \"Ir\",\n  \"Pt\",\n  \"Au\",\n  \"Hg\",\n  \"Tl\",\n  \"Pb\",\n  \"Bi\",\n  \"Po\",\n  \"At\",\n  \"Rn\",\n  \"Fr\",\n  \"Ra\",\n  \"Ac\",\n  \"Th\",\n  \"Pa\",\n  \"U\",\n  \"Np\",\n  \"Pu\",\n  \"Am\",\n  \"Cm\",\n  \"Bk\",\n  \"Cf\",\n  \"Es\",\n  \"Fm\",\n  \"Md\",\n  \"No\",\n  \"Lr\",\n  \"Rf\",\n  \"Db\",\n  \"Sg\",\n  \"Bh\",\n  \"Hs\",\n  \"Mt\",\n  \"Ds\",\n  \"Rg\",\n  \"Cn\",\n  \"Nh\",\n  \"Fl\",\n  \"Mc\",\n  \"Lv\",\n  \"Ts\",\n  \"Og\",\n];\n\nconst elementSet = new Set(elementSymbols.map((s) => s.toLowerCase()));\n\nexport function elementLookup(input: string): boolean {\n  return elementSet.has(input.toLowerCase());\n}\n","// SPDX-License-Identifier: MIT\n// Copyright © 2026 Paul Puhnaty\n\nimport * as types from \"./types\";\nimport { isLetter } from \"./helpers\";\nimport { elementLookup } from \"./elements\";\n\nenum FormatMarker {\n  Unmarked,\n  Start,\n  OneLetter,\n  TwoLetter,\n  OneOrTwoLetter,\n  Skip,\n  FirstHalf,\n}\n\n// The marker array and input string are offset by one\n// since the marker array contains a \"start\" symbol in\n// its first index. The SmartIndex will handle the conversion.\nclass SmartIndex {\n  private _index: number = 1;\n\n  get mark(): number {\n    return this._index;\n  }\n\n  get char(): number {\n    return this._index - 1;\n  }\n\n  set mark(i: number) {\n    this._index = i;\n  }\n\n  set char(i: number) {\n    this._index = i + 1;\n  }\n}\n\nexport function format(input: string, preferSingleSymbols: boolean): types.ResultSegment {\n  input = input.toLowerCase();\n\n  // Analyze the input string\n  const markers: FormatMarker[] = findFormatMarkers(input);\n\n  let firstMiss: number;\n\n  // \"firstMiss\" is guaranteed to be set by this next loop\n  // because the first value in \"markers\" is always FormatMarker.Start\n\n  for (let i = input.length; i >= 0; i--) {\n    if (markers[i] !== FormatMarker.Unmarked) {\n      firstMiss = i;\n      break;\n    }\n  }\n\n  // Apply formatting to the input string\n  const output = applyFormatMarkers(input, markers, preferSingleSymbols);\n\n  return new types.ResultSegment(output, firstMiss);\n}\n\nfunction findFormatMarkers(input: string): FormatMarker[] {\n  const markers: FormatMarker[] = new Array(input.length + 1).fill(FormatMarker.Unmarked);\n  markers[0] = FormatMarker.Start;\n\n  const i = new SmartIndex();\n\n  for (i.char = 0; i.char < input.length; i.char++) {\n    // Check the previous marker; skip if this letter is not reachable\n    if (markers[i.mark - 1] === FormatMarker.Unmarked) continue;\n    if (markers[i.mark - 1] === FormatMarker.FirstHalf) continue;\n\n    // Skip non-letters\n    if (!isLetter(input[i.char])) {\n      markers[i.mark] = FormatMarker.Skip;\n      continue;\n    }\n\n    // Check for single letter symbol\n    if (elementLookup(input[i.char])) {\n      if (markers[i.mark] === FormatMarker.TwoLetter) {\n        markers[i.mark] = FormatMarker.OneOrTwoLetter;\n      } else {\n        markers[i.mark] = FormatMarker.OneLetter;\n      }\n    }\n\n    // Check for two letter symbol\n    let offset = 1;\n    while (i.char + offset < input.length) {\n      // Skip if this is not a letter\n      if (!isLetter(input[i.char + offset])) {\n        offset += 1;\n        continue;\n      }\n\n      const digram = input[i.char] + input[i.char + offset];\n\n      if (elementLookup(digram)) {\n        markers[i.mark + offset] = FormatMarker.TwoLetter;\n\n        // Mark the current letter if it isn't marked\n        // already, so it can be found when formatting.\n        if (markers[i.mark] === FormatMarker.Unmarked) {\n          markers[i.mark] = FormatMarker.FirstHalf;\n        }\n      }\n\n      break;\n    }\n  }\n\n  return markers;\n}\n\nfunction applyFormatMarkers(\n  input: string,\n  markers: FormatMarker[],\n  preferSingleSymbols: boolean,\n): string {\n  const array = input.split(\"\");\n\n  const i = new SmartIndex();\n\n  i.mark = input.length;\n\n  while (i.mark > 0) {\n    if (markers[i.mark] === FormatMarker.Unmarked || markers[i.mark] === FormatMarker.Skip) {\n      i.mark -= 1;\n      continue;\n    }\n\n    // Choose between OneLetter or TwoLetter\n    if (markers[i.mark] === FormatMarker.OneOrTwoLetter) {\n      if (preferSingleSymbols) {\n        markers[i.mark] = FormatMarker.OneLetter;\n      } else {\n        markers[i.mark] = FormatMarker.TwoLetter;\n      }\n    }\n\n    // Case OneLetter\n    if (markers[i.mark] === FormatMarker.OneLetter) {\n      array[i.char] = array[i.char].toUpperCase();\n    }\n    // Case TwoLetter\n    else if (markers[i.mark] === FormatMarker.TwoLetter) {\n      let offset = 1;\n      while (\n        markers[i.mark - offset] === FormatMarker.Skip ||\n        markers[i.mark - offset] === FormatMarker.Unmarked\n      ) {\n        offset += 1;\n      }\n      array[i.char - offset] = array[i.char - offset].toUpperCase();\n      i.mark -= offset;\n    }\n\n    i.mark -= 1;\n  }\n\n  return array.join(\"\");\n}\n","// SPDX-License-Identifier: MIT\n// Copyright © 2026 Paul Puhnaty\n\nexport * from \"./interfaces\";\nexport * from \"./api\";\n\nimport * as interfaces from \"./interfaces\";\nimport * as api from \"./api\";\n\nexport default {\n  ...interfaces,\n  ...api,\n};\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "element-symbol-format",
+  "version": "1.0.0",
+  "license": "MIT",
+  "author": "Paul Puhnaty",
+  "description": "Format text as chemical element symbols",
+  "keywords": [
+    "periodic",
+    "table",
+    "element",
+    "symbol",
+    "format",
+    "string",
+    "capitalize"
+  ],
+  "homepage": "https://github.com/happysnail2357/element-symbol-format#readme",
+  "bugs": {
+    "url": "https://github.com/happysnail2357/element-symbol-format/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/happysnail2357/element-symbol-format.git"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      }
+    }
+  },
+  "scripts": {
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier . --check",
+    "format:write": "prettier . --write",
+    "build": "tsup",
+    "prebuild": "npm run lint",
+    "test": "jest --verbose"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "eslint": "^10.0.2",
+    "eslint-config-prettier": "^10.1.8",
+    "prettier": "^3.8.1",
+    "ts-jest": "^29.4.6",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.56.1"
+  }
+}