@burger-editor/utils 4.0.0-alpha.16 → 4.0.0-alpha.18

package/dist/index.d.ts

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

package/dist/index.js

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

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/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@burger-editor/utils",
-	"version": "4.0.0-alpha.16",
+	"version": "4.0.0-alpha.18",
 	"description": "BurgerEditor Editor Utility Functions",
 	"author": "D-ZERO",
 	"license": "(MIT OR Apache-2.0)",
@@ -26,12 +26,12 @@
 		"clean": "tsc --build --clean"
 	},
 	"dependencies": {
-		"dayjs": "1.11.13",
-		"marked": "16.2.0",
+		"dayjs": "1.11.18",
+		"marked": "16.2.1",
 		"turndown": "7.2.1"
 	},
 	"devDependencies": {
 		"@types/turndown": "5.0.5"
 	},
-	"gitHead": "d1e588ffde9fe0d69e3af6388b9ba4e627deb064"
+	"gitHead": "18fc101a19243250f7c9381c93e6d65d1f7a9fe1"
 }