holosphere 1.1.19 → 2.0.0-alpha0

package/hexlib.js

@@ -1,335 +0,0 @@
-// Generated code -- CC0 -- No Rights Reserved -- http://www.redblobgames.com/grids/hexagons/
-export class Point {
-    constructor(x, y) {
-        this.x = x;
-        this.y = y;
-    }
-}
-export class Hex {
-    constructor(q, r, s) {
-        this.q = q;
-        this.r = r;
-        this.s = s;
-        if (Math.round(q + r + s) !== 0)
-            throw "q + r + s must be 0";
-    }
-    add(b) {
-        return new Hex(this.q + b.q, this.r + b.r, this.s + b.s);
-    }
-    subtract(b) {
-        return new Hex(this.q - b.q, this.r - b.r, this.s - b.s);
-    }
-    scale(k) {
-        return new Hex(this.q * k, this.r * k, this.s * k);
-    }
-    rotateLeft() {
-        return new Hex(-this.s, -this.q, -this.r);
-    }
-    rotateRight() {
-        return new Hex(-this.r, -this.s, -this.q);
-    }
-    static direction(direction) {
-        return Hex.directions[direction];
-    }
-    neighbor(direction) {
-        return this.add(Hex.direction(direction));
-    }
-    diagonalNeighbor(direction) {
-        return this.add(Hex.diagonals[direction]);
-    }
-    len() {
-        return (Math.abs(this.q) + Math.abs(this.r) + Math.abs(this.s)) / 2;
-    }
-    distance(b) {
-        return this.subtract(b).len();
-    }
-    round() {
-        var qi = Math.round(this.q);
-        var ri = Math.round(this.r);
-        var si = Math.round(this.s);
-        var q_diff = Math.abs(qi - this.q);
-        var r_diff = Math.abs(ri - this.r);
-        var s_diff = Math.abs(si - this.s);
-        if (q_diff > r_diff && q_diff > s_diff) {
-            qi = -ri - si;
-        }
-        else if (r_diff > s_diff) {
-            ri = -qi - si;
-        }
-        else {
-            si = -qi - ri;
-        }
-        return new Hex(qi, ri, si);
-    }
-    lerp(b, t) {
-        return new Hex(this.q * (1.0 - t) + b.q * t, this.r * (1.0 - t) + b.r * t, this.s * (1.0 - t) + b.s * t);
-    }
-    linedraw(b) {
-        var N = this.distance(b);
-        var a_nudge = new Hex(this.q + 1e-06, this.r + 1e-06, this.s - 2e-06);
-        var b_nudge = new Hex(b.q + 1e-06, b.r + 1e-06, b.s - 2e-06);
-        var results = [];
-        var step = 1.0 / Math.max(N, 1);
-        for (var i = 0; i <= N; i++) {
-            results.push(a_nudge.lerp(b_nudge, step * i).round());
-        }
-        return results;
-    }
-}
-Hex.directions = [new Hex(1, 0, -1), new Hex(1, -1, 0), new Hex(0, -1, 1), new Hex(-1, 0, 1), new Hex(-1, 1, 0), new Hex(0, 1, -1)];
-Hex.diagonals = [new Hex(2, -1, -1), new Hex(1, -2, 1), new Hex(-1, -1, 2), new Hex(-2, 1, 1), new Hex(-1, 2, -1), new Hex(1, 1, -2)];
-export class OffsetCoord {
-    constructor(col, row) {
-        this.col = col;
-        this.row = row;
-    }
-    static qoffsetFromCube(offset, h) {
-        var col = h.q;
-        var row = h.r + (h.q + offset * (h.q & 1)) / 2;
-        if (offset !== OffsetCoord.EVEN && offset !== OffsetCoord.ODD) {
-            throw "offset must be EVEN (+1) or ODD (-1)";
-        }
-        return new OffsetCoord(col, row);
-    }
-    static qoffsetToCube(offset, h) {
-        var q = h.col;
-        var r = h.row - (h.col + offset * (h.col & 1)) / 2;
-        var s = -q - r;
-        if (offset !== OffsetCoord.EVEN && offset !== OffsetCoord.ODD) {
-            throw "offset must be EVEN (+1) or ODD (-1)";
-        }
-        return new Hex(q, r, s);
-    }
-    static roffsetFromCube(offset, h) {
-        var col = h.q + (h.r + offset * (h.r & 1)) / 2;
-        var row = h.r;
-        if (offset !== OffsetCoord.EVEN && offset !== OffsetCoord.ODD) {
-            throw "offset must be EVEN (+1) or ODD (-1)";
-        }
-        return new OffsetCoord(col, row);
-    }
-    static roffsetToCube(offset, h) {
-        var q = h.col - (h.row + offset * (h.row & 1)) / 2;
-        var r = h.row;
-        var s = -q - r;
-        if (offset !== OffsetCoord.EVEN && offset !== OffsetCoord.ODD) {
-            throw "offset must be EVEN (+1) or ODD (-1)";
-        }
-        return new Hex(q, r, s);
-    }
-}
-OffsetCoord.EVEN = 1;
-OffsetCoord.ODD = -1;
-export class DoubledCoord {
-    constructor(col, row) {
-        this.col = col;
-        this.row = row;
-    }
-    static qdoubledFromCube(h) {
-        var col = h.q;
-        var row = 2 * h.r + h.q;
-        return new DoubledCoord(col, row);
-    }
-    qdoubledToCube() {
-        var q = this.col;
-        var r = (this.row - this.col) / 2;
-        var s = -q - r;
-        return new Hex(q, r, s);
-    }
-    static rdoubledFromCube(h) {
-        var col = 2 * h.q + h.r;
-        var row = h.r;
-        return new DoubledCoord(col, row);
-    }
-    rdoubledToCube() {
-        var q = (this.col - this.row) / 2;
-        var r = this.row;
-        var s = -q - r;
-        return new Hex(q, r, s);
-    }
-}
-export class Orientation {
-    constructor(f0, f1, f2, f3, b0, b1, b2, b3, start_angle) {
-        this.f0 = f0;
-        this.f1 = f1;
-        this.f2 = f2;
-        this.f3 = f3;
-        this.b0 = b0;
-        this.b1 = b1;
-        this.b2 = b2;
-        this.b3 = b3;
-        this.start_angle = start_angle;
-    }
-}
-export class Layout {
-    constructor(orientation, size, origin) {
-        this.orientation = orientation;
-        this.size = size;
-        this.origin = origin;
-    }
-    hexToPixel(h) {
-        var M = this.orientation;
-        var size = this.size;
-        var origin = this.origin;
-        var x = (M.f0 * h.q + M.f1 * h.r) * size.x;
-        var y = (M.f2 * h.q + M.f3 * h.r) * size.y;
-        return new Point(x + origin.x, y + origin.y);
-    }
-    pixelToHex(p) {
-        var M = this.orientation;
-        var size = this.size;
-        var origin = this.origin;
-        var pt = new Point((p.x - origin.x) / size.x, (p.y - origin.y) / size.y);
-        var q = M.b0 * pt.x + M.b1 * pt.y;
-        var r = M.b2 * pt.x + M.b3 * pt.y;
-        return new Hex(q, r, -q - r);
-    }
-    hexCornerOffset(corner) {
-        var M = this.orientation;
-        var size = this.size;
-        var angle = 2.0 * Math.PI * (M.start_angle - corner) / 6.0;
-        return new Point(size.x * Math.cos(angle), size.y * Math.sin(angle));
-    }
-    polygonCorners(h) {
-        var corners = [];
-        var center = this.hexToPixel(h);
-        for (var i = 0; i < 6; i++) {
-            var offset = this.hexCornerOffset(i);
-            corners.push(new Point(center.x + offset.x, center.y + offset.y));
-        }
-        return corners;
-    }
-}
-Layout.pointy = new Orientation(Math.sqrt(3.0), Math.sqrt(3.0) / 2.0, 0.0, 3.0 / 2.0, Math.sqrt(3.0) / 3.0, -1.0 / 3.0, 0.0, 2.0 / 3.0, 0.5);
-Layout.flat = new Orientation(3.0 / 2.0, 0.0, Math.sqrt(3.0) / 2.0, Math.sqrt(3.0), 2.0 / 3.0, 0.0, -1.0 / 3.0, Math.sqrt(3.0) / 3.0, 0.0);
-class Tests {
-    constructor() { }
-    static equalHex(name, a, b) {
-        if (!(a.q === b.q && a.s === b.s && a.r === b.r)) {
-            complain(name);
-        }
-    }
-    static equalOffsetcoord(name, a, b) {
-        if (!(a.col === b.col && a.row === b.row)) {
-            complain(name);
-        }
-    }
-    static equalDoubledcoord(name, a, b) {
-        if (!(a.col === b.col && a.row === b.row)) {
-            complain(name);
-        }
-    }
-    static equalInt(name, a, b) {
-        if (!(a === b)) {
-            complain(name);
-        }
-    }
-    static equalHexArray(name, a, b) {
-        Tests.equalInt(name, a.length, b.length);
-        for (var i = 0; i < a.length; i++) {
-            Tests.equalHex(name, a[i], b[i]);
-        }
-    }
-    static testHexArithmetic() {
-        Tests.equalHex("hex_add", new Hex(4, -10, 6), new Hex(1, -3, 2).add(new Hex(3, -7, 4)));
-        Tests.equalHex("hex_subtract", new Hex(-2, 4, -2), new Hex(1, -3, 2).subtract(new Hex(3, -7, 4)));
-    }
-    static testHexDirection() {
-        Tests.equalHex("hex_direction", new Hex(0, -1, 1), Hex.direction(2));
-    }
-    static testHexNeighbor() {
-        Tests.equalHex("hex_neighbor", new Hex(1, -3, 2), new Hex(1, -2, 1).neighbor(2));
-    }
-    static testHexDiagonal() {
-        Tests.equalHex("hex_diagonal", new Hex(-1, -1, 2), new Hex(1, -2, 1).diagonalNeighbor(3));
-    }
-    static testHexDistance() {
-        Tests.equalInt("hex_distance", 7, new Hex(3, -7, 4).distance(new Hex(0, 0, 0)));
-    }
-    static testHexRotateRight() {
-        Tests.equalHex("hex_rotate_right", new Hex(1, -3, 2).rotateRight(), new Hex(3, -2, -1));
-    }
-    static testHexRotateLeft() {
-        Tests.equalHex("hex_rotate_left", new Hex(1, -3, 2).rotateLeft(), new Hex(-2, -1, 3));
-    }
-    static testHexRound() {
-        var a = new Hex(0.0, 0.0, 0.0);
-        var b = new Hex(1.0, -1.0, 0.0);
-        var c = new Hex(0.0, -1.0, 1.0);
-        Tests.equalHex("hex_round 1", new Hex(5, -10, 5), new Hex(0.0, 0.0, 0.0).lerp(new Hex(10.0, -20.0, 10.0), 0.5).round());
-        Tests.equalHex("hex_round 2", a.round(), a.lerp(b, 0.499).round());
-        Tests.equalHex("hex_round 3", b.round(), a.lerp(b, 0.501).round());
-        Tests.equalHex("hex_round 4", a.round(), new Hex(a.q * 0.4 + b.q * 0.3 + c.q * 0.3, a.r * 0.4 + b.r * 0.3 + c.r * 0.3, a.s * 0.4 + b.s * 0.3 + c.s * 0.3).round());
-        Tests.equalHex("hex_round 5", c.round(), new Hex(a.q * 0.3 + b.q * 0.3 + c.q * 0.4, a.r * 0.3 + b.r * 0.3 + c.r * 0.4, a.s * 0.3 + b.s * 0.3 + c.s * 0.4).round());
-    }
-    static testHexLinedraw() {
-        Tests.equalHexArray("hex_linedraw", [new Hex(0, 0, 0), new Hex(0, -1, 1), new Hex(0, -2, 2), new Hex(1, -3, 2), new Hex(1, -4, 3), new Hex(1, -5, 4)], new Hex(0, 0, 0).linedraw(new Hex(1, -5, 4)));
-    }
-    static testLayout() {
-        var h = new Hex(3, 4, -7);
-        var flat = new Layout(Layout.flat, new Point(10.0, 15.0), new Point(35.0, 71.0));
-        Tests.equalHex("layout", h, flat.pixelToHex(flat.hexToPixel(h)).round());
-        var pointy = new Layout(Layout.pointy, new Point(10.0, 15.0), new Point(35.0, 71.0));
-        Tests.equalHex("layout", h, pointy.pixelToHex(pointy.hexToPixel(h)).round());
-    }
-    static testOffsetRoundtrip() {
-        var a = new Hex(3, 4, -7);
-        var b = new OffsetCoord(1, -3);
-        Tests.equalHex("conversion_roundtrip even-q", a, OffsetCoord.qoffsetToCube(OffsetCoord.EVEN, OffsetCoord.qoffsetFromCube(OffsetCoord.EVEN, a)));
-        Tests.equalOffsetcoord("conversion_roundtrip even-q", b, OffsetCoord.qoffsetFromCube(OffsetCoord.EVEN, OffsetCoord.qoffsetToCube(OffsetCoord.EVEN, b)));
-        Tests.equalHex("conversion_roundtrip odd-q", a, OffsetCoord.qoffsetToCube(OffsetCoord.ODD, OffsetCoord.qoffsetFromCube(OffsetCoord.ODD, a)));
-        Tests.equalOffsetcoord("conversion_roundtrip odd-q", b, OffsetCoord.qoffsetFromCube(OffsetCoord.ODD, OffsetCoord.qoffsetToCube(OffsetCoord.ODD, b)));
-        Tests.equalHex("conversion_roundtrip even-r", a, OffsetCoord.roffsetToCube(OffsetCoord.EVEN, OffsetCoord.roffsetFromCube(OffsetCoord.EVEN, a)));
-        Tests.equalOffsetcoord("conversion_roundtrip even-r", b, OffsetCoord.roffsetFromCube(OffsetCoord.EVEN, OffsetCoord.roffsetToCube(OffsetCoord.EVEN, b)));
-        Tests.equalHex("conversion_roundtrip odd-r", a, OffsetCoord.roffsetToCube(OffsetCoord.ODD, OffsetCoord.roffsetFromCube(OffsetCoord.ODD, a)));
-        Tests.equalOffsetcoord("conversion_roundtrip odd-r", b, OffsetCoord.roffsetFromCube(OffsetCoord.ODD, OffsetCoord.roffsetToCube(OffsetCoord.ODD, b)));
-    }
-    static testOffsetFromCube() {
-        Tests.equalOffsetcoord("offset_from_cube even-q", new OffsetCoord(1, 3), OffsetCoord.qoffsetFromCube(OffsetCoord.EVEN, new Hex(1, 2, -3)));
-        Tests.equalOffsetcoord("offset_from_cube odd-q", new OffsetCoord(1, 2), OffsetCoord.qoffsetFromCube(OffsetCoord.ODD, new Hex(1, 2, -3)));
-    }
-    static testOffsetToCube() {
-        Tests.equalHex("offset_to_cube even-", new Hex(1, 2, -3), OffsetCoord.qoffsetToCube(OffsetCoord.EVEN, new OffsetCoord(1, 3)));
-        Tests.equalHex("offset_to_cube odd-q", new Hex(1, 2, -3), OffsetCoord.qoffsetToCube(OffsetCoord.ODD, new OffsetCoord(1, 2)));
-    }
-    static testDoubledRoundtrip() {
-        var a = new Hex(3, 4, -7);
-        var b = new DoubledCoord(1, -3);
-        Tests.equalHex("conversion_roundtrip doubled-q", a, DoubledCoord.qdoubledFromCube(a).qdoubledToCube());
-        Tests.equalDoubledcoord("conversion_roundtrip doubled-q", b, DoubledCoord.qdoubledFromCube(b.qdoubledToCube()));
-        Tests.equalHex("conversion_roundtrip doubled-r", a, DoubledCoord.rdoubledFromCube(a).rdoubledToCube());
-        Tests.equalDoubledcoord("conversion_roundtrip doubled-r", b, DoubledCoord.rdoubledFromCube(b.rdoubledToCube()));
-    }
-    static testDoubledFromCube() {
-        Tests.equalDoubledcoord("doubled_from_cube doubled-q", new DoubledCoord(1, 5), DoubledCoord.qdoubledFromCube(new Hex(1, 2, -3)));
-        Tests.equalDoubledcoord("doubled_from_cube doubled-r", new DoubledCoord(4, 2), DoubledCoord.rdoubledFromCube(new Hex(1, 2, -3)));
-    }
-    static testDoubledToCube() {
-        Tests.equalHex("doubled_to_cube doubled-q", new Hex(1, 2, -3), new DoubledCoord(1, 5).qdoubledToCube());
-        Tests.equalHex("doubled_to_cube doubled-r", new Hex(1, 2, -3), new DoubledCoord(4, 2).rdoubledToCube());
-    }
-    static testAll() {
-        Tests.testHexArithmetic();
-        Tests.testHexDirection();
-        Tests.testHexNeighbor();
-        Tests.testHexDiagonal();
-        Tests.testHexDistance();
-        Tests.testHexRotateRight();
-        Tests.testHexRotateLeft();
-        Tests.testHexRound();
-        Tests.testHexLinedraw();
-        Tests.testLayout();
-        Tests.testOffsetRoundtrip();
-        Tests.testOffsetFromCube();
-        Tests.testOffsetToCube();
-        Tests.testDoubledRoundtrip();
-        Tests.testDoubledFromCube();
-        Tests.testDoubledToCube();
-    }
-}
-// Tests
-function complain(name) { console.log("FAIL", name); }
-Tests.testAll();
-
-// Export Hex as the default since it's the main class
-export default Hex;

package/hologram.js

@@ -1,183 +0,0 @@
-// holo_hologram.js
-
-/**
- * Creates a soul hologram object for a data item
- * @param {HoloSphere} holoInstance - The HoloSphere instance.
- * @param {string} holon - The holon where the original data is stored
- * @param {string} lens - The lens where the original data is stored
- * @param {object} data - The data to create a hologram for
- * @returns {object} - A hologram object with id and soul
- */
-export function createHologram(holoInstance, holon, lens, data) {
-    // Check if the input data is already a hologram
-    if (isHologram(data)) {
-        // If it is, just return its existing ID and Soul, ignoring the provided holon/lens
-        return {
-            id: data.id,
-            soul: data.soul
-        };
-    }
-
-    // Original logic: Input data is not a hologram, create a new soul path
-    if (!holon || !lens || !data || !data.id) {
-        throw new Error('createHologram: Missing required parameters for non-hologram data');
-    }
-
-    const soul = `${holoInstance.appname}/${holon}/${lens}/${data.id}`;
-    return {
-        id: data.id,
-        soul: soul
-    };
-}
-
-/**
- * Parses a soul path into its components.
- * @param {string} soul - The soul path (e.g., "app/holon/lens/key").
- * @returns {object|null} - An object with appname, holon, lens, key, or null if invalid.
- */
-export function parseSoulPath(soul) {
-    if (typeof soul !== 'string') return null;
-    const parts = soul.split('/');
-    if (parts.length < 4) return null; // Must have at least app/holon/lens/key
-
-    // Reconstruct key if it contained slashes (though generally disallowed by getNodeRef validation)
-    const key = parts.slice(3).join('/');
-
-    return {
-        appname: parts[0],
-        holon: parts[1],
-        lens: parts[2],
-        key: key
-    };
-}
-
-/**
- * Checks if an object is a hologram.
- * This function checks for the presence and type of `id` and `soul` properties,
- * suitable for identifying holograms represented as plain JavaScript objects.
- * It also performs a basic check that the `soul` contains '/' as expected for a path.
- * @param {object | null | undefined} data - The data to check.
- * @returns {boolean} - True if the object is considered a hologram.
- */
-export function isHologram(data) {
-    if (!data || typeof data !== 'object') {
-        return false;
-    }
-    
-    // Basic check: Does it have an 'id' and a 'soul' which is a non-empty string?
-    if (data.id && typeof data.soul === 'string' && data.soul.length > 0) {
-         // Optional stricter check: Does the soul look like a valid path?
-         // This prevents objects like { id: 1, soul: "hello" } from being counted.
-         // We can use a simplified check here or rely on parseSoulPath failing later.
-         if (data.soul.includes('/')) { // Simple check for path structure
-            return true;
-         } 
-    }
-
-    return false;
-}
-
-/**
- * Resolves a hologram to its actual data
- * @param {HoloSphere} holoInstance - The HoloSphere instance.
- * @param {object} hologram - The hologram to resolve
- * @param {object} [options] - Optional parameters
- * @param {boolean} [options.followHolograms=true] - Whether to follow nested holograms
- * @param {Set<string>} [options.visited] - Internal use: Tracks visited souls to prevent loops
- * @param {number} [options.maxDepth=10] - Maximum resolution depth to prevent infinite loops
- * @param {number} [options.currentDepth=0] - Current resolution depth
- * @returns {Promise<object|null>} - The resolved data, null if resolution failed due to target not found, or the original hologram for circular/invalid cases.
- */
-export async function resolveHologram(holoInstance, hologram, options = {}) {
-    if (!isHologram(hologram)) {
-        return hologram; // Not a hologram, return as is
-    }
-
-    const { 
-        followHolograms = true, 
-        visited = new Set(), 
-        maxDepth = 10, 
-        currentDepth = 0 
-    } = options;
-
-    // Check depth limit first
-    if (currentDepth >= maxDepth) {
-        console.warn(`!!! Maximum resolution depth (${maxDepth}) reached for soul: ${hologram.soul}. Stopping resolution.`);
-        return null;
-    }
-
-    // Check for circular hologram
-    if (hologram.soul && visited.has(hologram.soul)) {
-        console.warn(`!!! CIRCULAR hologram detected for soul: ${hologram.soul}. Breaking loop.`);
-        return null;
-    }
-
-        try {
-            // Handle direct soul hologram
-            if (hologram.soul) {
-                const soulInfo = parseSoulPath(hologram.soul);
-                if (!soulInfo) {
-                    console.warn(`Invalid soul format: ${hologram.soul}`);
-                return null;
-                }
-
-                // Add current soul to visited set for THIS resolution path
-                const nextVisited = new Set(visited);
-                nextVisited.add(hologram.soul);
-
-            // Only log when actually resolving a hologram for debugging if needed
-            // console.log(`Resolving hologram: ${hologram.soul}`);
-
-            // Get original data with increased depth
-                const originalData = await holoInstance.get(
-                    soulInfo.holon,
-                    soulInfo.lens,
-                    soulInfo.key,
-                    null,
-                    {
-                        resolveHolograms: followHolograms,
-                    visited: nextVisited,
-                    maxDepth: maxDepth,
-                    currentDepth: currentDepth + 1
-                    }
-                );
-
-            if (originalData && !originalData._invalidHologram) {
-                    // Structure for the returned object - isHologram (top-level) is removed
-                    return {
-                        ...originalData,
-                        _meta: {
-                            ...(originalData._meta || {}), // Preserve original _meta
-                            resolvedFromHologram: true,    // This is now the primary indicator
-                        hologramSoul: hologram.soul,   // Clarified meta field
-                        resolutionDepth: currentDepth
-                        }
-                    };
-                } else {
-                console.warn(`!!! Original data NOT FOUND for soul: ${hologram.soul}. Removing broken hologram.`);
-                
-                // Return null to indicate the hologram should be removed
-                return null;
-                }
-            } else {
-                 // Should not happen if isHologram() passed
-                 console.warn('!!! resolveHologram called with object missing soul:', hologram);
-            return null;
-            }
-        } catch (error) {
-        if (error.message?.startsWith('CIRCULAR_REFERENCE')) {
-            console.warn(`!!! Circular reference detected during hologram resolution: ${error.message}`);
-            return null;
-        }
-        console.error(`!!! Error resolving hologram: ${error.message}`, error);
-        return null; // Return null on error to prevent loops
-    }
-}
-
-// Export all hologram operations as default
-export default {
-    createHologram,
-    parseSoulPath,
-    isHologram,
-    resolveHologram
-};