@vertesia/build-tools 1.2.0 → 1.3.0-dev.20260620.061059Z

package/lib/import-transform/patterns.js

@@ -0,0 +1,27 @@
+/**
+ * Shared regex fragments used by the scanner, detector, and orchestrator to
+ * identify Vertesia query-style imports. Keep these in sync with the
+ * `pattern` field of each transformer in `core/transformers/`.
+ */
+/**
+ * Suffix tokens for `?xxx` query imports.
+ */
+export const QUERY_SUFFIXES = ['skill', 'raw', 'prompt', 'template', 'skills', 'templates'];
+/**
+ * Bare filename tokens that mark an import as a transform target without a
+ * `?query` suffix (e.g. `import skill from './my-skill/SKILL.md'`).
+ */
+export const BARE_FILENAMES = ['SKILL.md', 'TEMPLATE.md'];
+const QUERY_GROUP = QUERY_SUFFIXES.join('|');
+const BARE_GROUP = BARE_FILENAMES.map((name) => `\\/${name.replace('.', '\\.')}`).join('|');
+/**
+ * Coarse sniff for whether a file body could contain any query-style imports.
+ * Cheap regex check before invoking the more expensive detector.
+ */
+export const SNIFF_PATTERN = new RegExp(`\\?(?:${QUERY_GROUP})\\b|(?:${BARE_GROUP})\\b`);
+/**
+ * Matches a quoted string literal whose contents end with a query marker.
+ * Capture group 1 is the quote character; capture group 2 is the specifier.
+ */
+export const QUERY_STRING_LITERAL = new RegExp(`(['"\`])([^'"\`]*?(?:\\?(?:${QUERY_GROUP})|${BARE_GROUP})[^'"\`]*)\\1`, 'g');
+//# sourceMappingURL=patterns.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.js","sourceRoot":"","sources":["../../src/import-transform/patterns.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAU,CAAC;AAErG;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,UAAU,EAAE,aAAa,CAAU,CAAC;AAEnE,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7C,MAAM,UAAU,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE5F;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,MAAM,CAAC,SAAS,WAAW,WAAW,UAAU,MAAM,CAAC,CAAC;AAEzF;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,MAAM,CAC1C,8BAA8B,WAAW,KAAK,UAAU,eAAe,EACvE,GAAG,CACN,CAAC"}

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

@@ -0,0 +1,23 @@
+/**
+ * Resolves a query-style import specifier to:
+ *   1. the source file path in `src/` (where the original asset lives), and
+ *   2. the chunk path in `lib/` (where the generated module will be written),
+ *      and the new relative specifier to write back into the importing file.
+ *
+ * Path mapping rule: lib/ and src/ are mirror trees, so a file at
+ * `<libDir>/<rel>` corresponds to `<srcDir>/<rel>`.
+ */
+export interface ResolvedImport {
+    /** Specifier with any `?query` suffix stripped. */
+    cleanSpecifier: string;
+    /** Absolute lib/ path of the resolved (extension-preserved) target. */
+    resolvedLibPath: string;
+    /** Absolute src/ path of the same target. */
+    resolvedSrcPath: string;
+    /** Absolute lib/ path where the generated chunk will be written. */
+    chunkLibPath: string;
+    /** Relative specifier (importer-relative) that should replace the original. */
+    chunkSpecifier: string;
+}
+export declare function resolveImport(importerLibPath: string, specifier: string, libDir: string, srcDir: string): ResolvedImport;
+//# sourceMappingURL=resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/import-transform/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,cAAc;IAC3B,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAC;IAEvB,uEAAuE;IACvE,eAAe,EAAE,MAAM,CAAC;IAExB,6CAA6C;IAC7C,eAAe,EAAE,MAAM,CAAC;IAExB,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAC;IAErB,+EAA+E;IAC/E,cAAc,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,aAAa,CACzB,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACf,cAAc,CAsBhB"}

package/lib/import-transform/resolver.js

@@ -0,0 +1,30 @@
+/**
+ * Resolves a query-style import specifier to:
+ *   1. the source file path in `src/` (where the original asset lives), and
+ *   2. the chunk path in `lib/` (where the generated module will be written),
+ *      and the new relative specifier to write back into the importing file.
+ *
+ * Path mapping rule: lib/ and src/ are mirror trees, so a file at
+ * `<libDir>/<rel>` corresponds to `<srcDir>/<rel>`.
+ */
+import path from 'node:path';
+export function resolveImport(importerLibPath, specifier, libDir, srcDir) {
+    const queryIndex = specifier.indexOf('?');
+    const cleanSpecifier = queryIndex >= 0 ? specifier.substring(0, queryIndex) : specifier;
+    const importerDir = path.dirname(importerLibPath);
+    const resolvedLibPath = path.resolve(importerDir, cleanSpecifier);
+    const libRoot = path.resolve(libDir);
+    const srcRoot = path.resolve(srcDir);
+    const relFromLib = path.relative(libRoot, resolvedLibPath);
+    const resolvedSrcPath = path.join(srcRoot, relFromLib);
+    const chunkLibPath = `${resolvedLibPath}.js`;
+    const chunkSpecifier = `${cleanSpecifier}.js`;
+    return {
+        cleanSpecifier,
+        resolvedLibPath,
+        resolvedSrcPath,
+        chunkLibPath,
+        chunkSpecifier,
+    };
+}
+//# sourceMappingURL=resolver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/import-transform/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAmB7B,MAAM,UAAU,aAAa,CACzB,eAAuB,EACvB,SAAiB,EACjB,MAAc,EACd,MAAc;IAEd,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,cAAc,GAAG,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAExF,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAClD,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAElE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IAC3D,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAEvD,MAAM,YAAY,GAAG,GAAG,eAAe,KAAK,CAAC;IAC7C,MAAM,cAAc,GAAG,GAAG,cAAc,KAAK,CAAC;IAE9C,OAAO;QACH,cAAc;QACd,eAAe;QACf,eAAe;QACf,YAAY;QACZ,cAAc;KACjB,CAAC;AACN,CAAC"}

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