Function buildImageInsertRequests

internal/cmd/docs_import.go:348–411

buildImageInsertRequests creates the Docs API batch update requests to replace placeholder text with inline images. Requests are ordered in reverse index order so earlier positions are not invalidated as the document is modified.

(placeholders map[string]docRange, images []markdownImage, imageURLs map[int]string, tabID string)

// placeholder text with inline images. Requests are ordered in reverse index order
// so earlier positions are not invalidated as the document is modified.
func buildImageInsertRequests(placeholders map[string]docRange, images []markdownImage, imageURLs map[int]string, tabID string) []*docs.Request {
	// Collect entries sorted by start index descending.
	type entry struct {
		image markdownImage
		dr    docRange
		url   string
	}
	var entries []entry
	for _, img := range images {
		ph := img.placeholder()
		dr, ok := placeholders[ph]
		if !ok {
			continue
		}
		u, ok := imageURLs[img.index]
		if !ok {
			continue
		}
		entries = append(entries, entry{image: img, dr: dr, url: u})
	}

	// Sort by start index descending; process from end of document to start.
	sort.Slice(entries, func(i, j int) bool {
		return entries[i].dr.startIndex > entries[j].dr.startIndex
	})

	reqs := make([]*docs.Request, 0, len(entries)*2)
	for _, e := range entries {
		// First delete the placeholder text.
		reqs = append(reqs, &docs.Request{
			DeleteContentRange: &docs.DeleteContentRangeRequest{
				Range: &docs.Range{
					StartIndex: e.dr.startIndex,
					EndIndex:   e.dr.endIndex,
					TabId:      tabID,
				},
			},
		})
		// Then insert the image at that position.
		objSize := &docs.Size{}
		switch {
		case e.image.widthPt > 0 && e.image.heightPt > 0:
			objSize.Width = &docs.Dimension{Magnitude: e.image.widthPt, Unit: "PT"}
			objSize.Height = &docs.Dimension{Magnitude: e.image.heightPt, Unit: "PT"}
		case e.image.widthPt > 0:
			objSize.Width = &docs.Dimension{Magnitude: e.image.widthPt, Unit: "PT"}
		case e.image.heightPt > 0:
			objSize.Height = &docs.Dimension{Magnitude: e.image.heightPt, Unit: "PT"}
		default:
			objSize.Width = &docs.Dimension{Magnitude: defaultImageMaxWidthPt, Unit: "PT"}
		}
		reqs = append(reqs, &docs.Request{
			InsertInlineImage: &docs.InsertInlineImageRequest{
				Uri: e.url,
				Location: &docs.Location{
					Index: e.dr.startIndex,
					TabId: tabID,
				},