@ttsc/lint 0.14.0-dev.20260529.1 → 0.14.0

package/linthost/rules_ts_prefer_string_starts_ends_with.go

@@ -23,55 +23,55 @@
 package linthost
 
 import (
-	"strings"
+  "strings"
 
-	shimast "github.com/microsoft/typescript-go/shim/ast"
-	shimchecker "github.com/microsoft/typescript-go/shim/checker"
+  shimast "github.com/microsoft/typescript-go/shim/ast"
+  shimchecker "github.com/microsoft/typescript-go/shim/checker"
 )
 
 type preferStringStartsEndsWith struct{}
 
 func (preferStringStartsEndsWith) Name() string {
-	return "typescript/prefer-string-starts-ends-with"
+  return "typescript/prefer-string-starts-ends-with"
 }
 func (preferStringStartsEndsWith) NeedsTypeChecker() bool {
-	return true
+  return true
 }
 func (preferStringStartsEndsWith) Visits() []shimast.Kind {
-	return []shimast.Kind{
-		shimast.KindBinaryExpression,
-		shimast.KindCallExpression,
-	}
+  return []shimast.Kind{
+    shimast.KindBinaryExpression,
+    shimast.KindCallExpression,
+  }
 }
 func (preferStringStartsEndsWith) Check(ctx *Context, node *shimast.Node) {
-	if ctx.Checker == nil {
-		return
-	}
-	switch node.Kind {
-	case shimast.KindBinaryExpression:
-		bin := node.AsBinaryExpression()
-		if bin == nil || bin.OperatorToken == nil {
-			return
-		}
-		if !preferStringStartsEndsWithIsEqualityOp(bin.OperatorToken.Kind) {
-			return
-		}
-		if preferStringStartsEndsWithBinary(ctx, bin.Left, bin.Right) {
-			ctx.Report(node, preferStringStartsEndsWithMessage)
-			return
-		}
-		if preferStringStartsEndsWithBinary(ctx, bin.Right, bin.Left) {
-			ctx.Report(node, preferStringStartsEndsWithMessage)
-		}
-	case shimast.KindCallExpression:
-		call := node.AsCallExpression()
-		if call == nil {
-			return
-		}
-		if preferStringStartsEndsWithRegexTest(ctx, call) {
-			ctx.Report(node, preferStringStartsEndsWithMessage)
-		}
-	}
+  if ctx.Checker == nil {
+    return
+  }
+  switch node.Kind {
+  case shimast.KindBinaryExpression:
+    bin := node.AsBinaryExpression()
+    if bin == nil || bin.OperatorToken == nil {
+      return
+    }
+    if !preferStringStartsEndsWithIsEqualityOp(bin.OperatorToken.Kind) {
+      return
+    }
+    if preferStringStartsEndsWithBinary(ctx, bin.Left, bin.Right) {
+      ctx.Report(node, preferStringStartsEndsWithMessage)
+      return
+    }
+    if preferStringStartsEndsWithBinary(ctx, bin.Right, bin.Left) {
+      ctx.Report(node, preferStringStartsEndsWithMessage)
+    }
+  case shimast.KindCallExpression:
+    call := node.AsCallExpression()
+    if call == nil {
+      return
+    }
+    if preferStringStartsEndsWithRegexTest(ctx, call) {
+      ctx.Report(node, preferStringStartsEndsWithMessage)
+    }
+  }
 }
 
 const preferStringStartsEndsWithMessage = "Prefer `String#startsWith` / `String#endsWith` over the equivalent `indexOf` / `lastIndexOf` / anchored-regex idioms — clearer and avoids the off-by-one arithmetic."
@@ -81,14 +81,14 @@ const preferStringStartsEndsWithMessage = "Prefer `String#startsWith` / `String#
 // `!=`, `!==` matter: every recognized shape compares two integers
 // for equality (or inequality with a sentinel) rather than ordering.
 func preferStringStartsEndsWithIsEqualityOp(kind shimast.Kind) bool {
-	switch kind {
-	case shimast.KindEqualsEqualsToken,
-		shimast.KindEqualsEqualsEqualsToken,
-		shimast.KindExclamationEqualsToken,
-		shimast.KindExclamationEqualsEqualsToken:
-		return true
-	}
-	return false
+  switch kind {
+  case shimast.KindEqualsEqualsToken,
+    shimast.KindEqualsEqualsEqualsToken,
+    shimast.KindExclamationEqualsToken,
+    shimast.KindExclamationEqualsEqualsToken:
+    return true
+  }
+  return false
 }
 
 // preferStringStartsEndsWithBinary inspects `call op other` for the
@@ -96,79 +96,79 @@ func preferStringStartsEndsWithIsEqualityOp(kind shimast.Kind) bool {
 // the call is provably string-typed AND the right-hand side matches
 // the sentinel of one of the recognized rewrites:
 //
-//	str.indexOf(p) === 0
-//	str.indexOf(p, str.length - p.length) !== -1
-//	str.lastIndexOf(p) === str.length - p.length
+//  str.indexOf(p) === 0
+//  str.indexOf(p, str.length - p.length) !== -1
+//  str.lastIndexOf(p) === str.length - p.length
 func preferStringStartsEndsWithBinary(
-	ctx *Context,
-	callNode, otherNode *shimast.Node,
+  ctx *Context,
+  callNode, otherNode *shimast.Node,
 ) bool {
-	callNode = stripParens(callNode)
-	otherNode = stripParens(otherNode)
-	if callNode == nil || otherNode == nil {
-		return false
-	}
-	if callNode.Kind != shimast.KindCallExpression {
-		return false
-	}
-	call := callNode.AsCallExpression()
-	if call == nil || call.Expression == nil {
-		return false
-	}
-	receiver, method, ok := promisePropertyAccessParts(call.Expression)
-	if !ok {
-		return false
-	}
-	if method != "indexOf" && method != "lastIndexOf" {
-		return false
-	}
-	if receiver == nil {
-		return false
-	}
-	t := ctx.Checker.GetTypeAtLocation(receiver)
-	if !preferStringStartsEndsWithIsString(t) {
-		return false
-	}
-	args := call.Arguments
-	if args == nil || len(args.Nodes) == 0 {
-		return false
-	}
-	arg := stripParens(args.Nodes[0])
-	if arg == nil {
-		return false
-	}
-	receiverText := nodeText(ctx.File, receiver)
-	argText := nodeText(ctx.File, arg)
-	otherText := nodeText(ctx.File, otherNode)
-	if receiverText == "" || argText == "" {
-		return false
-	}
-	switch method {
-	case "indexOf":
-		// startsWith: `str.indexOf(p) === 0`
-		if len(args.Nodes) == 1 {
-			return otherText == "0"
-		}
-		// endsWith via positional indexOf: the second argument must
-		// equal `str.length - arg.length`, and the comparison must be
-		// against -1 (the sentinel for "not present at that
-		// position").
-		if len(args.Nodes) != 2 {
-			return false
-		}
-		second := stripParens(args.Nodes[1])
-		if !preferStringStartsEndsWithIsLengthMinusLength(ctx, second, receiverText, argText) {
-			return false
-		}
-		return preferStringStartsEndsWithIsMinusOne(otherText)
-	case "lastIndexOf":
-		// endsWith: `str.lastIndexOf(p) === str.length - p.length`
-		if len(args.Nodes) != 1 {
-			return false
-		}
-		return preferStringStartsEndsWithIsLengthMinusLengthText(otherText, receiverText, argText)
-	}
-	return false
+  callNode = stripParens(callNode)
+  otherNode = stripParens(otherNode)
+  if callNode == nil || otherNode == nil {
+    return false
+  }
+  if callNode.Kind != shimast.KindCallExpression {
+    return false
+  }
+  call := callNode.AsCallExpression()
+  if call == nil || call.Expression == nil {
+    return false
+  }
+  receiver, method, ok := promisePropertyAccessParts(call.Expression)
+  if !ok {
+    return false
+  }
+  if method != "indexOf" && method != "lastIndexOf" {
+    return false
+  }
+  if receiver == nil {
+    return false
+  }
+  t := ctx.Checker.GetTypeAtLocation(receiver)
+  if !preferStringStartsEndsWithIsString(t) {
+    return false
+  }
+  args := call.Arguments
+  if args == nil || len(args.Nodes) == 0 {
+    return false
+  }
+  arg := stripParens(args.Nodes[0])
+  if arg == nil {
+    return false
+  }
+  receiverText := nodeText(ctx.File, receiver)
+  argText := nodeText(ctx.File, arg)
+  otherText := nodeText(ctx.File, otherNode)
+  if receiverText == "" || argText == "" {
+    return false
+  }
+  switch method {
+  case "indexOf":
+    // startsWith: `str.indexOf(p) === 0`
+    if len(args.Nodes) == 1 {
+      return otherText == "0"
+    }
+    // endsWith via positional indexOf: the second argument must
+    // equal `str.length - arg.length`, and the comparison must be
+    // against -1 (the sentinel for "not present at that
+    // position").
+    if len(args.Nodes) != 2 {
+      return false
+    }
+    second := stripParens(args.Nodes[1])
+    if !preferStringStartsEndsWithIsLengthMinusLength(ctx, second, receiverText, argText) {
+      return false
+    }
+    return preferStringStartsEndsWithIsMinusOne(otherText)
+  case "lastIndexOf":
+    // endsWith: `str.lastIndexOf(p) === str.length - p.length`
+    if len(args.Nodes) != 1 {
+      return false
+    }
+    return preferStringStartsEndsWithIsLengthMinusLengthText(otherText, receiverText, argText)
+  }
+  return false
 }
 
 // preferStringStartsEndsWithRegexTest reports whether `call` is a
@@ -179,29 +179,29 @@ func preferStringStartsEndsWithBinary(
 // without that the call is not equivalent to a startsWith/endsWith
 // rewrite (e.g. coercing a non-string regex argument).
 func preferStringStartsEndsWithRegexTest(
-	ctx *Context,
-	call *shimast.CallExpression,
+  ctx *Context,
+  call *shimast.CallExpression,
 ) bool {
-	if call == nil || call.Expression == nil || call.Arguments == nil || len(call.Arguments.Nodes) != 1 {
-		return false
-	}
-	receiver, method, ok := promisePropertyAccessParts(call.Expression)
-	if !ok || method != "test" {
-		return false
-	}
-	receiver = stripParens(receiver)
-	if receiver == nil || receiver.Kind != shimast.KindRegularExpressionLiteral {
-		return false
-	}
-	raw := nodeText(ctx.File, receiver)
-	if !preferStringStartsEndsWithIsAnchoredStaticRegex(raw) {
-		return false
-	}
-	arg := stripParens(call.Arguments.Nodes[0])
-	if arg == nil {
-		return false
-	}
-	return preferStringStartsEndsWithIsString(ctx.Checker.GetTypeAtLocation(arg))
+  if call == nil || call.Expression == nil || call.Arguments == nil || len(call.Arguments.Nodes) != 1 {
+    return false
+  }
+  receiver, method, ok := promisePropertyAccessParts(call.Expression)
+  if !ok || method != "test" {
+    return false
+  }
+  receiver = stripParens(receiver)
+  if receiver == nil || receiver.Kind != shimast.KindRegularExpressionLiteral {
+    return false
+  }
+  raw := nodeText(ctx.File, receiver)
+  if !preferStringStartsEndsWithIsAnchoredStaticRegex(raw) {
+    return false
+  }
+  arg := stripParens(call.Arguments.Nodes[0])
+  if arg == nil {
+    return false
+  }
+  return preferStringStartsEndsWithIsString(ctx.Checker.GetTypeAtLocation(arg))
 }
 
 // preferStringStartsEndsWithIsAnchoredStaticRegex reports whether
@@ -212,34 +212,34 @@ func preferStringStartsEndsWithRegexTest(
 // like `i` would lower-case both sides, which `startsWith` does not
 // do — so the rewrite would change meaning.
 func preferStringStartsEndsWithIsAnchoredStaticRegex(raw string) bool {
-	if len(raw) < 3 || raw[0] != '/' {
-		return false
-	}
-	closing := strings.LastIndexByte(raw, '/')
-	if closing <= 0 {
-		return false
-	}
-	pattern := raw[1:closing]
-	flags := raw[closing+1:]
-	if pattern == "" {
-		return false
-	}
-	for i := 0; i < len(flags); i++ {
-		switch flags[i] {
-		case 'g', 'y', 'd':
-			// stateful/position flags — fine for `.test` since we
-			// only call once
-		default:
-			return false
-		}
-	}
-	if pattern[0] == '^' {
-		return preferStringStartsEndsWithIsStaticString(pattern[1:])
-	}
-	if pattern[len(pattern)-1] == '$' {
-		return preferStringStartsEndsWithIsStaticString(pattern[:len(pattern)-1])
-	}
-	return false
+  if len(raw) < 3 || raw[0] != '/' {
+    return false
+  }
+  closing := strings.LastIndexByte(raw, '/')
+  if closing <= 0 {
+    return false
+  }
+  pattern := raw[1:closing]
+  flags := raw[closing+1:]
+  if pattern == "" {
+    return false
+  }
+  for i := 0; i < len(flags); i++ {
+    switch flags[i] {
+    case 'g', 'y', 'd':
+      // stateful/position flags — fine for `.test` since we
+      // only call once
+    default:
+      return false
+    }
+  }
+  if pattern[0] == '^' {
+    return preferStringStartsEndsWithIsStaticString(pattern[1:])
+  }
+  if pattern[len(pattern)-1] == '$' {
+    return preferStringStartsEndsWithIsStaticString(pattern[:len(pattern)-1])
+  }
+  return false
 }
 
 // preferStringStartsEndsWithIsStaticString reports whether `pattern`
@@ -249,35 +249,35 @@ func preferStringStartsEndsWithIsAnchoredStaticRegex(raw string) bool {
 // `[`, `]`, `{`, `}`, `|`, `.` — disqualifies the body because the
 // startsWith/endsWith rewrite would change matching semantics.
 func preferStringStartsEndsWithIsStaticString(pattern string) bool {
-	if pattern == "" {
-		return false
-	}
-	for i := 0; i < len(pattern); i++ {
-		ch := pattern[i]
-		if ch == '\\' {
-			// Accept only escapes that name a single literal
-			// character (`\.`, `\$`, `\^`, `\/`, `\\`, `\(`, `\)`,
-			// `\[`, `\]`, `\{`, `\}`, `\|`, `\+`, `\*`, `\?`).
-			// Reject character-class shortcuts (`\d`, `\w`, `\s`)
-			// and back-references — those would not survive a
-			// rewrite to startsWith/endsWith.
-			if i+1 >= len(pattern) {
-				return false
-			}
-			next := pattern[i+1]
-			switch next {
-			case '.', '$', '^', '/', '\\', '(', ')', '[', ']', '{', '}', '|', '+', '*', '?', '-':
-				i++
-				continue
-			}
-			return false
-		}
-		switch ch {
-		case '^', '$', '*', '+', '?', '(', ')', '[', ']', '{', '}', '|', '.':
-			return false
-		}
-	}
-	return true
+  if pattern == "" {
+    return false
+  }
+  for i := 0; i < len(pattern); i++ {
+    ch := pattern[i]
+    if ch == '\\' {
+      // Accept only escapes that name a single literal
+      // character (`\.`, `\$`, `\^`, `\/`, `\\`, `\(`, `\)`,
+      // `\[`, `\]`, `\{`, `\}`, `\|`, `\+`, `\*`, `\?`).
+      // Reject character-class shortcuts (`\d`, `\w`, `\s`)
+      // and back-references — those would not survive a
+      // rewrite to startsWith/endsWith.
+      if i+1 >= len(pattern) {
+        return false
+      }
+      next := pattern[i+1]
+      switch next {
+      case '.', '$', '^', '/', '\\', '(', ')', '[', ']', '{', '}', '|', '+', '*', '?', '-':
+        i++
+        continue
+      }
+      return false
+    }
+    switch ch {
+    case '^', '$', '*', '+', '?', '(', ')', '[', ']', '{', '}', '|', '.':
+      return false
+    }
+  }
+  return true
 }
 
 // preferStringStartsEndsWithIsLengthMinusLength reports whether
@@ -286,14 +286,14 @@ func preferStringStartsEndsWithIsStaticString(pattern string) bool {
 // rewrite only fires when the call site spelled the offset that way
 // — matching the upstream rule's textual shape detector.
 func preferStringStartsEndsWithIsLengthMinusLength(
-	ctx *Context,
-	node *shimast.Node,
-	receiverText, argText string,
+  ctx *Context,
+  node *shimast.Node,
+  receiverText, argText string,
 ) bool {
-	if node == nil {
-		return false
-	}
-	return preferStringStartsEndsWithIsLengthMinusLengthText(nodeText(ctx.File, node), receiverText, argText)
+  if node == nil {
+    return false
+  }
+  return preferStringStartsEndsWithIsLengthMinusLengthText(nodeText(ctx.File, node), receiverText, argText)
 }
 
 // preferStringStartsEndsWithIsLengthMinusLengthText is the text-level
@@ -301,29 +301,29 @@ func preferStringStartsEndsWithIsLengthMinusLength(
 // so the `lastIndexOf === str.length - p.length` shape can use the
 // same matcher against the binary RHS text.
 func preferStringStartsEndsWithIsLengthMinusLengthText(text, receiverText, argText string) bool {
-	wanted := receiverText + ".length-" + argText + ".length"
-	return preferStringStartsEndsWithStripSpaces(text) == wanted
+  wanted := receiverText + ".length-" + argText + ".length"
+  return preferStringStartsEndsWithStripSpaces(text) == wanted
 }
 
 // preferStringStartsEndsWithStripSpaces removes whitespace from `s`.
 // Used for the textual equality match — `a.length - b.length` and
 // `a.length-b.length` should both match the canonical form.
 func preferStringStartsEndsWithStripSpaces(s string) string {
-	var b strings.Builder
-	for i := 0; i < len(s); i++ {
-		ch := s[i]
-		if ch == ' ' || ch == '\t' || ch == '\r' || ch == '\n' {
-			continue
-		}
-		b.WriteByte(ch)
-	}
-	return b.String()
+  var b strings.Builder
+  for i := 0; i < len(s); i++ {
+    ch := s[i]
+    if ch == ' ' || ch == '\t' || ch == '\r' || ch == '\n' {
+      continue
+    }
+    b.WriteByte(ch)
+  }
+  return b.String()
 }
 
 // preferStringStartsEndsWithIsMinusOne reports whether `text` is the
 // numeric literal `-1` (with or without internal whitespace).
 func preferStringStartsEndsWithIsMinusOne(text string) bool {
-	return preferStringStartsEndsWithStripSpaces(text) == "-1"
+  return preferStringStartsEndsWithStripSpaces(text) == "-1"
 }
 
 // preferStringStartsEndsWithIsString reports whether t is provably
@@ -331,30 +331,30 @@ func preferStringStartsEndsWithIsMinusOne(text string) bool {
 // rejects `any` / `unknown` / `never` so generic helpers don't fire.
 // Union and intersection types must have every constituent string-like.
 func preferStringStartsEndsWithIsString(t *shimchecker.Type) bool {
-	if t == nil {
-		return false
-	}
-	flags := t.Flags()
-	if flags&(shimchecker.TypeFlagsAny|shimchecker.TypeFlagsUnknown|shimchecker.TypeFlagsNever) != 0 {
-		return false
-	}
-	if flags&shimchecker.TypeFlagsStringLike != 0 {
-		return true
-	}
-	if flags&(shimchecker.TypeFlagsUnion|shimchecker.TypeFlagsIntersection) != 0 {
-		for _, part := range t.Types() {
-			if part == nil {
-				continue
-			}
-			if !preferStringStartsEndsWithIsString(part) {
-				return false
-			}
-		}
-		return true
-	}
-	return false
+  if t == nil {
+    return false
+  }
+  flags := t.Flags()
+  if flags&(shimchecker.TypeFlagsAny|shimchecker.TypeFlagsUnknown|shimchecker.TypeFlagsNever) != 0 {
+    return false
+  }
+  if flags&shimchecker.TypeFlagsStringLike != 0 {
+    return true
+  }
+  if flags&(shimchecker.TypeFlagsUnion|shimchecker.TypeFlagsIntersection) != 0 {
+    for _, part := range t.Types() {
+      if part == nil {
+        continue
+      }
+      if !preferStringStartsEndsWithIsString(part) {
+        return false
+      }
+    }
+    return true
+  }
+  return false
 }
 
 func init() {
-	Register(preferStringStartsEndsWith{})
+  Register(preferStringStartsEndsWith{})
 }

package/linthost/rules_ts_promise_function_async.go

@@ -20,58 +20,58 @@
 package linthost
 
 import (
-	shimast "github.com/microsoft/typescript-go/shim/ast"
+  shimast "github.com/microsoft/typescript-go/shim/ast"
 )
 
 type promiseFunctionAsync struct{}
 
 func (promiseFunctionAsync) Name() string { return "typescript/promise-function-async" }
 func (promiseFunctionAsync) NeedsTypeChecker() bool {
-	return true
+  return true
 }
 func (promiseFunctionAsync) Visits() []shimast.Kind {
-	return []shimast.Kind{
-		shimast.KindFunctionDeclaration,
-		shimast.KindFunctionExpression,
-		shimast.KindArrowFunction,
-		shimast.KindMethodDeclaration,
-	}
+  return []shimast.Kind{
+    shimast.KindFunctionDeclaration,
+    shimast.KindFunctionExpression,
+    shimast.KindArrowFunction,
+    shimast.KindMethodDeclaration,
+  }
 }
 func (promiseFunctionAsync) Check(ctx *Context, node *shimast.Node) {
-	if ctx.Checker == nil {
-		return
-	}
-	if hasAsyncModifier(node) {
-		return
-	}
-	// Skip overload signatures and abstract methods — only the
-	// implementation signature carries an executable body that the
-	// `async` keyword could wrap.
-	if node.Body() == nil {
-		return
-	}
-	if hasModifier(node, shimast.KindAbstractKeyword) {
-		return
-	}
-	sig := ctx.Checker.GetSignatureFromDeclaration(node)
-	if sig == nil {
-		return
-	}
-	returnType := ctx.Checker.GetReturnTypeOfSignature(sig)
-	if returnType == nil {
-		return
-	}
-	if !isPromiseTypedExpression(ctx.Checker, returnType) {
-		return
-	}
-	startPos := keywordStart(ctx.File, node, "function")
-	if startPos >= 0 {
-		ctx.ReportRange(startPos, startPos+len("function"), "Function returning a Promise should be declared `async` so synchronous throws surface as a rejected Promise.")
-		return
-	}
-	ctx.Report(node, "Function returning a Promise should be declared `async` so synchronous throws surface as a rejected Promise.")
+  if ctx.Checker == nil {
+    return
+  }
+  if hasAsyncModifier(node) {
+    return
+  }
+  // Skip overload signatures and abstract methods — only the
+  // implementation signature carries an executable body that the
+  // `async` keyword could wrap.
+  if node.Body() == nil {
+    return
+  }
+  if hasModifier(node, shimast.KindAbstractKeyword) {
+    return
+  }
+  sig := ctx.Checker.GetSignatureFromDeclaration(node)
+  if sig == nil {
+    return
+  }
+  returnType := ctx.Checker.GetReturnTypeOfSignature(sig)
+  if returnType == nil {
+    return
+  }
+  if !isPromiseTypedExpression(ctx.Checker, returnType) {
+    return
+  }
+  startPos := keywordStart(ctx.File, node, "function")
+  if startPos >= 0 {
+    ctx.ReportRange(startPos, startPos+len("function"), "Function returning a Promise should be declared `async` so synchronous throws surface as a rejected Promise.")
+    return
+  }
+  ctx.Report(node, "Function returning a Promise should be declared `async` so synchronous throws surface as a rejected Promise.")
 }
 
 func init() {
-	Register(promiseFunctionAsync{})
+  Register(promiseFunctionAsync{})
 }