@vertesia/build-tools 1.3.0 → 1.4.0-dev.20260614.160504Z

package/lib/import-transform/rewriter.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Rewrites query-style import specifiers inside a JavaScript source file to
+ * point at the chunks emitted by the chunk-emitter.
+ *
+ * All replacements are intra-line (only the quoted string changes), which
+ * preserves line numbers — so existing source maps remain valid at the line
+ * level without re-emitting them.
+ */
+export interface ImportReplacement {
+    /** Offset where the opening quote begins in the original content. */
+    quoteStart: number;
+    /** Offset where the closing quote ends (exclusive). */
+    quoteEnd: number;
+    /** Quote character to wrap the new specifier with. */
+    quote: "'" | '"' | '`';
+    /** Replacement specifier (without quotes). */
+    newSpecifier: string;
+}
+export declare function rewriteImports(content: string, replacements: ImportReplacement[]): string;
+export declare function writeRewrittenFile(filePath: string, content: string, replacements: ImportReplacement[]): boolean;
+//# sourceMappingURL=rewriter.d.ts.map

package/lib/import-transform/rewriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewriter.d.ts","sourceRoot":"","sources":["../../src/import-transform/rewriter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,iBAAiB;IAC9B,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IAEnB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IAEjB,sDAAsD;IACtD,KAAK,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAEvB,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAazF;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAOhH"}

package/lib/import-transform/rewriter.js

@@ -0,0 +1,30 @@
+/**
+ * Rewrites query-style import specifiers inside a JavaScript source file to
+ * point at the chunks emitted by the chunk-emitter.
+ *
+ * All replacements are intra-line (only the quoted string changes), which
+ * preserves line numbers — so existing source maps remain valid at the line
+ * level without re-emitting them.
+ */
+import { writeFileSync } from 'node:fs';
+export function rewriteImports(content, replacements) {
+    if (replacements.length === 0) {
+        return content;
+    }
+    const sorted = [...replacements].sort((a, b) => b.quoteStart - a.quoteStart);
+    let out = content;
+    for (const r of sorted) {
+        const literal = `${r.quote}${r.newSpecifier}${r.quote}`;
+        out = out.slice(0, r.quoteStart) + literal + out.slice(r.quoteEnd);
+    }
+    return out;
+}
+export function writeRewrittenFile(filePath, content, replacements) {
+    if (replacements.length === 0) {
+        return false;
+    }
+    const next = rewriteImports(content, replacements);
+    writeFileSync(filePath, next, 'utf-8');
+    return true;
+}
+//# sourceMappingURL=rewriter.js.map

package/lib/import-transform/rewriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewriter.js","sourceRoot":"","sources":["../../src/import-transform/rewriter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAgBxC,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,YAAiC;IAC7E,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;IAE7E,IAAI,GAAG,GAAG,OAAO,CAAC;IAClB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACrB,MAAM,OAAO,GAAG,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;QACxD,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,OAAe,EAAE,YAAiC;IACnG,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACnD,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACvC,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/lib/import-transform/scanner.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Walks a compiled library directory to find candidate JavaScript files
+ * that may contain Vertesia query-style imports (`?skill`, `?raw`, …) or
+ * `SKILL.md` imports.
+ *
+ * Returns absolute paths to `.js` files whose content matches a quick
+ * content sniff for any of the trigger tokens, avoiding a re-read in the
+ * detector.
+ */
+export interface ScannedFile {
+    /** Absolute path to the file. */
+    path: string;
+    /** File content, captured during scanning. */
+    content: string;
+}
+export declare function scanLibForQueryImports(libDir: string): ScannedFile[];
+//# sourceMappingURL=scanner.d.ts.map

package/lib/import-transform/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/import-transform/scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,WAAW;IACxB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IAEb,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAIpE"}

package/lib/import-transform/scanner.js

@@ -0,0 +1,46 @@
+/**
+ * Walks a compiled library directory to find candidate JavaScript files
+ * that may contain Vertesia query-style imports (`?skill`, `?raw`, …) or
+ * `SKILL.md` imports.
+ *
+ * Returns absolute paths to `.js` files whose content matches a quick
+ * content sniff for any of the trigger tokens, avoiding a re-read in the
+ * detector.
+ */
+import { readdirSync, readFileSync, statSync } from 'node:fs';
+import path from 'node:path';
+import { SNIFF_PATTERN } from './patterns.js';
+export function scanLibForQueryImports(libDir) {
+    const results = [];
+    walk(libDir, results);
+    return results;
+}
+function walk(dir, out) {
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        const full = path.join(dir, entry);
+        let stats;
+        try {
+            stats = statSync(full);
+        }
+        catch {
+            continue;
+        }
+        if (stats.isDirectory()) {
+            walk(full, out);
+        }
+        else if (stats.isFile() && full.endsWith('.js')) {
+            const content = readFileSync(full, 'utf-8');
+            if (SNIFF_PATTERN.test(content)) {
+                out.push({ path: full, content });
+            }
+        }
+    }
+}
+//# sourceMappingURL=scanner.js.map

package/lib/import-transform/scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../../src/import-transform/scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAU9C,MAAM,UAAU,sBAAsB,CAAC,MAAc;IACjD,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtB,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,SAAS,IAAI,CAAC,GAAW,EAAE,GAAkB;IACzC,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACD,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO;IACX,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACnC,IAAI,KAAkC,CAAC;QACvC,IAAI,CAAC;YACD,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACL,SAAS;QACb,CAAC;QAED,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACpB,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAChD,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC5C,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC9B,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YACtC,CAAC;QACL,CAAC;IACL,CAAC;AACL,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Vertesia Build Tools
+ *
+ * Transformers for custom import syntaxes (`?skill`, `?raw`, `?prompt`,
+ * `?template`, `?skills`, `?templates`, and bare `SKILL.md` / `TEMPLATE.md`),
+ * a standalone CLI (`vertesia-build`) that runs them as a post-`tsc` step,
+ * and Vite plugins for dev-mode integration.
+ *
+ * Two consumer entry points:
+ *
+ *   - **Build-time:** invoke the `vertesia-build` CLI from your package
+ *     scripts (after `tsc`). Config lives under `vertesia-build` in your
+ *     `package.json`. The CLI calls `transformImports()` internally — you
+ *     can also call it directly if you need finer control.
+ *
+ *   - **Dev-time (Vite):** import `vertesiaDevServerPlugin` (or
+ *     `apiServerPlugin` for full Hono tool-server wiring) from
+ *     `@vertesia/build-tools/vite`. Same transformers, same behavior,
+ *     applied to source files at request time.
+ *
+ * @example
+ * ```typescript
+ * import { transformImports } from '@vertesia/build-tools';
+ *
+ * await transformImports({
+ *   libDir: './lib',
+ *   srcDir: './src',
+ *   transformers: ['skill', 'raw'],
+ *   assetsDir: './dist',
+ * });
+ * ```
+ */
+export { compileWidget, compileWidgets, type WidgetCompilerConfig, type WidgetInput, } from './core/compilers/widget.js';
+export { type FrontmatterResult, parseFrontmatter } from './core/parsers/frontmatter.js';
+export { type PromptContentType, type PromptDefinition, PromptDefinitionSchema, PromptRole, promptTransformer, type RenderingTemplateDefinition, RenderingTemplateDefinitionSchema, rawTransformer, type SkillContentType, type SkillDefinition, SkillDefinitionSchema, SkillPropertiesSchema, skillCollectionTransformer, skillTransformer, TemplateType, templateCollectionTransformer, templateTransformer, } from './core/transformers/index.js';
+export type { AssetFile, TransformerPreset, TransformerRule, TransformFunction, TransformResult, } from './core/types.js';
+export { BUILTIN_TRANSFORMER_NAMES, BUILTIN_TRANSFORMERS, resolveTransformerNames, } from './import-transform/builtins.js';
+export { type TransformImportsOptions, type TransformImportsResult, transformImports, } from './import-transform/index.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,EACH,aAAa,EACb,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,WAAW,GACnB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,KAAK,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEzF,OAAO,EACH,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,sBAAsB,EACtB,UAAU,EACV,iBAAiB,EACjB,KAAK,2BAA2B,EAChC,iCAAiC,EACjC,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,EAC1B,gBAAgB,EAChB,YAAY,EACZ,6BAA6B,EAC7B,mBAAmB,GACtB,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EACR,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,eAAe,GAClB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACH,yBAAyB,EACzB,oBAAoB,EACpB,uBAAuB,GAC1B,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACH,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,gBAAgB,GACnB,MAAM,6BAA6B,CAAC"}

package/lib/index.js

@@ -0,0 +1,43 @@
+/**
+ * Vertesia Build Tools
+ *
+ * Transformers for custom import syntaxes (`?skill`, `?raw`, `?prompt`,
+ * `?template`, `?skills`, `?templates`, and bare `SKILL.md` / `TEMPLATE.md`),
+ * a standalone CLI (`vertesia-build`) that runs them as a post-`tsc` step,
+ * and Vite plugins for dev-mode integration.
+ *
+ * Two consumer entry points:
+ *
+ *   - **Build-time:** invoke the `vertesia-build` CLI from your package
+ *     scripts (after `tsc`). Config lives under `vertesia-build` in your
+ *     `package.json`. The CLI calls `transformImports()` internally — you
+ *     can also call it directly if you need finer control.
+ *
+ *   - **Dev-time (Vite):** import `vertesiaDevServerPlugin` (or
+ *     `apiServerPlugin` for full Hono tool-server wiring) from
+ *     `@vertesia/build-tools/vite`. Same transformers, same behavior,
+ *     applied to source files at request time.
+ *
+ * @example
+ * ```typescript
+ * import { transformImports } from '@vertesia/build-tools';
+ *
+ * await transformImports({
+ *   libDir: './lib',
+ *   srcDir: './src',
+ *   transformers: ['skill', 'raw'],
+ *   assetsDir: './dist',
+ * });
+ * ```
+ */
+// esbuild-based widget bundler
+export { compileWidget, compileWidgets, } from './core/compilers/widget.js';
+// Parsers
+export { parseFrontmatter } from './core/parsers/frontmatter.js';
+// Transformers (the pure transformation functions)
+export { PromptDefinitionSchema, PromptRole, promptTransformer, RenderingTemplateDefinitionSchema, rawTransformer, SkillDefinitionSchema, SkillPropertiesSchema, skillCollectionTransformer, skillTransformer, TemplateType, templateCollectionTransformer, templateTransformer, } from './core/transformers/index.js';
+// CLI-friendly transformer name registry
+export { BUILTIN_TRANSFORMER_NAMES, BUILTIN_TRANSFORMERS, resolveTransformerNames, } from './import-transform/builtins.js';
+// Standalone import transformer (tsc → vertesia-build pipeline)
+export { transformImports, } from './import-transform/index.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,+BAA+B;AAC/B,OAAO,EACH,aAAa,EACb,cAAc,GAGjB,MAAM,4BAA4B,CAAC;AACpC,UAAU;AACV,OAAO,EAA0B,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACzF,mDAAmD;AACnD,OAAO,EAGH,sBAAsB,EACtB,UAAU,EACV,iBAAiB,EAEjB,iCAAiC,EACjC,cAAc,EAGd,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,EAC1B,gBAAgB,EAChB,YAAY,EACZ,6BAA6B,EAC7B,mBAAmB,GACtB,MAAM,8BAA8B,CAAC;AAStC,yCAAyC;AACzC,OAAO,EACH,yBAAyB,EACzB,oBAAoB,EACpB,uBAAuB,GAC1B,MAAM,gCAAgC,CAAC;AACxC,gEAAgE;AAChE,OAAO,EAGH,gBAAgB,GACnB,MAAM,6BAA6B,CAAC"}

package/lib/vite/api-server.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Vite plugin set that mounts a Vertesia Hono tool server as middleware on
+ * the Vite dev server. Includes the Vertesia import transformers needed by
+ * `ssrLoadModule` to handle `?skill` / `?template` / `?prompt` / `?raw`
+ * imports in the tool server source.
+ *
+ *   - `vite dev`     → loads the server entry via `ssrLoadModule` (source,
+ *                      with HMR invalidation)
+ *   - `vite preview` → loads the compiled server from `lib/` (validates
+ *                      production output)
+ *
+ * The Hono app is served on the same port as Vite under `/api`.
+ *
+ * @example
+ * ```typescript
+ * // vite.config.ts
+ * import { defineConfig } from 'vite';
+ * import { apiServerPlugin } from '@vertesia/build-tools/vite';
+ *
+ * export default defineConfig({
+ *     plugins: [
+ *         apiServerPlugin({ entry: './src/tool-server/server.ts' }),
+ *     ],
+ * });
+ * ```
+ */
+import type { Plugin } from 'vite';
+export interface ApiServerPluginOptions {
+    /**
+     * Tool server entry point (TypeScript source). Resolved by Vite from the
+     * project root in dev mode.
+     * @default './src/tool-server/server.ts'
+     */
+    entry?: string;
+    /**
+     * Compiled server module path used in preview mode. Resolved relative to
+     * `process.cwd()` (the consuming project's root when running `vite preview`).
+     * @default './lib/server.js'
+     */
+    compiledEntry?: string;
+    /**
+     * Path prefix that routes requests to the Hono server. Requests whose URL
+     * starts with this prefix are forwarded; others fall through to Vite.
+     * @default '/api'
+     */
+    apiPrefix?: string;
+    /**
+     * Names of transformers to enable in dev mode. Defaults to all built-ins
+     * (`skill`, `skills`, `template`, `templates`, `prompt`, `raw`).
+     */
+    transformers?: readonly string[];
+}
+export declare function apiServerPlugin(options?: ApiServerPluginOptions): Plugin[];
+//# sourceMappingURL=api-server.d.ts.map

package/lib/vite/api-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-server.d.ts","sourceRoot":"","sources":["../../src/vite/api-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAC;AASlD,MAAM,WAAW,sBAAsB;IACnC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,MAAM,EAAE,CA6B9E"}

package/lib/vite/api-server.js

@@ -0,0 +1,94 @@
+/**
+ * Vite plugin set that mounts a Vertesia Hono tool server as middleware on
+ * the Vite dev server. Includes the Vertesia import transformers needed by
+ * `ssrLoadModule` to handle `?skill` / `?template` / `?prompt` / `?raw`
+ * imports in the tool server source.
+ *
+ *   - `vite dev`     → loads the server entry via `ssrLoadModule` (source,
+ *                      with HMR invalidation)
+ *   - `vite preview` → loads the compiled server from `lib/` (validates
+ *                      production output)
+ *
+ * The Hono app is served on the same port as Vite under `/api`.
+ *
+ * @example
+ * ```typescript
+ * // vite.config.ts
+ * import { defineConfig } from 'vite';
+ * import { apiServerPlugin } from '@vertesia/build-tools/vite';
+ *
+ * export default defineConfig({
+ *     plugins: [
+ *         apiServerPlugin({ entry: './src/tool-server/server.ts' }),
+ *     ],
+ * });
+ * ```
+ */
+import path from 'node:path';
+import { getRequestListener } from '@hono/node-server';
+import { vertesiaDevServerPlugin } from './dev-server.js';
+export function apiServerPlugin(options = {}) {
+    const { entry = './src/tool-server/server.ts', compiledEntry = './lib/server.js', apiPrefix = '/api', transformers, } = options;
+    // Resolve compiled entry relative to the consumer's cwd. Vite is run from
+    // the project root by convention, so this lands at the right file.
+    const absoluteCompiledEntry = path.resolve(process.cwd(), compiledEntry);
+    return [
+        // Vertesia query-import transformer (skill / raw / prompt / template etc.).
+        vertesiaDevServerPlugin(transformers ? { transformers } : undefined),
+        // Hono middleware bridge for dev + preview.
+        {
+            name: 'vertesia-api-server',
+            configureServer(server) {
+                server.middlewares.use(createDevListener(server, entry, apiPrefix));
+            },
+            configurePreviewServer(server) {
+                server.middlewares.use(createPreviewListener(absoluteCompiledEntry, apiPrefix));
+            },
+        },
+    ];
+}
+/**
+ * Connect-compatible middleware that loads the Hono app from source via
+ * Vite's `ssrLoadModule` (preserving HMR invalidation on changes).
+ */
+function createDevListener(server, entry, apiPrefix) {
+    return async (req, res, next) => {
+        if (!req.url?.startsWith(apiPrefix)) {
+            return next();
+        }
+        try {
+            const mod = await server.ssrLoadModule(entry);
+            const app = mod.default;
+            const requestListener = getRequestListener(app.fetch);
+            void requestListener(req, res);
+        }
+        catch (e) {
+            next(e);
+        }
+    };
+}
+/**
+ * Connect-compatible middleware that loads the compiled Hono app from `lib/`
+ * for production validation. The compiled module is cached after first load
+ * (no HMR in preview mode).
+ */
+function createPreviewListener(compiledEntry, apiPrefix) {
+    let appPromise = null;
+    return async (req, res, next) => {
+        if (!req.url?.startsWith(apiPrefix)) {
+            return next();
+        }
+        try {
+            if (!appPromise) {
+                appPromise = import(compiledEntry).then((mod) => mod.default);
+            }
+            const app = await appPromise;
+            const requestListener = getRequestListener(app.fetch);
+            void requestListener(req, res);
+        }
+        catch (e) {
+            next(e);
+        }
+    };
+}
+//# sourceMappingURL=api-server.js.map

package/lib/vite/api-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-server.js","sourceRoot":"","sources":["../../src/vite/api-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAqC1D,MAAM,UAAU,eAAe,CAAC,UAAkC,EAAE;IAChE,MAAM,EACF,KAAK,GAAG,6BAA6B,EACrC,aAAa,GAAG,iBAAiB,EACjC,SAAS,GAAG,MAAM,EAClB,YAAY,GACf,GAAG,OAAO,CAAC;IAEZ,0EAA0E;IAC1E,mEAAmE;IACnE,MAAM,qBAAqB,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,CAAC,CAAC;IAEzE,OAAO;QACH,4EAA4E;QAC5E,uBAAuB,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAEpE,4CAA4C;QAC5C;YACI,IAAI,EAAE,qBAAqB;YAE3B,eAAe,CAAC,MAAqB;gBACjC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;YACxE,CAAC;YAED,sBAAsB,CAAC,MAAM;gBACzB,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,qBAAqB,CAAC,qBAAqB,EAAE,SAAS,CAAC,CAAC,CAAC;YACpF,CAAC;SACJ;KACJ,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,SAAS,iBAAiB,CAAC,MAAqB,EAAE,KAAa,EAAE,SAAiB;IAC9E,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAClC,OAAO,IAAI,EAAE,CAAC;QAClB,CAAC;QACD,IAAI,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YAC9C,MAAM,GAAG,GAAG,GAAG,CAAC,OAAkB,CAAC;YACnC,MAAM,eAAe,GAAG,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACtD,KAAK,eAAe,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,IAAI,CAAC,CAAC,CAAC,CAAC;QACZ,CAAC;IACL,CAAC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,SAAS,qBAAqB,CAAC,aAAqB,EAAE,SAAiB;IACnE,IAAI,UAAU,GAA4B,IAAI,CAAC;IAC/C,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAClC,OAAO,IAAI,EAAE,CAAC;QAClB,CAAC;QACD,IAAI,CAAC;YACD,IAAI,CAAC,UAAU,EAAE,CAAC;gBACd,UAAU,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAClE,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC;YAC7B,MAAM,eAAe,GAAG,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACtD,KAAK,eAAe,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,IAAI,CAAC,CAAC,CAAC,CAAC;QACZ,CAAC;IACL,CAAC,CAAC;AACN,CAAC"}

package/lib/vite/dev-server.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Vite plugin that transforms Vertesia query-style imports
+ * (`?skill`, `?skills`, `?prompt`, `?template`, `?templates`, `?raw`) on the
+ * fly during development, plus bare `SKILL.md` / `TEMPLATE.md` imports.
+ *
+ * This is the dev-mode counterpart to the standalone `transformImports` CLI
+ * used at build time. It runs Vite's `resolveId` + `load` hooks against the
+ * configured transformers, so the same source files work in both `vite dev`
+ * and post-`tsc` build modes.
+ *
+ * Asset copying and widget bundling are skipped in dev — they're build-time
+ * concerns only.
+ *
+ * @example
+ * ```typescript
+ * // vite.config.ts
+ * import { defineConfig } from 'vite';
+ * import { vertesiaDevServerPlugin } from '@vertesia/build-tools/vite';
+ *
+ * export default defineConfig({
+ *     plugins: [vertesiaDevServerPlugin()],
+ * });
+ * ```
+ *
+ * Default transformers include all built-ins (skill / skills / template /
+ * templates / prompt / raw). Pass `transformers` to restrict the set:
+ *
+ * ```typescript
+ * vertesiaDevServerPlugin({ transformers: ['skill', 'raw'] });
+ * ```
+ */
+import type { Plugin } from 'vite';
+export interface VertesiaDevServerPluginOptions {
+    /**
+     * Names of transformers to activate. Defaults to all built-ins:
+     * `['skill', 'skills', 'template', 'templates', 'prompt', 'raw']`.
+     * Pass a subset to disable transformers you don't use.
+     */
+    transformers?: readonly string[];
+}
+export declare function vertesiaDevServerPlugin(options?: VertesiaDevServerPluginOptions): Plugin;
+//# sourceMappingURL=dev-server.d.ts.map

package/lib/vite/dev-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../../src/vite/dev-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAInC,MAAM,WAAW,8BAA8B;IAC3C;;;;OAIG;IACH,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,8BAAmC,GAAG,MAAM,CAoE5F"}

package/lib/vite/dev-server.js

@@ -0,0 +1,111 @@
+/**
+ * Vite plugin that transforms Vertesia query-style imports
+ * (`?skill`, `?skills`, `?prompt`, `?template`, `?templates`, `?raw`) on the
+ * fly during development, plus bare `SKILL.md` / `TEMPLATE.md` imports.
+ *
+ * This is the dev-mode counterpart to the standalone `transformImports` CLI
+ * used at build time. It runs Vite's `resolveId` + `load` hooks against the
+ * configured transformers, so the same source files work in both `vite dev`
+ * and post-`tsc` build modes.
+ *
+ * Asset copying and widget bundling are skipped in dev — they're build-time
+ * concerns only.
+ *
+ * @example
+ * ```typescript
+ * // vite.config.ts
+ * import { defineConfig } from 'vite';
+ * import { vertesiaDevServerPlugin } from '@vertesia/build-tools/vite';
+ *
+ * export default defineConfig({
+ *     plugins: [vertesiaDevServerPlugin()],
+ * });
+ * ```
+ *
+ * Default transformers include all built-ins (skill / skills / template /
+ * templates / prompt / raw). Pass `transformers` to restrict the set:
+ *
+ * ```typescript
+ * vertesiaDevServerPlugin({ transformers: ['skill', 'raw'] });
+ * ```
+ */
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { BUILTIN_TRANSFORMER_NAMES, resolveTransformerNames } from '../import-transform/builtins.js';
+export function vertesiaDevServerPlugin(options = {}) {
+    const names = options.transformers ?? BUILTIN_TRANSFORMER_NAMES;
+    const transformers = resolveTransformerNames([...names]);
+    return {
+        name: 'vertesia-dev-server',
+        enforce: 'pre',
+        /**
+         * Map relative query-style imports to absolute paths so Vite's loader
+         * sees a stable id keyed by the original file location. The query
+         * suffix is preserved in the id and used by `load` to pick the right
+         * transformer.
+         */
+        resolveId(source, importer) {
+            for (const transformer of transformers) {
+                if (!transformer.pattern.test(source))
+                    continue;
+                // Only relative specifiers can be resolved meaningfully against an importer.
+                if (source.startsWith('.') && importer) {
+                    const cleanSource = source.replace(transformer.pattern, '');
+                    const cleanImporter = importer.includes('?')
+                        ? importer.substring(0, importer.indexOf('?'))
+                        : importer;
+                    const baseDir = path.dirname(cleanImporter);
+                    const resolved = path.resolve(baseDir, cleanSource);
+                    const suffix = source.match(transformer.pattern)?.[0] ?? '';
+                    return resolved + suffix;
+                }
+                // Bare or absolute matches are returned as-is.
+                return source;
+            }
+            return null;
+        },
+        /**
+         * Read the source file (skipping reads for virtual transformers),
+         * run the matched transformer, and return ES module source code.
+         */
+        async load(id) {
+            const matched = findMatchingTransformer(id, transformers);
+            if (!matched)
+                return null;
+            const cleanId = stripQuery(id);
+            try {
+                const content = matched.virtual ? '' : readFileSync(cleanId, 'utf-8');
+                const result = await matched.transform(content, cleanId);
+                if (matched.schema) {
+                    const validation = matched.schema.safeParse(result.data);
+                    if (!validation.success) {
+                        const errors = validation.error.issues
+                            .map((err) => `  - ${err.path.join('.')}: ${err.message}`)
+                            .join('\n');
+                        throw new Error(`Validation failed for ${id}:\n${errors}`);
+                    }
+                }
+                const importsBlock = result.imports && result.imports.length > 0 ? `${result.imports.join('\n')}\n\n` : '';
+                const body = result.code ?? `export default ${JSON.stringify(result.data, null, 2)};`;
+                return importsBlock + body;
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                // Vite/Rollup plugin context: `this.error` halts the load with a meaningful message.
+                this.error(`vertesia-dev-server: failed to transform ${id}: ${message}`);
+            }
+        },
+    };
+}
+function findMatchingTransformer(id, transformers) {
+    for (const t of transformers) {
+        if (t.pattern.test(id))
+            return t;
+    }
+    return undefined;
+}
+function stripQuery(id) {
+    const i = id.indexOf('?');
+    return i >= 0 ? id.substring(0, i) : id;
+}
+//# sourceMappingURL=dev-server.js.map

package/lib/vite/dev-server.js.map

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

package/lib/vite/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Vite integration for Vertesia build tools.
+ *
+ * - `vertesiaDevServerPlugin` — transforms `?skill` / `?raw` / `?prompt` /
+ *   `?template` (and `?skills` / `?templates`) imports on the fly during
+ *   `vite dev`. Same transformer set as the `vertesia-build` CLI used at
+ *   build time, so source files behave identically in both modes.
+ *
+ * - `apiServerPlugin` — mounts a Hono tool server as Vite middleware under
+ *   `/api`, with `vertesiaDevServerPlugin` already included so the tool
+ *   server's query-style imports work without extra wiring.
+ */
+export { type ApiServerPluginOptions, apiServerPlugin } from './api-server.js';
+export { type VertesiaDevServerPluginOptions, vertesiaDevServerPlugin } from './dev-server.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vite/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,KAAK,sBAAsB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EAAE,KAAK,8BAA8B,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC"}

package/lib/vite/index.js

@@ -0,0 +1,15 @@
+/**
+ * Vite integration for Vertesia build tools.
+ *
+ * - `vertesiaDevServerPlugin` — transforms `?skill` / `?raw` / `?prompt` /
+ *   `?template` (and `?skills` / `?templates`) imports on the fly during
+ *   `vite dev`. Same transformer set as the `vertesia-build` CLI used at
+ *   build time, so source files behave identically in both modes.
+ *
+ * - `apiServerPlugin` — mounts a Hono tool server as Vite middleware under
+ *   `/api`, with `vertesiaDevServerPlugin` already included so the tool
+ *   server's query-style imports work without extra wiring.
+ */
+export { apiServerPlugin } from './api-server.js';
+export { vertesiaDevServerPlugin } from './dev-server.js';
+//# sourceMappingURL=index.js.map

package/lib/vite/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vite/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAA+B,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EAAuC,uBAAuB,EAAE,MAAM,iBAAiB,CAAC"}