replaceOrAppend

Replace item in array or append if no match
Usage

Given an array of items, an item and an identity function, returns a new array with the item either replaced at the index of the existing item — if it exists, else it is appended at the end.
import * as 
import _
_ from 'radashi'

const 
const fish: {
    name: string;
    weight: number;
}[]
fish = [
  {
    
name: string
name: 'Marlin',
    
weight: number
weight: 105,
  },
  {
    
name: string
name: 'Salmon',
    
weight: number
weight: 19,
  },
  {
    
name: string
name: 'Trout',
    
weight: number
weight: 13,
  },
]

const 
const salmon: {
    name: string;
    weight: number;
}
salmon = {
  
name: string
name: 'Salmon',
  
weight: number
weight: 22,
}

const 
const sockeye: {
    name: string;
    weight: number;
}
sockeye = {
  
name: string
name: 'Sockeye',
  
weight: number
weight: 8,
}

import _
_.
replaceOrAppend<{
    name: string;
    weight: number;
}>(array: readonly {
    name: string;
    weight: number;
}[], newItem: {
    name: string;
    weight: number;
}, match: (a: {
    name: string;
    weight: number;
}, idx: number) => boolean): {
    name: string;
    weight: number;
}[]
export replaceOrAppend
Replace the first occurrence of an item in an array where the
match function returns true. If no items match, append the new
item to the end of the list.
@see ― https://radashi.js.org/reference/array/replaceOrAppend
@example 
replaceOrAppend([1, 2, 3], 4, (n) => n > 1)
// [1, 4, 3]

replaceOrAppend([1, 2, 3], 4, (n) => n > 100)
// [1, 2, 3, 4]
@version ― 12.1.0
replaceOrAppend(
const fish: {
    name: string;
    weight: number;
}[]
fish, 
const salmon: {
    name: string;
    weight: number;
}
salmon, 
f: {
    name: string;
    weight: number;
}
f => 
f: {
    name: string;
    weight: number;
}
f.
name: string
name === 'Salmon') // => [marlin, salmon (weight:22), trout]
import _
_.
replaceOrAppend<{
    name: string;
    weight: number;
}>(array: readonly {
    name: string;
    weight: number;
}[], newItem: {
    name: string;
    weight: number;
}, match: (a: {
    name: string;
    weight: number;
}, idx: number) => boolean): {
    name: string;
    weight: number;
}[]
export replaceOrAppend
Replace the first occurrence of an item in an array where the
match function returns true. If no items match, append the new
item to the end of the list.
@see ― https://radashi.js.org/reference/array/replaceOrAppend
@example 
replaceOrAppend([1, 2, 3], 4, (n) => n > 1)
// [1, 4, 3]

replaceOrAppend([1, 2, 3], 4, (n) => n > 100)
// [1, 2, 3, 4]
@version ― 12.1.0
replaceOrAppend(
const fish: {
    name: string;
    weight: number;
}[]
fish, 
const sockeye: {
    name: string;
    weight: number;
}
sockeye, 
f: {
    name: string;
    weight: number;
}
f => 
f: {
    name: string;
    weight: number;
}
f.
name: string
name === 'Sockeye') // => [marlin, salmon, trout, sockeye]