@loaders.gl/archives 0.0.0-stage → 5.0.0-alpha.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (168) hide show
  1. package/LICENSE +52 -0
  2. package/README.md +4 -2
  3. package/dist/dist.dev.js +5101 -0
  4. package/dist/dist.min.js +9 -0
  5. package/dist/index.cjs +2982 -0
  6. package/dist/index.cjs.map +6 -0
  7. package/dist/index.d.ts +11 -0
  8. package/dist/index.d.ts.map +1 -0
  9. package/dist/index.js +11 -0
  10. package/dist/index.js.map +1 -0
  11. package/dist/tar/index.cjs +576 -0
  12. package/dist/tar/index.cjs.map +6 -0
  13. package/dist/tar/index.d.ts +8 -0
  14. package/dist/tar/index.d.ts.map +1 -0
  15. package/dist/tar/index.js +9 -0
  16. package/dist/tar/index.js.map +1 -0
  17. package/dist/tar/lib/header.d.ts +9 -0
  18. package/dist/tar/lib/header.d.ts.map +1 -0
  19. package/dist/tar/lib/header.js +76 -0
  20. package/dist/tar/lib/header.js.map +1 -0
  21. package/dist/tar/lib/tar.d.ts +29 -0
  22. package/dist/tar/lib/tar.d.ts.map +1 -0
  23. package/dist/tar/lib/tar.js +136 -0
  24. package/dist/tar/lib/tar.js.map +1 -0
  25. package/dist/tar/lib/types.d.ts +48 -0
  26. package/dist/tar/lib/types.d.ts.map +1 -0
  27. package/dist/tar/lib/types.js +5 -0
  28. package/dist/tar/lib/types.js.map +1 -0
  29. package/dist/tar/lib/utils.d.ts +23 -0
  30. package/dist/tar/lib/utils.d.ts.map +1 -0
  31. package/dist/tar/lib/utils.js +52 -0
  32. package/dist/tar/lib/utils.js.map +1 -0
  33. package/dist/tar/tar-archive.d.ts +4 -0
  34. package/dist/tar/tar-archive.d.ts.map +1 -0
  35. package/dist/tar/tar-archive.js +97 -0
  36. package/dist/tar/tar-archive.js.map +1 -0
  37. package/dist/tar/tar-builder.d.ts +28 -0
  38. package/dist/tar/tar-builder.d.ts.map +1 -0
  39. package/dist/tar/tar-builder.js +38 -0
  40. package/dist/tar/tar-builder.js.map +1 -0
  41. package/dist/tar/tar-format.d.ts +12 -0
  42. package/dist/tar/tar-format.d.ts.map +1 -0
  43. package/dist/tar/tar-format.js +15 -0
  44. package/dist/tar/tar-format.js.map +1 -0
  45. package/dist/tar/tar-loader-types.d.ts +15 -0
  46. package/dist/tar/tar-loader-types.d.ts.map +1 -0
  47. package/dist/tar/tar-loader-types.js +20 -0
  48. package/dist/tar/tar-loader-types.js.map +1 -0
  49. package/dist/tar/tar-loader.cjs +285 -0
  50. package/dist/tar/tar-loader.cjs.map +6 -0
  51. package/dist/tar/tar-loader.d.ts +3 -0
  52. package/dist/tar/tar-loader.d.ts.map +1 -0
  53. package/dist/tar/tar-loader.js +12 -0
  54. package/dist/tar/tar-loader.js.map +1 -0
  55. package/dist/tar/tar-writer.cjs +114 -0
  56. package/dist/tar/tar-writer.cjs.map +6 -0
  57. package/dist/tar/tar-writer.d.ts +20 -0
  58. package/dist/tar/tar-writer.d.ts.map +1 -0
  59. package/dist/tar/tar-writer.js +94 -0
  60. package/dist/tar/tar-writer.js.map +1 -0
  61. package/dist/zip/filesystems/IndexedArchive.d.ts +40 -0
  62. package/dist/zip/filesystems/IndexedArchive.d.ts.map +1 -0
  63. package/dist/zip/filesystems/IndexedArchive.js +99 -0
  64. package/dist/zip/filesystems/IndexedArchive.js.map +1 -0
  65. package/dist/zip/filesystems/zip-filesystem.d.ts +53 -0
  66. package/dist/zip/filesystems/zip-filesystem.d.ts.map +1 -0
  67. package/dist/zip/filesystems/zip-filesystem.js +231 -0
  68. package/dist/zip/filesystems/zip-filesystem.js.map +1 -0
  69. package/dist/zip/hash-file-utility.d.ts +20 -0
  70. package/dist/zip/hash-file-utility.d.ts.map +1 -0
  71. package/dist/zip/hash-file-utility.js +83 -0
  72. package/dist/zip/hash-file-utility.js.map +1 -0
  73. package/dist/zip/index.cjs +4614 -0
  74. package/dist/zip/index.cjs.map +6 -0
  75. package/dist/zip/index.d.ts +18 -0
  76. package/dist/zip/index.d.ts.map +1 -0
  77. package/dist/zip/index.js +14 -0
  78. package/dist/zip/index.js.map +1 -0
  79. package/dist/zip/indexed-zip-writer.cjs +1211 -0
  80. package/dist/zip/indexed-zip-writer.cjs.map +6 -0
  81. package/dist/zip/indexed-zip-writer.d.ts +46 -0
  82. package/dist/zip/indexed-zip-writer.d.ts.map +1 -0
  83. package/dist/zip/indexed-zip-writer.js +229 -0
  84. package/dist/zip/indexed-zip-writer.js.map +1 -0
  85. package/dist/zip/lib/zip-composition.d.ts +37 -0
  86. package/dist/zip/lib/zip-composition.d.ts.map +1 -0
  87. package/dist/zip/lib/zip-composition.js +157 -0
  88. package/dist/zip/lib/zip-composition.js.map +1 -0
  89. package/dist/zip/lib/zip-entry-metadata.d.ts +34 -0
  90. package/dist/zip/lib/zip-entry-metadata.d.ts.map +1 -0
  91. package/dist/zip/lib/zip-entry-metadata.js +132 -0
  92. package/dist/zip/lib/zip-entry-metadata.js.map +1 -0
  93. package/dist/zip/lib/zip-serialization.d.ts +36 -0
  94. package/dist/zip/lib/zip-serialization.d.ts.map +1 -0
  95. package/dist/zip/lib/zip-serialization.js +148 -0
  96. package/dist/zip/lib/zip-serialization.js.map +1 -0
  97. package/dist/zip/lib/zip64-extra-field.d.ts +20 -0
  98. package/dist/zip/lib/zip64-extra-field.d.ts.map +1 -0
  99. package/dist/zip/lib/zip64-extra-field.js +53 -0
  100. package/dist/zip/lib/zip64-extra-field.js.map +1 -0
  101. package/dist/zip/zip-archive-types.d.ts +56 -0
  102. package/dist/zip/zip-archive-types.d.ts.map +1 -0
  103. package/dist/zip/zip-archive-types.js +5 -0
  104. package/dist/zip/zip-archive-types.js.map +1 -0
  105. package/dist/zip/zip-archive.d.ts +101 -0
  106. package/dist/zip/zip-archive.d.ts.map +1 -0
  107. package/dist/zip/zip-archive.js +593 -0
  108. package/dist/zip/zip-archive.js.map +1 -0
  109. package/dist/zip/zip-encode-types.d.ts +41 -0
  110. package/dist/zip/zip-encode-types.d.ts.map +1 -0
  111. package/dist/zip/zip-encode-types.js +5 -0
  112. package/dist/zip/zip-encode-types.js.map +1 -0
  113. package/dist/zip/zip-encode.cjs +1154 -0
  114. package/dist/zip/zip-encode.cjs.map +6 -0
  115. package/dist/zip/zip-encode.d.ts +15 -0
  116. package/dist/zip/zip-encode.d.ts.map +1 -0
  117. package/dist/zip/zip-encode.js +312 -0
  118. package/dist/zip/zip-encode.js.map +1 -0
  119. package/dist/zip/zip-format.d.ts +14 -0
  120. package/dist/zip/zip-format.d.ts.map +1 -0
  121. package/dist/zip/zip-format.js +17 -0
  122. package/dist/zip/zip-format.js.map +1 -0
  123. package/dist/zip/zip-loader-types.d.ts +15 -0
  124. package/dist/zip/zip-loader-types.d.ts.map +1 -0
  125. package/dist/zip/zip-loader-types.js +20 -0
  126. package/dist/zip/zip-loader-types.js.map +1 -0
  127. package/dist/zip/zip-loader.cjs +2681 -0
  128. package/dist/zip/zip-loader.cjs.map +6 -0
  129. package/dist/zip/zip-loader.d.ts +3 -0
  130. package/dist/zip/zip-loader.d.ts.map +1 -0
  131. package/dist/zip/zip-loader.js +38 -0
  132. package/dist/zip/zip-loader.js.map +1 -0
  133. package/dist/zip/zip-writer.cjs +1208 -0
  134. package/dist/zip/zip-writer.cjs.map +6 -0
  135. package/dist/zip/zip-writer.d.ts +40 -0
  136. package/dist/zip/zip-writer.d.ts.map +1 -0
  137. package/dist/zip/zip-writer.js +48 -0
  138. package/dist/zip/zip-writer.js.map +1 -0
  139. package/package.json +88 -4
  140. package/src/index.ts +14 -0
  141. package/src/tar/index.ts +11 -0
  142. package/src/tar/lib/header.ts +82 -0
  143. package/src/tar/lib/tar.ts +160 -0
  144. package/src/tar/lib/types.ts +51 -0
  145. package/src/tar/lib/utils.ts +55 -0
  146. package/src/tar/tar-archive.ts +98 -0
  147. package/src/tar/tar-builder.ts +47 -0
  148. package/src/tar/tar-format.ts +17 -0
  149. package/src/tar/tar-loader-types.ts +36 -0
  150. package/src/tar/tar-loader.ts +17 -0
  151. package/src/tar/tar-writer.ts +102 -0
  152. package/src/zip/filesystems/IndexedArchive.ts +110 -0
  153. package/src/zip/filesystems/zip-filesystem.ts +244 -0
  154. package/src/zip/hash-file-utility.ts +109 -0
  155. package/src/zip/index.ts +38 -0
  156. package/src/zip/indexed-zip-writer.ts +345 -0
  157. package/src/zip/lib/zip-composition.ts +243 -0
  158. package/src/zip/lib/zip-entry-metadata.ts +157 -0
  159. package/src/zip/lib/zip-serialization.ts +206 -0
  160. package/src/zip/lib/zip64-extra-field.ts +84 -0
  161. package/src/zip/zip-archive-types.ts +64 -0
  162. package/src/zip/zip-archive.ts +733 -0
  163. package/src/zip/zip-encode-types.ts +53 -0
  164. package/src/zip/zip-encode.ts +370 -0
  165. package/src/zip/zip-format.ts +19 -0
  166. package/src/zip/zip-loader-types.ts +36 -0
  167. package/src/zip/zip-loader.ts +43 -0
  168. package/src/zip/zip-writer.ts +73 -0
@@ -0,0 +1,64 @@
1
+ // loaders.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // Copyright (c) vis.gl contributors
4
+
5
+ import type {ReadableFile} from '@loaders.gl/core/loader-utils';
6
+
7
+ /** Immutable archive bytes or an owned random-access file. */
8
+ export type ZipArchiveInput = ArrayBuffer | ArrayBufferView | Blob | ReadableFile;
9
+
10
+ /** Independent bounds; decoded limits do not bound decoder intermediates or total heap. */
11
+ export interface ZipArchiveOptions {
12
+ /** Maximum archive length; default 1 TiB. */
13
+ readonly maxArchiveBytes?: bigint;
14
+ /** Maximum central-directory bytes; default 32 MiB. */
15
+ readonly maxDirectoryBytes?: number;
16
+ /** Maximum directory records; default 100000. */
17
+ readonly maxEntries?: number;
18
+ /** Maximum bytes in one physical read; default 1 MiB. */
19
+ readonly maxReadBytes?: number;
20
+ /** Maximum compressed bytes consumed for a complete entry; default 64 MiB. */
21
+ readonly maxCompressedBytes?: bigint;
22
+ /** Maximum decoded bytes consumed for a complete entry; default 64 MiB. */
23
+ readonly maxDecodedBytes?: bigint;
24
+ /** Maximum streaming input block; default 64 KiB, capped by maxReadBytes. */
25
+ readonly chunkBytes?: number;
26
+ /** Cancellation shared by initialization and subsequent reads. */
27
+ readonly signal?: AbortSignal;
28
+ }
29
+
30
+ /** Validated immutable entry metadata. Byte locations and lengths retain ZIP64 precision. */
31
+ export interface ZipEntry {
32
+ /** Canonical relative path, including a final slash for a directory. */
33
+ readonly path: string;
34
+ /** Whether this record represents a directory. */
35
+ readonly directory: boolean;
36
+ /** Compression method: STORE or raw DEFLATE. */
37
+ readonly compression: 'store' | 'deflate';
38
+ /** Compressed payload length. */
39
+ readonly compressedSize: bigint;
40
+ /** Decoded payload length. */
41
+ readonly size: bigint;
42
+ /** Expected CRC-32 of the complete decoded payload. */
43
+ readonly crc32: number;
44
+ /** Absolute local-header byte offset. */
45
+ readonly localHeaderOffset: bigint;
46
+ /** Absolute payload byte offset. */
47
+ readonly dataOffset: bigint;
48
+ /** Decoded central-directory comment, empty for direct local-header access. */
49
+ readonly comment: string;
50
+ }
51
+
52
+ /** Options for a complete entry read or streaming decode. */
53
+ export interface ZipReadOptions {
54
+ /** Cancellation for this operation in addition to the archive lifetime. */
55
+ readonly signal?: AbortSignal;
56
+ }
57
+
58
+ /** A bounded STORE slice; end is exclusive. CRC cannot be verified for a partial entry. */
59
+ export interface ZipRangeOptions extends ZipReadOptions {
60
+ /** Inclusive decoded byte offset. */
61
+ readonly start: bigint;
62
+ /** Exclusive decoded byte offset. */
63
+ readonly end: bigint;
64
+ }