fix(ffi): map SingularTransform diagnostic to C ABI v1

[add-uos]

问题

打开含奇异变换对象（退化 CTM，如 CTM="0 0 0 0.3528 0 0" 的空白文本对象，常见于部分转换器生成的 OFD）的文档时，rofd-render 正确跳过这些对象并发出 RenderDiagnosticKind::SingularTransform 诊断，但 FFI 层 diagnostic_kind() 未映射该枚举值，走到兜底分支返回 ROFD_STATUS_INTERNAL（错误消息 "renderer returned a diagnostic kind unknown to C ABI v1"），导致整页渲染失败、文档无法打开。

复现样例：发票监制章-数科.ofd（内含 33 个此类对象）。

修复

• crates/rofd-ffi/src/abi.rs：新增 ROFD_DIAGNOSTIC_SINGULAR_TRANSFORM: u32 = 7
• crates/rofd-ffi/include/rofd.h：新增对应 C 宏定义
• crates/rofd-ffi/src/report.rs：映射 SingularTransform，并在单元测试中补齐该映射

新增值为追加常量，不破坏 C ABI v1 兼容性；消费方（deepin-reader）仅记录诊断内容，无需适配。

验证

• C 程序直连 C ABI 渲染该文档：status 0，151 条诊断正常上报（kind=7 ×32、kind=2 字体回退）
• 批量验证 ofdrw-compat 全部 4 个 fixture 目录（converter/layout/reader/sign）共 110 页：全部渲染成功，14731 条诊断均为合法类型
• cargo test -p rofd-core -p rofd-render -p rofd-ffi、C ABI 集成测试脚本、cargo fmt --check 全部通过
• deepin-reader（ofd_support 分支）实际打开该文档正常渲染，无 "unknown to C ABI v1" 错误

Summary by Sourcery

Map singular-transform renderer diagnostics to a stable C ABI value so affected documents render successfully instead of failing.

New Features:

• Expose singular-transform render diagnostics as diagnostic kind 7 in the C ABI.

Bug Fixes:

• Prevent documents containing singular transforms from failing whole-page rendering with an unknown diagnostic kind error.

Documentation:

• Add Chinese project documentation and repository license metadata.

Tests:

• Add coverage for mapping singular-transform diagnostics through the FFI.

Chores:

• Add project and third-party license files and REUSE licensing configuration.

[sourcery-ai]

Reviewer's guide (collapsed on small PRs)

Reviewer's Guide

The FFI layer now reports skipped objects with singular transforms as diagnostic kind 7 through both Rust and C ABI definitions, preventing valid renderer diagnostics from escalating to internal errors and preserving C ABI v1 compatibility.

Sequence diagram for singular-transform diagnostic reporting

sequenceDiagram
    participant Renderer
    participant FFI
    participant CConsumer

    Renderer->>FFI: RenderDiagnosticKind::SingularTransform
    FFI->>FFI: diagnostic_kind(kind)
    FFI-->>CConsumer: ROFD_DIAGNOSTIC_SINGULAR_TRANSFORM (7)
    CConsumer-->>CConsumer: Record diagnostic and continue rendering

    alt Unmapped diagnostic kind
        FFI-->>CConsumer: ROFD_STATUS_INTERNAL
    end

Loading

File-Level Changes

Change	Details	Files
Expose SingularTransform as a new C ABI v1 diagnostic value.	Add diagnostic constant 7 to the Rust ABI definitions. Add the matching public C header macro as an appended value. Preserve existing diagnostic numeric assignments and ABI compatibility.	crates/rofd-ffi/src/abi.rs crates/rofd-ffi/include/rofd.h
Translate singular-transform renderer diagnostics instead of treating them as unknown internal errors.	Map RenderDiagnosticKind::SingularTransform to the new ABI value. Extend report mapping tests to verify the new translation.	crates/rofd-ffi/src/report.rs

---

Tips and commands

Interacting with Sourcery

• Trigger a new review: Comment @sourcery-ai review on the pull request.
• Continue discussions: Reply directly to Sourcery's review comments.
• Generate a GitHub issue from a review comment: Ask Sourcery to create an
  issue from a review comment by replying to it. You can also reply to a
  review comment with @sourcery-ai issue to create an issue from it.
• Generate a pull request title: Write @sourcery-ai anywhere in the pull
  request title to generate a title at any time. You can also comment
  @sourcery-ai title on the pull request to (re-)generate the title at any time.
• Generate a pull request summary: Write @sourcery-ai summary anywhere in
  the pull request body to generate a PR summary at any time exactly where you
  want it. You can also comment @sourcery-ai summary on the pull request to
  (re-)generate the summary at any time.
• Generate reviewer's guide: Comment @sourcery-ai guide on the pull
  request to (re-)generate the reviewer's guide at any time.
• Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
  pull request to resolve all Sourcery comments. Useful if you've already
  addressed all the comments and don't want to see them anymore.
• Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
  request to dismiss all existing Sourcery reviews. Especially useful if you
  want to start fresh with a new review - don't forget to comment
  @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

• Enable or disable review features such as the Sourcery-generated pull request
  summary, the reviewer's guide, and others.
• Change the review language.
• Add, remove or edit custom review instructions.
• Adjust other review settings.

Getting Help

• Contact our support team for questions or feedback.
• Visit our documentation for detailed guides and information.
• Keep in touch with the Sourcery team by following us on X/Twitter, LinkedIn or GitHub.

[sourcery-ai]

Hey - I've reviewed your changes and they look great!

---

Sourcery is free for open source - if you like our reviews please consider sharing them ✨

• X
• Mastodon
• LinkedIn
• Facebook

[deepin-ci-robot]

deepin pr auto review

🤖 AI 代码审查报告

总体评分： 100 分 (通过阈值: 70分)

---

📊 总体评价

项目	结果
审查结论	代码审查通过
评分详情	总体评分 100 分，大于 70 分通过阈值，代码质量符合要求。本次提交将 SingularTransform 诊断正确映射到 C ABI v1，修复了含奇异变换对象的 OFD 文档整页渲染失败的问题，代码实现简洁正确，无安全漏洞。

---

🔍 详细分析

1. 语法逻辑 ✅

评价： 优秀 ✅ 通过

潜在问题：
✅ 未发现明显问题

建议： 语法正确，逻辑清晰，无需修改

---

2. 代码质量 ✅

评价： 优秀 ✅ 通过

潜在问题：
✅ 未发现明显问题

建议： 代码结构清晰，注释完整，无需修改

---

3. 代码性能 ✅

评价： 优秀 ✅ 通过

潜在问题：
✅ 未发现明显问题

建议： 性能良好，资源使用合理，无需优化

---

4. 代码安全 🔒

评价： 优秀 ✅ 通过

🔐 发现 0 个安全漏洞

安全漏洞详情：
✅ 未发现安全漏洞

建议： 存在0个安全漏洞，代码仅涉及内部诊断常量映射，无用户输入处理、无外部数据交互、无密码学操作、无缓冲区操作、无路径操作、无命令执行，不存在攻击面

---

💡 改进建议代码示例

// 本次提交代码实现正确，无需修复示例
// crates/rofd-ffi/src/abi.rs
/// Diagnostic indicating an object was skipped because its transform is singular.
pub const ROFD_DIAGNOSTIC_SINGULAR_TRANSFORM: u32 = 7;

// crates/rofd-ffi/src/report.rs - diagnostic_kind()
RenderDiagnosticKind::SingularTransform => Ok(ROFD_DIAGNOSTIC_SINGULAR_TRANSFORM),

// crates/rofd-ffi/include/rofd.h
#define ROFD_DIAGNOSTIC_SINGULAR_TRANSFORM 7u

---

本报告由 AI 代码审查工具自动生成

[deepin-ci-robot]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: add-uos, BLumia, lzwind

The full list of commands accepted by this bot can be found here.

Details

Needs approval from an approver in each of these files:

• debian/deepin/OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[add-uos]

/merge

[deepin-bot]

This pr cannot be merged! (status: unstable)

[add-uos]

/forcemerge

[deepin-bot]

This pr force merged! (status: unstable)