@ogs-gmbh/rolldown-plugin-assets 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 — present OGS Gesellschaft für Datenverarbeitung und Systemberatung mbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/handlers.d.ts

@@ -0,0 +1,14 @@
+
+/*!
+ * Copyright (c) 2026 — present OGS Gesellschaft für Datenverarbeitung und Systemberatung mbH
+ * Licensed under MIT (See https://github.com/OGS-GmbH/rolldown-plugin-assets/LICENSE)
+ */
+
+import { PluginContext } from "rolldown";
+
+//#region src/handlers.d.ts
+declare function handleFile(this: PluginContext, cwd: string, from: string, to: string): void;
+declare function handleDirectory(this: PluginContext, cwd: string, from: string, to: string): void;
+//#endregion
+export { handleDirectory, handleFile };
+//# sourceMappingURL=handlers.d.ts.map

package/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","names":[],"sources":["../../src/handlers.ts"],"mappings":";;;;;;;;;iBAIS,UAAA,CAAW,IAAA,EAAM,aAAA,EAAe,GAAA,UAAa,IAAA,UAAc,EAAA;AAAA,iBAe3D,eAAA,CAAgB,IAAA,EAAM,aAAA,EAAe,GAAA,UAAa,IAAA,UAAc,EAAA"}

package/handlers.js

@@ -0,0 +1,37 @@
+
+/*!
+ * Copyright (c) 2026 — present OGS Gesellschaft für Datenverarbeitung und Systemberatung mbH
+ * Licensed under MIT (See https://github.com/OGS-GmbH/rolldown-plugin-assets/LICENSE)
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+//#region src/handlers.ts
+function handleFile(cwd, from, to) {
+	const fromPath = path.join(cwd, from);
+	const source = fs.readFileSync(fromPath, { encoding: "utf8" });
+	this.emitFile({
+		type: "asset",
+		fileName: to,
+		originalFileName: from,
+		source
+	});
+}
+function handleDirectory(cwd, from, to) {
+	const fromPath = path.join(cwd, from);
+	const files = fs.readdirSync(fromPath, {
+		recursive: true,
+		encoding: "utf8"
+	});
+	for (const file of files) {
+		const fromPathWithFile = path.join(fromPath, file);
+		if (!fs.statSync(fromPathWithFile).isFile()) continue;
+		const fromWithFile = path.join(from, file);
+		const toWithFile = path.join(to, file);
+		handleFile.call(this, cwd, fromWithFile, toWithFile);
+	}
+}
+//#endregion
+export { handleDirectory, handleFile };
+
+//# sourceMappingURL=handlers.js.map

package/handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.js","names":[],"sources":["../../src/handlers.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { PluginContext } from \"rolldown\";\n\nfunction handleFile(this: PluginContext, cwd: string, from: string, to: string) {\n  const fromPath = path.join(cwd, from);\n\n  const source = fs.readFileSync(fromPath, {\n    encoding: \"utf8\"\n  });\n\n  this.emitFile({\n    type: \"asset\",\n    fileName: to,\n    originalFileName: from,\n    source\n  });\n}\n\nfunction handleDirectory(this: PluginContext, cwd: string, from: string, to: string) {\n  const fromPath = path.join(cwd, from);\n\n  const files = fs.readdirSync(fromPath, {\n    recursive: true,\n    encoding: \"utf8\"\n  });\n\n  for (const file of files) {\n    const fromPathWithFile = path.join(fromPath, file);\n    const stats = fs.statSync(fromPathWithFile);\n\n    if (!stats.isFile()) continue;\n\n    const fromWithFile = path.join(from, file);\n    const toWithFile = path.join(to, file);\n\n    handleFile.call(this, cwd, fromWithFile, toWithFile);\n  }\n}\n\nexport { handleFile, handleDirectory };\n"],"mappings":";;;;;;;;;AAIA,SAAS,WAAgC,KAAa,MAAc,IAAY;CAC9E,MAAM,WAAW,KAAK,KAAK,KAAK,KAAK;CAErC,MAAM,SAAS,GAAG,aAAa,UAAU,EACvC,UAAU,QACX,CAAC;AAEF,MAAK,SAAS;EACZ,MAAM;EACN,UAAU;EACV,kBAAkB;EAClB;EACD,CAAC;;AAGJ,SAAS,gBAAqC,KAAa,MAAc,IAAY;CACnF,MAAM,WAAW,KAAK,KAAK,KAAK,KAAK;CAErC,MAAM,QAAQ,GAAG,YAAY,UAAU;EACrC,WAAW;EACX,UAAU;EACX,CAAC;AAEF,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,mBAAmB,KAAK,KAAK,UAAU,KAAK;AAGlD,MAAI,CAFU,GAAG,SAAS,iBAAiB,CAEhC,QAAQ,CAAE;EAErB,MAAM,eAAe,KAAK,KAAK,MAAM,KAAK;EAC1C,MAAM,aAAa,KAAK,KAAK,IAAI,KAAK;AAEtC,aAAW,KAAK,MAAM,KAAK,cAAc,WAAW"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@ogs-gmbh/rolldown-plugin-assets",
+  "version": "1.0.0",
+  "description": "A Rolldown plugin that emits static assets (files and directories) to the output directory during the build process.",
+  "keywords": [
+    "assets",
+    "build",
+    "bundler",
+    "plugin",
+    "rolldown",
+    "rolldown-plugin",
+    "static-assets"
+  ],
+  "license": "MIT",
+  "author": "OGS GmbH",
+  "contributors": [
+    {
+      "name": "Simon Kovtyk",
+      "email": "simon@kovtyk.com",
+      "url": "https://simonkov.dev"
+    }
+  ],
+  "type": "module",
+  "dependencies": {
+    "rolldown": "1.0.0-rc.13"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^20.5.0",
+    "@commitlint/config-conventional": "^20.5.0",
+    "@commitlint/prompt-cli": "^20.5.0",
+    "@ogs-gmbh/oxlint-presets": "^1.0.5",
+    "@ogs-gmbh/rolldown-plugin-package-json": "^1.1.0",
+    "@ogs-gmbh/vitepress-plugin-sidebar": "^1.0.3",
+    "@ogs-gmbh/vitepress-theme": "^1.1.0",
+    "@types/node": "^25.5.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.4.0",
+    "oxfmt": "^0.42.0",
+    "oxlint": "^1.58.0",
+    "sass-embedded": "^1.98.0",
+    "tsdown": "^0.21.7",
+    "typedoc": "^0.28.18",
+    "typedoc-plugin-frontmatter": "^1.3.1",
+    "typedoc-plugin-markdown": "^4.11.0",
+    "typescript": "^5.9.3",
+    "vitepress": "^1.6.4",
+    "vitepress-plugin-group-icons": "^1.7.3"
+  },
+  "homepage": "https://ogs-gmbh.github.io/rolldown-plugin-assets",
+  "bugs": "https://github.com/OGS-GmbH/rolldown-plugin-assets/issues",
+  "repository": "https://github.com/OGS-GmbH/rolldown-plugin-assets",
+  "exports": {
+    "types": "./public-api.d.ts",
+    "default": "./public-api.js"
+  }
+}

package/plugin.d.ts

@@ -0,0 +1,24 @@
+
+/*!
+ * Copyright (c) 2026 — present OGS Gesellschaft für Datenverarbeitung und Systemberatung mbH
+ * Licensed under MIT (See https://github.com/OGS-GmbH/rolldown-plugin-assets/LICENSE)
+ */
+
+import { Options } from "./types.js";
+import { Plugin } from "rolldown";
+
+//#region src/plugin.d.ts
+/**
+ * A Rollup plugin that emits assets
+ *
+ * @param options - An `Object` to configure {@link Options} for the plugin's behavior.
+ * @returns A Rollup plugin that emits assets.
+ *
+ * @since 1.0.0
+ * @author Simon Kovtyk
+ * @category Plugin
+ */
+declare function assetsPlugin(options: Options): Plugin;
+//#endregion
+export { assetsPlugin };
+//# sourceMappingURL=plugin.d.ts.map

package/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","names":[],"sources":["../../src/plugin.ts"],"mappings":";;;;;;;;;;;;AAKqC;;;;;;;;iBAY5B,YAAA,CAAa,OAAA,EAAS,OAAA,GAAU,MAAA"}

package/plugin.js

@@ -0,0 +1,59 @@
+
+/*!
+ * Copyright (c) 2026 — present OGS Gesellschaft für Datenverarbeitung und Systemberatung mbH
+ * Licensed under MIT (See https://github.com/OGS-GmbH/rolldown-plugin-assets/LICENSE)
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+import process from "node:process";
+import { handleDirectory, handleFile } from "./handlers.js";
+//#region src/plugin.ts
+/**
+* A Rollup plugin that emits assets
+*
+* @param options - An `Object` to configure {@link Options} for the plugin's behavior.
+* @returns A Rollup plugin that emits assets.
+*
+* @since 1.0.0
+* @author Simon Kovtyk
+* @category Plugin
+*/
+function assetsPlugin(options) {
+	const cwd = process.cwd();
+	return {
+		name: "assets-plugin",
+		generateBundle: function() {
+			for (const asset of options) {
+				let from;
+				let to;
+				if (typeof asset === "string") {
+					from = asset;
+					to = asset;
+				} else {
+					from = asset[0];
+					to = asset[1];
+				}
+				const fromPath = path.join(cwd, from);
+				let stats;
+				try {
+					stats = fs.statSync(fromPath);
+				} catch {
+					continue;
+				}
+				if (stats.isDirectory()) {
+					handleDirectory.call(this, cwd, from, to);
+					continue;
+				}
+				if (stats.isFile()) {
+					handleFile.call(this, cwd, from, to);
+					continue;
+				}
+			}
+		}
+	};
+}
+//#endregion
+export { assetsPlugin };
+
+//# sourceMappingURL=plugin.js.map

package/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","names":[],"sources":["../../src/plugin.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport process from \"node:process\";\nimport { Plugin, PluginContext } from \"rolldown\";\nimport { handleDirectory, handleFile } from \"./handlers.js\";\nimport { Options } from \"./types.js\";\n\n/**\n * A Rollup plugin that emits assets\n *\n * @param options - An `Object` to configure {@link Options} for the plugin's behavior.\n * @returns A Rollup plugin that emits assets.\n *\n * @since 1.0.0\n * @author Simon Kovtyk\n * @category Plugin\n */\nfunction assetsPlugin(options: Options): Plugin {\n  const cwd = process.cwd();\n\n  return {\n    name: \"assets-plugin\",\n    generateBundle: function (this: PluginContext) {\n      for (const asset of options) {\n        let from;\n        let to;\n\n        if (typeof asset === \"string\") {\n          from = asset;\n          to = asset;\n        } else {\n          from = asset[0];\n          to = asset[1];\n        }\n\n        const fromPath = path.join(cwd, from);\n        let stats;\n\n        try {\n          stats = fs.statSync(fromPath);\n        } catch {\n          continue;\n        }\n\n        if (stats.isDirectory()) {\n          handleDirectory.call(this, cwd, from, to);\n\n          continue;\n        }\n\n        if (stats.isFile()) {\n          handleFile.call(this, cwd, from, to);\n\n          continue;\n        }\n      }\n    }\n  };\n}\n\nexport { assetsPlugin };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAiBA,SAAS,aAAa,SAA0B;CAC9C,MAAM,MAAM,QAAQ,KAAK;AAEzB,QAAO;EACL,MAAM;EACN,gBAAgB,WAA+B;AAC7C,QAAK,MAAM,SAAS,SAAS;IAC3B,IAAI;IACJ,IAAI;AAEJ,QAAI,OAAO,UAAU,UAAU;AAC7B,YAAO;AACP,UAAK;WACA;AACL,YAAO,MAAM;AACb,UAAK,MAAM;;IAGb,MAAM,WAAW,KAAK,KAAK,KAAK,KAAK;IACrC,IAAI;AAEJ,QAAI;AACF,aAAQ,GAAG,SAAS,SAAS;YACvB;AACN;;AAGF,QAAI,MAAM,aAAa,EAAE;AACvB,qBAAgB,KAAK,MAAM,KAAK,MAAM,GAAG;AAEzC;;AAGF,QAAI,MAAM,QAAQ,EAAE;AAClB,gBAAW,KAAK,MAAM,KAAK,MAAM,GAAG;AAEpC;;;;EAIP"}

package/public-api.d.ts

@@ -0,0 +1,8 @@
+
+/*!
+ * Copyright (c) 2026 — present OGS Gesellschaft für Datenverarbeitung und Systemberatung mbH
+ * Licensed under MIT (See https://github.com/OGS-GmbH/rolldown-plugin-assets/LICENSE)
+ */
+
+export * from "./plugin.js";
+export * from "./types.js";

package/public-api.js

@@ -0,0 +1,8 @@
+
+/*!
+ * Copyright (c) 2026 — present OGS Gesellschaft für Datenverarbeitung und Systemberatung mbH
+ * Licensed under MIT (See https://github.com/OGS-GmbH/rolldown-plugin-assets/LICENSE)
+ */
+
+export * from "./plugin.js";
+export * from "./types.js";

package/types.d.ts

@@ -0,0 +1,37 @@
+
+/*!
+ * Copyright (c) 2026 — present OGS Gesellschaft für Datenverarbeitung und Systemberatung mbH
+ * Licensed under MIT (See https://github.com/OGS-GmbH/rolldown-plugin-assets/LICENSE)
+ */
+
+//#region src/types.d.ts
+/**
+ * An asset described as path to it.
+ *
+ * @author Simon Kovtyk
+ * @since 1.0.0
+ * @category Types
+ */
+type Asset = string;
+/**
+ * An `Array` that describes the source and destination paths for the asset.
+ *
+ * @remarks
+ * The first item of the `Array` is the source path and relative to `process.cwd`. The second `Array` item is the destination path, that is relative to Rolldown's output directory.
+ *
+ * @author Simon Kovtyk
+ * @since 1.0.0
+ * @category Types
+ */
+type AssetDirection = [string, string];
+/**
+ * Options for the plugin. See {@link Asset} and {@link AssetDirection} for more details.
+ *
+ * @author Simon Kovtyk
+ * @since 1.0.0
+ * @category Types
+ */
+type Options = Array<Asset | AssetDirection>;
+//#endregion
+export { type Asset, type AssetDirection, type Options };
+//# sourceMappingURL=types.d.ts.map

package/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/types.ts"],"mappings":";;;;;;;;;;;;;AAOU;KAAL,KAAA;;;;AAYc;;;;;;;KAAd,cAAA;;;;;;;;KASA,OAAA,GAAU,KAAA,CAAM,KAAA,GAAQ,cAAA"}

package/types.js

@@ -0,0 +1,6 @@
+
+/*!
+ * Copyright (c) 2026 — present OGS Gesellschaft für Datenverarbeitung und Systemberatung mbH
+ * Licensed under MIT (See https://github.com/OGS-GmbH/rolldown-plugin-assets/LICENSE)
+ */
+