@mmstack/primitives 20.13.2 → 20.13.4

package/fesm2022/mmstack-primitives.mjs

@@ -2010,6 +2010,29 @@ function indexArray(source, map, opt = {}) {
  */
 const mapArray = indexArray;
 
+function effectiveKeys(arr, getKey, report) {
+    const out = new Array(arr.length);
+    const counts = new Map();
+    const firstOrder = [];
+    let duped = null;
+    for (let i = 0; i < arr.length; i++) {
+        const base = String(getKey(arr[i]));
+        const seen = counts.get(base) ?? 0;
+        if (seen === 0) {
+            firstOrder.push(base);
+        }
+        else {
+            (duped ??= new Set()).add(base);
+        }
+        out[i] = seen === 0 ? base : base + '#' + seen;
+        counts.set(base, seen + 1);
+    }
+    if (report && duped) {
+        const bases = firstOrder.filter((b) => duped.has(b));
+        untracked(() => report(bases));
+    }
+    return out;
+}
 /**
  * Reactively maps items from a source array to a new array by value (identity).
  *
@@ -2023,11 +2046,15 @@ const mapArray = indexArray;
  * when the list is reordered.
  *
  * @param source A `Signal<T[]>` or a function returning `T[]`.
- * @param mapFn The mapping function. Receives the item and its index as a Signal.
+ * @param mapFn The mapping function. Receives the item, its index as a Signal, and the
+ *   entry's key (the effective ordinal key when `duplicateKeys` is enabled, otherwise
+ *   the raw key) — stable for the lifetime of the mapped entry.
  * @param options Optional configuration:
  *  - `onDestroy`: A callback invoked when a mapped item is removed from the array.
  *  - `key`: A custom key extractor for identity matching (e.g. `(item) => item.id`)
  *    when item references change but conceptual identity is preserved.
+ *  - `duplicateKeys`: Opt-in policy for handling duplicate keys. When omitted,
+ *    behavior is unchanged (duplicates collapse). See {@link DuplicateKeyPolicy}.
  * @returns A `Signal<U[]>` containing the mapped array.
  *
  * @example
@@ -2062,9 +2089,11 @@ function keyArray(source, mapFn, options = {}) {
     const tempIndexes = [];
     const newIndicesNext = [];
     const newIndexesCache = new Array();
+    const dup = options.duplicateKeys;
     return computed(() => {
         const newItems = sourceSignal() || [];
         return untracked(() => {
+            const newKeys = dup ? effectiveKeys(newItems, getKey, dup.report) : null;
             let i;
             let j;
             const newLen = newItems.length;
@@ -2096,7 +2125,7 @@ function keyArray(source, mapFn, options = {}) {
                     items[j] = item;
                     const indexSignal = signal(j, ...(ngDevMode ? [{ debugName: "indexSignal" }] : []));
                     newIndexes[j] = indexSignal;
-                    newMapped[j] = mapFn(item, indexSignal);
+                    newMapped[j] = mapFn(item, indexSignal, newKeys ? newKeys[j] : getKey(item));
                 }
             }
             else {
@@ -2104,27 +2133,30 @@ function keyArray(source, mapFn, options = {}) {
                 temp.length = 0;
                 tempIndexes.length = 0;
                 newIndicesNext.length = 0;
-                for (start = 0, end = Math.min(len, newLen); start < end && getKey(items[start]) === getKey(newItems[start]); start++) {
+                const oldKeys = dup ? effectiveKeys(items, getKey) : null;
+                const kNew = newKeys
+                    ? (idx) => newKeys[idx]
+                    : (idx) => getKey(newItems[idx]);
+                const kOld = oldKeys
+                    ? (idx) => oldKeys[idx]
+                    : (idx) => getKey(items[idx]);
+                for (start = 0, end = Math.min(len, newLen); start < end && kOld(start) === kNew(start); start++) {
                     newMapped[start] = mapped[start];
                     newIndexes[start] = indexes[start];
                 }
-                for (end = len - 1, newEnd = newLen - 1; end >= start &&
-                    newEnd >= start &&
-                    getKey(items[end]) === getKey(newItems[newEnd]); end--, newEnd--) {
+                for (end = len - 1, newEnd = newLen - 1; end >= start && newEnd >= start && kOld(end) === kNew(newEnd); end--, newEnd--) {
                     temp[newEnd] = mapped[end];
                     tempIndexes[newEnd] = indexes[end];
                 }
                 for (j = newEnd; j >= start; j--) {
-                    item = newItems[j];
-                    key = getKey(item);
-                    i = newIndices.get(key);
+                    key = kNew(j);
+                    i = newIndices.get(key) ?? -1;
                     newIndicesNext[j] = i === undefined ? -1 : i;
                     newIndices.set(key, j);
                 }
                 for (i = start; i <= end; i++) {
-                    item = items[i];
-                    key = getKey(item);
-                    j = newIndices.get(key);
+                    key = kOld(i);
+                    j = newIndices.get(key) ?? -1;
                     if (j !== undefined && j !== -1) {
                         temp[j] = mapped[i];
                         tempIndexes[j] = indexes[i];
@@ -2146,7 +2178,7 @@ function keyArray(source, mapFn, options = {}) {
                     else {
                         const indexSignal = signal(j, ...(ngDevMode ? [{ debugName: "indexSignal" }] : []));
                         newIndexes[j] = indexSignal;
-                        newMapped[j] = mapFn(newItems[j], indexSignal);
+                        newMapped[j] = mapFn(newItems[j], indexSignal, kNew(j));
                     }
                 }
                 items.length = newLen;