@powerlines/plugin-alloy 0.26.236 → 0.26.238

package/dist/typescript/components/tsdoc.d.mts

@@ -1,163 +0,0 @@
-import { ComponentProps } from "../../types/components.mjs";
-import { Children } from "@alloy-js/core";
-import { JsonSchemaPrimitiveType } from "@powerlines/schema";
-import { JSDocExampleProps, ParameterDescriptor } from "@alloy-js/typescript";
-//#region src/typescript/components/tsdoc.d.ts
-interface TSDocProps extends ComponentProps {
-  heading?: Children;
-}
-/**
- * Generates a TypeScript interface for the given reflection class.
- */
-declare function TSDoc(props: TSDocProps): Children;
-interface TSDocTagProps extends ComponentProps {
-  tag: string;
-}
-/**
- * Create a TSDoc `@<props.tag>` tag.
- */
-declare function TSDocTag(props: TSDocTagProps): Children;
-interface TSDocParamsProps {
-  parameters: ParameterDescriptor[] | string[];
-}
-/**
- * A component that creates a TSDoc block with `@param` tags for each parameter.
- */
-declare function TSDocParams(props: TSDocParamsProps): Children;
-/**
- * Create a TSDoc `@title` tag.
- */
-declare function TSDocTitle(props: ComponentProps): Children;
-/**
- * Create a TSDoc `@domain` tag.
- */
-declare function TSDocDomain(props: ComponentProps): Children;
-/**
- * Create a TSDoc `@alias` tag.
- */
-declare function TSDocAlias(props: ComponentProps): Children;
-/**
- * Create a TSDoc `@permission` tag.
- */
-declare function TSDocPermission(props: ComponentProps): Children;
-/**
- * Create a TSDoc `@group` tag.
- */
-declare function TSDocGroup(props: ComponentProps): Children;
-interface TSDocDefaultValueProps extends ComponentProps {
-  type?: JsonSchemaPrimitiveType | string;
-  defaultValue: any;
-}
-/**
- * Create a TSDoc `@defaultValue` tag.
- */
-declare function TSDocDefaultValue(props: TSDocDefaultValueProps): Children;
-/**
- * Create a TSDoc `@remarks` tag.
- */
-declare function TSDocRemarks(props: ComponentProps): Children;
-/**
- * Create a TSDoc `@see` tag.
- */
-declare function TSDocLink(props: ComponentProps): Children;
-interface TSDocExampleProps extends JSDocExampleProps {
-  /**
-   * Whether the file is a TSX file.
-   *
-   * @defaultValue false
-   */
-  tsx?: boolean;
-}
-/**
- * Create a TSDoc `@example` tag.
- */
-declare function TSDocExample(props: TSDocExampleProps): Children;
-/**
- * Create a TSDoc `@readonly` tag.
- */
-declare function TSDocReadonly(): Children;
-/**
- * Create a TSDoc `@internal` tag.
- */
-declare function TSDocInternal(): Children;
-/**
- * Create a TSDoc `@ignore` tag.
- */
-declare function TSDocIgnore(): Children;
-/**
- * Create a TSDoc `@hidden` tag.
- */
-declare function TSDocHidden(): Children;
-/**
- * Create a TSDoc `@runtime` tag.
- */
-declare function TSDocRuntime(): Children;
-interface TSDocAttributesTagsProps {
-  type?: JsonSchemaPrimitiveType | string;
-  default?: any;
-  title?: string;
-  alias?: string[];
-  tags?: string[];
-  readOnly?: boolean;
-  internal?: boolean;
-  ignore?: boolean;
-  hidden?: boolean;
-  runtime?: boolean;
-}
-/**
- * Generates a TypeScript interface property for the given reflection class.
- */
-declare function TSDocAttributesTags(props: TSDocAttributesTagsProps): Children;
-interface TSDocParamProps {
-  name: Children;
-  children?: Children;
-  optional?: boolean;
-  default?: Children;
-}
-/**
- * Create a TSDoc parameter set off with `@param`.
- */
-declare function TSDocParam(props: TSDocParamProps): Children;
-/**
- * Create a TSDoc `@returns` tag.
- */
-declare function TSDocReturns(props: ComponentProps): Children;
-/**
- * Create a TSDoc `@throws` tag.
- */
-declare function TSDocThrows(props: ComponentProps): Children;
-interface TSDocModuleProps extends ComponentProps {
-  /**
-   * The prefix for the builtin module name
-   *
-   * @remarks
-   * This value is populated from the Powerlines configuration output builtin prefix by default.
-   *
-   * @example
-   * ```ts
-   * /**
-   *  @module powerlines:my-module
-   *  \/
-   * ```
-   */
-  prefix?: string;
-  /**
-   * The name of the module
-   *
-   * @remarks
-   * This will be used in the `@module` tag as well as the import path for the module, e.g. `storm:<name>`.
-   *
-   * @example
-   * ```ts
-   * import { MyModule } from "powerlines:my-module";
-   * ```
-   */
-  name: Children;
-}
-/**
- * Generates a TSDoc `@module` tag for the given module name.
- */
-declare function TSDocModule(props: TSDocModuleProps): Children;
-//#endregion
-export { TSDoc, TSDocAlias, TSDocAttributesTags, TSDocAttributesTagsProps, TSDocDefaultValue, TSDocDefaultValueProps, TSDocDomain, TSDocExample, TSDocExampleProps, TSDocGroup, TSDocHidden, TSDocIgnore, TSDocInternal, TSDocLink, TSDocModule, TSDocModuleProps, TSDocParam, TSDocParamProps, TSDocParams, TSDocParamsProps, TSDocPermission, TSDocProps, TSDocReadonly, TSDocRemarks, TSDocReturns, TSDocRuntime, TSDocTag, TSDocTagProps, TSDocThrows, TSDocTitle };
-//# sourceMappingURL=tsdoc.d.mts.map

package/dist/typescript/components/tsdoc.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tsdoc.d.mts","names":[],"sources":["../../../src/typescript/components/tsdoc.tsx"],"mappings":""}

package/dist/typescript/components/tsdoc.mjs

@@ -1,465 +0,0 @@
-import { usePowerlinesSafe } from "../../core/contexts/context.mjs";
-import { Spacing } from "../../core/components/spacing.mjs";
-import { createComponent, createIntrinsic, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
-import { For, List, Prose, Show, childrenArray, computed, splitProps } from "@alloy-js/core";
-import { stringifyValue } from "@powerlines/schema";
-import { isUndefined } from "@stryke/type-checks/is-undefined";
-import { isSetString } from "@stryke/type-checks/is-set-string";
-
-//#region src/typescript/components/tsdoc.tsx
-/**
-* Generates a TypeScript interface for the given reflection class.
-*/
-function TSDoc(props) {
-	const [{ children, heading }] = splitProps(props, ["children", "heading"]);
-	return [
-		"/**",
-		createIntrinsic("align", {
-			string: " * ",
-			get children() {
-				return [
-					createIntrinsic("hbr", {}),
-					createComponent(Show, {
-						get when() {
-							return !isUndefined(heading);
-						},
-						children: heading
-					}),
-					createComponent(Show, {
-						get when() {
-							return memo(() => !!!isUndefined(children))() && childrenArray(() => children).filter(Boolean).length > 0;
-						},
-						get children() {
-							return [createComponent(Show, {
-								get when() {
-									return !isUndefined(heading);
-								},
-								get children() {
-									return createComponent(Spacing, {});
-								}
-							}), createComponent(List, {
-								hardline: false,
-								softline: true,
-								get children() {
-									return childrenArray(() => children);
-								}
-							})];
-						}
-					})
-				];
-			}
-		}),
-		createIntrinsic("hbr", {}),
-		`*/`,
-		createIntrinsic("hbr", {})
-	];
-}
-/**
-* Create a TSDoc `@<props.tag>` tag.
-*/
-function TSDocTag(props) {
-	const [{ children, tag }] = splitProps(props, ["children", "tag"]);
-	return [
-		`@${tag} `,
-		createComponent(Show, {
-			get when() {
-				return Boolean(children);
-			},
-			get children() {
-				return createIntrinsic("align", {
-					width: 2,
-					get children() {
-						return createComponent(Prose, { children });
-					}
-				});
-			}
-		}),
-		createIntrinsic("sbr", {})
-	];
-}
-/**
-* A component that creates a TSDoc block with `@param` tags for each parameter.
-*/
-function TSDocParams(props) {
-	return createComponent(For, {
-		each: normalizeParametersForDoc(props.parameters),
-		children: (param) => createComponent(TSDocParam, {
-			get name() {
-				return param.name;
-			},
-			get optional() {
-				return param.optional;
-			},
-			get children() {
-				return param.doc;
-			}
-		})
-	});
-}
-function normalizeParametersForDoc(parameters) {
-	if (parameters.some((p) => typeof p === "string")) return [];
-	return parameters;
-}
-/**
-* Create a TSDoc `@title` tag.
-*/
-function TSDocTitle(props) {
-	const [{ children }, rest] = splitProps(props, ["children"]);
-	return createComponent(TSDocTag, mergeProps(rest, {
-		tag: "title",
-		children
-	}));
-}
-/**
-* Create a TSDoc `@domain` tag.
-*/
-function TSDocDomain(props) {
-	const [{ children }, rest] = splitProps(props, ["children"]);
-	return createComponent(TSDocTag, mergeProps(rest, {
-		tag: "domain",
-		children
-	}));
-}
-/**
-* Create a TSDoc `@alias` tag.
-*/
-function TSDocAlias(props) {
-	const [{ children }, rest] = splitProps(props, ["children"]);
-	return createComponent(TSDocTag, mergeProps(rest, {
-		tag: "alias",
-		children
-	}));
-}
-/**
-* Create a TSDoc `@permission` tag.
-*/
-function TSDocPermission(props) {
-	const [{ children }, rest] = splitProps(props, ["children"]);
-	return createComponent(TSDocTag, mergeProps(rest, {
-		tag: "permission",
-		children
-	}));
-}
-/**
-* Create a TSDoc `@group` tag.
-*/
-function TSDocGroup(props) {
-	const [{ children }, rest] = splitProps(props, ["children"]);
-	return createComponent(TSDocTag, mergeProps(rest, {
-		tag: "group",
-		children
-	}));
-}
-/**
-* Create a TSDoc `@defaultValue` tag.
-*/
-function TSDocDefaultValue(props) {
-	const [{ type, defaultValue }] = splitProps(props, ["type", "defaultValue"]);
-	return ["@defaultValue ", createComponent(Show, {
-		get when() {
-			return !isUndefined(defaultValue);
-		},
-		get children() {
-			return createIntrinsic("align", {
-				width: 2,
-				get children() {
-					return createComponent(Prose, { get children() {
-						return stringifyValue(defaultValue, type);
-					} });
-				}
-			});
-		}
-	})];
-}
-/**
-* Create a TSDoc `@remarks` tag.
-*/
-function TSDocRemarks(props) {
-	return [
-		"@remarks ",
-		createIntrinsic("hbr", {}),
-		createComponent(List, {
-			hardline: false,
-			softline: true,
-			get children() {
-				return childrenArray(() => props.children);
-			}
-		})
-	];
-}
-/**
-* Create a TSDoc `@see` tag.
-*/
-function TSDocLink(props) {
-	return createComponent(TSDocTag, mergeProps(props, { tag: "see" }));
-}
-/**
-* Create a TSDoc `@example` tag.
-*/
-function TSDocExample(props) {
-	const [{ tsx, fenced = true, language, children }] = splitProps(props, [
-		"tsx",
-		"fenced",
-		"language",
-		"children"
-	]);
-	return [
-		"@example ",
-		createIntrinsic("hbr", {}),
-		createComponent(Show, {
-			when: fenced,
-			get children() {
-				return [
-					"```",
-					language || (tsx ? "tsx" : "ts"),
-					createIntrinsic("hbr", {})
-				];
-			}
-		}),
-		children,
-		createComponent(Show, {
-			when: fenced,
-			get children() {
-				return [createIntrinsic("hbr", {}), "```"];
-			}
-		})
-	];
-}
-/**
-* Create a TSDoc `@readonly` tag.
-*/
-function TSDocReadonly() {
-	return createComponent(TSDocTag, { tag: "readonly" });
-}
-/**
-* Create a TSDoc `@internal` tag.
-*/
-function TSDocInternal() {
-	return createComponent(TSDocTag, { tag: "internal" });
-}
-/**
-* Create a TSDoc `@ignore` tag.
-*/
-function TSDocIgnore() {
-	return createComponent(TSDocTag, { tag: "ignore" });
-}
-/**
-* Create a TSDoc `@hidden` tag.
-*/
-function TSDocHidden() {
-	return createComponent(TSDocTag, { tag: "hidden" });
-}
-/**
-* Create a TSDoc `@runtime` tag.
-*/
-function TSDocRuntime() {
-	return createComponent(TSDocTag, { tag: "runtime" });
-}
-/**
-* Generates a TypeScript interface property for the given reflection class.
-*/
-function TSDocAttributesTags(props) {
-	const [{ type, alias, tags, readOnly, internal, ignore, hidden, runtime, default: defaultValue }] = splitProps(props, [
-		"type",
-		"alias",
-		"tags",
-		"readOnly",
-		"internal",
-		"ignore",
-		"hidden",
-		"runtime",
-		"default"
-	]);
-	const title = computed(() => props.title?.trim() || "");
-	return [
-		createComponent(Show, {
-			get when() {
-				return isSetString(title.value);
-			},
-			get children() {
-				return createComponent(TSDocTitle, { get children() {
-					return title.value;
-				} });
-			}
-		}),
-		createComponent(Show, {
-			get when() {
-				return memo(() => !!(!isUndefined(alias) && alias.length > 0))() && alias.some((a) => isSetString(a?.trim()));
-			},
-			get children() {
-				return (alias?.filter((a) => isSetString(a?.trim())) ?? []).map((alias) => createComponent(TSDocAlias, { children: alias }));
-			}
-		}),
-		createComponent(Show, {
-			get when() {
-				return memo(() => !!(!isUndefined(tags) && tags.length > 0))() && tags.some((g) => isSetString(g?.trim()));
-			},
-			get children() {
-				return (tags?.filter((g) => isSetString(g?.trim())) ?? []).map((tag) => createComponent(TSDocGroup, { children: tag }));
-			}
-		}),
-		createComponent(Show, {
-			when: readOnly === true,
-			get children() {
-				return createComponent(TSDocReadonly, {});
-			}
-		}),
-		createComponent(Show, {
-			when: internal === true,
-			get children() {
-				return createComponent(TSDocInternal, {});
-			}
-		}),
-		createComponent(Show, {
-			when: ignore === true,
-			get children() {
-				return createComponent(TSDocIgnore, {});
-			}
-		}),
-		createComponent(Show, {
-			when: hidden === true,
-			get children() {
-				return createComponent(TSDocHidden, {});
-			}
-		}),
-		createComponent(Show, {
-			when: runtime === true,
-			get children() {
-				return createComponent(TSDocRuntime, {});
-			}
-		}),
-		createComponent(Show, {
-			get when() {
-				return memo(() => !!(runtime !== true && !isUndefined(type)))() && !isUndefined(defaultValue);
-			},
-			get children() {
-				return createComponent(TSDocDefaultValue, {
-					type,
-					defaultValue
-				});
-			}
-		})
-	];
-}
-/**
-* Create a TSDoc parameter set off with `@param`.
-*/
-function TSDocParam(props) {
-	return [
-		"@param ",
-		createComponent(TSDocParamName, {
-			get name() {
-				return props.name;
-			},
-			get optional() {
-				return props.optional;
-			},
-			get ["default"]() {
-				return props.default;
-			}
-		}),
-		createComponent(TSDocParamDescription, { get children() {
-			return props.children;
-		} })
-	];
-}
-function TSDocParamName(props) {
-	return [
-		createComponent(Show, {
-			get when() {
-				return props.optional;
-			},
-			children: "["
-		}),
-		memo(() => props.name),
-		createComponent(Show, {
-			get when() {
-				return Boolean(props.default);
-			},
-			get children() {
-				return ["=", memo(() => props.default)];
-			}
-		}),
-		createComponent(Show, {
-			get when() {
-				return props.optional;
-			},
-			children: "]"
-		})
-	];
-}
-function TSDocParamDescription(props) {
-	return createComponent(Show, {
-		get when() {
-			return Boolean(props.children);
-		},
-		get children() {
-			return [" - ", createIntrinsic("align", {
-				width: 2,
-				get children() {
-					return createComponent(Prose, { get children() {
-						return props.children;
-					} });
-				}
-			})];
-		}
-	});
-}
-/**
-* Create a TSDoc `@returns` tag.
-*/
-function TSDocReturns(props) {
-	return createComponent(TSDocTag, mergeProps(props, { tag: "returns" }));
-}
-/**
-* Create a TSDoc `@throws` tag.
-*/
-function TSDocThrows(props) {
-	return createComponent(TSDocTag, mergeProps(props, { tag: "throws" }));
-}
-/**
-* Generates a TSDoc `@module` tag for the given module name.
-*/
-function TSDocModule(props) {
-	const [{ children, name, prefix }] = splitProps(props, [
-		"children",
-		"name",
-		"prefix"
-	]);
-	const context = usePowerlinesSafe();
-	return [
-		"/**",
-		createIntrinsic("align", {
-			string: " * ",
-			get children() {
-				return [
-					createIntrinsic("hbr", {}),
-					createComponent(Show, {
-						get when() {
-							return Boolean(children);
-						},
-						get children() {
-							return [createComponent(List, {
-								hardline: false,
-								softline: true,
-								get children() {
-									return childrenArray(() => children);
-								}
-							}), createComponent(Spacing, {})];
-						}
-					}),
-					"@module ",
-					memo(() => prefix || context?.config?.framework?.name || "powerlines"),
-					":",
-					name
-				];
-			}
-		}),
-		createIntrinsic("hbr", {}),
-		` */`
-	];
-}
-
-//#endregion
-export { TSDoc, TSDocAlias, TSDocAttributesTags, TSDocDefaultValue, TSDocDomain, TSDocExample, TSDocGroup, TSDocHidden, TSDocIgnore, TSDocInternal, TSDocLink, TSDocModule, TSDocParam, TSDocParams, TSDocPermission, TSDocReadonly, TSDocRemarks, TSDocReturns, TSDocRuntime, TSDocTag, TSDocThrows, TSDocTitle };
-//# sourceMappingURL=tsdoc.mjs.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"tsdoc.mjs","names":[],"sources":[],"mappings":""}

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

@@ -1,38 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_typescript_components_tsdoc = require('./tsdoc.cjs');
-const require_typescript_components_type_parameters = require('./type-parameters.cjs');
-let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
-let _alloy_js_core = require("@alloy-js/core");
-let _alloy_js_typescript = require("@alloy-js/typescript");
-
-//#region src/typescript/components/type-declaration.tsx
-/**
-* Renders a TypeScript type declaration, including its name, optional TSDoc comment, and generic type parameters.
-*/
-const TypeDeclaration = (0, _alloy_js_typescript.ensureTypeRefContext)(function TypeDeclaration(props) {
-	const { children, doc, typeParameters, ...rest } = props;
-	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",
-		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
-exports.TypeDeclaration = TypeDeclaration;

package/dist/typescript/components/type-declaration.d.cts

@@ -1,15 +0,0 @@
-import { CommonDeclarationProps, TypeParameterDescriptor } from "@alloy-js/typescript";
-//#region src/typescript/components/type-declaration.d.ts
-interface TypeDeclarationProps extends CommonDeclarationProps {
-  /**
-   * The generic type parameters of the interface.
-   */
-  typeParameters?: TypeParameterDescriptor[] | string[];
-}
-/**
- * Renders a TypeScript type declaration, including its name, optional TSDoc comment, and generic type parameters.
- */
-declare const TypeDeclaration: import("@alloy-js/core").Component<TypeDeclarationProps>;
-//#endregion
-export { TypeDeclaration, TypeDeclarationProps };
-//# sourceMappingURL=type-declaration.d.cts.map

package/dist/typescript/components/type-declaration.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"type-declaration.d.cts","names":[],"sources":["../../../src/typescript/components/type-declaration.tsx"],"mappings":";;UA4BiB,6BAA6B;;;;EAI5C,iBAAiB;;;;;cAMN,0CAAe,UAAA"}

package/dist/typescript/components/type-declaration.d.mts

@@ -1,15 +0,0 @@
-import { CommonDeclarationProps, TypeParameterDescriptor } from "@alloy-js/typescript";
-//#region src/typescript/components/type-declaration.d.ts
-interface TypeDeclarationProps extends CommonDeclarationProps {
-  /**
-   * The generic type parameters of the interface.
-   */
-  typeParameters?: TypeParameterDescriptor[] | string[];
-}
-/**
- * Renders a TypeScript type declaration, including its name, optional TSDoc comment, and generic type parameters.
- */
-declare const TypeDeclaration: import("@alloy-js/core").Component<TypeDeclarationProps>;
-//#endregion
-export { TypeDeclaration, TypeDeclarationProps };
-//# sourceMappingURL=type-declaration.d.mts.map

package/dist/typescript/components/type-declaration.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"type-declaration.d.mts","names":[],"sources":["../../../src/typescript/components/type-declaration.tsx"],"mappings":""}