@rushstack/zipsync 0.1.0

package/lib/fs.d.ts

@@ -0,0 +1,13 @@
+import { type OpenMode } from 'node:fs';
+interface IInternalDisposableFileHandle extends Disposable {
+    fd: number;
+}
+export interface IDisposableFileHandle extends IInternalDisposableFileHandle {
+    readonly fd: number;
+}
+export declare const DISPOSE_SYMBOL: typeof Symbol.dispose;
+export declare function getDisposableFileHandle(path: string, openMode: OpenMode): IDisposableFileHandle;
+export declare function rmdirSync(dirPath: string): boolean;
+export declare function unlinkSync(filePath: string): boolean;
+export {};
+//# sourceMappingURL=fs.d.ts.map

package/lib/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEvD,UAAU,6BAA8B,SAAQ,UAAU;IACxD,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,qBAAsB,SAAQ,6BAA6B;IAC1E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,cAAc,EAAE,OAAO,MAAM,CAAC,OAAwD,CAAC;AAEpG,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,qBAAqB,CAY/F;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAYlD;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAYpD"}

package/lib/fs.js

@@ -0,0 +1,57 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DISPOSE_SYMBOL = void 0;
+exports.getDisposableFileHandle = getDisposableFileHandle;
+exports.rmdirSync = rmdirSync;
+exports.unlinkSync = unlinkSync;
+const node_fs_1 = __importDefault(require("node:fs"));
+exports.DISPOSE_SYMBOL = (_a = Symbol.dispose) !== null && _a !== void 0 ? _a : Symbol.for('Symbol.dispose');
+function getDisposableFileHandle(path, openMode) {
+    const result = {
+        fd: node_fs_1.default.openSync(path, openMode),
+        [exports.DISPOSE_SYMBOL]: () => {
+            if (!isNaN(result.fd)) {
+                node_fs_1.default.closeSync(result.fd);
+                result.fd = NaN;
+            }
+        }
+    };
+    return result;
+}
+function rmdirSync(dirPath) {
+    try {
+        node_fs_1.default.rmdirSync(dirPath);
+        return true;
+    }
+    catch (e) {
+        if (e.code === 'ENOENT' || e.code === 'ENOTDIR') {
+            // Not found, ignore
+        }
+        else {
+            throw e;
+        }
+    }
+    return false;
+}
+function unlinkSync(filePath) {
+    try {
+        node_fs_1.default.unlinkSync(filePath);
+        return true;
+    }
+    catch (e) {
+        if (e && e.code === 'ENOENT') {
+            // Not found, ignore
+        }
+        else {
+            throw e;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=fs.js.map

package/lib/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;;AAc3D,0DAYC;AAED,8BAYC;AAED,gCAYC;AApDD,sDAAuD;AAU1C,QAAA,cAAc,GAA0B,MAAA,MAAM,CAAC,OAAO,mCAAI,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAEpG,SAAgB,uBAAuB,CAAC,IAAY,EAAE,QAAkB;IACtE,MAAM,MAAM,GAAkC;QAC5C,EAAE,EAAE,iBAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;QAC/B,CAAC,sBAAc,CAAC,EAAE,GAAG,EAAE;YACrB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;gBACtB,iBAAE,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACxB,MAAM,CAAC,EAAE,GAAG,GAAG,CAAC;YAClB,CAAC;QACH,CAAC;KACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,SAAS,CAAC,OAAe;IACvC,IAAI,CAAC;QACH,iBAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAK,CAA2B,CAAC,IAAI,KAAK,QAAQ,IAAK,CAA2B,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACtG,oBAAoB;QACtB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAgB,UAAU,CAAC,QAAgB;IACzC,IAAI,CAAC;QACH,iBAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,IAAK,CAA2B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACxD,oBAAoB;QACtB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport { default as fs, type OpenMode } from 'node:fs';\n\ninterface IInternalDisposableFileHandle extends Disposable {\n  fd: number;\n}\n\nexport interface IDisposableFileHandle extends IInternalDisposableFileHandle {\n  readonly fd: number;\n}\n\nexport const DISPOSE_SYMBOL: typeof Symbol.dispose = Symbol.dispose ?? Symbol.for('Symbol.dispose');\n\nexport function getDisposableFileHandle(path: string, openMode: OpenMode): IDisposableFileHandle {\n  const result: IInternalDisposableFileHandle = {\n    fd: fs.openSync(path, openMode),\n    [DISPOSE_SYMBOL]: () => {\n      if (!isNaN(result.fd)) {\n        fs.closeSync(result.fd);\n        result.fd = NaN;\n      }\n    }\n  };\n\n  return result;\n}\n\nexport function rmdirSync(dirPath: string): boolean {\n  try {\n    fs.rmdirSync(dirPath);\n    return true;\n  } catch (e) {\n    if ((e as NodeJS.ErrnoException).code === 'ENOENT' || (e as NodeJS.ErrnoException).code === 'ENOTDIR') {\n      // Not found, ignore\n    } else {\n      throw e;\n    }\n  }\n  return false;\n}\n\nexport function unlinkSync(filePath: string): boolean {\n  try {\n    fs.unlinkSync(filePath);\n    return true;\n  } catch (e) {\n    if (e && (e as NodeJS.ErrnoException).code === 'ENOENT') {\n      // Not found, ignore\n    } else {\n      throw e;\n    }\n  }\n  return false;\n}\n"]}

package/lib/hash.d.ts

@@ -0,0 +1,3 @@
+export declare function computeFileHash(fd: number): string | false;
+export declare function calculateSHA1(data: Buffer): string;
+//# sourceMappingURL=hash.d.ts.map

package/lib/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAQA,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CA6B1D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/lib/hash.js

@@ -0,0 +1,43 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeFileHash = computeFileHash;
+exports.calculateSHA1 = calculateSHA1;
+const node_fs_1 = require("node:fs");
+const node_crypto_1 = require("node:crypto");
+const buffer = Buffer.allocUnsafeSlow(1 << 24);
+function computeFileHash(fd) {
+    try {
+        const hash = (0, node_crypto_1.createHash)('sha1');
+        let totalBytesRead = 0;
+        let bytesRead;
+        do {
+            bytesRead = (0, node_fs_1.readSync)(fd, buffer, 0, buffer.length, -1);
+            if (bytesRead <= 0) {
+                break;
+            }
+            totalBytesRead += bytesRead;
+            hash.update(buffer.subarray(0, bytesRead));
+        } while (bytesRead > 0);
+        if (totalBytesRead === 0) {
+            // Sometimes directories get treated as empty files
+            const stat = (0, node_fs_1.fstatSync)(fd);
+            if (!stat.isFile()) {
+                return false;
+            }
+        }
+        return hash.digest('hex');
+    }
+    catch (err) {
+        // There is a bug in node-core-library where it doesn't handle if the operation was on a file descriptor
+        if (err.code === 'EISDIR' || err.code === 'ENOENT' || err.code === 'ENOTDIR') {
+            return false;
+        }
+        throw err;
+    }
+}
+function calculateSHA1(data) {
+    return (0, node_crypto_1.createHash)('sha1').update(data).digest('hex');
+}
+//# sourceMappingURL=hash.js.map

package/lib/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;AAO3D,0CA6BC;AAED,sCAEC;AAtCD,qCAA0D;AAC1D,6CAAoD;AAEpD,MAAM,MAAM,GAAW,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAEvD,SAAgB,eAAe,CAAC,EAAU;IACxC,IAAI,CAAC;QACH,MAAM,IAAI,GAAS,IAAA,wBAAU,EAAC,MAAM,CAAC,CAAC;QACtC,IAAI,cAAc,GAAW,CAAC,CAAC;QAC/B,IAAI,SAAiB,CAAC;QACtB,GAAG,CAAC;YACF,SAAS,GAAG,IAAA,kBAAQ,EAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;YACvD,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;gBACnB,MAAM;YACR,CAAC;YACD,cAAc,IAAI,SAAS,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;QAC7C,CAAC,QAAQ,SAAS,GAAG,CAAC,EAAE;QACxB,IAAI,cAAc,KAAK,CAAC,EAAE,CAAC;YACzB,mDAAmD;YACnD,MAAM,IAAI,GAAU,IAAA,mBAAS,EAAC,EAAE,CAAC,CAAC;YAClC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;gBACnB,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,wGAAwG;QACxG,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7E,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAgB,aAAa,CAAC,IAAY;IACxC,OAAO,IAAA,wBAAU,EAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACvD,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport { readSync, fstatSync, type Stats } from 'node:fs';\nimport { createHash, type Hash } from 'node:crypto';\n\nconst buffer: Buffer = Buffer.allocUnsafeSlow(1 << 24);\n\nexport function computeFileHash(fd: number): string | false {\n  try {\n    const hash: Hash = createHash('sha1');\n    let totalBytesRead: number = 0;\n    let bytesRead: number;\n    do {\n      bytesRead = readSync(fd, buffer, 0, buffer.length, -1);\n      if (bytesRead <= 0) {\n        break;\n      }\n      totalBytesRead += bytesRead;\n      hash.update(buffer.subarray(0, bytesRead));\n    } while (bytesRead > 0);\n    if (totalBytesRead === 0) {\n      // Sometimes directories get treated as empty files\n      const stat: Stats = fstatSync(fd);\n      if (!stat.isFile()) {\n        return false;\n      }\n    }\n\n    return hash.digest('hex');\n  } catch (err) {\n    // There is a bug in node-core-library where it doesn't handle if the operation was on a file descriptor\n    if (err.code === 'EISDIR' || err.code === 'ENOENT' || err.code === 'ENOTDIR') {\n      return false;\n    }\n    throw err;\n  }\n}\n\nexport function calculateSHA1(data: Buffer): string {\n  return createHash('sha1').update(data).digest('hex');\n}\n"]}

package/lib/index.d.ts

@@ -0,0 +1,3 @@
+export { pack, type IZipSyncPackResult, type IZipSyncPackOptions } from './pack';
+export { unpack, type IZipSyncUnpackResult, type IZipSyncUnpackOptions } from './unpack';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAE,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AACjF,OAAO,EAAE,MAAM,EAAE,KAAK,oBAAoB,EAAE,KAAK,qBAAqB,EAAE,MAAM,UAAU,CAAC"}

package/lib/index.js

@@ -0,0 +1,10 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unpack = exports.pack = void 0;
+var pack_1 = require("./pack");
+Object.defineProperty(exports, "pack", { enumerable: true, get: function () { return pack_1.pack; } });
+var unpack_1 = require("./unpack");
+Object.defineProperty(exports, "unpack", { enumerable: true, get: function () { return unpack_1.unpack; } });
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAE3D,+BAAiF;AAAxE,4FAAA,IAAI,OAAA;AACb,mCAAyF;AAAhF,gGAAA,MAAM,OAAA","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nexport { pack, type IZipSyncPackResult, type IZipSyncPackOptions } from './pack';\nexport { unpack, type IZipSyncUnpackResult, type IZipSyncUnpackOptions } from './unpack';\n"]}

package/lib/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/lib/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":""}

package/lib/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport * as path from 'node:path';\nimport * as fs from 'node:fs';\n\nimport { NoOpTerminalProvider } from '@rushstack/terminal/lib/NoOpTerminalProvider';\nimport { Terminal } from '@rushstack/terminal/lib/Terminal';\n\nimport { pack } from './pack';\nimport { unpack } from './unpack';\nimport { getDemoDataDirectoryDisposable } from './testUtils';\nimport type { ZipSyncOptionCompression } from './zipSyncUtils';\n\ndescribe('zipSync tests', () => {\n  it(`basic pack test`, () => {\n    const compressionOptions = ['store', 'deflate', 'zstd', 'auto'] satisfies ZipSyncOptionCompression[];\n    compressionOptions.forEach((compression) => {\n      if (compression === 'zstd') {\n        const [major, minor] = process.versions.node.split('.').map((x) => parseInt(x, 10));\n        if (major < 22 || (major === 22 && minor < 15)) {\n          // eslint-disable-next-line no-console\n          console.warn(`Skipping zstd test on Node ${process.versions.node}`);\n          return;\n        }\n      }\n\n      using demoDataDisposable = getDemoDataDirectoryDisposable(5);\n      const { targetDirectories, baseDir, metadata } = demoDataDisposable;\n\n      const terminal = new Terminal(new NoOpTerminalProvider());\n\n      const archivePath: string = path.join(baseDir, 'archive.zip');\n      const packResult = pack({\n        terminal: terminal,\n        compression,\n        baseDir,\n        targetDirectories,\n        archivePath\n      });\n\n      expect(packResult).toMatchObject({ filesPacked: 21, metadata });\n\n      using unpackDemoDataDisposable = getDemoDataDirectoryDisposable(2);\n      const { baseDir: unpackBaseDir } = unpackDemoDataDisposable;\n\n      const unpackResult = unpack({\n        terminal: terminal,\n        archivePath,\n        baseDir: unpackBaseDir,\n        targetDirectories\n      });\n\n      expect(unpackResult).toMatchObject({\n        filesDeleted: 0,\n        filesExtracted: 12,\n        filesSkipped: 8,\n        foldersDeleted: 0,\n        metadata\n      });\n\n      // Verify files were extracted\n      for (const targetDirectory of targetDirectories) {\n        const sourceDir: string = path.join(baseDir, targetDirectory);\n        for (let i: number = 0; i < 5; ++i) {\n          const sourceFile: string = path.join(sourceDir, 'subdir', `file-${i}.txt`);\n          const destFile: string = path.join(unpackBaseDir, targetDirectory, 'subdir', `file-${i}.txt`);\n          expect(fs.readFileSync(destFile, { encoding: 'utf-8' })).toEqual(\n            fs.readFileSync(sourceFile, { encoding: 'utf-8' })\n          );\n        }\n      }\n    });\n  });\n});\n"]}

package/lib/pack.d.ts

@@ -0,0 +1,55 @@
+import type { ITerminal } from '@rushstack/terminal/lib/ITerminal';
+import { type ZipSyncOptionCompression, type IMetadata } from './zipSyncUtils';
+/**
+ * @public
+ * Options for zipsync
+ */
+export interface IZipSyncPackOptions {
+    /**
+     * \@rushstack/terminal compatible terminal for logging
+     */
+    terminal: ITerminal;
+    /**
+     * Zip file path
+     */
+    archivePath: string;
+    /**
+     * Target directories to pack (relative to baseDir)
+     */
+    targetDirectories: ReadonlyArray<string>;
+    /**
+     * Base directory for relative paths within the archive (defaults to common parent of targetDirectories)
+     */
+    baseDir: string;
+    /**
+     * Compression mode. If set to 'deflate', file data will be compressed using raw DEFLATE (method 8) when this
+     * produces a smaller result; otherwise it will fall back to 'store' per-file.
+     */
+    compression: ZipSyncOptionCompression;
+    /**
+     * Optional buffer that can be provided to avoid internal allocations.
+     */
+    inputBuffer?: Buffer<ArrayBuffer>;
+    /**
+     * Optional buffer that can be provided to avoid internal allocations.
+     */
+    outputBuffer?: Buffer<ArrayBuffer>;
+}
+export interface IZipSyncPackResult {
+    filesPacked: number;
+    metadata: IMetadata;
+}
+/**
+ * Create a zipsync archive by enumerating target directories, then streaming each file into the
+ * output zip using the local file header + (optional compressed data) + data descriptor pattern.
+ *
+ * Performance characteristics:
+ *  - Single pass per file (no read-then-compress-then-write buffering). CRC32 + SHA-1 are computed
+ *    while streaming so the metadata JSON can later be used for selective unpack.
+ *  - Data descriptor usage (bit 3) allows writing headers before we know sizes or CRC32.
+ *  - A single timestamp (captured once) is applied to all entries for determinism.
+ *  - Metadata entry is added as a normal zip entry at the end (before central directory) so legacy
+ *    tools can still list/extract it, while zipsync can quickly parse file hashes.
+ */
+export declare function pack({ archivePath, targetDirectories: rawTargetDirectories, baseDir: rawBaseDir, compression, terminal, inputBuffer, outputBuffer }: IZipSyncPackOptions): IZipSyncPackResult;
+//# sourceMappingURL=pack.d.ts.map

package/lib/pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack.d.ts","sourceRoot":"","sources":["../src/pack.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAmBnE,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,SAAS,EAKf,MAAM,gBAAgB,CAAC;AAoCxB;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,iBAAiB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACzC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,WAAW,EAAE,wBAAwB,CAAC;IACtC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IAClC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,IAAI,CAAC,EACnB,WAAW,EACX,iBAAiB,EAAE,oBAAoB,EACvC,OAAO,EAAE,UAAU,EACnB,WAAW,EACX,QAAQ,EACR,WAAuD,EACvD,YAAwD,EACzD,EAAE,mBAAmB,GAAG,kBAAkB,CAqS1C"}