@shell-shock/core 0.17.8 → 0.17.10

package/dist/components/command-validation-logic.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"command-validation-logic.mjs","names":[],"sources":["../../src/components/command-validation-logic.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, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseIfClause,\n  IfStatement,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { list } from \"@stryke/string-format/list\";\nimport type {\n  CommandTree,\n  NumberCommandParameter,\n  StringCommandParameter\n} from \"../types\";\nimport { CommandParameterKinds } from \"../types\";\n\nexport interface CommandValidationLogicProps {\n  command: CommandTree;\n}\n\n/**\n * A component that generates command validation logic for required options and arguments.\n */\nexport function CommandValidationLogic(props: CommandValidationLogicProps) {\n  const { command } = props;\n\n  return (\n    <>\n      <VarDeclaration name=\"failures\" type=\"string[]\" initializer={code`[];`} />\n      <hbr />\n      <For each={Object.values(command.options ?? {})} doubleHardline>\n        {option => (\n          <>\n            <Show when={!option.optional}>\n              <IfStatement\n                condition={code`!options${\n                  option.name.includes(\"?\")\n                    ? `[\"${option.name}\"]`\n                    : `.${camelCase(option.name)}`\n                }`}>\n                {code`failures.push(\"Missing required \\\\\"${option.name}\\\\\" option\");`}\n              </IfStatement>\n              <Show when={option.variadic}>\n                <ElseIfClause\n                  condition={code`options${\n                    option.name.includes(\"?\")\n                      ? `[\"${option.name}\"]`\n                      : `.${camelCase(option.name)}`\n                  }.length === 0`}>\n                  {code`failures.push(\"No values were provided to the required \\\\\"${\n                    option.name\n                  }\\\\\" array option\");`}\n                </ElseIfClause>\n              </Show>\n            </Show>\n            <Show when={option.kind === CommandParameterKinds.number}>\n              <Show\n                when={option.variadic}\n                fallback={\n                  <IfStatement\n                    condition={code`options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    } && Number.isNaN(options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    })`}>\n                    {code`failures.push(\"Invalid numeric value provided for the \\\\\"${\n                      option.name\n                    }\\\\\" option\");`}\n                  </IfStatement>\n                }>\n                <IfStatement\n                  condition={code`options${\n                    option.name.includes(\"?\")\n                      ? `[\"${option.name}\"]`\n                      : `.${camelCase(option.name)}`\n                  }.some(value => Number.isNaN(value))`}>\n                  {code`failures.push(\"Invalid numeric value provided in the \\\\\"${\n                    option.name\n                  }\\\\\" array option\");`}\n                </IfStatement>\n              </Show>\n            </Show>\n            <Show\n              when={\n                (option.kind === CommandParameterKinds.string ||\n                  option.kind === CommandParameterKinds.number) &&\n                option.choices &&\n                option.choices.length > 0\n              }>\n              <Show\n                when={!option.variadic}\n                fallback={\n                  <Show\n                    when={!option.optional}\n                    fallback={\n                      <IfStatement\n                        condition={code`!options${\n                          option.name.includes(\"?\")\n                            ? `[\"${option.name}\"]`\n                            : `.${camelCase(option.name)}`\n                        }.every(value => [${(\n                          option as\n                            | StringCommandParameter\n                            | NumberCommandParameter\n                        ).choices\n                          ?.map(choice =>\n                            option.kind === CommandParameterKinds.string\n                              ? `\"${choice}\"`\n                              : choice\n                          )\n                          .join(\", \")}].includes(value))`}>\n                        {code`failures.push(\\`Invalid value provided for the \\\\\"${\n                          option.name\n                        }\\\\\" option - valid values include: ${list(\n                          (\n                            option as\n                              | StringCommandParameter\n                              | NumberCommandParameter\n                          )?.choices?.map(choice => String(choice)) ?? []\n                        )}; provided: \\${options${\n                          option.name.includes(\"?\")\n                            ? `[\"${option.name}\"]`\n                            : `.${camelCase(option.name)}`\n                        }}\\`);`}\n                      </IfStatement>\n                    }>\n                    <ElseIfClause\n                      condition={code`!options${\n                        option.name.includes(\"?\")\n                          ? `[\"${option.name}\"]`\n                          : `.${camelCase(option.name)}`\n                      }.every(value => [${(\n                        option as\n                          | StringCommandParameter\n                          | NumberCommandParameter\n                      ).choices\n                        ?.map(choice =>\n                          option.kind === CommandParameterKinds.string\n                            ? `\"${choice}\"`\n                            : choice\n                        )\n                        .join(\", \")}].includes(value))`}>\n                      {code`failures.push(\\`Invalid value provided for the \\\\\"${\n                        option.name\n                      }\\\\\" option - valid values include: ${list(\n                        (\n                          option as\n                            | StringCommandParameter\n                            | NumberCommandParameter\n                        )?.choices?.map(choice => String(choice)) ?? []\n                      )}; provided: \\${options${\n                        option.name.includes(\"?\")\n                          ? `[\"${option.name}\"]`\n                          : `.${camelCase(option.name)}`\n                      }}\\`);`}\n                    </ElseIfClause>\n                  </Show>\n                }>\n                <Show\n                  when={!option.optional}\n                  fallback={\n                    <IfStatement\n                      condition={code`![${(\n                        option as\n                          | StringCommandParameter\n                          | NumberCommandParameter\n                      ).choices\n                        ?.map(choice =>\n                          option.kind === CommandParameterKinds.string\n                            ? `\"${choice}\"`\n                            : choice\n                        )\n                        .join(\", \")}].includes(options${\n                        option.name.includes(\"?\")\n                          ? `[\"${option.name}\"]`\n                          : `.${camelCase(option.name)}`\n                      })`}>\n                      {code`failures.push(\\`Invalid value provided for the \\\\\"${\n                        option.name\n                      }\\\\\" option - valid values include: ${list(\n                        (\n                          option as\n                            | StringCommandParameter\n                            | NumberCommandParameter\n                        )?.choices?.map(choice => String(choice)) ?? []\n                      )}; provided: \\${options${\n                        option.name.includes(\"?\")\n                          ? `[\"${option.name}\"]`\n                          : `.${camelCase(option.name)}`\n                      }}\\`);`}\n                    </IfStatement>\n                  }>\n                  <ElseIfClause\n                    condition={code`![${(\n                      option as StringCommandParameter | NumberCommandParameter\n                    ).choices\n                      ?.map(choice =>\n                        option.kind === CommandParameterKinds.string\n                          ? `\"${choice}\"`\n                          : choice\n                      )\n                      .join(\", \")}].includes(options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    })`}>\n                    {code`failures.push(\\`Invalid value provided for the \\\\\"${\n                      option.name\n                    }\\\\\" option - valid values include: ${list(\n                      (\n                        option as\n                          | StringCommandParameter\n                          | NumberCommandParameter\n                      )?.choices?.map(choice => String(choice)) ?? []\n                    )}; provided: \\${options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    }}\\`);`}\n                  </ElseIfClause>\n                </Show>\n              </Show>\n            </Show>\n          </>\n        )}\n      </For>\n      <Spacing />\n      <For each={command.args} doubleHardline>\n        {argument => (\n          <>\n            <Show when={!argument.optional}>\n              <IfStatement condition={code`!${camelCase(argument.name)}`}>\n                {code`failures.push(\"Missing required \\\\\"${\n                  argument.name\n                }\\\\\" positional argument\");`}\n              </IfStatement>\n              <Show when={argument.variadic}>\n                <ElseIfClause\n                  condition={code`${camelCase(argument.name)}.length === 0`}>\n                  {code`failures.push(\"No values were provided to the required \\\\\"${\n                    argument.name\n                  }\\\\\" array positional argument\");`}\n                </ElseIfClause>\n              </Show>\n            </Show>\n            <Show when={argument.kind === CommandParameterKinds.number}>\n              <Show\n                when={(argument as NumberCommandParameter).variadic}\n                fallback={\n                  <IfStatement\n                    condition={code`${camelCase(\n                      argument.name\n                    )} && Number.isNaN(${camelCase(argument.name)})`}>\n                    {code`failures.push(\"Invalid numeric value provided for the \\\\\"${\n                      argument.name\n                    }\\\\\" positional argument\");`}\n                  </IfStatement>\n                }>\n                <IfStatement\n                  condition={code`${camelCase(argument.name)}.some(value => Number.isNaN(value))`}>\n                  {code`failures.push(\"Invalid numeric value provided in the \\\\\"${\n                    argument.name\n                  }\\\\\" array positional argument\");`}\n                </IfStatement>\n              </Show>\n            </Show>\n          </>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"command-validation-logic.mjs","names":[],"sources":["../../src/components/command-validation-logic.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, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseIfClause,\n  IfStatement,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { list } from \"@stryke/string-format/list\";\nimport type {\n  CommandTree,\n  NumberCommandParameter,\n  StringCommandParameter\n} from \"../types\";\nimport { CommandParameterKinds } from \"../types\";\n\nexport interface CommandValidationLogicProps {\n  command: CommandTree;\n}\n\n/**\n * A component that generates command validation logic for required options and arguments.\n */\nexport function CommandValidationLogic(props: CommandValidationLogicProps) {\n  const { command } = props;\n\n  return (\n    <>\n      <VarDeclaration name=\"failures\" type=\"string[]\" initializer={code`[];`} />\n      <hbr />\n      <For each={Object.values(command.options ?? {})} doubleHardline>\n        {option => (\n          <>\n            <Show when={!option.optional}>\n              <IfStatement\n                condition={code`!options${\n                  option.name.includes(\"?\")\n                    ? `[\"${option.name}\"]`\n                    : `.${camelCase(option.name)}`\n                }`}>\n                {code`failures.push(\"Missing required \\\\\"${option.name}\\\\\" option\");`}\n              </IfStatement>\n              <Show when={option.variadic}>\n                <ElseIfClause\n                  condition={code`options${\n                    option.name.includes(\"?\")\n                      ? `[\"${option.name}\"]`\n                      : `.${camelCase(option.name)}`\n                  }.length === 0`}>\n                  {code`failures.push(\"No values were provided to the required \\\\\"${\n                    option.name\n                  }\\\\\" array option\");`}\n                </ElseIfClause>\n              </Show>\n            </Show>\n            <Show when={option.kind === CommandParameterKinds.number}>\n              <Show\n                when={option.variadic}\n                fallback={\n                  <IfStatement\n                    condition={code`options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    } && Number.isNaN(options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    })`}>\n                    {code`failures.push(\"Invalid numeric value provided for the \\\\\"${\n                      option.name\n                    }\\\\\" option\");`}\n                  </IfStatement>\n                }>\n                <IfStatement\n                  condition={code`options${\n                    option.name.includes(\"?\")\n                      ? `[\"${option.name}\"]`\n                      : `.${camelCase(option.name)}`\n                  }.some(value => Number.isNaN(value))`}>\n                  {code`failures.push(\"Invalid numeric value provided in the \\\\\"${\n                    option.name\n                  }\\\\\" array option\");`}\n                </IfStatement>\n              </Show>\n            </Show>\n            <Show\n              when={\n                (option.kind === CommandParameterKinds.string ||\n                  option.kind === CommandParameterKinds.number) &&\n                option.choices &&\n                option.choices.length > 0\n              }>\n              <Show\n                when={!option.variadic}\n                fallback={\n                  <Show\n                    when={!option.optional}\n                    fallback={\n                      <IfStatement\n                        condition={code`!options${\n                          option.name.includes(\"?\")\n                            ? `[\"${option.name}\"]`\n                            : `.${camelCase(option.name)}`\n                        }.every(value => [${(\n                          option as\n                            | StringCommandParameter\n                            | NumberCommandParameter\n                        ).choices\n                          ?.map(choice =>\n                            option.kind === CommandParameterKinds.string\n                              ? `\"${choice}\"`\n                              : choice\n                          )\n                          .join(\", \")}].includes(value))`}>\n                        {code`failures.push(\\`Invalid value provided for the \\\\\"${\n                          option.name\n                        }\\\\\" option - valid values include: ${list(\n                          (\n                            option as\n                              | StringCommandParameter\n                              | NumberCommandParameter\n                          )?.choices?.map(choice => String(choice)) ?? []\n                        )}; provided: \\${options${\n                          option.name.includes(\"?\")\n                            ? `[\"${option.name}\"]`\n                            : `.${camelCase(option.name)}`\n                        }}\\`);`}\n                      </IfStatement>\n                    }>\n                    <ElseIfClause\n                      condition={code`!options${\n                        option.name.includes(\"?\")\n                          ? `[\"${option.name}\"]`\n                          : `.${camelCase(option.name)}`\n                      }.every(value => [${(\n                        option as\n                          | StringCommandParameter\n                          | NumberCommandParameter\n                      ).choices\n                        ?.map(choice =>\n                          option.kind === CommandParameterKinds.string\n                            ? `\"${choice}\"`\n                            : choice\n                        )\n                        .join(\", \")}].includes(value))`}>\n                      {code`failures.push(\\`Invalid value provided for the \\\\\"${\n                        option.name\n                      }\\\\\" option - valid values include: ${list(\n                        (\n                          option as\n                            | StringCommandParameter\n                            | NumberCommandParameter\n                        )?.choices?.map(choice => String(choice)) ?? []\n                      )}; provided: \\${options${\n                        option.name.includes(\"?\")\n                          ? `[\"${option.name}\"]`\n                          : `.${camelCase(option.name)}`\n                      }}\\`);`}\n                    </ElseIfClause>\n                  </Show>\n                }>\n                <Show\n                  when={!option.optional}\n                  fallback={\n                    <IfStatement\n                      condition={code`![${(\n                        option as\n                          | StringCommandParameter\n                          | NumberCommandParameter\n                      ).choices\n                        ?.map(choice =>\n                          option.kind === CommandParameterKinds.string\n                            ? `\"${choice}\"`\n                            : choice\n                        )\n                        .join(\", \")}].includes(options${\n                        option.name.includes(\"?\")\n                          ? `[\"${option.name}\"]`\n                          : `.${camelCase(option.name)}`\n                      })`}>\n                      {code`failures.push(\\`Invalid value provided for the \\\\\"${\n                        option.name\n                      }\\\\\" option - valid values include: ${list(\n                        (\n                          option as\n                            | StringCommandParameter\n                            | NumberCommandParameter\n                        )?.choices?.map(choice => String(choice)) ?? []\n                      )}; provided: \\${options${\n                        option.name.includes(\"?\")\n                          ? `[\"${option.name}\"]`\n                          : `.${camelCase(option.name)}`\n                      }}\\`);`}\n                    </IfStatement>\n                  }>\n                  <ElseIfClause\n                    condition={code`![${(\n                      option as StringCommandParameter | NumberCommandParameter\n                    ).choices\n                      ?.map(choice =>\n                        option.kind === CommandParameterKinds.string\n                          ? `\"${choice}\"`\n                          : choice\n                      )\n                      .join(\", \")}].includes(options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    })`}>\n                    {code`failures.push(\\`Invalid value provided for the \\\\\"${\n                      option.name\n                    }\\\\\" option - valid values include: ${list(\n                      (\n                        option as\n                          | StringCommandParameter\n                          | NumberCommandParameter\n                      )?.choices?.map(choice => String(choice)) ?? []\n                    )}; provided: \\${options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    }}\\`);`}\n                  </ElseIfClause>\n                </Show>\n              </Show>\n            </Show>\n          </>\n        )}\n      </For>\n      <Spacing />\n      <For each={command.args} doubleHardline>\n        {argument => (\n          <>\n            <Show when={!argument.optional}>\n              <IfStatement condition={code`!${camelCase(argument.name)}`}>\n                {code`failures.push(\"Missing required \\\\\"${\n                  argument.name\n                }\\\\\" positional argument\");`}\n              </IfStatement>\n              <Show when={argument.variadic}>\n                <ElseIfClause\n                  condition={code`${camelCase(argument.name)}.length === 0`}>\n                  {code`failures.push(\"No values were provided to the required \\\\\"${\n                    argument.name\n                  }\\\\\" array positional argument\");`}\n                </ElseIfClause>\n              </Show>\n            </Show>\n            <Show when={argument.kind === CommandParameterKinds.number}>\n              <Show\n                when={(argument as NumberCommandParameter).variadic}\n                fallback={\n                  <IfStatement\n                    condition={code`${camelCase(\n                      argument.name\n                    )} && Number.isNaN(${camelCase(argument.name)})`}>\n                    {code`failures.push(\"Invalid numeric value provided for the \\\\\"${\n                      argument.name\n                    }\\\\\" positional argument\");`}\n                  </IfStatement>\n                }>\n                <IfStatement\n                  condition={code`${camelCase(argument.name)}.some(value => Number.isNaN(value))`}>\n                  {code`failures.push(\"Invalid numeric value provided in the \\\\\"${\n                    argument.name\n                  }\\\\\" array positional argument\");`}\n                </IfStatement>\n              </Show>\n            </Show>\n          </>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;AAEE,IAAG,SAAS;;;AA0Bd,MAAE,iCAAW;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;CAMb,MAAO,EACL,YACF;;;GAEE,MAAA;GACE,MAAC;GACH,aAAA,IAAA;GACF,CAAA;EAAM,gBAAU,OAAA,EAAA,CAAA;EAAA,gBAA8B,KAAA;GAC5C,IAAM,OAAE;;;GAGN,gBAAC;GACD,IAAG,WAAA;AACD,WAAM,cAAA,WAAA;KAAA,gBAAA,MAAA;MACL,IAAI,OAAM;AACR,cAAQ,CAAC,OAAC;;MAEX,IAAI,WAAW;AACb,cAAK,CAAA,gBAAA,aAAA;QACH,IAAI,YAAW;AACb,gBAAI,IAAO,WAAK,OAAY,KAAA,SAAA,IAAA,GAAA,KAAA,OAAA,KAAA,MAAA,IAAA,UAAA,OAAA,KAAA;;QAE9B,IAAI,WAAU;AACZ,gBAAK,IAAA,sCAAA,OAAA,KAAA;;QAER,CAAC,EAAE,gBAAa,MAAA;QACf,IAAG,OAAK;AACN,gBAAG,OAAA;;QAEL,IAAI,WAAW;AACb,gBAAO,gBAAe,cAAO;UAC3B,IAAI,YAAQ;AACV,kBAAE,IAAS,UAAK,OAAA,KAAA,SAAA,IAAA,GAAA,KAAA,OAAA,KAAA,MAAA,IAAA,UAAA,OAAA,KAAA,GAAA;;UAElB,IAAI,WAAO;AACT,kBAAK,IAAM,6DAAU,OAAA,KAAA;;UAExB,CAAC;;QAEL,CAAC,CAAC;;MAEN,CAAC;KAAE,gBAAkB,MAAC;MACrB,IAAI,OAAI;AACN,cAAO,OAAE,SAAA,sBAAA;;MAEX,IAAI,WAAU;AACZ,cAAO,gBAAc,MAAO;QAC1B,IAAI,OAAO;AACT,gBAAO,OAAI;;QAEb,IAAI,WAAW;AACb,gBAAO,gBAAkB,aAAa;UACpC,IAAI,YAAI;AACN,kBAAO,IAAC,UAAa,OAAE,KAAQ,SAAQ,IAAM,GAAA,KAAS,OAAO,KAAK,MAAA,IAAA,UAAA,OAAA,KAAA,GAAA,0BAAA,OAAA,KAAA,SAAA,IAAA,GAAA,KAAA,OAAA,KAAA,MAAA,IAAA,UAAA,OAAA,KAAA,GAAA;;UAEpE,IAAI,WAAW;AACb,kBAAE,IAAA,4DAAW,OAAA,KAAA;;UAEhB,CAAC;;QAEJ,IAAI,WAAW;AACb,gBAAO,gBAAe,aAAO;UAC3B,IAAI,YAAQ;AACV,kBAAO,IAAA,UAAS,OAAY,KAAC,SAAS,IAAA,GAAA,KAAA,OAAA,KAAA,MAAA,IAAA,UAAA,OAAA,KAAA,GAAA;;UAExC,IAAI,WAAO;AACT,kBAAK,IAAM,2DAAU,OAAA,KAAA;;UAExB,CAAC;;QAEL,CAAC;;MAEL,CAAC;KAAE,gBAAkB,MAAK;MACzB,IAAI,OAAM;AACR,eAAM,OAAO,SAAS,sBAAA,UAAA,OAAA,SAAA,sBAAA,WAAA,OAAA,WAAA,OAAA,QAAA,SAAA;;MAExB,IAAI,WAAG;AACL,cAAK,gBAAA,MAAA;QACH,IAAI,OAAO;AACT,gBAAE,CAAA,OAAS;;QAEb,IAAI,WAAW;AACb,gBAAM,gBAAS,MAAA;UACb,IAAI,OAAG;AACL,kBAAM,CAAA,OAAS;;UAEjB,IAAI,WAAW;AACb,kBAAO,gBAAkB,aAAa;YACpC,IAAI,YAAQ;AACV,oBAAI,IAAO,WAAA,OAAA,KAAA,SAAA,IAAA,GAAA,KAAA,OAAA,KAAA,MAAA,IAAA,UAAA,OAAA,KAAA,GAAA,mBAAA,OAAA,SAAA,IAAA,cAAA,WAAA,OAAA,SAAA,sBAAA,SAAA,IAAA,OAAA,KAAA,QAAA;cAAA;cAAA;cAAA;cAAA,CAAA,CAAA,CAAA,KAAA,KAAA,CAAA;;YAEb,IAAI,WAAM;AACR,oBAAI,IAAA,qDAAA,OAAA,KAAA,qCAAA,KAAA,QAAA,SAAA,IAAA,cAAA,WAAA,OAAA,OAAA,EAAA;cAAA;cAAA;cAAA;cAAA,CAAA,CAAA,IAAA,EAAA,CAAA,CAAA,wBAAA,OAAA,KAAA,SAAA,IAAA,GAAA,KAAA,OAAA,KAAA,MAAA,IAAA,UAAA,OAAA,KAAA,GAAA;;YAEP,CAAC;;UAEJ,IAAI,WAAW;AACb,kBAAO,gBAAC,cAAA;YACN,IAAI,YAAY;AACd,oBAAO,IAAC,WAAc,OAAE,KAAQ,SAAM,IAAS,GAAG,KAAK,OAAI,KAAA,MAAA,IAAA,UAAA,OAAA,KAAA,GAAA,mBAAA,OAAA,SAAA,IAAA,cAAA,WAAA,OAAA,SAAA,sBAAA,SAAA,IAAA,OAAA,KAAA,QAAA;cAAA;cAAA;cAAA;cAAA,CAAA,CAAA,CAAA,KAAA,KAAA,CAAA;;YAE7D,IAAI,WAAW;AACb,oBAAI,IAAA,qDAAA,OAAA,KAAA,qCAAA,KAAA,QAAA,SAAA,IAAA,cAAA,WAAA,OAAA,OAAA,EAAA;cAAA;cAAA;cAAA;cAAA,CAAA,CAAA,IAAA,EAAA,CAAA,CAAA,wBAAA,OAAA,KAAA,SAAA,IAAA,GAAA,KAAA,OAAA,KAAA,MAAA,IAAA,UAAA,OAAA,KAAA,GAAA;;YAEP,CAAC;;UAEL,CAAC;;QAEJ,IAAI,WAAU;AACZ,gBAAO,gBAAc,MAAO;UAC1B,IAAI,OAAO;AACT,kBAAO,CAAC,OAAK;;UAEf,IAAI,WAAC;AACH,kBAAG,gBAAA,aAAA;YACD,IAAE,YAAW;AACX,oBAAE,IAAO,KAAK,OAAS,SAAG,IAAA,cAAA,WAAA,OAAA,SAAA,sBAAA,SAAA,IAAA,OAAA,KAAA,QAAA;cAAA;cAAA;cAAA;cAAA,CAAA,CAAA,CAAA,KAAA,KAAA,CAAA,oBAAA,OAAA,KAAA,SAAA,IAAA,GAAA,KAAA,OAAA,KAAA,MAAA,IAAA,UAAA,OAAA,KAAA,GAAA;;YAE5B,IAAI,WAAQ;AACV,oBAAO,IAAC,qDAAY,OAAA,KAAA,qCAAA,KAAA,QAAA,SAAA,IAAA,cAAA,WAAA,OAAA,OAAA,EAAA;cAAA;cAAA;cAAA;cAAA,CAAA,CAAA,IAAA,EAAA,CAAA,CAAA,wBAAA,OAAA,KAAA,SAAA,IAAA,GAAA,KAAA,OAAA,KAAA,MAAA,IAAA,UAAA,OAAA,KAAA,GAAA;;YAEvB,CAAC;;UAEJ,IAAI,WAAI;AACN,kBAAO,gBAAa,cAAA;YAClB,IAAI,YAAS;AACX,oBAAO,IAAI,KAAC,OAAQ,SAAA,IAAA,cAAA,WAAA,OAAA,SAAA,sBAAA,SAAA,IAAA,OAAA,KAAA,QAAA;cAAA;cAAA;cAAA;cAAA,CAAA,CAAA,CAAA,KAAA,KAAA,CAAA,oBAAA,OAAA,KAAA,SAAA,IAAA,GAAA,KAAA,OAAA,KAAA,MAAA,IAAA,UAAA,OAAA,KAAA,GAAA;;YAEtB,IAAI,WAAA;AACF,oBAAO,IAAI,qDAAuB,OAAA,KAAA,qCAAA,KAAA,QAAA,SAAA,IAAA,cAAA,WAAA,OAAA,OAAA,EAAA;cAAA;cAAA;cAAA;cAAA,CAAA,CAAA,IAAA,EAAA,CAAA,CAAA,wBAAA,OAAA,KAAA,SAAA,IAAA,GAAA,KAAA,OAAA,KAAA,MAAA,IAAA,UAAA,OAAA,KAAA,GAAA;;YAErC,CAAC;;UAEL,CAAC;;QAEL,CAAC;;MAEL,CAAC;KAAC,EAAE;KAAC;KAAU;KAAI;KAAU,CAAA;;GAEjC,CAAC;EAAE,gBAAkB,SAAO,EAAI,CAAC;EAAA,gBAAY,KAAA;GAC5C,IAAI,OAAO;AACT,WAAO,QAAQ;;GAEjB,gBAAgB;GAChB,IAAI,WAAW;AACb,WAAO,cAAI,aAAA,CAAA,gBAAA,MAAA;KACT,IAAI,OAAK;AACP,aAAO,CAAC,SAAO;;KAEjB,IAAI,WAAS;AACX,aAAO,CAAC,gBAAe,aAAS;OAC9B,IAAI,YAAQ;AACV,eAAO,IAAI,IAAG,UAAA,SAAA,KAAA;;OAEhB,IAAI,WAAQ;AACV,eAAO,IAAI,sCAAa,SAAA,KAAA;;OAE3B,CAAC,EAAE,gBAAkB,MAAE;OACtB,IAAI,OAAO;AACT,eAAO,SAAG;;OAEZ,IAAI,WAAQ;AACV,eAAO,gBAAkB,cAAQ;SAC/B,IAAI,YAAY;AACd,iBAAO,IAAC,GAAA,UAAA,SAAA,KAAA,CAAA;;SAEV,IAAI,WAAW;AACb,iBAAO,IAAE,6DAAqC,SAAA,KAAA;;SAEjD,CAAC;;OAEL,CAAC,CAAC;;KAEN,CAAC,EAAE,gBAAgB,MAAQ;KAC1B,IAAI,OAAO;AACT,aAAO,SAAS,SAAO,sBAAc;;KAEvC,IAAI,WAAW;AACb,aAAO,gBAAgB,MAAA;OACrB,IAAI,OAAG;AACL,eAAK,SAAA;;OAEP,IAAI,WAAM;AACR,eAAO,gBAAC,aAAA;SACN,IAAI,YAAQ;AACV,iBAAM,IAAA,GAAO,UAAS,SAAA,KAAA,CAAA,mBAAsB,UAAA,SAAA,KAAA,CAAA;;SAE9C,IAAI,WAAQ;AACV,iBAAI,IAAA,4DAAA,SAAA,KAAA;;SAEP,CAAC;;OAEJ,IAAI,WAAW;AACb,eAAO,gBAAG,aAAA;SACR,IAAI,YAAM;AACR,iBAAI,IAAO,GAAA,UAAA,SAAA,KAAA,CAAA;;SAEb,IAAI,WAAE;AACJ,iBAAM,IAAA,2DAAO,SAAA,KAAA;;SAEhB,CAAC;;OAEL,CAAC;;KAEL,CAAC,CAAC,EAAE;KAAC;KAAY;KAAI;KAAU,CAAA;;GAEnC,CAAC;EAAC;;AAEL,uBAAsB,SAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA"}

package/dist/components/docs.cjs

@@ -1 +1,265 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`../contexts/command.cjs`),t=require(`../helpers/docs-helpers.cjs`),n=require(`../plugin-utils/context-helpers.cjs`),r=require(`../plugin-utils/reflect.cjs`),i=require(`./usage.cjs`);let a=require(`@alloy-js/core/jsx-runtime`),o=require(`defu`),s=require(`@alloy-js/core`),c=require(`@alloy-js/markdown`),l=require(`@powerlines/plugin-alloy/core/components/spacing`),u=require(`@powerlines/plugin-alloy/core/contexts/context`),d=require(`@powerlines/plugin-alloy/markdown/components/markdown-file`),f=require(`@powerlines/plugin-alloy/markdown/components/markdown-table`),p=require(`@stryke/path/join`);const m=[`T`,`Required`,`l+e#!e"!fRb!Pde"!gN##w"y`],h=[`T`,`Partial`,`l+e#!e"!fRb!Pde"!gN#"w"y`];function g(e,t){return e.__type=t,e}const _=[`CommandTree`,`command`,`The command to generate options documentation for.`,`CommandOptionsDocsProps`,`P"w!4"?#Mw$y`];function v(e){let{command:t}=e;return Object.keys(t.options).length===0?s.code`This command does not have any options.`:(0,a.createComponent)(f.MarkdownTable,{get data(){return r.sortOptions(Object.values(t.options)).map(g(e=>({name:e.name.trim(),description:e.description.trim(),defaultValue:e.default?String(e.default)?.includes(`"`)?e.default:`\`${Array.isArray(e.default)?e.default.join(`, `):e.default}\``:``,required:e.optional||e.default?``:`✔`}),[`option`,``,`P"2!"/"`]))}})}v.__type=[()=>_,`props`,`CommandOptionsDocs`,`Generates the options markdown documentation for a command.`,`Pn!2""/#?$`];const y=[`npm`,`yarn`,`pnpm`,`bun`,`packageManager`,`npm`,`The package manager to generate the usage example for.`,`CommandTree`,`command`,`The command to generate the usage example for.`,`CommandDocsUsageExampleProps`,`PP.!.".#.$J4%8>&?'"w(4)?*Mw+y`];function b(e){let{packageManager:t=`npm`,command:r}=e,o=(u.usePowerlines.Ω=[[`Context`,`"w!`]],(0,u.usePowerlines)());return[(0,a.createIntrinsic)(`hbr`,{}),s.code`\`\`\`bash `,(0,a.createIntrinsic)(`hbr`,{}),(0,a.createComponent)(i.Usage,{command:r,get bin(){return n.getAppBin(o)},packageManager:t}),(0,a.createIntrinsic)(`hbr`,{}),s.code`\`\`\``,(0,a.createIntrinsic)(`hbr`,{})]}b.__type=[()=>y,`props`,`CommandDocsUsageExample`,`Generates the markdown documentation for a command.`,`Pn!2""/#?$`];const x=[`levelOffset`,0,`The heading level offset to apply to the generated documentation.`,`CommandTree`,`command`,`The command to generate options documentation for.`,()=>m,()=>y,`packageManager`,`usageExamples`,'`["npm"]`',`Optional usage examples to include in the documentation.`,`CommandDocsProps`,`P'4!8>"?#"w$4%?&n(o'".)fF4*8>+?,Mw-y`];function S(e){let{levelOffset:t=0,command:n,usageExamples:r}=e;return[(0,a.createComponent)(c.Heading,{level:1+t,get children(){return n.title}}),(0,a.createComponent)(l.Spacing,{}),(0,a.memo)(()=>s.code`${n.description}`),(0,a.createComponent)(l.Spacing,{}),(0,a.createComponent)(c.Heading,{level:2+t,children:`Usage`}),(0,a.createComponent)(l.Spacing,{}),(0,a.memo)(()=>s.code`The ${n.name} command can be executed using the following syntax: `),(0,a.createComponent)(l.Spacing,{}),(0,a.createComponent)(s.Show,{get when(){return r&&r.length>0},get fallback(){return(0,a.createComponent)(b,{packageManager:`npm`,command:n})},get children(){return(0,a.createComponent)(s.For,{each:r,hardline:!0,get children(){return g(e=>(0,a.createComponent)(b,{packageManager:e,command:n}),[`packageManager`,``,`P"2!"/"`])}})}}),(0,a.createComponent)(l.Spacing,{}),(0,a.createComponent)(c.Heading,{level:2+t,children:`Options`}),(0,a.createComponent)(l.Spacing,{}),(0,a.memo)(()=>s.code`The following options are available for the ${n.name} command:`),(0,a.createComponent)(l.Spacing,{}),(0,a.createComponent)(v,{command:n}),(0,a.createComponent)(l.Spacing,{})]}S.__type=[()=>x,`props`,`CommandDocs`,`Generates the markdown documentation for a command.`,`Pn!2""/#?$`];const C=[()=>h,`levelOffset`,0,`The heading level offset to apply to the generated documentation.`,`CommandTree`,`command`,`The command to generate documentation for.`,`CommandDocsFileProps`,`P!o!"'4"8>#?$"w%4&?'Mw(y`];function w(n){let{levelOffset:r=0,command:i,frontMatter:c,...l}=n,f=(u.usePowerlines.Ω=[[`Context`,`"w!`]],(0,u.usePowerlines)()),m=(0,s.memo)(()=>[`npm`,`yarn`,`pnpm`,`bun`]);return(0,a.createComponent)(e.CommandContext.Provider,{value:i,get children(){return(0,a.createComponent)(d.MarkdownFile,(0,a.mergeProps)({get path(){return(0,p.joinPaths)(t.getDocsOutputPath(f),`${i.path}.md`)}},l,{get frontMatter(){return(0,o.defu)(c??{},{id:i.id,name:i.name,path:i.path,reference:i.reference,isVirtual:i.isVirtual,title:i.title,description:i.description,tags:i.tags})},get children(){return(0,a.createComponent)(S,{levelOffset:r,command:i,get usageExamples(){return m()}})}}))}})}w.__type=[()=>C,`props`,`CommandDocsFile`,`Generates the markdown documentation file for a command.`,`Pn!2""/#?$`],exports.CommandDocs=S,exports.CommandDocsFile=w,exports.CommandDocsUsageExample=b,exports.CommandOptionsDocs=v,exports.__ΩCommandDocsFileProps=C,exports.__ΩCommandDocsProps=x,exports.__ΩCommandDocsUsageExampleProps=y,exports.__ΩCommandOptionsDocsProps=_;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_contexts_command = require('../contexts/command.cjs');
+const require_docs_helpers = require('../helpers/docs-helpers.cjs');
+const require_context_helpers = require('../plugin-utils/context-helpers.cjs');
+const require_reflect = require('../plugin-utils/reflect.cjs');
+const require_components_usage = require('./usage.cjs');
+let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let defu = require("defu");
+let _alloy_js_core = require("@alloy-js/core");
+let _alloy_js_markdown = require("@alloy-js/markdown");
+let _powerlines_plugin_alloy_core_components_spacing = require("@powerlines/plugin-alloy/core/components/spacing");
+let _powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
+let _powerlines_plugin_alloy_markdown_components_markdown_file = require("@powerlines/plugin-alloy/markdown/components/markdown-file");
+let _powerlines_plugin_alloy_markdown_components_markdown_table = require("@powerlines/plugin-alloy/markdown/components/markdown-table");
+let _stryke_path_join = require("@stryke/path/join");
+
+//#region src/components/docs.tsx
+const __ΩRequired = [
+	"T",
+	"Required",
+	"l+e#!e\"!fRb!Pde\"!gN##w\"y"
+];
+const __ΩPartial = [
+	"T",
+	"Partial",
+	"l+e#!e\"!fRb!Pde\"!gN#\"w\"y"
+];
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+const __ΩCommandOptionsDocsProps = [
+	"CommandTree",
+	"command",
+	"The command to generate options documentation for.",
+	"CommandOptionsDocsProps",
+	"P\"w!4\"?#Mw$y"
+];
+/**
+* Generates the options markdown documentation for a command.
+*/
+function CommandOptionsDocs(props) {
+	const { command } = props;
+	if (Object.keys(command.options).length === 0) return _alloy_js_core.code`This command does not have any options.`;
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_markdown_components_markdown_table.MarkdownTable, { get data() {
+		return require_reflect.sortOptions(Object.values(command.options)).map(__assignType((option) => {
+			return {
+				name: option.name.trim(),
+				description: option.description.trim(),
+				defaultValue: option.default ? String(option.default)?.includes("\"") ? option.default : `\`${Array.isArray(option.default) ? option.default.join(", ") : option.default}\`` : "",
+				required: option.optional || option.default ? "" : "✔"
+			};
+		}, [
+			"option",
+			"",
+			"P\"2!\"/\""
+		]));
+	} });
+}
+CommandOptionsDocs.__type = [
+	() => __ΩCommandOptionsDocsProps,
+	"props",
+	"CommandOptionsDocs",
+	"Generates the options markdown documentation for a command.",
+	"Pn!2\"\"/#?$"
+];
+const __ΩCommandDocsUsageExampleProps = [
+	"npm",
+	"yarn",
+	"pnpm",
+	"bun",
+	"packageManager",
+	"npm",
+	"The package manager to generate the usage example for.",
+	"CommandTree",
+	"command",
+	"The command to generate the usage example for.",
+	"CommandDocsUsageExampleProps",
+	"PP.!.\".#.$J4%8>&?'\"w(4)?*Mw+y"
+];
+/**
+* Generates the markdown documentation for a command.
+*/
+function CommandDocsUsageExample(props) {
+	const { packageManager = "npm", command } = props;
+	const context = (_powerlines_plugin_alloy_core_contexts_context.usePowerlines.Ω = [["Context", "\"w!"]], (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)());
+	return [
+		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		_alloy_js_core.code`\`\`\`bash `,
+		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(require_components_usage.Usage, {
+			command,
+			get bin() {
+				return require_context_helpers.getAppBin(context);
+			},
+			packageManager
+		}),
+		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		_alloy_js_core.code`\`\`\``,
+		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
+	];
+}
+CommandDocsUsageExample.__type = [
+	() => __ΩCommandDocsUsageExampleProps,
+	"props",
+	"CommandDocsUsageExample",
+	"Generates the markdown documentation for a command.",
+	"Pn!2\"\"/#?$"
+];
+const __ΩCommandDocsProps = [
+	"levelOffset",
+	0,
+	"The heading level offset to apply to the generated documentation.",
+	"CommandTree",
+	"command",
+	"The command to generate options documentation for.",
+	() => __ΩRequired,
+	() => __ΩCommandDocsUsageExampleProps,
+	"packageManager",
+	"usageExamples",
+	"`[\"npm\"]`",
+	"Optional usage examples to include in the documentation.",
+	"CommandDocsProps",
+	"P'4!8>\"?#\"w$4%?&n(o'\".)fF4*8>+?,Mw-y"
+];
+/**
+* Generates the markdown documentation for a command.
+*/
+function CommandDocs(props) {
+	const { levelOffset = 0, command, usageExamples } = props;
+	return [
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_markdown.Heading, {
+			level: 1 + levelOffset,
+			get children() {
+				return command.title;
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`${command.description}`),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_markdown.Heading, {
+			level: 2 + levelOffset,
+			children: "Usage"
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`The ${command.name} command can be executed using the following syntax: `),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+			get when() {
+				return usageExamples && usageExamples.length > 0;
+			},
+			get fallback() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(CommandDocsUsageExample, {
+					packageManager: "npm",
+					command
+				});
+			},
+			get children() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
+					each: usageExamples,
+					hardline: true,
+					get children() {
+						return __assignType((packageManager) => (0, _alloy_js_core_jsx_runtime.createComponent)(CommandDocsUsageExample, {
+							packageManager,
+							command
+						}), [
+							"packageManager",
+							"",
+							"P\"2!\"/\""
+						]);
+					}
+				});
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_markdown.Heading, {
+			level: 2 + levelOffset,
+			children: "Options"
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`The following options are available for the ${command.name} command:`),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(CommandOptionsDocs, { command }),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {})
+	];
+}
+CommandDocs.__type = [
+	() => __ΩCommandDocsProps,
+	"props",
+	"CommandDocs",
+	"Generates the markdown documentation for a command.",
+	"Pn!2\"\"/#?$"
+];
+const __ΩCommandDocsFileProps = [
+	() => __ΩPartial,
+	"levelOffset",
+	0,
+	"The heading level offset to apply to the generated documentation.",
+	"CommandTree",
+	"command",
+	"The command to generate documentation for.",
+	"CommandDocsFileProps",
+	"P!o!\"'4\"8>#?$\"w%4&?'Mw(y"
+];
+/**
+* Generates the markdown documentation file for a command.
+*/
+function CommandDocsFile(props) {
+	const { levelOffset = 0, command, frontMatter, ...rest } = props;
+	const context = (_powerlines_plugin_alloy_core_contexts_context.usePowerlines.Ω = [["Context", "\"w!"]], (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)());
+	const usageExamples = (0, _alloy_js_core.memo)(() => [
+		"npm",
+		"yarn",
+		"pnpm",
+		"bun"
+	]);
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(require_contexts_command.CommandContext.Provider, {
+		value: command,
+		get children() {
+			return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_markdown_components_markdown_file.MarkdownFile, (0, _alloy_js_core_jsx_runtime.mergeProps)({ get path() {
+				return (0, _stryke_path_join.joinPaths)(require_docs_helpers.getDocsOutputPath(context), `${command.path}.md`);
+			} }, rest, {
+				get frontMatter() {
+					return (0, defu.defu)(frontMatter ?? {}, {
+						id: command.id,
+						name: command.name,
+						path: command.path,
+						reference: command.reference,
+						isVirtual: command.isVirtual,
+						title: command.title,
+						description: command.description,
+						tags: command.tags
+					});
+				},
+				get children() {
+					return (0, _alloy_js_core_jsx_runtime.createComponent)(CommandDocs, {
+						levelOffset,
+						command,
+						get usageExamples() {
+							return usageExamples();
+						}
+					});
+				}
+			}));
+		}
+	});
+}
+CommandDocsFile.__type = [
+	() => __ΩCommandDocsFileProps,
+	"props",
+	"CommandDocsFile",
+	"Generates the markdown documentation file for a command.",
+	"Pn!2\"\"/#?$"
+];
+
+//#endregion
+exports.CommandDocs = CommandDocs;
+exports.CommandDocsFile = CommandDocsFile;
+exports.CommandDocsUsageExample = CommandDocsUsageExample;
+exports.CommandOptionsDocs = CommandOptionsDocs;
+exports.__ΩCommandDocsFileProps = __ΩCommandDocsFileProps;
+exports.__ΩCommandDocsProps = __ΩCommandDocsProps;
+exports.__ΩCommandDocsUsageExampleProps = __ΩCommandDocsUsageExampleProps;
+exports.__ΩCommandOptionsDocsProps = __ΩCommandOptionsDocsProps;

package/dist/components/docs.mjs

@@ -1,2 +1,257 @@
-import{CommandContext as e}from"../contexts/command.mjs";import{getDocsOutputPath as t}from"../helpers/docs-helpers.mjs";import{getAppBin as n}from"../plugin-utils/context-helpers.mjs";import{sortOptions as r}from"../plugin-utils/reflect.mjs";import{Usage as i}from"./usage.mjs";import{createComponent as a,createIntrinsic as o,memo as s,mergeProps as c}from"@alloy-js/core/jsx-runtime";import{defu as l}from"defu";import{For as u,Show as d,code as f,memo as p}from"@alloy-js/core";import{Heading as m}from"@alloy-js/markdown";import{Spacing as h}from"@powerlines/plugin-alloy/core/components/spacing";import{usePowerlines as g}from"@powerlines/plugin-alloy/core/contexts/context";import{MarkdownFile as _}from"@powerlines/plugin-alloy/markdown/components/markdown-file";import{MarkdownTable as v}from"@powerlines/plugin-alloy/markdown/components/markdown-table";import{joinPaths as y}from"@stryke/path/join";const b=[`T`,`Required`,`l+e#!e"!fRb!Pde"!gN##w"y`],x=[`T`,`Partial`,`l+e#!e"!fRb!Pde"!gN#"w"y`];function S(e,t){return e.__type=t,e}const C=[`CommandTree`,`command`,`The command to generate options documentation for.`,`CommandOptionsDocsProps`,`P"w!4"?#Mw$y`];function w(e){let{command:t}=e;return Object.keys(t.options).length===0?f`This command does not have any options.`:a(v,{get data(){return r(Object.values(t.options)).map(S(e=>({name:e.name.trim(),description:e.description.trim(),defaultValue:e.default?String(e.default)?.includes(`"`)?e.default:`\`${Array.isArray(e.default)?e.default.join(`, `):e.default}\``:``,required:e.optional||e.default?``:`✔`}),[`option`,``,`P"2!"/"`]))}})}w.__type=[()=>C,`props`,`CommandOptionsDocs`,`Generates the options markdown documentation for a command.`,`Pn!2""/#?$`];const T=[`npm`,`yarn`,`pnpm`,`bun`,`packageManager`,`npm`,`The package manager to generate the usage example for.`,`CommandTree`,`command`,`The command to generate the usage example for.`,`CommandDocsUsageExampleProps`,`PP.!.".#.$J4%8>&?'"w(4)?*Mw+y`];function E(e){let{packageManager:t=`npm`,command:r}=e,s=(g.Ω=[[`Context`,`"w!`]],g());return[o(`hbr`,{}),f`\`\`\`bash `,o(`hbr`,{}),a(i,{command:r,get bin(){return n(s)},packageManager:t}),o(`hbr`,{}),f`\`\`\``,o(`hbr`,{})]}E.__type=[()=>T,`props`,`CommandDocsUsageExample`,`Generates the markdown documentation for a command.`,`Pn!2""/#?$`];const D=[`levelOffset`,0,`The heading level offset to apply to the generated documentation.`,`CommandTree`,`command`,`The command to generate options documentation for.`,()=>b,()=>T,`packageManager`,`usageExamples`,'`["npm"]`',`Optional usage examples to include in the documentation.`,`CommandDocsProps`,`P'4!8>"?#"w$4%?&n(o'".)fF4*8>+?,Mw-y`];function O(e){let{levelOffset:t=0,command:n,usageExamples:r}=e;return[a(m,{level:1+t,get children(){return n.title}}),a(h,{}),s(()=>f`${n.description}`),a(h,{}),a(m,{level:2+t,children:`Usage`}),a(h,{}),s(()=>f`The ${n.name} command can be executed using the following syntax: `),a(h,{}),a(d,{get when(){return r&&r.length>0},get fallback(){return a(E,{packageManager:`npm`,command:n})},get children(){return a(u,{each:r,hardline:!0,get children(){return S(e=>a(E,{packageManager:e,command:n}),[`packageManager`,``,`P"2!"/"`])}})}}),a(h,{}),a(m,{level:2+t,children:`Options`}),a(h,{}),s(()=>f`The following options are available for the ${n.name} command:`),a(h,{}),a(w,{command:n}),a(h,{})]}O.__type=[()=>D,`props`,`CommandDocs`,`Generates the markdown documentation for a command.`,`Pn!2""/#?$`];const k=[()=>x,`levelOffset`,0,`The heading level offset to apply to the generated documentation.`,`CommandTree`,`command`,`The command to generate documentation for.`,`CommandDocsFileProps`,`P!o!"'4"8>#?$"w%4&?'Mw(y`];function A(n){let{levelOffset:r=0,command:i,frontMatter:o,...s}=n,u=(g.Ω=[[`Context`,`"w!`]],g()),d=p(()=>[`npm`,`yarn`,`pnpm`,`bun`]);return a(e.Provider,{value:i,get children(){return a(_,c({get path(){return y(t(u),`${i.path}.md`)}},s,{get frontMatter(){return l(o??{},{id:i.id,name:i.name,path:i.path,reference:i.reference,isVirtual:i.isVirtual,title:i.title,description:i.description,tags:i.tags})},get children(){return a(O,{levelOffset:r,command:i,get usageExamples(){return d()}})}}))}})}A.__type=[()=>k,`props`,`CommandDocsFile`,`Generates the markdown documentation file for a command.`,`Pn!2""/#?$`];export{O as CommandDocs,A as CommandDocsFile,E as CommandDocsUsageExample,w as CommandOptionsDocs,k as __ΩCommandDocsFileProps,D as __ΩCommandDocsProps,T as __ΩCommandDocsUsageExampleProps,C as __ΩCommandOptionsDocsProps};
+import { CommandContext } from "../contexts/command.mjs";
+import { getDocsOutputPath } from "../helpers/docs-helpers.mjs";
+import { getAppBin } from "../plugin-utils/context-helpers.mjs";
+import { sortOptions } from "../plugin-utils/reflect.mjs";
+import { Usage } from "./usage.mjs";
+import { createComponent, createIntrinsic, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { defu } from "defu";
+import { For, Show, code, memo as memo$1 } from "@alloy-js/core";
+import { Heading } from "@alloy-js/markdown";
+import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
+import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
+import { MarkdownFile } from "@powerlines/plugin-alloy/markdown/components/markdown-file";
+import { MarkdownTable } from "@powerlines/plugin-alloy/markdown/components/markdown-table";
+import { joinPaths } from "@stryke/path/join";
+
+//#region src/components/docs.tsx
+const __ΩRequired = [
+	"T",
+	"Required",
+	"l+e#!e\"!fRb!Pde\"!gN##w\"y"
+];
+const __ΩPartial = [
+	"T",
+	"Partial",
+	"l+e#!e\"!fRb!Pde\"!gN#\"w\"y"
+];
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+const __ΩCommandOptionsDocsProps = [
+	"CommandTree",
+	"command",
+	"The command to generate options documentation for.",
+	"CommandOptionsDocsProps",
+	"P\"w!4\"?#Mw$y"
+];
+/**
+* Generates the options markdown documentation for a command.
+*/
+function CommandOptionsDocs(props) {
+	const { command } = props;
+	if (Object.keys(command.options).length === 0) return code`This command does not have any options.`;
+	return createComponent(MarkdownTable, { get data() {
+		return sortOptions(Object.values(command.options)).map(__assignType((option) => {
+			return {
+				name: option.name.trim(),
+				description: option.description.trim(),
+				defaultValue: option.default ? String(option.default)?.includes("\"") ? option.default : `\`${Array.isArray(option.default) ? option.default.join(", ") : option.default}\`` : "",
+				required: option.optional || option.default ? "" : "✔"
+			};
+		}, [
+			"option",
+			"",
+			"P\"2!\"/\""
+		]));
+	} });
+}
+CommandOptionsDocs.__type = [
+	() => __ΩCommandOptionsDocsProps,
+	"props",
+	"CommandOptionsDocs",
+	"Generates the options markdown documentation for a command.",
+	"Pn!2\"\"/#?$"
+];
+const __ΩCommandDocsUsageExampleProps = [
+	"npm",
+	"yarn",
+	"pnpm",
+	"bun",
+	"packageManager",
+	"npm",
+	"The package manager to generate the usage example for.",
+	"CommandTree",
+	"command",
+	"The command to generate the usage example for.",
+	"CommandDocsUsageExampleProps",
+	"PP.!.\".#.$J4%8>&?'\"w(4)?*Mw+y"
+];
+/**
+* Generates the markdown documentation for a command.
+*/
+function CommandDocsUsageExample(props) {
+	const { packageManager = "npm", command } = props;
+	const context = (usePowerlines.Ω = [["Context", "\"w!"]], usePowerlines());
+	return [
+		createIntrinsic("hbr", {}),
+		code`\`\`\`bash `,
+		createIntrinsic("hbr", {}),
+		createComponent(Usage, {
+			command,
+			get bin() {
+				return getAppBin(context);
+			},
+			packageManager
+		}),
+		createIntrinsic("hbr", {}),
+		code`\`\`\``,
+		createIntrinsic("hbr", {})
+	];
+}
+CommandDocsUsageExample.__type = [
+	() => __ΩCommandDocsUsageExampleProps,
+	"props",
+	"CommandDocsUsageExample",
+	"Generates the markdown documentation for a command.",
+	"Pn!2\"\"/#?$"
+];
+const __ΩCommandDocsProps = [
+	"levelOffset",
+	0,
+	"The heading level offset to apply to the generated documentation.",
+	"CommandTree",
+	"command",
+	"The command to generate options documentation for.",
+	() => __ΩRequired,
+	() => __ΩCommandDocsUsageExampleProps,
+	"packageManager",
+	"usageExamples",
+	"`[\"npm\"]`",
+	"Optional usage examples to include in the documentation.",
+	"CommandDocsProps",
+	"P'4!8>\"?#\"w$4%?&n(o'\".)fF4*8>+?,Mw-y"
+];
+/**
+* Generates the markdown documentation for a command.
+*/
+function CommandDocs(props) {
+	const { levelOffset = 0, command, usageExamples } = props;
+	return [
+		createComponent(Heading, {
+			level: 1 + levelOffset,
+			get children() {
+				return command.title;
+			}
+		}),
+		createComponent(Spacing, {}),
+		memo(() => code`${command.description}`),
+		createComponent(Spacing, {}),
+		createComponent(Heading, {
+			level: 2 + levelOffset,
+			children: "Usage"
+		}),
+		createComponent(Spacing, {}),
+		memo(() => code`The ${command.name} command can be executed using the following syntax: `),
+		createComponent(Spacing, {}),
+		createComponent(Show, {
+			get when() {
+				return usageExamples && usageExamples.length > 0;
+			},
+			get fallback() {
+				return createComponent(CommandDocsUsageExample, {
+					packageManager: "npm",
+					command
+				});
+			},
+			get children() {
+				return createComponent(For, {
+					each: usageExamples,
+					hardline: true,
+					get children() {
+						return __assignType((packageManager) => createComponent(CommandDocsUsageExample, {
+							packageManager,
+							command
+						}), [
+							"packageManager",
+							"",
+							"P\"2!\"/\""
+						]);
+					}
+				});
+			}
+		}),
+		createComponent(Spacing, {}),
+		createComponent(Heading, {
+			level: 2 + levelOffset,
+			children: "Options"
+		}),
+		createComponent(Spacing, {}),
+		memo(() => code`The following options are available for the ${command.name} command:`),
+		createComponent(Spacing, {}),
+		createComponent(CommandOptionsDocs, { command }),
+		createComponent(Spacing, {})
+	];
+}
+CommandDocs.__type = [
+	() => __ΩCommandDocsProps,
+	"props",
+	"CommandDocs",
+	"Generates the markdown documentation for a command.",
+	"Pn!2\"\"/#?$"
+];
+const __ΩCommandDocsFileProps = [
+	() => __ΩPartial,
+	"levelOffset",
+	0,
+	"The heading level offset to apply to the generated documentation.",
+	"CommandTree",
+	"command",
+	"The command to generate documentation for.",
+	"CommandDocsFileProps",
+	"P!o!\"'4\"8>#?$\"w%4&?'Mw(y"
+];
+/**
+* Generates the markdown documentation file for a command.
+*/
+function CommandDocsFile(props) {
+	const { levelOffset = 0, command, frontMatter, ...rest } = props;
+	const context = (usePowerlines.Ω = [["Context", "\"w!"]], usePowerlines());
+	const usageExamples = memo$1(() => [
+		"npm",
+		"yarn",
+		"pnpm",
+		"bun"
+	]);
+	return createComponent(CommandContext.Provider, {
+		value: command,
+		get children() {
+			return createComponent(MarkdownFile, mergeProps({ get path() {
+				return joinPaths(getDocsOutputPath(context), `${command.path}.md`);
+			} }, rest, {
+				get frontMatter() {
+					return defu(frontMatter ?? {}, {
+						id: command.id,
+						name: command.name,
+						path: command.path,
+						reference: command.reference,
+						isVirtual: command.isVirtual,
+						title: command.title,
+						description: command.description,
+						tags: command.tags
+					});
+				},
+				get children() {
+					return createComponent(CommandDocs, {
+						levelOffset,
+						command,
+						get usageExamples() {
+							return usageExamples();
+						}
+					});
+				}
+			}));
+		}
+	});
+}
+CommandDocsFile.__type = [
+	() => __ΩCommandDocsFileProps,
+	"props",
+	"CommandDocsFile",
+	"Generates the markdown documentation file for a command.",
+	"Pn!2\"\"/#?$"
+];
+
+//#endregion
+export { CommandDocs, CommandDocsFile, CommandDocsUsageExample, CommandOptionsDocs, __ΩCommandDocsFileProps, __ΩCommandDocsProps, __ΩCommandDocsUsageExampleProps, __ΩCommandOptionsDocsProps };
 //# sourceMappingURL=docs.mjs.map