From fe90dc1397902cc40a27bec341d6ecba9a09de56 Mon Sep 17 00:00:00 2001 From: Kayshen-X Date: Thu, 23 Jul 2026 21:52:23 +0800 Subject: [PATCH] docs(release): refine v0.8.2 notes and acknowledgements --- README.de.md | 15 ++--- README.es.md | 15 ++--- README.fr.md | 15 ++--- README.hi.md | 15 ++--- README.id.md | 15 ++--- README.ja.md | 15 ++--- README.ko.md | 15 ++--- README.md | 15 ++--- README.pt.md | 15 ++--- README.ru.md | 15 ++--- README.th.md | 15 ++--- README.tr.md | 15 ++--- README.vi.md | 15 ++--- README.zh-TW.md | 15 ++--- README.zh.md | 15 ++--- RELEASE_NOTES/v0.8.2.md | 145 +++++++++++++++++----------------------- 16 files changed, 167 insertions(+), 203 deletions(-) diff --git a/README.de.md b/README.de.md index 0a4985b0c..f08127048 100644 --- a/README.de.md +++ b/README.de.md @@ -445,15 +445,14 @@ Danke an **[MrQyun](https://github.com/mrqyun)** — soll dein Name auch hier st **Anerkannte Community: [LINUX DO](https://linux.do/)** -## Star History +## Geforkte Drittanbieterbibliotheken - - - - - Star History Chart - - +Wir danken den Upstream-Maintainern, auf deren Arbeit OpenPencil aufbaut. Diese Kopien werden ausschließlich für OpenPencil-spezifische Integrationsanforderungen gepflegt: + +- **[casement](https://github.com/ZSeven-W/casement)** — ein Fork von **[winit](https://github.com/rust-windowing/winit)**. +- **[anthropic-agent-sdk](./vendor/anthropic-agent-sdk)** — aus **[bartolli/anthropic-agent-sdk](https://github.com/bartolli/anthropic-agent-sdk)** übernommen und als lokaler Fork gepflegt. + +Für jedes Projekt gilt weiterhin die jeweilige Upstream-Lizenz. ## Bewertungen diff --git a/README.es.md b/README.es.md index ce411a3ad..c989f5b11 100644 --- a/README.es.md +++ b/README.es.md @@ -445,15 +445,14 @@ Gracias a **[MrQyun](https://github.com/mrqyun)** — ¿quieres ver tu nombre aq **Comunidad reconocida: [LINUX DO](https://linux.do/)** -## Star History +## Bibliotecas de terceros bifurcadas - - - - - Star History Chart - - +Agradecemos a los mantenedores de los proyectos originales en cuyo trabajo se basa OpenPencil. Estas copias se mantienen únicamente para cubrir necesidades de integración específicas de OpenPencil: + +- **[casement](https://github.com/ZSeven-W/casement)** — un fork de **[winit](https://github.com/rust-windowing/winit)**. +- **[anthropic-agent-sdk](./vendor/anthropic-agent-sdk)** — incorporada desde **[bartolli/anthropic-agent-sdk](https://github.com/bartolli/anthropic-agent-sdk)** y mantenida como un fork local. + +Cada proyecto sigue sujeto a su respectiva licencia original. ## Evaluaciones diff --git a/README.fr.md b/README.fr.md index c90c31465..f476333f7 100644 --- a/README.fr.md +++ b/README.fr.md @@ -445,15 +445,14 @@ Merci à **[MrQyun](https://github.com/mrqyun)** — vous voulez voir votre nom **Communauté reconnue : [LINUX DO](https://linux.do/)** -## Star History +## Bibliothèques tierces dérivées - - - - - Star History Chart - - +Nous remercions les mainteneurs des projets en amont sur lesquels repose OpenPencil. Ces copies ne sont maintenues que pour répondre aux besoins d’intégration propres à OpenPencil : + +- **[casement](https://github.com/ZSeven-W/casement)** — un fork de **[winit](https://github.com/rust-windowing/winit)**. +- **[anthropic-agent-sdk](./vendor/anthropic-agent-sdk)** — intégrée à partir de **[bartolli/anthropic-agent-sdk](https://github.com/bartolli/anthropic-agent-sdk)** et maintenue comme fork local. + +Chaque projet reste soumis à sa licence en amont respective. ## Évaluations diff --git a/README.hi.md b/README.hi.md index 050bf2492..6541d4b53 100644 --- a/README.hi.md +++ b/README.hi.md @@ -445,15 +445,14 @@ OpenPencil मुफ़्त और ओपन-सोर्स है। इस **मान्यता प्राप्त समुदाय: [LINUX DO](https://linux.do/)** -## Star History +## फ़ोर्क की गई तृतीय-पक्ष लाइब्रेरी - - - - - Star History Chart - - +जिन अपस्ट्रीम मेंटेनरों के काम पर OpenPencil आधारित है, हम उनके आभारी हैं। ये प्रतियाँ केवल OpenPencil की विशिष्ट इंटीग्रेशन आवश्यकताओं के लिए मेंटेन की जाती हैं: + +- **[casement](https://github.com/ZSeven-W/casement)** — **[winit](https://github.com/rust-windowing/winit)** से फ़ोर्क। +- **[anthropic-agent-sdk](./vendor/anthropic-agent-sdk)** — **[bartolli/anthropic-agent-sdk](https://github.com/bartolli/anthropic-agent-sdk)** से वेंडर की गई और लोकल फ़ोर्क के रूप में मेंटेन की गई। + +हर प्रोजेक्ट पर उसका संबंधित अपस्ट्रीम लाइसेंस लागू रहता है। ## मूल्यांकन diff --git a/README.id.md b/README.id.md index f07a3b067..0ae3c415d 100644 --- a/README.id.md +++ b/README.id.md @@ -445,15 +445,14 @@ Terima kasih kepada **[MrQyun](https://github.com/mrqyun)** — ingin nama Anda **Komunitas yang diakui: [LINUX DO](https://linux.do/)** -## Star History +## Library pihak ketiga hasil fork - - - - - Star History Chart - - +Kami berterima kasih kepada para pengelola upstream yang karyanya menjadi fondasi OpenPencil. Salinan ini dipelihara hanya untuk kebutuhan integrasi khusus OpenPencil: + +- **[casement](https://github.com/ZSeven-W/casement)** — fork dari **[winit](https://github.com/rust-windowing/winit)**. +- **[anthropic-agent-sdk](./vendor/anthropic-agent-sdk)** — di-vendor dari **[bartolli/anthropic-agent-sdk](https://github.com/bartolli/anthropic-agent-sdk)** dan dipelihara sebagai fork lokal. + +Setiap proyek tetap tunduk pada lisensi upstream masing-masing. ## Penilaian diff --git a/README.ja.md b/README.ja.md index c54b0a994..36b080782 100644 --- a/README.ja.md +++ b/README.ja.md @@ -445,15 +445,14 @@ OpenPencil は無料でオープンソースです。開発は、これを便利 **認定コミュニティ：[LINUX DO](https://linux.do/)** -## Star History +## フォークしているサードパーティライブラリ - - - - - Star History Chart - - +OpenPencil の基盤となる成果を提供してくださったアップストリームのメンテナーに感謝します。以下のコピーは、OpenPencil 固有の統合要件に対応するためだけに保守しています。 + +- **[casement](https://github.com/ZSeven-W/casement)** — **[winit](https://github.com/rust-windowing/winit)** からのフォーク。 +- **[anthropic-agent-sdk](./vendor/anthropic-agent-sdk)** — **[bartolli/anthropic-agent-sdk](https://github.com/bartolli/anthropic-agent-sdk)** をベンダリングし、ローカルフォークとして保守。 + +各プロジェクトには、それぞれのアップストリームライセンスが引き続き適用されます。 ## セキュリティ評価 diff --git a/README.ko.md b/README.ko.md index 393e74bb1..d364e2f46 100644 --- a/README.ko.md +++ b/README.ko.md @@ -445,15 +445,14 @@ OpenPencil은 무료이며 오픈소스입니다. 개발은 이 도구를 유용 **인정 커뮤니티: [LINUX DO](https://linux.do/)** -## Star History +## 포크한 서드파티 라이브러리 - - - - - Star History Chart - - +OpenPencil의 기반이 되는 작업을 제공한 업스트림 관리자분들께 감사드립니다. 아래 사본은 OpenPencil 전용 통합 요구 사항을 위해서만 유지 관리합니다: + +- **[casement](https://github.com/ZSeven-W/casement)** — **[winit](https://github.com/rust-windowing/winit)**에서 포크. +- **[anthropic-agent-sdk](./vendor/anthropic-agent-sdk)** — **[bartolli/anthropic-agent-sdk](https://github.com/bartolli/anthropic-agent-sdk)**에서 벤더링하여 로컬 포크로 유지 관리. + +각 프로젝트에는 해당 업스트림 라이선스가 계속 적용됩니다. ## 보안 평가 diff --git a/README.md b/README.md index e277a3065..5b82b5246 100644 --- a/README.md +++ b/README.md @@ -613,15 +613,14 @@ Thanks to **[MrQyun](https://github.com/mrqyun)** — want your name here too? * **Recognized community: [LINUX DO](https://linux.do/)** -## Star History +## Forked Third-Party Libraries - - - - - Star History Chart - - +We are grateful to the upstream maintainers whose work OpenPencil builds on. These copies are maintained only for OpenPencil-specific integration needs: + +- **[casement](https://github.com/ZSeven-W/casement)** — forked from **[winit](https://github.com/rust-windowing/winit)**. +- **[anthropic-agent-sdk](./vendor/anthropic-agent-sdk)** — vendored from **[bartolli/anthropic-agent-sdk](https://github.com/bartolli/anthropic-agent-sdk)** and maintained as a local fork. + +Each project remains subject to its respective upstream license. ## Assessments diff --git a/README.pt.md b/README.pt.md index f4e2fb368..2984cc2e7 100644 --- a/README.pt.md +++ b/README.pt.md @@ -445,15 +445,14 @@ Obrigado a **[MrQyun](https://github.com/mrqyun)** — quer ver seu nome aqui? * **Comunidade reconhecida: [LINUX DO](https://linux.do/)** -## Star History +## Forks de bibliotecas de terceiros - - - - - Star History Chart - - +Agradecemos aos mantenedores upstream cujo trabalho serve de base para o OpenPencil. Estas cópias são mantidas apenas para necessidades de integração específicas do OpenPencil: + +- **[casement](https://github.com/ZSeven-W/casement)** — fork de **[winit](https://github.com/rust-windowing/winit)**. +- **[anthropic-agent-sdk](./vendor/anthropic-agent-sdk)** — incorporada a partir de **[bartolli/anthropic-agent-sdk](https://github.com/bartolli/anthropic-agent-sdk)** e mantida como fork local. + +Cada projeto continua sujeito à respectiva licença upstream. ## Avaliações diff --git a/README.ru.md b/README.ru.md index 8787df2fe..cce8b082f 100644 --- a/README.ru.md +++ b/README.ru.md @@ -445,15 +445,14 @@ OpenPencil бесплатен и open source. Разработка финанс **Признанное сообщество: [LINUX DO](https://linux.do/)** -## Star History +## Форки сторонних библиотек - - - - - Star History Chart - - +Мы благодарим сопровождающих upstream-проектов, на чьих разработках основан OpenPencil. Эти копии поддерживаются только для специфических потребностей интеграции OpenPencil: + +- **[casement](https://github.com/ZSeven-W/casement)** — форк **[winit](https://github.com/rust-windowing/winit)**. +- **[anthropic-agent-sdk](./vendor/anthropic-agent-sdk)** — включена в репозиторий из **[bartolli/anthropic-agent-sdk](https://github.com/bartolli/anthropic-agent-sdk)** и поддерживается как локальный форк. + +К каждому проекту по-прежнему применяются условия его исходной лицензии. ## Оценки diff --git a/README.th.md b/README.th.md index 1823bdc7f..04692e0e8 100644 --- a/README.th.md +++ b/README.th.md @@ -445,15 +445,14 @@ OpenPencil เป็นซอฟต์แวร์ฟรีและโอเพ **ชุมชนที่ได้รับการยอมรับ: [LINUX DO](https://linux.do/)** -## Star History +## ไลบรารีจากบุคคลที่สามที่เรา fork - - - - - Star History Chart - - +ขอขอบคุณผู้ดูแลโครงการต้นทางซึ่งผลงานของพวกเขาเป็นรากฐานของ OpenPencil สำเนาเหล่านี้ได้รับการดูแลเฉพาะเพื่อรองรับความต้องการด้านการผสานรวมของ OpenPencil เท่านั้น: + +- **[casement](https://github.com/ZSeven-W/casement)** — fork มาจาก **[winit](https://github.com/rust-windowing/winit)** +- **[anthropic-agent-sdk](./vendor/anthropic-agent-sdk)** — นำโค้ดมาจาก **[bartolli/anthropic-agent-sdk](https://github.com/bartolli/anthropic-agent-sdk)** และดูแลในรูปแบบ local fork + +แต่ละโครงการยังคงอยู่ภายใต้สัญญาอนุญาตของโครงการต้นทาง ## การประเมิน diff --git a/README.tr.md b/README.tr.md index e44b511fd..4dee4e559 100644 --- a/README.tr.md +++ b/README.tr.md @@ -445,15 +445,14 @@ OpenPencil ücretsiz ve açık kaynaklıdır. Geliştirme, onu faydalı bulanlar **Tanınan topluluk: [LINUX DO](https://linux.do/)** -## Star History +## Forklanan üçüncü taraf kütüphaneleri - - - - - Star History Chart - - +OpenPencil'in temelini oluşturan çalışmaları sunan upstream bakımcılarına teşekkür ederiz. Bu kopyalar yalnızca OpenPencil'e özgü entegrasyon gereksinimleri için korunmaktadır: + +- **[casement](https://github.com/ZSeven-W/casement)** — **[winit](https://github.com/rust-windowing/winit)** fork'u. +- **[anthropic-agent-sdk](./vendor/anthropic-agent-sdk)** — **[bartolli/anthropic-agent-sdk](https://github.com/bartolli/anthropic-agent-sdk)** kaynağından depoya alınmış ve yerel bir fork olarak korunmaktadır. + +Her proje, kendi upstream lisansının koşullarına tabi olmaya devam eder. ## Değerlendirmeler diff --git a/README.vi.md b/README.vi.md index e63799b8d..11635ab1c 100644 --- a/README.vi.md +++ b/README.vi.md @@ -445,15 +445,14 @@ Cảm ơn **[MrQyun](https://github.com/mrqyun)** — muốn tên mình xuất h **Cộng đồng được công nhận: [LINUX DO](https://linux.do/)** -## Star History +## Các thư viện bên thứ ba được fork - - - - - Star History Chart - - +Chúng tôi cảm ơn các nhà bảo trì upstream có công việc làm nền tảng cho OpenPencil. Các bản sao này chỉ được duy trì để đáp ứng nhu cầu tích hợp riêng của OpenPencil: + +- **[casement](https://github.com/ZSeven-W/casement)** — được fork từ **[winit](https://github.com/rust-windowing/winit)**. +- **[anthropic-agent-sdk](./vendor/anthropic-agent-sdk)** — được vendor từ **[bartolli/anthropic-agent-sdk](https://github.com/bartolli/anthropic-agent-sdk)** và duy trì dưới dạng fork cục bộ. + +Mỗi dự án vẫn tuân theo giấy phép upstream tương ứng. ## Đánh giá diff --git a/README.zh-TW.md b/README.zh-TW.md index d3c1bec0b..9574dbcf7 100644 --- a/README.zh-TW.md +++ b/README.zh-TW.md @@ -445,15 +445,14 @@ OpenPencil 免費且開源,開發完全由覺得它好用的人們贊助 —— **認可社群：[LINUX DO](https://linux.do/)** -## Star History +## 第三方 Fork 與致謝 - - - - - Star History Chart - - +感謝上游維護者的工作，OpenPencil 得以在此基礎上建構。以下副本僅為滿足 OpenPencil 特定的整合需求而維護： + +- **[casement](https://github.com/ZSeven-W/casement)** — fork 自 **[winit](https://github.com/rust-windowing/winit)**。 +- **[anthropic-agent-sdk](./vendor/anthropic-agent-sdk)** — 自 **[bartolli/anthropic-agent-sdk](https://github.com/bartolli/anthropic-agent-sdk)** 引入存放庫，並作為本地 fork 維護。 + +各專案仍適用其各自的上游授權條款。 ## 安全評估 diff --git a/README.zh.md b/README.zh.md index eb8e8e8f3..33b502806 100644 --- a/README.zh.md +++ b/README.zh.md @@ -449,15 +449,14 @@ OpenPencil 免费开源,开发完全由觉得它好用的人们资助 —— 感 **认可社区：[LINUX DO](https://linux.do/)** -## Star History +## 第三方 Fork 与致谢 - - - - - Star History Chart - - +感谢上游维护者的工作，OpenPencil 得以在此基础上构建。以下副本仅为满足 OpenPencil 特定的集成需求而维护： + +- **[casement](https://github.com/ZSeven-W/casement)** — fork 自 **[winit](https://github.com/rust-windowing/winit)**。 +- **[anthropic-agent-sdk](./vendor/anthropic-agent-sdk)** — 从 **[bartolli/anthropic-agent-sdk](https://github.com/bartolli/anthropic-agent-sdk)** 引入仓库，并作为本地 fork 维护。 + +各项目仍适用其各自的上游许可证。 ## 安全评估 diff --git a/RELEASE_NOTES/v0.8.2.md b/RELEASE_NOTES/v0.8.2.md index 234f2cee7..aa5a5e970 100644 --- a/RELEASE_NOTES/v0.8.2.md +++ b/RELEASE_NOTES/v0.8.2.md @@ -1,95 +1,74 @@ # OpenPencil v0.8.2 -`v0.8.2` is a pre-release update focused on import fidelity, large-document -performance, safer persistence, and backward-compatible OpenPencil files. +`v0.8.2` is a prerelease focused on higher-fidelity imports, lower transient +memory use, smoother large-document workflows, and safer `.op` persistence. ## Highlights -- Figma imports preserve substantially more authored structure and appearance, - including component instances and swaps, masks, blend modes, page - backgrounds, image tiling, vectors, text, child order, and absolute layout. -- Import preparation, image resolution, text measurement, and component lookup - reuse cached work, while cancellation and background conversion keep the - desktop UI responsive. -- Imported desktop files can be written as adjacent `.op` documents. Existing - targets require confirmation; choosing not to replace creates a numbered - copy. -- Large `.op` files use memory-mapped input and a fast Preserve-mode loader. - Only the active page scene is built for editing, and the previous page scene - is released when switching pages. -- Page switches automatically fit and center the newly active page. -- Save and Save As run through serialized background jobs. Clean bound - documents can stream their source bytes while rewriting only editor - metadata, avoiding a full document clone. -- Legacy `.op` files are detected after compatibility repair and can be - rewritten in the current format, saved as a numbered copy, or opened without - conversion. -- HTML import accepts complete pages, multi-file projects, and ZIP packages +- Figma imports more closely preserve component instances and swaps, masks, + blend modes, page backgrounds, tiled images, vectors, text, child order, and + absolute positioning. +- Desktop Figma conversion runs outside the UI thread and writes a sibling + `.op` file. An existing target is never silently overwritten: replace it, + keep both with a numbered copy, or cancel the import. +- Large documents use a focused active-page render scene. Switching pages + releases the previous scene, then fits and centers the newly active page. +- Desktop Save and Save As run as serialized background jobs, reducing UI + stalls and avoiding unnecessary full-document clones for clean files. +- Older `.op` files open through the compatibility loader and can be upgraded + in place, saved as a numbered copy, or opened without conversion. +- HTML import now accepts complete pages, multi-file projects, and ZIP packages with local CSS, images, nested imports, and common text encodings. -## Figma Fidelity +## Figma and Editing Fidelity -- Component properties and instance overrides retain component backing data, - swap targets, authored geometry, and style references. -- Alpha, vector, and luminance masks render through the shared native and web - paint paths. -- Layer and fill blend modes, image tile scale, and page background color are - represented in the schema and editable in the property inspector. -- Boolean fallbacks, vector bounds, image fills, text metrics, layout - positioning, and paint ordering more closely match the source Figma file. -- The generated TypeScript schema bindings and web SDK types remain compatible - with older optional fields. +- Component properties, instance overrides, swap targets, authored geometry, + and style references survive conversion more reliably. +- Alpha, vector, and luminance masks, layer and fill blend modes, image tile + scale, and page background color render on native and web surfaces and are + configurable in the property inspector. +- Boolean geometry, vector bounds, image fills, text measurement, layout + positioning, and paint order more closely match the source design. -## Persistence and Compatibility +## Performance and Reliability + +- Figma conversion reuses prepared values, text measurements, image lookups, + and component data instead of recomputing them for every node. +- Desktop `.op` loading uses memory-mapped input and a fast path for safe + Preserve-mode documents. +- Web Figma conversion runs in a short-lived worker with IndexedDB staging, so + conversion memory can be released before the document is installed in the + editor. +- Native publication is atomic, web saves are queued and coalesced, and an + externally changed target is preserved by falling back to a numbered copy. +- Windows desktop startup recovers when the preferred native OpenGL path is + unavailable. + +## Compatibility - The current `.op` format marker is `1.2`. -- Existing current-format documents do not trigger migration solely because - optional editor metadata is absent. -- Legacy conversion preserves unknown top-level and nested fields, handles - deeply nested documents with stack protection, and writes through an atomic - sibling temporary file. -- Before replacing an original document, OpenPencil verifies that the source - has not changed since it was opened. A concurrent external change falls back - to a numbered copy. -- Failed migration or save publication does not bind stale in-memory state to - the target path. - -## Performance - -- Figma preparation caches decoded values, text measurements, image lookups, - instance assignments, and component style references. -- Desktop document loading maps the source file instead of first copying the - entire file into a second byte buffer. -- Preserve-authored documents can skip the generic full JSON compatibility DOM - when the fast loader proves the current shape is safe. -- Scene construction is active-page scoped across desktop, web, MCP, image - search, and export consumers. -- Large import and save payloads use indirection or streaming paths to reduce - queue size and peak allocations. - -## Web and SDK - -- Web Figma conversion stages output through a worker-backed temporary writer - instead of retaining every generated byte in the main UI task. -- Web save requests are queued and coalesced so an older serialization cannot - publish after a newer edit. -- Page fitting, compositing properties, masks, image tiling, and editor metadata - round-trip through the web host. -- `@zseven-w/op-web-sdk`, `@zseven-w/op-web-sdk-react`, and - `@zseven-w/op-web-sdk-vue` are synchronized at `0.8.2`. - -## Release Artifacts - -- Native desktop installers and standalone `op` CLI archives for macOS, - Windows, and Linux. -- `ghcr.io/zseven-w/openpencil-web:v0.8.2` for the Rust web host. -- Web SDK packages under the npm `next` tag, with package tarballs attached to - the GitHub prerelease. - -## Compatibility Notes - -- The public web SDK remains a read-only viewer surface. -- Active-page scene loading reduces renderer memory, but the canonical document - still retains all page data while open. +- Legacy upgrades preserve unknown top-level and nested fields; new optional + schema fields and generated TypeScript bindings remain backward compatible. +- A current-format document does not trigger migration merely because optional + editor metadata is absent. +- Active-page rendering reduces renderer memory, but the canonical document + still retains all page data while it is open. - Future incompatible format majors are rejected instead of being rewritten. -- The retired TypeScript application workspace is not part of this release. +- OpenPencil account sign-in is temporarily hidden in this prerelease and is + planned to return in a later version. +- The public web SDK remains a read-only viewer surface, and the retired + TypeScript application workspace is not part of this release. + +## Web SDK and Distribution + +- `@zseven-w/op-web-sdk`, `@zseven-w/op-web-sdk-react`, and + `@zseven-w/op-web-sdk-vue` are synchronized at `0.8.2` and published under + the npm `next` tag. +- Desktop installers and standalone `op` CLI archives are built for macOS, + Windows, and Linux. +- Platform-specific VS Code extension packages are attached to the prerelease + and published through Open VSX. +- The Rust web host is published as + `ghcr.io/zseven-w/openpencil-web:v0.8.2`. +- Homebrew and Scoop manifests are updated after the GitHub prerelease is + published.