rawsql-ts 0.11.42-beta → 0.11.44-beta

package/dist/src/transformers/SqlPrinter.js

@@ -4,6 +4,10 @@ exports.SqlPrinter = void 0;
 const SqlPrintToken_1 = require("../models/SqlPrintToken");
 const LinePrinter_1 = require("./LinePrinter");
 const FormatOptionResolver_1 = require("./FormatOptionResolver");
+const OnelineFormattingHelper_1 = require("./OnelineFormattingHelper");
+const CREATE_TABLE_SINGLE_PAREN_KEYWORDS = new Set(['unique', 'check', 'key', 'index']);
+const CREATE_TABLE_MULTI_PAREN_KEYWORDS = new Set(['primary key', 'foreign key', 'unique key']);
+const CREATE_TABLE_PAREN_KEYWORDS_WITH_IDENTIFIER = new Set(['references']);
 /**
  * SqlPrinter formats a SqlPrintToken tree into a SQL string with flexible style options.
  *
@@ -32,6 +36,12 @@ class SqlPrinter {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u;
         /** Track whether we are currently inside a WITH clause for full-oneline formatting */
         this.insideWithClause = false;
+        /** Tracks nesting depth while formatting MERGE WHEN predicate segments */
+        this.mergeWhenPredicateDepth = 0;
+        /** Pending line comment that needs a forced newline before next token */
+        this.pendingLineCommentBreak = null;
+        /** Accumulates lines when reconstructing multi-line block comments inside CommentBlocks */
+        this.smartCommentBlockBuilder = null;
         // Resolve logical options to their control character representations before applying defaults.
         const resolvedIndentChar = (0, FormatOptionResolver_1.resolveIndentCharOption)(options === null || options === void 0 ? void 0 : options.indentChar);
         const resolvedNewline = (0, FormatOptionResolver_1.resolveNewlineOption)(options === null || options === void 0 ? void 0 : options.newline);
@@ -46,17 +56,29 @@ class SqlPrinter {
         this.andBreak = (_e = options === null || options === void 0 ? void 0 : options.andBreak) !== null && _e !== void 0 ? _e : 'none';
         this.orBreak = (_f = options === null || options === void 0 ? void 0 : options.orBreak) !== null && _f !== void 0 ? _f : 'none';
         this.keywordCase = (_g = options === null || options === void 0 ? void 0 : options.keywordCase) !== null && _g !== void 0 ? _g : 'none';
-        this.exportComment = (_h = options === null || options === void 0 ? void 0 : options.exportComment) !== null && _h !== void 0 ? _h : false;
-        this.strictCommentPlacement = (_j = options === null || options === void 0 ? void 0 : options.strictCommentPlacement) !== null && _j !== void 0 ? _j : false;
-        this.withClauseStyle = (_k = options === null || options === void 0 ? void 0 : options.withClauseStyle) !== null && _k !== void 0 ? _k : 'standard';
-        this.commentStyle = (_l = options === null || options === void 0 ? void 0 : options.commentStyle) !== null && _l !== void 0 ? _l : 'block';
-        this.parenthesesOneLine = (_m = options === null || options === void 0 ? void 0 : options.parenthesesOneLine) !== null && _m !== void 0 ? _m : false;
-        this.betweenOneLine = (_o = options === null || options === void 0 ? void 0 : options.betweenOneLine) !== null && _o !== void 0 ? _o : false;
-        this.valuesOneLine = (_p = options === null || options === void 0 ? void 0 : options.valuesOneLine) !== null && _p !== void 0 ? _p : false;
-        this.joinOneLine = (_q = options === null || options === void 0 ? void 0 : options.joinOneLine) !== null && _q !== void 0 ? _q : false;
-        this.caseOneLine = (_r = options === null || options === void 0 ? void 0 : options.caseOneLine) !== null && _r !== void 0 ? _r : false;
-        this.subqueryOneLine = (_s = options === null || options === void 0 ? void 0 : options.subqueryOneLine) !== null && _s !== void 0 ? _s : false;
-        this.indentNestedParentheses = (_t = options === null || options === void 0 ? void 0 : options.indentNestedParentheses) !== null && _t !== void 0 ? _t : false;
+        this.commentExportMode = this.resolveCommentExportMode(options === null || options === void 0 ? void 0 : options.exportComment);
+        this.withClauseStyle = (_h = options === null || options === void 0 ? void 0 : options.withClauseStyle) !== null && _h !== void 0 ? _h : 'standard';
+        this.commentStyle = (_j = options === null || options === void 0 ? void 0 : options.commentStyle) !== null && _j !== void 0 ? _j : 'block';
+        this.parenthesesOneLine = (_k = options === null || options === void 0 ? void 0 : options.parenthesesOneLine) !== null && _k !== void 0 ? _k : false;
+        this.betweenOneLine = (_l = options === null || options === void 0 ? void 0 : options.betweenOneLine) !== null && _l !== void 0 ? _l : false;
+        this.valuesOneLine = (_m = options === null || options === void 0 ? void 0 : options.valuesOneLine) !== null && _m !== void 0 ? _m : false;
+        this.joinOneLine = (_o = options === null || options === void 0 ? void 0 : options.joinOneLine) !== null && _o !== void 0 ? _o : false;
+        this.caseOneLine = (_p = options === null || options === void 0 ? void 0 : options.caseOneLine) !== null && _p !== void 0 ? _p : false;
+        this.subqueryOneLine = (_q = options === null || options === void 0 ? void 0 : options.subqueryOneLine) !== null && _q !== void 0 ? _q : false;
+        this.indentNestedParentheses = (_r = options === null || options === void 0 ? void 0 : options.indentNestedParentheses) !== null && _r !== void 0 ? _r : false;
+        this.insertColumnsOneLine = (_s = options === null || options === void 0 ? void 0 : options.insertColumnsOneLine) !== null && _s !== void 0 ? _s : false;
+        this.whenOneLine = (_t = options === null || options === void 0 ? void 0 : options.whenOneLine) !== null && _t !== void 0 ? _t : false;
+        const onelineOptions = {
+            parenthesesOneLine: this.parenthesesOneLine,
+            betweenOneLine: this.betweenOneLine,
+            valuesOneLine: this.valuesOneLine,
+            joinOneLine: this.joinOneLine,
+            caseOneLine: this.caseOneLine,
+            subqueryOneLine: this.subqueryOneLine,
+            insertColumnsOneLine: this.insertColumnsOneLine,
+            withClauseStyle: this.withClauseStyle,
+        };
+        this.onelineHelper = new OnelineFormattingHelper_1.OnelineFormattingHelper(onelineOptions);
         this.linePrinter = new LinePrinter_1.LinePrinter(this.indentChar, this.indentSize, this.newline, this.commaBreak);
         // Initialize
         this.indentIncrementContainers = new Set((_u = options === null || options === void 0 ? void 0 : options.indentIncrementContainerTypes) !== null && _u !== void 0 ? _u : [
@@ -79,7 +101,11 @@ class SqlPrinter {
             SqlPrintToken_1.SqlPrintTokenContainerType.CaseThenValue,
             SqlPrintToken_1.SqlPrintTokenContainerType.ElseClause,
             SqlPrintToken_1.SqlPrintTokenContainerType.CaseElseValue,
-            SqlPrintToken_1.SqlPrintTokenContainerType.SimpleSelectQuery
+            SqlPrintToken_1.SqlPrintTokenContainerType.SimpleSelectQuery,
+            SqlPrintToken_1.SqlPrintTokenContainerType.CreateTableDefinition,
+            SqlPrintToken_1.SqlPrintTokenContainerType.AlterTableStatement,
+            SqlPrintToken_1.SqlPrintTokenContainerType.IndexColumnList,
+            SqlPrintToken_1.SqlPrintTokenContainerType.SetClause
             // Note: CommentBlock is intentionally excluded from indentIncrementContainers
             // because it serves as a grouping mechanism without affecting indentation.
             // CaseExpression, SwitchCaseArgument, CaseKeyValuePair, and ElseClause
@@ -100,13 +126,50 @@ class SqlPrinter {
         // initialize
         this.linePrinter = new LinePrinter_1.LinePrinter(this.indentChar, this.indentSize, this.newline, this.commaBreak);
         this.insideWithClause = false; // Reset WITH clause context
+        this.pendingLineCommentBreak = null;
+        this.smartCommentBlockBuilder = null;
         if (this.linePrinter.lines.length > 0 && level !== this.linePrinter.lines[0].level) {
             this.linePrinter.lines[0].level = level;
         }
         this.appendToken(token, level, undefined, 0, false);
         return this.linePrinter.print();
     }
-    appendToken(token, level, parentContainerType, caseContextDepth = 0, indentParentActive = false) {
+    // Resolve legacy boolean values into explicit comment export modes.
+    resolveCommentExportMode(option) {
+        if (option === undefined) {
+            return 'none';
+        }
+        if (option === true) {
+            return 'full';
+        }
+        if (option === false) {
+            return 'none';
+        }
+        return option;
+    }
+    // Determine whether the current mode allows emitting inline comments.
+    rendersInlineComments() {
+        return this.commentExportMode === 'full';
+    }
+    // Decide if a comment block or token should be rendered given its context.
+    shouldRenderComment(token, context) {
+        if (context === null || context === void 0 ? void 0 : context.forceRender) {
+            return this.commentExportMode !== 'none';
+        }
+        switch (this.commentExportMode) {
+            case 'full':
+                return true;
+            case 'none':
+                return false;
+            case 'header-only':
+                return token.isHeaderComment === true;
+            case 'top-header-only':
+                return token.isHeaderComment === true && Boolean(context === null || context === void 0 ? void 0 : context.isTopLevelContainer);
+            default:
+                return false;
+        }
+    }
+    appendToken(token, level, parentContainerType, caseContextDepth = 0, indentParentActive = false, commentContext) {
         // Track WITH clause context for full-oneline formatting
         const wasInsideWithClause = this.insideWithClause;
         if (token.containerType === SqlPrintToken_1.SqlPrintTokenContainerType.WithClause && this.withClauseStyle === 'full-oneline') {
@@ -115,6 +178,71 @@ class SqlPrinter {
         if (this.shouldSkipToken(token)) {
             return;
         }
+        const containerIsTopLevel = parentContainerType === undefined;
+        let leadingCommentCount = 0;
+        // Collect leading comment blocks with context so we can respect the export mode.
+        const leadingCommentContexts = [];
+        if (token.innerTokens && token.innerTokens.length > 0) {
+            while (leadingCommentCount < token.innerTokens.length) {
+                const leadingCandidate = token.innerTokens[leadingCommentCount];
+                if (leadingCandidate.containerType !== SqlPrintToken_1.SqlPrintTokenContainerType.CommentBlock) {
+                    break;
+                }
+                const context = {
+                    position: 'leading',
+                    isTopLevelContainer: containerIsTopLevel,
+                };
+                const shouldRender = this.shouldRenderComment(leadingCandidate, context);
+                leadingCommentContexts.push({ token: leadingCandidate, context, shouldRender });
+                leadingCommentCount++;
+            }
+        }
+        const hasRenderableLeadingComment = leadingCommentContexts.some(item => item.shouldRender);
+        const leadingCommentIndentLevel = hasRenderableLeadingComment
+            ? this.getLeadingCommentIndentLevel(parentContainerType, level)
+            : null;
+        if (hasRenderableLeadingComment
+            && !this.isOnelineMode()
+            && this.shouldAddNewlineBeforeLeadingComments(parentContainerType)) {
+            const currentLine = this.linePrinter.getCurrentLine();
+            if (currentLine.text.trim().length > 0) {
+                // Align the newline before leading comments with the intended comment indentation.
+                this.linePrinter.appendNewline(leadingCommentIndentLevel !== null && leadingCommentIndentLevel !== void 0 ? leadingCommentIndentLevel : level);
+            }
+        }
+        for (const leading of leadingCommentContexts) {
+            if (!leading.shouldRender) {
+                continue;
+            }
+            // Keep leading comment processing aligned with its computed indentation level.
+            this.appendToken(leading.token, leadingCommentIndentLevel !== null && leadingCommentIndentLevel !== void 0 ? leadingCommentIndentLevel : level, token.containerType, caseContextDepth, indentParentActive, leading.context);
+        }
+        if (this.smartCommentBlockBuilder && token.containerType !== SqlPrintToken_1.SqlPrintTokenContainerType.CommentBlock && token.type !== SqlPrintToken_1.SqlPrintTokenType.commentNewline) {
+            this.flushSmartCommentBlockBuilder();
+        }
+        if (this.pendingLineCommentBreak !== null) {
+            if (!this.isOnelineMode()) {
+                this.linePrinter.appendNewline(this.pendingLineCommentBreak);
+            }
+            const shouldSkipToken = token.type === SqlPrintToken_1.SqlPrintTokenType.commentNewline;
+            this.pendingLineCommentBreak = null;
+            if (shouldSkipToken) {
+                return;
+            }
+        }
+        // Fallback context applies when the caller did not provide comment metadata.
+        const effectiveCommentContext = commentContext !== null && commentContext !== void 0 ? commentContext : {
+            position: 'inline',
+            isTopLevelContainer: containerIsTopLevel,
+        };
+        if (token.containerType === SqlPrintToken_1.SqlPrintTokenContainerType.CommentBlock) {
+            if (!this.shouldRenderComment(token, effectiveCommentContext)) {
+                return;
+            }
+            const commentLevel = this.getCommentBaseIndentLevel(level, parentContainerType);
+            this.handleCommentBlockContainer(token, commentLevel, effectiveCommentContext);
+            return;
+        }
         const current = this.linePrinter.getCurrentLine();
         const isCaseContext = this.isCaseContext(token.containerType);
         const nextCaseContextDepth = isCaseContext ? caseContextDepth + 1 : caseContextDepth;
@@ -127,7 +255,7 @@ class SqlPrinter {
             this.handleCommaToken(token, level, parentContainerType);
         }
         else if (token.type === SqlPrintToken_1.SqlPrintTokenType.parenthesis) {
-            this.handleParenthesisToken(token, level, indentParentActive);
+            this.handleParenthesisToken(token, level, indentParentActive, parentContainerType);
         }
         else if (token.type === SqlPrintToken_1.SqlPrintTokenType.operator && token.text.toLowerCase() === 'and') {
             this.handleAndOperatorToken(token, level, parentContainerType, caseContextDepth);
@@ -135,37 +263,34 @@ class SqlPrinter {
         else if (token.type === SqlPrintToken_1.SqlPrintTokenType.operator && token.text.toLowerCase() === 'or') {
             this.handleOrOperatorToken(token, level, parentContainerType, caseContextDepth);
         }
-        else if (token.containerType === "JoinClause") {
+        else if (token.containerType === SqlPrintToken_1.SqlPrintTokenContainerType.JoinClause) {
             this.handleJoinClauseToken(token, level);
         }
         else if (token.type === SqlPrintToken_1.SqlPrintTokenType.comment) {
-            // Handle comments as regular tokens - let the standard processing handle everything
-            if (this.exportComment) {
-                // Note: Smart comment processing is handled at SqlPrintTokenParser level
-                // via positioned comments system, so we don't need additional processing here
-                this.linePrinter.appendText(token.text);
+            if (this.shouldRenderComment(token, effectiveCommentContext)) {
+                const commentLevel = this.getCommentBaseIndentLevel(level, parentContainerType);
+                this.printCommentToken(token.text, commentLevel, parentContainerType);
             }
         }
         else if (token.type === SqlPrintToken_1.SqlPrintTokenType.space) {
             this.handleSpaceToken(token, parentContainerType);
         }
         else if (token.type === SqlPrintToken_1.SqlPrintTokenType.commentNewline) {
-            this.handleCommentNewlineToken(token, level);
+            if (this.whenOneLine && parentContainerType === SqlPrintToken_1.SqlPrintTokenContainerType.MergeWhenClause) {
+                return;
+            }
+            const commentLevel = this.getCommentBaseIndentLevel(level, parentContainerType);
+            this.handleCommentNewlineToken(token, commentLevel);
         }
         else if (token.containerType === SqlPrintToken_1.SqlPrintTokenContainerType.CommonTable && this.withClauseStyle === 'cte-oneline') {
             this.handleCteOnelineToken(token, level);
             return; // Return early to avoid processing innerTokens
         }
-        else if ((token.containerType === SqlPrintToken_1.SqlPrintTokenContainerType.ParenExpression && this.parenthesesOneLine && !shouldIndentNested) ||
-            (token.containerType === SqlPrintToken_1.SqlPrintTokenContainerType.BetweenExpression && this.betweenOneLine) ||
-            (token.containerType === SqlPrintToken_1.SqlPrintTokenContainerType.Values && this.valuesOneLine) ||
-            (token.containerType === SqlPrintToken_1.SqlPrintTokenContainerType.JoinOnClause && this.joinOneLine) ||
-            (token.containerType === SqlPrintToken_1.SqlPrintTokenContainerType.CaseExpression && this.caseOneLine) ||
-            (token.containerType === SqlPrintToken_1.SqlPrintTokenContainerType.InlineQuery && this.subqueryOneLine)) {
+        else if (this.shouldFormatContainerAsOneline(token, shouldIndentNested)) {
             this.handleOnelineToken(token, level);
             return; // Return early to avoid processing innerTokens
         }
-        else {
+        else if (!this.tryAppendInsertClauseTokenText(token.text, parentContainerType)) {
             this.linePrinter.appendText(token.text);
         }
         // append keyword tokens(not indented)
@@ -179,6 +304,8 @@ class SqlPrinter {
         let increasedIndent = false;
         const shouldIncreaseIndent = this.indentIncrementContainers.has(token.containerType) || shouldIndentNested;
         const delayIndentNewline = shouldIndentNested && token.containerType === SqlPrintToken_1.SqlPrintTokenContainerType.ParenExpression;
+        const isAlterTableStatement = token.containerType === SqlPrintToken_1.SqlPrintTokenContainerType.AlterTableStatement;
+        let deferAlterTableIndent = false;
         if (!this.isOnelineMode() && shouldIncreaseIndent) {
             if (this.insideWithClause && this.withClauseStyle === 'full-oneline') {
                 // Keep everything on one line for full-oneline WITH clauses.
@@ -188,15 +315,99 @@ class SqlPrinter {
                 increasedIndent = true;
             }
             else if (current.text !== '') {
-                innerLevel = level + 1;
+                if (isAlterTableStatement) {
+                    // Delay the first line break so ALTER TABLE keeps the table name on the opening line.
+                    innerLevel = level + 1;
+                    increasedIndent = true;
+                    deferAlterTableIndent = true;
+                }
+                else {
+                    let targetIndentLevel = level + 1;
+                    if (token.containerType === SqlPrintToken_1.SqlPrintTokenContainerType.SetClause &&
+                        parentContainerType === SqlPrintToken_1.SqlPrintTokenContainerType.MergeUpdateAction) {
+                        targetIndentLevel = level + 2;
+                    }
+                    if (this.shouldAlignCreateTableSelect(token.containerType, parentContainerType)) {
+                        innerLevel = level;
+                        increasedIndent = false;
+                        this.linePrinter.appendNewline(level);
+                    }
+                    else {
+                        innerLevel = targetIndentLevel;
+                        increasedIndent = true;
+                        this.linePrinter.appendNewline(innerLevel);
+                    }
+                }
+            }
+            else if (token.containerType === SqlPrintToken_1.SqlPrintTokenContainerType.SetClause) {
+                innerLevel = parentContainerType === SqlPrintToken_1.SqlPrintTokenContainerType.MergeUpdateAction ? level + 2 : level + 1;
                 increasedIndent = true;
-                this.linePrinter.appendNewline(innerLevel);
+                current.level = innerLevel;
             }
         }
-        for (let i = 0; i < token.innerTokens.length; i++) {
+        const isMergeWhenClause = this.whenOneLine && token.containerType === SqlPrintToken_1.SqlPrintTokenContainerType.MergeWhenClause;
+        let mergePredicateActive = isMergeWhenClause;
+        let alterTableTableRendered = false;
+        let alterTableIndentInserted = false;
+        for (let i = leadingCommentCount; i < token.innerTokens.length; i++) {
             const child = token.innerTokens[i];
+            const nextChild = token.innerTokens[i + 1];
+            const previousEntry = this.findPreviousSignificantToken(token.innerTokens, i);
+            const previousChild = previousEntry === null || previousEntry === void 0 ? void 0 : previousEntry.token;
+            const priorEntry = previousEntry ? this.findPreviousSignificantToken(token.innerTokens, previousEntry.index) : undefined;
+            const priorChild = priorEntry === null || priorEntry === void 0 ? void 0 : priorEntry.token;
+            const childIsAction = this.isMergeActionContainer(child);
+            const nextIsAction = this.isMergeActionContainer(nextChild);
+            const inMergePredicate = mergePredicateActive && !childIsAction;
+            if (isAlterTableStatement) {
+                if (child.containerType === SqlPrintToken_1.SqlPrintTokenContainerType.QualifiedName) {
+                    // Track when the table name has been printed so we can defer indentation until after it.
+                    alterTableTableRendered = true;
+                }
+                else if (deferAlterTableIndent && alterTableTableRendered && !alterTableIndentInserted) {
+                    if (!this.isOnelineMode()) {
+                        this.linePrinter.appendNewline(innerLevel);
+                    }
+                    alterTableIndentInserted = true;
+                    deferAlterTableIndent = false;
+                    if (!this.isOnelineMode() && child.type === SqlPrintToken_1.SqlPrintTokenType.space) {
+                        // Drop the space token because we already emitted a newline.
+                        continue;
+                    }
+                }
+            }
+            if (child.type === SqlPrintToken_1.SqlPrintTokenType.space) {
+                if (this.shouldConvertSpaceToClauseBreak(token.containerType, nextChild)) {
+                    if (!this.isOnelineMode()) {
+                        // Use a dedicated indent resolver so clause breaks can shift indentation for nested blocks.
+                        const clauseBreakIndent = this.getClauseBreakIndentLevel(token.containerType, innerLevel);
+                        this.linePrinter.appendNewline(clauseBreakIndent);
+                    }
+                    if (isMergeWhenClause && nextIsAction) {
+                        mergePredicateActive = false;
+                    }
+                    continue;
+                }
+                this.handleSpaceToken(child, token.containerType, nextChild, previousChild, priorChild);
+                continue;
+            }
             const childIndentParentActive = token.containerType === SqlPrintToken_1.SqlPrintTokenContainerType.ParenExpression ? shouldIndentNested : indentParentActive;
-            this.appendToken(child, innerLevel, token.containerType, nextCaseContextDepth, childIndentParentActive);
+            if (inMergePredicate) {
+                this.mergeWhenPredicateDepth++;
+            }
+            const childCommentContext = child.containerType === SqlPrintToken_1.SqlPrintTokenContainerType.CommentBlock
+                ? { position: 'inline', isTopLevelContainer: containerIsTopLevel }
+                : undefined;
+            this.appendToken(child, innerLevel, token.containerType, nextCaseContextDepth, childIndentParentActive, childCommentContext);
+            if (inMergePredicate) {
+                this.mergeWhenPredicateDepth--;
+            }
+            if (childIsAction && isMergeWhenClause) {
+                mergePredicateActive = false;
+            }
+        }
+        if (this.smartCommentBlockBuilder && this.smartCommentBlockBuilder.mode === 'line') {
+            this.flushSmartCommentBlockBuilder();
         }
         // Exit WITH clause context when we finish processing WithClause container
         if (token.containerType === SqlPrintToken_1.SqlPrintTokenContainerType.WithClause && this.withClauseStyle === 'full-oneline') {
@@ -246,11 +457,13 @@ class SqlPrinter {
     }
     handleKeywordToken(token, level, parentContainerType, caseContextDepth = 0) {
         const lower = token.text.toLowerCase();
-        if (lower === 'and' && this.andBreak !== 'none') {
+        if (lower === 'and' &&
+            (this.andBreak !== 'none' || (this.whenOneLine && parentContainerType === SqlPrintToken_1.SqlPrintTokenContainerType.MergeWhenClause))) {
             this.handleAndOperatorToken(token, level, parentContainerType, caseContextDepth);
             return;
         }
-        else if (lower === 'or' && this.orBreak !== 'none') {
+        else if (lower === 'or' &&
+            (this.orBreak !== 'none' || (this.whenOneLine && parentContainerType === SqlPrintToken_1.SqlPrintTokenContainerType.MergeWhenClause))) {
             this.handleOrOperatorToken(token, level, parentContainerType, caseContextDepth);
             return;
         }
@@ -259,18 +472,50 @@ class SqlPrinter {
             this.linePrinter.appendText(text);
             return;
         }
+        this.ensureSpaceBeforeKeyword();
         this.linePrinter.appendText(text);
     }
+    ensureSpaceBeforeKeyword() {
+        const currentLine = this.linePrinter.getCurrentLine();
+        if (currentLine.text === '') {
+            return;
+        }
+        const lastChar = currentLine.text[currentLine.text.length - 1];
+        if (lastChar === '(') {
+            return;
+        }
+        this.ensureTrailingSpace();
+    }
+    ensureTrailingSpace() {
+        const currentLine = this.linePrinter.getCurrentLine();
+        if (currentLine.text === '') {
+            return;
+        }
+        if (!currentLine.text.endsWith(' ')) {
+            currentLine.text += ' ';
+        }
+        currentLine.text = currentLine.text.replace(/\s+$/, ' ');
+    }
+    /**
+     * Normalizes INSERT column list token text when one-line formatting is active.
+     */
+    tryAppendInsertClauseTokenText(text, parentContainerType) {
+        const currentLineText = this.linePrinter.getCurrentLine().text;
+        const result = this.onelineHelper.formatInsertClauseToken(text, parentContainerType, currentLineText, () => this.ensureTrailingSpace());
+        if (!result.handled) {
+            return false;
+        }
+        if (result.text) {
+            this.linePrinter.appendText(result.text);
+        }
+        return true;
+    }
     handleCommaToken(token, level, parentContainerType) {
         const text = token.text;
         const isWithinWithClause = parentContainerType === SqlPrintToken_1.SqlPrintTokenContainerType.WithClause;
-        const isWithinValuesClause = parentContainerType === SqlPrintToken_1.SqlPrintTokenContainerType.Values;
-        let effectiveCommaBreak = this.commaBreak;
-        if (isWithinWithClause) {
-            effectiveCommaBreak = this.cteCommaBreak;
-        }
-        else if (isWithinValuesClause) {
-            effectiveCommaBreak = this.valuesCommaBreak;
+        let effectiveCommaBreak = this.onelineHelper.resolveCommaBreak(parentContainerType, this.commaBreak, this.cteCommaBreak, this.valuesCommaBreak);
+        if (parentContainerType === SqlPrintToken_1.SqlPrintTokenContainerType.SetClause) {
+            effectiveCommaBreak = 'before';
         }
         // Skip comma newlines when inside WITH clause with full-oneline style
         if (this.insideWithClause && this.withClauseStyle === 'full-oneline') {
@@ -288,6 +533,14 @@ class SqlPrinter {
             }
             if (!(this.insideWithClause && this.withClauseStyle === 'full-oneline')) {
                 this.linePrinter.appendNewline(level);
+                if (this.newline === ' ') {
+                    // Remove the spacer introduced by space newlines so commas attach directly to the preceding token.
+                    this.linePrinter.trimTrailingWhitespaceFromPreviousLine();
+                }
+                if (parentContainerType === SqlPrintToken_1.SqlPrintTokenContainerType.InsertClause) {
+                    // Align comma-prefixed column entries under the INSERT column indentation.
+                    this.linePrinter.getCurrentLine().level = level + 1;
+                }
             }
             this.linePrinter.appendText(text);
             if (previousCommaBreak !== 'before') {
@@ -299,6 +552,9 @@ class SqlPrinter {
             if (previousCommaBreak !== 'after') {
                 this.linePrinter.commaBreak = 'after';
             }
+            if (!(this.insideWithClause && this.withClauseStyle === 'full-oneline')) {
+                this.linePrinter.appendNewline(level);
+            }
             this.linePrinter.appendText(text);
             if (!(this.insideWithClause && this.withClauseStyle === 'full-oneline')) {
                 this.linePrinter.appendNewline(level);
@@ -313,6 +569,9 @@ class SqlPrinter {
                 this.linePrinter.commaBreak = 'none';
             }
             this.linePrinter.appendText(text);
+            if (this.onelineHelper.isInsertClauseOneline(parentContainerType)) {
+                this.ensureTrailingSpace();
+            }
             if (previousCommaBreak !== 'none') {
                 this.linePrinter.commaBreak = previousCommaBreak;
             }
@@ -327,6 +586,11 @@ class SqlPrinter {
             this.linePrinter.appendText(text);
             return;
         }
+        if (this.whenOneLine &&
+            (parentContainerType === SqlPrintToken_1.SqlPrintTokenContainerType.MergeWhenClause || this.mergeWhenPredicateDepth > 0)) {
+            this.linePrinter.appendText(text);
+            return;
+        }
         if (this.andBreak === 'before') {
             // Skip newline when inside WITH clause with full-oneline style
             if (!(this.insideWithClause && this.withClauseStyle === 'full-oneline')) {
@@ -345,20 +609,32 @@ class SqlPrinter {
             this.linePrinter.appendText(text);
         }
     }
-    handleParenthesisToken(token, level, indentParentActive) {
+    handleParenthesisToken(token, level, indentParentActive, parentContainerType) {
         if (token.text === '(') {
             this.linePrinter.appendText(token.text);
-            if (indentParentActive && !this.isOnelineMode()) {
-                if (!(this.insideWithClause && this.withClauseStyle === 'full-oneline')) {
+            if ((parentContainerType === SqlPrintToken_1.SqlPrintTokenContainerType.InsertClause ||
+                parentContainerType === SqlPrintToken_1.SqlPrintTokenContainerType.MergeInsertAction) &&
+                this.insertColumnsOneLine) {
+                return;
+            }
+            if (!this.isOnelineMode()) {
+                if (this.shouldBreakAfterOpeningParen(parentContainerType)) {
+                    this.linePrinter.appendNewline(level + 1);
+                }
+                else if (indentParentActive && !(this.insideWithClause && this.withClauseStyle === 'full-oneline')) {
                     this.linePrinter.appendNewline(level);
                 }
             }
             return;
         }
-        if (token.text === ')' && indentParentActive && !this.isOnelineMode()) {
-            // Align closing parenthesis with the outer indentation level when nested groups expand.
-            const closingLevel = Math.max(level - 1, 0);
-            if (!(this.insideWithClause && this.withClauseStyle === 'full-oneline')) {
+        if (token.text === ')' && !this.isOnelineMode()) {
+            if (this.shouldBreakBeforeClosingParen(parentContainerType)) {
+                this.linePrinter.appendNewline(Math.max(level, 0));
+                this.linePrinter.appendText(token.text);
+                return;
+            }
+            if (indentParentActive && !(this.insideWithClause && this.withClauseStyle === 'full-oneline')) {
+                const closingLevel = Math.max(level - 1, 0);
                 this.linePrinter.appendNewline(closingLevel);
             }
         }
@@ -371,6 +647,11 @@ class SqlPrinter {
             this.linePrinter.appendText(text);
             return;
         }
+        if (this.whenOneLine &&
+            (parentContainerType === SqlPrintToken_1.SqlPrintTokenContainerType.MergeWhenClause || this.mergeWhenPredicateDepth > 0)) {
+            this.linePrinter.appendText(text);
+            return;
+        }
         if (this.orBreak === 'before') {
             // Insert a newline before OR unless WITH full-oneline mode suppresses breaks.
             if (!(this.insideWithClause && this.withClauseStyle === 'full-oneline')) {
@@ -420,34 +701,490 @@ class SqlPrinter {
     }
     handleJoinClauseToken(token, level) {
         const text = this.applyKeywordCase(token.text);
-        // before join clause, add newline (skip when inside WITH clause with full-oneline style)
-        if (!(this.insideWithClause && this.withClauseStyle === 'full-oneline')) {
+        // before join clause, add newline when multiline formatting is allowed
+        if (this.onelineHelper.shouldInsertJoinNewline(this.insideWithClause)) {
             this.linePrinter.appendNewline(level);
         }
         this.linePrinter.appendText(text);
     }
+    /**
+     * Decides whether the current container should collapse into a single line.
+     */
+    shouldFormatContainerAsOneline(token, shouldIndentNested) {
+        return this.onelineHelper.shouldFormatContainer(token, shouldIndentNested);
+    }
+    /**
+     * Detects an INSERT column list that must stay on a single line.
+     */
+    isInsertClauseOneline(parentContainerType) {
+        return this.onelineHelper.isInsertClauseOneline(parentContainerType);
+    }
     /**
      * Handles space tokens with context-aware filtering.
      * Skips spaces in CommentBlocks when in specific CTE modes to prevent duplication.
      */
-    handleSpaceToken(token, parentContainerType) {
-        if (this.shouldSkipCommentBlockSpace(parentContainerType)) {
+    handleSpaceToken(token, parentContainerType, nextToken, previousToken, priorToken) {
+        if (this.smartCommentBlockBuilder && this.smartCommentBlockBuilder.mode === 'line') {
+            this.flushSmartCommentBlockBuilder();
+        }
+        const currentLineText = this.linePrinter.getCurrentLine().text;
+        if (this.onelineHelper.shouldSkipInsertClauseSpace(parentContainerType, nextToken, currentLineText)) {
+            return;
+        }
+        if (this.onelineHelper.shouldSkipCommentBlockSpace(parentContainerType, this.insideWithClause)) {
             const currentLine = this.linePrinter.getCurrentLine();
             if (currentLine.text !== '' && !currentLine.text.endsWith(' ')) {
                 this.linePrinter.appendText(' ');
             }
             return;
         }
+        // Skip redundant spaces before structural parentheses in CREATE TABLE DDL.
+        if (this.shouldSkipSpaceBeforeParenthesis(parentContainerType, nextToken, previousToken, priorToken)) {
+            return;
+        }
         this.linePrinter.appendText(token.text);
     }
-    /**
-     * Determines whether to skip space tokens in CommentBlocks.
-     * Prevents duplicate spacing in CTE full-oneline mode only.
-     */
-    shouldSkipCommentBlockSpace(parentContainerType) {
-        return parentContainerType === SqlPrintToken_1.SqlPrintTokenContainerType.CommentBlock &&
-            this.insideWithClause &&
-            this.withClauseStyle === 'full-oneline';
+    findPreviousSignificantToken(tokens, index) {
+        for (let i = index - 1; i >= 0; i--) {
+            const candidate = tokens[i];
+            if (candidate.type === SqlPrintToken_1.SqlPrintTokenType.space || candidate.type === SqlPrintToken_1.SqlPrintTokenType.commentNewline) {
+                continue;
+            }
+            if (candidate.type === SqlPrintToken_1.SqlPrintTokenType.comment && !this.rendersInlineComments()) {
+                continue;
+            }
+            return { token: candidate, index: i };
+        }
+        return undefined;
+    }
+    shouldSkipSpaceBeforeParenthesis(parentContainerType, nextToken, previousToken, priorToken) {
+        if (!nextToken || nextToken.type !== SqlPrintToken_1.SqlPrintTokenType.parenthesis || nextToken.text !== '(') {
+            return false;
+        }
+        if (!parentContainerType || !this.isCreateTableSpacingContext(parentContainerType)) {
+            return false;
+        }
+        if (!previousToken) {
+            return false;
+        }
+        if (this.isCreateTableNameToken(previousToken, parentContainerType)) {
+            return true;
+        }
+        if (this.isCreateTableConstraintKeyword(previousToken, parentContainerType)) {
+            return true;
+        }
+        if (priorToken && this.isCreateTableConstraintKeyword(priorToken, parentContainerType)) {
+            if (this.isIdentifierAttachedToConstraint(previousToken, priorToken, parentContainerType)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    shouldAlignCreateTableSelect(containerType, parentContainerType) {
+        return containerType === SqlPrintToken_1.SqlPrintTokenContainerType.SimpleSelectQuery &&
+            parentContainerType === SqlPrintToken_1.SqlPrintTokenContainerType.CreateTableQuery;
+    }
+    isCreateTableSpacingContext(parentContainerType) {
+        switch (parentContainerType) {
+            case SqlPrintToken_1.SqlPrintTokenContainerType.CreateTableQuery:
+            case SqlPrintToken_1.SqlPrintTokenContainerType.CreateTableDefinition:
+            case SqlPrintToken_1.SqlPrintTokenContainerType.TableConstraintDefinition:
+            case SqlPrintToken_1.SqlPrintTokenContainerType.ColumnConstraintDefinition:
+            case SqlPrintToken_1.SqlPrintTokenContainerType.ReferenceDefinition:
+                return true;
+            default:
+                return false;
+        }
+    }
+    isCreateTableNameToken(previousToken, parentContainerType) {
+        if (parentContainerType !== SqlPrintToken_1.SqlPrintTokenContainerType.CreateTableQuery) {
+            return false;
+        }
+        return previousToken.containerType === SqlPrintToken_1.SqlPrintTokenContainerType.QualifiedName;
+    }
+    isCreateTableConstraintKeyword(token, parentContainerType) {
+        if (token.type !== SqlPrintToken_1.SqlPrintTokenType.keyword) {
+            return false;
+        }
+        const text = token.text.toLowerCase();
+        if (parentContainerType === SqlPrintToken_1.SqlPrintTokenContainerType.ReferenceDefinition) {
+            return CREATE_TABLE_PAREN_KEYWORDS_WITH_IDENTIFIER.has(text);
+        }
+        if (CREATE_TABLE_SINGLE_PAREN_KEYWORDS.has(text)) {
+            return true;
+        }
+        if (CREATE_TABLE_MULTI_PAREN_KEYWORDS.has(text)) {
+            return true;
+        }
+        return false;
+    }
+    isIdentifierAttachedToConstraint(token, keywordToken, parentContainerType) {
+        if (!token) {
+            return false;
+        }
+        if (parentContainerType === SqlPrintToken_1.SqlPrintTokenContainerType.ReferenceDefinition) {
+            return token.containerType === SqlPrintToken_1.SqlPrintTokenContainerType.QualifiedName &&
+                CREATE_TABLE_PAREN_KEYWORDS_WITH_IDENTIFIER.has(keywordToken.text.toLowerCase());
+        }
+        if (parentContainerType === SqlPrintToken_1.SqlPrintTokenContainerType.TableConstraintDefinition ||
+            parentContainerType === SqlPrintToken_1.SqlPrintTokenContainerType.ColumnConstraintDefinition) {
+            const normalized = keywordToken.text.toLowerCase();
+            if (CREATE_TABLE_SINGLE_PAREN_KEYWORDS.has(normalized) ||
+                CREATE_TABLE_MULTI_PAREN_KEYWORDS.has(normalized)) {
+                return token.containerType === SqlPrintToken_1.SqlPrintTokenContainerType.IdentifierString;
+            }
+        }
+        return false;
+    }
+    printCommentToken(text, level, parentContainerType) {
+        const trimmed = text.trim();
+        if (!trimmed) {
+            return;
+        }
+        if (this.commentStyle === 'smart' && parentContainerType === SqlPrintToken_1.SqlPrintTokenContainerType.CommentBlock) {
+            if (this.handleSmartCommentBlockToken(text, trimmed, level)) {
+                return;
+            }
+        }
+        if (this.commentStyle === 'smart') {
+            const normalized = this.normalizeCommentForSmart(trimmed);
+            if (normalized.lines.length > 1 || normalized.forceBlock) {
+                const blockText = this.buildBlockComment(normalized.lines, level);
+                this.linePrinter.appendText(blockText);
+            }
+            else {
+                const content = normalized.lines[0];
+                const lineText = content ? `-- ${content}` : '--';
+                if (parentContainerType === SqlPrintToken_1.SqlPrintTokenContainerType.CommentBlock) {
+                    this.linePrinter.appendText(lineText);
+                    this.pendingLineCommentBreak = this.resolveCommentIndentLevel(level, parentContainerType);
+                }
+                else {
+                    this.linePrinter.appendText(lineText);
+                    const effectiveLevel = this.resolveCommentIndentLevel(level, parentContainerType);
+                    this.linePrinter.appendNewline(effectiveLevel);
+                }
+            }
+        }
+        else {
+            if (trimmed.startsWith('/*') && trimmed.endsWith('*/')) {
+                if (/\r?\n/.test(trimmed)) {
+                    // Keep multi-line block comments intact by normalizing line endings once.
+                    const newlineReplacement = this.isOnelineMode() ? ' ' : (typeof this.newline === 'string' ? this.newline : '\n');
+                    const normalized = trimmed.replace(/\r?\n/g, newlineReplacement);
+                    this.linePrinter.appendText(normalized);
+                }
+                else {
+                    this.linePrinter.appendText(trimmed);
+                }
+            }
+            else {
+                this.linePrinter.appendText(trimmed);
+            }
+            if (trimmed.startsWith('--')) {
+                if (parentContainerType === SqlPrintToken_1.SqlPrintTokenContainerType.CommentBlock) {
+                    this.pendingLineCommentBreak = this.resolveCommentIndentLevel(level, parentContainerType);
+                }
+                else {
+                    const effectiveLevel = this.resolveCommentIndentLevel(level, parentContainerType);
+                    this.linePrinter.appendNewline(effectiveLevel);
+                }
+            }
+        }
+    }
+    handleSmartCommentBlockToken(raw, trimmed, level) {
+        if (!this.smartCommentBlockBuilder) {
+            if (trimmed === '/*') {
+                // Begin assembling a multi-line block comment that is emitted as split tokens
+                this.smartCommentBlockBuilder = { lines: [], level, mode: 'block' };
+                return true;
+            }
+            const lineContent = this.extractLineCommentContent(trimmed);
+            if (lineContent !== null) {
+                this.smartCommentBlockBuilder = {
+                    lines: [lineContent],
+                    level,
+                    mode: 'line',
+                };
+                return true;
+            }
+            return false;
+        }
+        if (this.smartCommentBlockBuilder.mode === 'block') {
+            if (trimmed === '*/') {
+                const { lines, level: blockLevel } = this.smartCommentBlockBuilder;
+                const blockText = this.buildBlockComment(lines, blockLevel);
+                this.linePrinter.appendText(blockText);
+                this.pendingLineCommentBreak = blockLevel;
+                this.smartCommentBlockBuilder = null;
+                return true;
+            }
+            this.smartCommentBlockBuilder.lines.push(this.normalizeSmartBlockLine(raw));
+            return true;
+        }
+        const content = this.extractLineCommentContent(trimmed);
+        if (content !== null) {
+            this.smartCommentBlockBuilder.lines.push(content);
+            return true;
+        }
+        this.flushSmartCommentBlockBuilder();
+        return false;
+    }
+    handleCommentBlockContainer(token, level, context) {
+        var _a;
+        if (this.commentStyle !== 'smart') {
+            const rawLines = this.extractRawCommentBlockLines(token);
+            if (rawLines.length > 0) {
+                const normalizedBlocks = rawLines.map(line => `/* ${line} */`).join(' ');
+                const hasTrailingSpace = (_a = token.innerTokens) === null || _a === void 0 ? void 0 : _a.some(child => child.type === SqlPrintToken_1.SqlPrintTokenType.space && child.text.includes(' '));
+                this.linePrinter.appendText(hasTrailingSpace ? `${normalizedBlocks} ` : normalizedBlocks);
+                return;
+            }
+            for (const child of token.innerTokens) {
+                // Force inner comment tokens to render once the block is approved.
+                const childContext = {
+                    position: context.position,
+                    isTopLevelContainer: context.isTopLevelContainer,
+                    forceRender: true,
+                };
+                this.appendToken(child, level, token.containerType, 0, false, childContext);
+            }
+            return;
+        }
+        const lines = this.collectCommentBlockLines(token);
+        if (lines.length === 0 && !this.smartCommentBlockBuilder) {
+            // No meaningful content; treat as empty line comment to preserve spacing
+            this.smartCommentBlockBuilder = {
+                lines: [''],
+                level,
+                mode: 'line',
+            };
+            return;
+        }
+        if (!this.smartCommentBlockBuilder || this.smartCommentBlockBuilder.mode !== 'line') {
+            this.smartCommentBlockBuilder = {
+                lines: [...lines],
+                level,
+                mode: 'line',
+            };
+        }
+        else {
+            this.smartCommentBlockBuilder.lines.push(...lines);
+        }
+    }
+    normalizeSmartBlockLine(raw) {
+        // Remove trailing whitespace that only carries formatting artifacts
+        let line = raw.replace(/\s+$/g, '');
+        if (!line) {
+            return '';
+        }
+        if (line.startsWith('  ')) {
+            line = line.slice(2);
+        }
+        if (line.startsWith('* ')) {
+            return line.slice(2);
+        }
+        if (line === '*') {
+            return '';
+        }
+        if (line.startsWith('*')) {
+            return line.slice(1);
+        }
+        return line;
+    }
+    extractLineCommentContent(trimmed) {
+        if (trimmed.startsWith('--')) {
+            return trimmed.slice(2).trimStart();
+        }
+        if (trimmed.startsWith('/*') && trimmed.endsWith('*/')) {
+            const inner = trimmed.slice(2, -2).trim();
+            return inner;
+        }
+        return null;
+    }
+    flushSmartCommentBlockBuilder() {
+        var _a;
+        if (!this.smartCommentBlockBuilder) {
+            return;
+        }
+        const { lines, level, mode } = this.smartCommentBlockBuilder;
+        if (mode === 'line') {
+            const meaningfulLineCount = lines.filter(line => line.trim() !== '').length;
+            if (meaningfulLineCount > 1) {
+                const blockText = this.buildBlockComment(lines, level);
+                this.linePrinter.appendText(blockText);
+            }
+            else {
+                const content = (_a = lines[0]) !== null && _a !== void 0 ? _a : '';
+                const lineText = content ? `-- ${content}` : '--';
+                this.linePrinter.appendText(lineText);
+            }
+            if (!this.isOnelineMode()) {
+                this.linePrinter.appendNewline(level);
+            }
+            this.pendingLineCommentBreak = null;
+        }
+        this.smartCommentBlockBuilder = null;
+    }
+    collectCommentBlockLines(token) {
+        var _a;
+        const lines = [];
+        let collectingBlock = false;
+        for (const child of (_a = token.innerTokens) !== null && _a !== void 0 ? _a : []) {
+            if (child.type === SqlPrintToken_1.SqlPrintTokenType.comment) {
+                const trimmed = child.text.trim();
+                if (trimmed === '/*') {
+                    collectingBlock = true;
+                    continue;
+                }
+                if (trimmed === '*/') {
+                    collectingBlock = false;
+                    continue;
+                }
+                if (collectingBlock) {
+                    lines.push(this.normalizeSmartBlockLine(child.text));
+                    continue;
+                }
+                const content = this.extractLineCommentContent(trimmed);
+                if (content !== null) {
+                    lines.push(content);
+                }
+            }
+        }
+        return lines;
+    }
+    extractRawCommentBlockLines(token) {
+        var _a;
+        const lines = [];
+        let collectingBlock = false;
+        for (const child of (_a = token.innerTokens) !== null && _a !== void 0 ? _a : []) {
+            if (child.type === SqlPrintToken_1.SqlPrintTokenType.comment) {
+                const text = child.text;
+                const trimmed = text.trim();
+                if (trimmed === '/*') {
+                    collectingBlock = true;
+                    continue;
+                }
+                if (trimmed === '*/') {
+                    collectingBlock = false;
+                    continue;
+                }
+                if (collectingBlock) {
+                    if (trimmed.length > 0) {
+                        lines.push(trimmed);
+                    }
+                    continue;
+                }
+            }
+        }
+        return lines;
+    }
+    normalizeCommentForSmart(text) {
+        const trimmed = text.trim();
+        let source = trimmed;
+        let forceBlock = false;
+        if (trimmed.startsWith('--')) {
+            source = trimmed.slice(2);
+        }
+        else if (trimmed.startsWith('/*') && trimmed.endsWith('*/')) {
+            const inner = trimmed.slice(2, -2);
+            const normalizedInner = inner.replace(/\r?\n/g, '\n');
+            if (normalizedInner.includes('\n')) {
+                forceBlock = true;
+                source = inner;
+            }
+            else {
+                source = inner;
+                if (!source.trim()) {
+                    source = trimmed;
+                }
+            }
+        }
+        const escaped = this.escapeCommentDelimiters(source);
+        const normalized = escaped.replace(/\r?\n/g, '\n');
+        const rawSegments = normalized.split('\n');
+        const processedLines = [];
+        const processedRaw = [];
+        for (const segment of rawSegments) {
+            const rawTrimmed = segment.trim();
+            const sanitized = this.sanitizeCommentLine(segment);
+            if (sanitized.length > 0) {
+                processedLines.push(sanitized);
+                processedRaw.push(rawTrimmed);
+            }
+        }
+        let lines = processedLines;
+        if (lines.length === 0) {
+            lines = [''];
+        }
+        if (!forceBlock && lines.length === 1 && !lines[0] && trimmed.startsWith('/*') && trimmed.endsWith('*/')) {
+            const escapedFull = this.escapeCommentDelimiters(trimmed);
+            lines = [this.sanitizeCommentLine(escapedFull)];
+        }
+        if (!forceBlock && lines.length > 1) {
+            forceBlock = true;
+        }
+        lines = lines.map((line, index) => {
+            var _a;
+            if (/^[-=_+*#]+$/.test(line)) {
+                const rawLine = (_a = processedRaw[index]) !== null && _a !== void 0 ? _a : line;
+                const normalizedRaw = rawLine.replace(/\s+/g, '');
+                if (normalizedRaw.length >= line.length) {
+                    return normalizedRaw;
+                }
+            }
+            return line;
+        });
+        return { lines, forceBlock };
+    }
+    buildBlockComment(lines, level) {
+        var _a, _b, _c;
+        if (lines.length <= 1) {
+            const content = (_a = lines[0]) !== null && _a !== void 0 ? _a : '';
+            return content ? `/* ${content} */` : '/* */';
+        }
+        const newline = this.newline === ' ' ? '\n' : this.newline;
+        const currentLevel = (_c = (_b = this.linePrinter.getCurrentLine()) === null || _b === void 0 ? void 0 : _b.level) !== null && _c !== void 0 ? _c : level;
+        const baseIndent = this.getIndentString(currentLevel);
+        const unitIndent = '  ';
+        const innerIndent = baseIndent + unitIndent;
+        const body = lines.map(line => `${innerIndent}${line}`).join(newline);
+        const closing = `${baseIndent}*/`;
+        return `/*${newline}${body}${newline}${closing}`;
+    }
+    getIndentString(level) {
+        if (level <= 0) {
+            return '';
+        }
+        if (this.indentSize <= 0) {
+            return '  '.repeat(level);
+        }
+        const unit = typeof this.indentChar === 'string' ? this.indentChar : '';
+        return unit.repeat(this.indentSize * level);
+    }
+    sanitizeCommentLine(content) {
+        let sanitized = content;
+        sanitized = sanitized.replace(/\u2028|\u2029/g, ' ');
+        sanitized = sanitized.replace(/\s+/g, ' ').trim();
+        return sanitized;
+    }
+    escapeCommentDelimiters(content) {
+        return content
+            .replace(/\/\*/g, '\\/\\*')
+            .replace(/\*\//g, '*\\/');
+    }
+    getCommentBaseIndentLevel(level, parentContainerType) {
+        if (!parentContainerType) {
+            return level;
+        }
+        const clauseAlignedLevel = this.getClauseBreakIndentLevel(parentContainerType, level);
+        return Math.max(level, clauseAlignedLevel);
+    }
+    resolveCommentIndentLevel(level, parentContainerType) {
+        var _a;
+        const baseLevel = this.getCommentBaseIndentLevel(level, parentContainerType);
+        const currentLevel = (_a = this.linePrinter.getCurrentLine().level) !== null && _a !== void 0 ? _a : baseLevel;
+        return Math.max(baseLevel, currentLevel);
     }
     /**
      * Handles commentNewline tokens with conditional newline behavior.
@@ -456,6 +1193,14 @@ class SqlPrinter {
      * Skips newlines in CTE modes (full-oneline, cte-oneline) to maintain one-line format.
      */
     handleCommentNewlineToken(token, level) {
+        if (this.smartCommentBlockBuilder) {
+            return;
+        }
+        if (this.pendingLineCommentBreak !== null) {
+            this.linePrinter.appendNewline(this.pendingLineCommentBreak);
+            this.pendingLineCommentBreak = null;
+            return;
+        }
         if (this.shouldSkipCommentNewline()) {
             return;
         }
@@ -471,6 +1216,39 @@ class SqlPrinter {
         return (this.insideWithClause && this.withClauseStyle === 'full-oneline') ||
             this.withClauseStyle === 'cte-oneline';
     }
+    shouldAddNewlineBeforeLeadingComments(parentType) {
+        if (!parentType) {
+            return false;
+        }
+        if (parentType === SqlPrintToken_1.SqlPrintTokenContainerType.TupleExpression) {
+            return true;
+        }
+        if (parentType === SqlPrintToken_1.SqlPrintTokenContainerType.InsertClause ||
+            parentType === SqlPrintToken_1.SqlPrintTokenContainerType.MergeInsertAction) {
+            return !this.insertColumnsOneLine;
+        }
+        if (parentType === SqlPrintToken_1.SqlPrintTokenContainerType.SetClause) {
+            return true;
+        }
+        if (parentType === SqlPrintToken_1.SqlPrintTokenContainerType.SelectClause) {
+            return true;
+        }
+        return false;
+    }
+    getLeadingCommentIndentLevel(parentType, currentLevel) {
+        if (parentType === SqlPrintToken_1.SqlPrintTokenContainerType.TupleExpression) {
+            return currentLevel + 1;
+        }
+        if (parentType === SqlPrintToken_1.SqlPrintTokenContainerType.InsertClause ||
+            parentType === SqlPrintToken_1.SqlPrintTokenContainerType.MergeInsertAction ||
+            parentType === SqlPrintToken_1.SqlPrintTokenContainerType.SelectClause) {
+            return currentLevel + 1;
+        }
+        if (parentType === SqlPrintToken_1.SqlPrintTokenContainerType.SetClause) {
+            return currentLevel + 1;
+        }
+        return currentLevel;
+    }
     /**
      * Determines if the printer is in oneliner mode.
      * Oneliner mode uses single spaces instead of actual newlines.
@@ -503,10 +1281,10 @@ class SqlPrinter {
             andBreak: this.andBreak,
             orBreak: this.orBreak,
             keywordCase: this.keywordCase,
-            exportComment: false,
-            strictCommentPlacement: this.strictCommentPlacement,
+            exportComment: 'none',
             withClauseStyle: 'standard', // Prevent recursive processing
             indentNestedParentheses: false,
+            insertColumnsOneLine: this.insertColumnsOneLine,
         });
     }
     /**
@@ -519,6 +1297,117 @@ class SqlPrinter {
         const cleanedResult = this.cleanDuplicateSpaces(onelineResult);
         this.linePrinter.appendText(cleanedResult);
     }
+    getClauseBreakIndentLevel(parentType, level) {
+        if (!parentType) {
+            return level;
+        }
+        switch (parentType) {
+            case SqlPrintToken_1.SqlPrintTokenContainerType.MergeWhenClause:
+                // Actions under WHEN clauses should be indented one level deeper than the WHEN line.
+                return level + 1;
+            case SqlPrintToken_1.SqlPrintTokenContainerType.MergeUpdateAction:
+            case SqlPrintToken_1.SqlPrintTokenContainerType.MergeDeleteAction:
+            case SqlPrintToken_1.SqlPrintTokenContainerType.MergeInsertAction:
+                // Keep MERGE actions and their follow-up keywords (e.g., VALUES, WHERE) aligned with the action keyword.
+                return level + 1;
+            default:
+                return level;
+        }
+    }
+    isMergeActionContainer(token) {
+        if (!token) {
+            return false;
+        }
+        switch (token.containerType) {
+            case SqlPrintToken_1.SqlPrintTokenContainerType.MergeUpdateAction:
+            case SqlPrintToken_1.SqlPrintTokenContainerType.MergeDeleteAction:
+            case SqlPrintToken_1.SqlPrintTokenContainerType.MergeInsertAction:
+            case SqlPrintToken_1.SqlPrintTokenContainerType.MergeDoNothingAction:
+                return true;
+            default:
+                return false;
+        }
+    }
+    shouldBreakAfterOpeningParen(parentType) {
+        if (!parentType) {
+            return false;
+        }
+        if (parentType === SqlPrintToken_1.SqlPrintTokenContainerType.InsertClause ||
+            parentType === SqlPrintToken_1.SqlPrintTokenContainerType.MergeInsertAction) {
+            return !this.isInsertClauseOneline(parentType);
+        }
+        return false;
+    }
+    shouldBreakBeforeClosingParen(parentType) {
+        if (!parentType) {
+            return false;
+        }
+        if (parentType === SqlPrintToken_1.SqlPrintTokenContainerType.InsertClause ||
+            parentType === SqlPrintToken_1.SqlPrintTokenContainerType.MergeInsertAction) {
+            return !this.isInsertClauseOneline(parentType);
+        }
+        return false;
+    }
+    shouldConvertSpaceToClauseBreak(parentType, nextToken) {
+        if (!parentType || !nextToken) {
+            return false;
+        }
+        const nextKeyword = nextToken.type === SqlPrintToken_1.SqlPrintTokenType.keyword ? nextToken.text.toLowerCase() : null;
+        const nextContainer = nextToken.containerType;
+        if (parentType === SqlPrintToken_1.SqlPrintTokenContainerType.MergeQuery) {
+            // Break before USING blocks and before each WHEN clause to mirror statement structure.
+            if (nextKeyword === 'using') {
+                return true;
+            }
+            if (nextContainer === SqlPrintToken_1.SqlPrintTokenContainerType.MergeWhenClause) {
+                return true;
+            }
+        }
+        if (parentType === SqlPrintToken_1.SqlPrintTokenContainerType.MergeWhenClause) {
+            // Force the action to start on the next line with additional indentation.
+            if (nextContainer === SqlPrintToken_1.SqlPrintTokenContainerType.MergeUpdateAction ||
+                nextContainer === SqlPrintToken_1.SqlPrintTokenContainerType.MergeDeleteAction ||
+                nextContainer === SqlPrintToken_1.SqlPrintTokenContainerType.MergeInsertAction ||
+                nextContainer === SqlPrintToken_1.SqlPrintTokenContainerType.MergeDoNothingAction) {
+                return true;
+            }
+        }
+        if (parentType === SqlPrintToken_1.SqlPrintTokenContainerType.UpdateQuery) {
+            if (nextKeyword === 'set' || nextKeyword === 'from' || nextKeyword === 'where' || nextKeyword === 'returning') {
+                return true;
+            }
+        }
+        if (parentType === SqlPrintToken_1.SqlPrintTokenContainerType.InsertQuery) {
+            if (nextKeyword === 'returning') {
+                return true;
+            }
+            if (nextKeyword && (nextKeyword.startsWith('select') || nextKeyword.startsWith('values'))) {
+                return true;
+            }
+            if (nextContainer === SqlPrintToken_1.SqlPrintTokenContainerType.ValuesQuery || nextContainer === SqlPrintToken_1.SqlPrintTokenContainerType.SimpleSelectQuery) {
+                return true;
+            }
+            if (nextContainer === SqlPrintToken_1.SqlPrintTokenContainerType.InsertClause) {
+                return true;
+            }
+        }
+        if (parentType === SqlPrintToken_1.SqlPrintTokenContainerType.DeleteQuery) {
+            if (nextKeyword === 'using' || nextKeyword === 'where' || nextKeyword === 'returning') {
+                return true;
+            }
+        }
+        if (parentType === SqlPrintToken_1.SqlPrintTokenContainerType.MergeUpdateAction || parentType === SqlPrintToken_1.SqlPrintTokenContainerType.MergeDeleteAction) {
+            if (nextKeyword === 'where') {
+                return true;
+            }
+        }
+        if (parentType === SqlPrintToken_1.SqlPrintTokenContainerType.MergeInsertAction) {
+            if (nextKeyword && (nextKeyword.startsWith('values') || nextKeyword === 'default values')) {
+                return true;
+            }
+        }
+        return false;
+    }
     /**
      * Creates a unified SqlPrinter instance configured for oneline formatting.
      * Works for all oneline options: parentheses, BETWEEN, VALUES, JOIN, CASE, subqueries.
@@ -535,8 +1424,8 @@ class SqlPrinter {
             andBreak: 'none', // Disable AND-based line breaks
             orBreak: 'none', // Disable OR-based line breaks
             keywordCase: this.keywordCase,
-            exportComment: this.exportComment,
-            strictCommentPlacement: this.strictCommentPlacement,
+            exportComment: this.commentExportMode,
+            commentStyle: this.commentStyle,
             withClauseStyle: 'standard',
             parenthesesOneLine: false, // Prevent recursive processing (avoid infinite loops)
             betweenOneLine: false, // Prevent recursive processing (avoid infinite loops)
@@ -545,6 +1434,7 @@ class SqlPrinter {
             caseOneLine: false, // Prevent recursive processing (avoid infinite loops)
             subqueryOneLine: false, // Prevent recursive processing (avoid infinite loops)
             indentNestedParentheses: false,
+            insertColumnsOneLine: this.insertColumnsOneLine,
         });
     }
     /**