npm - @ttsc/lint - Versions diffs - 0.14.0-dev.20260528.1 → 0.14.0-dev.20260529.1 - Mend

@ttsc/lint 0.14.0-dev.20260528.1 → 0.14.0-dev.20260529.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/README.md CHANGED Viewed

@@ -2,12 +2,7 @@
 ![banner of @ttsc/lint](https://ttsc.dev/og.jpg)
-[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/samchon/ttsc/blob/master/LICENSE)
-[![NPM Version](https://img.shields.io/npm/v/@ttsc/lint.svg)](https://www.npmjs.com/package/@ttsc/lint)
-[![NPM Downloads](https://img.shields.io/npm/dm/@ttsc/lint.svg)](https://www.npmjs.com/package/@ttsc/lint)
-[![Build Status](https://github.com/samchon/ttsc/workflows/test/badge.svg)](https://github.com/samchon/ttsc/actions?query=workflow%3Atest)
-[![Guide Documents](https://img.shields.io/badge/Guide-Documents-forestgreen)](https://ttsc.dev/docs)
-[![Discord Badge](https://img.shields.io/badge/discord-samchon-d91965?style=flat&labelColor=5866f2&logo=discord&logoColor=white&link=https://discord.gg/E94XhzrUCZ)](https://discord.gg/E94XhzrUCZ)
+[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/samchon/ttsc/blob/master/LICENSE) [![NPM Version](https://img.shields.io/npm/v/@ttsc/lint.svg)](https://www.npmjs.com/package/@ttsc/lint) [![NPM Downloads](https://img.shields.io/npm/dm/@ttsc/lint.svg)](https://www.npmjs.com/package/@ttsc/lint) [![Build Status](https://github.com/samchon/ttsc/workflows/test/badge.svg)](https://github.com/samchon/ttsc/actions?query=workflow%3Atest) [![Guide Documents](https://img.shields.io/badge/Guide-Documents-forestgreen)](https://ttsc.dev/docs) [![Discord Badge](https://img.shields.io/badge/discord-samchon-d91965?style=flat&labelColor=5866f2&logo=discord&logoColor=white&link=https://discord.gg/E94XhzrUCZ)](https://discord.gg/E94XhzrUCZ)
 A linter and formatter. Co-protagonist of the [`ttsc`](https://ttsc.dev) toolchain — paired with `ttsc`, it replaces `eslint` and `prettier`.
@@ -196,7 +191,6 @@ Rules:
   joined the family list.
 -->
 ### ESLint core
 Generic ESLint-compatible rules that apply to both JavaScript and TypeScript source. Every rule listed here corresponds 1-to-1 with an ESLint core rule of the same kebab-case id, so projects migrating from ESLint can paste their rule severities into `lint.config.ts` without renaming anything. TypeScript-only rules and `@typescript-eslint` extensions live under `typescript/*` in [TypeScript](#typescript) — `@ttsc/lint` does not accept legacy bare names or `@typescript-eslint/*` aliases for those.
@@ -526,7 +520,7 @@ Source: [`eslint-plugin-jsx-a11y`](https://github.com/jsx-eslint/eslint-plugin-j
 - [`jsx-a11y/heading-has-content`](https://github.com/samchon/ttsc/blob/master/tests/test-lint/src/cases/jsx-a11y-heading-has-content.tsx): rejects empty JSX headings.
 - [`jsx-a11y/html-has-lang`](https://github.com/samchon/ttsc/blob/master/tests/test-lint/src/cases/jsx-a11y-html-has-lang.tsx): requires `<html>` JSX elements to declare a non-empty `lang` attribute.
 - [`jsx-a11y/iframe-has-title`](https://github.com/samchon/ttsc/blob/master/tests/test-lint/src/cases/jsx-a11y-iframe-has-title.tsx): requires every `<iframe>` JSX element to declare a non-empty, unique `title`.
-- [`jsx-a11y/img-redundant-alt`](https://github.com/samchon/ttsc/blob/master/tests/test-lint/src/cases/jsx-a11y-img-redundant-alt.tsx): rejects redundant words such as *image*, *photo*, or *picture* inside the `alt` attribute of an `<img>`.
+- [`jsx-a11y/img-redundant-alt`](https://github.com/samchon/ttsc/blob/master/tests/test-lint/src/cases/jsx-a11y-img-redundant-alt.tsx): rejects redundant words such as _image_, _photo_, or _picture_ inside the `alt` attribute of an `<img>`.
 - [`jsx-a11y/interactive-supports-focus`](https://github.com/samchon/ttsc/blob/master/tests/test-lint/src/cases/jsx-a11y-interactive-supports-focus.tsx): requires elements with interactive ARIA roles to be focusable.
 - [`jsx-a11y/label-has-associated-control`](https://github.com/samchon/ttsc/blob/master/tests/test-lint/src/cases/jsx-a11y-label-has-associated-control.tsx): requires `<label>` elements to wrap a form control or reference one via `htmlFor`.
 - [`jsx-a11y/label-has-for`](https://github.com/samchon/ttsc/blob/master/tests/test-lint/src/cases/jsx-a11y-label-has-for.tsx): deprecated predecessor of `label-has-associated-control` that checks the same nesting / `htmlFor` association requirement.
@@ -991,7 +985,7 @@ Source: [`eslint-plugin-regexp`](https://github.com/ota-meshi/eslint-plugin-rege
 ### Security
-Security-focused TypeScript source rules. Report likely security smells — non-literal sinks for eval, file I/O, regex construction, child-process spawning, cryptographic primitives — that warrant human review even if no exploit is statically provable. Treat findings as *hints*, not proofs.
+Security-focused TypeScript source rules. Report likely security smells — non-literal sinks for eval, file I/O, regex construction, child-process spawning, cryptographic primitives — that warrant human review even if no exploit is statically provable. Treat findings as _hints_, not proofs.
 Source: [`eslint-plugin-security@4.0.0`](https://github.com/eslint-community/eslint-plugin-security).
@@ -1080,7 +1074,7 @@ export default {
 ### Architecture boundaries
-Architecture-boundary rules enforce import direction and module visibility between configured source-path *elements* (layers, features, apps in a monorepo). Every rule operates on the *resolved source file* of an import — relative imports are followed to the real `.ts`/`.tsx`/`.d.ts` file before classification. Boundary diagnostics do not offer autofixes — a violation usually needs an API or architecture decision, not a mechanical import rewrite.
+Architecture-boundary rules enforce import direction and module visibility between configured source-path _elements_ (layers, features, apps in a monorepo). Every rule operates on the _resolved source file_ of an import — relative imports are followed to the real `.ts`/`.tsx`/`.d.ts` file before classification. Boundary diagnostics do not offer autofixes — a violation usually needs an API or architecture decision, not a mechanical import rewrite.
 Source: ported from [`eslint-plugin-boundaries`](https://github.com/javierbrea/eslint-plugin-boundaries).
@@ -1204,4 +1198,3 @@ To the maintainers of every plugin listed above: the rule semantics under `react
 If you would prefer to publish a first-party `@ttsc/lint` plugin for your family yourself, you are welcome to take the Go sources under [`packages/lint/linthost/rules_*.go`](https://github.com/samchon/ttsc/tree/master/packages/lint/linthost) and the fixtures under [`tests/test-lint/src/cases/`](https://github.com/samchon/ttsc/tree/master/tests/test-lint/src/cases) and ship them as your own contributor plugin. Open an issue at [samchon/ttsc](https://github.com/samchon/ttsc/issues) when the upstream package is ready, and I will retire the in-tree port and add a redirect line under [Rules](#rules) pointing at your package. Same offer for partial coverage — name a subset and I will remove just those rules.
 The contributor-plugin walkthrough is the [`@ttsc/lint` development guide](https://ttsc.dev/docs/development/walkthroughs/lint).

package/linthost/lsp.go CHANGED Viewed

@@ -5,6 +5,7 @@ import (
   "errors"
   "flag"
   "fmt"
+  "io"
   "io/fs"
   "net/url"
   "os"
@@ -12,6 +13,10 @@ import (
   "strings"
   "unicode/utf16"
   "unicode/utf8"
+  shimast "github.com/microsoft/typescript-go/shim/ast"
+  shimcore "github.com/microsoft/typescript-go/shim/core"
+  shimparser "github.com/microsoft/typescript-go/shim/parser"
 )
 const (
@@ -67,8 +72,13 @@ type lspCommandOptions struct {
   argumentsJSON string
   command       string
   contextJSON   string
-  cwd           string
-  pluginsJSON   string
+  // contentStdin reports whether the caller passed --content-stdin. When
+  // set, RunLSPExecuteCommand reads the FULL document buffer from os.Stdin
+  // (to EOF) and formats that text in memory instead of reading the target
+  // file from disk. See lspFormatBuffer.
+  contentStdin bool
+  cwd          string
+  pluginsJSON  string
   // rangeJSON is accepted from the ttsc LSP server
   // (`internal/lspserver/lsp_native_plugin_source.go`) for forward
   // compatibility, but no current code path consumes it — code actions
@@ -180,6 +190,24 @@ func RunLSPExecuteCommand(args []string) int {
     return 2
   }
   opts.uri = uri
+  // --content-stdin selects the lightweight in-memory format path: the full
+  // document buffer is read from stdin and formatted with AST+source rules
+  // only, with no temp-workspace copy and no tsgo Program. It applies to
+  // ttsc.format.document; ttsc.lint.fixAll under --content-stdin is out of
+  // scope (lint-class fixes can require a type checker), so it falls back to
+  // the disk-based path below.
+  if opts.contentStdin && opts.command == commandFormatDocument {
+    content, err := io.ReadAll(os.Stdin)
+    if err != nil {
+      fmt.Fprintf(os.Stderr, "@ttsc/lint lsp-execute-command: read --content-stdin: %v\n", err)
+      return 2
+    }
+    edit, code := lspFormatBuffer(string(content), opts)
+    if code != 0 {
+      return code
+    }
+    return writeJSON(edit)
+  }
   edit, code := lspWorkspaceEditForCommand(opts)
   if code != 0 {
     return code
@@ -198,6 +226,7 @@ func parseLSPCommandOptions(name string, args []string) (*lspCommandOptions, boo
   contextJSON := fs.String("context-json", "", "")
   command := fs.String("command", "", "")
   argumentsJSON := fs.String("arguments-json", "", "")
+  contentStdin := fs.Bool("content-stdin", false, "")
   if err := fs.Parse(args); err != nil {
     return nil, false
   }
@@ -210,6 +239,7 @@ func parseLSPCommandOptions(name string, args []string) (*lspCommandOptions, boo
     argumentsJSON: *argumentsJSON,
     command:       *command,
     contextJSON:   *contextJSON,
+    contentStdin:  *contentStdin,
     cwd:           resolvedCwd,
     pluginsJSON:   *pluginsJSON,
     rangeJSON:     *rangeJSON,
@@ -421,6 +451,123 @@ func lspWorkspaceEditForCommand(opts *lspCommandOptions) (*lspWorkspaceEdit, int
   return workspaceEditForFullDocument(opts.uri, string(original), string(next)), 0
 }
+// lspFormatBuffer formats an in-memory document buffer using only the
+// format-class rules, with no tsgo Program and no temp-workspace copy. It is
+// the lightweight path behind --content-stdin for ttsc.format.document.
+//
+// Format rules are AST+source only (`IsFormat() == true`); none implement
+// typeAwareRule, so the engine runs them with a nil checker. The document
+// content comes entirely from `content` — the file on disk at opts.uri is
+// never read — so an editor can format an unsaved buffer without paying the
+// disk-copy + full-program-load cost of lspWorkspaceEditForCommand.
+//
+// Returns the same WorkspaceEdit shape as the disk path, or (nil, 0) on a
+// no-op (no fixable findings, or text unchanged after convergence).
+func lspFormatBuffer(content string, opts *lspCommandOptions) (*lspWorkspaceEdit, int) {
+  target, err := filePathFromURI(opts.uri)
+  if err != nil {
+    fmt.Fprintln(os.Stderr, err)
+    return nil, 2
+  }
+  // Guard rails mirror lspWorkspaceEditForCommand: skip targets outside the
+  // project root or inside node_modules.
+  if _, ok := projectRelativePath(opts.cwd, target); !ok {
+    fmt.Fprintf(os.Stderr, "@ttsc/lint: LSP command target %s is outside cwd %s\n", target, opts.cwd)
+    return nil, 2
+  }
+  if projectPathHasSegment(opts.cwd, target, "node_modules") {
+    return nil, 0
+  }
+  rules, err := loadRules(opts.pluginsJSON, opts.cwd, opts.tsconfig)
+  if err != nil {
+    fmt.Fprintln(os.Stderr, err)
+    return nil, 2
+  }
+  rules = formatCommandResolver{inner: rules}
+  engine := NewEngineWithResolver(rules)
+  if engine.NeedsTypeChecker() {
+    // A format-class contributor rule (formatContributorAdapter) needs the type
+    // checker, which the single-file in-memory parse can't supply. Fall back to
+    // the disk path, which builds a full program with a checker, so the result
+    // matches `ttsc format`; the dirty buffer can't be honored for these rules.
+    // Built-in format rules are AST-only, so they keep the fast in-memory path.
+    return lspWorkspaceEditForCommand(opts)
+  }
+  scriptKind := scriptKindForPath(target)
+  text := content
+  converged := false
+  for pass := 0; pass < maxFormatPasses; pass++ {
+    file := shimparser.ParseSourceFile(shimast.SourceFileParseOptions{FileName: target}, text, scriptKind)
+    if file == nil {
+      // Match the disk path: a buffer we can't parse is a benign no-op, not a
+      // hard error — don't fight the editor's own diagnostics on a dirty buffer.
+      return nil, 0
+    }
+    findings := filterFormatFindings(engine.Run([]*shimast.SourceFile{file}, nil))
+    next, applied := applyFindingFixesToText(text, findings)
+    if applied == 0 {
+      converged = true
+      break
+    }
+    text = next
+  }
+  if !converged {
+    fmt.Fprintf(os.Stderr,
+      "@ttsc/lint: LSP %s cascade did not converge after %d passes\n",
+      opts.command, maxFormatPasses)
+    return nil, 2
+  }
+  return workspaceEditForFullDocument(opts.uri, content, text), 0
+}
+// scriptKindForPath maps a file extension to the tsgo ScriptKind the parser
+// needs so TS/JSX-only syntax is recognized. Mirrors the test helpers'
+// ScriptKind selection (helpers_test.go parseTSFile/parseTSXFile).
+func scriptKindForPath(path string) shimcore.ScriptKind {
+  switch strings.ToLower(filepath.Ext(path)) {
+  case ".tsx":
+    return shimcore.ScriptKindTSX
+  case ".jsx":
+    return shimcore.ScriptKindJSX
+  case ".js", ".cjs", ".mjs":
+    return shimcore.ScriptKindJS
+  default:
+    return shimcore.ScriptKindTS
+  }
+}
+// applyFindingFixesToText is the in-memory counterpart of
+// applyFindingFixes/applyTextEditsToFile (fix.go): it collects every fixable
+// finding's TextEdit, selects a non-overlapping set with the same
+// selectTextEdits logic, applies them right-to-left to `text`, and returns the
+// new string plus the number of edits applied. It never writes to disk and
+// never reloads a Program. Findings carry byte offsets into the same `text`
+// that was just parsed, so no per-file grouping is needed.
+func applyFindingFixesToText(text string, findings []*Finding) (string, int) {
+  edits := make([]TextEdit, 0, len(findings))
+  for _, finding := range findings {
+    if finding == nil || len(finding.Fix) == 0 {
+      continue
+    }
+    edits = append(edits, finding.Fix...)
+  }
+  selected := selectTextEdits(len(text), edits)
+  if len(selected) == 0 {
+    return text, 0
+  }
+  next := text
+  for i := len(selected) - 1; i >= 0; i-- {
+    edit := selected[i]
+    next = next[:edit.Pos] + edit.Text + next[edit.End:]
+  }
+  if next == text {
+    return text, 0
+  }
+  return next, len(selected)
+}
 func workspaceEditForFullDocument(uri string, original string, next string) *lspWorkspaceEdit {
   if original == next {
     return nil

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@ttsc/lint",
-  "version": "0.14.0-dev.20260528.1",
+  "version": "0.14.0-dev.20260529.1",
   "description": "Reference ttsc plugin: ESLint-style lint rules hosted in the same Program/Checker as the type-check pass.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -36,7 +36,7 @@
     "@typescript/native-preview": "7.0.0-dev.20260527.2",
     "@types/node": "^25.3.0",
     "rimraf": "^6.1.2",
-    "ttsc": "0.14.0-dev.20260528.1"
+    "ttsc": "0.14.0-dev.20260529.1"
   },
   "repository": {
     "type": "git",