[heft-config-file] Let null reset properties (#5195)

* [heft-config-file] Let null reset properties

* Update extends documentation

* fix change files

---------

Co-authored-by: David Michon <[email protected]>

Author: dmichon-msft

apps/api-extractor/config/heft.json

@@ -7,6 +7,8 @@
   /**
    * Optionally specifies another JSON config file that this file extends from. This provides a way for standard
    * settings to be shared across multiple projects.
+   *
+   * To delete an inherited setting, set it to `null` in this file.
    */
   "extends": "decoupled-local-node-rig/profiles/default/config/heft.json",
 

apps/heft/src/schemas/heft-legacy.schema.json

@@ -20,7 +20,7 @@
     },
 
     "extends": {
-      "description": "Optionally specifies another JSON config file that this file extends from.  This provides a way for standard settings to be shared across multiple projects.",
+      "description": "Optionally specifies another JSON config file that this file extends from.  This provides a way for standard settings to be shared across multiple projects. To delete an inherited setting, set it to `null` in this file.",
       "type": "string"
     },
 

apps/heft/src/schemas/heft.schema.json

@@ -104,7 +104,7 @@
     },
 
     "extends": {
-      "description": "Optionally specifies another JSON config file that this file extends from.  This provides a way for standard settings to be shared across multiple projects.",
+      "description": "Optionally specifies another JSON config file that this file extends from.  This provides a way for standard settings to be shared across multiple projects. To delete an inherited setting, set it to `null` in this file.",
       "type": "string"
     },
 

apps/heft/src/schemas/node-service.schema.json

@@ -13,7 +13,7 @@
     },
 
     "extends": {
-      "description": "Optionally specifies another JSON config file that this file extends from.  This provides a way for standard settings to be shared across multiple projects.",
+      "description": "Optionally specifies another JSON config file that this file extends from.  This provides a way for standard settings to be shared across multiple projects. To delete an inherited setting, set it to `null` in this file.",
       "type": "string"
     },
 

apps/heft/src/schemas/templates/heft.json

@@ -7,6 +7,8 @@
   /**
    * Optionally specifies another JSON config file that this file extends from. This provides a way for standard
    * settings to be shared across multiple projects.
+   *
+   * To delete an inherited setting, set it to `null` in this file.
    */
   // "extends": "base-project/config/heft.json",
 

apps/lockfile-explorer-web/config/heft.json

@@ -7,6 +7,8 @@
   /**
    * Optionally specifies another JSON config file that this file extends from. This provides a way for standard
    * settings to be shared across multiple projects.
+   *
+   * To delete an inherited setting, set it to `null` in this file.
    */
   "extends": "local-web-rig/profiles/app/config/heft.json",
 

apps/lockfile-explorer/config/heft.json

@@ -7,6 +7,8 @@
   /**
    * Optionally specifies another JSON config file that this file extends from. This provides a way for standard
    * settings to be shared across multiple projects.
+   *
+   * To delete an inherited setting, set it to `null` in this file.
    */
   "extends": "local-node-rig/profiles/default/config/heft.json",
 

apps/lockfile-explorer/config/node-service.json

@@ -8,6 +8,8 @@
   /**
    * Optionally specifies another JSON config file that this file extends from. This provides a way for standard
    * settings to be shared across multiple projects.
+   *
+   * To delete an inherited setting, set it to `null` in this file.
    */
   // "extends": "base-project/config/serve-command.json",
 

build-tests-samples/heft-web-rig-library-tutorial/config/api-extractor.json

@@ -8,6 +8,8 @@
    * Optionally specifies another JSON config file that this file extends from.  This provides a way for
    * standard settings to be shared across multiple projects.
    *
+   * To delete an inherited setting, set it to `null` in this file.
+   *
    * If the path starts with "./" or "../", the path is resolved relative to the folder of the file that contains
    * the "extends" field.  Otherwise, the first path segment is interpreted as an NPM package name, and will be
    * resolved using NodeJS require().

build-tests/heft-fastify-test/config/node-service.json

@@ -8,6 +8,8 @@
   /**
    * Optionally specifies another JSON config file that this file extends from. This provides a way for standard
    * settings to be shared across multiple projects.
+   *
+   * To delete an inherited setting, set it to `null` in this file.
    */
   // "extends": "base-project/config/serve-command.json",