@projektemacher/storymapjs 0.10.7 → 0.11.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 (587) hide show
  1. package/CHANGELOG +431 -19
  2. package/README.md +168 -17
  3. package/dist/assets/demo-bWnOyfUw.js +1 -0
  4. package/dist/assets/harness-C3JUv5Ii.js +1 -0
  5. package/dist/assets/harness-multi-XZNex3tb.js +1 -0
  6. package/dist/assets/harness-support-CjfZIVeb.js +1 -0
  7. package/dist/assets/index-wHPqGrBS.js +1 -0
  8. package/dist/assets/main-DQ32hWBM.js +17 -0
  9. package/dist/context.json +23 -9
  10. package/dist/css/fonts/files/amatic-sc-cyrillic-400-normal.woff2 +0 -0
  11. package/dist/css/fonts/files/amatic-sc-cyrillic-700-normal.woff2 +0 -0
  12. package/dist/css/fonts/files/amatic-sc-hebrew-400-normal.woff2 +0 -0
  13. package/dist/css/fonts/files/amatic-sc-hebrew-700-normal.woff2 +0 -0
  14. package/dist/css/fonts/files/amatic-sc-vietnamese-400-normal.woff2 +0 -0
  15. package/dist/css/fonts/files/amatic-sc-vietnamese-700-normal.woff2 +0 -0
  16. package/dist/css/fonts/files/bitter-cyrillic-100-italic.woff2 +0 -0
  17. package/dist/css/fonts/files/bitter-cyrillic-100-normal.woff2 +0 -0
  18. package/dist/css/fonts/files/bitter-cyrillic-200-italic.woff2 +0 -0
  19. package/dist/css/fonts/files/bitter-cyrillic-200-normal.woff2 +0 -0
  20. package/dist/css/fonts/files/bitter-cyrillic-300-italic.woff2 +0 -0
  21. package/dist/css/fonts/files/bitter-cyrillic-300-normal.woff2 +0 -0
  22. package/dist/css/fonts/files/bitter-cyrillic-400-italic.woff2 +0 -0
  23. package/dist/css/fonts/files/bitter-cyrillic-400-normal.woff2 +0 -0
  24. package/dist/css/fonts/files/bitter-cyrillic-500-italic.woff2 +0 -0
  25. package/dist/css/fonts/files/bitter-cyrillic-500-normal.woff2 +0 -0
  26. package/dist/css/fonts/files/bitter-cyrillic-600-italic.woff2 +0 -0
  27. package/dist/css/fonts/files/bitter-cyrillic-600-normal.woff2 +0 -0
  28. package/dist/css/fonts/files/bitter-cyrillic-700-italic.woff2 +0 -0
  29. package/dist/css/fonts/files/bitter-cyrillic-700-normal.woff2 +0 -0
  30. package/dist/css/fonts/files/bitter-cyrillic-800-italic.woff2 +0 -0
  31. package/dist/css/fonts/files/bitter-cyrillic-800-normal.woff2 +0 -0
  32. package/dist/css/fonts/files/bitter-cyrillic-900-italic.woff2 +0 -0
  33. package/dist/css/fonts/files/bitter-cyrillic-900-normal.woff2 +0 -0
  34. package/dist/css/fonts/files/bitter-cyrillic-ext-100-italic.woff2 +0 -0
  35. package/dist/css/fonts/files/bitter-cyrillic-ext-100-normal.woff2 +0 -0
  36. package/dist/css/fonts/files/bitter-cyrillic-ext-200-italic.woff2 +0 -0
  37. package/dist/css/fonts/files/bitter-cyrillic-ext-200-normal.woff2 +0 -0
  38. package/dist/css/fonts/files/bitter-cyrillic-ext-300-italic.woff2 +0 -0
  39. package/dist/css/fonts/files/bitter-cyrillic-ext-300-normal.woff2 +0 -0
  40. package/dist/css/fonts/files/bitter-cyrillic-ext-400-italic.woff2 +0 -0
  41. package/dist/css/fonts/files/bitter-cyrillic-ext-400-normal.woff2 +0 -0
  42. package/dist/css/fonts/files/bitter-cyrillic-ext-500-italic.woff2 +0 -0
  43. package/dist/css/fonts/files/bitter-cyrillic-ext-500-normal.woff2 +0 -0
  44. package/dist/css/fonts/files/bitter-cyrillic-ext-600-italic.woff2 +0 -0
  45. package/dist/css/fonts/files/bitter-cyrillic-ext-600-normal.woff2 +0 -0
  46. package/dist/css/fonts/files/bitter-cyrillic-ext-700-italic.woff2 +0 -0
  47. package/dist/css/fonts/files/bitter-cyrillic-ext-700-normal.woff2 +0 -0
  48. package/dist/css/fonts/files/bitter-cyrillic-ext-800-italic.woff2 +0 -0
  49. package/dist/css/fonts/files/bitter-cyrillic-ext-800-normal.woff2 +0 -0
  50. package/dist/css/fonts/files/bitter-cyrillic-ext-900-italic.woff2 +0 -0
  51. package/dist/css/fonts/files/bitter-cyrillic-ext-900-normal.woff2 +0 -0
  52. package/dist/css/fonts/files/bitter-cyrillic-ext-wght-italic.woff2 +0 -0
  53. package/dist/css/fonts/files/bitter-cyrillic-ext-wght-normal.woff2 +0 -0
  54. package/dist/css/fonts/files/bitter-cyrillic-wght-italic.woff2 +0 -0
  55. package/dist/css/fonts/files/bitter-cyrillic-wght-normal.woff2 +0 -0
  56. package/dist/css/fonts/files/bitter-vietnamese-100-italic.woff2 +0 -0
  57. package/dist/css/fonts/files/bitter-vietnamese-100-normal.woff2 +0 -0
  58. package/dist/css/fonts/files/bitter-vietnamese-200-italic.woff2 +0 -0
  59. package/dist/css/fonts/files/bitter-vietnamese-200-normal.woff2 +0 -0
  60. package/dist/css/fonts/files/bitter-vietnamese-300-italic.woff2 +0 -0
  61. package/dist/css/fonts/files/bitter-vietnamese-300-normal.woff2 +0 -0
  62. package/dist/css/fonts/files/bitter-vietnamese-400-italic.woff2 +0 -0
  63. package/dist/css/fonts/files/bitter-vietnamese-400-normal.woff2 +0 -0
  64. package/dist/css/fonts/files/bitter-vietnamese-500-italic.woff2 +0 -0
  65. package/dist/css/fonts/files/bitter-vietnamese-500-normal.woff2 +0 -0
  66. package/dist/css/fonts/files/bitter-vietnamese-600-italic.woff2 +0 -0
  67. package/dist/css/fonts/files/bitter-vietnamese-600-normal.woff2 +0 -0
  68. package/dist/css/fonts/files/bitter-vietnamese-700-italic.woff2 +0 -0
  69. package/dist/css/fonts/files/bitter-vietnamese-700-normal.woff2 +0 -0
  70. package/dist/css/fonts/files/bitter-vietnamese-800-italic.woff2 +0 -0
  71. package/dist/css/fonts/files/bitter-vietnamese-800-normal.woff2 +0 -0
  72. package/dist/css/fonts/files/bitter-vietnamese-900-italic.woff2 +0 -0
  73. package/dist/css/fonts/files/bitter-vietnamese-900-normal.woff2 +0 -0
  74. package/dist/css/fonts/files/bitter-vietnamese-wght-italic.woff2 +0 -0
  75. package/dist/css/fonts/files/bitter-vietnamese-wght-normal.woff2 +0 -0
  76. package/dist/css/fonts/files/cairo-arabic-200-normal.woff2 +0 -0
  77. package/dist/css/fonts/files/cairo-arabic-300-normal.woff2 +0 -0
  78. package/dist/css/fonts/files/cairo-arabic-400-normal.woff2 +0 -0
  79. package/dist/css/fonts/files/cairo-arabic-500-normal.woff2 +0 -0
  80. package/dist/css/fonts/files/cairo-arabic-600-normal.woff2 +0 -0
  81. package/dist/css/fonts/files/cairo-arabic-700-normal.woff2 +0 -0
  82. package/dist/css/fonts/files/cairo-arabic-800-normal.woff2 +0 -0
  83. package/dist/css/fonts/files/cairo-arabic-900-normal.woff2 +0 -0
  84. package/dist/css/fonts/files/cairo-latin-200-normal.woff2 +0 -0
  85. package/dist/css/fonts/files/cairo-latin-300-normal.woff2 +0 -0
  86. package/dist/css/fonts/files/cairo-latin-400-normal.woff2 +0 -0
  87. package/dist/css/fonts/files/cairo-latin-500-normal.woff2 +0 -0
  88. package/dist/css/fonts/files/cairo-latin-600-normal.woff2 +0 -0
  89. package/dist/css/fonts/files/cairo-latin-700-normal.woff2 +0 -0
  90. package/dist/css/fonts/files/cairo-latin-800-normal.woff2 +0 -0
  91. package/dist/css/fonts/files/cairo-latin-900-normal.woff2 +0 -0
  92. package/dist/css/fonts/files/cairo-latin-ext-200-normal.woff2 +0 -0
  93. package/dist/css/fonts/files/cairo-latin-ext-300-normal.woff2 +0 -0
  94. package/dist/css/fonts/files/cairo-latin-ext-400-normal.woff2 +0 -0
  95. package/dist/css/fonts/files/cairo-latin-ext-500-normal.woff2 +0 -0
  96. package/dist/css/fonts/files/cairo-latin-ext-600-normal.woff2 +0 -0
  97. package/dist/css/fonts/files/cairo-latin-ext-700-normal.woff2 +0 -0
  98. package/dist/css/fonts/files/cairo-latin-ext-800-normal.woff2 +0 -0
  99. package/dist/css/fonts/files/cairo-latin-ext-900-normal.woff2 +0 -0
  100. package/dist/css/fonts/files/dancing-script-vietnamese-wght-normal.woff2 +0 -0
  101. package/dist/css/fonts/files/eb-garamond-cyrillic-ext-wght-italic.woff2 +0 -0
  102. package/dist/css/fonts/files/eb-garamond-cyrillic-ext-wght-normal.woff2 +0 -0
  103. package/dist/css/fonts/files/eb-garamond-cyrillic-wght-italic.woff2 +0 -0
  104. package/dist/css/fonts/files/eb-garamond-cyrillic-wght-normal.woff2 +0 -0
  105. package/dist/css/fonts/files/eb-garamond-greek-ext-wght-italic.woff2 +0 -0
  106. package/dist/css/fonts/files/eb-garamond-greek-ext-wght-normal.woff2 +0 -0
  107. package/dist/css/fonts/files/eb-garamond-greek-wght-italic.woff2 +0 -0
  108. package/dist/css/fonts/files/eb-garamond-greek-wght-normal.woff2 +0 -0
  109. package/dist/css/fonts/files/eb-garamond-vietnamese-wght-italic.woff2 +0 -0
  110. package/dist/css/fonts/files/eb-garamond-vietnamese-wght-normal.woff2 +0 -0
  111. package/dist/css/fonts/files/gentium-book-plus-cyrillic-400-italic.woff2 +0 -0
  112. package/dist/css/fonts/files/gentium-book-plus-cyrillic-400-normal.woff2 +0 -0
  113. package/dist/css/fonts/files/gentium-book-plus-cyrillic-700-italic.woff2 +0 -0
  114. package/dist/css/fonts/files/gentium-book-plus-cyrillic-700-normal.woff2 +0 -0
  115. package/dist/css/fonts/files/gentium-book-plus-cyrillic-ext-400-italic.woff2 +0 -0
  116. package/dist/css/fonts/files/gentium-book-plus-cyrillic-ext-400-normal.woff2 +0 -0
  117. package/dist/css/fonts/files/gentium-book-plus-cyrillic-ext-700-italic.woff2 +0 -0
  118. package/dist/css/fonts/files/gentium-book-plus-cyrillic-ext-700-normal.woff2 +0 -0
  119. package/dist/css/fonts/files/gentium-book-plus-greek-400-italic.woff2 +0 -0
  120. package/dist/css/fonts/files/gentium-book-plus-greek-400-normal.woff2 +0 -0
  121. package/dist/css/fonts/files/gentium-book-plus-greek-700-italic.woff2 +0 -0
  122. package/dist/css/fonts/files/gentium-book-plus-greek-700-normal.woff2 +0 -0
  123. package/dist/css/fonts/files/gentium-book-plus-greek-ext-400-italic.woff2 +0 -0
  124. package/dist/css/fonts/files/gentium-book-plus-greek-ext-400-normal.woff2 +0 -0
  125. package/dist/css/fonts/files/gentium-book-plus-greek-ext-700-italic.woff2 +0 -0
  126. package/dist/css/fonts/files/gentium-book-plus-greek-ext-700-normal.woff2 +0 -0
  127. package/dist/css/fonts/files/gentium-book-plus-vietnamese-400-italic.woff2 +0 -0
  128. package/dist/css/fonts/files/gentium-book-plus-vietnamese-400-normal.woff2 +0 -0
  129. package/dist/css/fonts/files/gentium-book-plus-vietnamese-700-italic.woff2 +0 -0
  130. package/dist/css/fonts/files/gentium-book-plus-vietnamese-700-normal.woff2 +0 -0
  131. package/dist/css/fonts/files/old-standard-tt-cyrillic-400-italic.woff2 +0 -0
  132. package/dist/css/fonts/files/old-standard-tt-cyrillic-400-normal.woff2 +0 -0
  133. package/dist/css/fonts/files/old-standard-tt-cyrillic-700-normal.woff2 +0 -0
  134. package/dist/css/fonts/files/old-standard-tt-cyrillic-ext-400-italic.woff2 +0 -0
  135. package/dist/css/fonts/files/old-standard-tt-cyrillic-ext-400-normal.woff2 +0 -0
  136. package/dist/css/fonts/files/old-standard-tt-cyrillic-ext-700-normal.woff2 +0 -0
  137. package/dist/css/fonts/files/old-standard-tt-vietnamese-400-italic.woff2 +0 -0
  138. package/dist/css/fonts/files/old-standard-tt-vietnamese-400-normal.woff2 +0 -0
  139. package/dist/css/fonts/files/old-standard-tt-vietnamese-700-normal.woff2 +0 -0
  140. package/dist/css/fonts/files/open-sans-cyrillic-ext-wght-italic.woff2 +0 -0
  141. package/dist/css/fonts/files/open-sans-cyrillic-ext-wght-normal.woff2 +0 -0
  142. package/dist/css/fonts/files/open-sans-cyrillic-wght-italic.woff2 +0 -0
  143. package/dist/css/fonts/files/open-sans-cyrillic-wght-normal.woff2 +0 -0
  144. package/dist/css/fonts/files/open-sans-greek-ext-wght-italic.woff2 +0 -0
  145. package/dist/css/fonts/files/open-sans-greek-ext-wght-normal.woff2 +0 -0
  146. package/dist/css/fonts/files/open-sans-greek-wght-italic.woff2 +0 -0
  147. package/dist/css/fonts/files/open-sans-greek-wght-normal.woff2 +0 -0
  148. package/dist/css/fonts/files/open-sans-hebrew-wght-italic.woff2 +0 -0
  149. package/dist/css/fonts/files/open-sans-hebrew-wght-normal.woff2 +0 -0
  150. package/dist/css/fonts/files/open-sans-vietnamese-wght-italic.woff2 +0 -0
  151. package/dist/css/fonts/files/open-sans-vietnamese-wght-normal.woff2 +0 -0
  152. package/dist/css/fonts/files/playfair-display-cyrillic-wght-italic.woff2 +0 -0
  153. package/dist/css/fonts/files/playfair-display-cyrillic-wght-normal.woff2 +0 -0
  154. package/dist/css/fonts/files/playfair-display-sc-cyrillic-400-italic.woff2 +0 -0
  155. package/dist/css/fonts/files/playfair-display-sc-cyrillic-400-normal.woff2 +0 -0
  156. package/dist/css/fonts/files/playfair-display-sc-cyrillic-700-italic.woff2 +0 -0
  157. package/dist/css/fonts/files/playfair-display-sc-cyrillic-700-normal.woff2 +0 -0
  158. package/dist/css/fonts/files/playfair-display-sc-cyrillic-900-italic.woff2 +0 -0
  159. package/dist/css/fonts/files/playfair-display-sc-cyrillic-900-normal.woff2 +0 -0
  160. package/dist/css/fonts/files/playfair-display-sc-vietnamese-400-italic.woff2 +0 -0
  161. package/dist/css/fonts/files/playfair-display-sc-vietnamese-400-normal.woff2 +0 -0
  162. package/dist/css/fonts/files/playfair-display-sc-vietnamese-700-italic.woff2 +0 -0
  163. package/dist/css/fonts/files/playfair-display-sc-vietnamese-700-normal.woff2 +0 -0
  164. package/dist/css/fonts/files/playfair-display-sc-vietnamese-900-italic.woff2 +0 -0
  165. package/dist/css/fonts/files/playfair-display-sc-vietnamese-900-normal.woff2 +0 -0
  166. package/dist/css/fonts/files/playfair-display-vietnamese-wght-italic.woff2 +0 -0
  167. package/dist/css/fonts/files/playfair-display-vietnamese-wght-normal.woff2 +0 -0
  168. package/dist/css/fonts/files/pt-sans-cyrillic-400-italic.woff2 +0 -0
  169. package/dist/css/fonts/files/pt-sans-cyrillic-400-normal.woff2 +0 -0
  170. package/dist/css/fonts/files/pt-sans-cyrillic-700-italic.woff2 +0 -0
  171. package/dist/css/fonts/files/pt-sans-cyrillic-700-normal.woff2 +0 -0
  172. package/dist/css/fonts/files/pt-sans-cyrillic-ext-400-italic.woff2 +0 -0
  173. package/dist/css/fonts/files/pt-sans-cyrillic-ext-400-normal.woff2 +0 -0
  174. package/dist/css/fonts/files/pt-sans-cyrillic-ext-700-italic.woff2 +0 -0
  175. package/dist/css/fonts/files/pt-sans-cyrillic-ext-700-normal.woff2 +0 -0
  176. package/dist/css/fonts/files/pt-sans-narrow-cyrillic-400-normal.woff2 +0 -0
  177. package/dist/css/fonts/files/pt-sans-narrow-cyrillic-700-normal.woff2 +0 -0
  178. package/dist/css/fonts/files/pt-sans-narrow-cyrillic-ext-400-normal.woff2 +0 -0
  179. package/dist/css/fonts/files/pt-sans-narrow-cyrillic-ext-700-normal.woff2 +0 -0
  180. package/dist/css/fonts/files/pt-serif-cyrillic-400-italic.woff2 +0 -0
  181. package/dist/css/fonts/files/pt-serif-cyrillic-400-normal.woff2 +0 -0
  182. package/dist/css/fonts/files/pt-serif-cyrillic-700-italic.woff2 +0 -0
  183. package/dist/css/fonts/files/pt-serif-cyrillic-700-normal.woff2 +0 -0
  184. package/dist/css/fonts/files/pt-serif-cyrillic-ext-400-italic.woff2 +0 -0
  185. package/dist/css/fonts/files/pt-serif-cyrillic-ext-400-normal.woff2 +0 -0
  186. package/dist/css/fonts/files/pt-serif-cyrillic-ext-700-italic.woff2 +0 -0
  187. package/dist/css/fonts/files/pt-serif-cyrillic-ext-700-normal.woff2 +0 -0
  188. package/dist/css/fonts/files/raleway-cyrillic-ext-wght-italic.woff2 +0 -0
  189. package/dist/css/fonts/files/raleway-cyrillic-ext-wght-normal.woff2 +0 -0
  190. package/dist/css/fonts/files/raleway-cyrillic-wght-italic.woff2 +0 -0
  191. package/dist/css/fonts/files/raleway-cyrillic-wght-normal.woff2 +0 -0
  192. package/dist/css/fonts/files/raleway-vietnamese-wght-italic.woff2 +0 -0
  193. package/dist/css/fonts/files/raleway-vietnamese-wght-normal.woff2 +0 -0
  194. package/dist/css/fonts/files/roboto-slab-cyrillic-ext-wght-normal.woff2 +0 -0
  195. package/dist/css/fonts/files/roboto-slab-cyrillic-wght-normal.woff2 +0 -0
  196. package/dist/css/fonts/files/roboto-slab-greek-ext-wght-normal.woff2 +0 -0
  197. package/dist/css/fonts/files/roboto-slab-greek-wght-normal.woff2 +0 -0
  198. package/dist/css/fonts/files/roboto-slab-vietnamese-wght-normal.woff2 +0 -0
  199. package/dist/css/fonts/files/ubuntu-cyrillic-300-italic.woff2 +0 -0
  200. package/dist/css/fonts/files/ubuntu-cyrillic-300-normal.woff2 +0 -0
  201. package/dist/css/fonts/files/ubuntu-cyrillic-400-italic.woff2 +0 -0
  202. package/dist/css/fonts/files/ubuntu-cyrillic-400-normal.woff2 +0 -0
  203. package/dist/css/fonts/files/ubuntu-cyrillic-500-italic.woff2 +0 -0
  204. package/dist/css/fonts/files/ubuntu-cyrillic-500-normal.woff2 +0 -0
  205. package/dist/css/fonts/files/ubuntu-cyrillic-700-italic.woff2 +0 -0
  206. package/dist/css/fonts/files/ubuntu-cyrillic-700-normal.woff2 +0 -0
  207. package/dist/css/fonts/files/ubuntu-cyrillic-ext-300-italic.woff2 +0 -0
  208. package/dist/css/fonts/files/ubuntu-cyrillic-ext-300-normal.woff2 +0 -0
  209. package/dist/css/fonts/files/ubuntu-cyrillic-ext-400-italic.woff2 +0 -0
  210. package/dist/css/fonts/files/ubuntu-cyrillic-ext-400-normal.woff2 +0 -0
  211. package/dist/css/fonts/files/ubuntu-cyrillic-ext-500-italic.woff2 +0 -0
  212. package/dist/css/fonts/files/ubuntu-cyrillic-ext-500-normal.woff2 +0 -0
  213. package/dist/css/fonts/files/ubuntu-cyrillic-ext-700-italic.woff2 +0 -0
  214. package/dist/css/fonts/files/ubuntu-cyrillic-ext-700-normal.woff2 +0 -0
  215. package/dist/css/fonts/files/ubuntu-greek-300-italic.woff2 +0 -0
  216. package/dist/css/fonts/files/ubuntu-greek-300-normal.woff2 +0 -0
  217. package/dist/css/fonts/files/ubuntu-greek-400-italic.woff2 +0 -0
  218. package/dist/css/fonts/files/ubuntu-greek-400-normal.woff2 +0 -0
  219. package/dist/css/fonts/files/ubuntu-greek-500-italic.woff2 +0 -0
  220. package/dist/css/fonts/files/ubuntu-greek-500-normal.woff2 +0 -0
  221. package/dist/css/fonts/files/ubuntu-greek-700-italic.woff2 +0 -0
  222. package/dist/css/fonts/files/ubuntu-greek-700-normal.woff2 +0 -0
  223. package/dist/css/fonts/files/ubuntu-greek-ext-300-italic.woff2 +0 -0
  224. package/dist/css/fonts/files/ubuntu-greek-ext-300-normal.woff2 +0 -0
  225. package/dist/css/fonts/files/ubuntu-greek-ext-400-italic.woff2 +0 -0
  226. package/dist/css/fonts/files/ubuntu-greek-ext-400-normal.woff2 +0 -0
  227. package/dist/css/fonts/files/ubuntu-greek-ext-500-italic.woff2 +0 -0
  228. package/dist/css/fonts/files/ubuntu-greek-ext-500-normal.woff2 +0 -0
  229. package/dist/css/fonts/files/ubuntu-greek-ext-700-italic.woff2 +0 -0
  230. package/dist/css/fonts/files/ubuntu-greek-ext-700-normal.woff2 +0 -0
  231. package/dist/css/fonts/files/unica-one-vietnamese-400-normal.woff2 +0 -0
  232. package/dist/css/fonts/files/vollkorn-cyrillic-ext-wght-italic.woff2 +0 -0
  233. package/dist/css/fonts/files/vollkorn-cyrillic-ext-wght-normal.woff2 +0 -0
  234. package/dist/css/fonts/files/vollkorn-cyrillic-wght-italic.woff2 +0 -0
  235. package/dist/css/fonts/files/vollkorn-cyrillic-wght-normal.woff2 +0 -0
  236. package/dist/css/fonts/files/vollkorn-greek-wght-italic.woff2 +0 -0
  237. package/dist/css/fonts/files/vollkorn-greek-wght-normal.woff2 +0 -0
  238. package/dist/css/fonts/files/vollkorn-vietnamese-wght-italic.woff2 +0 -0
  239. package/dist/css/fonts/files/vollkorn-vietnamese-wght-normal.woff2 +0 -0
  240. package/dist/css/fonts/font.abril-droidsans.css +3 -0
  241. package/dist/css/fonts/font.amatic-andika.css +57 -0
  242. package/dist/css/fonts/font.bitter-raleway.css +111 -0
  243. package/dist/css/fonts/font.cairo.css +312 -0
  244. package/dist/css/fonts/font.clicker-garamond.css +93 -0
  245. package/dist/css/fonts/font.dancing-ledger.css +12 -0
  246. package/dist/css/fonts/font.default.css +183 -0
  247. package/dist/css/fonts/font.fjalla-average.css +3 -0
  248. package/dist/css/fonts/font.georgia-helvetica.css +3 -0
  249. package/dist/css/fonts/font.knightlab.css +642 -0
  250. package/dist/css/fonts/font.lustria-lato.css +3 -0
  251. package/dist/css/fonts/font.medula-lato.css +3 -0
  252. package/dist/css/fonts/font.oldstandard.css +84 -0
  253. package/dist/css/fonts/font.opensans-gentiumbook.css +183 -0
  254. package/dist/css/fonts/font.playfair-faunaone.css +39 -0
  255. package/dist/css/fonts/font.playfair.css +147 -0
  256. package/dist/css/fonts/font.pt.css +183 -0
  257. package/dist/css/fonts/font.roboto-megrim.css +3 -0
  258. package/dist/css/fonts/font.rufina-sintony.css +3 -0
  259. package/dist/css/fonts/font.ubuntu.css +291 -0
  260. package/dist/css/fonts/font.unicaone-vollkorn.css +84 -0
  261. package/dist/css/storymap.css +1 -1
  262. package/dist/demo.html +3 -2
  263. package/dist/docs/api/.nojekyll +1 -0
  264. package/dist/docs/api/assets/custom.css +47 -0
  265. package/dist/docs/api/assets/hierarchy.js +1 -0
  266. package/dist/docs/api/assets/highlight.css +57 -0
  267. package/dist/docs/api/assets/icons.js +18 -0
  268. package/dist/docs/api/assets/icons.svg +1 -0
  269. package/dist/docs/api/assets/main.js +60 -0
  270. package/dist/docs/api/assets/navigation.js +1 -0
  271. package/dist/docs/api/assets/search.js +1 -0
  272. package/dist/docs/api/assets/style.css +1648 -0
  273. package/dist/docs/api/classes/StoryMap.html +2112 -0
  274. package/dist/docs/api/functions/MediaType.html +51 -0
  275. package/dist/docs/api/functions/isPresentation3Collection.html +47 -0
  276. package/dist/docs/api/functions/isPresentation3Manifest.html +53 -0
  277. package/dist/docs/api/functions/isSlideshowCollection.html +51 -0
  278. package/dist/docs/api/functions/loadCSS.html +63 -0
  279. package/dist/docs/api/functions/manifestToStorymapData.html +49 -0
  280. package/dist/docs/api/functions/setLanguage.html +54 -0
  281. package/dist/docs/api/functions/slideshowToStorymapData.html +51 -0
  282. package/dist/docs/api/functions/slideshowVersion.html +48 -0
  283. package/dist/docs/api/functions/storymapToManifest.html +57 -0
  284. package/dist/docs/api/functions/validateStorymap.html +53 -0
  285. package/dist/docs/api/functions/validateStorymapAndReport.html +54 -0
  286. package/dist/docs/api/hierarchy.html +28 -0
  287. package/dist/docs/api/index.html +300 -0
  288. package/dist/docs/api/interfaces/AnimationHandle.html +60 -0
  289. package/dist/docs/api/interfaces/ImagereadyPayload.html +71 -0
  290. package/dist/docs/api/interfaces/LanguageEntry.html +102 -0
  291. package/dist/docs/api/interfaces/LatLngLiteral.html +73 -0
  292. package/dist/docs/api/interfaces/LoadOptions.html +59 -0
  293. package/dist/docs/api/interfaces/MapEvents.html +116 -0
  294. package/dist/docs/api/interfaces/MapMarkerEvents.html +66 -0
  295. package/dist/docs/api/interfaces/MarkerEventPayload.html +57 -0
  296. package/dist/docs/api/interfaces/MediaEvents.html +78 -0
  297. package/dist/docs/api/interfaces/MenuBarEvents.html +114 -0
  298. package/dist/docs/api/interfaces/MessageEvents.html +72 -0
  299. package/dist/docs/api/interfaces/OlLayer.html +1400 -0
  300. package/dist/docs/api/interfaces/OlMap.html +1656 -0
  301. package/dist/docs/api/interfaces/OlProjection.html +332 -0
  302. package/dist/docs/api/interfaces/OlSource.html +784 -0
  303. package/dist/docs/api/interfaces/OlTileLayer.html +1497 -0
  304. package/dist/docs/api/interfaces/OlVectorLayer.html +1559 -0
  305. package/dist/docs/api/interfaces/OlView.html +1958 -0
  306. package/dist/docs/api/interfaces/SlideBackgroundState.html +66 -0
  307. package/dist/docs/api/interfaces/SlideEvents.html +78 -0
  308. package/dist/docs/api/interfaces/SlideNavEvents.html +72 -0
  309. package/dist/docs/api/interfaces/SlideshowPlayerSettings.html +182 -0
  310. package/dist/docs/api/interfaces/SlideshowToStorymapResult.html +60 -0
  311. package/dist/docs/api/interfaces/SlideshowTranslatorOptions.html +65 -0
  312. package/dist/docs/api/interfaces/SlideshowWarning.html +72 -0
  313. package/dist/docs/api/interfaces/StoryMapEvents.html +146 -0
  314. package/dist/docs/api/interfaces/StoryMapMarker.html +763 -0
  315. package/dist/docs/api/interfaces/StorySliderEvents.html +102 -0
  316. package/dist/docs/api/interfaces/StorymapBasemap.html +69 -0
  317. package/dist/docs/api/interfaces/StorymapData.html +77 -0
  318. package/dist/docs/api/interfaces/StorymapDataWrapper.html +60 -0
  319. package/dist/docs/api/interfaces/StorymapDocument.html +68 -0
  320. package/dist/docs/api/interfaces/StorymapError.html +63 -0
  321. package/dist/docs/api/interfaces/StorymapGeoreference.html +93 -0
  322. package/dist/docs/api/interfaces/StorymapGeoreferenceBody.html +74 -0
  323. package/dist/docs/api/interfaces/StorymapGroundControlPoint.html +69 -0
  324. package/dist/docs/api/interfaces/StorymapLanguageMap.html +57 -0
  325. package/dist/docs/api/interfaces/StorymapManifest.html +118 -0
  326. package/dist/docs/api/interfaces/StorymapManifestAnnotation.html +137 -0
  327. package/dist/docs/api/interfaces/StorymapManifestBackground.html +81 -0
  328. package/dist/docs/api/interfaces/StorymapManifestCanvas.html +188 -0
  329. package/dist/docs/api/interfaces/StorymapManifestContentResource.html +97 -0
  330. package/dist/docs/api/interfaces/StorymapManifestFeatureCollection.html +82 -0
  331. package/dist/docs/api/interfaces/StorymapManifestGeoreferencing.html +87 -0
  332. package/dist/docs/api/interfaces/StorymapManifestImageService.html +69 -0
  333. package/dist/docs/api/interfaces/StorymapManifestRange.html +75 -0
  334. package/dist/docs/api/interfaces/StorymapManifestService.html +77 -0
  335. package/dist/docs/api/interfaces/StorymapManifestSpecificResource.html +69 -0
  336. package/dist/docs/api/interfaces/StorymapManifestStatement.html +63 -0
  337. package/dist/docs/api/interfaces/StorymapMapOptions.html +92 -0
  338. package/dist/docs/api/interfaces/StorymapOptions.html +734 -0
  339. package/dist/docs/api/interfaces/StorymapOverlayLayer.html +157 -0
  340. package/dist/docs/api/interfaces/StorymapSlide.html +186 -0
  341. package/dist/docs/api/interfaces/StorymapSlideBackground.html +72 -0
  342. package/dist/docs/api/interfaces/StorymapSlideLocation.html +161 -0
  343. package/dist/docs/api/interfaces/StorymapSlideMarker.html +103 -0
  344. package/dist/docs/api/interfaces/StorymapSlideMedia.html +149 -0
  345. package/dist/docs/api/interfaces/StorymapSlideNarration.html +117 -0
  346. package/dist/docs/api/interfaces/StorymapSlideText.html +72 -0
  347. package/dist/docs/api/interfaces/StorymapTilejson.html +105 -0
  348. package/dist/docs/api/interfaces/SwipableEvents.html +102 -0
  349. package/dist/docs/api/interfaces/TextEvents.html +66 -0
  350. package/dist/docs/api/media/es.json +31 -0
  351. package/dist/docs/api/media/events.md +66 -0
  352. package/dist/docs/api/media/migration-from-knightlab.md +399 -0
  353. package/dist/docs/api/media/slideshow.md +109 -0
  354. package/dist/docs/api/media/storymap-as-iiif-manifest.md +1007 -0
  355. package/dist/docs/api/modules.html +50 -0
  356. package/dist/docs/api/types/ContentState.html +70 -0
  357. package/dist/docs/api/types/FiredEvent.html +43 -0
  358. package/dist/docs/api/types/ImagereadyKind.html +34 -0
  359. package/dist/docs/api/types/MediaTypeMatch.html +78 -0
  360. package/dist/docs/api/types/SwipeDirection.html +36 -0
  361. package/dist/docs/api/types/TileSourceFactory.html +53 -0
  362. package/dist/docs/authoring.html +306 -0
  363. package/dist/docs/events.html +263 -0
  364. package/dist/docs/iiif.html +738 -69
  365. package/dist/docs/migration.html +360 -11
  366. package/dist/docs/readme.html +149 -17
  367. package/dist/embed/index.html +8 -1
  368. package/dist/examples/font-css-false.json +33 -0
  369. package/dist/examples/issue-242-nonlatin.json +55 -0
  370. package/dist/examples/issue-305-start-at-slide-data.json +96 -0
  371. package/dist/examples/issue-358-iframe.json +57 -0
  372. package/dist/examples/issue-iiif-geo.json +32 -0
  373. package/dist/examples/issue-image-alt.json +23 -0
  374. package/dist/examples/issue-image-region.json +42 -0
  375. package/dist/examples/issue-image-srcset.json +24 -0
  376. package/dist/examples/layers-control.json +60 -0
  377. package/dist/examples/map-area-overlays.json +68 -0
  378. package/dist/examples/map-template-provider.json +36 -0
  379. package/dist/examples/multi-media.json +71 -0
  380. package/dist/examples/no-map.json +44 -0
  381. package/dist/examples-iiif/annotated-image.json +204 -0
  382. package/dist/examples-iiif/bob-boilen.json +11 -5
  383. package/dist/examples-iiif/courbet.json +9 -6
  384. package/dist/examples-iiif/empty.json +8 -4
  385. package/dist/examples-iiif/flickr-drewvigal.json +248 -24
  386. package/dist/examples-iiif/flickr-zach.wise.json +8 -4
  387. package/dist/examples-iiif/font-css-false.json +114 -0
  388. package/dist/examples-iiif/georeferenced-layer-unsupported.json +153 -0
  389. package/dist/examples-iiif/georeferenced-layer.json +318 -0
  390. package/dist/examples-iiif/iiif-wellcome.json +9 -6
  391. package/dist/examples-iiif/instagram-chenpamela.json +381 -36
  392. package/dist/examples-iiif/instagram_brentfoster.json +429 -40
  393. package/dist/examples-iiif/instagram_couch.json +261 -26
  394. package/dist/examples-iiif/instagram_joegermuska.json +441 -41
  395. package/dist/examples-iiif/instagram_matteich.json +261 -26
  396. package/dist/examples-iiif/instagram_mirandamulligan.json +261 -26
  397. package/dist/examples-iiif/instagram_raymondmccrea.json +261 -26
  398. package/dist/examples-iiif/instagram_test.json +261 -26
  399. package/dist/examples-iiif/issue-134-no-lines.json +9 -5
  400. package/dist/examples-iiif/issue-177-color-vars.json +9 -5
  401. package/dist/examples-iiif/issue-211-rtl.json +9 -5
  402. package/dist/examples-iiif/issue-242-nonlatin.json +239 -0
  403. package/dist/examples-iiif/issue-272-facebook.json +9 -5
  404. package/dist/examples-iiif/issue-305-start-at-slide-data.json +305 -0
  405. package/dist/examples-iiif/issue-305-start-at-slide.json +9 -5
  406. package/dist/examples-iiif/issue-341-distance.json +9 -5
  407. package/dist/examples-iiif/issue-358-iframe.json +190 -0
  408. package/dist/examples-iiif/issue-360-juxtapose.json +22 -7
  409. package/dist/examples-iiif/issue-368-null-fields.json +9 -5
  410. package/dist/examples-iiif/issue-375-code-lists.json +9 -5
  411. package/dist/examples-iiif/issue-381-dateline.json +9 -5
  412. package/dist/examples-iiif/issue-405-custom-icon.json +203 -0
  413. package/dist/examples-iiif/issue-425-many-slides.json +9 -5
  414. package/dist/examples-iiif/issue-428-background.json +20 -8
  415. package/dist/examples-iiif/issue-435-googlemaps.json +9 -5
  416. package/dist/examples-iiif/issue-437-documentcloud.json +22 -7
  417. package/dist/examples-iiif/issue-451-webp.json +9 -5
  418. package/dist/examples-iiif/issue-455-audio.json +9 -5
  419. package/dist/examples-iiif/issue-480-shorts.json +9 -5
  420. package/dist/examples-iiif/issue-506-marker-sync.json +9 -5
  421. package/dist/examples-iiif/issue-iiif-geo.json +200 -0
  422. package/dist/examples-iiif/issue-image-alt.json +90 -0
  423. package/dist/examples-iiif/issue-image-region.json +203 -0
  424. package/dist/examples-iiif/issue-image-srcset.json +87 -0
  425. package/dist/examples-iiif/jansteen.json +9 -6
  426. package/dist/examples-iiif/katrina.json +197 -41
  427. package/dist/examples-iiif/layers-control.json +226 -0
  428. package/dist/examples-iiif/map-area-overlays.json +289 -0
  429. package/dist/examples-iiif/map-template-provider.json +133 -0
  430. package/dist/examples-iiif/marktwain.json +255 -58
  431. package/dist/examples-iiif/multi-media.json +237 -0
  432. package/dist/examples-iiif/no-map.json +148 -0
  433. package/dist/examples-iiif/population.json +440 -76
  434. package/dist/examples-iiif/president.json +456 -83
  435. package/dist/examples-iiif/scroll-hint.json +190 -0
  436. package/dist/examples-iiif/seurat.json +113 -22
  437. package/dist/examples-iiif/zoomify-clamp.json +153 -0
  438. package/dist/examples-slideshow/single.json +79 -0
  439. package/dist/examples-slideshow/static/pixel.png +0 -0
  440. package/dist/examples-slideshow/static.json +44 -0
  441. package/dist/harness-multi.html +17 -0
  442. package/dist/harness.html +4 -2
  443. package/dist/index.html +19 -12
  444. package/dist/js/storymap.d.ts +2669 -307
  445. package/dist/js/storymap.js +10820 -6196
  446. package/dist/js/storymap.js.map +1 -1
  447. package/dist/navplace-properties.json +54 -0
  448. package/dist/site.css +54 -36
  449. package/docs/migration-from-knightlab.md +279 -19
  450. package/docs/storymap-as-iiif-manifest.md +633 -136
  451. package/package.json +12 -7
  452. package/schema/storymap.schema.json +733 -80
  453. package/src/animation/easings.ts +8 -1
  454. package/src/animation/tween.ts +186 -0
  455. package/src/core/Browser.ts +6 -5
  456. package/src/core/Load.ts +54 -2
  457. package/src/core/Util.ts +257 -193
  458. package/src/core/mixins.ts +66 -35
  459. package/src/core/viewers.ts +94 -0
  460. package/src/dom/DomEvent.ts +27 -8
  461. package/src/globals.d.ts +8 -0
  462. package/src/language/Language.ts +206 -25
  463. package/src/language/locale/.expected-gaps.json +346 -0
  464. package/src/language/locale/be.json +15 -2
  465. package/src/language/locale/bg.json +15 -2
  466. package/src/language/locale/cs.json +15 -2
  467. package/src/language/locale/de.json +23 -2
  468. package/src/language/locale/el.json +15 -2
  469. package/src/language/locale/en.json +17 -3
  470. package/src/language/locale/es.json +15 -2
  471. package/src/language/locale/et.json +5 -1
  472. package/src/language/locale/fr.json +15 -2
  473. package/src/language/locale/he.json +16 -3
  474. package/src/language/locale/hu.json +15 -2
  475. package/src/language/locale/is.json +5 -1
  476. package/src/language/locale/it.json +15 -2
  477. package/src/language/locale/jp.json +15 -2
  478. package/src/language/locale/ko.json +15 -2
  479. package/src/language/locale/nl.json +15 -2
  480. package/src/language/locale/nn.json +5 -1
  481. package/src/language/locale/no.json +15 -2
  482. package/src/language/locale/pl.json +15 -2
  483. package/src/language/locale/pt.json +15 -2
  484. package/src/language/locale/ru.json +15 -2
  485. package/src/language/locale/sk.json +15 -2
  486. package/src/language/locale/sr.json +5 -1
  487. package/src/language/locale/sv.json +15 -2
  488. package/src/language/locale/tr.json +15 -2
  489. package/src/language/locale/uk.json +15 -2
  490. package/src/language/locale/ur.json +5 -1
  491. package/src/language/locale/zh-cn.json +15 -2
  492. package/src/language/locale/zh-tw.json +15 -2
  493. package/src/main.ts +143 -0
  494. package/src/map/Map.ts +227 -112
  495. package/src/map/MapMarker.ts +44 -8
  496. package/src/map/georeference.ts +325 -0
  497. package/src/map/openlayers/Map.OpenLayers.ts +1601 -263
  498. package/src/map/openlayers/MapMarker.OpenLayers.ts +348 -24
  499. package/src/map/openlayers/zoomifyTiles.ts +1 -4
  500. package/src/map/slideView.ts +149 -0
  501. package/src/map/types.ts +2 -0
  502. package/src/media/EmbedUtil.ts +333 -24
  503. package/src/media/Media.ts +270 -59
  504. package/src/media/embedId.ts +110 -0
  505. package/src/media/types/Audio.ts +9 -82
  506. package/src/media/types/Blockquote.ts +2 -3
  507. package/src/media/types/DailyMotion.ts +5 -10
  508. package/src/media/types/DocumentCloud.ts +6 -35
  509. package/src/media/types/Facebook.ts +3 -4
  510. package/src/media/types/Flickr.ts +23 -12
  511. package/src/media/types/GoogleDoc.ts +3 -4
  512. package/src/media/types/HtmlMedia.ts +233 -0
  513. package/src/media/types/IFrame.ts +3 -4
  514. package/src/media/types/Image.ts +87 -9
  515. package/src/media/types/Juxtapose.ts +14 -5
  516. package/src/media/types/SoundCloud.ts +28 -6
  517. package/src/media/types/Text.ts +46 -21
  518. package/src/media/types/Twitter.ts +35 -20
  519. package/src/media/types/Video.ts +9 -79
  520. package/src/media/types/Vimeo.ts +11 -11
  521. package/src/media/types/Website.ts +23 -13
  522. package/src/media/types/Wikipedia.ts +18 -8
  523. package/src/media/types/YouTube.ts +72 -40
  524. package/src/scss/Typography.scss +16 -18
  525. package/src/scss/VCO.StoryMap.scss +208 -12
  526. package/src/scss/Variables.scss +3 -2
  527. package/src/scss/core/Mixins.scss +5 -63
  528. package/src/scss/core/Reset.scss +5 -18
  529. package/src/scss/fonts/font.amatic-andika.scss +3 -0
  530. package/src/scss/fonts/font.bitter-raleway.scss +6 -0
  531. package/src/scss/fonts/font.cairo.scss +79 -0
  532. package/src/scss/fonts/font.clicker-garamond.scss +5 -0
  533. package/src/scss/fonts/font.dancing-ledger.scss +1 -0
  534. package/src/scss/fonts/font.knightlab.scss +14 -0
  535. package/src/scss/fonts/font.oldstandard.scss +6 -0
  536. package/src/scss/fonts/font.opensans-gentiumbook.scss +5 -0
  537. package/src/scss/fonts/font.playfair-faunaone.scss +2 -0
  538. package/src/scss/fonts/font.playfair.scss +4 -0
  539. package/src/scss/fonts/font.pt.scss +6 -0
  540. package/src/scss/fonts/font.ubuntu.scss +4 -0
  541. package/src/scss/fonts/font.unicaone-vollkorn.scss +5 -0
  542. package/src/scss/map/VCO.Map.scss +1 -1
  543. package/src/scss/map/VCO.MapMarker.scss +114 -8
  544. package/src/scss/map/openlayers/VCO.Map.OpenLayers.scss +7 -4
  545. package/src/scss/media/VCO.Media.scss +14 -17
  546. package/src/scss/media/types/VCO.Media.Blockquote.scss +1 -1
  547. package/src/scss/media/types/VCO.Media.Text.scss +13 -5
  548. package/src/scss/media/types/VCO.Media.Twitter.scss +4 -4
  549. package/src/scss/media/types/VCO.Media.Wikipedia.scss +3 -19
  550. package/src/scss/site/site.scss +55 -36
  551. package/src/scss/slider/VCO.Slide.scss +61 -13
  552. package/src/scss/slider/VCO.SlideNav.scss +34 -24
  553. package/src/scss/slider/VCO.StorySlider.scss +53 -1
  554. package/src/scss/snapmap/VCO.SnapMap.scss +3 -3
  555. package/src/scss/ui/VCO.Consent.scss +63 -13
  556. package/src/scss/ui/VCO.Layers.scss +119 -0
  557. package/src/scss/ui/VCO.MenuBar.Button.scss +143 -14
  558. package/src/scss/ui/VCO.MenuBar.scss +9 -2
  559. package/src/scss/ui/VCO.Message.scss +16 -5
  560. package/src/site/site.ts +2 -1
  561. package/src/slider/Slide.ts +326 -74
  562. package/src/slider/SlideNav.ts +54 -9
  563. package/src/slider/StorySlider.ts +352 -60
  564. package/src/storymap/Consent.ts +429 -82
  565. package/src/storymap/StoryMap.ts +2163 -340
  566. package/src/storymap/content-state.ts +180 -0
  567. package/src/storymap/font-css.ts +72 -0
  568. package/src/storymap/from-slideshow.ts +785 -0
  569. package/src/storymap/iiif-shared.ts +228 -0
  570. package/src/storymap/iiif.ts +1742 -95
  571. package/src/storymap/to-iiif.ts +1008 -0
  572. package/src/storymap/validate.ts +80 -7
  573. package/src/types.ts +591 -29
  574. package/src/ui/LayersControl.ts +302 -0
  575. package/src/ui/MenuBar.ts +325 -61
  576. package/src/ui/Message.ts +44 -2
  577. package/src/ui/Swipable.ts +170 -85
  578. package/dist/assets/demo-D6cTmzn6.js +0 -1
  579. package/dist/assets/harness-BPFlzutp.js +0 -1
  580. package/dist/assets/index-DDsPBPZA.js +0 -1
  581. package/dist/assets/main-Y-MYUSJ4.js +0 -17
  582. package/src/animation/morpheus.d.ts +0 -41
  583. package/src/scss/VCO.StoryMap.Dark.scss +0 -138
  584. package/src/scss/Variables.Dark.scss +0 -56
  585. package/src/scss/media/types/VCO.Media.Instagram.scss +0 -7
  586. package/src/scss/media/types/VCO.Media.Profile.scss +0 -5
  587. package/src/ui/Draggable.ts +0 -374
package/dist/docs/api/interfaces/TextEvents.html ADDED
@@ -0,0 +1,66 @@
1
+ <!DOCTYPE html><html class="default" lang="en" data-base="../"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>TextEvents | StoryMapJS API</title><meta name="description" content="Documentation for StoryMapJS API"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="../assets/style.css"/><link rel="stylesheet" href="../assets/highlight.css"/><link rel="stylesheet" href="../assets/custom.css"/><script defer src="../assets/main.js"></script><script async src="../assets/icons.js" id="tsd-icons-script"></script><script async src="../assets/search.js" id="tsd-search-script"></script><script async src="../assets/navigation.js" id="tsd-nav-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") || "os";document.body.style.display="none";setTimeout(() => window.app?app.showPage():document.body.style.removeProperty("display"),500)</script><header class="tsd-page-toolbar">
2
+ <div class="tsd-toolbar-contents container"><a href="../index.html" class="title">StoryMapJS API</a>
3
+ <div id="tsd-toolbar-links"></div><button id="tsd-search-trigger" class="tsd-widget" aria-label="Search"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-search"></use></svg></button><dialog id="tsd-search" aria-label="Search"><input role="combobox" id="tsd-search-input" aria-controls="tsd-search-results" aria-autocomplete="list" aria-expanded="true" autocapitalize="off" autocomplete="off" placeholder="Search the docs" maxLength="100"/>
4
+ <ul role="listbox" id="tsd-search-results"></ul>
5
+ <div id="tsd-search-status" aria-live="polite" aria-atomic="true">
6
+ <div>Preparing search index...</div></div></dialog><a href="#" class="tsd-widget menu" id="tsd-toolbar-menu-trigger" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-menu"></use></svg></a></div></header>
7
+ <div class="container container-main">
8
+ <div class="col-content">
9
+ <div class="tsd-page-title">
10
+ <ul class="tsd-breadcrumb" aria-label="Breadcrumb">
11
+ <li><a href="" aria-current="page">TextEvents</a></li></ul>
12
+ <h1>Interface TextEvents</h1></div>
13
+ <div class="tsd-signature"><span class="tsd-signature-keyword">interface</span> <span class="tsd-kind-interface">TextEvents</span> <span class="tsd-signature-symbol">{</span><br/>    <a class="tsd-kind-property" href="#added">added</a><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">TextData</span><span class="tsd-signature-symbol">;</span><br/>    <a class="tsd-kind-property" href="#loaded">loaded</a><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">TextData</span><span class="tsd-signature-symbol">;</span><br/>    <a class="tsd-kind-property" href="#removed">removed</a><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">TextData</span><span class="tsd-signature-symbol">;</span><br/><span class="tsd-signature-symbol">}</span></div><aside class="tsd-sources">
14
+ <ul>
15
+ <li>Defined in <a href="https://github.com/cmahnke/StoryMapJS/blob/ffcd40cfccb804f667ff3b975dd61e8cf12bd289/src/media/types/Text.ts#L21">src/media/types/Text.ts:21</a></li></ul></aside>
16
+ <section class="tsd-panel-group tsd-index-group">
17
+ <section class="tsd-panel tsd-index-panel">
18
+ <details class="tsd-index-content tsd-accordion" open><summary class="tsd-accordion-summary tsd-index-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg>
19
+ <h5 class="tsd-index-heading uppercase">Index</h5></summary>
20
+ <div class="tsd-accordion-details">
21
+ <section class="tsd-index-section">
22
+ <h3 class="tsd-index-heading tsd-anchor-link" id="properties">Properties<a href="#properties" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
23
+ <div class="tsd-index-list"><a href="#added" class="tsd-index-link"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Property"><use href="../assets/icons.svg#icon-1024"></use></svg><span>added</span></a>
24
+ <a href="#loaded" class="tsd-index-link"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Property"><use href="../assets/icons.svg#icon-1024"></use></svg><span>loaded</span></a>
25
+ <a href="#removed" class="tsd-index-link"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Property"><use href="../assets/icons.svg#icon-1024"></use></svg><span>removed</span></a>
26
+ </div></section></div></details></section></section>
27
+ <details class="tsd-panel-group tsd-member-group tsd-accordion" open><summary class="tsd-accordion-summary" data-key="section-Properties"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg>
28
+ <h2 class="tsd-anchor-link" id="properties-1">Properties<a href="#properties-1" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2></summary>
29
+ <section>
30
+ <section class="tsd-panel tsd-member">
31
+ <h3 class="tsd-anchor-link" id="added"><span>added</span><a href="#added" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
32
+ <div class="tsd-signature"><span class="tsd-kind-property">added</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">TextData</span></div><aside class="tsd-sources">
33
+ <ul>
34
+ <li>Defined in <a href="https://github.com/cmahnke/StoryMapJS/blob/ffcd40cfccb804f667ff3b975dd61e8cf12bd289/src/media/types/Text.ts#L23">src/media/types/Text.ts:23</a></li></ul></aside></section>
35
+ <section class="tsd-panel tsd-member">
36
+ <h3 class="tsd-anchor-link" id="loaded"><span>loaded</span><a href="#loaded" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
37
+ <div class="tsd-signature"><span class="tsd-kind-property">loaded</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">TextData</span></div><aside class="tsd-sources">
38
+ <ul>
39
+ <li>Defined in <a href="https://github.com/cmahnke/StoryMapJS/blob/ffcd40cfccb804f667ff3b975dd61e8cf12bd289/src/media/types/Text.ts#L22">src/media/types/Text.ts:22</a></li></ul></aside></section>
40
+ <section class="tsd-panel tsd-member">
41
+ <h3 class="tsd-anchor-link" id="removed"><span>removed</span><a href="#removed" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
42
+ <div class="tsd-signature"><span class="tsd-kind-property">removed</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">TextData</span></div><aside class="tsd-sources">
43
+ <ul>
44
+ <li>Defined in <a href="https://github.com/cmahnke/StoryMapJS/blob/ffcd40cfccb804f667ff3b975dd61e8cf12bd289/src/media/types/Text.ts#L24">src/media/types/Text.ts:24</a></li></ul></aside></section></section></details></div>
45
+ <div class="col-sidebar">
46
+ <div class="page-menu">
47
+ <div class="tsd-navigation settings">
48
+ <details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg>
49
+ <h3>Settings</h3></summary>
50
+ <div class="tsd-accordion-details">
51
+ <div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span>
52
+ <ul id="tsd-filter-options">
53
+ <li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-protected" name="protected"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Protected</span></label></li>
54
+ <li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li>
55
+ <li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-external" name="external"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>External</span></label></li></ul></div>
56
+ <div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div>
57
+ <details open class="tsd-accordion tsd-page-navigation"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg>
58
+ <h3>On This Page</h3></summary>
59
+ <div class="tsd-accordion-details">
60
+ <details open class="tsd-accordion tsd-page-navigation-section"><summary class="tsd-accordion-summary" data-key="section-Properties"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg>Properties</summary>
61
+ <div><a href="#added"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Property"><use href="../assets/icons.svg#icon-1024"></use></svg><span>added</span></a><a href="#loaded"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Property"><use href="../assets/icons.svg#icon-1024"></use></svg><span>loaded</span></a><a href="#removed"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Property"><use href="../assets/icons.svg#icon-1024"></use></svg><span>removed</span></a></div></details></div></details></div>
62
+ <div class="site-menu">
63
+ <nav class="tsd-navigation"><a href="../modules.html">StoryMapJS API</a>
64
+ <ul class="tsd-small-nested-navigation" id="tsd-nav-container">
65
+ <li>Loading...</li></ul></nav></div></div></div><footer></footer>
66
+ <div class="overlay"></div></body></html>
package/dist/docs/api/media/es.json ADDED
@@ -0,0 +1,31 @@
1
+ {
2
+ "name": "Español",
3
+ "lang": "es",
4
+ "messages": {
5
+ "loading": "cargando",
6
+ "wikipedia": "de Wikipedia, la enciclopedia libre",
7
+ "start": "Explore",
8
+ "error": "Error de carga",
9
+ "consent_start_title": "Contenido externo",
10
+ "consent_start_message": "Esta historia carga contenido de servicios externos. Elija cuáles se permiten.",
11
+ "consent_allow_all": "Permitir todo",
12
+ "consent_decline_all": "Denegar todo",
13
+ "consent_message": "¿Cargar contenido de {service}?",
14
+ "consent_allow": "Permitir",
15
+ "consent_deny": "Denegar",
16
+ "consent_blocked": "El contenido de {service} está bloqueado.",
17
+ "consent_service_tiles": "teselas de mapa",
18
+ "consent_service_fonts": "fuentes web"
19
+ },
20
+ "buttons": {
21
+ "map_overview": "vista general del mapa",
22
+ "overview": "vista general",
23
+ "backtostart": "volver al comienzo",
24
+ "collapse_toggle": "ocultar mapa",
25
+ "uncollapse_toggle": "mostrar mapa",
26
+ "swipe_to_navigate": "Deslizar para navegar<br><span class='vco-button'>Entendido</span>",
27
+ "fullscreen": "pantalla completa",
28
+ "exit_fullscreen": "salir de pantalla completa"
29
+ },
30
+ "direction": "ltr"
31
+ }
package/dist/docs/api/media/events.md ADDED
@@ -0,0 +1,66 @@
1
+ # Event reference
2
+
3
+ One table per emitter: the event name, its payload, when it fires, and who
4
+ can subscribe. This is the canonical list;
5
+ `docs/migration-from-knightlab.md` keeps only the migration differences.
6
+ payloads are also typed — see the `*Events` maps exported from
7
+ `src/main.ts` (e.g. `StoryMapEvents`), which make `storymap.on("change", …)`
8
+ a compile error and infer the handler parameter.
9
+
10
+ Every event object carries the payload fields plus the framework's own
11
+ `type` and `target`. `target` is always the object that fired — in
12
+ particular, a re-fired event's `target` is the re-firing viewer, not the
13
+ origin (a payload carrying its own `type`/`target` cannot displace them).
14
+
15
+ ## `StoryMap` — subscribe on the viewer
16
+
17
+ | Event | Payload | Fires when |
18
+ | ----------------------------------- | ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
19
+ | `change` | `{ current_slide, current_id }` | any navigation completes (programmatic, slider, map, back-to-start); exactly once per navigation |
20
+ | `loaded` | the storymap data | slider and map both loaded (mapless stories skip the map gate) |
21
+ | `title` | `{ title }` | the story title resolves |
22
+ | `dataloaded` | _none_ | the storymap document is read, before layout |
23
+ | `fontLoaded` | `{ font }` | the font theme finishes loading — or fails to (a missing theme never blocks the story) |
24
+ | `transitionstart` / `transitionend` | `{ current_slide, duration }` / `{ current_slide }` | a slide glide starts / elapses (only the latest transition ever ends) |
25
+ | `error` | `{ message, source, conflict? }` | fetch/validation failure, or a second viewer claiming another locale (`conflict: true`) |
26
+ | `imageready` | `{ source, kind, layer }` (`kind`: `"iiif"` \| `"zoomify"` \| `"tiles"`; `layer` may be `null`) | an image source is actually attached — the only signal the imagery exists (`loaded` can fire earlier) |
27
+ | `annotationsloaded` | `{ stops, searchService, failed }` | `loadAnnotations()` appended external stops |
28
+ | `markerclick` | `{ marker_number, current_slide }` | a marker is clicked (`change` alone does not say _how_ the story moved) |
29
+ | `popupopen` / `popupclose` | `{ marker_number, current_slide }` | a marker card opens / closes (button, Escape, deactivation, dispose) |
30
+ | `basemapchange` | `{ map_type, previous }` | the layer switcher swapped the basemap |
31
+ | `overlaychange` | `{ index, visible }` | the layer switcher toggled an overlay |
32
+
33
+ ## `Map` (engine) — subscribe on `storymap._map`
34
+
35
+ `markerAdded` / `markerRemoved` fire **only here**, never on the viewer.
36
+ (`added` / `removed` from the `DomMixed` mixin exist on the engine too.)
37
+
38
+ | Event | Payload | Fires when |
39
+ | ------------------------------- | ------------------------- | ---------------------------------------------------------------------------------------------------- |
40
+ | `change` | `{ current_marker }` | the engine navigated (consumed internally to drive `_navigate`) |
41
+ | `loaded` | the map data | the engine loaded (guarded against OL `loadend` repeats) |
42
+ | `markerAdded` / `markerRemoved` | the marker | marker created / destroyed |
43
+ | `markerclick` | `{ marker_number }` | a marker is clicked (consumed internally to navigate; re-fired on the viewer) |
44
+ | `popupopen` / `popupclose` | `{ marker_number }` | a marker card opens / closes (re-fired on the viewer) |
45
+ | `imageready` | `{ source, kind, layer }` | a source is usable (re-fired on the viewer; `layer` may be `null`) |
46
+ | `tilesallowed` | _none_ | deferred tile layers attached after a tile consent grant (engine-only, never re-fired on the viewer) |
47
+
48
+ ## Internal emitters
49
+
50
+ Consumed inside the viewer; a host generally observes their effects through
51
+ the `StoryMap` events above.
52
+
53
+ | Emitter | Events |
54
+ | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
55
+ | `StorySlider` | `change {current_slide, uniqueid}`, `loaded`, `title {title}`, `colorchange`, `slideAdded`, `nav_next` / `nav_previous` / `nav_left` / `nav_right` (declared but never fired) |
56
+ | `Slide` | `background_change`, `call_to_action`, `loaded`, `added`, `removed` |
57
+ | `SlideNav` | `clicked`, `loaded`, `added`, `removed` |
58
+ | `Media` | `loaded`, `media_loaded`, `media_ended` (fired by media subclasses with a playable element — what `autoplay_media` waits for), `added`, `removed` |
59
+ | `Text` | `loaded`, `added`, `removed` |
60
+ | `MapMarker` | `markerclick`, `popupopen`, `popupclose` (all `{marker_number}`; consumed by the engine) |
61
+ | `MenuBar` | `overview`, `back_to_start`, `fullscreen`, `autoplay_toggle`, `progress_go {slide}` (consumed by the viewer to navigate), `collapse {y, collapsed}`, `basemapchange {map_type}`, `overlaychange {index, visible}` (the last two forwarded from the layer switcher and re-fired on the viewer) |
62
+ | `Message` | `clicked` (consumed by the slider), `loaded`, `added`, `removed` |
63
+ | `Swipable` | `dragstart`, `dragend`, `dragmove`, `momentum`, `swipe_left` / `swipe_right` / `swipe_up` / `swipe_down`, `swipe_nodirection` |
64
+
65
+ `loaded` / `added` / `removed` come from the `DomMixed` mixin (`onLoaded` /
66
+ `onAdd` / `onRemove`); some emitters provide them without ever firing them.
package/dist/docs/api/media/migration-from-knightlab.md ADDED
@@ -0,0 +1,399 @@
1
+ # Migrating from the Knight Lab StoryMapJS
2
+
3
+ This guide helps you move from the original Knight Lab StoryMapJS viewer
4
+ (distributed as a webpack UMD bundle with a `KLStoryMap` global) to this
5
+ rewritten TypeScript/OpenLayers viewer (ESM only).
6
+
7
+ The markup (`vco-*` classes), storymap JSON format and the
8
+ `new StoryMap(elem, data, options, listeners)` constructor signature are
9
+ preserved, so most stories render the same. What changed is the delivery
10
+ (ESM instead of UMD), the map engine (Leaflet → OpenLayers, so some
11
+ rendering details differ) and a few removed legacy paths.
12
+
13
+ ## Bundle and loading
14
+
15
+ | Knight Lab version (master) | This version |
16
+ | ------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
17
+ | `<script src="https://cdn.knightlab.com/libs/storymapjs/latest/js/storymap.js">` + `new KLStoryMap.StoryMap(...)` (UMD global) | `npm install` + ESM import: `import { StoryMap } from "storymapjs"` |
18
+ | `<link rel="stylesheet" href=".../css/storymap.css">` loaded manually | Import the CSS once (`import "storymapjs/css/storymap.css"` or the stylesheet from `dist/css/`); font themes load automatically via the `font_css` option |
19
+ | `main.js`/`main-min.js`, `compiled/` | single ESM bundle `dist/js/storymap.js` |
20
+
21
+ There is **no UMD/IIFE bundle and no `KLStoryMap`/`VCO` global** anymore. For
22
+ script-tag embedding use the ES module:
23
+
24
+ ```html
25
+ <script type="module">
26
+ import { StoryMap } from "https://example.com/storymap/js/storymap.js";
27
+ const storymap = new StoryMap("storymap-embed", "https://example.com/my-storymap.json");
28
+ </script>
29
+ ```
30
+
31
+ ## Constructor
32
+
33
+ The signature is the same:
34
+
35
+ ```ts
36
+ new StoryMap(elem, data, options?, listeners?)
37
+ ```
38
+
39
+ - `elem` — container element or DOM id (unchanged).
40
+ - `data` — a storymap document (`{ storymap: ... }`), an **IIIF Presentation 3
41
+ manifest**, or a **URL of the source file**, which is fetched and validated
42
+ automatically (unchanged).
43
+ - `options` — see below for removed/changed options.
44
+ - `listeners` — event listeners keyed by name (unchanged); `storymap.on(...)`
45
+ still works.
46
+
47
+ New capabilities:
48
+
49
+ - **Resize handling**: the viewer re-layouts automatically when its container
50
+ resizes (disable with `trackResize: false`).
51
+ - **Fullscreen**: a menubar fullscreen toggle driven by the standard HTML5
52
+ fullscreen API (`fullscreen: false` hides the button).
53
+ - **Raw OpenLayers options**: pass `map_options: { controls, interactions, view,
54
+ element, ... }` to configure the underlying OpenLayers map; `element`
55
+ (HTMLElement or DOM id) replaces the auto-created map container.
56
+ - **Runtime options**: `storymap.setMapOption(name, value)` /
57
+ `storymap.setMapOptions({...})` — e.g. switch `map_type` (main + minimap tile
58
+ layers are rebuilt together) or line styling live. Relative tile templates
59
+ such as `./tiles/{z}/{x}/{y}.png` are accepted, not just absolute `https://`
60
+ URLs.
61
+ - **Left-area map layout**: `map_area: "left"` limits the map to the left,
62
+ visible half in landscape with an opaque slide panel (no gradient over the
63
+ map) — the view needs no offset, so fits, `map_bbox` constraints and the
64
+ minimap align with the visible area directly. Default: `"full"` (the map
65
+ spans the whole width with the slide panel fading in over it).
66
+ - **Map bounding box**: `map_bbox: [west, south, east, north]` (lon/lat; raw
67
+ image pixels for image-space maps) constrains the view center to the box.
68
+ - **Scroll hint**: when a slide's content overflows, a bouncing downward
69
+ arrow appears at the bottom center of the slide (all devices) — tapping it
70
+ scrolls one step down; it hides after the first scroll. Touch scrollbars
71
+ are rendered wider with a visible track for contrast.
72
+
73
+ ## Changed options and map types
74
+
75
+ | Old | New |
76
+ | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
77
+ | `map_type: "zoomify"` (+ `options.zoomify`) | preferred: `map_type: "iiif"` with `options.iiif = { url, attribution }` (IIIF Image API 2/3); zoomify still works as a legacy image-pyramid basemap (see below) |
78
+ | `map_type: "stamen:toner"` etc. | `"stamen:*"` types are deprecated and remapped: `stamen:watercolor` → `ch-watercolor`, others → `osm:standard` |
79
+ | Stadia Maps paid tiles via `map_access_token` | Recommended: free OpenStreetMap vector styles, e.g. `map_type: "osm:bright"` (OpenFreeMap), or any style JSON URL |
80
+ | Bundled `map_access_token` | removed — pass `map_access_token` in the options if you use Mapbox/Stadia tiles |
81
+ | Bundled Flickr API key | removed — pass `api_key_flickr` in the options if you use `flickr.com/photos` API URLs |
82
+ | `relative_date: true` (moment.js) | removed — format dates in the story text |
83
+ | `font_css: "stock:<name>"` (or a path) | paths now resolve against the page URL (not the library location), plus the font files ship via `@fontsource-utils/scss`; no separate font CSS link needed |
84
+ | `font_css: false` (bundler consumers) | `stock:<name>` resolves via `import.meta.url`, which only survives when this package is _not_ processed by a bundler — bundling inlines `dist/js/storymap.js` into a chunk and the theme URL breaks. Instead `import "@projektemacher/storymapjs/css/fonts/font.default.css"` (fingerprinted, `files/` rebased by the bundler) and pass `font_css: false` for no injected `<link>`. `"none"` works too for JSON. A failing theme only warns |
85
+
86
+ ## A story with no map
87
+
88
+ `map_type: "none"` runs the storymap as text and media only. Nothing is
89
+ constructed: no `ol/Map`, no tile layer, no tile consent row, and the overview
90
+ control is hidden. The slider panel takes the full width, because there is no
91
+ map behind it to fade over.
92
+
93
+ This is the shape a photo essay or a transcript-led story wants, and it is the
94
+ one the map engine's unconditional construction used to make impossible. Note
95
+ that `map_type: ""` and an absent `map_type` both still mean OpenStreetMap, and
96
+ `map_type: null` now falls back to that default instead of throwing out of the
97
+ constructor — absence is not reinterpreted, so no existing document changes
98
+ meaning. Map-derived accessors (`getBaseLayer()`, `getMarkers()`, …) return
99
+ their neutral values, and the map setters are no-ops.
100
+
101
+ | Old | New |
102
+ | ------------------------------------------ | ------------------------------------- |
103
+ | a text-only story with a dummy `map_type` | `map_type: "none"` |
104
+ | `map_type: null` (crashed the constructor) | normalised to the default, `""` → OSM |
105
+
106
+ ## Removed globals and exports
107
+
108
+ | Removed | Replacement |
109
+ | --------------------------------- | ----------------------------------------------------- |
110
+ | `KLStoryMap` / `VCO` global (UMD) | ESM import of the named exports |
111
+ | `window.trace` | `console.log` |
112
+ | `getJSON(url, onload)` | `fetch` / the StoryMap constructor's URL loading |
113
+ | `StamenTileLayer` export | `map_type: "osm:bright"` or another OpenFreeMap style |
114
+ | `ZoomifyTileLayer` export | `map_type: "iiif"` |
115
+ | Knight Lab usage tracking (gtag) | none — nothing is sent |
116
+
117
+ ## Removed media types and services
118
+
119
+ | Removed | Replacement |
120
+ | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
121
+ | `vine` media type (service shut down) | vine URLs fall back to the `website` iframe — or paste the provider's `<iframe>` snippet into the slide text (sanitized, https-only); use another media source for those slides |
122
+ | Juxtapose `frame/?uid=` embed URLs | the `juxtapose.knightlab.com/frame/?uid=` host is dead — use the published format `https://cdn.knightlab.com/libs/juxtapose/latest/embed/index.html?uid=...` (note: this keeps a Knight Lab CDN dependency for those slides) |
123
+ | Twitter `@nickname` rendering | tweets from `x.com` URLs are now parsed too (fixes `@undefined` nicknames); no migration needed |
124
+ | Ricoh360/theta360 embeds (#391) | service no longer available (won't fix) — paste the provider's `<iframe>` snippet into the slide text if the service returns |
125
+
126
+ Extra media per slide (#358, partial): a slide takes `media_extra` (a list of
127
+ further media items, rendered after the primary one) plus `media_layout`
128
+ (`stack`, the default, or `row` for two side-by-side items). An `<iframe>`
129
+ embed snippet pasted into the slide `text` field still renders sanitized
130
+ (scripts, event handlers and non-https sources dropped) — keep that as the
131
+ migration path for removed media types:
132
+
133
+ ```html
134
+ <p>Extra footage:</p>
135
+ <iframe
136
+ src="https://example.com/embed/123"
137
+ width="560"
138
+ height="315"
139
+ frameborder="0"
140
+ allowfullscreen
141
+ ></iframe>
142
+ ```
143
+
144
+ `map_type: "zoomify"` is supported again (legacy): the image pyramid renders
145
+ via the storymap data's `zoomify` options (`path`, `width`, `height`), using a
146
+ JS warning instead of the previous removal error. Cropped edge/remainder tiles
147
+ are padded onto a full tile canvas before rendering (the original renderer's
148
+ per-tile clamp), and the minimap fits the whole image on the pyramid ladder.
149
+ Using zoomify in a IIIF
150
+ Presentation manifest is ignored — legacy zoomify options only work with
151
+ storymap JSON sources.
152
+
153
+ ## Map engine: Leaflet → OpenLayers
154
+
155
+ - `storymap.map` now exposes the **OpenLayers `Map`** instance instead of a
156
+ Leaflet map. Port any direct Leaflet calls to the OpenLayers API (table
157
+ below). It is `null` until the map has been built.
158
+ - Markers are DOM overlays (`.vco-mapmarker` / `.vco-mapmarker-active`) like
159
+ before; the mini map is an OpenLayers `OverviewMap` control.
160
+ - New basemap options: vector styles via `map_type: "osm:<style>"` (OpenFreeMap)
161
+ or a Mapbox style JSON URL.
162
+ - The `Ol*` aliases re-exported from `src/main.ts` (`OlMap`, `OlView`,
163
+ `OlLayer`, `OlTileLayer`, `OlVectorLayer`, `OlSource`, `OlProjection`) let
164
+ a consumer type the map and layers without depending on `ol` directly;
165
+ anything beyond those (features, geometries, coordinates) still needs `ol`.
166
+
167
+ ### Direct Leaflet calls → OpenLayers
168
+
169
+ Both maps are reachable from the same place (`storymap.map`), so only the
170
+ call syntax changes:
171
+
172
+ | Leaflet | OpenLayers |
173
+ | ------------------------------------------ | ------------------------------------------------------------------------- |
174
+ | `map.getCenter()` | `map.getView().getCenter()` — panel-shifted, see below |
175
+ | `map.getZoom()` | `map.getView().getZoom()` |
176
+ | `map.setView(c, z)` / `map.fitBounds(b)` | `map.getView().fit(extent, { size: map.getSize() })` |
177
+ | `map.panTo(c)` / `map.flyTo(c, z)` | `map.getView().animate({ center: c, duration: 300 })` |
178
+ | `map.setZoom(z)` | `map.getView().setZoom(z)` (or `.animate({ zoom: z })`) |
179
+ | `map.getSize()` / `map.getBounds()` | `map.getSize()` / `map.getView().calculateExtent(map.getSize())` |
180
+ | `map.on("moveend", fn)` | `map.on("moveend", fn)` (same event names; `movestart`/`move` also exist) |
181
+ | `L.tileLayer(url, opts).addTo(map)` | `new TileLayer({ source: new XYZ({ url, attributions }) }).setMap(map)` |
182
+ | `L.control.attribution` / `L.control.zoom` | OL `Attribution` / `Zoom` controls (pass them via `map_options.controls`) |
183
+ | `map.getPane("overlayPane")` | `map.getOverlayContainer()` (markers are DOM siblings, not OL features) |
184
+ | `map.invalidateSize()` | `map.updateSize()` |
185
+ | `map.remove()` | `map.setTarget(undefined); map.dispose();` (or `storymap.dispose()`) |
186
+
187
+ The exposed center is deliberately panel-shifted: in landscape the view is
188
+ offset so the visible map sits left of the slide panel, which means
189
+ `getView().getCenter()` does **not** equal the current slide's location.
190
+ That is a display concern, not a data one — read the location from the
191
+ slide, not from the view. There is intentionally no offset-aware getter;
192
+ an earlier `_getMapCenter(offset)` parameter promised that correction and
193
+ never applied it, so it was removed rather than left to mislead.
194
+ | `map.options.crs` / `map.getPixelOrigin()` | `map.getView().getProjection()` / `map.getPixelFromCoordinate(coord)` |
195
+
196
+ Marker positions are still DOM elements, so `marker.getLatLng()` has no
197
+ equivalent — read the slide data (`storymap.data.stlides[n].location`) or use
198
+ `storymap._map.getMarker(n).latLon()`.
199
+
200
+ ### Map and marker methods
201
+
202
+ The map/marker methods of the original viewer are still there with the same
203
+ names and behaviour (`storymap._map.<method>()`, `marker.<method>()`); the OL
204
+ engine implements them as thin wrappers over `storymap.map`. Two methods are
205
+ deprecated no-ops and one is gone:
206
+
207
+ | Original method | Status |
208
+ | --------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
209
+ | `updateDisplay`, `goTo`, `panTo`, `zoomTo`, `viewTo` | unchanged |
210
+ | `getBoundsZoom`, `markerOverview`, `calculateMarkerZooms` | unchanged (`getBoundsZoom()` now returns `number \| undefined` instead of a falsy value) |
211
+ | `createMiniMap`, `createMarkers`, `createMarker` | unchanged |
212
+ | `setMapOffset`, `calculateMinMaxZoom`, `updateMinMaxZoom`, `initialMapLocation` | unchanged |
213
+ | `show()` / `hide()` (map and marker) | **deprecated no-ops** — they were already empty in the original viewer. Style `.vco-mapmarker` or use `marker.active(false)` |
214
+ | `map.addTo(container)` / `map.removeFrom(container)` | unchanged — inherited from the `DomMixed` mixin: append/remove the map container and fire `added`/`removed`. The engine override re-targets and re-measures the OpenLayers viewport, so a move into a differently sized parent works |
215
+ | `marker.createPopup()` | **deprecated no-op** — it never did anything upstream either (empty base body, commented-out Leaflet body), so the `map_popup` option that called it had no effect. Still accepted, still inert. Use `marker.openPopup()` / `storymap.openMarkerPopup(n)` instead |
216
+ | `marker.addTo()`, `marker.removeFrom()`, `marker.updateDisplay()`, `marker.active()`, `marker.location()` | unchanged |
217
+ | `marker.openPopup()` / `closePopup()` / `togglePopup()` / `isPopupEnabled()` / `popupOpen` | **new** — programmatic control of the popup card (`marker: { popup: true }`); `openPopup()` returns false when disabled or not a real marker, `popupOpen` reports the state |
218
+ | `storymap.openMarkerPopup(n)` / `closeMarkerPopup(n?)` / `isPopupOpen(n)` | **new** — open/close/query a stop's card from the viewer; `openMarkerPopup` navigates to `n` first and returns false (changing nothing) when disabled, out of range, disposed or mapless |
219
+
220
+ Marker helpers that Leaflet provided on the marker object (`getLatLng`,
221
+ `setIcon`, `bindPopup`) are gone; use `marker.latLon()`, the
222
+ `.vco-mapmarker` element and your own DOM/CSS.
223
+
224
+ ## Reaching the map, layers and markers
225
+
226
+ `storymap.map` is the raw `ol/Map` (typed as `OlMap | null` — it is set during
227
+ construction, so check it before first use in an async setup). Everything the
228
+ viewer keeps internally is available through accessors on `storymap` (and on
229
+ `storymap._map` for the engine methods):
230
+
231
+ | Accessor | Returns |
232
+ | ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------- |
233
+ | `getBaseLayer()` | the base tile/vector layer |
234
+ | `getOverlayLayers()` / `getOverlayLayer(i)` | overlay layers / one by index (`null` if out of range) |
235
+ | `getOverlayCount()` | number of overlays |
236
+ | `setOverlayVisible(i, on)` / `setOverlayOpacity(i, opacity)` | show/hide and fade one overlay |
237
+ | `getMinimap()` | the inner overview `ol/Map` (`OlMap \| null`), not the `OverviewMap` control itself — there is no accessor for the control object |
238
+ | `getLine()` / `getLineActive()` | the full and the travelled route `VectorLayer` |
239
+ | `getMarker(n)` / `getMarkers()` | one marker or all of them, in slide order |
240
+ | `setExtraAttributions(html)` | extra attribution HTML, listed after the source credits |
241
+ | `isImageSpace()` | whether the map is a IIIF image in image space (see below) |
242
+
243
+ `tile_source_factory` may return a full `ol/layer/Layer` (not just a source)
244
+ anywhere a layer is built, so custom layers can carry their own opacity,
245
+ z-index and events. A custom layer without a source (Allmaps'
246
+ `WarpedMapLayer`) passes through untouched; source reads go through a
247
+ capability check, so it simply skips the tile-grid fits.
248
+
249
+ The viewer reserves three z-index ranges and custom layers should stay out
250
+ of them: **0** for the base tiles, **1..n** for the stacked `overlays[]`
251
+ entries in order, and **10/11** for the full and travelled route lines. A
252
+ custom layer with no explicit z-index lands wherever OpenLayers puts it,
253
+ which is above the lines — set one explicitly if the layer must sit inside
254
+ the stack.
255
+
256
+ ### Layer switcher
257
+
258
+ `show_layers_control: true` adds a disclosure button to the menubar with
259
+ basemap radios and overlay checkboxes. Basemap candidates come from
260
+ `basemaps[]` (entry 0 is the initial basemap unless `map_type` says
261
+ otherwise; omit for an overlays-only control); overlay rows come from the
262
+ built `overlays[]` entries, so a malformed entry never gets a row and row
263
+ _i_ is always layer _i_. `label` may be a function for host i18n (re-invoked
264
+ on `refreshLabels()`), `locked: true` renders a row checked and disabled,
265
+ `control: false` hides a row without removing the overlay — but function
266
+ labels survive only in constructor options, because `mergeData()` lets
267
+ storymap JSON overwrite same-named option keys. A runtime basemap swap
268
+ rebuilds layers but never the view, so candidates needing another
269
+ projection are refused with a warning; switching fires `basemapchange` /
270
+ `overlaychange`, and the visitor's choice is never persisted.
271
+
272
+ ### Image space vs. georeferenced
273
+
274
+ `map_type: "iiif"` is a mercator map by default. With `map_as_image: true` the
275
+ image _is_ the map: the view projection becomes `EPSG:4326`, the view is
276
+ fitted to the image extent and marker locations are pixel offsets into the
277
+ image rather than lat/lon. Ask `storymap.isImageSpace()` instead of testing
278
+ `map_type` — georeferenced IIIF (a manifest with `navPlace` regions) is an
279
+ ordinary mercator map, and `map_bbox` with a georeferenced layer is one too.
280
+
281
+ ### Knowing when the imagery is there
282
+
283
+ Tile and image sources attach asynchronously, so `loaded` can fire before the
284
+ imagery exists. Listen for `imageready`, which fires once a source is ready and
285
+ carries `{ source, kind, layer }` (`kind` is `"iiif"`, `"zoomify"` or
286
+ `"tiles"`); it is re-fired on the `storymap` as well:
287
+
288
+ ```js
289
+ storymap.on("imageready", ({ kind, source }) => {
290
+ console.log("imagery ready", kind, source);
291
+ });
292
+ ```
293
+
294
+ ### Tearing a storymap down
295
+
296
+ Call `storymap.dispose()` when the embedding view goes away (SPA route change,
297
+ dialog close). It clears the timers and the resize observer, removes the
298
+ `window`/`document` listeners, cancels running slide animations, disposes the
299
+ slider and the OpenLayers map, and sets `storymap.map` to `null`. Calling it
300
+ twice is safe; the instance is unusable afterwards.
301
+
302
+ ## Custom map providers
303
+
304
+ Any slippy-map tile URL works as `map_type` — pass the template verbatim
305
+ (including `{z}/{x}/{y}`), relative or absolute:
306
+
307
+ ```js
308
+ new StoryMap("embed", data, {
309
+ map_type: "https://tiles.example.org/base/{z}/{x}/{y}.png",
310
+ });
311
+ ```
312
+
313
+ Mapbox style JSON URLs render as vector tile layers; OpenLayers
314
+ `Map`/`View` pass-through stays available via `options.map_options`
315
+ (`controls` replaces the defaults, `interactions` are added to the
316
+ viewer's own pan/zoom set, `view` merges over the computed default).
317
+
318
+ For source classes the templates cannot express (WMS, authenticated or
319
+ gridded sources), use the `tile_source_factory` option. It is consulted
320
+ for every base, overlay and minimap layer before the built-in
321
+ `map_type` handling — return any `ol/layer/Layer` (used as-is) or a bare
322
+ `Source` (which is wrapped in a `TileLayer`), or `null`/`undefined` to fall
323
+ through:
324
+
325
+ ```js
326
+ import TileLayer from "ol/layer/Tile";
327
+ import TileWMS from "ol/source/TileWMS";
328
+
329
+ new StoryMap("embed", data, {
330
+ map_type: "wms:flood",
331
+ tile_source_factory: (map_type, { options, createDefault }) =>
332
+ map_type.startsWith("wms:")
333
+ ? new TileLayer({
334
+ source: new TileWMS({
335
+ url: "https://geoserver.example.org/wms",
336
+ params: { LAYERS: map_type.slice(4) },
337
+ crossOrigin: "anonymous",
338
+ }),
339
+ })
340
+ : createDefault(),
341
+ });
342
+ ```
343
+
344
+ The second factory argument also carries the resolved `options`
345
+ (`{ options, createDefault }`). A factory may return any `ol/layer/Layer`
346
+ (used as-is — including sourceless layers such as Allmaps'
347
+ `WarpedMapLayer`), a bare `Source` (wrapped in a `TileLayer`), or
348
+ `null`/`undefined` to fall through to the default `map_type` handling.
349
+
350
+ Custom sources must carry their own attributions (via the returned
351
+ source or the `attribution` option) — only the built-in `osm*` types
352
+ are credited automatically. `tile_source_factory` is constructor- and
353
+ runtime-only (functions cannot ride storymap JSON) and also applies to
354
+ `overlays[]` entries, whose `map_type` values go through the same
355
+ factory.
356
+
357
+ ## Data and tooling
358
+
359
+ - Storymap JSON is now validated against a JSON Schema
360
+ (`schema/storymap.schema.json`); invalid documents are reported to the
361
+ console at load time.
362
+ - IIIF Presentation 3 manifests are accepted directly as storymap sources.
363
+ The map settings map onto `storymap:` terms of a map configuration service
364
+ (IIIF has no basemap or tile-layer vocabulary of its own), and the
365
+ geospatial parts use the native extensions where they exist: `navPlace`
366
+ Points for slide locations, a `navPlace` Polygon for the story extent
367
+ (`map_bbox`), an IIIF Image API Selector for `location.region`, and the
368
+ Georeference Extension for placed rasters. A georeferenced layer is
369
+ manifest-only (the legacy format cannot express ground control points); see
370
+ [docs/storymap-as-iiif-manifest.md](storymap-as-iiif-manifest.md#geo-referenced-layers).
371
+ - The editor, staging/backend infrastructure, AWS/GitHub hosting scripts and the
372
+ Python authoring server are gone — this is a viewer-only library.
373
+ - **Slideshow tours** are a third input format: W3C `AnnotationCollection`
374
+ documents (the format of slideshow-style guided image tours) load
375
+ directly by object, file or URL, auto-detected after the IIIF branch
376
+ (`slideshow: false` opts out). A pure translator converts them to
377
+ storymap data — per-slide image regions, rotation, filter grading,
378
+ spotlight masks, per-slide basemaps, narration with playback flags and
379
+ player chrome — which renders only for slideshow tours (the internal
380
+ `slideshow_source` marker; other documents are unaffected). Convert
381
+ offline with `npm run convert:slideshow`; the full mapping is in
382
+ [docs/slideshow.md](slideshow.md).
383
+
384
+ ## Events (unchanged, plus new ones)
385
+
386
+ The canonical reference is [docs/events.md](events.md) — one table per
387
+ emitter, with payloads. What changed in migration terms: `change` gains
388
+ `current_id`, `loaded`, `title`, `dataloaded`, `fontLoaded`,
389
+ `transitionstart`/`transitionend`, `error` and the constructor listener map
390
+ all work as before; `markerAdded`/`markerRemoved` still fire on the map
391
+ object; `imageready`, `markerclick` and `popupopen`/`popupclose` are new
392
+ (see above).
393
+
394
+ Two additions for IIIF tours: `await storymap.loadAnnotations()` fetches a
395
+ manifest's externally referenced annotation pages and appends them as stops,
396
+ then fires `annotationsloaded` with `{ stops, searchService, failed }`. A
397
+ slide's stable identity is available as `storymap.getSlideId(index)`, which
398
+ is what the `#slide-N` hash and the `iiif-content` deep link resolve
399
+ through.