@fgv/ts-extras 5.1.0-45 → 5.1.0-46

package/lib/packlets/zip-file-tree/zipFileTreeWriter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zipFileTreeWriter.d.ts","sourceRoot":"","sources":["../../../src/packlets/zip-file-tree/zipFileTreeWriter.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,MAAM,EAAiB,MAAM,eAAe,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAExE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,mBAAmB,CAAC;CACtC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,aAAa,CAAC,YAAY,CAAC,EAClC,OAAO,CAAC,EAAE,iBAAiB,GAC1B,MAAM,CAAC,UAAU,CAAC,CAUpB"}
+{"version":3,"file":"zipFileTreeWriter.d.ts","sourceRoot":"","sources":["../../../src/packlets/zip-file-tree/zipFileTreeWriter.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,MAAM,EAAiB,MAAM,eAAe,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAC;CACxC;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAExE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,mBAAmB,CAAC;CACtC;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,aAAa,CAAC,YAAY,CAAC,EAClC,OAAO,CAAC,EAAE,iBAAiB,GAC1B,MAAM,CAAC,UAAU,CAAC,CAEpB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,EAC9B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,MAAM,CAAC,UAAU,CAAC,CAUpB"}

package/lib/packlets/zip-file-tree/zipFileTreeWriter.js

@@ -22,19 +22,35 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createZipFromTextFiles = createZipFromTextFiles;
+exports.createZipFromFiles = createZipFromFiles;
 const fflate_1 = require("fflate");
 const ts_utils_1 = require("@fgv/ts-utils");
 /**
  * Creates a zip file from an array of text files.
+ *
+ * @remarks
+ * Contents are encoded as UTF-8. Use `createZipFromFiles` to write entries whose
+ * contents are raw bytes.
  * @public
  */
 function createZipFromTextFiles(files, options) {
+    return createZipFromFiles(files, options);
+}
+/**
+ * Creates a zip file from an array of files whose contents are either text or raw bytes.
+ *
+ * @remarks
+ * String contents are encoded as UTF-8; `Uint8Array` contents are stored verbatim, so
+ * arbitrary binary payloads round-trip through the archive unchanged.
+ * @public
+ */
+function createZipFromFiles(files, options) {
     return (0, ts_utils_1.captureResult)(() => {
         var _a;
         const out = {};
         for (const f of files) {
             const normalizedPath = f.path.replace(/^\/+/, '');
-            out[normalizedPath] = (0, fflate_1.strToU8)(f.contents);
+            out[normalizedPath] = typeof f.contents === 'string' ? (0, fflate_1.strToU8)(f.contents) : f.contents;
         }
         return (0, fflate_1.zipSync)(out, { level: (_a = options === null || options === void 0 ? void 0 : options.level) !== null && _a !== void 0 ? _a : 6 });
         /* c8 ignore next - defensive: zipSync only throws on internal library errors */

package/lib/packlets/zip-file-tree/zipFileTreeWriter.js.map

@@ -1 +1 @@
-{"version":3,"file":"zipFileTreeWriter.js","sourceRoot":"","sources":["../../../src/packlets/zip-file-tree/zipFileTreeWriter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;AAgCH,wDAaC;AA3CD,mCAA0C;AAC1C,4CAAsD;AAyBtD;;;GAGG;AACH,SAAgB,sBAAsB,CACpC,KAAkC,EAClC,OAA2B;IAE3B,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE;;QACxB,MAAM,GAAG,GAA+B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAClD,GAAG,CAAC,cAAc,CAAC,GAAG,IAAA,gBAAO,EAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,IAAA,gBAAO,EAAC,GAAG,EAAE,EAAE,KAAK,EAAE,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,mCAAI,CAAC,EAAE,CAAC,CAAC;QACpD,gFAAgF;IAClF,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC;AAC1D,CAAC","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { zipSync, strToU8 } from 'fflate';\nimport { Result, captureResult } from '@fgv/ts-utils';\n\n/**\n * Simple interface for a file to be added to a zip file.\n * @public\n */\nexport interface IZipTextFile {\n  readonly path: string;\n  readonly contents: string;\n}\n\n/**\n * Supported compression levels for zip files.\n * @public\n */\nexport type ZipCompressionLevel = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;\n\n/**\n * Options for creating a zip file from text files.\n * @public\n */\nexport interface ICreateZipOptions {\n  readonly level?: ZipCompressionLevel;\n}\n\n/**\n * Creates a zip file from an array of text files.\n * @public\n */\nexport function createZipFromTextFiles(\n  files: ReadonlyArray<IZipTextFile>,\n  options?: ICreateZipOptions\n): Result<Uint8Array> {\n  return captureResult(() => {\n    const out: Record<string, Uint8Array> = {};\n    for (const f of files) {\n      const normalizedPath = f.path.replace(/^\\/+/, '');\n      out[normalizedPath] = strToU8(f.contents);\n    }\n    return zipSync(out, { level: options?.level ?? 6 });\n    /* c8 ignore next - defensive: zipSync only throws on internal library errors */\n  }).withErrorFormat((e) => `Failed to create zip: ${e}`);\n}\n"]}
+{"version":3,"file":"zipFileTreeWriter.js","sourceRoot":"","sources":["../../../src/packlets/zip-file-tree/zipFileTreeWriter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;AAiDH,wDAKC;AAUD,gDAaC;AA3ED,mCAA0C;AAC1C,4CAAsD;AAsCtD;;;;;;;GAOG;AACH,SAAgB,sBAAsB,CACpC,KAAkC,EAClC,OAA2B;IAE3B,OAAO,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,kBAAkB,CAChC,KAA8B,EAC9B,OAA2B;IAE3B,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE;;QACxB,MAAM,GAAG,GAA+B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAClD,GAAG,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAA,gBAAO,EAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC1F,CAAC;QACD,OAAO,IAAA,gBAAO,EAAC,GAAG,EAAE,EAAE,KAAK,EAAE,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,mCAAI,CAAC,EAAE,CAAC,CAAC;QACpD,gFAAgF;IAClF,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC;AAC1D,CAAC","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { zipSync, strToU8 } from 'fflate';\nimport { Result, captureResult } from '@fgv/ts-utils';\n\n/**\n * Simple interface for a text file to be added to a zip file.\n * @public\n */\nexport interface IZipTextFile {\n  readonly path: string;\n  readonly contents: string;\n}\n\n/**\n * Interface for a file to be added to a zip file, whose contents are either text or\n * raw bytes.\n *\n * @remarks\n * String contents are encoded as UTF-8; `Uint8Array` contents are stored verbatim.\n * @public\n */\nexport interface IZipFile {\n  readonly path: string;\n  readonly contents: string | Uint8Array;\n}\n\n/**\n * Supported compression levels for zip files.\n * @public\n */\nexport type ZipCompressionLevel = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;\n\n/**\n * Options for creating a zip file from text files.\n * @public\n */\nexport interface ICreateZipOptions {\n  readonly level?: ZipCompressionLevel;\n}\n\n/**\n * Creates a zip file from an array of text files.\n *\n * @remarks\n * Contents are encoded as UTF-8. Use `createZipFromFiles` to write entries whose\n * contents are raw bytes.\n * @public\n */\nexport function createZipFromTextFiles(\n  files: ReadonlyArray<IZipTextFile>,\n  options?: ICreateZipOptions\n): Result<Uint8Array> {\n  return createZipFromFiles(files, options);\n}\n\n/**\n * Creates a zip file from an array of files whose contents are either text or raw bytes.\n *\n * @remarks\n * String contents are encoded as UTF-8; `Uint8Array` contents are stored verbatim, so\n * arbitrary binary payloads round-trip through the archive unchanged.\n * @public\n */\nexport function createZipFromFiles(\n  files: ReadonlyArray<IZipFile>,\n  options?: ICreateZipOptions\n): Result<Uint8Array> {\n  return captureResult(() => {\n    const out: Record<string, Uint8Array> = {};\n    for (const f of files) {\n      const normalizedPath = f.path.replace(/^\\/+/, '');\n      out[normalizedPath] = typeof f.contents === 'string' ? strToU8(f.contents) : f.contents;\n    }\n    return zipSync(out, { level: options?.level ?? 6 });\n    /* c8 ignore next - defensive: zipSync only throws on internal library errors */\n  }).withErrorFormat((e) => `Failed to create zip: ${e}`);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fgv/ts-extras",
-  "version": "5.1.0-45",
+  "version": "5.1.0-46",
   "description": "Assorted Typescript Utilities",
   "main": "lib/index.js",
   "types": "dist/ts-extras.d.ts",
@@ -90,10 +90,10 @@
     "@types/js-yaml": "~4.0.9",
     "typedoc": "~0.28.16",
     "typedoc-plugin-markdown": "~4.9.0",
-    "@fgv/heft-dual-rig": "5.1.0-45",
-    "@fgv/typedoc-compact-theme": "5.1.0-45",
-    "@fgv/ts-utils": "5.1.0-45",
-    "@fgv/ts-utils-jest": "5.1.0-45"
+    "@fgv/typedoc-compact-theme": "5.1.0-46",
+    "@fgv/heft-dual-rig": "5.1.0-46",
+    "@fgv/ts-utils-jest": "5.1.0-46",
+    "@fgv/ts-utils": "5.1.0-46"
   },
   "dependencies": {
     "@types/luxon": "^3.7.1",
@@ -102,10 +102,10 @@
     "papaparse": "^5.4.1",
     "fflate": "~0.8.2",
     "js-yaml": "~4.1.1",
-    "@fgv/ts-json-base": "5.1.0-45"
+    "@fgv/ts-json-base": "5.1.0-46"
   },
   "peerDependencies": {
-    "@fgv/ts-utils": "5.1.0-45"
+    "@fgv/ts-utils": "5.1.0-46"
   },
   "repository": {
     "type": "git",