[{"data":1,"prerenderedAt":433},["ShallowReactive",2],{"navigation_docs":3,"page:docs:\u002Fperformance\u002Fbenchmarks":247,"surround:docs:\u002Fperformance\u002Fbenchmarks":428},[4,27,49,95,117,131,149,171,189,211,225],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":26},"Getting Started","i-lucide-rocket","\u002Fgetting-started","01.getting-started",[10,14,18,22],{"title":11,"path":12,"stem":13},"Introduction","\u002Fgetting-started\u002Fintroduction","01.getting-started\u002F1.introduction",{"title":15,"path":16,"stem":17},"Installation","\u002Fgetting-started\u002Finstallation","01.getting-started\u002F2.installation",{"title":19,"path":20,"stem":21},"Quick Start","\u002Fgetting-started\u002Fquick-start","01.getting-started\u002F3.quick-start",{"title":23,"path":24,"stem":25},"Comparison","\u002Fgetting-started\u002Fcomparison","01.getting-started\u002F4.comparison",false,{"title":28,"icon":29,"path":30,"stem":31,"children":32,"page":26},"Core Concepts","i-lucide-layers","\u002Fcore-concepts","02.core-concepts",[33,37,41,45],{"title":34,"path":35,"stem":36},"Schema Modes","\u002Fcore-concepts\u002Fschema-modes","02.core-concepts\u002F1.schema-modes",{"title":38,"path":39,"stem":40},"Row Model","\u002Fcore-concepts\u002Frow-model","02.core-concepts\u002F2.row-model",{"title":42,"path":43,"stem":44},"Schema Context","\u002Fcore-concepts\u002Fschema-context","02.core-concepts\u002F3.schema-context",{"title":46,"path":47,"stem":48},"Execution Model","\u002Fcore-concepts\u002Fexecution-model","02.core-concepts\u002F4.execution-model",{"title":50,"icon":51,"path":52,"stem":53,"children":54,"page":26},"Columns","i-lucide-table-2","\u002Fcolumns","03.columns",[55,59,63,67,71,75,79,83,87,91],{"title":56,"path":57,"stem":58},"Defining Columns","\u002Fcolumns\u002Fdefining-columns","03.columns\u002F01.defining-columns",{"title":60,"path":61,"stem":62},"Column Groups","\u002Fcolumns\u002Fcolumn-groups","03.columns\u002F02.column-groups",{"title":64,"path":65,"stem":66},"Dynamic Columns","\u002Fcolumns\u002Fdynamic-columns","03.columns\u002F03.dynamic-columns",{"title":68,"path":69,"stem":70},"Column Selection","\u002Fcolumns\u002Fcolumn-selection","03.columns\u002F04.column-selection",{"title":72,"path":73,"stem":74},"Summary Rows","\u002Fcolumns\u002Fsummary-rows","03.columns\u002F05.summary-rows",{"title":76,"path":77,"stem":78},"Data Validation","\u002Fcolumns\u002Fdata-validation","03.columns\u002F06.data-validation",{"title":80,"path":81,"stem":82},"Hyperlinks","\u002Fcolumns\u002Fhyperlinks","03.columns\u002F07.hyperlinks",{"title":84,"path":85,"stem":86},"Sparklines","\u002Fcolumns\u002Fsparklines","03.columns\u002F08.sparklines",{"title":88,"path":89,"stem":90},"Images","\u002Fcolumns\u002Fimages","03.columns\u002F09.images",{"title":92,"path":93,"stem":94},"Badges and Checkboxes","\u002Fcolumns\u002Fbadges-and-checkboxes","03.columns\u002F10.badges-and-checkboxes",{"title":96,"icon":97,"path":98,"stem":99,"children":100,"page":26},"Styling","i-lucide-palette","\u002Fstyling","04.styling",[101,105,109,113],{"title":102,"path":103,"stem":104},"Themes","\u002Fstyling\u002Fthemes","04.styling\u002F1.themes",{"title":106,"path":107,"stem":108},"Cell Styles","\u002Fstyling\u002Fcell-styles","04.styling\u002F2.cell-styles",{"title":110,"path":111,"stem":112},"Dynamic Styles","\u002Fstyling\u002Fdynamic-styles","04.styling\u002F3.dynamic-styles",{"title":114,"path":115,"stem":116},"Conditional Styles","\u002Fstyling\u002Fconditional-styles","04.styling\u002F4.conditional-styles",{"title":118,"icon":119,"path":120,"stem":121,"children":122,"page":26},"Formulas","i-lucide-function-square","\u002Fformulas","05.formulas",[123,127],{"title":124,"path":125,"stem":126},"Formula Columns","\u002Fformulas\u002Fformula-columns","05.formulas\u002F1.formula-columns",{"title":128,"path":129,"stem":130},"Scope & References","\u002Fformulas\u002Fscope-and-references","05.formulas\u002F2.scope-and-references",{"title":132,"icon":133,"path":134,"stem":135,"children":136,"page":26},"Excel Tables","i-lucide-table","\u002Fexcel-tables","06.excel-tables",[137,141,145],{"title":138,"path":139,"stem":140},"Table Mode","\u002Fexcel-tables\u002Ftable-mode","06.excel-tables\u002F1.table-mode",{"title":142,"path":143,"stem":144},"Table Styles","\u002Fexcel-tables\u002Ftable-styles","06.excel-tables\u002F2.table-styles",{"title":146,"path":147,"stem":148},"Totals Row","\u002Fexcel-tables\u002Ftotals-row","06.excel-tables\u002F3.totals-row",{"title":150,"icon":151,"path":152,"stem":153,"children":154,"page":26},"Charts and Pivots","i-lucide-chart-column","\u002Fcharts","07.charts",[155,159,163,167],{"title":156,"path":157,"stem":158},"Charts","\u002Fcharts\u002Foverview","07.charts\u002F1.overview",{"title":160,"path":161,"stem":162},"Marks","\u002Fcharts\u002Fmarks","07.charts\u002F2.marks",{"title":164,"path":165,"stem":166},"Axes and Styling","\u002Fcharts\u002Faxes-and-styling","07.charts\u002F3.axes-and-styling",{"title":168,"path":169,"stem":170},"Pivot Tables","\u002Fcharts\u002Fpivot-tables","07.charts\u002F4.pivot-tables",{"title":172,"icon":173,"path":174,"stem":175,"children":176,"page":26},"Workbook","i-lucide-book-open","\u002Fworkbook","08.workbook",[177,181,185],{"title":178,"path":179,"stem":180},"Building Workbooks","\u002Fworkbook\u002Fbuilding-workbooks","08.workbook\u002F1.building-workbooks",{"title":182,"path":183,"stem":184},"Sheet Options","\u002Fworkbook\u002Fsheet-options","08.workbook\u002F2.sheet-options",{"title":186,"path":187,"stem":188},"Protection","\u002Fworkbook\u002Fprotection","08.workbook\u002F3.protection",{"title":190,"icon":191,"path":192,"stem":193,"children":194,"page":26},"Streaming","i-lucide-waves","\u002Fstreaming","09.streaming",[195,199,203,207],{"title":196,"path":197,"stem":198},"Streaming Intro","\u002Fstreaming\u002Fstreaming-intro","09.streaming\u002F1.streaming-intro",{"title":200,"path":201,"stem":202},"Output Targets","\u002Fstreaming\u002Foutput-targets","09.streaming\u002F2.output-targets",{"title":204,"path":205,"stem":206},"Memory Tuning","\u002Fstreaming\u002Fmemory-tuning","09.streaming\u002F3.memory-tuning",{"title":208,"path":209,"stem":210},"Stream Examples","\u002Fstreaming\u002Fstream-examples","09.streaming\u002F4.stream-examples",{"title":212,"icon":213,"path":214,"stem":215,"children":216,"page":26},"Performance","i-lucide-gauge","\u002Fperformance","10.performance",[217,221],{"title":218,"path":219,"stem":220},"Benchmarks","\u002Fperformance\u002Fbenchmarks","10.performance\u002F1.benchmarks",{"title":222,"path":223,"stem":224},"Large Exports","\u002Fperformance\u002Flarge-exports","10.performance\u002F2.large-exports",{"title":226,"icon":227,"path":228,"stem":229,"children":230,"page":26},"Migration","i-lucide-arrow-right-left","\u002Fmigration","12.migration",[231,235,239,243],{"title":232,"path":233,"stem":234},"v0 → v1","\u002Fmigration\u002Fv0-to-v1","12.migration\u002F1.v0-to-v1",{"title":236,"path":237,"stem":238},"v1 → v2","\u002Fmigration\u002Fv1-to-v2","12.migration\u002F2.v1-to-v2",{"title":240,"path":241,"stem":242},"v2 → typed-xlsx","\u002Fmigration\u002Fv2-to-typed-xlsx","12.migration\u002F3.v2-to-typed-xlsx",{"title":244,"path":245,"stem":246},"v4 → v5","\u002Fmigration\u002Fv4-to-v5","12.migration\u002F4.v4-to-v5",{"id":248,"title":218,"body":249,"description":420,"extension":421,"links":422,"meta":423,"navigation":424,"path":219,"seo":425,"stem":220,"__hash__":427},"docs\u002F10.performance\u002F1.benchmarks.md",{"type":250,"value":251,"toc":412},"minimark",[252,261,266,269,273,276,280,283,290,293,297,300,303,370,373,377,400],[253,254,255,256,260],"p",{},"These numbers come from the streaming benchmark in ",[257,258,259],"code",{},"packages\u002Fbenchmark",", run on 2026-09-22 against version 4.2.0 and the current engine with the same harness, schema and data. The charts read the published report directly.",[262,263,265],"h2",{"id":264},"export-time","Export time",[253,267,268],{},"Each workload writes an 11-column report with styles, dates, number formats and summary rows, committed in 5,000-row batches. Every notes cell contains XML-reserved characters and Unicode, so escaping is part of the measurement.",[270,271],"benchmark-chart",{"metric":272},"time",[253,274,275],{},"The current engine is 3.2× to 3.4× faster across the four workloads. The gain is in row processing and spooling: finalizing the ZIP still takes about one second at 200k rows and 2.4 seconds at 500k, as before.",[262,277,279],{"id":278},"peak-memory","Peak memory",[270,281],{"metric":282},"rss",[253,284,285,286,289],{},"With inline strings, peak memory barely moves between 200k and 500k rows (274 and 279 MiB). Shared strings trade memory for a smaller file: the string table stays in memory until the workbook is finalized. See ",[287,288,222],"a",{"href":223}," for how to choose.",[253,291,292],{},"Memory is not constant for every schema. Shared strings, merged sub-rows, images, hyperlinks and row-aware summary formulas keep their own metadata for the whole export.",[262,294,296],{"id":295},"a-real-application-export","A real application export",[253,298,299],{},"The same engines exported a production-shaped report from a local PostgreSQL database: 202,058 records, 25 columns, 41 batches, with file spooling and the low-memory profile. The whole worker job went from 40.3 s to 19.4 s.",[270,301],{"metric":302},"app",[304,305,306,322],"table",{},[307,308,309],"thead",{},[310,311,312,316,319],"tr",{},[313,314,315],"th",{},"Phase",[313,317,318],{},"4.2.0",[313,320,321],{},"Current",[323,324,325,337,348,359],"tbody",{},[310,326,327,331,334],{},[328,329,330],"td",{},"Fetch hydrated records",[328,332,333],{},"11.08 s",[328,335,336],{},"10.58 s",[310,338,339,342,345],{},[328,340,341],{},"Commit XLSX rows",[328,343,344],{},"27.21 s",[328,346,347],{},"6.88 s",[310,349,350,353,356],{},[328,351,352],{},"Finalize XLSX",[328,354,355],{},"1.66 s",[328,357,358],{},"1.54 s",[310,360,361,364,367],{},[328,362,363],{},"Whole job",[328,365,366],{},"40.33 s",[328,368,369],{},"19.36 s",[253,371,372],{},"Writing the five million cells went from 27.2 s to 6.9 s, so fetching from the database is now the slowest phase. Both versions produced byte-identical files (21,832,191 bytes).",[262,374,376],{"id":375},"how-it-was-measured","How it was measured",[378,379,380,384,387,390,397],"ul",{},[381,382,383],"li",{},"Node 24.13.0 on an Apple M5 with 32 GiB of RAM, macOS.",[381,385,386],{},"Baseline and current engine run serially in alternating fresh processes.",[381,388,389],{},"200k-row results are the median of three runs. The 500k-row case is a single run per engine, so read it as a scaling check.",[381,391,392,393,396],{},"Peak memory is the process high-water mark (",[257,394,395],{},"maxRSS",").",[381,398,399],{},"All 20 benchmark workbooks are byte-identical between the two engines.",[253,401,402,403,411],{},"These are local measurements, not a production or concurrent-load guarantee. The full report, raw JSON and the commands to reproduce it are in ",[287,404,408],{"href":405,"rel":406},"https:\u002F\u002Fgithub.com\u002FChronicStone\u002Ftyped-xlsx\u002Ftree\u002Fmain\u002Fpackages\u002Fbenchmark\u002Fartifacts\u002Freports\u002Fstream",[407],"nofollow",[257,409,410],{},"packages\u002Fbenchmark\u002Fartifacts\u002Freports\u002Fstream",".",{"title":413,"searchDepth":414,"depth":414,"links":415},"",2,[416,417,418,419],{"id":264,"depth":414,"text":265},{"id":278,"depth":414,"text":279},{"id":295,"depth":414,"text":296},{"id":375,"depth":414,"text":376},"Measured streaming throughput and peak memory for 200k and 500k rows, and a real 202k-row export, comparing typed-xlsx 4.2.0 with the current engine.","md",null,{},true,{"title":426,"description":420},"Excel export benchmarks: speed and memory","7q6cGGNChR-1C5H6J1RFgqLkG5S-xmjASvse3OafLtc",[429,431],{"title":208,"path":209,"stem":210,"description":430,"children":-1},"S3 upload, progress tracking, parallel tables, and stream finalization patterns.",{"title":222,"path":223,"stem":224,"description":432,"children":-1},"How to keep big exports fast and memory-bounded, choose between buffered and streaming, shared and inline strings, and size your batches.",1795026121205]