✨ Add title oparating functions

Author: takker99

deps/testing.ts

@@ -0,0 +1 @@
+export * from "https://deno.land/[email protected]/testing/asserts.ts";

title.test.ts

@@ -0,0 +1,39 @@
+import { encodeTitleURI, revertTitleLc, toTitleLc } from "./title.ts";
+import { assertStrictEquals } from "./deps/testing.ts";
+
+Deno.test("toTitleLc()", async (t) => {
+  await t.step("` ` -> `_`", () => {
+    assertStrictEquals<string>(toTitleLc("空白入り タイトル"), "空白入り_タイトル");
+    assertStrictEquals<string>(
+      toTitleLc(" 前後にも 空白入り _タイトル "),
+      "_前後にも_空白入り__タイトル_",
+    );
+  });
+
+  await t.step("upper -> lower", () => {
+    assertStrictEquals<string>(toTitleLc("Scrapbox-Gyazo"), "scrapbox-gyazo");
+    assertStrictEquals<string>(
+      toTitleLc("全角アルファベット「Ｓｃｒａｐｂｏｘ」も変換できる"),
+      "全角アルファベット「ｓｃｒａｐｂｏｘ」も変換できる",
+    );
+  });
+  await t.step("UPPER Case -> lower_case", () => {
+    assertStrictEquals<string>(
+      toTitleLc("Scrapbox is one of the products powered by Nota inc."),
+      "scrapbox_is_one_of_the_products_powered_by_nota_inc.",
+    );
+  });
+});
+
+Deno.test("revertTitleLc()", () => {
+  assertStrictEquals<string>(
+    revertTitleLc("Title_with underscore"),
+    "Title with underscore",
+  );
+});
+
+Deno.test("encodeTitleURI()", async (t) => {
+  await t.step("tail symbol", () => {
+    assertStrictEquals<string>(encodeTitleURI(":title:"), ":title%3A");
+  });
+});

title.ts

@@ -0,0 +1,42 @@
+/** 文字列をtitleLc形式に変換する
+ *
+ * - ` ` -> `_`
+ *
+ * - 大文字 -> 小文字
+ *
+ * リンクの等値比較をする際に主に使われる
+ *
+ * @param text 変換する文字列
+ * @return 変換後の文字列
+ */
+export const toTitleLc = (text: string): string =>
+  text.replaceAll(" ", "_").toLowerCase();
+
+/** `_`を半角スペースに変換する
+ *
+ * @param text 変換する文字列
+ * @return 変換後の文字列
+ */
+export const revertTitleLc = (text: string): string =>
+  text.replaceAll("_", " ");
+
+/** titleをURIで使える形式にEncodeする
+ *
+ * @param title 変換するtitle
+ * @return 変換後の文字列
+ */
+export const encodeTitleURI = (title: string): string => {
+  return [...title].map((char, index) => {
+    if (char === " ") return "_";
+    if (
+      !noEncodeChars.includes(char) ||
+      (index === title.length - 1 && noTailChars.includes(char))
+    ) {
+      return encodeURIComponent(char);
+    }
+    return char;
+  }).join("");
+};
+
+const noEncodeChars = '@$&+=:;",';
+const noTailChars = ':;",';