figrecipe 0.6.0__py3-none-any.whl → 0.9.0__py3-none-any.whl

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 (269) hide show
  1. figrecipe/__init__.py +161 -1030
  2. figrecipe/__main__.py +12 -0
  3. figrecipe/_api/__init__.py +48 -0
  4. figrecipe/_api/_extract.py +108 -0
  5. figrecipe/_api/_notebook.py +61 -0
  6. figrecipe/_api/_panel.py +113 -0
  7. figrecipe/_api/_save.py +287 -0
  8. figrecipe/_api/_seaborn_proxy.py +34 -0
  9. figrecipe/_api/_style_manager.py +153 -0
  10. figrecipe/_api/_subplots.py +333 -0
  11. figrecipe/_api/_validate.py +82 -0
  12. figrecipe/_cli/__init__.py +7 -0
  13. figrecipe/_cli/_compose.py +87 -0
  14. figrecipe/_cli/_convert.py +117 -0
  15. figrecipe/_cli/_crop.py +82 -0
  16. figrecipe/_cli/_edit.py +70 -0
  17. figrecipe/_cli/_extract.py +128 -0
  18. figrecipe/_cli/_fonts.py +47 -0
  19. figrecipe/_cli/_info.py +67 -0
  20. figrecipe/_cli/_main.py +58 -0
  21. figrecipe/_cli/_reproduce.py +79 -0
  22. figrecipe/_cli/_style.py +77 -0
  23. figrecipe/_cli/_validate.py +66 -0
  24. figrecipe/_cli/_version.py +50 -0
  25. figrecipe/_composition/__init__.py +32 -0
  26. figrecipe/_composition/_alignment.py +452 -0
  27. figrecipe/_composition/_compose.py +179 -0
  28. figrecipe/_composition/_import_axes.py +127 -0
  29. figrecipe/_composition/_visibility.py +125 -0
  30. figrecipe/_dev/__init__.py +4 -93
  31. figrecipe/_dev/_plotters.py +76 -0
  32. figrecipe/_dev/_run_demos.py +56 -0
  33. figrecipe/_dev/browser/__init__.py +69 -0
  34. figrecipe/_dev/browser/_audio.py +240 -0
  35. figrecipe/_dev/browser/_caption.py +356 -0
  36. figrecipe/_dev/browser/_click_effect.py +146 -0
  37. figrecipe/_dev/browser/_cursor.py +196 -0
  38. figrecipe/_dev/browser/_highlight.py +105 -0
  39. figrecipe/_dev/browser/_narration.py +237 -0
  40. figrecipe/_dev/browser/_recorder.py +446 -0
  41. figrecipe/_dev/browser/_utils.py +178 -0
  42. figrecipe/_dev/browser/_video_trim/__init__.py +152 -0
  43. figrecipe/_dev/browser/_video_trim/_detection.py +223 -0
  44. figrecipe/_dev/browser/_video_trim/_markers.py +140 -0
  45. figrecipe/_dev/demo_plotters/__init__.py +35 -166
  46. figrecipe/_dev/demo_plotters/_categories.py +81 -0
  47. figrecipe/_dev/demo_plotters/_figure_creators.py +119 -0
  48. figrecipe/_dev/demo_plotters/_helpers.py +31 -0
  49. figrecipe/_dev/demo_plotters/_registry.py +50 -0
  50. figrecipe/_dev/demo_plotters/bar_categorical/__init__.py +4 -0
  51. figrecipe/_dev/demo_plotters/contour_surface/__init__.py +4 -0
  52. figrecipe/_dev/demo_plotters/distribution/__init__.py +4 -0
  53. figrecipe/_dev/demo_plotters/image_matrix/__init__.py +4 -0
  54. figrecipe/_dev/demo_plotters/line_curve/__init__.py +4 -0
  55. figrecipe/_dev/demo_plotters/{plot_plot.py → line_curve/plot_plot.py} +3 -2
  56. figrecipe/_dev/demo_plotters/scatter_points/__init__.py +4 -0
  57. figrecipe/_dev/demo_plotters/special/__init__.py +4 -0
  58. figrecipe/_dev/demo_plotters/{plot_pie.py → special/plot_pie.py} +5 -1
  59. figrecipe/_dev/demo_plotters/spectral_signal/__init__.py +4 -0
  60. figrecipe/_dev/demo_plotters/vector_flow/__init__.py +4 -0
  61. figrecipe/_editor/__init__.py +61 -13
  62. figrecipe/_editor/_bbox/__init__.py +43 -0
  63. figrecipe/_editor/_bbox/_collections.py +177 -0
  64. figrecipe/_editor/_bbox/_elements.py +159 -0
  65. figrecipe/_editor/_bbox/_extract.py +402 -0
  66. figrecipe/_editor/_bbox/_extract_axes.py +370 -0
  67. figrecipe/_editor/_bbox/_extract_text.py +466 -0
  68. figrecipe/_editor/_bbox/_lines.py +173 -0
  69. figrecipe/_editor/_bbox/_transforms.py +146 -0
  70. figrecipe/_editor/_call_overrides.py +183 -0
  71. figrecipe/_editor/_datatable_plot_handlers.py +249 -0
  72. figrecipe/_editor/_figure_layout.py +211 -0
  73. figrecipe/_editor/_flask_app.py +200 -1030
  74. figrecipe/_editor/_helpers.py +251 -0
  75. figrecipe/_editor/_hitmap/__init__.py +76 -0
  76. figrecipe/_editor/_hitmap/_artists/__init__.py +21 -0
  77. figrecipe/_editor/_hitmap/_artists/_collections.py +345 -0
  78. figrecipe/_editor/_hitmap/_artists/_images.py +68 -0
  79. figrecipe/_editor/_hitmap/_artists/_lines.py +107 -0
  80. figrecipe/_editor/_hitmap/_artists/_patches.py +163 -0
  81. figrecipe/_editor/_hitmap/_artists/_text.py +190 -0
  82. figrecipe/_editor/_hitmap/_colors.py +181 -0
  83. figrecipe/_editor/_hitmap/_detect.py +194 -0
  84. figrecipe/_editor/_hitmap/_restore.py +154 -0
  85. figrecipe/_editor/_hitmap_main.py +182 -0
  86. figrecipe/_editor/_overrides.py +4 -1
  87. figrecipe/_editor/_plot_types_registry.py +190 -0
  88. figrecipe/_editor/_preferences.py +135 -0
  89. figrecipe/_editor/_render_overrides.py +507 -0
  90. figrecipe/_editor/_renderer.py +81 -186
  91. figrecipe/_editor/_routes_annotation.py +114 -0
  92. figrecipe/_editor/_routes_axis.py +482 -0
  93. figrecipe/_editor/_routes_captions.py +130 -0
  94. figrecipe/_editor/_routes_composition.py +270 -0
  95. figrecipe/_editor/_routes_core.py +126 -0
  96. figrecipe/_editor/_routes_datatable.py +364 -0
  97. figrecipe/_editor/_routes_element.py +335 -0
  98. figrecipe/_editor/_routes_files.py +443 -0
  99. figrecipe/_editor/_routes_image.py +200 -0
  100. figrecipe/_editor/_routes_snapshot.py +94 -0
  101. figrecipe/_editor/_routes_style.py +243 -0
  102. figrecipe/_editor/_templates/__init__.py +116 -1
  103. figrecipe/_editor/_templates/_html.py +154 -64
  104. figrecipe/_editor/_templates/_html_components/__init__.py +13 -0
  105. figrecipe/_editor/_templates/_html_components/_composition_toolbar.py +79 -0
  106. figrecipe/_editor/_templates/_html_components/_file_browser.py +41 -0
  107. figrecipe/_editor/_templates/_html_datatable.py +92 -0
  108. figrecipe/_editor/_templates/_scripts/__init__.py +178 -0
  109. figrecipe/_editor/_templates/_scripts/_accordion.py +328 -0
  110. figrecipe/_editor/_templates/_scripts/_annotation_drag.py +504 -0
  111. figrecipe/_editor/_templates/_scripts/_api.py +228 -0
  112. figrecipe/_editor/_templates/_scripts/_canvas_context_menu.py +182 -0
  113. figrecipe/_editor/_templates/_scripts/_captions.py +231 -0
  114. figrecipe/_editor/_templates/_scripts/_colors.py +485 -0
  115. figrecipe/_editor/_templates/_scripts/_composition.py +283 -0
  116. figrecipe/_editor/_templates/_scripts/_core.py +493 -0
  117. figrecipe/_editor/_templates/_scripts/_datatable/__init__.py +59 -0
  118. figrecipe/_editor/_templates/_scripts/_datatable/_cell_edit.py +97 -0
  119. figrecipe/_editor/_templates/_scripts/_datatable/_clipboard.py +164 -0
  120. figrecipe/_editor/_templates/_scripts/_datatable/_context_menu.py +221 -0
  121. figrecipe/_editor/_templates/_scripts/_datatable/_core.py +150 -0
  122. figrecipe/_editor/_templates/_scripts/_datatable/_editable.py +511 -0
  123. figrecipe/_editor/_templates/_scripts/_datatable/_import.py +161 -0
  124. figrecipe/_editor/_templates/_scripts/_datatable/_plot.py +261 -0
  125. figrecipe/_editor/_templates/_scripts/_datatable/_selection.py +438 -0
  126. figrecipe/_editor/_templates/_scripts/_datatable/_table.py +256 -0
  127. figrecipe/_editor/_templates/_scripts/_datatable/_tabs.py +354 -0
  128. figrecipe/_editor/_templates/_scripts/_debug_snapshot.py +186 -0
  129. figrecipe/_editor/_templates/_scripts/_element_editor.py +325 -0
  130. figrecipe/_editor/_templates/_scripts/_files.py +429 -0
  131. figrecipe/_editor/_templates/_scripts/_files_context_menu.py +240 -0
  132. figrecipe/_editor/_templates/_scripts/_hitmap.py +512 -0
  133. figrecipe/_editor/_templates/_scripts/_image_drop.py +428 -0
  134. figrecipe/_editor/_templates/_scripts/_inspector.py +315 -0
  135. figrecipe/_editor/_templates/_scripts/_labels.py +464 -0
  136. figrecipe/_editor/_templates/_scripts/_legend_drag.py +270 -0
  137. figrecipe/_editor/_templates/_scripts/_modals.py +226 -0
  138. figrecipe/_editor/_templates/_scripts/_multi_select.py +198 -0
  139. figrecipe/_editor/_templates/_scripts/_overlays.py +292 -0
  140. figrecipe/_editor/_templates/_scripts/_panel_drag.py +505 -0
  141. figrecipe/_editor/_templates/_scripts/_panel_drag_snapshot.py +33 -0
  142. figrecipe/_editor/_templates/_scripts/_panel_position.py +463 -0
  143. figrecipe/_editor/_templates/_scripts/_panel_resize.py +230 -0
  144. figrecipe/_editor/_templates/_scripts/_panel_snap.py +307 -0
  145. figrecipe/_editor/_templates/_scripts/_region_select.py +255 -0
  146. figrecipe/_editor/_templates/_scripts/_selection.py +244 -0
  147. figrecipe/_editor/_templates/_scripts/_sync.py +242 -0
  148. figrecipe/_editor/_templates/_scripts/_tabs.py +89 -0
  149. figrecipe/_editor/_templates/_scripts/_undo_redo.py +348 -0
  150. figrecipe/_editor/_templates/_scripts/_view_mode.py +107 -0
  151. figrecipe/_editor/_templates/_scripts/_zoom.py +212 -0
  152. figrecipe/_editor/_templates/_styles/__init__.py +78 -0
  153. figrecipe/_editor/_templates/_styles/_base.py +111 -0
  154. figrecipe/_editor/_templates/_styles/_buttons.py +327 -0
  155. figrecipe/_editor/_templates/_styles/_color_input.py +123 -0
  156. figrecipe/_editor/_templates/_styles/_composition.py +87 -0
  157. figrecipe/_editor/_templates/_styles/_controls.py +430 -0
  158. figrecipe/_editor/_templates/_styles/_datatable/__init__.py +40 -0
  159. figrecipe/_editor/_templates/_styles/_datatable/_editable.py +203 -0
  160. figrecipe/_editor/_templates/_styles/_datatable/_panel.py +268 -0
  161. figrecipe/_editor/_templates/_styles/_datatable/_table.py +479 -0
  162. figrecipe/_editor/_templates/_styles/_datatable/_toolbar.py +384 -0
  163. figrecipe/_editor/_templates/_styles/_datatable/_vars.py +123 -0
  164. figrecipe/_editor/_templates/_styles/_dynamic_props.py +144 -0
  165. figrecipe/_editor/_templates/_styles/_file_browser.py +466 -0
  166. figrecipe/_editor/_templates/_styles/_forms.py +224 -0
  167. figrecipe/_editor/_templates/_styles/_hitmap.py +191 -0
  168. figrecipe/_editor/_templates/_styles/_inspector.py +90 -0
  169. figrecipe/_editor/_templates/_styles/_labels.py +118 -0
  170. figrecipe/_editor/_templates/_styles/_modals.py +127 -0
  171. figrecipe/_editor/_templates/_styles/_overlays.py +130 -0
  172. figrecipe/_editor/_templates/_styles/_preview.py +430 -0
  173. figrecipe/_editor/_templates/_styles/_selection.py +73 -0
  174. figrecipe/_editor/_templates/_styles/_spinner.py +117 -0
  175. figrecipe/_editor/static/audio/click.mp3 +0 -0
  176. figrecipe/_editor/static/click.mp3 +0 -0
  177. figrecipe/_editor/static/icons/favicon.ico +0 -0
  178. figrecipe/_integrations/__init__.py +17 -0
  179. figrecipe/_integrations/_scitex_stats.py +298 -0
  180. figrecipe/_params/_DECORATION_METHODS.py +8 -0
  181. figrecipe/_recorder.py +63 -109
  182. figrecipe/_recorder_utils.py +124 -0
  183. figrecipe/_reproducer/__init__.py +18 -0
  184. figrecipe/_reproducer/_core.py +509 -0
  185. figrecipe/_reproducer/_custom_plots.py +279 -0
  186. figrecipe/_reproducer/_seaborn.py +100 -0
  187. figrecipe/_reproducer/_violin.py +186 -0
  188. figrecipe/_signatures/_kwargs.py +273 -0
  189. figrecipe/_signatures/_loader.py +21 -423
  190. figrecipe/_signatures/_parsing.py +147 -0
  191. figrecipe/_utils/__init__.py +3 -0
  192. figrecipe/_utils/_bundle.py +205 -0
  193. figrecipe/_wrappers/_axes.py +252 -895
  194. figrecipe/_wrappers/_axes_helpers.py +136 -0
  195. figrecipe/_wrappers/_axes_plots.py +418 -0
  196. figrecipe/_wrappers/_axes_seaborn.py +157 -0
  197. figrecipe/_wrappers/_caption_generator.py +218 -0
  198. figrecipe/_wrappers/_figure.py +188 -1
  199. figrecipe/_wrappers/_panel_labels.py +127 -0
  200. figrecipe/_wrappers/_plot_helpers.py +143 -0
  201. figrecipe/_wrappers/_stat_annotation.py +274 -0
  202. figrecipe/_wrappers/_violin_helpers.py +180 -0
  203. figrecipe/styles/__init__.py +8 -6
  204. figrecipe/styles/_dotdict.py +72 -0
  205. figrecipe/styles/_finalize.py +134 -0
  206. figrecipe/styles/_fonts.py +77 -0
  207. figrecipe/styles/_kwargs_converter.py +178 -0
  208. figrecipe/styles/_plot_styles.py +209 -0
  209. figrecipe/styles/_style_applier.py +42 -480
  210. figrecipe/styles/_style_loader.py +16 -192
  211. figrecipe/styles/_themes.py +151 -0
  212. figrecipe/styles/presets/MATPLOTLIB.yaml +2 -1
  213. figrecipe/styles/presets/SCITEX.yaml +40 -28
  214. figrecipe-0.9.0.dist-info/METADATA +427 -0
  215. figrecipe-0.9.0.dist-info/RECORD +277 -0
  216. figrecipe-0.9.0.dist-info/entry_points.txt +2 -0
  217. figrecipe/_editor/_bbox.py +0 -978
  218. figrecipe/_editor/_hitmap.py +0 -937
  219. figrecipe/_editor/_templates/_scripts.py +0 -2778
  220. figrecipe/_editor/_templates/_styles.py +0 -1326
  221. figrecipe/_reproducer.py +0 -975
  222. figrecipe-0.6.0.dist-info/METADATA +0 -394
  223. figrecipe-0.6.0.dist-info/RECORD +0 -90
  224. /figrecipe/_dev/demo_plotters/{plot_bar.py → bar_categorical/plot_bar.py} +0 -0
  225. /figrecipe/_dev/demo_plotters/{plot_barh.py → bar_categorical/plot_barh.py} +0 -0
  226. /figrecipe/_dev/demo_plotters/{plot_contour.py → contour_surface/plot_contour.py} +0 -0
  227. /figrecipe/_dev/demo_plotters/{plot_contourf.py → contour_surface/plot_contourf.py} +0 -0
  228. /figrecipe/_dev/demo_plotters/{plot_tricontour.py → contour_surface/plot_tricontour.py} +0 -0
  229. /figrecipe/_dev/demo_plotters/{plot_tricontourf.py → contour_surface/plot_tricontourf.py} +0 -0
  230. /figrecipe/_dev/demo_plotters/{plot_tripcolor.py → contour_surface/plot_tripcolor.py} +0 -0
  231. /figrecipe/_dev/demo_plotters/{plot_triplot.py → contour_surface/plot_triplot.py} +0 -0
  232. /figrecipe/_dev/demo_plotters/{plot_boxplot.py → distribution/plot_boxplot.py} +0 -0
  233. /figrecipe/_dev/demo_plotters/{plot_ecdf.py → distribution/plot_ecdf.py} +0 -0
  234. /figrecipe/_dev/demo_plotters/{plot_hist.py → distribution/plot_hist.py} +0 -0
  235. /figrecipe/_dev/demo_plotters/{plot_hist2d.py → distribution/plot_hist2d.py} +0 -0
  236. /figrecipe/_dev/demo_plotters/{plot_violinplot.py → distribution/plot_violinplot.py} +0 -0
  237. /figrecipe/_dev/demo_plotters/{plot_hexbin.py → image_matrix/plot_hexbin.py} +0 -0
  238. /figrecipe/_dev/demo_plotters/{plot_imshow.py → image_matrix/plot_imshow.py} +0 -0
  239. /figrecipe/_dev/demo_plotters/{plot_matshow.py → image_matrix/plot_matshow.py} +0 -0
  240. /figrecipe/_dev/demo_plotters/{plot_pcolor.py → image_matrix/plot_pcolor.py} +0 -0
  241. /figrecipe/_dev/demo_plotters/{plot_pcolormesh.py → image_matrix/plot_pcolormesh.py} +0 -0
  242. /figrecipe/_dev/demo_plotters/{plot_spy.py → image_matrix/plot_spy.py} +0 -0
  243. /figrecipe/_dev/demo_plotters/{plot_errorbar.py → line_curve/plot_errorbar.py} +0 -0
  244. /figrecipe/_dev/demo_plotters/{plot_fill.py → line_curve/plot_fill.py} +0 -0
  245. /figrecipe/_dev/demo_plotters/{plot_fill_between.py → line_curve/plot_fill_between.py} +0 -0
  246. /figrecipe/_dev/demo_plotters/{plot_fill_betweenx.py → line_curve/plot_fill_betweenx.py} +0 -0
  247. /figrecipe/_dev/demo_plotters/{plot_stackplot.py → line_curve/plot_stackplot.py} +0 -0
  248. /figrecipe/_dev/demo_plotters/{plot_stairs.py → line_curve/plot_stairs.py} +0 -0
  249. /figrecipe/_dev/demo_plotters/{plot_step.py → line_curve/plot_step.py} +0 -0
  250. /figrecipe/_dev/demo_plotters/{plot_scatter.py → scatter_points/plot_scatter.py} +0 -0
  251. /figrecipe/_dev/demo_plotters/{plot_eventplot.py → special/plot_eventplot.py} +0 -0
  252. /figrecipe/_dev/demo_plotters/{plot_loglog.py → special/plot_loglog.py} +0 -0
  253. /figrecipe/_dev/demo_plotters/{plot_semilogx.py → special/plot_semilogx.py} +0 -0
  254. /figrecipe/_dev/demo_plotters/{plot_semilogy.py → special/plot_semilogy.py} +0 -0
  255. /figrecipe/_dev/demo_plotters/{plot_stem.py → special/plot_stem.py} +0 -0
  256. /figrecipe/_dev/demo_plotters/{plot_acorr.py → spectral_signal/plot_acorr.py} +0 -0
  257. /figrecipe/_dev/demo_plotters/{plot_angle_spectrum.py → spectral_signal/plot_angle_spectrum.py} +0 -0
  258. /figrecipe/_dev/demo_plotters/{plot_cohere.py → spectral_signal/plot_cohere.py} +0 -0
  259. /figrecipe/_dev/demo_plotters/{plot_csd.py → spectral_signal/plot_csd.py} +0 -0
  260. /figrecipe/_dev/demo_plotters/{plot_magnitude_spectrum.py → spectral_signal/plot_magnitude_spectrum.py} +0 -0
  261. /figrecipe/_dev/demo_plotters/{plot_phase_spectrum.py → spectral_signal/plot_phase_spectrum.py} +0 -0
  262. /figrecipe/_dev/demo_plotters/{plot_psd.py → spectral_signal/plot_psd.py} +0 -0
  263. /figrecipe/_dev/demo_plotters/{plot_specgram.py → spectral_signal/plot_specgram.py} +0 -0
  264. /figrecipe/_dev/demo_plotters/{plot_xcorr.py → spectral_signal/plot_xcorr.py} +0 -0
  265. /figrecipe/_dev/demo_plotters/{plot_barbs.py → vector_flow/plot_barbs.py} +0 -0
  266. /figrecipe/_dev/demo_plotters/{plot_quiver.py → vector_flow/plot_quiver.py} +0 -0
  267. /figrecipe/_dev/demo_plotters/{plot_streamplot.py → vector_flow/plot_streamplot.py} +0 -0
  268. {figrecipe-0.6.0.dist-info → figrecipe-0.9.0.dist-info}/WHEEL +0 -0
  269. {figrecipe-0.6.0.dist-info → figrecipe-0.9.0.dist-info}/licenses/LICENSE +0 -0
@@ -0,0 +1,292 @@
1
+ #!/usr/bin/env python3
2
+ # -*- coding: utf-8 -*-
3
+ """Ruler, grid, and column overlay JavaScript for the figure editor."""
4
+
5
+ SCRIPTS_OVERLAYS = """
6
+ // ============================================
7
+ // MEASUREMENT OVERLAYS (Ruler, Grid, Columns)
8
+ // ============================================
9
+
10
+ // State for overlays
11
+ let rulerVisible = false;
12
+ let gridVisible = false;
13
+ let columnsVisible = false;
14
+
15
+ // Get figure DPI from server (default 300 for preview at 150)
16
+ // Preview DPI is 150, which is half of output DPI
17
+ const PREVIEW_DPI = 150;
18
+ const MM_PER_INCH = 25.4;
19
+
20
+ // Pixels per mm at preview resolution
21
+ function getPxPerMm() {
22
+ return PREVIEW_DPI / MM_PER_INCH;
23
+ }
24
+
25
+ // Unified ruler & grid state
26
+ let rulerGridVisible = false;
27
+
28
+ // Initialize overlay controls (single toggle button)
29
+ function initializeOverlayControls() {
30
+ const btn = document.getElementById('btn-ruler-grid');
31
+ if (btn) {
32
+ btn.addEventListener('click', toggleRulerGrid);
33
+ }
34
+ }
35
+
36
+ // Toggle all ruler/grid overlays together
37
+ function toggleRulerGrid() {
38
+ rulerGridVisible = !rulerGridVisible;
39
+
40
+ // Sync all three visibility states
41
+ rulerVisible = rulerGridVisible;
42
+ gridVisible = rulerGridVisible;
43
+ columnsVisible = rulerGridVisible;
44
+
45
+ // Update overlays
46
+ const rulerOverlay = document.getElementById('ruler-overlay');
47
+ const gridOverlay = document.getElementById('grid-overlay');
48
+ const columnOverlay = document.getElementById('column-overlay');
49
+
50
+ if (rulerOverlay) rulerOverlay.classList.toggle('visible', rulerGridVisible);
51
+ if (gridOverlay) gridOverlay.classList.toggle('visible', rulerGridVisible);
52
+ if (columnOverlay) columnOverlay.classList.toggle('visible', rulerGridVisible);
53
+
54
+ // Draw overlays if visible
55
+ if (rulerGridVisible) {
56
+ drawRuler();
57
+ drawGrid();
58
+ drawColumnGuides();
59
+ }
60
+
61
+ // Update button state
62
+ const btn = document.getElementById('btn-ruler-grid');
63
+ if (btn) {
64
+ btn.classList.toggle('active', rulerGridVisible);
65
+ }
66
+ }
67
+
68
+ // Legacy functions for backward compatibility
69
+ function toggleRuler() { toggleRulerGrid(); }
70
+ function toggleGrid() { toggleRulerGrid(); }
71
+ function toggleColumns() { toggleRulerGrid(); }
72
+
73
+ // Draw ruler overlay (top and left edges)
74
+ function drawRuler() {
75
+ const overlay = document.getElementById('ruler-overlay');
76
+ const img = document.getElementById('preview-image');
77
+ if (!overlay || !img) return;
78
+
79
+ // Clear existing
80
+ overlay.innerHTML = '';
81
+
82
+ const imgWidth = img.naturalWidth || img.width;
83
+ const imgHeight = img.naturalHeight || img.height;
84
+ const pxPerMm = getPxPerMm();
85
+
86
+ // Set SVG size
87
+ overlay.setAttribute('viewBox', `0 0 ${imgWidth} ${imgHeight}`);
88
+ overlay.style.width = imgWidth + 'px';
89
+ overlay.style.height = imgHeight + 'px';
90
+
91
+ const rulerThickness = 15; // pixels
92
+
93
+ // Background for horizontal ruler (top)
94
+ const hBg = document.createElementNS('http://www.w3.org/2000/svg', 'rect');
95
+ hBg.setAttribute('x', 0);
96
+ hBg.setAttribute('y', 0);
97
+ hBg.setAttribute('width', imgWidth);
98
+ hBg.setAttribute('height', rulerThickness);
99
+ hBg.setAttribute('class', 'ruler-bg');
100
+ overlay.appendChild(hBg);
101
+
102
+ // Background for vertical ruler (left)
103
+ const vBg = document.createElementNS('http://www.w3.org/2000/svg', 'rect');
104
+ vBg.setAttribute('x', 0);
105
+ vBg.setAttribute('y', 0);
106
+ vBg.setAttribute('width', rulerThickness);
107
+ vBg.setAttribute('height', imgHeight);
108
+ vBg.setAttribute('class', 'ruler-bg');
109
+ overlay.appendChild(vBg);
110
+
111
+ const widthMm = imgWidth / pxPerMm;
112
+ const heightMm = imgHeight / pxPerMm;
113
+
114
+ // Draw horizontal ruler ticks (every 1mm, labels every 5mm)
115
+ for (let mm = 0; mm <= widthMm; mm++) {
116
+ const x = mm * pxPerMm;
117
+ const isMajor = mm % 5 === 0;
118
+ const tickLen = isMajor ? 10 : 5;
119
+
120
+ const line = document.createElementNS('http://www.w3.org/2000/svg', 'line');
121
+ line.setAttribute('x1', x);
122
+ line.setAttribute('y1', 0);
123
+ line.setAttribute('x2', x);
124
+ line.setAttribute('y2', tickLen);
125
+ line.setAttribute('class', isMajor ? 'ruler-line-major' : 'ruler-line');
126
+ overlay.appendChild(line);
127
+
128
+ // Label every 10mm
129
+ if (mm % 10 === 0 && mm > 0) {
130
+ const text = document.createElementNS('http://www.w3.org/2000/svg', 'text');
131
+ text.setAttribute('x', x);
132
+ text.setAttribute('y', 13);
133
+ text.setAttribute('class', 'ruler-text');
134
+ text.setAttribute('text-anchor', 'middle');
135
+ text.textContent = mm.toString();
136
+ overlay.appendChild(text);
137
+ }
138
+ }
139
+
140
+ // Draw vertical ruler ticks (every 1mm, labels every 5mm)
141
+ for (let mm = 0; mm <= heightMm; mm++) {
142
+ const y = mm * pxPerMm;
143
+ const isMajor = mm % 5 === 0;
144
+ const tickLen = isMajor ? 10 : 5;
145
+
146
+ const line = document.createElementNS('http://www.w3.org/2000/svg', 'line');
147
+ line.setAttribute('x1', 0);
148
+ line.setAttribute('y1', y);
149
+ line.setAttribute('x2', tickLen);
150
+ line.setAttribute('y2', y);
151
+ line.setAttribute('class', isMajor ? 'ruler-line-major' : 'ruler-line');
152
+ overlay.appendChild(line);
153
+
154
+ // Label every 10mm
155
+ if (mm % 10 === 0 && mm > 0) {
156
+ const text = document.createElementNS('http://www.w3.org/2000/svg', 'text');
157
+ text.setAttribute('x', 2);
158
+ text.setAttribute('y', y + 3);
159
+ text.setAttribute('class', 'ruler-text');
160
+ text.setAttribute('text-anchor', 'start');
161
+ text.setAttribute('transform', `rotate(-90, 2, ${y})`);
162
+ text.textContent = mm.toString();
163
+ overlay.appendChild(text);
164
+ }
165
+ }
166
+ }
167
+
168
+ // Draw grid overlay (1mm and 5mm intervals)
169
+ function drawGrid() {
170
+ const overlay = document.getElementById('grid-overlay');
171
+ const img = document.getElementById('preview-image');
172
+ if (!overlay || !img) return;
173
+
174
+ // Clear existing
175
+ overlay.innerHTML = '';
176
+
177
+ const imgWidth = img.naturalWidth || img.width;
178
+ const imgHeight = img.naturalHeight || img.height;
179
+ const pxPerMm = getPxPerMm();
180
+
181
+ // Set SVG size
182
+ overlay.setAttribute('viewBox', `0 0 ${imgWidth} ${imgHeight}`);
183
+ overlay.style.width = imgWidth + 'px';
184
+ overlay.style.height = imgHeight + 'px';
185
+
186
+ const widthMm = imgWidth / pxPerMm;
187
+ const heightMm = imgHeight / pxPerMm;
188
+
189
+ // Draw vertical lines (every 1mm)
190
+ for (let mm = 0; mm <= widthMm; mm++) {
191
+ const x = mm * pxPerMm;
192
+ const is5mm = mm % 5 === 0;
193
+
194
+ const line = document.createElementNS('http://www.w3.org/2000/svg', 'line');
195
+ line.setAttribute('x1', x);
196
+ line.setAttribute('y1', 0);
197
+ line.setAttribute('x2', x);
198
+ line.setAttribute('y2', imgHeight);
199
+ line.setAttribute('class', is5mm ? 'grid-line-5mm' : 'grid-line-1mm');
200
+ overlay.appendChild(line);
201
+ }
202
+
203
+ // Draw horizontal lines (every 1mm)
204
+ for (let mm = 0; mm <= heightMm; mm++) {
205
+ const y = mm * pxPerMm;
206
+ const is5mm = mm % 5 === 0;
207
+
208
+ const line = document.createElementNS('http://www.w3.org/2000/svg', 'line');
209
+ line.setAttribute('x1', 0);
210
+ line.setAttribute('y1', y);
211
+ line.setAttribute('x2', imgWidth);
212
+ line.setAttribute('y2', y);
213
+ line.setAttribute('class', is5mm ? 'grid-line-5mm' : 'grid-line-1mm');
214
+ overlay.appendChild(line);
215
+ }
216
+ }
217
+
218
+ // Draw column guide lines (45mm intervals: 0, 45, 90, 135, 180mm)
219
+ function drawColumnGuides() {
220
+ const overlay = document.getElementById('column-overlay');
221
+ const img = document.getElementById('preview-image');
222
+ if (!overlay || !img) return;
223
+
224
+ // Clear existing
225
+ overlay.innerHTML = '';
226
+
227
+ const imgWidth = img.naturalWidth || img.width;
228
+ const imgHeight = img.naturalHeight || img.height;
229
+ const pxPerMm = getPxPerMm();
230
+
231
+ // Set SVG size
232
+ overlay.setAttribute('viewBox', `0 0 ${imgWidth} ${imgHeight}`);
233
+ overlay.style.width = imgWidth + 'px';
234
+ overlay.style.height = imgHeight + 'px';
235
+
236
+ // Journal column width: 45mm
237
+ // Lines at 0, 45, 90, 135, 180mm for 0, 1, 2, 3, 4 columns
238
+ const columnPositions = [
239
+ { mm: 0, label: '0' },
240
+ { mm: 45, label: '1 col' },
241
+ { mm: 90, label: '2 col' },
242
+ { mm: 135, label: '3 col' },
243
+ { mm: 180, label: '4 col' }
244
+ ];
245
+
246
+ for (const col of columnPositions) {
247
+ const x = col.mm * pxPerMm;
248
+
249
+ // Skip if beyond image width
250
+ if (x > imgWidth) continue;
251
+
252
+ // Draw vertical line
253
+ const line = document.createElementNS('http://www.w3.org/2000/svg', 'line');
254
+ line.setAttribute('x1', x);
255
+ line.setAttribute('y1', 0);
256
+ line.setAttribute('x2', x);
257
+ line.setAttribute('y2', imgHeight);
258
+ line.setAttribute('class', 'column-line');
259
+ overlay.appendChild(line);
260
+
261
+ // Label background
262
+ const labelBg = document.createElementNS('http://www.w3.org/2000/svg', 'rect');
263
+ const labelText = `${col.label} (${col.mm}mm)`;
264
+ const labelWidth = labelText.length * 7 + 8;
265
+ labelBg.setAttribute('x', x + 3);
266
+ labelBg.setAttribute('y', 3);
267
+ labelBg.setAttribute('width', labelWidth);
268
+ labelBg.setAttribute('height', 18);
269
+ labelBg.setAttribute('rx', 3);
270
+ labelBg.setAttribute('class', 'column-bg');
271
+ overlay.appendChild(labelBg);
272
+
273
+ // Label
274
+ const text = document.createElementNS('http://www.w3.org/2000/svg', 'text');
275
+ text.setAttribute('x', x + 6);
276
+ text.setAttribute('y', 16);
277
+ text.setAttribute('class', 'column-text');
278
+ text.setAttribute('text-anchor', 'start');
279
+ text.textContent = labelText;
280
+ overlay.appendChild(text);
281
+ }
282
+ }
283
+
284
+ // Update all overlays when image changes
285
+ function updateOverlays() {
286
+ if (rulerVisible) drawRuler();
287
+ if (gridVisible) drawGrid();
288
+ if (columnsVisible) drawColumnGuides();
289
+ }
290
+ """
291
+
292
+ __all__ = ["SCRIPTS_OVERLAYS"]