@graphty/graph-io 0.3.25 → 0.3.27

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 (581) hide show
  1. package/README.md +49 -414
  2. package/dist/chunks/children-CL3Cy0ez.js.map +1 -1
  3. package/dist/chunks/choose-DrXtu_96.js +56 -0
  4. package/dist/chunks/choose-DrXtu_96.js.map +1 -0
  5. package/dist/chunks/constants-ikG85dT8.js +231 -0
  6. package/dist/chunks/constants-ikG85dT8.js.map +1 -0
  7. package/dist/chunks/{escape-B-tkk_Cl.js → escape-D1HPTUrP.js} +390 -99
  8. package/dist/chunks/escape-D1HPTUrP.js.map +1 -0
  9. package/dist/chunks/export-CHd4tQE2.js +4333 -0
  10. package/dist/chunks/export-CHd4tQE2.js.map +1 -0
  11. package/dist/chunks/{importer-eUREhBGj.js → exporter-D23CKNqF.js} +4969 -3201
  12. package/dist/chunks/exporter-D23CKNqF.js.map +1 -0
  13. package/dist/chunks/{exporter-DIeGJXAZ.js → exporter-DfWTgrti.js} +23 -21
  14. package/dist/chunks/exporter-DfWTgrti.js.map +1 -0
  15. package/dist/chunks/exporter-DhtW6FxK.js +3465 -0
  16. package/dist/chunks/exporter-DhtW6FxK.js.map +1 -0
  17. package/dist/chunks/{exporter-BGrsWamJ.js → exporter-IHv4nkCm.js} +38 -229
  18. package/dist/chunks/exporter-IHv4nkCm.js.map +1 -0
  19. package/dist/chunks/{importer-BWY2FFc5.js → importer-B1wmPQjr.js} +255 -77
  20. package/dist/chunks/importer-B1wmPQjr.js.map +1 -0
  21. package/dist/chunks/{importer-D_e7e7LX.js → importer-B2W_58pz.js} +399 -146
  22. package/dist/chunks/importer-B2W_58pz.js.map +1 -0
  23. package/dist/chunks/importer-BSALvkui.js +2811 -0
  24. package/dist/chunks/importer-BSALvkui.js.map +1 -0
  25. package/dist/chunks/{importer-vi3bSdtw.js → importer-BVRE--Un.js} +510 -77
  26. package/dist/chunks/importer-BVRE--Un.js.map +1 -0
  27. package/dist/chunks/{importer-DET1tg6s.js → importer-CIAzt-wo.js} +1689 -312
  28. package/dist/chunks/importer-CIAzt-wo.js.map +1 -0
  29. package/dist/chunks/{importer-DIrbbnAf.js → importer-DpEW5zeG.js} +585 -226
  30. package/dist/chunks/importer-DpEW5zeG.js.map +1 -0
  31. package/dist/chunks/{importer-zGLo8Dg_.js → importer-z_FL4VMb.js} +488 -161
  32. package/dist/chunks/importer-z_FL4VMb.js.map +1 -0
  33. package/dist/chunks/json-elements-BAmNBZok.js +1225 -0
  34. package/dist/chunks/json-elements-BAmNBZok.js.map +1 -0
  35. package/dist/chunks/ontology-export-Bab4eUA8.js +357 -0
  36. package/dist/chunks/ontology-export-Bab4eUA8.js.map +1 -0
  37. package/dist/chunks/{records-dbRkxwaq.js → records-CdlvL4RO.js} +298 -114
  38. package/dist/chunks/records-CdlvL4RO.js.map +1 -0
  39. package/dist/chunks/{text-Dr0Ifpag.js → text-DzXjAiTl.js} +29 -11
  40. package/dist/chunks/text-DzXjAiTl.js.map +1 -0
  41. package/dist/chunks/{writer-C7flM-Ih.js → writer-DxjgHwSe.js} +19 -1
  42. package/dist/chunks/writer-DxjgHwSe.js.map +1 -0
  43. package/dist/csv.js +952 -262
  44. package/dist/csv.js.map +1 -1
  45. package/dist/cx.js +6 -3
  46. package/dist/cx2.js +2 -2
  47. package/dist/cys.js +6 -3
  48. package/dist/dot.js +1 -1
  49. package/dist/gexf.js +554 -122
  50. package/dist/gexf.js.map +1 -1
  51. package/dist/gml.js +344 -87
  52. package/dist/gml.js.map +1 -1
  53. package/dist/graph-io.js +1105 -213
  54. package/dist/graph-io.js.map +1 -1
  55. package/dist/graphml.js +3 -2
  56. package/dist/graphml.js.map +1 -1
  57. package/dist/json.js +3 -2
  58. package/dist/neo4j.js +565 -158
  59. package/dist/neo4j.js.map +1 -1
  60. package/dist/obo.js +6 -3
  61. package/dist/pajek.js +1 -1
  62. package/dist/src/children.d.ts +18 -6
  63. package/dist/src/children.d.ts.map +1 -1
  64. package/dist/src/children.js +6 -3
  65. package/dist/src/children.js.map +1 -1
  66. package/dist/src/common/attributes.d.ts +29 -11
  67. package/dist/src/common/attributes.d.ts.map +1 -1
  68. package/dist/src/common/attributes.js +25 -7
  69. package/dist/src/common/attributes.js.map +1 -1
  70. package/dist/src/common/cell-budget.d.ts +9 -2
  71. package/dist/src/common/cell-budget.d.ts.map +1 -1
  72. package/dist/src/common/cell-budget.js +11 -3
  73. package/dist/src/common/cell-budget.js.map +1 -1
  74. package/dist/src/common/choose.d.ts +19 -0
  75. package/dist/src/common/choose.d.ts.map +1 -0
  76. package/dist/src/common/choose.js +72 -0
  77. package/dist/src/common/choose.js.map +1 -0
  78. package/dist/src/common/codes.d.ts +456 -66
  79. package/dist/src/common/codes.d.ts.map +1 -1
  80. package/dist/src/common/codes.js +458 -66
  81. package/dist/src/common/codes.js.map +1 -1
  82. package/dist/src/common/compare.d.ts +81 -0
  83. package/dist/src/common/compare.d.ts.map +1 -0
  84. package/dist/src/common/compare.js +394 -0
  85. package/dist/src/common/compare.js.map +1 -0
  86. package/dist/src/common/cx-export.d.ts +123 -0
  87. package/dist/src/common/cx-export.d.ts.map +1 -0
  88. package/dist/src/common/cx-export.js +334 -0
  89. package/dist/src/common/cx-export.js.map +1 -0
  90. package/dist/src/common/declared-types.d.ts +22 -2
  91. package/dist/src/common/declared-types.d.ts.map +1 -1
  92. package/dist/src/common/declared-types.js +21 -3
  93. package/dist/src/common/declared-types.js.map +1 -1
  94. package/dist/src/common/direction.d.ts +74 -50
  95. package/dist/src/common/direction.d.ts.map +1 -1
  96. package/dist/src/common/direction.js +47 -27
  97. package/dist/src/common/direction.js.map +1 -1
  98. package/dist/src/common/escape.d.ts +21 -9
  99. package/dist/src/common/escape.d.ts.map +1 -1
  100. package/dist/src/common/escape.js +39 -22
  101. package/dist/src/common/escape.js.map +1 -1
  102. package/dist/src/common/export.d.ts +144 -32
  103. package/dist/src/common/export.d.ts.map +1 -1
  104. package/dist/src/common/export.js +216 -42
  105. package/dist/src/common/export.js.map +1 -1
  106. package/dist/src/common/format.d.ts +23 -1
  107. package/dist/src/common/format.d.ts.map +1 -1
  108. package/dist/src/common/format.js +26 -1
  109. package/dist/src/common/format.js.map +1 -1
  110. package/dist/src/common/ids.d.ts +9 -2
  111. package/dist/src/common/ids.d.ts.map +1 -1
  112. package/dist/src/common/ids.js +6 -2
  113. package/dist/src/common/ids.js.map +1 -1
  114. package/dist/src/common/input.d.ts +122 -28
  115. package/dist/src/common/input.d.ts.map +1 -1
  116. package/dist/src/common/input.js +890 -124
  117. package/dist/src/common/input.js.map +1 -1
  118. package/dist/src/common/json-elements.d.ts +144 -20
  119. package/dist/src/common/json-elements.d.ts.map +1 -1
  120. package/dist/src/common/json-elements.js +869 -189
  121. package/dist/src/common/json-elements.js.map +1 -1
  122. package/dist/src/common/line-format.d.ts +90 -0
  123. package/dist/src/common/line-format.d.ts.map +1 -0
  124. package/dist/src/common/line-format.js +185 -0
  125. package/dist/src/common/line-format.js.map +1 -0
  126. package/dist/src/common/lists.d.ts +6 -1
  127. package/dist/src/common/lists.d.ts.map +1 -1
  128. package/dist/src/common/lists.js +3 -1
  129. package/dist/src/common/lists.js.map +1 -1
  130. package/dist/src/common/ontology-export.d.ts +167 -0
  131. package/dist/src/common/ontology-export.d.ts.map +1 -0
  132. package/dist/src/common/ontology-export.js +359 -0
  133. package/dist/src/common/ontology-export.js.map +1 -0
  134. package/dist/src/common/ontology.d.ts +25 -3
  135. package/dist/src/common/ontology.d.ts.map +1 -1
  136. package/dist/src/common/ontology.js +30 -9
  137. package/dist/src/common/ontology.js.map +1 -1
  138. package/dist/src/common/options.d.ts +62 -12
  139. package/dist/src/common/options.d.ts.map +1 -1
  140. package/dist/src/common/options.js +89 -11
  141. package/dist/src/common/options.js.map +1 -1
  142. package/dist/src/common/plural.d.ts +31 -0
  143. package/dist/src/common/plural.d.ts.map +1 -0
  144. package/dist/src/common/plural.js +46 -0
  145. package/dist/src/common/plural.js.map +1 -0
  146. package/dist/src/common/report.d.ts +72 -14
  147. package/dist/src/common/report.d.ts.map +1 -1
  148. package/dist/src/common/report.js +146 -22
  149. package/dist/src/common/report.js.map +1 -1
  150. package/dist/src/common/temporal.d.ts +22 -5
  151. package/dist/src/common/temporal.d.ts.map +1 -1
  152. package/dist/src/common/temporal.js +13 -2
  153. package/dist/src/common/temporal.js.map +1 -1
  154. package/dist/src/common/text.d.ts +39 -23
  155. package/dist/src/common/text.d.ts.map +1 -1
  156. package/dist/src/common/text.js +51 -21
  157. package/dist/src/common/text.js.map +1 -1
  158. package/dist/src/common/weights.d.ts +37 -4
  159. package/dist/src/common/weights.d.ts.map +1 -1
  160. package/dist/src/common/weights.js +61 -2
  161. package/dist/src/common/weights.js.map +1 -1
  162. package/dist/src/common/writer.d.ts +19 -3
  163. package/dist/src/common/writer.d.ts.map +1 -1
  164. package/dist/src/common/writer.js +30 -2
  165. package/dist/src/common/writer.js.map +1 -1
  166. package/dist/src/common/xml.d.ts +125 -9
  167. package/dist/src/common/xml.d.ts.map +1 -1
  168. package/dist/src/common/xml.js +402 -85
  169. package/dist/src/common/xml.js.map +1 -1
  170. package/dist/src/common/zip.d.ts +44 -4
  171. package/dist/src/common/zip.d.ts.map +1 -1
  172. package/dist/src/common/zip.js +134 -5
  173. package/dist/src/common/zip.js.map +1 -1
  174. package/dist/src/formats/csv/exporter.d.ts +80 -24
  175. package/dist/src/formats/csv/exporter.d.ts.map +1 -1
  176. package/dist/src/formats/csv/exporter.js +146 -33
  177. package/dist/src/formats/csv/exporter.js.map +1 -1
  178. package/dist/src/formats/csv/header.d.ts +38 -9
  179. package/dist/src/formats/csv/header.d.ts.map +1 -1
  180. package/dist/src/formats/csv/header.js +46 -10
  181. package/dist/src/formats/csv/header.js.map +1 -1
  182. package/dist/src/formats/csv/importer.d.ts +187 -37
  183. package/dist/src/formats/csv/importer.d.ts.map +1 -1
  184. package/dist/src/formats/csv/importer.js +835 -204
  185. package/dist/src/formats/csv/importer.js.map +1 -1
  186. package/dist/src/formats/csv/index.d.ts +100 -19
  187. package/dist/src/formats/csv/index.d.ts.map +1 -1
  188. package/dist/src/formats/csv/index.js +94 -21
  189. package/dist/src/formats/csv/index.js.map +1 -1
  190. package/dist/src/formats/csv/records.d.ts +95 -10
  191. package/dist/src/formats/csv/records.d.ts.map +1 -1
  192. package/dist/src/formats/csv/records.js +333 -122
  193. package/dist/src/formats/csv/records.js.map +1 -1
  194. package/dist/src/formats/csv/values.d.ts +1 -0
  195. package/dist/src/formats/csv/values.d.ts.map +1 -1
  196. package/dist/src/formats/csv/values.js +1 -0
  197. package/dist/src/formats/csv/values.js.map +1 -1
  198. package/dist/src/formats/cx/exporter.d.ts +102 -0
  199. package/dist/src/formats/cx/exporter.d.ts.map +1 -0
  200. package/dist/src/formats/cx/exporter.js +1217 -0
  201. package/dist/src/formats/cx/exporter.js.map +1 -0
  202. package/dist/src/formats/cx/importer.d.ts +79 -32
  203. package/dist/src/formats/cx/importer.d.ts.map +1 -1
  204. package/dist/src/formats/cx/importer.js +682 -287
  205. package/dist/src/formats/cx/importer.js.map +1 -1
  206. package/dist/src/formats/cx/index.d.ts +4 -3
  207. package/dist/src/formats/cx/index.d.ts.map +1 -1
  208. package/dist/src/formats/cx/index.js +4 -3
  209. package/dist/src/formats/cx/index.js.map +1 -1
  210. package/dist/src/formats/cx2/exporter.d.ts +29 -11
  211. package/dist/src/formats/cx2/exporter.d.ts.map +1 -1
  212. package/dist/src/formats/cx2/exporter.js +39 -268
  213. package/dist/src/formats/cx2/exporter.js.map +1 -1
  214. package/dist/src/formats/cx2/importer.d.ts +78 -28
  215. package/dist/src/formats/cx2/importer.d.ts.map +1 -1
  216. package/dist/src/formats/cx2/importer.js +227 -80
  217. package/dist/src/formats/cx2/importer.js.map +1 -1
  218. package/dist/src/formats/cx2/index.d.ts +2 -1
  219. package/dist/src/formats/cx2/index.d.ts.map +1 -1
  220. package/dist/src/formats/cx2/index.js +2 -1
  221. package/dist/src/formats/cx2/index.js.map +1 -1
  222. package/dist/src/formats/cys/constants.d.ts +66 -17
  223. package/dist/src/formats/cys/constants.d.ts.map +1 -1
  224. package/dist/src/formats/cys/constants.js +59 -18
  225. package/dist/src/formats/cys/constants.js.map +1 -1
  226. package/dist/src/formats/cys/exporter.d.ts +118 -0
  227. package/dist/src/formats/cys/exporter.d.ts.map +1 -0
  228. package/dist/src/formats/cys/exporter.js +1072 -0
  229. package/dist/src/formats/cys/exporter.js.map +1 -0
  230. package/dist/src/formats/cys/importer.d.ts +22 -8
  231. package/dist/src/formats/cys/importer.d.ts.map +1 -1
  232. package/dist/src/formats/cys/importer.js +510 -149
  233. package/dist/src/formats/cys/importer.js.map +1 -1
  234. package/dist/src/formats/cys/index.d.ts +4 -2
  235. package/dist/src/formats/cys/index.d.ts.map +1 -1
  236. package/dist/src/formats/cys/index.js +4 -2
  237. package/dist/src/formats/cys/index.js.map +1 -1
  238. package/dist/src/formats/cys/session.d.ts +46 -7
  239. package/dist/src/formats/cys/session.d.ts.map +1 -1
  240. package/dist/src/formats/cys/session.js +101 -27
  241. package/dist/src/formats/cys/session.js.map +1 -1
  242. package/dist/src/formats/cys/tables.d.ts +9 -2
  243. package/dist/src/formats/cys/tables.d.ts.map +1 -1
  244. package/dist/src/formats/cys/tables.js +29 -7
  245. package/dist/src/formats/cys/tables.js.map +1 -1
  246. package/dist/src/formats/dot/exporter.d.ts +42 -14
  247. package/dist/src/formats/dot/exporter.d.ts.map +1 -1
  248. package/dist/src/formats/dot/exporter.js +56 -29
  249. package/dist/src/formats/dot/exporter.js.map +1 -1
  250. package/dist/src/formats/dot/importer.d.ts +91 -29
  251. package/dist/src/formats/dot/importer.d.ts.map +1 -1
  252. package/dist/src/formats/dot/importer.js +190 -39
  253. package/dist/src/formats/dot/importer.js.map +1 -1
  254. package/dist/src/formats/dot/index.d.ts +2 -1
  255. package/dist/src/formats/dot/index.d.ts.map +1 -1
  256. package/dist/src/formats/dot/index.js +2 -1
  257. package/dist/src/formats/dot/index.js.map +1 -1
  258. package/dist/src/formats/dot/names.d.ts +44 -11
  259. package/dist/src/formats/dot/names.d.ts.map +1 -1
  260. package/dist/src/formats/dot/names.js +44 -11
  261. package/dist/src/formats/dot/names.js.map +1 -1
  262. package/dist/src/formats/dot/tokenizer.d.ts +9 -2
  263. package/dist/src/formats/dot/tokenizer.d.ts.map +1 -1
  264. package/dist/src/formats/dot/tokenizer.js +20 -5
  265. package/dist/src/formats/dot/tokenizer.js.map +1 -1
  266. package/dist/src/formats/gexf/exporter.d.ts +46 -15
  267. package/dist/src/formats/gexf/exporter.d.ts.map +1 -1
  268. package/dist/src/formats/gexf/exporter.js +45 -15
  269. package/dist/src/formats/gexf/exporter.js.map +1 -1
  270. package/dist/src/formats/gexf/importer.d.ts +87 -23
  271. package/dist/src/formats/gexf/importer.d.ts.map +1 -1
  272. package/dist/src/formats/gexf/importer.js +471 -90
  273. package/dist/src/formats/gexf/importer.js.map +1 -1
  274. package/dist/src/formats/gexf/index.d.ts +84 -21
  275. package/dist/src/formats/gexf/index.d.ts.map +1 -1
  276. package/dist/src/formats/gexf/index.js +80 -23
  277. package/dist/src/formats/gexf/index.js.map +1 -1
  278. package/dist/src/formats/gexf/schema.d.ts +67 -15
  279. package/dist/src/formats/gexf/schema.d.ts.map +1 -1
  280. package/dist/src/formats/gexf/schema.js +59 -13
  281. package/dist/src/formats/gexf/schema.js.map +1 -1
  282. package/dist/src/formats/gml/exporter.d.ts +69 -21
  283. package/dist/src/formats/gml/exporter.d.ts.map +1 -1
  284. package/dist/src/formats/gml/exporter.js +74 -29
  285. package/dist/src/formats/gml/exporter.js.map +1 -1
  286. package/dist/src/formats/gml/importer.d.ts +116 -25
  287. package/dist/src/formats/gml/importer.d.ts.map +1 -1
  288. package/dist/src/formats/gml/importer.js +290 -61
  289. package/dist/src/formats/gml/importer.js.map +1 -1
  290. package/dist/src/formats/gml/index.d.ts +87 -24
  291. package/dist/src/formats/gml/index.d.ts.map +1 -1
  292. package/dist/src/formats/gml/index.js +79 -26
  293. package/dist/src/formats/gml/index.js.map +1 -1
  294. package/dist/src/formats/gml/syntax.d.ts +67 -18
  295. package/dist/src/formats/gml/syntax.d.ts.map +1 -1
  296. package/dist/src/formats/gml/syntax.js +110 -28
  297. package/dist/src/formats/gml/syntax.js.map +1 -1
  298. package/dist/src/formats/graphml/constants.d.ts +174 -44
  299. package/dist/src/formats/graphml/constants.d.ts.map +1 -1
  300. package/dist/src/formats/graphml/constants.js +165 -44
  301. package/dist/src/formats/graphml/constants.js.map +1 -1
  302. package/dist/src/formats/graphml/exporter.d.ts +17 -9
  303. package/dist/src/formats/graphml/exporter.d.ts.map +1 -1
  304. package/dist/src/formats/graphml/exporter.js +33 -12
  305. package/dist/src/formats/graphml/exporter.js.map +1 -1
  306. package/dist/src/formats/graphml/importer.d.ts +19 -7
  307. package/dist/src/formats/graphml/importer.d.ts.map +1 -1
  308. package/dist/src/formats/graphml/importer.js +466 -39
  309. package/dist/src/formats/graphml/importer.js.map +1 -1
  310. package/dist/src/formats/graphml/index.d.ts +2 -1
  311. package/dist/src/formats/graphml/index.d.ts.map +1 -1
  312. package/dist/src/formats/graphml/index.js +2 -1
  313. package/dist/src/formats/graphml/index.js.map +1 -1
  314. package/dist/src/formats/graphml/tree.d.ts +6 -2
  315. package/dist/src/formats/graphml/tree.d.ts.map +1 -1
  316. package/dist/src/formats/graphml/tree.js +6 -2
  317. package/dist/src/formats/graphml/tree.js.map +1 -1
  318. package/dist/src/formats/graphml/yfiles.d.ts +8 -3
  319. package/dist/src/formats/graphml/yfiles.d.ts.map +1 -1
  320. package/dist/src/formats/graphml/yfiles.js +36 -15
  321. package/dist/src/formats/graphml/yfiles.js.map +1 -1
  322. package/dist/src/formats/json/dialect.d.ts +88 -24
  323. package/dist/src/formats/json/dialect.d.ts.map +1 -1
  324. package/dist/src/formats/json/dialect.js +109 -19
  325. package/dist/src/formats/json/dialect.js.map +1 -1
  326. package/dist/src/formats/json/exporter.d.ts +134 -22
  327. package/dist/src/formats/json/exporter.d.ts.map +1 -1
  328. package/dist/src/formats/json/exporter.js +135 -54
  329. package/dist/src/formats/json/exporter.js.map +1 -1
  330. package/dist/src/formats/json/importer.d.ts +173 -52
  331. package/dist/src/formats/json/importer.d.ts.map +1 -1
  332. package/dist/src/formats/json/importer.js +899 -220
  333. package/dist/src/formats/json/importer.js.map +1 -1
  334. package/dist/src/formats/json/index.d.ts +3 -2
  335. package/dist/src/formats/json/index.d.ts.map +1 -1
  336. package/dist/src/formats/json/index.js +3 -2
  337. package/dist/src/formats/json/index.js.map +1 -1
  338. package/dist/src/formats/json/obographs-export.d.ts +68 -0
  339. package/dist/src/formats/json/obographs-export.d.ts.map +1 -0
  340. package/dist/src/formats/json/obographs-export.js +941 -0
  341. package/dist/src/formats/json/obographs-export.js.map +1 -0
  342. package/dist/src/formats/json/obographs.d.ts +26 -0
  343. package/dist/src/formats/json/obographs.d.ts.map +1 -1
  344. package/dist/src/formats/json/obographs.js +297 -80
  345. package/dist/src/formats/json/obographs.js.map +1 -1
  346. package/dist/src/formats/neo4j/exporter.d.ts +109 -21
  347. package/dist/src/formats/neo4j/exporter.d.ts.map +1 -1
  348. package/dist/src/formats/neo4j/exporter.js +239 -86
  349. package/dist/src/formats/neo4j/exporter.js.map +1 -1
  350. package/dist/src/formats/neo4j/header.d.ts +17 -4
  351. package/dist/src/formats/neo4j/header.d.ts.map +1 -1
  352. package/dist/src/formats/neo4j/header.js +36 -4
  353. package/dist/src/formats/neo4j/header.js.map +1 -1
  354. package/dist/src/formats/neo4j/importer.d.ts +107 -27
  355. package/dist/src/formats/neo4j/importer.d.ts.map +1 -1
  356. package/dist/src/formats/neo4j/importer.js +415 -63
  357. package/dist/src/formats/neo4j/importer.js.map +1 -1
  358. package/dist/src/formats/neo4j/index.d.ts +73 -23
  359. package/dist/src/formats/neo4j/index.d.ts.map +1 -1
  360. package/dist/src/formats/neo4j/index.js +65 -25
  361. package/dist/src/formats/neo4j/index.js.map +1 -1
  362. package/dist/src/formats/obo/exporter.d.ts +150 -0
  363. package/dist/src/formats/obo/exporter.d.ts.map +1 -0
  364. package/dist/src/formats/obo/exporter.js +1736 -0
  365. package/dist/src/formats/obo/exporter.js.map +1 -0
  366. package/dist/src/formats/obo/importer.d.ts +95 -19
  367. package/dist/src/formats/obo/importer.d.ts.map +1 -1
  368. package/dist/src/formats/obo/importer.js +475 -104
  369. package/dist/src/formats/obo/importer.js.map +1 -1
  370. package/dist/src/formats/obo/index.d.ts +6 -3
  371. package/dist/src/formats/obo/index.d.ts.map +1 -1
  372. package/dist/src/formats/obo/index.js +6 -3
  373. package/dist/src/formats/obo/index.js.map +1 -1
  374. package/dist/src/formats/obo/syntax.d.ts +108 -4
  375. package/dist/src/formats/obo/syntax.d.ts.map +1 -1
  376. package/dist/src/formats/obo/syntax.js +211 -34
  377. package/dist/src/formats/obo/syntax.js.map +1 -1
  378. package/dist/src/formats/pajek/exporter.d.ts +54 -16
  379. package/dist/src/formats/pajek/exporter.d.ts.map +1 -1
  380. package/dist/src/formats/pajek/exporter.js +67 -35
  381. package/dist/src/formats/pajek/exporter.js.map +1 -1
  382. package/dist/src/formats/pajek/importer.d.ts +84 -22
  383. package/dist/src/formats/pajek/importer.d.ts.map +1 -1
  384. package/dist/src/formats/pajek/importer.js +303 -83
  385. package/dist/src/formats/pajek/importer.js.map +1 -1
  386. package/dist/src/formats/pajek/index.d.ts +2 -1
  387. package/dist/src/formats/pajek/index.d.ts.map +1 -1
  388. package/dist/src/formats/pajek/index.js +2 -1
  389. package/dist/src/formats/pajek/index.js.map +1 -1
  390. package/dist/src/formats/pajek/syntax.d.ts +77 -14
  391. package/dist/src/formats/pajek/syntax.d.ts.map +1 -1
  392. package/dist/src/formats/pajek/syntax.js +186 -54
  393. package/dist/src/formats/pajek/syntax.js.map +1 -1
  394. package/dist/src/formats/xgmml/columns.d.ts +1 -0
  395. package/dist/src/formats/xgmml/columns.d.ts.map +1 -1
  396. package/dist/src/formats/xgmml/columns.js +4 -0
  397. package/dist/src/formats/xgmml/columns.js.map +1 -1
  398. package/dist/src/formats/xgmml/constants.d.ts +186 -56
  399. package/dist/src/formats/xgmml/constants.d.ts.map +1 -1
  400. package/dist/src/formats/xgmml/constants.js +181 -57
  401. package/dist/src/formats/xgmml/constants.js.map +1 -1
  402. package/dist/src/formats/xgmml/document.d.ts +65 -11
  403. package/dist/src/formats/xgmml/document.d.ts.map +1 -1
  404. package/dist/src/formats/xgmml/document.js +157 -28
  405. package/dist/src/formats/xgmml/document.js.map +1 -1
  406. package/dist/src/formats/xgmml/emit.d.ts +61 -3
  407. package/dist/src/formats/xgmml/emit.d.ts.map +1 -1
  408. package/dist/src/formats/xgmml/emit.js +129 -26
  409. package/dist/src/formats/xgmml/emit.js.map +1 -1
  410. package/dist/src/formats/xgmml/exporter.d.ts +13 -6
  411. package/dist/src/formats/xgmml/exporter.d.ts.map +1 -1
  412. package/dist/src/formats/xgmml/exporter.js +21 -22
  413. package/dist/src/formats/xgmml/exporter.js.map +1 -1
  414. package/dist/src/formats/xgmml/importer.d.ts +33 -12
  415. package/dist/src/formats/xgmml/importer.d.ts.map +1 -1
  416. package/dist/src/formats/xgmml/importer.js +35 -72
  417. package/dist/src/formats/xgmml/importer.js.map +1 -1
  418. package/dist/src/formats/xgmml/index.d.ts +1 -0
  419. package/dist/src/formats/xgmml/index.d.ts.map +1 -1
  420. package/dist/src/formats/xgmml/index.js +1 -0
  421. package/dist/src/formats/xgmml/index.js.map +1 -1
  422. package/dist/src/formats/xgmml/values.d.ts +8 -1
  423. package/dist/src/formats/xgmml/values.d.ts.map +1 -1
  424. package/dist/src/formats/xgmml/values.js +8 -3
  425. package/dist/src/formats/xgmml/values.js.map +1 -1
  426. package/dist/src/index.d.ts +23 -18
  427. package/dist/src/index.d.ts.map +1 -1
  428. package/dist/src/index.js +28 -16
  429. package/dist/src/index.js.map +1 -1
  430. package/dist/src/registry.d.ts +478 -92
  431. package/dist/src/registry.d.ts.map +1 -1
  432. package/dist/src/registry.js +807 -88
  433. package/dist/src/registry.js.map +1 -1
  434. package/dist/src/sniff.d.ts +61 -19
  435. package/dist/src/sniff.d.ts.map +1 -1
  436. package/dist/src/sniff.js +121 -29
  437. package/dist/src/sniff.js.map +1 -1
  438. package/dist/src/types.d.ts +362 -112
  439. package/dist/src/types.d.ts.map +1 -1
  440. package/dist/src/types.js +28 -7
  441. package/dist/src/types.js.map +1 -1
  442. package/dist/xgmml.js +2 -2
  443. package/docs/samples/README.md +25 -0
  444. package/docs/samples/got-edges.csv +353 -0
  445. package/docs/samples/got-network.graphml +1384 -0
  446. package/docs/samples/got-nodes.csv +108 -0
  447. package/docs/samples/got.cx +930 -0
  448. package/docs/samples/got.cx2 +465 -0
  449. package/docs/samples/got.gexf +471 -0
  450. package/docs/samples/got.gml +2650 -0
  451. package/docs/samples/got.json +2546 -0
  452. package/docs/samples/got.net +461 -0
  453. package/docs/samples/movies-nodes.csv +9 -0
  454. package/docs/samples/movies-rels.csv +8 -0
  455. package/docs/samples/networks.cys +0 -0
  456. package/docs/samples/proteins.xgmml +9 -0
  457. package/docs/samples/teams.gv +24 -0
  458. package/docs/samples/vehicles.obo +25 -0
  459. package/package.json +9 -4
  460. package/src/children.ts +18 -6
  461. package/src/common/attributes.ts +29 -11
  462. package/src/common/cell-budget.ts +11 -3
  463. package/src/common/choose.ts +89 -0
  464. package/src/common/codes.ts +490 -66
  465. package/src/common/compare.ts +472 -0
  466. package/src/common/cx-export.ts +432 -0
  467. package/src/common/declared-types.ts +40 -6
  468. package/src/common/direction.ts +78 -51
  469. package/src/common/escape.ts +39 -22
  470. package/src/common/export.ts +284 -47
  471. package/src/common/format.ts +30 -1
  472. package/src/common/ids.ts +14 -3
  473. package/src/common/input.ts +1057 -134
  474. package/src/common/json-elements.ts +1035 -199
  475. package/src/common/line-format.ts +249 -0
  476. package/src/common/lists.ts +7 -2
  477. package/src/common/ontology-export.ts +461 -0
  478. package/src/common/ontology.ts +31 -9
  479. package/src/common/options.ts +110 -15
  480. package/src/common/plural.ts +49 -0
  481. package/src/common/report.ts +168 -25
  482. package/src/common/temporal.ts +22 -5
  483. package/src/common/text.ts +62 -23
  484. package/src/common/weights.ts +74 -4
  485. package/src/common/writer.ts +37 -3
  486. package/src/common/xml.ts +479 -90
  487. package/src/common/zip.ts +169 -7
  488. package/src/formats/csv/exporter.ts +202 -47
  489. package/src/formats/csv/header.ts +50 -11
  490. package/src/formats/csv/importer.ts +1133 -245
  491. package/src/formats/csv/index.ts +106 -19
  492. package/src/formats/csv/records.ts +396 -122
  493. package/src/formats/csv/values.ts +1 -0
  494. package/src/formats/cx/exporter.ts +1483 -0
  495. package/src/formats/cx/importer.ts +890 -302
  496. package/src/formats/cx/index.ts +4 -3
  497. package/src/formats/cx2/exporter.ts +62 -339
  498. package/src/formats/cx2/importer.ts +318 -87
  499. package/src/formats/cx2/index.ts +2 -1
  500. package/src/formats/cys/constants.ts +62 -17
  501. package/src/formats/cys/exporter.ts +1368 -0
  502. package/src/formats/cys/importer.ts +659 -157
  503. package/src/formats/cys/index.ts +4 -2
  504. package/src/formats/cys/session.ts +142 -34
  505. package/src/formats/cys/tables.ts +47 -9
  506. package/src/formats/dot/exporter.ts +83 -37
  507. package/src/formats/dot/importer.ts +248 -54
  508. package/src/formats/dot/index.ts +2 -1
  509. package/src/formats/dot/names.ts +44 -11
  510. package/src/formats/dot/tokenizer.ts +25 -6
  511. package/src/formats/gexf/exporter.ts +57 -18
  512. package/src/formats/gexf/importer.ts +636 -105
  513. package/src/formats/gexf/index.ts +90 -21
  514. package/src/formats/gexf/schema.ts +67 -15
  515. package/src/formats/gml/exporter.ts +90 -36
  516. package/src/formats/gml/importer.ts +388 -67
  517. package/src/formats/gml/index.ts +85 -24
  518. package/src/formats/gml/syntax.ts +113 -28
  519. package/src/formats/graphml/constants.ts +178 -44
  520. package/src/formats/graphml/exporter.ts +52 -18
  521. package/src/formats/graphml/importer.ts +640 -60
  522. package/src/formats/graphml/index.ts +2 -1
  523. package/src/formats/graphml/tree.ts +6 -2
  524. package/src/formats/graphml/yfiles.ts +37 -15
  525. package/src/formats/json/dialect.ts +128 -29
  526. package/src/formats/json/exporter.ts +205 -68
  527. package/src/formats/json/importer.ts +1163 -253
  528. package/src/formats/json/index.ts +3 -1
  529. package/src/formats/json/obographs-export.ts +1197 -0
  530. package/src/formats/json/obographs.ts +353 -92
  531. package/src/formats/neo4j/exporter.ts +321 -102
  532. package/src/formats/neo4j/header.ts +44 -6
  533. package/src/formats/neo4j/importer.ts +512 -73
  534. package/src/formats/neo4j/index.ts +75 -23
  535. package/src/formats/obo/exporter.ts +2210 -0
  536. package/src/formats/obo/importer.ts +622 -109
  537. package/src/formats/obo/index.ts +6 -3
  538. package/src/formats/obo/syntax.ts +232 -37
  539. package/src/formats/pajek/exporter.ts +90 -42
  540. package/src/formats/pajek/importer.ts +407 -93
  541. package/src/formats/pajek/index.ts +2 -1
  542. package/src/formats/pajek/syntax.ts +216 -55
  543. package/src/formats/xgmml/columns.ts +10 -0
  544. package/src/formats/xgmml/constants.ts +183 -56
  545. package/src/formats/xgmml/document.ts +212 -34
  546. package/src/formats/xgmml/emit.ts +175 -34
  547. package/src/formats/xgmml/exporter.ts +36 -28
  548. package/src/formats/xgmml/importer.ts +64 -86
  549. package/src/formats/xgmml/index.ts +1 -0
  550. package/src/formats/xgmml/values.ts +12 -4
  551. package/src/index.ts +81 -11
  552. package/src/registry.ts +1121 -135
  553. package/src/sniff.ts +163 -32
  554. package/src/types.ts +385 -114
  555. package/dist/chunks/escape-B-tkk_Cl.js.map +0 -1
  556. package/dist/chunks/export-Bh60Dv-n.js +0 -582
  557. package/dist/chunks/export-Bh60Dv-n.js.map +0 -1
  558. package/dist/chunks/exporter-BGrsWamJ.js.map +0 -1
  559. package/dist/chunks/exporter-DIeGJXAZ.js.map +0 -1
  560. package/dist/chunks/importer-BWY2FFc5.js.map +0 -1
  561. package/dist/chunks/importer-DD-xv9_Y.js +0 -1471
  562. package/dist/chunks/importer-DD-xv9_Y.js.map +0 -1
  563. package/dist/chunks/importer-DET1tg6s.js.map +0 -1
  564. package/dist/chunks/importer-DEcKhsmQ.js +0 -1614
  565. package/dist/chunks/importer-DEcKhsmQ.js.map +0 -1
  566. package/dist/chunks/importer-DIrbbnAf.js.map +0 -1
  567. package/dist/chunks/importer-D_e7e7LX.js.map +0 -1
  568. package/dist/chunks/importer-eUREhBGj.js.map +0 -1
  569. package/dist/chunks/importer-vi3bSdtw.js.map +0 -1
  570. package/dist/chunks/importer-zGLo8Dg_.js.map +0 -1
  571. package/dist/chunks/json-elements-DDS8N2Dd.js +0 -779
  572. package/dist/chunks/json-elements-DDS8N2Dd.js.map +0 -1
  573. package/dist/chunks/ontology-BnrJ4I98.js +0 -113
  574. package/dist/chunks/ontology-BnrJ4I98.js.map +0 -1
  575. package/dist/chunks/records-dbRkxwaq.js.map +0 -1
  576. package/dist/chunks/report-B1z4WT9e.js +0 -2372
  577. package/dist/chunks/report-B1z4WT9e.js.map +0 -1
  578. package/dist/chunks/text-Dr0Ifpag.js.map +0 -1
  579. package/dist/chunks/weights-Dzba96G3.js +0 -176
  580. package/dist/chunks/weights-Dzba96G3.js.map +0 -1
  581. package/dist/chunks/writer-C7flM-Ih.js.map +0 -1
@@ -1,76 +1,152 @@
1
1
  /**
2
2
  * What the XGMML importer and exporter share: the namespaces, the format facts, the fixed column
3
- * names, the `meta.extra` key, and the issue and loss code tables (design
4
- * `design/graph-io/cytoscape-and-obo/design.md` section 1.1).
3
+ * names, the `meta.extra` key, and the issue and loss code tables.
4
+ */
5
+ /**
6
+ * The format name.
7
+ * @category Plugin helpers
5
8
  */
6
- /** The format name. */
7
9
  export declare const FORMAT = "xgmml";
8
- /** File extensions (never `.gr`, which DIMACS owns). */
10
+ /**
11
+ * File extensions (never `.gr`, which DIMACS owns).
12
+ * @category Plugin helpers
13
+ */
9
14
  export declare const EXTENSIONS: readonly string[];
10
- /** MIME types: the draft's (appendix E) and Cytoscape's. */
15
+ /**
16
+ * MIME types: the draft's (appendix E) and Cytoscape's.
17
+ * @category Plugin helpers
18
+ */
11
19
  export declare const MIME_TYPES: readonly string[];
12
- /** The XGMML namespace. */
20
+ /**
21
+ * The XGMML namespace.
22
+ * @category Plugin helpers
23
+ */
13
24
  export declare const XGMML_NAMESPACE = "http://www.cs.rpi.edu/XGMML";
14
- /** Cytoscape's namespace, bound to the `cy` prefix. */
25
+ /**
26
+ * Cytoscape's namespace, bound to the `cy` prefix.
27
+ * @category Plugin helpers
28
+ */
15
29
  export declare const CY_NAMESPACE = "http://www.cytoscape.org";
16
- /** The XLink namespace. */
30
+ /**
31
+ * The XLink namespace.
32
+ * @category Plugin helpers
33
+ */
17
34
  export declare const XLINK_NAMESPACE = "http://www.w3.org/1999/xlink";
18
- /** The `meta.extra` key the importer writes and the exporter reads. */
35
+ /**
36
+ * The `meta.extra` key the importer writes and the exporter reads.
37
+ * @category Plugin helpers
38
+ */
19
39
  export declare const META_KEY = "xgmml";
20
- /** The label column (role label) of node and edge `label` attributes. */
40
+ /**
41
+ * The label column (role label) of node and edge `label` attributes.
42
+ * @category Plugin helpers
43
+ */
21
44
  export declare const LABEL_COLUMN = "label";
22
- /** The edge `id` column (role id, unique). */
45
+ /**
46
+ * The edge `id` column (role id, unique).
47
+ * @category Plugin helpers
48
+ */
23
49
  export declare const EDGE_ID_COLUMN = "id";
24
- /** The node position (f32 x3, role position, y up). */
50
+ /**
51
+ * The node position (f32 x3, role position, y up).
52
+ * @category Plugin helpers
53
+ */
25
54
  export declare const POSITION_COLUMN = "position";
26
- /** Cytoscape's stacking order (`NODE_Z_LOCATION`), kept out of the position. */
55
+ /**
56
+ * Cytoscape's stacking order (`NODE_Z_LOCATION`), kept out of the position.
57
+ * @category Plugin helpers
58
+ */
27
59
  export declare const Z_COLUMN = "z";
28
- /** The node, edge and graph json column of a `<graphics>` element's values as written. */
60
+ /**
61
+ * The node, edge and graph json column of a `<graphics>` element's values as written.
62
+ * @category Plugin helpers
63
+ */
29
64
  export declare const GRAPHICS_COLUMN = "graphics";
30
- /** The containing group node (u32, role parent). */
65
+ /**
66
+ * The containing group node (u32, role parent).
67
+ * @category Plugin helpers
68
+ */
31
69
  export declare const PARENT_COLUMN = "parent";
32
- /** Every containing group node of a node that is in several groups (list of u32, role parents). */
70
+ /**
71
+ * Every containing group node of a node that is in several groups (list of u32, role parents).
72
+ * @category Plugin helpers
73
+ */
33
74
  export declare const PARENTS_COLUMN = "parents";
34
- /** The json node column of a group's nested graph id, label and atts. */
75
+ /**
76
+ * The json node column of a group's nested graph id, label and atts.
77
+ * @category Plugin helpers
78
+ */
35
79
  export declare const SUBGRAPH_COLUMN = "xgmml.subgraph";
36
- /** The string node column naming the network a node's nested-network pointer points to. */
80
+ /**
81
+ * The string node column naming the network a node's nested-network pointer points to.
82
+ * @category Plugin helpers
83
+ */
37
84
  export declare const NESTED_NETWORK_COLUMN = "cytoscape.nestedNetwork";
38
- /** The string node column of a nested-network pointer into another file (`file.xgmml#id`). */
85
+ /**
86
+ * The string node column of a nested-network pointer into another file (`file.xgmml#id`).
87
+ * @category Plugin helpers
88
+ */
39
89
  export declare const NETWORK_POINTER_COLUMN = "xgmml.networkPointer";
40
- /** The list node column of the root-level subgraphs a node belongs to, in a generic document. */
90
+ /**
91
+ * The list node column of the root-level subgraphs a node belongs to, in a generic document.
92
+ * @category Plugin helpers
93
+ */
41
94
  export declare const NETWORKS_COLUMN = "xgmml.networks";
42
- /** The edge column of Cytoscape's interaction type. */
95
+ /**
96
+ * The edge column of Cytoscape's interaction type.
97
+ * @category Plugin helpers
98
+ */
43
99
  export declare const INTERACTION_COLUMN = "interaction";
44
- /** The `origin.namespace` of the columns the importer derives from XGMML structure. */
100
+ /**
101
+ * The `origin.namespace` of the columns the importer derives from XGMML structure.
102
+ * @category Plugin helpers
103
+ */
45
104
  export declare const XGMML_ORIGIN_NAMESPACE = "xgmml";
46
- /** The `origin.namespace` of the columns that hold Cytoscape-only data (z, nested networks). */
105
+ /**
106
+ * The `origin.namespace` of the columns that hold Cytoscape-only data (z, nested networks).
107
+ * @category Plugin helpers
108
+ */
47
109
  export declare const CYTOSCAPE_ORIGIN_NAMESPACE = "cytoscape";
48
110
  /**
49
- * The issue codes the XGMML importer records (design section 8.6), by name: the codes shared with
50
- * the other importers (src/common/codes.ts) and the XGMML-specific ones. A key is the code without
111
+ * The issue codes the XGMML importer records, by name: the codes shared with
112
+ * the other importers and the XGMML-specific ones. A key is the code without
51
113
  * its severity and format prefixes.
114
+ * @category Built-in formats
52
115
  */
53
116
  export declare const XGMML_ISSUE: Readonly<{
54
- /** Fatal: the input is not well-formed XML. */
117
+ /** The input is not well-formed XML. The import stops. */
55
118
  XML_SYNTAX: "E_XML_SYNTAX";
56
- /** Fatal: the input is empty or whitespace only. */
119
+ /** The input is empty or whitespace only. The import stops. */
57
120
  EMPTY_INPUT: "E_EMPTY_INPUT";
58
- /** Fatal: the input holds invalid UTF-8. */
121
+ /** The input is not valid UTF-8. The import stops. */
59
122
  INVALID_UTF8: "E_INVALID_UTF8";
60
- /** Fatal: bytes invalid in the encoding a BOM, a declaration or the option chose. */
123
+ /**
124
+ * Some bytes are not valid in the encoding that was chosen (by a byte order mark, the file's declaration or the
125
+ * `encoding` option). The import stops.
126
+ */
61
127
  INVALID_ENCODING: "E_INVALID_ENCODING";
62
128
  /** Undeclared non-UTF-8 bytes were read as windows-1252. */
63
129
  ENCODING_FALLBACK: "W_ENCODING_FALLBACK";
64
130
  /** A declared encoding the platform cannot decode was ignored. */
65
131
  UNKNOWN_ENCODING: "W_UNKNOWN_ENCODING";
66
- /** Fatal: the root element is not `<graph>` (an XHTML page embedding one, a GraphML file). */
132
+ /** A declared encoding the byte order mark contradicts (the mark wins). */
133
+ ENCODING_CONFLICT: "W_ENCODING_CONFLICT";
134
+ /**
135
+ * The root element is not `<graph>` (it may be an XHTML page with a graph inside, or a GraphML file). The import
136
+ * stops.
137
+ */
67
138
  NO_GRAPH: "E_NO_GRAPH";
68
- /** Fatal: a session view document (`cy:view="1"`): view SUIDs and no topology. */
139
+ /**
140
+ * The file is a Cytoscape session view (`cy:view="1"`), which holds only view settings and no nodes or edges. The
141
+ * import stops.
142
+ */
69
143
  VIEW_DOCUMENT: "E_XGMML_VIEW_DOCUMENT";
70
144
  /** A node with neither an id nor a label; it is skipped with its subtree. */
71
145
  MISSING_ID: "E_MISSING_ID";
72
146
  /** A node without an id; its label is used as the id. */
73
147
  ID_FROM_LABEL: "W_XGMML_ID_FROM_LABEL";
148
+ /** A node or edge with both an id and an `xlink:href`; it is read as the reference. */
149
+ ID_AND_HREF: "W_XGMML_ID_AND_HREF";
74
150
  /** An edge without a source or a target that no label alias resolves. */
75
151
  MISSING_ENDPOINT: "E_MISSING_ENDPOINT";
76
152
  /** An edge endpoint that names no node (addMissingNodes false); the edge is skipped. */
@@ -81,7 +157,10 @@ export declare const XGMML_ISSUE: Readonly<{
81
157
  DUPLICATE_NODE: "W_DUPLICATE_NODE";
82
158
  /** An edge id used twice; the second edge is skipped. */
83
159
  DUPLICATE_EDGE_ID: "E_DUPLICATE_EDGE_ID";
84
- /** A meta-edge the 2.x writer repeats inside a group; the copy is dropped. */
160
+ /**
161
+ * Cytoscape 2.x writes each edge of a group a second time, inside the group. The repeats are dropped, so every edge
162
+ * is read once; nothing is lost.
163
+ */
85
164
  GROUP_DUPLICATE_EDGE: "W_XGMML_GROUP_DUPLICATE_EDGE";
86
165
  /** A `directed` or `cy:directed` value other than 0 / 1. */
87
166
  BAD_DIRECTED: "W_XGMML_BAD_DIRECTED";
@@ -97,19 +176,28 @@ export declare const XGMML_ISSUE: Readonly<{
97
176
  SURROGATE_PAIRED: "W_XGMML_SURROGATE_PAIRED";
98
177
  /** An empty list whose element type nothing states; a list of strings is assumed. */
99
178
  EMPTY_LIST_TYPE: "W_XGMML_EMPTY_LIST_TYPE";
100
- /** A record list, a list of lists, a 2.x map or foreign XML in an att, kept as json. */
179
+ /**
180
+ * An attribute holds a structure a single column cannot (a list of records, a list of lists, a Cytoscape 2.x map
181
+ * or XML from another tool). Its value is kept as a JSON value, which a save as XGMML writes back.
182
+ */
101
183
  RECORD_LIST: "W_XGMML_RECORD_LIST";
102
184
  /** A pointer into another file (`file.xgmml#id`); kept as text. */
103
185
  CROSS_FILE_REFERENCE: "W_XGMML_CROSS_FILE_REFERENCE";
104
186
  /** A graph nested in an edge's att; there is no model for it. */
105
187
  EDGE_NESTED_GRAPH: "W_XGMML_EDGE_NESTED_GRAPH";
106
- /** Elements of a session network declared outside every registered subnetwork. */
188
+ /**
189
+ * Some nodes or edges of a Cytoscape session belong to none of its networks (Cytoscape keeps group meta-edges and
190
+ * the members of collapsed groups this way). They are not read; the message counts them.
191
+ */
107
192
  ROOT_ONLY_ELEMENTS: "W_XGMML_ROOT_ONLY_ELEMENTS";
108
193
  /** A value that does not parse as its declared type; the cell is unset. */
109
194
  BAD_VALUE: "E_BAD_VALUE";
110
- /** A column widened because its values or declared types disagree. */
195
+ /**
196
+ * An attribute's type was widened because a later value did not fit: an integer above 2^31 in an integer column,
197
+ * or two declared types for one attribute.
198
+ */
111
199
  WIDENED: "W_WIDENED";
112
- /** A long or real beyond what a double holds exactly. */
200
+ /** An integer beyond 2^53 was stored as the nearest 64-bit float; pass `long: "string"` to keep every digit. */
113
201
  PRECISION: "W_PRECISION";
114
202
  /** A reference (xlink:href, nested-network pointer) that names nothing. */
115
203
  DANGLING_REFERENCE: "W_DANGLING_REFERENCE";
@@ -127,54 +215,87 @@ export declare const XGMML_ISSUE: Readonly<{
127
215
  UNKNOWN_ELEMENT: "W_UNKNOWN_ELEMENT";
128
216
  /** Character data where XGMML allows only elements, or inside an att. */
129
217
  STRAY_TEXT: "W_STRAY_TEXT";
130
- /** A session network document holds several registered networks; one was read. */
218
+ /**
219
+ * The file holds several graphs and only the first was read. It is not added when `graphIndex` or `graphName` chose the graph.
220
+ * `importAllGraphs()` reads every one.
221
+ */
131
222
  MULTIPLE_GRAPHS: "W_MULTIPLE_GRAPHS";
132
- /** graphIndex / graphName names no network (fatal). */
223
+ /** `graphIndex` or `graphName` matches no network in the session. The import stops. */
133
224
  GRAPH_NOT_FOUND: "E_GRAPH_NOT_FOUND";
134
- /** graphName names several networks (fatal). */
225
+ /** `graphName` matches several networks in the session. The import stops. */
135
226
  AMBIGUOUS_GRAPH_NAME: "E_AMBIGUOUS_GRAPH_NAME";
136
- /** A column renamed `<name>#<n>` because its name was taken. */
227
+ /**
228
+ * An attribute was renamed `<name>#<suffix>` because another attribute already has its name, for example
229
+ * two attributes declared with the same name.
230
+ */
137
231
  COLUMN_RENAMED: "W_COLUMN_RENAMED";
138
- /** A column declared without its role because the table already holds it. */
232
+ /**
233
+ * You read into a graph builder that already has an id, label or position attribute, so this file's one is kept as
234
+ * a plain attribute.
235
+ */
139
236
  ROLE_TAKEN: "W_ROLE_TAKEN";
140
- /** Two id texts merged into one number under ids "number". */
237
+ /** Two different id texts became the same number because `ids` is "number", so their nodes were merged. */
141
238
  ID_MERGED: "W_ID_MERGED";
142
- /** An option the format has no use for. */
239
+ /** You set an option this format does not use; it had no effect. The message names the option. */
143
240
  OPTION_IGNORED: "W_OPTION_IGNORED";
144
- /** A builder-policy option the sink does not honour. */
241
+ /**
242
+ * You read into your own graph builder, which was created with a different `addMissingNodes`, `duplicateEdges`,
243
+ * `selfLoops` or `weightDtype` than the option you passed; the builder's setting applies.
244
+ */
145
245
  SINK_OPTION: "W_SINK_OPTION";
146
- /** The sink refused the file's direction. */
246
+ /**
247
+ * You read into a graph builder whose direction is already set, or which already holds edges, so the file is read
248
+ * with the builder's direction instead of its own.
249
+ */
147
250
  DIRECTION_REFUSED: "W_DIRECTION_REFUSED";
148
- /** Edges forced to the policy's direction. */
251
+ /** Edges of the other direction were read with the direction `onMixedDirection` chose. */
149
252
  DIRECTION_FORCED: "W_DIRECTION_FORCED";
150
- /** A mixed file under onMixedDirection "error" (fatal). */
253
+ /**
254
+ * The graph has both directed and undirected edges and `onMixedDirection` is "error". An import stops; a save to a
255
+ * format that holds one direction per file fails with E_DIRECTED. Pass "directed" or "undirected" to read or write
256
+ * it anyway.
257
+ */
151
258
  MIXED_DIRECTION: "E_MIXED_DIRECTION";
259
+ INVALID_ID: "E_INVALID_ID";
260
+ INVALID_WEIGHT: "E_INVALID_WEIGHT";
261
+ DUPLICATE_EDGE: "E_DUPLICATE_EDGE";
262
+ SELF_LOOP: "E_SELF_LOOP";
263
+ TOO_LARGE: "E_TOO_LARGE";
264
+ CONTROL_CHARACTER: "W_CONTROL_CHARACTER";
265
+ FOREIGN_FORMAT: "E_FOREIGN_FORMAT";
266
+ ISSUES_SUPPRESSED: "W_ISSUES_SUPPRESSED";
152
267
  }>;
153
268
  /**
154
269
  * Loss note codes of the XGMML exporter (check()): the XGMML ones and the shared ones its notes
155
270
  * can carry. The generic notes of `checkCapabilities()` (dtypes, components, temporal and visual
156
271
  * roles, extension tables) are those of `LOSS`.
272
+ * @category Built-in formats
157
273
  */
158
274
  export declare const XGMML_LOSS: Readonly<{
159
275
  /** A json or nested-list column written as a string att. */
160
276
  JSON_AS_STRING: "W_XGMML_JSON_AS_STRING";
161
- /** A dtype written as a wider Cytoscape type (f32 as Double, u32 above i32 as Long, u8 as Integer, dict as String). */
277
+ /**
278
+ * An attribute type Cytoscape does not have is written as a wider one (a 32-bit float as Double, a large unsigned
279
+ * integer as Long, a byte as Integer, a dictionary as String).
280
+ */
162
281
  WIDENED_TYPE: "W_XGMML_WIDENED_TYPE";
163
- /** A string holding a character XML 1.0 cannot carry; export() throws. */
282
+ /** A text value holds a character XML 1.0 forbids (most control characters); the save fails with E_COLUMN_TYPE. */
164
283
  XML_ILLEGAL_CHAR: "E_XML_ILLEGAL_CHAR";
165
284
  /** A temporal column written as plain numbers. */
166
285
  TEMPORAL_DROPPED: "W_TEMPORAL_DROPPED";
167
286
  /** A temporal text companion written as a plain string att. */
168
287
  TEMPORAL_TEXT_DROPPED: "W_TEMPORAL_TEXT_DROPPED";
169
- /** A role the format has no slot for, written as a plain att. */
288
+ /** An attribute with a role the format has no place for is written as a plain attribute; the role is lost. */
170
289
  ROLE_DROPPED: "W_ROLE_DROPPED";
171
- /** A parents column not written because the snapshot also has a parent column. */
290
+ /**
291
+ * A `parents` attribute (several parents per node) is not written because the graph also has a `parent` attribute.
292
+ */
172
293
  PARENTS_DROPPED: "W_PARENTS_DROPPED";
173
294
  /** A mutual pair written as two directed edges. */
174
295
  MUTUAL_EXPANDED: "W_MUTUAL_EXPANDED";
175
296
  /** Node ids whose text reads back as the other type. */
176
297
  ID_TEXT_TYPE: "W_ID_TEXT_TYPE";
177
- /** An edge id column of another dtype written as text; it reads back as strings. */
298
+ /** Edge ids that are not text are written as text and read back as text. */
178
299
  EDGE_ID_TEXT: "W_XGMML_EDGE_ID_TEXT";
179
300
  /** Strings holding a literal backslash-n or backslash-t read back as newline / tab (Cytoscape's escapes). */
180
301
  BACKSLASH_ESCAPE: "W_XGMML_BACKSLASH_ESCAPE";
@@ -182,13 +303,22 @@ export declare const XGMML_LOSS: Readonly<{
182
303
  POSITION: "W_XGMML_POSITION";
183
304
  /** Nodes whose parent chain never reaches a root are written at the top level. */
184
305
  PARENT_CYCLE: "W_XGMML_PARENT_CYCLE";
185
- /** A column named like a column the importer owns reads back renamed. */
306
+ /**
307
+ * An attribute with a role (for example, the label) is written where the format keeps that role, and reads back under the
308
+ * name the format's importer gives it.
309
+ */
186
310
  COLUMN_NAME_CHANGED: "W_COLUMN_NAME_CHANGED";
187
- /** A role-less column written into a slot reads back with the slot's role. */
311
+ /**
312
+ * An attribute without a role is written where the format keeps a role (for example, a `name` column as the label), and
313
+ * reads back with that role.
314
+ */
188
315
  ROLE_ASSUMED: "W_ROLE_ASSUMED";
189
- /** A plain `weight` edge column reads back as THE weight. */
316
+ /** An attribute named `weight` without the weight role reads back as the edge weight. */
190
317
  WEIGHT_KEY_CLASH: "W_WEIGHT_KEY_CLASH";
191
- /** A string / dict column that reads back as the other storage class. */
318
+ /**
319
+ * A text attribute reads back as a dictionary attribute, or the reverse, because the importer chooses by how often
320
+ * its values repeat. The values are the same.
321
+ */
192
322
  STORAGE_CLASS_CHANGED: "W_STORAGE_CLASS_CHANGED";
193
323
  /** Edge labels shaped `a (i) b` read back with an `interaction` column (Cytoscape's label alias). */
194
324
  INTERACTION_FROM_LABEL: "W_XGMML_INTERACTION_FROM_LABEL";
@@ -1 +1 @@
1
- {"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/formats/xgmml/constants.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/formats/xgmml/constants.ts"],"names":[],"mappings":"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"}