@shell-shock/plugin-upgrade 0.1.0

package/dist/components/upgrade-builtin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-builtin.mjs","names":["code","Show","splitProps","ElseClause","ElseIfClause","FunctionDeclaration","IfStatement","InterfaceDeclaration","VarDeclaration","Spacing","InterfaceMember","TSDoc","TSDocParam","TSDocRemarks","TSDocReturns","TypeDeclaration","BuiltinFile","defu","LocatePackageJsonFunctionDeclaration","_$createComponent","name","doc","children","optional","type","heading","async","parameters","default","returnType","initializer","_$createIntrinsic","condition","LocateLockfileFunctionDeclaration","GetPackageManagerFunctionDeclaration","FetchNpmPackageFunctionDeclaration","GetLatestFunctionDeclaration","InstallFunctionDeclaration","UpgradeBuiltin","props","rest","_$mergeProps","id","description","imports","builtinImports","console","env","when","Boolean"],"sources":["../../src/components/upgrade-builtin.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code, Show, splitProps } from \"@alloy-js/core\";\nimport {\n  ElseClause,\n  ElseIfClause,\n  FunctionDeclaration,\n  IfStatement,\n  InterfaceDeclaration,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport {\n  InterfaceMember,\n  TSDoc,\n  TSDocParam,\n  TSDocRemarks,\n  TSDocReturns,\n  TypeDeclaration\n} from \"@powerlines/plugin-alloy/typescript\";\nimport type { BuiltinFileProps } from \"@powerlines/plugin-alloy/typescript/components/builtin-file\";\nimport { BuiltinFile } from \"@powerlines/plugin-alloy/typescript/components/builtin-file\";\nimport defu from \"defu\";\n\n/**\n * The `locatePackageJson` handler function declaration code for the Shell Shock project.\n */\nexport function LocatePackageJsonFunctionDeclaration() {\n  return (\n    <>\n      <InterfaceDeclaration\n        export\n        name=\"LocatePackageJsonOptions\"\n        doc=\"Options for the `locatePackageJson` handler function.\">\n        <InterfaceMember\n          name=\"cwd\"\n          optional\n          type=\"string\"\n          doc=\"The current working directory to use. If not provided, the process's current working directory will be used.\"\n        />\n      </InterfaceDeclaration>\n      <Spacing />\n      <TSDoc heading=\"Locate the package.json file currently being used by the command-line/workspace.\">\n        <TSDocRemarks>\n          {`This function is used to determine the package.json file currently being used by the command-line/workspace. It can be used in the CLI upgrade command to check if the application is using npm, yarn, or another package manager.`}\n        </TSDocRemarks>\n        <Spacing />\n        <TSDocParam name=\"options\">\n          {`The options for the \\`locatePackageJson\\` function. Currently, there are no options available, but this parameter is included for future extensibility.`}\n        </TSDocParam>\n        <TSDocReturns>\n          {`A promise that resolves to the package.json file currently being used by the command-line/workspace as a string.`}\n        </TSDocReturns>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        async\n        name=\"locatePackageJson\"\n        parameters={[\n          {\n            name: \"options\",\n            type: \"LocatePackageJsonOptions\",\n            default: \"{}\"\n          }\n        ]}\n        returnType=\"string | undefined\">\n        <VarDeclaration\n          let\n          name=\"currentPath\"\n          type=\"string\"\n          initializer={code`options.cwd ?? process.cwd(); `}\n        />\n        <hbr />\n        <VarDeclaration\n          let\n          name=\"parentPath\"\n          initializer={code`resolve(currentPath, \"..\"); `}\n        />\n        <Spacing />\n        {code`while (parentPath !== currentPath && currentPath !== homePath && currentPath !== tempPath) { `}\n        <IfStatement\n          condition={code`existsSync(join(currentPath, \"package.json\"))`}>\n          {code`return join(currentPath, \"package.json\"); `}\n        </IfStatement>\n        <ElseClause>\n          {code`currentPath = pathParent;\n          parentPath = resolve(currentPath, \"..\"); `}\n        </ElseClause>\n        {code` }\n\n        return undefined; `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n\n/**\n * The `locateLockfile` handler function declaration code for the Shell Shock project.\n */\nexport function LocateLockfileFunctionDeclaration() {\n  return (\n    <>\n      <InterfaceDeclaration\n        export\n        name=\"LocateLockfileOptions\"\n        doc=\"Options for the `locateLockfile` handler function.\">\n        <InterfaceMember\n          name=\"cwd\"\n          optional\n          type=\"string\"\n          doc=\"The current working directory to use. If not provided, the process's current working directory will be used.\"\n        />\n      </InterfaceDeclaration>\n      <Spacing />\n      <TSDoc heading=\"Locate the lockfile currently being used by the command-line/workspace.\">\n        <TSDocRemarks>\n          {`This function is used to determine the lockfile currently being used by the command-line/workspace. It can be used in the CLI upgrade command to check if the application is using npm, yarn, or another package manager.`}\n        </TSDocRemarks>\n        <Spacing />\n        <TSDocParam name=\"options\">\n          {`The options for the \\`locateLockfile\\` function. Currently, there are no options available, but this parameter is included for future extensibility.`}\n        </TSDocParam>\n        <TSDocReturns>\n          {`A promise that resolves to the lockfile currently being used by the command-line/workspace as a string.`}\n        </TSDocReturns>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        async\n        name=\"locateLockfile\"\n        parameters={[\n          {\n            name: \"options\",\n            type: \"LocateLockfileOptions\",\n            default: \"{}\"\n          }\n        ]}\n        returnType=\"string | undefined\">\n        <VarDeclaration\n          let\n          name=\"currentPath\"\n          type=\"string\"\n          initializer={code`options.cwd ?? process.cwd(); `}\n        />\n        <hbr />\n        <VarDeclaration\n          let\n          name=\"parentPath\"\n          initializer={code`resolve(currentPath, \"..\"); `}\n        />\n        <Spacing />\n        {code`while (parentPath !== currentPath && currentPath !== homePath && currentPath !== tempPath) { `}\n        <VarDeclaration\n          const\n          name=\"lockfile\"\n          initializer={code`[\n            \"package-lock.json\",\n            \"npm-shrinkwrap.json\",\n            \"yarn.lock\",\n            \"pnpm-lock.yaml\",\n            \"pnpm-workspace.yaml\",\n            \"deno.lock\",\n            \"deno.json\",\n            \"deno.jsonc\",\n            \"bun.lock\",\n            \"bun.lockb\"\n          ].find(lf => existsSync(join(currentPath, lf))); `}\n        />\n        <hbr />\n        <IfStatement condition={code`lockfile`}>\n          {code`return lockfile; `}\n        </IfStatement>\n        <ElseClause>\n          {code`currentPath = pathParent;\n          parentPath = resolve(currentPath, \"..\"); `}\n        </ElseClause>\n        {code` }\n\n        return undefined; `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n\n/**\n * The `getPackageManager` handler function declaration code for the Shell Shock project.\n */\nexport function GetPackageManagerFunctionDeclaration() {\n  return (\n    <>\n      <TypeDeclaration\n        export\n        name=\"GetPackageManagerOptions\"\n        doc=\"Options for the `getPackageManager` handler function.\">{code`LocateLockfileOptions;`}</TypeDeclaration>\n      <Spacing />\n      <TSDoc heading=\"Get the package manager currently being used by the command-line/workspace.\">\n        <TSDocRemarks>\n          {`This function is used to determine the package manager currently being used by the command-line/workspace. It can be used in the CLI upgrade command to check if the application is using npm, yarn, or another package manager.`}\n        </TSDocRemarks>\n        <Spacing />\n        <TSDocParam name=\"options\">\n          {`The options for the \\`getPackageManager\\` function. Currently, there are no options available, but this parameter is included for future extensibility.`}\n        </TSDocParam>\n        <TSDocReturns>\n          {`A promise that resolves to the package manager currently being used by the command-line/workspace as a string.`}\n        </TSDocReturns>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        async\n        name=\"getPackageManager\"\n        parameters={[\n          {\n            name: \"options\",\n            type: \"GetPackageManagerOptions\",\n            default: \"{}\"\n          }\n        ]}\n        returnType={code`Promise<\"npm\" | \"yarn\" | \"deno\" | \"pnpm\" | \"bun\">`}>\n        <VarDeclaration\n          const\n          name=\"userAgent\"\n          type=\"string\"\n          initializer={code`process.env.npm_config_user_agent ?? \"\"; `}\n        />\n        <hbr />\n        <VarDeclaration\n          const\n          name=\"execPath\"\n          type=\"string\"\n          initializer={code`process.env.npm_execpath ?? \"\"; `}\n        />\n        <Spacing />\n        <IfStatement\n          condition={code`userAgent.startsWith(\"yarn\") || execPath.includes(\"yarn\")`}>\n          {code`return \"yarn\"; `}\n        </IfStatement>\n        <ElseIfClause\n          condition={code`userAgent.startsWith(\"pnpm\") || execPath.includes(\"pnpm\")`}>\n          {code`return \"pnpm\"; `}\n        </ElseIfClause>\n        <ElseIfClause\n          condition={code`userAgent.startsWith(\"bun\") || execPath.includes(\"bun\") || typeof Bun !== \"undefined\" || process.versions.bun`}>\n          {code`return \"bun\"; `}\n        </ElseIfClause>\n        <ElseClause>\n          <VarDeclaration\n            const\n            name=\"lockfilePath\"\n            initializer={code`locateLockfile(options); `}\n          />\n          <Spacing />\n          <IfStatement condition={code`lockfilePath === \"yarn.lock\"`}>\n            {code`return \"yarn\"; `}\n          </IfStatement>\n          <ElseIfClause\n            condition={code`lockfilePath === \"deno.lock\" || lockfilePath === \"deno.json\" || lockfilePath === \"deno.jsonc\"`}>\n            {code`return \"deno\"; `}\n          </ElseIfClause>\n          <ElseIfClause\n            condition={code`lockfilePath === \"pnpm-lock.yaml\" || lockfilePath === \"pnpm-workspace.yaml\"`}>\n            {code`return \"pnpm\"; `}\n          </ElseIfClause>\n          <ElseIfClause\n            condition={code`lockfilePath === \"bun.lock\" || lockfilePath === \"bun.lockb\"`}>\n            {code`return \"bun\"; `}\n          </ElseIfClause>\n          <ElseClause>\n            <VarDeclaration\n              const\n              name=\"packageJsonPath\"\n              initializer={code`locatePackageJson(options); `}\n            />\n            <IfStatement\n              condition={code`packageJsonPath && existsSync(packageJsonPath)`}>\n              <VarDeclaration\n                const\n                name=\"packageJson\"\n                initializer={code`JSON.parse(await readFile(packageJsonPath, \"utf8\")); `}\n              />\n              <IfStatement\n                condition={code`packageJson.devEngines?.packageManager?.name && typeof packageJson.devEngines.packageManager.name === \"string\" && [\"npm\", \"yarn\", \"pnpm\", \"deno\", \"bun\"].includes(packageJson.devEngines.packageManager.name)`}>\n                {code`return packageJson.devEngines.packageManager.name; `}\n              </IfStatement>\n              <Spacing />\n              <VarDeclaration\n                const\n                name=\"dependencies\"\n                initializer={code`{\n                ...packageJson.dependencies,\n                ...packageJson.devDependencies,\n                ...packageJson.peerDependencies,\n                ...packageJson.optionalDependencies,\n              }; `}\n              />\n              <IfStatement\n                condition={code`Object.keys(dependencies).some(dep => dep === \"yarn\" || dep.startsWith(\"yarn@\") || dep === \"yarnpkg\" || dep.startsWith(\"yarnpkg@\"))`}>\n                {code`return \"yarn\"; `}\n              </IfStatement>\n              <ElseIfClause\n                condition={code`Object.keys(dependencies).some(dep => dep === \"bun\" || dep.startsWith(\"bun@\"))`}>\n                {code`return \"bun\"; `}\n              </ElseIfClause>\n              <ElseIfClause\n                condition={code`Object.keys(dependencies).some(dep => dep === \"pnpm\" || dep.startsWith(\"pnpm@\"))`}>\n                {code`return \"pnpm\"; `}\n              </ElseIfClause>\n              <ElseIfClause\n                condition={code`Object.keys(dependencies).some(dep => dep === \"deno\" || dep.startsWith(\"deno@\"))`}>\n                {code`return \"deno\"; `}\n              </ElseIfClause>\n            </IfStatement>\n            <Spacing />\n            {code`return \"npm\"; `}\n          </ElseClause>\n        </ElseClause>\n      </FunctionDeclaration>\n    </>\n  );\n}\n\n/**\n * The `fetchNpmPackage` handler function declaration code for the Shell Shock project.\n */\nexport function FetchNpmPackageFunctionDeclaration() {\n  return (\n    <>\n      <InterfaceDeclaration\n        export\n        name=\"NpmPackageMaintainer\"\n        doc=\"Represents a maintainer of an npm package.\">\n        <InterfaceMember\n          name=\"email\"\n          type=\"string\"\n          doc=\"The email of the npm package maintainer.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"username\"\n          type=\"string\"\n          doc=\"The username of the npm package maintainer.\"\n        />\n      </InterfaceDeclaration>\n      <Spacing />\n      <InterfaceDeclaration\n        export\n        name=\"NpmPackageLinks\"\n        doc=\"Represents the links of an npm package.\">\n        <InterfaceMember\n          name=\"homepage\"\n          type=\"string\"\n          optional\n          doc=\"The homepage of the npm package.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"repository\"\n          type=\"string\"\n          optional\n          doc=\"The repository of the npm package.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"bugs\"\n          type=\"string\"\n          optional\n          doc=\"The bugs page of the npm package.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"npm\"\n          type=\"string\"\n          optional\n          doc=\"The npm page of the npm package.\"\n        />\n      </InterfaceDeclaration>\n      <Spacing />\n      <InterfaceDeclaration\n        export\n        name=\"NpmPackage\"\n        doc=\"Represents an npm package.\">\n        <InterfaceMember\n          name=\"name\"\n          type=\"string\"\n          doc=\"The name of the npm package.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"date\"\n          type=\"Date\"\n          doc=\"The date when the npm package was last updated.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"version\"\n          type=\"string\"\n          doc=\"The version of the npm package.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"description\"\n          type=\"string\"\n          optional\n          doc=\"The description of the npm package.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"keywords\"\n          type=\"string[]\"\n          doc=\"A list of keywords associated with the npm package.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"license\"\n          type=\"string\"\n          optional\n          doc=\"The license of the npm package.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"maintainers\"\n          type=\"NpmPackageMaintainer[]\"\n          doc=\"The maintainers of the npm package.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"links\"\n          type=\"NpmPackageLinks\"\n          doc=\"The links of the npm package.\"\n        />\n        <hbr />\n      </InterfaceDeclaration>\n      <Spacing />\n      <InterfaceDeclaration\n        export\n        name=\"NpmPackageSearchResultItem\"\n        doc=\"Represents an npm package search result item.\">\n        <InterfaceMember\n          name=\"package\"\n          type=\"NpmPackage\"\n          doc=\"The npm package details.\"\n        />\n      </InterfaceDeclaration>\n      <Spacing />\n      <InterfaceDeclaration\n        export\n        name=\"NpmPackageSearchResult\"\n        doc=\"Represents an npm package search result.\">\n        <InterfaceMember\n          name=\"objects\"\n          type=\"NpmPackageSearchResultItem[]\"\n          doc=\"The list of npm package search result items.\"\n        />\n      </InterfaceDeclaration>\n      <Spacing />\n      <TSDoc heading=\"Fetch details of an npm package.\">\n        <TSDocRemarks>\n          {`This function is used to fetch an npm package. It can be used in the CLI upgrade command to check if the application is using npm, yarn, or another package manager.`}\n        </TSDocRemarks>\n        <Spacing />\n        <TSDocParam name=\"packageName\">\n          {`The name of the npm package to fetch.`}\n        </TSDocParam>\n        <TSDocReturns>\n          {`A promise that resolves to the npm package details or undefined if the package is not found.`}\n        </TSDocReturns>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        async\n        name=\"fetchNpmPackage\"\n        parameters={[\n          {\n            name: \"packageName\",\n            type: \"string\"\n          }\n        ]}\n        returnType={code`Promise<NpmPackage | undefined>`}>\n        <VarDeclaration\n          const\n          name=\"result\"\n          initializer={code` await fetch(\\`https://registry.npmjs.com/-/v1/search?text=\\${packageName}&size=1\\`).then(res => res.json()) as NpmPackageSearchResult; `}\n        />\n        <hbr />\n        <IfStatement\n          condition={code`result.objects && result.objects.length > 0 && result.objects[0].package && result.objects[0].package.name === packageName`}>\n          {code`return result.objects[0].package; `}\n        </IfStatement>\n        <ElseClause>{code`return undefined; `}</ElseClause>\n      </FunctionDeclaration>\n    </>\n  );\n}\n\n/**\n * The `getLatest` handler function declaration code for the Shell Shock project.\n */\nexport function GetLatestFunctionDeclaration() {\n  return (\n    <>\n      <TSDoc heading=\"Get the latest version of the application from the npm registry.\">\n        <TSDocRemarks>\n          {`This function is used to retrieve the latest version of the application from the npm registry. It can be used in the CLI upgrade command to check if there is a newer version of the application available.`}\n        </TSDocRemarks>\n        <Spacing />\n        <TSDocParam name=\"packageName\">\n          {`The name of the npm package to fetch.`}\n        </TSDocParam>\n        <TSDocReturns>\n          {`A promise that resolves to the latest version of the specified npm package as a string.`}\n        </TSDocReturns>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        async\n        name=\"getLatest\"\n        parameters={[\n          {\n            name: \"packageName\",\n            type: \"string\"\n          }\n        ]}>\n        <VarDeclaration\n          const\n          name=\"package\"\n          initializer={code`await fetchNpmPackage(packageName); `}\n        />\n        <Spacing />\n        {code`return package?.version; `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n\n/**\n * The `install` handler function declaration code for the Shell Shock project.\n */\nexport function InstallFunctionDeclaration() {\n  return (\n    <>\n      <InterfaceDeclaration\n        export\n        name=\"InstallOptions\"\n        doc=\"Options for the `install` handler function.\">\n        <InterfaceMember\n          name=\"stdout\"\n          optional\n          type=\"(string) => void\"\n          doc=\"A callback function that is called with the stdout output of the command.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"stderr\"\n          optional\n          type=\"(string) => void\"\n          doc=\"A callback function that is called with the stderr output of the command.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"color\"\n          optional\n          type=\"boolean\"\n          doc=\"Whether to enable color output in the command. If not provided, color output will be enabled by default.\"\n        />\n      </InterfaceDeclaration>\n      <Spacing />\n      <TSDoc heading=\"Install the application dependencies.\">\n        <TSDocRemarks>\n          {`This function is used to install the application dependencies. It can be used in the CLI upgrade command to ensure that all necessary dependencies are installed.`}\n        </TSDocRemarks>\n        <Spacing />\n        <TSDocParam name=\"options\">\n          {`The options for the \\`install\\` function. Currently, there are no options available, but this parameter is included for future extensibility.`}\n        </TSDocParam>\n        <TSDocReturns>\n          {`A promise that resolves when the installation of dependencies is complete.`}\n        </TSDocReturns>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        async\n        name=\"install\"\n        parameters={[\n          {\n            name: \"options\",\n            type: \"InstallOptions\",\n            default: \"{}\"\n          }\n        ]}\n        returnType=\"Promise<string>\">\n        <VarDeclaration\n          const\n          name=\"packageManager\"\n          initializer={code`getPackageManager(); `}\n        />\n        <hbr />\n        <VarDeclaration let name=\"output\" initializer={code`\"\"; `} />\n        <hbr />\n        {code`try {\n            // await spawn(\n            //   \\`\\${packageManager}\\${isWindows && packageManager !== \"bun\" ? \".cmd\" : \"\"}\\`,\n            //   [\"install\"],\n            //   {\n            //     stdout: (data: string) => {\n            //       options.stdout?.(data);\n            //       output += data;\n            //     },\n            //     stderr: (data: string) => {\n            //       options.stderr?.(data);\n            //     },\n            //   },\n            //   {\n            //     cwd: options.cwd ?? process.cwd(),\n            //     env: {\n            //       ...process.env,\n            //       ...(options.color !== false ? { FORCE_COLOR: true } : null),\n            //       // With spawn, pnpm install will fail with ERR_PNPM_PEER_DEP_ISSUES  Unmet peer dependencies.\n            //       // When pnpm install is run directly from the terminal, this error does not occur.\n            //       // When pnpm install is run from a simple spawn script, this error does not occur.\n            //       // The issue only seems to be when pnpm install is executed from npm-check-updates, but it's not clear what configuration or environmental factors are causing this.\n            //       // For now, turn off strict-peer-dependencies on pnpm auto-install.\n            //       // See: https://github.com/raineorshine/npm-check-updates/issues/1191\n            //       ...(packageManager === 'pnpm' ? { npm_config_strict_peer_dependencies: false } : null),\n            //     },\n            //   },\n            // );\n          } catch (err) {\n            console.error(\"Error executing install command:\", err);\n            throw err;\n          }\n          `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n\nexport interface UpgradeBuiltinProps extends Omit<\n  BuiltinFileProps,\n  \"id\" | \"description\"\n> {}\n\n/**\n * A built-in upgrade module for Shell Shock.\n */\nexport function UpgradeBuiltin(props: UpgradeBuiltinProps) {\n  const [{ children }, rest] = splitProps(props, [\"children\"]);\n\n  return (\n    <BuiltinFile\n      id=\"upgrade\"\n      description=\"A collection of application upgrade utility functions for Shell Shock.\"\n      {...rest}\n      imports={defu(rest.imports ?? {}, {\n        \"node:os\": \"os\",\n        \"node:path\": [\"join\", \"resolve\"],\n        \"node:fs\": [\"existsSync\"],\n        \"node:fs/promises\": [\"readFile\", \"writeFile\"],\n        \"node:process\": \"process\"\n      })}\n      builtinImports={defu(rest.builtinImports ?? {}, {\n        console: [\"error\", \"verbose\", \"writeLine\"],\n        env: [\"paths\", \"isWindows\"]\n      })}>\n      <VarDeclaration\n        const\n        name=\"homePath\"\n        type=\"string\"\n        initializer={code`os.homedir(); `}\n      />\n      <Spacing />\n      <VarDeclaration\n        const\n        name=\"tempPath\"\n        type=\"string\"\n        initializer={code`os.tmpdir(); `}\n      />\n      <Spacing />\n      <LocateLockfileFunctionDeclaration />\n      <Spacing />\n      <GetPackageManagerFunctionDeclaration />\n      <Spacing />\n      <FetchNpmPackageFunctionDeclaration />\n      <Spacing />\n      <GetLatestFunctionDeclaration />\n      <Spacing />\n      <InstallFunctionDeclaration />\n      <Spacing />\n      <Show when={Boolean(children)}>{children}</Show>\n    </BuiltinFile>\n  );\n}\n"],"mappings":"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"}

package/dist/components/upgrade-command.cjs

@@ -0,0 +1,96 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let __alloy_js_core = require("@alloy-js/core");
+let __alloy_js_typescript = require("@alloy-js/typescript");
+let __powerlines_plugin_alloy_typescript = require("@powerlines/plugin-alloy/typescript");
+let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let __powerlines_plugin_alloy_core = require("@powerlines/plugin-alloy/core");
+let __powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
+let __powerlines_plugin_alloy_typescript_components_tsdoc = require("@powerlines/plugin-alloy/typescript/components/tsdoc");
+let __stryke_path = require("@stryke/path");
+
+//#region src/components/upgrade-command.tsx
+/**
+* The Upgrade command's handler wrapper for the Shell Shock project.
+*/
+function UpgradeCommand() {
+	const context = (0, __powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript.TypescriptFile, {
+		get path() {
+			return (0, __stryke_path.joinPaths)(context.entryPath, "upgrade", "command.ts");
+		},
+		imports: {
+			"node:os": ["os"],
+			"node:fs/promises": ["readFile", "writeFile"]
+		},
+		builtinImports: { console: [
+			"colors",
+			"writeLine",
+			"success",
+			"warn",
+			"stripAnsi"
+		] },
+		get children() {
+			return [
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { heading: "Options for the Upgrade command." }),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.InterfaceDeclaration, {
+					"export": true,
+					name: "UpgradeOptions",
+					get children() {
+						return [
+							(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+								heading: "Whether to upgrade to the latest version.",
+								get children() {
+									return [(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocRemarks, { children: `If set to \`true\`, the command will attempt to upgrade to the latest version. This option takes precedence over the \`version\` option.` }), (0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocDefaultValue, {
+										get type() {
+											return __powerlines_deepkit_vendor_type.ReflectionKind.boolean;
+										},
+										defaultValue: false
+									})];
+								}
+							}),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript.InterfaceMember, {
+								name: "latest",
+								optional: true,
+								type: "boolean"
+							}),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core.Spacing, {}),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+								heading: "A specific application version to upgrade to.",
+								get children() {
+									return [(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocRemarks, { children: `The command will attempt to upgrade to the specified version. The version should be a valid semantic version string, or \`latest\` to upgrade to the latest version.` }), (0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocDefaultValue, {
+										get type() {
+											return __powerlines_deepkit_vendor_type.ReflectionKind.string;
+										},
+										defaultValue: "latest"
+									})];
+								}
+							}),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript.InterfaceMember, {
+								name: "version",
+								optional: true,
+								type: "string"
+							})
+						];
+					}
+				}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core.Spacing, {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { heading: "Handler logic for the \\`upgrade\\` command." }),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.FunctionDeclaration, {
+					"export": true,
+					"default": true,
+					async: true,
+					name: "handler",
+					parameters: [{
+						name: "options",
+						type: "UpgradeOptions"
+					}],
+					children: __alloy_js_core.code` return;`
+				})
+			];
+		}
+	});
+}
+
+//#endregion
+exports.UpgradeCommand = UpgradeCommand;

package/dist/components/upgrade-command.d.cts

@@ -0,0 +1,10 @@
+import * as _alloy_js_core0 from "@alloy-js/core";
+
+//#region src/components/upgrade-command.d.ts
+/**
+ * The Upgrade command's handler wrapper for the Shell Shock project.
+ */
+declare function UpgradeCommand(): _alloy_js_core0.Children;
+//#endregion
+export { UpgradeCommand };
+//# sourceMappingURL=upgrade-command.d.cts.map

package/dist/components/upgrade-command.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-command.d.cts","names":[],"sources":["../../src/components/upgrade-command.tsx"],"sourcesContent":[],"mappings":";;;;;;AAyCgB,iBAAA,cAAA,CAAA,CAAc,EAAA,eAAA,CAAA,QAAA"}

package/dist/components/upgrade-command.d.mts

@@ -0,0 +1,10 @@
+import * as _alloy_js_core0 from "@alloy-js/core";
+
+//#region src/components/upgrade-command.d.ts
+/**
+ * The Upgrade command's handler wrapper for the Shell Shock project.
+ */
+declare function UpgradeCommand(): _alloy_js_core0.Children;
+//#endregion
+export { UpgradeCommand };
+//# sourceMappingURL=upgrade-command.d.mts.map

package/dist/components/upgrade-command.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-command.d.mts","names":[],"sources":["../../src/components/upgrade-command.tsx"],"sourcesContent":[],"mappings":";;;;;;AAyCgB,iBAAA,cAAA,CAAA,CAAc,EAAA,eAAA,CAAA,QAAA"}

package/dist/components/upgrade-command.mjs

@@ -0,0 +1,96 @@
+import { createComponent } from "@alloy-js/core/jsx-runtime";
+import { code } from "@alloy-js/core";
+import { FunctionDeclaration, InterfaceDeclaration } from "@alloy-js/typescript";
+import { InterfaceMember, TypescriptFile } from "@powerlines/plugin-alloy/typescript";
+import { ReflectionKind } from "@powerlines/deepkit/vendor/type";
+import { Spacing } from "@powerlines/plugin-alloy/core";
+import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
+import { TSDoc as TSDoc$1, TSDocDefaultValue, TSDocRemarks as TSDocRemarks$1 } from "@powerlines/plugin-alloy/typescript/components/tsdoc";
+import { joinPaths } from "@stryke/path";
+
+//#region src/components/upgrade-command.tsx
+/**
+* The Upgrade command's handler wrapper for the Shell Shock project.
+*/
+function UpgradeCommand() {
+	const context = usePowerlines();
+	return createComponent(TypescriptFile, {
+		get path() {
+			return joinPaths(context.entryPath, "upgrade", "command.ts");
+		},
+		imports: {
+			"node:os": ["os"],
+			"node:fs/promises": ["readFile", "writeFile"]
+		},
+		builtinImports: { console: [
+			"colors",
+			"writeLine",
+			"success",
+			"warn",
+			"stripAnsi"
+		] },
+		get children() {
+			return [
+				createComponent(TSDoc$1, { heading: "Options for the Upgrade command." }),
+				createComponent(InterfaceDeclaration, {
+					"export": true,
+					name: "UpgradeOptions",
+					get children() {
+						return [
+							createComponent(TSDoc$1, {
+								heading: "Whether to upgrade to the latest version.",
+								get children() {
+									return [createComponent(TSDocRemarks$1, { children: `If set to \`true\`, the command will attempt to upgrade to the latest version. This option takes precedence over the \`version\` option.` }), createComponent(TSDocDefaultValue, {
+										get type() {
+											return ReflectionKind.boolean;
+										},
+										defaultValue: false
+									})];
+								}
+							}),
+							createComponent(InterfaceMember, {
+								name: "latest",
+								optional: true,
+								type: "boolean"
+							}),
+							createComponent(Spacing, {}),
+							createComponent(TSDoc$1, {
+								heading: "A specific application version to upgrade to.",
+								get children() {
+									return [createComponent(TSDocRemarks$1, { children: `The command will attempt to upgrade to the specified version. The version should be a valid semantic version string, or \`latest\` to upgrade to the latest version.` }), createComponent(TSDocDefaultValue, {
+										get type() {
+											return ReflectionKind.string;
+										},
+										defaultValue: "latest"
+									})];
+								}
+							}),
+							createComponent(InterfaceMember, {
+								name: "version",
+								optional: true,
+								type: "string"
+							})
+						];
+					}
+				}),
+				createComponent(Spacing, {}),
+				createComponent(TSDoc$1, { heading: "Handler logic for the \\`upgrade\\` command." }),
+				createComponent(FunctionDeclaration, {
+					"export": true,
+					"default": true,
+					async: true,
+					name: "handler",
+					parameters: [{
+						name: "options",
+						type: "UpgradeOptions"
+					}],
+					children: code` return;`
+				})
+			];
+		}
+	});
+}
+
+//#endregion
+export { UpgradeCommand };
+//# sourceMappingURL=upgrade-command.mjs.map

package/dist/components/upgrade-command.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-command.mjs","names":["code","FunctionDeclaration","InterfaceDeclaration","ReflectionKind","Spacing","usePowerlines","InterfaceMember","TypescriptFile","TSDoc","TSDocDefaultValue","TSDocRemarks","joinPaths","UpgradeCommand","context","_$createComponent","path","entryPath","imports","builtinImports","console","children","heading","name","type","boolean","defaultValue","optional","string","async","parameters"],"sources":["../../src/components/upgrade-command.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code } from \"@alloy-js/core\";\nimport {\n  FunctionDeclaration,\n  InterfaceDeclaration\n} from \"@alloy-js/typescript\";\nimport { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport {\n  InterfaceMember,\n  TypescriptFile\n} from \"@powerlines/plugin-alloy/typescript\";\nimport {\n  TSDoc,\n  TSDocDefaultValue,\n  TSDocRemarks\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport { joinPaths } from \"@stryke/path\";\nimport type { UpgradePluginContext } from \"../types/plugin\";\n\n/**\n * The Upgrade command's handler wrapper for the Shell Shock project.\n */\nexport function UpgradeCommand() {\n  const context = usePowerlines<UpgradePluginContext>();\n\n  return (\n    <TypescriptFile\n      path={joinPaths(context.entryPath, \"upgrade\", \"command.ts\")}\n      imports={{\n        \"node:os\": [\"os\"],\n        \"node:fs/promises\": [\"readFile\", \"writeFile\"]\n      }}\n      builtinImports={{\n        console: [\"colors\", \"writeLine\", \"success\", \"warn\", \"stripAnsi\"]\n      }}>\n      <TSDoc heading=\"Options for the Upgrade command.\" />\n      <InterfaceDeclaration export name=\"UpgradeOptions\">\n        <TSDoc heading=\"Whether to upgrade to the latest version.\">\n          <TSDocRemarks>{`If set to \\`true\\`, the command will attempt to upgrade to the latest version. This option takes precedence over the \\`version\\` option.`}</TSDocRemarks>\n          <TSDocDefaultValue\n            type={ReflectionKind.boolean}\n            defaultValue={false}\n          />\n        </TSDoc>\n        <InterfaceMember name=\"latest\" optional type=\"boolean\" />\n        <Spacing />\n        <TSDoc heading=\"A specific application version to upgrade to.\">\n          <TSDocRemarks>{`The command will attempt to upgrade to the specified version. The version should be a valid semantic version string, or \\`latest\\` to upgrade to the latest version.`}</TSDocRemarks>\n          <TSDocDefaultValue\n            type={ReflectionKind.string}\n            defaultValue=\"latest\"\n          />\n        </TSDoc>\n        <InterfaceMember name=\"version\" optional type=\"string\" />\n      </InterfaceDeclaration>\n      <Spacing />\n      <TSDoc heading=\"Handler logic for the \\`upgrade\\` command.\"></TSDoc>\n      <FunctionDeclaration\n        export\n        default\n        async\n        name=\"handler\"\n        parameters={[{ name: \"options\", type: \"UpgradeOptions\" }]}>\n        {code` return;`}\n      </FunctionDeclaration>\n    </TypescriptFile>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;AAyCA,SAAgBY,iBAAiB;CAC/B,MAAMC,UAAUR,eAAqC;AAErD,QAAAS,gBACGP,gBAAc;EAAA,IACbQ,OAAI;AAAA,UAAEJ,UAAUE,QAAQG,WAAW,WAAW,aAAa;;EAC3DC,SAAS;GACP,WAAW,CAAC,KAAK;GACjB,oBAAoB,CAAC,YAAY,YAAW;GAC7C;EACDC,gBAAgB,EACdC,SAAS;GAAC;GAAU;GAAa;GAAW;GAAQ;GAAW,EAChE;EAAA,IAAAC,WAAA;AAAA,UAAA;IAAAN,gBACAN,SAAK,EAACa,SAAO,oCAAA,CAAA;IAAAP,gBACbZ,sBAAoB;KAAA,UAAA;KAAQoB,MAAI;KAAA,IAAAF,WAAA;AAAA,aAAA;OAAAN,gBAC9BN,SAAK;QAACa,SAAO;QAAA,IAAAD,WAAA;AAAA,gBAAA,CAAAN,gBACXJ,gBAAY,EAAAU,UAAE,4IAA0I,CAAA,EAAAN,gBACxJL,mBAAiB;UAAA,IAChBc,OAAI;AAAA,kBAAEpB,eAAeqB;;UACrBC,cAAc;UAAK,CAAA,CAAA;;QAAA,CAAA;OAAAX,gBAGtBR,iBAAe;QAACgB,MAAI;QAAUI,UAAQ;QAACH,MAAI;QAAA,CAAA;OAAAT,gBAC3CV,SAAO,EAAA,CAAA;OAAAU,gBACPN,SAAK;QAACa,SAAO;QAAA,IAAAD,WAAA;AAAA,gBAAA,CAAAN,gBACXJ,gBAAY,EAAAU,UAAE,wKAAsK,CAAA,EAAAN,gBACpLL,mBAAiB;UAAA,IAChBc,OAAI;AAAA,kBAAEpB,eAAewB;;UACrBF,cAAY;UAAA,CAAA,CAAA;;QAAA,CAAA;OAAAX,gBAGfR,iBAAe;QAACgB,MAAI;QAAWI,UAAQ;QAACH,MAAI;QAAA,CAAA;OAAA;;KAAA,CAAA;IAAAT,gBAE9CV,SAAO,EAAA,CAAA;IAAAU,gBACPN,SAAK,EAACa,SAAO,gDAAA,CAAA;IAAAP,gBACbb,qBAAmB;KAAA,UAAA;KAAA,WAAA;KAGlB2B,OAAK;KACLN,MAAI;KACJO,YAAY,CAAC;MAAEP,MAAM;MAAWC,MAAM;MAAkB,CAAC;KAAAH,UACxDpB,IAAI;KAAU,CAAA;IAAA;;EAAA,CAAA"}

package/dist/index.cjs

@@ -0,0 +1,51 @@
+Object.defineProperty(exports, '__esModule', { value: true });
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const require_components_upgrade_builtin = require('./components/upgrade-builtin.cjs');
+const require_components_upgrade_command = require('./components/upgrade-command.cjs');
+require('./components/index.cjs');
+let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let __powerlines_plugin_alloy_render = require("@powerlines/plugin-alloy/render");
+let __shell_shock_core_plugin_utils = require("@shell-shock/core/plugin-utils");
+let __stryke_path_join = require("@stryke/path/join");
+
+//#region src/index.tsx
+/**
+* The Upgrade - Shell Shock plugin to add version check functionality and upgrade commands to a Shell Shock application.
+*/
+const plugin = (options = {}) => {
+	return {
+		name: "shell-shock:upgrade",
+		config() {
+			this.debug("Providing default configuration for the Shell Shock `upgrade` plugin.");
+			return { upgrade: options };
+		},
+		configResolved() {
+			this.debug("Adding the CLI upgrade commands to the application context.");
+			this.inputs ??= [];
+			if (this.inputs.some((input) => input.id === "upgrade")) this.info("The `upgrade` command already exists in the commands list. If you would like the upgrade command to be managed by the `@shell-shock/plugin-upgrade` package, please remove or rename the command.");
+			else this.inputs.push({
+				id: "upgrade",
+				name: "upgrade",
+				alias: ["up", "update"],
+				path: "upgrade",
+				segments: ["upgrade"],
+				title: "Upgrade",
+				description: `A command for checking and upgrading the version of the ${(0, __shell_shock_core_plugin_utils.getAppTitle)(this)}.`,
+				entry: {
+					file: (0, __stryke_path_join.joinPaths)(this.entryPath, "upgrade", "command.ts"),
+					input: { file: (0, __stryke_path_join.joinPaths)(this.entryPath, "upgrade", "command.ts") }
+				},
+				isVirtual: false
+			});
+		},
+		async prepare() {
+			this.debug("Rendering upgrade built-in and command modules for the Shell Shock `upgrade` plugin.");
+			return (0, __powerlines_plugin_alloy_render.render)(this, [(0, __alloy_js_core_jsx_runtime.createComponent)(require_components_upgrade_builtin.UpgradeBuiltin, {}), (0, __alloy_js_core_jsx_runtime.createComponent)(require_components_upgrade_command.UpgradeCommand, {})]);
+		}
+	};
+};
+var src_default = plugin;
+
+//#endregion
+exports.default = src_default;
+exports.plugin = plugin;

package/dist/index.d.cts

@@ -0,0 +1,12 @@
+import { UpgradePluginContext, UpgradePluginOptions } from "./types/plugin.cjs";
+import { Plugin } from "powerlines";
+
+//#region src/index.d.ts
+
+/**
+ * The Upgrade - Shell Shock plugin to add version check functionality and upgrade commands to a Shell Shock application.
+ */
+declare const plugin: <TContext extends UpgradePluginContext = UpgradePluginContext>(options?: UpgradePluginOptions) => Plugin<TContext>;
+//#endregion
+export { plugin as default, plugin };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.tsx"],"sourcesContent":[],"mappings":";;;;;;;AA+BA;AACmB,cADN,MACM,EAAA,CAAA,iBAAA,oBAAA,GAAuB,oBAAvB,CAAA,CAAA,OAAA,CAAA,EAER,oBAFQ,EAAA,GAGhB,MAHgB,CAGT,QAHS,CAAA"}

package/dist/index.d.mts

@@ -0,0 +1,12 @@
+import { UpgradePluginContext, UpgradePluginOptions } from "./types/plugin.mjs";
+import { Plugin } from "powerlines";
+
+//#region src/index.d.ts
+
+/**
+ * The Upgrade - Shell Shock plugin to add version check functionality and upgrade commands to a Shell Shock application.
+ */
+declare const plugin: <TContext extends UpgradePluginContext = UpgradePluginContext>(options?: UpgradePluginOptions) => Plugin<TContext>;
+//#endregion
+export { plugin as default, plugin };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.tsx"],"sourcesContent":[],"mappings":";;;;;;;AA+BA;AACmB,cADN,MACM,EAAA,CAAA,iBAAA,oBAAA,GAAuB,oBAAvB,CAAA,CAAA,OAAA,CAAA,EAER,oBAFQ,EAAA,GAGhB,MAHgB,CAGT,QAHS,CAAA"}

package/dist/index.mjs

@@ -0,0 +1,49 @@
+import { UpgradeBuiltin } from "./components/upgrade-builtin.mjs";
+import { UpgradeCommand } from "./components/upgrade-command.mjs";
+import "./components/index.mjs";
+import { createComponent } from "@alloy-js/core/jsx-runtime";
+import { render } from "@powerlines/plugin-alloy/render";
+import { getAppTitle } from "@shell-shock/core/plugin-utils";
+import { joinPaths } from "@stryke/path/join";
+
+//#region src/index.tsx
+/**
+* The Upgrade - Shell Shock plugin to add version check functionality and upgrade commands to a Shell Shock application.
+*/
+const plugin = (options = {}) => {
+	return {
+		name: "shell-shock:upgrade",
+		config() {
+			this.debug("Providing default configuration for the Shell Shock `upgrade` plugin.");
+			return { upgrade: options };
+		},
+		configResolved() {
+			this.debug("Adding the CLI upgrade commands to the application context.");
+			this.inputs ??= [];
+			if (this.inputs.some((input) => input.id === "upgrade")) this.info("The `upgrade` command already exists in the commands list. If you would like the upgrade command to be managed by the `@shell-shock/plugin-upgrade` package, please remove or rename the command.");
+			else this.inputs.push({
+				id: "upgrade",
+				name: "upgrade",
+				alias: ["up", "update"],
+				path: "upgrade",
+				segments: ["upgrade"],
+				title: "Upgrade",
+				description: `A command for checking and upgrading the version of the ${getAppTitle(this)}.`,
+				entry: {
+					file: joinPaths(this.entryPath, "upgrade", "command.ts"),
+					input: { file: joinPaths(this.entryPath, "upgrade", "command.ts") }
+				},
+				isVirtual: false
+			});
+		},
+		async prepare() {
+			this.debug("Rendering upgrade built-in and command modules for the Shell Shock `upgrade` plugin.");
+			return render(this, [createComponent(UpgradeBuiltin, {}), createComponent(UpgradeCommand, {})]);
+		}
+	};
+};
+var src_default = plugin;
+
+//#endregion
+export { src_default as default, plugin };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["render","getAppTitle","joinPaths","UpgradeBuiltin","UpgradeCommand","plugin","options","name","config","debug","upgrade","configResolved","inputs","some","input","id","info","push","alias","path","segments","title","description","entry","file","entryPath","isVirtual","prepare","_$createComponent"],"sources":["../src/index.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport type { Plugin } from \"powerlines\";\nimport { UpgradeBuiltin, UpgradeCommand } from \"./components\";\nimport type {\n  UpgradePluginContext,\n  UpgradePluginOptions\n} from \"./types/plugin\";\n\n/**\n * The Upgrade - Shell Shock plugin to add version check functionality and upgrade commands to a Shell Shock application.\n */\nexport const plugin = <\n  TContext extends UpgradePluginContext = UpgradePluginContext\n>(\n  options: UpgradePluginOptions = {}\n): Plugin<TContext> => {\n  return {\n    name: \"shell-shock:upgrade\",\n    config() {\n      this.debug(\n        \"Providing default configuration for the Shell Shock `upgrade` plugin.\"\n      );\n\n      return {\n        upgrade: options\n      };\n    },\n    configResolved() {\n      this.debug(\"Adding the CLI upgrade commands to the application context.\");\n\n      this.inputs ??= [];\n      if (this.inputs.some(input => input.id === \"upgrade\")) {\n        this.info(\n          \"The `upgrade` command already exists in the commands list. If you would like the upgrade command to be managed by the `@shell-shock/plugin-upgrade` package, please remove or rename the command.\"\n        );\n      } else {\n        this.inputs.push({\n          id: \"upgrade\",\n          name: \"upgrade\",\n          alias: [\"up\", \"update\"],\n          path: \"upgrade\",\n          segments: [\"upgrade\"],\n          title: \"Upgrade\",\n          description: `A command for checking and upgrading the version of the ${getAppTitle(\n            this\n          )}.`,\n          entry: {\n            file: joinPaths(this.entryPath, \"upgrade\", \"command.ts\"),\n            input: {\n              file: joinPaths(this.entryPath, \"upgrade\", \"command.ts\")\n            }\n          },\n          isVirtual: false\n        });\n      }\n    },\n    async prepare() {\n      this.debug(\n        \"Rendering upgrade built-in and command modules for the Shell Shock `upgrade` plugin.\"\n      );\n\n      return render(\n        this,\n        <>\n          <UpgradeBuiltin />\n          <UpgradeCommand />\n        </>\n      );\n    }\n  };\n};\n\nexport default plugin;\n"],"mappings":";;;;;;;;;;;;AA+BA,MAAaK,UAGXC,UAAgC,EAAE,KACb;AACrB,QAAO;EACLC,MAAM;EACNC,SAAS;AACP,QAAKC,MACH,wEACD;AAED,UAAO,EACLC,SAASJ,SACV;;EAEHK,iBAAiB;AACf,QAAKF,MAAM,8DAA8D;AAEzE,QAAKG,WAAW,EAAE;AAClB,OAAI,KAAKA,OAAOC,MAAKC,UAASA,MAAMC,OAAO,UAAU,CACnD,MAAKC,KACH,oMACD;OAED,MAAKJ,OAAOK,KAAK;IACfF,IAAI;IACJR,MAAM;IACNW,OAAO,CAAC,MAAM,SAAS;IACvBC,MAAM;IACNC,UAAU,CAAC,UAAU;IACrBC,OAAO;IACPC,aAAa,2DAA2DrB,YACtE,KACD,CAAA;IACDsB,OAAO;KACLC,MAAMtB,UAAU,KAAKuB,WAAW,WAAW,aAAa;KACxDX,OAAO,EACLU,MAAMtB,UAAU,KAAKuB,WAAW,WAAW,aAAY,EACzD;KACD;IACDC,WAAW;IACZ,CAAC;;EAGN,MAAMC,UAAU;AACd,QAAKlB,MACH,uFACD;AAED,UAAOT,OACL,MAAI,CAAA4B,gBAEDzB,gBAAc,EAAA,CAAA,EAAAyB,gBACdxB,gBAAc,EAAA,CAAA,CAEnB,CAAC;;EAEJ;;AAGH,kBAAeC"}

package/dist/types/index.cjs

@@ -0,0 +1,4 @@
+const require_types_package_manager = require('./package-manager.cjs');
+
+exports.PACKAGE_MANAGERS = require_types_package_manager.PACKAGE_MANAGERS;
+exports.PACKAGE_MANAGER_LOCKFILE_MAP = require_types_package_manager.PACKAGE_MANAGER_LOCKFILE_MAP;

package/dist/types/index.d.cts

@@ -0,0 +1,3 @@
+import { UpgradePluginContext, UpgradePluginOptions, UpgradePluginResolvedConfig, UpgradePluginUserConfig } from "./plugin.cjs";
+import { PACKAGE_MANAGERS, PACKAGE_MANAGER_LOCKFILE_MAP, PackageManager } from "./package-manager.cjs";
+export { PACKAGE_MANAGERS, PACKAGE_MANAGER_LOCKFILE_MAP, PackageManager, UpgradePluginContext, UpgradePluginOptions, UpgradePluginResolvedConfig, UpgradePluginUserConfig };

package/dist/types/index.d.mts

@@ -0,0 +1,3 @@
+import { UpgradePluginContext, UpgradePluginOptions, UpgradePluginResolvedConfig, UpgradePluginUserConfig } from "./plugin.mjs";
+import { PACKAGE_MANAGERS, PACKAGE_MANAGER_LOCKFILE_MAP, PackageManager } from "./package-manager.mjs";
+export { PACKAGE_MANAGERS, PACKAGE_MANAGER_LOCKFILE_MAP, PackageManager, UpgradePluginContext, UpgradePluginOptions, UpgradePluginResolvedConfig, UpgradePluginUserConfig };

package/dist/types/index.mjs

@@ -0,0 +1,3 @@
+import { PACKAGE_MANAGERS, PACKAGE_MANAGER_LOCKFILE_MAP } from "./package-manager.mjs";
+
+export { PACKAGE_MANAGERS, PACKAGE_MANAGER_LOCKFILE_MAP };

package/dist/types/package-manager.cjs

@@ -0,0 +1,20 @@
+
+//#region src/types/package-manager.ts
+const PACKAGE_MANAGERS = [
+	"npm",
+	"yarn",
+	"pnpm",
+	"deno",
+	"bun"
+];
+const PACKAGE_MANAGER_LOCKFILE_MAP = {
+	"package-lock": "npm",
+	yarn: "yarn",
+	"pnpm-lock": "pnpm",
+	deno: "deno",
+	bun: "bun"
+};
+
+//#endregion
+exports.PACKAGE_MANAGERS = PACKAGE_MANAGERS;
+exports.PACKAGE_MANAGER_LOCKFILE_MAP = PACKAGE_MANAGER_LOCKFILE_MAP;

package/dist/types/package-manager.d.cts

@@ -0,0 +1,7 @@
+//#region src/types/package-manager.d.ts
+type PackageManager = "npm" | "yarn" | "pnpm" | "deno" | "bun";
+declare const PACKAGE_MANAGERS: readonly PackageManager[];
+declare const PACKAGE_MANAGER_LOCKFILE_MAP: Record<string, PackageManager>;
+//#endregion
+export { PACKAGE_MANAGERS, PACKAGE_MANAGER_LOCKFILE_MAP, PackageManager };
+//# sourceMappingURL=package-manager.d.cts.map

package/dist/types/package-manager.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.d.cts","names":[],"sources":["../../src/types/package-manager.ts"],"sourcesContent":[],"mappings":";KAkBY,cAAA;AAAA,cAEC,gBAFa,EAAA,SAEc,cAFd,EAAA;AAEb,cAQA,4BARyC,EAQX,MARW,CAAA,MAAA,EAQI,cARJ,CAAA"}

package/dist/types/package-manager.d.mts

@@ -0,0 +1,7 @@
+//#region src/types/package-manager.d.ts
+type PackageManager = "npm" | "yarn" | "pnpm" | "deno" | "bun";
+declare const PACKAGE_MANAGERS: readonly PackageManager[];
+declare const PACKAGE_MANAGER_LOCKFILE_MAP: Record<string, PackageManager>;
+//#endregion
+export { PACKAGE_MANAGERS, PACKAGE_MANAGER_LOCKFILE_MAP, PackageManager };
+//# sourceMappingURL=package-manager.d.mts.map

package/dist/types/package-manager.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.d.mts","names":[],"sources":["../../src/types/package-manager.ts"],"sourcesContent":[],"mappings":";KAkBY,cAAA;AAAA,cAEC,gBAFa,EAAA,SAEc,cAFd,EAAA;AAEb,cAQA,4BARyC,EAQX,MARW,CAAA,MAAA,EAQI,cARJ,CAAA"}

package/dist/types/package-manager.mjs

@@ -0,0 +1,19 @@
+//#region src/types/package-manager.ts
+const PACKAGE_MANAGERS = [
+	"npm",
+	"yarn",
+	"pnpm",
+	"deno",
+	"bun"
+];
+const PACKAGE_MANAGER_LOCKFILE_MAP = {
+	"package-lock": "npm",
+	yarn: "yarn",
+	"pnpm-lock": "pnpm",
+	deno: "deno",
+	bun: "bun"
+};
+
+//#endregion
+export { PACKAGE_MANAGERS, PACKAGE_MANAGER_LOCKFILE_MAP };
+//# sourceMappingURL=package-manager.mjs.map

package/dist/types/package-manager.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.mjs","names":["PACKAGE_MANAGERS","PACKAGE_MANAGER_LOCKFILE_MAP","yarn","deno","bun"],"sources":["../../src/types/package-manager.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nexport type PackageManager = \"npm\" | \"yarn\" | \"pnpm\" | \"deno\" | \"bun\";\n\nexport const PACKAGE_MANAGERS: readonly PackageManager[] = [\n  \"npm\",\n  \"yarn\",\n  \"pnpm\",\n  \"deno\",\n  \"bun\"\n] as const;\n\nexport const PACKAGE_MANAGER_LOCKFILE_MAP: Record<string, PackageManager> = {\n  \"package-lock\": \"npm\",\n  yarn: \"yarn\",\n  \"pnpm-lock\": \"pnpm\",\n  deno: \"deno\",\n  bun: \"bun\"\n} as const;\n"],"mappings":";AAoBA,MAAaA,mBAA8C;CACzD;CACA;CACA;CACA;CACA;CACQ;AAEV,MAAaC,+BAA+D;CAC1E,gBAAgB;CAChBC,MAAM;CACN,aAAa;CACbC,MAAM;CACNC,KAAK;CACG"}

package/dist/types/plugin.d.cts

@@ -0,0 +1,29 @@
+import { ResolvedConfig, UserConfig } from "@shell-shock/core/types/config";
+import { Context } from "@shell-shock/core/types/context";
+
+//#region src/types/plugin.d.ts
+interface UpgradePluginOptions {
+  /**
+   * Optionally specify the name of the package in npm to check for upgrades.
+   *
+   * @remarks
+   * This option is used to determine which package's version to check for upgrades. If not specified, it will default to the value detected in the `package.json` file of the project, or the name of the package that the plugin is a part of if it is being used within a package context. This option is primarily intended for use when the plugin is being used in a non-package context, such as a global installation, where there may not be a `package.json` file to reference.
+   */
+  packageName?: string;
+}
+type UpgradePluginUserConfig = UserConfig & {
+  /**
+   * Resolved upgrade configuration for the plugin.
+   */
+  upgrade: UpgradePluginOptions;
+};
+type UpgradePluginResolvedConfig = ResolvedConfig & {
+  /**
+   * Resolved upgrade configuration for the plugin.
+   */
+  upgrade: UpgradePluginOptions;
+};
+type UpgradePluginContext<TResolvedConfig extends UpgradePluginResolvedConfig = UpgradePluginResolvedConfig> = Context<TResolvedConfig>;
+//#endregion
+export { UpgradePluginContext, UpgradePluginOptions, UpgradePluginResolvedConfig, UpgradePluginUserConfig };
+//# sourceMappingURL=plugin.d.cts.map

package/dist/types/plugin.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.cts","names":[],"sources":["../../src/types/plugin.ts"],"sourcesContent":[],"mappings":";;;;UAwBiB,oBAAA;;AAAjB;AAUA;AAOA;AAOA;;EAEI,WAAA,CAAA,EAAA,MAAA;;AACA,KAjBQ,uBAAA,GAA0B,UAiBlC,GAAA;EAAO;;;WAbA;;KAGC,2BAAA,GAA8B;;;;WAI/B;;KAGC,6CACc,8BACtB,+BACA,QAAQ"}