Might be a Parcel bug but I'm not sure: Parcel build failing to resolve zstddec/stream

[eldang]

I was going to file an issue but realised that my understanding of the problem here is too vague; specifically I can't tell if the failure is Parcel's remit or something misconfigured elsewhere. After some dependency updates, I started getting these errors from Parcel builds:

🚨 Build failed.

@parcel/core: Failed to resolve 'zstddec/stream' from './node_modules/ol/node_modules/geotiff/dist-module/compression/zstd.js'

  /Users/eldan/Documents/github/terragis/ol_base_viewer/node_modules/ol/node_modules/geotiff/dist-module/compression/zstd.js:1:29
  > 1 | import { ZSTDDecoder } from 'zstddec/stream';
  >   |                             ^^^^^^^^^^^^^^^^
    2 | import BaseDecoder from './basedecoder.js';
    3 | export const zstd = new ZSTDDecoder();

@parcel/resolver-default: Cannot load file './stream' from module 'zstddec'

I'm currently using npm@11.9.0 and Node 25.6.1 on a Mac, with Parcel 2.16.4. The problem also replicates in Github's automated CI which has Node 20.20.0 and npm 10.8.2.

By rolling back individual dependencies, I figured out that the breaking change was:

• OpenLayers 10.7 to 10.8
• Which bumped Geotiff from 2.1.3 to 3.0.3
• Which bumped zstddec from 0.1.0 to 0.2.0

But there are a few strange things going on:

• If I bump Geotiff to 3.0.x manually without the OpenLayers upgrade, everything builds fine. Though looking through package-lock.json that may be because OpenLayers is still including the 2.x version of Geotiff, so the 3.x one may not be getting linked in the Parcel build.
• As discussed at the Geotiff repository, there doesn't seem to be anything wrong with how Geotiff is importing zstddec.
• And I'm not at all sure about this last part, but so far it looks like the only people who are having trouble with this are using bundlers, either Parcel or Webpack.

So I'm confused about where the problem even lies: whether it's Geotiff, zstddec, OpenLayers, Parcel, or something else. Any idea where we should be looking?

[ahocevar]

Parcel does not resolve package exports by default. See https://parceljs.org/features/dependency-resolution/#enabling-package-exports. To enable support for package exports, parcel users should add the following to their package.json:

  "@parcel/resolver-default": {
    "packageExports": true
  }

This goes in the package.json of the application that uses parcel as bundler and zstddec as dependency, to configure parcel properly. There is nothing wrong with ol, geotiff and zstddec in that regard.

[eldang]

Thank you, that was indeed the issue and I just hadn't understood what needed to be done.