[items] Add support for providing Items, metadata & channel links from file-based scripts

[florian-h05]

No description provided.

[Copilot]

Pull Request Overview

This PR extends script-based item management by enabling file-based scripts to provide Items, metadata, and channel links with optional persistence.
Key changes:

• Introduces an environment module to detect file- vs UI-based execution and conditionally use provider registries.
• Enhances addItem (and related metadata functions) to accept a persist flag and wire up metadata & channel links.
• Adds a new flat items.itemChannelLink API and deprecates the old items.metadata.itemchannellink namespace.

Reviewed Changes

Copilot reviewed 9 out of 26 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
src/environment.js	New environment utilities to detect script context
src/items/metadata.js	Added addMetadata API with persistence support
src/items/itemchannellink.js	New items.itemChannelLink module exposing channel-link methods
src/items/items.js	Updated addItem to include persist, metadata & channel linking
src/index.js	Exposed environment in top‐level API
README.md	Documentation for new persistence options
CHANGELOG.md	Unreleased entries for environment and items enhancements

Comments suppressed due to low confidence (3)

src/environment.js:18

• Add unit tests for isFileBasedScript (and useProviderRegistries) to verify detection of file-based vs UI-based contexts.

function isFileBasedScript () {

src/items/metadata.js:133

• Consider adding tests for addMetadata to cover both successful additions and the duplicate‐metadata error path.

function addMetadata (itemOrName, namespace, value, configuration, persist = false) {

src/items/itemchannellink.js:98

• The addItemChannelLink and replaceItemChannelLink methods have different parameter lists (persist only on the former); consider unifying their signatures for consistency.

function addItemChannelLink (itemOrName, channelUID, configuration, persist = false) {