@adriangalilea/utils 0.0.10 → 0.2.0

package/README.md

@@ -5,13 +5,11 @@ TypeScript utilities - logger, currency, offensive programming, file operations,
 ## Installation
 
 ```bash
-# Using JSR (recommended)
-pnpm dlx jsr add @adriangalilea/utils
-
-# or with npm
-npx jsr add @adriangalilea/utils
+pnpm add @adriangalilea/utils
 ```
 
+Also available on [JSR](https://jsr.io/@adriangalilea/utils) but the JSR publish pipeline is not automated — versions may lag behind npm.
+
 ## Usage
 
 ### Logger
@@ -79,21 +77,123 @@ currency.percentToBasisPoints(1)  // 100
 currency.formatBasisPoints(50)  // "50 bps"
 ```
 
+### Format
+
+Number and currency formatting utilities:
+
+```typescript
+import { format } from '@adriangalilea/utils/format'
+
+// Number formatting
+format.number(1234.567, 2)  // "1234.57"
+format.withCommas(1234567)  // "1,234,567"
+format.withCommas(1234.567, 2)  // "1,234.57"
+
+// Compact notation
+format.compact(1234567)  // "1.2M"
+format.compact(1234)  // "1.2K"
+
+// Currency formatting
+format.usd(1234.56)  // "$1,234.56"
+format.btc(0.00123456)  // "0.001235 ₿"
+format.eth(1.23456789)  // "1.234568 Ξ"
+format.auto(100, 'EUR')  // "€100.00"
+
+// Percentages
+format.percentage(12.3456)  // "12.3%"
+format.percentage(0.05)  // "0.05%"
+format.percentage(123.456)  // "123%"
+```
+
+### Offensive Programming
+
+Fail loud, fail fast. All primitives throw `Panic` — an uncaught `Panic` crashes the process with a full stack trace. Zero dependencies, works identically in Node, Deno, Bun, and browsers.
+
+```typescript
+import { assert, panic, must, unwrap, Panic } from '@adriangalilea/utils'
+
+// Assert invariants — narrows types
+assert(port > 0 && port < 65536, 'invalid port:', port)
+
+// Impossible state
+switch (state) {
+  case 'ready': handleReady(); break
+  default: panic('impossible state:', state)
+}
+
+// Unwrap operations that shouldn't fail (sync + async)
+const data = must(() => JSON.parse(staticJsonString))
+const file = must(() => readFileSync(path))
+const resp = await must(() => fetch(url))
+
+// Unwrap nullable values — type narrows T | null | undefined → T in one expression
+// (assert needs two statements, unwrap does it inline)
+const user = unwrap(db.findUser(id), 'user not found:', id)
+const el = unwrap(document.getElementById('app'))
+
+// must() replaces try/catch boilerplate:
+//   try { return readFileSync(path, 'utf-8') }
+//   catch (err) { check(err) }
+// becomes:
+return must(() => readFileSync(path, 'utf-8'))
+
+// Panic is a distinct error class — distinguishes bugs from runtime errors
+// In a server: let Panics crash, handle everything else
+app.use((err, req, res, next) => {
+  if (err instanceof Panic) throw err  // bug, re-throw, let it crash
+  res.status(500).json({ error: 'internal error' })
+})
+
+// In tests: assert that code panics
+expect(() => assert(false, 'boom')).toThrow(Panic)
+```
+
 ## Features
 
 - **Logger**: Next.js-style colored console output with symbols
-- **Currency**: 
+- **Currency**:
   - 13,750+ crypto symbols from CoinGecko (auto-updatable)
   - Alternative ticker support (XBT→BTC, wrapped tokens, etc.)
   - Optimal decimal calculations
   - Percentage and basis point utilities
   - Fiat and stablecoin detection
-- **Offensive Programming**: Assert, must, check, panic utilities
+- **Format**: Number and currency formatting with compact notation
+- **Offensive Programming**: assert, panic, must, unwrap — all throw `Panic` with full stack traces
 - **File Operations**: Read, write with automatic path resolution
 - **Directory Operations**: Create, list, walk directories
 - **KEV**: Redis-style environment variable management with monorepo support
+- **XDG**: XDG Base Directory paths — reads env vars set by [xdg-dirs](https://github.com/adriangalilea/xdg-dirs), falls back to spec defaults
 - **Project Discovery**: Find project/monorepo roots, detect JS/TS projects
 
+### XDG Base Directories
+
+XDG paths that respect env vars from [xdg-dirs](https://github.com/adriangalilea/xdg-dirs) with spec-compliant fallbacks:
+
+```typescript
+import { xdg, dir } from '@adriangalilea/utils'
+
+xdg.state('notify')                    // ~/.local/state/notify
+xdg.state('notify', 'watchers.json')   // ~/.local/state/notify/watchers.json
+xdg.config('myapp')                    // ~/.config/myapp
+xdg.data('myapp')                      // ~/.local/share/myapp
+xdg.cache('myapp')                     // ~/.cache/myapp
+xdg.runtime('myapp')                   // $XDG_RUNTIME_DIR/myapp
+
+// Ensure the directory exists before writing
+dir.create(xdg.state('notify'))
+```
+
+## Release
+
+Bump version in `package.json` (and `jsr.json`), push to `main`. CI handles everything:
+
+1. Type-check, lint, build
+2. Publish to npm via [OIDC trusted publishing](https://docs.npmjs.com/generating-provenance-statements) (no tokens — GitHub Actions proves identity directly to npm)
+3. Create git tag `vX.Y.Z`
+4. Generate changelog via [git-cliff](https://github.com/orhun/git-cliff) and create GitHub release
+
+JSR publishing is not automated — see `jsr.json` TODO.
+
 ## License
 
 MIT

package/dist/index.d.ts

@@ -13,4 +13,5 @@ export * from './platform/dir.js';
 export * from './platform/path.js';
 export * from './platform/project.js';
 export * from './platform/kev.js';
+export * from './platform/xdg.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAGvD,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAG7C,cAAc,gBAAgB,CAAA;AAI9B,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAGvD,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAG7C,cAAc,gBAAgB,CAAA;AAI9B,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA"}

package/dist/index.js

@@ -8,7 +8,7 @@ export { runtime } from './runtime.js';
 export * from './universal/log.js';
 export * from './universal/format.js';
 export * from './universal/currency/index.js';
-// Offensive programming - uses runtime.exit() so it adapts to environment
+// Offensive programming - pure throws, zero dependencies
 export * from './offensive.js';
 // Platform-specific utilities
 // These will throw helpful errors in browser environment when used
@@ -17,4 +17,5 @@ export * from './platform/dir.js';
 export * from './platform/path.js';
 export * from './platform/project.js';
 export * from './platform/kev.js';
+export * from './platform/xdg.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8CAA8C;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAGtC,wCAAwC;AACxC,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAE7C,0EAA0E;AAC1E,cAAc,gBAAgB,CAAA;AAE9B,8BAA8B;AAC9B,mEAAmE;AACnE,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8CAA8C;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAGtC,wCAAwC;AACxC,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAE7C,yDAAyD;AACzD,cAAc,gBAAgB,CAAA;AAE9B,8BAA8B;AAC9B,mEAAmE;AACnE,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA"}

package/dist/offensive.d.ts

@@ -3,58 +3,55 @@
  *
  * "A confused program SHOULD scream" - John Carmack
  *
- * These utilities are the ANTITHESIS of defensive programming.
+ * Throw, always. An uncaught Panic crashes the process with a full stack trace.
+ * Zero dependencies. Works identically in Node, Deno, Bun, and browsers.
  *
- * Defensive programming: try/catch, error recovery, graceful degradation, silent failures
- * Offensive programming: FAIL LOUD, FAIL FAST, NO RECOVERY, CRASH EARLY
+ * Four primitives:
+ *   assert(cond, ...msg)   - invariant checking, narrows types
+ *   panic(...msg)          - impossible state reached
+ *   must(() => expr)       - unwrap-or-die for operations (sync + async)
+ *   unwrap(value, ...msg)  - unwrap nullable values
  *
- * We don't handle errors - we make them catastrophic.
- * We don't recover - we crash.
- * We don't validate and continue - we assert and panic.
+ * must() replaces the old try/catch/check pattern:
  *
- * This approach makes bugs IMPOSSIBLE to ignore:
- * - Wrong assumptions? CRASH
- * - Invalid state? CRASH
- * - "Impossible" error? CRASH
+ *   // before: 5 lines
+ *   try {
+ *     const data = readFileSync(path, 'utf-8')
+ *     return data
+ *   } catch (err) {
+ *     check(err)
+ *   }
  *
- * The only acceptable response to confusion is to scream and die.
+ *   // after: 1 line
+ *   return must(() => readFileSync(path, 'utf-8'))
  */
 /**
- * Assert exits with error if condition is false.
- * Use for validating preconditions and invariants.
+ * Distinct error class for offensive programming failures.
+ * Distinguishes bugs from runtime errors at catch boundaries.
  *
  * @example
- * function sendPacket(data: Buffer, port: number) {
- *   assert(data.length > 0, 'empty packet')
- *   assert(port > 0 && port < 65536, 'invalid port:', port)
- *   // Now safe to proceed
- * }
- */
-export declare function assert(condition: boolean, ...msg: any[]): asserts condition;
-/**
- * Must unwraps a value that may throw and exits if error occurs.
- * Use for operations that should never fail in correct code.
+ * // In a server — let Panics crash, handle everything else
+ * app.use((err, req, res, next) => {
+ *   if (err instanceof Panic) throw err  // bug, re-throw, let it crash
+ *   res.status(500).json({ error: 'internal error' })
+ * })
  *
- * @example
- * const data = must(() => JSON.parse(staticJsonString))
- * const regex = must(() => new RegExp('^\\d+$'))
+ * // In tests — assert that code panics
+ * expect(() => assert(false, 'boom')).toThrow(Panic)
  */
-export declare function must<T>(fn: () => T): T;
+export declare class Panic extends Error {
+    constructor(message: string);
+}
 /**
- * Check exits cleanly with formatted error message if error is not null/undefined.
- * Use for expected errors: file not found, network issues, permissions, etc.
+ * Assert throws if condition is false. Narrows types via `asserts condition`.
  *
  * @example
- * try {
- *   const data = await fs.readFile(userFile)
- * } catch (err) {
- *   check(err) // exits with error message
- * }
+ * assert(data.length > 0, 'empty packet')
+ * assert(port > 0 && port < 65536, 'invalid port:', port)
  */
-export declare function check(err: any, ...messages: string[]): void;
+export declare function assert(condition: boolean, ...msg: any[]): asserts condition;
 /**
- * Panic immediately exits with error message.
- * Use when the program reaches an impossible state.
+ * Panic throws immediately. Use when the program reaches an impossible state.
  *
  * @example
  * switch (state) {
@@ -64,10 +61,35 @@ export declare function check(err: any, ...messages: string[]): void;
  * }
  */
 export declare function panic(...msg: any[]): never;
+/**
+ * Must unwraps an operation that should never fail. Handles sync and async.
+ *
+ * @example
+ * const data = must(() => JSON.parse(staticJsonString))
+ * const file = await must(() => fs.promises.readFile(path))
+ * const buf = must(() => readFileSync(path))
+ */
+export declare function must<T>(fn: () => Promise<T>): Promise<T>;
+export declare function must<T>(fn: () => T): T;
+/**
+ * Unwrap a nullable value or throw. Like Rust's .unwrap()/.expect().
+ * Returns T from T | null | undefined with type narrowing in one expression.
+ *
+ * @example
+ * // assert needs two statements:
+ * const user = db.findUser(id)
+ * assert(user !== null, 'user not found:', id)
+ *
+ * // unwrap does it inline:
+ * const user = unwrap(db.findUser(id), 'user not found:', id)
+ * const el = unwrap(document.getElementById('app'))
+ */
+export declare function unwrap<T>(value: T | null | undefined, ...msg: any[]): T;
 export declare const offensive: {
+    Panic: typeof Panic;
     assert: typeof assert;
-    must: typeof must;
-    check: typeof check;
     panic: typeof panic;
+    must: typeof must;
+    unwrap: typeof unwrap;
 };
 //# sourceMappingURL=offensive.d.ts.map

package/dist/offensive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"offensive.d.ts","sourceRoot":"","sources":["../src/offensive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAKH;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,CAM3E;AAED;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAOtC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAS3D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAI1C;AAED,eAAO,MAAM,SAAS;;;;;CAKrB,CAAA"}
+{"version":3,"file":"offensive.d.ts","sourceRoot":"","sources":["../src/offensive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH;;;;;;;;;;;;;GAaG;AACH,qBAAa,KAAM,SAAQ,KAAK;gBAClB,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,CAE3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAE1C;AAED;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AACzD,wBAAgB,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;AAevC;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAGvE;AAED,eAAO,MAAM,SAAS;;;;;;CAMrB,CAAA"}

package/dist/offensive.js

@@ -3,101 +3,109 @@
  *
  * "A confused program SHOULD scream" - John Carmack
  *
- * These utilities are the ANTITHESIS of defensive programming.
+ * Throw, always. An uncaught Panic crashes the process with a full stack trace.
+ * Zero dependencies. Works identically in Node, Deno, Bun, and browsers.
  *
- * Defensive programming: try/catch, error recovery, graceful degradation, silent failures
- * Offensive programming: FAIL LOUD, FAIL FAST, NO RECOVERY, CRASH EARLY
+ * Four primitives:
+ *   assert(cond, ...msg)   - invariant checking, narrows types
+ *   panic(...msg)          - impossible state reached
+ *   must(() => expr)       - unwrap-or-die for operations (sync + async)
+ *   unwrap(value, ...msg)  - unwrap nullable values
  *
- * We don't handle errors - we make them catastrophic.
- * We don't recover - we crash.
- * We don't validate and continue - we assert and panic.
+ * must() replaces the old try/catch/check pattern:
  *
- * This approach makes bugs IMPOSSIBLE to ignore:
- * - Wrong assumptions? CRASH
- * - Invalid state? CRASH
- * - "Impossible" error? CRASH
+ *   // before: 5 lines
+ *   try {
+ *     const data = readFileSync(path, 'utf-8')
+ *     return data
+ *   } catch (err) {
+ *     check(err)
+ *   }
  *
- * The only acceptable response to confusion is to scream and die.
+ *   // after: 1 line
+ *   return must(() => readFileSync(path, 'utf-8'))
  */
-import { log } from './universal/log.js';
-import { runtime } from './runtime.js';
 /**
- * Assert exits with error if condition is false.
- * Use for validating preconditions and invariants.
+ * Distinct error class for offensive programming failures.
+ * Distinguishes bugs from runtime errors at catch boundaries.
  *
  * @example
- * function sendPacket(data: Buffer, port: number) {
- *   assert(data.length > 0, 'empty packet')
- *   assert(port > 0 && port < 65536, 'invalid port:', port)
- *   // Now safe to proceed
- * }
+ * // In a server — let Panics crash, handle everything else
+ * app.use((err, req, res, next) => {
+ *   if (err instanceof Panic) throw err  // bug, re-throw, let it crash
+ *   res.status(500).json({ error: 'internal error' })
+ * })
+ *
+ * // In tests — assert that code panics
+ * expect(() => assert(false, 'boom')).toThrow(Panic)
  */
-export function assert(condition, ...msg) {
-    if (!condition) {
-        const message = msg.length > 0 ? msg.join(' ') : 'assertion failed';
-        log.error(message);
-        runtime.exit(1);
+export class Panic extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'Panic';
     }
 }
 /**
- * Must unwraps a value that may throw and exits if error occurs.
- * Use for operations that should never fail in correct code.
+ * Assert throws if condition is false. Narrows types via `asserts condition`.
  *
  * @example
- * const data = must(() => JSON.parse(staticJsonString))
- * const regex = must(() => new RegExp('^\\d+$'))
+ * assert(data.length > 0, 'empty packet')
+ * assert(port > 0 && port < 65536, 'invalid port:', port)
  */
-export function must(fn) {
-    try {
-        return fn();
-    }
-    catch (error) {
-        log.error(error);
-        return runtime.exit(1);
-    }
+export function assert(condition, ...msg) {
+    if (!condition)
+        throw new Panic(msg.join(' ') || 'assertion failed');
 }
 /**
- * Check exits cleanly with formatted error message if error is not null/undefined.
- * Use for expected errors: file not found, network issues, permissions, etc.
+ * Panic throws immediately. Use when the program reaches an impossible state.
  *
  * @example
- * try {
- *   const data = await fs.readFile(userFile)
- * } catch (err) {
- *   check(err) // exits with error message
+ * switch (state) {
+ *   case 'ready': handleReady(); break
+ *   case 'loading': handleLoading(); break
+ *   default: panic('impossible state:', state)
  * }
  */
-export function check(err, ...messages) {
-    if (err) {
-        if (messages.length > 0) {
-            log.error(messages.join(' '));
-        }
-        else {
-            log.error(err);
+export function panic(...msg) {
+    throw new Panic(msg.join(' ') || 'panic');
+}
+export function must(fn) {
+    try {
+        const result = fn();
+        if (result instanceof Promise) {
+            return result.catch(e => {
+                throw new Panic(e instanceof Error ? e.message : String(e));
+            });
         }
-        runtime.exit(1);
+        return result;
+    }
+    catch (e) {
+        throw new Panic(e instanceof Error ? e.message : String(e));
     }
 }
 /**
- * Panic immediately exits with error message.
- * Use when the program reaches an impossible state.
+ * Unwrap a nullable value or throw. Like Rust's .unwrap()/.expect().
+ * Returns T from T | null | undefined with type narrowing in one expression.
  *
  * @example
- * switch (state) {
- *   case 'ready': handleReady(); break
- *   case 'loading': handleLoading(); break
- *   default: panic('impossible state:', state)
- * }
+ * // assert needs two statements:
+ * const user = db.findUser(id)
+ * assert(user !== null, 'user not found:', id)
+ *
+ * // unwrap does it inline:
+ * const user = unwrap(db.findUser(id), 'user not found:', id)
+ * const el = unwrap(document.getElementById('app'))
  */
-export function panic(...msg) {
-    const message = msg.length > 0 ? msg.join(' ') : 'panic';
-    log.error(message);
-    return runtime.exit(1);
+export function unwrap(value, ...msg) {
+    if (value == null)
+        throw new Panic(msg.join(' ') || `unwrap: got ${value}`);
+    return value;
 }
 export const offensive = {
+    Panic,
     assert,
-    must,
-    check,
     panic,
+    must,
+    unwrap,
 };
 //# sourceMappingURL=offensive.js.map

package/dist/offensive.js.map

@@ -1 +1 @@
-{"version":3,"file":"offensive.js","sourceRoot":"","sources":["../src/offensive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,MAAM,CAAC,SAAkB,EAAE,GAAG,GAAU;IACtD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAA;QACnE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,IAAI,CAAI,EAAW;IACjC,IAAI,CAAC;QACH,OAAO,EAAE,EAAE,CAAA;IACb,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QAChB,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAU,CAAA;IACjC,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,KAAK,CAAC,GAAQ,EAAE,GAAG,QAAkB;IACnD,IAAI,GAAG,EAAE,CAAC;QACR,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;QAC/B,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAChB,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,KAAK,CAAC,GAAG,GAAU;IACjC,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;IACxD,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAClB,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACxB,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,MAAM;IACN,IAAI;IACJ,KAAK;IACL,KAAK;CACN,CAAA"}
+{"version":3,"file":"offensive.js","sourceRoot":"","sources":["../src/offensive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,KAAM,SAAQ,KAAK;IAC9B,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,OAAO,CAAA;IACrB,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CAAC,SAAkB,EAAE,GAAG,GAAU;IACtD,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,CAAA;AACtE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,KAAK,CAAC,GAAG,GAAU;IACjC,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,CAAA;AAC3C,CAAC;AAYD,MAAM,UAAU,IAAI,CAAI,EAAwB;IAC9C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,EAAE,EAAE,CAAA;QACnB,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;YAC9B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;gBACtB,MAAM,IAAI,KAAK,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;YAC7D,CAAC,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7D,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,MAAM,CAAI,KAA2B,EAAE,GAAG,GAAU;IAClE,IAAI,KAAK,IAAI,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,eAAe,KAAK,EAAE,CAAC,CAAA;IAC3E,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,KAAK;IACL,MAAM;IACN,KAAK;IACL,IAAI;IACJ,MAAM;CACP,CAAA"}

package/dist/platform/dir.d.ts

@@ -1,9 +1,9 @@
 /**
- * Directory operations that exit on error (offensive programming style)
+ * Directory operations that throw on error (offensive programming style)
  */
 declare class DirOps {
     /**
-     * Create a directory (including parents) and exit on error
+     * Create a directory (including parents). Throws on error.
      */
     create(path: string): void;
     /**
@@ -11,11 +11,11 @@ declare class DirOps {
      */
     exists(path: string): boolean;
     /**
-     * Remove a directory and all its contents, exit on error
+     * Remove a directory and all its contents. Throws on error.
      */
     remove(path: string): void;
     /**
-     * List all entries in a directory, exit on error
+     * List all entries in a directory. Throws on error.
      */
     list(path: string): string[];
     /**
@@ -23,15 +23,15 @@ declare class DirOps {
      */
     listFull(dirPath: string): string[];
     /**
-     * List only subdirectories
+     * List only subdirectories. Throws on error.
      */
     listDirs(path: string): string[];
     /**
-     * List only files (not directories)
+     * List only files (not directories). Throws on error.
      */
     listFiles(path: string): string[];
     /**
-     * Check if directory is empty
+     * Check if directory is empty. Throws on error.
      */
     isEmpty(path: string): boolean;
 }

package/dist/platform/dir.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dir.d.ts","sourceRoot":"","sources":["../../src/platform/dir.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,cAAM,MAAM;IACV;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ1B;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAU7B;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ1B;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAS5B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAKnC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAYhC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAYjC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAS/B;AAED,eAAO,MAAM,GAAG,QAAe,CAAA"}
+{"version":3,"file":"dir.d.ts","sourceRoot":"","sources":["../../src/platform/dir.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,cAAM,MAAM;IACV;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI1B;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAU7B;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI1B;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAI5B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAKnC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAMhC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAMjC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAG/B;AAED,eAAO,MAAM,GAAG,QAAe,CAAA"}

package/dist/platform/dir.js

@@ -1,20 +1,15 @@
 import { mkdirSync, existsSync, statSync, rmSync, readdirSync } from 'fs';
-import { check } from '../offensive.js';
+import { must } from '../offensive.js';
 import { path } from './path.js';
 /**
- * Directory operations that exit on error (offensive programming style)
+ * Directory operations that throw on error (offensive programming style)
  */
 class DirOps {
     /**
-     * Create a directory (including parents) and exit on error
+     * Create a directory (including parents). Throws on error.
      */
     create(path) {
-        try {
-            mkdirSync(path, { recursive: true, mode: 0o755 });
-        }
-        catch (err) {
-            check(err);
-        }
+        must(() => mkdirSync(path, { recursive: true, mode: 0o755 }));
     }
     /**
      * Check if directory exists
@@ -31,27 +26,16 @@ class DirOps {
         }
     }
     /**
-     * Remove a directory and all its contents, exit on error
+     * Remove a directory and all its contents. Throws on error.
      */
     remove(path) {
-        try {
-            rmSync(path, { recursive: true, force: true });
-        }
-        catch (err) {
-            check(err);
-        }
+        must(() => rmSync(path, { recursive: true, force: true }));
     }
     /**
-     * List all entries in a directory, exit on error
+     * List all entries in a directory. Throws on error.
      */
     list(path) {
-        try {
-            return readdirSync(path);
-        }
-        catch (err) {
-            check(err);
-            throw err;
-        }
+        return must(() => readdirSync(path));
     }
     /**
      * List full paths of all entries in a directory
@@ -61,47 +45,26 @@ class DirOps {
         return names.map(name => path.join(dirPath, name));
     }
     /**
-     * List only subdirectories
+     * List only subdirectories. Throws on error.
      */
     listDirs(path) {
-        try {
-            const entries = readdirSync(path, { withFileTypes: true });
-            return entries
-                .filter(entry => entry.isDirectory())
-                .map(entry => entry.name);
-        }
-        catch (err) {
-            check(err);
-            throw err;
-        }
+        return must(() => readdirSync(path, { withFileTypes: true }))
+            .filter(entry => entry.isDirectory())
+            .map(entry => entry.name);
     }
     /**
-     * List only files (not directories)
+     * List only files (not directories). Throws on error.
      */
     listFiles(path) {
-        try {
-            const entries = readdirSync(path, { withFileTypes: true });
-            return entries
-                .filter(entry => entry.isFile())
-                .map(entry => entry.name);
-        }
-        catch (err) {
-            check(err);
-            throw err;
-        }
+        return must(() => readdirSync(path, { withFileTypes: true }))
+            .filter(entry => entry.isFile())
+            .map(entry => entry.name);
     }
     /**
-     * Check if directory is empty
+     * Check if directory is empty. Throws on error.
      */
     isEmpty(path) {
-        try {
-            const entries = readdirSync(path);
-            return entries.length === 0;
-        }
-        catch (err) {
-            check(err);
-            throw err;
-        }
+        return must(() => readdirSync(path)).length === 0;
     }
 }
 export const dir = new DirOps();

package/dist/platform/dir.js.map

@@ -1 +1 @@
-{"version":3,"file":"dir.js","sourceRoot":"","sources":["../../src/platform/dir.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dir.js","sourceRoot":"","sources":["../../src/platform/dir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,IAAI,CAAA;AACzE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC;;GAEG;AACH,MAAM,MAAM;IACV;;OAEG;IACH,MAAM,CAAC,IAAY;QACjB,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;IAC/D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAY;QACjB,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,OAAO,KAAK,CAAA;YACnC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;YAC5B,OAAO,KAAK,CAAC,WAAW,EAAE,CAAA;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAA;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAY;QACjB,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IAC5D,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,IAAY;QACf,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAA;IACtC,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,OAAe;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAChC,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAA;IACpD,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;aAC1D,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;aACpC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC7B,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;aAC1D,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;aAC/B,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC7B,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAA;IACnD,CAAC;CACF;AAED,MAAM,CAAC,MAAM,GAAG,GAAG,IAAI,MAAM,EAAE,CAAA"}

package/dist/platform/file.d.ts

@@ -1,5 +1,5 @@
 /**
- * File operations that exit on error (offensive programming style)
+ * File operations that throw on error (offensive programming style)
  */
 declare class FileOps {
     /**
@@ -7,16 +7,15 @@ declare class FileOps {
      * This allows us to resolve relative paths from the calling module
      */
     getCallerUrl(): string | undefined;
+    private resolvePath;
     /**
-     * Read a file and exit on error
-     * Relative paths (./file.txt) are resolved from the calling module
-     * Absolute paths are used as-is
+     * Read a file as Buffer. Throws on error.
+     * Relative paths resolved from calling module.
      */
     read(filePath: string): Buffer;
     /**
-     * Read a file as string and exit on error
-     * Relative paths (./file.txt) are resolved from the calling module
-     * Absolute paths are used as-is
+     * Read a file as string. Throws on error.
+     * Relative paths resolved from calling module.
      *
      * @param filePath - Path to the file
      * @param encodingOrUrl - Optional: encoding (e.g. 'utf-8') or import.meta.url for explicit resolution
@@ -24,27 +23,24 @@ declare class FileOps {
      */
     readText(filePath: string, encodingOrUrl?: BufferEncoding | string, encoding?: BufferEncoding): string;
     /**
-     * Write data to a file and exit on error
-     * Relative paths (./file.txt) are resolved from the calling module
-     * Absolute paths are used as-is
+     * Write data to a file. Throws on error.
+     * Relative paths resolved from calling module.
      */
     write(filePath: string, data: string | Buffer): void;
     /**
      * Check if file exists (not a directory)
-     * Relative paths (./file.txt) are resolved from the calling module
-     * Absolute paths are used as-is
      */
     exists(filePath: string): boolean;
     /**
-     * Remove a file and exit on error
+     * Remove a file. Throws on error.
      */
     remove(path: string): void;
     /**
-     * Get file size in bytes
+     * Get file size in bytes. Throws on error.
      */
     size(path: string): number;
     /**
-     * Get file modification time
+     * Get file modification time. Throws on error.
      */
     mtime(path: string): Date;
 }

package/dist/platform/file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/platform/file.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,cAAM,OAAO;IACX;;;OAGG;IACH,YAAY,IAAI,MAAM,GAAG,SAAS;IA2DlC;;;;OAIG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAkB9B;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,cAAc,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,MAAM;IAkCtG;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAiBpD;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAmBjC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ1B;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAU1B;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAS1B;AAED,eAAO,MAAM,IAAI,SAAgB,CAAA"}
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/platform/file.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,cAAM,OAAO;IACX;;;OAGG;IACH,YAAY,IAAI,MAAM,GAAG,SAAS;IA2DlC,OAAO,CAAC,WAAW;IAWnB;;;OAGG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAK9B;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,cAAc,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,MAAM;IAwBtG;;;OAGG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKpD;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAWjC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI1B;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI1B;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAG1B;AAED,eAAO,MAAM,IAAI,SAAgB,CAAA"}

package/dist/platform/file.js

@@ -1,8 +1,8 @@
 import { readFileSync, writeFileSync, existsSync, unlinkSync, statSync } from 'fs';
-import { check } from '../offensive.js';
+import { must } from '../offensive.js';
 import { path } from './path.js';
 /**
- * File operations that exit on error (offensive programming style)
+ * File operations that throw on error (offensive programming style)
  */
 class FileOps {
     /**
@@ -18,7 +18,7 @@ class FileOps {
         // Stack looks like:
         // Error
         //   at FileOps.getCallerUrl (file:///path/to/file.ts:line:col)
-        //   at FileOps.readText (file:///path/to/file.ts:line:col)  
+        //   at FileOps.readText (file:///path/to/file.ts:line:col)
         //   at caller (file:///path/to/caller.ts:line:col) <- we want this
         const lines = stack.split('\n');
         // Try multiple regex patterns for different environments
@@ -57,112 +57,71 @@ class FileOps {
         }
         return undefined;
     }
+    resolvePath(filePath) {
+        if (filePath.startsWith('./') || filePath.startsWith('../')) {
+            const callerUrl = this.getCallerUrl();
+            return path.resolve(filePath, callerUrl);
+        }
+        if (!path.isAbsolute(filePath)) {
+            return path.resolve(filePath);
+        }
+        return filePath;
+    }
     /**
-     * Read a file and exit on error
-     * Relative paths (./file.txt) are resolved from the calling module
-     * Absolute paths are used as-is
+     * Read a file as Buffer. Throws on error.
+     * Relative paths resolved from calling module.
      */
     read(filePath) {
-        try {
-            // Auto-detect caller for relative paths
-            let resolvedPath = filePath;
-            if (filePath.startsWith('./') || filePath.startsWith('../')) {
-                const callerUrl = this.getCallerUrl();
-                resolvedPath = path.resolve(filePath, callerUrl);
-            }
-            else if (!path.isAbsolute(filePath)) {
-                resolvedPath = path.resolve(filePath);
-            }
-            return readFileSync(resolvedPath);
-        }
-        catch (err) {
-            check(err);
-            throw err; // TypeScript needs this even though check exits
-        }
+        const resolved = this.resolvePath(filePath);
+        return must(() => readFileSync(resolved));
     }
     /**
-     * Read a file as string and exit on error
-     * Relative paths (./file.txt) are resolved from the calling module
-     * Absolute paths are used as-is
+     * Read a file as string. Throws on error.
+     * Relative paths resolved from calling module.
      *
      * @param filePath - Path to the file
      * @param encodingOrUrl - Optional: encoding (e.g. 'utf-8') or import.meta.url for explicit resolution
      * @param encoding - Optional: encoding when second param is import.meta.url
      */
     readText(filePath, encodingOrUrl, encoding) {
-        try {
-            // Determine if second param is encoding or URL
-            let callerUrl;
-            let actualEncoding = 'utf-8';
-            if (encodingOrUrl) {
-                if (encodingOrUrl.startsWith('file://') || encodingOrUrl.includes('/')) {
-                    // It's a URL/path
-                    callerUrl = encodingOrUrl;
-                    actualEncoding = encoding || 'utf-8';
-                }
-                else {
-                    // It's an encoding
-                    actualEncoding = encodingOrUrl;
-                }
-            }
-            // Auto-detect caller for relative paths
-            let resolvedPath = filePath;
-            if (filePath.startsWith('./') || filePath.startsWith('../')) {
-                // Use explicit URL if provided, otherwise detect from stack
-                const url = callerUrl || this.getCallerUrl();
-                resolvedPath = path.resolve(filePath, url);
+        let callerUrl;
+        let actualEncoding = 'utf-8';
+        if (encodingOrUrl) {
+            if (encodingOrUrl.startsWith('file://') || encodingOrUrl.includes('/')) {
+                callerUrl = encodingOrUrl;
+                actualEncoding = encoding || 'utf-8';
             }
-            else if (!path.isAbsolute(filePath)) {
-                resolvedPath = path.resolve(filePath);
+            else {
+                actualEncoding = encodingOrUrl;
             }
-            return readFileSync(resolvedPath, actualEncoding);
         }
-        catch (err) {
-            check(err);
-            throw err;
+        let resolvedPath = filePath;
+        if (filePath.startsWith('./') || filePath.startsWith('../')) {
+            const url = callerUrl || this.getCallerUrl();
+            resolvedPath = path.resolve(filePath, url);
         }
+        else if (!path.isAbsolute(filePath)) {
+            resolvedPath = path.resolve(filePath);
+        }
+        return must(() => readFileSync(resolvedPath, actualEncoding));
     }
     /**
-     * Write data to a file and exit on error
-     * Relative paths (./file.txt) are resolved from the calling module
-     * Absolute paths are used as-is
+     * Write data to a file. Throws on error.
+     * Relative paths resolved from calling module.
      */
     write(filePath, data) {
-        try {
-            // Auto-detect caller for relative paths
-            let resolvedPath = filePath;
-            if (filePath.startsWith('./') || filePath.startsWith('../')) {
-                const callerUrl = this.getCallerUrl();
-                resolvedPath = path.resolve(filePath, callerUrl);
-            }
-            else if (!path.isAbsolute(filePath)) {
-                resolvedPath = path.resolve(filePath);
-            }
-            writeFileSync(resolvedPath, data, { mode: 0o644 });
-        }
-        catch (err) {
-            check(err);
-        }
+        const resolved = this.resolvePath(filePath);
+        must(() => writeFileSync(resolved, data, { mode: 0o644 }));
     }
     /**
      * Check if file exists (not a directory)
-     * Relative paths (./file.txt) are resolved from the calling module
-     * Absolute paths are used as-is
      */
     exists(filePath) {
         try {
-            // Auto-detect caller for relative paths
-            let resolvedPath = filePath;
-            if (filePath.startsWith('./') || filePath.startsWith('../')) {
-                const callerUrl = this.getCallerUrl();
-                resolvedPath = path.resolve(filePath, callerUrl);
-            }
-            else if (!path.isAbsolute(filePath)) {
-                resolvedPath = path.resolve(filePath);
-            }
-            if (!existsSync(resolvedPath))
+            const resolved = this.resolvePath(filePath);
+            if (!existsSync(resolved))
                 return false;
-            const stats = statSync(resolvedPath);
+            const stats = statSync(resolved);
             return stats.isFile();
         }
         catch {
@@ -170,41 +129,22 @@ class FileOps {
         }
     }
     /**
-     * Remove a file and exit on error
+     * Remove a file. Throws on error.
      */
     remove(path) {
-        try {
-            unlinkSync(path);
-        }
-        catch (err) {
-            check(err);
-        }
+        must(() => unlinkSync(path));
     }
     /**
-     * Get file size in bytes
+     * Get file size in bytes. Throws on error.
      */
     size(path) {
-        try {
-            const stats = statSync(path);
-            return stats.size;
-        }
-        catch (err) {
-            check(err);
-            throw err;
-        }
+        return must(() => statSync(path)).size;
     }
     /**
-     * Get file modification time
+     * Get file modification time. Throws on error.
      */
     mtime(path) {
-        try {
-            const stats = statSync(path);
-            return stats.mtime;
-        }
-        catch (err) {
-            check(err);
-            throw err;
-        }
+        return must(() => statSync(path)).mtime;
     }
 }
 export const file = new FileOps();

package/dist/platform/file.js.map

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

package/dist/platform/xdg.d.ts

@@ -0,0 +1,8 @@
+export declare const xdg: {
+    config: (...segments: string[]) => string;
+    data: (...segments: string[]) => string;
+    state: (...segments: string[]) => string;
+    cache: (...segments: string[]) => string;
+    runtime: (...segments: string[]) => string;
+};
+//# sourceMappingURL=xdg.d.ts.map

package/dist/platform/xdg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xdg.d.ts","sourceRoot":"","sources":["../../src/platform/xdg.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,GAAG;0BACS,MAAM,EAAE;wBACR,MAAM,EAAE;yBACR,MAAM,EAAE;yBACR,MAAM,EAAE;2BACR,MAAM,EAAE;CAChC,CAAA"}

package/dist/platform/xdg.js

@@ -0,0 +1,12 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const home = homedir();
+const env = (key, fallback) => process.env[key] || fallback;
+export const xdg = {
+    config: (...segments) => join(env('XDG_CONFIG_HOME', join(home, '.config')), ...segments),
+    data: (...segments) => join(env('XDG_DATA_HOME', join(home, '.local', 'share')), ...segments),
+    state: (...segments) => join(env('XDG_STATE_HOME', join(home, '.local', 'state')), ...segments),
+    cache: (...segments) => join(env('XDG_CACHE_HOME', join(home, '.cache')), ...segments),
+    runtime: (...segments) => join(env('XDG_RUNTIME_DIR', join(home, '.local', 'run')), ...segments),
+};
+//# sourceMappingURL=xdg.js.map

package/dist/platform/xdg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xdg.js","sourceRoot":"","sources":["../../src/platform/xdg.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,MAAM,IAAI,GAAG,OAAO,EAAE,CAAA;AACtB,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,QAAgB,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAA;AAE3E,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,MAAM,EAAG,CAAC,GAAG,QAAkB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC;IACpG,IAAI,EAAK,CAAC,GAAG,QAAkB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC;IAC1G,KAAK,EAAI,CAAC,GAAG,QAAkB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC;IAC3G,KAAK,EAAI,CAAC,GAAG,QAAkB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC;IAClG,OAAO,EAAE,CAAC,GAAG,QAAkB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC;CAC3G,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adriangalilea/utils",
-  "version": "0.0.10",
+  "version": "0.2.0",
   "description": "TypeScript utilities - logger, currency, formatter, and more",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -32,6 +32,18 @@
   "files": [
     "dist"
   ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "test": "echo 'Tests not configured yet'",
+    "test:runtime": "tsx tests/runtime-test.ts",
+    "test:browser": "open tests/browser-test.html",
+    "example": "tsx tests/example.ts",
+    "update-crypto": "tsx src/universal/currency/download-crypto-list.ts",
+    "type-check": "tsc --noEmit",
+    "lint": "echo 'No linter configured yet'",
+    "prepublishOnly": "pnpm run build"
+  },
   "keywords": [
     "typescript",
     "utils",
@@ -60,16 +72,5 @@
   "bugs": {
     "url": "https://github.com/adriangalilea/ts-utils/issues"
   },
-  "homepage": "https://github.com/adriangalilea/ts-utils#readme",
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsx src/index.ts",
-    "test": "echo 'Tests not configured yet'",
-    "test:runtime": "tsx tests/runtime-test.ts",
-    "test:browser": "open tests/browser-test.html",
-    "example": "tsx tests/example.ts",
-    "update-crypto": "tsx src/universal/currency/download-crypto-list.ts",
-    "type-check": "tsc --noEmit",
-    "lint": "echo 'No linter configured yet'"
-  }
+  "homepage": "https://github.com/adriangalilea/ts-utils#readme"
 }