feat(stdlib): Tiled P0 — XML reader + base64 decode + gzip framing (#67)
All checks were successful
bootstrap / cfree-fixpoint (push) Successful in 20s
ci / build-and-test (push) Successful in 1m43s
commit-lint / conventional-commits (push) Successful in 2s
docs / build-and-deploy (push) Successful in 27s

The three parsing primitives the TMX path needs that were not already in
the tree (zlib inflate + the JSON reader already shipped):

- Xml.* — a minimal, deterministic pure-Ludic XML reader for the
  element/attribute/CDATA subset TMX/TSX/TX use, spliced on demand. Handles
  nested elements, single/double-quoted attributes, text + <![CDATA[…]]>,
  comments, the <?xml?> prolog and <!DOCTYPE>, the five predefined entities
  and numeric character references.
- Base64.* — standard base64 (RFC 4648) decode + a matching pure-Ludic
  encoder; the decoder ignores the whitespace Tiled wraps into <data>.
  Splicing Base64.* also pulls in inflate.ludic so a plain tool can run the
  full base64 -> zlib/gzip decode chain.
- z_gunzip — gzip framing (RFC 1952) over the existing DEFLATE inflater:
  skip the 10-byte header + optional fields, inflate the body, ignore the
  CRC32/ISIZE trailer.

Golden corpus vendored under assets/tiled-fixtures/ (mapeditor/tiled
examples, attributed, + hand-authored multi-encoding fixtures). New
example library/tiled_p0.ludic proves all three (21 assertions); docs
pages + inventory added so check-impl stays green.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Orkun ÇAKILKAYA 2026-09-01 14:04:49 +03:00
parent 0b149a6876
commit 79776d1f6a
35 changed files with 20549 additions and 18415 deletions

View file

@ -0,0 +1,7 @@
---
id: base64
title: Base64
order: 41
---
Standard base64 (RFC 4648) — <a href="base64-decode"><code>Base64.decode</code></a> reads base64 text into the bytes it stands for, and <a href="base64-encode"><code>Base64.encode</code></a> is the inverse. The decoder ignores ASCII whitespace, so it reads the newline-wrapped base64 that Tiled writes inside a <code>&lt;data&gt;</code> element; that output then feeds the DEFLATE inflater for zlib/gzip-compressed layer data. Deterministic; spliced on demand when a program mentions <code>Base64.*</code>. (The security-sensitive encoder <a href="crypto-base64"><code>Crypto.base64</code></a> is a separate, hardened path.)

View file

@ -0,0 +1,14 @@
---
id: base64-decode
name: Base64.decode
category: base64
kind: namespace-method
tokens: Base64.decode
sig: Base64.decode(src: string) -> string
tip: Decode standard base64 text to bytes.
order: 1
ns: Base64
member: decode
---
Decodes base64 <code>src</code> to the bytes it represents, returned as a NUL-terminated string. ASCII whitespace is ignored and <code>=</code> padding ends the stream. For binary payloads that may contain a NUL byte, decode into a sized buffer at the runtime level and track the returned length instead.

View file

@ -0,0 +1,14 @@
---
id: base64-encode
name: Base64.encode
category: base64
kind: namespace-method
tokens: Base64.encode
sig: Base64.encode(src: string) -> string
tip: Encode bytes as standard base64 text.
order: 2
ns: Base64
member: encode
---
Encodes the bytes of <code>src</code> as standard base64 with <code>=</code> padding — the inverse of <a href="base64-decode"><code>Base64.decode</code></a>.