prettier-plugin-sfmc 0.1.0 → 0.2.0

package/README.md

@@ -1,6 +1,6 @@
 # prettier-plugin-sfmc
 
-Unified Prettier plugin for **Salesforce Marketing Cloud** — formats **AMPscript** (`.ampscript`, `.amp`, `.html`) and registers **SSJS** (`.ssjs`) files with Prettier's built-in JavaScript formatter.
+Unified Prettier plugin for **Salesforce Marketing Cloud** — formats **AMPscript** (`.ampscript`, `.amp`, `.html`), registers **SSJS** (`.ssjs`) with Prettier’s JavaScript formatter, and formats **SQL** (`.sql`) via embedded [prettier-plugin-sql](https://www.npmjs.com/package/prettier-plugin-sql).
 
 ## Installation
 
@@ -12,7 +12,7 @@ Requires Prettier 3.7+.
 
 ## Quick Start
 
-Prettier auto-discovers plugins installed in `node_modules`. No config needed for `.ampscript`, `.amp`, and `.ssjs` files.
+Prettier auto-discovers plugins installed in `node_modules`. No config needed for `.ampscript`, `.amp`, `.ssjs`, and `.sql` files.
 
 For `.html` files containing AMPscript, the plugin's parser handles AMPscript regions while delegating HTML to Prettier's built-in HTML formatter. SSJS `<script runat="server">` blocks are formatted as JavaScript by Prettier's HTML pipeline automatically.
 
@@ -20,7 +20,7 @@ To use explicitly in `.prettierrc`:
 
 ```json
 {
-    "plugins": ["prettier-plugin-sfmc"]
+  "plugins": ["prettier-plugin-sfmc"]
 }
 ```
 
@@ -28,25 +28,25 @@ To use explicitly in `.prettierrc`:
 
 All options use the `ampscript` prefix — they control AMPscript formatting behavior.
 
-| Option                               | Type                                                                         | Default         | Description                                    |
-| ------------------------------------ | ---------------------------------------------------------------------------- | --------------- | ---------------------------------------------- |
-| [`ampscriptSpacing`](docs/options/ampscript-spacing.md)                   | boolean                                                                      | `true`          | Spacing in inline expressions: `%%= V(@x) =%%` |
-| [`ampscriptEnforceVariableCasing`](docs/options/ampscript-enforce-variable-casing.md)     | boolean                                                                      | `true`          | Normalize variable casing to first occurrence  |
+| Option                                                                                        | Type                                                                         | Default         | Description                                    |
+| --------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | --------------- | ---------------------------------------------- |
+| [`ampscriptSpacing`](docs/options/ampscript-spacing.md)                                       | boolean                                                                      | `true`          | Spacing in inline expressions: `%%= V(@x) =%%` |
+| [`ampscriptEnforceVariableCasing`](docs/options/ampscript-enforce-variable-casing.md)         | boolean                                                                      | `true`          | Normalize variable casing to first occurrence  |
 | [`ampscriptRemoveUnnecessaryBrackets`](docs/options/ampscript-remove-unnecessary-brackets.md) | boolean                                                                      | `true`          | Remove needless parentheses                    |
-| [`ampscriptQuoteStyle`](docs/options/ampscript-quote-style.md)                | `"single"` \| `"double"`                                                     | `"single"`      | String quote style                             |
-| [`ampscriptKeywordCase`](docs/options/ampscript-keyword-case.md)               | `"lower"` \| `"upper"` \| `"preserve"`                                       | `"lower"`       | Keyword casing                                 |
-| [`ampscriptFunctionCase`](docs/options/ampscript-function-case.md)              | `"upper-camel"` \| `"lower-camel"` \| `"upper"` \| `"lower"` \| `"preserve"` | `"upper-camel"` | Function name casing                           |
-| [`ampscriptBlockLineBreaks`](docs/options/ampscript-block-line-breaks.md)           | boolean                                                                      | `true`          | Line breaks before/after `%%[ ]%%` blocks      |
-| [`ampscriptVarDeclarationStyle`](docs/options/ampscript-var-declaration-style.md)       | `"auto"` \| `"single-line"` \| `"multi-line"`                                | `"auto"`        | Var declaration formatting                     |
+| [`ampscriptQuoteStyle`](docs/options/ampscript-quote-style.md)                                | `"single"` \| `"double"`                                                     | `"single"`      | String quote style                             |
+| [`ampscriptKeywordCase`](docs/options/ampscript-keyword-case.md)                              | `"lower"` \| `"upper"` \| `"preserve"`                                       | `"lower"`       | Keyword casing                                 |
+| [`ampscriptFunctionCase`](docs/options/ampscript-function-case.md)                            | `"upper-camel"` \| `"lower-camel"` \| `"upper"` \| `"lower"` \| `"preserve"` | `"upper-camel"` | Function name casing                           |
+| [`ampscriptBlockLineBreaks`](docs/options/ampscript-block-line-breaks.md)                     | boolean                                                                      | `true`          | Line breaks before/after `%%[ ]%%` blocks      |
+| [`ampscriptVarDeclarationStyle`](docs/options/ampscript-var-declaration-style.md)             | `"auto"` \| `"single-line"` \| `"multi-line"`                                | `"multi-line"`  | Var declaration formatting                     |
 
 ### Example `.prettierrc`
 
 ```json
 {
-    "plugins": ["prettier-plugin-sfmc"],
-    "ampscriptKeywordCase": "upper",
-    "ampscriptFunctionCase": "upper-camel",
-    "ampscriptQuoteStyle": "single"
+  "plugins": ["prettier-plugin-sfmc"],
+  "ampscriptKeywordCase": "upper",
+  "ampscriptFunctionCase": "upper-camel",
+  "ampscriptQuoteStyle": "single"
 }
 ```
 
@@ -58,6 +58,45 @@ All options use the `ampscript` prefix — they control AMPscript formatting beh
 | `.amp`       | `ampscript-parse`  | Full AMPscript formatting                       |
 | `.html`      | `ampscript-parse`  | AMPscript formatted; HTML delegated to Prettier |
 | `.ssjs`      | `babel` (built-in) | Standard JavaScript formatting                  |
+| `.sql`       | `sql`              | SQL via composed `prettier-plugin-sql`          |
+
+## Core Prettier defaults (AMPscript, HTML, SQL)
+
+This plugin exports [Prettier `defaultOptions`](https://prettier.io/docs/plugins#defaultoptions). Prettier merges them when **this plugin’s printer** is active (AMPscript / embedded AMPscript in HTML, and SQL via the composed `sql` printer). They affect layout choices such as `tabWidth` and `printWidth` for those formats.
+
+| Option | Default | Rationale |
+| ------ | ------- | --------- |
+| `useTabs` | `false` | SFMC often normalizes tabs away on save; spaces keep layout stable. |
+| `tabWidth` | `4` | Readable indentation (override in config if you prefer 2). |
+| `printWidth` | `100` | Fits typical editor panes better than Prettier’s 80. |
+| `singleQuote` | `true` | Matches common JS style and `ampscriptQuoteStyle: 'single'` for AMPscript-related output where the core quote option applies. |
+| `trailingComma` | `'none'` | Avoids trailing commas in stacks where they can be problematic (notably SSJS — see below). |
+
+String delimiters inside AMPscript blocks still follow `ampscriptQuoteStyle`. See [Prettier options](https://prettier.io/docs/options) for every standard flag.
+
+### SSJS (`.ssjs`)
+
+`.ssjs` files use Prettier’s built-in **JavaScript** printer, not this plugin’s printer, so the `defaultOptions` above are **not** applied automatically to SSJS. Use `.prettierrc` (or [overrides](https://prettier.io/docs/configuration#configuration-overrides) on `*.ssjs`) if you want the same style, for example:
+
+```json
+{
+  "plugins": ["prettier-plugin-sfmc"],
+  "singleQuote": true,
+  "trailingComma": "none",
+  "tabWidth": 4,
+  "printWidth": 100
+}
+```
+
+To keep **AMPscript-only** indentation at 2 spaces while using different values for SSJS, use `overrides` keyed by file pattern.
+
+## SQL (Transact-SQL / SFMC)
+
+`.sql` formatting is provided by [prettier-plugin-sql](https://github.com/un-ts/prettier/tree/master/packages/sql) (npm: [prettier-plugin-sql](https://www.npmjs.com/package/prettier-plugin-sql)). You only need `prettier` and `prettier-plugin-sfmc`; do not add a second entry in `plugins` for SQL.
+
+**Defaults chosen for SFMC-style T-SQL:** `language` `tsql`, `formatter` `sql-formatter`, `keywordCase` / `functionCase` `upper`, `identifierCase` / `dataTypeCase` `preserve`. Override any of these in `.prettierrc` or under `overrides` with `files: "*.sql"` if needed.
+
+Core layout still follows [Prettier options](https://prettier.io/docs/options). SQL-specific knobs (`expressionWidth`, `linesBetweenQueries`, etc.) are documented in the upstream package README.
 
 ## HTML Embedding
 
@@ -69,13 +108,67 @@ When formatting `.html` files, the plugin:
 
 This means a single plugin handles all SFMC formatting in HTML email templates.
 
-## Migration from `prettier-plugin-ampscript` / `prettier-plugin-ssjs`
+## Ignoring Code
+
+Prettier provides two ways to exclude code from formatting: ignore comments for specific code sections, and `.prettierignore` for entire files.
+
+### SSJS
 
-Both plugins have been merged into this single package:
+SSJS uses Prettier's built-in JavaScript formatter. Use `// prettier-ignore` to exclude the next statement from formatting:
 
-1. Replace `prettier-plugin-ampscript` and `prettier-plugin-ssjs` with `prettier-plugin-sfmc`
-2. Update the `plugins` array in `.prettierrc` if explicitly configured
-3. All `ampscript*` option names are unchanged
+```js
+// prettier-ignore
+var config = {
+    clientId:     "abc123",
+    clientSecret: "xyz789",
+    endpoint:     "https://example.com"
+};
+```
+
+Without the comment, Prettier would collapse the aligned spacing.
+
+### AMPscript
+
+AMPscript uses block comment syntax. Use `/* prettier-ignore */` to exclude the next statement from formatting:
+
+```ampscript
+%%[
+/* prettier-ignore */
+set @matrix = Concat(
+    '1, 0, 0,',
+    '0, 1, 0,',
+    '0, 0, 1'
+)
+]%%
+```
+
+### Ignoring Files: .prettierignore
+
+To exclude entire files from formatting, create a `.prettierignore` file in the root of your project. It uses [gitignore syntax](https://git-scm.com/docs/gitignore#_pattern_format).
+
+Example:
+
+```text
+# Ignore artifacts:
+build
+coverage
+
+# Ignore all HTML files:
+**/*.html
+```
+
+By default Prettier ignores files in version control directories (`.git`, `.svn`, `.hg`) and `node_modules`. Prettier also follows rules in `.gitignore` if present.
+
+#### SMS and Mobile Messages
+
+For SMS or MobilePush messages, line breaks and exact character placement often matter for delivery and display. Excluding these files from formatting prevents Prettier from altering whitespace that affects message rendering.
+
+Example pattern for SFMC DevTools mobile message assets:
+
+```text
+# Preserve exact formatting in mobile messages
+**/*.asset-mobile-meta.amp
+```
 
 ## License
 

package/docs/options/ampscript-function-case.md

@@ -44,6 +44,30 @@ Normalises the casing of every known AMPscript function name. AMPscript function
 ]%%
 ```
 
+### `"lower-camel"`
+
+Uses the same canonical name as `"upper-camel"`, but with the first character lowercased (camelCase).
+
+**Input:**
+
+```ampscript
+%%[
+  var @result
+  set @result = LOOKUP("MyDE", "Value", "Key", @key)
+  set @html = contentblockbykey("my-block")
+]%%
+```
+
+**Output:**
+
+```ampscript
+%%[
+  var @result
+  set @result = lookup("MyDE", "Value", "Key", @key)
+  set @html = contentBlockByKey("my-block")
+]%%
+```
+
 ### `"upper"`
 
 **Output:**

package/docs/options/ampscript-var-declaration-style.md

@@ -5,22 +5,22 @@
 | | |
 |---|---|
 | **Type** | `"auto"` \| `"single-line"` \| `"multi-line"` |
-| **Default** | `"auto"` |
+| **Default** | `"multi-line"` |
 | **Applied by** | `prettier --write` · VS Code format-on-save (requires the [Prettier extension](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode)) |
 
 ## What It Controls
 
-Determines whether multiple variables in a single `var` statement are kept on one line, split to one variable per line, or left to Prettier's `printWidth` heuristic. AMPscript allows both `var @a, @b, @c` (all on one line) and separate `var` statements for each variable.
+Determines whether multiple variables in a single `var` statement stay on one line, break after each comma (still a single `var` keyword), or follow Prettier’s `printWidth` heuristic. AMPscript allows `var @a, @b, @c` on one line; this option does not split into separate `var` statements.
 
 ## Settings
 
 | Value | Effect |
 |-------|--------|
-| `"auto"` (default) | Single line when it fits within `printWidth`; one-per-line when it doesn't |
+| `"multi-line"` (default) | One `var` keyword; variables separated by comma and line breaks (indented under `var`) |
+| `"auto"` | Single line when it fits within `printWidth`; otherwise same comma-and-line-break layout as `"multi-line"` |
 | `"single-line"` | Always `var @a, @b, @c` on one line regardless of width |
-| `"multi-line"` | Always one variable per `var` statement |
 
-### `"auto"` (default)
+### `"multi-line"` (default)
 
 **Input:**
 
@@ -30,49 +30,48 @@ Determines whether multiple variables in a single `var` statement are kept on on
 ]%%
 ```
 
-**Output (when line is short enough for `printWidth`):**
+**Output** (indentation follows your Prettier `tabWidth`; shown with the plugin default of 4):
 
 ```ampscript
 %%[
-  var @firstName, @lastName, @email
+    var @firstName,
+        @lastName,
+        @email,
+        @address,
+        @city,
+        @postalCode
 ]%%
 ```
 
-**Output (when line exceeds `printWidth`):**
+### `"auto"`
+
+**Input:**
 
 ```ampscript
 %%[
-  var @firstName
-  var @lastName
-  var @email
-  var @address
-  var @city
-  var @postalCode
+  var @firstName, @lastName, @email
 ]%%
 ```
 
-### `"single-line"`
-
-**Output:**
+**Output (when the line fits within `printWidth`):**
 
 ```ampscript
 %%[
-  var @firstName, @lastName, @email, @address, @city, @postalCode
+    var @firstName, @lastName, @email
 ]%%
 ```
 
-### `"multi-line"`
+**Output (when the line exceeds `printWidth`):**
+
+Same wrapped shape as `"multi-line"`: one `var`, commas at end of lines, continuation lines indented.
+
+### `"single-line"`
 
 **Output:**
 
 ```ampscript
 %%[
-  var @firstName
-  var @lastName
-  var @email
-  var @address
-  var @city
-  var @postalCode
+    var @firstName, @lastName, @email, @address, @city, @postalCode
 ]%%
 ```
 
@@ -81,6 +80,6 @@ Determines whether multiple variables in a single `var` statement are kept on on
 ```json
 {
     "plugins": ["prettier-plugin-sfmc"],
-    "ampscriptVarDeclarationStyle": "multi-line"
+    "ampscriptVarDeclarationStyle": "auto"
 }
 ```

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "prettier-plugin-sfmc",
-    "version": "0.1.0",
-    "description": "Prettier plugin for Salesforce Marketing Cloud — AMPscript formatting and SSJS file registration",
+    "version": "0.2.0",
+    "description": "Prettier plugin for Salesforce Marketing Cloud — AMPscript, SSJS, and SQL formatting",
     "type": "module",
     "main": "src/index.js",
     "exports": {
@@ -24,12 +24,19 @@
     "author": "Joern Berkefeld",
     "scripts": {
         "example": "prettier --plugin . example.ampscript",
-        "test": "node --experimental-vm-modules ../node_modules/jest/bin/jest.js"
+        "test": "node ./scripts/run-jest.mjs",
+        "lint": "eslint .",
+        "lint:fix": "eslint --fix .",
+        "format": "prettier --write .",
+        "format:check": "prettier --check ."
     },
     "keywords": [
         "prettier",
         "ampscript",
         "ssjs",
+        "sql",
+        "tsql",
+        "transact-sql",
         "sfmc",
         "salesforce",
         "marketing-cloud",
@@ -38,14 +45,22 @@
     ],
     "license": "MIT",
     "dependencies": {
-        "ampscript-data": "^0.1.1",
-        "ampscript-parser": "^0.1.0",
-        "ssjs-data": "^0.1.0"
+        "ampscript-data": "^0.1.3",
+        "ampscript-parser": "^0.1.1",
+        "prettier-plugin-sql": "^0.20.0",
+        "ssjs-data": "^0.2.2"
     },
     "devDependencies": {
-        "jest": "^29.0.0",
+        "@eslint/js": "^10.0.1",
         "@jest/globals": "^29.0.0",
-        "prettier": "^3.7.0"
+        "eslint": "^10.1.0",
+        "eslint-config-prettier": "^10.1.8",
+        "eslint-plugin-jsdoc": "^62.0.0",
+        "eslint-plugin-prettier": "^5.5.0",
+        "eslint-plugin-unicorn": "^64.0.0",
+        "globals": "^17.4.0",
+        "jest": "^29.0.0",
+        "prettier": "^3.8.1"
     },
     "peerDependencies": {
         "prettier": ">=3.7.0"

package/src/index.js

@@ -2,17 +2,45 @@
  * prettier-plugin-sfmc
  *
  * A unified Prettier plugin for Salesforce Marketing Cloud.
- * Handles AMPscript formatting (.ampscript, .amp, .html) and
- * SSJS file registration (.ssjs).
+ * Handles AMPscript formatting (.ampscript, .amp, .html), SSJS file
+ * registration (.ssjs), and SQL (.sql) via composed prettier-plugin-sql.
  *
  * Exports: languages, parsers, printers, options, defaultOptions
  * Following the Prettier v3 plugin API (ESM).
  */
 
 import { parse } from 'ampscript-parser';
+import sqlPlugin from 'prettier-plugin-sql';
 import { printAmpscriptNode, collectVariableMap } from './printer.js';
 import * as prettier from 'prettier';
 
+/**
+ * Clone sql plugin option descriptors and set SFMC-friendly defaults.
+ *
+ * @param {Record<string, object>} sqlOptions
+ * @returns {Record<string, object>} Option map with adjusted defaults.
+ */
+function mergeSqlOptionsWithSfmcDefaults(sqlOptions) {
+    /** @type {Record<string, object>} */
+    const merged = {};
+    for (const [key, descriptor] of Object.entries(sqlOptions)) {
+        merged[key] = { ...descriptor };
+    }
+    const defaults = {
+        language: 'tsql',
+        keywordCase: 'upper',
+        functionCase: 'upper',
+        identifierCase: 'preserve',
+        dataTypeCase: 'preserve',
+    };
+    for (const [key, defaultValue] of Object.entries(defaults)) {
+        if (merged[key]) {
+            merged[key].default = defaultValue;
+        }
+    }
+    return merged;
+}
+
 // ── Languages ────────────────────────────────────────────────────────────────
 
 export const languages = [
@@ -28,6 +56,7 @@ export const languages = [
         extensions: ['.ssjs'],
         vscodeLanguageIds: ['ssjs'],
     },
+    ...sqlPlugin.languages,
 ];
 
 // ── Parsers ──────────────────────────────────────────────────────────────────
@@ -35,6 +64,7 @@ export const languages = [
 const PRAGMA_RE = /^\s*\/\*\*?\s*@(?:format|prettier)\s*\*\//;
 
 export const parsers = {
+    ...sqlPlugin.parsers,
     'ampscript-parse': {
         parse(text) {
             return parse(text);
@@ -52,7 +82,9 @@ export const parsers = {
                 const blockClose = text.indexOf(']%%', blockOpen);
                 if (blockClose !== -1) {
                     const blockContent = text.slice(blockOpen + 3, blockClose);
-                    if (PRAGMA_RE.test(blockContent)) return true;
+                    if (PRAGMA_RE.test(blockContent)) {
+                        return true;
+                    }
                 }
             }
             return PRAGMA_RE.test(text);
@@ -63,6 +95,7 @@ export const parsers = {
 // ── Printers ─────────────────────────────────────────────────────────────────
 
 export const printers = {
+    ...sqlPlugin.printers,
     'ampscript-ast': {
         print(path, options, print) {
             const node = path.node;
@@ -76,12 +109,16 @@ export const printers = {
 
         embed(path, options) {
             const node = path.node;
-            if (node.type !== 'Document') return;
+            if (node.type !== 'Document') {
+                return;
+            }
 
             const hasHtml = node.children.some(
                 (c) => c.type === 'Content' && /<[a-zA-Z!/]/.test(c.value),
             );
-            if (!hasHtml) return;
+            if (!hasHtml) {
+                return;
+            }
 
             return async (textToDocument, print) => {
                 if (!options.__ampscriptVariableMap) {
@@ -111,19 +148,27 @@ export const printers = {
 
                 const re = new RegExp(String.raw`${PH}(\d+)END`, 'g');
                 return prettier.doc.utils.mapDoc(htmlDocument, (d) => {
-                    if (typeof d !== 'string') return d;
-                    if (!d.includes(PH)) return d;
+                    if (typeof d !== 'string') {
+                        return d;
+                    }
+                    if (!d.includes(PH)) {
+                        return d;
+                    }
 
                     const parts = [];
                     let last = 0;
                     let m;
                     re.lastIndex = 0;
                     while ((m = re.exec(d)) !== null) {
-                        if (m.index > last) parts.push(d.slice(last, m.index));
+                        if (m.index > last) {
+                            parts.push(d.slice(last, m.index));
+                        }
                         parts.push(print(['children', Number.parseInt(m[1], 10)]));
                         last = m.index + m[0].length;
                     }
-                    if (last < d.length) parts.push(d.slice(last));
+                    if (last < d.length) {
+                        parts.push(d.slice(last));
+                    }
                     return parts.length === 1 ? parts[0] : parts;
                 });
             };
@@ -143,7 +188,9 @@ export const printers = {
 
         printComment(path) {
             const comment = path.node;
-            if (comment.type === 'Comment') return comment.value;
+            if (comment.type === 'Comment') {
+                return comment.value;
+            }
             return '';
         },
 
@@ -205,7 +252,7 @@ export const printers = {
 
 // ── Options ──────────────────────────────────────────────────────────────────
 
-export const options = {
+const sfmcOptions = {
     ampscriptSpacing: {
         type: 'boolean',
         category: 'AMPscript',
@@ -292,12 +339,12 @@ export const options = {
     ampscriptVarDeclarationStyle: {
         type: 'choice',
         category: 'AMPscript',
-        default: 'auto',
+        default: 'multi-line',
         choices: [
             {
                 value: 'auto',
                 description:
-                    "Let Prettier decide based on printWidth: single line when it fits, one-per-line when it doesn't.",
+                    'Let Prettier decide based on printWidth: single line when it fits, otherwise break after each comma.',
             },
             {
                 value: 'single-line',
@@ -305,16 +352,25 @@ export const options = {
             },
             {
                 value: 'multi-line',
-                description: 'Always place each variable on its own line.',
+                description:
+                    'Always break after each comma: one `var` keyword, variables listed on separate lines.',
             },
         ],
         description: 'Control how var declarations with multiple variables are formatted.',
     },
 };
 
+export const options = {
+    ...mergeSqlOptionsWithSfmcDefaults(sqlPlugin.options),
+    ...sfmcOptions,
+};
+
 // ── Default Options ──────────────────────────────────────────────────────────
 
 export const defaultOptions = {
-    tabWidth: 2,
     useTabs: false,
+    tabWidth: 4,
+    printWidth: 100,
+    singleQuote: true,
+    trailingComma: 'none',
 };

package/src/printer.js

@@ -13,12 +13,16 @@ const { group, indent, join, line, softline, hardline } = prettier.doc.builders;
 
 /**
  * Collect all variable names in first-occurrence order for consistent casing.
+ *
+ * @param node
  */
 function collectVariableMap(node) {
     const map = new Map(); // lowercase -> first-seen casing
 
     function walk(n) {
-        if (!n || typeof n !== 'object') return;
+        if (!n || typeof n !== 'object') {
+            return;
+        }
 
         if (n.type === 'Variable' && n.value) {
             const lower = n.value.toLowerCase();
@@ -27,28 +31,64 @@ function collectVariableMap(node) {
             }
         }
 
-        if (Array.isArray(n.children)) n.children.forEach(walk);
-        if (Array.isArray(n.statements)) n.statements.forEach(walk);
-        if (n.target) walk(n.target);
-        if (n.value && typeof n.value === 'object') walk(n.value);
-        if (n.expression) walk(n.expression);
-        if (n.condition) walk(n.condition);
-        if (n.left) walk(n.left);
-        if (n.right) walk(n.right);
-        if (n.argument) walk(n.argument);
-        if (Array.isArray(n.arguments)) n.arguments.forEach(walk);
-        if (Array.isArray(n.variables)) n.variables.forEach(walk);
-        if (Array.isArray(n.consequent)) n.consequent.forEach(walk);
+        if (Array.isArray(n.children)) {
+            n.children.forEach(walk);
+        }
+        if (Array.isArray(n.statements)) {
+            n.statements.forEach(walk);
+        }
+        if (n.target) {
+            walk(n.target);
+        }
+        if (n.value && typeof n.value === 'object') {
+            walk(n.value);
+        }
+        if (n.expression) {
+            walk(n.expression);
+        }
+        if (n.condition) {
+            walk(n.condition);
+        }
+        if (n.left) {
+            walk(n.left);
+        }
+        if (n.right) {
+            walk(n.right);
+        }
+        if (n.argument) {
+            walk(n.argument);
+        }
+        if (Array.isArray(n.arguments)) {
+            n.arguments.forEach(walk);
+        }
+        if (Array.isArray(n.variables)) {
+            n.variables.forEach(walk);
+        }
+        if (Array.isArray(n.consequent)) {
+            n.consequent.forEach(walk);
+        }
         if (Array.isArray(n.alternates)) {
             for (const alt of n.alternates) {
-                if (alt.condition) walk(alt.condition);
-                if (Array.isArray(alt.body)) alt.body.forEach(walk);
+                if (alt.condition) {
+                    walk(alt.condition);
+                }
+                if (Array.isArray(alt.body)) {
+                    alt.body.forEach(walk);
+                }
             }
         }
-        if (Array.isArray(n.body)) n.body.forEach(walk);
-        if (n.counter) walk(n.counter);
-        if (n.startExpr) walk(n.startExpr);
-        if (n.endExpr) walk(n.endExpr);
+        if (Array.isArray(n.body)) {
+            n.body.forEach(walk);
+        }
+        if (n.counter) {
+            walk(n.counter);
+        }
+        if (n.startExpr) {
+            walk(n.startExpr);
+        }
+        if (n.endExpr) {
+            walk(n.endExpr);
+        }
     }
 
     walk(node);
@@ -57,9 +97,13 @@ function collectVariableMap(node) {
 
 /**
  * Detect needless parentheses around a single variable or literal.
+ *
+ * @param node
  */
 function isNeedlessParenExpression(node) {
-    if (node.type !== 'ParenExpression') return false;
+    if (node.type !== 'ParenExpression') {
+        return false;
+    }
     const inner = node.expression;
     return (
         inner.type === 'Variable' ||
@@ -90,18 +134,25 @@ function getOperatorPrecedence(op) {
  * Context-aware check for whether a ParenExpression's parens can be removed.
  * Covers simple atoms, function calls, nested parens, statement-level
  * positions, and precedence-based removal inside binary expressions.
+ *
+ * @param path
+ * @param node
  */
 function canRemoveParens(path, node) {
     const inner = node.expression;
 
-    if (isNeedlessParenExpression(node)) return true;
+    if (isNeedlessParenExpression(node)) {
+        return true;
+    }
 
     if (inner.type === 'FunctionCall' || inner.type === 'ParenExpression') {
         return true;
     }
 
     const parent = path.getParentNode();
-    if (!parent) return false;
+    if (!parent) {
+        return false;
+    }
 
     const STATEMENT_PARENTS = [
         'SetStatement',
@@ -111,7 +162,9 @@ function canRemoveParens(path, node) {
         'ForStatement',
         'InlineExpression',
     ];
-    if (STATEMENT_PARENTS.includes(parent.type)) return true;
+    if (STATEMENT_PARENTS.includes(parent.type)) {
+        return true;
+    }
 
     if (parent.type === 'BinaryExpression') {
         const parentPrec = getOperatorPrecedence(parent.operator);
@@ -133,41 +186,64 @@ function canRemoveParens(path, node) {
  * processing are applied to every child node.
  *
  * @param {import("prettier").AstPath} path
- * @param {object} options  Merged Prettier + plugin options
- * @param {function} print  Prettier recursive print callback
+ * @param {object} options Merged Prettier + plugin options
+ * @param {function} print Prettier recursive print callback
  */
 function printAmpscriptNode(path, options, print) {
     const node = path.node;
-    if (!node) return '';
+    if (!node) {
+        return '';
+    }
 
     const variableMap = options.__ampscriptVariableMap || new Map();
     const enforceSpacing = options.ampscriptSpacing;
     const quoteChar = options.ampscriptQuoteStyle === 'single' ? "'" : '"';
     const enforceCasing = options.ampscriptEnforceVariableCasing;
     const removeBrackets = options.ampscriptRemoveUnnecessaryBrackets;
-    const variableStyle = options.ampscriptVarDeclarationStyle || 'auto';
+    const variableStyle = options.ampscriptVarDeclarationStyle || 'multi-line';
     const keywordCase = options.ampscriptKeywordCase || 'lower';
     const functionCase = options.ampscriptFunctionCase || 'upper-camel';
     const blockLineBreaks = options.ampscriptBlockLineBreaks !== false;
 
     function resolveVariable(variableName) {
-        if (!enforceCasing) return variableName;
+        if (!enforceCasing) {
+            return variableName;
+        }
         const lower = variableName.toLowerCase();
         return variableMap.get(lower) || variableName;
     }
 
-    /** Apply keyword casing rule. Pass originalText for preserve mode. */
+    /**
+     * Apply keyword casing rule. Pass originalText for preserve mode.
+     *
+     * @param keyword
+     * @param originalText
+     */
     function kw(keyword, originalText) {
-        if (keywordCase === 'upper') return keyword.toUpperCase();
-        if (keywordCase === 'lower') return keyword.toLowerCase();
+        if (keywordCase === 'upper') {
+            return keyword.toUpperCase();
+        }
+        if (keywordCase === 'lower') {
+            return keyword.toLowerCase();
+        }
         return originalText || keyword;
     }
 
-    /** Apply function casing rule */
+    /**
+     * Apply function casing rule
+     *
+     * @param name
+     */
     function function_(name) {
-        if (functionCase === 'preserve') return name;
-        if (functionCase === 'upper') return name.toUpperCase();
-        if (functionCase === 'lower') return name.toLowerCase();
+        if (functionCase === 'preserve') {
+            return name;
+        }
+        if (functionCase === 'upper') {
+            return name.toUpperCase();
+        }
+        if (functionCase === 'lower') {
+            return name.toLowerCase();
+        }
         const canonical = FUNCTION_CANONICAL_MAP.get(name.toLowerCase()) || name;
         if (functionCase === 'lower-camel') {
             return canonical[0].toLowerCase() + canonical.slice(1);