@graphty/graphty-element 2.3.1 → 2.4.1

package/dist/src/session/styles/intern.d.ts

@@ -26,9 +26,17 @@
  * does today. {@link channelRole} is where that split is written down, and
  * {@link meshChannelsFor} is the list a repaint pushes.
  *
- * A KEY IS OPAQUE AND SESSION-LOCAL. It is the order a style was first seen in, so it is stable
- * for the life of the session and meaningless outside it. Nothing may persist one, compare two
- * from different sessions, or read anything back out of the number.
+ * A KEY IS OPAQUE AND SESSION-LOCAL. It names one style for the life of the session and is
+ * meaningless outside it. Nothing may persist one, compare two from different sessions, or read
+ * anything back out of the number.
+ *
+ * A KEY IS RELEASED WHEN NOTHING IS DRAWN FROM IT, AND NEVER HANDED OUT AGAIN. The repaint counts
+ * the elements drawn from each key ({@link StyleInterner.retain}, {@link StyleInterner.release}),
+ * and a style no element holds is forgotten, so what the interner keeps follows the looks on
+ * screen rather than every edit ever made. The number is not recycled: a renderer names a cached
+ * source mesh after it, and a recycled key would hand one look's mesh to another. The storage
+ * behind a key IS recycled, which is what keeps a session that edits a size a thousand times
+ * the size of the picture it draws.
  *
  * Nothing here reaches Babylon.js, Lit or the DOM.
  */
@@ -76,7 +84,7 @@ export declare function meshChannelsFor(target: "node" | "edge"): readonly Chann
  * into the interner.
  */
 export interface StyleInterner<T> {
-    /** How many distinct styles have been minted. Keys run from 0 to this less one. */
+    /** How many distinct styles are held: minted and not yet released. */
     readonly size: number;
     /** Start a new sequence, discarding anything pushed and not ended. */
     begin(): void;
@@ -105,9 +113,22 @@ export interface StyleInterner<T> {
     /**
      * Finish the sequence and answer with the key the style it describes is known by.
      * @param mint - Builds the style object, called ONLY when the sequence is new.
-     * @returns The key: the order the style was first seen in.
+     * @returns The key, which no other style is ever given in this interner.
      */
     end(mint: () => T): number;
+    /**
+     * Say that one more element is drawn from a key.
+     * @param key - The key, as {@link end} answered with.
+     */
+    retain(key: number): void;
+    /**
+     * Say that one element fewer is drawn from a key, and forget its style when none is left.
+     *
+     * A style that has been minted and never retained is held until something retains and then
+     * releases it: minting is a lookup, and a lookup must not take a style away.
+     * @param key - The key, as {@link end} answered with.
+     */
+    release(key: number): void;
     /**
      * The style one key stands for.
      * @param key - The key, as {@link end} answered with.

package/dist/src/session/styles/repaint.d.ts

@@ -168,7 +168,8 @@ export interface ElementPaint {
      *
      * This is the number a structural hash exists to keep small: it must follow the distinct
      * SHAPES and SIZES in the picture, never the element count, and a colour encoding must not
-     * move it.
+     * move it. A mesh no element is drawn from any more is not counted: its key is released and
+     * never handed out again.
      * @param target - Nodes or edges.
      * @returns The count, which is at least one.
      */

package/dist/src/session/types.d.ts

@@ -15,7 +15,7 @@
 import type { DerivedGraph, GraphSnapshot, NodeId } from "@graphty/graph-format";
 import type { z } from "zod/v4";
 import type { AccelerationCapabilities, AccelerationPolicy, AccelerationStatus, GraphAccelerator } from "../acceleration";
-import type { AlgorithmKey, AttributeDescriptor, CatalogApi, EdgeId, RunId, Scope } from "../catalog/types";
+import type { AlgorithmKey, AttributeDescriptor, CatalogApi, DeprecatedCatalogMethod, EdgeId, RunId, Scope } from "../catalog/types";
 import type { DataConfig } from "../config/DataConfig";
 import type { ElementPositions } from "../data/positions";
 import type { ImportReport } from "../data/report";
@@ -347,12 +347,12 @@ export interface SessionDataApi {
  * been run. A consumer wanting only the metrics that CAN run filters on `available`; both lists
  * come off one call rather than two that could disagree.
  *
- * The rest of the graph-dependent half of {@link CatalogApi} -- what an option's bounds resolve to
- * over a scope, whether an expression references anything real -- is still absent rather than
- * stubbed: the session's query engine exists, and the catalogue is not wired to it yet. A consumer discovers that gap by
- * autocomplete finding nothing, not by a call that throws.
+ * The rest of {@link CatalogApi} -- the methods named in `DeprecatedCatalogMethod` -- is absent
+ * rather than stubbed, and deprecated on `CatalogApi` itself. A consumer discovers that gap by
+ * autocomplete finding nothing, not by a call that throws. This type is derived from that list,
+ * so implementing one of them means deleting its name there and nothing here.
  */
-export type SessionCatalogApi = Pick<CatalogApi, "algorithms" | "cameras" | "formats" | "layouts" | "logSinks" | "metrics" | "palettes" | "scales">;
+export type SessionCatalogApi = Omit<CatalogApi, DeprecatedCatalogMethod>;
 /** The configuration a session carries. */
 export interface SessionConfig {
     /** The data configuration: id paths, weight paths, position scale, direction, id coercion. */

package/dist/src/xr/XRSessionManager.d.ts

@@ -11,7 +11,7 @@ interface XRSessionConfig {
         referenceSpaceType: XRReferenceSpaceType;
         optionalFeatures?: string[];
     };
-    /** Whether XR sessions track hands (`xr.input.handTracking`). On, Babylon downloads hand meshes. Defaults to true. */
+    /** Whether XR sessions track hands (`xr.input.handTracking`). Defaults to true. */
     handTracking?: boolean;
 }
 /**

package/dist/webgpu.d.ts

@@ -46,6 +46,14 @@
  * republishes rather than finishing that work anywhere else. Recorded in
  * `docs/decisions/device-computes-incorrectly.md`.
  *
+ * That the ELEMENT reports `E_DEVICE_INCORRECT` on the Windows WARP renderer is inference, by
+ * decision, not a test: no lane runs graphty-element on WARP. The host matrix (`hosts.yml`) runs
+ * only webgpu-graph-algorithms there, whose own tests show the multi-block scan failing. This
+ * file's side -- a failed check becomes `E_DEVICE_INCORRECT`, and the controller refuses the
+ * device at attach -- is pinned against a stubbed peer and a deliberately wrong fake. Adding an
+ * element job to the Windows lane is a CI cost that can be taken on later if the two halves ever
+ * disagree.
+ *
  * ## Detection is not a fallback
  *
  * Finding out, before anything runs, that this host has no WebGPU and letting the element take

package/dist/webgpu.js

@@ -1,7 +1,7 @@
 import { EXACT_MAX_NODES as n, createAccelerator as p, verifyDevice as u } from "@graphty/webgpu-graph-algorithms";
 import { probeBrowserWebGpu as l, requestGpuContext as d } from "@graphty/webgpu-graph-algorithms/browser";
-import { r as h } from "./chunks/registry-CSba5QGJ.js";
-import { G as s } from "./chunks/GraphtyError-BwcnblTH.js";
+import { r as h } from "./chunks/registry-DQeq4B2K.js";
+import { G as s } from "./chunks/pluginRegistry-MaTIDh6l.js";
 const a = "webgpu-graph-algorithms", w = /* @__PURE__ */ new Set(["kind", "ctx", "options", "dispose", "verify"]);
 function b(o, e) {
   for (const [r, t] of Object.entries(o))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graphty/graphty-element",
-  "version": "2.3.1",
+  "version": "2.4.1",
   "description": "A Web Component library for 3D/2D graph visualization built with Lit and Babylon.js",
   "type": "module",
   "customElements": "./dist/custom-elements.json",
@@ -133,8 +133,8 @@
     "vite-plugin-eslint": "^1.8.1",
     "vitepress": "^1.6.3",
     "vitest": "^3.2.4",
-    "@graphty/remote-logger": "^1.3.7",
-    "@graphty/webgpu-graph-algorithms": "^0.6.5"
+    "@graphty/webgpu-graph-algorithms": "^0.6.7",
+    "@graphty/remote-logger": "^1.3.7"
   },
   "peerDependencies": {
     "@ai-sdk/anthropic": "^2.0.50",
@@ -146,7 +146,7 @@
     "ai": "^5.0.104",
     "encrypt-storage": "^2.14.7",
     "lit": "^3.0.0",
-    "@graphty/webgpu-graph-algorithms": "^0.6.5"
+    "@graphty/webgpu-graph-algorithms": "^0.6.7"
   },
   "peerDependenciesMeta": {
     "@ai-sdk/anthropic": {
@@ -184,9 +184,9 @@
     "papaparse": "^5.5.3",
     "toposort": "^2.0.2",
     "zod": "^3.25.28",
-    "@graphty/algorithms": "^2.0.3",
+    "@graphty/algorithms": "^2.0.4",
     "@graphty/graph-format": "^1.0.5",
-    "@graphty/layout": "^1.9.1"
+    "@graphty/layout": "^1.10.0"
   },
   "overrides": {
     "storybook": "$storybook"

package/dist/chunks/GraphtyError-BwcnblTH.js

@@ -1,132 +0,0 @@
-const N = {
-  E_BAD_COMMAND: "E_BAD_COMMAND",
-  E_BAD_QUERY: "E_BAD_QUERY",
-  E_BAD_LAYER: "E_BAD_LAYER",
-  E_BAD_SELECTOR: "E_BAD_SELECTOR",
-  E_BAD_FORMULA: "E_BAD_FORMULA",
-  E_SELECTOR_EMPTY: "E_SELECTOR_EMPTY",
-  E_UNSCOPED_RUN_ENCODING: "E_UNSCOPED_RUN_ENCODING",
-  E_UNKNOWN_SCALE: "E_UNKNOWN_SCALE",
-  E_UNKNOWN_CHANNEL: "E_UNKNOWN_CHANNEL",
-  E_UNKNOWN_OPTION: "E_UNKNOWN_OPTION",
-  E_OPTION_RANGE: "E_OPTION_RANGE",
-  E_UNKNOWN_ATTRIBUTE: "E_UNKNOWN_ATTRIBUTE",
-  E_UNKNOWN_ALGORITHM: "E_UNKNOWN_ALGORITHM",
-  E_UNKNOWN_LAYOUT: "E_UNKNOWN_LAYOUT",
-  E_UNKNOWN_FORMAT: "E_UNKNOWN_FORMAT",
-  E_UNKNOWN_PALETTE: "E_UNKNOWN_PALETTE",
-  E_UNKNOWN_CAMERA: "E_UNKNOWN_CAMERA",
-  E_UNKNOWN_SINK: "E_UNKNOWN_SINK",
-  E_UNKNOWN_RUN: "E_UNKNOWN_RUN",
-  E_UNSTABLE_RUN_ID: "E_UNSTABLE_RUN_ID",
-  E_DUPLICATE_ID: "E_DUPLICATE_ID",
-  E_DUPLICATE_EDGE: "E_DUPLICATE_EDGE",
-  E_DUPLICATE_PLUGIN: "E_DUPLICATE_PLUGIN",
-  E_PROTECTED: "E_PROTECTED",
-  E_FETCH_FAILED: "E_FETCH_FAILED",
-  E_PARSE_FAILED: "E_PARSE_FAILED",
-  E_EDGE_ENDPOINTS_UNRESOLVED: "E_EDGE_ENDPOINTS_UNRESOLVED",
-  E_ID_MISSING: "E_ID_MISSING",
-  E_TOO_LARGE: "E_TOO_LARGE",
-  E_OUT_OF_MEMORY: "E_OUT_OF_MEMORY",
-  E_CAP_EXCEEDED: "E_CAP_EXCEEDED",
-  E_SCOPE_EMPTY: "E_SCOPE_EMPTY",
-  E_NOT_CONVERGED: "E_NOT_CONVERGED",
-  E_NO_ACCELERATOR: "E_NO_ACCELERATOR",
-  E_NO_WEBGPU: "E_NO_WEBGPU",
-  E_NO_ADAPTER: "E_NO_ADAPTER",
-  E_SOFTWARE_ONLY: "E_SOFTWARE_ONLY",
-  E_DEVICE_INCORRECT: "E_DEVICE_INCORRECT",
-  E_DEVICE_LOST: "E_DEVICE_LOST",
-  E_NO_WEBGL: "E_NO_WEBGL",
-  E_UNSUPPORTED: "E_UNSUPPORTED",
-  E_READONLY: "E_READONLY",
-  E_DISPOSED: "E_DISPOSED",
-  E_INTERNAL: "E_INTERNAL"
-}, U = Object.freeze(Object.values(N)), C = Object.freeze([
-  N.E_NO_WEBGPU,
-  N.E_NO_ADAPTER,
-  N.E_SOFTWARE_ONLY,
-  N.E_DEVICE_INCORRECT,
-  N.E_DEVICE_LOST,
-  N.E_TOO_LARGE
-]);
-function s(_) {
-  return typeof _ == "string" && Object.hasOwn(N, _);
-}
-const r = Object.freeze({});
-function D(_) {
-  if (typeof _ != "object" || _ === null || !("code" in _))
-    return;
-  const { code: E } = _;
-  return s(E) ? E : void 0;
-}
-function R(_) {
-  if (typeof _ != "object" || _ === null || !("code" in _))
-    return;
-  const { code: E } = _;
-  return typeof E == "string" && !s(E) ? E : void 0;
-}
-class e extends Error {
-  /**
-   * Builds an error.
-   * @param init - The code, the message, the failing area and anything else known about the
-   * failure.
-   */
-  constructor(E) {
-    super(E.message, E.cause === void 0 ? void 0 : { cause: E.cause }), this.name = "GraphtyError", Object.setPrototypeOf(this, new.target.prototype), this.code = E.code, this.source = E.source, this.recoverable = E.recoverable ?? !1, this.details = E.details === void 0 ? r : Object.freeze({ ...E.details }), E.target !== void 0 && (this.target = E.target);
-  }
-  /**
-   * Re-reports a failure from somewhere else as a `GraphtyError`.
-   *
-   * A sibling package -- graph-io, graph-format, the WebGPU peer -- throws its own class. The
-   * class does not cross the boundary, so the element carries the code instead: when the
-   * original's `code` is one the element knows, that code wins; when it is a string the
-   * element does not know, it is kept in `details.sourceCode` and the caller's code is used.
-   * A value that is already a `GraphtyError` is returned untouched, so the most specific code
-   * survives.
-   * @param cause - The thrown value being wrapped.
-   * @param init - The code, area and facts to use when the original supplies none.
-   * @returns The error to throw.
-   */
-  static wrap(E, O) {
-    if (E instanceof e)
-      return E;
-    const A = D(E), t = R(E), o = O.message ?? (E instanceof Error ? E.message : String(E)), T = t === void 0 ? O.details : { ...O.details, sourceCode: t };
-    return new e({
-      ...O,
-      code: A ?? O.code,
-      message: o,
-      details: T,
-      cause: E
-    });
-  }
-  /**
-   * Renders the error as plain JSON.
-   *
-   * Called by `JSON.stringify`, and used wherever an error has to survive a boundary a class
-   * cannot cross: a log line, a worker message, a bug report.
-   * @returns The serialisable form.
-   */
-  toJSON() {
-    const E = {
-      name: this.name,
-      code: this.code,
-      message: this.message,
-      source: this.source,
-      recoverable: this.recoverable,
-      details: this.details
-    };
-    return this.target !== void 0 && (E.target = this.target), this.cause instanceof Error && (E.causeMessage = this.cause.message), E;
-  }
-}
-function L(_) {
-  return _ instanceof e;
-}
-export {
-  C as A,
-  e as G,
-  U as a,
-  s as b,
-  L as i
-};