canirequire › Dual (CommonJS + ESM) › @storybook/blocks
Is @storybook/blocks ESM-only? Can you require() it?
Storybook Doc Blocks
Last verified Sep 9, 2026 against @storybook/blocks@8.6.14. Markdown · JSON
Dual (CommonJS + ESM) Dual package — require() works on every Node.js version we test; import works too
@storybook/blocks publishes both a CommonJS entry and a native ESM entry (ESM added in 7.0.0). require("@storybook/blocks") works on every Node.js version we test (18, 20, 22, 24 and 26) and in Bun. import "@storybook/blocks" works alongside it.
What to do
- Nothing to change. require("@storybook/blocks") works on every Node.js version we test (18, 20, 22, 24 and 26) and in Bun. import * as blocks from "@storybook/blocks" works alongside it; use named imports for what the ESM entry exports.
- TypeScript: types are bundled; install nothing extra.
Does @storybook/blocks@8.6.14 actually load? Runtime test results
Installed and executed on Sep 9, 2026 with require("@storybook/blocks") from a CommonJS file and import "@storybook/blocks" from an ES module.
| Runtime | require("@storybook/blocks") | import "@storybook/blocks" |
|---|---|---|
| Node.js 18 | ✓ works | ✗ failsReferenceError |
| Node.js 20 | ✓ works | ✗ failsReferenceError |
| Node.js 22 | ✓ works | ✗ failsReferenceError |
| Node.js 24 | ✓ works | ✗ failsReferenceError |
| Node.js 26 | ✓ works | ✗ failsReferenceError |
| Bun 1.4.0 | ✓ works | ✗ failsReferenceError |
How to import @storybook/blocks
ES modules (import)
import * as blocks from "@storybook/blocks";Namespace import shown because the ESM entry may have no default export; use named imports for what it exports.
CommonJS (require)
const blocks = require("@storybook/blocks");Module format by version
Derived from the type, main and exports fields of every stable release on npm, corrected where a runtime test of that version contradicted them (151 versions; the newest 60 shown).
| Versions | Format | First published |
|---|---|---|
| 8.1.7 – 8.6.18 | Dual (CommonJS + ESM) | Jun 12, 2024 |
Frequently asked
Is @storybook/blocks ESM-only?
@storybook/blocks@8.6.14 ships CommonJS and ESM builds. @storybook/blocks publishes both a CommonJS entry and a native ESM entry (ESM added in 7.0.0). require("@storybook/blocks") works on every Node.js version we test (18, 20, 22, 24 and 26) and in Bun. import "@storybook/blocks" works alongside it.
Can I require @storybook/blocks?
Yes. @storybook/blocks ships a CommonJS entry alongside the native ESM entry. require("@storybook/blocks") works on every Node.js version we test (18, 20, 22, 24 and 26) and in Bun.
Does @storybook/blocks work in Bun?
Importing @storybook/blocks failed in Bun 1.4.0 on Sep 9, 2026: ReferenceError: document is not defined
Does @storybook/blocks ship TypeScript types?
Yes. @storybook/blocks bundles its own type declarations; no @types package is needed.
Links
Other dual (commonjs + esm) packages
- minimatch 10.2.6Dual
- brace-expansion 5.0.9Dual
- lru-cache 11.5.2Dual
- tslib 2.8.1Dual
- glob 13.0.6Dual
- eslint-visitor-keys 5.0.1Dual
- yallist 5.0.0Dual
- balanced-match 4.0.4Dual
Similar popularity
- react-dnd 16.0.1ESM-only
- nock 14.0.17CommonJS
- @angular/platform-browser 22.1.5ESM-only
- echarts 6.1.0Dual
- @angular/forms 22.1.5ESM-only
- eslint-plugin-promise 7.3.0CommonJS
- @angular/router 22.1.5ESM-only
- stylelint-scss 7.2.0ESM-only