#Signal Methods

TeamPlay signals come with a set of methods for interacting with the data they represent. These methods are available on all signals, whether they're created using $(), accessed through the root signal $, or returned by sub() or useSub().

#get()

Retrieves the current value of the signal.

const value = $signal.get()

#set(value)

Updates the value of the signal.

await $signal.set(newValue)

Note: set() is asynchronous and returns a Promise.

#del()

Deletes the value of the signal or removes an item from an array.

await $signal.del()

Note: del() is asynchronous and returns a Promise.

#push(value)

Adds a value to the end of an array signal.

await $signal.push(newItem)

#pop()

Removes and returns the last item from an array signal.

const lastItem = await $signal.pop()

#increment(value)

Increments a numeric signal by the specified value (or by 1 if no value is provided).

await $signal.increment(5)

#add(value)

Adds a new item to a collection signal, automatically generating a unique ID.

const newId = await $signal.add({ name: 'New Item' })

#assign(object)

Assigns multiple properties to a signal at once. This method iterates through the object's own properties and sets or deletes them on the signal.

// Set multiple properties at once (adds new properties if they don't exist)
await $user.assign({
  firstName: 'John',
  lastName: 'Smith',
  age: 30
})

// Update existing properties and add new ones, others remain unchanged
await $user.assign({
  age: 31,              // updates existing property
  email: 'john@example.com'  // adds new property
})

// Delete properties by assigning null or undefined
await $user.assign({
  middleName: null,     // deletes middleName
  nickname: undefined   // deletes nickname
})

Behavior:

• For non-null/undefined values: calls .set(value) on the child signal (adds property if it doesn't exist)
• For null/undefined values: calls .del() on the child signal
• Only assigns own properties (not inherited ones)
• Returns a Promise that resolves when all operations complete

#Notes

• All methods that modify data (set(), del(), push(), pop(), increment(), add(), assign()) are asynchronous and return Promises. This ensures data consistency with the server.
• The get() method is synchronous and returns the current local value of the signal.
• These methods can be chained on nested signals, e.g., $.users[userId].name.set('New Name').