@shopify/cli 3.59.3 → 3.60.1

package/dist/cli/commands/demo/index.js

@@ -1,44 +1,44 @@
 import {
   demo
-} from "../../../chunk-OVCQRTZZ.js";
-import "../../../chunk-WBWFZ6IT.js";
+} from "../../../chunk-Z3ORRLFL.js";
+import "../../../chunk-7P2SWIQY.js";
 import {
   base_command_default
-} from "../../../chunk-WD7SEY5L.js";
-import "../../../chunk-GPBOTRYV.js";
-import "../../../chunk-6MJ52OLD.js";
-import "../../../chunk-DLDVLYHU.js";
-import "../../../chunk-7SNGGY5B.js";
-import "../../../chunk-LJA4EOTX.js";
-import "../../../chunk-TKNIQF4H.js";
-import "../../../chunk-TOONJ2CA.js";
-import "../../../chunk-PNZIXRIF.js";
+} from "../../../chunk-76FPU4Y4.js";
+import "../../../chunk-M2LKXZGR.js";
+import "../../../chunk-LKGDG6WW.js";
+import "../../../chunk-BKLNHG3A.js";
+import "../../../chunk-TMGCRPEZ.js";
+import "../../../chunk-ZDPFPYD3.js";
+import "../../../chunk-IN5IG3IS.js";
+import "../../../chunk-UQNUIOTG.js";
+import "../../../chunk-UJNJ5XCL.js";
+import "../../../chunk-23EONB5V.js";
 import {
   readFile
-} from "../../../chunk-SDNI4T2T.js";
-import "../../../chunk-SA32EMWV.js";
-import "../../../chunk-JCAIZOYO.js";
-import "../../../chunk-QI5VKSMW.js";
+} from "../../../chunk-OK6RFX7A.js";
+import "../../../chunk-FQIRJADJ.js";
+import "../../../chunk-FBB6KUZG.js";
+import "../../../chunk-OVPEO3GL.js";
 import {
   require_lib
-} from "../../../chunk-3MMF34G4.js";
-import "../../../chunk-YLPWACJJ.js";
-import "../../../chunk-SMULJJG3.js";
-import "../../../chunk-LOF3ZXQM.js";
-import "../../../chunk-F6GZ5SSL.js";
-import "../../../chunk-WI3E2P3B.js";
-import "../../../chunk-CYG4QPQ3.js";
-import "../../../chunk-P52UWCZD.js";
+} from "../../../chunk-4AOK4O3R.js";
+import "../../../chunk-FWGRGI4R.js";
+import "../../../chunk-BE73NZXB.js";
+import "../../../chunk-VNBOO6TJ.js";
+import "../../../chunk-QTHWTF4X.js";
+import "../../../chunk-RQ24VTW4.js";
+import "../../../chunk-WCNR75S2.js";
 import {
   cwd,
   resolvePath
-} from "../../../chunk-M336AND6.js";
-import "../../../chunk-AXXAG7WU.js";
-import "../../../chunk-566AK3QG.js";
+} from "../../../chunk-G6FN5VUE.js";
+import "../../../chunk-3JLUTHGR.js";
+import "../../../chunk-GXPKATXW.js";
 import {
   __toESM,
   init_cjs_shims
-} from "../../../chunk-BVGYIZ3O.js";
+} from "../../../chunk-M63RTPGR.js";
 
 // src/cli/commands/demo/index.ts
 init_cjs_shims();

package/dist/cli/commands/demo/print-ai-prompt.js

@@ -1,34 +1,34 @@
 import {
   PrintAIPrompt
-} from "../../../chunk-NLMW7YYN.js";
-import "../../../chunk-CXG2USMP.js";
-import "../../../chunk-OVCQRTZZ.js";
-import "../../../chunk-WBWFZ6IT.js";
-import "../../../chunk-WD7SEY5L.js";
-import "../../../chunk-GPBOTRYV.js";
-import "../../../chunk-6MJ52OLD.js";
-import "../../../chunk-DLDVLYHU.js";
-import "../../../chunk-7SNGGY5B.js";
-import "../../../chunk-LJA4EOTX.js";
-import "../../../chunk-TKNIQF4H.js";
-import "../../../chunk-TOONJ2CA.js";
-import "../../../chunk-PNZIXRIF.js";
-import "../../../chunk-SDNI4T2T.js";
-import "../../../chunk-SA32EMWV.js";
-import "../../../chunk-JCAIZOYO.js";
-import "../../../chunk-QI5VKSMW.js";
-import "../../../chunk-3MMF34G4.js";
-import "../../../chunk-YLPWACJJ.js";
-import "../../../chunk-SMULJJG3.js";
-import "../../../chunk-LOF3ZXQM.js";
-import "../../../chunk-F6GZ5SSL.js";
-import "../../../chunk-WI3E2P3B.js";
-import "../../../chunk-CYG4QPQ3.js";
-import "../../../chunk-P52UWCZD.js";
-import "../../../chunk-M336AND6.js";
-import "../../../chunk-AXXAG7WU.js";
-import "../../../chunk-566AK3QG.js";
-import "../../../chunk-BVGYIZ3O.js";
+} from "../../../chunk-QGJ5DP4W.js";
+import "../../../chunk-IUHH3PST.js";
+import "../../../chunk-Z3ORRLFL.js";
+import "../../../chunk-7P2SWIQY.js";
+import "../../../chunk-76FPU4Y4.js";
+import "../../../chunk-M2LKXZGR.js";
+import "../../../chunk-LKGDG6WW.js";
+import "../../../chunk-BKLNHG3A.js";
+import "../../../chunk-TMGCRPEZ.js";
+import "../../../chunk-ZDPFPYD3.js";
+import "../../../chunk-IN5IG3IS.js";
+import "../../../chunk-UQNUIOTG.js";
+import "../../../chunk-UJNJ5XCL.js";
+import "../../../chunk-23EONB5V.js";
+import "../../../chunk-OK6RFX7A.js";
+import "../../../chunk-FQIRJADJ.js";
+import "../../../chunk-FBB6KUZG.js";
+import "../../../chunk-OVPEO3GL.js";
+import "../../../chunk-4AOK4O3R.js";
+import "../../../chunk-FWGRGI4R.js";
+import "../../../chunk-BE73NZXB.js";
+import "../../../chunk-VNBOO6TJ.js";
+import "../../../chunk-QTHWTF4X.js";
+import "../../../chunk-RQ24VTW4.js";
+import "../../../chunk-WCNR75S2.js";
+import "../../../chunk-G6FN5VUE.js";
+import "../../../chunk-3JLUTHGR.js";
+import "../../../chunk-GXPKATXW.js";
+import "../../../chunk-M63RTPGR.js";
 export {
   PrintAIPrompt as default
 };

package/dist/cli/commands/docs/generate.js

@@ -4,32 +4,32 @@ import {
   writeCommandDocumentation,
   writeCommandFlagInterface,
   writeCommandUsageExampleFile
-} from "../../../chunk-BEYT7IAV.js";
-import "../../../chunk-WD7SEY5L.js";
-import "../../../chunk-GPBOTRYV.js";
-import "../../../chunk-6MJ52OLD.js";
-import "../../../chunk-DLDVLYHU.js";
-import "../../../chunk-7SNGGY5B.js";
-import "../../../chunk-LJA4EOTX.js";
-import "../../../chunk-TKNIQF4H.js";
-import "../../../chunk-TOONJ2CA.js";
-import "../../../chunk-PNZIXRIF.js";
-import "../../../chunk-SDNI4T2T.js";
-import "../../../chunk-SA32EMWV.js";
-import "../../../chunk-JCAIZOYO.js";
-import "../../../chunk-QI5VKSMW.js";
-import "../../../chunk-3MMF34G4.js";
-import "../../../chunk-YLPWACJJ.js";
-import "../../../chunk-SMULJJG3.js";
-import "../../../chunk-LOF3ZXQM.js";
-import "../../../chunk-F6GZ5SSL.js";
-import "../../../chunk-WI3E2P3B.js";
-import "../../../chunk-CYG4QPQ3.js";
-import "../../../chunk-P52UWCZD.js";
-import "../../../chunk-M336AND6.js";
-import "../../../chunk-AXXAG7WU.js";
-import "../../../chunk-566AK3QG.js";
-import "../../../chunk-BVGYIZ3O.js";
+} from "../../../chunk-SQR2WUOU.js";
+import "../../../chunk-76FPU4Y4.js";
+import "../../../chunk-M2LKXZGR.js";
+import "../../../chunk-LKGDG6WW.js";
+import "../../../chunk-BKLNHG3A.js";
+import "../../../chunk-TMGCRPEZ.js";
+import "../../../chunk-ZDPFPYD3.js";
+import "../../../chunk-IN5IG3IS.js";
+import "../../../chunk-UQNUIOTG.js";
+import "../../../chunk-UJNJ5XCL.js";
+import "../../../chunk-23EONB5V.js";
+import "../../../chunk-OK6RFX7A.js";
+import "../../../chunk-FQIRJADJ.js";
+import "../../../chunk-FBB6KUZG.js";
+import "../../../chunk-OVPEO3GL.js";
+import "../../../chunk-4AOK4O3R.js";
+import "../../../chunk-FWGRGI4R.js";
+import "../../../chunk-BE73NZXB.js";
+import "../../../chunk-VNBOO6TJ.js";
+import "../../../chunk-QTHWTF4X.js";
+import "../../../chunk-RQ24VTW4.js";
+import "../../../chunk-WCNR75S2.js";
+import "../../../chunk-G6FN5VUE.js";
+import "../../../chunk-3JLUTHGR.js";
+import "../../../chunk-GXPKATXW.js";
+import "../../../chunk-M63RTPGR.js";
 export {
   DocsGenerate as default,
   extractCommandData,

package/dist/cli/commands/docs/generate.js.map

@@ -1 +1 @@
-{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../../../src/cli/commands/docs/generate.ts"],"names":[],"mappings":"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","sourcesContent":["import Command from '@shopify/cli-kit/node/base-command'\nimport {Command as oclifCommand} from '@oclif/core'\nimport {mkdir, rmdir, writeFile} from '@shopify/cli-kit/node/fs'\nimport {cwd, joinPath} from '@shopify/cli-kit/node/path'\nimport {outputInfo} from '@shopify/cli-kit/node/output'\n\nconst docsPath = joinPath(cwd(), '/docs-shopify.dev/commands')\n\nexport type CommandWithMarkdown = oclifCommand.Loadable & {descriptionWithMarkdown?: string}\n\nexport interface CommandData {\n  commandName: string\n  fileName: string\n  interfaceName: string\n  hasTopic: boolean\n  topic: string | undefined\n  hasFlags: boolean\n}\n\nexport default class DocsGenerate extends Command {\n  static description = 'Generate CLI commands documentation'\n  static hidden = true\n\n  async run(): Promise<void> {\n    const commands = this.config.commands as CommandWithMarkdown[]\n\n    // Remove all files and recreate the folder. To make sure we don't leave any orphaned files.\n    await rmdir(docsPath)\n    await mkdir(docsPath)\n\n    // Short by length to ensure that we first generate the interfaces for the parent topics to detect hidden ones.\n    const sortedCommands = commands\n      .sort((ca, cb) => ca.id.length - cb.id.length)\n      .filter((command) => !isHidden(command))\n    const promises = sortedCommands.flatMap((command) => {\n      const commandData = extractCommandData(command)\n      return [\n        writeCommandFlagInterface(command, commandData),\n        writeCommandUsageExampleFile(command, commandData),\n        writeCommandDocumentation(command, commandData),\n      ]\n    })\n\n    await Promise.all(promises)\n  }\n}\n\n// By default we hide oclif commands that are not part of the Shopify CLI documentation\nconst hiddenTopics: string[] = ['commands', 'help', 'plugins']\n\n// Topics that are included in the Universal commands category\nconst universalTopics: string[] = ['config', 'auth']\n\nfunction isHidden(command: oclifCommand.Loadable) {\n  // Some commands rely on the hidden property of the parent topic, but is not returned in the oclif command object\n  if (command.hidden) {\n    hiddenTopics.push(command.id)\n    return true\n  }\n\n  // User plugins are installed locally and are not part of the Shopify CLI documentation\n  if (command.pluginType === 'user') return true\n  return hiddenTopics.some((topic) => command.id.startsWith(`${topic}:`))\n}\n\nexport function extractCommandData(command: CommandWithMarkdown) {\n  const commandName = command.id.replace(/[:]/g, ' ')\n  const fileName = command.id.replace(/[:]/g, '-')\n  const interfaceName = command.id.replace(/[:-]/g, '')\n  const hasTopic = command.id.includes(':')\n  const topic = command.id.split(':')[0]\n  const hasFlags = command.flags && Object.keys(command.flags).length > 0\n  return {commandName, fileName, interfaceName, hasTopic, topic, hasFlags}\n}\n\n// Generates the documentation for a command and writes it to a file (also a file with an example usage of the command)\nexport async function writeCommandDocumentation(\n  command: CommandWithMarkdown,\n  {commandName, fileName, interfaceName, hasTopic, topic, hasFlags}: CommandData,\n) {\n  const flagDoc = `\n  {\n    title: 'Flags',\n    description: 'The following flags are available for the \\`${commandName}\\` command:',\n    type: '${interfaceName}',\n  },`\n\n  const description = command.descriptionWithMarkdown ?? command.description ?? command.summary\n  const previewDescription = command.summary ?? description\n\n  const category = hasTopic && !universalTopics.includes(topic!) ? topic : 'Universal commands'\n\n  const string = `// This is an autogenerated file. Don't edit this file manually.\nimport {ReferenceEntityTemplateSchema} from '@shopify/generate-docs'\n\nconst data: ReferenceEntityTemplateSchema = {\n  name: '${commandName}',\n  description: \\`${description?.replace(/`/g, '\\\\`')}\\`,\n  overviewPreviewDescription: \\`${previewDescription?.replace(/`/g, '\\\\`')}\\`,\n  type: 'command',\n  isVisualComponent: false,\n  defaultExample: {\n    codeblock: {\n      tabs: [\n        {\n          title: '${commandName}',\n          code: './examples/${fileName}.example.sh',\n          language: 'bash',\n        },\n      ],\n      title: '${commandName}',\n    },\n  },\n  definitions: [${hasFlags ? flagDoc : ''}\n  ],\n  category: '${category}',\n  related: [\n  ],\n}\n\nexport default data`\n\n  await writeFile(`${docsPath}/${fileName}.doc.ts`, string)\n  outputInfo(`Generated docs for ${commandName}`)\n}\n\n// Generates an interface for the flags of a command and writes it to a file\nexport async function writeCommandFlagInterface(\n  command: oclifCommand.Loadable,\n  {fileName, interfaceName}: CommandData,\n) {\n  const flagsDetails = Object.keys(command.flags)\n    .map((flagName) => {\n      const flag = command.flags[flagName]\n      if (!flag) return\n      if (flag.hidden) return\n      const flagDescription = flag.description || ''\n      const char = flag.char ? `-${flag.char}, ` : ''\n      const type = flag.type === 'option' ? 'string' : \"''\"\n      const value = flag.type === 'option' ? ' <value>' : ''\n      const optional = flag.required ? '' : '?'\n      const flagContent = `  /**\n   * ${flagDescription}\n   */\n  '${char}--${flagName}${value}'${optional}: ${type}`\n      // Example output: '-c, --config <value>'?: string\n      return flagContent\n    })\n    .filter((str) => str && str?.length > 0)\n    .join('\\n\\n')\n\n  const commandContent = `// This is an autogenerated file. Don't edit this file manually.\nexport interface ${interfaceName} {\n${flagsDetails}\n}\n`\n  await mkdir(`${docsPath}/interfaces`)\n  await writeFile(`${docsPath}/interfaces/${fileName}.interface.ts`, commandContent)\n}\n\n// Generates a file with an example usage of a command\nexport async function writeCommandUsageExampleFile(command: CommandWithMarkdown, {fileName, commandName}: CommandData) {\n  let usage = ''\n  const hasFlags = command.flags && Object.keys(command.flags).length > 0\n  if (typeof command.usage === 'string') {\n    usage = command.usage\n  } else if (Array.isArray(command.usage)) {\n    usage = command.usage.join('\\n\\n')\n  } else {\n    usage = `shopify ${commandName}${hasFlags ? ' [flags]' : ''}`\n  }\n  await mkdir(`${docsPath}/examples`)\n  await writeFile(`${docsPath}/examples/${fileName}.example.sh`, usage)\n}\n"]}
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../../../src/cli/commands/docs/generate.ts"],"names":[],"mappings":"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","sourcesContent":["import Command from '@shopify/cli-kit/node/base-command'\nimport {Command as oclifCommand} from '@oclif/core'\nimport {mkdir, rmdir, writeFile} from '@shopify/cli-kit/node/fs'\nimport {cwd, joinPath} from '@shopify/cli-kit/node/path'\nimport {outputInfo} from '@shopify/cli-kit/node/output'\n\nconst docsPath = joinPath(cwd(), '/docs-shopify.dev/commands')\n\nexport type CommandWithMarkdown = oclifCommand.Loadable & {descriptionWithMarkdown?: string}\n\nexport interface CommandData {\n  commandName: string\n  fileName: string\n  interfaceName: string\n  hasTopic: boolean\n  topic: string | undefined\n  hasFlags: boolean\n}\n\nexport default class DocsGenerate extends Command {\n  static description = 'Generate CLI commands documentation'\n  static hidden = true\n\n  async run(): Promise<void> {\n    const commands = this.config.commands as CommandWithMarkdown[]\n\n    // Remove all files and recreate the folder. To make sure we don't leave any orphaned files.\n    await rmdir(docsPath)\n    await mkdir(docsPath)\n\n    // Short by length to ensure that we first generate the interfaces for the parent topics to detect hidden ones.\n    const sortedCommands = commands\n      .sort((ca, cb) => ca.id.length - cb.id.length)\n      .filter((command) => !isHidden(command))\n    const promises = sortedCommands.flatMap((command) => {\n      const commandData = extractCommandData(command)\n      return [\n        writeCommandFlagInterface(command, commandData),\n        writeCommandUsageExampleFile(command, commandData),\n        writeCommandDocumentation(command, commandData),\n      ]\n    })\n\n    await Promise.all(promises)\n  }\n}\n\n// By default we hide oclif commands that are not part of the Shopify CLI documentation\nconst hiddenTopics: string[] = ['commands', 'help', 'plugins']\n\n// Topics that are included in the general commands category\nconst generalTopics: string[] = ['config', 'auth']\n\nfunction isHidden(command: oclifCommand.Loadable) {\n  // Some commands rely on the hidden property of the parent topic, but is not returned in the oclif command object\n  if (command.hidden) {\n    hiddenTopics.push(command.id)\n    return true\n  }\n\n  // User plugins are installed locally and are not part of the Shopify CLI documentation\n  if (command.pluginType === 'user') return true\n  return hiddenTopics.some((topic) => command.id.startsWith(`${topic}:`))\n}\n\nexport function extractCommandData(command: CommandWithMarkdown) {\n  const commandName = command.id.replace(/[:]/g, ' ')\n  const fileName = command.id.replace(/[:]/g, '-')\n  const interfaceName = command.id.replace(/[:-]/g, '')\n  const hasTopic = command.id.includes(':')\n  const topic = command.id.split(':')[0]\n  const hasFlags = command.flags && Object.keys(command.flags).length > 0\n  return {commandName, fileName, interfaceName, hasTopic, topic, hasFlags}\n}\n\n// Generates the documentation for a command and writes it to a file (also a file with an example usage of the command)\nexport async function writeCommandDocumentation(\n  command: CommandWithMarkdown,\n  {commandName, fileName, interfaceName, hasTopic, topic, hasFlags}: CommandData,\n) {\n  const flagDoc = `\n  {\n    title: 'Flags',\n    description: 'The following flags are available for the \\`${commandName}\\` command:',\n    type: '${interfaceName}',\n  },`\n\n  const description = command.descriptionWithMarkdown ?? command.description ?? command.summary ?? ''\n  const cleanDescription = description?.replace(/`/g, '\\\\`').replace(/https:\\/\\/shopify\\.dev/g, '')\n  const previewDescription = command.summary ?? description ?? ''\n  const cleanPreview = previewDescription.replace(/`/g, '\\\\`').replace(/https:\\/\\/shopify\\.dev/g, '')\n\n  const category = hasTopic && !generalTopics.includes(topic!) ? topic : 'general commands'\n\n  const string = `// This is an autogenerated file. Don't edit this file manually.\nimport {ReferenceEntityTemplateSchema} from '@shopify/generate-docs'\n\nconst data: ReferenceEntityTemplateSchema = {\n  name: '${commandName}',\n  description: \\`${cleanDescription}\\`,\n  overviewPreviewDescription: \\`${cleanPreview}\\`,\n  type: 'command',\n  isVisualComponent: false,\n  defaultExample: {\n    codeblock: {\n      tabs: [\n        {\n          title: '${commandName}',\n          code: './examples/${fileName}.example.sh',\n          language: 'bash',\n        },\n      ],\n      title: '${commandName}',\n    },\n  },\n  definitions: [${hasFlags ? flagDoc : ''}\n  ],\n  category: '${category}',\n  related: [\n  ],\n}\n\nexport default data`\n\n  await writeFile(`${docsPath}/${fileName}.doc.ts`, string)\n  outputInfo(`Generated docs for ${commandName}`)\n}\n\n// Generates an interface for the flags of a command and writes it to a file\nexport async function writeCommandFlagInterface(\n  command: oclifCommand.Loadable,\n  {fileName, interfaceName}: CommandData,\n) {\n  const flagsDetails = Object.keys(command.flags)\n    .map((flagName) => {\n      const flag = command.flags[flagName]\n      if (!flag) return\n      if (flag.hidden) return\n      const flagDescription = flag.description || ''\n      const char = flag.char ? `-${flag.char}, ` : ''\n      const type = flag.type === 'option' ? 'string' : \"''\"\n      const value = flag.type === 'option' ? ' <value>' : ''\n      const optional = flag.required ? '' : '?'\n      // eslint-disable-next-line no-negated-condition\n      const envValue = flag.env !== undefined ? ` @environment ${flag.env}` : ''\n      const flagContent = `  /**\n   * ${flagDescription}\n   *${envValue}\n   */\n  '${char}--${flagName}${value}'${optional}: ${type}`\n      // Example output: '-c, --config <value>'?: string\n      return flagContent\n    })\n    .filter((str) => str && str?.length > 0)\n    .join('\\n\\n')\n\n  const commandContent = `// This is an autogenerated file. Don't edit this file manually.\nexport interface ${interfaceName} {\n${flagsDetails}\n}\n`\n  await mkdir(`${docsPath}/interfaces`)\n  await writeFile(`${docsPath}/interfaces/${fileName}.interface.ts`, commandContent)\n}\n\n// Generates a file with an example usage of a command\nexport async function writeCommandUsageExampleFile(command: CommandWithMarkdown, {fileName, commandName}: CommandData) {\n  let usage = ''\n  const hasFlags = command.flags && Object.keys(command.flags).length > 0\n  if (typeof command.usage === 'string') {\n    usage = command.usage\n  } else if (Array.isArray(command.usage)) {\n    usage = command.usage.join('\\n\\n')\n  } else {\n    usage = `shopify ${commandName}${hasFlags ? ' [flags]' : ''}`\n  }\n  await mkdir(`${docsPath}/examples`)\n  await writeFile(`${docsPath}/examples/${fileName}.example.sh`, usage)\n}\n"]}

package/dist/cli/commands/docs/generate.test.js

@@ -3,42 +3,42 @@ import {
   writeCommandDocumentation,
   writeCommandFlagInterface,
   writeCommandUsageExampleFile
-} from "../../../chunk-BEYT7IAV.js";
+} from "../../../chunk-SQR2WUOU.js";
 import {
   describe,
   globalExpect,
   test,
   vi
-} from "../../../chunk-7D6QIBBS.js";
-import "../../../chunk-WD7SEY5L.js";
-import "../../../chunk-GPBOTRYV.js";
-import "../../../chunk-6MJ52OLD.js";
-import "../../../chunk-DLDVLYHU.js";
-import "../../../chunk-7SNGGY5B.js";
-import "../../../chunk-LJA4EOTX.js";
-import "../../../chunk-TKNIQF4H.js";
-import "../../../chunk-TOONJ2CA.js";
-import "../../../chunk-PNZIXRIF.js";
+} from "../../../chunk-5R5555YE.js";
+import "../../../chunk-76FPU4Y4.js";
+import "../../../chunk-M2LKXZGR.js";
+import "../../../chunk-LKGDG6WW.js";
+import "../../../chunk-BKLNHG3A.js";
+import "../../../chunk-TMGCRPEZ.js";
+import "../../../chunk-ZDPFPYD3.js";
+import "../../../chunk-IN5IG3IS.js";
+import "../../../chunk-UQNUIOTG.js";
+import "../../../chunk-UJNJ5XCL.js";
+import "../../../chunk-23EONB5V.js";
 import {
   writeFile
-} from "../../../chunk-SDNI4T2T.js";
-import "../../../chunk-SA32EMWV.js";
-import "../../../chunk-JCAIZOYO.js";
-import "../../../chunk-QI5VKSMW.js";
-import "../../../chunk-3MMF34G4.js";
-import "../../../chunk-YLPWACJJ.js";
-import "../../../chunk-SMULJJG3.js";
-import "../../../chunk-LOF3ZXQM.js";
-import "../../../chunk-F6GZ5SSL.js";
-import "../../../chunk-WI3E2P3B.js";
-import "../../../chunk-CYG4QPQ3.js";
-import "../../../chunk-P52UWCZD.js";
-import "../../../chunk-M336AND6.js";
-import "../../../chunk-AXXAG7WU.js";
-import "../../../chunk-566AK3QG.js";
+} from "../../../chunk-OK6RFX7A.js";
+import "../../../chunk-FQIRJADJ.js";
+import "../../../chunk-FBB6KUZG.js";
+import "../../../chunk-OVPEO3GL.js";
+import "../../../chunk-4AOK4O3R.js";
+import "../../../chunk-FWGRGI4R.js";
+import "../../../chunk-BE73NZXB.js";
+import "../../../chunk-VNBOO6TJ.js";
+import "../../../chunk-QTHWTF4X.js";
+import "../../../chunk-RQ24VTW4.js";
+import "../../../chunk-WCNR75S2.js";
+import "../../../chunk-G6FN5VUE.js";
+import "../../../chunk-3JLUTHGR.js";
+import "../../../chunk-GXPKATXW.js";
 import {
   init_cjs_shims
-} from "../../../chunk-BVGYIZ3O.js";
+} from "../../../chunk-M63RTPGR.js";
 
 // src/cli/commands/docs/generate.test.ts
 init_cjs_shims();
@@ -58,6 +58,7 @@ var testCommand = {
       type: "boolean",
       char: "a",
       description: "another flag description",
+      env: "FLAG_ENV",
       allowNo: false
     }
   },
@@ -91,11 +92,13 @@ describe("writeCommandFlagInterface", () => {
 export interface topictestcommand {
   /**
    * flag description
+   *
    */
   '-f, --flag1 <value>'?: string
 
   /**
    * another flag description
+   * @environment FLAG_ENV
    */
   '-a, --flag2'?: ''
 }

package/dist/cli/commands/help.js

@@ -1,31 +1,31 @@
 import {
   HelpCommand
-} from "../../chunk-FS2KWH4D.js";
-import "../../chunk-WD7SEY5L.js";
-import "../../chunk-GPBOTRYV.js";
-import "../../chunk-6MJ52OLD.js";
-import "../../chunk-DLDVLYHU.js";
-import "../../chunk-7SNGGY5B.js";
-import "../../chunk-LJA4EOTX.js";
-import "../../chunk-TKNIQF4H.js";
-import "../../chunk-TOONJ2CA.js";
-import "../../chunk-PNZIXRIF.js";
-import "../../chunk-SDNI4T2T.js";
-import "../../chunk-SA32EMWV.js";
-import "../../chunk-JCAIZOYO.js";
-import "../../chunk-QI5VKSMW.js";
-import "../../chunk-3MMF34G4.js";
-import "../../chunk-YLPWACJJ.js";
-import "../../chunk-SMULJJG3.js";
-import "../../chunk-LOF3ZXQM.js";
-import "../../chunk-F6GZ5SSL.js";
-import "../../chunk-WI3E2P3B.js";
-import "../../chunk-CYG4QPQ3.js";
-import "../../chunk-P52UWCZD.js";
-import "../../chunk-M336AND6.js";
-import "../../chunk-AXXAG7WU.js";
-import "../../chunk-566AK3QG.js";
-import "../../chunk-BVGYIZ3O.js";
+} from "../../chunk-6IDIGZKI.js";
+import "../../chunk-76FPU4Y4.js";
+import "../../chunk-M2LKXZGR.js";
+import "../../chunk-LKGDG6WW.js";
+import "../../chunk-BKLNHG3A.js";
+import "../../chunk-TMGCRPEZ.js";
+import "../../chunk-ZDPFPYD3.js";
+import "../../chunk-IN5IG3IS.js";
+import "../../chunk-UQNUIOTG.js";
+import "../../chunk-UJNJ5XCL.js";
+import "../../chunk-23EONB5V.js";
+import "../../chunk-OK6RFX7A.js";
+import "../../chunk-FQIRJADJ.js";
+import "../../chunk-FBB6KUZG.js";
+import "../../chunk-OVPEO3GL.js";
+import "../../chunk-4AOK4O3R.js";
+import "../../chunk-FWGRGI4R.js";
+import "../../chunk-BE73NZXB.js";
+import "../../chunk-VNBOO6TJ.js";
+import "../../chunk-QTHWTF4X.js";
+import "../../chunk-RQ24VTW4.js";
+import "../../chunk-WCNR75S2.js";
+import "../../chunk-G6FN5VUE.js";
+import "../../chunk-3JLUTHGR.js";
+import "../../chunk-GXPKATXW.js";
+import "../../chunk-M63RTPGR.js";
 export {
   HelpCommand as default
 };

package/dist/cli/commands/hydrogen/init.js

@@ -1,31 +1,31 @@
 import {
   Init
-} from "../../../chunk-SIH2DDL6.js";
-import "../../../chunk-WD7SEY5L.js";
-import "../../../chunk-GPBOTRYV.js";
-import "../../../chunk-6MJ52OLD.js";
-import "../../../chunk-DLDVLYHU.js";
-import "../../../chunk-7SNGGY5B.js";
-import "../../../chunk-LJA4EOTX.js";
-import "../../../chunk-TKNIQF4H.js";
-import "../../../chunk-TOONJ2CA.js";
-import "../../../chunk-PNZIXRIF.js";
-import "../../../chunk-SDNI4T2T.js";
-import "../../../chunk-SA32EMWV.js";
-import "../../../chunk-JCAIZOYO.js";
-import "../../../chunk-QI5VKSMW.js";
-import "../../../chunk-3MMF34G4.js";
-import "../../../chunk-YLPWACJJ.js";
-import "../../../chunk-SMULJJG3.js";
-import "../../../chunk-LOF3ZXQM.js";
-import "../../../chunk-F6GZ5SSL.js";
-import "../../../chunk-WI3E2P3B.js";
-import "../../../chunk-CYG4QPQ3.js";
-import "../../../chunk-P52UWCZD.js";
-import "../../../chunk-M336AND6.js";
-import "../../../chunk-AXXAG7WU.js";
-import "../../../chunk-566AK3QG.js";
-import "../../../chunk-BVGYIZ3O.js";
+} from "../../../chunk-6HKMY2UF.js";
+import "../../../chunk-76FPU4Y4.js";
+import "../../../chunk-M2LKXZGR.js";
+import "../../../chunk-LKGDG6WW.js";
+import "../../../chunk-BKLNHG3A.js";
+import "../../../chunk-TMGCRPEZ.js";
+import "../../../chunk-ZDPFPYD3.js";
+import "../../../chunk-IN5IG3IS.js";
+import "../../../chunk-UQNUIOTG.js";
+import "../../../chunk-UJNJ5XCL.js";
+import "../../../chunk-23EONB5V.js";
+import "../../../chunk-OK6RFX7A.js";
+import "../../../chunk-FQIRJADJ.js";
+import "../../../chunk-FBB6KUZG.js";
+import "../../../chunk-OVPEO3GL.js";
+import "../../../chunk-4AOK4O3R.js";
+import "../../../chunk-FWGRGI4R.js";
+import "../../../chunk-BE73NZXB.js";
+import "../../../chunk-VNBOO6TJ.js";
+import "../../../chunk-QTHWTF4X.js";
+import "../../../chunk-RQ24VTW4.js";
+import "../../../chunk-WCNR75S2.js";
+import "../../../chunk-G6FN5VUE.js";
+import "../../../chunk-3JLUTHGR.js";
+import "../../../chunk-GXPKATXW.js";
+import "../../../chunk-M63RTPGR.js";
 export {
   Init as default
 };

package/dist/cli/commands/kitchen-sink/async.js

@@ -1,32 +1,32 @@
 import {
   KitchenSinkAsync
-} from "../../../chunk-IUKVZDDI.js";
-import "../../../chunk-MWCOJGV6.js";
-import "../../../chunk-WD7SEY5L.js";
-import "../../../chunk-GPBOTRYV.js";
-import "../../../chunk-6MJ52OLD.js";
-import "../../../chunk-DLDVLYHU.js";
-import "../../../chunk-7SNGGY5B.js";
-import "../../../chunk-LJA4EOTX.js";
-import "../../../chunk-TKNIQF4H.js";
-import "../../../chunk-TOONJ2CA.js";
-import "../../../chunk-PNZIXRIF.js";
-import "../../../chunk-SDNI4T2T.js";
-import "../../../chunk-SA32EMWV.js";
-import "../../../chunk-JCAIZOYO.js";
-import "../../../chunk-QI5VKSMW.js";
-import "../../../chunk-3MMF34G4.js";
-import "../../../chunk-YLPWACJJ.js";
-import "../../../chunk-SMULJJG3.js";
-import "../../../chunk-LOF3ZXQM.js";
-import "../../../chunk-F6GZ5SSL.js";
-import "../../../chunk-WI3E2P3B.js";
-import "../../../chunk-CYG4QPQ3.js";
-import "../../../chunk-P52UWCZD.js";
-import "../../../chunk-M336AND6.js";
-import "../../../chunk-AXXAG7WU.js";
-import "../../../chunk-566AK3QG.js";
-import "../../../chunk-BVGYIZ3O.js";
+} from "../../../chunk-I5U2GOJX.js";
+import "../../../chunk-GZXEPYCR.js";
+import "../../../chunk-76FPU4Y4.js";
+import "../../../chunk-M2LKXZGR.js";
+import "../../../chunk-LKGDG6WW.js";
+import "../../../chunk-BKLNHG3A.js";
+import "../../../chunk-TMGCRPEZ.js";
+import "../../../chunk-ZDPFPYD3.js";
+import "../../../chunk-IN5IG3IS.js";
+import "../../../chunk-UQNUIOTG.js";
+import "../../../chunk-UJNJ5XCL.js";
+import "../../../chunk-23EONB5V.js";
+import "../../../chunk-OK6RFX7A.js";
+import "../../../chunk-FQIRJADJ.js";
+import "../../../chunk-FBB6KUZG.js";
+import "../../../chunk-OVPEO3GL.js";
+import "../../../chunk-4AOK4O3R.js";
+import "../../../chunk-FWGRGI4R.js";
+import "../../../chunk-BE73NZXB.js";
+import "../../../chunk-VNBOO6TJ.js";
+import "../../../chunk-QTHWTF4X.js";
+import "../../../chunk-RQ24VTW4.js";
+import "../../../chunk-WCNR75S2.js";
+import "../../../chunk-G6FN5VUE.js";
+import "../../../chunk-3JLUTHGR.js";
+import "../../../chunk-GXPKATXW.js";
+import "../../../chunk-M63RTPGR.js";
 export {
   KitchenSinkAsync as default
 };

package/dist/cli/commands/kitchen-sink/async.test.js

@@ -1,42 +1,42 @@
 import {
   KitchenSinkAsync
-} from "../../../chunk-IUKVZDDI.js";
+} from "../../../chunk-I5U2GOJX.js";
 import {
   asyncTasks
-} from "../../../chunk-MWCOJGV6.js";
+} from "../../../chunk-GZXEPYCR.js";
 import {
   describe,
   globalExpect,
   test,
   vi
-} from "../../../chunk-7D6QIBBS.js";
-import "../../../chunk-WD7SEY5L.js";
-import "../../../chunk-GPBOTRYV.js";
-import "../../../chunk-6MJ52OLD.js";
-import "../../../chunk-DLDVLYHU.js";
-import "../../../chunk-7SNGGY5B.js";
-import "../../../chunk-LJA4EOTX.js";
-import "../../../chunk-TKNIQF4H.js";
-import "../../../chunk-TOONJ2CA.js";
-import "../../../chunk-PNZIXRIF.js";
-import "../../../chunk-SDNI4T2T.js";
-import "../../../chunk-SA32EMWV.js";
-import "../../../chunk-JCAIZOYO.js";
-import "../../../chunk-QI5VKSMW.js";
-import "../../../chunk-3MMF34G4.js";
-import "../../../chunk-YLPWACJJ.js";
-import "../../../chunk-SMULJJG3.js";
-import "../../../chunk-LOF3ZXQM.js";
-import "../../../chunk-F6GZ5SSL.js";
-import "../../../chunk-WI3E2P3B.js";
-import "../../../chunk-CYG4QPQ3.js";
-import "../../../chunk-P52UWCZD.js";
-import "../../../chunk-M336AND6.js";
-import "../../../chunk-AXXAG7WU.js";
-import "../../../chunk-566AK3QG.js";
+} from "../../../chunk-5R5555YE.js";
+import "../../../chunk-76FPU4Y4.js";
+import "../../../chunk-M2LKXZGR.js";
+import "../../../chunk-LKGDG6WW.js";
+import "../../../chunk-BKLNHG3A.js";
+import "../../../chunk-TMGCRPEZ.js";
+import "../../../chunk-ZDPFPYD3.js";
+import "../../../chunk-IN5IG3IS.js";
+import "../../../chunk-UQNUIOTG.js";
+import "../../../chunk-UJNJ5XCL.js";
+import "../../../chunk-23EONB5V.js";
+import "../../../chunk-OK6RFX7A.js";
+import "../../../chunk-FQIRJADJ.js";
+import "../../../chunk-FBB6KUZG.js";
+import "../../../chunk-OVPEO3GL.js";
+import "../../../chunk-4AOK4O3R.js";
+import "../../../chunk-FWGRGI4R.js";
+import "../../../chunk-BE73NZXB.js";
+import "../../../chunk-VNBOO6TJ.js";
+import "../../../chunk-QTHWTF4X.js";
+import "../../../chunk-RQ24VTW4.js";
+import "../../../chunk-WCNR75S2.js";
+import "../../../chunk-G6FN5VUE.js";
+import "../../../chunk-3JLUTHGR.js";
+import "../../../chunk-GXPKATXW.js";
 import {
   init_cjs_shims
-} from "../../../chunk-BVGYIZ3O.js";
+} from "../../../chunk-M63RTPGR.js";
 
 // src/cli/commands/kitchen-sink/async.test.ts
 init_cjs_shims();