@kanzo-tech/graph 0.13.1 → 0.15.0

package/dist/render/encode.d.ts

@@ -1,42 +0,0 @@
-import { Binding } from '../core/channels';
-import { TileView } from '../core/store';
-/**
- * Values to codes, in the order first seen — stable for the life of a binding. **The seed ranks
- * first, in its own order**: the manifest's ordinals or the host's named values, so a colour is
- * decided before a tile arrives. Only a value outside it is ranked by value, after the seed.
- */
-export declare class Dictionary {
-    #private;
-    readonly values: unknown[];
-    constructor(seed?: readonly unknown[]);
-    code(value: unknown): number;
-    /** Each code's rank: the seed's own order, then every other value seen, numbers before strings. */
-    ranks(): Uint32Array;
-}
-/** One tile's rows and edges as the arrays a composition concatenates. */
-export interface Encoded {
-    readonly n: number;
-    readonly cells: boolean;
-    /** `[x0, y0, x1, y1, …]`. */
-    readonly positions: Float32Array;
-    /** `dense_id` at the payload, `cell_id` on a rung — what an edge's ends name. */
-    readonly keys: Float64Array;
-    /** Dictionary codes of the categorical column, or `null` when nothing is bound. */
-    readonly codes: Uint32Array | null;
-    /** The ramp: `r`'s column at the payload, a cell's `count` on a rung. */
-    readonly sizes: Float32Array | null;
-    /** Vertices each row stands for: one at the payload, a cell's `count` on a rung. */
-    readonly counts: Float64Array;
-    readonly titles: readonly string[] | null;
-    /** `[src, dst, …]` in `keys`' space, every relation read from this tile, both directions. */
-    readonly links: Float64Array;
-    /** How many edges each link stands for: one at the payload, the quotient's `weight` on a rung. */
-    readonly weights: Float32Array | null;
-}
-/**
- * **A tile is encoded once per binding**: the arrays are made when it arrives, and a composition is a
- * concatenation of arrays already made. A cell summarises one channel, so its colour is `mode` when
- * `fill` binds the column the tree's mode is of, its size can only be `count`, and it has no title.
- */
-export declare function encode(view: TileView, binding: Binding, dictionary: Dictionary, modeColumn: string | null): Encoded;
-//# sourceMappingURL=encode.d.ts.map

package/dist/render/encode.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"encode.d.ts","sourceRoot":"","sources":["../../src/render/encode.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAY9C;;;;GAIG;AACH,qBAAa,UAAU;;IACrB,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,CAAM;gBAIpB,IAAI,GAAE,SAAS,OAAO,EAAO;IAKzC,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAW5B,mGAAmG;IACnG,KAAK,IAAI,WAAW;CAUrB;AASD,0EAA0E;AAC1E,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,6BAA6B;IAC7B,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,iFAAiF;IACjF,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,mFAAmF;IACnF,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IACnC,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IACpC,oFAAoF;IACpF,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAC1C,6FAA6F;IAC7F,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,kGAAkG;IAClG,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;CACvC;AAQD;;;;GAIG;AACH,wBAAgB,MAAM,CACpB,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,MAAM,GAAG,IAAI,GACxB,OAAO,CA2CT"}

package/dist/render/encode.js

@@ -1,68 +0,0 @@
-var q = Object.defineProperty;
-var M = (e) => {
-  throw TypeError(e);
-};
-var x = (e, t, o) => t in e ? q(e, t, { enumerable: !0, configurable: !0, writable: !0, value: o }) : e[t] = o;
-var P = (e, t, o) => x(e, typeof t != "symbol" ? t + "" : t, o), T = (e, t, o) => t.has(e) || M("Cannot " + o);
-var u = (e, t, o) => (T(e, t, "read from private field"), o ? o.call(e) : t.get(e)), C = (e, t, o) => t.has(e) ? M("Cannot add the same private member more than once") : t instanceof WeakSet ? t.add(e) : t.set(e, o), U = (e, t, o, r) => (T(e, t, "write to private field"), r ? r.call(e, o) : t.set(e, o), o);
-import { PAYLOAD_COORDINATES as B, PAYLOAD_ADDRESS as G } from "@fossil-lang/corpus";
-const H = "cell_id", J = "count", Q = "mode", V = G[0], [W, Z] = B;
-var f, l;
-class ot {
-  constructor(t = []) {
-    P(this, "values", []);
-    C(this, f, /* @__PURE__ */ new Map());
-    C(this, l);
-    for (const o of t) this.code(o);
-    U(this, l, this.values.length);
-  }
-  code(t) {
-    const o = typeof t == "bigint" ? Number(t) : t;
-    let r = u(this, f).get(o);
-    return r === void 0 && (r = this.values.length, this.values.push(o), u(this, f).set(o, r)), r;
-  }
-  /** Each code's rank: the seed's own order, then every other value seen, numbers before strings. */
-  ranks() {
-    const t = new Uint32Array(this.values.length);
-    for (let r = 0; r < u(this, l); r++) t[r] = r;
-    const o = this.values.slice(u(this, l)).map((r, n) => ({ value: r, code: u(this, l) + n }));
-    return o.sort((r, n) => $(r.value, n.value)), o.forEach(({ code: r }, n) => {
-      t[r] = u(this, l) + n;
-    }), t;
-  }
-}
-f = new WeakMap(), l = new WeakMap();
-function $(e, t) {
-  return typeof e == "number" && typeof t == "number" ? e - t : typeof e == "number" ? -1 : typeof t == "number" ? 1 : String(e ?? "").localeCompare(String(t ?? ""));
-}
-const w = (e, t) => {
-  const o = new Float64Array(t);
-  if (e) for (let r = 0; r < t; r++) o[r] = Number(e[r] ?? Number.NaN);
-  return o;
-};
-function rt(e, t, o, r) {
-  var k, F, S, Y, O, z, R, K;
-  const { rows: n, edges: L } = e.content, i = e.kind === "cells", c = n.numRows, y = (k = n.getChild(W)) == null ? void 0 : k.toArray(), m = (F = n.getChild(Z)) == null ? void 0 : F.toArray(), g = new Float32Array(c * 2);
-  for (let s = 0; s < c; s++)
-    g[s * 2] = Number((y == null ? void 0 : y[s]) ?? Number.NaN), g[s * 2 + 1] = Number((m == null ? void 0 : m[s]) ?? Number.NaN);
-  const I = w((S = n.getChild(i ? H : V)) == null ? void 0 : S.toArray(), c), E = i ? t.category === r ? Q : void 0 : t.category, b = E === void 0 || (Y = n.getChild(E)) == null ? void 0 : Y.toArray();
-  let A = null;
-  if (b) {
-    A = new Uint32Array(c);
-    for (let s = 0; s < c; s++) A[s] = o.code(b[s] ?? null);
-  }
-  const D = i ? w((O = n.getChild(J)) == null ? void 0 : O.toArray(), c) : new Float64Array(c).fill(1), d = i ? t.size !== void 0 ? D : void 0 : t.size, X = d === void 0 ? null : Float32Array.from(typeof d == "string" ? w((z = n.getChild(d)) == null ? void 0 : z.toArray(), c) : d), _ = !i && t.title !== void 0 ? (R = n.getChild(t.title)) == null ? void 0 : R.toArray() : void 0, j = _ ? Array.from({ length: c }, (s, a) => String(_[a] ?? "")) : null;
-  let N = 0;
-  for (const s of L) N += s.src.length;
-  const p = new Float64Array(N * 2), v = i ? new Float32Array(N) : null;
-  let h = 0;
-  for (const s of L)
-    for (let a = 0; a < s.src.length; a++, h++)
-      p[h * 2] = Number(s.src[a]), p[h * 2 + 1] = Number(s.dst[a]), v && (v[h] = Number(((K = s.weight) == null ? void 0 : K[a]) ?? 1));
-  return { n: c, cells: i, positions: g, keys: I, codes: A, sizes: X, counts: D, titles: j, links: p, weights: v };
-}
-export {
-  ot as Dictionary,
-  rt as encode
-};
-//# sourceMappingURL=encode.js.map

package/dist/render/encode.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"encode.js","sources":["../../src/render/encode.ts"],"sourcesContent":["import { PAYLOAD_ADDRESS, PAYLOAD_COORDINATES } from \"@fossil-lang/corpus\";\nimport type { Binding } from \"../core/channels\";\nimport type { TileView } from \"../core/store\";\n\n/**\n * The cell columns a view reads. fossil's barrel publishes the payload's role table and not the\n * cells', so these two are spelled here; `/docs/design/graph` lists it as open on fossil's side.\n */\nconst CELL_KEY = \"cell_id\";\nconst CELL_TALLY = \"count\";\nconst CELL_MODE = \"mode\";\nconst KEY = PAYLOAD_ADDRESS[0] as string;\nconst [X, Y] = PAYLOAD_COORDINATES as [string, string];\n\n/**\n * Values to codes, in the order first seen — stable for the life of a binding. **The seed ranks\n * first, in its own order**: the manifest's ordinals or the host's named values, so a colour is\n * decided before a tile arrives. Only a value outside it is ranked by value, after the seed.\n */\nexport class Dictionary {\n  readonly values: unknown[] = [];\n  readonly #codes = new Map<unknown, number>();\n  readonly #seeded: number;\n\n  constructor(seed: readonly unknown[] = []) {\n    for (const value of seed) this.code(value);\n    this.#seeded = this.values.length;\n  }\n\n  code(value: unknown): number {\n    const key = typeof value === \"bigint\" ? Number(value) : value;\n    let code = this.#codes.get(key);\n    if (code === undefined) {\n      code = this.values.length;\n      this.values.push(key);\n      this.#codes.set(key, code);\n    }\n    return code;\n  }\n\n  /** Each code's rank: the seed's own order, then every other value seen, numbers before strings. */\n  ranks(): Uint32Array {\n    const ranks = new Uint32Array(this.values.length);\n    for (let code = 0; code < this.#seeded; code++) ranks[code] = code;\n    const rest = this.values.slice(this.#seeded).map((value, i) => ({ value, code: this.#seeded + i }));\n    rest.sort((a, b) => compare(a.value, b.value));\n    rest.forEach(({ code }, i) => {\n      ranks[code] = this.#seeded + i;\n    });\n    return ranks;\n  }\n}\n\nfunction compare(a: unknown, b: unknown): number {\n  if (typeof a === \"number\" && typeof b === \"number\") return a - b;\n  if (typeof a === \"number\") return -1;\n  if (typeof b === \"number\") return 1;\n  return String(a ?? \"\").localeCompare(String(b ?? \"\"));\n}\n\n/** One tile's rows and edges as the arrays a composition concatenates. */\nexport interface Encoded {\n  readonly n: number;\n  readonly cells: boolean;\n  /** `[x0, y0, x1, y1, …]`. */\n  readonly positions: Float32Array;\n  /** `dense_id` at the payload, `cell_id` on a rung — what an edge's ends name. */\n  readonly keys: Float64Array;\n  /** Dictionary codes of the categorical column, or `null` when nothing is bound. */\n  readonly codes: Uint32Array | null;\n  /** The ramp: `r`'s column at the payload, a cell's `count` on a rung. */\n  readonly sizes: Float32Array | null;\n  /** Vertices each row stands for: one at the payload, a cell's `count` on a rung. */\n  readonly counts: Float64Array;\n  readonly titles: readonly string[] | null;\n  /** `[src, dst, …]` in `keys`' space, every relation read from this tile, both directions. */\n  readonly links: Float64Array;\n  /** How many edges each link stands for: one at the payload, the quotient's `weight` on a rung. */\n  readonly weights: Float32Array | null;\n}\n\nconst numbers = (values: ArrayLike<unknown> | undefined, n: number): Float64Array => {\n  const out = new Float64Array(n);\n  if (values) for (let i = 0; i < n; i++) out[i] = Number(values[i] ?? Number.NaN);\n  return out;\n};\n\n/**\n * **A tile is encoded once per binding**: the arrays are made when it arrives, and a composition is a\n * concatenation of arrays already made. A cell summarises one channel, so its colour is `mode` when\n * `fill` binds the column the tree's mode is of, its size can only be `count`, and it has no title.\n */\nexport function encode(\n  view: TileView,\n  binding: Binding,\n  dictionary: Dictionary,\n  modeColumn: string | null,\n): Encoded {\n  const { rows, edges } = view.content;\n  const cells = view.kind === \"cells\";\n  const n = rows.numRows;\n  const xs = rows.getChild(X)?.toArray();\n  const ys = rows.getChild(Y)?.toArray();\n  const positions = new Float32Array(n * 2);\n  for (let i = 0; i < n; i++) {\n    positions[i * 2] = Number(xs?.[i] ?? Number.NaN);\n    positions[i * 2 + 1] = Number(ys?.[i] ?? Number.NaN);\n  }\n  const keys = numbers(rows.getChild(cells ? CELL_KEY : KEY)?.toArray(), n);\n\n  const categorical = cells ? (binding.category === modeColumn ? CELL_MODE : undefined) : binding.category;\n  const category = categorical === undefined ? undefined : rows.getChild(categorical)?.toArray();\n  let codes: Uint32Array | null = null;\n  if (category) {\n    codes = new Uint32Array(n);\n    for (let i = 0; i < n; i++) codes[i] = dictionary.code(category[i] ?? null);\n  }\n\n  const counts = cells ? numbers(rows.getChild(CELL_TALLY)?.toArray(), n) : new Float64Array(n).fill(1);\n  const ramp = cells ? (binding.size !== undefined ? counts : undefined) : binding.size;\n  const sizes =\n    ramp === undefined ? null : Float32Array.from(typeof ramp === \"string\" ? numbers(rows.getChild(ramp)?.toArray(), n) : ramp);\n\n  const named = !cells && binding.title !== undefined ? rows.getChild(binding.title)?.toArray() : undefined;\n  const titles = named ? Array.from({ length: n }, (_, i) => String(named[i] ?? \"\")) : null;\n\n  let total = 0;\n  for (const edge of edges) total += edge.src.length;\n  const links = new Float64Array(total * 2);\n  const weights = cells ? new Float32Array(total) : null;\n  let at = 0;\n  for (const edge of edges) {\n    for (let e = 0; e < edge.src.length; e++, at++) {\n      links[at * 2] = Number(edge.src[e]);\n      links[at * 2 + 1] = Number(edge.dst[e]);\n      if (weights) weights[at] = Number(edge.weight?.[e] ?? 1);\n    }\n  }\n\n  return { n, cells, positions, keys, codes, sizes, counts, titles, links, weights };\n}\n"],"names":["CELL_KEY","CELL_TALLY","CELL_MODE","KEY","PAYLOAD_ADDRESS","X","Y","PAYLOAD_COORDINATES","Dictionary","seed","__publicField","__privateAdd","_codes","_seeded","value","__privateSet","key","code","__privateGet","ranks","rest","i","a","b","compare","numbers","values","n","out","encode","view","binding","dictionary","modeColumn","rows","edges","cells","xs","_a","ys","_b","positions","keys","_c","categorical","category","_d","codes","counts","_e","ramp","sizes","_f","named","_g","titles","_","total","edge","links","weights","at","e","_h"],"mappings":"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"}

package/dist/render/when-ready.d.ts

@@ -1,35 +0,0 @@
-import { Graph } from '@cosmos.gl/graph';
-/**
- * **Every write into cosmos.gl goes through here, because a non-null instance is not a usable one.**
- *
- * cosmos.gl 3.x builds its device asynchronously. The constructor returns immediately and
- * `graphRef.current` is set, but for tens of milliseconds — longer when several graphs mount on one
- * page — the instance has no points, no links and no config to change. What happens then is not one
- * failure mode but two, and the quiet one is worse:
- *
- * - `setPointPositions` **throws** `Cannot set properties of undefined (setting 'shouldSkipRescale')`.
- *   React swallows it into the effect boundary, so it reaches the console and nothing else.
- * - `setPointColors`, `setPointSizes`, `setConfigPartial` and `fitViewByPointPositions` **do not**.
- *   They raise a dirty flag on something that is not there and return, so the picture is simply
- *   never uploaded: a blank canvas beside a badge reporting a full slice, with `onFailure` silent
- *   and nothing in the console at all.
- *
- * Measured on `/docs/graph`, where three graphs mount together and none of them drew a single point.
- * Upstream states the contract in its own `.d.ts` for `findPointsInRect` and `findPointsInPolygon`
- * — *must only be called when the graph is ready* — and it holds for every setter too.
- *
- * **The rule is a helper rather than five `await`s** because it was broken at five call sites in
- * four modules, which is what `CONVENTIONS.md` means by a rule that has to become a test.
- * `when-ready.test.ts` is that test, and it reads the source rather than the behaviour.
- *
- * **`ready` has no failure path.** When the device cannot be made, cosmos.gl does not reject — the
- * promise simply never settles, so `apply` never runs and the canvas stays empty. That is the state
- * `hasWebGL()` in `use-renderer.ts` probes for before any of this, and it is why this returns a
- * cancel rather than being awaited: nothing here may hold a caller open.
- *
- * @returns a cancel. Call it from an effect's cleanup — during a pan the slices arrive faster than
- *   a frame, and every one but the last is superseded before it could have been drawn.
- */
-export declare function whenReady(graph: Graph, apply: (graph: Graph) => void): () => void;
-export declare function isReady(graph: Graph): boolean;
-//# sourceMappingURL=when-ready.d.ts.map

package/dist/render/when-ready.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"when-ready.d.ts","sourceRoot":"","sources":["../../src/render/when-ready.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,MAAM,IAAI,CAQjF;AAeD,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAI7C"}

package/dist/render/when-ready.js

@@ -1,17 +0,0 @@
-function d(e, r) {
-  let t = !0;
-  return e.ready.then(() => {
-    t && r(e);
-  }), () => {
-    t = !1;
-  };
-}
-const n = /* @__PURE__ */ new WeakSet();
-function i(e) {
-  return n.has(e) ? !0 : (e.ready.then(() => n.add(e)), !1);
-}
-export {
-  i as isReady,
-  d as whenReady
-};
-//# sourceMappingURL=when-ready.js.map

package/dist/render/when-ready.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"when-ready.js","sources":["../../src/render/when-ready.ts"],"sourcesContent":["import type { Graph } from \"@cosmos.gl/graph\";\n\n/**\n * **Every write into cosmos.gl goes through here, because a non-null instance is not a usable one.**\n *\n * cosmos.gl 3.x builds its device asynchronously. The constructor returns immediately and\n * `graphRef.current` is set, but for tens of milliseconds — longer when several graphs mount on one\n * page — the instance has no points, no links and no config to change. What happens then is not one\n * failure mode but two, and the quiet one is worse:\n *\n * - `setPointPositions` **throws** `Cannot set properties of undefined (setting 'shouldSkipRescale')`.\n *   React swallows it into the effect boundary, so it reaches the console and nothing else.\n * - `setPointColors`, `setPointSizes`, `setConfigPartial` and `fitViewByPointPositions` **do not**.\n *   They raise a dirty flag on something that is not there and return, so the picture is simply\n *   never uploaded: a blank canvas beside a badge reporting a full slice, with `onFailure` silent\n *   and nothing in the console at all.\n *\n * Measured on `/docs/graph`, where three graphs mount together and none of them drew a single point.\n * Upstream states the contract in its own `.d.ts` for `findPointsInRect` and `findPointsInPolygon`\n * — *must only be called when the graph is ready* — and it holds for every setter too.\n *\n * **The rule is a helper rather than five `await`s** because it was broken at five call sites in\n * four modules, which is what `CONVENTIONS.md` means by a rule that has to become a test.\n * `when-ready.test.ts` is that test, and it reads the source rather than the behaviour.\n *\n * **`ready` has no failure path.** When the device cannot be made, cosmos.gl does not reject — the\n * promise simply never settles, so `apply` never runs and the canvas stays empty. That is the state\n * `hasWebGL()` in `use-renderer.ts` probes for before any of this, and it is why this returns a\n * cancel rather than being awaited: nothing here may hold a caller open.\n *\n * @returns a cancel. Call it from an effect's cleanup — during a pan the slices arrive faster than\n *   a frame, and every one but the last is superseded before it could have been drawn.\n */\nexport function whenReady(graph: Graph, apply: (graph: Graph) => void): () => void {\n  let live = true;\n  void graph.ready.then(() => {\n    if (live) apply(graph);\n  });\n  return () => {\n    live = false;\n  };\n}\n\n/**\n * Whether this instance's device has arrived, answered **synchronously**.\n *\n * For the two call sites that cannot wait: `findPointsInRect` and `findPointsInPolygon` run inside a\n * pointer handler and have to return a number, and upstream marks exactly those two — and nothing\n * else in its `.d.ts` — *must only be called when the graph is ready*.\n *\n * The flag is kept beside the instance rather than on it, in a `WeakSet`, because the promise is the\n * only thing cosmos.gl exposes and a promise cannot be asked whether it has settled. A graph that is\n * never asked about is never added, which costs one `false` and one hit test that selects nothing.\n */\nconst arrived = new WeakSet<Graph>();\n\nexport function isReady(graph: Graph): boolean {\n  if (arrived.has(graph)) return true;\n  void graph.ready.then(() => arrived.add(graph));\n  return false;\n}\n"],"names":["whenReady","graph","apply","live","arrived","isReady"],"mappings":"AAiCO,SAASA,EAAUC,GAAcC,GAA2C;AACjF,MAAIC,IAAO;AACX,SAAKF,EAAM,MAAM,KAAK,MAAM;AAC1B,IAAIE,OAAYF,CAAK;AAAA,EACvB,CAAC,GACM,MAAM;AACX,IAAAE,IAAO;AAAA,EACT;AACF;AAaA,MAAMC,wBAAc,QAAA;AAEb,SAASC,EAAQJ,GAAuB;AAC7C,SAAIG,EAAQ,IAAIH,CAAK,IAAU,MAC1BA,EAAM,MAAM,KAAK,MAAMG,EAAQ,IAAIH,CAAK,CAAC,GACvC;AACT;"}