rolldown-plugin-access-privates 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Martin Elend
+
+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,2 @@
+# rolldown-plugin-access-privates
+Rolldown Plugin to add accessors for class Private Fields

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+import { type GeneralHookFilter, type Plugin } from "rolldown";
+import { type ESTree } from "rolldown/utils";
+/**
+ * A Vite plugin to generate accessors for private fields to allow testing them.
+ * This plugin will generate getter and setter methods for private fields and methods, allowing you to access them in your tests.
+ * For example, if you have a private field `#foo`, the plugin will generate `fooPrivate` getter and setter.
+ * Also automatically exports all top-level variables, functions, and classes in the module, allowing you to import them in your tests without needing to use `export` in your source code.
+ * @param options - Options for the plugin.
+ * @returns
+ */
+export default function AccessPrivates({ exports, classMembers, suffix, idFilter }?: {
+    /**
+     * Whether to export all top-level variables, functions, and classes in the module.
+     * Can be an array of "variable", "function", and "class", or a function that will be called with the module ID and AST node of each variable, function, or class declaration
+     * @default true
+     */
+    exports?: ("variable" | "function" | "class")[] | boolean | ((id: string, astNode: ESTree.VariableDeclaration | ESTree.Function | ESTree.Class) => boolean) | undefined;
+    /**
+     * Which class members to generate accessors for.
+     * Can be an array of "method", "get", "set", and "property", or a function that will be called with the module ID and AST node of each method or property definition.
+     * @default true
+     */
+    classMembers?: ("method" | "get" | "set" | "property")[] | boolean | ((id: string, astNode: ESTree.MethodDefinition | ESTree.PropertyDefinition) => boolean) | undefined;
+    /**
+     * The suffix to use for the generated accessors. Defaults to "Private". For example, if you have a private field `#foo`, the plugin will generate `fooPrivate` getter and setter.
+     * @default "Private"
+     */
+    suffix?: string | ((name: string) => string) | undefined;
+    /**
+     * Filter for which modules the plugin should apply.
+     * Can be a string, a RegExp, an array of strings and RegExps, or an object with an `include` and `exclude` property, each of which can be a string, a RegExp, or an array of strings and RegExps.
+     * The filter will be applied to the module ID.
+     * @default /\.[jt]sx?$/
+     */
+    idFilter?: GeneralHookFilter | undefined;
+}): Plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAE/D,OAAO,EAAW,KAAK,MAAM,EAAsB,MAAM,gBAAgB,CAAC;AAS1E;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,EACrC,OAAc,EACd,YAAmB,EACnB,MAAkB,EAClB,QAAuB,EACxB,GAAE;IACD;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC,EAAE,GAAG,OAAO,GAAG,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,mBAAmB,GAAG,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,KAAK,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;IACxK;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,UAAU,CAAC,EAAE,GAAG,OAAO,GAAG,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,gBAAgB,GAAG,MAAM,CAAC,kBAAkB,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;IACzK;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,SAAS,CAAC;IACzD;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;CACrC,GAAG,MAAM,CA6Fd"}

package/dist/index.js

@@ -0,0 +1,124 @@
+import {} from "rolldown";
+import { withMagicString } from "rolldown-string";
+import { Visitor } from "rolldown/utils";
+/** Map exports types to their corresponding AST node types */
+const exportsToType = {
+    variable: "VariableDeclaration",
+    function: "FunctionDeclaration",
+    class: "ClassDeclaration",
+};
+/**
+ * A Vite plugin to generate accessors for private fields to allow testing them.
+ * This plugin will generate getter and setter methods for private fields and methods, allowing you to access them in your tests.
+ * For example, if you have a private field `#foo`, the plugin will generate `fooPrivate` getter and setter.
+ * Also automatically exports all top-level variables, functions, and classes in the module, allowing you to import them in your tests without needing to use `export` in your source code.
+ * @param options - Options for the plugin.
+ * @returns
+ */
+export default function AccessPrivates({ exports = true, classMembers = true, suffix = "Private", idFilter = /\.[jt]sx?$/, } = {}) {
+    // Calculate which code path can be optimized.
+    const canNotExport = exports === false || (Array.isArray(exports) && exports.length === 0);
+    const canNotPropertyDefinition = classMembers === false || (Array.isArray(classMembers) && (classMembers.length === 0 || !classMembers.includes("property")));
+    const canNotMethodDefinition = classMembers === false || (Array.isArray(classMembers) && (classMembers.length === 0 || !classMembers.some(m => m === "method" || m === "get" || m === "set")));
+    // Transform filters in to a unified format
+    if (typeof exports === "boolean") {
+        const shouldExport = exports;
+        exports = () => shouldExport;
+    }
+    else if (Array.isArray(exports)) {
+        const mappedExports = exports.map(e => exportsToType[e]);
+        exports = (_id, astNode) => mappedExports.includes(astNode.type);
+    }
+    if (typeof classMembers === "boolean") {
+        const shouldGenerate = classMembers;
+        classMembers = () => shouldGenerate;
+    }
+    else if (Array.isArray(classMembers)) {
+        const members = classMembers;
+        classMembers = (_id, astNode) => {
+            if (astNode.type === "PropertyDefinition")
+                return members.includes("property");
+            if (astNode.type === "MethodDefinition") {
+                if (astNode.kind === "method")
+                    return members.includes("method");
+                if (astNode.kind === "get")
+                    return members.includes("get");
+                if (astNode.kind === "set")
+                    return members.includes("set");
+            }
+            return false;
+        };
+    }
+    if (typeof suffix === "string") {
+        const suffixString = suffix;
+        suffix = (name) => name + suffixString;
+    }
+    // Definition of the Plugin
+    return {
+        name: "rolldown-plugin-access-privates",
+        transform: {
+            // Filters to optimize the plugin by skipping modules that don't need to be transformed.
+            filter: {
+                id: idFilter,
+                // if there is no need to add exports, we only need to process modules that have private class members.
+                ...(canNotExport ? { code: "#" } : {}),
+            },
+            // Function implementing the transformation logic.
+            handler: withMagicString(function (code, id, meta) {
+                // If ast is provided in meta, use it. Otherwise, parse the code with the appropriate language based on the file extension.
+                let ast = meta.ast !== undefined ? meta.ast : this.parse(code.original, { lang: id.endsWith('.tsx') ? 'tsx' : id.endsWith('.ts') ? 'ts' : id.endsWith('.jsx') ? 'jsx' : 'js' });
+                const visitors = {};
+                // only add the visitors needed.
+                if (!canNotExport) {
+                    // Visitor to add export keyword to top-level variable, function, and class declarations.
+                    visitors.Program = function (node) {
+                        for (const child of node.body) {
+                            if (child.type !== "VariableDeclaration" && child.type !== "FunctionDeclaration" && child.type !== "ClassDeclaration" || child.declare)
+                                continue;
+                            if (!exports(id, child))
+                                continue;
+                            code.appendLeft(child.start, "export ");
+                        }
+                    };
+                }
+                if (!canNotPropertyDefinition) {
+                    // Visitor to add getter and setter for private fields defined with PropertyDefinition.
+                    visitors.PropertyDefinition = function (node) {
+                        if (node.type !== "PropertyDefinition" || node.key.type !== "PrivateIdentifier" || node.declare || node.override)
+                            return;
+                        if (!classMembers(id, node))
+                            return;
+                        const name = suffix(node.key.name);
+                        code.appendRight(node.end, `\n${node.static ? "static " : ""}get ["${name}"]() {return this.#${node.key.name};}`);
+                        code.appendRight(node.end, `\n${node.static ? "static " : ""}set ["${name}"](value) {this.#${node.key.name} = value;}`);
+                    };
+                }
+                if (!canNotMethodDefinition) {
+                    // Visitor to add getter and setter for private fields defined with MethodDefinition.
+                    visitors.MethodDefinition = function (node) {
+                        if (node.type !== "MethodDefinition" || node.key.type !== "PrivateIdentifier" || node.override)
+                            return;
+                        if (!classMembers(id, node))
+                            return;
+                        const name = suffix(node.key.name);
+                        switch (node.kind) {
+                            case "method":
+                                code.appendRight(node.end, `\n${node.static ? "static " : ""}get ["${name}"]() {return this.#${node.key.name};}`);
+                                code.appendRight(node.end, `\n${node.static ? "static " : ""}set ["${name}"](value) {this.#${node.key.name} = value;}`);
+                                break;
+                            case "get":
+                                code.appendRight(node.end, `\n${node.static ? "static " : ""}get ["${name}"]() {return this.#${node.key.name};}`);
+                                break;
+                            case "set":
+                                code.appendRight(node.end, `\n${node.static ? "static " : ""}set ["${name}"](value) {this.#${node.key.name} = value;}`);
+                                break;
+                        }
+                    };
+                }
+                // Walk the AST with the defined visitors to apply the transformations.
+                new Visitor(visitors).visit(ast);
+            }),
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "rolldown-plugin-access-privates",
+  "version": "0.1.0",
+  "description": "Rolldown Plugin to add accessors for class Private Fields",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/IIIMADDINIII/rolldown-plugin-access-privates"
+  },
+  "author": "IIIMADDINIII <martin@elend.name>",
+  "license": "MIT",
+  "keywords": [
+    "private",
+    "class",
+    "fields",
+    "accessors",
+    "rolldown",
+    "rolldown-plugin",
+    "testing"
+  ],
+  "bugs": {
+    "url": "https://github.com/IIIMADDINIII/rolldown-plugin-access-privates/issues"
+  },
+  "homepage": "https://github.com/IIIMADDINIII/rolldown-plugin-access-privates#readme",
+  "devDependencies": {
+    "@typescript/native-preview": "^7.0.0-dev.20260324.1"
+  },
+  "peerDependencies": {
+    "rolldown": ">=1.0.0-rc.12"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "rolldown-string": "^0.3.0",
+    "tslib": ">=2.8.1"
+  },
+  "compatiblePackages": {
+    "schemaVersion": 1,
+    "rollup": {
+      "type": "incompatible",
+      "reason": "Uses Rolldown-specific APIs"
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,143 @@
+import { type GeneralHookFilter, type Plugin } from "rolldown";
+import { withMagicString } from "rolldown-string";
+import { Visitor, type ESTree, type VisitorObject } from "rolldown/utils";
+
+/** Map exports types to their corresponding AST node types */
+const exportsToType = {
+  variable: "VariableDeclaration",
+  function: "FunctionDeclaration",
+  class: "ClassDeclaration",
+} as const;
+
+/**
+ * A Vite plugin to generate accessors for private fields to allow testing them.
+ * This plugin will generate getter and setter methods for private fields and methods, allowing you to access them in your tests.
+ * For example, if you have a private field `#foo`, the plugin will generate `fooPrivate` getter and setter.
+ * Also automatically exports all top-level variables, functions, and classes in the module, allowing you to import them in your tests without needing to use `export` in your source code.
+ * @param options - Options for the plugin.
+ * @returns 
+ */
+export default function AccessPrivates({
+  exports = true,
+  classMembers = true,
+  suffix = "Private",
+  idFilter = /\.[jt]sx?$/,
+}: {
+  /**
+   * Whether to export all top-level variables, functions, and classes in the module. 
+   * Can be an array of "variable", "function", and "class", or a function that will be called with the module ID and AST node of each variable, function, or class declaration
+   * @default true
+   */
+  exports?: ("variable" | "function" | "class")[] | boolean | ((id: string, astNode: ESTree.VariableDeclaration | ESTree.Function | ESTree.Class) => boolean) | undefined;
+  /**
+   * Which class members to generate accessors for.
+   * Can be an array of "method", "get", "set", and "property", or a function that will be called with the module ID and AST node of each method or property definition.
+   * @default true
+   */
+  classMembers?: ("method" | "get" | "set" | "property")[] | boolean | ((id: string, astNode: ESTree.MethodDefinition | ESTree.PropertyDefinition) => boolean) | undefined;
+  /**
+   * The suffix to use for the generated accessors. Defaults to "Private". For example, if you have a private field `#foo`, the plugin will generate `fooPrivate` getter and setter.
+   * @default "Private"
+   */
+  suffix?: string | ((name: string) => string) | undefined;
+  /**
+   * Filter for which modules the plugin should apply.
+   * Can be a string, a RegExp, an array of strings and RegExps, or an object with an `include` and `exclude` property, each of which can be a string, a RegExp, or an array of strings and RegExps.
+   * The filter will be applied to the module ID.
+   * @default /\.[jt]sx?$/
+   */
+  idFilter?: GeneralHookFilter | undefined;
+} = {}): Plugin {
+  // Calculate which code path can be optimized.
+  const canNotExport = exports === false || (Array.isArray(exports) && exports.length === 0);
+  const canNotPropertyDefinition = classMembers === false || (Array.isArray(classMembers) && (classMembers.length === 0 || !classMembers.includes("property")));
+  const canNotMethodDefinition = classMembers === false || (Array.isArray(classMembers) && (classMembers.length === 0 || !classMembers.some(m => m === "method" || m === "get" || m === "set")));
+  // Transform filters in to a unified format
+  if (typeof exports === "boolean") {
+    const shouldExport = exports;
+    exports = () => shouldExport;
+  } else if (Array.isArray(exports)) {
+    const mappedExports: ESTree.Node["type"][] = exports.map(e => exportsToType[e]);
+    exports = (_id, astNode) => mappedExports.includes(astNode.type);
+  }
+  if (typeof classMembers === "boolean") {
+    const shouldGenerate = classMembers;
+    classMembers = () => shouldGenerate;
+  } else if (Array.isArray(classMembers)) {
+    const members = classMembers;
+    classMembers = (_id, astNode) => {
+      if (astNode.type === "PropertyDefinition") return members.includes("property");
+      if (astNode.type === "MethodDefinition") {
+        if (astNode.kind === "method") return members.includes("method");
+        if (astNode.kind === "get") return members.includes("get");
+        if (astNode.kind === "set") return members.includes("set");
+      }
+      return false;
+    };
+  }
+  if (typeof suffix === "string") {
+    const suffixString = suffix;
+    suffix = (name) => name + suffixString;
+  }
+  // Definition of the Plugin
+  return {
+    name: "rolldown-plugin-access-privates",
+    transform: {
+      // Filters to optimize the plugin by skipping modules that don't need to be transformed.
+      filter: {
+        id: idFilter,
+        // if there is no need to add exports, we only need to process modules that have private class members.
+        ...(canNotExport ? { code: "#" } : {}),
+      },
+      // Function implementing the transformation logic.
+      handler: withMagicString(function (code, id, meta) {
+        // If ast is provided in meta, use it. Otherwise, parse the code with the appropriate language based on the file extension.
+        let ast = meta.ast !== undefined ? meta.ast : this.parse(code.original, { lang: id.endsWith('.tsx') ? 'tsx' : id.endsWith('.ts') ? 'ts' : id.endsWith('.jsx') ? 'jsx' : 'js' });
+        const visitors: VisitorObject = {};
+        // only add the visitors needed.
+        if (!canNotExport) {
+          // Visitor to add export keyword to top-level variable, function, and class declarations.
+          visitors.Program = function (node) {
+            for (const child of node.body) {
+              if (child.type !== "VariableDeclaration" && child.type !== "FunctionDeclaration" && child.type !== "ClassDeclaration" || child.declare) continue;
+              if (!exports(id, child)) continue;
+              code.appendLeft(child.start, "export ");
+            }
+          };
+        }
+        if (!canNotPropertyDefinition) {
+          // Visitor to add getter and setter for private fields defined with PropertyDefinition.
+          visitors.PropertyDefinition = function (node) {
+            if (node.type !== "PropertyDefinition" || node.key.type !== "PrivateIdentifier" || node.declare || node.override) return;
+            if (!classMembers(id, node)) return;
+            const name = suffix(node.key.name);
+            code.appendRight(node.end, `\n${node.static ? "static " : ""}get ["${name}"]() {return this.#${node.key.name};}`);
+            code.appendRight(node.end, `\n${node.static ? "static " : ""}set ["${name}"](value) {this.#${node.key.name} = value;}`);
+          };
+        }
+        if (!canNotMethodDefinition) {
+          // Visitor to add getter and setter for private fields defined with MethodDefinition.
+          visitors.MethodDefinition = function (node) {
+            if (node.type !== "MethodDefinition" || node.key.type !== "PrivateIdentifier" || node.override) return;
+            if (!classMembers(id, node)) return;
+            const name = suffix(node.key.name);
+            switch (node.kind) {
+              case "method":
+                code.appendRight(node.end, `\n${node.static ? "static " : ""}get ["${name}"]() {return this.#${node.key.name};}`);
+                code.appendRight(node.end, `\n${node.static ? "static " : ""}set ["${name}"](value) {this.#${node.key.name} = value;}`);
+                break;
+              case "get":
+                code.appendRight(node.end, `\n${node.static ? "static " : ""}get ["${name}"]() {return this.#${node.key.name};}`);
+                break;
+              case "set":
+                code.appendRight(node.end, `\n${node.static ? "static " : ""}set ["${name}"](value) {this.#${node.key.name} = value;}`);
+                break;
+            }
+          };
+        }
+        // Walk the AST with the defined visitors to apply the transformations.
+        new Visitor(visitors).visit(ast);
+      }),
+    },
+  };
+}