@wasm-fmt/mago_fmt 0.8.0 → 0.10.0

package/jsr.jsonc

@@ -1,7 +1,7 @@
 {
 	"$schema": "https://jsr.io/schema/config-file.v1.json",
 	"name": "@fmt/mago-fmt",
-	"version": "0.7.0",
+	"version": "0.10.0",
 	"exports": {
 		".": "./mago_fmt.js",
 		"./esm": "./mago_fmt_esm.js",

package/mago_fmt_settings.d.ts

@@ -51,7 +51,7 @@ export interface Settings {
 
 	/**
 	 * End-of-line characters to use.
-	 * @default "lf"
+	 * @default "auto"
 	 */
 	"end-of-line"?: "auto" | "lf" | "crlf" | "cr";
 
@@ -438,6 +438,31 @@ export interface Settings {
 	 */
 	"preserve-breaking-member-access-chain"?: boolean;
 
+	/**
+	 * When preserving a broken object method chain, keep the first method call on the same line as the receiver.
+	 *
+	 * This only affects already-broken chains preserved by
+	 * `"preserve-breaking-member-access-chain"`, and does not change the default
+	 * breaking style for newly broken chains.
+	 * @default false
+	 *
+	 * @example true
+	 * ```php
+	 * $object->method1()
+	 *     ->method2()
+	 *     ->method3();
+	 * ```
+	 *
+	 * @example false
+	 * ```php
+	 * $object
+	 *     ->method1()
+	 *     ->method2()
+	 *     ->method3();
+	 * ```
+	 */
+	"preserve-breaking-member-access-chain-first-method-on-same-line"?: boolean;
+
 	/**
 	 * Whether to preserve line breaks in argument lists, even if they could fit on a single line.
 	 * @default false
@@ -468,6 +493,15 @@ export interface Settings {
 	 */
 	"preserve-breaking-conditional-expression"?: boolean;
 
+	/**
+	 * Whether to preserve line breaks in condition expressions (if, elseif, while, do-while, switch, match).
+	 *
+	 * When enabled, if the original source has conditions broken across multiple lines,
+	 * the formatter maintains that layout using PER Coding Style 3.0 rules.
+	 * @default false
+	 */
+	"preserve-breaking-condition-expression"?: boolean;
+
 	/**
 	 * Whether to break a parameter list with one or more promoted properties into multiple lines.
 	 * @default true
@@ -537,6 +571,82 @@ export interface Settings {
 	 */
 	"line-before-binary-operator"?: boolean;
 
+	/**
+	 * Whether to indent continuation lines of binary expressions.
+	 *
+	 * When enabled, if a binary expression breaks across lines, the continuation
+	 * is indented relative to the start of the expression:
+	 * @default false
+	 *
+	 * @example true
+	 * ```php
+	 * $emailNotifications = $this->stringUtils->splitStringToArray($jobPosting->getVacancyEmailNotification())
+	 *     ?? [];
+	 * ```
+	 *
+	 * @example false
+	 * ```php
+	 * $emailNotifications = $this->stringUtils->splitStringToArray($jobPosting->getVacancyEmailNotification())
+	 * ?? [];
+	 * ```
+	 */
+	"indent-binary-expression-continuation"?: boolean;
+
+	/**
+	 * Whether to omit redundant parentheses around arithmetic binary expressions under comparison and null coalesce expressions.
+	 * @default false
+	 *
+	 * @example true
+	 * ```php
+	 * if ($i === $retries - 1) {
+	 * }
+	 * ```
+	 *
+	 * @example false
+	 * ```php
+	 * if ($i === ($retries - 1)) {
+	 * }
+	 * ```
+	 */
+	"omit-redundant-arithmetic-binary-expression-parentheses"?: boolean;
+
+	/**
+	 * Whether to omit redundant parentheses around bitwise binary child expressions.
+	 * @default false
+	 *
+	 * @example true
+	 * ```php
+	 * if ($mask === $flags << 1) {
+	 * }
+	 * ```
+	 *
+	 * @example false
+	 * ```php
+	 * if ($mask === ($flags << 1)) {
+	 * }
+	 * ```
+	 */
+	"omit-redundant-bitwise-binary-expression-parentheses"?: boolean;
+
+	/**
+	 * Whether to preserve author-written parentheses around logical binary sub-expressions
+	 * even when PHP's operator precedence makes them redundant.
+	 * @default false
+	 *
+	 * @example true
+	 * ```php
+	 * if (($var1 > 200 && $var2 < 1) || ($var1 <= 200 && $var2 < 3)) {
+	 * }
+	 * ```
+	 *
+	 * @example false
+	 * ```php
+	 * if ($var1 > 200 && $var2 < 1 || $var1 <= 200 && $var2 < 3) {
+	 * }
+	 * ```
+	 */
+	"preserve-redundant-logical-binary-expression-parentheses"?: boolean;
+
 	/**
 	 * Whether to always break named argument lists into multiple lines.
 	 * @default false
@@ -566,6 +676,29 @@ export interface Settings {
 	 */
 	"always-break-attribute-named-argument-lists"?: boolean;
 
+	/**
+	 * Whether to align named arguments in multiline argument lists.
+	 * @default false
+	 *
+	 * @example true
+	 * ```php
+	 * some_function(
+	 *     short:       1,
+	 *     longerName:  2,
+	 *     longestName: 3,
+	 * );
+	 * ```
+	 */
+	"align-named-arguments"?: boolean;
+
+	/**
+	 * Whether to align multiline function and method parameter lists by the variable column.
+	 *
+	 * This is especially useful for promoted constructor properties with visibility modifiers.
+	 * @default false
+	 */
+	"align-parameters"?: boolean;
+
 	/**
 	 * Whether to use table-style alignment for arrays.
 	 * @default true

package/package.json

@@ -5,7 +5,7 @@
 		"magic-akari <akari.ccino@gmail.com>"
 	],
 	"description": "A WASM based PHP Formatter",
-	"version": "0.8.0",
+	"version": "0.10.0",
 	"license": "MIT",
 	"repository": {
 		"type": "git",