@powerlines/plugin-alloy 0.19.13 → 0.19.15

package/dist/capnp-CnQcwo0s.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"capnp-CnQcwo0s.mjs","names":["getUnionTypes","kindToName","getClassName","memberNameToString","ReflectionKind","capnpc","resolveOptions","toArray","getUniqueBy","StormJSON","joinPaths","camelCase","getWords","pascalCase","titleCase","isBigInt","isNull","isNumber","isString","isUndefined","defu","Buffer","exec","promisify","getBaseFileHeader","compile","context","options","opts","ts","js","dts","schemas","artifactsPath","tsconfig","projectRoot","config","workspaceRoot","workspaceConfig","tty","resolvedOptions","Error","join","stringifyCapnpDefaultValue","property","value","stringifyCapnpValue","type","getDefaultValue","kind","string","literal","String","enum","array","stringify","object","objectLiteral","replaceAll","getCapnpEnumTypes","unique","values","filter","enumMember","length","isVoidType","void","never","null","undefined","symbol","getCapnpUnionTypes","isCapnpStringUnion","some","member","LARGE_BUFFER","execAsync","generateCapnpId","stdout","windowsHide","maxBuffer","killSignal","generateCapnp","reflection","capnpId","trim","replace","getMethods","generateCapnpStruct","generateCapnpInterface","structName","name","getTitle","getName","generateCapnpEnums","generateCapnpSchema","interfaceName","formatEnumName","enums","getProperties","prop","isIgnored","union","sort","a","b","isReadonly","getNameAsString","localeCompare","map","enumeration","generateCapnpEnumSchema","index","indexCounter","generateCapnpPropertySchema","methods","generateCapnpMethodSchema","class","classType","Map","Date","methodName","reflectionClass","getParameters","param","generateCapnpPrimitive","getType","hasDefault","getReturnType","getDescription","generateCapnpPropertyComment","result","relaxed","reduce","ret","word","includes","substring","lastIndexOf","current","getSubType","typeArguments","ArrayBuffer","typeName","indexType","types","enumType","Object","entries","key","Set","bigint","number","regexp","boolean"],"sources":["../src/helpers/capnp.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { getUnionTypes, kindToName } from \"@powerlines/deepkit/utilities\";\nimport { getClassName } from \"@powerlines/deepkit/vendor/core\";\nimport {\n  memberNameToString,\n  ReflectionClass,\n  ReflectionKind,\n  ReflectionMethod,\n  ReflectionParameter,\n  ReflectionProperty,\n  Type,\n  TypeEnum,\n  TypeLiteral,\n  TypeUnion\n} from \"@powerlines/deepkit/vendor/type\";\nimport { capnpc } from \"@stryke/capnp/compile\";\nimport { resolveOptions } from \"@stryke/capnp/helpers\";\nimport type { CapnpcOptions, CapnpcResult } from \"@stryke/capnp/types\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { getUniqueBy } from \"@stryke/helpers/get-unique\";\nimport { StormJSON } from \"@stryke/json\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { getWords } from \"@stryke/string-format/get-words\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isBigInt } from \"@stryke/type-checks/is-bigint\";\nimport { isNull } from \"@stryke/type-checks/is-null\";\nimport { isNumber } from \"@stryke/type-checks/is-number\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport { isUndefined } from \"@stryke/type-checks/is-undefined\";\nimport defu from \"defu\";\nimport { Buffer } from \"node:buffer\";\nimport { exec } from \"node:child_process\";\nimport { promisify } from \"node:util\";\nimport { getBaseFileHeader } from \"powerlines/lib/utilities/file-header\";\nimport { Context, PluginContext } from \"powerlines/types/context\";\n\n/**\n * Compiles a Cap'n Proto schema into TypeScript definitions.\n *\n * @param context - The context containing the project and workspace information.\n * @param options - The options for compiling the schema.\n * @returns A promise that resolves to the compiled schema.\n */\nexport async function compile(\n  context: Context,\n  options: Partial<CapnpcOptions> = {}\n): Promise<CapnpcResult> {\n  const opts = defu(options, {\n    ts: true,\n    js: false,\n    dts: false,\n    schemas: joinPaths(context.artifactsPath, \"schemas\"),\n    tsconfig: context.tsconfig,\n    projectRoot: context.config.projectRoot,\n    workspaceRoot: context.workspaceConfig.workspaceRoot,\n    tty: true\n  }) as Parameters<typeof resolveOptions>[0];\n\n  const resolvedOptions = await resolveOptions(opts);\n  if (!resolvedOptions) {\n    throw new Error(\n      `✖ No Cap'n Proto schema files found in the specified source paths: ${toArray(\n        opts.schemas\n      ).join(\", \")}.`\n    );\n  }\n\n  return capnpc(resolvedOptions);\n}\n\n/**\n * Converts any {@link ReflectionProperty} or {@link ReflectionParameter}'s value to string representation.\n *\n * @param property - The {@link ReflectionProperty} or {@link ReflectionParameter} containing the value to stringify.\n * @param value - The value to stringify.\n * @returns A string representation of the value.\n */\nexport function stringifyCapnpDefaultValue(\n  property: ReflectionProperty | ReflectionParameter,\n  value?: any\n): string {\n  return stringifyCapnpValue(\n    property.type,\n    value ?? property.getDefaultValue()\n  );\n}\n\n/**\n * Converts any {@link Type}'s actual value to string representation.\n *\n * @param type - The {@link Type} of the value to stringify.\n * @param value - The value to stringify.\n * @returns A string representation of the value.\n */\nexport function stringifyCapnpValue(type: Type, value: any): string {\n  return type.kind === ReflectionKind.string ||\n    (type.kind === ReflectionKind.literal && isString(type.literal))\n    ? `\"${String(value)}\"`\n    : type.kind === ReflectionKind.enum\n      ? `${camelCase(String(value))}`\n      : type.kind === ReflectionKind.array\n        ? StormJSON.stringify(value)\n        : type.kind === ReflectionKind.object ||\n            type.kind === ReflectionKind.objectLiteral\n          ? StormJSON.stringify(value).replaceAll(\"{\", \"(\").replaceAll(\"}\", \")\")\n          : String(value);\n}\n\n/**\n * Converts a ReflectionProperty's default value to a Cap'n Proto schema string representation.\n *\n * @param type - The TypeEnum to evaluate.\n * @returns A string representation of the property.\n */\nexport function getCapnpEnumTypes(type: Type): \"Text\" | \"Float32\" | null {\n  if (type.kind !== ReflectionKind.enum) {\n    return null;\n  }\n\n  const unique = getUniqueBy(\n    type.values.filter(value => !isUndefined(value) && !isNull(value)),\n    enumMember => (isString(enumMember) ? \"Text\" : \"Float32\")\n  );\n  if (unique.length === 0) {\n    return null;\n  }\n\n  return unique[0] && isString(unique[0]) ? \"Text\" : \"Float32\";\n}\n\n/**\n * Determines if a Type is a `Void` type in a Cap'n Proto schema.\n *\n * @param type - The Type to check.\n * @returns True if the Type is a `Void` type, false otherwise.\n */\nexport function isVoidType(type: Type): boolean {\n  return (\n    type.kind === ReflectionKind.void ||\n    type.kind === ReflectionKind.never ||\n    type.kind === ReflectionKind.null ||\n    type.kind === ReflectionKind.undefined ||\n    type.kind === ReflectionKind.symbol\n  );\n}\n\n/**\n * Converts a {@link TypeUnion} to an array of its underlying Cap'n Proto primitive type representation.\n *\n * @param type - The {@link TypeUnion} to convert.\n * @returns A string representation of the Cap'n Proto primitive type.\n */\nexport function getCapnpUnionTypes(type: Type): Type[] {\n  return getUnionTypes(type);\n}\n\n/**\n * Converts a {@link TypeUnion} to an array of its underlying Cap'n Proto primitive type representation.\n *\n * @param type - The {@link TypeUnion} to convert.\n * @returns An array of Cap'n Proto primitive types.\n */\nexport function isCapnpStringUnion(type: Type): boolean {\n  return getCapnpUnionTypes(type).some(\n    member => member.kind === ReflectionKind.string\n  );\n}\n\nexport const LARGE_BUFFER = 1024 * 1000000;\nexport type IOType = \"overlapped\" | \"pipe\" | \"ignore\" | \"inherit\";\nexport type StdioOptions =\n  | IOType\n  | Array<IOType | \"ipc\" | number | null | undefined>;\n\nconst execAsync = promisify(exec);\n\nexport async function generateCapnpId() {\n  const { stdout } = await execAsync(\"capnp id\", {\n    windowsHide: true,\n    maxBuffer: LARGE_BUFFER,\n    killSignal: \"SIGTERM\"\n  });\n\n  return stdout;\n}\n\nexport interface GenerateCapnpOptions {\n  name?: string;\n}\n\nexport async function generateCapnp(\n  context: PluginContext,\n  reflection: ReflectionClass<any>,\n  options: GenerateCapnpOptions\n) {\n  const capnpId = await generateCapnpId();\n\n  return `${capnpId.trim()};\n${getBaseFileHeader(context)\n  .replace(/^\\r*\\n*/g, \"\")\n  .replaceAll(\"//\", \"#\")}\n${\n  reflection.getMethods().length === 0\n    ? generateCapnpStruct(reflection, options)\n    : generateCapnpInterface(reflection, options)\n}\n`.trim();\n}\n\nexport interface GenerateCapnpStructOptions extends GenerateCapnpOptions {\n  indexCounter?: () => number;\n}\n\nexport function generateCapnpStruct(\n  reflection: ReflectionClass<any>,\n  options: GenerateCapnpStructOptions = {}\n): string {\n  const structName =\n    options?.name ||\n    reflection.getTitle() ||\n    reflection.getClassName() ||\n    reflection.getName();\n\n  return `${generateCapnpEnums(reflection)}struct ${pascalCase(structName)} {\n  # Struct definition for ${titleCase(structName)}.\n\n  ${generateCapnpSchema(reflection, options)}\n}\n`;\n}\n\nexport function generateCapnpInterface(\n  reflection: ReflectionClass<any>,\n  options: GenerateCapnpStructOptions = {}\n): string {\n  const interfaceName =\n    options?.name ||\n    reflection.getTitle() ||\n    reflection.getClassName() ||\n    reflection.getName();\n\n  return `${generateCapnpEnums(reflection)}interface ${pascalCase(interfaceName)} {\n  # Interface definition for ${titleCase(interfaceName)}.\n\n  ${generateCapnpSchema(reflection, options)}\n}\n`;\n}\n\nfunction formatEnumName(name: string) {\n  return pascalCase(`${name}_Type`);\n}\n\nfunction generateCapnpEnums(reflection: ReflectionClass<any>): string {\n  const enums = reflection\n    .getProperties()\n    .filter(\n      prop =>\n        !prop.isIgnored() &&\n        (prop.type.kind === ReflectionKind.enum ||\n          (prop.type.kind === ReflectionKind.union &&\n            getCapnpUnionTypes(prop.type).filter(\n              type =>\n                type.kind === ReflectionKind.literal &&\n                (isString(type.literal) || isNumber(type.literal))\n            ).length === 1))\n    )\n    .sort((a, b) =>\n      (a.isReadonly() && b.isReadonly()) || (!a.isReadonly() && !b.isReadonly())\n        ? b.getNameAsString().localeCompare(a.getNameAsString())\n        : a.isReadonly()\n          ? 1\n          : -1\n    );\n  if (enums.length === 0) {\n    return \"\";\n  }\n\n  return `${enums\n    .map(enumeration =>\n      generateCapnpEnumSchema(\n        enumeration.type as TypeEnum | TypeUnion,\n        formatEnumName(enumeration.getNameAsString())\n      )\n    )\n    .join(\"\\n\\n\")}\n\n`;\n}\n\nexport function generateCapnpSchema(\n  reflection: ReflectionClass<any>,\n  options: GenerateCapnpStructOptions = {}\n): string {\n  let index = 0;\n  const indexCounter: () => number = options?.indexCounter ?? (() => index++);\n\n  return `${reflection\n    .getProperties()\n    .filter(prop => !prop.isIgnored())\n    .sort((a, b) =>\n      (a.isReadonly() && b.isReadonly()) || (!a.isReadonly() && !b.isReadonly())\n        ? b.getNameAsString().localeCompare(a.getNameAsString())\n        : a.isReadonly()\n          ? 1\n          : -1\n    )\n    .map(prop => generateCapnpPropertySchema(prop, indexCounter))\n    .join(\" \\n\\n\\t\")}${reflection\n    .getMethods()\n    .filter(methods => !methods.isIgnored())\n    .sort((a, b) =>\n      (a.isReadonly() && b.isReadonly()) || (!a.isReadonly() && !b.isReadonly())\n        ? String(b.getName()).localeCompare(String(a.getName()))\n        : a.isReadonly()\n          ? 1\n          : -1\n    )\n    .map(methods => generateCapnpMethodSchema(methods, indexCounter))\n    .join(\" \\n\\n\\t\")}${\n    reflection\n      .getProperties()\n      .some(\n        prop =>\n          prop.type.kind === ReflectionKind.class && prop.type.classType === Map\n      )\n      ? `\n  struct Map(Key, Value) {\n    entries @0 :List(Entry);\n\n    struct Entry {\n      key @0 :Key;\n      value @1 :Value;\n    }\n  }`\n      : \"\"\n  }${\n    reflection\n      .getProperties()\n      .some(\n        prop =>\n          prop.type.kind === ReflectionKind.class &&\n          prop.type.classType === Date\n      )\n      ? `\n  struct Date {\n    # A standard Gregorian calendar date.\n\n    year @0 :Int16;\n    # The year - Must include the century.\n    # Negative value indicates BC.\n\n    month @1 :UInt8; # The month, 1-12\n\n    day @2 :UInt8; # The day of the month, 1-30\n\n    hour @3 :UInt8;    # The hour of the day, 0-23\n\n    minute @4 :UInt8;  # The minute of the hour, 0-59\n\n    second @5 :UInt8;  # The second of the minute, 0-59\n\n    millisecond @6 :UInt16; # Milliseconds of the second, 0-999\n  }`\n      : \"\"\n  }`;\n}\n\nexport function generateCapnpMethodSchema(\n  reflection: ReflectionMethod,\n  indexCounter: () => number\n): string {\n  const methodName =\n    reflection.getTitle() || typeof reflection.getName() === \"string\"\n      ? String(reflection.getName())\n      : \"\";\n  if (!methodName) {\n    throw new Error(\n      `Cannot generate Cap'n Proto schema for method without a name - Parent interface: ${reflection.reflectionClass.getName()}`\n    );\n  }\n\n  return `${camelCase(methodName)} @${indexCounter()} (${reflection\n    .getParameters()\n    .map(param => {\n      return `${camelCase(\n        param.getName()\n      )} :${generateCapnpPrimitive(param.getType())}${\n        param.hasDefault() ? ` = ${stringifyCapnpDefaultValue(param)}` : \"\"\n      }`;\n    })\n    .join(\", \")})${\n    isVoidType(reflection.getReturnType())\n      ? \"\"\n      : ` -> (${kindToName(\n          reflection.getReturnType().kind\n        )}: ${generateCapnpPrimitive(reflection.getReturnType())})`\n  }; # ${(\n    reflection.getDescription() ||\n    `The ${titleCase(\n      reflection.reflectionClass.getTitle() ||\n        reflection.reflectionClass.getName()\n    )} interface ${titleCase(methodName)} method.`\n  ).replaceAll(\"\\n\", \". \")}`;\n}\n\nfunction generateCapnpPropertyComment(reflection: ReflectionProperty) {\n  const result = getWords(\n    reflection.getDescription() ||\n      `A schema property for ${titleCase(\n        reflection.getTitle() || reflection.getNameAsString()\n      )} field.`,\n    {\n      relaxed: true\n    }\n  )\n    .reduce((ret, word) => {\n      let length = ret.length;\n      if (ret.includes(\"\\n\")) {\n        length = ret.substring(ret.lastIndexOf(\"\\n\") + 1).length;\n      }\n\n      const current = word.trim();\n      if (length + current.length > 60) {\n        ret += `\\n\\t# ${current}`;\n      } else {\n        ret += ` ${current}`;\n      }\n      return ret;\n    }, \"\")\n    .trim();\n  if (result.length > 0) {\n    return `\\t# ${result}`;\n  }\n\n  return \"\";\n}\n\nfunction generateCapnpPropertySchema(\n  reflection: ReflectionProperty,\n  indexCounter: () => number\n): string {\n  if (reflection.type.kind === ReflectionKind.union) {\n    if (getCapnpUnionTypes(reflection.type).length === 0) {\n      return `${camelCase(reflection.getNameAsString())} @${indexCounter()} :Void;\n${generateCapnpPropertyComment(reflection)}`;\n    } else if (\n      getCapnpUnionTypes(reflection.type).filter(\n        type =>\n          type.kind === ReflectionKind.literal &&\n          (isString(type.literal) || isNumber(type.literal))\n      ).length === 1\n    ) {\n      return `${camelCase(reflection.getNameAsString())} @${indexCounter()} :${formatEnumName(\n        reflection.getNameAsString()\n      )}${\n        reflection.hasDefault()\n          ? ` = ${stringifyCapnpDefaultValue(reflection)}`\n          : \"\"\n      };\n${generateCapnpPropertyComment(reflection)}`;\n    } else {\n      return `${camelCase(reflection.getNameAsString())} :union {\n${getCapnpUnionTypes(reflection.type)\n  .map(\n    type =>\n      `   ${kindToName(type.kind)} @${indexCounter()} :${generateCapnpPrimitive(\n        type\n      )};`\n  )\n  .join(\"\\n\")}\n  }\n${generateCapnpPropertyComment(reflection)}`;\n    }\n  } else if (reflection.type.kind === ReflectionKind.array) {\n    return `${camelCase(reflection.getNameAsString())} @${indexCounter()} :List(${generateCapnpPrimitive(reflection.getSubType())})${\n      reflection.hasDefault()\n        ? ` = ${stringifyCapnpDefaultValue(reflection)}`\n        : \"\"\n    };\n${generateCapnpPropertyComment(reflection)}`;\n  } else if (reflection.type.kind === ReflectionKind.class) {\n    if (reflection.type.classType === Map) {\n      return `${camelCase(reflection.getNameAsString())} @${indexCounter()} :Map(${\n        !reflection.type.typeArguments ||\n        reflection.type.typeArguments.length === 0 ||\n        !reflection.type.typeArguments[0]\n          ? \"Data\"\n          : generateCapnpPrimitive(reflection.type.typeArguments[0])\n      }, ${\n        !reflection.type.typeArguments ||\n        reflection.type.typeArguments.length < 2 ||\n        !reflection.type.typeArguments[1]\n          ? \"Data\"\n          : generateCapnpPrimitive(reflection.type.typeArguments[1])\n      })${\n        reflection.hasDefault()\n          ? ` = ${stringifyCapnpDefaultValue(reflection)}`\n          : \"\"\n      };\n${generateCapnpPropertyComment(reflection)}`;\n    } else if (reflection.type.classType === Date) {\n      return `${camelCase(reflection.getNameAsString())} @${indexCounter()} :Data${\n        reflection.hasDefault()\n          ? ` = ${stringifyCapnpDefaultValue(reflection)}`\n          : \"\"\n      };\n${generateCapnpPropertyComment(reflection)}`;\n    } else if (reflection.type.classType === Buffer) {\n      return `${camelCase(reflection.getNameAsString())} @${indexCounter()} :Data${\n        reflection.hasDefault()\n          ? ` = ${stringifyCapnpDefaultValue(reflection)}`\n          : \"\"\n      };\n${generateCapnpPropertyComment(reflection)}`;\n    } else if (reflection.type.classType === ArrayBuffer) {\n      return `${camelCase(reflection.getNameAsString())} @${indexCounter()} :Data${\n        reflection.hasDefault()\n          ? ` = ${stringifyCapnpDefaultValue(reflection)}`\n          : \"\"\n      };\n${generateCapnpPropertyComment(reflection)}`;\n    } else {\n      return `${camelCase(reflection.getNameAsString())} @${indexCounter()} :${pascalCase(\n        reflection.type.typeName || getClassName(reflection.type.classType)\n      )}${generateCapnpStruct(reflection.reflectionClass, {\n        name: pascalCase(\n          reflection.type.typeName || getClassName(reflection.type.classType)\n        )\n      })}${\n        reflection.hasDefault()\n          ? ` = ${stringifyCapnpDefaultValue(reflection)}`\n          : \"\"\n      };\n${generateCapnpPropertyComment(reflection)}`;\n    }\n  } else if (reflection.type.kind === ReflectionKind.objectLiteral) {\n    return `${camelCase(reflection.getNameAsString())} @${indexCounter()} :${pascalCase(\n      reflection.type.typeName ||\n        memberNameToString(reflection.getNameAsString())\n    )}${generateCapnpStruct(reflection.reflectionClass, {\n      name: pascalCase(\n        reflection.type.typeName ||\n          memberNameToString(reflection.getNameAsString())\n      )\n    })}${\n      reflection.hasDefault()\n        ? ` = ${stringifyCapnpDefaultValue(reflection)}`\n        : \"\"\n    };\n${generateCapnpPropertyComment(reflection)}`;\n  } else if (reflection.type.kind === ReflectionKind.enum) {\n    return `${camelCase(reflection.getNameAsString())} @${indexCounter()} :${pascalCase(\n      reflection.getNameAsString()\n    )}${\n      reflection.hasDefault()\n        ? ` = ${stringifyCapnpDefaultValue(reflection)}`\n        : \"\"\n    };\n${generateCapnpPropertyComment(reflection)}`;\n  }\n\n  return `${camelCase(reflection.getNameAsString())} @${indexCounter()} :${generateCapnpPrimitive(\n    reflection.getType()\n  )}${\n    reflection.hasDefault()\n      ? ` = ${stringifyCapnpDefaultValue(reflection)}`\n      : \"\"\n  };\n${generateCapnpPropertyComment(reflection)}`;\n}\n\nexport function generateCapnpEnumSchema(\n  type: TypeEnum | TypeUnion,\n  name: string\n): string {\n  if (type.kind === ReflectionKind.union) {\n    return generateCapnpEnumSchema(\n      {\n        kind: ReflectionKind.enum,\n        indexType: type,\n        enum: (type.types as TypeLiteral[]).reduce<\n          Record<string, string | number>\n        >((ret, type) => {\n          if (isString(type.literal) || isNumber(type.literal)) {\n            ret[camelCase(String(type.literal))] = type.literal;\n          }\n\n          return ret;\n        }, {}),\n        values: (\n          getCapnpUnionTypes(type).filter(\n            type =>\n              type.kind === ReflectionKind.literal &&\n              (isString(type.literal) || isNumber(type.literal))\n          ) as TypeLiteral[]\n        ).map(type => type.literal as string | number)\n      },\n      name\n    );\n  }\n\n  let index = 0;\n  const indexCounter: () => number = () => index++;\n\n  const enumType = getCapnpEnumTypes(type);\n  if (!enumType) {\n    return \"\";\n  }\n\n  return `enum ${pascalCase(name)} {\n${\n  type.enum && Object.entries(type.enum).length > 0\n    ? Object.entries(type.enum)\n        .filter(([, value]) => value !== null && value !== undefined)\n        .map(([key]) => `    ${camelCase(key)} @${indexCounter()};`)\n        .join(\"\\n\")\n    : type.values\n        .filter(value => value !== null && value !== undefined)\n        .map(\n          value =>\n            `${\n              enumType === \"Text\" && value\n                ? camelCase(String(value))\n                : `${\n                    type.typeName ? `${camelCase(type.typeName)}_` : \"\"\n                  }${value || \"\"}`\n            } @${indexCounter()};`\n        )\n        .join(\"\\n\")\n}\n  }`;\n}\n\n/**\n * Generates a string representation of Cap'n Proto primitive types from a Deepkit Type.\n *\n * @param type - The Deepkit Type to convert.\n * @returns A string representation of the Cap'n Proto primitive type.\n */\nexport function generateCapnpPrimitive(type: Type): string {\n  return type.kind === ReflectionKind.never ||\n    type.kind === ReflectionKind.void ||\n    type.kind === ReflectionKind.null ||\n    type.kind === ReflectionKind.undefined ||\n    type.kind === ReflectionKind.symbol\n    ? \"Void\"\n    : type.kind === ReflectionKind.class && type.classType === Date\n      ? \"Date\"\n      : type.kind === ReflectionKind.class && type.classType === Set\n        ? `List(${\n            type.typeArguments && type.typeArguments[0]\n              ? generateCapnpPrimitive(type.typeArguments[0])\n              : \"Data\"\n          })`\n        : type.kind === ReflectionKind.bigint\n          ? \"UInt64\"\n          : type.kind === ReflectionKind.number\n            ? \"Float64\"\n            : type.kind === ReflectionKind.string ||\n                type.kind === ReflectionKind.regexp\n              ? \"Text\"\n              : type.kind === ReflectionKind.boolean\n                ? \"Bool\"\n                : type.kind === ReflectionKind.literal\n                  ? isNumber(type.literal)\n                    ? \"Float64\"\n                    : isBigInt(type.literal)\n                      ? \"UInt64\"\n                      : isString(type.literal)\n                        ? \"Text\"\n                        : typeof type.literal === \"boolean\"\n                          ? \"Bool\"\n                          : \"Data\"\n                  : \"Data\";\n}\n"],"mappings":""}

package/dist/capnp-YnGBPkLK.d.cts

@@ -0,0 +1,88 @@
+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 { stringifyCapnpDefaultValue as C, isVoidType as S, generateCapnpSchema as _, StdioOptions as a, getCapnpUnionTypes as b, __ΩIOType as c, generateCapnp as d, generateCapnpEnumSchema as f, generateCapnpPrimitive as g, generateCapnpMethodSchema as h, LARGE_BUFFER as i, __ΩStdioOptions as l, generateCapnpInterface as m, GenerateCapnpStructOptions as n, __ΩGenerateCapnpOptions as o, generateCapnpId as p, IOType as r, __ΩGenerateCapnpStructOptions as s, GenerateCapnpOptions as t, compile as u, generateCapnpStruct as v, stringifyCapnpValue as w, isCapnpStringUnion as x, getCapnpEnumTypes as y };
+//# sourceMappingURL=capnp-YnGBPkLK.d.cts.map

package/dist/capnp-YnGBPkLK.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capnp-YnGBPkLK.d.cts","names":[],"sources":["../src/helpers/capnp.ts"],"sourcesContent":[],"mappings":";;;;;;;;AA8DA;;;;;AAGG,iBAHmB,OAAA,CAGnB,OAAA,EAFQ,OAER,EAAA,OAAA,CAAA,EADQ,OACR,CADgB,aAChB,CAAA,CAAA,EAAA,OAAA,CAAQ,YAAR,CAAA;;AA+BH;AAiBA;AAoBA;AAsBA;AAgBA;AAUA;AAMa,iBA3FG,0BAAA,CA2F0B,QAAA,EA1F9B,kBA0F8B,GA1FT,mBA0FS,EAAA,KAAA,CAAA,EAAA,GAAA,CAAA,EAAA,MAAA;AAC1C;AACA;;;;;AAMA;AAUiB,iBA5FD,mBAAA,CA4FqB,IAAA,EA5FK,IA4FL,EAAA,KAAA,EAAA,GAAA,CAAA,EAAA,MAAA;AAIrC;;;;;;AAmBiB,iBA/FD,iBAAA,CA+F4B,IAAQ,EA/FZ,IA+FY,CAAA,EAAA,MAAA,GAAA,SAAoB,GAAA,IAAA;AAIxE;AAkBA;AA2DA;AA8EA;AA4MA;AAoEA;iBAxfgB,UAAA,OAAiB;;;;;;;iBAgBjB,kBAAA,OAAyB,OAAO;;;;;;;iBAUhC,kBAAA,OAAyB;cAM5B;KACD,MAAA;KACA,YAAA,GACR,SACA,MAAM;iBAIY,eAAA,CAAA,GAAe;UAUpB,oBAAA;;;iBAIK,aAAA,UACX,2BACG,+BACH,uBAAoB;UAgBd,0BAAA,SAAmC;;;iBAIpC,mBAAA,aACF,gCACH;iBAgBK,sBAAA,aACF,gCACH;iBAyDK,mBAAA,aACF,gCACH;iBA4EK,yBAAA,aACF;iBA2ME,uBAAA,OACR,WAAW;;;;;;;iBAmEH,sBAAA,OAA6B"}

package/dist/{_virtual/rolldown_runtime.cjs → chunk-CbDLau6x.cjs}

@@ -26,4 +26,9 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 
 //#endregion
 
-exports.__toESM = __toESM;
+Object.defineProperty(exports, '__toESM', {
+  enumerable: true,
+  get: function () {
+    return __toESM;
+  }
+});

package/dist/components-C_Rnle_h.mjs

@@ -0,0 +1 @@
+export {  };

package/dist/components-CpjG2zC9.mjs

@@ -0,0 +1 @@
+export {  };

package/dist/components-CrWk5KiP.mjs

@@ -0,0 +1 @@
+export {  };

package/dist/components-CyQi7RHT.mjs

@@ -0,0 +1 @@
+export {  };

package/dist/components-IRVnipN0.d.cts

@@ -0,0 +1,143 @@
+import { Children, Context } from "@alloy-js/core";
+import { StoragePreset } from "powerlines/types/fs";
+import { SourceFileContext } from "@alloy-js/typescript";
+import { ResolvedEntryTypeDefinition } from "powerlines/types/resolved";
+
+//#region src/types/components.d.ts
+interface CopyOutputFile {
+  kind: "file";
+  path: string;
+  sourcePath: string;
+  /**
+   * The format of the output files
+   *
+   * @remarks
+   * If not specified, the output mode will be determined by the provided \`output.mode\` value.
+   */
+  preset?: StoragePreset;
+}
+interface WriteOutputFile {
+  kind: "file" | "entry" | "builtin";
+  path: string;
+  contents: string;
+  filetype: string;
+  /**
+   * The format of the output files
+   *
+   * @remarks
+   * If not specified, the output mode will be determined by the provided \`output.mode\` value.
+   */
+  preset?: StoragePreset;
+}
+type OutputFile = (WriteOutputFile & {
+  kind: "file";
+}) | (WriteOutputFile & {
+  kind: "entry";
+  typeDefinition?: ResolvedEntryTypeDefinition;
+}) | (WriteOutputFile & {
+  kind: "builtin";
+  id: string;
+}) | CopyOutputFile;
+interface OutputDirectory {
+  kind: "directory";
+  path: string;
+  contents: (OutputDirectory | OutputFile)[];
+}
+interface RenderEntryContext {
+  typeDefinition: ResolvedEntryTypeDefinition;
+}
+interface RenderBuiltinContext {
+  id: string;
+}
+interface RenderOutputContext {
+  mode?: StoragePreset;
+}
+interface CopyFileOutputContext {
+  path?: string;
+  sourcePath?: string;
+}
+interface RenderContext extends Context {
+  meta?: {
+    copyFile?: CopyFileOutputContext;
+    /**
+     * The current context for the built-in module.
+     */
+    builtin?: RenderBuiltinContext;
+    /**
+     * The current context for the application entrypoint file being rendered.
+     */
+    entry?: RenderEntryContext;
+    /**
+     * The current context for output rendering.
+     */
+    output?: RenderOutputContext;
+  } & Record<string, any>;
+}
+/**
+ * A type that represents the props of a component that can have children.
+ */
+interface ComponentProps {
+  children?: Children;
+}
+/**
+ * A type that requires the `children` prop in a component.
+ */
+type ComponentPropsWithChildren = Omit<ComponentProps, "children"> & Required<Pick<ComponentProps, "children">>;
+interface BuiltinSourceFileContext extends SourceFileContext {
+  /**
+   * The runtime module identifier.
+   */
+  id: string;
+}
+interface ReflectionOverrideInterface<T> {
+  name?: string | Children;
+  type?: string | Children;
+  extends?: string | false;
+  defaultValue?: Partial<T>;
+}
+interface TypescriptFileImportItem {
+  name: string;
+  default?: boolean;
+  alias?: string;
+  type?: boolean;
+}
+type TypescriptFileImports = Record<string, null | string | Array<TypescriptFileImportItem | string>>;
+interface SourceFileHeaderProps extends ComponentProps {
+  /**
+   * If true, disables the ESLint directive at the top of the file.
+   *
+   * @defaultValue true
+   */
+  disableEslint?: boolean;
+  /**
+   * If true, disables the Biome directive at the top of the file.
+   *
+   * @defaultValue true
+   */
+  disableBiome?: boolean;
+  /**
+   * If true, disables the Prettier directive at the top of the file.
+   *
+   * @defaultValue false
+   */
+  disablePrettier?: boolean;
+}
+declare type __ΩCopyOutputFile = any[];
+declare type __ΩWriteOutputFile = any[];
+declare type __ΩOutputFile = any[];
+declare type __ΩOutputDirectory = any[];
+declare type __ΩRenderEntryContext = any[];
+declare type __ΩRenderBuiltinContext = any[];
+declare type __ΩRenderOutputContext = any[];
+declare type __ΩCopyFileOutputContext = any[];
+declare type __ΩRenderContext = any[];
+declare type __ΩComponentProps = any[];
+declare type __ΩComponentPropsWithChildren = any[];
+declare type __ΩBuiltinSourceFileContext = any[];
+declare type __ΩReflectionOverrideInterface = any[];
+declare type __ΩTypescriptFileImportItem = any[];
+declare type __ΩTypescriptFileImports = any[];
+declare type __ΩSourceFileHeaderProps = any[];
+//#endregion
+export { __ΩTypescriptFileImportItem as A, __ΩOutputFile as C, __ΩRenderEntryContext as D, __ΩRenderContext as E, __ΩWriteOutputFile as M, __ΩRenderOutputContext as O, __ΩOutputDirectory as S, __ΩRenderBuiltinContext as T, __ΩBuiltinSourceFileContext as _, CopyOutputFile as a, __ΩCopyFileOutputContext as b, ReflectionOverrideInterface as c, RenderEntryContext as d, RenderOutputContext as f, WriteOutputFile as g, TypescriptFileImports as h, CopyFileOutputContext as i, __ΩTypescriptFileImports as j, __ΩSourceFileHeaderProps as k, RenderBuiltinContext as l, TypescriptFileImportItem as m, ComponentProps as n, OutputDirectory as o, SourceFileHeaderProps as p, ComponentPropsWithChildren as r, OutputFile as s, BuiltinSourceFileContext as t, RenderContext as u, __ΩComponentProps as v, __ΩReflectionOverrideInterface as w, __ΩCopyOutputFile as x, __ΩComponentPropsWithChildren as y };
+//# sourceMappingURL=components-IRVnipN0.d.cts.map

package/dist/components-IRVnipN0.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components-IRVnipN0.d.cts","names":[],"sources":["../src/types/components.ts"],"sourcesContent":[],"mappings":";;;;;;UAuBiB,cAAA;;EAAA,IAAA,EAAA,MAAA;EAcA,UAAA,EAAA,MAAe;EAepB;;;;;;EAOM,MAAA,CAAA,EAzBP,aAyBO;AAElB;AAMiB,UA9BA,eAAA,CA8BkB;EAIlB,IAAA,EAAA,MAAA,GAAA,OAAA,GAAoB,SAAA;EAIpB,IAAA,EAAA,MAAA;EAIA,QAAA,EAAA,MAAA;EAKA,QAAA,EAAA,MAAc;EAEhB;;;;;;EAF+B,MAAA,CAAA,EAnCnC,aAmCmC;AAwB9C;AAOY,KA/DA,UAAA,GA+DA,CA9DP,eA8DiC,GAAA;EAAQ,IAAA,EAAA,MAAA;CAAL,CAAA,GAAA,CA7DpC,eA6DoC,GAAA;EACzB,IAAA,EAAA,OAAA;EAAL,cAAA,CAAA,EA5DY,2BA4DZ;CAAT,CAAA,GAAA,CA1DG,eA0DH,GAAA;EAAQ,IAAA,EAAA,SAAA;EAEO,EAAA,EAAA,MAAA;AAOjB,CAAA,CAAA,GAlEI,cAkEa;AACC,UAjED,eAAA,CAiEC;EACA,IAAA,EAAA,WAAA;EAEO,IAAA,EAAA,MAAA;EAAR,QAAA,EAAA,CAjEJ,eAiEI,GAjEc,UAiEd,CAAA,EAAA;;AAGA,UAjEA,kBAAA,CAiEwB;EAO7B,cAAA,EAvEM,2BAuEe;;AAEf,UAtED,oBAAA,CAsEC;EAFkB,EAAA,EAAA,MAAA;;AAKnB,UArEA,mBAAA,CAqEsB;SApE9B;;UAGQ,qBAAA;;;;UAKA,aAAA,SAAsB;;eAExB;;;;cAKD;;;;YAKF;;;;aAKC;MACP;;;;;UAMW,cAAA;aACJ;;;;;KAMD,0BAAA,GAA6B,KAAK,8BAC5C,SAAS,KAAK;UAEC,wBAAA,SAAiC;;;;;;UAOjC;kBACC;kBACA;;iBAED,QAAQ;;UAGR,wBAAA;;;;;;KAOL,qBAAA,GAAwB,+BAElB,MAAM;UAGP,qBAAA,SAA8B"}

package/dist/components-oHSM7vmp.d.mts

@@ -0,0 +1,143 @@
+import { Children, Context } from "@alloy-js/core";
+import { SourceFileContext as SourceFileContext$1 } from "@alloy-js/typescript";
+import { StoragePreset } from "powerlines/types/fs";
+import { ResolvedEntryTypeDefinition } from "powerlines/types/resolved";
+
+//#region src/types/components.d.ts
+interface CopyOutputFile {
+  kind: "file";
+  path: string;
+  sourcePath: string;
+  /**
+   * The format of the output files
+   *
+   * @remarks
+   * If not specified, the output mode will be determined by the provided \`output.mode\` value.
+   */
+  preset?: StoragePreset;
+}
+interface WriteOutputFile {
+  kind: "file" | "entry" | "builtin";
+  path: string;
+  contents: string;
+  filetype: string;
+  /**
+   * The format of the output files
+   *
+   * @remarks
+   * If not specified, the output mode will be determined by the provided \`output.mode\` value.
+   */
+  preset?: StoragePreset;
+}
+type OutputFile = (WriteOutputFile & {
+  kind: "file";
+}) | (WriteOutputFile & {
+  kind: "entry";
+  typeDefinition?: ResolvedEntryTypeDefinition;
+}) | (WriteOutputFile & {
+  kind: "builtin";
+  id: string;
+}) | CopyOutputFile;
+interface OutputDirectory {
+  kind: "directory";
+  path: string;
+  contents: (OutputDirectory | OutputFile)[];
+}
+interface RenderEntryContext {
+  typeDefinition: ResolvedEntryTypeDefinition;
+}
+interface RenderBuiltinContext {
+  id: string;
+}
+interface RenderOutputContext {
+  mode?: StoragePreset;
+}
+interface CopyFileOutputContext {
+  path?: string;
+  sourcePath?: string;
+}
+interface RenderContext extends Context {
+  meta?: {
+    copyFile?: CopyFileOutputContext;
+    /**
+     * The current context for the built-in module.
+     */
+    builtin?: RenderBuiltinContext;
+    /**
+     * The current context for the application entrypoint file being rendered.
+     */
+    entry?: RenderEntryContext;
+    /**
+     * The current context for output rendering.
+     */
+    output?: RenderOutputContext;
+  } & Record<string, any>;
+}
+/**
+ * A type that represents the props of a component that can have children.
+ */
+interface ComponentProps {
+  children?: Children;
+}
+/**
+ * A type that requires the `children` prop in a component.
+ */
+type ComponentPropsWithChildren = Omit<ComponentProps, "children"> & Required<Pick<ComponentProps, "children">>;
+interface BuiltinSourceFileContext extends SourceFileContext$1 {
+  /**
+   * The runtime module identifier.
+   */
+  id: string;
+}
+interface ReflectionOverrideInterface<T> {
+  name?: string | Children;
+  type?: string | Children;
+  extends?: string | false;
+  defaultValue?: Partial<T>;
+}
+interface TypescriptFileImportItem {
+  name: string;
+  default?: boolean;
+  alias?: string;
+  type?: boolean;
+}
+type TypescriptFileImports = Record<string, null | string | Array<TypescriptFileImportItem | string>>;
+interface SourceFileHeaderProps extends ComponentProps {
+  /**
+   * If true, disables the ESLint directive at the top of the file.
+   *
+   * @defaultValue true
+   */
+  disableEslint?: boolean;
+  /**
+   * If true, disables the Biome directive at the top of the file.
+   *
+   * @defaultValue true
+   */
+  disableBiome?: boolean;
+  /**
+   * If true, disables the Prettier directive at the top of the file.
+   *
+   * @defaultValue false
+   */
+  disablePrettier?: boolean;
+}
+declare type __ΩCopyOutputFile = any[];
+declare type __ΩWriteOutputFile = any[];
+declare type __ΩOutputFile = any[];
+declare type __ΩOutputDirectory = any[];
+declare type __ΩRenderEntryContext = any[];
+declare type __ΩRenderBuiltinContext = any[];
+declare type __ΩRenderOutputContext = any[];
+declare type __ΩCopyFileOutputContext = any[];
+declare type __ΩRenderContext = any[];
+declare type __ΩComponentProps = any[];
+declare type __ΩComponentPropsWithChildren = any[];
+declare type __ΩBuiltinSourceFileContext = any[];
+declare type __ΩReflectionOverrideInterface = any[];
+declare type __ΩTypescriptFileImportItem = any[];
+declare type __ΩTypescriptFileImports = any[];
+declare type __ΩSourceFileHeaderProps = any[];
+//#endregion
+export { __ΩTypescriptFileImportItem as A, __ΩOutputFile as C, __ΩRenderEntryContext as D, __ΩRenderContext as E, __ΩWriteOutputFile as M, __ΩRenderOutputContext as O, __ΩOutputDirectory as S, __ΩRenderBuiltinContext as T, __ΩBuiltinSourceFileContext as _, CopyOutputFile as a, __ΩCopyFileOutputContext as b, ReflectionOverrideInterface as c, RenderEntryContext as d, RenderOutputContext as f, WriteOutputFile as g, TypescriptFileImports as h, CopyFileOutputContext as i, __ΩTypescriptFileImports as j, __ΩSourceFileHeaderProps as k, RenderBuiltinContext as l, TypescriptFileImportItem as m, ComponentProps as n, OutputDirectory as o, SourceFileHeaderProps as p, ComponentPropsWithChildren as r, OutputFile as s, BuiltinSourceFileContext as t, RenderContext as u, __ΩComponentProps as v, __ΩReflectionOverrideInterface as w, __ΩCopyOutputFile as x, __ΩComponentPropsWithChildren as y };
+//# sourceMappingURL=components-oHSM7vmp.d.mts.map

package/dist/components-oHSM7vmp.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components-oHSM7vmp.d.mts","names":[],"sources":["../src/types/components.ts"],"sourcesContent":[],"mappings":";;;;;;UAuBiB,cAAA;;EAAA,IAAA,EAAA,MAAA;EAcA,UAAA,EAAA,MAAe;EAepB;;;;;;EAOM,MAAA,CAAA,EAzBP,aAyBO;AAElB;AAMiB,UA9BA,eAAA,CA8BkB;EAIlB,IAAA,EAAA,MAAA,GAAA,OAAA,GAAoB,SAAA;EAIpB,IAAA,EAAA,MAAA;EAIA,QAAA,EAAA,MAAA;EAKA,QAAA,EAAA,MAAc;EAEhB;;;;;;EAF+B,MAAA,CAAA,EAnCnC,aAmCmC;AAwB9C;AAOY,KA/DA,UAAA,GA+DA,CA9DP,eA8DiC,GAAA;EAAQ,IAAA,EAAA,MAAA;CAAL,CAAA,GAAA,CA7DpC,eA6DoC,GAAA;EACzB,IAAA,EAAA,OAAA;EAAL,cAAA,CAAA,EA5DY,2BA4DZ;CAAT,CAAA,GAAA,CA1DG,eA0DH,GAAA;EAAQ,IAAA,EAAA,SAAA;EAEO,EAAA,EAAA,MAAA;AAOjB,CAAA,CAAA,GAlEI,cAkEa;AACC,UAjED,eAAA,CAiEC;EACA,IAAA,EAAA,WAAA;EAEO,IAAA,EAAA,MAAA;EAAR,QAAA,EAAA,CAjEJ,eAiEI,GAjEc,UAiEd,CAAA,EAAA;;AAGA,UAjEA,kBAAA,CAiEwB;EAO7B,cAAA,EAvEM,2BAuEe;;AAEf,UAtED,oBAAA,CAsEC;EAFkB,EAAA,EAAA,MAAA;;AAKnB,UArEA,mBAAA,CAqEsB;SApE9B;;UAGQ,qBAAA;;;;UAKA,aAAA,SAAsB;;eAExB;;;;cAKD;;;;YAKF;;;;aAKC;MACP;;;;;UAMW,cAAA;aACJ;;;;;KAMD,0BAAA,GAA6B,KAAK,8BAC5C,SAAS,KAAK;UAEC,wBAAA,SAAiC;;;;;;UAOjC;kBACC;kBACA;;iBAED,QAAQ;;UAGR,wBAAA;;;;;;KAOL,qBAAA,GAAwB,+BAElB,MAAM;UAGP,qBAAA,SAA8B"}

package/dist/context--KBspFnw.cjs

@@ -0,0 +1,79 @@
+const require_unctx = require('./unctx-r7Vvh6XR.cjs');
+
+//#region src/core/contexts/context.ts
+/**
+* Hook to access the Powerlines Context.
+*
+* @returns The Context.
+*/
+function usePowerlinesContext() {
+	return require_unctx.unctx.tryUse();
+}
+/**
+* Hook to safely access the {@link PluginContext | Powerlines context}.
+*
+* @returns The Powerlines context or null if not set.
+*/
+function usePowerlinesSafe() {
+	return usePowerlinesContext()?.value ?? null;
+}
+/**
+* Hook to access the {@link PluginContext | Powerlines context}.
+*
+* @returns The Powerlines context.
+*/
+function usePowerlines() {
+	const powerlines = usePowerlinesSafe();
+	if (!powerlines) throw new Error("Powerlines - Context is not set. Please make sure the Alloy components are being provided to an invocation of the `render` function added to plugins by `@powerlines/plugin-alloy`.");
+	return powerlines;
+}
+/**
+* Hook to safely access the render context's metadata.
+*
+* @returns The Powerlines context or null if not set.
+*/
+function useMetaSafe() {
+	return usePowerlinesContext()?.meta ?? null;
+}
+/**
+* Hook to access the render context's metadata.
+*
+* @returns The Powerlines context.
+*/
+function useMeta() {
+	const meta = useMetaSafe();
+	if (!meta) throw new Error("Powerlines metadata is not available in the rendering context. Please make sure the Alloy components are being provided to an invocation of the `render` function added to plugins by `@powerlines/plugin-alloy`.");
+	return meta;
+}
+
+//#endregion
+Object.defineProperty(exports, 'useMeta', {
+  enumerable: true,
+  get: function () {
+    return useMeta;
+  }
+});
+Object.defineProperty(exports, 'useMetaSafe', {
+  enumerable: true,
+  get: function () {
+    return useMetaSafe;
+  }
+});
+Object.defineProperty(exports, 'usePowerlines', {
+  enumerable: true,
+  get: function () {
+    return usePowerlines;
+  }
+});
+Object.defineProperty(exports, 'usePowerlinesContext', {
+  enumerable: true,
+  get: function () {
+    return usePowerlinesContext;
+  }
+});
+Object.defineProperty(exports, 'usePowerlinesSafe', {
+  enumerable: true,
+  get: function () {
+    return usePowerlinesSafe;
+  }
+});

package/dist/context-Du_bVzRZ.d.mts

@@ -0,0 +1,67 @@
+import { PluginContext } from "powerlines/types/context";
+import { StoragePreset } from "powerlines/types/fs";
+
+//#region src/core/contexts/context.d.ts
+interface MetaItem {
+  /**
+   * The kind of metadata item.
+   */
+  kind?: "builtin" | "entry" | string;
+  /**
+   * Whether to skip formatting for this output.
+   */
+  skipFormat?: boolean;
+  /**
+   * The storage preset or adapter name for the output files.
+   *
+   * @remarks
+   * If not specified, the output mode will be determined by the provided `output.mode` value.
+   */
+  storage?: StoragePreset | string;
+  [key: string]: any;
+}
+interface PowerlinesContextInterface<TContext extends PluginContext = PluginContext, TMeta extends Record<string, MetaItem> = Record<string, MetaItem>> {
+  /**
+   * The current Powerlines context.
+   */
+  value: TContext;
+  /**
+   * The current render metadata.
+   */
+  meta: TMeta;
+}
+/**
+ * Hook to access the Powerlines Context.
+ *
+ * @returns The Context.
+ */
+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 null if not set.
+ */
+declare function usePowerlinesSafe<TContext extends PluginContext = PluginContext>(): TContext | null;
+/**
+ * Hook to access the {@link PluginContext | Powerlines context}.
+ *
+ * @returns The Powerlines context.
+ */
+declare function usePowerlines<TContext extends PluginContext = PluginContext>(): TContext;
+/**
+ * Hook to safely access the render context's metadata.
+ *
+ * @returns The Powerlines context or null if not set.
+ */
+declare function useMetaSafe<TMeta extends Record<string, MetaItem> = Record<string, MetaItem>>(): TMeta | null;
+/**
+ * Hook to access the render context's metadata.
+ *
+ * @returns The Powerlines context.
+ */
+declare function useMeta<TMeta extends Record<string, MetaItem> = Record<string, MetaItem>>(): TMeta;
+declare type __ΩMetaItem = any[];
+declare type __ΩPowerlinesContextInterface = any[];
+//#endregion
+export { useMeta as a, usePowerlinesContext as c, __ΩPowerlinesContextInterface as i, usePowerlinesSafe as l, PowerlinesContextInterface as n, useMetaSafe as o, __ΩMetaItem as r, usePowerlines as s, MetaItem as t };
+//# sourceMappingURL=context-Du_bVzRZ.d.mts.map

package/dist/context-Du_bVzRZ.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-Du_bVzRZ.d.mts","names":[],"sources":["../src/core/contexts/context.ts"],"sourcesContent":[],"mappings":";;;;UAsBiB,QAAA;;AAAjB;AAsBA;EACmB,IAAA,CAAA,EAAA,SAAA,GAAA,OAAA,GAAA,MAAA;EAAgB;;;EACuB,UAAA,CAAA,EAAA,OAAA;EAAf;;;;AAkB3C;;EACmC,OAAA,CAAA,EA1BvB,aA0BuB,GAAA,MAAA;EACJ,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,GAAA;;AAA2B,UAtBzC,0BAsByC,CAAA,iBArBvC,aAqBuC,GArBvB,aAqBuB,EAAA,cApB1C,MAoB0C,CAAA,MAAA,EApB3B,QAoB2B,CAAA,GApBf,MAoBe,CAAA,MAAA,EApBA,QAoBA,CAAA,CAAA,CAAA;EAAf;;;EACtC,KAAA,EAhBI,QAgBJ;EAA0B;AAS/B;;EACmC,IAAA,EArB3B,KAqB2B;;;AAYnC;;;;AAEa,iBA3BG,oBA2BH,CAAA,iBA1BM,aA0BN,GA1BsB,aA0BtB,EAAA,cAzBG,MAyBH,CAAA,MAAA,EAzBkB,QAyBlB,CAAA,GAzB8B,MAyB9B,CAAA,MAAA,EAzB6C,QAyB7C,CAAA,CAAA,CAAA,CAAA,EAxBR,0BAwBQ,CAxBmB,QAwBnB,EAxB6B,KAwB7B,CAAA,GAAA,IAAA;AAgBb;;;;;AAEK,iBAjCW,iBAiCX,CAAA,iBAhCc,aAgCd,GAhC8B,aAgC9B,CAAA,CAAA,CAAA,EA/BA,QA+BA,GAAA,IAAA;;AAWL;;;;AAC2C,iBAhC3B,aAgC2B,CAAA,iBA/BxB,aA+BwB,GA/BR,aA+BQ,CAAA,CAAA,CAAA,EA9BtC,QA8BsC;;;;;;iBAd3B,0BACA,eAAe,YAAY,eAAe,cACrD;;;;;;iBAWW,sBACA,eAAe,YAAY,eAAe,cACrD"}