Skip to content

docs(reference): document TISH_PACKED_ARRAYS flag (sound, default-off perf wash) - #1

Open
spacedevin wants to merge 1 commit into
mainfrom
docs/packed-arrays-flag
Open

docs(reference): document TISH_PACKED_ARRAYS flag (sound, default-off perf wash)#1
spacedevin wants to merge 1 commit into
mainfrom
docs/packed-arrays-flag

Conversation

@spacedevin

Copy link
Copy Markdown
Member

Adds a Value-representation flags subsection to the Native Backend reference documenting TISH_PACKED_ARRAYS: unboxed Vec<f64> numeric arrays across all backends (interp/vm/native) with in-place deopt (Packed → Boxed) on non-numeric stores so aliases stay sound; sound (full parity sweep flag-on vs flag-off across backends + GAUNTLET checksums vs Node); kept off by default on purpose because it is a performance wash — the VM JIT does not consume NumberArray, so packed never reaches the tier that speeds numeric loops (flag-on within ~1% of flag-off). Mirrors the authoritative docs/packed-arrays.md in the tish repo (tishlang/tish#521, following #520). Docs-only.

… perf wash)

Add a "Value-representation flags" subsection to the Native Backend reference
documenting TISH_PACKED_ARRAYS: unboxed Vec<f64> arrays across all backends with
in-place deopt on non-numeric stores, sound (full parity sweep + GAUNTLET
checksums vs Node), but kept off by default because it is a performance wash — the
VM JIT does not consume NumberArray, so packed never reaches the tier that speeds
numeric loops (flag-on within ~1% of flag-off).
@vercel

vercel Bot commented Jul 17, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
tishlang Ready Ready Preview, Comment, Open in v0 Jul 17, 2026 11:44pm

@codacy-production

Copy link
Copy Markdown

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

NEW Get contextual insights on your PRs based on Codacy's metrics, along with PR and Jira context, without leaving GitHub. Enable AI reviewer
TIP This summary will be updated as you push new changes.

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