docs(docs): V1-2.2 final A6 perimeter, root visibility, open findings

This commit is contained in:
bchanot committed 2026-10-30 18:56:48 +01:00
1 parent d8562f60f5
commit a095ea0e1b
3 files changed
+92 -8

No files matched your search

+22 -6
View File
@@ -1322,7 +1322,7 @@ The page reads the file with the core SVG reader before anything is stored.
| Reader outcome | Treatment |
|---|---|
| Hard rejection (`too_large`, `doctype`, `malformed`, `not_svg`, `too_many_elements`, `too_deep`, `too_many_uses`, `too_complex`, `reference_cycle`, `dangling_reference`, `reserved_id`) | refused, with the reason in FR or EN; no cleaning offered |
| Hard rejection (`too_large`, `doctype`, `malformed`, `not_svg`, `too_many_elements`, `too_deep`, `too_many_uses`, `too_complex`, `reference_cycle`, `dangling_reference`, `reserved_id`, `root_visibility`) | refused, with the reason in FR or EN; no cleaning offered |
| Any removal of active or external content: `script`, `foreignObject`, event-handler attributes, `image`, animation elements, a reference that does not point inside the document (`href` or `url(…)` not starting with `#`), `@import` or `javascript:` values | refused (`svg_active_content`): such a file is hostile or incompatible; no cleaning offered |
| Any other removal (editor metadata and namespaces, `data-*` attributes, `<style>` elements, `class` or `style` on the root, ids outside the grammar, unsupported elements such as `symbol`, oversized `title` or `desc`) | cleaning offered: « Nettoyer et utiliser cette version », after the composed preview of the cleaned drawing and one confirmation; a removed `<style>` element is named, since the `class` attributes it styled then render unstyled |
| No removal | used, in the stored form (below) |
@@ -1381,6 +1381,13 @@ The page reads the file with the core SVG reader before anything is stored.
(`reserved_id`) for the same readers and for the PDF snapshot gate; both
composers refuse such a tree. Exact names only: the historical drawings keep
`osteo-overlays` (RUST.md §12.9).
- Root visibility (owner brief 2026-10-30): the marker layer is the root's last
child, so a root `visibility` other than `visible` (any letter case, CSS-wide
keywords and unreadable values included) is a hard rejection
(`root_visibility`) for the same readers and the PDF snapshot gate; a root
`style` or `class` and `<style>` elements are already removed, and `opacity`
or `display` on the root act on the drawing and the markers alike
(RUST.md §12.10).
- Colours (owner decision 2026-10-29): presentation attributes and `style`
keep the strict colour functions cairo writes, lowercase `rgb(` with three
and `rgba(` with four components, all bare numbers up to 255 or all
@@ -1419,8 +1426,8 @@ The page reads the file with the core SVG reader before anything is stored.
bytes do not hash to its key, writes an audit row, and lets the editor
upload again. It is the one Storage deletion of V1-2.
6. Closed codes shown to the editor: `size_mismatch`, `hash_mismatch`,
`svg_rejected` (with the reader's reason, `dangling_reference` and
`reserved_id` included),
`svg_rejected` (with the reader's reason, `dangling_reference`,
`reserved_id` and `root_visibility` included),
`svg_active_content`, `svg_not_canonical`, `too_large`, `upload_missing`,
`object_conflict`.
@@ -2382,14 +2389,14 @@ Asked before the code of V1-2.2, on the brief « Autorisation de démarrer V1-2.
| Item | Decision | Where |
|---|---|---|
| Vector-tool exports | The owner supplies the editors' exports (Inkscape, Illustrator, Figma, Affinity) under `crates/core/tests/fixtures/svg/exports/owner/`; the cairo and ImageMagick exports of the development machine are committed meanwhile, tool and version in the file name | §9.2, §15 |
| Vector-tool exports | The owner supplies the editors' exports (Inkscape, Illustrator, Figma, Affinity) under `crates/core/tests/fixtures/svg/exports/owner/` (scope amended in §17.6); the cairo and ImageMagick exports of the development machine are committed meanwhile, tool and version in the file name | §9.2, §15 |
| Strict-parse code | `verification.integrity.document` (and `.base` for the base), as §6.5 files it; the 19 rule errors are `verification.validation.rules` | §6.5, §6.7 |
| Draft load | caps excess and missing drawings reported for a draft, refused for a published or deprecated version | §10 |
| SVG references | a local reference to an id the drawing does not define is refused (`dangling_reference`); the composed canvas scopes every id and reference to its view (`fv.<view>.`), at composition only, stored bytes and fingerprints untouched; implemented in V1-2.2, not deferred to V1-2.6; the PDF halo's id `osteo-halo` is reserved (`reserved_id`, owner brief 2026-10-30) | §9.2, §10 |
| SVG serialisation | one stored form for every uploaded drawing (declaration + core serialisation), « clean = original bytes » withdrawn; verdict and preview refuse another form (`verification.integrity.svg_not_canonical`); no stored object rewritten, the equine object already in that form | §6.5, §6.7, §9.2, §9.3 |
| cairo colours | strict numeric `rgb()` / `rgba()` kept in presentation attributes and `style`; every other function, external `url(`, `expression(`, scripts and active CSS still removed or refused | §9.2 |
| Edit commands | strict command validation confirmed; `remove` refused atomically (`has_dependents`) while another element names the element; descendants of a finding go with it; no cascade in level 1 | §8.1 |
| Inkscape exports | the Ubuntu archive package of Inkscape 1.4.3 unpacked in the session scratch folder (no install) produces real exports, committed with their generator; Illustrator and Figma stay owner-supplied, A6 open until they arrive | §9.2, §15 |
| Inkscape exports | the Ubuntu archive package of Inkscape 1.4.3 unpacked in the session scratch folder (no install) produces real exports, committed with their generator; Illustrator and Figma stay owner-supplied (A6 scope final in §17.6) | §9.2, §15 |
| Module size | the shipped module drops wasm-bindgen's debug `name` section (`--remove-name-section`); the 600 000-byte cap and its test are kept | RUST.md §12 |
### 17.5 V1-2.2 finalisation (owner, 2026-10-30)
@@ -2398,11 +2405,20 @@ Brief « V1-2.2 : finalisation et intégration A6 Figma », after the final inde
| Item | Decision | Where |
|---|---|---|
| Editor exports required for A6 | Inkscape (covered, §17.4), Figma (required: the owner's two raw exports `owner/figma-web-20261030-{default,ids}.svg`) and Illustrator (required: the real Adobe Illustrator; VectorCraft or any look-alike is not equivalent). Affinity is optional. A6 stays open until the Illustrator exports are committed and pass | §9.2, §15 |
| Editor exports required for A6 | Inkscape (covered, §17.4), Figma (required: the owner's two raw exports `owner/figma-web-20261030-{default,ids}.svg`) and Illustrator (required: the real Adobe Illustrator; VectorCraft or any look-alike is not equivalent). Affinity is optional. Superseded by §17.6: Illustrator is optional too | §9.2, §15 |
| Mask and clip units | `maskUnits`, `maskContentUnits` and `clipPathUnits` kept with the keywords `userSpaceOnUse` and `objectBoundingBox` only, any other value removed: removing Figma's `maskUnits="userSpaceOnUse"` re-read the mask region in bounding-box units and cut the drawing's edge | §9.2 |
| Glued `url(` | a `url(` glued to a longer name (`xurl(#a)`) is removed from any attribute, not only from presentation attributes and `style`, so the reader, the cleaning, the verdict, the preview, the canvas and the PDF view accept the same drawings | §9.2, §10 |
| Document instances | the per-document prefix (§10) stays a requirement before any page draws two documents at once | §10 |
### 17.6 V1-2.2 final arbitration (owner, 2026-10-30)
Brief « V1-2.2 : arbitrage définitif A6 et correction visibility », on `81f7639`:
| Item | Decision | Where |
|---|---|---|
| A6 tested perimeter | Figma (two raw exports), Inkscape 1.4.3, cairo 1.18.4 and ImageMagick 7.1.2-18, all real exports read by the suite. Adobe Illustrator and Affinity are optional: never declared compatible or validated without a real export; their absence does not block V1-2.2. The `owner/` folder and its procedure stay for a later test | §9.2, §15 |
| Root visibility | a drawing whose root carries a `visibility` other than `visible` is a hard rejection (`root_visibility`): the marker layer, appended as the root's last child, inherits it while the drawing's children can set `visible` back. Refused by the reader before verification or publication, by the cleaning, the verdict, the preview, the canvas and the PDF snapshot gate; both composers refuse such a root | §9.2, §10 |
---
## 18. Documents touched by V1-2.0