rolldown_plugin_json 0.1.0

Rolldown plugin for JSON file imports
Documentation

Maintenance Guide

A plugin for rolldown-vite that handles the transformation of JSON files into JavaScript modules, ported from Vite's jsonPlugin.

This plugin is exclusive to rolldown-vite and is not recommended for external use.

📦 What it does

This plugin processes JSON files and transforms them into JavaScript modules. The resulting JavaScript either directly exports the parsed JSON or provides a wrapper around JSON.parse() depending on the configuration.

🚀 Debug Usage

import { defineConfig } from 'rolldown';
import { jsonPlugin } from 'rolldown/experimental';

export default defineConfig({
  input: {
    entry: './main.ts',
  },
  plugins: [jsonPlugin({
    minify: false,
    namedExports: false,
    stringify: 'auto',
  })],
});

⚙️ Options

Option Type Description Default
minify boolean Whether to minify the JSON content (remove spaces and formatting) for stringify. false
namedExports boolean Whether to use named exports for JSON properties (useful for ESM compatibility). false
stringify JsonPluginStringify Determines when the JSON content should be stringified into a JSON.parse() call. "auto"

🧩 JsonPluginStringify

This option controls how the JSON content is processed:

  • "auto": Automatically decides whether to stringify the JSON based on file size.
  • true: Always stringify the content, even for small JSON files.
  • false: Never stringify, just export the JSON as is.