feat(beta): add BasicTable beta component (src/beta/basic-table-0.1)

build-tools/tasks/docs.js

@@ -1,20 +1,65 @@
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
+const fs = require('fs');
 const path = require('path');
 const { writeComponentsDocumentation, writeTestUtilsDocumentation } = require('@cloudscape-design/documenter');
 const workspace = require('../utils/workspace');
 
+// Dash-case names of the versioned beta components — the dirs matching the beta documenter glob
+// (src/beta/<name>-<major.minor>/<component>/index.tsx). Used to flag their generated definitions.
+function getBetaComponentNames(srcDir = 'src') {
+  const betaRoot = path.join(srcDir, 'beta');
+  if (!fs.existsSync(betaRoot)) {
+    return [];
+  }
+  const names = [];
+  for (const versionDir of fs.readdirSync(betaRoot)) {
+    const versionPath = path.join(betaRoot, versionDir);
+    if (!fs.statSync(versionPath).isDirectory()) {
+      continue;
+    }
+    for (const component of fs.readdirSync(versionPath)) {
+      if (fs.existsSync(path.join(versionPath, component, 'index.tsx'))) {
+        names.push(component);
+      }
+    }
+  }
+  return names;
+}
+
 module.exports = function docs() {
+  const componentsOutDir = path.join(workspace.apiDocsPath, 'components');
+
+  // Document the stable components AND the versioned beta components into the SINGLE `components`
+  // output (one combined glob → one index barrel; the documenter rewrites the index from its glob,
+  // so a second same-outDir pass would clobber it). Beta components are NOT shipped as a separate
+  // barrel; they live in `components` and are distinguished by the `releaseStatus: 'beta'` flag
+  // stamped below.
   writeComponentsDocumentation({
-    outDir: path.join(workspace.apiDocsPath, 'components'),
+    outDir: componentsOutDir,
     tsconfigPath: require.resolve('../../tsconfig.json'),
-    publicFilesGlob: 'src/*/index.tsx',
+    publicFilesGlob: 'src/{*/index.tsx,beta/*/*/index.tsx}',
     extraExports: {
       FileDropzone: ['useFilesDragging'],
       IconProvider: ['defineIcons', 'IconRegistry', 'IconMap'],
       TagEditor: ['getTagsDiff'],
     },
   });
+
+  // The documenter hard-codes `releaseStatus: 'stable'` with no tag override, so stamp the beta
+  // components' generated definitions as `beta`. The website derives `isBeta` from this (beta page
+  // header alert + nav badge), keeping the single components barrel with per-component flagging.
+  for (const name of getBetaComponentNames('src')) {
+    const definitionFile = path.join(componentsOutDir, `${name}.js`);
+    if (!fs.existsSync(definitionFile)) {
+      continue;
+    }
+
+    const definition = require(path.resolve(definitionFile));
+    definition.releaseStatus = 'beta';
+    fs.writeFileSync(definitionFile, `module.exports = ${JSON.stringify(definition, null, 2)};`);
+  }
+
   writeTestUtilsDocumentation({
     outDir: path.join(workspace.apiDocsPath, 'test-utils-doc'),
     tsconfigPath: require.resolve('../../src/test-utils/tsconfig.json'),

build-tools/tasks/package-json.js

@@ -3,7 +3,7 @@
 const { parallel } = require('gulp');
 const path = require('path');
 const fs = require('fs');
-const { writeFile, listPublicItems } = require('../utils/files');
+const { writeFile, listPublicItems, listBetaItems } = require('../utils/files');
 const themes = require('../utils/themes');
 const { task, copyTask } = require('../utils/gulp-utils');
 const workspace = require('../utils/workspace');
@@ -51,6 +51,13 @@ function getComponentsExports() {
     result[`./${component}`] = `./${component}/index.js`;
   }
 
+  // Versioned beta components, published only at their explicit subpath (e.g.
+  // `@cloudscape-design/components/beta/basic-table-0.1`) — the versioning escape-hatch. Not added
+  // to the top-level barrel.
+  for (const betaItem of listBetaItems('src')) {
+    result[`./${betaItem}`] = `./${betaItem}/index.js`;
+  }
+
   // Per-component test-utils DOM wrappers (e.g. `.../test-utils/dom/button`).
   for (const component of listPublicItems('src/test-utils/dom')) {
     result[`./test-utils/dom/${component}`] = `./test-utils/dom/${component}/index.js`;

build-tools/utils/files.js

@@ -9,23 +9,40 @@
 }
 
 function listPublicItems(baseDir) {
   return fs
     .readdirSync(baseDir)
     .filter(
       elem =>
         !elem.startsWith('__') &&
         !elem.startsWith('.') &&
         elem !== 'internal' &&
         elem !== 'types' &&
         elem !== 'index.tsx' &&
         elem !== 'index.ts' &&
         elem !== 'interfaces.ts' &&
         elem !== 'test-utils' &&
         elem !== 'i18n' &&
         elem !== 'theming' &&
         elem !== 'plugins' &&
-        elem !== 'contexts'
+        elem !== 'contexts' &&
+        // `beta` is not a component: it is a container for versioned, opt-in beta components
+        // (e.g. `beta/basic-table-0.1`) enumerated separately via `listBetaItems`.
+        elem !== 'beta'
     );
 }
 
-module.exports = { writeFile, listPublicItems };
+// Lists the versioned beta components as `beta/<name>` (e.g. `beta/basic-table-0.1`). Beta components
+// are opt-in and published only at their versioned export subpath — they are intentionally excluded
+// from the top-level barrel and treated as their own kind of public item elsewhere in the build.
+function listBetaItems(srcDir = 'src') {
+  const betaDir = path.join(srcDir, 'beta');
+  if (!fs.existsSync(betaDir)) {
+    return [];
+  }
+  return fs
+    .readdirSync(betaDir)
+    .filter(elem => !elem.startsWith('__') && !elem.startsWith('.') && fs.statSync(path.join(betaDir, elem)).isDirectory())
+    .map(elem => `beta/${elem}`);
+}
+
+module.exports = { writeFile, listPublicItems, listBetaItems };

build-tools/utils/pluralize.js

@@ -11,6 +11,7 @@ const pluralizationMap = {
   Autosuggest: 'Autosuggests',
   Badge: 'Badges',
   BarChart: 'BarCharts',
+  BasicTable: 'BasicTables',
   Box: 'Boxes',
   BreadcrumbGroup: 'BreadcrumbGroups',
   Button: 'Buttons',

src/__tests__/snapshot-tests/__snapshots__/documenter.test.ts.snap

@@ -37687,6 +37687,84 @@ Options get highlighted when they match the value of the input field.",
       ],
       "name": "BarChartWrapper",
     },
+    {
+      "methods": [
+        {
+          "name": "findColumnHeaders",
+          "parameters": [],
+          "returnType": {
+            "isNullable": false,
+            "name": "Array",
+            "typeArguments": [
+              {
+                "name": "ElementWrapper<HTMLElement>",
+              },
+            ],
+          },
+        },
+        {
+          "name": "findHeaderRow",
+          "parameters": [],
+          "returnType": {
+            "isNullable": true,
+            "name": "ElementWrapper",
+            "typeArguments": [
+              {
+                "name": "HTMLElement",
+              },
+            ],
+          },
+        },
+        {
+          "name": "findLoadingText",
+          "parameters": [],
+          "returnType": {
+            "isNullable": true,
+            "name": "ElementWrapper",
+            "typeArguments": [
+              {
+                "name": "HTMLElement",
+              },
+            ],
+          },
+        },
+        {
+          "name": "findRowByIndex",
+          "parameters": [
+            {
+              "flags": {
+                "isOptional": false,
+              },
+              "name": "index",
+              "typeName": "number",
+            },
+          ],
+          "returnType": {
+            "isNullable": true,
+            "name": "ElementWrapper",
+            "typeArguments": [
+              {
+                "name": "HTMLElement",
+              },
+            ],
+          },
+        },
+        {
+          "name": "findRows",
+          "parameters": [],
+          "returnType": {
+            "isNullable": false,
+            "name": "Array",
+            "typeArguments": [
+              {
+                "name": "ElementWrapper<HTMLElement>",
+              },
+            ],
+          },
+        },
+      ],
+      "name": "BasicTableWrapper",
+    },
     {
       "methods": [],
       "name": "BoxWrapper",
@@ -49495,6 +49573,69 @@ Options get highlighted when they match the value of the input field.",
       ],
       "name": "BarChartWrapper",
     },
+    {
+      "methods": [
+        {
+          "name": "findColumnHeaders",
+          "parameters": [],
+          "returnType": {
+            "isNullable": false,
+            "name": "MultiElementWrapper",
+            "typeArguments": [
+              {
+                "name": "ElementWrapper",
+              },
+            ],
+          },
+        },
+        {
+          "name": "findHeaderRow",
+          "parameters": [],
+          "returnType": {
+            "isNullable": false,
+            "name": "ElementWrapper",
+          },
+        },
+        {
+          "name": "findLoadingText",
+          "parameters": [],
+          "returnType": {
+            "isNullable": false,
+            "name": "ElementWrapper",
+          },
+        },
+        {
+          "name": "findRowByIndex",
+          "parameters": [
+            {
+              "flags": {
+                "isOptional": false,
+              },
+              "name": "index",
+              "typeName": "number",
+            },
+          ],
+          "returnType": {
+            "isNullable": false,
+            "name": "ElementWrapper",
+          },
+        },
+        {
+          "name": "findRows",
+          "parameters": [],
+          "returnType": {
+            "isNullable": false,
+            "name": "MultiElementWrapper",
+            "typeArguments": [
+              {
+                "name": "ElementWrapper",
+              },
+            ],
+          },
+        },
+      ],
+      "name": "BasicTableWrapper",
+    },
     {
       "methods": [],
       "name": "BoxWrapper",

src/__tests__/snapshot-tests/__snapshots__/test-utils-selectors.test.tsx.snap

@@ -81,6 +81,14 @@ exports[`test-utils selectors 1`] = `
   "bar-chart": [
     "awsui_root_1gfe1",
   ],
+  "beta": [
+    "awsui_body_e1x3z",
+    "awsui_header-cell_e1x3z",
+    "awsui_header-row_e1x3z",
+    "awsui_loading_e1x3z",
+    "awsui_root_e1x3z",
+    "awsui_row_e1x3z",
+  ],
   "box": [
     "awsui_root_18wu0",
   ],