@alphacharts/drawings 0.1.0 → 0.1.1

package/dist/types/index.d.ts

@@ -8,7 +8,7 @@ export { TemplateStore } from "./templates.js";
 export type { DrawingTemplate } from "./templates.js";
 export { DEFAULT_STYLE, SCHEMA_VERSION } from "./types.js";
 export type { Anchor, Dash, Drawing, DrawingStyle, DrawingsState, Gesture, Shape, Stroke, ToolCtx, ToolDef } from "./types.js";
-export { drawShapes, shapeDistance, shapeInRect, withAlpha } from "./shapes.js";
+export { declutter, drawShapes, shapeDistance, shapeInRect, withAlpha } from "./shapes.js";
 export * as geometry from "./geometry.js";
 export { allTools } from "./tools/all.js";
 export { lineTools, trendLine, ray, infoLine, extendedLine, horizontalLine, horizontalRay, verticalLine, crossLine } from "./tools/lines.js";

package/dist/types/plugin.d.ts

@@ -15,6 +15,12 @@ export interface DrawingsOptions {
     magnet?: MagnetMode;
     /** Stay in the tool after a drawing is finished. */
     continuous?: boolean;
+    /**
+     * Display only, for drawings the host places by code: the plugin never takes a pointer press, key or cursor, so
+     * nothing it draws can be hit, selected, moved or deleted, and the chart (pan, zoom, its own handles above it)
+     * gets every event as if no drawing were there. `setTool` throws. `add`, `update`, `remove` and `fromJSON` still work.
+     */
+    readOnly?: boolean;
     /** Templates and favourites storage. */
     store?: LayoutStore;
     /** A tool failed to draw or a gesture produced an invalid drawing. Default: console.error. */

package/dist/types/shapes.d.ts

@@ -13,6 +13,16 @@ export interface TextBox {
 export declare function textBox(s: Extract<Shape, {
     k: "text";
 }>, style: DrawingStyle, measure: (text: string, font: string) => number): TextBox;
+/**
+ * Moves the `stack` labels of one pane apart: in order from the top, a label that overlaps one already placed is
+ * moved down until it clears it. Mutates the shapes (they are made anew for each frame); nothing else is touched.
+ */
+export declare function declutter(items: readonly {
+    s: Extract<Shape, {
+        k: "text";
+    }>;
+    style: DrawingStyle;
+}[], measure: (text: string, font: string) => number): void;
 export declare function drawShapes(ctx: CanvasRenderingContext2D, shapes: readonly Shape[], style: DrawingStyle, W: number, H: number, opts?: {
     widthBoost?: number;
 }): void;

package/dist/types/types.d.ts

@@ -85,6 +85,11 @@ export type Shape = (Stroke & {
     /** Border of the background box. */
     border?: string | null;
     pad?: number;
+    /**
+     * A label that gives way: when the pane draws it over another stacking label it is moved down just clear of it
+     * (the price labels of several levels close in price do not print over one another).
+     */
+    stack?: boolean;
 });
 export interface ToolCtx {
     /** Pane size in CSS px. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@alphacharts/drawings",
-  "version": "0.1.0",
-  "description": "Chart drawing tools for AlphaCharts: 82 tools, undo/redo, magnet and templates.",
+  "version": "0.1.1",
+  "description": "Chart drawing tools for alphacharts: 82 tools, undo/redo, magnet and templates.",
   "keywords": [
     "drawings",
     "trendline",
@@ -44,7 +44,7 @@
     "typescript": "5.9.3",
     "vite": "8.3.1",
     "vitest": "5.0.2",
-    "@alphacharts/core": "0.1.0"
+    "@alphacharts/core": "0.1.1"
   },
   "scripts": {
     "build": "vite build && tsc -p tsconfig.build.json",