@goodscript/core 0.13.0

package/dist/string-ext-gs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-ext-gs.d.ts","sourceRoot":"","sources":["../src/string-ext-gs.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,SAAS;IACpB;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAQlC;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAmB5C;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAQpC;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAc9C;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAItD;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAIrD;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAInD;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAO/C;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAIjC;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAE,MAAY,GAAG,MAAM;IAI3E;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAE,MAAY,GAAG,MAAM;IAI5E;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAIzD;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,SAAS,GAAE,MAAW,GAAG,MAAM;IAIjE;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAIrC;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAIrC;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAI9B;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAIlC;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;CAGpC"}

package/dist/string-ext-gs.js

@@ -0,0 +1,145 @@
+/**
+ * String parsing utilities with dual error handling pattern.
+ */
+export class StringExt {
+    /**
+     * Parse integer from string. Throws on invalid input.
+     */
+    static parseInt(s) {
+        const result = StringExt.tryParseInt(s);
+        if (result === null) {
+            throw new Error(`Invalid integer: "${s}"`);
+        }
+        return result;
+    }
+    /**
+     * Parse integer from string. Returns null on invalid input.
+     */
+    static tryParseInt(s) {
+        const trimmed = s.trim();
+        if (trimmed === '') {
+            return null;
+        }
+        const parsed = Number.parseInt(trimmed, 10);
+        if (Number.isNaN(parsed)) {
+            return null;
+        }
+        // Ensure the entire string was consumed (no trailing garbage)
+        if (!/^-?\d+$/.test(trimmed)) {
+            return null;
+        }
+        return parsed;
+    }
+    /**
+     * Parse float from string. Throws on invalid input.
+     */
+    static parseFloat(s) {
+        const result = StringExt.tryParseFloat(s);
+        if (result === null) {
+            throw new Error(`Invalid number: "${s}"`);
+        }
+        return result;
+    }
+    /**
+     * Parse float from string. Returns null on invalid input.
+     */
+    static tryParseFloat(s) {
+        const trimmed = s.trim();
+        if (trimmed === '') {
+            return null;
+        }
+        const parsed = Number.parseFloat(trimmed);
+        if (Number.isNaN(parsed)) {
+            return null;
+        }
+        return parsed;
+    }
+    /**
+     * Check if string contains substring.
+     */
+    static contains(s, substring) {
+        return s.includes(substring);
+    }
+    /**
+     * Check if string starts with prefix.
+     */
+    static startsWith(s, prefix) {
+        return s.startsWith(prefix);
+    }
+    /**
+     * Check if string ends with suffix.
+     */
+    static endsWith(s, suffix) {
+        return s.endsWith(suffix);
+    }
+    /**
+     * Repeat string n times.
+     */
+    static repeat(s, count) {
+        if (count < 0) {
+            throw new Error(`Repeat count must be non-negative: ${count}`);
+        }
+        return s.repeat(count);
+    }
+    /**
+     * Reverse string.
+     */
+    static reverse(s) {
+        return s.split('').reverse().join('');
+    }
+    /**
+     * Pad string to length on left with fillString.
+     */
+    static padLeft(s, length, fillString = ' ') {
+        return s.padStart(length, fillString);
+    }
+    /**
+     * Pad string to length on right with fillString.
+     */
+    static padRight(s, length, fillString = ' ') {
+        return s.padEnd(length, fillString);
+    }
+    /**
+     * Split string by separator.
+     */
+    static split(s, separator) {
+        return s.split(separator);
+    }
+    /**
+     * Join array of strings with separator.
+     */
+    static join(parts, separator = '') {
+        return parts.join(separator);
+    }
+    /**
+     * Convert string to uppercase.
+     */
+    static toUpperCase(s) {
+        return s.toUpperCase();
+    }
+    /**
+     * Convert string to lowercase.
+     */
+    static toLowerCase(s) {
+        return s.toLowerCase();
+    }
+    /**
+     * Trim whitespace from both ends.
+     */
+    static trim(s) {
+        return s.trim();
+    }
+    /**
+     * Trim whitespace from left end.
+     */
+    static trimLeft(s) {
+        return s.trimStart();
+    }
+    /**
+     * Trim whitespace from right end.
+     */
+    static trimRight(s) {
+        return s.trimEnd();
+    }
+}
+//# sourceMappingURL=string-ext-gs.js.map

package/dist/string-ext-gs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-ext-gs.js","sourceRoot":"","sources":["../src/string-ext-gs.ts"],"names":[],"mappings":"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"}

package/dist/string-tools-gs.d.ts

@@ -0,0 +1,78 @@
+/**
+ * String parsing utilities with dual error handling pattern.
+ */
+export declare class StringTools {
+    /**
+     * Parse integer from string. Throws on invalid input.
+     */
+    static parseInt(s: string): number;
+    /**
+     * Parse integer from string. Returns null on invalid input.
+     */
+    static tryParseInt(s: string): number | null;
+    /**
+     * Parse float from string. Throws on invalid input.
+     */
+    static parseFloat(s: string): number;
+    /**
+     * Parse float from string. Returns null on invalid input.
+     */
+    static tryParseFloat(s: string): number | null;
+    /**
+     * Check if string contains substring.
+     */
+    static contains(s: string, substring: string): boolean;
+    /**
+     * Check if string starts with prefix.
+     */
+    static startsWith(s: string, prefix: string): boolean;
+    /**
+     * Check if string ends with suffix.
+     */
+    static endsWith(s: string, suffix: string): boolean;
+    /**
+     * Repeat string n times.
+     */
+    static repeat(s: string, count: number): string;
+    /**
+     * Reverse string.
+     */
+    static reverse(s: string): string;
+    /**
+     * Pad string to length on left with fillString.
+     */
+    static padLeft(s: string, length: number, fillString?: string): string;
+    /**
+     * Pad string to length on right with fillString.
+     */
+    static padRight(s: string, length: number, fillString?: string): string;
+    /**
+     * Split string by separator.
+     */
+    static split(s: string, separator: string): Array<string>;
+    /**
+     * Join array of strings with separator.
+     */
+    static join(parts: Array<string>, separator?: string): string;
+    /**
+     * Convert string to uppercase.
+     */
+    static toUpperCase(s: string): string;
+    /**
+     * Convert string to lowercase.
+     */
+    static toLowerCase(s: string): string;
+    /**
+     * Trim whitespace from both ends.
+     */
+    static trim(s: string): string;
+    /**
+     * Trim whitespace from left end.
+     */
+    static trimLeft(s: string): string;
+    /**
+     * Trim whitespace from right end.
+     */
+    static trimRight(s: string): string;
+}
+//# sourceMappingURL=string-tools-gs.d.ts.map

package/dist/string-tools-gs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-tools-gs.d.ts","sourceRoot":"","sources":["../src/string-tools-gs.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,WAAW;IACtB;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAQlC;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAmB5C;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAQpC;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAc9C;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAItD;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAIrD;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAInD;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAO/C;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAIjC;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAE,MAAY,GAAG,MAAM;IAI3E;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAE,MAAY,GAAG,MAAM;IAI5E;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAIzD;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,SAAS,GAAE,MAAW,GAAG,MAAM;IAIjE;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAIrC;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAIrC;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAI9B;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAIlC;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;CAGpC"}

package/dist/string-tools-gs.js

@@ -0,0 +1,145 @@
+/**
+ * String parsing utilities with dual error handling pattern.
+ */
+export class StringTools {
+    /**
+     * Parse integer from string. Throws on invalid input.
+     */
+    static parseInt(s) {
+        const result = StringTools.tryParseInt(s);
+        if (result === null) {
+            throw new Error(`Invalid integer: "${s}"`);
+        }
+        return result;
+    }
+    /**
+     * Parse integer from string. Returns null on invalid input.
+     */
+    static tryParseInt(s) {
+        const trimmed = s.trim();
+        if (trimmed === '') {
+            return null;
+        }
+        const parsed = Number.parseInt(trimmed, 10);
+        if (Number.isNaN(parsed)) {
+            return null;
+        }
+        // Ensure the entire string was consumed (no trailing garbage)
+        if (!/^-?\d+$/.test(trimmed)) {
+            return null;
+        }
+        return parsed;
+    }
+    /**
+     * Parse float from string. Throws on invalid input.
+     */
+    static parseFloat(s) {
+        const result = StringTools.tryParseFloat(s);
+        if (result === null) {
+            throw new Error(`Invalid number: "${s}"`);
+        }
+        return result;
+    }
+    /**
+     * Parse float from string. Returns null on invalid input.
+     */
+    static tryParseFloat(s) {
+        const trimmed = s.trim();
+        if (trimmed === '') {
+            return null;
+        }
+        const parsed = Number.parseFloat(trimmed);
+        if (Number.isNaN(parsed)) {
+            return null;
+        }
+        return parsed;
+    }
+    /**
+     * Check if string contains substring.
+     */
+    static contains(s, substring) {
+        return s.includes(substring);
+    }
+    /**
+     * Check if string starts with prefix.
+     */
+    static startsWith(s, prefix) {
+        return s.startsWith(prefix);
+    }
+    /**
+     * Check if string ends with suffix.
+     */
+    static endsWith(s, suffix) {
+        return s.endsWith(suffix);
+    }
+    /**
+     * Repeat string n times.
+     */
+    static repeat(s, count) {
+        if (count < 0) {
+            throw new Error(`Repeat count must be non-negative: ${count}`);
+        }
+        return s.repeat(count);
+    }
+    /**
+     * Reverse string.
+     */
+    static reverse(s) {
+        return s.split('').reverse().join('');
+    }
+    /**
+     * Pad string to length on left with fillString.
+     */
+    static padLeft(s, length, fillString = ' ') {
+        return s.padStart(length, fillString);
+    }
+    /**
+     * Pad string to length on right with fillString.
+     */
+    static padRight(s, length, fillString = ' ') {
+        return s.padEnd(length, fillString);
+    }
+    /**
+     * Split string by separator.
+     */
+    static split(s, separator) {
+        return s.split(separator);
+    }
+    /**
+     * Join array of strings with separator.
+     */
+    static join(parts, separator = '') {
+        return parts.join(separator);
+    }
+    /**
+     * Convert string to uppercase.
+     */
+    static toUpperCase(s) {
+        return s.toUpperCase();
+    }
+    /**
+     * Convert string to lowercase.
+     */
+    static toLowerCase(s) {
+        return s.toLowerCase();
+    }
+    /**
+     * Trim whitespace from both ends.
+     */
+    static trim(s) {
+        return s.trim();
+    }
+    /**
+     * Trim whitespace from left end.
+     */
+    static trimLeft(s) {
+        return s.trimStart();
+    }
+    /**
+     * Trim whitespace from right end.
+     */
+    static trimRight(s) {
+        return s.trimEnd();
+    }
+}
+//# sourceMappingURL=string-tools-gs.js.map

package/dist/string-tools-gs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-tools-gs.js","sourceRoot":"","sources":["../src/string-tools-gs.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@goodscript/core",
+  "version": "0.13.0",
+  "description": "GoodScript core types and collections",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE-MIT",
+    "LICENSE-APACHE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "pnpm build && pnpm test"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fcapolini/goodscript.git",
+    "directory": "stdlib/core"
+  },
+  "bugs": {
+    "url": "https://github.com/fcapolini/goodscript/issues"
+  },
+  "homepage": "https://github.com/fcapolini/goodscript/tree/main/stdlib/core#readme",
+  "keywords": [
+    "goodscript",
+    "stdlib",
+    "collections",
+    "array",
+    "map",
+    "set",
+    "string"
+  ],
+  "author": "GoodScript Contributors",
+  "license": "MIT OR Apache-2.0",
+  "devDependencies": {
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  }
+}

package/src/array-tools-gs.ts

@@ -0,0 +1,172 @@
+/**
+ * Array utilities with dual error handling pattern.
+ * 
+ * All fallible operations provide:
+ * - `operation()` - throws Error on failure
+ * - `tryOperation()` - returns null on failure
+ */
+export class ArrayTools {
+  /**
+   * Get element at index. Throws if index is out of bounds.
+   */
+  static at<T>(arr: Array<T>, index: number): T {
+    const result = ArrayTools.tryAt(arr, index);
+    if (result === null) {
+      throw new Error(`Array index out of bounds: ${index} (length: ${arr.length})`);
+    }
+    return result;
+  }
+
+  /**
+   * Get element at index. Returns null if index is out of bounds.
+   */
+  static tryAt<T>(arr: Array<T>, index: number): T | null {
+    // Support negative indexing
+    const actualIndex = index < 0 ? arr.length + index : index;
+    if (actualIndex < 0 || actualIndex >= arr.length) {
+      return null;
+    }
+    return arr[actualIndex];
+  }
+
+  /**
+   * Get first element. Throws if array is empty.
+   */
+  static first<T>(arr: Array<T>): T {
+    const result = ArrayTools.tryFirst(arr);
+    if (result === null) {
+      throw new Error('Cannot get first element of empty array');
+    }
+    return result;
+  }
+
+  /**
+   * Get first element. Returns null if array is empty.
+   */
+  static tryFirst<T>(arr: Array<T>): T | null {
+    if (arr.length === 0) {
+      return null;
+    }
+    return arr[0];
+  }
+
+  /**
+   * Get last element. Throws if array is empty.
+   */
+  static last<T>(arr: Array<T>): T {
+    const result = ArrayTools.tryLast(arr);
+    if (result === null) {
+      throw new Error('Cannot get last element of empty array');
+    }
+    return result;
+  }
+
+  /**
+   * Get last element. Returns null if array is empty.
+   */
+  static tryLast<T>(arr: Array<T>): T | null {
+    if (arr.length === 0) {
+      return null;
+    }
+    return arr[arr.length - 1];
+  }
+
+  /**
+   * Split array into chunks of specified size.
+   * Last chunk may be smaller if array length is not evenly divisible.
+   */
+  static chunk<T>(arr: Array<T>, size: number): Array<Array<T>> {
+    if (size <= 0) {
+      throw new Error(`Chunk size must be positive, got: ${size}`);
+    }
+
+    const result: Array<Array<T>> = [];
+    for (let i = 0; i < arr.length; i += size) {
+      result.push(arr.slice(i, i + size));
+    }
+    return result;
+  }
+
+  /**
+   * Zip two arrays together into array of tuples.
+   * Result length is minimum of input lengths.
+   */
+  static zip<T, U>(a: Array<T>, b: Array<U>): Array<[T, U]> {
+    const length = Math.min(a.length, b.length);
+    const result: Array<[T, U]> = [];
+    for (let i = 0; i < length; i++) {
+      result.push([a[i], b[i]]);
+    }
+    return result;
+  }
+
+  /**
+   * Create range of integers [start, end).
+   */
+  static range(start: number, end: number, step: number = 1): Array<number> {
+    if (step === 0) {
+      throw new Error('Step cannot be zero');
+    }
+    if ((end - start) / step < 0) {
+      throw new Error('Invalid range: step direction does not match start/end');
+    }
+
+    const result: Array<number> = [];
+    if (step > 0) {
+      for (let i = start; i < end; i += step) {
+        result.push(i);
+      }
+    } else {
+      for (let i = start; i > end; i += step) {
+        result.push(i);
+      }
+    }
+    return result;
+  }
+
+  /**
+   * Flatten nested array one level deep.
+   */
+  static flatten<T>(arr: Array<Array<T>>): Array<T> {
+    const result: Array<T> = [];
+    for (const subArray of arr) {
+      for (const item of subArray) {
+        result.push(item);
+      }
+    }
+    return result;
+  }
+
+  /**
+   * Remove duplicate values from array.
+   * Preserves first occurrence order.
+   */
+  static unique<T>(arr: Array<T>): Array<T> {
+    const seen = new Set<T>();
+    const result: Array<T> = [];
+    for (const item of arr) {
+      if (!seen.has(item)) {
+        seen.add(item);
+        result.push(item);
+      }
+    }
+    return result;
+  }
+
+  /**
+   * Partition array into two arrays based on predicate.
+   * Returns [truthy, falsy] tuple.
+   */
+  static partition<T>(arr: Array<T>, predicate: (item: T) => boolean): [Array<T>, Array<T>] {
+    const truthy: Array<T> = [];
+    const falsy: Array<T> = [];
+    for (const item of arr) {
+      if (predicate(item)) {
+        truthy.push(item);
+      } else {
+        falsy.push(item);
+      }
+    }
+    return [truthy, falsy];
+  }
+}

package/src/index-gs.ts

@@ -0,0 +1,17 @@
+/**
+ * @goodscript/core - Core Types & Collections
+ * 
+ * GoodScript standard library module providing utilities for:
+ * - Array operations with dual error handling
+ * - Map and Set utilities
+ * - String parsing with fallible operations
+ * 
+ * All fallible operations follow the dual-API pattern:
+ * - `operation()` throws on error
+ * - `tryOperation()` returns null on error
+ */
+
+export { ArrayTools } from './array-tools-gs.js';
+export { MapTools } from './map-tools-gs.js';
+export { SetTools } from './set-tools-gs.js';
+export { StringTools } from './string-tools-gs.js';