Fix handling for true values and add CHANGELOG

Author: luin

CHANGELOG.md

@@ -1,5 +1,7 @@
 # [Unreleased]
 
+- Prevent overriding of theme's default toolbar settings mistakenly [#4120](https://github.com/quilljs/quill/pull/4120)
+
 # 2.0.0
 
 We are thrilled to announce the release of Quill 2.0! Please check out the [announcement post](https://slab.com/blog/announcing-quill-2-0/).

packages/quill/src/core/quill.ts

@@ -766,7 +766,7 @@ function expandModuleConfig(config: Record<string, unknown> | undefined) {
       ...expanded,
       [key]: value === true ? {} : value,
     }),
-    {},
+    {} as Record<string, unknown>,
   );
 }
 
@@ -784,55 +784,53 @@ function expandConfig(
   if (!container) {
     throw new Error('Invalid Quill container');
   }
-  
-  const userOptions={...options};
 
   const shouldUseDefaultTheme =
-    !userOptions.theme || userOptions.theme === Quill.DEFAULTS.theme;
+    !options.theme || options.theme === Quill.DEFAULTS.theme;
   const theme = shouldUseDefaultTheme
     ? Theme
-    : Quill.import(`themes/${userOptions.theme}`);
+    : Quill.import(`themes/${options.theme}`);
   if (!theme) {
-    throw new Error(`Invalid theme ${userOptions.theme}. Did you register it?`);
+    throw new Error(`Invalid theme ${options.theme}. Did you register it?`);
   }
 
   const { modules: quillModuleDefaults, ...quillDefaults } = Quill.DEFAULTS;
   const { modules: themeModuleDefaults, ...themeDefaults } = theme.DEFAULTS;
 
+  let userModuleOptions = expandModuleConfig(options.modules);
   // Special case toolbar shorthand
-  
   if (
-    userOptions.modules != null &&
-    userOptions.modules.toolbar &&
-    userOptions.modules.toolbar.constructor !== Object
+    userModuleOptions != null &&
+    userModuleOptions.toolbar &&
+    userModuleOptions.toolbar.constructor !== Object
   ) {
-    userOptions.modules.toolbar = {
-      container: userOptions.modules.toolbar
+    userModuleOptions = {
+      ...userModuleOptions,
+      toolbar: { container: userModuleOptions.toolbar },
     };
   }
 
   const modules: ExpandedQuillOptions['modules'] = merge(
     {},
     expandModuleConfig(quillModuleDefaults),
     expandModuleConfig(themeModuleDefaults),
-    expandModuleConfig(userOptions.modules),
+    userModuleOptions,
   );
 
-
   const config = {
     ...quillDefaults,
     ...omitUndefinedValuesFromOptions(themeDefaults),
-    ...omitUndefinedValuesFromOptions(userOptions),
+    ...omitUndefinedValuesFromOptions(options),
   };
 
-  let registry = userOptions.registry;
+  let registry = options.registry;
   if (registry) {
-    if (userOptions.formats) {
+    if (options.formats) {
       debug.warn('Ignoring "formats" option because "registry" is specified');
     }
   } else {
-    registry = userOptions.formats
-      ? createRegistryWithFormats(userOptions.formats, config.registry, debug)
+    registry = options.formats
+      ? createRegistryWithFormats(options.formats, config.registry, debug)
       : config.registry;
   }
 

packages/quill/test/unit/core/quill.spec.ts

@@ -764,6 +764,22 @@ describe('Quill', () => {
       });
     });
 
+    test('toolbar container shorthand with theme options', () => {
+      const config = expandConfig(`#${testContainerId}`, {
+        modules: {
+          toolbar: document.querySelector(`#${testContainerId}`),
+        },
+        theme: 'snow',
+      });
+      for (const [format, handler] of Object.entries(
+        Snow.DEFAULTS.modules.toolbar!.handlers ?? {},
+      )) {
+        console.log('===format', format);
+        // @ts-expect-error
+        expect(config.modules.toolbar.handlers[format]).toBe(handler);
+      }
+    });
+
     test('toolbar format array', () => {
       const config = expandConfig(`#${testContainerId}`, {
         modules: {