@genesislcap/build-kit 14.162.2-alpha-a2fd6f2.0 → 14.162.3

package/dist/utils/index.d.ts

@@ -14,7 +14,6 @@ export * from './npm';
 export * from './prompts';
 export * from './proxy';
 export * from './object';
-export * from './seed.commands';
 export * from './seed.fetching';
 export * from './seed.meta';
 export * from './seed.processing';

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC;AACtB,cAAc,cAAc,CAAC;AAC7B,cAAc,MAAM,CAAC;AACrB,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC;AACtB,cAAc,cAAc,CAAC;AAC7B,cAAc,MAAM,CAAC;AACrB,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC"}

package/dist/utils/index.js

@@ -17,7 +17,6 @@ tslib_1.__exportStar(require("./npm"), exports);
 tslib_1.__exportStar(require("./prompts"), exports);
 tslib_1.__exportStar(require("./proxy"), exports);
 tslib_1.__exportStar(require("./object"), exports);
-tslib_1.__exportStar(require("./seed.commands"), exports);
 tslib_1.__exportStar(require("./seed.fetching"), exports);
 tslib_1.__exportStar(require("./seed.meta"), exports);
 tslib_1.__exportStar(require("./seed.processing"), exports);

package/dist/utils/prompts.js

@@ -77,7 +77,7 @@ exports.getPromptValidators = getPromptValidators;
 // process CLI prompt params
 const getCLIParams = (persistedAnswers, params, defaults, dir, subdir, skipOptionalPrompts, seedMeta, details, validate) => {
     const base = skipOptionalPrompts ? defaults : {};
-    const cliParams = Object.assign(Object.assign(Object.assign(Object.assign({}, base), persistedAnswers), params), { appName: (0, node_path_1.basename)(dir), pkgName: (0, node_path_1.basename)(dir), directory: dir, appSeed: {
+    const cliParams = Object.assign(Object.assign(Object.assign(Object.assign({}, base), persistedAnswers), params), { appName: (0, node_path_1.basename)(dir), pkgName: (0, node_path_1.basename)(dir), directory: (0, node_path_1.basename)(dir), appSeed: {
             type: seedMeta.local ? 'local' : 'remote',
             name: seedMeta.seed,
             description: details.description,

package/dist/utils/seed.processing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seed.processing.d.ts","sourceRoot":"","sources":["../../src/utils/seed.processing.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAE/C,eAAO,MAAM,gBAAgB,yBAA2B,MAAM,EAAE,kBAkB/D,CAAC;AAmCF,eAAO,MAAM,cAAc,yFAsC1B,CAAC"}
+{"version":3,"file":"seed.processing.d.ts","sourceRoot":"","sources":["../../src/utils/seed.processing.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAE/C,eAAO,MAAM,gBAAgB,yBAA2B,MAAM,EAAE,kBAkB/D,CAAC;AAmCF,eAAO,MAAM,cAAc,yFAmC1B,CAAC"}

package/dist/utils/seed.processing.js

@@ -9,7 +9,6 @@ const console_1 = require("./console");
 const fs_1 = require("./fs");
 const handlebars_1 = require("./handlebars");
 const json_1 = require("./json");
-const formatPersistedData = (data) => (Object.assign(Object.assign({}, data), { directory: (0, node_path_1.basename)(data.directory) }));
 exports.PROMPT_DATA_FILE = 'answers.json';
 const removeExclusions = (dir, exclusions) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
     try {
@@ -79,8 +78,9 @@ const processOptions = (fetchSeedResult, dir, data, isInit, persistedAnswers) =>
     if (options.persistAnswers) {
         const jsonPath = (0, node_path_1.resolve)(fetchSeedResult.genxDir, exports.PROMPT_DATA_FILE);
         const additions = persistedAnswers.additions || [];
-        const addData = Object.assign(Object.assign({}, data), { appSeed: persistedAnswers.appSeed, additions: [...additions, data.appSeed] });
-        const json = isInit ? formatPersistedData(data) : formatPersistedData(addData);
+        const json = isInit
+            ? data
+            : Object.assign(Object.assign({}, data), { appSeed: persistedAnswers.appSeed, additions: [...additions, data.appSeed] });
         (0, json_1.writeJSON)(jsonPath, json);
     }
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/build-kit",
   "description": "Build utilities & types",
-  "version": "14.162.2-alpha-a2fd6f2.0",
+  "version": "14.162.3",
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -36,7 +36,7 @@
   },
   "devDependencies": {
     "@esbuild-kit/cjs-loader": "2.4.2",
-    "@genesislcap/foundation-testing": "14.162.2-alpha-a2fd6f2.0",
+    "@genesislcap/foundation-testing": "14.162.3",
     "@types/http-proxy": "^1.17.8",
     "@types/node": "^20.8.7",
     "tsm": "^2.2.1",
@@ -51,5 +51,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "98e0b9eab3be45356523abc1ebbed8c958dd931b"
+  "gitHead": "ec9c4e02d46ba766a3760bbe85a77ffb40c6c55c"
 }

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './utils';
+export * from './types';

package/src/types/build-context.ts

@@ -0,0 +1,57 @@
+import type { PackageJson } from 'pkg-types';
+import { Config } from './config';
+
+export enum ENV {
+  PROD = 'production',
+  DEV = 'development',
+  TEST = 'test',
+}
+
+export enum COMMAND {
+  BUILD = 'build',
+  DEV = 'dev',
+  TEST = 'test',
+  ANALYZE = 'analyze',
+  RUN = 'run',
+  UPGRADE = 'upgrade',
+  LINT = 'lint',
+  INIT = 'init',
+  ADD = 'add',
+}
+
+export interface BuildContext {
+  cli: {
+    command: COMMAND;
+    isDev: boolean;
+    isBuild: boolean;
+    isTest: boolean;
+    isAnalyze: boolean;
+    isRun: boolean;
+    isLint: boolean;
+    // CLI options
+    options: { [index: string]: any };
+  };
+  env: {
+    isCI: boolean;
+  };
+  // resolved options from genx.config.{js,json,ts} or genx key in package.json
+  config: Config;
+  // package.json of current project
+  pkg: PackageJson;
+  dirs: {
+    // working directory
+    cwd: string;
+    // monorepo root directory
+    workspace?: string;
+  };
+  resolve: {
+    alias: {
+      [index: string]: string;
+    };
+  };
+  enable: {
+    apiExtractor?: object;
+    cemAnalyzer?: object;
+    mft?: object;
+  };
+}

package/src/types/config.ts

@@ -0,0 +1,269 @@
+import { COMMAND } from './build-context';
+import { PWAManifest } from './pwa';
+
+export interface WebpackFilenames {
+  chunk?: ({ isDev }: { isDev: boolean }) => string;
+  file?: ({ isDev }: { isDev: boolean }) => string;
+  sourceMap?: ({ isDev }: { isDev: boolean }) => string;
+}
+
+/**
+ * GENX CLI configuration
+ * Loaded from genx.config.{js,json,ts} or genx key in package.json in working directory
+ */
+export interface Config {
+  app?: {
+    /**
+     * Root application element name (must include hyphen)
+     */
+    rootElement?: string;
+  };
+  /**
+   * Override default builder for a given CLI command (dev/build/analyze/test).
+   * A given builder typically supports a subset of all possible commands (e.g. a test runner won't handle analyze command).
+   * If you use an incompatible builder, you'll get an unrecognized command error.
+   * @defaultValue
+   * ```
+   * {
+   *   default: 'webpack',
+   *   dev: 'vite',
+   *   lint: 'eslint-stylelint',
+   *   test: 'uvu-playwright',
+   * }
+   * ```
+   * @example
+   * ```
+   * "builder": {
+   *   "build": "ts",
+   *   "dev": "ts"
+   * }
+   * ```
+   */
+  builder?: {
+    [index in COMMAND | 'default']: string;
+  };
+  /**
+   * Controls whether dist folder should be cleared out before the build.
+   * Can be overriden using `GENX_NO_CLEAN` environment variable.
+   * @defaultValue true
+   */
+  clean?: boolean;
+  /**
+   * Static assets to copy during the build.
+   * @defaultValue ['src/**\/*.{css,jpg,png,svg,mp4,ogg,webm}']
+   */
+  copyAssets?: string[];
+  /**
+   * Override default entry point
+   * Paths are resolved relative to src folder
+   * @example
+   * ```
+   * "entry": {
+   *   "electron": "electron.main.ts"
+   * }
+   * ```
+   */
+  entry?: string | { [index: string]: string };
+  /**
+   * Environment variables to expose in UI code. Regex patterns allowed.
+   * @defaultValue `['API_HOST', 'DEFAULT_ORGANISATION', 'DEFAULT_USER', 'DEFAULT_PASSWORD', 'ENABLE_SSO', 'GENX.*', 'GENX_*', 'FORCE_HTTP', 'SOCKET_EXT']
+   */
+  env?: string[];
+  /**
+   * Exclude modules from the output bundle.
+   * @remark This setting has no effect on `ts-builder`
+   * @defaultValue `index.ts`
+   * @example
+   * ```
+   * "externals": {
+   *   "@ag-grid-community/core": "agGrid"
+   * }
+   * ```
+   */
+  externals?: {
+    [index: string]: string;
+  };
+  /**
+   * Module federation options.
+   */
+  federation?: {
+    /**
+     * Federation dashboard URL
+     */
+    dashboardURL?: string;
+    /**
+     * Federation publish version
+     * Defaults to version in package.json.
+     */
+    publishVersion?: string;
+    /**
+     * Remote federated modules
+     * @example
+     * ```
+     * remotes: ["@genesislcap/foundation-zero"]
+     * ```
+     */
+    remotes?: {
+      [index: string]: string;
+    };
+    /**
+     * Shared federated modules
+     * @example
+     * ```
+     * shared: ["@microsoft/fast-components", "@microsoft/fast-element", "@microsoft/fast-foundation"]
+     * ```
+     */
+    shared?: {
+      [index: string]: string | { singleton: boolean; requiredVersion: string };
+    };
+    /**
+     * Exposed entry points
+     * @example
+     * ```
+     * exposes: {
+     *   "./index": "./src/index.federated.ts",
+     *   "./utils": "./src/utils/index.ts"
+     * }
+     * ```
+     */
+    exposes?: {
+      [index: string]: string;
+    };
+  };
+  /**
+   * HTTP polling configuration.
+   * @example
+   * ```
+   * http: {
+   *  "POLLING_MAP": {
+   *    "EVENT_AMEND_USER": {
+   *     "TEMP_FREQUENCY": 400,
+   *      "AMOUNT_OF_POLLS": 5,
+   *      "QUERIES": [
+   *        "ALL_USERS"
+   *      ]
+   *    }
+   *  },
+   *  "POLLING_INTERVAL_MAP": {
+   *    "ALL_TRADES": 4000,
+   *    "ALL_USERS": 4000,
+   *    "ALL_PROCESSES_STATUS": 5000
+   *  },
+   *  "POLLING_FREQUENCY": 4000
+   * }
+   * ```
+   */
+  http?: object;
+  /*
+   * Web application manifest
+   * @remarks
+   * Keys are specified using camel case notation
+   *
+   * @see https://developer.mozilla.org/en-US/docs/Web/Manifest
+   * @example
+   * ```
+   * pwa: {
+   *   name: 'SampleApp',
+   *   shortName: 'SampleApp',
+   *   startUrl: '.',
+   *   display: 'standalone',
+   *   backgroundColor: '#FFF',
+   *   description: 'Application manifest example.',
+   *   icons: [{
+   *     src: 'images/touch/homescreen48.png',
+   *     sizes: [48]
+   *   }]
+   *   }
+   * ```
+   */
+  pwa?: PWAManifest;
+  /*
+   * Server worker configuration
+   * @see https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API
+   */
+  serviceWorker?: {
+    /*
+     * Service worker file
+     */
+    worker: string;
+    /*
+     * Service worker registration file
+     */
+    registration: string;
+    /*
+     * Generated service worker asset filename
+     * @defaultValue `service-worker.js`
+     */
+    assetName?: string;
+    /*
+     * Exclude from from the precache manifest
+     * @defaultValue `[/\.map$/, /^manifest.*\.js$]`
+     */
+    exclude?: Array<string | RegExp | ((arg0: any) => boolean)>;
+    /*
+     * Maximum size of files to precache, in bytes. This prevents you from inadvertently precaching very large files that might have accidentally matched one of your patterns.
+     * @defaultValue `2097152`
+     */
+    maximumFileSizeToCache?: number;
+  };
+  /*
+   * Webpack specific configuration
+   */
+  webpack?: {
+    /*
+     * Whether to polyfill or mock certain Node.js globals
+     * @see https://webpack.js.org/configuration/node/
+     */
+    node?:
+      | false
+      | {
+          [index: string]: boolean | string;
+        };
+    /**
+     * Customize bundle filenames.
+     *
+     * @note Be careful when using non-hashed based filenames in production
+     * as most browsers will cache the asset and not detect the changes on first load.
+     *
+     * @see https://webpack.js.org/configuration/output/#outputfilename
+     * @example
+     * ```js
+     * filenames: {
+     *   chunk: ({ isDev }) => (isDev ? '[name].js' : '[id].[contenthash].js')
+     * }
+     * ```
+     */
+    filenames?: WebpackFilenames;
+    /**
+     * Customize Webpack optimization settings.
+     *
+     * @see https://webpack.js.org/configuration/optimization/
+     */
+    optimization?: ({ isDev }: { isDev: boolean }) => unknown;
+    /**
+     * Set Webpack deployment target.
+     *
+     * @see https://webpack.js.org/concepts/targets/
+     */
+    target?: string | false | string[];
+    /**
+     * Dev server middleware writeToDisk toggle.
+     *
+     * @remarks
+     * Useful during development when watching packages for changes that are bundled with webpack.
+     *
+     * @example
+     * ```json
+     * "genx": {
+     *     "app": {...},
+     *     "webpack": {
+     *       "writeToDisk": true
+     *     }
+     *   },
+     * ```
+     *
+     * @see https://webpack.js.org/configuration/dev-server/#devserverdevmiddleware
+     */
+    writeToDisk?: boolean;
+  };
+}

package/src/types/index.ts

@@ -0,0 +1,3 @@
+export * from './build-context';
+export * from './config';
+export * from './pwa';

package/src/types/pwa.ts

@@ -0,0 +1,67 @@
+export type PWADirection = 'ltr' | 'rtl' | 'auto';
+export type PWADisplay = 'fullscreen' | 'standalone' | 'minimal-ui' | 'browser';
+export type PWAOrientation =
+  | 'any'
+  | 'natural'
+  | 'landscape'
+  | 'landscape-primary'
+  | 'landscape-secondary'
+  | 'portrait'
+  | 'portrait-primary'
+  | 'portrait-secondary';
+export type PWACrossOrigin = 'use-credentials' | 'anonymous';
+
+export interface PWARelatedApplications {
+  platform?: string;
+  url: string;
+  id?: string;
+}
+export interface PWAIosOptions {
+  'apple-touch-icon'?: string | PWAIosAppleTouchIcon;
+  'apple-touch-startup-image'?: string;
+  'apple-mobile-web-app-title'?: string;
+  'apple-mobile-web-app-capable'?: 'yes' | 'no' | boolean;
+  'apple-mobile-web-app-status-bar-style'?: 'default' | 'black' | 'black-translucent';
+}
+export interface PWAIosAppleTouchIcon {
+  sizes?: string | number;
+  href: string;
+}
+export interface PWAIcon {
+  src: string;
+  size?: string | number;
+  sizes?: number[];
+  destination?: string;
+  ios?: boolean | 'default' | 'startup';
+  purpose?: string;
+  type?: string;
+}
+
+// Only listing the officially supported keys here https://developer.mozilla.org/en-US/docs/Web/Manifest
+// Bundler-specific keys can still be passed in because of the index type below
+export interface PWAManifest {
+  backgroundColor?: string;
+  categories?: string[];
+  crossorigin?: PWACrossOrigin;
+  description?: string;
+  dir?: PWADirection;
+  display?: PWADisplay;
+  displayOverride?: string[];
+  fileHandlers?: object[];
+  icons?: PWAIcon | PWAIcon[];
+  id?: string;
+  ios?: boolean | PWAIosOptions;
+  lang?: string;
+  launchHandler?: object;
+  name: string;
+  orientation?: PWAOrientation;
+  preferRelatedApplications?: boolean;
+  relatedApplications?: PWARelatedApplications[];
+  scope?: string;
+  screenshots?: object[];
+  shareTarget?: string;
+  shortName?: string;
+  startUrl?: string;
+  themeColor?: string;
+  [index: string]: string | object | boolean;
+}

package/src/utils/archive.ts

@@ -0,0 +1,18 @@
+import { cpSync } from 'node:fs';
+import consola from 'consola';
+import download from 'download-tarball';
+import tmp from 'tmp';
+
+export const downloadTarball = async (url: string, destination: string, subPath = '') => {
+  const tmpDir = tmp.dirSync();
+
+  consola.debug({
+    tmp: tmpDir.name,
+    destination,
+    url,
+  });
+
+  await download({ url, dir: tmpDir.name });
+  const source = `${tmpDir.name}${subPath}`;
+  cpSync(`${source}`, destination, { recursive: true });
+};

package/src/utils/args.ts

@@ -0,0 +1,7 @@
+import unparse from 'unparse-args';
+
+export const unparseArgs = (args: object): string => {
+  const clone = { ...args };
+  delete clone['--']; // always included in cac parsed options
+  return unparse(clone).command_string;
+};

package/src/utils/build-context.ts

@@ -0,0 +1,42 @@
+import { resolve } from 'node:path';
+import { findWorkspaceDir } from 'pkg-types';
+import { BuildContext, COMMAND } from '../types';
+import { loadConfig } from './config';
+import { loadPackageJSON, tryRequire } from './npm';
+
+export const loadBuildContext = async (cwd, command: COMMAND, options): Promise<BuildContext> => {
+  const pkg = await loadPackageJSON();
+  const workspace = await findWorkspaceDir();
+  const config = await loadConfig(pkg);
+  return {
+    cli: {
+      command,
+      isDev: command === COMMAND.DEV,
+      isAnalyze: command === COMMAND.ANALYZE,
+      isBuild: command === COMMAND.BUILD,
+      isTest: command === COMMAND.TEST,
+      isRun: command === COMMAND.RUN,
+      isLint: command === COMMAND.LINT,
+      options,
+    },
+    env: {
+      isCI: !!process.env.CI,
+    },
+    dirs: {
+      cwd,
+      workspace,
+    },
+    resolve: {
+      alias: {
+        pbc: resolve(cwd, './src/pbc'),
+      },
+    },
+    pkg,
+    config,
+    enable: {
+      apiExtractor: tryRequire('./api-extractor', cwd),
+      cemAnalyzer: tryRequire('./custom-elements-manifest.config', cwd),
+      mft: tryRequire('./federation.config'),
+    },
+  };
+};

package/src/utils/child-process.ts

@@ -0,0 +1,115 @@
+import { spawnSync, spawn } from 'node:child_process';
+import { resolve as resolvePath, relative } from 'node:path';
+import consola from 'consola';
+
+export interface RunOptions {
+  exitOnError?: boolean;
+  prefixCommandWithNode?: boolean;
+  verbose?: boolean;
+  env?: Record<string, string>;
+  nodeArgs?: string;
+}
+
+export const run = (cwd, command, options: RunOptions = {}) => {
+  const {
+    exitOnError = true,
+    // defaulting to true for Windows support
+    prefixCommandWithNode = true,
+    env = { ...process.env },
+    nodeArgs = '',
+    verbose = true,
+  } = options;
+
+  const fullCommand = prefixCommandWithNode ? `node ${nodeArgs} ${command}` : command;
+
+  const result = spawnSync(fullCommand, {
+    shell: true,
+    cwd,
+    stdio: verbose ? 'inherit' : 'ignore',
+    env,
+  });
+
+  if (result.status === 1 && exitOnError) {
+    process.exit(result.status);
+  }
+
+  return result;
+};
+
+const normaliseNPMCLI = (cli: string): string => {
+  if (cli.toLowerCase() === 'npm') {
+    return process.platform.match(/^win/) ? 'npm.cmd' : 'npm';
+  }
+  return cli;
+};
+
+export const runAsync = async (cwd, command, options: RunOptions = {}): Promise<Error | null> => {
+  const {
+    exitOnError = true,
+    prefixCommandWithNode = true,
+    env = { ...process.env },
+    nodeArgs = '',
+    verbose = true,
+  } = options;
+
+  return new Promise((resolve, reject) => {
+    const chunks = command.trim().split(' ');
+    const fullCommand = prefixCommandWithNode
+      ? `node ${nodeArgs} ${chunks.shift()}`
+      : chunks.shift();
+    const crossPlatformCommand = normaliseNPMCLI(fullCommand);
+    const child = spawn(crossPlatformCommand, chunks, {
+      cwd,
+      stdio: verbose ? 'inherit' : 'ignore',
+      env,
+    });
+    child.on('close', (code) => {
+      if (code === 0) {
+        resolve(null);
+      } else {
+        const err = new Error(`Unexpected error executing ${command}`);
+        if (exitOnError) {
+          consola.error(err);
+          return process.exit(code);
+        }
+        reject(err);
+      }
+    });
+    child.on('error', (err) => {
+      if (exitOnError) {
+        consola.error(err);
+        return process.exit(1);
+      }
+      reject(err);
+    });
+  });
+};
+
+// Based on https://github.com/unjs/giget/blob/main/src/_utils.ts#L110
+
+const currentShell = () => {
+  if (process.env.SHELL) {
+    return process.env.SHELL;
+  }
+  if (process.platform === 'win32') {
+    return 'cmd.exe';
+  }
+  return '/bin/bash';
+};
+
+export const startShell = (cwd: string) => {
+  cwd = resolvePath(cwd);
+  const shell = currentShell();
+  consola.info(`(experimental) Opening shell in ${relative(process.cwd(), cwd)}...`);
+  // spawnSync command is quoted to support paths with spaces on Windows (C:/Program Files etc.)
+  spawnSync(`"${shell}"`, [], {
+    cwd,
+    shell: true,
+    stdio: 'inherit',
+    env: {
+      ...process.env,
+      // DEBUG (set via log-level) messes up zsh
+      DEBUG: undefined,
+    },
+  });
+};