Up JSDoc

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;