@zitadel/cli 1.0.0-alpha.21 → 1.0.0-alpha.23

package/dist/lib/oclif/help.mjs

@@ -0,0 +1,67 @@
+import { n as COMMAND_GROUPS, t as ADDITIONAL_COMMANDS_GROUP } from "../../groups-CMB0fMzE.mjs";
+import { Help, toConfiguredId, ux } from "@oclif/core";
+//#region src/lib/oclif/help.ts
+/**
+* Summaries for oclif plugin commands that ship without one. `version` prints
+* a blank line otherwise.
+*/
+const PLUGIN_SUMMARIES = { version: "Show the CLI version" };
+/**
+* Root help in the style of `gh --help`: a tagline, usage, the commands under
+* headed groups with oclif's utilities last, then flags, examples, and where
+* to go next. Only {@link showRootHelp} is replaced; per-command and
+* per-topic help (`start --help`, `schemas --help`) stay oclif's own. Wired
+* in via `oclif.helpClass` in `package.json`.
+*/
+var ZitadelHelp = class extends Help {
+	async showRootHelp() {
+		const { bin } = this.config;
+		const commands = this.rootCommands();
+		const width = Math.max(0, ...commands.map((command) => this.displayName(command).length));
+		const list = (entries) => entries.map((command) => `${this.displayName(command).padEnd(width)} ${this.oneLineSummary(command)}`).join("\n");
+		const groups = COMMAND_GROUPS.map((group) => [group, byGroup(commands, group)]).filter(([, entries]) => entries.length > 0);
+		const additional = commands.filter((command) => command.group === void 0).sort((a, b) => a.id.localeCompare(b.id));
+		const sections = [
+			this.render(this.config.pjson.oclif.description ?? this.config.pjson.description ?? ""),
+			this.section("Usage", `${bin} <command> [flags]`),
+			...groups.map(([group, entries]) => this.section(group, list(entries))),
+			...additional.length > 0 ? [this.section(ADDITIONAL_COMMANDS_GROUP, list(additional))] : [],
+			this.section("Flags", ["--help      Show help for command", `--version   Show ${bin} version`].join("\n")),
+			this.section("Examples", [
+				`$ ${bin} setup --framework next`,
+				`$ ${bin} start`,
+				`$ ${bin} doctor`
+			].join("\n")),
+			this.section("Learn more", `Use \`${bin} <command> --help\` for more information about a command.`)
+		];
+		this.log(sections.join("\n\n"));
+	}
+	/**
+	* The commands the root screen lists: every visible command, grouped or
+	* not, whatever its depth. Alias entries and `help` itself are left out.
+	*/
+	rootCommands() {
+		return this.sortedCommands.filter((command) => command.id !== "help" && !command.aliases?.includes(command.id));
+	}
+	displayName(command) {
+		return `${toConfiguredId(command.id, this.config)}:`;
+	}
+	/**
+	* The summary as `gh` prints it: the first clause of the summary or
+	* description, with no trailing full stop. Built from the raw statics rather
+	* than {@link summary} so a user theme's colour codes cannot end up inside
+	* the clause; the theme is applied once the text is final.
+	*/
+	oneLineSummary(command) {
+		const source = PLUGIN_SUMMARIES[command.id] ?? command.summary ?? command.description ?? "";
+		const [clause = ""] = this.render(source).split(/[.:]\s|\n/, 1);
+		return ux.colorize(this.config.theme?.commandSummary, clause.trim().replace(/\.$/, ""));
+	}
+};
+function byGroup(commands, group) {
+	return commands.filter((command) => command.group === group).sort((a, b) => (a.groupOrder ?? Number.MAX_SAFE_INTEGER) - (b.groupOrder ?? Number.MAX_SAFE_INTEGER) || a.id.localeCompare(b.id));
+}
+//#endregion
+export { ZitadelHelp as default };
+
+//# sourceMappingURL=help.mjs.map

package/dist/lib/oclif/help.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.mjs","names":[],"sources":["../../../src/lib/oclif/help.ts"],"sourcesContent":["import { type Command, Help, toConfiguredId, ux } from \"@oclif/core\";\n\nimport { ADDITIONAL_COMMANDS_GROUP, COMMAND_GROUPS, type CommandGroup } from \"./groups\";\n\n/** A loaded command plus the root-help statics `BaseCommand` (`./base`) declares. */\ntype GroupedCommand = Command.Loadable & { group?: CommandGroup; groupOrder?: number };\n\n/**\n * Summaries for oclif plugin commands that ship without one. `version` prints\n * a blank line otherwise.\n */\nconst PLUGIN_SUMMARIES: Readonly<Record<string, string>> = {\n  version: \"Show the CLI version\",\n};\n\n/**\n * Root help in the style of `gh --help`: a tagline, usage, the commands under\n * headed groups with oclif's utilities last, then flags, examples, and where\n * to go next. Only {@link showRootHelp} is replaced; per-command and\n * per-topic help (`start --help`, `schemas --help`) stay oclif's own. Wired\n * in via `oclif.helpClass` in `package.json`.\n */\nexport default class ZitadelHelp extends Help {\n  protected override async showRootHelp(): Promise<void> {\n    const { bin } = this.config;\n    const commands = this.rootCommands();\n    const width = Math.max(0, ...commands.map((command) => this.displayName(command).length));\n    const list = (entries: readonly GroupedCommand[]): string =>\n      entries\n        .map(\n          (command) => `${this.displayName(command).padEnd(width)} ${this.oneLineSummary(command)}`,\n        )\n        .join(\"\\n\");\n\n    const groups = COMMAND_GROUPS.map((group) => [group, byGroup(commands, group)] as const).filter(\n      ([, entries]) => entries.length > 0,\n    );\n    const additional = commands\n      .filter((command) => command.group === undefined)\n      .sort((a, b) => a.id.localeCompare(b.id));\n\n    const sections = [\n      this.render(this.config.pjson.oclif.description ?? this.config.pjson.description ?? \"\"),\n      this.section(\"Usage\", `${bin} <command> [flags]`),\n      ...groups.map(([group, entries]) => this.section(group, list(entries))),\n      ...(additional.length > 0 ? [this.section(ADDITIONAL_COMMANDS_GROUP, list(additional))] : []),\n      this.section(\n        \"Flags\",\n        [\"--help      Show help for command\", `--version   Show ${bin} version`].join(\"\\n\"),\n      ),\n      this.section(\n        \"Examples\",\n        [`$ ${bin} setup --framework next`, `$ ${bin} start`, `$ ${bin} doctor`].join(\"\\n\"),\n      ),\n      this.section(\n        \"Learn more\",\n        `Use \\`${bin} <command> --help\\` for more information about a command.`,\n      ),\n    ];\n    this.log(sections.join(\"\\n\\n\"));\n  }\n\n  /**\n   * The commands the root screen lists: every visible command, grouped or\n   * not, whatever its depth. Alias entries and `help` itself are left out.\n   */\n  private rootCommands(): GroupedCommand[] {\n    return (this.sortedCommands as GroupedCommand[]).filter(\n      (command) => command.id !== \"help\" && !command.aliases?.includes(command.id),\n    );\n  }\n\n  private displayName(command: GroupedCommand): string {\n    return `${toConfiguredId(command.id, this.config)}:`;\n  }\n\n  /**\n   * The summary as `gh` prints it: the first clause of the summary or\n   * description, with no trailing full stop. Built from the raw statics rather\n   * than {@link summary} so a user theme's colour codes cannot end up inside\n   * the clause; the theme is applied once the text is final.\n   */\n  private oneLineSummary(command: GroupedCommand): string {\n    const source = PLUGIN_SUMMARIES[command.id] ?? command.summary ?? command.description ?? \"\";\n    const [clause = \"\"] = this.render(source).split(/[.:]\\s|\\n/, 1);\n    return ux.colorize(this.config.theme?.commandSummary, clause.trim().replace(/\\.$/, \"\"));\n  }\n}\n\nfunction byGroup(commands: readonly GroupedCommand[], group: CommandGroup): GroupedCommand[] {\n  return commands\n    .filter((command) => command.group === group)\n    .sort(\n      (a, b) =>\n        (a.groupOrder ?? Number.MAX_SAFE_INTEGER) - (b.groupOrder ?? Number.MAX_SAFE_INTEGER) ||\n        a.id.localeCompare(b.id),\n    );\n}\n"],"mappings":";;;;;;;AAWA,MAAM,mBAAqD,EACzD,SAAS,wBACV;;;;;;;;AASD,IAAqB,cAArB,cAAyC,KAAK;CAC5C,MAAyB,eAA8B;EACrD,MAAM,EAAE,QAAQ,KAAK;EACrB,MAAM,WAAW,KAAK,cAAc;EACpC,MAAM,QAAQ,KAAK,IAAI,GAAG,GAAG,SAAS,KAAK,YAAY,KAAK,YAAY,QAAQ,CAAC,OAAO,CAAC;EACzF,MAAM,QAAQ,YACZ,QACG,KACE,YAAY,GAAG,KAAK,YAAY,QAAQ,CAAC,OAAO,MAAM,CAAC,GAAG,KAAK,eAAe,QAAQ,GACxF,CACA,KAAK,KAAK;EAEf,MAAM,SAAS,eAAe,KAAK,UAAU,CAAC,OAAO,QAAQ,UAAU,MAAM,CAAC,CAAU,CAAC,QACtF,GAAG,aAAa,QAAQ,SAAS,EACnC;EACD,MAAM,aAAa,SAChB,QAAQ,YAAY,QAAQ,UAAU,KAAA,EAAU,CAChD,MAAM,GAAG,MAAM,EAAE,GAAG,cAAc,EAAE,GAAG,CAAC;EAE3C,MAAM,WAAW;GACf,KAAK,OAAO,KAAK,OAAO,MAAM,MAAM,eAAe,KAAK,OAAO,MAAM,eAAe,GAAG;GACvF,KAAK,QAAQ,SAAS,GAAG,IAAI,oBAAoB;GACjD,GAAG,OAAO,KAAK,CAAC,OAAO,aAAa,KAAK,QAAQ,OAAO,KAAK,QAAQ,CAAC,CAAC;GACvE,GAAI,WAAW,SAAS,IAAI,CAAC,KAAK,QAAQ,2BAA2B,KAAK,WAAW,CAAC,CAAC,GAAG,EAAE;GAC5F,KAAK,QACH,SACA,CAAC,qCAAqC,oBAAoB,IAAI,UAAU,CAAC,KAAK,KAAK,CACpF;GACD,KAAK,QACH,YACA;IAAC,KAAK,IAAI;IAA0B,KAAK,IAAI;IAAS,KAAK,IAAI;IAAS,CAAC,KAAK,KAAK,CACpF;GACD,KAAK,QACH,cACA,SAAS,IAAI,2DACd;GACF;AACD,OAAK,IAAI,SAAS,KAAK,OAAO,CAAC;;;;;;CAOjC,eAAyC;AACvC,SAAQ,KAAK,eAAoC,QAC9C,YAAY,QAAQ,OAAO,UAAU,CAAC,QAAQ,SAAS,SAAS,QAAQ,GAAG,CAC7E;;CAGH,YAAoB,SAAiC;AACnD,SAAO,GAAG,eAAe,QAAQ,IAAI,KAAK,OAAO,CAAC;;;;;;;;CASpD,eAAuB,SAAiC;EACtD,MAAM,SAAS,iBAAiB,QAAQ,OAAO,QAAQ,WAAW,QAAQ,eAAe;EACzF,MAAM,CAAC,SAAS,MAAM,KAAK,OAAO,OAAO,CAAC,MAAM,aAAa,EAAE;AAC/D,SAAO,GAAG,SAAS,KAAK,OAAO,OAAO,gBAAgB,OAAO,MAAM,CAAC,QAAQ,OAAO,GAAG,CAAC;;;AAI3F,SAAS,QAAQ,UAAqC,OAAuC;AAC3F,QAAO,SACJ,QAAQ,YAAY,QAAQ,UAAU,MAAM,CAC5C,MACE,GAAG,OACD,EAAE,cAAc,OAAO,qBAAqB,EAAE,cAAc,OAAO,qBACpE,EAAE,GAAG,cAAc,EAAE,GAAG,CAC3B"}