Reorganize monorepo scripts

Author: necolas

package-lock.json

@@ -11,7 +11,8 @@
     "prettier": "prettier --write \"**/*.js\" \"**/*.ts\"",
     "prettier:report": "prettier --check \"**/*.js\"",
     "lint": "npm run lint:report -- --fix",
-    "lint:report": "eslint",
+    "lint:report": "eslint packages tools",
+    "release": "tools/npm/release.js",
     "test:packages": "npm run test --workspaces --if-present",
     "test": "npm run build && npm run flow && npm run test:packages && npm run prettier:report && npm run lint:report"
   },
@@ -38,7 +39,7 @@
     "prettier": "^3.5.0",
     "prettier-plugin-hermes-parser": "^0.26.0",
     "rimraf": "^5.0.10",
-    "typescript": "^5.3.3"
+    "yargs": "17.7.2"
   },
   "prettier": {
     "singleQuote": true,

package.json

@@ -27,7 +27,7 @@
     "yargs": "^17.7.2"
   },
   "devDependencies": {
-    "@stylexjs/scripts": "0.11.1"
+    "scripts": "0.11.1"
   },
   "bin": {
     "stylex": "./lib/index.js"

packages/cli/package.json

@@ -1,37 +1,3 @@
-# @stylexjs/scripts
+# scripts
 
-Private scripts used by the monorepo.
-
-## How to create a release
-
-The release script (run from the monorepo root) must be used to create and publish releases.
-
-```shell
-npm run release
-  # workspace
-  -w @stylexjs/scripts --
-  # package version (required)
-  --pkg-version 0.10.2
-  # creates git commit and tag
-  --commit
-  # publishes to npm using 2fa
-  --publish --otp 123456
-```
-
-You can perform a dry run by only specifying the new version for a release:
-
-```shell
-npm run release -w @stylexjs/scripts -- --pkg-version 0.10.2
-```
-
-To commit and tag the release:
-
-```shell
-npm run release -w @stylexjs/scripts -- --pkg-version 0.10.2 --commit
-```
-
-To publish the release:
-
-```shell
-npm run release -w @stylexjs/scripts -- --pkg-version 0.10.2 --publish
-```
+Private CLI scripts that can be installed and used by packages within the monorepo as part of their dev and build processes.

packages/scripts/README.md

@@ -9,19 +9,15 @@
  */
 
 const fsPromises = require('fs/promises');
-const monorepoPackage = require('../../package.json');
+const monorepoPackage = require('../../../package.json');
 const path = require('path');
 const translate = require('flow-api-translator');
+const utils = require('./flow-module-utils');
 const yargs = require('yargs/yargs');
 
-const {
-  findFlowModules,
-  patchFlowModulePaths,
-} = require('./handle-flow-modules');
-
 async function generateTypes(inputDir, outputDir, rootDir) {
   const rootPath = rootDir ?? path.resolve(inputDir, '../');
-  const flowModules = await findFlowModules(inputDir, rootPath);
+  const flowModules = await utils.findFlowModules(inputDir, rootPath);
 
   await fsPromises.mkdir(outputDir, { recursive: true });
   let dirents = await fsPromises.readdir(inputDir, { withFileTypes: true });
@@ -85,7 +81,7 @@ async function generateTypes(inputDir, outputDir, rootDir) {
 
           await fsPromises.writeFile(
             `${outputFullPath}.flow`,
-            patchFlowModulePaths(
+            utils.patchFlowModulePaths(
               outputFullPath,
               outputFlowContents,
               flowModules,

packages/scripts/handle-flow-modules.js packages/scripts/flow-translator/flow-module-utils.js

@@ -5,7 +5,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * @flow
+ *
  */
 
 const fs = require('fs').promises;

packages/scripts/gen-types.js packages/scripts/flow-translator/generate-types.js

@@ -1,15 +1,12 @@
 {
   "private": true,
-  "name": "@stylexjs/scripts",
+  "name": "scripts",
   "version": "0.11.1",
   "description": "Helper scripts for stylex monorepo.",
   "license": "MIT",
   "bin": {
-    "gen-types": "./gen-types.js",
-    "rewrite-imports": "./rewrite-imports.js"
-  },
-  "scripts": {
-    "release": "./create-release.js"
+    "gen-types": "./flow-translator/generate-types.js",
+    "rewrite-imports": "./flow-translator/rewrite-imports.js"
   },
   "dependencies": {
     "flow-api-translator": "0.26.0",

packages/scripts/rewrite-imports.js packages/scripts/flow-translator/rewrite-imports.js

@@ -24,8 +24,8 @@
     "@babel/preset-flow": "^7.25.9",
     "@babel/preset-react": "^7.26.3",
     "@babel/preset-typescript": "^7.26.0",
-    "@stylexjs/scripts": "0.11.1",
-    "babel-plugin-syntax-hermes-parser": "^0.26.0"
+    "babel-plugin-syntax-hermes-parser": "^0.26.0",
+    "scripts": "0.11.1"
   },
   "jest": {
     "snapshotFormat": {

packages/scripts/package.json

@@ -63,10 +63,10 @@
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^15.3.0",
     "@rollup/plugin-replace": "^6.0.1",
-    "@stylexjs/scripts": "0.11.1",
     "babel-plugin-syntax-hermes-parser": "^0.26.0",
     "cross-env": "^7.0.3",
-    "rollup": "^4.24.0"
+    "rollup": "^4.24.0",
+    "scripts": "0.11.1"
   },
   "jest": {},
   "files": [

packages/shared/package.json

@@ -0,0 +1,35 @@
+# Tools
+
+Tools used to manage monorepo tasks like pre-commit hooks and npm releases.
+
+## How to create a release
+
+The release script (run from the monorepo root) must be used to create and publish releases.
+
+```shell
+npm run release
+  # package version (required)
+  --pkg-version 0.10.2
+  # creates git commit and tag
+  --commit
+  # publishes to npm using 2fa
+  --publish --otp 123456
+```
+
+You can perform a dry run by only specifying the new version for a release:
+
+```shell
+npm run release -- --pkg-version 0.10.2
+```
+
+To commit and tag the release:
+
+```shell
+npm run release -- --pkg-version 0.10.2 --commit
+```
+
+To publish the release:
+
+```shell
+npm run release -- --pkg-version 0.10.2 --publish
+```