@powerlines/plugin-satori 0.1.115 → 0.1.117

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/index.cjs

@@ -1 +1,61 @@
-Object.defineProperty(exports,`__esModule`,{value:!0});const e=require(`./_virtual/rolldown_runtime.cjs`),t=require(`./powerlines/src/plugin-utils/paths.cjs`);let n=require(`@storm-software/config-tools/types`),r=require(`@stryke/convert/to-array`),i=require(`@stryke/fs/exists`),a=require(`@stryke/fs/list-files`),o=require(`@stryke/path/file-path-fns`),s=require(`@stryke/path/join-paths`),c=require(`@stryke/path/replace`),l=require(`defu`);l=e.__toESM(l);let u=require(`satori`);u=e.__toESM(u);const d=e=>({name:`satori`,config(){return{satori:{defaultOptions:{},width:1200,height:630,fonts:[],...e}}},async configResolved(){if(!this.config.satori.path)throw Error("The Powerlines Satori plugin requires a `path` option to be specified.");this.config.satori.inputs=(await Promise.all((0,r.toArray)(this.config.satori.path).map(async e=>e.includes(`*`)?(0,a.listFiles)(t.replacePathTokens(this,e)):t.replacePathTokens(this,e)))).flat().filter(e=>e&&[`jsx`,`tsx`].includes((0,o.findFileExtensionSafe)(e))&&(0,i.existsSync)(e))},async prepare(){await Promise.all(this.config.satori.inputs.map(async e=>{try{let t=await this.resolver.import(e);if(t&&t.default){let n=await(0,u.default)(t.default,(0,l.default)(t.options??{},this.config.satori.defaultOptions));n&&await this.fs.write(this.config.satori.outputPath?(0,s.joinPaths)(this.config.satori.outputPath,(0,c.replacePath)(e,(0,s.joinPaths)(this.workspaceConfig.workspaceRoot,this.config.projectRoot))):e.replace((0,o.findFileExtensionSafe)(e),`svg`),n)}}catch(t){this.log(n.LogLevelLabel.DEBUG,`Failed to load Satori schema from ${e}: ${t.message}`)}}))}});var f=d;exports.default=f,exports.plugin=d;
+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');
+let __storm_software_config_tools_types = require("@storm-software/config-tools/types");
+let __stryke_convert_to_array = require("@stryke/convert/to-array");
+let __stryke_fs_exists = require("@stryke/fs/exists");
+let __stryke_fs_list_files = require("@stryke/fs/list-files");
+let __stryke_path_file_path_fns = require("@stryke/path/file-path-fns");
+let __stryke_path_join_paths = require("@stryke/path/join-paths");
+let __stryke_path_replace = require("@stryke/path/replace");
+let defu = require("defu");
+defu = require_rolldown_runtime.__toESM(defu);
+let satori = require("satori");
+satori = require_rolldown_runtime.__toESM(satori);
+
+//#region src/index.ts
+/**
+* A Powerlines plugin to use Untyped for code generation based on user-defined schemas.
+*
+* @param options - The plugin options.
+* @returns A Powerlines plugin instance.
+*/
+const plugin = (options) => {
+	return {
+		name: "satori",
+		config() {
+			return { satori: {
+				defaultOptions: {},
+				width: 1200,
+				height: 630,
+				fonts: [],
+				...options
+			} };
+		},
+		async configResolved() {
+			if (!this.config.satori.path) throw new Error("The Powerlines Satori plugin requires a `path` option to be specified.");
+			this.config.satori.inputs = (await Promise.all((0, __stryke_convert_to_array.toArray)(this.config.satori.path).map(async (path) => {
+				if (path.includes("*")) return (0, __stryke_fs_list_files.listFiles)(require_paths.replacePathTokens(this, path));
+				return require_paths.replacePathTokens(this, path);
+			}))).flat().filter((path) => path && ["jsx", "tsx"].includes((0, __stryke_path_file_path_fns.findFileExtensionSafe)(path)) && (0, __stryke_fs_exists.existsSync)(path));
+		},
+		async prepare() {
+			await Promise.all(this.config.satori.inputs.map(async (input) => {
+				try {
+					const mod = await this.resolver.import(input);
+					if (mod && mod.default) {
+						const result = await (0, satori.default)(mod.default, (0, defu.default)(mod.options ?? {}, this.config.satori.defaultOptions));
+						if (result) await this.fs.write(this.config.satori.outputPath ? (0, __stryke_path_join_paths.joinPaths)(this.config.satori.outputPath, (0, __stryke_path_replace.replacePath)(input, (0, __stryke_path_join_paths.joinPaths)(this.workspaceConfig.workspaceRoot, this.config.projectRoot))) : input.replace((0, __stryke_path_file_path_fns.findFileExtensionSafe)(input), "svg"), result);
+					}
+				} catch (error) {
+					this.log(__storm_software_config_tools_types.LogLevelLabel.DEBUG, `Failed to load Satori schema from ${input}: ${error.message}`);
+				}
+			}));
+		}
+	};
+};
+var src_default = plugin;
+
+//#endregion
+exports.default = src_default;
+exports.plugin = plugin;

package/dist/index.mjs

@@ -1 +1,56 @@
-import{replacePathTokens as e}from"./powerlines/src/plugin-utils/paths.mjs";import{LogLevelLabel as t}from"@storm-software/config-tools/types";import{toArray as n}from"@stryke/convert/to-array";import{existsSync as r}from"@stryke/fs/exists";import{listFiles as i}from"@stryke/fs/list-files";import{findFileExtensionSafe as a}from"@stryke/path/file-path-fns";import{joinPaths as o}from"@stryke/path/join-paths";import{replacePath as s}from"@stryke/path/replace";import c from"defu";import l from"satori";const u=u=>({name:`satori`,config(){return{satori:{defaultOptions:{},width:1200,height:630,fonts:[],...u}}},async configResolved(){if(!this.config.satori.path)throw Error("The Powerlines Satori plugin requires a `path` option to be specified.");this.config.satori.inputs=(await Promise.all(n(this.config.satori.path).map(async t=>t.includes(`*`)?i(e(this,t)):e(this,t)))).flat().filter(e=>e&&[`jsx`,`tsx`].includes(a(e))&&r(e))},async prepare(){await Promise.all(this.config.satori.inputs.map(async e=>{try{let t=await this.resolver.import(e);if(t&&t.default){let n=await l(t.default,c(t.options??{},this.config.satori.defaultOptions));n&&await this.fs.write(this.config.satori.outputPath?o(this.config.satori.outputPath,s(e,o(this.workspaceConfig.workspaceRoot,this.config.projectRoot))):e.replace(a(e),`svg`),n)}}catch(n){this.log(t.DEBUG,`Failed to load Satori schema from ${e}: ${n.message}`)}}))}});var d=u;export{d as default,u as plugin};
+import { replacePathTokens } from "./powerlines/src/plugin-utils/paths.mjs";
+import { LogLevelLabel } from "@storm-software/config-tools/types";
+import { toArray } from "@stryke/convert/to-array";
+import { existsSync } from "@stryke/fs/exists";
+import { listFiles } from "@stryke/fs/list-files";
+import { findFileExtensionSafe } from "@stryke/path/file-path-fns";
+import { joinPaths } from "@stryke/path/join-paths";
+import { replacePath } from "@stryke/path/replace";
+import defu from "defu";
+import satori from "satori";
+
+//#region src/index.ts
+/**
+* A Powerlines plugin to use Untyped for code generation based on user-defined schemas.
+*
+* @param options - The plugin options.
+* @returns A Powerlines plugin instance.
+*/
+const plugin = (options) => {
+	return {
+		name: "satori",
+		config() {
+			return { satori: {
+				defaultOptions: {},
+				width: 1200,
+				height: 630,
+				fonts: [],
+				...options
+			} };
+		},
+		async configResolved() {
+			if (!this.config.satori.path) throw new Error("The Powerlines Satori plugin requires a `path` option to be specified.");
+			this.config.satori.inputs = (await Promise.all(toArray(this.config.satori.path).map(async (path) => {
+				if (path.includes("*")) return listFiles(replacePathTokens(this, path));
+				return replacePathTokens(this, path);
+			}))).flat().filter((path) => path && ["jsx", "tsx"].includes(findFileExtensionSafe(path)) && existsSync(path));
+		},
+		async prepare() {
+			await Promise.all(this.config.satori.inputs.map(async (input) => {
+				try {
+					const mod = await this.resolver.import(input);
+					if (mod && mod.default) {
+						const result = await satori(mod.default, defu(mod.options ?? {}, this.config.satori.defaultOptions));
+						if (result) await this.fs.write(this.config.satori.outputPath ? joinPaths(this.config.satori.outputPath, replacePath(input, joinPaths(this.workspaceConfig.workspaceRoot, this.config.projectRoot))) : input.replace(findFileExtensionSafe(input), "svg"), result);
+					}
+				} catch (error) {
+					this.log(LogLevelLabel.DEBUG, `Failed to load Satori schema from ${input}: ${error.message}`);
+				}
+			}));
+		}
+	};
+};
+var src_default = plugin;
+
+//#endregion
+export { src_default as default, plugin };

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

@@ -80,10 +80,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.
  *
@@ -294,6 +302,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
    *
@@ -302,7 +326,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
    *
@@ -311,6 +344,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/module.mjs

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

package/dist/types/plugin.mjs

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerlines/plugin-satori",
-  "version": "0.1.115",
+  "version": "0.1.117",
   "type": "module",
   "description": "A Powerlines plugin to use Satori to generate SVG files from jsx/tsx components.",
   "repository": {
@@ -122,26 +122,26 @@
     "react-dom": { "optional": true }
   },
   "dependencies": {
-    "@stryke/convert": "^0.6.29",
-    "@stryke/fs": "^0.33.26",
-    "@stryke/helpers": "^0.9.31",
-    "@stryke/json": "^0.9.32",
-    "@stryke/path": "^0.24.0",
-    "@stryke/type-checks": "^0.5.14",
-    "@stryke/types": "^0.10.28",
+    "@stryke/convert": "^0.6.30",
+    "@stryke/fs": "^0.33.27",
+    "@stryke/helpers": "^0.9.32",
+    "@stryke/json": "^0.9.33",
+    "@stryke/path": "^0.24.1",
+    "@stryke/type-checks": "^0.5.15",
+    "@stryke/types": "^0.10.29",
     "defu": "^6.1.4",
     "jiti": "^2.6.1",
-    "powerlines": "^0.36.21",
+    "powerlines": "^0.36.23",
     "satori": "^0.18.3"
   },
   "devDependencies": {
-    "@powerlines/nx": "^0.11.47",
-    "@powerlines/plugin-plugin": "^0.12.68",
+    "@powerlines/nx": "^0.11.49",
+    "@powerlines/plugin-plugin": "^0.12.70",
     "@storm-software/config": "^1.134.74",
     "@types/node": "^24.10.4",
     "@types/react": "^19.2.7",
     "@types/react-dom": "^19.2.3"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "b16324cf857ea5743fd7ad06e18607b1ba32abe0"
+  "gitHead": "be47e546b48b9a82e460b5c5d4f02fb66e821f18"
 }