@elg/tscodegen 0.1.1 → 0.3.0

package/.circleci/config.yml

@@ -0,0 +1,38 @@
+version: 2.1
+
+jobs:
+  build:
+    working_directory: ~/tscodegen
+    docker:
+      - image: cimg/node:lts
+    steps:
+      - checkout
+      - restore_cache:
+          keys:
+            - v3-node-{{ arch }}-{{ .Branch }}-{{ checksum "yarn.lock" }}
+            - v3-node-{{ arch }}-{{ .Branch }}-
+            - v3-node-{{ arch }}-
+      - run:
+          name: Install Dependencies
+          command: yarn --frozen-lockfile --cache-folder ~/.cache/yarn --non-interactive
+      - save_cache:
+          key: v3-node-{{ arch }}-{{ .Branch }}-{{ checksum "yarn.lock" }}
+          paths:
+            - ~/.cache/yarn
+            - node_modules
+      - run:
+          name: Typecheck Code
+          command: yarn typecheck
+      - run:
+          name: Run Linters
+          command: yarn lint
+      - run:
+          name: Test code
+          environment:
+            NODE_ENV: test
+          command: |
+            set -e
+            yarn test
+            yarn codecov --disable=gcov -f ./coverage/coverage-final.json
+      - store_test_results:
+          path: test-reports

package/CHANGELOG.md

@@ -0,0 +1,35 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.3.0] - 2026-03-02
+
+### Added
+
+- `CodeBuilder.format` now accepts an optional `prettierOptions` parameter to customize Prettier formatting without resolving config from disk.
+
+### Breaking
+
+- **Prettier 3 only:** `peerDependencies.prettier` is now `3.x` (was `2.x || 3.x`).
+- Added `@prettier/sync` as a runtime dependency for Prettier 3 compatibility.
+
+### Changed
+
+- Bumped dev dependencies to latest: TypeScript 5.x, ESLint 10.x, Jest 30.x, Prettier 3.x, and related tooling.
+- TypeScript target updated from ES2015 to ES2018.
+- Migrated ESLint to flat config (`eslint.config.mjs`).
+
+## [0.2.0] - 2020-06-08
+
+### Added
+
+- `CodeFile.lock`, a new manual lock step that allows you to customize the
+  lock docstring.
+
+### Changed
+
+- **BREAKNG:** `CodeFile.build` no longer locks the file automatically. Call
+  `CodeFile.lock` after calling `build` to get the old behavior.

package/README.md

@@ -1,5 +1,9 @@
 # tscodegen
 
+[![CircleCI](https://circleci.com/gh/taneliang/tscodegen.svg?style=svg)](https://circleci.com/gh/taneliang/tscodegen)
+[![codecov](https://codecov.io/gh/taneliang/tscodegen/branch/master/graph/badge.svg)](https://codecov.io/gh/taneliang/tscodegen)
+[![Maintainability](https://api.codeclimate.com/v1/badges/bbc025c3c4e1ce23b002/maintainability)](https://codeclimate.com/github/taneliang/tscodegen/maintainability)
+
 [tscodegen](https://www.npmjs.com/package/@elg/tscodegen) is a minimal
 TypeScript port of [Facebook's Hack
 Codegen](https://hhvm.github.io/hack-codegen). It provides a fluent API that
@@ -67,17 +71,18 @@ new CodeFile("./file.ts")
       .addBlock("class Steam extends Water", (builder) =>
         builder
           .addBlock("constructor()", (builder) =>
-            builder.addLine("this.boil();")
+            builder.addLine("this.boil();"),
           )
           .addLine()
           .addBlock("boil()", (b) =>
             b.addManualSection("boil_body", (builder) =>
-              builder.add("this.temp = 100;")
-            )
-          )
+              builder.add("this.temp = 100;"),
+            ),
+          ),
       )
-      .format()
+      .format(),
   )
+  .lock()
   .saveToFile();
 ```
 

package/coverage/coverage-final.json

@@ -0,0 +1,6 @@
+{"/Users/e-liang/a/tscodegen/src/CodeFile.ts": {"path":"/Users/e-liang/a/tscodegen/src/CodeFile.ts","statementMap":{"0":{"start":{"line":1,"column":0},"end":{"line":1,"column":20}},"1":{"start":{"line":2,"column":0},"end":{"line":2,"column":44}},"2":{"start":{"line":3,"column":0},"end":{"line":3,"column":67}},"3":{"start":{"line":4,"column":0},"end":{"line":4,"column":58}},"4":{"start":{"line":10,"column":2},"end":{"line":10,"column":35}},"5":{"start":{"line":11,"column":2},"end":{"line":11,"column":29}},"6":{"start":{"line":12,"column":2},"end":{"line":12,"column":21}},"7":{"start":{"line":13,"column":2},"end":{"line":13,"column":46}},"8":{"start":{"line":16,"column":4},"end":{"line":16,"column":42}},"9":{"start":{"line":17,"column":4},"end":{"line":23,"column":null}},"10":{"start":{"line":18,"column":6},"end":{"line":18,"column":76}},"11":{"start":{"line":19,"column":6},"end":{"line":19,"column":54}},"12":{"start":{"line":20,"column":6},"end":{"line":22,"column":31}},"13":{"start":{"line":30,"column":4},"end":{"line":30,"column":42}},"14":{"start":{"line":40,"column":20},"end":{"line":41,"column":null}},"15":{"start":{"line":43,"column":4},"end":{"line":43,"column":44}},"16":{"start":{"line":44,"column":4},"end":{"line":44,"column":62}},"17":{"start":{"line":45,"column":4},"end":{"line":45,"column":16}},"18":{"start":{"line":58,"column":4},"end":{"line":62,"column":6}},"19":{"start":{"line":63,"column":4},"end":{"line":63,"column":16}},"20":{"start":{"line":70,"column":4},"end":{"line":70,"column":30}},"21":{"start":{"line":81,"column":4},"end":{"line":84,"column":null}},"22":{"start":{"line":82,"column":6},"end":{"line":82,"column":74}},"23":{"start":{"line":83,"column":6},"end":{"line":83,"column":54}},"24":{"start":{"line":9,"column":0},"end":{"line":9,"column":13}}},"fnMap":{"0":{"name":"(anonymous_3)","decl":{"start":{"line":15,"column":2},"end":{"line":15,"column":14}},"loc":{"start":{"line":15,"column":36},"end":{"line":24,"column":3}}},"1":{"name":"(anonymous_4)","decl":{"start":{"line":29,"column":2},"end":{"line":29,"column":8}},"loc":{"start":{"line":29,"column":8},"end":{"line":31,"column":3}}},"2":{"name":"(anonymous_5)","decl":{"start":{"line":39,"column":2},"end":{"line":39,"column":7}},"loc":{"start":{"line":39,"column":61},"end":{"line":46,"column":3}}},"3":{"name":"(anonymous_6)","decl":{"start":{"line":57,"column":2},"end":{"line":57,"column":6}},"loc":{"start":{"line":57,"column":25},"end":{"line":64,"column":3}}},"4":{"name":"(anonymous_7)","decl":{"start":{"line":69,"column":2},"end":{"line":69,"column":10}},"loc":{"start":{"line":69,"column":10},"end":{"line":71,"column":3}}},"5":{"name":"(anonymous_8)","decl":{"start":{"line":80,"column":2},"end":{"line":80,"column":12}},"loc":{"start":{"line":80,"column":26},"end":{"line":85,"column":3}}}},"branchMap":{"0":{"loc":{"start":{"line":17,"column":4},"end":{"line":23,"column":null}},"type":"if","locations":[{"start":{"line":17,"column":4},"end":{"line":23,"column":null}},{"start":{"line":17,"column":4},"end":{"line":23,"column":null}}]},"1":{"loc":{"start":{"line":22,"column":7},"end":{"line":22,"column":9}},"type":"cond-expr","locations":[{"start":{"line":22,"column":7},"end":{"line":22,"column":9}},{"start":{"line":22,"column":7},"end":{"line":22,"column":30}}]},"2":{"loc":{"start":{"line":20,"column":10},"end":{"line":22,"column":9}},"type":"binary-expr","locations":[{"start":{"line":20,"column":10},"end":{"line":22,"column":9}},{"start":{"line":22,"column":7},"end":{"line":22,"column":9}}]},"3":{"loc":{"start":{"line":57,"column":23},"end":{"line":57,"column":25}},"type":"default-arg","locations":[{"start":{"line":57,"column":23},"end":{"line":57,"column":25}}]},"4":{"loc":{"start":{"line":58,"column":33},"end":{"line":58,"column":null}},"type":"cond-expr","locations":[{"start":{"line":58,"column":33},"end":{"line":58,"column":null}},{"start":{"line":60,"column":37},"end":{"line":60,"column":42}}]},"5":{"loc":{"start":{"line":58,"column":33},"end":{"line":58,"column":null}},"type":"binary-expr","locations":[{"start":{"line":58,"column":33},"end":{"line":58,"column":null}},{"start":{"line":58,"column":33},"end":{"line":58,"column":null}}]},"6":{"loc":{"start":{"line":80,"column":21},"end":{"line":80,"column":26}},"type":"default-arg","locations":[{"start":{"line":80,"column":21},"end":{"line":80,"column":26}}]},"7":{"loc":{"start":{"line":81,"column":4},"end":{"line":84,"column":null}},"type":"if","locations":[{"start":{"line":81,"column":4},"end":{"line":84,"column":null}},{"start":{"line":81,"column":4},"end":{"line":84,"column":null}}]},"8":{"loc":{"start":{"line":81,"column":8},"end":{"line":81,"column":13}},"type":"binary-expr","locations":[{"start":{"line":81,"column":8},"end":{"line":81,"column":13}},{"start":{"line":81,"column":17},"end":{"line":81,"column":66}}]}},"s":{"0":0,"1":0,"2":0,"3":0,"4":0,"5":0,"6":0,"7":0,"8":0,"9":0,"10":0,"11":0,"12":0,"13":0,"14":0,"15":0,"16":0,"17":0,"18":0,"19":0,"20":0,"21":0,"22":0,"23":0,"24":0},"f":{"0":0,"1":0,"2":0,"3":0,"4":0,"5":0},"b":{"0":[0,0],"1":[0,0],"2":[0,0],"3":[0],"4":[0,0],"5":[0,0],"6":[0],"7":[0,0],"8":[0,0]}}
+,"/Users/e-liang/a/tscodegen/src/codelock.ts": {"path":"/Users/e-liang/a/tscodegen/src/codelock.ts","statementMap":{"0":{"start":{"line":1,"column":0},"end":{"line":1,"column":28}},"1":{"start":{"line":2,"column":0},"end":{"line":2,"column":null}},"2":{"start":{"line":7,"column":0},"end":{"line":7,"column":56}},"3":{"start":{"line":21,"column":19},"end":{"line":21,"column":46}},"4":{"start":{"line":22,"column":2},"end":{"line":24,"column":null}},"5":{"start":{"line":23,"column":4},"end":{"line":23,"column":21}},"6":{"start":{"line":26,"column":24},"end":{"line":26,"column":44}},"7":{"start":{"line":27,"column":2},"end":{"line":29,"column":null}},"8":{"start":{"line":28,"column":4},"end":{"line":28,"column":21}},"9":{"start":{"line":32,"column":19},"end":{"line":32,"column":58}},"10":{"start":{"line":34,"column":27},"end":{"line":35,"column":76}},"11":{"start":{"line":36,"column":2},"end":{"line":41,"column":null}},"12":{"start":{"line":37,"column":4},"end":{"line":40,"column":6}},"13":{"start":{"line":43,"column":29},"end":{"line":45,"column":11}},"14":{"start":{"line":46,"column":2},"end":{"line":51,"column":null}},"15":{"start":{"line":47,"column":4},"end":{"line":50,"column":6}},"16":{"start":{"line":53,"column":2},"end":{"line":53,"column":19}},"17":{"start":{"line":19,"column":0},"end":{"line":19,"column":16}},"18":{"start":{"line":65,"column":23},"end":{"line":67,"column":10}},"19":{"start":{"line":68,"column":2},"end":{"line":71,"column":22}},"20":{"start":{"line":89,"column":15},"end":{"line":89,"column":55}},"21":{"start":{"line":93,"column":2},"end":{"line":103,"column":null}},"22":{"start":{"line":94,"column":4},"end":{"line":98,"column":41}},"23":{"start":{"line":100,"column":4},"end":{"line":102,"column":32}},"24":{"start":{"line":105,"column":2},"end":{"line":105,"column":52}},"25":{"start":{"line":84,"column":0},"end":{"line":84,"column":16}},"26":{"start":{"line":115,"column":24},"end":{"line":115,"column":51}},"27":{"start":{"line":116,"column":2},"end":{"line":118,"column":null}},"28":{"start":{"line":117,"column":4},"end":{"line":117,"column":17}},"29":{"start":{"line":119,"column":2},"end":{"line":125,"column":4}},"30":{"start":{"line":114,"column":0},"end":{"line":114,"column":16}}},"fnMap":{"0":{"name":"getCodelockInfo","decl":{"start":{"line":19,"column":16},"end":{"line":19,"column":31}},"loc":{"start":{"line":19,"column":50},"end":{"line":54,"column":1}}},"1":{"name":"computeHash","decl":{"start":{"line":64,"column":9},"end":{"line":64,"column":20}},"loc":{"start":{"line":64,"column":69},"end":{"line":72,"column":1}}},"2":{"name":"lockCode","decl":{"start":{"line":84,"column":16},"end":{"line":84,"column":24}},"loc":{"start":{"line":87,"column":20},"end":{"line":106,"column":1}}},"3":{"name":"verifyLock","decl":{"start":{"line":114,"column":16},"end":{"line":114,"column":26}},"loc":{"start":{"line":114,"column":45},"end":{"line":126,"column":1}}}},"branchMap":{"0":{"loc":{"start":{"line":22,"column":2},"end":{"line":24,"column":null}},"type":"if","locations":[{"start":{"line":22,"column":2},"end":{"line":24,"column":null}},{"start":{"line":22,"column":2},"end":{"line":24,"column":null}}]},"1":{"loc":{"start":{"line":27,"column":2},"end":{"line":29,"column":null}},"type":"if","locations":[{"start":{"line":27,"column":2},"end":{"line":29,"column":null}},{"start":{"line":27,"column":2},"end":{"line":29,"column":null}}]},"2":{"loc":{"start":{"line":35,"column":68},"end":{"line":35,"column":70}},"type":"cond-expr","locations":[{"start":{"line":35,"column":68},"end":{"line":35,"column":70}},{"start":{"line":35,"column":68},"end":{"line":35,"column":76}}]},"3":{"loc":{"start":{"line":34,"column":27},"end":{"line":35,"column":70}},"type":"binary-expr","locations":[{"start":{"line":34,"column":27},"end":{"line":35,"column":70}},{"start":{"line":35,"column":68},"end":{"line":35,"column":70}}]},"4":{"loc":{"start":{"line":36,"column":2},"end":{"line":41,"column":null}},"type":"if","locations":[{"start":{"line":36,"column":2},"end":{"line":41,"column":null}},{"start":{"line":36,"column":2},"end":{"line":41,"column":null}}]},"5":{"loc":{"start":{"line":45,"column":3},"end":{"line":45,"column":5}},"type":"cond-expr","locations":[{"start":{"line":45,"column":3},"end":{"line":45,"column":5}},{"start":{"line":45,"column":3},"end":{"line":45,"column":11}}]},"6":{"loc":{"start":{"line":43,"column":29},"end":{"line":45,"column":5}},"type":"binary-expr","locations":[{"start":{"line":43,"column":29},"end":{"line":45,"column":5}},{"start":{"line":45,"column":3},"end":{"line":45,"column":5}}]},"7":{"loc":{"start":{"line":46,"column":2},"end":{"line":51,"column":null}},"type":"if","locations":[{"start":{"line":46,"column":2},"end":{"line":51,"column":null}},{"start":{"line":46,"column":2},"end":{"line":51,"column":null}}]},"8":{"loc":{"start":{"line":66,"column":32},"end":{"line":66,"column":57}},"type":"cond-expr","locations":[{"start":{"line":66,"column":32},"end":{"line":66,"column":57}},{"start":{"line":66,"column":60},"end":{"line":66,"column":64}}]},"9":{"loc":{"start":{"line":87,"column":18},"end":{"line":87,"column":20}},"type":"default-arg","locations":[{"start":{"line":87,"column":18},"end":{"line":87,"column":20}}]},"10":{"loc":{"start":{"line":93,"column":2},"end":{"line":103,"column":null}},"type":"if","locations":[{"start":{"line":93,"column":2},"end":{"line":103,"column":null}},{"start":{"line":93,"column":2},"end":{"line":103,"column":null}}]},"11":{"loc":{"start":{"line":116,"column":2},"end":{"line":118,"column":null}},"type":"if","locations":[{"start":{"line":116,"column":2},"end":{"line":118,"column":null}},{"start":{"line":116,"column":2},"end":{"line":118,"column":null}}]}},"s":{"0":0,"1":0,"2":0,"3":0,"4":0,"5":0,"6":0,"7":0,"8":0,"9":0,"10":0,"11":0,"12":0,"13":0,"14":0,"15":0,"16":0,"17":0,"18":0,"19":0,"20":0,"21":0,"22":0,"23":0,"24":0,"25":0,"26":0,"27":0,"28":0,"29":0,"30":0},"f":{"0":0,"1":0,"2":0,"3":0},"b":{"0":[0,0],"1":[0,0],"2":[0,0],"3":[0,0],"4":[0,0],"5":[0,0],"6":[0,0],"7":[0,0],"8":[0,0],"9":[0],"10":[0,0],"11":[0,0]}}
+,"/Users/e-liang/a/tscodegen/src/index.ts": {"path":"/Users/e-liang/a/tscodegen/src/index.ts","statementMap":{"0":{"start":{"line":1,"column":0},"end":{"line":1,"column":27}},"1":{"start":{"line":2,"column":0},"end":{"line":2,"column":30}},"2":{"start":{"line":3,"column":0},"end":{"line":3,"column":41}}},"fnMap":{},"branchMap":{},"s":{"0":0,"1":0,"2":0},"f":{},"b":{}}
+,"/Users/e-liang/a/tscodegen/src/sections/docblock.ts": {"path":"/Users/e-liang/a/tscodegen/src/sections/docblock.ts","statementMap":{"0":{"start":{"line":1,"column":28},"end":{"line":1,"column":70}},"1":{"start":{"line":13,"column":30},"end":{"line":13,"column":71}},"2":{"start":{"line":14,"column":2},"end":{"line":16,"column":null}},"3":{"start":{"line":15,"column":4},"end":{"line":15,"column":21}},"4":{"start":{"line":18,"column":22},"end":{"line":18,"column":53}},"5":{"start":{"line":19,"column":2},"end":{"line":27,"column":4}},"6":{"start":{"line":23,"column":21},"end":{"line":23,"column":55}},"7":{"start":{"line":12,"column":0},"end":{"line":12,"column":16}},"8":{"start":{"line":39,"column":2},"end":{"line":41,"column":null}},"9":{"start":{"line":40,"column":4},"end":{"line":40,"column":16}},"10":{"start":{"line":42,"column":2},"end":{"line":42,"column":47}},"11":{"start":{"line":38,"column":0},"end":{"line":38,"column":16}},"12":{"start":{"line":51,"column":42},"end":{"line":54,"column":15}},"13":{"start":{"line":53,"column":19},"end":{"line":53,"column":43}},"14":{"start":{"line":55,"column":19},"end":{"line":55,"column":65}},"15":{"start":{"line":56,"column":2},"end":{"line":56,"column":18}},"16":{"start":{"line":50,"column":0},"end":{"line":50,"column":16}},"17":{"start":{"line":70,"column":2},"end":{"line":70,"column":69}},"18":{"start":{"line":66,"column":0},"end":{"line":66,"column":16}}},"fnMap":{"0":{"name":"getFileDocblock","decl":{"start":{"line":12,"column":16},"end":{"line":12,"column":31}},"loc":{"start":{"line":12,"column":44},"end":{"line":28,"column":1}}},"1":{"name":"(anonymous_1)","decl":{"start":{"line":23,"column":11},"end":{"line":23,"column":12}},"loc":{"start":{"line":23,"column":21},"end":{"line":23,"column":55}}},"2":{"name":"removeFileDocblock","decl":{"start":{"line":38,"column":16},"end":{"line":38,"column":34}},"loc":{"start":{"line":38,"column":47},"end":{"line":43,"column":1}}},"3":{"name":"createDocblock","decl":{"start":{"line":50,"column":16},"end":{"line":50,"column":30}},"loc":{"start":{"line":50,"column":54},"end":{"line":57,"column":1}}},"4":{"name":"(anonymous_4)","decl":{"start":{"line":53,"column":9},"end":{"line":53,"column":10}},"loc":{"start":{"line":53,"column":19},"end":{"line":53,"column":43}}},"5":{"name":"prependFileDocblock","decl":{"start":{"line":66,"column":16},"end":{"line":66,"column":35}},"loc":{"start":{"line":68,"column":25},"end":{"line":71,"column":1}}}},"branchMap":{"0":{"loc":{"start":{"line":13,"column":63},"end":{"line":13,"column":65}},"type":"cond-expr","locations":[{"start":{"line":13,"column":63},"end":{"line":13,"column":65}},{"start":{"line":13,"column":63},"end":{"line":13,"column":71}}]},"1":{"loc":{"start":{"line":13,"column":30},"end":{"line":13,"column":65}},"type":"binary-expr","locations":[{"start":{"line":13,"column":30},"end":{"line":13,"column":65}},{"start":{"line":13,"column":63},"end":{"line":13,"column":65}}]},"2":{"loc":{"start":{"line":14,"column":2},"end":{"line":16,"column":null}},"type":"if","locations":[{"start":{"line":14,"column":2},"end":{"line":16,"column":null}},{"start":{"line":14,"column":2},"end":{"line":16,"column":null}}]},"3":{"loc":{"start":{"line":39,"column":2},"end":{"line":41,"column":null}},"type":"if","locations":[{"start":{"line":39,"column":2},"end":{"line":41,"column":null}},{"start":{"line":39,"column":2},"end":{"line":41,"column":null}}]}},"s":{"0":0,"1":0,"2":0,"3":0,"4":0,"5":0,"6":0,"7":0,"8":0,"9":0,"10":0,"11":0,"12":0,"13":0,"14":0,"15":0,"16":0,"17":0,"18":0},"f":{"0":0,"1":0,"2":0,"3":0,"4":0,"5":0},"b":{"0":[0,0],"1":[0,0],"2":[0,0],"3":[0,0]}}
+,"/Users/e-liang/a/tscodegen/src/sections/manual.ts": {"path":"/Users/e-liang/a/tscodegen/src/sections/manual.ts","statementMap":{"0":{"start":{"line":4,"column":2},"end":{"line":4,"column":94}},"1":{"start":{"line":11,"column":2},"end":{"line":15,"column":null}},"2":{"start":{"line":12,"column":4},"end":{"line":14,"column":6}},"3":{"start":{"line":17,"column":29},"end":{"line":17,"column":47}},"4":{"start":{"line":18,"column":2},"end":{"line":19,"column":71}},"5":{"start":{"line":21,"column":2},"end":{"line":21,"column":101}},"6":{"start":{"line":6,"column":0},"end":{"line":6,"column":16}},"7":{"start":{"line":25,"column":21},"end":{"line":25,"column":54}},"8":{"start":{"line":26,"column":43},"end":{"line":26,"column":45}},"9":{"start":{"line":27,"column":2},"end":{"line":32,"column":5}},"10":{"start":{"line":28,"column":4},"end":{"line":30,"column":null}},"11":{"start":{"line":29,"column":6},"end":{"line":29,"column":13}},"12":{"start":{"line":31,"column":4},"end":{"line":31,"column":64}},"13":{"start":{"line":33,"column":2},"end":{"line":33,"column":24}},"14":{"start":{"line":24,"column":0},"end":{"line":24,"column":16}},"15":{"start":{"line":42,"column":2},"end":{"line":44,"column":4}},"16":{"start":{"line":43,"column":4},"end":{"line":43,"column":39}},"17":{"start":{"line":41,"column":0},"end":{"line":41,"column":16}}},"fnMap":{"0":{"name":"createManualSection","decl":{"start":{"line":6,"column":16},"end":{"line":6,"column":35}},"loc":{"start":{"line":8,"column":21},"end":{"line":22,"column":1}}},"1":{"name":"extractManualSections","decl":{"start":{"line":24,"column":16},"end":{"line":24,"column":37}},"loc":{"start":{"line":24,"column":50},"end":{"line":34,"column":1}}},"2":{"name":"(anonymous_2)","decl":{"start":{"line":27,"column":26},"end":{"line":27,"column":27}},"loc":{"start":{"line":27,"column":54},"end":{"line":32,"column":3}}},"3":{"name":"emptyManualSections","decl":{"start":{"line":41,"column":16},"end":{"line":41,"column":35}},"loc":{"start":{"line":41,"column":48},"end":{"line":45,"column":1}}},"4":{"name":"(anonymous_4)","decl":{"start":{"line":42,"column":42},"end":{"line":42,"column":43}},"loc":{"start":{"line":43,"column":4},"end":{"line":43,"column":39}}}},"branchMap":{"0":{"loc":{"start":{"line":11,"column":2},"end":{"line":15,"column":null}},"type":"if","locations":[{"start":{"line":11,"column":2},"end":{"line":15,"column":null}},{"start":{"line":11,"column":2},"end":{"line":15,"column":null}}]},"1":{"loc":{"start":{"line":11,"column":6},"end":{"line":11,"column":29}},"type":"binary-expr","locations":[{"start":{"line":11,"column":6},"end":{"line":11,"column":29}},{"start":{"line":11,"column":33},"end":{"line":11,"column":54}}]},"2":{"loc":{"start":{"line":19,"column":38},"end":{"line":19,"column":65}},"type":"cond-expr","locations":[{"start":{"line":19,"column":38},"end":{"line":19,"column":65}},{"start":{"line":19,"column":68},"end":{"line":19,"column":70}}]},"3":{"loc":{"start":{"line":28,"column":4},"end":{"line":30,"column":null}},"type":"if","locations":[{"start":{"line":28,"column":4},"end":{"line":30,"column":null}},{"start":{"line":28,"column":4},"end":{"line":30,"column":null}}]}},"s":{"0":0,"1":0,"2":0,"3":0,"4":0,"5":0,"6":0,"7":0,"8":0,"9":0,"10":0,"11":0,"12":0,"13":0,"14":0,"15":0,"16":0,"17":0},"f":{"0":0,"1":0,"2":0,"3":0,"4":0},"b":{"0":[0,0],"1":[0,0],"2":[0,0],"3":[0,0]}}
+}

package/dist/CodeBuilder.d.ts

@@ -36,8 +36,11 @@ export declare class CodeBuilder {
     addManualSection(sectionKey: string, sectionBuilder: (manualSectionBuilder: CodeBuilder) => CodeBuilder): this;
     /**
      * Formats the stored code with Prettier.
+     *
+     * @param prettierOptions Optional Prettier configuration object. If provided,
+     *   this will be used directly and no config will be resolved from disk.
      */
-    format(): this;
+    format(prettierOptions?: import("prettier").Options): this;
     /**
      * Returns the stored code.
      */

package/dist/CodeBuilder.js

@@ -1,45 +1,43 @@
 "use strict";
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, privateMap, value) {
-    if (!privateMap.has(receiver)) {
-        throw new TypeError("attempted to set private field on non-instance");
-    }
-    privateMap.set(receiver, value);
-    return value;
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
 };
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, privateMap) {
-    if (!privateMap.has(receiver)) {
-        throw new TypeError("attempted to get private field on non-instance");
-    }
-    return privateMap.get(receiver);
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
-var _gennedCode, _hasManualSections, _existingManualSections;
+var _CodeBuilder_gennedCode, _CodeBuilder_hasManualSections, _CodeBuilder_existingManualSections;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CodeBuilder = void 0;
-const prettier_1 = __importDefault(require("prettier"));
+const sync_1 = __importDefault(require("@prettier/sync"));
 const manual_1 = require("./sections/manual");
 const docblock_1 = require("./sections/docblock");
 class CodeBuilder {
     constructor(manualSections) {
-        _gennedCode.set(this, "");
-        _hasManualSections.set(this, false);
-        _existingManualSections.set(this, void 0);
-        __classPrivateFieldSet(this, _existingManualSections, manualSections);
+        _CodeBuilder_gennedCode.set(this, "");
+        _CodeBuilder_hasManualSections.set(this, false);
+        _CodeBuilder_existingManualSections.set(this, void 0);
+        __classPrivateFieldSet(this, _CodeBuilder_existingManualSections, manualSections, "f");
     }
     /**
      * Simply appends `code`.
      */
     add(code) {
-        __classPrivateFieldSet(this, _gennedCode, __classPrivateFieldGet(this, _gennedCode) + code);
+        __classPrivateFieldSet(this, _CodeBuilder_gennedCode, __classPrivateFieldGet(this, _CodeBuilder_gennedCode, "f") + code, "f");
         return this;
     }
     /**
      * Appends `code` and a newline. Call without arguments to insert a newline.
      */
     addLine(code = "") {
-        __classPrivateFieldSet(this, _gennedCode, __classPrivateFieldGet(this, _gennedCode) + (code + "\n"));
+        __classPrivateFieldSet(this, _CodeBuilder_gennedCode, __classPrivateFieldGet(this, _CodeBuilder_gennedCode, "f") + (code + "\n"), "f");
         return this;
     }
     /**
@@ -49,7 +47,7 @@ class CodeBuilder {
      * @param docblockContent Plain docblock content (i.e. without "*"s at the start of each line)
      */
     addDocblock(docblockContent) {
-        return this.addLine(docblock_1.createDocblock(docblockContent));
+        return this.addLine((0, docblock_1.createDocblock)(docblockContent));
     }
     /**
      * Add a block of code, i.e. code with braces around them.
@@ -59,8 +57,8 @@ class CodeBuilder {
      * in the block.
      */
     addBlock(codeBeforeBlock, blockBuilder) {
-        const builtBlockBuilder = blockBuilder(new CodeBuilder(__classPrivateFieldGet(this, _existingManualSections)));
-        __classPrivateFieldSet(this, _hasManualSections, __classPrivateFieldGet(this, _hasManualSections) || builtBlockBuilder.hasManualSections());
+        const builtBlockBuilder = blockBuilder(new CodeBuilder(__classPrivateFieldGet(this, _CodeBuilder_existingManualSections, "f")));
+        __classPrivateFieldSet(this, _CodeBuilder_hasManualSections, __classPrivateFieldGet(this, _CodeBuilder_hasManualSections, "f") || builtBlockBuilder.hasManualSections(), "f");
         return this.add(codeBeforeBlock)
             .addLine(" {")
             .addLine(builtBlockBuilder.toString())
@@ -76,35 +74,45 @@ class CodeBuilder {
      */
     addManualSection(sectionKey, sectionBuilder) {
         let sectionContent;
-        if (__classPrivateFieldGet(this, _existingManualSections)[sectionKey]) {
-            sectionContent = __classPrivateFieldGet(this, _existingManualSections)[sectionKey];
+        if (__classPrivateFieldGet(this, _CodeBuilder_existingManualSections, "f")[sectionKey]) {
+            sectionContent = __classPrivateFieldGet(this, _CodeBuilder_existingManualSections, "f")[sectionKey];
         }
         else {
-            sectionContent = sectionBuilder(new CodeBuilder(__classPrivateFieldGet(this, _existingManualSections))).toString();
+            sectionContent = sectionBuilder(new CodeBuilder(__classPrivateFieldGet(this, _CodeBuilder_existingManualSections, "f"))).toString();
         }
-        __classPrivateFieldSet(this, _hasManualSections, true);
-        return this.addLine(manual_1.createManualSection(sectionKey, sectionContent));
+        __classPrivateFieldSet(this, _CodeBuilder_hasManualSections, true, "f");
+        return this.addLine((0, manual_1.createManualSection)(sectionKey, sectionContent));
     }
     /**
      * Formats the stored code with Prettier.
+     *
+     * @param prettierOptions Optional Prettier configuration object. If provided,
+     *   this will be used directly and no config will be resolved from disk.
      */
-    format() {
-        const prettierOptions = prettier_1.default.resolveConfig.sync(process.cwd());
-        __classPrivateFieldSet(this, _gennedCode, prettier_1.default.format(__classPrivateFieldGet(this, _gennedCode), Object.assign(Object.assign({}, (prettierOptions !== null && prettierOptions !== void 0 ? prettierOptions : {})), { parser: "typescript" })));
+    format(prettierOptions) {
+        var _a;
+        let options = prettierOptions;
+        if (!options) {
+            options = (_a = sync_1.default.resolveConfig(process.cwd())) !== null && _a !== void 0 ? _a : {};
+        }
+        __classPrivateFieldSet(this, _CodeBuilder_gennedCode, sync_1.default.format(__classPrivateFieldGet(this, _CodeBuilder_gennedCode, "f"), {
+            ...options,
+            parser: "typescript",
+        }), "f");
         return this;
     }
     /**
      * Returns the stored code.
      */
     toString() {
-        return __classPrivateFieldGet(this, _gennedCode);
+        return __classPrivateFieldGet(this, _CodeBuilder_gennedCode, "f");
     }
     /**
      * Whether this built code contains at least one manual section.
      */
     hasManualSections() {
-        return __classPrivateFieldGet(this, _hasManualSections);
+        return __classPrivateFieldGet(this, _CodeBuilder_hasManualSections, "f");
     }
 }
 exports.CodeBuilder = CodeBuilder;
-_gennedCode = new WeakMap(), _hasManualSections = new WeakMap(), _existingManualSections = new WeakMap();
+_CodeBuilder_gennedCode = new WeakMap(), _CodeBuilder_hasManualSections = new WeakMap(), _CodeBuilder_existingManualSections = new WeakMap();

package/dist/CodeFile.d.ts

@@ -16,6 +16,16 @@ export declare class CodeFile {
      * @param builderBuilder A builder that builds a replacement source.
      */
     build(builderBuilder: (builder: CodeBuilder) => CodeBuilder): this;
+    /**
+     * Prepend a codelock docblock to the file.
+     *
+     * Recommended to be called after `build`.
+     *
+     * NOTE: This will prepend a docblock even if the file already has one.
+     *
+     * @param customComment Comment to be interpolated into the lock docblock.
+     */
+    lock(customComment?: string): this;
     /**
      * Returns the in-memory representation of the file's source code.
      */

package/dist/CodeFile.js

@@ -1,21 +1,19 @@
 "use strict";
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, privateMap, value) {
-    if (!privateMap.has(receiver)) {
-        throw new TypeError("attempted to set private field on non-instance");
-    }
-    privateMap.set(receiver, value);
-    return value;
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
 };
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, privateMap) {
-    if (!privateMap.has(receiver)) {
-        throw new TypeError("attempted to get private field on non-instance");
-    }
-    return privateMap.get(receiver);
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
-var _sourceFilePath, _fileContents, _hasPendingChanges;
+var _CodeFile_sourceFilePath, _CodeFile_originalFileContents, _CodeFile_fileContents, _CodeFile_manualSectionsAllowed;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CodeFile = void 0;
 const fs_1 = __importDefault(require("fs"));
@@ -27,19 +25,23 @@ const manual_1 = require("./sections/manual");
  */
 class CodeFile {
     constructor(sourceFilePath) {
-        _sourceFilePath.set(this, void 0);
-        _fileContents.set(this, "");
-        _hasPendingChanges.set(this, false);
-        __classPrivateFieldSet(this, _sourceFilePath, sourceFilePath);
+        var _a;
+        _CodeFile_sourceFilePath.set(this, void 0);
+        _CodeFile_originalFileContents.set(this, "");
+        _CodeFile_fileContents.set(this, "");
+        _CodeFile_manualSectionsAllowed.set(this, void 0);
+        __classPrivateFieldSet(this, _CodeFile_sourceFilePath, sourceFilePath, "f");
         if (fs_1.default.existsSync(sourceFilePath)) {
-            __classPrivateFieldSet(this, _fileContents, fs_1.default.readFileSync(sourceFilePath, "utf-8"));
+            __classPrivateFieldSet(this, _CodeFile_originalFileContents, fs_1.default.readFileSync(sourceFilePath, "utf-8"), "f");
+            __classPrivateFieldSet(this, _CodeFile_fileContents, __classPrivateFieldGet(this, _CodeFile_originalFileContents, "f"), "f");
+            __classPrivateFieldSet(this, _CodeFile_manualSectionsAllowed, (_a = (0, codelock_1.getCodelockInfo)(__classPrivateFieldGet(this, _CodeFile_fileContents, "f"))) === null || _a === void 0 ? void 0 : _a.manualSectionsAllowed, "f");
         }
     }
     /**
      * Verifies that the codelock in the generated file is present and valid.
      */
     verify() {
-        return codelock_1.verifyLock(__classPrivateFieldGet(this, _fileContents));
+        return (0, codelock_1.verifyLock)(__classPrivateFieldGet(this, _CodeFile_fileContents, "f"));
     }
     /**
      * Replace the file's code (this class's in-memory representation at least)
@@ -48,18 +50,30 @@ class CodeFile {
      * @param builderBuilder A builder that builds a replacement source.
      */
     build(builderBuilder) {
-        const builder = builderBuilder(new CodeBuilder_1.CodeBuilder(manual_1.extractManualSections(__classPrivateFieldGet(this, _fileContents))));
-        const builtCode = builder.toString();
-        const oldFileContents = __classPrivateFieldGet(this, _fileContents);
-        __classPrivateFieldSet(this, _fileContents, codelock_1.lockCode(builtCode, builder.hasManualSections()));
-        __classPrivateFieldSet(this, _hasPendingChanges, oldFileContents !== __classPrivateFieldGet(this, _fileContents));
+        const builder = builderBuilder(new CodeBuilder_1.CodeBuilder((0, manual_1.extractManualSections)(__classPrivateFieldGet(this, _CodeFile_fileContents, "f"))));
+        __classPrivateFieldSet(this, _CodeFile_fileContents, builder.toString(), "f");
+        __classPrivateFieldSet(this, _CodeFile_manualSectionsAllowed, builder.hasManualSections(), "f");
+        return this;
+    }
+    /**
+     * Prepend a codelock docblock to the file.
+     *
+     * Recommended to be called after `build`.
+     *
+     * NOTE: This will prepend a docblock even if the file already has one.
+     *
+     * @param customComment Comment to be interpolated into the lock docblock.
+     */
+    lock(customComment = "") {
+        var _a;
+        __classPrivateFieldSet(this, _CodeFile_fileContents, (0, codelock_1.lockCode)(__classPrivateFieldGet(this, _CodeFile_fileContents, "f"), (_a = __classPrivateFieldGet(this, _CodeFile_manualSectionsAllowed, "f")) !== null && _a !== void 0 ? _a : false, customComment), "f");
         return this;
     }
     /**
      * Returns the in-memory representation of the file's source code.
      */
     toString() {
-        return __classPrivateFieldGet(this, _fileContents);
+        return __classPrivateFieldGet(this, _CodeFile_fileContents, "f");
     }
     /**
      * Save to `sourceFilePath` if the in-memory representation of the code has
@@ -69,11 +83,11 @@ class CodeFile {
      * changes.
      */
     saveToFile(force = false) {
-        if (force || __classPrivateFieldGet(this, _hasPendingChanges)) {
-            fs_1.default.writeFileSync(__classPrivateFieldGet(this, _sourceFilePath), __classPrivateFieldGet(this, _fileContents), "utf-8");
-            __classPrivateFieldSet(this, _hasPendingChanges, false);
+        if (force || __classPrivateFieldGet(this, _CodeFile_originalFileContents, "f") !== __classPrivateFieldGet(this, _CodeFile_fileContents, "f")) {
+            fs_1.default.writeFileSync(__classPrivateFieldGet(this, _CodeFile_sourceFilePath, "f"), __classPrivateFieldGet(this, _CodeFile_fileContents, "f"), "utf-8");
+            __classPrivateFieldSet(this, _CodeFile_originalFileContents, __classPrivateFieldGet(this, _CodeFile_fileContents, "f"), "f");
         }
     }
 }
 exports.CodeFile = CodeFile;
-_sourceFilePath = new WeakMap(), _fileContents = new WeakMap(), _hasPendingChanges = new WeakMap();
+_CodeFile_sourceFilePath = new WeakMap(), _CodeFile_originalFileContents = new WeakMap(), _CodeFile_fileContents = new WeakMap(), _CodeFile_manualSectionsAllowed = new WeakMap();

package/dist/codelock.d.ts

@@ -15,9 +15,10 @@ export declare function getCodelockInfo(lockedCode: string): CodelockInfo | unde
  *
  * @param code Code to be locked.
  * @param manualSectionsAllowed Whether generated code can contain manual sections.
+ * @param customContent A custom comment to insert into the docblock.
  * @returns Locked code, i.e. code with prepended codelock file docblock.
  */
-export declare function lockCode(code: string, manualSectionsAllowed: boolean): string;
+export declare function lockCode(code: string, manualSectionsAllowed: boolean, customContent?: string): string;
 /**
  * Verify that the codelock in the source file is valid.
  *

package/dist/codelock.js

@@ -3,7 +3,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.verifyLock = exports.lockCode = exports.getCodelockInfo = void 0;
+exports.getCodelockInfo = getCodelockInfo;
+exports.lockCode = lockCode;
+exports.verifyLock = verifyLock;
 const crypto_1 = __importDefault(require("crypto"));
 const docblock_1 = require("./sections/docblock");
 const manual_1 = require("./sections/manual");
@@ -15,7 +17,7 @@ const manual_1 = require("./sections/manual");
 function getCodelockInfo(lockedCode) {
     var _a, _b;
     // TODO: get docblock, and if it exists, retrieve hash
-    const docblock = docblock_1.getFileDocblock(lockedCode);
+    const docblock = (0, docblock_1.getFileDocblock)(lockedCode);
     if (!docblock) {
         return undefined;
     }
@@ -41,7 +43,6 @@ function getCodelockInfo(lockedCode) {
     }
     return undefined;
 }
-exports.getCodelockInfo = getCodelockInfo;
 /**
  * Computes the codelock hash for a source file. Will not unlock if locked.
  *
@@ -51,9 +52,7 @@ exports.getCodelockInfo = getCodelockInfo;
  * @returns Lock hash for `code`.
  */
 function computeHash(code, shouldEmptyManualSections) {
-    const hashableCode = (shouldEmptyManualSections
-        ? manual_1.emptyManualSections(code)
-        : code).trim();
+    const hashableCode = (shouldEmptyManualSections ? (0, manual_1.emptyManualSections)(code) : code).trim();
     return crypto_1.default
         .createHash("shake128", { outputLength: 24 })
         .update(hashableCode)
@@ -66,26 +65,26 @@ function computeHash(code, shouldEmptyManualSections) {
  *
  * @param code Code to be locked.
  * @param manualSectionsAllowed Whether generated code can contain manual sections.
+ * @param customContent A custom comment to insert into the docblock.
  * @returns Locked code, i.e. code with prepended codelock file docblock.
  */
-function lockCode(code, manualSectionsAllowed) {
+function lockCode(code, manualSectionsAllowed, customContent = "") {
     const hash = computeHash(code, manualSectionsAllowed);
     let docblockContent;
     if (manualSectionsAllowed) {
         docblockContent = `This file is generated with manually editable sections. Only make
 modifications between BEGIN MANUAL SECTION and END MANUAL SECTION
 designators.
-
+${customContent}
 @generated-editable Codelock<<${hash}>>`;
     }
     else {
         docblockContent = `This file is generated. Do not modify it manually.
-
+${customContent}
 @generated Codelock<<${hash}>>`;
     }
-    return docblock_1.prependFileDocblock(code, docblockContent);
+    return (0, docblock_1.prependFileDocblock)(code, docblockContent);
 }
-exports.lockCode = lockCode;
 /**
  * Verify that the codelock in the source file is valid.
  *
@@ -98,6 +97,5 @@ function verifyLock(lockedCode) {
         return false;
     }
     return (codeblockInfo.hash ===
-        computeHash(docblock_1.removeFileDocblock(lockedCode), codeblockInfo.manualSectionsAllowed));
+        computeHash((0, docblock_1.removeFileDocblock)(lockedCode), codeblockInfo.manualSectionsAllowed));
 }
-exports.verifyLock = verifyLock;

package/dist/index.js

@@ -1,13 +1,17 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
 }));
 var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !exports.hasOwnProperty(p)) __createBinding(exports, m, p);
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./CodeFile"), exports);

package/dist/sections/docblock.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.prependFileDocblock = exports.createDocblock = exports.removeFileDocblock = exports.getFileDocblock = void 0;
+exports.getFileDocblock = getFileDocblock;
+exports.removeFileDocblock = removeFileDocblock;
+exports.createDocblock = createDocblock;
+exports.prependFileDocblock = prependFileDocblock;
 const docblockMatchRegExp = /^\/\*\*\n(?<contents>( \*.*\n)*?) \*\/\n/;
 /**
  * Get file docblock from `code`, the contents of a source file.
@@ -26,7 +29,6 @@ function getFileDocblock(code) {
         // Remove trailing \n
         .trim());
 }
-exports.getFileDocblock = getFileDocblock;
 /**
  * Removes the file docblock from the start of a file.
  *
@@ -41,7 +43,6 @@ function removeFileDocblock(code) {
     }
     return code.replace(docblockMatchRegExp, "");
 }
-exports.removeFileDocblock = removeFileDocblock;
 /**
  * Creates a docblock from `docblockContent`.
  *
@@ -55,7 +56,6 @@ function createDocblock(docblockContent) {
     const docblock = `/**\n${docblockContentWithLeadingStars}\n */`;
     return docblock;
 }
-exports.createDocblock = createDocblock;
 /**
  * Prepends `code` with `docblockContent`. Assumes `code` does not already have
  * a file docblock.
@@ -66,4 +66,3 @@ exports.createDocblock = createDocblock;
 function prependFileDocblock(code, docblockContent) {
     return `${createDocblock(docblockContent)}\n\n${code.trimStart()}`;
 }
-exports.prependFileDocblock = prependFileDocblock;

package/dist/sections/manual.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.emptyManualSections = exports.extractManualSections = exports.createManualSection = void 0;
+exports.createManualSection = createManualSection;
+exports.extractManualSections = extractManualSections;
+exports.emptyManualSections = emptyManualSections;
 const sectionMatchRegExp = /\/\* BEGIN MANUAL SECTION (?<key>\S+) \*\/(?<code>(.|\n)+?|)\/\* END MANUAL SECTION \*\//gm;
 function createManualSection(sectionKey, sectionCode) {
     // Ensure section key is non-empty and contains no whitespaces
@@ -12,7 +14,6 @@ function createManualSection(sectionKey, sectionCode) {
         processedSectionCode.length > 0 ? `${processedSectionCode}\n` : "";
     return `/* BEGIN MANUAL SECTION ${sectionKey} */\n${processedSectionCode}/* END MANUAL SECTION */`;
 }
-exports.createManualSection = createManualSection;
 function extractManualSections(code) {
     const allMatches = code.matchAll(sectionMatchRegExp);
     const manualSections = {};
@@ -24,7 +25,6 @@ function extractManualSections(code) {
     });
     return manualSections;
 }
-exports.extractManualSections = extractManualSections;
 /**
  * Removes all code between manual section designators.
  *
@@ -33,4 +33,3 @@ exports.extractManualSections = extractManualSections;
 function emptyManualSections(code) {
     return code.replace(sectionMatchRegExp, (matchedString, sectionKey) => createManualSection(sectionKey, ""));
 }
-exports.emptyManualSections = emptyManualSections;

package/dist/types/ManualSectionMap.d.ts

@@ -1,3 +1,3 @@
-export declare type ManualSectionMap = {
+export type ManualSectionMap = {
     [sectionKey: string]: string;
 };

package/eslint.config.mjs

@@ -0,0 +1,49 @@
+import { defineConfig } from "eslint/config";
+import typescriptEslint from "@typescript-eslint/eslint-plugin";
+import jest from "eslint-plugin-jest";
+import prettier from "eslint-plugin-prettier";
+import globals from "globals";
+import tsParser from "@typescript-eslint/parser";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import js from "@eslint/js";
+import { FlatCompat } from "@eslint/eslintrc";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const compat = new FlatCompat({
+  baseDirectory: __dirname,
+  recommendedConfig: js.configs.recommended,
+  allConfig: js.configs.all,
+});
+
+export default defineConfig([
+  {
+    extends: compat.extends(
+      "eslint:recommended",
+      "plugin:@typescript-eslint/recommended",
+      "plugin:jest/recommended",
+      "plugin:jest/style",
+      "plugin:prettier/recommended",
+    ),
+
+    plugins: {
+      "@typescript-eslint": typescriptEslint,
+      jest,
+      prettier,
+    },
+
+    languageOptions: {
+      globals: {
+        ...globals.node,
+      },
+
+      parser: tsParser,
+    },
+
+    rules: {
+      "prettier/prettier": "error",
+      "jest/valid-title": ["error", { ignoreTypeOfDescribeName: true }],
+    },
+  },
+]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elg/tscodegen",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "TypeScript string-based code generation tool, with hashed files and manually editable sections",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -14,32 +14,39 @@
     "clean": "rm -rf dist",
     "build": "tsc --project tsconfig.dist.json",
     "typecheck": "tsc --noEmit",
-    "test": "jest",
+    "test": "jest --coverage",
     "lint": "yarn lint:code && yarn lint:misc",
-    "lint:code": "eslint .",
-    "lint:code:fix": "eslint . --fix",
-    "lint:misc:base": "prettier './*.{js,json,md}'",
-    "lint:misc": "yarn lint:misc:base --check",
-    "lint:misc:fix": "yarn lint:misc:base --write",
+    "lint:code": "eslint src ./*.js ./*.mjs",
+    "lint:code:fix": "yarn lint:code --fix",
+    "lint:misc": "prettier --check './*.{js,mjs,json,md}'",
+    "lint:misc:fix": "yarn lint:misc --write",
     "prepare": "yarn clean && yarn build"
   },
+  "dependencies": {
+    "@prettier/sync": "^0.6.1"
+  },
   "peerDependencies": {
-    "prettier": "2.x"
+    "prettier": "3.x"
   },
   "devDependencies": {
-    "@types/jest": "^25.2.3",
-    "@types/mock-fs": "^4.10.0",
-    "@typescript-eslint/eslint-plugin": "^3.0.2",
-    "@typescript-eslint/parser": "^3.0.2",
-    "eslint": "^7.1.0",
-    "eslint-config-prettier": "^6.11.0",
-    "eslint-plugin-jest": "^23.13.2",
-    "eslint-plugin-prettier": "^3.1.3",
-    "jest": "^26.0.1",
-    "mock-fs": "^4.12.0",
-    "prettier": "^2.0.5",
-    "ts-jest": "^26.0.0",
-    "typescript": "^3.9.3"
+    "@eslint/eslintrc": "^3.3.4",
+    "@eslint/js": "^10.0.1",
+    "@types/jest": "^30.0.0",
+    "@types/mock-fs": "^4.13.4",
+    "@typescript-eslint/eslint-plugin": "^8.56.1",
+    "@typescript-eslint/parser": "^8.56.1",
+    "codecov": "^3.8.3",
+    "eslint": "^10.0.2",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-jest": "^29.15.0",
+    "eslint-plugin-prettier": "^5.5.5",
+    "globals": "^17.4.0",
+    "jest": "^30.2.0",
+    "jest-junit": "^16.0.0",
+    "mock-fs": "^5.5.0",
+    "prettier": "^3.8.1",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.9.3"
   },
   "keywords": [
     "codegen",

package/test-reports/junit/junit.xml

@@ -0,0 +1,3 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<testsuites name="jest tests" tests="0" failures="0" time="0.844">
+</testsuites>