[{"data":1,"prerenderedAt":553},["ShallowReactive",2],{"navigation_docs":3,"page:docs:\u002Fgetting-started\u002Fcomparison":247,"surround:docs:\u002Fgetting-started\u002Fcomparison":548},[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":23,"body":249,"description":539,"extension":540,"links":541,"meta":542,"navigation":543,"path":24,"seo":544,"stem":25,"__hash__":547},"docs\u002F01.getting-started\u002F4.comparison.md",{"type":250,"value":251,"toc":532},"minimark",[252,261,264,269,438,442,449,463,469,487,497,501],[253,254,255,256,260],"p",{},"SheetJS, ExcelJS and typed-xlsx can all write ",[257,258,259],"code",{},".xlsx"," files. They differ in what you write.",[253,262,263],{},"With SheetJS or ExcelJS you place values into cells. With typed-xlsx you describe a report as a typed schema, and the library places the cells. That makes typed-xlsx narrower, it only writes reports, and much stricter about them.",[265,266,268],"h2",{"id":267},"at-a-glance","At a glance",[270,271,272,290],"table",{},[273,274,275],"thead",{},[276,277,278,281,284,287],"tr",{},[279,280],"th",{},[279,282,283],{},"typed-xlsx",[279,285,286],{},"SheetJS (Community)",[279,288,289],{},"ExcelJS",[291,292,293,308,323,336,348,360,373,384,396,409,425],"tbody",{},[276,294,295,299,302,305],{},[296,297,298],"td",{},"You write",[296,300,301],{},"a schema typed against your rows",[296,303,304],{},"arrays and cell objects",[296,306,307],{},"workbook, row and cell objects",[276,309,310,315,318,321],{},[296,311,312,313],{},"Reads ",[257,314,259],{},[296,316,317],{},"no",[296,319,320],{},"yes",[296,322,320],{},[276,324,325,328,330,333],{},[296,326,327],{},"Other formats",[296,329,317],{},[296,331,332],{},"CSV, XLS, ODS and many more",[296,334,335],{},"CSV",[276,337,338,341,343,346],{},[296,339,340],{},"Cell styles on write",[296,342,320],{},[296,344,345],{},"in SheetJS Pro",[296,347,320],{},[276,349,350,352,355,358],{},[296,351,118],{},[296,353,354],{},"typed DSL, references checked by TypeScript",[296,356,357],{},"strings",[296,359,357],{},[276,361,362,365,368,371],{},[296,363,364],{},"Summary and totals rows",[296,366,367],{},"declared per column",[296,369,370],{},"written by hand",[296,372,370],{},[276,374,375,378,380,382],{},[296,376,377],{},"Native Excel tables",[296,379,320],{},[296,381,317],{},[296,383,320],{},[276,385,386,389,392,394],{},[296,387,388],{},"Native charts",[296,390,391],{},"typed marks over your tables",[296,393,317],{},[296,395,317],{},[276,397,398,401,404,406],{},[296,399,400],{},"Pivot tables",[296,402,403],{},"typed fields, with pivot charts",[296,405,317],{},[296,407,408],{},"basic",[276,410,411,414,417,422],{},[296,412,413],{},"Streaming write",[296,415,416],{},"same schema, batch commits",[296,418,419,420],{},"not for ",[257,421,259],{},[296,423,424],{},"separate streaming writer",[276,426,427,430,433,435],{},[296,428,429],{},"Runtime dependencies",[296,431,432],{},"none",[296,434,432],{},[296,436,437],{},"several",[265,439,441],{"id":440},"where-typed-xlsx-is-the-better-fit","Where typed-xlsx is the better fit",[253,443,444,448],{},[445,446,447],"strong",{},"The report is the contract."," Columns, headers, formulas, styles and summaries live in one schema typed against your row type. Renaming a field breaks the build, not the export.",[253,450,451,454,455,458,459,462],{},[445,452,453],{},"Formulas stay correct when columns move."," You write ",[257,456,457],{},"refs.column(\"qty\").mul(refs.column(\"unitPrice\"))","; typed-xlsx writes ",[257,460,461],{},"=(C2*D2)",", or a structured reference inside an Excel table. Referencing a column that doesn't exist, or one declared later, is a type error.",[253,464,465,468],{},[445,466,467],{},"One schema, many exports."," The same schema serves different row sets, a different column selection per audience, a different theme, or a native Excel table, without copying column definitions.",[253,470,471,474,475,478,479,482,483,486],{},[445,472,473],{},"Big exports use the same code."," ",[257,476,477],{},"createWorkbookStream()"," takes the same schema as ",[257,480,481],{},"createWorkbook()",". See ",[484,485,218],"a",{"href":219}," for measured throughput.",[253,488,489,492,493,496],{},[445,490,491],{},"Report features are built in."," Grouped headers, sub-row expansion, summary rows, badges, checkboxes, sparklines, images, hyperlinks, validation dropdowns, conditional formats and protection are schema options rather than cell-by-cell code. ",[484,494,495],{"href":157},"Native charts and pivot tables"," are declared from the tables you already have, with their columns checked by TypeScript.",[265,498,500],{"id":499},"where-sheetjs-or-exceljs-is-the-better-fit","Where SheetJS or ExcelJS is the better fit",[502,503,504,511,520,526],"ul",{},[505,506,507,510],"li",{},[445,508,509],{},"Reading files."," typed-xlsx only writes. To parse uploads or import spreadsheets, use SheetJS or ExcelJS.",[505,512,513,516,517,519],{},[445,514,515],{},"Other formats."," SheetJS reads and writes far more formats than ",[257,518,259],{},".",[505,521,522,525],{},[445,523,524],{},"Editing an existing workbook."," Opening a file, changing it and saving it back is outside typed-xlsx's scope.",[505,527,528,531],{},[445,529,530],{},"Free-form sheets."," When the sheet isn't a table of records (a form, a dashboard laid out cell by cell, notes and rich text), a cell API is the more direct tool.",{"title":533,"searchDepth":534,"depth":534,"links":535},"",2,[536,537,538],{"id":267,"depth":534,"text":268},{"id":440,"depth":534,"text":441},{"id":499,"depth":534,"text":500},"How typed-xlsx differs from SheetJS and ExcelJS, and when each one is the better choice.","md",null,{},true,{"title":545,"description":546},"typed-xlsx vs ExcelJS vs SheetJS","Compare typed-xlsx, ExcelJS and SheetJS for writing Excel files in TypeScript: typed schemas, formulas, styles, native tables, charts, pivot tables, streaming and dependencies.","CVz7a3oxauvPHRJmtutyqAii7ZujPhaVUeqcRtdykH8",[549,551],{"title":19,"path":20,"stem":21,"description":550,"children":-1},"Build an invoice report with formula columns, a totals row and status badges, then export it buffered and streamed from the same schema.",{"title":34,"path":35,"stem":36,"description":552,"children":-1},"Report mode writes a laid-out range with titles and summary rows; excel-table mode writes a native Excel table with filters and a totals row. How to choose.",1795026121262]