@folijs/core 0.2.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (136) hide show
  1. package/CHANGELOG.md +45 -0
  2. package/README.md +1 -1
  3. package/dist/document.d.ts +10 -16
  4. package/dist/document.d.ts.map +1 -1
  5. package/dist/document.js +22 -22
  6. package/dist/document.js.map +1 -1
  7. package/dist/index.d.ts +3 -2
  8. package/dist/index.d.ts.map +1 -1
  9. package/dist/index.js +3 -2
  10. package/dist/index.js.map +1 -1
  11. package/dist/model/fragment.d.ts +5 -2
  12. package/dist/model/fragment.d.ts.map +1 -1
  13. package/dist/model/fragment.js +5 -2
  14. package/dist/model/fragment.js.map +1 -1
  15. package/dist/model/node.d.ts +1 -1
  16. package/dist/model/node.d.ts.map +1 -1
  17. package/dist/model/node.js.map +1 -1
  18. package/dist/schema.d.ts +10 -1
  19. package/dist/schema.d.ts.map +1 -1
  20. package/dist/schema.js +11 -1
  21. package/dist/schema.js.map +1 -1
  22. package/dist/state/commands.d.ts +7 -6
  23. package/dist/state/commands.d.ts.map +1 -1
  24. package/dist/state/commands.js +162 -97
  25. package/dist/state/commands.js.map +1 -1
  26. package/dist/state/comments.d.ts +47 -0
  27. package/dist/state/comments.d.ts.map +1 -0
  28. package/dist/state/comments.js +304 -0
  29. package/dist/state/comments.js.map +1 -0
  30. package/dist/state/editor.d.ts +67 -16
  31. package/dist/state/editor.d.ts.map +1 -1
  32. package/dist/state/editor.js +74 -18
  33. package/dist/state/editor.js.map +1 -1
  34. package/dist/state/format.d.ts +8 -22
  35. package/dist/state/format.d.ts.map +1 -1
  36. package/dist/state/format.js +16 -140
  37. package/dist/state/format.js.map +1 -1
  38. package/dist/state/history.d.ts +1 -1
  39. package/dist/state/history.d.ts.map +1 -1
  40. package/dist/state/history.js +3 -2
  41. package/dist/state/history.js.map +1 -1
  42. package/dist/state/index.d.ts +11 -4
  43. package/dist/state/index.d.ts.map +1 -1
  44. package/dist/state/index.js +11 -4
  45. package/dist/state/index.js.map +1 -1
  46. package/dist/state/links.d.ts.map +1 -1
  47. package/dist/state/links.js +10 -2
  48. package/dist/state/links.js.map +1 -1
  49. package/dist/state/lists.d.ts +19 -32
  50. package/dist/state/lists.d.ts.map +1 -1
  51. package/dist/state/lists.js +23 -372
  52. package/dist/state/lists.js.map +1 -1
  53. package/dist/state/mark.d.ts +28 -0
  54. package/dist/state/mark.d.ts.map +1 -0
  55. package/dist/state/mark.js +57 -0
  56. package/dist/state/mark.js.map +1 -0
  57. package/dist/state/review.d.ts +43 -0
  58. package/dist/state/review.d.ts.map +1 -0
  59. package/dist/state/review.js +282 -0
  60. package/dist/state/review.js.map +1 -0
  61. package/dist/state/state.d.ts +2 -0
  62. package/dist/state/state.d.ts.map +1 -1
  63. package/dist/state/state.js +18 -0
  64. package/dist/state/state.js.map +1 -1
  65. package/dist/state/track.d.ts +47 -0
  66. package/dist/state/track.d.ts.map +1 -0
  67. package/dist/state/track.js +534 -0
  68. package/dist/state/track.js.map +1 -0
  69. package/dist/state/word.d.ts +100 -0
  70. package/dist/state/word.d.ts.map +1 -0
  71. package/dist/state/word.js +253 -0
  72. package/dist/state/word.js.map +1 -0
  73. package/dist/state/wordclip.d.ts +43 -0
  74. package/dist/state/wordclip.d.ts.map +1 -0
  75. package/dist/state/wordclip.js +412 -0
  76. package/dist/state/wordclip.js.map +1 -0
  77. package/dist/state/wordformat.d.ts +136 -0
  78. package/dist/state/wordformat.d.ts.map +1 -0
  79. package/dist/state/wordformat.js +846 -0
  80. package/dist/state/wordformat.js.map +1 -0
  81. package/dist/v3/check.d.ts +33 -0
  82. package/dist/v3/check.d.ts.map +1 -0
  83. package/dist/v3/check.js +90 -0
  84. package/dist/v3/check.js.map +1 -0
  85. package/dist/v3/document.d.ts +217 -0
  86. package/dist/v3/document.d.ts.map +1 -0
  87. package/dist/v3/document.js +225 -0
  88. package/dist/v3/document.js.map +1 -0
  89. package/dist/v3/index.d.ts +6 -0
  90. package/dist/v3/index.d.ts.map +1 -0
  91. package/dist/v3/index.js +6 -0
  92. package/dist/v3/index.js.map +1 -0
  93. package/dist/v3/migrate.d.ts +19 -0
  94. package/dist/v3/migrate.d.ts.map +1 -0
  95. package/dist/v3/migrate.js +227 -0
  96. package/dist/v3/migrate.js.map +1 -0
  97. package/dist/v3/resolve.d.ts +129 -0
  98. package/dist/v3/resolve.d.ts.map +1 -0
  99. package/dist/v3/resolve.js +534 -0
  100. package/dist/v3/resolve.js.map +1 -0
  101. package/dist/v3/schema.d.ts +29 -0
  102. package/dist/v3/schema.d.ts.map +1 -0
  103. package/dist/v3/schema.js +431 -0
  104. package/dist/v3/schema.js.map +1 -0
  105. package/dist/v3/units.d.ts +16 -0
  106. package/dist/v3/units.d.ts.map +1 -0
  107. package/dist/v3/units.js +28 -0
  108. package/dist/v3/units.js.map +1 -0
  109. package/package.json +1 -1
  110. package/src/document.ts +26 -26
  111. package/src/index.ts +3 -6
  112. package/src/model/fragment.ts +11 -3
  113. package/src/model/node.ts +6 -1
  114. package/src/schema.ts +13 -1
  115. package/src/state/commands.ts +173 -91
  116. package/src/state/comments.ts +342 -0
  117. package/src/state/editor.ts +176 -36
  118. package/src/state/format.ts +24 -122
  119. package/src/state/history.ts +3 -2
  120. package/src/state/index.ts +73 -3
  121. package/src/state/links.ts +10 -2
  122. package/src/state/lists.ts +31 -408
  123. package/src/state/mark.ts +64 -0
  124. package/src/state/review.ts +330 -0
  125. package/src/state/state.ts +18 -0
  126. package/src/state/track.ts +602 -0
  127. package/src/state/word.ts +330 -0
  128. package/src/state/wordclip.ts +445 -0
  129. package/src/state/wordformat.ts +982 -0
  130. package/src/v3/check.ts +119 -0
  131. package/src/v3/document.ts +456 -0
  132. package/src/v3/index.ts +33 -0
  133. package/src/v3/migrate.ts +267 -0
  134. package/src/v3/resolve.ts +646 -0
  135. package/src/v3/schema.ts +482 -0
  136. package/src/v3/units.ts +34 -0
@@ -0,0 +1,225 @@
1
+ import { DEFAULT_SETTINGS, parseDocumentV2 } from "../document.js";
2
+ import { FoliDocumentError } from "../model/index.js";
3
+ import { bool, color, date, int, isRecord, listOf, oneOf, shape, str, text, token, xml, } from "./check.js";
4
+ import { migrateToV3 } from "./migrate.js";
5
+ import { checkSection, checkParagraphProperties as paragraphProperties, checkRunProperties as runProperties, schema, } from "./schema.js";
6
+ /** The schema version of documents in the Word model (ADR-0005). */
7
+ export const SCHEMA_VERSION = 3;
8
+ /**
9
+ * A new document: `content` (schema v3; default: one empty paragraph) on A4 with 25.4 mm
10
+ * margins, with the styles and list definitions the editor's commands use (Normal, Heading 1–6,
11
+ * List Paragraph, Hyperlink; bullets and numbers) and 11 pt Georgia, 1.5 lines: the look a
12
+ * migrated 0.2.0 document has. `section` (in twips: `mmToTwips`) is merged over that page:
13
+ * `pageSize` and `margins` part by part. Not validated: `parseDocument` (or `createEditor`) does
14
+ * that.
15
+ */
16
+ export function createDocument(content = { type: "doc", content: [{ type: "paragraph" }] }, section) {
17
+ const empty = { type: "doc", content: [] };
18
+ const blank = migrateToV3({
19
+ schemaVersion: 2,
20
+ settings: DEFAULT_SETTINGS,
21
+ content: empty,
22
+ });
23
+ const base = blank.section;
24
+ return {
25
+ ...blank,
26
+ // The default (A4) section has only pageSize and margins: each merged part by part.
27
+ section: {
28
+ ...section,
29
+ pageSize: { ...base.pageSize, ...section?.pageSize },
30
+ margins: { ...base.margins, ...section?.margins },
31
+ },
32
+ content,
33
+ };
34
+ }
35
+ /**
36
+ * Validates untrusted input against schema v3. Returns a copy that shares nothing with the
37
+ * input, with the content and the comments' content in canonical form. Documents of schema 1
38
+ * and 2 are validated as such and migrated (`migrateToV3`). Throws FoliDocumentError instead
39
+ * of dropping anything.
40
+ *
41
+ * What Word opens is accepted: duplicate ids (the first wins), a numbering instance or a reply
42
+ * whose target is missing, references to styles that do not exist. Rejected is only what the
43
+ * engine cannot work with: wrong types, out-of-range values, and cycles (a style based on
44
+ * itself, comments replying to each other) that would never end when followed.
45
+ */
46
+ export function parseDocument(input) {
47
+ if (!isRecord(input))
48
+ throw new FoliDocumentError("Document must be an object");
49
+ const version = input.schemaVersion;
50
+ if (version === 1 || version === 2)
51
+ return parseDocument(migrateToV3(parseDocumentV2(input)));
52
+ if (version !== SCHEMA_VERSION) {
53
+ const newer = Number.isInteger(version) && version > SCHEMA_VERSION;
54
+ throw new FoliDocumentError(`Unsupported schemaVersion: ${String(version)} (this version of @folijs/core reads 1 to ` +
55
+ `${SCHEMA_VERSION}${newer ? "; the document was saved by a newer one" : ""})`);
56
+ }
57
+ for (const key of Object.keys(input)) {
58
+ if (!ENVELOPE_KEYS.includes(key))
59
+ throw new FoliDocumentError(`${key}: unknown key`);
60
+ }
61
+ check("section", input.section, checkSection);
62
+ check("defaults", input.defaults, shape({ paragraph: paragraphProperties, run: runProperties, ext: xml }, [], true));
63
+ check("styles", input.styles, listOf(checkStyle));
64
+ check("numbering", input.numbering, shape({ abstracts: listOf(checkAbstract), instances: listOf(checkInstance) }, [
65
+ "abstracts",
66
+ "instances",
67
+ ]));
68
+ if (input.theme !== undefined)
69
+ check("theme", input.theme, checkTheme);
70
+ check("comments", input.comments, listOf(checkComment));
71
+ const styles = input.styles;
72
+ const comments = input.comments;
73
+ noCycles("styles", styles, (s) => s.id, (s) => s.basedOn, (s) => `${s.id} is based on itself`);
74
+ noCycles("comments", comments, (c) => c.id, (c) => c.parent, (c) => `comment ${c.id} replies to itself`);
75
+ const content = parseContent(input.content);
76
+ // A copy: the validated document must not change when the caller's input does.
77
+ const envelope = structuredClone({
78
+ section: input.section,
79
+ defaults: input.defaults,
80
+ styles,
81
+ numbering: input.numbering,
82
+ theme: input.theme,
83
+ });
84
+ return {
85
+ schemaVersion: SCHEMA_VERSION,
86
+ section: envelope.section,
87
+ defaults: envelope.defaults,
88
+ styles: envelope.styles,
89
+ numbering: envelope.numbering,
90
+ ...(envelope.theme === undefined ? {} : { theme: envelope.theme }),
91
+ comments: comments.map((c, i) => ({
92
+ ...structuredClone({ ...c, content: [] }),
93
+ content: blocks(c.content, `comments[${i}].content`).map((block) => block.toJSON()),
94
+ })),
95
+ content: content.toJSON(),
96
+ };
97
+ }
98
+ /** Parses untrusted schema v3 content into a `doc` node. */
99
+ export function parseContent(value, path = "content") {
100
+ const doc = schema.nodeFromJSON(value, path);
101
+ if (doc.type !== schema.topNodeType)
102
+ fail(path, 'root node must be of type "doc"');
103
+ if (doc.marks.length)
104
+ fail(`${path}.marks`, "doc cannot have marks");
105
+ return doc;
106
+ }
107
+ const ENVELOPE_KEYS = [
108
+ "schemaVersion",
109
+ "section",
110
+ "defaults",
111
+ "styles",
112
+ "numbering",
113
+ "theme",
114
+ "comments",
115
+ "content",
116
+ ];
117
+ function fail(path, message) {
118
+ throw new FoliDocumentError(`${path}: ${message}`);
119
+ }
120
+ function check(path, value, checker) {
121
+ const error = checker(value);
122
+ if (error)
123
+ fail(path, error);
124
+ }
125
+ /**
126
+ * Following `next` from any item ends (no item reaches itself). Linear: each item is walked
127
+ * once. Ids that occur twice resolve to the first, as Word does.
128
+ */
129
+ function noCycles(path, items, id, next, message) {
130
+ const byId = new Map();
131
+ items.forEach((item, i) => {
132
+ if (!byId.has(id(item)))
133
+ byId.set(id(item), i);
134
+ });
135
+ const state = new Uint8Array(items.length); // 0 unseen, 1 on the current path, 2 ends
136
+ items.forEach((_, start) => {
137
+ const path_ = [];
138
+ let at = start;
139
+ while (at !== undefined && state[at] === 0) {
140
+ state[at] = 1;
141
+ path_.push(at);
142
+ const target = next(items[at]);
143
+ at = target === undefined ? undefined : byId.get(target);
144
+ }
145
+ if (at !== undefined && state[at] === 1)
146
+ fail(`${path}[${at}]`, message(items[at]));
147
+ for (const i of path_)
148
+ state[i] = 2;
149
+ });
150
+ }
151
+ function blocks(content, path) {
152
+ const doc = parseContent({ type: "doc", content }, path);
153
+ const list = [];
154
+ doc.forEach((block) => {
155
+ list.push(block);
156
+ });
157
+ return list;
158
+ }
159
+ const checkStyle = shape({
160
+ id: text(),
161
+ type: oneOf(["paragraph", "character", "table", "numbering"]),
162
+ name: str(),
163
+ basedOn: text(),
164
+ next: text(),
165
+ link: text(),
166
+ isDefault: bool,
167
+ paragraph: paragraphProperties,
168
+ run: runProperties,
169
+ ext: xml,
170
+ }, ["id", "type"]);
171
+ const checkLevel = shape({
172
+ level: int(0, 8),
173
+ start: int(0, 2_147_483_647),
174
+ format: token,
175
+ text: str(),
176
+ justification: oneOf(["left", "center", "right", "start", "end"]),
177
+ restart: int(0, 9),
178
+ legal: bool,
179
+ suffix: oneOf(["tab", "space", "nothing"]),
180
+ style: text(),
181
+ paragraph: paragraphProperties,
182
+ run: runProperties,
183
+ ext: xml,
184
+ }, ["level"]);
185
+ const checkAbstract = shape({
186
+ id: int(0, 2_147_483_647),
187
+ multiLevelType: oneOf(["singleLevel", "multilevel", "hybridMultilevel"]),
188
+ levels: listOf(checkLevel, 9),
189
+ styleLink: text(),
190
+ numStyleLink: text(),
191
+ ext: xml,
192
+ }, ["id", "levels"]);
193
+ const checkInstance = shape({
194
+ id: int(1, 2_147_483_647),
195
+ abstract: int(0, 2_147_483_647),
196
+ overrides: listOf(shape({ level: int(0, 8), start: int(0, 2_147_483_647), definition: checkLevel }, ["level"]), 9),
197
+ ext: xml,
198
+ }, ["id", "abstract"]);
199
+ const font = shape({ latin: str(), eastAsia: str(), cs: str() }, ["latin"]);
200
+ const checkTheme = shape({
201
+ fonts: shape({ major: font, minor: font }, ["major", "minor"]),
202
+ colors: (v) => {
203
+ if (!isRecord(v))
204
+ return "must be an object";
205
+ for (const [key, value] of Object.entries(v)) {
206
+ if (!/^(dk[12]|lt[12]|accent[1-6]|hlink|folHlink)$/.test(key))
207
+ return `unknown color ${key}`;
208
+ const error = color(value);
209
+ if (error)
210
+ return `${key} ${error}`;
211
+ }
212
+ return undefined;
213
+ },
214
+ }, ["fonts", "colors"]);
215
+ const checkComment = shape({
216
+ id: int(0, 2_147_483_647),
217
+ author: str(),
218
+ initials: str(9),
219
+ date: date,
220
+ content: (v) => (Array.isArray(v) ? undefined : "must be an array of blocks"),
221
+ parent: int(0, 2_147_483_647),
222
+ done: bool,
223
+ ext: xml,
224
+ }, ["id", "author", "content"]);
225
+ //# sourceMappingURL=document.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"document.js","sourceRoot":"","sources":["../../src/v3/document.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ export { type AbstractNumberingJSON, type BorderJSON, type CommentJSON, createDocument, type FoliDocument, type NumberingInstanceJSON, type NumberingLevelJSON, type ParagraphPropertiesJSON, parseContent, parseDocument, SCHEMA_VERSION, type SectionJSON, type StyleJSON, type ThemeJSON, } from "./document.js";
2
+ export { migrateToV3 } from "./migrate.js";
3
+ export { formatNumber, type ListMarker, type ParagraphFormat, Resolver, type RunFormat, } from "./resolve.js";
4
+ export { checkSection, HIGHLIGHT_COLORS, JUSTIFICATIONS, type Justification, RUN_PROPERTY_MARKS, schema, } from "./schema.js";
5
+ export * from "./units.js";
6
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v3/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,YAAY,EACZ,aAAa,EACb,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,SAAS,GACf,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EACL,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,QAAQ,EACR,KAAK,SAAS,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,KAAK,aAAa,EAClB,kBAAkB,EAClB,MAAM,GACP,MAAM,aAAa,CAAC;AACrB,cAAc,YAAY,CAAC"}
@@ -0,0 +1,6 @@
1
+ export { createDocument, parseContent, parseDocument, SCHEMA_VERSION, } from "./document.js";
2
+ export { migrateToV3 } from "./migrate.js";
3
+ export { formatNumber, Resolver, } from "./resolve.js";
4
+ export { checkSection, HIGHLIGHT_COLORS, JUSTIFICATIONS, RUN_PROPERTY_MARKS, schema, } from "./schema.js";
5
+ export * from "./units.js";
6
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/v3/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,cAAc,EAKd,YAAY,EACZ,aAAa,EACb,cAAc,GAIf,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EACL,YAAY,EAGZ,QAAQ,GAET,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,cAAc,EAEd,kBAAkB,EAClB,MAAM,GACP,MAAM,aAAa,CAAC;AACrB,cAAc,YAAY,CAAC"}
@@ -0,0 +1,19 @@
1
+ import type { FoliDocumentV2 } from "../document.js";
2
+ import type { FoliDocument } from "./document.js";
3
+ /**
4
+ * Schema v2 → v3 (ADR-0005): the content keeps every character, mark and break; its structure
5
+ * becomes Word's.
6
+ * - Headings become paragraphs styled `Heading1`–`Heading6`.
7
+ * - Lists become numbered paragraphs (style `ListParagraph`, `numbering` id and level): one
8
+ * numbering instance per list, a nested list of the same kind continuing its parent's at the
9
+ * next level; further blocks of an item are indented to its text. Levels past Word's 9 stay at
10
+ * the ninth.
11
+ * - A horizontal rule becomes an empty paragraph with a bottom border.
12
+ * - Alignment becomes justification; text color `color`; highlight (any color) `shading`, as
13
+ * Word records a background color that is not one of its highlight colors. Linked text gets
14
+ * Word's "Hyperlink" character style (blue, underlined), the look links had.
15
+ * - `settings` becomes the section, in twips (rounded to the twip: under 0.02 mm).
16
+ * The styles and numbering definitions the result references are added.
17
+ */
18
+ export declare function migrateToV3(doc: FoliDocumentV2): FoliDocument;
19
+ //# sourceMappingURL=migrate.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/v3/migrate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGrD,OAAO,KAAK,EAEV,YAAY,EAIb,MAAM,eAAe,CAAC;AAGvB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,YAAY,CAqB7D"}
@@ -0,0 +1,227 @@
1
+ import { mmToTwips } from "./units.js";
2
+ /**
3
+ * Schema v2 → v3 (ADR-0005): the content keeps every character, mark and break; its structure
4
+ * becomes Word's.
5
+ * - Headings become paragraphs styled `Heading1`–`Heading6`.
6
+ * - Lists become numbered paragraphs (style `ListParagraph`, `numbering` id and level): one
7
+ * numbering instance per list, a nested list of the same kind continuing its parent's at the
8
+ * next level; further blocks of an item are indented to its text. Levels past Word's 9 stay at
9
+ * the ninth.
10
+ * - A horizontal rule becomes an empty paragraph with a bottom border.
11
+ * - Alignment becomes justification; text color `color`; highlight (any color) `shading`, as
12
+ * Word records a background color that is not one of its highlight colors. Linked text gets
13
+ * Word's "Hyperlink" character style (blue, underlined), the look links had.
14
+ * - `settings` becomes the section, in twips (rounded to the twip: under 0.02 mm).
15
+ * The styles and numbering definitions the result references are added.
16
+ */
17
+ export function migrateToV3(doc) {
18
+ const instances = [];
19
+ const content = blocks(doc.content.content, { instances });
20
+ return {
21
+ schemaVersion: 3,
22
+ section: section(doc.settings),
23
+ // The default stylesheet's look, rather than Word's empty-defaults 10 pt: 11 pt Georgia, 1.5
24
+ // lines, and the browser's 1em between paragraphs as space after.
25
+ defaults: {
26
+ paragraph: { spacing: { after: 220, line: 360, lineRule: "auto" } },
27
+ run: [
28
+ { type: "font", attrs: { ascii: "Georgia", hAnsi: "Georgia", cs: "Georgia" } },
29
+ { type: "fontSize", attrs: { value: 22, complexScript: 22 } },
30
+ ],
31
+ },
32
+ // Copies: no two documents share an object.
33
+ styles: structuredClone(STYLES),
34
+ numbering: { abstracts: structuredClone([BULLETS, NUMBERS]), instances },
35
+ comments: [],
36
+ content: { type: "doc", content },
37
+ };
38
+ }
39
+ const INDENT = 720; // twips per list level: 0.5 inch, Word's
40
+ const HANGING = 360;
41
+ /** Millimetres to twips within Word's limits (22 inches: v2 allowed any size). */
42
+ function twips(mm) {
43
+ return Math.min(mmToTwips(mm), 31_680);
44
+ }
45
+ function section(settings) {
46
+ const { width, height } = settings.pageSize;
47
+ const { top, right, bottom, left } = settings.margins;
48
+ return {
49
+ pageSize: {
50
+ width: Math.max(twips(width), 1),
51
+ height: Math.max(twips(height), 1),
52
+ ...(width > height ? { orientation: "landscape" } : {}),
53
+ },
54
+ margins: {
55
+ top: twips(top),
56
+ right: twips(right),
57
+ bottom: twips(bottom),
58
+ left: twips(left),
59
+ },
60
+ };
61
+ }
62
+ function blocks(list, context) {
63
+ const out = [];
64
+ for (const block of list) {
65
+ if (block.type === "bulletList" || block.type === "orderedList") {
66
+ listBlocks(block, 0, undefined, context, out);
67
+ }
68
+ else {
69
+ out.push(paragraph(block, {}));
70
+ }
71
+ }
72
+ return out;
73
+ }
74
+ /** A v2 list's items as numbered paragraphs, appended to `out`. */
75
+ function listBlocks(list, depth, parent, context, out) {
76
+ const level = Math.min(depth, 8);
77
+ const kind = list.type === "bulletList" ? "bullet" : "number";
78
+ const start = list.type === "orderedList" ? (list.attrs?.start ?? 1) : 1;
79
+ // A nested list of the same kind starting at 1 continues its parent's numbering one level
80
+ // down: Word restarts the deeper level after each item, as v2 numbered it. Only the item's
81
+ // first such list (a second one would continue the first's count) and only while the level
82
+ // goes down (past the ninth, it would continue the parent's).
83
+ const continues = parent !== undefined &&
84
+ parent.kind === kind &&
85
+ start === 1 &&
86
+ depth <= 8 &&
87
+ !parent.item.continued;
88
+ let id;
89
+ if (continues) {
90
+ id = parent.id;
91
+ parent.item.continued = true;
92
+ }
93
+ if (id === undefined) {
94
+ id = context.instances.length + 1;
95
+ context.instances.push({
96
+ id,
97
+ abstract: kind === "bullet" ? BULLETS.id : NUMBERS.id,
98
+ // An explicit start restarts the numbering, whatever instances share the definition.
99
+ ...(kind === "number" ? { overrides: [{ level, start }] } : {}),
100
+ });
101
+ }
102
+ for (const item of list.content) {
103
+ const [first, ...rest] = item.content;
104
+ const state = { continued: false };
105
+ out.push(paragraph(first, { style: "ListParagraph", numbering: { id, level } }));
106
+ for (const block of rest) {
107
+ if (block.type === "bulletList" || block.type === "orderedList") {
108
+ listBlocks(block, depth + 1, { id, kind, item: state }, context, out);
109
+ }
110
+ else {
111
+ // More of the item: aligned with its text.
112
+ const style = block.type === "paragraph" || block.type === "horizontalRule"
113
+ ? { style: "ListParagraph" }
114
+ : {};
115
+ out.push(paragraph(block, { ...style, indent: { left: INDENT * (level + 1) } }));
116
+ }
117
+ }
118
+ }
119
+ }
120
+ function paragraph(block, extra) {
121
+ if (block.type === "horizontalRule") {
122
+ return {
123
+ type: "paragraph",
124
+ attrs: {
125
+ ...extra,
126
+ borders: { bottom: { style: "single", size: 6, space: 1, color: "auto" } },
127
+ },
128
+ };
129
+ }
130
+ const attrs = { ...extra };
131
+ if (block.type === "heading")
132
+ attrs.style = `Heading${block.attrs.level}`;
133
+ const align = block.attrs?.align;
134
+ if (align && align !== "start")
135
+ attrs.justification = JUSTIFY[align];
136
+ return {
137
+ type: "paragraph",
138
+ ...(Object.keys(attrs).length ? { attrs } : {}),
139
+ ...(block.content?.length ? { content: block.content.map(inline) } : {}),
140
+ };
141
+ }
142
+ const JUSTIFY = { center: "center", end: "right", justify: "both" };
143
+ function inline(node) {
144
+ const marks = node.marks?.flatMap((m) => m.type === "link"
145
+ ? [mark(m), { type: "characterStyle", attrs: { id: "Hyperlink" } }]
146
+ : [mark(m)]);
147
+ return { ...node, ...(marks?.length ? { marks } : {}) };
148
+ }
149
+ function mark(m) {
150
+ switch (m.type) {
151
+ case "link":
152
+ return { type: "link", attrs: { href: m.attrs.href } };
153
+ case "textColor":
154
+ return { type: "color", attrs: { value: m.attrs.color.slice(1).toUpperCase() } };
155
+ case "highlight":
156
+ return {
157
+ type: "shading",
158
+ attrs: { pattern: "clear", fill: m.attrs.color.slice(1).toUpperCase() },
159
+ };
160
+ default:
161
+ return { type: m.type };
162
+ }
163
+ }
164
+ /** The styles migrated documents use, as Word names them. */
165
+ const HEADING_SIZES = [32, 28, 26, 24, 22, 22]; // half-points
166
+ const STYLES = [
167
+ { id: "Normal", type: "paragraph", name: "Normal", isDefault: true },
168
+ ...HEADING_SIZES.map((size, i) => ({
169
+ id: `Heading${i + 1}`,
170
+ type: "paragraph",
171
+ name: `heading ${i + 1}`,
172
+ basedOn: "Normal",
173
+ next: "Normal",
174
+ paragraph: {
175
+ keepNext: true,
176
+ keepLines: true,
177
+ outlineLevel: i,
178
+ spacing: { before: 240, after: 120 },
179
+ },
180
+ run: [{ type: "bold" }, { type: "fontSize", attrs: { value: size } }],
181
+ })),
182
+ {
183
+ id: "ListParagraph",
184
+ type: "paragraph",
185
+ name: "List Paragraph",
186
+ basedOn: "Normal",
187
+ paragraph: { indent: { left: INDENT }, contextualSpacing: true },
188
+ },
189
+ {
190
+ id: "DefaultParagraphFont",
191
+ type: "character",
192
+ name: "Default Paragraph Font",
193
+ isDefault: true,
194
+ },
195
+ {
196
+ id: "Hyperlink",
197
+ type: "character",
198
+ name: "Hyperlink",
199
+ basedOn: "DefaultParagraphFont",
200
+ run: [
201
+ { type: "color", attrs: { value: "0563C1", themeColor: "hyperlink" } },
202
+ { type: "underline" },
203
+ ],
204
+ },
205
+ ];
206
+ function levels(kind) {
207
+ return Array.from({ length: 9 }, (_, level) => ({
208
+ level,
209
+ start: 1,
210
+ // v2 showed nested numbers as decimal at every level (the browser's default).
211
+ format: kind === "bullet" ? "bullet" : "decimal",
212
+ text: kind === "bullet" ? ["•", "◦", "▪"][level % 3] : `%${level + 1}.`,
213
+ justification: "left",
214
+ paragraph: { indent: { left: INDENT * (level + 1), hanging: HANGING } },
215
+ }));
216
+ }
217
+ const BULLETS = {
218
+ id: 0,
219
+ multiLevelType: "hybridMultilevel",
220
+ levels: levels("bullet"),
221
+ };
222
+ const NUMBERS = {
223
+ id: 1,
224
+ multiLevelType: "hybridMultilevel",
225
+ levels: levels("number"),
226
+ };
227
+ //# sourceMappingURL=migrate.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../src/v3/migrate.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,129 @@
1
+ /**
2
+ * How a schema v3 document looks: the effective paragraph and run formatting Word computes from
3
+ * the document defaults, the styles and direct formatting (ECMA-376 Part 1, 17.7.2), and the
4
+ * list markers numbering gives paragraphs (17.9). No DOM: the view turns these into CSS.
5
+ */
6
+ import type { MarkJSON } from "../model/index.js";
7
+ import type { FoliDocument, ParagraphPropertiesJSON } from "./document.js";
8
+ type Json = Record<string, unknown>;
9
+ /** Effective run formatting: what a run looks like after defaults, styles and direct marks. */
10
+ export interface RunFormat {
11
+ bold: boolean;
12
+ /** Bold for complex scripts (`w:bCs`). */
13
+ boldCs: boolean;
14
+ italic: boolean;
15
+ italicCs: boolean;
16
+ caps: boolean;
17
+ smallCaps: boolean;
18
+ strike: boolean;
19
+ doubleStrike: boolean;
20
+ hidden: boolean;
21
+ /** Underline style (`single`, `double`…); null for none. */
22
+ underline: string | null;
23
+ underlineColor: string | null;
24
+ /** Font names per script, theme fonts resolved; null where nothing names one. */
25
+ font: {
26
+ ascii: string | null;
27
+ hAnsi: string | null;
28
+ eastAsia: string | null;
29
+ cs: string | null;
30
+ };
31
+ /** Half-points (Word's default without any: 20, 10 pt). */
32
+ size: number;
33
+ sizeCs: number;
34
+ /** `RRGGBB` (theme colors resolved); null for automatic. */
35
+ color: string | null;
36
+ highlight: string | null;
37
+ /** Shading fill `RRGGBB`; null for none. */
38
+ shading: string | null;
39
+ verticalAlign: "baseline" | "superscript" | "subscript";
40
+ /** Twips. */
41
+ characterSpacing: number;
42
+ }
43
+ /** Effective paragraph properties: a paragraph's attributes after defaults, styles and numbering. */
44
+ export interface ParagraphFormat {
45
+ /** The paragraph style that applies (the default paragraph style when none is named). */
46
+ style: string | null;
47
+ justification: string | null;
48
+ /** Twips. Only one of `firstLine` and `hanging` is non-zero. */
49
+ indent: {
50
+ left: number;
51
+ right: number;
52
+ firstLine: number;
53
+ hanging: number;
54
+ };
55
+ spacing: {
56
+ before: number;
57
+ after: number;
58
+ line: number | null;
59
+ lineRule: "auto" | "exact" | "atLeast";
60
+ beforeAutospacing: boolean;
61
+ afterAutospacing: boolean;
62
+ };
63
+ keepNext: boolean;
64
+ keepLines: boolean;
65
+ widowControl: boolean;
66
+ pageBreakBefore: boolean;
67
+ contextualSpacing: boolean;
68
+ outlineLevel: number | null;
69
+ tabs: {
70
+ position: number;
71
+ kind: string;
72
+ leader: string | null;
73
+ }[];
74
+ borders: NonNullable<ParagraphPropertiesJSON["borders"]> | null;
75
+ shading: ParagraphPropertiesJSON["shading"] | null;
76
+ /** The numbering that applies (direct, or from the style): instance id and level. */
77
+ numbering: {
78
+ id: number;
79
+ level: number;
80
+ } | null;
81
+ }
82
+ /** A paragraph's list marker. */
83
+ export interface ListMarker {
84
+ /** As Word shows it ("1.", "1.1", "(a)", or a bullet's character as the file has it). */
85
+ text: string;
86
+ /** What follows the marker. */
87
+ suffix: "tab" | "space" | "nothing";
88
+ justification: string;
89
+ /** The marker's formatting: the paragraph's, its mark's, then the level's run properties. */
90
+ run: RunFormat;
91
+ instance: number;
92
+ level: number;
93
+ }
94
+ /** A counter in a number format (ST_NumberFormat); formats Foli does not know show as decimal. */
95
+ export declare function formatNumber(n: number, format: string | undefined): string;
96
+ type Envelope = Pick<FoliDocument, "defaults" | "styles" | "numbering" | "theme">;
97
+ /**
98
+ * Resolves a document's formatting from its envelope (defaults, styles, numbering, theme).
99
+ * Style resolutions are memoized: build one per envelope and reuse it.
100
+ */
101
+ export declare class Resolver {
102
+ #private;
103
+ constructor(envelope: Envelope);
104
+ /**
105
+ * A paragraph's effective properties, and the formatting of its text before a run's own marks
106
+ * (`attrs`: the paragraph node's attributes, as JSON or a live node has them). The results are
107
+ * the caller's: changing them changes nothing else.
108
+ */
109
+ paragraph(attrs: Json): {
110
+ paragraph: ParagraphFormat;
111
+ run: RunFormat;
112
+ };
113
+ /**
114
+ * The number format (`decimal`, `bullet`…) of the numbering level a paragraph is in (`attrs`:
115
+ * its attributes), or null when it is not numbered.
116
+ */
117
+ numberFormat(attrs: Json): string | null;
118
+ /** A run's formatting: its paragraph's (`paragraphRun`), its character style, then its own marks. */
119
+ run(paragraphRun: RunFormat, marks: readonly MarkJSON[]): RunFormat;
120
+ /**
121
+ * The list markers of a document's paragraphs in order (`paragraphs`: each paragraph's
122
+ * attributes). Counters are kept per abstract definition, so instances that share one continue
123
+ * a list; an instance's start override restarts it where the instance is first used; a level
124
+ * restarts after a paragraph of a level above it, or as its `restart` says.
125
+ */
126
+ markers(paragraphs: readonly Json[]): (ListMarker | null)[];
127
+ }
128
+ export {};
129
+ //# sourceMappingURL=resolve.d.ts.map