wickchart 1.7.0 → 2.0.2

package/src/wick-feed.js

@@ -19,7 +19,6 @@
  *   streaming. Status is reflected in the `status` attribute and via
  *   `wick-feed:status` events (loading / live / polling / fallback / loaded /
  *   waiting / idle). `wick-feed:fallback` fires when a live source degrades.
- *   (The 0.x event names `hab-feed:*` still fire as deprecated aliases.)
  * ========================================================================== */
 
 import './wick-chart.js';
@@ -41,6 +40,7 @@ import {
   normalizeTrades,
 } from './feeds.js';
 
+
 const LIVE_TICK_MS = 650;
 
 const HTMLElementBase = typeof HTMLElement !== 'undefined' ? HTMLElement : class {};
@@ -99,21 +99,19 @@ class WickFeed extends HTMLElementBase {
     this._fire('status', { status, ...detail });
   }
 
-  /** Dispatch `wick-feed:name` plus the deprecated `hab-feed:name` alias. */
+  /** Dispatch `wick-feed:name`. */
   _fire(name, detail) {
     this.dispatchEvent(new CustomEvent('wick-feed:' + name, { detail }));
-    this.dispatchEvent(new CustomEvent('hab-feed:' + name, { detail }));
   }
-
   /** Resolve the target chart (by `for` id, else the first chart element —
-   *  <wick-chart> or the deprecated <hab-chart>). */
+   *  <wick-chart>). */
   _resolveChart() {
     const id = this.getAttribute('for');
     if (id) {
       const el = document.getElementById(id);
       return el && (el.tagName === 'WICK-CHART' || el.tagName === 'HAB-CHART') ? el : null;
     }
-    return document.querySelector('wick-chart') || document.querySelector('hab-chart');
+    return document.querySelector('wick-chart');
   }
 
   _restart() {
@@ -459,12 +457,6 @@ if (typeof customElements !== 'undefined') {
   if (!customElements.get('wick-feed')) {
     customElements.define('wick-feed', WickFeed);
   }
-  // 0.x alias: same element under its old tag name (deprecated, removed in 2.0)
-  if (!customElements.get('hab-feed')) {
-    /** @deprecated use <wick-feed> */
-    class HabFeed extends WickFeed {}
-    customElements.define('hab-feed', HabFeed);
-  }
 }
 
 export default WickFeed;

package/types/core.d.ts

@@ -199,6 +199,9 @@ export declare const DAY: number;
  * @returns {number} milliseconds
  */
 export declare const toMs: (t: number | Date) => number;
+/** Warn once per distinct message (used by the 2.0 moved-method stubs in
+ *  wick-chart.js — deleted with them in 3.0). */
+export declare function warnDeprecatedAlias(message: any): void;
 /**
  * Milliseconds east of UTC in `zone` at the instant `at`.
  *   'utc'            → 0
@@ -477,20 +480,6 @@ export declare function detectAnnotations(bars: Bar[], i0: number, i1: number, r
     i: number;
     note: string;
 }>;
-/**
- * Map a price to a sonification frequency over the visible scale.
- * Logarithmic scales map through log-space; result clamped to [lo, hi] Hz.
- * @param {number} price
- * @param {{min: number, max: number, useLog?: boolean}} scale
- * @param {number} [freqLo=180]
- * @param {number} [freqHi=880]
- * @returns {number} frequency in Hz
- */
-export declare function priceToFreq(price: number, scale: {
-    min: number;
-    max: number;
-    useLog?: boolean;
-}, freqLo?: number, freqHi?: number): number;
 /**
  * Volume profile over a visible bar range: volume distributed into price
  * rows, with POC and the value area (greedy expansion around the POC).
@@ -826,7 +815,7 @@ export declare function evalScript(compiled: {
 /**
  * Build an indicator definition from a WickScript expression — used inline by
  * `indicators="expr:{…}"` / `pexpr:{…}"`, or register it under a name:
- * `HabChart.registerIndicator('myspread', scriptIndicator('close - ema(close,21)'))`.
+ * `WickChart.registerIndicator('myspread', scriptIndicator('close - ema(close,21)'))`.
  * @param {string} src
  * @param {{pane?: boolean}} [opts]
  * @returns {IndicatorDef}
@@ -987,24 +976,6 @@ export declare function normalizeOverlays(list: any): object[];
  * @returns {string} a concrete CSS color
  */
 export declare function resolveOverlayColor(raw: any, pal: object): string;
-/**
- * σ-cone projection from realized per-bar volatility: price bands widening
- * with √h (GBM-style, exp(±z·σ·√h)) over `horizon` future bars.
- * @param {number} lastClose anchor price (bar 0)
- * @param {number} volPerBar per-bar stddev of log returns (from calcRealizedVol)
- * @param {number} horizon future bars (clamped 1–500, default 48)
- * @param {number[]} [levels] σ multipliers, e.g. [1, 2] (each clamped to 0–5)
- * @returns {{horizon: number, levels: number[], bands: Record<string, {up: number[], down: number[]}>}}
- *          bands[z].up/.down are arrays indexed by h = 0…horizon ([0] === lastClose)
- */
-export declare function calcVolCone(lastClose: number, volPerBar: number, horizon: number, levels?: number[]): {
-    horizon: number;
-    levels: number[];
-    bands: Record<string, {
-        up: number[];
-        down: number[];
-    }>;
-};
 /**
  * Validate a scenario spec: a ghost path of future prices (bars or API data)
  * plus optional cone settings. Invalid entries are dropped, never thrown.
@@ -1061,34 +1032,6 @@ export declare function normalizeRiskPlan(spec: any): null | {
     maxK: number;
     label: string;
 };
-/**
- * Turn a bar window into an ordered story: the annotation events (pivot
- * highs/lows, volume spikes, gaps, RSI divergences) plus derived **legs** —
- * the move between consecutive opposite pivots ("+12.4% over 38 bars").
- * The timeline drives the bar-walk player and any caption UI.
- *
- * @param {Bar[]} bars full dataset
- * @param {number} i0 first index of the window
- * @param {number} i1 last index of the window
- * @param {{pivot?: number, volMult?: number, gapMult?: number, rsiPeriod?: number}} [opts]
- *        pivot window defaults to 8 (denser than the annotations overlay's 20)
- * @returns {{i: number, time: number, type: string, side: string, note: string,
- *            legPct?: number, legBars?: number}[]} sorted by index, capped at 60
- */
-export declare function narrateWindow(bars: Bar[], i0: number, i1: number, opts?: {
-    pivot?: number;
-    volMult?: number;
-    gapMult?: number;
-    rsiPeriod?: number;
-}): {
-    i: number;
-    time: number;
-    type: string;
-    side: string;
-    note: string;
-    legPct?: number;
-    legBars?: number;
-}[];
 /**
  * Stats for a brushed bar range: net move (open of the first bar → close
  * of the last), extremes, and summed volume. Powers the brush-selection
@@ -1120,72 +1063,6 @@ export declare function brushStats(bars: Bar[], i0: number, i1: number): null |
     low: number;
     volume: number;
 };
-/** Smoothest cheap easing for viewport pans: slow in, slow out. */
-export declare function easeInOutCubic(t: any): number;
-/**
- * Validate one story scene. Every field is optional except that a scene
- * must be an object; omitted fields simply don't change that aspect of
- * the chart when played. `scenario`/`riskPlan` use a 'clear' sentinel for
- * explicit "remove it" (null input means clear too when the KEY is present).
- *
- *   { title: 'The breakout', note: 'What happened…',
- *     range: { from, to },          // times (s or ms) — the camera pans there
- *     indicators: 'sma:20 rsi:14',  // optional indicator string
- *     type: 'candles',              // optional series type
- *     overlays: [...],              // optional zones/levels (normalizeOverlays)
- *     scenario: {...} | null,       // set / clear a scenario
- *     riskPlan: {...} | null,       // set / clear a risk plan
- *     dwell: 2200 }                 // ms to hold after the pan (500–30000)
- *
- * @returns {object|null} normalized scene, or null for non-objects
- */
-export declare function normalizeScene(scene: any): object | null;
-/**
- * Validate a whole story: normalize each scene, drop junk, cap at 20.
- * @returns {object[]} possibly empty
- */
-export declare function sceneList(story: any): object[];
-/**
- * Tracks other charts viewing the same room: last-sighting timestamps per
- * peer plus the viewport each one is looking at. Pure bookkeeping — the
- * transport (BroadcastChannel, WebSocket, …) lives in the component/app.
- *
- * Peers expire `ttl` ms after their last sighting, so a closed tab fades
- * out of the room without an explicit goodbye.
- */
-export declare class PresenceTracker {
-    ttl: number;
-    /** @type {Map<string, {id: string, name: string|null, range: {from:number,to:number}|null, at: number}>} */
-    peers: Map<string, {
-        id: string;
-        name: string | null;
-        range: {
-            from: number;
-            to: number;
-        } | null;
-        at: number;
-    }>;
-    /** @param {number} [ttl=12000] ms a peer survives without a sighting */
-    constructor(ttl?: number);
-    /**
-     * Record a sighting. `patch.range` ({from,to} times) is validated and
-     * normalized; a sighting without a range keeps the previous one.
-     * @returns {boolean} true when this sighting is a join (new peer)
-     */
-    track(id: any, patch?: {}, now?: number): boolean;
-    /** @returns {object|null} the removed peer entry, or null when unknown */
-    drop(id: any): object | null;
-    /** Expire peers not seen within the ttl.
-     *  @returns {object[]} the peer entries that left */
-    sweep(now?: number): object[];
-    /** @returns {{id: string, name: string|null, range: object|null, at: number}[]} copies, oldest sighting first */
-    list(): {
-        id: string;
-        name: string | null;
-        range: object | null;
-        at: number;
-    }[];
-}
 export declare const tfLabelOf: (dtMs: any) => string;
 /**
  * Compact, LLM-friendly summary of a bar window: structured fields plus a
@@ -1215,110 +1092,3 @@ export declare function encodeStateQuery(state: ChartState | null): string;
  * @returns {ChartState}
  */
 export declare function decodeStateQuery(str: string): ChartState;
-/**
- * Tool manifest for LLM/agent control of a chart. Tools map 1:1 onto the
- * public element API; every op through applyChartOps is validated before it
- * touches the chart (LLM output is untrusted input).
- */
-export declare const AI_TOOLS: ({
-    tool: string;
-    description: string;
-    args: {
-        indicators?: undefined;
-        overlays?: undefined;
-        from?: undefined;
-        to?: undefined;
-        type?: undefined;
-        enabled?: undefined;
-        low?: undefined;
-        high?: undefined;
-    };
-} | {
-    tool: string;
-    description: string;
-    args: {
-        indicators: string;
-        overlays?: undefined;
-        from?: undefined;
-        to?: undefined;
-        type?: undefined;
-        enabled?: undefined;
-        low?: undefined;
-        high?: undefined;
-    };
-} | {
-    tool: string;
-    description: string;
-    args: {
-        indicators?: undefined;
-        overlays: string;
-        from?: undefined;
-        to?: undefined;
-        type?: undefined;
-        enabled?: undefined;
-        low?: undefined;
-        high?: undefined;
-    };
-} | {
-    tool: string;
-    description: string;
-    args: {
-        indicators?: undefined;
-        overlays?: undefined;
-        from: string;
-        to: string;
-        type?: undefined;
-        enabled?: undefined;
-        low?: undefined;
-        high?: undefined;
-    };
-} | {
-    tool: string;
-    description: string;
-    args: {
-        indicators?: undefined;
-        overlays?: undefined;
-        from?: undefined;
-        to?: undefined;
-        type: string;
-        enabled?: undefined;
-        low?: undefined;
-        high?: undefined;
-    };
-} | {
-    tool: string;
-    description: string;
-    args: {
-        indicators?: undefined;
-        overlays?: undefined;
-        from?: undefined;
-        to?: undefined;
-        type?: undefined;
-        enabled: string;
-        low: string;
-        high: string;
-    };
-})[];
-/**
- * Compact system prompt for agent control: paste into any LLM alongside the
- * tool manifest. The model answers with a JSON array of {tool, args} ops.
- * @returns {string}
- */
-export declare function aiPromptText(): string;
-/**
- * Validate + apply a list of {tool, args} ops (typically LLM output) to a
- * chart-like target. Ops are whitelisted and their args validated — an op
- * never throws; it returns {ok: false, error} instead so the agent can
- * self-correct. Target contract: getDataWindow(), setAttribute(k, v),
- * setOverlays(list), clearOverlays(), addAlert(a), setVisibleRange(r),
- * fit(), and (static) _registry() for indicator name checks.
- * @param {object} target chart element (or test double)
- * @param {any} ops
- * @returns {Array<{ok: boolean, tool?: string, result?: any, error?: string}>}
- */
-export declare function applyChartOps(target: object, ops: any): Array<{
-    ok: boolean;
-    tool?: string;
-    result?: any;
-    error?: string;
-}>;