@powerlines/plugin-alloy 0.18.118 → 0.18.119

package/dist/core/components/index.cjs

@@ -1,7 +1,7 @@
-const require_output = require('./output.cjs');
-const require_single_line_comment = require('./single-line-comment.cjs');
-const require_source_file = require('./source-file.cjs');
+const require_core_components_output = require('./output.cjs');
+const require_core_components_single_line_comment = require('./single-line-comment.cjs');
+const require_core_components_source_file = require('./source-file.cjs');
 
-exports.Output = require_output.Output;
-exports.SingleLineComment = require_single_line_comment.SingleLineComment;
-exports.SourceFile = require_source_file.SourceFile;
+exports.Output = require_core_components_output.Output;
+exports.SingleLineComment = require_core_components_single_line_comment.SingleLineComment;
+exports.SourceFile = require_core_components_source_file.SourceFile;

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

@@ -1,10 +1,10 @@
 import { MetaItem } from "../contexts/context.cjs";
-import * as _alloy_js_core0 from "@alloy-js/core";
-import { OutputProps } from "@alloy-js/core";
+import * as _alloy_js_core7 from "@alloy-js/core";
+import { OutputProps as OutputProps$1 } from "@alloy-js/core";
 import { PluginContext } from "powerlines/types/context";
 
 //#region src/core/components/output.d.ts
-interface OutputProps$1<TContext extends PluginContext = PluginContext, TMeta extends Record<string, MetaItem> = Record<string, MetaItem>> extends OutputProps {
+interface OutputProps<TContext extends PluginContext = PluginContext, TMeta extends Record<string, MetaItem> = Record<string, MetaItem>> extends OutputProps$1 {
   /**
    * The current Powerlines process 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<TContext extends PluginContext = PluginContext, TMeta extends Record<string, MetaItem> = Record<string, MetaItem>>(props: OutputProps$1<TContext, TMeta>): _alloy_js_core0.Children;
+declare function Output<TContext extends PluginContext = PluginContext, TMeta extends Record<string, MetaItem> = Record<string, MetaItem>>(props: OutputProps<TContext, TMeta>): _alloy_js_core7.Children;
 declare type __ΩOutputProps = any[];
 //#endregion
-export { Output, OutputProps$1 as OutputProps, __ΩOutputProps };
+export { Output, OutputProps, __ΩOutputProps };

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

@@ -1,10 +1,10 @@
 import { MetaItem } from "../contexts/context.mjs";
 import * as _alloy_js_core1 from "@alloy-js/core";
-import { OutputProps } from "@alloy-js/core";
+import { OutputProps as OutputProps$1 } from "@alloy-js/core";
 import { PluginContext } from "powerlines/types/context";
 
 //#region src/core/components/output.d.ts
-interface OutputProps$1<TContext extends PluginContext = PluginContext, TMeta extends Record<string, MetaItem> = Record<string, MetaItem>> extends OutputProps {
+interface OutputProps<TContext extends PluginContext = PluginContext, TMeta extends Record<string, MetaItem> = Record<string, MetaItem>> extends OutputProps$1 {
   /**
    * The current Powerlines process 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<TContext extends PluginContext = PluginContext, TMeta extends Record<string, MetaItem> = Record<string, MetaItem>>(props: OutputProps<TContext, TMeta>): _alloy_js_core1.Children;
 declare type __ΩOutputProps = any[];
 //#endregion
-export { Output$1 as Output, OutputProps$1 as OutputProps, __ΩOutputProps };
+export { Output, OutputProps, __ΩOutputProps };

package/dist/core/components/output.mjs

@@ -1,19 +1,19 @@
 import { createComponent, mergeProps } from "@alloy-js/core/jsx-runtime";
-import { Output, Show, computed, splitProps } from "@alloy-js/core";
+import { Output as Output$1, Show, computed, splitProps } from "@alloy-js/core";
 import { replacePath } from "@stryke/path/replace";
 
 //#region src/core/components/output.tsx
 /**
 * Output component for rendering the Powerlines plugin's output files via templates.
 */
-function Output$1(props) {
+function Output(props) {
 	const [{ children, context, basePath }, rest] = splitProps(props, [
 		"children",
 		"context",
 		"basePath"
 	]);
 	const basePathRef = computed(() => basePath ? replacePath(basePath, context.workspaceConfig.workspaceRoot) : context.workspaceConfig.workspaceRoot);
-	return createComponent(Output, mergeProps(rest, {
+	return createComponent(Output$1, mergeProps(rest, {
 		get basePath() {
 			return basePathRef.value;
 		},
@@ -29,4 +29,4 @@ function Output$1(props) {
 }
 
 //#endregion
-export { Output$1 as Output };
+export { Output };

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

@@ -1,5 +1,5 @@
 import { ComponentProps } from "../../types/components.cjs";
-import * as _alloy_js_core1 from "@alloy-js/core";
+import * as _alloy_js_core8 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_core1.Children;
+declare function SingleLineComment(props: SingleLineCommentProps): _alloy_js_core8.Children;
 declare type __ΩSingleLineCommentVariant = any[];
 declare type __ΩSingleLineCommentProps = any[];
 //#endregion

package/dist/core/components/source-file.d.cts

@@ -1,10 +1,10 @@
 import { ComponentProps } from "../../types/components.cjs";
-import * as _alloy_js_core0 from "@alloy-js/core";
-import { SourceFileProps } from "@alloy-js/core";
+import * as _alloy_js_core4 from "@alloy-js/core";
+import { SourceFileProps as SourceFileProps$1 } from "@alloy-js/core";
 import { StoragePreset } from "powerlines/types/fs";
 
 //#region src/core/components/source-file.d.ts
-type SourceFileProps$1 = SourceFileProps & ComponentProps & {
+type SourceFileProps = SourceFileProps$1 & ComponentProps & {
   /**
    * The storage preset for the output files.
    *
@@ -26,7 +26,7 @@ type SourceFileProps$1 = SourceFileProps & ComponentProps & {
  * @param props - The properties for the source file.
  * @returns The rendered source file component.
  */
-declare function SourceFile(props: SourceFileProps$1): _alloy_js_core0.Children;
+declare function SourceFile(props: SourceFileProps): _alloy_js_core4.Children;
 declare type __ΩSourceFileProps = any[];
 //#endregion
-export { SourceFile, SourceFileProps$1 as SourceFileProps, __ΩSourceFileProps };
+export { SourceFile, SourceFileProps, __ΩSourceFileProps };

package/dist/core/components/source-file.d.mts

@@ -1,10 +1,10 @@
 import { ComponentProps } from "../../types/components.mjs";
 import * as _alloy_js_core0 from "@alloy-js/core";
-import { SourceFileProps } from "@alloy-js/core";
+import { SourceFileProps as SourceFileProps$1 } from "@alloy-js/core";
 import { StoragePreset } from "powerlines/types/fs";
 
 //#region src/core/components/source-file.d.ts
-type SourceFileProps$1 = SourceFileProps & ComponentProps & {
+type SourceFileProps = SourceFileProps$1 & ComponentProps & {
   /**
    * The storage preset for the output files.
    *
@@ -26,7 +26,7 @@ type SourceFileProps$1 = SourceFileProps & ComponentProps & {
  * @param props - The properties for the source file.
  * @returns The rendered source file component.
  */
-declare function SourceFile(props: SourceFileProps$1): _alloy_js_core0.Children;
+declare function SourceFile(props: SourceFileProps): _alloy_js_core0.Children;
 declare type __ΩSourceFileProps = any[];
 //#endregion
-export { SourceFile, SourceFileProps$1 as SourceFileProps, __ΩSourceFileProps };
+export { SourceFile, SourceFileProps, __ΩSourceFileProps };

package/dist/core/index.cjs

@@ -1,18 +1,18 @@
-const require_output = require('./components/output.cjs');
-const require_single_line_comment = require('./components/single-line-comment.cjs');
+const require_core_components_output = require('./components/output.cjs');
+const require_core_components_single_line_comment = require('./components/single-line-comment.cjs');
 const require_core_contexts_context = require('./contexts/context.cjs');
 const require_core_contexts_reflection = require('./contexts/reflection.cjs');
 require('./contexts/index.cjs');
-const require_source_file = require('./components/source-file.cjs');
+const require_core_components_source_file = require('./components/source-file.cjs');
 require('./components/index.cjs');
 
-exports.Output = require_output.Output;
+exports.Output = require_core_components_output.Output;
 exports.ReflectionClassContext = require_core_contexts_reflection.ReflectionClassContext;
 exports.ReflectionMethodContext = require_core_contexts_reflection.ReflectionMethodContext;
 exports.ReflectionParameterContext = require_core_contexts_reflection.ReflectionParameterContext;
 exports.ReflectionPropertyContext = require_core_contexts_reflection.ReflectionPropertyContext;
-exports.SingleLineComment = require_single_line_comment.SingleLineComment;
-exports.SourceFile = require_source_file.SourceFile;
+exports.SingleLineComment = require_core_components_single_line_comment.SingleLineComment;
+exports.SourceFile = require_core_components_source_file.SourceFile;
 exports.useMeta = require_core_contexts_context.useMeta;
 exports.useMetaSafe = require_core_contexts_context.useMetaSafe;
 exports.usePowerlines = require_core_contexts_context.usePowerlines;

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 };