@bendyline/squisq 1.5.1 → 2.0.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 (268) hide show
  1. package/README.md +63 -10
  2. package/dist/{Doc-BBVGq1_9.d.ts → Doc-ylqWKDc_.d.ts} +248 -37
  3. package/dist/{ImageEditDoc-FuyGtt6o.d.ts → ImageEditDoc-D828IXJ1.d.ts} +1 -1
  4. package/dist/annotationCoercion-Dr_DY9Hx.d.ts +86 -0
  5. package/dist/{chunk-VWUFZ6ZG.js → chunk-3E5F2XMR.js} +2 -29
  6. package/dist/chunk-3E5F2XMR.js.map +1 -0
  7. package/dist/chunk-4X3JQXNM.js +35 -0
  8. package/dist/chunk-4X3JQXNM.js.map +1 -0
  9. package/dist/{chunk-2OIBZYKP.js → chunk-5DKBFXPY.js} +31 -121
  10. package/dist/chunk-5DKBFXPY.js.map +1 -0
  11. package/dist/{chunk-DLXZMS5K.js → chunk-5J4HKRJF.js} +51 -3
  12. package/dist/chunk-5J4HKRJF.js.map +1 -0
  13. package/dist/chunk-5UYI3RJB.js +2503 -0
  14. package/dist/chunk-5UYI3RJB.js.map +1 -0
  15. package/dist/{chunk-TEEEILMP.js → chunk-66QO7XFB.js} +19 -292
  16. package/dist/chunk-66QO7XFB.js.map +1 -0
  17. package/dist/{chunk-KKNUBQ6Y.js → chunk-6PJRB2CF.js} +156 -91
  18. package/dist/chunk-6PJRB2CF.js.map +1 -0
  19. package/dist/{chunk-HWVFJAAH.js → chunk-AMIR72JP.js} +28 -10
  20. package/dist/chunk-AMIR72JP.js.map +1 -0
  21. package/dist/chunk-FVJUUTEM.js +74 -0
  22. package/dist/chunk-FVJUUTEM.js.map +1 -0
  23. package/dist/{chunk-LH7I6SH7.js → chunk-GF3BVNLU.js} +6360 -5723
  24. package/dist/chunk-GF3BVNLU.js.map +1 -0
  25. package/dist/{chunk-Q3ROPT5H.js → chunk-GZY66SDN.js} +1 -1
  26. package/dist/{chunk-Q3ROPT5H.js.map → chunk-GZY66SDN.js.map} +1 -1
  27. package/dist/chunk-JOQYPRDZ.js +127 -0
  28. package/dist/chunk-JOQYPRDZ.js.map +1 -0
  29. package/dist/{chunk-A4O7GIWE.js → chunk-LYNJEOAC.js} +10 -73
  30. package/dist/chunk-LYNJEOAC.js.map +1 -0
  31. package/dist/{chunk-LDQ2HJIX.js → chunk-PXLVXTLW.js} +252 -54
  32. package/dist/chunk-PXLVXTLW.js.map +1 -0
  33. package/dist/{chunk-TQWLI6S2.js → chunk-Q7LROV2H.js} +4 -2
  34. package/dist/{chunk-TQWLI6S2.js.map → chunk-Q7LROV2H.js.map} +1 -1
  35. package/dist/{chunk-T5UK6YOB.js → chunk-QTSJOY54.js} +60 -17
  36. package/dist/chunk-QTSJOY54.js.map +1 -0
  37. package/dist/chunk-QVANWDPH.js +2358 -0
  38. package/dist/chunk-QVANWDPH.js.map +1 -0
  39. package/dist/{chunk-6ATE2PSM.js → chunk-R2GC6RLD.js} +7 -7
  40. package/dist/chunk-R2GC6RLD.js.map +1 -0
  41. package/dist/chunk-R2YZTCLO.js +292 -0
  42. package/dist/chunk-R2YZTCLO.js.map +1 -0
  43. package/dist/chunk-S7A5D7ZJ.js +174 -0
  44. package/dist/chunk-S7A5D7ZJ.js.map +1 -0
  45. package/dist/chunk-T3TI7GSZ.js +884 -0
  46. package/dist/chunk-T3TI7GSZ.js.map +1 -0
  47. package/dist/{chunk-RUDYOTA6.js → chunk-TUWMK62B.js} +110 -4
  48. package/dist/chunk-TUWMK62B.js.map +1 -0
  49. package/dist/{chunk-IMSCRLLV.js → chunk-VR7UPJ7C.js} +35 -25
  50. package/dist/chunk-VR7UPJ7C.js.map +1 -0
  51. package/dist/doc/index.d.ts +2334 -5
  52. package/dist/doc/index.js +134 -34
  53. package/dist/generate/index.d.ts +7 -2
  54. package/dist/generate/index.js +1 -1
  55. package/dist/imageEdit/index.d.ts +9 -6
  56. package/dist/imageEdit/index.js +3 -3
  57. package/dist/index.d.ts +12 -10
  58. package/dist/index.js +253 -81
  59. package/dist/jsonForm/index.d.ts +7 -3
  60. package/dist/jsonForm/index.js +9 -4
  61. package/dist/markdown/index.d.ts +6 -70
  62. package/dist/markdown/index.js +13 -9
  63. package/dist/narration/index.d.ts +618 -0
  64. package/dist/narration/index.js +82 -0
  65. package/dist/recommend/index.d.ts +15 -1
  66. package/dist/recommend/index.js +2 -2
  67. package/dist/schemas/index.d.ts +28 -6
  68. package/dist/schemas/index.js +15 -13
  69. package/dist/spatial/index.d.ts +0 -1
  70. package/dist/spatial/index.js +1 -1
  71. package/dist/storage/index.js +1 -1
  72. package/dist/{themeLibrary-CehcJhzz.d.ts → themeLibrary-RjVgLpUi.d.ts} +10 -11
  73. package/dist/timing/index.js +5 -3
  74. package/dist/transform/index.d.ts +35 -24
  75. package/dist/transform/index.js +9 -10
  76. package/dist/{types-DlAZ7MW4.d.ts → types-BwMPl2CB.d.ts} +1 -1
  77. package/dist/{types-D98li1gV.d.ts → types-C4kiRn_k.d.ts} +3 -1
  78. package/dist/versions/index.d.ts +2 -1
  79. package/dist/versions/index.js +2 -2
  80. package/package.json +6 -6
  81. package/src/__tests__/applyNarrationTiming.test.ts +190 -0
  82. package/src/__tests__/applyRenderStyle.test.ts +3 -3
  83. package/src/__tests__/asciiDiagramBattle.test.ts +246 -0
  84. package/src/__tests__/asciiDiagramDetect.test.ts +162 -0
  85. package/src/__tests__/asciiDiagramMapping.test.ts +38 -0
  86. package/src/__tests__/asciiDiagramParse.test.ts +233 -0
  87. package/src/__tests__/asciiDiagramPipeline.test.ts +273 -0
  88. package/src/__tests__/asciiDiagramRender.test.ts +162 -0
  89. package/src/__tests__/asciiDiagramRepair.test.ts +84 -0
  90. package/src/__tests__/asciiTimelineDetect.test.ts +157 -0
  91. package/src/__tests__/asciiTimelineParse.test.ts +205 -0
  92. package/src/__tests__/asciiTimelinePipeline.test.ts +349 -0
  93. package/src/__tests__/asciiTimelineRender.test.ts +376 -0
  94. package/src/__tests__/attrTokens.test.ts +5 -0
  95. package/src/__tests__/contentContainer.test.ts +43 -0
  96. package/src/__tests__/coverBlock.test.ts +33 -2
  97. package/src/__tests__/customTemplatesFrontmatter.test.ts +0 -15
  98. package/src/__tests__/dataTable.test.ts +25 -15
  99. package/src/__tests__/diagramBlock.test.ts +3 -3
  100. package/src/__tests__/diagramText.test.ts +26 -0
  101. package/src/__tests__/docToMarkdownMedia.test.ts +83 -0
  102. package/src/__tests__/drawingBlock.test.ts +3 -3
  103. package/src/__tests__/fixtures/asciiDiagramBattle.ts +512 -0
  104. package/src/__tests__/fixtures/asciiDiagrams.ts +287 -0
  105. package/src/__tests__/fixtures/asciiTimelines.ts +35 -0
  106. package/src/__tests__/fixtures/treeviewFixtures.ts +243 -0
  107. package/src/__tests__/getLayers.test.ts +32 -18
  108. package/src/__tests__/getLayersFallback.test.ts +8 -8
  109. package/src/__tests__/imageEditVersions.test.ts +2 -0
  110. package/src/__tests__/jsonForm.pointer.test.ts +47 -1
  111. package/src/__tests__/layoutBlock.test.ts +3 -3
  112. package/src/__tests__/majorApiTypes.test.ts +18 -0
  113. package/src/__tests__/markdown.test.ts +41 -0
  114. package/src/__tests__/markdownToDoc.test.ts +5 -2
  115. package/src/__tests__/matchFontFamily.test.ts +114 -0
  116. package/src/__tests__/materializeBlockLayers.test.ts +135 -0
  117. package/src/__tests__/materializeTestUtils.ts +17 -0
  118. package/src/__tests__/narrationAlign.test.ts +150 -0
  119. package/src/__tests__/narrationFeatures.test.ts +71 -0
  120. package/src/__tests__/narrationNuclei.test.ts +45 -0
  121. package/src/__tests__/narrationPacing.test.ts +189 -0
  122. package/src/__tests__/narrationScript.test.ts +149 -0
  123. package/src/__tests__/narrationSessionRepro.test.ts +62 -0
  124. package/src/__tests__/narrationSidecar.test.ts +88 -0
  125. package/src/__tests__/narrationSyllables.test.ts +65 -0
  126. package/src/__tests__/narrationTestSignals.ts +167 -0
  127. package/src/__tests__/narrationVad.test.ts +66 -0
  128. package/src/__tests__/resolveDocTheme.test.ts +16 -2
  129. package/src/__tests__/rootExports.test.ts +18 -0
  130. package/src/__tests__/scopedContentContainer.test.ts +20 -0
  131. package/src/__tests__/shapeGeometry.test.ts +49 -0
  132. package/src/__tests__/templateAnnotationParse.test.ts +10 -0
  133. package/src/__tests__/templateInputs.test.ts +69 -0
  134. package/src/__tests__/templateMetadata.test.ts +2 -1
  135. package/src/__tests__/templates.test.ts +143 -17
  136. package/src/__tests__/themeCompile.test.ts +49 -22
  137. package/src/__tests__/transformProvenance.test.ts +160 -0
  138. package/src/__tests__/transformV2.test.ts +40 -14
  139. package/src/__tests__/treeviewBattle.test.ts +76 -0
  140. package/src/__tests__/treeviewDetect.test.ts +168 -0
  141. package/src/__tests__/treeviewParse.test.ts +118 -0
  142. package/src/__tests__/treeviewPipeline.test.ts +183 -0
  143. package/src/__tests__/treeviewRender.test.ts +91 -0
  144. package/src/__tests__/versions.test.ts +44 -0
  145. package/src/doc/applyNarrationTiming.ts +244 -0
  146. package/src/doc/asciiDiagram/chars.ts +210 -0
  147. package/src/doc/asciiDiagram/detect.ts +175 -0
  148. package/src/doc/asciiDiagram/index.ts +38 -0
  149. package/src/doc/asciiDiagram/mapping.ts +225 -0
  150. package/src/doc/asciiDiagram/parse.ts +1095 -0
  151. package/src/doc/asciiDiagram/render.ts +963 -0
  152. package/src/doc/asciiDiagram/repair.ts +400 -0
  153. package/src/doc/asciiDiagram/types.ts +65 -0
  154. package/src/doc/asciiTimeline/detect.ts +138 -0
  155. package/src/doc/asciiTimeline/index.ts +26 -0
  156. package/src/doc/asciiTimeline/mapping.ts +43 -0
  157. package/src/doc/asciiTimeline/parse.ts +870 -0
  158. package/src/doc/asciiTimeline/render.ts +427 -0
  159. package/src/doc/asciiTimeline/types.ts +73 -0
  160. package/src/doc/asciiTimeline/wrappedFlow.ts +427 -0
  161. package/src/doc/audioMapping.ts +60 -46
  162. package/src/doc/customTemplatesFrontmatter.ts +0 -41
  163. package/src/doc/docToMarkdown.ts +126 -39
  164. package/src/doc/index.ts +76 -4
  165. package/src/doc/markdownToDoc.ts +135 -1
  166. package/src/doc/materializeBlockLayers.ts +304 -0
  167. package/src/doc/mediaAnnotations.ts +20 -0
  168. package/src/doc/resolveDocTheme.ts +8 -7
  169. package/src/doc/templateInputs.ts +185 -2
  170. package/src/doc/templates/__tests__/customTemplateRegistry.test.ts +22 -8
  171. package/src/doc/templates/coverBlock.ts +49 -13
  172. package/src/doc/templates/diagramBlock.ts +237 -38
  173. package/src/doc/templates/drawingBlock.ts +2 -2
  174. package/src/doc/templates/fallbackBlock.ts +1 -1
  175. package/src/doc/templates/index.ts +134 -279
  176. package/src/doc/templates/inputDescriptors.ts +20 -1
  177. package/src/doc/templates/metadata.ts +10 -0
  178. package/src/doc/templates/persistentLayers.ts +12 -126
  179. package/src/doc/templates/registry.ts +88 -0
  180. package/src/doc/templates/templateNames.ts +22 -0
  181. package/src/doc/templates/timelineBlock.ts +613 -0
  182. package/src/doc/templates/treeBlock.ts +131 -0
  183. package/src/doc/treeview/chars.ts +72 -0
  184. package/src/doc/treeview/detect.ts +145 -0
  185. package/src/doc/treeview/index.ts +30 -0
  186. package/src/doc/treeview/mapping.ts +95 -0
  187. package/src/doc/treeview/parse.ts +201 -0
  188. package/src/doc/treeview/render.ts +41 -0
  189. package/src/doc/treeview/types.ts +43 -0
  190. package/src/doc/utils/applyRenderStyle.ts +2 -9
  191. package/src/doc/utils/diagramText.ts +78 -0
  192. package/src/doc/utils/shapeGeometry.ts +157 -7
  193. package/src/doc/validate.ts +1 -1
  194. package/src/generate/templateMapper.ts +7 -0
  195. package/src/imageEdit/export.ts +6 -5
  196. package/src/imageEdit/versionPaths.ts +13 -26
  197. package/src/imageEdit/versions.ts +21 -100
  198. package/src/index.ts +1 -0
  199. package/src/internal/immutable.ts +58 -0
  200. package/src/jsonForm/index.ts +9 -1
  201. package/src/jsonForm/pointer.ts +68 -23
  202. package/src/markdown/attrTokens.ts +7 -5
  203. package/src/markdown/convert.ts +11 -1
  204. package/src/markdown/index.ts +1 -0
  205. package/src/markdown/stringify.ts +4 -9
  206. package/src/markdown/utils.ts +36 -14
  207. package/src/narration/align.ts +514 -0
  208. package/src/narration/features.ts +231 -0
  209. package/src/narration/index.ts +86 -0
  210. package/src/narration/nuclei.ts +118 -0
  211. package/src/narration/pacing.ts +211 -0
  212. package/src/narration/script.ts +239 -0
  213. package/src/narration/session.ts +100 -0
  214. package/src/narration/sidecar.ts +187 -0
  215. package/src/narration/syllables.ts +85 -0
  216. package/src/narration/trace.ts +50 -0
  217. package/src/narration/types.ts +299 -0
  218. package/src/narration/vad.ts +131 -0
  219. package/src/recommend/numberHighlight.ts +25 -0
  220. package/src/recommend/templates.ts +108 -12
  221. package/src/schemas/BlockTemplates.ts +156 -7
  222. package/src/schemas/Doc.ts +72 -9
  223. package/src/schemas/Media.ts +12 -2
  224. package/src/schemas/Theme.ts +45 -25
  225. package/src/schemas/Viewport.ts +2 -2
  226. package/src/schemas/fontStacks.ts +79 -0
  227. package/src/schemas/themeCompile.ts +15 -0
  228. package/src/schemas/themeConstants.ts +2 -0
  229. package/src/schemas/themeLibrary.ts +25 -19
  230. package/src/schemas/themeValidator.ts +1 -1
  231. package/src/spatial/Geohash.ts +0 -3
  232. package/src/storage/ContentContainer.ts +17 -9
  233. package/src/storage/ScopedContentContainer.ts +45 -15
  234. package/src/transform/applyTransform.ts +5 -5
  235. package/src/transform/index.ts +3 -1
  236. package/src/transform/registry.ts +169 -49
  237. package/src/transform/templateSelector.ts +21 -2
  238. package/src/transform/timingAllocator.ts +152 -21
  239. package/src/transform/types.ts +14 -1
  240. package/src/versions/gitignore.ts +34 -0
  241. package/src/versions/index.ts +2 -0
  242. package/src/versions/operations.ts +18 -104
  243. package/src/versions/paths.ts +13 -28
  244. package/src/versions/snapshotStore.ts +202 -0
  245. package/src/versions/types.ts +3 -1
  246. package/dist/chunk-2OIBZYKP.js.map +0 -1
  247. package/dist/chunk-6ATE2PSM.js.map +0 -1
  248. package/dist/chunk-A4O7GIWE.js.map +0 -1
  249. package/dist/chunk-DLXZMS5K.js.map +0 -1
  250. package/dist/chunk-HWVFJAAH.js.map +0 -1
  251. package/dist/chunk-IMSCRLLV.js.map +0 -1
  252. package/dist/chunk-JELIRVDP.js +0 -24
  253. package/dist/chunk-JELIRVDP.js.map +0 -1
  254. package/dist/chunk-KKNUBQ6Y.js.map +0 -1
  255. package/dist/chunk-LDQ2HJIX.js.map +0 -1
  256. package/dist/chunk-LH7I6SH7.js.map +0 -1
  257. package/dist/chunk-RUDYOTA6.js.map +0 -1
  258. package/dist/chunk-T5UK6YOB.js.map +0 -1
  259. package/dist/chunk-TEEEILMP.js.map +0 -1
  260. package/dist/chunk-UY7KGQ5R.js +0 -192
  261. package/dist/chunk-UY7KGQ5R.js.map +0 -1
  262. package/dist/chunk-VLJJHDAC.js +0 -218
  263. package/dist/chunk-VLJJHDAC.js.map +0 -1
  264. package/dist/chunk-VWUFZ6ZG.js.map +0 -1
  265. package/dist/story/index.d.ts +0 -1777
  266. package/dist/story/index.js +0 -273
  267. package/src/doc/getLayers.ts +0 -195
  268. /package/dist/{story → narration}/index.js.map +0 -0
@@ -1,218 +0,0 @@
1
- import {
2
- formatVersionTimestamp,
3
- parseVersionTimestamp
4
- } from "./chunk-JELIRVDP.js";
5
-
6
- // src/versions/paths.ts
7
- var VERSIONS_PREFIX = ".versions/";
8
- function getDocBasename(documentPath) {
9
- const slash = documentPath.lastIndexOf("/");
10
- const file = slash >= 0 ? documentPath.slice(slash + 1) : documentPath;
11
- const dot = file.lastIndexOf(".");
12
- return dot > 0 ? file.slice(0, dot) : file;
13
- }
14
- function buildVersionPath(basename, date, collision = 0) {
15
- const stamp = formatVersionTimestamp(date);
16
- const suffix = collision > 0 ? `-${collision + 1}` : "";
17
- return `${VERSIONS_PREFIX}${basename}.${stamp}${suffix}.md`;
18
- }
19
- function parseVersionPath(path) {
20
- if (!path.startsWith(VERSIONS_PREFIX)) return null;
21
- const rest = path.slice(VERSIONS_PREFIX.length);
22
- if (!rest.endsWith(".md")) return null;
23
- const stem = rest.slice(0, -".md".length);
24
- const lastDot = stem.lastIndexOf(".");
25
- if (lastDot <= 0) return null;
26
- const basename = stem.slice(0, lastDot);
27
- const tail = stem.slice(lastDot + 1);
28
- const dash = tail.indexOf("-");
29
- let stamp;
30
- let collision = 0;
31
- if (dash >= 0) {
32
- stamp = tail.slice(0, dash);
33
- const n = Number(tail.slice(dash + 1));
34
- if (!Number.isInteger(n) || n < 2) return null;
35
- collision = n - 1;
36
- } else {
37
- stamp = tail;
38
- }
39
- const timestamp = parseVersionTimestamp(stamp);
40
- if (!timestamp) return null;
41
- return { basename, timestamp, collision };
42
- }
43
-
44
- // src/versions/operations.ts
45
- var decoder = new TextDecoder();
46
- var encoder = new TextEncoder();
47
- async function resolveBasename(container, override) {
48
- if (override) return override;
49
- const docPath = await container.getDocumentPath();
50
- if (!docPath) return null;
51
- return getDocBasename(docPath);
52
- }
53
- async function resolveDocPath(container) {
54
- const docPath = await container.getDocumentPath();
55
- return docPath ?? "index.md";
56
- }
57
- async function listVersions(container, basename) {
58
- const entries = await container.listFiles(VERSIONS_PREFIX);
59
- const versions = [];
60
- for (const entry of entries) {
61
- const parsed = parseVersionPath(entry.path);
62
- if (!parsed) continue;
63
- if (basename !== void 0 && parsed.basename !== basename) continue;
64
- versions.push({
65
- path: entry.path,
66
- basename: parsed.basename,
67
- timestamp: parsed.timestamp,
68
- size: entry.size,
69
- collision: parsed.collision
70
- });
71
- }
72
- versions.sort((a, b) => {
73
- const dt = b.timestamp.getTime() - a.timestamp.getTime();
74
- if (dt !== 0) return dt;
75
- return b.collision - a.collision;
76
- });
77
- return versions;
78
- }
79
- async function readVersion(container, version) {
80
- const path = typeof version === "string" ? version : version.path;
81
- const data = await container.readFile(path);
82
- if (!data) return null;
83
- return decoder.decode(data);
84
- }
85
- async function saveVersion(container, options = {}) {
86
- const content = options.content ?? await container.readDocument();
87
- if (content === null || content === void 0) {
88
- return { saved: false, version: null, reason: "no-document" };
89
- }
90
- if (content.length === 0) {
91
- return { saved: false, version: null, reason: "empty" };
92
- }
93
- const basename = await resolveBasename(container, options.basename);
94
- if (!basename) {
95
- return { saved: false, version: null, reason: "no-document" };
96
- }
97
- const versions = await listVersions(container, basename);
98
- if (!options.force && versions.length > 0) {
99
- const latest = versions[0];
100
- const existing = await readVersion(container, latest);
101
- if (existing === content) {
102
- return { saved: false, version: null, reason: "unchanged" };
103
- }
104
- }
105
- const now = options.now ?? /* @__PURE__ */ new Date();
106
- let collision = 0;
107
- let path = buildVersionPath(basename, now, collision);
108
- while (await container.exists(path)) {
109
- collision += 1;
110
- path = buildVersionPath(basename, now, collision);
111
- }
112
- const data = encoder.encode(content);
113
- await container.writeFile(path, data, "text/markdown");
114
- const version = {
115
- path,
116
- basename,
117
- timestamp: now,
118
- size: data.byteLength,
119
- collision
120
- };
121
- return { saved: true, version, reason: "saved" };
122
- }
123
- async function revertToVersion(container, version, options = {}) {
124
- const content = await readVersion(container, version);
125
- if (content === null) {
126
- return { reverted: false, snapshotted: null };
127
- }
128
- let snapshotted = null;
129
- if (options.snapshotCurrent !== false) {
130
- const result = await saveVersion(container);
131
- snapshotted = result.version;
132
- }
133
- const docPath = await resolveDocPath(container);
134
- await container.writeDocument(content, docPath);
135
- return { reverted: true, snapshotted };
136
- }
137
- async function pruneVersions(container, policy, basename) {
138
- const versions = await listVersions(container, basename);
139
- const toDelete = [];
140
- if (policy.type === "keep-last-n") {
141
- const n = Math.max(0, Math.floor(policy.n));
142
- toDelete.push(...versions.slice(n));
143
- } else if (policy.type === "older-than") {
144
- const cutoff = policy.date.getTime();
145
- for (const v of versions) {
146
- if (v.timestamp.getTime() < cutoff) toDelete.push(v);
147
- }
148
- } else {
149
- for (const v of versions) {
150
- if (!policy.keep(v, versions)) toDelete.push(v);
151
- }
152
- }
153
- for (const v of toDelete) {
154
- await container.removeFile(v.path);
155
- }
156
- return toDelete;
157
- }
158
- async function coalesceVersions(container, options = {}, basename) {
159
- const windowMs = options.windowMs ?? 6e4;
160
- const versions = await listVersions(container, basename);
161
- const toDelete = [];
162
- if (versions.length > 0) {
163
- let anchor = versions[0];
164
- for (let i = 1; i < versions.length; i++) {
165
- const candidate = versions[i];
166
- if (anchor.timestamp.getTime() - candidate.timestamp.getTime() <= windowMs) {
167
- toDelete.push(candidate);
168
- } else {
169
- anchor = candidate;
170
- }
171
- }
172
- }
173
- for (const v of toDelete) {
174
- await container.removeFile(v.path);
175
- }
176
- return toDelete;
177
- }
178
-
179
- // src/versions/DocumentVersionManager.ts
180
- var DocumentVersionManager = class {
181
- constructor(container, options = {}) {
182
- this.container = container;
183
- this.basename = options.basename;
184
- }
185
- saveVersion(options = {}) {
186
- return saveVersion(this.container, { basename: this.basename, ...options });
187
- }
188
- listVersions() {
189
- return listVersions(this.container, this.basename);
190
- }
191
- readVersion(version) {
192
- return readVersion(this.container, version);
193
- }
194
- revertToVersion(version, options) {
195
- return revertToVersion(this.container, version, options);
196
- }
197
- pruneVersions(policy) {
198
- return pruneVersions(this.container, policy, this.basename);
199
- }
200
- coalesceVersions(options) {
201
- return coalesceVersions(this.container, options, this.basename);
202
- }
203
- };
204
-
205
- export {
206
- VERSIONS_PREFIX,
207
- getDocBasename,
208
- buildVersionPath,
209
- parseVersionPath,
210
- listVersions,
211
- readVersion,
212
- saveVersion,
213
- revertToVersion,
214
- pruneVersions,
215
- coalesceVersions,
216
- DocumentVersionManager
217
- };
218
- //# sourceMappingURL=chunk-VLJJHDAC.js.map
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/versions/paths.ts","../src/versions/operations.ts","../src/versions/DocumentVersionManager.ts"],"sourcesContent":["/**\n * Path conventions for version snapshots.\n *\n * Snapshots live at `<VERSIONS_PREFIX><basename>.<timestamp>[<-suffix>].md`.\n * The optional numeric suffix (`-2`, `-3`, ...) is appended only when two\n * snapshots collide on the same UTC second.\n */\n\nimport { formatVersionTimestamp, parseVersionTimestamp } from './timestamp.js';\n\n/** Subfolder (inside the ContentContainer) that holds version snapshots. */\nexport const VERSIONS_PREFIX = '.versions/';\n\n/**\n * Strip the directory and extension from a document path to produce the\n * basename used in version filenames. `subdir/index.md` -> `index`.\n */\nexport function getDocBasename(documentPath: string): string {\n const slash = documentPath.lastIndexOf('/');\n const file = slash >= 0 ? documentPath.slice(slash + 1) : documentPath;\n const dot = file.lastIndexOf('.');\n return dot > 0 ? file.slice(0, dot) : file;\n}\n\n/**\n * Build a version snapshot path. Optionally append a collision suffix\n * (e.g. `2`, `3`) when two saves land on the same UTC second.\n */\nexport function buildVersionPath(basename: string, date: Date, collision = 0): string {\n const stamp = formatVersionTimestamp(date);\n const suffix = collision > 0 ? `-${collision + 1}` : '';\n return `${VERSIONS_PREFIX}${basename}.${stamp}${suffix}.md`;\n}\n\n/**\n * Parse a version snapshot path. Returns null if it doesn't match the\n * convention (so unrelated files stored under `.versions/` are ignored).\n */\nexport function parseVersionPath(\n path: string,\n): { basename: string; timestamp: Date; collision: number } | null {\n if (!path.startsWith(VERSIONS_PREFIX)) return null;\n const rest = path.slice(VERSIONS_PREFIX.length);\n if (!rest.endsWith('.md')) return null;\n const stem = rest.slice(0, -'.md'.length);\n // basename can contain dots; the timestamp is always the *last* dot-segment\n // (optionally followed by a `-N` collision suffix).\n const lastDot = stem.lastIndexOf('.');\n if (lastDot <= 0) return null;\n const basename = stem.slice(0, lastDot);\n const tail = stem.slice(lastDot + 1);\n const dash = tail.indexOf('-');\n let stamp: string;\n let collision = 0;\n if (dash >= 0) {\n stamp = tail.slice(0, dash);\n const n = Number(tail.slice(dash + 1));\n if (!Number.isInteger(n) || n < 2) return null;\n collision = n - 1;\n } else {\n stamp = tail;\n }\n const timestamp = parseVersionTimestamp(stamp);\n if (!timestamp) return null;\n return { basename, timestamp, collision };\n}\n","/**\n * Pure-ish version operations against a {@link ContentContainer}.\n *\n * These functions are the canonical implementation. {@link DocumentVersionManager}\n * is a thin wrapper that captures a container reference for ergonomics.\n */\n\nimport type { ContentContainer } from '../storage/ContentContainer.js';\nimport { buildVersionPath, getDocBasename, parseVersionPath, VERSIONS_PREFIX } from './paths.js';\nimport type {\n CoalesceOptions,\n PrunePolicy,\n RevertOptions,\n SaveVersionOptions,\n SaveVersionResult,\n Version,\n} from './types.js';\n\nconst decoder = new TextDecoder();\nconst encoder = new TextEncoder();\n\nasync function resolveBasename(\n container: ContentContainer,\n override: string | undefined,\n): Promise<string | null> {\n if (override) return override;\n const docPath = await container.getDocumentPath();\n if (!docPath) return null;\n return getDocBasename(docPath);\n}\n\nasync function resolveDocPath(container: ContentContainer): Promise<string> {\n // Default to `index.md` when the container has no document yet — matches\n // `MemoryContentContainer.writeDocument`'s default.\n const docPath = await container.getDocumentPath();\n return docPath ?? 'index.md';\n}\n\n/**\n * List all snapshots in the container, newest-first.\n *\n * @param basename Optional filter: when set, only versions whose basename\n * matches are returned.\n */\nexport async function listVersions(\n container: ContentContainer,\n basename?: string,\n): Promise<Version[]> {\n const entries = await container.listFiles(VERSIONS_PREFIX);\n const versions: Version[] = [];\n for (const entry of entries) {\n const parsed = parseVersionPath(entry.path);\n if (!parsed) continue;\n if (basename !== undefined && parsed.basename !== basename) continue;\n versions.push({\n path: entry.path,\n basename: parsed.basename,\n timestamp: parsed.timestamp,\n size: entry.size,\n collision: parsed.collision,\n });\n }\n // Newest first. Tie-break on collision (higher = newer). Compare the\n // numeric collision rather than the path string: lexicographically a path\n // with no suffix sorts *after* one with `-N`, because `.` (0x2E) is\n // greater than `-` (0x2D), which would invert the order.\n versions.sort((a, b) => {\n const dt = b.timestamp.getTime() - a.timestamp.getTime();\n if (dt !== 0) return dt;\n return b.collision - a.collision;\n });\n return versions;\n}\n\n/**\n * Read the markdown content of a snapshot. Returns null if the snapshot\n * doesn't exist.\n */\nexport async function readVersion(\n container: ContentContainer,\n version: Version | string,\n): Promise<string | null> {\n const path = typeof version === 'string' ? version : version.path;\n const data = await container.readFile(path);\n if (!data) return null;\n return decoder.decode(data);\n}\n\n/**\n * Save a new snapshot of the document if its content differs from the\n * latest existing snapshot.\n */\nexport async function saveVersion(\n container: ContentContainer,\n options: SaveVersionOptions = {},\n): Promise<SaveVersionResult> {\n const content = options.content ?? (await container.readDocument());\n if (content === null || content === undefined) {\n return { saved: false, version: null, reason: 'no-document' };\n }\n if (content.length === 0) {\n return { saved: false, version: null, reason: 'empty' };\n }\n\n const basename = await resolveBasename(container, options.basename);\n if (!basename) {\n return { saved: false, version: null, reason: 'no-document' };\n }\n\n const versions = await listVersions(container, basename);\n if (!options.force && versions.length > 0) {\n const latest = versions[0]!;\n const existing = await readVersion(container, latest);\n if (existing === content) {\n return { saved: false, version: null, reason: 'unchanged' };\n }\n }\n\n const now = options.now ?? new Date();\n let collision = 0;\n let path = buildVersionPath(basename, now, collision);\n while (await container.exists(path)) {\n collision += 1;\n path = buildVersionPath(basename, now, collision);\n }\n\n const data = encoder.encode(content);\n await container.writeFile(path, data, 'text/markdown');\n\n const version: Version = {\n path,\n basename,\n timestamp: now,\n size: data.byteLength,\n collision,\n };\n return { saved: true, version, reason: 'saved' };\n}\n\n/**\n * Revert the document to a prior snapshot. By default, the *current*\n * document is snapshotted first so the revert is itself recoverable.\n */\nexport async function revertToVersion(\n container: ContentContainer,\n version: Version | string,\n options: RevertOptions = {},\n): Promise<{ reverted: boolean; snapshotted: Version | null }> {\n const content = await readVersion(container, version);\n if (content === null) {\n return { reverted: false, snapshotted: null };\n }\n\n let snapshotted: Version | null = null;\n if (options.snapshotCurrent !== false) {\n const result = await saveVersion(container);\n snapshotted = result.version;\n }\n\n const docPath = await resolveDocPath(container);\n await container.writeDocument(content, docPath);\n return { reverted: true, snapshotted };\n}\n\n/**\n * Delete snapshots that don't satisfy the policy. Returns the deleted\n * versions in their original (newest-first) order.\n */\nexport async function pruneVersions(\n container: ContentContainer,\n policy: PrunePolicy,\n basename?: string,\n): Promise<Version[]> {\n const versions = await listVersions(container, basename);\n const toDelete: Version[] = [];\n\n if (policy.type === 'keep-last-n') {\n const n = Math.max(0, Math.floor(policy.n));\n toDelete.push(...versions.slice(n));\n } else if (policy.type === 'older-than') {\n const cutoff = policy.date.getTime();\n for (const v of versions) {\n if (v.timestamp.getTime() < cutoff) toDelete.push(v);\n }\n } else {\n for (const v of versions) {\n if (!policy.keep(v, versions)) toDelete.push(v);\n }\n }\n\n for (const v of toDelete) {\n await container.removeFile(v.path);\n }\n return toDelete;\n}\n\n/**\n * Collapse adjacent snapshots that occurred close together — keeping the\n * newer one — to keep history readable across rapid edits.\n */\nexport async function coalesceVersions(\n container: ContentContainer,\n options: CoalesceOptions = {},\n basename?: string,\n): Promise<Version[]> {\n const windowMs = options.windowMs ?? 60_000;\n const versions = await listVersions(container, basename);\n const toDelete: Version[] = [];\n // Walk newest -> oldest, anchored to the last *kept* snapshot. Any\n // candidate within `windowMs` of the anchor is dropped; the first one\n // outside the window becomes the new anchor. Comparing each pair against\n // its previous neighbor instead would chain through deleted snapshots\n // and over-prune any tightly-clustered run (e.g. 30s apart with a 60s\n // window collapses to a single survivor).\n if (versions.length > 0) {\n let anchor = versions[0]!;\n for (let i = 1; i < versions.length; i++) {\n const candidate = versions[i]!;\n if (anchor.timestamp.getTime() - candidate.timestamp.getTime() <= windowMs) {\n toDelete.push(candidate);\n } else {\n anchor = candidate;\n }\n }\n }\n for (const v of toDelete) {\n await container.removeFile(v.path);\n }\n return toDelete;\n}\n","/**\n * Convenience wrapper around the version operations that captures a\n * {@link ContentContainer} reference and an optional basename override.\n *\n * Hosts that prefer a stable handle (e.g. to pass into a UI component)\n * use this; everything it does is also reachable as a free function.\n */\n\nimport type { ContentContainer } from '../storage/ContentContainer.js';\nimport {\n coalesceVersions,\n listVersions,\n pruneVersions,\n readVersion,\n revertToVersion,\n saveVersion,\n} from './operations.js';\nimport type {\n CoalesceOptions,\n PrunePolicy,\n RevertOptions,\n SaveVersionOptions,\n SaveVersionResult,\n Version,\n} from './types.js';\n\nexport interface DocumentVersionManagerOptions {\n /**\n * Override the document basename used in version filenames. Defaults to\n * the basename of `container.getDocumentPath()` resolved at call time.\n */\n basename?: string;\n}\n\nexport class DocumentVersionManager {\n private readonly container: ContentContainer;\n private readonly basename: string | undefined;\n\n constructor(container: ContentContainer, options: DocumentVersionManagerOptions = {}) {\n this.container = container;\n this.basename = options.basename;\n }\n\n saveVersion(options: SaveVersionOptions = {}): Promise<SaveVersionResult> {\n return saveVersion(this.container, { basename: this.basename, ...options });\n }\n\n listVersions(): Promise<Version[]> {\n return listVersions(this.container, this.basename);\n }\n\n readVersion(version: Version | string): Promise<string | null> {\n return readVersion(this.container, version);\n }\n\n revertToVersion(\n version: Version | string,\n options?: RevertOptions,\n ): Promise<{ reverted: boolean; snapshotted: Version | null }> {\n return revertToVersion(this.container, version, options);\n }\n\n pruneVersions(policy: PrunePolicy): Promise<Version[]> {\n return pruneVersions(this.container, policy, this.basename);\n }\n\n coalesceVersions(options?: CoalesceOptions): Promise<Version[]> {\n return coalesceVersions(this.container, options, this.basename);\n }\n}\n"],"mappings":"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","names":[]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/timing/narrationTiming.ts","../src/timing/readingTime.ts"],"sourcesContent":["/**\n * Narration timing estimation.\n *\n * Estimates how long text takes to speak aloud, accounting for:\n * - Numbers spoken as multiple words (e.g., \"1910\" → \"nineteen ten\")\n * - Pauses at commas\n * - Year pronunciation conventions (1000–2099)\n *\n * Ported from qualla-internal's AudioTiming.ts (pure functions, no Node.js deps).\n */\n\n/** Numbers are spoken more slowly than regular words (1.3× multiplier). */\nconst NUMBER_SPEAKING_MULTIPLIER = 1.3;\n\n/** Comma pause in \"word equivalents\" — speakers pause ~0.3 words at commas. */\nconst COMMA_PAUSE_PENALTY = 0.3;\n\n/** Default speaking rate in words per second (~150 WPM). */\nexport const DEFAULT_WORDS_PER_SECOND = 2.5;\n\n/**\n * Estimate how many \"spoken word equivalents\" a single token represents.\n * Numbers get expanded (e.g., \"175,000\" → ~5 words × 1.3 multiplier).\n */\nexport function estimateSpokenWordCount(token: string): number {\n const cleaned = token.replace(/,/g, '');\n const num = parseFloat(cleaned);\n\n if (isNaN(num) || !isFinite(num)) {\n return 1; // Not a number — count as 1 word\n }\n\n return estimateNumberWordCount(cleaned, num) * NUMBER_SPEAKING_MULTIPLIER;\n}\n\n/**\n * Raw word count for a number (before the speaking multiplier).\n */\nfunction estimateNumberWordCount(cleaned: string, num: number): number {\n // Handle decimals: \"3.14\" → words(\"3\") + \"point\" + 2 digits\n if (cleaned.includes('.')) {\n const [whole, decimal] = cleaned.split('.');\n const wholeNum = parseFloat(whole) || 0;\n return estimateNumberWordCount(whole, wholeNum) + 1 + decimal.length;\n }\n\n const absNum = Math.abs(num);\n let words = num < 0 ? 1 : 0; // \"negative\" / \"minus\"\n\n if (absNum === 0) return 1; // \"zero\"\n\n // Years (1000–2099) are spoken as two two-digit groups:\n // \"1910\" → \"nineteen ten\", \"2024\" → \"twenty twenty-four\"\n if (absNum >= 1000 && absNum <= 2099 && Number.isInteger(absNum)) {\n const yearStr = absNum.toString();\n if (yearStr.length === 4) {\n const firstTwo = parseInt(yearStr.slice(0, 2));\n const lastTwo = parseInt(yearStr.slice(2));\n\n // First part\n if (firstTwo >= 10 && firstTwo <= 19) {\n words += 1;\n } else if (firstTwo >= 20 && firstTwo <= 99) {\n words += firstTwo % 10 === 0 ? 1 : 2;\n } else {\n words += 2; // \"two thousand\"\n }\n\n // Second part\n if (lastTwo === 0) {\n if (firstTwo >= 10 && firstTwo <= 99 && firstTwo !== 20) {\n words += 1; // \"hundred\"\n }\n } else if (lastTwo >= 1 && lastTwo <= 9) {\n words += 2; // \"oh five\"\n } else if (lastTwo >= 10 && lastTwo <= 19) {\n words += 1;\n } else {\n words += lastTwo % 10 === 0 ? 1 : 2;\n }\n\n return Math.max(words, 2);\n }\n }\n\n // General number handling — each magnitude group adds words\n let remaining = absNum;\n\n if (remaining >= 1_000_000_000) {\n const billions = Math.floor(remaining / 1_000_000_000);\n words += estimateNumberWordCount(String(billions), billions);\n words += 1; // \"billion\"\n remaining %= 1_000_000_000;\n }\n\n if (remaining >= 1_000_000) {\n const millions = Math.floor(remaining / 1_000_000);\n words += estimateNumberWordCount(String(millions), millions);\n words += 1; // \"million\"\n remaining %= 1_000_000;\n }\n\n if (remaining >= 1_000) {\n const thousands = Math.floor(remaining / 1_000);\n words += estimateNumberWordCount(String(thousands), thousands);\n words += 1; // \"thousand\"\n remaining %= 1_000;\n }\n\n if (remaining >= 100) {\n words += 2; // digit + \"hundred\"\n remaining %= 100;\n }\n\n if (remaining >= 1) {\n if (remaining >= 20) {\n words += remaining % 10 === 0 ? 1 : 2;\n } else {\n words += 1; // 1–19\n }\n }\n\n return Math.max(words, 1);\n}\n\n/**\n * Count \"spoken word equivalents\" in a block of text,\n * expanding numbers and adding comma pauses.\n */\nexport function countSpokenWords(text: string): number {\n const tokens = text.split(/\\s+/).filter((w) => w.length > 0);\n let count = 0;\n\n for (const token of tokens) {\n // Strip punctuation only at token boundaries so internal punctuation\n // (e.g., decimals like \"3.14\" or digit-grouping commas \"1,000\") is preserved.\n const stripped = token.replace(/^[.,!?;:'\"()[\\]{}]+|[.,!?;:'\"()[\\]{}]+$/g, '');\n count += estimateSpokenWordCount(stripped);\n\n // Count only punctuation commas for pauses: exclude digit-grouping commas\n // (i.e., commas with digits on both sides, like in \"1,234\").\n let punctuationCommaCount = 0;\n for (let i = 0; i < token.length; i++) {\n if (token[i] === ',') {\n const prev = i > 0 ? token[i - 1] : '';\n const next = i < token.length - 1 ? token[i + 1] : '';\n const prevIsDigit = prev >= '0' && prev <= '9';\n const nextIsDigit = next >= '0' && next <= '9';\n if (!(prevIsDigit && nextIsDigit)) {\n punctuationCommaCount++;\n }\n }\n }\n count += punctuationCommaCount * COMMA_PAUSE_PENALTY;\n }\n\n return count;\n}\n\n/**\n * Estimate audio time at a character offset using word-proportion mapping.\n *\n * Given the full source text and a character position, returns the\n * estimated time (in seconds) at which that position would be spoken.\n *\n * @param text - Full source text\n * @param charOffset - Character offset to estimate timing for\n * @param totalDuration - Total audio duration in seconds\n * @returns Estimated time in seconds\n */\nexport function estimateTimeFromText(\n text: string,\n charOffset: number,\n totalDuration: number,\n): number {\n const textBefore = text.slice(0, charOffset);\n const spokenWordsBefore = countSpokenWords(textBefore);\n const totalSpokenWords = countSpokenWords(text);\n\n if (totalSpokenWords === 0) return 0;\n return (spokenWordsBefore / totalSpokenWords) * totalDuration;\n}\n\n/**\n * Estimate how long a spoken prefix adds to audio duration.\n *\n * When audio includes a spoken title or header before the main content,\n * this calculates the extra duration to offset timing calculations.\n *\n * @param prefix - Prefix text (e.g., an article title spoken before the body)\n * @param wordsPerSecond - Speaking rate (default: 2.5)\n * @returns Estimated duration in seconds\n */\nexport function calculatePrefixDuration(\n prefix: string,\n wordsPerSecond: number = DEFAULT_WORDS_PER_SECOND,\n): number {\n if (!prefix) return 0;\n\n const words = prefix.split(/\\s+/).filter((w) => w.length > 0);\n const newlineCount = (prefix.match(/\\n\\n/g) || []).length;\n const pauseTime = newlineCount * 0.5;\n\n return words.length / wordsPerSecond + pauseTime;\n}\n\n/**\n * Estimate narration duration for a block of text.\n *\n * @param text - The text to estimate\n * @param wordsPerSecond - Speaking rate (default: 2.5, i.e. ~150 WPM)\n * @returns Duration in seconds\n */\nexport function estimateNarrationDuration(\n text: string,\n wordsPerSecond: number = DEFAULT_WORDS_PER_SECOND,\n): number {\n const spokenWords = countSpokenWords(text);\n return spokenWords / wordsPerSecond;\n}\n","/**\n * Reading time estimation.\n *\n * Estimates how long it takes to read text silently vs. narrate it aloud.\n * Uses configurable words-per-minute rates.\n */\n\nimport { countSpokenWords, DEFAULT_WORDS_PER_SECOND } from './narrationTiming.js';\n\n/** Default silent reading rate (adults average ~200–250 WPM). */\nconst DEFAULT_READING_WPM = 200;\n\n/** Result of a reading-time estimate. */\nexport interface ReadingTimeEstimate {\n /** Number of words (plain word count, not spoken equivalents). */\n words: number;\n /** Estimated minutes (decimal). */\n minutes: number;\n /** Estimated seconds (rounded). */\n seconds: number;\n}\n\n/** Options for reading-time estimation. */\nexport interface ReadingTimeOptions {\n /** Words per minute for silent reading (default: 200). */\n wordsPerMinute?: number;\n}\n\n/**\n * Estimate silent reading time for a block of text.\n *\n * @param text - The text to estimate\n * @param options - Optional configuration\n * @returns Word count + time estimate\n */\nexport function estimateReadingTime(\n text: string,\n options?: ReadingTimeOptions,\n): ReadingTimeEstimate {\n const configuredWpm = options?.wordsPerMinute;\n const wpm =\n typeof configuredWpm === 'number' && configuredWpm > 0 ? configuredWpm : DEFAULT_READING_WPM;\n const words = text.split(/\\s+/).filter((w) => w.length > 0).length;\n const minutes = words / wpm;\n\n return {\n words,\n minutes,\n seconds: Math.round(minutes * 60),\n };\n}\n\n/** Result of a narration-time estimate. */\nexport interface NarrationTimeEstimate {\n /** Spoken word equivalents (numbers expanded, comma pauses added). */\n spokenWords: number;\n /** Estimated minutes (decimal). */\n minutes: number;\n /** Estimated seconds (rounded). */\n seconds: number;\n}\n\n/** Options for narration-time estimation. */\nexport interface NarrationTimeOptions {\n /** Words per second for narration (default: 2.5 ≈ 150 WPM). */\n wordsPerSecond?: number;\n}\n\n/**\n * Estimate narration (spoken) time for a block of text.\n *\n * Unlike silent reading, this accounts for numbers being spoken as\n * multiple words and pauses at commas.\n *\n * @param text - The text to estimate\n * @param options - Optional configuration\n * @returns Spoken word equivalents + time estimate\n */\nexport function estimateNarrationTime(\n text: string,\n options?: NarrationTimeOptions,\n): NarrationTimeEstimate {\n const providedWps = options?.wordsPerSecond;\n const wps =\n typeof providedWps === 'number' && providedWps > 0 ? providedWps : DEFAULT_WORDS_PER_SECOND;\n const spokenWords = countSpokenWords(text);\n const totalSeconds = spokenWords / wps;\n\n return {\n spokenWords,\n minutes: totalSeconds / 60,\n seconds: Math.round(totalSeconds),\n };\n}\n"],"mappings":"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","names":[]}