Function BuildRequests

internal/docsformat/format.go:103–155

(options Options, start, end int64, tabID string)

}

func BuildRequests(options Options, start, end int64, tabID string) ([]*docs.Request, error) {
	if start < 0 || end <= start {
		return nil, invalidf("invalid format range: %d..%d", start, end)
	}

	textReq, hasText, err := buildTextStyleRequest(options, start, end, tabID)
	if err != nil {
		return nil, err
	}

	paragraphStart, paragraphEnd := start, end

	hasPostBulletRange := options.PostBulletParagraphStart > 0 && options.PostBulletParagraphEnd > options.PostBulletParagraphStart
	if hasPostBulletRange {
		paragraphStart = options.PostBulletParagraphStart
		paragraphEnd = options.PostBulletParagraphEnd
	}

	paragraphReq, hasParagraph, err := buildParagraphStyleRequest(options, paragraphStart, paragraphEnd, tabID)
	if err != nil {
		return nil, err
	}

	bulletReq, hasBullets, err := buildParagraphBulletsRequest(options, start, end, tabID)
	if err != nil {
		return nil, err
	}

	requests := make([]*docs.Request, 0, 3)
	if hasText {
		requests = append(requests, textReq)
	}

	// Removing bullets preserves list nesting by adding paragraph indentation.
	// Apply explicit paragraph controls afterward so the caller's values win.
	if hasBullets && (options.ClearBullets || hasPostBulletRange) {
		requests = append(requests, bulletReq)
	}

	if hasParagraph {
		requests = append(requests, paragraphReq)
	}

	if hasBullets && !options.ClearBullets && !hasPostBulletRange {
		requests = append(requests, bulletReq)
	}

	if len(requests) == 0 {
		return nil, ValidationError("no formatting flags provided")
	}

	return requests, nil
}

func buildTextStyleRequest(options Options, start, end int64, tabID string) (*docs.Request, bool, error) {
	style := &docs.TextStyle{}