xsheetjs/docbits/54_shobject.md

#### Worksheet Object

In addition to the base sheet keys, worksheets also add:

- `ws['!cols']`: array of column properties objects.  Column widths are actually
  stored in files in a normalized manner, measured in terms of the "Maximum
  Digit Width" (the largest width of the rendered digits 0-9, in pixels).  When
  parsed, the column objects store the pixel width in the `wpx` field, character
  width in the `wch` field, and the maximum digit width in the `MDW` field.

- `ws['!merges']`: array of range objects corresponding to the merged cells in
  the worksheet.  Plaintext utilities are unaware of merge cells.  CSV export
  will write all cells in the merge range if they exist, so be sure that only
  the first cell (upper-left) in the range is set.

- `ws['protect']`: object of write sheet protection properties.  The `password`
  key specifies the password.  The writer uses the XOR obfuscation method.  The
  following keys control the sheet protection (same as ECMA-376 18.3.1.85):

| key                   | functionality disabled if value is true              |
|:----------------------|:-----------------------------------------------------|
| `selectLockedCells`   | Select locked cells                                  |
| `selectUnlockedCells` | Select unlocked cells                                |
| `formatCells`         | Format cells                                         |
| `formatColumns`       | Format columns                                       |
| `formatRows`          | Format rows                                          |
| `insertColumns`       | Insert columns                                       |
| `insertRows`          | Insert rows                                          |
| `insertHyperlinks`    | Insert hyperlinks                                    |
| `deleteColumns`       | Delete columns                                       |
| `deleteRows`          | Delete rows                                          |
| `sort`                | Sort                                                 |
| `autoFilter`          | Filter                                               |
| `pivotTables`         | Use PivotTable reports                               |
| `objects`             | Edit objects                                         |
| `scenarios`           | Edit scenarios                                       |

- `ws['!autofilter']`: AutoFilter object following the schema:

```typescript
type AutoFilter = {
	ref:string; // A-1 based range representing the AutoFilter table range
}
```

#### Chartsheet Object

Chartsheets are represented as standard sheets.  They are distinguished with the
`!type` property set to `"chart"`.

The underlying data and `!ref` refer to the cached data in the chartsheet.  The
first row of the chartsheet is the underlying header.