#引用 JSON 文件

Rslib 支持在代码中引用 JSON 文件，也支持引用 YAML 和 TOML 文件并将其转换为 JSON 格式。

#JSON 文件

你可以直接在 JavaScript 文件中引用 JSON 文件。

#默认引用

{
  "name": "foo",
  "items": [1, 2]
}

import example from './example.json';

console.log(example.name); // 'foo';
console.log(example.items); // [1, 2];

#具名引用

Rslib 同样支持通过 named import 来引用 JSON 文件。

下面是一个使用示例，假设源码如下：

import { name } from './example.json';

console.log(name); // 'foo';

会根据配置文件中的 产物结构 配置，输出如下产物：

var example_namespaceObject = {
  u: 'foo',
};
console.log(example_namespaceObject.u);

#使用 import attributes

在 bundle 模式下，Rslib 支持 import attributes，你可以通过 import attributes 来引入 JSON 文件：

import json from './example.json' with { type: 'json' };

在 bundleless 模式下，通过 import attributes 引入 JSON 文件时，需要确保产物中保留对 JSON 文件的引用，参考 文档 进行配置。

#YAML 文件

YAML 是一种数据序列化语言，通常用于编写配置文件。

通过添加 @rsbuild/plugin-yaml 插件，你可以在 JavaScript 中引用 .yaml 或 .yml 文件，它们会被自动转换为 JavaScript 对象。

npm add @rsbuild/plugin-yaml -D

#注册插件

你可以在 rslib.config.ts 文件中注册插件：

import { pluginYaml } from '@rsbuild/plugin-yaml';

export default {
  plugins: [pluginYaml()],
};

#示例

import example from './example.yaml';

console.log(example.hello); // 'world';
console.log(example.foo); // { bar: 'baz' };

#TOML 文件

TOML 是一种语义明显、易于阅读的配置文件格式。

通过添加 @rsbuild/plugin-toml 插件，你可以在 JavaScript 中引用 .toml 文件，它们会被自动转换为 JavaScript 对象。

npm add @rsbuild/plugin-toml -D

#注册插件

你可以在 rslib.config.ts 文件中注册插件：

import { pluginToml } from '@rsbuild/plugin-toml';

export default {
  plugins: [pluginToml()],
};

#示例

import example from './example.toml';

console.log(example.hello); // 'world';
console.log(example.foo); // { bar: 'baz' };

#类型声明

当你在 TypeScript 代码中引用 YAML 或 TOML 文件时，请在项目中创建 src/env.d.ts 文件，并添加相应的类型声明。

• 方法一：如果项目里安装了 @rslib/core 包，你可以直接引用 @rslib/core 提供的 预设类型：

/// <reference types="@rslib/core/types" />

• 方法二：手动添加需要的类型声明：

declare module '*.yaml' {
  const content: Record<string, any>;
  export default content;
}
declare module '*.yml' {
  const content: Record<string, any>;
  export default content;
}
declare module '*.toml' {
  const content: Record<string, any>;
  export default content;
}

#打包模式与输出

Rslib 支持在不同的打包模式下，JSON / YAML / TOML 文件以不同的形式输出。

#bundle

在 bundle 模式下（即 bundle: true），JSON 文件会被直接打包到 JavaScript 产物中，且 JSON 文件中没有被使用到的 key 会被 tree-shake 掉，TOML 和 YAML 文件同理。

#bundleless

在 bundleless 模式下（即 bundle: false），每个 JSON / YAML / TOML 文件会被转换为对应的 JavaScript 模块输出，JSON 文件会被转换为 JSON.parse 的形式并导出，YAML 和 TOML 文件会被转换为 JavaScript 对象并导出。

如果希望 JSON / YAML / TOML 文件按原样输出到产物目录，并且产物 JavaScript 文件中保留对这些文件的引用路径，可以通过以下方式完成：

1. 在 source.entry 入口文件的 glob 匹配中忽略 JSON / YAML / TOML 文件
2. 在 output.externals 中保留 JSON / YAML / TOML 文件的请求路径
3. 在产物输出中添加 output.copy 选项，指定 JSON / YAML / TOML 文件的输出路径

例如下面的配置将会将 src 目录下的所有 JSON 文件按原样输出：

export default defineConfig({
  lib: [
    {
      bundle: false,
      source: {
        entry: {
          index: ['./src/**', '!./src/**/*.json'],
        },
      },
      output: {
        copy: [{ from: './**/*.json', context: './src' }],
        externals: [/.*\.json$/],
      },
    },
  ],
});