@powerlines/plugin-alloy 0.25.33 → 0.25.35

package/dist/typescript/components/tsdoc.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"tsdoc.mjs","names":[],"sources":["../../../src/typescript/components/tsdoc.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\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/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport {\n  Children,\n  childrenArray,\n  computed,\n  For,\n  List,\n  Prose,\n  Show,\n  splitProps\n} from \"@alloy-js/core\";\nimport { JSDocExampleProps, ParameterDescriptor } from \"@alloy-js/typescript\";\nimport { stringifyDefaultValue } from \"@powerlines/deepkit/utilities\";\nimport {\n  ReflectionKind,\n  ReflectionParameter,\n  ReflectionProperty\n} from \"@powerlines/deepkit/vendor/type\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isUndefined } from \"@stryke/type-checks/is-undefined\";\nimport { Spacing } from \"../../core/components/spacing\";\nimport { usePowerlinesSafe } from \"../../core/contexts/context\";\nimport { ComponentProps } from \"../../types/components\";\n\nexport interface TSDocProps extends ComponentProps {\n  heading?: Children;\n}\n\n/**\n * Generates a TypeScript interface for the given reflection class.\n */\nexport function TSDoc(props: TSDocProps) {\n  const [{ children, heading }] = splitProps(props, [\"children\", \"heading\"]);\n\n  return (\n    <>\n      /**\n      <align string=\" * \">\n        <hbr />\n        <Show when={!isUndefined(heading)}>{heading}</Show>\n        <Show\n          when={\n            !isUndefined(children) &&\n            childrenArray(() => children).filter(Boolean).length > 0\n          }>\n          <Show when={!isUndefined(heading)}>\n            <Spacing />\n          </Show>\n          <List>{childrenArray(() => children)}</List>\n        </Show>\n      </align>\n      <hbr />\n      {`*/`}\n      <hbr />\n    </>\n  );\n}\n\nexport interface TSDocTagProps extends ComponentProps {\n  tag: string;\n}\n\n/**\n * Create a TSDoc `@<props.tag>` tag.\n */\nexport function TSDocTag(props: TSDocTagProps) {\n  const [{ children, tag }] = splitProps(props, [\"children\", \"tag\"]);\n\n  return (\n    <>\n      {`@${tag} `}\n      <Show when={Boolean(children)}>\n        <align width={2}>\n          <Prose>{children}</Prose>\n        </align>\n      </Show>\n      <sbr />\n    </>\n  );\n}\n\nexport interface TSDocParamsProps {\n  parameters: ParameterDescriptor[] | string[];\n}\n\n/**\n * A component that creates a TSDoc block with `@param` tags for each parameter.\n */\nexport function TSDocParams(props: TSDocParamsProps) {\n  const parameters = normalizeParametersForDoc(props.parameters);\n\n  return (\n    <For each={parameters}>\n      {param => (\n        <TSDocParam name={param.name} optional={param.optional}>\n          {param.doc}\n        </TSDocParam>\n      )}\n    </For>\n  );\n}\n\nfunction normalizeParametersForDoc(\n  parameters: ParameterDescriptor[] | string[]\n): ParameterDescriptor[] {\n  if (parameters.some(p => typeof p === \"string\")) {\n    return [];\n  }\n\n  return parameters as ParameterDescriptor[];\n}\n\n/**\n * Create a TSDoc `@title` tag.\n */\nexport function TSDocTitle(props: ComponentProps) {\n  const [{ children }, rest] = splitProps(props, [\"children\"]);\n\n  return (\n    <TSDocTag {...rest} tag=\"title\">\n      {children}\n    </TSDocTag>\n  );\n}\n\n/**\n * Create a TSDoc `@domain` tag.\n */\nexport function TSDocDomain(props: ComponentProps) {\n  const [{ children }, rest] = splitProps(props, [\"children\"]);\n\n  return (\n    <TSDocTag {...rest} tag=\"domain\">\n      {children}\n    </TSDocTag>\n  );\n}\n\n/**\n * Create a TSDoc `@alias` tag.\n */\nexport function TSDocAlias(props: ComponentProps) {\n  const [{ children }, rest] = splitProps(props, [\"children\"]);\n\n  return (\n    <TSDocTag {...rest} tag=\"alias\">\n      {children}\n    </TSDocTag>\n  );\n}\n\n/**\n * Create a TSDoc `@permission` tag.\n */\nexport function TSDocPermission(props: ComponentProps) {\n  const [{ children }, rest] = splitProps(props, [\"children\"]);\n\n  return (\n    <TSDocTag {...rest} tag=\"permission\">\n      {children}\n    </TSDocTag>\n  );\n}\n\nexport interface TSDocDefaultValueProps extends ComponentProps {\n  type: ReflectionKind | ReflectionProperty | ReflectionParameter;\n  defaultValue: any;\n}\n\n/**\n * Create a TSDoc `@defaultValue` tag.\n */\nexport function TSDocDefaultValue(props: TSDocDefaultValueProps) {\n  const [{ type, defaultValue }] = splitProps(props, [\"type\", \"defaultValue\"]);\n\n  return (\n    <>\n      {\"@defaultValue \"}\n      <Show when={!isUndefined(defaultValue)}>\n        <align width={2}>\n          <Prose>{stringifyDefaultValue(type, defaultValue)}</Prose>\n        </align>\n      </Show>\n    </>\n  );\n}\n\n/**\n * Create a TSDoc `@remarks` tag.\n */\nexport function TSDocRemarks(props: ComponentProps) {\n  return (\n    <>\n      {\"@remarks \"}\n      <hbr />\n      <List hardline={true}>{childrenArray(() => props.children)}</List>\n    </>\n  );\n}\n\n/**\n * Create a TSDoc `@see` tag.\n */\nexport function TSDocLink(props: ComponentProps) {\n  return <TSDocTag {...props} tag=\"see\" />;\n}\n\nexport interface TSDocExampleProps extends JSDocExampleProps {\n  /**\n   * Whether the file is a TSX file.\n   *\n   * @defaultValue false\n   */\n  tsx?: boolean;\n}\n\n/**\n * Create a TSDoc `@example` tag.\n */\nexport function TSDocExample(props: TSDocExampleProps) {\n  const [{ tsx, fenced = true, language, children }] = splitProps(props, [\n    \"tsx\",\n    \"fenced\",\n    \"language\",\n    \"children\"\n  ]);\n\n  return (\n    <>\n      {\"@example \"}\n      <hbr />\n      <Show when={fenced}>\n        ```{language || (tsx ? \"tsx\" : \"ts\")}\n        <hbr />\n      </Show>\n      {children}\n      <Show when={fenced}>\n        <hbr />\n        ```\n      </Show>\n    </>\n  );\n}\n\n/**\n * Create a TSDoc `@readonly` tag.\n */\nexport function TSDocReadonly() {\n  return <TSDocTag tag=\"readonly\" />;\n}\n\n/**\n * Create a TSDoc `@internal` tag.\n */\nexport function TSDocInternal() {\n  return <TSDocTag tag=\"internal\" />;\n}\n\n/**\n * Create a TSDoc `@ignore` tag.\n */\nexport function TSDocIgnore() {\n  return <TSDocTag tag=\"ignore\" />;\n}\n\n/**\n * Create a TSDoc `@hidden` tag.\n */\nexport function TSDocHidden() {\n  return <TSDocTag tag=\"hidden\" />;\n}\n\nexport interface TSDocAttributesTagsProps {\n  type?: ReflectionKind | ReflectionProperty | ReflectionParameter;\n  title?: string;\n  alias?: string[];\n  permission?: string[];\n  domain?: string;\n  readonly?: boolean;\n  internal?: boolean;\n  ignore?: boolean;\n  hidden?: boolean;\n  defaultValue?: any;\n}\n\n/**\n * Generates a TypeScript interface property for the given reflection class.\n */\nexport function TSDocAttributesTags(props: TSDocAttributesTagsProps) {\n  const [\n    {\n      type,\n      alias,\n      permission,\n      readonly,\n      internal,\n      ignore,\n      hidden,\n      defaultValue\n    }\n  ] = splitProps(props, [\n    \"type\",\n    \"alias\",\n    \"permission\",\n    \"readonly\",\n    \"internal\",\n    \"ignore\",\n    \"hidden\",\n    \"defaultValue\"\n  ]);\n\n  const title = computed(() => props.title?.trim() || \"\");\n  const domain = computed(() => props.domain?.trim() || \"\");\n\n  return (\n    <>\n      <Show when={isSetString(title.value)}>\n        <TSDocTitle>{title.value}</TSDocTitle>\n      </Show>\n      <Show\n        when={\n          !isUndefined(alias) &&\n          alias.length > 0 &&\n          alias.some(a => isSetString(a?.trim()))\n        }>\n        <For each={alias?.filter(a => isSetString(a?.trim())) ?? []}>\n          {alias => <TSDocAlias>{alias}</TSDocAlias>}\n        </For>\n      </Show>\n      <Show when={isSetString(domain.value)}>\n        <TSDocDomain>{domain.value}</TSDocDomain>\n      </Show>\n      <Show\n        when={\n          !isUndefined(permission) &&\n          permission.length > 0 &&\n          permission.some(p => isSetString(p?.trim()))\n        }>\n        <For each={permission?.filter(p => isSetString(p?.trim())) ?? []}>\n          {permission => <TSDocPermission>{permission}</TSDocPermission>}\n        </For>\n      </Show>\n      <Show when={readonly === true}>\n        <TSDocReadonly />\n      </Show>\n      <Show when={internal === true}>\n        <TSDocInternal />\n      </Show>\n      <Show when={ignore === true}>\n        <TSDocIgnore />\n      </Show>\n      <Show when={hidden === true}>\n        <TSDocHidden />\n      </Show>\n      <Show when={!isUndefined(type) && !isUndefined(defaultValue)}>\n        <TSDocDefaultValue\n          type={\n            type as ReflectionKind | ReflectionProperty | ReflectionParameter\n          }\n          defaultValue={defaultValue}\n        />\n      </Show>\n    </>\n  );\n}\n\nexport interface TSDocParamProps {\n  name: Children;\n  children?: Children;\n  optional?: boolean;\n  defaultValue?: Children;\n}\n\n/**\n * Create a TSDoc parameter set off with `@param`.\n */\nexport function TSDocParam(props: TSDocParamProps) {\n  return (\n    <>\n      {\"@param \"}\n      <TSDocParamName\n        name={props.name}\n        optional={props.optional}\n        defaultValue={props.defaultValue}\n      />\n      <TSDocParamDescription children={props.children} />\n    </>\n  );\n}\n\ninterface TSDocParamNameProps {\n  name: Children;\n  optional?: boolean;\n  defaultValue?: Children;\n}\n\nfunction TSDocParamName(props: TSDocParamNameProps) {\n  return (\n    <>\n      <Show when={props.optional}>{\"[\"}</Show>\n      {props.name}\n      <Show when={Boolean(props.defaultValue)}>={props.defaultValue}</Show>\n      <Show when={props.optional}>{\"]\"}</Show>\n    </>\n  );\n}\n\ninterface TSDocParamDescriptionProps {\n  children?: Children;\n}\n\nfunction TSDocParamDescription(props: TSDocParamDescriptionProps) {\n  return (\n    <Show when={Boolean(props.children)}>\n      {\" - \"}\n      <align width={2}>\n        <Prose>{props.children}</Prose>\n      </align>\n    </Show>\n  );\n}\n\n/**\n * Create a TSDoc `@returns` tag.\n */\nexport function TSDocReturns(props: ComponentProps) {\n  return <TSDocTag {...props} tag=\"returns\" />;\n}\n\n/**\n * Create a TSDoc `@throws` tag.\n */\nexport function TSDocThrows(props: ComponentProps) {\n  return <TSDocTag {...props} tag=\"throws\" />;\n}\n\nexport interface TSDocModuleProps extends ComponentProps {\n  /**\n   * The prefix for the builtin module name\n   *\n   * @remarks\n   * This value is populated from the Powerlines configuration output builtin prefix by default.\n   *\n   * @example\n   * ```ts\n   * /**\n   *  @module powerlines:my-module\n   *  \\/\n   * ```\n   */\n  prefix?: string;\n\n  /**\n   * The name of the module\n   *\n   * @remarks\n   * This will be used in the `@module` tag as well as the import path for the module, e.g. `storm:<name>`.\n   *\n   * @example\n   * ```ts\n   * import { MyModule } from \"powerlines:my-module\";\n   * ```\n   */\n  name: Children;\n}\n\n/**\n * Generates a TSDoc `@module` tag for the given module name.\n */\nexport function TSDocModule(props: TSDocModuleProps) {\n  const [{ children, name, prefix }] = splitProps(props, [\n    \"children\",\n    \"name\",\n    \"prefix\"\n  ]);\n\n  const context = usePowerlinesSafe();\n\n  return (\n    <>\n      /**\n      <align string=\" * \">\n        <hbr />\n        <Show when={Boolean(children)}>\n          <List hardline={true}>{childrenArray(() => children)}</List>\n          <Spacing />\n        </Show>\n        {\"@module \"}\n        {prefix || context?.config?.framework || \"powerlines\"}:{name}\n      </align>\n      <hbr />\n      {` */`}\n    </>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"tsdoc.mjs","names":[],"sources":["../../../src/typescript/components/tsdoc.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\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/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport {\n  Children,\n  childrenArray,\n  computed,\n  For,\n  List,\n  Prose,\n  Show,\n  splitProps\n} from \"@alloy-js/core\";\nimport { JSDocExampleProps, ParameterDescriptor } from \"@alloy-js/typescript\";\nimport { stringifyDefaultValue } from \"@powerlines/deepkit/utilities\";\nimport {\n  ReflectionKind,\n  ReflectionParameter,\n  ReflectionProperty\n} from \"@powerlines/deepkit/vendor/type\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isUndefined } from \"@stryke/type-checks/is-undefined\";\nimport { Spacing } from \"../../core/components/spacing\";\nimport { usePowerlinesSafe } from \"../../core/contexts/context\";\nimport { ComponentProps } from \"../../types/components\";\n\nexport interface TSDocProps extends ComponentProps {\n  heading?: Children;\n}\n\n/**\n * Generates a TypeScript interface for the given reflection class.\n */\nexport function TSDoc(props: TSDocProps) {\n  const [{ children, heading }] = splitProps(props, [\"children\", \"heading\"]);\n\n  return (\n    <>\n      /**\n      <align string=\" * \">\n        <hbr />\n        <Show when={!isUndefined(heading)}>{heading}</Show>\n        <Show\n          when={\n            !isUndefined(children) &&\n            childrenArray(() => children).filter(Boolean).length > 0\n          }>\n          <Show when={!isUndefined(heading)}>\n            <Spacing />\n          </Show>\n          <List>{childrenArray(() => children)}</List>\n        </Show>\n      </align>\n      <hbr />\n      {`*/`}\n      <hbr />\n    </>\n  );\n}\n\nexport interface TSDocTagProps extends ComponentProps {\n  tag: string;\n}\n\n/**\n * Create a TSDoc `@<props.tag>` tag.\n */\nexport function TSDocTag(props: TSDocTagProps) {\n  const [{ children, tag }] = splitProps(props, [\"children\", \"tag\"]);\n\n  return (\n    <>\n      {`@${tag} `}\n      <Show when={Boolean(children)}>\n        <align width={2}>\n          <Prose>{children}</Prose>\n        </align>\n      </Show>\n      <sbr />\n    </>\n  );\n}\n\nexport interface TSDocParamsProps {\n  parameters: ParameterDescriptor[] | string[];\n}\n\n/**\n * A component that creates a TSDoc block with `@param` tags for each parameter.\n */\nexport function TSDocParams(props: TSDocParamsProps) {\n  const parameters = normalizeParametersForDoc(props.parameters);\n\n  return (\n    <For each={parameters}>\n      {param => (\n        <TSDocParam name={param.name} optional={param.optional}>\n          {param.doc}\n        </TSDocParam>\n      )}\n    </For>\n  );\n}\n\nfunction normalizeParametersForDoc(\n  parameters: ParameterDescriptor[] | string[]\n): ParameterDescriptor[] {\n  if (parameters.some(p => typeof p === \"string\")) {\n    return [];\n  }\n\n  return parameters as ParameterDescriptor[];\n}\n\n/**\n * Create a TSDoc `@title` tag.\n */\nexport function TSDocTitle(props: ComponentProps) {\n  const [{ children }, rest] = splitProps(props, [\"children\"]);\n\n  return (\n    <TSDocTag {...rest} tag=\"title\">\n      {children}\n    </TSDocTag>\n  );\n}\n\n/**\n * Create a TSDoc `@domain` tag.\n */\nexport function TSDocDomain(props: ComponentProps) {\n  const [{ children }, rest] = splitProps(props, [\"children\"]);\n\n  return (\n    <TSDocTag {...rest} tag=\"domain\">\n      {children}\n    </TSDocTag>\n  );\n}\n\n/**\n * Create a TSDoc `@alias` tag.\n */\nexport function TSDocAlias(props: ComponentProps) {\n  const [{ children }, rest] = splitProps(props, [\"children\"]);\n\n  return (\n    <TSDocTag {...rest} tag=\"alias\">\n      {children}\n    </TSDocTag>\n  );\n}\n\n/**\n * Create a TSDoc `@permission` tag.\n */\nexport function TSDocPermission(props: ComponentProps) {\n  const [{ children }, rest] = splitProps(props, [\"children\"]);\n\n  return (\n    <TSDocTag {...rest} tag=\"permission\">\n      {children}\n    </TSDocTag>\n  );\n}\n\nexport interface TSDocDefaultValueProps extends ComponentProps {\n  type: ReflectionKind | ReflectionProperty | ReflectionParameter;\n  defaultValue: any;\n}\n\n/**\n * Create a TSDoc `@defaultValue` tag.\n */\nexport function TSDocDefaultValue(props: TSDocDefaultValueProps) {\n  const [{ type, defaultValue }] = splitProps(props, [\"type\", \"defaultValue\"]);\n\n  return (\n    <>\n      {\"@defaultValue \"}\n      <Show when={!isUndefined(defaultValue)}>\n        <align width={2}>\n          <Prose>{stringifyDefaultValue(type, defaultValue)}</Prose>\n        </align>\n      </Show>\n    </>\n  );\n}\n\n/**\n * Create a TSDoc `@remarks` tag.\n */\nexport function TSDocRemarks(props: ComponentProps) {\n  return (\n    <>\n      {\"@remarks \"}\n      <hbr />\n      <List hardline={true}>{childrenArray(() => props.children)}</List>\n    </>\n  );\n}\n\n/**\n * Create a TSDoc `@see` tag.\n */\nexport function TSDocLink(props: ComponentProps) {\n  return <TSDocTag {...props} tag=\"see\" />;\n}\n\nexport interface TSDocExampleProps extends JSDocExampleProps {\n  /**\n   * Whether the file is a TSX file.\n   *\n   * @defaultValue false\n   */\n  tsx?: boolean;\n}\n\n/**\n * Create a TSDoc `@example` tag.\n */\nexport function TSDocExample(props: TSDocExampleProps) {\n  const [{ tsx, fenced = true, language, children }] = splitProps(props, [\n    \"tsx\",\n    \"fenced\",\n    \"language\",\n    \"children\"\n  ]);\n\n  return (\n    <>\n      {\"@example \"}\n      <hbr />\n      <Show when={fenced}>\n        ```{language || (tsx ? \"tsx\" : \"ts\")}\n        <hbr />\n      </Show>\n      {children}\n      <Show when={fenced}>\n        <hbr />\n        ```\n      </Show>\n    </>\n  );\n}\n\n/**\n * Create a TSDoc `@readonly` tag.\n */\nexport function TSDocReadonly() {\n  return <TSDocTag tag=\"readonly\" />;\n}\n\n/**\n * Create a TSDoc `@internal` tag.\n */\nexport function TSDocInternal() {\n  return <TSDocTag tag=\"internal\" />;\n}\n\n/**\n * Create a TSDoc `@ignore` tag.\n */\nexport function TSDocIgnore() {\n  return <TSDocTag tag=\"ignore\" />;\n}\n\n/**\n * Create a TSDoc `@hidden` tag.\n */\nexport function TSDocHidden() {\n  return <TSDocTag tag=\"hidden\" />;\n}\n\nexport interface TSDocAttributesTagsProps {\n  type?: ReflectionKind | ReflectionProperty | ReflectionParameter;\n  title?: string;\n  alias?: string[];\n  permission?: string[];\n  domain?: string;\n  readonly?: boolean;\n  internal?: boolean;\n  ignore?: boolean;\n  hidden?: boolean;\n  defaultValue?: any;\n}\n\n/**\n * Generates a TypeScript interface property for the given reflection class.\n */\nexport function TSDocAttributesTags(props: TSDocAttributesTagsProps) {\n  const [\n    {\n      type,\n      alias,\n      permission,\n      readonly,\n      internal,\n      ignore,\n      hidden,\n      defaultValue\n    }\n  ] = splitProps(props, [\n    \"type\",\n    \"alias\",\n    \"permission\",\n    \"readonly\",\n    \"internal\",\n    \"ignore\",\n    \"hidden\",\n    \"defaultValue\"\n  ]);\n\n  const title = computed(() => props.title?.trim() || \"\");\n  const domain = computed(() => props.domain?.trim() || \"\");\n\n  return (\n    <>\n      <Show when={isSetString(title.value)}>\n        <TSDocTitle>{title.value}</TSDocTitle>\n      </Show>\n      <Show\n        when={\n          !isUndefined(alias) &&\n          alias.length > 0 &&\n          alias.some(a => isSetString(a?.trim()))\n        }>\n        <For each={alias?.filter(a => isSetString(a?.trim())) ?? []}>\n          {alias => <TSDocAlias>{alias}</TSDocAlias>}\n        </For>\n      </Show>\n      <Show when={isSetString(domain.value)}>\n        <TSDocDomain>{domain.value}</TSDocDomain>\n      </Show>\n      <Show\n        when={\n          !isUndefined(permission) &&\n          permission.length > 0 &&\n          permission.some(p => isSetString(p?.trim()))\n        }>\n        <For each={permission?.filter(p => isSetString(p?.trim())) ?? []}>\n          {permission => <TSDocPermission>{permission}</TSDocPermission>}\n        </For>\n      </Show>\n      <Show when={readonly === true}>\n        <TSDocReadonly />\n      </Show>\n      <Show when={internal === true}>\n        <TSDocInternal />\n      </Show>\n      <Show when={ignore === true}>\n        <TSDocIgnore />\n      </Show>\n      <Show when={hidden === true}>\n        <TSDocHidden />\n      </Show>\n      <Show when={!isUndefined(type) && !isUndefined(defaultValue)}>\n        <TSDocDefaultValue\n          type={\n            type as ReflectionKind | ReflectionProperty | ReflectionParameter\n          }\n          defaultValue={defaultValue}\n        />\n      </Show>\n    </>\n  );\n}\n\nexport interface TSDocParamProps {\n  name: Children;\n  children?: Children;\n  optional?: boolean;\n  defaultValue?: Children;\n}\n\n/**\n * Create a TSDoc parameter set off with `@param`.\n */\nexport function TSDocParam(props: TSDocParamProps) {\n  return (\n    <>\n      {\"@param \"}\n      <TSDocParamName\n        name={props.name}\n        optional={props.optional}\n        defaultValue={props.defaultValue}\n      />\n      <TSDocParamDescription children={props.children} />\n    </>\n  );\n}\n\ninterface TSDocParamNameProps {\n  name: Children;\n  optional?: boolean;\n  defaultValue?: Children;\n}\n\nfunction TSDocParamName(props: TSDocParamNameProps) {\n  return (\n    <>\n      <Show when={props.optional}>{\"[\"}</Show>\n      {props.name}\n      <Show when={Boolean(props.defaultValue)}>={props.defaultValue}</Show>\n      <Show when={props.optional}>{\"]\"}</Show>\n    </>\n  );\n}\n\ninterface TSDocParamDescriptionProps {\n  children?: Children;\n}\n\nfunction TSDocParamDescription(props: TSDocParamDescriptionProps) {\n  return (\n    <Show when={Boolean(props.children)}>\n      {\" - \"}\n      <align width={2}>\n        <Prose>{props.children}</Prose>\n      </align>\n    </Show>\n  );\n}\n\n/**\n * Create a TSDoc `@returns` tag.\n */\nexport function TSDocReturns(props: ComponentProps) {\n  return <TSDocTag {...props} tag=\"returns\" />;\n}\n\n/**\n * Create a TSDoc `@throws` tag.\n */\nexport function TSDocThrows(props: ComponentProps) {\n  return <TSDocTag {...props} tag=\"throws\" />;\n}\n\nexport interface TSDocModuleProps extends ComponentProps {\n  /**\n   * The prefix for the builtin module name\n   *\n   * @remarks\n   * This value is populated from the Powerlines configuration output builtin prefix by default.\n   *\n   * @example\n   * ```ts\n   * /**\n   *  @module powerlines:my-module\n   *  \\/\n   * ```\n   */\n  prefix?: string;\n\n  /**\n   * The name of the module\n   *\n   * @remarks\n   * This will be used in the `@module` tag as well as the import path for the module, e.g. `storm:<name>`.\n   *\n   * @example\n   * ```ts\n   * import { MyModule } from \"powerlines:my-module\";\n   * ```\n   */\n  name: Children;\n}\n\n/**\n * Generates a TSDoc `@module` tag for the given module name.\n */\nexport function TSDocModule(props: TSDocModuleProps) {\n  const [{ children, name, prefix }] = splitProps(props, [\n    \"children\",\n    \"name\",\n    \"prefix\"\n  ]);\n\n  const context = usePowerlinesSafe();\n\n  return (\n    <>\n      /**\n      <align string=\" * \">\n        <hbr />\n        <Show when={Boolean(children)}>\n          <List hardline={true}>{childrenArray(() => children)}</List>\n          <Spacing />\n        </Show>\n        {\"@module \"}\n        {prefix || context?.config?.framework || \"powerlines\"}:{name}\n      </align>\n      <hbr />\n      {` */`}\n    </>\n  );\n}\n"],"mappings":"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"}

package/dist/typescript/components/type-declaration.cjs

@@ -2,8 +2,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
 const require_typescript_components_tsdoc = require('./tsdoc.cjs');
 const require_typescript_components_type_parameters = require('./type-parameters.cjs');
-let _alloy_js_core = require("@alloy-js/core");
 let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let _alloy_js_core = require("@alloy-js/core");
 let _alloy_js_typescript = require("@alloy-js/typescript");
 
 //#region src/typescript/components/type-declaration.tsx
@@ -12,22 +12,27 @@ let _alloy_js_typescript = require("@alloy-js/typescript");
 */
 const TypeDeclaration = (0, _alloy_js_typescript.ensureTypeRefContext)(function TypeDeclaration(props) {
 	const { children, doc, typeParameters, ...rest } = props;
-	return /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsxs)(_alloy_js_core_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_core.Show, {
-		when: Boolean(doc),
-		children: /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(require_typescript_components_tsdoc.TSDoc, { heading: doc })
-	}), /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsxs)(_alloy_js_typescript.Declaration, {
-		...rest,
+	return [(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+		get when() {
+			return Boolean(doc);
+		},
+		get children() {
+			return (0, _alloy_js_core_jsx_runtime.createComponent)(require_typescript_components_tsdoc.TSDoc, { heading: doc });
+		}
+	}), (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.Declaration, (0, _alloy_js_core_jsx_runtime.mergeProps)(rest, {
 		kind: "type",
 		nameKind: "type",
-		children: [
-			"type ",
-			/* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_core.Name, {}),
-			typeParameters && /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(require_typescript_components_type_parameters.TypeParameters, { parameters: typeParameters }),
-			" = ",
-			children,
-			";"
-		]
-	})] });
+		get children() {
+			return [
+				"type ",
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Name, {}),
+				(0, _alloy_js_core_jsx_runtime.memo)(() => typeParameters && (0, _alloy_js_core_jsx_runtime.createComponent)(require_typescript_components_type_parameters.TypeParameters, { parameters: typeParameters })),
+				" = ",
+				children,
+				";"
+			];
+		}
+	}))];
 });
 
 //#endregion

package/dist/typescript/components/type-declaration.mjs

@@ -1,7 +1,7 @@
 import { TSDoc } from "./tsdoc.mjs";
 import { TypeParameters } from "./type-parameters.mjs";
+import { createComponent, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
 import { Name, Show } from "@alloy-js/core";
-import { Fragment, jsx, jsxs } from "@alloy-js/core/jsx-runtime";
 import { Declaration as Declaration$1, ensureTypeRefContext } from "@alloy-js/typescript";
 
 //#region src/typescript/components/type-declaration.tsx
@@ -10,22 +10,27 @@ import { Declaration as Declaration$1, ensureTypeRefContext } from "@alloy-js/ty
 */
 const TypeDeclaration = ensureTypeRefContext(function TypeDeclaration(props) {
 	const { children, doc, typeParameters, ...rest } = props;
-	return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(Show, {
-		when: Boolean(doc),
-		children: /* @__PURE__ */ jsx(TSDoc, { heading: doc })
-	}), /* @__PURE__ */ jsxs(Declaration$1, {
-		...rest,
+	return [createComponent(Show, {
+		get when() {
+			return Boolean(doc);
+		},
+		get children() {
+			return createComponent(TSDoc, { heading: doc });
+		}
+	}), createComponent(Declaration$1, mergeProps(rest, {
 		kind: "type",
 		nameKind: "type",
-		children: [
-			"type ",
-			/* @__PURE__ */ jsx(Name, {}),
-			typeParameters && /* @__PURE__ */ jsx(TypeParameters, { parameters: typeParameters }),
-			" = ",
-			children,
-			";"
-		]
-	})] });
+		get children() {
+			return [
+				"type ",
+				createComponent(Name, {}),
+				memo(() => typeParameters && createComponent(TypeParameters, { parameters: typeParameters })),
+				" = ",
+				children,
+				";"
+			];
+		}
+	}))];
 });
 
 //#endregion

package/dist/typescript/components/type-declaration.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"type-declaration.mjs","names":["Declaration"],"sources":["../../../src/typescript/components/type-declaration.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\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/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { Name, Show } from \"@alloy-js/core\";\nimport {\n  CommonDeclarationProps,\n  Declaration,\n  ensureTypeRefContext,\n  TypeParameterDescriptor\n} from \"@alloy-js/typescript\";\nimport { TSDoc } from \"./tsdoc\";\nimport { TypeParameters } from \"./type-parameters\";\n\nexport interface TypeDeclarationProps extends CommonDeclarationProps {\n  /**\n   * The generic type parameters of the interface.\n   */\n  typeParameters?: TypeParameterDescriptor[] | string[];\n}\n\n/**\n * Renders a TypeScript type declaration, including its name, optional TSDoc comment, and generic type parameters.\n */\nexport const TypeDeclaration = ensureTypeRefContext(function TypeDeclaration(\n  props: TypeDeclarationProps\n) {\n  const { children, doc, typeParameters, ...rest } = props;\n\n  return (\n    <>\n      <Show when={Boolean(doc)}>\n        <TSDoc heading={doc} />\n      </Show>\n      <Declaration {...rest} kind=\"type\" nameKind=\"type\">\n        type <Name />\n        {typeParameters && (\n          <TypeParameters parameters={typeParameters} />\n        )} = {children};\n      </Declaration>\n    </>\n  );\n});\n"],"mappings":";;;;;;;;;;AAsCA,MAAa,kBAAkB,qBAAqB,SAAS,gBAC3D,OACA;CACA,MAAM,EAAE,UAAU,KAAK,gBAAgB,GAAG,SAAS;AAEnD,QACE,4CACE,oBAAC,MAAD;EAAM,MAAM,QAAQ,IAAI;YACtB,oBAAC,OAAD,EAAO,SAAS,KAAO;EAClB,GACP,qBAACA,eAAD;EAAa,GAAI;EAAM,MAAK;EAAO,UAAS;YAA5C;GAAmD;GAC5C,oBAAC,MAAD,EAAQ;GACZ,kBACC,oBAAC,gBAAD,EAAgB,YAAY,gBAAkB;GAC9C;GAAI;GAAS;GACH;IACb;EAEL"}
+{"version":3,"file":"type-declaration.mjs","names":[],"sources":["../../../src/typescript/components/type-declaration.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\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/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { Name, Show } from \"@alloy-js/core\";\nimport {\n  CommonDeclarationProps,\n  Declaration,\n  ensureTypeRefContext,\n  TypeParameterDescriptor\n} from \"@alloy-js/typescript\";\nimport { TSDoc } from \"./tsdoc\";\nimport { TypeParameters } from \"./type-parameters\";\n\nexport interface TypeDeclarationProps extends CommonDeclarationProps {\n  /**\n   * The generic type parameters of the interface.\n   */\n  typeParameters?: TypeParameterDescriptor[] | string[];\n}\n\n/**\n * Renders a TypeScript type declaration, including its name, optional TSDoc comment, and generic type parameters.\n */\nexport const TypeDeclaration = ensureTypeRefContext(function TypeDeclaration(\n  props: TypeDeclarationProps\n) {\n  const { children, doc, typeParameters, ...rest } = props;\n\n  return (\n    <>\n      <Show when={Boolean(doc)}>\n        <TSDoc heading={doc} />\n      </Show>\n      <Declaration {...rest} kind=\"type\" nameKind=\"type\">\n        type <Name />\n        {typeParameters && (\n          <TypeParameters parameters={typeParameters} />\n        )} = {children};\n      </Declaration>\n    </>\n  );\n});\n"],"mappings":";;;;;;;;;;AAiCA,MAAA,kBAAA,qBAAA,SAAA,gBAAA,OAAA;SAEE,UACC,KACD,gBACF,GAAO,SACL;AACA,QAAA,CAAA,gBAAA,MAAA;EACA,IAAM,OAAE;;;EAGN,IAAC,WAAA;AACC,UAAM,gBAAmB,OAAA,EACvB,SAAO,KACR,CAAC;;EAEL,CAAC,EAAE,gBAAc,eAAA,WAAA,MAAA;EAChB,MAAK;EACL,UAAO;EACP,IAAI,WAAM;AACR,UAAE;IAAA;IAAW,gBAAA,MAAA,EAAA,CAAA;IAAA,WAAA,kBAAA,gBAAA,gBAAA,EACb,YAAA,gBACH,CAAA,CAAA;IAAA;IAAA;IAAA;IAAA"}

package/dist/typescript/components/type-parameters.cjs

@@ -1,29 +1,49 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
-let _alloy_js_core = require("@alloy-js/core");
 let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let _alloy_js_core = require("@alloy-js/core");
 let _alloy_js_typescript = require("@alloy-js/typescript");
 
 //#region src/typescript/components/type-parameters.tsx
 function typeParameter(param) {
-	return /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsxs)(_alloy_js_core.Show, {
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
 		when: typeof param === "object",
-		fallback: /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_core_jsx_runtime.Fragment, { children: param }),
-		children: [/* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsxs)("group", { children: [
-			param.name,
-			/* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsxs)(_alloy_js_core.Show, {
-				when: !!param.extends,
-				children: [
-					" ",
-					"extends",
-					/* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsxs)("indent", { children: [" ", /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_typescript.TypeRefContext, { children: param.extends })] })
-				]
-			}),
-			/* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsxs)(_alloy_js_core.Show, {
-				when: !!param.default,
-				children: [" = ", /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_typescript.TypeRefContext, { children: param.default })]
-			})
-		] }), " "]
+		get fallback() {
+			return [param];
+		},
+		get children() {
+			return [(0, _alloy_js_core_jsx_runtime.createIntrinsic)("group", { get children() {
+				return [
+					(0, _alloy_js_core_jsx_runtime.memo)(() => param.name),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+						get when() {
+							return !!param.extends;
+						},
+						get children() {
+							return [
+								" ",
+								"extends",
+								(0, _alloy_js_core_jsx_runtime.createIntrinsic)("indent", { get children() {
+									return [" ", (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.TypeRefContext, { get children() {
+										return param.extends;
+									} })];
+								} })
+							];
+						}
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+						get when() {
+							return !!param.default;
+						},
+						get children() {
+							return [" = ", (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.TypeRefContext, { get children() {
+								return param.default;
+							} })];
+						}
+					})
+				];
+			} }), " "];
+		}
 	});
 }
 /**
@@ -37,19 +57,25 @@ function typeParameter(param) {
 function TypeParameters(props) {
 	if (props.children) return props.children;
 	if (!props.parameters) return;
-	return /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsxs)(_alloy_js_core_jsx_runtime.Fragment, { children: [
+	return [
 		"<",
-		/* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)("group", { children: /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsxs)(_alloy_js_core.Indent, {
-			softline: true,
-			children: [/* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_core.For, {
-				each: props.parameters,
-				comma: true,
-				line: true,
-				children: (param) => typeParameter(param)
-			}), /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)("ifBreak", { children: "," })]
-		}) }),
+		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("group", { get children() {
+			return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Indent, {
+				softline: true,
+				get children() {
+					return [(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
+						get each() {
+							return props.parameters;
+						},
+						comma: true,
+						line: true,
+						children: (param) => typeParameter(param)
+					}), (0, _alloy_js_core_jsx_runtime.createIntrinsic)("ifBreak", { children: "," })];
+				}
+			});
+		} }),
 		">"
-	] });
+	];
 }
 
 //#endregion

package/dist/typescript/components/type-parameters.mjs

@@ -1,27 +1,47 @@
+import { createComponent, createIntrinsic, memo } from "@alloy-js/core/jsx-runtime";
 import { For, Indent, Show } from "@alloy-js/core";
-import { Fragment, jsx, jsxs } from "@alloy-js/core/jsx-runtime";
 import { TypeRefContext } from "@alloy-js/typescript";
 
 //#region src/typescript/components/type-parameters.tsx
 function typeParameter(param) {
-	return /* @__PURE__ */ jsxs(Show, {
+	return createComponent(Show, {
 		when: typeof param === "object",
-		fallback: /* @__PURE__ */ jsx(Fragment, { children: param }),
-		children: [/* @__PURE__ */ jsxs("group", { children: [
-			param.name,
-			/* @__PURE__ */ jsxs(Show, {
-				when: !!param.extends,
-				children: [
-					" ",
-					"extends",
-					/* @__PURE__ */ jsxs("indent", { children: [" ", /* @__PURE__ */ jsx(TypeRefContext, { children: param.extends })] })
-				]
-			}),
-			/* @__PURE__ */ jsxs(Show, {
-				when: !!param.default,
-				children: [" = ", /* @__PURE__ */ jsx(TypeRefContext, { children: param.default })]
-			})
-		] }), " "]
+		get fallback() {
+			return [param];
+		},
+		get children() {
+			return [createIntrinsic("group", { get children() {
+				return [
+					memo(() => param.name),
+					createComponent(Show, {
+						get when() {
+							return !!param.extends;
+						},
+						get children() {
+							return [
+								" ",
+								"extends",
+								createIntrinsic("indent", { get children() {
+									return [" ", createComponent(TypeRefContext, { get children() {
+										return param.extends;
+									} })];
+								} })
+							];
+						}
+					}),
+					createComponent(Show, {
+						get when() {
+							return !!param.default;
+						},
+						get children() {
+							return [" = ", createComponent(TypeRefContext, { get children() {
+								return param.default;
+							} })];
+						}
+					})
+				];
+			} }), " "];
+		}
 	});
 }
 /**
@@ -35,19 +55,25 @@ function typeParameter(param) {
 function TypeParameters(props) {
 	if (props.children) return props.children;
 	if (!props.parameters) return;
-	return /* @__PURE__ */ jsxs(Fragment, { children: [
+	return [
 		"<",
-		/* @__PURE__ */ jsx("group", { children: /* @__PURE__ */ jsxs(Indent, {
-			softline: true,
-			children: [/* @__PURE__ */ jsx(For, {
-				each: props.parameters,
-				comma: true,
-				line: true,
-				children: (param) => typeParameter(param)
-			}), /* @__PURE__ */ jsx("ifBreak", { children: "," })]
-		}) }),
+		createIntrinsic("group", { get children() {
+			return createComponent(Indent, {
+				softline: true,
+				get children() {
+					return [createComponent(For, {
+						get each() {
+							return props.parameters;
+						},
+						comma: true,
+						line: true,
+						children: (param) => typeParameter(param)
+					}), createIntrinsic("ifBreak", { children: "," })];
+				}
+			});
+		} }),
 		">"
-	] });
+	];
 }
 
 //#endregion

package/dist/typescript/components/type-parameters.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"type-parameters.mjs","names":[],"sources":["../../../src/typescript/components/type-parameters.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\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/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { Children, For, Indent, Show } from \"@alloy-js/core\";\nimport { TypeParameterDescriptor, TypeRefContext } from \"@alloy-js/typescript\";\n\n/** Props for type parameters */\nexport interface TypeParametersProps {\n  /** Parameters */\n  parameters?: TypeParameterDescriptor[] | string[];\n  /** Jsx Children */\n  children?: Children;\n}\n\nfunction typeParameter(param: TypeParameterDescriptor | string) {\n  return (\n    <Show when={typeof param === \"object\"} fallback={<>{param}</>}>\n      <group>\n        {(param as TypeParameterDescriptor).name}\n        <Show when={!!(param as TypeParameterDescriptor).extends}>\n          {\" \"}\n          extends\n          <indent>\n            {\" \"}\n            <TypeRefContext>\n              {(param as TypeParameterDescriptor).extends}\n            </TypeRefContext>\n          </indent>\n        </Show>\n        <Show when={!!(param as TypeParameterDescriptor).default}>\n          {\" = \"}\n          <TypeRefContext>\n            {(param as TypeParameterDescriptor).default}\n          </TypeRefContext>\n        </Show>\n      </group>{\" \"}\n    </Show>\n  );\n}\n\n/**\n * Represent type parameters\n *\n * @example\n * ```ts\n * <A, B extends string>\n * ```\n */\nexport function TypeParameters(props: TypeParametersProps) {\n  if (props.children) {\n    return props.children;\n  }\n\n  if (!props.parameters) {\n    return undefined;\n  }\n\n  return (\n    <>\n      {\"<\"}\n      <group>\n        <Indent softline>\n          <For each={props.parameters} comma line>\n            {param => typeParameter(param)}\n          </For>\n          <ifBreak>,</ifBreak>\n        </Indent>\n      </group>\n      {\">\"}\n    </>\n  );\n}\n"],"mappings":";;;;;AA6BA,SAAS,cAAc,OAAyC;AAC9D,QACE,qBAAC,MAAD;EAAM,MAAM,OAAO,UAAU;EAAU,UAAU,0CAAG,OAAS;YAA7D,CACE,qBAAC,SAAD;GACI,MAAkC;GACpC,qBAAC,MAAD;IAAM,MAAM,CAAC,CAAE,MAAkC;cAAjD;KACG;KAAI;KAEL,qBAAC,UAAD,aACG,KACD,oBAAC,gBAAD,YACI,MAAkC,SACrB,EACV;KACJ;;GACP,qBAAC,MAAD;IAAM,MAAM,CAAC,CAAE,MAAkC;cAAjD,CACG,OACD,oBAAC,gBAAD,YACI,MAAkC,SACrB,EACZ;;GACD,KAAC,IACJ;;;;;;;;;;;AAYX,SAAgB,eAAe,OAA4B;AACzD,KAAI,MAAM,SACR,QAAO,MAAM;AAGf,KAAI,CAAC,MAAM,WACT;AAGF,QACE;EACG;EACD,oBAAC,SAAD,YACE,qBAAC,QAAD;GAAQ;aAAR,CACE,oBAAC,KAAD;IAAK,MAAM,MAAM;IAAY;IAAM;eAChC,UAAS,cAAc,MAAM;IAC1B,GACN,oBAAC,WAAD,YAAS,KAAW,EACb;MACH;EACP;EACA"}
+{"version":3,"file":"type-parameters.mjs","names":[],"sources":["../../../src/typescript/components/type-parameters.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\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/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { Children, For, Indent, Show } from \"@alloy-js/core\";\nimport { TypeParameterDescriptor, TypeRefContext } from \"@alloy-js/typescript\";\n\n/** Props for type parameters */\nexport interface TypeParametersProps {\n  /** Parameters */\n  parameters?: TypeParameterDescriptor[] | string[];\n  /** Jsx Children */\n  children?: Children;\n}\n\nfunction typeParameter(param: TypeParameterDescriptor | string) {\n  return (\n    <Show when={typeof param === \"object\"} fallback={<>{param}</>}>\n      <group>\n        {(param as TypeParameterDescriptor).name}\n        <Show when={!!(param as TypeParameterDescriptor).extends}>\n          {\" \"}\n          extends\n          <indent>\n            {\" \"}\n            <TypeRefContext>\n              {(param as TypeParameterDescriptor).extends}\n            </TypeRefContext>\n          </indent>\n        </Show>\n        <Show when={!!(param as TypeParameterDescriptor).default}>\n          {\" = \"}\n          <TypeRefContext>\n            {(param as TypeParameterDescriptor).default}\n          </TypeRefContext>\n        </Show>\n      </group>{\" \"}\n    </Show>\n  );\n}\n\n/**\n * Represent type parameters\n *\n * @example\n * ```ts\n * <A, B extends string>\n * ```\n */\nexport function TypeParameters(props: TypeParametersProps) {\n  if (props.children) {\n    return props.children;\n  }\n\n  if (!props.parameters) {\n    return undefined;\n  }\n\n  return (\n    <>\n      {\"<\"}\n      <group>\n        <Indent softline>\n          <For each={props.parameters} comma line>\n            {param => typeParameter(param)}\n          </For>\n          <ifBreak>,</ifBreak>\n        </Indent>\n      </group>\n      {\">\"}\n    </>\n  );\n}\n"],"mappings":";;;;;AA6BA,SAAS,cAAc,OAAyC;AAC9D,QAAO,gBAAA,MAAA;EACL,MAAM,OAAM,UAAO;EACnB,IAAG,WAAK;AACN,UAAI,CAAA,MAAS;;EAEf,IAAI,WAAM;AACR,UAAI,CAAA,gBAAA,SAAA,EACF,IAAG,WAAM;AACP,WAAM;KAAA,WAAA,MAAA,KAAA;KAAA,gBAAA,MAAA;MACJ,IAAC,OAAA;AACC,cAAO,CAAC,CAAE,MAAiC;;MAE7C,IAAA,WAAM;AACJ,cAAA;QAAA;QAAA;QAAA,gBAAA,UAAA,EACA,IAAM,WAAW;AACf,gBAAA,CAAA,KAAA,gBAAA,gBAAA,EACL,IAAA,WAAc;AACH,iBAAC,MAAgC;YAEzC,CAAA,CAAA;WAEJ,CAAA;QAAA;;MAEV,CAAA;KAAA,gBAAA,MAAA;;AAEE,cAAA,CAAA,CAAA,MAAA;;MAED,IAAA,WAAA;AACG,cAAA,CAAA,OAAA,gBAAA,gBAAA,EACE,IAAA,WAAA;AACW,eAAM,MAAA;UAErB,CAAA,CAAA;;MAES,CAAC;KAAA;MAEV,CAAA,EAAA,IAAA;;EAEA,CAAE;;;;;;;;;;AAWJ,SAAe,eAAA,OAAA;AACb,KAAI,MAAK,SACP,QAAM,MAAM;AAEd,KAAI,CAAC,MAAG,WACN;AAEJ,QAAA;EAAA;EAAA,gBAAA,SAAA"}