@djangocfg/widget-code

中文文档
0.1.23发布于 2026/11/11MITTypeScriptES Module近 30 天下载 3279

Code surfaces: a Monaco editor, a diff viewer, a JSON editor and the markdown renderer that embeds them

原始使用文档
文档目录4 节
  1. Install
  2. No root barrel worth importing
  3. Read-only code elsewhere
  4. Verify

@djangocfg/widget-code

Code surfaces: an editor, a diff, a highlighted listing, a JSON editor, and the markdown renderer that embeds them.

Install

pnpm add @djangocfg/widget-code @djangocfg/ui-core @djangocfg/i18n
SubpathWhatWeight
./editorMonaco, single file or diff~550 KB, lazy
./json-editoran editable JSON treejson-edit-react
./diff-viewerunified or split diff, virtualisedPrism + virtuoso
./diff-viewer/fullthe same, eagerly
./markdown-messagemarkdown with embedded code, diagrams and chips
./role-tokensthe ANCHOR / TOGGLE class contracts

No root barrel worth importing

Monaco alone is ~550 KB, and Prism and json-edit-react sit behind their own subpaths. The root exports the role tokens and nothing else, on purpose.

Read-only code elsewhere

PrettyCode (a read-only listing with a panel header, Prism) lives in @djangocfg/widget-kit/pretty-code, with /pretty-code/lazy for the deferred form; DiffViewer and MarkdownMessage here use it from there, and so does the chat's Response. @djangocfg/widget-media/code is a second, shiki listing with no consumer in this repo.

Verify

pnpm --filter @djangocfg/widget-code check-types test

版本与发布记录

@djangocfg/widget-code 共发布 19 个版本,首次发布于 2026/09/09;过去 12 个月发布了 19 个版本。

版本发布日期距今
0.1.23latest2026/11/111 天前
0.1.222026/11/111 天前
0.1.212026/11/102 天前
0.1.202026/11/102 天前
0.1.182026/11/057 天前
0.1.172026/11/047 天前

关于 @djangocfg/widget-code 的常见问题

@djangocfg/widget-code 是什么?

Code surfaces: a Monaco editor, a diff viewer, a JSON editor and the markdown renderer that embeds them

如何安装 @djangocfg/widget-code?

在项目目录运行 npm install @djangocfg/widget-code,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^19.0.0)、react-dom(^19.0.0)、lucide-react(^1.68.0)、@djangocfg/i18n(^2.1.648)、@djangocfg/ui-core(^2.1.648)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@djangocfg/widget-code 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@djangocfg/widget-code 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@djangocfg/widget-code 可以商用吗?

@djangocfg/widget-code 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@djangocfg/widget-code 的下载量有多少?

根据 npm 官方下载统计,@djangocfg/widget-code 在 2026/10/13 – 2026/11/11 这 30 天内被下载 3,279 次,日均约 109 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@djangocfg/widget-code 还在维护吗?

最新版本 0.1.23 发布于 2026/11/11(1 天前);至今共发布 19 个版本,其中过去 12 个月发布了 19 个;首次发布于 2026/09/09。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。