@powerlines/plugin-content-collections 0.1.116 → 0.1.118

package/dist/_virtual/rolldown_runtime.cjs

@@ -1 +1,29 @@
-var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));exports.__toESM=s;
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+
+exports.__toESM = __toESM;

package/dist/helpers/create-emitter.cjs

@@ -1 +1,33 @@
-const e=require(`../_virtual/rolldown_runtime.cjs`);let t=require(`node:events`);function n(){let e=new t.EventEmitter;function n(t,n){e.on(t,n)}function r(t,n){e.emit(t,n),typeof n==`object`&&n&&`error`in n&&e.emit(`_error`,{...n,_event:t}),e.emit(`_all`,{...n,_event:t})}return{on:n,emit:r}}exports.createEmitter=n;
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let node_events = require("node:events");
+
+//#region src/helpers/create-emitter.ts
+/**
+* Create an event emitter with typed events.
+*
+* @returns An event emitter instance with typed event handling.
+*/
+function createEmitter() {
+	const emitter = new node_events.EventEmitter();
+	function on(key, listener) {
+		emitter.on(key, listener);
+	}
+	function emit(key, event) {
+		emitter.emit(key, event);
+		if (typeof event === "object" && event !== null && "error" in event) emitter.emit("_error", {
+			...event,
+			_event: key
+		});
+		emitter.emit("_all", {
+			...event,
+			_event: key
+		});
+	}
+	return {
+		on,
+		emit
+	};
+}
+
+//#endregion
+exports.createEmitter = createEmitter;

package/dist/helpers/create-emitter.mjs

@@ -1 +1,32 @@
-import{EventEmitter as e}from"node:events";function t(){let t=new e;function n(e,n){t.on(e,n)}function r(e,n){t.emit(e,n),typeof n==`object`&&n&&`error`in n&&t.emit(`_error`,{...n,_event:e}),t.emit(`_all`,{...n,_event:e})}return{on:n,emit:r}}export{t as createEmitter};
+import { EventEmitter } from "node:events";
+
+//#region src/helpers/create-emitter.ts
+/**
+* Create an event emitter with typed events.
+*
+* @returns An event emitter instance with typed event handling.
+*/
+function createEmitter() {
+	const emitter = new EventEmitter();
+	function on(key, listener) {
+		emitter.on(key, listener);
+	}
+	function emit(key, event) {
+		emitter.emit(key, event);
+		if (typeof event === "object" && event !== null && "error" in event) emitter.emit("_error", {
+			...event,
+			_event: key
+		});
+		emitter.emit("_all", {
+			...event,
+			_event: key
+		});
+	}
+	return {
+		on,
+		emit
+	};
+}
+
+//#endregion
+export { createEmitter };

package/dist/helpers/create-writer.cjs

@@ -1,6 +1,41 @@
-const e=require(`../_virtual/rolldown_runtime.cjs`),t=require(`../powerlines/src/lib/utilities/file-header.cjs`);let n=require(`@content-collections/core`),r=require(`@stryke/path/join-paths`),i=require(`@stryke/string-format/kebab-case`),a=require(`pluralize`);a=e.__toESM(a);const o=e=>(0,a.default)(e.charAt(0).toUpperCase()+e.slice(1)),s=e=>`all${o(e)}`,c=e=>({createJavaScriptFile:async n=>e.emitBuiltin(`${t.getBaseFileHeader(e)}
-${n.collections.map(({name:e})=>`import ${s(e)} from "./${(0,i.kebabCase)(e)}";`).join(`
-`)}
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_file_header = require('../powerlines/src/lib/utilities/file-header.cjs');
+let __content_collections_core = require("@content-collections/core");
+let __stryke_path_join_paths = require("@stryke/path/join-paths");
+let __stryke_string_format_kebab_case = require("@stryke/string-format/kebab-case");
+let pluralize = require("pluralize");
+pluralize = require_rolldown_runtime.__toESM(pluralize);
 
-export { ${n.collections.map(({name:e})=>s(e)).join(`, `)} };
-`,`content`),createTypeDefinitionFile:async e=>Promise.resolve(),createDataFiles:async t=>{await Promise.all(t.map(async t=>e.config.contentCollections.outputPath?e.fs.write((0,r.joinPaths)(e.config.contentCollections.outputPath,(0,i.kebabCase)(t.name)),(0,n.serialize)(t.documents.map(e=>e.document))):e.emitBuiltin((0,n.serialize)(t.documents.map(e=>e.document)),(0,r.joinPaths)(`content`,(0,i.kebabCase)(t.name)))))}});exports.createWriter=c;
+//#region src/helpers/create-writer.ts
+const createConstName = (name) => {
+	return (0, pluralize.default)(name.charAt(0).toUpperCase() + name.slice(1));
+};
+const createArrayConstName = (name) => {
+	return `all${createConstName(name)}`;
+};
+/**
+*
+* @param context - The Powerlines build plugin
+* @returns
+*/
+const createWriter = (context) => {
+	return {
+		createJavaScriptFile: async (configuration) => {
+			return context.emitBuiltin(`${require_file_header.getBaseFileHeader(context)}
+${configuration.collections.map(({ name }) => `import ${createArrayConstName(name)} from "./${(0, __stryke_string_format_kebab_case.kebabCase)(name)}";`).join("\n")}
+
+export { ${configuration.collections.map(({ name }) => createArrayConstName(name)).join(", ")} };
+`, "content");
+		},
+		createTypeDefinitionFile: async (_) => Promise.resolve(),
+		createDataFiles: async (collections) => {
+			await Promise.all(collections.map(async (collection) => {
+				if (context.config.contentCollections.outputPath) return context.fs.write((0, __stryke_path_join_paths.joinPaths)(context.config.contentCollections.outputPath, (0, __stryke_string_format_kebab_case.kebabCase)(collection.name)), (0, __content_collections_core.serialize)(collection.documents.map((doc) => doc.document)));
+				return context.emitBuiltin((0, __content_collections_core.serialize)(collection.documents.map((doc) => doc.document)), (0, __stryke_path_join_paths.joinPaths)("content", (0, __stryke_string_format_kebab_case.kebabCase)(collection.name)));
+			}));
+		}
+	};
+};
+
+//#endregion
+exports.createWriter = createWriter;

package/dist/helpers/create-writer.mjs

@@ -1,6 +1,39 @@
-import{getBaseFileHeader as e}from"../powerlines/src/lib/utilities/file-header.mjs";import{serialize as t}from"@content-collections/core";import{joinPaths as n}from"@stryke/path/join-paths";import{kebabCase as r}from"@stryke/string-format/kebab-case";import i from"pluralize";const a=e=>i(e.charAt(0).toUpperCase()+e.slice(1)),o=e=>`all${a(e)}`,s=i=>({createJavaScriptFile:async t=>i.emitBuiltin(`${e(i)}
-${t.collections.map(({name:e})=>`import ${o(e)} from "./${r(e)}";`).join(`
-`)}
+import { getBaseFileHeader } from "../powerlines/src/lib/utilities/file-header.mjs";
+import { serialize } from "@content-collections/core";
+import { joinPaths } from "@stryke/path/join-paths";
+import { kebabCase } from "@stryke/string-format/kebab-case";
+import pluralize from "pluralize";
 
-export { ${t.collections.map(({name:e})=>o(e)).join(`, `)} };
-`,`content`),createTypeDefinitionFile:async e=>Promise.resolve(),createDataFiles:async e=>{await Promise.all(e.map(async e=>i.config.contentCollections.outputPath?i.fs.write(n(i.config.contentCollections.outputPath,r(e.name)),t(e.documents.map(e=>e.document))):i.emitBuiltin(t(e.documents.map(e=>e.document)),n(`content`,r(e.name)))))}});export{s as createWriter};
+//#region src/helpers/create-writer.ts
+const createConstName = (name) => {
+	return pluralize(name.charAt(0).toUpperCase() + name.slice(1));
+};
+const createArrayConstName = (name) => {
+	return `all${createConstName(name)}`;
+};
+/**
+*
+* @param context - The Powerlines build plugin
+* @returns
+*/
+const createWriter = (context) => {
+	return {
+		createJavaScriptFile: async (configuration) => {
+			return context.emitBuiltin(`${getBaseFileHeader(context)}
+${configuration.collections.map(({ name }) => `import ${createArrayConstName(name)} from "./${kebabCase(name)}";`).join("\n")}
+
+export { ${configuration.collections.map(({ name }) => createArrayConstName(name)).join(", ")} };
+`, "content");
+		},
+		createTypeDefinitionFile: async (_) => Promise.resolve(),
+		createDataFiles: async (collections) => {
+			await Promise.all(collections.map(async (collection) => {
+				if (context.config.contentCollections.outputPath) return context.fs.write(joinPaths(context.config.contentCollections.outputPath, kebabCase(collection.name)), serialize(collection.documents.map((doc) => doc.document)));
+				return context.emitBuiltin(serialize(collection.documents.map((doc) => doc.document)), joinPaths("content", kebabCase(collection.name)));
+			}));
+		}
+	};
+};
+
+//#endregion
+export { createWriter };

package/dist/helpers/index.cjs

@@ -1 +1,5 @@
-const e=require(`./create-emitter.cjs`),t=require(`./create-writer.cjs`);exports.createEmitter=e.createEmitter,exports.createWriter=t.createWriter;
+const require_helpers_create_emitter = require('./create-emitter.cjs');
+const require_helpers_create_writer = require('./create-writer.cjs');
+
+exports.createEmitter = require_helpers_create_emitter.createEmitter;
+exports.createWriter = require_helpers_create_writer.createWriter;

package/dist/helpers/index.mjs

@@ -1 +1,4 @@
-import{createEmitter as e}from"./create-emitter.mjs";import{createWriter as t}from"./create-writer.mjs";export{e as createEmitter,t as createWriter};
+import { createEmitter } from "./create-emitter.mjs";
+import { createWriter } from "./create-writer.mjs";
+
+export { createEmitter, createWriter };

package/dist/index.cjs

@@ -1 +1,68 @@
-Object.defineProperty(exports,`__esModule`,{value:!0});const e=require(`./_virtual/rolldown_runtime.cjs`),t=require(`./powerlines/src/plugin-utils/paths.cjs`),n=require(`./helpers/create-emitter.cjs`),r=require(`./helpers/create-writer.cjs`);require(`./helpers/index.cjs`);let i=require(`@content-collections/core`),a=require(`@stryke/fs/exists`),o=require(`@stryke/path/join`),s=require(`defu`);s=e.__toESM(s);let c=require(`node:crypto`);const l=e=>({name:`content-collections`,config(){return{contentCollections:(0,s.default)(e,{configFile:`{projectRoot}/content-collections.ts`,collections:[]})}},async configResolved(){this.config.contentCollections.configFile||=t.replacePathTokens(this,this.config.contentCollections.configFile),this.config.contentCollections.outputPath||=t.replacePathTokens(this,this.config.contentCollections.outputPath);let e=n.createEmitter(),l=(0,i.createConfigurationReader)(),u={};try{(0,a.existsSync)(this.config.contentCollections.configFile)&&(u=await l(this.config.contentCollections.configFile,{configName:`config.mjs`,cacheDir:(0,o.joinPaths)(this.cachePath,`content-collections`)}))}catch{}u=(0,s.default)(u??{},this.config.contentCollections),u.checksum=(0,c.createHash)(`sha256`).update(JSON.stringify(u)).digest(`hex`);let d=await(0,i.createBuildContext)({emitter:e,baseDirectory:(0,o.joinPaths)(this.workspaceConfig.workspaceRoot,this.config.projectRoot),outputDirectory:this.config.contentCollections.outputPath||(0,o.joinPaths)(this.builtinsPath,`content`),configuration:u});d.writer=r.createWriter(this),this.contentCollections={context:d,build:async()=>(0,i.build)(d),on:e.on}},async prepare(){return this.contentCollections.build()}});var u=l;exports.createEmitter=n.createEmitter,exports.createWriter=r.createWriter,exports.default=u,exports.plugin=l;
+Object.defineProperty(exports, '__esModule', { value: true });
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const require_paths = require('./powerlines/src/plugin-utils/paths.cjs');
+const require_helpers_create_emitter = require('./helpers/create-emitter.cjs');
+const require_helpers_create_writer = require('./helpers/create-writer.cjs');
+require('./helpers/index.cjs');
+let __content_collections_core = require("@content-collections/core");
+let __stryke_fs_exists = require("@stryke/fs/exists");
+let __stryke_path_join = require("@stryke/path/join");
+let defu = require("defu");
+defu = require_rolldown_runtime.__toESM(defu);
+let node_crypto = require("node:crypto");
+
+//#region src/index.ts
+/**
+* A Powerlines plugin to integrate Content Collections for code generation.
+*
+* @param options - The plugin options.
+* @returns A Powerlines plugin instance.
+*/
+const plugin = (options) => {
+	return {
+		name: "content-collections",
+		config() {
+			return { contentCollections: (0, defu.default)(options, {
+				configFile: "{projectRoot}/content-collections.ts",
+				collections: []
+			}) };
+		},
+		async configResolved() {
+			this.config.contentCollections.configFile ||= require_paths.replacePathTokens(this, this.config.contentCollections.configFile);
+			this.config.contentCollections.outputPath ||= require_paths.replacePathTokens(this, this.config.contentCollections.outputPath);
+			const emitter = require_helpers_create_emitter.createEmitter();
+			const readConfiguration = (0, __content_collections_core.createConfigurationReader)();
+			let configuration = {};
+			try {
+				if ((0, __stryke_fs_exists.existsSync)(this.config.contentCollections.configFile)) configuration = await readConfiguration(this.config.contentCollections.configFile, {
+					configName: "config.mjs",
+					cacheDir: (0, __stryke_path_join.joinPaths)(this.cachePath, "content-collections")
+				});
+			} catch {}
+			configuration = (0, defu.default)(configuration ?? {}, this.config.contentCollections);
+			configuration.checksum = (0, node_crypto.createHash)("sha256").update(JSON.stringify(configuration)).digest("hex");
+			const context = await (0, __content_collections_core.createBuildContext)({
+				emitter,
+				baseDirectory: (0, __stryke_path_join.joinPaths)(this.workspaceConfig.workspaceRoot, this.config.projectRoot),
+				outputDirectory: this.config.contentCollections.outputPath || (0, __stryke_path_join.joinPaths)(this.builtinsPath, "content"),
+				configuration
+			});
+			context.writer = require_helpers_create_writer.createWriter(this);
+			this.contentCollections = {
+				context,
+				build: async () => (0, __content_collections_core.build)(context),
+				on: emitter.on
+			};
+		},
+		async prepare() {
+			return this.contentCollections.build();
+		}
+	};
+};
+var src_default = plugin;
+
+//#endregion
+exports.createEmitter = require_helpers_create_emitter.createEmitter;
+exports.createWriter = require_helpers_create_writer.createWriter;
+exports.default = src_default;
+exports.plugin = plugin;

package/dist/index.mjs

@@ -1 +1,62 @@
-import{replacePathTokens as e}from"./powerlines/src/plugin-utils/paths.mjs";import{createEmitter as t}from"./helpers/create-emitter.mjs";import{createWriter as n}from"./helpers/create-writer.mjs";import"./helpers/index.mjs";import{build as r,createBuildContext as i,createConfigurationReader as a}from"@content-collections/core";import{existsSync as o}from"@stryke/fs/exists";import{joinPaths as s}from"@stryke/path/join";import c from"defu";import{createHash as l}from"node:crypto";const u=u=>({name:`content-collections`,config(){return{contentCollections:c(u,{configFile:`{projectRoot}/content-collections.ts`,collections:[]})}},async configResolved(){this.config.contentCollections.configFile||=e(this,this.config.contentCollections.configFile),this.config.contentCollections.outputPath||=e(this,this.config.contentCollections.outputPath);let u=t(),d=a(),f={};try{o(this.config.contentCollections.configFile)&&(f=await d(this.config.contentCollections.configFile,{configName:`config.mjs`,cacheDir:s(this.cachePath,`content-collections`)}))}catch{}f=c(f??{},this.config.contentCollections),f.checksum=l(`sha256`).update(JSON.stringify(f)).digest(`hex`);let p=await i({emitter:u,baseDirectory:s(this.workspaceConfig.workspaceRoot,this.config.projectRoot),outputDirectory:this.config.contentCollections.outputPath||s(this.builtinsPath,`content`),configuration:f});p.writer=n(this),this.contentCollections={context:p,build:async()=>r(p),on:u.on}},async prepare(){return this.contentCollections.build()}});var d=u;export{t as createEmitter,n as createWriter,d as default,u as plugin};
+import { replacePathTokens } from "./powerlines/src/plugin-utils/paths.mjs";
+import { createEmitter } from "./helpers/create-emitter.mjs";
+import { createWriter } from "./helpers/create-writer.mjs";
+import "./helpers/index.mjs";
+import { build, createBuildContext, createConfigurationReader } from "@content-collections/core";
+import { existsSync } from "@stryke/fs/exists";
+import { joinPaths } from "@stryke/path/join";
+import defu from "defu";
+import { createHash } from "node:crypto";
+
+//#region src/index.ts
+/**
+* A Powerlines plugin to integrate Content Collections for code generation.
+*
+* @param options - The plugin options.
+* @returns A Powerlines plugin instance.
+*/
+const plugin = (options) => {
+	return {
+		name: "content-collections",
+		config() {
+			return { contentCollections: defu(options, {
+				configFile: "{projectRoot}/content-collections.ts",
+				collections: []
+			}) };
+		},
+		async configResolved() {
+			this.config.contentCollections.configFile ||= replacePathTokens(this, this.config.contentCollections.configFile);
+			this.config.contentCollections.outputPath ||= replacePathTokens(this, this.config.contentCollections.outputPath);
+			const emitter = createEmitter();
+			const readConfiguration = createConfigurationReader();
+			let configuration = {};
+			try {
+				if (existsSync(this.config.contentCollections.configFile)) configuration = await readConfiguration(this.config.contentCollections.configFile, {
+					configName: "config.mjs",
+					cacheDir: joinPaths(this.cachePath, "content-collections")
+				});
+			} catch {}
+			configuration = defu(configuration ?? {}, this.config.contentCollections);
+			configuration.checksum = createHash("sha256").update(JSON.stringify(configuration)).digest("hex");
+			const context = await createBuildContext({
+				emitter,
+				baseDirectory: joinPaths(this.workspaceConfig.workspaceRoot, this.config.projectRoot),
+				outputDirectory: this.config.contentCollections.outputPath || joinPaths(this.builtinsPath, "content"),
+				configuration
+			});
+			context.writer = createWriter(this);
+			this.contentCollections = {
+				context,
+				build: async () => build(context),
+				on: emitter.on
+			};
+		},
+		async prepare() {
+			return this.contentCollections.build();
+		}
+	};
+};
+var src_default = plugin;
+
+//#endregion
+export { createEmitter, createWriter, src_default as default, plugin };

package/dist/powerlines/src/lib/utilities/file-header.cjs

@@ -1,4 +1,13 @@
-const e=require(`../../../../_virtual/rolldown_runtime.cjs`);let t=require(`@stryke/string-format/title-case`);function n(e){return`
-// Generated with ${(0,t.titleCase)(e.config.framework)}
+const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.cjs');
+let __stryke_string_format_title_case = require("@stryke/string-format/title-case");
+
+//#region ../powerlines/src/lib/utilities/file-header.ts
+function getBaseFileHeader(context) {
+	return `
+// Generated with ${(0, __stryke_string_format_title_case.titleCase)(context.config.framework)}
 // Note: Do not edit this file manually - it will be overwritten automatically
-`}exports.getBaseFileHeader=n;
+`;
+}
+
+//#endregion
+exports.getBaseFileHeader = getBaseFileHeader;

package/dist/powerlines/src/lib/utilities/file-header.mjs

@@ -1,4 +1,12 @@
-import{titleCase as e}from"@stryke/string-format/title-case";function t(t){return`
-// Generated with ${e(t.config.framework)}
+import { titleCase } from "@stryke/string-format/title-case";
+
+//#region ../powerlines/src/lib/utilities/file-header.ts
+function getBaseFileHeader(context) {
+	return `
+// Generated with ${titleCase(context.config.framework)}
 // Note: Do not edit this file manually - it will be overwritten automatically
-`}export{t as getBaseFileHeader};
+`;
+}
+
+//#endregion
+export { getBaseFileHeader };

package/dist/powerlines/src/plugin-utils/paths.cjs

@@ -1 +1,36 @@
-const e=require(`../../../_virtual/rolldown_runtime.cjs`);let t=require(`@stryke/path/replace`);function n(e,n){return n&&n.replaceAll(`{workspaceRoot}`,e.workspaceConfig.workspaceRoot).replaceAll(`{root}`,e.config.projectRoot).replaceAll(`{projectRoot}`,e.config.projectRoot).replaceAll(`{sourceRoot}`,e.config.sourceRoot).replaceAll(`{powerlinesPath}`,e.powerlinesPath).replaceAll(`{cachePath}`,e.cachePath).replaceAll(`{dataPath}`,e.dataPath).replaceAll(`{logPath}`,e.envPaths.log).replaceAll(`{tempPath}`,e.envPaths.temp).replaceAll(`{configPath}`,e.envPaths.config).replaceAll(`{outputPath}`,e.config.output.outputPath).replaceAll(`{buildPath}`,e.config.output.buildPath).replaceAll(`{artifactsPath}`,(0,t.replacePath)(e.artifactsPath,e.workspaceConfig.workspaceRoot)).replaceAll(`{builtinPath}`,(0,t.replacePath)(e.builtinsPath,e.workspaceConfig.workspaceRoot)).replaceAll(`{entryPath}`,(0,t.replacePath)(e.entryPath,e.workspaceConfig.workspaceRoot))}exports.replacePathTokens=n;
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+let __stryke_path_replace = require("@stryke/path/replace");
+
+//#region ../powerlines/src/plugin-utils/paths.ts
+/**
+* Replaces tokens in the given path string with their corresponding values from the context.
+*
+* @remarks
+* The following tokens are supported:
+* - `{workspaceRoot}` - The root directory of the workspace.
+* - `{root}` - The root directory of the project (same as `{projectRoot}`).
+* - `{projectRoot}` - The root directory of the project (same as `{root}`).
+* - `{sourceRoot}` - The source root directory of the project (usually `./src`).
+* - `{powerlinesPath}` - The directory where Powerlines is installed.
+* - `{cachePath}` - The environment's directory for cached files.
+* - `{dataPath}` - The environment's directory for data files.
+* - `{logPath}` - The environment's directory for log files.
+* - `{tempPath}` - The environment's directory for temporary files.
+* - `{configPath}` - The environment's directory for configuration files.
+* - `{outputPath}` - The configured output directory for the project.
+* - `{buildPath}` - The configured distribution directory for the project.
+* - `{artifactsPath}` - The configured directory for build artifacts.
+* - `{builtinPath}` - The configured directory for generated built-in plugins.
+* - `{entryPath}` - The configured directory for generated entry files.
+*
+* @param context - The context containing the values for the path tokens.
+* @param path - The path string with tokens to replace.
+* @returns The path string with tokens replaced by their corresponding values from the context.
+*/
+function replacePathTokens(context, path) {
+	if (!path) return path;
+	return path.replaceAll("{workspaceRoot}", context.workspaceConfig.workspaceRoot).replaceAll("{root}", context.config.projectRoot).replaceAll("{projectRoot}", context.config.projectRoot).replaceAll("{sourceRoot}", context.config.sourceRoot).replaceAll("{powerlinesPath}", context.powerlinesPath).replaceAll("{cachePath}", context.cachePath).replaceAll("{dataPath}", context.dataPath).replaceAll("{logPath}", context.envPaths.log).replaceAll("{tempPath}", context.envPaths.temp).replaceAll("{configPath}", context.envPaths.config).replaceAll("{outputPath}", context.config.output.outputPath).replaceAll("{buildPath}", context.config.output.buildPath).replaceAll("{artifactsPath}", (0, __stryke_path_replace.replacePath)(context.artifactsPath, context.workspaceConfig.workspaceRoot)).replaceAll("{builtinPath}", (0, __stryke_path_replace.replacePath)(context.builtinsPath, context.workspaceConfig.workspaceRoot)).replaceAll("{entryPath}", (0, __stryke_path_replace.replacePath)(context.entryPath, context.workspaceConfig.workspaceRoot));
+}
+
+//#endregion
+exports.replacePathTokens = replacePathTokens;

package/dist/powerlines/src/plugin-utils/paths.mjs

@@ -1 +1,35 @@
-import{replacePath as e}from"@stryke/path/replace";function t(t,n){return n&&n.replaceAll(`{workspaceRoot}`,t.workspaceConfig.workspaceRoot).replaceAll(`{root}`,t.config.projectRoot).replaceAll(`{projectRoot}`,t.config.projectRoot).replaceAll(`{sourceRoot}`,t.config.sourceRoot).replaceAll(`{powerlinesPath}`,t.powerlinesPath).replaceAll(`{cachePath}`,t.cachePath).replaceAll(`{dataPath}`,t.dataPath).replaceAll(`{logPath}`,t.envPaths.log).replaceAll(`{tempPath}`,t.envPaths.temp).replaceAll(`{configPath}`,t.envPaths.config).replaceAll(`{outputPath}`,t.config.output.outputPath).replaceAll(`{buildPath}`,t.config.output.buildPath).replaceAll(`{artifactsPath}`,e(t.artifactsPath,t.workspaceConfig.workspaceRoot)).replaceAll(`{builtinPath}`,e(t.builtinsPath,t.workspaceConfig.workspaceRoot)).replaceAll(`{entryPath}`,e(t.entryPath,t.workspaceConfig.workspaceRoot))}export{t as replacePathTokens};
+import { replacePath } from "@stryke/path/replace";
+
+//#region ../powerlines/src/plugin-utils/paths.ts
+/**
+* Replaces tokens in the given path string with their corresponding values from the context.
+*
+* @remarks
+* The following tokens are supported:
+* - `{workspaceRoot}` - The root directory of the workspace.
+* - `{root}` - The root directory of the project (same as `{projectRoot}`).
+* - `{projectRoot}` - The root directory of the project (same as `{root}`).
+* - `{sourceRoot}` - The source root directory of the project (usually `./src`).
+* - `{powerlinesPath}` - The directory where Powerlines is installed.
+* - `{cachePath}` - The environment's directory for cached files.
+* - `{dataPath}` - The environment's directory for data files.
+* - `{logPath}` - The environment's directory for log files.
+* - `{tempPath}` - The environment's directory for temporary files.
+* - `{configPath}` - The environment's directory for configuration files.
+* - `{outputPath}` - The configured output directory for the project.
+* - `{buildPath}` - The configured distribution directory for the project.
+* - `{artifactsPath}` - The configured directory for build artifacts.
+* - `{builtinPath}` - The configured directory for generated built-in plugins.
+* - `{entryPath}` - The configured directory for generated entry files.
+*
+* @param context - The context containing the values for the path tokens.
+* @param path - The path string with tokens to replace.
+* @returns The path string with tokens replaced by their corresponding values from the context.
+*/
+function replacePathTokens(context, path) {
+	if (!path) return path;
+	return path.replaceAll("{workspaceRoot}", context.workspaceConfig.workspaceRoot).replaceAll("{root}", context.config.projectRoot).replaceAll("{projectRoot}", context.config.projectRoot).replaceAll("{sourceRoot}", context.config.sourceRoot).replaceAll("{powerlinesPath}", context.powerlinesPath).replaceAll("{cachePath}", context.cachePath).replaceAll("{dataPath}", context.dataPath).replaceAll("{logPath}", context.envPaths.log).replaceAll("{tempPath}", context.envPaths.temp).replaceAll("{configPath}", context.envPaths.config).replaceAll("{outputPath}", context.config.output.outputPath).replaceAll("{buildPath}", context.config.output.buildPath).replaceAll("{artifactsPath}", replacePath(context.artifactsPath, context.workspaceConfig.workspaceRoot)).replaceAll("{builtinPath}", replacePath(context.builtinsPath, context.workspaceConfig.workspaceRoot)).replaceAll("{entryPath}", replacePath(context.entryPath, context.workspaceConfig.workspaceRoot));
+}
+
+//#endregion
+export { replacePathTokens };

package/dist/powerlines/src/types/context.d.cts

@@ -78,10 +78,18 @@ interface ParseOptions extends ParserOptions {
    */
   allowReturnOutsideFunction?: boolean;
 }
+interface EmitOptions extends WriteOptions {
+  /**
+   * If true, will emit the file using {@link UnpluginBuildContext.emitFile | the bundler's emit function}.
+   */
+  emitWithBundler?: boolean;
+  needsCodeReference?: Parameters<UnpluginBuildContext["emitFile"]>[0]["needsCodeReference"];
+  originalFileName?: Parameters<UnpluginBuildContext["emitFile"]>[0]["originalFileName"];
+}
 /**
  * Options for emitting entry virtual files
  */
-type EmitEntryOptions = WriteOptions & Omit<ResolvedEntryTypeDefinition, "file">;
+type EmitEntryOptions = EmitOptions & Omit<ResolvedEntryTypeDefinition, "file">;
 /**
  * The unresolved Powerlines context.
  *
@@ -292,6 +300,22 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * The Powerlines builtin virtual files
    */
   getBuiltins: () => Promise<VirtualFile[]>;
+  /**
+   * Resolves a file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the file
+   * @param path - The path to write the file to
+   * @param options - Additional options for writing the file
+   */
+  emit: (code: string, path: string, options?: EmitOptions) => Promise<void>;
+  /**
+   * Synchronously resolves a file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the file
+   * @param path - The path to write the file to
+   * @param options - Additional options for writing the file
+   */
+  emitSync: (code: string, path: string, options?: EmitOptions) => void;
   /**
    * Resolves a builtin virtual file and writes it to the VFS if it does not already exist
    *
@@ -300,7 +324,16 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * @param path - An optional path to write the builtin file to
    * @param options - Additional options for writing the builtin file
    */
-  emitBuiltin: (code: string, id: string, path?: string, options?: WriteOptions) => Promise<void>;
+  emitBuiltin: (code: string, id: string, path?: string, options?: EmitOptions) => Promise<void>;
+  /**
+   * Synchronously resolves a builtin virtual file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the builtin file
+   * @param id - The unique identifier of the builtin file
+   * @param path - An optional path to write the builtin file to
+   * @param options - Additional options for writing the builtin file
+   */
+  emitBuiltinSync: (code: string, id: string, path?: string, options?: EmitOptions) => void;
   /**
    * Resolves a entry virtual file and writes it to the VFS if it does not already exist
    *
@@ -309,6 +342,14 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * @param options - Additional options for writing the entry file
    */
   emitEntry: (code: string, path: string, options?: EmitEntryOptions) => Promise<void>;
+  /**
+   * Synchronously resolves a entry virtual file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the entry file
+   * @param path - An optional path to write the entry file to
+   * @param options - Additional options for writing the entry file
+   */
+  emitEntrySync: (code: string, path: string, options?: EmitEntryOptions) => void;
   /**
    * A function to update the context fields using a new user configuration options
    */

package/dist/powerlines/src/types/context.d.mts

@@ -78,10 +78,18 @@ interface ParseOptions extends ParserOptions {
    */
   allowReturnOutsideFunction?: boolean;
 }
+interface EmitOptions extends WriteOptions {
+  /**
+   * If true, will emit the file using {@link UnpluginBuildContext.emitFile | the bundler's emit function}.
+   */
+  emitWithBundler?: boolean;
+  needsCodeReference?: Parameters<UnpluginBuildContext["emitFile"]>[0]["needsCodeReference"];
+  originalFileName?: Parameters<UnpluginBuildContext["emitFile"]>[0]["originalFileName"];
+}
 /**
  * Options for emitting entry virtual files
  */
-type EmitEntryOptions = WriteOptions & Omit<ResolvedEntryTypeDefinition, "file">;
+type EmitEntryOptions = EmitOptions & Omit<ResolvedEntryTypeDefinition, "file">;
 /**
  * The unresolved Powerlines context.
  *
@@ -292,6 +300,22 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * The Powerlines builtin virtual files
    */
   getBuiltins: () => Promise<VirtualFile[]>;
+  /**
+   * Resolves a file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the file
+   * @param path - The path to write the file to
+   * @param options - Additional options for writing the file
+   */
+  emit: (code: string, path: string, options?: EmitOptions) => Promise<void>;
+  /**
+   * Synchronously resolves a file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the file
+   * @param path - The path to write the file to
+   * @param options - Additional options for writing the file
+   */
+  emitSync: (code: string, path: string, options?: EmitOptions) => void;
   /**
    * Resolves a builtin virtual file and writes it to the VFS if it does not already exist
    *
@@ -300,7 +324,16 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * @param path - An optional path to write the builtin file to
    * @param options - Additional options for writing the builtin file
    */
-  emitBuiltin: (code: string, id: string, path?: string, options?: WriteOptions) => Promise<void>;
+  emitBuiltin: (code: string, id: string, path?: string, options?: EmitOptions) => Promise<void>;
+  /**
+   * Synchronously resolves a builtin virtual file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the builtin file
+   * @param id - The unique identifier of the builtin file
+   * @param path - An optional path to write the builtin file to
+   * @param options - Additional options for writing the builtin file
+   */
+  emitBuiltinSync: (code: string, id: string, path?: string, options?: EmitOptions) => void;
   /**
    * Resolves a entry virtual file and writes it to the VFS if it does not already exist
    *
@@ -309,6 +342,14 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * @param options - Additional options for writing the entry file
    */
   emitEntry: (code: string, path: string, options?: EmitEntryOptions) => Promise<void>;
+  /**
+   * Synchronously resolves a entry virtual file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the entry file
+   * @param path - An optional path to write the entry file to
+   * @param options - Additional options for writing the entry file
+   */
+  emitEntrySync: (code: string, path: string, options?: EmitEntryOptions) => void;
   /**
    * A function to update the context fields using a new user configuration options
    */

package/dist/powerlines/src/types/fs.d.cts

@@ -13,6 +13,13 @@ interface StorageAdapter {
    * A name identifying the storage adapter type.
    */
   name: string;
+  /**
+   * The storage preset for the adapter.
+   *
+   * @remarks
+   * This can be used as an alternate way to identify the type of storage being used.
+   */
+  preset?: StoragePreset | null;
   /**
    * Checks if a key exists in the storage.
    *
@@ -207,6 +214,13 @@ interface WriteOptions {
    * @defaultValue false
    */
   skipFormat?: boolean;
+  /**
+   * The storage preset or adapter name for the output file.
+   *
+   * @remarks
+   * If not specified, the output mode will be determined by the provided `output.mode` value.
+   */
+  storage?: StoragePreset | string;
   /**
    * Additional metadata for the file.
    */

package/dist/powerlines/src/types/fs.d.mts

@@ -13,6 +13,13 @@ interface StorageAdapter {
    * A name identifying the storage adapter type.
    */
   name: string;
+  /**
+   * The storage preset for the adapter.
+   *
+   * @remarks
+   * This can be used as an alternate way to identify the type of storage being used.
+   */
+  preset?: StoragePreset | null;
   /**
    * Checks if a key exists in the storage.
    *
@@ -207,6 +214,13 @@ interface WriteOptions {
    * @defaultValue false
    */
   skipFormat?: boolean;
+  /**
+   * The storage preset or adapter name for the output file.
+   *
+   * @remarks
+   * If not specified, the output mode will be determined by the provided `output.mode` value.
+   */
+  storage?: StoragePreset | string;
   /**
    * Additional metadata for the file.
    */

package/dist/types/index.mjs

@@ -1 +1 @@
-export{};
+export {  };

package/dist/types/plugin.mjs

@@ -1 +1 @@
-export{};
+export {  };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerlines/plugin-content-collections",
-  "version": "0.1.116",
+  "version": "0.1.118",
   "type": "module",
   "description": "A Powerlines plugin to generate project code using Content Collections.",
   "repository": {
@@ -123,22 +123,22 @@
   ],
   "dependencies": {
     "@content-collections/core": "^0.12.0",
-    "@stryke/fs": "^0.33.26",
-    "@stryke/string-format": "^0.12.29",
-    "@stryke/path": "^0.24.0",
-    "@stryke/type-checks": "^0.5.14",
-    "@stryke/types": "^0.10.28",
+    "@stryke/fs": "^0.33.27",
+    "@stryke/string-format": "^0.12.30",
+    "@stryke/path": "^0.24.1",
+    "@stryke/type-checks": "^0.5.15",
+    "@stryke/types": "^0.10.29",
     "defu": "^6.1.4",
     "pluralize": "^8.0.0",
-    "powerlines": "^0.36.21"
+    "powerlines": "^0.36.23"
   },
   "devDependencies": {
-    "@powerlines/nx": "^0.11.47",
-    "@powerlines/plugin-plugin": "^0.12.68",
+    "@powerlines/nx": "^0.11.49",
+    "@powerlines/plugin-plugin": "^0.12.70",
     "@standard-schema/spec": "^1.1.0",
     "@types/node": "^24.10.4",
     "@types/pluralize": "^0.0.33"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "b16324cf857ea5743fd7ad06e18607b1ba32abe0"
+  "gitHead": "be47e546b48b9a82e460b5c5d4f02fb66e821f18"
 }