Add Catalog Hash System for Dependency Tracking

.changeset/ninety-toys-complain.md

@@ -0,0 +1,16 @@
+---
+"@khanacademy/kas": patch
+"@khanacademy/keypad-context": patch
+"@khanacademy/kmath": patch
+"@khanacademy/math-input": patch
+"@khanacademy/perseus": patch
+"@khanacademy/perseus-core": patch
+"@khanacademy/perseus-editor": patch
+"@khanacademy/perseus-linter": patch
+"@khanacademy/perseus-score": patch
+"@khanacademy/perseus-utils": patch
+"@khanacademy/pure-markdown": patch
+"@khanacademy/simple-markdown": patch
+---
+
+Add catalog hash system for dependency tracking

README.md

@@ -40,12 +40,13 @@ To make changes to Perseus, create a new branch based on `main`, commit your cha
 ### Everyday commands
 
 ```bash
-pnpm tsc -w     # run the typechecker in watch mode
-pnpm test       # run all tests
-pnpm lint       # find problems
-pnpm lint --fix # fix problems
-pnpm storybook  # open component gallery
-pnpm changeset  # create a changeset file (see below)
+pnpm tsc -w                  # run the typechecker in watch mode
+pnpm test                    # run all tests
+pnpm lint                    # find problems
+pnpm lint --fix              # fix problems
+pnpm storybook               # open component gallery
+pnpm changeset               # create a changeset file (see below)
+pnpm update-catalog-hashes   # update catalog dependency hashes (see below)
 ```
 
 Additionally, we use Khan Academy's Git extensions (OLC) to manage pull requests.
@@ -63,6 +64,10 @@ The components and widgets of Perseus are developed using [Storybook](https://gi
 
 We use [changesets](https://github.com/changesets/changesets) to help manage our versioning/releases. Each pull request must include a changeset file stating which packages changed and how their versions should be incremented. Run `pnpm changeset` to generate and commit a changeset file.
 
+### Catalog Hashes
+
+Catalog hashes ensure packages are rebuilt when their catalog dependencies (Wonder Blocks, React, etc.) are updated. These hashes are automatically updated when running `utils/sync-dependencies.ts`. If you manually add catalog dependencies to a package.json, run `pnpm update-catalog-hashes` to update the hashes. The pre-publish check will verify all hashes are current before releasing.
+
 ### Releasing Perseus to npm
 
 1. Landing changes to `main` creates/updates a “Version Packages” PR

package.json

@@ -57,6 +57,7 @@
         "@types/react": "~18.2.64",
         "@types/react-dom": "~18.2.19",
         "@types/semver": "7.7.0",
+        "@types/string-hash": "^1.1.3",
         "@types/underscore": "^1.11.4",
         "@typescript-eslint/eslint-plugin": "^8.18.0",
         "@typescript-eslint/parser": "^8.18.0",
@@ -120,6 +121,7 @@
         "sloc": "^0.2.1",
         "storybook": "^9.0.4",
         "storybook-multilevel-sort": "^2.0.1",
+        "string-hash": "^1.1.3",
         "style-loader": "^3.3.3",
         "swc_mut_cjs_exports": "^8.0.1",
         "tiny-invariant": "catalog:devDeps",
@@ -144,6 +146,7 @@
         "lint": "eslint . --ext .js --ext .jsx --ext .ts --ext .tsx",
         "lint:timing": "cross-env TIMING=1 pnpm lint",
         "publish:ci": "utils/pre-publish-check-ci.ts && git diff --stat --exit-code HEAD && pnpm build && pnpm build:types && changeset publish",
+        "update-catalog-hashes": "utils/update-catalog-hashes-cli.ts",
         "sloc": "sloc packages --exclude node_modules",
         "test": "jest",
         "storybook": "storybook dev -p 6006",

packages/kas/package.json

@@ -42,5 +42,8 @@
         "expression",
         "algebra",
         "symbolic"
-    ]
+    ],
+    "khan": {
+        "catalogHash": "1315561098"
+    }
 }

packages/keypad-context/package.json

@@ -34,5 +34,8 @@
     "peerDependencies": {
         "react": "catalog:peerDeps"
     },
-    "keywords": []
+    "keywords": [],
+    "khan": {
+        "catalogHash": "1430796529"
+    }
 }

packages/kmath/package.json

@@ -37,5 +37,8 @@
         "jquery": "catalog:peerDeps",
         "underscore": "catalog:peerDeps"
     },
-    "keywords": []
+    "keywords": [],
+    "khan": {
+        "catalogHash": "2806871786"
+    }
 }

packages/math-input/package.json

@@ -78,5 +78,8 @@
         "react-dom": "catalog:peerDeps",
         "react-transition-group": "^4.4.1"
     },
-    "keywords": []
+    "keywords": [],
+    "khan": {
+        "catalogHash": "4265157434"
+    }
 }

packages/perseus-core/package.json

@@ -53,5 +53,8 @@
         "@khanacademy/wonder-stuff-core": "catalog:peerDeps",
         "underscore": "catalog:peerDeps"
     },
-    "keywords": []
+    "keywords": [],
+    "khan": {
+        "catalogHash": "2504152792"
+    }
 }

packages/perseus-editor/package.json

@@ -109,5 +109,8 @@
         "react-dom": "catalog:peerDeps",
         "underscore": "catalog:peerDeps"
     },
-    "keywords": []
+    "keywords": [],
+    "khan": {
+        "catalogHash": "3388811657"
+    }
 }

packages/perseus-linter/package.json

@@ -32,5 +32,8 @@
         "@khanacademy/pure-markdown": "workspace:*",
         "perseus-build-settings": "workspace:*"
     },
-    "keywords": []
+    "keywords": [],
+    "khan": {
+        "catalogHash": "5381"
+    }
 }

packages/perseus-score/package.json

@@ -37,5 +37,8 @@
     "peerDependencies": {
         "underscore": "catalog:peerDeps"
     },
-    "keywords": []
+    "keywords": [],
+    "khan": {
+        "catalogHash": "1315561098"
+    }
 }

packages/perseus-utils/package.json

@@ -28,5 +28,8 @@
     "dependencies": {},
     "devDependencies": {
         "perseus-build-settings": "workspace:*"
+    },
+    "khan": {
+        "catalogHash": "5381"
     }
 }

packages/perseus/package.json

@@ -131,5 +131,8 @@
         "react-popper": "^2.2.5",
         "underscore": "catalog:peerDeps"
     },
-    "keywords": []
+    "keywords": [],
+    "khan": {
+        "catalogHash": "2287515007"
+    }
 }

packages/pure-markdown/package.json

@@ -32,5 +32,8 @@
         "perseus-build-settings": "workspace:*"
     },
     "peerDependencies": {},
-    "keywords": []
+    "keywords": [],
+    "khan": {
+        "catalogHash": "5381"
+    }
 }

packages/simple-markdown/package.json

@@ -36,5 +36,8 @@
     },
     "keywords": [
         "markdown"
-    ]
+    ],
+    "khan": {
+        "catalogHash": "2928525122"
+    }
 }