@powerlines/plugin-alloy 0.19.13 → 0.19.14

package/dist/capnp-ClfqI-5t.cjs

@@ -0,0 +1,356 @@
+const require_chunk = require('./chunk-CbDLau6x.cjs');
+let defu = require("defu");
+defu = require_chunk.__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
+Object.defineProperty(exports, 'LARGE_BUFFER', {
+  enumerable: true,
+  get: function () {
+    return LARGE_BUFFER;
+  }
+});
+Object.defineProperty(exports, 'compile', {
+  enumerable: true,
+  get: function () {
+    return compile;
+  }
+});
+Object.defineProperty(exports, 'generateCapnp', {
+  enumerable: true,
+  get: function () {
+    return generateCapnp;
+  }
+});
+Object.defineProperty(exports, 'generateCapnpEnumSchema', {
+  enumerable: true,
+  get: function () {
+    return generateCapnpEnumSchema;
+  }
+});
+Object.defineProperty(exports, 'generateCapnpId', {
+  enumerable: true,
+  get: function () {
+    return generateCapnpId;
+  }
+});
+Object.defineProperty(exports, 'generateCapnpInterface', {
+  enumerable: true,
+  get: function () {
+    return generateCapnpInterface;
+  }
+});
+Object.defineProperty(exports, 'generateCapnpMethodSchema', {
+  enumerable: true,
+  get: function () {
+    return generateCapnpMethodSchema;
+  }
+});
+Object.defineProperty(exports, 'generateCapnpPrimitive', {
+  enumerable: true,
+  get: function () {
+    return generateCapnpPrimitive;
+  }
+});
+Object.defineProperty(exports, 'generateCapnpSchema', {
+  enumerable: true,
+  get: function () {
+    return generateCapnpSchema;
+  }
+});
+Object.defineProperty(exports, 'generateCapnpStruct', {
+  enumerable: true,
+  get: function () {
+    return generateCapnpStruct;
+  }
+});
+Object.defineProperty(exports, 'getCapnpEnumTypes', {
+  enumerable: true,
+  get: function () {
+    return getCapnpEnumTypes;
+  }
+});
+Object.defineProperty(exports, 'getCapnpUnionTypes', {
+  enumerable: true,
+  get: function () {
+    return getCapnpUnionTypes;
+  }
+});
+Object.defineProperty(exports, 'isCapnpStringUnion', {
+  enumerable: true,
+  get: function () {
+    return isCapnpStringUnion;
+  }
+});
+Object.defineProperty(exports, 'isVoidType', {
+  enumerable: true,
+  get: function () {
+    return isVoidType;
+  }
+});
+Object.defineProperty(exports, 'stringifyCapnpDefaultValue', {
+  enumerable: true,
+  get: function () {
+    return stringifyCapnpDefaultValue;
+  }
+});
+Object.defineProperty(exports, 'stringifyCapnpValue', {
+  enumerable: true,
+  get: function () {
+    return stringifyCapnpValue;
+  }
+});

package/dist/capnp-CnQcwo0s.mjs

@@ -0,0 +1,260 @@
+import defu from "defu";
+import { getUnionTypes, kindToName } from "@powerlines/deepkit/utilities";
+import { camelCase } from "@stryke/string-format/camel-case";
+import { titleCase } from "@stryke/string-format/title-case";
+import { isUndefined } from "@stryke/type-checks/is-undefined";
+import { getClassName } from "@powerlines/deepkit/vendor/core";
+import { ReflectionKind, memberNameToString } from "@powerlines/deepkit/vendor/type";
+import { capnpc } from "@stryke/capnp/compile";
+import { resolveOptions } from "@stryke/capnp/helpers";
+import { toArray } from "@stryke/convert/to-array";
+import { getUniqueBy } from "@stryke/helpers/get-unique";
+import { StormJSON } from "@stryke/json";
+import { joinPaths } from "@stryke/path/join";
+import { getWords } from "@stryke/string-format/get-words";
+import { pascalCase } from "@stryke/string-format/pascal-case";
+import { isBigInt } from "@stryke/type-checks/is-bigint";
+import { isNull } from "@stryke/type-checks/is-null";
+import { isNumber } from "@stryke/type-checks/is-number";
+import { isString } from "@stryke/type-checks/is-string";
+import { Buffer } from "node:buffer";
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import { getBaseFileHeader } from "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 = defu(options, {
+		ts: true,
+		js: false,
+		dts: false,
+		schemas: joinPaths(context.artifactsPath, "schemas"),
+		tsconfig: context.tsconfig,
+		projectRoot: context.config.projectRoot,
+		workspaceRoot: context.workspaceConfig.workspaceRoot,
+		tty: true
+	});
+	const resolvedOptions = await resolveOptions(opts);
+	if (!resolvedOptions) throw new Error(`✖ No Cap'n Proto schema files found in the specified source paths: ${toArray(opts.schemas).join(", ")}.`);
+	return 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 === ReflectionKind.string || type.kind === ReflectionKind.literal && isString(type.literal) ? `"${String(value)}"` : type.kind === ReflectionKind.enum ? `${camelCase(String(value))}` : type.kind === ReflectionKind.array ? StormJSON.stringify(value) : type.kind === ReflectionKind.object || type.kind === ReflectionKind.objectLiteral ? 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 !== ReflectionKind.enum) return null;
+	const unique = getUniqueBy(type.values.filter((value) => !isUndefined(value) && !isNull(value)), (enumMember) => isString(enumMember) ? "Text" : "Float32");
+	if (unique.length === 0) return null;
+	return unique[0] && 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 === ReflectionKind.void || type.kind === ReflectionKind.never || type.kind === ReflectionKind.null || type.kind === ReflectionKind.undefined || type.kind === 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 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 === ReflectionKind.string);
+}
+const LARGE_BUFFER = 1024 * 1e6;
+const execAsync = promisify(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()};
+${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 ${pascalCase(structName)} {
+  # Struct definition for ${titleCase(structName)}.
+
+  ${generateCapnpSchema(reflection, options)}
+}
+`;
+}
+function generateCapnpInterface(reflection, options = {}) {
+	const interfaceName = options?.name || reflection.getTitle() || reflection.getClassName() || reflection.getName();
+	return `${generateCapnpEnums(reflection)}interface ${pascalCase(interfaceName)} {
+  # Interface definition for ${titleCase(interfaceName)}.
+
+  ${generateCapnpSchema(reflection, options)}
+}
+`;
+}
+function formatEnumName(name) {
+	return pascalCase(`${name}_Type`);
+}
+function generateCapnpEnums(reflection) {
+	const enums = reflection.getProperties().filter((prop) => !prop.isIgnored() && (prop.type.kind === ReflectionKind.enum || prop.type.kind === ReflectionKind.union && getCapnpUnionTypes(prop.type).filter((type) => type.kind === ReflectionKind.literal && (isString(type.literal) || 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 === 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 === 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 `${camelCase(methodName)} @${indexCounter()} (${reflection.getParameters().map((param) => {
+		return `${camelCase(param.getName())} :${generateCapnpPrimitive(param.getType())}${param.hasDefault() ? ` = ${stringifyCapnpDefaultValue(param)}` : ""}`;
+	}).join(", ")})${isVoidType(reflection.getReturnType()) ? "" : ` -> (${kindToName(reflection.getReturnType().kind)}: ${generateCapnpPrimitive(reflection.getReturnType())})`}; # ${(reflection.getDescription() || `The ${titleCase(reflection.reflectionClass.getTitle() || reflection.reflectionClass.getName())} interface ${titleCase(methodName)} method.`).replaceAll("\n", ". ")}`;
+}
+function generateCapnpPropertyComment(reflection) {
+	const result = getWords(reflection.getDescription() || `A schema property for ${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 === ReflectionKind.union) if (getCapnpUnionTypes(reflection.type).length === 0) return `${camelCase(reflection.getNameAsString())} @${indexCounter()} :Void;
+${generateCapnpPropertyComment(reflection)}`;
+	else if (getCapnpUnionTypes(reflection.type).filter((type) => type.kind === ReflectionKind.literal && (isString(type.literal) || isNumber(type.literal))).length === 1) return `${camelCase(reflection.getNameAsString())} @${indexCounter()} :${formatEnumName(reflection.getNameAsString())}${reflection.hasDefault() ? ` = ${stringifyCapnpDefaultValue(reflection)}` : ""};
+${generateCapnpPropertyComment(reflection)}`;
+	else return `${camelCase(reflection.getNameAsString())} :union {
+${getCapnpUnionTypes(reflection.type).map((type) => `   ${kindToName(type.kind)} @${indexCounter()} :${generateCapnpPrimitive(type)};`).join("\n")}
+  }
+${generateCapnpPropertyComment(reflection)}`;
+	else if (reflection.type.kind === ReflectionKind.array) return `${camelCase(reflection.getNameAsString())} @${indexCounter()} :List(${generateCapnpPrimitive(reflection.getSubType())})${reflection.hasDefault() ? ` = ${stringifyCapnpDefaultValue(reflection)}` : ""};
+${generateCapnpPropertyComment(reflection)}`;
+	else if (reflection.type.kind === ReflectionKind.class) if (reflection.type.classType === Map) return `${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 `${camelCase(reflection.getNameAsString())} @${indexCounter()} :Data${reflection.hasDefault() ? ` = ${stringifyCapnpDefaultValue(reflection)}` : ""};
+${generateCapnpPropertyComment(reflection)}`;
+	else if (reflection.type.classType === Buffer) return `${camelCase(reflection.getNameAsString())} @${indexCounter()} :Data${reflection.hasDefault() ? ` = ${stringifyCapnpDefaultValue(reflection)}` : ""};
+${generateCapnpPropertyComment(reflection)}`;
+	else if (reflection.type.classType === ArrayBuffer) return `${camelCase(reflection.getNameAsString())} @${indexCounter()} :Data${reflection.hasDefault() ? ` = ${stringifyCapnpDefaultValue(reflection)}` : ""};
+${generateCapnpPropertyComment(reflection)}`;
+	else return `${camelCase(reflection.getNameAsString())} @${indexCounter()} :${pascalCase(reflection.type.typeName || getClassName(reflection.type.classType))}${generateCapnpStruct(reflection.reflectionClass, { name: pascalCase(reflection.type.typeName || getClassName(reflection.type.classType)) })}${reflection.hasDefault() ? ` = ${stringifyCapnpDefaultValue(reflection)}` : ""};
+${generateCapnpPropertyComment(reflection)}`;
+	else if (reflection.type.kind === ReflectionKind.objectLiteral) return `${camelCase(reflection.getNameAsString())} @${indexCounter()} :${pascalCase(reflection.type.typeName || memberNameToString(reflection.getNameAsString()))}${generateCapnpStruct(reflection.reflectionClass, { name: pascalCase(reflection.type.typeName || memberNameToString(reflection.getNameAsString())) })}${reflection.hasDefault() ? ` = ${stringifyCapnpDefaultValue(reflection)}` : ""};
+${generateCapnpPropertyComment(reflection)}`;
+	else if (reflection.type.kind === ReflectionKind.enum) return `${camelCase(reflection.getNameAsString())} @${indexCounter()} :${pascalCase(reflection.getNameAsString())}${reflection.hasDefault() ? ` = ${stringifyCapnpDefaultValue(reflection)}` : ""};
+${generateCapnpPropertyComment(reflection)}`;
+	return `${camelCase(reflection.getNameAsString())} @${indexCounter()} :${generateCapnpPrimitive(reflection.getType())}${reflection.hasDefault() ? ` = ${stringifyCapnpDefaultValue(reflection)}` : ""};
+${generateCapnpPropertyComment(reflection)}`;
+}
+function generateCapnpEnumSchema(type, name) {
+	if (type.kind === ReflectionKind.union) return generateCapnpEnumSchema({
+		kind: ReflectionKind.enum,
+		indexType: type,
+		enum: type.types.reduce((ret, type$1) => {
+			if (isString(type$1.literal) || isNumber(type$1.literal)) ret[camelCase(String(type$1.literal))] = type$1.literal;
+			return ret;
+		}, {}),
+		values: getCapnpUnionTypes(type).filter((type$1) => type$1.kind === ReflectionKind.literal && (isString(type$1.literal) || 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 ${pascalCase(name)} {
+${type.enum && Object.entries(type.enum).length > 0 ? Object.entries(type.enum).filter(([, value]) => value !== null && value !== void 0).map(([key]) => `    ${camelCase(key)} @${indexCounter()};`).join("\n") : type.values.filter((value) => value !== null && value !== void 0).map((value) => `${enumType === "Text" && value ? camelCase(String(value)) : `${type.typeName ? `${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 === ReflectionKind.never || type.kind === ReflectionKind.void || type.kind === ReflectionKind.null || type.kind === ReflectionKind.undefined || type.kind === ReflectionKind.symbol ? "Void" : type.kind === ReflectionKind.class && type.classType === Date ? "Date" : type.kind === ReflectionKind.class && type.classType === Set ? `List(${type.typeArguments && type.typeArguments[0] ? generateCapnpPrimitive(type.typeArguments[0]) : "Data"})` : type.kind === ReflectionKind.bigint ? "UInt64" : type.kind === ReflectionKind.number ? "Float64" : type.kind === ReflectionKind.string || type.kind === ReflectionKind.regexp ? "Text" : type.kind === ReflectionKind.boolean ? "Bool" : type.kind === ReflectionKind.literal ? isNumber(type.literal) ? "Float64" : isBigInt(type.literal) ? "UInt64" : isString(type.literal) ? "Text" : typeof type.literal === "boolean" ? "Bool" : "Data" : "Data";
+}
+
+//#endregion
+export { generateCapnpId as a, generateCapnpPrimitive as c, getCapnpEnumTypes as d, getCapnpUnionTypes as f, stringifyCapnpValue as g, stringifyCapnpDefaultValue as h, generateCapnpEnumSchema as i, generateCapnpSchema as l, isVoidType as m, compile as n, generateCapnpInterface as o, isCapnpStringUnion as p, generateCapnp as r, generateCapnpMethodSchema as s, LARGE_BUFFER as t, generateCapnpStruct as u };
+//# sourceMappingURL=capnp-CnQcwo0s.mjs.map