@holoscript/std 3.1.1 → 7.0.0

package/dist/time.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/time.ts"],"sourcesContent":["/**\n * @holoscript/std - Time Module\n *\n * Time, timer, and scheduling utilities for HoloScript Plus programs.\n */\n\n/**\n * Get current timestamp in milliseconds\n */\nexport function now(): number {\n  return Date.now();\n}\n\n/**\n * Get high-resolution timestamp (for performance measurement)\n */\nexport function hrTime(): number {\n  if (typeof performance !== 'undefined') {\n    return performance.now();\n  }\n  return Date.now();\n}\n\n/**\n * Sleep for a specified number of milliseconds\n */\nexport function sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/**\n * Wait until a condition is true\n */\nexport async function waitUntil(\n  condition: () => boolean | Promise<boolean>,\n  options: { timeout?: number; interval?: number } = {}\n): Promise<void> {\n  const { timeout = 30000, interval = 100 } = options;\n  const startTime = now();\n\n  while (true) {\n    if (await condition()) return;\n    if (now() - startTime > timeout) {\n      throw new Error('waitUntil timeout');\n    }\n    await sleep(interval);\n  }\n}\n\n/**\n * Execute a function with timeout\n */\nexport async function withTimeout<T>(fn: () => Promise<T>, ms: number): Promise<T> {\n  return Promise.race([\n    fn(),\n    new Promise<T>((_, reject) => setTimeout(() => reject(new Error('Timeout')), ms)),\n  ]);\n}\n\n/**\n * Retry a function with exponential backoff\n */\nexport async function retry<T>(\n  fn: () => Promise<T>,\n  options: {\n    maxAttempts?: number;\n    initialDelay?: number;\n    maxDelay?: number;\n    factor?: number;\n    onRetry?: (error: Error, attempt: number) => void;\n  } = {}\n): Promise<T> {\n  const { maxAttempts = 3, initialDelay = 1000, maxDelay = 30000, factor = 2, onRetry } = options;\n\n  let lastError: Error;\n  let delay = initialDelay;\n\n  for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n    try {\n      return await fn();\n    } catch (error) {\n      lastError = error instanceof Error ? error : new Error(String(error));\n\n      if (attempt === maxAttempts) break;\n\n      onRetry?.(lastError, attempt);\n      await sleep(delay);\n      delay = Math.min(delay * factor, maxDelay);\n    }\n  }\n\n  throw lastError!;\n}\n\n/**\n * Debounce a function\n */\nexport function debounce<T extends (...args: unknown[]) => unknown>(fn: T, ms: number): T {\n  let timeoutId: ReturnType<typeof setTimeout> | null = null;\n\n  return ((...args: unknown[]) => {\n    if (timeoutId) clearTimeout(timeoutId);\n    timeoutId = setTimeout(() => {\n      timeoutId = null;\n      fn(...args);\n    }, ms);\n  }) as T;\n}\n\n/**\n * Throttle a function\n */\nexport function throttle<T extends (...args: unknown[]) => unknown>(fn: T, ms: number): T {\n  let lastCall = 0;\n  let timeoutId: ReturnType<typeof setTimeout> | null = null;\n\n  return ((...args: unknown[]) => {\n    const elapsed = now() - lastCall;\n\n    if (elapsed >= ms) {\n      lastCall = now();\n      fn(...args);\n    } else if (!timeoutId) {\n      timeoutId = setTimeout(() => {\n        lastCall = now();\n        timeoutId = null;\n        fn(...args);\n      }, ms - elapsed);\n    }\n  }) as T;\n}\n\n/**\n * Measure execution time of a function\n */\nexport async function measure<T>(\n  fn: () => T | Promise<T>\n): Promise<{ result: T; duration: number }> {\n  const start = hrTime();\n  const result = await fn();\n  const duration = hrTime() - start;\n  return { result, duration };\n}\n\n/**\n * Measure execution time and log it\n */\nexport async function timed<T>(label: string, fn: () => T | Promise<T>): Promise<T> {\n  const start = hrTime();\n  try {\n    return await fn();\n  } finally {\n    const duration = hrTime() - start;\n    void duration; // timing available for callers via return value\n  }\n}\n\n/**\n * Simple stopwatch for measuring elapsed time\n */\nexport class Stopwatch {\n  private startTime: number = 0;\n  private pausedTime: number = 0;\n  private running: boolean = false;\n\n  start(): this {\n    if (!this.running) {\n      this.startTime = hrTime() - this.pausedTime;\n      this.running = true;\n    }\n    return this;\n  }\n\n  stop(): number {\n    if (this.running) {\n      this.pausedTime = hrTime() - this.startTime;\n      this.running = false;\n    }\n    return this.pausedTime;\n  }\n\n  reset(): this {\n    this.startTime = 0;\n    this.pausedTime = 0;\n    this.running = false;\n    return this;\n  }\n\n  restart(): this {\n    return this.reset().start();\n  }\n\n  get elapsed(): number {\n    if (this.running) {\n      return hrTime() - this.startTime;\n    }\n    return this.pausedTime;\n  }\n\n  get isRunning(): boolean {\n    return this.running;\n  }\n\n  lap(): number {\n    const elapsed = this.elapsed;\n    this.restart();\n    return elapsed;\n  }\n}\n\n/**\n * Interval timer with pause/resume support\n */\nexport class IntervalTimer {\n  private intervalId: ReturnType<typeof setInterval> | null = null;\n  private callback: () => void;\n  private intervalMs: number;\n  private isPaused: boolean = false;\n\n  constructor(callback: () => void, intervalMs: number) {\n    this.callback = callback;\n    this.intervalMs = intervalMs;\n  }\n\n  start(): this {\n    if (!this.intervalId && !this.isPaused) {\n      this.intervalId = setInterval(this.callback, this.intervalMs);\n    }\n    return this;\n  }\n\n  stop(): this {\n    if (this.intervalId) {\n      clearInterval(this.intervalId);\n      this.intervalId = null;\n    }\n    this.isPaused = false;\n    return this;\n  }\n\n  pause(): this {\n    if (this.intervalId) {\n      clearInterval(this.intervalId);\n      this.intervalId = null;\n      this.isPaused = true;\n    }\n    return this;\n  }\n\n  resume(): this {\n    if (this.isPaused) {\n      this.isPaused = false;\n      this.intervalId = setInterval(this.callback, this.intervalMs);\n    }\n    return this;\n  }\n\n  get running(): boolean {\n    return this.intervalId !== null;\n  }\n\n  get paused(): boolean {\n    return this.isPaused;\n  }\n}\n\n/**\n * Countdown timer\n */\nexport class CountdownTimer {\n  private remainingMs: number;\n  private startTime: number = 0;\n  private running: boolean = false;\n  private onTick?: (remaining: number) => void;\n  private onComplete?: () => void;\n  private tickIntervalId: ReturnType<typeof setInterval> | null = null;\n\n  constructor(\n    durationMs: number,\n    options: {\n      onTick?: (remaining: number) => void;\n      onComplete?: () => void;\n      tickInterval?: number;\n    } = {}\n  ) {\n    this.remainingMs = durationMs;\n    this.onTick = options.onTick;\n    this.onComplete = options.onComplete;\n\n    if (options.onTick && options.tickInterval) {\n      this.tickIntervalId = setInterval(() => {\n        if (this.running) {\n          this.onTick?.(this.remaining);\n        }\n      }, options.tickInterval);\n    }\n  }\n\n  start(): this {\n    if (!this.running && this.remainingMs > 0) {\n      this.startTime = hrTime();\n      this.running = true;\n      this.scheduleCompletion();\n    }\n    return this;\n  }\n\n  pause(): this {\n    if (this.running) {\n      this.remainingMs = Math.max(0, this.remainingMs - (hrTime() - this.startTime));\n      this.running = false;\n    }\n    return this;\n  }\n\n  resume(): this {\n    return this.start();\n  }\n\n  reset(durationMs?: number): this {\n    this.running = false;\n    this.remainingMs = durationMs ?? this.remainingMs;\n    return this;\n  }\n\n  stop(): this {\n    this.running = false;\n    if (this.tickIntervalId) {\n      clearInterval(this.tickIntervalId);\n      this.tickIntervalId = null;\n    }\n    return this;\n  }\n\n  get remaining(): number {\n    if (this.running) {\n      return Math.max(0, this.remainingMs - (hrTime() - this.startTime));\n    }\n    return this.remainingMs;\n  }\n\n  get isRunning(): boolean {\n    return this.running;\n  }\n\n  get isComplete(): boolean {\n    return this.remaining <= 0;\n  }\n\n  private scheduleCompletion(): void {\n    setTimeout(() => {\n      if (this.running && this.remaining <= 0) {\n        this.running = false;\n        this.onComplete?.();\n      }\n    }, this.remainingMs);\n  }\n}\n\n/**\n * Frame-based timer for game loops\n */\nexport class FrameTimer {\n  private lastFrameTime: number = 0;\n  private deltaTime: number = 0;\n  private frameCount: number = 0;\n  private fps: number = 0;\n  private fpsUpdateInterval: number = 1000;\n  private lastFpsUpdate: number = 0;\n  private framesSinceLastFpsUpdate: number = 0;\n\n  /**\n   * Call at the start of each frame\n   */\n  update(): void {\n    const currentTime = hrTime();\n\n    if (this.lastFrameTime > 0) {\n      this.deltaTime = (currentTime - this.lastFrameTime) / 1000; // Convert to seconds\n    }\n\n    this.lastFrameTime = currentTime;\n    this.frameCount++;\n    this.framesSinceLastFpsUpdate++;\n\n    // Update FPS calculation\n    if (currentTime - this.lastFpsUpdate >= this.fpsUpdateInterval) {\n      this.fps = (this.framesSinceLastFpsUpdate * 1000) / (currentTime - this.lastFpsUpdate);\n      this.lastFpsUpdate = currentTime;\n      this.framesSinceLastFpsUpdate = 0;\n    }\n  }\n\n  /**\n   * Get delta time in seconds since last frame\n   */\n  get delta(): number {\n    return this.deltaTime;\n  }\n\n  /**\n   * Get delta time in milliseconds since last frame\n   */\n  get deltaMs(): number {\n    return this.deltaTime * 1000;\n  }\n\n  /**\n   * Get total frame count\n   */\n  get frames(): number {\n    return this.frameCount;\n  }\n\n  /**\n   * Get current FPS (frames per second)\n   */\n  get currentFps(): number {\n    return this.fps;\n  }\n\n  /**\n   * Get total elapsed time in seconds\n   */\n  get totalTime(): number {\n    return this.lastFrameTime / 1000;\n  }\n\n  /**\n   * Reset the timer\n   */\n  reset(): void {\n    this.lastFrameTime = 0;\n    this.deltaTime = 0;\n    this.frameCount = 0;\n    this.fps = 0;\n    this.lastFpsUpdate = 0;\n    this.framesSinceLastFpsUpdate = 0;\n  }\n}\n\n/**\n * Schedule a callback to run after a delay\n */\nexport function schedule(callback: () => void, delayMs: number): () => void {\n  const timeoutId = setTimeout(callback, delayMs);\n  return () => clearTimeout(timeoutId);\n}\n\n/**\n * Schedule a callback to run at regular intervals\n */\nexport function scheduleInterval(callback: () => void, intervalMs: number): () => void {\n  const intervalId = setInterval(callback, intervalMs);\n  return () => clearInterval(intervalId);\n}\n\n/**\n * Schedule a callback to run on the next animation frame (browser only)\n */\nexport function scheduleFrame(callback: (timestamp: number) => void): () => void {\n  if (typeof requestAnimationFrame !== 'undefined') {\n    const id = requestAnimationFrame(callback);\n    return () => cancelAnimationFrame(id);\n  }\n  // Fallback for non-browser environments\n  const id = setTimeout(() => callback(hrTime()), 16);\n  return () => clearTimeout(id);\n}\n\n/**\n * Create a ticker that calls a callback at a target frame rate\n */\nexport function createTicker(\n  callback: (delta: number) => void,\n  targetFps: number = 60\n): { start: () => void; stop: () => void } {\n  const frameTime = 1000 / targetFps;\n  let lastTime = 0;\n  let running = false;\n  let animationId: number | ReturnType<typeof setTimeout>;\n\n  const tick = (currentTime: number) => {\n    if (!running) return;\n\n    if (lastTime > 0) {\n      const delta = (currentTime - lastTime) / 1000;\n      callback(delta);\n    }\n    lastTime = currentTime;\n\n    if (typeof requestAnimationFrame !== 'undefined') {\n      animationId = requestAnimationFrame(tick);\n    } else {\n      animationId = setTimeout(() => tick(hrTime()), frameTime);\n    }\n  };\n\n  return {\n    start: () => {\n      if (!running) {\n        running = true;\n        lastTime = 0;\n        if (typeof requestAnimationFrame !== 'undefined') {\n          animationId = requestAnimationFrame(tick);\n        } else {\n          tick(hrTime());\n        }\n      }\n    },\n    stop: () => {\n      running = false;\n      if (typeof cancelAnimationFrame !== 'undefined') {\n        cancelAnimationFrame(animationId as number);\n      } else {\n        clearTimeout(animationId as ReturnType<typeof setTimeout>);\n      }\n    },\n  };\n}\n\n/**\n * Date/time formatting utilities\n */\nexport const DateTime = {\n  /**\n   * Format a date as ISO string\n   */\n  toISO(date: Date = new Date()): string {\n    return date.toISOString();\n  },\n\n  /**\n   * Format a date as local string\n   */\n  toLocal(date: Date = new Date()): string {\n    return date.toLocaleString();\n  },\n\n  /**\n   * Format a date using a pattern\n   * Supports: YYYY, MM, DD, HH, mm, ss, SSS\n   */\n  format(date: Date, pattern: string): string {\n    const pad = (n: number, width: number) => String(n).padStart(width, '0');\n\n    return pattern\n      .replace('YYYY', String(date.getFullYear()))\n      .replace('MM', pad(date.getMonth() + 1, 2))\n      .replace('DD', pad(date.getDate(), 2))\n      .replace('HH', pad(date.getHours(), 2))\n      .replace('mm', pad(date.getMinutes(), 2))\n      .replace('ss', pad(date.getSeconds(), 2))\n      .replace('SSS', pad(date.getMilliseconds(), 3));\n  },\n\n  /**\n   * Parse a date string\n   */\n  parse(dateString: string): Date {\n    return new Date(dateString);\n  },\n\n  /**\n   * Get difference between two dates in various units\n   */\n  diff(date1: Date, date2: Date, unit: 'ms' | 's' | 'm' | 'h' | 'd' = 'ms'): number {\n    const diffMs = date1.getTime() - date2.getTime();\n    switch (unit) {\n      case 'ms':\n        return diffMs;\n      case 's':\n        return diffMs / 1000;\n      case 'm':\n        return diffMs / 60000;\n      case 'h':\n        return diffMs / 3600000;\n      case 'd':\n        return diffMs / 86400000;\n    }\n  },\n\n  /**\n   * Add time to a date\n   */\n  add(date: Date, amount: number, unit: 'ms' | 's' | 'm' | 'h' | 'd'): Date {\n    const _ms = DateTime.diff(new Date(amount), new Date(0), 'ms');\n    const multipliers = { ms: 1, s: 1000, m: 60000, h: 3600000, d: 86400000 };\n    return new Date(date.getTime() + amount * multipliers[unit]);\n  },\n\n  /**\n   * Check if a date is today\n   */\n  isToday(date: Date): boolean {\n    const today = new Date();\n    return (\n      date.getDate() === today.getDate() &&\n      date.getMonth() === today.getMonth() &&\n      date.getFullYear() === today.getFullYear()\n    );\n  },\n\n  /**\n   * Get start of day\n   */\n  startOfDay(date: Date = new Date()): Date {\n    const result = new Date(date);\n    result.setHours(0, 0, 0, 0);\n    return result;\n  },\n\n  /**\n   * Get end of day\n   */\n  endOfDay(date: Date = new Date()): Date {\n    const result = new Date(date);\n    result.setHours(23, 59, 59, 999);\n    return result;\n  },\n};\n"],"mappings":"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","names":["id"]}

package/dist/time.d.ts

@@ -0,0 +1,215 @@
+/**
+ * @holoscript/std - Time Module
+ *
+ * Time, timer, and scheduling utilities for HoloScript Plus programs.
+ */
+/**
+ * Get current timestamp in milliseconds
+ */
+export declare function now(): number;
+/**
+ * Get high-resolution timestamp (for performance measurement)
+ */
+export declare function hrTime(): number;
+/**
+ * Sleep for a specified number of milliseconds
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Wait until a condition is true
+ */
+export declare function waitUntil(condition: () => boolean | Promise<boolean>, options?: {
+    timeout?: number;
+    interval?: number;
+}): Promise<void>;
+/**
+ * Execute a function with timeout
+ */
+export declare function withTimeout<T>(fn: () => Promise<T>, ms: number): Promise<T>;
+/**
+ * Retry a function with exponential backoff
+ */
+export declare function retry<T>(fn: () => Promise<T>, options?: {
+    maxAttempts?: number;
+    initialDelay?: number;
+    maxDelay?: number;
+    factor?: number;
+    onRetry?: (error: Error, attempt: number) => void;
+}): Promise<T>;
+/**
+ * Debounce a function
+ */
+export declare function debounce<T extends (...args: unknown[]) => unknown>(fn: T, ms: number): T;
+/**
+ * Throttle a function
+ */
+export declare function throttle<T extends (...args: unknown[]) => unknown>(fn: T, ms: number): T;
+/**
+ * Measure execution time of a function
+ */
+export declare function measure<T>(fn: () => T | Promise<T>): Promise<{
+    result: T;
+    duration: number;
+}>;
+/**
+ * Measure execution time and log it
+ */
+export declare function timed<T>(label: string, fn: () => T | Promise<T>): Promise<T>;
+/**
+ * Simple stopwatch for measuring elapsed time
+ */
+export declare class Stopwatch {
+    private startTime;
+    private pausedTime;
+    private running;
+    start(): this;
+    stop(): number;
+    reset(): this;
+    restart(): this;
+    get elapsed(): number;
+    get isRunning(): boolean;
+    lap(): number;
+}
+/**
+ * Interval timer with pause/resume support
+ */
+export declare class IntervalTimer {
+    private intervalId;
+    private callback;
+    private intervalMs;
+    private isPaused;
+    constructor(callback: () => void, intervalMs: number);
+    start(): this;
+    stop(): this;
+    pause(): this;
+    resume(): this;
+    get running(): boolean;
+    get paused(): boolean;
+}
+/**
+ * Countdown timer
+ */
+export declare class CountdownTimer {
+    private remainingMs;
+    private startTime;
+    private running;
+    private onTick?;
+    private onComplete?;
+    private tickIntervalId;
+    constructor(durationMs: number, options?: {
+        onTick?: (remaining: number) => void;
+        onComplete?: () => void;
+        tickInterval?: number;
+    });
+    start(): this;
+    pause(): this;
+    resume(): this;
+    reset(durationMs?: number): this;
+    stop(): this;
+    get remaining(): number;
+    get isRunning(): boolean;
+    get isComplete(): boolean;
+    private scheduleCompletion;
+}
+/**
+ * Frame-based timer for game loops
+ */
+export declare class FrameTimer {
+    private lastFrameTime;
+    private deltaTime;
+    private frameCount;
+    private fps;
+    private fpsUpdateInterval;
+    private lastFpsUpdate;
+    private framesSinceLastFpsUpdate;
+    /**
+     * Call at the start of each frame
+     */
+    update(): void;
+    /**
+     * Get delta time in seconds since last frame
+     */
+    get delta(): number;
+    /**
+     * Get delta time in milliseconds since last frame
+     */
+    get deltaMs(): number;
+    /**
+     * Get total frame count
+     */
+    get frames(): number;
+    /**
+     * Get current FPS (frames per second)
+     */
+    get currentFps(): number;
+    /**
+     * Get total elapsed time in seconds
+     */
+    get totalTime(): number;
+    /**
+     * Reset the timer
+     */
+    reset(): void;
+}
+/**
+ * Schedule a callback to run after a delay
+ */
+export declare function schedule(callback: () => void, delayMs: number): () => void;
+/**
+ * Schedule a callback to run at regular intervals
+ */
+export declare function scheduleInterval(callback: () => void, intervalMs: number): () => void;
+/**
+ * Schedule a callback to run on the next animation frame (browser only)
+ */
+export declare function scheduleFrame(callback: (timestamp: number) => void): () => void;
+/**
+ * Create a ticker that calls a callback at a target frame rate
+ */
+export declare function createTicker(callback: (delta: number) => void, targetFps?: number): {
+    start: () => void;
+    stop: () => void;
+};
+/**
+ * Date/time formatting utilities
+ */
+export declare const DateTime: {
+    /**
+     * Format a date as ISO string
+     */
+    toISO(date?: Date): string;
+    /**
+     * Format a date as local string
+     */
+    toLocal(date?: Date): string;
+    /**
+     * Format a date using a pattern
+     * Supports: YYYY, MM, DD, HH, mm, ss, SSS
+     */
+    format(date: Date, pattern: string): string;
+    /**
+     * Parse a date string
+     */
+    parse(dateString: string): Date;
+    /**
+     * Get difference between two dates in various units
+     */
+    diff(date1: Date, date2: Date, unit?: "ms" | "s" | "m" | "h" | "d"): number;
+    /**
+     * Add time to a date
+     */
+    add(date: Date, amount: number, unit: "ms" | "s" | "m" | "h" | "d"): Date;
+    /**
+     * Check if a date is today
+     */
+    isToday(date: Date): boolean;
+    /**
+     * Get start of day
+     */
+    startOfDay(date?: Date): Date;
+    /**
+     * Get end of day
+     */
+    endOfDay(date?: Date): Date;
+};
+//# sourceMappingURL=time.d.ts.map

package/dist/time.js

@@ -0,0 +1,44 @@
+import {
+  CountdownTimer,
+  DateTime,
+  FrameTimer,
+  IntervalTimer,
+  Stopwatch,
+  createTicker,
+  debounce,
+  hrTime,
+  measure,
+  now,
+  retry,
+  schedule,
+  scheduleFrame,
+  scheduleInterval,
+  sleep,
+  throttle,
+  timed,
+  waitUntil,
+  withTimeout
+} from "./chunk-ZXVZAQCZ.js";
+import "./chunk-PR4QN5HX.js";
+export {
+  CountdownTimer,
+  DateTime,
+  FrameTimer,
+  IntervalTimer,
+  Stopwatch,
+  createTicker,
+  debounce,
+  hrTime,
+  measure,
+  now,
+  retry,
+  schedule,
+  scheduleFrame,
+  scheduleInterval,
+  sleep,
+  throttle,
+  timed,
+  waitUntil,
+  withTimeout
+};
+//# sourceMappingURL=time.js.map

package/dist/time.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/traits/ARTraits.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @fileoverview AR Traits (Augmented Reality)
+ * @module @holoscript/std/traits
+ *
+ * Defines the AST traits required for augmented reality overlays
+ * and real-world physical anchoring.
+ */
+import type { TraitDefinition } from '../types.js';
+/**
+ * Standard AR traits included in HoloScript's base functionality
+ */
+export declare const ARTraits: TraitDefinition[];
+export default ARTraits;
+//# sourceMappingURL=ARTraits.d.ts.map

package/dist/traits/EconomicPrimitives.cjs

@@ -0,0 +1,335 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/traits/EconomicPrimitives.ts
+var EconomicPrimitives_exports = {};
+__export(EconomicPrimitives_exports, {
+  DEFAULT_BONDING_CURVE: () => DEFAULT_BONDING_CURVE,
+  DEFAULT_DEPRECIATION: () => DEFAULT_DEPRECIATION,
+  DEFAULT_PID: () => DEFAULT_PID,
+  DEFAULT_WEALTH_TAX: () => DEFAULT_WEALTH_TAX,
+  bondingCurveBuyCost: () => bondingCurveBuyCost,
+  bondingCurvePrice: () => bondingCurvePrice,
+  bondingCurveSellRefund: () => bondingCurveSellRefund,
+  calculateDepreciation: () => calculateDepreciation,
+  calculateRedistribution: () => calculateRedistribution,
+  calculateRepairCost: () => calculateRepairCost,
+  calculateTaxAmount: () => calculateTaxAmount,
+  calculateTaxRate: () => calculateTaxRate,
+  createDualLoopPIDState: () => createDualLoopPIDState,
+  createFaucetSinkMetrics: () => createFaucetSinkMetrics,
+  createPIDState: () => createPIDState,
+  depreciatedValue: () => depreciatedValue,
+  executeTrade: () => executeTrade,
+  generateTxHash: () => generateTxHash,
+  isDestroyed: () => isDestroyed,
+  recordFaucet: () => recordFaucet,
+  recordSink: () => recordSink,
+  resetMetricsPeriod: () => resetMetricsPeriod,
+  spatialPrice: () => spatialPrice,
+  updateDualLoopPID: () => updateDualLoopPID,
+  updatePID: () => updatePID
+});
+module.exports = __toCommonJS(EconomicPrimitives_exports);
+function generateTxHash(from, to, price, timestamp) {
+  let hash = 2166136261;
+  const input = `${from}:${to}:${price}:${timestamp}`;
+  for (let i = 0; i < input.length; i++) {
+    hash ^= input.charCodeAt(i);
+    hash = Math.imul(hash, 16777619);
+  }
+  return (hash >>> 0).toString(16).padStart(8, "0");
+}
+function executeTrade(record, buyer, price, timestamp) {
+  if (record.locked) {
+    return { ok: false, error: "TRANSFER_BLOCKED" };
+  }
+  if (price < 0) {
+    return { ok: false, error: "INVALID_AMOUNT" };
+  }
+  const txHash = generateTxHash(record.owner, buyer, price, timestamp);
+  const transfer = {
+    from: record.owner,
+    to: buyer,
+    price,
+    timestamp,
+    txHash
+  };
+  const history = [transfer, ...record.history].slice(0, 50);
+  return {
+    ok: true,
+    value: {
+      owner: buyer,
+      history,
+      locked: false
+    }
+  };
+}
+var DEFAULT_DEPRECIATION = {
+  decayRate: 1e-4,
+  // 0.01% per second (~36% per hour)
+  condition: 1,
+  destroyThreshold: 0.01,
+  repairable: true,
+  repairCostMultiplier: 0.5
+};
+function calculateDepreciation(initialCondition, decayRate, elapsedSeconds) {
+  if (decayRate <= 0) return initialCondition;
+  if (elapsedSeconds <= 0) return initialCondition;
+  return initialCondition * Math.exp(-decayRate * elapsedSeconds);
+}
+function depreciatedValue(baseValue, condition) {
+  return baseValue * Math.max(0, Math.min(1, condition));
+}
+function isDestroyed(condition, threshold) {
+  return condition <= threshold;
+}
+function calculateRepairCost(baseValue, currentCondition, repairCostMultiplier) {
+  const conditionDeficit = 1 - Math.max(0, Math.min(1, currentCondition));
+  return baseValue * conditionDeficit * repairCostMultiplier;
+}
+var DEFAULT_BONDING_CURVE = {
+  curveType: "exponential",
+  reserveRatio: 1,
+  curveSteepness: 2,
+  currentSupply: 0,
+  reserveBalance: 0,
+  transactionFee: 0.02,
+  // 2% hard sink
+  sigmoidK: 100,
+  spatialDistanceFactor: 0
+};
+function bondingCurvePrice(supply, reserveRatio, curveSteepness, curveType = "exponential", sigmoidK = 100) {
+  if (supply <= 0) return 0;
+  if (reserveRatio <= 0) return 0;
+  switch (curveType) {
+    case "linear":
+      return reserveRatio * supply;
+    case "exponential":
+      return reserveRatio * Math.pow(supply, 1 / curveSteepness);
+    case "logarithmic":
+      return reserveRatio * Math.log(supply + 1);
+    case "sigmoid": {
+      const sn = Math.pow(supply, curveSteepness);
+      const kn = Math.pow(sigmoidK, curveSteepness);
+      return reserveRatio * (sn / (kn + sn));
+    }
+    default:
+      return reserveRatio * Math.pow(supply, 1 / curveSteepness);
+  }
+}
+function bondingCurveBuyCost(config, amount) {
+  if (amount <= 0) return 0;
+  const n = Math.max(10, Math.ceil(amount));
+  const h = amount / n;
+  let sum = 0;
+  const s0 = config.currentSupply;
+  for (let i = 0; i <= n; i++) {
+    const s = s0 + i * h;
+    const p = bondingCurvePrice(
+      s,
+      config.reserveRatio,
+      config.curveSteepness,
+      config.curveType,
+      config.sigmoidK
+    );
+    if (i === 0 || i === n) {
+      sum += p;
+    } else if (i % 2 === 1) {
+      sum += 4 * p;
+    } else {
+      sum += 2 * p;
+    }
+  }
+  const cost = h / 3 * sum;
+  return cost * (1 + config.transactionFee);
+}
+function bondingCurveSellRefund(config, amount) {
+  if (amount <= 0) return 0;
+  if (amount > config.currentSupply) return 0;
+  const n = Math.max(10, Math.ceil(amount));
+  const h = amount / n;
+  let sum = 0;
+  const s0 = config.currentSupply - amount;
+  for (let i = 0; i <= n; i++) {
+    const s = s0 + i * h;
+    const p = bondingCurvePrice(
+      s,
+      config.reserveRatio,
+      config.curveSteepness,
+      config.curveType,
+      config.sigmoidK
+    );
+    if (i === 0 || i === n) {
+      sum += p;
+    } else if (i % 2 === 1) {
+      sum += 4 * p;
+    } else {
+      sum += 2 * p;
+    }
+  }
+  const refund = h / 3 * sum;
+  return refund * (1 - config.transactionFee);
+}
+function spatialPrice(basePrice, distanceToHub, distanceFactor) {
+  if (distanceFactor <= 0 || distanceToHub <= 0) return basePrice;
+  return basePrice * (1 + distanceFactor * distanceToHub);
+}
+var DEFAULT_WEALTH_TAX = {
+  threshold: 1e4,
+  baseRate: 0.01,
+  // 1% base
+  maxEffectiveRate: 0.05,
+  // 5% cap
+  collectionInterval: "daily",
+  enableRedistribution: true,
+  redistributionFraction: 0.7
+  // 70% redistributed, 30% burned as hard sink
+};
+function calculateTaxRate(wealth, threshold, baseRate, maxEffectiveRate) {
+  if (wealth <= threshold) return 0;
+  if (threshold <= 0) return 0;
+  const rate = Math.log(wealth / threshold) * baseRate;
+  return Math.min(rate, maxEffectiveRate);
+}
+function calculateTaxAmount(wealth, config) {
+  const rate = calculateTaxRate(wealth, config.threshold, config.baseRate, config.maxEffectiveRate);
+  return wealth * rate;
+}
+function calculateRedistribution(totalTaxCollected, recipientCount, redistributionFraction) {
+  if (recipientCount <= 0 || totalTaxCollected <= 0) {
+    return { perRecipient: 0, burned: totalTaxCollected };
+  }
+  const redistributed = totalTaxCollected * redistributionFraction;
+  const burned = totalTaxCollected - redistributed;
+  const perRecipient = redistributed / recipientCount;
+  return { perRecipient, burned };
+}
+var DEFAULT_PID = {
+  kp: 0.5,
+  ki: 0.01,
+  kd: 0.1,
+  setpoint: 0,
+  outputMin: -1,
+  outputMax: 1,
+  integralLimit: 10
+};
+function createPIDState() {
+  return {
+    previousError: 0,
+    integral: 0,
+    lastOutput: 0,
+    initialized: false
+  };
+}
+function updatePID(config, state, measurement, dt) {
+  if (dt <= 0) return state.lastOutput;
+  const error = config.setpoint - measurement;
+  const p = config.kp * error;
+  state.integral += error * dt;
+  state.integral = Math.max(-config.integralLimit, Math.min(config.integralLimit, state.integral));
+  const i = config.ki * state.integral;
+  let d = 0;
+  if (state.initialized) {
+    d = config.kd * ((error - state.previousError) / dt);
+  }
+  let output = p + i + d;
+  output = Math.max(config.outputMin, Math.min(config.outputMax, output));
+  state.previousError = error;
+  state.lastOutput = output;
+  state.initialized = true;
+  return output;
+}
+function createDualLoopPIDState() {
+  return {
+    innerState: createPIDState(),
+    outerState: createPIDState(),
+    faucetMultiplier: 1
+  };
+}
+function updateDualLoopPID(config, state, totalMoneySupply, currentFaucetRate, dt) {
+  const targetSupply = config.perCapitaTarget * config.activePlayerCount;
+  const outerConfig = { ...config.outerLoop, setpoint: targetSupply };
+  const outerOutput = updatePID(outerConfig, state.outerState, totalMoneySupply, dt);
+  const desiredFaucetRate = currentFaucetRate * (1 + outerOutput * 0.1);
+  const innerConfig = { ...config.innerLoop, setpoint: desiredFaucetRate };
+  const innerOutput = updatePID(innerConfig, state.innerState, currentFaucetRate, dt);
+  state.faucetMultiplier = Math.max(0, Math.min(2, 1 + innerOutput));
+  return state.faucetMultiplier;
+}
+function createFaucetSinkMetrics(timestamp) {
+  return {
+    totalFaucet: 0,
+    totalSink: 0,
+    ratio: 1,
+    velocity: 0,
+    periodStart: timestamp,
+    ratioHistory: []
+  };
+}
+function recordFaucet(metrics, amount) {
+  metrics.totalFaucet += amount;
+  metrics.ratio = metrics.totalSink > 0 ? metrics.totalFaucet / metrics.totalSink : metrics.totalFaucet > 0 ? Infinity : 1;
+}
+function recordSink(metrics, amount) {
+  metrics.totalSink += amount;
+  metrics.ratio = metrics.totalSink > 0 ? metrics.totalFaucet / metrics.totalSink : metrics.totalFaucet > 0 ? Infinity : 1;
+}
+function resetMetricsPeriod(metrics, timestamp) {
+  if (metrics.totalFaucet > 0 || metrics.totalSink > 0) {
+    metrics.ratioHistory.push(metrics.ratio);
+    if (metrics.ratioHistory.length > 100) {
+      metrics.ratioHistory.shift();
+    }
+  }
+  metrics.totalFaucet = 0;
+  metrics.totalSink = 0;
+  metrics.ratio = 1;
+  metrics.velocity = 0;
+  metrics.periodStart = timestamp;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_BONDING_CURVE,
+  DEFAULT_DEPRECIATION,
+  DEFAULT_PID,
+  DEFAULT_WEALTH_TAX,
+  bondingCurveBuyCost,
+  bondingCurvePrice,
+  bondingCurveSellRefund,
+  calculateDepreciation,
+  calculateRedistribution,
+  calculateRepairCost,
+  calculateTaxAmount,
+  calculateTaxRate,
+  createDualLoopPIDState,
+  createFaucetSinkMetrics,
+  createPIDState,
+  depreciatedValue,
+  executeTrade,
+  generateTxHash,
+  isDestroyed,
+  recordFaucet,
+  recordSink,
+  resetMetricsPeriod,
+  spatialPrice,
+  updateDualLoopPID,
+  updatePID
+});
+//# sourceMappingURL=EconomicPrimitives.cjs.map