chore: preview docs import attribute fix for node 22 (#5805)

* chore: preview docs import attribute fix for node 22

* chore: update node to v 20.10.0 to support next gen import attributes

---------

Co-authored-by: Rajdeep Chandra <[email protected]>
Co-authored-by: Rúben Carvalho <[email protected]>

Author: 3 people

package.json

@@ -217,7 +217,7 @@
         "lit-html"
     ],
     "engines": {
-        "node": ">=20",
+        "node": ">=20.10.0",
         "yarn": ">=4.6.0"
     },
     "wireit": {

projects/documentation/.eleventy.js

@@ -19,15 +19,15 @@ const packageVersion = async function (packageName) {
         packageJSON = await import(
             `../../packages/${packageName}/package.json`,
             {
-                assert: { type: 'json' },
+                with: { type: 'json' },
             }
         ).then((packageDefault) => packageDefault.default);
     } catch (e) {
         try {
             packageJSON = await import(
                 `../../tools/${packageName}/package.json`,
                 {
-                    assert: { type: 'json' },
+                    with: { type: 'json' },
                 }
             ).then((packageDefault) => packageDefault.default);
         } catch (e) {}

projects/documentation/scripts/copy-component-docs.js

@@ -63,8 +63,11 @@ const findDeprecationNotice = async function (filePath) {
     for await (const mdPath of globby.stream(filePath)) {
         const hasDeprecation = fs.existsSync(mdPath);
         if (hasDeprecation) {
+            // Using 'with' syntax for import attributes (required in Node.js 20.10+).
+            // The 'assert' keyword was deprecated and replaced with 'with' per TC39 proposal.
+            // See: https://github.com/tc39/proposal-import-attributes
             const packageJSON = await import(mdPath, {
-                assert: { type: 'json' },
+                with: { type: 'json' },
             }).then((packageDefault) => packageDefault.default);
             return packageJSON.deprecationNotice;
         }

test/benchmark/cli.ts

@@ -235,7 +235,7 @@ $ node test/benchmark/cli -n 20
                     'package.json'
                 ),
                 {
-                    assert: { type: 'json' },
+                    with: { type: 'json' },
                 }
             );
             if (pjson.version === '0.0.1' && opts.compare !== 'none') {
@@ -245,7 +245,9 @@ $ node test/benchmark/cli -n 20
                 );
                 return;
             }
-            if (!config.benchmarks) return;
+            if (!config.benchmarks) {
+                return;
+            }
             if (opts.compare !== 'none') {
                 config.benchmarks.push({
                     name: `${packageName}:${benchmark}`,