Extensions

第三方库与渲染后端

适用版本：v1.1.0。版本兼容说明

独立第三方库模板

项目提供可独立测试的 starter 模板，包含公开库注册、版本要求、自定义图形/数字格式化器、表格样式及后端代理示例。

扩展应通过公开接口调用宏包，不直接依赖内部变量。将第三方库文件与宏包模块放在 TeX 搜索路径内，再于导言区注册、加载。使用 \gradbarsrequireversion{1.1.0} 声明最低版本。

模板自检：在宏包仓库根目录执行：

texlua docs/libraries/starter/check.lua --gradbars-root .

这会检查三个引擎及版本保护。模板的完整 example.tex 给出注册和加载顺序。

schema-1 标量后端契约

\documentclass{article}
\usepackage{gradbars}
\gradbarsdeclarebackend{my-backend}
 {bar,heat,missing,signed,gradient,print,labels,units,clip,
  decorations,embedded,tagging,artifact}
 {\gradbarsbackenddefault}
\begin{document}
\gradbar[backend=my-backend]{72.125}
\end{document}

上例代理到原生 TikZ，故可声明其能力。独立实现只能声明实际实现的能力。后端注册在导言区进行；记录在回调内只读，包含未舍入原值、已解析尺度、几何位置、格式和语义信息。

当前公开契约覆盖 bar 和 Heat；默认渲染器仍为 TikZ，宏包仍依赖 PGF/TikZ。堆叠、趋势、比较、箱线图和图例等复合图形需要原生后端，或显式设置 backend fallback=tikz。默认遇到不支持的能力报错，避免静默改变结果。

测量阶段可能多次调用回调，扩展应避免写文件等外部副作用。接口存在并不表示已提供第二套独立渲染器。

完整后端契约 · 稳定接口契约