@theholocron/rollup-plugin-transform-template 3.48.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Newton Koumantzelis
+
+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/README.md

@@ -0,0 +1,44 @@
+# `@theholocron/rollup-plugin-transform-template`
+
+Rollup plugin for Vite/Rolldown/tsdown that transforms template files into default-exported string literals so they can be imported directly in TypeScript/JavaScript.
+
+## Installation
+
+```sh
+pnpm add -D @theholocron/rollup-plugin-transform-template
+```
+
+## Usage
+
+```ts
+// vite.config.ts / vitest.config.ts / tsdown.config.ts
+import { transformTemplate } from "@theholocron/rollup-plugin-transform-template";
+
+export default defineConfig({
+  plugins: [transformTemplate({ dirs: ["/src/commands/setup/templates/"] })],
+});
+```
+
+Then import template files directly:
+
+```ts
+import editorconfigBody from "./editorconfig";
+import labelerBody from "./github-labeler.yml";
+// Both resolve to plain strings at runtime
+```
+
+## What gets transformed
+
+| File type              | Condition                          | Result                                                           |
+| ---------------------- | ---------------------------------- | ---------------------------------------------------------------- |
+| `.yml`                 | Always                             | Default-exported string                                          |
+| `.md`                  | Always                             | Default-exported string                                          |
+| Any non-JSON extension | Path contains a string from `dirs` | Default-exported string                                          |
+| `.json`                | Even inside `dirs`                 | Not transformed — bundlers handle JSON natively as typed objects |
+| `.ts` / `.tsx`         | Even inside `dirs`                 | Not transformed — source files, not templates                    |
+
+## Options
+
+| Option | Type       | Default | Description                                                                                                                |
+| ------ | ---------- | ------- | -------------------------------------------------------------------------------------------------------------------------- |
+| `dirs` | `string[]` | `[]`    | Path substrings — any file whose resolved id contains one of these strings (and isn't `.json`/`.ts`/`.tsx`) is transformed |

package/client.d.ts

@@ -0,0 +1,9 @@
+/** Ambient declarations: *.yml and *.md files are inlined as strings by transformTemplate. */
+declare module "*.yml" {
+	const content: string;
+	export default content;
+}
+declare module "*.md" {
+	const content: string;
+	export default content;
+}

package/dist/index.d.mts

@@ -0,0 +1,39 @@
+//#region src/index.d.ts
+interface TransformTemplateOptions {
+  /**
+   * Additional directory path segments. Any file whose resolved id contains
+   * one of these strings is transformed into a default-exported string,
+   * regardless of extension (except .json, which is handled natively by most
+   * bundlers and should not be double-transformed).
+   *
+   * @example
+   * transformTemplate({ dirs: ["/commands/setup/templates/"] })
+   */
+  dirs?: string[];
+}
+/**
+ * Rollup/Vite/Rolldown plugin that transforms text files into
+ * default-exported string literals so they can be imported directly in code.
+ *
+ * Two categories of files are transformed:
+ *  1. `.yml` and `.md` files — always, regardless of location.
+ *  2. Any non-JSON file whose resolved path contains a string listed in `dirs`.
+ *
+ * JSON files in `dirs` are intentionally excluded: bundlers handle `.json`
+ * imports natively as typed objects, which is more useful than a raw string.
+ *
+ * @example
+ * // vite.config.ts / vitest.config.ts / tsdown.config.ts
+ * import { transformTemplate } from "@theholocron/rollup-plugin-transform-template";
+ *
+ * plugins: [transformTemplate({ dirs: ["/src/commands/setup/templates/"] })]
+ */
+declare function transformTemplate(options?: TransformTemplateOptions): {
+  name: string;
+  transform(_code: string, id: string): {
+    code: string;
+    map: null;
+  } | null;
+};
+//#endregion
+export { TransformTemplateOptions, transformTemplate };

package/dist/index.mjs

@@ -0,0 +1,37 @@
+import { readFileSync } from "node:fs";
+//#region src/index.ts
+/**
+* Rollup/Vite/Rolldown plugin that transforms text files into
+* default-exported string literals so they can be imported directly in code.
+*
+* Two categories of files are transformed:
+*  1. `.yml` and `.md` files — always, regardless of location.
+*  2. Any non-JSON file whose resolved path contains a string listed in `dirs`.
+*
+* JSON files in `dirs` are intentionally excluded: bundlers handle `.json`
+* imports natively as typed objects, which is more useful than a raw string.
+*
+* @example
+* // vite.config.ts / vitest.config.ts / tsdown.config.ts
+* import { transformTemplate } from "@theholocron/rollup-plugin-transform-template";
+*
+* plugins: [transformTemplate({ dirs: ["/src/commands/setup/templates/"] })]
+*/
+function transformTemplate(options = {}) {
+	const { dirs = [] } = options;
+	return {
+		name: "rollup-plugin-transform-template",
+		transform(_code, id) {
+			const isYmlOrMd = id.endsWith(".yml") || id.endsWith(".md");
+			const isNativeOrSource = id.endsWith(".json") || id.endsWith(".ts") || id.endsWith(".tsx");
+			const isTemplateDir = dirs.length > 0 && dirs.some((dir) => id.includes(dir)) && !isNativeOrSource;
+			if (!isYmlOrMd && !isTemplateDir) return null;
+			return {
+				code: `export default ${JSON.stringify(readFileSync(id, "utf8"))};`,
+				map: null
+			};
+		}
+	};
+}
+//#endregion
+export { transformTemplate };

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@theholocron/rollup-plugin-transform-template",
+  "version": "3.48.0",
+  "description": "Rollup/Vite/Rolldown plugin that transforms template files into default-exported strings.",
+  "keywords": [
+    "rollup",
+    "plugin",
+    "rollup-plugin",
+    "vite",
+    "rolldown",
+    "template",
+    "transform"
+  ],
+  "homepage": "https://github.com/theholocron/holocron/tree/main/packages/rollup-plugin-transform-template#readme",
+  "bugs": "https://github.com/theholocron/holocron/issues",
+  "repository": "theholocron/holocron",
+  "license": "GPL-3.0",
+  "author": "Newton Koumantzelis",
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./client": {
+      "types": "./client.d.ts",
+      "default": "./client.d.ts"
+    }
+  },
+  "files": [
+    "client.d.ts",
+    "dist"
+  ],
+  "devDependencies": {
+    "@theholocron/eslint-config": "^7.32.1",
+    "@theholocron/tsconfig": "^7.32.1",
+    "@theholocron/tsdown-config": "^7.32.1",
+    "@theholocron/vitest-config": "^7.32.1",
+    "@types/node": "^26",
+    "vitest": "^4.1.11"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "lint": "eslint src",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  }
+}