@powerlines/plugin-alloy 0.21.3 → 0.21.4

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

@@ -0,0 +1,225 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_core_contexts_reflection = require('../../core/contexts/reflection.cjs');
+const require_typescript_components_tsdoc = require('./tsdoc.cjs');
+const require_typescript_contexts_member_scope = require('../contexts/member-scope.cjs');
+const require_typescript_components_property_name = require('./property-name.cjs');
+const require_typescript_components_type_parameters = require('./type-parameters.cjs');
+const require_typescript_components_tsdoc_reflection = require('./tsdoc-reflection.cjs');
+let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let __alloy_js_core = require("@alloy-js/core");
+let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let __stryke_string_format_pascal_case = require("@stryke/string-format/pascal-case");
+let __stryke_type_checks_is_string = require("@stryke/type-checks/is-string");
+let __alloy_js_typescript = require("@alloy-js/typescript");
+
+//#region src/typescript/components/interface-declaration.tsx
+const InterfaceExpression = (0, __alloy_js_typescript.ensureTypeRefContext)(function InterfaceExpression$1(props) {
+	const symbol = (0, __alloy_js_core.createSymbol)(__alloy_js_typescript.TSOutputSymbol, "", void 0, {
+		transient: true,
+		binder: (0, __alloy_js_typescript.useTSLexicalScope)()?.binder
+	});
+	(0, __alloy_js_core.emitSymbol)(symbol);
+	return (0, __alloy_js_core_jsx_runtime.createIntrinsic)("group", { get children() {
+		return (0, __alloy_js_core_jsx_runtime.createComponent)(require_typescript_contexts_member_scope.MemberScope, {
+			ownerSymbol: symbol,
+			get children() {
+				return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Block, { get children() {
+					return props.children;
+				} });
+			}
+		});
+	} });
+});
+/**
+* Create a TypeScript interface member.
+*
+* An interface member can either provide a `name` prop to create a named
+* property, or an `indexer` prop to define an indexer for the interface.
+*
+* The type of the member can be provided either as the `type` prop or as the
+* children of the component.
+*/
+function InterfaceMember(props) {
+	const type = props.type ?? props.children;
+	const readonly = props.readonly ? "readonly " : "";
+	if ("indexer" in props) return [
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			get when() {
+				return Boolean(props.doc);
+			},
+			get children() {
+				return (0, __alloy_js_core_jsx_runtime.createComponent)(require_typescript_components_tsdoc.TSDoc, { get heading() {
+					return props.doc;
+				} });
+			}
+		}),
+		readonly,
+		"[",
+		(0, __alloy_js_core_jsx_runtime.memo)(() => props.indexer),
+		"]: ",
+		type
+	];
+	const optionality = props.optional ? "?" : "";
+	const scope = (0, __alloy_js_typescript.useTSMemberScope)();
+	const sym = (0, __alloy_js_core.createSymbol)(__alloy_js_typescript.TSOutputSymbol, props.name, scope.ownerSymbol.staticMembers, {
+		refkeys: props.refkey,
+		tsFlags: __alloy_js_typescript.TSSymbolFlags.TypeSymbol | (props.nullish ?? props.optional ? __alloy_js_typescript.TSSymbolFlags.Nullish : __alloy_js_typescript.TSSymbolFlags.None),
+		namePolicy: (0, __alloy_js_typescript.useTSNamePolicy)().for("interface-member"),
+		binder: scope.binder
+	});
+	const taken = (0, __alloy_js_core.takeSymbols)();
+	(0, __alloy_js_core.effect)(() => {
+		if (taken.size > 1) return;
+		const symbol = Array.from(taken)[0];
+		if (symbol?.isTransient) symbol.moveMembersTo(sym);
+	});
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.MemberDeclaration, {
+		symbol: sym,
+		get children() {
+			return [
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+					get when() {
+						return Boolean(props.doc);
+					},
+					get children() {
+						return (0, __alloy_js_core_jsx_runtime.createComponent)(require_typescript_components_tsdoc.TSDoc, { get heading() {
+							return props.doc;
+						} });
+					}
+				}),
+				readonly,
+				(0, __alloy_js_core_jsx_runtime.createComponent)(require_typescript_components_property_name.PropertyName, {}),
+				optionality,
+				": ",
+				type
+			];
+		}
+	});
+}
+const BaseInterfaceDeclaration = (0, __alloy_js_typescript.ensureTypeRefContext)(function InterfaceDeclaration$1(props) {
+	const ExprSlot = (0, __alloy_js_core.createSymbolSlot)();
+	const children = (0, __alloy_js_core.childrenArray)(() => props.children);
+	const extendsPart = props.extends ? [" extends ", (0, __alloy_js_core_jsx_runtime.memo)(() => props.extends)] : "";
+	const filteredChildren = (0, __alloy_js_core.findUnkeyedChildren)(children);
+	const currentScope = (0, __alloy_js_typescript.useTSLexicalScope)();
+	const binder = currentScope?.binder;
+	const sym = (0, __alloy_js_core.createSymbol)(__alloy_js_typescript.TSOutputSymbol, props.name, currentScope.types, {
+		refkeys: props.refkey,
+		default: props.default,
+		export: props.export,
+		metadata: props.metadata,
+		tsFlags: __alloy_js_typescript.TSSymbolFlags.TypeSymbol,
+		namePolicy: (0, __alloy_js_typescript.useTSNamePolicy)().for("interface"),
+		binder
+	});
+	(0, __alloy_js_core.effect)(() => {
+		if (ExprSlot.ref.value) {
+			const takenSymbols = ExprSlot.ref.value;
+			for (const symbol of takenSymbols) if (symbol.isTransient) symbol.moveMembersTo(sym);
+		}
+	});
+	return [(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+		get when() {
+			return Boolean(props.doc);
+		},
+		get children() {
+			return (0, __alloy_js_core_jsx_runtime.createComponent)(require_typescript_components_tsdoc.TSDoc, { get heading() {
+				return props.doc;
+			} });
+		}
+	}), (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.Declaration, (0, __alloy_js_core_jsx_runtime.mergeProps)(props, {
+		nameKind: "interface",
+		kind: "type",
+		symbol: sym,
+		get children() {
+			return [
+				"interface ",
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Name, {}),
+				(0, __alloy_js_core_jsx_runtime.memo)(() => (0, __alloy_js_core_jsx_runtime.memo)(() => !!props.typeParameters)() && (0, __alloy_js_core_jsx_runtime.createComponent)(require_typescript_components_type_parameters.TypeParameters, { get parameters() {
+					return props.typeParameters;
+				} })),
+				extendsPart,
+				" ",
+				(0, __alloy_js_core_jsx_runtime.createComponent)(ExprSlot, { get children() {
+					return (0, __alloy_js_core_jsx_runtime.createComponent)(InterfaceExpression, { children: filteredChildren });
+				} })
+			];
+		}
+	}))];
+});
+/**
+* Generates a TypeScript interface for the given reflection class.
+*/
+function InterfaceDeclaration(props) {
+	const [{ name, reflection, doc }, rest] = (0, __alloy_js_core.splitProps)(props, [
+		"name",
+		"reflection",
+		"doc"
+	]);
+	const interfaceName = (0, __alloy_js_core.computed)(() => (0, __stryke_string_format_pascal_case.pascalCase)(((0, __stryke_type_checks_is_string.isString)(name) ? name : name.toString()) || reflection?.getName()));
+	const properties = (0, __alloy_js_core.computed)(() => reflection ? reflection.getProperties().filter((item) => !item.isIgnored()).sort((a, b) => a.isReadonly() && b.isReadonly() || !a.isReadonly() && !b.isReadonly() ? a.getNameAsString().localeCompare(b.getNameAsString()) : a.isReadonly() ? 1 : -1) : []);
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+		get when() {
+			return properties.value.length > 0;
+		},
+		get fallback() {
+			return (0, __alloy_js_core_jsx_runtime.createComponent)(BaseInterfaceDeclaration, (0, __alloy_js_core_jsx_runtime.mergeProps)(props, { get name() {
+				return interfaceName.value;
+			} }));
+		},
+		get children() {
+			return (0, __alloy_js_core_jsx_runtime.createComponent)(require_core_contexts_reflection.ReflectionClassContext.Provider, {
+				value: { reflection },
+				get children() {
+					return [(0, __alloy_js_core_jsx_runtime.createComponent)(require_typescript_components_tsdoc_reflection.TSDocReflectionClass, { heading: doc }), (0, __alloy_js_core_jsx_runtime.createComponent)(BaseInterfaceDeclaration, (0, __alloy_js_core_jsx_runtime.mergeProps)({
+						"export": true,
+						get name() {
+							return interfaceName.value;
+						}
+					}, rest, { get children() {
+						return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.For, {
+							each: properties,
+							doubleHardline: true,
+							semicolon: true,
+							children: (prop) => (0, __alloy_js_core_jsx_runtime.createComponent)(InterfaceDeclarationProperty, { property: prop })
+						});
+					} }))];
+				}
+			});
+		}
+	});
+}
+/**
+* Generates a TypeScript interface property for the given reflection class.
+*/
+function InterfaceDeclarationProperty(props) {
+	const [{ property }, rest] = (0, __alloy_js_core.splitProps)(props, ["property"]);
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(require_core_contexts_reflection.ReflectionPropertyContext.Provider, {
+		value: property,
+		get children() {
+			return [(0, __alloy_js_core_jsx_runtime.createComponent)(require_typescript_components_tsdoc_reflection.TSDocReflectionProperty, {}), (0, __alloy_js_core_jsx_runtime.createComponent)(InterfaceMember, (0, __alloy_js_core_jsx_runtime.mergeProps)({
+				get name() {
+					return property.getNameAsString();
+				},
+				get readonly() {
+					return property.isReadonly();
+				},
+				get optional() {
+					return property.isOptional();
+				},
+				get nullish() {
+					return property.isNullable();
+				},
+				get type() {
+					return (0, __powerlines_deepkit_vendor_type.stringifyType)(property.getType());
+				}
+			}, rest))];
+		}
+	});
+}
+
+//#endregion
+exports.InterfaceDeclaration = InterfaceDeclaration;
+exports.InterfaceDeclarationProperty = InterfaceDeclarationProperty;
+exports.InterfaceExpression = InterfaceExpression;
+exports.InterfaceMember = InterfaceMember;

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

@@ -0,0 +1,82 @@
+import { ComponentProps } from "../../types/components.cjs";
+import * as _alloy_js_core13 from "@alloy-js/core";
+import { Children, Namekey, Refkey } from "@alloy-js/core";
+import { ReflectionClass, ReflectionProperty } from "@powerlines/deepkit/vendor/type";
+import { CommonDeclarationProps, TypeParameterDescriptor } from "@alloy-js/typescript";
+
+//#region src/typescript/components/interface-declaration.d.ts
+interface InterfaceDeclarationProps<T extends Record<string, any> = Record<string, any>> extends CommonDeclarationProps, ComponentProps {
+  /**
+   * A base type that this interface extends. This can be used to represent inheritance
+   */
+  extends?: Children;
+  /**
+   * The generic type parameters of the interface.
+   */
+  typeParameters?: TypeParameterDescriptor[] | string[];
+  /**
+   * The reflection class that describes the properties of this interface.
+   *
+   * @remarks
+   * This is used to generate the members of the interface based on the properties of the reflection class.
+   */
+  reflection?: ReflectionClass<T>;
+  /**
+   * A default value for this interface.
+   *
+   * @remarks
+   * This is used when the interface is used as a type for a variable declaration, to provide an initial value for the variable.
+   */
+  defaultValue?: Partial<T>;
+}
+interface InterfaceDeclarationPropertyProps extends Omit<InterfaceMemberProps, "name">, ComponentProps {
+  property: ReflectionProperty;
+}
+interface InterfaceExpressionProps {
+  children?: Children;
+}
+declare const InterfaceExpression: _alloy_js_core13.Component<InterfaceExpressionProps>;
+interface InterfaceMemberPropsBase {
+  type?: Children;
+  children?: Children;
+  readonly?: boolean;
+  doc?: Children;
+  refkey?: Refkey | Refkey[];
+}
+interface InterfacePropertyMemberProps extends InterfaceMemberPropsBase {
+  name: string | Namekey;
+  optional?: boolean;
+  nullish?: boolean;
+}
+interface InterfaceIndexerMemberProps extends InterfaceMemberPropsBase {
+  indexer: Children;
+}
+type InterfaceMemberProps = InterfacePropertyMemberProps | InterfaceIndexerMemberProps;
+/**
+ * Create a TypeScript interface member.
+ *
+ * An interface member can either provide a `name` prop to create a named
+ * property, or an `indexer` prop to define an indexer for the interface.
+ *
+ * The type of the member can be provided either as the `type` prop or as the
+ * children of the component.
+ */
+declare function InterfaceMember(props: InterfaceMemberProps): Children;
+/**
+ * Generates a TypeScript interface for the given reflection class.
+ */
+declare function InterfaceDeclaration<T extends Record<string, any> = Record<string, any>>(props: InterfaceDeclarationProps<T>): Children;
+/**
+ * Generates a TypeScript interface property for the given reflection class.
+ */
+declare function InterfaceDeclarationProperty(props: InterfaceDeclarationPropertyProps): Children;
+declare type __ΩInterfaceDeclarationProps = any[];
+declare type __ΩInterfaceDeclarationPropertyProps = any[];
+declare type __ΩInterfaceExpressionProps = any[];
+declare type __ΩInterfaceMemberPropsBase = any[];
+declare type __ΩInterfacePropertyMemberProps = any[];
+declare type __ΩInterfaceIndexerMemberProps = any[];
+declare type __ΩInterfaceMemberProps = any[];
+//#endregion
+export { InterfaceDeclaration, InterfaceDeclarationProperty, InterfaceDeclarationPropertyProps, InterfaceDeclarationProps, InterfaceExpression, InterfaceExpressionProps, InterfaceIndexerMemberProps, InterfaceMember, InterfaceMemberProps, InterfaceMemberPropsBase, InterfacePropertyMemberProps, __ΩInterfaceDeclarationPropertyProps, __ΩInterfaceDeclarationProps, __ΩInterfaceExpressionProps, __ΩInterfaceIndexerMemberProps, __ΩInterfaceMemberProps, __ΩInterfaceMemberPropsBase, __ΩInterfacePropertyMemberProps };
+//# sourceMappingURL=interface-declaration.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interface-declaration.d.cts","names":[],"sources":["../../../src/typescript/components/interface-declaration.tsx"],"sourcesContent":[],"mappings":";;;;;;;UAqEiB,oCACL,sBAAsB,6BAExB,wBAAwB;;;AAHlC;EACY,OAAA,CAAA,EAMA,QANA;EAAsB;;;EAmBH,cAAA,CAAA,EARZ,uBAQY,EAAA,GAAA,MAAA,EAAA;EAAhB;;;;;;EAWE,UAAA,CAAA,EAXF,eAWE,CAXc,CAWd,CAAA;EACF;;;;;AAIf;EAIa,YAAA,CAAA,EAZI,OA8BhB,CA9BwB,CA8BxB,CAAA;AAED;AACS,UA9BQ,iCAAA,SACP,IA6BD,CA7BM,oBA6BN,EAAA,MAAA,CAAA,EA7BqC,cA6BrC,CAAA;EACI,QAAA,EA7BD,kBA6BC;;AAGF,UA7BM,wBAAA,CA6BN;EAAS,QAAA,CAAA,EA5BP,QA4BO;;AAEH,cA3BJ,mBA2BiC,EA3Bd,gBAAA,CAAA,SA2BsB,CA3BtB,wBA2B8C,CAAA;AAM7D,UAbA,wBAAA,CAa4B;EAIjC,IAAA,CAAA,EAhBH,QAgBG;EAaI,QAAA,CAAA,EA5BH,QA4BkB;EA+Gf,QAAA,CAAA,EAAA,OAAA;EACJ,GAAA,CAAA,EA1IJ,QA0II;EAAsB,MAAA,CAAA,EAzIvB,MAyIuB,GAzId,MAyIc,EAAA;;AACzB,UAxIQ,4BAAA,SAAqC,wBAwI7C,CAAA;EAA4B,IAAA,EAAA,MAAA,GAvIpB,OAuIoB;EAAA,QAAA,CAAA,EAAA,OAAA;EAwDrB,OAAA,CAAA,EAAA,OAAA;;UA1LC,2BAAA,SAAoC;WAC1C;;KAGC,oBAAA,GACR,+BACA;;;;;;;;;;iBAWY,eAAA,QAAuB,uBAAoB;;;;iBA+G3C,+BACJ,sBAAsB,4BACzB,0BAA0B,KAAE;;;;iBAwDrB,4BAAA,QACP,oCAAiC"}

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

@@ -0,0 +1,82 @@
+import { ComponentProps } from "../../types/components.mjs";
+import * as _alloy_js_core15 from "@alloy-js/core";
+import { Children, Namekey, Refkey } from "@alloy-js/core";
+import { ReflectionClass, ReflectionProperty } from "@powerlines/deepkit/vendor/type";
+import { CommonDeclarationProps, TypeParameterDescriptor } from "@alloy-js/typescript";
+
+//#region src/typescript/components/interface-declaration.d.ts
+interface InterfaceDeclarationProps<T extends Record<string, any> = Record<string, any>> extends CommonDeclarationProps, ComponentProps {
+  /**
+   * A base type that this interface extends. This can be used to represent inheritance
+   */
+  extends?: Children;
+  /**
+   * The generic type parameters of the interface.
+   */
+  typeParameters?: TypeParameterDescriptor[] | string[];
+  /**
+   * The reflection class that describes the properties of this interface.
+   *
+   * @remarks
+   * This is used to generate the members of the interface based on the properties of the reflection class.
+   */
+  reflection?: ReflectionClass<T>;
+  /**
+   * A default value for this interface.
+   *
+   * @remarks
+   * This is used when the interface is used as a type for a variable declaration, to provide an initial value for the variable.
+   */
+  defaultValue?: Partial<T>;
+}
+interface InterfaceDeclarationPropertyProps extends Omit<InterfaceMemberProps, "name">, ComponentProps {
+  property: ReflectionProperty;
+}
+interface InterfaceExpressionProps {
+  children?: Children;
+}
+declare const InterfaceExpression: _alloy_js_core15.Component<InterfaceExpressionProps>;
+interface InterfaceMemberPropsBase {
+  type?: Children;
+  children?: Children;
+  readonly?: boolean;
+  doc?: Children;
+  refkey?: Refkey | Refkey[];
+}
+interface InterfacePropertyMemberProps extends InterfaceMemberPropsBase {
+  name: string | Namekey;
+  optional?: boolean;
+  nullish?: boolean;
+}
+interface InterfaceIndexerMemberProps extends InterfaceMemberPropsBase {
+  indexer: Children;
+}
+type InterfaceMemberProps = InterfacePropertyMemberProps | InterfaceIndexerMemberProps;
+/**
+ * Create a TypeScript interface member.
+ *
+ * An interface member can either provide a `name` prop to create a named
+ * property, or an `indexer` prop to define an indexer for the interface.
+ *
+ * The type of the member can be provided either as the `type` prop or as the
+ * children of the component.
+ */
+declare function InterfaceMember(props: InterfaceMemberProps): Children;
+/**
+ * Generates a TypeScript interface for the given reflection class.
+ */
+declare function InterfaceDeclaration<T extends Record<string, any> = Record<string, any>>(props: InterfaceDeclarationProps<T>): Children;
+/**
+ * Generates a TypeScript interface property for the given reflection class.
+ */
+declare function InterfaceDeclarationProperty(props: InterfaceDeclarationPropertyProps): Children;
+declare type __ΩInterfaceDeclarationProps = any[];
+declare type __ΩInterfaceDeclarationPropertyProps = any[];
+declare type __ΩInterfaceExpressionProps = any[];
+declare type __ΩInterfaceMemberPropsBase = any[];
+declare type __ΩInterfacePropertyMemberProps = any[];
+declare type __ΩInterfaceIndexerMemberProps = any[];
+declare type __ΩInterfaceMemberProps = any[];
+//#endregion
+export { InterfaceDeclaration, InterfaceDeclarationProperty, InterfaceDeclarationPropertyProps, InterfaceDeclarationProps, InterfaceExpression, InterfaceExpressionProps, InterfaceIndexerMemberProps, InterfaceMember, InterfaceMemberProps, InterfaceMemberPropsBase, InterfacePropertyMemberProps, __ΩInterfaceDeclarationPropertyProps, __ΩInterfaceDeclarationProps, __ΩInterfaceExpressionProps, __ΩInterfaceIndexerMemberProps, __ΩInterfaceMemberProps, __ΩInterfaceMemberPropsBase, __ΩInterfacePropertyMemberProps };
+//# sourceMappingURL=interface-declaration.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interface-declaration.d.mts","names":[],"sources":["../../../src/typescript/components/interface-declaration.tsx"],"sourcesContent":[],"mappings":";;;;;;;UAqEiB,oCACL,sBAAsB,6BAExB,wBAAwB;;;AAHlC;EACY,OAAA,CAAA,EAMA,QANA;EAAsB;;;EAmBH,cAAA,CAAA,EARZ,uBAQY,EAAA,GAAA,MAAA,EAAA;EAAhB;;;;;;EAWE,UAAA,CAAA,EAXF,eAWE,CAXc,CAWd,CAAA;EACF;;;;;AAIf;EAIa,YAAA,CAAA,EAZI,OA8BhB,CA9BwB,CA8BxB,CAAA;AAED;AACS,UA9BQ,iCAAA,SACP,IA6BD,CA7BM,oBA6BN,EAAA,MAAA,CAAA,EA7BqC,cA6BrC,CAAA;EACI,QAAA,EA7BD,kBA6BC;;AAGF,UA7BM,wBAAA,CA6BN;EAAS,QAAA,CAAA,EA5BP,QA4BO;;AAEH,cA3BJ,mBA2BiC,EA3Bd,gBAAA,CAAA,SA2BsB,CA3BtB,wBA2B8C,CAAA;AAM7D,UAbA,wBAAA,CAa4B;EAIjC,IAAA,CAAA,EAhBH,QAgBG;EAaI,QAAA,CAAA,EA5BH,QA4BkB;EA+Gf,QAAA,CAAA,EAAA,OAAA;EACJ,GAAA,CAAA,EA1IJ,QA0II;EAAsB,MAAA,CAAA,EAzIvB,MAyIuB,GAzId,MAyIc,EAAA;;AACzB,UAxIQ,4BAAA,SAAqC,wBAwI7C,CAAA;EAA4B,IAAA,EAAA,MAAA,GAvIpB,OAuIoB;EAAA,QAAA,CAAA,EAAA,OAAA;EAwDrB,OAAA,CAAA,EAAA,OAAA;;UA1LC,2BAAA,SAAoC;WAC1C;;KAGC,oBAAA,GACR,+BACA;;;;;;;;;;iBAWY,eAAA,QAAuB,uBAAoB;;;;iBA+G3C,+BACJ,sBAAsB,4BACzB,0BAA0B,KAAE;;;;iBAwDrB,4BAAA,QACP,oCAAiC"}

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

@@ -0,0 +1,222 @@
+import { ReflectionClassContext, ReflectionPropertyContext } from "../../core/contexts/reflection.mjs";
+import { TSDoc } from "./tsdoc.mjs";
+import { MemberScope as MemberScope$1 } from "../contexts/member-scope.mjs";
+import { PropertyName } from "./property-name.mjs";
+import { TypeParameters } from "./type-parameters.mjs";
+import { TSDocReflectionClass, TSDocReflectionProperty } from "./tsdoc-reflection.mjs";
+import { createComponent, createIntrinsic, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { Block, For, MemberDeclaration, Name, Show, childrenArray, computed, createSymbol, createSymbolSlot, effect, emitSymbol, findUnkeyedChildren, splitProps, takeSymbols } from "@alloy-js/core";
+import { stringifyType } from "@powerlines/deepkit/vendor/type";
+import { pascalCase } from "@stryke/string-format/pascal-case";
+import { isString } from "@stryke/type-checks/is-string";
+import { Declaration as Declaration$1, TSOutputSymbol, TSSymbolFlags, ensureTypeRefContext, useTSLexicalScope, useTSMemberScope, useTSNamePolicy } from "@alloy-js/typescript";
+
+//#region src/typescript/components/interface-declaration.tsx
+const InterfaceExpression = ensureTypeRefContext(function InterfaceExpression$1(props) {
+	const symbol = createSymbol(TSOutputSymbol, "", void 0, {
+		transient: true,
+		binder: useTSLexicalScope()?.binder
+	});
+	emitSymbol(symbol);
+	return createIntrinsic("group", { get children() {
+		return createComponent(MemberScope$1, {
+			ownerSymbol: symbol,
+			get children() {
+				return createComponent(Block, { get children() {
+					return props.children;
+				} });
+			}
+		});
+	} });
+});
+/**
+* Create a TypeScript interface member.
+*
+* An interface member can either provide a `name` prop to create a named
+* property, or an `indexer` prop to define an indexer for the interface.
+*
+* The type of the member can be provided either as the `type` prop or as the
+* children of the component.
+*/
+function InterfaceMember(props) {
+	const type = props.type ?? props.children;
+	const readonly = props.readonly ? "readonly " : "";
+	if ("indexer" in props) return [
+		createComponent(Show, {
+			get when() {
+				return Boolean(props.doc);
+			},
+			get children() {
+				return createComponent(TSDoc, { get heading() {
+					return props.doc;
+				} });
+			}
+		}),
+		readonly,
+		"[",
+		memo(() => props.indexer),
+		"]: ",
+		type
+	];
+	const optionality = props.optional ? "?" : "";
+	const scope = useTSMemberScope();
+	const sym = createSymbol(TSOutputSymbol, props.name, scope.ownerSymbol.staticMembers, {
+		refkeys: props.refkey,
+		tsFlags: TSSymbolFlags.TypeSymbol | (props.nullish ?? props.optional ? TSSymbolFlags.Nullish : TSSymbolFlags.None),
+		namePolicy: useTSNamePolicy().for("interface-member"),
+		binder: scope.binder
+	});
+	const taken = takeSymbols();
+	effect(() => {
+		if (taken.size > 1) return;
+		const symbol = Array.from(taken)[0];
+		if (symbol?.isTransient) symbol.moveMembersTo(sym);
+	});
+	return createComponent(MemberDeclaration, {
+		symbol: sym,
+		get children() {
+			return [
+				createComponent(Show, {
+					get when() {
+						return Boolean(props.doc);
+					},
+					get children() {
+						return createComponent(TSDoc, { get heading() {
+							return props.doc;
+						} });
+					}
+				}),
+				readonly,
+				createComponent(PropertyName, {}),
+				optionality,
+				": ",
+				type
+			];
+		}
+	});
+}
+const BaseInterfaceDeclaration = ensureTypeRefContext(function InterfaceDeclaration$1(props) {
+	const ExprSlot = createSymbolSlot();
+	const children = childrenArray(() => props.children);
+	const extendsPart = props.extends ? [" extends ", memo(() => props.extends)] : "";
+	const filteredChildren = findUnkeyedChildren(children);
+	const currentScope = useTSLexicalScope();
+	const binder = currentScope?.binder;
+	const sym = createSymbol(TSOutputSymbol, props.name, currentScope.types, {
+		refkeys: props.refkey,
+		default: props.default,
+		export: props.export,
+		metadata: props.metadata,
+		tsFlags: TSSymbolFlags.TypeSymbol,
+		namePolicy: useTSNamePolicy().for("interface"),
+		binder
+	});
+	effect(() => {
+		if (ExprSlot.ref.value) {
+			const takenSymbols = ExprSlot.ref.value;
+			for (const symbol of takenSymbols) if (symbol.isTransient) symbol.moveMembersTo(sym);
+		}
+	});
+	return [createComponent(Show, {
+		get when() {
+			return Boolean(props.doc);
+		},
+		get children() {
+			return createComponent(TSDoc, { get heading() {
+				return props.doc;
+			} });
+		}
+	}), createComponent(Declaration$1, mergeProps(props, {
+		nameKind: "interface",
+		kind: "type",
+		symbol: sym,
+		get children() {
+			return [
+				"interface ",
+				createComponent(Name, {}),
+				memo(() => memo(() => !!props.typeParameters)() && createComponent(TypeParameters, { get parameters() {
+					return props.typeParameters;
+				} })),
+				extendsPart,
+				" ",
+				createComponent(ExprSlot, { get children() {
+					return createComponent(InterfaceExpression, { children: filteredChildren });
+				} })
+			];
+		}
+	}))];
+});
+/**
+* Generates a TypeScript interface for the given reflection class.
+*/
+function InterfaceDeclaration(props) {
+	const [{ name, reflection, doc }, rest] = splitProps(props, [
+		"name",
+		"reflection",
+		"doc"
+	]);
+	const interfaceName = computed(() => pascalCase((isString(name) ? name : name.toString()) || reflection?.getName()));
+	const properties = computed(() => reflection ? reflection.getProperties().filter((item) => !item.isIgnored()).sort((a, b) => a.isReadonly() && b.isReadonly() || !a.isReadonly() && !b.isReadonly() ? a.getNameAsString().localeCompare(b.getNameAsString()) : a.isReadonly() ? 1 : -1) : []);
+	return createComponent(Show, {
+		get when() {
+			return properties.value.length > 0;
+		},
+		get fallback() {
+			return createComponent(BaseInterfaceDeclaration, mergeProps(props, { get name() {
+				return interfaceName.value;
+			} }));
+		},
+		get children() {
+			return createComponent(ReflectionClassContext.Provider, {
+				value: { reflection },
+				get children() {
+					return [createComponent(TSDocReflectionClass, { heading: doc }), createComponent(BaseInterfaceDeclaration, mergeProps({
+						"export": true,
+						get name() {
+							return interfaceName.value;
+						}
+					}, rest, { get children() {
+						return createComponent(For, {
+							each: properties,
+							doubleHardline: true,
+							semicolon: true,
+							children: (prop) => createComponent(InterfaceDeclarationProperty, { property: prop })
+						});
+					} }))];
+				}
+			});
+		}
+	});
+}
+/**
+* Generates a TypeScript interface property for the given reflection class.
+*/
+function InterfaceDeclarationProperty(props) {
+	const [{ property }, rest] = splitProps(props, ["property"]);
+	return createComponent(ReflectionPropertyContext.Provider, {
+		value: property,
+		get children() {
+			return [createComponent(TSDocReflectionProperty, {}), createComponent(InterfaceMember, mergeProps({
+				get name() {
+					return property.getNameAsString();
+				},
+				get readonly() {
+					return property.isReadonly();
+				},
+				get optional() {
+					return property.isOptional();
+				},
+				get nullish() {
+					return property.isNullable();
+				},
+				get type() {
+					return stringifyType(property.getType());
+				}
+			}, rest))];
+		}
+	});
+}
+
+//#endregion
+export { InterfaceDeclaration, InterfaceDeclarationProperty, InterfaceExpression, InterfaceMember };
+//# sourceMappingURL=interface-declaration.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interface-declaration.mjs","names":["Block","childrenArray","computed","createSymbol","createSymbolSlot","effect","emitSymbol","findUnkeyedChildren","For","MemberDeclaration","Name","Show","splitProps","takeSymbols","Declaration","ensureTypeRefContext","TSOutputSymbol","TSSymbolFlags","useTSLexicalScope","useTSMemberScope","useTSNamePolicy","stringifyType","pascalCase","isString","ReflectionClassContext","ReflectionPropertyContext","MemberScope","PropertyName","TSDoc","TSDocReflectionClass","TSDocReflectionProperty","TypeParameters","InterfaceExpression","props","scope","symbol","undefined","transient","binder","_$createIntrinsic","children","_$createComponent","ownerSymbol","InterfaceMember","type","readonly","when","Boolean","doc","heading","_$memo","indexer","optionality","optional","sym","name","staticMembers","refkeys","refkey","tsFlags","TypeSymbol","nullish","Nullish","None","namePolicy","for","taken","size","Array","from","isTransient","moveMembersTo","BaseInterfaceDeclaration","InterfaceDeclaration","ExprSlot","extendsPart","extends","filteredChildren","currentScope","types","default","export","metadata","ref","value","takenSymbols","_$mergeProps","nameKind","kind","typeParameters","parameters","reflection","rest","interfaceName","toString","getName","properties","getProperties","filter","item","isIgnored","sort","a","b","isReadonly","getNameAsString","localeCompare","length","fallback","Provider","each","doubleHardline","semicolon","prop","InterfaceDeclarationProperty","property","isOptional","isNullable","getType"],"sources":["../../../src/typescript/components/interface-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 {\n  Block,\n  Children,\n  childrenArray,\n  computed,\n  createSymbol,\n  createSymbolSlot,\n  effect,\n  emitSymbol,\n  findUnkeyedChildren,\n  For,\n  MemberDeclaration,\n  Name,\n  Namekey,\n  Refkey,\n  Show,\n  splitProps,\n  takeSymbols\n} from \"@alloy-js/core\";\nimport {\n  CommonDeclarationProps,\n  Declaration,\n  ensureTypeRefContext,\n  TSOutputSymbol,\n  TSSymbolFlags,\n  TypeParameterDescriptor,\n  useTSLexicalScope,\n  useTSMemberScope,\n  useTSNamePolicy\n} from \"@alloy-js/typescript\";\nimport {\n  ReflectionClass,\n  ReflectionProperty,\n  stringifyType\n} from \"@powerlines/deepkit/vendor/type\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport {\n  ReflectionClassContext,\n  ReflectionPropertyContext\n} from \"../../core/contexts/reflection\";\nimport { ComponentProps } from \"../../types/components\";\nimport { MemberScope } from \"../contexts/member-scope\";\nimport { PropertyName } from \"./property-name\";\nimport { TSDoc } from \"./tsdoc\";\nimport {\n  TSDocReflectionClass,\n  TSDocReflectionProperty\n} from \"./tsdoc-reflection\";\nimport { TypeParameters } from \"./type-parameters\";\n\nexport interface InterfaceDeclarationProps<\n  T extends Record<string, any> = Record<string, any>\n>\n  extends CommonDeclarationProps, ComponentProps {\n  /**\n   * A base type that this interface extends. This can be used to represent inheritance\n   */\n  extends?: Children;\n\n  /**\n   * The generic type parameters of the interface.\n   */\n  typeParameters?: TypeParameterDescriptor[] | string[];\n\n  /**\n   * The reflection class that describes the properties of this interface.\n   *\n   * @remarks\n   * This is used to generate the members of the interface based on the properties of the reflection class.\n   */\n  reflection?: ReflectionClass<T>;\n\n  /**\n   * A default value for this interface.\n   *\n   * @remarks\n   * This is used when the interface is used as a type for a variable declaration, to provide an initial value for the variable.\n   */\n  defaultValue?: Partial<T>;\n}\n\nexport interface InterfaceDeclarationPropertyProps\n  extends Omit<InterfaceMemberProps, \"name\">, ComponentProps {\n  property: ReflectionProperty;\n}\n\nexport interface InterfaceExpressionProps {\n  children?: Children;\n}\n\nexport const InterfaceExpression = ensureTypeRefContext(\n  function InterfaceExpression(props: InterfaceExpressionProps) {\n    const scope = useTSLexicalScope();\n    const symbol = createSymbol(TSOutputSymbol, \"\", undefined, {\n      transient: true,\n      binder: scope?.binder\n    });\n\n    emitSymbol(symbol);\n\n    return (\n      <group>\n        <MemberScope ownerSymbol={symbol}>\n          <Block>{props.children}</Block>\n        </MemberScope>\n      </group>\n    );\n  }\n);\n\nexport interface InterfaceMemberPropsBase {\n  type?: Children;\n  children?: Children;\n  readonly?: boolean;\n  doc?: Children;\n  refkey?: Refkey | Refkey[];\n}\nexport interface InterfacePropertyMemberProps extends InterfaceMemberPropsBase {\n  name: string | Namekey;\n  optional?: boolean;\n  nullish?: boolean;\n}\n\nexport interface InterfaceIndexerMemberProps extends InterfaceMemberPropsBase {\n  indexer: Children;\n}\n\nexport type InterfaceMemberProps =\n  | InterfacePropertyMemberProps\n  | InterfaceIndexerMemberProps;\n\n/**\n * Create a TypeScript interface member.\n *\n * An interface member can either provide a `name` prop to create a named\n * property, or an `indexer` prop to define an indexer for the interface.\n *\n * The type of the member can be provided either as the `type` prop or as the\n * children of the component.\n */\nexport function InterfaceMember(props: InterfaceMemberProps) {\n  const type = props.type ?? props.children;\n  const readonly = props.readonly ? \"readonly \" : \"\";\n\n  if (\"indexer\" in props) {\n    return (\n      <>\n        <Show when={Boolean(props.doc)}>\n          <TSDoc heading={props.doc} />\n        </Show>\n        {readonly}[{props.indexer}]: {type}\n      </>\n    );\n  }\n\n  const optionality = props.optional ? \"?\" : \"\";\n  const scope = useTSMemberScope();\n  const sym = createSymbol(\n    TSOutputSymbol,\n    props.name,\n    scope.ownerSymbol.staticMembers,\n    {\n      refkeys: props.refkey,\n      tsFlags:\n        TSSymbolFlags.TypeSymbol |\n        ((props.nullish ?? props.optional)\n          ? TSSymbolFlags.Nullish\n          : TSSymbolFlags.None),\n      namePolicy: useTSNamePolicy().for(\"interface-member\"),\n      binder: scope.binder\n    }\n  );\n\n  const taken = takeSymbols();\n\n  effect(() => {\n    if (taken.size > 1) return;\n    const symbol = Array.from(taken)[0];\n    if (symbol?.isTransient) {\n      symbol.moveMembersTo(sym);\n    }\n  });\n\n  return (\n    <MemberDeclaration symbol={sym}>\n      <Show when={Boolean(props.doc)}>\n        <TSDoc heading={props.doc} />\n      </Show>\n      {readonly}\n      <PropertyName />\n      {optionality}: {type}\n    </MemberDeclaration>\n  );\n}\n\nconst BaseInterfaceDeclaration = ensureTypeRefContext(\n  function InterfaceDeclaration(props: InterfaceDeclarationProps) {\n    const ExprSlot = createSymbolSlot();\n\n    const children = childrenArray(() => props.children);\n\n    const extendsPart = props.extends ? <> extends {props.extends}</> : \"\";\n    const filteredChildren = findUnkeyedChildren(children);\n    const currentScope = useTSLexicalScope();\n\n    const binder = currentScope?.binder;\n    const sym = createSymbol(TSOutputSymbol, props.name, currentScope.types, {\n      refkeys: props.refkey,\n      default: props.default,\n      export: props.export,\n      metadata: props.metadata,\n      tsFlags: TSSymbolFlags.TypeSymbol,\n      namePolicy: useTSNamePolicy().for(\"interface\"),\n      binder\n    });\n\n    effect(() => {\n      if (ExprSlot.ref.value) {\n        const takenSymbols = ExprSlot.ref.value;\n        for (const symbol of takenSymbols) {\n          // ignore non-transient symbols (likely not the result of an expression).\n          if (symbol.isTransient) {\n            symbol.moveMembersTo(sym);\n          }\n        }\n      }\n    });\n\n    return (\n      <>\n        <Show when={Boolean(props.doc)}>\n          <TSDoc heading={props.doc} />\n        </Show>\n        <Declaration {...props} nameKind=\"interface\" kind=\"type\" symbol={sym}>\n          interface <Name />\n          {props.typeParameters && (\n            <TypeParameters parameters={props.typeParameters} />\n          )}\n          {extendsPart}{\" \"}\n          <ExprSlot>\n            <InterfaceExpression>{filteredChildren}</InterfaceExpression>\n          </ExprSlot>\n        </Declaration>\n      </>\n    );\n  }\n);\n\n/**\n * Generates a TypeScript interface for the given reflection class.\n */\nexport function InterfaceDeclaration<\n  T extends Record<string, any> = Record<string, any>\n>(props: InterfaceDeclarationProps<T>) {\n  const [{ name, reflection, doc }, rest] = splitProps(props, [\n    \"name\",\n    \"reflection\",\n    \"doc\"\n  ]);\n\n  const interfaceName = computed(() =>\n    pascalCase(\n      (isString(name) ? name : name.toString()) || reflection?.getName()\n    )\n  );\n\n  const properties = computed(() =>\n    reflection\n      ? reflection\n          .getProperties()\n          .filter(item => !item.isIgnored())\n          .sort((a, b) =>\n            (a.isReadonly() && b.isReadonly()) ||\n            (!a.isReadonly() && !b.isReadonly())\n              ? a.getNameAsString().localeCompare(b.getNameAsString())\n              : a.isReadonly()\n                ? 1\n                : -1\n          )\n      : []\n  );\n\n  return (\n    <Show\n      when={properties.value.length > 0}\n      fallback={\n        <BaseInterfaceDeclaration {...props} name={interfaceName.value} />\n      }>\n      <ReflectionClassContext.Provider\n        value={{\n          reflection: reflection!\n        }}>\n        <TSDocReflectionClass heading={doc} />\n        <BaseInterfaceDeclaration\n          export={true}\n          name={interfaceName.value}\n          {...rest}>\n          <For each={properties} doubleHardline={true} semicolon={true}>\n            {prop => <InterfaceDeclarationProperty property={prop} />}\n          </For>\n        </BaseInterfaceDeclaration>\n      </ReflectionClassContext.Provider>\n    </Show>\n  );\n}\n\n/**\n * Generates a TypeScript interface property for the given reflection class.\n */\nexport function InterfaceDeclarationProperty(\n  props: InterfaceDeclarationPropertyProps\n) {\n  const [{ property }, rest] = splitProps(props, [\"property\"]);\n\n  return (\n    <ReflectionPropertyContext.Provider value={property}>\n      <TSDocReflectionProperty />\n      <InterfaceMember\n        name={property.getNameAsString()}\n        readonly={property.isReadonly()}\n        optional={property.isOptional()}\n        nullish={property.isNullable()}\n        type={stringifyType(property.getType())}\n        {...rest}\n      />\n    </ReflectionPropertyContext.Provider>\n  );\n}\n"],"mappings":""}