Merge pull request #13 from MaksymStoianov/max/next

Max/next

Author: MaksymStoianov

README.md

@@ -85,6 +85,7 @@ A collection of functions to simplify working with Google Sheets.
 | [`isTextStyle`](src/appsscript/sheets/isTextStyle.ts)                             | Checks if an object is a [`TextStyle`](https://developers.google.com/apps-script/reference/slides/text-style).                   |
 | [`isValidSheetName`](src/appsscript/sheets/isValidSheetName.ts)                   | Checks if a sheet name is valid.                                                                                                 |
 | [`isValidSpreadsheetId`](src/appsscript/sheets/isValidSpreadsheetId.ts)           | Checks if a spreadsheet ID is valid.                                                                                             |
+| [`nonSheet`](src/appsscript/sheets/nonSheet.ts) 🆕                                | Checks if an object is not a [`Sheet`](https://developers.google.com/apps-script/reference/spreadsheet/sheet).                   |
 | [`parseA1Notation`](src/appsscript/sheets/parseA1Notation.ts)                     | Parses an A1 notation (e.g., 'A1:B2') into [`GridRange`](src/appsscript/sheets/types/GridRange.ts) components.                   |
 | [`prependRow`](src/appsscript/sheets/prependRow.ts)                               | Prepends a single row of data to the sheet.                                                                                      |
 | [`prependRows`](src/appsscript/sheets/prependRows.ts)                             | Prepends multiple rows of data to the sheet.                                                                                     |
@@ -243,7 +244,7 @@ Functions for working with file paths and URLs.
 - [ ] `base/date/getDaysInMonth`
 - [ ] `base/date/getDaysLeftInMonth`
 - [ ] `base/date/offset`
-- [ ] `base/date/offset`
+- [ ] `abstract/EventEmitter`
 
 </details>
 

src/appsscript/sheets/getColumnLetterByPosition.ts

@@ -1,4 +1,4 @@
-import { getColumnLetterByIndex } from "@/appsscript";
+import { getColumnLetterByIndex } from "./getColumnLetterByIndex";
 
 /**
  * ## getColumnLetterByPosition

src/appsscript/sheets/index.ts

@@ -24,6 +24,8 @@ export { isTextStyle } from "./isTextStyle";
 export { isValidSheetName } from "./isValidSheetName";
 export { isValidSpreadsheetId } from "./isValidSpreadsheetId";
 
+export { nonSheet } from "./nonSheet";
+
 export { parseA1Notation } from "./parseA1Notation";
 
 export { toA1Notation } from "./toA1Notation";

src/appsscript/sheets/isCellGridRange.ts

@@ -1,4 +1,4 @@
-import { nonNil } from "@/base";
+import { nonNil } from "../../base";
 import { GridRange } from "./types";
 
 /**

src/appsscript/sheets/isSheet.ts

@@ -7,6 +7,7 @@ import { isObject } from "../../base";
  *
  * @param       value - The value to check.
  * @returns     `true` if the value is a {@link GoogleAppsScript.Spreadsheet.Sheet|Sheet} object, `false` otherwise.
+ * @see         nonSheet
  * @see         [Class Sheet](https://developers.google.com/apps-script/reference/spreadsheet/sheet)
  * @since       1.0.0
  * @version     1.0.0

src/appsscript/sheets/nonSheet.ts

@@ -0,0 +1,20 @@
+import { isSheet } from "./isSheet";
+
+/**
+ * ## nonSheet
+ *
+ * Checks if the provided value is not a [`Google Sheet`](https://developers.google.com/apps-script/reference/spreadsheet/sheet) object.
+ *
+ * @param value - The value to check.
+ * @returns `true` if the value is not a {@link GoogleAppsScript.Spreadsheet.Sheet|Sheet} object.
+ * @see         isSheet
+ * @see         [Class Sheet](https://developers.google.com/apps-script/reference/spreadsheet/sheet)
+ * @since       1.3.0
+ * @version     1.0.0
+ * @environment Google Apps Script
+ */
+export function nonSheet<T>(
+  value: T | GoogleAppsScript.Spreadsheet.Sheet
+): value is T {
+  return !isSheet(value);
+}

src/base/index.ts

@@ -35,6 +35,7 @@ export { isValidVersion } from "./isValidVersion";
 export { isVersionCompatible } from "./isVersionCompatible";
 
 export { nonBoolean } from "./nonBoolean";
+export { nonEmpty } from "./nonEmpty";
 export { nonNil } from "./nonNil";
 export { nonNull } from "./nonNull";
 export { nonNumber } from "./nonNumber";