chore: auto import in zoe

turadg · turadg · commit 0d80709c0e55 · 2025-11-13T17:02:00.000-08:00
diff --git a/packages/zoe/src/contractFacet/exit.js b/packages/zoe/src/contractFacet/exit.js
@@ -10,6 +10,10 @@ import {
   isWaivedExitRule,
 } from '../typeGuards.js';
 
+/**
+ * @import {MakeExitObj} from '../internal-types.js';
+ */
+
 const ExitObjectI = M.interface('ExitObject', { exit: M.call().returns() });
 const WakerI = M.interface('Waker', {
   wake: M.call(TimestampShape).returns(),
diff --git a/packages/zoe/src/contractFacet/vatRoot.js b/packages/zoe/src/contractFacet/vatRoot.js
@@ -16,6 +16,9 @@ import { makeZCFZygote } from './zcfZygote.js';
 /**
  * @import {ZoeService} from '@agoric/zoe';
  * @import {Baggage} from '@agoric/vat-data';
+ * @import {VatPowers} from '@agoric/swingset-vat';
+ * @import {BundleCap} from '@agoric/swingset-vat';
+ * @import {StartZcf} from '../internal-types.js';
  */
 
 /**
diff --git a/packages/zoe/src/contractFacet/zcfMint.js b/packages/zoe/src/contractFacet/zcfMint.js
@@ -11,6 +11,10 @@ import { ZcfMintI } from './typeGuards.js';
 /**
  * @import {ZCFMint, ZCFSeat} from '@agoric/zoe';
  * @import {Baggage} from '@agoric/vat-data';
+ * @import {GetAssetKindByBrand} from '../internal-types.js';
+ * @import {UserSeat} from '../../build/src/zoeService/types.js';
+ * @import {ZcfMintReallocator} from '../internal-types.js';
+ * @import {ZoeMint} from '../internal-types.js';
  */
 
 /**
diff --git a/packages/zoe/src/contractFacet/zcfSeat.js b/packages/zoe/src/contractFacet/zcfSeat.js
@@ -25,6 +25,10 @@ import { assertRightsConserved } from './rightsConservation.js';
  * @import {ShutdownWithFailure} from '@agoric/swingset-vat';
  * @import {Baggage} from '@agoric/vat-data';
  * @import {Allocation} from './types.js';
+ * @import {ZoeInstanceAdmin} from '../internal-types.js';
+ * @import {GetAssetKindByBrand} from '../internal-types.js';
+ * @import {ZcfMintReallocator} from '../internal-types.js';
+ * @import {SeatHandle} from '../internal-types.js';
  */
 
 /**
diff --git a/packages/zoe/src/contractFacet/zcfZygote.js b/packages/zoe/src/contractFacet/zcfZygote.js
@@ -34,6 +34,11 @@ import { prepareZcMint } from './zcfMint.js';
  * @import {Baggage} from '@agoric/vat-data';
  * @import {IssuerOptionsRecord} from '@agoric/ertp';
  * @import {ZoeIssuerRecord, ZCFRegisterFeeMint, ContractStartFn, SetTestJig} from './types.js';
+ * @import {ZoeInstanceAdmin} from '../internal-types.js';
+ * @import {InstanceRecord} from '../zoeService/utils.js';
+ * @import {ExecuteContractResult} from '../internal-types.js';
+ * @import {ZoeMint} from '../internal-types.js';
+ * @import {HandleOfferResult} from '../internal-types.js';
  */
 
 /**
diff --git a/packages/zoe/src/contractSupport/zoeHelpers.js b/packages/zoe/src/contractSupport/zoeHelpers.js
@@ -10,6 +10,7 @@ import { atomicTransfer, fromOnly, toOnly } from './atomicTransfer.js';
 /**
  * @import {Pattern} from '@endo/patterns';
  * @import {ContractMeta, Invitation, Proposal, ZCF, ZCFSeat} from '@agoric/zoe';
+ * @import {UserSeat} from '../../build/src/zoeService/types.js';
  */
 
 export const defaultAcceptanceMsg = `The offer has been accepted. Once the contract has been completed, please check your payout`;
diff --git a/packages/zoe/src/contracts/otcDesk.js b/packages/zoe/src/contracts/otcDesk.js
@@ -10,6 +10,7 @@ import {
 
 /**
  * @import {TimerService} from '@agoric/time';
+ * @import {UserSeat} from '../types-index.js';
  */
 
 /**
diff --git a/packages/zoe/src/contracts/types-ambient.js b/packages/zoe/src/contracts/types-ambient.js
@@ -19,7 +19,7 @@
  * @property {Amount} pricePerItem
  *
  * @typedef {object} SellItemsResult
- * @property {UserSeat} sellItemsCreatorSeat
+ * @property {import('../types-index.js').UserSeat} sellItemsCreatorSeat
  * @property {SellItemsCreatorFacet} sellItemsCreatorFacet
  * @property {Instance} sellItemsInstance
  * @property {SellItemsPublicFacet} sellItemsPublicFacet
diff --git a/packages/zoe/src/zoeService/installationStorage.js b/packages/zoe/src/zoeService/installationStorage.js
@@ -15,6 +15,8 @@ import {
  * @import {WeakMapStore} from '@agoric/store';
  * @import {BundleID, BundleCap} from '@agoric/swingset-vat';
  * @import {SourceBundle} from '@agoric/zoe';
+ * @import {GetBundleCapForID} from './internal-types.js';
+ * @import {InstallBundle} from '../../build/src/zoeService/types.js';
  */
 
 /**
diff --git a/packages/zoe/src/zoeService/instanceAdminStorage.js b/packages/zoe/src/zoeService/instanceAdminStorage.js
@@ -21,6 +21,9 @@ import { makeZoeSeatAdminFactory } from './zoeSeat.js';
 /**
  * @import {WeakMapStore} from '@agoric/store';
  * @import {Baggage} from '@agoric/vat-data';
+ * @import {HandleOfferResult} from '../internal-types.js';
+ * @import {SeatHandle} from '../internal-types.js';
+ * @import {ZoeSeatAdmin} from '../internal-types.js';
  */
 
 /**
diff --git a/packages/zoe/src/zoeService/internal-types.js b/packages/zoe/src/zoeService/internal-types.js
@@ -8,6 +8,11 @@
  * @import {GetPublicFacet} from './utils.js';
  * @import {GetTerms} from './utils.js';
  * @import {CreateVatResults} from '@agoric/swingset-vat';
+ * @import {MakeZoeMint} from '../internal-types.js';
+ * @import {RegisterFeeMint} from '../internal-types.js';
+ * @import {ZoeInstanceAdminMakeInvitation} from '../internal-types.js';
+ * @import {GetAssetKindByBrand} from '../internal-types.js';
+ * @import {Pattern} from '@agoric/swingset-liveslots';
  */
 
 /**
diff --git a/packages/zoe/src/zoeService/offer/burnInvitation.js b/packages/zoe/src/zoeService/offer/burnInvitation.js
@@ -3,6 +3,10 @@
 import { Fail, X, annotateError, assert, makeError } from '@endo/errors';
 import { E } from '@endo/eventual-send';
 
+/**
+ * @import {InvitationHandle} from '../zoe.js';
+ */
+
 /**
  * Burn the invitation, assert that only one invitation was burned,
  * and extract and return the instanceHandle and invitationHandle
diff --git a/packages/zoe/src/zoeService/originalZoeSeat.js b/packages/zoe/src/zoeService/originalZoeSeat.js
@@ -16,6 +16,10 @@ import {
 
 /**
  * @import {Baggage} from '@agoric/vat-data';
+ * @import {InstanceAdminHelper} from '../internal-types.js';
+ * @import {WithdrawFacet} from '../internal-types.js';
+ * @import {ExitObj} from '../internal-types.js';
+ * @import {HandleOfferResult} from '../internal-types.js';
  */
 
 export const coreUserSeatMethods = harden({
diff --git a/packages/zoe/src/zoeService/startInstance.js b/packages/zoe/src/zoeService/startInstance.js
@@ -26,6 +26,13 @@ import { makeInstanceAdminMaker } from './instanceAdminStorage.js';
  * @import {StartInstance} from './utils.js';
  * @import {PromiseWatcher} from '@agoric/swingset-liveslots';
  * @import {VatAdminFacet} from '@agoric/swingset-vat';
+ * @import {SeatHandle} from '../internal-types.js';
+ * @import {ZoeSeatAdmin} from '../internal-types.js';
+ * @import {Completion} from '../types-index.js';
+ * @import {ZoeInstanceStorageManager} from './internal-types.js';
+ * @import {ZCFRoot} from '../internal-types.js';
+ * @import {InstanceAdmin} from '../internal-types.js';
+ * @import {ZoeInstanceAdmin} from '../internal-types.js';
  */
 
 /**
diff --git a/packages/zoe/src/zoeService/zoe.js b/packages/zoe/src/zoeService/zoe.js
@@ -32,6 +32,7 @@ import { makeZoeStorageManager } from './zoeStorageManager.js';
  * @import {VatAdminSvc, ShutdownWithFailure} from '@agoric/swingset-vat';
  * @import {Baggage} from '@agoric/vat-data';
  * @import {FeeIssuerConfig, FeeMintAccess, ZCFSpec, ZoeService} from './types.js';
+ * @import {GetBundleCapForID} from './internal-types.js';
  */
 
 /**
diff --git a/packages/zoe/src/zoeService/zoeSeat.js b/packages/zoe/src/zoeService/zoeSeat.js
@@ -17,6 +17,10 @@ import {
 
 /**
  * @import {Baggage} from '@agoric/vat-data';
+ * @import {InstanceAdminHelper} from '../internal-types.js';
+ * @import {WithdrawFacet} from '../internal-types.js';
+ * @import {HandleOfferResult} from '../internal-types.js';
+ * @import {ExitObj} from '../internal-types.js';
  */
 
 // ZoeSeatAdmin has the implementation of coreUserSeatMethods, but ZoeUserSeat
diff --git a/packages/zoe/src/zoeService/zoeStorageManager.js b/packages/zoe/src/zoeService/zoeStorageManager.js
@@ -38,6 +38,11 @@ import './internal-types.js';
 /**
  * @import {Baggage} from '@agoric/vat-data';
  * @import {InvitationAmount} from '@agoric/zoe';
+ * @import {CreateZCFVat} from './internal-types.js';
+ * @import {GetBundleCapForID} from './internal-types.js';
+ * @import {ShutdownWithFailure} from '@agoric/swingset-vat';
+ * @import {GetFeeIssuerKit} from './internal-types.js';
+ * @import {ZoeMint} from '../internal-types.js';
  */
 
 const { ownKeys } = Reflect;
diff --git a/packages/zoe/test/runMintContract.js b/packages/zoe/test/runMintContract.js
@@ -2,6 +2,10 @@ import { E } from '@endo/eventual-send';
 import { Far } from '@endo/marshal';
 import { AmountMath } from '@agoric/ertp';
 
+/**
+ * @import {FeeMintAccess} from '../src/types-index.js';
+ */
+
 /**
  * @param {ZCF} zcf
  * @param {{feeMintAccess: FeeMintAccess}} privateArgs
diff --git a/packages/zoe/test/swingsetTests/runMint/vat-alice.js b/packages/zoe/test/swingsetTests/runMint/vat-alice.js
@@ -3,6 +3,7 @@ import { Far } from '@endo/marshal';
 
 /**
  * @import {ZoeService} from '@agoric/zoe';
+ * @import {FeeMintAccess} from '../../../build/src/zoeService/types.js';
  */
 
 /**
diff --git a/packages/zoe/test/swingsetTests/upgradeCoveredCall/coveredCall-service-upgrade.test.js b/packages/zoe/test/swingsetTests/upgradeCoveredCall/coveredCall-service-upgrade.test.js
@@ -3,6 +3,11 @@ import { test } from '@agoric/swingset-vat/tools/prepare-test-env-ava.js';
 import { assert } from '@endo/errors';
 import { buildVatController } from '@agoric/swingset-vat';
 
+/**
+ * @import {SwingSetConfig} from '@agoric/swingset-vat';
+ * @import {ManagerType} from '@agoric/swingset-vat';
+ */
+
 const bfile = name => new URL(name, import.meta.url).pathname;
 
 test('coveredCall service upgrade', async t => {
diff --git a/packages/zoe/test/swingsetTests/zoe/zoe-upgrade.test.js b/packages/zoe/test/swingsetTests/zoe/zoe-upgrade.test.js
@@ -5,6 +5,10 @@ import bundleSource from '@endo/bundle-source';
 import { buildVatController } from '@agoric/swingset-vat';
 import { kunser } from '@agoric/kmarshal';
 
+/**
+ * @import {SwingSetConfig} from '@agoric/swingset-vat';
+ */
+
 const bfile = name => new URL(name, import.meta.url).pathname;
 
 test('zoe vat upgrade trauma', async t => {
diff --git a/packages/zoe/test/unitTests/zcf/registerFeeMintContract.js b/packages/zoe/test/unitTests/zcf/registerFeeMintContract.js
@@ -2,6 +2,10 @@ import { AmountMath } from '@agoric/ertp';
 import { E } from '@endo/eventual-send';
 import { Far } from '@endo/marshal';
 
+/**
+ * @import {FeeMintAccess} from '../../../src/types-index.js';
+ */
+
 /**
  * Tests zcf.registerFeeMint
  *
diff --git a/packages/zoe/test/unitTests/zcf/zcf.test.js b/packages/zoe/test/unitTests/zcf/zcf.test.js
@@ -14,6 +14,7 @@ import { assertAmountsEqual } from '../../zoeTestHelpers.js';
 
 /**
  * @import {ContractMeta, Invitation, OfferHandler, ZCF, ZCFSeat} from '@agoric/zoe';
+ * @import {ZoeIssuerRecord} from '../../../build/src/contractFacet/types.js';
  */
 
 test(`zcf.getZoeService`, async t => {
diff --git a/packages/zoe/test/unitTests/zoe/escrowStorage.test.js b/packages/zoe/test/unitTests/zoe/escrowStorage.test.js
@@ -9,6 +9,10 @@ import {
   assertPayoutAmount,
 } from '../../zoeTestHelpers.js';
 
+/**
+ * @import {ZoeIssuerRecord} from '../../../src/types-index.js';
+ */
+
 test('provideEscrowStorage', async t => {
   const { createPurse, provideLocalPurse, withdrawPayments, depositPayments } =
     provideEscrowStorage(

Original file line number	Diff line number	Diff line change
`@@ -19,7 +19,7 @@`
`19`	`19`	`* @property {Amount} pricePerItem`
`20`	`20`	`*`
`21`	`21`	`* @typedef {object} SellItemsResult`
`22`		`- * @property {UserSeat} sellItemsCreatorSeat`
	`22`	`+ * @property {import('../types-index.js').UserSeat} sellItemsCreatorSeat`
`23`	`23`	`* @property {SellItemsCreatorFacet} sellItemsCreatorFacet`
`24`	`24`	`* @property {Instance} sellItemsInstance`
`25`	`25`	`* @property {SellItemsPublicFacet} sellItemsPublicFacet`