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

package/lib/{types → core}/types.d.ts

@@ -1,7 +1,7 @@
 /**
- * Type definitions for the Vertesia Rollup Import Plugin
+ * Type definitions shared across the Vertesia build-tools pipeline:
+ * transformers, transformer results, and asset metadata produced by them.
  */
-import type { Plugin } from 'rollup';
 import type { z } from 'zod';
 /**
  * Asset file to be copied during build
@@ -45,71 +45,15 @@ export interface TransformerRule {
     /** Transform function to convert file content */
     transform: TransformFunction;
     /** Optional: Zod schema for validation */
-    schema?: z.ZodType<any>;
+    schema?: z.ZodType<unknown>;
     /** Optional: If true, the transformer generates virtual modules (no file to read) */
     virtual?: boolean;
     /** Optional: additional options for this transformer */
     options?: Record<string, unknown>;
 }
 /**
- * Widget compilation configuration
- */
-export interface WidgetConfig {
-    /**
-     * External dependencies that should not be bundled
-     * Default: ['react', 'react-dom', 'react/jsx-runtime']
-     */
-    external?: string[];
-    /**
-     * Path to tsconfig.json for widget compilation
-     * Default: './tsconfig.json'
-     */
-    tsconfig?: string;
-    /**
-     * Additional options to pass to @rollup/plugin-typescript
-     */
-    typescript?: Record<string, unknown>;
-    /**
-     * Minify widget output
-     * Default: false
-     */
-    minify?: boolean;
-}
-/**
- * Plugin configuration
- */
-export interface PluginConfig {
-    /** Array of transformer rules to apply */
-    transformers: TransformerRule[];
-    /**
-     * Root directory for asset output (scripts, widgets, etc.)
-     * - If specified: assets will be copied to this directory
-     * - If false: asset copying is disabled
-     * - Default: './dist'
-     */
-    assetsDir?: string | false;
-    /**
-     * Directory for script files relative to assetsDir
-     * Default: 'scripts'
-     */
-    scriptsDir?: string;
-    /**
-     * Directory for widget files relative to assetsDir
-     * Default: 'widgets'
-     */
-    widgetsDir?: string;
-    /**
-     * Widget compilation configuration
-     * If provided, discovered widgets will be automatically compiled
-     */
-    widgetConfig?: WidgetConfig;
-}
-/**
- * Type for transformer presets
+ * Type for transformer presets — alias for `TransformerRule` used by the
+ * built-in preset modules (skill, raw, prompt, template, …).
  */
 export type TransformerPreset = TransformerRule;
-/**
- * Plugin factory return type
- */
-export type VertesiaImportPlugin = (config: PluginConfig) => Plugin;
 //# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IAEnB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IAEjB,oCAAoC;IACpC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,sDAAsD;IACtD,IAAI,EAAE,OAAO,CAAC;IAEd,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,+CAA+C;IAC/C,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IAErB,gDAAgD;IAChD,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAElH;;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,OAAO,CAAC,CAAC;IAE5B,qFAAqF;IACrF,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,eAAe,CAAC"}

package/lib/core/types.js

@@ -0,0 +1,6 @@
+/**
+ * Type definitions shared across the Vertesia build-tools pipeline:
+ * transformers, transformer results, and asset metadata produced by them.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/lib/{cjs → core}/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/lib/core/utils/asset-copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-copy.d.ts","sourceRoot":"","sources":["../../../src/core/utils/asset-copy.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAgB7C;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAiBxE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAS1E"}

package/lib/core/utils/asset-copy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-copy.js","sourceRoot":"","sources":["../../../src/core/utils/asset-copy.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B;;GAEG;AACH,SAAS,eAAe,CAAC,OAAe;IACpC,IAAI,CAAC;QACD,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,qCAAqC;QACrC,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAgB,EAAE,UAAkB;IAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEvC,sCAAsC;IACtC,eAAe,CAAC,OAAO,CAAC,CAAC;IAEzB,YAAY;IACZ,IAAI,CAAC;QACD,YAAY,CAAC,KAAK,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACX,6BAA6B,KAAK,CAAC,UAAU,OAAO,QAAQ,KACxD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACzD,EAAE,CACL,CAAC;IACN,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,MAAmB,EAAE,UAAkB;IAC9D,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACzB,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QACjC,MAAM,EAAE,CAAC;IACb,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/lib/core/utils/asset-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-discovery.d.ts","sourceRoot":"","sources":["../../../src/core/utils/asset-discovery.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IAEb,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,oDAAoD;IACpD,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,iDAAiD;IACjD,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,sCAAsC;IACtC,cAAc,EAAE,cAAc,EAAE,CAAC;IAEjC,+BAA+B;IAC/B,UAAU,EAAE,SAAS,EAAE,CAAC;CAC3B;AAgDD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAC/B,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;IACL,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CAClB,GACP,gBAAgB,CA0ClB"}

package/lib/{esm → core}/utils/asset-discovery.js

@@ -19,7 +19,7 @@ function isFile(filePath) {
  */
 function getFilesInDirectory(dirPath) {
     try {
-        return readdirSync(dirPath).filter(file => {
+        return readdirSync(dirPath).filter((file) => {
             const fullPath = path.join(dirPath, file);
             return isFile(fullPath);
         });
@@ -69,7 +69,7 @@ export function discoverSkillAssets(skillFilePath, options = {}) {
             assetFiles.push({
                 sourcePath: fullPath,
                 destPath: path.join(scriptsDir, file),
-                type: 'script'
+                type: 'script',
             });
         }
         else if (isWidgetFile(file)) {
@@ -78,7 +78,7 @@ export function discoverSkillAssets(skillFilePath, options = {}) {
             widgets.push(widgetName);
             widgetMetadata.push({
                 name: widgetName,
-                path: fullPath
+                path: fullPath,
             });
             // Note: We don't add widget .tsx files to assetFiles
             // Widgets are compiled by the plugin if widgetConfig is provided
@@ -88,7 +88,7 @@ export function discoverSkillAssets(skillFilePath, options = {}) {
         scripts,
         widgets,
         widgetMetadata,
-        assetFiles
+        assetFiles,
     };
 }
 //# sourceMappingURL=asset-discovery.js.map

package/lib/core/utils/asset-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-discovery.js","sourceRoot":"","sources":["../../../src/core/utils/asset-discovery.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,IAAI,MAAM,WAAW,CAAC;AA+B7B;;GAEG;AACH,SAAS,MAAM,CAAC,QAAgB;IAC5B,IAAI,CAAC;QACD,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,OAAe;IACxC,IAAI,CAAC;QACD,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;YACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC1C,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACP,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,QAAgB;IAClC,OAAO,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,QAAgB;IAClC,OAAO,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,QAAgB;IACnC,OAAO,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAC/B,aAAqB,EACrB,UAGI,EAAE;IAEN,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAE5C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,cAAc,GAAqB,EAAE,CAAC;IAC5C,MAAM,UAAU,GAAgB,EAAE,CAAC;IAEnC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,SAAS,CAAC;IAEnD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAE3C,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,2BAA2B;YAC3B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,UAAU,CAAC,IAAI,CAAC;gBACZ,UAAU,EAAE,QAAQ;gBACpB,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC;gBACrC,IAAI,EAAE,QAAQ;aACjB,CAAC,CAAC;QACP,CAAC;aAAM,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,qBAAqB;YACrB,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;YACvC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACzB,cAAc,CAAC,IAAI,CAAC;gBAChB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,QAAQ;aACjB,CAAC,CAAC;YAEH,qDAAqD;YACrD,iEAAiE;QACrE,CAAC;IACL,CAAC;IAED,OAAO;QACH,OAAO;QACP,OAAO;QACP,cAAc;QACd,UAAU;KACb,CAAC;AACN,CAAC"}

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

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

package/lib/{esm → core}/utils/template-asset-discovery.js

@@ -7,13 +7,9 @@ import path from 'node:path';
  * Files to exclude from template asset discovery
  * (source files and the template definition itself)
  */
-const EXCLUDED_PATTERNS = [
-    /^TEMPLATE\.md$/,
-    /\.ts$/,
-    /\.js$/,
-];
+const EXCLUDED_PATTERNS = [/^TEMPLATE\.md$/, /\.ts$/, /\.js$/];
 function isExcluded(fileName) {
-    return EXCLUDED_PATTERNS.some(p => p.test(fileName));
+    return EXCLUDED_PATTERNS.some((p) => p.test(fileName));
 }
 /**
  * Discover asset files in a template directory.
@@ -29,7 +25,7 @@ export function discoverTemplateAssets(templateFilePath, templatePath) {
     const assetFiles = [];
     let files;
     try {
-        files = readdirSync(templateDir).filter(file => {
+        files = readdirSync(templateDir).filter((file) => {
             try {
                 return statSync(path.join(templateDir, file)).isFile();
             }

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * CLI-friendly name registry for the built-in transformers.
+ *
+ * Names mirror the query-suffix convention used in source code:
+ *   `?skill`   → 'skill'
+ *   `?skills`  → 'skills'         (collection)
+ *   `?template`→ 'template'
+ *   `?templates`→ 'templates'     (collection)
+ *   `?prompt`  → 'prompt'
+ *   `?raw`     → 'raw'
+ */
+import type { TransformerRule } from '../core/types.js';
+export declare const BUILTIN_TRANSFORMERS: Readonly<Record<string, TransformerRule>>;
+/** Names of all registered transformers, in stable order. */
+export declare const BUILTIN_TRANSFORMER_NAMES: readonly string[];
+/**
+ * Resolve a list of transformer names to their concrete `TransformerRule`
+ * instances. Throws if any name is unknown.
+ */
+export declare function resolveTransformerNames(names: readonly string[]): TransformerRule[];
+//# sourceMappingURL=builtins.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../src/import-transform/builtins.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAOzE,CAAC;AAEH,6DAA6D;AAC7D,eAAO,MAAM,yBAAyB,EAAE,SAAS,MAAM,EAAqD,CAAC;AAE7G;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,eAAe,EAAE,CAmBnF"}

package/lib/import-transform/builtins.js

@@ -0,0 +1,50 @@
+/**
+ * CLI-friendly name registry for the built-in transformers.
+ *
+ * Names mirror the query-suffix convention used in source code:
+ *   `?skill`   → 'skill'
+ *   `?skills`  → 'skills'         (collection)
+ *   `?template`→ 'template'
+ *   `?templates`→ 'templates'     (collection)
+ *   `?prompt`  → 'prompt'
+ *   `?raw`     → 'raw'
+ */
+import { promptTransformer } from '../core/transformers/prompt.js';
+import { rawTransformer } from '../core/transformers/raw.js';
+import { skillTransformer } from '../core/transformers/skill.js';
+import { skillCollectionTransformer } from '../core/transformers/skill-collection.js';
+import { templateTransformer } from '../core/transformers/template.js';
+import { templateCollectionTransformer } from '../core/transformers/template-collection.js';
+export const BUILTIN_TRANSFORMERS = Object.freeze({
+    skill: skillTransformer,
+    skills: skillCollectionTransformer,
+    template: templateTransformer,
+    templates: templateCollectionTransformer,
+    prompt: promptTransformer,
+    raw: rawTransformer,
+});
+/** Names of all registered transformers, in stable order. */
+export const BUILTIN_TRANSFORMER_NAMES = Object.freeze(Object.keys(BUILTIN_TRANSFORMERS));
+/**
+ * Resolve a list of transformer names to their concrete `TransformerRule`
+ * instances. Throws if any name is unknown.
+ */
+export function resolveTransformerNames(names) {
+    const resolved = [];
+    const unknown = [];
+    for (const name of names) {
+        const rule = BUILTIN_TRANSFORMERS[name];
+        if (rule) {
+            resolved.push(rule);
+        }
+        else {
+            unknown.push(name);
+        }
+    }
+    if (unknown.length > 0) {
+        const known = BUILTIN_TRANSFORMER_NAMES.join(', ');
+        throw new Error(`Unknown transformer name(s): ${unknown.join(', ')}. Known transformers: ${known}.`);
+    }
+    return resolved;
+}
+//# sourceMappingURL=builtins.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.js","sourceRoot":"","sources":["../../src/import-transform/builtins.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,6BAA6B,EAAE,MAAM,6CAA6C,CAAC;AAG5F,MAAM,CAAC,MAAM,oBAAoB,GAA8C,MAAM,CAAC,MAAM,CAAC;IACzF,KAAK,EAAE,gBAAgB;IACvB,MAAM,EAAE,0BAA0B;IAClC,QAAQ,EAAE,mBAAmB;IAC7B,SAAS,EAAE,6BAA6B;IACxC,MAAM,EAAE,iBAAiB;IACzB,GAAG,EAAE,cAAc;CACtB,CAAC,CAAC;AAEH,6DAA6D;AAC7D,MAAM,CAAC,MAAM,yBAAyB,GAAsB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC;AAE7G;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAwB;IAC5D,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,IAAI,EAAE,CAAC;YACP,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;aAAM,CAAC;YACJ,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACL,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,gCAAgC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,yBAAyB,KAAK,GAAG,CAAC,CAAC;IACzG,CAAC;IAED,OAAO,QAAQ,CAAC;AACpB,CAAC"}

package/lib/import-transform/chunk-emitter.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Runs a transformer against a source file and writes the resulting module
+ * as a standalone `.js` chunk inside the lib output.
+ *
+ * The generated module mirrors the historical code produced by the legacy
+ * rollup `load()` hook — it supports `imports`, `code`, and default
+ * `export default <data>` payloads — so the runtime behavior of
+ * import-transformed builds matches the legacy rollup-based pipeline
+ * byte-for-byte.
+ */
+import type { AssetFile, TransformerRule } from '../core/types.js';
+import type { WidgetMetadata } from '../core/utils/asset-discovery.js';
+export interface EmittedChunk {
+    /** Absolute path of the written chunk. */
+    chunkPath: string;
+    /** Generated module source (the same bytes written to `chunkPath`). */
+    content: string;
+    /** Assets returned by the transformer that should be copied. */
+    assets: AssetFile[];
+    /** Widget entries returned by the transformer that should be bundled. */
+    widgets: WidgetMetadata[];
+}
+export declare function emitChunk(srcPath: string, chunkPath: string, transformer: TransformerRule): Promise<EmittedChunk>;
+//# sourceMappingURL=chunk-emitter.d.ts.map

package/lib/import-transform/chunk-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-emitter.d.ts","sourceRoot":"","sources":["../../src/import-transform/chunk-emitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEvE,MAAM,WAAW,YAAY;IACzB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAElB,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAEhB,gEAAgE;IAChE,MAAM,EAAE,SAAS,EAAE,CAAC;IAEpB,yEAAyE;IACzE,OAAO,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED,wBAAsB,SAAS,CAC3B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,eAAe,GAC7B,OAAO,CAAC,YAAY,CAAC,CAyBvB"}

package/lib/import-transform/chunk-emitter.js

@@ -0,0 +1,35 @@
+/**
+ * Runs a transformer against a source file and writes the resulting module
+ * as a standalone `.js` chunk inside the lib output.
+ *
+ * The generated module mirrors the historical code produced by the legacy
+ * rollup `load()` hook — it supports `imports`, `code`, and default
+ * `export default <data>` payloads — so the runtime behavior of
+ * import-transformed builds matches the legacy rollup-based pipeline
+ * byte-for-byte.
+ */
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+export async function emitChunk(srcPath, chunkPath, transformer) {
+    const content = transformer.virtual ? '' : readFileSync(srcPath, 'utf-8');
+    const result = await transformer.transform(content, srcPath);
+    if (transformer.schema) {
+        const validation = transformer.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 ${srcPath}:\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)};`;
+    const moduleCode = importsBlock + body;
+    mkdirSync(path.dirname(chunkPath), { recursive: true });
+    writeFileSync(chunkPath, moduleCode, 'utf-8');
+    return {
+        chunkPath,
+        content: moduleCode,
+        assets: result.assets ?? [],
+        widgets: result.widgets ?? [],
+    };
+}
+//# sourceMappingURL=chunk-emitter.js.map

package/lib/import-transform/chunk-emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-emitter.js","sourceRoot":"","sources":["../../src/import-transform/chunk-emitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,IAAI,MAAM,WAAW,CAAC;AAkB7B,MAAM,CAAC,KAAK,UAAU,SAAS,CAC3B,OAAe,EACf,SAAiB,EACjB,WAA4B;IAE5B,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAE7D,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;QACrB,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC7D,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5G,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,MAAM,MAAM,EAAE,CAAC,CAAC;QACpE,CAAC;IACL,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3G,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,kBAAkB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC;IACtF,MAAM,UAAU,GAAG,YAAY,GAAG,IAAI,CAAC;IAEvC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,aAAa,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAE9C,OAAO;QACH,SAAS;QACT,OAAO,EAAE,UAAU;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;QAC3B,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;KAChC,CAAC;AACN,CAAC"}

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

@@ -0,0 +1,24 @@
+/**
+ * Finds Vertesia query-style import specifiers inside a JavaScript source
+ * file and maps each one to the transformer that should handle it.
+ *
+ * The detector is regex-based and works on `tsc` output where import
+ * specifiers are preserved literally. It identifies any string literal that
+ * contains a known marker (`?skill`, `?raw`, …, or `/SKILL.md`) and then
+ * matches the specifier against the configured transformer patterns.
+ */
+import type { TransformerRule } from '../core/types.js';
+export interface ImportOccurrence {
+    /** The transformer whose pattern matched the specifier. */
+    transformer: TransformerRule;
+    /** The original specifier text (the value between the quotes). */
+    specifier: string;
+    /** Offset in the source where the opening quote begins. */
+    quoteStart: number;
+    /** Offset in the source where the closing quote ends (exclusive). */
+    quoteEnd: number;
+    /** The quote character used in the source. */
+    quote: "'" | '"' | '`';
+}
+export declare function detectQueryImports(content: string, transformers: TransformerRule[]): ImportOccurrence[];
+//# sourceMappingURL=detector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../src/import-transform/detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGxD,MAAM,WAAW,gBAAgB;IAC7B,2DAA2D;IAC3D,WAAW,EAAE,eAAe,CAAC;IAE7B,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAElB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IAEnB,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;IAEjB,8CAA8C;IAC9C,KAAK,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;CAC1B;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,GAAG,gBAAgB,EAAE,CAyBvG"}

package/lib/import-transform/detector.js

@@ -0,0 +1,34 @@
+/**
+ * Finds Vertesia query-style import specifiers inside a JavaScript source
+ * file and maps each one to the transformer that should handle it.
+ *
+ * The detector is regex-based and works on `tsc` output where import
+ * specifiers are preserved literally. It identifies any string literal that
+ * contains a known marker (`?skill`, `?raw`, …, or `/SKILL.md`) and then
+ * matches the specifier against the configured transformer patterns.
+ */
+import { QUERY_STRING_LITERAL } from './patterns.js';
+export function detectQueryImports(content, transformers) {
+    const occurrences = [];
+    QUERY_STRING_LITERAL.lastIndex = 0;
+    let match;
+    // biome-ignore lint/suspicious/noAssignInExpressions: standard regex.exec loop
+    while ((match = QUERY_STRING_LITERAL.exec(content)) !== null) {
+        const quote = match[1];
+        const specifier = match[2];
+        for (const transformer of transformers) {
+            if (transformer.pattern.test(specifier)) {
+                occurrences.push({
+                    transformer,
+                    specifier,
+                    quoteStart: match.index,
+                    quoteEnd: match.index + match[0].length,
+                    quote,
+                });
+                break;
+            }
+        }
+    }
+    return occurrences;
+}
+//# sourceMappingURL=detector.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"detector.js","sourceRoot":"","sources":["../../src/import-transform/detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAmBrD,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,YAA+B;IAC/E,MAAM,WAAW,GAAuB,EAAE,CAAC;IAC3C,oBAAoB,CAAC,SAAS,GAAG,CAAC,CAAC;IAEnC,IAAI,KAA6B,CAAC;IAClC,+EAA+E;IAC/E,OAAO,CAAC,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC3D,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAoB,CAAC;QAC1C,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAE3B,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;YACrC,IAAI,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;gBACtC,WAAW,CAAC,IAAI,CAAC;oBACb,WAAW;oBACX,SAAS;oBACT,UAAU,EAAE,KAAK,CAAC,KAAK;oBACvB,QAAQ,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM;oBACvC,KAAK;iBACR,CAAC,CAAC;gBACH,MAAM;YACV,CAAC;QACL,CAAC;IACL,CAAC;IAED,OAAO,WAAW,CAAC;AACvB,CAAC"}

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

@@ -0,0 +1,47 @@
+/**
+ * Standalone import transformer for Vertesia query-style imports.
+ *
+ * Operates directly on the JavaScript output of `tsc`:
+ *
+ *   1. Walk `libDir` for `.js` files containing query imports.
+ *   2. For each occurrence, resolve back to the corresponding source asset
+ *      under `srcDir`, run the transformer, and write the generated module
+ *      as a sibling chunk in `libDir`.
+ *   3. Rewrite the importing file in place so the original `?skill` /
+ *      `SKILL.md` specifier points at the new chunk.
+ *   4. Copy any transformer-declared assets (scripts, handlebars, …) and
+ *      bundle any discovered widget `.tsx` siblings via esbuild.
+ *
+ * Emitted chunks are re-scanned for nested query imports (e.g. a `?skills`
+ * collection chunk that imports `SKILL.md` siblings), so the pipeline
+ * matches rollup's recursive resolveId/load behavior.
+ */
+import { type WidgetCompilerConfig } from '../core/compilers/widget.js';
+import type { TransformerRule } from '../core/types.js';
+export interface TransformImportsOptions {
+    /** Root of the compiled JavaScript output (e.g. `./lib`). */
+    libDir: string;
+    /** Root of the original sources, mirroring `libDir` (e.g. `./src`). */
+    srcDir: string;
+    /** Transformers to apply. */
+    transformers: TransformerRule[];
+    /**
+     * Root directory where script assets are copied and widgets are written.
+     * - String: assets and widgets are emitted under this directory.
+     * - `false`: asset copying and widget compilation are skipped.
+     * - Default: `libDir` (so widgets land in `lib/<widgetsDir>/`).
+     */
+    assetsDir?: string | false;
+    /** Sub-directory under `assetsDir` for widget bundles. Default: 'widgets'. */
+    widgetsDir?: string;
+    /** Configuration forwarded to the esbuild widget bundler. */
+    widgetConfig?: WidgetCompilerConfig;
+}
+export interface TransformImportsResult {
+    filesProcessed: number;
+    chunksEmitted: number;
+    assetsCopied: number;
+    widgetsCompiled: number;
+}
+export declare function transformImports(opts: TransformImportsOptions): Promise<TransformImportsResult>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/import-transform/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAkB,KAAK,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxF,OAAO,KAAK,EAAa,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAUnE,MAAM,WAAW,uBAAuB;IACpC,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IAEf,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;IAEf,6BAA6B;IAC7B,YAAY,EAAE,eAAe,EAAE,CAAC;IAEhC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAE3B,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,oBAAoB,CAAC;CACvC;AAED,MAAM,WAAW,sBAAsB;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CAC3B;AAOD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA2FrG"}

package/lib/import-transform/index.js

@@ -0,0 +1,115 @@
+/**
+ * Standalone import transformer for Vertesia query-style imports.
+ *
+ * Operates directly on the JavaScript output of `tsc`:
+ *
+ *   1. Walk `libDir` for `.js` files containing query imports.
+ *   2. For each occurrence, resolve back to the corresponding source asset
+ *      under `srcDir`, run the transformer, and write the generated module
+ *      as a sibling chunk in `libDir`.
+ *   3. Rewrite the importing file in place so the original `?skill` /
+ *      `SKILL.md` specifier points at the new chunk.
+ *   4. Copy any transformer-declared assets (scripts, handlebars, …) and
+ *      bundle any discovered widget `.tsx` siblings via esbuild.
+ *
+ * Emitted chunks are re-scanned for nested query imports (e.g. a `?skills`
+ * collection chunk that imports `SKILL.md` siblings), so the pipeline
+ * matches rollup's recursive resolveId/load behavior.
+ */
+import path from 'node:path';
+import { compileWidgets } from '../core/compilers/widget.js';
+import { copyAssets } from '../core/utils/asset-copy.js';
+import { emitChunk } from './chunk-emitter.js';
+import { detectQueryImports } from './detector.js';
+import { SNIFF_PATTERN } from './patterns.js';
+import { resolveImport } from './resolver.js';
+import { writeRewrittenFile } from './rewriter.js';
+import { scanLibForQueryImports } from './scanner.js';
+export async function transformImports(opts) {
+    const { libDir, srcDir, transformers, widgetsDir = 'widgets', widgetConfig } = opts;
+    const assetsDir = opts.assetsDir === undefined ? libDir : opts.assetsDir;
+    const shouldCopyAssets = assetsDir !== false;
+    const shouldCompileWidgets = assetsDir !== false;
+    if (!transformers || transformers.length === 0) {
+        throw new Error('transformImports: At least one transformer must be configured');
+    }
+    const seenFiles = new Set();
+    const workQueue = [];
+    for (const file of scanLibForQueryImports(libDir)) {
+        if (!seenFiles.has(file.path)) {
+            seenFiles.add(file.path);
+            workQueue.push(file);
+        }
+    }
+    const emittedChunks = new Set();
+    const seenWidgets = new Map();
+    const assetsToCopy = [];
+    let chunksEmitted = 0;
+    let filesProcessed = 0;
+    while (workQueue.length > 0) {
+        const file = workQueue.shift();
+        const occurrences = detectQueryImports(file.content, transformers);
+        if (occurrences.length === 0) {
+            continue;
+        }
+        const replacements = [];
+        for (const occ of occurrences) {
+            const resolved = resolveImport(file.path, occ.specifier, libDir, srcDir);
+            if (!emittedChunks.has(resolved.chunkLibPath)) {
+                const emitted = await emitChunk(resolved.resolvedSrcPath, resolved.chunkLibPath, occ.transformer);
+                emittedChunks.add(resolved.chunkLibPath);
+                chunksEmitted++;
+                if (emitted.assets.length > 0 && shouldCopyAssets) {
+                    assetsToCopy.push(...emitted.assets);
+                }
+                if (emitted.widgets.length > 0 && shouldCompileWidgets) {
+                    for (const widget of emitted.widgets) {
+                        if (!seenWidgets.has(widget.path)) {
+                            seenWidgets.set(widget.path, widget);
+                        }
+                    }
+                }
+                // Chunks may themselves contain query imports (e.g. ?skills
+                // collection chunks emit `import './foo/SKILL.md'` lines).
+                if (SNIFF_PATTERN.test(emitted.content) && !seenFiles.has(resolved.chunkLibPath)) {
+                    seenFiles.add(resolved.chunkLibPath);
+                    workQueue.push({ path: resolved.chunkLibPath, content: emitted.content });
+                }
+            }
+            replacements.push({
+                quoteStart: occ.quoteStart,
+                quoteEnd: occ.quoteEnd,
+                quote: occ.quote,
+                newSpecifier: resolved.chunkSpecifier,
+            });
+        }
+        if (writeRewrittenFile(file.path, file.content, replacements)) {
+            filesProcessed++;
+        }
+    }
+    let assetsCopied = 0;
+    if (shouldCopyAssets && assetsToCopy.length > 0) {
+        assetsCopied = copyAssets(assetsToCopy, assetsDir);
+    }
+    let widgetsCompiled = 0;
+    if (shouldCompileWidgets && seenWidgets.size > 0) {
+        const widgetInputs = Array.from(seenWidgets.values()).map((widget) => ({
+            name: widget.name,
+            entry: mapSrcWidgetToLib(widget.path, srcDir, libDir),
+        }));
+        const widgetOutput = path.join(assetsDir, widgetsDir);
+        widgetsCompiled = await compileWidgets(widgetInputs, widgetOutput, widgetConfig);
+    }
+    return { filesProcessed, chunksEmitted, assetsCopied, widgetsCompiled };
+}
+/**
+ * Map a widget `.tsx` source path to its tsc-compiled `.js` counterpart in lib/.
+ */
+function mapSrcWidgetToLib(srcTsxPath, srcDir, libDir) {
+    const srcRoot = path.resolve(srcDir);
+    const libRoot = path.resolve(libDir);
+    const rel = path.relative(srcRoot, srcTsxPath);
+    const libRel = rel.replace(/\.tsx$/, '.js');
+    return path.join(libRoot, libRel);
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/import-transform/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,cAAc,EAA6B,MAAM,6BAA6B,CAAC;AAExF,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAA0B,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAuCtD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAA6B;IAChE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,GAAG,SAAS,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IACpF,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;IACzE,MAAM,gBAAgB,GAAG,SAAS,KAAK,KAAK,CAAC;IAC7C,MAAM,oBAAoB,GAAG,SAAS,KAAK,KAAK,CAAC;IAEjD,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACrF,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,MAAM,SAAS,GAAe,EAAE,CAAC;IAEjC,KAAK,MAAM,IAAI,IAAI,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACzB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;IACL,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IACxC,MAAM,WAAW,GAAG,IAAI,GAAG,EAA0B,CAAC;IACtD,MAAM,YAAY,GAAgB,EAAE,CAAC;IACrC,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,cAAc,GAAG,CAAC,CAAC;IAEvB,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,EAAc,CAAC;QAC3C,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACnE,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,SAAS;QACb,CAAC;QAED,MAAM,YAAY,GAAwB,EAAE,CAAC;QAE7C,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YAEzE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC5C,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;gBAClG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;gBACzC,aAAa,EAAE,CAAC;gBAEhB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,gBAAgB,EAAE,CAAC;oBAChD,YAAY,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;gBACzC,CAAC;gBACD,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,oBAAoB,EAAE,CAAC;oBACrD,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;wBACnC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;4BAChC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;wBACzC,CAAC;oBACL,CAAC;gBACL,CAAC;gBAED,4DAA4D;gBAC5D,2DAA2D;gBAC3D,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;oBAC/E,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;oBACrC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC9E,CAAC;YACL,CAAC;YAED,YAAY,CAAC,IAAI,CAAC;gBACd,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,YAAY,EAAE,QAAQ,CAAC,cAAc;aACxC,CAAC,CAAC;QACP,CAAC;QAED,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,CAAC;YAC5D,cAAc,EAAE,CAAC;QACrB,CAAC;IACL,CAAC;IAED,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,gBAAgB,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,YAAY,GAAG,UAAU,CAAC,YAAY,EAAE,SAAmB,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,IAAI,oBAAoB,IAAI,WAAW,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACnE,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,iBAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC;SACxD,CAAC,CAAC,CAAC;QACJ,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAmB,EAAE,UAAU,CAAC,CAAC;QAChE,eAAe,GAAG,MAAM,cAAc,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;IACrF,CAAC;IAED,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC;AAC5E,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,UAAkB,EAAE,MAAc,EAAE,MAAc;IACzE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACtC,CAAC"}

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

@@ -0,0 +1,25 @@
+/**
+ * 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 declare const QUERY_SUFFIXES: readonly ["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 declare const BARE_FILENAMES: readonly ["SKILL.md", "TEMPLATE.md"];
+/**
+ * Coarse sniff for whether a file body could contain any query-style imports.
+ * Cheap regex check before invoking the more expensive detector.
+ */
+export declare const SNIFF_PATTERN: RegExp;
+/**
+ * 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 declare const QUERY_STRING_LITERAL: RegExp;
+//# sourceMappingURL=patterns.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.d.ts","sourceRoot":"","sources":["../../src/import-transform/patterns.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc,wEAAyE,CAAC;AAErG;;;GAGG;AACH,eAAO,MAAM,cAAc,sCAAuC,CAAC;AAKnE;;;GAGG;AACH,eAAO,MAAM,aAAa,QAA8D,CAAC;AAEzF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,QAGhC,CAAC"}