Could the bootstrap documentation be wrong in its explanation in this section "Remove from Map"?

[RockyMdee32]

I have been reading the bootstrap documentation, so I have arrived in this section Remove from Map

It says To remove colors from $theme-colors, or any other map, use map-remove. Be aware you must insert $theme-colors between our requirements just after its definition in variables and before its usage in maps:

and then provides this code

// Required
@import "../node_modules/bootstrap/scss/functions";
@import "../node_modules/bootstrap/scss/variables";
@import "../node_modules/bootstrap/scss/variables-dark";

$theme-colors: map-remove($theme-colors, "info", "light", "dark");

@import "../node_modules/bootstrap/scss/maps";
@import "../node_modules/bootstrap/scss/mixins";
@import "../node_modules/bootstrap/scss/root";

// Optional
@import "../node_modules/bootstrap/scss/reboot";
@import "../node_modules/bootstrap/scss/type";
// etc

but remember bootstrap's $theme-colors map is defined with the !default flag.

This means the value is only assigned if the variable isn't already defined. This means that from the above code provided in the bootstrap documenation by the time the map-remove() line is executed, $theme-colors is already defined. Therefore the !default flag prevents the map-remove() from having any effect because the variable already has a value.

I have been chatting with Gemini 1.5 Pro and it says to remove keys from a map with !default, you must define your modified map before importing the file that contains the !default definition. Here's the correct way to remove "info", "light", and "dark" from $theme-colors:

// Your custom.scss
$theme-colors: (
  "primary": map-get($theme-colors, "primary"), // Keep "primary"
  "secondary": map-get($theme-colors, "secondary"), // Keep "secondary"
  // ... other colors you want to keep
); // "info", "light", and "dark" are now excluded


// Required
@import "../node_modules/bootstrap/scss/functions";
@import "../node_modules/bootstrap/scss/variables"; // Bootstrap's variables are imported *after* your custom definition
@import "../node_modules/bootstrap/scss/variables-dark";
// ... rest of your imports

Gemini 1.5 Pro also says if the map you're trying to modify was originally defined with the !default flag (as is common in Bootstrap), you can't directly modify it using map-remove(). You'll need to create a new map with the desired key-value pairs.

Could there be an error in the bootstrap documentation, or is it possible that I am misunderstanding this section?