# OHLC bar inspection
Render OHLC stems and ticks, then query committed nearest and painted bars.

## APIs demonstrated

- [OhlcBarSeries](/reference/functions/financial-series/) from `@pibbl/core/viz`
- [OhlcBarSeriesProps](/reference/functions/financial-series/) from `@pibbl/core/viz`
- [OhlcBarSeriesStyle](/reference/functions/financial-series/) from `@pibbl/core/viz`
- [useOhlcBarInspection](/reference/functions/financial-series/) from `@pibbl/core/viz/inspection`
- [nearestRecordedOhlcBarX](/reference/functions/financial-series/) from `@pibbl/core/viz/inspection`
- [paintedOhlcBarAt](/reference/functions/financial-series/) from `@pibbl/core/viz/inspection`
- [OhlcBarObservation](/reference/functions/financial-series/) from `@pibbl/core/viz/inspection`
- [OhlcBarInspectionCandidate](/reference/functions/financial-series/) from `@pibbl/core/viz/inspection`
- [NearestOhlcBarHit](/reference/functions/financial-series/) from `@pibbl/core/viz/inspection`
- [PaintedOhlcBarHit](/reference/functions/financial-series/) from `@pibbl/core/viz/inspection`
- [OhlcBarInspectionRef](/reference/functions/financial-series/) from `@pibbl/core/viz/inspection`
- [OhlcBarRenderedSeries](/reference/functions/financial-series/) from `@pibbl/core/viz/inspection`

## Complete example

[Plain source](/minimal/viz/financial-ohlc-bars.tsx). This example demonstrates a type-level or host-specific contract; it is checked with TypeScript rather than presented as an animated preview.

```tsx
import { pibbl } from "@pibbl/core";
import {
  LinearScale,
  OhlcBarSeries,
  UTCScale,
  type OhlcBarSeriesProps,
  type OhlcBarSeriesStyle,
} from "@pibbl/core/viz";
import {
  nearestRecordedOhlcBarX,
  paintedOhlcBarAt,
  useOhlcBarInspection,
  type NearestOhlcBarHit,
  type OhlcBarInspectionCandidate,
  type OhlcBarInspectionRef,
  type OhlcBarObservation,
  type OhlcBarRenderedSeries,
  type PaintedOhlcBarHit,
} from "@pibbl/core/viz/inspection";

interface Price {
  time: number;
  open: number;
  high: number;
  low: number;
  close: number;
}
const prices: readonly Price[] = [
  { time: 1_000, open: 10, high: 14, low: 8, close: 12 },
];
const props: OhlcBarSeriesProps<Price> = {
  data: prices,
  time: "time",
  open: "open",
  high: "high",
  low: "low",
  close: "close",
  xScale: "time",
  yScale: "price",
};
const style: OhlcBarSeriesStyle = {
  bandwidth: 8,
  stroke: "#00876e",
  strokeWidth: 1.2,
};
const insideCommittedClips = (
  candidate: OhlcBarInspectionCandidate<Price>,
): boolean => candidate.anchorInsideClips();
function inspectCommitted(inspection: OhlcBarInspectionRef<Price>):
  | Readonly<{
      observation: OhlcBarObservation<Price> | undefined;
      nearest: NearestOhlcBarHit<Price> | undefined;
      painted: PaintedOhlcBarHit<Price> | undefined;
    }>
  | undefined {
  const rendered: OhlcBarRenderedSeries<Price> | undefined =
    inspection.rendered();
  if (!rendered) return undefined;
  const nearest: NearestOhlcBarHit<Price> | undefined = nearestRecordedOhlcBarX(
    rendered,
    {
      time: prices[0]!.time,
      filter: insideCommittedClips,
    },
  );
  const observation: OhlcBarObservation<Price> | undefined = nearest;
  const painted: PaintedOhlcBarHit<Price> | undefined = nearest
    ? paintedOhlcBarAt(rendered, { rootPoint: nearest.anchorRoot })
    : undefined;
  return { observation, nearest, painted };
}
function Bars() {
  const inspection: OhlcBarInspectionRef<Price> = useOhlcBarInspection(props);
  return (
    <OhlcBarSeries
      {...props}
      inspection={inspection}
      onClick={() => void inspectCommitted(inspection)}
      style={style}
    />
  );
}
export function FinancialOhlcBars() {
  return (
    <UTCScale id="time" domain={[0, 2_000]} range={[0, 100]}>
      <LinearScale id="price" domain={[0, 20]} range={[100, 0]}>
        <Bars />
      </LinearScale>
    </UTCScale>
  );
}

const canvas = document.createElement("canvas");
canvas.width = 120;
canvas.height = 120;
document.body.append(canvas);
const app = pibbl(canvas, <FinancialOhlcBars />);
window.addEventListener("pagehide", () => app.dispose(), { once: true });

```

## Usage notes



## Documentation version

Documentation built with @pibbl/core 0.0.2, revision dd39ce2. ALPHA — NOT FOR PRODUCTION USE.