@vertesia/build-tools 1.0.0-dev.20260225.024852Z → 1.0.0-dev.20260227.104700Z

package/lib/cjs/index.js

@@ -19,7 +19,7 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseFrontmatter = exports.TemplateType = exports.PromptRole = exports.PromptDefinitionSchema = exports.SkillPropertiesSchema = exports.SkillDefinitionSchema = exports.promptTransformer = exports.skillCollectionTransformer = exports.rawTransformer = exports.skillTransformer = exports.vertesiaImportPlugin = void 0;
+exports.parseFrontmatter = exports.TemplateType = exports.PromptRole = exports.PromptDefinitionSchema = exports.RenderingTemplateDefinitionSchema = exports.SkillPropertiesSchema = exports.SkillDefinitionSchema = exports.promptTransformer = exports.templateCollectionTransformer = exports.templateTransformer = exports.skillCollectionTransformer = exports.rawTransformer = exports.skillTransformer = exports.vertesiaImportPlugin = void 0;
 // Core plugin
 var plugin_js_1 = require("./plugin.js");
 Object.defineProperty(exports, "vertesiaImportPlugin", { enumerable: true, get: function () { return plugin_js_1.vertesiaImportPlugin; } });
@@ -28,9 +28,12 @@ var index_js_1 = require("./presets/index.js");
 Object.defineProperty(exports, "skillTransformer", { enumerable: true, get: function () { return index_js_1.skillTransformer; } });
 Object.defineProperty(exports, "rawTransformer", { enumerable: true, get: function () { return index_js_1.rawTransformer; } });
 Object.defineProperty(exports, "skillCollectionTransformer", { enumerable: true, get: function () { return index_js_1.skillCollectionTransformer; } });
+Object.defineProperty(exports, "templateTransformer", { enumerable: true, get: function () { return index_js_1.templateTransformer; } });
+Object.defineProperty(exports, "templateCollectionTransformer", { enumerable: true, get: function () { return index_js_1.templateCollectionTransformer; } });
 Object.defineProperty(exports, "promptTransformer", { enumerable: true, get: function () { return index_js_1.promptTransformer; } });
 Object.defineProperty(exports, "SkillDefinitionSchema", { enumerable: true, get: function () { return index_js_1.SkillDefinitionSchema; } });
 Object.defineProperty(exports, "SkillPropertiesSchema", { enumerable: true, get: function () { return index_js_1.SkillPropertiesSchema; } });
+Object.defineProperty(exports, "RenderingTemplateDefinitionSchema", { enumerable: true, get: function () { return index_js_1.RenderingTemplateDefinitionSchema; } });
 Object.defineProperty(exports, "PromptDefinitionSchema", { enumerable: true, get: function () { return index_js_1.PromptDefinitionSchema; } });
 Object.defineProperty(exports, "PromptRole", { enumerable: true, get: function () { return index_js_1.PromptRole; } });
 Object.defineProperty(exports, "TemplateType", { enumerable: true, get: function () { return index_js_1.TemplateType; } });

package/lib/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AAEH,cAAc;AACd,yCAAmD;AAA1C,iHAAA,oBAAoB,OAAA;AAa7B,UAAU;AACV,+CAc4B;AAbxB,4GAAA,gBAAgB,OAAA;AAChB,0GAAA,cAAc,OAAA;AACd,sHAAA,0BAA0B,OAAA;AAC1B,6GAAA,iBAAiB,OAAA;AACjB,iHAAA,qBAAqB,OAAA;AACrB,iHAAA,qBAAqB,OAAA;AACrB,kHAAA,sBAAsB,OAAA;AAKtB,sGAAA,UAAU,OAAA;AACV,wGAAA,YAAY,OAAA;AAGhB,YAAY;AACZ,2DAAoF;AAA3E,kHAAA,gBAAgB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AAEH,cAAc;AACd,yCAAmD;AAA1C,iHAAA,oBAAoB,OAAA;AAa7B,UAAU;AACV,+CAkB4B;AAjBxB,4GAAA,gBAAgB,OAAA;AAChB,0GAAA,cAAc,OAAA;AACd,sHAAA,0BAA0B,OAAA;AAC1B,+GAAA,mBAAmB,OAAA;AACnB,yHAAA,6BAA6B,OAAA;AAC7B,6GAAA,iBAAiB,OAAA;AACjB,iHAAA,qBAAqB,OAAA;AACrB,iHAAA,qBAAqB,OAAA;AACrB,6HAAA,iCAAiC,OAAA;AACjC,kHAAA,sBAAsB,OAAA;AAMtB,sGAAA,UAAU,OAAA;AACV,wGAAA,YAAY,OAAA;AAGhB,YAAY;AACZ,2DAAoF;AAA3E,kHAAA,gBAAgB,OAAA"}

package/lib/cjs/presets/index.js

@@ -3,13 +3,18 @@
  * Preset transformers for common use cases
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TemplateType = exports.PromptRole = exports.PromptDefinitionSchema = exports.promptTransformer = exports.rawTransformer = exports.skillCollectionTransformer = exports.SkillPropertiesSchema = exports.SkillDefinitionSchema = exports.skillTransformer = void 0;
+exports.TemplateType = exports.PromptRole = exports.PromptDefinitionSchema = exports.promptTransformer = exports.rawTransformer = exports.templateCollectionTransformer = exports.RenderingTemplateDefinitionSchema = exports.templateTransformer = exports.skillCollectionTransformer = exports.SkillPropertiesSchema = exports.SkillDefinitionSchema = exports.skillTransformer = void 0;
 var skill_js_1 = require("./skill.js");
 Object.defineProperty(exports, "skillTransformer", { enumerable: true, get: function () { return skill_js_1.skillTransformer; } });
 Object.defineProperty(exports, "SkillDefinitionSchema", { enumerable: true, get: function () { return skill_js_1.SkillDefinitionSchema; } });
 Object.defineProperty(exports, "SkillPropertiesSchema", { enumerable: true, get: function () { return skill_js_1.SkillPropertiesSchema; } });
 var skill_collection_js_1 = require("./skill-collection.js");
 Object.defineProperty(exports, "skillCollectionTransformer", { enumerable: true, get: function () { return skill_collection_js_1.skillCollectionTransformer; } });
+var template_js_1 = require("./template.js");
+Object.defineProperty(exports, "templateTransformer", { enumerable: true, get: function () { return template_js_1.templateTransformer; } });
+Object.defineProperty(exports, "RenderingTemplateDefinitionSchema", { enumerable: true, get: function () { return template_js_1.RenderingTemplateDefinitionSchema; } });
+var template_collection_js_1 = require("./template-collection.js");
+Object.defineProperty(exports, "templateCollectionTransformer", { enumerable: true, get: function () { return template_collection_js_1.templateCollectionTransformer; } });
 var raw_js_1 = require("./raw.js");
 Object.defineProperty(exports, "rawTransformer", { enumerable: true, get: function () { return raw_js_1.rawTransformer; } });
 var prompt_js_1 = require("./prompt.js");

package/lib/cjs/presets/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/presets/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uCAAyI;AAAhI,4GAAA,gBAAgB,OAAA;AAAE,iHAAA,qBAAqB,OAAA;AAAE,iHAAA,qBAAqB,OAAA;AACvE,6DAAmE;AAA1D,iIAAA,0BAA0B,OAAA;AACnC,mCAA0C;AAAjC,wGAAA,cAAc,OAAA;AACvB,yCAAiJ;AAAxI,8GAAA,iBAAiB,OAAA;AAAE,mHAAA,sBAAsB,OAAA;AAAiD,uGAAA,UAAU,OAAA;AAAE,yGAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/presets/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uCAAyI;AAAhI,4GAAA,gBAAgB,OAAA;AAAE,iHAAA,qBAAqB,OAAA;AAAE,iHAAA,qBAAqB,OAAA;AACvE,6DAAmE;AAA1D,iIAAA,0BAA0B,OAAA;AACnC,6CAAyH;AAAhH,kHAAA,mBAAmB,OAAA;AAAE,gIAAA,iCAAiC,OAAA;AAC/D,mEAAyE;AAAhE,uIAAA,6BAA6B,OAAA;AACtC,mCAA0C;AAAjC,wGAAA,cAAc,OAAA;AACvB,yCAAiJ;AAAxI,8GAAA,iBAAiB,OAAA;AAAE,mHAAA,sBAAsB,OAAA;AAAiD,uGAAA,UAAU,OAAA;AAAE,yGAAA,YAAY,OAAA"}

package/lib/cjs/presets/template-collection.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * Template collection transformer for directory-based template imports
+ * Scans a directory for subdirectories containing TEMPLATE.md files
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.templateCollectionTransformer = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+/**
+ * Template collection transformer preset
+ * Transforms directory imports with ?templates suffix into an array of template imports
+ *
+ * Matches:
+ * - ./all?templates (recommended - generates all.js in the directory)
+ * - Any path ending with a filename and ?templates
+ *
+ * NOTE: A filename before ?templates is REQUIRED to avoid naming conflicts.
+ * The filename becomes the output module name.
+ *
+ * @example
+ * ```typescript
+ * import templates from './all?templates';
+ * // Scans current directory for subdirectories with TEMPLATE.md
+ * // Generates all.js containing array of all templates
+ * ```
+ */
+exports.templateCollectionTransformer = {
+    pattern: /\/[^/?]+\?templates$/,
+    virtual: true,
+    transform: (_content, filePath) => {
+        // Remove ?templates suffix and the filename to get directory path
+        const pathWithoutQuery = filePath.replace(/\?templates$/, '');
+        const dirPath = node_path_1.default.dirname(pathWithoutQuery);
+        if (!(0, node_fs_1.existsSync)(dirPath)) {
+            throw new Error(`Directory not found: ${dirPath}`);
+        }
+        if (!(0, node_fs_1.statSync)(dirPath).isDirectory()) {
+            throw new Error(`Not a directory: ${dirPath}`);
+        }
+        // Scan for subdirectories containing TEMPLATE.md
+        const entries = (0, node_fs_1.readdirSync)(dirPath);
+        const imports = [];
+        const names = [];
+        for (const entry of entries) {
+            const entryPath = node_path_1.default.join(dirPath, entry);
+            try {
+                if ((0, node_fs_1.statSync)(entryPath).isDirectory()) {
+                    const templateFile = node_path_1.default.join(entryPath, 'TEMPLATE.md');
+                    if ((0, node_fs_1.existsSync)(templateFile)) {
+                        const identifier = `Template_${entry.replace(/[^a-zA-Z0-9_]/g, '_')}`;
+                        imports.push(`import ${identifier} from './${entry}/TEMPLATE.md';`);
+                        names.push(identifier);
+                    }
+                }
+            }
+            catch (_err) {
+                // Skip entries that can't be read
+                continue;
+            }
+        }
+        if (names.length === 0) {
+            console.warn(`No TEMPLATE.md files found in subdirectories of ${dirPath}`);
+        }
+        // Generate code that imports all templates and exports as array
+        const code = [
+            ...imports,
+            '',
+            `export default [${names.join(', ')}];`
+        ].join('\n');
+        return {
+            data: null,
+            code
+        };
+    }
+};
+//# sourceMappingURL=template-collection.js.map

package/lib/cjs/presets/template-collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-collection.js","sourceRoot":"","sources":["../../../src/presets/template-collection.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;AAEH,qCAA4D;AAC5D,0DAA6B;AAG7B;;;;;;;;;;;;;;;;;GAiBG;AACU,QAAA,6BAA6B,GAAsB;IAC5D,OAAO,EAAE,sBAAsB;IAC/B,OAAO,EAAE,IAAI;IACb,SAAS,EAAE,CAAC,QAAgB,EAAE,QAAgB,EAAE,EAAE;QAC9C,kEAAkE;QAClE,MAAM,gBAAgB,GAAG,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QAC9D,MAAM,OAAO,GAAG,mBAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAE/C,IAAI,CAAC,IAAA,oBAAU,EAAC,OAAO,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAC;QACvD,CAAC;QAED,IAAI,CAAC,IAAA,kBAAQ,EAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,iDAAiD;QACjD,MAAM,OAAO,GAAG,IAAA,qBAAW,EAAC,OAAO,CAAC,CAAC;QACrC,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC1B,MAAM,SAAS,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAE5C,IAAI,CAAC;gBACD,IAAI,IAAA,kBAAQ,EAAC,SAAS,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;oBACpC,MAAM,YAAY,GAAG,mBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;oBACzD,IAAI,IAAA,oBAAU,EAAC,YAAY,CAAC,EAAE,CAAC;wBAC3B,MAAM,UAAU,GAAG,YAAY,KAAK,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,EAAE,CAAC;wBACtE,OAAO,CAAC,IAAI,CAAC,UAAU,UAAU,YAAY,KAAK,gBAAgB,CAAC,CAAC;wBACpE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;oBAC3B,CAAC;gBACL,CAAC;YACL,CAAC;YAAC,OAAO,IAAI,EAAE,CAAC;gBACZ,kCAAkC;gBAClC,SAAS;YACb,CAAC;QACL,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,mDAAmD,OAAO,EAAE,CAAC,CAAC;QAC/E,CAAC;QAED,gEAAgE;QAChE,MAAM,IAAI,GAAG;YACT,GAAG,OAAO;YACV,EAAE;YACF,mBAAmB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;SAC1C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,OAAO;YACH,IAAI,EAAE,IAAI;YACV,IAAI;SACP,CAAC;IACN,CAAC;CACJ,CAAC"}

package/lib/cjs/presets/template.js

@@ -0,0 +1,105 @@
+"use strict";
+/**
+ * Template transformer preset for markdown files with frontmatter
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.templateTransformer = exports.RenderingTemplateDefinitionSchema = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+const zod_1 = require("zod");
+const frontmatter_js_1 = require("../parsers/frontmatter.js");
+const template_asset_discovery_js_1 = require("../utils/template-asset-discovery.js");
+/**
+ * Zod schema for template frontmatter validation.
+ * Only includes fields authored by the user.
+ * The name and id are inferred from the directory structure.
+ */
+const TemplateFrontmatterSchema = zod_1.z.object({
+    title: zod_1.z.string().optional(),
+    description: zod_1.z.string().min(1, 'Template description is required'),
+    tags: zod_1.z.array(zod_1.z.string()).optional(),
+    type: zod_1.z.enum(['presentation', 'document']),
+}).strict();
+/**
+ * MUST be kept in sync with @vertesia/tools-sdk RenderingTemplateDefinition
+ * Zod schema for template definition
+ */
+exports.RenderingTemplateDefinitionSchema = zod_1.z.object({
+    id: zod_1.z.string().min(1, 'Template id is required'),
+    name: zod_1.z.string().min(1, 'Template name is required'),
+    title: zod_1.z.string().optional(),
+    description: zod_1.z.string().min(1, 'Template description is required'),
+    instructions: zod_1.z.string(),
+    tags: zod_1.z.array(zod_1.z.string()).optional(),
+    type: zod_1.z.enum(['presentation', 'document']),
+    assets: zod_1.z.array(zod_1.z.string()),
+}).passthrough();
+/**
+ * Derive the template path segments from the file path.
+ *
+ * Example: .../templates/examples/report/TEMPLATE.md
+ *   → category: "examples", name: "report", relative: "examples/report"
+ */
+function deriveTemplatePathInfo(filePath) {
+    const templateDir = node_path_1.default.dirname(filePath);
+    const templateName = node_path_1.default.basename(templateDir);
+    const collectionDir = node_path_1.default.dirname(templateDir);
+    const category = node_path_1.default.basename(collectionDir);
+    return { category, templateName, relative: `${category}/${templateName}` };
+}
+/**
+ * Template transformer preset
+ * Transforms markdown files with ?template suffix OR TEMPLATE.md files into template definition objects
+ *
+ * Matches:
+ * - Files with ?template suffix: ./my-template.md?template
+ * - TEMPLATE.md files: ./my-template/TEMPLATE.md
+ *
+ * @example
+ * ```typescript
+ * import template1 from './my-template.md?template';
+ * import template2 from './my-template/TEMPLATE.md';
+ * // Both are RenderingTemplateDefinition objects
+ * ```
+ */
+exports.templateTransformer = {
+    pattern: /(\.md\?template$|\/TEMPLATE\.md$)/,
+    schema: exports.RenderingTemplateDefinitionSchema,
+    transform: (content, filePath) => {
+        const { frontmatter, content: markdown } = (0, frontmatter_js_1.parseFrontmatter)(content);
+        // Validate frontmatter
+        const frontmatterValidation = TemplateFrontmatterSchema.safeParse(frontmatter);
+        if (!frontmatterValidation.success) {
+            const errors = frontmatterValidation.error.errors
+                .map((err) => {
+                const pathStr = err.path.length > 0 ? err.path.join('.') : 'frontmatter';
+                return `  - ${pathStr}: ${err.message}`;
+            })
+                .join('\n');
+            throw new Error(`Invalid frontmatter in ${filePath}:\n${errors}`);
+        }
+        // Derive template path from directory structure
+        const { category, templateName, relative: templatePath } = deriveTemplatePathInfo(filePath);
+        // Discover asset files in the template directory
+        const assets = (0, template_asset_discovery_js_1.discoverTemplateAssets)(filePath, templatePath);
+        // Build template definition
+        // Assets use absolute paths for direct server-side resolution
+        const templateData = {
+            id: `${category}:${templateName}`,
+            name: templateName,
+            title: frontmatter.title,
+            description: frontmatter.description,
+            instructions: markdown,
+            tags: frontmatter.tags,
+            type: frontmatter.type,
+            assets: assets.fileNames.map(f => `/templates/${templatePath}/${f}`),
+        };
+        return {
+            data: templateData,
+            assets: assets.assetFiles,
+        };
+    }
+};
+//# sourceMappingURL=template.js.map

package/lib/cjs/presets/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../src/presets/template.ts"],"names":[],"mappings":"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"}

package/lib/cjs/utils/template-asset-discovery.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * Utilities for discovering asset files in template directories
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.discoverTemplateAssets = discoverTemplateAssets;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+/**
+ * Files to exclude from template asset discovery
+ * (source files and the template definition itself)
+ */
+const EXCLUDED_PATTERNS = [
+    /^TEMPLATE\.md$/,
+    /\.ts$/,
+    /\.js$/,
+];
+function isExcluded(fileName) {
+    return EXCLUDED_PATTERNS.some(p => p.test(fileName));
+}
+/**
+ * Discover asset files in a template directory.
+ * All files except TEMPLATE.md, *.ts, and *.js are considered assets.
+ *
+ * @param templateFilePath - Absolute path to the TEMPLATE.md file
+ * @param templatePath - The template path segment (e.g., "examples/report")
+ * @returns Discovered assets and metadata
+ */
+function discoverTemplateAssets(templateFilePath, templatePath) {
+    const templateDir = node_path_1.default.dirname(templateFilePath);
+    const fileNames = [];
+    const assetFiles = [];
+    let files;
+    try {
+        files = (0, node_fs_1.readdirSync)(templateDir).filter(file => {
+            try {
+                return (0, node_fs_1.statSync)(node_path_1.default.join(templateDir, file)).isFile();
+            }
+            catch {
+                return false;
+            }
+        });
+    }
+    catch {
+        files = [];
+    }
+    for (const file of files) {
+        if (isExcluded(file)) {
+            continue;
+        }
+        fileNames.push(file);
+        assetFiles.push({
+            sourcePath: node_path_1.default.join(templateDir, file),
+            destPath: node_path_1.default.join('templates', templatePath, file),
+            type: 'template',
+        });
+    }
+    return { fileNames, assetFiles };
+}
+//# sourceMappingURL=template-asset-discovery.js.map

package/lib/cjs/utils/template-asset-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-asset-discovery.js","sourceRoot":"","sources":["../../../src/utils/template-asset-discovery.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;AAuCH,wDAmCC;AAxED,qCAAgD;AAChD,0DAA6B;AAc7B;;;GAGG;AACH,MAAM,iBAAiB,GAAG;IACtB,gBAAgB;IAChB,OAAO;IACP,OAAO;CACV,CAAC;AAEF,SAAS,UAAU,CAAC,QAAgB;IAChC,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,sBAAsB,CAClC,gBAAwB,EACxB,YAAoB;IAEpB,MAAM,WAAW,GAAG,mBAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACnD,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,UAAU,GAAgB,EAAE,CAAC;IAEnC,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACD,KAAK,GAAG,IAAA,qBAAW,EAAC,WAAW,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;YAC3C,IAAI,CAAC;gBACD,OAAO,IAAA,kBAAQ,EAAC,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;YAC3D,CAAC;YAAC,MAAM,CAAC;gBACL,OAAO,KAAK,CAAC;YACjB,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;IAAC,MAAM,CAAC;QACL,KAAK,GAAG,EAAE,CAAC;IACf,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACnB,SAAS;QACb,CAAC;QAED,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,UAAU,CAAC,IAAI,CAAC;YACZ,UAAU,EAAE,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC;YACxC,QAAQ,EAAE,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,IAAI,CAAC;YACpD,IAAI,EAAE,UAAU;SACnB,CAAC,CAAC;IACP,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;AACrC,CAAC"}

package/lib/esm/index.js

@@ -20,7 +20,7 @@
 // Core plugin
 export { vertesiaImportPlugin } from './plugin.js';
 // Presets
-export { skillTransformer, rawTransformer, skillCollectionTransformer, promptTransformer, SkillDefinitionSchema, SkillPropertiesSchema, PromptDefinitionSchema, PromptRole, TemplateType } from './presets/index.js';
+export { skillTransformer, rawTransformer, skillCollectionTransformer, templateTransformer, templateCollectionTransformer, promptTransformer, SkillDefinitionSchema, SkillPropertiesSchema, RenderingTemplateDefinitionSchema, PromptDefinitionSchema, PromptRole, TemplateType } from './presets/index.js';
 // Utilities
 export { parseFrontmatter } from './parsers/frontmatter.js';
 //# sourceMappingURL=index.js.map

package/lib/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,cAAc;AACd,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAanD,UAAU;AACV,OAAO,EACH,gBAAgB,EAChB,cAAc,EACd,0BAA0B,EAC1B,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EAKtB,UAAU,EACV,YAAY,EACf,MAAM,oBAAoB,CAAC;AAE5B,YAAY;AACZ,OAAO,EAAE,gBAAgB,EAA0B,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,cAAc;AACd,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAanD,UAAU;AACV,OAAO,EACH,gBAAgB,EAChB,cAAc,EACd,0BAA0B,EAC1B,mBAAmB,EACnB,6BAA6B,EAC7B,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,iCAAiC,EACjC,sBAAsB,EAMtB,UAAU,EACV,YAAY,EACf,MAAM,oBAAoB,CAAC;AAE5B,YAAY;AACZ,OAAO,EAAE,gBAAgB,EAA0B,MAAM,0BAA0B,CAAC"}

package/lib/esm/presets/index.js

@@ -3,6 +3,8 @@
  */
 export { skillTransformer, SkillDefinitionSchema, SkillPropertiesSchema } from './skill.js';
 export { skillCollectionTransformer } from './skill-collection.js';
+export { templateTransformer, RenderingTemplateDefinitionSchema } from './template.js';
+export { templateCollectionTransformer } from './template-collection.js';
 export { rawTransformer } from './raw.js';
 export { promptTransformer, PromptDefinitionSchema, PromptRole, TemplateType } from './prompt.js';
 //# sourceMappingURL=index.js.map

package/lib/esm/presets/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/presets/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,qBAAqB,EAA+C,MAAM,YAAY,CAAC;AACzI,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAiD,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/presets/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,qBAAqB,EAA+C,MAAM,YAAY,CAAC;AACzI,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,iCAAiC,EAAoC,MAAM,eAAe,CAAC;AACzH,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAiD,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/lib/esm/presets/template-collection.js

@@ -0,0 +1,74 @@
+/**
+ * Template collection transformer for directory-based template imports
+ * Scans a directory for subdirectories containing TEMPLATE.md files
+ */
+import { readdirSync, statSync, existsSync } from 'node:fs';
+import path from 'node:path';
+/**
+ * Template collection transformer preset
+ * Transforms directory imports with ?templates suffix into an array of template imports
+ *
+ * Matches:
+ * - ./all?templates (recommended - generates all.js in the directory)
+ * - Any path ending with a filename and ?templates
+ *
+ * NOTE: A filename before ?templates is REQUIRED to avoid naming conflicts.
+ * The filename becomes the output module name.
+ *
+ * @example
+ * ```typescript
+ * import templates from './all?templates';
+ * // Scans current directory for subdirectories with TEMPLATE.md
+ * // Generates all.js containing array of all templates
+ * ```
+ */
+export const templateCollectionTransformer = {
+    pattern: /\/[^/?]+\?templates$/,
+    virtual: true,
+    transform: (_content, filePath) => {
+        // Remove ?templates suffix and the filename to get directory path
+        const pathWithoutQuery = filePath.replace(/\?templates$/, '');
+        const dirPath = path.dirname(pathWithoutQuery);
+        if (!existsSync(dirPath)) {
+            throw new Error(`Directory not found: ${dirPath}`);
+        }
+        if (!statSync(dirPath).isDirectory()) {
+            throw new Error(`Not a directory: ${dirPath}`);
+        }
+        // Scan for subdirectories containing TEMPLATE.md
+        const entries = readdirSync(dirPath);
+        const imports = [];
+        const names = [];
+        for (const entry of entries) {
+            const entryPath = path.join(dirPath, entry);
+            try {
+                if (statSync(entryPath).isDirectory()) {
+                    const templateFile = path.join(entryPath, 'TEMPLATE.md');
+                    if (existsSync(templateFile)) {
+                        const identifier = `Template_${entry.replace(/[^a-zA-Z0-9_]/g, '_')}`;
+                        imports.push(`import ${identifier} from './${entry}/TEMPLATE.md';`);
+                        names.push(identifier);
+                    }
+                }
+            }
+            catch (_err) {
+                // Skip entries that can't be read
+                continue;
+            }
+        }
+        if (names.length === 0) {
+            console.warn(`No TEMPLATE.md files found in subdirectories of ${dirPath}`);
+        }
+        // Generate code that imports all templates and exports as array
+        const code = [
+            ...imports,
+            '',
+            `export default [${names.join(', ')}];`
+        ].join('\n');
+        return {
+            data: null,
+            code
+        };
+    }
+};
+//# sourceMappingURL=template-collection.js.map

package/lib/esm/presets/template-collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-collection.js","sourceRoot":"","sources":["../../../src/presets/template-collection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAsB;IAC5D,OAAO,EAAE,sBAAsB;IAC/B,OAAO,EAAE,IAAI;IACb,SAAS,EAAE,CAAC,QAAgB,EAAE,QAAgB,EAAE,EAAE;QAC9C,kEAAkE;QAClE,MAAM,gBAAgB,GAAG,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAE/C,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAC;QACvD,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,iDAAiD;QACjD,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAE5C,IAAI,CAAC;gBACD,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;oBACpC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;oBACzD,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;wBAC3B,MAAM,UAAU,GAAG,YAAY,KAAK,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,EAAE,CAAC;wBACtE,OAAO,CAAC,IAAI,CAAC,UAAU,UAAU,YAAY,KAAK,gBAAgB,CAAC,CAAC;wBACpE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;oBAC3B,CAAC;gBACL,CAAC;YACL,CAAC;YAAC,OAAO,IAAI,EAAE,CAAC;gBACZ,kCAAkC;gBAClC,SAAS;YACb,CAAC;QACL,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,mDAAmD,OAAO,EAAE,CAAC,CAAC;QAC/E,CAAC;QAED,gEAAgE;QAChE,MAAM,IAAI,GAAG;YACT,GAAG,OAAO;YACV,EAAE;YACF,mBAAmB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;SAC1C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,OAAO;YACH,IAAI,EAAE,IAAI;YACV,IAAI;SACP,CAAC;IACN,CAAC;CACJ,CAAC"}

package/lib/esm/presets/template.js

@@ -0,0 +1,99 @@
+/**
+ * Template transformer preset for markdown files with frontmatter
+ */
+import path from 'node:path';
+import { z } from 'zod';
+import { parseFrontmatter } from '../parsers/frontmatter.js';
+import { discoverTemplateAssets } from '../utils/template-asset-discovery.js';
+/**
+ * Zod schema for template frontmatter validation.
+ * Only includes fields authored by the user.
+ * The name and id are inferred from the directory structure.
+ */
+const TemplateFrontmatterSchema = z.object({
+    title: z.string().optional(),
+    description: z.string().min(1, 'Template description is required'),
+    tags: z.array(z.string()).optional(),
+    type: z.enum(['presentation', 'document']),
+}).strict();
+/**
+ * MUST be kept in sync with @vertesia/tools-sdk RenderingTemplateDefinition
+ * Zod schema for template definition
+ */
+export const RenderingTemplateDefinitionSchema = z.object({
+    id: z.string().min(1, 'Template id is required'),
+    name: z.string().min(1, 'Template name is required'),
+    title: z.string().optional(),
+    description: z.string().min(1, 'Template description is required'),
+    instructions: z.string(),
+    tags: z.array(z.string()).optional(),
+    type: z.enum(['presentation', 'document']),
+    assets: z.array(z.string()),
+}).passthrough();
+/**
+ * Derive the template path segments from the file path.
+ *
+ * Example: .../templates/examples/report/TEMPLATE.md
+ *   → category: "examples", name: "report", relative: "examples/report"
+ */
+function deriveTemplatePathInfo(filePath) {
+    const templateDir = path.dirname(filePath);
+    const templateName = path.basename(templateDir);
+    const collectionDir = path.dirname(templateDir);
+    const category = path.basename(collectionDir);
+    return { category, templateName, relative: `${category}/${templateName}` };
+}
+/**
+ * Template transformer preset
+ * Transforms markdown files with ?template suffix OR TEMPLATE.md files into template definition objects
+ *
+ * Matches:
+ * - Files with ?template suffix: ./my-template.md?template
+ * - TEMPLATE.md files: ./my-template/TEMPLATE.md
+ *
+ * @example
+ * ```typescript
+ * import template1 from './my-template.md?template';
+ * import template2 from './my-template/TEMPLATE.md';
+ * // Both are RenderingTemplateDefinition objects
+ * ```
+ */
+export const templateTransformer = {
+    pattern: /(\.md\?template$|\/TEMPLATE\.md$)/,
+    schema: RenderingTemplateDefinitionSchema,
+    transform: (content, filePath) => {
+        const { frontmatter, content: markdown } = parseFrontmatter(content);
+        // Validate frontmatter
+        const frontmatterValidation = TemplateFrontmatterSchema.safeParse(frontmatter);
+        if (!frontmatterValidation.success) {
+            const errors = frontmatterValidation.error.errors
+                .map((err) => {
+                const pathStr = err.path.length > 0 ? err.path.join('.') : 'frontmatter';
+                return `  - ${pathStr}: ${err.message}`;
+            })
+                .join('\n');
+            throw new Error(`Invalid frontmatter in ${filePath}:\n${errors}`);
+        }
+        // Derive template path from directory structure
+        const { category, templateName, relative: templatePath } = deriveTemplatePathInfo(filePath);
+        // Discover asset files in the template directory
+        const assets = discoverTemplateAssets(filePath, templatePath);
+        // Build template definition
+        // Assets use absolute paths for direct server-side resolution
+        const templateData = {
+            id: `${category}:${templateName}`,
+            name: templateName,
+            title: frontmatter.title,
+            description: frontmatter.description,
+            instructions: markdown,
+            tags: frontmatter.tags,
+            type: frontmatter.type,
+            assets: assets.fileNames.map(f => `/templates/${templatePath}/${f}`),
+        };
+        return {
+            data: templateData,
+            assets: assets.assetFiles,
+        };
+    }
+};
+//# sourceMappingURL=template.js.map

package/lib/esm/presets/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../src/presets/template.ts"],"names":[],"mappings":"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"}

package/lib/esm/utils/template-asset-discovery.js

@@ -0,0 +1,57 @@
+/**
+ * Utilities for discovering asset files in template directories
+ */
+import { readdirSync, statSync } from 'node:fs';
+import path from 'node:path';
+/**
+ * Files to exclude from template asset discovery
+ * (source files and the template definition itself)
+ */
+const EXCLUDED_PATTERNS = [
+    /^TEMPLATE\.md$/,
+    /\.ts$/,
+    /\.js$/,
+];
+function isExcluded(fileName) {
+    return EXCLUDED_PATTERNS.some(p => p.test(fileName));
+}
+/**
+ * Discover asset files in a template directory.
+ * All files except TEMPLATE.md, *.ts, and *.js are considered assets.
+ *
+ * @param templateFilePath - Absolute path to the TEMPLATE.md file
+ * @param templatePath - The template path segment (e.g., "examples/report")
+ * @returns Discovered assets and metadata
+ */
+export function discoverTemplateAssets(templateFilePath, templatePath) {
+    const templateDir = path.dirname(templateFilePath);
+    const fileNames = [];
+    const assetFiles = [];
+    let files;
+    try {
+        files = readdirSync(templateDir).filter(file => {
+            try {
+                return statSync(path.join(templateDir, file)).isFile();
+            }
+            catch {
+                return false;
+            }
+        });
+    }
+    catch {
+        files = [];
+    }
+    for (const file of files) {
+        if (isExcluded(file)) {
+            continue;
+        }
+        fileNames.push(file);
+        assetFiles.push({
+            sourcePath: path.join(templateDir, file),
+            destPath: path.join('templates', templatePath, file),
+            type: 'template',
+        });
+    }
+    return { fileNames, assetFiles };
+}
+//# sourceMappingURL=template-asset-discovery.js.map

package/lib/esm/utils/template-asset-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-asset-discovery.js","sourceRoot":"","sources":["../../../src/utils/template-asset-discovery.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,IAAI,MAAM,WAAW,CAAC;AAc7B;;;GAGG;AACH,MAAM,iBAAiB,GAAG;IACtB,gBAAgB;IAChB,OAAO;IACP,OAAO;CACV,CAAC;AAEF,SAAS,UAAU,CAAC,QAAgB;IAChC,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAClC,gBAAwB,EACxB,YAAoB;IAEpB,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACnD,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,UAAU,GAAgB,EAAE,CAAC;IAEnC,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACD,KAAK,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;YAC3C,IAAI,CAAC;gBACD,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;YAC3D,CAAC;YAAC,MAAM,CAAC;gBACL,OAAO,KAAK,CAAC;YACjB,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;IAAC,MAAM,CAAC;QACL,KAAK,GAAG,EAAE,CAAC;IACf,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACnB,SAAS;QACb,CAAC;QAED,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,UAAU,CAAC,IAAI,CAAC;YACZ,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC;YACxC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,IAAI,CAAC;YACpD,IAAI,EAAE,UAAU;SACnB,CAAC,CAAC;IACP,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;AACrC,CAAC"}

package/lib/types/index.d.ts

@@ -19,6 +19,6 @@
  */
 export { vertesiaImportPlugin } from './plugin.js';
 export type { PluginConfig, TransformerRule, TransformerPreset, TransformFunction, TransformResult, AssetFile, WidgetConfig } from './types.js';
-export { skillTransformer, rawTransformer, skillCollectionTransformer, promptTransformer, SkillDefinitionSchema, SkillPropertiesSchema, PromptDefinitionSchema, type SkillDefinition, type SkillContentType, type PromptDefinition, type PromptContentType, PromptRole, TemplateType } from './presets/index.js';
+export { skillTransformer, rawTransformer, skillCollectionTransformer, templateTransformer, templateCollectionTransformer, promptTransformer, SkillDefinitionSchema, SkillPropertiesSchema, RenderingTemplateDefinitionSchema, PromptDefinitionSchema, type SkillDefinition, type SkillContentType, type RenderingTemplateDefinition, type PromptDefinition, type PromptContentType, PromptRole, TemplateType } from './presets/index.js';
 export { parseFrontmatter, type FrontmatterResult } from './parsers/frontmatter.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGnD,YAAY,EACR,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,SAAS,EACT,YAAY,EACf,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,gBAAgB,EAChB,cAAc,EACd,0BAA0B,EAC1B,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,UAAU,EACV,YAAY,EACf,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGnD,YAAY,EACR,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,SAAS,EACT,YAAY,EACf,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,gBAAgB,EAChB,cAAc,EACd,0BAA0B,EAC1B,mBAAmB,EACnB,6BAA6B,EAC7B,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,iCAAiC,EACjC,sBAAsB,EACtB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,2BAA2B,EAChC,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,UAAU,EACV,YAAY,EACf,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}

package/lib/types/presets/index.d.ts

@@ -3,6 +3,8 @@
  */
 export { skillTransformer, SkillDefinitionSchema, SkillPropertiesSchema, type SkillDefinition, type SkillContentType } from './skill.js';
 export { skillCollectionTransformer } from './skill-collection.js';
+export { templateTransformer, RenderingTemplateDefinitionSchema, type RenderingTemplateDefinition } from './template.js';
+export { templateCollectionTransformer } from './template-collection.js';
 export { rawTransformer } from './raw.js';
 export { promptTransformer, PromptDefinitionSchema, type PromptDefinition, type PromptContentType, PromptRole, TemplateType } from './prompt.js';
 //# sourceMappingURL=index.d.ts.map