docs: tree node size/checksum reflect the original form under originals=true

Author: ErykKul

docs/useCases.md

@@ -1654,7 +1654,7 @@ _See [use case](../src/datasets/domain/useCases/ListDatasetTreeNode.ts) implemen
 
 `datasetId` can be a numeric id or a persistent identifier string. `datasetVersionId` is optional and defaults to `DatasetNotNumberedVersion.LATEST`.
 
-Other optional parameters: `cursor` (opaque, from a previous response), `include` (`'all' | 'folders' | 'files'`, default `'all'`), `order` (`'NameAZ' | 'NameZA'`, default `'NameAZ'`), `includeDeaccessioned` (default `false`), and `originals` (when `true`, the per-file `downloadUrl` carries `?format=original`).
+Other optional parameters: `cursor` (opaque, from a previous response), `include` (`'all' | 'folders' | 'files'`, default `'all'`), `order` (`'NameAZ' | 'NameZA'`, default `'NameAZ'`), `includeDeaccessioned` (default `false`), and `originals` (when `true`, ingested tabular files are reported in their original-upload form: the per-file `downloadUrl` carries `?format=original`, and `checksum` and `size` reflect the saved original instead of the converted TSV).
 
 For published, non-deaccessioned versions the underlying API emits `ETag` + `Cache-Control: private, immutable` headers. The `private` directive keeps responses out of shared proxy caches because the route is auth-required; the browser's own cache still benefits from `immutable`. Drafts and deaccessioned versions don't.
 

src/datasets/domain/models/FileTreeNode.ts

@@ -40,6 +40,12 @@ export interface FileTreeFileNode {
   id: number
   name: string
   path: string
+  /**
+   * File size in bytes. For ingested tabular files this is the
+   * served-form (converted TSV) size by default; when the listing was
+   * requested with `originals=true` it is the saved original's size,
+   * matching the bytes `downloadUrl` then serves.
+   */
   size: number
   contentType?: string
   access?: 'public' | 'restricted' | 'embargoed'