@vertesia/build-tools 0.80.0 → 0.80.2

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

@@ -0,0 +1,77 @@
+/**
+ * Skill collection transformer for directory-based skill imports
+ * Scans a directory for subdirectories containing SKILL.md files
+ */
+import { readdirSync, statSync, existsSync } from 'node:fs';
+import path from 'node:path';
+/**
+ * Skill collection transformer preset
+ * Transforms directory imports with ?skills suffix into an array of skill imports
+ *
+ * Matches:
+ * - ./all?skills (recommended - generates all.js in the directory)
+ * - ./_skills?skills (generates _skills.js in the directory)
+ * - Any path ending with a filename and ?skills
+ *
+ * NOTE: A filename before ?skills is REQUIRED to avoid naming conflicts.
+ * The filename becomes the output module name.
+ *
+ * @example
+ * ```typescript
+ * import skills from './all?skills';
+ * // Scans current directory for subdirectories with SKILL.md
+ * // Generates all.js containing array of all skills
+ * ```
+ */
+export const skillCollectionTransformer = {
+    pattern: /\/[^/?]+\?skills$/,
+    virtual: true, // Indicates this doesn't transform a real file
+    transform: (_content, filePath) => {
+        // Remove ?skills suffix and the filename to get directory path
+        // Example: /path/code/all?skills -> /path/code/all -> /path/code/
+        const pathWithoutQuery = filePath.replace(/\?skills$/, '');
+        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 SKILL.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 skillFile = path.join(entryPath, 'SKILL.md');
+                    if (existsSync(skillFile)) {
+                        // Generate unique identifier from directory name
+                        const identifier = `Skill_${entry.replace(/[^a-zA-Z0-9_]/g, '_')}`;
+                        imports.push(`import ${identifier} from './${entry}/SKILL.md';`);
+                        names.push(identifier);
+                    }
+                }
+            }
+            catch (err) {
+                // Skip entries that can't be read
+                continue;
+            }
+        }
+        if (names.length === 0) {
+            console.warn(`No SKILL.md files found in subdirectories of ${dirPath}`);
+        }
+        // Generate code that imports all skills and exports as array
+        const code = [
+            ...imports,
+            '',
+            `export default [${names.join(', ')}];`
+        ].join('\n');
+        return {
+            data: null, // Not used when custom code is provided
+            code
+        };
+    }
+};
+//# sourceMappingURL=skill-collection.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-collection.js","sourceRoot":"","sources":["../../../src/presets/skill-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;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAsB;IACzD,OAAO,EAAE,mBAAmB;IAC5B,OAAO,EAAE,IAAI,EAAE,+CAA+C;IAC9D,SAAS,EAAE,CAAC,QAAgB,EAAE,QAAgB,EAAE,EAAE;QAC9C,+DAA+D;QAC/D,kEAAkE;QAClE,MAAM,gBAAgB,GAAG,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC3D,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,8CAA8C;QAC9C,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,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;oBACnD,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;wBACxB,iDAAiD;wBACjD,MAAM,UAAU,GAAG,SAAS,KAAK,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,EAAE,CAAC;wBACnE,OAAO,CAAC,IAAI,CAAC,UAAU,UAAU,YAAY,KAAK,aAAa,CAAC,CAAC;wBACjE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;oBAC3B,CAAC;gBACL,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACX,kCAAkC;gBAClC,SAAS;YACb,CAAC;QACL,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,gDAAgD,OAAO,EAAE,CAAC,CAAC;QAC5E,CAAC;QAED,6DAA6D;QAC7D,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,EAAE,wCAAwC;YACpD,IAAI;SACP,CAAC;IACN,CAAC;CACJ,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, SkillDefinitionSchema, type SkillDefinition, type SkillContentType } from './presets/index.js';
+export { skillTransformer, rawTransformer, skillCollectionTransformer, promptTransformer, SkillDefinitionSchema, PromptDefinitionSchema, type SkillDefinition, type SkillContentType, 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,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACxB,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,iBAAiB,EACjB,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"}

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

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGrC,OAAO,KAAK,EAAE,YAAY,EAA8B,MAAM,YAAY,CAAC;AAK3E;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA8IjE"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGrC,OAAO,KAAK,EAAE,YAAY,EAA8B,MAAM,YAAY,CAAC;AAK3E;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAsJjE"}

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

@@ -2,5 +2,7 @@
  * Preset transformers for common use cases
  */
 export { skillTransformer, SkillDefinitionSchema, type SkillDefinition, type SkillContentType } from './skill.js';
+export { skillCollectionTransformer } from './skill-collection.js';
 export { rawTransformer } from './raw.js';
+export { promptTransformer, PromptDefinitionSchema, type PromptDefinition, type PromptContentType, PromptRole, TemplateType } from './prompt.js';
 //# sourceMappingURL=index.d.ts.map

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,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAClH,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/presets/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAClH,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"}

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

@@ -0,0 +1,63 @@
+/**
+ * Prompt transformer preset for template files with frontmatter
+ * Supports .jst, .hbs, and plain text files
+ */
+import { z } from 'zod';
+import type { TransformerPreset } from '../types.js';
+import { TemplateType } from '@vertesia/common';
+import { PromptRole } from '@llumiverse/common';
+/**
+ * Re-export types for backwards compatibility
+ */
+export { TemplateType, PromptRole };
+/**
+ * Template type alias
+ */
+export type PromptContentType = TemplateType;
+/**
+ * MUST be kept in sync with @vertesia/common InCodePrompt
+ * Zod schema for prompt definition
+ */
+export declare const PromptDefinitionSchema: z.ZodObject<{
+    role: z.ZodNativeEnum<typeof PromptRole>;
+    content: z.ZodString;
+    content_type: z.ZodNativeEnum<typeof TemplateType>;
+    schema: z.ZodOptional<z.ZodAny>;
+    name: z.ZodOptional<z.ZodString>;
+    externalId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    content_type: TemplateType;
+    content: string;
+    role: PromptRole;
+    schema?: any;
+    name?: string | undefined;
+    externalId?: string | undefined;
+}, {
+    content_type: TemplateType;
+    content: string;
+    role: PromptRole;
+    schema?: any;
+    name?: string | undefined;
+    externalId?: string | undefined;
+}>;
+/**
+ * TypeScript type inferred from the Zod schema
+ */
+export type PromptDefinition = z.infer<typeof PromptDefinitionSchema>;
+/**
+ * Prompt transformer preset
+ * Transforms template files with ?prompt suffix into prompt definition objects
+ *
+ * Supported file types:
+ * - .jst (JavaScript template literals) → content_type: 'jst'
+ * - .hbs (Handlebars templates) → content_type: 'handlebars'
+ * - .txt or other → content_type: 'text'
+ *
+ * @example
+ * ```typescript
+ * import PROMPT from './prompt.hbs?prompt';
+ * // PROMPT is an InCodePrompt object
+ * ```
+ */
+export declare const promptTransformer: TransformerPreset;
+//# sourceMappingURL=prompt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/presets/prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;AAEpC;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAkB7C;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;EAOjC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAiGtE;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iBAAiB,EAAE,iBA4D/B,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * Skill collection transformer for directory-based skill imports
+ * Scans a directory for subdirectories containing SKILL.md files
+ */
+import type { TransformerPreset } from '../types.js';
+/**
+ * Skill collection transformer preset
+ * Transforms directory imports with ?skills suffix into an array of skill imports
+ *
+ * Matches:
+ * - ./all?skills (recommended - generates all.js in the directory)
+ * - ./_skills?skills (generates _skills.js in the directory)
+ * - Any path ending with a filename and ?skills
+ *
+ * NOTE: A filename before ?skills is REQUIRED to avoid naming conflicts.
+ * The filename becomes the output module name.
+ *
+ * @example
+ * ```typescript
+ * import skills from './all?skills';
+ * // Scans current directory for subdirectories with SKILL.md
+ * // Generates all.js containing array of all skills
+ * ```
+ */
+export declare const skillCollectionTransformer: TransformerPreset;
+//# sourceMappingURL=skill-collection.d.ts.map

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

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

package/lib/types/types.d.ts

@@ -46,6 +46,8 @@ export interface TransformerRule {
     transform: TransformFunction;
     /** Optional: Zod schema for validation */
     schema?: z.ZodType<any>;
+    /** Optional: If true, the transformer generates virtual modules (no file to read) */
+    virtual?: boolean;
     /** Optional: additional options for this transformer */
     options?: Record<string, unknown>;
 }

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,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,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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertesia/build-tools",
-  "version": "0.80.0",
+  "version": "0.80.2",
   "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",
@@ -28,7 +28,9 @@
   },
   "dependencies": {
     "gray-matter": "^4.0.3",
-    "zod": "^3.24.1"
+    "zod": "^3.24.1",
+    "@vertesia/common": "0.81.0",
+    "@llumiverse/common": "0.24.0"
   },
   "peerDependencies": {
     "rollup": "^4.0.0"

package/src/index.ts

@@ -36,9 +36,16 @@ export type {
 export {
     skillTransformer,
     rawTransformer,
+    skillCollectionTransformer,
+    promptTransformer,
     SkillDefinitionSchema,
+    PromptDefinitionSchema,
     type SkillDefinition,
-    type SkillContentType
+    type SkillContentType,
+    type PromptDefinition,
+    type PromptContentType,
+    PromptRole,
+    TemplateType
 } from './presets/index.js';
 
 // Utilities

package/src/plugin.ts

@@ -39,7 +39,13 @@ export function vertesiaImportPlugin(config: PluginConfig): Plugin {
                     // Handle relative imports
                     if (source.startsWith('.') && importer) {
                         const cleanSource = source.replace(transformer.pattern, '');
-                        const resolved = path.resolve(path.dirname(importer), cleanSource);
+                        // Strip query parameters from importer to get the file path
+                        const cleanImporter = importer.indexOf('?') >= 0
+                            ? importer.substring(0, importer.indexOf('?'))
+                            : importer;
+                        // Always use dirname to get the directory containing the importer
+                        const baseDir = path.dirname(cleanImporter);
+                        const resolved = path.resolve(baseDir, cleanSource);
                         // Return with the pattern suffix to identify it in load
                         const suffix = source.match(transformer.pattern)?.[0] || '';
                         return resolved + suffix;
@@ -75,8 +81,10 @@ export function vertesiaImportPlugin(config: PluginConfig): Plugin {
             }
 
             try {
-                // Read file content
-                const content = readFileSync(cleanId, 'utf-8');
+                // Read file content (skip for virtual transforms)
+                const content = matchedTransformer.virtual
+                    ? ''
+                    : readFileSync(cleanId, 'utf-8');
 
                 // Transform the content
                 const result = await matchedTransformer.transform(content, cleanId);
@@ -105,12 +113,12 @@ export function vertesiaImportPlugin(config: PluginConfig): Plugin {
                 }
 
                 // Generate code
+                const imports = result.imports ? result.imports.join('\n') + '\n\n' : '';
                 if (result.code) {
-                    // Custom code provided
-                    return result.code;
+                    // Custom code provided - prepend imports
+                    return imports + result.code;
                 } else {
                     // Default: export data (escape if string, otherwise stringify as JSON)
-                    const imports = result.imports ? result.imports.join('\n') + '\n\n' : '';
                     const dataJson = JSON.stringify(result.data, null, 2);
                     return `${imports}export default ${dataJson};`;
                 }

package/src/presets/index.ts

@@ -3,4 +3,6 @@
  */
 
 export { skillTransformer, SkillDefinitionSchema, type SkillDefinition, type SkillContentType } from './skill.js';
+export { skillCollectionTransformer } from './skill-collection.js';
 export { rawTransformer } from './raw.js';
+export { promptTransformer, PromptDefinitionSchema, type PromptDefinition, type PromptContentType, PromptRole, TemplateType } from './prompt.js';

package/src/presets/prompt.ts

@@ -0,0 +1,227 @@
+/**
+ * Prompt transformer preset for template files with frontmatter
+ * Supports .jst, .hbs, and plain text files
+ */
+
+import { z } from 'zod';
+import type { TransformerPreset } from '../types.js';
+import { parseFrontmatter } from '../parsers/frontmatter.js';
+import path from 'path';
+import { TemplateType } from '@vertesia/common';
+import { PromptRole } from '@llumiverse/common';
+
+/**
+ * Re-export types for backwards compatibility
+ */
+export { TemplateType, PromptRole };
+
+/**
+ * Template type alias
+ */
+export type PromptContentType = TemplateType;
+
+/**
+ * Zod schema for prompt frontmatter validation
+ */
+const PromptFrontmatterSchema = z.object({
+    // Required fields
+    role: z.nativeEnum(PromptRole, {
+        errorMap: () => ({ message: 'Role must be one of: safety, system, user, assistant, negative' })
+    }),
+
+    // Optional fields
+    content_type: z.nativeEnum(TemplateType).optional(),
+    schema: z.string().optional(),
+    name: z.string().optional(),
+    externalId: z.string().optional(),
+}).strict();
+
+/**
+ * MUST be kept in sync with @vertesia/common InCodePrompt
+ * Zod schema for prompt definition
+ */
+export const PromptDefinitionSchema = z.object({
+    role: z.nativeEnum(PromptRole),
+    content: z.string(),
+    content_type: z.nativeEnum(TemplateType),
+    schema: z.any().optional(),
+    name: z.string().optional(),
+    externalId: z.string().optional(),
+});
+
+/**
+ * TypeScript type inferred from the Zod schema
+ */
+export type PromptDefinition = z.infer<typeof PromptDefinitionSchema>;
+
+/**
+ * Normalize schema path for import
+ * - Adds './' prefix if not a relative path
+ * - Replaces .ts with .js
+ * - Adds .js if no extension
+ *
+ * @param schemaPath - Original schema path from frontmatter
+ * @returns Normalized path for ES module import
+ */
+function normalizeSchemaPath(schemaPath: string): string {
+    let normalized = schemaPath.trim();
+
+    // Add './' prefix if not already a relative path
+    if (!normalized.startsWith('.')) {
+        normalized = './' + normalized;
+    }
+
+    // Get the extension
+    const ext = path.extname(normalized);
+
+    if (ext === '.ts') {
+        // Replace .ts with .js
+        normalized = normalized.slice(0, -3) + '.js';
+    } else if (!ext) {
+        // No extension, add .js
+        normalized = normalized + '.js';
+    }
+    // If extension is already .js or something else, leave as is
+
+    return normalized;
+}
+
+/**
+ * Infer content type from file extension
+ *
+ * @param filePath - Path to the prompt file
+ * @returns Inferred content type
+ */
+function inferContentType(filePath: string): TemplateType {
+    const ext = path.extname(filePath).toLowerCase();
+
+    switch (ext) {
+        case '.jst':
+            return TemplateType.jst;
+        case '.hbs':
+            return TemplateType.handlebars;
+        default:
+            return TemplateType.text;
+    }
+}
+
+/**
+ * Build a PromptDefinition from frontmatter and content
+ *
+ * @param frontmatter - Parsed frontmatter object
+ * @param content - Prompt content (body of the file)
+ * @param filePath - Path to the prompt file (for content type inference)
+ * @returns Prompt definition object and optional imports
+ */
+function buildPromptDefinition(
+    frontmatter: Record<string, any>,
+    content: string,
+    filePath: string
+): { prompt: PromptDefinition; imports?: string[]; schemaImportName?: string } {
+    // Determine content type from frontmatter or file extension
+    const content_type: TemplateType =
+        frontmatter.content_type || inferContentType(filePath);
+
+    const prompt: PromptDefinition = {
+        role: frontmatter.role,
+        content,
+        content_type,
+    };
+
+    // Add optional fields
+    if (frontmatter.name) {
+        prompt.name = frontmatter.name;
+    }
+    if (frontmatter.externalId) {
+        prompt.externalId = frontmatter.externalId;
+    }
+
+    // Handle schema import if specified
+    let imports: string[] | undefined;
+    let schemaImportName: string | undefined;
+
+    if (frontmatter.schema) {
+        const normalizedPath = normalizeSchemaPath(frontmatter.schema);
+        schemaImportName = '__promptSchema';
+        imports = [`import ${schemaImportName} from '${normalizedPath}';`];
+    }
+
+    return { prompt, imports, schemaImportName };
+}
+
+/**
+ * Prompt transformer preset
+ * Transforms template files with ?prompt suffix into prompt definition objects
+ *
+ * Supported file types:
+ * - .jst (JavaScript template literals) → content_type: 'jst'
+ * - .hbs (Handlebars templates) → content_type: 'handlebars'
+ * - .txt or other → content_type: 'text'
+ *
+ * @example
+ * ```typescript
+ * import PROMPT from './prompt.hbs?prompt';
+ * // PROMPT is an InCodePrompt object
+ * ```
+ */
+export const promptTransformer: TransformerPreset = {
+    pattern: /\?prompt$/,
+    schema: PromptDefinitionSchema,
+    transform: (content: string, filePath: string) => {
+        const { frontmatter, content: promptContent } = parseFrontmatter(content);
+
+        // Validate frontmatter
+        const frontmatterValidation = PromptFrontmatterSchema.safeParse(frontmatter);
+        if (!frontmatterValidation.success) {
+            const errors = frontmatterValidation.error.errors
+                .map((err) => {
+                    const path = err.path.length > 0 ? err.path.join('.') : 'frontmatter';
+                    return `  - ${path}: ${err.message}`;
+                })
+                .join('\n');
+            throw new Error(
+                `Invalid frontmatter in ${filePath}:\n${errors}`
+            );
+        }
+
+        // Build prompt definition
+        const { prompt, imports, schemaImportName } = buildPromptDefinition(
+            frontmatter,
+            promptContent,
+            filePath
+        );
+
+        // If schema is specified, generate custom code with schema reference
+        if (schemaImportName) {
+            // Build the code manually to avoid JSON.stringify issues with schema reference
+            const lines = [
+                'export default {',
+                `  role: "${prompt.role}",`,
+                `  content: ${JSON.stringify(prompt.content)},`,
+                `  content_type: "${prompt.content_type}",`,
+                `  schema: ${schemaImportName}`,
+            ];
+
+            if (prompt.name) {
+                lines.splice(4, 0, `  name: ${JSON.stringify(prompt.name)},`);
+            }
+            if (prompt.externalId) {
+                lines.splice(4, 0, `  externalId: ${JSON.stringify(prompt.externalId)},`);
+            }
+
+            lines.push('};');
+            const code = lines.join('\n');
+
+            return {
+                data: prompt,
+                imports,
+                code,
+            };
+        }
+
+        // Standard case without schema
+        return {
+            data: prompt,
+        };
+    }
+};

package/src/presets/skill-collection.ts

@@ -0,0 +1,86 @@
+/**
+ * Skill collection transformer for directory-based skill imports
+ * Scans a directory for subdirectories containing SKILL.md files
+ */
+
+import { readdirSync, statSync, existsSync } from 'node:fs';
+import path from 'node:path';
+import type { TransformerPreset } from '../types.js';
+
+/**
+ * Skill collection transformer preset
+ * Transforms directory imports with ?skills suffix into an array of skill imports
+ *
+ * Matches:
+ * - ./all?skills (recommended - generates all.js in the directory)
+ * - ./_skills?skills (generates _skills.js in the directory)
+ * - Any path ending with a filename and ?skills
+ *
+ * NOTE: A filename before ?skills is REQUIRED to avoid naming conflicts.
+ * The filename becomes the output module name.
+ *
+ * @example
+ * ```typescript
+ * import skills from './all?skills';
+ * // Scans current directory for subdirectories with SKILL.md
+ * // Generates all.js containing array of all skills
+ * ```
+ */
+export const skillCollectionTransformer: TransformerPreset = {
+    pattern: /\/[^/?]+\?skills$/,
+    virtual: true, // Indicates this doesn't transform a real file
+    transform: (_content: string, filePath: string) => {
+        // Remove ?skills suffix and the filename to get directory path
+        // Example: /path/code/all?skills -> /path/code/all -> /path/code/
+        const pathWithoutQuery = filePath.replace(/\?skills$/, '');
+        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 SKILL.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 skillFile = path.join(entryPath, 'SKILL.md');
+                    if (existsSync(skillFile)) {
+                        // Generate unique identifier from directory name
+                        const identifier = `Skill_${entry.replace(/[^a-zA-Z0-9_]/g, '_')}`;
+                        imports.push(`import ${identifier} from './${entry}/SKILL.md';`);
+                        names.push(identifier);
+                    }
+                }
+            } catch (err) {
+                // Skip entries that can't be read
+                continue;
+            }
+        }
+
+        if (names.length === 0) {
+            console.warn(`No SKILL.md files found in subdirectories of ${dirPath}`);
+        }
+
+        // Generate code that imports all skills and exports as array
+        const code = [
+            ...imports,
+            '',
+            `export default [${names.join(', ')}];`
+        ].join('\n');
+
+        return {
+            data: null, // Not used when custom code is provided
+            code
+        };
+    }
+};

package/src/types.ts

@@ -60,6 +60,9 @@ export interface TransformerRule {
     /** Optional: Zod schema for validation */
     schema?: z.ZodType<any>;
 
+    /** Optional: If true, the transformer generates virtual modules (no file to read) */
+    virtual?: boolean;
+
     /** Optional: additional options for this transformer */
     options?: Record<string, unknown>;
 }