fontlab-grablab 1.1.16__tar.gz

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 (44) hide show
  1. fontlab_grablab-1.1.16/.gitignore +14 -0
  2. fontlab_grablab-1.1.16/CHANGELOG.md +493 -0
  3. fontlab_grablab-1.1.16/DEPENDENCIES.md +44 -0
  4. fontlab_grablab-1.1.16/LICENSE +201 -0
  5. fontlab_grablab-1.1.16/MIGRATION.json +35 -0
  6. fontlab_grablab-1.1.16/PKG-INFO +268 -0
  7. fontlab_grablab-1.1.16/README.md +246 -0
  8. fontlab_grablab-1.1.16/Scripts/GrabLab/grablab_menu.py +8 -0
  9. fontlab_grablab-1.1.16/Scripts/GrabLab/grablab_now.py +6 -0
  10. fontlab_grablab-1.1.16/Scripts/GrabLab/grablab_on_f5_mac.py +47 -0
  11. fontlab_grablab-1.1.16/Scripts/GrabLab/grablab_on_save.py +8 -0
  12. fontlab_grablab-1.1.16/examples/fonts/LICENSE-CC0.txt +121 -0
  13. fontlab_grablab-1.1.16/examples/fonts/README.md +7 -0
  14. fontlab_grablab-1.1.16/examples/fonts/ocra.md +19 -0
  15. fontlab_grablab-1.1.16/examples/fonts/ocra.vfj +10005 -0
  16. fontlab_grablab-1.1.16/examples/fonts/plum-var.md +19 -0
  17. fontlab_grablab-1.1.16/examples/fonts/plum-var.vfj +34344 -0
  18. fontlab_grablab-1.1.16/examples/fonts/sources.json +27 -0
  19. fontlab_grablab-1.1.16/examples/fonts/veni.md +18 -0
  20. fontlab_grablab-1.1.16/examples/fonts/veni.vfj +13453 -0
  21. fontlab_grablab-1.1.16/examples/native_smoke.py +23 -0
  22. fontlab_grablab-1.1.16/examples/screenshots/Artboard 1.svg +2090 -0
  23. fontlab_grablab-1.1.16/examples/screenshots/Artboard 1@2x.png +0 -0
  24. fontlab_grablab-1.1.16/examples/screenshots/README.md +16 -0
  25. fontlab_grablab-1.1.16/examples/screenshots/font-window-monochrome.svg +5055 -0
  26. fontlab_grablab-1.1.16/examples/screenshots/font-window-wireframe.svg +5055 -0
  27. fontlab_grablab-1.1.16/examples/screenshots/font-window.svg +5055 -0
  28. fontlab_grablab-1.1.16/examples/screenshots/glyph-window-monochrome.svg +7473 -0
  29. fontlab_grablab-1.1.16/examples/screenshots/glyph-window-wireframe.svg +7473 -0
  30. fontlab_grablab-1.1.16/examples/screenshots/glyph-window.svg +7473 -0
  31. fontlab_grablab-1.1.16/install.vfpy +39 -0
  32. fontlab_grablab-1.1.16/pyproject.toml +37 -0
  33. fontlab_grablab-1.1.16/src/grablab/__init__.py +55 -0
  34. fontlab_grablab-1.1.16/src/grablab/grab.py +605 -0
  35. fontlab_grablab-1.1.16/src/grablab/snapshot.py +220 -0
  36. fontlab_grablab-1.1.16/src/grablab/svg.py +845 -0
  37. fontlab_grablab-1.1.16/test.sh +4 -0
  38. fontlab_grablab-1.1.16/tests/test_capture.py +188 -0
  39. fontlab_grablab-1.1.16/tests/test_capture_exports.py +507 -0
  40. fontlab_grablab-1.1.16/tests/test_fly_consumers.py +152 -0
  41. fontlab_grablab-1.1.16/tests/test_historical_helpers.py +72 -0
  42. fontlab_grablab-1.1.16/tests/test_install_contract.py +77 -0
  43. fontlab_grablab-1.1.16/tests/test_snapshot.py +160 -0
  44. fontlab_grablab-1.1.16/tests/test_svg.py +901 -0
@@ -0,0 +1,14 @@
1
+ .venv/
2
+ .local/
3
+ __pycache__/
4
+ .pytest_cache/
5
+ *.egg-info/
6
+ dist/
7
+ uv.lock
8
+ # Private and scratch state: macOS metadata, agent scratch dirs, local envs (never source)
9
+ .DS_Store
10
+ .omc/
11
+ **/.omc/
12
+ .superpowers/
13
+ .worktrees/
14
+ *.vfpyc
@@ -0,0 +1,493 @@
1
+ ---
2
+ this_file: CHANGELOG.md
3
+ ---
4
+
5
+ ## Unreleased
6
+
7
+ - `install.vfpy` is now the short fontlab-instamix stub. It installs
8
+ fontlab-instamix from PyPI when it is missing, then installs this checkout from
9
+ its `[tool.fontlab-install]` table. The large legacy installer is gone.
10
+ - `tests/test_install_contract.py` keeps the declaration check and tests the stub and sdist;
11
+ `tests/test_install_lifecycle.py` (legacy installer internals only) is removed.
12
+ - README describes the stub install.
13
+
14
+ ## 2026-11-15 — Shared installer source alignment
15
+
16
+ Copied the reviewed shared installer exactly: dependency constraints and managed origins remain protected; inactive conditional dependencies are filtered before sibling execution in the resolver target Python. FontLab imports remain standard-library-only. Package identity, runtime APIs, dependency declarations, scripts, bundles and legal files are unchanged. Existing source-archive installer selection is retained. GrabLab contracts now require no-uv constraint refusal before script changes, preserve unlogged foreign scripts through uninstall, and verify managed-origin pins and declared optional metadata.
17
+
18
+ Focused checks: 46 passed in 0.40s. This qualifies the local source candidate only. Independent review, combined-main/full delivery gates, genuine release/downloads, installed provider closure and admitted FontLab/native workflows remain separate. No owner-folder installation or native operation ran.
19
+
20
+
21
+ ## 2026-11-14 — Functional work order documented
22
+
23
+ - Added the owner's functional-progress-first guidance and repository-specific priorities, including cross-package compatibility and a later detailed testing pass. Existing mandatory hooks, holds and unfinished work remain in force.
24
+ - This change updates guidance and planning only; it establishes no new runtime, installed, native or release result.
25
+
26
+ ## 2026-11-13 — Issue 255 verified release qualification
27
+
28
+ - [fontlab-grablab v1.1.14](https://github.com/fontlabcom/fontlab-grablab/releases/tag/v1.1.14) is released at `0de4c56f07605560309e47b774c8060a246141ce`. Reviewed main/tag delivery, applicable CI and actual downloads match the qualified artifacts.
29
+ - The F5/F6 and Save consumers, native smoke example and guarded Grab example use Fly; the wheel remains library-only.
30
+ - 206 runtime tests and all four complete changed-module gates pass (grab.py: 85.98% statements, 82.32% branches; the other three modules: 100%). All 36 documentation tests and exact 50-file parity pass. Genuine wheel/sdist ordinary cohorts each contain 29 compatible packages and match all 7 installed payload files; eight extracted-sdist consumer cases use stand-ins. Normal main/tag hooks, CI and actual downloads are qualified.
31
+ - Ordinary external installation is qualified; installed FontLab/native acceptance remains unproved under D43. Menu scripts and the smoke example are sdist/source payloads. Native acceptance must execute the published sdist example against the genuine installed GrabLab 1.1.14 wheel and assert that library imports resolve to that wheel.
32
+
33
+ ## 2026-11-13 — Fly imports for authored consumers (Issue 255)
34
+
35
+ - Route the F5/F6 and Save scripts, native smoke example and guarded Grab example
36
+ through Fly App/Qt aliases. Preserve App wildcard exports, deferred Save capture,
37
+ hotkey timestamp/modal/canvas behavior and smoke cleanup. Library imports stay
38
+ canonical; GrabLab itself still uses `grablab`.
39
+ - Declare `fontlab-fly>=1.3.0` in the source installer's consumer requirements,
40
+ alongside App and Darwin Quartz. The library-only wheel keeps its App dependency;
41
+ shared `install.vfpy` bytes and historical provenance remain unchanged.
42
+ - Eight new offline consumer cases failed before migration. All 206 runtime tests
43
+ pass on arm64 CPython 3.11.14 afterward, including owned success/failure cleanup
44
+ and installer metadata/argv checks. Each complete changed production module
45
+ passes the 80% statement/branch gate with zero exclusions: hotkey/save/smoke
46
+ 100%; grab.py 85.98% statements and 82.32% branches. Ruff retains the same 31
47
+ inherited findings; none added. Locked external docs preview and all 36 docs
48
+ tests pass. This qualifies source and stand-ins, not native capture or artifacts.
49
+ - Ordinary Fly 1.3.0/App 1.2.15 imports preserve App and PrefLib/hotkey module
50
+ identity. Native Qt identity uses a stand-in with `__spec__ = None`; no native
51
+ provider or real handler was activated. GrabLab remains source-only in this probe.
52
+ - Independent source review reports SPEC PASS / QUALITY PASS. Controller reruns
53
+ pass 206 runtime tests and all four strict module gates; the exact-lock docs
54
+ build, 36 documentation tests and 50-file clean-rebuild parity pass. Final
55
+ containing-commit output, artifact installation and native proof remain separate.
56
+
57
+
58
+ ## 2026-11-12 — D46 documentation pass (Issue 250)
59
+
60
+ - Landed on `main` this session: `e3644bd` (2026-11-10 entry), `e71be0f` (historical helper dispositions, 2026-11-11), `3d5209b` (install-contract fake matches installed App metadata, owner change) and `3022a89` (TODO: decide whether Grablab joins the `install.vfpy` sync set). No source changed in this pass.
61
+ - Grablab's `install.vfpy` (a46f3d19) was deliberately not synced to App's canonical `install.vfpy` (Issue 254 propagation covered App, pens, fontport, echopy, fly, glyport and scriptmix); the decision stays an open TODO row.
62
+ - `WORK.md` is a short status stub; its earlier 43,685-byte content (SHA-256 `0a8a5eea588b92b5b112242189e6645081f65f288f348b5a1b4e5e58116eb4a3`) stays archived on the workspace data volume.
63
+
64
+ ## 2026-11-12 — install contract fake matches installed App metadata (owner change)
65
+
66
+ - The owner changed `tests/test_install_contract.py`. The `distribution` fake now compares normalised names (`i.norm`), as `install.vfpy` does. It also reports `INSTALLER` as `install.vfpy`, because App was installed earlier from its sibling checkout and uv must not look it up again. Landed by lander1 from the owner's working-tree edit; no other bytes changed.
67
+
68
+ ## 2026-11-11 — historical helper dispositions pinned (Issue 250)
69
+
70
+ - New `tests/test_historical_helpers.py`. Each of `copy_statusid.py`, `copy_statusid2.py`, `print_menu.py`, `print_uimenu.py` and `ui_hider.py` must keep exactly one README disposition line. None may appear under `Scripts`, the wheel packages, the sdist `only-include` inputs or `[tool.fontlab-install]` script folders, and neither `install.vfpy` nor `MIGRATION.json` may name them.
71
+ - The preserved sources are not on GrabLab `main`; they remain in the workspace's confidential historical corpus. The tests therefore assert absence, not content.
72
+ - Mutants: a `Scripts/Help Dev/ui_hider.py` file, a `src/grablab/legacy/print_uimenu.py` file, a removed `print_menu.py` README line and a `copy_statusid` mention in `install.vfpy` each fail 1 test (7 pass).
73
+
74
+ ## 2026-11-10 — native smoke passed against App main (Issue 250)
75
+
76
+ `examples/native_smoke.py` ran inside FontLab 9 through `fl-native.sh` with
77
+ `sys.path` swapped to App origin/main and this source: it printed "Native PNG and
78
+ SVG passed" (widget capture wrote a PNG and an SVG to a temporary folder). The
79
+ installed-wheel run remains open. No code changed.
80
+
81
+ ## 2026-11-10 — live font editing rule (Issue 250, D44)
82
+
83
+ - AGENTS.md: agents test and edit the font open in FontLab 9, starting from the Desktop VFJs, and may save them.
84
+
85
+ ## 2026-11-10 — install.vfpy always reinstalls scripts and dependencies
86
+
87
+ - Every install copies all files from `Scripts/` afresh and replaces any file
88
+ already at the same path. A symlinked script folder is replaced by a real
89
+ folder; the link target is never written. A directory where a script file
90
+ belongs is still refused.
91
+ - Required packages are installed on every run. Packages that no package
92
+ index carries (the fontlab-* packages, pythonqtside) are installed from
93
+ checkouts beside this one through their own `install.vfpy`, once per run
94
+ and safe against cycles. uv receives every other requirement, so version
95
+ ranges, markers and extras are enforced. Without uv, sibling checkouts are
96
+ still installed and only the remaining missing requirements are reported.
97
+ - The installer is byte-identical across all eleven installer repositories.
98
+
99
+ ## 2026-11-05 — independently approved documentation applied
100
+
101
+ [Task 2 final review](../verification/issue-230/task-2-fix2-review.md) records
102
+ SPEC PASS / QUALITY APPROVED. The [78-file application receipt](../verification/issue-230/task-2-apply.json)
103
+ includes this repository's six guides and preserves all 21 repository heads,
104
+ branches, indexes and non-selected diffs. This is applied documentation evidence,
105
+ not a new product test, installed artifact, native result or publication.
106
+
107
+ The complete earlier handoff/history below retains its proposal-stage statements
108
+ and dated source pins. Later review, application and delivery status belong in the
109
+ [live workspace ledger](../verification/issue-230/progress.md). Original future,
110
+ native, artifact and preservation contracts remain binding.
111
+
112
+ ## 2026-11-05 — documentation reconciliation proposal
113
+
114
+ Prepared repository-specific organization, test and MVP/delivery guidance from current source/test configuration and retained Issue 207–211 evidence. Distinguished current canonical layout from qualified candidates, future plugin ownership and unfinished native/artifact gates. Preserved all prior work and changelog evidence; no runtime completion, installation or publication is claimed. Completed historical task rows were removed from the active checklist and consolidated below from existing local CHANGELOG/WORK receipts. Unfinished native, artifact and integration checks remain open.
115
+
116
+ ## Retained scoped completion receipts — corrected evidence map
117
+
118
+ These are dated results at the stated source/version and acceptance surface. They do not establish current integrated, installed, native or published acceptance. Full receipts and hashes are indexed in the workspace Issue 230 task-2 manifest. Canonical-preimage line ranges below refer to the unchanged historical documents, before these new entries.
119
+
120
+ - Four-mode icon follow-up:141package tests;48actual-wheel tool tests;466d986 source/artifact identity;156SVG/24gallery/12embedding checks.
121
+ Historical receipt: WORK.md:5–41.
122
+
123
+ - Issue131 paired widget/runtime metadata implementation;source90c1842;122 full/installed tests;85.09/94.93/95.68% changed-module coverage.
124
+ Historical receipt: CHANGELOG.md:235–255; WORK.md:431–452.
125
+
126
+ - Issue1310.2.1.dev18+g90c1842e6:ordinary parity/122 installed tests;owned native captures/preferences and6 browser variants;owner font creation/export waiver.
127
+ Historical receipt: WORK.md:431–459.
128
+
129
+ - Issue1310.2.1.dev18+g90c1842e6:composed Font/Glyph captures and six vector/mono/wireframe variants reviewed;ambiguous rasters retained.
130
+ Historical receipt: WORK.md:431–459.
131
+
132
+ ## 2026-11-05 — planning chronology reconciliation
133
+
134
+ Four-mode icon source466d986 and paired screenshot source90c1842 are bounded verified deliveries, not current implementation tasks. Whole-desktop/all-configurations/dialog restoration/Issue122Appsmoke remain open, with owner font creation/export waiver intact. Historical passing results retain their dated source and acceptance scope in the entries above and original history below. This documentation change creates no new runtime acceptance.
135
+
136
+ ---
137
+ this_file: CHANGELOG.md
138
+ ---
139
+
140
+ ## 2026-11-03 — fixes from runs inside FontLab 9
141
+
142
+ - The SVG asset manifest is read as UTF-8 (FontLab's Python defaults to ASCII).
143
+
144
+ ## 2026-11-03 — installer options, licence and cleanup
145
+
146
+ - `install.vfpy` reads optional `[tool.fontlab-install]` keys: `name` (the distribution
147
+ record), `packages` (`[]` installs scripts only) and `dependencies` (what FontLab needs,
148
+ instead of `project.dependencies`). Symlinks inside `Scripts/` are not copied.
149
+ - Relicensed under Apache-2.0 by the copyright owner (previously BSD-3-Clause). `LICENSE` now
150
+ holds the Apache License 2.0 text.
151
+
152
+ ## 2026-11-03 — install.vfpy fixes from runs inside FontLab 9
153
+
154
+ Verified by installing all nine packages inside FontLab 9 (Python 3.11.6, arm64).
155
+ - Dependencies with console scripts (glyphsLib, fontTools) failed: uv writes them to
156
+ `site-packages/../../../bin`, which resolves through the venv link to the FontLab
157
+ folder. `bin`, `share` and `include` there now link back into `.venv`.
158
+ - A failed install appends a `"failed"` record with the traceback and uv's output to
159
+ `install.log`; List/Uninstall ignore failed records.
160
+ - Package records include `WHEEL`, so `uv pip check` accepts them.
161
+ - Scripts are copied file by file into FontLab's `Scripts` folder, from a package's
162
+ `Scripts/` folder (exact case) and from folders listed in `[tool.fontlab-install] scripts`.
163
+ Folders shared by several packages merge, e.g. two packages' `Scripts/Kerning`. The
164
+ installer refuses to overwrite a file another package or the user put there; uninstall
165
+ removes only its own files, their `.pyc`, and folders left empty. An older install's
166
+ folder link (`Scripts/Aidus Code`) is replaced by copied files.
167
+ - `*.vfpyc` (FontLab's compiled `install.vfpy`) is ignored by Git.
168
+
169
+ ## 2026-11-03 — install.vfpy creates FontLab's venv
170
+
171
+ FontLab's `python/3.11/site-packages` is now always a real folder; packages are
172
+ symlinked into it, so no `.pth` processing is needed. `install.vfpy` creates `.venv` with
173
+ uv from FontLab's exact Python version and processor type, and links the venv's
174
+ site-packages to FontLab's folder, so `uv pip install --python .venv/bin/python` installs
175
+ into FontLab. An older layout (FontLab's folder linked into `.venv`) is migrated.
176
+
177
+ ## 2026-11-03 — reverse-domain extension id and install.log
178
+
179
+ `[tool.fontlab-install] id = "com.fontlab.grablab"` names this extension. `install.vfpy` keeps
180
+ `Extensions/com.fontlab.grablab/install.log` (JSON Lines; the last line lists every installed file),
181
+ puts copied code in `Extensions/com.fontlab.grablab/lib/`, and adds Scripts > Extensions >
182
+ List Extensions and Uninstall com.fontlab.grablab.
183
+
184
+ ## 2026-11-03 — install.vfpy without uv
185
+
186
+ `install.vfpy` now needs only FontLab's Python. It asks FontLab for its data folder
187
+ (`flPreferences().dataPathDefault`), links a Git checkout or copies a plain folder into
188
+ `Extensions/`, and writes a `.pth` plus `.dist-info` into `python/3.11/site-packages`.
189
+ uv is used only to add missing dependencies. It never replaces folders it does not own.
190
+
191
+ ## 2026-11-03 — release scripts
192
+
193
+ Added `build.sh` (uv build into dist/), `publish.sh` (`uv publish`; refuses a dirty
194
+ tree or an untagged HEAD) and `install.vfpy` (editable install into FontLab's venv
195
+ from inside FontLab). Version stays hatch-vcs from `vX.Y.Z` tags.
196
+
197
+ <!-- workspace-handoff:2026-11-03 -->
198
+ ## 2026-11-03 — documentation handoff for November 2–3
199
+
200
+ No new November 2–3 runtime delivery is attributed here; historical export evidence and current access holds remain retained.
201
+
202
+ No capture, export, preference change or native acceptance is implied by documentation maintenance.
203
+
204
+ Observed canonical checkout: `main` at `3ebbf85b0128`. No source integration is performed by this update.
205
+
206
+ Updated the requested AGENTS/TODO/PLAN/CHANGELOG/README documentation and
207
+ recorded the paused state. Existing project text, examples and history remain;
208
+ no runtime source, installation, native session, branch/ref, release or site was
209
+ changed by this documentation maintenance. Source/archive/ordinary/native and
210
+ promotion acceptance remain separate claims. Detailed workspace evidence is
211
+ recorded in the root CHANGELOG and retained verification reports.
212
+ <!-- /workspace-handoff -->
213
+
214
+ # Changelog
215
+
216
+ ## 2026-11-10 — Issue 250 documentation round
217
+
218
+ - AGENTS.md describes the delegation, integration and release workflow.
219
+ - WORK.md reset to the current round; the earlier bytes are archived on the owner's workspace data volume, not public.
220
+
221
+ ## 2026-11-03 — Issue 201 audit
222
+
223
+ - No file removed: every tracked file is referenced by code, tests, packaging or docs (evidence in the
224
+ workspace `verification/issue-201/task-15-report.md`). Imports of `fontlabapp` (`Application`,
225
+ `utils.attribdict/slugify/timestamp`, `application.preflib`) resolve in the issue-201 App.
226
+ Removed a stale AGENTS.md sentence about a README `--python 3.12`.
227
+
228
+ ## 2026-10-26 — icon representation modes
229
+
230
+ - Add host-free base64, PNG URL, SVG URL and default inline SVG processing,
231
+ named asset links, outcome receipts, and output-aware composition.
232
+ - Preserve existing inline_images callers and capture behavior.
233
+
234
+ ## Issue 131 Task 10 review fix round1 — 2026-10-26
235
+
236
+ Refuse CSS-wide root filter keywords before monochrome mutation, preventing
237
+ invalid keyword/function lists from silently preserving coloured output. Covers
238
+ initial, unset, inherit, revert and revert-layer, case-insensitively, in inline
239
+ styles and presentation attributes. All12new parametrized controls failed first.
240
+ Conservative refusal preserves the complete document; no cascade resolver added.
241
+
242
+ Fresh commands (exit0):
243
+ ```
244
+ rtk proxy env PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 <svg-env>/bin/python -m pytest -q
245
+ rtk proxy uvx ruff check src/grablab/svg.py tests/test_svg.py
246
+ rtk proxy git diff --check
247
+ ```
248
+ 119tests pass and Ruff/diff clean. Wait, but: actual screenshot rerenders and
249
+ ordinary artifacts remain the root's separate gate; no native or tooling changes.
250
+
251
+ ## Issue 131 Task 10 rendered acceptance correction — 2026-10-26
252
+
253
+ Actual Chrome captures exposed two presentation failures. Monochrome now applies
254
+ standard grayscale to the complete SVG drawing, preserving the light/dark paint
255
+ hierarchy, geometry and existing root/descendant filter effects. The actual
256
+ process_captures.py caller no longer overrides every stroke/fill with dark grey.
257
+ Wireframe keeps originally painted surfaces white (or the requested background),
258
+ retains none paints and sibling order, and uses readable dark text/outlines.
259
+ Definition/clip/pattern/filter/marker descendants remain unchanged; container paint
260
+ is not overridden so resource inheritance remains intact. Retained raster
261
+ wireframe wrappers and their existing effects remain supported and idempotent.
262
+ Author stylesheets in monochrome and important root filters are refused before
263
+ mutation; masks retain their existing refusal. No new dependency or color parser.
264
+
265
+ Reviewed W3C Filter Effects 1 sections5,6,13 for full-drawing filtering and ordered
266
+ filter function composition: https://www.w3.org/TR/filter-effects-1/#FilterProperty
267
+ Two new contrast/occlusion tests failed before implementation. Fresh checks:
268
+
269
+ ```
270
+ rtk proxy env PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 <svg-env>/bin/python -m pytest -q
271
+ rtk proxy uvx ruff check src/grablab/svg.py tests/test_svg.py
272
+ rtk proxy git diff --check
273
+ ```
274
+
275
+ All107tests pass; Ruff and diff checks exit0. Wait, but: this proves source
276
+ regressions, not the root's separately required actual rendered acceptance or
277
+ ordinary wheel qualification. No native call, live install, push or font work.
278
+
279
+
280
+ ## 2026-10-26 — issue 131 final SVG review fixes
281
+
282
+ - Rewrite local URL references in one dictionary-backed pass, avoiding per-ID
283
+ regex compilation on every attribute during large semantic capture composition.
284
+ - Refuse mask-bearing restyling before mutation, including font changes, to
285
+ preserve luminance masks and inherited text geometry.
286
+
287
+ ## 2026-10-26 — issue 131 Task 9 review fix
288
+
289
+ - Refuse stylesheet-bearing retained-raster monochrome/wireframe input before
290
+ mutation, preserving selector-dependent geometry/effects by failing explicitly.
291
+
292
+ ## 2026-10-26 — issue 131 retained raster monochrome treatment
293
+
294
+ - Add explicit monochrome raster presentation to restyle, also enabled by
295
+ wireframe. Preserve image bytes, geometry, existing effects and sibling order;
296
+ reuse marked grayscale wrappers on repeated calls and report filtered counts.
297
+
298
+ ## 2026-10-26 — issue 131 screen/canvas pairing
299
+
300
+ - Pair high-level screen captures as PNG plus explicitly raster-backed SVG;
301
+ preserve one capture, logical geometry, physical pixels/DPR and metadata.
302
+ - Pair all native canvas vector variants with PNG rendered from that same SVG;
303
+ record source viewBox/frame mapping and preserve flags, dark/alternative/PDF
304
+ behavior, painter cleanup and preference restoration.
305
+ - Reuse exclusive staged bundle publication and JSON sidecars for non-widget
306
+ captures without inventing Designer UI. Preserve primitive return interfaces.
307
+
308
+ ## 2026-10-25 — issue 131 host-free SVG pipeline
309
+
310
+ - Review fix round1: retain contradictory authoritative-name candidates beside
311
+ exported-pixel matches; fail closed on unresolved equal-area widget ties; use
312
+ maintained CSS cascade parsing to preserve effective no-paint during restyling.
313
+
314
+ - Add explicit SVG postprocessing: provenance-aware raster/vector mapping,
315
+ namespaced inlining, coordinate widget tags on original paint elements,
316
+ conservative opt-in duplicate cleanup, logical composition and restyling.
317
+ - Preserve raw captures through exclusive new output files. Disclose ambiguous,
318
+ unmatched and unsupported raster/semantic cases; distinguish source-name vector
319
+ associations from exported pixel-equivalent matches.
320
+ - Add optional Pillow/svgelements dependencies and host-free regression controls.
321
+ Native screenshot and rendered-geometry acceptance remain separate.
322
+
323
+ ## 2026-10-15 — completed checklist (moved from TODO.md)
324
+
325
+ - Record source provenance and baseline.
326
+ - Implement complete package migration and scoped modernization.
327
+ - Verify wheel, sdist, isolated installs and privacy.
328
+ - Verify relevant native behavior in FontLab.
329
+ - Pass review and scoped fixes.
330
+ - Complete all three project iterations.
331
+ - Push, tag, release and verify assets.
332
+
333
+ ## v0.2.1 (2026-10-16)
334
+
335
+ Documentation and ignore-rule reconciliation since v0.2.0 (issue 101/104/106); no runtime changes. Release review: verification/issue-106/reviews/X5-fontlab-grablab.md.
336
+
337
+
338
+ - Preserve all source functionality and license notices with migration hashes.
339
+ - Add hatch-vcs wheel/sdist packaging, lazy imports and source annotations.
340
+ - Restore rendering preferences and alternative-view toggles around capture.
341
+ - Fix failed-save stale-file reporting, recursive collision handling and dropped
342
+ submenu paths; preserve SVG metadata and add missing elements.
343
+ - Allow reuse of an Application context through an optional constructor argument.
344
+ - Verify source regressions and installed native hidden-widget capture.
345
+ - Exclude failed screen captures from saved-file lists; avoid mutable screen default.
346
+
347
+ ## v0.2.0 publication verified
348
+
349
+ Actual publication and independent downloaded-asset verification complete.
350
+ Three full-project iterations pass; installed tagged wheel/sdist each457tests.
351
+ Downloaded native smoke covers all eight packages and both formats, including
352
+ production ACP/native UI and TypeRig composition. Exact release URLs, immutable
353
+ code commit and asset digests are in RELEASE.md. This follow-up changes only
354
+ completion evidence; release code and tag are unchanged.
355
+
356
+ ## 2026-10-15 — workspace plan and checklist reconciliation
357
+
358
+ Completed repository scope archived after reading WORK.md and checking the
359
+ workspace evidence. Workspace release/integration gates remain in the parent
360
+ PLAN.md. Historical verification limits below remain part of the record.
361
+
362
+ ### Archived PLAN.md
363
+
364
+ # Plan
365
+
366
+ No open work in this repository. Its issue 101 migration scope is complete and released as verified v0.2.0 (see README.md "Status" and RELEASE.md). Cross-package work for the expanded ecosystem (joint regression in the three expanded iterations, R050/P11, and any new release) is tracked in the workspace PLAN.md.
367
+
368
+ ### Archived TODO.md
369
+
370
+ # Tasks
371
+
372
+ No open tasks. Workspace-level work is tracked in the parent TODO.md.
373
+
374
+
375
+ ## Issue 131 — source candidate, native acceptance pending
376
+
377
+ - Pair widget PNG/SVG by one collision-safe basename across image/JSON/UI members,
378
+ independently of DPR; preserve image-only returns and add automatic sidecars.
379
+ - Embed FontSnap-shaped extended records in PNG/SVG and retain bounded visible
380
+ runtime widget geometry/content in JSON and Qt Designer XML without model walks.
381
+ - Stage bundles and publish exclusively with rollback; retain preference restoration.
382
+ - Make the former SVG font/stroke substitutions explicit `restyle=True` opt-in.
383
+
384
+
385
+ ### Issue 131 Task 1 review fixes
386
+
387
+ - Restrict Designer properties to writable standard-control allowlists; retain
388
+ read-only progress/spin display text in JSON and deduplicate checked state.
389
+ - Include rendered descendants of hidden owned roots via relative visibility.
390
+ - Measure visible contained menu/menu-bar action geometry/text; classify hidden,
391
+ empty and clipped owned actions outside, and emit supported action/addaction UI.
392
+ - Validate generated standard-control and menu XML with actual Qt5 uic.
393
+
394
+ - Keep unnamed measured menu/menu-bar QAction content in FontSnap-compatible
395
+ parts; reserve generated IDs for runtime extensions and Designer references.
396
+
397
+ ## Issue 131 premultiplied PNG matching
398
+
399
+ - Match exact8-bit premultiplied pixels across Qt PNG round-trips, preserving ambiguity and visible channel/alpha differences. Rebuild schema1indexes as schema2.
400
+
401
+ ### Issue 131 verified delivery — 2026-10-26
402
+
403
+ - Qualify paired native window/panel/canvas snapshots and actual composed vector, mono and wireframe screenshots; preserve ambiguous raster content.
404
+ - Verify ordinary artifacts, 122 tests and changed-module coverage above80%; record the owner font-work waiver and remaining native integration limits.
405
+
406
+
407
+ ## 2026-11-06 — bounded source reconciliation candidate
408
+
409
+ - Reuse App >=1.2.0's GlyphWindow viewport adapter with direct/named/missing,
410
+ visibility/order/return and failure-restoration regression controls.
411
+ - Restore the explicit source-installer App/Darwin Quartz requirements; keep
412
+ install.vfpy unchanged and disclose its presence-only version/marker limitation.
413
+ - Include the four current Scripts and installer in sdists; wheels remain library-only.
414
+ - Bind the removed recovery archive to its immutable ancestor revision while
415
+ preserving migration hashes/keys, fixture/licence/screenshot provenance and
416
+ the five historical helpers' individual dispositions outside active payloads.
417
+ - Source, ordinary artifacts, current native/owner installation, remote delivery
418
+ and private Pages publication retain separate acceptance boundaries.
419
+
420
+ ### Retained historical owner report
421
+
422
+ Historical owner report from 2026-11-05, retained verbatim from acb33b0a. Its native installation, live viewport, and 53-test statements are owner-reported history, not controller acceptance for current source. The presence-only installer check does not evaluate version ranges or markers; uv evaluates submitted requirement strings. Current supported behavior and ordinary proof are recorded separately.
423
+
424
+ ## 2026-11-05 — F5/F6 hotkey script: Quartz dependency installed
425
+
426
+ `Scripts/GrabLab/grablab_on_f5_mac.py` failed with `ModuleNotFoundError: No module named 'Quartz'`:
427
+ `fontlabapp.hotkey` imports `Quartz` on macOS, which App only declares in its optional
428
+ `hotkeys` extra, and GrabLab's installer dependencies never asked for it. Following the
429
+ fontport/glyport pattern, `[tool.fontlab-install] dependencies` now lists
430
+ `fontlab-fontlabapp>=1.2.0` and `pyobjc-framework-Quartz>=10; sys_platform == 'darwin'`
431
+ (spelled out: linked App records carry no extras metadata, so `fontlab-fontlabapp[hotkeys]`
432
+ would resolve to nothing). `install.vfpy` is unchanged; its presence check and
433
+ `uv pip install` already handle markers. Reinstalled through the native runner into the
434
+ owner's FontLab 9: pyobjc-core, -cocoa and -quartz 13.0 landed in `.venv`/site-packages,
435
+ the dist-info record lists both requirements, and inside the running host
436
+ `fontlabapp.hotkey.HotkeyManager` resolves to `fontlabapp.core.hotkey.mac`. The owner's
437
+ pre-existing hand-copied `Scripts/GrabLab` (byte-identical to the repo's) was moved aside so
438
+ the installer could own the folder.
439
+
440
+ `Scripts/GrabLab/grablab_on_save.py` connected `Grab().grabAll` straight to
441
+ `QAction.triggered`, which emits `checked: bool`, so every save raised
442
+ `TypeError: Grab.grabAll() takes 1 positional argument but 2 were given`. The slot is now a
443
+ lambda that drops the argument. The installed copy in FontLab's Scripts folder was updated
444
+ in place (same content the installer would copy).
445
+
446
+ `Grab.grabGlyphWindows` read `widget.widgetViewport`, which FontLab 9's PythonQt does not
447
+ expose as an attribute (`AttributeError: GlyphWindow has no attribute named 'widgetViewport'`).
448
+ It now takes the viewport from App's `fontlabapp.qt.views.GlyphWindow`, which falls back to
449
+ the child widget with that objectName. Verified in the running host: the open glyph window's
450
+ viewport resolves to a `YLighterWidget`. Tests: 53 pass.
451
+
452
+ ## 2026-11-06 — Private documentation candidate
453
+
454
+ Added the product-specific light ProperDocs/MaterialX source/generated site and every-main source/output qualification workflow without private Pages operations. Runtime products and native acceptance are unchanged.
455
+
456
+
457
+ ## 2026-11-07 — Exact frontend notices and English search assets
458
+
459
+ Added exact upstream frontend notices and source-map provenance for the existing MaterialX 10.1.8 payload. Explicit English configuration and a small build hook reject language, corpus, reference, asset-set or hash drift before omitting the 35 unused language helpers. All nine retained core assets, original product legal files, guides, catalogue rows, media, runtime and dependency/build locks are preserved.
460
+
461
+ The strict site build and all 35 documentation tests pass. The complete new hook has 100% statement/branch coverage; real Git staging, checkout and archives preserve exact legal bytes. An independently installed matching lock reproduces all 50 output bytes and modes. Existing immutable source/output, epoch, concurrency and full-parity workflow checks remain active. Browser and independent review evidence are separate from these local checks.
462
+
463
+ Private Pages configuration, grants, requests and publication remain owner-held; this source follow-up adds none.
464
+ No product release or installation is claimed. Prior ordinary artifacts remain bound to their recorded revisions; a later Git revision changes genuine hatch-vcs metadata. Full current source archives include these documentation additions; no unchanged-sdist or whole-wheel identity is asserted. Native acceptance and owner installation remain separate.
465
+
466
+
467
+ ## 2026-11-07 — installed icon path-tuple inventory refinement
468
+
469
+ The current HTML/CSS contains 45 distinct ordered SVG path tuples. A complete scan of the four installed MaterialX icon families finds 43 exact installed matches and two unmatched Lucide tuples, refining the earlier known-candidate inventory. The additional installed match is the Font Awesome version caret-down. Its existing CSS header and full notice retain Font Awesome Free 7.1.0, Fonticons and CC-BY-4.0 icon attribution. The official NPM caret SVG has different raw path bytes; no unmodified-primary SVG, whole-geometry or optimizer-recipe equivalence is claimed. The two unmatched Lucide tuples retain their pinned SCSS source attribution.
470
+
471
+ A new actual-output regression derives these counts and checks installed matches, unmatched CSS references and the caret header. It fails against the prior 42 count and passes with the corrected metadata. All 36 current documentation tests pass; full strict and independent exact-lock builds match every output byte and mode. Only the legal paragraph, corresponding inventory and legal search row change in the site. Runtime, packaging, generators, vendor assets, full notices, existing guidance and the Fly search fix remain exact. Fresh browser verification and independent review are recorded separately. No private Pages operation, delivery, installed-product upgrade or native acceptance is claimed.
472
+
473
+
474
+ ## 2026-11-07 — Release-note attribution correction
475
+
476
+ Removed the Pythonqtside-only relocation and sdist sentence from the Task11 documentation entry. All history before that entry remains byte-exact. The existing documentation checks and normal installed pre-push gate pass; WORK.md records their scope and limits.
477
+
478
+
479
+ ## 2026-11-07 — Resolve complete source-installer requirements with uv
480
+
481
+ The source installer now sends every declared requirement unchanged to uv,
482
+ including versions, markers and extras, when uv is available. It retains empty
483
+ requirements, both Python target routes, normal satisfied-package behavior and
484
+ the explicit limited presence-only fallback without uv. No runtime dependency
485
+ or custom requirement parser is added.
486
+
487
+ All 189 source tests pass; the complete installer reaches 95.77% combined
488
+ statement/branch coverage with no exclusions. Owned offline resolver experiments
489
+ prove too-old upgrade, false-marker omission, requested extras, satisfied no-op
490
+ and real failure/payload preservation on both target routes. Genuine precommit
491
+ wheel/sdist and ordinary tests qualify their recorded candidate bytes separately
492
+ from final delivery. Native/owner installation, full G2 and private Pages remain
493
+ separate. All earlier history, including the qualified owner report, is retained.
@@ -0,0 +1,44 @@
1
+ ---
2
+ this_file: DEPENDENCIES.md
3
+ ---
4
+
5
+ ## Conditional installer requirements
6
+
7
+ Only conditional installer requirements use `packaging==26.3` in an external uv-managed Python environment. FontLab itself imports only the standard library; no permanent project dependency was added. An unavailable helper fails before sibling execution.
8
+
9
+
10
+
11
+ # Dependencies
12
+
13
+ - hatchling and hatch-vcs: standard builds and Git-tag versioning.
14
+ - pytest: regression tests; native host checks run separately.
15
+ - fontlab-fontlabapp >=1.2.0: application/UI/preferences and the supported
16
+ `qt.views.GlyphWindow` viewport adapter, including named-child lookup.
17
+ - fontlab-fly >=1.3.0: retained menu scripts and the native smoke example access
18
+ App and native Qt through Fly aliases. This is a source-installer consumer
19
+ requirement; the library-only wheel keeps its direct App dependency.
20
+ - Source installation explicitly requests `pyobjc-framework-Quartz>=10;
21
+ sys_platform == 'darwin'` for the macOS F5/F6 hotkey script. App retains its
22
+ optional `hotkeys` extra; the linked installer metadata writes Requires-Dist
23
+ without optional dependency/Provides-Extra metadata, so the explicit override
24
+ is needed. The library-only wheel does not activate that script or require Quartz.
25
+ - With uv available, `install.vfpy` submits the complete declared requirement list
26
+ unchanged to the standard uv resolver, including versions, markers and extras.
27
+ Satisfactory dependencies are not forcibly upgraded or reinstalled. Empty lists
28
+ do not start a dependency-install process. Without uv, the retained fallback
29
+ checks presence only and reports missing dependencies; it does not validate
30
+ installed versions, markers or extras.
31
+ - Native PythonQt QtGui/QtSvg/Qt and FontLab: supplied by the host for capture.
32
+ - Standard pathlib, tempfile and ElementTree: existing file/SVG implementation.
33
+ - Optional `svg` extra: Pillow >=10 decodes PNGs into exact8-bit premultiplied RGBa pixel keys;
34
+ svgelements >=1.9.6 supplies maintained pure-Python SVG path/shape/transform
35
+ bounds, avoiding a custom geometry parser or NumPy/SciPy dependency. Both are
36
+ also test dependencies and are imported lazily only by postprocessing helpers.
37
+ - Optional `svg`/test extras also include cssselect2 >=0.8 and tinycss2 >=1.4:
38
+ maintained pure-Python selector matching and CSS parsing for paint specificity,
39
+ source order, importance and inheritance. Avoid a custom CSS parser and preserve
40
+ CSS-defined `none` during ordinary recoloring; capture does not import them.
41
+
42
+ ## Documentation build
43
+
44
+ A separate Python 3.13 docs environment uses the 31-package hash lock at `src_docs/requirements.txt`: ProperDocs 1.6.7, MkDocs 1.6.1, MaterialX 10.1.8 and PyMdown 11.0.1. Search is the sole plugin; light fltheme26 assets provide the shared menu/footer. Runtime dependencies and locks remain separate.