dxpdf 0.2.0

A fast DOCX-to-PDF converter powered by Skia
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182

//! Typed identifiers and revision tracking.

/// A relationship ID (e.g., "rId1") — opaque, interned from the .rels files.
#[derive(Clone, Debug, PartialEq, Eq, Hash)]
pub struct RelId(String);

impl RelId {
    pub fn new(id: impl Into<String>) -> Self {
        Self(id.into())
    }

    pub fn as_str(&self) -> &str {
        &self.0
    }
}

/// Footnote or endnote numeric ID.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
pub struct NoteId(i64);

impl NoteId {
    pub fn new(id: i64) -> Self {
        Self(id)
    }

    pub fn value(self) -> i64 {
        self.0
    }
}

/// A bookmark ID.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
pub struct BookmarkId(i64);

impl BookmarkId {
    pub fn new(id: i64) -> Self {
        Self(id)
    }

    pub fn value(self) -> i64 {
        self.0
    }
}

/// A style ID (e.g., "Heading1", "Normal") — reference into `Document.styles`.
/// Per §17.7.4.17, this is the `w:styleId` attribute value.
#[derive(Clone, Debug, PartialEq, Eq, Hash)]
pub struct StyleId(String);

impl StyleId {
    pub fn new(id: impl Into<String>) -> Self {
        Self(id.into())
    }

    pub fn as_str(&self) -> &str {
        &self.0
    }
}

/// §17.9.1: abstract numbering definition ID.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
pub struct AbstractNumId(i64);

impl AbstractNumId {
    pub fn new(id: i64) -> Self {
        Self(id)
    }

    pub fn value(self) -> i64 {
        self.0
    }
}

/// §17.9.19: numbering instance ID.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
pub struct NumId(i64);

impl NumId {
    pub fn new(id: i64) -> Self {
        Self(id)
    }

    pub fn value(self) -> i64 {
        self.0
    }
}

/// §17.9.21: picture bullet ID. References between `w:numPicBullet` and `w:lvlPicBulletId`.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
pub struct NumPicBulletId(i64);

impl NumPicBulletId {
    pub fn new(id: i64) -> Self {
        Self(id)
    }

    pub fn value(self) -> i64 {
        self.0
    }
}

/// VML shape identifier (e.g., "_x0000_t202"). Used as a `v:shapetype` `id`
/// and referenced by `v:shape` `type` (with a leading `#` prefix).
#[derive(Clone, Debug, PartialEq, Eq, Hash)]
pub struct VmlShapeId(String);

impl VmlShapeId {
    pub fn new(id: impl Into<String>) -> Self {
        Self(id.into())
    }

    pub fn as_str(&self) -> &str {
        &self.0
    }
}

/// Revision Save ID — identifies which editing session produced a change.
/// Stored as a 32-bit value parsed from an 8-digit hex string (e.g., "00A2B3C4").
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
pub struct RevisionSaveId(u32);

impl RevisionSaveId {
    pub fn value(self) -> u32 {
        self.0
    }

    /// Parse from an OOXML hex string. Returns None if invalid.
    pub fn from_hex(s: &str) -> Option<Self> {
        u32::from_str_radix(s, 16).ok().map(Self)
    }
}

/// Revision tracking IDs attached to an element.
/// Each field records which editing session performed that type of change.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Default)]
pub struct RevisionIds {
    /// Session that added this element.
    pub r: Option<RevisionSaveId>,
    /// Session that last modified this element's properties.
    pub r_pr: Option<RevisionSaveId>,
    /// Session that deleted this element (for tracked deletions).
    pub del: Option<RevisionSaveId>,
}

/// Revision tracking IDs specific to paragraphs.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Default)]
pub struct ParagraphRevisionIds {
    /// Session that added this paragraph.
    pub r: Option<RevisionSaveId>,
    /// Session that added the default run content.
    pub r_default: Option<RevisionSaveId>,
    /// Session that last modified paragraph properties.
    pub p: Option<RevisionSaveId>,
    /// Session that last modified run properties on the paragraph mark.
    pub r_pr: Option<RevisionSaveId>,
    /// Session that deleted this paragraph.
    pub del: Option<RevisionSaveId>,
}

/// Revision tracking IDs specific to table rows.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Default)]
pub struct TableRowRevisionIds {
    /// Session that added this row.
    pub r: Option<RevisionSaveId>,
    /// Session that last modified row properties.
    pub r_pr: Option<RevisionSaveId>,
    /// Session that deleted this row.
    pub del: Option<RevisionSaveId>,
    /// Session that last modified this row's table-level formatting.
    pub tr: Option<RevisionSaveId>,
}

/// Revision tracking IDs specific to section properties.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Default)]
pub struct SectionRevisionIds {
    /// Session that added this section.
    pub r: Option<RevisionSaveId>,
    /// Session that last modified section run properties.
    pub r_pr: Option<RevisionSaveId>,
    /// Session that last modified section properties.
    pub sect: Option<RevisionSaveId>,
}