@jakubmazanec/template 2.0.17-next.fac374fa → 2.0.17-unstable.2468857d

package/build/Template.js

@@ -1,4 +1,6 @@
-"use strict";
+import { NO_INFERRED_PARSER_REGEXP } from "./constants.js";
+import { templateAttributesSchema } from "./TemplateAttributes.js";
+import { TemplateError } from "./TemplateError.js";
 import ejs from "ejs";
 import fs from "fs-extra";
 import matter from "gray-matter";
@@ -6,158 +8,145 @@ import _ from "lodash";
 import path from "node:path";
 import prettier from "prettier";
 import yaml from "yaml";
-import { NO_INFERRED_PARSER_REGEXP } from "./constants.js";
-import { templateAttributesSchema } from "./TemplateAttributes.js";
-import { TemplateError } from "./TemplateError.js";
-export class Template {
-  /** Template path. */
-  path;
-  /** Template content. Templates are written in [EJS](https://ejs.co/). */
-  content;
-  /** Template attributes. These control how the template is rendered. Some attributes can be written in [EJS](https://ejs.co/) and are rendered before the template content is rendered. It is expected that attribute `if` renders to a string that can be parsed as YAML value; if that value is `false`, the rendering is cancelled. Attribute `to` is also rendered and it represents the path of file the resulting template render is supposed to be written into (by the user). Attribute `variables` is an object that is merged with the data object before rendering. If attribute `variables` is an array of objects, that leads to multiple renders, each with different variables object merged with the data. Each variable that is a string is also rendered. */
-  attributes;
-  /** Template function. */
-  fn;
-  /** Zod schema for custom template attributes. */
-  attributesSchema;
-  /** Zod schema for template data. */
-  dataSchema;
-  constructor({
-    path: templatePath,
-    content,
-    attributes,
-    attributesSchema,
-    dataSchema
-  }) {
-    if (templatePath) {
-      this.path = templatePath;
-    }
-    this.content = content;
-    this.attributes = attributes;
-    this.fn = ejs.compile(this.content);
-    if (attributesSchema) {
-      this.attributesSchema = attributesSchema;
-    } else {
-      this.attributesSchema = null;
-    }
-    if (dataSchema) {
-      this.dataSchema = dataSchema;
-    } else {
-      this.dataSchema = null;
-    }
-  }
-  /**
-   * Reads a template from a file.
-   *
-   * @param templatePath Path to the template file.
-   */
-  static async read(templatePath, options) {
-    let { data: rawAttributes, content } = matter(await fs.readFile(templatePath, "utf8"));
-    if (typeof rawAttributes.extends === "string" && rawAttributes.extends) {
-      let extendedTemplate = await Template.read(
-        path.join(path.dirname(templatePath), rawAttributes.extends),
-        options
-      );
-      rawAttributes = _.merge(extendedTemplate.attributes, rawAttributes);
-      if (!content.trim()) {
-        content = extendedTemplate.content;
-      }
-    }
-    let attributesSchema = options?.attributesSchema ? templateAttributesSchema.merge(options.attributesSchema) : templateAttributesSchema;
-    let attributesParseResult = attributesSchema.safeParse(rawAttributes);
-    if (!attributesParseResult.success) {
-      throw new TemplateError("INVALID_ATTRIBUTES", {
-        cause: attributesParseResult.error,
-        data: {
-          path: templatePath,
-          zodIssues: attributesParseResult.error.issues
-        }
-      });
-    }
-    let attributes = attributesParseResult.data;
-    return new this({
-      path: templatePath,
-      attributes,
-      content,
-      attributesSchema: options?.attributesSchema,
-      dataSchema: options?.dataSchema
-    });
-  }
-  /**
-   * Reads a template from a file and then renders it.
-   *
-   * @param templatePath Path to the template file.
-   * @param data Data used for rendering the template.
-   * @param options Options object.
-   * @return Template renders.
-   */
-  static async readAndRender(templatePath, data, options) {
-    let template = await Template.read(templatePath, {
-      attributesSchema: options?.attributesSchema,
-      dataSchema: options?.dataSchema
-    });
-    return template.render(data, {
-      prettierOptions: options?.prettierOptions,
-      disablePrettier: options?.disablePrettier
-    });
-  }
-  /**
-   * Renders the template using data.
-   *
-   * @param data Data used for rendering the template.
-   * @param options Options object.
-   * @return Template renders.
-   */
-  async render(data, options) {
-    let renders = [];
-    for (let variables of Array.isArray(this.attributes.variables) ? this.attributes.variables : [this.attributes.variables]) {
-      let renderedAttributes = _.omit(this.attributes, ["if"]);
-      let renderedVariables = variables;
-      if (renderedVariables) {
-        for (let [variableName, variableValue] of Object.entries(renderedVariables)) {
-          if (typeof variableValue === "string") {
-            renderedVariables[variableName] = ejs.render(variableValue, { ...data });
-          } else {
-            renderedVariables[variableName] = variableValue;
-          }
-        }
-        renderedAttributes.variables = renderedVariables;
-      }
-      let dataWithAttributes = { ...data, attributes: renderedAttributes };
-      if (this.attributes.if) {
-        let renderedIf = ejs.render(this.attributes.if, dataWithAttributes);
-        let parsedIf = yaml.parse(renderedIf);
-        if (parsedIf === false) {
-          continue;
-        }
-      }
-      renderedAttributes.to = ejs.render(renderedAttributes.to, dataWithAttributes);
-      dataWithAttributes.attributes = renderedAttributes;
-      let content;
-      try {
-        content = this.fn(dataWithAttributes);
-      } catch (error) {
-        throw new TemplateError("FAILED_RENDER", { cause: error });
-      }
-      if (!options?.disablePrettier) {
-        try {
-          content = await prettier.format(content, {
-            ...options?.prettierOptions,
-            filepath: renderedAttributes.to
-          });
-        } catch (error) {
-          if (!NO_INFERRED_PARSER_REGEXP.test(error.message)) {
-            throw new TemplateError("FAILED_FORMAT", { cause: error });
-          }
-        }
-      }
-      renders.push({
-        attributes: renderedAttributes,
-        data: data ?? null,
-        content
-      });
-    }
-    return renders;
-  }
-}
-//# sourceMappingURL=Template.js.map
+
+//#region source/Template.ts
+/**
+* The `Template` object stores all information about a template and has methods for reading and rendering.
+*
+* ```TypeScript
+* let template = new Template({
+*   content: '<%- value %>',
+*   attributes: {
+*     to: 'value.txt',
+*   },
+*   dataSchema: z.object({value: z.number()}),
+* });
+*
+* console.log(await template.render({value: 42})); // ->  [{attributes: {to: 'value.txt'}, data: {value: 42}, content: '42'}]
+* ```
+*
+* @typeParam A A Zod schema type used to define the custom template attributes type.
+* @typeParam D A Zod schema type used to define the template datatype.
+*/
+var Template = class Template {
+	/** Template path. */
+	path;
+	/** Template content. Templates are written in [EJS](https://ejs.co/). */
+	content;
+	/** Template attributes. These control how the template is rendered. Some attributes can be written in [EJS](https://ejs.co/) and are rendered before the template content is rendered. It is expected that attribute `if` renders to a string that can be parsed as YAML value; if that value is `false`, the rendering is cancelled. Attribute `to` is also rendered and it represents the path of file the resulting template render is supposed to be written into (by the user). Attribute `variables` is an object that is merged with the data object before rendering. If attribute `variables` is an array of objects, that leads to multiple renders, each with different variables object merged with the data. Each variable that is a string is also rendered. */
+	attributes;
+	/** Template function. */
+	fn;
+	/** Zod schema for custom template attributes. */
+	attributesSchema;
+	/** Zod schema for template data. */
+	dataSchema;
+	constructor({ path: templatePath, content, attributes, attributesSchema, dataSchema }) {
+		if (templatePath) this.path = templatePath;
+		this.content = content;
+		this.attributes = attributes;
+		this.fn = ejs.compile(this.content);
+		if (attributesSchema) this.attributesSchema = attributesSchema;
+		else this.attributesSchema = null;
+		if (dataSchema) this.dataSchema = dataSchema;
+		else this.dataSchema = null;
+	}
+	/**
+	* Reads a template from a file.
+	*
+	* @param templatePath Path to the template file.
+	*/
+	static async read(templatePath, options) {
+		let { data: rawAttributes, content } = matter(await fs.readFile(templatePath, "utf8"));
+		if (typeof rawAttributes.extends === "string" && rawAttributes.extends) {
+			let extendedTemplate = await Template.read(path.join(path.dirname(templatePath), rawAttributes.extends), options);
+			rawAttributes = _.merge(extendedTemplate.attributes, rawAttributes);
+			if (!content.trim()) content = extendedTemplate.content;
+		}
+		let attributesParseResult = (options?.attributesSchema ? templateAttributesSchema.merge(options.attributesSchema) : templateAttributesSchema).safeParse(rawAttributes);
+		if (!attributesParseResult.success) throw new TemplateError("INVALID_ATTRIBUTES", {
+			cause: attributesParseResult.error,
+			data: {
+				path: templatePath,
+				zodIssues: attributesParseResult.error.issues
+			}
+		});
+		let attributes = attributesParseResult.data;
+		return new this({
+			path: templatePath,
+			attributes,
+			content,
+			attributesSchema: options?.attributesSchema,
+			dataSchema: options?.dataSchema
+		});
+	}
+	/**
+	* Reads a template from a file and then renders it.
+	*
+	* @param templatePath Path to the template file.
+	* @param data Data used for rendering the template.
+	* @param options Options object.
+	* @return Template renders.
+	*/
+	static async readAndRender(templatePath, data, options) {
+		return (await Template.read(templatePath, {
+			attributesSchema: options?.attributesSchema,
+			dataSchema: options?.dataSchema
+		})).render(data, {
+			prettierOptions: options?.prettierOptions,
+			disablePrettier: options?.disablePrettier
+		});
+	}
+	/**
+	* Renders the template using data.
+	*
+	* @param data Data used for rendering the template.
+	* @param options Options object.
+	* @return Template renders.
+	*/
+	async render(data, options) {
+		let renders = [];
+		for (let variables of Array.isArray(this.attributes.variables) ? this.attributes.variables : [this.attributes.variables]) {
+			let renderedAttributes = _.omit(this.attributes, ["if"]);
+			let renderedVariables = variables;
+			if (renderedVariables) {
+				for (let [variableName, variableValue] of Object.entries(renderedVariables)) if (typeof variableValue === "string") renderedVariables[variableName] = ejs.render(variableValue, { ...data });
+				else renderedVariables[variableName] = variableValue;
+				renderedAttributes.variables = renderedVariables;
+			}
+			let dataWithAttributes = {
+				...data,
+				attributes: renderedAttributes
+			};
+			if (this.attributes.if) {
+				let renderedIf = ejs.render(this.attributes.if, dataWithAttributes);
+				if (yaml.parse(renderedIf) === false) continue;
+			}
+			renderedAttributes.to = ejs.render(renderedAttributes.to, dataWithAttributes);
+			dataWithAttributes.attributes = renderedAttributes;
+			let content;
+			try {
+				content = this.fn(dataWithAttributes);
+			} catch (error) {
+				throw new TemplateError("FAILED_RENDER", { cause: error });
+			}
+			if (!options?.disablePrettier) try {
+				content = await prettier.format(content, {
+					...options?.prettierOptions,
+					filepath: renderedAttributes.to
+				});
+			} catch (error) {
+				if (!NO_INFERRED_PARSER_REGEXP.test(error.message)) throw new TemplateError("FAILED_FORMAT", { cause: error });
+			}
+			renders.push({
+				attributes: renderedAttributes,
+				data: data ?? null,
+				content
+			});
+		}
+		return renders;
+	}
+};
+
+//#endregion
+export { Template };

package/build/TemplateAttributes.js

@@ -1,10 +1,16 @@
-"use strict";
-import { z } from "zod";
 import { templateVariablesSchema } from "./TemplateVariables.js";
-export const templateAttributesSchema = z.object({
-  extends: z.string().optional(),
-  to: z.string(),
-  if: z.string().optional(),
-  variables: templateVariablesSchema.optional()
+import { z } from "zod";
+
+//#region source/TemplateAttributes.ts
+/**
+* Zod schema for {@link TemplateAttributes}.
+*/
+const templateAttributesSchema = z.object({
+	extends: z.string().optional(),
+	to: z.string(),
+	if: z.string().optional(),
+	variables: templateVariablesSchema.optional()
 }).strict();
-//# sourceMappingURL=TemplateAttributes.js.map
+
+//#endregion
+export { templateAttributesSchema };

package/build/TemplateError.js

@@ -1,16 +1,18 @@
-"use strict";
 import { createCustomErrorWithData } from "@jakubmazanec/error";
-export const TemplateError = createCustomErrorWithData(
-  "TemplateError",
-  {
-    INVALID_ATTRIBUTES: "Invalid template attributes.",
-    FAILED_FORMAT: "Template render formatting has failed.",
-    FAILED_RENDER: "Template rendering has failed."
-  },
-  class TemplateErrorData {
-    template;
-    path;
-    zodIssues;
-  }
-);
-//# sourceMappingURL=TemplateError.js.map
+
+//#region source/TemplateError.ts
+/**
+* A subclass of `Error` that indicates a template  failure.
+*/
+const TemplateError = createCustomErrorWithData("TemplateError", {
+	INVALID_ATTRIBUTES: "Invalid template attributes.",
+	FAILED_FORMAT: "Template render formatting has failed.",
+	FAILED_RENDER: "Template rendering has failed."
+}, class TemplateErrorData {
+	template;
+	path;
+	zodIssues;
+});
+
+//#endregion
+export { TemplateError };

package/build/TemplateVariables.js

@@ -1,7 +1,10 @@
-"use strict";
-import * as z from "zod";
-export const templateVariablesSchema = z.union([
-  z.record(z.string(), z.unknown()),
-  z.array(z.record(z.string(), z.unknown()))
-]);
-//# sourceMappingURL=TemplateVariables.js.map
+import * as z$1 from "zod";
+
+//#region source/TemplateVariables.ts
+/**
+* Zod schema for {@link TemplateAttributesVariables}.
+*/
+const templateVariablesSchema = z$1.union([z$1.record(z$1.string(), z$1.unknown()), z$1.array(z$1.record(z$1.string(), z$1.unknown()))]);
+
+//#endregion
+export { templateVariablesSchema };

package/build/constants.js

@@ -1,3 +1,5 @@
-"use strict";
-export const NO_INFERRED_PARSER_REGEXP = /parser.*inferred/i;
-//# sourceMappingURL=constants.js.map
+//#region source/constants.ts
+const NO_INFERRED_PARSER_REGEXP = /parser.*inferred/i;
+
+//#endregion
+export { NO_INFERRED_PARSER_REGEXP };

package/build/main.js

@@ -1,6 +1,6 @@
-"use strict";
-export * from "./Template.js";
-export * from "./TemplateAttributes.js";
-export * from "./TemplateError.js";
-export * from "./TemplateVariables.js";
-//# sourceMappingURL=main.js.map
+import { templateVariablesSchema } from "./TemplateVariables.js";
+import { templateAttributesSchema } from "./TemplateAttributes.js";
+import { TemplateError } from "./TemplateError.js";
+import { Template } from "./Template.js";
+
+export { Template, TemplateError, templateAttributesSchema, templateVariablesSchema };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jakubmazanec/template",
-  "version": "2.0.17-next.fac374fa",
+  "version": "2.0.17-unstable.2468857d",
   "description": "TypeScript-first library for working with templates using EJS and Zod.",
   "repository": {
     "type": "git",
@@ -17,9 +17,9 @@
     "source"
   ],
   "scripts": {
-    "build": "del-cli build tsconfig.tsbuildinfo && esbuild \"source/**/*\" --platform=node --target=node24.3 --outdir=build --sourcemap && tsc",
+    "build": "del-cli build tsconfig.tsbuildinfo && tsdown && tsc",
     "clean": "del-cli coverage build *.tsbuildinfo",
-    "develop": "concurrently \"esbuild \"source/**/*\" --platform=node --target=node24.3 --outdir=build --sourcemap --watch\" \"tsc --watch\"",
+    "develop": "concurrently \"tsdown --watch\" \"tsc --watch\"",
     "document": "del-cli docs && typedoc --options typedoc.config.cjs",
     "format": "prettier . --write --ignore-unknown",
     "lint": "eslint .",
@@ -27,7 +27,7 @@
     "typecheck": "tsc --project tsconfig.typecheck.json"
   },
   "dependencies": {
-    "@jakubmazanec/error": "3.0.16-next.fac374fa",
+    "@jakubmazanec/error": "3.0.16-unstable.2468857d",
     "ejs": "^3.1.10",
     "fs-extra": "^11.3.2",
     "gray-matter": "^4.0.3",
@@ -37,7 +37,7 @@
     "zod": "^4.1.13"
   },
   "devDependencies": {
-    "@jakubmazanec/eslint-config": "4.1.10-next.fac374fa",
+    "@jakubmazanec/eslint-config": "4.1.10-unstable.2468857d",
     "@types/ejs": "^3.1.5",
     "@types/fs-extra": "^11.0.4",
     "@types/lodash": "^4.17.21",
@@ -45,9 +45,9 @@
     "@vitest/coverage-v8": "^3.2.4",
     "concurrently": "^9.2.1",
     "del-cli": "^6.0.0",
-    "esbuild": "^0.27.0",
     "eslint": "^9.33.0",
     "prettier-plugin-packagejson": "^2.5.19",
+    "tsdown": "^0.17.2",
     "typedoc": "^0.28.14",
     "typedoc-plugin-markdown": "^4.9.0",
     "typescript": "^5.9.3",

package/build/Template.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../source/Template.ts"],
-  "sourcesContent": ["import ejs from 'ejs';\nimport fs from 'fs-extra';\nimport matter from 'gray-matter';\nimport _ from 'lodash';\nimport path from 'node:path';\nimport prettier from 'prettier';\nimport yaml from 'yaml';\nimport {type z, type ZodObject} from 'zod';\n\nimport {NO_INFERRED_PARSER_REGEXP} from './constants.js';\nimport {type TemplateAttributes, templateAttributesSchema} from './TemplateAttributes.js';\nimport {TemplateError} from './TemplateError.js';\nimport {type TemplateFunction} from './TemplateFunction.js';\nimport {type TemplateRender} from './TemplateRender.js';\nimport {type TemplateRenders} from './TemplateRenders.js';\n\nexport type TemplateOptions<\n  A extends ZodObject | undefined = undefined,\n  D extends ZodObject | undefined = undefined,\n> = {\n  /** Template path. */\n  path?: string;\n\n  /** Template content. */\n  content: string;\n\n  /** Template attributes.  */\n  attributes: A extends undefined ? TemplateAttributes\n  : TemplateAttributes & z.infer<NonNullable<A>>;\n\n  /** Zod schema for custom template attributes. */\n  attributesSchema?: A | undefined;\n\n  /** Zod schema for template data. */\n  dataSchema?: D | undefined;\n};\n\nexport type TemplateReadOptions<\n  A extends ZodObject | undefined = undefined,\n  D extends ZodObject | undefined = undefined,\n> = {\n  /** Zod schema for custom template attributes. */\n  attributesSchema?: A | undefined;\n\n  /** Zod schema for template data. */\n  dataSchema?: D | undefined;\n};\n\nexport type TemplateReadAndRenderOptions<\n  A extends ZodObject | undefined = undefined,\n  D extends ZodObject | undefined = undefined,\n> = {\n  /** Prettier options.  */\n  prettierOptions?: prettier.Options | undefined;\n\n  /** Disable formatting the rendered template using Prettier.  */\n  disablePrettier?: boolean | undefined;\n\n  /** Zod schema for custom template attributes. */\n  attributesSchema?: A | undefined;\n\n  /** Zod schema for template data. */\n  dataSchema?: D | undefined;\n};\n\nexport type TemplateRenderOptions = {\n  /** Prettier options.  */\n  prettierOptions?: prettier.Options | undefined;\n\n  /** Disable formatting the rendered template using Prettier.  */\n  disablePrettier?: boolean | undefined;\n};\n\n/**\n * The `Template` object stores all information about a template and has methods for reading and rendering.\n *\n * ```TypeScript\n * let template = new Template({\n *   content: '<%- value %>',\n *   attributes: {\n *     to: 'value.txt',\n *   },\n *   dataSchema: z.object({value: z.number()}),\n * });\n *\n * console.log(await template.render({value: 42})); // ->  [{attributes: {to: 'value.txt'}, data: {value: 42}, content: '42'}]\n * ```\n *\n * @typeParam A A Zod schema type used to define the custom template attributes type.\n * @typeParam D A Zod schema type used to define the template datatype.\n */\nexport class Template<\n  A extends ZodObject | undefined = undefined,\n  D extends ZodObject | undefined = undefined,\n> {\n  /** Template path. */\n  path?: string;\n\n  /** Template content. Templates are written in [EJS](https://ejs.co/). */\n  readonly content: string;\n\n  /** Template attributes. These control how the template is rendered. Some attributes can be written in [EJS](https://ejs.co/) and are rendered before the template content is rendered. It is expected that attribute `if` renders to a string that can be parsed as YAML value; if that value is `false`, the rendering is cancelled. Attribute `to` is also rendered and it represents the path of file the resulting template render is supposed to be written into (by the user). Attribute `variables` is an object that is merged with the data object before rendering. If attribute `variables` is an array of objects, that leads to multiple renders, each with different variables object merged with the data. Each variable that is a string is also rendered. */\n  readonly attributes: A extends undefined ? TemplateAttributes\n  : TemplateAttributes & z.infer<NonNullable<A>>;\n\n  /** Template function. */\n  private readonly fn: TemplateFunction;\n\n  /** Zod schema for custom template attributes. */\n  readonly attributesSchema: A extends ZodObject ? A : null;\n\n  /** Zod schema for template data. */\n  readonly dataSchema: D extends ZodObject ? D : null;\n\n  constructor({\n    path: templatePath,\n    content,\n    attributes,\n    attributesSchema,\n    dataSchema,\n  }: TemplateOptions<A, D>) {\n    if (templatePath) {\n      this.path = templatePath;\n    }\n\n    this.content = content;\n    this.attributes = attributes;\n    this.fn = ejs.compile(this.content);\n\n    if (attributesSchema) {\n      this.attributesSchema = attributesSchema as A extends ZodObject ? A : null;\n    } else {\n      this.attributesSchema = null as A extends ZodObject ? A : null;\n    }\n\n    if (dataSchema) {\n      this.dataSchema = dataSchema as D extends ZodObject ? D : null;\n    } else {\n      this.dataSchema = null as D extends ZodObject ? D : null;\n    }\n  }\n\n  /**\n   * Reads a template from a file.\n   *\n   * @param templatePath Path to the template file.\n   */\n  static async read<\n    A extends ZodObject | undefined = undefined,\n    D extends ZodObject | undefined = undefined,\n  >(templatePath: string, options?: TemplateReadOptions<A, D>): Promise<Template<A, D>> {\n    let {data: rawAttributes, content} = matter(await fs.readFile(templatePath, 'utf8'));\n\n    // extending another template\n    if (typeof rawAttributes.extends === 'string' && rawAttributes.extends) {\n      let extendedTemplate = await Template.read(\n        path.join(path.dirname(templatePath), rawAttributes.extends),\n        options,\n      ); // you can point to any template, but it will be parsed with the same options, including attribute or data schema\n\n      // attributes are recursively merged\n      rawAttributes = _.merge(extendedTemplate.attributes, rawAttributes);\n\n      // if content is empty, use content from the extended template\n      if (!content.trim()) {\n        content = extendedTemplate.content;\n      }\n    }\n\n    let attributesSchema =\n      options?.attributesSchema ?\n        templateAttributesSchema.merge(options.attributesSchema)\n      : templateAttributesSchema;\n    let attributesParseResult = attributesSchema.safeParse(rawAttributes);\n\n    if (!attributesParseResult.success) {\n      throw new TemplateError('INVALID_ATTRIBUTES', {\n        cause: attributesParseResult.error,\n        data: {\n          path: templatePath,\n          zodIssues: attributesParseResult.error.issues,\n        },\n      });\n    }\n\n    let attributes = attributesParseResult.data;\n\n    return new this({\n      path: templatePath,\n      attributes,\n      content,\n      attributesSchema: options?.attributesSchema,\n      dataSchema: options?.dataSchema,\n    } as TemplateOptions<A, D>);\n  }\n\n  /**\n   * Reads a template from a file and then renders it.\n   *\n   * @param templatePath Path to the template file.\n   * @param data Data used for rendering the template.\n   * @param options Options object.\n   * @return Template renders.\n   */\n  static async readAndRender<\n    A extends ZodObject | undefined = undefined,\n    D extends ZodObject | undefined = undefined,\n  >(\n    templatePath: string,\n    data: D extends undefined ? null : z.infer<NonNullable<D>>,\n    options?: TemplateReadAndRenderOptions<A, D>,\n  ) {\n    let template = await Template.read<A, D>(templatePath, {\n      attributesSchema: options?.attributesSchema,\n      dataSchema: options?.dataSchema,\n    });\n\n    return template.render(data, {\n      prettierOptions: options?.prettierOptions,\n      disablePrettier: options?.disablePrettier,\n    });\n  }\n\n  /**\n   * Renders the template using data.\n   *\n   * @param data Data used for rendering the template.\n   * @param options Options object.\n   * @return Template renders.\n   */\n  async render(\n    data: D extends undefined ? null : z.infer<NonNullable<D>>,\n    options?: TemplateRenderOptions,\n  ): Promise<TemplateRenders<A, D>> {\n    let renders: TemplateRenders<A, D> = [];\n\n    for (let variables of Array.isArray(this.attributes.variables) ?\n      this.attributes.variables\n    : [this.attributes.variables]) {\n      let renderedAttributes = _.omit(this.attributes, ['if']);\n      let renderedVariables = variables;\n\n      if (renderedVariables) {\n        for (let [variableName, variableValue] of Object.entries(renderedVariables)) {\n          if (typeof variableValue === 'string') {\n            renderedVariables[variableName] = ejs.render(variableValue, {...data});\n          } else {\n            renderedVariables[variableName] = variableValue;\n          }\n        }\n\n        renderedAttributes.variables = renderedVariables;\n      }\n\n      let dataWithAttributes = {...data, attributes: renderedAttributes};\n\n      if (this.attributes.if) {\n        let renderedIf = ejs.render(this.attributes.if, dataWithAttributes);\n        let parsedIf = yaml.parse(renderedIf) as unknown;\n\n        if (parsedIf === false) {\n          continue;\n        }\n      }\n\n      renderedAttributes.to = ejs.render(renderedAttributes.to, dataWithAttributes);\n      dataWithAttributes.attributes = renderedAttributes;\n\n      let content;\n\n      try {\n        content = this.fn(dataWithAttributes);\n      } catch (error: unknown) {\n        throw new TemplateError('FAILED_RENDER', {cause: error});\n      }\n\n      if (!options?.disablePrettier) {\n        try {\n          content = await prettier.format(content, {\n            ...options?.prettierOptions,\n            filepath: renderedAttributes.to,\n          });\n        } catch (error: unknown) {\n          if (!NO_INFERRED_PARSER_REGEXP.test((error as Error).message)) {\n            throw new TemplateError('FAILED_FORMAT', {cause: error});\n          }\n        }\n      }\n\n      renders.push({\n        attributes: renderedAttributes,\n        data: data ?? null,\n        content,\n      } as TemplateRender<A, D>);\n    }\n\n    return renders;\n  }\n}\n"],
-  "mappings": ";AAAA,OAAO,SAAS;AAChB,OAAO,QAAQ;AACf,OAAO,YAAY;AACnB,OAAO,OAAO;AACd,OAAO,UAAU;AACjB,OAAO,cAAc;AACrB,OAAO,UAAU;AAGjB,SAAQ,iCAAgC;AACxC,SAAiC,gCAA+B;AAChE,SAAQ,qBAAoB;AAgFrB,aAAM,SAGX;AAAA;AAAA,EAEA;AAAA;AAAA,EAGS;AAAA;AAAA,EAGA;AAAA;AAAA,EAIQ;AAAA;AAAA,EAGR;AAAA;AAAA,EAGA;AAAA,EAET,YAAY;AAAA,IACV,MAAM;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAA0B;AACxB,QAAI,cAAc;AAChB,WAAK,OAAO;AAAA,IACd;AAEA,SAAK,UAAU;AACf,SAAK,aAAa;AAClB,SAAK,KAAK,IAAI,QAAQ,KAAK,OAAO;AAElC,QAAI,kBAAkB;AACpB,WAAK,mBAAmB;AAAA,IAC1B,OAAO;AACL,WAAK,mBAAmB;AAAA,IAC1B;AAEA,QAAI,YAAY;AACd,WAAK,aAAa;AAAA,IACpB,OAAO;AACL,WAAK,aAAa;AAAA,IACpB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,aAAa,KAGX,cAAsB,SAA8D;AACpF,QAAI,EAAC,MAAM,eAAe,QAAO,IAAI,OAAO,MAAM,GAAG,SAAS,cAAc,MAAM,CAAC;AAGnF,QAAI,OAAO,cAAc,YAAY,YAAY,cAAc,SAAS;AACtE,UAAI,mBAAmB,MAAM,SAAS;AAAA,QACpC,KAAK,KAAK,KAAK,QAAQ,YAAY,GAAG,cAAc,OAAO;AAAA,QAC3D;AAAA,MACF;AAGA,sBAAgB,EAAE,MAAM,iBAAiB,YAAY,aAAa;AAGlE,UAAI,CAAC,QAAQ,KAAK,GAAG;AACnB,kBAAU,iBAAiB;AAAA,MAC7B;AAAA,IACF;AAEA,QAAI,mBACF,SAAS,mBACP,yBAAyB,MAAM,QAAQ,gBAAgB,IACvD;AACJ,QAAI,wBAAwB,iBAAiB,UAAU,aAAa;AAEpE,QAAI,CAAC,sBAAsB,SAAS;AAClC,YAAM,IAAI,cAAc,sBAAsB;AAAA,QAC5C,OAAO,sBAAsB;AAAA,QAC7B,MAAM;AAAA,UACJ,MAAM;AAAA,UACN,WAAW,sBAAsB,MAAM;AAAA,QACzC;AAAA,MACF,CAAC;AAAA,IACH;AAEA,QAAI,aAAa,sBAAsB;AAEvC,WAAO,IAAI,KAAK;AAAA,MACd,MAAM;AAAA,MACN;AAAA,MACA;AAAA,MACA,kBAAkB,SAAS;AAAA,MAC3B,YAAY,SAAS;AAAA,IACvB,CAA0B;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,aAAa,cAIX,cACA,MACA,SACA;AACA,QAAI,WAAW,MAAM,SAAS,KAAW,cAAc;AAAA,MACrD,kBAAkB,SAAS;AAAA,MAC3B,YAAY,SAAS;AAAA,IACvB,CAAC;AAED,WAAO,SAAS,OAAO,MAAM;AAAA,MAC3B,iBAAiB,SAAS;AAAA,MAC1B,iBAAiB,SAAS;AAAA,IAC5B,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,OACJ,MACA,SACgC;AAChC,QAAI,UAAiC,CAAC;AAEtC,aAAS,aAAa,MAAM,QAAQ,KAAK,WAAW,SAAS,IAC3D,KAAK,WAAW,YAChB,CAAC,KAAK,WAAW,SAAS,GAAG;AAC7B,UAAI,qBAAqB,EAAE,KAAK,KAAK,YAAY,CAAC,IAAI,CAAC;AACvD,UAAI,oBAAoB;AAExB,UAAI,mBAAmB;AACrB,iBAAS,CAAC,cAAc,aAAa,KAAK,OAAO,QAAQ,iBAAiB,GAAG;AAC3E,cAAI,OAAO,kBAAkB,UAAU;AACrC,8BAAkB,YAAY,IAAI,IAAI,OAAO,eAAe,EAAC,GAAG,KAAI,CAAC;AAAA,UACvE,OAAO;AACL,8BAAkB,YAAY,IAAI;AAAA,UACpC;AAAA,QACF;AAEA,2BAAmB,YAAY;AAAA,MACjC;AAEA,UAAI,qBAAqB,EAAC,GAAG,MAAM,YAAY,mBAAkB;AAEjE,UAAI,KAAK,WAAW,IAAI;AACtB,YAAI,aAAa,IAAI,OAAO,KAAK,WAAW,IAAI,kBAAkB;AAClE,YAAI,WAAW,KAAK,MAAM,UAAU;AAEpC,YAAI,aAAa,OAAO;AACtB;AAAA,QACF;AAAA,MACF;AAEA,yBAAmB,KAAK,IAAI,OAAO,mBAAmB,IAAI,kBAAkB;AAC5E,yBAAmB,aAAa;AAEhC,UAAI;AAEJ,UAAI;AACF,kBAAU,KAAK,GAAG,kBAAkB;AAAA,MACtC,SAAS,OAAgB;AACvB,cAAM,IAAI,cAAc,iBAAiB,EAAC,OAAO,MAAK,CAAC;AAAA,MACzD;AAEA,UAAI,CAAC,SAAS,iBAAiB;AAC7B,YAAI;AACF,oBAAU,MAAM,SAAS,OAAO,SAAS;AAAA,YACvC,GAAG,SAAS;AAAA,YACZ,UAAU,mBAAmB;AAAA,UAC/B,CAAC;AAAA,QACH,SAAS,OAAgB;AACvB,cAAI,CAAC,0BAA0B,KAAM,MAAgB,OAAO,GAAG;AAC7D,kBAAM,IAAI,cAAc,iBAAiB,EAAC,OAAO,MAAK,CAAC;AAAA,UACzD;AAAA,QACF;AAAA,MACF;AAEA,cAAQ,KAAK;AAAA,QACX,YAAY;AAAA,QACZ,MAAM,QAAQ;AAAA,QACd;AAAA,MACF,CAAyB;AAAA,IAC3B;AAEA,WAAO;AAAA,EACT;AACF;",
-  "names": []
-}

package/build/TemplateAttributes.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../source/TemplateAttributes.ts"],
-  "sourcesContent": ["import {z} from 'zod';\n\nimport {templateVariablesSchema} from './TemplateVariables.js';\n\n/**\n * Zod schema for {@link TemplateAttributes}.\n */\nexport const templateAttributesSchema = z\n  .object({\n    extends: z.string().optional(),\n    to: z.string(),\n    if: z.string().optional(),\n    variables: templateVariablesSchema.optional(),\n  })\n  .strict();\n\n/**\n * Type representing template attributes.\n */\nexport type TemplateAttributes = z.infer<typeof templateAttributesSchema>;\n"],
-  "mappings": ";AAAA,SAAQ,SAAQ;AAEhB,SAAQ,+BAA8B;AAK/B,aAAM,2BAA2B,EACrC,OAAO;AAAA,EACN,SAAS,EAAE,OAAO,EAAE,SAAS;AAAA,EAC7B,IAAI,EAAE,OAAO;AAAA,EACb,IAAI,EAAE,OAAO,EAAE,SAAS;AAAA,EACxB,WAAW,wBAAwB,SAAS;AAC9C,CAAC,EACA,OAAO;",
-  "names": []
-}

package/build/TemplateContent.js

@@ -1,2 +0,0 @@
-"use strict";
-//# sourceMappingURL=TemplateContent.js.map

package/build/TemplateContent.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": [],
-  "sourcesContent": [],
-  "mappings": "",
-  "names": []
-}

package/build/TemplateError.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../source/TemplateError.ts"],
-  "sourcesContent": ["import {createCustomErrorWithData} from '@jakubmazanec/error';\nimport {type ZodIssue} from 'zod';\n\nimport {type Template} from './Template.js';\n\n/**\n * A subclass of `Error` that indicates a template  failure.\n */\nexport const TemplateError = createCustomErrorWithData(\n  'TemplateError',\n  {\n    INVALID_ATTRIBUTES: 'Invalid template attributes.',\n    FAILED_FORMAT: 'Template render formatting has failed.',\n    FAILED_RENDER: 'Template rendering has failed.',\n  },\n  class TemplateErrorData {\n    template?: Template;\n    path?: string;\n    zodIssues?: ZodIssue[];\n  },\n);\n"],
-  "mappings": ";AAAA,SAAQ,iCAAgC;AAQjC,aAAM,gBAAgB;AAAA,EAC3B;AAAA,EACA;AAAA,IACE,oBAAoB;AAAA,IACpB,eAAe;AAAA,IACf,eAAe;AAAA,EACjB;AAAA,EACA,MAAM,kBAAkB;AAAA,IACtB;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;",
-  "names": []
-}

package/build/TemplateFunction.js

@@ -1,2 +0,0 @@
-"use strict";
-//# sourceMappingURL=TemplateFunction.js.map

package/build/TemplateFunction.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": [],
-  "sourcesContent": [],
-  "mappings": "",
-  "names": []
-}

package/build/TemplateRender.js

@@ -1,2 +0,0 @@
-"use strict";
-//# sourceMappingURL=TemplateRender.js.map

package/build/TemplateRender.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": [],
-  "sourcesContent": [],
-  "mappings": "",
-  "names": []
-}

package/build/TemplateRenders.js

@@ -1,2 +0,0 @@
-"use strict";
-//# sourceMappingURL=TemplateRenders.js.map

package/build/TemplateRenders.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": [],
-  "sourcesContent": [],
-  "mappings": "",
-  "names": []
-}

package/build/TemplateVariables.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../source/TemplateVariables.ts"],
-  "sourcesContent": ["import * as z from 'zod';\n\n/**\n * Zod schema for {@link TemplateAttributesVariables}.\n */\nexport const templateVariablesSchema = z.union([\n  z.record(z.string(), z.unknown()),\n  z.array(z.record(z.string(), z.unknown())),\n]);\n\n/**\n * Type of `variables`` property of {@link TemplateAttributes}.\n */\nexport type TemplateAttributesVariables = z.infer<typeof templateVariablesSchema>;\n"],
-  "mappings": ";AAAA,YAAY,OAAO;AAKZ,aAAM,0BAA0B,EAAE,MAAM;AAAA,EAC7C,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC;AAAA,EAChC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC,CAAC;AAC3C,CAAC;",
-  "names": []
-}

package/build/constants.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../source/constants.ts"],
-  "sourcesContent": ["export const NO_INFERRED_PARSER_REGEXP = /parser.*inferred/i;\n"],
-  "mappings": ";AAAO,aAAM,4BAA4B;",
-  "names": []
-}

package/build/main.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../source/main.ts"],
-  "sourcesContent": ["export * from './Template.js';\nexport * from './TemplateAttributes.js';\nexport type * from './TemplateContent.js';\nexport * from './TemplateError.js';\nexport type * from './TemplateFunction.js';\nexport type * from './TemplateRender.js';\nexport type * from './TemplateRenders.js';\nexport * from './TemplateVariables.js';\n"],
-  "mappings": ";AAAA,cAAc;AACd,cAAc;AAEd,cAAc;AAId,cAAc;",
-  "names": []
-}