feat!: build .d.ts instead of .ts

packages/agoric-cli/src/publish.js

@@ -15,6 +15,8 @@ import { stringToPath } from '@cosmjs/crypto';
 import { Decimal } from '@cosmjs/math';
 import { Bech32 } from '@cosmjs/encoding';
 
+// @ts-expect-error ESM confusion
+// eslint-disable-next-line import/no-unresolved -- doesn't understand "exports" field
 import { MsgInstallBundle } from '@agoric/cosmic-proto/swingset/msgs.js';
 
 // https://github.com/Agoric/agoric-sdk/blob/master/golang/cosmos/daemon/main.go

packages/cosmic-proto/MAINTAINERS.md

@@ -1,4 +1,11 @@
-We check-in and publish the `gen` generated artifacts to npm.
+This package is updated rarely and so the build is checked into SCM. That is, the `dist` files and a copied subset to `swingset` so they can be imported in consumers that don't yet support ESM. At one time these were symlinks but [NPM won't publish symlinks](https://github.com/npm/npm/issues/3310).
+
+To include `dist` files requires overriding the repo-wide .gitignore of `dist`:
+```
+git add -f dist/agoric dist/cosmos
+```
+
+ We used to check in `gen` but they're redundant with `dist` and include `.ts` which creates problems for downstream consumers using TypeScript ([ref](https://github.com/microsoft/TypeScript/issues/47387#issuecomment-1168711813)).
 To rebuild the generated artifacts, install `protoc` [1] and run `yarn rebuild` in
 this package.
 
@@ -46,3 +53,4 @@ To surface additional stubs:
    symbolic links for aliasing when necessary.
 
 [1] http://google.github.io/proto-lens/installing-protoc.html
+

packages/cosmic-proto/README.md

@@ -2,3 +2,8 @@
 
 This package exports JavaScript and TypeScript generated from Cosmic Swingset
 Protobuf IDL so that clients can communicate with the Agoric chain.
+
+Package exports are defined in `exports` and also made available in the
+`swingset/` file path for backwards compatibility.
+
+See also [MAINTAINERS.md](MAINTAINERS.md).