@burger-editor/utils 4.0.0-alpha.4 → 4.0.0-alpha.43

package/dist/camel-case.d.ts

@@ -0,0 +1,5 @@
+/**
+ *
+ * @param str
+ */
+export declare function camelCase(str: string): string;

package/dist/camel-case.js

@@ -0,0 +1,13 @@
+const camelCaseCache = new Map();
+/**
+ *
+ * @param str
+ */
+export function camelCase(str) {
+    if (camelCaseCache.has(str)) {
+        return camelCaseCache.get(str);
+    }
+    const result = str.replaceAll(/-([a-z])/g, (_, c) => c.toUpperCase());
+    camelCaseCache.set(str, result);
+    return result;
+}

package/dist/index.d.ts

@@ -1,2 +1,7 @@
+export * from './camel-case.js';
+export * from './kebab-case.js';
 export * from './markdown.js';
+export * from './merge-items.js';
+export * from './normalize-html.js';
+export * from './replace-comment-with-html.js';
 export * from './utils.js';

package/dist/index.js

@@ -1,2 +1,7 @@
+export * from './camel-case.js';
+export * from './kebab-case.js';
 export * from './markdown.js';
+export * from './merge-items.js';
+export * from './normalize-html.js';
+export * from './replace-comment-with-html.js';
 export * from './utils.js';

package/dist/kebab-case.d.ts

@@ -0,0 +1,5 @@
+/**
+ *
+ * @param str
+ */
+export declare function kebabCase(str: string): string;

package/dist/kebab-case.js

@@ -0,0 +1,13 @@
+const kebabCaseCache = new Map();
+/**
+ *
+ * @param str
+ */
+export function kebabCase(str) {
+    if (kebabCaseCache.has(str)) {
+        return kebabCaseCache.get(str);
+    }
+    const result = str.replaceAll(/([A-Z])/g, '-$1').toLowerCase();
+    kebabCaseCache.set(str, result);
+    return result;
+}

package/dist/merge-items.d.ts

@@ -0,0 +1,35 @@
+/**
+ * マージ操作が可能な汎用型
+ * 任意のオブジェクト型にdeleteプロパティを追加する
+ */
+export type Mergeable<T extends Record<string, unknown>> = T & {
+    readonly delete?: boolean;
+};
+/**
+ * 汎用的なマージ関数
+ * 指定されたキーフィールドを基準にアイテムのマージを行う
+ * @param defaultItems デフォルトのアイテム配列
+ * @param mergeItems マージ設定配列
+ * @param keyField キーとなるフィールド名
+ * @param isValidForAdd 新規追加時のバリデーション関数
+ * @returns マージ後のアイテム配列
+ * @example
+ * ```typescript
+ * // SelectableValue型での使用例
+ * const result = mergeItems(
+ *   [{ value: 'a', label: 'A' }],
+ *   [{ value: 'b', label: 'B' }],
+ *   'value',
+ *   (item) => Boolean(item.label)
+ * );
+ *
+ * // 独自型での使用例
+ * interface User { id: string; name: string; }
+ * const users = mergeItems(
+ *   [{ id: '1', name: 'Alice' }],
+ *   [{ id: '2', name: 'Bob' }],
+ *   'id'
+ * );
+ * ```
+ */
+export declare function mergeItems<T extends Record<string, unknown>, K extends keyof T & string>(defaultItems: readonly T[], mergeItems: readonly Mergeable<Partial<T> & Pick<T, K>>[] | undefined, keyField: K, isValidForAdd?: (item: Mergeable<Partial<T> & Pick<T, K>>) => boolean): T[];

package/dist/merge-items.js

@@ -0,0 +1,57 @@
+/**
+ * 汎用的なマージ関数
+ * 指定されたキーフィールドを基準にアイテムのマージを行う
+ * @param defaultItems デフォルトのアイテム配列
+ * @param mergeItems マージ設定配列
+ * @param keyField キーとなるフィールド名
+ * @param isValidForAdd 新規追加時のバリデーション関数
+ * @returns マージ後のアイテム配列
+ * @example
+ * ```typescript
+ * // SelectableValue型での使用例
+ * const result = mergeItems(
+ *   [{ value: 'a', label: 'A' }],
+ *   [{ value: 'b', label: 'B' }],
+ *   'value',
+ *   (item) => Boolean(item.label)
+ * );
+ *
+ * // 独自型での使用例
+ * interface User { id: string; name: string; }
+ * const users = mergeItems(
+ *   [{ id: '1', name: 'Alice' }],
+ *   [{ id: '2', name: 'Bob' }],
+ *   'id'
+ * );
+ * ```
+ */
+export function mergeItems(defaultItems, mergeItems, keyField, isValidForAdd) {
+    // マージ設定がない場合はデフォルトをそのまま返す
+    if (!mergeItems) {
+        return [...defaultItems];
+    }
+    let result = [...defaultItems];
+    for (const mergeItem of mergeItems) {
+        if (mergeItem.delete) {
+            // 削除: キーが一致するものを除去
+            const keyValue = mergeItem[keyField];
+            result = result.filter((item) => item[keyField] !== keyValue);
+        }
+        else {
+            // 追加または更新
+            const keyValue = mergeItem[keyField];
+            const existingIndex = result.findIndex((item) => item[keyField] === keyValue);
+            if (existingIndex === -1) {
+                // 新規追加: バリデーション通過が必要
+                if (!isValidForAdd || isValidForAdd(mergeItem)) {
+                    result.push(mergeItem);
+                }
+            }
+            else {
+                // 既存の更新: マージする
+                result[existingIndex] = { ...result[existingIndex], ...mergeItem };
+            }
+        }
+    }
+    return result;
+}

package/dist/normalize-html.d.ts

@@ -0,0 +1,8 @@
+/**
+ * HTMLの構造を正規化して比較する
+ * 空白や属性順序の違いを無視し、タグ構造のみを比較する
+ * @param html1 比較対象のHTML文字列1
+ * @param html2 比較対象のHTML文字列2
+ * @returns 構造が同じ場合true、異なる場合false
+ */
+export declare function normalizeHtmlStructure(html1: string, html2: string): boolean;

package/dist/normalize-html.js

@@ -0,0 +1,109 @@
+/**
+ * HTMLの構造を正規化して比較する
+ * 空白や属性順序の違いを無視し、タグ構造のみを比較する
+ * @param html1 比較対象のHTML文字列1
+ * @param html2 比較対象のHTML文字列2
+ * @returns 構造が同じ場合true、異なる場合false
+ */
+export function normalizeHtmlStructure(html1, html2) {
+    const doc1 = new Range().createContextualFragment(html1);
+    const doc2 = new Range().createContextualFragment(html2);
+    return compareElements(doc1, doc2);
+}
+/**
+ * 2つの要素の構造を比較する
+ * @param el1 比較対象の要素1
+ * @param el2 比較対象の要素2
+ * @returns 構造が同じ場合true、異なる場合false
+ */
+function compareElements(el1, el2) {
+    // 子要素の数を取得（テキストノードは無視）
+    const children1 = [...el1.children];
+    const children2 = [...el2.children];
+    // 子要素の数が異なる場合は構造が異なる
+    if (children1.length !== children2.length) {
+        return false;
+    }
+    // 子要素がない場合（テキストのみまたは空要素）
+    if (children1.length === 0) {
+        // テキスト内容を正規化して比較
+        const text1 = normalizeText(el1.textContent ?? '');
+        const text2 = normalizeText(el2.textContent ?? '');
+        return text1 === text2;
+    }
+    // 各子要素を比較
+    for (const [i, child1] of children1.entries()) {
+        const child2 = children2[i];
+        if (!child1 || !child2 || !compareElementStructure(child1, child2)) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * 2つの要素の構造を詳細に比較する
+ * @param el1 比較対象の要素1
+ * @param el2 比較対象の要素2
+ * @returns 構造が同じ場合true、異なる場合false
+ */
+function compareElementStructure(el1, el2) {
+    // タグ名が異なる場合は構造が異なる
+    if (el1.tagName !== el2.tagName) {
+        return false;
+    }
+    // 属性を比較（順序は無視）
+    const attrs1 = getNormalizedAttributes(el1);
+    const attrs2 = getNormalizedAttributes(el2);
+    if (!compareAttributes(attrs1, attrs2)) {
+        return false;
+    }
+    // 子要素を再帰的に比較
+    return compareElements(el1, el2);
+}
+/**
+ * 要素の属性を正規化して取得する
+ * @param el 対象の要素
+ * @returns 属性名をキー、属性値を値とするオブジェクト
+ */
+function getNormalizedAttributes(el) {
+    const attrs = {};
+    for (const attr of el.attributes) {
+        attrs[attr.name] = attr.value;
+    }
+    return attrs;
+}
+/**
+ * 2つの属性オブジェクトを比較する
+ * @param attrs1 比較対象の属性1
+ * @param attrs2 比較対象の属性2
+ * @returns 属性が同じ場合true、異なる場合false
+ */
+function compareAttributes(attrs1, attrs2) {
+    const keys1 = Object.keys(attrs1).toSorted();
+    const keys2 = Object.keys(attrs2).toSorted();
+    // 属性名の数が異なる場合は異なる
+    if (keys1.length !== keys2.length) {
+        return false;
+    }
+    // 各属性を比較
+    for (const [i, key1] of keys1.entries()) {
+        const key2 = keys2[i];
+        // 属性名が異なる場合は異なる
+        if (key1 !== key2) {
+            return false;
+        }
+        // 属性値が異なる場合は異なる
+        if (attrs1[key1] !== attrs2[key2]) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * テキストを正規化する（空白文字を統一）
+ * @param text 対象のテキスト
+ * @returns 正規化されたテキスト
+ */
+function normalizeText(text) {
+    return text.replaceAll(/\s+/g, ' ').trim();
+}

package/dist/normalize-indent.d.ts

@@ -0,0 +1,8 @@
+/**
+ * HTMLの先頭行のインデントを検出し、全行から同じインデントを削除する
+ *
+ * CRLF (\r\n) と LF (\n) の両方に対応
+ * @param html - 正規化するHTML文字列
+ * @returns インデントが正規化され、前後の空白行が削除されたHTML文字列
+ */
+export declare function normalizeIndent(html: string): string;

package/dist/normalize-indent.js

@@ -0,0 +1,18 @@
+/**
+ * HTMLの先頭行のインデントを検出し、全行から同じインデントを削除する
+ *
+ * CRLF (\r\n) と LF (\n) の両方に対応
+ * @param html - 正規化するHTML文字列
+ * @returns インデントが正規化され、前後の空白行が削除されたHTML文字列
+ */
+export function normalizeIndent(html) {
+    // 先頭の改行を削除
+    const trimmedHtml = html.replace(/^(?:\r?\n)+/, '');
+    const lines = trimmedHtml.split(/\r?\n/);
+    const firstLineIndent = lines[0]?.match(/^\s+/)?.[0] ?? '';
+    if (firstLineIndent.length === 0) {
+        return trimmedHtml;
+    }
+    const normalizedLines = lines.map((line) => line.replace(firstLineIndent, ''));
+    return normalizedLines.join('\n');
+}

package/dist/replace-comment-with-html.d.ts

@@ -0,0 +1,9 @@
+/**
+ *
+ * @param html
+ * @param templateSeed
+ * @param dataConverter
+ */
+export declare function replaceCommentWithHTML<T extends string>(html: string, templateSeed: {
+    [key in T]: string;
+}, dataConverter?: (key: string, html: string, data: any) => string): string;

package/dist/replace-comment-with-html.js

@@ -0,0 +1,37 @@
+import { kebabCase } from './kebab-case.js';
+/**
+ *
+ * @param html
+ * @param templateSeed
+ * @param dataConverter
+ */
+export function replaceCommentWithHTML(html, templateSeed, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+dataConverter) {
+    let iteration = 0;
+    const replacements = new Map();
+    for (const [key, itemTemplate] of Object.entries(templateSeed)) {
+        const _key = kebabCase(key);
+        const placeholder = new RegExp(`<!-- ${_key}({[^}]*})? -->`, 'g');
+        html = html.replaceAll(placeholder, (_, attr) => {
+            const marker = `<!-- __MARKER__${iteration} -->`;
+            replacements.set(marker, [key, itemTemplate, attr]);
+            iteration++;
+            return marker;
+        });
+    }
+    html = html.replaceAll(/<!-- __MARKER__(\d+) -->/g, (_, iteration) => {
+        const replacement = replacements.get(`<!-- __MARKER__${iteration} -->`);
+        if (!replacement) {
+            return '';
+        }
+        const [key, itemTemplate, attr] = replacement;
+        let itemHtml = itemTemplate;
+        if (dataConverter) {
+            const data = attr ? JSON.parse(`${attr}`) : {};
+            itemHtml = dataConverter(key, itemTemplate, data);
+        }
+        return itemHtml;
+    });
+    return html;
+}

package/package.json

@@ -1,13 +1,12 @@
 {
 	"name": "@burger-editor/utils",
-	"version": "4.0.0-alpha.4",
+	"version": "4.0.0-alpha.43",
 	"description": "BurgerEditor Editor Utility Functions",
 	"author": "D-ZERO",
-	"license": "MIT",
+	"license": "(MIT OR Apache-2.0)",
 	"repository": {
 		"url": "https://github.com/d-zero-dev/BurgerEditor.git"
 	},
-	"private": false,
 	"publishConfig": {
 		"access": "public"
 	},
@@ -27,12 +26,12 @@
 		"clean": "tsc --build --clean"
 	},
 	"dependencies": {
-		"dayjs": "1.11.13",
-		"marked": "15.0.7",
-		"turndown": "7.2.0"
+		"dayjs": "1.11.19",
+		"marked": "17.0.1",
+		"turndown": "7.2.2"
 	},
 	"devDependencies": {
-		"@types/turndown": "5.0.5"
+		"@types/turndown": "5.0.6"
 	},
-	"gitHead": "823486d58579275ae556942c5d7a4aef4e1f634e"
+	"gitHead": "3293443ba2bf45b1c80d8b424f16b77cefe65cf1"
 }

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2017-2024 D-ZERO Co., Ltd.
-
-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.