powerlines 0.37.62 → 0.37.64

package/dist/api.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkW6EJUB3S_cjs = require('./chunk-W6EJUB3S.cjs');
+var chunkHS5JA66T_cjs = require('./chunk-HS5JA66T.cjs');
 require('./chunk-B6DVCLP5.cjs');
 require('./chunk-V5WOGN7O.cjs');
 require('./chunk-Z6ARQDHR.cjs');
@@ -10,7 +10,7 @@ require('./chunk-PK6SKIKE.cjs');
 
 Object.defineProperty(exports, "PowerlinesAPI", {
   enumerable: true,
-  get: function () { return chunkW6EJUB3S_cjs.PowerlinesAPI; }
+  get: function () { return chunkHS5JA66T_cjs.PowerlinesAPI; }
 });
 //# sourceMappingURL=api.cjs.map
 //# sourceMappingURL=api.cjs.map

package/dist/api.js

@@ -1,4 +1,4 @@
-export { PowerlinesAPI } from './chunk-YPVXCIVO.js';
+export { PowerlinesAPI } from './chunk-K7NROKGA.js';
 import './chunk-PQXP7XQK.js';
 import './chunk-NITQ5IYP.js';
 import './chunk-2MYPFASJ.js';

package/dist/astro.cjs

@@ -2,10 +2,10 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var chunkIY62R4ON_cjs = require('./chunk-IY62R4ON.cjs');
+var chunkNJUPXMG2_cjs = require('./chunk-NJUPXMG2.cjs');
 require('./chunk-NSSJOBJ7.cjs');
-require('./chunk-EDURJN6H.cjs');
-require('./chunk-W6EJUB3S.cjs');
+require('./chunk-4LCVNG4B.cjs');
+require('./chunk-HS5JA66T.cjs');
 require('./chunk-B6DVCLP5.cjs');
 require('./chunk-V5WOGN7O.cjs');
 require('./chunk-Z6ARQDHR.cjs');
@@ -15,7 +15,7 @@ var chunkPK6SKIKE_cjs = require('./chunk-PK6SKIKE.cjs');
 var astro = /* @__PURE__ */ chunkPK6SKIKE_cjs.__name((config) => ({
   vite: {
     plugins: [
-      chunkIY62R4ON_cjs.vite_default(config)
+      chunkNJUPXMG2_cjs.vite_default(config)
     ]
   }
 }), "astro");

package/dist/astro.js

@@ -1,7 +1,7 @@
-import { vite_default } from './chunk-CU3OVPWB.js';
+import { vite_default } from './chunk-OQSCFQLD.js';
 import './chunk-6JXP537N.js';
-import './chunk-GFEZTRXL.js';
-import './chunk-YPVXCIVO.js';
+import './chunk-SJPKT4LT.js';
+import './chunk-K7NROKGA.js';
 import './chunk-PQXP7XQK.js';
 import './chunk-NITQ5IYP.js';
 import './chunk-2MYPFASJ.js';

package/dist/{chunk-MIFRMV2M.js → chunk-2ARCLHFU.js}

@@ -1,5 +1,5 @@
 import { extractESBuildConfig } from './chunk-6JXP537N.js';
-import { createUnpluginFactory } from './chunk-GFEZTRXL.js';
+import { createUnpluginFactory } from './chunk-SJPKT4LT.js';
 import { __name } from './chunk-7QVYU63E.js';
 import { isUndefined } from '@stryke/type-checks/is-undefined';
 import { createEsbuildPlugin } from 'unplugin';
@@ -29,5 +29,5 @@ var esbuild = createEsbuildPlugin(createUnpluginFactory("esbuild", (api, plugin)
 var esbuild_default = esbuild;
 
 export { esbuild, esbuild_default };
-//# sourceMappingURL=chunk-MIFRMV2M.js.map
-//# sourceMappingURL=chunk-MIFRMV2M.js.map
+//# sourceMappingURL=chunk-2ARCLHFU.js.map
+//# sourceMappingURL=chunk-2ARCLHFU.js.map

package/dist/chunk-3AZ6WGHP.cjs

@@ -0,0 +1,12 @@
+'use strict';
+
+var chunk4LCVNG4B_cjs = require('./chunk-4LCVNG4B.cjs');
+var unplugin = require('unplugin');
+
+var rolldown = unplugin.createRolldownPlugin(chunk4LCVNG4B_cjs.createUnpluginFactory("rolldown"));
+var rolldown_default = rolldown;
+
+exports.rolldown = rolldown;
+exports.rolldown_default = rolldown_default;
+//# sourceMappingURL=chunk-3AZ6WGHP.cjs.map
+//# sourceMappingURL=chunk-3AZ6WGHP.cjs.map

package/dist/{chunk-EDURJN6H.cjs → chunk-4LCVNG4B.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkW6EJUB3S_cjs = require('./chunk-W6EJUB3S.cjs');
+var chunkHS5JA66T_cjs = require('./chunk-HS5JA66T.cjs');
 var chunkPK6SKIKE_cjs = require('./chunk-PK6SKIKE.cjs');
 var types = require('@storm-software/config-tools/types');
 var getWorkspaceRoot = require('@stryke/fs/get-workspace-root');
@@ -27,7 +27,7 @@ chunkPK6SKIKE_cjs.__name(getString, "getString");
 // src/lib/unplugin/factory.ts
 function createUnpluginFactory(variant, decorate) {
   return (config, meta) => {
-    const log = chunkW6EJUB3S_cjs.createLog("unplugin", config);
+    const log = chunkHS5JA66T_cjs.createLog("unplugin", config);
     log(types.LogLevelLabel.DEBUG, "Initializing Unplugin");
     try {
       const userConfig = {
@@ -38,7 +38,7 @@ function createUnpluginFactory(variant, decorate) {
       let api;
       async function buildStart() {
         log(types.LogLevelLabel.DEBUG, "Powerlines build plugin starting...");
-        api = await chunkW6EJUB3S_cjs.PowerlinesAPI.from(getWorkspaceRoot.getWorkspaceRoot(process.cwd()), userConfig);
+        api = await chunkHS5JA66T_cjs.PowerlinesAPI.from(getWorkspaceRoot.getWorkspaceRoot(process.cwd()), userConfig);
         unplugin.setParseImpl(api.context.parse);
         log(types.LogLevelLabel.DEBUG, "Preparing build artifacts for the Powerlines project...");
         await api.prepare({
@@ -137,5 +137,5 @@ chunkPK6SKIKE_cjs.__name(createUnpluginFactory, "createUnpluginFactory");
 
 exports.createUnpluginFactory = createUnpluginFactory;
 exports.getString = getString;
-//# sourceMappingURL=chunk-EDURJN6H.cjs.map
-//# sourceMappingURL=chunk-EDURJN6H.cjs.map
+//# sourceMappingURL=chunk-4LCVNG4B.cjs.map
+//# sourceMappingURL=chunk-4LCVNG4B.cjs.map

package/dist/{chunk-W6EJUB3S.cjs → chunk-HS5JA66T.cjs}

@@ -110,7 +110,7 @@ var $__namespace = /*#__PURE__*/_interopNamespace($);
 
 // package.json
 var name = "powerlines";
-var version = "0.37.61";
+var version = "0.37.63";
 var package_default = {
   version};
 
@@ -331,6 +331,7 @@ function createProgram(context, override) {
 chunkPK6SKIKE_cjs.__name(createProgram, "createProgram");
 
 // src/internal/helpers/generate-types.ts
+var getModuleCommentBlockRegex = /* @__PURE__ */ chunkPK6SKIKE_cjs.__name((moduleId) => new RegExp(`^\\/\\*\\*(?s:.)*@module ${moduleId}(?s:.)*\\*\\/s*`), "getModuleCommentBlockRegex");
 function formatTypes(code) {
   return code.replace(
     // eslint-disable-next-line regexp/no-super-linear-backtracking
@@ -382,9 +383,14 @@ async function emitBuiltinTypes(context, files) {
     context.trace(`Processing emitted type declaration file: ${emittedFile.filePath}`);
     const filePath = append.appendPath(emittedFile.filePath, context.workspaceConfig.workspaceRoot);
     if (!filePath.endsWith(".map") && filePathFns.findFileName(filePath) !== "tsconfig.tsbuildinfo" && isParentPath.isParentPath(filePath, context.builtinsPath)) {
-      builtinModules += `
-declare module "${context.config.output?.builtinPrefix || context.config?.framework || "powerlines"}:${replace.replaceExtension(replace.replacePath(filePath, context.builtinsPath))}" {
-    ${emittedFile.text.trim().replace(/^\s*export\s*declare\s*/gm, "export ").replace(/^\s*declare\s*/gm, "")}
+      const moduleId = `${context.config.output?.builtinPrefix || context.config?.framework || "powerlines"}:${replace.replaceExtension(replace.replacePath(filePath, context.builtinsPath), "", {
+        fullExtension: true
+      })}`;
+      const moduleComment = emittedFile.text.match(getModuleCommentBlockRegex(moduleId))?.find((comment) => isSetString.isSetString(comment?.trim()));
+      builtinModules += `${moduleComment ? `
+${moduleComment.trim()}` : ""}
+declare module "${moduleId}" {
+    ${emittedFile.text.replace(moduleComment ?? "", "").trim().replace(/^\s*export\s*declare\s*/gm, "export ").replace(/^\s*declare\s*/gm, "")}
 }
 `;
     }
@@ -5103,5 +5109,5 @@ exports.extendLog = extendLog;
 exports.isUnpluginBuilderVariant = isUnpluginBuilderVariant;
 exports.name = name;
 exports.version = version;
-//# sourceMappingURL=chunk-W6EJUB3S.cjs.map
-//# sourceMappingURL=chunk-W6EJUB3S.cjs.map
+//# sourceMappingURL=chunk-HS5JA66T.cjs.map
+//# sourceMappingURL=chunk-HS5JA66T.cjs.map

package/dist/{chunk-YPVXCIVO.js → chunk-K7NROKGA.js}

@@ -81,7 +81,7 @@ import '@stryke/fs/remove-file';
 
 // package.json
 var name = "powerlines";
-var version = "0.37.61";
+var version = "0.37.63";
 var package_default = {
   version};
 
@@ -302,6 +302,7 @@ function createProgram(context, override) {
 __name(createProgram, "createProgram");
 
 // src/internal/helpers/generate-types.ts
+var getModuleCommentBlockRegex = /* @__PURE__ */ __name((moduleId) => new RegExp(`^\\/\\*\\*(?s:.)*@module ${moduleId}(?s:.)*\\*\\/s*`), "getModuleCommentBlockRegex");
 function formatTypes(code) {
   return code.replace(
     // eslint-disable-next-line regexp/no-super-linear-backtracking
@@ -353,9 +354,14 @@ async function emitBuiltinTypes(context, files) {
     context.trace(`Processing emitted type declaration file: ${emittedFile.filePath}`);
     const filePath = appendPath(emittedFile.filePath, context.workspaceConfig.workspaceRoot);
     if (!filePath.endsWith(".map") && findFileName(filePath) !== "tsconfig.tsbuildinfo" && isParentPath(filePath, context.builtinsPath)) {
-      builtinModules += `
-declare module "${context.config.output?.builtinPrefix || context.config?.framework || "powerlines"}:${replaceExtension(replacePath(filePath, context.builtinsPath))}" {
-    ${emittedFile.text.trim().replace(/^\s*export\s*declare\s*/gm, "export ").replace(/^\s*declare\s*/gm, "")}
+      const moduleId = `${context.config.output?.builtinPrefix || context.config?.framework || "powerlines"}:${replaceExtension(replacePath(filePath, context.builtinsPath), "", {
+        fullExtension: true
+      })}`;
+      const moduleComment = emittedFile.text.match(getModuleCommentBlockRegex(moduleId))?.find((comment) => isSetString(comment?.trim()));
+      builtinModules += `${moduleComment ? `
+${moduleComment.trim()}` : ""}
+declare module "${moduleId}" {
+    ${emittedFile.text.replace(moduleComment ?? "", "").trim().replace(/^\s*export\s*declare\s*/gm, "export ").replace(/^\s*declare\s*/gm, "")}
 }
 `;
     }
@@ -5062,5 +5068,5 @@ Note: Please ensure the plugin package's default export is a class that extends
 };
 
 export { FileId, FileMetadata, FileMetadata_KeyValuePair, FileStorage, FileSystem, PowerlinesAPI, _capnpFileId, combineContexts, createLog, extendLog, isUnpluginBuilderVariant, name, version };
-//# sourceMappingURL=chunk-YPVXCIVO.js.map
-//# sourceMappingURL=chunk-YPVXCIVO.js.map
+//# sourceMappingURL=chunk-K7NROKGA.js.map
+//# sourceMappingURL=chunk-K7NROKGA.js.map

package/dist/{chunk-IY62R4ON.cjs → chunk-NJUPXMG2.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
 var chunkNSSJOBJ7_cjs = require('./chunk-NSSJOBJ7.cjs');
-var chunkEDURJN6H_cjs = require('./chunk-EDURJN6H.cjs');
+var chunk4LCVNG4B_cjs = require('./chunk-4LCVNG4B.cjs');
 var chunkPK6SKIKE_cjs = require('./chunk-PK6SKIKE.cjs');
 var environmentChecks = require('@stryke/env/environment-checks');
 var defu = require('defu');
@@ -98,7 +98,7 @@ function extractViteConfig(context) {
 chunkPK6SKIKE_cjs.__name(extractViteConfig, "extractViteConfig");
 
 // src/vite.ts
-var vite = unplugin.createVitePlugin(chunkEDURJN6H_cjs.createUnpluginFactory("vite", (api, plugin) => {
+var vite = unplugin.createVitePlugin(chunk4LCVNG4B_cjs.createUnpluginFactory("vite", (api, plugin) => {
   return {
     ...plugin,
     vite: {
@@ -159,5 +159,5 @@ var vite_default = vite;
 
 exports.vite = vite;
 exports.vite_default = vite_default;
-//# sourceMappingURL=chunk-IY62R4ON.cjs.map
-//# sourceMappingURL=chunk-IY62R4ON.cjs.map
+//# sourceMappingURL=chunk-NJUPXMG2.cjs.map
+//# sourceMappingURL=chunk-NJUPXMG2.cjs.map

package/dist/{chunk-CU3OVPWB.js → chunk-OQSCFQLD.js}

@@ -1,5 +1,5 @@
 import { extractESBuildConfig } from './chunk-6JXP537N.js';
-import { createUnpluginFactory } from './chunk-GFEZTRXL.js';
+import { createUnpluginFactory } from './chunk-SJPKT4LT.js';
 import { __name } from './chunk-7QVYU63E.js';
 import { isDevelopmentMode, isTestMode } from '@stryke/env/environment-checks';
 import defu from 'defu';
@@ -152,5 +152,5 @@ var vite = createVitePlugin(createUnpluginFactory("vite", (api, plugin) => {
 var vite_default = vite;
 
 export { vite, vite_default };
-//# sourceMappingURL=chunk-CU3OVPWB.js.map
-//# sourceMappingURL=chunk-CU3OVPWB.js.map
+//# sourceMappingURL=chunk-OQSCFQLD.js.map
+//# sourceMappingURL=chunk-OQSCFQLD.js.map

package/dist/{chunk-2D4DO5EB.js → chunk-QVPFNUOE.js}

@@ -1,9 +1,9 @@
-import { createUnpluginFactory } from './chunk-GFEZTRXL.js';
+import { createUnpluginFactory } from './chunk-SJPKT4LT.js';
 import { createRolldownPlugin } from 'unplugin';
 
 var rolldown = createRolldownPlugin(createUnpluginFactory("rolldown"));
 var rolldown_default = rolldown;
 
 export { rolldown, rolldown_default };
-//# sourceMappingURL=chunk-2D4DO5EB.js.map
-//# sourceMappingURL=chunk-2D4DO5EB.js.map
+//# sourceMappingURL=chunk-QVPFNUOE.js.map
+//# sourceMappingURL=chunk-QVPFNUOE.js.map

package/dist/chunk-QXEDDRR2.cjs

@@ -0,0 +1,12 @@
+'use strict';
+
+var chunk4LCVNG4B_cjs = require('./chunk-4LCVNG4B.cjs');
+var unplugin = require('unplugin');
+
+var webpack = unplugin.createWebpackPlugin(chunk4LCVNG4B_cjs.createUnpluginFactory("webpack"));
+var webpack_default = webpack;
+
+exports.webpack = webpack;
+exports.webpack_default = webpack_default;
+//# sourceMappingURL=chunk-QXEDDRR2.cjs.map
+//# sourceMappingURL=chunk-QXEDDRR2.cjs.map

package/dist/{chunk-4XAVV5HA.cjs → chunk-R4KILD2W.cjs}

@@ -1,12 +1,12 @@
 'use strict';
 
 var chunkNSSJOBJ7_cjs = require('./chunk-NSSJOBJ7.cjs');
-var chunkEDURJN6H_cjs = require('./chunk-EDURJN6H.cjs');
+var chunk4LCVNG4B_cjs = require('./chunk-4LCVNG4B.cjs');
 var chunkPK6SKIKE_cjs = require('./chunk-PK6SKIKE.cjs');
 var isUndefined = require('@stryke/type-checks/is-undefined');
 var unplugin = require('unplugin');
 
-var esbuild = unplugin.createEsbuildPlugin(chunkEDURJN6H_cjs.createUnpluginFactory("esbuild", (api, plugin) => {
+var esbuild = unplugin.createEsbuildPlugin(chunk4LCVNG4B_cjs.createUnpluginFactory("esbuild", (api, plugin) => {
   return {
     ...plugin,
     esbuild: {
@@ -32,5 +32,5 @@ var esbuild_default = esbuild;
 
 exports.esbuild = esbuild;
 exports.esbuild_default = esbuild_default;
-//# sourceMappingURL=chunk-4XAVV5HA.cjs.map
-//# sourceMappingURL=chunk-4XAVV5HA.cjs.map
+//# sourceMappingURL=chunk-R4KILD2W.cjs.map
+//# sourceMappingURL=chunk-R4KILD2W.cjs.map

package/dist/{chunk-GFEZTRXL.js → chunk-SJPKT4LT.js}

@@ -1,4 +1,4 @@
-import { createLog, PowerlinesAPI } from './chunk-YPVXCIVO.js';
+import { createLog, PowerlinesAPI } from './chunk-K7NROKGA.js';
 import { __name } from './chunk-7QVYU63E.js';
 import { LogLevelLabel } from '@storm-software/config-tools/types';
 import { getWorkspaceRoot } from '@stryke/fs/get-workspace-root';
@@ -134,5 +134,5 @@ function createUnpluginFactory(variant, decorate) {
 __name(createUnpluginFactory, "createUnpluginFactory");
 
 export { createUnpluginFactory, getString };
-//# sourceMappingURL=chunk-GFEZTRXL.js.map
-//# sourceMappingURL=chunk-GFEZTRXL.js.map
+//# sourceMappingURL=chunk-SJPKT4LT.js.map
+//# sourceMappingURL=chunk-SJPKT4LT.js.map

package/dist/{chunk-4NWPQX5R.js → chunk-V22EVTLB.js}

@@ -1,9 +1,9 @@
-import { createUnpluginFactory } from './chunk-GFEZTRXL.js';
+import { createUnpluginFactory } from './chunk-SJPKT4LT.js';
 import { createWebpackPlugin } from 'unplugin';
 
 var webpack = createWebpackPlugin(createUnpluginFactory("webpack"));
 var webpack_default = webpack;
 
 export { webpack, webpack_default };
-//# sourceMappingURL=chunk-4NWPQX5R.js.map
-//# sourceMappingURL=chunk-4NWPQX5R.js.map
+//# sourceMappingURL=chunk-V22EVTLB.js.map
+//# sourceMappingURL=chunk-V22EVTLB.js.map

package/dist/esbuild.cjs

@@ -2,10 +2,10 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var chunk4XAVV5HA_cjs = require('./chunk-4XAVV5HA.cjs');
+var chunkR4KILD2W_cjs = require('./chunk-R4KILD2W.cjs');
 require('./chunk-NSSJOBJ7.cjs');
-require('./chunk-EDURJN6H.cjs');
-require('./chunk-W6EJUB3S.cjs');
+require('./chunk-4LCVNG4B.cjs');
+require('./chunk-HS5JA66T.cjs');
 require('./chunk-B6DVCLP5.cjs');
 require('./chunk-V5WOGN7O.cjs');
 require('./chunk-Z6ARQDHR.cjs');
@@ -15,15 +15,15 @@ require('./chunk-PK6SKIKE.cjs');
 
 Object.defineProperty(exports, "default", {
   enumerable: true,
-  get: function () { return chunk4XAVV5HA_cjs.esbuild_default; }
+  get: function () { return chunkR4KILD2W_cjs.esbuild_default; }
 });
 Object.defineProperty(exports, "esbuild", {
   enumerable: true,
-  get: function () { return chunk4XAVV5HA_cjs.esbuild; }
+  get: function () { return chunkR4KILD2W_cjs.esbuild; }
 });
 Object.defineProperty(exports, "module.exports", {
   enumerable: true,
-  get: function () { return chunk4XAVV5HA_cjs.esbuild; }
+  get: function () { return chunkR4KILD2W_cjs.esbuild; }
 });
 //# sourceMappingURL=esbuild.cjs.map
 //# sourceMappingURL=esbuild.cjs.map

package/dist/esbuild.js

@@ -1,7 +1,7 @@
-export { esbuild_default as default, esbuild, esbuild as "module.exports" } from './chunk-MIFRMV2M.js';
+export { esbuild_default as default, esbuild, esbuild as "module.exports" } from './chunk-2ARCLHFU.js';
 import './chunk-6JXP537N.js';
-import './chunk-GFEZTRXL.js';
-import './chunk-YPVXCIVO.js';
+import './chunk-SJPKT4LT.js';
+import './chunk-K7NROKGA.js';
 import './chunk-PQXP7XQK.js';
 import './chunk-NITQ5IYP.js';
 import './chunk-2MYPFASJ.js';

package/dist/farm.cjs

@@ -2,15 +2,15 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var chunkEDURJN6H_cjs = require('./chunk-EDURJN6H.cjs');
-require('./chunk-W6EJUB3S.cjs');
+var chunk4LCVNG4B_cjs = require('./chunk-4LCVNG4B.cjs');
+require('./chunk-HS5JA66T.cjs');
 require('./chunk-B6DVCLP5.cjs');
 require('./chunk-V5WOGN7O.cjs');
 require('./chunk-Z6ARQDHR.cjs');
 require('./chunk-PK6SKIKE.cjs');
 var unplugin = require('unplugin');
 
-var farm = unplugin.createFarmPlugin(chunkEDURJN6H_cjs.createUnpluginFactory("farm"));
+var farm = unplugin.createFarmPlugin(chunk4LCVNG4B_cjs.createUnpluginFactory("farm"));
 var farm_default = farm;
 
 exports.default = farm_default;

package/dist/farm.js

@@ -1,5 +1,5 @@
-import { createUnpluginFactory } from './chunk-GFEZTRXL.js';
-import './chunk-YPVXCIVO.js';
+import { createUnpluginFactory } from './chunk-SJPKT4LT.js';
+import './chunk-K7NROKGA.js';
 import './chunk-PQXP7XQK.js';
 import './chunk-NITQ5IYP.js';
 import './chunk-2MYPFASJ.js';

package/dist/index.cjs

@@ -13,7 +13,7 @@ require('./chunk-4JCNAKOE.cjs');
 require('./chunk-D6GGZQLC.cjs');
 var chunkA7AUGAHH_cjs = require('./chunk-A7AUGAHH.cjs');
 var chunk42ZHOCZJ_cjs = require('./chunk-42ZHOCZJ.cjs');
-var chunkW6EJUB3S_cjs = require('./chunk-W6EJUB3S.cjs');
+var chunkHS5JA66T_cjs = require('./chunk-HS5JA66T.cjs');
 var chunkB6DVCLP5_cjs = require('./chunk-B6DVCLP5.cjs');
 var chunkV5WOGN7O_cjs = require('./chunk-V5WOGN7O.cjs');
 var chunkZ6ARQDHR_cjs = require('./chunk-Z6ARQDHR.cjs');
@@ -27,10 +27,10 @@ chunkPK6SKIKE_cjs.__name(defineConfig, "defineConfig");
 async function createPowerlines(options = {}) {
   options.root ??= process.cwd();
   const workspaceRoot = getWorkspaceRoot.getWorkspaceRoot(options.root);
-  return chunkW6EJUB3S_cjs.PowerlinesAPI.from(workspaceRoot, options);
+  return chunkHS5JA66T_cjs.PowerlinesAPI.from(workspaceRoot, options);
 }
 chunkPK6SKIKE_cjs.__name(createPowerlines, "createPowerlines");
-var index_default = chunkW6EJUB3S_cjs.PowerlinesAPI;
+var index_default = chunkHS5JA66T_cjs.PowerlinesAPI;
 
 Object.defineProperty(exports, "STORAGE_PRESETS", {
   enumerable: true,
@@ -50,31 +50,31 @@ Object.defineProperty(exports, "HOOKS_LIST_ORDERS", {
 });
 Object.defineProperty(exports, "FileId", {
   enumerable: true,
-  get: function () { return chunkW6EJUB3S_cjs.FileId; }
+  get: function () { return chunkHS5JA66T_cjs.FileId; }
 });
 Object.defineProperty(exports, "FileMetadata", {
   enumerable: true,
-  get: function () { return chunkW6EJUB3S_cjs.FileMetadata; }
+  get: function () { return chunkHS5JA66T_cjs.FileMetadata; }
 });
 Object.defineProperty(exports, "FileMetadata_KeyValuePair", {
   enumerable: true,
-  get: function () { return chunkW6EJUB3S_cjs.FileMetadata_KeyValuePair; }
+  get: function () { return chunkHS5JA66T_cjs.FileMetadata_KeyValuePair; }
 });
 Object.defineProperty(exports, "FileStorage", {
   enumerable: true,
-  get: function () { return chunkW6EJUB3S_cjs.FileStorage; }
+  get: function () { return chunkHS5JA66T_cjs.FileStorage; }
 });
 Object.defineProperty(exports, "FileSystem", {
   enumerable: true,
-  get: function () { return chunkW6EJUB3S_cjs.FileSystem; }
+  get: function () { return chunkHS5JA66T_cjs.FileSystem; }
 });
 Object.defineProperty(exports, "PowerlinesAPI", {
   enumerable: true,
-  get: function () { return chunkW6EJUB3S_cjs.PowerlinesAPI; }
+  get: function () { return chunkHS5JA66T_cjs.PowerlinesAPI; }
 });
 Object.defineProperty(exports, "_capnpFileId", {
   enumerable: true,
-  get: function () { return chunkW6EJUB3S_cjs._capnpFileId; }
+  get: function () { return chunkHS5JA66T_cjs._capnpFileId; }
 });
 Object.defineProperty(exports, "KNOWN_PLUGIN_FIELDS", {
   enumerable: true,

package/dist/index.js

@@ -9,8 +9,8 @@ import './chunk-OYASPHNL.js';
 import './chunk-OD4BINRW.js';
 export { STORAGE_PRESETS, __VFS_PATCH__, __VFS_REVERT__ } from './chunk-KXRVVFNK.js';
 export { HOOKS_LIST_ORDERS } from './chunk-CCJQBJKQ.js';
-import { PowerlinesAPI } from './chunk-YPVXCIVO.js';
-export { FileId, FileMetadata, FileMetadata_KeyValuePair, FileStorage, FileSystem, PowerlinesAPI, _capnpFileId } from './chunk-YPVXCIVO.js';
+import { PowerlinesAPI } from './chunk-K7NROKGA.js';
+export { FileId, FileMetadata, FileMetadata_KeyValuePair, FileStorage, FileSystem, PowerlinesAPI, _capnpFileId } from './chunk-K7NROKGA.js';
 export { KNOWN_PLUGIN_FIELDS, PLUGIN_HOOKS_FIELDS, PLUGIN_NON_HOOK_FIELDS } from './chunk-PQXP7XQK.js';
 export { BUILDER_VARIANTS, UNPLUGIN_BUILDER_VARIANTS } from './chunk-NITQ5IYP.js';
 export { SUPPORTED_COMMANDS } from './chunk-2MYPFASJ.js';

package/dist/lib/{chunk-6CV42PFW.js → chunk-WO5GGRTA.js}

@@ -50,7 +50,7 @@ import { titleCase } from '@stryke/string-format/title-case';
 
 // package.json
 var package_default = {
-  version: "0.37.61"};
+  version: "0.37.63"};
 
 // src/plugin-utils/modules.ts
 function isBuiltinModule(context, moduleName) {
@@ -162,6 +162,7 @@ var moduleResolverBabelPlugin = /* @__PURE__ */ __name((context, options) => {
     };
   }, "builder"));
 }, "moduleResolverBabelPlugin");
+var getModuleCommentBlockRegex = /* @__PURE__ */ __name((moduleId) => new RegExp(`^\\/\\*\\*(?s:.)*@module ${moduleId}(?s:.)*\\*\\/s*`), "getModuleCommentBlockRegex");
 function formatTypes(code) {
   return code.replace(
     // eslint-disable-next-line regexp/no-super-linear-backtracking
@@ -213,9 +214,14 @@ async function emitBuiltinTypes(context, files) {
     context.trace(`Processing emitted type declaration file: ${emittedFile.filePath}`);
     const filePath = appendPath(emittedFile.filePath, context.workspaceConfig.workspaceRoot);
     if (!filePath.endsWith(".map") && findFileName(filePath) !== "tsconfig.tsbuildinfo" && isParentPath(filePath, context.builtinsPath)) {
-      builtinModules += `
-declare module "${context.config.output?.builtinPrefix || context.config?.framework || "powerlines"}:${replaceExtension(replacePath(filePath, context.builtinsPath))}" {
-    ${emittedFile.text.trim().replace(/^\s*export\s*declare\s*/gm, "export ").replace(/^\s*declare\s*/gm, "")}
+      const moduleId = `${context.config.output?.builtinPrefix || context.config?.framework || "powerlines"}:${replaceExtension(replacePath(filePath, context.builtinsPath), "", {
+        fullExtension: true
+      })}`;
+      const moduleComment = emittedFile.text.match(getModuleCommentBlockRegex(moduleId))?.find((comment) => isSetString(comment?.trim()));
+      builtinModules += `${moduleComment ? `
+${moduleComment.trim()}` : ""}
+declare module "${moduleId}" {
+    ${emittedFile.text.replace(moduleComment ?? "", "").trim().replace(/^\s*export\s*declare\s*/gm, "export ").replace(/^\s*declare\s*/gm, "")}
 }
 `;
     }
@@ -1266,5 +1272,5 @@ function createUnpluginFactory(variant, decorate) {
 __name(createUnpluginFactory, "createUnpluginFactory");
 
 export { createUnpluginFactory };
-//# sourceMappingURL=chunk-6CV42PFW.js.map
-//# sourceMappingURL=chunk-6CV42PFW.js.map
+//# sourceMappingURL=chunk-WO5GGRTA.js.map
+//# sourceMappingURL=chunk-WO5GGRTA.js.map