@matchstick-trading/primitives 0.0.10

package/dist/index.d.ts

@@ -0,0 +1,82 @@
+export { numericWidth, primitiveAttributes } from './attributes.js';
+export type { Change, CursorMark, DiffStatus, PrimitiveAttributes, PrimitiveState, Quality, Side } from './attributes.js';
+export { Notice } from './Notice.js';
+export type { NoticeKind, NoticeProps } from './Notice.js';
+export { useLadderKeys } from './ladder-keys.js';
+export { LADDER_ROW_ATTRIBUTE, nextLadderRow, resolveLadderKey } from './core/ladder-keys.js';
+export type { LadderKeyAction } from './ladder-keys.js';
+export { Transport } from './Transport.js';
+export type { TransportRootProps, TransportSpeedProps } from './Transport.js';
+export { CURSOR_START, Cursor, sameCursor, useCursor } from './Cursor.js';
+export type { CursorBoundary, CursorRootProps, CursorState, CursorValue } from './Cursor.js';
+export { Scrubber, useScrubber } from './Scrubber.js';
+export type { ScrubberMarkProps, ScrubberRootProps, ScrubberThumbProps } from './Scrubber.js';
+export { clampFraction, fractionFromPointer, isActiveScrubPointer, isPrimaryScrubPointer, reduceScrubGesture, resolveScrubKey } from './core/scrubber-gesture.js';
+export type { ScrubGestureEvent, ScrubGestureResult, ScrubKeyAction, ScrubPointer } from './core/scrubber-gesture.js';
+export { DepthProfile } from './DepthProfile.js';
+export type { DepthProfileRootProps } from './DepthProfile.js';
+export { depthGeometry, depthLevelId, nextDepthIndex, resolveDepthKey } from './core/depth-profile.js';
+export type { DepthGeometry, DepthKeyAction, DepthLevel } from './core/depth-profile.js';
+export { DiffTable } from './DiffTable.js';
+export type { DiffTableRootProps } from './DiffTable.js';
+export { DIFF_CHANGE_LABEL, compareExact, diffRowId, holdDiffOrder, nextDiffIndex, nextDiffSort, resolveDiffKey, signedDelta, sortDiffRows } from './core/diff-table.js';
+export type { DiffChange, DiffKeyAction, DiffMove, DiffSort, DiffTableRow } from './core/diff-table.js';
+export { Tape } from './Tape.js';
+export type { TapeRootProps } from './Tape.js';
+export { TAPE_SIDE_LABEL, holdTape, newestFirst, nextTapeIndex, readTape, resolveTapeKey, tapeSummary, tapeTime } from './core/tape.js';
+export type { TapeIssue, TapeKeyAction, TapeMove, TapeRead, TapeRow, TapeSide, TapeTrade } from './core/tape.js';
+export { Ladder } from './Ladder.js';
+export type { LadderRootProps } from './Ladder.js';
+export { buildLadder } from './core/ladder.js';
+export type { LadderBuilt, LadderInput, LadderIssue, LadderLevelIn, LadderRow, LadderSide } from './core/ladder.js';
+export { Receipt } from './Receipt.js';
+export type { ReceiptRootProps } from './Receipt.js';
+export { receiptHash, receiptVerdict, resolveReceiptKey } from './core/receipt-rules.js';
+export type { ReceiptData, ReceiptHashOf, ReceiptVerdict } from './core/receipt-rules.js';
+export { SymbolSearch } from './SymbolSearch.js';
+export type { SymbolSearchRootProps } from './SymbolSearch.js';
+export { buildSymbolIndex, nextSymbolIndex, normalizeSymbolText, resolveSymbolKey, searchSymbols } from './core/symbol-search.js';
+export type { Instrument, MatchHow, MatchedOn, SearchOptions, SymbolIndex, SymbolKeyAction, SymbolMatch } from './core/symbol-search.js';
+export { Chart, useChart } from './Chart.js';
+export { heikinAshi } from './core/candles.js';
+export type { CandleStyle, ChartContext, ChartRootProps, TimeAxisProps } from './Chart.js';
+export { barInterval, chartFrame, clampPriceRange, dataPriceSpan, growViewport, indexOfTime, lastBars, panPriceRange, panViewport, priceTicks, resolveChartKey, tickDecimals, timeOfIndex, zoomPriceRange, zoomViewport } from './core/chart-scale.js';
+export type { CandleBar, ChartFrame, ChartFrameOptions, ChartInclude, PriceSpan, ChartKeyAction, ChartSize, ChartViewport } from './core/chart-scale.js';
+export { Study } from './Studies.js';
+export type { StudyBandProps, StudyLegendProps, StudyLineProps } from './Studies.js';
+export { atr, bollinger, ema, rsi, sma, sourcePrice, studyRange, visibleIndexes, vwap, wma } from './core/studies.js';
+export type { BollingerBands, StudySource, VwapBand, VwapOptions, VwapResult } from './core/studies.js';
+export { VolumeProfile } from './VolumeProfile.js';
+export type { VolumeProfileHistogramProps, VolumeProfileOptionsProps } from './VolumeProfile.js';
+export { indexRangeOfTime, volumeProfile } from './core/volume-profile.js';
+export type { ProfileRow, VolumeProfileOptions, VolumeProfileResult } from './core/volume-profile.js';
+export type { NameProps } from './accessible-name.js';
+export { Toolbar } from './Toolbar.js';
+export type { ToolbarButtonProps, ToolbarRootProps } from './Toolbar.js';
+export { Menu } from './Menu.js';
+export type { MenuItemProps, MenuListProps, MenuRadioItemProps, MenuRootProps, MenuTriggerProps } from './Menu.js';
+export { Submenu } from './Submenu.js';
+export { Drawings, useDrawings } from './Drawings.js';
+export type { DrawingsEditProps, DrawingsListProps, DrawingsLockProps, DrawingsRemoveProps, DrawingsRootProps, DrawingsToolbarProps, DrawingsUndoProps } from './Drawings.js';
+export { ATTACH_LABELS, ATTACH_MODES, DRAWING_TOOLS, DRAWING_TOOL_LABELS, FIB_RATIOS, anchorCount, attachOf, barTime, barsFromFirst, barsFromLast, timeOfBarFromLast, describeAnchor, describeDrawing, drawingGeometry, drawingPriceRanges, editDrawing, hitTest, moveAnchor, moveDrawing, nextDrawingId, nudgeAmount, resolveDrawingKey, snapToBar } from './core/drawings.js';
+export type { AttachMode, Drawing, DrawingAnchor, DrawingGeometry, DrawingHit, DrawingKeyAction, DrawingTool, SnapMode } from './core/drawings.js';
+export { Selection, Series } from './Selection.js';
+export type { SelectionRootProps, SeriesRootProps } from './SelectionParts.js';
+export { describeSelection, sameSelection, selectionAfterClearTap, selectionAfterEscape, selectionAfterTap } from './core/selection.js';
+export type { ChartSelection, SelectionNames } from './core/selection.js';
+export { CsvDrop } from './CsvDrop.js';
+export type { CsvDropLoad, CsvDropRootProps } from './CsvDrop.js';
+export { describeBarsCsv, parseBarsCsv } from './core/csv-bars.js';
+export type { CsvBarsError, CsvBarsNote, CsvBarsOptions, CsvBarsResult, CsvExtraColumn } from './core/csv-bars.js';
+export { Fullscreen, useFullscreen } from './Fullscreen.js';
+export type { FullscreenFrameProps, FullscreenState, FullscreenToggleProps } from './Fullscreen.js';
+export { FULLSCREEN_LABEL, FULLSCREEN_MESSAGE, resolveFullscreenEscape } from './core/fullscreen.js';
+export type { FullscreenEscape } from './core/fullscreen.js';
+export { Panels, usePanels } from './Panels.js';
+export type { PanelsListProps, PanelsMoveProps, PanelsRootProps } from './PanelsParts.js';
+export type { PanelSeriesData } from './panels-context.js';
+export { AXIS_BOTTOM, MAIN_PANEL, describeMove, moveSeries, moveTargets, normalizeLayout, panelBands, panelOf, reconcileLayout } from './core/panels.js';
+export type { MoveDestination, MoveTarget, PanelBand, PanelLayout, PanelSeriesRequest, PanelSpec } from './core/panels.js';
+export { POINT_KINDS, alignSeries, csvAdapter, duplicateIds, pointsFromValues, report, resolveSeries, seriesSetSchema, toSeriesSet, validateSeriesSet } from './core/index.js';
+export type { AdapterIssue, AdapterResult, AlignMode, AlignOptions, AlignedSeries, AlignedState, CsvAdapterOptions, DataAdapter, DataSeries, FindingKind, PointKind, ResolvedSeries, SeriesCalendar, SeriesFinding, SeriesInput, SeriesIssue, SeriesPoint, SeriesSet, SeriesValidation } from './core/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,42 @@
+export { numericWidth, primitiveAttributes } from './attributes.js';
+export { Notice } from './Notice.js';
+export { useLadderKeys } from './ladder-keys.js';
+export { LADDER_ROW_ATTRIBUTE, nextLadderRow, resolveLadderKey } from './core/ladder-keys.js';
+export { Transport } from './Transport.js';
+export { CURSOR_START, Cursor, sameCursor, useCursor } from './Cursor.js';
+export { Scrubber, useScrubber } from './Scrubber.js';
+export { clampFraction, fractionFromPointer, isActiveScrubPointer, isPrimaryScrubPointer, reduceScrubGesture, resolveScrubKey } from './core/scrubber-gesture.js';
+export { DepthProfile } from './DepthProfile.js';
+export { depthGeometry, depthLevelId, nextDepthIndex, resolveDepthKey } from './core/depth-profile.js';
+export { DiffTable } from './DiffTable.js';
+export { DIFF_CHANGE_LABEL, compareExact, diffRowId, holdDiffOrder, nextDiffIndex, nextDiffSort, resolveDiffKey, signedDelta, sortDiffRows } from './core/diff-table.js';
+export { Tape } from './Tape.js';
+export { TAPE_SIDE_LABEL, holdTape, newestFirst, nextTapeIndex, readTape, resolveTapeKey, tapeSummary, tapeTime } from './core/tape.js';
+export { Ladder } from './Ladder.js';
+export { buildLadder } from './core/ladder.js';
+export { Receipt } from './Receipt.js';
+export { receiptHash, receiptVerdict, resolveReceiptKey } from './core/receipt-rules.js';
+export { SymbolSearch } from './SymbolSearch.js';
+export { buildSymbolIndex, nextSymbolIndex, normalizeSymbolText, resolveSymbolKey, searchSymbols } from './core/symbol-search.js';
+export { Chart, useChart } from './Chart.js';
+export { heikinAshi } from './core/candles.js';
+export { barInterval, chartFrame, clampPriceRange, dataPriceSpan, growViewport, indexOfTime, lastBars, panPriceRange, panViewport, priceTicks, resolveChartKey, tickDecimals, timeOfIndex, zoomPriceRange, zoomViewport } from './core/chart-scale.js';
+export { Study } from './Studies.js';
+export { atr, bollinger, ema, rsi, sma, sourcePrice, studyRange, visibleIndexes, vwap, wma } from './core/studies.js';
+export { VolumeProfile } from './VolumeProfile.js';
+export { indexRangeOfTime, volumeProfile } from './core/volume-profile.js';
+export { Toolbar } from './Toolbar.js';
+export { Menu } from './Menu.js';
+export { Submenu } from './Submenu.js';
+export { Drawings, useDrawings } from './Drawings.js';
+export { ATTACH_LABELS, ATTACH_MODES, DRAWING_TOOLS, DRAWING_TOOL_LABELS, FIB_RATIOS, anchorCount, attachOf, barTime, barsFromFirst, barsFromLast, timeOfBarFromLast, describeAnchor, describeDrawing, drawingGeometry, drawingPriceRanges, editDrawing, hitTest, moveAnchor, moveDrawing, nextDrawingId, nudgeAmount, resolveDrawingKey, snapToBar } from './core/drawings.js';
+export { Selection, Series } from './Selection.js';
+export { describeSelection, sameSelection, selectionAfterClearTap, selectionAfterEscape, selectionAfterTap } from './core/selection.js';
+export { CsvDrop } from './CsvDrop.js';
+export { describeBarsCsv, parseBarsCsv } from './core/csv-bars.js';
+export { Fullscreen, useFullscreen } from './Fullscreen.js';
+export { FULLSCREEN_LABEL, FULLSCREEN_MESSAGE, resolveFullscreenEscape } from './core/fullscreen.js';
+export { Panels, usePanels } from './Panels.js';
+export { AXIS_BOTTOM, MAIN_PANEL, describeMove, moveSeries, moveTargets, normalizeLayout, panelBands, panelOf, reconcileLayout } from './core/panels.js';
+// The series contract and the adapters (also under ./core): points with a clock, the boundary check, the report, the CSV adapter.
+export { POINT_KINDS, alignSeries, csvAdapter, duplicateIds, pointsFromValues, report, resolveSeries, seriesSetSchema, toSeriesSet, validateSeriesSet } from './core/index.js';

package/dist/ladder-keys.d.ts

@@ -0,0 +1,16 @@
+import { type KeyboardEvent } from 'react';
+export { LADDER_ROW_ATTRIBUTE, nextLadderRow, resolveLadderKey, type LadderKeyAction, type LadderKeyInput } from './core/ladder-keys.js';
+/**
+ * Roving focus for the ladder rows. Spread `containerProps` on the element wrapping every row, give each row `data-ladder-row={id}` and
+ * `tabIndex={id === tabStop(ids, bestBidId) ? 0 : -1}`, where `id` is the row's price level (identity is the price, not the index).
+ */
+export declare function useLadderKeys(): {
+    containerProps: {
+        ref: (node: HTMLElement | null) => void;
+        onKeyDown: (event: KeyboardEvent<HTMLElement>) => void;
+        onFocus: (event: React.FocusEvent<HTMLElement>) => void;
+    };
+    /** The id of the one row that is a tab stop: the focused row while it is still on screen, else `fallback` (the best bid, or the best ask when there are no bids). */
+    tabStop: (ids: readonly string[], fallback: string | undefined) => string | undefined;
+};
+//# sourceMappingURL=ladder-keys.d.ts.map

package/dist/ladder-keys.js

@@ -0,0 +1,86 @@
+'use client';
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { isRowShown, LADDER_ROW_ATTRIBUTE, nextLadderRow, resolveLadderKey } from './core/ladder-keys.js';
+// The pure contract lives in the core (no React); the hook below is the React layer over it.
+export { LADDER_ROW_ATTRIBUTE, nextLadderRow, resolveLadderKey } from './core/ladder-keys.js';
+/**
+ * Roving focus for the ladder rows. Spread `containerProps` on the element wrapping every row, give each row `data-ladder-row={id}` and
+ * `tabIndex={id === tabStop(ids, bestBidId) ? 0 : -1}`, where `id` is the row's price level (identity is the price, not the index).
+ */
+export function useLadderKeys() {
+    const container = useRef(null);
+    const [active, setActive] = useState(null);
+    const onKeyDown = useCallback((event) => {
+        if (!(event.target instanceof HTMLElement))
+            return;
+        const action = resolveLadderKey(event);
+        // A read-only row is a plain div with no activation of its own: Space on it does nothing, and must not scroll the page
+        // or reach the transport's play/pause. (A seeking row is a button, which handles Space itself.)
+        const row = event.target.closest(`[${LADDER_ROW_ATTRIBUTE}]`);
+        if (event.key === ' ' && !event.altKey && !event.ctrlKey && !event.metaKey && !event.shiftKey && row && row.tagName !== 'BUTTON') {
+            event.preventDefault();
+            event.stopPropagation();
+            return;
+        }
+        if (!action) {
+            // A modified Home or End has no ladder meaning, but must not reach the global transport jump either.
+            if ((event.key === 'Home' || event.key === 'End') && event.target.closest(`[${LADDER_ROW_ATTRIBUTE}]`))
+                event.stopPropagation();
+            return;
+        }
+        const host = container.current;
+        if (!host)
+            return;
+        // Rows inside a closed disclosure are in the DOM but not on screen: they are not part of the walk.
+        const rows = Array.from(host.querySelectorAll(`[${LADDER_ROW_ATTRIBUTE}]`)).filter(isRowShown);
+        const current = event.target.closest(`[${LADDER_ROW_ATTRIBUTE}]`);
+        if (!current)
+            return;
+        event.preventDefault();
+        event.stopPropagation(); // Home and End must not reach the global transport shortcuts from here
+        const target = nextLadderRow(rows, current, action);
+        if (!target)
+            return;
+        setActive(target.getAttribute(LADDER_ROW_ATTRIBUTE));
+        target.focus();
+    }, []);
+    const onFocus = useCallback((event) => {
+        const row = event.target.closest(`[${LADDER_ROW_ATTRIBUTE}]`);
+        if (row)
+            setActive(row.getAttribute(LADDER_ROW_ATTRIBUTE));
+    }, []);
+    // The row that holds the tab stop can also leave the screen without a toggle: a replay update can push it past the visible
+    // levels into a closed disclosure. After each render, hand the stop back if it is no longer shown (it sets state only then).
+    useEffect(() => {
+        const host = container.current;
+        if (!host || active === null)
+            return;
+        const stop = Array.from(host.querySelectorAll(`[${LADDER_ROW_ATTRIBUTE}]`)).find((r) => r.getAttribute(LADDER_ROW_ATTRIBUTE) === active);
+        if (!stop || !isRowShown(stop))
+            setActive(null);
+    });
+    // A disclosure that closes hides the row that held the tab stop; `toggle` does not bubble, so listen in the capture phase.
+    useEffect(() => {
+        const host = container.current;
+        if (!host)
+            return;
+        const onToggle = () => {
+            const stop = host.querySelector(`[${LADDER_ROW_ATTRIBUTE}][tabindex="0"]`);
+            if (stop && !isRowShown(stop))
+                setActive(null);
+        };
+        host.addEventListener('toggle', onToggle, true);
+        return () => host.removeEventListener('toggle', onToggle, true);
+    }, []);
+    return {
+        containerProps: {
+            ref: (node) => {
+                container.current = node;
+            },
+            onKeyDown,
+            onFocus,
+        },
+        /** The id of the one row that is a tab stop: the focused row while it is still on screen, else `fallback` (the best bid, or the best ask when there are no bids). */
+        tabStop: (ids, fallback) => active !== null && ids.includes(active) ? active : fallback,
+    };
+}

package/dist/panels-context.d.ts

@@ -0,0 +1,47 @@
+import type { CandleBar, PriceSpan } from './core/chart-scale.js';
+import type { MoveDestination, PanelLayout } from './core/panels.js';
+import type { ResolvedSeries, SeriesPoint } from './core/series.js';
+/**
+ * One series a host puts on the chart besides its bars. Give it `points` (a time and a value or a reason for none, see
+ * `core/series`); it is placed on the bars by time. `values` (one number per bar, by position) still works for now and is
+ * removed in 0.0.7.
+ */
+export interface PanelSeriesData {
+    /** The selection id. Unique on the chart. */
+    id: string;
+    /** What the series is called: button names, the list and the live-region text. */
+    label: string;
+    /** The series on its own clock. Placed on the bars by time (`align` on `Panels.Root`; exact by default). */
+    points?: ReadonlyArray<SeriesPoint>;
+    /**
+     * @deprecated One value per bar by position, null for none. A length that differs from the bars is shown as a problem
+     * in `Panels.List`. Removed in 0.0.7; use `points` (for a study, `pointsFromValues` from the core makes them).
+     */
+    values?: ReadonlyArray<number | null>;
+    /** A fixed vertical range `[min, max]` for the band the series is in (an oscillator bounded 0 to 100). Ignored in `main`. */
+    range?: readonly [number, number];
+    /** Horizontal reference lines in the band, for example `[30, 70]`. Ignored in `main`. */
+    levels?: readonly number[];
+    /** `line` (default), or `histogram`: bars from zero, for a signed series. */
+    style?: 'line' | 'histogram';
+}
+/**
+ * The context behind Panels, in a module of its own so Chart can read the layout without importing the parts (which
+ * import Chart).
+ */
+export interface PanelsContextValue {
+    series: readonly PanelSeriesData[];
+    layout: PanelLayout;
+    move: (seriesId: string, destination: MoveDestination) => void;
+    /** Prices of the series sitting in `main`, so the main scale keeps them in view. */
+    mainInclude: (visible: {
+        first: number;
+        last: number;
+    }, bars: readonly CandleBar[]) => readonly PriceSpan[];
+    /** A series on these bars: the value at each bar and the problems with the input. Cached per bars array and series. */
+    resolve: (item: PanelSeriesData, bars: readonly CandleBar[]) => ResolvedSeries;
+    /** Problems that belong to the set, not one series (an id used twice). */
+    problems: readonly string[];
+}
+export declare const PanelsContext: import("react").Context<PanelsContextValue | null>;
+//# sourceMappingURL=panels-context.d.ts.map

package/dist/panels-context.js

@@ -0,0 +1,3 @@
+'use client';
+import { createContext } from 'react';
+export const PanelsContext = createContext(null);

package/dist/selection-context.d.ts

@@ -0,0 +1,41 @@
+import { type MutableRefObject } from 'react';
+import type { ChartSelection } from './core/selection.js';
+/**
+ * The contexts behind Selection and Series, in a module of their own so Chart, Drawings and Studies can read them
+ * without importing the parts (which import Chart).
+ */
+/** What Drawings.Layer tells the Selection.Layer so a press on a drawing, or while a tool is in use, is not read as a tap on clear chart. */
+export interface SelectionGuard {
+    /** True when a press here belongs to a drawing or to a tool in use. */
+    owns: (clientX: number, clientY: number, pointerType: string) => boolean;
+    /** True while a tool is armed or a drawing is half placed: Escape then cancels that first. */
+    busy: () => boolean;
+}
+export interface SelectionContextValue {
+    /** The selection now. */
+    selection: ChartSelection;
+    /** Change the selection. Setting what is already selected does nothing, so two parts agreeing on a tap report once. */
+    select: (next: ChartSelection) => void;
+    /** The selection as of the last change, even before the next render. */
+    current: () => ChartSelection;
+    /** The series a Series.Root mounted, or null. A tap on clear chart selects it. */
+    series: {
+        id: string;
+        label: string;
+    } | null;
+    registerSeries: (series: {
+        id: string;
+        label: string;
+    }) => () => void;
+    /** A name for the live region; the id is used when none is set. Returns the cleanup. */
+    setName: (kind: 'drawing' | 'series' | 'study', id: string, name: string) => () => void;
+    guard: MutableRefObject<SelectionGuard | null>;
+}
+export declare const SelectionContext: import("react").Context<SelectionContextValue | null>;
+export interface SeriesContextValue {
+    id: string;
+    label: string;
+    selected: boolean;
+}
+export declare const SeriesContext: import("react").Context<SeriesContextValue | null>;
+//# sourceMappingURL=selection-context.d.ts.map

package/dist/selection-context.js

@@ -0,0 +1,4 @@
+'use client';
+import { createContext } from 'react';
+export const SelectionContext = createContext(null);
+export const SeriesContext = createContext(null);

package/examples/csv-to-chart-frame.mjs

@@ -0,0 +1,17 @@
+// Core without React: parse a bars CSV, then compute the chart frame a renderer would draw.
+// Synthetic data only. Run: node examples/csv-to-chart-frame.mjs
+import { parseBarsCsv, describeBarsCsv, chartFrame, lastBars } from '@matchstick-trading/primitives/core';
+
+const csv = [
+  'timestamp,open,high,low,close,volume',
+  '1700000000000,100,102,99,101,1200',
+  '1700000060000,101,103,100,102,900',
+  '1700000120000,102,102.5,98,99,1500',
+  '1700000180000,99,101,98.5,100.5,700',
+].join('\n');
+
+const result = parseBarsCsv(csv);
+console.log(describeBarsCsv(result, 'synthetic.csv'));
+
+const frame = chartFrame(result.bars, lastBars(result.bars.length, 4), { width: 600, height: 300 });
+console.log('visible bars:', frame.first, 'to', frame.last, 'price', frame.priceMin, 'to', frame.priceMax);

package/examples/studies.mjs

@@ -0,0 +1,12 @@
+// Core without React: indicator series on synthetic bars. Run: node examples/studies.mjs
+import { sma, ema, rsi } from '@matchstick-trading/primitives/core';
+
+const bars = Array.from({ length: 30 }, (_, i) => {
+  const close = 100 + Math.sin(i / 3) * 5 + i * 0.2;
+  return { timestamp: 1700000000000 + i * 60000, open: close - 0.4, high: close + 1, low: close - 1, close, volume: 1000 + i * 10 };
+});
+
+const last = (series) => series[series.length - 1];
+console.log('sma(10):', last(sma(bars, 10)));
+console.log('ema(10):', last(ema(bars, 10)));
+console.log('rsi(14):', last(rsi(bars, 14)));

package/llms.txt

@@ -0,0 +1,16 @@
+# Matchstick Primitives
+
+> Headless, keyboard-first React parts for trading screens, with a plain-TypeScript core. Developer preview 0.0.10. Every example uses synthetic data.
+
+- [README.md](README.md): the parts, a first chart, the core, your own data.
+- [AGENTS.md](AGENTS.md): what an agent may do with this package, what to ask first, what not to do.
+- [dist/index.d.ts](dist/index.d.ts): every part, prop and type, with doc comments.
+- [dist/core/index.d.ts](dist/core/index.d.ts): the React-free core (geometry, studies, drawing model, CSV reader, key maps).
+- [src/tokens.css](src/tokens.css): design tokens (`--mt-*`), imported as `@matchstick-trading/primitives/tokens.css`.
+- Docs: https://ui.matchstick.trading/docs/getting-started
+- Licence: Apache-2.0 (LICENSE). Source is in src/. Free building blocks for trading screens; issues are open at https://github.com/matchstick-trading/primitives/issues.
+- Live demo: https://ui.matchstick.trading/docs/live (made-up data).
+- Full screen: `Fullscreen.Frame` wraps the chart and `Fullscreen.Toggle` (inside it) enters and leaves; the browser's full screen where there is one, a full-page fallback otherwise (README, "Full screen"). Escape clears the chart's crosshair or selection first, then leaves.
+- Selection: `Selection.Root`, `Selection.Layer`, `Series.Root`, `Series.Select`, `Series.Options` and an `id` on `Study.Line` / `Study.Band` give one selection (drawing, series or study). Rules and parts are in README.md, "Select the series and studies". Series options are the host's to fill.
+- Series: a series is `{ id, label, points[] }` with `{ t, kind, v? }` points (ISO-8601 UTC `t`; kinds `value`, `missing`, `market-closed`, `not-applicable`, `halted`, `unknown`); `Panels.Root` and `Study.Line` take `points`; bare `values` is a shim that is still accepted in this version and will be removed in a later one. `csvAdapter`, `validateSeriesSet`, `report` are in the core. See README.md, "Give a series a clock".
+- Panels: `Panels.Root` (series and bands), `Panels.Layer` (inside `Chart.Plot`), `Panels.List` and `Panels.Move` put more than one series on a chart in bands with their own price scales, and move a series between bands by buttons, not a drag. The bars, volume and drawings stay in the first band. Rules and parts are in README.md, "Panels and several series".

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@matchstick-trading/primitives",
+  "version": "0.0.10",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/matchstick-trading/primitives.git",
+    "directory": "packages/primitives"
+  },
+  "homepage": "https://ui.matchstick.trading",
+  "bugs": {
+    "url": "https://github.com/matchstick-trading/primitives/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Matchstick Primitives: composable, headless chart and replay parts (developer preview)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js"
+    },
+    "./tokens.css": "./src/tokens.css"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.map",
+    "src",
+    "!src/**/*.test.*",
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md",
+    "AGENTS.md",
+    "llms.txt",
+    "examples"
+  ],
+  "scripts": {
+    "build": "tsc && node scripts/add-use-client.mjs",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit && node scripts/check-core.mjs",
+    "check:core": "node scripts/check-core.mjs",
+    "check:pack": "node scripts/check-pack.mjs",
+    "prepublishOnly": "npm run build && npm run check:pack"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "react": "^19.2.0",
+    "typescript": "~5.8.2",
+    "vitest": "^2.1.4"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  }
+}

package/src/Chart.tsx

@@ -0,0 +1,7 @@
+import { Root, Plot, Grid, Candles, Volume, PriceAxis, TimeAxis, Crosshair, Readout, Reset, Autoscale, Table } from './ChartParts.js';
+
+// The parts live in ChartParts.js (a client module). The namespace object is built here, outside it, so a server
+// component can write `Chart.Root`: a property of an object exported from a client module is not reachable there.
+export * from './ChartParts.js';
+export { heikinAshi } from './core/candles.js';
+export const Chart = { Root, Plot, Grid, Candles, Volume, PriceAxis, TimeAxis, Crosshair, Readout, Reset, Autoscale, Table };