@powerlines/plugin-alloy 0.18.118 → 0.19.0

package/dist/core/components/output.d.mts

@@ -1,5 +1,5 @@
 import { MetaItem } from "../contexts/context.mjs";
-import * as _alloy_js_core1 from "@alloy-js/core";
+import * as _alloy_js_core0 from "@alloy-js/core";
 import { OutputProps } from "@alloy-js/core";
 import { PluginContext } from "powerlines/types/context";
 
@@ -17,7 +17,7 @@ interface OutputProps$1<TContext extends PluginContext = PluginContext, TMeta ex
 /**
  * Output component for rendering the Powerlines plugin's output files via templates.
  */
-declare function Output$1<TContext extends PluginContext = PluginContext, TMeta extends Record<string, MetaItem> = Record<string, MetaItem>>(props: OutputProps$1<TContext, TMeta>): _alloy_js_core1.Children;
+declare function Output$1<TContext extends PluginContext = PluginContext, TMeta extends Record<string, MetaItem> = Record<string, MetaItem>>(props: OutputProps$1<TContext, TMeta>): _alloy_js_core0.Children;
 declare type __ΩOutputProps = any[];
 //#endregion
 export { Output$1 as Output, OutputProps$1 as OutputProps, __ΩOutputProps };

package/dist/core/components/single-line-comment.d.mts

@@ -1,5 +1,5 @@
 import { ComponentProps } from "../../types/components.mjs";
-import * as _alloy_js_core0 from "@alloy-js/core";
+import * as _alloy_js_core1 from "@alloy-js/core";
 
 //#region src/core/components/single-line-comment.d.ts
 type SingleLineCommentVariant = "double-slash" | "triple-slash" | "slash-star" | "slash-star-star" | "markdown";
@@ -15,7 +15,7 @@ interface SingleLineCommentProps extends ComponentProps {
  * A single line comment block. The children are rendered as a prose element, which means that they
  * are broken into multiple lines
  */
-declare function SingleLineComment(props: SingleLineCommentProps): _alloy_js_core0.Children;
+declare function SingleLineComment(props: SingleLineCommentProps): _alloy_js_core1.Children;
 declare type __ΩSingleLineCommentVariant = any[];
 declare type __ΩSingleLineCommentProps = any[];
 //#endregion

package/dist/core/contexts/context.cjs

@@ -7,15 +7,15 @@ const require_unctx = require('../../internal/unctx.cjs');
 * @returns The Context.
 */
 function usePowerlinesContext() {
-	return require_unctx.unctx.use();
+	return require_unctx.unctx.tryUse();
 }
 /**
 * Hook to safely access the {@link PluginContext | Powerlines context}.
 *
-* @returns The Powerlines context or undefined if not set.
+* @returns The Powerlines context or null if not set.
 */
 function usePowerlinesSafe() {
-	return usePowerlinesContext()?.value;
+	return usePowerlinesContext()?.value ?? null;
 }
 /**
 * Hook to access the {@link PluginContext | Powerlines context}.
@@ -30,10 +30,10 @@ function usePowerlines() {
 /**
 * Hook to safely access the render context's metadata.
 *
-* @returns The Powerlines context or undefined if not set.
+* @returns The Powerlines context or null if not set.
 */
 function useMetaSafe() {
-	return usePowerlinesContext()?.meta;
+	return usePowerlinesContext()?.meta ?? null;
 }
 /**
 * Hook to access the render context's metadata.

package/dist/core/contexts/context.d.cts

@@ -35,13 +35,13 @@ interface PowerlinesContextInterface<TContext extends PluginContext = PluginCont
  *
  * @returns The Context.
  */
-declare function usePowerlinesContext<TContext extends PluginContext = PluginContext, TMeta extends Record<string, MetaItem> = Record<string, MetaItem>>(): PowerlinesContextInterface<TContext, TMeta> | undefined;
+declare function usePowerlinesContext<TContext extends PluginContext = PluginContext, TMeta extends Record<string, MetaItem> = Record<string, MetaItem>>(): PowerlinesContextInterface<TContext, TMeta> | null;
 /**
  * Hook to safely access the {@link PluginContext | Powerlines context}.
  *
- * @returns The Powerlines context or undefined if not set.
+ * @returns The Powerlines context or null if not set.
  */
-declare function usePowerlinesSafe<TContext extends PluginContext = PluginContext>(): TContext | undefined;
+declare function usePowerlinesSafe<TContext extends PluginContext = PluginContext>(): TContext | null;
 /**
  * Hook to access the {@link PluginContext | Powerlines context}.
  *
@@ -51,9 +51,9 @@ declare function usePowerlines<TContext extends PluginContext = PluginContext>()
 /**
  * Hook to safely access the render context's metadata.
  *
- * @returns The Powerlines context or undefined if not set.
+ * @returns The Powerlines context or null if not set.
  */
-declare function useMetaSafe<TMeta extends Record<string, MetaItem> = Record<string, MetaItem>>(): TMeta | undefined;
+declare function useMetaSafe<TMeta extends Record<string, MetaItem> = Record<string, MetaItem>>(): TMeta | null;
 /**
  * Hook to access the render context's metadata.
  *

package/dist/core/contexts/context.d.mts

@@ -35,13 +35,13 @@ interface PowerlinesContextInterface<TContext extends PluginContext = PluginCont
  *
  * @returns The Context.
  */
-declare function usePowerlinesContext<TContext extends PluginContext = PluginContext, TMeta extends Record<string, MetaItem> = Record<string, MetaItem>>(): PowerlinesContextInterface<TContext, TMeta> | undefined;
+declare function usePowerlinesContext<TContext extends PluginContext = PluginContext, TMeta extends Record<string, MetaItem> = Record<string, MetaItem>>(): PowerlinesContextInterface<TContext, TMeta> | null;
 /**
  * Hook to safely access the {@link PluginContext | Powerlines context}.
  *
- * @returns The Powerlines context or undefined if not set.
+ * @returns The Powerlines context or null if not set.
  */
-declare function usePowerlinesSafe<TContext extends PluginContext = PluginContext>(): TContext | undefined;
+declare function usePowerlinesSafe<TContext extends PluginContext = PluginContext>(): TContext | null;
 /**
  * Hook to access the {@link PluginContext | Powerlines context}.
  *
@@ -51,9 +51,9 @@ declare function usePowerlines<TContext extends PluginContext = PluginContext>()
 /**
  * Hook to safely access the render context's metadata.
  *
- * @returns The Powerlines context or undefined if not set.
+ * @returns The Powerlines context or null if not set.
  */
-declare function useMetaSafe<TMeta extends Record<string, MetaItem> = Record<string, MetaItem>>(): TMeta | undefined;
+declare function useMetaSafe<TMeta extends Record<string, MetaItem> = Record<string, MetaItem>>(): TMeta | null;
 /**
  * Hook to access the render context's metadata.
  *

package/dist/core/contexts/context.mjs

@@ -7,15 +7,15 @@ import { unctx } from "../../internal/unctx.mjs";
 * @returns The Context.
 */
 function usePowerlinesContext() {
-	return unctx.use();
+	return unctx.tryUse();
 }
 /**
 * Hook to safely access the {@link PluginContext | Powerlines context}.
 *
-* @returns The Powerlines context or undefined if not set.
+* @returns The Powerlines context or null if not set.
 */
 function usePowerlinesSafe() {
-	return usePowerlinesContext()?.value;
+	return usePowerlinesContext()?.value ?? null;
 }
 /**
 * Hook to access the {@link PluginContext | Powerlines context}.
@@ -30,10 +30,10 @@ function usePowerlines() {
 /**
 * Hook to safely access the render context's metadata.
 *
-* @returns The Powerlines context or undefined if not set.
+* @returns The Powerlines context or null if not set.
 */
 function useMetaSafe() {
-	return usePowerlinesContext()?.meta;
+	return usePowerlinesContext()?.meta ?? null;
 }
 /**
 * Hook to access the render context's metadata.

package/dist/helpers/capnp.cjs

@@ -0,0 +1,276 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let defu = require("defu");
+defu = require_rolldown_runtime.__toESM(defu);
+let __powerlines_deepkit_utilities = require("@powerlines/deepkit/utilities");
+let __stryke_string_format_camel_case = require("@stryke/string-format/camel-case");
+let __stryke_string_format_title_case = require("@stryke/string-format/title-case");
+let __stryke_type_checks_is_undefined = require("@stryke/type-checks/is-undefined");
+let __powerlines_deepkit_vendor_core = require("@powerlines/deepkit/vendor/core");
+let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let __stryke_capnp_compile = require("@stryke/capnp/compile");
+let __stryke_capnp_helpers = require("@stryke/capnp/helpers");
+let __stryke_convert_to_array = require("@stryke/convert/to-array");
+let __stryke_helpers_get_unique = require("@stryke/helpers/get-unique");
+let __stryke_json = require("@stryke/json");
+let __stryke_path_join = require("@stryke/path/join");
+let __stryke_string_format_get_words = require("@stryke/string-format/get-words");
+let __stryke_string_format_pascal_case = require("@stryke/string-format/pascal-case");
+let __stryke_type_checks_is_bigint = require("@stryke/type-checks/is-bigint");
+let __stryke_type_checks_is_null = require("@stryke/type-checks/is-null");
+let __stryke_type_checks_is_number = require("@stryke/type-checks/is-number");
+let __stryke_type_checks_is_string = require("@stryke/type-checks/is-string");
+let node_buffer = require("node:buffer");
+let node_child_process = require("node:child_process");
+let node_util = require("node:util");
+let powerlines_lib_utilities_file_header = require("powerlines/lib/utilities/file-header");
+
+//#region src/helpers/capnp.ts
+/**
+* Compiles a Cap'n Proto schema into TypeScript definitions.
+*
+* @param context - The context containing the project and workspace information.
+* @param options - The options for compiling the schema.
+* @returns A promise that resolves to the compiled schema.
+*/
+async function compile(context, options = {}) {
+	const opts = (0, defu.default)(options, {
+		ts: true,
+		js: false,
+		dts: false,
+		schemas: (0, __stryke_path_join.joinPaths)(context.artifactsPath, "schemas"),
+		tsconfig: context.tsconfig,
+		projectRoot: context.config.projectRoot,
+		workspaceRoot: context.workspaceConfig.workspaceRoot,
+		tty: true
+	});
+	const resolvedOptions = await (0, __stryke_capnp_helpers.resolveOptions)(opts);
+	if (!resolvedOptions) throw new Error(`✖ No Cap'n Proto schema files found in the specified source paths: ${(0, __stryke_convert_to_array.toArray)(opts.schemas).join(", ")}.`);
+	return (0, __stryke_capnp_compile.capnpc)(resolvedOptions);
+}
+/**
+* Converts any {@link ReflectionProperty} or {@link ReflectionParameter}'s value to string representation.
+*
+* @param property - The {@link ReflectionProperty} or {@link ReflectionParameter} containing the value to stringify.
+* @param value - The value to stringify.
+* @returns A string representation of the value.
+*/
+function stringifyCapnpDefaultValue(property, value) {
+	return stringifyCapnpValue(property.type, value ?? property.getDefaultValue());
+}
+/**
+* Converts any {@link Type}'s actual value to string representation.
+*
+* @param type - The {@link Type} of the value to stringify.
+* @param value - The value to stringify.
+* @returns A string representation of the value.
+*/
+function stringifyCapnpValue(type, value) {
+	return type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string || type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.literal && (0, __stryke_type_checks_is_string.isString)(type.literal) ? `"${String(value)}"` : type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.enum ? `${(0, __stryke_string_format_camel_case.camelCase)(String(value))}` : type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.array ? __stryke_json.StormJSON.stringify(value) : type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.object || type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.objectLiteral ? __stryke_json.StormJSON.stringify(value).replaceAll("{", "(").replaceAll("}", ")") : String(value);
+}
+/**
+* Converts a ReflectionProperty's default value to a Cap'n Proto schema string representation.
+*
+* @param type - The TypeEnum to evaluate.
+* @returns A string representation of the property.
+*/
+function getCapnpEnumTypes(type) {
+	if (type.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.enum) return null;
+	const unique = (0, __stryke_helpers_get_unique.getUniqueBy)(type.values.filter((value) => !(0, __stryke_type_checks_is_undefined.isUndefined)(value) && !(0, __stryke_type_checks_is_null.isNull)(value)), (enumMember) => (0, __stryke_type_checks_is_string.isString)(enumMember) ? "Text" : "Float32");
+	if (unique.length === 0) return null;
+	return unique[0] && (0, __stryke_type_checks_is_string.isString)(unique[0]) ? "Text" : "Float32";
+}
+/**
+* Determines if a Type is a `Void` type in a Cap'n Proto schema.
+*
+* @param type - The Type to check.
+* @returns True if the Type is a `Void` type, false otherwise.
+*/
+function isVoidType(type) {
+	return type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.void || type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.never || type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.null || type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.undefined || type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.symbol;
+}
+/**
+* Converts a {@link TypeUnion} to an array of its underlying Cap'n Proto primitive type representation.
+*
+* @param type - The {@link TypeUnion} to convert.
+* @returns A string representation of the Cap'n Proto primitive type.
+*/
+function getCapnpUnionTypes(type) {
+	return (0, __powerlines_deepkit_utilities.getUnionTypes)(type);
+}
+/**
+* Converts a {@link TypeUnion} to an array of its underlying Cap'n Proto primitive type representation.
+*
+* @param type - The {@link TypeUnion} to convert.
+* @returns An array of Cap'n Proto primitive types.
+*/
+function isCapnpStringUnion(type) {
+	return getCapnpUnionTypes(type).some((member) => member.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string);
+}
+const LARGE_BUFFER = 1024 * 1e6;
+const execAsync = (0, node_util.promisify)(node_child_process.exec);
+async function generateCapnpId() {
+	const { stdout } = await execAsync("capnp id", {
+		windowsHide: true,
+		maxBuffer: LARGE_BUFFER,
+		killSignal: "SIGTERM"
+	});
+	return stdout;
+}
+async function generateCapnp(context, reflection, options) {
+	return `${(await generateCapnpId()).trim()};
+${(0, powerlines_lib_utilities_file_header.getBaseFileHeader)(context).replace(/^\r*\n*/g, "").replaceAll("//", "#")}
+${reflection.getMethods().length === 0 ? generateCapnpStruct(reflection, options) : generateCapnpInterface(reflection, options)}
+`.trim();
+}
+function generateCapnpStruct(reflection, options = {}) {
+	const structName = options?.name || reflection.getTitle() || reflection.getClassName() || reflection.getName();
+	return `${generateCapnpEnums(reflection)}struct ${(0, __stryke_string_format_pascal_case.pascalCase)(structName)} {
+  # Struct definition for ${(0, __stryke_string_format_title_case.titleCase)(structName)}.
+
+  ${generateCapnpSchema(reflection, options)}
+}
+`;
+}
+function generateCapnpInterface(reflection, options = {}) {
+	const interfaceName = options?.name || reflection.getTitle() || reflection.getClassName() || reflection.getName();
+	return `${generateCapnpEnums(reflection)}interface ${(0, __stryke_string_format_pascal_case.pascalCase)(interfaceName)} {
+  # Interface definition for ${(0, __stryke_string_format_title_case.titleCase)(interfaceName)}.
+
+  ${generateCapnpSchema(reflection, options)}
+}
+`;
+}
+function formatEnumName(name) {
+	return (0, __stryke_string_format_pascal_case.pascalCase)(`${name}_Type`);
+}
+function generateCapnpEnums(reflection) {
+	const enums = reflection.getProperties().filter((prop) => !prop.isIgnored() && (prop.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.enum || prop.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.union && getCapnpUnionTypes(prop.type).filter((type) => type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.literal && ((0, __stryke_type_checks_is_string.isString)(type.literal) || (0, __stryke_type_checks_is_number.isNumber)(type.literal))).length === 1)).sort((a, b) => a.isReadonly() && b.isReadonly() || !a.isReadonly() && !b.isReadonly() ? b.getNameAsString().localeCompare(a.getNameAsString()) : a.isReadonly() ? 1 : -1);
+	if (enums.length === 0) return "";
+	return `${enums.map((enumeration) => generateCapnpEnumSchema(enumeration.type, formatEnumName(enumeration.getNameAsString()))).join("\n\n")}
+
+`;
+}
+function generateCapnpSchema(reflection, options = {}) {
+	let index = 0;
+	const indexCounter = options?.indexCounter ?? (() => index++);
+	return `${reflection.getProperties().filter((prop) => !prop.isIgnored()).sort((a, b) => a.isReadonly() && b.isReadonly() || !a.isReadonly() && !b.isReadonly() ? b.getNameAsString().localeCompare(a.getNameAsString()) : a.isReadonly() ? 1 : -1).map((prop) => generateCapnpPropertySchema(prop, indexCounter)).join(" \n\n	")}${reflection.getMethods().filter((methods) => !methods.isIgnored()).sort((a, b) => a.isReadonly() && b.isReadonly() || !a.isReadonly() && !b.isReadonly() ? String(b.getName()).localeCompare(String(a.getName())) : a.isReadonly() ? 1 : -1).map((methods) => generateCapnpMethodSchema(methods, indexCounter)).join(" \n\n	")}${reflection.getProperties().some((prop) => prop.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.class && prop.type.classType === Map) ? `
+  struct Map(Key, Value) {
+    entries @0 :List(Entry);
+
+    struct Entry {
+      key @0 :Key;
+      value @1 :Value;
+    }
+  }` : ""}${reflection.getProperties().some((prop) => prop.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.class && prop.type.classType === Date) ? `
+  struct Date {
+    # A standard Gregorian calendar date.
+
+    year @0 :Int16;
+    # The year - Must include the century.
+    # Negative value indicates BC.
+
+    month @1 :UInt8; # The month, 1-12
+
+    day @2 :UInt8; # The day of the month, 1-30
+
+    hour @3 :UInt8;    # The hour of the day, 0-23
+
+    minute @4 :UInt8;  # The minute of the hour, 0-59
+
+    second @5 :UInt8;  # The second of the minute, 0-59
+
+    millisecond @6 :UInt16; # Milliseconds of the second, 0-999
+  }` : ""}`;
+}
+function generateCapnpMethodSchema(reflection, indexCounter) {
+	const methodName = reflection.getTitle() || typeof reflection.getName() === "string" ? String(reflection.getName()) : "";
+	if (!methodName) throw new Error(`Cannot generate Cap'n Proto schema for method without a name - Parent interface: ${reflection.reflectionClass.getName()}`);
+	return `${(0, __stryke_string_format_camel_case.camelCase)(methodName)} @${indexCounter()} (${reflection.getParameters().map((param) => {
+		return `${(0, __stryke_string_format_camel_case.camelCase)(param.getName())} :${generateCapnpPrimitive(param.getType())}${param.hasDefault() ? ` = ${stringifyCapnpDefaultValue(param)}` : ""}`;
+	}).join(", ")})${isVoidType(reflection.getReturnType()) ? "" : ` -> (${(0, __powerlines_deepkit_utilities.kindToName)(reflection.getReturnType().kind)}: ${generateCapnpPrimitive(reflection.getReturnType())})`}; # ${(reflection.getDescription() || `The ${(0, __stryke_string_format_title_case.titleCase)(reflection.reflectionClass.getTitle() || reflection.reflectionClass.getName())} interface ${(0, __stryke_string_format_title_case.titleCase)(methodName)} method.`).replaceAll("\n", ". ")}`;
+}
+function generateCapnpPropertyComment(reflection) {
+	const result = (0, __stryke_string_format_get_words.getWords)(reflection.getDescription() || `A schema property for ${(0, __stryke_string_format_title_case.titleCase)(reflection.getTitle() || reflection.getNameAsString())} field.`, { relaxed: true }).reduce((ret, word) => {
+		let length = ret.length;
+		if (ret.includes("\n")) length = ret.substring(ret.lastIndexOf("\n") + 1).length;
+		const current = word.trim();
+		if (length + current.length > 60) ret += `\n\t# ${current}`;
+		else ret += ` ${current}`;
+		return ret;
+	}, "").trim();
+	if (result.length > 0) return `\t# ${result}`;
+	return "";
+}
+function generateCapnpPropertySchema(reflection, indexCounter) {
+	if (reflection.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.union) if (getCapnpUnionTypes(reflection.type).length === 0) return `${(0, __stryke_string_format_camel_case.camelCase)(reflection.getNameAsString())} @${indexCounter()} :Void;
+${generateCapnpPropertyComment(reflection)}`;
+	else if (getCapnpUnionTypes(reflection.type).filter((type) => type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.literal && ((0, __stryke_type_checks_is_string.isString)(type.literal) || (0, __stryke_type_checks_is_number.isNumber)(type.literal))).length === 1) return `${(0, __stryke_string_format_camel_case.camelCase)(reflection.getNameAsString())} @${indexCounter()} :${formatEnumName(reflection.getNameAsString())}${reflection.hasDefault() ? ` = ${stringifyCapnpDefaultValue(reflection)}` : ""};
+${generateCapnpPropertyComment(reflection)}`;
+	else return `${(0, __stryke_string_format_camel_case.camelCase)(reflection.getNameAsString())} :union {
+${getCapnpUnionTypes(reflection.type).map((type) => `   ${(0, __powerlines_deepkit_utilities.kindToName)(type.kind)} @${indexCounter()} :${generateCapnpPrimitive(type)};`).join("\n")}
+  }
+${generateCapnpPropertyComment(reflection)}`;
+	else if (reflection.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.array) return `${(0, __stryke_string_format_camel_case.camelCase)(reflection.getNameAsString())} @${indexCounter()} :List(${generateCapnpPrimitive(reflection.getSubType())})${reflection.hasDefault() ? ` = ${stringifyCapnpDefaultValue(reflection)}` : ""};
+${generateCapnpPropertyComment(reflection)}`;
+	else if (reflection.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.class) if (reflection.type.classType === Map) return `${(0, __stryke_string_format_camel_case.camelCase)(reflection.getNameAsString())} @${indexCounter()} :Map(${!reflection.type.typeArguments || reflection.type.typeArguments.length === 0 || !reflection.type.typeArguments[0] ? "Data" : generateCapnpPrimitive(reflection.type.typeArguments[0])}, ${!reflection.type.typeArguments || reflection.type.typeArguments.length < 2 || !reflection.type.typeArguments[1] ? "Data" : generateCapnpPrimitive(reflection.type.typeArguments[1])})${reflection.hasDefault() ? ` = ${stringifyCapnpDefaultValue(reflection)}` : ""};
+${generateCapnpPropertyComment(reflection)}`;
+	else if (reflection.type.classType === Date) return `${(0, __stryke_string_format_camel_case.camelCase)(reflection.getNameAsString())} @${indexCounter()} :Data${reflection.hasDefault() ? ` = ${stringifyCapnpDefaultValue(reflection)}` : ""};
+${generateCapnpPropertyComment(reflection)}`;
+	else if (reflection.type.classType === node_buffer.Buffer) return `${(0, __stryke_string_format_camel_case.camelCase)(reflection.getNameAsString())} @${indexCounter()} :Data${reflection.hasDefault() ? ` = ${stringifyCapnpDefaultValue(reflection)}` : ""};
+${generateCapnpPropertyComment(reflection)}`;
+	else if (reflection.type.classType === ArrayBuffer) return `${(0, __stryke_string_format_camel_case.camelCase)(reflection.getNameAsString())} @${indexCounter()} :Data${reflection.hasDefault() ? ` = ${stringifyCapnpDefaultValue(reflection)}` : ""};
+${generateCapnpPropertyComment(reflection)}`;
+	else return `${(0, __stryke_string_format_camel_case.camelCase)(reflection.getNameAsString())} @${indexCounter()} :${(0, __stryke_string_format_pascal_case.pascalCase)(reflection.type.typeName || (0, __powerlines_deepkit_vendor_core.getClassName)(reflection.type.classType))}${generateCapnpStruct(reflection.reflectionClass, { name: (0, __stryke_string_format_pascal_case.pascalCase)(reflection.type.typeName || (0, __powerlines_deepkit_vendor_core.getClassName)(reflection.type.classType)) })}${reflection.hasDefault() ? ` = ${stringifyCapnpDefaultValue(reflection)}` : ""};
+${generateCapnpPropertyComment(reflection)}`;
+	else if (reflection.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.objectLiteral) return `${(0, __stryke_string_format_camel_case.camelCase)(reflection.getNameAsString())} @${indexCounter()} :${(0, __stryke_string_format_pascal_case.pascalCase)(reflection.type.typeName || (0, __powerlines_deepkit_vendor_type.memberNameToString)(reflection.getNameAsString()))}${generateCapnpStruct(reflection.reflectionClass, { name: (0, __stryke_string_format_pascal_case.pascalCase)(reflection.type.typeName || (0, __powerlines_deepkit_vendor_type.memberNameToString)(reflection.getNameAsString())) })}${reflection.hasDefault() ? ` = ${stringifyCapnpDefaultValue(reflection)}` : ""};
+${generateCapnpPropertyComment(reflection)}`;
+	else if (reflection.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.enum) return `${(0, __stryke_string_format_camel_case.camelCase)(reflection.getNameAsString())} @${indexCounter()} :${(0, __stryke_string_format_pascal_case.pascalCase)(reflection.getNameAsString())}${reflection.hasDefault() ? ` = ${stringifyCapnpDefaultValue(reflection)}` : ""};
+${generateCapnpPropertyComment(reflection)}`;
+	return `${(0, __stryke_string_format_camel_case.camelCase)(reflection.getNameAsString())} @${indexCounter()} :${generateCapnpPrimitive(reflection.getType())}${reflection.hasDefault() ? ` = ${stringifyCapnpDefaultValue(reflection)}` : ""};
+${generateCapnpPropertyComment(reflection)}`;
+}
+function generateCapnpEnumSchema(type, name) {
+	if (type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.union) return generateCapnpEnumSchema({
+		kind: __powerlines_deepkit_vendor_type.ReflectionKind.enum,
+		indexType: type,
+		enum: type.types.reduce((ret, type$1) => {
+			if ((0, __stryke_type_checks_is_string.isString)(type$1.literal) || (0, __stryke_type_checks_is_number.isNumber)(type$1.literal)) ret[(0, __stryke_string_format_camel_case.camelCase)(String(type$1.literal))] = type$1.literal;
+			return ret;
+		}, {}),
+		values: getCapnpUnionTypes(type).filter((type$1) => type$1.kind === __powerlines_deepkit_vendor_type.ReflectionKind.literal && ((0, __stryke_type_checks_is_string.isString)(type$1.literal) || (0, __stryke_type_checks_is_number.isNumber)(type$1.literal))).map((type$1) => type$1.literal)
+	}, name);
+	let index = 0;
+	const indexCounter = () => index++;
+	const enumType = getCapnpEnumTypes(type);
+	if (!enumType) return "";
+	return `enum ${(0, __stryke_string_format_pascal_case.pascalCase)(name)} {
+${type.enum && Object.entries(type.enum).length > 0 ? Object.entries(type.enum).filter(([, value]) => value !== null && value !== void 0).map(([key]) => `    ${(0, __stryke_string_format_camel_case.camelCase)(key)} @${indexCounter()};`).join("\n") : type.values.filter((value) => value !== null && value !== void 0).map((value) => `${enumType === "Text" && value ? (0, __stryke_string_format_camel_case.camelCase)(String(value)) : `${type.typeName ? `${(0, __stryke_string_format_camel_case.camelCase)(type.typeName)}_` : ""}${value || ""}`} @${indexCounter()};`).join("\n")}
+  }`;
+}
+/**
+* Generates a string representation of Cap'n Proto primitive types from a Deepkit Type.
+*
+* @param type - The Deepkit Type to convert.
+* @returns A string representation of the Cap'n Proto primitive type.
+*/
+function generateCapnpPrimitive(type) {
+	return type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.never || type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.void || type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.null || type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.undefined || type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.symbol ? "Void" : type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.class && type.classType === Date ? "Date" : type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.class && type.classType === Set ? `List(${type.typeArguments && type.typeArguments[0] ? generateCapnpPrimitive(type.typeArguments[0]) : "Data"})` : type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.bigint ? "UInt64" : type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.number ? "Float64" : type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string || type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.regexp ? "Text" : type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.boolean ? "Bool" : type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.literal ? (0, __stryke_type_checks_is_number.isNumber)(type.literal) ? "Float64" : (0, __stryke_type_checks_is_bigint.isBigInt)(type.literal) ? "UInt64" : (0, __stryke_type_checks_is_string.isString)(type.literal) ? "Text" : typeof type.literal === "boolean" ? "Bool" : "Data" : "Data";
+}
+
+//#endregion
+exports.LARGE_BUFFER = LARGE_BUFFER;
+exports.compile = compile;
+exports.generateCapnp = generateCapnp;
+exports.generateCapnpEnumSchema = generateCapnpEnumSchema;
+exports.generateCapnpId = generateCapnpId;
+exports.generateCapnpInterface = generateCapnpInterface;
+exports.generateCapnpMethodSchema = generateCapnpMethodSchema;
+exports.generateCapnpPrimitive = generateCapnpPrimitive;
+exports.generateCapnpSchema = generateCapnpSchema;
+exports.generateCapnpStruct = generateCapnpStruct;
+exports.getCapnpEnumTypes = getCapnpEnumTypes;
+exports.getCapnpUnionTypes = getCapnpUnionTypes;
+exports.isCapnpStringUnion = isCapnpStringUnion;
+exports.isVoidType = isVoidType;
+exports.stringifyCapnpDefaultValue = stringifyCapnpDefaultValue;
+exports.stringifyCapnpValue = stringifyCapnpValue;

package/dist/helpers/capnp.d.cts

@@ -0,0 +1,87 @@
+import { Context, PluginContext } from "powerlines/types/context";
+import { ReflectionClass, ReflectionMethod, ReflectionParameter, ReflectionProperty, Type, TypeEnum, TypeUnion } from "@powerlines/deepkit/vendor/type";
+import { CapnpcOptions, CapnpcResult } from "@stryke/capnp/types";
+
+//#region src/helpers/capnp.d.ts
+
+/**
+ * Compiles a Cap'n Proto schema into TypeScript definitions.
+ *
+ * @param context - The context containing the project and workspace information.
+ * @param options - The options for compiling the schema.
+ * @returns A promise that resolves to the compiled schema.
+ */
+declare function compile(context: Context, options?: Partial<CapnpcOptions>): Promise<CapnpcResult>;
+/**
+ * Converts any {@link ReflectionProperty} or {@link ReflectionParameter}'s value to string representation.
+ *
+ * @param property - The {@link ReflectionProperty} or {@link ReflectionParameter} containing the value to stringify.
+ * @param value - The value to stringify.
+ * @returns A string representation of the value.
+ */
+declare function stringifyCapnpDefaultValue(property: ReflectionProperty | ReflectionParameter, value?: any): string;
+/**
+ * Converts any {@link Type}'s actual value to string representation.
+ *
+ * @param type - The {@link Type} of the value to stringify.
+ * @param value - The value to stringify.
+ * @returns A string representation of the value.
+ */
+declare function stringifyCapnpValue(type: Type, value: any): string;
+/**
+ * Converts a ReflectionProperty's default value to a Cap'n Proto schema string representation.
+ *
+ * @param type - The TypeEnum to evaluate.
+ * @returns A string representation of the property.
+ */
+declare function getCapnpEnumTypes(type: Type): "Text" | "Float32" | null;
+/**
+ * Determines if a Type is a `Void` type in a Cap'n Proto schema.
+ *
+ * @param type - The Type to check.
+ * @returns True if the Type is a `Void` type, false otherwise.
+ */
+declare function isVoidType(type: Type): boolean;
+/**
+ * Converts a {@link TypeUnion} to an array of its underlying Cap'n Proto primitive type representation.
+ *
+ * @param type - The {@link TypeUnion} to convert.
+ * @returns A string representation of the Cap'n Proto primitive type.
+ */
+declare function getCapnpUnionTypes(type: Type): Type[];
+/**
+ * Converts a {@link TypeUnion} to an array of its underlying Cap'n Proto primitive type representation.
+ *
+ * @param type - The {@link TypeUnion} to convert.
+ * @returns An array of Cap'n Proto primitive types.
+ */
+declare function isCapnpStringUnion(type: Type): boolean;
+declare const LARGE_BUFFER: number;
+type IOType = "overlapped" | "pipe" | "ignore" | "inherit";
+type StdioOptions = IOType | Array<IOType | "ipc" | number | null | undefined>;
+declare function generateCapnpId(): Promise<string>;
+interface GenerateCapnpOptions {
+  name?: string;
+}
+declare function generateCapnp(context: PluginContext, reflection: ReflectionClass<any>, options: GenerateCapnpOptions): Promise<string>;
+interface GenerateCapnpStructOptions extends GenerateCapnpOptions {
+  indexCounter?: () => number;
+}
+declare function generateCapnpStruct(reflection: ReflectionClass<any>, options?: GenerateCapnpStructOptions): string;
+declare function generateCapnpInterface(reflection: ReflectionClass<any>, options?: GenerateCapnpStructOptions): string;
+declare function generateCapnpSchema(reflection: ReflectionClass<any>, options?: GenerateCapnpStructOptions): string;
+declare function generateCapnpMethodSchema(reflection: ReflectionMethod, indexCounter: () => number): string;
+declare function generateCapnpEnumSchema(type: TypeEnum | TypeUnion, name: string): string;
+/**
+ * Generates a string representation of Cap'n Proto primitive types from a Deepkit Type.
+ *
+ * @param type - The Deepkit Type to convert.
+ * @returns A string representation of the Cap'n Proto primitive type.
+ */
+declare function generateCapnpPrimitive(type: Type): string;
+declare type __ΩIOType = any[];
+declare type __ΩStdioOptions = any[];
+declare type __ΩGenerateCapnpOptions = any[];
+declare type __ΩGenerateCapnpStructOptions = any[];
+//#endregion
+export { GenerateCapnpOptions, GenerateCapnpStructOptions, IOType, LARGE_BUFFER, StdioOptions, __ΩGenerateCapnpOptions, __ΩGenerateCapnpStructOptions, __ΩIOType, __ΩStdioOptions, compile, generateCapnp, generateCapnpEnumSchema, generateCapnpId, generateCapnpInterface, generateCapnpMethodSchema, generateCapnpPrimitive, generateCapnpSchema, generateCapnpStruct, getCapnpEnumTypes, getCapnpUnionTypes, isCapnpStringUnion, isVoidType, stringifyCapnpDefaultValue, stringifyCapnpValue };

package/dist/helpers/capnp.d.mts

@@ -0,0 +1,87 @@
+import { ReflectionClass, ReflectionMethod, ReflectionParameter, ReflectionProperty, Type, TypeEnum, TypeUnion } from "@powerlines/deepkit/vendor/type";
+import { Context, PluginContext } from "powerlines/types/context";
+import { CapnpcOptions, CapnpcResult } from "@stryke/capnp/types";
+
+//#region src/helpers/capnp.d.ts
+
+/**
+ * Compiles a Cap'n Proto schema into TypeScript definitions.
+ *
+ * @param context - The context containing the project and workspace information.
+ * @param options - The options for compiling the schema.
+ * @returns A promise that resolves to the compiled schema.
+ */
+declare function compile(context: Context, options?: Partial<CapnpcOptions>): Promise<CapnpcResult>;
+/**
+ * Converts any {@link ReflectionProperty} or {@link ReflectionParameter}'s value to string representation.
+ *
+ * @param property - The {@link ReflectionProperty} or {@link ReflectionParameter} containing the value to stringify.
+ * @param value - The value to stringify.
+ * @returns A string representation of the value.
+ */
+declare function stringifyCapnpDefaultValue(property: ReflectionProperty | ReflectionParameter, value?: any): string;
+/**
+ * Converts any {@link Type}'s actual value to string representation.
+ *
+ * @param type - The {@link Type} of the value to stringify.
+ * @param value - The value to stringify.
+ * @returns A string representation of the value.
+ */
+declare function stringifyCapnpValue(type: Type, value: any): string;
+/**
+ * Converts a ReflectionProperty's default value to a Cap'n Proto schema string representation.
+ *
+ * @param type - The TypeEnum to evaluate.
+ * @returns A string representation of the property.
+ */
+declare function getCapnpEnumTypes(type: Type): "Text" | "Float32" | null;
+/**
+ * Determines if a Type is a `Void` type in a Cap'n Proto schema.
+ *
+ * @param type - The Type to check.
+ * @returns True if the Type is a `Void` type, false otherwise.
+ */
+declare function isVoidType(type: Type): boolean;
+/**
+ * Converts a {@link TypeUnion} to an array of its underlying Cap'n Proto primitive type representation.
+ *
+ * @param type - The {@link TypeUnion} to convert.
+ * @returns A string representation of the Cap'n Proto primitive type.
+ */
+declare function getCapnpUnionTypes(type: Type): Type[];
+/**
+ * Converts a {@link TypeUnion} to an array of its underlying Cap'n Proto primitive type representation.
+ *
+ * @param type - The {@link TypeUnion} to convert.
+ * @returns An array of Cap'n Proto primitive types.
+ */
+declare function isCapnpStringUnion(type: Type): boolean;
+declare const LARGE_BUFFER: number;
+type IOType = "overlapped" | "pipe" | "ignore" | "inherit";
+type StdioOptions = IOType | Array<IOType | "ipc" | number | null | undefined>;
+declare function generateCapnpId(): Promise<string>;
+interface GenerateCapnpOptions {
+  name?: string;
+}
+declare function generateCapnp(context: PluginContext, reflection: ReflectionClass<any>, options: GenerateCapnpOptions): Promise<string>;
+interface GenerateCapnpStructOptions extends GenerateCapnpOptions {
+  indexCounter?: () => number;
+}
+declare function generateCapnpStruct(reflection: ReflectionClass<any>, options?: GenerateCapnpStructOptions): string;
+declare function generateCapnpInterface(reflection: ReflectionClass<any>, options?: GenerateCapnpStructOptions): string;
+declare function generateCapnpSchema(reflection: ReflectionClass<any>, options?: GenerateCapnpStructOptions): string;
+declare function generateCapnpMethodSchema(reflection: ReflectionMethod, indexCounter: () => number): string;
+declare function generateCapnpEnumSchema(type: TypeEnum | TypeUnion, name: string): string;
+/**
+ * Generates a string representation of Cap'n Proto primitive types from a Deepkit Type.
+ *
+ * @param type - The Deepkit Type to convert.
+ * @returns A string representation of the Cap'n Proto primitive type.
+ */
+declare function generateCapnpPrimitive(type: Type): string;
+declare type __ΩIOType = any[];
+declare type __ΩStdioOptions = any[];
+declare type __ΩGenerateCapnpOptions = any[];
+declare type __ΩGenerateCapnpStructOptions = any[];
+//#endregion
+export { GenerateCapnpOptions, GenerateCapnpStructOptions, IOType, LARGE_BUFFER, StdioOptions, __ΩGenerateCapnpOptions, __ΩGenerateCapnpStructOptions, __ΩIOType, __ΩStdioOptions, compile, generateCapnp, generateCapnpEnumSchema, generateCapnpId, generateCapnpInterface, generateCapnpMethodSchema, generateCapnpPrimitive, generateCapnpSchema, generateCapnpStruct, getCapnpEnumTypes, getCapnpUnionTypes, isCapnpStringUnion, isVoidType, stringifyCapnpDefaultValue, stringifyCapnpValue };