acetheking987/bsky-social-app
1
0
Fork 0
Code Issues Actions Packages Projects Releases 1 Wiki Activity

add comment about lexicons regeneration

Browse Source
This commit is contained in:
Oleksii Bulenok
2026-08-31 13:49:12 +02:00
parent 5bfbd3abcd
commit 85f946b7f4
1 changed files with 9 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
plugins/babel-plugin-lexicon-leaf-imports.js
+9
View File
@@ -25,6 +25,15 @@
* binding is left on the barrel import. The result is always correct, merely * binding is left on the barrel import. The result is always correct, merely
* unshaken for that file. Set BSKY_LEXICON_IMPORTS_DEBUG=1 to log such bails. * unshaken for that file. Set BSKY_LEXICON_IMPORTS_DEBUG=1 to log such bails.
* *
* Caveat: the rewrite bakes leaf file paths into each consumer's transform
* output, but Metro's and babel-jest's persistent caches key only on the
* consumer's own content, so a regen that MOVES leaf files (or a @bsky/sdk
* upgrade that reshuffles dist) can leave unchanged consumers replaying stale
* leaf imports from a warm cache. Symptoms are a module-not-found error in a
* file you did not touch or, if the old path still resolves, a runtime
* undefined-member error. Restart with `expo start -c` (or clear the Jest
* cache) after such a regen.
*
* Leaf vs barrel is decided from the filesystem: a segment with both `<seg>.ts` * Leaf vs barrel is decided from the filesystem: a segment with both `<seg>.ts`
* (or `.js`) and a `<seg>/` directory is a barrel, a segment with only the file * (or `.js`) and a `<seg>/` directory is a barrel, a segment with only the file
* is a leaf. This keeps the plugin independent of nesting depth (most NSIDs are * is a leaf. This keeps the plugin independent of nesting depth (most NSIDs are