@ttsc/strip 0.8.0 → 0.9.0

package/README.md

@@ -9,30 +9,15 @@
 [![Guide Documents](https://img.shields.io/badge/Guide-Documents-forestgreen)](https://github.com/samchon/ttsc/tree/master/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)
 
-`@ttsc/strip` removes configured call-expression statements and debugger statements from TypeScript source before emit.
+`@ttsc/strip` removes configured debug calls and `debugger` statements from TypeScript source AST before emit.
 
 ## Setup
 
-Install `ttsc`, TypeScript-Go, and the strip plugin:
+Install `ttsc` and TypeScript-Go, then the strip plugin:
 
 ```bash
-npm install -D ttsc @typescript/native-preview @ttsc/strip
-```
-
-Open your project's `tsconfig.json`, then add this entry under `compilerOptions.plugins`. If the file already has `compilerOptions`, merge this into the existing object:
-
-```jsonc
-{
-  "compilerOptions": {
-    "plugins": [
-      {
-        "transform": "@ttsc/strip",
-        "calls": ["console.log", "console.debug", "assert.*"],
-        "statements": ["debugger"],
-      },
-    ],
-  },
-}
+npm install -D ttsc @typescript/native-preview
+npm install -D @ttsc/strip
 ```
 
 Run your normal `ttsc` command:
@@ -41,22 +26,29 @@ Run your normal `ttsc` command:
 npx ttsc
 ```
 
+With no extra config, `@ttsc/strip` removes `console.log`, `console.debug`, `assert.*`, and `debugger`.
+
 Only the configured patterns are removed. `@ttsc/strip` is not a minifier, tree-shaker, or dead-code-elimination pass.
 
-## Notes
+## Configuration
+
+Default behavior removes these statement patterns:
+
+```json
+{
+  "calls": ["console.log", "console.debug", "assert.*"],
+  "statements": ["debugger"]
+}
+```
 
 Call patterns match statement-level calls such as `console.log("debug")` or `assert.equal(left, right)`. A wildcard is supported at the end of a dotted call pattern, such as `assert.*`.
 
+Add a direct plugin config only when the project needs a different strip list:
+
 ```jsonc
 {
   "compilerOptions": {
     "plugins": [
-      // Keep lint first.
-      { "transform": "@ttsc/lint", "config": { "no-var": "error" } },
-
-      // First-party utilities use their documented transform order.
-      { "transform": "@ttsc/banner", "banner": "License MIT" },
-      { "transform": "@ttsc/paths" },
       {
         "transform": "@ttsc/strip",
         "calls": ["console.log", "console.debug", "assert.*"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttsc/strip",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "First-party ttsc plugin that removes configured calls and statements from emitted JavaScript.",
   "main": "src/index.cjs",
   "exports": {
@@ -14,11 +14,17 @@
     "typescript",
     "tsgo"
   ],
+  "ttsc": {
+    "plugin": {
+      "transform": "@ttsc/strip"
+    }
+  },
   "files": [
     "README.md",
     "src/index.cjs",
     "go.mod",
-    "plugin"
+    "plugin/main.go",
+    "plugin/strip.go"
   ],
   "repository": {
     "type": "git",

package/plugin/main.go

@@ -28,7 +28,7 @@ func run(args []string) int {
   case "transform":
     return utility.RunTransform(args[1:])
   case "check":
-    return 0
+    return utility.RunCheck(args[1:])
   default:
     fmt.Fprintf(os.Stderr, "@ttsc/strip: unknown command %q\n", args[0])
     return 2