packages/flow-transform-oxidized/README.md
A package for traversing and transforming a Flow AST. Forked from upstream
hermes-transform
with the sibling deps rewired:
hermes-parser -> flow-parser-oxidizedhermes-estree -> flow-estree-oxidizedhermes-eslint -> flow-eslint-oxidizedprettier-plugin-hermes-parser -> prettier-plugin-flow-parser-oxidized
(optional peerDep)This package is pieced together and inspired by code from:
src/generated/{node-types.js, special-case-node-types/, TransformCloneSignatures.js.flow, TransformModifySignatures.js.flow, TransformReplaceSignatures.js.flow} are
marked @generated by upstream codegen scripts that live OUTSIDE this
package (at xplat/static_h/tools/hermes-parser/js/scripts/genTransform*.js).
Their contents still reference hermes-estree import paths. Retargeting the
codegen so it emits flow-estree-oxidized references is a separate
follow-up. Until then, consumers who hit those imports can rely on the
Yarn-workspace resolution chain (the upstream hermes-estree package is
still present alongside the fork).src/detachedNode.js uses
Symbol.for('hermes-transform - ...') runtime markers. These are private
to this package (not import paths), preserved verbatim from upstream to
keep the fork a pure literal rename.flow/packages/flow-parser-oxidized/src/transform/print/ (with print.js,
detachedNodeTypes.js, comments/). It predates this fork and is left
untouched. Consumers should migrate to flow-transform-oxidized over time;
a follow-up can either delete the partial vendor or re-export from this
package.