@varavel/vdl-plugin-sdk 0.0.0 → 0.1.1

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/define-plugin.ts","../src/types/types.ts","../src/utils/annotations.ts","../src/utils/literals.ts","../src/utils/options.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","/**\n * Returns a string option or the provided fallback when the key is missing.\n */\nexport function getOptionString(\n  options: Record<string, string> | undefined,\n  key: string,\n  defaultValue: string,\n): string {\n  const value = options?.[key];\n  return value === undefined ? defaultValue : value;\n}\n\n/**\n * Returns a boolean option using common truthy and falsy string values.\n *\n * Accepted truthy values: `true`, `1`, `yes`, `on`, `enable`, `enabled`, `y`.\n *\n * Accepted falsy values: `false`, `0`, `no`, `off`, `disable`, `disabled`, `n`.\n *\n * Invalid values fall back to the provided default.\n */\nexport function getOptionBool(\n  options: Record<string, string> | undefined,\n  key: string,\n  defaultValue: boolean,\n): boolean {\n  const value = options?.[key];\n\n  if (value === undefined) {\n    return defaultValue;\n  }\n\n  switch (value.trim().toLowerCase()) {\n    case \"true\":\n    case \"1\":\n    case \"yes\":\n    case \"on\":\n    case \"enable\":\n    case \"enabled\":\n    case \"y\":\n      return true;\n    case \"false\":\n    case \"0\":\n    case \"no\":\n    case \"off\":\n    case \"disable\":\n    case \"disabled\":\n    case \"n\":\n      return false;\n    default:\n      return defaultValue;\n  }\n}\n\n/**\n * Returns a numeric option or the provided fallback when parsing fails.\n *\n * Empty, invalid, and non-finite values fall back to the default.\n */\nexport function getOptionNumber(\n  options: Record<string, string> | undefined,\n  key: string,\n  defaultValue: number,\n): number {\n  const value = options?.[key];\n\n  if (value === undefined) {\n    return defaultValue;\n  }\n\n  const trimmedValue = value.trim();\n\n  if (trimmedValue === \"\") {\n    return defaultValue;\n  }\n\n  const parsedValue = Number(trimmedValue);\n  return Number.isFinite(parsedValue) ? parsedValue : defaultValue;\n}\n\n/**\n * Returns a string array option from a separator-delimited value.\n *\n * Empty items are removed and each entry is trimmed.\n *\n * Missing values return the provided default.\n *\n * @example\n * // For options: { \"features\": \"feature1, feature2, feature3\" }\n * getOptionArray(options, \"features\", [], \",\")\n * // returns [\"feature1\", \"feature2\", \"feature3\"]\n */\nexport function getOptionArray(\n  options: Record<string, string> | undefined,\n  key: string,\n  defaultValue: string[] = [],\n  separator = \",\",\n): string[] {\n  const value = options?.[key];\n\n  if (value === undefined) {\n    return defaultValue;\n  }\n\n  const trimmedValue = value.trim();\n\n  if (trimmedValue === \"\") {\n    return [];\n  }\n\n  return trimmedValue\n    .split(separator)\n    .map((item) => item.trim())\n    .filter((item) => item.length > 0);\n}\n"],"mappings":"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"}

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "@varavel/vdl-plugin-sdk",
-  "version": "0.0.0",
+  "version": "0.1.1",
   "description": "SDK to build plugins for VDL using TypeScript",
   "keywords": [
+    "varavel",
     "vdl",
     "vdl-plugin",
+    "vdl-plugin-sdk",
+    "vdl-sdk",
     "sdk"
   ],
   "homepage": "https://github.com/varavelio/vdl-plugin-sdk#readme",
@@ -17,7 +20,6 @@
   },
   "license": "MIT",
   "author": "Varavel LLC",
-  "sideEffects": false,
   "publishConfig": {
     "access": "public"
   },
@@ -25,17 +27,24 @@
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "bin": {
+    "vdl-plugin": "./bin/vdl-plugin.js"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs",
       "default": "./dist/index.js"
-    }
+    },
+    "./tsconfig.base.json": "./tsconfig.base.json"
   },
   "files": [
+    "bin",
+    "schemas",
     "src",
     "dist",
+    "tsconfig.base.json",
     "README.md",
     "LICENSE"
   ],
@@ -43,13 +52,17 @@
     "ci": "npm run lint && npm run test && npm run build",
     "build": "tsdown",
     "format": "biome format",
-    "lint": "biome check",
+    "lint": "tsc --noEmit && biome check",
     "test": "vitest run"
   },
+  "dependencies": {
+    "esbuild": "0.27.3",
+    "typescript": "5.9.3"
+  },
   "devDependencies": {
     "@biomejs/biome": "2.4.6",
+    "@varavel/vdl": "0.4.0-alpha.5",
     "tsdown": "0.21.0",
-    "typescript": "5.9.3",
     "vitest": "4.0.18"
   }
 }

package/schemas/common/position.vdl

@@ -0,0 +1,14 @@
+"""
+It represents a position within a file and is used for error
+reporting, diagnostics, plugins, and tooling support.
+"""
+type Position {
+  """ Absolute file path """
+  file: string
+
+  """ Line number (1-indexed) """
+  line: int
+
+  """ Column number (1-indexed) """
+  column: int
+}

package/schemas/ir.vdl

@@ -0,0 +1,319 @@
+include "./common/position.vdl"
+
+"""
+IrSchema is the generator-facing representation of a VDL program.
+
+This model is intentionally "flat" and "resolved":
+
+- spreads are already expanded
+- references are already resolved
+- collections are in deterministic order
+
+A code generator should be able to consume IrSchema directly, without needing
+to re-run parser or semantic-analysis logic.
+"""
+type IrSchema {
+  """ Absolute path to the main file that triggered the compilation """
+  entryPoint: string
+
+  """ Constant definitions, sorted by name """
+  constants: ConstantDef[]
+
+  """ Enum definitions, sorted by name """
+  enums: EnumDef[]
+
+  """ Type definitions, sorted by name """
+  types: TypeDef[]
+
+  """ Standalone documentation blocks in source traversal order """
+  docs: TopLevelDoc[]
+}
+
+/********
+* ENUMS *
+********/
+
+""" Kind discriminator for TypeRef """
+enum TypeKind {
+  Primitive = "primitive"
+  Type = "type"
+  Enum = "enum"
+  Array = "array"
+  Map = "map"
+  Object = "object"
+}
+
+""" Primitive scalar type names """
+enum PrimitiveType {
+  String = "string"
+  Int = "int"
+  Float = "float"
+  Bool = "bool"
+  Datetime = "datetime"
+}
+
+""" Underlying storage kind used by an enum """
+enum EnumValueType {
+  String = "string"
+  Int = "int"
+}
+
+"""
+Kind discriminator for LiteralValue.
+
+LiteralValue is used for fully resolved literal data in:
+
+- constant values
+- annotation arguments
+"""
+enum LiteralKind {
+  String = "string"
+  Int = "int"
+  Float = "float"
+  Bool = "bool"
+  Object = "object"
+  Array = "array"
+}
+
+/*******************
+* TYPE SYSTEM CORE *
+*******************/
+
+"""
+Normalized type reference used by fields and constants.
+
+`kind` selects which payload fields are meaningful. Generators should inspect
+`kind` first, then read the related payload fields.
+"""
+type TypeRef {
+  """ Type category discriminator """
+  kind: TypeKind
+
+  """ Primitive type name when `kind` is `primitive` """
+  primitiveName?: PrimitiveType
+
+  """ Referenced type name when `kind` is `type` """
+  typeName?: string
+
+  """ Referenced enum name when `kind` is `enum` """
+  enumName?: string
+
+  """ Referenced enum underlying kind when `kind` is `enum` """
+  enumType?: EnumValueType
+
+  """ Element type when `kind` is `array` """
+  arrayType?: TypeRef
+
+  """ Array rank when `kind` is `array` (for example, 2 for `T[][]`) """
+  arrayDims?: int
+
+  """ Map value type when `kind` is `map` """
+  mapType?: TypeRef
+
+  """ Inline object fields when `kind` is `object` """
+  objectFields?: Field[]
+}
+
+"""
+Annotation metadata preserved in IR.
+
+`name` is the annotation identifier without the `@` prefix.
+`argument`, when present, is fully resolved as a LiteralValue.
+"""
+type Annotation {
+  """ Source position of this annotation """
+  position: Position
+
+  """ Annotation name without `@` """
+  name: string
+
+  """ Optional resolved argument payload """
+  argument?: LiteralValue
+}
+
+""" Flattened object/type field definition """
+type Field {
+  """ Source position of this field """
+  position: Position
+
+  """ Field name """
+  name: string
+
+  """ Optional field documentation """
+  doc?: string
+
+  """ True when the field is optional (`?`) """
+  optional: bool
+
+  """ Field annotations in source order """
+  annotations: Annotation[]
+
+  """ Normalized field type reference """
+  typeRef: TypeRef
+}
+
+/*****************
+* RESOLVED VALUE *
+*****************/
+
+"""
+Fully resolved literal value.
+
+The selected payload is determined by `kind`:
+
+- `string` -> `stringValue`
+- `int` -> `intValue`
+- `float` -> `floatValue`
+- `bool` -> `boolValue`
+- `object` -> `objectEntries`
+- `array` -> `arrayItems`
+"""
+type LiteralValue {
+  """ Source position of this literal value """
+  position: Position
+
+  """ Value category discriminator """
+  kind: LiteralKind
+
+  """ Payload for `kind = string` """
+  stringValue?: string
+
+  """ Payload for `kind = int` """
+  intValue?: int
+
+  """ Payload for `kind = float` """
+  floatValue?: float
+
+  """ Payload for `kind = bool` """
+  boolValue?: bool
+
+  """ Payload for `kind = object` """
+  objectEntries?: ObjectEntry[]
+
+  """ Payload for `kind = array` """
+  arrayItems?: LiteralValue[]
+}
+
+""" Key/value pair inside an object LiteralValue payload """
+type ObjectEntry {
+  """ Source position of this key-value pair """
+  position: Position
+
+  """ Object key """
+  key: string
+
+  """ Fully resolved value for this key """
+  value: LiteralValue
+}
+
+/************************
+* TOP LEVEL DEFINITIONS *
+************************/
+
+"""
+Flattened type definition.
+
+All spreads are already expanded. The unified `typeRef` describes what this
+type IS, a primitive, custom reference, map, array, or object with fields.
+"""
+type TypeDef {
+  """
+  Source position of this type definition.
+  Will be zero valued if the type was inferred by the compiler.
+  """
+  position: Position
+
+  """ Type name """
+  name: string
+
+  """ Optional type documentation """
+  doc?: string
+
+  """ Type annotations in source order """
+  annotations: Annotation[]
+
+  """ Unified type reference describing what this type IS """
+  typeRef: TypeRef
+}
+
+"""
+Flattened enum definition.
+
+All enum spreads are already expanded into `members`.
+"""
+type EnumDef {
+  """ Source position of this definition """
+  position: Position
+
+  """ Enum name """
+  name: string
+
+  """ Optional enum documentation """
+  doc?: string
+
+  """ Enum annotations in source order """
+  annotations: Annotation[]
+
+  """ Enum underlying storage kind """
+  enumType: EnumValueType
+
+  """ Enum members in source order after spread expansion """
+  members: EnumMember[]
+}
+
+""" Enum member definition """
+type EnumMember {
+  """ Source position of this member """
+  position: Position
+
+  """ Member name """
+  name: string
+
+  """ Fully resolved member value """
+  value: LiteralValue
+
+  """ Optional member documentation """
+  doc?: string
+
+  """ Member annotations in source order """
+  annotations: Annotation[]
+}
+
+"""
+Fully resolved constant definition.
+
+`typeRef` is explicit or inferred by analysis.
+`value` contains the fully resolved literal payload.
+"""
+type ConstantDef {
+  """ Source position of this definition """
+  position: Position
+
+  """ Constant name """
+  name: string
+
+  """ Optional constant documentation """
+  doc?: string
+
+  """ Constant annotations in source order """
+  annotations: Annotation[]
+
+  """ Normalized constant type reference (explicit or inferred) """
+  typeRef: TypeRef
+
+  """ Fully resolved constant value """
+  value: LiteralValue
+}
+
+"""
+Standalone documentation block.
+
+Used for top-level docstrings that are not attached to a type/enum/constant.
+"""
+type TopLevelDoc {
+  """ Source position of this documentation block """
+  position: Position
+
+  """ Resolved documentation content """
+  content: string
+}

package/schemas/plugin.vdl

@@ -0,0 +1,19 @@
+"""
+VDL Plugin Protocol Schema
+
+This schema defines the exact communication protocol between the VDL compiler
+core and the sandboxed plugin environment (JavaScript via Goja).
+
+## Protocol Overview
+
+1. VDL parses and compiles the schema into an IrSchema.
+2. VDL instantiates a secure JavaScript sandbox using Goja.
+3. VDL invokes the plugin's exported `generate` function, passing a `PluginInput` object.
+4. The `generate` function returns a `PluginOutput` object (or throws a fatal error).
+5. VDL reads the output. If `errors` are present, it aborts and prints them. Otherwise, it writes the `files` to the disk.
+
+A plugin SHOULD be a pure function: `function generate(input: PluginInput): PluginOutput`
+"""
+
+include "./plugin_input.vdl"
+include "./plugin_output.vdl"

package/schemas/plugin_input.vdl

@@ -0,0 +1,30 @@
+include "./ir.vdl"
+
+"""
+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 {
+  """ The VDL binary version (without v prefix, e.g. 1.0.0) """
+  version: string
+
+  """
+  The complete VDL Intermediate Representation.
+
+  Contains all types, enums, constants, and documentation from the compiled
+  schema, fully resolved and ready for code generation.
+  """
+  ir: IrSchema
+
+  """
+  Arbitrary key-value options passed from the `vdl.config.vdl` plugin configuration.
+
+  These allow users to customize plugin behavior without modifying the plugin
+  itself. Common use cases include specifying target frameworks, API versions,
+  naming conventions, or feature flags.
+  """
+  options: map<string>
+}

package/schemas/plugin_output.vdl

@@ -0,0 +1,72 @@
+include "./common/position.vdl"
+
+"""
+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 {
+  """
+  List of virtual files generated by the plugin.
+
+  Each file specifies a relative path within the output directory and its
+  complete textual content. Paths may include subdirectories which VDL
+  will create automatically.
+
+  If no files are returned, VDL will not write anything.
+  """
+  files?: PluginOutputFile[]
+
+  """
+  List of semantic errors encountered by the plugin.
+
+  If present, VDL will stop the compilation and display them to the user.
+  """
+  errors?: PluginOutputError[]
+}
+
+"""
+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 {
+  """
+  Relative path from the output directory where this file should be written.
+
+  May include subdirectory separators (e.g., "src/models/user.py").
+  Forward slashes are normalized to the appropriate separator for the
+  current operating system.
+  """
+  path: string
+
+  """
+  The complete textual content of the generated file.
+
+  This should be the final, formatted output ready to be written to disk.
+  VDL writes this content as-is without additional processing.
+  """
+  content: string
+}
+
+"""
+A structured error reported by the plugin.
+"""
+type PluginOutputError {
+  """ Human-readable error message explaining what went wrong """
+  message: string
+
+  """
+  Optional source position associated with this error.
+  If provided, VDL will print a beautiful snippet highlighting the exact code.
+  If omitted, the error is treated as a global configuration/plugin error.
+  """
+  position?: Position
+}