worsier 2.0.0 → 2.2.0

package/README.md

@@ -1,21 +1,36 @@
 # Worsier
 
-A focused JavaScript, TypeScript, JSX, and TSX formatter powered by Rust. It formats static imports
-and the boundaries around runtime variable declarations while preserving the declarations
-themselves.
+A focused JavaScript, TypeScript, JSX, and TSX formatter powered by Rust. It formats static imports,
+trailing commas, and the boundaries around runtime variable declarations while preserving source
+text outside the enabled rules.
 Node.js 24.0.0 or newer is required.
 Prebuilt Windows x64 binaries are temporarily unavailable while
 [npm package publication is restored](https://github.com/Perdolique/worsier/issues/11).
 
 ```sh
 pnpm add -D worsier
-pnpm exec worsier --init
 pnpm exec worsier --check .
 pnpm exec worsier --write .
 ```
 
+The CLI uses its opinionated defaults without a configuration file. An optional `worsier.jsonc`
+can override them; run `pnpm exec worsier --init` to create the complete typed configuration.
+
 ```js
 import { format } from 'worsier'
 
-const output = await format('example.ts', "import{answer,type Value}from'pkg'", {})
+const output = await format('example.ts', "import{answer,type Value}from'pkg'")
 ```
+
+Pass an optional third `FormatConfig` argument to override the programmatic defaults. The
+programmatic API does not discover configuration files.
+
+## Broader alternatives
+
+[Prettier](https://prettier.io/docs/) is a mature opinionated formatter that prints the complete
+source, while [Oxfmt](https://oxc.rs/docs/guide/usage/formatter.html) is a fast,
+Prettier-compatible formatter with broader language and formatting coverage. Both provide selected
+configuration options, including [Prettier](https://prettier.io/docs/options#trailing-commas) and
+[Oxfmt](https://oxc.rs/docs/guide/usage/formatter/config-file-reference#trailingcomma)
+trailing-comma modes. Worsier instead focuses on independently configurable source-rewrite rules
+and preserves text outside the selected rules.

package/configuration_schema.json

@@ -29,7 +29,8 @@
         "statementSpacing": {
           "imports": "separate",
           "variableDeclarations": "separate"
-        }
+        },
+        "trailingCommas": "never"
       }
     },
     "verifyAst": {
@@ -52,6 +53,10 @@
             "imports": "separate",
             "variableDeclarations": "separate"
           }
+        },
+        "trailingCommas": {
+          "$ref": "#/$defs/TrailingCommaMode",
+          "default": "never"
         }
       },
       "additionalProperties": false
@@ -77,6 +82,14 @@
         "compact",
         "off"
       ]
+    },
+    "TrailingCommaMode": {
+      "type": "string",
+      "enum": [
+        "always",
+        "never",
+        "off"
+      ]
     }
   }
 }

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 import type { FormatConfig } from './types.js';
 export type { FormatConfig } from './types.js';
-export declare function format(fileName: string, sourceText: string, config: FormatConfig): Promise<string>;
+export declare function format(fileName: string, sourceText: string, config?: FormatConfig): Promise<string>;

package/dist/index.js

@@ -1,5 +1,5 @@
 import { loadBinding } from './binding.js';
-export async function format(fileName, sourceText, config) {
+export async function format(fileName, sourceText, config = {}) {
     const configJson = JSON.stringify(config);
     try {
         return await loadBinding().format(fileName, sourceText, configJson);

package/dist/types.d.ts

@@ -8,6 +8,7 @@ export interface FormatConfig {
 export interface RulesConfig {
     importLayout?: boolean;
     statementSpacing?: StatementSpacingConfig;
+    trailingCommas?: 'always' | 'never' | 'off';
 }
 export interface StatementSpacingConfig {
     imports?: 'separate' | 'compact' | 'off';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "worsier",
-  "version": "2.0.0",
-  "description": "A focused JavaScript and TypeScript import and variable-boundary formatter powered by Rust",
+  "version": "2.2.0",
+  "description": "A focused JavaScript and TypeScript import, trailing-comma, and statement-boundary formatter powered by Rust",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -48,13 +48,13 @@
     ]
   },
   "optionalDependencies": {
-    "worsier-darwin-arm64": "2.0.0",
-    "worsier-win32-arm64-msvc": "2.0.0",
-    "worsier-linux-arm64-gnu": "2.0.0",
-    "worsier-linux-arm64-musl": "2.0.0",
-    "worsier-darwin-x64": "2.0.0",
-    "worsier-linux-x64-gnu": "2.0.0",
-    "worsier-linux-x64-musl": "2.0.0"
+    "worsier-darwin-arm64": "2.2.0",
+    "worsier-win32-arm64-msvc": "2.2.0",
+    "worsier-linux-arm64-gnu": "2.2.0",
+    "worsier-linux-arm64-musl": "2.2.0",
+    "worsier-darwin-x64": "2.2.0",
+    "worsier-linux-x64-gnu": "2.2.0",
+    "worsier-linux-x64-musl": "2.2.0"
   },
   "devDependencies": {
     "@types/node": "26.2.0",