lightweight-charts-drawing 0.3.0 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## 0.5.0 (08/10/2026)
+
+### Added
+
+- `DrawingManager.setHidden(id, hidden)`: hide / show one drawing without
+  removing it (the drawing's `hidden` flag, saved with it).
+- `DrawingManager.setDrawingsVisible(visible)` / `drawingsVisible()` and the
+  `visibility` event: hide / show every drawing at once (TradingView "Hide
+  all drawings"). Not saved, the drawings are untouched. Hiding disarms the
+  tool; arming a tool shows the drawings again.
+- Demo: hide all button, hide button in the selection bar.
+
+### Fixed
+
+- A drawing that stops being shown (`hidden`, per-interval visibility) leaves
+  the selection and the hover: Delete could remove a drawing that was not
+  drawn.
+
+## 0.4.0 (02/10/2026)
+
+### Added
+
+- `fibLevelAt` is exported from the package entry.
+
+### Changed
+
+- `VERSION` is read from `package.json` at build time (vite `define`), so it
+  cannot stay behind the package version again.
+
 ## 0.3.0 (02/10/2026)
 
 ### Added

package/README.md

@@ -61,6 +61,8 @@ intraday of date labels), `stayInDrawingMode` (TV Keep drawing).
 | `setTool(kind \| null, { glyph? })`, `tool()` | arm / disarm a tool (`kind` from docs/TOOLS.md) |
 | `setMagnet(mode)`, `setInterval(i)`, `setStayInDrawingMode(on)` | settings |
 | `add(drawing)`, `update(drawing)`, `remove(id)`, `clear()`, `get(id)`, `drawings()` | drawings |
+| `setHidden(id, hidden)` | hide / show one drawing without removing it (the drawing's `hidden` flag, saved with it) |
+| `setDrawingsVisible(visible)`, `drawingsVisible()` | hide / show every drawing at once (TV "Hide all drawings"; not saved, the drawings are untouched) |
 | `select(ids)`, `selection()` | selection (multi-select with Ctrl / Cmd) |
 | `bringToFront(id)`, `sendToBack(id)` | z-order |
 | `toggleAnchored(id)` | TV "Anchor drawing" for Text, Pin and Table: the drawing keeps its pane position when the chart scrolls (`isAnchorable(kind)`) |
@@ -71,6 +73,7 @@ intraday of date labels), `stayInDrawingMode` (TV Keep drawing).
 | `redraw()`, `destroy()` | |
 
 Events: `change`, `add`, `update`, `remove`, `selection`, `tool`,
+`visibility` (every drawing hidden / shown again),
 `textEdit` (a text tool was placed or double-clicked: open your editor at
 the given pane point and `update` the drawing's `text`), `tableEdit` (a click
 on a cell of the selected table: open your editor over the given cell box),
@@ -84,6 +87,10 @@ steps / square boxes and magnet off, Ctrl / Cmd inverts the magnet; Escape
 drops pending points, then the tool, then the selection; Delete removes the
 selection (locked drawings stay).
 
+Drawing flags: `locked` (selectable, but no drag and no Delete) and `hidden`
+(not drawn, hit or selected). A drawing that gets hidden leaves the
+selection. Arming a tool while every drawing is hidden shows them again.
+
 The host keeps what is not drawing logic: undo stack, storage, settings
 dialogs, text / table editors, toolbar, context menu.
 

package/dist/index.d.ts

@@ -183,6 +183,8 @@ export declare class DrawingManager {
     private readonly listeners;
     private list;
     private selected;
+    /** TV "Hide all drawings": off = nothing is drawn or hit (not saved). */
+    private visible;
     private hovered;
     private spec;
     private glyph;
@@ -206,6 +208,7 @@ export declare class DrawingManager {
     on(event: "remove", cb: DrawingManagerEvents["remove"]): () => void;
     on(event: "selection", cb: DrawingManagerEvents["selection"]): () => void;
     on(event: "tool", cb: DrawingManagerEvents["tool"]): () => void;
+    on(event: "visibility", cb: DrawingManagerEvents["visibility"]): () => void;
     on(event: "textEdit", cb: DrawingManagerEvents["textEdit"]): () => void;
     on(event: "gestureEnd", cb: DrawingManagerEvents["gestureEnd"]): () => void;
     on(event: "tableEdit", cb: DrawingManagerEvents["tableEdit"]): () => void;
@@ -217,12 +220,20 @@ export declare class DrawingManager {
     tool(): DrawingKind | null;
     setMagnet(mode: MagnetMode): void;
     setInterval(interval: string | undefined): void;
+    /** TV "Hide all drawings": hide / show every drawing without touching
+     *  them (the drawings' own `hidden` flag and the saved JSON stay as they
+     *  are). Hiding disarms the tool and clears the selection. */
+    setDrawingsVisible(visible: boolean): void;
+    drawingsVisible(): boolean;
     setStayInDrawingMode(on: boolean): void;
     drawings(): readonly Drawing[];
     get(id: string): Drawing | undefined;
     /** Add a drawing (default style of its kind when none); returns its id. */
     add(nd: NewDrawing | Drawing): string;
     update(d: Drawing): void;
+    /** Hide / show one drawing (its `hidden` flag, saved with it): a hidden
+     *  drawing is not drawn, hit or selected. */
+    setHidden(id: string, hidden: boolean): void;
     remove(id: string): void;
     clear(): void;
     /** Z-order (TV Visual order): the list order is the draw order. */
@@ -287,6 +298,9 @@ export declare class DrawingManager {
     private changed;
     private reorder;
     private shown;
+    /** Drawings that are no longer shown leave the selection and the hover:
+     *  Delete must not remove a drawing the user cannot see. */
+    private dropHidden;
     private paneSize;
     /** Pointer position in pane coordinates. */
     private panePoint;
@@ -334,6 +348,9 @@ export declare type DrawingManagerEvents = {
     selection: (ids: readonly string[]) => void;
     /** The armed tool changed (null = none). */
     tool: (kind: DrawingKind | null) => void;
+    /** Every drawing was hidden or shown again (setDrawingsVisible, or a tool
+     *  armed while they were hidden). */
+    visibility: (visible: boolean) => void;
     /** A text tool was placed (or double-clicked): the host opens its editor
      *  at `screen` (pane coordinates) and calls update with the text. */
     textEdit: (d: Drawing, screen: Pt) => void;
@@ -637,6 +654,19 @@ export declare function drawScene(ctx: Ctx, items: SceneItem[], o: CanvasSceneOp
  *  saved default (TV restoreFactoryDefaults / "Apply defaults"). */
 export declare function factoryStyleFor(kind: DrawingKind): DrawingStyle;
 
+/** The fib retracement / trend-based extension level line under `cursor`
+ *  (within 6 px, inside the levels' x-range): its index in the drawing's
+ *  level list (`style.levels` or the factory list), y, x-range and the
+ *  position of its level text (the Text alignment). Null elsewhere. Used by
+ *  hosts to edit a level's text on the chart. */
+export declare function fibLevelAt(d: Drawing, pts: Pt[], cursor: Pt, w: number, coords: Coords | null): {
+    index: number;
+    y: number;
+    left: number;
+    right: number;
+    textX: number;
+} | null;
+
 export declare function findOverlaySpec(toolId: string | null): OverlaySpec | undefined;
 
 /** A finished placement: the clicked points -> the new drawing with the data
@@ -1363,7 +1393,7 @@ declare type UnitVisibility = {
     to: number;
 };
 
-export declare const VERSION = "0.3.0";
+export declare const VERSION: string;
 
 /** Volume profile tools: the reference VbPFixed / VbPAnchored study
  *  defaults (24 rows, Up/Down, 70% value area, histogram 30% of the box,
@@ -1461,9 +1491,8 @@ declare type WithId<T> = T & {
     closed?: boolean;
     /** Locked drawings can be selected but not dragged or deleted via Delete-key. */
     locked?: boolean;
-    /** Hidden drawings are not rendered or hit-tested. Toggle via context menu;
-     *  unhiding from the chart requires re-selecting through the ObjectTreePanel
-     *  (not yet built). */
+    /** Hidden drawings are not rendered, hit-tested or selected; the flag is
+     *  saved with the drawing (DrawingManager.setHidden). */
     hidden?: boolean;
     /** Per-interval visibility matrix (Settings → Visibility). Absent = always
      *  visible (the default for drawings saved before this field existed). */