@cosmos.gl/graph 2.5.0 → 2.6.1

package/dist/modules/Clusters/index.d.ts

@@ -1,5 +1,5 @@
-import { default as regl } from 'regl';
-import { CoreModule } from '../core-module';
+import regl from 'regl';
+import { CoreModule } from '@/graph/modules/core-module';
 export declare class Clusters extends CoreModule {
     centermassFbo: regl.Framebuffer2D | undefined;
     clusterCount: number | undefined;

package/dist/modules/Drag/index.d.ts

@@ -1,9 +1,9 @@
-import { Store } from '../Store';
-import { GraphConfigInterface } from '../../config';
+import { Store } from '@/graph/modules/Store';
+import { GraphConfigInterface } from '@/graph/config';
 export declare class Drag {
     readonly store: Store;
     readonly config: GraphConfigInterface;
     isActive: boolean;
-    behavior: import('d3-drag').DragBehavior<HTMLCanvasElement, undefined, import('d3-drag').SubjectPosition | undefined>;
+    behavior: import("d3-drag").DragBehavior<HTMLCanvasElement, undefined, import("d3-drag").SubjectPosition | undefined>;
     constructor(store: Store, config: GraphConfigInterface);
 }

package/dist/modules/ForceCenter/index.d.ts

@@ -1,4 +1,4 @@
-import { CoreModule } from '../core-module';
+import { CoreModule } from '@/graph/modules/core-module';
 export declare class ForceCenter extends CoreModule {
     private centermassFbo;
     private clearCentermassCommand;

package/dist/modules/ForceGravity/index.d.ts

@@ -1,4 +1,4 @@
-import { CoreModule } from '../core-module';
+import { CoreModule } from '@/graph/modules/core-module';
 export declare class ForceGravity extends CoreModule {
     private runCommand;
     initPrograms(): void;

package/dist/modules/ForceLink/index.d.ts

@@ -1,4 +1,4 @@
-import { CoreModule } from '../core-module';
+import { CoreModule } from '@/graph/modules/core-module';
 export declare enum LinkDirection {
     OUTGOING = "outgoing",
     INCOMING = "incoming"

package/dist/modules/ForceManyBody/index.d.ts

@@ -1,4 +1,4 @@
-import { CoreModule } from '../core-module';
+import { CoreModule } from '@/graph/modules/core-module';
 export declare class ForceManyBody extends CoreModule {
     private randomValuesFbo;
     private levelsFbos;

package/dist/modules/ForceManyBodyQuadtree/index.d.ts

@@ -1,4 +1,4 @@
-import { CoreModule } from '../core-module';
+import { CoreModule } from '@/graph/modules/core-module';
 export declare class ForceManyBodyQuadtree extends CoreModule {
     private randomValuesFbo;
     private levelsTextures;

package/dist/modules/ForceMouse/index.d.ts

@@ -1,4 +1,4 @@
-import { CoreModule } from '../core-module';
+import { CoreModule } from '@/graph/modules/core-module';
 export declare class ForceMouse extends CoreModule {
     private runCommand;
     initPrograms(): void;

package/dist/modules/GraphData/index.d.ts

@@ -1,4 +1,4 @@
-import { GraphConfig } from '../../config';
+import { GraphConfig } from '@/graph/config';
 export declare enum PointShape {
     Circle = 0,
     Square = 1,
@@ -24,6 +24,7 @@ export declare class GraphData {
     inputPointClusters: (number | undefined)[] | undefined;
     inputClusterPositions: (number | undefined)[] | undefined;
     inputClusterStrength: Float32Array | undefined;
+    inputPinnedPoints: number[] | undefined;
     pointPositions: Float32Array | undefined;
     pointColors: Float32Array | undefined;
     pointSizes: Float32Array | undefined;

package/dist/modules/Lines/index.d.ts

@@ -1,5 +1,5 @@
-import { default as regl } from 'regl';
-import { CoreModule } from '../core-module';
+import regl from 'regl';
+import { CoreModule } from '@/graph/modules/core-module';
 export declare class Lines extends CoreModule {
     linkIndexFbo: regl.Framebuffer2D | undefined;
     hoveredLineIndexFbo: regl.Framebuffer2D | undefined;

package/dist/modules/Points/index.d.ts

@@ -1,5 +1,5 @@
-import { default as regl } from 'regl';
-import { CoreModule } from '../core-module';
+import regl from 'regl';
+import { CoreModule } from '@/graph/modules/core-module';
 export declare class Points extends CoreModule {
     currentPositionFbo: regl.Framebuffer2D | undefined;
     previousPositionFbo: regl.Framebuffer2D | undefined;
@@ -39,6 +39,8 @@ export declare class Points extends CoreModule {
     private trackedIndices;
     private selectedTexture;
     private greyoutStatusTexture;
+    private pinnedStatusTexture;
+    private pinnedStatusFbo;
     private sizeTexture;
     private trackedIndicesTexture;
     private polygonPathTexture;
@@ -51,6 +53,7 @@ export declare class Points extends CoreModule {
     initPrograms(): void;
     updateColor(): void;
     updateGreyoutStatus(): void;
+    updatePinnedStatus(): void;
     updateSize(): void;
     updateShape(): void;
     updateImageIndices(): void;

package/dist/modules/Shared/buffer.d.ts

@@ -1,4 +1,4 @@
-import { default as regl } from 'regl';
+import regl from 'regl';
 export declare function createQuadBuffer(reglInstance: regl.Regl): {
     buffer: regl.Buffer;
     size: number;

package/dist/modules/Store/index.d.ts

@@ -1,5 +1,5 @@
 import { mat3 } from 'gl-matrix';
-import { GraphConfigInterface } from '../../config';
+import type { GraphConfigInterface } from '@/graph/config';
 export declare const ALPHA_MIN = 0.001;
 export declare const MAX_POINT_SIZE = 64;
 /**

package/dist/modules/Zoom/index.d.ts

@@ -1,11 +1,11 @@
 import { ZoomTransform } from 'd3-zoom';
-import { Store } from '../Store';
-import { GraphConfigInterface } from '../../config';
+import { Store } from '@/graph/modules/Store';
+import { GraphConfigInterface } from '@/graph/config';
 export declare class Zoom {
     readonly store: Store;
     readonly config: GraphConfigInterface;
     eventTransform: ZoomTransform;
-    behavior: import('d3-zoom').ZoomBehavior<HTMLCanvasElement, undefined>;
+    behavior: import("d3-zoom").ZoomBehavior<HTMLCanvasElement, undefined>;
     isRunning: boolean;
     constructor(store: Store, config: GraphConfigInterface);
     /**

package/dist/modules/core-module.d.ts

@@ -1,8 +1,8 @@
-import { default as regl } from 'regl';
-import { GraphConfigInterface } from '../config';
-import { GraphData } from './GraphData';
-import { Points } from './Points';
-import { Store } from './Store';
+import regl from 'regl';
+import { GraphConfigInterface } from '@/graph/config';
+import { GraphData } from '@/graph/modules/GraphData';
+import { Points } from '@/graph/modules/Points';
+import { Store } from '@/graph/modules/Store';
 export declare class CoreModule {
     readonly reglInstance: regl.Regl;
     readonly config: GraphConfigInterface;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmos.gl/graph",
-  "version": "2.5.0",
+  "version": "2.6.1",
   "description": "GPU-based force graph layout and rendering",
   "jsdelivr": "dist/index.min.js",
   "main": "dist/index.js",
@@ -8,6 +8,10 @@
   "license": "MIT",
   "repository": "git://github.com/cosmos.gl/graph.git",
   "type": "module",
+  "files": [
+    "dist",
+    "CITATION.cff"
+  ],
   "scripts": {
     "build": "rm -rf dist; rollup -c",
     "build:vite": "rm -rf dist; vite build",

package/.eslintrc

@@ -1,147 +0,0 @@
-{
-  "extends": [
-    "plugin:@typescript-eslint/recommended",
-    "standard"
-  ],
-  "env": {
-    "es6": true,
-    "node": true,
-    "browser": true
-  },
-  "plugins": [
-    "import",
-    "unicorn"
-  ],
-  "parser": "@typescript-eslint/parser",
-  "parserOptions": {
-    "project": "./tsconfig.json"
-  },
-  "rules": {
-    "object-curly-spacing": ["error", "always"],
-    "prefer-template": "error",
-    "no-useless-constructor": "off",
-    "import/extensions": 0,
-    "import/no-extraneous-dependencies": 0,
-    "import/no-default-export": "error",
-    "import/prefer-default-export": 0,
-    "import/first": ["error", "absolute-first"],
-    "import/order": ["error", 
-      {
-        "groups": ["builtin", "external", "internal", "parent", "sibling", "index", "object"],
-        "pathGroups": [
-          {
-            "pattern": "@/**",
-            "group": "internal"
-          }
-        ],
-      }
-    ],
-    "comma-dangle": ["error", {
-      "arrays": "always-multiline",
-      "objects": "always-multiline",
-      "imports": "always-multiline",
-      "exports": "always-multiline",
-      "functions": "never"
-    }],
-    "indent": ["error", 2],
-    "consistent-return": "error",
-    "no-console": ["error", { "allow": ["warn", "error"] }],
-    "no-undef": 0,
-    "no-unused-expressions": "off",
-    "no-multiple-empty-lines": 2,
-    "no-use-before-define": "off",
-    "@typescript-eslint/no-use-before-define": ["error", {"variables": false}],
-    "no-unused-vars": "off",
-    "@typescript-eslint/no-unused-vars": ["error"],
-    "@typescript-eslint/no-unused-expressions": ["error"],
-    "@typescript-eslint/no-explicit-any": ["error"],
-    "@typescript-eslint/indent": "off",
-    "@typescript-eslint/type-annotation-spacing": ["error"],
-    "@typescript-eslint/member-delimiter-style": ["error", {
-      "multiline": {
-        "delimiter": "semi",
-        "requireLast": true
-      },
-      "singleline": {
-        "delimiter": "semi",
-        "requireLast": false
-      }
-    }],
-    "@typescript-eslint/member-ordering": "error",
-    "@typescript-eslint/explicit-member-accessibility": "error",
-    "@typescript-eslint/explicit-function-return-type": "error",
-    "@typescript-eslint/naming-convention": [
-      "error",
-      {
-        "selector": "default",
-        "format": ["camelCase"],
-        "leadingUnderscore": "allow",
-        "trailingUnderscore": "allow"
-      },
-      {
-        "selector": "import",
-        "format": ["camelCase", "PascalCase"]
-      },
-      {
-        "selector": "classProperty",
-        "format": ["camelCase", "UPPER_CASE"],
-        "leadingUnderscore": "allow",
-        "trailingUnderscore": "allow"
-      },
-      {
-        "selector": "classProperty",
-        "types": ["boolean"],
-        "format": ["PascalCase"],
-        "prefix": ["is", "should", "has", "can", "did", "will", "are"],
-        "leadingUnderscore": "allow",
-        "trailingUnderscore": "allow"
-      },
-      {
-        "selector": "function",
-        "format": ["camelCase", "PascalCase"],
-        "modifiers": ["exported"],
-        "leadingUnderscore": "allow",
-        "trailingUnderscore": "allow"
-      },
-      {
-        "selector": "variable",
-        "format": ["camelCase", "UPPER_CASE"],
-        "leadingUnderscore": "allow",
-        "trailingUnderscore": "allow"
-      },
-      {
-        "selector": "variable",
-        "modifiers": ["exported"],
-        "format": ["camelCase", "UPPER_CASE", "PascalCase"]
-      },
-      {
-        "selector": "typeLike",
-        "format": ["PascalCase"]
-      },
-      {
-        "selector": "enumMember",
-        "format": ["PascalCase"]
-      },
-      {
-        "selector": "property",
-        "leadingUnderscore": "allowSingleOrDouble",
-        "format": ["camelCase", "snake_case", "UPPER_CASE"]
-      }
-    ],
-    "max-len": ["warn", { "code": 160, "comments": 160 }],
-    "unicorn/filename-case": "error",
-    "unicorn/no-for-loop": "error",
-    "unicorn/prefer-array-some": "error",
-    "unicorn/no-instanceof-array": "error",
-    "unicorn/prefer-includes": "error",
-    "unicorn/prefer-keyboard-event-key": "error"
-  },
-  "overrides": [
-    {
-      "files": ["src/stories/**/*.ts"],
-      "rules": {
-        "no-console": "off"
-      }
-    }
-  ]
-}

package/.github/SECURITY.md

@@ -1,13 +0,0 @@
-# Security Policy
-
-## Supported Versions
-
-Security updates are applied only to the latest release.
-
-## Reporting a Vulnerability
-
-If you have discovered a security vulnerability in this project, please report it privately. **Do not disclose it as a public issue.** This gives us time to work with you to fix the issue before public exposure, reducing the chance that the exploit will be used before a patch is released.
-
-Please disclose it at [security advisory](https://github.com/cosmograph-org/cosmos/security/advisories/new).
-
-This project is maintained by a team of volunteers on a reasonable-effort basis. As such, please give us at least 90 days to work on a fix before public exposure.

package/.github/dco.yml

@@ -1,4 +0,0 @@
-allowRemediationCommits:
-  individual: true
-require:
-  members: false

package/.github/workflows/github_pages.yml

@@ -1,54 +0,0 @@
-name: Deploy to GitHub Pages
-
-on:
-  push:
-    branches:
-      - main
-
-# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
-permissions:
-  contents: read
-  pages: write
-  id-token: write
-
-# Allow one concurrent deployment
-concurrency:
-  group: "pages"
-  cancel-in-progress: false
-
-jobs:
-  # Build job
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-      - name: Setup Pages
-        uses: actions/configure-pages@v5
-      - name: Cache dependencies
-        uses: actions/cache@v4
-        with:
-          path: ~/.npm
-          key: npm-${{ hashFiles('package-lock.json') }}
-          restore-keys: npm-
-      - name: Build
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20.x'
-      - run: npm install -g npm@10
-      - run: npm ci
-      - run: npm run build:storybook -- -o _site
-      - name: Upload artifact
-        uses: actions/upload-pages-artifact@v3
-
-  # Deployment job
-  deploy:
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    runs-on: ubuntu-latest
-    needs: build
-    steps:
-      - name: Deploy to GitHub Pages
-        id: deployment
-        uses: actions/deploy-pages@v4

package/.storybook/main.ts

@@ -1,26 +0,0 @@
-import type { StorybookConfig } from "@storybook/html-vite";
-import remarkGfm from 'remark-gfm';
-
-const config: StorybookConfig = {
-  stories: ["../src/**/*.mdx", "../src/**/*.stories.@(js|jsx|mjs|ts|tsx)"],
-  addons: [
-    "@jls-digital/storybook-addon-code",
-    "@storybook/addon-essentials",
-    "@storybook/addon-interactions",
-    {
-      name: '@storybook/addon-docs',
-      options: {
-        mdxPluginOptions: {
-          mdxCompileOptions: {
-            remarkPlugins: [remarkGfm],
-          },
-        },
-      },
-    },
-  ],
-  framework: {
-    name: "@storybook/html-vite",
-    options: {},
-  },
-};
-export default config;

package/.storybook/manager-head.html

@@ -1 +0,0 @@
-<link rel="icon" type="image/png" href="https://cosmograph.app/img/favicon.png" />

package/.storybook/manager.ts

@@ -1,14 +0,0 @@
-import { addons } from '@storybook/manager-api';
-import { create } from '@storybook/theming';
- 
-const theme = create({
-  base: 'dark',
-  brandTitle: 'cosmos.gl',
-  brandUrl: 'https://cosmosgl.github.io/graph',
-  brandImage: 'https://d.cosmograph.app/cosmos-dark-theme.svg',
-  brandTarget: '_self',
-});
-
-addons.setConfig({
-  theme,
-});

package/.storybook/preview.ts

@@ -1,29 +0,0 @@
-import type { Preview } from "@storybook/html";
-import { themes } from '@storybook/theming';
-
-import './style.css';
-
-const preview: Preview = {
-  parameters: {
-    layout: 'fullscreen',
-    controls: {
-      disable: true,
-      matchers: {
-        color: /(background|color)$/i,
-        date: /Date$/i,
-      },
-    },
-    docs: {
-      theme: themes.dark,
-    },
-    backgrounds: {
-      default: 'dark',
-      values: [
-        { name: 'light', value: '#fff' },
-        { name: 'dark', value: '#192132' },
-      ],
-    },
-  },
-};
-
-export default preview;

package/.storybook/style.css

@@ -1,3 +0,0 @@
-tr:nth-of-type(2n) {
-  background-color: #1e2326;
-}

package/CHARTER.md

@@ -1,69 +0,0 @@
-# cosmos.gl Charter
-
-## **Section 0: Guiding Principles**
-
-**Mission:** Provide the web development community with a high-performance framework for visualizing network graphs and scatter plots.
-
-**Vision:** Deliver fast, robust, open-source data visualization tools that empower interactive, scalable analysis in the browser.
-
-**Values:**
-
-- **Performance First:** Prioritize speed and efficiency in every feature and implementation.  
-- **Accessibility:** Ensure the API is intuitive and the tooling easy to adopt, lowering barriers for developers.  
-- **Community:** Foster open collaboration, welcoming contributions and feedback.  
-- **Transparency:** Maintain clear documentation, benchmarks, and decision-making processes.
-
-## **Section 1: Scope**
-
-cosmos.gl is a browser-native, GPU-accelerated force-directed graph layout and rendering engine designed to visualize and interact with massive, complex datasets at scale. By leveraging WebGL, it delivers fast simulations and real-time rendering of millions of nodes and edges directly in the browser. cosmos.gl bridges the gap between high-performance data visualization and interactive web-based research workflows, serving developers, researchers, and analysts. Its value lies in unlocking scalable, explainable graph exploration for AI, biotech, finance, and data science stakeholders.
-
-### **1.1: In-scope**
-
-- GPU-accelerated graph algorithms  
-- WebGL- and WebGPU-based rendering of large-scale network graph and machine learning embeddings  
-- Browser-native integration with frontend tooling and workflows
-
-### **1.2: Out-of-Scope**
-
-- Server-side computation, backend data processing and pipelines
-- Native desktop or mobile applications (outside browser environment)
-- Direct integration with domain-specific tools
-
-## **Section 2: Relationship with OpenJS Foundation CPC**
-
-Technical leadership of the cosmos.gl project is delegated to the cosmos.gl Technical Steering Committee (TSC) by the OpenJS Cross Project Council (CPC). Amendments to this charter require approval from both the CPC, through its [decision-making process](https://github.com/openjs-foundation/cross-project-council/blob/master/CPC-CHARTER.md#section-9-decision-making), and the TSC.
-
-## **Section 3: Technical Steering Committee (TSC)**
-
-TSC members may attend meetings, participate in discussions, and vote on all matters before the TSC.
-
-TSC memberships are not time-limited. There is no maximum size of the TSC. 
-
-There is no specific set of requirements or qualifications for TSC membership beyond these rules. A TSC member can be removed from the TSC by voluntary resignation or by a standard TSC motion.
-
-The TSC shall meet regularly using tools that enable participation by the community. The meeting shall be directed by the TSC chairperson. Responsibility for directing individual meetings may be delegated by the TSC chairperson to any other TSC member. Minutes or an appropriate recording shall be taken and made available to the community through accessible public postings.
-
-TSC members are expected to regularly participate in TSC activities.
-
-The TSC chairperson is elected by a simple majority vote of all TSC members. The chairperson serves until they resign or are replaced by a TSC vote. Any TSC member may call for a vote at any time, provided the proposal is made in writing and shared with the full TSC. Votes may be held in meetings or asynchronously using any communication tool commonly used by the TSC.
-
-## **Section 4: Roles & Responsibilities**
-The roles and responsibilities of cosmos.gl's TSC are described in [GOVERNANCE.md](./GOVERNANCE.md).
-
-### **Section 4.1 Project Operations & Management**
-The Project Operations & Management processes are defined in [GOVERNANCE.md](./GOVERNANCE.md).
-
-### **Section 4.2: Decision-making, Voting, and/or Elections**
-
-Project decisions shall operate under a model of Lazy Consensus by default. The TSC shall define appropriate guidelines for implementing Lazy Consensus (e.g., notification periods, review windows) within the development process.
-
-When consensus cannot be reached, the TSC shall decide via public voting.
-
-Each vote presents the available options in a format that supports clear expression of member preferences—this may include polls, emoji reactions, checklists, or comparable methods. TSC members may vote for one or more options or abstain. Unless otherwise specified, the winning option is the one that receives the greatest support among participating members.
-
-For decisions involving three or more options, the TSC may optionally conduct pairwise comparisons between all candidates. In such cases, the winner is the candidate who secures a simple majority against every other candidate in head-to-head matchups (Condorcet winner). All votes are public, and voting activity may be adjusted until the close of the voting period.
-
-## **Section 5: Definitions**
-### **Agenda Item**
-
-An agenda item is a specific topic, proposal, or issue scheduled for discussion or decision during a TSC meeting. Examples include proposed technical changes, governance matters, or any subject requiring TSC review or input. Agenda items are published in advance to allow TSC members and the community to prepare for discussion or decision-making.