@linkurious/ogma-annotations-react 1.1.23 → 1.1.25

package/dist/types/index.d.ts

@@ -2,9 +2,8 @@ import { Annotation } from '@linkurious/ogma-annotations';
 import { AnnotationCollection } from '@linkurious/ogma-annotations';
 import { AnnotationFeature } from '@linkurious/ogma-annotations';
 import { ArrowStyles } from '@linkurious/ogma-annotations';
-import { Context } from 'react';
 import { Control } from '@linkurious/ogma-annotations';
-import { JSX as JSX_2 } from 'react/jsx-runtime';
+import { default as default_2 } from 'react';
 import { ReactElement } from 'react';
 import { TextStyle } from '@linkurious/ogma-annotations';
 
@@ -15,38 +14,94 @@ declare type AnnotationAction = {
 
 declare type AnnotationActionType = "add" | "remove" | "update";
 
-export declare const AnnotationsContext: Context<IAnnotationsContext>;
-
-export declare const AnnotationsContextProvider: ({ children }: Props) => JSX_2.Element;
+/**
+ * Creates a React context for managing annotations with type safety.
+ *
+ * @type {Context<IAnnotationsContext>} A typed context for annotation-related
+ * state and operations
+ */
+export declare const AnnotationsContext: default_2.Context<IAnnotationsContext>;
+
+/**
+ * Provides a context provider for managing annotations in a graph visualization.
+ *
+ * This component handles the state and interactions for creating, selecting,
+ * and styling annotations, including arrow and text annotations.
+ *
+ * @param {Props} props - The component props containing child elements
+ * @returns {ReactElement} A context provider with annotation management capabilities
+ */
+export declare const AnnotationsContextProvider: ({ children }: Props) => default_2.JSX.Element;
 
 export declare const BLACK = "#333333";
 
-export declare function createAnnotationsContext(): Context<IAnnotationsContext | null>;
-
+/**
+ * Creates a React context for managing annotations with optional type safety.
+ *
+ * @returns {Context<IAnnotationsContext | null>} A context for annotation-related state and operations that can be null
+ */
+export declare function createAnnotationsContext(): default_2.Context<IAnnotationsContext | null>;
+
+/**
+ * Default arrow style for annotations.
+ * @type {ArrowStyles}
+ */
 export declare const defaultArrowStyle: ArrowStyles;
 
+/**
+ * List of default colors for annotations.
+ * @type {string[]}
+ */
 export declare const defaultColors: string[];
 
+/**
+ * Default text style for annotations.
+ * @type {TextStyle}
+ */
 export declare const defaultTextStyle: TextStyle;
 
+/**
+ * List of available fonts for annotations.
+ */
 export declare const fonts: string[];
 
 export declare const fontSizes: number[];
 
-declare interface IAnnotationsContext {
+/**
+ * Defines the context interface for managing annotations in a React application.
+ *
+ * @interface
+ * @description Provides state and methods for handling annotation collections,
+ * current annotation selection, styling, and editor control.
+ */
+export declare interface IAnnotationsContext {
+    /** Current annotations in the application. */
     annotations: AnnotationCollection;
-    updateAnnotations: React.Dispatch<AnnotationAction>;
+    /** Updates the annotations in the application. */
+    updateAnnotations: default_2.Dispatch<AnnotationAction>;
+    /** The currently selected annotation in the application. */
     currentAnnotation: AnnotationFeature | null;
+    /** Sets the currently selected annotation in the application. */
     setCurrentAnnotation: (annotation: AnnotationFeature | null) => void;
+    /** The current arrow style for annotations. */
     arrowStyle: ArrowStyles;
+    /** The current width factor for arrow annotations. */
     arrowWidthFactor: number;
+    /** Sets the width factor for arrow annotations. */
     setArrowWidthFactor: (arrowWidthFactor: number) => void;
+    /** Sets the current arrow style for annotations. */
     setArrowStyle: (arrowStyle: ArrowStyles) => void;
+    /** The current text style for annotations. */
     textStyle: TextStyle;
+    /** The current size factor for text annotations in regards to node sizes. */
     textSizeFactor: number;
+    /** Sets the size factor for text annotations. */
     setTextSizeFactor: (textSizeFactor: number) => void;
+    /** Sets the current text style for annotations. */
     setTextStyle: (textStyle: TextStyle) => void;
+    /** The annotations editor for managing annotations. See {@link AnnotationsEditor} */
     editor: Control;
+    /** Sets the current annotations editor for managing annotations. */
     setEditor: (editor: Control) => void;
 }
 
@@ -60,10 +115,19 @@ declare interface Props {
     children: ReactElement;
 }
 
+/**
+ * Default relative padding for text annotations.
+ */
 export declare const RELATIVE_PADDING = 0.25;
 
 export declare const TRANSPARENT = "none";
 
+/**
+ * Retrieves the current annotations context for accessing and managing annotations.
+ *
+ * @returns {IAnnotationsContext} The current annotations context with methods and
+ * state for annotation management
+ */
 export declare const useAnnotationsContext: () => IAnnotationsContext;
 
 export { }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linkurious/ogma-annotations-react",
-  "version": "1.1.23",
+  "version": "1.1.25",
   "description": "A react component to add ogma annotations with  react",
   "type": "module",
   "main": "dist/index.mjs",
@@ -25,7 +25,7 @@
   },
   "scripts": {
     "dev": "vite -c web/vite.config.mts",
-    "build": "tsc --p ./tsconfig-build.json && vite build",
+    "build": "tsc --p ./tsconfig-build.json && vite build --mode production",
     "postversion": "npm i --save-peer @linkurious/ogma-annotations@${npm_new_version}",
     "bump:patch": "bump2version patch && npm version --no-git-tag-version patch",
     "bump:minor": "bump2version minor && npm version --no-git-tag-version minor",
@@ -34,7 +34,8 @@
     "postdocs:build": "bash scripts/postdocs.sh",
     "lint": "eslint . --ext ts,tsx --report-unused-disable-directives --max-warnings 0",
     "lint:ci": "eslint -f checkstyle -o reports/checkstyle.xml --ext ts,tsx src",
-    "test:unit": ""
+    "test:unit": "vitest run",
+    "test": "npm run test:unit"
   },
   "publishConfig": {
     "access": "public"
@@ -51,15 +52,16 @@
   "license": "Apache-2.0",
   "peerDependencies": {
     "@linkurious/ogma": ">=4.5.6 || ^5.0.0",
-    "@linkurious/ogma-annotations": "^1.1.23",
+    "@linkurious/ogma-annotations": "^1.1.25",
     "@linkurious/ogma-react": ">=5",
     "react": ">=17"
   },
   "devDependencies": {
     "@linkurious/eslint-config-ogma": "^1.0.14",
+    "@testing-library/react": "16.2.0",
     "@types/react": "18.3.1",
     "@types/react-dom": "18.3.1",
-    "@vitejs/plugin-react": "4.3.4",
+    "@vitejs/plugin-react": "4.5.1",
     "eslint": "8.56.0",
     "eslint-plugin-react-hooks": "4.6.0",
     "eslint-plugin-react-refresh": "0.4.5",
@@ -67,7 +69,7 @@
     "react": "18.3.1",
     "react-dom": "18.3.1",
     "typescript": "5.3.3",
-    "vite": "6.2.0",
+    "vite": "6.3.5",
     "vite-plugin-dts": "4.5.1",
     "vite-plugin-lib-inject-css": "1.3.0",
     "vitest": "3.0.7"