Skip to content

docs: bring NOTICE, the font docs and the test ledger up to today - #232

Merged
chaxus merged 1 commit into
mainfrom
docs/notice-and-fonts-refresh
Sep 12, 2026
Merged

chaxus merged 1 commit into
mainfrom
docs/notice-and-fonts-refresh

Conversation

@chaxus

@chaxus chaxus commented Sep 12, 2026

Copy link
Copy Markdown
Member

NOTICE is a licence document — AGPL §5(a) asks for the modifications this project makes to the vendor tree — and today's work changed several of them while the file still described yesterday's.

NOTICE

was now
x2t_helper.js loads through instantiateWasm from a gzip response streams straight off the response, and runs in a worker as well as the frame
x2t.worker.js — new, and ours
x2t.wasm published gzip-compressed published brotli-compressed
fonts_thumbnail* not mentioned extended 193 → 202 tiles (#218)
AllFonts.js "the catalog registry is unchanged in shape" listed as edited: rows re-pointed at substitute faces, nine families added

That last line mattered: "unchanged in shape" was not an accurate description of a registry where 60 of 202 rows now name a font no file carries.

Also corrected: "Nothing else in public/sdkjs/ or public/web-apps/ is edited" — which stopped being true the moment we touched common/Images/.

docs/fonts.md + docs/fonts.zh.md

  • "Adding a family needs three things" → four. The fourth is a tile in every sprite, and missing it does not degrade — it stops the editor.
  • A section on the sprites: the on-disk format (12-byte big-endian header, then an alpha mask where 0 introduces a transparent run — nothing else documents this), the commands, and why allfontsgen cannot be used here: it derives families from the files' own name tables, and 60 of our 202 rows are aliases (Arial, Calibri, Microsoft YaHei, 楷体…) that no file carries, so it would drop every one and with them every document asking for a proprietary font by name.
  • The "Adding a font" checklist gains the node bin/font-thumbnails.mjs step.

docs/test-matrix.md

  • The vendor-contract sentinel cell was ⬜ and is now covered — vendor-contract, offline-seam, plugin-availability, vendor-bad-image-url, and the sprite invariants.
  • Two rows added to the escape table (the one that exists to record what the matrix missed): 选择字体滑到最底会报错导致无法继续编辑 #218, and the blank editor after a Service Worker swap.

🤖 Generated with Claude Code

https://claude.ai/code/session_01MKNHFQ1kek1cHeqhbH37Pk

NOTICE is a licence document, and AGPL 5(a) asks for the modifications
this project makes to the vendor tree. Today's work changed several of
them and the file still described yesterday's:

  * x2t_helper.js now streams the module straight off the response rather
    than out of a gzip, and runs in a worker as well as in the frame
  * x2t.worker.js is new, and is ours
  * x2t.wasm ships brotli-compressed, not gzip
  * the font picker's thumbnail sprites gained nine tiles
  * AllFonts.js itself is edited -- the licensing sweep re-pointed rows at
    substitute faces and added nine families, which "the catalog registry
    is unchanged in shape" did not say

docs/fonts.md and its Chinese twin gain the fourth thing a new family
needs, and a section on the sprites: the format (nothing else documents
it), why allfontsgen cannot be used here (60 of 202 rows are aliases no
font file carries, and it would drop every one), and the commands.

docs/test-matrix.md marks the vendor-contract sentinel covered, and
records two escapes -- #218 and the blank editor after a worker swap --
in the table that exists to track what the matrix missed.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MKNHFQ1kek1cHeqhbH37Pk
@chaxus
chaxus enabled auto-merge (rebase) September 12, 2026 12:41
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying document with  Cloudflare Pages  Cloudflare Pages

Latest commit: 37066cc
Status: ✅  Deploy successful!
Preview URL: https://87432c12.document-7hm.pages.dev
Branch Preview URL: https://docs-notice-and-fonts-refres.document-7hm.pages.dev

View logs

@chaxus
chaxus merged commit 9db85d7 into main Sep 12, 2026
18 checks passed
@chaxus
chaxus deleted the docs/notice-and-fonts-refresh branch September 12, 2026 12:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant