# @internetarchive/histogram-date-range

> Internet Archive histogram date range picker

Latest version **1.4.2** (published 2026-05-22) · AGPL-3.0-only license · 0 weekly downloads

> **Deprecated.** This package is deprecated.

## Install

```sh
npm install @internetarchive/histogram-date-range
pnpm add @internetarchive/histogram-date-range
yarn add @internetarchive/histogram-date-range
bun add @internetarchive/histogram-date-range
```

## Health

**Score 10/100 (F)** — status: deprecated.

Negative: deprecated.

## Facts

| | |
|---|---|
| Version | 1.4.2 |
| Published | 2026-05-22 |
| First published | 2021-02-02 |
| Weekly downloads | 0 |
| License | AGPL-3.0-only |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 3 |
| Unpacked size | 477.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | bfalling, mitraardron, vbanos, kngenie, iisa, cdrini, nsharma123, dualcnhq, latonv, ibnesayeed, tracey.pooh, jim-at-ia, jeffwklein, rebecca-shoptaw, jbuckner, dhallia |

## Links

- npm: https://www.npmjs.com/package/@internetarchive/histogram-date-range
- npm.io page: https://npm.io/package/@internetarchive/histogram-date-range

## Dependencies (3)

- [lit](https://npm.io/package/lit.md) ^2.8.0
- [dayjs](https://npm.io/package/dayjs.md) ^1.11.13
- [@internetarchive/ia-activity-indicator](https://npm.io/package/@internetarchive/ia-activity-indicator.md) ^0.0.6

## Recent versions

- 1.4.2 (latest) — 2026-05-22
- 1.4.2-alpha-webdev8495.0 (alpha) — 2026-05-22
- 1.4.1-alpha1 (canary) — 2025-12-23
- 1.4.1 — 2025-12-25
- 1.4.0 — 2025-09-24
- 1.4.0-alpha-webdev7756.1 — 2025-09-23
- 1.4.0-alpha-webdev7756.0 — 2025-09-16
- 1.3.2 — 2025-09-11
- 1.3.2-alpha-webdev7713.0 — 2025-09-09
- 1.3.1 — 2025-09-05
- 1.3.1-alpha-webdev7745.0 — 2025-09-05
- 1.3.0 — 2025-09-04
- 1.2.2-alpha-webdev7377.8 — 2025-09-03
- 1.2.2-alpha-webdev7377.7 — 2025-09-03
- 1.2.2-alpha-webdev7377.6 — 2025-09-03
- … 57 more at https://npm.io/package/@internetarchive/histogram-date-range/versions

## README

# \<histogram-date-range>

Check out the [interactive demo](https://internetarchive.github.io/iaux-histogram-date-range/demo/).

This webcomponent follows the [open-wc](https://github.com/open-wc/open-wc) recommendation.

Travis:
[![Build Status](https://travis-ci.com/internetarchive/iaux-histogram-date-range.svg?branch=main)](https://travis-ci.com/internetarchive/iaux-histogram-date-range)
CodeCov: [![codecov](https://codecov.io/gh/internetarchive/iaux-histogram-date-range/branch/main/graph/badge.svg)](https://codecov.io/gh/internetarchive/iaux-histogram-date-range)

## Installation

```bash
npm i @internetarchive/histogram-date-range
```

## Usage

```html
<script type="module">
  import 'histogram-date-range/dist/src/histogram-date-range.js';
</script>
<histogram-date-range
  width="300"
  height="50"
  tooltipWidth="140"
  dateFormat="DD MMM YYYY"
  style="
    --histogramDateRangeTooltipFontSize: 1rem;
    --histogramDateRangeInputWidth: 85px;
  "
  minDate="1400"
  maxDate="2021"
  minSelectedDate="1800"
  maxSelectedDate="1900"
  bins="[ 74, 67, 17, 66, 49, 93, 47, 61, 32, 46, 53, 2,
          13, 45, 28, 1, 8, 70, 37, 74, 67, 17, 66, 49, 93,
          47, 61, 70, 37, 74, 67, 17, 66, 49, 93, 47, 61, 32,
          32, 70, 37, 74, 67, 17, 66, 49, 93, 47, 61, 32
        ]"
></histogram-date-range>
```

A slot named `inputs-right-side` is available for inserting elements to the right
of the min/max date input fields, e.g.:

```html
<histogram-date-range>
  <button slot="inputs-right-side">Apply</button>
</histogram-date-range>
```

## Linting with ESLint, Prettier, and Types

To scan the project for linting errors, run

```bash
npm run lint
```

You can lint with ESLint and Prettier individually as well

```bash
npm run lint:eslint
```

```bash
npm run lint:prettier
```

To automatically fix many linting errors, run

```bash
npm run format
```

You can format using ESLint and Prettier individually as well

```bash
npm run format:eslint
```

```bash
npm run format:prettier
```

## Testing with Web Test Runner

To run the suite of Web Test Runner tests, run

```bash
npm run test
```

To run the tests in watch mode (for &lt;abbr title=&#34;test driven development&#34;&gt;TDD&lt;/abbr&gt;, for example), run

```bash
npm run test:watch
```

## Tooling configs

For most of the tools, the configuration is in the `package.json` to reduce the amount of files in your project.

If you customize the configuration a lot, you can consider moving them to individual files.

## Local Demo with `web-dev-server`

```bash
npm start
```

To run a local development server that serves the basic demo located in `demo/index.html`

---
_Source: https://npm.io/package/@internetarchive/histogram-date-range · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._