@pipsend/charts 0.0.11 → 0.0.13

package/dist/typings.d.ts

@@ -96,6 +96,55 @@ export declare class InteractiveLineManager {
 	 */
 	isCreating(): boolean;
 }
+/**
+ * Gestor de marcadores de posiciones de trading
+ */
+export declare class PositionMarkersManager<TimeType> {
+	private _markersPlugin;
+	private _positions;
+	private _options;
+	constructor(series: ISeriesApi<SeriesType, TimeType>, options?: PositionMarkersOptions);
+	/**
+	 * Agrega una posición al gráfico
+	 */
+	addPosition(position: TradingPosition<TimeType>): void;
+	/**
+	 * Agrega múltiples posiciones al gráfico
+	 */
+	addPositions(positions: TradingPosition<TimeType>[]): void;
+	/**
+	 * Establece las posiciones (reemplaza las existentes)
+	 */
+	setPositions(positions: TradingPosition<TimeType>[]): void;
+	/**
+	 * Elimina una posición por ID
+	 */
+	removePosition(id: string): void;
+	/**
+	 * Limpia todas las posiciones
+	 */
+	clearPositions(): void;
+	/**
+	 * Obtiene todas las posiciones actuales
+	 */
+	getPositions(): readonly TradingPosition<TimeType>[];
+	/**
+	 * Actualiza las opciones del gestor
+	 */
+	applyOptions(options: PositionMarkersOptions): void;
+	/**
+	 * Convierte las posiciones a marcadores de serie
+	 */
+	private _positionsToMarkers;
+	/**
+	 * Actualiza los marcadores en el gráfico
+	 */
+	private _updateMarkers;
+	/**
+	 * Desconecta el plugin y limpia recursos
+	 */
+	detach(): void;
+}
 export declare const customSeriesDefaultOptions: CustomSeriesOptions;
 /**
  * Enumeration representing the sign of a marker.
@@ -456,6 +505,51 @@ export declare function createInteractiveLineManager(chart: IChartApi, series: I
  * @returns An instance of IChartApiBase configured for price-based horizontal scaling.
  */
 export declare function createOptionsChart(container: string | HTMLElement, options?: DeepPartial<PriceChartOptions>): IChartApiBase<number>;
+/**
+ * Crea un gestor de marcadores de posiciones de trading
+ *
+ * @param series - Serie a la que se adjuntarán los marcadores
+ * @param positions - Posiciones iniciales (opcional)
+ * @param options - Opciones de configuración (opcional)
+ * @returns Instancia del gestor de posiciones
+ *
+ * @example
+ * ```typescript
+ * // Crear el gestor
+ * const positionMarkers = createPositionMarkers(candleSeries);
+ *
+ * // Agregar una posición long
+ * positionMarkers.addPosition({
+ *   type: 'long',
+ *   entry: { time: '2023-01-01', price: 100.50 },
+ *   exit: { time: '2023-01-05', price: 105.20 },
+ *   id: 'pos-1'
+ * });
+ *
+ * // Agregar una posición short
+ * positionMarkers.addPosition({
+ *   type: 'short',
+ *   entry: { time: '2023-01-10', price: 110.00 },
+ *   exit: { time: '2023-01-15', price: 107.50 },
+ *   id: 'pos-2'
+ * });
+ *
+ * // Agregar múltiples posiciones
+ * positionMarkers.setPositions([
+ *   {
+ *     type: 'long',
+ *     entry: { time: '2023-02-01', price: 95.00 },
+ *     exit: { time: '2023-02-10', price: 98.50 }
+ *   },
+ *   {
+ *     type: 'short',
+ *     entry: { time: '2023-02-15', price: 102.00 },
+ *     exit: { time: '2023-02-20', price: 99.00 }
+ *   }
+ * ]);
+ * ```
+ */
+export declare function createPositionMarkers<TimeType>(series: ISeriesApi<SeriesType, TimeType>, positions?: TradingPosition<TimeType>[], options?: PositionMarkersOptions): PositionMarkersManager<TimeType>;
 /**
  * A function to create a series markers primitive.
  *
@@ -3605,6 +3699,29 @@ export interface Point {
 	 */
 	readonly y: Coordinate;
 }
+/**
+ * Opciones para el gestor de posiciones
+ */
+export interface PositionMarkersOptions {
+	/**
+	 * Colores predeterminados para posiciones long
+	 */
+	longColors?: {
+		entry?: string;
+		exit?: string;
+	};
+	/**
+	 * Colores predeterminados para posiciones short
+	 */
+	shortColors?: {
+		entry?: string;
+		exit?: string;
+	};
+	/**
+	 * Tamaño predeterminado de las flechas
+	 */
+	defaultSize?: number;
+}
 /**
  * Extends LocalizationOptions for price-based charts.
  * Includes settings specific to formatting price values on the horizontal scale.
@@ -4574,6 +4691,52 @@ export interface TradingLineOptions {
 	onDragMove?: (price: number) => void;
 	onDragEnd?: (price: number) => void;
 }
+/**
+ * Representa una posición de trading con punto de entrada y salida
+ */
+export interface TradingPosition<TimeType> {
+	/**
+	 * Tipo de posición (long o short)
+	 */
+	type: PositionType;
+	/**
+	 * Punto de entrada
+	 */
+	entry: {
+		time: TimeType;
+		price: number;
+	};
+	/**
+	 * Punto de salida
+	 */
+	exit: {
+		time: TimeType;
+		price: number;
+	};
+	/**
+	 * ID opcional para identificar la posición
+	 */
+	id?: string;
+	/**
+	 * Color personalizado para las flechas (opcional)
+	 * Si no se especifica, se usarán colores predeterminados según el tipo
+	 */
+	color?: {
+		entry?: string;
+		exit?: string;
+	};
+	/**
+	 * Tamaño de las flechas (opcional, por defecto 1)
+	 */
+	size?: number;
+	/**
+	 * Texto opcional para las flechas
+	 */
+	text?: {
+		entry?: string;
+		exit?: string;
+	};
+}
 /**
  * Configuration options for the UpDownMarkers plugin.
  */
@@ -4914,6 +5077,10 @@ export type OverlayPriceScaleOptions = Omit<PriceScaleOptions, "visible" | "auto
  * A function used to format a percentage value as a string.
  */
 export type PercentageFormatterFn = (percentageValue: number) => string;
+/**
+ * Tipo de posición de trading
+ */
+export type PositionType = "long" | "short";
 /**
  * Represents information used to format prices.
  */

package/package.json

@@ -1,6 +1,5 @@
 {
-  "private": false,
-  "version": "0.0.11",
+  "version": "0.0.13",
   "name": "@pipsend/charts",
   "author": "Pipsend",
   "license": "SEE LICENSE IN LICENSE",
@@ -54,88 +53,7 @@
     "bollinger-bands",
     "financial-analysis"
   ],
-  "engines": {
-    "node": ">=22.3"
-  },
   "dependencies": {
     "fancy-canvas": "2.1.0"
-  },
-  "devDependencies": {
-    "@juggle/resize-observer": "3.4.0",
-    "@rollup/plugin-node-resolve": "16.0.1",
-    "@rollup/plugin-replace": "6.0.2",
-    "@rollup/plugin-terser": "0.4.4",
-    "@size-limit/file": "11.2.0",
-    "@size-limit/webpack": "11.2.0",
-    "@types/chai": "5.2.1",
-    "@types/express": "5.0.1",
-    "@types/glob": "8.1.0",
-    "@types/node": "22",
-    "@types/pixelmatch": "5.2.6",
-    "@types/pngjs": "6.0.5",
-    "@typescript-eslint/eslint-plugin": "7.18.0",
-    "@typescript-eslint/eslint-plugin-tslint": "7.0.2",
-    "@typescript-eslint/parser": "7.18.0",
-    "ajv": "7.2.4",
-    "bytes": "3.1.2",
-    "chai": "5.2.0",
-    "chai-exclude": "3.0.1",
-    "cross-env": "7.0.3",
-    "dts-bundle-generator": "9.5.1",
-    "eslint": "8",
-    "eslint-formatter-unix": "8.40.0",
-    "eslint-plugin-deprecation": "3.0.0",
-    "eslint-plugin-import": "2.31.0",
-    "eslint-plugin-unicorn": "56.0.1",
-    "esno": "4.8.0",
-    "glob": "11.0.1",
-    "markdown-it": "14.1.0",
-    "markdown-it-anchor": "9.2.0",
-    "markdownlint-cli": "0.44.0",
-    "npm-run-all": "4.1.5",
-    "rimraf": "6.0.1",
-    "rollup": "4.40.0",
-    "size-limit": "11.2.0",
-    "ts-node": "10.9.2",
-    "ts-patch": "3.3.0",
-    "ts-transformer-properties-rename": "0.17.0",
-    "ts-transformer-strip-const-enums": "2.0.0",
-    "tslib": "2.8.1",
-    "tslint": "6.1.3",
-    "tslint-eslint-rules": "5.4.0",
-    "tslint-microsoft-contrib": "6.2.0",
-    "tsx": "4.19.3",
-    "typescript": "5.5.4",
-    "yargs": "17.7.2"
-  },
-  "scripts": {
-    "install-hooks": "node scripts/githooks/install.js",
-    "clean": "rimraf lib/ dist/",
-    "bundle-dts": "dts-bundle-generator --config dts-config.json",
-    "tsc": "tspc -p tsconfig.prod.json",
-    "tsc-watch": "npm run tsc -- --watch --preserveWatchOutput",
-    "tsc-verify": "node website/scripts/generate-versions-dts.js && tsc -b tsconfig.composite.json",
-    "lint": "npm-run-all -p lint:**",
-    "lint:eslint": "eslint --format=unix ./",
-    "lint:md": "markdownlint -i \"**/node_modules/**\" -i \"**/website/docs/api/**\" -i \"**/website/versioned_docs/**/api/**\" -i \"**/*.mdx\" \"**/*.md\"",
-    "check-dts-docs": "npm-run-all -p check-dts-docs-duplicates check-dts-docs-eslint",
-    "check-dts-docs-duplicates": "node ./scripts/check-typings-for-duplicates.js ./dist/typings.d.ts",
-    "check-dts-docs-eslint": "eslint --format=unix ./dist/typings.d.ts --no-ignore",
-    "check-markdown-links": "node scripts/check-markdown-links.js",
-    "rollup": "rollup -c rollup.config.js",
-    "rollup-watch": "npm run rollup -- --watch",
-    "build": "npm-run-all tsc rollup bundle-dts",
-    "build:watch": "npm-run-all tsc -p tsc-watch rollup-watch",
-    "build:prod": "cross-env NODE_ENV=production npm run build",
-    "build:release": "cross-env BUILD_TAG=release npm run build:prod",
-    "prepare-release": "npm-run-all clean build:release && npm run prepare-package-json-for-release",
-    "prepare-package-json-for-release": "node ./scripts/clean-package-json.js",
-    "size-limit": "size-limit",
-    "verify": "npm-run-all clean -p build:prod check-markdown-links -p lint check-dts-docs tsc-verify test size-limit -p type-tests",
-    "test": "esno --import ./tests/unittests/setup.units.mjs --test './tests/unittests/**/*.spec.ts'",
-    "type-tests": "tsc -b ./src/tsconfig.composite.json && tsc -p ./tests/type-checks/tsconfig.composite.json --noEmit",
-    "e2e:coverage": "esno ./tests/e2e/coverage/runner.ts ./dist/pipsend-charts.standalone.development.js",
-    "e2e:interactions": "esno ./tests/e2e/interactions/runner.ts ./dist/pipsend-charts.standalone.development.js",
-    "e2e:memleaks": "esno ./tests/e2e/memleaks/runner.ts ./dist/pipsend-charts.standalone.development.js"
   }
 }