@stencil/core 4.43.3 → 5.0.0-alpha.1

package/package.json

@@ -1,264 +1,135 @@
 {
   "name": "@stencil/core",
-  "version": "4.43.3",
+  "version": "5.0.0-alpha.1",
+  "description": "A Compiler for Web Components and Progressive Web Apps",
+  "keywords": [
+    "components",
+    "custom elements",
+    "ionic",
+    "progressive web app",
+    "pwa",
+    "stencil",
+    "web components",
+    "webapp"
+  ],
+  "homepage": "https://stenciljs.com/",
   "license": "MIT",
-  "main": "./internal/stencil-core/index.cjs",
-  "module": "./internal/stencil-core/index.js",
-  "types": "./internal/stencil-core/index.d.ts",
+  "author": "StencilJs Contributors",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stenciljs/core.git"
+  },
   "bin": {
-    "stencil": "bin/stencil"
+    "stencil": "./bin/stencil.mjs"
   },
   "files": [
-    "!**/*.map",
-    "!**/*.stub.ts",
-    "!**/*.stub.tsx",
     "bin/",
-    "cli/",
-    "compiler/",
-    "dev-server/",
-    "internal/",
-    "mock-doc/",
-    "screenshot/",
-    "sys/",
-    "testing/"
+    "dist/"
   ],
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
   "exports": {
+    "./package.json": "./package.json",
     ".": {
-      "types": "./internal/stencil-core/index.d.ts",
-      "import": "./internal/stencil-core/index.js",
-      "require": "./internal/stencil-core/index.cjs"
-    },
-    "./jsx-runtime": {
-      "types": "./internal/stencil-core/jsx-runtime.d.ts",
-      "import": "./internal/stencil-core/jsx-runtime.js",
-      "require": "./internal/stencil-core/jsx-runtime.cjs"
-    },
-    "./jsx-dev-runtime": {
-      "types": "./internal/stencil-core/jsx-dev-runtime.d.ts",
-      "import": "./internal/stencil-core/jsx-dev-runtime.js",
-      "require": "./internal/stencil-core/jsx-dev-runtime.cjs"
-    },
-    "./cli": {
-      "import": "./cli/index.js",
-      "require": "./cli/index.cjs"
-    },
-    "./internal": {
-      "import": "./internal/index.js",
-      "types": "./internal/index.d.ts"
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
     },
-    "./internal/client": {
-      "import": "./internal/client/index.js",
-      "require": "./internal/client/index.js"
+    "./compiler": {
+      "types": "./dist/compiler/index.d.mts",
+      "import": "./dist/compiler/index.mjs"
     },
-    "./internal/testing": {
-      "import": "./internal/testing/index.js",
-      "require": "./internal/testing/index.js"
+    "./compiler/utils": {
+      "types": "./dist/compiler/utils/index.d.mts",
+      "import": "./dist/compiler/utils/index.mjs"
     },
-    "./internal/testing/jsx-runtime": {
-      "types": "./internal/testing/jsx-runtime.d.ts",
-      "import": "./internal/testing/jsx-runtime.js",
-      "require": "./internal/testing/jsx-runtime.js"
+    "./jsx-runtime": {
+      "types": "./dist/jsx-runtime.d.ts",
+      "import": "./dist/jsx-runtime.js"
     },
-    "./internal/testing/jsx-dev-runtime": {
-      "types": "./internal/testing/jsx-dev-runtime.d.ts",
-      "import": "./internal/testing/jsx-dev-runtime.js",
-      "require": "./internal/testing/jsx-dev-runtime.js"
+    "./jsx-dev-runtime": {
+      "types": "./dist/jsx-runtime.d.ts",
+      "import": "./dist/jsx-runtime.js"
     },
-    "./internal/testing/*": {
-      "import": "./internal/testing/*"
+    "./mock-doc": {
+      "types": "./dist/mock-doc.d.mts",
+      "import": "./dist/mock-doc.mjs",
+      "default": "./dist/mock-doc.mjs"
     },
-    "./internal/app-data": {
-      "types": "./internal/app-data/index.d.ts",
-      "import": "./internal/app-data/index.js",
-      "require": "./internal/app-data/index.cjs"
+    "./runtime": {
+      "types": "./dist/runtime/index.d.ts",
+      "import": "./dist/runtime/index.js"
     },
-    "./internal/app-globals": {
-      "import": "./internal/app-globals/index.js",
-      "require": "./internal/app-globals/index.js"
+    "./runtime/app-data": {
+      "types": "./dist/runtime/app-data/index.d.ts",
+      "import": "./dist/runtime/app-data/index.js"
     },
-    "./mock-doc": {
-      "types": "./mock-doc/index.d.ts",
-      "import": "./mock-doc/index.js",
-      "require": "./mock-doc/index.cjs"
+    "./runtime/app-globals": {
+      "types": "./dist/runtime/app-globals/index.d.ts",
+      "import": "./dist/runtime/app-globals/index.js"
     },
-    "./compiler": {
-      "types": "./compiler/stencil.d.ts",
-      "import": "./compiler/stencil.js",
-      "require": "./compiler/stencil.js"
+    "./runtime/client": {
+      "types": "./dist/runtime/client/index.d.ts",
+      "import": "./dist/runtime/client/index.js"
     },
-    "./compiler/*": {
-      "types": "./compiler/*",
-      "import": "./compiler/*",
-      "require": "./compiler/*"
+    "./runtime/server": {
+      "types": "./dist/runtime/server/index.d.mts",
+      "import": "./dist/runtime/server/index.mjs"
     },
-    "./screenshot": {
-      "types": "./screenshot/index.d.ts",
-      "require": "./screenshot/index.js"
+    "./runtime/server/runner": {
+      "types": "./dist/runtime/server/runner.d.mts",
+      "import": "./dist/runtime/server/runner.mjs"
     },
     "./sys/node": {
-      "types": "./sys/node/index.d.ts",
-      "import": "./sys/node/index.js",
-      "require": "./sys/node/index.js"
-    },
-    "./sys/node/*": {
-      "import": "./sys/node/*",
-      "require": "./sys/node/*"
+      "types": "./dist/sys/node/index.d.mts",
+      "import": "./dist/sys/node/index.mjs"
     },
     "./testing": {
-      "types": "./testing/index.d.ts",
-      "import": "./testing/index.js",
-      "require": "./testing/index.js"
-    },
-    "./testing/jest-preset": {
-      "require": "./testing/jest-preset.js"
-    },
-    "./testing/*": {
-      "import": "./testing/*",
-      "require": "./testing/*"
+      "types": "./dist/testing/index.d.mts",
+      "import": "./dist/testing/index.mjs"
     }
   },
-  "scripts": {
-    "build": "npm run clean && npm run tsc.prod && npm run ts scripts/index.ts -- --prod --ci",
-    "build.watch": "npm run build -- --watch",
-    "build.updateSelectorEngine": "npm run ts scripts/updateSelectorEngine.ts",
-    "clean": "rimraf --max-retries=2 build/ cli/ compiler/ dev-server/ internal/ mock-doc/ sys/node/ sys/ testing/ && npm run clean:scripts && npm run clean.screenshots",
-    "clean.screenshots": "rimraf test/end-to-end/screenshot/builds test/end-to-end/screenshot/images",
-    "clean:scripts": "rimraf scripts/build",
-    "lint": "eslint bin/* scripts/*.ts scripts/**/*.ts src/*.ts src/**/*.ts src/**/*.tsx test/wdio/**/*.tsx",
-    "install.jest": "npx tsx ./src/testing/jest/install-dependencies.mts",
-    "prettier": "npm run prettier.base -- --write",
-    "prettier.base": "prettier --cache \"./({bin,scripts,src,test}/**/*.{ts,tsx,js,jsx})|bin/stencil|.github/(**/)?*.(yml|yaml)|*.js\"",
-    "prettier.dry-run": "npm run prettier.base -- --list-different",
-    "release.ci.prepare": "npm run ts scripts/index.ts -- --release --ci-prepare",
-    "release.ci": "NODE_OPTIONS=--max-old-space-size=4096 npm run ts scripts/index.ts -- --release --ci-publish",
-    "spellcheck": "npm run spellcheck.code && npm run spellcheck.markdown",
-    "spellcheck.code": "cspell --config cspell-code.json --no-progress \"src/**/*.ts\" \"src/**/*.tsx\" \"scripts/**/*.ts\"",
-    "spellcheck.markdown": "cspell --config cspell-markdown.json --no-progress \"*.md\" \"**/*.md\"",
-    "test": "node --experimental-vm-modules ./node_modules/jest/bin/jest.js --coverage",
-    "test.analysis": "cd test && npm ci && npm run analysis.build-and-analyze",
-    "test.bundle-size": "cd test/bundle-size && npm test",
-    "test.bundlers": "cd test && npm run bundlers",
-    "test.copytask": "cd test/copy-task && npm ci && npm run test",
-    "test.dist": "npm run ts scripts/index.ts -- --validate-build",
-    "test.end-to-end": "cd test/end-to-end && npm ci && npm test && npm run test.dist",
-    "test.jest": "node --experimental-vm-modules ./node_modules/jest/bin/jest.js",
-    "test.type-tests": "cd ./test/wdio && npm install && npm run build.test-sibling && npm run build.main && cd ../../ && tsc -p test/type-tests/tsconfig.json",
-    "test.wdio": "cd test/wdio && npm ci && npm run test",
-    "test.wdio.testOnly": "cd test/wdio && npm ci && npm run wdio",
-    "test.prod": "npm run test.dist && npm run test.end-to-end && npm run test.jest && npm run test.wdio && npm run test.testing && npm run test.analysis",
-    "test.testing": "node scripts/test/validate-testing.js",
-    "test.docs-build": "cd test && npm run build.docs-json && npm run build.docs-readme",
-    "test.watch": "node --experimental-vm-modules ./node_modules/jest/bin/jest.js --watch",
-    "test.watch-all": "node --experimental-vm-modules ./node_modules/jest/bin/jest.js --watchAll --coverage",
-    "tsc.prod": "tsc",
-    "ts": "tsc --noEmit --project scripts/tsconfig.json && tsx"
-  },
-  "devDependencies": {
-    "@ionic/prettier-config": "^4.0.0",
-    "@jridgewell/source-map": "^0.3.6",
-    "@rollup/plugin-commonjs": "28.0.2",
-    "@rollup/plugin-json": "6.1.0",
-    "@rollup/plugin-node-resolve": "16.0.0",
-    "@rollup/plugin-replace": "6.0.2",
-    "@rollup/pluginutils": "5.1.4",
-    "@types/eslint": "^8.4.6",
-    "@types/exit": "^0.1.31",
-    "@types/fs-extra": "^11.0.0",
-    "@types/graceful-fs": "^4.1.5",
-    "@types/jest": "^27.0.3",
-    "@types/listr": "^0.14.4",
-    "@types/node": "^24.6.2",
-    "@types/pixelmatch": "^5.2.4",
-    "@types/pngjs": "^6.0.1",
-    "@types/prompts": "^2.0.9",
-    "@types/semver": "^7.3.12",
-    "@types/ws": "^8.5.4",
-    "@types/yarnpkg__lockfile": "^1.1.5",
-    "@typescript-eslint/eslint-plugin": "^7.0.0",
-    "@typescript-eslint/parser": "^7.0.0",
-    "@yarnpkg/lockfile": "^1.1.0",
-    "ansi-colors": "4.1.3",
-    "autoprefixer": "10.4.19",
-    "conventional-changelog-cli": "^5.0.0",
-    "cspell": "^8.0.0",
+  "dependencies": {
+    "@parcel/watcher": "^2.5.1",
+    "@rollup/plugin-commonjs": "^29.0.0",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-replace": "^6.0.3",
+    "@rollup/pluginutils": "^5.3.0",
+    "@stencil/vitest": "^1.9.3",
+    "autoprefixer": "^10.4.24",
+    "chalk": "^5.6.2",
     "css-what": "^7.0.0",
-    "dts-bundle-generator": "~9.5.0",
-    "esbuild": "^0.25.0",
-    "esbuild-plugin-replace": "^1.4.0",
-    "eslint": "^8.23.1",
-    "eslint-config-prettier": "^9.0.0",
-    "eslint-plugin-jest": "^28.0.0",
-    "eslint-plugin-jsdoc": "^50.0.0",
-    "eslint-plugin-simple-import-sort": "^12.0.0",
-    "eslint-plugin-wdio": "^8.24.12",
-    "execa": "9.3.0",
-    "exit": "^0.1.2",
-    "fs-extra": "^11.0.0",
-    "glob": "10.5.0",
-    "graceful-fs": "~4.2.6",
-    "jest": "^27.4.5",
-    "jest-cli": "^27.4.5",
-    "jest-environment-node": "^27.4.4",
-    "jquery": "https://github.com/jquery/jquery/tarball/c98597eaf5e144ee5e549cb41984687cd1033068",
-    "listr": "^0.14.3",
+    "glob": "^10.0.0",
+    "graceful-fs": "^4.2.11",
     "magic-string": "^0.30.0",
     "merge-source-map": "^1.1.0",
-    "mime-db": "^1.46.0",
-    "minimatch": "9.0.9",
-    "node-fetch": "3.3.2",
-    "open": "^9.0.0",
-    "open-in-editor": "2.2.0",
-    "parse5": "7.2.1",
-    "pixelmatch": "5.3.0",
-    "postcss": "^8.2.8",
+    "minimatch": "^10.1.2",
+    "postcss": "^8.5.6",
     "postcss-safe-parser": "^7.0.1",
-    "postcss-selector-parser": "^7.1.0",
-    "prettier": "3.3.1",
-    "prompts": "2.4.2",
-    "puppeteer": "^24.1.0",
-    "rimraf": "^6.0.1",
-    "rollup": "4.44.0",
-    "semver": "^7.3.7",
+    "postcss-selector-parser": "^7.1.1",
+    "resolve": "^1.22.0",
+    "rollup": "^4.0.0",
+    "semver": "^7.7.4",
     "terser": "5.37.0",
-    "tsx": "^4.19.2",
-    "typescript": "~5.8.3",
-    "webpack": "^5.75.0",
-    "ws": "8.17.1"
+    "typescript": "~6.0.2",
+    "@stencil/dev-server": "5.0.0-alpha.1",
+    "@stencil/cli": "5.0.0-alpha.1",
+    "@stencil/mock-doc": "5.0.0-alpha.1"
   },
-  "optionalDependencies": {
-    "@rollup/rollup-darwin-arm64": "4.44.0",
-    "@rollup/rollup-darwin-x64": "4.44.0",
-    "@rollup/rollup-linux-arm64-gnu": "4.44.0",
-    "@rollup/rollup-linux-arm64-musl": "4.44.0",
-    "@rollup/rollup-linux-x64-gnu": "4.44.0",
-    "@rollup/rollup-linux-x64-musl": "4.44.0",
-    "@rollup/rollup-win32-arm64-msvc": "4.44.0",
-    "@rollup/rollup-win32-x64-msvc": "4.44.0"
-  },
-  "engines": {
-    "node": ">=16.0.0",
-    "npm": ">=7.10.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/stenciljs/core.git"
+  "devDependencies": {
+    "@ionic/prettier-config": "^4.0.0",
+    "prettier": "^3.5.0",
+    "tsdown": "^0.21.6",
+    "vitest": "^4.1.1",
+    "vitest-environment-stencil": "^1.9.3"
   },
-  "author": "Ionic Team",
-  "homepage": "https://stenciljs.com/",
-  "description": "A Compiler for Web Components and Progressive Web Apps",
-  "keywords": [
-    "web components",
-    "components",
-    "stencil",
-    "ionic",
-    "webapp",
-    "custom elements",
-    "pwa",
-    "progressive web app"
-  ],
-  "prettier": "@ionic/prettier-config",
   "volta": {
-    "node": "22.2.0",
-    "npm": "10.8.1"
+    "extends": "../../package.json"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
   }
-}
+}

package/bin/stencil

@@ -1,57 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-var minimumVersion = '16.0';
-var futureDeprecationMinVersion = '16.0';
-var recommendedVersion = '18.16';
-var currentVersion = process.versions.node;
-
-function isNodeLT(v) {
-  var check = v.split('.').map(Number);
-  var node = currentVersion.split('.').map(Number);
-  return node[0] < check[0] || (node[0] === check[0] && node[1] < check[1]);
-}
-
-if (isNodeLT(minimumVersion)) {
-  console.error(
-    '\nYour current version of Node is v' +
-      currentVersion +
-      ', however Stencil requires v' +
-      minimumVersion +
-      '.0 or greater. It is recommended to use an Active LTS version of Node (https://nodejs.org/en/about/releases/).\n',
-  );
-  process.exit(1);
-}
-
-if (isNodeLT(futureDeprecationMinVersion)) {
-  console.warn(
-    '\nIn an upcoming major release of Stencil, Node v' + recommendedVersion + '.0 or higher will be required.\n',
-  );
-} else if (isNodeLT(recommendedVersion)) {
-  console.warn(
-    '\nYour current version of Node is v' +
-      currentVersion +
-      ", however Stencil's recommendation is v" +
-      recommendedVersion +
-      '.0 or greater. Note that future versions of Stencil will eventually remove support for older Node versions and an Active LTS version is recommended (https://nodejs.org/en/about/releases/).\n',
-  );
-}
-
-var cli = require('../cli/index.cjs');
-var nodeApi = require('../sys/node/index.js');
-var nodeLogger = nodeApi.createNodeLogger();
-var nodeSys = nodeApi.createNodeSys({ process: process, logger: nodeLogger });
-
-nodeApi.setupNodeProcess({ process: process, logger: nodeLogger });
-
-cli
-  .run({
-    args: process.argv.slice(2),
-    logger: nodeLogger,
-    sys: nodeSys,
-    checkVersion: nodeApi.checkVersion,
-  })
-  .catch(function (err) {
-    console.error('uncaught error', err);
-    process.exit(1);
-  });

package/cli/config-flags.d.ts

@@ -1,132 +0,0 @@
-import type { LogLevel, TaskCommand } from '../internal/index';
-/**
- * All the Boolean options supported by the Stencil CLI
- */
-export declare const BOOLEAN_CLI_FLAGS: readonly ["build", "cache", "checkVersion", "ci", "compare", "debug", "dev", "devtools", "docs", "e2e", "es5", "esm", "help", "log", "open", "prerender", "prerenderExternal", "prod", "profile", "serviceWorker", "screenshot", "serve", "skipNodeCheck", "spec", "ssr", "updateScreenshot", "verbose", "version", "watch", "all", "automock", "bail", "changedFilesWithAncestor", "clearCache", "clearMocks", "collectCoverage", "color", "colors", "coverage", "detectLeaks", "detectOpenHandles", "errorOnDeprecated", "expand", "findRelatedTests", "forceExit", "init", "injectGlobals", "json", "lastCommit", "listTests", "logHeapUsage", "noStackTrace", "notify", "onlyChanged", "onlyFailures", "passWithNoTests", "resetMocks", "resetModules", "restoreMocks", "runInBand", "runTestsByPath", "showConfig", "silent", "skipFilter", "testLocationInResults", "updateSnapshot", "useStderr", "watchAll", "watchman"];
-/**
- * All the Number options supported by the Stencil CLI
- */
-export declare const NUMBER_CLI_FLAGS: readonly ["port", "maxConcurrency", "testTimeout"];
-/**
- * All the String options supported by the Stencil CLI
- */
-export declare const STRING_CLI_FLAGS: readonly ["address", "config", "docsApi", "docsJson", "emulate", "root", "screenshotConnector", "cacheDirectory", "changedSince", "collectCoverageFrom", "coverageDirectory", "coverageThreshold", "env", "filter", "globalSetup", "globalTeardown", "globals", "haste", "moduleNameMapper", "notifyMode", "outputFile", "preset", "prettierPath", "resolver", "rootDir", "runner", "testEnvironment", "testEnvironmentOptions", "testFailureExitCode", "testNamePattern", "testResultsProcessor", "testRunner", "testSequencer", "testURL", "timers", "transform"];
-export declare const STRING_ARRAY_CLI_FLAGS: readonly ["collectCoverageOnlyFrom", "coveragePathIgnorePatterns", "coverageReporters", "moduleDirectories", "moduleFileExtensions", "modulePathIgnorePatterns", "modulePaths", "projects", "reporters", "roots", "selectProjects", "setupFiles", "setupFilesAfterEnv", "snapshotSerializers", "testMatch", "testPathIgnorePatterns", "testPathPattern", "testRegex", "transformIgnorePatterns", "unmockedModulePathPatterns", "watchPathIgnorePatterns"];
-/**
- * All the CLI arguments which may have string or number values
- *
- * `maxWorkers` is an argument which is used both by Stencil _and_ by Jest,
- * which means that we need to support parsing both string and number values.
- */
-export declare const STRING_NUMBER_CLI_FLAGS: readonly ["maxWorkers"];
-/**
- * All the CLI arguments which may have boolean or string values.
- */
-export declare const BOOLEAN_STRING_CLI_FLAGS: readonly ["headless", "stats"];
-/**
- * All the LogLevel-type options supported by the Stencil CLI
- *
- * This is a bit silly since there's only one such argument atm,
- * but this approach lets us make sure that we're handling all
- * our arguments in a type-safe way.
- */
-export declare const LOG_LEVEL_CLI_FLAGS: readonly ["logLevel"];
-/**
- * A type which gives the members of a `ReadonlyArray<string>` as
- * an enum-like type which can be used for e.g. keys in a `Record`
- * (as in the `AliasMap` type below)
- */
-type ArrayValuesAsUnion<T extends ReadonlyArray<string>> = T[number];
-export type BooleanCLIFlag = ArrayValuesAsUnion<typeof BOOLEAN_CLI_FLAGS>;
-export type StringCLIFlag = ArrayValuesAsUnion<typeof STRING_CLI_FLAGS>;
-export type StringArrayCLIFlag = ArrayValuesAsUnion<typeof STRING_ARRAY_CLI_FLAGS>;
-export type NumberCLIFlag = ArrayValuesAsUnion<typeof NUMBER_CLI_FLAGS>;
-export type StringNumberCLIFlag = ArrayValuesAsUnion<typeof STRING_NUMBER_CLI_FLAGS>;
-export type BooleanStringCLIFlag = ArrayValuesAsUnion<typeof BOOLEAN_STRING_CLI_FLAGS>;
-export type LogCLIFlag = ArrayValuesAsUnion<typeof LOG_LEVEL_CLI_FLAGS>;
-export type KnownCLIFlag = BooleanCLIFlag | StringCLIFlag | StringArrayCLIFlag | NumberCLIFlag | StringNumberCLIFlag | BooleanStringCLIFlag | LogCLIFlag;
-type AliasMap = Partial<Record<string, KnownCLIFlag>>;
-/**
- * For a small subset of CLI options we support a short alias e.g. `'h'` for `'help'`
- */
-export declare const CLI_FLAG_ALIASES: AliasMap;
-/**
- * A regular expression which can be used to match a CLI flag for one of our
- * short aliases.
- */
-export declare const CLI_FLAG_REGEX: RegExp;
-/**
- * Given two types `K` and `T` where `K` extends `ReadonlyArray<string>`,
- * construct a type which maps the strings in `K` as keys to values of type `T`.
- *
- * Because we use types derived this way to construct an interface (`ConfigFlags`)
- * for which we want optional keys, we make all the properties optional (w/ `'?'`)
- * and possibly null.
- */
-type ObjectFromKeys<K extends ReadonlyArray<string>, T> = {
-    [key in K[number]]?: T | null;
-};
-/**
- * Type containing the possible Boolean configuration flags, to be included
- * in ConfigFlags, below
- */
-type BooleanConfigFlags = ObjectFromKeys<typeof BOOLEAN_CLI_FLAGS, boolean>;
-/**
- * Type containing the possible String configuration flags, to be included
- * in ConfigFlags, below
- */
-type StringConfigFlags = ObjectFromKeys<typeof STRING_CLI_FLAGS, string>;
-/**
- * Type containing the possible String Array configuration flags. This is
- * one of the 'constituent types' for `ConfigFlags`.
- */
-type StringArrayConfigFlags = ObjectFromKeys<typeof STRING_ARRAY_CLI_FLAGS, string[]>;
-/**
- * Type containing the possible numeric configuration flags, to be included
- * in ConfigFlags, below
- */
-type NumberConfigFlags = ObjectFromKeys<typeof NUMBER_CLI_FLAGS, number>;
-/**
- * Type containing the configuration flags which may be set to either string
- * or number values.
- */
-type StringNumberConfigFlags = ObjectFromKeys<typeof STRING_NUMBER_CLI_FLAGS, string | number>;
-/**
- * Type containing the configuration flags which may be set to either string
- * or boolean values.
- */
-type BooleanStringConfigFlags = ObjectFromKeys<typeof BOOLEAN_STRING_CLI_FLAGS, boolean | string>;
-/**
- * Type containing the possible LogLevel configuration flags, to be included
- * in ConfigFlags, below
- */
-type LogLevelFlags = ObjectFromKeys<typeof LOG_LEVEL_CLI_FLAGS, LogLevel>;
-/**
- * The configuration flags which can be set by the user on the command line.
- * This interface captures both known arguments (which are enumerated and then
- * parsed according to their types) and unknown arguments which the user may
- * pass at the CLI.
- *
- * Note that this interface is constructed by extending `BooleanConfigFlags`,
- * `StringConfigFlags`, etc. These types are in turn constructed from types
- * extending `ReadonlyArray<string>` which we declare in another module. This
- * allows us to record our known CLI arguments in one place, using a
- * `ReadonlyArray<string>` to get both a type-level representation of what CLI
- * options we support and a runtime list of strings which can be used to match
- * on actual flags passed by the user.
- */
-export interface ConfigFlags extends BooleanConfigFlags, StringConfigFlags, StringArrayConfigFlags, NumberConfigFlags, StringNumberConfigFlags, BooleanStringConfigFlags, LogLevelFlags {
-    task: TaskCommand | null;
-    args: string[];
-    knownArgs: string[];
-    unknownArgs: string[];
-}
-/**
- * Helper function for initializing a `ConfigFlags` object. Provide any overrides
- * for default values and off you go!
- *
- * @param init an object with any overrides for default values
- * @returns a complete CLI flag object
- */
-export declare const createConfigFlags: (init?: Partial<ConfigFlags>) => ConfigFlags;
-export {};