@xenolithengine/graph-solid 0.7.0-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 strelok2012
+
+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,54 @@
+# @xenolithengine/graph-solid
+
+[![BETA](https://img.shields.io/badge/status-BETA-FCB400?style=flat-square)](https://github.com/XenolithEngine/xenolith-graph#status)
+[![MIT](https://img.shields.io/badge/license-MIT-FCB400?style=flat-square)](https://github.com/XenolithEngine/xenolith-graph/blob/main/LICENSE)
+
+Solid adapter for XenolithGraph — the `use:xenolith` directive.
+
+> **Beta** — public API in `STABLE-API.md` is the surface we plan to freeze, but it is **NOT frozen yet** — breaking changes can land at any point before v1.0. If you adopt now, pin an exact version.
+
+Part of [XenolithGraph](https://github.com/XenolithEngine/xenolith-graph) — an AI-native, embeddable node-graph editor for the web with its own visual design language (Xen).
+
+## Install
+
+```bash
+pnpm add @xenolithengine/graph-solid pixi.js
+```
+
+Peer deps: `solid-js >= 1.8`, `pixi.js@^8.6.0`. WebGL/client-only.
+
+## Usage
+
+```tsx
+import { xenolith } from '@xenolithengine/graph-solid'
+import savedGraph from './graph.json'
+
+// Re-import is required for Solid to pick up the directive in JSX.
+xenolith
+
+export function Editor() {
+  const props = () => ({ graph: savedGraph, minimap: true })
+  return (
+    <div
+      use:xenolith={props()}
+      on:node:click={(e) => console.log(e.detail.nodeId)}
+      on:selection:changed={(e) => console.log(e.detail)}
+      style="width: 100%; height: 100vh"
+    />
+  )
+}
+```
+
+Editor events are re-dispatched as same-named `CustomEvent`s — Solid's `on:` binds colon names directly.
+
+## What's exported
+
+- `xenolith` — the Solid directive (`use:xenolith={props}`)
+- `createXenolithGraph(el, props)` — imperative primitive returning an `EditorBinding`
+
+## Docs
+
+- [API reference](https://xenolithengine.github.io/xenolith-graph/guides/api/) — every method exposed by `XenolithEditor`
+- [GitHub](https://github.com/XenolithEngine/xenolith-graph)
+
+MIT © XenolithEngine

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+import { type EditorBinding, type XenolithProps } from '@xenolithengine/graph-adapter-core';
+/**
+ * Solid directive: `<div use:xenolith={props} on:node:click={…} on:selection:changed={…} />`.
+ * Mounts the editor into the element, syncs props reactively, and re-dispatches every editor event
+ * off the element as a same-named CustomEvent (Solid's `on:` binds colon names). Client-only (WebGL).
+ *
+ * Solid calls a directive as `xenolith(el, accessor)`, where `accessor()` is the bound value.
+ */
+export declare function xenolith(el: HTMLElement, accessor: () => XenolithProps | undefined): void;
+/** Imperative primitive for hosts that prefer it over the directive. Returns the binding promise;
+ *  the caller owns teardown (call `destroy()` from `onCleanup`). */
+export declare function createXenolithGraph(el: HTMLElement, props?: XenolithProps): Promise<EditorBinding>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,aAAa,EACnB,MAAM,oCAAoC,CAAA;AAE3C;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,aAAa,GAAG,SAAS,GAAG,IAAI,CAkBzF;AAED;oEACoE;AACpE,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,GAAE,aAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAEtG"}

package/dist/index.js

@@ -0,0 +1,36 @@
+import { createEffect, onCleanup } from 'solid-js';
+import { createEditorBinding, EDITOR_EVENT_NAMES, } from '@xenolithengine/graph-adapter-core';
+/**
+ * Solid directive: `<div use:xenolith={props} on:node:click={…} on:selection:changed={…} />`.
+ * Mounts the editor into the element, syncs props reactively, and re-dispatches every editor event
+ * off the element as a same-named CustomEvent (Solid's `on:` binds colon names). Client-only (WebGL).
+ *
+ * Solid calls a directive as `xenolith(el, accessor)`, where `accessor()` is the bound value.
+ */
+export function xenolith(el, accessor) {
+    let binding = null;
+    let destroyed = false;
+    const offs = [];
+    void createEditorBinding(el, accessor() ?? {}).then((b) => {
+        if (destroyed) {
+            b.destroy();
+            return;
+        }
+        binding = b;
+        for (const ev of EDITOR_EVENT_NAMES) {
+            offs.push(b.on(ev, (detail) => el.dispatchEvent(new CustomEvent(ev, { detail }))));
+        }
+        b.setProps(accessor() ?? {});
+    });
+    // Re-run whenever the bound props signal changes.
+    createEffect(() => { const p = accessor(); if (p)
+        binding?.setProps(p); });
+    onCleanup(() => { destroyed = true; for (const off of offs)
+        off(); binding?.destroy(); binding = null; });
+}
+/** Imperative primitive for hosts that prefer it over the directive. Returns the binding promise;
+ *  the caller owns teardown (call `destroy()` from `onCleanup`). */
+export function createXenolithGraph(el, props = {}) {
+    return createEditorBinding(el, props);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAClD,OAAO,EACL,mBAAmB,EACnB,kBAAkB,GAGnB,MAAM,oCAAoC,CAAA;AAE3C;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,EAAe,EAAE,QAAyC;IACjF,IAAI,OAAO,GAAyB,IAAI,CAAA;IACxC,IAAI,SAAS,GAAG,KAAK,CAAA;IACrB,MAAM,IAAI,GAAsB,EAAE,CAAA;IAElC,KAAK,mBAAmB,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;QACxD,IAAI,SAAS,EAAE,CAAC;YAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAAC,OAAM;QAAC,CAAC;QACtC,OAAO,GAAG,CAAC,CAAA;QACX,KAAK,MAAM,EAAE,IAAI,kBAAkB,EAAE,CAAC;YACpC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;QACpF,CAAC;QACD,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;IAC9B,CAAC,CAAC,CAAA;IAEF,kDAAkD;IAClD,YAAY,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;IAEzE,SAAS,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC,KAAK,MAAM,GAAG,IAAI,IAAI;QAAE,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,GAAG,IAAI,CAAA,CAAC,CAAC,CAAC,CAAA;AAC1G,CAAC;AAED;oEACoE;AACpE,MAAM,UAAU,mBAAmB,CAAC,EAAe,EAAE,QAAuB,EAAE;IAC5E,OAAO,mBAAmB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;AACvC,CAAC"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@xenolithengine/graph-solid",
+  "version": "0.7.0-beta.0",
+  "description": "Solid adapter for XenolithGraph — the use:xenolith directive.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "@xenolithengine/graph-adapter-core": "0.7.0-beta.0",
+    "@xenolithengine/graph-editor": "0.7.0-beta.0"
+  },
+  "peerDependencies": {
+    "pixi.js": "^8.6.0",
+    "solid-js": ">=1.8"
+  },
+  "devDependencies": {
+    "jsdom": "^25.0.0",
+    "pixi.js": "^8.6.0",
+    "solid-js": "^1.8.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "keywords": [
+    "solid",
+    "solidjs",
+    "node-editor",
+    "node-graph",
+    "graph-editor"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/XenolithEngine/xenolith-graph.git",
+    "directory": "packages/solid"
+  },
+  "homepage": "https://xenolithengine.github.io/xenolith-graph/",
+  "bugs": {
+    "url": "https://github.com/XenolithEngine/xenolith-graph/issues"
+  },
+  "author": "XenolithEngine",
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "tsc -b --watch",
+    "test": "vitest run --passWithNoTests",
+    "lint": "eslint src",
+    "typecheck": "tsc --noEmit"
+  }
+}