feat!: rename getInstanceId to getNodeId and add a scope option

[bowheart]

@affects atoms, stores

Description

With the introduction of scoped atoms came the concept of scoped ids. These @scope()-suffixed ids can currently only be generated automatically by Zedux internals.

Expose a way to create scoped ids via the existing getInstanceId method on AtomTemplateBase. Pass an optional third object parameter with a scope map pointing contexts to their contextual values that should be added to the id. Also rename getInstanceId to getNodeId to match the new nomenclature.

import { atom, createEcosystem } from '@zedux/react'

const ecosystem = createEcosystem()
const contextAtom = atom('context', 'example state')

const scopedAtom = atom('scoped', () => {
  inject(contextAtom)
})

const scope = new Map([
  [contextAtom, ecosystem.getNode(contextAtom)]
])

const id = scopedAtom.getNodeId(ecosystem, [], { scope })

id // 'scoped-@scope("context")'

Breaking Changes

The AtomTemplateBase class is the last thing that needs some love for Zedux v2. Rename:

• getInstanceId -> getNodeId
• _createInstance -> _instantiate
• _config -> c (short for config)
• _value -> v (short for valueOrFactory)