From b788db61db2e6c7a96f7a7a62872c6139a337ce7 Mon Sep 17 00:00:00 2001 From: Artur Arseniev Date: Mon, 6 Apr 2026 16:48:49 +0400 Subject: [PATCH] Up JSDoc --- packages/core/src/data_sources/config/config.ts | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/packages/core/src/data_sources/config/config.ts b/packages/core/src/data_sources/config/config.ts index 0825bf6b3..f6f38c792 100644 --- a/packages/core/src/data_sources/config/config.ts +++ b/packages/core/src/data_sources/config/config.ts @@ -8,7 +8,21 @@ export interface DataSourcesConfig { autoloadProviders?: boolean; /** - * Controls how parsed static HTML/CSS updates interact with existing data source bindings. + * Controls how parsed HTML/CSS string imports interact with existing data-bound + * component properties, attributes, and styles. + * + * This applies when a string import tries to write a static value over an existing + * data binding, for example via `components().resetFromString(...)` or + * `Css.addCollection('...')`. + * + * Available options: + * - `'overwrite'`: replace the existing binding with the imported static value. + * - `'skip'`: ignore the imported static value and keep the current binding. + * - `'update'`: write the imported static value into the bound data source and keep the binding. + * - `(context) => action`: decide per imported key based on the binding context. + * + * This value acts as the global default and can be overridden per import call with + * the `dataBindingImportPolicy` option. * @default 'overwrite' */ dataBindingImportPolicy?: DataBindingImportPolicy;