From 15f5fadb8df79e9d9b3a741cc90c94671846b5f6 Mon Sep 17 00:00:00 2001
From: Aleks Hudochenkov <aleks@hudochenkov.com>
Date: Thu, 5 Jan 2023 15:05:54 +0100
Subject: [PATCH] Add types for an Input.error()

---
 lib/input.d.ts | 30 +++++++++++++++++++++++++++++-
 1 file changed, 29 insertions(+), 1 deletion(-)

diff --git a/lib/input.d.ts b/lib/input.d.ts
index 357910bd0..8e39d0053 100644
--- a/lib/input.d.ts
+++ b/lib/input.d.ts
@@ -1,4 +1,4 @@
-import { ProcessOptions } from './postcss.js'
+import { CssSyntaxError, ProcessOptions } from './postcss.js'
 import PreviousMap from './previous-map.js'
 
 export interface FilePosition {
@@ -147,4 +147,32 @@ export default class Input {
    * @param offset Source offset.
    */
   fromOffset(offset: number): { line: number; col: number } | null
+
+  /**
+   * Returns `CssSyntaxError` with information about the error and its position
+   *
+   * @param message Error message.
+   * @param line The line number in the input or a position that is part of a range.
+   * @param column The column number in the input or a position that is part of a range.
+   * @param opts Object contains `plugin` key with PostCSS plugin name, if error came from a plugin.
+   * @return `CssSyntaxError`
+   */
+  error(
+    message: string,
+    line:
+      | number
+      | {
+          offset?: number
+          line: number
+          column: number
+        },
+    column?:
+      | number
+      | {
+          offset?: number
+          line: number
+          column: number
+        },
+    opts?: { plugin?: CssSyntaxError['plugin'] }
+  ): CssSyntaxError
 }