package.json module and typings point to files missing from the published tarball (TS7016 for TypeScript consumers)

[Prabhakar-Poudel]

The published package.json declares:

"module": "dist/widgets.m.js",
"typings": "dist/types/index.d.ts"

Neither file exists in the published tarball (checked 4.0.0 through 4.4.0). The files actually shipped are dist/widgets.js (CJS) and dist/types/src/index.d.ts.

Consequences for npm consumers:

• TypeScript: import { Widgets } from "@alma/widgets" fails with TS7016: Could not find a declaration file for module '@alma/widgets' — the typings path resolves to nothing.
• Bundlers that honor module have to fall back to main after failing to resolve dist/widgets.m.js (webpack and vite do this silently; stricter tooling errors).
• Even after pointing typings manually at dist/types/src/index.d.ts, the emitted declarations import internal @/... path aliases that can't resolve outside your build, so the exported option types (PaymentPlanWidgetOptions etc.) degrade to any.

Current workaround: a local ambient declaration (declare module "@alma/widgets/dist/widgets.js" { export * from "@alma/widgets/dist/types/src/index"; }) plus importing @alma/widgets/dist/widgets.js directly. Corrected field paths (or an exports map) and alias-free emitted .d.ts files would remove the need for it.

Related: #256 — if the published package.json gets touched for that one, both fixes could land in the same patch release.

[hunki1488-a11y]

I can take this as a small paid package-readiness fix if the maintainers want it handled quickly.

Scope for $120 / 24h:

• verify the 4.x published tarball paths and reproduce the TS7016 consumer failure in a strict scratch project;
• map the minimal package.json/build/declaration change so module and typings point to shipped files;
• check whether emitted .d.ts files still leak unresolved @/ aliases for external consumers;
• hand off a PR-ready patch or concise maintainer report with an npm-pack/typecheck smoke checklist.

I would only start after paid scope is explicitly agreed and funded/escrowed. No speculative unpaid PR is implied by this comment.