@varavel/vdl-plugin-sdk 0.0.0 → 0.1.0

package/README.md

@@ -0,0 +1,120 @@
+<p align="center">
+  <img
+    src="https://raw.githubusercontent.com/varavelio/vdl/9cb8432f972f986ba91ffa1e4fe82220a8aa373f/assets/png/vdl.png"
+    alt="VDL logo"
+    width="130"
+  />
+</p>
+
+<h1 align="center">VDL Plugin SDK</h1>
+
+<p align="center">
+  Build VDL plugins in TypeScript with typed IR models, utility helpers, and a simple CLI for checking and bundling plugin packages.
+</p>
+
+<p align="center">
+  <a href="https://github.com/varavelio/vdl-plugin-sdk/actions">
+    <img src="https://github.com/varavelio/vdl-plugin-sdk/actions/workflows/ci.yaml/badge.svg" alt="CI status"/>
+  </a>
+  <a href="https://github.com/varavelio/vdl-plugin-sdk/releases/latest">
+    <img src="https://img.shields.io/github/release/varavelio/vdl-plugin-sdk.svg" alt="Release Version"/>
+  </a>
+  <a href="https://www.npmjs.com/package/@varavel/vdl-plugin-sdk">
+    <img src="https://img.shields.io/npm/v/%40varavel%2Fvdl-plugin-sdk" alt="NPM Version"/>
+  </a>
+  <a href="https://github.com/varavelio/vdl-plugin-sdk">
+    <img src="https://img.shields.io/github/stars/varavelio/vdl-plugin-sdk?style=flat&label=github+stars" alt="GitHub Stars"/>
+  </a>
+  <a href="LICENSE">
+    <img src="https://img.shields.io/github/license/varavelio/vdl-plugin-sdk.svg" alt="License"/>
+  </a>
+</p>
+
+## Install
+
+This is a reference install command. In most cases you do not need it manually:
+`vdl plugin init` and the official
+[`vdl-plugin-template`](https://github.com/varavelio/vdl-plugin-template)
+already include this SDK by default.
+
+```bash
+npm install @varavel/vdl-plugin-sdk
+```
+
+## What You Get
+
+- `definePlugin(...)` to declare a plugin handler with typed input and output.
+- Generated VDL IR types exported directly from the package.
+- `getAnnotation` and `getAnnotationArgs` for reading annotations.
+- `unwrapLiteral<T>()` for reading constants and annotation values.
+- A `vdl-plugin` binary that supports `check` and `build`.
+
+## Quick Start
+
+Every VDL plugin should export a `definePlugin(...)` handler from `src/index.ts`.
+
+Create `src/index.ts` in your plugin project:
+
+```ts
+import { definePlugin } from "@varavel/vdl-plugin-sdk";
+
+export const generate = definePlugin((_input) => {
+  // Your plugin logic goes here.
+
+  return {
+    files: [
+      {
+        path: "hello.txt",
+        content: "Hello from VDL Plugin SDK",
+      },
+    ],
+  };
+});
+```
+
+## Plugin Workflow
+
+Every plugin follows the same release flow:
+
+1. Create and export a `definePlugin(...)` handler in `./src/index.ts`.
+2. Run `vdl-plugin build` to bundle the plugin into `./dist/index.js`.
+3. Commit `./dist/index.js` to the repository.
+4. Publish a new release on GitHub including all your files (including `./dist/index.js`).
+5. When the plugin is used, VDL reads `./dist/index.js` directly from your GitHub relases.
+
+## CLI
+
+Use the bundled binary in scripts or with `npx`:
+
+```bash
+npx vdl-plugin check
+npx vdl-plugin build
+```
+
+- `check` runs TypeScript without emitting files.
+- `build` bundles the required `src/index.ts` entry into `dist/index.js`.
+
+Example `package.json` scripts:
+
+```json
+{
+  "scripts": {
+    "check": "vdl-plugin check",
+    "build": "vdl-plugin build"
+  }
+}
+```
+
+## TypeScript Setup
+
+You can extend the shared base config exported by the SDK:
+
+```json
+{
+  "extends": "@varavel/vdl-plugin-sdk/tsconfig.base.json"
+}
+```
+
+## License
+
+This project is released under the MIT License. See [LICENSE](LICENSE).

package/bin/vdl-plugin.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+
+import { execFileSync } from "node:child_process";
+import { createRequire } from "node:module";
+import { resolve } from "node:path";
+import * as esbuild from "esbuild";
+
+const require = createRequire(import.meta.url);
+const command = process.argv[2];
+
+function printHelp() {
+  console.log(`Usage: vdl-plugin <command>
+
+Commands:
+  check   Run TypeScript type checks without emitting files
+  build   Bundle the plugin from src/index.ts into dist/index.js`);
+}
+
+function runCheck() {
+  console.log("Running TypeScript type checks...");
+
+  try {
+    const tscPath = require.resolve("typescript/bin/tsc");
+    execFileSync(process.execPath, [tscPath, "--noEmit"], { stdio: "inherit" });
+    console.log("Type checks completed successfully.");
+  } catch {
+    process.exit(1);
+  }
+}
+
+function runBuild() {
+  console.log("Building VDL plugin...");
+
+  try {
+    esbuild.buildSync({
+      entryPoints: [resolve(process.cwd(), "src/index.ts")],
+      outfile: resolve(process.cwd(), "dist/index.js"),
+      format: "cjs",
+      platform: "neutral",
+      target: "es2015",
+      bundle: true,
+      minify: true,
+      treeShaking: true,
+    });
+
+    console.log("Plugin built successfully at dist/index.js.");
+  } catch (error) {
+    console.error("Failed to build the plugin.");
+    if (error instanceof Error && error.message) {
+      console.error(error.message);
+    }
+    process.exit(1);
+  }
+}
+
+if (command === "check") {
+  runCheck();
+} else if (command === "build") {
+  runBuild();
+} else {
+  if (command) {
+    console.error(`Unknown command: ${command}`);
+  }
+  printHelp();
+  process.exit(1);
+}

package/dist/{ir.cjs → index.cjs}

@@ -1,5 +1,30 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region src/ir.ts
+//#region src/define-plugin.ts
+/**
+* Defines a VDL plugin by wrapping the provided handler function. This is a helper function
+* that can be used to create plugins in a more concise way.
+*
+* Example usage:
+* ```typescript
+* import { definePlugin } from "@varavel/vdl-plugin-sdk";
+*
+* export const generate = definePlugin((input) => {
+*  // Plugin logic goes here
+*  return {
+*    files: [],
+*    errors: []
+*  };
+* });
+* ```
+*
+* @param handler - The plugin handler function that contains the logic for processing the input and generating the output.
+* @returns The same handler function, which can be exported as the plugin's main entry point.
+*/
+function definePlugin(handler) {
+	return handler;
+}
+//#endregion
+//#region src/types/types.ts
 const EnumValueTypeList = ["string", "int"];
 function isEnumValueType(value) {
 	return EnumValueTypeList.includes(value);
@@ -286,6 +311,72 @@ function validateObjectEntry(input, path = "ObjectEntry") {
 	}
 	return null;
 }
+function hydratePluginInput(input) {
+	return {
+		version: input.version,
+		ir: hydrateIrSchema(input.ir),
+		options: input.options
+	};
+}
+function validatePluginInput(input, path = "PluginInput") {
+	if (input === null || input === void 0 || typeof input !== "object") return `${path}: expected object, got ${typeof input}`;
+	const obj = input;
+	if (obj.ir === void 0 || obj.ir === null) return `${path}.ir: required field is missing`;
+	{
+		const err = validateIrSchema(obj.ir, `${path}.ir`);
+		if (err !== null) return err;
+	}
+	return null;
+}
+function hydratePluginOutput(input) {
+	return {
+		files: input.files ? input.files.map((el) => hydratePluginOutputFile(el)) : input.files,
+		errors: input.errors ? input.errors.map((el) => hydratePluginOutputError(el)) : input.errors
+	};
+}
+function validatePluginOutput(input, path = "PluginOutput") {
+	if (input === null || input === void 0 || typeof input !== "object") return `${path}: expected object, got ${typeof input}`;
+	const obj = input;
+	if (obj.files !== void 0 && obj.files !== null) {
+		if (!Array.isArray(obj.files)) return `${path}.files: expected array, got ${typeof obj.files}`;
+		for (let i = 0; i < obj.files.length; i++) {
+			const err = validatePluginOutputFile(obj.files[i], `${path}.files[${i}]`);
+			if (err !== null) return err;
+		}
+	}
+	if (obj.errors !== void 0 && obj.errors !== null) {
+		if (!Array.isArray(obj.errors)) return `${path}.errors: expected array, got ${typeof obj.errors}`;
+		for (let i = 0; i < obj.errors.length; i++) {
+			const err = validatePluginOutputError(obj.errors[i], `${path}.errors[${i}]`);
+			if (err !== null) return err;
+		}
+	}
+	return null;
+}
+function hydratePluginOutputError(input) {
+	return {
+		message: input.message,
+		position: input.position ? hydratePosition(input.position) : input.position
+	};
+}
+function validatePluginOutputError(input, path = "PluginOutputError") {
+	if (input === null || input === void 0 || typeof input !== "object") return `${path}: expected object, got ${typeof input}`;
+	const obj = input;
+	if (obj.position !== void 0 && obj.position !== null) {
+		const err = validatePosition(obj.position, `${path}.position`);
+		if (err !== null) return err;
+	}
+	return null;
+}
+function hydratePluginOutputFile(input) {
+	return {
+		path: input.path,
+		content: input.content
+	};
+}
+function validatePluginOutputFile(_input, _path = "PluginOutputFile") {
+	return null;
+}
 function hydratePosition(input) {
 	return {
 		file: input.file,
@@ -384,10 +475,67 @@ function validateTypeRef(input, path = "TypeRef") {
 	return null;
 }
 //#endregion
+//#region src/utils/annotations.ts
+/**
+* Returns the first annotation that matches the provided name.
+*/
+function getAnnotation(annotations, name) {
+	if (!annotations) return void 0;
+	return annotations.find((anno) => anno.name === name);
+}
+/**
+* Returns the raw literal argument stored in an annotation.
+*
+* VDL annotations currently expose a single literal argument.
+* Pair this helper with `unwrapLiteral` when you need a plain JavaScript value.
+*/
+function getAnnotationArgs(annotations, name) {
+	const anno = getAnnotation(annotations, name);
+	return anno === null || anno === void 0 ? void 0 : anno.argument;
+}
+//#endregion
+//#region src/utils/literals.ts
+/**
+* Resolves a `LiteralValue` into its native JavaScript representation.
+*
+* Pass a generic when you already know the expected shape.
+* Omit it to get `unknown` and narrow the result yourself.
+*
+* The generic only affects TypeScript types. It does not validate the runtime value.
+*/
+function unwrapLiteral(value) {
+	return unwrapLiteralValue(value);
+}
+/**
+* Performs the recursive literal resolution used by `unwrapLiteral`.
+*/
+function unwrapLiteralValue(value) {
+	switch (value.kind) {
+		case "string": return value.stringValue;
+		case "int": return value.intValue;
+		case "float": return value.floatValue;
+		case "bool": return value.boolValue;
+		case "object": {
+			var _value$objectEntries;
+			const resolvedObject = {};
+			const entries = (_value$objectEntries = value.objectEntries) !== null && _value$objectEntries !== void 0 ? _value$objectEntries : [];
+			for (const entry of entries) resolvedObject[entry.key] = unwrapLiteralValue(entry.value);
+			return resolvedObject;
+		}
+		case "array":
+			var _value$arrayItems;
+			return ((_value$arrayItems = value.arrayItems) !== null && _value$arrayItems !== void 0 ? _value$arrayItems : []).map((item) => unwrapLiteralValue(item));
+		default: return null;
+	}
+}
+//#endregion
 exports.EnumValueTypeList = EnumValueTypeList;
 exports.LiteralKindList = LiteralKindList;
 exports.PrimitiveTypeList = PrimitiveTypeList;
 exports.TypeKindList = TypeKindList;
+exports.definePlugin = definePlugin;
+exports.getAnnotation = getAnnotation;
+exports.getAnnotationArgs = getAnnotationArgs;
 exports.hydrateAnnotation = hydrateAnnotation;
 exports.hydrateConstantDef = hydrateConstantDef;
 exports.hydrateEnumDef = hydrateEnumDef;
@@ -396,6 +544,10 @@ exports.hydrateField = hydrateField;
 exports.hydrateIrSchema = hydrateIrSchema;
 exports.hydrateLiteralValue = hydrateLiteralValue;
 exports.hydrateObjectEntry = hydrateObjectEntry;
+exports.hydratePluginInput = hydratePluginInput;
+exports.hydratePluginOutput = hydratePluginOutput;
+exports.hydratePluginOutputError = hydratePluginOutputError;
+exports.hydratePluginOutputFile = hydratePluginOutputFile;
 exports.hydratePosition = hydratePosition;
 exports.hydrateTopLevelDoc = hydrateTopLevelDoc;
 exports.hydrateTypeDef = hydrateTypeDef;
@@ -404,6 +556,7 @@ exports.isEnumValueType = isEnumValueType;
 exports.isLiteralKind = isLiteralKind;
 exports.isPrimitiveType = isPrimitiveType;
 exports.isTypeKind = isTypeKind;
+exports.unwrapLiteral = unwrapLiteral;
 exports.validateAnnotation = validateAnnotation;
 exports.validateConstantDef = validateConstantDef;
 exports.validateEnumDef = validateEnumDef;
@@ -412,9 +565,13 @@ exports.validateField = validateField;
 exports.validateIrSchema = validateIrSchema;
 exports.validateLiteralValue = validateLiteralValue;
 exports.validateObjectEntry = validateObjectEntry;
+exports.validatePluginInput = validatePluginInput;
+exports.validatePluginOutput = validatePluginOutput;
+exports.validatePluginOutputError = validatePluginOutputError;
+exports.validatePluginOutputFile = validatePluginOutputFile;
 exports.validatePosition = validatePosition;
 exports.validateTopLevelDoc = validateTopLevelDoc;
 exports.validateTypeDef = validateTypeDef;
 exports.validateTypeRef = validateTypeRef;
 
-//# sourceMappingURL=ir.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/define-plugin.ts","../src/types/types.ts","../src/utils/annotations.ts","../src/utils/literals.ts"],"sourcesContent":["import type { PluginInput, PluginOutput } from \"./types\";\n\n/**\n * Defines a VDL plugin handler function.\n *\n * @param input - The input data for the plugin containing the IR and other relevant information.\n * @returns The output data from the plugin containing the generated files and any errors.\n */\nexport type VdlPluginHandler = (input: PluginInput) => PluginOutput;\n\n/**\n * Defines a VDL plugin by wrapping the provided handler function. This is a helper function\n * that can be used to create plugins in a more concise way.\n *\n * Example usage:\n * ```typescript\n * import { definePlugin } from \"@varavel/vdl-plugin-sdk\";\n *\n * export const generate = definePlugin((input) => {\n *  // Plugin logic goes here\n *  return {\n *    files: [],\n *    errors: []\n *  };\n * });\n * ```\n *\n * @param handler - The plugin handler function that contains the logic for processing the input and generating the output.\n * @returns The same handler function, which can be exported as the plugin's main entry point.\n */\nexport function definePlugin(handler: VdlPluginHandler): VdlPluginHandler {\n  return handler;\n}\n","// Code generated by VDL v0.4.0-alpha.5. DO NOT EDIT.\n// If you edit this file, it will be overwritten the next time it is generated.\n//\n// For more information about VDL, visit https://vdl.varavel.com\n\n/* eslint-disable */\n/* tslint:disable */\n// biome-ignore-all lint: Generated by VDL\n\n// -----------------------------------------------------------------------------\n// Enumerations\n// -----------------------------------------------------------------------------\n\n/**\n * Underlying storage kind used by an enum\n */\nexport type EnumValueType = \"string\" | \"int\";\n\nexport const EnumValueTypeList: EnumValueType[] = [\n  \"string\",\n  \"int\",\n];\n\nexport function isEnumValueType(value: unknown): value is EnumValueType {\n  return EnumValueTypeList.includes(value as EnumValueType);\n}\n\n/**\n * Kind discriminator for LiteralValue.\n * \n * LiteralValue is used for fully resolved literal data in:\n * \n * - constant values\n * - annotation arguments\n */\nexport type LiteralKind = \"string\" | \"int\" | \"float\" | \"bool\" | \"object\" | \"array\";\n\nexport const LiteralKindList: LiteralKind[] = [\n  \"string\",\n  \"int\",\n  \"float\",\n  \"bool\",\n  \"object\",\n  \"array\",\n];\n\nexport function isLiteralKind(value: unknown): value is LiteralKind {\n  return LiteralKindList.includes(value as LiteralKind);\n}\n\n/**\n * Primitive scalar type names\n */\nexport type PrimitiveType = \"string\" | \"int\" | \"float\" | \"bool\" | \"datetime\";\n\nexport const PrimitiveTypeList: PrimitiveType[] = [\n  \"string\",\n  \"int\",\n  \"float\",\n  \"bool\",\n  \"datetime\",\n];\n\nexport function isPrimitiveType(value: unknown): value is PrimitiveType {\n  return PrimitiveTypeList.includes(value as PrimitiveType);\n}\n\n/**\n * Kind discriminator for TypeRef\n */\nexport type TypeKind = \"primitive\" | \"type\" | \"enum\" | \"array\" | \"map\" | \"object\";\n\nexport const TypeKindList: TypeKind[] = [\n  \"primitive\",\n  \"type\",\n  \"enum\",\n  \"array\",\n  \"map\",\n  \"object\",\n];\n\nexport function isTypeKind(value: unknown): value is TypeKind {\n  return TypeKindList.includes(value as TypeKind);\n}\n\n// -----------------------------------------------------------------------------\n// Domain Types\n// -----------------------------------------------------------------------------\n\n/**\n * Annotation Annotation metadata preserved in IR.\n * \n * `name` is the annotation identifier without the `@` prefix.\n * `argument`, when present, is fully resolved as a LiteralValue.\n */\nexport type Annotation = {\n  position: Position\n  name: string\n  argument?: LiteralValue\n}\n\nexport function hydrateAnnotation(input: Annotation): Annotation {\n  const hydratedPosition = hydratePosition(input.position)\n  const hydratedName = input.name\n  const hydratedArgument = input.argument ? hydrateLiteralValue(input.argument) : input.argument\n  return {\n    position: hydratedPosition,\n    name: hydratedName,\n    argument: hydratedArgument,\n  }\n}\n\nexport function validateAnnotation(input: unknown, path = \"Annotation\"): string | null {\n  if (input === null || input === undefined || typeof input !== \"object\") {\n    return `${path}: expected object, got ${typeof input}`;\n  }\n  const obj = input as Record<string, unknown>;\n\n  if (obj.position === undefined || obj.position === null) {\n    return `${path}.position: required field is missing`;\n  }\n  {\n    const err = validatePosition(obj.position, `${path}.position`);\n    if (err !== null) return err;\n  }\n  if (obj.argument !== undefined && obj.argument !== null) {\n    {\n      const err = validateLiteralValue(obj.argument, `${path}.argument`);\n      if (err !== null) return err;\n    }\n  }\n  return null;\n}\n\n/**\n * ConstantDef Fully resolved constant definition.\n * \n * `typeRef` is explicit or inferred by analysis.\n * `value` contains the fully resolved literal payload.\n */\nexport type ConstantDef = {\n  position: Position\n  name: string\n  doc?: string\n  annotations: Annotation[]\n  typeRef: TypeRef\n  value: LiteralValue\n}\n\nexport function hydrateConstantDef(input: ConstantDef): ConstantDef {\n  const hydratedPosition = hydratePosition(input.position)\n  const hydratedName = input.name\n  const hydratedDoc = input.doc ? input.doc : input.doc\n  const hydratedAnnotations = input.annotations.map(el => hydrateAnnotation(el))\n  const hydratedTypeRef = hydrateTypeRef(input.typeRef)\n  const hydratedValue = hydrateLiteralValue(input.value)\n  return {\n    position: hydratedPosition,\n    name: hydratedName,\n    doc: hydratedDoc,\n    annotations: hydratedAnnotations,\n    typeRef: hydratedTypeRef,\n    value: hydratedValue,\n  }\n}\n\nexport function validateConstantDef(input: unknown, path = \"ConstantDef\"): string | null {\n  if (input === null || input === undefined || typeof input !== \"object\") {\n    return `${path}: expected object, got ${typeof input}`;\n  }\n  const obj = input as Record<string, unknown>;\n\n  if (obj.position === undefined || obj.position === null) {\n    return `${path}.position: required field is missing`;\n  }\n  {\n    const err = validatePosition(obj.position, `${path}.position`);\n    if (err !== null) return err;\n  }\n  if (obj.annotations === undefined || obj.annotations === null) {\n    return `${path}.annotations: required field is missing`;\n  }\n  {\n    if (!Array.isArray(obj.annotations)) {\n      return `${path}.annotations: expected array, got ${typeof obj.annotations}`;\n    }\n    for (let i = 0; i < obj.annotations.length; i++) {\n      {\n        const err = validateAnnotation(obj.annotations[i], `${path}.annotations[${i}]`);\n        if (err !== null) return err;\n      }\n    }\n  }\n  if (obj.typeRef === undefined || obj.typeRef === null) {\n    return `${path}.typeRef: required field is missing`;\n  }\n  {\n    const err = validateTypeRef(obj.typeRef, `${path}.typeRef`);\n    if (err !== null) return err;\n  }\n  if (obj.value === undefined || obj.value === null) {\n    return `${path}.value: required field is missing`;\n  }\n  {\n    const err = validateLiteralValue(obj.value, `${path}.value`);\n    if (err !== null) return err;\n  }\n  return null;\n}\n\n/**\n * EnumDef Flattened enum definition.\n * \n * All enum spreads are already expanded into `members`.\n */\nexport type EnumDef = {\n  position: Position\n  name: string\n  doc?: string\n  annotations: Annotation[]\n  enumType: EnumValueType\n  members: EnumMember[]\n}\n\nexport function hydrateEnumDef(input: EnumDef): EnumDef {\n  const hydratedPosition = hydratePosition(input.position)\n  const hydratedName = input.name\n  const hydratedDoc = input.doc ? input.doc : input.doc\n  const hydratedAnnotations = input.annotations.map(el => hydrateAnnotation(el))\n  const hydratedEnumType = input.enumType\n  const hydratedMembers = input.members.map(el => hydrateEnumMember(el))\n  return {\n    position: hydratedPosition,\n    name: hydratedName,\n    doc: hydratedDoc,\n    annotations: hydratedAnnotations,\n    enumType: hydratedEnumType,\n    members: hydratedMembers,\n  }\n}\n\nexport function validateEnumDef(input: unknown, path = \"EnumDef\"): string | null {\n  if (input === null || input === undefined || typeof input !== \"object\") {\n    return `${path}: expected object, got ${typeof input}`;\n  }\n  const obj = input as Record<string, unknown>;\n\n  if (obj.position === undefined || obj.position === null) {\n    return `${path}.position: required field is missing`;\n  }\n  {\n    const err = validatePosition(obj.position, `${path}.position`);\n    if (err !== null) return err;\n  }\n  if (obj.annotations === undefined || obj.annotations === null) {\n    return `${path}.annotations: required field is missing`;\n  }\n  {\n    if (!Array.isArray(obj.annotations)) {\n      return `${path}.annotations: expected array, got ${typeof obj.annotations}`;\n    }\n    for (let i = 0; i < obj.annotations.length; i++) {\n      {\n        const err = validateAnnotation(obj.annotations[i], `${path}.annotations[${i}]`);\n        if (err !== null) return err;\n      }\n    }\n  }\n  if (obj.enumType === undefined || obj.enumType === null) {\n    return `${path}.enumType: required field is missing`;\n  }\n  {\n    if (!isEnumValueType(obj.enumType)) {\n      return `${path}.enumType: invalid enum value '${obj.enumType}' for EnumValueType`;\n    }\n  }\n  if (obj.members === undefined || obj.members === null) {\n    return `${path}.members: required field is missing`;\n  }\n  {\n    if (!Array.isArray(obj.members)) {\n      return `${path}.members: expected array, got ${typeof obj.members}`;\n    }\n    for (let i = 0; i < obj.members.length; i++) {\n      {\n        const err = validateEnumMember(obj.members[i], `${path}.members[${i}]`);\n        if (err !== null) return err;\n      }\n    }\n  }\n  return null;\n}\n\n/**\n * EnumMember Enum member definition\n */\nexport type EnumMember = {\n  position: Position\n  name: string\n  value: LiteralValue\n  doc?: string\n  annotations: Annotation[]\n}\n\nexport function hydrateEnumMember(input: EnumMember): EnumMember {\n  const hydratedPosition = hydratePosition(input.position)\n  const hydratedName = input.name\n  const hydratedValue = hydrateLiteralValue(input.value)\n  const hydratedDoc = input.doc ? input.doc : input.doc\n  const hydratedAnnotations = input.annotations.map(el => hydrateAnnotation(el))\n  return {\n    position: hydratedPosition,\n    name: hydratedName,\n    value: hydratedValue,\n    doc: hydratedDoc,\n    annotations: hydratedAnnotations,\n  }\n}\n\nexport function validateEnumMember(input: unknown, path = \"EnumMember\"): string | null {\n  if (input === null || input === undefined || typeof input !== \"object\") {\n    return `${path}: expected object, got ${typeof input}`;\n  }\n  const obj = input as Record<string, unknown>;\n\n  if (obj.position === undefined || obj.position === null) {\n    return `${path}.position: required field is missing`;\n  }\n  {\n    const err = validatePosition(obj.position, `${path}.position`);\n    if (err !== null) return err;\n  }\n  if (obj.value === undefined || obj.value === null) {\n    return `${path}.value: required field is missing`;\n  }\n  {\n    const err = validateLiteralValue(obj.value, `${path}.value`);\n    if (err !== null) return err;\n  }\n  if (obj.annotations === undefined || obj.annotations === null) {\n    return `${path}.annotations: required field is missing`;\n  }\n  {\n    if (!Array.isArray(obj.annotations)) {\n      return `${path}.annotations: expected array, got ${typeof obj.annotations}`;\n    }\n    for (let i = 0; i < obj.annotations.length; i++) {\n      {\n        const err = validateAnnotation(obj.annotations[i], `${path}.annotations[${i}]`);\n        if (err !== null) return err;\n      }\n    }\n  }\n  return null;\n}\n\n/**\n * Field Flattened object/type field definition\n */\nexport type Field = {\n  position: Position\n  name: string\n  doc?: string\n  optional: boolean\n  annotations: Annotation[]\n  typeRef: TypeRef\n}\n\nexport function hydrateField(input: Field): Field {\n  const hydratedPosition = hydratePosition(input.position)\n  const hydratedName = input.name\n  const hydratedDoc = input.doc ? input.doc : input.doc\n  const hydratedOptional = input.optional\n  const hydratedAnnotations = input.annotations.map(el => hydrateAnnotation(el))\n  const hydratedTypeRef = hydrateTypeRef(input.typeRef)\n  return {\n    position: hydratedPosition,\n    name: hydratedName,\n    doc: hydratedDoc,\n    optional: hydratedOptional,\n    annotations: hydratedAnnotations,\n    typeRef: hydratedTypeRef,\n  }\n}\n\nexport function validateField(input: unknown, path = \"Field\"): string | null {\n  if (input === null || input === undefined || typeof input !== \"object\") {\n    return `${path}: expected object, got ${typeof input}`;\n  }\n  const obj = input as Record<string, unknown>;\n\n  if (obj.position === undefined || obj.position === null) {\n    return `${path}.position: required field is missing`;\n  }\n  {\n    const err = validatePosition(obj.position, `${path}.position`);\n    if (err !== null) return err;\n  }\n  if (obj.annotations === undefined || obj.annotations === null) {\n    return `${path}.annotations: required field is missing`;\n  }\n  {\n    if (!Array.isArray(obj.annotations)) {\n      return `${path}.annotations: expected array, got ${typeof obj.annotations}`;\n    }\n    for (let i = 0; i < obj.annotations.length; i++) {\n      {\n        const err = validateAnnotation(obj.annotations[i], `${path}.annotations[${i}]`);\n        if (err !== null) return err;\n      }\n    }\n  }\n  if (obj.typeRef === undefined || obj.typeRef === null) {\n    return `${path}.typeRef: required field is missing`;\n  }\n  {\n    const err = validateTypeRef(obj.typeRef, `${path}.typeRef`);\n    if (err !== null) return err;\n  }\n  return null;\n}\n\n/**\n * IrSchema IrSchema is the generator-facing representation of a VDL program.\n * \n * This model is intentionally \"flat\" and \"resolved\":\n * \n * - spreads are already expanded\n * - references are already resolved\n * - collections are in deterministic order\n * \n * A code generator should be able to consume IrSchema directly, without needing\n * to re-run parser or semantic-analysis logic.\n */\nexport type IrSchema = {\n  entryPoint: string\n  constants: ConstantDef[]\n  enums: EnumDef[]\n  types: TypeDef[]\n  docs: TopLevelDoc[]\n}\n\nexport function hydrateIrSchema(input: IrSchema): IrSchema {\n  const hydratedEntryPoint = input.entryPoint\n  const hydratedConstants = input.constants.map(el => hydrateConstantDef(el))\n  const hydratedEnums = input.enums.map(el => hydrateEnumDef(el))\n  const hydratedTypes = input.types.map(el => hydrateTypeDef(el))\n  const hydratedDocs = input.docs.map(el => hydrateTopLevelDoc(el))\n  return {\n    entryPoint: hydratedEntryPoint,\n    constants: hydratedConstants,\n    enums: hydratedEnums,\n    types: hydratedTypes,\n    docs: hydratedDocs,\n  }\n}\n\nexport function validateIrSchema(input: unknown, path = \"IrSchema\"): string | null {\n  if (input === null || input === undefined || typeof input !== \"object\") {\n    return `${path}: expected object, got ${typeof input}`;\n  }\n  const obj = input as Record<string, unknown>;\n\n  if (obj.constants === undefined || obj.constants === null) {\n    return `${path}.constants: required field is missing`;\n  }\n  {\n    if (!Array.isArray(obj.constants)) {\n      return `${path}.constants: expected array, got ${typeof obj.constants}`;\n    }\n    for (let i = 0; i < obj.constants.length; i++) {\n      {\n        const err = validateConstantDef(obj.constants[i], `${path}.constants[${i}]`);\n        if (err !== null) return err;\n      }\n    }\n  }\n  if (obj.enums === undefined || obj.enums === null) {\n    return `${path}.enums: required field is missing`;\n  }\n  {\n    if (!Array.isArray(obj.enums)) {\n      return `${path}.enums: expected array, got ${typeof obj.enums}`;\n    }\n    for (let i = 0; i < obj.enums.length; i++) {\n      {\n        const err = validateEnumDef(obj.enums[i], `${path}.enums[${i}]`);\n        if (err !== null) return err;\n      }\n    }\n  }\n  if (obj.types === undefined || obj.types === null) {\n    return `${path}.types: required field is missing`;\n  }\n  {\n    if (!Array.isArray(obj.types)) {\n      return `${path}.types: expected array, got ${typeof obj.types}`;\n    }\n    for (let i = 0; i < obj.types.length; i++) {\n      {\n        const err = validateTypeDef(obj.types[i], `${path}.types[${i}]`);\n        if (err !== null) return err;\n      }\n    }\n  }\n  if (obj.docs === undefined || obj.docs === null) {\n    return `${path}.docs: required field is missing`;\n  }\n  {\n    if (!Array.isArray(obj.docs)) {\n      return `${path}.docs: expected array, got ${typeof obj.docs}`;\n    }\n    for (let i = 0; i < obj.docs.length; i++) {\n      {\n        const err = validateTopLevelDoc(obj.docs[i], `${path}.docs[${i}]`);\n        if (err !== null) return err;\n      }\n    }\n  }\n  return null;\n}\n\n/**\n * LiteralValue Fully resolved literal value.\n * \n * The selected payload is determined by `kind`:\n * \n * - `string` -> `stringValue`\n * - `int` -> `intValue`\n * - `float` -> `floatValue`\n * - `bool` -> `boolValue`\n * - `object` -> `objectEntries`\n * - `array` -> `arrayItems`\n */\nexport type LiteralValue = {\n  position: Position\n  kind: LiteralKind\n  stringValue?: string\n  intValue?: number\n  floatValue?: number\n  boolValue?: boolean\n  objectEntries?: ObjectEntry[]\n  arrayItems?: LiteralValue[]\n}\n\nexport function hydrateLiteralValue(input: LiteralValue): LiteralValue {\n  const hydratedPosition = hydratePosition(input.position)\n  const hydratedKind = input.kind\n  const hydratedStringValue = input.stringValue ? input.stringValue : input.stringValue\n  const hydratedIntValue = input.intValue ? input.intValue : input.intValue\n  const hydratedFloatValue = input.floatValue ? input.floatValue : input.floatValue\n  const hydratedBoolValue = input.boolValue ? input.boolValue : input.boolValue\n  const hydratedObjectEntries = input.objectEntries ? input.objectEntries.map(el => hydrateObjectEntry(el)) : input.objectEntries\n  const hydratedArrayItems = input.arrayItems ? input.arrayItems.map(el => hydrateLiteralValue(el)) : input.arrayItems\n  return {\n    position: hydratedPosition,\n    kind: hydratedKind,\n    stringValue: hydratedStringValue,\n    intValue: hydratedIntValue,\n    floatValue: hydratedFloatValue,\n    boolValue: hydratedBoolValue,\n    objectEntries: hydratedObjectEntries,\n    arrayItems: hydratedArrayItems,\n  }\n}\n\nexport function validateLiteralValue(input: unknown, path = \"LiteralValue\"): string | null {\n  if (input === null || input === undefined || typeof input !== \"object\") {\n    return `${path}: expected object, got ${typeof input}`;\n  }\n  const obj = input as Record<string, unknown>;\n\n  if (obj.position === undefined || obj.position === null) {\n    return `${path}.position: required field is missing`;\n  }\n  {\n    const err = validatePosition(obj.position, `${path}.position`);\n    if (err !== null) return err;\n  }\n  if (obj.kind === undefined || obj.kind === null) {\n    return `${path}.kind: required field is missing`;\n  }\n  {\n    if (!isLiteralKind(obj.kind)) {\n      return `${path}.kind: invalid enum value '${obj.kind}' for LiteralKind`;\n    }\n  }\n  if (obj.objectEntries !== undefined && obj.objectEntries !== null) {\n    {\n      if (!Array.isArray(obj.objectEntries)) {\n        return `${path}.objectEntries: expected array, got ${typeof obj.objectEntries}`;\n      }\n      for (let i = 0; i < obj.objectEntries.length; i++) {\n        {\n          const err = validateObjectEntry(obj.objectEntries[i], `${path}.objectEntries[${i}]`);\n          if (err !== null) return err;\n        }\n      }\n    }\n  }\n  if (obj.arrayItems !== undefined && obj.arrayItems !== null) {\n    {\n      if (!Array.isArray(obj.arrayItems)) {\n        return `${path}.arrayItems: expected array, got ${typeof obj.arrayItems}`;\n      }\n      for (let i = 0; i < obj.arrayItems.length; i++) {\n        {\n          const err = validateLiteralValue(obj.arrayItems[i], `${path}.arrayItems[${i}]`);\n          if (err !== null) return err;\n        }\n      }\n    }\n  }\n  return null;\n}\n\n/**\n * ObjectEntry Key/value pair inside an object LiteralValue payload\n */\nexport type ObjectEntry = {\n  position: Position\n  key: string\n  value: LiteralValue\n}\n\nexport function hydrateObjectEntry(input: ObjectEntry): ObjectEntry {\n  const hydratedPosition = hydratePosition(input.position)\n  const hydratedKey = input.key\n  const hydratedValue = hydrateLiteralValue(input.value)\n  return {\n    position: hydratedPosition,\n    key: hydratedKey,\n    value: hydratedValue,\n  }\n}\n\nexport function validateObjectEntry(input: unknown, path = \"ObjectEntry\"): string | null {\n  if (input === null || input === undefined || typeof input !== \"object\") {\n    return `${path}: expected object, got ${typeof input}`;\n  }\n  const obj = input as Record<string, unknown>;\n\n  if (obj.position === undefined || obj.position === null) {\n    return `${path}.position: required field is missing`;\n  }\n  {\n    const err = validatePosition(obj.position, `${path}.position`);\n    if (err !== null) return err;\n  }\n  if (obj.value === undefined || obj.value === null) {\n    return `${path}.value: required field is missing`;\n  }\n  {\n    const err = validateLiteralValue(obj.value, `${path}.value`);\n    if (err !== null) return err;\n  }\n  return null;\n}\n\n/**\n * PluginInput PluginInput represents the data payload sent to a plugin.\n * \n * The plugin receives this as a single argument containing the complete\n * Intermediate Representation of the VDL schema along with any user-defined\n * configuration options from `vdl.config.vdl`.\n */\nexport type PluginInput = {\n  version: string\n  ir: IrSchema\n  options: Record<string, string>\n}\n\nexport function hydratePluginInput(input: PluginInput): PluginInput {\n  const hydratedVersion = input.version\n  const hydratedIr = hydrateIrSchema(input.ir)\n  const hydratedOptions = input.options\n  return {\n    version: hydratedVersion,\n    ir: hydratedIr,\n    options: hydratedOptions,\n  }\n}\n\nexport function validatePluginInput(input: unknown, path = \"PluginInput\"): string | null {\n  if (input === null || input === undefined || typeof input !== \"object\") {\n    return `${path}: expected object, got ${typeof input}`;\n  }\n  const obj = input as Record<string, unknown>;\n\n  if (obj.ir === undefined || obj.ir === null) {\n    return `${path}.ir: required field is missing`;\n  }\n  {\n    const err = validateIrSchema(obj.ir, `${path}.ir`);\n    if (err !== null) return err;\n  }\n  return null;\n}\n\n/**\n * PluginOutput PluginOutput represents the response payload returned by the `plugin` function.\n * \n * After processing the input schema, the plugin outputs this object containing\n * all files to be generated or errors to be displayed to the user.\n * \n * If there are no errors and at least one file is returned, VDL will write each\n * file to the specified path within the output directory. If there are errors,\n * VDL will display them to the user and not write any files.\n */\nexport type PluginOutput = {\n  files?: PluginOutputFile[]\n  errors?: PluginOutputError[]\n}\n\nexport function hydratePluginOutput(input: PluginOutput): PluginOutput {\n  const hydratedFiles = input.files ? input.files.map(el => hydratePluginOutputFile(el)) : input.files\n  const hydratedErrors = input.errors ? input.errors.map(el => hydratePluginOutputError(el)) : input.errors\n  return {\n    files: hydratedFiles,\n    errors: hydratedErrors,\n  }\n}\n\nexport function validatePluginOutput(input: unknown, path = \"PluginOutput\"): string | null {\n  if (input === null || input === undefined || typeof input !== \"object\") {\n    return `${path}: expected object, got ${typeof input}`;\n  }\n  const obj = input as Record<string, unknown>;\n\n  if (obj.files !== undefined && obj.files !== null) {\n    {\n      if (!Array.isArray(obj.files)) {\n        return `${path}.files: expected array, got ${typeof obj.files}`;\n      }\n      for (let i = 0; i < obj.files.length; i++) {\n        {\n          const err = validatePluginOutputFile(obj.files[i], `${path}.files[${i}]`);\n          if (err !== null) return err;\n        }\n      }\n    }\n  }\n  if (obj.errors !== undefined && obj.errors !== null) {\n    {\n      if (!Array.isArray(obj.errors)) {\n        return `${path}.errors: expected array, got ${typeof obj.errors}`;\n      }\n      for (let i = 0; i < obj.errors.length; i++) {\n        {\n          const err = validatePluginOutputError(obj.errors[i], `${path}.errors[${i}]`);\n          if (err !== null) return err;\n        }\n      }\n    }\n  }\n  return null;\n}\n\n/**\n * PluginOutputError A structured error reported by the plugin.\n */\nexport type PluginOutputError = {\n  message: string\n  position?: Position\n}\n\nexport function hydratePluginOutputError(input: PluginOutputError): PluginOutputError {\n  const hydratedMessage = input.message\n  const hydratedPosition = input.position ? hydratePosition(input.position) : input.position\n  return {\n    message: hydratedMessage,\n    position: hydratedPosition,\n  }\n}\n\nexport function validatePluginOutputError(input: unknown, path = \"PluginOutputError\"): string | null {\n  if (input === null || input === undefined || typeof input !== \"object\") {\n    return `${path}: expected object, got ${typeof input}`;\n  }\n  const obj = input as Record<string, unknown>;\n\n  if (obj.position !== undefined && obj.position !== null) {\n    {\n      const err = validatePosition(obj.position, `${path}.position`);\n      if (err !== null) return err;\n    }\n  }\n  return null;\n}\n\n/**\n * PluginOutputFile PluginOutputFile represents a single generated file produced by the plugin.\n * \n * This abstraction allows plugins to generate multiple files from a single\n * invocation, enabling patterns like one-file-per-type or splitting large\n * outputs across multiple modules.\n */\nexport type PluginOutputFile = {\n  path: string\n  content: string\n}\n\nexport function hydratePluginOutputFile(input: PluginOutputFile): PluginOutputFile {\n  const hydratedPath = input.path\n  const hydratedContent = input.content\n  return {\n    path: hydratedPath,\n    content: hydratedContent,\n  }\n}\n\nexport function validatePluginOutputFile(_input: unknown, _path = \"PluginOutputFile\"): string | null {\n  return null;\n}\n\n/**\n * Position It represents a position within a file and is used for error\n * reporting, diagnostics, plugins, and tooling support.\n */\nexport type Position = {\n  file: string\n  line: number\n  column: number\n}\n\nexport function hydratePosition(input: Position): Position {\n  const hydratedFile = input.file\n  const hydratedLine = input.line\n  const hydratedColumn = input.column\n  return {\n    file: hydratedFile,\n    line: hydratedLine,\n    column: hydratedColumn,\n  }\n}\n\nexport function validatePosition(_input: unknown, _path = \"Position\"): string | null {\n  return null;\n}\n\n/**\n * TopLevelDoc Standalone documentation block.\n * \n * Used for top-level docstrings that are not attached to a type/enum/constant.\n */\nexport type TopLevelDoc = {\n  position: Position\n  content: string\n}\n\nexport function hydrateTopLevelDoc(input: TopLevelDoc): TopLevelDoc {\n  const hydratedPosition = hydratePosition(input.position)\n  const hydratedContent = input.content\n  return {\n    position: hydratedPosition,\n    content: hydratedContent,\n  }\n}\n\nexport function validateTopLevelDoc(input: unknown, path = \"TopLevelDoc\"): string | null {\n  if (input === null || input === undefined || typeof input !== \"object\") {\n    return `${path}: expected object, got ${typeof input}`;\n  }\n  const obj = input as Record<string, unknown>;\n\n  if (obj.position === undefined || obj.position === null) {\n    return `${path}.position: required field is missing`;\n  }\n  {\n    const err = validatePosition(obj.position, `${path}.position`);\n    if (err !== null) return err;\n  }\n  return null;\n}\n\n/**\n * TypeDef Flattened type definition.\n * \n * All spreads are already expanded. The unified `typeRef` describes what this\n * type IS, a primitive, custom reference, map, array, or object with fields.\n */\nexport type TypeDef = {\n  position: Position\n  name: string\n  doc?: string\n  annotations: Annotation[]\n  typeRef: TypeRef\n}\n\nexport function hydrateTypeDef(input: TypeDef): TypeDef {\n  const hydratedPosition = hydratePosition(input.position)\n  const hydratedName = input.name\n  const hydratedDoc = input.doc ? input.doc : input.doc\n  const hydratedAnnotations = input.annotations.map(el => hydrateAnnotation(el))\n  const hydratedTypeRef = hydrateTypeRef(input.typeRef)\n  return {\n    position: hydratedPosition,\n    name: hydratedName,\n    doc: hydratedDoc,\n    annotations: hydratedAnnotations,\n    typeRef: hydratedTypeRef,\n  }\n}\n\nexport function validateTypeDef(input: unknown, path = \"TypeDef\"): string | null {\n  if (input === null || input === undefined || typeof input !== \"object\") {\n    return `${path}: expected object, got ${typeof input}`;\n  }\n  const obj = input as Record<string, unknown>;\n\n  if (obj.position === undefined || obj.position === null) {\n    return `${path}.position: required field is missing`;\n  }\n  {\n    const err = validatePosition(obj.position, `${path}.position`);\n    if (err !== null) return err;\n  }\n  if (obj.annotations === undefined || obj.annotations === null) {\n    return `${path}.annotations: required field is missing`;\n  }\n  {\n    if (!Array.isArray(obj.annotations)) {\n      return `${path}.annotations: expected array, got ${typeof obj.annotations}`;\n    }\n    for (let i = 0; i < obj.annotations.length; i++) {\n      {\n        const err = validateAnnotation(obj.annotations[i], `${path}.annotations[${i}]`);\n        if (err !== null) return err;\n      }\n    }\n  }\n  if (obj.typeRef === undefined || obj.typeRef === null) {\n    return `${path}.typeRef: required field is missing`;\n  }\n  {\n    const err = validateTypeRef(obj.typeRef, `${path}.typeRef`);\n    if (err !== null) return err;\n  }\n  return null;\n}\n\n/**\n * TypeRef Normalized type reference used by fields and constants.\n * \n * `kind` selects which payload fields are meaningful. Generators should inspect\n * `kind` first, then read the related payload fields.\n */\nexport type TypeRef = {\n  kind: TypeKind\n  primitiveName?: PrimitiveType\n  typeName?: string\n  enumName?: string\n  enumType?: EnumValueType\n  arrayType?: TypeRef\n  arrayDims?: number\n  mapType?: TypeRef\n  objectFields?: Field[]\n}\n\nexport function hydrateTypeRef(input: TypeRef): TypeRef {\n  const hydratedKind = input.kind\n  const hydratedPrimitiveName = input.primitiveName ? input.primitiveName : input.primitiveName\n  const hydratedTypeName = input.typeName ? input.typeName : input.typeName\n  const hydratedEnumName = input.enumName ? input.enumName : input.enumName\n  const hydratedEnumType = input.enumType ? input.enumType : input.enumType\n  const hydratedArrayType = input.arrayType ? hydrateTypeRef(input.arrayType) : input.arrayType\n  const hydratedArrayDims = input.arrayDims ? input.arrayDims : input.arrayDims\n  const hydratedMapType = input.mapType ? hydrateTypeRef(input.mapType) : input.mapType\n  const hydratedObjectFields = input.objectFields ? input.objectFields.map(el => hydrateField(el)) : input.objectFields\n  return {\n    kind: hydratedKind,\n    primitiveName: hydratedPrimitiveName,\n    typeName: hydratedTypeName,\n    enumName: hydratedEnumName,\n    enumType: hydratedEnumType,\n    arrayType: hydratedArrayType,\n    arrayDims: hydratedArrayDims,\n    mapType: hydratedMapType,\n    objectFields: hydratedObjectFields,\n  }\n}\n\nexport function validateTypeRef(input: unknown, path = \"TypeRef\"): string | null {\n  if (input === null || input === undefined || typeof input !== \"object\") {\n    return `${path}: expected object, got ${typeof input}`;\n  }\n  const obj = input as Record<string, unknown>;\n\n  if (obj.kind === undefined || obj.kind === null) {\n    return `${path}.kind: required field is missing`;\n  }\n  {\n    if (!isTypeKind(obj.kind)) {\n      return `${path}.kind: invalid enum value '${obj.kind}' for TypeKind`;\n    }\n  }\n  if (obj.primitiveName !== undefined && obj.primitiveName !== null) {\n    {\n      if (!isPrimitiveType(obj.primitiveName)) {\n        return `${path}.primitiveName: invalid enum value '${obj.primitiveName}' for PrimitiveType`;\n      }\n    }\n  }\n  if (obj.enumType !== undefined && obj.enumType !== null) {\n    {\n      if (!isEnumValueType(obj.enumType)) {\n        return `${path}.enumType: invalid enum value '${obj.enumType}' for EnumValueType`;\n      }\n    }\n  }\n  if (obj.arrayType !== undefined && obj.arrayType !== null) {\n    {\n      const err = validateTypeRef(obj.arrayType, `${path}.arrayType`);\n      if (err !== null) return err;\n    }\n  }\n  if (obj.mapType !== undefined && obj.mapType !== null) {\n    {\n      const err = validateTypeRef(obj.mapType, `${path}.mapType`);\n      if (err !== null) return err;\n    }\n  }\n  if (obj.objectFields !== undefined && obj.objectFields !== null) {\n    {\n      if (!Array.isArray(obj.objectFields)) {\n        return `${path}.objectFields: expected array, got ${typeof obj.objectFields}`;\n      }\n      for (let i = 0; i < obj.objectFields.length; i++) {\n        {\n          const err = validateField(obj.objectFields[i], `${path}.objectFields[${i}]`);\n          if (err !== null) return err;\n        }\n      }\n    }\n  }\n  return null;\n}\n","import type { Annotation, LiteralValue } from \"../types\";\n\n/**\n * Returns the first annotation that matches the provided name.\n */\nexport function getAnnotation(\n  annotations: Annotation[] | undefined,\n  name: string,\n): Annotation | undefined {\n  if (!annotations) return undefined;\n  return annotations.find((anno) => anno.name === name);\n}\n\n/**\n * Returns the raw literal argument stored in an annotation.\n *\n * VDL annotations currently expose a single literal argument.\n * Pair this helper with `unwrapLiteral` when you need a plain JavaScript value.\n */\nexport function getAnnotationArgs(\n  annotations: Annotation[] | undefined,\n  name: string,\n): LiteralValue | undefined {\n  const anno = getAnnotation(annotations, name);\n  return anno?.argument;\n}\n","import type { LiteralValue } from \"../types\";\n\n/**\n * Native JavaScript value produced by `unwrapLiteral`.\n *\n * `undefined` is preserved when a literal is missing its kind-specific payload.\n * `null` is returned for unknown literal kinds to keep the resolver non-throwing.\n */\nexport type UnwrappedLiteral =\n  | string\n  | number\n  | boolean\n  | null\n  | undefined\n  | UnwrappedLiteral[]\n  | { [key: string]: UnwrappedLiteral };\n\n/**\n * Resolves a `LiteralValue` into its native JavaScript representation.\n *\n * Pass a generic when you already know the expected shape.\n * Omit it to get `unknown` and narrow the result yourself.\n *\n * The generic only affects TypeScript types. It does not validate the runtime value.\n */\nexport function unwrapLiteral<T = unknown>(value: LiteralValue): T {\n  return unwrapLiteralValue(value) as T;\n}\n\n/**\n * Performs the recursive literal resolution used by `unwrapLiteral`.\n */\nfunction unwrapLiteralValue(value: LiteralValue): UnwrappedLiteral {\n  switch (value.kind) {\n    case \"string\":\n      return value.stringValue;\n    case \"int\":\n      return value.intValue;\n    case \"float\":\n      return value.floatValue;\n    case \"bool\":\n      return value.boolValue;\n    case \"object\": {\n      const resolvedObject: { [key: string]: UnwrappedLiteral } = {};\n      const entries = value.objectEntries ?? [];\n\n      for (const entry of entries) {\n        resolvedObject[entry.key] = unwrapLiteralValue(entry.value);\n      }\n\n      return resolvedObject;\n    }\n    case \"array\": {\n      const items = value.arrayItems ?? [];\n      return items.map((item) => unwrapLiteralValue(item));\n    }\n    default:\n      return null;\n  }\n}\n"],"mappings":"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"}

package/dist/{ir.d.cts → index.d.cts}

@@ -1,4 +1,14 @@
-//#region src/ir.d.ts
+//#region src/runtime.d.ts
+declare global {
+  const console: {
+    log(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+  };
+} //# sourceMappingURL=runtime.d.ts.map
+//#endregion
+//#region src/types/types.d.ts
 /**
  * Underlying storage kind used by an enum
  */
@@ -152,6 +162,58 @@ type ObjectEntry = {
 };
 declare function hydrateObjectEntry(input: ObjectEntry): ObjectEntry;
 declare function validateObjectEntry(input: unknown, path?: string): string | null;
+/**
+ * PluginInput PluginInput represents the data payload sent to a plugin.
+ *
+ * The plugin receives this as a single argument containing the complete
+ * Intermediate Representation of the VDL schema along with any user-defined
+ * configuration options from `vdl.config.vdl`.
+ */
+type PluginInput = {
+  version: string;
+  ir: IrSchema;
+  options: Record<string, string>;
+};
+declare function hydratePluginInput(input: PluginInput): PluginInput;
+declare function validatePluginInput(input: unknown, path?: string): string | null;
+/**
+ * PluginOutput PluginOutput represents the response payload returned by the `plugin` function.
+ *
+ * After processing the input schema, the plugin outputs this object containing
+ * all files to be generated or errors to be displayed to the user.
+ *
+ * If there are no errors and at least one file is returned, VDL will write each
+ * file to the specified path within the output directory. If there are errors,
+ * VDL will display them to the user and not write any files.
+ */
+type PluginOutput = {
+  files?: PluginOutputFile[];
+  errors?: PluginOutputError[];
+};
+declare function hydratePluginOutput(input: PluginOutput): PluginOutput;
+declare function validatePluginOutput(input: unknown, path?: string): string | null;
+/**
+ * PluginOutputError A structured error reported by the plugin.
+ */
+type PluginOutputError = {
+  message: string;
+  position?: Position;
+};
+declare function hydratePluginOutputError(input: PluginOutputError): PluginOutputError;
+declare function validatePluginOutputError(input: unknown, path?: string): string | null;
+/**
+ * PluginOutputFile PluginOutputFile represents a single generated file produced by the plugin.
+ *
+ * This abstraction allows plugins to generate multiple files from a single
+ * invocation, enabling patterns like one-file-per-type or splitting large
+ * outputs across multiple modules.
+ */
+type PluginOutputFile = {
+  path: string;
+  content: string;
+};
+declare function hydratePluginOutputFile(input: PluginOutputFile): PluginOutputFile;
+declare function validatePluginOutputFile(_input: unknown, _path?: string): string | null;
 /**
  * Position It represents a position within a file and is used for error
  * reporting, diagnostics, plugins, and tooling support.
@@ -209,5 +271,68 @@ type TypeRef = {
 declare function hydrateTypeRef(input: TypeRef): TypeRef;
 declare function validateTypeRef(input: unknown, path?: string): string | null;
 //#endregion
-export { Annotation, ConstantDef, EnumDef, EnumMember, EnumValueType, EnumValueTypeList, Field, IrSchema, LiteralKind, LiteralKindList, LiteralValue, ObjectEntry, Position, PrimitiveType, PrimitiveTypeList, TopLevelDoc, TypeDef, TypeKind, TypeKindList, TypeRef, hydrateAnnotation, hydrateConstantDef, hydrateEnumDef, hydrateEnumMember, hydrateField, hydrateIrSchema, hydrateLiteralValue, hydrateObjectEntry, hydratePosition, hydrateTopLevelDoc, hydrateTypeDef, hydrateTypeRef, isEnumValueType, isLiteralKind, isPrimitiveType, isTypeKind, validateAnnotation, validateConstantDef, validateEnumDef, validateEnumMember, validateField, validateIrSchema, validateLiteralValue, validateObjectEntry, validatePosition, validateTopLevelDoc, validateTypeDef, validateTypeRef };
-//# sourceMappingURL=ir.d.cts.map
+//#region src/define-plugin.d.ts
+/**
+ * Defines a VDL plugin handler function.
+ *
+ * @param input - The input data for the plugin containing the IR and other relevant information.
+ * @returns The output data from the plugin containing the generated files and any errors.
+ */
+type VdlPluginHandler = (input: PluginInput) => PluginOutput;
+/**
+ * Defines a VDL plugin by wrapping the provided handler function. This is a helper function
+ * that can be used to create plugins in a more concise way.
+ *
+ * Example usage:
+ * ```typescript
+ * import { definePlugin } from "@varavel/vdl-plugin-sdk";
+ *
+ * export const generate = definePlugin((input) => {
+ *  // Plugin logic goes here
+ *  return {
+ *    files: [],
+ *    errors: []
+ *  };
+ * });
+ * ```
+ *
+ * @param handler - The plugin handler function that contains the logic for processing the input and generating the output.
+ * @returns The same handler function, which can be exported as the plugin's main entry point.
+ */
+declare function definePlugin(handler: VdlPluginHandler): VdlPluginHandler;
+//#endregion
+//#region src/utils/annotations.d.ts
+/**
+ * Returns the first annotation that matches the provided name.
+ */
+declare function getAnnotation(annotations: Annotation[] | undefined, name: string): Annotation | undefined;
+/**
+ * Returns the raw literal argument stored in an annotation.
+ *
+ * VDL annotations currently expose a single literal argument.
+ * Pair this helper with `unwrapLiteral` when you need a plain JavaScript value.
+ */
+declare function getAnnotationArgs(annotations: Annotation[] | undefined, name: string): LiteralValue | undefined;
+//#endregion
+//#region src/utils/literals.d.ts
+/**
+ * Native JavaScript value produced by `unwrapLiteral`.
+ *
+ * `undefined` is preserved when a literal is missing its kind-specific payload.
+ * `null` is returned for unknown literal kinds to keep the resolver non-throwing.
+ */
+type UnwrappedLiteral = string | number | boolean | null | undefined | UnwrappedLiteral[] | {
+  [key: string]: UnwrappedLiteral;
+};
+/**
+ * Resolves a `LiteralValue` into its native JavaScript representation.
+ *
+ * Pass a generic when you already know the expected shape.
+ * Omit it to get `unknown` and narrow the result yourself.
+ *
+ * The generic only affects TypeScript types. It does not validate the runtime value.
+ */
+declare function unwrapLiteral<T = unknown>(value: LiteralValue): T;
+//#endregion
+export { Annotation, ConstantDef, EnumDef, EnumMember, EnumValueType, EnumValueTypeList, Field, IrSchema, LiteralKind, LiteralKindList, LiteralValue, ObjectEntry, PluginInput, PluginOutput, PluginOutputError, PluginOutputFile, Position, PrimitiveType, PrimitiveTypeList, TopLevelDoc, TypeDef, TypeKind, TypeKindList, TypeRef, UnwrappedLiteral, VdlPluginHandler, definePlugin, getAnnotation, getAnnotationArgs, hydrateAnnotation, hydrateConstantDef, hydrateEnumDef, hydrateEnumMember, hydrateField, hydrateIrSchema, hydrateLiteralValue, hydrateObjectEntry, hydratePluginInput, hydratePluginOutput, hydratePluginOutputError, hydratePluginOutputFile, hydratePosition, hydrateTopLevelDoc, hydrateTypeDef, hydrateTypeRef, isEnumValueType, isLiteralKind, isPrimitiveType, isTypeKind, unwrapLiteral, validateAnnotation, validateConstantDef, validateEnumDef, validateEnumMember, validateField, validateIrSchema, validateLiteralValue, validateObjectEntry, validatePluginInput, validatePluginOutput, validatePluginOutputError, validatePluginOutputFile, validatePosition, validateTopLevelDoc, validateTypeDef, validateTypeRef };
+//# sourceMappingURL=index.d.cts.map