@sv443-network/coreutils 3.4.0 → 3.5.1

package/dist/lib/DataStoreSerializer.d.ts

@@ -2,7 +2,7 @@
  * @module DataStoreSerializer  
  * This module contains the DataStoreSerializer class, which allows you to import and export serialized DataStore data - [see the documentation for more info](https://github.com/Sv443-Network/UserUtils/blob/main/docs.md#datastoreserializer)  
  */
-import type { DataStore, DataStoreData } from "./DataStore.ts";
+import type { DataStore } from "./DataStore.ts";
 /** Options for the DataStoreSerializer class */
 export type DataStoreSerializerOptions = {
     /** Whether to add a checksum to the exported data. Defaults to `true` */
@@ -44,9 +44,9 @@ export type StoreFilter = string[] | ((id: string) => boolean);
  * - ⚠️ Needs to run in a secure context (HTTPS) due to the use of the SubtleCrypto API if checksumming is enabled.  
  */
 export declare class DataStoreSerializer {
-    protected stores: DataStore<DataStoreData, boolean>[];
+    protected stores: DataStore<any, boolean>[];
     protected options: Required<DataStoreSerializerOptions>;
-    constructor(stores: DataStore<DataStoreData, boolean>[], options?: DataStoreSerializerOptions);
+    constructor(stores: DataStore<any, boolean>[], options?: DataStoreSerializerOptions);
     /**
      * Calculates the checksum of a string. Uses {@linkcode computeHash()} with SHA-256 and digests as a hex string by default.  
      * Override this in a subclass if a custom checksum method is needed.  
@@ -118,5 +118,5 @@ export declare class DataStoreSerializer {
     /** Checks if a given value is a SerializedDataStore object */
     static isSerializedDataStoreObj(obj: unknown): obj is SerializedDataStore;
     /** Returns the DataStore instances whose IDs match the provided array or function */
-    protected getStoresFiltered(stores?: StoreFilter): DataStore<DataStoreData, boolean>[];
+    protected getStoresFiltered(stores?: StoreFilter): DataStore<any, boolean>[];
 }

package/dist/lib/text.d.ts

@@ -39,3 +39,68 @@ export declare function joinArrayReadable(array: unknown[], separators?: string,
 export declare function secsToTimeStr(seconds: number): string;
 /** Truncates a string if it exceeds `length` and inserts `endStr` at the end (empty string to disable), so that the final string doesn't exceed the given length */
 export declare function truncStr(input: Stringifiable, length: number, endStr?: string): string;
+/**
+ * Border styles for the `lineStyle` option of the {@linkcode createTable} function.  
+ *  
+ * | Style | Example |  
+ * | :-- | :-- |  
+ * | `single` | `┌──────┬──────┐` |  
+ * | `double` | `╔══════╦══════╗` |  
+ * | `none` |  |  
+ */
+export type TableLineStyle = "single" | "double" | "none";
+/**
+ * How to align cell content in a column for the `columnAlign` option of the {@linkcode createTable} function.  
+ *  
+ * | Alignment | Example | Description |  
+ * | :-- | :-- | :-- |  
+ * | `left` | `│.Text....│` | Hugs the left border, with padding determined by `minPadding`. |  
+ * | `centerLeft` | `│..Text...│` | In the center, but if the padding is uneven, favors the left side. |  
+ * | `centerRight` | `│...Text..│` | In the center, but if the padding is uneven, favors the right side. |  
+ * | `right` | `│....Text.│` | Hugs the right border, with padding determined by `minPadding`. |  
+ */
+export type TableColumnAlign = "left" | "centerLeft" | "centerRight" | "right";
+/** Options for the {@linkcode createTable} function. */
+export type TableOptions = {
+    /** Alignment for each column, either a single value to apply to all columns or an array of values for each column. Defaults to `left`. */
+    columnAlign?: TableColumnAlign | TableColumnAlign[];
+    /** If set, cell content that exceeds this width will be truncated with the value of `truncEndStr` (defaults to `…`) so that the final cell content doesn't exceed this width. */
+    truncateAbove?: number;
+    /** The string to append to truncated cell content if `truncateAbove` is set. Defaults to `…`. */
+    truncEndStr?: string;
+    /** Minimum padding to add to the left and right of cell content, regardless of alignment settings. Defaults to 1, set to 0 to disable. */
+    minPadding?: number;
+    /** Which kind of line characters to use for the border of the table. Defaults to `single` (`┌──────┬──────┐`). */
+    lineStyle?: TableLineStyle;
+    /** Can be used to change the characters used for the lines dividing cells in the table. If not set, {@linkcode defaultTableLineCharset} will be used. */
+    lineCharset?: TableLineCharset;
+    /**
+     * Can be used to add custom values like ANSI color codes to the lines dividing cells.  
+     * Function gets passed the row index (i) and column index (j) of the character being rendered.  
+     * Note that each row renders three rows of characters, so the row index (i) is not the same as the index of the row in the input array, but can be used to determine it with `Math.floor(i / 3)`.  
+     * The first value of the returned tuple will be added before the line character and the second value will be added after.  
+     * Return an empty array to not apply any custom styling.  
+     */
+    applyLineStyle?: (i: number, j: number) => [before?: string, after?: string] | void;
+    /**
+     * Can be used to add custom values like ANSI color codes to the cell content.  
+     * Function gets passed the row index (i) and column index (j) of the cell being rendered.  
+     * Note: cell width is calculated before applying this style, so characters with non-zero width will mess up the alignment and border placement.  
+     * The first value of the returned tuple will be added before the cell content and the second value will be added after.  
+     * Return an empty array to not apply any custom styling.  
+     */
+    applyCellStyle?: (i: number, j: number) => [before?: string, after?: string] | void;
+};
+/** Characters to use for the lines dividing cells in the table generated by {@linkcode createTable}, based on the `lineStyle` option. */
+export type TableLineStyleChars = Record<"horizontal" | "vertical" | `${"top" | "bottom"}${"Left" | "Right"}` | `${"left" | "right" | "top" | "bottom"}T` | "cross", string>;
+/** The characters to use for the lines dividing cells in the table generated by {@linkcode createTable}, based on the `lineStyle` option. */
+export type TableLineCharset = Record<TableLineStyle, TableLineStyleChars>;
+/** The default characters to use for the lines dividing cells in the table generated by {@linkcode createTable}, based on the `lineStyle` option. */
+export declare const defaultTableLineCharset: TableLineCharset;
+/**
+ * Creates an ASCII table string from the given rows and options.  
+ * Supports ANSI color codes in cell content: they are ignored for width calculation, included in the final output, and handled correctly during truncation (escape sequences are never split; any open color code is closed with a reset).  
+ * @param rows Array of tuples, where each tuple represents a row and its values. The first tuple is used to determine the column count.  
+ * @param options Object with options for customizing the table output, such as column alignment, truncation, padding and line styles.  
+ */
+export declare function createTable<TRow extends [...Stringifiable[]]>(rows: TRow[], options?: TableOptions): string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sv443-network/coreutils",
   "libName": "@sv443-network/coreutils",
-  "version": "3.4.0",
+  "version": "3.5.1",
   "description": "Cross-platform, general-purpose, JavaScript core library for Node, Deno and the browser. Intended to be used in conjunction with `@sv443-network/userutils` and `@sv443-network/djsutils`, but can be used independently as well.",
   "main": "dist/CoreUtils.cjs",
   "module": "dist/CoreUtils.mjs",