@invinite-org/chartlang-runtime 1.0.2

package/dist/ta/lib/volume-profile/scaffold.d.ts

@@ -0,0 +1,165 @@
+import { Float64RingBuffer } from "../../../ringBuffer.js";
+import type { RuntimeContext } from "../../../runtimeContext.js";
+import { type VolumeProfileBar } from "./index.js";
+import type { ProfileConfig } from "./index.js";
+/**
+ * Histogram bucket shape shared by all four volume-profile primitives.
+ *
+ * @formula N/A — internal volume-profile slot scaffolding (see the four
+ *          `ta.*VolumeProfile` primitives for the math contract).
+ * @since 0.5
+ * @internal
+ * @stable
+ * @example
+ *     // const bucket: HistogramBucket = { price: 100, volume: 10 };
+ */
+export type HistogramBucket = Readonly<{
+    price: number;
+    volume: number;
+    color?: string;
+}>;
+/**
+ * The "what we computed for this bar" snapshot used to commit to the
+ * slot's ring buffers and emit the histogram. NaN values short-circuit
+ * the buffer writes to NaN-warmup.
+ *
+ * @formula N/A — internal volume-profile slot scaffolding (see the four
+ *          `ta.*VolumeProfile` primitives for the math contract).
+ * @since 0.5
+ * @internal
+ * @stable
+ * @example
+ *     // const snap: VolumeProfileSnapshot = { buckets: [], poc: NaN, valHigh: NaN, valLow: NaN };
+ */
+export type VolumeProfileSnapshot = Readonly<{
+    buckets: ReadonlyArray<HistogramBucket>;
+    poc: number;
+    valHigh: number;
+    valLow: number;
+}>;
+/**
+ * Per-VP slot state: three Float64 ring buffers (POC / VAH / VAL) plus
+ * the latest computed buckets. Callers wrap this with a primitive-
+ * specific `result` object that exposes `Series<number>` views over the
+ * buffers and (optionally) the `buckets` getter.
+ *
+ * @formula N/A — internal volume-profile slot scaffolding (see the four
+ *          `ta.*VolumeProfile` primitives for the math contract).
+ * @since 0.5
+ * @internal
+ * @stable
+ * @example
+ *     // const core = createVolumeProfileCore(capacity);
+ */
+export type VolumeProfileCore = {
+    readonly pocBuffer: Float64RingBuffer;
+    readonly valHighBuffer: Float64RingBuffer;
+    readonly valLowBuffer: Float64RingBuffer;
+    buckets: ReadonlyArray<HistogramBucket>;
+};
+/**
+ * Allocate the three Float64 ring buffers + an empty `buckets` array
+ * shared by every volume-profile slot.
+ *
+ * @formula N/A — internal volume-profile slot scaffolding (see the four
+ *          `ta.*VolumeProfile` primitives for the math contract).
+ * @since 0.5
+ * @internal
+ * @stable
+ * @example
+ *     // const core = createVolumeProfileCore(capacity);
+ */
+export declare function createVolumeProfileCore(capacity: number): VolumeProfileCore;
+/**
+ * Normalise a primitive's options into the shared `ProfileConfig`.
+ * `rowSize` defaults to 24 and `valueAreaPct` defaults to 0.7 — both
+ * values match the upstream invinite reference. `valueAreaPct <= 1` is
+ * interpreted as a fraction and scaled to percent.
+ *
+ * @formula N/A — internal volume-profile slot scaffolding (see the four
+ *          `ta.*VolumeProfile` primitives for the math contract).
+ * @since 0.5
+ * @internal
+ * @stable
+ * @example
+ *     // const cfg = volumeProfileConfigFromOpts({ rowSize: 20, valueAreaPct: 0.7 });
+ */
+export declare function volumeProfileConfigFromOpts(opts: {
+    rowSize?: number;
+    valueAreaPct?: number;
+}): ProfileConfig;
+/**
+ * Apply a single-bucket fallback for windows where the full bucketizer
+ * cannot produce a profile (constant-price input, single-bar window,
+ * etc.). Returns `null` when no finite-close / positive-volume bar
+ * exists in the window.
+ *
+ * @formula N/A — internal volume-profile slot scaffolding (see the four
+ *          `ta.*VolumeProfile` primitives for the math contract).
+ * @since 0.5
+ * @internal
+ * @stable
+ * @example
+ *     // const fallback = degenerateVolumeProfile(bars, "#fff");
+ */
+export declare function degenerateVolumeProfile(bars: ReadonlyArray<VolumeProfileBar>, bucketColor: string | undefined): VolumeProfileSnapshot | null;
+/**
+ * Empty / NaN snapshot returned when no bars are in the window and
+ * the degenerate fallback also fails to produce one.
+ *
+ * @formula N/A — internal volume-profile slot scaffolding (see the four
+ *          `ta.*VolumeProfile` primitives for the math contract).
+ * @since 0.5
+ * @internal
+ * @stable
+ * @example
+ *     // const snap = emptyVolumeProfileSnapshot();
+ */
+export declare function emptyVolumeProfileSnapshot(): VolumeProfileSnapshot;
+/**
+ * Common "compute → apply bucketColor → fall back to degenerate"
+ * pipeline used by every VP primitive.
+ *
+ * @formula N/A — internal volume-profile slot scaffolding (see the four
+ *          `ta.*VolumeProfile` primitives for the math contract).
+ * @since 0.5
+ * @internal
+ * @stable
+ * @example
+ *     // const snap = resolveVolumeProfileSnapshot({ bars, config, bucketColor: "#fff" });
+ */
+export declare function resolveVolumeProfileSnapshot(args: {
+    bars: ReadonlyArray<VolumeProfileBar>;
+    config: ProfileConfig;
+    bucketColor: string | undefined;
+}): VolumeProfileSnapshot;
+/**
+ * Commit a snapshot to a slot's POC / VAH / VAL ring buffers. Append
+ * on close, replace-head on tick. Updates the `buckets` cache.
+ *
+ * @formula N/A — internal volume-profile slot scaffolding (see the four
+ *          `ta.*VolumeProfile` primitives for the math contract).
+ * @since 0.5
+ * @internal
+ * @stable
+ * @example
+ *     // commitVolumeProfileSnapshot(core, false, snap);
+ */
+export declare function commitVolumeProfileSnapshot(core: VolumeProfileCore, isTick: boolean, snapshot: VolumeProfileSnapshot): void;
+/**
+ * Emit the auto-generated `horizontal-histogram` PlotEmission for a
+ * VP primitive, or a deduped `unsupported-plot-kind` diagnostic when
+ * the adapter cannot render the kind. The dedup key includes the slot
+ * id so an indicator that reuses VP across multiple call sites still
+ * receives one diagnostic per call site, not per bar.
+ *
+ * @formula N/A — internal volume-profile slot scaffolding (see the four
+ *          `ta.*VolumeProfile` primitives for the math contract).
+ * @since 0.5
+ * @internal
+ * @stable
+ * @example
+ *     // emitVolumeProfileHistogram(ctx, slotId, "Anchored Volume Profile", snap.poc, snap.buckets);
+ */
+export declare function emitVolumeProfileHistogram(ctx: RuntimeContext, slotId: string, title: string, value: number, buckets: ReadonlyArray<HistogramBucket>): void;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/ta/lib/volume-profile/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../../src/ta/lib/volume-profile/scaffold.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAAE,KAAK,gBAAgB,EAA4C,MAAM,YAAY,CAAC;AAC7F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IACzC,OAAO,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC5B,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IACzC,OAAO,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;CAC3C,CAAC;AAMF;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAO3E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,aAAa,CAOhB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CACnC,IAAI,EAAE,aAAa,CAAC,gBAAgB,CAAC,EACrC,WAAW,EAAE,MAAM,GAAG,SAAS,GAChC,qBAAqB,GAAG,IAAI,CAmB9B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,IAAI,qBAAqB,CAOlE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IAC/C,IAAI,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IACtC,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,GAAG,qBAAqB,CAsBxB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CACvC,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,qBAAqB,GAChC,IAAI,CAWN;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CACtC,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,aAAa,CAAC,eAAe,CAAC,GACxC,IAAI,CA4BN"}

package/dist/ta/lib/volume-profile/scaffold.js

@@ -0,0 +1,209 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { pushDiagnostic, pushPlot } from "../../../emit/index.js";
+import { Float64RingBuffer } from "../../../ringBuffer.js";
+import { computeProfile } from "./index.js";
+const DEFAULT_ROW_SIZE = 24;
+const DEFAULT_VALUE_AREA_PCT = 0.7;
+const HISTOGRAM_SLOT_SUFFIX = "/histogram";
+/**
+ * Allocate the three Float64 ring buffers + an empty `buckets` array
+ * shared by every volume-profile slot.
+ *
+ * @formula N/A — internal volume-profile slot scaffolding (see the four
+ *          `ta.*VolumeProfile` primitives for the math contract).
+ * @since 0.5
+ * @internal
+ * @stable
+ * @example
+ *     // const core = createVolumeProfileCore(capacity);
+ */
+export function createVolumeProfileCore(capacity) {
+    return {
+        buckets: [],
+        pocBuffer: new Float64RingBuffer(capacity),
+        valHighBuffer: new Float64RingBuffer(capacity),
+        valLowBuffer: new Float64RingBuffer(capacity),
+    };
+}
+/**
+ * Normalise a primitive's options into the shared `ProfileConfig`.
+ * `rowSize` defaults to 24 and `valueAreaPct` defaults to 0.7 — both
+ * values match the upstream invinite reference. `valueAreaPct <= 1` is
+ * interpreted as a fraction and scaled to percent.
+ *
+ * @formula N/A — internal volume-profile slot scaffolding (see the four
+ *          `ta.*VolumeProfile` primitives for the math contract).
+ * @since 0.5
+ * @internal
+ * @stable
+ * @example
+ *     // const cfg = volumeProfileConfigFromOpts({ rowSize: 20, valueAreaPct: 0.7 });
+ */
+export function volumeProfileConfigFromOpts(opts) {
+    const rowSize = opts.rowSize;
+    const valueAreaPct = opts.valueAreaPct ?? DEFAULT_VALUE_AREA_PCT;
+    return {
+        rowSize: rowSize === undefined || rowSize <= 0 ? DEFAULT_ROW_SIZE : rowSize,
+        valueAreaPct: valueAreaPct <= 1 ? valueAreaPct * 100 : valueAreaPct,
+    };
+}
+/**
+ * Apply a single-bucket fallback for windows where the full bucketizer
+ * cannot produce a profile (constant-price input, single-bar window,
+ * etc.). Returns `null` when no finite-close / positive-volume bar
+ * exists in the window.
+ *
+ * @formula N/A — internal volume-profile slot scaffolding (see the four
+ *          `ta.*VolumeProfile` primitives for the math contract).
+ * @since 0.5
+ * @internal
+ * @stable
+ * @example
+ *     // const fallback = degenerateVolumeProfile(bars, "#fff");
+ */
+export function degenerateVolumeProfile(bars, bucketColor) {
+    let totalVolume = 0;
+    let price = Number.NaN;
+    for (const bar of bars) {
+        if (!Number.isFinite(bar.close))
+            continue;
+        price = bar.close;
+        if (Number.isFinite(bar.volume) && bar.volume > 0)
+            totalVolume += bar.volume;
+    }
+    if (!Number.isFinite(price) || totalVolume <= 0)
+        return null;
+    const bucket = bucketColor === undefined
+        ? { price, volume: totalVolume }
+        : { price, volume: totalVolume, color: bucketColor };
+    return {
+        buckets: [bucket],
+        poc: price,
+        valHigh: price,
+        valLow: price,
+    };
+}
+/**
+ * Empty / NaN snapshot returned when no bars are in the window and
+ * the degenerate fallback also fails to produce one.
+ *
+ * @formula N/A — internal volume-profile slot scaffolding (see the four
+ *          `ta.*VolumeProfile` primitives for the math contract).
+ * @since 0.5
+ * @internal
+ * @stable
+ * @example
+ *     // const snap = emptyVolumeProfileSnapshot();
+ */
+export function emptyVolumeProfileSnapshot() {
+    return {
+        buckets: [],
+        poc: Number.NaN,
+        valHigh: Number.NaN,
+        valLow: Number.NaN,
+    };
+}
+/**
+ * Common "compute → apply bucketColor → fall back to degenerate"
+ * pipeline used by every VP primitive.
+ *
+ * @formula N/A — internal volume-profile slot scaffolding (see the four
+ *          `ta.*VolumeProfile` primitives for the math contract).
+ * @since 0.5
+ * @internal
+ * @stable
+ * @example
+ *     // const snap = resolveVolumeProfileSnapshot({ bars, config, bucketColor: "#fff" });
+ */
+export function resolveVolumeProfileSnapshot(args) {
+    const { bars, config, bucketColor } = args;
+    const profile = bars.length === 0
+        ? null
+        : computeProfile({
+            config,
+            laneBars: bars,
+            windowFromIdx: 0,
+            windowToIdx: bars.length - 1,
+        });
+    if (profile !== null && profile.buckets.length > 0) {
+        return {
+            buckets: profile.buckets.map((bucket) => bucketColor === undefined ? bucket : { ...bucket, color: bucketColor }),
+            poc: profile.poc,
+            valHigh: profile.valHigh,
+            valLow: profile.valLow,
+        };
+    }
+    return degenerateVolumeProfile(bars, bucketColor) ?? emptyVolumeProfileSnapshot();
+}
+/**
+ * Commit a snapshot to a slot's POC / VAH / VAL ring buffers. Append
+ * on close, replace-head on tick. Updates the `buckets` cache.
+ *
+ * @formula N/A — internal volume-profile slot scaffolding (see the four
+ *          `ta.*VolumeProfile` primitives for the math contract).
+ * @since 0.5
+ * @internal
+ * @stable
+ * @example
+ *     // commitVolumeProfileSnapshot(core, false, snap);
+ */
+export function commitVolumeProfileSnapshot(core, isTick, snapshot) {
+    core.buckets = snapshot.buckets;
+    if (isTick) {
+        core.pocBuffer.replaceHead(snapshot.poc);
+        core.valHighBuffer.replaceHead(snapshot.valHigh);
+        core.valLowBuffer.replaceHead(snapshot.valLow);
+    }
+    else {
+        core.pocBuffer.append(snapshot.poc);
+        core.valHighBuffer.append(snapshot.valHigh);
+        core.valLowBuffer.append(snapshot.valLow);
+    }
+}
+/**
+ * Emit the auto-generated `horizontal-histogram` PlotEmission for a
+ * VP primitive, or a deduped `unsupported-plot-kind` diagnostic when
+ * the adapter cannot render the kind. The dedup key includes the slot
+ * id so an indicator that reuses VP across multiple call sites still
+ * receives one diagnostic per call site, not per bar.
+ *
+ * @formula N/A — internal volume-profile slot scaffolding (see the four
+ *          `ta.*VolumeProfile` primitives for the math contract).
+ * @since 0.5
+ * @internal
+ * @stable
+ * @example
+ *     // emitVolumeProfileHistogram(ctx, slotId, "Anchored Volume Profile", snap.poc, snap.buckets);
+ */
+export function emitVolumeProfileHistogram(ctx, slotId, title, value, buckets) {
+    if (!ctx.capabilities.plots.has("horizontal-histogram")) {
+        const key = `unsupported-plot-kind|${slotId}`;
+        if (ctx.diagnosedRequestKeys.has(key))
+            return;
+        ctx.diagnosedRequestKeys.add(key);
+        pushDiagnostic(ctx.emissions, {
+            kind: "diagnostic",
+            severity: "warning",
+            code: "unsupported-plot-kind",
+            message: 'Adapter cannot render plot kind "horizontal-histogram".',
+            slotId,
+            bar: ctx.barIndex(),
+        });
+        return;
+    }
+    const emission = {
+        bar: ctx.barIndex(),
+        color: null,
+        kind: "plot",
+        meta: {},
+        pane: "overlay",
+        slotId: `${slotId}${HISTOGRAM_SLOT_SUFFIX}`,
+        style: { kind: "horizontal-histogram", buckets },
+        time: ctx.stream.bar.time,
+        title,
+        value: Number.isFinite(value) ? value : null,
+    };
+    pushPlot(ctx.emissions, emission);
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/ta/lib/volume-profile/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../../../src/ta/lib/volume-profile/scaffold.ts"],"names":[],"mappings":"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"}

package/dist/ta/lib/volume-profile/tooHeavy.d.ts

@@ -0,0 +1,45 @@
+import type { RowsLayout, VolumeProfileCostStatus } from "./types.js";
+/**
+ * Finer-bar count threshold from the invinite profile renderer.
+ *
+ * @formula PLAN §9.2 — cap finer-bar scans for one profile compute.
+ * @since 0.5
+ * @internal
+ * @stable
+ * @example
+ *     // const max = VOLUME_PROFILE_HEAVY_THRESHOLD;
+ */
+export declare const VOLUME_PROFILE_HEAVY_THRESHOLD = 50000;
+/**
+ * Default maximum bucket count for a single pure profile compute.
+ *
+ * @formula PLAN §9.2 — cap bucket allocations for one profile compute.
+ * @since 0.5
+ * @internal
+ * @stable
+ * @example
+ *     // const max = VOLUME_PROFILE_MAX_BUCKETS;
+ */
+export declare const VOLUME_PROFILE_MAX_BUCKETS = 2000;
+/**
+ * Assess whether a volume-profile input window is too expensive and
+ * optionally recommend a coarser `rowSize` fallback.
+ *
+ * @formula PLAN §9.2 — guard range / rowSize combinations that would
+ *          allocate pathological bucket counts before bucketing.
+ * @since 0.5
+ * @internal
+ * @stable
+ * @example
+ *     // const status = assessVolumeProfileCost({ finerCandleCount: 1000, priceMin: 1, priceMax: 100, rowSize: 1, rowsLayout: "numberOfRows" });
+ */
+export declare function assessVolumeProfileCost(args: {
+    finerCandleCount: number;
+    rowSize?: number;
+    rowsLayout?: RowsLayout;
+    tickSize?: number;
+    priceMin?: number;
+    priceMax?: number;
+    maxBuckets?: number;
+}): VolumeProfileCostStatus;
+//# sourceMappingURL=tooHeavy.d.ts.map

package/dist/ta/lib/volume-profile/tooHeavy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooHeavy.d.ts","sourceRoot":"","sources":["../../../../src/ta/lib/volume-profile/tooHeavy.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAEtE;;;;;;;;;GASG;AACH,eAAO,MAAM,8BAA8B,QAAS,CAAC;AAErD;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAEhD;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC1C,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,uBAAuB,CAsB1B"}

package/dist/ta/lib/volume-profile/tooHeavy.js

@@ -0,0 +1,92 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// Ported from ../invinite/src/components/trading-chart/indicators/lib/volume-profile/too-heavy.ts
+//   @ 3234c8c0c3f9880d9d1e3a3ee63ebd55ddd535f4.
+// Translated, not transcribed — ReadonlyArray<number> inputs, JSDoc, runtime.
+// See packages/runtime/src/ta/CLAUDE.md for the port convention.
+/**
+ * Finer-bar count threshold from the invinite profile renderer.
+ *
+ * @formula PLAN §9.2 — cap finer-bar scans for one profile compute.
+ * @since 0.5
+ * @internal
+ * @stable
+ * @example
+ *     // const max = VOLUME_PROFILE_HEAVY_THRESHOLD;
+ */
+export const VOLUME_PROFILE_HEAVY_THRESHOLD = 50_000;
+/**
+ * Default maximum bucket count for a single pure profile compute.
+ *
+ * @formula PLAN §9.2 — cap bucket allocations for one profile compute.
+ * @since 0.5
+ * @internal
+ * @stable
+ * @example
+ *     // const max = VOLUME_PROFILE_MAX_BUCKETS;
+ */
+export const VOLUME_PROFILE_MAX_BUCKETS = 2_000;
+/**
+ * Assess whether a volume-profile input window is too expensive and
+ * optionally recommend a coarser `rowSize` fallback.
+ *
+ * @formula PLAN §9.2 — guard range / rowSize combinations that would
+ *          allocate pathological bucket counts before bucketing.
+ * @since 0.5
+ * @internal
+ * @stable
+ * @example
+ *     // const status = assessVolumeProfileCost({ finerCandleCount: 1000, priceMin: 1, priceMax: 100, rowSize: 1, rowsLayout: "numberOfRows" });
+ */
+export function assessVolumeProfileCost(args) {
+    if (args.finerCandleCount > VOLUME_PROFILE_HEAVY_THRESHOLD) {
+        return { heavy: true, reason: "too-many-finer-bars", recommendedRowSize: null };
+    }
+    const maxBuckets = args.maxBuckets ?? VOLUME_PROFILE_MAX_BUCKETS;
+    const estimate = estimateBucketCount(args);
+    if (estimate.kind === "estimated" && estimate.bucketCount > maxBuckets) {
+        return {
+            heavy: true,
+            reason: "too-many-buckets",
+            recommendedRowSize: args.rowsLayout === "ticksPerRow"
+                ? Math.ceil((estimate.priceMax - estimate.priceMin) /
+                    (maxBuckets * estimate.tickSize))
+                : Math.max(1, maxBuckets),
+        };
+    }
+    return { heavy: false, reason: null, recommendedRowSize: null };
+}
+function estimateBucketCount(args) {
+    const { priceMax, priceMin, rowSize } = args;
+    if (rowSize === undefined ||
+        priceMin === undefined ||
+        priceMax === undefined ||
+        !Number.isFinite(priceMin) ||
+        !Number.isFinite(priceMax) ||
+        rowSize <= 0 ||
+        priceMax <= priceMin) {
+        return { bucketCount: 0, kind: "invalid" };
+    }
+    const tickSize = args.tickSize ?? 0.01;
+    if (args.rowsLayout === "ticksPerRow") {
+        const width = rowSize * tickSize;
+        return width > 0
+            ? {
+                bucketCount: Math.ceil((priceMax - priceMin) / width),
+                kind: "estimated",
+                priceMax,
+                priceMin,
+                rowSize,
+                tickSize,
+            }
+            : { bucketCount: 0, kind: "invalid" };
+    }
+    return {
+        bucketCount: Math.floor(rowSize),
+        kind: "estimated",
+        priceMax,
+        priceMin,
+        rowSize,
+        tickSize,
+    };
+}
+//# sourceMappingURL=tooHeavy.js.map

package/dist/ta/lib/volume-profile/tooHeavy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooHeavy.js","sourceRoot":"","sources":["../../../../src/ta/lib/volume-profile/tooHeavy.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,kGAAkG;AAClG,gDAAgD;AAChD,8EAA8E;AAC9E,iEAAiE;AAIjE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,MAAM,CAAC;AAErD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,CAAC;AAEhD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAQvC;IACG,IAAI,IAAI,CAAC,gBAAgB,GAAG,8BAA8B,EAAE,CAAC;QACzD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC;IACpF,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,0BAA0B,CAAC;IACjE,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,IAAI,QAAQ,CAAC,WAAW,GAAG,UAAU,EAAE,CAAC;QACrE,OAAO;YACH,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,kBAAkB;YAC1B,kBAAkB,EACd,IAAI,CAAC,UAAU,KAAK,aAAa;gBAC7B,CAAC,CAAC,IAAI,CAAC,IAAI,CACL,CAAC,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;oBACnC,CAAC,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC,CACvC;gBACH,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC;SACpC,CAAC;IACN,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC;AACpE,CAAC;AAED,SAAS,mBAAmB,CAAC,IAM5B;IAUG,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC7C,IACI,OAAO,KAAK,SAAS;QACrB,QAAQ,KAAK,SAAS;QACtB,QAAQ,KAAK,SAAS;QACtB,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC1B,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC1B,OAAO,IAAI,CAAC;QACZ,QAAQ,IAAI,QAAQ,EACtB,CAAC;QACC,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC/C,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC;IACvC,IAAI,IAAI,CAAC,UAAU,KAAK,aAAa,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;QACjC,OAAO,KAAK,GAAG,CAAC;YACZ,CAAC,CAAC;gBACI,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,GAAG,QAAQ,CAAC,GAAG,KAAK,CAAC;gBACrD,IAAI,EAAE,WAAW;gBACjB,QAAQ;gBACR,QAAQ;gBACR,OAAO;gBACP,QAAQ;aACX;YACH,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC9C,CAAC;IACD,OAAO;QACH,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QAChC,IAAI,EAAE,WAAW;QACjB,QAAQ;QACR,QAAQ;QACR,OAAO;QACP,QAAQ;KACX,CAAC;AACN,CAAC"}