Add Paper Figure Studio and OpticalSetup bridge ports

[bertona88]

Summary

Adds the greenfield PicSetup successor under app/ while leaving the immutable prototype/ production snapshot unchanged.

• adds Paper Figure Studio with a hybrid paper template, editable labels/arrows/annotations, image and plot panels, and content-cropped SVG/high-resolution PNG export;
• adds typed optical, electrical, rf, control, and annotation connections while admitting only optical links to the coherent scattering solve;
• adds edge couplers, OpticalSetup bridge boundaries, a spiral delay line, four-channel AWG, thermo-optic heater control, and publication/system blocks;
• adds the versioned setup-port/1 OpticalSetup sender, bridge manifest export, and a framework-neutral receiver adapter;
• adds the photonics model, interface, claims/validation, and acceptance contracts required by the repository;
• adds pull-request validation for syntax, regression tests, and standalone packaging;
• updates GitHub Pages to publish the static runtime under app/ instead of the preserved prototype snapshot.

Model and integration boundary

PicSetup owns the scalar guided-mode network. OpticalSetup continues to own free-space geometry, beam waist, numerical aperture, wavefront, laboratory coordinates, and receiver-side scene creation.

The bridge is a deterministic, inspectable document handoff. It is not live synchronization or a distributed multi-physics solve. The included receiver adapter is a focused integration proposal; it has not been deployed to LucaGenchi/optics-sketch.

Semantic JSON preserves the complete hybrid figure graph. SAX and gdsfactory scaffolds deliberately contain only physical optical topology.

Validation

• npm run app:check — passed
• npm run app:test — 19 passed, 0 failed
• npm run app:build — passed; generated output remains ignored
• npm run prototype:test — 14 passed, 0 failed
• npm run prototype:check — passed
• git diff --check — passed
• prototype/ tree — preserved

Deployment authorization

On 2026-07-28, the repository owner explicitly authorized merging this PR and replacing the GitHub Pages publication artifact with the greenfield PicSetup app under app/. The source snapshot under prototype/ remains preserved in the repository for provenance and rollback.

Reviewer focus

• Does setup-port/1 expose the correct power references, units, omissions, and ownership boundary?
• Are any diagram-only or non-optical objects able to leak into the coherent solver?
• Are the publication exports and hybrid template appropriately separated from quantitative simulation claims?