@cj-tech-master/excelts 4.2.1-canary.20260111102127.f808a37 → 4.2.1-canary.20260112134913.a3cecdd

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 (101) hide show
  1. package/dist/browser/modules/archive/io/archive-sink.d.ts +0 -1
  2. package/dist/browser/modules/archive/io/archive-sink.js +6 -38
  3. package/dist/browser/modules/archive/io/archive-source.d.ts +0 -2
  4. package/dist/browser/modules/archive/io/archive-source.js +1 -8
  5. package/dist/browser/modules/excel/utils/ooxml-validator.d.ts +48 -0
  6. package/dist/browser/modules/excel/utils/ooxml-validator.js +469 -0
  7. package/dist/browser/modules/excel/worksheet.js +5 -2
  8. package/dist/browser/modules/excel/xlsx/xform/drawing/ctrl-prop-xform.d.ts +1 -0
  9. package/dist/browser/modules/excel/xlsx/xform/drawing/ctrl-prop-xform.js +13 -1
  10. package/dist/browser/modules/excel/xlsx/xform/drawing/sp-xform.d.ts +18 -0
  11. package/dist/browser/modules/excel/xlsx/xform/drawing/sp-xform.js +112 -0
  12. package/dist/browser/modules/excel/xlsx/xform/drawing/two-cell-anchor-xform.d.ts +6 -1
  13. package/dist/browser/modules/excel/xlsx/xform/drawing/two-cell-anchor-xform.js +30 -2
  14. package/dist/browser/modules/excel/xlsx/xform/drawing/vml-drawing-xform.js +11 -0
  15. package/dist/browser/modules/excel/xlsx/xform/sheet/page-setup-xform.d.ts +1 -0
  16. package/dist/browser/modules/excel/xlsx/xform/sheet/page-setup-xform.js +16 -2
  17. package/dist/browser/modules/excel/xlsx/xform/sheet/worksheet-xform.js +110 -12
  18. package/dist/browser/modules/stream/base-transform.d.ts +3 -0
  19. package/dist/browser/modules/stream/base-transform.js +34 -20
  20. package/dist/browser/modules/stream/buffered-stream.d.ts +2 -12
  21. package/dist/browser/modules/stream/chunked-builder.js +4 -4
  22. package/dist/browser/modules/stream/index.browser.d.ts +13 -19
  23. package/dist/browser/modules/stream/index.browser.js +10 -22
  24. package/dist/browser/modules/stream/index.d.ts +18 -41
  25. package/dist/browser/modules/stream/index.js +15 -44
  26. package/dist/browser/modules/stream/internal/event-utils.d.ts +17 -0
  27. package/dist/browser/modules/stream/internal/event-utils.js +40 -0
  28. package/dist/browser/modules/stream/internal/type-guards.d.ts +9 -0
  29. package/dist/browser/modules/stream/internal/type-guards.js +24 -0
  30. package/dist/browser/modules/stream/pull-stream.d.ts +5 -6
  31. package/dist/browser/modules/stream/pull-stream.js +107 -43
  32. package/dist/browser/modules/stream/shared.d.ts +1 -1
  33. package/dist/browser/modules/stream/shared.js +7 -4
  34. package/dist/browser/modules/stream/streams.browser.d.ts +4 -14
  35. package/dist/browser/modules/stream/streams.browser.js +129 -164
  36. package/dist/browser/modules/stream/streams.d.ts +4 -20
  37. package/dist/browser/modules/stream/streams.js +6 -37
  38. package/dist/browser/modules/stream/utils.js +5 -38
  39. package/dist/cjs/modules/archive/io/archive-sink.js +7 -40
  40. package/dist/cjs/modules/archive/io/archive-source.js +3 -12
  41. package/dist/cjs/modules/excel/utils/ooxml-validator.js +475 -0
  42. package/dist/cjs/modules/excel/worksheet.js +5 -2
  43. package/dist/cjs/modules/excel/xlsx/xform/drawing/ctrl-prop-xform.js +13 -1
  44. package/dist/cjs/modules/excel/xlsx/xform/drawing/sp-xform.js +115 -0
  45. package/dist/cjs/modules/excel/xlsx/xform/drawing/two-cell-anchor-xform.js +30 -2
  46. package/dist/cjs/modules/excel/xlsx/xform/drawing/vml-drawing-xform.js +11 -0
  47. package/dist/cjs/modules/excel/xlsx/xform/sheet/page-setup-xform.js +16 -2
  48. package/dist/cjs/modules/excel/xlsx/xform/sheet/worksheet-xform.js +110 -12
  49. package/dist/cjs/modules/stream/base-transform.js +34 -20
  50. package/dist/cjs/modules/stream/chunked-builder.js +4 -4
  51. package/dist/cjs/modules/stream/index.browser.js +10 -17
  52. package/dist/cjs/modules/stream/index.js +15 -39
  53. package/dist/cjs/modules/stream/internal/event-utils.js +43 -0
  54. package/dist/cjs/modules/stream/internal/type-guards.js +30 -0
  55. package/dist/cjs/modules/stream/pull-stream.js +107 -43
  56. package/dist/cjs/modules/stream/shared.js +7 -4
  57. package/dist/cjs/modules/stream/streams.browser.js +135 -175
  58. package/dist/cjs/modules/stream/streams.js +16 -49
  59. package/dist/cjs/modules/stream/utils.js +3 -36
  60. package/dist/esm/modules/archive/io/archive-sink.js +6 -38
  61. package/dist/esm/modules/archive/io/archive-source.js +1 -8
  62. package/dist/esm/modules/excel/utils/ooxml-validator.js +469 -0
  63. package/dist/esm/modules/excel/worksheet.js +5 -2
  64. package/dist/esm/modules/excel/xlsx/xform/drawing/ctrl-prop-xform.js +13 -1
  65. package/dist/esm/modules/excel/xlsx/xform/drawing/sp-xform.js +112 -0
  66. package/dist/esm/modules/excel/xlsx/xform/drawing/two-cell-anchor-xform.js +30 -2
  67. package/dist/esm/modules/excel/xlsx/xform/drawing/vml-drawing-xform.js +11 -0
  68. package/dist/esm/modules/excel/xlsx/xform/sheet/page-setup-xform.js +16 -2
  69. package/dist/esm/modules/excel/xlsx/xform/sheet/worksheet-xform.js +110 -12
  70. package/dist/esm/modules/stream/base-transform.js +34 -20
  71. package/dist/esm/modules/stream/chunked-builder.js +4 -4
  72. package/dist/esm/modules/stream/index.browser.js +10 -22
  73. package/dist/esm/modules/stream/index.js +15 -44
  74. package/dist/esm/modules/stream/internal/event-utils.js +40 -0
  75. package/dist/esm/modules/stream/internal/type-guards.js +24 -0
  76. package/dist/esm/modules/stream/pull-stream.js +107 -43
  77. package/dist/esm/modules/stream/shared.js +7 -4
  78. package/dist/esm/modules/stream/streams.browser.js +129 -164
  79. package/dist/esm/modules/stream/streams.js +6 -37
  80. package/dist/esm/modules/stream/utils.js +5 -38
  81. package/dist/iife/excelts.iife.js +325 -60
  82. package/dist/iife/excelts.iife.js.map +1 -1
  83. package/dist/iife/excelts.iife.min.js +25 -25
  84. package/dist/types/modules/archive/io/archive-sink.d.ts +0 -1
  85. package/dist/types/modules/archive/io/archive-source.d.ts +0 -2
  86. package/dist/types/modules/excel/utils/ooxml-validator.d.ts +48 -0
  87. package/dist/types/modules/excel/xlsx/xform/drawing/ctrl-prop-xform.d.ts +1 -0
  88. package/dist/types/modules/excel/xlsx/xform/drawing/sp-xform.d.ts +18 -0
  89. package/dist/types/modules/excel/xlsx/xform/drawing/two-cell-anchor-xform.d.ts +6 -1
  90. package/dist/types/modules/excel/xlsx/xform/sheet/page-setup-xform.d.ts +1 -0
  91. package/dist/types/modules/stream/base-transform.d.ts +3 -0
  92. package/dist/types/modules/stream/buffered-stream.d.ts +2 -12
  93. package/dist/types/modules/stream/index.browser.d.ts +13 -19
  94. package/dist/types/modules/stream/index.d.ts +18 -41
  95. package/dist/types/modules/stream/internal/event-utils.d.ts +17 -0
  96. package/dist/types/modules/stream/internal/type-guards.d.ts +9 -0
  97. package/dist/types/modules/stream/pull-stream.d.ts +5 -6
  98. package/dist/types/modules/stream/shared.d.ts +1 -1
  99. package/dist/types/modules/stream/streams.browser.d.ts +4 -14
  100. package/dist/types/modules/stream/streams.d.ts +4 -20
  101. package/package.json +10 -10
@@ -1,25 +1,13 @@
1
1
  /**
2
- * Stream Module (browser type surface)
2
+ * Stream Module (browser entry)
3
3
  *
4
- * Mirrors [src/modules/stream/index.ts] but explicitly re-exports from
5
- * ./streams.browser so we can enforce index export-surface parity.
4
+ * Mirrors the public surface of `./index.ts`, but exports the browser
5
+ * implementation from `./streams.browser`.
6
+ *
7
+ * This file is intentionally export-only (tree-shaking friendly).
6
8
  */
7
- // =============================================================================
8
- // Native Stream Classes and Functions (browser)
9
- // =============================================================================
10
- import { Readable, Writable, Transform, Duplex, PassThrough, Collector, PullStream, BufferedStream, StringChunk, BufferChunk, createReadable, createWritable, createTransform, createCollector, createPassThrough, createPullStream, createBufferedStream, createReadableFromArray, createReadableFromAsyncIterable, createReadableFromGenerator, createReadableFromPromise, createDuplex, createEmptyReadable, createNullWritable, pipeline, finished, streamToPromise, streamToUint8Array, streamToBuffer, streamToString, drainStream, copyStream, addAbortSignal, compose, finishedAll, once, promisify, isReadable, isWritable, isTransform, isDuplex, isStream, isDestroyed, isDisturbed, isErrored, getDefaultHighWaterMark, setDefaultHighWaterMark, duplexPair, normalizeWritable as Writeable, consumers, promises } from "./streams.browser.js";
11
- export { Readable, Writable, Transform, Duplex, PassThrough, Collector, PullStream, BufferedStream, StringChunk, BufferChunk, createReadable, createWritable, createTransform, createCollector, createPassThrough, createPullStream, createBufferedStream, createReadableFromArray, createReadableFromAsyncIterable, createReadableFromGenerator, createReadableFromPromise, createDuplex, createEmptyReadable, createNullWritable, pipeline, finished, streamToPromise, streamToUint8Array, streamToBuffer, streamToString, drainStream, copyStream, addAbortSignal, compose, finishedAll, once, promisify, isReadable, isWritable, isTransform, isDuplex, isStream, isDestroyed, isDisturbed, isErrored, getDefaultHighWaterMark, setDefaultHighWaterMark, duplexPair, Writeable, consumers, promises };
12
- import { EventEmitter } from "./event-emitter.js";
13
- export { EventEmitter };
14
- // =============================================================================
15
- // ChunkedBuilder (platform-independent)
16
- // =============================================================================
17
- import { ChunkedBuilder, TransactionalChunkedBuilder } from "./chunked-builder.js";
18
- export { ChunkedBuilder, TransactionalChunkedBuilder };
19
- // =============================================================================
20
- // Utility Functions (platform-independent)
21
- // =============================================================================
22
- import { textEncoder, textDecoder, stringToUint8Array, uint8ArrayToString, uint8ArrayEquals, uint8ArrayIndexOf, uint8ArraySlice, toUint8Array, bufferToString, concatUint8Arrays } from "./shared.js";
23
- export { textEncoder, textDecoder, stringToUint8Array, uint8ArrayToString, uint8ArrayEquals, uint8ArrayIndexOf, uint8ArraySlice, toUint8Array, bufferToString, concatUint8Arrays };
24
- import { collect, text, json, bytes, fromString, fromJSON, fromBytes, transform, filter } from "./utils.js";
25
- export { collect, text, json, bytes, fromString, fromJSON, fromBytes, transform, filter };
9
+ export { Readable, Writable, Transform, Duplex, PassThrough, Collector, PullStream, BufferedStream, StringChunk, BufferChunk, createReadable, createWritable, createTransform, createCollector, createPassThrough, createPullStream, createBufferedStream, createReadableFromArray, createReadableFromAsyncIterable, createReadableFromGenerator, createReadableFromPromise, createDuplex, createEmptyReadable, createNullWritable, pipeline, finished, streamToPromise, streamToUint8Array, streamToBuffer, streamToString, drainStream, copyStream, addAbortSignal, compose, finishedAll, once, promisify, isReadable, isWritable, isTransform, isDuplex, isStream, isDestroyed, isDisturbed, isErrored, getDefaultHighWaterMark, setDefaultHighWaterMark, duplexPair, normalizeWritable as Writeable, consumers, promises } from "./streams.browser.js";
10
+ export { EventEmitter } from "./event-emitter.js";
11
+ export { ChunkedBuilder, TransactionalChunkedBuilder } from "./chunked-builder.js";
12
+ export { textEncoder, textDecoder, stringToUint8Array, uint8ArrayToString, uint8ArrayEquals, uint8ArrayIndexOf, uint8ArraySlice, toUint8Array, bufferToString, concatUint8Arrays } from "./shared.js";
13
+ export { collect, text, json, bytes, fromString, fromJSON, fromBytes, transform, filter } from "./utils.js";
@@ -1,49 +1,26 @@
1
1
  /**
2
- * Stream Module
2
+ * Stream Module (Node.js entry)
3
3
  *
4
- * Native stream implementations for Node.js and Browser.
4
+ * Public entrypoint for stream utilities and classes.
5
5
  *
6
- * - Node.js: Uses native `stream` module (Readable, Writable, Transform, Duplex, PassThrough)
7
- * - Browser: Uses Web Streams API (ReadableStream, WritableStream, TransformStream)
8
- *
9
- * Both implementations provide the same API for cross-platform compatibility.
6
+ * Notes:
7
+ * - This file is intentionally export-only (tree-shaking friendly).
8
+ * - Browser builds should import from `@stream/index.browser`.
10
9
  *
11
10
  * @example
12
- * ```typescript
13
- * import {
14
- * Readable,
15
- * Writable,
16
- * Transform,
17
- * Duplex,
18
- * PassThrough,
19
- * pipeline,
20
- * createTransform,
21
- * streamToUint8Array
22
- * } from './modules/stream';
23
- *
24
- * // Create a transform stream
25
- * const uppercase = createTransform<Uint8Array, Uint8Array>(chunk => {
26
- * const text = new TextDecoder().decode(chunk);
27
- * return new TextEncoder().encode(text.toUpperCase());
28
- * });
11
+ * ```ts
12
+ * import { pipeline, createTransform, createCollector } from "@stream";
29
13
  *
30
- * // Use pipeline for clean stream composition
31
- * await pipeline(readable, uppercase, writable);
14
+ * const upper = createTransform<Uint8Array, Uint8Array>(chunk => chunk);
15
+ * const out = createCollector<Uint8Array>();
16
+ * await pipeline(source, upper, out);
32
17
  * ```
33
18
  */
34
- import type { ReadableStreamOptions, WritableStreamOptions, TransformStreamOptions, DuplexStreamOptions, PullStreamOptions, BufferedStreamOptions, TransformCallback, FlushCallback, WriteCallback, DestroyCallback, IEventEmitter, IReadable, IWritable, ITransform, IDuplex, IPullStream, IBufferedStream, IPassThrough, ICollector, DataChunk, EventListener, PipelineSource, PipelineTransform, PipelineDestination, ReadWriteBufferOptions } from "@stream/types";
35
- export type { ReadableStreamOptions, WritableStreamOptions, TransformStreamOptions, DuplexStreamOptions, PullStreamOptions, BufferedStreamOptions, TransformCallback, FlushCallback, WriteCallback, DestroyCallback, IEventEmitter, IReadable, IWritable, ITransform, IDuplex, IPullStream, IBufferedStream, IPassThrough, ICollector, DataChunk, EventListener, PipelineSource, PipelineTransform, PipelineDestination, ReadWriteBufferOptions };
36
- import { Readable, Writable, Transform, Duplex, PassThrough, Collector, PullStream, BufferedStream, StringChunk, BufferChunk, createReadable, createWritable, createTransform, createCollector, createPassThrough, createPullStream, createBufferedStream, createReadableFromArray, createReadableFromAsyncIterable, createReadableFromGenerator, createReadableFromPromise, createDuplex, createEmptyReadable, createNullWritable, pipeline, finished, streamToPromise, streamToUint8Array, streamToBuffer, streamToString, drainStream, copyStream, addAbortSignal, compose, finishedAll, once, promisify, isReadable, isWritable, isTransform, isDuplex, isStream, isDestroyed, isDisturbed, isErrored, getDefaultHighWaterMark, setDefaultHighWaterMark, duplexPair, normalizeWritable as Writeable, consumers, promises } from "@stream/streams";
37
- import type { PipelineOptions, FinishedOptions } from "@stream/streams";
38
- export { Readable, Writable, Transform, Duplex, PassThrough, Collector, PullStream, BufferedStream, StringChunk, BufferChunk, createReadable, createWritable, createTransform, createCollector, createPassThrough, createPullStream, createBufferedStream, createReadableFromArray, createReadableFromAsyncIterable, createReadableFromGenerator, createReadableFromPromise, createDuplex, createEmptyReadable, createNullWritable, pipeline, finished, streamToPromise, streamToUint8Array, streamToBuffer, streamToString, drainStream, copyStream, addAbortSignal, compose, finishedAll, once, promisify, isReadable, isWritable, isTransform, isDuplex, isStream, isDestroyed, isDisturbed, isErrored, getDefaultHighWaterMark, setDefaultHighWaterMark, duplexPair, Writeable, consumers, promises };
39
- export type { PipelineOptions, FinishedOptions };
40
- import { EventEmitter } from "@stream/event-emitter";
41
- export { EventEmitter };
42
- import { ChunkedBuilder, TransactionalChunkedBuilder } from "@stream/chunked-builder";
43
- import type { ChunkedBuilderOptions, BuilderSnapshot } from "@stream/chunked-builder";
44
- export { ChunkedBuilder, TransactionalChunkedBuilder };
45
- export type { ChunkedBuilderOptions, BuilderSnapshot };
46
- import { textEncoder, textDecoder, stringToUint8Array, uint8ArrayToString, uint8ArrayEquals, uint8ArrayIndexOf, uint8ArraySlice, toUint8Array, bufferToString, concatUint8Arrays } from "@stream/shared";
47
- export { textEncoder, textDecoder, stringToUint8Array, uint8ArrayToString, uint8ArrayEquals, uint8ArrayIndexOf, uint8ArraySlice, toUint8Array, bufferToString, concatUint8Arrays };
48
- import { collect, text, json, bytes, fromString, fromJSON, fromBytes, transform, filter } from "@stream/utils";
49
- export { collect, text, json, bytes, fromString, fromJSON, fromBytes, transform, filter };
19
+ export type { ReadableStreamOptions, WritableStreamOptions, TransformStreamOptions, DuplexStreamOptions, PullStreamOptions, BufferedStreamOptions, TransformCallback, FlushCallback, WriteCallback, DestroyCallback, IEventEmitter, IReadable, IWritable, ITransform, IDuplex, IPullStream, IBufferedStream, IPassThrough, ICollector, DataChunk, EventListener, PipelineSource, PipelineTransform, PipelineDestination, ReadWriteBufferOptions } from "@stream/types";
20
+ export { Readable, Writable, Transform, Duplex, PassThrough, Collector, PullStream, BufferedStream, StringChunk, BufferChunk, createReadable, createWritable, createTransform, createCollector, createPassThrough, createPullStream, createBufferedStream, createReadableFromArray, createReadableFromAsyncIterable, createReadableFromGenerator, createReadableFromPromise, createDuplex, createEmptyReadable, createNullWritable, pipeline, finished, streamToPromise, streamToUint8Array, streamToBuffer, streamToString, drainStream, copyStream, addAbortSignal, compose, finishedAll, once, promisify, isReadable, isWritable, isTransform, isDuplex, isStream, isDestroyed, isDisturbed, isErrored, getDefaultHighWaterMark, setDefaultHighWaterMark, duplexPair, normalizeWritable as Writeable, consumers, promises } from "@stream/streams";
21
+ export type { PipelineOptions, FinishedOptions } from "@stream/streams";
22
+ export { EventEmitter } from "@stream/event-emitter";
23
+ export { ChunkedBuilder, TransactionalChunkedBuilder } from "@stream/chunked-builder";
24
+ export type { ChunkedBuilderOptions, BuilderSnapshot } from "@stream/chunked-builder";
25
+ export { textEncoder, textDecoder, stringToUint8Array, uint8ArrayToString, uint8ArrayEquals, uint8ArrayIndexOf, uint8ArraySlice, toUint8Array, bufferToString, concatUint8Arrays } from "@stream/shared";
26
+ export { collect, text, json, bytes, fromString, fromJSON, fromBytes, transform, filter } from "@stream/utils";
@@ -1,52 +1,23 @@
1
1
  /**
2
- * Stream Module
2
+ * Stream Module (Node.js entry)
3
3
  *
4
- * Native stream implementations for Node.js and Browser.
4
+ * Public entrypoint for stream utilities and classes.
5
5
  *
6
- * - Node.js: Uses native `stream` module (Readable, Writable, Transform, Duplex, PassThrough)
7
- * - Browser: Uses Web Streams API (ReadableStream, WritableStream, TransformStream)
8
- *
9
- * Both implementations provide the same API for cross-platform compatibility.
6
+ * Notes:
7
+ * - This file is intentionally export-only (tree-shaking friendly).
8
+ * - Browser builds should import from `@stream/index.browser`.
10
9
  *
11
10
  * @example
12
- * ```typescript
13
- * import {
14
- * Readable,
15
- * Writable,
16
- * Transform,
17
- * Duplex,
18
- * PassThrough,
19
- * pipeline,
20
- * createTransform,
21
- * streamToUint8Array
22
- * } from './modules/stream.js';
23
- *
24
- * // Create a transform stream
25
- * const uppercase = createTransform<Uint8Array, Uint8Array>(chunk => {
26
- * const text = new TextDecoder().decode(chunk);
27
- * return new TextEncoder().encode(text.toUpperCase());
28
- * });
11
+ * ```ts
12
+ * import { pipeline, createTransform, createCollector } from "./index.browser.js";
29
13
  *
30
- * // Use pipeline for clean stream composition
31
- * await pipeline(readable, uppercase, writable);
14
+ * const upper = createTransform<Uint8Array, Uint8Array>(chunk => chunk);
15
+ * const out = createCollector<Uint8Array>();
16
+ * await pipeline(source, upper, out);
32
17
  * ```
33
18
  */
34
- // =============================================================================
35
- // Native Stream Classes and Functions (platform-specific)
36
- // =============================================================================
37
- import { Readable, Writable, Transform, Duplex, PassThrough, Collector, PullStream, BufferedStream, StringChunk, BufferChunk, createReadable, createWritable, createTransform, createCollector, createPassThrough, createPullStream, createBufferedStream, createReadableFromArray, createReadableFromAsyncIterable, createReadableFromGenerator, createReadableFromPromise, createDuplex, createEmptyReadable, createNullWritable, pipeline, finished, streamToPromise, streamToUint8Array, streamToBuffer, streamToString, drainStream, copyStream, addAbortSignal, compose, finishedAll, once, promisify, isReadable, isWritable, isTransform, isDuplex, isStream, isDestroyed, isDisturbed, isErrored, getDefaultHighWaterMark, setDefaultHighWaterMark, duplexPair, normalizeWritable as Writeable, consumers, promises } from "./streams.browser.js";
38
- export { Readable, Writable, Transform, Duplex, PassThrough, Collector, PullStream, BufferedStream, StringChunk, BufferChunk, createReadable, createWritable, createTransform, createCollector, createPassThrough, createPullStream, createBufferedStream, createReadableFromArray, createReadableFromAsyncIterable, createReadableFromGenerator, createReadableFromPromise, createDuplex, createEmptyReadable, createNullWritable, pipeline, finished, streamToPromise, streamToUint8Array, streamToBuffer, streamToString, drainStream, copyStream, addAbortSignal, compose, finishedAll, once, promisify, isReadable, isWritable, isTransform, isDuplex, isStream, isDestroyed, isDisturbed, isErrored, getDefaultHighWaterMark, setDefaultHighWaterMark, duplexPair, Writeable, consumers, promises };
39
- import { EventEmitter } from "./event-emitter.js";
40
- export { EventEmitter };
41
- // =============================================================================
42
- // ChunkedBuilder (platform-independent)
43
- // =============================================================================
44
- import { ChunkedBuilder, TransactionalChunkedBuilder } from "./chunked-builder.js";
45
- export { ChunkedBuilder, TransactionalChunkedBuilder };
46
- // =============================================================================
47
- // Utility Functions (platform-independent)
48
- // =============================================================================
49
- import { textEncoder, textDecoder, stringToUint8Array, uint8ArrayToString, uint8ArrayEquals, uint8ArrayIndexOf, uint8ArraySlice, toUint8Array, bufferToString, concatUint8Arrays } from "./shared.js";
50
- export { textEncoder, textDecoder, stringToUint8Array, uint8ArrayToString, uint8ArrayEquals, uint8ArrayIndexOf, uint8ArraySlice, toUint8Array, bufferToString, concatUint8Arrays };
51
- import { collect, text, json, bytes, fromString, fromJSON, fromBytes, transform, filter } from "./utils.js";
52
- export { collect, text, json, bytes, fromString, fromJSON, fromBytes, transform, filter };
19
+ export { Readable, Writable, Transform, Duplex, PassThrough, Collector, PullStream, BufferedStream, StringChunk, BufferChunk, createReadable, createWritable, createTransform, createCollector, createPassThrough, createPullStream, createBufferedStream, createReadableFromArray, createReadableFromAsyncIterable, createReadableFromGenerator, createReadableFromPromise, createDuplex, createEmptyReadable, createNullWritable, pipeline, finished, streamToPromise, streamToUint8Array, streamToBuffer, streamToString, drainStream, copyStream, addAbortSignal, compose, finishedAll, once, promisify, isReadable, isWritable, isTransform, isDuplex, isStream, isDestroyed, isDisturbed, isErrored, getDefaultHighWaterMark, setDefaultHighWaterMark, duplexPair, normalizeWritable as Writeable, consumers, promises } from "./streams.browser.js";
20
+ export { EventEmitter } from "./event-emitter.js";
21
+ export { ChunkedBuilder, TransactionalChunkedBuilder } from "./chunked-builder.js";
22
+ export { textEncoder, textDecoder, stringToUint8Array, uint8ArrayToString, uint8ArrayEquals, uint8ArrayIndexOf, uint8ArraySlice, toUint8Array, bufferToString, concatUint8Arrays } from "./shared.js";
23
+ export { collect, text, json, bytes, fromString, fromJSON, fromBytes, transform, filter } from "./utils.js";
@@ -0,0 +1,17 @@
1
+ /**
2
+ * Small event utilities for Node-style emitters.
3
+ *
4
+ * Prefer keeping this separate from the main stream implementation so other
5
+ * modules (e.g. archive) can reuse it without pulling in the whole stream API.
6
+ */
7
+ type NodeStyleEmitter = {
8
+ on?: (event: string, listener: (...args: any[]) => void) => any;
9
+ once?: (event: string, listener: (...args: any[]) => void) => any;
10
+ off?: (event: string, listener: (...args: any[]) => void) => any;
11
+ removeListener?: (event: string, listener: (...args: any[]) => void) => any;
12
+ };
13
+ /**
14
+ * Resolve when an emitter fires `event`, reject on `error`.
15
+ */
16
+ export declare function onceEvent(emitter: NodeStyleEmitter, event: string): Promise<void>;
17
+ export {};
@@ -0,0 +1,40 @@
1
+ /**
2
+ * Small event utilities for Node-style emitters.
3
+ *
4
+ * Prefer keeping this separate from the main stream implementation so other
5
+ * modules (e.g. archive) can reuse it without pulling in the whole stream API.
6
+ */
7
+ function off(emitter, event, listener) {
8
+ if (typeof emitter.off === "function") {
9
+ emitter.off(event, listener);
10
+ }
11
+ else if (typeof emitter.removeListener === "function") {
12
+ emitter.removeListener(event, listener);
13
+ }
14
+ }
15
+ /**
16
+ * Resolve when an emitter fires `event`, reject on `error`.
17
+ */
18
+ export function onceEvent(emitter, event) {
19
+ return new Promise((resolve, reject) => {
20
+ const onError = (err) => {
21
+ cleanup();
22
+ reject(err instanceof Error ? err : new Error(String(err)));
23
+ };
24
+ const onDone = () => {
25
+ cleanup();
26
+ resolve();
27
+ };
28
+ const cleanup = () => {
29
+ off(emitter, "error", onError);
30
+ off(emitter, event, onDone);
31
+ };
32
+ if (typeof emitter.once === "function") {
33
+ emitter.once("error", onError);
34
+ emitter.once(event, onDone);
35
+ return;
36
+ }
37
+ emitter.on?.("error", onError);
38
+ emitter.on?.(event, onDone);
39
+ });
40
+ }
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Lightweight runtime type guards shared across modules.
3
+ *
4
+ * Keep this file dependency-free to maximize deduping in bundled builds.
5
+ */
6
+ export declare function isReadableStream(value: unknown): value is ReadableStream<unknown>;
7
+ export declare function isWritableStream(value: unknown): value is WritableStream<unknown>;
8
+ export declare function isAsyncIterable(value: unknown): value is AsyncIterable<unknown>;
9
+ export declare function isTransformStream(value: unknown): value is TransformStream<unknown, unknown>;
@@ -0,0 +1,24 @@
1
+ /**
2
+ * Lightweight runtime type guards shared across modules.
3
+ *
4
+ * Keep this file dependency-free to maximize deduping in bundled builds.
5
+ */
6
+ export function isReadableStream(value) {
7
+ return !!value && typeof value === "object" && typeof value.getReader === "function";
8
+ }
9
+ export function isWritableStream(value) {
10
+ return !!value && typeof value === "object" && typeof value.getWriter === "function";
11
+ }
12
+ export function isAsyncIterable(value) {
13
+ return (!!value &&
14
+ (typeof value === "object" || typeof value === "function") &&
15
+ typeof value[Symbol.asyncIterator] === "function");
16
+ }
17
+ export function isTransformStream(value) {
18
+ return (!!value &&
19
+ typeof value === "object" &&
20
+ !!value.readable &&
21
+ !!value.writable &&
22
+ isReadableStream(value.readable) &&
23
+ isWritableStream(value.writable));
24
+ }
@@ -5,16 +5,15 @@
5
5
  * Works identically in both browser and Node.js environments.
6
6
  */
7
7
  import { EventEmitter } from "@stream/event-emitter";
8
- export interface PullStreamOptions {
9
- /** Enable object mode */
10
- objectMode?: boolean;
11
- }
8
+ import type { PullStreamOptions } from "@stream/types";
9
+ export type { PullStreamOptions } from "@stream/types";
12
10
  /**
13
11
  * Browser-compatible Pull Stream - Read data from buffer on demand with pattern matching
14
12
  */
15
13
  export declare class PullStream extends EventEmitter {
16
- private _bufferChunks;
17
- private _totalLength;
14
+ private _buffer;
15
+ private _bufferReadIndex;
16
+ private _bufferWriteIndex;
18
17
  protected finished: boolean;
19
18
  protected _match?: number;
20
19
  private _destroyed;
@@ -5,36 +5,41 @@
5
5
  * Works identically in both browser and Node.js environments.
6
6
  */
7
7
  import { EventEmitter } from "./event-emitter.js";
8
- import { concatUint8Arrays } from "./shared.js";
8
+ const EMPTY_U8 = new Uint8Array(0);
9
9
  /**
10
10
  * Browser-compatible Pull Stream - Read data from buffer on demand with pattern matching
11
11
  */
12
12
  export class PullStream extends EventEmitter {
13
13
  constructor(_options = {}) {
14
14
  super();
15
- // Use chunked buffer storage to avoid repeated concat
16
- this._bufferChunks = [];
17
- this._totalLength = 0;
15
+ // Single growable buffer with read/write cursors.
16
+ // IMPORTANT: never mutate bytes that have already been returned via subarray
17
+ // (to keep views stable). When we need to reclaim prefix space, we allocate
18
+ // a new buffer and copy the remaining bytes.
19
+ this._buffer = new Uint8Array(0);
20
+ this._bufferReadIndex = 0;
21
+ this._bufferWriteIndex = 0;
18
22
  this.finished = false;
19
23
  this._destroyed = false;
20
24
  }
21
- // Consolidate chunks into single buffer when needed
25
+ // Maintain legacy protected accessor for subclasses.
26
+ // Returned value is a view of the readable region.
22
27
  get buffer() {
23
- const len = this._bufferChunks.length;
24
- if (len === 0) {
25
- return new Uint8Array(0);
28
+ if (this._bufferReadIndex === this._bufferWriteIndex) {
29
+ return EMPTY_U8;
26
30
  }
27
- if (len === 1) {
28
- return this._bufferChunks[0];
29
- }
30
- // Consolidate multiple chunks
31
- const buf = concatUint8Arrays(this._bufferChunks);
32
- this._bufferChunks = [buf];
33
- return buf;
31
+ return this._buffer.subarray(this._bufferReadIndex, this._bufferWriteIndex);
34
32
  }
35
33
  set buffer(buf) {
36
- this._bufferChunks = buf.length > 0 ? [buf] : [];
37
- this._totalLength = buf.length;
34
+ if (buf.length === 0) {
35
+ this._buffer = EMPTY_U8;
36
+ this._bufferReadIndex = 0;
37
+ this._bufferWriteIndex = 0;
38
+ return;
39
+ }
40
+ this._buffer = buf;
41
+ this._bufferReadIndex = 0;
42
+ this._bufferWriteIndex = buf.length;
38
43
  }
39
44
  /**
40
45
  * Write data to the stream
@@ -44,8 +49,38 @@ export class PullStream extends EventEmitter {
44
49
  this.emit("error", new Error("Cannot write to destroyed stream"));
45
50
  return false;
46
51
  }
47
- this._bufferChunks.push(chunk);
48
- this._totalLength += chunk.length;
52
+ const chunkLen = chunk.length;
53
+ if (chunkLen === 0) {
54
+ this.emit("chunk");
55
+ return true;
56
+ }
57
+ // Fast path: first write can reuse caller buffer without copy.
58
+ if (this._buffer.length === 0) {
59
+ this._buffer = chunk;
60
+ this._bufferReadIndex = 0;
61
+ this._bufferWriteIndex = chunkLen;
62
+ this.emit("chunk");
63
+ return true;
64
+ }
65
+ const required = this._bufferWriteIndex + chunkLen;
66
+ if (required <= this._buffer.length) {
67
+ this._buffer.set(chunk, this._bufferWriteIndex);
68
+ this._bufferWriteIndex += chunkLen;
69
+ this.emit("chunk");
70
+ return true;
71
+ }
72
+ // Need a new buffer. We keep previously returned views stable by allocating.
73
+ const remaining = this._bufferWriteIndex - this._bufferReadIndex;
74
+ const nextLength = remaining + chunkLen;
75
+ const prevCap = this._buffer.length;
76
+ // Grow exponentially to avoid O(n^2) copying on many small writes.
77
+ const nextCap = Math.max(nextLength, prevCap > 0 ? prevCap * 2 : 1024);
78
+ const next = new Uint8Array(nextCap);
79
+ next.set(this._buffer.subarray(this._bufferReadIndex, this._bufferWriteIndex), 0);
80
+ next.set(chunk, remaining);
81
+ this._buffer = next;
82
+ this._bufferReadIndex = 0;
83
+ this._bufferWriteIndex = nextLength;
49
84
  this.emit("chunk");
50
85
  return true;
51
86
  }
@@ -69,8 +104,9 @@ export class PullStream extends EventEmitter {
69
104
  return;
70
105
  }
71
106
  this._destroyed = true;
72
- this._bufferChunks = [];
73
- this._totalLength = 0;
107
+ this._buffer = EMPTY_U8;
108
+ this._bufferReadIndex = 0;
109
+ this._bufferWriteIndex = 0;
74
110
  if (error) {
75
111
  this.emit("error", error);
76
112
  }
@@ -95,19 +131,32 @@ export class PullStream extends EventEmitter {
95
131
  reject(new Error("Stream destroyed"));
96
132
  return;
97
133
  }
98
- // Use _totalLength for fast check before consolidating
99
- if (this._totalLength >= size) {
100
- const buf = this.buffer;
101
- const result = buf.subarray(0, size);
102
- this.buffer = buf.subarray(size);
134
+ if (size === 0) {
135
+ resolve(this._buffer.subarray(this._bufferReadIndex, this._bufferReadIndex));
136
+ return;
137
+ }
138
+ const available = this._bufferWriteIndex - this._bufferReadIndex;
139
+ if (available >= size) {
140
+ const start = this._bufferReadIndex;
141
+ const end = start + size;
142
+ const result = this._buffer.subarray(start, end);
143
+ this._bufferReadIndex = end;
144
+ if (this._bufferReadIndex === this._bufferWriteIndex) {
145
+ this._buffer = EMPTY_U8;
146
+ this._bufferReadIndex = 0;
147
+ this._bufferWriteIndex = 0;
148
+ }
103
149
  resolve(result);
104
150
  return;
105
151
  }
106
152
  if (this.finished) {
107
153
  // Return whatever we have
108
- const result = this.buffer;
109
- this._bufferChunks = [];
110
- this._totalLength = 0;
154
+ const result = this._bufferReadIndex === this._bufferWriteIndex
155
+ ? EMPTY_U8
156
+ : this._buffer.subarray(this._bufferReadIndex, this._bufferWriteIndex);
157
+ this._buffer = EMPTY_U8;
158
+ this._bufferReadIndex = 0;
159
+ this._bufferWriteIndex = 0;
111
160
  resolve(result);
112
161
  return;
113
162
  }
@@ -124,21 +173,36 @@ export class PullStream extends EventEmitter {
124
173
  reject(new Error("Stream destroyed"));
125
174
  return;
126
175
  }
127
- const buf = this.buffer;
128
- const matchIndex = this._indexOf(buf, pattern);
129
- if (matchIndex !== -1) {
130
- this._match = matchIndex;
131
- const endIndex = includePattern ? matchIndex + pattern.length : matchIndex;
132
- const result = buf.subarray(0, endIndex);
133
- this.buffer = buf.subarray(includePattern ? endIndex : matchIndex + pattern.length);
176
+ // Match empty pattern without consuming anything.
177
+ if (pattern.length === 0) {
178
+ this._match = 0;
179
+ resolve(this._buffer.subarray(this._bufferReadIndex, this._bufferReadIndex));
180
+ return;
181
+ }
182
+ const matchIndexAbs = this._indexOf(this._buffer, this._bufferReadIndex, this._bufferWriteIndex, pattern);
183
+ if (matchIndexAbs !== -1) {
184
+ this._match = matchIndexAbs - this._bufferReadIndex;
185
+ const patternLen = pattern.length;
186
+ const resultEndAbs = includePattern ? matchIndexAbs + patternLen : matchIndexAbs;
187
+ const consumeTo = matchIndexAbs + patternLen;
188
+ const result = this._buffer.subarray(this._bufferReadIndex, resultEndAbs);
189
+ this._bufferReadIndex = consumeTo;
190
+ if (this._bufferReadIndex === this._bufferWriteIndex) {
191
+ this._buffer = EMPTY_U8;
192
+ this._bufferReadIndex = 0;
193
+ this._bufferWriteIndex = 0;
194
+ }
134
195
  resolve(result);
135
196
  return;
136
197
  }
137
198
  if (this.finished) {
138
199
  // Pattern not found, return everything
139
- const result = buf;
140
- this._bufferChunks = [];
141
- this._totalLength = 0;
200
+ const result = this._bufferReadIndex === this._bufferWriteIndex
201
+ ? EMPTY_U8
202
+ : this._buffer.subarray(this._bufferReadIndex, this._bufferWriteIndex);
203
+ this._buffer = EMPTY_U8;
204
+ this._bufferReadIndex = 0;
205
+ this._bufferWriteIndex = 0;
142
206
  resolve(result);
143
207
  return;
144
208
  }
@@ -158,7 +222,7 @@ export class PullStream extends EventEmitter {
158
222
  * Get remaining buffer length
159
223
  */
160
224
  get length() {
161
- return this._totalLength;
225
+ return this._bufferWriteIndex - this._bufferReadIndex;
162
226
  }
163
227
  /**
164
228
  * Check if stream is finished
@@ -175,13 +239,13 @@ export class PullStream extends EventEmitter {
175
239
  /**
176
240
  * Find pattern in Uint8Array (like Buffer.indexOf)
177
241
  */
178
- _indexOf(haystack, needle, start = 0) {
242
+ _indexOf(haystack, start, end, needle) {
179
243
  const needleLen = needle.length;
180
244
  if (needleLen === 0) {
181
245
  return start;
182
246
  }
183
- const haystackLen = haystack.length;
184
- if (needleLen > haystackLen) {
247
+ const haystackLen = end;
248
+ if (needleLen > haystackLen - start) {
185
249
  return -1;
186
250
  }
187
251
  const first = needle[0];
@@ -31,7 +31,7 @@ export declare function uint8ArrayToString(arr: Uint8Array, encoding?: string):
31
31
  /**
32
32
  * Concatenate multiple Uint8Arrays efficiently
33
33
  */
34
- export declare function concatUint8Arrays(arrays: readonly Uint8Array[]): Uint8Array;
34
+ export declare function concatUint8Arrays(arrays: readonly Uint8Array[], totalLength?: number): Uint8Array;
35
35
  /**
36
36
  * Compare two Uint8Arrays for equality
37
37
  */
@@ -54,7 +54,7 @@ export function uint8ArrayToString(arr, encoding) {
54
54
  /**
55
55
  * Concatenate multiple Uint8Arrays efficiently
56
56
  */
57
- export function concatUint8Arrays(arrays) {
57
+ export function concatUint8Arrays(arrays, totalLength) {
58
58
  const len = arrays.length;
59
59
  if (len === 0) {
60
60
  return new Uint8Array(0);
@@ -63,9 +63,12 @@ export function concatUint8Arrays(arrays) {
63
63
  return arrays[0];
64
64
  }
65
65
  // Calculate total length with for loop for better performance
66
- let totalLength = 0;
67
- for (let i = 0; i < len; i++) {
68
- totalLength += arrays[i].length;
66
+ if (totalLength === undefined) {
67
+ let sum = 0;
68
+ for (let i = 0; i < len; i++) {
69
+ sum += arrays[i].length;
70
+ }
71
+ totalLength = sum;
69
72
  }
70
73
  const result = new Uint8Array(totalLength);
71
74
  let offset = 0;
@@ -10,11 +10,11 @@
10
10
  * - Safari >= 14.1
11
11
  * - Edge >= 89
12
12
  */
13
- import type { TransformStreamOptions, ReadableStreamOptions, WritableStreamOptions, DuplexStreamOptions, PullStreamOptions, BufferedStreamOptions, DataChunk, ICollector, IDuplex, IEventEmitter, IPassThrough, IReadable, ITransform, IWritable, PipelineStreamLike, ReadableLike, WritableLike } from "@stream/types";
13
+ import type { TransformStreamOptions, ReadableStreamOptions, WritableStreamOptions, DuplexStreamOptions, PullStreamOptions, BufferedStreamOptions, ICollector, IDuplex, IEventEmitter, IPassThrough, IReadable, ITransform, IWritable, PipelineStreamLike, ReadableLike, WritableLike } from "@stream/types";
14
14
  import type { Writable as NodeWritable } from "stream";
15
15
  import { EventEmitter } from "@stream/event-emitter";
16
- import { PullStream as StandalonePullStream, type PullStreamOptions as StandalonePullStreamOptions } from "@stream/pull-stream";
17
- import { BufferedStream as StandaloneBufferedStream, StringChunk as StandaloneStringChunk, BufferChunk as StandaloneBufferChunk } from "@stream/buffered-stream";
16
+ import { PullStream } from "@stream/pull-stream";
17
+ import { BufferedStream, BufferChunk, StringChunk } from "@stream/buffered-stream";
18
18
  /**
19
19
  * A wrapper around Web ReadableStream that provides Node.js-like API
20
20
  */
@@ -667,16 +667,7 @@ export declare class Collector<T = Uint8Array> extends Writable<T> {
667
667
  toString(): string;
668
668
  get isFinished(): boolean;
669
669
  }
670
- export declare class PullStream extends StandalonePullStream {
671
- constructor(options?: PullStreamOptions | StandalonePullStreamOptions);
672
- }
673
- export declare class StringChunk extends StandaloneStringChunk implements DataChunk {
674
- }
675
- export declare class BufferChunk extends StandaloneBufferChunk implements DataChunk {
676
- }
677
- export declare class BufferedStream extends StandaloneBufferedStream {
678
- constructor(options?: BufferedStreamOptions);
679
- }
670
+ export { PullStream, BufferedStream, StringChunk, BufferChunk };
680
671
  /**
681
672
  * Create a readable stream with custom read implementation
682
673
  */
@@ -933,4 +924,3 @@ export declare const promises: {
933
924
  pipeline: typeof pipeline;
934
925
  finished: typeof finished;
935
926
  };
936
- export {};