@holoscript/std 2.1.0 → 6.0.3

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @holoscript/std
+
+## 6.0.3
+
+### Patch Changes
+
+- chore(deps): updated internal dependencies representing workspace minor and security package bumps.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 HoloScript Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,197 @@
+# @holoscript/std
+
+HoloScript Standard Library - Core types and utilities.
+
+## Installation
+
+```bash
+npm install @holoscript/std
+```
+
+## Entry Points
+
+| Import                        | Description              |
+| ----------------------------- | ------------------------ |
+| `@holoscript/std`             | All utilities            |
+| `@holoscript/std/math`        | Math & vector operations |
+| `@holoscript/std/collections` | Immutable collections    |
+| `@holoscript/std/string`      | String manipulation      |
+| `@holoscript/std/time`        | Timers & scheduling      |
+
+## Core Types
+
+Spatial and graphical primitives used throughout HoloScript:
+
+```typescript
+import { vec3, quat, rgb, transform, aabb, ray } from '@holoscript/std';
+
+const position = vec3(0, 1, -2);
+const rotation = quat(0, 0, 0, 1);
+const color = rgb(0.2, 0.5, 1.0);
+const t = transform(position, rotation, vec3(1, 1, 1));
+const bounds = aabb(vec3(-1, -1, -1), vec3(1, 1, 1));
+```
+
+**Type definitions:** `Vec2`, `Vec3`, `Vec4`, `Quat`, `Transform`, `EulerAngles`, `ColorRGB`, `ColorRGBA`, `ColorHSL`, `AABB`, `BoundingSphere`, `Ray`, `RaycastHit`
+
+**Utility types:** `Nullable<T>`, `Optional<T>`, `DeepPartial<T>`
+
+## Math
+
+```typescript
+import {
+  lerp,
+  clamp,
+  remap,
+  smoothstep,
+  vec3Math,
+  quatMath,
+  noise,
+  random,
+} from '@holoscript/std/math';
+
+// Interpolation
+lerp(0, 100, 0.5); // 50
+remap(0.5, 0, 1, -10, 10); // 0
+smoothstep(0, 1, 0.3);
+
+// Vector math
+const forward = vec3Math.forward(); // { x: 0, y: 0, z: 1 }
+const dir = vec3Math.normalize(vec3Math.sub(target, origin));
+const d = vec3Math.distance(a, b);
+
+// Quaternion math
+const q = quatMath.fromEuler({ pitch: 0, yaw: 90, roll: 0 });
+const rotated = quatMath.rotateVec3(q, forward);
+
+// Noise
+noise.perlin2d(x, y);
+noise.fbm(x, y, z, 4, 2.0, 0.5);
+noise.worley(x, y, z);
+
+// Random
+random.range(1, 10);
+random.insideUnitSphere();
+const rng = random.seeded(42);
+```
+
+**Constants:** `PI`, `TAU`, `HALF_PI`, `DEG_TO_RAD`, `RAD_TO_DEG`, `EPSILON`
+
+**Additional:** `vec2Math`, `aabbMath` (contains/intersects/merge)
+
+## Collections
+
+Immutable, functional collection classes:
+
+```typescript
+import { List, HoloMap, HoloSet, SpatialGrid, PriorityQueue } from '@holoscript/std/collections';
+
+// List - immutable array with rich API
+const items = List.of(3, 1, 4, 1, 5);
+items
+  .sort()
+  .unique()
+  .map((x) => x * 2)
+  .filter((x) => x > 4);
+items.groupBy((x) => (x % 2 === 0 ? 'even' : 'odd'));
+List.range(0, 100, 5); // [0, 5, 10, ..., 95]
+
+// HoloMap - immutable key-value store
+const scores = HoloMap.of(['alice', 100], ['bob', 85]);
+scores.set('carol', 92).filter((k, v) => v > 90);
+
+// HoloSet - immutable set with set operations
+const a = HoloSet.of(1, 2, 3);
+const b = HoloSet.of(2, 3, 4);
+a.union(b); // {1, 2, 3, 4}
+a.intersection(b); // {2, 3}
+
+// SpatialGrid - spatial partitioning
+const grid = new SpatialGrid(10);
+grid.insert(vec3(5, 0, 5), entity);
+const nearby = grid.query(vec3(6, 0, 6), 15);
+
+// PriorityQueue
+const pq = PriorityQueue.minHeap();
+pq.enqueue('urgent', 1);
+pq.enqueue('later', 10);
+pq.dequeue(); // 'urgent'
+```
+
+## String
+
+80+ string utilities:
+
+```typescript
+import { camelCase, slugify, truncate, levenshtein, format, uuid } from '@holoscript/std/string';
+
+camelCase('hello-world'); // 'helloWorld'
+slugify('Hello World!'); // 'hello-world'
+truncate('long text...', 8); // 'long ...'
+levenshtein('kitten', 'sitting'); // 3
+format('{name} has {n} items', { name: 'Alice', n: 5 });
+uuid(); // 'a1b2c3d4-...'
+```
+
+**Categories:** case conversion, padding/truncation, validation (`isBlank`, `isNumeric`), encoding (`escapeHtml`, `escapeRegex`), formatting (`formatBytes`, `formatDuration`), splitting (`lines`, `words`)
+
+## Time
+
+Timers, scheduling, and async control:
+
+```typescript
+import {
+  sleep,
+  debounce,
+  throttle,
+  measure,
+  retry,
+  Stopwatch,
+  CountdownTimer,
+  FrameTimer,
+  dateTime,
+} from '@holoscript/std/time';
+
+await sleep(1000);
+const elapsed = await measure(async () => {
+  /* work */
+});
+
+const sw = new Stopwatch();
+sw.start();
+// ... work ...
+sw.lap();
+console.log(sw.elapsed);
+
+const countdown = new CountdownTimer(60000, {
+  onTick: (remaining) => updateUI(remaining),
+  onComplete: () => console.log('done!'),
+});
+countdown.start();
+
+const frame = new FrameTimer();
+function loop() {
+  frame.update();
+  console.log(frame.delta, frame.currentFps);
+  requestAnimationFrame(loop);
+}
+
+await retry(fetchData, { maxRetries: 3, baseDelay: 1000 });
+
+dateTime.format(new Date(), 'YYYY-MM-DD HH:mm');
+```
+
+## General Utilities
+
+```typescript
+import { assert, clone, equals, pipe, compose } from '@holoscript/std';
+
+assert(x > 0, 'x must be positive');
+const copy = clone(deepObject);
+equals({ a: 1 }, { a: 1 }); // true
+pipe(5, double, addOne, toString); // '11'
+```
+
+## License
+
+MIT

package/dist/__tests__/EconomicPrimitives.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=EconomicPrimitives.test.d.ts.map

package/dist/__tests__/EconomicPrimitives.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EconomicPrimitives.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/EconomicPrimitives.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/EconomicTraits.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=EconomicTraits.test.d.ts.map

package/dist/__tests__/EconomicTraits.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EconomicTraits.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/EconomicTraits.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/SimulationLabPrimitives.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SimulationLabPrimitives.test.d.ts.map

package/dist/__tests__/SimulationLabPrimitives.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SimulationLabPrimitives.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/SimulationLabPrimitives.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/collections.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=collections.test.d.ts.map

package/dist/__tests__/collections.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/collections.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/events.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=events.test.d.ts.map

package/dist/__tests__/events.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/events.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/__tests__/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/index.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/materials.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=materials.test.d.ts.map

package/dist/__tests__/materials.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materials.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/materials.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/math.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=math.test.d.ts.map

package/dist/__tests__/math.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/math.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/physics.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=physics.test.d.ts.map

package/dist/__tests__/physics.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"physics.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/physics.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/spatial.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=spatial.test.d.ts.map

package/dist/__tests__/spatial.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spatial.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/spatial.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/standard-library-fundamentals.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=standard-library-fundamentals.test.d.ts.map

package/dist/__tests__/standard-library-fundamentals.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-library-fundamentals.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/standard-library-fundamentals.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/string-and-time-utilities.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=string-and-time-utilities.test.d.ts.map

package/dist/__tests__/string-and-time-utilities.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-and-time-utilities.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/string-and-time-utilities.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/string-decoupled.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=string-decoupled.test.d.ts.map

package/dist/__tests__/string-decoupled.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-decoupled.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/string-decoupled.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/string.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=string.test.d.ts.map

package/dist/__tests__/string.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/string.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/time.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=time.test.d.ts.map

package/dist/__tests__/time.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/time.test.ts"],"names":[],"mappings":""}