Consolidate Lit repositories: figma-to-lit, figma_lit_example, lit-3d-piano, lit-calculator, lit-code-editor, lit-draggable-dom, lit-file-based-routing, lit-force-graph, lit-html-editor, lit-html-table, lit-modules, lit-native, lit-node-editor, lit-sheet-music, lit-starter-ts, lit-vscode-extension, lit-wmr, vite-lit-capacitor, vite-lit-element-starter, vite-rxdb-lit

2026-05-16 22:17:12 -07:00
parent 4dc3c8a3ff
commit 95667e3038
527 changed files with 63872 additions and 54 deletions
@@ -0,0 +1,24 @@
+name: Demo
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Use Node.js
+        uses: actions/setup-node@v1
+        with:
+          node-version: 12.x
+      - run: npm install
+      - run: npm run build
+
+      - name: Deploy
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./dist
@@ -0,0 +1,24 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
@@ -0,0 +1,16 @@
+# Lit Force Graph
+
+[![Demo](https://github.com/rodydavis/lit-force-graph/actions/workflows/ci.yml/badge.svg)](https://github.com/rodydavis/lit-force-graph/actions/workflows/ci.yml)
+
+[Lit](https://lit.dev) Example of how to take a json graph file and render it in 2D or 3D.
+
+You can try the demo [here](https://rodydavis.github.io/lit-force-graph/)!
+
+Here is the related [blog post](https://rodydavis.com/posts/lit-force-graph/).
+
+## Screenshots
+
+![](/screenshots/2d-light.png)
+![](/screenshots/2d-dark.png)
+![](/screenshots/3d-light.png)
+![](/screenshots/3d-dark.png)
@@ -0,0 +1,65 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/src/favicon.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Lit Force Graph</title>
+    <script type="module" src="/src/lit-force-graph.ts"></script>
+    <link rel="stylesheet" href="/style.css" />
+  </head>
+  <body>
+    <lit-force-graph>
+      <script type="application/json">
+        {
+          "name": "Lit Force Graph",
+          "description": "A force graph built with Lit",
+          "nodes": [
+            {
+              "id": "1",
+              "name": "Node 1"
+            },
+            {
+              "id": "2",
+              "name": "Node 2"
+            },
+            {
+              "id": "3",
+              "name": "Node 3"
+            },
+            {
+              "id": "4",
+              "name": "Node 4"
+            }
+          ],
+          "links": [
+            {
+              "source": "1",
+              "target": "2"
+            },
+            {
+              "source": "1",
+              "target": "3"
+            },
+            {
+              "source": "2",
+              "target": "3"
+            },
+            {
+              "source": "2",
+              "target": "4"
+            },
+            {
+              "source": "3",
+              "target": "4"
+            },
+            {
+              "source": "4",
+              "target": "1"
+            }
+          ]
+        }
+      </script>
+    </lit-force-graph>
+  </body>
+</html>
@@ -0,0 +1,35 @@
+{
+  "name": "lit-force-graph",
+  "private": true,
+  "version": "0.0.0",
+  "main": "dist/my-element.es.js",
+  "exports": {
+    ".": "./dist/my-element.es.js"
+  },
+  "types": "types/my-element.d.ts",
+  "files": [
+    "dist",
+    "types"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build"
+  },
+  "dependencies": {
+    "@ar-js-org/ar.js": "^3.4.0-alpha-rc2",
+    "3d-force-graph": "^1.70.9",
+    "3d-force-graph-ar": "^1.7.5",
+    "3d-force-graph-vr": "^2.0.12",
+    "aframe": "^1.3.0",
+    "force-graph": "^1.42.9",
+    "lit": "^2.0.2",
+    "three": "^0.139.2",
+    "three-spritetext": "^1.6.5"
+  },
+  "devDependencies": {
+    "@types/node": "^17.0.23",
+    "@types/three": "^0.139.0",
+    "typescript": "^4.5.4",
+    "vite": "^2.9.0"
+  }
+}
@@ -0,0 +1,31 @@
+body {
+  margin: 0;
+  padding: 0;
+  overflow: hidden;
+  font-size: 12px;
+  font-family: "Helvetica Neue", Helvetica, Arial, sans-serif;
+  position: relative;
+  width: 100%;
+  height: 100%;
+}
+
+lit-force-graph {
+  width: 100%;
+  height: 100vh;
+}
+
+:root {
+  --graph-background-color: #eee;
+  --graph-foreground-color: #000;
+  --graph-line-color: rgb(90, 90, 90);
+  --graph-node-color: rgb(218, 14, 14);
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --graph-background-color: #000;
+    --graph-foreground-color: #fafafa;
+    --graph-line-color: rgb(214, 214, 214);
+    --graph-node-color: rgb(228, 8, 8);
+  }
+}
@@ -0,0 +1,9 @@
+import { GraphData, GraphNode } from "./graph";
+
+export interface RenderContext {
+  data: GraphData;
+  element: HTMLElement;
+  onHover: (node?: GraphNode) => void;
+}
+
+export type Renderer = (context: RenderContext) => void;
@@ -0,0 +1,46 @@
+export class Graph {
+  private ids = new Set();
+  private graph: GraphData = {
+    nodes: [],
+    links: [],
+  };
+
+  addNode<T = any>(node: GraphNode<T>) {
+    if (this.ids.has(node.id)) {
+      return this.graph.nodes.find((n) => n.id === node.id)!;
+    }
+    this.ids.add(node.id);
+    this.graph.nodes.push(node);
+    return node;
+  }
+
+  addLink<T = any>(link: GraphLink<T>) {
+    this.graph.links.push(link);
+    return link;
+  }
+
+  toJSON() {
+    return this.graph;
+  }
+}
+
+export interface GraphNode<T = any> {
+  id: string;
+  name?: string;
+  group?: string;
+  value?: T;
+}
+
+export interface GraphLink<T = any> {
+  source: string;
+  target: string;
+  name?: string;
+  value?: T;
+}
+
+export interface GraphData<A = any, B = any> {
+  name?: string;
+  description?: string;
+  nodes: GraphNode<A>[];
+  links: GraphLink<B>[];
+}
@@ -0,0 +1,15 @@
+<svg width="410" height="404" viewBox="0 0 410 404" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M399.641 59.5246L215.643 388.545C211.844 395.338 202.084 395.378 198.228 388.618L10.5817 59.5563C6.38087 52.1896 12.6802 43.2665 21.0281 44.7586L205.223 77.6824C206.398 77.8924 207.601 77.8904 208.776 77.6763L389.119 44.8058C397.439 43.2894 403.768 52.1434 399.641 59.5246Z" fill="url(#paint0_linear)"/>
+<path d="M292.965 1.5744L156.801 28.2552C154.563 28.6937 152.906 30.5903 152.771 32.8664L144.395 174.33C144.198 177.662 147.258 180.248 150.51 179.498L188.42 170.749C191.967 169.931 195.172 173.055 194.443 176.622L183.18 231.775C182.422 235.487 185.907 238.661 189.532 237.56L212.947 230.446C216.577 229.344 220.065 232.527 219.297 236.242L201.398 322.875C200.278 328.294 207.486 331.249 210.492 326.603L212.5 323.5L323.454 102.072C325.312 98.3645 322.108 94.137 318.036 94.9228L279.014 102.454C275.347 103.161 272.227 99.746 273.262 96.1583L298.731 7.86689C299.767 4.27314 296.636 0.855181 292.965 1.5744Z" fill="url(#paint1_linear)"/>
+<defs>
+<linearGradient id="paint0_linear" x1="6.00017" y1="32.9999" x2="235" y2="344" gradientUnits="userSpaceOnUse">
+<stop stop-color="#41D1FF"/>
+<stop offset="1" stop-color="#BD34FE"/>
+</linearGradient>
+<linearGradient id="paint1_linear" x1="194.651" y1="8.81818" x2="236.076" y2="292.989" gradientUnits="userSpaceOnUse">
+<stop stop-color="#FFEA83"/>
+<stop offset="0.0833333" stop-color="#FFDD35"/>
+<stop offset="1" stop-color="#FFA800"/>
+</linearGradient>
+</defs>
+</svg>
@@ -0,0 +1,217 @@
+import { html, css, LitElement } from "lit";
+import { customElement, property, query, state } from "lit/decorators.js";
+import { Renderer } from "./classes/context";
+import { GraphData, GraphNode } from "./classes/graph";
+import { render as render2D } from "./modes/mode-2d";
+import { render as render3D } from "./modes/mode-3d";
+
+export const tagName = "lit-force-graph";
+
+@customElement(tagName)
+export class LitForceGraph extends LitElement {
+  static styles = css`
+    :host {
+      background-color: var(--graph-background-color, #000011);
+      color: var(--graph-foreground-color, #ffffff);
+      width: var(--graph-width, 100%);
+      height: var(--graph-height, 100vh);
+    }
+
+    #graph {
+      width: 100%;
+      height: 100%;
+      width: var(--graph-width, 100%);
+      height: var(--graph-height, 100vh);
+    }
+
+    #controls {
+      position: absolute;
+      top: 20px;
+      right: 20px;
+      z-index: 100 !important;
+      display: flex;
+      flex-direction: column;
+      align-items: flex-end;
+    }
+    #controls div {
+      padding: 5px;
+    }
+
+    #info {
+      position: absolute;
+      top: 10px;
+      left: 10px;
+      z-index: 100 !important;
+      display: flex;
+      flex-direction: column;
+      align-items: flex-start;
+    }
+
+    #tooltips {
+      position: absolute;
+      bottom: 10px;
+      left: 10px;
+      right: 10px;
+      display: flex;
+      flex-direction: row;
+      align-items: center;
+      text-align: center;
+      justify-content: center;
+    }
+
+    .node-tooltip {
+      background-color: var(--graph-foreground-color, #ffffff);
+      color: var(--graph-background-color, #000011);
+      border-radius: 5px;
+      font-size: 12px;
+      padding: 5px;
+      opacity: 0.67;
+    }
+
+    #graph-description {
+      opacity: 0.67;
+    }
+
+    .scene-tooltip {
+      color: var(--graph-foreground-color, #ffffff);
+      background-color: transparent;
+      display: none;
+    }
+  `;
+
+  @query("#graph") graph!: HTMLElement;
+  @property() src = "";
+  @property() mode = "2D";
+  @property({ type: Object }) data?: GraphData;
+  @state() hovered?: GraphNode;
+
+  renderers = new Map<string, Renderer>([
+    ["2D", render2D],
+    ["3D", render3D],
+  ]);
+
+  render() {
+    return html` <main
+      accept="application/json"
+      @drop="${this.onDrop}"
+      @dragover="${(e: Event) => e.preventDefault()}"
+    >
+      <div id="graph"></div>
+      <div id="controls">
+        <div>
+          <label for="render-mode">Render mode</label>
+          <select id="render-mode" @change=${this.onChangeMode}>
+            ${Array.from(this.renderers.keys()).map((mode) => {
+              return html` <option value="${mode}">${mode}</option> `;
+            })}
+          </select>
+        </div>
+      </div>
+      <div id="info">
+        <h2 id="graph-name">${this.data?.name}</h2>
+        <div id="graph-description">${this?.data?.description}</div>
+      </div>
+      <div id="tooltips">
+        ${this.hovered
+          ? html` <div class="node-tooltip">
+              ${this.hovered?.name ?? this.hovered?.id}
+            </div>`
+          : html``}
+      </div>
+    </main>`;
+  }
+
+  async firstUpdated() {
+    await this.refresh();
+    const prefersDark = window.matchMedia("(prefers-color-scheme: dark)");
+    prefersDark.addEventListener("change", () => {
+      this.refresh();
+    });
+  }
+
+  /**
+   * Set the graph data and update the renderer
+   *
+   * @param data Graph JSON
+   */
+  setData(data: GraphData) {
+    this.data = data;
+    const renderer = this.renderers.get(this.mode);
+    renderer?.({
+      element: this.graph,
+      data,
+      onHover: (node) => (this.hovered = node),
+    });
+  }
+
+  private async refresh() {
+    // Get json from script tag
+    const children = Array.from(this.children);
+    const elem = children.find((child) => child.tagName === "SCRIPT");
+    if (elem) {
+      // Render from script tag contents
+      if (elem.textContent) {
+        const data = JSON.parse(elem.textContent);
+        if (data) this.setData(data);
+        // Render from script tag src
+      } else if (elem.hasAttribute("src")) {
+        const url = elem.getAttribute("src")!;
+        const data = await fetch(url).then((res) => res.json());
+        if (data) this.setData(data);
+      }
+    } else if (this.src.length > 0) {
+      // Render from src attribute
+      const data = await fetch(this.src).then((res) => res.json());
+      if (data) this.setData(data);
+    }
+  }
+
+  private onChangeMode(e: Event) {
+    const mode = (e.target as HTMLSelectElement).value;
+    this.mode = mode;
+    if (!this.data) return;
+    this.setData({ ...this.data! });
+  }
+
+  private onDrop(e: DragEvent) {
+    e.preventDefault();
+    const files = e.dataTransfer?.files;
+    if (files && files.length > 0) {
+      const file = files[0];
+      const reader = new FileReader();
+      reader.onload = () => {
+        const json = JSON.parse(reader.result as string);
+        this.data = json;
+        this.setData(json);
+      };
+      reader.readAsText(file);
+    }
+    return false;
+  }
+
+  attributeChangedCallback(
+    name: string,
+    _old: string | null,
+    value: string | null
+  ): void {
+    if (name === "src" && value) {
+      this.refresh();
+    }
+    if (name === "data" && value) {
+      this.setData(JSON.parse(value));
+    }
+    if (name === "mode" && value) {
+      this.mode = value;
+      if (this.data) {
+        this.setData({ ...this.data! });
+      }
+    }
+    super.attributeChangedCallback(name, _old, value);
+  }
+}
+
+declare global {
+  interface HTMLElementTagNameMap {
+    "lit-force-graph": LitForceGraph;
+  }
+}
@@ -0,0 +1,58 @@
+import ForceGraph from "force-graph";
+import { RenderContext } from "../classes/context";
+
+export function render(context: RenderContext) {
+  const graph = ForceGraph();
+  const style = getComputedStyle(context.element);
+  const lineColor = style.getPropertyValue("--graph-line-color").trim();
+  const bgColor = style.getPropertyValue("--graph-background-color").trim();
+  const fgColor = style.getPropertyValue("--graph-foreground-color").trim();
+  const nodeColor = style.getPropertyValue("--graph-node-color").trim();
+  graph(context.element)
+    .graphData(context.data)
+    .width(Number(style.width.slice(0, -2)))
+    .height(Number(style.height.slice(0, -2)))
+    .cooldownTicks(100)
+    .backgroundColor(bgColor)
+    .linkColor(() => lineColor)
+    .linkWidth(0.2)
+    .nodeCanvasObject((node: any, ctx, globalScale) => {
+      // Draw a circle
+      ctx.beginPath();
+      const size = 5 / globalScale;
+      ctx.arc(node.x, node.y, size, 0, 2 * Math.PI);
+      //   ctx.fillStyle = nodeColor(node, groupColors);
+      ctx.fillStyle = nodeColor;
+      ctx.fill();
+      ctx.lineWidth = 1 / globalScale;
+      ctx.strokeStyle = lineColor;
+      ctx.stroke();
+
+      if (globalScale >= 4) {
+        const label = node.name ?? node.id;
+        const fontSize = 12 / globalScale;
+        ctx.font = `${fontSize}px Sans-Serif`;
+        const textWidth = ctx.measureText(label).width;
+        const bckgDimensions = [textWidth, fontSize].map(
+          (n) => n + fontSize * 0.2
+        ); // some padding
+
+        ctx.textAlign = "center";
+        ctx.textBaseline = "middle";
+        ctx.fillStyle = fgColor;
+        // Measure text
+        ctx.fillText(label, node.x + size * 2 + textWidth / 2, node.y);
+
+        node.__bckgDimensions = bckgDimensions;
+      }
+    })
+    .onNodeHover((node: any, prev: any) => {
+      if (node) {
+        const graphNode = context.data.nodes.find((n) => n.id === node.id);
+        context.onHover(graphNode);
+      }
+      if (prev) {
+        context.onHover(undefined);
+      }
+    });
+}
@@ -0,0 +1,36 @@
+import ForceGraph from "3d-force-graph";
+import { RenderContext } from "../classes/context.js";
+
+export function render(context: RenderContext) {
+  const graph = ForceGraph({
+    controlType: "trackball",
+    rendererConfig: { antialias: true, alpha: true },
+  });
+  const style = getComputedStyle(context.element);
+  const lineColor = style.getPropertyValue("--graph-line-color").trim();
+  const bgColor = style.getPropertyValue("--graph-background-color").trim();
+  const nodeColor = style.getPropertyValue("--graph-node-color").trim();
+  graph(context.element)
+    .graphData(context.data)
+    .width(Number(style.width.slice(0, -2)))
+    .height(Number(style.height.slice(0, -2)))
+    .showNavInfo(false)
+    .linkColor(() => lineColor)
+    .backgroundColor(bgColor)
+    .nodeThreeObject((node: any) => {
+      const color = node.color ?? nodeColor;
+      node.color = color;
+      return false as any;
+    })
+    .nodeThreeObjectExtend(true)
+    .onNodeHover((node: any, prev: any) => {
+      if (node) {
+        const graphNode = context.data.nodes.find((n) => n.id === node.id);
+        context.onHover(graphNode);
+      }
+      if (prev) {
+        context.onHover(undefined);
+      }
+    })
+    .cooldownTicks(100);
+}
@@ -0,0 +1,16 @@
+import "aframe";
+import "@ar-js-org/ar.js";
+import ForceGraph from "3d-force-graph-ar";
+import { RenderContext } from "../classes/context.js";
+
+export function renderAR(context: RenderContext) {
+  const graph = ForceGraph();
+  const style = getComputedStyle(context.element);
+  //   const lineColor = style.getPropertyValue("--graph-line-color").trim();
+  //   const bgColor = style.getPropertyValue("--graph-background-color").trim();
+  graph(context.element)
+    .graphData(context.data)
+    .width(Number(style.width.slice(0, -2)))
+    .height(Number(style.height.slice(0, -2)))
+    .cooldownTicks(100);
+}
@@ -0,0 +1,15 @@
+import ForceGraph from "3d-force-graph-vr";
+import { RenderContext } from "../classes/context.js";
+
+export function renderVR(context: RenderContext) {
+  const graph = ForceGraph();
+  const style = getComputedStyle(context.element);
+  //   const lineColor = style.getPropertyValue("--graph-line-color").trim();
+  //   const bgColor = style.getPropertyValue("--graph-background-color").trim();
+  graph(context.element)
+    .graphData(context.data)
+    .width(Number(style.width.slice(0, -2)))
+    .height(Number(style.height.slice(0, -2)))
+    .showNavInfo(false)
+    .cooldownTicks(100);
+}
@@ -0,0 +1 @@
+/// <reference types="vite/client" />
@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "module": "esnext",
+    "lib": ["es2017", "dom", "dom.iterable"],
+    "declaration": true,
+    "emitDeclarationOnly": true,
+    "outDir": "./types",
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "moduleResolution": "node",
+    "allowSyntheticDefaultImports": true,
+    "experimentalDecorators": true,
+    "forceConsistentCasingInFileNames": true,
+    "useDefineForClassFields": false
+  },
+  "include": ["src/**/*.ts"],
+  "references": [{ "path": "./tsconfig.node.json" }]
+}
@@ -0,0 +1,8 @@
+{
+  "compilerOptions": {
+    "composite": true,
+    "module": "esnext",
+    "moduleResolution": "node"
+  },
+  "include": ["vite.config.ts"]
+}
@@ -0,0 +1,17 @@
+import { defineConfig } from "vite";
+import { resolve } from "path";
+
+export default defineConfig({
+  base: "/lit-force-graph/",
+  build: {
+    lib: {
+      entry: "src/lit-force-graph.ts",
+      formats: ["es"],
+    },
+    rollupOptions: {
+      input: {
+        main: resolve(__dirname, "index.html"),
+      },
+    },
+  },
+});