npm - chrono-phylo-tree - Versions diffs - 1.0.16 → 1.1.1 - Mend

chrono-phylo-tree 1.0.16 → 1.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (66) hide show

package/eslint.config.js +28 -0
package/global.d.ts +26 -0
package/index.html +13 -0
package/package.json +2 -7
package/src/App.css +131 -0
package/src/App.tsx +149 -0
package/src/assets/react.svg +1 -0
package/src/classes/Species.tsx +267 -0
package/src/components/HoverDescription.tsx +27 -0
package/src/components/LanguageSelector.tsx +29 -0
package/src/components/Menu.tsx +348 -0
package/src/components/NavBar.tsx +234 -0
package/src/components/PhTree.tsx +362 -0
package/src/index.css +68 -0
package/src/index.ts +4 -0
package/src/main.tsx +10 -0
package/src/types.d.ts +9 -0
package/src/utils/between.tsx +3 -0
package/src/utils/example.tsx +73 -0
package/src/utils/hexToRGBA.tsx +12 -0
package/src/utils/scientificNotation.tsx +20 -0
package/src/utils/setFromJson.tsx +40 -0
package/src/utils/translate.tsx +68 -0
package/src/utils/updateSpecies.tsx +129 -0
package/src/vite-env.d.ts +1 -0
package/tsconfig.app.json +26 -0
package/tsconfig.json +17 -0
package/tsconfig.node.json +24 -0
package/vite.config.ts +34 -0
package/dist/App.d.ts +0 -3
package/dist/App.d.ts.map +0 -1
package/dist/chrono-phylo-tree.js +0 -1111
package/dist/chrono-phylo-tree.umd.cjs +0 -15
package/dist/classes/Species.d.ts +0 -35
package/dist/classes/Species.d.ts.map +0 -1
package/dist/components/HoverDescription.d.ts +0 -15
package/dist/components/HoverDescription.d.ts.map +0 -1
package/dist/components/LanguageSelector.d.ts +0 -9
package/dist/components/LanguageSelector.d.ts.map +0 -1
package/dist/components/Menu.d.ts +0 -15
package/dist/components/Menu.d.ts.map +0 -1
package/dist/components/NavBar.d.ts +0 -33
package/dist/components/NavBar.d.ts.map +0 -1
package/dist/components/PhTree.d.ts +0 -31
package/dist/components/PhTree.d.ts.map +0 -1
package/dist/index.d.ts +0 -5
package/dist/index.d.ts.map +0 -1
package/dist/main.d.ts +0 -1
package/dist/main.d.ts.map +0 -1
package/dist/utils/between.d.ts +0 -2
package/dist/utils/between.d.ts.map +0 -1
package/dist/utils/example.d.ts +0 -3
package/dist/utils/example.d.ts.map +0 -1
package/dist/utils/hexToRGBA.d.ts +0 -2
package/dist/utils/hexToRGBA.d.ts.map +0 -1
package/dist/utils/scientificNotation.d.ts +0 -2
package/dist/utils/scientificNotation.d.ts.map +0 -1
package/dist/utils/setFromJson.d.ts +0 -3
package/dist/utils/setFromJson.d.ts.map +0 -1
package/dist/utils/translate.d.ts +0 -4
package/dist/utils/translate.d.ts.map +0 -1
package/dist/utils/updateSpecies.d.ts +0 -7
package/dist/utils/updateSpecies.d.ts.map +0 -1
/package/{dist → public}/logo.png +0 -0
/package/{dist → public}/translate.csv +0 -0
/package/{dist → public}/vite.svg +0 -0

package/eslint.config.js ADDED Viewed

@@ -0,0 +1,28 @@
+import js from '@eslint/js'
+import globals from 'globals'
+import reactHooks from 'eslint-plugin-react-hooks'
+import reactRefresh from 'eslint-plugin-react-refresh'
+import tseslint from 'typescript-eslint'
+export default tseslint.config(
+  { ignores: ['dist'] },
+  {
+    extends: [js.configs.recommended, ...tseslint.configs.recommended],
+    files: ['**/*.{ts,tsx}'],
+    languageOptions: {
+      ecmaVersion: 2020,
+      globals: globals.browser,
+    },
+    plugins: {
+      'react-hooks': reactHooks,
+      'react-refresh': reactRefresh,
+    },
+    rules: {
+      ...reactHooks.configs.recommended.rules,
+      'react-refresh/only-export-components': [
+        'warn',
+        { allowConstantExport: true },
+      ],
+    },
+  },
+)

package/global.d.ts ADDED Viewed

@@ -0,0 +1,26 @@
+interface SaveFilePickerOptions {
+    suggestedName?: string;
+    types?: Array<{
+        description: string;
+        accept: { [mimeType: string]: string[] };
+    }>;
+}
+interface FileSystemCreateWritableOptions {
+    keepExistingData?: boolean;
+}
+interface FileSystemFileHandle {
+    createWritable: (options?: FileSystemCreateWritableOptions) => Promise<FileSystemWritableFileStream>;
+}
+interface FileSystemWritableFileStream extends WritableStream {
+    seek(position: number): Promise<void>;
+    truncate(size: number): Promise<void>;
+    write(data: FileSystemWriteChunkType): Promise<void>;
+    close: () => Promise<void>;
+}
+interface Window {
+    showSaveFilePicker?: (options?: SaveFilePickerOptions) => Promise<FileSystemFileHandle>;
+}

package/index.html ADDED Viewed

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/logo.png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title id="title">Árbol Cronofilogenético</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/package.json CHANGED Viewed

@@ -1,14 +1,9 @@
 {
   "name": "chrono-phylo-tree",
-  "version": "1.0.16",
+  "version": "1.1.1",
   "description": "A React-based phylogenetic tree visualization library",
   "type": "module",
-  "main": "dist/index.d.ts",
-  "module": "dist/index.d.ts",
-  "types": "dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
+  "main": "src/index.ts",
   "scripts": {
     "dev": "vite",
     "build": "tsc -b && vite build",

package/src/App.css ADDED Viewed

@@ -0,0 +1,131 @@
+@import "tailwindcss";
+@tailwindcss base;
+@tailwindcss component;
+@tailwindcss utilities;
+#root {
+  max-width: 1280px;
+  margin: 0 auto;
+  padding: 2rem;
+  text-align: center;
+}
+.logo {
+  height: 6em;
+  padding: 1.5em;
+  will-change: filter;
+  transition: filter 300ms;
+}
+.logo:hover {
+  filter: drop-shadow(0 0 2em #646cffaa);
+}
+.logo.react:hover {
+  filter: drop-shadow(0 0 2em #61dafbaa);
+}
+@keyframes logo-spin {
+  from {
+    transform: rotate(0deg);
+  }
+  to {
+    transform: rotate(360deg);
+  }
+}
+@media (prefers-reduced-motion: no-preference) {
+  a:nth-of-type(2) .logo {
+    animation: logo-spin infinite 20s linear;
+  }
+}
+.card {
+  padding: 2em;
+}
+.read-the-docs {
+  color: #888;
+}
+input:not([type="file"]) {
+  text-rendering: auto;
+  color: fieldtext;
+  letter-spacing: normal;
+  word-spacing: normal;
+  line-height: normal;
+  text-transform: none;
+  text-indent: 0px;
+  text-shadow: none;
+  display: inline-block;
+  text-align: start;
+  appearance: auto;
+  -webkit-rtl-ordering: logical;
+  cursor: text;
+  background-color: field;
+  margin: 0em;
+  padding: 1px 0px;
+  border-width: 2px;
+  border-style: inset;
+  border-color: light-dark(rgb(118, 118, 118), rgb(133, 133, 133));
+  border-image: initial;
+  padding-block: 1px;
+  padding-inline: 2px;
+}
+input:not([type="image" i], [type="range" i], [type="checkbox" i], [type="radio" i]) {
+  overflow-clip-margin: 0px !important;
+  overflow: clip !important;
+}
+input[type="text" i],
+input[type="number" i] {
+  margin-left: 4px;
+  margin-right: 4px;
+  padding-block: 1px;
+  padding-inline: 2px;
+  background-color: field;
+}
+input[type="range" i] {
+  appearance: auto;
+  cursor: default;
+  color: light-dark(rgb(16, 16, 16), rgb(255, 255, 255));
+  padding: initial;
+  border: initial;
+  margin: 2px;
+}
+input[type="file"]::file-selector-button{
+  background-color: #6b6b6b;
+  padding-left: 4px;
+  padding-right: 4px;
+  border-radius: 0.25rem;
+}
+textarea {
+  font-family: monospace;
+  text-rendering: auto;
+  color: fieldtext;
+  letter-spacing: normal;
+  word-spacing: normal;
+  line-height: normal;
+  text-transform: none;
+  text-indent: 0px;
+  text-shadow: none;
+  display: inline-block;
+  text-align: start;
+  appearance: auto;
+  -webkit-rtl-ordering: logical;
+  resize: -internal-textarea-auto;
+  cursor: text;
+  overflow-wrap: break-word;
+  background-color: field;
+  column-count: initial !important;
+  margin: 0em;
+  border-width: 1px;
+  border-style: solid;
+  border-color: light-dark(rgb(118, 118, 118), rgb(133, 133, 133));
+  border-image: initial;
+  padding: 2px;
+  white-space: pre-wrap;
+}

package/src/App.tsx ADDED Viewed

@@ -0,0 +1,149 @@
+import { useEffect, useState } from 'react'
+import './App.css'
+import { PhTree } from './components/PhTree'
+import { Species } from './classes/Species'
+import { between } from './utils/between';
+import { codeTextAlt, getLanguageOptions } from './utils/translate';
+import { Menu } from './components/Menu';
+import { NavBar } from './components/NavBar';
+import { scientificNotation } from './utils/scientificNotation';
+import { hexToRGBA } from './utils/hexToRGBA';
+import { example } from './utils/example';
+import { createAncestor, createDescendant, deleteAncestor, deleteSpecies, saveSpecies } from './utils/updateSpecies';
+import { setFromJson } from './utils/setFromJson';
+import { HoverDescription } from './components/HoverDescription';
+function App() {
+  const [scale, setScale] = useState(1);
+  const [species, setSpecies] = useState<Species | undefined>(undefined);
+  const [speciesList, setSpeciesList] = useState<Species[]>([]);
+  const [lineColor, setLineColor] = useState("#7F7F7F");
+  const [presentTime, setPresentTime] = useState<number>(1);
+  const [presentTimeBoolean, setPresentTimeBoolean] = useState(true);
+  const [chronoScale, setChronoScale] = useState(true);
+  const [language, setLanguage] = useState("spanish");
+  const [hoverPosition, setHoverPosition] = useState({x: 0, y: 0});
+  const [showHover, setShowHover] = useState(false);
+  const [showImages, setShowImages] = useState(true);
+  const languages = getLanguageOptions();
+  const minScale = 1e-12;
+  const offset = {x: 0, y: -50}
+  useEffect(() => {
+    const title = document.getElementById("title");
+    if(title) {
+      codeTextAlt("ttl", language).then((ttl) => title.textContent = ttl);
+    }
+  }, [language]);
+  const showScaleNumber = false;
+  const showExample = () => {
+    setSpecies(() =>{
+      if(presentTimeBoolean){
+        setPresentTime(example.absoluteExtinction());
+      }
+      setScale(example.absoluteDuration());
+      return example;
+    });
+  };
+  const changePresentTime = (n: number) => {
+    setPresentTime(n);
+    setScale(between(scale, 1, maxScale(n)));
+  };
+  const maxScale = (n: number) => species ? Math.min(species.absoluteDuration(), presentTimeBoolean ? n - species.apparition : species.absoluteDuration()) : 1
+  const createEmptySpecies = async () => {
+    setSpecies(new Species(await codeTextAlt("nvbtn01", language), 0, 1));
+    setScale(1);
+    setPresentTime(1);
+  };
+  const deleteAllSpecies = async () => {
+    if(!species) return;
+    if(!confirm(await codeTextAlt("cnfrm01" + (species.descendants.length > 0 ? "_0" : ""), language, [species.name]))) return;
+    setSpecies(undefined);
+  };
+  const handleMouseMove = (x: number, y: number) => {
+    setHoverPosition({
+      x: x,
+      y: y,
+    });
+  };
+  //document.addEventListener("mousemove", handleMouseMove);
+  return (
+    <>
+      <NavBar
+        species={species}
+        color={hexToRGBA(lineColor, 0.5)}
+        lineColor={lineColor}
+        setLineColor={setLineColor}
+        language={language}
+        languages={languages}
+        setLanguage={setLanguage}
+        minScale={minScale}
+        maxScale={maxScale(presentTime)}
+        scale={scale}
+        setScale={setScale}
+        chronoScale={chronoScale}
+        setChronoScale={setChronoScale}
+        showScaleNumber={showScaleNumber}
+        showHover={showHover}
+        setShowHover={setShowHover}
+        showImages={showImages}
+        setShowImages={setShowImages}
+        presentTime={presentTime}
+        setPresentTime={setPresentTime}
+        setFromJson={setFromJson(setSpecies, setScale, setPresentTime, presentTimeBoolean)}
+        presentTimeBoolean={presentTimeBoolean}
+        setPresentTimeBoolean={setPresentTimeBoolean}
+        changePresentTime={changePresentTime}
+        deleteAllSpecies={deleteAllSpecies}
+        createEmptySpecies={createEmptySpecies}
+        showExample={showExample}
+      />
+      {species && <div className="h-155 sm:h-65"/>}
+      {species && <PhTree
+        commonAncestor={species}
+        width={window.screen.width * (species?.absoluteDuration() ?? 0) / scale - 64}
+        height={50}
+        stroke={lineColor}
+        format={scientificNotation}
+        chronoScale={chronoScale}
+        showImages={showImages}
+        presentTime={presentTimeBoolean ? presentTime : undefined}
+        padding={1}
+        handleMouseMove={handleMouseMove}
+      >
+        {(sp, showMenu, toggleShowMenu, hoverSpecies) => species &&
+          <>
+            {showMenu && sp && <Menu
+              species={sp}
+              language={language}
+              open={showMenu}
+              onClose={() => toggleShowMenu(sp)}
+              saveSpecies={saveSpecies(setSpecies, language)}
+              createDescendant={createDescendant(setSpecies, language, presentTimeBoolean, setPresentTime, setScale)}
+              createAncestor={createAncestor(setSpecies, language, presentTimeBoolean, setPresentTime, setScale)}
+              deleteAncestor={deleteAncestor(sp, setSpecies, setScale, language)}
+              deleteSpecies={deleteSpecies(sp, setSpecies, language)}
+            />}
+            {showHover && hoverSpecies && hoverSpecies.description &&
+              <HoverDescription
+                hoverPosition={hoverPosition}
+                hoverSpecies={hoverSpecies}
+                offset={offset}
+              />
+            }
+          </>
+        }
+      </PhTree>}
+    </>
+  )
+}
+export default App

package/src/assets/react.svg ADDED Viewed

@@ -0,0 +1 @@

+ <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="35.93" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 228"><path fill="#00D8FF" d="M210.483 73.824a171.49 171.49 0 0 0-8.24-2.597c.465-1.9.893-3.777 1.273-5.621c6.238-30.281 2.16-54.676-11.769-62.708c-13.355-7.7-35.196.329-57.254 19.526a171.23 171.23 0 0 0-6.375 5.848a155.866 155.866 0 0 0-4.241-3.917C100.759 3.829 77.587-4.822 63.673 3.233C50.33 10.957 46.379 33.89 51.995 62.588a170.974 170.974 0 0 0 1.892 8.48c-3.28.932-6.445 1.924-9.474 2.98C17.309 83.498 0 98.307 0 113.668c0 15.865 18.582 31.778 46.812 41.427a145.52 145.52 0 0 0 6.921 2.165a167.467 167.467 0 0 0-2.01 9.138c-5.354 28.2-1.173 50.591 12.134 58.266c13.744 7.926 36.812-.22 59.273-19.855a145.567 145.567 0 0 0 5.342-4.923a168.064 168.064 0 0 0 6.92 6.314c21.758 18.722 43.246 26.282 56.54 18.586c13.731-7.949 18.194-32.003 12.4-61.268a145.016 145.016 0 0 0-1.535-6.842c1.62-.48 3.21-.974 4.76-1.488c29.348-9.723 48.443-25.443 48.443-41.52c0-15.417-17.868-30.326-45.517-39.844Zm-6.365 70.984c-1.4.463-2.836.91-4.3 1.345c-3.24-10.257-7.612-21.163-12.963-32.432c5.106-11 9.31-21.767 12.459-31.957c2.619.758 5.16 1.557 7.61 2.4c23.69 8.156 38.14 20.213 38.14 29.504c0 9.896-15.606 22.743-40.946 31.14Zm-10.514 20.834c2.562 12.94 2.927 24.64 1.23 33.787c-1.524 8.219-4.59 13.698-8.382 15.893c-8.067 4.67-25.32-1.4-43.927-17.412a156.726 156.726 0 0 1-6.437-5.87c7.214-7.889 14.423-17.06 21.459-27.246c12.376-1.098 24.068-2.894 34.671-5.345a134.17 134.17 0 0 1 1.386 6.193ZM87.276 214.515c-7.882 2.783-14.16 2.863-17.955.675c-8.075-4.657-11.432-22.636-6.853-46.752a156.923 156.923 0 0 1 1.869-8.499c10.486 2.32 22.093 3.988 34.498 4.994c7.084 9.967 14.501 19.128 21.976 27.15a134.668 134.668 0 0 1-4.877 4.492c-9.933 8.682-19.886 14.842-28.658 17.94ZM50.35 144.747c-12.483-4.267-22.792-9.812-29.858-15.863c-6.35-5.437-9.555-10.836-9.555-15.216c0-9.322 13.897-21.212 37.076-29.293c2.813-.98 5.757-1.905 8.812-2.773c3.204 10.42 7.406 21.315 12.477 32.332c-5.137 11.18-9.399 22.249-12.634 32.792a134.718 134.718 0 0 1-6.318-1.979Zm12.378-84.26c-4.811-24.587-1.616-43.134 6.425-47.789c8.564-4.958 27.502 2.111 47.463 19.835a144.318 144.318 0 0 1 3.841 3.545c-7.438 7.987-14.787 17.08-21.808 26.988c-12.04 1.116-23.565 2.908-34.161 5.309a160.342 160.342 0 0 1-1.76-7.887Zm110.427 27.268a347.8 347.8 0 0 0-7.785-12.803c8.168 1.033 15.994 2.404 23.343 4.08c-2.206 7.072-4.956 14.465-8.193 22.045a381.151 381.151 0 0 0-7.365-13.322Zm-45.032-43.861c5.044 5.465 10.096 11.566 15.065 18.186a322.04 322.04 0 0 0-30.257-.006c4.974-6.559 10.069-12.652 15.192-18.18ZM82.802 87.83a323.167 323.167 0 0 0-7.227 13.238c-3.184-7.553-5.909-14.98-8.134-22.152c7.304-1.634 15.093-2.97 23.209-3.984a321.524 321.524 0 0 0-7.848 12.897Zm8.081 65.352c-8.385-.936-16.291-2.203-23.593-3.793c2.26-7.3 5.045-14.885 8.298-22.6a321.187 321.187 0 0 0 7.257 13.246c2.594 4.48 5.28 8.868 8.038 13.147Zm37.542 31.03c-5.184-5.592-10.354-11.779-15.403-18.433c4.902.192 9.899.29 14.978.29c5.218 0 10.376-.117 15.453-.343c-4.985 6.774-10.018 12.97-15.028 18.486Zm52.198-57.817c3.422 7.8 6.306 15.345 8.596 22.52c-7.422 1.694-15.436 3.058-23.88 4.071a382.417 382.417 0 0 0 7.859-13.026a347.403 347.403 0 0 0 7.425-13.565Zm-16.898 8.101a358.557 358.557 0 0 1-12.281 19.815a329.4 329.4 0 0 1-23.444.823c-7.967 0-15.716-.248-23.178-.732a310.202 310.202 0 0 1-12.513-19.846h.001a307.41 307.41 0 0 1-10.923-20.627a310.278 310.278 0 0 1 10.89-20.637l-.001.001a307.318 307.318 0 0 1 12.413-19.761c7.613-.576 15.42-.876 23.31-.876H128c7.926 0 15.743.303 23.354.883a329.357 329.357 0 0 1 12.335 19.695a358.489 358.489 0 0 1 11.036 20.54a329.472 329.472 0 0 1-11 20.722Zm22.56-122.124c8.572 4.944 11.906 24.881 6.52 51.026c-.344 1.668-.73 3.367-1.15 5.09c-10.622-2.452-22.155-4.275-34.23-5.408c-7.034-10.017-14.323-19.124-21.64-27.008a160.789 160.789 0 0 1 5.888-5.4c18.9-16.447 36.564-22.941 44.612-18.3ZM128 90.808c12.625 0 22.86 10.235 22.86 22.86s-10.235 22.86-22.86 22.86s-22.86-10.235-22.86-22.86s10.235-22.86 22.86-22.86Z"></path></svg>

package/src/classes/Species.tsx ADDED Viewed

@@ -0,0 +1,267 @@
+import { sortArray } from "multiple-sorting-array";
+import { SpeciesJSON } from "../types";
+export class Species {
+  name = "";
+  apparition = 0;
+  duration = 0;
+  ancestor?: Species = undefined;
+  descendants: Species[] = [];
+  description?: string = undefined;
+  display = true;
+  image?: string = undefined;
+  private onPosition(ret = true) {
+    if(!ret) return ret;
+    return this.firstAncestor().stepsUntil(this)! % 2 === 0;
+  }
+  constructor(
+    name = '',
+    apparition = 0,
+    duration = 0,
+    ancestor: Species | undefined = undefined,
+    descendants: Species[] = [],
+    description: string | undefined = undefined,
+    image: string | undefined = undefined,
+  ) {
+    if(duration <= 0){
+      throw new Error("The duration of the species must be greater than 0");
+    }
+    this.name = name;
+    this.apparition = apparition;
+    this.duration = duration;
+    this.ancestor = ancestor;
+    this.descendants = descendants;
+    this.description = description === "" ? undefined : description;
+    this.image = image === "" ? undefined : image;
+  }
+  copy() : Species {
+    const fa = this.firstAncestor();
+    const n = fa.allDescendants(false).indexOf(this)
+    const sp = Species.fromJSON(fa.toJSON());
+    return sp.allDescendants(false)[n];
+  }
+  unlinkAncestor(): [Species, Species] | undefined {
+    if(!this.ancestor) {
+      return;
+    }
+    this.ancestor.descendants = this.ancestor.descendants.filter((d) => d !== this);
+    const exAncestor = this.ancestor;
+    this.ancestor = undefined;
+    return [exAncestor.firstAncestor(), this];
+  }
+  unlinkDescendant(descendant: Species): [Species, Species] | undefined {
+    if(!this.descendants.includes(descendant)) {
+      return;
+    }
+    this.descendants = this.descendants.filter((d) => d !== descendant);
+    descendant.ancestor = undefined;
+    return [this.firstAncestor(), descendant];
+  }
+  linkAncestor(ancestor: Species) {
+    if(this.ancestor === ancestor && ancestor.descendants.includes(this)) {
+      return;
+    }
+    if(ancestor.apparition > this.apparition) {
+      throw new Error(`The ancestor's apparition (${ancestor.apparition}) must be before or equal the descendant's apparition (${this.apparition})`);
+    }
+    if(ancestor.extinction() < this.apparition) {
+      throw new Error(`The ancestor's extinction (${ancestor.extinction()}) must be after or equal the descendant's apparition (${this.apparition})`);
+    }
+    if(this.ancestor !== ancestor) {
+      this.unlinkAncestor();
+    }
+    this.ancestor = ancestor;
+    ancestor.descendants.push(this);
+  }
+  linkDescendant(descendant: Species) {
+    if(descendant.ancestor === this && this.descendants.includes(descendant)) {
+      return;
+    }
+    if(descendant.apparition < this.apparition) {
+      throw new Error(`The descendant's apparition (${descendant.apparition}) must be after or equal the ancestor's apparition (${this.apparition})`);
+    }
+    if(descendant.extinction() > this.extinction()) {
+      throw new Error(`The descendant's extinction (${descendant.extinction()}) must be before or equal the ancestor's extinction (${this.extinction()})`);
+    }
+    if(this.descendants.includes(descendant)) {
+      return;
+    }
+    if(descendant.ancestor) {
+      descendant.unlinkAncestor();
+    }
+    this.descendants.push(descendant);
+    descendant.ancestor = this;
+  }
+  linkDescendants(descendants: Species[]) {
+    for(const desc of descendants) {
+      try {
+        this.linkDescendant(desc);
+      } catch (error) {
+        console.error(`Error linking descendant ${desc.name} to ancestor ${this.name}:`, error);
+      }
+    }
+  }
+  addDescendant(
+    name = '',
+    afterApparition = 0,
+    duration = 0,
+    description: string | undefined = undefined,
+    image: string | undefined = undefined,
+    copy = false
+  ) {
+    if(afterApparition < 0 || afterApparition > this.duration) {
+      throw new Error(`The apparition of the descendant must be between the apparition (${this.apparition}) and the extinction (${this.extinction()}) of the ancestor`);
+    }
+    const sp = copy ? this.copy() : this;
+    const desc = new Species(
+      name,
+      sp.apparition + Math.max(afterApparition, 0),
+      Math.max(duration, 0),
+      undefined,
+      [],
+      description,
+      image
+    );
+    desc.linkAncestor(sp);
+    return copy ? sp : desc;
+  }
+  removeDescendant(desc: Species) {
+    this.descendants = this.descendants.filter((d) => d !== desc);
+  }
+  addAncestor(
+    name = '',
+    previousApparition = 0,
+    duration = 0,
+    description: string | undefined = undefined,
+    image: string | undefined = undefined,
+    display = true,
+    copy = false
+  ) {
+    if(previousApparition < 0) {
+      throw new Error(`The apparition of the ancestor must be before or equal the apparition (${this.apparition}) of the descendant`);
+    }
+    if(duration < previousApparition){
+      throw new Error(`The extiction of the ancestor must be after or equal the apparition (${this.apparition}) of the descendant`);
+    }
+    const sp = copy ? this.copy() : this;
+    const anc = new Species(
+      name,
+      sp.apparition - Math.max(previousApparition, 0),
+      duration,
+      undefined,
+      [],
+      description,
+      image
+    );
+    anc.display = display;
+    sp.linkAncestor(anc);
+    return copy ? sp : anc;
+  }
+  extinction() {
+    return this.apparition + this.duration;
+  }
+  absoluteExtinction(): number {
+    return this.descendants.length > 0
+        ? Math.max(...this.allDescendants(false).map((desc) => desc.extinction()))
+        : this.extinction();
+  }
+  absoluteDuration() {
+    return this.absoluteExtinction() - this.apparition;
+  }
+  firstAncestor(includeNotDisplay = false): Species {
+    return this.ancestor ? ((this.ancestor.display || includeNotDisplay) ? this.ancestor.firstAncestor() : this) : this;
+  }
+  cousinsExtinction() {
+    return this.firstAncestor().absoluteExtinction();
+  }
+  allDescendants(sort = true): Species[] {
+    const desc = sort ? sortArray(this.descendants, s => -s.apparition, s => -s.absoluteExtinction()) : this.descendants;
+    if (desc.length === 0) {
+      return [this];
+    }
+    const limitDesc = desc.filter(desc => desc.apparition >= this.extinction());
+    const prevDesc = desc.filter(desc => limitDesc.indexOf(desc) === -1);
+    const halfFunc = this.onPosition(sort) ? Math.ceil : Math.floor;
+    const half = halfFunc(limitDesc.length / 2);
+    const lim0 = limitDesc.slice(0, half);
+    const lim1 = limitDesc.slice(half);
+    return lim0.flatMap((d) => d.allDescendants(sort)).concat([this]).concat(lim1.flatMap((d) => d.allDescendants(sort))).concat(prevDesc.flatMap((d) => d.allDescendants(sort)));
+  }
+  stepsChain(desc: Species, includeNotDisplay = false): Species[] {
+    if(!this.allDescendants(false).includes(desc)) {
+      return [];
+    }
+    return [this as Species].concat(this.descendants.find(d => d.allDescendants(false).includes(desc))?.stepsChain(desc) ?? []).filter(d => d.display || includeNotDisplay);
+  }
+  stepsUntil(desc: Species, includeNotDisplay = false): number | undefined {
+    if(!this.allDescendants(false).includes(desc)) {
+      return;
+    }
+    return this.stepsChain(desc, includeNotDisplay).length - 1;
+  }
+  stepsUntilLastDescendant(icludeNotDisplay = false): number{
+    if(this.descendants.length === 0) {
+      return 0;
+    }
+    return Math.max(...this.allDescendants(false).filter(d => d.descendants.length === 0).map(d => this.stepsUntil(d, icludeNotDisplay) ?? 0));
+  }
+  toJSON(): SpeciesJSON {
+    return {
+      name: this.name,
+      apparition: !this.ancestor ? this.apparition : undefined,
+      afterApparition: this.ancestor ? this.apparition - this.ancestor.apparition : undefined,
+      description: this.description,
+      duration: this.duration,
+      descendants: this.descendants.length > 0 ? this.descendants.map((desc) => desc.toJSON()) : undefined,
+      image: this.image,
+    };
+  }
+  async saveJSON(filename: string | undefined = undefined) {
+    try{
+      const jsonString = JSON.stringify(this.toJSON(), null, 2);
+      const blob = new Blob([jsonString], { type: 'application/json' });
+      const url = URL.createObjectURL(blob);
+      const a = document.createElement('a');
+      a.href = url;
+      a.download = filename ?? `${this.name}.json`;
+      a.click();
+      URL.revokeObjectURL(url);
+    } catch(errror) {
+      console.error("Error saving file:", errror);
+    }
+  }
+  static fromJSON(json: SpeciesJSON, ancestor?: Species): Species {
+    const afterApparition = json.afterApparition ?? 0;
+    const apparition = ancestor ? ancestor.apparition : json.apparition ?? 0;
+    const sp = new Species(json.name ?? "", apparition + afterApparition, json.duration ?? 0, ancestor, [], json.description, json.image);
+    if(json.descendants) {
+      for (const desc of json.descendants) {
+        sp.descendants.push(Species.fromJSON(desc, sp));
+      }
+    }
+    return sp
+  }
+}

package/src/components/HoverDescription.tsx ADDED Viewed

@@ -0,0 +1,27 @@
+import { Species } from "../classes/Species";
+import { scientificNotation } from "../utils/scientificNotation";
+export const HoverDescription = ({
+    hoverPosition,
+    hoverSpecies,
+    offset = { x: 0, y: 50 }
+} : HoverDescriptionProps) => {
+    return (
+        <nav
+            style={{
+                left: hoverPosition.x + offset.x,
+                top: hoverPosition.y - offset.y,
+            }}
+            className="absolute bg-gray-500 p-2.5"
+        >
+            <p>{hoverSpecies.name} ({scientificNotation(hoverSpecies.apparition)} — {scientificNotation(hoverSpecies.extinction())}):</p>
+            <p>{hoverSpecies.description}</p>
+        </nav>
+    );
+};
+interface HoverDescriptionProps {
+    hoverPosition: { x: number; y: number };
+    hoverSpecies: Species;
+    offset?: { x: number; y: number };
+}