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

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/presets/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,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,EAAE,KAAK,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/presets/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACzI,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,iCAAiC,EAAE,KAAK,2BAA2B,EAAE,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,EAAE,KAAK,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

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

@@ -55,14 +55,14 @@ export declare const SkillDefinitionSchema: z.ZodObject<{
         template: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         language: string;
+        template?: string | undefined;
         packages?: string[] | undefined;
         system_packages?: string[] | undefined;
-        template?: string | undefined;
     }, {
         language: string;
+        template?: string | undefined;
         packages?: string[] | undefined;
         system_packages?: string[] | undefined;
-        template?: string | undefined;
     }>>;
     related_tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     scripts: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -106,14 +106,14 @@ export declare const SkillDefinitionSchema: z.ZodObject<{
         template: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         language: string;
+        template?: string | undefined;
         packages?: string[] | undefined;
         system_packages?: string[] | undefined;
-        template?: string | undefined;
     }, {
         language: string;
+        template?: string | undefined;
         packages?: string[] | undefined;
         system_packages?: string[] | undefined;
-        template?: string | undefined;
     }>>;
     related_tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     scripts: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -157,14 +157,14 @@ export declare const SkillDefinitionSchema: z.ZodObject<{
         template: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         language: string;
+        template?: string | undefined;
         packages?: string[] | undefined;
         system_packages?: string[] | undefined;
-        template?: string | undefined;
     }, {
         language: string;
+        template?: string | undefined;
         packages?: string[] | undefined;
         system_packages?: string[] | undefined;
-        template?: string | undefined;
     }>>;
     related_tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     scripts: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -217,14 +217,14 @@ export declare const SkillPropertiesSchema: z.ZodObject<{
         template: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         language: string;
+        template?: string | undefined;
         packages?: string[] | undefined;
         system_packages?: string[] | undefined;
-        template?: string | undefined;
     }, {
         language: string;
+        template?: string | undefined;
         packages?: string[] | undefined;
         system_packages?: string[] | undefined;
-        template?: string | undefined;
     }>>>;
     related_tools: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
     scripts: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
@@ -268,14 +268,14 @@ export declare const SkillPropertiesSchema: z.ZodObject<{
         template: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         language: string;
+        template?: string | undefined;
         packages?: string[] | undefined;
         system_packages?: string[] | undefined;
-        template?: string | undefined;
     }, {
         language: string;
+        template?: string | undefined;
         packages?: string[] | undefined;
         system_packages?: string[] | undefined;
-        template?: string | undefined;
     }>>>;
     related_tools: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
     scripts: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
@@ -319,14 +319,14 @@ export declare const SkillPropertiesSchema: z.ZodObject<{
         template: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         language: string;
+        template?: string | undefined;
         packages?: string[] | undefined;
         system_packages?: string[] | undefined;
-        template?: string | undefined;
     }, {
         language: string;
+        template?: string | undefined;
         packages?: string[] | undefined;
         system_packages?: string[] | undefined;
-        template?: string | undefined;
     }>>>;
     related_tools: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
     scripts: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;

package/lib/types/presets/template-collection.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Template collection transformer for directory-based template imports
+ * Scans a directory for subdirectories containing TEMPLATE.md files
+ */
+import type { TransformerPreset } from '../types.js';
+/**
+ * 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 declare const templateCollectionTransformer: TransformerPreset;
+//# sourceMappingURL=template-collection.d.ts.map

package/lib/types/presets/template-collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-collection.d.ts","sourceRoot":"","sources":["../../../src/presets/template-collection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,6BAA6B,EAAE,iBAuD3C,CAAC"}

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

@@ -0,0 +1,58 @@
+/**
+ * Template transformer preset for markdown files with frontmatter
+ */
+import { z } from 'zod';
+import type { TransformerPreset } from '../types.js';
+/**
+ * MUST be kept in sync with @vertesia/tools-sdk RenderingTemplateDefinition
+ * Zod schema for template definition
+ */
+export declare const RenderingTemplateDefinitionSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodString;
+    instructions: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    type: z.ZodEnum<["presentation", "document"]>;
+    assets: z.ZodArray<z.ZodString, "many">;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodString;
+    name: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodString;
+    instructions: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    type: z.ZodEnum<["presentation", "document"]>;
+    assets: z.ZodArray<z.ZodString, "many">;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodString;
+    name: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodString;
+    instructions: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    type: z.ZodEnum<["presentation", "document"]>;
+    assets: z.ZodArray<z.ZodString, "many">;
+}, z.ZodTypeAny, "passthrough">>;
+/**
+ * TypeScript type inferred from the Zod schema
+ */
+export type RenderingTemplateDefinition = z.infer<typeof RenderingTemplateDefinitionSchema>;
+/**
+ * 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 declare const templateTransformer: TransformerPreset;
+//# sourceMappingURL=template.d.ts.map

package/lib/types/presets/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../../src/presets/template.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAgBrD;;;GAGG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAS9B,CAAC;AAEjB;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAgB5F;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,mBAAmB,EAAE,iBA4CjC,CAAC"}

package/lib/types/types.d.ts

@@ -12,7 +12,7 @@ export interface AssetFile {
     /** Relative destination path within assets directory */
     destPath: string;
     /** Asset type for categorization */
-    type: 'script';
+    type: 'script' | 'template';
 }
 /**
  * Result of a transform function

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IAEnB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IAEjB,oCAAoC;IACpC,IAAI,EAAE,QAAQ,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,sDAAsD;IACtD,IAAI,EAAE,OAAO,CAAC;IAEd,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,+CAA+C;IAC/C,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IAErB,gDAAgD;IAChD,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,KACf,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAEhB,iDAAiD;IACjD,SAAS,EAAE,iBAAiB,CAAC;IAE7B,0CAA0C;IAC1C,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAExB,qFAAqF;IACrF,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAErC;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,0CAA0C;IAC1C,YAAY,EAAE,eAAe,EAAE,CAAC;IAEhC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAE3B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAEhD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,YAAY,KAAK,MAAM,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IAEnB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IAEjB,oCAAoC;IACpC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,sDAAsD;IACtD,IAAI,EAAE,OAAO,CAAC;IAEd,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,+CAA+C;IAC/C,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IAErB,gDAAgD;IAChD,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,KACf,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAEhB,iDAAiD;IACjD,SAAS,EAAE,iBAAiB,CAAC;IAE7B,0CAA0C;IAC1C,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAExB,qFAAqF;IACrF,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAErC;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,0CAA0C;IAC1C,YAAY,EAAE,eAAe,EAAE,CAAC;IAEhC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAE3B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAEhD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,YAAY,KAAK,MAAM,CAAC"}

package/lib/types/utils/template-asset-discovery.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Utilities for discovering asset files in template directories
+ */
+import type { AssetFile } from '../types.js';
+/**
+ * Discovered assets in a template directory
+ */
+export interface DiscoveredTemplateAssets {
+    /** Asset file names (relative to template dir) */
+    fileNames: string[];
+    /** Asset files to be copied */
+    assetFiles: AssetFile[];
+}
+/**
+ * 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 declare function discoverTemplateAssets(templateFilePath: string, templatePath: string): DiscoveredTemplateAssets;
+//# sourceMappingURL=template-asset-discovery.d.ts.map

package/lib/types/utils/template-asset-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-asset-discovery.d.ts","sourceRoot":"","sources":["../../../src/utils/template-asset-discovery.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,kDAAkD;IAClD,SAAS,EAAE,MAAM,EAAE,CAAC;IAEpB,+BAA+B;IAC/B,UAAU,EAAE,SAAS,EAAE,CAAC;CAC3B;AAgBD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAClC,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,MAAM,GACrB,wBAAwB,CAgC1B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertesia/build-tools",
-  "version": "1.0.0-dev.20260225.024852Z",
+  "version": "1.0.0-dev.20260227.112605Z",
   "description": "Build tools for Vertesia projects - Rollup and Vite plugins for transforming imports, bundling skills, and compiling widgets",
   "type": "module",
   "main": "./lib/esm/index.js",
@@ -20,8 +20,8 @@
     "@rollup/plugin-node-resolve": "^16.0.1",
     "@rollup/plugin-typescript": "^12.1.2",
     "@types/node": "^25.0.3",
-    "rollup": "^4.40.2",
-    "rollup-plugin-terser": "^7.0.2",
+    "rollup": "^4.59.0",
+    "@rollup/plugin-terser": "^0.4.4",
     "ts-dual-module": "^0.6.3",
     "typescript": "^5.9.3",
     "vitest": "^4.0.16"
@@ -29,11 +29,11 @@
   "dependencies": {
     "gray-matter": "^4.0.3",
     "zod": "^3.24.1",
-    "@llumiverse/common": "1.0.0-dev.20260224.234313Z",
-    "@vertesia/common": "1.0.0-dev.20260225.024852Z"
+    "@vertesia/common": "1.0.0-dev.20260227.112605Z",
+    "@llumiverse/common": "1.0.0-dev.20260224.234313Z"
   },
   "peerDependencies": {
-    "rollup": "^4.0.0"
+    "rollup": "^4.59.0"
   },
   "ts_dual_module": {
     "outDir": "lib"

package/src/index.ts

@@ -37,12 +37,16 @@ export {
     skillTransformer,
     rawTransformer,
     skillCollectionTransformer,
+    templateTransformer,
+    templateCollectionTransformer,
     promptTransformer,
     SkillDefinitionSchema,
     SkillPropertiesSchema,
+    RenderingTemplateDefinitionSchema,
     PromptDefinitionSchema,
     type SkillDefinition,
     type SkillContentType,
+    type RenderingTemplateDefinition,
     type PromptDefinition,
     type PromptContentType,
     PromptRole,

package/src/presets/index.ts

@@ -4,5 +4,7 @@
 
 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';

package/src/presets/template-collection.ts

@@ -0,0 +1,83 @@
+/**
+ * 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';
+import type { TransformerPreset } from '../types.js';
+
+/**
+ * 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: TransformerPreset = {
+    pattern: /\/[^/?]+\?templates$/,
+    virtual: true,
+    transform: (_content: string, filePath: string) => {
+        // 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: string[] = [];
+        const names: string[] = [];
+
+        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
+        };
+    }
+};

package/src/presets/template.ts

@@ -0,0 +1,116 @@
+/**
+ * Template transformer preset for markdown files with frontmatter
+ */
+
+import path from 'node:path';
+import { z } from 'zod';
+import type { TransformerPreset } from '../types.js';
+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();
+
+/**
+ * TypeScript type inferred from the Zod schema
+ */
+export type RenderingTemplateDefinition = z.infer<typeof RenderingTemplateDefinitionSchema>;
+
+/**
+ * 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: string): { category: string; templateName: string; relative: string } {
+    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: TransformerPreset = {
+    pattern: /(\.md\?template$|\/TEMPLATE\.md$)/,
+    schema: RenderingTemplateDefinitionSchema,
+    transform: (content: string, filePath: string) => {
+        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: RenderingTemplateDefinition = {
+            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,
+        };
+    }
+};

package/src/types.ts

@@ -16,7 +16,7 @@ export interface AssetFile {
     destPath: string;
 
     /** Asset type for categorization */
-    type: 'script';
+    type: 'script' | 'template';
 }
 
 /**

package/src/utils/template-asset-discovery.ts

@@ -0,0 +1,77 @@
+/**
+ * Utilities for discovering asset files in template directories
+ */
+
+import { readdirSync, statSync } from 'node:fs';
+import path from 'node:path';
+import type { AssetFile } from '../types.js';
+
+/**
+ * Discovered assets in a template directory
+ */
+export interface DiscoveredTemplateAssets {
+    /** Asset file names (relative to template dir) */
+    fileNames: string[];
+
+    /** Asset files to be copied */
+    assetFiles: AssetFile[];
+}
+
+/**
+ * Files to exclude from template asset discovery
+ * (source files and the template definition itself)
+ */
+const EXCLUDED_PATTERNS = [
+    /^TEMPLATE\.md$/,
+    /\.ts$/,
+    /\.js$/,
+];
+
+function isExcluded(fileName: string): boolean {
+    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: string,
+    templatePath: string,
+): DiscoveredTemplateAssets {
+    const templateDir = path.dirname(templateFilePath);
+    const fileNames: string[] = [];
+    const assetFiles: AssetFile[] = [];
+
+    let files: string[];
+    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 };
+}